diff --git a/.agents/skills/epctl-commands/SKILL.md b/.agents/skills/epctl-commands/SKILL.md
new file mode 100644
index 00000000..122bed31
--- /dev/null
+++ b/.agents/skills/epctl-commands/SKILL.md
@@ -0,0 +1,112 @@
+---
+name: epctl-commands
+description: "Use when adding or changing EasyP CLI commands, handlers in internal/api, or registration in cmd/easyp/main.go. epctl-commands is the retained legacy skill name."
+argument-hint: "Describe the EasyP CLI command you want to add or change"
+---
+
+# EasyP CLI Commands — Legacy Skill Name: epctl-commands
+
+The name <code>epctl-commands</code> and its installation path are retained for compatibility. This skill routes current CLI work to <code>github.com/easyp-tech/easyp</code>. EasyP uses <code>github.com/urfave/cli/v2</code>, with handlers in <code>internal/api</code> and registration in <code>cmd/easyp/main.go</code>.
+
+Start with [AGENTS.md](../../../AGENTS.md), the [agent rules](../../../.spec/agent-rules.md), and [.spec/CLI.md](../../../.spec/CLI.md). Read the nearest handler and its tests before extending a command.
+
+## Source Map
+
+| Responsibility | Actual source |
+|----------------|---------------|
+| Root <code>cli.App</code>, logger initialization, registration | [cmd/easyp/main.go](../../../cmd/easyp/main.go) |
+| <code>Handler</code> contract: <code>Command() *cli.Command</code> | [internal/api/interface.go](../../../internal/api/interface.go) |
+| Small handler example | [internal/api/schema_gen.go](../../../internal/api/schema_gen.go) |
+| Group and subcommands | [internal/api/mod.go](../../../internal/api/mod.go) |
+| Validation and text/JSON reports | [internal/api/validate.go](../../../internal/api/validate.go) |
+| Logger lookup and core construction | [internal/api/runtime.go](../../../internal/api/runtime.go) |
+| Root flags and output format selection | [internal/flags/flags.go](../../../internal/flags/flags.go), [format.go](../../../internal/flags/format.go) |
+
+Use neighboring file names such as <code>schema_gen.go</code>, <code>mod.go</code>, and <code>mod_v1_update.go</code>. Place CLI wiring in <code>internal/api</code>; keep operations in their existing packages: <code>internal/modules</code> for dependencies, <code>internal/generation</code> for generation orchestration, <code>internal/migration</code> for migration, and <code>internal/core</code> for engines.
+
+## urfave/cli v2 Pattern
+
+- The root is a <code>*cli.App</code> with a <code>Commands</code> slice.
+- Handlers implement <code>Command() *cli.Command</code>, often on a small exported struct.
+- Actions have signature <code>func(ctx *cli.Context) error</code>. Read flags through <code>ctx.String</code>, <code>ctx.Bool</code>, and related methods; use <code>ctx.Args()</code> for positional arguments.
+- Pass <code>ctx.Context</code> to operations requiring <code>context.Context</code>.
+- Groups put children in <code>cli.Command.Subcommands</code>. The root app's <code>Commands</code> and a group's <code>Subcommands</code> are different fields.
+
+This complete handler-file example adapts the existing <code>SchemaGen</code> handler and uses the real [schemagen API](../../../internal/schemagen/schemagen.go). It shows fresh command-local flags and separate assignment/error checking. It illustrates a replacement pattern for that file, not a second handler to add beside the existing one.
+
+~~~go
+package api
+
+import (
+	"fmt"
+
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/schemagen"
+)
+
+// SchemaGen writes JSON Schemas for the v1 YAML documents.
+type SchemaGen struct{}
+
+var _ Handler = (*SchemaGen)(nil)
+
+// Command implements Handler.
+func (s SchemaGen) Command() *cli.Command {
+	return &cli.Command{
+		Name:   "schema-gen",
+		Usage:  "generate JSON Schemas for v1 YAML files",
+		Action: s.Action,
+		Flags: []cli.Flag{
+			&cli.StringFlag{
+				Name:  "out-dir",
+				Usage: "directory for generated v1 JSON Schemas",
+				Value: schemagen.DefaultOutDir,
+			},
+		},
+	}
+}
+
+// Action writes the schemas to the selected output directory.
+func (s SchemaGen) Action(ctx *cli.Context) error {
+	err := schemagen.Run(schemagen.Options{OutDir: ctx.String("out-dir")})
+	if err != nil {
+		return fmt.Errorf("Run: %w", err)
+	}
+	return nil
+}
+~~~
+
+For engine work, follow <code>buildCore</code> and [core.New(core.Options)](../../../internal/core/core.go). Consult the actual engine signature, such as <code>Core.Lint(context.Context, DirWalker) ([]IssueInfo, error)</code> in [core/lint.go](../../../internal/core/lint.go), rather than inventing a service client or server lifecycle.
+
+## Wiring a Command
+
+1. Add or update the handler in <code>internal/api</code>, implementing <code>Handler</code>. Keep parsing, output, and CLI error decisions at this boundary.
+2. For a top-level command, add the handler value to the existing <code>buildCommand(...)</code> call in <code>main</code>. For example, <code>api.SchemaGen{}</code> is already registered there. The helper calls each handler's <code>Command()</code>.
+3. For a subcommand, extend the parent's <code>Subcommands</code> slice. Follow <code>Mod.Command</code>, which binds actions such as <code>m.Download</code> and <code>m.Update</code>.
+4. Give flags accurate names, aliases, usage text, defaults, and required behavior. Preserve public spellings and inspect parent/local flag precedence.
+5. Add focused action tests and registration/argument tests where needed. Use [go-testing](../go-testing/SKILL.md) for process-state and urfave flag isolation.
+
+## Output, Logging, and Errors
+
+- The root defines <code>--cfg</code> (alias <code>--config</code>), <code>--debug</code>, and <code>--format</code> (alias <code>-f</code>). Text/JSON support and default format are command-specific; use <code>flags.GetFormat</code> where appropriate.
+- Follow the target command's existing output contract. For writer-based output, use <code>ctx.App.Writer</code> and <code>ctx.App.ErrWriter</code>, with appropriate standard-stream fallbacks when actions can be invoked directly. <code>Validate.Action</code> demonstrates reports through the application writer.
+- Preserve output write failures with <code>%w</code>, including buffered flush/JSON encode failures. EasyP has no universal printer abstraction or global <code>--output</code> mode.
+- Use <code>getLogger(ctx)</code> for the repository logger. The root installs it in application metadata; do not introduce unrelated global logger state.
+- Wrap call failures using only the callee name, such as <code>fmt.Errorf("Run: %w", err)</code>, without a receiver/package prefix. Follow [go-code-style](../go-code-style/SKILL.md).
+- Inspect the handler, <code>runtime.go</code>, and <code>main.go</code> before changing exits. Some handlers return errors, some use <code>cli.Exit</code>, and some call process-exit helpers. [.spec/ERRORS.md](../../../.spec/ERRORS.md) documents these boundaries; there is no general gRPC status mapper.
+
+## CLI Test Isolation
+
+Construct fresh commands, flags, mutable flag values, contexts, and writers per parallel case. urfave/cli v2 shares <code>HelpFlag</code>: use <code>HideHelp: true</code> on the test app and every command/subcommand when help is irrelevant. <code>HideHelpCommand</code> alone is insufficient; use <code>HideVersion: true</code> on the app for the shared version flag too.
+
+Action-only tests can use a private <code>flag.FlagSet</code> with <code>cli.NewContext</code>. Tests that alter cwd, environment, or global context/CLI hooks stay sequential or run in subprocesses; paths that exit the process need subprocess coverage. See [go-testing](../go-testing/SKILL.md) and [breaking_baseline_test.go](../../../internal/api/breaking_baseline_test.go).
+
+## Quick Checklist
+
+- [ ] Work targets the EasyP CLI; the legacy skill name/path remain intact.
+- [ ] Handler and action signatures use urfave/cli v2.
+- [ ] Registration uses <code>buildCommand</code> for root commands and <code>Subcommands</code> for groups.
+- [ ] Operations use actual package APIs and preserve context cancellation.
+- [ ] Flags, output formats, logger use, and exit behavior match the command contract.
+- [ ] Errors retain causes and use callee-only labels.
+- [ ] Tests isolate mutable CLI flags and respect process-state constraints.
diff --git a/.agents/skills/go-code-style/SKILL.md b/.agents/skills/go-code-style/SKILL.md
new file mode 100644
index 00000000..c32f4589
--- /dev/null
+++ b/.agents/skills/go-code-style/SKILL.md
@@ -0,0 +1,108 @@
+---
+name: go-code-style
+description: "Use when writing, reviewing, or refactoring Go code or creating packages in the github.com/easyp-tech/easyp CLI repository."
+argument-hint: "Describe the Go code you are writing or reviewing"
+---
+
+# Go Code Style — EasyP CLI
+
+Apply these conventions to <code>github.com/easyp-tech/easyp</code>, the Protocol Buffers CLI toolkit. Start with [AGENTS.md](../../../AGENTS.md), [.spec/README.md](../../../.spec/README.md), and the mandatory [agent rules](../../../.spec/agent-rules.md). Verify relevant source before changing behavior; older code may not follow every current convention.
+
+## Errors and Resource Cleanup
+
+- Wrap propagated call failures with <code>fmt.Errorf("&lt;callee&gt;: %w", err)</code>. Use only the called function or method name, without a package or receiver prefix.
+- For <code>os.Open</code>, use <code>"Open: %w"</code>; for <code>source.Fetch</code>, use <code>"Fetch: %w"</code>; for <code>c.protoInfoRead</code>, use <code>"protoInfoRead: %w"</code>.
+- Use <code>errors.Is</code> for sentinel identity and <code>errors.As</code> for typed error details. Reuse errors in their owning packages rather than inventing duplicates.
+- Never use a bare <code>defer resource.Close()</code> or discard the close error. Wrap the deferred call and log or handle its error. Propagate finalization failures when they affect successful output.
+- Log a failure where it is handled or terminates an operation; lower layers normally wrap and return it.
+
+Error ownership follows actual source:
+
+| Owner | Examples |
+|-------|----------|
+| [internal/core/core.go](../../../internal/core/core.go) | <code>ErrInvalidRule</code>, <code>ErrRepositoryDoesNotExist</code>, <code>ErrEmptyInputFiles</code> |
+| [internal/core/dom.go](../../../internal/core/dom.go) | <code>OpenImportFileError</code>, <code>GitRefNotFoundError</code> |
+| [internal/modules/immutable_versions.go](../../../internal/modules/immutable_versions.go) | <code>ErrLockedVersionChanged</code> |
+| [internal/config/v1/legacy_detection.go](../../../internal/config/v1/legacy_detection.go) | <code>ErrLegacyConfiguration</code> |
+| [internal/migration](../../../internal/migration) | Contextual planning and apply errors |
+
+See [.spec/ERRORS.md](../../../.spec/ERRORS.md) and the relevant CLI handler for reporting and exit behavior. There is no central domain-to-gRPC-status mapper. Follow [cmd/easyp/main.go](../../../cmd/easyp/main.go) and the handler's actual return/exit path instead of assigning a universal exit code to a sentinel.
+
+This complete, generic standalone example illustrates wrapping and cleanup; it is not an existing EasyP helper:
+
+~~~go
+package example
+
+import (
+	"fmt"
+	"io"
+	"log/slog"
+	"os"
+)
+
+// ReadText reads a file and reports any close failure to the logger.
+func ReadText(path string) (string, error) {
+	file, err := os.Open(path)
+	if err != nil {
+		return "", fmt.Errorf("Open: %w", err)
+	}
+	defer func() {
+		err := file.Close()
+		if err != nil {
+			slog.Error("Close", "error", err)
+		}
+	}()
+
+	data, err := io.ReadAll(file)
+	if err != nil {
+		return "", fmt.Errorf("ReadAll: %w", err)
+	}
+	return string(data), nil
+}
+~~~
+
+## Assignments, Imports, and Comments
+
+- Assign existing variables and check errors on separate lines. A block-scoped short declaration with <code>:=</code> in an <code>if</code> initializer is allowed.
+- Put comments above control flow, never inline on <code>if</code>, <code>for</code>, or <code>return</code> lines.
+- Group imports as standard library, third-party, then project packages, separated by blank lines. Project imports start with <code>github.com/easyp-tech/easyp</code>.
+- Use English comments and godoc. Every exported symbol needs a comment starting with its name. Put a package comment in one file per package.
+- Format Go code with <code>gofmt</code>. Import grouping and tag spellings are repository conventions: [.golangci.yml](../../../.golangci.yml) explicitly enables <code>staticcheck</code>, not <code>gci</code> or <code>tagliatelle</code>. Do not infer enabled linters from these conventions.
+
+## Naming and Package Boundaries
+
+| Responsibility | Source to follow |
+|----------------|------------------|
+| CLI handlers | [internal/api](../../../internal/api), implementing <code>Handler.Command() *cli.Command</code> |
+| Process entry and command registration | [cmd/easyp/main.go](../../../cmd/easyp/main.go) |
+| Lint/breaking engines and low-level plugin execution | [internal/core](../../../internal/core) |
+| Dependency resolution and repositories | [internal/modules](../../../internal/modules) |
+| Generation orchestration | [internal/generation](../../../internal/generation) |
+| v1 configuration and schema source | [internal/config/v1](../../../internal/config/v1) |
+| Lint rules and tests | [internal/rules](../../../internal/rules), colocated <code>&lt;rule&gt;.go</code> and <code>&lt;rule&gt;_test.go</code> |
+
+Use exported domain types and adapter implementations where required by their consumers; keep local configuration structs unexported. Existing public models such as <code>core.Options</code> and <code>v1.Policy</code> stay exported. Follow neighboring filenames and colocate tests as <code>&lt;file&gt;_test.go</code>.
+
+Reserve zero for new enum types with <code>_ = iota</code> so an unset value is not silently valid. Preserve established public configuration spellings and formats when extending existing types.
+
+## Interfaces and Context
+
+- Put <code>context.Context</code> first in methods that need it, and <code>error</code> last in results. Preserve existing contracts that do not take a context.
+- Define small interfaces in the consuming package; prefer one method when sufficient. Do not prefix interface names with <code>I</code>.
+- Actual contracts include <code>core.Rule</code> and <code>core.CurrentProjectGitWalker</code> in [dom.go](../../../internal/core/dom.go), <code>modules.Source</code> in [resolve.go](../../../internal/modules/resolve.go), and repository/cache interfaces in [repository.go](../../../internal/modules/repository.go).
+- <code>Console</code> belongs to [internal/adapters/console/new.go](../../../internal/adapters/console/new.go). Use the current owner when implementing or mocking it.
+- CLI actions receive <code>*cli.Context</code> from urfave/cli v2; pass <code>ctx.Context</code> to context-aware operations. Keep cancellation and mutable state scoped to the operation. Choose concurrency from the actual engine/adapter contract.
+
+## Struct Tags
+
+Follow the existing model's tags. v1 configuration types live in <code>internal/config/v1</code>, shared engine configuration in <code>internal/config</code>. Use the established YAML/JSON keys, usually <code>snake_case</code>, and retain hyphenated public keys such as <code>linters-settings</code> and <code>exclude-rules</code>. Avoid adding serialization tags to internal-only types without a consumer. Never hand-edit generated protobuf code or schema JSON.
+
+## Quick Checklist
+
+- [ ] Error wraps contain the callee name only, with <code>%w</code> and no package/receiver prefix.
+- [ ] Existing-variable assignment and error checking are separate; deferred close errors are handled.
+- [ ] Imports use the repository module path and the three conventional groups.
+- [ ] Exported symbols have English godoc; control-flow comments are on separate lines.
+- [ ] Errors and interfaces stay with their actual owners; new enums reserve zero.
+- [ ] Public tag spellings are preserved; lint claims match the current configuration.
+- [ ] Tests follow [go-testing](../go-testing/SKILL.md); CLI changes follow the legacy-named [epctl-commands](../epctl-commands/SKILL.md).
diff --git a/.agents/skills/go-testing/SKILL.md b/.agents/skills/go-testing/SKILL.md
new file mode 100644
index 00000000..6edf1951
--- /dev/null
+++ b/.agents/skills/go-testing/SKILL.md
@@ -0,0 +1,159 @@
+---
+name: go-testing
+description: "Use when writing, reviewing, or debugging Go tests in the github.com/easyp-tech/easyp CLI repository, including table tests, test doubles, and CLI state isolation."
+argument-hint: "Describe the test you are writing or reviewing"
+---
+
+# Go Testing — EasyP CLI
+
+Follow [AGENTS.md](../../../AGENTS.md), the mandatory [agent rules](../../../.spec/agent-rules.md), and [.spec/TESTING.md](../../../.spec/TESTING.md). EasyP tests exercise a CLI, engines, configuration, generation, migration, and Git-backed dependencies.
+
+## Table Tests and Assertions
+
+- Give new slice-based cases a descriptive <code>name string</code> field first, followed by inputs, optional setup, and expected outputs. Existing rule tests also use named map keys.
+- Prefer lowercase scenario names such as <code>missing_manifest</code>, <code>invalid_policy</code>, or <code>canceled_context</code>; underscores improve readability.
+- Use <code>t.Parallel()</code> at the top level and inside isolated subtests. Apply the process-state exceptions below before adding either call.
+- Construct mutable dependencies inside each subtest. A setup callback should receive that case's dependency rather than capture shared mutable state. Give filesystem cases separate <code>t.TempDir()</code> directories.
+- Use Testify <code>require</code> for fatal preconditions and <code>assert</code> for independent value checks. Check errors and nil pointers before accessing results.
+- Use <code>require.ErrorIs</code> for sentinel errors, <code>require.ErrorAs</code> for typed details, and <code>require.ErrorContains</code> for meaningful diagnostics without a sentinel. Use <code>require.NoError</code> on success; do not invent sentinels to simplify tests.
+
+This complete example uses the real <code>Validate.Action</code> API and follows [validate_test.go](../../../internal/api/validate_test.go). It can live in an <code>internal/api</code> test file. Each case has its own path, flag set, CLI context, and writer; it does not run the shared CLI parser setup.
+
+~~~go
+package api
+
+import (
+	"bytes"
+	"flag"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/flags"
+)
+
+func TestValidateActionReportExample(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name     string
+		contents string
+		wantHead string
+		wantErr  error
+	}{
+		{
+			name:     "valid_policy",
+			contents: "version: v1\n",
+			wantHead: "VALID: true\n",
+		},
+		{
+			name:     "invalid_policy",
+			contents: "linters:\n  unknown: true\n",
+			wantHead: "VALID: false\nERRORS:\n",
+			wantErr:  ErrHasValidateIssue,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			path := filepath.Join(t.TempDir(), "easyp.yaml")
+			require.NoError(t, os.WriteFile(path, []byte(tt.contents), 0o600))
+			var output bytes.Buffer
+			set := flag.NewFlagSet("validate-config", flag.ContinueOnError)
+			set.String(flags.Config.Name, "", "")
+			set.String(flags.Format.Name, "", "")
+			require.NoError(t, set.Set(flags.Config.Name, path))
+			require.NoError(t, set.Set(flags.Format.Name, flags.TextFormat))
+			ctx := cli.NewContext(&cli.App{Writer: &output}, set, nil)
+			ctx.Context = t.Context()
+
+			err := (Validate{}).Action(ctx)
+
+			if tt.wantErr != nil {
+				require.ErrorIs(t, err, tt.wantErr)
+			} else {
+				require.NoError(t, err)
+			}
+			assert.True(t, bytes.HasPrefix(output.Bytes(), []byte(tt.wantHead)), output.String())
+		})
+	}
+}
+~~~
+
+## Context, Cwd, and Environment Isolation
+
+Tests that change process cwd, environment, or global CLI/context hooks must remain sequential or run the affected behavior in an isolated subprocess. These are legitimate exceptions to parallel execution.
+
+- With <code>t.Chdir</code> or <code>t.Setenv</code>, neither the test nor any ancestor may call <code>t.Parallel()</code>. Keep its state-dependent subtests sequential too. Prefer these helpers for automatic restoration.
+- A private <code>t.TempDir()</code> does not isolate <code>os.Chdir</code>, <code>os.Setenv</code>, <code>os.Args</code>, standard streams, or package-global hooks. Avoid manual process mutation; when unavoidable, restore it with cleanup and check restoration errors.
+- For parallel process-level scenarios, configure each child with <code>exec.Cmd.Dir</code> and <code>exec.Cmd.Env</code>, without changing the parent process. Test paths that call <code>os.Exit</code> or default CLI exit handling in subprocesses.
+- Ordinary per-test contexts can run in parallel. Use <code>t.Context()</code> or a fresh cancellable child and clean it up. Do not share a mutable <code>*cli.Context</code>, <code>cli.App</code>, metadata map, or cancellation control between cases.
+- Prefer absolute paths passed to APIs when a test does not need to exercise cwd behavior. See [get_v1_test.go](../../../internal/api/get_v1_test.go) for sequential cwd/environment cases and [resolve_test.go](../../../internal/modules/resolve_test.go) for isolated cancellation cases.
+
+## urfave/cli v2 Parallel Tests
+
+A fresh <code>cli.App</code> alone is insufficient. The library shares <code>cli.HelpFlag</code>, and parsing mutates flag state. Project globals in [internal/flags/flags.go](../../../internal/flags/flags.go) and some command constructors also reuse flag pointers.
+
+For independent parallel parser tests:
+
+1. Create an app, command tree, flags, writers, and metadata per case. Allocate fresh flag values and destinations too; a shallow copy can still share <code>GenericFlag.Value</code>, slices, or pointers.
+2. Set <code>HideHelp: true</code> on the app and each command/subcommand in the test tree when help is irrelevant. <code>HideHelpCommand</code> alone does not remove the shared help flag. Use <code>HideVersion: true</code> on the app to avoid the shared version flag.
+3. Do not reassign <code>cli.HelpFlag</code>, <code>cli.VersionFlag</code>, exit functions, or other package globals in a parallel test. Keep tests of real help/global behavior sequential or subprocess-isolated.
+4. To test just an action, use a private standard-library <code>flag.FlagSet</code> and <code>cli.NewContext</code>, as above. This does not test command registration or flag parsing; cover those separately where relevant.
+
+Follow [breaking_baseline_test.go](../../../internal/api/breaking_baseline_test.go) for fresh flags and help isolation, and [migrate_interactive_test.go](../../../internal/api/migrate_interactive_test.go) for a command tree with help disabled. Inspect each constructor before assuming it returns independent flags.
+
+## Test Doubles and Mockery
+
+Small handwritten consumer test doubles are appropriate. Put them in the consuming package's <code>_test.go</code> file, or a shared <code>helpers_test.go</code> when several files use them. Use names such as <code>mockRule</code> or <code>fakeSource</code> that identify the contract and behavior. Add an interface assertion when useful.
+
+This complete double implements the actual [core.Rule](../../../internal/core/dom.go) interface:
+
+~~~go
+package core_test
+
+import "github.com/easyp-tech/easyp/internal/core"
+
+type mockRule struct {
+	issues []core.Issue
+	err    error
+}
+
+var _ core.Rule = (*mockRule)(nil)
+
+func (m *mockRule) Message() string {
+	return "example rule"
+}
+
+func (m *mockRule) Validate(_ core.ProtoInfo) ([]core.Issue, error) {
+	return m.issues, m.err
+}
+~~~
+
+Create a fresh double and any mutable slices/maps for each parallel case. Update doubles when their consumer interfaces change.
+
+Optional Mockery generation is also supported through <code>task mock</code> and <code>task mocks</code> in [Taskfile.yml](../../../Taskfile.yml). Check the selected target and actual interface owner before generation; use [.spec/TESTING.md](../../../.spec/TESTING.md) for current tooling limitations. <code>Rule</code> and <code>CurrentProjectGitWalker</code> are in <code>internal/core</code>; <code>Console</code> is in [internal/adapters/console](../../../internal/adapters/console/new.go). Regenerate generated doubles rather than hand-editing them. Handwritten doubles do not require generation.
+
+## Files, Packages, and Cleanup
+
+- Colocate tests as <code>&lt;file&gt;_test.go</code>; use <code>Test&lt;Function&gt;</code> or <code>Test&lt;Function&gt;_&lt;scenario&gt;</code>, following nearby names for existing suites.
+- Use same-package tests for unexported behavior and external test packages for exported contracts. Both are established here: [core/generate_path_test.go](../../../internal/core/generate_path_test.go) uses <code>package core</code>; [rules/file_lower_snake_case_test.go](../../../internal/rules/file_lower_snake_case_test.go) uses <code>package rules_test</code>.
+- Mark helpers with <code>t.Helper()</code>. Use <code>t.Cleanup()</code> for resources and check close errors, following [rules/init_test.go](../../../internal/rules/init_test.go).
+- Read fixtures from <code>testdata</code> and write generated test artifacts under temporary directories. Local Git tests can use temporary repositories without a public remote.
+- For behavior changes, run affected package tests with <code>-race -count=1</code>, subject to the task's execution constraints. See [.spec/TESTING.md](../../../.spec/TESTING.md) for Task targets; documentation-only repairs do not require a full Go suite.
+
+## Quick Checklist
+
+- [ ] Cases are named; inputs, setup, and expected outputs are clear.
+- [ ] Parallel cases have private dependencies, files, contexts, flags, and writers.
+- [ ] Cwd/environment/global-state cases are sequential or subprocess-isolated.
+- [ ] Parallel CLI parsers isolate application flags and the library's shared help/version flags.
+- [ ] Fatal preconditions use <code>require</code>; error assertions match the actual error contract.
+- [ ] Package choice follows the tested API; doubles match actual interfaces.
+- [ ] Cleanup handles errors; relevant behavior tests have been run within the authorized scope.
diff --git a/.agents/skills/protobuf-expert-skill/SKILL.md b/.agents/skills/protobuf-expert-skill/SKILL.md
new file mode 100644
index 00000000..e03cc550
--- /dev/null
+++ b/.agents/skills/protobuf-expert-skill/SKILL.md
@@ -0,0 +1,185 @@
+---
+name: protobuf-expert-skill
+description: "Protocol Buffers expert with deep EasyP CLI knowledge. Use when: writing or reviewing .proto files, configuring easyp.yaml, choosing lint rules, setting up code generation plugins, managing proto dependencies, detecting breaking API changes, debugging easyp errors, following protobuf style guide and API design best practices."
+argument-hint: "Describe your protobuf or easyp task (e.g. 'set up linting for my project', 'fix breaking change errors')"
+---
+
+# Protobuf Expert — EasyP CLI Skill
+
+You are an expert in Protocol Buffers design and the EasyP CLI toolkit (drop-in buf.build replacement). Help developers write idiomatic .proto files, configure EasyP correctly, and follow protobuf best practices.
+
+## When to Use
+
+- Writing, reviewing, or refactoring `.proto` files
+- Setting up or modifying `easyp.yaml` configuration
+- Choosing which lint rules to enable
+- Configuring code generation plugins and managed mode
+- Managing proto dependencies (`mod download/update/vendor`)
+- Detecting and resolving breaking API changes
+- Debugging lint errors or generation failures
+- Following protobuf style guide and API design patterns
+- Migrating from buf.build to EasyP
+- Setting up CI/CD for proto linting and breaking checks
+- Installing EasyP
+
+## Decision Flow
+
+```
+User wants to...
+│
+├─ INSTALL EasyP → see [installation.md](./references/installation.md)
+│
+├─ MIGRATE from buf.build → see [migration-from-buf.md](./references/migration-from-buf.md)
+│
+├─ START a new project
+│  ├─ Quick → `easyp init`
+│  └─ Manual → create easyp.yaml, see starter configs in [assets/](./assets/)
+│
+├─ LINT proto files
+│  ├─ Choose rules → § Lint Rule Selection Guide below
+│  ├─ Fix violations → run `easyp lint --debug`, check rule docs
+│  └─ Suppress rules → `lint.except`, `lint.ignore`, or `// easyp:off`
+│
+├─ GENERATE code
+│  ├─ Local plugins → `name` or `path` in `generate.plugins`
+│  ├─ Remote plugins → `remote` in `generate.plugins`
+│  └─ Managed mode → `generate.managed.enabled: true`
+│
+├─ DETECT breaking changes
+│  ├─ Run check → `easyp breaking --against main`
+│  ├─ Resolve → see § Breaking Change Resolution below
+│  └─ Ignore intentional → add to `breaking.ignore`
+│
+├─ SET UP CI/CD → see [ci-cd-integration.md](./references/ci-cd-integration.md)
+│
+└─ DEBUG an error → see [troubleshooting.md](./references/troubleshooting.md)
+```
+
+## Core Knowledge
+
+EasyP is a Go CLI tool (`easyp`) configured via `easyp.yaml`. It provides:
+
+| Command | Purpose |
+|---------|---------|
+| `easyp lint` | Lint .proto files against 42+ rules |
+| `easyp generate` | Generate code via protoc plugins |
+| `easyp breaking` | Detect breaking API changes vs a git ref |
+| `easyp mod download/update/vendor` | Manage proto dependencies |
+| `easyp init` | Interactive config setup |
+| `easyp validate-config` | Validate easyp.yaml |
+| `easyp ls-files` | List proto files with imports |
+| `easyp completion` | Shell completions (bash/zsh) |
+
+Global flags: `--cfg <path>` (default: `easyp.yaml`), `--debug`, `--format text|json`.
+
+## Procedure
+
+### 1. Understand the User's Goal
+
+Identify which workflow applies:
+- **New project setup** → `easyp init` or manual `easyp.yaml` creation
+- **Lint configuration** → Rule selection, groups, ignores
+- **Code generation** → Plugin setup, managed mode, inputs
+- **Dependency management** → `deps` config, mod commands
+- **Breaking change detection** → `breaking` config, git ref comparison
+- **Proto file authoring** → Style guide, naming, structure
+- **Debugging** → Error interpretation, config validation
+
+### 2. Apply the Right Reference
+
+Load the appropriate reference file for detailed information:
+
+| Task | Reference |
+|------|-----------|
+| CLI commands, flags, exit codes | [cli-commands.md](./references/cli-commands.md) |
+| Lint rules (42 rules, 5 groups) | [lint-rules.md](./references/lint-rules.md) |
+| Breaking change checks | [breaking-checks.md](./references/breaking-checks.md) |
+| easyp.yaml full format | [config-reference.md](./references/config-reference.md) |
+| Proto file style and API design | [protobuf-best-practices.md](./references/protobuf-best-practices.md) |
+| Migrating from buf.build | [migration-from-buf.md](./references/migration-from-buf.md) |
+| Troubleshooting & debugging | [troubleshooting.md](./references/troubleshooting.md) |
+| CI/CD integration | [ci-cd-integration.md](./references/ci-cd-integration.md) |
+| Installation methods | [installation.md](./references/installation.md) |
+| Starter configs (Go+gRPC, minimal, strict) | [assets/](./assets/) |
+
+### 3. Lint Rule Selection Guide
+
+When helping users choose rules, recommend by project maturity:
+
+- **Starting out**: Use the `DEFAULT` group (32 rules — covers MINIMAL + BASIC + DEFAULT)
+- **Strict API projects**: `DEFAULT` + `COMMENTS` + `UNARY_RPC` (all 42 rules)
+- **Internal/rapid prototyping**: `BASIC` group (24 rules — less opinionated)
+- **Minimal enforcement**: `MINIMAL` group (4 rules — package consistency only)
+
+Always suggest `allow_comment_ignores: true` for gradual adoption.
+
+### 4. Config Authoring
+
+When creating or modifying `easyp.yaml`:
+1. Start with required section (`lint.use` at minimum)
+2. Add `deps` for any external proto imports
+3. Add `generate` section with plugins, `out`, and `opts`
+4. Add `breaking` section if API stability matters
+5. Validate with `easyp validate-config`
+
+### 5. Proto File Review
+
+When reviewing `.proto` files, check against easyp rules:
+- File name: `lower_snake_case.proto`
+- Package: matches directory, has version suffix (`v1`, `v2`)
+- Naming: Messages/Services/Enums PascalCase, fields lower_snake_case, enum values UPPER_SNAKE_CASE
+- Enum zero value: has `_UNSPECIFIED` suffix (or configured suffix)
+- RPC: request/response types are unique, named `<Method>Request`/`<Method>Response`
+- Comments: all public entities documented
+- Imports: no unused, no public/weak imports
+
+### 6. Breaking Change Resolution
+
+When users encounter breaking changes:
+1. Identify the change type (field deleted, type changed, service removed, etc.)
+2. Explain WHY it's breaking for consumers
+3. Suggest backward-compatible alternatives:
+   - Don't remove fields — deprecate and reserve the number
+   - Don't change field types — add a new field
+   - Don't rename enum values — add new value, deprecate old
+   - Don't remove RPCs — deprecate first
+4. If the break is intentional, suggest adding to `breaking.ignore`
+
+### 7. New Project Setup
+
+When helping users start a new project:
+1. Recommend installation method from [installation.md](./references/installation.md)
+2. Run `easyp init` for interactive setup, OR
+3. Copy a starter config from [assets/](./assets/):
+   - `easyp-minimal.yaml` — linting only (DEFAULT group)
+   - `easyp-go-grpc.yaml` — Go + gRPC with generation
+   - `easyp-strict.yaml` — all 42 rules, Go + gRPC
+4. Run `easyp mod download` if deps are configured
+5. Validate with `easyp validate-config`
+
+### 8. Migration from buf.build
+
+When users are migrating from buf:
+1. Load [migration-from-buf.md](./references/migration-from-buf.md) for the full mapping
+2. Convert `buf.yaml` + `buf.gen.yaml` → single `easyp.yaml`
+3. Replace BSR deps with Git repository URLs
+4. Test: `easyp lint`, `easyp generate`, `easyp breaking`
+5. Update CI with [easyp-tech/actions](https://github.com/easyp-tech/actions)
+
+### 9. CI/CD Setup
+
+When setting up CI/CD:
+1. Load [ci-cd-integration.md](./references/ci-cd-integration.md)
+2. For GitHub → use official `easyp-tech/actions/lint@v1` and `easyp-tech/actions/breaking@v1`
+3. For GitLab/other → use Docker image `ghcr.io/easyp-tech/easyp:<version>`
+4. Always pin EasyP version for reproducibility
+5. Breaking checks need full git history (`fetch-depth: 0`)
+
+## Important Constraints
+
+- EasyP uses `easyp.yaml` (not `buf.yaml`) but is a drop-in buf.build replacement
+- Rule names are UPPER_SNAKE_CASE (e.g., `FIELD_LOWER_SNAKE_CASE`)
+- Groups can be used in `lint.use`: `MINIMAL`, `BASIC`, `DEFAULT`, `COMMENTS`, `UNARY_RPC`
+- Exit codes: 0 = success, 1 = issues found, 2 = critical error
+- `--format json` is available for `lint`, `breaking`, `validate-config`, and `ls-files`
+- Dependencies support `@version` or `@commit-hash` suffixes
diff --git a/.agents/skills/protobuf-expert-skill/assets/easyp-go-grpc.yaml b/.agents/skills/protobuf-expert-skill/assets/easyp-go-grpc.yaml
new file mode 100644
index 00000000..4c9df3bd
--- /dev/null
+++ b/.agents/skills/protobuf-expert-skill/assets/easyp-go-grpc.yaml
@@ -0,0 +1,26 @@
+# EasyP starter config: Go + gRPC project
+# Usage: copy to your project root as easyp.yaml
+# Dependencies: copy assets/protobuf-common.mod as protobuf.mod
+
+lint:
+  use:
+    - DEFAULT
+    - COMMENTS
+  allow_comment_ignores: true
+
+generate:
+  inputs:
+    - directory: proto
+  plugins:
+    - name: go
+      out: gen/go
+      opts:
+        paths: source_relative
+    - name: go-grpc
+      out: gen/go
+      opts:
+        paths: source_relative
+        require_unimplemented_servers: false
+
+breaking:
+  against_git_ref: main
diff --git a/.agents/skills/protobuf-expert-skill/assets/easyp-minimal.yaml b/.agents/skills/protobuf-expert-skill/assets/easyp-minimal.yaml
new file mode 100644
index 00000000..6208cdba
--- /dev/null
+++ b/.agents/skills/protobuf-expert-skill/assets/easyp-minimal.yaml
@@ -0,0 +1,7 @@
+# EasyP starter config: minimal linting only
+# Usage: copy to your project root as easyp.yaml
+
+lint:
+  use:
+    - DEFAULT
+  allow_comment_ignores: true
diff --git a/.agents/skills/protobuf-expert-skill/assets/easyp-strict.yaml b/.agents/skills/protobuf-expert-skill/assets/easyp-strict.yaml
new file mode 100644
index 00000000..76e7db88
--- /dev/null
+++ b/.agents/skills/protobuf-expert-skill/assets/easyp-strict.yaml
@@ -0,0 +1,28 @@
+# EasyP starter config: strict API project (all 42 rules)
+# Usage: copy to your project root as easyp.yaml
+# Dependencies: copy assets/protobuf-common.mod as protobuf.mod
+
+lint:
+  use:
+    - DEFAULT
+    - COMMENTS
+    - UNARY_RPC
+    - PACKAGE_NO_IMPORT_CYCLE
+  allow_comment_ignores: true
+
+generate:
+  inputs:
+    - directory: proto
+  plugins:
+    - name: go
+      out: gen/go
+      opts:
+        paths: source_relative
+    - name: go-grpc
+      out: gen/go
+      opts:
+        paths: source_relative
+        require_unimplemented_servers: false
+
+breaking:
+  against_git_ref: main
diff --git a/.agents/skills/protobuf-expert-skill/assets/protobuf-common.mod b/.agents/skills/protobuf-expert-skill/assets/protobuf-common.mod
new file mode 100644
index 00000000..0eb301c9
--- /dev/null
+++ b/.agents/skills/protobuf-expert-skill/assets/protobuf-common.mod
@@ -0,0 +1,4 @@
+direct (
+	github.com/googleapis/googleapis
+	github.com/protocolbuffers/protobuf
+)
diff --git a/.agents/skills/protobuf-expert-skill/references/breaking-checks.md b/.agents/skills/protobuf-expert-skill/references/breaking-checks.md
new file mode 100644
index 00000000..5870050e
--- /dev/null
+++ b/.agents/skills/protobuf-expert-skill/references/breaking-checks.md
@@ -0,0 +1,92 @@
+# EasyP Breaking Change Checks Reference
+
+EasyP detects breaking API changes by comparing the current proto files against a previous git ref (branch, tag, or commit).
+
+## Usage
+
+```sh
+easyp breaking --path proto --against main
+```
+
+## Configuration
+
+```yaml
+breaking:
+  ignore:
+    - proto/internal          # Paths to exclude from checks
+  against_git_ref: main       # Default ref (overridden by --against flag)
+```
+
+## Check Categories
+
+### Import Changes
+
+| Check | Description |
+|-------|-------------|
+| Import deleted | A previously existing import was removed |
+
+### Service Changes
+
+| Check | Description |
+|-------|-------------|
+| Service deleted | An entire service definition was removed |
+| RPC deleted | An RPC method was removed from a service |
+| RPC request type changed | The request message type of an RPC was changed |
+| RPC response type changed | The response message type of an RPC was changed |
+
+### Message Changes
+
+| Check | Description |
+|-------|-------------|
+| Message deleted | A message definition was removed |
+| Field deleted | A field was removed (reports field number and name) |
+| Field type changed | A field's type was changed |
+| Field became optional | A required/default field was changed to optional |
+| Field became not optional | An optional field was changed to required |
+
+### OneOf Changes
+
+| Check | Description |
+|-------|-------------|
+| OneOf deleted | A oneof group was removed |
+| OneOf field deleted | A field within a oneof was removed |
+| OneOf field type changed | A field type within a oneof was changed |
+
+### Enum Changes
+
+| Check | Description |
+|-------|-------------|
+| Enum deleted | An enum definition was removed |
+| Enum value deleted | An enum value was removed |
+| Enum value name changed | An enum value was renamed |
+
+## Backward-Compatible Alternatives
+
+Instead of making a breaking change, use these patterns:
+
+| Breaking Change | Safe Alternative |
+|----------------|-----------------|
+| Remove a field | Mark as `reserved` and deprecate: `reserved 3; reserved "old_field";` |
+| Change field type | Add a new field with the new type, deprecate the old one |
+| Remove an enum value | Reserve the number and name, add replacement value |
+| Rename an enum value | Add new value, deprecate old (both keep same number) |
+| Remove an RPC | Deprecate with `option deprecated = true;` first |
+| Remove a service | Deprecate first, remove in next major version |
+| Change RPC request/response | Create a new RPC with new types |
+
+## Ignoring Breaking Changes
+
+For intentional breaks, add paths to `breaking.ignore`:
+
+```yaml
+breaking:
+  ignore:
+    - proto/internal/experimental
+```
+
+Or change the comparison ref to start fresh:
+
+```yaml
+breaking:
+  against_git_ref: v2.0.0    # Compare against a specific release tag
+```
diff --git a/.agents/skills/protobuf-expert-skill/references/ci-cd-integration.md b/.agents/skills/protobuf-expert-skill/references/ci-cd-integration.md
new file mode 100644
index 00000000..0138dfd8
--- /dev/null
+++ b/.agents/skills/protobuf-expert-skill/references/ci-cd-integration.md
@@ -0,0 +1,171 @@
+# EasyP CI/CD Integration
+
+## GitHub Actions (Official)
+
+EasyP provides official GitHub Actions at [easyp-tech/actions](https://github.com/easyp-tech/actions).
+
+### Lint on push and PR
+
+```yaml
+name: easyp-lint
+on: [push, pull_request]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: easyp-tech/actions/lint@v1
+        with:
+          version: v0.12.2
+```
+
+### Breaking change detection on PR
+
+```yaml
+name: easyp-breaking
+on: [pull_request]
+
+jobs:
+  breaking:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0    # Required — needs full git history
+      - uses: easyp-tech/actions/breaking@v1
+        with:
+          version: v0.12.2
+          against: origin/main
+```
+
+### Combined workflow (lint + breaking)
+
+```yaml
+name: easyp
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: easyp-tech/actions/lint@v1
+        with:
+          version: v0.12.2
+
+  breaking:
+    name: Breaking Changes
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: easyp-tech/actions/breaking@v1
+        with:
+          version: v0.12.2
+          against: origin/main
+```
+
+Features of official actions:
+- Pre-built Docker images (fast, no compilation)
+- GitHub Annotations (errors appear on PR diff lines)
+- Version pinning via `version` input
+
+## GitLab CI
+
+```yaml
+stages:
+  - proto
+
+easyp-lint:
+  stage: proto
+  image: ghcr.io/easyp-tech/easyp:v0.12.2
+  script:
+    - easyp lint
+  rules:
+    - changes:
+        - "**/*.proto"
+        - easyp.yaml
+
+easyp-breaking:
+  stage: proto
+  image: ghcr.io/easyp-tech/easyp:v0.12.2
+  script:
+    - easyp breaking --against origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME
+  variables:
+    GIT_DEPTH: 0
+  rules:
+    - if: $CI_MERGE_REQUEST_IID
+      changes:
+        - "**/*.proto"
+        - easyp.yaml
+```
+
+## Makefile
+
+```makefile
+EASYP_VERSION ?= latest
+
+.PHONY: proto-lint proto-breaking proto-generate proto-download proto-validate
+
+proto-lint:
+	easyp lint
+
+proto-breaking:
+	easyp breaking --against main
+
+proto-generate:
+	easyp generate
+
+proto-download:
+	easyp mod download
+
+proto-validate:
+	easyp validate-config
+
+proto-all: proto-download proto-lint proto-generate
+```
+
+## Pre-commit Hook
+
+```bash
+#!/bin/sh
+# .git/hooks/pre-commit
+
+# Lint only changed proto files
+if git diff --cached --name-only | grep -q '\.proto$'; then
+  easyp lint
+  if [ $? -ne 0 ]; then
+    echo "Proto lint failed. Fix issues before committing."
+    exit 1
+  fi
+fi
+```
+
+## Docker-based CI (generic)
+
+For any CI system that supports Docker:
+
+```bash
+docker run --rm \
+  -v $(pwd):/workspace \
+  -w /workspace \
+  ghcr.io/easyp-tech/easyp:v0.12.2 \
+  lint
+```
+
+## Important CI Notes
+
+- **Breaking checks need full git history** — use `fetch-depth: 0` or `GIT_DEPTH: 0`
+- **Pin the EasyP version** — avoid `latest` in CI for reproducibility
+- **Run `validate-config` first** — catches config issues before lint/generate
+- **Cache dependencies** — `easyp mod download` results are cached in `~/.cache/easyp`
diff --git a/.agents/skills/protobuf-expert-skill/references/cli-commands.md b/.agents/skills/protobuf-expert-skill/references/cli-commands.md
new file mode 100644
index 00000000..f35b3341
--- /dev/null
+++ b/.agents/skills/protobuf-expert-skill/references/cli-commands.md
@@ -0,0 +1,153 @@
+# EasyP CLI Commands Reference
+
+## Global Flags
+
+| Flag | Short | Type | Default | Env Var | Description |
+|------|-------|------|---------|---------|-------------|
+| `--cfg` / `--config` | — | string | `easyp.yaml` | `EASYP_CFG` | Path to config file |
+| `--debug` | `-d` | bool | `false` | `EASYP_DEBUG` | Enable debug logging |
+| `--format` | `-f` | enum | `text` | `EASYP_FORMAT` | Output format: `text` or `json` |
+
+---
+
+## lint (alias: l)
+
+Lint `.proto` files against configured rules.
+
+**Flags:**
+
+| Flag | Short | Type | Default | Description |
+|------|-------|------|---------|-------------|
+| `--path` | `-p` | string | `.` | Relative path to proto directory |
+| `--root` | `-r` | string | project root | Root directory for file search |
+
+**Output formats:**
+- Text: `path:line:column:source message (rule_name)`
+- JSON: Structured issue objects
+
+**Exit codes:** 0 = no issues, 1 = lint issues found, 2 = critical error (e.g., import failure)
+
+---
+
+## generate (alias: g)
+
+Generate code from proto files using configured plugins.
+
+**Flags:**
+
+| Flag | Short | Type | Default | Description |
+|------|-------|------|---------|-------------|
+| `--path` | `-p` | string | `.` | Relative path to proto directory |
+| `--root` | `-r` | string | project root | Root directory for file search |
+| `--descriptor_set_out` | — | string | — | Output path for binary FileDescriptorSet |
+| `--include_imports` | — | bool | `false` | Include transitive deps in FileDescriptorSet |
+
+**Env:** `EASYP_ROOT_GENERATE_PATH` overrides `--path`.
+
+---
+
+## breaking
+
+Detect breaking API changes by comparing against a git ref.
+
+**Flags:**
+
+| Flag | Short | Type | Default | Description |
+|------|-------|------|---------|-------------|
+| `--path` | `-p` | string | `.` | Relative path to proto directory |
+| `--against` | — | string | `master` | Git branch/ref to compare against |
+
+**Exit codes:** 0 = no breaking changes, 1 = breaking changes found, 2 = critical error
+
+---
+
+## mod (alias: m)
+
+Package manager for proto dependencies.
+
+### mod download
+
+Download all dependencies from `deps` and `generate.inputs[].git_repo` to local cache.
+
+No additional flags. Exit code 1 if version not found.
+
+### mod update
+
+Update cached modules to versions specified in config.
+
+No additional flags. Exit code 1 if version not found.
+
+### mod vendor
+
+Copy proto files from cached dependencies into `vendor/` directory.
+
+No additional flags. Exit code 1 if version not found.
+
+---
+
+## init (alias: i)
+
+Interactive configuration setup — creates `easyp.yaml`.
+
+**Flags:**
+
+| Flag | Short | Type | Default | Description |
+|------|-------|------|---------|-------------|
+| `--dir` | `-d` | string | `.` | Directory to initialize |
+
+**Env:** `EASYP_INIT_DIR` overrides `--dir`.
+
+Prompts for: lint rule groups, enum zero value suffix, service suffix, breaking check ref, generate plugins, dependencies.
+
+---
+
+## validate-config (alias: validate)
+
+Validate `easyp.yaml` syntax and structure.
+
+**Output:**
+- JSON: `{"valid": bool, "errors": [...], "warnings": [...]}`
+- Text: tabular format with counts
+
+**Exit codes:** 0 = valid, 1 = validation errors
+
+---
+
+## ls-files (alias: ls)
+
+List `.proto` files considering inputs and imports.
+
+**Flags:**
+
+| Flag | Short | Type | Default | Description |
+|------|-------|------|---------|-------------|
+| `--include-imports` | `-I` | bool | `true` | Include transitive import dependencies |
+
+**Output:** JSON or text with roots, files (source, import path, absolute path), and errors.
+
+---
+
+## schema-gen
+
+Generate JSON Schema artifacts for `easyp.yaml` (for IDE autocompletion).
+
+**Flags:**
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--out-versioned` | string | `schemas/easyp-config-v1.schema.json` | Versioned schema output |
+| `--out-latest` | string | `schemas/easyp-config.schema.json` | Latest schema alias output |
+
+---
+
+## completion
+
+Generate shell completion scripts.
+
+### completion bash
+
+Outputs bash completion function for the `easyp` command.
+
+### completion zsh
+
+Outputs zsh completion function for the `easyp` command.
diff --git a/.agents/skills/protobuf-expert-skill/references/config-reference.md b/.agents/skills/protobuf-expert-skill/references/config-reference.md
new file mode 100644
index 00000000..ad74ba1f
--- /dev/null
+++ b/.agents/skills/protobuf-expert-skill/references/config-reference.md
@@ -0,0 +1,160 @@
+# EasyP Configuration Reference (easyp.yaml)
+
+Complete reference for all configuration sections and options.
+
+## Minimal Example
+
+```yaml
+lint:
+  use:
+    - DEFAULT
+```
+
+## Full Structure
+
+```yaml
+# ─── Lint ───────────────────────────────────────────────
+lint:
+  use:                              # Required. Rule names or group names.
+    - DEFAULT                       # Groups: MINIMAL, BASIC, DEFAULT, COMMENTS, UNARY_RPC
+    - COMMENTS
+    - PACKAGE_NO_IMPORT_CYCLE       # Individual rule names also accepted
+
+  except:                           # Rules to exclude (even if included by group)
+    - SERVICE_SUFFIX
+    - PACKAGE_VERSION_SUFFIX
+
+  enum_zero_value_suffix: _UNSPECIFIED  # Suffix for ENUM_ZERO_VALUE_SUFFIX rule (default: _UNSPECIFIED)
+  service_suffix: Service               # Suffix for SERVICE_SUFFIX rule (default: Service)
+
+  allow_comment_ignores: true       # Allow // easyp:off / // easyp:on in proto files
+
+  ignore:                           # Directories to skip entirely
+    - proto/vendor
+    - proto/third_party
+
+  ignore_only:                      # Per-rule path ignores
+    FIELD_LOWER_SNAKE_CASE:
+      - proto/legacy
+    COMMENT_FIELD:
+      - proto/internal
+
+# ─── Dependencies ──────────────────────────────────────
+# Declared in protobuf.mod (not easyp.yaml):
+# direct (
+# 	github.com/googleapis/googleapis@v1.0.0
+# )
+
+# ─── Generate ──────────────────────────────────────────
+generate:
+  inputs:                           # Proto file sources
+    - directory: proto              # Local directory (shorthand)
+    - directory:                    # Full form with all fields
+        path: proto                 #   Path to proto files
+        root: .                     #   Root directory (default: ".")
+
+    - git_repo:                     # Remote git repository
+        url: github.com/user/repo@v1.0.0
+        sub_directory: proto        # Optional: subdirectory within repo
+        root: .                     # Optional: root within subdirectory
+
+  plugins:
+    - name: go                      # Plugin source (one of: name, remote, path, command)
+      out: gen/go                   # Output directory
+      opts:                         # Plugin-specific options (key-value)
+        paths: source_relative
+      with_imports: false           # Generate code for imported files too
+
+    - remote: buf.build/grpc/go     # Remote plugin from registry
+      out: gen/go
+      opts:
+        paths: source_relative
+
+    - path: /usr/local/bin/protoc-gen-custom  # Local binary path
+      out: gen/custom
+
+    - command:                      # Command array to execute
+        - docker
+        - run
+        - --rm
+        - protoc-gen-custom
+      out: gen/custom
+
+  managed:                          # Managed mode — auto-set file/field options
+    enabled: true
+
+    disable:                        # Disable managed mode for specific targets
+      - module: google.protobuf     # By module name
+      - package: com.example        # By proto package
+      - path: proto/internal        # By file path
+      - file_option: go_package     # By file option name
+      - field_option: "(custom)"    # By field option name
+      - field: pkg.Message.field    # By fully qualified field name
+
+    override:                       # Override specific options
+      - file_option: go_package     # Override a file option
+        value: github.com/myorg/pkg
+        module: myapp               # Optional: limit to module
+        package: com.example        # Optional: limit to proto package
+        path: proto/api             # Optional: limit to path
+
+      - field_option: "(validate.rules)"  # Override a field option
+        value: true
+        field: pkg.Message.field    # Optional: limit to specific field
+
+      - file_option: java_package
+        value: com.myorg.proto
+
+# ─── Breaking Change Detection ────────────────────────
+breaking:
+  ignore:                           # Paths to exclude from breaking checks
+    - proto/internal
+    - proto/experimental
+
+  against_git_ref: main             # Default git ref to compare against
+```
+
+Dependencies are declared in `protobuf.mod` (not in `easyp.yaml`):
+
+```
+direct (
+	github.com/googleapis/googleapis
+	github.com/grpc-ecosystem/grpc-gateway@v2.0.0
+	github.com/user/repo@abc123def
+)
+```
+
+## Plugin Source Priority
+
+Each plugin must specify exactly ONE source:
+
+| Source | Description | Example |
+|--------|-------------|---------|
+| `name` | Built-in plugin name | `go`, `go-grpc`, `grpc-gateway`, `openapiv2`, `validate-go` |
+| `remote` | Registry URL | `buf.build/grpc/go` |
+| `path` | Local binary path | `/usr/local/bin/protoc-gen-foo` |
+| `command` | Command array | `["docker", "run", "gen-image"]` |
+
+Plugin `opts` values can be scalars or arrays:
+
+```yaml
+opts:
+  paths: source_relative                    # Scalar value
+  require_unimplemented_servers: false       # Boolean value
+```
+
+## Managed Mode
+
+When `managed.enabled: true`, EasyP automatically sets file options (like `go_package`, `java_package`) based on the proto file's package and path, reducing boilerplate.
+
+Use `managed.disable` to exclude specific modules, packages, or paths from managed mode.
+Use `managed.override` to set specific option values for specific modules.
+
+## Validation
+
+Always validate config after editing:
+
+```sh
+easyp validate-config
+easyp validate-config --format json
+```
diff --git a/.agents/skills/protobuf-expert-skill/references/installation.md b/.agents/skills/protobuf-expert-skill/references/installation.md
new file mode 100644
index 00000000..0005a77b
--- /dev/null
+++ b/.agents/skills/protobuf-expert-skill/references/installation.md
@@ -0,0 +1,58 @@
+# EasyP Installation Guide
+
+## Homebrew (macOS / Linux)
+
+```bash
+brew install easyp-tech/tap/easyp
+```
+
+## Go Install
+
+Requires Go 1.21+:
+
+```bash
+go install github.com/easyp-tech/easyp/cmd/easyp@latest
+```
+
+## npm
+
+```bash
+npx easyp@latest --help
+```
+
+## Docker
+
+```bash
+docker run --rm -v $(pwd):/workspace ghcr.io/easyp-tech/easyp:latest lint
+```
+
+## Binary from GitHub Releases
+
+Download the appropriate binary from [GitHub Releases](https://github.com/easyp-tech/easyp/releases):
+
+```bash
+# Example for Linux amd64
+curl -Lo easyp https://github.com/easyp-tech/easyp/releases/latest/download/easyp_linux_amd64
+chmod +x easyp
+sudo mv easyp /usr/local/bin/
+```
+
+## Verify Installation
+
+```bash
+easyp --help
+```
+
+## Shell Completions
+
+```bash
+# Bash
+easyp completion bash >> ~/.bashrc
+
+# Zsh
+easyp completion zsh >> ~/.zshrc
+```
+
+## Official Documentation
+
+For the most up-to-date installation methods, see [easyp.tech/docs/guide/introduction/install](https://easyp.tech/docs/guide/introduction/install).
diff --git a/.agents/skills/protobuf-expert-skill/references/lint-rules.md b/.agents/skills/protobuf-expert-skill/references/lint-rules.md
new file mode 100644
index 00000000..c3b593af
--- /dev/null
+++ b/.agents/skills/protobuf-expert-skill/references/lint-rules.md
@@ -0,0 +1,154 @@
+# EasyP Lint Rules Reference
+
+EasyP provides 42 lint rules organized into 5 groups. Groups are cumulative — `BASIC` includes `MINIMAL`, `DEFAULT` includes `BASIC`.
+
+## Rule Groups
+
+| Group | Rules | Description |
+|-------|-------|-------------|
+| `MINIMAL` | 4 | Package consistency only |
+| `BASIC` | 24 | MINIMAL + naming conventions and import hygiene |
+| `DEFAULT` | 32 | BASIC + enum/RPC/service/file standards |
+| `COMMENTS` | 7 | Documentation requirements for all entities |
+| `UNARY_RPC` | 2 | Disallow streaming RPCs |
+
+Use a group name directly in `lint.use` to enable all its rules.
+
+---
+
+## MINIMAL Group (4 rules)
+
+| Rule | What it checks |
+|------|----------------|
+| `DIRECTORY_SAME_PACKAGE` | All `.proto` files in the same directory must declare the same package |
+| `PACKAGE_DEFINED` | Every file must have a `package` declaration |
+| `PACKAGE_DIRECTORY_MATCH` | Package name must match the directory path |
+| `PACKAGE_SAME_DIRECTORY` | All files declaring the same package must be in the same directory |
+
+---
+
+## BASIC Group (adds 20 rules)
+
+### Naming
+
+| Rule | What it checks |
+|------|----------------|
+| `ENUM_PASCAL_CASE` | Enum type names must be PascalCase |
+| `ENUM_VALUE_UPPER_SNAKE_CASE` | Enum values must be UPPER_SNAKE_CASE |
+| `FIELD_LOWER_SNAKE_CASE` | Message field names must be lower_snake_case |
+| `MESSAGE_PASCAL_CASE` | Message type names must be PascalCase |
+| `ONEOF_LOWER_SNAKE_CASE` | Oneof field names must be lower_snake_case |
+| `PACKAGE_LOWER_SNAKE_CASE` | Package names must be lower_snake_case |
+| `RPC_PASCAL_CASE` | RPC method names must be PascalCase |
+| `SERVICE_PASCAL_CASE` | Service names must be PascalCase |
+
+### Enums
+
+| Rule | What it checks |
+|------|----------------|
+| `ENUM_FIRST_VALUE_ZERO` | First enum value must have number 0 |
+| `ENUM_NO_ALLOW_ALIAS` | Enums must not use `allow_alias = true` |
+
+### Imports
+
+| Rule | What it checks |
+|------|----------------|
+| `IMPORT_NO_PUBLIC` | No `import public` statements |
+| `IMPORT_NO_WEAK` | No `import weak` statements |
+| `IMPORT_USED` | All imports must be referenced |
+
+### Cross-file Package Consistency
+
+| Rule | What it checks |
+|------|----------------|
+| `PACKAGE_SAME_CSHARP_NAMESPACE` | Files in same package must have same `csharp_namespace` |
+| `PACKAGE_SAME_GO_PACKAGE` | Files in same package must have same `go_package` |
+| `PACKAGE_SAME_JAVA_MULTIPLE_FILES` | Files in same package must have same `java_multiple_files` |
+| `PACKAGE_SAME_JAVA_PACKAGE` | Files in same package must have same `java_package` |
+| `PACKAGE_SAME_PHP_NAMESPACE` | Files in same package must have same `php_namespace` |
+| `PACKAGE_SAME_RUBY_PACKAGE` | Files in same package must have same `ruby_package` |
+| `PACKAGE_SAME_SWIFT_PREFIX` | Files in same package must have same `swift_prefix` |
+
+---
+
+## DEFAULT Group (adds 8 rules)
+
+| Rule | What it checks | Config |
+|------|----------------|--------|
+| `ENUM_VALUE_PREFIX` | Enum values must be prefixed with the enum type name in UPPER_SNAKE_CASE | — |
+| `ENUM_ZERO_VALUE_SUFFIX` | Zero-value enum entry must end with a specific suffix | `lint.enum_zero_value_suffix` (default: `_UNSPECIFIED`) |
+| `FILE_LOWER_SNAKE_CASE` | `.proto` file names must be lower_snake_case | — |
+| `RPC_REQUEST_RESPONSE_UNIQUE` | Each RPC request/response type must be used by only one RPC | — |
+| `RPC_REQUEST_STANDARD_NAME` | RPC request type must be named `<MethodName>Request` | — |
+| `RPC_RESPONSE_STANDARD_NAME` | RPC response type must be named `<MethodName>Response` | — |
+| `PACKAGE_VERSION_SUFFIX` | Package must end with a version (e.g., `.v1`, `.v2beta1`) | — |
+| `SERVICE_SUFFIX` | Service names must end with a configurable suffix | `lint.service_suffix` (default: `Service`) |
+
+---
+
+## COMMENTS Group (7 rules)
+
+| Rule | What it checks |
+|------|----------------|
+| `COMMENT_ENUM` | Enum types must have a non-empty leading comment |
+| `COMMENT_ENUM_VALUE` | Enum values must have a non-empty leading comment |
+| `COMMENT_FIELD` | Message fields must have a non-empty leading comment |
+| `COMMENT_MESSAGE` | Message types must have a non-empty leading comment |
+| `COMMENT_ONEOF` | Oneof fields must have a non-empty leading comment |
+| `COMMENT_RPC` | RPC methods must have a non-empty leading comment |
+| `COMMENT_SERVICE` | Services must have a non-empty leading comment |
+
+---
+
+## UNARY_RPC Group (2 rules)
+
+| Rule | What it checks |
+|------|----------------|
+| `RPC_NO_CLIENT_STREAMING` | RPCs must not use client streaming |
+| `RPC_NO_SERVER_STREAMING` | RPCs must not use server streaming |
+
+---
+
+## Uncategorized (1 rule)
+
+| Rule | What it checks |
+|------|----------------|
+| `PACKAGE_NO_IMPORT_CYCLE` | Packages must not have circular import dependencies |
+
+---
+
+## Suppression
+
+### Ignoring paths
+
+```yaml
+lint:
+  ignore:
+    - proto/vendor        # Ignore entire directories
+  ignore_only:
+    FIELD_LOWER_SNAKE_CASE:
+      - proto/legacy      # Ignore specific rule for specific paths
+```
+
+### Inline comment ignores
+
+Enable with `lint.allow_comment_ignores: true`, then use in `.proto` files:
+
+```protobuf
+// easyp:off
+message legacy_message {  // This won't trigger MESSAGE_PASCAL_CASE
+  string BadField = 1;    // This won't trigger FIELD_LOWER_SNAKE_CASE
+}
+// easyp:on
+```
+
+### Excluding rules
+
+```yaml
+lint:
+  use:
+    - DEFAULT
+  except:
+    - SERVICE_SUFFIX          # Disable individual rules from a group
+    - PACKAGE_VERSION_SUFFIX
+```
diff --git a/.agents/skills/protobuf-expert-skill/references/migration-from-buf.md b/.agents/skills/protobuf-expert-skill/references/migration-from-buf.md
new file mode 100644
index 00000000..1f4df047
--- /dev/null
+++ b/.agents/skills/protobuf-expert-skill/references/migration-from-buf.md
@@ -0,0 +1,132 @@
+# Migration from buf.build to EasyP
+
+EasyP is a drop-in replacement for buf.build. This guide maps buf concepts to EasyP equivalents.
+
+## Command Mapping
+
+| buf command | EasyP equivalent | Notes |
+|-------------|-----------------|-------|
+| `buf lint` | `easyp lint` | Same rule names and groups |
+| `buf breaking` | `easyp breaking` | Same detection categories |
+| `buf generate` | `easyp generate` | Supports local + remote plugins |
+| `buf mod update` | `easyp mod update` | Git-native dependencies |
+| `buf mod init` | `easyp init` | Interactive setup wizard |
+| `buf build` | `easyp generate --descriptor_set_out` | FileDescriptorSet output |
+| `buf format` | — | Not yet supported |
+| `buf push` | — | Not needed (uses Git repos directly) |
+| `buf registry` | — | Not needed (uses Git repos directly) |
+
+## Config File Mapping
+
+| buf file | EasyP file | Notes |
+|----------|-----------|-------|
+| `buf.yaml` | `easyp.yaml` | Single config for all features |
+| `buf.gen.yaml` | `easyp.yaml` (`generate` section) | Merged into main config |
+| `buf.lock` | — | Uses Git refs for pinning |
+
+## Config Structure Migration
+
+### buf.yaml → easyp.yaml: Lint
+
+```yaml
+# buf.yaml                          # easyp.yaml
+version: v1                         # (no version field)
+lint:                                lint:
+  use:                                 use:
+    - DEFAULT                            - DEFAULT
+  except:                              except:
+    - SERVICE_SUFFIX                     - SERVICE_SUFFIX
+  ignore:                              ignore:
+    - proto/vendor                       - proto/vendor
+  allow_comment_ignores: true          allow_comment_ignores: true
+  enum_zero_value_suffix: _UNSPECIFIED enum_zero_value_suffix: _UNSPECIFIED
+  service_suffix: Service              service_suffix: Service
+```
+
+### buf.yaml → easyp.yaml: Breaking
+
+```yaml
+# buf.yaml                          # easyp.yaml
+breaking:                            breaking:
+  use:                                 # (no `use` — all checks enabled)
+    - FILE                             ignore:
+  ignore:                                - proto/internal
+    - proto/internal                   against_git_ref: main
+```
+
+### buf.yaml → easyp: Dependencies
+
+```yaml
+# buf.yaml
+deps:
+  - buf.build/googleapis/googleapis
+  - buf.build/grpc/grpc
+```
+
+```
+# protobuf.mod
+direct (
+	github.com/googleapis/googleapis
+	github.com/grpc/grpc@v1.60.0
+)
+```
+
+Key difference: buf uses BSR module references, EasyP uses **Git repository URLs** in `protobuf.mod` with optional `@version` or `@commit` suffixes.
+
+### buf.gen.yaml → easyp.yaml: Code Generation
+
+```yaml
+# buf.gen.yaml                      # easyp.yaml
+version: v1                         generate:
+plugins:                               inputs:
+  - plugin: go                           - directory: proto
+    out: gen/go                        plugins:
+    opt: paths=source_relative           - name: go
+  - plugin: buf.build/grpc/go              out: gen/go
+    out: gen/go                            opts:
+    opt: paths=source_relative               paths: source_relative
+                                         - remote: buf.build/grpc/go
+                                             out: gen/go
+                                             opts:
+                                               paths: source_relative
+```
+
+Key differences:
+- `opt` (string) → `opts` (key-value map)
+- `plugin` → `name`, `remote`, `path`, or `command`
+- Inputs are declared explicitly in `generate.inputs`
+
+## Lint Rule Compatibility
+
+EasyP supports the **same rule names and groups** as buf:
+
+| Group | Rules | Equivalent |
+|-------|-------|-----------|
+| `MINIMAL` | 4 rules | Identical |
+| `BASIC` | 24 rules | Identical |
+| `DEFAULT` | 32 rules | Identical |
+| `COMMENTS` | 7 rules | Identical |
+| `UNARY_RPC` | 2 rules | Identical |
+
+Inline suppression uses `// easyp:off` / `// easyp:on` (instead of `// buf:lint:ignore`).
+
+## Dependency Management Differences
+
+| Concept | buf | EasyP |
+|---------|-----|-------|
+| Registry | BSR (buf.build) | Git repositories |
+| Pinning | `buf.lock` | `@version` or `@commit` in deps URL |
+| Download | `buf mod update` | `easyp mod download` |
+| Vendoring | — | `easyp mod vendor` |
+
+## Migration Steps
+
+1. **Rename config**: Create `easyp.yaml` based on your `buf.yaml` + `buf.gen.yaml`
+2. **Convert deps**: Replace BSR module refs with Git repository URLs
+3. **Convert plugins**: Map `plugin` + `opt` to `name`/`remote` + `opts`
+4. **Download deps**: `easyp mod download`
+5. **Test lint**: `easyp lint` — should produce same results
+6. **Test generate**: `easyp generate` — verify output matches
+7. **Test breaking**: `easyp breaking --against main`
+8. **Update CI**: Replace buf actions with [easyp-tech/actions](https://github.com/easyp-tech/actions)
+9. **Remove buf files**: Delete `buf.yaml`, `buf.gen.yaml`, `buf.lock`
diff --git a/.agents/skills/protobuf-expert-skill/references/protobuf-best-practices.md b/.agents/skills/protobuf-expert-skill/references/protobuf-best-practices.md
new file mode 100644
index 00000000..23d7affd
--- /dev/null
+++ b/.agents/skills/protobuf-expert-skill/references/protobuf-best-practices.md
@@ -0,0 +1,237 @@
+# Protobuf Best Practices (EasyP-aligned)
+
+Best practices for writing `.proto` files that are idiomatic, maintainable, and pass EasyP lint rules.
+
+## File Organization
+
+### File naming
+- Use `lower_snake_case.proto` for all file names → enforced by `FILE_LOWER_SNAKE_CASE`
+- One service per file (or group tightly related messages)
+- Name the file after the primary entity: `user_service.proto`, `order.proto`
+
+### Package structure
+- Use dot-separated, lower_snake_case packages → enforced by `PACKAGE_LOWER_SNAKE_CASE`
+- End with a version suffix → enforced by `PACKAGE_VERSION_SUFFIX`
+- Match directory layout → enforced by `PACKAGE_DIRECTORY_MATCH`
+
+```
+proto/
+  myapp/
+    user/
+      v1/
+        user_service.proto    → package myapp.user.v1;
+        user.proto            → package myapp.user.v1;
+    order/
+      v1/
+        order_service.proto   → package myapp.order.v1;
+```
+
+### File options
+- Set `go_package`, `java_package`, etc. consistently within each package
+- Enforced by `PACKAGE_SAME_GO_PACKAGE`, `PACKAGE_SAME_JAVA_PACKAGE`, etc.
+- Consider using EasyP's managed mode to auto-set these
+
+---
+
+## Naming Conventions
+
+| Entity | Convention | Example | EasyP Rule |
+|--------|-----------|---------|------------|
+| Message | PascalCase | `UserProfile` | `MESSAGE_PASCAL_CASE` |
+| Field | lower_snake_case | `first_name` | `FIELD_LOWER_SNAKE_CASE` |
+| Service | PascalCase + suffix | `UserService` | `SERVICE_PASCAL_CASE`, `SERVICE_SUFFIX` |
+| RPC | PascalCase | `GetUser` | `RPC_PASCAL_CASE` |
+| Enum type | PascalCase | `UserStatus` | `ENUM_PASCAL_CASE` |
+| Enum value | UPPER_SNAKE_CASE | `USER_STATUS_ACTIVE` | `ENUM_VALUE_UPPER_SNAKE_CASE` |
+| Oneof | lower_snake_case | `auth_method` | `ONEOF_LOWER_SNAKE_CASE` |
+| Package | lower_snake_case | `myapp.user.v1` | `PACKAGE_LOWER_SNAKE_CASE` |
+| File | lower_snake_case | `user_service.proto` | `FILE_LOWER_SNAKE_CASE` |
+
+---
+
+## Enums
+
+### Zero value
+Every enum must have a zero value with a suffix like `_UNSPECIFIED`:
+
+```protobuf
+enum UserStatus {
+  USER_STATUS_UNSPECIFIED = 0;  // Default/unknown
+  USER_STATUS_ACTIVE = 1;
+  USER_STATUS_INACTIVE = 2;
+}
+```
+
+- Zero value rule → `ENUM_ZERO_VALUE_SUFFIX` (configurable suffix)
+- First value must be 0 → `ENUM_FIRST_VALUE_ZERO`
+
+### Value prefixing
+Prefix all values with the enum type in UPPER_SNAKE_CASE → `ENUM_VALUE_PREFIX`:
+
+```protobuf
+// Good
+enum Color {
+  COLOR_UNSPECIFIED = 0;
+  COLOR_RED = 1;
+}
+
+// Bad — values lack prefix
+enum Color {
+  UNSPECIFIED = 0;
+  RED = 1;
+}
+```
+
+### No aliases
+Avoid `allow_alias = true` → `ENUM_NO_ALLOW_ALIAS`. Use separate values instead.
+
+---
+
+## Services and RPCs
+
+### Request/Response pattern
+Each RPC should have unique, method-named request and response types:
+
+```protobuf
+service UserService {
+  rpc GetUser(GetUserRequest) returns (GetUserResponse);
+  rpc ListUsers(ListUsersRequest) returns (ListUsersResponse);
+  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
+}
+```
+
+- Unique types → `RPC_REQUEST_RESPONSE_UNIQUE`
+- Naming convention → `RPC_REQUEST_STANDARD_NAME`, `RPC_RESPONSE_STANDARD_NAME`
+
+### Service suffix
+Use a consistent suffix (default: `Service`) → `SERVICE_SUFFIX`
+
+### Streaming considerations
+If using `UNARY_RPC` rules, streaming is disallowed. Design APIs as unary where possible. Use streaming only when truly needed (large data transfers, real-time updates).
+
+---
+
+## Comments and Documentation
+
+Document all public entities with leading comments:
+
+```protobuf
+// UserService handles user account operations.
+service UserService {
+  // GetUser retrieves a user by their unique identifier.
+  rpc GetUser(GetUserRequest) returns (GetUserResponse);
+}
+
+// UserStatus represents the current state of a user account.
+enum UserStatus {
+  // USER_STATUS_UNSPECIFIED is the default value.
+  USER_STATUS_UNSPECIFIED = 0;
+  // USER_STATUS_ACTIVE means the user can log in.
+  USER_STATUS_ACTIVE = 1;
+}
+
+// GetUserRequest contains the parameters for retrieving a user.
+message GetUserRequest {
+  // user_id is the unique identifier of the user.
+  string user_id = 1;
+}
+```
+
+Enforced by `COMMENT_SERVICE`, `COMMENT_RPC`, `COMMENT_ENUM`, `COMMENT_ENUM_VALUE`, `COMMENT_MESSAGE`, `COMMENT_FIELD`, `COMMENT_ONEOF`.
+
+---
+
+## Imports
+
+- Remove unused imports → `IMPORT_USED`
+- Never use `import public` → `IMPORT_NO_PUBLIC`
+- Never use `import weak` → `IMPORT_NO_WEAK`
+- Avoid circular package imports → `PACKAGE_NO_IMPORT_CYCLE`
+
+---
+
+## Backward Compatibility
+
+### Never do
+
+- Remove or rename fields (reserve instead)
+- Change field types or numbers
+- Remove enum values (reserve instead)
+- Remove or rename RPCs
+- Change RPC request/response types
+
+### Safe changes
+
+- Add new fields (with new field numbers)
+- Add new enum values
+- Add new RPCs to existing services
+- Add new services
+- Add new messages
+- Deprecate fields with `[deprecated = true]`
+
+### Reservations
+
+When removing a field or enum value, reserve both the number and the name:
+
+```protobuf
+message User {
+  reserved 3, 7;
+  reserved "old_field", "legacy_field";
+
+  string name = 1;
+  string email = 2;
+  // field 3 was old_field (removed in v1.2)
+}
+```
+
+---
+
+## API Design Patterns
+
+### Use wrapper messages
+Always wrap request and response in dedicated messages (never use primitives directly):
+
+```protobuf
+// Good
+rpc GetUser(GetUserRequest) returns (GetUserResponse);
+
+// Bad — cannot evolve without breaking
+rpc GetUser(google.protobuf.StringValue) returns (User);
+```
+
+### Pagination
+For list endpoints, use cursor-based or offset pagination:
+
+```protobuf
+message ListUsersRequest {
+  int32 page_size = 1;
+  string page_token = 2;
+}
+
+message ListUsersResponse {
+  repeated User users = 1;
+  string next_page_token = 2;
+}
+```
+
+### Field masks
+Use `google.protobuf.FieldMask` for partial updates:
+
+```protobuf
+message UpdateUserRequest {
+  User user = 1;
+  google.protobuf.FieldMask update_mask = 2;
+}
+```
+
+### Standard method names
+Follow consistent verb patterns: `Get`, `List`, `Create`, `Update`, `Delete`, `BatchGet`, `BatchCreate`.
+
+---
+
+## Versioning
+
+- Use package version suffixes: `myapp.user.v1`, `myapp.user.v2`
+- Never make breaking changes within a version — create `v2` instead
+- Keep old versions running until all clients migrate
+- Enforced by `PACKAGE_VERSION_SUFFIX`
diff --git a/.agents/skills/protobuf-expert-skill/references/troubleshooting.md b/.agents/skills/protobuf-expert-skill/references/troubleshooting.md
new file mode 100644
index 00000000..d0ece6f5
--- /dev/null
+++ b/.agents/skills/protobuf-expert-skill/references/troubleshooting.md
@@ -0,0 +1,135 @@
+# EasyP Troubleshooting Guide
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success (no issues) |
+| 1 | Issues found (lint violations, breaking changes, validation errors) |
+| 2 | Critical error (import failure, config error, runtime crash) |
+
+## Common Errors
+
+### Import not found
+
+**Symptom:** `exit code 2` with message like `import "google/protobuf/timestamp.proto" not found`
+
+**Causes & fixes:**
+1. Missing dependency — add to `protobuf.mod`:
+   ```
+   direct (
+   	github.com/protocolbuffers/protobuf@v25.0
+   )
+   ```
+2. Dependencies not downloaded — run `easyp mod download`
+3. Wrong `--path` flag — ensure it points to the correct proto directory
+
+### Config validation errors
+
+**Symptom:** `easyp validate-config` returns errors
+
+**Debug:**
+```bash
+easyp validate-config --format json
+```
+
+**Common causes:**
+- Unknown keys (typos in field names) — including legacy `deps` in `easyp.yaml`
+- Missing required fields (`lint.use` is required)
+- Invalid rule names in `lint.use` or `lint.except`
+- Plugin missing exactly one source (`name`, `remote`, `path`, or `command`)
+
+### Lint rule not working
+
+**Symptom:** Expected lint violation not reported
+
+**Check:**
+1. Rule is in `lint.use` (either directly or via group)
+2. Rule is NOT in `lint.except`
+3. File path is NOT in `lint.ignore`
+4. Rule is NOT suppressed by `// easyp:off` in the proto file
+5. Run with `--debug` for verbose output: `easyp lint --debug`
+
+### Breaking check fails with "could not get git ref"
+
+**Symptom:** `easyp breaking --against main` fails
+
+**Causes:**
+- Shallow clone — need full history: `git fetch --unshallow` or `fetch-depth: 0` in CI
+- Wrong ref name — verify with `git branch -a` or `git tag -l`
+- Detached HEAD — specify explicit branch: `--against origin/main`
+
+### Generate produces no output
+
+**Symptom:** `easyp generate` runs but no files are created
+
+**Check:**
+1. `generate.inputs` points to directory with `.proto` files
+2. Plugin binary is installed and in `$PATH` (for `name` source)
+3. `out` directory exists or plugin can create it
+4. Run with `--debug`: `easyp generate --debug`
+5. For remote plugins, check network connectivity
+
+### Dependency version not found
+
+**Symptom:** `easyp mod download` fails with exit code 1
+
+**Causes:**
+- Tag doesn't exist — verify tag on the repository: `git ls-remote --tags <url>`
+- Commit hash is wrong or abbreviated — use full hash
+- Repository is private — ensure Git credentials are configured
+
+### Circular import detected
+
+**Symptom:** `PACKAGE_NO_IMPORT_CYCLE` violation
+
+**Debug with:**
+```bash
+easyp ls-files --format json
+```
+
+This shows the full import graph. Refactor packages to break the cycle:
+- Move shared types to a common package
+- Use message wrappers instead of direct cross-package imports
+
+## Debugging Techniques
+
+### Verbose output
+
+```bash
+easyp lint --debug
+easyp generate --debug
+```
+
+### JSON output for parsing
+
+```bash
+easyp lint --format json
+easyp breaking --format json
+easyp validate-config --format json
+easyp ls-files --format json
+```
+
+### List resolved files
+
+```bash
+easyp ls-files                    # With imports
+easyp ls-files --include-imports=false  # Without imports
+```
+
+### Validate config first
+
+Always validate before running other commands:
+```bash
+easyp validate-config
+```
+
+## Environment Variables
+
+| Variable | Overrides | Description |
+|----------|----------|-------------|
+| `EASYP_CFG` | `--cfg` | Path to config file |
+| `EASYP_DEBUG` | `--debug` | Enable debug logging |
+| `EASYP_FORMAT` | `--format` | Output format (text/json) |
+| `EASYP_INIT_DIR` | `init --dir` | Init directory |
+| `EASYP_ROOT_GENERATE_PATH` | `generate --path` | Generate path |
diff --git a/.agents/skills/protoc-gen-mcp-skill/SKILL.md b/.agents/skills/protoc-gen-mcp-skill/SKILL.md
new file mode 100644
index 00000000..23c9172b
--- /dev/null
+++ b/.agents/skills/protoc-gen-mcp-skill/SKILL.md
@@ -0,0 +1,370 @@
+---
+name: protoc-gen-mcp-skill
+description: "Build MCP servers from protobuf definitions using protoc-gen-mcp and easyp. Use when: creating an MCP server, generating MCP tools from proto files, building a proto-first MCP server in Go, configuring easyp for MCP generation, adding MCP tool annotations to protobuf services, implementing MCP tool handlers, setting up ProtoJSON-based MCP tools, or any task involving protobuf-to-MCP code generation. Also use when the user mentions protoc-gen-mcp, mcp proto, proto mcp server, easyp mcp, or wants type-safe MCP bindings from .proto files."
+---
+
+# protoc-gen-mcp — Proto-First MCP Server Generator
+
+Generate type-safe Go MCP tool bindings from annotated protobuf services.
+Protobuf is the source of truth: define your service once in `.proto`, generate
+both `*.pb.go` and `*.mcp.go`, implement the handler interface, and serve.
+
+## When to Use
+
+- Building a new MCP server and want type-safe, schema-validated tools
+- Already have protobuf services and want to expose them as MCP tools
+- Need JSON Schema validation on MCP tool inputs derived from proto definitions
+- Want ProtoJSON as the wire format for MCP tool requests and responses
+
+## Prerequisites
+
+Install [easyp](https://easyp.tech) — the recommended way to lint and generate:
+
+```bash
+brew install easyp-tech/tap/easyp
+```
+
+Or install from source:
+
+```bash
+go install github.com/easyp-tech/easyp/cmd/easyp@latest
+```
+
+See https://easyp.tech/docs for full documentation.
+
+## Step-by-Step Workflow
+
+### Step 1: Define Your Proto Service
+
+Create a `.proto` file with service, methods, and MCP annotations:
+
+```proto
+syntax = "proto3";
+
+package myapi.v1;
+
+option go_package = "github.com/you/myproject/myapi/v1;myapiv1";
+
+import "mcp/options/v1/options.proto";
+import "google/protobuf/empty.proto";
+
+service MyServiceAPI {
+  option (mcp.options.v1.service) = {
+    namespace: "myapi"
+    description: "My tools exposed as MCP tools."
+  };
+
+  // CreateItem creates a new item.
+  rpc CreateItem(CreateItemRequest) returns (CreateItemResponse) {
+    option (mcp.options.v1.method) = {
+      title: "Create item"
+      description: "Create a new item with validation."
+      annotations: { read_only_hint: false }
+    };
+  }
+
+  // Health returns server status.
+  rpc Health(google.protobuf.Empty) returns (HealthResponse) {
+    option (mcp.options.v1.method) = {
+      title: "Health check"
+      description: "Verify the server is alive."
+      annotations: { read_only_hint: true }
+    };
+  }
+}
+
+message CreateItemRequest {
+  // name is required (singular, non-optional in proto3).
+  string name = 1 [(mcp.options.v1.field) = {
+    description: "Item name."
+    examples: [{ string_value: "Widget" }]
+    min_length: 1
+    max_length: 200
+  }];
+
+  // count has a default and numeric bounds.
+  int32 count = 2 [(mcp.options.v1.field) = {
+    default_value: { number_value: 1 }
+    minimum: 1
+    maximum: 1000
+  }];
+
+  // tags is optional because it is repeated.
+  repeated string tags = 3 [(mcp.options.v1.field) = {
+    max_items: 20
+    unique_items: true
+  }];
+
+  // note is optional because of the `optional` keyword.
+  optional string note = 4;
+}
+
+message CreateItemResponse {
+  string id = 1;
+}
+
+message HealthResponse {
+  string status = 1;
+}
+```
+
+### Step 2: Configure easyp
+
+Create `easyp.yaml` and `protobuf.mod` in your project root. These drive both
+`protoc-gen-go` (standard Go protobuf) and `protoc-gen-mcp` (MCP bindings):
+
+```
+direct (
+	github.com/easyp-tech/protoc-gen-mcp@v0.3.1
+)
+```
+
+```yaml
+lint:
+  use:
+    - PACKAGE_DEFINED
+    - PACKAGE_VERSION_SUFFIX
+    - RPC_NO_CLIENT_STREAMING
+    - RPC_NO_SERVER_STREAMING
+
+generate:
+  inputs:
+    - directory:
+        path: proto          # directory containing your .proto files
+        root: "."
+  plugins:
+    - name: go
+      out: .
+      opts:
+        paths: source_relative
+    - command: ["go", "run", "github.com/easyp-tech/protoc-gen-mcp/cmd/protoc-gen-mcp@latest"]
+      out: .
+      opts:
+        paths: source_relative
+```
+
+For reproducible builds, pin a specific version tag instead of `@latest`:
+
+```yaml
+    - command: ["go", "run", "github.com/easyp-tech/protoc-gen-mcp/cmd/protoc-gen-mcp@v0.3.1"]
+```
+
+Why easyp over raw protoc:
+- Single `easyp.yaml` config manages all plugins, lint rules, and dependencies
+- Both `*.pb.go` and `*.mcp.go` are generated in one command
+- Built-in linting catches streaming RPCs and other unsupported patterns early
+- Git-native dependency management with lock files for reproducibility
+- No need to install `protoc` or manage plugin binaries manually
+
+### Step 3: Generate Code
+
+```bash
+# Validate config
+easyp validate-config
+
+# Download dependencies
+easyp mod download
+
+# Lint proto files
+easyp lint -p proto -r .
+
+# Generate *.pb.go and *.mcp.go
+easyp generate -p proto -r .
+```
+
+This produces two files next to your `.proto`:
+- `myapi.pb.go` — standard protobuf Go types
+- `myapi.mcp.go` — MCP tool handler interface + registration
+
+### Step 4: Implement the Handler
+
+The generated code exposes a `<Service>ToolHandler` interface. Implement it:
+
+```go
+package main
+
+import (
+    "context"
+    "log"
+
+    myapiv1 "github.com/you/myproject/myapi/v1"
+    "github.com/modelcontextprotocol/go-sdk/mcp"
+    emptypb "google.golang.org/protobuf/types/known/emptypb"
+)
+
+type handler struct{}
+
+func (handler) CreateItem(
+    _ context.Context,
+    req *myapiv1.CreateItemRequest,
+) (*myapiv1.CreateItemResponse, error) {
+    return &myapiv1.CreateItemResponse{Id: "item-1"}, nil
+}
+
+func (handler) Health(
+    _ context.Context,
+    _ *emptypb.Empty,
+) (*myapiv1.HealthResponse, error) {
+    return &myapiv1.HealthResponse{Status: "ok"}, nil
+}
+
+func main() {
+    server := mcp.NewServer(&mcp.Implementation{
+        Name:    "myapi-mcp",
+        Version: "v0.1.0",
+    }, nil)
+
+    if err := myapiv1.RegisterMyServiceAPITools(server, handler{}); err != nil {
+        log.Fatal(err)
+    }
+
+    if err := server.Run(context.Background(), &mcp.StdioTransport{}); err != nil {
+        log.Fatal(err)
+    }
+}
+```
+
+### Step 5: Run
+
+```bash
+go run ./cmd/myserver
+```
+
+The server communicates over stdio. Connect any MCP client to it. The generated
+tools are `myapi_CreateItem` and `myapi_Health`.
+
+## Key Concepts
+
+### Tool Naming
+
+Generated tool names follow the pattern `{namespace}_{MethodName}`. Dots in
+the namespace are normalized to underscores. Override the method segment with
+`mcp.options.v1.method.name`.
+
+### Requiredness Policy
+
+Requiredness in generated MCP JSON Schema is determined by proto3 syntax:
+
+| Proto Pattern | Required? |
+|---|---|
+| `string name = 1` (singular, no `optional`) | YES |
+| `optional string name = 1` | NO |
+| `repeated string names = 1` | NO |
+| `map<string, string> m = 1` | NO |
+| `oneof choice { ... }` | NO (unless `mcp.options.v1.oneof.required = true`) |
+
+Fields that are not required accept explicit JSON `null`.
+
+### ProtoJSON Contract
+
+MCP tool I/O uses ProtoJSON encoding. Key differences from plain JSON:
+
+- `int64`/`uint64` are JSON **strings**, not numbers
+- `float`/`double` accept `"NaN"`, `"Infinity"`, `"-Infinity"` as strings
+- `bytes` use base64 encoding
+- Enums use string names (e.g., `"FORECAST_MODE_DAILY"`)
+- `Timestamp` → RFC 3339 string, `Duration` → `"3.5s"`, `FieldMask` → `"field1,field2"`
+
+### Supported Protobuf Features
+
+- Scalars, enums, nested messages, repeated, maps, `oneof`, `optional`
+- Recursive messages via `$defs`/`$ref`
+- Well-known types: `Any`, `Empty`, `Timestamp`, `Duration`, `FieldMask`,
+  `Struct`, `Value`, `ListValue`, and all scalar wrapper types
+
+### Fail-Fast Rules
+
+The generator rejects at generation time (not runtime):
+- Proto2 syntax
+- Streaming RPCs (client, server, or bidirectional)
+- Unsupported `google.protobuf.*` types
+
+## Quick Proto Options Reference
+
+```proto
+import "mcp/options/v1/options.proto";
+
+// Service: namespace prefix, description, icons
+option (mcp.options.v1.service) = {
+  namespace: "myapi"
+  description: "My API tools."
+};
+
+// Method: tool name, title, description, visibility, agent hints
+option (mcp.options.v1.method) = {
+  name: "CustomName"
+  title: "Human Title"
+  description: "What this tool does."
+  hidden: true
+  annotations: {
+    read_only_hint: true
+    destructive_hint: false
+    idempotent_hint: true
+  }
+};
+
+// Field: description, examples, defaults, validation constraints
+[(mcp.options.v1.field) = {
+  description: "Field purpose."
+  examples: [{ string_value: "example" }]
+  default_value: { number_value: 42 }
+  pattern: "^[A-Z]"
+  min_length: 1
+  max_length: 255
+  minimum: 0
+  maximum: 100
+  min_items: 1
+  max_items: 50
+  unique_items: true
+}];
+
+// Oneof: make a oneof group required in the MCP schema
+option (mcp.options.v1.oneof) = { required: true };
+
+// Enum: title and description for the enum type
+option (mcp.options.v1.enum) = { title: "Status" };
+
+// Enum value: hide sentinel zero-value from the schema
+UNSPECIFIED = 0 [(mcp.options.v1.enum_value) = { hidden: true }];
+```
+
+For full options details, read `references/options-reference.md` in this skill.
+
+## Common Patterns
+
+### Hide Internal RPCs
+
+```proto
+rpc InternalDebug(DebugRequest) returns (DebugResponse) {
+  option (mcp.options.v1.method) = { hidden: true };
+};
+```
+
+### Read-Only vs Destructive Tools
+
+```proto
+// Read-only query
+option (mcp.options.v1.method) = {
+  annotations: { read_only_hint: true }
+};
+
+// Destructive mutation
+option (mcp.options.v1.method) = {
+  annotations: { destructive_hint: true }
+};
+```
+
+### Namespace Override at Registration
+
+```go
+myapiv1.RegisterMyServiceAPITools(server, handler{},
+    mcpruntime.WithNamespace("custom_prefix"),
+)
+```
+
+## Reference Files
+
+For detailed lookup tables, read these files from this skill directory:
+
+- `references/options-reference.md` — full MCP proto options with all fields and examples
+- `references/schema-mapping.md` — proto type → JSON Schema mapping, well-known types, nullability rules
diff --git a/.agents/skills/protoc-gen-mcp-skill/references/options-reference.md b/.agents/skills/protoc-gen-mcp-skill/references/options-reference.md
new file mode 100644
index 00000000..c05f0ac0
--- /dev/null
+++ b/.agents/skills/protoc-gen-mcp-skill/references/options-reference.md
@@ -0,0 +1,212 @@
+# MCP Proto Options Reference
+
+Complete reference for all `mcp.options.v1` protobuf extension options.
+
+Import in your `.proto` files:
+```proto
+import "mcp/options/v1/options.proto";
+```
+
+## ServiceOptions
+
+Applied via `option (mcp.options.v1.service) = { ... };` inside a `service` block.
+
+| Field | Type | Description |
+|---|---|---|
+| `namespace` | `string` | Prefix for all generated tool names (e.g., `weather` → `weather_GetForecast`) |
+| `description` | `string` | Overrides the service description inferred from proto comments |
+| `icons` | `repeated Icon` | Default icon metadata for all tools in this service |
+
+```proto
+service WeatherAPI {
+  option (mcp.options.v1.service) = {
+    namespace: "weather"
+    description: "Weather tools exposed as MCP tools."
+    icons: [{
+      src: "https://example.com/weather.png"
+      mime_type: "image/png"
+    }]
+  };
+}
+```
+
+## MethodOptions
+
+Applied via `option (mcp.options.v1.method) = { ... };` inside an `rpc` block.
+
+| Field | Type | Description |
+|---|---|---|
+| `name` | `string` | Override the RPC segment of the tool name |
+| `title` | `string` | Human-readable tool title |
+| `description` | `string` | Override description from proto comments |
+| `hidden` | `bool` | Suppress tool generation for this RPC entirely |
+| `annotations` | `ToolAnnotations` | Agent hints (see below) |
+| `icons` | `repeated Icon` | Per-tool icons, overrides service default |
+| `execution` | `ExecutionOptions` | Execution behavior (e.g., `task_support`) |
+
+```proto
+rpc Forecast(GetForecastRequest) returns (GetForecastResponse) {
+  option (mcp.options.v1.method) = {
+    name: "GetForecast"
+    title: "Get forecast"
+    description: "Fetch the forecast for a city."
+    annotations: {
+      read_only_hint: true
+      idempotent_hint: true
+    }
+  };
+}
+```
+
+### ToolAnnotations
+
+| Field | Type | Description |
+|---|---|---|
+| `read_only_hint` | `bool` | Tool only reads data, no side effects |
+| `destructive_hint` | `bool` | Tool may delete or irreversibly modify data |
+| `idempotent_hint` | `bool` | Repeated calls with same input produce same result |
+| `open_world_hint` | `bool` | Tool interacts with external systems |
+
+### Icon
+
+| Field | Type | Description |
+|---|---|---|
+| `src` | `string` | URI to the icon resource |
+| `mime_type` | `string` | MIME type (e.g., `image/png`, `image/svg+xml`) |
+
+### ExecutionOptions
+
+| Field | Type | Description |
+|---|---|---|
+| `task_support` | `TaskSupport` | `TASK_SUPPORT_UNSPECIFIED` or `TASK_SUPPORT_OPTIONAL` |
+
+## FieldOptions
+
+Applied via `[(mcp.options.v1.field) = { ... }]` on a message field.
+
+| Field | Type | Description |
+|---|---|---|
+| `description` | `string` | Override description from proto comments |
+| `examples` | `repeated ExampleValue` | Typed example values for the schema |
+| `default_value` | `ExampleValue` | Explicit default value |
+| `pattern` | `string` | Regex pattern for string fields |
+| `format` | `string` | JSON Schema format (e.g., `email`, `date-time`, `uri`) |
+| `min_length` | `uint32` | Minimum string length |
+| `max_length` | `uint32` | Maximum string length |
+| `minimum` | `float` | Minimum numeric value (inclusive) |
+| `maximum` | `float` | Maximum numeric value (inclusive) |
+| `exclusive_minimum` | `float` | Minimum numeric value (exclusive) |
+| `exclusive_maximum` | `float` | Maximum numeric value (exclusive) |
+| `multiple_of` | `float` | Number must be a multiple of this value |
+| `min_items` | `uint32` | Minimum array length |
+| `max_items` | `uint32` | Maximum array length |
+| `unique_items` | `bool` | Array items must be unique |
+| `read_only` | `bool` | Mark field as read-only |
+
+```proto
+string city = 1 [(mcp.options.v1.field) = {
+  description: "City name."
+  examples: [{ string_value: "Paris" }, { string_value: "London" }]
+  min_length: 1
+  max_length: 100
+  pattern: "^[A-Z]"
+}];
+
+int32 count = 2 [(mcp.options.v1.field) = {
+  default_value: { number_value: 10 }
+  minimum: 1
+  maximum: 1000
+}];
+
+repeated string labels = 5 [(mcp.options.v1.field) = {
+  min_items: 1
+  max_items: 50
+  unique_items: true
+}];
+```
+
+### ExampleValue
+
+Typed example values used in `examples` and `default_value`:
+
+| Oneof Field | Type | Usage |
+|---|---|---|
+| `string_value` | `string` | `{ string_value: "Paris" }` |
+| `number_value` | `double` | `{ number_value: 42.5 }` |
+| `integer_value` | `int64` | `{ integer_value: 10 }` |
+| `bool_value` | `bool` | `{ bool_value: true }` |
+| `array_value` | `ArrayValue` | `{ array_value: { items: [{ string_value: "a" }] } }` |
+| `object_value` | `ObjectValue` | `{ object_value: { fields: [{ key: "k" value: { string_value: "v" } }] } }` |
+| `null_value` | `NullValue` | `{ null_value: NULL_VALUE }` |
+
+## MessageOptions
+
+Applied via `option (mcp.options.v1.message) = { ... };` inside a `message` block.
+
+| Field | Type | Description |
+|---|---|---|
+| `title` | `string` | Human-readable message title |
+| `description` | `string` | Message description |
+| `examples` | `repeated ExampleValue` | Example message payloads |
+
+## OneofOptions
+
+Applied via `option (mcp.options.v1.oneof) = { ... };` inside a `oneof` block.
+
+| Field | Type | Description |
+|---|---|---|
+| `description` | `string` | Description of the oneof group |
+| `required` | `bool` | If true, exactly one variant must be set |
+
+```proto
+oneof selector {
+  option (mcp.options.v1.oneof) = {
+    description: "Select how to find the city."
+    required: true
+  };
+  string city_alias = 41;
+  int64 city_id = 42;
+}
+```
+
+## EnumOptions
+
+Applied via `option (mcp.options.v1.enum) = { ... };` inside an `enum` block.
+
+| Field | Type | Description |
+|---|---|---|
+| `title` | `string` | Human-readable enum title |
+| `description` | `string` | Enum description |
+
+## EnumValueOptions
+
+Applied via `[(mcp.options.v1.enum_value) = { ... }]` on an enum value.
+
+| Field | Type | Description |
+|---|---|---|
+| `description` | `string` | Description for this enum value |
+| `hidden` | `bool` | Hide this value from the schema (commonly used for sentinel zero-values) |
+
+```proto
+enum ForecastMode {
+  option (mcp.options.v1.enum) = {
+    title: "Forecast Mode"
+    description: "Scope of the forecast."
+  };
+
+  FORECAST_MODE_NONE = 0 [(mcp.options.v1.enum_value) = { hidden: true }];
+  FORECAST_MODE_DAILY = 1;
+  FORECAST_MODE_HOURLY = 2;
+}
+```
+
+## Comment-Based Metadata
+
+Proto comments also contribute to generated metadata:
+
+- Plain comment lines become descriptions
+- `Example: ...` adds a single schema example
+- `Examples: ... | ...` adds multiple schema examples (pipe-separated)
+
+Field options (`mcp.options.v1.field`) take precedence when both comments and
+options define the same metadata.
diff --git a/.agents/skills/protoc-gen-mcp-skill/references/schema-mapping.md b/.agents/skills/protoc-gen-mcp-skill/references/schema-mapping.md
new file mode 100644
index 00000000..60ae9bbe
--- /dev/null
+++ b/.agents/skills/protoc-gen-mcp-skill/references/schema-mapping.md
@@ -0,0 +1,91 @@
+# Proto Type → JSON Schema Mapping
+
+## Scalar Types
+
+| Proto Type | JSON Schema Type | Notes |
+|---|---|---|
+| `int32`, `sint32`, `sfixed32` | `integer` | — |
+| `uint32`, `fixed32` | `integer`, `minimum: 0` | — |
+| `int64`, `sint64`, `sfixed64` | `string` | ProtoJSON encodes as string |
+| `uint64`, `fixed64` | `string` | ProtoJSON encodes as string |
+| `float`, `double` | `number` | Also accepts `"NaN"`, `"Infinity"`, `"-Infinity"` strings |
+| `bool` | `boolean` | — |
+| `string` | `string` | — |
+| `bytes` | `string` | base64 encoding |
+| `enum` | `string` | ProtoJSON enum name strings; hidden zero-values excluded |
+
+## Compound Types
+
+| Proto Type | JSON Schema Type | Notes |
+|---|---|---|
+| `message` | `object` | Nested schema; recursive via `$defs`/`$ref` |
+| `repeated T` | `array` of T | — |
+| `map<K, V>` | `object` with `additionalProperties` | Key type determines `propertyNames.pattern` |
+| `oneof` | `oneOf` array | Discriminated union of variants |
+
+## Well-Known Types
+
+| Proto Type | JSON Schema | ProtoJSON Shape |
+|---|---|---|
+| `google.protobuf.Timestamp` | `string` (format: `date-time`) | `"2024-01-01T00:00:00Z"` |
+| `google.protobuf.Duration` | `string` | `"3.5s"` |
+| `google.protobuf.FieldMask` | `string` | `"field1,field2"` |
+| `google.protobuf.Struct` | `object` (free-form) | `{ "key": value }` |
+| `google.protobuf.Value` | any JSON value | `true`, `1.0`, `"str"`, `null`, `[]`, `{}` |
+| `google.protobuf.ListValue` | `array` | `[value, ...]` |
+| `google.protobuf.Any` | `object` with `@type` | `{"@type": "type.googleapis.com/...", ...}` |
+| `google.protobuf.Empty` | `object` (empty) | `{}` |
+| `google.protobuf.*Value` wrappers | unwrapped scalar type | `42`, `"str"`, `true` |
+
+Supported wrapper types: `BoolValue`, `StringValue`, `BytesValue`,
+`Int32Value`, `UInt32Value`, `Int64Value`, `UInt64Value`, `FloatValue`, `DoubleValue`.
+
+## Map Key Patterns
+
+| Key Type | `propertyNames.pattern` |
+|---|---|
+| `string` | (no constraint) |
+| `int32`, `sint32`, `sfixed32` | `^-?[0-9]+$` |
+| `uint32`, `fixed32`, `uint64`, `fixed64` | `^[0-9]+$` |
+| `int64`, `sint64`, `sfixed64` | `^-?[0-9]+$` |
+| `bool` | `^(true\|false)$` |
+
+## Requiredness Decision Tree
+
+```
+Is the field...
+├── proto3 `optional`?           → NOT required, nullable
+├── `repeated`?                  → NOT required, nullable
+├── `map`?                       → NOT required, nullable
+├── Inside a `oneof`?            → NOT required (unless oneof has required=true)
+├── Has FieldOptions.optional?   → NOT required, nullable
+└── Singular (none of above)?    → REQUIRED
+```
+
+## Nullability Rules
+
+For any field NOT in the `required` array:
+- Schema wraps type with null: `"type": ["string", "null"]`
+- Or uses `"oneOf": [<schema>, {"type": "null"}]` for complex types
+- Runtime accepts explicit JSON `null` → treated as unset in ProtoJSON
+
+This ensures MCP clients that validate cached `inputSchema` do not reject
+otherwise valid tool calls.
+
+## Recursive Messages
+
+- First occurrence generates full schema in `$defs`
+- Subsequent references use `$ref: "#/$defs/MessageName"`
+- Prevents infinite schema expansion
+
+## ProtoJSON Special Encodings
+
+| Type | Encoding | Example |
+|---|---|---|
+| `int64`/`uint64` | JSON string | `"123456789"` |
+| `float`/`double` special | Strings for non-finite | `"NaN"`, `"Infinity"`, `"-Infinity"` |
+| `bytes` | base64 string | `"SGVsbG8="` |
+| `enum` | string name | `"REPORT_STATUS_OK"` |
+| `Timestamp` | RFC 3339 | `"2024-01-01T00:00:00Z"` |
+| `Duration` | seconds with `s` | `"3.5s"` |
+| `FieldMask` | comma-separated | `"field1,field2"` |
diff --git a/.agents/skills/sdd/SKILL.md b/.agents/skills/sdd/SKILL.md
new file mode 100644
index 00000000..1f3ebe90
--- /dev/null
+++ b/.agents/skills/sdd/SKILL.md
@@ -0,0 +1,293 @@
+---
+name: sdd
+version: 1.5.0
+description: >
+  Spec-driven development pipeline with 6 phases: Explore, Requirements,
+  Design, Task Plan, Implementation, Review. Enforces human approval gates
+  between phases. Also provides a standalone documentation workflow for
+  generating or updating project docs without starting a feature pipeline.
+  Use when user wants structured feature development, spec-first approach,
+  or says "I want to add feature X", "new feature", "implement", "build",
+  "generate documentation", "update docs", "actualize the documentation".
+  Keywords: spec, requirements, design document, TDD plan, task plan,
+  implementation, code review, pipeline, approval gates, WHEN/SHALL,
+  generate docs, update docs, documentation queue.
+---
+
+# Spec-Driven Development
+
+You are operating in **spec-driven development mode**.
+This project uses a 6-phase pipeline with human approval gates between each phase.
+
+## Pipeline
+
+```
+Explore → [APPROVE] → Requirements → [APPROVE] → Design → [APPROVE] → Task Plan → [APPROVE] → Implementation → [APPROVE] → Review → [APPROVE] → Done
+```
+
+Each phase has a dedicated prompt template. Read the template for the **current** phase before generating any output.
+
+## Quick Reference
+
+### Core Commands
+
+| Action | Command |
+|--------|---------|
+| Check state | `sh ./scripts/pipeline.sh status` |
+| Start feature | `sh ./scripts/pipeline.sh init <name>` |
+| Register output | `sh ./scripts/pipeline.sh artifact [path]` |
+| Advance phase | `sh ./scripts/pipeline.sh approve` (only after user says "approve") |
+| Mark task done | `sh ./scripts/pipeline.sh task T-N` (implementation phase only) |
+| Multi-feature | Add `--feature <name>` before any command |
+
+### Decision Points
+
+At these moments, **ask the user** before running a command:
+
+#### Starting a feature (`init`)
+
+If config has `auto_branch: true` or `auto_worktree: true` → use the config default silently.
+Otherwise, ASK: *"Create a separate branch for this feature? (branch / worktree / no)"*
+
+| User answer | Command |
+|------------|--------|
+| "branch" | `pipeline.sh init --branch <name>` |
+| "worktree" | `pipeline.sh init --worktree <name>` |
+| "no" / "нет" | `pipeline.sh init <name>` |
+
+#### Finishing a feature (`finish`)
+
+After pipeline reaches `done` and docs maintenance is handled, ASK: *"What to do with the branch? (merge / PR / keep / discard)"*
+
+| User answer | Command |
+|------------|--------|
+| "merge" | `pipeline.sh finish merge` |
+| "PR" / "pull request" | `pipeline.sh finish pr` |
+| "keep" / "оставить" | `pipeline.sh finish keep` |
+| "discard" / "удалить" | `pipeline.sh finish discard --confirm` |
+| On default branch / no git | `pipeline.sh finish keep` (auto, no question) |
+
+#### Documentation updates
+
+When `docs-check` reports issues, ASK the user (already described in Pre-flight Checklist step 3).
+
+| User answer | Command |
+|------------|--------|
+| "generate docs" | `pipeline.sh docs-init --all` |
+| "update docs" | `pipeline.sh docs-init --update` |
+| "skip" / "пропустить" | (no command) |
+
+**Hard rules:** check status first · never skip phases · never auto-approve · save artifacts to `.spec/features/<feature>/` · max 3 revisions then ask user
+
+**Config:** `.spec/config.yaml` → `context`, `rules.<phase>`, `test_skill`, `test_reference`, `docs_dir`, `auto_branch`, `branch_prefix`, `auto_worktree`, `worktree_dir`
+
+**Phase flow:** read template → generate artifact → save → `artifact` → present → wait for "approve" → `approve`
+
+## Phases
+
+| # | Phase          | Template                        | Produces                        |
+|---|----------------|---------------------------------|---------------------------------|
+| 1 | Explore        | `./templates/explore.md`        | Exploration & research document |
+| 2 | Requirements   | `./templates/requirements.md`   | Formal requirements document    |
+| 3 | Design         | `./templates/design.md`         | Architecture & design document  |
+| 4 | Task Plan      | `./templates/task-plan.md`      | TDD implementation plan         |
+| 5 | Implementation | `./templates/implementation.md` | Implementation report           |
+| 6 | Review         | `./templates/review.md`         | Code review document            |
+
+## State Machine
+
+The pipeline state is managed via a shell script:
+
+```sh
+# Check current phase and progress
+sh ./scripts/pipeline.sh status
+
+# Start a new feature pipeline (see Decision Points for branching options)
+sh ./scripts/pipeline.sh init <feature-name>
+
+# Register the artifact you generated for the current phase
+sh ./scripts/pipeline.sh artifact [path]
+
+# Advance to the next phase (only after user says "approve")
+sh ./scripts/pipeline.sh approve
+
+# View revision history
+sh ./scripts/pipeline.sh revisions [phase]
+
+# View all features and their status
+sh ./scripts/pipeline.sh history
+
+# Mark an implementation task as completed (enables resume)
+sh ./scripts/pipeline.sh task <T-N>
+
+# Validate config file
+sh ./scripts/pipeline.sh config-check
+
+# Inject a pre-written artifact and skip to that phase
+sh ./scripts/pipeline.sh inject <phase> <path>
+
+# Abandon an active pipeline
+sh ./scripts/pipeline.sh abandon [feature]
+```
+
+For standalone documentation workflow commands (`docs-init`, `docs-next`, `docs-done`, `docs-status`, `docs-reset`), see `./templates/docs-maintenance.md`.
+
+For all available flags and options: `sh ./scripts/pipeline.sh help`
+
+### Parallel Pipelines
+
+When multiple features are active simultaneously, add `--feature <name>` before the command:
+
+```sh
+sh ./scripts/pipeline.sh --feature auth-flow status
+sh ./scripts/pipeline.sh --feature payment approve
+```
+
+Without the flag, the pipeline auto-detects the active feature. If more than one is active, it will error and prompt you to use `--feature`.
+
+## Project Configuration
+
+If the file `.spec/config.yaml` exists in the project root, read it before starting any phase. See `.spec/config.yaml.example` for a template with all supported keys.
+
+> **Format limitation:** the pipeline parser reads flat `key: value` pairs only. Nested YAML structures, multi-line values, and quoted strings are not supported.
+
+| Key | Type | Default | Description |
+|-----|------|---------|-------------|
+| `context` | string | — | Project-wide background for ALL phases |
+| `rules.<phase>` | string | — | Phase-specific rules (supplement template) |
+| `rules.docs` | string | — | Rules for documentation generation |
+| `test_skill` | string | — | Skill name for delegated test generation |
+| `test_reference` | string | — | Glob/paths to representative test files |
+| `docs_dir` | string | `.spec` | Directory for project documentation |
+| `doc_freshness_days` | integer | `30` | Days before a generated doc is stale |
+| `auto_branch` | boolean | `false` | Auto-create git branch on `init` |
+| `branch_prefix` | string | `feature/` | Prefix for auto-created branches |
+| `auto_worktree` | boolean | `false` | Auto-create git worktree on `init` (mutually exclusive with `auto_branch`) |
+| `worktree_dir` | string | `.worktrees` | Directory for worktrees (add to `.gitignore`) |
+
+Phase-specific rule keys: `rules.explore`, `rules.requirements`, `rules.design`, `rules.task-plan`, `rules.implementation`, `rules.review`, `rules.docs`.
+
+Injection order: **context → phase rules → template instructions.**
+
+If the file does not exist, skip this step.
+
+## Standalone Documentation Workflow
+
+If the user requests documentation generation or update **without referring to a feature** (e.g. *"generate docs"*, *"update documentation"*, *"actualize the docs"*, *"refresh AUTH.md"*) — **do NOT run `pipeline.sh init`**. This is a standalone workflow with its own state machine.
+
+1. Read `./templates/docs-maintenance.md` § Standalone Documentation Workflow.
+2. Run `pipeline.sh docs-init [--all|--update|<template>...]` based on user intent.
+3. Choose execution strategy (subagent recommended when available, sequential as fallback).
+4. Drive the queue: `docs-next` → generate → `docs-done` (sequential), or dispatch up to 3 subagents in parallel (subagent mode).
+
+The standalone workflow is independent from feature pipelines — it does not create `.spec/features/<feature>/`, does not require approvals, and runs purely from `.spec/.docs-queue.kv` state.
+
+## Pre-flight Checklist
+
+Before starting any pipeline work, follow these steps in order:
+
+1. **Check pipeline state**: run `pipeline.sh status`.
+   - If exactly one active pipeline exists → resume from the current phase. Do NOT run `init` again.
+   - If no active pipeline → proceed to step 2.
+   - If multiple active pipelines → ask the user which feature to work on, then use `--feature <name>` with all subsequent commands.
+2. **Read project config**: check if `.spec/config.yaml` exists.
+   - If yes → read it, apply `context` to all phases, note `rules.*` for each phase.
+   - If no → proceed without config (defaults apply).
+3. **Check documentation** (MUST — do not skip this step): run `pipeline.sh docs-check`.
+   - **Docs directory missing** → suggest: *"Project documentation (<docs_dir>/) not found. I can generate it to better understand your codebase. Say 'generate docs' or 'skip'."* **Wait for the user's response** before proceeding. This is a soft gate — the pipeline works without documentation, but the user must explicitly acknowledge (say 'generate docs' or 'skip').
+   - **Docs exist, stale files found** → suggest: *"Some docs are outdated (<file>: <N> days old). Regenerate before starting? Say 'update docs' or 'skip'."* **Wait for the user's response.** If user agrees, read `./templates/docs-maintenance.md` for the Stale doc regeneration workflow.
+   - **Docs exist, all fresh** → use as supplementary context for ALL phases. Read `<docs_dir>/README.md` for the documentation map.
+   - If user says **"generate docs"** or **"update docs"**: read `./templates/docs-maintenance.md`, follow the workflow. Generated documentation files go to `<docs_dir>/` (default: `.spec/`), **NOT** to `.spec/features/<feature>/`.
+   - **Do NOT proceed to step 4 until the user responds** to the documentation suggestion.
+4. **Start pipeline**: run `pipeline.sh init <feature-name>`.
+
+For documentation generation, staleness checks, and regeneration workflows, read `./templates/docs-maintenance.md`.
+
+## When to Use This Pipeline
+
+**Use the pipeline for:**
+- New features ("add user authentication", "implement search")
+- Significant changes to existing features (new behavior, API changes, schema migrations)
+- Bug fixes that require investigation and design (root cause unknown, multiple components affected)
+
+**Do NOT use the pipeline for:**
+- Trivial changes: typo fixes, config tweaks, single-field additions, comment updates
+- Dependency updates with no code changes
+- Pure refactors with no behavioral change (unless they are large and risky)
+
+For trivial changes, just make the change directly — no pipeline needed. The skill is designed for work that **benefits from structured thinking before coding**.
+
+### Fast-track mode
+
+For **bug fixes with a known reproduction** or other small, well-understood changes:
+
+- All 6 phases still apply — do not skip phases.
+- Each phase produces a **minimal artifact**: 1-paragraph exploration, 1–2 requirements, focused design (CPs only for the bug scenario), 4–5 tasks (RED→GREEN→CODE→VERIFY→GATE), brief implementation report, short review.
+- Each template contains a "Fast-track mode" section with phase-specific minimums. Follow those rules when fast-track applies.
+
+**When to activate:** The agent activates fast-track when the user describes a bug with a known reproduction step, or a small, scoped change where investigation is unnecessary. At the start, announce: *"Using fast-track mode — all 6 phases, minimal artifacts."* If the user says "full pipeline", switch to the standard (non-abbreviated) flow.
+
+**Scope:** This pipeline is designed for a **single project or monorepo**. It is not intended for features that span multiple independent repositories. Within a monorepo, use one `.spec/` directory at the repository root.
+
+## Rules
+
+1. **MUST check status first.** Run `pipeline.sh status` before doing anything. Never generate phase output without checking status. If multiple active pipelines exist, use `--feature <name>` with all commands.
+2. **Never skip phases.** Follow the order: explore → requirements → design → task-plan → implementation → review.
+3. **Never auto-approve.** Wait for the user to explicitly say "approve" or equivalent.
+4. **Read the template.** Before generating output for a phase, read the corresponding template file.
+5. **Save artifacts.** Save phase artifacts (explore, requirements, design, task-plan, implementation, review) to `.spec/features/<feature>/` and register them with `pipeline.sh artifact`. **Project documentation** (README.md, ARCHITECTURE.md, DOMAIN.md, etc.) goes to `<docs_dir>/` (default: `.spec/`), NOT to `.spec/features/<feature>/` — these are separate directories with separate purposes.
+6. **Each phase produces one artifact** that becomes input for the next phase.
+7. **Artifacts are cumulative.** Each phase reads all prior artifacts.
+8. **Revision limit.** If the user rejects the same artifact 3 times in a row, stop generating and ask: "We've gone through 3 revisions — could you clarify what's missing or what direction you'd prefer?" Do not continue revising without explicit guidance.
+9. **Surface uncertainty.** If you are unsure about intent, scope, or technical approach — say so explicitly. State the assumption you would make and ask the user to confirm or correct it. Never silently assume.
+10. **Write in the user's language.** Detect the user's language from their first message and use it for ALL pipeline artifacts and conversational replies. What stays in English:
+    - Formal grammar keywords: `WHEN`, `SHALL`, `the system`
+    - Requirement IDs: `REQ-X.Y`
+    - Task IDs: `T-N`
+    - Instruction keywords: `CRITICAL`, `IMPORTANT`, `NOTE`, `DO NOT`, `GOAL`
+    - Correctness Property format: `Property N`, `Category`, `For all`, `Validates`
+    - Code identifiers, file paths, shell commands, Mermaid node labels
+    - Documentation in `<docs_dir>/` (`.spec/`) — always English (see `templates/docs/README.md`)
+
+    Everything else — prose, section headers, descriptions, interview questions, explanations — is written in the user's language.
+
+## Error Recovery
+
+- **Revising an artifact:** Overwrite the file, re-register with `pipeline.sh artifact`, and present the updated version to the user. The previous version is automatically saved as a revision in the feature’s `revisions/` directory. Use `pipeline.sh revisions` to view past revisions.
+
+
+## Documentation Maintenance
+
+After the pipeline reaches `phase=done`, read `./templates/docs-maintenance.md` § Documentation Maintenance to check if project documentation needs updating.
+
+## Branch Finishing
+
+After documentation maintenance is complete (or skipped), follow the **Finishing a feature** Decision Point in Quick Reference above.
+
+If on the default branch (main/master) or git is unavailable, run `pipeline.sh finish keep` automatically — no question needed.
+
+This is a soft suggestion, not a blocker. If the user ignores it, the pipeline is still complete.
+
+## Quick Start (for the agent)
+
+When the user says something like "I want to add feature X":
+
+1. Follow the **Pre-flight Checklist** (status → config → docs-check → init)
+2. Read `./templates/explore.md` — investigate the problem space (use `.spec/` docs as context if available)
+3. Generate the exploration document → save to `.spec/features/<feature>/explore.md`
+4. Run `pipeline.sh artifact`
+5. Present to user → wait for "approve"
+6. Run `pipeline.sh approve` → phase advances to requirements
+7. Read `./templates/requirements.md` → follow its interview process
+8. Generate the requirements document → save, register artifact, present, wait for approve
+9. Repeat for design phase
+10. Read `./templates/task-plan.md` → generate TDD implementation plan (no code yet)
+11. Save, register artifact, present, wait for approve
+12. Read `./templates/implementation.md` → execute the task plan (write tests, write code, mark tasks done)
+13. Save implementation report, register artifact, present, wait for approve
+14. Read `./templates/review.md` → review the written code against all prior artifacts
+15. Present review document with findings and verdict → wait for user instructions
+16. If user asks to fix findings → fix → generate new review → present again → wait for approve
+17. After review is approved → `pipeline.sh approve` → pipeline complete
+18. Check if documentation needs updating (see Documentation Maintenance)
+19. Check if the feature branch needs finalizing (see Branch Finishing) → present options → `pipeline.sh finish`
diff --git a/.agents/skills/sdd/scripts/pipeline.sh b/.agents/skills/sdd/scripts/pipeline.sh
new file mode 100755
index 00000000..3cecf09a
--- /dev/null
+++ b/.agents/skills/sdd/scripts/pipeline.sh
@@ -0,0 +1,1723 @@
+#!/usr/bin/env sh
+# Spec-Driven Dev Pipeline — state machine (POSIX sh, zero dependencies)
+# Usage: sh pipeline.sh [--feature <name>] <command> [args]
+#
+# Shell compatibility: requires sh with `local` support (bash, dash, ash, zsh).
+#
+# Global flags:
+#   --feature <name>      Specify which feature to operate on (required when
+#                         multiple pipelines are active simultaneously)
+#
+# Commands:
+#   init [--branch|--no-branch] <feature-name>
+#                         Start a new pipeline for a feature
+#                         --branch: create git branch <prefix><name> (prefix from config, default: feature/)
+#                         --no-branch: skip branch creation even if auto_branch is set in config
+#   status                Show current phase, feature, and artifacts
+#   approve               Advance to next phase (requires artifact)
+#   artifact [path]       Register artifact for current phase
+#   history               Show all features and their status
+#   revisions [phase]     Show revision history for current or specified phase
+#   docs-check            Check project documentation status
+#   task <T-N>            Mark implementation task as completed (resume tracking)
+#   version               Show version
+#   help                  Show this help message
+
+set -e
+
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+SKILL_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+FEATURES_DIR="$PROJECT_ROOT/.spec/features"
+CONFIG_FILE="$PROJECT_ROOT/.spec/config.yaml"
+
+# --- helpers ---
+
+VERSION="1.5.0"
+EXPLICIT_FEATURE=""
+
+die() { echo "ERROR: $*" >&2; exit 1; }
+info() { echo "→ $*"; }
+warn() { echo "⚠ $*" >&2; }
+
+iso_now() {
+  date -u +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date +"%Y-%m-%dT%H:%M:%SZ"
+}
+
+iso_now_compact() {
+  date -u +"%Y-%m-%dT%H-%M-%SZ" 2>/dev/null || date +"%Y-%m-%dT%H-%M-%SZ"
+}
+
+# Escape a string for safe embedding in JSON values (RFC 8259)
+json_escape() {
+  printf '%s' "$1" | awk '
+    BEGIN { ORS="" }
+    {
+      gsub(/\\/, "\\\\")
+      gsub(/"/, "\\\"")
+      gsub(/\t/, "\\t")
+      gsub(/\r/, "\\r")
+      if (NR > 1) printf "\\n"
+      printf "%s", $0
+    }'
+}
+
+# Read a value from .spec/config.yaml (simple grep-based, no YAML parser)
+# Usage: read_config <key> [default]
+# Returns the value or default (empty string if no default)
+read_config() {
+  local key="$1" default="${2:-}"
+  if [ -f "$CONFIG_FILE" ]; then
+    local val
+    val="$(grep "^${key}:" "$CONFIG_FILE" 2>/dev/null | head -1 | sed "s/^${key}:[[:space:]]*//" | sed 's/[[:space:]]*$//')"
+    if [ -n "$val" ]; then
+      printf '%s' "$val"
+      return
+    fi
+  fi
+  printf '%s' "$default"
+}
+
+# --- per-feature state ---
+
+# Current feature paths (set by set_feature_context / resolve_feature)
+FEATURE_DIR=""
+STATE_FILE=""
+KV_FILE=""
+REVISIONS_DIR=""
+APPROVED_DIR=""
+
+set_feature_context() {
+  # set_feature_context <feature-name> — sets global paths for the feature
+  FEATURE_DIR="$FEATURES_DIR/$1"
+  KV_FILE="$FEATURE_DIR/pipeline.kv"
+  STATE_FILE="$FEATURE_DIR/pipeline.json"
+  REVISIONS_DIR="$FEATURE_DIR/revisions"
+  APPROVED_DIR="$FEATURE_DIR/approved"
+}
+
+ensure_feature_dir() {
+  # ensure_feature_dir <feature-name> — creates feature directory structure
+  local fdir="$FEATURES_DIR/$1"
+  mkdir -p "$fdir" "$fdir/revisions" "$fdir/approved"
+}
+
+read_field() {
+  [ -f "$KV_FILE" ] || return 1
+  local _line
+  _line="$(grep "^$1=" "$KV_FILE" 2>/dev/null | head -1)" || return 1
+  [ -n "$_line" ] || return 1
+  printf '%s' "$_line" | cut -d'=' -f2-
+}
+
+validate_kv() {
+  # Verify required fields exist in KV store; die with diagnostic on failure
+  [ -f "$KV_FILE" ] || die "Pipeline state file missing: $KV_FILE"
+  local missing=""
+  for field in feature phase created_at; do
+    grep -q "^${field}=" "$KV_FILE" 2>/dev/null || missing="$missing $field"
+  done
+  if [ -n "$missing" ]; then
+    die "Corrupted pipeline state ($KV_FILE): missing fields:$missing. Fix the file manually or remove and re-init."
+  fi
+  # Verify every line matches key=value format (key: lowercase + digits + underscore)
+  local line_num=0
+  while IFS= read -r line || [ -n "$line" ]; do
+    line_num=$((line_num + 1))
+    case "$line" in
+      "") continue ;;  # skip blank lines
+      [a-z_]*=*) ;;    # valid key=value
+      *) die "Corrupted pipeline state ($KV_FILE): invalid line $line_num: $line" ;;
+    esac
+  done < "$KV_FILE"
+}
+
+# Escape a value for safe use in sed replacement string
+kv_escape_sed() {
+  printf '%s' "$1" | sed -e 's/[&\\/|]/\\&/g'
+}
+
+# Validate that a value is safe for the KV store (no =, |, or newlines)
+kv_validate_value() {
+  case "$1" in
+    *'='*) die "KV value must not contain '=': $1" ;;
+    *'|'*) die "KV value must not contain '|': $1" ;;
+  esac
+  # Check for newlines by comparing line count (portable across POSIX shells)
+  local line_count
+  line_count="$(printf '%s' "$1" | wc -l)"
+  if [ "$line_count" -ne 0 ]; then
+    die "KV value must not contain newlines: $1"
+  fi
+}
+
+# Validate artifact path: reject directory traversal and control characters
+validate_artifact_path() {
+  case "$1" in
+    */../*|*/..) die "Artifact path must not contain '..' traversal" ;;
+    ../*|..)     die "Artifact path must not contain '..' traversal" ;;
+  esac
+  if printf '%s' "$1" | grep -q '[[:cntrl:]]' 2>/dev/null; then
+    die "Artifact path must not contain control characters"
+  fi
+}
+
+write_field() {
+  kv_validate_value "$2"
+  if [ -f "$KV_FILE" ] && grep -q "^$1=" "$KV_FILE" 2>/dev/null; then
+    local tmp="$KV_FILE.tmp"
+    local escaped
+    escaped="$(kv_escape_sed "$2")"
+    sed "s|^$1=.*|$1=$escaped|" "$KV_FILE" > "$tmp" && mv "$tmp" "$KV_FILE"
+  else
+    echo "$1=$2" >> "$KV_FILE"
+  fi
+}
+
+detect_active_feature() {
+  # Scan all features, return the one with phase != done
+  [ -d "$FEATURES_DIR" ] || return 0
+  local active=""
+  local count=0
+  for kv in "$FEATURES_DIR"/*/pipeline.kv; do
+    [ -f "$kv" ] || continue
+    local phase
+    phase="$(grep "^phase=" "$kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+    if [ -n "$phase" ] && [ "$phase" != "done" ]; then
+      local fname
+      fname="$(grep "^feature=" "$kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+      active="$fname"
+      count=$((count + 1))
+    fi
+  done
+  if [ "$count" -gt 1 ]; then
+    warn "Multiple active pipelines found:"
+    for kv in "$FEATURES_DIR"/*/pipeline.kv; do
+      [ -f "$kv" ] || continue
+      local phase fname
+      phase="$(grep "^phase=" "$kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+      fname="$(grep "^feature=" "$kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+      if [ -n "$phase" ] && [ "$phase" != "done" ]; then
+        echo "  - $fname (phase: $phase)" >&2
+      fi
+    done
+    return 1
+  fi
+  [ -n "$active" ] && echo "$active"
+}
+
+resolve_feature() {
+  if [ -n "$EXPLICIT_FEATURE" ]; then
+    # Validate that the explicitly specified feature exists
+    if [ ! -f "$FEATURES_DIR/$EXPLICIT_FEATURE/pipeline.kv" ]; then
+      die "Feature '$EXPLICIT_FEATURE' not found. Run 'pipeline.sh history' to list features."
+    fi
+    set_feature_context "$EXPLICIT_FEATURE"
+    validate_kv
+    return 0
+  fi
+  local feat
+  feat="$(detect_active_feature)" || { warn "Hint: use --feature <name> to select one."; return 1; }
+  if [ -z "$feat" ]; then
+    return 1
+  fi
+  set_feature_context "$feat"
+  validate_kv
+  return 0
+}
+
+next_phase() {
+  case "$1" in
+    explore)        echo "requirements" ;;
+    requirements)   echo "design" ;;
+    design)         echo "task-plan" ;;
+    task-plan)      echo "implementation" ;;
+    implementation) echo "review" ;;
+    review)         echo "done" ;;
+    done)           echo "" ;;
+    *)              echo "" ;;
+  esac
+}
+
+phase_number() {
+  case "$1" in
+    explore)        echo "1" ;;
+    requirements)   echo "2" ;;
+    design)         echo "3" ;;
+    task-plan)      echo "4" ;;
+    implementation) echo "5" ;;
+    review)         echo "6" ;;
+    done)           echo "✓" ;;
+    *)              echo "?" ;;
+  esac
+}
+
+# Numeric ordering for comparisons (phase_number is for display)
+phase_order() {
+  case "$1" in
+    explore)        echo 1 ;;
+    requirements)   echo 2 ;;
+    design)         echo 3 ;;
+    task-plan)      echo 4 ;;
+    implementation) echo 5 ;;
+    review)         echo 6 ;;
+    done)           echo 7 ;;
+    *)              echo 0 ;;
+  esac
+}
+
+# Rebuild the JSON file from KV store (for agents to read)
+# Uses atomic write (tmp + mv) to prevent corruption on interruption
+rebuild_json() {
+  validate_kv
+  local feature phase created artifact
+  feature="$(json_escape "$(read_field feature)")"
+  phase="$(read_field phase)"
+  created="$(read_field created_at)"
+  artifact="$(read_field current_artifact)"
+  local history_count
+  history_count="$(read_field history_count)"
+  [ -z "$history_count" ] && history_count=0
+
+  local tmp_file="$STATE_FILE.tmp"
+  {
+    printf '{\n'
+    printf '  "feature": "%s",\n' "$feature"
+    printf '  "phase": "%s",\n' "$phase"
+    printf '  "created_at": "%s",\n' "$created"
+    if [ -n "$artifact" ]; then
+      printf '  "current_artifact": "%s",\n' "$(json_escape "$artifact")"
+    else
+      printf '  "current_artifact": null,\n'
+    fi
+    printf '  "history": [\n'
+
+    local i=0
+    while [ "$i" -lt "$history_count" ]; do
+      local h_phase h_artifact h_approved
+      h_phase="$(read_field "history_${i}_phase")"
+      h_artifact="$(json_escape "$(read_field "history_${i}_artifact")")"
+      h_approved="$(read_field "history_${i}_approved_at")"
+      [ "$i" -gt 0 ] && printf ',\n'
+      printf '    {"phase": "%s", "artifact": "%s", "approved_at": "%s"}' \
+        "$h_phase" "$h_artifact" "$h_approved"
+      i=$((i + 1))
+    done
+
+    printf '\n  ],\n'
+
+    # Include review_base_commit if set
+    local rbc
+    rbc="$(read_field review_base_commit 2>/dev/null || echo "")"
+    if [ -n "$rbc" ]; then
+      printf '  "review_base_commit": "%s",\n' "$(json_escape "$rbc")"
+    else
+      printf '  "review_base_commit": null,\n'
+    fi
+
+    # Include branch if set
+    local br
+    br="$(read_field branch 2>/dev/null || echo "")"
+    if [ -n "$br" ]; then
+      printf '  "branch": "%s",\n' "$(json_escape "$br")"
+    else
+      printf '  "branch": null,\n'
+    fi
+
+    # Include worktree if set
+    local wt
+    wt="$(read_field worktree 2>/dev/null || echo "")"
+    if [ -n "$wt" ]; then
+      printf '  "worktree": "%s",\n' "$(json_escape "$wt")"
+    else
+      printf '  "worktree": null,\n'
+    fi
+
+    # Include last_completed_task if set
+    local lct
+    lct="$(read_field last_completed_task 2>/dev/null || echo "")"
+    if [ -n "$lct" ]; then
+      printf '  "last_completed_task": "%s",\n' "$(json_escape "$lct")"
+    else
+      printf '  "last_completed_task": null,\n'
+    fi
+
+    # Include finish fields if set
+    local fa ft fb
+    fa="$(read_field finish_action 2>/dev/null || echo "")"
+    ft="$(read_field finished_at 2>/dev/null || echo "")"
+    fb="$(read_field finish_base 2>/dev/null || echo "")"
+    if [ -n "$fa" ]; then
+      printf '  "finish_action": "%s",\n' "$(json_escape "$fa")"
+      printf '  "finished_at": "%s",\n' "$(json_escape "$ft")"
+      if [ -n "$fb" ]; then
+        printf '  "finish_base": "%s"\n' "$(json_escape "$fb")"
+      else
+        printf '  "finish_base": null\n'
+      fi
+    else
+      printf '  "finish_action": null,\n'
+      printf '  "finished_at": null,\n'
+      printf '  "finish_base": null\n'
+    fi
+
+    printf '}\n'
+  } > "$tmp_file"
+  mv -f "$tmp_file" "$STATE_FILE"
+}
+
+# --- commands ---
+
+cmd_init() {
+  # Parse init-specific flags
+  local do_branch=""
+  local do_worktree=""
+  local feature=""
+  while [ $# -gt 0 ]; do
+    case "$1" in
+      --branch)      do_branch="yes"; shift ;;
+      --worktree)    do_worktree="yes"; shift ;;
+      --no-branch)   do_branch="no"; do_worktree="no"; shift ;;
+      -*)            die "Unknown flag for init: $1" ;;
+      *)
+        [ -n "$feature" ] && die "Unexpected argument: $1"
+        feature="$1"; shift
+        ;;
+    esac
+  done
+
+  [ -z "$feature" ] && die "Usage: pipeline.sh init [--branch|--worktree|--no-branch] <feature-name>"
+
+  # Mutual exclusion
+  if [ "$do_branch" = "yes" ] && [ "$do_worktree" = "yes" ]; then
+    die "--branch and --worktree are mutually exclusive."
+  fi
+
+  # Validate feature name (kebab-case)
+  case "$feature" in
+    *[!a-z0-9-]*) die "Feature name must be kebab-case (e.g. grpc-streaming-support)" ;;
+    -*|*-)        die "Feature name must be kebab-case (e.g. grpc-streaming-support)" ;;
+    *--*)         die "Feature name must be kebab-case (e.g. grpc-streaming-support)" ;;
+    [!a-z]*)      die "Feature name must be kebab-case (e.g. grpc-streaming-support)" ;;
+  esac
+
+  if [ ${#feature} -gt 64 ]; then
+    die "Feature name too long (max 64 chars): $feature"
+  fi
+
+  # Resolve branch/worktree creation: flag > config > default (neither)
+  if [ -z "$do_branch" ] && [ -z "$do_worktree" ]; then
+    local auto_branch auto_worktree
+    auto_worktree="$(read_config auto_worktree "false")"
+    case "$auto_worktree" in
+      true|yes|1) do_worktree="yes" ;;
+    esac
+    if [ "$do_worktree" != "yes" ]; then
+      auto_branch="$(read_config auto_branch "false")"
+      case "$auto_branch" in
+        true|yes|1) do_branch="yes" ;;
+        *)          do_branch="no" ;;
+      esac
+    fi
+  fi
+
+  local branch_name=""
+  local worktree_path=""
+
+  if [ "$do_worktree" = "yes" ]; then
+    # --- Worktree mode ---
+    if ! command -v git >/dev/null 2>&1; then
+      die "Git not found. Cannot create worktree."
+    fi
+    if ! git rev-parse --git-dir >/dev/null 2>&1; then
+      die "Not a git repository. Cannot create worktree."
+    fi
+
+    local prefix wt_dir
+    prefix="$(read_config branch_prefix "feature/")"
+    wt_dir="$(read_config worktree_dir ".worktrees")"
+    branch_name="${prefix}${feature}"
+    worktree_path="${wt_dir}/${feature}"
+
+    # Check if branch already exists
+    if git rev-parse --verify "$branch_name" >/dev/null 2>&1; then
+      die "Branch '$branch_name' already exists."
+    fi
+
+    # Warn if worktree_dir is not in .gitignore
+    if [ -f ".gitignore" ]; then
+      if ! grep -qx "$wt_dir" .gitignore 2>/dev/null && ! grep -qx "$wt_dir/" .gitignore 2>/dev/null; then
+        warn "Worktree directory '$wt_dir' is not in .gitignore. Consider adding it."
+      fi
+    else
+      warn "No .gitignore found. Consider adding '$wt_dir' to .gitignore."
+    fi
+
+    git worktree add "$worktree_path" -b "$branch_name" || die "Failed to create worktree at '$worktree_path'."
+    info "Created worktree: $worktree_path (branch: $branch_name)"
+
+  elif [ "$do_branch" = "yes" ]; then
+    # Verify git is available
+    if ! command -v git >/dev/null 2>&1; then
+      die "Git not found. Cannot create branch."
+    fi
+    if ! git rev-parse --git-dir >/dev/null 2>&1; then
+      die "Not a git repository. Cannot create branch."
+    fi
+
+    local prefix
+    prefix="$(read_config branch_prefix "feature/")"
+    branch_name="${prefix}${feature}"
+
+    # Check if branch already exists
+    if git rev-parse --verify "$branch_name" >/dev/null 2>&1; then
+      die "Branch '$branch_name' already exists."
+    fi
+
+    # Warn about dirty working tree
+    if ! git diff --quiet 2>/dev/null || ! git diff --cached --quiet 2>/dev/null; then
+      warn "Working tree has uncommitted changes."
+    fi
+
+    git checkout -b "$branch_name" || die "Failed to create branch '$branch_name'."
+    info "Created branch: $branch_name"
+  fi
+
+  local fdir="$FEATURES_DIR/$feature"
+
+  # Check if feature already exists
+  if [ -f "$fdir/pipeline.kv" ]; then
+    local existing_phase
+    existing_phase="$(grep "^phase=" "$fdir/pipeline.kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+    if [ "$existing_phase" = "done" ]; then
+      die "Feature '$feature' already completed. Choose a different name."
+    else
+      warn "Active pipeline for '$feature' exists (phase: $existing_phase)"
+      die "Complete or choose a different feature name."
+    fi
+  fi
+
+  ensure_feature_dir "$feature"
+  set_feature_context "$feature"
+
+  # Initialize KV store
+  {
+    echo "feature=$feature"
+    echo "phase=explore"
+    echo "created_at=$(iso_now)"
+    echo "current_artifact="
+    echo "history_count=0"
+    if [ -n "$branch_name" ]; then
+      echo "branch=$branch_name"
+    fi
+    if [ -n "$worktree_path" ]; then
+      echo "worktree=$worktree_path"
+    fi
+  } > "$KV_FILE"
+
+  rebuild_json
+  info "Pipeline initialized for '$feature'"
+  if [ -n "$worktree_path" ]; then
+    info "Worktree: $worktree_path (branch: $branch_name)"
+  elif [ -n "$branch_name" ]; then
+    info "Branch: $branch_name"
+  fi
+  info "Phase: [1/6] explore"
+  info "Artifacts: .spec/features/$feature/"
+  info "Read template: ./templates/explore.md"
+}
+
+cmd_status() {
+  if ! resolve_feature; then
+    info "No active pipeline."
+    # Show completed features if any
+    if [ -d "$FEATURES_DIR" ]; then
+      local has_completed=0
+      for kv in "$FEATURES_DIR"/*/pipeline.kv; do
+        [ -f "$kv" ] || continue
+        local phase
+        phase="$(grep "^phase=" "$kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+        if [ "$phase" = "done" ]; then
+          if [ "$has_completed" -eq 0 ]; then
+            echo ""
+            echo "Completed features:"
+            has_completed=1
+          fi
+          local fname
+          fname="$(grep "^feature=" "$kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+          printf "  ✓ %s\n" "$fname"
+        fi
+      done
+    fi
+    echo ""
+    info "Run: pipeline.sh init <feature-name>"
+    return 0
+  fi
+
+  local feature phase artifact history_count
+  feature="$(read_field feature)"
+  phase="$(read_field phase)"
+  artifact="$(read_field current_artifact)"
+  history_count="$(read_field history_count)"
+  [ -z "$history_count" ] && history_count=0
+
+  echo ""
+  echo "┌─────────────────────────────────────────────┐"
+  printf "│ Feature: %-35s│\n" "$feature"
+  printf "│ Phase:   [%s/6] %-30s│\n" "$(phase_number "$phase")" "$phase"
+  # Show branch/worktree info
+  local br_info wt_info
+  br_info="$(read_field branch 2>/dev/null || echo "")"
+  wt_info="$(read_field worktree 2>/dev/null || echo "")"
+  if [ -n "$wt_info" ]; then
+    printf "│ Worktree: %-34s│\n" "$wt_info"
+  elif [ -n "$br_info" ]; then
+    printf "│ Branch:  %-35s│\n" "$br_info"
+  fi
+  if [ -n "$artifact" ]; then
+    printf "│ Artifact: %-34s│\n" "$artifact"
+  else
+    printf "│ Artifact: %-34s│\n" "(none — register before approve)"
+  fi
+  # Show last completed task during implementation phase
+  if [ "$phase" = "implementation" ]; then
+    local lct
+    lct="$(read_field last_completed_task 2>/dev/null || echo "")"
+    if [ -n "$lct" ]; then
+      printf "│ Last task: %-33s│\n" "$lct"
+    fi
+  fi
+  echo "├─────────────────────────────────────────────┤"
+
+  # Show pipeline progress
+  local e_mark="○" r_mark="○" d_mark="○" t_mark="○" i_mark="○" rev_mark="○"
+  case "$phase" in
+    explore)        e_mark="●" ;;
+    requirements)   e_mark="✓"; r_mark="●" ;;
+    design)         e_mark="✓"; r_mark="✓"; d_mark="●" ;;
+    task-plan)      e_mark="✓"; r_mark="✓"; d_mark="✓"; t_mark="●" ;;
+    implementation) e_mark="✓"; r_mark="✓"; d_mark="✓"; t_mark="✓"; i_mark="●" ;;
+    review)         e_mark="✓"; r_mark="✓"; d_mark="✓"; t_mark="✓"; i_mark="✓"; rev_mark="●" ;;
+    done)           e_mark="✓"; r_mark="✓"; d_mark="✓"; t_mark="✓"; i_mark="✓"; rev_mark="✓" ;;
+  esac
+  printf "│ %s Ex → %s Rq → %s Ds → %s Tp → %s Im → %s Rv │\n" "$e_mark" "$r_mark" "$d_mark" "$t_mark" "$i_mark" "$rev_mark"
+  echo "└─────────────────────────────────────────────┘"
+
+  # Show history
+  if [ "$history_count" -gt 0 ]; then
+    echo ""
+    echo "Completed phases:"
+    local i=0
+    while [ "$i" -lt "$history_count" ]; do
+      local h_phase h_artifact h_approved
+      h_phase="$(read_field "history_${i}_phase")"
+      h_artifact="$(read_field "history_${i}_artifact")"
+      h_approved="$(read_field "history_${i}_approved_at")"
+      printf "  [%s] %-15s → %s (approved: %s)\n" "$((i+1))" "$h_phase" "$h_artifact" "$h_approved"
+      i=$((i + 1))
+    done
+  fi
+
+  # Hint for next action
+  echo ""
+  if [ "$phase" = "done" ]; then
+    info "Pipeline complete."
+  elif [ -z "$artifact" ]; then
+    info "Next: register artifact with 'pipeline.sh artifact <path>'"
+    info "Then: 'pipeline.sh approve' after user approval"
+  else
+    info "Artifact registered. Ask user to approve, then run 'pipeline.sh approve'"
+  fi
+  echo ""
+}
+
+cmd_artifact() {
+  resolve_feature || die "No active pipeline. Run 'pipeline.sh init <feature>' first."
+
+  local phase
+  phase="$(read_field phase)"
+  [ "$phase" = "done" ] && die "Pipeline is complete. Nothing to register."
+
+  local path="$1"
+
+  # If no path given, use the default: .spec/features/<feature>/<phase>.md
+  if [ -z "$path" ]; then
+    path="$FEATURE_DIR/${phase}.md"
+  fi
+
+  validate_artifact_path "$path"
+  [ -f "$path" ] || die "Artifact file does not exist: $path"
+
+  # Save a snapshot of the artifact being registered (revision tracking)
+  local rev_count
+  rev_count="$(read_field "revision_count_${phase}")"
+  [ -z "$rev_count" ] && rev_count=0
+  rev_count=$((rev_count + 1))
+  local rev_name
+  rev_name="${phase}-rev-${rev_count}-$(iso_now_compact).md"
+  cp "$path" "$REVISIONS_DIR/$rev_name"
+  write_field "revision_count_${phase}" "$rev_count"
+  if [ "$rev_count" -gt 1 ]; then
+    info "Revision $rev_count saved: $rev_name"
+  fi
+
+  write_field current_artifact "$path"
+  rebuild_json
+  info "Artifact registered for phase '$phase': $path"
+}
+
+cmd_approve() {
+  resolve_feature || die "No active pipeline."
+
+  local phase artifact history_count
+  phase="$(read_field phase)"
+  artifact="$(read_field current_artifact)"
+  history_count="$(read_field history_count)"
+  [ -z "$history_count" ] && history_count=0
+
+  [ "$phase" = "done" ] && die "Pipeline already complete."
+  [ -z "$artifact" ] && die "No artifact registered for phase '$phase'. Run 'pipeline.sh artifact <path>' first."
+  [ -f "$artifact" ] || die "Artifact file no longer exists: $artifact. Re-register with 'pipeline.sh artifact <path>'."
+
+  # Snapshot artifact contents
+  cp "$artifact" "$APPROVED_DIR/${phase}.md"
+
+  # Record base commit for review phase (git diff source)
+  if [ "$phase" = "task-plan" ]; then
+    local base_commit
+    base_commit="$(git rev-parse HEAD 2>/dev/null || echo "")"
+    write_field review_base_commit "$base_commit"
+  fi
+
+  # Record in history
+  write_field "history_${history_count}_phase" "$phase"
+  write_field "history_${history_count}_artifact" "$artifact"
+  write_field "history_${history_count}_approved_at" "$(iso_now)"
+  history_count=$((history_count + 1))
+  write_field history_count "$history_count"
+
+  # Advance phase
+  local next
+  next="$(next_phase "$phase")"
+  write_field phase "$next"
+  write_field current_artifact ""
+
+  # Clear task tracking when leaving implementation
+  if [ "$phase" = "implementation" ]; then
+    write_field last_completed_task ""
+  fi
+
+  rebuild_json
+
+  if [ "$next" = "done" ]; then
+    echo ""
+    echo "✅ Pipeline complete!"
+    echo ""
+    echo "All artifacts:"
+    local i=0
+    while [ "$i" -lt "$history_count" ]; do
+      printf "  [%s] %s → %s\n" "$((i+1))" \
+        "$(read_field "history_${i}_phase")" \
+        "$(read_field "history_${i}_artifact")"
+      i=$((i + 1))
+    done
+    echo ""
+    local feat
+    feat="$(read_field feature)"
+    info "Artifacts saved in: .spec/features/$feat/"
+    info "Next: check documentation (docs-check), then finish branch (pipeline.sh finish)"
+  else
+    info "Phase '$phase' approved."
+    info "Advanced to: [$(phase_number "$next")/6] $next"
+    info "Read template: ./templates/${next}.md"
+  fi
+}
+
+cmd_task() {
+  local task_id="$1"
+  [ -z "$task_id" ] && die "Usage: pipeline.sh task <T-N>"
+
+  resolve_feature || die "No active pipeline."
+
+  local phase
+  phase="$(read_field phase)"
+  [ "$phase" = "implementation" ] || die "Task tracking is only available during implementation phase (current: $phase)."
+
+  write_field last_completed_task "$task_id"
+  rebuild_json
+  info "Task $task_id marked complete"
+}
+
+cmd_history() {
+  if [ ! -d "$FEATURES_DIR" ]; then
+    info "No features found."
+    return 0
+  fi
+
+  local found=0
+  for kv in "$FEATURES_DIR"/*/pipeline.kv; do
+    [ -f "$kv" ] || continue
+    found=1
+    local fname phase created
+    fname="$(grep "^feature=" "$kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+    phase="$(grep "^phase=" "$kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+    created="$(grep "^created_at=" "$kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+
+    local status_icon
+    if [ "$phase" = "done" ]; then
+      status_icon="✓"
+    else
+      status_icon="●"
+    fi
+
+    printf "  %s %-25s [%s/6] %-15s (created: %s)\n" \
+      "$status_icon" "$fname" "$(phase_number "$phase")" "$phase" "$created"
+  done
+
+  if [ "$found" -eq 0 ]; then
+    info "No features found."
+  fi
+}
+
+cmd_revisions() {
+  resolve_feature || die "No active pipeline."
+
+  local phase
+  phase="$(read_field phase)"
+
+  local target_phase="${1:-$phase}"
+  # Validate target phase
+  case "$target_phase" in
+    explore|requirements|design|task-plan|implementation|review|all) ;;
+    *) die "Unknown phase: $target_phase. Use: explore, requirements, design, task-plan, implementation, review, or all." ;;
+  esac
+
+  local found=0
+  local tmp
+  tmp="$(mktemp)"
+  if [ "$target_phase" = "all" ]; then
+    echo "All revisions:"
+    for p in explore requirements design task-plan implementation review; do
+      find "$REVISIONS_DIR" -name "${p}-rev-*" 2>/dev/null | sort > "$tmp"
+      while IFS= read -r f; do
+        printf "  [%s] %s\n" "$p" "$(basename "$f")"
+        found=1
+      done < "$tmp"
+    done
+  else
+    echo "Revisions for phase '$target_phase':"
+    find "$REVISIONS_DIR" -name "${target_phase}-rev-*" 2>/dev/null | sort > "$tmp"
+    while IFS= read -r f; do
+      printf "  %s\n" "$(basename "$f")"
+      found=1
+    done < "$tmp"
+  fi
+  rm -f "$tmp"
+
+  if [ "$found" -eq 0 ]; then
+    info "No revisions recorded yet."
+  fi
+}
+
+cmd_version() {
+  echo "Spec-Driven Dev Pipeline v${VERSION}"
+}
+
+# check_file_staleness <file> <templates_dir> <freshness_days> <now_epoch>
+# Outputs tab-separated: generated template age_days stale scope_changed
+check_file_staleness() {
+  local f="$1" templates_dir="$2" freshness_days="$3" now_epoch="$4"
+  local generated="null" template="null" age_days="null" stale="false" scope_changed="null"
+
+  local first_line
+  first_line="$(head -1 "$f" 2>/dev/null)"
+  case "$first_line" in
+    *"<!-- generated:"*"template:"*"-->"*)
+      local gen_date gen_tmpl
+      gen_date="$(echo "$first_line" | sed 's/.*<!-- generated: \([0-9-]*\),.*/\1/')"
+      gen_tmpl="$(echo "$first_line" | sed 's/.*template: \([^ ]*\) -->.*/\1/')"
+      if [ -n "$gen_date" ]; then
+        generated="\"$gen_date\""
+        template="\"$gen_tmpl\""
+        local gen_epoch
+        gen_epoch="$(date -j -f '%Y-%m-%d' "$gen_date" '+%s' 2>/dev/null || date -d "$gen_date" '+%s' 2>/dev/null || echo 0)"
+        if [ "$gen_epoch" -gt 0 ] && [ "$now_epoch" -gt 0 ]; then
+          age_days=$(( (now_epoch - gen_epoch) / 86400 ))
+
+          local tmpl_file="$templates_dir/$gen_tmpl"
+          if [ -f "$tmpl_file" ]; then
+            local scope_line
+            scope_line="$(head -1 "$tmpl_file" 2>/dev/null)"
+            case "$scope_line" in
+              "<!-- scope:"*"-->")
+                local patterns
+                patterns="$(echo "$scope_line" | sed 's/<!-- scope: //' | sed 's/ -->//' | sed 's/,[[:space:]]*/\n/g' | tr '\n' ' ' | sed 's/[[:space:]]*$//')"
+                if [ -n "$patterns" ]; then
+                  local git_hits
+                  # shellcheck disable=SC2086
+                  git_hits="$(cd "$PROJECT_ROOT" && set -f && git log --oneline --since="$gen_date" -- $patterns 2>/dev/null | head -1)"
+                  if [ -n "$git_hits" ]; then
+                    scope_changed="true"
+                    if [ "$age_days" -gt "$freshness_days" ]; then
+                      stale="true"
+                    fi
+                  else
+                    scope_changed="false"
+                  fi
+                fi
+                ;;
+              *)
+                if [ "$age_days" -gt "$freshness_days" ]; then
+                  stale="true"
+                fi
+                ;;
+            esac
+          else
+            if [ "$age_days" -gt "$freshness_days" ]; then
+              stale="true"
+            fi
+          fi
+        fi
+      fi
+      ;;
+  esac
+  printf '%s\t%s\t%s\t%s\t%s' "$generated" "$template" "$age_days" "$stale" "$scope_changed"
+}
+
+cmd_docs_check() {
+  local config_file="$CONFIG_FILE"
+  local docs_dir=".spec"
+  local freshness_days=30
+
+  # Read docs_dir and doc_freshness_days from config.yaml if it exists
+  if [ -f "$config_file" ]; then
+    local configured_dir
+    configured_dir="$(grep '^docs_dir:' "$config_file" 2>/dev/null | head -1 | sed 's/^docs_dir:[[:space:]]*//' | sed 's/[[:space:]]*$//')"
+    if [ -n "$configured_dir" ]; then
+      docs_dir="$configured_dir"
+    fi
+    local configured_days
+    configured_days="$(grep '^doc_freshness_days:' "$config_file" 2>/dev/null | head -1 | sed 's/^doc_freshness_days:[[:space:]]*//' | sed 's/[[:space:]]*$//')"
+    if [ -n "$configured_days" ]; then
+      freshness_days="$configured_days"
+    fi
+  fi
+
+  local full_path="$PROJECT_ROOT/$docs_dir"
+  local templates_dir="$SKILL_DIR/templates/docs"
+  local now_epoch
+  now_epoch="$(date +%s 2>/dev/null || echo 0)"
+
+  if [ -d "$full_path" ]; then
+    printf '{"exists": true, "dir": "%s", "freshness_days": %d, "files": [' "$(json_escape "$docs_dir")" "$freshness_days"
+
+    # Single scan: find files into tmpfile, iterate once, capture stale names
+    local tmp_files tmp_stale
+    tmp_files="$(mktemp)"
+    tmp_stale="$(mktemp)"
+    find "$full_path" -maxdepth 1 -type f -name '*.md' 2>/dev/null | sort > "$tmp_files"
+
+    local first=1
+    while IFS= read -r f; do
+      local fname result generated template age_days stale scope_changed
+      fname="$(basename "$f")"
+      result="$(check_file_staleness "$f" "$templates_dir" "$freshness_days" "$now_epoch")"
+
+      generated="$(printf '%s' "$result" | cut -f1)"
+      template="$(printf '%s' "$result" | cut -f2)"
+      age_days="$(printf '%s' "$result" | cut -f3)"
+      stale="$(printf '%s' "$result" | cut -f4)"
+      scope_changed="$(printf '%s' "$result" | cut -f5)"
+
+      if [ "$first" -eq 1 ]; then
+        first=0
+      else
+        printf ', '
+      fi
+      printf '{"name": "%s", "generated": %s, "template": %s, "age_days": %s, "stale": %s, "scope_changed": %s}' \
+        "$(json_escape "$fname")" "$generated" "$template" "$age_days" "$stale" "$scope_changed"
+
+      if [ "$stale" = "true" ]; then
+        echo "$fname" >> "$tmp_stale"
+      fi
+    done < "$tmp_files"
+
+    printf '], "stale": ['
+    # Read stale names from tmpfile (no re-scan needed)
+    local sfirst=1
+    if [ -s "$tmp_stale" ]; then
+      while IFS= read -r sname; do
+        if [ "$sfirst" -eq 1 ]; then
+          sfirst=0
+        else
+          printf ', '
+        fi
+        printf '"%s"' "$(json_escape "$sname")"
+      done < "$tmp_stale"
+    fi
+    printf ']}\n'
+
+    rm -f "$tmp_files" "$tmp_stale"
+  else
+    printf '{"exists": false, "dir": "%s", "freshness_days": %d, "files": [], "stale": []}\n' "$(json_escape "$docs_dir")" "$freshness_days"
+  fi
+}
+
+# --- standalone docs queue ---
+
+DOCS_QUEUE_FILE="$PROJECT_ROOT/.spec/.docs-queue.kv"
+
+docs_queue_read() {
+  # docs_queue_read <key> — read value from queue file
+  [ -f "$DOCS_QUEUE_FILE" ] || return 1
+  local _line
+  _line="$(grep "^$1=" "$DOCS_QUEUE_FILE" 2>/dev/null | head -1)" || return 1
+  [ -n "$_line" ] || return 1
+  printf '%s' "$_line" | sed "s/^$1=//"
+}
+
+docs_queue_write_status() {
+  # docs_queue_write_status <index> <status>
+  local idx="$1" status="$2"
+  local tmp="$DOCS_QUEUE_FILE.tmp"
+  grep -v "^template_${idx}_status=" "$DOCS_QUEUE_FILE" > "$tmp" 2>/dev/null || true
+  echo "template_${idx}_status=$status" >> "$tmp"
+  mv -f "$tmp" "$DOCS_QUEUE_FILE"
+}
+
+docs_template_name() {
+  # Extract template name from generated file metadata (line 1)
+  local f="$1"
+  local first_line
+  first_line="$(head -1 "$f" 2>/dev/null)"
+  case "$first_line" in
+    "<!-- generated:"*"-->")
+      printf '%s' "$first_line" | sed -n 's/.*template:[[:space:]]*\([^[:space:]]*\)\.md[[:space:]]*-->/\1/p'
+      ;;
+  esac
+}
+
+cmd_docs_init() {
+  local mode="all"
+  local explicit_templates=""
+  while [ $# -gt 0 ]; do
+    case "$1" in
+      --all)    mode="all"; shift ;;
+      --update) mode="update"; shift ;;
+      -*)       die "Unknown flag for docs-init: $1" ;;
+      *)
+        explicit_templates="$explicit_templates $1"
+        mode="explicit"
+        shift
+        ;;
+    esac
+  done
+
+  [ -f "$DOCS_QUEUE_FILE" ] && die "Docs queue already exists at $DOCS_QUEUE_FILE. Run 'pipeline.sh docs-reset' first."
+
+  local templates_dir="$SKILL_DIR/templates/docs"
+  local docs_dir
+  docs_dir="$(read_config docs_dir ".spec")"
+  local full_path="$PROJECT_ROOT/$docs_dir"
+
+  local templates=""
+  case "$mode" in
+    all)
+      for f in "$templates_dir"/*.md; do
+        local name
+        name="$(basename "$f" .md)"
+        [ "$name" = "README" ] && continue
+        templates="$templates $name"
+      done
+      ;;
+    update)
+      [ -d "$full_path" ] || die "Docs directory '$docs_dir' does not exist. Use --all to bootstrap."
+      local freshness_days
+      freshness_days="$(read_config doc_freshness_days "30")"
+      local now_epoch
+      now_epoch="$(date +%s 2>/dev/null || echo 0)"
+      # Iterate stale files, extract template names
+      local tmp_list
+      tmp_list="$(mktemp)"
+      find "$full_path" -maxdepth 1 -type f -name '*.md' 2>/dev/null | sort > "$tmp_list"
+      while IFS= read -r f; do
+        local result stale tmpl
+        result="$(check_file_staleness "$f" "$templates_dir" "$freshness_days" "$now_epoch")"
+        stale="$(printf '%s' "$result" | cut -f4)"
+        if [ "$stale" = "true" ]; then
+          tmpl="$(docs_template_name "$f")"
+          if [ -n "$tmpl" ]; then
+            case " $templates " in
+              *" $tmpl "*) ;;
+              *) templates="$templates $tmpl" ;;
+            esac
+          fi
+        fi
+      done < "$tmp_list"
+      rm -f "$tmp_list"
+      ;;
+    explicit)
+      templates="$explicit_templates"
+      ;;
+  esac
+
+  mkdir -p "$(dirname "$DOCS_QUEUE_FILE")"
+
+  # Build queue file
+  local count=0
+  local tmp_queue="$DOCS_QUEUE_FILE.tmp"
+  {
+    echo "created_at=$(iso_now)"
+    echo "docs_dir=$docs_dir"
+    echo "mode=$mode"
+  } > "$tmp_queue"
+
+  for t in $templates; do
+    if [ ! -f "$templates_dir/$t.md" ]; then
+      warn "Template not found, skipping: $t"
+      continue
+    fi
+    echo "template_${count}=$t" >> "$tmp_queue"
+    echo "template_${count}_status=pending" >> "$tmp_queue"
+    count=$((count + 1))
+  done
+  echo "total=$count" >> "$tmp_queue"
+
+  if [ "$count" -eq 0 ]; then
+    rm -f "$tmp_queue"
+    info "No templates to queue (nothing stale or none selected)."
+    return 0
+  fi
+
+  mv -f "$tmp_queue" "$DOCS_QUEUE_FILE"
+
+  info "Docs queue created: $count template(s), mode=$mode."
+  info "Next: pipeline.sh docs-next"
+  info ""
+  info "Execution strategy:"
+  info "  - If your toolset supports subagent dispatch (Task/Composer/etc):"
+  info "    use SUBAGENT mode — dispatch up to 3 templates in parallel."
+  info "  - Otherwise: SEQUENTIAL mode — one template per iteration."
+  info "  See ./templates/docs-maintenance.md § Standalone Documentation Workflow."
+}
+
+cmd_docs_next() {
+  [ -f "$DOCS_QUEUE_FILE" ] || die "No docs queue. Run 'pipeline.sh docs-init' first."
+
+  local total
+  total="$(docs_queue_read total)"
+  [ -z "$total" ] && total=0
+
+  local i=0
+  local templates_dir="$SKILL_DIR/templates/docs"
+  local docs_dir
+  docs_dir="$(docs_queue_read docs_dir)"
+
+  while [ "$i" -lt "$total" ]; do
+    local status
+    status="$(docs_queue_read "template_${i}_status")"
+    if [ "$status" = "pending" ]; then
+      local name
+      name="$(docs_queue_read "template_${i}")"
+      printf '%s\t%s\n' "$name" "$templates_dir/$name.md"
+      # Sequential mode hint after position 3
+      if [ "$i" -ge 3 ]; then
+        info "" >&2
+        info "Tip: if context feels heavy, start a fresh chat and resume" >&2
+        info "     with 'pipeline.sh docs-status' (sequential mode)." >&2
+      fi
+      return 0
+    fi
+    i=$((i + 1))
+  done
+
+  info "Docs queue complete: all $total template(s) processed."
+  info "Run 'pipeline.sh docs-reset' to clear the queue."
+  return 0
+}
+
+cmd_docs_done() {
+  local name="${1:-}"
+  [ -z "$name" ] && die "Usage: pipeline.sh docs-done <template>"
+  [ -f "$DOCS_QUEUE_FILE" ] || die "No docs queue. Run 'pipeline.sh docs-init' first."
+
+  local total
+  total="$(docs_queue_read total)"
+  [ -z "$total" ] && total=0
+
+  local i=0
+  while [ "$i" -lt "$total" ]; do
+    local entry
+    entry="$(docs_queue_read "template_${i}")"
+    if [ "$entry" = "$name" ]; then
+      local status
+      status="$(docs_queue_read "template_${i}_status")"
+      if [ "$status" = "done" ]; then
+        warn "Template '$name' already marked done."
+        return 0
+      fi
+      docs_queue_write_status "$i" "done"
+      info "Marked done: $name ($((i + 1))/$total)"
+      # Check if queue is now complete
+      local remaining=0
+      local j=0
+      while [ "$j" -lt "$total" ]; do
+        local s
+        s="$(docs_queue_read "template_${j}_status")"
+        [ "$s" = "pending" ] && remaining=$((remaining + 1))
+        j=$((j + 1))
+      done
+      if [ "$remaining" -eq 0 ]; then
+        info "Docs queue complete. Run 'pipeline.sh docs-reset' to clear it."
+      fi
+      return 0
+    fi
+    i=$((i + 1))
+  done
+
+  die "Template '$name' not found in queue."
+}
+
+cmd_docs_status() {
+  if [ ! -f "$DOCS_QUEUE_FILE" ]; then
+    printf '{"exists": false}\n'
+    return 0
+  fi
+
+  local total docs_dir mode created_at
+  total="$(docs_queue_read total)"
+  docs_dir="$(docs_queue_read docs_dir)"
+  mode="$(docs_queue_read mode)"
+  created_at="$(docs_queue_read created_at)"
+  [ -z "$total" ] && total=0
+
+  local completed=0
+  local pending_list=""
+  local current=""
+  local first_pending_set=0
+  local i=0
+  while [ "$i" -lt "$total" ]; do
+    local name status
+    name="$(docs_queue_read "template_${i}")"
+    status="$(docs_queue_read "template_${i}_status")"
+    if [ "$status" = "done" ]; then
+      completed=$((completed + 1))
+    else
+      if [ "$first_pending_set" -eq 0 ]; then
+        current="$name"
+        first_pending_set=1
+      fi
+      if [ -z "$pending_list" ]; then
+        pending_list="\"$(json_escape "$name")\""
+      else
+        pending_list="$pending_list, \"$(json_escape "$name")\""
+      fi
+    fi
+    i=$((i + 1))
+  done
+
+  printf '{"exists": true, "total": %d, "completed": %d, "current": %s, "pending": [%s], "mode": "%s", "docs_dir": "%s", "created_at": "%s"}\n' \
+    "$total" \
+    "$completed" \
+    "$([ -n "$current" ] && printf '"%s"' "$(json_escape "$current")" || printf 'null')" \
+    "$pending_list" \
+    "$(json_escape "$mode")" \
+    "$(json_escape "$docs_dir")" \
+    "$(json_escape "$created_at")"
+}
+
+cmd_docs_reset() {
+  if [ ! -f "$DOCS_QUEUE_FILE" ]; then
+    info "No docs queue to reset."
+    return 0
+  fi
+
+  local total completed=0
+  total="$(docs_queue_read total)"
+  [ -z "$total" ] && total=0
+  local i=0
+  while [ "$i" -lt "$total" ]; do
+    local s
+    s="$(docs_queue_read "template_${i}_status")"
+    [ "$s" = "done" ] && completed=$((completed + 1))
+    i=$((i + 1))
+  done
+
+  rm -f "$DOCS_QUEUE_FILE"
+  info "Docs queue reset (was: $completed/$total completed)."
+}
+
+cmd_config_check() {
+  [ -f "$CONFIG_FILE" ] || { info "No config file found: $CONFIG_FILE"; return 0; }
+
+  local valid_keys=" context rules.explore rules.requirements rules.design rules.task-plan rules.implementation rules.review rules.docs test_skill test_reference docs_dir doc_freshness_days auto_branch branch_prefix auto_worktree worktree_dir "
+  local errors=0
+
+  info "Checking $CONFIG_FILE ..."
+
+  # Extract keys and validate against whitelist
+  local tmp
+  tmp="$(mktemp)"
+  grep '^[a-z]' "$CONFIG_FILE" 2>/dev/null > "$tmp" || true
+  while IFS= read -r line; do
+    local key
+    key="$(printf '%s' "$line" | sed 's/:.*//')"
+    case "$valid_keys" in
+      *" $key "*) ;;
+      *) warn "Unknown key: '$key'"; errors=$((errors + 1)) ;;
+    esac
+  done < "$tmp"
+  rm -f "$tmp"
+
+  # Type checks
+  local val
+  val="$(read_config doc_freshness_days "")"
+  if [ -n "$val" ]; then
+    case "$val" in
+      *[!0-9]*) warn "doc_freshness_days must be numeric, got: '$val'"; errors=$((errors + 1)) ;;
+    esac
+  fi
+
+  val="$(read_config auto_branch "")"
+  if [ -n "$val" ]; then
+    case "$val" in
+      true|false|yes|no|1|0) ;;
+      *) warn "auto_branch must be boolean (true/false/yes/no/1/0), got: '$val'"; errors=$((errors + 1)) ;;
+    esac
+  fi
+
+  val="$(read_config auto_worktree "")"
+  if [ -n "$val" ]; then
+    case "$val" in
+      true|false|yes|no|1|0) ;;
+      *) warn "auto_worktree must be boolean (true/false/yes/no/1/0), got: '$val'"; errors=$((errors + 1)) ;;
+    esac
+  fi
+
+  if [ "$errors" -eq 0 ]; then
+    info "Config OK — all keys valid."
+  else
+    warn "$errors problem(s) found."
+    return 1
+  fi
+}
+
+cmd_inject() {
+  local target_phase="${1:-}"
+  local artifact_path="${2:-}"
+
+  if [ -z "$target_phase" ] || [ -z "$artifact_path" ]; then
+    die "Usage: pipeline.sh inject <phase> <path>"
+  fi
+
+  # Validate target phase
+  case "$target_phase" in
+    explore|requirements|design|task-plan|implementation|review) ;;
+    *) die "Unknown phase: $target_phase. Use: explore, requirements, design, task-plan, implementation, review." ;;
+  esac
+
+  resolve_feature || die "No active pipeline. Run 'pipeline.sh init <feature>' first."
+
+  local current_phase
+  current_phase="$(read_field phase)"
+  [ "$current_phase" = "done" ] && die "Pipeline already complete."
+
+  # Validate current phase <= target phase
+  local current_num target_num
+  current_num="$(phase_order "$current_phase")"
+  target_num="$(phase_order "$target_phase")"
+  if [ "$current_num" -gt "$target_num" ]; then
+    die "Cannot inject backward: current phase is '$current_phase' ($current_num), target is '$target_phase' ($target_num)."
+  fi
+
+  validate_artifact_path "$artifact_path"
+  [ -f "$artifact_path" ] || die "Artifact file does not exist: $artifact_path"
+
+  # Lightweight content validation
+  case "$target_phase" in
+    requirements)
+      if ! grep -q 'WHEN\|SHALL' "$artifact_path" 2>/dev/null; then
+        warn "Requirements artifact should contain WHEN/SHALL keywords."
+      fi
+      ;;
+    design)
+      if ! grep -q 'Correctness\|Property' "$artifact_path" 2>/dev/null; then
+        warn "Design artifact should contain Correctness Properties."
+      fi
+      ;;
+  esac
+
+  # Skip intermediate phases (record as injected in history)
+  local p="$current_phase"
+  local history_count
+  history_count="$(read_field history_count)"
+  [ -z "$history_count" ] && history_count=0
+
+  while [ "$p" != "$target_phase" ]; do
+    write_field "history_${history_count}_phase" "$p"
+    write_field "history_${history_count}_artifact" "(injected)"
+    write_field "history_${history_count}_approved_at" "$(iso_now)"
+    history_count=$((history_count + 1))
+    p="$(next_phase "$p")"
+  done
+
+  # Set to target phase and register artifact
+  write_field phase "$target_phase"
+  write_field current_artifact "$artifact_path"
+  write_field history_count "$history_count"
+
+  # Save revision snapshot
+  local rev_count
+  rev_count="$(read_field "revision_count_${target_phase}")"
+  [ -z "$rev_count" ] && rev_count=0
+  rev_count=$((rev_count + 1))
+  local rev_name
+  rev_name="${target_phase}-rev-${rev_count}-$(iso_now_compact).md"
+  cp "$artifact_path" "$REVISIONS_DIR/$rev_name"
+  write_field "revision_count_${target_phase}" "$rev_count"
+
+  # Capture review_base_commit if injecting into implementation/review and not already set
+  case "$target_phase" in
+    implementation|review)
+      local rbc
+      rbc="$(read_field review_base_commit 2>/dev/null || echo "")"
+      if [ -z "$rbc" ]; then
+        local head_commit
+        head_commit="$(git rev-parse HEAD 2>/dev/null || echo "")"
+        if [ -n "$head_commit" ]; then
+          write_field review_base_commit "$head_commit"
+          info "Captured review_base_commit: $(printf '%.8s' "$head_commit")"
+        fi
+      fi
+      ;;
+  esac
+
+  rebuild_json
+
+  local skipped=$((target_num - current_num))
+  if [ "$skipped" -gt 0 ]; then
+    info "$skipped phase(s) skipped to reach '$target_phase'."
+  fi
+  info "Artifact injected for phase '$target_phase': $artifact_path"
+  info "Ask user to approve, then run 'pipeline.sh approve'"
+}
+
+cmd_finish() {
+  # Parse finish-specific flags and action
+  local action=""
+  local confirm=""
+  while [ $# -gt 0 ]; do
+    case "$1" in
+      --confirm) confirm="yes"; shift ;;
+      -*)        die "Unknown flag for finish: $1" ;;
+      *)
+        [ -n "$action" ] && die "Unexpected argument: $1"
+        action="$1"; shift
+        ;;
+    esac
+  done
+
+  [ -z "$action" ] && die "Usage: pipeline.sh finish <merge|pr|keep|discard> [--confirm]"
+
+  # Validate action
+  case "$action" in
+    merge|pr|keep|discard) ;;
+    *) die "Unknown finish action: $action. Use: merge, pr, keep, discard." ;;
+  esac
+
+  # Resolve feature (supports completed pipelines)
+  if [ -n "$EXPLICIT_FEATURE" ]; then
+    if [ ! -f "$FEATURES_DIR/$EXPLICIT_FEATURE/pipeline.kv" ]; then
+      die "Feature '$EXPLICIT_FEATURE' not found."
+    fi
+    set_feature_context "$EXPLICIT_FEATURE"
+    validate_kv
+  else
+    # For finish, we need to find a done-but-not-finished feature
+    local found=""
+    local count=0
+    if [ -d "$FEATURES_DIR" ]; then
+      for kv in "$FEATURES_DIR"/*/pipeline.kv; do
+        [ -f "$kv" ] || continue
+        local p fa
+        p="$(grep "^phase=" "$kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+        fa="$(grep "^finish_action=" "$kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+        if [ "$p" = "done" ] && [ -z "$fa" ]; then
+          local fn
+          fn="$(grep "^feature=" "$kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+          found="$fn"
+          count=$((count + 1))
+        fi
+      done
+    fi
+    if [ "$count" -gt 1 ]; then
+      warn "Multiple completed pipelines awaiting finish:"
+      for kv in "$FEATURES_DIR"/*/pipeline.kv; do
+        [ -f "$kv" ] || continue
+        local p fa fn
+        p="$(grep "^phase=" "$kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+        fa="$(grep "^finish_action=" "$kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+        fn="$(grep "^feature=" "$kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+        if [ "$p" = "done" ] && [ -z "$fa" ]; then
+          echo "  - $fn" >&2
+        fi
+      done
+      die "Use --feature <name> to select one."
+    fi
+    if [ -z "$found" ]; then
+      die "No completed pipeline awaiting finish. Run 'pipeline.sh history' to list features."
+    fi
+    set_feature_context "$found"
+    validate_kv
+  fi
+
+  local phase
+  phase="$(read_field phase)"
+  [ "$phase" != "done" ] && die "Pipeline not complete (current phase: $phase). Finish is only available after all phases are done."
+
+  # Check idempotency
+  local existing_action
+  existing_action="$(read_field finish_action 2>/dev/null || echo "")"
+  if [ -n "$existing_action" ]; then
+    die "Already finished (action: $existing_action). Nothing to do."
+  fi
+
+  # Git availability check
+  if [ "$action" != "keep" ]; then
+    if ! command -v git >/dev/null 2>&1; then
+      die "Git not found. Use 'finish keep' to skip git operations."
+    fi
+    if ! git rev-parse --git-dir >/dev/null 2>&1; then
+      die "Not a git repository. Use 'finish keep' to skip git operations."
+    fi
+  fi
+
+  local feat branch current_branch worktree
+  feat="$(read_field feature)"
+  branch="$(read_field branch 2>/dev/null || echo "")"
+  worktree="$(read_field worktree 2>/dev/null || echo "")"
+  current_branch="$(git branch --show-current 2>/dev/null || git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")"
+
+  # Determine base branch for merge/discard
+  local base_branch=""
+  if [ "$action" = "merge" ] || [ "$action" = "discard" ]; then
+    # Try to find default branch
+    if git rev-parse --verify main >/dev/null 2>&1; then
+      base_branch="main"
+    elif git rev-parse --verify master >/dev/null 2>&1; then
+      base_branch="master"
+    else
+      die "Cannot determine base branch (no main or master). Merge/discard manually."
+    fi
+
+    # Check for uncommitted changes
+    if ! git diff --quiet 2>/dev/null || ! git diff --cached --quiet 2>/dev/null; then
+      die "Working tree has uncommitted changes. Commit or stash before '$action'."
+    fi
+  fi
+
+  # Determine which branch to operate on
+  local target_branch="${branch:-$current_branch}"
+
+  case "$action" in
+    merge)
+      [ -z "$target_branch" ] && die "No branch to merge (not on a feature branch and no branch recorded)."
+      [ "$target_branch" = "$base_branch" ] && die "Already on $base_branch. Nothing to merge."
+      # If worktree, remove it first (must not be in worktree dir when removing)
+      if [ -n "$worktree" ] && git worktree list 2>/dev/null | grep -q "$worktree"; then
+        git worktree remove "$worktree" || die "Failed to remove worktree '$worktree'."
+        info "Removed worktree: $worktree"
+      fi
+      git checkout "$base_branch" || die "Failed to checkout $base_branch."
+      git merge "$target_branch" || die "Merge failed. Resolve conflicts and retry."
+      write_field finish_action "merge"
+      write_field finished_at "$(iso_now)"
+      write_field finish_base "$base_branch"
+      rebuild_json
+      info "Merged '$target_branch' into '$base_branch'."
+      info "Tip: run tests to verify, then 'git branch -d $target_branch' to clean up."
+      ;;
+
+    pr)
+      [ -z "$target_branch" ] && die "No branch to push (not on a feature branch and no branch recorded)."
+      [ "$target_branch" = "$base_branch" ] && die "Already on $base_branch. Nothing to push."
+      git push -u origin "$target_branch" || die "Failed to push '$target_branch'."
+      write_field finish_action "pr"
+      write_field finished_at "$(iso_now)"
+      write_field finish_base "${base_branch:-}"
+      rebuild_json
+      info "Branch '$target_branch' pushed to origin."
+      info "Create a pull request: gh pr create --fill"
+      ;;
+
+    keep)
+      write_field finish_action "keep"
+      write_field finished_at "$(iso_now)"
+      rebuild_json
+      info "Branch kept as-is. Handle manually when ready."
+      ;;
+
+    discard)
+      [ "$confirm" != "yes" ] && die "Discard deletes the branch and all unmerged commits. Re-run with --confirm to proceed: pipeline.sh finish discard --confirm"
+      [ -z "$target_branch" ] && die "No branch to discard (not on a feature branch and no branch recorded)."
+      [ "$target_branch" = "$base_branch" ] && die "Cannot discard $base_branch."
+      # If worktree, force-remove it first
+      if [ -n "$worktree" ] && git worktree list 2>/dev/null | grep -q "$worktree"; then
+        git worktree remove --force "$worktree" || die "Failed to remove worktree '$worktree'."
+        info "Removed worktree: $worktree"
+      fi
+      git checkout "$base_branch" || die "Failed to checkout $base_branch."
+      git branch -D "$target_branch" || die "Failed to delete branch '$target_branch'."
+      write_field finish_action "discard"
+      write_field finished_at "$(iso_now)"
+      write_field finish_base "$base_branch"
+      rebuild_json
+      info "Branch '$target_branch' discarded."
+      ;;
+  esac
+}
+
+cmd_abandon() {
+  local feature="${1:-}"
+
+  # If --feature was specified globally, use it
+  if [ -z "$feature" ] && [ -n "$EXPLICIT_FEATURE" ]; then
+    feature="$EXPLICIT_FEATURE"
+  fi
+
+  # If still empty, try to resolve active feature
+  if [ -z "$feature" ]; then
+    feature="$(detect_active_feature)" || die "Multiple active pipelines. Use: pipeline.sh abandon <feature-name>"
+    [ -z "$feature" ] && die "No active pipeline to abandon."
+  fi
+
+  local fdir="$FEATURES_DIR/$feature"
+  [ -f "$fdir/pipeline.kv" ] || die "Feature '$feature' not found."
+
+  local phase
+  phase="$(grep "^phase=" "$fdir/pipeline.kv" 2>/dev/null | head -1 | cut -d'=' -f2-)"
+  [ "$phase" = "done" ] && die "Feature '$feature' is already completed."
+
+  set_feature_context "$feature"
+  write_field phase "done"
+  write_field abandoned_at "$(iso_now)"
+  write_field finish_action "abandoned"
+  write_field finished_at "$(iso_now)"
+
+  # Clean up worktree if present
+  local wt
+  wt="$(read_field worktree 2>/dev/null || echo "")"
+  if [ -n "$wt" ] && command -v git >/dev/null 2>&1 && git rev-parse --git-dir >/dev/null 2>&1; then
+    if git worktree list 2>/dev/null | grep -q "$wt"; then
+      git worktree remove --force "$wt" 2>/dev/null && info "Removed worktree: $wt"
+    fi
+  fi
+
+  rebuild_json
+
+  info "Feature '$feature' abandoned (was in phase: $phase)."
+  info "Artifacts remain in: .spec/features/$feature/"
+}
+
+cmd_help() {
+  echo "Spec-Driven Dev Pipeline v${VERSION}"
+  echo ""
+  echo "Usage: sh pipeline.sh [--feature <name>] <command> [args]"
+  echo ""
+  echo "Global flags:"
+  echo "  --feature <name>  Select feature (needed when multiple are active)"
+  echo ""
+  echo "Commands:"
+  echo "  init [--branch|--worktree|--no-branch] <feature>"
+  echo "                    Start a new pipeline (kebab-case name)"
+  echo "                    --branch: create git branch <prefix><name>"
+  echo "                    --worktree: create git worktree in <worktree_dir>/<name>"
+  echo "                    --no-branch: skip auto-branch/worktree from config"
+  echo "  status            Show current phase, artifacts, progress"
+  echo "  artifact [path]   Register output artifact for current phase"
+  echo "  approve           Advance to next phase (needs artifact)"
+  echo "  revisions [phase] Show revision history (current phase or specify: explore, all)"
+  echo "  history           Show all features and their status"
+  echo "  docs-check        Check project documentation status (JSON)"
+  echo "  docs-init [--all|--update|<template>...]"
+  echo "                    Create standalone docs generation queue"
+  echo "                    --all: queue all available templates"
+  echo "                    --update: queue only stale templates"
+  echo "                    <template>...: queue explicit templates by name"
+  echo "  docs-next         Print next pending template (name + path)"
+  echo "  docs-done <name>  Mark template as completed in queue"
+  echo "  docs-status       Show docs queue progress (JSON)"
+  echo "  docs-reset        Clear the docs queue"
+  echo "  task <T-N>        Mark implementation task as completed (resume tracking)"
+  echo "  config-check      Validate .spec/config.yaml keys and types"
+  echo "  inject <phase> <path>"
+  echo "                    Inject pre-written artifact and skip to that phase"
+  echo "  finish <action>   Finalize branch after pipeline completes"
+  echo "                    Actions: merge, pr, keep, discard (--confirm)"
+  echo "  abandon [feature] Abandon an active pipeline (marks as done)"
+  echo "  version           Show version"
+  echo "  help              Show this message"
+  echo ""
+  echo "Workflow (6 phases):"
+  echo "  1. init my-feature"
+  echo "  2. (agent reads templates/explore.md, investigates)"
+  echo "  3. artifact  ← writes .spec/features/my-feature/explore.md"
+  echo "  4. approve   ← user confirms"
+  echo "  5. (agent reads templates/requirements.md, generates doc)"
+  echo "  6. artifact  ← writes .spec/features/my-feature/requirements.md"
+  echo "  7. approve   ← user confirms"
+  echo "  8. (agent reads templates/design.md, generates doc)"
+  echo "  9. artifact  ← writes .spec/features/my-feature/design.md"
+  echo " 10. approve   ← user confirms"
+  echo " 11. (agent reads templates/task-plan.md, creates TDD plan)"
+  echo " 12. artifact  ← writes .spec/features/my-feature/task-plan.md"
+  echo " 13. approve   ← user confirms"
+  echo " 14. (agent reads templates/implementation.md, executes TDD plan)"
+  echo " 15. artifact  ← writes .spec/features/my-feature/implementation.md"
+  echo " 16. approve   ← user confirms"
+  echo " 17. (agent reads templates/review.md, reviews code)"
+  echo " 18. artifact  ← writes .spec/features/my-feature/review.md"
+  echo " 19. approve   ← user confirms → done!"
+  echo " 20. docs-check ← update project documentation if needed"
+  echo " 21. finish     ← merge, push PR, keep, or discard branch"
+  echo ""
+  echo "All artifacts are saved permanently in .spec/features/<feature>/ and tracked by git."
+  echo "Tip: use 'revisions' to see previous versions of an artifact within a phase."
+}
+
+# --- main ---
+
+# Parse global flags before command dispatch
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --feature)
+      [ -n "$2" ] || die "--feature requires a value"
+      EXPLICIT_FEATURE="$2"
+      shift 2
+      ;;
+    *) break ;;
+  esac
+done
+
+case "${1:-help}" in
+  init)     shift; cmd_init "$@" ;;
+  status)   cmd_status ;;
+  artifact) shift; cmd_artifact "$@" ;;
+  approve)  cmd_approve ;;
+  revisions) shift; cmd_revisions "$@" ;;
+  history)  cmd_history ;;
+  docs-check) cmd_docs_check ;;
+  task)     shift; cmd_task "$@" ;;
+  config-check) cmd_config_check ;;
+  inject)   shift; cmd_inject "$@" ;;
+  finish)   shift; cmd_finish "$@" ;;
+  abandon)  shift; cmd_abandon "$@" ;;
+  docs-init)   shift; cmd_docs_init "$@" ;;
+  docs-next)   cmd_docs_next ;;
+  docs-done)   shift; cmd_docs_done "$@" ;;
+  docs-status) cmd_docs_status ;;
+  docs-reset)  cmd_docs_reset ;;
+  version|--version|-v) cmd_version ;;
+  help|--help|-h) cmd_help ;;
+  *)        die "Unknown command: $1. Run 'pipeline.sh help' for usage." ;;
+esac
diff --git a/.agents/skills/sdd/templates/_preamble.md b/.agents/skills/sdd/templates/_preamble.md
new file mode 100644
index 00000000..37ae049c
--- /dev/null
+++ b/.agents/skills/sdd/templates/_preamble.md
@@ -0,0 +1,37 @@
+# Phase Preamble — Shared Instructions
+
+This file contains pipeline integration and project context instructions shared by all phase templates.
+
+Each phase template references this file instead of repeating these sections.
+
+---
+
+## Pipeline Integration
+
+Before starting any phase work:
+
+1. **Check pipeline state:**
+   ```
+   sh ./scripts/pipeline.sh status
+   ```
+2. **Read input artifacts:** read all completed phase artifacts listed in the status output (`history[N].artifact`). Later phases build on earlier ones — read them all for context.
+3. **After the user approves your output:**
+   a. Save the document to `.spec/features/<feature-name>/<phase-name>.md`
+   b. Register: `sh ./scripts/pipeline.sh artifact` (defaults to `.spec/features/<feature-name>/<phase-name>.md`)
+   c. Wait for user to confirm, then: `sh ./scripts/pipeline.sh approve`
+
+> **Directory separation — DO NOT mix these:**
+> - **Phase artifacts** (explore.md, requirements.md, design.md, …) → `.spec/features/<feature>/`
+> - **Project documentation** (README.md, ARCHITECTURE.md, DOMAIN.md, …) → `<docs_dir>/` (default: `.spec/`)
+>
+> Phase artifact instructions above apply ONLY to pipeline phase outputs. Project documentation is a separate workflow — see `./templates/docs-maintenance.md`.
+
+---
+
+## Project Context
+
+If `.spec/config.yaml` exists, read it now and apply:
+- **`context`** → treat as background knowledge about this project.
+- **`rules.<phase>`** → treat as additional rules for THIS phase (appended to the rules below, not replacing them). The phase-specific rule key is specified in each template.
+
+If the file does not exist, skip this step.
diff --git a/.agents/skills/sdd/templates/design.md b/.agents/skills/sdd/templates/design.md
new file mode 100644
index 00000000..432c64df
--- /dev/null
+++ b/.agents/skills/sdd/templates/design.md
@@ -0,0 +1,302 @@
+# Phase 3: Design
+
+You are a Software Architect. Your task: accept the approved requirements document and transform it into a detailed design document that fully describes **HOW** to implement the requirements.
+
+You do **NOT** write implementation code.
+You do **NOT** create task lists.
+You **design** the solution: architecture, interfaces, data models, correctness properties, and verification strategy.
+
+---
+
+Read `./templates/_preamble.md` for Pipeline Integration and Project Context instructions.
+- **Phase rule key:** `rules.design`
+- **Input artifacts:** read `history[0..1].artifact` (exploration, requirements documents)
+- **Output:** `.spec/features/<feature-name>/design.md`
+
+---
+
+### Fast-track mode
+
+When the requirements artifact contains 1–2 REQs for a small bug fix:
+
+- **§2.1 Overview:** 1 paragraph.
+- **§2.2 Architecture:** simplified diagram — only the modified component(s). Omit unchanged context unless needed for understanding.
+- **§2.3 Components:** only files requiring changes + 1–2 unchanged files for context. Skip exhaustive "NOT Requiring Changes" list.
+- **§2.4 Key Decisions:** 1 ADR max. Omit if the fix is straightforward with no meaningful alternatives.
+- **§2.5 Data Models:** omit entirely if no new types or schema changes.
+- **§2.6 Correctness Properties:** 2–3 properties focused on the bug scenario. Skip categories that don't apply.
+- **§2.7 Error Handling:** 1–2 rows (main error path + fallback if applicable).
+- **§2.8 Testing Strategy:** reference existing test infrastructure. No new test patterns needed unless the bug exposed a gap.
+
+Target artifact size: **≤ 1.5 pages**.
+
+---
+
+## Language
+
+Write the design document in the **user's language** (detected from their first message). This includes:
+- Section headers (translate "Overview", "Architecture", "Key Decisions", "Error Handling", etc.)
+- All prose: overviews, ADR context/rationale/consequences, error scenario descriptions, test descriptions
+- File change descriptions in §2.3 tables (the "Description" column)
+- Correctness Property statements: write in the user's language, but keep the formal frame in English — `Property N`, `Category`, the quantifier `For all`, and `Validates: Requirements X.Y`
+
+Keep in English (do not translate):
+- Code signatures, type definitions, field names, import paths
+- Mermaid diagram node labels (they reference code constructs)
+- File paths in §2.3 tables
+- Project Commands table values (commands must be verbatim)
+- Tag names in test tables: `Feature/<name>`, `Property/<N>`
+
+---
+
+## Step 1: Context Clarification (optional)
+
+Ask clarifying questions when:
+- The requirements admit multiple substantially different architectural solutions
+- You need information about the existing codebase to make sound design decisions
+- There are contradictions or ambiguities in the requirements
+
+Group 2–4 questions in a single message. If the requirements are self-contained and unambiguous, you may skip this step — but then label every design assumption with `[ASSUMPTION: ...]` inline where it appears, so the user can spot and correct unstated beliefs during review.
+
+---
+
+## Step 2: Design Document Generation
+
+Produce a design document with the following sections. All marked **[REQUIRED]** must appear in every design document. Sections marked **[IF APPLICABLE]** should be included when relevant.
+
+---
+
+### 2.1 Overview [REQUIRED]
+
+Provide a brief description of the feature or change being designed. If the task divides into distinct logical parts, list them explicitly.
+
+---
+
+### 2.2 Architecture [REQUIRED]
+
+Describe the overall architecture using one or more **Mermaid diagrams**. Diagrams must visually distinguish:
+
+- **New** components: `fill:#90EE90` (green)
+- **Modified** components: `fill:#FFD700` (yellow)
+- **Existing/unchanged** components: default styling
+
+Also specify the **implementation order** — which parts should be built first and why.
+
+---
+
+### 2.3 Components and Interfaces [REQUIRED]
+
+#### Files Requiring Changes
+
+Provide a table of all files that must be created or modified:
+
+| File | Change Type | Description |
+|------|-------------|-------------|
+| `path/to/file` | `[NEW]` / `[MODIFIED]` / `[DELETED]` | What specifically is added, changed, or removed |
+
+For `[MODIFIED]` files — state **what exactly changes** (not "various changes"). Example:
+- ✓ `[MODIFIED]` — adds `refreshToken()` method, modifies `authenticate()` return type
+- ✗ `[MODIFIED]` — various authentication changes
+
+#### Files NOT Requiring Changes
+
+Explicitly list files that are in scope or might be expected to change, but will **not** be modified:
+
+| File | Reason Unchanged |
+|------|-----------------|
+| `path/to/file` | Explanation of why this file is unaffected |
+
+> Do not leave this table empty or skip it. Explicitly stating what is not changing is part of the design.
+
+For each interface, provide:
+- **Signature only** — no function bodies or implementation details
+- Input and output types
+- Any preconditions or postconditions in prose
+
+---
+
+### 2.4 Key Decisions (ADR) [REQUIRED]
+
+For each significant design decision, document an Architecture Decision Record (ADR):
+
+**Decision: [short title]**
+- **Context:** What problem or trade-off necessitates this decision
+- **Options considered:** List 2–3 alternatives
+- **Decision:** Which option was chosen
+- **Rationale:** Why this option was selected over the others
+- **Consequences:** Any trade-offs or implications of this choice
+
+Include at least one ADR per non-trivial design choice. Every ADR must capture a **choice between alternatives** — not a restatement of the requirements.
+
+If the feature changes a public API, wire protocol, database schema, or configuration contract, include a **Versioning & Backward Compatibility ADR**:
+- **Versioning strategy** — how old clients/schemas coexist with new (e.g., URL versioning, header negotiation, schema migration with rollback)
+- **Breaking change assessment** — what breaks if deployed without coordination
+- **Migration path** — steps for consumers to adopt the new version
+
+---
+
+### 2.5 Data Models [IF APPLICABLE]
+
+Show full type definitions (struct/class/interface/type alias) for all data structures involved in the feature. Include:
+
+- All fields with their types and a brief comment
+- Mark new types as `[NEW]`
+- Mark types that replace or supersede existing types as `[REMOVED: <OldTypeName>]`
+- Mark modified types explicitly
+
+Example format:
+
+```
+// [NEW] Represents a scheduled job entry
+JobEntry {
+  id:         string   // Unique identifier
+  name:       string   // Human-readable label
+  schedule:   string   // Cron expression
+  enabled:    boolean  // Whether the job is active
+  lastRunAt:  datetime // Timestamp of most recent execution, nullable
+}
+```
+
+Use the syntax natural to your project's language. The goal is precision and completeness, not adherence to any specific language.
+
+---
+
+### 2.6 Correctness Properties [REQUIRED]
+
+Define formal, verifiable properties that the implementation must satisfy. These serve as the specification for testing.
+
+**Format for each property:**
+
+```
+Property <N>: <Name>
+Category: <Equivalence | Absence | Round-trip | Propagation | Exclusion>
+Statement: For all <inputs/states>, <condition that must hold>
+Validates: Requirements <X.Y>
+```
+
+**Category definitions:**
+- **Equivalence** — Two computations that should produce the same result always do
+- **Absence** — A specific error, state, or condition never occurs
+- **Round-trip** — An operation followed by its inverse returns the original value
+- **Propagation** — A change in one place correctly flows through to dependent locations
+- **Exclusion** — Two conditions or states that must never both be true simultaneously
+
+**Rules:**
+- Every property must use the "For all" quantifier — no existential claims
+- Every property must include a `Validates: Requirements X.Y` reference
+- Every requirement from the requirements document must be covered by at least one property
+- Properties must be verifiable — not vague assertions
+- When referenced in tables (Coverage Matrix, Traceability Matrix), use the abbreviated form `CP-N` (e.g., `CP-1`, `CP-2`). The full form `Property N` is used only in definitions above.
+
+**Worked examples** of each category (Equivalence, Absence, Round-trip, Propagation, Exclusion) with §2.6 definitions and §2.8 test table entries: read `./templates/reference/correctness-properties-examples.md`.
+
+---
+
+### 2.7 Error Handling [REQUIRED]
+
+Enumerate all error scenarios and specify how each is detected and handled:
+
+| Scenario | Detection | Action |
+|----------|-----------|--------|
+| Description of what can go wrong | How the system detects this condition | What the system does in response |
+
+Cover edge cases, not just happy-path failures. Include:
+- Invalid or malformed inputs
+- Missing or unavailable dependencies (files, services, connections)
+- Concurrent or race conditions (if applicable)
+- Partial failure states
+
+---
+
+### 2.8 Testing Strategy [REQUIRED]
+
+#### Test Style Source
+
+Before specifying any tests, determine the test style source using the priority cascade defined in `./templates/task-plan.md` § Test Infrastructure Discovery. If `test_skill` is configured, delegate test specification to that skill and skip the rest of §2.8.
+
+**Output:** Include a `Test Style Source` block at the top of §2.8:
+
+```markdown
+**Test Style Source:** Tier <1|2|3>
+- <Evidence: skill name / reference test file paths / "no adjacent tests found">
+- <Key patterns to follow, if Tier 2>
+```
+
+All tests specified below MUST follow the patterns identified in the Test Style Source.
+
+#### Project Commands
+
+Copy the Verification Commands table from the requirements document (§2.8) into the design document. These exact commands will be used in the implementation plan for all test/build/lint/generate steps. If the requirements document lacks this table, read the exploration document's Build Tooling section or discover commands directly from `Makefile`, `Taskfile.yml`, or `package.json` scripts.
+
+```markdown
+**Project Commands:**
+| Action   | Command     |
+|----------|-------------|
+| Test     | `<command>` |
+| Build    | `<command>` |
+| Lint     | `<command>` |
+| Generate | `<command>` |
+```
+
+> The **Generate** row is required only if the project uses code generation. These commands are passed verbatim to the implementation phase.
+
+---
+
+#### Unit Tests
+
+Define the tests required to verify the design. Tag each test with the feature or property it validates.
+
+| Test | Description | Tags |
+|------|-------------|------|
+| `test_<name>` | What is being tested and what the expected outcome is | `Feature/<name>` |
+
+#### Property-Based Tests
+
+Use a property-based testing library appropriate for the project's language. For each correctness property defined in section 2.6, provide a corresponding property-based test:
+
+| Test | Property | Generator description | Tags |
+|------|----------|-----------------------|------|
+| `prop_<name>` | Property N from section 2.6 | What inputs are randomly generated | `Property/<N>` |
+
+**Rules:**
+- Every correctness property from section 2.6 must have a corresponding property-based test
+- If no property-based testing library is available for the project's language, substitute targeted unit tests covering representative inputs for each correctness property. Mark them `prop_<name>` and tag with `Property/<N>` as usual. In the Test Style Source block, note: "PBT unavailable — using targeted unit tests as substitute."
+- Every unit test must reference at least one `Feature/` or `Property/` tag
+- Tests are specified by **what they verify** — not by implementation
+
+---
+
+## Quality Control Checklist
+
+Before presenting the design document, verify:
+
+- [ ] Every requirement from the requirements document is covered by at least one correctness property
+- [ ] Every correctness property includes a `Validates: Requirements X.Y` reference
+- [ ] Every correctness property has a corresponding property-based test in section 2.8
+- [ ] Mermaid diagrams use correct colors: green for new, yellow for modified, default for unchanged
+- [ ] The "Files NOT Requiring Changes" table in section 2.3 is filled out
+- [ ] All data types referenced in interfaces are fully defined in section 2.5 (if applicable)
+- [ ] Error handling covers edge cases and partial failure states
+- [ ] Test Style Source (§2.8) is documented with tier and evidence
+- [ ] If the feature changes public APIs, database schemas, or protocols, a versioning/backward-compatibility ADR is present in §2.4
+- [ ] The document is self-contained: a reader unfamiliar with prior context can understand the design
+
+---
+
+## Done when
+
+Do NOT suggest approval until **every** condition is true:
+
+1. Every requirement from the requirements document is traced to at least one correctness property.
+2. Every correctness property has a corresponding property-based test in §2.8.
+3. The "Files NOT Requiring Changes" table in §2.3 is non-empty.
+4. Mermaid diagrams use correct color coding: green (`#90EE90`) = new, yellow (`#FFD700`) = modified, default = unchanged.
+5. At least one ADR is present in §2.4. If changing API/schema/protocol contracts, a versioning ADR is included.
+6. Test Style Source is documented in §2.8 with tier selection and evidence.
+7. Artifact is registered via `pipeline.sh artifact <path>`.
+
+---
+
+## Antipatterns to Avoid
+
+Antipatterns for this phase: read `./templates/reference/antipatterns.md` § Design.
diff --git a/.agents/skills/sdd/templates/docs-maintenance.md b/.agents/skills/sdd/templates/docs-maintenance.md
new file mode 100644
index 00000000..dedf4da2
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs-maintenance.md
@@ -0,0 +1,209 @@
+# Documentation Workflows
+
+This file contains all documentation generation, staleness checking, and post-pipeline maintenance workflows. Referenced from `SKILL.md`.
+
+---
+
+## Standalone Documentation Workflow
+
+**Trigger:** the user requests documentation generation or update **without referring to a feature**. Examples:
+- *"Generate the project documentation"* / *"сгенерируй документацию"*
+- *"Update the docs"* / *"обнови документацию"*
+- *"Refresh AUTH.md"* / *"actualize the architecture doc"*
+
+**DO NOT** run `pipeline.sh init <feature>` for these requests. Documentation generation is a **standalone workflow** with its own state machine — `.spec/.docs-queue.kv` — driven by `pipeline.sh docs-*` commands.
+
+### Step 1: Detect intent
+
+| User intent | Command |
+|-------------|---------|
+| Bootstrap docs from scratch (no `<docs_dir>/` yet) | `pipeline.sh docs-init --all` |
+| Update stale docs only | `pipeline.sh docs-init --update` |
+| Regenerate specific docs (user named them, e.g. "regenerate AUTH and API") | `pipeline.sh docs-init auth api` |
+| User unsure | Run `pipeline.sh docs-check`. If `exists: false` → propose `--all`. If `stale: []` → propose `--update`. Wait for user confirmation. |
+
+### Step 2: Initialize the queue
+
+Run the chosen `docs-init` command. It writes `.spec/.docs-queue.kv` with the list of templates to process. If a queue already exists, the command errors — run `pipeline.sh docs-reset` first if you intend to start over.
+
+Then verify with `pipeline.sh docs-status` (returns JSON with `total`, `completed`, `pending`, `current`, `mode`).
+
+### Step 2.5: Evaluate Execution Strategy
+
+Documentation templates are **independent** (no shared state) and **heavy** (each requires reading dozens of source files). This makes parallelization safe and beneficial.
+
+**Default: SUBAGENT mode** — recommended whenever your toolset supports subagent dispatch (e.g. Claude Code `Task` tool, Cursor Composer, GitHub Copilot subagents, or equivalent).
+
+**Fallback: SEQUENTIAL mode** — used only when subagent dispatch is unavailable.
+
+**Skip mode selection if `total = 1`** — sequential always (overhead of dispatch not justified).
+
+#### Subagent mode (recommended default)
+
+You become the **controller**. Loop:
+
+1. Read `pipeline.sh docs-status` to see pending templates.
+2. **Dispatch up to 3 subagents in parallel** (rate-limit + controller context safety). Each subagent gets one template via this **context package**:
+   - Path to template file (e.g. `./templates/docs/auth.md`)
+   - `docs_dir` value (where to save output)
+   - `rules.docs` from `.spec/config.yaml` (if set)
+   - `context` from `.spec/config.yaml` (if set)
+   - One- or two-sentence summary of project stack (language, framework, key patterns)
+3. **Receive each subagent's report** — it should report which file(s) were created and where.
+4. **Verify** each generated file (controller, never delegated):
+   - File exists at the expected path
+   - **Line 1** matches `<!-- generated: YYYY-MM-DD, template: <name>.md -->`
+   - File is non-trivial (≥ 50 lines)
+5. **If verification fails**: re-dispatch with the verification error in the context package. Maximum **2 retries per template**, then escalate to the user.
+6. **If verification passes**: call `pipeline.sh docs-done <template>`.
+7. Repeat from step 1 until `docs-next` reports the queue is complete.
+8. Run `pipeline.sh docs-reset` to clear the queue.
+
+**Subagent rules:**
+- One subagent per template — never bundle multiple templates into one dispatch.
+- Subagents do NOT interact with `pipeline.sh` — only the controller does.
+- Up to 3 in parallel (no more — controller context fills up receiving multiple large outputs at once).
+- Verification is always performed by the controller.
+
+#### Sequential mode (fallback)
+
+Loop:
+
+1. Run `pipeline.sh docs-next` — it prints the next pending template name and path (tab-separated).
+2. Read the template file from the printed path.
+3. Read `rules.docs` and `context` from `.spec/config.yaml` (if set).
+4. Generate the documentation file(s) following the template's instructions. Save to `<docs_dir>/`. Verify line 1 has the `<!-- generated: ... -->` metadata.
+5. Run `pipeline.sh docs-done <template-name>`.
+6. Repeat until `docs-next` reports the queue is complete.
+
+**Fresh-chat hint:** after position 3, `docs-next` automatically prints a hint suggesting you start a fresh chat to avoid context exhaustion. The queue persists in `.spec/.docs-queue.kv` — in a new chat, run `pipeline.sh docs-status` to see your position and continue with `docs-next`.
+
+### Step 3: Auto-trigger from `docs-check`
+
+When `pipeline.sh docs-check` reports `stale: [...]` non-empty (during pre-pipeline check or on-demand), the workflow is:
+
+1. Inform the user: *"Found N stale doc(s): X, Y, Z. Initialize update queue? Say 'update docs' or 'skip'."*
+2. If user agrees → `pipeline.sh docs-init --update` → proceed to Step 2.5 (execution strategy).
+3. If user declines → no action. The user can run `pipeline.sh docs-init --update` later.
+
+The script does not auto-create the queue — explicit user consent is always required to begin a regeneration cycle.
+
+---
+
+## Documentation Context
+
+The skill supports a self-documenting mechanic via a project documentation directory (default: `.spec/`, configurable via `docs_dir` in `config.yaml`).
+
+> **Directory separation:** Project documentation files (README.md, ARCHITECTURE.md, DOMAIN.md, etc.) live in `<docs_dir>/` (default: `.spec/`). Pipeline phase artifacts (explore.md, requirements.md, design.md, etc.) live in `.spec/features/<feature>/`. **Never place project documentation into the feature directory or vice versa.**
+
+### Pre-pipeline check
+
+When running `pipeline.sh init <feature-name>`, before starting the Explore phase:
+
+1. Determine the docs directory: read `docs_dir` from `.spec/config.yaml`. If not set, default to `.spec`.
+2. Run `pipeline.sh docs-check` to determine if documentation exists and check freshness.
+3. If the docs directory **exists and contains `README.md`**:
+   - Read `README.md` for the documentation map
+   - Use available docs (`ARCHITECTURE.md`, `PACKAGES.md`, etc.) as supplementary context for ALL phases
+   - This is richer than `config.yaml` context and reduces the file-read budget in Explore phase
+   - Check the `stale` array in docs-check output. If stale files exist, suggest: *"Some docs are outdated (<file>: <N> days old). Regenerate before starting? Say 'update docs' or 'skip'."* If user agrees, follow the **Standalone Documentation Workflow** above (`pipeline.sh docs-init --update`).
+4. If the docs directory **does not exist**:
+   - Suggest to the user: *"Project documentation (<docs_dir>/) not found. I can generate it to better understand your codebase. Say 'generate docs' or 'skip'."*
+   - If user says **"generate docs"**: follow the **Standalone Documentation Workflow** above (`pipeline.sh docs-init --all`).
+   - If user says **"skip"**: proceed with the pipeline normally — documentation is NOT required
+   - **This is a soft suggestion, not a blocker.** The pipeline works without documentation.
+
+### Stale doc regeneration workflow (legacy ad-hoc)
+
+> **Prefer the Standalone Documentation Workflow** (top of this file) which uses the `docs-init --update` queue. The ad-hoc steps below remain as a reference for manual single-file regeneration.
+
+When `pipeline.sh docs-check` reports stale files (or the user requests a doc update), follow these steps:
+
+1. Parse the `docs-check` JSON output — read the `stale` array.
+2. For each stale file, extract the `template` field from its freshness metadata.
+3. Group stale files by template (one template may generate multiple files).
+4. For each affected template:
+   a. Read the template from `./templates/docs/<template>.md`.
+   b. Read the existing generated file(s) as baseline — preserve project-specific content where possible.
+   c. Regenerate following the template instructions.
+   d. Update the freshness metadata: `<!-- generated: YYYY-MM-DD, template: <name>.md -->`.
+5. Present updated files to the user for review before saving.
+6. **Never auto-overwrite.** Always confirm with the user.
+
+Use this lookup table to find the owner template for any generated file:
+
+| Generated file | Owner template |
+|----------------|----------------|
+| `README.md`, `agent-rules.md` | `bootstrap.md` |
+| `AGENTS.md` | `agents-index.md` |
+| `ARCHITECTURE.md`, `PACKAGES.md`, `DOMAIN.md`, `CODE_STYLE.md` | `core.md` |
+| `TOOLS.md`, `TESTING.md`, `FILES.md` | `development.md` |
+| `ERRORS.md` | `errors.md` |
+| `AUTH.md`, `OAUTH.md` | `auth.md` |
+| `DATABASE.md` | `database.md` |
+| `API.md` | `api.md` |
+| `DEPLOYMENT.md` | `deployment.md` |
+| `SECURITY.md` | `security.md` |
+| `CLIENTS.md` + per-client docs | `clients.md` |
+| `FEATURE_FLAGS.md` | `feature-flags.md` |
+| `BACKGROUND_JOBS.md` | `background-jobs.md` |
+| `<COMPONENT>.md` (infra) | `infrastructure.md` |
+| `CLI.md` | `cli.md` |
+| `STATE.md` | `state-management.md` |
+| `EVENTS.md` | `events.md` |
+| `COMPONENTS.md` | `components.md` |
+| `ROUTING.md` | `routing.md` |
+
+### Documentation generation templates
+
+Templates for generating project documentation are in `./templates/docs/`. Read the manifest (`./templates/docs/README.md`) to discover available templates. When generating docs:
+- Apply `rules.docs` from `config.yaml` (if present) as additional rules
+- Apply `context` from `config.yaml` as background knowledge
+- Each template is self-contained and generates one or more files in `<docs_dir>/`
+- **Freshness metadata**: when generating or updating any file in `<docs_dir>/`, MUST add `<!-- generated: YYYY-MM-DD, template: <template-name>.md -->` as the **first line** of the file (before the title). This enables `pipeline.sh docs-check` to track documentation age and detect stale files.
+- **Freshness metadata validation**: after saving a generated doc, verify that line 1 matches the pattern `<!-- generated: YYYY-MM-DD, template: <name>.md -->`. If the metadata is missing or malformed, fix it immediately — `docs-check` will silently skip files without valid metadata.
+- **Content-aware staleness**: `pipeline.sh docs-check` uses scope metadata from templates (`<!-- scope: ... -->` first line) combined with `git log --since=<generated_date>` to determine staleness. A doc is marked stale only if (a) files matching its template's scope patterns were changed since generation **and** (b) the doc exceeds the freshness threshold. Docs whose scope shows no changes remain fresh regardless of age. If a template has no scope line, the check falls back to pure age-based staleness. The JSON output includes a `scope_changed` field (`true`/`false`/`null`) per file.
+
+---
+
+## Documentation Maintenance
+
+After the pipeline reaches `phase=done` and artifacts are published, check if project documentation needs updating.
+
+### Step 1: Identify affected docs
+
+Read the design document §2.3 ("Files Requiring Changes" table). Match changed file paths against this pattern table:
+
+| Changed file pattern | Affected doc | Owner template |
+|----------------------|-------------|----------------|
+| `*domain*`, `models/*`, `types/*`, `*entity*` | `DOMAIN.md` | `core.md` |
+| new directory under `internal/`, `pkg/` | `PACKAGES.md` | `core.md` |
+| `cmd/*`, new service, layer changes | `ARCHITECTURE.md` | `core.md` |
+| `*_test*`, `__tests__/`, test config files | `TESTING.md` | `development.md` |
+| `Makefile`, `Taskfile`, `scripts/*`, CI tool changes | `TOOLS.md` | `development.md` |
+| `*error*`, `*errs*`, error codes, error types | `ERRORS.md` | `errors.md` |
+| `*auth*`, `*oauth*`, `*login*`, `*session*` | `AUTH.md` / `OAUTH.md` | `auth.md` |
+| `migrations/*`, `schema*`, `*_repo*`, `*_store*` | `DATABASE.md` | `database.md` |
+| `*handler*`, `*route*`, `*endpoint*`, `*.proto`, `openapi*` | `API.md` | `api.md` |
+| `Dockerfile`, `.github/workflows/*`, `k8s/*`, `docker-compose*` | `DEPLOYMENT.md` | `deployment.md` |
+| `*redis*`, `*kafka*`, `*traefik*`, `*prometheus*`, `*nats*` | `<COMPONENT>.md` | `infrastructure.md` |
+| `*client*`, `*frontend*`, `*mobile*` | `CLIENTS.md` | `clients.md` |
+| `*cors*`, `*csrf*`, `*rate_limit*`, `*security*`, `*helmet*` | `SECURITY.md` | `security.md` |
+| `*feature_flag*`, `*toggle*`, `*experiment*` | `FEATURE_FLAGS.md` | `feature-flags.md` |
+| `*worker*`, `*job*`, `*queue*`, `*cron*`, `*scheduler*` | `BACKGROUND_JOBS.md` | `background-jobs.md` |
+| new code style rule, naming convention change | `CODE_STYLE.md` | `core.md` |
+| `cmd/*`, `cli/*`, `commands/*`, `*cobra*`, `*clap*`, `*click*` | `CLI.md` | `cli.md` |
+| `*store*`, `*redux*`, `*bloc*`, `*provider*`, `*zustand*`, `*pinia*` | `STATE.md` | `state-management.md` |
+| `*event*`, `*messaging*`, `*pubsub*`, `*subscriber*`, `*producer*`, `*consumer*` | `EVENTS.md` | `events.md` |
+| `components/*`, `ui/*`, `design-system/*`, `*widget*`, `atoms/*`, `molecules/*` | `COMPONENTS.md` | `components.md` |
+| `routes/*`, `router/*`, `pages/*`, `screens/*`, `navigation/*` | `ROUTING.md` | `routing.md` |
+
+### Step 2: Filter and suggest
+
+1. Collect unique affected docs from the pattern matches.
+2. **Filter**: only suggest docs that already exist in `<docs_dir>/`. Do not suggest creating new docs post-pipeline.
+3. Present to user: *"This feature touched auth and database files. Update AUTH.md and DATABASE.md? Say 'update docs' or 'skip'."*
+4. If user says **"update docs"**: for each affected doc, read its owner template from `./templates/docs/`, regenerate the doc, update freshness metadata.
+5. If user says **"skip"**: done, no action.
+6. If the docs directory does not exist at all, suggest full generation (same as Pre-flight Checklist step 3).
+7. **Never auto-update documentation.** Always ask the user first.
diff --git a/.agents/skills/sdd/templates/docs/README.md b/.agents/skills/sdd/templates/docs/README.md
new file mode 100644
index 00000000..62398495
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/README.md
@@ -0,0 +1,91 @@
+# Documentation Templates — Manifest
+
+This directory contains prompt templates for generating project documentation in the `.spec/` directory (configurable via `docs_dir` in `config.yaml`).
+
+> **IMPORTANT — Output directory:** All files generated by these templates go to `<docs_dir>/` (default: `.spec/`), **NOT** to `.spec/features/<feature>/`. The features directory is for pipeline phase artifacts only. These are separate directories with separate purposes.
+
+Each template is a self-contained prompt that instructs the AI agent to analyze the project and generate specific documentation files.
+
+## Available Templates
+
+Execution order: **Bootstrap → Core → Domain-Specific**. Run Bootstrap templates first to create the index, then Core for fundamental docs, then Domain-Specific as needed.
+
+| Template | Stage | Generates | When to Use |
+|----------|-------|-----------|-------------|
+| `bootstrap.md` | Bootstrap | `README.md`, `agent-rules.md` | **Run first** — creates the root index and agent rules |
+| `agents-index.md` | Bootstrap | `AGENTS.md` (root) | First-time setup — creates the entry point that explains `.spec/` to agents |
+| `core.md` | Core | `ARCHITECTURE.md`, `PACKAGES.md`, `DOMAIN.md`, `CODE_STYLE.md` | First-time setup or after significant architectural changes |
+| `development.md` | Core | `TOOLS.md`, `TESTING.md`, `FILES.md` | First-time setup or after tooling/testing convention changes |
+| `errors.md` | Core | `ERRORS.md` | If the project defines custom error types, error codes, or error mapping |
+| `auth.md` | Domain | `AUTH.md` or `OAUTH.md` | If the project has authentication (OAuth, email+password, API keys, etc.) |
+| `database.md` | Domain | `DATABASE.md` | If the project uses SQL/NoSQL databases |
+| `api.md` | Domain | `API.md` | If the project exposes REST/gRPC/GraphQL API |
+| `deployment.md` | Domain | `DEPLOYMENT.md` | If the project has Dockerfile, CI/CD, k8s, or PaaS config |
+| `infrastructure.md` | Domain | One `<COMPONENT>.md` per infra component | If the project has Redis, Kafka, Traefik, observability, etc. |
+| `clients.md` | Domain | `CLIENTS.md` + per-client docs | If the project has frontend, mobile, Telegram, CLI clients |
+| `security.md` | Domain | `SECURITY.md` | If the project needs a security audit (input validation, CORS, secrets, OWASP) |
+| `feature-flags.md` | Domain | `FEATURE_FLAGS.md` | If the project uses feature flags, A/B testing, or gradual rollouts |
+| `background-jobs.md` | Domain | `BACKGROUND_JOBS.md` | If the project has background workers, cron jobs, task queues, or async processing |
+| `cli.md` | Domain | `CLI.md` | If the project is a CLI application (commands, flags, config, exit codes) |
+| `state-management.md` | Domain | `STATE.md` | If the project uses state management (Redux, Zustand, BLoC, Pinia, MobX, etc.) |
+| `events.md` | Domain | `EVENTS.md` | If the project uses event-driven patterns (Kafka, NATS, domain events, pub/sub) |
+| `components.md` | Domain | `COMPONENTS.md` | If the project has a UI component library or design system |
+| `routing.md` | Domain | `ROUTING.md` | If the project has client-side routing, navigation guards, or page-based structure |
+
+## Usage
+
+The agent reads this manifest to discover available templates when:
+1. **Pre-pipeline check**: `.spec/` directory is missing — agent offers to generate it
+2. **Post-pipeline update**: feature touched files that affect documentation — agent offers targeted regeneration
+
+The agent selects the relevant template(s), reads them, and follows the instructions to generate documentation.
+
+### Multi-Service / Monorepo Projects
+
+When the project contains multiple services, languages, or independently deployable components:
+- **One `.spec/` per repository, not per service.** Documentation is scoped to the repository level.
+- **Core templates** (`core.md`, `development.md`) cover the overall architecture. Use sections within generated files to describe per-service specifics (e.g., `ARCHITECTURE.md` has a section per service).
+- **Domain templates** (`api.md`, `database.md`, etc.) may be run multiple times — once per service that has the relevant concern. Name generated files with a service prefix if needed (e.g., `API-gateway.md`, `API-users.md`).
+- **Template selection is per-concern, not per-service.** Don't generate `DEPLOYMENT.md` for a service with no deployment config.
+
+## Adding a New Template
+
+To add documentation for a new topic (e.g., AUTH.md, OBSERVABILITY.md, CACHING.md):
+
+1. Create a new file `<topic>.md` in this directory
+2. Follow the structure convention below
+3. Add an entry to the "Available Templates" table above
+
+### Structure Convention
+
+Every template file must follow this structure:
+
+```markdown
+# <Topic> Documentation Template
+
+## What This Generates
+<List of files this template creates, with brief descriptions>
+
+## Instructions
+<Detailed prompt for the AI agent>
+
+### File 1: .spec/<FILENAME>.md
+<Structure and content requirements for this file>
+
+### File 2: .spec/<FILENAME>.md (if multiple)
+<Structure and content requirements for this file>
+
+## General Rules
+<Shared rules for all files generated by this template>
+```
+
+### Rules for template authors:
+- **Language**: English only
+- **Language-neutral examples**: Templates use generic or Go-like examples for illustration, but generated documentation MUST use actual code from the project in its real language/framework. Agents should adapt patterns, naming conventions, and idioms to match the project's tech stack.
+- **Examples**: Use generic placeholders, not project-specific code
+- **Self-contained**: Each template must be usable independently
+- **Real code only**: Templates must instruct the agent to use examples from actual project source, not invented ones
+- **Skip if absent**: If a topic doesn't apply to the project, the agent should skip it (not generate empty docs)
+- **Freshness metadata**: Instruct the agent to add `<!-- generated: YYYY-MM-DD, template: <name>.md -->` as the first line of every generated file. This is parsed by `pipeline.sh docs-check` for staleness detection.
+- **Single owner**: Each piece of data must live in exactly one `.spec/` file. If another template already owns a topic, add a one-line pointer (e.g., "See `ERRORS.md`") instead of duplicating content.
+- **Scope metadata**: Every template must include `<!-- scope: pattern1, pattern2, ... -->` as the **first line** (before the title). Patterns are glob expressions matching source files relevant to the template's topic. `pipeline.sh docs-check` reads these patterns to perform content-aware staleness detection — a doc is only marked stale if files matching its scope were actually changed since the last generation. Example: `<!-- scope: **/migrations/*, **/schema*, **/*repo*, **/*store* -->`.
diff --git a/.agents/skills/sdd/templates/docs/agents-index.md b/.agents/skills/sdd/templates/docs/agents-index.md
new file mode 100644
index 00000000..cb63aecd
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/agents-index.md
@@ -0,0 +1,74 @@
+<!-- scope: .copilot/*, .cursor/*, .github/copilot* -->
+# Agents Index Documentation Template
+
+## What This Generates
+
+- `AGENTS.md` in the project root — an instruction file for AI agents (Copilot, Cursor, Windsurf, Claude, etc.) explaining how to use the `.spec/` documentation directory.
+
+## Instructions
+
+Create `AGENTS.md` in the project root. This file instructs AI agents on how to work with the `.spec/` directory in this repository.
+
+The file must contain the following sections:
+
+### Section 1: What is `.spec/`
+
+Explain that `.spec/` is a project documentation directory optimized for AI agent (LLM) consumption. It contains:
+- Structured descriptions of architecture, packages, and domain
+- Code and testing conventions
+- Infrastructure and tooling descriptions
+- Agent rules (`agent-rules.md`)
+
+Purpose: give the agent full project context without having to read the entire source code.
+
+### Section 2: How to Use (for agents)
+
+Instructions for the AI agent:
+- When starting work on a project — read `.spec/README.md` for the documentation map
+- Before modifying code — read the relevant document from `.spec/` (e.g., before modifying API — read `ARCHITECTURE.md` and `CODE_STYLE.md`)
+- Always follow rules from `agent-rules.md`
+- If a document appears outdated — suggest an update
+
+### Section 3: File Structure Convention
+
+Describe file naming conventions in `.spec/`:
+- `README.md` — index of all documents, Quick Facts, project structure, ports, commands
+- `agent-rules.md` — mandatory rules for the agent (code style, naming, error handling)
+- `UPPER_CASE.md` — topical documents (`ARCHITECTURE.md`, `TESTING.md`, etc.)
+- `skills/` — directory for agent skills (custom scripts)
+- `workflows/` — directory for agent workflows
+- `prompts/` — prompts for (re)generating documentation
+
+### Section 4: Document Categories
+
+List the recommended document categories:
+- **Core**: Architecture, Packages, Domain, Code Style
+- **Development**: Tools, Testing, Files/Storage
+- **Auth & Security**: OAuth, API Keys, Permissions
+- **Infrastructure**: Observability, Caching, Proxy, Queues, Leader Election
+- **Clients**: Frontend apps, Mobile, Bots
+
+### Section 5: How to Maintain
+
+Rules for keeping documentation current:
+- When adding a new component — update or create the corresponding document
+- When changing architecture — update `ARCHITECTURE.md`
+- When adding a dependency — update `PACKAGES.md`
+- `README.md` must always reflect the current list of documents
+- Documents must contain code examples from the actual project, not abstract ones
+
+### Section 6: How to Add New Document
+
+Steps for adding a new document:
+1. Create a file `TOPIC_NAME.md` in `.spec/`
+2. Use this structure: title → overview → architectural diagram (ASCII) → details → code examples → configuration → testing → key files
+3. Add a link in `README.md` under the appropriate category
+4. If the topic is project-specific — use real code examples
+
+## General Rules
+
+- Format: Markdown with ASCII diagrams, tables, fenced code blocks with language tags
+- Style: concise, structured, no filler. Optimized for quick scanning.
+- Language: English
+- All code examples must come from the actual project source, not invented
+- If a section does not apply to the project, omit it
diff --git a/.agents/skills/sdd/templates/docs/api.md b/.agents/skills/sdd/templates/docs/api.md
new file mode 100644
index 00000000..61d7f12a
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/api.md
@@ -0,0 +1,156 @@
+<!-- scope: **/routes/*, **/handlers/*, **/api/*, *.proto, **/openapi* -->
+# API Documentation Template
+
+## What This Generates
+
+- `.spec/API.md` — API endpoint reference, conventions, middleware, and error format
+
+## Instructions
+
+You are a technical documentarian. Create API documentation for the project in the `.spec/` directory.
+Analyze: route definitions, handler files, middleware chain, proto/OpenAPI specs, request/response types, error handling.
+
+### Step 1: Identify API Surface
+
+Determine the API type(s):
+- **REST**: route files, handler functions, HTTP methods
+- **gRPC**: `.proto` files, generated code, service definitions
+- **GraphQL**: schema files, resolvers
+- **WebSocket**: upgrade handlers, event definitions
+
+For each API surface, identify:
+- Router / framework (e.g., `chi`, `gin`, `echo`, `Express`, `FastAPI`, `net/http`)
+- Base path / port
+- Authentication method (Bearer token, API key, cookie)
+
+### Step 2: Create .spec/API.md
+
+#### Structure:
+
+##### 1. Overview
+- One sentence: API type + framework
+- Base URL pattern (e.g., `http://localhost:8080/api/v1`)
+- Authentication method summary
+
+##### 2. Middleware Stack
+
+Ordered list of middleware in the request processing pipeline:
+| Order | Middleware | Purpose |
+|-------|-----------|---------|
+| 1 | Request ID | Assigns unique ID to each request |
+| 2 | Logger | Structured request logging |
+| 3 | Recovery | Panic recovery |
+| 4 | Auth | Token validation |
+| 5 | ... | ... |
+
+Determine order from the actual router setup code.
+Note which middleware is global vs route-specific.
+
+##### 3. Endpoint Reference
+
+Group endpoints by resource/domain:
+
+**Users**
+| Method | Path | Auth | Description |
+|--------|------|------|-------------|
+| POST | `/api/v1/users` | No | Create user |
+| GET | `/api/v1/users/:id` | Yes | Get user by ID |
+
+For each group, include:
+- All endpoints with method, path, auth requirement, description
+- Source file reference (handler file path)
+
+If there are many endpoints (>20), create a summary table first, then detail sections per resource.
+
+##### 4. Request / Response Conventions
+
+Describe the standard patterns:
+- **Request envelope**: is there a wrapper? (`{"data": ...}` vs flat)
+- **Response envelope**: standard response format
+  ```json
+  {
+    "data": { ... },
+    "error": null
+  }
+  ```
+- **Pagination**: pattern used (offset/limit, cursor, page/per_page)
+  - Request parameters
+  - Response metadata (`total`, `next_cursor`, `has_more`)
+- **Sorting**: parameter name and format (e.g., `?sort=name,-created_at`)
+- **Filtering**: parameter patterns (e.g., `?status=active&role=admin`)
+
+Code examples from the actual project.
+
+##### 5. Status Codes & Error Format
+
+**Standard status codes used:**
+| Status | When Used |
+|--------|-----------|
+| 200 | Successful response |
+| 201 | Resource created |
+| 400 | Validation error |
+| 401 | Unauthorized |
+| 403 | Forbidden |
+| 404 | Not found |
+| 500 | Internal error |
+
+**Error response format:**
+```json
+{
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "email is required",
+    "details": [...]
+  }
+}
+```
+
+Show the actual error response structure from the project.
+Reference the error mapping code (where domain errors become HTTP errors).
+
+##### 6. Versioning Strategy (if applicable)
+- How API versions are specified: URL prefix (`/v1/`), header (`Accept-Version`), content type
+- Current version(s)
+- Deprecation policy
+
+##### 7. Rate Limiting (if applicable)
+- Rate limit values (requests per second/minute)
+- Rate limit headers returned (`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `Retry-After`)
+- Per-user vs per-IP vs per-API-key
+- Configuration reference
+
+##### 8. Proto / OpenAPI / GraphQL Schema (if applicable)
+
+For **gRPC**:
+- `.proto` file locations
+- Service definitions (list of RPCs per service)
+- Code generation command
+- Client stub usage example
+
+For **OpenAPI**:
+- Spec file location (e.g., `api/openapi.yaml`)
+- How spec is generated (manual vs auto-generated)
+- Swagger UI URL (if served)
+- Code generation command (if applicable)
+
+For **GraphQL**:
+- Schema file location
+- Key queries and mutations
+- Resolver structure
+
+##### 9. Validation
+- Validation library / approach (struct tags, middleware, manual)
+- Where validation happens (handler, middleware, domain layer)
+- Common validation rules used
+- Custom validators (if any)
+
+Code example of a validated request from the project.
+
+## General Rules
+
+- Language: English
+- All endpoints must come from actual route definitions, not assumed
+- Request/response examples must use realistic but non-sensitive data
+- If the project has no API (library, CLI-only), do not generate this file
+- Group endpoints logically by resource, not by HTTP method
+- After creating, update `.spec/README.md`: add a link under the appropriate section
diff --git a/.agents/skills/sdd/templates/docs/auth.md b/.agents/skills/sdd/templates/docs/auth.md
new file mode 100644
index 00000000..afd5d8cb
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/auth.md
@@ -0,0 +1,142 @@
+<!-- scope: **/*auth*, **/*oauth*, **/*login*, **/*session* -->
+# Auth Documentation Template
+
+## What This Generates
+
+- `.spec/AUTH.md` (or `.spec/OAUTH.md` if the project primarily uses OAuth) — authentication and authorization documentation
+
+## Instructions
+
+You are a technical documentarian. Create auth/authorization documentation for the project in the `.spec/` directory.
+Analyze: OAuth adapters, JWT/PASETO/session middleware, login handlers, DB migrations with auth fields.
+
+### Step 1: Identify Authentication Mechanisms
+
+Determine which authentication mechanisms exist in the project:
+- OAuth2 providers (Google, GitHub, Apple, Yandex, Facebook, Twitter, etc.)
+- Email + Password (classic registration)
+- Telegram Login / Mini App initData
+- API Keys
+- SSO (SAML, OIDC)
+- Magic Links
+- 2FA / MFA
+
+### Step 2: Create the Document
+
+Create `.spec/OAUTH.md` if OAuth is the primary mechanism, or `.spec/AUTH.md` otherwise.
+
+#### Structure:
+
+##### 1. Supported Providers / Methods
+
+Table:
+| Provider/Method | Status | Validation Method |
+|-----------------|--------|-------------------|
+| Google | Ready / TODO | ID Token / API call / ... |
+
+Statuses: Ready, TODO, In Progress
+
+##### 2. Architecture (Flow)
+
+ASCII diagram of the authentication flow:
+```
+Frontend → obtains token → sends to backend → validation → session creation → response
+```
+
+Show the full flow from user click to session receipt.
+If multiple flows exist (OAuth, email+password, Telegram) — show a unified diagram.
+
+##### 3. User Lookup / Creation Logic
+
+Flowchart (Mermaid or ASCII):
+- Token received → validation
+- Search by provider_id → found? → login
+- Search by email → found? → account linking
+- Not found → create new user
+- Create session → return token
+
+##### 4. Account Linking (if applicable)
+Description of the mechanism for linking OAuth accounts to an existing user.
+
+##### 5. Authorization (if applicable)
+
+Permission and access control model:
+- Authorization model type: RBAC / ABAC / scope-based / custom
+- Permission matrix table:
+
+| Role | Action | Resource | Allowed |
+|------|--------|----------|---------|
+| admin | * | * | Yes |
+| user | read | own profile | Yes |
+
+- Where authorization checks happen (middleware, guard, decorator, in-handler)
+- Code reference: file path and key function/method for permission checking
+- How roles/permissions are stored (DB table, JWT claims, config)
+
+##### 6. Session Management (if applicable)
+
+Session storage and lifecycle:
+- Storage mechanism: database / Redis / JWT (stateless) / cookie-based
+- Session model (fields: id, user_id, token, expires_at, etc.)
+- Session lifecycle:
+  1. Creation (on login / OAuth callback)
+  2. Validation (on each request)
+  3. Refresh (token rotation)
+  4. Revocation (logout, password change)
+- Concurrent session policy: allow multiple / single session / limit per device
+- Session cleanup: TTL, cron job, on-demand
+
+##### 7. Token Lifecycle (if applicable)
+
+Token flow and management:
+- Token types used: access token, refresh token, ID token, API key
+- Token format: JWT / PASETO / opaque / custom
+- Token claims / payload structure
+- Issuance flow: what triggers token creation
+- Rotation strategy: how refresh tokens are rotated
+- Revocation mechanism: blocklist, DB flag, Redis TTL
+- Token storage on client side (see also CLIENTS.md if applicable)
+
+##### 8. Account Operations (if applicable)
+
+User account management flows:
+- **Password reset**: flow diagram (request → email → token → new password), token TTL, rate limiting
+- **Email change**: verification flow, old email notification
+- **Account deletion / deactivation**: soft delete vs hard delete, data retention, cascade rules
+- **Profile update**: which fields are mutable, validation rules
+
+For each flow: endpoint reference, code path, edge cases.
+
+##### 9. Configuration
+Configuration example (config.yml, .env, environment variables).
+Do not include real secrets — use placeholders.
+
+##### 10. Per-Provider / Per-Method Implementation
+
+For each provider/method:
+- **File**: path to implementation file
+- **Code**: key fragment (token validation, API call)
+- **Specifics**: what distinguishes this provider
+
+##### 11. Tracing (if applicable)
+Table of tracing spans for auth operations:
+| Span | Description |
+|------|-------------|
+
+##### 12. Adding a New Provider / Method
+Step-by-step guide (numbered list):
+1. Create adapter (code example)
+2. Add configuration
+3. Register in main
+4. DB migration (if needed)
+5. Update handler
+6. Update API validation
+
+## General Rules
+
+- Language: English
+- Do not create sections for providers/methods that do not exist in the project
+- Replace real secrets with placeholders
+- If the project only has email+password without OAuth — name the file `AUTH.md` and adapt the structure
+- All code examples must come from the actual project
+- After creating, update `.spec/README.md`: add a link under Auth & Security
diff --git a/.agents/skills/sdd/templates/docs/background-jobs.md b/.agents/skills/sdd/templates/docs/background-jobs.md
new file mode 100644
index 00000000..2d37e3e8
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/background-jobs.md
@@ -0,0 +1,107 @@
+<!-- scope: **/*worker*, **/*job*, **/*queue*, **/*cron* -->
+# Background Jobs Documentation Template
+
+## What This Generates
+
+- `.spec/BACKGROUND_JOBS.md` — documents the background job system, job inventory, retry strategy, and scaling approach
+
+## Instructions
+
+Analyze the project to identify any background job or async task processing. Look for:
+- Job frameworks (Sidekiq, Celery, Temporal, Asynq, Bull, Hangfire, Faktory)
+- Custom worker implementations (goroutines + channels, threads + queues)
+- Cron/scheduler configurations (crontab, systemd timers, Kubernetes CronJobs, `robfig/cron`)
+- Message queue consumers (Kafka consumers, RabbitMQ subscribers, NATS workers, SQS listeners)
+
+If no background job system is found, **skip this template entirely** — do not generate an empty document.
+
+### File: .spec/BACKGROUND_JOBS.md
+
+#### Structure:
+
+##### 1. Overview
+- **System**: which job framework or custom implementation is used
+- **Transport**: underlying queue/broker (Redis, RabbitMQ, Kafka, PostgreSQL, in-memory)
+- **Architecture pattern**: pull-based (workers poll queue) or push-based (broker dispatches)
+- **Entry point**: where workers are started (separate binary, same process, sidecar)
+
+##### 2. Job Inventory
+
+Table of all registered jobs:
+
+| Job Name | Trigger | Frequency / Event | Timeout | Retry | DLQ | Priority |
+|----------|---------|-------------------|---------|-------|-----|----------|
+| `SendWelcomeEmail` | Event: user.created | On event | 30s | 3× | ✅ | normal |
+| `CleanupExpiredSessions` | Cron | Every hour | 5m | 1× | ❌ | low |
+| `ProcessPayment` | Event: order.placed | On event | 60s | 5× exponential | ✅ | high |
+
+Trigger types: `Cron` (scheduled), `Event` (message/webhook), `Manual` (API/CLI), `Cascade` (triggered by another job).
+
+##### 3. Architecture
+
+ASCII diagram showing the job processing flow:
+
+```
+Producer → Queue/Broker → Worker Pool → Result Store
+                ↓ (on failure)
+           Dead Letter Queue → Alert
+```
+
+For each component:
+- **Producer**: which services enqueue jobs, how (SDK call, publish message, HTTP endpoint)
+- **Queue**: queue names, partitioning, priority levels
+- **Worker**: concurrency model (process per job, thread pool, goroutine pool), startup configuration
+- **Result**: where job results are stored (database, cache, nowhere), how callers check completion
+
+##### 4. Retry & Error Handling
+- **Retry policy**: max retries per job, backoff strategy (fixed, exponential, custom)
+- **Backoff configuration**: initial delay, multiplier, max delay, jitter
+- **Dead letter queue (DLQ)**: which jobs have DLQ, how DLQ is monitored, manual replay procedure
+- **Idempotency**: which jobs MUST be idempotent, how idempotency is enforced (unique keys, deduplication)
+- **Error classification**: transient errors (retry) vs permanent errors (DLQ), how the system distinguishes them
+- **Poison messages**: how malformed/unprocessable messages are handled
+
+##### 5. Concurrency & Ordering
+- **Worker count**: how many workers per queue, how it's configured
+- **Parallelism**: can the same job type run in parallel? Are there mutex/lock constraints?
+- **Ordering guarantees**: FIFO per queue? Per partition key? No guarantees?
+- **Rate limiting**: are any jobs rate-limited (e.g., email sending, API calls)?
+- **Distributed locking**: if jobs use locks, which lock mechanism (Redis, DB advisory locks, etcd)
+
+##### 6. Monitoring
+- **Metrics**: which job metrics are collected
+  - Queue depth (pending jobs)
+  - Processing duration (p50, p95, p99)
+  - Success/failure rate
+  - DLQ size
+- **Dashboards**: Grafana/Datadog dashboard links or query examples
+- **Alerting**: alert rules (e.g., "DLQ > 100", "queue depth > 1000 for 5min", "job duration > 2× p99")
+- **Logging**: what is logged per job execution (start, end, duration, error, retry count)
+
+##### 7. Scaling
+- **Horizontal scaling**: how to add more workers (replicas, autoscaling, manual)
+- **Queue partitioning**: are queues partitioned? By what key?
+- **Priority queues**: which priority levels exist, how workers consume them (weighted, strict)
+- **Backpressure**: what happens when the queue is full (block producer, drop, overflow queue)
+- **Resource limits**: CPU/memory per worker, connection pool sizing
+
+##### 8. Development
+Step-by-step guide to add a new background job:
+1. Define job payload struct/schema
+2. Implement handler function
+3. Register handler with the worker
+4. Create producer (enqueue function)
+5. Add retry/DLQ configuration
+6. Write tests (unit + integration)
+7. Add monitoring (metrics, alerts)
+8. Deploy (worker restart required?)
+
+- **Local testing**: how to run workers locally, how to enqueue test jobs
+- **Job simulation**: how to trigger a job manually for debugging (CLI, admin API, console)
+
+## General Rules
+
+- Language: English
+- Use actual job names, queue names, and code references from the project — do not invent examples
+- If no background job system exists, do not generate this file
+- For message queue consumers that are part of the infrastructure layer, defer to `infrastructure.md` for broker-level docs (connection, topology). This template owns the job-level details (handler, retry, monitoring).
diff --git a/.agents/skills/sdd/templates/docs/bootstrap.md b/.agents/skills/sdd/templates/docs/bootstrap.md
new file mode 100644
index 00000000..1d43fdf7
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/bootstrap.md
@@ -0,0 +1,126 @@
+<!-- scope: * -->
+# Bootstrap Documentation Template
+
+## What This Generates
+
+- `.spec/README.md` — project documentation index (Quick Facts, Project Structure, Running, Ports, Key Interfaces, Adding Features)
+- `.spec/agent-rules.md` — mandatory rules for AI agents working on this project (Code Style, Naming, Error Handling, Testing, Dependencies, Formatting)
+
+**Run this template first** — it creates the root index that all other templates reference and update.
+
+## Instructions
+
+You are a technical documentarian. Your task is to analyze the current project and create the foundational documentation in the `.spec/` directory for use by AI agents.
+
+### Step 1: Project Analysis
+
+Study the project structure. Pay attention to:
+- Root files: `go.mod`, `package.json`, `requirements.txt`, `Cargo.toml`, `pom.xml`, etc. → determine language and framework
+- Directory structure: `cmd/`, `src/`, `internal/`, `pkg/`, `app/`, `lib/`, etc.
+- Configuration: `docker-compose.yml`, `Makefile`, `Taskfile.yml`, `.github/`, CI/CD
+- API: proto files, OpenAPI/Swagger, GraphQL schemas
+- Tests: `*_test.go`, `*.test.ts`, `test/`, `tests/`, `spec/`
+- Infrastructure: `Dockerfile`, `kubernetes/`, `terraform/`, `configs/`
+- Client applications: `clients/`, `frontend/`, `web/`, `mobile/`
+- Dependencies: `go.sum`, `package-lock.json`, `poetry.lock`, etc.
+
+### Step 2: Create .spec/README.md
+
+Create `.spec/README.md` with the following structure:
+
+#### Header
+```markdown
+# {Project Name} Documentation
+This folder contains documentation to help LLMs and developers quickly understand the project context.
+```
+
+#### Documentation Index
+Group documents by category. Use only categories relevant to the project:
+
+- **Core** — Architecture, Packages, Domain, Code Style (always needed)
+- **Development** — Tools, Testing, Files/Storage (always needed)
+- **Auth & Security** — if the project has OAuth, JWT, API keys
+- **Infrastructure** — if the project has Docker, monitoring, caching, queues
+- **Clients** — if the project has frontend, mobile apps, bots
+
+For each document, add a link: `- [DOC_NAME.md](./DOC_NAME.md) — brief description`
+
+IMPORTANT: If documents have not been created yet, mark them as "TODO" or add a note that they will be created later.
+
+#### Quick Facts
+Table of key project technologies:
+
+```markdown
+| Aspect | Technology |
+|--------|------------|
+| **Language** | ... |
+| **Architecture** | ... |
+| **API** | ... |
+| **Database** | ... |
+| ...    | ...        |
+```
+
+Fill in only what actually exists in the project. Do not guess.
+
+#### Project Structure
+ASCII tree of main directories (1-2 levels deep) with comments:
+
+```
+project/
+├── cmd/           # Entry points
+├── internal/      # Private packages
+├── ...
+```
+
+#### Running
+Key commands for running, testing, and building. Source from Makefile/Taskfile/package.json.
+
+#### Ports
+Port table (if server components exist). Determine from docker-compose.yml, configs, code.
+
+#### Key Interfaces / Entry Points
+Main interfaces or application entry points.
+
+#### Adding New Features
+Brief guide: how to add a new endpoint / page / module.
+
+### Step 3: Create .spec/agent-rules.md
+
+Create `.spec/agent-rules.md` with rules for AI agents specific to this project.
+
+Determine rules based on:
+- Programming language (Go → Effective Go, Python → PEP8, TypeScript → project standards)
+- Linter config (`.golangci.yml`, `.eslintrc`, `.prettierrc`, `pyproject.toml`)
+- Existing code (naming patterns, error handling, file structure)
+
+Required sections:
+- **Code Style** — main style rules
+- **Naming Conventions** — variable, function, and file naming
+- **Error Handling** — project's error handling pattern
+- **Testing** — testing conventions (framework, coverage, patterns)
+- **Dependencies** — how to manage dependencies
+- **Formatting** — formatting and linting
+
+Each rule: 1-2 lines. No filler.
+
+### Step 4: Output Recommendations
+
+After creating files, output a list of recommended documents to generate:
+
+```
+Recommended documents for generation:
+1. ARCHITECTURE.md — [reason: detected Clean Architecture / MVC / ... pattern]
+2. PACKAGES.md — [reason: X packages in the project]
+3. ...
+```
+
+Include only documents for which there is real content in the project.
+
+## General Rules
+
+- Language: English
+- Use only facts from actual code — do not invent
+- If something is unclear — mark as "TODO: requires clarification"
+- Format: Markdown, ASCII diagrams, tables
+- Style: concise, no filler
+- After creating files, the README.md should serve as the map for all future documentation
diff --git a/.agents/skills/sdd/templates/docs/cli.md b/.agents/skills/sdd/templates/docs/cli.md
new file mode 100644
index 00000000..2e9f5ac5
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/cli.md
@@ -0,0 +1,146 @@
+<!-- scope: **/cmd/*, **/cli/*, **/commands/*, **/flags/* -->
+# CLI Documentation Template
+
+## What This Generates
+
+- `.spec/CLI.md` — command tree, flags, arguments, configuration, exit codes, I/O contracts
+
+## Instructions
+
+You are a technical documentarian. Create CLI application documentation for the project in the `.spec/` directory.
+Analyze: entry point files, command definitions, flag/argument parsers, configuration loaders, and shell completion scripts.
+
+### Step 1: Identify CLI Framework
+
+Check for the presence of:
+- **Go**: cobra, urfave/cli, kong, pflag, flag (stdlib)
+- **Rust**: clap, structopt, argh
+- **Python**: click, typer, argparse, fire
+- **Node.js**: commander, yargs, oclif, meow, citty
+- **Ruby**: thor, optparse, gli
+- **Dart**: args, dcli
+
+Determine from imports, `go.mod`, `Cargo.toml`, `package.json`, `requirements.txt`, `pubspec.yaml`, etc.
+
+### Step 2: Create .spec/CLI.md
+
+#### Structure:
+
+##### 1. Overview
+- One sentence: what the CLI does and who uses it
+- Installation command (if applicable)
+- Quick start example (the most common invocation)
+
+##### 2. Command Tree
+
+ASCII tree of all commands and subcommands:
+```
+myapp
+├── init              # Initialize a new project
+├── run               # Run the application
+│   ├── --watch       # Watch mode
+│   └── --port N      # Port number
+├── config
+│   ├── get <key>     # Read config value
+│   ├── set <key> <v> # Write config value
+│   └── list          # List all config values
+└── version           # Print version
+```
+
+Build from actual command registration code (e.g., `rootCmd.AddCommand()`, `@app.command()`, `.command()`).
+
+##### 3. Commands Reference
+
+For each command (or command group):
+
+```markdown
+### `myapp <command> [flags]`
+
+**Description:** One sentence.
+
+| Flag / Argument | Type | Required | Default | Description |
+|----------------|------|----------|---------|-------------|
+| `<positional>` | string | yes | — | What it is |
+| `--flag` / `-f` | bool | no | `false` | What it does |
+| `--output` / `-o` | string | no | `stdout` | Output destination |
+
+**Examples:**
+\```bash
+myapp run --port 8080
+myapp config set key value
+\```
+```
+
+Extract flags from actual struct tags, decorators, or builder calls — do not invent.
+
+##### 4. Configuration
+
+- Config file locations (precedence order): CLI flags → env vars → config file → defaults
+- Config file format (YAML, TOML, JSON, INI)
+- Config file path resolution (XDG, `$HOME/.config/`, project-local)
+- Environment variable naming convention (e.g., `MYAPP_PORT`, `MYAPP_LOG_LEVEL`)
+
+Table:
+| Setting | Flag | Env Var | Config Key | Default |
+|---------|------|---------|------------|---------|
+
+##### 5. Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `1` | General error |
+| `2` | Usage error (invalid flags/arguments) |
+| ... | Project-specific codes |
+
+Extract from actual code if defined (e.g., `os.Exit()`, `process.exit()`, `std::process::exit()`).
+
+##### 6. I/O Contracts
+
+- **stdin**: Does the CLI read from stdin? What format? (e.g., piped JSON, line-delimited)
+- **stdout**: What is printed on success? (data output, structured JSON, human-readable text)
+- **stderr**: What goes to stderr? (logs, progress, errors)
+- **Files**: Does the CLI create/modify files? Where?
+
+Piping and composition examples:
+```bash
+cat input.json | myapp process --format json > output.json
+myapp list --json | jq '.[] | .name'
+```
+
+##### 7. Shell Completion
+
+- Supported shells (bash, zsh, fish, PowerShell)
+- Installation commands for each shell
+- How completions are generated (static file, dynamic `completion` subcommand)
+
+If no completion support exists, note it explicitly.
+
+##### 8. Global Flags
+
+Flags available on all commands:
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--verbose` / `-v` | bool | `false` | Verbose output |
+| `--config` / `-c` | string | `~/.config/myapp/config.yaml` | Config file path |
+| `--quiet` / `-q` | bool | `false` | Suppress non-error output |
+
+##### 9. Error Messages & Troubleshooting
+
+Common error messages and their resolutions:
+| Error | Cause | Fix |
+|-------|-------|-----|
+
+##### 10. Development
+
+- How to run the CLI locally during development
+- How to build a release binary
+- How to add a new command (step-by-step referencing the framework)
+
+## General Rules
+
+- Language: English
+- All commands, flags, and examples must come from actual source code — do not invent
+- If the CLI has no subcommands (single-command tool), adapt the structure: skip the command tree, expand the flags section
+- If the project is not a CLI application, do not generate this file — skip entirely
+- After creating, update `.spec/README.md`: add a link under the appropriate section
diff --git a/.agents/skills/sdd/templates/docs/clients.md b/.agents/skills/sdd/templates/docs/clients.md
new file mode 100644
index 00000000..6f21ac2b
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/clients.md
@@ -0,0 +1,175 @@
+<!-- scope: **/client*, **/sdk/* -->
+# Clients Documentation Template
+
+## What This Generates
+
+- `.spec/CLIENTS.md` — overview of all client applications
+- `.spec/<CLIENT_NAME>.md` — one file per significant client (e.g., `FRONTEND.md`, `TELEGRAM.md`, `MOBILE.md`, `CLI.md`)
+
+## Instructions
+
+You are a technical documentarian. Create client application documentation for the project in the `.spec/` directory.
+Analyze directories: `clients/`, `frontend/`, `web/`, `mobile/`, `app/`, `bot/`, `cli/`, etc.
+
+### Step 1: Identify Client Applications
+
+Check for the presence of:
+- **Web SPA**: React, Vue, Angular, Svelte, Next.js, Nuxt
+- **Mobile**: React Native, Flutter, Swift, Kotlin
+- **Telegram**: Mini App, Bot
+- **Desktop**: Electron, Tauri
+- **CLI**: cobra, click, argparse
+- **Browser Extension**: Chrome, Firefox
+
+For each found client, analyze: `package.json`, `pubspec.yaml`, `build.gradle`, etc.
+
+### Step 2: Create .spec/CLIENTS.md (overview)
+
+#### Structure:
+
+##### 1. Available Clients
+Table:
+| Client | Location | Technology | Purpose |
+|--------|----------|------------|---------|
+
+##### 2. Shared Code
+What clients share:
+- API types (TypeScript interfaces, Dart models)
+- API client (Axios, Dio, fetch wrapper)
+- Commands for syncing shared code
+
+**Code Generation** (if applicable):
+- Source of truth: proto files, OpenAPI spec, GraphQL schema
+- Generation command (e.g., `make gen-client`, `npm run codegen`)
+- Output directory (e.g., `clients/shared/api/`)
+- Sync workflow: when to regenerate, how to verify freshness
+
+**API Version Management** (if applicable):
+- How clients handle API versioning (URL prefix, header, content-type)
+- Backward compatibility strategy (deprecation notices, feature flags)
+- How multiple API versions coexist on the client side
+
+##### 3. API Communication
+ASCII diagram: how clients communicate with the backend:
+```
+┌──────────┐     ┌──────────┐
+│  Client  │────>│ Backend  │
+│  (React) │ REST│ (API)    │
+└──────────┘     └──────────┘
+```
+Protocol (REST, gRPC, WebSocket, GraphQL), ports.
+
+##### 4. Authentication Flow
+Authentication steps from the client perspective:
+1. Registration → endpoint
+2. Login → endpoint → token receipt
+3. Token storage (localStorage, SecureStorage, cookies)
+4. Sending in header
+
+##### 5. Adding a New Client
+Options (React-based, native mobile, PWA, etc.) with step-by-step instructions.
+
+##### 6. Development Workflow
+Commands for running the full stack (backend + clients).
+
+### Step 3: Create Per-Client Documents
+
+Create a separate document if the client:
+- Has its own technology stack
+- Contains > 10 files
+- Has specific logic (Telegram SDK, TON Connect, etc.)
+
+#### Per-Client Template: .spec/{CLIENT_NAME}.md
+
+Example names: `FRONTEND.md`, `TELEGRAM.md`, `MOBILE.md`, `CLI.md`
+
+##### 1. Overview
+One sentence + link to base template (if applicable).
+Path: `clients/web/` or equivalent.
+
+##### 2. Tech Stack
+Table:
+| Technology | Purpose |
+|------------|---------|
+
+Determine from `package.json` / `pubspec.yaml` / `build.gradle`.
+
+##### 3. Directory Structure
+ASCII tree (2 levels):
+```
+clients/web/
+├── src/
+│   ├── api/         # API client and types
+│   ├── components/  # Reusable components
+│   ├── pages/       # Page components
+│   └── ...
+└── package.json
+```
+
+##### 4. Commands
+```bash
+npm install          # Install dependencies
+npm run dev          # Start dev server
+npm run build        # Production build
+...
+```
+
+##### 5. Routes / Navigation
+Route table:
+| Path | Component | Auth Required |
+|------|-----------|---------------|
+
+##### 6. API Client
+- Configuration (base URL, interceptors)
+- Authentication (how the token is stored and sent)
+- Available methods (table: Method | Endpoint | Auth)
+
+##### 7. UI Framework / Theme (if applicable)
+- Which UI kit is used
+- Colors, fonts, styling approach
+
+##### 8. Platform-Specific Features
+
+**For Telegram Mini App:**
+- SDK initialization
+- initData authentication
+- Mock environment for local development
+- Native UI components (@telegram-apps/telegram-ui)
+- TON Connect (if applicable)
+- Auto-login flow
+
+**For Mobile (React Native / Flutter):**
+- Platform-specific code (iOS/Android)
+- Push notifications
+- Deep linking
+- Native modules
+
+**For CLI:**
+- Commands and subcommands
+- Flags and arguments
+- Configuration files
+
+##### 9. Environment Variables
+```bash
+VITE_API_URL=http://localhost:10002
+# or
+NEXT_PUBLIC_API_URL=...
+```
+
+##### 10. Development vs Production
+Differences between dev and prod modes.
+
+##### 11. Deployment
+How to deploy the client (GitHub Pages, Vercel, App Store, npm publish).
+
+##### 12. Adding New Pages / Features
+Step-by-step instructions for adding a new page/feature.
+
+## General Rules
+
+- If a client is trivial (< 5 files) — do not create a separate document, describe it in `CLIENTS.md`
+- Determine technologies from actual `package.json` / dependencies, do not guess
+- Routes must come from the actual router code (`App.tsx`, `routes.tsx`, `router.ts`)
+- API methods must come from the actual API client
+- After creating files, update `.spec/README.md`: add links under the Clients section
+- If there are no client applications in the project, do not generate any files — skip this template entirely
diff --git a/.agents/skills/sdd/templates/docs/components.md b/.agents/skills/sdd/templates/docs/components.md
new file mode 100644
index 00000000..113afa6a
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/components.md
@@ -0,0 +1,176 @@
+<!-- scope: **/components/*, **/ui/*, **/design-system/*, **/atoms/*, **/molecules/*, **/widgets/* -->
+# Components Documentation Template
+
+## What This Generates
+
+- `.spec/COMPONENTS.md` — design system, component library, composition patterns, theming
+
+## Instructions
+
+You are a technical documentarian. Create UI component documentation for the project in the `.spec/` directory.
+Analyze: component directories, shared UI libraries, theme/token files, Storybook config, and style systems.
+
+### Step 1: Identify Component Architecture
+
+Check for the presence of:
+- **React**: `components/`, JSX/TSX files, Storybook, Radix, shadcn/ui, MUI, Ant Design, Chakra
+- **Vue**: `components/`, SFC (`.vue` files), Vuetify, PrimeVue, Quasar, Headless UI
+- **Angular**: `components/`, Angular Material, PrimeNG, standalone components
+- **Svelte**: `lib/components/`, SvelteKit components, Skeleton UI, Flowbite
+- **Flutter/Dart**: `widgets/`, `lib/ui/`, custom Widget classes, Material/Cupertino
+- **Web Components**: Custom Elements, Lit, Stencil
+
+Determine from framework files, imports, and component registration patterns.
+
+### Step 2: Create .spec/COMPONENTS.md
+
+#### Structure:
+
+##### 1. Overview
+- One sentence: component architecture approach
+- UI library / framework used (if any)
+- Design methodology: Atomic Design, BEM, component composition, compound components
+- Styling approach: CSS Modules, styled-components, Tailwind, CSS-in-JS, vanilla CSS, SCSS
+
+##### 2. Component Inventory
+
+Master table of all shared/reusable components:
+
+| Component | Location | Category | Props / Inputs | Used By |
+|-----------|----------|----------|----------------|---------|
+| `Button` | `src/components/Button.tsx` | Atom | `variant`, `size`, `disabled`, `onClick` | Throughout |
+| `Modal` | `src/components/Modal.tsx` | Molecule | `isOpen`, `onClose`, `title`, `children` | `Settings`, `Confirm` |
+| `DataTable` | `src/components/DataTable.tsx` | Organism | `columns`, `data`, `onSort`, `pagination` | `Users`, `Orders` |
+
+Categorize by complexity level (Atom / Molecule / Organism / Template) or by domain (Layout / Form / Feedback / Navigation / Data Display) — whichever the project uses.
+
+##### 3. Component API Patterns
+
+Document the conventions used across all components:
+
+**Props / Inputs:**
+- Naming conventions (e.g., `onX` for callbacks, `isX` for booleans, `xRef` for refs)
+- Required vs optional patterns
+- Default values strategy
+- Children / slots / content projection patterns
+
+**Composition patterns used:**
+- Compound components (e.g., `<Select><Select.Option>`)
+- Render props / scoped slots
+- Higher-order components / mixins
+- Headless / renderless components
+- Forward ref / template ref
+
+Code example of a well-structured component from the project.
+
+##### 4. Design Tokens / Theme
+
+**Colors:**
+| Token | Light Value | Dark Value | Usage |
+|-------|-------------|------------|-------|
+| `--color-primary` | `#3B82F6` | `#60A5FA` | Buttons, links, active states |
+| `--color-surface` | `#FFFFFF` | `#1E1E1E` | Cards, modals, backgrounds |
+
+**Typography:**
+| Token | Value | Usage |
+|-------|-------|-------|
+| `--font-family-base` | `Inter, sans-serif` | Body text |
+| `--font-size-sm` | `0.875rem` | Secondary text, captions |
+
+**Spacing:**
+| Token | Value |
+|-------|-------|
+| `--space-1` | `4px` |
+| `--space-2` | `8px` |
+
+Extract from actual theme files, CSS custom properties, Tailwind config, `ThemeData`, or token files.
+
+**Dark mode / Theming:**
+- How themes are defined and switched
+- CSS custom properties, `ThemeProvider`, `prefers-color-scheme`
+- Where theme tokens live (file path)
+
+##### 5. Layout System
+
+- Grid system: CSS Grid, Flexbox, framework grid (e.g., MUI Grid, Bootstrap Grid)
+- Breakpoints:
+
+| Name | Min Width | Typical Usage |
+|------|-----------|---------------|
+| `sm` | `640px` | Mobile landscape |
+| `md` | `768px` | Tablet |
+| `lg` | `1024px` | Desktop |
+
+- Container / wrapper components
+- Responsive patterns used (fluid, adaptive, mobile-first)
+
+##### 6. Form Components
+
+- Form library (React Hook Form, Formik, VeeValidate, Angular Reactive Forms)
+- Validation approach (schema-based with Zod/Yup, inline, server-side)
+- Error display pattern (inline, toast, summary)
+- Standard form controls:
+
+| Component | Type | Validation | Accessibility |
+|-----------|------|------------|---------------|
+| `TextInput` | text, email, password | required, pattern | `aria-label`, error announcement |
+| `Select` | dropdown | required | keyboard navigation |
+| `Checkbox` | boolean | — | `role="checkbox"` |
+
+##### 7. Icon System
+
+- Icon source: icon library (Lucide, Heroicons, Material Icons), custom SVGs, icon font
+- How icons are used in components (component import, sprite, CSS class)
+- Sizing conventions
+- Where custom icons are stored
+
+##### 8. Animation & Transitions
+
+- Animation library (Framer Motion, GSAP, Vue Transition, CSS animations)
+- Standard transitions:
+
+| Transition | Duration | Easing | Used For |
+|-----------|----------|--------|----------|
+| Fade in/out | `200ms` | `ease-in-out` | Modal, tooltip |
+| Slide | `300ms` | `ease-out` | Drawer, sidebar |
+| Scale | `150ms` | `ease-in` | Button press, card hover |
+
+- Reduced motion: how `prefers-reduced-motion` is respected
+
+##### 9. Accessibility (a11y)
+
+- WCAG target level (A, AA, AAA)
+- Keyboard navigation patterns (tab order, focus trap in modals, arrow keys in lists)
+- ARIA attributes used by components
+- Screen reader testing approach
+- Color contrast compliance
+
+##### 10. Storybook / Component Playground
+
+- Storybook version and config location (if applicable)
+- How to run: command
+- Story file naming convention (`.stories.tsx`, `.stories.vue`)
+- Addons used (a11y, viewport, controls)
+- How to add a new story
+
+If no Storybook or equivalent exists, note it.
+
+##### 11. Adding a New Component
+
+Step-by-step guide:
+1. Create component file in the correct directory
+2. Define props/inputs interface
+3. Implement with project conventions (styling, composition)
+4. Add to exports / barrel file
+5. Write story (if Storybook)
+6. Write tests (unit + visual regression if applicable)
+7. Document usage
+
+## General Rules
+
+- Language: English
+- All components, props, and tokens must come from actual source code — do not invent
+- If the project uses a pre-built UI library with no customization (e.g., just MUI out-of-box), document the usage patterns rather than the library internals
+- For Flutter/Dart projects, adapt terminology: Widget instead of Component, `ThemeData` instead of CSS tokens
+- If the project has no shared UI components (e.g., pure backend, CLI), do not generate this file — skip entirely
+- After creating, update `.spec/README.md`: add a link under the appropriate section
diff --git a/.agents/skills/sdd/templates/docs/core.md b/.agents/skills/sdd/templates/docs/core.md
new file mode 100644
index 00000000..22a591fb
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/core.md
@@ -0,0 +1,232 @@
+<!-- scope: cmd/*, internal/*, pkg/*, src/*, app/*, domain/* -->
+# Core Documentation Template
+
+## What This Generates
+
+- `.spec/ARCHITECTURE.md` — project architecture overview
+- `.spec/PACKAGES.md` — reference of all packages/modules
+- `.spec/DOMAIN.md` — domain model description
+- `.spec/CODE_STYLE.md` — project-specific code conventions
+
+## Instructions
+
+You are a technical documentarian. Create the core project documentation in the `.spec/` directory.
+Analyze the source code, directory structure, dependencies, and configuration files.
+
+Create the following files:
+
+---
+
+### File 1: .spec/ARCHITECTURE.md
+
+A document describing the project's architecture.
+
+#### Structure:
+
+##### 1. Overview
+- One sentence: application type + architectural pattern
+- ASCII diagram of application layers (top-down: Transport → Application → Adapters → Infrastructure)
+- Show connections between layers with arrows
+
+##### 2. Component Deep Dive
+For each architectural layer:
+- Name and package path
+- Key files with descriptions (table: File | Description)
+- Role in the system
+- Which interfaces it implements / uses
+
+Analyze the actual code:
+- Entry point (`main.go` / `main.ts` / `app.py` etc.)
+- Business logic (`app/`, `domain/`, `services/`, `use_cases/`)
+- Adapters (`adapters/`, `repositories/`, `infrastructure/`)
+- API layer (`api/`, `handlers/`, `controllers/`, `routes/`)
+
+##### 3. Directory Structure
+ASCII tree with comments (2-3 levels deep):
+```
+project/
+├── cmd/                    # Entry points
+│   └── app/
+│       └── internal/
+│           ├── app/        # Business logic
+│           ├── adapters/   # Infrastructure adapters
+│           └── api/        # API handlers
+├── internal/               # Shared packages
+└── configs/                # Configuration files
+```
+
+##### 4. Key Design Decisions
+Numbered list of key architectural decisions (3-7 items):
+- Architectural pattern and why
+- API strategy (REST/gRPC/GraphQL)
+- Dependency injection approach
+- Testing strategy
+- Observability approach (if present)
+- Context propagation (if present)
+
+For each decision: title, 2-3 bullet points, code example if appropriate.
+
+##### 5. Data Flow
+Trace the lifecycle of a typical request from entry point to response:
+- ASCII sequence diagram showing how a request passes through layers
+- Name the concrete types/functions involved at each step
+- Show where validation, authorization, business logic, and persistence happen
+
+Example format:
+```
+HTTP Request
+  → Router (api/router.go)
+    → Middleware (auth, logging, tracing)
+      → Handler (api/handler.go)
+        → App method (app/service.go)
+          → Adapter (adapters/repo.go)
+            → Database
+          ← Return domain object
+        ← Convert to response
+      ← Send HTTP response
+```
+
+If the project has multiple entry points (HTTP + gRPC, CLI + API), show the primary one and note differences for others.
+
+---
+
+### File 2: .spec/PACKAGES.md
+
+Reference of all project packages/modules.
+
+#### Structure:
+
+For each package/module:
+
+```markdown
+### `path/to/package`
+**Brief description** — one sentence.
+
+| File | Description |
+|------|-------------|
+| `file1.go` | Description |
+| `file2.go` | Description |
+
+Key details (if applicable):
+- Which interfaces it implements
+- Which libraries it uses
+- Specifics (tracing, caching, etc.)
+```
+
+Group packages by layer:
+1. **Application Layer** — business logic
+2. **Adapters Layer** — infrastructure adapters
+3. **API Layer** — transport
+4. **Shared/Internal** — common utilities
+5. **Generated** — generated code (proto, OpenAPI, etc.)
+
+---
+
+### File 3: .spec/DOMAIN.md
+
+Description of the project's domain model.
+
+#### Structure:
+
+##### 1. Core Entities
+For each entity:
+- Name
+- Structure definition (in the project's language)
+- Field comments (if non-obvious)
+
+##### 2. Enums / Value Objects
+All enumerations and value objects with their values.
+
+##### 3. Business Errors
+> Owned by `errors.md` → `ERRORS.md`. Do **not** duplicate the catalog here.
+
+One-line summary: "For the full business error catalog (codes, HTTP/gRPC mapping, retry policy) see `ERRORS.md`."
+If `ERRORS.md` does not exist yet, list errors inline and note that they should be migrated when `errors.md` is run.
+
+##### 4. Search/Filter Parameters
+Search/filter structures (if present).
+
+Important:
+- Take definitions from actual code (`domain.go`, `models.py`, `types.ts`, etc.)
+- Do not invent fields — only what exists in the code
+- For large structures, show all fields
+
+---
+
+### File 4: .spec/CODE_STYLE.md
+
+Project-specific code conventions.
+
+#### Structure:
+
+##### 1. Layer Structure
+ASCII diagram of layers with rules for each:
+- Which structures are used (public/private, with/without tags)
+- How conversion between layers works
+
+##### 2. Struct Tags by Layer (if applicable)
+For each layer:
+- Rule
+- Code example (Correct)
+- Explanation (Why)
+
+##### 3. Conversion Pattern
+How data is converted between layers:
+- Adapters ↔ App (convert methods)
+- API ↔ App (toX functions)
+
+##### 4. Naming Conventions
+Tables:
+- Files: file naming patterns by layer
+- Structs: visibility (public/private) by layer
+- Enums: definition pattern
+
+##### 5. Interface Conventions
+Rules for interfaces:
+- Argument order (context first, etc.)
+- Error documentation
+- Interface composition
+
+##### 6. Import Ordering
+Import order with example.
+
+##### 7. Test File Organization
+Table of test file patterns.
+
+##### 8. Quick Reference
+Summary table: Aspect | App Layer | Adapters Layer | API Layer
+
+##### 9. Error Propagation
+Rules for error handling across layers:
+- How errors are wrapped when crossing layer boundaries
+- Sentinel errors vs typed errors: when to use each
+- Error types by layer (domain errors, adapter errors, API errors)
+- Code example showing error wrapping chain from adapter → app → API
+
+##### 10. Logging Conventions
+Structured logging rules:
+- Logger type and initialization pattern
+- What to log at each layer (table: Layer | Log Level | What to Log)
+- Sensitive data handling (what must never be logged)
+- Correlation IDs / request IDs (how passed through context)
+- Code example of a properly logged operation
+
+##### 11. Concurrency Patterns (if applicable)
+Concurrency rules used in the project:
+- Goroutine / async task management (how spawned, how tracked)
+- Context cancellation propagation
+- Channel / queue usage patterns
+- Mutex / synchronization patterns
+- Graceful shutdown sequence
+
+If the project is single-threaded or has no concurrency patterns, skip this section.
+
+## General Rules
+
+- Language: English
+- Format: Markdown with ASCII diagrams, tables, fenced code blocks with language tags
+- Code examples: ONLY from the actual project, not abstract
+- If something is not found in the project — do not create the corresponding section
+- Each document must be self-contained (can be read independently)
+- Do not duplicate information between documents — cross-reference instead
+- After creating files, update `.spec/README.md`: add links to created documents in the Documentation Index section
diff --git a/.agents/skills/sdd/templates/docs/database.md b/.agents/skills/sdd/templates/docs/database.md
new file mode 100644
index 00000000..04b986bb
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/database.md
@@ -0,0 +1,114 @@
+<!-- scope: **/migrations/*, **/schema*, **/*repo*, **/*store* -->
+# Database Documentation Template
+
+## What This Generates
+
+- `.spec/DATABASE.md` — database schema, migrations, connection management, and query patterns
+
+## Instructions
+
+You are a technical documentarian. Create database documentation for the project in the `.spec/` directory.
+Analyze: migration files, ORM config, repository/DAO layer, database drivers, connection setup, seed scripts.
+
+### Step 1: Identify Database Usage
+
+Determine which databases the project uses:
+- **SQL**: PostgreSQL, MySQL, SQLite, CockroachDB
+- **NoSQL**: MongoDB, DynamoDB, Cassandra, Redis (if used as primary store)
+- **Search**: Elasticsearch, Meilisearch, Typesense
+
+For each database, identify:
+- Driver / ORM / query builder (e.g., `pgx`, `sqlx`, `GORM`, `Prisma`, `TypeORM`, `sqlc`)
+- Migration tool (e.g., `goose`, `migrate`, `knex`, `Flyway`, `Alembic`)
+- Connection configuration (env vars, config files)
+
+### Step 2: Create .spec/DATABASE.md
+
+#### Structure:
+
+##### 1. Overview
+- One sentence: which database(s) and why
+- Driver / ORM used
+- Connection string format (with placeholders, no real credentials)
+
+##### 2. Schema Overview
+
+**Entity-Relationship Diagram:**
+ASCII or Mermaid ER diagram showing tables and relationships:
+```
+┌──────────┐     ┌──────────────┐     ┌──────────┐
+│  users   │────<│ user_tokens  │     │  posts   │
+│──────────│     │──────────────│     │──────────│
+│ id (PK)  │     │ id (PK)      │     │ id (PK)  │
+│ email    │     │ user_id (FK) │  ┌──│ user_id  │
+│ name     │     │ token        │  │  │ title    │
+└──────────┘     └──────────────┘  │  └──────────┘
+      │                            │
+      └────────────────────────────┘
+```
+
+**Table Reference:**
+| Table | Purpose | Key Columns |
+|-------|---------|-------------|
+| `users` | User accounts | `id`, `email`, `name`, `created_at` |
+
+For each table: name, purpose, key columns. Group by domain area if many tables.
+
+##### 3. Migration Strategy
+- Migration tool and version
+- Migration directory path
+- Naming convention (e.g., `YYYYMMDDHHMMSS_description.sql`, sequential numbers)
+- Up / down convention: are down migrations required?
+- How to create a new migration (command)
+- How to run migrations (command)
+- How to rollback (command)
+- CI integration: are migrations run automatically in CI/CD?
+
+##### 4. Connection Management
+- Connection pool configuration (min/max connections, idle timeout)
+- Read replicas (if applicable): how reads are routed
+- Connection lifecycle: where the connection is created, how it's passed (context, DI, global)
+- Health check / ping mechanism
+- Reconnection strategy
+
+Code reference: file path where connection is initialized.
+
+##### 5. Query Patterns
+- Repository / DAO pattern: interface definition and implementation structure
+- Query builder vs raw SQL vs ORM: which approach is used and when
+- Transaction management: how transactions are started, committed, rolled back
+- Prepared statements / named queries (if applicable)
+- Pagination pattern (offset vs cursor)
+
+Code example of a typical repository method from the project.
+
+##### 6. Seed / Fixtures
+- Dev seed data: how to populate the database for local development (command)
+- Test fixtures: how test data is set up (helpers, factories, SQL files)
+- Reset command: how to wipe and re-seed the database
+- Sample data location (if seed files exist)
+
+##### 7. Indexes & Performance (if discoverable)
+Notable indexes beyond primary keys:
+| Table | Index | Columns | Type |
+|-------|-------|---------|------|
+
+Only include if indexes are defined in migration files or ORM annotations.
+
+##### 8. Backup & Recovery (if applicable)
+- Backup strategy (pg_dump, cloud snapshots, scheduled jobs)
+- Backup commands or scripts
+- Point-in-time recovery (WAL archiving, binlog)
+- Data retention policy
+
+Only include if backup tooling or scripts exist in the project.
+
+## General Rules
+
+- Language: English
+- All SQL examples must come from actual migration files or repository code
+- Do not invent tables or columns — only document what exists
+- If the project uses multiple databases, create sections for each
+- Connection strings and credentials must use placeholders, never real values
+- If the project has no database, do not generate this file — skip entirely
+- After creating, update `.spec/README.md`: add a link under the appropriate section
diff --git a/.agents/skills/sdd/templates/docs/deployment.md b/.agents/skills/sdd/templates/docs/deployment.md
new file mode 100644
index 00000000..72e88e99
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/deployment.md
@@ -0,0 +1,138 @@
+<!-- scope: Dockerfile*, docker-compose*, **/deploy/*, **/k8s/* -->
+# Deployment Documentation Template
+
+## What This Generates
+
+- `.spec/DEPLOYMENT.md` — environments, deployment pipeline, rollout strategy, health checks, and infrastructure
+
+## Instructions
+
+You are a technical documentarian. Create deployment documentation for the project in the `.spec/` directory.
+Analyze: Dockerfile, docker-compose files, CI/CD configs, Kubernetes manifests, Helm charts, Terraform files, deployment scripts, health check endpoints.
+
+### Step 1: Identify Deployment Infrastructure
+
+Check for the presence of:
+- **Containers**: `Dockerfile`, `docker-compose.yml`, `.dockerignore`
+- **CI/CD**: `.github/workflows/`, `.gitlab-ci.yml`, `Jenkinsfile`, `bitbucket-pipelines.yml`
+- **Orchestration**: `k8s/`, `helm/`, `kustomize/`, `nomad/`
+- **IaC**: `terraform/`, `pulumi/`, `cloudformation/`
+- **PaaS**: `fly.toml`, `render.yaml`, `railway.json`, `vercel.json`, `netlify.toml`
+
+### Step 2: Create .spec/DEPLOYMENT.md
+
+#### Structure:
+
+##### 1. Overview
+- One sentence: deployment target + strategy
+- ASCII diagram of the deployment pipeline:
+```
+push → CI (lint + test) → build image → push registry → deploy → health check
+```
+
+##### 2. Environments
+
+| Environment | URL / Host | Purpose | Branch | Auto-deploy |
+|-------------|-----------|---------|--------|-------------|
+| Local | `localhost:8080` | Development | — | — |
+| Staging | `staging.example.com` | Pre-production testing | `develop` | Yes |
+| Production | `example.com` | Live | `main` | No (manual) |
+
+For each environment: how to access, what branch triggers deployment, any special config.
+
+##### 3. Docker
+
+**Dockerfile analysis:**
+- Base image and build stages (multi-stage?)
+- Build arguments and their purpose
+- Exposed ports
+- Entry point / command
+- Image size optimization notes
+
+**Docker Compose (dev):**
+- Services defined and their roles
+- Volume mounts
+- Network configuration
+- Useful commands:
+```bash
+docker-compose up -d        # Start all services
+docker-compose logs -f app  # Follow app logs
+docker-compose down -v      # Stop and remove volumes
+```
+
+##### 4. CI/CD Pipeline
+
+For each CI/CD workflow file:
+- **File**: path to workflow
+- **Trigger**: on push, PR, tag, manual
+- **Steps**: ordered list of what happens
+- **Secrets required**: list of secret names (not values)
+
+Example:
+```
+.github/workflows/ci.yml
+  Trigger: push to main, PR
+  Steps: checkout → setup → lint → test → build → push image
+  Secrets: DOCKER_USERNAME, DOCKER_PASSWORD, DEPLOY_KEY
+```
+
+##### 5. Rollout Strategy
+- Strategy type: rolling update / blue-green / canary / recreate
+- Configuration (max surge, max unavailable, canary percentage)
+- Where configured (k8s deployment spec, PaaS config, script)
+- Zero-downtime deployment: yes/no, how achieved
+
+##### 6. Health Checks
+
+| Endpoint | Type | Expected Response | Timeout |
+|----------|------|-------------------|---------|
+| `/health` | Liveness | `200 OK` | 5s |
+| `/ready` | Readiness | `200 OK` | 10s |
+
+- What each check verifies (DB connection, cache, external services)
+- Startup probe (if applicable)
+- Code reference: where health check handlers are defined
+
+##### 7. Rollback Procedure
+Step-by-step rollback instructions:
+1. Identify the issue (logs, metrics, alerts)
+2. Rollback command (e.g., `kubectl rollout undo`, `git revert` + redeploy, PaaS rollback)
+3. Verify rollback (health check, smoke test)
+4. Post-mortem actions
+
+Include actual commands for the project's deployment target.
+
+##### 8. Secrets Management
+- Where secrets are stored: environment variables, vault, cloud secret manager, CI/CD variables
+- How secrets are injected: env files, k8s secrets, mounted volumes
+- Rotation policy (if documented)
+- Required secrets list:
+
+| Secret | Purpose | Where Set |
+|--------|---------|-----------|
+| `DATABASE_URL` | DB connection | CI/CD vars |
+| `JWT_SECRET` | Token signing | Vault |
+
+Do not include actual secret values.
+
+##### 9. Infrastructure Requirements (if applicable)
+Resource requirements per service:
+| Service | CPU | Memory | Storage | Replicas |
+|---------|-----|--------|---------|----------|
+
+Determine from k8s resource limits, PaaS config, or documentation.
+
+##### 10. Monitoring & Alerts (if applicable)
+- Where to view logs (log aggregator URL, command)
+- Metrics dashboard (Grafana URL, Datadog, etc.)
+- Alert rules (what triggers alerts)
+- On-call / escalation process (if documented)
+
+## General Rules
+
+- Language: English
+- All commands and paths must come from actual project files
+- Never include real secrets, tokens, or internal URLs — use placeholders
+- If the project has no deployment config (pure library), do not generate this file
+- Focus on what exists, not what should exist — document current state
+- After creating, update `.spec/README.md`: add a link under the appropriate section
diff --git a/.agents/skills/sdd/templates/docs/development.md b/.agents/skills/sdd/templates/docs/development.md
new file mode 100644
index 00000000..9aa772eb
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/development.md
@@ -0,0 +1,202 @@
+<!-- scope: Makefile, Taskfile*, scripts/*, **/ci/* -->
+# Development Documentation Template
+
+## What This Generates
+
+- `.spec/TOOLS.md` — reference of commands and project tools
+- `.spec/TESTING.md` — project testing conventions
+- `.spec/FILES.md` — file storage system description (only if applicable)
+
+## Instructions
+
+You are a technical documentarian. Create the development documentation in the `.spec/` directory.
+Analyze the Makefile, Taskfile.yml, package.json scripts, CI/CD configs, test files, and file adapters.
+
+Create the following files:
+
+---
+
+### File 1: .spec/TOOLS.md
+
+Reference of commands and project tools.
+
+#### Structure:
+
+##### 0. Dev Environment Setup
+
+Prerequisites and first-run instructions for new developers:
+
+**Prerequisites:**
+| Tool | Version | Install |
+|------|---------|---------|
+| Go / Node / Python | x.y | `brew install ...` / link |
+
+Determine from: `go.mod`, `package.json` engines, `.tool-versions`, `Dockerfile` base image, README.
+
+**First Run:**
+Numbered steps to go from a fresh clone to a running dev environment:
+1. Clone the repository
+2. Copy env file (`cp .env.example .env`) — list required variables
+3. Install dependencies (`go mod download` / `npm install`)
+4. Start infrastructure (`docker-compose up -d`)
+5. Run migrations (command)
+6. Start the application (command)
+7. Verify (health check URL or test command)
+
+If a `Makefile` / `Taskfile` has an `init` or `setup` target, reference it.
+
+##### 1. Overview
+One sentence + important note about how to run commands (e.g., "All commands must be run via `task`" or "Use `make`" or "Use `npm run`").
+
+##### 2. Quick Reference
+Table of key commands:
+| Action | Command |
+|--------|---------|
+| Unit tests | `...` |
+| Build | `...` |
+| Lint | `...` |
+| Start | `...` |
+| Stop | `...` |
+
+Source commands from:
+- Makefile / Taskfile.yml / package.json scripts
+- CI/CD configs (`.github/workflows/`, `.gitlab-ci.yml`)
+- Project README.md
+
+##### 3. Detailed Command Groups
+
+For each group (Testing, Building, Docker, Linting, Init, etc.):
+- Command with usage example (bash code block)
+- What it does (1-2 lines)
+- Dependencies (what must be run before)
+- Tools used
+
+##### 4. Code Generation (if applicable)
+Code generation commands:
+- Proto/OpenAPI generation
+- Test mocks
+- Stringer/enum generators
+- ORM generators (sqlc, ent, etc.)
+
+For each: command + what it generates + configuration file.
+
+##### 5. CI/CD Cheatsheet
+Quick commands for simulating the CI pipeline locally.
+
+##### 6. Tool Installation
+Table of tools with installation commands:
+| Tool | Install Command |
+|------|-----------------|
+
+Determine from go.mod tools, package.json devDependencies, Brewfile, etc.
+
+---
+
+### File 2: .spec/TESTING.md
+
+Project testing conventions.
+
+#### Structure:
+
+Analyze existing test files in the project and identify patterns.
+
+##### 1. Test Package Naming
+Which convention: internal test package or external test package?
+Example from actual code.
+
+##### 2. Test File Structure
+Full example of a typical test from the project:
+- Imports
+- Test case structure
+- Setup / teardown
+- Assertions
+
+##### 3. Key Patterns
+Identify and describe patterns (only those actually used):
+- Table-driven tests (map vs slice)
+- Parallel execution
+- Variable capture in range loops
+- Common test helpers (`start()`, `setup()` functions)
+- Builder pattern for test data
+- Golden files
+- Snapshot testing
+
+For each pattern: name + code example from the project.
+
+##### 4. Mock Generation
+How mocks are generated:
+- Tool (mockgen, testify/mock, etc.)
+- Generation command
+- Where stored (alongside tests / separate directory)
+- `go:generate` directive (if applicable)
+
+##### 5. Integration Tests
+- How separated from unit tests (build tags, directory, naming)
+- Run command
+- Test containers / test helpers for Docker
+- Examples of test resource initialization
+
+##### 6. Export Pattern (if applicable)
+How private functions are tested from external test packages.
+Example of `export_test.go` or equivalent.
+
+##### 7. Commands
+All testing commands:
+```bash
+# Unit tests
+...
+# Integration tests
+...
+# Coverage
+...
+# Race detector
+...
+```
+
+---
+
+### File 3: .spec/FILES.md (only if the project has file storage)
+
+Description of the file handling system.
+
+#### When to create:
+- S3/MinIO/file adapter exists
+- File upload/download functionality exists
+- Avatars, media, or documents are handled
+
+#### Structure:
+
+##### 1. Overview
+ASCII diagram of file flow: API → Application → FileStore → Storage
+
+##### 2. FileStore Interface
+Interface definition from the code.
+
+##### 3. File Model
+File structure from the domain layer.
+
+##### 4. Storage Adapter
+- Which storage (S3, MinIO, local FS, Cloudflare R2)
+- Configuration
+- Bucket / directory structure
+- File metadata
+
+##### 5. Specific Features
+Project-specific features (avatars, limits, formats, etc.)
+
+##### 6. Limitations & Recommendations
+Current limitations and improvement recommendations.
+
+##### 7. Environment Variables
+Storage configuration from docker-compose / env files.
+
+##### 8. Test Coverage
+How the file system is tested.
+
+## General Rules
+
+- All code examples — from the actual project
+- If a tool/pattern is not found — do not describe it
+- Format: Markdown, tables, fenced code blocks with language tags
+- After creating files, update `.spec/README.md`: add links under the Development section
+- If `.spec/FILES.md` does not apply (no file storage in the project), skip it entirely
diff --git a/.agents/skills/sdd/templates/docs/errors.md b/.agents/skills/sdd/templates/docs/errors.md
new file mode 100644
index 00000000..384040c2
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/errors.md
@@ -0,0 +1,172 @@
+<!-- scope: **/*error*, **/*errs* -->
+# Errors Documentation Template
+
+## What This Generates
+
+- `.spec/ERRORS.md` — error architecture, business error catalog, wrapping conventions, and API error format
+
+## Instructions
+
+You are a technical documentarian. Create error handling documentation for the project in the `.spec/` directory.
+Analyze: error type definitions, error packages, HTTP/gRPC error mapping, middleware error handlers, domain error constants.
+
+### Step 1: Identify Error Patterns
+
+Determine how the project handles errors:
+- **Custom error types**: struct-based errors with codes, domain error packages
+- **Sentinel errors**: `var ErrNotFound = errors.New(...)` / constants
+- **Error wrapping**: `fmt.Errorf("...: %w", err)` / custom wrap functions
+- **Error mapping**: domain → HTTP status, domain → gRPC code
+- **Error response format**: JSON structure returned to API consumers
+
+### Step 2: Create .spec/ERRORS.md
+
+#### Structure:
+
+##### 1. Error Architecture
+
+Layered error model showing how errors flow through the application:
+```
+┌─────────────────────────────────────────────────┐
+│  API Layer                                       │
+│  Maps domain errors → HTTP status / gRPC code   │
+│  Formats error response JSON                     │
+├─────────────────────────────────────────────────┤
+│  Application Layer                               │
+│  Returns domain errors (ErrNotFound, etc.)       │
+│  Wraps adapter errors with context               │
+├─────────────────────────────────────────────────┤
+│  Adapter Layer                                   │
+│  Wraps infrastructure errors (DB, network)       │
+│  Converts to domain errors where appropriate     │
+├─────────────────────────────────────────────────┤
+│  Infrastructure                                  │
+│  Raw errors (sql.ErrNoRows, net.Error, etc.)     │
+└─────────────────────────────────────────────────┘
+```
+
+Describe the error propagation direction and rules:
+- Which layer creates errors
+- Which layer wraps errors
+- Which layer maps/translates errors
+- Where errors are logged vs returned
+
+##### 2. Business Error Catalog
+
+Table of all defined business/domain errors:
+
+| Code | Name | HTTP Status | gRPC Code | Description |
+|------|------|-------------|-----------|-------------|
+| `NOT_FOUND` | `ErrNotFound` | 404 | `NotFound` | Resource does not exist |
+| `ALREADY_EXISTS` | `ErrAlreadyExists` | 409 | `AlreadyExists` | Resource already exists |
+| `VALIDATION` | `ErrValidation` | 400 | `InvalidArgument` | Input validation failed |
+| `UNAUTHORIZED` | `ErrUnauthorized` | 401 | `Unauthenticated` | Authentication required |
+| `FORBIDDEN` | `ErrForbidden` | 403 | `PermissionDenied` | Insufficient permissions |
+
+Group by domain area if many errors exist. Include the file path where each error is defined.
+
+##### 3. Error Wrapping Convention
+
+Rules for wrapping errors at each layer boundary:
+
+**Adapter → Application:**
+```
+// Example pattern (use actual code from the project)
+func (r *repo) GetUser(ctx context.Context, id UserID) (*User, error) {
+    row := r.db.QueryRow(ctx, query, id)
+    if err := row.Scan(...); err != nil {
+        if errors.Is(err, sql.ErrNoRows) {
+            return nil, ErrNotFound
+        }
+        return nil, fmt.Errorf("get user %s: %w", id, err)
+    }
+    ...
+}
+```
+
+**Application → API:**
+```
+// Example pattern (use actual code from the project)
+func handleError(err error) (int, ErrorResponse) {
+    switch {
+    case errors.Is(err, app.ErrNotFound):
+        return 404, ErrorResponse{Code: "NOT_FOUND", ...}
+    ...
+    }
+}
+```
+
+Show the actual wrapping pattern used in the project. Include file references.
+
+##### 4. Error Response Format
+
+The standard error response structure returned by the API:
+
+```json
+{
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "Human-readable description",
+    "details": [
+      {
+        "field": "email",
+        "message": "must be a valid email address"
+      }
+    ]
+  }
+}
+```
+
+Document:
+- Envelope structure
+- Required vs optional fields
+- How validation errors include field-level details
+- How the code maps to the Business Error Catalog
+- Content-Type header
+
+##### 5. Sentinel Errors vs Error Types
+
+When to use each approach in this project:
+
+**Sentinel errors** (simple, comparable with `errors.Is`):
+- When to use: identity-only errors without extra data
+- Examples from the project
+
+**Typed errors** (struct implementing `error` interface):
+- When to use: errors carrying extra context (field name, entity ID, etc.)
+- Examples from the project
+
+**Error interfaces** (if applicable):
+- Custom error interfaces for behavior-based checking (`errors.As`)
+- Examples from the project
+
+##### 6. Retry Policy (if applicable)
+
+Which errors are retryable and how:
+
+| Error Category | Retryable | Strategy |
+|----------------|-----------|----------|
+| Network timeout | Yes | Exponential backoff, max 3 |
+| DB connection lost | Yes | Reconnect + retry once |
+| Validation error | No | — |
+| Not found | No | — |
+| Rate limited | Yes | Respect Retry-After header |
+
+Include retry logic implementation reference if it exists in the project.
+
+##### 7. Error Logging
+
+Rules for error logging:
+- Which errors are logged and at which level (error, warn, info)
+- What context is included (request ID, user ID, stack trace)
+- Where errors are logged (handler layer, middleware, or both)
+- How to avoid double-logging (log at the top, wrap at the bottom)
+
+## General Rules
+
+- Language: English
+- All error types and codes must come from actual code — do not invent errors
+- Code examples must be from the project, showing real wrapping and mapping patterns
+- If the project has no custom error handling (uses raw errors only), document that and keep the file minimal
+- Do not duplicate the full error catalog if it already exists in `DOMAIN.md` §3 — cross-reference instead, but add HTTP/gRPC mapping columns
+- After creating, update `.spec/README.md`: add a link under the appropriate section
diff --git a/.agents/skills/sdd/templates/docs/events.md b/.agents/skills/sdd/templates/docs/events.md
new file mode 100644
index 00000000..99627f47
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/events.md
@@ -0,0 +1,159 @@
+<!-- scope: **/events/*, **/messaging/*, **/pubsub/*, **/subscribers/*, **/producers/*, **/consumers/* -->
+# Events Documentation Template
+
+## What This Generates
+
+- `.spec/EVENTS.md` — event catalog, schemas, producers/consumers, delivery guarantees, error handling
+
+## Instructions
+
+You are a technical documentarian. Create event-driven architecture documentation for the project in the `.spec/` directory.
+Analyze: event definitions, message schemas, producer/publisher implementations, consumer/subscriber handlers, queue/topic configuration, and retry/DLQ logic.
+
+### Step 1: Identify Event System
+
+Check for the presence of:
+- **Message Brokers**: Kafka, RabbitMQ, NATS, Redis Pub/Sub, AWS SQS/SNS, Google Pub/Sub, Azure Service Bus
+- **In-Process Event Bus**: EventEmitter (Node.js), mediator pattern, domain events (DDD), Spring Events
+- **Streaming**: Kafka Streams, NATS JetStream, Redis Streams, Flink
+- **Browser/Frontend**: CustomEvent, EventTarget, RxJS Subject, Vue EventBus, React event callbacks
+- **Mobile**: Flutter Streams, BroadcastChannel, NotificationCenter (iOS), LocalBroadcastManager (Android)
+- **Webhooks**: outbound event delivery over HTTP (see also `webhooks.md` if you create a separate template)
+
+For each system found, identify: client library, connection config, serialization format (JSON, Protobuf, Avro, MessagePack).
+
+### Step 2: Create .spec/EVENTS.md
+
+#### Structure:
+
+##### 1. Overview
+- One sentence: which event system(s) and why
+- Architecture pattern: event-driven, CQRS, event sourcing, pub/sub, saga/choreography
+- ASCII diagram of the event flow:
+
+```
+Producer A ──→ [Topic/Queue] ──→ Consumer X
+Producer B ──→ [Topic/Queue] ──→ Consumer Y
+                    ↓
+              [Dead Letter Queue]
+```
+
+##### 2. Event Catalog
+
+Master table of all events in the system:
+
+| Event Name | Topic / Channel | Producer | Consumer(s) | Schema | Idempotent |
+|------------|----------------|----------|-------------|--------|------------|
+| `user.created` | `users` | `UserService` | `EmailService`, `AnalyticsService` | `UserCreatedEvent` | Yes (by user_id) |
+| `order.paid` | `orders` | `PaymentGateway` | `FulfillmentService` | `OrderPaidEvent` | Yes (by order_id) |
+| `cart.updated` | in-process | `CartStore` | `CartBadge`, `CartSummary` | `CartState` | N/A |
+
+Extract from actual event publishing and subscription code — do not invent events.
+
+##### 3. Event Schemas
+
+For each event (or event group), document the payload:
+
+```typescript
+// user.created
+interface UserCreatedEvent {
+  event_id: string;        // Unique event identifier (UUID)
+  event_type: "user.created";
+  timestamp: string;       // ISO 8601
+  data: {
+    user_id: string;
+    email: string;
+    registered_via: "email" | "oauth";
+  };
+  metadata: {
+    correlation_id: string;  // Request trace ID
+    source: string;          // Producing service name
+  };
+}
+```
+
+Use the project's actual language and types. Note which fields are required vs optional.
+
+##### 4. Topics / Channels / Queues
+
+| Topic / Queue | Partitions | Retention | Consumer Group(s) | Purpose |
+|--------------|------------|-----------|-------------------|---------|
+| `users` | 3 | 7 days | `email-svc`, `analytics-svc` | User lifecycle events |
+| `orders` | 6 | 30 days | `fulfillment-svc` | Order processing |
+
+Include configuration source (env vars, config files, IaC definitions).
+
+##### 5. Producers
+
+For each producer:
+- **Location**: file path and function/method
+- **Trigger**: what causes the event to be published
+- **Serialization**: how the event is serialized before sending
+- **Error handling**: what happens if publishing fails (retry, circuit breaker, outbox pattern)
+- **Transactional outbox**: if used, describe the pattern (DB transaction + outbox table + poller)
+
+Code example of a typical producer from the project.
+
+##### 6. Consumers
+
+For each consumer:
+- **Location**: file path and function/method
+- **Concurrency**: how many concurrent consumers (worker count, partition assignment)
+- **Processing guarantee**: at-least-once, at-most-once, exactly-once
+- **Idempotency strategy**: how duplicate events are handled (idempotency key, deduplication window, upsert)
+- **Error handling**: what happens on processing failure
+- **Ordering**: does processing depend on event order? How is it guaranteed?
+
+Code example of a typical consumer from the project.
+
+##### 7. Delivery Guarantees
+
+| Guarantee | Strategy | Implementation |
+|-----------|----------|----------------|
+| At-least-once | Manual ack after processing | Consumer commits offset after handler returns |
+| Ordering | Per-key ordering | Partition key = entity ID |
+| Idempotency | Dedup by event_id | Check processed_events table before handling |
+| Exactly-once | Transactional outbox | DB transaction + outbox poller |
+
+##### 8. Dead Letter Queue (DLQ)
+
+- DLQ topic/queue name and configuration
+- When events are sent to DLQ (max retries exceeded, deserialization failure, handler exception)
+- Retry policy before DLQ: count, backoff strategy (fixed, exponential, jitter)
+- How DLQ events are monitored and reprocessed
+- Manual replay mechanism (if available)
+
+If no DLQ exists, note it explicitly and flag as a risk.
+
+##### 9. Event Versioning & Evolution
+
+- How event schemas evolve (backward-compatible additions, schema registry, version field)
+- Breaking change process: how old consumers handle new event versions
+- Schema validation: compile-time (Protobuf, Avro) or runtime (JSON Schema)
+- If no versioning strategy exists, note it and flag as a risk.
+
+##### 10. Monitoring & Observability
+
+- Consumer lag monitoring (Kafka consumer group lag, queue depth)
+- Event throughput metrics
+- Failed event alerting
+- Correlation ID / trace propagation through events
+- Dashboard links (if applicable)
+
+##### 11. Testing Events
+
+- How to test producers (unit test: event published with correct payload)
+- How to test consumers (unit test: handler processes event correctly)
+- Integration testing: in-memory broker, test containers, embedded broker
+- How to publish test events manually (CLI tool, admin endpoint, script)
+
+Code example of an event test from the project.
+
+## General Rules
+
+- Language: English
+- All events, topics, and schemas must come from actual source code — do not invent
+- If the project uses multiple event systems (e.g., Kafka for inter-service + in-process for domain events), document all and explain boundaries
+- For frontend-only event systems (CustomEvent, RxJS), adapt the template: skip DLQ, delivery guarantees, and monitoring sections
+- If the project has no event-driven patterns, do not generate this file — skip entirely
+- After creating, update `.spec/README.md`: add a link under the appropriate section
diff --git a/.agents/skills/sdd/templates/docs/feature-flags.md b/.agents/skills/sdd/templates/docs/feature-flags.md
new file mode 100644
index 00000000..45c22458
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/feature-flags.md
@@ -0,0 +1,91 @@
+<!-- scope: **/*flag*, **/*toggle*, **/*feature* -->
+# Feature Flags Documentation Template
+
+## What This Generates
+
+- `.spec/FEATURE_FLAGS.md` — documents the feature flag system, flag inventory, lifecycle, and rollout strategy
+
+## Instructions
+
+Analyze the project to identify any feature flag or feature toggle system. Look for:
+- SDK imports (LaunchDarkly, Unleash, Flagsmith, Split.io)
+- Custom flag implementations (config-based, env var-based, database-based)
+- Flag evaluation calls in application code
+- A/B testing or experimentation frameworks
+
+If no feature flag system is found, **skip this template entirely** — do not generate an empty document.
+
+### File: .spec/FEATURE_FLAGS.md
+
+#### Structure:
+
+##### 1. Overview
+- **System**: which flag provider or custom implementation is used
+- **Architecture**: how flags are loaded (SDK init, config file, env vars, database table)
+- **Evaluation flow**: where in the request lifecycle flags are checked (middleware, service layer, per-handler)
+- **Default behavior**: what happens when the flag service is unavailable (fail open / fail closed)
+
+##### 2. Flag Inventory
+
+Table of all active feature flags:
+
+| Flag Name | Type | Description | Owner | Created | Expiry | Default |
+|-----------|------|-------------|-------|---------|--------|---------|
+| `enable_new_checkout` | boolean | New checkout flow | @payments | 2025-01-15 | 2025-04-15 | false |
+| `search_algorithm` | multivariate | A/B test for search | @search | 2025-02-01 | — | `v1` |
+
+Types: `boolean`, `multivariate` (string/number variants), `percentage` (0–100).
+
+Mark flags as: 🟢 Active, 🟡 Rolling out, 🔴 Scheduled for removal.
+
+##### 3. Lifecycle
+Document the flag lifecycle in this project:
+1. **Creation** — who can create flags, where they are defined, naming conventions
+2. **Rollout** — gradual rollout strategy (percentage, user segments, regions)
+3. **Stabilization** — when a flag is considered stable (metrics period, error rate threshold)
+4. **Permanent or removal** — decision criteria: does the flag become permanent config or get removed?
+5. **Removal process** — code cleanup steps, how to find all evaluation points
+
+##### 4. Implementation Pattern
+Show the code pattern used to evaluate flags in this project:
+- **Evaluation call**: actual code example from the project (e.g., `flags.IsEnabled("feature_x", user)`)
+- **Context passing**: how user/request context reaches the flag evaluation
+- **Type safety**: is there a typed wrapper or raw string keys?
+- **Fallback**: what value is returned if evaluation fails
+
+##### 5. Testing with Flags
+- **Unit tests**: how to override flag values in tests (mock, test config, env var)
+- **Integration tests**: how to test both sides of a flag (enabled and disabled)
+- **Test matrix**: which flag combinations are tested together
+- **CI behavior**: are flags forced to a specific value in CI?
+
+##### 6. Rollout Strategy
+- **Percentage rollout**: how to do gradual rollout (1% → 10% → 50% → 100%)
+- **User targeting**: can flags be enabled per user, per org, per region?
+- **Kill switch**: how to instantly disable a flag in production
+- **Monitoring**: what metrics to watch during rollout (error rate, latency, conversion)
+- **Rollback**: how to roll back a flag without a code deploy
+
+##### 7. Cleanup Policy
+- **Stale flag detection**: how to find flags that are 100% rolled out but not removed from code
+- **Linting / static analysis**: any tooling to detect dead flag references
+- **Cleanup cadence**: how often the team reviews and removes old flags
+- **Technical debt tracking**: how stale flags are tracked (issues, labels, dashboards)
+
+##### 8. Configuration
+How flags are configured per environment:
+
+| Environment | Source | Sync | Notes |
+|-------------|--------|------|-------|
+| Development | `.env` / config file | Manual | All flags enabled by default |
+| Staging | Flag service | Real-time | Mirrors production targeting |
+| Production | Flag service | Real-time | Gradual rollout rules apply |
+
+- **Local override**: how developers enable/disable flags locally
+
+## General Rules
+
+- Language: English
+- Use actual flag names and code from the project — do not invent examples
+- If no feature flag system exists, do not generate this file
+- Mark flags scheduled for removal — this document should help cleanup efforts
diff --git a/.agents/skills/sdd/templates/docs/infrastructure.md b/.agents/skills/sdd/templates/docs/infrastructure.md
new file mode 100644
index 00000000..85974070
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/infrastructure.md
@@ -0,0 +1,157 @@
+<!-- scope: **/infra/*, **/redis*, **/kafka*, **/nats* -->
+# Infrastructure Documentation Template
+
+## What This Generates
+
+One `.spec/<COMPONENT>.md` file per significant infrastructure component discovered in the project. Examples:
+- `.spec/OBSERVABILITY.md` — OpenTelemetry, Prometheus, Grafana, Jaeger, etc.
+- `.spec/REDIS.md` — Redis caching, sessions, leader election
+- `.spec/TRAEFIK.md` / `.spec/NGINX.md` — reverse proxy
+- `.spec/QUEUES.md` / `.spec/KAFKA.md` — message queues
+- `.spec/LEADER_ELECTION.md` — distributed coordination
+- `.spec/SEARCH.md` — Elasticsearch, Meilisearch, etc.
+
+## Instructions
+
+You are a technical documentarian. Create infrastructure documentation for the project in the `.spec/` directory.
+Analyze: `docker-compose.yml`, `configs/`, caching adapters, monitoring setup, proxy config, and other infrastructure components.
+
+### Step 1: Identify Infrastructure Components
+
+Check for the presence of:
+- **Observability**: OpenTelemetry, Prometheus, Grafana, Jaeger, Tempo, Loki, Datadog, New Relic, Sentry, Pyroscope
+- **Caching**: Redis, Memcached, in-memory cache
+- **Message Queues**: Kafka, RabbitMQ, NATS, Redis Pub/Sub
+- **Reverse Proxy**: Traefik, Nginx, Caddy, Envoy
+- **Search**: Elasticsearch, Meilisearch, Typesense
+- **Distributed Coordination**: Leader election, distributed locks, service discovery
+- **CDN / Object Storage**: CloudFront, Cloudflare, S3
+
+For each discovered component, create a separate `.spec/COMPONENT_NAME.md` file.
+
+### Step 2: Create Documents
+
+For each infrastructure component, use the following template:
+
+---
+
+#### Section 1: Overview
+- One sentence: what it is and why it's used
+- ASCII diagram: how the component connects to the rest of the system
+
+#### Section 2: Architecture / Components
+If the component has multiple parts (e.g., Grafana stack = Tempo + Loki + Mimir + Alloy):
+- For each part: role, configuration file, endpoints (ports)
+
+If the component is standalone (e.g., Redis):
+- Usage diagram (which services connect, what data they store)
+
+#### Section 3: Use Cases (for general-purpose components like Redis)
+Table:
+| Use Case | Key Pattern | TTL | Purpose |
+|----------|-------------|-----|---------|
+
+#### Section 4: File Structure
+```
+path/to/adapter/
+├── file1.go    # Description
+├── file2.go    # Description
+└── ...
+```
+
+#### Section 5: Interfaces
+Interface definitions from the code (contracts.go, interfaces, etc.).
+Show the full interface code.
+
+#### Section 6: Implementation Details
+
+For each use case / method:
+- Name
+- Usage example (code)
+- Configuration
+- Key parameters (TTL, retry policy, etc.)
+
+**Type-specific sections:**
+
+**For Observability (OBSERVABILITY.md):**
+- Backend Integration: how tracing/metrics are initialized in code
+- Instrumentation Layers: table (Layer | Package | Technology | Span Names)
+- Trace-Log Correlation: how trace_id gets into logs
+- Span Hierarchy Example: span tree for a typical request
+- Grafana / Dashboard access and key queries
+
+**For Cache/Redis (REDIS.md):**
+- Generic Cache API (Set/Get/Del)
+- Session Storage: keys, TTL, format
+- Cache-Aside / Read-Through pattern
+- Invalidation strategy
+- Algorithm (for leader election and similar): steps + Lua scripts
+
+**For Reverse Proxy (TRAEFIK.md / NGINX.md):**
+- Service URLs table
+- How to customize (prefixes, domains)
+- Configuration (labels, config files)
+- Ports exposed to host
+- Troubleshooting
+
+**For Message Queues (QUEUES.md / KAFKA.md):**
+- Topics / Exchanges / Subjects
+- Producer / Consumer pattern
+- Retry / DLQ policy
+- Serialization format
+
+**For Leader Election (LEADER_ELECTION.md):**
+- Algorithm (SETNX, Consul, etcd)
+- Failover scenarios
+- Heartbeat mechanism
+- Parameters table (TTL, heartbeat interval, namespace)
+
+#### Section 7: Configuration
+
+Docker Compose fragment:
+```yaml
+service_name:
+  image: ...
+  ports: ...
+  environment: ...
+  volumes: ...
+```
+
+Application config (config.yml / .env):
+```yaml
+component:
+  url: "..."
+  option: "..."
+```
+
+#### Section 8: Testing
+- How the component is tested (integration tests, test containers)
+- Test example
+
+#### Section 9: Observability (for non-tracing components)
+- How the component is traced (redisotel, otelhttp, etc.)
+- Health check
+
+#### Section 10: Verification Commands
+```bash
+# Check connection
+docker exec container_name ...
+# View data
+...
+# Monitoring
+...
+```
+
+#### Section 11: Key Files
+Table:
+| File | Description |
+|------|-------------|
+
+## General Rules
+
+- Create a separate file for each significant infrastructure component
+- If a component is trivial (1 config, no code) — do not create a separate file, mention it in `ARCHITECTURE.md`
+- All code examples and configs — from the actual project
+- Docker Compose fragments — from the actual `docker-compose.yml`
+- After creating files, update `.spec/README.md`: add links under the Infrastructure section
+- If no infrastructure components are found, do not generate any files — skip this template entirely
diff --git a/.agents/skills/sdd/templates/docs/routing.md b/.agents/skills/sdd/templates/docs/routing.md
new file mode 100644
index 00000000..614214cc
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/routing.md
@@ -0,0 +1,198 @@
+<!-- scope: **/routes/*, **/router/*, **/pages/*, **/screens/*, **/navigation/* -->
+# Routing Documentation Template
+
+## What This Generates
+
+- `.spec/ROUTING.md` — route definitions, guards, layouts, navigation patterns, SSR/SSG strategy
+
+## Instructions
+
+You are a technical documentarian. Create routing and navigation documentation for the project in the `.spec/` directory.
+Analyze: router configuration, route definitions, page/screen components, navigation guards/middleware, layout wrappers, and deep link configuration.
+
+### Step 1: Identify Routing Framework
+
+Check for the presence of:
+- **React**: React Router, TanStack Router, Next.js App Router / Pages Router, Remix, Wouter
+- **Vue**: Vue Router, Nuxt routing (file-based)
+- **Angular**: Angular Router (@angular/router)
+- **Svelte**: SvelteKit file-based routing
+- **Flutter/Dart**: GoRouter, Navigator 2.0, auto_route, Beamer
+- **React Native**: React Navigation, Expo Router
+- **Solid**: Solid Router, SolidStart file-based routing
+
+Determine from imports, configuration files, and directory structure (file-based routing uses `pages/`, `app/`, `routes/`).
+
+### Step 2: Create .spec/ROUTING.md
+
+#### Structure:
+
+##### 1. Overview
+- One sentence: routing framework and approach
+- Routing type: code-based, file-based, or hybrid
+- Rendering strategy: CSR, SSR, SSG, ISR, or mixed
+- ASCII diagram of the route tree (high-level):
+
+```
+/
+├── / (home)                    [public]
+├── /auth
+│   ├── /login                  [public]
+│   └── /register               [public]
+├── /dashboard                  [auth required]
+│   ├── /settings               [auth required]
+│   └── /profile                [auth required]
+├── /admin/*                    [admin role]
+└── /api/* (API routes)         [server only]
+```
+
+##### 2. Route Table
+
+Complete table of all routes:
+
+| Path | Component / Page | Auth | Roles | Layout | Method | Notes |
+|------|-----------------|------|-------|--------|--------|-------|
+| `/` | `HomePage` | No | — | `MainLayout` | GET | Landing page |
+| `/login` | `LoginPage` | No | — | `AuthLayout` | GET | Redirects if authenticated |
+| `/dashboard` | `DashboardPage` | Yes | `user` | `DashboardLayout` | GET | — |
+| `/admin/users` | `AdminUsersPage` | Yes | `admin` | `AdminLayout` | GET | — |
+| `/api/users` | — | Yes | — | — | GET, POST | API route (server only) |
+
+Extract from actual router configuration, file-based route directories, or route decorators.
+
+##### 3. Route Parameters & Query Strings
+
+| Route Pattern | Param | Type | Validation | Example |
+|--------------|-------|------|------------|---------|
+| `/users/:id` | `id` | UUID | Regex / Zod | `/users/abc-123` |
+| `/posts/:slug` | `slug` | string | — | `/posts/hello-world` |
+| `/search?q=` | `q` | string | URL encoded | `/search?q=hello` |
+
+Document how params are parsed and validated (middleware, loader, schema).
+
+##### 4. Guards / Middleware / Interceptors
+
+Navigation guards that run before route access:
+
+| Guard | Applied To | Check | On Failure |
+|-------|-----------|-------|------------|
+| `authGuard` | `/dashboard/*`, `/admin/*` | Token exists and valid | Redirect to `/login` |
+| `roleGuard` | `/admin/*` | User has `admin` role | Redirect to `/403` |
+| `onboardingGuard` | `/dashboard/*` | Profile is complete | Redirect to `/onboarding` |
+
+For each guard:
+- **Location**: file path
+- **Execution order**: in what order do guards run
+- **How applied**: route meta, middleware chain, HOC wrapper, per-route config
+
+Code example of a typical guard from the project.
+
+##### 5. Layouts & Nesting
+
+Layout hierarchy:
+
+```
+RootLayout (html, body, providers)
+├── MainLayout (header, footer, nav)
+│   ├── HomePage
+│   └── AboutPage
+├── AuthLayout (centered card, no nav)
+│   ├── LoginPage
+│   └── RegisterPage
+├── DashboardLayout (sidebar, topbar)
+│   ├── DashboardPage
+│   └── SettingsPage
+└── AdminLayout (admin sidebar)
+    └── AdminPages
+```
+
+For each layout:
+- **Location**: file path
+- **Provides**: what UI chrome it adds (header, sidebar, footer)
+- **Context / Providers**: what data it fetches or provides to children (user, theme, permissions)
+
+##### 6. Data Loading
+
+How data is loaded for routes:
+
+| Pattern | Framework Feature | When |
+|---------|-------------------|------|
+| Server loader | `loader()` (Remix), `getServerSideProps` (Next), `load()` (SvelteKit) | Before render, server-side |
+| Client fetch | `useEffect`, `onMounted`, `initState` | After mount, client-side |
+| Suspense / streaming | React Suspense, deferred data | Progressive loading |
+| Static generation | `getStaticProps`, `prerender` | Build time |
+
+For each significant route, document:
+- What data is loaded and from where (API endpoint, database, cache)
+- Loading state handling (skeleton, spinner, placeholder)
+- Error state handling (error boundary, fallback component)
+
+##### 7. Navigation Patterns
+
+How navigation is triggered:
+
+| Pattern | Implementation | Example |
+|---------|---------------|---------|
+| Declarative link | `<Link to="/about">` | Menu items, breadcrumbs |
+| Programmatic | `router.push("/dashboard")` | After form submit, auth redirect |
+| Back / history | `router.back()`, `history.back()` | Cancel buttons |
+| Replace (no history entry) | `router.replace("/login")` | Auth redirects |
+| External | `window.open(url)` | Third-party links |
+
+##### 8. Deep Links & Universal Links (Mobile / PWA)
+
+If the project supports deep linking:
+- URL scheme: `myapp://path` or `https://myapp.com/path`
+- Configuration file: `AndroidManifest.xml`, `Info.plist`, `apple-app-site-association`, `assetlinks.json`
+- Route-to-screen mapping
+- Deferred deep links (install → open at correct screen)
+- Testing: how to test deep links locally
+
+If not applicable, skip this section.
+
+##### 9. Error & Special Routes
+
+| Route | Purpose | Component |
+|-------|---------|-----------|
+| `404` / `*` | Not found | `NotFoundPage` |
+| `403` | Forbidden | `ForbiddenPage` |
+| `500` | Server error | `ErrorPage` |
+| `/maintenance` | Maintenance mode | `MaintenancePage` |
+
+How errors are caught: error boundaries, `errorElement` (React Router), `+error.svelte`, `error.tsx`.
+
+##### 10. SEO & Metadata
+
+- How page titles and meta descriptions are set per route (Head component, `generateMetadata`, `useMeta`)
+- Open Graph / social sharing meta tags
+- Canonical URLs
+- Sitemap generation (static, dynamic, `sitemap.xml`)
+- `robots.txt` configuration
+
+##### 11. Route Testing
+
+- How routes are tested (navigation tests, guard tests, loader tests)
+- Testing framework and utilities (Testing Library, Playwright, Cypress)
+- How to test protected routes (mock auth, test tokens)
+- Code example from the project
+
+##### 12. Adding a New Route
+
+Step-by-step guide:
+1. Create page/screen component
+2. Add route definition (config entry or file in `pages/`)
+3. Apply guard/middleware if needed
+4. Assign layout
+5. Add data loader (if SSR/SSG)
+6. Set page metadata (title, description)
+7. Add to navigation (menu, breadcrumbs)
+8. Write tests
+
+## General Rules
+
+- Language: English
+- All routes, guards, and layouts must come from actual source code — do not invent
+- If the project uses file-based routing, document the directory structure as the primary route definition source
+- For API-only projects (no pages/screens), do not generate this file — skip entirely
+- For Flutter/Dart, adapt terminology: Screen instead of Page, Navigator/GoRouter instead of React Router
+- After creating, update `.spec/README.md`: add a link under the appropriate section
diff --git a/.agents/skills/sdd/templates/docs/security.md b/.agents/skills/sdd/templates/docs/security.md
new file mode 100644
index 00000000..6b93b0d1
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/security.md
@@ -0,0 +1,209 @@
+<!-- scope: **/*security*, **/*crypto*, **/*cert* -->
+# Security Documentation Template
+
+## What This Generates
+
+- `.spec/SECURITY.md` — security model, threat boundaries, input validation, secrets management, and OWASP Top 10 mapping
+
+## Instructions
+
+You are a technical documentarian with a security focus. Create security documentation for the project in the `.spec/` directory.
+Analyze: input validation logic, authentication/authorization middleware, CORS/CSP config, rate limiting, TLS setup, secrets handling, dependency manifests, security headers.
+
+**Important**: This template focuses on the **security perspective** of the project. It cross-references `AUTH.md` (if it exists) for detailed auth flows and `DEPLOYMENT.md` for infrastructure security, but does not duplicate them. Instead, it audits and evaluates security posture.
+
+### Step 1: Identify Security Surface
+
+Map the project's security surface:
+- **Entry points**: HTTP endpoints, gRPC services, WebSocket handlers, CLI commands, message consumers
+- **Trust boundaries**: external → API gateway → backend → database, user input → validation → business logic
+- **Sensitive data**: PII fields, credentials, tokens, financial data
+- **Third-party integrations**: OAuth providers, payment systems, external APIs
+
+### Step 2: Create .spec/SECURITY.md
+
+#### Structure:
+
+##### 1. Security Overview
+
+High-level security posture:
+- One sentence: security model summary (e.g., "Token-based auth with RBAC, TLS everywhere, secrets in Vault")
+- Trust boundary diagram (ASCII):
+```
+┌─────────────────────────────────────────────┐
+│  External (untrusted)                        │
+│  ┌─────────┐    ┌──────────┐                │
+│  │ Browser │    │ Mobile   │                │
+│  └────┬────┘    └────┬─────┘                │
+│       └──────┬───────┘                       │
+├──────────────┼───────────────────────────────┤
+│  DMZ         │                               │
+│  ┌───────────▼──────────┐                   │
+│  │  Reverse Proxy / LB  │                   │
+│  └───────────┬──────────┘                   │
+├──────────────┼───────────────────────────────┤
+│  Internal (trusted)                          │
+│  ┌───────────▼──────────┐  ┌─────────────┐ │
+│  │  Application Server  │──│  Database    │ │
+│  └──────────────────────┘  └─────────────┘ │
+└─────────────────────────────────────────────┘
+```
+- List of security-critical components with file references
+
+##### 2. Input Validation
+
+Input sanitization strategy:
+- **Validation layer**: where validation happens (handler, middleware, domain, or all)
+- **Validation approach**: struct tags, validation library, manual checks
+- **Injection prevention**:
+  - SQL injection: parameterized queries? ORM? raw SQL audit
+  - XSS: output encoding, template escaping, CSP
+  - Command injection: any `exec` / `os.Command` usage? input sanitization
+  - Path traversal: file path validation
+- **Validation rules**: table of key validated inputs:
+
+| Input | Location | Validation | Sanitization |
+|-------|----------|------------|--------------|
+| email | POST /users | format, length | lowercase, trim |
+| file upload | POST /files | size, mime type | rename, virus scan |
+
+Code reference: file path where validation is implemented.
+
+##### 3. Authentication & Authorization Audit
+
+Security-focused review of auth (cross-references `AUTH.md` if it exists):
+- **Authentication strength**: password policy (min length, complexity), brute force protection (rate limit, lockout)
+- **Token security**: token type, signing algorithm, expiry times, rotation policy
+- **Session security**: HttpOnly cookies, Secure flag, SameSite, session fixation prevention
+- **Privilege escalation prevention**: horizontal (user A accessing user B's data) and vertical (user → admin)
+- **Known weaknesses or TODOs**: any `// TODO: security` comments, missing auth checks
+
+If `AUTH.md` exists, reference it for flow details and focus here on security audit findings.
+
+##### 4. Transport Security
+
+TLS and network security:
+- **TLS configuration**: version (1.2/1.3), cipher suites, certificate source (Let's Encrypt, self-signed, CA)
+- **Internal communication**: mTLS between services? plain HTTP internally?
+- **Certificate management**: how certificates are provisioned and rotated
+- **Redirect policy**: HTTP → HTTPS redirect enforced?
+
+Code/config reference for TLS setup.
+
+##### 5. CORS & CSP
+
+Cross-origin and content security policies:
+- **CORS configuration**:
+  - Allowed origins (exact list or pattern)
+  - Allowed methods and headers
+  - Credentials policy
+  - Preflight cache duration
+  - Code reference: where CORS is configured
+- **Content Security Policy** (if applicable):
+  - CSP directives (script-src, style-src, connect-src, etc.)
+  - Report-only vs enforced
+  - Where CSP header is set
+
+##### 6. Rate Limiting & Abuse Prevention
+
+- **Rate limits**: table of limits per endpoint or operation:
+
+| Scope | Limit | Window | Action |
+|-------|-------|--------|--------|
+| Login | 5 req | 1 min | 429 + lockout |
+| API global | 100 req | 1 min | 429 |
+| File upload | 10 req | 1 hour | 429 |
+
+- **Rate limit implementation**: middleware, reverse proxy, cloud WAF
+- **Headers returned**: `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `Retry-After`
+- **DDoS mitigation**: Cloudflare, AWS Shield, or application-level measures
+- **Bot protection**: CAPTCHA, proof-of-work, behavioral analysis
+
+##### 7. Secrets Management (audit only)
+
+> Operational details (inventory, storage, rotation, local dev) are owned by `deployment.md` → `DEPLOYMENT.md §8 Secrets`.
+> This section focuses on **security audit**: anti-patterns, gaps, and recommendations.
+
+- **Anti-patterns to flag**: secrets in code, secrets in git history, secrets in logs, unencrypted config files
+- **Gaps**: any secrets without rotation, any secrets accessible beyond need-to-know
+- **Recommendations**: concrete next steps to improve secrets hygiene
+
+##### 8. Data Protection
+
+Data handling and privacy:
+- **Encryption at rest**: database encryption, file storage encryption
+- **Encryption in transit**: TLS (see §4)
+- **PII handling**: which fields are PII, how they are stored, access controls
+- **Data retention**: retention periods, deletion policy, right to erasure
+- **Backup encryption**: are backups encrypted?
+- **Compliance**: GDPR, HIPAA, SOC2, PCI-DSS — which apply and how addressed
+
+If no compliance requirements exist, note that and skip the compliance subsection.
+
+##### 9. Security Headers
+
+HTTP security headers:
+
+| Header | Value | Purpose |
+|--------|-------|---------|
+| `Strict-Transport-Security` | `max-age=31536000; includeSubDomains` | Force HTTPS |
+| `X-Content-Type-Options` | `nosniff` | Prevent MIME sniffing |
+| `X-Frame-Options` | `DENY` | Prevent clickjacking |
+| `X-XSS-Protection` | `0` | Disable legacy XSS filter |
+| `Referrer-Policy` | `strict-origin-when-cross-origin` | Control referrer |
+| `Permissions-Policy` | `camera=(), microphone=()` | Restrict browser features |
+
+Identify which headers are set and which are missing. Note where they are configured.
+
+##### 10. Dependency Security
+
+Third-party dependency audit:
+- **Audit tool**: `npm audit`, `govulncheck`, `pip-audit`, `cargo audit`, Snyk, Dependabot
+- **Audit command**: how to run a vulnerability scan
+- **Update policy**: how often dependencies are updated, who reviews
+- **Known vulnerabilities**: any current advisories (from the latest audit)
+- **Lock file**: is a lock file committed (`go.sum`, `package-lock.json`, `poetry.lock`)?
+- **Supply chain**: pinned versions, integrity hashes, trusted registries
+
+##### 11. OWASP Top 10 Mapping
+
+Map each OWASP Top 10 (2021) category to the project's mitigations:
+
+| # | OWASP Category | Project Mitigation | Status |
+|---|----------------|-------------------|--------|
+| A01 | Broken Access Control | RBAC middleware, ownership checks | ✅ Mitigated |
+| A02 | Cryptographic Failures | TLS 1.3, bcrypt passwords, JWT RS256 | ✅ Mitigated |
+| A03 | Injection | Parameterized queries, input validation | ✅ Mitigated |
+| A04 | Insecure Design | Threat modeling, code review | ⚠️ Partial |
+| A05 | Security Misconfiguration | Hardened defaults, no debug in prod | ✅ Mitigated |
+| A06 | Vulnerable Components | Dependabot, weekly audit | ✅ Mitigated |
+| A07 | Auth Failures | Rate limiting, MFA, strong passwords | ⚠️ Partial |
+| A08 | Data Integrity Failures | Signed deployments, CI/CD gates | ✅ Mitigated |
+| A09 | Logging & Monitoring | Structured logging, alerting | ⚠️ Partial |
+| A10 | SSRF | No user-controlled URLs / URL allowlist | ✅ Mitigated |
+
+Statuses: ✅ Mitigated, ⚠️ Partial, ❌ Not Addressed, N/A
+
+For each "Partial" or "Not Addressed": note what's missing and recommend next steps.
+
+##### 12. Incident Response (if applicable)
+
+If the project has incident response procedures or documentation:
+- **Detection**: how security incidents are detected (alerts, logs, user reports)
+- **Containment**: immediate steps (revoke tokens, block IPs, disable accounts)
+- **Communication**: who to notify, disclosure timeline
+- **Recovery**: restore from backup, re-deploy, rotate secrets
+- **Post-mortem**: how lessons learned are documented
+
+If no incident response exists, note this as a gap and suggest creating one.
+
+## General Rules
+
+- Language: English
+- This is a **security audit** template — focus on findings, gaps, and recommendations
+- Cross-reference `AUTH.md` for detailed auth flows, `DEPLOYMENT.md` for infra security — do not duplicate
+- All code references must point to actual project files
+- Never include real secrets, tokens, keys, or internal URLs — use placeholders
+- Flag security anti-patterns explicitly (e.g., "⚠️ JWT secret is hardcoded in config file")
+- If a section is not applicable (e.g., no CORS because no browser clients), state "N/A — [reason]" and skip
+- After creating, update `.spec/README.md`: add a link under the Security section
diff --git a/.agents/skills/sdd/templates/docs/state-management.md b/.agents/skills/sdd/templates/docs/state-management.md
new file mode 100644
index 00000000..4b3be82a
--- /dev/null
+++ b/.agents/skills/sdd/templates/docs/state-management.md
@@ -0,0 +1,151 @@
+<!-- scope: **/store/*, **/stores/*, **/state/*, **/redux/*, **/bloc/*, **/providers/* -->
+# State Management Documentation Template
+
+## What This Generates
+
+- `.spec/STATE.md` — state management architecture, store structure, data flow, side effects
+
+## Instructions
+
+You are a technical documentarian. Create state management documentation for the project in the `.spec/` directory.
+Analyze: store definitions, reducers, actions, selectors, providers, BLoC classes, signals, and reactive state primitives.
+
+### Step 1: Identify State Management Approach
+
+Check for the presence of:
+- **React**: Redux (Toolkit), Zustand, MobX, Jotai, Recoil, Valtio, XState, React Context + useReducer
+- **Vue**: Pinia, Vuex
+- **Angular**: NgRx, Akita, Elf, simple services with RxJS
+- **Svelte**: Svelte stores (writable, readable, derived)
+- **Solid**: Solid signals, createStore
+- **Flutter/Dart**: BLoC, Provider, Riverpod, GetX, MobX
+- **Mobile (RN)**: Redux, Zustand, MobX-State-Tree
+
+Determine from `package.json`, `pubspec.yaml`, imports in source files.
+
+### Step 2: Create .spec/STATE.md
+
+#### Structure:
+
+##### 1. Overview
+- One sentence: which state management solution and why
+- Architecture pattern name (Flux, CQRS, reactive, signal-based)
+- ASCII diagram of the data flow:
+
+```
+User Action → Dispatch → Store/Reducer → New State → UI Re-render
+                           ↓
+                      Side Effects (API calls, persistence)
+```
+
+Adapt the diagram to the actual pattern used (BLoC: Event → Bloc → State → Widget; Signals: Signal → Effect → Derived).
+
+##### 2. Store Structure
+
+Map of all stores / slices / blocs / atoms:
+
+| Store / Slice | Location | Purpose | Persistence |
+|---------------|----------|---------|-------------|
+| `authStore` | `src/stores/auth.ts` | User session, tokens | localStorage |
+| `cartSlice` | `src/store/cart.ts` | Shopping cart items | None (memory) |
+
+For each store, note whether it is:
+- **Global** (app-wide singleton)
+- **Scoped** (per-route, per-component tree, per-feature)
+- **Local** (component-level, not shared)
+
+##### 3. State Shape
+
+For each significant store, document the state type/interface:
+
+```typescript
+// authStore state
+interface AuthState {
+  user: User | null;       // Current authenticated user
+  token: string | null;    // JWT access token
+  isLoading: boolean;      // Auth operation in progress
+  error: string | null;    // Last auth error message
+}
+```
+
+Use the project's actual language and type definitions. Include initial/default values.
+
+##### 4. Actions / Events / Mutations
+
+For each store, list the actions that modify state:
+
+| Action / Event | Payload | Effect on State | Side Effects |
+|----------------|---------|-----------------|--------------|
+| `login` | `{email, password}` | Sets `isLoading: true` | API call to `/auth/login` |
+| `loginSuccess` | `{user, token}` | Sets `user`, `token`, `isLoading: false` | Persists token |
+| `logout` | — | Clears `user`, `token` | Removes token from storage |
+
+##### 5. Selectors / Derived State / Computed
+
+| Selector / Computed | Source | Returns | Used By |
+|---------------------|--------|---------|---------|
+| `isAuthenticated` | `authStore` | `boolean` | `ProtectedRoute`, `Header` |
+| `cartTotal` | `cartStore` | `number` | `CartSummary`, `Checkout` |
+
+##### 6. Side Effects
+
+How async operations and side effects are handled:
+- **Pattern**: thunks, sagas, epics, effects, listeners, BLoC events, async actions
+- **API integration**: how API calls are dispatched and results handled
+- **Error handling**: how API errors flow back to state
+- **Optimistic updates**: are they used? Where?
+- **Cancellation**: how in-flight requests are cancelled (e.g., route change, unmount)
+
+Code example of a typical side effect from the project.
+
+##### 7. Persistence
+
+Which parts of state are persisted and how:
+
+| Store | Medium | Key | Serialization | Hydration |
+|-------|--------|-----|---------------|-----------|
+| `auth` | localStorage | `auth_token` | JSON | On app init |
+| `settings` | AsyncStorage | `user_prefs` | JSON | On app init |
+| `cart` | sessionStorage | `cart_items` | JSON | On tab restore |
+
+If no persistence is used, state it explicitly.
+
+##### 8. Subscriptions / Reactivity
+
+How components subscribe to state changes:
+- **React**: `useSelector`, `useStore`, `useSnapshot`, custom hooks
+- **Vue**: `storeToRefs`, computed properties
+- **Flutter**: `BlocBuilder`, `Consumer`, `Watch`
+- **Svelte**: `$store` auto-subscription
+
+Performance considerations:
+- Selector memoization
+- Render optimization (shallow compare, structural sharing)
+- Common pitfalls in the project
+
+##### 9. Testing State
+
+- How stores/slices/blocs are unit tested
+- How to create test state (factories, fixtures, initial state overrides)
+- How to mock stores in component tests
+- Code example of a store test from the project
+
+##### 10. Adding a New Store
+
+Step-by-step guide for adding a new store/slice/bloc:
+1. Create the state type
+2. Define actions/events
+3. Implement reducer/handler
+4. Add selectors
+5. Connect to components
+6. Add tests
+
+Reference existing stores as examples.
+
+## General Rules
+
+- Language: English
+- All state shapes, actions, and selectors must come from actual source code
+- If the project uses multiple state management solutions (e.g., Redux for global + useState for local), document all of them and explain the boundary
+- If the project has no state management beyond component-local state, do not generate this file — skip entirely
+- After creating, update `.spec/README.md`: add a link under the appropriate section
diff --git a/.agents/skills/sdd/templates/explore.md b/.agents/skills/sdd/templates/explore.md
new file mode 100644
index 00000000..97ac82d1
--- /dev/null
+++ b/.agents/skills/sdd/templates/explore.md
@@ -0,0 +1,212 @@
+# Phase 1: Exploration
+
+## Role
+
+You are a **Research Partner**. Your task: investigate the problem space, analyze the existing codebase, compare approaches, and help the user clarify what they actually need before committing to formal requirements.
+
+You do **NOT** write requirements documents.
+You do **NOT** design solutions or write code.
+You **explore**: ask questions, read code, compare options, surface constraints and risks.
+
+---
+
+Read `./templates/_preamble.md` for Pipeline Integration and Project Context instructions.
+- **Phase rule key:** `rules.explore`
+- **Input artifacts:** none (this is the first phase)
+- **Output:** `.spec/features/<feature-name>/explore.md`
+
+---
+
+### Fast-track mode
+
+When the user describes a bug with a known reproduction or a small scoped change:
+
+- **Intent:** 1 paragraph (not 3–5). State the problem and the expected fix direction.
+- **Investigation (Root Cause):** confirm the bug exists AND identify root cause. Follow these steps:
+  1. **Read errors** — read the full stack trace / error log, not just the last line. Note the originating call site.
+  2. **Reproduce** — run the failing test or command yourself. Capture actual output.
+  3. **Check recent changes** — `git log --oneline -10 <affected-files>` (if git is available). Look for the commit that introduced the regression.
+  4. **Trace data flow** — follow the data path from input → processing → failure point. Cite each file and line in the chain.
+  
+  If root cause remains unclear after these steps, mark it as `[ROOT CAUSE: unknown]` and include it in Open Questions. Do NOT skip to a fix direction based on symptoms alone.
+- **Options:** single recommended approach. Skip multi-option comparison unless two genuinely different strategies exist.
+- **Scope boundaries:** list only must-have (v1). Omit deferred/spike unless the user raised them.
+- **Assumptions:** 2–3 critical assumptions max.
+- **Open questions:** omit if none. Do not fabricate questions.
+- **Build Tooling:** still required (later phases depend on it).
+
+Target artifact size: **≤ 1 page**.
+
+IMPORTANT: For bug fixes, DO NOT propose a fix direction in "Recommended Direction" until root cause is identified. A symptom-level recommendation ("the error is on line 42, let's fix it") without understanding WHY it fails leads to patches that mask the real problem.
+
+---
+
+## Language
+
+Write the entire exploration document in the **user's language** (detected from their first message). This includes:
+- Section headers (e.g., translate "Intent", "Investigation", "Options Considered", etc.)
+- All prose: problem descriptions, findings, trade-off analysis, recommendations
+- Scope boundary labels (translate "Must-have (v1)", "Deferred (v2)", "Needs spike")
+- Assumption tags: keep the marker format `[ASSUMPTION: ...]` but write the assumption text in the user's language
+
+Keep in English (do not translate):
+- Code identifiers, file paths, import paths
+- Shell commands and their output
+- Build Tooling commands (the command values — labels like "Orchestrator", "Test", "Build" may be translated)
+
+---
+
+## What To Do
+
+### Step 1: Understand Intent
+
+Ask the user:
+- What problem are they trying to solve?
+- What triggered this — a bug report, user feedback, tech debt, new feature request?
+- Is this new functionality (greenfield) or modifying existing behavior (brownfield)?
+- Is there prior art or inspiration (other tools, competitors, RFCs)?
+
+### Step 2: Investigate the Codebase
+
+Without waiting for all answers:
+
+**Project documentation shortcut:** If the project documentation directory exists (default: `.spec/`, configurable via `docs_dir` in `config.yaml`), read `README.md` first for the documentation map, then read relevant docs (`ARCHITECTURE.md`, `PACKAGES.md`, `DOMAIN.md`) before scanning source code. This provides pre-verified context and significantly reduces file-read budget consumption. If docs exist, you may need fewer than 20 raw file reads.
+
+> **Directory reminder:** You READ project documentation from `<docs_dir>/` (default: `.spec/`). You WRITE phase artifacts to `.spec/features/<feature>/`. These are separate directories — do not mix them.
+
+- Read relevant source code, configs, and tests
+- Identify existing patterns, conventions, and constraints
+
+**Budget:** Limit initial investigation to ~20 file reads. If the codebase is large and you haven't found enough context, summarize what you've learned so far and ask the user which areas to investigate deeper. This prevents context window exhaustion.
+- Find related functionality that might be affected
+- Note technical debt or risks in the affected area
+
+**If modifying existing code (brownfield):**
+- What behavior must NOT change? Identify preservation constraints.
+- What tests cover current behavior? These must keep passing.
+- What's the migration path if data structures change?
+
+**If building new (greenfield):**
+- What similar patterns already exist in the codebase? Follow them.
+- Are there shared abstractions (interfaces, base classes) to reuse?
+
+**Testing patterns (brownfield and greenfield):**
+- Identify the project's testing framework and assertion library.
+- Where do test files live? What naming convention is used?
+- Note representative test files for later phases to follow as style references.
+
+**Build tooling discovery (brownfield and greenfield):**
+- Identify the project's command orchestrator: check for `Makefile`, `Taskfile.yml` (`taskfile.yml`), `package.json` scripts section, `Justfile`, or similar.
+- Extract key commands for: **test**, **build**, **lint**, **generate** (code generation), **start**, **stop**.
+- If a `Makefile` or `Taskfile` exists, read it and list the relevant targets.
+- If `package.json` exists, read the `scripts` section.
+- Note code generation commands (proto, OpenAPI, mocks, ORM generators) — these must run before tests.
+- Document the orchestrator and commands in the exploration output (see Build Tooling section in Output Format).
+
+### Step 3: Compare Approaches
+
+If multiple solutions exist:
+- List 2–4 realistic options
+- For each: brief description, pros, cons, estimated complexity
+- Highlight trade-offs explicitly (e.g., "simpler but less extensible")
+
+### Step 4: Surface Constraints
+
+Proactively identify:
+- Breaking changes or backward compatibility concerns
+- Performance implications
+- Security considerations
+- Dependencies that would be added or affected
+- Edge cases that aren't obvious
+
+### Step 5: Recommend Direction
+
+Based on investigation, suggest:
+- Which approach seems best and why
+- What questions remain unanswered
+- **What assumptions your recommendation depends on** — list them explicitly and ask the user to confirm or correct before proceeding
+
+**Scope Boundaries** — explicitly categorize:
+- **Must-have (v1):** essential for the feature to be useful
+- **Deferred (v2):** valuable but not required for initial delivery
+- **Needs spike:** risky or unknown, requires investigation before committing
+
+---
+
+## Output Format
+
+Generate an exploration document with this structure:
+
+```markdown
+# Exploration: <Feature Name>
+
+## Intent
+What problem we're solving and why.
+
+## Investigation
+What was examined in the codebase. Key findings about existing code, patterns, constraints.
+
+## Root Cause
+<!-- Bug fixes only. Omit for pure features. -->
+Identified root cause of the defect: what is broken and why. Cite the originating file, line, and commit (if found).
+If unknown: `[ROOT CAUSE: unknown]` — explain what was investigated and why cause remains unclear.
+
+## Build Tooling
+- **Orchestrator:** make / task / npm scripts / custom scripts / none
+- **Test:** `<command>`
+- **Build:** `<command>`
+- **Lint:** `<command>`
+- **Generate:** `<command>` (if applicable — proto, mocks, ORM, etc.)
+- **Source:** Makefile / Taskfile.yml / package.json / CI config / ...
+
+## Options Considered
+### Option A: ...
+- Description, pros, cons, complexity.
+### Option B: ...
+- Description, pros, cons, complexity.
+
+## Constraints & Risks
+- Breaking changes, security, performance, dependencies.
+
+## Recommended Direction
+Which option and why.
+
+## Scope Boundaries
+- **Must-have (v1):** ...
+- **Deferred (v2):** ...
+- **Needs spike:** ...
+
+## Assumptions & Open Questions
+Explicit assumptions behind the recommendation. Open questions that need clarification before requirements.
+```
+
+---
+
+## Quality Checklist
+
+Before presenting to the user:
+- [ ] Codebase was actually read (not just guessed about)
+- [ ] At least 2 options were considered (unless truly only one path exists)
+- [ ] Trade-offs are explicit, not hidden
+- [ ] Scope boundaries are suggested
+- [ ] Assumptions behind the recommendation are stated explicitly
+- [ ] Open questions are listed (if any)
+- [ ] For bug fixes: root cause is identified and cited, or explicitly marked `[ROOT CAUSE: unknown]`
+- [ ] Build Tooling section is present with orchestrator and key commands (test, build, lint; generate if applicable)
+
+## Done when
+
+Do NOT suggest approval until **every** condition is true:
+
+1. Codebase was actually read — file paths and findings are cited, not guessed.
+2. At least 2 options were compared (or a single-path justification is documented).
+3. Scope boundaries are explicitly categorized: **Must-have (v1)**, **Deferred (v2)**, **Needs spike**.
+4. Every assumption behind the recommendation is tagged with `[ASSUMPTION: ...]`.
+5. Open questions section is present (even if the answer is "None identified").
+6. For bug fixes: root cause is documented — either identified with file/line citation, or explicitly marked `[ROOT CAUSE: unknown]` with investigation summary.
+7. Build Tooling section is present — orchestrator identified, key commands (test, build, lint) documented.
+8. Artifact is registered via `pipeline.sh artifact <path>`.
+
+## Antipatterns
+
+Antipatterns for this phase: read `./templates/reference/antipatterns.md` § Explore.
diff --git a/.agents/skills/sdd/templates/implementation.md b/.agents/skills/sdd/templates/implementation.md
new file mode 100644
index 00000000..078e19a9
--- /dev/null
+++ b/.agents/skills/sdd/templates/implementation.md
@@ -0,0 +1,280 @@
+# Phase 5: Implementation
+
+> **For AI agents (Cursor, Claude Code, Windsurf, etc.):**
+> Read this file in full before starting. Follow every instruction exactly.
+> Your role is to execute the approved task plan — write tests, write code, run, iterate.
+
+---
+
+## Role
+
+You are a **TDD Implementation Executor**. Your task: take the approved task plan and execute it — write real tests, write real production code, run the suite, and iterate until everything is green.
+
+You do **NOT** create new tasks or modify the plan. You **execute** the tasks exactly as specified.
+You do **NOT** skip tasks. You do **NOT** reorder tasks (unless a dependency requires it and you document why).
+You **write code** and **run tests** for every task.
+
+---
+
+Read `./templates/_preamble.md` for Pipeline Integration and Project Context instructions.
+- **Phase rule key:** `rules.implementation`
+- **Input artifacts:** read `history[0..3].artifact` (exploration, requirements, design, task plan). Read the **task plan** (`history[3]`) carefully — it defines the exact sequence of tasks to execute.
+- **Output:** `.spec/features/<feature-name>/implementation.md`
+
+---
+
+### Fast-track mode
+
+When the task plan contains 4–5 tasks for a small bug fix:
+
+- **Summary:** 1 paragraph (bug description + fix approach).
+- **Task Execution:** 1–2 lines per task — status and brief note only. Skip detailed iteration logs unless a task required retry.
+- **Final Verification:** still required — actual stdout from test, build, lint commands. No shortcuts here.
+- **Files Changed:** list of modified/created files (typically 1–3).
+
+Target artifact size: **≤ 0.5 page** (excluding stdout).
+
+---
+
+## Language
+
+Write the implementation report in the **user's language** (detected from their first message). This includes:
+- Section headers, task status descriptions, notes on issues found
+- Summary of what was done
+
+Keep in English (do not translate):
+- Code identifiers, file paths, shell commands
+- Test names, assertion messages
+- Task IDs: `T-N`
+- Instruction keywords: `CRITICAL`, `IMPORTANT`, `NOTE`, `DO NOT`, `GOAL`
+
+---
+
+## What To Do
+
+### Step 1: Read the Task Plan
+
+Read the approved task plan artifact. Extract:
+- **Commands** block — the exact commands for test, build, lint, generate
+- **Test Style Source** — the test style reference files
+- **Task list** — the ordered sequence of tasks (`T-1`, `T-2`, etc.)
+
+**Resume check:** Run `pipeline.sh status`. If `Last task` is shown (e.g., `T-4`), skip all tasks up to and including that task — they were completed in a previous session. Resume from the next task.
+
+### Step 1.5: Evaluate Execution Strategy
+
+After reading the task plan, decide whether to use **sequential mode** (default) or **subagent mode**.
+
+**Consider subagent mode when ALL three conditions are true:**
+1. The plan contains **6+ top-level tasks**
+2. At least one task has `Complexity: complex`
+3. Your platform supports **dispatching isolated subagents** (e.g., Claude Code `Task` tool, Cursor Composer, or equivalent)
+
+If any condition is not met — use sequential mode (Step 2 as-is). Sequential is always safe.
+
+**Subagent mode architecture:**
+
+You become a **controller**. For each task `T-N` in order:
+1. **Build a context package** — extract from the task plan:
+   - The single task `T-N` with all subtasks, `_Requirements_`, `_Preservation_`, `_Complexity_`
+   - Commands block and Test Style Source (copied verbatim)
+   - File paths referenced in subtasks
+   - One-line summary of each previously completed task (not full reports)
+2. **Dispatch a subagent** with this context package as input
+3. **Receive the subagent's report** — changed files, test stdout, any issues
+4. **Verify** — run the full test suite yourself. If tests fail, fix or escalate (same rules as Step 4)
+5. **Mark done** — `pipeline.sh task T-N`, update the implementation report
+
+**Subagent rules:**
+- One subagent per task — never bundle multiple `T-N` into one dispatch
+- Subagent does NOT interact with `pipeline.sh` — only the controller does
+- Task order remains strict (RED → GREEN → CODE → VERIFY → GATE) — parallelize only if tasks have zero shared files and no `_Preservation_` overlap
+- GATE task is always executed by the controller, never delegated
+- If a subagent fails after 3 attempts, apply the same rollback rules as Step 4
+
+NOTE: If you are unsure whether your platform supports subagents, use sequential mode. The output is identical — only the execution strategy differs.
+
+### Step 2: Execute Each Task
+
+For each task in order:
+
+#### 2.1 Exploration Tests (RED)
+
+If the task is an exploration test:
+1. Write the test exactly as described in the task
+2. Run the test command — confirm it **fails** (RED)
+3. If it passes instead of failing, the problem may already be fixed — note this and proceed
+4. Mark the task as done in the artifact (see Step 3)
+
+#### 2.2 Preservation Tests (GREEN)
+
+If the task is a preservation test:
+1. Write the test exactly as described in the task
+2. Run the test command — confirm it **passes** (GREEN)
+3. If it fails, there's a pre-existing bug — note this and ask the user before proceeding
+4. Mark the task as done in the artifact
+
+#### 2.3 Implementation Tasks (Code Changes)
+
+If the task is an implementation task:
+1. Read the task's `GOAL`, instructions, and `_Preservation_` list
+2. Make the minimal atomic change described
+3. Run the full test suite — confirm:
+   - The exploration test now **passes** (GREEN)
+   - All preservation tests still **pass** (GREEN)
+   - No other tests broke
+4. If tests fail, iterate:
+   - Diagnose the failure
+   - Adjust the implementation (not the tests, unless the test is wrong)
+   - Re-run until green
+5. Mark the task as done in the artifact
+
+#### 2.4 Re-test / Checkpoint Tasks
+
+If the task is a re-test or checkpoint:
+1. Run the specified commands
+2. Verify the expected outcome
+3. Mark the task as done in the artifact
+
+### Step 3: Mark Tasks Done
+
+After completing each task, update the implementation report artifact by marking the task as completed:
+
+```markdown
+- [x] **T-1** Exploration test: verify current behavior — RED confirmed
+- [x] **T-2** Preservation test: lock auth flow — GREEN confirmed
+- [x] **T-3** Implement token refresh — GREEN (all tests pass)
+- [ ] **T-4** Re-test full suite — (next)
+```
+
+**Rules for marking:**
+- Use `[x]` for completed tasks, `[ ]` for pending
+- Add a brief status note after the task title (e.g., "RED confirmed", "GREEN (3 tests pass)", "needed adjustment — see notes")
+- If a task required iteration (fix → re-run), note what was adjusted
+- After writing `[x]`, register in this order:
+  1. `sh ./scripts/pipeline.sh artifact` — saves the updated report
+  2. `sh ./scripts/pipeline.sh task T-N` — records last completed task for resume
+
+### Step 4: Handle Failures
+
+If a task cannot be completed:
+- **Test won't compile** — check imports, dependencies, code generation. Run `generate` command if available.
+- **Exploration test passes when it should fail** — the behavior may already be correct. Note it and proceed.
+- **Preservation test fails** — pre-existing bug. Note it and ask the user: "Preservation test T-N fails on existing code. This is a pre-existing issue. Proceed or fix first?"
+- **Implementation breaks other tests** — iterate on the implementation. Do NOT modify preservation tests.
+- **Blocked by dependency** — note the blocker, skip the task, continue with independent tasks. Return to blocked task when unblocked.
+
+#### Task rollback on repeated failure
+
+If an implementation task fails after **3 attempts** (3 iterations of adjust → re-run without reaching green):
+
+1. **Stop** — do not continue iterating.
+2. **Document** the situation in the implementation report:
+   - Task ID and title
+   - What was attempted (3 approaches tried)
+   - Which files were modified during attempts
+   - Current state: which tests pass, which fail
+3. **Present the user** with options:
+   - **(a) Revert this task's files** — `git checkout HEAD -- <file1> <file2> ...` to undo changes from the failed task only. Then continue with the next independent task.
+   - **(b) Debug together** — the user helps investigate the issue. Provide the failing test output and relevant code context.
+   - **(c) Full rollback** — `git checkout <review_base_commit> -- .` to restore the entire working tree to the state before implementation started. This undoes ALL tasks, not just the failed one.
+4. **Wait** for the user's decision before proceeding.
+
+CRITICAL: Do NOT silently leave the project in a broken state. If tests are failing after implementation attempts, the user must be informed and given control.
+
+### Step 5: Final Verification
+
+After all tasks are complete:
+1. Run the **full test suite** — all tests must pass
+2. Run the **build** command — must succeed
+3. Run the **lint** command — must pass (or only pre-existing warnings)
+4. Run **generate** command if applicable — ensure generated code is up to date
+5. Update the implementation report with final results
+
+---
+
+## Output Format
+
+Generate an implementation report with this structure:
+
+```markdown
+# Implementation Report: <Feature Name>
+
+## Summary
+Brief description of what was implemented. Number of tasks completed.
+
+## Commands Used
+- **Test:** `<command>`
+- **Build:** `<command>`
+- **Lint:** `<command>`
+- **Generate:** `<command>` (if applicable)
+
+## Task Execution
+
+- [x] **T-1** <task title> — <status>
+- [x] **T-2** <task title> — <status>
+- [x] **T-3** <task title> — <status>
+  - Note: <any adjustments or iteration notes>
+- [x] **T-4** <task title> — <status>
+...
+
+## Final Verification
+
+Include the actual (possibly truncated) stdout of each command below. Do NOT replace real output with status assertions like "All pass".
+
+```
+- **Tests:**
+\`\`\`
+<paste last 20 lines of test command output>
+\`\`\`
+- **Build:**
+\`\`\`
+<paste last 10 lines of build command output>
+\`\`\`
+- **Lint:**
+\`\`\`
+<paste last 10 lines of lint command output>
+\`\`\`
+- **Generate:** (if applicable)
+\`\`\`
+<paste last 10 lines of generate command output>
+\`\`\`
+```
+
+## Files Changed
+List of files created or modified during implementation.
+
+## Notes
+Any observations, pre-existing issues found, or deviations from the plan.
+```
+
+---
+
+## Quality Checklist
+
+Before presenting to the user:
+- [ ] Every task from the plan is marked (completed or explicitly skipped with reason)
+- [ ] All exploration tests confirmed RED before implementation
+- [ ] All preservation tests confirmed GREEN before and after implementation
+- [ ] Full test suite passes after all tasks
+- [ ] Build succeeds
+- [ ] Lint passes (or only pre-existing warnings)
+- [ ] Implementation report artifact is registered via `pipeline.sh artifact`
+- [ ] No tasks were silently skipped
+- [ ] Final Verification section contains actual command output (stdout), not just status assertions
+
+## Done when
+
+Do NOT suggest approval until **every** condition is true:
+
+1. Every task from the approved plan is executed and marked in the artifact.
+2. Full test suite passes — zero new failures.
+3. Build command succeeds.
+4. Lint command passes (pre-existing warnings are acceptable, new ones are not).
+5. Implementation report lists all files changed.
+6. Artifact is registered via `pipeline.sh artifact`.
+7. Final Verification section contains real command output (stdout) for test, build, and lint.
+
+## Antipatterns
+
+Antipatterns for this phase: read `./templates/reference/antipatterns.md` § Implementation.
diff --git a/.agents/skills/sdd/templates/reference/antipatterns.md b/.agents/skills/sdd/templates/reference/antipatterns.md
new file mode 100644
index 00000000..09f89cd6
--- /dev/null
+++ b/.agents/skills/sdd/templates/reference/antipatterns.md
@@ -0,0 +1,103 @@
+# Antipatterns Reference
+
+Antipattern tables for each pipeline phase. Referenced from the corresponding phase template.
+
+---
+
+## Explore
+
+| Antipattern | WRONG ❌ | RIGHT ✓ | Why |
+|---|---|---|---|
+| Premature requirements | "WHEN token expires, system SHALL refresh" | "One option is to auto-refresh tokens" | WHEN/SHALL belongs in requirements phase |
+| Solution attachment | "We should use Redis" | "Option A: Redis, Option B: in-memory — trade-offs:..." | Must show alternatives before committing |
+| Ignoring existing code | "I suggest adding a new auth module" | "Existing `src/auth` uses X pattern; we can extend it" | Always read codebase first |
+| Scope creep | "We should also add rate limiting and logging" | "Rate limiting could be v2; focus on core auth first" | Help user narrow, not expand |
+| Analysis paralysis | 5 options with no recommendation | "Option B is best because...; A is fallback if..." | Recommend clearly when path is evident |
+| Symptom-level fix | "Bug confirmed at line 42, let's fix it" | "Root cause: `validate()` skips nil check added in commit abc123; line 42 fails because input is nil" | Without root cause, fix may mask the real problem |
+
+---
+
+## Requirements
+
+| Antipattern | WRONG ❌ | RIGHT ✓ | Why |
+|---|---|---|---|
+| Architectural solution | "Use a Redis cache for token storage" | "WHEN cache miss occurs, SHALL return fresh data within 100ms" | Prescribes HOW, not WHAT |
+| Code or pseudocode | `if token.expired { refresh() }` | "WHEN token is expired, SHALL attempt refresh" | Implementation detail |
+| Diagram | Mermaid sequence diagram | Prose description of the flow | Belongs in design phase |
+| Vague wording | "The system should handle errors gracefully" | "WHEN refresh fails, SHALL return 401 with error code" | Not verifiable |
+| Combined SHALLs | "…SHALL refresh the token and log the event" | Two REQs: one for refresh, one for logging | Must be one SHALL per REQ |
+| Unconfirmed requirement | Agent adds REQ-3.1 user never mentioned | Only requirements confirmed by user in interview | Hallucinated scope |
+| Technology lock-in | "Use JWT with RS256 signing" | "WHEN issuing tokens, SHALL use cryptographic signing" | Constrains design without user mandate |
+
+---
+
+## Design
+
+| Antipattern | WRONG ❌ | RIGHT ✓ | Why |
+|---|---|---|---|
+| Function bodies | `func refresh() { cache.Get(key)... }` | `func refresh(token Token) (Token, error)` | Interfaces show signatures only |
+| Task lists | "Step 1: create file, Step 2: add tests" | Architecture + interfaces + properties | This is design, not work breakdown |
+| Skipping unchanged files | "Files NOT Requiring Changes" table is empty | Explicitly list files in scope that won't change | Omission suggests scope not fully considered |
+| Existential properties | "There exists a case where refresh works" | "For all expired tokens, refresh returns valid token" | Properties must use universal quantifier |
+| Unlinked properties | "Property 3: tokens are secure" | "Property 3: ... Validates: REQ-1.2" | Every property must trace to a requirement |
+| Vague modification scope | `[MODIFIED]` — "various authentication changes" | `[MODIFIED]` — "adds refreshToken(), modifies authenticate() return type" | Must state what exactly changes |
+| Scope creep | Designing rate limiting not in requirements | Only design what requirements specify | Stay within approved requirements |
+| Silent assumption | Choosing a caching strategy without stating why | `[ASSUMPTION: write-through preferred]` — ask user or mark explicitly | Unstated beliefs cause surprises during implementation |
+| Ignoring existing test patterns | Agent invents new test structure (e.g., flat assertions) | Agent follows existing pattern: `auth/token_test.go:TestRefresh` uses table-driven subtests | Tests must be consistent with the project's existing style |
+
+---
+
+## Task Plan
+
+| Antipattern | Why it's harmful |
+|---|---|
+| Writing code in the plan | The plan is instructions for an agent, not the implementation itself |
+| Designing architecture in the plan | Architecture is fixed in the approved design document — do not revise it here |
+| Skipping exploration tests for bug fixes | Without a failing test, you cannot prove the bug existed or was fixed |
+| Tasks without `*_Requirements:_*` | Untraced tasks cannot be reviewed or rejected with precision |
+| Multi-file subtasks | Atomic subtasks are the unit of change — mixing files makes review and fixing harder |
+| Forgetting re-test tasks | A fix without a passing re-test is unverified |
+| Placing the checkpoint before all tasks complete | The checkpoint is a gate, not a milestone |
+| Vague task descriptions | "Update the code" is not a task. "Add null check to `parseToken` in auth module" is a task |
+| Inventing test style | When adjacent tests use table-driven subtests, do not write flat assertions. Follow existing project test patterns discovered in Test Infrastructure Discovery |
+
+---
+
+## Implementation
+
+| Antipattern | WRONG ❌ | RIGHT ✓ | Why |
+|---|---|---|---|
+| Skipping exploration test | Write code first, then test | Write test first (RED), then code (GREEN) | TDD requires RED→GREEN cycle |
+| Modifying preservation tests | Change test to match new code | Change code to satisfy both old and new tests | Preservation tests lock correct behavior |
+| Bulk implementation | Implement all tasks at once, test at the end | Implement one task, test, mark done, repeat | Atomic execution finds issues early |
+| Silent skip | Skip a failing task without noting it | Note the issue, ask user, document decision | Transparency over speed |
+| Plan modification | "This task doesn't make sense, I'll do it differently" | Execute as planned; note concerns for review phase | The plan was approved — execute it faithfully |
+| Silently leaving broken state | Continue to next task while tests are failing | Stop after 3 failed attempts, document state, ask user to decide | User must stay in control when implementation is stuck |
+| Unsupervised subagent | Dispatch subagent, accept its output without running tests | Dispatch subagent, then run full test suite yourself before marking task done | Subagent output must be verified — trust but verify |
+
+---
+
+## Review
+
+| Antipattern | Why it's harmful |
+|---|---|
+| Skipping the implementation report | The implementation report (history[4]) shows which tasks were completed — always verify against it |
+| Reviewing the entire codebase | Scope is limited to files changed since `review_base_commit` |
+| Approving with `major` findings open | Major findings must be resolved before `PASS` verdict |
+| Changing the design in the review | Design is locked in the approved design document — open a new pipeline for design changes |
+| Skipping the traceability matrix | Without it, requirements coverage cannot be verified |
+| Inventing requirements during review | Review checks against approved requirements only — new requirements need a new pipeline |
+| Flagging style preferences as `major` | Style preferences are `nit` at most; reserve `major` for real issues |
+| Auto-fixing without user direction | Review is for presenting findings to the user, not for autonomous code changes. Wait for explicit user instructions before modifying code |
+
+---
+
+## Documentation (Standalone Workflow)
+
+| Antipattern | WRONG ❌ | RIGHT ✓ | Why |
+|---|---|---|---|
+| All templates in one window | Generate `core.md` + `development.md` + `auth.md` + ... back-to-back in a single chat | Use `pipeline.sh docs-init` + queue; one template per iteration (sequential) or up to 3 parallel subagents | Single-chat batch generation exhausts context; agent starts hallucinating, dropping rules, and truncating output |
+| Sequential when subagent available | Loop `docs-next` / `docs-done` in one chat when your toolset has Task/Composer/dispatch tool | Use SUBAGENT mode — dispatch up to 3 templates in parallel; controller verifies metadata after each | Subagent dispatch isolates per-template context, prevents controller bloat, and parallelizes independent work |
+| Bundled subagent dispatch | "Subagent, generate `core.md`, `development.md`, and `auth.md`" | One subagent = one template; dispatch 3 separate subagents in parallel | Bundling defeats isolation; subagent context fills up the same way single-chat batch does |
+| Skipping metadata verification | Call `docs-done <template>` immediately after subagent reports success | After subagent finishes, controller verifies file exists, line 1 matches `<!-- generated: YYYY-MM-DD, template: <name>.md -->`, and file is non-trivial (≥ 50 lines) — only then `docs-done` | `docs-check` silently skips files with malformed metadata; missed verification = stale detection broken forever |
+| Running `init <feature>` for docs request | User says "обнови документацию" → agent runs `pipeline.sh init update-docs` | Run `pipeline.sh docs-init --update` (or `--all` for bootstrap) — the standalone workflow is independent from feature pipelines | Documentation generation does not need 6 phases, approval gates, or `.spec/features/<feature>/` — it is a separate state machine |
diff --git a/.agents/skills/sdd/templates/reference/correctness-properties-examples.md b/.agents/skills/sdd/templates/reference/correctness-properties-examples.md
new file mode 100644
index 00000000..421df842
--- /dev/null
+++ b/.agents/skills/sdd/templates/reference/correctness-properties-examples.md
@@ -0,0 +1,120 @@
+# Correctness Properties — Worked Examples
+
+Worked examples for each Correctness Property category. Referenced from `design.md` §2.6.
+
+Each example shows (1) a requirement, (2) the §2.6 property definition, (3) the §2.8 property-based test table entry, and (4) what the generator does.
+
+---
+
+## Equivalence
+
+Suppose REQ-1.1 says: *WHEN the system receives a valid token, it SHALL return the corresponding user profile.*
+
+**§2.6 definition:**
+
+```
+Property 1: Token-to-profile resolution
+Category: Equivalence
+Statement: For all valid tokens T issued for user U, resolveProfile(T) = profile(U)
+Validates: Requirements 1.1
+```
+
+**§2.8 property-based test table entry:**
+
+| Test | Property | Generator description | Tags |
+|------|----------|-----------------------|------|
+| `prop_token_resolves_to_owner_profile` | Property 1 | Generate random valid User, issue a token for that user, resolve profile via token | `Property/1` |
+
+The generator creates a random user, issues a token, and asserts that resolving the token returns the same user's profile. This verifies the equivalence property across many random inputs.
+
+---
+
+## Absence
+
+Suppose REQ-2.1 says: *WHEN processing a payment, the system SHALL never charge the user twice for the same order.*
+
+**§2.6 definition:**
+
+```
+Property 2: No duplicate charges
+Category: Absence
+Statement: For all orders O processed concurrently, chargeCount(O) = 1
+Validates: Requirements 2.1
+```
+
+**§2.8 property-based test table entry:**
+
+| Test | Property | Generator description | Tags |
+|------|----------|-----------------------|------|
+| `prop_no_duplicate_charges` | Property 2 | Generate random Order, simulate N concurrent payment attempts for that order, count successful charges | `Property/2` |
+
+The generator creates a random order, fires multiple concurrent payment requests, and asserts the total charge count is exactly 1. This verifies the absence of duplicate charges under concurrency.
+
+---
+
+## Round-trip
+
+Suppose REQ-3.1 says: *WHEN the system serializes a configuration, it SHALL be able to deserialize it back to an identical value.*
+
+**§2.6 definition:**
+
+```
+Property 3: Config serialization round-trip
+Category: Round-trip
+Statement: For all valid configurations C, deserialize(serialize(C)) = C
+Validates: Requirements 3.1
+```
+
+**§2.8 property-based test table entry:**
+
+| Test | Property | Generator description | Tags |
+|------|----------|-----------------------|------|
+| `prop_config_roundtrip` | Property 3 | Generate random valid Config with varied field types, serialize to storage format, deserialize back | `Property/3` |
+
+The generator creates a random valid configuration, serializes it, deserializes the result, and asserts structural equality with the original. This verifies no data loss or mutation during the round-trip.
+
+---
+
+## Propagation
+
+Suppose REQ-4.1 says: *WHEN a user changes their email, the system SHALL update the email in all notification subscriptions.*
+
+**§2.6 definition:**
+
+```
+Property 4: Email propagation to subscriptions
+Category: Propagation
+Statement: For all users U and new emails E, after updateEmail(U, E), every subscription of U has email = E
+Validates: Requirements 4.1
+```
+
+**§2.8 property-based test table entry:**
+
+| Test | Property | Generator description | Tags |
+|------|----------|-----------------------|------|
+| `prop_email_propagates_to_subscriptions` | Property 4 | Generate random User with 1–10 subscriptions, update email to a new random value, inspect all subscriptions | `Property/4` |
+
+The generator creates a user with multiple subscriptions, changes the user's email, and asserts every subscription reflects the new address. This verifies the change propagates to all dependent records.
+
+---
+
+## Exclusion
+
+Suppose REQ-5.1 says: *WHEN an account is suspended, the system SHALL reject all login attempts.*
+
+**§2.6 definition:**
+
+```
+Property 5: Suspended accounts cannot be active
+Category: Exclusion
+Statement: For all accounts A, suspended(A) and activeSession(A) are never both true
+Validates: Requirements 5.1
+```
+
+**§2.8 property-based test table entry:**
+
+| Test | Property | Generator description | Tags |
+|------|----------|-----------------------|------|
+| `prop_suspended_blocks_login` | Property 5 | Generate random Account, suspend it, attempt login, inspect account state and session | `Property/5` |
+
+The generator creates a random account, suspends it, attempts a login, and asserts that login fails and no active session exists. This verifies the two states are mutually exclusive.
diff --git a/.agents/skills/sdd/templates/reference/review-reference.md b/.agents/skills/sdd/templates/reference/review-reference.md
new file mode 100644
index 00000000..45b90f1c
--- /dev/null
+++ b/.agents/skills/sdd/templates/reference/review-reference.md
@@ -0,0 +1,14 @@
+# Review Phase — Extended Reference
+
+Severity definitions for the Review phase. Referenced from `review.md`.
+
+---
+
+## Severity Definitions
+
+| Severity | Meaning |
+|----------|---------|
+| `critical` | Must fix before merge — security hole, data loss risk, core requirement unmet |
+| `major` | Must fix before merge — missing test, design deviation, significant quality issue |
+| `minor` | Should fix — naming, minor style issue, missing edge case test |
+| `nit` | Optional — cosmetic, preference-based suggestion |
diff --git a/.agents/skills/sdd/templates/reference/task-types.md b/.agents/skills/sdd/templates/reference/task-types.md
new file mode 100644
index 00000000..b5edba74
--- /dev/null
+++ b/.agents/skills/sdd/templates/reference/task-types.md
@@ -0,0 +1,123 @@
+# Task Type Templates
+
+Templates for each task type in the TDD implementation plan. Referenced from `task-plan.md`.
+
+---
+
+## RED: Exploration Test (for bug fixes)
+
+> GOAL: Demonstrate the defect exists before any fix is applied.
+
+```
+### Task: Write exploration test for <defect description>
+
+*_Requirements: X.Y_*
+*_Bug_Condition: <condition that triggers the bug>_*
+*_Expected_Behavior: <what should happen instead>_*
+
+CRITICAL: This test MUST FAIL when run against the unmodified codebase.
+IMPORTANT: Do not fix anything yet. The test exists only to confirm the bug is reproducible.
+IMPORTANT: Follow the test style identified in Test Infrastructure Discovery. Match naming, structure, assertion patterns, and helpers from the reference tests.
+DO NOT: Write more than one test in this task. One defect = one exploration test.
+
+Instructions:
+1. Using the testing framework, write a test that directly exercises the defective path.
+2. Run: `<test command>`
+3. Confirm the test fails with the expected failure message.
+4. Commit the failing test as evidence of the defect.
+```
+
+---
+
+## GREEN: Preservation Test
+
+> GOAL: Lock correct behavior in areas adjacent to the change so it cannot be accidentally broken.
+
+NOTE: For **pure new features** with no existing code in the affected area, GREEN tasks test that existing system behavior (e.g., other endpoints, unrelated modules) is NOT broken by the introduction of new code. If no existing behavior is affected, this step may produce zero tasks — document this explicitly in the plan with a note: "No preservation tests needed — feature is fully additive with no adjacent behavior to protect."
+
+```
+### Task: Write preservation tests for <component or behavior>
+
+*_Requirements: X.Y_*
+
+IMPORTANT: These tests must pass BEFORE any implementation changes are made.
+IMPORTANT: Follow the test style identified in Test Infrastructure Discovery. Match naming, structure, assertion patterns, and helpers from the reference tests.
+NOTE: Preservation tests cover behavior where the bug does NOT manifest — they define the "safe zone" around your change.
+DO NOT: Modify production code during this task.
+
+Instructions:
+1. Identify all behaviors in the affected component that must remain unchanged.
+2. For each behavior, write a test using the testing framework.
+3. Run: `<test command>`
+4. All preservation tests must pass (GREEN). If any fail, stop and investigate.
+5. Commit the preservation tests before touching production code.
+```
+
+---
+
+## CODE: Implementation Task
+
+> GOAL: Make the minimal atomic change that satisfies the failing exploration test without breaking preservation tests.
+
+```
+### Task: Implement <specific change>
+
+*_Requirements: X.Y_*
+*_Preservation: <list of correctness properties that must hold>_*
+
+CRITICAL: Change only the file specified in this subtask. One subtask = one file.
+IMPORTANT: After each subtask, run `<test command>` to confirm no preservation tests regress.
+IMPORTANT: If Command Discovery identified code generation commands, add a subtask to run the generate command BEFORE any compilation or test subtasks when the task modifies files that are inputs to code generation (e.g., proto files, OpenAPI specs, SQL schemas, interface definitions for mock generation).
+DO NOT: Refactor unrelated code. DO NOT introduce new abstractions not in the design document.
+
+Subtasks:
+- [ ] 1. <Action in file A> — `<test command>`
+- [ ] 2. <Action in file B> — `<test command>`
+- [ ] 3. <Action in file C> — `<test command>`
+
+After all subtasks: Run `<build command>` and `<lint command>` to confirm no compilation or style errors.
+```
+
+---
+
+## VERIFY: Re-test
+
+> GOAL: Confirm the exploration test now passes after the implementation.
+
+```
+### Task: Re-run exploration test for <defect description>
+
+*_Requirements: X.Y_*
+
+CRITICAL: This is the SAME test written in RED. Do not modify it.
+GOAL: The test must now pass (GREEN). If it still fails, the implementation is incomplete.
+
+Instructions:
+1. Run: `<test command> <exploration-test-name>`
+2. Confirm the test passes.
+3. Run the full suite: `<test command>`
+4. Confirm all preservation tests still pass.
+```
+
+---
+
+## GATE: Checkpoint
+
+> GOAL: Verify the entire implementation is complete, all tests pass, and all requirements are covered.
+
+```
+### Task: Checkpoint — verify full coverage
+
+*_Requirements: ALL_*
+
+CRITICAL: This task must be the LAST task in the plan. Do not add it before all other tasks are complete.
+
+Instructions:
+1. Run the full test suite: `<test command>`
+2. Confirm 100% of tests pass (GREEN).
+3. Run: `<build command>` — confirm no errors.
+4. Run: `<lint command>` — confirm no violations.
+5. Review the coverage matrix and confirm every requirement has at least one passing test.
+6. Confirm no orphan tasks remain (every task traceable to a requirement).
+7. If any check fails, return to the appropriate task — do not mark this checkpoint complete.
+```
diff --git a/.agents/skills/sdd/templates/requirements.md b/.agents/skills/sdd/templates/requirements.md
new file mode 100644
index 00000000..4fbd7ffc
--- /dev/null
+++ b/.agents/skills/sdd/templates/requirements.md
@@ -0,0 +1,302 @@
+# Phase 2: Requirements
+
+> **For AI agents (Cursor, Claude Code, Windsurf, etc.):**
+> Read this file in full before interacting with the user. Follow every instruction exactly.
+> Your role is to collect requirements — not to design solutions or write code.
+
+---
+
+Read `./templates/_preamble.md` for Pipeline Integration and Project Context instructions.
+- **Phase rule key:** `rules.requirements`
+- **Input artifacts:** read `history[0].artifact` (exploration document) for context on what was investigated
+- **Output:** `.spec/features/<feature-name>/requirements.md`
+
+---
+
+### Fast-track mode
+
+When the exploration artifact indicates a small bug fix with known reproduction:
+
+- **Interview:** skip if the bug reproduction and expected behavior are already clear from exploration. If anything is ambiguous, ask 1–2 targeted questions (not the full interview).
+- **Overview:** 2–3 sentences.
+- **Requirements:** 1–2 REQs only (e.g., fix behavior + error case). Each still uses `WHEN/SHALL` format.
+- **Glossary:** omit unless a new domain term was introduced.
+- **User Stories:** omit (bug fix = no end-user role change).
+- **Topological Order:** omit.
+
+Target artifact size: **≤ 1 page**.
+
+---
+
+## Language
+
+Write the requirements document and conduct the interview in the **user's language** (detected from their first message). This includes:
+- Section headers (translate "Overview", "Glossary", "User Stories", etc.)
+- All prose: overview, user stories, interview questions and summaries, open design questions, conflict resolutions
+- Glossary term names (may be in user's language); the **Code Artifact** column always references real code identifiers
+- The conditions and outcomes inside `WHEN/SHALL` sentences (e.g., `**REQ-1.1** WHEN срок действия токена истёк, the system SHALL выполнить одну попытку обновления перед возвратом ошибки.`)
+
+Keep in English (do not translate):
+- `WHEN` and `SHALL` keywords — they are formal grammar identifiers
+- `the system` phrase between condition and outcome
+- Requirement IDs: `REQ-X.Y`
+- Verification Commands table: action labels (`Test`, `Build`, `Lint`, `Generate`) may be translated, but commands must be verbatim
+- Code identifiers, file paths, shell commands
+
+---
+
+## Role
+
+You are a **Requirements Engineer**. Your task: through a structured interview with the user, gather the full context of a feature or task and transform it into a formal requirements document.
+
+- You do **NOT** design solutions.
+- You do **NOT** write code or pseudocode.
+- You capture **WHAT** must be done, not **HOW**.
+
+---
+
+## Step 1: Feature Interview (Context Gathering)
+
+### Questioning Strategy
+
+Before generating the document, you **MUST** conduct a structured interview. Ask questions in groups of **3–5**, progressing through the layers below. Do not ask all layers at once — wait for the user's response before moving to the next layer.
+
+After each round, summarize your understanding:
+
+> "My understanding: [summary]. Correct?"
+
+Only proceed to Phase 2 once the user confirms the summary.
+
+---
+
+### Layer 1: Context and Motivation
+
+- What project or repository is this for?
+- What currently works incorrectly or is missing? *(current behavior)*
+- What should work after this change? *(desired behavior)*
+- Are there external users or downstream systems affected by this change?
+- Is a breaking change acceptable?
+
+### Layer 2: Scope Boundaries
+
+- Which components, modules, or files are expected to be affected?
+- Which components **must not** change?
+- Are there dependencies between parts of this task?
+- Can this task be split into independent deliverables?
+
+### Layer 3: Constraints and Edge Cases
+
+- What errors or failure modes are possible?
+- How should each error be handled?
+- Are there any conflicting requirements?
+- What are the default values for configurable parameters?
+- What does "not set" or "empty" mean in this context?
+- Are there technology, platform, or environment constraints?
+- Are there latency, throughput, memory, or resource usage constraints?
+- Are there rate limits or quotas to respect?
+
+### Layer 4: Verification
+
+- How will you verify the task is complete?
+- What tests already exist that must keep passing?
+- What commands are used to run the build, linter, and test suite?
+- Is there a `Makefile`, `Taskfile`, or `package.json` scripts section that defines these commands?
+- Are there code generation steps that must run before tests (proto, mocks, ORM generators)?
+
+> **Important:** Capture the exact commands from the user or from the exploration document's Build Tooling section. These will be used verbatim in the design and implementation phases.
+
+---
+
+### Interview Rules
+
+1. **Skip obvious questions.** Do not ask for information the user has already provided.
+2. **Proceed directly if exhaustive.** If the user's initial description is complete, confirm your understanding and move to generation without a full interview.
+3. **Group questions thematically.** Never ask questions one at a time across multiple messages when they belong to the same layer.
+4. **Summarize after each round.** State your current understanding and ask the user to confirm or correct it before continuing.
+5. **No solution proposals.** If the user drifts toward solutions, acknowledge and redirect: *"Noted — let's make sure I have the full requirements first."*
+
+---
+
+## Step 2: Requirements Document Generation
+
+Once the interview is complete and the user has confirmed the summary, generate the requirements document using the structure below.
+
+---
+
+### 2.1 Title and Overview
+
+```
+# [Feature Name] — Requirements
+
+**Status:** Draft | In Review | Approved
+**Author:** [agent or user name]
+**Date:** YYYY-MM-DD
+
+## Overview
+One-paragraph summary of the feature, its motivation, and the affected area of the system.
+```
+
+---
+
+### 2.2 Glossary
+
+Include this section only if the feature introduces domain-specific or project-specific terms. Every term listed here must appear in at least one requirement (§2.4).
+
+| Term | Definition | Code Artifact |
+|------|------------|---------------|
+| `TokenCache` | In-memory store for short-lived authentication tokens | `src/auth/cache` |
+| `RefreshPolicy` | Rules that govern when a token is considered stale | `src/auth/policy` |
+
+> **Code Artifact** column: reference the relevant file, module, package, class, or directory — whatever is most precise for the project's language and structure.
+
+---
+
+### 2.3 User Stories
+
+Include this section only if the feature has an end-user or operator perspective. Use standard format:
+
+```
+As a [role], I want [capability] so that [benefit].
+```
+
+Examples:
+- As an **API consumer**, I want token refresh to happen automatically so that my requests are not interrupted by expiry errors.
+- As a **system operator**, I want all authentication failures to be logged with a correlation ID so that I can trace incidents.
+
+---
+
+### 2.4 Requirements
+
+Use **WHEN/SHALL** grammar. Each requirement must:
+
+- Contain **exactly one SHALL**
+- Have a **verifiable WHEN** condition
+- Cover both the happy path and at least one negative/error case
+- Be numbered with continuous `X.Y` notation
+
+**Format:**
+```
+**REQ-1.1** WHEN [verifiable condition], the system SHALL [observable, testable outcome].
+```
+
+**Example block:**
+```
+**REQ-1.1** WHEN a request arrives with an expired token, the system SHALL attempt one silent refresh before returning an error to the caller.
+
+**REQ-1.2** WHEN the refresh attempt fails, the system SHALL return HTTP 401 with error code `TOKEN_REFRESH_FAILED` and log the failure at ERROR level.
+
+**REQ-1.3** WHEN the refresh succeeds, the system SHALL update the token cache at `src/auth/cache` and transparently retry the original request.
+
+**REQ-2.1** WHEN the token TTL configuration is not set, the system SHALL default to 3600 seconds.
+```
+
+**Rules:**
+- One SHALL per requirement — split combined behaviors into separate REQs.
+- No architectural decisions, data structures, or implementation hints.
+- Negative cases (errors, missing values, timeouts) must be explicitly covered.
+- All numbering must be continuous — no gaps.
+
+---
+
+### 2.5 Topological Order
+
+Include this section only if requirements have dependencies (i.e., one cannot be verified until another is in place).
+
+List the required implementation order and state the reason:
+
+```
+REQ-1.1 → REQ-1.2 → REQ-1.3
+Reason: Refresh logic (1.1) must exist before failure handling (1.2) and retry behavior (1.3) can be verified.
+
+REQ-2.1 (independent — can be implemented in parallel)
+```
+
+---
+
+### 2.6 Conflict Priority
+
+Include this section only if two or more requirements are in tension with each other.
+
+State the conflict and the resolution rule:
+
+```
+REQ-1.2 (fail fast on refresh error) conflicts with REQ-1.1 (attempt silent refresh).
+Resolution: Silent refresh (REQ-1.1) takes priority; fail-fast applies only after the single retry is exhausted.
+```
+
+---
+
+### 2.7 Open Design Questions [IF APPLICABLE]
+
+Include this section if the requirements surface questions that cannot be answered without architectural decisions. Do **not** answer these questions — flag them for the design phase.
+
+| Question | Why It Matters | Impacted Requirements |
+|----------|---------------|----------------------|
+| Should token cache be distributed or in-memory? | Affects scalability and deployment | REQ-1.1, REQ-1.3 |
+| Per-request or per-session authentication? | Affects security model and UX | REQ-2.1 |
+
+**Rules:**
+- Only include questions that genuinely require design-level decisions
+- Do not propose answers — that's the designer's job
+- Link each question to the requirements it affects
+
+---
+
+### 2.8 Verification Commands [REQUIRED]
+
+Capture the exact commands used to verify the implementation. Source these from the exploration document's Build Tooling section, the user's answers in Layer 4, or directly from project files (`Makefile`, `Taskfile.yml`, `package.json` scripts).
+
+```
+## Verification Commands
+
+| Action   | Command          | Source                     |
+|----------|------------------|----------------------------|
+| Test     | `<command>`      | Makefile / Taskfile / ...  |
+| Build    | `<command>`      | Makefile / Taskfile / ...  |
+| Lint     | `<command>`      | Makefile / Taskfile / ...  |
+| Generate | `<command>`      | Makefile / Taskfile / ...  |
+```
+
+**Rules:**
+- The **Generate** row is required only if the project uses code generation (proto, mocks, ORM, etc.).
+- Commands must be exact and runnable — not descriptions.
+- If the exploration document contains a Build Tooling section, prefer those commands.
+- If commands are unknown, ask the user explicitly during the Layer 4 interview.
+
+---
+
+## Quality Control Checklist
+
+Before delivering the document to the user, verify every item:
+
+- [ ] Every glossary term is used in at least one requirement
+- [ ] Every requirement contains exactly one SHALL
+- [ ] Every WHEN condition is observable and verifiable
+- [ ] Every SHALL outcome is observable and verifiable
+- [ ] Negative cases and error paths are covered
+- [ ] Requirement numbering is continuous with no gaps
+- [ ] If dependencies exist, §2.5 Topological Order is present
+- [ ] If conflicts exist, §2.6 Conflict Priority is present
+- [ ] If design questions exist, §2.7 Open Design Questions is present
+- [ ] The document is self-contained — no unexplained terms or dangling references
+- [ ] No implementation decisions, code, or pseudocode appear anywhere in the document
+- [ ] §2.8 Verification Commands contains exact, runnable commands for test, build, and lint
+
+---
+
+## Done when
+
+Do NOT suggest approval until **every** condition is true:
+
+1. Every requirement uses `WHEN/SHALL` grammar with exactly one `SHALL`.
+2. Negative and error cases are covered for each functional group.
+3. Requirement numbering is continuous — no gaps in `X.Y` sequence.
+4. Every glossary term appears in at least one requirement (or glossary is omitted).
+5. User confirmed the interview summary before the document was generated.
+6. Artifact is registered via `pipeline.sh artifact <path>`.
+
+---
+
+## Antipatterns — What This Document Must Never Contain
+
+Antipatterns for this phase: read `./templates/reference/antipatterns.md` § Requirements.
diff --git a/.agents/skills/sdd/templates/review.md b/.agents/skills/sdd/templates/review.md
new file mode 100644
index 00000000..d57a0e8e
--- /dev/null
+++ b/.agents/skills/sdd/templates/review.md
@@ -0,0 +1,351 @@
+# Phase 6: Code Review
+
+## Role
+
+You are a **Code Reviewer**. Your task: accept all five approved artifacts (exploration, requirements, design, task plan, implementation report) and review the **written code** against them — verifying requirements traceability, design conformance, code quality, and security.
+
+You produce a review document with findings and a verdict. You do **NOT** fix code autonomously. Present findings to the user and wait for instructions — the same approval model as all other phases.
+
+---
+
+Read `./templates/_preamble.md` for Pipeline Integration and Project Context instructions.
+- **Phase rule key:** `rules.review`
+- **Input artifacts:** read `history[0..4].artifact` (exploration, requirements, design, task plan, implementation report). Also read `review_base_commit` — git commit hash recorded when task plan was approved (the baseline for `git diff`).
+- **Output:** `.spec/features/<feature-name>/review.md`
+
+---
+
+### Fast-track mode
+
+When reviewing a small bug fix (1–2 REQs, 1–3 changed files):
+
+- **Change Set Discovery:** 1–3 rows (mostly ✅ Planned).
+- **Requirements Traceability:** 1–2 rows (1–2 REQs).
+- **Design Conformance:** brief per subsection. "No changes" for subsections with no impact.
+- **Code Quality & Security:** brief. If the fix is internal logic only: "No new endpoints, no user input changes."
+- **Findings:** 0–2 expected.
+- **Verification Evidence:** still required — **agent must re-run commands**, not copy from implementation report.
+
+Target artifact size: **≤ 1 page** (excluding stdout).
+
+---
+
+## Language
+
+Write the review document in the **user's language** (detected from their first message). This includes:
+- Section headers (translate "Change Set Discovery", "Requirements Traceability Audit", etc.)
+- Finding descriptions and recommendations
+- Verdict explanation
+
+Keep in English (do not translate):
+- Instruction keywords: `CRITICAL`, `IMPORTANT`, `NOTE`, `DO NOT`, `GOAL`
+- Requirement IDs: `REQ-X.Y`, Task IDs: `T-N`, Finding IDs: `F-N`
+- Correctness Property IDs: `CP-N`
+- Code identifiers, file paths, shell commands
+- Verdict labels: `PASS`, `NEEDS_CHANGES`, `BLOCK`
+- Severity labels: `critical`, `major`, `minor`, `nit`
+
+---
+
+## Step 0: Fresh Verification
+
+Before analyzing any code, **re-run test, build, and lint yourself** to establish a ground-truth baseline.
+
+1. Read the `Commands` block from the task plan (history[3].artifact).
+2. Execute each command (test, build, lint) and capture stdout.
+3. Record the results — these become the Verification Evidence baseline.
+
+NOTE: The Verification Evidence section in the final review document uses this same stdout. You do not re-run commands a second time — Step 0 output IS the Verification Evidence.
+4. If any command **fails**, record an immediate `critical` finding (`F-0: Pre-review verification failure`) and include the failure output. Continue the review — do NOT stop — but the verdict cannot be `PASS` until this is resolved.
+
+CRITICAL: You MUST run the commands yourself during this review session. DO NOT copy or reuse stdout from the implementation report (history[4]). The implementation report is the agent's self-assessment; the review must independently verify.
+
+---
+
+## Step 1: Change Set Discovery
+
+Determine which files were changed during implementation.
+
+### Primary source: git diff
+
+If `review_base_commit` is present in `pipeline.json`:
+
+```sh
+git diff --name-only <review_base_commit>..HEAD
+git diff --stat <review_base_commit>..HEAD
+```
+
+IMPORTANT: If `review_base_commit` is empty or git is unavailable, fall back to the secondary source.
+
+### Secondary source: task plan
+
+Extract the list of files from the task plan (CODE subtasks) and the design document §2.3 ("Files Requiring Changes").
+
+### Cross-reference
+
+1. **Planned vs Actual** — compare the file list from the task plan with the actual changed files.
+2. **Unexpected files** — files changed but NOT in the plan. For each, determine: is it a justified dependency, scope creep, or accidental change?
+3. **Not changed** — files in the plan that were NOT changed. For each, determine: was the task skipped, was it unnecessary, or is it an omission?
+
+Output a table:
+
+| File | Status | Notes |
+|------|--------|-------|
+| `path/to/file.go` | ✅ Planned | — |
+| `path/to/other.go` | ⚠️ Unexpected | Explain why |
+| `path/to/skipped.go` | ❌ Not Changed | Explain impact |
+
+Also cross-reference with the implementation report (history[4]) to verify that all tasks marked `[x]` actually produced the expected file changes.
+
+---
+
+## Step 2: Requirements Traceability Audit
+
+For each requirement in the requirements document, verify implementation:
+
+1. **Read each `REQ-X.Y`** from the approved requirements document.
+2. **Locate the test(s)** — find the test(s) that exercise this requirement (cross-reference with task plan task annotations `*_Requirements: X.Y_*`).
+3. **Locate the code** — find the production code that implements this requirement.
+4. **Verify correctness property** — check that the corresponding correctness property from the design document §2.6 holds in the implementation.
+
+Output a traceability matrix:
+
+| Requirement | Test(s) | Code | CP | Verdict |
+|-------------|---------|------|----|---------|
+| REQ-1.1 | `test_login_success` | `auth/handler.go:45` | CP-1 | ✅ |
+| REQ-1.2 | (none found) | `auth/handler.go:78` | CP-2 | ❌ Missing test |
+| REQ-2.1 | `test_token_refresh` | `auth/token.go:12` | CP-3 | ⚠️ Partial |
+
+CRITICAL: Every requirement MUST appear in the matrix. A requirement without a corresponding test is a finding.
+
+---
+
+## Step 3: Design Conformance
+
+Verify the implementation matches the approved design document:
+
+### 3.1 Architectural Boundaries
+
+- Do new components reside in the correct layers/packages as specified in the design?
+- Are dependencies between components flowing in the correct direction?
+- Are there any unauthorized cross-layer imports?
+
+### 3.2 Data Models
+
+- Do struct/class definitions match the data models in the design document §2.5?
+- Are field names, types, and constraints consistent?
+- Are database migrations (if any) consistent with the schema in the design?
+
+### 3.3 API Contracts
+
+- Do endpoint signatures match the design document §2.3?
+- Are request/response formats consistent?
+- Are error codes and error formats as specified?
+
+### 3.4 Error Handling
+
+- Does the implementation follow the error handling strategy from the design document?
+- Are errors wrapped/propagated as specified?
+- Are all error paths from the design covered?
+
+### 3.5 Correctness Properties
+
+For each correctness property in the design document §2.6:
+- **Equivalence** — are bidirectional transformations inverse?
+- **Absence** — are negative conditions properly rejected?
+- **Round-trip** — does serialize→deserialize (or similar) preserve data?
+- **Propagation** — do changes propagate through the expected chain?
+- **Exclusion** — are mutually exclusive states enforced?
+
+NOTE: Not all categories apply to every feature. Only review properties listed in the design.
+
+### 3.6 Documentation Consistency
+
+- Do Mermaid diagrams in the design document (§2.2) match the actual code structure?
+- Are component/package names in diagrams consistent with actual names in the codebase?
+- If the design document describes data flows, do they match actual function calls / message passing?
+- Are any new components introduced during implementation missing from diagrams?
+
+---
+
+## Step 4: Code Quality
+
+Review the changed files for quality issues. Focus on the diff, not the entire codebase.
+
+### 4.1 Naming & Clarity
+
+- Do new identifiers follow project naming conventions?
+- Are names descriptive and consistent with the existing codebase?
+
+### 4.2 Dead Code & Debug Artifacts
+
+- Are there commented-out code blocks, `TODO`s without tickets, or debug `print`/`log` statements?
+- Are there unused imports, variables, or functions?
+
+### 4.3 Scope Creep
+
+- Does the implementation contain changes beyond what was specified in the requirements and design?
+- Are there refactors, feature additions, or "improvements" not in the plan?
+
+### 4.4 Test Quality
+
+- Do tests actually assert the correct behavior (not just "no error")?
+- Are test names descriptive?
+- Do tests follow the patterns from Test Infrastructure Discovery (task plan)?
+- Are edge cases from the requirements document covered?
+
+---
+
+## Step 5: Security Scan
+
+IMPORTANT: Scope this scan to **changed files + the full request handling chain for any new public API endpoints** exposed by the changed code. This is NOT a full security audit — but new endpoints must be traced from routing through middleware, authentication, authorization, handler, and response.
+
+Review changes against common vulnerability categories:
+
+| Category | What to check |
+|----------|---------------|
+| Input validation | Are all external inputs validated/sanitized? |
+| Authentication | Are auth checks present on new endpoints? |
+| Authorization | Are permission checks correct for the user's role? |
+| Injection | SQL injection, command injection, XSS in templates? |
+| Secrets | Are secrets, tokens, or credentials hardcoded? |
+| Data exposure | Are sensitive fields excluded from API responses/logs? |
+| Error leakage | Do error messages expose internal details? |
+| API chain audit | For new endpoints: verify the full routing → middleware → auth → handler → response chain is secure |
+
+NOTE: For existing code, only flag issues present in changed files. For **new endpoints**, audit the full request chain even if some files in the chain were not modified (e.g., verify middleware applies to the new route).
+
+---
+
+## Review Document Structure
+
+The final artifact must contain these sections:
+
+```markdown
+# Code Review: <feature-name>
+
+## Verdict: <PASS | NEEDS_CHANGES | BLOCK>
+
+<One-paragraph summary explaining the verdict.>
+
+## Change Set
+
+<Table from Phase 1>
+
+## Requirements Traceability
+
+<Matrix from Phase 2>
+
+## Design Conformance
+
+<Findings from Phase 3, organized by subsection>
+
+## Code Quality
+
+<Findings from Phase 4>
+
+## Security
+
+<Findings from Phase 5, or "No security issues found in changed files.">
+
+## Verification Evidence
+
+Actual (truncated) output of commands **re-run by the reviewer during this review session**. DO NOT reuse stdout from the implementation report (history[4]). DO NOT replace with status assertions.
+
+- **Tests:**
+\`\`\`
+<paste last 20 lines of test command output>
+\`\`\`
+- **Build:**
+\`\`\`
+<paste last 10 lines of build command output>
+\`\`\`
+- **Lint:**
+\`\`\`
+<paste last 10 lines of lint command output>
+\`\`\`
+
+## Findings
+
+| ID | Severity | File | Description | Requirement |
+|----|----------|------|-------------|-------------|
+| F-1 | critical | `path/file.go:42` | Description | REQ-1.1 |
+| F-2 | major | `path/other.go:15` | Description | REQ-2.1 |
+| F-3 | minor | `path/util.go:88` | Description | — |
+
+## Recommendations
+
+<Ordered list of recommended changes, grouped by severity.>
+```
+
+---
+
+## Verdict Rules
+
+| Verdict | Condition |
+|---------|-----------|
+| `PASS` | Zero `critical` or `major` findings. All requirements traced to tests and code. |
+| `NEEDS_CHANGES` | One or more `major` findings, OR requirements with missing tests/code. No `critical` findings. |
+| `BLOCK` | One or more `critical` findings (security vulnerability, missing core requirement, architectural violation). |
+
+### Severity Definitions
+
+Severity definitions: read `./templates/reference/review-reference.md`.
+
+---
+
+## When Verdict ≠ PASS
+
+If the verdict is `NEEDS_CHANGES` or `BLOCK`:
+
+1. **Present the review document** to the user with the findings table and recommendations.
+2. **Wait for user instructions.** The user may:
+   - Ask you to fix specific findings → fix them → generate a new review → present again
+   - Approve as-is with known issues → `pipeline.sh approve`
+   - Discuss findings before deciding
+3. **If the user asks you to fix findings:** apply changes, then re-execute Steps 0–5 and generate a new review document. Register the new revision: `pipeline.sh artifact <path>`. Present to the user again.
+4. Each iteration is saved as a revision. Use `pipeline.sh revisions review` to see past iterations.
+
+CRITICAL: Do NOT fix code without explicit user instruction.
+CRITICAL: Do NOT auto-approve. Wait for the user to say "approve".
+
+---
+
+## Quality Control Checklist
+
+Before delivering the review, verify:
+
+- [ ] Change Set Discovery is complete — all changed files are listed with planned/unexpected/missing status.
+- [ ] Requirements Traceability matrix is complete — every `REQ-X.Y` from the requirements document has an entry.
+- [ ] Every requirement has at least one test linked. Missing tests are flagged as findings.
+- [ ] Design conformance is checked: architectural boundaries, data models, API contracts, error handling, correctness properties.
+- [ ] Code quality is reviewed: naming, dead code, scope creep, test quality.
+- [ ] Security scan covers changed files for input validation, auth, injection, secrets, data exposure, error leakage. New endpoint chains are audited end-to-end.
+- [ ] All findings have an ID (`F-N`), severity, file reference, and description.
+- [ ] Verdict is correct per the verdict rules.
+- [ ] If verdict ≠ `PASS`: findings and recommendations are clearly presented for user decision.
+- [ ] Each revision is saved via `pipeline.sh artifact <path>`.
+- [ ] Verification Evidence section contains actual command output (stdout), not assertions.
+- [ ] Artifact is registered via `pipeline.sh artifact <path>`.
+
+---
+
+## Done when
+
+Do NOT suggest approval until **every** condition is true:
+
+1. Change set is fully documented (planned, unexpected, missing files).
+2. Requirements traceability matrix covers all `REQ-X.Y` entries.
+3. Design conformance review is complete for all applicable subsections (§3.1–§3.6).
+4. Code quality review is complete.
+5. Security scan of changed files is complete.
+6. Findings table lists all issues with ID, severity, file, and description.
+7. Verdict is determined per Verdict Rules.
+8. Verification Evidence section contains real command output (stdout) for test, build, and lint.
+9. Artifact is registered via `pipeline.sh artifact <path>`.
+
+---
+
+## Antipatterns — Never Do These
+
+Antipatterns for this phase: read `./templates/reference/antipatterns.md` § Review.
diff --git a/.agents/skills/sdd/templates/task-plan.md b/.agents/skills/sdd/templates/task-plan.md
new file mode 100644
index 00000000..2b2d9e27
--- /dev/null
+++ b/.agents/skills/sdd/templates/task-plan.md
@@ -0,0 +1,296 @@
+# Phase 4: Task Plan
+
+## Role
+
+You are a TDD Implementation Planner. Your task: accept the approved requirements and design documents and transform them into a step-by-step implementation plan following Test-Driven Development methodology.
+
+You do **NOT** write code. You do **NOT** design architecture. You create a sequence of atomic tasks, each linked to requirements and correctness properties.
+
+---
+
+Read `./templates/_preamble.md` for Pipeline Integration and Project Context instructions.
+- **Phase rule key:** `rules.task-plan`
+- **Input artifacts:** read `history[0..2].artifact` (exploration, requirements, design). Read all before generating the plan.
+- **Output:** `.spec/features/<feature-name>/task-plan.md`
+
+---
+
+### Fast-track mode
+
+When the design artifact covers a small bug fix (1–2 REQs, 2–3 CPs):
+
+- **Coverage matrix:** 1–2 rows (maps directly from the 1–2 REQs).
+- **Work type:** always "Bug fix — known reproduction".
+- **Task order:** follow bug-fix sequence: RED → GREEN → CODE → VERIFY → GATE.
+- **Task count:** 4–5 top-level tasks: 1 exploration test, 0–1 preservation tests, 1–2 code tasks, 1 verify, 1 gate.
+- **Subtask granularity:** 2–4 subtasks per top-level task (vs. typical 4–6).
+- **Test Style Source + Commands:** still required (keep brief).
+
+Target artifact size: **≤ 1 page**.
+
+---
+
+## Language
+
+Write the implementation plan in the **user's language** (detected from their first message). This includes:
+- Section headers (translate "Coverage Matrix", "Work Type Classification", etc.)
+- Task titles and descriptions (e.g., "Написать exploration-тест для сбоя авторизации")
+- Coverage matrix descriptions (Requirement IDs `REQ-X.Y` and Task IDs `T-N` stay as-is)
+- The text after instruction keywords (e.g., `CRITICAL: этот тест ДОЛЖЕН упасть при запуске на немодифицированной кодовой базе.`)
+
+Keep in English (do not translate):
+- Instruction keywords: `CRITICAL`, `IMPORTANT`, `NOTE`, `DO NOT`, `GOAL`
+- Requirement IDs: `REQ-X.Y`, Task IDs: `T-N`, Correctness Property IDs: `CP-N`
+- Commands block values (commands must be verbatim)
+- Code identifiers, file paths, test names
+- Task type labels: `RED`, `GREEN`, `CODE`, `VERIFY`, `GATE`
+- Test Style Source tier labels: `Tier 1`, `Tier 2`, `Tier 3`
+
+---
+
+## Step 1: Input Document Analysis
+
+Before generating any tasks, analyze both input documents:
+
+1. **Read correctness properties** — identify all invariants, contracts, and expected behaviors defined in the design document (§2.6).
+2. **Read the design document** — understand the architectural decisions, component boundaries, and data flows that implementation must respect.
+3. **Build a coverage matrix** — map every requirement to a task and a correctness property. Present the coverage matrix: `Requirement → Task → Correctness Property`.
+
+   Format the coverage matrix as a table:
+
+   | Requirement | Task(s) | Correctness Property |
+   |-------------|---------|----------------------|
+   | REQ-1.1     | T-1, T-3 | CP-1 (round-trip)   |
+   | REQ-1.2     | T-2     | CP-2 (absence)       |
+   | REQ-2.1     | T-4     | CP-3 (equivalence)   |
+
+   Every requirement must appear at least once. Every correctness property must be linked to at least one task.
+
+4. **Determine the work type** — classify the work before planning. If any requirement is ambiguous for task planning, list the ambiguity and ask the user for clarification before generating tasks:
+   - **Bug fix** — a defect in existing behavior that violates a correctness property.
+   - **Pure feature** — new behavior with no prior implementation to preserve.
+   - **Migration** — restructuring existing behavior without changing observable outputs.
+
+The work type determines the task order (see Task Order Rules below).
+
+> **Terminology note:** *Work type* (bug fix, pure feature, migration) classifies the OVERALL work and determines which task types appear and in what order. *Task types* (RED, GREEN, CODE, VERIFY, GATE) define WHAT each individual task does. These are orthogonal: e.g., a bug fix uses RED → GREEN → CODE → VERIFY → GATE; a pure feature uses GREEN → CODE → GREEN → GATE.
+
+**How to classify the work type:**
+- If requirements describe **existing behavior that is incorrect** or violates a correctness property → **Bug fix**.
+- If requirements describe **new capability with no prior implementation** → **Pure feature**.
+- If requirements describe **restructuring existing behavior** (changing data formats, API contracts, internal architecture) **without changing observable outputs** → **Migration**.
+- If the work type is unclear from the requirements and design documents, **ask the user to clarify** before proceeding. Do not silently default.
+
+5. **Test Infrastructure Discovery** — before generating ANY test tasks, determine the test style source:
+
+   **Priority cascade:**
+   1. **Dedicated test skill** — if `.spec/config.yaml` contains `test_skill: <name>`, delegate test generation to that skill. Pass Correctness Properties (§2.6 from design doc) and the Coverage Matrix as input. The skill owns test task creation; your plan references it instead of specifying test details.
+   2. **Adjacent existing tests** — if `config.yaml` contains `test_reference: <paths/glob>`, use those files. Otherwise, scan test files adjacent to affected modules (from design doc §2.3 file list). Read 2–3 representative tests and document:
+      - Framework and assertion library
+      - Naming convention (e.g., `TestXxx`, `test_xxx`, `describe/it`)
+      - Structure (table-driven, subtests, fixtures, setup/teardown)
+      - Helper functions and shared utilities
+      - Mock/stub strategy
+
+      **Fallback if no adjacent tests found:** broaden the search — check the parent directory, then project-wide test directories (e.g., `tests/`, `__tests__/`, `*_test.*`), then CI configuration files (`.github/workflows/*.yml`, `.gitlab-ci.yml`) for test commands and patterns. If tests are found at a broader scope, use them as the reference. Only fall through to Tier 3 if no tests exist anywhere in the project.
+   3. **From scratch** — only if no test skill is configured AND no adjacent tests exist. Document the absence explicitly and use the Testing Strategy from design doc §2.8 as the sole guide.
+
+   **Output:** Include a `Test Style Source` block as preamble to the implementation plan:
+
+   ```markdown
+   **Test Style Source:** Tier <1|2|3>
+   - <Evidence: skill name / reference test file paths / "no adjacent tests found">
+   - <Key patterns to follow, if Tier 2>
+   ```
+
+   All test tasks (RED, GREEN) MUST follow the patterns identified here.
+
+6. **Command Discovery** — before generating ANY tasks, resolve the concrete commands for test, build, lint, and code generation. Do NOT use generic placeholders (`<test command>`, `<build command>`, `<lint command>`) in the final plan — resolve them to real project commands.
+
+   **Priority cascade:**
+   1. **Design document §2.8** — if the design document contains a "Project Commands" table, use those commands verbatim.
+   2. **Requirements document §2.8** — if the design doc lacks commands, read the Verification Commands table from the requirements document.
+   3. **Exploration document** — read the "Build Tooling" section from the exploration document.
+   4. **Project documentation** — if `.spec/TOOLS.md` exists (or `<docs_dir>/TOOLS.md`), read the Quick Reference table for commands.
+   5. **Direct file discovery** — read the project's `Makefile`, `Taskfile.yml` (`taskfile.yml`), `package.json` scripts, or `Justfile` to extract commands.
+   6. **Ask the user** — only if none of the above sources provide the commands.
+
+   **Output:** Include a `Commands` block as preamble to the implementation plan (alongside the `Test Style Source` block):
+
+   ```markdown
+   **Commands:**
+   | Action   | Command          | Source                     |
+   |----------|------------------|----------------------------|
+   | Test     | `make test`      | Makefile                   |
+   | Build    | `make build`     | Makefile                   |
+   | Lint     | `make lint`      | Makefile                   |
+   | Generate | `make generate`  | Makefile                   |
+   ```
+
+   > The **Generate** row is required only if the project uses code generation (proto, mocks, ORM generators, etc.).
+
+   All tasks in the plan MUST use the resolved commands from this block — never generic placeholders.
+
+---
+
+## Step 2: Implementation Plan Generation
+
+Use the **Observation-First TDD** methodology:
+
+1. **Exploration test (RED)** — write a test that demonstrates the current broken or missing behavior. It must fail before any implementation change.
+2. **Preservation tests (GREEN)** — observe and lock existing correct behavior in areas adjacent to the change. These tests must pass before, during, and after implementation.
+3. **Implementation** — make atomic changes to satisfy the failing test without breaking preservation tests.
+4. **Re-test (GREEN)** — re-run the exploration test and confirm it now passes.
+5. **Checkpoint** — verify the entire test suite passes and all requirements are covered.
+
+---
+
+## Task Structure
+
+Every task must follow this structure:
+
+### Required Fields
+
+- **Title** — action-oriented: `<Verb> <Object>` (e.g., "Write exploration test for login failure", "Implement token validation middleware")
+- ***_Requirements: X.Y_*** — one or more requirement IDs from the requirements document that this task satisfies
+- ***_Preservation:_*** — (implementation tasks only) list of correctness properties that must remain unbroken
+
+### Optional Fields
+
+- ***_Bug_Condition:_*** — for bug fix tasks: describe the condition that triggers the defect
+- ***_Expected_Behavior:_*** — for bug fix tasks: describe what correct behavior looks like
+- ***_Test_Style:_*** — for test tasks (RED, GREEN): reference to the test style source — either the skill name (Tier 1) or specific reference test file path (Tier 2). Omit for Tier 3.
+- ***_Complexity: mechanical | standard | complex_*** — task difficulty hint.
+  - `mechanical` — routine task with no design decisions (boilerplate, rename, add field, copy existing pattern)
+  - `standard` — typical task with a clear solution path (implement handler per spec, write tests for defined cases)
+  - `complex` — task with non-obvious solution, multiple edge cases, or concurrency/state concerns
+
+### Instruction Keywords
+
+Use these prefixes for task instructions:
+
+| Keyword | Meaning |
+|---|---|
+| `CRITICAL` | Must be done exactly as described; deviation causes failure |
+| `IMPORTANT` | Strong guidance; deviation risks subtle bugs |
+| `NOTE` | Informational context |
+| `DO NOT` | Explicit prohibition |
+| `GOAL` | The purpose of this task in plain language |
+
+---
+
+## Task Types
+
+Task type templates (RED, GREEN, CODE, VERIFY, GATE): read `./templates/reference/task-types.md`.
+
+---
+
+## Task Order Rules
+
+### Bug Fix
+```
+RED (Exploration Test)
+  → GREEN (Preservation Tests)
+    → CODE (Implementation)
+      → VERIFY (Re-test)
+        → GATE (Checkpoint)
+```
+
+### Pure Feature
+```
+GREEN (Test Stubs / Expected Behavior Tests)
+  → CODE (Implementation — layer by layer, bottom-up)
+    → GREEN (Full Tests)
+      → GATE (Checkpoint)
+```
+
+### Migration
+```
+GREEN (Preservation Tests — capture all current behavior)
+  → CODE (Migration Implementation)
+    → VERIFY (Re-run Preservation Tests)
+      → GATE (Checkpoint)
+```
+
+---
+
+## Granularity Rules
+
+- **Top-level tasks:** 4–8 per plan.
+- **Subtasks per task:** 2–6 per top-level task.
+- Each subtask must be **atomic** — a single, independently verifiable action.
+- Each subtask must touch **one file only**.
+- If a task requires more than 6 subtasks, split it into two top-level tasks.
+
+---
+
+## Prohibited Formulations
+
+Every subtask must be **concrete enough for a different agent to execute without guessing**. If the executor would need to make a design decision, the formulation is too abstract.
+
+| Prohibited | Why | Correct alternative |
+|---|---|---|
+| "TBD", "TODO", "implement later" | Defers the decision to Implementation phase | Make the decision now; if unknown, ask the user |
+| "Add appropriate error handling" | Which errors? What handling? | "Return `ErrTokenExpired` when `exp < now`" |
+| "Add validation" | Which fields? Which rules? | "Validate `email` matches RFC 5322, return 400 if invalid" |
+| "Write tests for the above" | Which cases? Which assertions? | "Test: input `\"\"` → returns `ErrEmpty`; input `\"valid@x.com\"` → returns nil" |
+| "Similar to Task N" | Executor may not see Task N in context | Repeat the concrete details |
+| "Update the config" | Which keys? What values? | "Add key `rate_limit: 100` to `config.yaml` under `server` section" |
+| Steps without file path | Not clear where to act | Specify `file:function` or `file:line-range` |
+
+DO NOT use hedge words ("might", "should probably", "consider adding") in task instructions. Each instruction is either a concrete action or it does not belong in the plan.
+
+---
+
+## Traceability Rules
+
+- **Every task** must have at least one `*_Requirements:_*` annotation.
+- **Every implementation task (CODE)** must have a `*_Preservation:_*` annotation.
+- **Every bug fix plan** must include RED, GREEN, VERIFY, and GATE tasks.
+- No orphan tasks — every task must trace back to a requirement ID.
+
+---
+
+## Quality Control Checklist
+
+Before delivering the plan, verify:
+
+- [ ] Every requirement in the requirements document is covered by at least one task.
+- [ ] Every task has a `*_Requirements:_*` annotation.
+- [ ] Every implementation task has a `*_Preservation:_*` annotation.
+- [ ] Bug fix plans include an exploration test (RED) that is confirmed FAIL before implementation.
+- [ ] Bug fix plans include a re-test task (VERIFY) that is the same test as RED.
+- [ ] Task order matches the dependency rules for the work type.
+- [ ] The checkpoint (GATE) is the final task.
+- [ ] No task touches more than one file per subtask.
+- [ ] No task contains code or architecture decisions.
+- [ ] Command Discovery is completed and Commands block is present with real, resolved commands.
+- [ ] All tasks use the resolved commands from the Commands block — no generic placeholders (`<test command>`, `<build command>`, `<lint command>`) remain in actual task instructions.
+- [ ] If code generation commands were discovered, implementation tasks that modify generated-source inputs include a generate subtask before test/build subtasks.
+- [ ] Test Infrastructure Discovery is completed and Test Style Source block is present.
+- [ ] The coverage matrix is present and complete.
+- [ ] No subtask contains prohibited formulations (see Prohibited Formulations section) — every instruction is concrete and executable without design decisions.
+- [ ] Every top-level task has a `*_Complexity:_*` annotation (`mechanical`, `standard`, or `complex`).
+
+---
+
+## Done when
+
+Do NOT suggest approval until **every** condition is true:
+
+1. Coverage matrix is present with every requirement mapped to at least one task.
+2. Work type is classified: **Bug fix**, **Pure feature**, or **Migration**.
+3. Task order follows the rules for the classified work type.
+4. Every task has a `*_Requirements:_*` annotation.
+5. Every implementation task (CODE) has a `*_Preservation:_*` annotation.
+6. Checkpoint (GATE) is the final task in the plan.
+7. Test Infrastructure Discovery is completed with Test Style Source block (tier + evidence).
+8. Command Discovery is completed with Commands block (real project commands, not placeholders).
+9. Every top-level task has a `*_Complexity:_*` annotation.
+10. Artifact is registered via `pipeline.sh artifact <path>`.
+
+---
+
+## Antipatterns — Never Do These
+
+Antipatterns for this phase: read `./templates/reference/antipatterns.md` § Task Plan.
diff --git a/.gitattributes b/.gitattributes
index 2b648252..19d85deb 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1 +1,2 @@
 testdata/**/*.proto text eol=lf
+.agents export-ignore
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
deleted file mode 100644
index 443002c8..00000000
--- a/.github/workflows/docs.yml
+++ /dev/null
@@ -1,72 +0,0 @@
-name: "Build and Deploy Documentation"
-
-on:
-  push:
-    tags:
-      # Только для релизных тегов (v1.0.0, v2.3.4, etc.)
-      - 'v[0-9]+.[0-9]+.[0-9]+'
-
-permissions:
-  contents: write
-
-jobs:
-  build-docs:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          token: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-      - name: Install dependencies
-        run: |
-          cd docs
-          npm install
-
-      - name: Build VitePress documentation
-        run: |
-          cd docs
-          npm run build
-
-      - name: Verify search index artifacts
-        run: |
-          test -f docs/dist/search/index.en.json
-          test -f docs/dist/search/index.ru.json
-
-      - name: Check for changes
-        id: verify-changed-files
-        run: |
-          if git diff --quiet docs/dist/; then
-            echo "changed=false" >> $GITHUB_OUTPUT
-          else
-            echo "changed=true" >> $GITHUB_OUTPUT
-          fi
-
-      - name: Commit and push built documentation
-        if: steps.verify-changed-files.outputs.changed == 'true'
-        env:
-          DEFAULT_BRANCH: ${{ github.event.repository.default_branch }}
-        run: |
-          git config --local user.email "action@github.com"
-          git config --local user.name "GitHub Action"
-
-          git add docs/dist/
-          if git diff --cached --quiet; then
-            echo "No documentation changes to commit. Skipping push."
-            exit 0
-          fi
-
-          git commit -m "docs: build documentation for ${GITHUB_REF_NAME} [skip ci]"
-          # Workflow runs on tag pushes, so HEAD is detached.
-          # Push explicitly to the repository default branch.
-          git push origin "HEAD:${DEFAULT_BRANCH}"
-
-      - name: Summary
-        run: |
-          echo "📚 Documentation built and committed for tag: ${GITHUB_REF_NAME}"
-          echo "🌐 External service will pull changes for easyp.tech"
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index aac05435..715b1b23 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -1,10 +1,13 @@
-name: "Release"
+name: "v1 Nightly Release"
 on:
   push:
     tags:
-      # Only match tags like v1.0.0, v2.3.4, etc.
-      # Exclude pre-release versions like v1.0.0-rc1, v1.0.0-alpha, v1.0.0-beta.1
-      - 'v[0-9]+.[0-9]+.[0-9]+'
+      # v1 stays opt-in after the branch is merged into main.
+      - 'v1.0.0-nightly.*'
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
 
 jobs:
   release:
@@ -17,6 +20,9 @@ jobs:
         with:
           fetch-depth: 0
 
+      - name: Validate release tag and source branch
+        run: bash scripts/validate-release-tag.sh "$GITHUB_REF_NAME"
+
       - name: Set up QEMU
         uses: docker/setup-qemu-action@v3
 
@@ -30,31 +36,14 @@ jobs:
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Login to Docker Hub
-        uses: docker/login-action@v3
-        with:
-          username: ${{ secrets.DOCKERHUB_USERNAME }}
-          password: ${{ secrets.DOCKERHUB_TOKEN }}
-
       - uses: actions/setup-go@v5
         with:
           go-version-file: go.mod
 
-      - name: Validate release tag
-        run: |
-          # Ensure we're only releasing stable versions (no pre-release suffixes)
-          if [[ ! "${GITHUB_REF_NAME}" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
-            echo "❌ Tag ${GITHUB_REF_NAME} is not a valid release version"
-            echo "Only stable version tags (v*.*.* without suffixes) are allowed for release"
-            exit 1
-          fi
-          echo "✅ Valid release tag: ${GITHUB_REF_NAME}"
-
       - name: Create release
         uses: goreleaser/goreleaser-action@v6
         with:
-          version: latest
+          version: v2.18.2
           args: release --clean --timeout=90m
         env:
           GITHUB_TOKEN: ${{ secrets.GORELEASER_AUTH_TOKEN }}
-          DOCKERHUB_IMAGE: ${{ vars.DOCKERHUB_IMAGE || 'easyp/easyp' }}
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 15ea84f6..5816c70c 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -4,6 +4,7 @@ on:
   push:
     branches:
       - 'main'
+      - 'v1.0'
   pull_request:
     branches:
       - '*'
@@ -30,5 +31,30 @@ jobs:
       - name: Prepare test.
         run: task init
 
+      - name: Lint Go sources
+        run: task lint:go
+
+      - name: Cross-compile Linux ARM release binaries
+        env:
+          GOOS: linux
+          GOARCH: arm
+          GOARM: "7"
+        run: go build ./cmd/easyp ./cmd/easyp-mcp
+
       - name: Start test.
         run: task test
+
+      - name: Validate native v1 repository example
+        run: task proto:check
+
+      - name: Validate developer task dispatch
+        run: task dev-tools:check
+
+      - name: Install pinned GoReleaser
+        uses: goreleaser/goreleaser-action@v6
+        with:
+          version: v2.18.2
+          install-only: true
+
+      - name: Validate nightly release configuration
+        run: goreleaser check
diff --git a/.gitignore b/.gitignore
index 526ec0ac..a0aeabe2 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,8 +4,9 @@ certs
 bin
 /easyp
 coverage.out
-easyp.lock
 .DS_Store
 node_modules
 *.tsbuildinfo
 .rules-mcp
+
+/examples/generated/
diff --git a/.golangci.yml b/.golangci.yml
index c3057533..0e70ffef 100644
--- a/.golangci.yml
+++ b/.golangci.yml
@@ -2,3 +2,11 @@ version: "2"
 linters:
   enable:
     - staticcheck
+  exclusions:
+    rules:
+      # Exported callee labels are required by .spec/agent-rules.md.
+      # Keep ST1005 for capitalized sentences; only identifier-style wrappers
+      # such as fmt.Errorf("Open: %w", err) are exempt.
+      - linters: [staticcheck]
+        text: '^ST1005:'
+        source: 'fmt\.Errorf\("[A-Z][A-Za-z0-9_]*: '
diff --git a/.goreleaser.yaml b/.goreleaser.yaml
index f77a5b36..80c82978 100644
--- a/.goreleaser.yaml
+++ b/.goreleaser.yaml
@@ -3,10 +3,14 @@ version: 2
 project_name: easyp
 
 builds:
-  - binary: easyp
+  - id: easyp
+    binary: easyp
     main: ./cmd/easyp/
     flags:
       - -trimpath
+    ldflags:
+      - -s -w
+      - -X github.com/easyp-tech/easyp/internal/version.releaseVersion={{ if .IsSnapshot }}{{ .Version }}{{ else }}{{ .Tag }}{{ end }}
     env:
       - CGO_ENABLED=0
     goos:
@@ -22,6 +26,36 @@ builds:
       - 7
     gomips:
       - hardfloat
+    ignore:
+      - goos: windows
+        goarch: arm
+
+  - id: easyp-mcp
+    binary: easyp-mcp
+    main: ./cmd/easyp-mcp/
+    flags:
+      - -trimpath
+    ldflags:
+      - -s -w
+      - -X github.com/easyp-tech/easyp/internal/version.releaseVersion={{ if .IsSnapshot }}{{ .Version }}{{ else }}{{ .Tag }}{{ end }}
+    env:
+      - CGO_ENABLED=0
+    goos:
+      - darwin
+      - windows
+      - linux
+    goarch:
+      - amd64
+      - arm64
+      - arm
+    goarm:
+      - 6
+      - 7
+    gomips:
+      - hardfloat
+    ignore:
+      - goos: windows
+        goarch: arm
 
 archives:
   - formats:
@@ -61,6 +95,8 @@ changelog:
 
 release:
   skip_upload: false
+  prerelease: true
+  make_latest: false
   github:
     owner: easyp-tech
     name: easyp
@@ -72,12 +108,12 @@ source:
   name_template: '{{ .ProjectName }}-{{ .Version }}-source'
 
 dockers_v2:
-  - images:
+  - ids:
+      - easyp
+    images:
       - "ghcr.io/easyp-tech/easyp"
-#      - "{{ .Env.DOCKERHUB_IMAGE }}"
     tags:
       - "{{ .Tag }}"
-      - "latest"
     dockerfile: Dockerfile
     platforms:
       - linux/amd64
@@ -92,6 +128,7 @@ dockers_v2:
     sbom: false
     flags:
       - "--provenance=false"
+      - "--build-arg=RELEASE_VERSION={{ if .IsSnapshot }}{{ .Version }}{{ else }}{{ .Tag }}{{ end }}"
     extra_files:
       - go.mod
       - go.sum
@@ -99,24 +136,3 @@ dockers_v2:
       - internal
       - mcp
       - wellknownimports
-
-brews:
-  - description: Easy modern protobuf tooling for all your needs.
-    homepage: https://easyp.tech
-    skip_upload: false
-    repository:
-      owner: easyp-tech
-      name: homebrew-tap
-    commit_author:
-      name: easyp-tech-releaser
-      email: action@github.com
-    directory: Formula
-    install: |
-      bin.install "easyp"
-      output = Utils.popen_read("#{bin}/easyp completion bash")
-      (bash_completion/"easyp").write output
-      output = Utils.popen_read("#{bin}/easyp completion zsh")
-      (zsh_completion/"_easyp").write output
-      prefix.install_metafiles
-    test: |
-      system "#{bin}/easyp --version"
diff --git a/.spec/ARCHITECTURE.md b/.spec/ARCHITECTURE.md
new file mode 100644
index 00000000..97317cec
--- /dev/null
+++ b/.spec/ARCHITECTURE.md
@@ -0,0 +1,115 @@
+<!-- generated: 2026-09-30, template: core.md -->
+# EasyP Architecture
+
+EasyP v1 separates CLI composition, module operations, generation preparation, and execution. The CLI entry point is <code>cmd/easyp</code>; configuration contracts live in <code>internal/config/v1</code>.
+
+## Responsibilities and dependencies
+
+| Component | Responsibility and owned state | Dependencies |
+|-----------|--------------------------------|--------------|
+| <code>internal/api</code> | Flags, process paths/environment, adapter construction, policy command orchestration, output and exit status | Module/generation operations, configuration, rules, core, concrete adapters |
+| <code>internal/modules</code> | Dependency selection, lock validation, source roots and ownership, manifest edits, coordinated project-file updates | V1 models, <code>Source</code>/<code>Cache</code> contracts, metadata reader, filesystem |
+| <code>internal/adapters/gitmodules</code> | Git candidates/revisions, checkout lifetime, persistent object cache and locking, tracked-file hashes and installation | System Git, <code>module_config</code>, module contracts, filesystem |
+| <code>internal/adapters/module_config</code> | Adapt repository metadata into a named module and import roots | Native <code>protobuf.mod</code> parser, legacy EasyP and Buf readers |
+| <code>internal/migration</code> | Preview plans, legacy conversion, integrity verification gates, backups and rollback | V1 models, module resolution, explicit migration repository, filesystem |
+| <code>internal/workspace</code> | Repository boundary and ancestor/module/config discovery | Filesystem |
+| <code>internal/schemagen</code> | Write versioned JSON Schemas for YAML configs and latest aliases | V1 schema builder, filesystem |
+| <code>internal/generation</code> | Discover generator configs, inherit options, select modules, translate to engine options, run generation | V1 models, module source operations, core, logger |
+| <code>internal/core</code> | Proto parsing/compilation, managed descriptors, plugin execution, lint and breaking engines | Explicit roots/options, rules, plugin executors and Git tree walker |
+| <code>internal/fs/fs</code> | Directory walking, exclusive regular-file copy, temporary-file replacement | OS filesystem |
+
+<code>modules</code>, <code>generation</code>, and the infrastructure adapters do not import the CLI package. Neither module operations nor generation require <code>*cli.Context</code>. The CLI resolves <code>EASYPPATH</code> and supplies a cache instance; only the Git adapter knows its on-disk layout.
+
+## Dependency operations
+
+<code>modules.Resolve(ctx, module, source, pins)</code> owns version selection and traversal. <code>Source.Fetch</code> returns module metadata and its reproducible lock entry. The resolver does not run Git, manage checkout paths, or install files. Repeated source/version requests reuse fetched metadata; versionless requirements retain existing pins during tidy. Output lock entries are sorted by source.
+
+The contracts reflect actual consumers:
+
+- <code>Source</code>: fetch revision metadata for graph resolution.
+- <code>Cache</code>: install/verify a lock and read installed module metadata.
+- <code>Repository</code>: source plus cache for <code>Get</code> and <code>Tidy</code>.
+- <code>VersionedRepository</code>: also list versions for <code>Update</code>.
+
+<code>Download</code> and <code>Vendor</code> need only <code>Cache</code>. The Git adapter implements these contracts. Unit tests use explicit fake answers/errors without Git; adapter and integration tests retain local repository fixtures.
+
+Git dependencies can carry BSR requests from Buf configs and locks. The Git adapter passes them to <code>modules.BSRResolver</code>, records their pinned Git targets and provenance on the parent lock entry, and exposes ordinary requirements to the graph. The current explicit compatibility snapshots are selected in <code>api.moduleCache</code>, shared by module commands and migration; a Service backend replaces that injected implementation. Cached/frozen reads replay recorded bindings without consulting the backend. See [BSR resolution and limitations](config/dependency.md#bsr-compatibility-snapshots).
+
+~~~text
+get / mod tidy / mod update
+  -> read manifest and relevant pins
+  -> Resolve through Source
+  -> Cache.Install and cached metadata
+  -> roots, collisions and unresolved-import checks
+  -> compute manifest edits and lock
+  -> persist project files
+
+mod download
+  -> read manifest and lock
+  -> validate requirements before installation
+  -> install and verify transitive cached metadata
+
+mod vendor
+  -> validate/ensure locked sources and collisions
+  -> copy into temporary directory
+  -> replace easyp_vendor, restoring the old directory on replacement failure
+~~~
+
+<code>protobuf.mod</code> uses native directives parsed by <code>v1.ParseModule</code>; <code>protobuf.lock</code> uses strict v1 YAML. Dependencies come from the manifest, not generation inputs. Manifest editing preserves comments and formatting. <code>writeV1ResolvedFiles</code> owns the order of manifest/lock updates and restores the original manifest when lock replacement fails. Restoration errors are returned together with the original error. Each file is replaced through a temporary file; the pair is **not** a filesystem transaction or a crash-atomic update.
+
+## Source roots and ownership
+
+<code>modules.ModuleSources</code> resolves roots relative to the module directory and validates their directories. <code>SourceRoots</code> carries both physical paths and module identities. Local replacements precede locked sources in <code>EnsureSources</code>; source order is preserved.
+
+<code>EnsureLockedSources</code> may install dependencies. <code>ReadManifest</code>, <code>ReadLock</code>, <code>LocalSources</code>, and <code>CachedSources</code> do not download or rewrite project files. <code>CachedSources</code> assumes installation/hash verification has already occurred.
+
+Generation, policy commands, and module operations share root/collision checks. <code>WalkProtoFiles</code> owns dependency-source traversal, including exclusion of hidden directories, vendored sources and nested module boundaries. Generator discovery and policy ancestor traversal remain separate: their inclusion and inheritance rules differ.
+
+Nested protobuf module roots are rebased by <code>module_config</code> from the nested manifest directory into the checkout directory. Import names remain relative to those roots; repository/module prefixes do not become part of an import.
+
+The Git cache lives beneath the CLI-supplied EasyP directory in <code>v1/git</code>; <code>internal/adapters/gitmodules/object_cache.go</code> maintains reusable bare object repositories with OS locks. <code>Cache.Cached</code> reads installed metadata; <code>Install</code> supplies content verification before cached metadata is trusted.
+
+Local replacements use an ephemeral main-module overlay graph and never alter the shared lock. Tidy validates the overlay; get/update may edit explicit manifest requirements. Vendor copies the effective local graph without touching the lock. Explicit frozen operation verifies existing native manifests and locked graphs; automatic unknown-import-to-module discovery is intentionally not implemented.
+
+## Generation
+
+~~~text
+api.Generate.Action: flags + cwd + cache
+  -> generation.Run(context, logger, cache, Request)
+  -> discover configs / inherit generation options
+  -> select sibling, workspace, replacement or locked module
+  -> ensure sources and reject import collisions
+  -> translate v1 config to core.Options
+  -> core.New(complete options)
+  -> Core.PrepareGeneration for each selected target
+  -> compiled graph / managed mode / optional descriptor-export validation
+  -> GenerationPlan.ExecuteInto shared GenerateBucket
+  -> generated output / optional descriptor output
+~~~
+
+<code>internal/generation/config.go</code> owns translation to engine types, including output locations and managed-option priority. Managed rule slices are independently constructed for each module. <code>core.New</code> receives and copies import roots and file-module mappings; there are no follow-up <code>SetImportRoots</code>/<code>SetFileModules</code> calls.
+
+<code>Request.WorkDir</code> controls discovery, relative descriptor output and local plugin execution. Plugin output remains relative to the generator config. Default discovery chooses the nearest ancestor generator within the workspace; repeatable <code>--project</code> selects consumers explicitly and <code>--all</code> enables recursive discovery. Generation builds no unrelated lint rules. Only generation options inherit; plugins and module selections remain local to the consumer.
+
+## Policy and validation commands
+
+Lint/breaking CLI adapters select producer policy and prepare shared module import roots before constructing the engine. <code>buildCore</code> in <code>internal/api/runtime.go</code> constructs only lint/breaking engines. <code>core.Options</code> carries <code>AllowCommentIgnores</code> and <code>KnownLintRules</code> per engine; comment directives are parsed and applied to findings by <code>internal/core/comment_suppressions.go</code>. Breaking comparisons use historical Git trees and the baseline-specific roots prepared by the API layer.
+
+<code>validate-config</code> calls <code>config/v1.ValidatePath</code>; recursive file discovery and structured YAML validation belong to that package. <code>internal/schemagen</code> writes schemas from <code>v1.SchemaJSON</code>; <code>mcp/easypconfig</code> exposes the same model to MCP clients. The generated pairs are <code>schemas/easyp-v1.schema.json</code> / <code>schemas/easyp.schema.json</code>, <code>schemas/easyp.gen-v1.schema.json</code> / <code>schemas/easyp.gen.schema.json</code>, and <code>schemas/protobuf.lock-v1.schema.json</code> / <code>schemas/protobuf.lock.schema.json</code>. The native manifest is not a YAML schema target.
+
+<code>linters.extends</code> and <code>breaking.extends</code> resolve section-scoped bases through <code>internal/policy</code> and verified consumer module graphs. Local references are bounded; validation is cache-only. <code>generate.packages</code> selects exact protobuf package names before compilation. Explicit FILE/PACKAGE/WIRE_JSON/WIRE profiles compare compiled descriptors; omitted or empty categories default to FILE for v1 policies. Policy parsing and both policy conversions share semantic checks in <code>internal/config/v1/policy_semantics.go</code>; native policy/generator parsers also validate expanded YAML against the schema. Structured validation returns diagnostics through its own entry point.
+
+## Migration
+
+<code>internal/api/migrate.go</code> selects flag-only preview or the terminal wizard in <code>internal/api/migrate_interactive.go</code>. The wizard asks for directory and module identity, displays a preview, obtains separate consent for dependency/cache access when needed, then confirms applying the displayed plan. <code>--module</code> selects a noninteractive preview unless interactive mode is explicitly requested.
+
+<code>migration.Build</code> owns legacy conversion into policy, generator, manifest and lock candidates. Dependency verification uses an explicitly supplied migration repository and is gated by <code>ResolveLock</code>; conversion never executes plugins. <code>Plan.Apply</code> rechecks observed state, stages files and byte-identical backups, and rolls back ordinary write failures. Legacy <code>easyp.lock</code> stays unchanged; native output conflicts require manual reconciliation. This is not a crash-atomic multi-file transaction.
+
+## Verification boundaries
+
+- Resolver, version selection, config conversion, manifest editing and collision rules: parallel table-driven unit tests.
+- Git/checkouts/hash verification and filesystem replacement: temporary local repositories/directories.
+- CLI: retained integration tests for get/tidy/download/update/vendor, nested modules, policies and error propagation. Cases changing environment/cwd run sequentially.
+- Generation: explicit working directories and cache dependencies allow parallel execution without CLI/environment setup.
+
+See [dependency management](config/dependency.md) for the v1 module contract and [package reference](PACKAGES.md) for file ownership.
diff --git a/.spec/CLI.md b/.spec/CLI.md
new file mode 100644
index 00000000..ea77e63f
--- /dev/null
+++ b/.spec/CLI.md
@@ -0,0 +1,363 @@
+<!-- generated: 2026-09-30, template: cli.md -->
+
+# EasyP CLI
+
+## Overview
+
+EasyP is a Protocol Buffers CLI for linting, compatibility checks, code generation, and Git-based dependency management. The entry point is [cmd/easyp/main.go](../cmd/easyp/main.go); handlers use <code>urfave/cli/v2</code> and implement [api.Handler](../internal/api/interface.go).
+
+Build a local binary and run the usual checks from a configured project:
+
+~~~bash
+go build -o easyp ./cmd/easyp
+easyp lint --path .
+easyp generate
+~~~
+
+The native v1 files have separate roles: <code>protobuf.mod</code> declares module identity, roots, and dependencies; <code>protobuf.lock</code> records resolved Git dependencies; <code>easyp.yaml</code> defines producer lint/breaking policy; <code>easyp.gen.yaml</code> defines consumer generation. Legacy configuration requires explicit migration.
+
+## Command Tree
+
+These handlers and aliases are registered by the application:
+
+~~~text
+easyp
+├── lint (l)                         Lint Protocol Buffer files
+├── generate (g)                     Generate selected consumer projects
+├── breaking                         Check API compatibility against Git
+├── get                              Add or promote a direct Git module requirement
+├── mod (m)                          Manage protobuf.mod / protobuf.lock
+│   ├── download                     Install the exact locked dependencies
+│   ├── update                       Update compatible versions / versionless HEAD
+│   ├── tidy                         Resolve requirements and write the lock
+│   └── vendor                       Copy locked sources into easyp_vendor
+├── init (i)                         Initialize the three v1 project files
+├── migrate                          Preview or apply v0-to-v1 migration
+├── ls-files (ls)                    List module sources and reachable imports
+├── validate-config (validate)       Validate one file or a directory tree
+├── schema-gen                       Generate six v1 JSON Schema artifacts
+└── completion
+    ├── bash                         Print Bash completion script
+    └── zsh                          Print Zsh completion script
+~~~
+
+The framework also provides help and <code>--version</code>; there is no registered standalone <code>version</code> command.
+
+## Global Flags
+
+| Flag | Type | Default | Environment variable | Meaning |
+|---|---|---|---|---|
+| <code>--cfg</code>, <code>--config</code> | string | <code>easyp.yaml</code> | <code>EASYP_CFG</code> | Explicit policy path for lint/breaking, or validation target. Discovery applies when unset. |
+| <code>--debug</code>, <code>-d</code> | bool | <code>false</code> | <code>EASYP_DEBUG</code> | Enable debug logs. |
+| <code>--format</code>, <code>-f</code> | enum | <code>text</code> in flag definition | <code>EASYP_FORMAT</code> | Select <code>text</code> or <code>json</code> for commands supporting structured output. |
+| <code>--frozen</code> | bool | <code>false</code> | — | Require the selected native manifest and locked graph without dependency re-resolution or manifest/lock writes. |
+| <code>--version</code> | bool | <code>false</code> | — | Framework version output from <code>internal/version</code>. |
+| <code>--help</code> | bool | <code>false</code> | — | Framework help. |
+
+The application registers config, debug, format, and frozen; their definitions are in [internal/flags/flags.go](../internal/flags/flags.go) and [frozen.go](../internal/flags/frozen.go). Config is optional. Put global flags before the command; <code>ls-files</code> also registers format locally, and <code>validate-config</code> registers both config and format locally. <code>flags.GetFormat</code> in [internal/flags/format.go](../internal/flags/format.go) selects the nearest explicitly set format, including an explicit global or environment value. Without an explicit selection, lint/breaking use text and ls-files/validate-config use JSON.
+
+## Frozen dependency mode
+
+<code>--frozen</code> is explicit and defaults to false; <code>CI=true</code> never enables it. Put it before the command, or directly on <code>generate</code>, <code>lint</code>, <code>breaking</code>, <code>ls-files</code>, <code>get</code>, <code>init</code>, or <code>migrate</code>. Module commands accept it on <code>mod</code> or its <code>download</code>, <code>tidy</code>, <code>vendor</code>, and <code>update</code> subcommands. A true value anywhere in the command lineage enables frozen mode; a child <code>--frozen=false</code> cannot disable a parent's true value.
+
+~~~bash
+easyp --frozen generate
+easyp generate --frozen --project services/backend
+easyp mod --frozen download
+easyp mod download --frozen
+easyp lint --frozen --path proto
+easyp breaking --frozen --against main
+easyp ls-files --frozen
+~~~
+
+Every selected native module whose dependency graph is used must have both <code>protobuf.mod</code> and <code>protobuf.lock</code>, including an empty lock for a module with no dependencies. Plain source directories without a manifest are rejected. All root <code>replace</code> directives, including unused entries, are rejected before accessing their targets or fetching dependencies. The shared validation checks direct and transitive requirements against the lock and rejects missing, invalid, incomplete, or stale graphs.
+
+Frozen operations preserve manifest and lock bytes and do not resolve dependency versions, query HEAD/tags, or update requirements. They may fill the cache using exact locked commits and verify content hashes on both cold and warm caches. Frozen mode is not offline; cache fills and configured remote plugins can require network access.
+
+<code>mod download</code> validates and installs the locked graph. <code>mod vendor</code> validates it before copying sources into <code>easyp_vendor</code>. <code>mod tidy</code>, <code>get</code>, <code>mod update</code>, and <code>init</code> refuse frozen execution; <code>migrate</code> also refuses it, including preview and interactive mode. Prepare or refresh the manifest/lock explicitly outside frozen mode.
+
+Generation validates every selected graph before any plugin executes, including descriptor-only runs. An explicit workspace-relative module path uses that module's manifest and lock; a directory containing only <code>easyp.gen.yaml</code> does not need a separate pair. For example, <code>backend/easyp.gen.yaml</code> selecting <code>proto/user</code> validates <code>proto/user/protobuf.mod</code> and <code>proto/user/protobuf.lock</code>. A dependency selected by identity still requires its consumer's manifest and lock, and does not need its own lock inside the downloaded directory. Unselected projects are ignored; frozen does not broaden <code>--project</code> or <code>--all</code> selection or change their plugin authorization. Lint keeps effective policy scoping. Breaking validates current and historical graphs with their own manifests and locks; the baseline never borrows the current lock. <code>ls-files --include-imports=false</code> still enforces frozen graph validation even though it lists only local files.
+
+## Commands Reference
+
+### <code>easyp lint [flags]</code>
+
+Lints sources with the effective v1 policy. Flags come from [internal/api/lint.go](../internal/api/lint.go).
+
+| Flag | Type | Default | Meaning |
+|---|---|---|---|
+| <code>--path</code>, <code>-p</code> | string | <code>.</code> | Source path relative to the operation root. The definition is marked required but its default is already marked set, so an explicit argument is optional. |
+| <code>--root</code>, <code>-r</code> | string | selected policy's directory | Override the operation root; a relative value is resolved from the working directory. |
+
+~~~bash
+easyp lint --path proto
+easyp --format json lint --path api
+~~~
+
+Policy discovery starts at the working directory or the explicit root; see Configuration below. Descendant policies apply to their sources. Module roots and native module dependencies provide imports. Findings go to stdout: text uses <code>path:line:column:source message (rule)</code>; JSON emits one issue object per line, rather than one array.
+
+### <code>easyp generate [flags]</code>
+
+Generates according to the selected <code>easyp.gen.yaml</code> files. [internal/api/generate.go](../internal/api/generate.go) registers these generation flags, plus the shared <code>--frozen</code> flag:
+
+| Flag | Type | Default | Meaning |
+|---|---|---|---|
+| <code>--project</code> | repeatable string | nearest ancestor generator | Select a consumer project directory containing <code>easyp.gen.yaml</code>; relative paths start at the working directory. |
+| <code>--all</code> | bool | <code>false</code> | Recursively select generation projects below the working directory; exclusive with <code>--project</code>. |
+| <code>--workspace</code> | string | discovered workspace boundary | Set the root for repository-relative module selectors and bounded ancestor lookup; it must contain the working directory. |
+| <code>--descriptor_set_out</code> | string | empty | Write one combined binary <code>FileDescriptorSet</code>. |
+| <code>--descriptor_set_out_dir</code> | string | empty | Write one binary descriptor set per selected project/module; exclusive with <code>--descriptor_set_out</code>. |
+| <code>--include_imports</code> | bool | <code>false</code> | Include transitive dependencies in exported descriptor sets. |
+
+~~~bash
+easyp generate
+easyp generate --project services/backend --project services/frontend
+easyp generate --all --descriptor_set_out_dir descriptors --include_imports
+easyp generate --project services/backend --descriptor_set_out descriptors.pb
+~~~
+
+Automatic selection finds the nearest ancestor generator within the workspace boundary. It does not recursively execute all generators; use <code>--all</code> for that. Recursive discovery skips hidden directories, <code>easyp_vendor</code>, <code>node_modules</code>, and nested Git repositories. The global config flag does not select a generator. This command has no <code>--path</code>, <code>--root</code>, or <code>EASYP_ROOT_GENERATE_PATH</code> input.
+
+Generation targets come from <code>generate.modules</code>, or from the local module enclosing the selected generator when the list is empty. Native <code>protobuf.mod</code> supplies roots and dependencies; <code>generate.inputs</code> is removed. Plugin output directories are relative to the generator file. Relative descriptor destinations are relative to the working directory. Export still runs configured plugins; an empty plugin list permits descriptor-only export.
+
+All selected descriptor graphs are prepared before plugin execution. A single combined export rejects conflicting definitions with the same import path; separate per-project/module exports retain independent graphs. See [descriptor exports](config/descriptor-export.md) for stable filenames and output guarantees, and the implementations in [internal/generation/discovery.go](../internal/generation/discovery.go), [selection.go](../internal/generation/selection.go), and [descriptor_set.go](../internal/generation/descriptor_set.go).
+
+### <code>easyp breaking [flags]</code>
+
+Checks compatibility against a Git revision. Flags and exit handling are in [internal/api/breaking_check.go](../internal/api/breaking_check.go).
+
+| Flag | Type | Default | Meaning |
+|---|---|---|---|
+| <code>--path</code>, <code>-p</code> | string | <code>.</code> | Source path relative to the operation root; shares lint's already-set default. |
+| <code>--against</code> | string | <code>master</code> fallback | Explicit Git ref overrides <code>breaking.baseline</code>; an explicitly empty value is an error. |
+| <code>--root</code>, <code>-r</code> | string | selected policy's directory | Override the operation root. |
+
+~~~bash
+easyp breaking --path proto --against main
+easyp --format json breaking --against HEAD~1
+~~~
+
+Without an explicit <code>--against</code>, the effective policy's <code>breaking.baseline</code> wins, with its required <code>git:</code> prefix removed; only an empty baseline falls back to <code>master</code>. Nonempty policy baselines must use <code>git:&lt;ref&gt;</code>, while the CLI flag accepts the raw ref. The v0 <code>breaking_check.against_git_ref</code> YAML key is obsolete. Findings use lint's text/JSON formats.
+
+Current and baseline sources use their own module manifests and locks. Descendant policies and <code>breaking.ignore</code> are evaluated with policy ownership; ignore paths are relative to the policy file. Explicit FILE/PACKAGE/WIRE_JSON/WIRE profiles compare linked descriptors; omitted or empty categories default to FILE for v1 policies. See [breaking-profiles.md](config/breaking-profiles.md). <code>breaking.ignore_unstable</code> is supported. Section-scoped <code>extends</code> uses bounded local policies or verified consumer dependencies. See [internal/api/breaking_v1.go](../internal/api/breaking_v1.go), [breaking_scope.go](../internal/api/breaking_scope.go), and [breaking_ignore.go](../internal/api/breaking_ignore.go).
+
+### <code>easyp get &lt;module&gt;[@version|@tag|@commit]</code>
+
+Adds a new direct requirement or promotes an existing indirect requirement, then resolves its transitive dependencies and writes <code>protobuf.mod</code> and <code>protobuf.lock</code>. Exactly one positional module argument is required; the shared <code>--frozen</code> flag is registered in [internal/api/get_v1.go](../internal/api/get_v1.go).
+
+An explicit query accepts a semantic version, named Git tag or full Git commit. Named tags are resolved into full commit pins in the manifest and lock; a branch name is not a tag. Module identities use Go major suffixes: v0/v1 are unsuffixed, v2+ uses matching <code>/vN</code>. For unsuffixed legacy repositories, get automatically marks verified pre-native v2+ releases with <code>+incompatible</code>; it cannot bypass a native manifest. See [major versions and Git mapping](config/dependency.md#major-versions-and-git-mapping). A new requirement without a suffix resolves Git HEAD. Repeating an existing requirement without a suffix preserves its specified version. Module lookup starts at the working directory and searches upward within the workspace.
+
+~~~bash
+easyp get github.com/googleapis/googleapis
+easyp get github.com/googleapis/googleapis@common-protos-1_3_1
+easyp get github.com/acme/contracts@v1.2.3
+~~~
+
+### <code>easyp mod &lt;subcommand&gt;</code>
+
+The <code>mod</code> parent and all four subcommands accept <code>--frozen</code>. They use the nearest ancestor <code>protobuf.mod</code> found within the workspace, not a YAML dependency list or an unconditional current-directory root. Registration is in [internal/api/mod.go](../internal/api/mod.go); lookup is in [module_root.go](../internal/api/module_root.go).
+
+| Subcommand | Behavior |
+|---|---|
+| <code>download</code> | Read the existing lock, validate remote requirements against it, and install/verify its exact pinned dependencies in the cache. A missing lock reports that tidy is required. |
+| <code>update</code> | Advance tagged requirements within their current major version, refresh versionless requirements to HEAD, retain explicit commit pins, and rewrite manifest/lock resolution. Stable versions skip prerelease upgrades. |
+| <code>tidy</code> | Resolve manifest requirements and transitive requirements, check import collisions/unresolved imports, update manifest requirements, and write exact commits/content hashes to the lock. Existing versionless pins are preserved. |
+| <code>vendor</code> | Copy verified locked dependency proto files into <code>easyp_vendor</code>, replacing that directory through staging/backup handling. |
+
+~~~bash
+easyp mod tidy
+easyp mod download
+easyp mod update
+easyp mod vendor
+~~~
+
+Outside frozen mode, with local replacements, <code>tidy</code> validates the ephemeral effective graph without writing manifest or lock. <code>get</code>/<code>update</code> may edit explicit requirements, but all operations preserve an existing lock byte-for-byte and do not create a local-graph lock. <code>vendor</code> copies the effective graph without changing the lock. Unknown imports are reported; automatic import-to-Git discovery is intentionally excluded. See [Dependency Management](config/dependency.md).
+
+### <code>easyp init [flags]</code>
+
+Initializes <code>protobuf.mod</code>, <code>easyp.yaml</code>, and <code>easyp.gen.yaml</code>. The policy starts with <code>linters.default: STANDARD</code> and <code>breaking.baseline: git:main</code>; generation starts with <code>plugins: []</code>. It does not create a lock or prompt for lint rule groups.
+
+| Flag | Type | Default | Meaning |
+|---|---|---|---|
+| <code>--dir</code>, <code>-d</code> | string | <code>.</code> | Directory to initialize; also set by <code>EASYP_INIT_DIR</code>. |
+| <code>--module</code> | string | inferred or prompted | Canonical module identity. |
+
+Identity precedence is explicit <code>--module</code>, an existing native manifest, workspace Git identity, then an interactive prompt. Git inference applies when the target is the repository root and derives the identity from the literal <code>remote.origin.url</code>, before any transport URL rewrite. The result is validated as one module identity before preparing the manifest. Different existing file contents require individual overwrite confirmation; all choices are collected before writing. Identical files remain unchanged. Existing <code>buf.yaml</code> or <code>buf.yml</code> is rejected because Buf-to-Git dependency mapping is not implemented.
+
+Prompts require both input and output to be terminals. Noninteractive initialization works with an explicit or inferred valid identity and no required overwrite confirmations; missing identity or a conflicting existing file returns an error instead of opening a controlling terminal.
+
+~~~bash
+easyp init --dir . --module github.com/acme/contracts
+~~~
+
+See [internal/api/init.go](../internal/api/init.go), [init_v1.go](../internal/api/init_v1.go), [init_prompt.go](../internal/api/init_prompt.go), and [gitmodules/identity.go](../internal/adapters/gitmodules/identity.go).
+
+### <code>easyp migrate [flags]</code>
+
+Prepares actual v1 candidates from legacy configuration without executing plugins. Positional arguments are rejected. The command and wizard are in [internal/api/migrate.go](../internal/api/migrate.go), [migrate_interactive.go](../internal/api/migrate_interactive.go), and [migrate_prompt.go](../internal/api/migrate_prompt.go).
+
+| Flag | Type | Default | Meaning |
+|---|---|---|---|
+| <code>--dir</code> | string | <code>.</code> | Directory containing legacy <code>easyp.yaml</code>. |
+| <code>--module</code> | string | unset | Canonical local module identity; required in flag-only mode. |
+| <code>--interactive</code> | bool | automatic on a terminal without explicit module | Request the terminal wizard; <code>--interactive=false</code> disables automatic prompting. |
+| <code>--resolve-lock</code> | bool | <code>false</code> | In flag-only mode, authorize dependency resolution/integrity verification and cache writes, including during preview. |
+| <code>--write</code> | bool | <code>false</code> | In flag-only mode, apply validated candidates with historical backups. |
+
+The wizard requires both input and output to be terminals. It collects missing directory/identity values, displays an initial local preview, separately asks for dependency/cache access if required, displays the verified preview, and asks before applying files. Enter means no for both confirmations; prefilled flags never bypass them. EOF is cancellation, not consent. Explicit <code>--module</code> preserves flag-only preview unless interactive mode is explicitly requested.
+
+~~~bash
+easyp migrate
+easyp migrate --dir . --module github.com/acme/contracts
+easyp migrate --dir . --module github.com/acme/contracts --resolve-lock --write
+~~~
+
+Flag-only invocation previews without file writes unless <code>--write</code> is supplied. If dependency integrity checks are required, application remains blocked until <code>--resolve-lock</code> authorizes them. Existing native outputs are not overwritten with conflicting candidates; legacy replaced files receive <code>.v0.bak</code> backups and <code>easyp.lock</code> is retained unchanged. Legacy <code>version</code> metadata such as <code>v1alpha</code> is accepted and omitted with a warning; <code>deps: null</code> means an empty dependency list. Keys that the v0 parser ignored are also omitted with source-path warnings instead of being assigned invented v1 semantics, while the byte-identical v0 backup preserves them. Known fields with invalid or ambiguous values still block migration. The plan rechecks observed files before applying and rolls back ordinary write failures, but multiple replacements are not process-crash atomic. See [internal/migration/migration.go](../internal/migration/migration.go), [apply.go](../internal/migration/apply.go), and [migration review context](config/review-migration-and-polish.md).
+
+### <code>easyp ls-files [flags]</code>
+
+Lists sources from the working directory's native manifest, or a default local <code>.</code> root if that directory has no manifest. Unlike <code>mod</code>/<code>get</code>, this handler does not search upward for a module. The global config flag does not choose its root.
+
+| Flag | Type | Default | Meaning |
+|---|---|---|---|
+| <code>--include-imports</code>, <code>-I</code> | bool | <code>true</code> | Include reachable imports from dependency roots and embedded well-known protos. |
+| <code>--format</code>, <code>-f</code> | enum | <code>json</code> when unset | Command-local registration of the shared format flag. |
+
+~~~bash
+easyp ls-files
+easyp ls-files --include-imports=false --format text
+~~~
+
+JSON is one indented object with <code>files</code>, <code>roots</code>, and optional <code>errors</code>. Each file contains <code>abs_path</code>, <code>import_path</code>, <code>source</code>, and <code>root</code>. Text prints tab-separated <code>import_path</code>, <code>source</code>, and <code>abs_path</code> to stdout, plus collected errors to stderr; it does not print the roots table. Sources are <code>workspace</code>, <code>dependency</code>, or <code>wellknown</code>. Embedded well-known paths use the synthetic <code>/wellknownimports</code> prefix, not a host directory.
+
+After printing the report, collected parse/import errors return <code>cli.Exit(..., 1)</code> with an error count. Both JSON and text reports therefore produce status 1 when their error collection is nonempty. Setup, cache, indexing, and output-write failures also return errors. Source: [internal/api/ls_files_v1.go](../internal/api/ls_files_v1.go).
+
+### <code>easyp validate-config [flags]</code>
+
+Recursively validates <code>easyp.yaml</code>, <code>easyp.gen.yaml</code>, <code>protobuf.mod</code>, and <code>protobuf.lock</code> below the current directory. An explicit config argument or environment value chooses one file or a directory instead. Directory scanning reports an error if no recognized configuration files are found.
+
+| Flag | Type | Default | Meaning |
+|---|---|---|---|
+| <code>--cfg</code>, <code>--config</code> | string | current directory when unset | Command-local registration of the global config selector. |
+| <code>--format</code>, <code>-f</code> | enum | <code>json</code> when unset | Command-local registration of the shared format selector. |
+
+~~~bash
+easyp validate-config --config easyp.yaml
+easyp validate-config --format text
+easyp --format text validate-config --config ./services
+~~~
+
+The default JSON object contains <code>valid</code> and optional <code>errors</code>/<code>warnings</code>. Text begins with <code>VALID: true</code> or <code>VALID: false</code>, followed by issue tables when present. Invalid reports return <code>ErrHasValidateIssue</code> after printing, giving process status 1. Validation checks configuration structure and supported semantics; it does not install dependencies or execute generators. Read [internal/api/validate.go](../internal/api/validate.go), [internal/config/v1/validate.go](../internal/config/v1/validate.go), and [validate_path.go](../internal/config/v1/validate_path.go) for the current checks.
+
+### <code>easyp schema-gen [flags]</code>
+
+Generates the versioned schemas and latest aliases for policy YAML, generator YAML, and lock YAML.
+
+| Flag | Type | Default | Meaning |
+|---|---|---|---|
+| <code>--out-dir</code> | string | <code>schemas</code> | Output directory for all six artifacts. |
+
+~~~bash
+easyp schema-gen
+easyp schema-gen --out-dir /tmp/easyp-schemas
+~~~
+
+[internal/schemagen/schemagen.go](../internal/schemagen/schemagen.go) writes exactly:
+
+- [schemas/easyp-v1.schema.json](../schemas/easyp-v1.schema.json) and [schemas/easyp.schema.json](../schemas/easyp.schema.json).
+- [schemas/easyp.gen-v1.schema.json](../schemas/easyp.gen-v1.schema.json) and [schemas/easyp.gen.schema.json](../schemas/easyp.gen.schema.json).
+- [schemas/protobuf.lock-v1.schema.json](../schemas/protobuf.lock-v1.schema.json) and [schemas/protobuf.lock.schema.json](../schemas/protobuf.lock.schema.json).
+
+<code>protobuf.mod</code> uses its native parser, not a generated JSON Schema. Edit types/schema construction under [internal/config/v1](../internal/config/v1), then regenerate artifacts; do not hand-edit the generated files.
+
+### <code>easyp completion &lt;shell&gt;</code>
+
+Only Bash and Zsh subcommands are registered. They take no command-specific flags and print a script to stdout. Dynamic suggestions use the framework's <code>--generate-bash-completion</code> support.
+
+~~~bash
+easyp completion bash > "$(brew --prefix)/etc/bash_completion.d/easyp"
+easyp completion zsh > "${fpath[1]}/_easyp"
+~~~
+
+These shell-specific examples assume an existing completion installation and writable destination. Source: [internal/api/completion.go](../internal/api/completion.go).
+
+## Configuration and Command Context
+
+Explicit config selection follows flag, then <code>EASYP_CFG</code>; relative values resolve from the working directory. The flag's nominal <code>easyp.yaml</code> default does not mean every command reads that file from the working directory:
+
+| Command | Context resolution |
+|---|---|
+| lint / breaking | Explicit config wins. Otherwise search for an ancestor policy from cwd or <code>--root</code>, then accept one unambiguous outermost descendant policy. Multiple independent policies require selection. The policy directory becomes project root; <code>--root</code> overrides the operation root. |
+| generate | Discover the nearest generator or explicitly select projects; <code>--all</code> opts into recursive discovery. <code>--workspace</code> sets its boundary. |
+| mod / get | Find the nearest ancestor native module within the workspace. |
+| ls-files | Read the working directory's manifest or use its default local root. |
+| validate-config | Scan cwd unless an explicit config selector chooses a file/directory. |
+| init / migrate | Use <code>--dir</code>. |
+
+[internal/workspace/discovery.go](../internal/workspace/discovery.go) bounds searches at the nearest Git repository. Without Git metadata, it uses the outermost EasyP ancestor below the home directory. Policy root handling is in [internal/api/roots.go](../internal/api/roots.go).
+
+| Environment variable | Meaning | Default |
+|---|---|---|
+| <code>EASYP_CFG</code> | Explicit config selection for the relevant commands | unset; command discovery applies |
+| <code>EASYP_DEBUG</code> | Debug logging | <code>false</code> |
+| <code>EASYP_FORMAT</code> | Shared explicit output format | command-specific default |
+| <code>EASYP_INIT_DIR</code> | Init directory | <code>.</code> |
+| <code>EASYPPATH</code> | Module cache root | <code>$HOME/.easyp</code> |
+
+The cache path is resolved to an absolute path by [internal/api/runtime.go](../internal/api/runtime.go). Import consumers may install missing locked sources in that cache. Native dependency declarations belong in <code>protobuf.mod</code>, not the removed generation input configuration.
+
+Current feature boundaries remain explicit: <code>generate.packages</code> selects exact protobuf names; FILE/PACKAGE/WIRE_JSON/WIRE are selectable breaking profiles. Unknown-import-to-Git-module discovery is intentionally excluded. Local replacement overlays apply in normal mode; explicit <code>--frozen</code> rejects them. Current parsing, execution, and schemas must all be consulted before documenting further support; see [policy.go](../internal/config/v1/policy.go), [generate.go](../internal/config/v1/generate.go), and [schema.go](../internal/config/v1/schema.go).
+
+## Exit Codes and Error Flow
+
+| Code | Current executable behavior |
+|---:|---|
+| 0 | Handler success, including successful reports and a wizard confirmation declined without an input error. |
+| 1 | Lint/breaking findings use explicit <code>os.Exit(1)</code>; ls-files reports collected parse/import errors before returning <code>cli.Exit(..., 1)</code>. Any ordinary error returned from <code>app.Run</code> reaches standard-library <code>log.Fatal</code>, which prints it and exits 1; this includes invalid configuration, module/cache errors, usage errors, and failed initialization/migration. |
+| 2 | Lint/breaking wrappers recognize <code>*core.OpenImportFileError</code>. Breaking also recognizes <code>*core.GitRefNotFoundError</code> and <code>core.ErrRepositoryDoesNotExist</code>. |
+
+An import-related message alone does not imply status 2. [internal/core/proto_info_read.go](../internal/core/proto_info_read.go) returns the typed missing-import error after disk, dependency roots, and embedded well-known lookup fail. Invalid paths, permission/read failures, and imported-file parse errors remain ordinary returned errors. Generation and module handlers do not use lint/breaking's status-2 switch. Keep these contracts tied to the checked-in source when changing import handling.
+
+## I/O Contracts
+
+- **stdin/terminal:** init may ask for module identity and overwrite choices through its interactive prompter, only when input and output are terminals. The migration wizard reads line-based input from the application reader (normally stdin) and also requires terminal input/output; flag-only migration accepts no stdin document.
+- **stdout:** lint/breaking findings; ls-files and validation reports; migration previews/prompts; shell completion; framework help/version. Schema generation primarily writes files.
+- **stderr:** structured text logger output (including debug records when enabled), fatal returned errors, ls-files text-mode collected errors, and its CLI exit error count for either report format.
+- **files:** init writes the three native project files; migration writes validated candidates/backups when authorized; generation writes configured plugin outputs and optional descriptors; get/tidy/update write manifest/lock results; download populates the cache; vendor writes <code>easyp_vendor</code>; schema-gen writes six schemas. Commands resolving imports may also populate the cache.
+
+~~~bash
+easyp --format json lint --path proto > lint-issues.json
+easyp ls-files --format json | jq '.files[]'
+easyp validate-config --format json > validation.json
+~~~
+
+## Troubleshooting
+
+| Message / condition | Interpretation and next step |
+|---|---|
+| <code>no selected easyp.gen.yaml</code> | Select a consumer directory with <code>--project</code>, or intentionally opt into recursive generation with <code>--all</code>. |
+| <code>multiple independent policies found</code> | Select the intended policy with global <code>--cfg</code>. |
+| Missing <code>protobuf.lock</code> during download | Resolve the manifest explicitly with <code>mod tidy</code> before downloading its pinned graph. |
+| Frozen rejects missing/stale locks or local replacements | Remove replacements and prepare the manifest/lock with <code>mod tidy</code> outside frozen mode; commit both files before retrying. |
+| Legacy configuration rejection | Use <code>migrate</code> to inspect a concrete v1 conversion; generation does not silently convert v0 inputs. |
+| <code>--interactive requires terminal input and output</code> | Run the wizard in a terminal or use explicit module/write/resolve flags for scripted migration. |
+| Conflicting descriptor in a combined export | Select a compatible project set or use <code>--descriptor_set_out_dir</code> to retain separate graphs. |
+
+## Development
+
+~~~bash
+go run ./cmd/easyp lint --path .
+go build -o easyp ./cmd/easyp
+~~~
+
+To add a command, implement <code>api.Handler.Command() *cli.Command</code>, define only its actual command flags, and register the handler in <code>buildCommand</code> in [cmd/easyp/main.go](../cmd/easyp/main.go). Shared flags and output precedence live in [internal/flags](../internal/flags). Keep command help, discovery, error behavior, and this reference aligned with the implementation.
+
+For additional reviewed behavior, see [context and generation](config/review-context-and-generation.md), [generation and baselines](config/review-generation-and-baselines.md), and [migration and reserved contracts](config/review-migration-and-polish.md). Those are retained review records; current source remains authoritative.
+
+### Shared policy references
+
+<code>linters.extends</code> and <code>breaking.extends</code> resolve independently after nearest-section cascading. See [policy-extends](config/policy-extends.md) for the file/module grammar, precedence, consumer-relative baseline/ignore behavior and non-networked validation.
+
+## MCP configuration reference
+
+<code>easyp_config_describe</code> covers all four v1 formats. <code>protobuf.mod</code> returns text grammar and examples; YAML files, including <code>protobuf.lock</code>, return their actual JSON Schemas. The reference never reads project files or resolves dependencies. See [MCP reference contract](config/mcp-module-reference.md).
diff --git a/.spec/CODE_STYLE.md b/.spec/CODE_STYLE.md
new file mode 100644
index 00000000..63ff83dc
--- /dev/null
+++ b/.spec/CODE_STYLE.md
@@ -0,0 +1,220 @@
+<!-- generated: 2026-09-30, template: core.md -->
+# EasyP Code Style
+
+This document records repository conventions from <code>AGENTS.md</code>, <code>.spec/agent-rules.md</code>, and existing source. Project rules take precedence over generic Go guidance.
+
+## Layer Structure
+
+~~~text
+cmd/easyp
+  -> internal/api              CLI handlers and composition
+    -> internal/modules        dependency operations, consumer-owned source/cache ports
+    -> internal/generation     consumer selection, engine preparation, descriptor export
+    -> internal/migration      preview, conversion, verification and file application
+    -> internal/core           lint, breaking, compilation and plugin engines
+
+internal/adapters/gitmodules   Git object/install cache and revision verification
+internal/adapters/module_config dependency metadata adaptation
+internal/adapters/plugin       local, remote, command and bundled execution
+internal/config/v1             native manifest, lock, policy, generator and schemas
+internal/config                shared/legacy engine configuration types
+internal/workspace             command context and discovery boundaries
+internal/rules                 core.Rule implementations
+internal/schemagen             generated schema artifacts
+mcp/easypconfig                 MCP config descriptions backed by v1 schemas
+~~~
+
+| Layer | Convention |
+|-------|------------|
+| CLI/API | Implement <code>api.Handler</code>, build a <code>*cli.Command</code>, parse flags, construct adapters and map known CLI outcomes. |
+| Modules | Keep source/cache contracts in <code>internal/modules</code>; receive context and explicit roots instead of CLI context or environment lookups. |
+| Generation | Convert v1 consumer config to complete <code>core.Options</code>, prepare all selected targets, then execute plugins/output. |
+| Migration | Separate immutable preview candidates from explicit dependency access and application; preserve backup and input-recheck guarantees. |
+| Core | Operate on explicit engine inputs and consumer-side interfaces; keep dependency resolution in the module layer. Core currently constructs concrete plugin/console executors. |
+| Adapters | Implement Git, cache, filesystem, plugin, console, metadata and prompt mechanics. |
+| Rules | Implement <code>core.Rule</code> in a dedicated source file with a colocated test file. |
+| Config/schema | Keep native configuration parsing/validation and schema definitions in <code>internal/config/v1</code>; generate artifacts through <code>internal/schemagen</code>. |
+
+## Public Types and Tags
+
+Exported types have Go doc comments that begin with the type name. Use the tags required by each representation. Native YAML structs use <code>yaml</code> tags; shared legacy types may also have <code>json</code> tags. Native <code>v1.Module</code> has no YAML tags because <code>protobuf.mod</code> uses a directive parser. For example, <code>internal/config/v1/plugin.go</code> defines:
+
+| <code>Plugin</code> field | Go type | YAML key |
+|-------------------------|---------|----------|
+| <code>Name</code> | <code>string</code> | <code>name</code> |
+| <code>Path</code> | <code>string</code> | <code>path</code> |
+| <code>Command</code> | <code>[]string</code> | <code>command</code> |
+| <code>Remote</code> | <code>string</code> | <code>remote</code> |
+| <code>Version</code> | <code>string</code> | <code>version</code> |
+| <code>Out</code> | <code>string</code> | <code>out</code> |
+| <code>Opts</code> | <code>PluginOptions</code> | <code>opts</code> |
+| <code>WithImports</code> | <code>bool</code> | <code>with_imports</code> |
+
+Preserve native field spellings: YAML includes snake_case names such as <code>with_imports</code> and hyphenated keys such as <code>linters-settings</code> and <code>exclude-rules</code>. Do not rename established keys to satisfy a generic style preference. Keep types unexported when their scope is local; exported domain/config entities and adapter implementations use exported names.
+
+## Conversion Boundaries
+
+Conversion belongs to the workflow that owns it. <code>buildCore</code> in <code>internal/api/runtime.go</code> converts producer lint/breaking settings into engine options. <code>prepareV1GeneratorConfig</code> in <code>internal/generation/config.go</code> converts native plugins, selected module roots, output locations and managed rules into <code>core.Options</code>:
+
+~~~go
+cfg.Plugins = append(cfg.Plugins, core.Plugin{
+    Source: core.PluginSource{Name: plugin.Name, Path: plugin.Path, Command: plugin.Command, Remote: remote},
+    Out:    outRel, Options: plugin.Opts, WithImports: plugin.WithImports,
+})
+~~~
+
+Remote source/version are joined for the engine, and plugin output remains relative to the generator config. Module roots become <code>core.InputFilesDir</code> values. Native dependencies come from <code>protobuf.mod</code>; the engine does not receive a Git-generation-input collection. Core engine structs do not carry YAML tags for these representations. Pass complete options to <code>core.New</code>; it copies import roots, module ownership and known lint rule names.
+
+## Naming Conventions
+
+| Subject | Convention |
+|---------|------------|
+| Go source | Use lowercase, underscore-separated file names. |
+| Tests | Place tests beside the implementation as <code>&lt;file&gt;_test.go</code>. |
+| Lint rules | Use <code>internal/rules/&lt;rule&gt;.go</code> plus <code>&lt;rule&gt;_test.go</code>. |
+| Packages | Use short lower-case package names; adapter subpackages describe a capability. |
+| Interfaces | Use descriptive names without an <code>I</code> prefix. |
+| Enums | Reserve the zero value with <code>_ = iota</code> when defining enums. |
+| Rule names | <code>core.GetRuleName</code> converts concrete rule type names to upper snake case. |
+| Struct tags | Preserve the actual public format; most fields use snake_case, with established hyphenated policy keys. |
+
+Examples of rule-file naming include <code>rpc_pascal_case.go</code>, <code>package_defined.go</code>, and <code>enum_first_value_zero.go</code>.
+
+## Interface Conventions
+
+Interfaces are generally defined by the package that consumes them. <code>internal/core</code> owns <code>Rule</code>, <code>FS</code>, <code>DirWalker</code>, and <code>CurrentProjectGitWalker</code>. <code>internal/modules</code> owns <code>Source</code>, <code>Cache</code>, <code>Repository</code>, and <code>VersionedRepository</code>; <code>internal/migration</code> extends the source contract for historical verification. Plugin executors implement the adapter-level <code>Executor</code> contract in <code>internal/adapters/plugin/interface.go</code>.
+
+~~~go
+type Rule interface {
+	Message() string
+	Validate(ProtoInfo) ([]Issue, error)
+}
+
+type Executor interface {
+	Execute(ctx context.Context, plugin Info, request *pluginpb.CodeGeneratorRequest) (*pluginpb.CodeGeneratorResponse, error)
+	GetName() string
+}
+~~~
+
+Rules:
+
+- Put <code>context.Context</code> first in interface and function signatures.
+- Put <code>error</code> last in results.
+- Do not prefix interface names with <code>I</code>.
+- Prefer passing a small consumer-owned interface over a concrete adapter.
+- Update colocated fakes when changing the contracts they implement. <code>Taskfile.yml</code> retains <code>task mock</code> / <code>task mocks</code>; the aggregate target still names a removed <code>core.Console</code> interface and requires an out-of-scope tooling correction before it is a reliable regeneration command.
+
+## Error Propagation
+
+Wrap returned errors at each failing call site using the called function or method name only:
+
+~~~go
+original, module, err := ReadManifest(root)
+if err != nil {
+    return fmt.Errorf("ReadManifest: %w", err)
+}
+~~~
+
+~~~go
+if err := modules.CheckImportCollisions(moduleDir, module.Roots, importRoots.Paths()); err != nil {
+    return nil, fmt.Errorf("CheckImportCollisions: %w", err)
+}
+~~~
+
+These call sites are in <code>internal/modules/get.go</code> and <code>internal/generation/module.go</code>. Preserve <code>%w</code> chains so handlers can use <code>errors.Is</code> for sentinels and <code>errors.As</code> for typed errors. Current examples include <code>core.ErrEmptyInputFiles</code>, <code>modules.ErrLockedVersionChanged</code>, <code>v1.ErrLegacyConfiguration</code>, <code>*core.OpenImportFileError</code>, and <code>*core.GitRefNotFoundError</code>.
+
+Place errors in the package that owns their meaning; current ownership spans core, modules, v1 config, and CLI finding sentinels. Do not recreate the removed dependency-model error package or invent a central gRPC status mapper for this CLI. Command exit mappings must be read from handlers and the entry point; contextual import errors are not automatically equivalent to a typed missing-import error. See [ERRORS.md](./ERRORS.md).
+
+Keep reassignment and error checks on separate lines; a short <code>:=</code> declaration scoped to an <code>if</code> remains allowed. Preserve call context without adding an unrelated package label to every error.
+
+## Resource Closing
+
+Do not use a bare <code>defer x.Close()</code>. Wrap close calls and explicitly handle or intentionally discard the returned error:
+
+~~~go
+defer func() {
+	_ = file.Close()
+}()
+~~~
+
+When the close failure is operationally useful, <code>Core.close</code> logs the path and error with the repository logger.
+
+## Imports
+
+Order imports as standard library, third-party packages, then project packages. Separate groups with blank lines:
+
+~~~go
+import (
+	"context"
+	"fmt"
+
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	"github.com/easyp-tech/easyp/internal/core"
+)
+~~~
+
+Preserve this repository grouping and run <code>gofmt</code>. The current <code>.golangci.yml</code> explicitly enables <code>staticcheck</code>; it does not configure <code>gci</code>, so do not claim import grouping is enforced by that tool.
+
+## Comments and Documentation
+
+- Write Go comments and Godoc in English.
+- Begin exported-symbol documentation with that symbol's name.
+- Put explanatory comments above <code>if</code>, <code>for</code>, and <code>return</code> lines rather than inline.
+- Keep generated schema JSON out of manual edits.
+
+## Testing Organization
+
+| Test target | Location and pattern |
+|-------------|----------------------|
+| A core behavior | <code>internal/core/&lt;file&gt;_test.go</code> |
+| A lint rule | <code>internal/rules/&lt;rule&gt;_test.go</code> |
+| An adapter | Its adapter package with <code>&lt;file&gt;_test.go</code> |
+| Module source/cache fakes | <code>internal/modules/fixtures_test.go</code> |
+| Generation fixtures/fakes | <code>internal/generation/fixtures_test.go</code> and neighboring tests |
+| CLI integration fixtures | <code>internal/api/v1_fixtures_test.go</code> |
+| Migration behavior | <code>internal/migration/apply_test.go</code>, <code>internal/migration/lock_test.go</code> and neighboring tests |
+
+Tests use <code>testify</code>. Use <code>require</code> for fatal preconditions and <code>assert</code> for non-fatal assertions. Table-driven tests require a descriptive <code>name</code> field. Use <code>t.Parallel()</code> at the top level and inside each <code>t.Run</code> when the case is isolated, and create dependencies per case instead of sharing mutable fakes. Tests that change process environment or working directory run sequentially; prefer explicit work directories for application tests. Use <code>t.TempDir()</code> for independent filesystem state and <code>ErrorIs</code> / <code>ErrorAs</code> for error contracts.
+
+Run relevant tests after behavior changes. The repository's comprehensive task uses race detection:
+
+~~~sh
+task test
+~~~
+
+## Logging
+
+The CLI initializes a <code>slog</code> text handler and stores the project logger in <code>cli.App.Metadata</code>. API handlers retrieve it with <code>getLogger</code>; core and adapters receive it as a dependency.
+
+| Layer | Typical use |
+|-------|-------------|
+| CLI/API | Log terminal failures before calling <code>os.Exit</code> for recognized conditions. |
+| Core | Log operation start/completion, debug resolution data, and warnings for recoverable conditions. |
+| Adapters | Log infrastructure-relevant actions through the injected logger. |
+
+Use structured attributes such as <code>slog.String</code>, <code>slog.Int</code>, and <code>slog.Any</code>. Existing generation and breaking flows pass <code>context.Context</code> to logging methods. No project-wide correlation-ID convention is defined in the inspected code.
+
+## Concurrency
+
+Methods accept and check <code>context.Context</code> during dependency resolution, filesystem walks, compilation, and executor calls; preserve cancellation propagation. The Git object cache uses per-repository OS locks in <code>internal/adapters/gitmodules/object_cache.go</code> with platform-specific lock implementations; acquisition waits observe context cancellation. Migration <code>Plan</code> is not safe for concurrent use, and file replacement does not exclude noncooperating writers. No common server worker-pool pattern is established by these CLI workflows.
+
+## Quick Reference
+
+| Aspect | API | Core | Adapters |
+|--------|-----|------|----------|
+| Main responsibility | CLI translation and composition | Lint/breaking/compilation engines | Concrete infrastructure |
+| Config representation | Native <code>internal/config/v1</code> and converted policy values | Complete <code>core.Options</code> | Adapter-specific values and v1 metadata |
+| Error handling | Map known outcomes; wrap unknown failures | Wrap port failures; expose core sentinels | Wrap OS/Git/plugin failures |
+| Dependency direction | Imports application packages and adapters | Uses filesystem/Git ports and plugin executors | Implements source/cache/engine-facing behavior |
+| Tests | Handler-focused | Workflow and model tests | Adapter behavior tests |
+
+## Tooling Rules
+
+- Format Go code with <code>gofmt</code> and run <code>task lint</code> when appropriate.
+- Use <code>task build</code>, <code>task test</code>, <code>task quality</code>, and <code>task schema:check</code> as defined in <code>Taskfile.yml</code>.
+- Update <code>internal/config/v1</code> models/schema rules before <code>task schema:generate</code>; keep MCP field descriptions in <code>mcp/easypconfig</code> aligned.
+- Do not hand-edit <code>schemas/easyp-v1.schema.json</code>, <code>schemas/easyp.schema.json</code>, <code>schemas/easyp.gen-v1.schema.json</code>, <code>schemas/easyp.gen.schema.json</code>, <code>schemas/protobuf.lock-v1.schema.json</code>, or <code>schemas/protobuf.lock.schema.json</code>.
+- Do not commit generated local binaries, <code>coverage.out</code>, dependency-installation artifacts, secrets, or credentials.
+- Dependency and vendoring conventions are documented in [config/dependency.md](./config/dependency.md); the vendor directory is <code>easyp_vendor</code>.
diff --git a/.spec/DEPLOYMENT.md b/.spec/DEPLOYMENT.md
new file mode 100644
index 00000000..7fbd4058
--- /dev/null
+++ b/.spec/DEPLOYMENT.md
@@ -0,0 +1,115 @@
+# Release distribution
+
+EasyP is distributed as CLI/MCP binaries and a CLI container. Human-facing
+installation instructions live in README.md and the separate easyp-tech/docs
+repository. The v1 source can be merged into main while the latest stable
+release remains v0.17.0.
+
+## Channels
+
+| Channel | Selection | Published by this branch |
+|---|---|---|
+| Stable | GitHub Releases latest, Homebrew easyp, Go @latest, Docker latest | No |
+| v1 nightly | Exact v1.0.0-nightly.YYYYMMDD.N tag | Yes, on explicit tag push |
+| Local snapshot | goreleaser release --snapshot --clean | Local artifacts only |
+
+The nightly GoReleaser configuration sets release.prerelease to true and
+release.make_latest to false, contains no Homebrew publisher, and has exactly
+one Docker tag template: the Git tag. There is no floating nightly tag. Existing
+stable release assets, Homebrew formula and Docker latest remain on v0.
+
+Do not create a stable v1.0.0 Git tag during this period. Go selects module
+versions from Git tags, independently of GitHub Release flags. A stable v1 tag
+would become eligible for @latest even if its GitHub release were hidden or
+marked as a prerelease. Removing a tag after Go proxies have cached it is not
+an effective rollback.
+
+## Nightly workflow
+
+.github/workflows/release.yml runs only for v1.0.0-nightly.* tag pushes. It:
+
+1. Checks out full history, including origin/main and origin/v1.0.
+2. Runs scripts/validate-release-tag.sh before registry login. It accepts
+   v1.0.0-nightly.YYYYMMDD.N, where N is positive without leading zeros, and
+   requires the tag commit to be an ancestor of origin/main or origin/v1.0.
+   Stable tags and other prerelease forms are rejected.
+3. Sets up QEMU and Docker Buildx, logs into GHCR with GITHUB_TOKEN, and selects
+   Go from go.mod (1.26.6).
+4. Runs GoReleaser OSS 2.18.2 with release --clean --timeout=90m, using
+   GORELEASER_AUTH_TOKEN for GitHub publishing. This is an ordinary SemVer
+   prerelease, not GoReleaser Pro's --nightly feature.
+
+A push or merge to main alone does not publish anything. There is no scheduled
+or workflow_dispatch release in this branch. GitHub requires those triggers
+in the default branch; add them there explicitly if automatic nightlies are
+wanted later. Runs for the same release tag are serialized.
+
+### Publishing a nightly
+
+Only run these commands when a release is intended. Preparing or merging the
+branch does not require creating a tag.
+
+```sh
+git fetch origin --prune --tags
+git switch main
+git merge --ff-only origin/main
+# Verify the selected commit and its CI results before tagging.
+EASYP_NIGHTLY_TAG="v1.0.0-nightly.$(date -u +%Y%m%d).1"
+# Increase the sequence if that date already has a published nightly.
+git tag -a "$EASYP_NIGHTLY_TAG" -m "EasyP $EASYP_NIGHTLY_TAG"
+bash scripts/validate-release-tag.sh "$EASYP_NIGHTLY_TAG"
+git push origin "refs/tags/$EASYP_NIGHTLY_TAG"
+```
+
+Tags are immutable. If publication fails, inspect the workflow and existing
+assets before retrying; do not move a published tag. Corrections get a new
+sequence. Stable v0 maintenance must use v0 sources and its release workflow;
+this branch deliberately has no stable release publisher.
+
+## Artifacts and version metadata
+
+GoReleaser builds easyp and easyp-mcp for Darwin, Windows and Linux with the
+architecture matrix in .goreleaser.yaml. Each platform archive contains both
+binaries, LICENSE and README.md. Windows uses zip; other platforms use tar.gz.
+Checksums and a source archive are uploaded alongside them. The source archive
+respects .gitattributes; .agents is export-ignore.
+
+Both binaries receive internal/version.releaseVersion through the linker's -X
+flag. Their System() metadata and compiler metadata use that release tag; Go
+install and ordinary source builds keep embedded module/VCS version fallback.
+Snapshots receive the snapshot version rather than an older stable tag.
+
+Docker publishes ghcr.io/easyp-tech/easyp:<exact-nightly-tag> for linux/amd64
+and linux/arm64. The root Dockerfile builds the CLI from source and receives
+RELEASE_VERSION from GoReleaser, so its --version matches the release. There is
+no MCP container. Local task docker:build never pushes and does not require a
+release version. Runtime APK versions remain pinned in Dockerfile.
+
+## Checks before publishing
+
+Use Go 1.26.6 and GoReleaser 2.18.2 without upgrading repository dependencies.
+
+```sh
+goreleaser check
+go test -mod=readonly -race -count=1 ./scripts ./internal/version ./internal/core
+task lint:go
+task dev-tools:check
+```
+
+The normal tests workflow runs the full race suite, Go lint, Linux ARMv7 compile,
+proto example and developer-task guards, and the pinned GoReleaser config check.
+The scripts package checks immutable Docker tags, GitHub prerelease/latest
+settings, absence of Homebrew publishing, version linker flags, supported tag
+forms and source branches, and validation before publishing credentials.
+
+For packaging checks, use an isolated checkout with a temporary nightly tag and
+run goreleaser release --clean --skip=publish,docker. Do not create verification
+tags in the user's checkout or push them. For Docker, use a unique local tag and
+verify --version with an explicit RELEASE_VERSION build argument. Snapshot Task
+commands use the local dist directory; run them in an isolated checkout when
+existing artifacts must be preserved.
+
+The documentation site is built and published by easyp-tech/docs. Its latest
+version selector validates published stable releases and fails closed if GitHub
+returns only prereleases or invalid metadata; it never promotes a nightly via
+a raw-tag fallback.
diff --git a/.spec/DOMAIN.md b/.spec/DOMAIN.md
new file mode 100644
index 00000000..9a54b1d6
--- /dev/null
+++ b/.spec/DOMAIN.md
@@ -0,0 +1,272 @@
+<!-- generated: 2026-09-30, template: core.md -->
+# EasyP Domain Model
+
+EasyP operates on Protocol Buffers source trees, lint findings, generation targets and plugins, and Git-backed dependency modules. Engine types live in <code>internal/core</code>; native configuration and dependency records live in <code>internal/config/v1</code>; <code>internal/modules</code>, <code>internal/generation</code>, and <code>internal/migration</code> own their application workflows.
+
+## Core Proto Entities
+
+### <code>ProtoInfo</code>
+
+Defined in <code>internal/core/dom.go</code>. It is the parsed view of one protobuf source file and the imported files available to it.
+
+~~~go
+type ProtoInfo struct {
+	Path                 string
+	ImportPath           string
+	Info                 *unordered.Proto
+	ProtoFilesFromImport map[ImportPath]*unordered.Proto
+}
+~~~
+
+- <code>Path</code> is the source file path.
+- <code>ImportPath</code> is relative to a declared source root, independently of the scan root.
+- <code>Info</code> is the parsed protobuf syntax tree.
+- <code>ProtoFilesFromImport</code> maps import paths to parsed imported files.
+
+### <code>Issue</code> and <code>IssueInfo</code>
+
+Defined in <code>internal/core/dom.go</code>. Linting and breaking checks emit these values.
+
+~~~go
+type Issue struct {
+	Position   meta.Position
+	SourceName string
+	Message    string
+	RuleName   string
+}
+
+type IssueInfo struct {
+	Issue
+	Path string
+}
+~~~
+
+- <code>Position</code> identifies the protobuf source location.
+- <code>SourceName</code> records the checked source.
+- <code>Message</code> is supplied by the rule or checker.
+- <code>RuleName</code> is the upper-snake-case rule identity.
+- <code>Path</code> is added when the issue is associated with a walked file.
+
+### <code>ProtoData</code> and <code>Collection</code>
+
+Breaking checks collect parsed files into a package-keyed representation.
+
+~~~go
+type Collection struct {
+	Imports  map[ImportPath]Import
+	Services map[string]Service
+	Messages map[string]Message
+	OneOfs   map[string]OneOf
+	Enums    map[string]Enum
+}
+
+type ProtoData map[PackageName]*Collection
+~~~
+
+Each collection groups proto declarations for one <code>PackageName</code>. Nested messages, oneofs, and enums retain a dotted parent path such as <code>MainMessage.NestedMessage</code>.
+
+### Declaration Wrappers
+
+<code>internal/core/dom.go</code> wraps parser nodes with their source context:
+
+| Type | Context retained |
+|------|------------------|
+| <code>Import</code> | Proto file path, package name, and parsed import. |
+| <code>Service</code> | Proto file path, package name, and parsed service. |
+| <code>Message</code> | Message path, proto file path, package name, and parsed message. |
+| <code>OneOf</code> | Oneof path, proto file path, package name, and parsed oneof. |
+| <code>Enum</code> | Enum path, proto file path, package name, and parsed enum. |
+
+## Rule Model
+
+### <code>Rule</code>
+
+Every lint rule implements the core interface:
+
+~~~go
+type Rule interface {
+	Message() string
+	Validate(ProtoInfo) ([]Issue, error)
+}
+~~~
+
+<code>internal/rules/builder.go</code> creates engine rules from <code>config.LintConfig</code> (<code>Use</code>, <code>Except</code>, <code>IgnoreOnly</code>). Producer policy uses <code>linters.default</code>, <code>linters.enable</code>, <code>linters.disable</code>, <code>linters-settings</code>, and <code>issues.exclude-rules</code> in <code>easyp.yaml</code>; <code>v1.Policy.LintConfig</code> performs the conversion. Native presets are <code>MINIMAL</code>, <code>BASIC</code>, <code>STANDARD</code> (the default), and <code>COMMENTS</code>. <code>STANDARD</code> expands the internal <code>MINIMAL</code>, <code>BASIC</code>, and <code>DEFAULT</code> groups. The engine also defines the <code>UNARY_RPC</code> group. Native enable/disable and exclusion selectors are validated through <code>rules.ValidateNames</code>, which accepts registered rules/groups, including <code>UNARY_RPC</code>; it is not a <code>linters.default</code> preset.
+
+### Ignore Model
+
+The engine receives <code>Ignore</code>, <code>IgnoreOnly</code>, <code>AllowCommentIgnores</code>, and <code>KnownLintRules</code> through <code>core.Options</code>. <code>AllowCommentIgnores</code> is per engine, defaults to true when converting native policy, and is controlled by <code>linters.allow_comment_ignores</code>.
+
+<code>internal/core/comment_suppressions.go</code> parses actual parser comments. It supports <code>easyp:disable</code> / <code>easyp:enable</code> regions and declaration-scoped suppressions, plus the legacy <code>nolint:</code> and <code>buf:lint:ignore</code> forms. Malformed directives, unknown rules, and unmatched enables produce errors. <code>issues.exclude-rules</code> is the native path/rule suppression model; engine fields are not interchangeable with native YAML keys.
+
+## Module and Dependency Entities
+
+### Native Manifest
+
+Defined in <code>internal/config/v1/module.go</code>:
+
+~~~go
+type Module struct {
+    Name     string
+    Roots    []string
+    Requires []Requirement
+    Replaces []Replacement
+}
+
+type Requirement struct {
+    Module  string
+    Version string
+}
+
+type Replacement struct {
+    Module string
+    Target string
+}
+~~~
+
+<code>Module.Name</code> is the module identity, and <code>Roots</code> are import roots relative to its directory. <code>ParseModule</code> reads native <code>protobuf.mod</code> directives (<code>module</code>, <code>roots</code>, <code>require</code>, <code>replace</code>); this file is not YAML and has no JSON Schema. Roots default to <code>.</code>. The parser handles token-boundary <code>#</code> / <code>//</code> comments, optional first-line BOM, and multiline blocks; it rejects duplicate requirements/replacements, unknown directives, inline blocks, and roots that lexically leave the module. Filesystem checks occur later in <code>modules.ModuleSources</code>.
+
+<code>Requirement.Version</code> is an optional token. Resolution accepts semantic versions and full Git commit IDs; an omitted version is a weak requirement. <code>modules.Resolve</code> chooses the highest semantic minimum, reconciles exact commit constraints, and uses a supplied existing pin for versionless dependencies when available. It rejects incompatible tag/commit constraints. An omitted version has no separate enum or pseudo-version model.
+
+<code>Replacement.Target</code> names a local directory. Relative targets are resolved from the module directory; dependency roots come from the replacement's native manifest. Main-module replacements apply throughout the effective graph; replacements declared by dependencies are ignored. <code>EffectiveGraph</code> keeps local metadata separate from real remote revisions. Local operations preserve the shared lock; only explicit get/update requests can change root manifest requirements. Vendor can copy this effective graph without changing the lock. Frozen mode explicitly verifies existing published graphs; automatic unknown-import discovery is intentionally excluded.
+
+### Native Lock
+
+Defined in <code>internal/config/v1/lock.go</code>:
+
+| Type / field | Go type | YAML key |
+|--------------|---------|----------|
+| <code>Lock.Version</code> | <code>int</code> | <code>version</code> |
+| <code>Lock.Modules</code> | <code>[]LockedModule</code> | <code>modules</code> |
+| <code>LockedModule.Source</code> | <code>string</code> | <code>source</code> |
+| <code>LockedModule.Version</code> | <code>string</code> | <code>version</code> |
+| <code>LockedModule.Commit</code> | <code>string</code> | <code>commit</code> |
+| <code>LockedModule.Hash</code> | <code>string</code> | <code>hash</code> |
+
+<code>protobuf.lock</code> is one strict YAML document with numeric <code>version: 1</code>. Every locked source is unique. <code>Version</code> must be a semantic version or a full Git commit; <code>Commit</code> is a 40- or 64-character hexadecimal ID. A commit-valued version must equal <code>Commit</code> ignoring case. <code>Hash</code> is <code>h1:</code> plus a base64-encoded 32-byte digest. Parsing validates the document; installation verifies the actual Git-backed contents against it. A legacy <code>easyp.lock</code> is a different format and must be migrated with integrity verification, not renamed.
+
+### Resolved Metadata and Source Ownership
+
+Defined in <code>internal/modules/resolve.go</code> and <code>internal/modules/sources.go</code>:
+
+~~~go
+type Fetched struct {
+    Module v1.Module
+    Lock   v1.LockedModule
+}
+
+type SourceRoot struct {
+    Path   string
+    Module string
+}
+
+type SourceRoots []SourceRoot
+~~~
+
+<code>Source.Fetch</code> returns one revision's metadata and lock record. <code>Cache.Install</code> verifies/installs locked contents, while <code>Cache.Cached</code> returns an installed directory and <code>v1.Module</code> metadata without re-verifying content. <code>SourceRoots.Paths</code> preserves order; <code>FileModules</code> maps root-relative proto import names to identities for managed selectors after callers check collisions.
+
+<code>internal/adapters/module_config</code> adapts native manifests and supported legacy EasyP/Buf dependency metadata to <code>v1.Module</code>. <code>internal/adapters/gitmodules</code> owns checkout, object-cache and installation details; the module application layer does not expose a legacy installed-module model. See [config/dependency.md](./config/dependency.md) for resolution, integrity and installation details.
+
+## Generation Model
+
+### Engine Plugins and Inputs
+
+Core generation receives already-converted values:
+
+~~~go
+type PluginSource struct {
+	Name    string
+	Remote  string
+	Path    string
+	Command []string
+}
+
+type Plugin struct {
+	Source      PluginSource
+	Out         string
+	Options     map[string][]string
+	WithImports bool
+}
+~~~
+
+Plugin execution source selection is command first, then remote, then a built-in plugin absent from <code>PATH</code>, and otherwise local execution.
+
+~~~go
+type InputFilesDir struct {
+    Path string
+    Root string
+}
+
+type Inputs struct {
+    InputFilesDir []InputFilesDir
+}
+~~~
+
+These are engine inputs assembled from selected modules and their declared roots by <code>internal/generation/config.go</code>; there is no native <code>generate.inputs</code> field or engine Git-input collection. Dependencies are declared in <code>protobuf.mod</code>, and generation selection uses <code>generate.modules</code> in <code>easyp.gen.yaml</code>.
+
+<code>core.GenerationPlan</code> holds a compiled graph after managed options are applied. <code>Core.PrepareGeneration</code> creates it without running plugins; <code>DescriptorSet</code> returns a copied descriptor set; <code>ExecuteInto</code> stages plugin output in a shared <code>GenerateBucket</code>. <code>internal/generation/descriptor_set.go</code> prepares selected targets before plugin execution and validates descriptor export plans; <code>GenerationPlan</code> replaces the old <code>Query</code> description.
+
+### Managed Mode
+
+The configuration model contains:
+
+~~~go
+type ManagedMode struct {
+	Enabled bool
+	Disable []ManagedDisableRule
+	Override []ManagedOverrideRule
+}
+~~~
+
+Disable rules can match a module, protobuf package, path, file option, field option, or field. Override rules set a file or field option value and can be scoped by module, package, path, or field.
+
+The configuration validator requires valid option combinations: a rule cannot use both file and field options, and a field scope requires a field option.
+
+## Configuration Model
+
+Native v1 separates producer policy, consumer generation, module requirements and the lock:
+
+| File | Type / parser | Role |
+|------|---------------|------|
+| <code>easyp.yaml</code> | <code>v1.Policy</code> / <code>ParsePolicy</code> | Linter selection/settings, issue exclusions, breaking policy. |
+| <code>easyp.gen.yaml</code> | <code>v1.Generate</code> / <code>ParseGenerate</code> | Module selection, plugins and generation options. |
+| <code>protobuf.mod</code> | <code>v1.Module</code> / <code>ParseModule</code> | Module identity, roots, native requirements and replacements. |
+| <code>protobuf.lock</code> | <code>v1.Lock</code> / <code>ParseLock</code> | Reproducible dependency versions, commits and content hashes. |
+
+<code>v1.Policy</code> has <code>Version</code>, <code>Linters</code>, <code>LinterSettings</code>, <code>Issues</code>, and <code>Breaking</code>. <code>internal/config/v1/policy.go</code> defines their concrete structures and translates policy to engine configuration. <code>Config</code> in <code>internal/config/config.go</code> remains an internal policy-engine carrier and contains shared/legacy configuration types; it is not the native user-facing file model.
+
+The generation structures in <code>internal/config/v1/generate.go</code> are:
+
+| Type / field | Go type | YAML key |
+|--------------|---------|----------|
+| <code>Generate.Version</code> | <code>string</code> | <code>version</code> |
+| <code>Generate.InheritedGoPackagePrefix</code> | <code>bool</code> | <code>-</code> (excluded from YAML) |
+| <code>Generate.Generate</code> | <code>GenerateTargets</code> | <code>generate</code> |
+| <code>Generate.Plugins</code> | <code>[]Plugin</code> | <code>plugins</code> |
+| <code>Generate.Options</code> | <code>GenerateOptions</code> | <code>options</code> |
+| <code>GenerateTargets.Modules</code> | <code>[]string</code> | <code>modules</code> |
+| <code>GenerateTargets.Packages</code> | <code>[]string</code> | <code>packages</code> |
+| <code>GenerateTargets.Managed</code> | <code>config.ManagedMode</code> | <code>managed</code> |
+| <code>GenerateOptions.Go</code> | <code>GoOptions</code> | <code>go</code> |
+| <code>GoOptions.PackagePrefix</code> | <code>*string</code> | <code>package_prefix</code> |
+
+A nil <code>PackagePrefix</code> allows nearest-ancestor inheritance; an explicit empty string stops inheritance. Plugins and generation targets remain consumer-owned. The native <code>v1.Plugin</code> has <code>Name</code>, <code>Path</code>, <code>Command</code>, <code>Remote</code>, <code>Version</code>, <code>Out</code>, <code>Opts</code>, and <code>WithImports</code> fields. Exactly one source must be set; remote plugins require a pinned semantic version in the separate <code>version</code> field. Native plugin options use <code>v1.PluginOptions</code> and are converted to the engine's map of string slices.
+
+Native policy/generation YAML expands environment values through <code>internal/config/v1/environment.go</code>; the native manifest and lock do not share that expansion path. Runtime parsing and structured <code>ValidatePath</code> diagnostics are distinct entry points: do not assume that accepting a field in a schema means its runtime feature is implemented.
+
+Current configuration capabilities are explicit: <code>generate.packages</code> selects exact protobuf package names; <code>linters.extends</code> and <code>breaking.extends</code> load bounded local or verified locked-module policies, with presence-aware local overrides. Breaking categories FILE/PACKAGE/WIRE_JSON/WIRE select distinct compiled-descriptor compatibility profiles; omitted or empty categories default to FILE for v1 policies. Check the current parser, conversion methods and validation code before claiming where a reserved field fails.
+
+<code>internal/config/v1/schema.go</code> is the schema source. <code>internal/schemagen</code> writes the six artifacts: <code>schemas/easyp-v1.schema.json</code>, <code>schemas/easyp.schema.json</code>, <code>schemas/easyp.gen-v1.schema.json</code>, <code>schemas/easyp.gen.schema.json</code>, <code>schemas/protobuf.lock-v1.schema.json</code>, and <code>schemas/protobuf.lock.schema.json</code>. <code>mcp/easypconfig</code> consumes the same v1 schema. Regenerate artifacts instead of editing JSON directly.
+
+## Migration Model
+
+<code>internal/migration/migration.go</code> defines <code>Options</code> (<code>Dir</code>, <code>Module</code>, <code>ResolveLock</code>, <code>Repository</code>), candidate <code>Output</code> (<code>Name</code>, <code>Content</code>, <code>Mode</code>, <code>Unchanged</code>), and <code>Plan</code>. <code>Build</code> prepares concrete candidates, <code>Outputs</code> returns copies for review, <code>CheckUnchanged</code> rechecks inputs, and <code>Apply</code> applies the prepared plan. It does not run generation plugins or expand variable placeholders.
+
+The CLI migration wizard in <code>internal/api/migrate_interactive.go</code> first builds a preview without dependency access, requests separate dependency/cache authorization when needed, then confirms applying the displayed files and backups. Flag-only mode uses an explicit module identity and preview by default. Legacy backups and rollback support do not make multiple file replacements crash-atomic.
+
+## Business Errors
+
+See [ERRORS.md](./ERRORS.md) for error ownership, wrapping, command mappings and retry guidance. Current examples include <code>core.ErrInvalidRule</code>, <code>core.ErrRepositoryDoesNotExist</code>, <code>core.ErrEmptyInputFiles</code>, <code>modules.ErrLockedVersionChanged</code>, and <code>v1.ErrLegacyConfiguration</code>; typed core errors include <code>OpenImportFileError</code> and <code>GitRefNotFoundError</code>. Dependency failures also use contextual wrapped errors from module, manifest and cache operations. The removed dependency-model package is not an error source.
+
+## MCP configuration reference
+
+<code>easyp_config_describe</code> covers all four v1 formats. <code>protobuf.mod</code> returns text grammar and examples; YAML files, including <code>protobuf.lock</code>, return their actual JSON Schemas. The reference never reads project files or resolves dependencies. See [MCP reference contract](config/mcp-module-reference.md).
diff --git a/.spec/ERRORS.md b/.spec/ERRORS.md
new file mode 100644
index 00000000..04ec3a9b
--- /dev/null
+++ b/.spec/ERRORS.md
@@ -0,0 +1,283 @@
+<!-- generated: 2026-09-30, template: errors.md -->
+# Error Handling
+
+EasyP is a command-line application. It does not expose an HTTP or gRPC
+server API, so it has no HTTP status mapping, gRPC status mapping, or
+server-side JSON error envelope. The API layer in this document means the
+command handlers in <code>internal/api</code>.
+
+## Error Architecture
+
+~~~text
+CLI command handlers (internal/api)
+  -> configuration parsing/validation (internal/config/v1)
+  -> module operations and source resolution (internal/modules)
+  -> generation orchestration (internal/generation)
+  -> lint/breaking/compiler/plugin engines (internal/core)
+  -> migration planning/application (internal/migration)
+  -> adapters: Git/cache, module metadata, console and plugins
+  -> filesystem, Git subprocesses, parsers and remote executors
+
+Errors return upward with operation context; command-specific handlers
+print findings, classify selected errors, or return the error to main.
+~~~
+
+These are cooperating packages, not one mandatory call chain. For example,
+<code>mod tidy</code> calls <code>modules.Tidy</code> with a
+<code>gitmodules.Cache</code>; it does not call a dependency method on
+<code>core.Core</code>. Generation resolves module sources before constructing
+the core compiler/plugin engine. Migration uses its own plan and filesystem
+transaction.
+
+Go <code>error</code> values normally propagate upward. Use
+<code>errors.Is</code> for sentinel identity and <code>errors.As</code> for
+structured error types; wrapping with <code>%w</code> preserves both. Ordinary
+errors returned by <code>app.Run</code> reach <code>log.Fatal</code> in
+<code>cmd/easyp/main.go</code> and exit 1. An action returning
+<code>cli.Exit</code> instead supplies an <code>ExitCoder</code>: the default
+urfave/cli handler prints its message and exits with the specified status
+before <code>main</code>'s fallback. The explicit
+<code>errExit</code> helper in <code>internal/api/runtime.go</code> logs with the
+application logger and calls <code>os.Exit</code>. It is used by selected lint
+and breaking error branches, not as a global mapper.
+
+## Sentinel Catalog
+
+These sentinels exist in the current source. Their Go identifiers do not
+constitute a serialized error-code protocol.
+
+| Name | Defined in | Meaning and handling |
+|---|---|---|
+| <code>core.ErrInvalidRule</code> | <code>internal/core/core.go</code> | Unknown or unavailable lint rule. Wrapped by rule selection/building and returned; no dedicated CLI exit mapping. |
+| <code>core.ErrRepositoryDoesNotExist</code> | <code>internal/core/core.go</code> | Git repository is unavailable for breaking checks. The breaking handler logs an actionable message and exits 2. |
+| <code>core.ErrEmptyInputFiles</code> | <code>internal/core/core.go</code> | <code>Core.PrepareGeneration</code> found no input protos. Current generation preparation returns the error; there is no warning-and-success special case in the v1 CLI. |
+| <code>core.ErrRootOutsideProject</code> | <code>internal/core/breaking_check.go</code> | Breaking scan root is outside the Git repository. No dedicated CLI mapping; returned failures exit 1. |
+| <code>v1.ErrLegacyConfiguration</code> | <code>internal/config/v1/legacy_detection.go</code> | Recognized legacy configuration requires explicit migration. The message points to <code>easyp migrate --module &lt;identity&gt;</code>; native parsers do not silently convert files. |
+| <code>modules.ErrLockedVersionChanged</code> | <code>internal/modules/immutable_versions.go</code> | A previously locked semantic version now resolves to a different commit or content hash. The wrapped error includes old/new identities and asks for restoration or a new version; it returns through the command and exits 1. |
+| <code>api.ErrHasLintIssue</code> | <code>internal/api/lint.go</code> | Lint findings were printed; the lint handler exits 1. |
+| <code>api.ErrHasValidateIssue</code> | <code>internal/api/lint.go</code> | <code>validate-config</code> printed an invalid report; the returned error reaches <code>main</code> and exits 1. |
+| <code>api.ErrBreakingCheckIssue</code> | <code>internal/api/breaking_check.go</code> | Breaking findings were printed; the breaking handler exits 1. |
+
+Dependency resolution no longer relies on the removed model sentinels for
+version lookup, installed-module metadata, lock entries, or hash mismatch.
+Those cases are now ordinary contextual errors in the v1 module/cache flow,
+except for the explicit <code>ErrLockedVersionChanged</code> identity above.
+The <code>mod</code> handlers return those errors; they have no special
+version-not-found <code>os.Exit</code> branch.
+
+## Typed Errors and Diagnostic Records
+
+| Type | Defined in | Handling |
+|---|---|---|
+| <code>*core.OpenImportFileError</code> | <code>internal/core/dom.go</code> | Carries <code>FileName</code>. Lint and breaking use <code>errors.As</code>, log “Cannot import file” with a file-name attribute, and exit 2. This mapping applies to this type, not every error mentioning an import. |
+| <code>*core.GitRefNotFoundError</code> | <code>internal/core/dom.go</code> | Carries <code>GitRef</code>. Breaking logs “Cannot find git ref” with the ref and exits 2. |
+| <code>console.RunError</code> | <code>internal/adapters/console/error.go</code> | Holds command, parameters, working directory, underlying error and stderr. Its error string includes command/error/stderr; it has no <code>Unwrap</code> method, so the underlying <code>Err</code> is not automatically discoverable with <code>errors.Is</code>. |
+| <code>config.ValidationIssue</code> | <code>internal/config/validation_issue.go</code> | Diagnostic record with file/code/message/location/severity; not an <code>error</code> implementation. |
+| <code>v1ListError</code> | <code>internal/api/ls_files_v1.go</code> | File-listing diagnostic with code/message; not an <code>error</code> implementation. |
+
+No project-wide error interface or central domain-to-status conversion exists.
+Choose a sentinel for identity-only branching and a typed error when a caller
+needs structured context. Do not invent a sentinel or a status mapping merely
+to mirror a diagnostic message.
+
+## Module and Cache Error Flow
+
+Native <code>protobuf.mod</code> supplies requirements, roots and local
+replacements; <code>protobuf.lock</code> supplies immutable remote selections.
+The source files below own their respective failure paths.
+
+| Operation | Source | Failure behavior |
+|---|---|---|
+| Read native manifest | <code>internal/modules/project_files.go</code> | Read/parse errors retain context. Only <code>ReadModuleOrDefault</code> treats a missing manifest as a local root with no dependencies; <code>ReadManifest</code> callers require the manifest. |
+| Read/validate lock | <code>internal/modules/locked_sources.go</code> | Missing or unsatisfied remote requirements instruct the user to run <code>easyp mod tidy</code>. A missing native lock alongside legacy <code>easyp.lock</code> wraps <code>ErrLegacyConfiguration</code>; renaming the old file is not conversion. |
+| Resolve versions | <code>internal/modules/resolve.go</code> | Invalid versions, conflicting commit constraints, incompatible tag/commit selections and unstable versionless constraints return contextual errors. Deferred errors from provisional HEAD dependency graphs are reported only if that graph remains selected. |
+| Guard recorded versions | <code>internal/modules/immutable_versions.go</code> | Reusing a semantic version whose commit/hash changed wraps <code>ErrLockedVersionChanged</code>. |
+| Read local replacements | <code>internal/modules/local_sources.go</code> | Metadata/root errors and local dependency cycles return errors. Relative paths resolve from the owning manifest; absolute replacement paths remain absolute. |
+| Check imports | <code>internal/modules/collisions.go</code>, <code>internal/modules/imports.go</code> | Duplicate paths, nonportable import paths and unreadable/invalid reachable sources fail the operation. Import validation traverses root sources and reachable dependency/built-in imports, resolving against local/dependency roots and embedded well-known files. Unrelated dependency files are not traversed. |
+| Install locked content | <code>internal/adapters/gitmodules/download.go</code> | Validate the lock, install missing snapshots and verify hashes of both new and existing cached content. Hash mismatches or non-directory cache entries are errors, not successful cache misses. |
+| Obtain pinned Git objects | <code>internal/adapters/gitmodules/object_cache.go</code> | Verify the requested commit after fetching. Unavailable pins do not silently become HEAD. Cancellation and Git failures propagate. |
+| Persist manifest/lock | <code>internal/modules/project_files.go</code> | If lock writing fails after a manifest edit, restore the original manifest; join a restoration failure with the original error. |
+
+### Local Overlay and Remaining X20 Boundaries
+
+Local overlays are implemented without changing the published lock:
+
+- <code>modules.EnsureEffectiveGraph</code> applies only main-module replacements,
+  validates used local identities and resolves needed remote requirements.
+  Tidy/download never write project files in local mode; get/update may edit
+  explicit requirements but preserve the lock. Vendor snapshots the effective graph.
+  Historical versionless remote edges require a historical pin rather than HEAD.
+- Explicit <code>--frozen</code> validates native manifests and their existing
+  locks, including every reachable transitive requirement and exact cached hash.
+  It rejects main-module replacements and mutating commands. Missing snapshots
+  may be downloaded only at locked commits; dependency versions are not resolved.
+  Missing/stale locks fail without project writes. See [CLI.md](CLI.md).
+- Unknown import paths are checked against known roots. There is no implemented
+  automatic mapping from an arbitrary missing import to its owning Git module.
+  <code>resolveV1Lock</code> returns <code>cannot resolve imports</code> rather
+  than discovering a dependency identity from that path.
+
+CLI exit classification for missing-import diagnostics is a separate concern
+from X20 dependency discovery. Follow the actual handler's typed-error or
+result-record branch, not the words in its message.
+
+## Exit Code Behavior
+
+| Exit code | Current command behavior |
+|---|---|
+| <code>0</code> | A command action returns nil. Migration preview and a declined wizard confirmation can succeed without writing project files. Generation can return success when there are no executable targets, but an attempted compilation with no input files returns an error. |
+| <code>1</code> | Printed lint/breaking findings; an invalid validation report; <code>ls-files</code> collection diagnostics via <code>cli.Exit</code>; or an otherwise unhandled returned error, including module/cache, generation and migration failures. |
+| <code>2</code> | The explicit lint/breaking <code>OpenImportFileError</code> branches and breaking's missing Git ref/repository branches. It is not the universal code for all invalid configuration or import errors. |
+
+There is no central exit-code mapper. Inspect <code>Action</code> as well as its
+internal worker functions: tests that call only an internal function cannot
+establish the process exit code. In <code>internal/api/ls_files_v1.go</code>,
+<code>Action</code> first writes the complete JSON/text result, then returns
+<code>cli.Exit</code> with status 1 when the collected <code>errors</code> are
+nonempty. Output failures return their own wrapped errors. This exit behavior
+does not implement automatic import-to-module discovery.
+
+## Configuration Validation and Reserved Fields
+
+<code>internal/config/v1/validate_path.go</code> discovers the four native files:
+<code>easyp.yaml</code>, <code>easyp.gen.yaml</code>, <code>protobuf.mod</code> and
+<code>protobuf.lock</code>. <code>ValidateFile</code> in
+<code>internal/config/v1/validate.go</code> selects the parser/semantic checks;
+YAML schema diagnostics come from
+<code>internal/config/v1/validate_yaml.go</code>. Filesystem failures are returned
+as errors rather than embedded in a validation report.
+
+- <code>yaml_validation</code> identifies schema diagnostics, with source
+  coordinates where available; legacy-policy detection also uses this code.
+- <code>v1_validation</code> identifies semantic parser/conversion failures and
+  environment-expansion or schema-loading failures. The old
+  <code>ValidateRaw</code>/<code>envsubst_error</code> description is not the v1
+  path.
+- <code>config.HasErrors</code> and the CLI report use
+  <code>SeverityError</code> to decide invalidity. Warnings alone leave
+  <code>valid</code> true.
+
+Field presence in a Go struct is not a promise of implemented runtime behavior:
+
+| Field | Verified boundary |
+|---|---|
+| <code>linters.extends</code> | Invalid reference syntax fails parsing; missing bases, cycles and boundary violations fail context-aware resolution. Direct engine conversion rejects an unresolved base. CLI validation never downloads dependencies. |
+| <code>breaking.extends</code> | Resolves independently in the checked module context. Invalid or unresolved bases fail explicitly; baseline and ignore paths belong to the consumer. |
+| <code>generate.packages</code> | Exact package names; malformed names fail config validation and unmatched names fail generation before plugins. Dependencies remain available for compilation. |
+| <code>breaking.categories</code> | FILE/PACKAGE/WIRE_JSON/WIRE are implemented profiles. Unknown categories fail shared validation; omitted or empty categories default to FILE for v1 policies. See [profile catalog](config/breaking-profiles.md). |
+
+<code>ParsePolicy</code> and <code>ParseGenerate</code> also validate already-expanded
+YAML through <code>validateExpandedV1YAML</code>; environment substitution is not
+repeated during that schema pass. <code>yamlValidationError</code> in
+<code>internal/config/v1/semantic_validation.go</code> joins schema errors with
+file/location context for runtime callers. Policy parsing and both
+<code>LintConfig</code>/<code>BreakingConfig</code> invoke the shared semantics check,
+including unsupported extensions/categories, settings and baseline syntax.
+A nonempty baseline must be <code>git:&lt;ref&gt;</code>; an empty value permits fallback.
+Recursive validation still returns structured diagnostics through its own entry
+point; field presence alone is insufficient to assert feature support.
+
+## Wrapping Convention
+
+Add the called operation and preserve the cause with <code>%w</code>. Use a
+function/method prefix rather than a redundant layer/package label. A current
+example from <code>internal/modules/repository.go</code> is:
+
+~~~go
+roots, err := LocalSources(moduleDir, module)
+if err != nil {
+    return nil, fmt.Errorf("LocalSources: %w", err)
+}
+locked, err := EnsureLockedSources(ctx, moduleDir, module, cache)
+if err != nil {
+    return nil, fmt.Errorf("EnsureLockedSources: %w", err)
+}
+return append(roots, locked...), nil
+~~~
+
+Expected absence is checked before wrapping, as in
+<code>ReadModuleOrDefault</code> in <code>internal/modules/project_files.go</code>:
+
+~~~go
+_, module, err := ReadManifest(root)
+if errors.Is(err, os.ErrNotExist) {
+    return v1.Module{Roots: []string{"."}}, nil
+}
+if err != nil {
+    return v1.Module{}, fmt.Errorf("ReadManifest: %w", err)
+}
+return module, nil
+~~~
+
+Retain the primary failure when cleanup or rollback also fails.
+<code>errors.Join</code> is used by manifest restoration, vendor restoration and
+migration transactions. Migration also joins close errors into named return
+errors. Do not replace a failing operation's error with a later cleanup error,
+or discard identity by using only <code>%v</code> when callers inspect it.
+
+## Migration Error Flow
+
+<code>internal/api/migrate.go</code> wraps <code>migration.Build</code> and
+<code>Plan.Apply</code> failures. The flag-only path previews without writes;
+applying requires <code>--write</code>, and dependency integrity work requires
+<code>--resolve-lock</code>. A plan needing unapproved lock resolution can be
+shown with warnings, but its <code>Apply</code> fails. The terminal wizard in
+<code>internal/api/migrate_interactive.go</code> asks separately for dependency
+access/cache writes and applying the displayed plan; flags do not bypass its
+confirmations.
+
+Invalid explicit directory/module values fail directly; the wizard can prompt
+again for invalid values entered interactively. A declined confirmation prints
+cancellation and returns nil. EOF, incomplete input, context cancellation, or
+forced interactive mode without terminal input/output returns an error
+(<code>internal/api/migrate_prompt.go</code>).
+
+<code>internal/migration/migration.go</code> rejects unrepresentable legacy
+semantics, conflicting native outputs and changed inputs rather than silently
+converting them. <code>internal/migration/apply.go</code> stages outputs/backups,
+rechecks observed state and restores prior files after ordinary installation
+errors. A rollback failure is joined with the original error and reports the
+retained recovery directory. Multiple filesystem replacements are not a
+process-crash-atomic transaction; legacy backups and the retained legacy lock
+are recovery inputs.
+
+## User-Facing Output Formats
+
+EasyP does not serialize a general error response object:
+
+- Lint/breaking print each <code>core.IssueInfo</code> to stdout. Text uses
+  <code>path:line:column:source message (rule)</code>; JSON encodes one issue per
+  line in <code>internal/api/lint.go</code>.
+- <code>validate-config</code> prints a report with <code>valid</code> and optional
+  <code>errors</code>/<code>warnings</code> arrays. Issues contain
+  <code>code</code>/<code>message</code>, with file/location/severity as provided
+  by the record. Text output starts with <code>VALID: true|false</code> and adds
+  error/warning tables. See <code>internal/api/validate.go</code>.
+- <code>ls-files</code> JSON has <code>files</code>, <code>roots</code> and optional
+  <code>errors</code>. Collection codes are <code>parse_error</code>,
+  <code>invalid_import</code>, <code>import_not_found</code> and
+  <code>open_error</code>. Text mode writes file rows to the application writer
+  and diagnostics to its error writer (stdout/stderr by default). Collection
+  errors preserve the result output and cause exit 1; setup/indexing failures
+  return ordinary errors.
+- Migration prints warnings and candidate contents through its application
+  writer. These warnings are plan information, not validation-record arrays.
+- Explicit <code>errExit</code> cases log to stderr through the configured text
+  <code>slog</code> handler. The default CLI handler prints <code>cli.Exit</code>
+  summaries to stderr; ordinary returned failures use <code>main</code>'s
+  standard <code>log.Fatal</code> path.
+
+## Retry and Error Logging
+
+There is no shared retry/backoff policy or retryable-error classification.
+The Git object cache does have a compatibility fallback: if a shallow fetch of
+the exact commit fails, it fetches advertised history and verifies that same
+commit again (<code>internal/adapters/gitmodules/object_cache.go</code>). This
+is not permission to substitute HEAD or a different version. Its object-lock
+wait loop honors context cancellation.
+
+<code>cmd/easyp/main.go</code> installs a text <code>slog</code> logger on stderr,
+with debug logging enabled by the debug flag. Preserve useful operation
+context, including source/module/ref/path details when known. Log a failure at
+the boundary that terminates or meaningfully handles it; lower layers should
+normally wrap and return instead of logging the same failure repeatedly.
diff --git a/.spec/PACKAGES.md b/.spec/PACKAGES.md
new file mode 100644
index 00000000..6a1b45b0
--- /dev/null
+++ b/.spec/PACKAGES.md
@@ -0,0 +1,68 @@
+<!-- generated: 2026-09-30, template: core.md -->
+# EasyP Package Reference
+
+## Application packages
+
+| Package | Main files | Responsibility |
+|---------|------------|----------------|
+| <code>cmd/easyp</code> | <code>main.go</code> | Registered CLI commands, logger and global flags |
+| <code>cmd/easyp-mcp</code> | <code>main.go</code> | Separate MCP server entry point |
+| <code>internal/api</code> | <code>get_v1.go</code>, <code>mod_v1*.go</code>, <code>generate.go</code> | Parse command inputs and call module/generation operations |
+| <code>internal/api</code> | <code>lint_v1.go</code>, <code>breaking_v1.go</code>, <code>policy_v1.go</code>, <code>policy_imports.go</code>, <code>runtime.go</code> | Policy selection, import-root preparation, lint/breaking engine composition and output |
+| <code>internal/api</code> | <code>validate.go</code>, <code>schema_gen.go</code>, <code>ls_files_v1.go</code>, <code>init_v1.go</code> | Validation presentation, schema generation, file listing and project initialization |
+| <code>internal/api</code> | <code>migrate.go</code>, <code>migrate_interactive.go</code>, <code>migrate_prompt.go</code> | Flag-only migration and terminal wizard, preview and authorization prompts |
+| <code>internal/modules</code> | <code>resolve.go</code> | Select revisions through the small <code>Source</code> contract |
+| <code>internal/modules</code> | <code>operations.go</code>, <code>get.go</code>, <code>update.go</code>, <code>vendor.go</code>, <code>repository.go</code> | Independent application operations and their required source/cache contracts |
+| <code>internal/modules</code> | <code>sources.go</code>, <code>local_sources.go</code>, <code>locked_sources.go</code>, <code>collisions.go</code>, <code>walk.go</code>, <code>imports.go</code> | Roots, ownership, replacements, lock validation, source walking and imports |
+| <code>internal/modules</code> | <code>manifest_edit.go</code>, <code>manifest_requirements.go</code>, <code>project_files.go</code> | Preserve manifest text, classify direct/indirect requirements and coordinate persistence |
+| <code>internal/generation</code> | <code>generate.go</code>, <code>discovery.go</code>, <code>inherit.go</code>, <code>selection.go</code> | Discover configs, inherit options and select modules |
+| <code>internal/generation</code> | <code>config.go</code>, <code>module.go</code> | Translate config and construct a fully configured generation engine |
+| <code>internal/generation</code> | <code>descriptor_set.go</code>, <code>descriptor_output.go</code>, <code>descriptor_conflict.go</code> | Prepare target graphs, validate export destinations and descriptor compatibility, execute shared output bucket |
+| <code>internal/migration</code> | <code>migration.go</code>, <code>legacy.go</code>, <code>convert.go</code>, <code>manifest.go</code>, <code>lock.go</code>, <code>roots.go</code>, <code>apply.go</code>, <code>validate.go</code> | Build validated migration candidates, verify historical dependency pins, preserve backups, apply with rechecks/rollback |
+| <code>internal/workspace</code> | <code>discovery.go</code> | Repository boundary, ancestor config/module selection, recursive discovery exclusions |
+| <code>internal/core</code> | <code>core.go</code>, <code>dom.go</code>, <code>proto_info_read.go</code>, <code>lint.go</code> | Engine options, proto representations and lint execution |
+| <code>internal/core</code> | <code>generate.go</code>, <code>managed_mode.go</code>, <code>generate_bucket.go</code>, <code>generate_insertion_point.go</code> | Descriptor compilation, managed mode, plugins and output |
+| <code>internal/core</code> | <code>comment_suppressions.go</code>, <code>instruction_parser.go</code>, <code>unstable_package_matcher.go</code> | Per-engine lint directives, protobuf instruction names and unstable package matching |
+| <code>internal/core/path_helpers</code> | <code>is_target_path.go</code>, <code>v1_source.go</code> | Target path matching and v1 source exclusions |
+| <code>internal/core</code> | <code>breaking_check.go</code>, <code>breaking_checker.go</code> | Read and compare current/historical proto models |
+| <code>internal/rules</code> | <code>builder.go</code> and individual rules | Named lint groups and implementations of <code>core.Rule</code> |
+
+<code>modules</code> and <code>generation</code> are callable with <code>context.Context</code> and explicit inputs. Core no longer owns dependency downloads or lock updates. CLI code does not know the physical Git cache layout.
+
+## Configuration and metadata
+
+| Package | Responsibility |
+|---------|----------------|
+| <code>internal/config/v1</code> | Native directive parser in <code>module.go</code>; lock/policy/generator YAML in <code>lock.go</code>, <code>policy.go</code>, <code>generate.go</code>; <code>schema.go</code>, <code>policy_semantics.go</code>, <code>semantic_validation.go</code>, recursive validation and YAML issues |
+| <code>internal/config</code> | Shared engine/legacy lint, breaking, plugin and managed types; legacy dependency readers live in <code>internal/adapters/module_config</code> |
+| <code>internal/adapters/module_config</code> | Select supported dependency metadata modes and adapt nested module, Buf and legacy EasyP roots/requirements |
+| <code>internal/adapters/modfile</code> | Legacy <code>direct</code>/<code>replace</code> manifest parsing for dependency compatibility |
+| <code>internal/schemagen</code> | <code>schemagen.go</code> writes versioned schema artifacts and latest aliases from <code>v1.SchemaJSON</code> |
+| <code>mcp/easypconfig</code> | MCP config-description tool and schema exposure backed by <code>internal/config/v1</code> |
+
+Generated JSON Schemas are <code>schemas/easyp-v1.schema.json</code>, <code>schemas/easyp.schema.json</code>, <code>schemas/easyp.gen-v1.schema.json</code>, <code>schemas/easyp.gen.schema.json</code>, <code>schemas/protobuf.lock-v1.schema.json</code>, and <code>schemas/protobuf.lock.schema.json</code>. Regenerate with <code>task schema:generate</code>, then run <code>task schema:check</code>. Native <code>protobuf.mod</code> is parsed directly and has no JSON Schema.
+
+Section-scoped <code>extends</code> is implemented in <code>internal/policy</code>, backed by the verified consumer graph. Generation <code>packages</code> is an exact-name selector; FILE/PACKAGE/WIRE_JSON/WIRE breaking profiles are implemented in the core descriptor comparator. These struct/schema fields are not proof of runtime support. See [domain model](DOMAIN.md) and [dependency management](config/dependency.md) for current limits, including local overlays, explicit frozen validation and intentionally excluded unknown-import discovery.
+
+## Infrastructure
+
+| Package | Main files / contract |
+|---------|-----------------------|
+| <code>internal/adapters/gitmodules</code> | <code>cache.go</code>, <code>git.go</code>: cache layout and Git execution; <code>object_cache.go</code>, <code>object_lock_unix.go</code>, <code>object_lock_windows.go</code>: reusable Git object repositories and OS locks; <code>checkout.go</code>, <code>git_source.go</code>: revision/candidate selection; <code>download.go</code>, <code>files.go</code>: installation and tracked-file hashing; <code>identity.go</code>: optional Git origin identity; <code>migration.go</code>, <code>migration_config.go</code>, <code>migration_selection.go</code>: historical revision/hash verification |
+| <code>internal/adapters/plugin</code> | Local, remote, built-in WASM and command executors; <code>Info</code> carries the explicit local execution directory |
+| <code>internal/adapters/go_git</code> | Historical project-tree walkers for breaking checks |
+| <code>internal/adapters/console</code> | Platform command execution |
+| <code>internal/adapters/prompter</code> | Interactive prompting |
+| <code>internal/fs/go_git</code> | Read-only filesystem and directory walkers over historical Git trees |
+| <code>internal/fs/fs</code> | Core filesystem walker, exclusive regular-file copying and atomic replacement of an individual file |
+| <code>internal/logger</code> | Logger contract and implementations |
+| <code>internal/flags</code> | Shared CLI flags |
+| <code>internal/version</code> | Build/compiler version metadata |
+
+Normal Git dependency reads use <code>module_config</code>. The Git adapter also has a dedicated historical YAML reader in <code>internal/adapters/gitmodules/migration_config.go</code> to reproduce legacy roots for integrity verification. Filesystem helpers do not interpret manifests, locks or module identities.
+
+See [architecture](ARCHITECTURE.md) for direction of dependencies, ownership, and persistence guarantees.
+
+## MCP configuration reference
+
+<code>easyp_config_describe</code> covers all four v1 formats. <code>protobuf.mod</code> returns text grammar and examples; YAML files, including <code>protobuf.lock</code>, return their actual JSON Schemas. The reference never reads project files or resolves dependencies. See [MCP reference contract](config/mcp-module-reference.md).
diff --git a/.spec/README.md b/.spec/README.md
new file mode 100644
index 00000000..3e4fd685
--- /dev/null
+++ b/.spec/README.md
@@ -0,0 +1,115 @@
+<!-- generated: 2026-09-30, template: bootstrap.md -->
+# EasyP Documentation
+
+This folder contains documentation to help LLMs and developers quickly understand the project context.
+
+## Documentation Index
+
+### Core
+
+- [ARCHITECTURE.md](./ARCHITECTURE.md) — CLI wiring, modules, generation, migration, engines and adapters
+- [PACKAGES.md](./PACKAGES.md) — Package reference for <code>internal/*</code>, <code>mcp/</code>, <code>cmd/</code>
+- [DOMAIN.md](./DOMAIN.md) — Domain model (modules, lockfile, lint rules, plugins)
+- [CODE_STYLE.md](./CODE_STYLE.md) — Go conventions expanded from agent-rules
+
+### Development
+
+- [TOOLS.md](./TOOLS.md) — Taskfile, golangci-lint, mockery, gotestsum
+- [TESTING.md](./TESTING.md) — testify patterns, mocks, race tests
+
+### Config & Dependencies
+
+- [config/dependency.md](./config/dependency.md) — Git-native package manager (<code>easyp mod</code>, lockfile, cache)
+- [../V1_RELEASE_NOTES.md](../V1_RELEASE_NOTES.md) — unreleased v1 contract changes that supersede the earlier pilot RFC
+- [agent-rules.md](./agent-rules.md) — Mandatory rules for AI agents
+
+### Domain (CLI toolkit)
+
+- [CLI.md](./CLI.md) — Commands, flags, exit codes
+- [ERRORS.md](./ERRORS.md) — Current error types, CLI flow and unresolved mappings
+- [DEPLOYMENT.md](./DEPLOYMENT.md) — Docker, CI/CD, releases
+
+## Quick Facts
+
+| Aspect | Technology |
+|--------|------------|
+| **Language** | Go 1.26.6 (<code>github.com/easyp-tech/easyp</code>) |
+| **Product** | Protocol Buffers CLI toolkit |
+| **CLI** | urfave/cli v2 (<code>cmd/easyp</code>) |
+| **Capabilities** | lint, breaking, generate, get, mod, init, migrate, ls-files, validate-config, schema-gen, completion |
+| **Config** | v1 <code>easyp.yaml</code> policy + <code>easyp.gen.yaml</code> generation; <code>internal/config/v1</code> models/schema, <code>internal/schemagen</code> writer |
+| **Deps** | Git repositories; declare in <code>protobuf.mod</code>; lockfile <code>protobuf.lock</code>; cache <code>EASYPPATH</code> |
+| **Build** | Task (<code>Taskfile.yml</code>) |
+| **Lint** | golangci-lint (<code>.golangci.yml</code>) |
+| **Tests** | gotestsum, <code>-race</code>, testify |
+| **Human docs** | Root [README.md](../README.md); site maintained in separate <code>easyp-tech/docs</code> repository, https://easyp.tech |
+
+## Project Structure
+
+~~~
+easyp/
+├── cmd/easyp/              # CLI entrypoint
+├── internal/
+│   ├── api/                # CLI command wiring
+│   ├── core/               # Lint/breaking engines, parsing, plugin execution
+│   ├── modules/            # Resolver, native manifests, locks, imports, vendor
+│   ├── generation/         # Consumer discovery, module selection, descriptor export
+│   ├── migration/          # Legacy conversion plans and guarded apply
+│   ├── rules/              # Lint rules (+ colocated tests)
+│   ├── config/v1/          # Native v1 models, parsing, validation and schemas
+│   ├── schemagen/          # Writes generated schemas
+│   └── adapters/           # Git/cache, dependency metadata, plugins, prompts
+├── mcp/easypconfig/        # MCP descriptions consuming the v1 schema
+├── schemas/               # Six generated JSON Schema artifacts
+├── .spec/                  # Agent-oriented project docs (this tree)
+└── Taskfile.yml
+~~~
+
+## Running
+
+~~~sh
+task init              # install local tools (golangci-lint, gotestsum, mockery)
+task build             # go build -o easyp ./cmd/easyp
+task test              # gotestsum with -race and coverage
+task lint              # golangci-lint (+ hadolint where applicable)
+task quality           # test + lint
+task schema:generate   # regenerate schemas/*.json
+task schema:check      # fail if schemas drift
+task mocks             # optional mocks for actual core and console interfaces
+task dev-tools:check   # isolated offline Taskfile regression
+~~~
+
+Without Task:
+
+~~~sh
+go build -o easyp ./cmd/easyp
+go test -race -count=1 ./...
+go run ./cmd/easyp schema-gen
+~~~
+
+<code>task lint</code> runs the local Go linter and Hadolint against root <code>Dockerfile</code>. See [TOOLS.md](./TOOLS.md) for pinned tool prerequisites and <code>task dev-tools:check</code>. Docker build helpers build locally and never publish.
+
+## Ports
+
+N/A — EasyP is a CLI tool, not a long-running server. Remote plugin execution uses gRPC to an external EasyP plugin API when configured; there is no default listen port in-repo.
+
+## Key Interfaces / Entry Points
+
+| Entry | Role |
+|-------|------|
+| <code>cmd/easyp</code> | Process entry; registers CLI handlers |
+| <code>internal/api</code> | All registered command handlers; see [CLI.md](./CLI.md) for flags and aliases |
+| <code>Core</code> in <code>internal/core/core.go</code> | Per-engine lint, breaking and low-level generation state |
+| <code>Source</code>, <code>Cache</code>, <code>Repository</code>, <code>VersionedRepository</code> in <code>internal/modules</code> | Dependency resolution and verified installation contracts |
+| <code>internal/migration</code> + <code>internal/api/migrate_interactive.go</code> | Preview/apply conversion and interactive migration wizard |
+| <code>easyp.yaml</code> + <code>easyp.gen.yaml</code> + <code>protobuf.mod</code> + <code>protobuf.lock</code> | Policy, generation, declared dependencies and locked revisions |
+| <code>mcp/easypconfig</code> | Config schema / MCP metadata |
+
+## Adding New Features
+
+1. **Lint rule** — add <code>internal/rules/&lt;rule&gt;.go</code> + <code>&lt;file&gt;_test.go</code>; register via existing rule builder; mirror neighboring rules.
+2. **v1 schema** — change <code>internal/config/v1</code>, then <code>task schema:generate</code>; update MCP descriptions when semantics change. Never hand-edit <code>schemas/*.json</code>.
+3. **CLI command** — wire in <code>internal/api</code>, register from <code>cmd/easyp</code>; follow existing handler patterns.
+4. **Interfaces** — update consumer interfaces and their test doubles; consult [TESTING.md](./TESTING.md) before generating optional Mockery test doubles. Add/adjust tests with <code>-race</code>.
+5. Before finishing behavior changes: run tests for touched packages; for schema changes run <code>task schema:check</code>.
+6. Implemented policy inheritance, exact package selection and breaking profiles are described in [CLI.md](./CLI.md) and [ERRORS.md](./ERRORS.md); do not infer support from a declared field alone.
diff --git a/.spec/TESTING.md b/.spec/TESTING.md
new file mode 100644
index 00000000..d98b3871
--- /dev/null
+++ b/.spec/TESTING.md
@@ -0,0 +1,307 @@
+<!-- generated: 2026-09-30, template: development.md -->
+# Testing
+
+## Overview
+
+EasyP tests are Go <code>*_test.go</code> files distributed beside the packages they
+exercise. The test task runs every package with coverage, the race detector,
+and test caching disabled:
+
+~~~bash
+task test
+~~~
+
+The command expands to:
+
+~~~bash
+bin/gotestsum --format pkgname -- -coverprofile=coverage.out -race -count=1 ./...
+~~~
+
+Tests use the standard <code>testing</code> package and <code>github.com/stretchr/testify</code>.
+Testify's <code>require</code> package is the most common assertion style in the lint
+rule tests, while some smaller package tests use <code>t.Fatalf</code> or <code>t.Errorf</code>.
+
+## Test Package Naming
+
+Both external and internal test packages are present; select the package style
+that matches the code being tested and neighboring tests.
+
+Lint rule tests use an external package:
+
+~~~go
+package rules_test
+
+import (
+    "testing"
+
+    "github.com/easyp-tech/easyp/internal/rules"
+)
+~~~
+
+For example, <code>internal/rules/file_lower_snake_case_test.go</code> imports
+<code>internal/rules</code> explicitly and tests its exported rule type. Tests in
+<code>internal/core</code> commonly use the internal package instead:
+
+~~~go
+package core
+~~~
+
+<code>internal/core/generate_path_test.go</code> calls the unexported <code>stripPrefix</code>
+function directly, which requires the internal <code>core</code> package. Private behavior is tested from same-package tests rather than exposed
+through test-only export shims.
+
+## Test File Structure
+
+Rule validation tests commonly use a table keyed by scenario name, make
+parallelism explicit, create test data through a shared helper, and use
+Testify assertions:
+
+~~~go
+func TestFileLowerSnakeCase_Validate(t *testing.T) {
+    t.Parallel()
+
+    tests := map[string]struct {
+        fileName   string
+        wantIssues *core.Issue
+        wantErr    error
+    }{
+        "invalid": {fileName: invalidAuthProto3},
+        "valid":   {fileName: validAuthProto},
+    }
+
+    for name, tc := range tests {
+        name, tc := name, tc
+        t.Run(name, func(t *testing.T) {
+            t.Parallel()
+
+            r, protos := start(t)
+            rule := rules.FileLowerSnakeCase{}
+            issues, err := rule.Validate(protos[tc.fileName])
+            r.ErrorIs(err, tc.wantErr)
+            if tc.wantIssues != nil {
+                r.Contains(issues, *tc.wantIssues)
+            }
+        })
+    }
+}
+~~~
+
+The actual test additionally verifies rule issue fields. The abbreviated
+example shows the recurring structure without duplicating all fixture data.
+
+## Table-Driven Tests
+
+The repository uses both map- and slice-based table tests.
+
+Rule tests typically use <code>map[string]struct</code> where each map key is the
+subtest name. They rebind the range values before the closure:
+
+~~~go
+for name, tc := range tests {
+    name, tc := name, tc
+    t.Run(name, func(t *testing.T) {
+        // use name and tc
+    })
+}
+~~~
+
+This is a retained convention in older tests. Go 1.26.6 uses per-iteration
+variables for this loop form, so rebinding is no longer necessary for capture
+safety; it does not isolate shared fixtures or mocks.
+
+Other tests use a slice with an explicit <code>name</code> field. For example,
+<code>internal/adapters/plugin/options_test.go</code> defines:
+
+~~~go
+tests := []struct {
+    name      string
+    options   map[string][]string
+    expected  string
+    hasResult bool
+}{
+    {
+        name:      "single scalar value",
+        options:   map[string][]string{"env": {"node"}},
+        expected:  "env=node",
+        hasResult: true,
+    },
+}
+~~~
+
+Prefer descriptive scenario names. The project testing skill calls for
+<code>name string</code> as the first table field, input fields next, setup fields after
+that, and expected values last. Existing legacy tests do not all follow every
+new convention, so use nearby tests and the testing skill when adding code.
+
+## Parallel Execution
+
+Many rule tests call <code>t.Parallel()</code> at the top level and in every subtest:
+
+~~~go
+func TestRule_Validate(t *testing.T) {
+    t.Parallel()
+
+    for name, tc := range tests {
+        name, tc := name, tc
+        t.Run(name, func(t *testing.T) {
+            t.Parallel()
+            // isolated test body
+        })
+    }
+}
+~~~
+
+The project testing skill treats this as the standard for table-driven tests.
+Keep each parallel subtest isolated: create mutable dependencies inside the
+subtest and use <code>t.TempDir()</code> for filesystem state. Do not remove
+parallelism merely to work around coupled test state.
+
+Not every existing test is parallel. For example,
+<code>internal/core/generate_path_test.go</code> uses sequential subtests, and
+<code>internal/config/v1/environment_test.go</code> uses <code>t.Setenv</code> for process
+environment variables. When modifying a test, preserve its safety requirements rather
+than adding parallelism to code with shared global state.
+
+## Helpers, Fixtures, and Cleanup
+
+<code>internal/rules/init_test.go</code> supplies the shared <code>start(t testing.TB)</code>
+helper for rule tests. It parses <code>.proto</code> files from <code>testdata/</code> and returns
+both <code>*require.Assertions</code> and a map of <code>core.ProtoInfo</code>.
+
+The helper marks itself as a helper and registers file cleanup:
+
+~~~go
+func parseFile(t testing.TB, assert *require.Assertions, path string) core.ProtoInfo {
+    t.Helper()
+
+    f, err := os.Open(path)
+    assert.NoError(err)
+    t.Cleanup(func() { assert.NoError(f.Close()) })
+
+    got, err := protoparser.Parse(f)
+    assert.NoError(err)
+    // interpret the parsed proto and its imports
+}
+~~~
+
+Use <code>t.Helper()</code> for reusable helpers so failure locations point to the test
+call site. Use <code>t.Cleanup()</code> for resources opened by the test. Local Git snapshot tests live in
+<code>internal/adapters/go_git/snapshot_test.go</code>; generation/descriptor fixtures
+live in <code>internal/generation</code>. These are ordinary Go tests, without a separate
+snapshot-testing framework.
+
+## Assertions and Errors
+
+Testify is a direct module dependency. Rule tests frequently construct
+<code>require.New(t)</code> and use the returned assertion object:
+
+~~~go
+assert := require.New(t)
+assert.Equal(expMessage, message)
+assert.NoError(err)
+~~~
+
+For new tests, use <code>require</code> for a condition that must hold before later
+assertions can be meaningful, such as an error-free operation or a non-nil
+value. Use <code>assert</code> for independent value checks when continued reporting is
+useful. For expected sentinel errors, the project testing skill specifies
+<code>require.ErrorIs(t, err, wantErr)</code>.
+
+Some existing compact tests use direct fatal failures:
+
+~~~go
+if result != tt.expected {
+    t.Fatalf("flattenOptions() result = %q, want %q", result, tt.expected)
+}
+~~~
+
+Follow the surrounding test's established assertion style when making a
+small extension, while using the project testing conventions for new suites.
+
+## Mock Generation
+
+Mockery is the generated-mock tool. <code>Taskfile.yml</code> pins Mockery v2.53.7 and
+installs it into <code>bin/</code> through <code>task init</code>.
+
+~~~bash
+task mocks
+~~~
+
+The optional Taskfile helper generates <code>Rule</code> and <code>CurrentProjectGitWalker</code>
+from <code>internal/core</code> into <code>internal/core/mocks</code>, and <code>Console</code> from
+<code>internal/adapters/console</code> into <code>internal/adapters/console/mocks</code>.
+There are no checked-in Mockery outputs or <code>go:generate</code> directives in the
+current source. Neither build nor test depends on generation. Do not commit
+unused outputs or recreate removed interfaces to satisfy an old command.
+Generated mocks import <code>testify/mock</code>, whose <code>objx</code> dependency is not
+needed by the handwritten doubles. To check optional outputs without changing
+the root <code>go.mod</code>/<code>go.sum</code>, resolve those dependencies in a temporary modfile:
+
+~~~sh
+(
+    set -eu
+    mock_check_dir=$(mktemp -d)
+    trap 'rm -rf "$mock_check_dir"' EXIT
+    cp go.mod go.sum "$mock_check_dir/"
+    go test -mod=mod -modfile="$mock_check_dir/go.mod" ./internal/core/mocks ./internal/adapters/console/mocks
+)
+~~~
+
+Keep Mockery's tool dependencies separate from the root module. If a tool
+build or package-loading error mentions an older <code>golang.org/x/tools</code>,
+record that error rather than changing application dependencies to fix the tool.
+
+<code>internal/modules/resolve_test.go</code> and <code>internal/modules/operations_test.go</code>
+use small hand-written implementations of the <code>Source</code>/repository contracts.
+Keep mutable fake state isolated per test. Update the matching test double
+when an interface changes, and do not hand-edit generated outputs if future
+Mockery generation is introduced.
+
+## Integration Tests
+
+There is no separate integration-test directory, test build tag, <code>TestMain</code>,
+or test-container configuration in the current test tree. <code>task test</code> runs
+all Go tests in <code>./...</code>; it is therefore the single repository test command
+rather than a unit/integration split.
+
+Tests that parse Protocol Buffers use checked-in files under <code>testdata/</code>.
+Local Git integration tests in <code>internal/adapters/gitmodules</code> and
+<code>internal/api</code> initialize temporary repositories and run system Git; they do
+not need a public remote. Module tests cover resolver ordering, retained
+comments, lock/hash checks, replacements and vendor staging. They do not
+start an external database or Docker Compose stack. EasyP's Git-backed
+module cache and <code>easyp_vendor</code> output belong to
+the dependency-management flow; see
+[config/dependency.md](config/dependency.md), not a file-upload test suite.
+
+## Commands
+
+~~~bash
+# Full suite: coverage, race detector, and no cache
+task test
+
+# Direct Go equivalent without gotestsum's package formatter
+go test -race -count=1 ./...
+
+# Run one package
+go test -race -count=1 ./internal/rules
+
+# Run one test or subtest pattern
+go test -race -count=1 ./internal/rules -run 'TestFileLowerSnakeCase_Validate'
+
+# Open the coverage profile produced by task test
+task coverage
+
+# Optional Mockery targets for core and console
+task mocks
+
+# Offline Taskfile dispatch and failure checks (requires only Task and shell tools)
+task dev-tools:check
+
+# Validate the native v1 example in a temporary workspace
+task proto:check
+~~~
+
+Run at least the package tests you touched after a behavior change. Run
+<code>task test</code> before handing off broader changes; it is also the command used
+by the GitHub Actions test workflow after <code>task init</code>.
diff --git a/.spec/TOOLS.md b/.spec/TOOLS.md
new file mode 100644
index 00000000..0de305dd
--- /dev/null
+++ b/.spec/TOOLS.md
@@ -0,0 +1,246 @@
+<!-- generated: 2026-09-30, template: development.md -->
+# Development Tools
+
+## Dev Environment Setup
+
+EasyP is a Go Protocol Buffers CLI toolkit. The module declares Go 1.26.6;
+the test and release workflows use <code>go-version-file: go.mod</code>. CI installs Task 3.x.
+
+| Tool | Version / source | Purpose |
+|---|---|---|
+| Go | 1.26.6 (<code>go.mod</code>) | Build and test the CLI |
+| Task | 3.x in CI | Run the repository task targets |
+| Docker | Required by lint and image tasks | Run Hadolint and build images |
+| Git | Required by EasyP module operations and releases | Work with Git-backed proto dependencies |
+
+<code>Taskfile.yml</code> installs project-local helpers into <code>bin/</code>:
+<code>golangci-lint</code> 2.14.0, <code>gotestsum</code> 1.13.0, and <code>mockery</code> 2.53.7.
+Hadolint v2.12.1-beta is pulled as a Docker image instead of installed
+locally. <code>LOCAL_BIN</code> is anchored to the root Taskfile directory, so tools
+install and run from the same location when Task is invoked in a subdirectory.
+Paths are shell-quoted, including repository paths containing spaces.
+
+### First Run
+
+1. Clone the repository and enter its root.
+2. Install Go 1.26.6 and Task.
+3. Ensure Docker is available if you will run <code>task lint</code>, Docker image
+   tasks, or release snapshots.
+4. Run <code>task init</code>. It installs the local Go tools into <code>bin/</code> and runs
+   <code>go mod download</code> to fetch existing dependencies without an upgrade step.
+5. Run <code>task test</code> to verify the checkout.
+6. Run <code>task build</code> to create the root-level <code>easyp</code> executable.
+
+The repository has no <code>docker-compose</code> file or service startup target. EasyP
+is a CLI, so development verification is normally a build or test command.
+
+## Overview
+
+Prefer <code>task</code> targets from <code>Taskfile.yml</code>; they encode the local tool paths,
+coverage settings, race detection, and Docker-based lint checks used by the
+project.
+
+## Quick Reference
+
+| Action | Command |
+|---|---|
+| Install development helpers | <code>task init</code> |
+| Build the CLI | <code>task build</code> |
+| Run the full test suite | <code>task test</code> |
+| Run lint checks | <code>task lint</code> |
+| Run Go lint without Docker | <code>task lint:go</code> |
+| Lint root Dockerfile | <code>task lint:docker</code> |
+| Run tests and lint | <code>task quality</code> |
+| Open HTML coverage | <code>task coverage</code> |
+| Install the CLI into <code>GOBIN</code> | <code>task install</code> |
+| Remove local build/tool artifacts | <code>task clean</code> |
+| Regenerate config schemas | <code>task schema:generate</code> |
+| Check config schema drift | <code>task schema:check</code> |
+| Generate optional core and console mocks | <code>task mocks</code> |
+| Check Task dispatch offline | <code>task dev-tools:check</code> |
+| Build the current Docker image locally | <code>task docker:build</code> |
+| Validate/generate the native v1 example | <code>task proto:check</code> |
+
+## Build and Install
+
+~~~bash
+task build
+task install
+~~~
+
+<code>task build</code> runs <code>go build -o easyp ./cmd/easyp</code>, placing a local executable
+at <code>./easyp</code>. <code>task install</code> instead runs <code>go install ./cmd/easyp</code> and uses
+the Go installation destination. Neither task needs generated schemas or
+mocks as a prerequisite.
+
+The direct build equivalent is:
+
+~~~bash
+go build -o easyp ./cmd/easyp
+~~~
+
+The root <code>Dockerfile</code> is a separate production build path. It compiles with
+<code>CGO_ENABLED=0</code> using <code>golang:1.26-alpine</code> and packages the binary in
+<code>alpine:3.22</code> with CA certificates, timezone data, Git, and Bash.
+
+## Testing and Coverage
+
+~~~bash
+task test
+task coverage
+~~~
+
+<code>task test</code> invokes the project-local <code>bin/gotestsum</code> with:
+
+~~~bash
+bin/gotestsum --format pkgname -- -coverprofile=coverage.out -race -count=1 ./...
+~~~
+
+This is the repository-wide test command: it records coverage in
+<code>coverage.out</code>, enables the race detector, and disables Go test caching.
+<code>task coverage</code> opens that existing profile with <code>go tool cover -html</code>; run
+<code>task test</code> first. See [TESTING.md](TESTING.md) for conventions and narrower
+Go commands.
+
+## Linting and Quality
+
+~~~bash
+task lint
+task quality
+~~~
+
+<code>task lint</code> attempts both <code>lint:go</code> and <code>lint:docker</code>, then returns
+a failure if either fails. No binary build is required. <code>task lint:go</code> invokes
+<code>bin/golangci-lint run ./...</code>; the checked-in <code>.golangci.yml</code> enables
+<code>staticcheck</code>. <code>task lint:docker</code> feeds root <code>Dockerfile</code> to the pinned
+Hadolint image and requires Docker with a running daemon. Run either check
+independently to diagnose failures. Missing local tools report their install
+task; lint findings and Docker failures are not suppressed.
+
+<code>task quality</code> depends on both <code>task test</code> and <code>task lint</code>. It is the closest
+local approximation of the test and lint checks. CI's <code>tests.yml</code> workflow
+performs <code>task init</code>, <code>task lint:go</code>, a Linux ARMv7 cross-compile,
+<code>task test</code>, <code>task proto:check</code>, <code>task dev-tools:check</code>, and a
+pinned GoReleaser configuration check. Docker lint remains a separate local check.
+
+## Generated Artifacts
+
+### Configuration JSON Schema
+
+~~~bash
+task schema:generate
+task schema:check
+~~~
+
+<code>task schema:generate</code> runs <code>go run ./cmd/easyp schema-gen --out-dir schemas</code>.
+The generator derives separate versioned and latest JSON Schemas from the v1
+models for <code>easyp.yaml</code>, <code>easyp.gen.yaml</code>, and <code>protobuf.lock</code>. The text
+<code>protobuf.mod</code> manifest is validated by <code>easyp validate-config</code>.
+
+Use <code>task schema:check</code> after changing v1 configuration models or validation.
+It generates all six artifacts in a temporary directory and diffs that directory
+against <code>schemas/</code>, without rewriting committed files:
+
+- <code>schemas/easyp-v1.schema.json</code> and <code>schemas/easyp.schema.json</code>
+- <code>schemas/easyp.gen-v1.schema.json</code> and <code>schemas/easyp.gen.schema.json</code>
+- <code>schemas/protobuf.lock-v1.schema.json</code> and <code>schemas/protobuf.lock.schema.json</code>
+
+Do not hand-edit those generated JSON files.
+
+### Test Mocks
+
+~~~bash
+task mocks
+~~~
+
+<code>task mocks</code> is an optional Mockery helper for <code>Rule</code> and
+<code>CurrentProjectGitWalker</code> in <code>internal/core</code>, and <code>Console</code> in
+<code>internal/adapters/console</code>. Outputs go into each owning package's
+<code>mocks/</code> subdirectory. The individual helper accepts <code>task mock NAME=Rule
+DIR=./internal/core</code>. Neither build nor test depends on these outputs.
+Existing tests use handwritten doubles, with no checked-in Mockery outputs
+or <code>go:generate</code> directives. Compile generated mocks before using them;
+do not commit unused outputs. See [TESTING.md](TESTING.md).
+
+### Taskfile Smoke Test
+
+<code>task dev-tools:check</code> runs <code>scripts/check-dev-tools.sh</code> using installed
+Task and standard shell utilities. It copies the Taskfile and fixture inputs
+to a temporary directory, replaces tools with trace executables, and invokes
+Task from a nested path containing spaces and quotes. It verifies dispatch,
+mock owners, missing-tool messages, installer and lint failure propagation,
+local-only Docker builds, and unchanged module manifests. It is deterministic
+and offline; actual tool compatibility and source lint still need real tools.
+
+## Docker and Release Checks
+
+~~~bash
+task docker
+task docker:build DOCKER_IMAGE=easyp:local
+task goreleaser:check
+task goreleaser:test
+task goreleaser:test-docker
+~~~
+
+<code>task docker</code> aliases <code>docker:build</code>, which builds root <code>Dockerfile</code>
+locally with the overridable <code>DOCKER_IMAGE</code> tag (default <code>easyp:local</code>).
+Neither target publishes an image. The obsolete <code>docker_base</code>,
+<code>docker_lint</code> and <code>docker_push</code> targets have been removed. Publishing
+remains in the existing release workflow.
+
+<code>task goreleaser:check</code> validates GoReleaser configuration. The snapshot
+tasks create or select a <code>multiarch</code> Docker Buildx builder and run
+<code>goreleaser release --snapshot --clean</code>; they do not publish a release.
+The pinned GoReleaser version is <code>2.18.2</code>; CI also runs its configuration check.
+This branch's release workflow accepts only explicit
+<code>v1.0.0-nightly.YYYYMMDD.N</code> tags and authenticates to GitHub Container Registry.
+It never updates GitHub Latest, the stable Homebrew formula, or the Docker
+<code>latest</code> tag. See [nightly release operations](DEPLOYMENT.md).
+
+## Dependency and Vendor Tools
+
+EasyP module dependencies are Git repositories, cached under <code>EASYPPATH</code>
+(default <code>$HOME/.easyp</code>) and locked in <code>protobuf.lock</code>. The vendoring command is:
+
+~~~bash
+./easyp mod vendor
+~~~
+
+It verifies the v1 lock, then copies <code>.proto</code> files from locked dependency
+roots to <code>easyp_vendor</code> by import path. Local replacements use the
+effective graph without writing the published lock. It rejects
+duplicate import paths. This is a materialized dependency tree, separate from
+the module cache and Go's usual <code>vendor/</code> directory. See
+[config/dependency.md](config/dependency.md) for the authoritative dependency
+flow and available <code>easyp mod</code> subcommands.
+
+## Native v1 Example
+
+<code>task proto:check</code> invokes <code>scripts/check-proto-example.sh</code>. The script builds
+a temporary CLI, copies the four repository v1 files and <code>examples/proto</code>,
+validates configuration, tidies and compares the lock, lints, then generates
+twice and compares descriptors and generated output. Its work and cache are
+isolated in a temporary directory. It runs in the test workflow.
+
+## Tool Installation
+
+| Tool | Installation used by this repository |
+|---|---|
+| Go | Install Go 1.26.6, then verify with <code>go version</code> |
+| Task | Install Task 3.x; CI uses <code>arduino/setup-task@v1</code> |
+| GolangCI-Lint | <code>task init</code> installs it into <code>./bin</code> |
+| Gotestsum | <code>task init</code> installs it into <code>./bin</code> |
+| Mockery | <code>task init</code> installs it into <code>./bin</code> |
+| Hadolint | <code>task lint</code> pulls <code>ghcr.io/hadolint/hadolint:v2.12.1-beta</code> |
+| GoReleaser | Provide <code>goreleaser</code> on <code>PATH</code> for its Task targets |
+
+The GolangCI-Lint installer is downloaded from its fixed release tag before
+execution; a failed download or installer fails the task. Go helpers use
+versioned <code>go install</code> commands with repository-local <code>GOBIN</code>.
+Mockery remains on v2.53.7; if its build or package loader reports an older
+<code>golang.org/x/tools</code> compatibility error, capture that failure without
+changing the root module's dependencies to accommodate the development tool.
+
+<code>task clean</code> removes <code>bin/</code> and <code>coverage.out</code>, then clears the Go build
+cache. It does not remove module caches, EasyP's dependency cache, schemas,
+or the root-level <code>easyp</code> binary.
diff --git a/.spec/agent-rules.md b/.spec/agent-rules.md
new file mode 100644
index 00000000..f61310fa
--- /dev/null
+++ b/.spec/agent-rules.md
@@ -0,0 +1,58 @@
+<!-- generated: 2026-09-30, template: bootstrap.md -->
+# Agent Rules — EasyP
+
+Mandatory rules for AI agents. Prefer these over generic Go guides when they conflict. Expanded skills: [go-code-style](../.agents/skills/go-code-style/SKILL.md), [go-testing](../.agents/skills/go-testing/SKILL.md). Dependency details: [config/dependency.md](./config/dependency.md). The bundled skills describe this CLI; the legacy epctl-commands skill name is retained for compatibility, not as an instruction to use the separate service CLI.
+
+## Code Style
+
+- Wrap errors as <code>fmt.Errorf("&lt;called_function&gt;: %w", err)</code> — function/method name only, **no package prefix**.
+- Do not assign inside <code>if</code> conditions except <code>:=</code> for block-scoped vars; assign then check on separate lines.
+- Never bare <code>defer x.Close()</code> — always wrap Close and log/handle the error.
+- No inline comments on <code>if</code> / <code>for</code> / <code>return</code> lines; comments go above if needed.
+- Imports: stdlib → third-party → project (repository convention; current lint config does not enable <code>gci</code>); comments and godoc in English; exported symbols need godoc starting with the name.
+- Interfaces: context first, error last, no <code>I</code> prefix; prefer defining interfaces in the consumer package.
+- Enums: reserve zero with <code>_ = iota</code> so unset values are never silently valid.
+
+## Naming Conventions
+
+- Files: colocated tests as <code>&lt;file&gt;_test.go</code>; lint rules as <code>internal/rules/&lt;rule&gt;.go</code>.
+- Types: exported domain/entities and adapter implementations; keep config structs unexported when local.
+- Struct tags: follow existing public config spellings, usually <code>snake_case</code>; retain established hyphenated keys such as <code>linters-settings</code> and <code>exclude-rules</code>.
+- Do not invent parallel agent instruction files (<code>.cursor/rules/</code>, <code>CLAUDE.md</code>); root <code>AGENTS.md</code> + <code>.spec/</code> are the source of truth.
+
+## Error Handling
+
+- Wrap at every call site with <code>%w</code>; use <code>errors.Is</code> / <code>errors.As</code> for sentinels. The lint configuration exempts identifier-style exported callee labels from ST1005, not capitalized prose errors.
+- Reuse existing errors in their owning packages: core parsing/breaking types, <code>modules.ErrLockedVersionChanged</code>, <code>v1.ErrLegacyConfiguration</code>, and contextual migration errors. See [ERRORS.md](./ERRORS.md); do not invent duplicate sentinels.
+- CLI: inspect the actual handler and process entrypoint before assigning exit codes. Local replacements preserve the published lock; explicit frozen mode verifies only the published graph and unknown-import discovery is intentionally excluded; there is no universal package-manager sentinel-to-exit mapper.
+
+## Testing
+
+- Use <code>testify</code> (<code>require</code> for fatal preconditions, <code>assert</code> for non-fatal checks).
+- New slice-based table tests require a <code>name</code> field. Use <code>t.Parallel()</code> at top level and in isolated subtests; tests that change process cwd/environment must stay sequential. Existing rule tests also use named map keys.
+- No shared mutable mocks/state across parallel sub-tests — construct deps per case.
+- Prefer <code>require.ErrorIs</code> for expected errors; run with <code>-race</code> (<code>task test</code>).
+- Update test doubles when consumer interfaces change. Optional <code>task mocks</code> uses <code>internal/core</code> for <code>Rule</code>/<code>CurrentProjectGitWalker</code> and <code>internal/adapters/console</code> for <code>Console</code>. Preserve handwritten doubles and compile any generated mocks before using them; see [TESTING.md](./TESTING.md).
+
+## Dependencies
+
+- Native v1 proto dependencies come from <code>protobuf.mod</code> <code>require</code> directives, never removed <code>generate.inputs</code>. Lock with <code>protobuf.lock</code>; cache under <code>EASYPPATH</code> (default <code>~/.easyp</code>). Legacy inputs are read only by dependency compatibility/migration adapters.
+- Vendor directory is <code>easyp_vendor</code>, not <code>vendor/</code>.
+- Use <code>easyp mod download</code> (lock-first) vs <code>easyp mod update</code> (refresh from <code>protobuf.mod</code>); commit <code>protobuf.lock</code> for CI reproducibility.
+- No remotes/mirrors/auth fields in <code>easyp.yaml</code> — auth via system git.
+- Regenerate schemas via <code>task schema:generate</code>: <code>schemas/easyp-v1.schema.json</code>, <code>schemas/easyp.schema.json</code>, <code>schemas/easyp.gen-v1.schema.json</code>, <code>schemas/easyp.gen.schema.json</code>, <code>schemas/protobuf.lock-v1.schema.json</code>, <code>schemas/protobuf.lock.schema.json</code>. Never hand-edit these outputs.
+- Use the implemented descriptor-based FILE/PACKAGE/WIRE_JSON/WIRE catalog; omitted or empty categories default to FILE for v1 policies; use [CLI.md](./CLI.md) for current v1 behavior and the migration wizard.
+
+## Formatting
+
+- Format with <code>gofmt</code> / project tooling; <code>task lint</code> attempts <code>lint:go</code> and <code>lint:docker</code> and reports either failure. Hadolint checks root <code>Dockerfile</code> and requires Docker; <code>task lint:go</code> runs independently.
+- Do not commit secrets, generated dependency directories, <code>coverage.out</code>, or the local <code>easyp</code> binary in the repo root. The docs site is maintained in a separate repository.
+- After behavior changes, run tests for touched packages; after schema changes, run <code>task schema:check</code>.
+
+## Quick Checklist
+
+- [ ] Error wrap = callee name only; no bare <code>defer Close()</code>
+- [ ] Tests: named cases, <code>t.Parallel</code>, no shared mutable mocks
+- [ ] Schema JSON regenerated, not hand-edited; vendor = <code>easyp_vendor</code>
+
+Shared producer policies use section-scoped <code>extends</code> from bounded local files or already declared/locked modules. See [.spec/config/policy-extends.md](config/policy-extends.md). No standalone policy versions or unpinned reference downloads are allowed.
diff --git a/.spec/config.yaml b/.spec/config.yaml
new file mode 100644
index 00000000..de6c0872
--- /dev/null
+++ b/.spec/config.yaml
@@ -0,0 +1,7 @@
+context: EasyP is a Protocol Buffers CLI toolkit (Go) — lint, breaking, generate, easyp mod.
+docs_dir: .spec
+doc_freshness_days: 30
+auto_branch: false
+auto_worktree: false
+test_skill: go-testing
+rules.docs: Prefer code under internal/ and AGENTS.md over marketing docs. Vendor dir is easyp_vendor. Link .spec/config/dependency.md for package manager details.
diff --git a/.spec/config/breaking-profiles.md b/.spec/config/breaking-profiles.md
new file mode 100644
index 00000000..2a003059
--- /dev/null
+++ b/.spec/config/breaking-profiles.md
@@ -0,0 +1,36 @@
+# Descriptor-based breaking profiles
+
+Nonempty <code>breaking.categories</code> selects real descriptor-based profiles: <code>FILE</code>, <code>PACKAGE</code>, <code>WIRE_JSON</code>, or <code>WIRE</code>. Omitted or empty categories default to FILE for v1 policies; this is not an alias for WIRE. The low-level Core API still keeps its historical empty-category behavior for compatibility with direct legacy callers. Multiple profiles apply their union without duplicate diagnostics.
+
+| Change | FILE | PACKAGE | WIRE_JSON | WIRE |
+|---|---|---|---|---|
+| Move a declaration within its package, preserving options | Reject | Allow | Allow | Allow |
+| Rename a field, even with its old JSON name retained | Reject | Reject | Reject | Allow |
+| Change int32 to int64 | Reject | Reject | Reject | Allow |
+| Change int32 to uint32 | Reject | Reject | Allow | Allow |
+| Change string to bytes | Reject | Reject | Reject | Allow |
+| Change bytes to string or int32 to sint32 | Reject | Reject | Reject | Reject |
+| Delete a non-required field | Reject | Reject | Reserve number and name | Reserve number |
+| Add/remove a required field or change a real oneof | Reject | Reject | Reject | Reject |
+| Add explicit optional presence | Reject | Reject | Allow | Allow |
+| Convert repeated entry messages to a compatible map | Reject | Reject | Reject | Allow |
+
+A map is encoded as repeated entry messages; repeated scalar values are not compatible merely because their type equals the map value type. Existing reserved names and number ranges cannot be released in any profile. Enum aliases are checked by name/number pairs for source/JSON and by retained numbers for WIRE. RPC/service removal, request/response identity, streaming, idempotency, and actual default-value changes remain checked. Source profiles additionally check supported file/field code-generation options, enum openness, declaration and extension ranges. WIRE_JSON also checks JSON format capability.
+
+Current and baseline sources are compiled separately using their own imports and pinned revisions. Diagnostics retain source coordinates and repository-relative paths; consumer managed options are not applied. Profiles work with section-scoped extends, ignores, local overlays and frozen verification. No source, manifest, lock or plugin output is written by breaking.
+
+The precise implemented rule catalog is <code>internal/config/breaking_profiles.go</code>. This feature does not claim full rule-for-rule Buf equivalence. It checks standard descriptor properties and supported effective Edition features, not arbitrary application-defined option semantics or external generated-code behavior. Unsupported syntax/editions are rejected by the pinned compiler instead of being declared compatible.
+
+## Selection and verification
+
+~~~yaml
+version: v1
+breaking:
+  baseline: git:main
+  categories: [WIRE_JSON]
+  ignore_unstable: true
+~~~
+
+Runtime and generated schema use the same profile catalog; MCP describes that selection. Existing direct low-level FilesCheck callers may still use the historical AST checker. v1 CLI policies with omitted or empty categories select FILE. Explicit profiles compare linked descriptors with normalized full type identities, real versus synthetic oneofs, and effective inherited features. Ranges use int64 interval coverage, including inclusive enum maximum endpoints; no iteration over reserved numbers.
+
+The external matrix lives in tests/e2e/v1/breaking_profiles_parent_test.go in easyp-test. It includes real Git baselines, declaration moves/import aliases, unchanged files, max ranges, local historical dependencies, shared extends, frozen mode and JSONL diagnostics.
diff --git a/.spec/config/dependency.md b/.spec/config/dependency.md
new file mode 100644
index 00000000..c694b269
--- /dev/null
+++ b/.spec/config/dependency.md
@@ -0,0 +1,190 @@
+# EasyP v1 Dependency Management
+
+Source of truth: <code>internal/modules</code>, <code>internal/config/v1</code>, <code>internal/adapters/gitmodules</code> and <code>internal/adapters/module_config</code>. The architectural boundaries are documented in [ARCHITECTURE.md](../ARCHITECTURE.md).
+
+## Declaration
+
+Each independently required module has a native text <code>protobuf.mod</code>, parsed by
+<code>ParseModule</code> in <code>internal/config/v1/module.go</code>. This is the dependency source;
+<code>easyp.gen.yaml</code> selects modules for generation and does not declare dependencies
+through the removed <code>generate.inputs</code> format. Example manifest:
+
+~~~text
+module github.com/acme/contracts/orders
+roots proto
+require (
+    github.com/acme/contracts/common
+    github.com/acme/types v1.2.3
+)
+~~~
+
+- Exactly one <code>module</code> directive is required; it identifies the module, including its directory when nested in a repository. <code>roots</code>, <code>require</code> and <code>replace</code> accept multiline blocks or individual directives. Block entries cannot share the opening/closing line. Duplicate require/replace sources are errors.
+- <code>roots</code> are relative to that manifest's directory and default to <code>.</code>.
+- Each dependency is a separate <code>require</code>. A version may be omitted, a semantic version, or a full Git commit, and is always a separate token: <code>require module v1.2.3</code>. Forms such as <code>require module@v1.2.3</code> or <code>replace module@v1.2.3 =&gt; path</code> are rejected instead of treating <code>@version</code> as part of module identity. An <code>@</code> inside a URL authority, such as <code>ssh://git@host/repo</code>, remains part of the transport URL.
+- Versionless requirements resolve repository HEAD on first use. Tidy preserves an existing locked commit; update refreshes it. Tags are not required for this path or explicit commits.
+- Semantic versions resolve actual tags. For a nested module, that means a directory-prefixed tag such as <code>common/v1.2.3</code>; an untagged module should use an omitted version or commit.
+- <code>easyp get repo@common-protos-1_3_1</code> also accepts named Git tags. It resolves the tag and writes the full commit into the requirement and lock; subsequent frozen operations do not depend on that tag. Branch names are not named tags.
+- <code>replace &lt;module&gt; =&gt; &lt;local-path&gt;</code> supplies local source roots. Relative paths resolve from the consuming manifest directory; absolute replacement paths are used directly. Roots within a module cannot escape its directory.
+- Normal project commands use v1 manifests. Legacy metadata is read by dependency compatibility adapters and the explicit <code>easyp migrate</code> preview/apply workflow. <code>easyp migrate --interactive</code> starts the migration wizard; migration never consists of simply renaming a legacy lock. See [CLI.md](../CLI.md).
+
+Nested modules get separate lock entries even when their commits match. The Git adapter tries repository candidates and the metadata reader confirms the requested module name at the candidate directory. A root manifest does not hide named nested modules.
+
+## Major versions and Git mapping
+
+EasyP uses Go-style semantic import versioning for module identities. Native <code>module</code>, <code>require</code>, <code>replace</code> source identities, fetched metadata and lock entries are checked; changing only the consumer manifest cannot bypass the check.
+
+- v0 and v1 share the unsuffixed identity. From v2 onward, the final path component is <code>vN</code>, where N is a decimal integer of at least 2 without leading zeros, and the SemVer major must equal N.
+- <code>/v0</code>, <code>/v1</code>, <code>/v01</code> and numeric dotted suffixes such as <code>/v2.0</code> are invalid module suffixes. Ordinary components such as <code>/2024</code> or <code>/v2beta</code> are not major suffixes. The check concerns module identities, not directories or protobuf import paths inside a module.
+- <code>golang.org/x/mod/module.SplitPathVersion</code> and <code>CheckPathMajor</code> implement the suffix rules (including Go's <code>gopkg.in/name.vN</code> spelling). Absolute local Git fixture paths and explicit transport URLs remain supported; the URL host/path is checked without treating credentials or a port as a module suffix. Transport spelling remains part of identity and is not silently normalized.
+- Omitting a version or using a full commit does not waive exact native manifest identity checks. These refs provide no semantic major to infer; a valid declared identity is still required.
+
+| Requested identity | Allowed physical manifest directory | Release tag |
+|---|---|---|
+| <code>repo</code> at <code>v1.2.0</code> | repository root | <code>v1.2.0</code> |
+| <code>repo/v2</code> at <code>v2.0.0</code> | root or <code>v2/</code> | <code>v2.0.0</code> |
+| <code>repo/sub/v2</code> at <code>v2.0.0</code> | <code>sub/</code> or <code>sub/v2/</code> | <code>sub/v2.0.0</code> |
+
+The final slash major suffix is logical: it is excluded from the repository candidate and the tag prefix. A tag alone does not establish module identity; the manifest at an allowed location must declare the exact requested source. Lightweight and annotated tags resolve to commits. A <code>v2/v2.0.0</code> tag does not release <code>repo/v2</code>.
+
+<code>repo</code> and <code>repo/v2</code> are separate MVS, lock, cache and replacement identities. They may coexist when their protobuf import paths are distinct. EasyP never rewrites protobuf packages or imports; duplicate import paths still fail, even for identical content. Same-identity maximum-minimum selection, exact SHA/tag agreement, immutable tags, local overlays and explicit frozen checks remain in force.
+
+The Go pre-module <code>+incompatible</code> exception is supported for an unsuffixed v2+ requirement whose exact Git revision has no native root <code>protobuf.mod</code> and no matching nested native manifest. <code>easyp get repo@v2.0.0</code> adds the marker after verifying this boundary; a manually written manifest must include it explicitly. For example, <code>repo v2.0.0+incompatible</code> resolves the root tag <code>v2.0.0</code>, never a tag literally ending in <code>+incompatible</code>. Fetch, migration, cold installation and warm cache reads verify this metadata boundary. Update preserves the marker for eligible legacy releases and rejects a selected revision that has become native. Markers on v0/v1 or on suffixed identities are rejected. An unmarked unsuffixed v2+ requirement remains invalid.
+
+Migration does not invent a namespace, add a compatibility marker, or change a source/version. For an old unsuffixed native v2+ dependency, select a published <code>/vN</code> identity and matching version, or explicitly choose an unsuffixed v0/v1 release, then retry. A published native manifest can never qualify for the legacy exception. As in Go, an unversioned local replacement may contain a native manifest with the same unsuffixed identity even when replacing an explicit legacy <code>+incompatible</code> requirement. This overlay does not certify a published revision and cannot change the shared lock; frozen mode rejects replacements. Requirements read from older metadata are checked again when used at the actual source boundary.
+
+See [Go major version suffixes](https://go.dev/ref/mod#major-version-suffixes) and [mapping versions to commits](https://go.dev/ref/mod#vcs-version).
+
+## Lock and cache
+
+<code>protobuf.lock</code> is YAML with integer <code>version: 1</code> and a <code>modules</code> sequence. Each entry has <code>source</code>, <code>version</code>, <code>commit</code> and <code>hash</code>; the resolver sorts by source. Commits must be full 40- or 64-character hexadecimal hashes; <code>hash</code> is <code>h1:</code> plus a base64 SHA-256 digest. A commit-valued version must equal the commit. Duplicate sources, unknown fields and multiple YAML documents are rejected. The hash covers the installed regular-file snapshot using Go's directory-hash algorithm. Git symlinks and submodules are omitted, even when a symlink is materialized as a regular file by <code>core.symlinks=false</code>. Dependency config files must be regular Git files. Buf file filters are applied before hashing and installation; non-proto regular files remain included. Legacy lock migration retains its stricter non-regular-file rejection because it must reproduce the old hash.
+
+The CLI resolves <code>EASYPPATH</code> once for a command that needs the cache (default <code>$HOME/.easyp</code>). <code>gitmodules.Cache</code> owns <code>&lt;EASYPPATH&gt;/v1/git</code>, source keys, temporary checkout names and installation paths. Installed snapshots live under its <code>modules/&lt;source-key&gt;/&lt;commit&gt;</code> layout; reusable bare object stores live under <code>objects/&lt;remote-key&gt;</code>, with OS locks for concurrent fetches. Application callers request cached module metadata and its physical directory; they do not assemble cache paths.
+
+<code>Cache.Install</code> verifies locked contents, including cache hits. A newly installed snapshot is checked with the full <code>h1:</code> directory hash. On Darwin/Linux, later unchanged hits use a sidecar verification stamp keyed by the expected lock hash plus an inode/ctime metadata fingerprint; any metadata change invalidates the stamp and forces the full directory hash again. Content changes therefore remain detectable even when size and mtime are restored. Platforms without a strong change token keep the full-hash path. The stamp is an optimization of the per-user local cache, not an additional source of dependency identity. Cached objects support shallow pinned-commit fetches with an advertised-history fallback; neither path substitutes HEAD for an unavailable pin. <code>Cache.Cached</code> reads installed metadata without downloading or rewriting module contents and requires prior verification. Git credentials and transport configuration remain the responsibility of system Git.
+
+## Operations
+
+| Command | Application operation | Behavior |
+|---------|-----------------------|----------|
+| <code>get &lt;module&gt;[@version\|@commit]</code> | <code>modules.Get</code> | Add/promote a direct requirement, resolve the graph and add transitive requirements |
+| <code>mod tidy</code> | <code>modules.Tidy</code> | Resolve requirements, preserve versionless pins, validate imports and write manifest/lock |
+| <code>mod download</code> | <code>modules.Download</code> | Validate the lock against the manifest before installing exact locked contents |
+| <code>mod update</code> | <code>modules.Update</code> | Refresh HEAD requirements and tagged requirements within the existing major version; retain explicit commit pins |
+| <code>mod vendor</code> | <code>modules.Vendor</code> | Verify locked sources and copy their import paths into <code>easyp_vendor</code> |
+
+Tidy/get/update preserve existing manifest comments while editing requirements.
+<code>Get</code> adds/promotes the requested requirement as direct and records other derived
+requirements as <code>// indirect</code>. <code>Update</code> resolves from explicit direct entries,
+then classifies transitive requirements imported by root proto files as direct.
+<code>Tidy</code> also classifies newly added transitive entries and promotes an existing
+<code>// indirect</code> entry when a root proto directly imports it. The current
+<code>augmentV1ManifestRequirements</code> checks existing derived entries instead of
+skipping them, preserves their version spelling, and removes only the indirect
+marker. Its regression case is <code>TestTidyPromotesIndirectWithoutChangingLock</code>
+in <code>internal/modules/operations_test.go</code>.
+Sources: <code>internal/modules/get.go</code>, <code>internal/modules/update.go</code>,
+<code>internal/modules/operations.go</code>, <code>internal/modules/manifest_requirements.go</code>.
+
+### Local effective graph
+
+Only replacements in the main (consuming) module apply, including to required transitive modules. Dependency manifests contribute their requirements, but their replacements are ignored. A replacement alone never introduces a dependency; unused replacements are not read or downloaded. All relative replacement paths are based on the main manifest directory, even at transitive depths. Absolute paths work directly. A native replacement manifest must declare the replaced identity; missing directories and identity mismatches are contextual errors. Legacy metadata uses the existing roots/requirements adapter without executing dependency plugins or loading dependency generation policy.
+
+<code>EnsureEffectiveGraph</code> reuses the existing version resolver with local metadata lookup. Local modules have no synthetic version, commit, hash or lock entry. Ordinary dependency cycles are deduplicated; contradictory local directory identities fail. Needed unreplaced modules reuse matching published revisions (or versionless pins) after <code>Cache.Install</code> verification. New fork requirements resolve through the real <code>Source.Fetch</code> interface and immutable-version guard, then install verified snapshots. Selection and roots remain in memory.
+
+While the main manifest contains any replacements, every operation preserves existing <code>protobuf.lock</code> bytes and does not create a missing lock. No local source information or fork-only transitive graph is persisted there. This is an explicit EasyP lock invariant: <code>protobuf.lock</code> is not Go's <code>go.sum</code>, and this does not claim that Go never changes <code>go.sum</code> with replacements.
+
+- <code>mod tidy</code> validates the effective graph/imports and installs needed remote snapshots without changing the manifest or lock.
+- <code>get</code> can add/promote/change the explicitly requested requirement; <code>mod update</code> refreshes unreplaced direct requirements with the existing version rules. Replaced requirements need no remote fetch or version lookup. Neither command promotes fork-only transitives or writes a lock.
+- <code>mod download</code> resolves and verifies only needed unreplaced snapshots, including new fork dependencies, without downloading replaced roots or unused published-lock entries.
+- Generate (including selected dependencies and both descriptor modes), lint, ls-files and breaking use the same overlay. In-repository baseline replacements are mapped into the Git snapshot; external baseline replacements remain errors. A versionless remote dependency introduced by a historical fork requires a historical lock pin; current HEAD cannot stand in for the baseline.
+- <code>mod vendor</code> snapshots the effective local and remote dependency sources into <code>easyp_vendor</code> without writing the shared lock. It is a local artifact, not proof of a reproducible published graph. Remove replacements and run <code>mod tidy</code> before publishing the manifest/lock.
+
+A pure-local graph works unpublished and offline without a lock. New remote requirements can require network access; matching published revisions and versionless pins use verified cache when available. Remote plugins retain their own network requirements. These overlay rules apply outside explicit frozen mode; <code>CI=true</code> alone does not change them.
+
+Import checking parses root sources and their reachable dependency/embedded
+imports, validates portable relative import paths, and reports the importing file.
+Unresolved imports fail resolution with <code>cannot resolve imports</code>;
+tidy does not infer a new Git module identity from an unknown proto import.
+<code>modules.ErrLockedVersionChanged</code> protects an already locked semantic version
+from silently changing commit/hash; explicit versionless updates still refresh
+HEAD. See <code>internal/modules/immutable_versions.go</code> and [ERRORS.md](../ERRORS.md)
+for the distinction between such errors and CLI exit classification.
+
+The resolver accepts <code>Source.Fetch</code>, independent of Git/cache. It selects the highest required semantic version, treats versionless requirements as weak constraints, and rejects incompatible exact commits (including tag/commit disagreement). It caches revision fetches within a resolution, rebuilds provisional HEAD edges when stronger requirements appear, and sorts resulting entries. <code>Update</code> additionally needs version enumeration; vendor and published download only need the cache contract; local-overlay download additionally uses Source when a new remote requirement needs resolution.
+
+## Frozen graph validation
+
+Explicit <code>--frozen</code> requires <code>protobuf.mod</code> and <code>protobuf.lock</code> for each selected native dependency graph, even for a module with no dependencies. An empty graph must have an empty lock. A plain source tree without a manifest fails with a missing-manifest diagnostic. Frozen mode is never inferred from CI environment variables. See [CLI flag placement](../CLI.md#frozen-dependency-mode).
+
+All root replacement directives are forbidden, even when unused. Validation rejects them before opening replacement directories or accessing dependency caches/remotes. Dependency manifests still supply transitive requirements; dependency-local replacements remain ignored. The locked closure must satisfy direct and transitive requirements with no missing or stale entries. Malformed locks, incompatible versions/commits and unexpected graph entries fail instead of triggering resolution.
+
+The frozen path does not call the version resolver, query HEAD or tags, or create/rewrite manifests and locks. Exact locked commits may be downloaded when absent from cache; installed sources are lock-hash verified on cold paths, while unchanged Darwin/Linux warm hits reuse the verified metadata stamp and fall back to a full <code>h1:</code> check after any detected filesystem change. This permits reproducible dependency selection with a cold cache and does not imply offline execution. Existing Git credentials, transport configuration, and plugin network requirements still apply.
+
+- <code>mod download</code> validates and installs the locked graph; <code>mod vendor</code> validates it before replacing vendor output.
+- <code>mod tidy</code>, <code>get</code>, <code>mod update</code>, and <code>init</code> refuse frozen operation. <code>migrate</code>, including preview and interactive mode, is also rejected.
+- Generation preflights every selected graph before any plugin runs. Explicit workspace-relative module paths use the selected module's manifest and lock; a generator-only directory needs no separate pair. Dependency identity selectors require the consumer manifest and lock, without requiring lock files inside downloaded dependencies. Unrelated projects are ignored and existing explicit/recursive selection rules remain unchanged.
+- Lint retains effective policy/module grouping. Breaking uses the historical manifest and lock for its baseline, independently from the current module. Local-only <code>ls-files</code> output still requires frozen graph validation.
+
+Run normal <code>mod tidy</code> after removing local replacements to prepare the shared lock, then commit the manifest and lock. Frozen success never certifies unpublished local overlays, and normal replacement/vendor semantics above remain unchanged.
+
+## Metadata and imports
+
+<code>module_config</code> handles dependency metadata in these forms:
+
+- V1 <code>protobuf.mod</code>, including named nested manifests.
+- Legacy EasyP <code>protobuf.mod</code> requirements and <code>easyp.yaml</code> inputs.
+- Buf v1 workspace/module configs and Buf v2 module roots.
+- No config: the repository directory is the default root.
+
+Root config detection checks existence; parsing belongs to format-specific readers. Missing optional files are normal. Invalid files and filesystem errors are returned. Buf roots take precedence over legacy EasyP roots when both formats occur; legacy requirements are still extracted. Buf v2 <code>modules[].includes/excludes</code> and v1/v1beta1 <code>build.excludes</code> filter proto files without changing their import paths. All paths are relative to the declaring <code>buf.yaml</code>; nested v1 workspace configs are rebased to the repository. A file selected by any of the Buf modules remains available.
+
+Buf <code>deps</code> in Git dependencies are passed to <code>modules.BSRResolver</code>. The current <code>bsr.StaticResolver</code> uses an explicit table of fixed Git compatibility snapshots. Its output is the existing <code>v1.Requirement</code>; the dependency graph, Git acquisition, import checks and indirect requirement editing keep their existing paths. Native <code>protobuf.mod</code> takes precedence over Buf metadata. Direct BSR requirements in a consumer's <code>protobuf.mod</code> are not supported.
+
+### BSR compatibility snapshots
+
+The Buf adapter reads v1/v1beta1/v2 <code>buf.yaml</code> and optional <code>buf.lock</code>, including configs in v1 workspaces. It preserves the BSR identity, requested reference, locked BSR commit/digest and declaring config path. All locked transitive BSR dependencies participate. Identical declarations are deduplicated; conflicting references, invalid pins and declarations missing from an existing Buf lock fail before manifest/lock updates. Declared dependencies are resolved even when their imports are unused. Unknown BSR modules produce <code>unsupported BSR module: ...; no mapping in the BSR resolver</code>; no repository is guessed.
+
+| BSR module | Git module | Fixed Git revision |
+|---|---|---|
+| <code>buf.build/googleapis/googleapis</code> | <code>github.com/googleapis/googleapis</code> | <code>03a91044136a014466d4293eb1fe91f2b02075d2</code> |
+| <code>buf.build/grpc-ecosystem/grpc-gateway</code> | <code>github.com/grpc-ecosystem/grpc-gateway</code> | <code>v2.31.0+incompatible</code> |
+| <code>buf.build/mercari/grpc-federation</code> | <code>github.com/mercari/grpc-federation</code> | <code>v1.27.0</code> |
+| <code>buf.build/envoyproxy/protoc-gen-validate</code> | <code>github.com/envoyproxy/protoc-gen-validate</code> | <code>v1.3.3</code> |
+| <code>buf.build/bufbuild/protovalidate</code> | <code>github.com/bufbuild/protovalidate</code> | <code>v1.2.2</code> |
+
+grpc-gateway v2.26.1/v2.31.0 and grpc-federation v1.24.0/v1.27.0 declare only the Googleapis BSR dependency. Their BSR commits differ, and this backend deliberately selects the same tested Googleapis snapshot. It does **not** prove equivalence with a BSR reference or verify the BSR digest. The CLI reports this limitation when resolving; the parent Git entry records it as <code>resolution: compatibility_snapshot</code>:
+
+~~~yaml
+# Inside the requiring Git module's protobuf.lock entry:
+bsr:
+  - dependency:
+      module: buf.build/googleapis/googleapis
+      commit: 62f35d8aed1149c291d606d958a7ce32
+      config: buf.yaml
+    git:
+      module: github.com/googleapis/googleapis
+      version: 03a91044136a014466d4293eb1fe91f2b02075d2
+    resolution: compatibility_snapshot
+~~~
+
+The usual Git lock entry and verified <code>h1:</code> hash still pin the installed source. Frozen and cached operations verify the original Buf metadata against the recorded bindings and reuse their Git targets without calling the BSR backend. Locks created before this feature must be regenerated with <code>easyp mod tidy</code> if a dependency contains BSR declarations. Git tags remain subject to the existing immutable-version guard.
+
+The backend is wired in [internal/api/mod_v1_cache.go](../../internal/api/mod_v1_cache.go) through <code>gitmodules.NewWithBSRResolver</code>. A future EasyP Service implementation replaces <code>bsr.StaticResolver</code> there and implements the same <code>modules.BSRResolver</code>; it need not change the dependency graph. The temporary backend has no BSR API requests, Buf executable dependency, HTTP client, implicit latest or universal BSR-to-Git inference. Other BSR revisions can require features absent from the compatibility snapshot. Separate manifests that require incompatible exact Git commits retain the existing conflict diagnostic.
+
+A nested module root <code>proto</code> becomes <code>&lt;checkout&gt;/&lt;module-directory&gt;/proto</code>. A file below that root is imported without either physical prefix. <code>modules.SourceRoots</code> preserves module identity for managed selectors. Common import paths in different physical roots are rejected rather than silently selecting one.
+
+Generation, lint, breaking and module operations share root/collision rules. Source traversal excludes hidden directories, vendored output and nested-module boundaries via <code>internal/core/path_helpers/v1_source.go</code>. Config discovery and policy inheritance use their own traversal rules.
+
+## Persistence guarantees
+
+Manifest/lock updates are coordinated by <code>writeV1ResolvedFiles</code>. If lock replacement fails after a manifest change, the original manifest is restored; any restoration failure is returned with the original error. Each individual file uses a temporary file and rename. There is no atomic transaction or crash-recovery guarantee for the pair.
+
+Vendor output is built in a temporary directory before replacing the current output; replacement failure attempts to restore the previous vendor directory. Temporary checkout and staging directories are cleaned up by their owners.
+
+## Tests
+
+Pure resolver tests cover semver selection, commits, versionless pins, repeated visits, cancellation and source errors. Filesystem tests cover manifest preservation, stale-lock rejection before installation, and vendor staging. Local-Git integration tests retain nested-module, hash, tag/HEAD and command coverage. Generation tests use explicit directories/cache values instead of process-wide cwd/env changes.
+
+## Producer-policy dependencies
+
+Shared policies use the same declared identities and exact locked snapshots. <code>extends</code> never infers a Git repository or duplicates a dependency version. See [policy-extends](policy-extends.md). Validation only inspects already cached, verified contents; execution can install an existing locked commit.
diff --git a/.spec/config/descriptor-export.md b/.spec/config/descriptor-export.md
new file mode 100644
index 00000000..500b0ce4
--- /dev/null
+++ b/.spec/config/descriptor-export.md
@@ -0,0 +1,112 @@
+# v1 descriptor exports
+
+## CLI contract
+
+The two export flags belong to the generate command, not to easyp.gen.yaml.
+They are mutually exclusive. Paths are resolved from the command working
+directory, independently of the selected generation project.
+
+~~~bash
+# One compatible graph containing all selected modules.
+easyp generate --project backend --descriptor_set_out build/backend.pb --include_imports
+
+# One independent graph for each selected project/module pair.
+easyp generate --all --descriptor_set_out_dir build/descriptors --include_imports
+~~~
+
+Generation selects the nearest project by default. Multiple projects require
+repeated project flags or an explicit all flag, as described in
+[context selection](review-context-and-generation.md). Without either export
+flag, generation uses the same explicit selection rules. With an export
+flag, configured plugins still run, but only after all requested graphs and
+output paths pass preflight. Pluginless projects can export descriptors too.
+
+The include_imports flag controls the saved contents only. Compilation and
+compatibility validation always use the full transitive graph, even when
+imports are omitted from the exported files.
+
+## Single-file export
+
+The descriptor_set_out flag combines compatible graphs. Identical descriptors
+are deduplicated by proto filename and content. Different definitions under
+one import path, or conflicting symbols across different files, cause an
+error. Version numbers alone do not determine compatibility.
+
+Diagnostics identify both generation projects, selected modules, owning source
+modules, and the first differing descriptor field. Resolved dependency versions
+and commits are included when available from the lock actually used by the
+consumer. Local replacements are labelled as replacements, not as resolved
+remote versions.
+
+Consumer managed options are preserved. The exporter does not drop go_package
+or other options just to make conflicting graphs appear compatible.
+
+## Directory export and naming
+
+The descriptor_set_out_dir flag validates each project/module graph separately;
+it does not combine graphs with each other. It therefore supports consumers
+with different managed options and modules with conflicting dependency versions.
+
+Within the output directory, generation-project paths mirror their paths from
+the working directory. A project at the root writes directly into the output
+directory. Each filename consists of the module identity's final path component,
+sanitized to a lowercase filesystem-safe name, followed by the first 12 hex
+digits of the SHA-256 of the full module identity, and the suffix .pb.
+
+~~~text
+descriptors/
+  backend/
+    user-<identity-hash>.pb
+    order-<identity-hash>.pb
+  frontend/
+    user-<identity-hash>.pb
+~~~
+
+The identity suffix is always present: adding another module with the same
+basename cannot rename or overwrite existing targets. Filenames do not depend
+on selection order or the module version. Without a manifest, the identity is
+formed from the module directory relative to the working directory. Explicit
+projects outside that directory are placed in an _external namespace with a
+safe, identity-suffixed project name; parent traversal is never used in outputs.
+
+Selecting the same resolved directory more than once in one project exports it
+and runs its plugins only once. Different source directories claiming the same
+output identity are rejected before plugins execute. Existing ancestor symlinks
+are resolved for collision checks; dangling output ancestors and symlink output
+files are rejected before plugins execute. Existing unrelated files
+are not deleted. Use a dedicated empty directory when a directory's entire
+contents must represent exactly one invocation.
+
+This mode changes descriptor destinations only, not configured plugin output
+paths. Independent generated SDKs still need suitable plugin output layouts.
+
+## Preparation and effects
+
+The generation layer prepares core.GenerationPlan values in memory: resolve
+sources, compile, and apply managed options. The full graphs are then validated
+and export bytes are prepared before the first plugin is invoked. Plugin
+requests and exported descriptors are independent copies of that prepared graph;
+there is no second compilation after validation.
+
+A descriptor conflict, invalid later module, invalid export path, or conflicting
+export flags must not invoke any plugin or change existing generated/descriptor
+outputs. Resolving sources can still populate the configured dependency cache.
+
+After successful preflight, plugins run. Descriptor files are written only after
+all selected plugin executions succeed, using an atomic replacement per file
+and preserving an existing regular file's permissions. Missing output parent
+directories are created. This is not a transaction across all plugin side
+effects or all exported files: plugin errors and filesystem failures after
+preflight do not promise a global rollback.
+
+An explicit Go-options-only ancestor with child generation projects and no
+protobuf.mod is an inheritance container, not an implicit module. Incidental
+legacy proto files do not turn that container into an export target. A declared
+root module still participates, as do standalone pluginless projects.
+
+## Regression coverage
+
+Unit and CLI tests live in internal/core, internal/generation and internal/api.
+The independent easyp-test repository contains file-first v1 fixtures and their
+checks in tests/e2e/v1/descriptor_exports_test.go. All v1 checks require an
+explicit absolute EASYP_BIN and never silently use a released binary.
diff --git a/.spec/config/mcp-module-reference.md b/.spec/config/mcp-module-reference.md
new file mode 100644
index 00000000..4f7d83c2
--- /dev/null
+++ b/.spec/config/mcp-module-reference.md
@@ -0,0 +1,13 @@
+# MCP reference for all v1 configuration formats
+
+The stable easyp_config_describe tool accepts easyp.yaml, easyp.gen.yaml, protobuf.mod and protobuf.lock. File is a known format selector, never a filename to open. Tool calls only construct in-memory reference data; they do not read project files, access Git/the network, expand environment variables, change files or execute plugins.
+
+For YAML, schema and examples[].yaml remain compatible with existing clients. protobuf.lock obtains its actual schema from v1.SchemaJSON("protobuf.lock"); documentation distinguishes structural rules from ParseLock semantic checks. Synthetic sample commits/hashes are labelled and are not assertions about real content.
+
+protobuf.mod is text: format=text, grammar={dialect,syntax,notes}, examples containing format=text and text, no schema and no examples[].yaml. Directive/field selection covers module, roots, require, replace and their relevant child fields. Grammar follows the parser's whitespace tokens, block boundaries, comments/BOM, duplicate-source rejection and major-version identity rules. It does not invent a YAML schema for a text format.
+
+include_schema controls JSON Schema for YAML and grammar for text. Other detail/child/example flags keep their existing meaning. Empty file selects easyp.yaml; empty path, root and $ select the root; indices normalize to []. examples_limit defaults to 10, accepts 1 through 50, and now rejects invalid bounds rather than clamping. This validation tightening is explicit. Unknown file/path/arguments fail; valid previous YAML inputs and existing YAML example fields remain supported.
+
+Responses own all mutable maps/slices. Parallel calls and mutation tests verify isolation. The MCP input schema lists the four formats and matches the typed argument names, while output continues using the SDK's typed schema inference.
+
+See ../../mcp/easypconfig/README.md for requests. Unit tests cover parser/schema parity, returned-state isolation and in-memory SDK transport. easyp-test/tests/e2e/v1/mcp_module_reference_test.go exercises actual stdio initialization/list/call, invalid inputs, no project reads, example CLI validation and exact generated-schema equality. EASYP_MCP_BIN selects the freshly built server; the fallback builds it from explicit EASYP_SOURCE, never a global installed binary.
diff --git a/.spec/config/package-selection.md b/.spec/config/package-selection.md
new file mode 100644
index 00000000..47895d84
--- /dev/null
+++ b/.spec/config/package-selection.md
@@ -0,0 +1,47 @@
+# Exact protobuf package selection
+
+A nonempty generate.packages selects exact protobuf package names within the
+modules selected by a generation project. Empty or omitted selects all source
+files, preserving the existing behavior. Names follow protobuf identifier
+syntax; they are not prefixes, filesystem paths, globs or expressions.
+
+~~~yaml
+version: v1
+generate:
+  modules: [proto/orders, proto/users]
+  packages: [orders.v1, users.v1]
+plugins:
+  - name: go
+    out: gen
+    with_imports: true
+~~~
+
+All files declaring a selected package participate. Matching is across the
+project's selected modules, not separately required in every module. Modules
+with no matching package do not execute plugins or produce empty descriptor
+sets. Unknown names fail before any plugin, including partially matched lists.
+Duplicate names are idempotent. Explicit package validation applies even to an
+options-only project without plugins.
+
+Discovery lexes top-level package declarations, leaving unrelated malformed
+message bodies uncompiled. Selected sources and their entire reachable import
+closure are compiled by the existing protobuf compiler, so required invalid
+imports still fail. Existing module-root and import collision checks remain.
+Compilation preserves source information, custom options and managed rules.
+
+Plugin FileToGenerate contains only selected sources unless that plugin opts
+into with_imports. Other packages remain in ProtoFile when they are required
+for linking. One plugin's with_imports does not affect another plugin or the
+independent descriptor export include_imports flag.
+
+Both descriptor export modes use the same prepared selection. Without imports
+only selected source descriptors are written; with imports the entire selected
+closure is written. Compatible merging, collision diagnostics and preflight
+before execution remain unchanged. Selection never modifies dependency state,
+proto packages, import names or a published lock. Frozen checks still verify
+the selected module graph; local replacements remain forbidden in frozen mode.
+
+Regressions verify exact/prefix distinction, multiple files, multiple modules,
+no-plugin failures, invalid unselected/required sources, custom options, per-
+plugin imports, both descriptor modes and compiled Go output with a local
+major-version dependency.
diff --git a/.spec/config/policy-extends.md b/.spec/config/policy-extends.md
new file mode 100644
index 00000000..eec645ee
--- /dev/null
+++ b/.spec/config/policy-extends.md
@@ -0,0 +1,71 @@
+# Section-scoped producer policy inheritance
+
+The nearest definition still selects each producer section as a whole. Explicit
+linters.extends or breaking.extends then loads a base for that section only.
+No generation plugin or base issues section is inherited or executed.
+
+## References and boundaries
+
+~~~yaml
+version: v1
+linters:
+  extends: ./.policies/lint.yaml
+  disable: [PACKAGE_VERSION_SUFFIX]
+breaking:
+  extends: example.com/policies#breaking/base.yaml
+  ignore: []
+~~~
+
+Local ./ or ../ references resolve relative to the referring file, inside the
+workspace. A directory means its easyp.yaml. The explicit module#path form and
+the longest known module/path prefix form refer only to identities in the
+consumer's declared, verified graph. Exact module identity selects easyp.yaml.
+Module-relative paths cannot escape the actual manifest directory; nested /vN
+layouts are resolved using that directory, never a proto import root. Relative
+references inside a dependency remain inside that same module. Symlink escapes,
+cycles and chains deeper than 16 base policies are errors with provenance.
+
+Versions occur only in protobuf.mod/protobuf.lock, never in extends. Loading a
+policy may install an exact existing pin, but never resolves a tag, selects HEAD,
+adds a dependency or changes a lock. Main-module replacements are allowed only
+in normal mode; remote edges introduced by a replacement still need existing
+pins. Unreachable lock entries are not acquired. Frozen additionally rejects
+replacements and unreachable pins and checks the complete reached graph.
+
+## Precedence
+
+Base policies resolve recursively. Explicit local default replaces the base
+preset; inherited explicit enable/disable actions remain. Local enable can undo
+a base disable, including an expanded group; local disable wins in the same
+layer. Selections are deduplicated deterministically. Linter settings merge by
+rule/key; an explicitly empty section clears all base settings, and an empty
+rule map clears that rule's settings. YAML aliases/merge keys retain presence.
+Explicit false, empty scalar baseline and empty category/ignore lists remain
+local decisions rather than being replaced by inherited values. Environment
+expansion is performed only for consumer-owned policy files and their local
+extends. A policy reached through a declared dependency module treats ${...}
+placeholders literally, including relative extends inside that dependency and
+local-replacement modules physically stored inside the workspace. Values are
+never expanded again after merging.
+
+Breaking baseline and ignore paths are templates at the consuming policy, not
+paths inside the dependency cache. Each checked module resolves its own graph,
+so a common ancestor policy may select different pinned bases for two modules.
+Deleted source/module scopes are compared using the chosen baseline snapshot.
+A wholly removed module with a remote-only base may need explicit --against to
+locate the historical graph; it never silently succeeds without comparison.
+
+## Validation and ownership
+
+ParsePolicy, ValidateFile and ValidatePath validate syntax without acquisition.
+The CLI validate-config adds bounded resolution of references, checks cached
+hashes and reports missing content with instructions to run mod download. It
+never downloads policy dependencies. Structured errors include the consuming
+file/field plus the chain of base sources. A root policy inherited by native
+child modules is checked in those consumer contexts.
+
+The reference MCP tool only describes syntax and examples; it never reads the
+referenced files. No locks, policies or proto sources are written by resolution.
+
+Tests live in internal/modules/policy_parent_test.go, internal/config/v1 policy
+merge/reference tests and easyp-test/tests/e2e/v1/policy_extends*.go.
diff --git a/.spec/config/review-context-and-generation.md b/.spec/config/review-context-and-generation.md
new file mode 100644
index 00000000..42319758
--- /dev/null
+++ b/.spec/config/review-context-and-generation.md
@@ -0,0 +1,209 @@
+# Context, plugin imports, mixed versions and comment suppressions
+
+## X-19 / X-22: explicit selection and bounded discovery
+
+Default generation selects only the closest easyp.gen.yaml in the current
+or a parent directory. It no longer executes every generator discovered below
+the working directory. This is an intentional v1 behavior correction.
+
+~~~bash
+# Closest consumer project only.
+easyp generate
+
+# Exactly the named consumer projects (repeatable flag).
+easyp generate --project backend --project frontend
+
+# Explicit opt-in to recursive generation below the invocation directory.
+easyp generate --all
+~~~
+
+The all and project flags are mutually exclusive. Recursive discovery skips
+hidden directories, easyp_vendor, node_modules and nested Git repositories.
+A project in a skipped directory can still be deliberately selected with
+project. Automatic selection refuses a symlink configuration file; explicit
+project selection is required to use it. No name-based directory denylist is
+claimed to establish a trust boundary: choosing all explicitly authorizes
+recursive generation, including command plugins in the selected tree.
+
+Workspace-relative module paths and inherited Go options use the nearest Git
+repository boundary rather than assuming the current directory is the root.
+The boundary supports both a .git directory and a worktree .git file. Without
+Git, EasyP uses enclosing EasyP config/manifest files to establish a boundary.
+The workspace flag explicitly supplies that boundary when a non-Git tree is
+otherwise ambiguous. User-supplied project paths, descriptor destinations and
+plugin command working directories retain invocation-relative semantics;
+plugin out paths remain relative to their generation config.
+
+~~~bash
+# Inside backend/deep, find backend/easyp.gen.yaml and repository modules.
+easyp generate --descriptor_set_out ./api.pb
+
+# Explicit boundary for a non-Git tree.
+easyp generate --workspace ../.. --project ..
+~~~
+
+Lint and breaking search upward for the nearest policy within the boundary.
+When no ancestor policy exists, one unambiguous outermost descendant policy
+may be selected. Multiple independent descendant policies require an explicit
+cfg instead of an arbitrary choice. An explicit cfg keeps precedence; an
+explicit root is used as the default policy lookup start. Module operations
+and get use the nearest ancestor protobuf.mod within the workspace. Discovery
+never crosses a nested Git boundary to borrow an unrelated parent's config.
+
+Tests that intentionally relied on recursive generation now request all.
+Single-project invocation is tested independently; no negative test was changed
+to expect accidental execution of an unselected command plugin.
+
+## X-15: per-plugin import generation and output consistency
+
+The v0 setting is restored under its original YAML spelling, with_imports.
+It defaults to false and applies to the individual plugin only. When true,
+FileToGenerate includes the transitive dependency descriptors exactly once.
+It is independent of descriptor export's include_imports flag. Other plugins
+still receive imports as descriptors for linking, without generating them.
+
+~~~yaml
+version: v1
+plugins:
+  - name: go
+    out: .
+    with_imports: true
+    opts: [module=example.com/app]
+  - name: python
+    out: gen/python
+~~~
+
+Do not put differently named Go packages into one output directory. For modules
+whose roots both contain v1/, source_relative plus one shared out directory can
+be invalid even when the protobuf module graphs are individually valid. The
+following explicit layout keeps module identities, Go import paths and physical
+outputs aligned. The common module exposes common/v1/common.proto; user and
+order expose v1/user.proto and v1/order.proto respectively.
+
+~~~yaml
+version: v1
+generate:
+  modules: [user, order]
+  managed:
+    enabled: true
+    override:
+      - file_option: go_package_prefix
+        value: example.com/app/gen
+      - file_option: go_package_prefix
+        module: example.com/user
+        value: example.com/app/gen/user
+      - file_option: go_package_prefix
+        module: example.com/order
+        value: example.com/app/gen/order
+plugins:
+  - name: go
+    out: .
+    with_imports: true
+    opts: [module=example.com/app]
+~~~
+
+Outputs are gen/user/v1/user.pb.go, gen/order/v1/order.pb.go and
+ gen/common/v1/common.pb.go below a Go module named example.com/app. This exact
+shape is generated and compiled in easyp-test. No automatic module-name prefix
+is inserted behind the user's explicit options, and no imported code is
+implicitly generated when with_imports is absent.
+
+All selected plans stage plugin responses in a shared output bucket. Identical
+shared outputs are deduplicated. Different contents for one filename and
+conflicting Go package declarations within one generated directory are errors
+before generated files are written. Import targets are deduplicated even when
+a file is both an explicit input and an import. Insertion points are preserved.
+This does not promise rollback of arbitrary plugin side effects, filesystem
+errors during final writes, or cleanup of old files from previous invocations.
+
+## X-23: mixed dependency requirement kinds
+
+Semantic versions retain the maximum-required-minimum selection rule.
+An explicit commit is exact. It may coexist with semantic requirements only
+when their selected tag resolves to that same commit. Different explicit
+commits, or a selected tag resolving elsewhere, remain a diagnosed conflict.
+No semantic order is inferred from a SHA, commit date or ancestry alone.
+
+A versionless requirement is unconstrained when a semantic version or exact
+commit is supplied elsewhere in the graph. Only a still-unconstrained module
+uses the existing lock pin for tidy, or current HEAD without a pin. Update
+continues refreshing unconstrained HEAD requirements. The result does not
+depend on the order of root declarations. Tags remain in the lock when needed
+to satisfy semantic constraints, while exact commit constraints are verified
+against the selected commit.
+
+Provisional HEAD dependency edges are rebuilt if a stronger constraint changes
+the selected revision. Dependencies and errors from an ultimately unselected
+HEAD are not retained. Revisions are fetched at most once per resolution,
+including failed fetches. Cyclic, unstable versionless constraints are rejected
+rather than choosing a graph based on traversal order. The previously added
+protection against republished locked tags remains active.
+
+## X-18: per-policy, per-file comment suppressions
+
+Comment suppressions are enabled by default in v1. Set
+linters.allow_comment_ignores to false in an effective policy to disable them.
+There is no process-global switch. Rules produce diagnostics; the lint engine
+applies the policy's suppressions afterwards.
+
+~~~protobuf
+// Applies to this declaration and, for a message, its block.
+// easyp:disable FIELD_LOWER_SNAKE_CASE
+message Example {
+  string legacyField = 1;
+}
+
+// A trailing directive applies to the annotated declaration's line/block.
+message Another {
+  string legacyField = 1; // easyp:disable FIELD_LOWER_SNAKE_CASE
+}
+
+// Explicit bounded region; it cannot leak into another file.
+// easyp:disable MESSAGE_PASCAL_CASE
+message old_name {}
+message another_old_name {}
+// easyp:enable MESSAGE_PASCAL_CASE
+~~~
+
+Without a matching enable, disable must annotate a declaration; it is not an
+implicit file-wide disable. Nested paired regions for the same rule are balanced.
+Individual rule names may be comma- or whitespace-separated. Unknown rule names,
+empty directives, unsupported actions and unmatched enables are errors with
+source coordinates, even when suppressions are disabled. Only actual parsed
+comments are interpreted, never marker-like text inside string literals.
+
+Legacy nolint:RULE and buf:lint:ignore RULE comments remain supported as
+annotations. An explanation can follow a space-delimited -- or // separator.
+Rule groups are not accepted as comment rule names. Disabling one rule does
+not disable unrelated checks or a neighboring module's policy.
+
+## X-25: reusable Git objects for pinned commits
+
+Pinned revisions use a reusable bare object store per Git remote below the v1
+cache. The first attempt is a depth-one fetch of the exact commit. Temporary
+checkouts borrow local objects; Fetch followed by Install no longer downloads
+the same remote history twice. Repeat fetches of a known commit work without
+contacting the remote, including when that remote is unavailable.
+
+Servers may reject requests for an unadvertised historical SHA. In that case,
+EasyP fetches advertised reachable history as a compatibility fallback, then
+still requires the original exact commit. It never substitutes HEAD. Thus a
+cold request is not guaranteed shallow on every server. Object stores use
+cross-process OS locks with context cancellation; process exit releases them.
+Installed contents retain lock-hash verification and corrupt installations are
+rejected. Tag lookups are still refreshed so cache reuse cannot hide a retag.
+
+The reproducible benchmark is scripts/benchmarks/git_commit_cache.py in
+easyp-test. It uses a read-only loopback Git daemon and 48 revisions with a
+256 KiB changing payload; all files and logs are isolated below its out path.
+The daemon is always stopped in finally, and the old/new lock hashes must match.
+Measured on the development Mac, not a public-network performance guarantee:
+
+| Fixture server | First run, before / after | Warm runs, before / after | Warm remote data operations after |
+|---|---|---|---|
+| Historical SHA allowed | 1.040 s / 0.244 s | 0.511–0.514 s / 0.075–0.076 s | 0 |
+| Historical SHA denied; fallback used | 1.107 s / 0.634 s | 0.502–0.548 s / 0.069–0.071 s | 0 |
+
+In the shallow case the object store contained 5 reachable objects versus 146
+in the complete fixture history. In the fallback case it retained all 146.
+Both paths produced byte-identical lockfiles compared with the previous CLI.
diff --git a/.spec/config/review-correctness.md b/.spec/config/review-correctness.md
new file mode 100644
index 00000000..4d9ab977
--- /dev/null
+++ b/.spec/config/review-correctness.md
@@ -0,0 +1,47 @@
+# v1 review correctness fixes
+
+## Lint selection (X-9, R-16, R-17)
+
+The runtime, v1 schema, and MCP share the implemented rule/group catalog.
+Repeated rule names or group names are idempotent: the first occurrence is
+retained, and disabling takes precedence over enabling. The same semantics
+apply to presets and pathless issue exclusions.
+
+Unknown names in enable, disable, and exclusion lists are errors, even when
+the same name also appears in the opposite list. Configuration validation
+reports all invalid entries with their YAML coordinates and rejected names.
+The reserved PACKAGE_NO_IMPORT_CYCLE rule is not advertised or executable;
+selecting it reports that it is not implemented rather than panicking.
+
+## Local replacements (X-13)
+
+An absolute replacement target is used directly. A relative target is resolved
+from the directory of its owning protobuf.mod, not from the generation consumer
+or command working directory. Source resolution and explicit dependency
+selection use the same path helper.
+
+## Breaking baseline precedence (X-17)
+
+Precedence is: explicitly supplied --against, then breaking.baseline, then the
+existing CLI default master. Explicit --against master still overrides a
+configured baseline. An explicitly empty or whitespace-only flag is an error;
+a missing explicit Git ref does not silently fall back to the configured ref.
+These changes do not expand supported Git ref kinds.
+
+## Legacy dependency metadata (X-2)
+
+When adapting a published pre-v1 dependency, easyp.yaml deps and generation Git
+inputs both contribute requirements. Exact source/version duplicates are
+removed in stable order; different minimum versions remain visible to MVS.
+Malformed deps entries fail explicitly. Roots retain their previous behavior.
+A matching native protobuf.mod takes precedence over the legacy configuration.
+Only dependency metadata is read; dependency plugins are never executed.
+
+## Verification
+
+Unit tests cover runtime selection, validation locations and schema parity,
+absolute/relative paths, flag precedence, native manifest precedence, invalid
+legacy metadata, and combined deps/Git-input requirements. End-to-end fixtures
+are in easyp-test/specs/scenarios/v1 and run through TestFiveReviewFixes using
+an explicit EASYP_BIN. The pre-fix binary fails all five defect cases while
+the relative-replacement control passes.
diff --git a/.spec/config/review-generation-and-baselines.md b/.spec/config/review-generation-and-baselines.md
new file mode 100644
index 00000000..edd9b8d5
--- /dev/null
+++ b/.spec/config/review-generation-and-baselines.md
@@ -0,0 +1,113 @@
+# Generation, baseline and reproducibility review fixes
+
+## X-14: Go package prefix is not full managed mode
+
+`options.go.package_prefix` applies Go option overrides without enabling
+defaults for Java, C#, PHP, Ruby, Objective-C or C++. Ordinary prefixes derive
+multi-segment Go import paths from the protobuf package hierarchy. This keeps
+modules such as `user.v1` and `order.v1` in distinct generated directories even
+when both contain `v1/*.proto` and use `paths=source_relative`. Single-segment
+packages and path markers retain their existing file path semantics.
+
+Source-relative Go output follows the plugin's effective `go_package`, relative
+to the configured prefix (the stable parent for marker templates). Disabled
+options and explicit overrides therefore keep imports and output directories
+consistent. Packages outside that prefix keep their plugin output paths.
+`paths=import` and the plugin's `module` option retain plugin-controlled layout.
+The last nonempty per-file `Mfile.proto=import/path` mapping takes precedence
+over descriptor options; alias-only and empty mappings preserve the effective
+import path. The marked generator header identifies the source even when proto
+comments contain `// source:`. Insertion responses reuse the producer's recorded
+output path in that output directory, independent of insertion plugin options.
+
+The internal GoPackageOnly runtime mode is not a new YAML setting. Empty
+options are not materialized in otherwise unchanged descriptors. Other
+languages and field-option overrides require an explicit
+`generate.managed.enabled: true`.
+
+The existing ordering remains: inherited prefixes precede explicit managed
+Go overrides; a directly specified options.go.package_prefix follows them.
+Go disable selectors, including go_package itself, still suppress the prefix.
+Explicit full managed mode preserves its language defaults and overrides.
+
+## X-16: revision-local module contexts for breaking
+
+Each selected module is compared separately. Both revisions discover their own
+module roots and dependencies. Baseline protobuf sources and manifests/locks
+are read from an isolated Git snapshot, never from the current working tree.
+The caller's checkout, manifest and lock are not modified; the verified
+module cache may be populated. Snapshot directories are removed after use.
+
+The selected paths are relative to the Git repository, so changing --root does
+not change the identity of an otherwise identical checked file. Explicit target
+paths take precedence over import aliases when building the checker input.
+Baseline-only files and deleted modules remain checkable, including via --path.
+Directory and file aliases are canonicalized before repository-relative selection;
+deleted targets retain their suffix below the nearest existing ancestor.
+
+Policy ownership is still determined from current configuration. Each effective
+policy uses its own baseline; dependencies are checked with the policy of the
+selected files, not an unrelated ancestor at the module directory. Repeated
+identical findings are emitted once. FILE checks and whole-section policy
+inheritance remain enabled. This change does not add new Git ref kinds.
+
+Local replacements within the repository use their baseline contents. Absolute
+paths are mapped back into the snapshot, including macOS filesystem aliases.
+External local replacement directories have no recoverable historical identity;
+these are explicitly rejected for baseline comparison instead of silently using
+current contents. A locked dependency provides a reproducible baseline.
+
+## R-20: vendor files are imports, not lint targets
+
+Target discovery skips easyp_vendor and hidden storage/Git directories before
+reading policies or constructing module contexts. A legacy or invalid policy
+under vendor therefore does not break a root lint invocation. A vendor target
+explicitly selected through --path is excluded too. Import resolution for user
+sources continues through their module roots and verified dependencies.
+
+Local replacement sources are also import-only during consumer lint and
+breaking checks, including legacy/Buf metadata and nested modules. Their paths
+are excluded before reading their policies. Selecting a replacement explicitly
+through `--path` still validates its policy. Absolute in-repository targets are
+rebased into the baseline snapshot during source selection as well as import
+resolution. Only reachable replacements own these import-only trees. Unused
+replacements pointing to files or directories cannot hide checked sources.
+
+Local Buf source includes/excludes remain attached to each import root. The
+same selection is applied to import resolution, descriptor compilation, explicit
+dependency generation and package selection, file listing, collision detection
+and vendoring. Nested module boundaries and physical aliases prevent a broad
+consumer root from reintroducing an excluded dependency file. Current and
+baseline contexts retain separate filters.
+
+## X-24: a recorded version cannot silently change identity
+
+Tidy, get and update verify every fetched previously locked semantic version
+against the recorded commit and content hash. A mismatch returns
+ErrLockedVersionChanged with both identities before installing the new graph or
+writing protobuf.mod/protobuf.lock. This covers direct and transitive
+requirements and works independently of a warm installed-module cache.
+
+Update still refreshes versionless requirements and can select a new semantic
+version; the versionless HEAD pins are not accidentally frozen by the guard.
+Download remains lock-first and can retrieve the old exact commit after a tag
+moves, provided that commit remains available from the source.
+
+## X-26: documentation publication belongs to its repository
+
+The obsolete CLI .github/workflows/docs.yml has been removed. It attempted to
+build a deleted docs directory and push generated files to the default branch
+from a release tag. Documentation builds and image publication are independently
+owned by easyp-tech/docs and its .github/workflows/docker-publish.yml. No new
+cross-repository credentials, dispatch or duplicate publishing step is added.
+
+## Regression
+
+Local tests cover Go-only transformation, explicit managed defaults, snapshot
+isolation, module roots, import aliases, filesystem aliases, immutable version
+checks and the absent obsolete workflow. The v1 easyp-test suite additionally
+runs CLI scenarios for all five findings, cold/warm caches, changed baseline
+dependencies, nested policies, FILE moves, deleted modules and transitive retags.
+The source-only workflow guard needs EASYP_SOURCE; executable scenarios always
+require an absolute EASYP_BIN. All newly observed defect cases are reproduced on
+the previous CLI before validation of the fix.
diff --git a/.spec/config/review-maintenance.md b/.spec/config/review-maintenance.md
new file mode 100644
index 00000000..91ce570c
--- /dev/null
+++ b/.spec/config/review-maintenance.md
@@ -0,0 +1,56 @@
+# Developer tooling and pinned-dependency diagnostics
+
+## Developer task repairs
+
+Tools live under the Taskfile root, not the caller's working directory. Paths
+and explicit LOCAL_BIN overrides remain quoted through aggregate lint tasks.
+init installs fixed tool versions and runs go mod download, never go get.
+Go and root-Dockerfile lint checks have separate targets; lint attempts both and
+returns failure if either fails. It does not hide existing source findings.
+The old missing Docker/base and Docker/lint build helpers are removed. docker
+and docker:build build the current root Dockerfile locally; neither publishes.
+Release publishing stays in the existing release workflow.
+
+Optional Mockery targets follow core.Rule, core.CurrentProjectGitWalker and
+adapters/console.Console. The normal test suite uses handwritten doubles.
+Generated mocks may introduce test dependencies: run go mod tidy after choosing
+to add them. Verify generated code in a disposable checkout; do not commit
+unused generated files merely to exercise a developer task.
+
+scripts/check-dev-tools.sh checks command dispatch in an isolated directory with
+spaces and quotes, using trace-only tools on an allowlisted PATH. It tests
+failure propagation, missing executables, local-only Docker behavior, root-based
+tool lookup and explicit overrides. It performs no downloads or real Docker/Go
+operations. CI invokes the same dev-tools:check target.
+
+## Remaining B-13 diagnostics
+
+A cached content mismatch identifies the exact installed directory and instructs
+the operator to inspect or quarantine that entry, retry mod download, and retain
+the existing protobuf.lock. Nothing is automatically deleted, repaired or repinned.
+A newly downloaded mismatch does not receive misleading local-cache repair advice.
+Failure to query a repository is not reported as proof that a tag does not exist.
+Successful history retrieval without the pinned commit advises restoring access
+to that revision instead of substituting HEAD. Errors retain their Git causes;
+cancellation during a Git subprocess remains detectable with errors.Is.
+
+This does not add an offline fallback for tag validation, weaken integrity checks,
+change version selection, or implement X-20/Buf registry mappings.
+
+## Agent skills
+
+The existing go-code-style, go-testing and legacy-named epctl-commands skills now
+refer to the EasyP CLI module and urfave/cli v2. They use actual error/interface
+owners and document process-state exceptions to parallel tests. Skill names and
+paths are retained so existing references remain valid.
+
+## Findings exposed by the repaired checks
+
+The WASM runtime now propagates close failures rather than discarding them.
+Removed an ineffectual map-value assignment in lint batching and simplified
+string-builder formatting and YAML quote scanning without changing their scope.
+Staticcheck ST1005 remains active for prose errors; its exclusion only matches
+exported identifier-style wrapping labels required by the existing code style.
+This is not a blanket disable for staticcheck or for arbitrary error messages.
+Runtime-image APK packages have explicit overridable version build arguments,
+verified against Alpine 3.22. Update those pins when updating runtime packages.
diff --git a/.spec/config/review-migration-and-polish.md b/.spec/config/review-migration-and-polish.md
new file mode 100644
index 00000000..1259be60
--- /dev/null
+++ b/.spec/config/review-migration-and-polish.md
@@ -0,0 +1,119 @@
+# Migration and remaining review corrections
+
+## Native repository configuration (X-7)
+
+The CLI repository uses native v1 policy, generation, manifest and lock files.
+The previous api generation directory did not exist; its obsolete dependencies
+and legacy root lock were removed from this repository, not from user projects.
+A documented hello/v1 example uses the bundled Python generator and a well-known
+Timestamp import, without external protobuf dependencies. The proto:check task
+copies only real config and example inputs to a temporary directory, validates,
+lints, verifies the lock and compares two generations. CI runs the same task.
+Intentional negative fixtures under testdata remain unchanged.
+
+## Explicit v0 migration (X-1, X-6, X-11)
+
+The migrate command in flag-only mode previews real output content by default. Writing requires
+--write; optional dependency resolution/cache access requires --resolve-lock.
+The module identity is explicit. Migrating does not execute plugins or save
+expanded environment secrets. Effective lint selection, legacy comment opt-in,
+settings, literal/prefix exclusions, plugin argv/options/with_imports, supported
+managed rules and representable input roots are transferred. The selected
+physical files and protobuf import names must remain equivalent.
+
+Legacy direct/indirect directives become require. Old full-SHA/pseudo-version
+pins retain their commit. A tag-only pin is accepted only after verifying the
+legacy installed-tree hash. The new full tracked-repository hash is calculated
+independently. Missing historical pins, retags and hash mismatches fail. The old
+easyp.lock remains byte-identical. Empty projects receive a native empty lock,
+so the retained old lock cannot block later normal module commands.
+
+The application transaction stages all results and .v0.bak recovery copies,
+checks observed contents/permissions/source scope again, and rolls back ordinary
+failures. Conflicting existing files and unsafe symlink destinations are refused.
+A validated native project is an idempotent no-op. Several filesystem renames
+are not a crash-atomic transaction; uncooperative concurrent writers remain
+outside the guarantee. Recovery material is retained if rollback itself fails.
+
+Conservative refusal is part of the contract, not silent success: unsupported
+external/sliced inputs, custom Git-input roots, ambiguous managed selectors,
+missing historical identity, full lock migration with local replacements and
+Buf-config conversion may need manual migration. Native v1 execution remains
+separate; detection of old configs points to migrate instead of accepting v0.
+
+## Supported policy features and explicit reserved fields (X-5)
+
+issues.exclude-rules.path supports relative glob segments *, ?, character classes
+and whole-segment **. Literal directories cover descendants, literal proto files
+match exactly. The effective issues policy's directory is the base. Whole-file
+exclusions are applied before import preparation; named rules/groups only affect
+matching files. A pathless empty linter list continues to explicitly suppress
+all checks in its policy scope; examples document this rather than changing it
+silently.
+
+breaking.ignore_unstable filters only unstable final package-version components
+on both sides. Stable declarations, imports and references remain checked.
+FILE remains the only additional category. Shared extends and generate.packages
+are reserved: schemas reject nonempty values rather than advertising execution.
+Public English/Russian references and guides reflect supported code, explicit
+project selection and plugin-specific with_imports.
+
+## Independently confirmed smaller defects
+
+- protobuf.mod accepts initial BOM and token-start # comments, rejects duplicate
+  require/replace sources and malformed/inline blocks with source line numbers.
+  Manifest editing preserves these comments, BOM, URL text and indirect markers.
+- validate-config checks missing/non-directory local replacement targets.
+- YAML policy and generation files require exactly one document.
+- PACKAGE_DIRECTORY_MATCH uses the declared module import path, independently
+  of --root, while diagnostics retain the selected user-facing path.
+- breaking.ignore is bound to its policy file, not to the Git repository root.
+  Baselines support branches, lightweight/annotated tags and Git commit refs;
+  an existing bare branch name retains precedence over a same-named tag.
+- command plugins pass executable and argv directly, without implicit shell
+  string evaluation. A shell script remains possible via explicit sh -c argv.
+- an explicitly selected global output format is not hidden by a local default;
+  a local explicit format still wins. Duplicate filename prefixes are removed
+  from configuration errors, and parent paths are not mistaken for ignored dirs.
+
+## Still requires a separate contract
+
+X-20 local-replacement lock semantics, an explicit frozen/reproducible mode and
+unknown import-to-Git-module discovery have not been invented here. Likewise,
+remote policy distribution through extends, package selectors and additional
+breaking categories remain outside the supported subset. Different major
+versions and registry-specific Buf dependency identity need explicit decisions.
+
+## Verification entry points
+
+~~~bash
+go test -race -count=1 ./...
+go vet ./...
+task schema:check
+task proto:check
+~~~
+
+The external v1 easyp-test suite has CLI regression tests for migration,
+historical hash/commit preservation, preview/no-write failures and policy/path
+corrections. EASYP_BIN and EASYP_SOURCE must both point at the tested build.
+
+## Interactive migration
+
+A terminal invocation without --module starts the line-based wizard. Explicit
+--interactive requests it even with supplied flags; --interactive=false disables
+it. Both application input and output must be terminals. No /dev/tty fallback
+is used to reinterpret piped data as consent. Existing --module invocations
+remain noninteractive unless the wizard is explicitly requested.
+
+Missing directory and identity values are prompted and validated. Native module
+metadata or local Git origin may supply a credential-free identity suggestion;
+it is never accepted without user input. The initial preview requires no
+repository access. Deferred dependency verification has its own default-no
+confirmation, followed by a fresh complete preview and a separate default-no
+write confirmation. Prefilled --write/--resolve-lock do not bypass these gates.
+EOF, malformed input and unavailable output never imply consent. Already-v1
+projects terminate without resolution or write questions. The reviewed plan is
+applied without rebuilding it after consent; its input snapshots are rechecked.
+Before and after authorized resolution, the original input state is also checked.
+Cancellation after authorized resolution may retain cache entries, not project
+changes. Existing application crash/concurrent-writer limits remain unchanged.
diff --git a/.spec/config/review-remaining-audit.md b/.spec/config/review-remaining-audit.md
new file mode 100644
index 00000000..dcd4ebc9
--- /dev/null
+++ b/.spec/config/review-remaining-audit.md
@@ -0,0 +1,79 @@
+# Remaining review audit: validated configuration and reachable imports
+
+## Correctness fixes
+
+R-17 now rejects unknown managed file/field options, incorrect value types,
+unsupported enum values and invalid selector structure. Generated schema uses
+metadata derived from the actual managed-handler registry and protobuf option
+descriptors. Parity tests compare the metadata with every registered handler.
+No existing managed transformation or selector precedence is removed.
+
+The policy and generation parsers validate their expanded YAML using the same
+schema as validate-config. Environment expansion happens once per input path;
+escaped placeholders remain literal. Policy conversion also validates settings
+constructed directly in Go. A nonempty baseline must use git:<ref>. Unsupported
+extends, categories and misspelled linter settings are not accepted by lint just
+because it does not execute a breaking check.
+
+B-11 (import validation and exit status): tidy follows the transitive import
+closure reachable from local source files before writing manifest/lock. Missing
+imports, illegal relative paths and invalid reachable source syntax fail with
+the owning file. A google/protobuf prefix is not sufficient: bundled files must
+exist. Unrelated invalid dependency files are not traversed. Cycles terminate
+without duplicate parsing; this import scan is not a full protobuf type checker.
+
+ls-files emits the complete JSON or text result, including accumulated errors,
+and then returns exit status 1 when errors exist. include-imports=false remains
+an intentional local-file listing rather than an import validation command.
+
+R-14: an existing indirect requirement is inspected for direct imports instead
+of skipped. Promotion removes only the indirect marker, keeping its version,
+unrelated comments and unchanged lock. Repeating tidy remains idempotent.
+
+C-16: legacy remote: host/plugin:version produces an actionable split-field
+error even when the separate version is absent. Host ports remain valid.
+C-14: mod update help explicitly describes refreshing within the current major
+and rewriting the manifest and lock; exact commit behavior is unchanged.
+
+R-21 / C-15: init cannot prompt through a hidden controlling terminal when its
+input/output is redirected. Explicit or locally inferred identities still work.
+An identity derived from origin reads the declared URL before insteadOf transport
+rewriting, removes credentials, and only applies at the repository root. The
+existing 0600 file mode is unchanged. Multiline identity injection is rejected.
+
+C-17: lint executes once per effective policy/module batch, retains stateful
+rule instances and full import access, applies named exclusions per file, and
+sorts findings back to original lexical source order. Batching does not imply
+that all imported files are themselves lint targets.
+
+R-31: the existing AGENTS and top-level .spec documentation now describes native
+v1 paths, commands, cache, error contracts and schema files. Old historical
+review notes remain immutable; they record the state at their own commit.
+
+## Remaining contracts and audit limits
+
+X-20 is not implemented here. Local-replacement lock semantics, a frozen mode,
+and unknown import-to-repository discovery need separate decisions. Buf registry
+identities are not inferred as Git modules: B-11 registry metadata handling is
+not closed by the import-integrity fix. Major-version identity policy remains
+separate, as do shared extends, package selectors and extra breaking categories.
+
+The documented 0600 init mode and non-offline tag revalidation remain deliberate
+existing behavior, not silently modified to satisfy historical observations.
+Existing service-oriented bundled skills and outdated development-task targets
+are recorded separately from the repaired runtime issues. This audit does not
+claim complete replay of every historical A/B/C/R script or security audit.
+
+## Verification
+
+~~~bash
+go test -race -count=1 ./...
+go vet ./...
+task schema:check
+task proto:check
+~~~
+
+The external suite has additional real CLI regressions under
+ tests/e2e/v1/remaining_audit_test.go. EASYP_BIN and EASYP_SOURCE must identify
+the same implementation. Red/green logs and exact commits live with the review
+material, not in the source tree.
diff --git a/.spec/plans/2026-10-03-bsr-resolution.md b/.spec/plans/2026-10-03-bsr-resolution.md
new file mode 100644
index 00000000..7911cc6d
--- /dev/null
+++ b/.spec/plans/2026-10-03-bsr-resolution.md
@@ -0,0 +1,42 @@
+# BSR dependency resolution implementation plan
+
+**Goal:** Resolve BSR metadata in Git dependencies through a replaceable backend and reuse the existing Git graph, cache and import pipeline.
+
+**Architecture:** Buf readers preserve module identity, requested reference, lock commit/digest and the declaring config. A small `modules.BSRResolver` supplies an existing `v1.Requirement`; the Git adapter records this binding on its parent's lock entry and adds the requirement to its metadata. Frozen and cached operations replay recorded bindings instead of calling a backend. The current backend uses explicit fixed Git snapshots; its `compatibility_snapshot` policy states that BSR revision equivalence and BSR digest verification are not guaranteed. The user approved this policy on 2026-10-03.
+
+**Tech stack:** Existing Go toolchain, yaml.v3, testify, Git cache and local-binary v1 regressions. No Buf API, Buf executable, HTTP client or new dependency.
+
+## Scope and files
+
+- `internal/config/v1/bsr.go`: BSR request and recorded binding values, validation. Reuse `Requirement` for the Git target.
+- `internal/config/v1/module.go`, `lock.go`, `schema.go`: internal metadata and optional `bsr` bindings in locked Git entries. Regenerate lock schemas through the existing generator.
+- `internal/modules/bsr.go`: the backend interface; dependency graph code remains BSR-agnostic.
+- `internal/adapters/bsr/resolver.go`: explicit snapshot table and diagnostic unknown-module error. CLI logging explains the compatibility policy.
+- `internal/adapters/module_config/git_dependency_buf*.go`: v1/v1beta1/v2 Buf references and optional locks, including workspace rebasing. Read all locked transitive BSR pins; reject invalid/stale pins and symlink metadata.
+- `internal/adapters/gitmodules/bsr.go`, `cache.go`, `checkout.go`, `migration.go`: resolve bindings while fetching, restore exact bindings in Cached, expose backend injection without altering Git fetch/install APIs.
+- `internal/api/mod_v1_cache.go`: backend composition point for the future Service implementation.
+- `easyp-test/tests/e2e/v1/bsr_dependencies_test.go`: local Git regression fixtures. Git URL rewriting redirects fixed semantic snapshots to isolated local tagged providers; no runtime test configuration is added to EasyP.
+- `easyp-test/tests/e2e/v1/live_dependencies_test.go`: grpc-gateway and grpc-federation must work without explicitly adding Googleapis. Preserve existing direct-provider coverage separately.
+
+## Execution
+
+- [x] Add local CLI regressions and verify RED on the current v1.0 executable: known mapping, unknown mapping, plain Git, workspace, pins/digests, several modules, deduplication, frozen replay and no writes on errors.
+- [x] Add metadata/domain/backend tests before implementing each corresponding operation. Cover context cancellation, error identity, malformed/stale Buf locks, ambiguous/conflicting pins and invalid backend results.
+- [x] Implement parsing, the explicit backend and fetch/cache bindings. Preserve parent provenance; deduplicate equivalent requirements through the existing graph. Frozen operations must work with a backend that always fails.
+- [x] Add/regenerate optional lock schema fields. Validate recorded origins against the verified dependency config rather than trusting arbitrary bindings.
+- [x] Update regressions whose old expectation intentionally ignored BSR metadata. Preserve manual Git-provider behavior with fixtures that declare no BSR identity; unknown BSR modules now fail explicitly.
+- [x] Build the current development binary; run relevant package tests and the full v1 e2e suite with `-race`.
+- [x] Run real old/current grpc-gateway and grpc-federation cases, including cold frozen download/generation/vendor, without manual Googleapis requirements.
+- [x] Run full Go tests with `-race`, `lint:go`, schema check, vet and diff review. Document actual mappings, the replacement point and compatibility limitations.
+
+## Verification results
+
+- RED: the original development binary passed plain Git and failed the other 12 new CLI cases for the expected missing-resolution behavior.
+- GREEN: the new local BSR cases pass, including cold frozen download, generation and vendor, provenance checks and no project writes on errors.
+- EasyP: `go test -race -count=1 ./...` passed on the final source tree.
+- EasyP-test: `go test -race -tags=v1 ./tests/e2e/v1 -count=1 -parallel=4` passed with `EASYP_BIN=/tmp/easyp-bsr-development` and `EASYP_SOURCE` pointing to this checkout. The first attempt omitted `EASYP_SOURCE` and failed only its three source-dependent checks; both configured full runs passed.
+- Public matrix: `go test -tags='v1 live_dependencies' ./tests/e2e/v1 -run '^TestLiveGitDependencies$' -count=1 -parallel=3 -v` passed all 11 cases. grpc-gateway v2.26.1/v2.31.0 and grpc-federation v1.24.0/v1.27.0 acquired Googleapis automatically; cold frozen descriptors matched their initial bytes and vendor succeeded.
+- `task lint:go` with the pinned 2.14.0 executable reported zero issues; `task schema:generate`, `task schema:check`, `go vet ./...` and `git diff --check` passed.
+- Independent BSR code review found no required changes. Migration delegates to `moduleCache`, keeping backend composition centralized.
+
+No commit or push is part of this request. Earlier unrelated working-tree changes stay intact.
diff --git a/.spec/plans/2026-10-04-additional-policy-regressions.md b/.spec/plans/2026-10-04-additional-policy-regressions.md
new file mode 100644
index 00000000..19f45df0
--- /dev/null
+++ b/.spec/plans/2026-10-04-additional-policy-regressions.md
@@ -0,0 +1,90 @@
+# Additional v1 policy regressions
+
+## Confirmed defects
+
+The audit continues from EasyP `ece51fe` and easyp-test `5796d16`.
+
+1. Consumer lint and breaking select local replacement policies when the
+   dependency has legacy EasyP metadata, Buf metadata, or a nested native module.
+   The previous filter only recognizes the replacement's exact native module
+   directory.
+2. A plain replacement under `roots .` becomes both a checked repository file
+   and an import. Lint reports dependency-local findings; breaking compilation
+   fails because the same protobuf symbols are compiled twice.
+3. Absolute replacements inside the repository are excluded in the current
+   checkout but not its baseline snapshot, producing duplicate descriptors or
+   false deletions. Both plain and native dependency layouts are affected.
+
+## Implementation and preserved contracts
+
+- Identify import-only sources by containment in a declared replacement path,
+  before reading their module or policy metadata.
+- Inspect consuming manifests first; only native manifests declare replacements.
+- An explicitly selected replacement file/directory remains a policy target.
+- Selecting a replacement does not implicitly select its own local replacements.
+- Filesystem aliases and deleted selected paths retain their physical identity.
+- Baseline scope discovery receives the original repository root explicitly,
+  rebasing absolute in-repository replacements into the scanned snapshot.
+- Independent workspace modules and similarly named sibling directories remain
+  checked. Compatibility adapters still provide dependency roots and requirements.
+- Breaking retains comparison of imported contracts under the consumer policy;
+  the fix removes duplicate targets and unrelated policies, not import checking.
+- Frozen mode continues to reject local replace directives.
+
+Independent review also caught a false positive in the initial containment fix:
+an unused replacement pointing to a proto file hid that consumer file. Target
+classification now requires a directory. CLI regression tests first reproduced
+the failure; sibling and independent-module cases serve as negative controls.
+
+## Verification plan
+
+- [x] Extend CLI regressions before changing production code: native,
+  legacy-with/without-manifest, Buf v1/v1-workspace/v2-workspace, nested modules,
+  and plain replacements. Include explicit-selection and file-preservation checks.
+- [x] Run against the unchanged `ece51fe` CLI and confirm failures.
+- [x] Add focused parallel table-driven unit cases for source selection, sibling
+  isolation, nested replacement ownership, aliases, and missing selected paths.
+- [x] Run the complete source tests with race detection.
+- [x] Run the complete v1 regression suite, public dependency regressions, and
+  Python gRPC runtime regressions using freshly built CLI/MCP binaries.
+- [x] Run vet, pinned Go lint, schema/proto checks, module verification, and ARM
+  compilation. Review the final changes independently before committing/pushing.
+
+Baseline failures: `/tmp/easyp-additional-baseline-all-red.log` (18 failures,
+12 passing controls against unchanged `ece51fe`). The legacy protobuf manifest
+fixture is a passing compatibility control.
+Focused fixed regressions: `/tmp/easyp-additional-policies-green.log`.
+Missing-alias unit failure and correction:
+`/tmp/easyp-additional-unit-{red,green}.log`.
+Absolute-path and file-target failures:
+`/tmp/easyp-additional-{absolute,scope}-red.log`.
+The final targeted suite has 30 CLI cases, including 6 absolute/plain/native/
+alias/inherited-policy cases and 6 scope-isolation controls.
+
+## Final verification — 2026-10-04
+
+Tested binaries: `/tmp/easyp-additional-fixes` and
+`/tmp/easyp-additional-fixes-mcp`, built from the final working tree. Commands
+used `GOCACHE=/tmp/easyp-codex-go-cache`; E2E also used `EASYP_SOURCE` pointing
+to this checkout and `EASYP_TEST_PYTHON=/tmp/easyp-python-grpc-runtime/bin/python`.
+
+| Command | Result |
+| --- | --- |
+| EasyP `go test -race -count=1 ./...` | PASS. |
+| easyp-test `go test -race -tags=v1,live_dependencies,python_grpc ./tests/e2e/v1 -count=1 -parallel=4 -v` | PASS, 151.555s. Includes the complete standard v1 suite, 30 targeted policy cases, 66 Go SDK compilations, 11 real upstream dependency cases, and 8 Python gRPC runtime cases. |
+| easyp-test `go test -race -tags=v1,python_grpc ./tests/e2e/v1 -count=1 -parallel=4` | PASS, 84.726s after the final error-guard readability change; source unit/race, lint, vet and ARM build were also rerun. |
+| easyp-test `go test -race -count=1 ./internal/... ./cmd/...` | PASS. |
+| EasyP `go vet ./...`; easyp-test `go vet -tags=v1,live_dependencies,python_grpc ./tests/e2e/v1` | PASS. |
+| `task lint:go LOCAL_BIN=/tmp/easyp-quality-tools/golangci-lint-2.14.0-darwin-arm64` | PASS, 0 issues. |
+| `task lint:docker` | PASS. |
+| `task schema:check`; `task proto:check` | PASS. |
+| `go mod verify` | PASS. |
+| `GOOS=linux GOARCH=arm GOARM=7 go build ./cmd/easyp ./cmd/easyp-mcp` | PASS. |
+| Go formatting and `git diff --check` in both repositories | PASS. |
+
+Independent read-only review reproduced the absolute-baseline defect and the
+initial file-target false positive. After regressions and corrections, it found
+no remaining confirmed defects, including additional deleted/aliased selections.
+Full verification logs are `/tmp/easyp-additional-final-*.log`.
+The optional external Python gRPC plugin suite was not run; the builtin Python
+and builtin gRPC Python runtime cases were run.
diff --git a/.spec/plans/2026-10-04-review-regressions.md b/.spec/plans/2026-10-04-review-regressions.md
new file mode 100644
index 00000000..fd4cd5ff
--- /dev/null
+++ b/.spec/plans/2026-10-04-review-regressions.md
@@ -0,0 +1,113 @@
+# v1 review regressions and fixes
+
+## Goal
+
+Address every finding from the review of `d70401e`, including documentation.
+Add CLI regressions in `easyp-test` before changing EasyP. Successful Go
+generation must produce an SDK that compiles, not merely exit successfully.
+
+## Contracts to preserve
+
+- `options.go.package_prefix` works with managed mode omitted, enabled, or disabled.
+- Managed disable selectors and explicit overrides keep their precedence.
+- Path markers retain their existing file path semantics.
+- Ordinary option prefixes derive multi-segment Go paths from protobuf packages.
+- Import-only local replacements do not contribute consumer lint/breaking policies.
+- Explicitly selecting a replacement still validates its own policy.
+- Git modules are resolved from the requested revision, independently of current
+  checkout metadata. Unrelated parent worktrees must not be treated as modules.
+- The v1 default breaking profile is FILE; low-level legacy callers stay supported.
+
+## Work
+
+1. **Regressions first**
+   - Add a managed/prefix matrix: omitted/enabled/disabled, ordinary prefixes,
+     single-segment packages, path markers, disabled Go options, and overrides.
+     Check descriptor `go_package`, generated locations, and compile each Go SDK.
+   - Add overlapping proto basenames (`user.proto`, `user_types.proto`) with
+     distinct protobuf packages and compile the generated SDK.
+   - Add consumer lint and breaking cases with replacement-local legacy/invalid
+     policies; verify ignored policies and explicit selection separately.
+   - Add local nested Git modules resolved by historical tag and commit after
+     removal of their live manifest, including cold-cache frozen download.
+   - Run the new suites against the unmodified review binary and record failures.
+2. **Go output placement (Must Fix + Should Fix)**
+   - Use the effective Go import path after managed rules to place Go outputs.
+   - Match the generating proto unambiguously; preserve plugin-specific filenames
+     and outputs whose location is already controlled by the plugin.
+   - Relocate only explicit `paths=source_relative`; cover omitted/default import
+     paths when the proto source directory coincides with the Go import path.
+     Repeated `paths` options use the plugin's last-value priority.
+   - Add focused table-driven unit tests for relocation and rule interactions.
+3. **Consumer policies (Should Fix)**
+   - Filter import-only replacement modules before reading their policies.
+   - Preserve explicit target selection and error propagation.
+4. **Historical local Git modules (Should Fix)**
+   - Discover the repository without requiring live module metadata.
+   - Validate nested module identity at the fetched revision; retain isolation
+     from unrelated parent repositories.
+5. **Documentation (Nice to Have)**
+   - Correct stale v1 breaking-default statements in AGENTS, agent rules, and
+     architecture documentation. Check other current references for consistency.
+6. **Verification and final review**
+   - Run the new regressions with the fixed binary, then the full v1 E2E suite.
+   - Run Go formatting, `go test -race -count=1 ./...`, `go vet ./...`, project
+     Go lint, schema drift checks, module verification, and the ARM build gate.
+   - Review both final diffs, preserve unrelated local files, and report exact
+     commands/results and any unavailable checks.
+
+## Progress
+
+- [x] Regression suites added and baseline failures confirmed.
+- [x] Effective Go output placement and ambiguous basenames fixed.
+- [x] Replacement policy ordering fixed.
+- [x] Historical local Git module discovery fixed.
+- [x] Documentation corrected.
+- [x] Full verification and final diff review complete.
+
+## Implementation
+
+| Concern | EasyP files | Regression suites in `easyp-test/tests/e2e/v1` |
+| --- | --- | --- |
+| Effective Go paths and source identity | `internal/generation/config.go`, `internal/core/core.go`, `generate.go`, `go_package_output.go`, `go_package_output_test.go` | `managed_go_layout_test.go`: 42 managed/layout cases, 21 plugin-layout cases, 3 overlapping-name cases; all 66 SDKs compile. |
+| Import-only replacement policies | `internal/api/lint_v1.go`, `breaking_v1.go` | `review_consumer_policies_test.go`: legacy/invalid policies, lint/breaking, explicit-selection controls. |
+| Historical local Git discovery | `internal/adapters/gitmodules/git_source.go`, `git_source_test.go` | `review_historical_local_module_test.go`: 4 historical revisions/layouts, 2 unrelated-worktree rejection cases. |
+| Current breaking documentation | `AGENTS.md`, `.spec/agent-rules.md`, `ARCHITECTURE.md`, `ERRORS.md`, `DOMAIN.md` | `review_breaking_docs_test.go`: all 5 current references. |
+
+The local candidate unit test now checks the nearest worktree boundary; module
+acceptance is checked against the requested revision by the CLI regressions.
+No live manifest is required to propose a repository candidate.
+
+Independent final review found and verified two additional branches of the Go
+layout defect: omitted `paths` uses import layout, and repeated `paths` use the
+last value. Both first failed a new regression against the intermediate binary,
+then passed after correction. No confirmed findings remained in final review.
+
+## Verification — 2026-10-04
+
+Source baseline: EasyP `d70401e`; easyp-test `f71ac96`. Checks below cover the
+working-tree fixes. Binaries: `/tmp/easyp-review-fixes` and
+`/tmp/easyp-review-fixes-mcp`. Go cache: `/tmp/easyp-codex-go-cache`.
+
+| Command | Result |
+| --- | --- |
+| Targeted `go test -race -tags=v1 ./tests/e2e/v1 -run '^TestReview(ManagedGoLayout\|GoPluginImportLayout\|GoLayoutOverlappingProtoNames\|ReplacementPolicyIsImportOnly\|HistoricalLocalModule\|UnrelatedLocalWorktreeIsNotModule\|BreakingDefaultDocumentation)$' -count=1 -parallel=4 -v` | PASS: 81 cases, including 66 Go/Go gRPC SDK compilations. |
+| EasyP `go test -race -count=1 ./...` | PASS. |
+| easyp-test `go test -race -tags=v1 ./tests/e2e/v1 -count=1 -parallel=4` | PASS: 77.482s with the final CLI/MCP binaries and `EASYP_SOURCE` set to the tested checkout. |
+| easyp-test `go test -race -count=1 ./internal/... ./cmd/...` | PASS. |
+| EasyP `go vet ./...`; easyp-test `go vet -tags=v1 ./tests/e2e/v1` | PASS. |
+| `task lint:go LOCAL_BIN=/tmp/easyp-quality-tools/golangci-lint-2.14.0-darwin-arm64` | PASS: 0 issues, pinned version 2.14.0. |
+| `task schema:check` | PASS: no schema drift. |
+| `task proto:check` | PASS: validation, lint, lock and deterministic generation. |
+| `go mod verify` | PASS: all modules verified. |
+| `GOOS=linux GOARCH=arm GOARM=7 go build ./cmd/easyp ./cmd/easyp-mcp` | PASS. |
+| Go formatting and `git diff --check` in both repositories | PASS. |
+
+Baseline failure logs are `/tmp/easyp-review-fixes-red.log`,
+`/tmp/easyp-review-fixes-unit-red.log`, and
+`/tmp/easyp-review-fixes-docs-red.log`. Final logs use
+`/tmp/easyp-review-fixes-final-{regressions,unit,v1,lint,schema,proto}.log`.
+Docker lint and opt-in live upstream/Python/plugin tests were not run; the
+standard v1 suite and all new local regressions were run. After verification,
+the user requested committing and pushing these fixes directly for review:
+EasyP to `v1.0`, easyp-test regressions to `master`.
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 00000000..a044f3a1
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,93 @@
+# AGENTS.md
+
+Instructions for AI coding agents working in this repository.
+
+## Project overview
+
+EasyP is a Protocol Buffers CLI toolkit (<code>github.com/easyp-tech/easyp</code>, Go 1.26.6) that provides:
+
+- linting (buf-compatible rules)
+- breaking change detection
+- code generation (local and remote plugins)
+- Git-based dependency / package management (<code>easyp mod</code>)
+
+Human-facing docs: [README.md](README.md) and https://easyp.tech.
+
+## Layout
+
+| Path | Role |
+|------|------|
+| <code>cmd/easyp</code> | CLI entrypoint |
+| <code>internal/api</code> | CLI command wiring |
+| <code>internal/core</code> | Proto parsing, lint/breaking engines and low-level plugin execution |
+| <code>internal/modules</code> | Dependency resolution, manifest/lock operations, import roots and vendoring |
+| <code>internal/generation</code> | Consumer-project discovery, module selection, inherited generation options and descriptor export |
+| <code>internal/migration</code> | Legacy-to-v1 migration plans, validation and guarded apply |
+| <code>internal/rules</code> | Lint rules (each rule + colocated <code>&lt;file&gt;_test.go</code>) |
+| <code>internal/config</code> | Shared engine configuration and validation issue types |
+| <code>internal/adapters</code> | Git module cache, dependency metadata, legacy modfile reader, plugins, console and prompts |
+| <code>internal/adapters/gitmodules</code> | Verified Git checkouts and installed modules under the v1 cache |
+| <code>mcp/easypconfig</code> | MCP reference for policy/generation YAML, <code>protobuf.lock</code> JSON Schema and <code>protobuf.mod</code> text grammar |
+| <code>internal/config/v1</code> | v1 parsing, validation, and JSON Schema source |
+| <code>internal/schemagen</code> | Writes the six versioned/latest v1 JSON Schema artifacts |
+| <code>schemas/</code> | Generated policy, generation and lock JSON Schemas |
+| <code>easyp-tech/docs</code> (separate repository) | Documentation site and its publishing workflow |
+
+## What is .spec/
+.spec/ is a project documentation directory optimized for AI agent (LLM) consumption. It contains:
+
+* Structured descriptions of architecture, packages, and domain model
+* Code conventions and testing patterns
+* Infrastructure and tooling descriptions
+* [Agent rules](.spec/agent-rules.md) with mandatory coding standards
+* Purpose: give the agent project context without reading the entire source code. Start with [.spec/README.md](.spec/README.md), then verify relevant details against source before changing behavior.
+
+
+## Build, test, lint
+
+Prefer Task targets from [<code>Taskfile.yml</code>](Taskfile.yml):
+
+~~~sh
+task init              # install local tools (golangci-lint, gotestsum, mockery)
+task build             # go build -o easyp ./cmd/easyp
+task test              # gotestsum with -race and coverage
+task lint              # Go lint + hadolint on root Dockerfile
+task lint:go           # Go lint without Docker
+task lint:docker       # hadolint on root Dockerfile
+task quality           # test + lint
+task schema:generate   # regenerate schemas/*.json
+task schema:check      # generate and fail if schemas drift
+task mocks             # optional core and console mocks
+task dev-tools:check   # offline Taskfile dispatch smoke test
+task docker:build      # local root Dockerfile build; no publish
+~~~
+
+Equivalents without Task:
+
+~~~sh
+go build -o easyp ./cmd/easyp
+go test -race -count=1 ./...
+go run ./cmd/easyp schema-gen
+~~~
+
+After behavior changes, run the relevant tests (at least the packages you touched). For config schema changes, run <code>task schema:check</code> before finishing.
+
+<code>task init</code> installs pinned helpers into the repository's <code>bin/</code>, including when invoked from a nested directory, and fetches dependencies with <code>go mod download</code>. <code>task lint</code> attempts both checks and fails if either fails; Docker must be available for Hadolint. <code>task docker</code> aliases the local <code>docker:build</code> target, with an overridable <code>DOCKER_IMAGE</code> tag (default <code>easyp:local</code>). Release publishing stays in the release workflow. See [.spec/TOOLS.md](.spec/TOOLS.md).
+
+## Conventions
+
+- **New lint rules**: add <code>internal/rules/&lt;rule&gt;.go</code> + <code>&lt;file&gt;_test.go</code>, register via the existing rule builder; mirror patterns in neighboring rules.
+- **v1 YAML schemas**: change types and schema rules in <code>internal/config/v1</code>, then regenerate <code>schemas/</code> with <code>task schema:generate</code>. The MCP tool reads the same schema through <code>v1.SchemaJSON</code>; update its field descriptions when behavior changes. Do not hand-edit generated schema JSON.
+- **Tests**: use <code>testify</code>; update test doubles when interfaces change. Optional <code>task mocks</code> targets <code>core.Rule</code>, <code>core.CurrentProjectGitWalker</code> and <code>console.Console</code> in <code>internal/adapters/console</code>. Existing tests use handwritten doubles; mock generation is not a build/test prerequisite. Compile generated outputs before using them and do not commit unused mocks.
+- **v1 files**: policy is <code>easyp.yaml</code>; generation is <code>easyp.gen.yaml</code>; native <code>protobuf.mod</code> declares dependencies; <code>protobuf.lock</code> records verified revisions. Use <code>easyp migrate</code> for a legacy migration preview, <code>easyp migrate --interactive</code> for the wizard, and <code>--write</code> for explicit apply; see [.spec/CLI.md](.spec/CLI.md).
+- **Implementation boundaries**: Explicit breaking profiles FILE/PACKAGE/WIRE_JSON/WIRE are implemented; omitted or empty categories default to FILE for v1 policies. Local replacements use a non-persisted overlay; explicit frozen mode verifies only the published graph and unknown-import-to-module discovery is intentionally excluded; [.spec/ERRORS.md](.spec/ERRORS.md) separates those gaps from actual CLI exit behavior.
+- Prefer pointing agents/humans at README and docs over copying long usage text into this file.
+
+## Do not
+
+- Commit secrets, credentials, or unrelated local artifacts.
+- Hand-edit generated schema JSON: <code>schemas/easyp-v1.schema.json</code>, <code>schemas/easyp.schema.json</code>, <code>schemas/easyp.gen-v1.schema.json</code>, <code>schemas/easyp.gen.schema.json</code>, <code>schemas/protobuf.lock-v1.schema.json</code>, <code>schemas/protobuf.lock.schema.json</code>.
+- Commit or “fix” generated dependency/build noise, <code>coverage.out</code>, or the local <code>easyp</code> binary in the repo root. The documentation site lives in the separate docs repository.
+- Add parallel agent instruction files (<code>.cursor/rules/</code>, <code>CLAUDE.md</code>) unless explicitly requested; keep this file the source of truth.
+
+Shared producer policies use section-scoped <code>extends</code> from bounded local files or already declared/locked modules. See [.spec/config/policy-extends.md](.spec/config/policy-extends.md). No standalone policy versions or unpinned reference downloads are allowed.
diff --git a/Dockerfile b/Dockerfile
index 84d250f2..30afb9c2 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -4,6 +4,7 @@ ARG TARGETPLATFORM
 ARG BUILDPLATFORM
 ARG TARGETOS
 ARG TARGETARCH
+ARG RELEASE_VERSION
 
 LABEL stage=gobuilder
 
@@ -18,11 +19,21 @@ RUN go mod download
 
 COPY . .
 
-RUN go build -trimpath -o /easyp ./cmd/easyp
+RUN go build -trimpath -ldflags "-s -w -X github.com/easyp-tech/easyp/internal/version.releaseVersion=${RELEASE_VERSION}" -o /easyp ./cmd/easyp
 
 FROM alpine:3.22
 
-RUN apk add --no-cache ca-certificates tzdata git bash
+# Keep package pins aligned with the Alpine release; override for verified updates.
+ARG CA_CERTIFICATES_VERSION=20260909-r0
+ARG TZDATA_VERSION=2026d-r0
+ARG GIT_VERSION=2.49.1-r0
+ARG BASH_VERSION=5.2.37-r0
+
+RUN apk add --no-cache \
+    ca-certificates="${CA_CERTIFICATES_VERSION}" \
+    tzdata="${TZDATA_VERSION}" \
+    git="${GIT_VERSION}" \
+    bash="${BASH_VERSION}"
 
 COPY --from=builder /easyp /easyp
 
diff --git a/README.md b/README.md
index 541de5c0..90f3c9c6 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,8 @@
 # EasyP
 
 [![License](https://img.shields.io/github/license/easyp-tech/easyp?color=blue)](https://github.com/easyp-tech/easyp/blob/main/LICENSE)
-[![Release](https://img.shields.io/github/v/release/easyp-tech/easyp?include_prereleases)](https://github.com/easyp-tech/easyp/releases)
-[![CI](https://github.com/easyp-tech/easyp/workflows/ci/badge.svg)](https://github.com/easyp-tech/easyp/actions?workflow=ci)
+[![Stable release](https://img.shields.io/github/v/release/easyp-tech/easyp)](https://github.com/easyp-tech/easyp/releases/latest)
+[![CI](https://github.com/easyp-tech/easyp/actions/workflows/tests.yml/badge.svg)](https://github.com/easyp-tech/easyp/actions/workflows/tests.yml)
 
 **Modern Protocol Buffers toolkit for streamlined development workflows**
 
@@ -16,6 +16,10 @@ The `easyp` CLI is a comprehensive tool for working with [Protocol Buffers](http
 
 ## Installation
 
+The latest stable release is **v0.17.0**. The source on this branch implements
+**v1.0**, which is distributed only through explicitly selected nightly versions.
+Merging v1 into `main` does not update the stable installation channels.
+
 ### Homebrew
 
 You can install `easyp` using [Homebrew](https://brew.sh) (macOS or Linux):
@@ -32,24 +36,65 @@ go install github.com/easyp-tech/easyp/cmd/easyp@latest
 
 ### Other methods
 
-For other installation methods, see our [official documentation](https://easyp.tech/docs/guide/introduction/install), which covers:
+For archives and Docker installation, see the [installation guide](https://easyp.tech/docs/introduction/install).
+
+### v1 nightly (explicit opt-in)
+
+Choose an existing `v1.0.0-nightly.YYYYMMDD.N` tag from
+[GitHub Releases](https://github.com/easyp-tech/easyp/releases). The tag below is a
+placeholder; replace it with a published nightly. Building v1 requires Go 1.26.6
+or later.
+
+```sh
+EASYP_NIGHTLY_VERSION=v1.0.0-nightly.YYYYMMDD.N
+EASYP_NIGHTLY_BIN="$HOME/.local/share/easyp-nightly/bin"
+mkdir -p "$EASYP_NIGHTLY_BIN"
+GOBIN="$EASYP_NIGHTLY_BIN" go install "github.com/easyp-tech/easyp/cmd/easyp@$EASYP_NIGHTLY_VERSION"
+GOBIN="$EASYP_NIGHTLY_BIN" go install "github.com/easyp-tech/easyp/cmd/easyp-mcp@$EASYP_NIGHTLY_VERSION"
+"$EASYP_NIGHTLY_BIN/easyp" --version
+```
 
-- Installing `easyp` via npm
-- Using `easyp` as a Docker image
-- Installing as a binary from GitHub Releases
+Nightly archives contain both `easyp` and `easyp-mcp`, with a checksums file in the
+same release. The CLI container uses the exact tag
+`ghcr.io/easyp-tech/easyp:<nightly-tag>`. Nightlies do not update Homebrew,
+GitHub Latest, or the Docker `latest` tag. `go install ...@latest` continues to
+select the stable v0 release while v1 has only prerelease tags.
+
+Go modules use the same `github.com/easyp-tech/easyp` path for v0 and v1; there is
+no `/v1` suffix. The `/v2` suffix is required starting with v2. Existing pinned
+v0 dependencies keep their versions after the merge, but explicitly upgrading
+to v1 may require API and configuration changes. Creating a **stable Git tag**
+`v1.0.0` would make it eligible for `@latest`, even without a GitHub Release, so
+v1 stable tags must not be created during the nightly period. See
+[Go module version numbering](https://go.dev/doc/modules/version-numbers).
+
+Go selects one version per module path for a build. Another dependency requiring
+a v1 nightly can raise the selected version through
+[minimal version selection](https://go.dev/ref/mod#minimal-version-selection),
+so library consumers also need a dependency graph compatible with v0.
 
 ## Quick Start
 
+These commands describe the v1 nightly contract. Select the nightly binary
+above, or build this checkout, before using them. For an existing v0 project,
+run `easyp migrate` to preview its migration and `easyp migrate --write` to apply
+the plan.
+
 ```sh
+# Select the explicitly installed nightly for this terminal's v1 examples.
+export PATH="$HOME/.local/share/easyp-nightly/bin:$PATH"
+easyp --version
+
 # Initialize a new project
 mkdir my-proto-project && cd my-proto-project
-easyp init
+easyp init --module github.com/acme/my-proto-project
 
 # Add your .proto files to the project
 mkdir api
 # ... add your .proto files to api/ ...
 
 # Download dependencies and generate code
+easyp mod tidy
 easyp mod download
 easyp generate
 
@@ -70,11 +115,11 @@ easyp --help
 
 For comprehensive usage information, consult EasyP's [documentation](https://easyp.tech), especially these guides:
 
-* [What is EasyP?](https://easyp.tech/docs/guide/introduction/what-is) - Overview and key concepts
-* [`easyp lint`](https://easyp.tech/docs/guide/cli/linter/linter) - Code linting and validation
-* [`easyp breaking`](https://easyp.tech/docs/guide/cli/breaking-changes/breaking-changes) - Breaking change detection
-* [`easyp mod`](https://easyp.tech/docs/guide/cli/package-manager/package-manager) - Package management
-* [`easyp generate`](https://easyp.tech/docs/guide/cli/generator/generator) - Code generation
+* [What is EasyP?](https://easyp.tech/docs/introduction/what-is) - Overview and key concepts
+* [`easyp lint`](https://easyp.tech/docs/cli/linter) - Code linting and validation
+* [`easyp breaking`](https://easyp.tech/docs/cli/breaking-changes) - Breaking change detection
+* [`easyp mod`](https://easyp.tech/docs/cli/package-manager) - Package management
+* [`easyp generate`](https://easyp.tech/docs/cli/generator) - Code generation
 * `easyp validate-config` - Validate `easyp.yaml` structure and types (JSON or text output)
 * Global flag: `--format, -f` / env `EASYP_FORMAT` (`text` or `json`) for commands that support formatted output
 
@@ -101,8 +146,8 @@ While buf.build provides excellent protobuf tooling, EasyP offers several key ad
 **Key Benefits:**
 - **No infrastructure changes**: Use your existing Git repositories for proto dependencies
 - **Enhanced flexibility**: Execute plugins both locally and remotely for consistent results
-- **Simplified configuration**: Single file for all protobuf operations
-- **Full buf compatibility**: Drop-in replacement with familiar rule sets and configuration
+- **Separated configuration**: `protobuf.mod`, `easyp.gen.yaml`, and `easyp.yaml` each own one part of the workflow
+- **Buf dependency roots**: Git dependencies using Buf v1 or v2 configuration can supply import roots
 
 ## Our goals for Protobuf
 
@@ -112,61 +157,58 @@ While Protocol Buffers offer significant technical advantages over REST/JSON, ac
 
 ## Configuration
 
-EasyP uses a single `easyp.yaml` file for all configuration:
+The development version of EasyP v1.0 uses `protobuf.mod` for module identity, source roots, and dependencies. `easyp.gen.yaml` selects modules and plugins; `easyp.yaml` configures lint and breaking checks. Run `easyp get <module>[@version|@tag|@commit]` from the module directory to add a direct requirement and record its transitive dependencies as `// indirect`. Named Git tags are resolved to full commits before the requirement is written. The command writes pinned commits and content hashes to `protobuf.lock`; `easyp mod tidy` resolves requirements already in the manifest.
 
-```yaml
-# Dependencies
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/bufbuild/protoc-gen-validate@v0.9.1
+Git dependencies using Buf can resolve known BSR dependencies through fixed Git snapshots, including the Googleapis dependency of grpc-gateway and grpc-federation. The lock retains the original BSR reference, commit and digest with `resolution: compatibility_snapshot`; the CLI explicitly reports that BSR revision equivalence and digest verification are not guaranteed. Frozen commands reuse the recorded mapping. Unknown BSR modules fail explicitly. See [supported mappings and resolver boundaries](.spec/config/dependency.md#bsr-compatibility-snapshots).
+
+The [`easyp_config_describe` MCP tool](mcp/easypconfig/README.md) describes the editable v1 YAML files and uses the same JSON Schemas as the CLI.
 
-# Code generation
+In `easyp.yaml` and `easyp.gen.yaml`, EasyP expands environment variables before parsing and validation. Use `${NAME}`, `${NAME:-default}` for a fallback, or `$${NAME}` to keep a literal `${NAME}`. An unset variable without a fallback expands to an empty string. Substitutions inside YAML comments are ignored. `protobuf.mod` and `protobuf.lock` do not expand environment variables.
+
+```text
+# protobuf.mod
+module github.com/acme/contracts
+roots proto
+require github.com/acme/weather v1.2.0
+```
+
+```yaml
+# easyp.gen.yaml
+version: v1
 generate:
-  inputs:
-    - directory: "api"
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - remote: api.beta.easyp.tech/community/stephenh-ts-proto:v1.178.0
-      out: ./web/generated
-      opts:
-        env: node
-        useExactTypes: false
-        outputServices:
-          - grpc-js
-          - generic-definitions
-        esModuleInterop: true
-        useOptionals: true
-
-# Linting
-lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-    - PACKAGE_DEFINED
-    - FIELD_LOWER_SNAKE_CASE
-    - MESSAGE_PASCAL_CASE
+  modules: [github.com/acme/contracts]
+plugins:
+  - name: go
+    out: ./gen/go
+    opts:
+      paths: source_relative
+```
+
+A plugin can select one source: `name` for a local or bundled plugin, `path` for an explicit binary, `command` for an executable and its arguments, or `remote` with a pinned `version`. Relative binary paths and commands run from the directory where `easyp generate` starts.
+
+```yaml
+# easyp.yaml
+version: v1
+linters:
+  default: STANDARD
+breaking:
+  baseline: git:main
+```
 
 # Configuration validation
 
-`easyp validate-config` validates `easyp.yaml` (or a custom path passed via `--config`). It expands env vars, checks required fields and types, warns on unknown keys, and exits with a non-zero status when errors are found.
+`easyp validate-config` recursively validates every `easyp.yaml`, `easyp.gen.yaml`, `protobuf.mod`, and `protobuf.lock` under the current directory. Use `--config` to validate one file or all matching files under a selected directory. Errors include the file path and, for YAML structure errors, the line and column. The command exits with a non-zero status when errors are found.
 
 ```sh
-# Validate the default easyp.yaml with JSON output (default)
+# Validate all EasyP configuration and module files below the current directory
 easyp validate-config
 
-# Validate a custom file with text output (global --format flag)
-easyp --format text validate-config --config example.easyp.yaml
-```
-
-### Config Schema Integration
-
-The source of truth for config schema + MCP tool metadata lives in [`mcp/easypconfig`](mcp/easypconfig/README.md).
+# Validate one generator file with text output
+easyp --format text validate-config --config easyp.gen.yaml
 
-- Go integration: import `github.com/easyp-tech/easyp/mcp/easypconfig` and call `RegisterTool(...)` / `Describe(...)`.
-- Cross-language integration: consume generated JSON Schema artifacts in `schemas/easyp-config-v1.schema.json` and `schemas/easyp-config.schema.json`.
-- Regenerate artifacts: `task schema:generate` (or `go run ./cmd/easyp schema-gen`).
+# Validate every matching file below a directory
+easyp validate-config --config ./services
+```
 
 ## Community
 
@@ -190,3 +232,25 @@ EasyP is released under the [Apache License 2.0](LICENSE).
 ---
 
 *Built with ❤️ for the Protocol Buffers community*
+
+
+### Working with the v1 pilot
+
+The implementation and `.spec` tree define the current unreleased v1 contract. Some earlier pilot RFC examples were intentionally superseded; see [v1.0 pre-release contract notes](V1_RELEASE_NOTES.md) before treating an old RFC example as a compatibility requirement.
+
+The repository's native configuration has a runnable local example. Run
+<code>task proto:check</code> to validate it, lint it and verify repeatable
+generation without altering the source checkout. User configuration is split
+between <code>easyp.yaml</code>, <code>easyp.gen.yaml</code> and
+<code>protobuf.mod</code>/<code>protobuf.lock</code>.
+
+For a v0 project, <code>easyp migrate --module github.com/acme/contracts</code>
+previews conversion; it does not write or execute plugins. See the
+[documented migration contract](.spec/config/review-migration-and-polish.md)
+before applying it with <code>--write</code>.
+
+Run <code>easyp migrate</code> in a terminal for a guided migration, or add
+<code>--interactive</code> to use the wizard with prefilled flags. Dependency
+access and applying files require separate confirmations, both defaulting to no.
+Explicit <code>--module</code> without the wizard keeps the preview-first script
+interface; <code>--interactive=false</code> disables automatic prompting.
diff --git a/Taskfile.yml b/Taskfile.yml
index 9baa4dd0..1fab7967 100644
--- a/Taskfile.yml
+++ b/Taskfile.yml
@@ -1,63 +1,100 @@
 version: "3"
 
 vars:
-  LINTER_VERSION: "2.1.6"
+  LINTER_VERSION: "2.14.0"
   GOTESTSUM_VERSION: "1.13.0"
   HADOLINT_VERSION: "v2.12.1-beta"
-  LOCAL_BIN: "{{.USER_WORKING_DIR}}/bin"
+  LOCAL_BIN: "{{.ROOT_DIR}}/bin"
   MOCKERY_VERSION: "v2.53.7"
+  DOCKER_IMAGE: '{{.DOCKER_IMAGE | default "easyp:local"}}'
 
 tasks:
   install_linters:
     cmds:
-      - "curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b {{.LOCAL_BIN}} v{{.LINTER_VERSION}}"
+      - |
+        set -eu
+        installer=$(mktemp)
+        trap 'rm -f "$installer"' EXIT
+        curl -fsSL https://raw.githubusercontent.com/golangci/golangci-lint/v{{.LINTER_VERSION}}/install.sh -o "$installer"
+        sh "$installer" -b {{.LOCAL_BIN | shellQuote}} v{{.LINTER_VERSION}}
 
   install_gotestsum:
     cmds:
-      - "GOBIN={{.LOCAL_BIN}} go install gotest.tools/gotestsum@v{{.GOTESTSUM_VERSION}}"
+      - 'GOBIN={{.LOCAL_BIN | shellQuote}} go install gotest.tools/gotestsum@v{{.GOTESTSUM_VERSION}}'
 
   install_mockery:
     cmds:
-      - "GOBIN={{.LOCAL_BIN}} go install github.com/vektra/mockery/v2@{{.MOCKERY_VERSION}}"
+      - 'GOBIN={{.LOCAL_BIN | shellQuote}} go install github.com/vektra/mockery/v2@{{.MOCKERY_VERSION}}'
 
   install_hadolint:
     cmds:
       - "docker pull ghcr.io/hadolint/hadolint:{{.HADOLINT_VERSION}}"
 
   init:
+    desc: Install pinned local helpers and download module dependencies
     deps:
       - install_linters
       - install_gotestsum
       - install_mockery
     cmds:
-      - "go get -v ./..."
+      - "go mod download"
 
   build:
+    desc: Build the CLI locally
     cmds:
       - "go build -o easyp ./cmd/easyp"
 
+  proto:check:
+    desc: Validate the native v1 example and verify deterministic generation
+    cmds:
+      - sh scripts/check-proto-example.sh
+
   schema:generate:
-    desc: Generate versioned and latest easyp config JSON Schema artifacts
+    desc: Generate v1 JSON Schemas from the configuration models
     cmds:
-      - "go run ./cmd/easyp schema-gen"
+      - "go run ./cmd/easyp schema-gen --out-dir schemas"
 
   schema:check:
-    desc: Ensure schema artifacts are up to date
+    desc: Verify committed v1 JSON Schemas match the configuration models
     cmds:
-      - task: schema:generate
-      - "git diff --exit-code -- schemas/easyp-config-v1.schema.json schemas/easyp-config.schema.json"
+      - |
+        schema_check_dir=$(mktemp -d)
+        trap 'rm -rf "$schema_check_dir"' EXIT
+        go run ./cmd/easyp schema-gen --out-dir "$schema_check_dir"
+        diff -r schemas "$schema_check_dir"
 
   test:
+    desc: Run Go tests with race detection and coverage
+    preconditions:
+      - sh: 'test -x {{printf "%s/gotestsum" .LOCAL_BIN | shellQuote}}'
+        msg: 'Missing local gotestsum; run task install_gotestsum.'
     cmds:
-      - "{{.LOCAL_BIN}}/gotestsum --format pkgname -- -coverprofile=coverage.out -race -count=1 ./..."
+      - '{{printf "%s/gotestsum" .LOCAL_BIN | shellQuote}} --format pkgname -- -coverprofile=coverage.out -race -count=1 ./...'
 
   lint:
-    deps:
-      - build
+    desc: Run both Go and Dockerfile lint checks, reporting either failure
     cmds:
-      - "docker run --rm -i ghcr.io/hadolint/hadolint:{{.HADOLINT_VERSION}} < Docker/base/Dockerfile"
-      - "docker run --rm -i ghcr.io/hadolint/hadolint:{{.HADOLINT_VERSION}} < Docker/lint/Dockerfile"
-      - "{{.LOCAL_BIN}}/golangci-lint run ./..."
+      - |
+        status=0
+        {{.TASK_EXE | shellQuote}} lint:go LOCAL_BIN={{.LOCAL_BIN | shellQuote}} || status=$?
+        {{.TASK_EXE | shellQuote}} lint:docker HADOLINT_VERSION={{.HADOLINT_VERSION | shellQuote}} || status=$?
+        exit "$status"
+
+  lint:go:
+    desc: Lint Go sources with the pinned local golangci-lint
+    preconditions:
+      - sh: 'test -x {{printf "%s/golangci-lint" .LOCAL_BIN | shellQuote}}'
+        msg: 'Missing local golangci-lint; run task install_linters.'
+    cmds:
+      - '{{printf "%s/golangci-lint" .LOCAL_BIN | shellQuote}} run ./...'
+
+  lint:docker:
+    desc: Lint the root Dockerfile with pinned Hadolint in Docker
+    preconditions:
+      - sh: 'command -v docker >/dev/null 2>&1'
+        msg: 'Docker is required; install Docker and start its daemon to run this task.'
+    cmds:
+      - 'docker run --rm -i ghcr.io/hadolint/hadolint:{{.HADOLINT_VERSION}} < {{printf "%s/Dockerfile" .ROOT_DIR | shellQuote}}'
 
   quality:
     deps:
@@ -79,62 +116,42 @@ tasks:
       - "go clean -cache"
 
   mock:
+    desc: Generate an optional mock (NAME and DIR required)
+    requires:
+      vars: [NAME, DIR]
+    preconditions:
+      - sh: 'test -x {{printf "%s/mockery" .LOCAL_BIN | shellQuote}}'
+        msg: 'Missing local mockery; run task install_mockery.'
     cmds:
-      - "{{.LOCAL_BIN}}/mockery --name {{.NAME}} --dir {{.DIR}} --output {{.DIR}}/mocks"
+      - '{{printf "%s/mockery" .LOCAL_BIN | shellQuote}} --name {{.NAME | shellQuote}} --dir {{.DIR | shellQuote}} --output {{printf "%s/mocks" .DIR | shellQuote}}'
 
   mocks:
+    desc: Generate optional core and console mocks (not required by the test suite)
     cmds:
-      - task: mock
-        vars: { NAME: "LockFile", DIR: "./internal/adapters/storage" }
-
       - task: mock
         vars: { NAME: "Rule", DIR: "./internal/core" }
       - task: mock
-        vars: { NAME: "Console", DIR: "./internal/core" }
+        vars: { NAME: "Console", DIR: "./internal/adapters/console" }
       - task: mock
         vars: { NAME: "CurrentProjectGitWalker", DIR: "./internal/core" }
-      - task: mock
-        vars: { NAME: "Storage", DIR: "./internal/core" }
-      - task: mock
-        vars: { NAME: "ModuleConfig", DIR: "./internal/core" }
-      - task: mock
-        vars: { NAME: "LockFile", DIR: "./internal/core" }
 
-  docker_base:
-    preconditions:
-      - test -f Docker/base/Dockerfile
+  docker:
+    desc: Build the current Docker image locally (alias for docker:build)
     cmds:
-      - docker build -f Docker/base/Dockerfile -t easyp/base:latest .
-      - docker tag easyp/base:latest easyp/base:{{.GIT_TAG}}
+      - task: docker:build
 
-  docker_lint:
+  docker:build:
+    desc: Build root Dockerfile locally; override DOCKER_IMAGE to change the tag
     preconditions:
-      - test -f Docker/lint/Dockerfile
+      - sh: 'command -v docker >/dev/null 2>&1'
+        msg: 'Docker is required; install Docker and start its daemon to run this task.'
     cmds:
-      - docker build -f Docker/lint/Dockerfile --build-arg="EASYP_BASE_VERSION=latest" -t easyp/lint:latest .
-      - docker tag easyp/lint:latest easyp/lint:{{.GIT_TAG}}
+      - 'docker build -f {{printf "%s/Dockerfile" .ROOT_DIR | shellQuote}} -t {{.DOCKER_IMAGE | shellQuote}} {{.ROOT_DIR | shellQuote}}'
 
-  docker_push:
+  dev-tools:check:
+    desc: Check developer task dispatch offline with isolated trace tools
     cmds:
-      - docker push easyp/base:latest
-      - docker push easyp/base:{{.GIT_TAG}}
-      - docker push easyp/lint:latest
-      - docker push easyp/lint:{{.GIT_TAG}}
-
-  docker:
-    vars:
-      GIT_TAG:
-        sh: "git describe --tags --abbrev=0"
-    cmds:
-      - task: docker_base
-        vars:
-          GIT_TAG: "{{.GIT_TAG}}"
-      - task: docker_lint
-        vars:
-          GIT_TAG: "{{.GIT_TAG}}"
-      - task: docker_push
-        vars:
-          GIT_TAG: "{{.GIT_TAG}}"
+      - sh scripts/check-dev-tools.sh
 
   goreleaser:check:
     desc: Check GoReleaser configuration syntax
diff --git a/V1_RELEASE_NOTES.md b/V1_RELEASE_NOTES.md
new file mode 100644
index 00000000..5a48190e
--- /dev/null
+++ b/V1_RELEASE_NOTES.md
@@ -0,0 +1,70 @@
+# EasyP v1.0 — pre-release contract notes
+
+EasyP v1.0 has no stable release. It is prepared for explicitly selected nightly
+versions; the default installation remains the stable v0.17.0 release. The
+implementation and the current `.spec` documents are the source of truth for
+the v1 contract.
+
+## Distribution and Go module compatibility
+
+After the v1 branch is merged into `main`, v1 is published only with
+`v1.0.0-nightly.YYYYMMDD.N` tags. The workflow marks releases as prereleases,
+keeps GitHub Latest unchanged, and publishes only the exact Docker tag. It does
+not publish a Homebrew formula. See [installation](README.md#v1-nightly-explicit-opt-in)
+and [release operations](.spec/DEPLOYMENT.md).
+
+The Go module path remains `github.com/easyp-tech/easyp`: v0 and v1 share a path,
+and `/vN` is required only for v2 and later. Pinned v0 requirements are unchanged
+by a branch merge. While v1 has only prerelease tags, `go install ...@latest` and
+`go get -u` for v0 consumers select the existing stable release. Explicit nightly
+requirements opt into the v1 API and configuration contract, which may break
+v0 callers. Do not create a stable `v1.0.0` Git tag during the nightly period:
+Go reads Git tags independently of GitHub Release flags, and that tag would
+become eligible for ordinary updates. See [Go's version rules](https://go.dev/doc/modules/version-numbers)
+and [version queries](https://go.dev/ref/mod#version-queries).
+
+Go uses one version per module path in each build. A dependency that requires a
+higher v1 nightly can also raise the selected EasyP version through
+[minimal version selection](https://go.dev/ref/mod#minimal-version-selection).
+The v0/v1 path therefore provides no API isolation between them.
+
+An earlier pilot design RFC was used to bootstrap the v1 branch. Some of its examples and proposed defaults were intentionally superseded during implementation and review. They must not be used as compatibility requirements when they conflict with the contracts below.
+
+## Superseded pilot RFC decisions
+
+| Pilot RFC area | Current v1.0 contract |
+|---|---|
+| Module identity could be implicit | Every native `protobuf.mod` has exactly one `module <identity>` directive. Nested modules include their repository subdirectory in that identity. |
+| A v2+ semantic version could use an unsuffixed module identity | Module identities follow Go major-version semantics: v0/v1 are unsuffixed and native v2+ modules use `/vN`. Verified pre-native repositories can use `+incompatible`; a native manifest cannot bypass the suffix rule. |
+| Lock examples used short commits and no content hash | `protobuf.lock` stores a full 40- or 64-character Git commit and an `h1:` content hash for each locked Git module. Both identity and installed contents are verified. |
+| `generate` without selectors recursively ran every generator below the working directory | Automatic generation selects the nearest ancestor `easyp.gen.yaml`. Recursive execution is explicit with `easyp generate --all`; individual projects use repeatable `--project`. |
+| Plugin `version` was required for both local/bundled and remote plugins | `remote` plugins require a separate pinned semantic `version`. `name`, `path`, and `command` plugins must not declare `version`, because EasyP cannot verify that field against the selected local executable. |
+| Go package layout followed the pilot source-layout examples | `options.go.package_prefix` derives Go import/output paths from the protobuf package hierarchy. This keeps independently selected modules such as `user.v1` and `order.v1` in distinct generated Go directories even when both source modules contain `v1/*.proto`. Explicit managed `go_package_prefix` overrides keep their existing buf-compatible file-path semantics. |
+| Empty `breaking.categories` selected the historical checker | A v1 policy with omitted or empty `breaking.categories` defaults to the descriptor-backed `FILE` profile. Explicit `FILE`, `PACKAGE`, `WIRE_JSON`, and `WIRE` profiles remain available. |
+
+## Dependency and lock compatibility
+
+The native dependency format is documented in [`.spec/config/dependency.md`](.spec/config/dependency.md). In particular:
+
+- `require` versions are separate tokens, not part of module identity.
+- `replace` is a main-module local development overlay. Local replacement state is not written into the shared `protobuf.lock`.
+- `--frozen` is explicit; it validates an existing manifest/lock graph and never infers frozen behavior from `CI=true`.
+- `mod tidy` does not discover arbitrary Git repositories from proto import strings.
+- Known BSR dependencies encountered inside Git dependency metadata can be mapped through the current compatibility-snapshot resolver. Unknown BSR modules fail explicitly; no Git repository is guessed.
+
+## Generation compatibility
+
+The current command behavior is documented in [`.spec/CLI.md`](.spec/CLI.md):
+
+- generation discovery is nearest-project by default and recursive only with `--all`;
+- `generate.modules` selects module identities or workspace module paths;
+- `generate.packages` selects exact protobuf package names;
+- dependencies are available for imports but are not automatically generation targets;
+- `with_imports` is per-plugin and does not change descriptor-export `--include_imports` semantics.
+- source-relative Go output follows the effective descriptor `go_package`, including disable rules, overrides, and path markers; plugin-controlled import layouts stay intact. See [generation details](.spec/config/review-generation-and-baselines.md).
+
+## Migration
+
+`easyp migrate` is the supported v0-to-v1 transition path. It accepts the documented legacy compatibility metadata, preserves legacy inputs until apply succeeds, and does not silently reinterpret a pilot-RFC file as a native v1 manifest.
+
+When reviewing v1.0, treat differences listed in this document as deliberate pre-release contract changes. A failing literal example from the earlier pilot RFC is not by itself a product defect if the current behavior matches this document and the linked `.spec` contract.
diff --git a/cmd/easyp-mcp/main.go b/cmd/easyp-mcp/main.go
new file mode 100644
index 00000000..5b14d36b
--- /dev/null
+++ b/cmd/easyp-mcp/main.go
@@ -0,0 +1,21 @@
+package main
+
+import (
+	"context"
+	"fmt"
+	"os"
+
+	"github.com/modelcontextprotocol/go-sdk/mcp"
+
+	"github.com/easyp-tech/easyp/internal/version"
+	"github.com/easyp-tech/easyp/mcp/easypconfig"
+)
+
+func main() {
+	server := mcp.NewServer(&mcp.Implementation{Name: "easypconfig", Version: version.System()}, nil)
+	easypconfig.RegisterTool(server)
+	if err := server.Run(context.Background(), &mcp.StdioTransport{}); err != nil {
+		fmt.Fprintln(os.Stderr, err)
+		os.Exit(1)
+	}
+}
diff --git a/cmd/easyp/main.go b/cmd/easyp/main.go
index 45ac3dd6..57505bd9 100644
--- a/cmd/easyp/main.go
+++ b/cmd/easyp/main.go
@@ -37,23 +37,25 @@ func main() {
 	app := &cli.App{
 		Name:        "easyp",
 		HelpName:    "easyp",
-		Usage:       "usage info",
-		UsageText:   "usage text info",
-		ArgsUsage:   "args usage info",
+		Usage:       "modern Protocol Buffers toolkit",
+		UsageText:   "easyp [global options] command [command options]",
 		Version:     version.System(),
-		Description: "description info",
+		Description: "Manage protobuf dependencies, lint APIs, generate code, and check compatibility.",
 		Commands: buildCommand(
 			api.Lint{},
 			api.Mod{},
+			api.Get{},
 			api.Completion{},
 			api.Init{},
+			api.Migrate{},
 			api.Generate{},
-			api.SchemaGen{},
 			api.LsFiles{},
+			api.SchemaGen{},
 			api.Validate{},
 			api.BreakingCheck{},
 		),
 		Flags: []cli.Flag{
+			flags.Frozen(),
 			flags.Config,
 			flags.DebugMode,
 			flags.Format,
diff --git a/docs/dist/apple-touch-icon.png b/docs/dist/apple-touch-icon.png
deleted file mode 100644
index 86c15fe8..00000000
Binary files a/docs/dist/apple-touch-icon.png and /dev/null differ
diff --git a/docs/dist/apple-touch-icon.svg b/docs/dist/apple-touch-icon.svg
deleted file mode 100644
index 95187755..00000000
--- a/docs/dist/apple-touch-icon.svg
+++ /dev/null
@@ -1,32 +0,0 @@
-<svg width="180" height="180" viewBox="0 0 180 180" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <defs>
-    <linearGradient id="appleIconGradient" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#60a5fa"/>
-      <stop offset="100%" style="stop-color:#3b82f6"/>
-    </linearGradient>
-    <linearGradient id="appleBgGradient" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#1e293b"/>
-      <stop offset="100%" style="stop-color:#0f172a"/>
-    </linearGradient>
-    <filter id="appleShadow">
-      <feDropShadow dx="0" dy="4" stdDeviation="8" floodOpacity="0.3"/>
-    </filter>
-  </defs>
-
-  <!-- Background with rounded corners for Apple style -->
-  <rect width="180" height="180" rx="40" fill="url(#appleBgGradient)" filter="url(#appleShadow)"/>
-
-  <!-- Subtle inner glow -->
-  <rect width="180" height="180" rx="40" fill="url(#appleIconGradient)" opacity="0.1"/>
-
-  <!-- Letter E -->
-  <path d="M45 50h50v15h-30v20h25v15h-25v20h30v15H45V50z" fill="url(#appleIconGradient)"/>
-
-  <!-- Letter P -->
-  <path d="M105 50h35c8 0 15 7 15 15v10c0 8-7 15-15 15h-20v45h-15V50zm15 25h20c3 0 5-2 5-5v-5c0-3-2-5-5-5h-20v15z" fill="url(#appleIconGradient)"/>
-
-  <!-- Decorative accent dots -->
-  <circle cx="150" cy="30" r="8" fill="#60a5fa" opacity="0.8"/>
-  <circle cx="30" cy="150" r="6" fill="#8b5cf6" opacity="0.7"/>
-  <circle cx="160" cy="140" r="4" fill="#06b6d4" opacity="0.6"/>
-</svg>
diff --git a/docs/dist/assets/_basePickBy-CqMtcO3s.js b/docs/dist/assets/_basePickBy-CqMtcO3s.js
deleted file mode 100644
index 0efd8c01..00000000
--- a/docs/dist/assets/_basePickBy-CqMtcO3s.js
+++ /dev/null
@@ -1 +0,0 @@
-import{e as x,c as O,g as m,k as P,h as p,j as w,l as A,m as c,n as I,t as N,o as E}from"./_baseUniq-CfjWcJYV.js";import{aR as g,aA as F,aS as M,aT as T,aU as _,aV as l,aW as $,aX as B,aY as S,aZ as y}from"./index-BxX29htg.js";var R=/\s/;function G(n){for(var r=n.length;r--&&R.test(n.charAt(r)););return r}var H=/^\s+/;function L(n){return n&&n.slice(0,G(n)+1).replace(H,"")}var o=NaN,W=/^[-+]0x[0-9a-f]+$/i,X=/^0b[01]+$/i,Y=/^0o[0-7]+$/i,q=parseInt;function z(n){if(typeof n=="number")return n;if(x(n))return o;if(g(n)){var r=typeof n.valueOf=="function"?n.valueOf():n;n=g(r)?r+"":r}if(typeof n!="string")return n===0?n:+n;n=L(n);var t=X.test(n);return t||Y.test(n)?q(n.slice(2),t?2:8):W.test(n)?o:+n}var v=1/0,C=17976931348623157e292;function K(n){if(!n)return n===0?n:0;if(n=z(n),n===v||n===-v){var r=n<0?-1:1;return r*C}return n===n?n:0}function U(n){var r=K(n),t=r%1;return r===r?t?r-t:r:0}function fn(n){var r=n==null?0:n.length;return r?O(n):[]}var b=Object.prototype,Z=b.hasOwnProperty,dn=F(function(n,r){n=Object(n);var t=-1,i=r.length,a=i>2?r[2]:void 0;for(a&&M(r[0],r[1],a)&&(i=1);++t<i;)for(var f=r[t],e=T(f),s=-1,d=e.length;++s<d;){var u=e[s],h=n[u];(h===void 0||_(h,b[u])&&!Z.call(n,u))&&(n[u]=f[u])}return n});function un(n){var r=n==null?0:n.length;return r?n[r-1]:void 0}function D(n){return function(r,t,i){var a=Object(r);if(!l(r)){var f=m(t);r=P(r),t=function(s){return f(a[s],s,a)}}var e=n(r,t,i);return e>-1?a[f?r[e]:e]:void 0}}var J=Math.max;function Q(n,r,t){var i=n==null?0:n.length;if(!i)return-1;var a=t==null?0:U(t);return a<0&&(a=J(i+a,0)),p(n,m(r),a)}var hn=D(Q);function V(n,r){var t=-1,i=l(n)?Array(n.length):[];return w(n,function(a,f,e){i[++t]=r(a,f,e)}),i}function gn(n,r){var t=$(n)?A:V;return t(n,m(r))}var j=Object.prototype,k=j.hasOwnProperty;function nn(n,r){return n!=null&&k.call(n,r)}function mn(n,r){return n!=null&&c(n,r,nn)}function rn(n,r){return n<r}function tn(n,r,t){for(var i=-1,a=n.length;++i<a;){var f=n[i],e=r(f);if(e!=null&&(s===void 0?e===e&&!x(e):t(e,s)))var s=e,d=f}return d}function on(n){return n&&n.length?tn(n,B,rn):void 0}function an(n,r,t,i){if(!g(n))return n;r=I(r,n);for(var a=-1,f=r.length,e=f-1,s=n;s!=null&&++a<f;){var d=N(r[a]),u=t;if(d==="__proto__"||d==="constructor"||d==="prototype")return n;if(a!=e){var h=s[d];u=void 0,u===void 0&&(u=g(h)?h:S(r[a+1])?[]:{})}y(s,d,u),s=s[d]}return n}function vn(n,r,t){for(var i=-1,a=r.length,f={};++i<a;){var e=r[i],s=E(n,e);t(s,e)&&an(f,I(e,n),s)}return f}export{rn as a,tn as b,V as c,vn as d,on as e,fn as f,hn as g,mn as h,dn as i,U as j,un as l,gn as m,K as t};
diff --git a/docs/dist/assets/_baseUniq-CfjWcJYV.js b/docs/dist/assets/_baseUniq-CfjWcJYV.js
deleted file mode 100644
index ae660d8c..00000000
--- a/docs/dist/assets/_baseUniq-CfjWcJYV.js
+++ /dev/null
@@ -1 +0,0 @@
-import{be as S,bf as Rn,aW as T,bg as w,bh as xn,bi as mn,aV as sn,bj as Mn,bk as un,bl as x,aT as U,bm as Cn,bn as on,bo as Fn,bp as E,bc as gn,bq as R,aR as ln,br as Dn,bs as D,bt as Gn,bu as Un,bv as _,aZ as Bn,bw as Nn,aU as Kn,bx as X,by as jn,bz as Hn,aY as qn,aX as cn,ba as Yn,bA as M}from"./index-BxX29htg.js";var Zn="[object Symbol]";function B(n){return typeof n=="symbol"||S(n)&&Rn(n)==Zn}function bn(n,r){for(var e=-1,t=n==null?0:n.length,f=Array(t);++e<t;)f[e]=r(n[e],e,n);return f}var J=w?w.prototype:void 0,Q=J?J.toString:void 0;function dn(n){if(typeof n=="string")return n;if(T(n))return bn(n,dn)+"";if(B(n))return Q?Q.call(n):"";var r=n+"";return r=="0"&&1/n==-1/0?"-0":r}function Xn(){}function pn(n,r){for(var e=-1,t=n==null?0:n.length;++e<t&&r(n[e],e,n)!==!1;);return n}function Jn(n,r,e,t){for(var f=n.length,i=e+-1;++i<f;)if(r(n[i],i,n))return i;return-1}function Qn(n){return n!==n}function Wn(n,r,e){for(var t=e-1,f=n.length;++t<f;)if(n[t]===r)return t;return-1}function zn(n,r,e){return r===r?Wn(n,r,e):Jn(n,Qn,e)}function Vn(n,r){var e=n==null?0:n.length;return!!e&&zn(n,r,0)>-1}function $(n){return sn(n)?xn(n):mn(n)}var kn=/\.|\[(?:[^[\]]*|(["'])(?:(?!\1)[^\\]|\\.)*?\1)\]/,nr=/^\w*$/;function N(n,r){if(T(n))return!1;var e=typeof n;return e=="number"||e=="symbol"||e=="boolean"||n==null||B(n)?!0:nr.test(n)||!kn.test(n)||r!=null&&n in Object(r)}var rr=500;function er(n){var r=Mn(n,function(t){return e.size===rr&&e.clear(),t}),e=r.cache;return r}var tr=/[^.[\]]+|\[(?:(-?\d+(?:\.\d+)?)|(["'])((?:(?!\2)[^\\]|\\.)*?)\2)\]|(?=(?:\.|\[\])(?:\.|\[\]|$))/g,ir=/\\(\\)?/g,fr=er(function(n){var r=[];return n.charCodeAt(0)===46&&r.push(""),n.replace(tr,function(e,t,f,i){r.push(f?i.replace(ir,"$1"):t||e)}),r});function ar(n){return n==null?"":dn(n)}function An(n,r){return T(n)?n:N(n,r)?[n]:fr(ar(n))}function m(n){if(typeof n=="string"||B(n))return n;var r=n+"";return r=="0"&&1/n==-1/0?"-0":r}function yn(n,r){r=An(r,n);for(var e=0,t=r.length;n!=null&&e<t;)n=n[m(r[e++])];return e&&e==t?n:void 0}function sr(n,r,e){var t=n==null?void 0:yn(n,r);return t===void 0?e:t}function K(n,r){for(var e=-1,t=r.length,f=n.length;++e<t;)n[f+e]=r[e];return n}var W=w?w.isConcatSpreadable:void 0;function ur(n){return T(n)||un(n)||!!(W&&n&&n[W])}function Ot(n,r,e,t,f){var i=-1,a=n.length;for(e||(e=ur),f||(f=[]);++i<a;){var s=n[i];e(s)?K(f,s):t||(f[f.length]=s)}return f}function or(n,r,e,t){var f=-1,i=n==null?0:n.length;for(t&&i&&(e=n[++f]);++f<i;)e=r(e,n[f],f,n);return e}function gr(n,r){return n&&x(r,$(r),n)}function lr(n,r){return n&&x(r,U(r),n)}function Tn(n,r){for(var e=-1,t=n==null?0:n.length,f=0,i=[];++e<t;){var a=n[e];r(a,e,n)&&(i[f++]=a)}return i}function hn(){return[]}var cr=Object.prototype,br=cr.propertyIsEnumerable,z=Object.getOwnPropertySymbols,j=z?function(n){return n==null?[]:(n=Object(n),Tn(z(n),function(r){return br.call(n,r)}))}:hn;function dr(n,r){return x(n,j(n),r)}var pr=Object.getOwnPropertySymbols,wn=pr?function(n){for(var r=[];n;)K(r,j(n)),n=Cn(n);return r}:hn;function Ar(n,r){return x(n,wn(n),r)}function On(n,r,e){var t=r(n);return T(n)?t:K(t,e(n))}function G(n){return On(n,$,j)}function yr(n){return On(n,U,wn)}var Tr=Object.prototype,hr=Tr.hasOwnProperty;function wr(n){var r=n.length,e=new n.constructor(r);return r&&typeof n[0]=="string"&&hr.call(n,"index")&&(e.index=n.index,e.input=n.input),e}function Or(n,r){var e=r?on(n.buffer):n.buffer;return new n.constructor(e,n.byteOffset,n.byteLength)}var $r=/\w*$/;function _r(n){var r=new n.constructor(n.source,$r.exec(n));return r.lastIndex=n.lastIndex,r}var V=w?w.prototype:void 0,k=V?V.valueOf:void 0;function Sr(n){return k?Object(k.call(n)):{}}var Er="[object Boolean]",Ir="[object Date]",Pr="[object Map]",vr="[object Number]",Lr="[object RegExp]",Rr="[object Set]",xr="[object String]",mr="[object Symbol]",Mr="[object ArrayBuffer]",Cr="[object DataView]",Fr="[object Float32Array]",Dr="[object Float64Array]",Gr="[object Int8Array]",Ur="[object Int16Array]",Br="[object Int32Array]",Nr="[object Uint8Array]",Kr="[object Uint8ClampedArray]",jr="[object Uint16Array]",Hr="[object Uint32Array]";function qr(n,r,e){var t=n.constructor;switch(r){case Mr:return on(n);case Er:case Ir:return new t(+n);case Cr:return Or(n,e);case Fr:case Dr:case Gr:case Ur:case Br:case Nr:case Kr:case jr:case Hr:return Fn(n,e);case Pr:return new t;case vr:case xr:return new t(n);case Lr:return _r(n);case Rr:return new t;case mr:return Sr(n)}}var Yr="[object Map]";function Zr(n){return S(n)&&E(n)==Yr}var nn=R&&R.isMap,Xr=nn?gn(nn):Zr,Jr="[object Set]";function Qr(n){return S(n)&&E(n)==Jr}var rn=R&&R.isSet,Wr=rn?gn(rn):Qr,zr=1,Vr=2,kr=4,$n="[object Arguments]",ne="[object Array]",re="[object Boolean]",ee="[object Date]",te="[object Error]",_n="[object Function]",ie="[object GeneratorFunction]",fe="[object Map]",ae="[object Number]",Sn="[object Object]",se="[object RegExp]",ue="[object Set]",oe="[object String]",ge="[object Symbol]",le="[object WeakMap]",ce="[object ArrayBuffer]",be="[object DataView]",de="[object Float32Array]",pe="[object Float64Array]",Ae="[object Int8Array]",ye="[object Int16Array]",Te="[object Int32Array]",he="[object Uint8Array]",we="[object Uint8ClampedArray]",Oe="[object Uint16Array]",$e="[object Uint32Array]",g={};g[$n]=g[ne]=g[ce]=g[be]=g[re]=g[ee]=g[de]=g[pe]=g[Ae]=g[ye]=g[Te]=g[fe]=g[ae]=g[Sn]=g[se]=g[ue]=g[oe]=g[ge]=g[he]=g[we]=g[Oe]=g[$e]=!0;g[te]=g[_n]=g[le]=!1;function C(n,r,e,t,f,i){var a,s=r&zr,u=r&Vr,b=r&kr;if(a!==void 0)return a;if(!ln(n))return n;var l=T(n);if(l){if(a=wr(n),!s)return Dn(n,a)}else{var o=E(n),c=o==_n||o==ie;if(D(n))return Gn(n,s);if(o==Sn||o==$n||c&&!f){if(a=u||c?{}:Un(n),!s)return u?Ar(n,lr(a,n)):dr(n,gr(a,n))}else{if(!g[o])return f?n:{};a=qr(n,o,s)}}i||(i=new _);var h=i.get(n);if(h)return h;i.set(n,a),Wr(n)?n.forEach(function(d){a.add(C(d,r,e,d,n,i))}):Xr(n)&&n.forEach(function(d,p){a.set(p,C(d,r,e,p,n,i))});var A=b?u?yr:G:u?U:$,y=l?void 0:A(n);return pn(y||n,function(d,p){y&&(p=d,d=n[p]),Bn(a,p,C(d,r,e,p,n,i))}),a}var _e="__lodash_hash_undefined__";function Se(n){return this.__data__.set(n,_e),this}function Ee(n){return this.__data__.has(n)}function I(n){var r=-1,e=n==null?0:n.length;for(this.__data__=new Nn;++r<e;)this.add(n[r])}I.prototype.add=I.prototype.push=Se;I.prototype.has=Ee;function Ie(n,r){for(var e=-1,t=n==null?0:n.length;++e<t;)if(r(n[e],e,n))return!0;return!1}function En(n,r){return n.has(r)}var Pe=1,ve=2;function In(n,r,e,t,f,i){var a=e&Pe,s=n.length,u=r.length;if(s!=u&&!(a&&u>s))return!1;var b=i.get(n),l=i.get(r);if(b&&l)return b==r&&l==n;var o=-1,c=!0,h=e&ve?new I:void 0;for(i.set(n,r),i.set(r,n);++o<s;){var A=n[o],y=r[o];if(t)var d=a?t(y,A,o,r,n,i):t(A,y,o,n,r,i);if(d!==void 0){if(d)continue;c=!1;break}if(h){if(!Ie(r,function(p,O){if(!En(h,O)&&(A===p||f(A,p,e,t,i)))return h.push(O)})){c=!1;break}}else if(!(A===y||f(A,y,e,t,i))){c=!1;break}}return i.delete(n),i.delete(r),c}function Le(n){var r=-1,e=Array(n.size);return n.forEach(function(t,f){e[++r]=[f,t]}),e}function H(n){var r=-1,e=Array(n.size);return n.forEach(function(t){e[++r]=t}),e}var Re=1,xe=2,me="[object Boolean]",Me="[object Date]",Ce="[object Error]",Fe="[object Map]",De="[object Number]",Ge="[object RegExp]",Ue="[object Set]",Be="[object String]",Ne="[object Symbol]",Ke="[object ArrayBuffer]",je="[object DataView]",en=w?w.prototype:void 0,F=en?en.valueOf:void 0;function He(n,r,e,t,f,i,a){switch(e){case je:if(n.byteLength!=r.byteLength||n.byteOffset!=r.byteOffset)return!1;n=n.buffer,r=r.buffer;case Ke:return!(n.byteLength!=r.byteLength||!i(new X(n),new X(r)));case me:case Me:case De:return Kn(+n,+r);case Ce:return n.name==r.name&&n.message==r.message;case Ge:case Be:return n==r+"";case Fe:var s=Le;case Ue:var u=t&Re;if(s||(s=H),n.size!=r.size&&!u)return!1;var b=a.get(n);if(b)return b==r;t|=xe,a.set(n,r);var l=In(s(n),s(r),t,f,i,a);return a.delete(n),l;case Ne:if(F)return F.call(n)==F.call(r)}return!1}var qe=1,Ye=Object.prototype,Ze=Ye.hasOwnProperty;function Xe(n,r,e,t,f,i){var a=e&qe,s=G(n),u=s.length,b=G(r),l=b.length;if(u!=l&&!a)return!1;for(var o=u;o--;){var c=s[o];if(!(a?c in r:Ze.call(r,c)))return!1}var h=i.get(n),A=i.get(r);if(h&&A)return h==r&&A==n;var y=!0;i.set(n,r),i.set(r,n);for(var d=a;++o<u;){c=s[o];var p=n[c],O=r[c];if(t)var Z=a?t(O,p,c,r,n,i):t(p,O,c,n,r,i);if(!(Z===void 0?p===O||f(p,O,e,t,i):Z)){y=!1;break}d||(d=c=="constructor")}if(y&&!d){var P=n.constructor,v=r.constructor;P!=v&&"constructor"in n&&"constructor"in r&&!(typeof P=="function"&&P instanceof P&&typeof v=="function"&&v instanceof v)&&(y=!1)}return i.delete(n),i.delete(r),y}var Je=1,tn="[object Arguments]",fn="[object Array]",L="[object Object]",Qe=Object.prototype,an=Qe.hasOwnProperty;function We(n,r,e,t,f,i){var a=T(n),s=T(r),u=a?fn:E(n),b=s?fn:E(r);u=u==tn?L:u,b=b==tn?L:b;var l=u==L,o=b==L,c=u==b;if(c&&D(n)){if(!D(r))return!1;a=!0,l=!1}if(c&&!l)return i||(i=new _),a||jn(n)?In(n,r,e,t,f,i):He(n,r,u,e,t,f,i);if(!(e&Je)){var h=l&&an.call(n,"__wrapped__"),A=o&&an.call(r,"__wrapped__");if(h||A){var y=h?n.value():n,d=A?r.value():r;return i||(i=new _),f(y,d,e,t,i)}}return c?(i||(i=new _),Xe(n,r,e,t,f,i)):!1}function q(n,r,e,t,f){return n===r?!0:n==null||r==null||!S(n)&&!S(r)?n!==n&&r!==r:We(n,r,e,t,q,f)}var ze=1,Ve=2;function ke(n,r,e,t){var f=e.length,i=f;if(n==null)return!i;for(n=Object(n);f--;){var a=e[f];if(a[2]?a[1]!==n[a[0]]:!(a[0]in n))return!1}for(;++f<i;){a=e[f];var s=a[0],u=n[s],b=a[1];if(a[2]){if(u===void 0&&!(s in n))return!1}else{var l=new _,o;if(!(o===void 0?q(b,u,ze|Ve,t,l):o))return!1}}return!0}function Pn(n){return n===n&&!ln(n)}function nt(n){for(var r=$(n),e=r.length;e--;){var t=r[e],f=n[t];r[e]=[t,f,Pn(f)]}return r}function vn(n,r){return function(e){return e==null?!1:e[n]===r&&(r!==void 0||n in Object(e))}}function rt(n){var r=nt(n);return r.length==1&&r[0][2]?vn(r[0][0],r[0][1]):function(e){return e===n||ke(e,n,r)}}function et(n,r){return n!=null&&r in Object(n)}function tt(n,r,e){r=An(r,n);for(var t=-1,f=r.length,i=!1;++t<f;){var a=m(r[t]);if(!(i=n!=null&&e(n,a)))break;n=n[a]}return i||++t!=f?i:(f=n==null?0:n.length,!!f&&Hn(f)&&qn(a,f)&&(T(n)||un(n)))}function it(n,r){return n!=null&&tt(n,r,et)}var ft=1,at=2;function st(n,r){return N(n)&&Pn(r)?vn(m(n),r):function(e){var t=sr(e,n);return t===void 0&&t===r?it(e,n):q(r,t,ft|at)}}function ut(n){return function(r){return r?.[n]}}function ot(n){return function(r){return yn(r,n)}}function gt(n){return N(n)?ut(m(n)):ot(n)}function Ln(n){return typeof n=="function"?n:n==null?cn:typeof n=="object"?T(n)?st(n[0],n[1]):rt(n):gt(n)}function lt(n,r){return n&&Yn(n,r,$)}function ct(n,r){return function(e,t){if(e==null)return e;if(!sn(e))return n(e,t);for(var f=e.length,i=-1,a=Object(e);++i<f&&t(a[i],i,a)!==!1;);return e}}var Y=ct(lt);function bt(n){return typeof n=="function"?n:cn}function $t(n,r){var e=T(n)?pn:Y;return e(n,bt(r))}function dt(n,r){var e=[];return Y(n,function(t,f,i){r(t,f,i)&&e.push(t)}),e}function _t(n,r){var e=T(n)?Tn:dt;return e(n,Ln(r))}function pt(n,r){return bn(r,function(e){return n[e]})}function St(n){return n==null?[]:pt(n,$(n))}function Et(n){return n===void 0}function At(n,r,e,t,f){return f(n,function(i,a,s){e=t?(t=!1,i):r(e,i,a,s)}),e}function It(n,r,e){var t=T(n)?or:At,f=arguments.length<3;return t(n,Ln(r),e,f,Y)}var yt=1/0,Tt=M&&1/H(new M([,-0]))[1]==yt?function(n){return new M(n)}:Xn,ht=200;function Pt(n,r,e){var t=-1,f=Vn,i=n.length,a=!0,s=[],u=s;if(i>=ht){var b=r?null:Tt(n);if(b)return H(b);a=!1,f=En,u=new I}else u=r?[]:s;n:for(;++t<i;){var l=n[t],o=r?r(l):l;if(l=l!==0?l:0,a&&o===o){for(var c=u.length;c--;)if(u[c]===o)continue n;r&&u.push(o),s.push(l)}else f(u,o,e)||(u!==s&&u.push(o),s.push(l))}return s}export{Tn as A,dt as B,Ie as C,Xn as D,I as S,Pt as a,C as b,Ot as c,$t as d,B as e,_t as f,Ln as g,Jn as h,Et as i,Y as j,$ as k,bn as l,tt as m,An as n,yn as o,bt as p,lt as q,It as r,it as s,m as t,ar as u,St as v,Vn as w,En as x,zn as y,yr as z};
diff --git a/docs/dist/assets/arc-sXMYVGHN.js b/docs/dist/assets/arc-sXMYVGHN.js
deleted file mode 100644
index f1184487..00000000
--- a/docs/dist/assets/arc-sXMYVGHN.js
+++ /dev/null
@@ -1 +0,0 @@
-import{a0 as ln,a1 as an,a2 as y,a3 as tn,a4 as H,a5 as q,a6 as _,a7 as un,a8 as B,a9 as rn,aa as L,ab as o,ac as sn,ad as on,ae as fn}from"./index-BxX29htg.js";function cn(l){return l.innerRadius}function yn(l){return l.outerRadius}function gn(l){return l.startAngle}function dn(l){return l.endAngle}function mn(l){return l&&l.padAngle}function pn(l,h,I,D,v,A,C,a){var O=I-l,i=D-h,n=C-v,d=a-A,u=d*O-n*i;if(!(u*u<y))return u=(n*(h-A)-d*(l-v))/u,[l+u*O,h+u*i]}function W(l,h,I,D,v,A,C){var a=l-I,O=h-D,i=(C?A:-A)/L(a*a+O*O),n=i*O,d=-i*a,u=l+n,s=h+d,f=I+n,c=D+d,F=(u+f)/2,t=(s+c)/2,m=f-u,g=c-s,R=m*m+g*g,T=v-A,P=u*c-f*s,S=(g<0?-1:1)*L(fn(0,T*T*R-P*P)),j=(P*g-m*S)/R,z=(-P*m-g*S)/R,w=(P*g+m*S)/R,p=(-P*m+g*S)/R,x=j-F,e=z-t,r=w-F,G=p-t;return x*x+e*e>r*r+G*G&&(j=w,z=p),{cx:j,cy:z,x01:-n,y01:-d,x11:j*(v/T-1),y11:z*(v/T-1)}}function hn(){var l=cn,h=yn,I=B(0),D=null,v=gn,A=dn,C=mn,a=null,O=ln(i);function i(){var n,d,u=+l.apply(this,arguments),s=+h.apply(this,arguments),f=v.apply(this,arguments)-an,c=A.apply(this,arguments)-an,F=un(c-f),t=c>f;if(a||(a=n=O()),s<u&&(d=s,s=u,u=d),!(s>y))a.moveTo(0,0);else if(F>tn-y)a.moveTo(s*H(f),s*q(f)),a.arc(0,0,s,f,c,!t),u>y&&(a.moveTo(u*H(c),u*q(c)),a.arc(0,0,u,c,f,t));else{var m=f,g=c,R=f,T=c,P=F,S=F,j=C.apply(this,arguments)/2,z=j>y&&(D?+D.apply(this,arguments):L(u*u+s*s)),w=_(un(s-u)/2,+I.apply(this,arguments)),p=w,x=w,e,r;if(z>y){var G=sn(z/u*q(j)),M=sn(z/s*q(j));(P-=G*2)>y?(G*=t?1:-1,R+=G,T-=G):(P=0,R=T=(f+c)/2),(S-=M*2)>y?(M*=t?1:-1,m+=M,g-=M):(S=0,m=g=(f+c)/2)}var J=s*H(m),K=s*q(m),N=u*H(T),Q=u*q(T);if(w>y){var U=s*H(g),V=s*q(g),X=u*H(R),Y=u*q(R),E;if(F<rn)if(E=pn(J,K,X,Y,U,V,N,Q)){var Z=J-E[0],$=K-E[1],b=U-E[0],k=V-E[1],nn=1/q(on((Z*b+$*k)/(L(Z*Z+$*$)*L(b*b+k*k)))/2),en=L(E[0]*E[0]+E[1]*E[1]);p=_(w,(u-en)/(nn-1)),x=_(w,(s-en)/(nn+1))}else p=x=0}S>y?x>y?(e=W(X,Y,J,K,s,x,t),r=W(U,V,N,Q,s,x,t),a.moveTo(e.cx+e.x01,e.cy+e.y01),x<w?a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,s,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),!t),a.arc(r.cx,r.cy,x,o(r.y11,r.x11),o(r.y01,r.x01),!t))):(a.moveTo(J,K),a.arc(0,0,s,m,g,!t)):a.moveTo(J,K),!(u>y)||!(P>y)?a.lineTo(N,Q):p>y?(e=W(N,Q,U,V,u,-p,t),r=W(J,K,X,Y,u,-p,t),a.lineTo(e.cx+e.x01,e.cy+e.y01),p<w?a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,u,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),t),a.arc(r.cx,r.cy,p,o(r.y11,r.x11),o(r.y01,r.x01),!t))):a.arc(0,0,u,T,R,t)}if(a.closePath(),n)return a=null,n+""||null}return i.centroid=function(){var n=(+l.apply(this,arguments)+ +h.apply(this,arguments))/2,d=(+v.apply(this,arguments)+ +A.apply(this,arguments))/2-rn/2;return[H(d)*n,q(d)*n]},i.innerRadius=function(n){return arguments.length?(l=typeof n=="function"?n:B(+n),i):l},i.outerRadius=function(n){return arguments.length?(h=typeof n=="function"?n:B(+n),i):h},i.cornerRadius=function(n){return arguments.length?(I=typeof n=="function"?n:B(+n),i):I},i.padRadius=function(n){return arguments.length?(D=n==null?null:typeof n=="function"?n:B(+n),i):D},i.startAngle=function(n){return arguments.length?(v=typeof n=="function"?n:B(+n),i):v},i.endAngle=function(n){return arguments.length?(A=typeof n=="function"?n:B(+n),i):A},i.padAngle=function(n){return arguments.length?(C=typeof n=="function"?n:B(+n),i):C},i.context=function(n){return arguments.length?(a=n??null,i):a},i}export{hn as d};
diff --git a/docs/dist/assets/architectureDiagram-VXUJARFQ-BsBPSHs1.js b/docs/dist/assets/architectureDiagram-VXUJARFQ-BsBPSHs1.js
deleted file mode 100644
index 82330541..00000000
--- a/docs/dist/assets/architectureDiagram-VXUJARFQ-BsBPSHs1.js
+++ /dev/null
@@ -1,36 +0,0 @@
-import{aI as Ze,_ as vt,H as ke,V as qe,l as Se,b as Qe,a as Je,p as Ke,q as je,g as _e,s as tr,y as er,D as rr,E as ir,F as ar,c as Ee,ak as me,aJ as pe,i as nr,d as or,x as sr,aK as hr,aL as lr}from"./index-BxX29htg.js";import{p as fr}from"./chunk-4BX2VUAB-BU7cqk0M.js";import{p as cr}from"./treemap-KMMF4GRG-DFERHDZP.js";import{c as Fe}from"./cytoscape.esm-CF_z7lu9.js";import"./_baseUniq-CfjWcJYV.js";import"./_basePickBy-CqMtcO3s.js";import"./clone-BRV0rZiZ.js";var he={exports:{}},le={exports:{}},fe={exports:{}},gr=fe.exports,we;function ur(){return we||(we=1,(function(I,x){(function(P,N){I.exports=N()})(gr,function(){return(function(A){var P={};function N(u){if(P[u])return P[u].exports;var h=P[u]={i:u,l:!1,exports:{}};return A[u].call(h.exports,h,h.exports,N),h.l=!0,h.exports}return N.m=A,N.c=P,N.i=function(u){return u},N.d=function(u,h,a){N.o(u,h)||Object.defineProperty(u,h,{configurable:!1,enumerable:!0,get:a})},N.n=function(u){var h=u&&u.__esModule?(function(){return u.default}):(function(){return u});return N.d(h,"a",h),h},N.o=function(u,h){return Object.prototype.hasOwnProperty.call(u,h)},N.p="",N(N.s=28)})([(function(A,P,N){function u(){}u.QUALITY=1,u.DEFAULT_CREATE_BENDS_AS_NEEDED=!1,u.DEFAULT_INCREMENTAL=!1,u.DEFAULT_ANIMATION_ON_LAYOUT=!0,u.DEFAULT_ANIMATION_DURING_LAYOUT=!1,u.DEFAULT_ANIMATION_PERIOD=50,u.DEFAULT_UNIFORM_LEAF_NODE_SIZES=!1,u.DEFAULT_GRAPH_MARGIN=15,u.NODE_DIMENSIONS_INCLUDE_LABELS=!1,u.SIMPLE_NODE_SIZE=40,u.SIMPLE_NODE_HALF_SIZE=u.SIMPLE_NODE_SIZE/2,u.EMPTY_COMPOUND_NODE_SIZE=40,u.MIN_EDGE_LENGTH=1,u.WORLD_BOUNDARY=1e6,u.INITIAL_WORLD_BOUNDARY=u.WORLD_BOUNDARY/1e3,u.WORLD_CENTER_X=1200,u.WORLD_CENTER_Y=900,A.exports=u}),(function(A,P,N){var u=N(2),h=N(8),a=N(9);function e(l,i,g){u.call(this,g),this.isOverlapingSourceAndTarget=!1,this.vGraphObject=g,this.bendpoints=[],this.source=l,this.target=i}e.prototype=Object.create(u.prototype);for(var r in u)e[r]=u[r];e.prototype.getSource=function(){return this.source},e.prototype.getTarget=function(){return this.target},e.prototype.isInterGraph=function(){return this.isInterGraph},e.prototype.getLength=function(){return this.length},e.prototype.isOverlapingSourceAndTarget=function(){return this.isOverlapingSourceAndTarget},e.prototype.getBendpoints=function(){return this.bendpoints},e.prototype.getLca=function(){return this.lca},e.prototype.getSourceInLca=function(){return this.sourceInLca},e.prototype.getTargetInLca=function(){return this.targetInLca},e.prototype.getOtherEnd=function(l){if(this.source===l)return this.target;if(this.target===l)return this.source;throw"Node is not incident with this edge"},e.prototype.getOtherEndInGraph=function(l,i){for(var g=this.getOtherEnd(l),t=i.getGraphManager().getRoot();;){if(g.getOwner()==i)return g;if(g.getOwner()==t)break;g=g.getOwner().getParent()}return null},e.prototype.updateLength=function(){var l=new Array(4);this.isOverlapingSourceAndTarget=h.getIntersection(this.target.getRect(),this.source.getRect(),l),this.isOverlapingSourceAndTarget||(this.lengthX=l[0]-l[2],this.lengthY=l[1]-l[3],Math.abs(this.lengthX)<1&&(this.lengthX=a.sign(this.lengthX)),Math.abs(this.lengthY)<1&&(this.lengthY=a.sign(this.lengthY)),this.length=Math.sqrt(this.lengthX*this.lengthX+this.lengthY*this.lengthY))},e.prototype.updateLengthSimple=function(){this.lengthX=this.target.getCenterX()-this.source.getCenterX(),this.lengthY=this.target.getCenterY()-this.source.getCenterY(),Math.abs(this.lengthX)<1&&(this.lengthX=a.sign(this.lengthX)),Math.abs(this.lengthY)<1&&(this.lengthY=a.sign(this.lengthY)),this.length=Math.sqrt(this.lengthX*this.lengthX+this.lengthY*this.lengthY)},A.exports=e}),(function(A,P,N){function u(h){this.vGraphObject=h}A.exports=u}),(function(A,P,N){var u=N(2),h=N(10),a=N(13),e=N(0),r=N(16),l=N(5);function i(t,o,s,c){s==null&&c==null&&(c=o),u.call(this,c),t.graphManager!=null&&(t=t.graphManager),this.estimatedSize=h.MIN_VALUE,this.inclusionTreeDepth=h.MAX_VALUE,this.vGraphObject=c,this.edges=[],this.graphManager=t,s!=null&&o!=null?this.rect=new a(o.x,o.y,s.width,s.height):this.rect=new a}i.prototype=Object.create(u.prototype);for(var g in u)i[g]=u[g];i.prototype.getEdges=function(){return this.edges},i.prototype.getChild=function(){return this.child},i.prototype.getOwner=function(){return this.owner},i.prototype.getWidth=function(){return this.rect.width},i.prototype.setWidth=function(t){this.rect.width=t},i.prototype.getHeight=function(){return this.rect.height},i.prototype.setHeight=function(t){this.rect.height=t},i.prototype.getCenterX=function(){return this.rect.x+this.rect.width/2},i.prototype.getCenterY=function(){return this.rect.y+this.rect.height/2},i.prototype.getCenter=function(){return new l(this.rect.x+this.rect.width/2,this.rect.y+this.rect.height/2)},i.prototype.getLocation=function(){return new l(this.rect.x,this.rect.y)},i.prototype.getRect=function(){return this.rect},i.prototype.getDiagonal=function(){return Math.sqrt(this.rect.width*this.rect.width+this.rect.height*this.rect.height)},i.prototype.getHalfTheDiagonal=function(){return Math.sqrt(this.rect.height*this.rect.height+this.rect.width*this.rect.width)/2},i.prototype.setRect=function(t,o){this.rect.x=t.x,this.rect.y=t.y,this.rect.width=o.width,this.rect.height=o.height},i.prototype.setCenter=function(t,o){this.rect.x=t-this.rect.width/2,this.rect.y=o-this.rect.height/2},i.prototype.setLocation=function(t,o){this.rect.x=t,this.rect.y=o},i.prototype.moveBy=function(t,o){this.rect.x+=t,this.rect.y+=o},i.prototype.getEdgeListToNode=function(t){var o=[],s=this;return s.edges.forEach(function(c){if(c.target==t){if(c.source!=s)throw"Incorrect edge source!";o.push(c)}}),o},i.prototype.getEdgesBetween=function(t){var o=[],s=this;return s.edges.forEach(function(c){if(!(c.source==s||c.target==s))throw"Incorrect edge source and/or target";(c.target==t||c.source==t)&&o.push(c)}),o},i.prototype.getNeighborsList=function(){var t=new Set,o=this;return o.edges.forEach(function(s){if(s.source==o)t.add(s.target);else{if(s.target!=o)throw"Incorrect incidency!";t.add(s.source)}}),t},i.prototype.withChildren=function(){var t=new Set,o,s;if(t.add(this),this.child!=null)for(var c=this.child.getNodes(),f=0;f<c.length;f++)o=c[f],s=o.withChildren(),s.forEach(function(T){t.add(T)});return t},i.prototype.getNoOfChildren=function(){var t=0,o;if(this.child==null)t=1;else for(var s=this.child.getNodes(),c=0;c<s.length;c++)o=s[c],t+=o.getNoOfChildren();return t==0&&(t=1),t},i.prototype.getEstimatedSize=function(){if(this.estimatedSize==h.MIN_VALUE)throw"assert failed";return this.estimatedSize},i.prototype.calcEstimatedSize=function(){return this.child==null?this.estimatedSize=(this.rect.width+this.rect.height)/2:(this.estimatedSize=this.child.calcEstimatedSize(),this.rect.width=this.estimatedSize,this.rect.height=this.estimatedSize,this.estimatedSize)},i.prototype.scatter=function(){var t,o,s=-e.INITIAL_WORLD_BOUNDARY,c=e.INITIAL_WORLD_BOUNDARY;t=e.WORLD_CENTER_X+r.nextDouble()*(c-s)+s;var f=-e.INITIAL_WORLD_BOUNDARY,T=e.INITIAL_WORLD_BOUNDARY;o=e.WORLD_CENTER_Y+r.nextDouble()*(T-f)+f,this.rect.x=t,this.rect.y=o},i.prototype.updateBounds=function(){if(this.getChild()==null)throw"assert failed";if(this.getChild().getNodes().length!=0){var t=this.getChild();if(t.updateBounds(!0),this.rect.x=t.getLeft(),this.rect.y=t.getTop(),this.setWidth(t.getRight()-t.getLeft()),this.setHeight(t.getBottom()-t.getTop()),e.NODE_DIMENSIONS_INCLUDE_LABELS){var o=t.getRight()-t.getLeft(),s=t.getBottom()-t.getTop();this.labelWidth&&(this.labelPosHorizontal=="left"?(this.rect.x-=this.labelWidth,this.setWidth(o+this.labelWidth)):this.labelPosHorizontal=="center"&&this.labelWidth>o?(this.rect.x-=(this.labelWidth-o)/2,this.setWidth(this.labelWidth)):this.labelPosHorizontal=="right"&&this.setWidth(o+this.labelWidth)),this.labelHeight&&(this.labelPosVertical=="top"?(this.rect.y-=this.labelHeight,this.setHeight(s+this.labelHeight)):this.labelPosVertical=="center"&&this.labelHeight>s?(this.rect.y-=(this.labelHeight-s)/2,this.setHeight(this.labelHeight)):this.labelPosVertical=="bottom"&&this.setHeight(s+this.labelHeight))}}},i.prototype.getInclusionTreeDepth=function(){if(this.inclusionTreeDepth==h.MAX_VALUE)throw"assert failed";return this.inclusionTreeDepth},i.prototype.transform=function(t){var o=this.rect.x;o>e.WORLD_BOUNDARY?o=e.WORLD_BOUNDARY:o<-e.WORLD_BOUNDARY&&(o=-e.WORLD_BOUNDARY);var s=this.rect.y;s>e.WORLD_BOUNDARY?s=e.WORLD_BOUNDARY:s<-e.WORLD_BOUNDARY&&(s=-e.WORLD_BOUNDARY);var c=new l(o,s),f=t.inverseTransformPoint(c);this.setLocation(f.x,f.y)},i.prototype.getLeft=function(){return this.rect.x},i.prototype.getRight=function(){return this.rect.x+this.rect.width},i.prototype.getTop=function(){return this.rect.y},i.prototype.getBottom=function(){return this.rect.y+this.rect.height},i.prototype.getParent=function(){return this.owner==null?null:this.owner.getParent()},A.exports=i}),(function(A,P,N){var u=N(0);function h(){}for(var a in u)h[a]=u[a];h.MAX_ITERATIONS=2500,h.DEFAULT_EDGE_LENGTH=50,h.DEFAULT_SPRING_STRENGTH=.45,h.DEFAULT_REPULSION_STRENGTH=4500,h.DEFAULT_GRAVITY_STRENGTH=.4,h.DEFAULT_COMPOUND_GRAVITY_STRENGTH=1,h.DEFAULT_GRAVITY_RANGE_FACTOR=3.8,h.DEFAULT_COMPOUND_GRAVITY_RANGE_FACTOR=1.5,h.DEFAULT_USE_SMART_IDEAL_EDGE_LENGTH_CALCULATION=!0,h.DEFAULT_USE_SMART_REPULSION_RANGE_CALCULATION=!0,h.DEFAULT_COOLING_FACTOR_INCREMENTAL=.3,h.COOLING_ADAPTATION_FACTOR=.33,h.ADAPTATION_LOWER_NODE_LIMIT=1e3,h.ADAPTATION_UPPER_NODE_LIMIT=5e3,h.MAX_NODE_DISPLACEMENT_INCREMENTAL=100,h.MAX_NODE_DISPLACEMENT=h.MAX_NODE_DISPLACEMENT_INCREMENTAL*3,h.MIN_REPULSION_DIST=h.DEFAULT_EDGE_LENGTH/10,h.CONVERGENCE_CHECK_PERIOD=100,h.PER_LEVEL_IDEAL_EDGE_LENGTH_FACTOR=.1,h.MIN_EDGE_LENGTH=1,h.GRID_CALCULATION_CHECK_PERIOD=10,A.exports=h}),(function(A,P,N){function u(h,a){h==null&&a==null?(this.x=0,this.y=0):(this.x=h,this.y=a)}u.prototype.getX=function(){return this.x},u.prototype.getY=function(){return this.y},u.prototype.setX=function(h){this.x=h},u.prototype.setY=function(h){this.y=h},u.prototype.getDifference=function(h){return new DimensionD(this.x-h.x,this.y-h.y)},u.prototype.getCopy=function(){return new u(this.x,this.y)},u.prototype.translate=function(h){return this.x+=h.width,this.y+=h.height,this},A.exports=u}),(function(A,P,N){var u=N(2),h=N(10),a=N(0),e=N(7),r=N(3),l=N(1),i=N(13),g=N(12),t=N(11);function o(c,f,T){u.call(this,T),this.estimatedSize=h.MIN_VALUE,this.margin=a.DEFAULT_GRAPH_MARGIN,this.edges=[],this.nodes=[],this.isConnected=!1,this.parent=c,f!=null&&f instanceof e?this.graphManager=f:f!=null&&f instanceof Layout&&(this.graphManager=f.graphManager)}o.prototype=Object.create(u.prototype);for(var s in u)o[s]=u[s];o.prototype.getNodes=function(){return this.nodes},o.prototype.getEdges=function(){return this.edges},o.prototype.getGraphManager=function(){return this.graphManager},o.prototype.getParent=function(){return this.parent},o.prototype.getLeft=function(){return this.left},o.prototype.getRight=function(){return this.right},o.prototype.getTop=function(){return this.top},o.prototype.getBottom=function(){return this.bottom},o.prototype.isConnected=function(){return this.isConnected},o.prototype.add=function(c,f,T){if(f==null&&T==null){var v=c;if(this.graphManager==null)throw"Graph has no graph mgr!";if(this.getNodes().indexOf(v)>-1)throw"Node already in graph!";return v.owner=this,this.getNodes().push(v),v}else{var d=c;if(!(this.getNodes().indexOf(f)>-1&&this.getNodes().indexOf(T)>-1))throw"Source or target not in graph!";if(!(f.owner==T.owner&&f.owner==this))throw"Both owners must be this graph!";return f.owner!=T.owner?null:(d.source=f,d.target=T,d.isInterGraph=!1,this.getEdges().push(d),f.edges.push(d),T!=f&&T.edges.push(d),d)}},o.prototype.remove=function(c){var f=c;if(c instanceof r){if(f==null)throw"Node is null!";if(!(f.owner!=null&&f.owner==this))throw"Owner graph is invalid!";if(this.graphManager==null)throw"Owner graph manager is invalid!";for(var T=f.edges.slice(),v,d=T.length,L=0;L<d;L++)v=T[L],v.isInterGraph?this.graphManager.remove(v):v.source.owner.remove(v);var b=this.nodes.indexOf(f);if(b==-1)throw"Node not in owner node list!";this.nodes.splice(b,1)}else if(c instanceof l){var v=c;if(v==null)throw"Edge is null!";if(!(v.source!=null&&v.target!=null))throw"Source and/or target is null!";if(!(v.source.owner!=null&&v.target.owner!=null&&v.source.owner==this&&v.target.owner==this))throw"Source and/or target owner is invalid!";var C=v.source.edges.indexOf(v),G=v.target.edges.indexOf(v);if(!(C>-1&&G>-1))throw"Source and/or target doesn't know this edge!";v.source.edges.splice(C,1),v.target!=v.source&&v.target.edges.splice(G,1);var b=v.source.owner.getEdges().indexOf(v);if(b==-1)throw"Not in owner's edge list!";v.source.owner.getEdges().splice(b,1)}},o.prototype.updateLeftTop=function(){for(var c=h.MAX_VALUE,f=h.MAX_VALUE,T,v,d,L=this.getNodes(),b=L.length,C=0;C<b;C++){var G=L[C];T=G.getTop(),v=G.getLeft(),c>T&&(c=T),f>v&&(f=v)}return c==h.MAX_VALUE?null:(L[0].getParent().paddingLeft!=null?d=L[0].getParent().paddingLeft:d=this.margin,this.left=f-d,this.top=c-d,new g(this.left,this.top))},o.prototype.updateBounds=function(c){for(var f=h.MAX_VALUE,T=-h.MAX_VALUE,v=h.MAX_VALUE,d=-h.MAX_VALUE,L,b,C,G,k,Y=this.nodes,K=Y.length,O=0;O<K;O++){var it=Y[O];c&&it.child!=null&&it.updateBounds(),L=it.getLeft(),b=it.getRight(),C=it.getTop(),G=it.getBottom(),f>L&&(f=L),T<b&&(T=b),v>C&&(v=C),d<G&&(d=G)}var n=new i(f,v,T-f,d-v);f==h.MAX_VALUE&&(this.left=this.parent.getLeft(),this.right=this.parent.getRight(),this.top=this.parent.getTop(),this.bottom=this.parent.getBottom()),Y[0].getParent().paddingLeft!=null?k=Y[0].getParent().paddingLeft:k=this.margin,this.left=n.x-k,this.right=n.x+n.width+k,this.top=n.y-k,this.bottom=n.y+n.height+k},o.calculateBounds=function(c){for(var f=h.MAX_VALUE,T=-h.MAX_VALUE,v=h.MAX_VALUE,d=-h.MAX_VALUE,L,b,C,G,k=c.length,Y=0;Y<k;Y++){var K=c[Y];L=K.getLeft(),b=K.getRight(),C=K.getTop(),G=K.getBottom(),f>L&&(f=L),T<b&&(T=b),v>C&&(v=C),d<G&&(d=G)}var O=new i(f,v,T-f,d-v);return O},o.prototype.getInclusionTreeDepth=function(){return this==this.graphManager.getRoot()?1:this.parent.getInclusionTreeDepth()},o.prototype.getEstimatedSize=function(){if(this.estimatedSize==h.MIN_VALUE)throw"assert failed";return this.estimatedSize},o.prototype.calcEstimatedSize=function(){for(var c=0,f=this.nodes,T=f.length,v=0;v<T;v++){var d=f[v];c+=d.calcEstimatedSize()}return c==0?this.estimatedSize=a.EMPTY_COMPOUND_NODE_SIZE:this.estimatedSize=c/Math.sqrt(this.nodes.length),this.estimatedSize},o.prototype.updateConnected=function(){var c=this;if(this.nodes.length==0){this.isConnected=!0;return}var f=new t,T=new Set,v=this.nodes[0],d,L,b=v.withChildren();for(b.forEach(function(O){f.push(O),T.add(O)});f.length!==0;){v=f.shift(),d=v.getEdges();for(var C=d.length,G=0;G<C;G++){var k=d[G];if(L=k.getOtherEndInGraph(v,this),L!=null&&!T.has(L)){var Y=L.withChildren();Y.forEach(function(O){f.push(O),T.add(O)})}}}if(this.isConnected=!1,T.size>=this.nodes.length){var K=0;T.forEach(function(O){O.owner==c&&K++}),K==this.nodes.length&&(this.isConnected=!0)}},A.exports=o}),(function(A,P,N){var u,h=N(1);function a(e){u=N(6),this.layout=e,this.graphs=[],this.edges=[]}a.prototype.addRoot=function(){var e=this.layout.newGraph(),r=this.layout.newNode(null),l=this.add(e,r);return this.setRootGraph(l),this.rootGraph},a.prototype.add=function(e,r,l,i,g){if(l==null&&i==null&&g==null){if(e==null)throw"Graph is null!";if(r==null)throw"Parent node is null!";if(this.graphs.indexOf(e)>-1)throw"Graph already in this graph mgr!";if(this.graphs.push(e),e.parent!=null)throw"Already has a parent!";if(r.child!=null)throw"Already has a child!";return e.parent=r,r.child=e,e}else{g=l,i=r,l=e;var t=i.getOwner(),o=g.getOwner();if(!(t!=null&&t.getGraphManager()==this))throw"Source not in this graph mgr!";if(!(o!=null&&o.getGraphManager()==this))throw"Target not in this graph mgr!";if(t==o)return l.isInterGraph=!1,t.add(l,i,g);if(l.isInterGraph=!0,l.source=i,l.target=g,this.edges.indexOf(l)>-1)throw"Edge already in inter-graph edge list!";if(this.edges.push(l),!(l.source!=null&&l.target!=null))throw"Edge source and/or target is null!";if(!(l.source.edges.indexOf(l)==-1&&l.target.edges.indexOf(l)==-1))throw"Edge already in source and/or target incidency list!";return l.source.edges.push(l),l.target.edges.push(l),l}},a.prototype.remove=function(e){if(e instanceof u){var r=e;if(r.getGraphManager()!=this)throw"Graph not in this graph mgr";if(!(r==this.rootGraph||r.parent!=null&&r.parent.graphManager==this))throw"Invalid parent node!";var l=[];l=l.concat(r.getEdges());for(var i,g=l.length,t=0;t<g;t++)i=l[t],r.remove(i);var o=[];o=o.concat(r.getNodes());var s;g=o.length;for(var t=0;t<g;t++)s=o[t],r.remove(s);r==this.rootGraph&&this.setRootGraph(null);var c=this.graphs.indexOf(r);this.graphs.splice(c,1),r.parent=null}else if(e instanceof h){if(i=e,i==null)throw"Edge is null!";if(!i.isInterGraph)throw"Not an inter-graph edge!";if(!(i.source!=null&&i.target!=null))throw"Source and/or target is null!";if(!(i.source.edges.indexOf(i)!=-1&&i.target.edges.indexOf(i)!=-1))throw"Source and/or target doesn't know this edge!";var c=i.source.edges.indexOf(i);if(i.source.edges.splice(c,1),c=i.target.edges.indexOf(i),i.target.edges.splice(c,1),!(i.source.owner!=null&&i.source.owner.getGraphManager()!=null))throw"Edge owner graph or owner graph manager is null!";if(i.source.owner.getGraphManager().edges.indexOf(i)==-1)throw"Not in owner graph manager's edge list!";var c=i.source.owner.getGraphManager().edges.indexOf(i);i.source.owner.getGraphManager().edges.splice(c,1)}},a.prototype.updateBounds=function(){this.rootGraph.updateBounds(!0)},a.prototype.getGraphs=function(){return this.graphs},a.prototype.getAllNodes=function(){if(this.allNodes==null){for(var e=[],r=this.getGraphs(),l=r.length,i=0;i<l;i++)e=e.concat(r[i].getNodes());this.allNodes=e}return this.allNodes},a.prototype.resetAllNodes=function(){this.allNodes=null},a.prototype.resetAllEdges=function(){this.allEdges=null},a.prototype.resetAllNodesToApplyGravitation=function(){this.allNodesToApplyGravitation=null},a.prototype.getAllEdges=function(){if(this.allEdges==null){var e=[],r=this.getGraphs();r.length;for(var l=0;l<r.length;l++)e=e.concat(r[l].getEdges());e=e.concat(this.edges),this.allEdges=e}return this.allEdges},a.prototype.getAllNodesToApplyGravitation=function(){return this.allNodesToApplyGravitation},a.prototype.setAllNodesToApplyGravitation=function(e){if(this.allNodesToApplyGravitation!=null)throw"assert failed";this.allNodesToApplyGravitation=e},a.prototype.getRoot=function(){return this.rootGraph},a.prototype.setRootGraph=function(e){if(e.getGraphManager()!=this)throw"Root not in this graph mgr!";this.rootGraph=e,e.parent==null&&(e.parent=this.layout.newNode("Root node"))},a.prototype.getLayout=function(){return this.layout},a.prototype.isOneAncestorOfOther=function(e,r){if(!(e!=null&&r!=null))throw"assert failed";if(e==r)return!0;var l=e.getOwner(),i;do{if(i=l.getParent(),i==null)break;if(i==r)return!0;if(l=i.getOwner(),l==null)break}while(!0);l=r.getOwner();do{if(i=l.getParent(),i==null)break;if(i==e)return!0;if(l=i.getOwner(),l==null)break}while(!0);return!1},a.prototype.calcLowestCommonAncestors=function(){for(var e,r,l,i,g,t=this.getAllEdges(),o=t.length,s=0;s<o;s++){if(e=t[s],r=e.source,l=e.target,e.lca=null,e.sourceInLca=r,e.targetInLca=l,r==l){e.lca=r.getOwner();continue}for(i=r.getOwner();e.lca==null;){for(e.targetInLca=l,g=l.getOwner();e.lca==null;){if(g==i){e.lca=g;break}if(g==this.rootGraph)break;if(e.lca!=null)throw"assert failed";e.targetInLca=g.getParent(),g=e.targetInLca.getOwner()}if(i==this.rootGraph)break;e.lca==null&&(e.sourceInLca=i.getParent(),i=e.sourceInLca.getOwner())}if(e.lca==null)throw"assert failed"}},a.prototype.calcLowestCommonAncestor=function(e,r){if(e==r)return e.getOwner();var l=e.getOwner();do{if(l==null)break;var i=r.getOwner();do{if(i==null)break;if(i==l)return i;i=i.getParent().getOwner()}while(!0);l=l.getParent().getOwner()}while(!0);return l},a.prototype.calcInclusionTreeDepths=function(e,r){e==null&&r==null&&(e=this.rootGraph,r=1);for(var l,i=e.getNodes(),g=i.length,t=0;t<g;t++)l=i[t],l.inclusionTreeDepth=r,l.child!=null&&this.calcInclusionTreeDepths(l.child,r+1)},a.prototype.includesInvalidEdge=function(){for(var e,r=[],l=this.edges.length,i=0;i<l;i++)e=this.edges[i],this.isOneAncestorOfOther(e.source,e.target)&&r.push(e);for(var i=0;i<r.length;i++)this.remove(r[i]);return!1},A.exports=a}),(function(A,P,N){var u=N(12);function h(){}h.calcSeparationAmount=function(a,e,r,l){if(!a.intersects(e))throw"assert failed";var i=new Array(2);this.decideDirectionsForOverlappingNodes(a,e,i),r[0]=Math.min(a.getRight(),e.getRight())-Math.max(a.x,e.x),r[1]=Math.min(a.getBottom(),e.getBottom())-Math.max(a.y,e.y),a.getX()<=e.getX()&&a.getRight()>=e.getRight()?r[0]+=Math.min(e.getX()-a.getX(),a.getRight()-e.getRight()):e.getX()<=a.getX()&&e.getRight()>=a.getRight()&&(r[0]+=Math.min(a.getX()-e.getX(),e.getRight()-a.getRight())),a.getY()<=e.getY()&&a.getBottom()>=e.getBottom()?r[1]+=Math.min(e.getY()-a.getY(),a.getBottom()-e.getBottom()):e.getY()<=a.getY()&&e.getBottom()>=a.getBottom()&&(r[1]+=Math.min(a.getY()-e.getY(),e.getBottom()-a.getBottom()));var g=Math.abs((e.getCenterY()-a.getCenterY())/(e.getCenterX()-a.getCenterX()));e.getCenterY()===a.getCenterY()&&e.getCenterX()===a.getCenterX()&&(g=1);var t=g*r[0],o=r[1]/g;r[0]<o?o=r[0]:t=r[1],r[0]=-1*i[0]*(o/2+l),r[1]=-1*i[1]*(t/2+l)},h.decideDirectionsForOverlappingNodes=function(a,e,r){a.getCenterX()<e.getCenterX()?r[0]=-1:r[0]=1,a.getCenterY()<e.getCenterY()?r[1]=-1:r[1]=1},h.getIntersection2=function(a,e,r){var l=a.getCenterX(),i=a.getCenterY(),g=e.getCenterX(),t=e.getCenterY();if(a.intersects(e))return r[0]=l,r[1]=i,r[2]=g,r[3]=t,!0;var o=a.getX(),s=a.getY(),c=a.getRight(),f=a.getX(),T=a.getBottom(),v=a.getRight(),d=a.getWidthHalf(),L=a.getHeightHalf(),b=e.getX(),C=e.getY(),G=e.getRight(),k=e.getX(),Y=e.getBottom(),K=e.getRight(),O=e.getWidthHalf(),it=e.getHeightHalf(),n=!1,m=!1;if(l===g){if(i>t)return r[0]=l,r[1]=s,r[2]=g,r[3]=Y,!1;if(i<t)return r[0]=l,r[1]=T,r[2]=g,r[3]=C,!1}else if(i===t){if(l>g)return r[0]=o,r[1]=i,r[2]=G,r[3]=t,!1;if(l<g)return r[0]=c,r[1]=i,r[2]=b,r[3]=t,!1}else{var p=a.height/a.width,E=e.height/e.width,y=(t-i)/(g-l),R=void 0,M=void 0,S=void 0,W=void 0,D=void 0,q=void 0;if(-p===y?l>g?(r[0]=f,r[1]=T,n=!0):(r[0]=c,r[1]=s,n=!0):p===y&&(l>g?(r[0]=o,r[1]=s,n=!0):(r[0]=v,r[1]=T,n=!0)),-E===y?g>l?(r[2]=k,r[3]=Y,m=!0):(r[2]=G,r[3]=C,m=!0):E===y&&(g>l?(r[2]=b,r[3]=C,m=!0):(r[2]=K,r[3]=Y,m=!0)),n&&m)return!1;if(l>g?i>t?(R=this.getCardinalDirection(p,y,4),M=this.getCardinalDirection(E,y,2)):(R=this.getCardinalDirection(-p,y,3),M=this.getCardinalDirection(-E,y,1)):i>t?(R=this.getCardinalDirection(-p,y,1),M=this.getCardinalDirection(-E,y,3)):(R=this.getCardinalDirection(p,y,2),M=this.getCardinalDirection(E,y,4)),!n)switch(R){case 1:W=s,S=l+-L/y,r[0]=S,r[1]=W;break;case 2:S=v,W=i+d*y,r[0]=S,r[1]=W;break;case 3:W=T,S=l+L/y,r[0]=S,r[1]=W;break;case 4:S=f,W=i+-d*y,r[0]=S,r[1]=W;break}if(!m)switch(M){case 1:q=C,D=g+-it/y,r[2]=D,r[3]=q;break;case 2:D=K,q=t+O*y,r[2]=D,r[3]=q;break;case 3:q=Y,D=g+it/y,r[2]=D,r[3]=q;break;case 4:D=k,q=t+-O*y,r[2]=D,r[3]=q;break}}return!1},h.getCardinalDirection=function(a,e,r){return a>e?r:1+r%4},h.getIntersection=function(a,e,r,l){if(l==null)return this.getIntersection2(a,e,r);var i=a.x,g=a.y,t=e.x,o=e.y,s=r.x,c=r.y,f=l.x,T=l.y,v=void 0,d=void 0,L=void 0,b=void 0,C=void 0,G=void 0,k=void 0,Y=void 0,K=void 0;return L=o-g,C=i-t,k=t*g-i*o,b=T-c,G=s-f,Y=f*c-s*T,K=L*G-b*C,K===0?null:(v=(C*Y-G*k)/K,d=(b*k-L*Y)/K,new u(v,d))},h.angleOfVector=function(a,e,r,l){var i=void 0;return a!==r?(i=Math.atan((l-e)/(r-a)),r<a?i+=Math.PI:l<e&&(i+=this.TWO_PI)):l<e?i=this.ONE_AND_HALF_PI:i=this.HALF_PI,i},h.doIntersect=function(a,e,r,l){var i=a.x,g=a.y,t=e.x,o=e.y,s=r.x,c=r.y,f=l.x,T=l.y,v=(t-i)*(T-c)-(f-s)*(o-g);if(v===0)return!1;var d=((T-c)*(f-i)+(s-f)*(T-g))/v,L=((g-o)*(f-i)+(t-i)*(T-g))/v;return 0<d&&d<1&&0<L&&L<1},h.findCircleLineIntersections=function(a,e,r,l,i,g,t){var o=(r-a)*(r-a)+(l-e)*(l-e),s=2*((a-i)*(r-a)+(e-g)*(l-e)),c=(a-i)*(a-i)+(e-g)*(e-g)-t*t,f=s*s-4*o*c;if(f>=0){var T=(-s+Math.sqrt(s*s-4*o*c))/(2*o),v=(-s-Math.sqrt(s*s-4*o*c))/(2*o),d=null;return T>=0&&T<=1?[T]:v>=0&&v<=1?[v]:d}else return null},h.HALF_PI=.5*Math.PI,h.ONE_AND_HALF_PI=1.5*Math.PI,h.TWO_PI=2*Math.PI,h.THREE_PI=3*Math.PI,A.exports=h}),(function(A,P,N){function u(){}u.sign=function(h){return h>0?1:h<0?-1:0},u.floor=function(h){return h<0?Math.ceil(h):Math.floor(h)},u.ceil=function(h){return h<0?Math.floor(h):Math.ceil(h)},A.exports=u}),(function(A,P,N){function u(){}u.MAX_VALUE=2147483647,u.MIN_VALUE=-2147483648,A.exports=u}),(function(A,P,N){var u=(function(){function i(g,t){for(var o=0;o<t.length;o++){var s=t[o];s.enumerable=s.enumerable||!1,s.configurable=!0,"value"in s&&(s.writable=!0),Object.defineProperty(g,s.key,s)}}return function(g,t,o){return t&&i(g.prototype,t),o&&i(g,o),g}})();function h(i,g){if(!(i instanceof g))throw new TypeError("Cannot call a class as a function")}var a=function(g){return{value:g,next:null,prev:null}},e=function(g,t,o,s){return g!==null?g.next=t:s.head=t,o!==null?o.prev=t:s.tail=t,t.prev=g,t.next=o,s.length++,t},r=function(g,t){var o=g.prev,s=g.next;return o!==null?o.next=s:t.head=s,s!==null?s.prev=o:t.tail=o,g.prev=g.next=null,t.length--,g},l=(function(){function i(g){var t=this;h(this,i),this.length=0,this.head=null,this.tail=null,g?.forEach(function(o){return t.push(o)})}return u(i,[{key:"size",value:function(){return this.length}},{key:"insertBefore",value:function(t,o){return e(o.prev,a(t),o,this)}},{key:"insertAfter",value:function(t,o){return e(o,a(t),o.next,this)}},{key:"insertNodeBefore",value:function(t,o){return e(o.prev,t,o,this)}},{key:"insertNodeAfter",value:function(t,o){return e(o,t,o.next,this)}},{key:"push",value:function(t){return e(this.tail,a(t),null,this)}},{key:"unshift",value:function(t){return e(null,a(t),this.head,this)}},{key:"remove",value:function(t){return r(t,this)}},{key:"pop",value:function(){return r(this.tail,this).value}},{key:"popNode",value:function(){return r(this.tail,this)}},{key:"shift",value:function(){return r(this.head,this).value}},{key:"shiftNode",value:function(){return r(this.head,this)}},{key:"get_object_at",value:function(t){if(t<=this.length()){for(var o=1,s=this.head;o<t;)s=s.next,o++;return s.value}}},{key:"set_object_at",value:function(t,o){if(t<=this.length()){for(var s=1,c=this.head;s<t;)c=c.next,s++;c.value=o}}}]),i})();A.exports=l}),(function(A,P,N){function u(h,a,e){this.x=null,this.y=null,h==null&&a==null&&e==null?(this.x=0,this.y=0):typeof h=="number"&&typeof a=="number"&&e==null?(this.x=h,this.y=a):h.constructor.name=="Point"&&a==null&&e==null&&(e=h,this.x=e.x,this.y=e.y)}u.prototype.getX=function(){return this.x},u.prototype.getY=function(){return this.y},u.prototype.getLocation=function(){return new u(this.x,this.y)},u.prototype.setLocation=function(h,a,e){h.constructor.name=="Point"&&a==null&&e==null?(e=h,this.setLocation(e.x,e.y)):typeof h=="number"&&typeof a=="number"&&e==null&&(parseInt(h)==h&&parseInt(a)==a?this.move(h,a):(this.x=Math.floor(h+.5),this.y=Math.floor(a+.5)))},u.prototype.move=function(h,a){this.x=h,this.y=a},u.prototype.translate=function(h,a){this.x+=h,this.y+=a},u.prototype.equals=function(h){if(h.constructor.name=="Point"){var a=h;return this.x==a.x&&this.y==a.y}return this==h},u.prototype.toString=function(){return new u().constructor.name+"[x="+this.x+",y="+this.y+"]"},A.exports=u}),(function(A,P,N){function u(h,a,e,r){this.x=0,this.y=0,this.width=0,this.height=0,h!=null&&a!=null&&e!=null&&r!=null&&(this.x=h,this.y=a,this.width=e,this.height=r)}u.prototype.getX=function(){return this.x},u.prototype.setX=function(h){this.x=h},u.prototype.getY=function(){return this.y},u.prototype.setY=function(h){this.y=h},u.prototype.getWidth=function(){return this.width},u.prototype.setWidth=function(h){this.width=h},u.prototype.getHeight=function(){return this.height},u.prototype.setHeight=function(h){this.height=h},u.prototype.getRight=function(){return this.x+this.width},u.prototype.getBottom=function(){return this.y+this.height},u.prototype.intersects=function(h){return!(this.getRight()<h.x||this.getBottom()<h.y||h.getRight()<this.x||h.getBottom()<this.y)},u.prototype.getCenterX=function(){return this.x+this.width/2},u.prototype.getMinX=function(){return this.getX()},u.prototype.getMaxX=function(){return this.getX()+this.width},u.prototype.getCenterY=function(){return this.y+this.height/2},u.prototype.getMinY=function(){return this.getY()},u.prototype.getMaxY=function(){return this.getY()+this.height},u.prototype.getWidthHalf=function(){return this.width/2},u.prototype.getHeightHalf=function(){return this.height/2},A.exports=u}),(function(A,P,N){var u=typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?function(a){return typeof a}:function(a){return a&&typeof Symbol=="function"&&a.constructor===Symbol&&a!==Symbol.prototype?"symbol":typeof a};function h(){}h.lastID=0,h.createID=function(a){return h.isPrimitive(a)?a:(a.uniqueID!=null||(a.uniqueID=h.getString(),h.lastID++),a.uniqueID)},h.getString=function(a){return a==null&&(a=h.lastID),"Object#"+a},h.isPrimitive=function(a){var e=typeof a>"u"?"undefined":u(a);return a==null||e!="object"&&e!="function"},A.exports=h}),(function(A,P,N){function u(s){if(Array.isArray(s)){for(var c=0,f=Array(s.length);c<s.length;c++)f[c]=s[c];return f}else return Array.from(s)}var h=N(0),a=N(7),e=N(3),r=N(1),l=N(6),i=N(5),g=N(17),t=N(29);function o(s){t.call(this),this.layoutQuality=h.QUALITY,this.createBendsAsNeeded=h.DEFAULT_CREATE_BENDS_AS_NEEDED,this.incremental=h.DEFAULT_INCREMENTAL,this.animationOnLayout=h.DEFAULT_ANIMATION_ON_LAYOUT,this.animationDuringLayout=h.DEFAULT_ANIMATION_DURING_LAYOUT,this.animationPeriod=h.DEFAULT_ANIMATION_PERIOD,this.uniformLeafNodeSizes=h.DEFAULT_UNIFORM_LEAF_NODE_SIZES,this.edgeToDummyNodes=new Map,this.graphManager=new a(this),this.isLayoutFinished=!1,this.isSubLayout=!1,this.isRemoteUse=!1,s!=null&&(this.isRemoteUse=s)}o.RANDOM_SEED=1,o.prototype=Object.create(t.prototype),o.prototype.getGraphManager=function(){return this.graphManager},o.prototype.getAllNodes=function(){return this.graphManager.getAllNodes()},o.prototype.getAllEdges=function(){return this.graphManager.getAllEdges()},o.prototype.getAllNodesToApplyGravitation=function(){return this.graphManager.getAllNodesToApplyGravitation()},o.prototype.newGraphManager=function(){var s=new a(this);return this.graphManager=s,s},o.prototype.newGraph=function(s){return new l(null,this.graphManager,s)},o.prototype.newNode=function(s){return new e(this.graphManager,s)},o.prototype.newEdge=function(s){return new r(null,null,s)},o.prototype.checkLayoutSuccess=function(){return this.graphManager.getRoot()==null||this.graphManager.getRoot().getNodes().length==0||this.graphManager.includesInvalidEdge()},o.prototype.runLayout=function(){this.isLayoutFinished=!1,this.tilingPreLayout&&this.tilingPreLayout(),this.initParameters();var s;return this.checkLayoutSuccess()?s=!1:s=this.layout(),h.ANIMATE==="during"?!1:(s&&(this.isSubLayout||this.doPostLayout()),this.tilingPostLayout&&this.tilingPostLayout(),this.isLayoutFinished=!0,s)},o.prototype.doPostLayout=function(){this.incremental||this.transform(),this.update()},o.prototype.update2=function(){if(this.createBendsAsNeeded&&(this.createBendpointsFromDummyNodes(),this.graphManager.resetAllEdges()),!this.isRemoteUse){for(var s=this.graphManager.getAllEdges(),c=0;c<s.length;c++)s[c];for(var f=this.graphManager.getRoot().getNodes(),c=0;c<f.length;c++)f[c];this.update(this.graphManager.getRoot())}},o.prototype.update=function(s){if(s==null)this.update2();else if(s instanceof e){var c=s;if(c.getChild()!=null)for(var f=c.getChild().getNodes(),T=0;T<f.length;T++)update(f[T]);if(c.vGraphObject!=null){var v=c.vGraphObject;v.update(c)}}else if(s instanceof r){var d=s;if(d.vGraphObject!=null){var L=d.vGraphObject;L.update(d)}}else if(s instanceof l){var b=s;if(b.vGraphObject!=null){var C=b.vGraphObject;C.update(b)}}},o.prototype.initParameters=function(){this.isSubLayout||(this.layoutQuality=h.QUALITY,this.animationDuringLayout=h.DEFAULT_ANIMATION_DURING_LAYOUT,this.animationPeriod=h.DEFAULT_ANIMATION_PERIOD,this.animationOnLayout=h.DEFAULT_ANIMATION_ON_LAYOUT,this.incremental=h.DEFAULT_INCREMENTAL,this.createBendsAsNeeded=h.DEFAULT_CREATE_BENDS_AS_NEEDED,this.uniformLeafNodeSizes=h.DEFAULT_UNIFORM_LEAF_NODE_SIZES),this.animationDuringLayout&&(this.animationOnLayout=!1)},o.prototype.transform=function(s){if(s==null)this.transform(new i(0,0));else{var c=new g,f=this.graphManager.getRoot().updateLeftTop();if(f!=null){c.setWorldOrgX(s.x),c.setWorldOrgY(s.y),c.setDeviceOrgX(f.x),c.setDeviceOrgY(f.y);for(var T=this.getAllNodes(),v,d=0;d<T.length;d++)v=T[d],v.transform(c)}}},o.prototype.positionNodesRandomly=function(s){if(s==null)this.positionNodesRandomly(this.getGraphManager().getRoot()),this.getGraphManager().getRoot().updateBounds(!0);else for(var c,f,T=s.getNodes(),v=0;v<T.length;v++)c=T[v],f=c.getChild(),f==null||f.getNodes().length==0?c.scatter():(this.positionNodesRandomly(f),c.updateBounds())},o.prototype.getFlatForest=function(){for(var s=[],c=!0,f=this.graphManager.getRoot().getNodes(),T=!0,v=0;v<f.length;v++)f[v].getChild()!=null&&(T=!1);if(!T)return s;var d=new Set,L=[],b=new Map,C=[];for(C=C.concat(f);C.length>0&&c;){for(L.push(C[0]);L.length>0&&c;){var G=L[0];L.splice(0,1),d.add(G);for(var k=G.getEdges(),v=0;v<k.length;v++){var Y=k[v].getOtherEnd(G);if(b.get(G)!=Y)if(!d.has(Y))L.push(Y),b.set(Y,G);else{c=!1;break}}}if(!c)s=[];else{var K=[].concat(u(d));s.push(K);for(var v=0;v<K.length;v++){var O=K[v],it=C.indexOf(O);it>-1&&C.splice(it,1)}d=new Set,b=new Map}}return s},o.prototype.createDummyNodesForBendpoints=function(s){for(var c=[],f=s.source,T=this.graphManager.calcLowestCommonAncestor(s.source,s.target),v=0;v<s.bendpoints.length;v++){var d=this.newNode(null);d.setRect(new Point(0,0),new Dimension(1,1)),T.add(d);var L=this.newEdge(null);this.graphManager.add(L,f,d),c.add(d),f=d}var L=this.newEdge(null);return this.graphManager.add(L,f,s.target),this.edgeToDummyNodes.set(s,c),s.isInterGraph()?this.graphManager.remove(s):T.remove(s),c},o.prototype.createBendpointsFromDummyNodes=function(){var s=[];s=s.concat(this.graphManager.getAllEdges()),s=[].concat(u(this.edgeToDummyNodes.keys())).concat(s);for(var c=0;c<s.length;c++){var f=s[c];if(f.bendpoints.length>0){for(var T=this.edgeToDummyNodes.get(f),v=0;v<T.length;v++){var d=T[v],L=new i(d.getCenterX(),d.getCenterY()),b=f.bendpoints.get(v);b.x=L.x,b.y=L.y,d.getOwner().remove(d)}this.graphManager.add(f,f.source,f.target)}}},o.transform=function(s,c,f,T){if(f!=null&&T!=null){var v=c;if(s<=50){var d=c/f;v-=(c-d)/50*(50-s)}else{var L=c*T;v+=(L-c)/50*(s-50)}return v}else{var b,C;return s<=50?(b=9*c/500,C=c/10):(b=9*c/50,C=-8*c),b*s+C}},o.findCenterOfTree=function(s){var c=[];c=c.concat(s);var f=[],T=new Map,v=!1,d=null;(c.length==1||c.length==2)&&(v=!0,d=c[0]);for(var L=0;L<c.length;L++){var b=c[L],C=b.getNeighborsList().size;T.set(b,b.getNeighborsList().size),C==1&&f.push(b)}var G=[];for(G=G.concat(f);!v;){var k=[];k=k.concat(G),G=[];for(var L=0;L<c.length;L++){var b=c[L],Y=c.indexOf(b);Y>=0&&c.splice(Y,1);var K=b.getNeighborsList();K.forEach(function(n){if(f.indexOf(n)<0){var m=T.get(n),p=m-1;p==1&&G.push(n),T.set(n,p)}})}f=f.concat(G),(c.length==1||c.length==2)&&(v=!0,d=c[0])}return d},o.prototype.setGraphManager=function(s){this.graphManager=s},A.exports=o}),(function(A,P,N){function u(){}u.seed=1,u.x=0,u.nextDouble=function(){return u.x=Math.sin(u.seed++)*1e4,u.x-Math.floor(u.x)},A.exports=u}),(function(A,P,N){var u=N(5);function h(a,e){this.lworldOrgX=0,this.lworldOrgY=0,this.ldeviceOrgX=0,this.ldeviceOrgY=0,this.lworldExtX=1,this.lworldExtY=1,this.ldeviceExtX=1,this.ldeviceExtY=1}h.prototype.getWorldOrgX=function(){return this.lworldOrgX},h.prototype.setWorldOrgX=function(a){this.lworldOrgX=a},h.prototype.getWorldOrgY=function(){return this.lworldOrgY},h.prototype.setWorldOrgY=function(a){this.lworldOrgY=a},h.prototype.getWorldExtX=function(){return this.lworldExtX},h.prototype.setWorldExtX=function(a){this.lworldExtX=a},h.prototype.getWorldExtY=function(){return this.lworldExtY},h.prototype.setWorldExtY=function(a){this.lworldExtY=a},h.prototype.getDeviceOrgX=function(){return this.ldeviceOrgX},h.prototype.setDeviceOrgX=function(a){this.ldeviceOrgX=a},h.prototype.getDeviceOrgY=function(){return this.ldeviceOrgY},h.prototype.setDeviceOrgY=function(a){this.ldeviceOrgY=a},h.prototype.getDeviceExtX=function(){return this.ldeviceExtX},h.prototype.setDeviceExtX=function(a){this.ldeviceExtX=a},h.prototype.getDeviceExtY=function(){return this.ldeviceExtY},h.prototype.setDeviceExtY=function(a){this.ldeviceExtY=a},h.prototype.transformX=function(a){var e=0,r=this.lworldExtX;return r!=0&&(e=this.ldeviceOrgX+(a-this.lworldOrgX)*this.ldeviceExtX/r),e},h.prototype.transformY=function(a){var e=0,r=this.lworldExtY;return r!=0&&(e=this.ldeviceOrgY+(a-this.lworldOrgY)*this.ldeviceExtY/r),e},h.prototype.inverseTransformX=function(a){var e=0,r=this.ldeviceExtX;return r!=0&&(e=this.lworldOrgX+(a-this.ldeviceOrgX)*this.lworldExtX/r),e},h.prototype.inverseTransformY=function(a){var e=0,r=this.ldeviceExtY;return r!=0&&(e=this.lworldOrgY+(a-this.ldeviceOrgY)*this.lworldExtY/r),e},h.prototype.inverseTransformPoint=function(a){var e=new u(this.inverseTransformX(a.x),this.inverseTransformY(a.y));return e},A.exports=h}),(function(A,P,N){function u(t){if(Array.isArray(t)){for(var o=0,s=Array(t.length);o<t.length;o++)s[o]=t[o];return s}else return Array.from(t)}var h=N(15),a=N(4),e=N(0),r=N(8),l=N(9);function i(){h.call(this),this.useSmartIdealEdgeLengthCalculation=a.DEFAULT_USE_SMART_IDEAL_EDGE_LENGTH_CALCULATION,this.gravityConstant=a.DEFAULT_GRAVITY_STRENGTH,this.compoundGravityConstant=a.DEFAULT_COMPOUND_GRAVITY_STRENGTH,this.gravityRangeFactor=a.DEFAULT_GRAVITY_RANGE_FACTOR,this.compoundGravityRangeFactor=a.DEFAULT_COMPOUND_GRAVITY_RANGE_FACTOR,this.displacementThresholdPerNode=3*a.DEFAULT_EDGE_LENGTH/100,this.coolingFactor=a.DEFAULT_COOLING_FACTOR_INCREMENTAL,this.initialCoolingFactor=a.DEFAULT_COOLING_FACTOR_INCREMENTAL,this.totalDisplacement=0,this.oldTotalDisplacement=0,this.maxIterations=a.MAX_ITERATIONS}i.prototype=Object.create(h.prototype);for(var g in h)i[g]=h[g];i.prototype.initParameters=function(){h.prototype.initParameters.call(this,arguments),this.totalIterations=0,this.notAnimatedIterations=0,this.useFRGridVariant=a.DEFAULT_USE_SMART_REPULSION_RANGE_CALCULATION,this.grid=[]},i.prototype.calcIdealEdgeLengths=function(){for(var t,o,s,c,f,T,v,d=this.getGraphManager().getAllEdges(),L=0;L<d.length;L++)t=d[L],o=t.idealLength,t.isInterGraph&&(c=t.getSource(),f=t.getTarget(),T=t.getSourceInLca().getEstimatedSize(),v=t.getTargetInLca().getEstimatedSize(),this.useSmartIdealEdgeLengthCalculation&&(t.idealLength+=T+v-2*e.SIMPLE_NODE_SIZE),s=t.getLca().getInclusionTreeDepth(),t.idealLength+=o*a.PER_LEVEL_IDEAL_EDGE_LENGTH_FACTOR*(c.getInclusionTreeDepth()+f.getInclusionTreeDepth()-2*s))},i.prototype.initSpringEmbedder=function(){var t=this.getAllNodes().length;this.incremental?(t>a.ADAPTATION_LOWER_NODE_LIMIT&&(this.coolingFactor=Math.max(this.coolingFactor*a.COOLING_ADAPTATION_FACTOR,this.coolingFactor-(t-a.ADAPTATION_LOWER_NODE_LIMIT)/(a.ADAPTATION_UPPER_NODE_LIMIT-a.ADAPTATION_LOWER_NODE_LIMIT)*this.coolingFactor*(1-a.COOLING_ADAPTATION_FACTOR))),this.maxNodeDisplacement=a.MAX_NODE_DISPLACEMENT_INCREMENTAL):(t>a.ADAPTATION_LOWER_NODE_LIMIT?this.coolingFactor=Math.max(a.COOLING_ADAPTATION_FACTOR,1-(t-a.ADAPTATION_LOWER_NODE_LIMIT)/(a.ADAPTATION_UPPER_NODE_LIMIT-a.ADAPTATION_LOWER_NODE_LIMIT)*(1-a.COOLING_ADAPTATION_FACTOR)):this.coolingFactor=1,this.initialCoolingFactor=this.coolingFactor,this.maxNodeDisplacement=a.MAX_NODE_DISPLACEMENT),this.maxIterations=Math.max(this.getAllNodes().length*5,this.maxIterations),this.displacementThresholdPerNode=3*a.DEFAULT_EDGE_LENGTH/100,this.totalDisplacementThreshold=this.displacementThresholdPerNode*this.getAllNodes().length,this.repulsionRange=this.calcRepulsionRange()},i.prototype.calcSpringForces=function(){for(var t=this.getAllEdges(),o,s=0;s<t.length;s++)o=t[s],this.calcSpringForce(o,o.idealLength)},i.prototype.calcRepulsionForces=function(){var t=arguments.length>0&&arguments[0]!==void 0?arguments[0]:!0,o=arguments.length>1&&arguments[1]!==void 0?arguments[1]:!1,s,c,f,T,v=this.getAllNodes(),d;if(this.useFRGridVariant)for(this.totalIterations%a.GRID_CALCULATION_CHECK_PERIOD==1&&t&&this.updateGrid(),d=new Set,s=0;s<v.length;s++)f=v[s],this.calculateRepulsionForceOfANode(f,d,t,o),d.add(f);else for(s=0;s<v.length;s++)for(f=v[s],c=s+1;c<v.length;c++)T=v[c],f.getOwner()==T.getOwner()&&this.calcRepulsionForce(f,T)},i.prototype.calcGravitationalForces=function(){for(var t,o=this.getAllNodesToApplyGravitation(),s=0;s<o.length;s++)t=o[s],this.calcGravitationalForce(t)},i.prototype.moveNodes=function(){for(var t=this.getAllNodes(),o,s=0;s<t.length;s++)o=t[s],o.move()},i.prototype.calcSpringForce=function(t,o){var s=t.getSource(),c=t.getTarget(),f,T,v,d;if(this.uniformLeafNodeSizes&&s.getChild()==null&&c.getChild()==null)t.updateLengthSimple();else if(t.updateLength(),t.isOverlapingSourceAndTarget)return;f=t.getLength(),f!=0&&(T=t.edgeElasticity*(f-o),v=T*(t.lengthX/f),d=T*(t.lengthY/f),s.springForceX+=v,s.springForceY+=d,c.springForceX-=v,c.springForceY-=d)},i.prototype.calcRepulsionForce=function(t,o){var s=t.getRect(),c=o.getRect(),f=new Array(2),T=new Array(4),v,d,L,b,C,G,k;if(s.intersects(c)){r.calcSeparationAmount(s,c,f,a.DEFAULT_EDGE_LENGTH/2),G=2*f[0],k=2*f[1];var Y=t.noOfChildren*o.noOfChildren/(t.noOfChildren+o.noOfChildren);t.repulsionForceX-=Y*G,t.repulsionForceY-=Y*k,o.repulsionForceX+=Y*G,o.repulsionForceY+=Y*k}else this.uniformLeafNodeSizes&&t.getChild()==null&&o.getChild()==null?(v=c.getCenterX()-s.getCenterX(),d=c.getCenterY()-s.getCenterY()):(r.getIntersection(s,c,T),v=T[2]-T[0],d=T[3]-T[1]),Math.abs(v)<a.MIN_REPULSION_DIST&&(v=l.sign(v)*a.MIN_REPULSION_DIST),Math.abs(d)<a.MIN_REPULSION_DIST&&(d=l.sign(d)*a.MIN_REPULSION_DIST),L=v*v+d*d,b=Math.sqrt(L),C=(t.nodeRepulsion/2+o.nodeRepulsion/2)*t.noOfChildren*o.noOfChildren/L,G=C*v/b,k=C*d/b,t.repulsionForceX-=G,t.repulsionForceY-=k,o.repulsionForceX+=G,o.repulsionForceY+=k},i.prototype.calcGravitationalForce=function(t){var o,s,c,f,T,v,d,L;o=t.getOwner(),s=(o.getRight()+o.getLeft())/2,c=(o.getTop()+o.getBottom())/2,f=t.getCenterX()-s,T=t.getCenterY()-c,v=Math.abs(f)+t.getWidth()/2,d=Math.abs(T)+t.getHeight()/2,t.getOwner()==this.graphManager.getRoot()?(L=o.getEstimatedSize()*this.gravityRangeFactor,(v>L||d>L)&&(t.gravitationForceX=-this.gravityConstant*f,t.gravitationForceY=-this.gravityConstant*T)):(L=o.getEstimatedSize()*this.compoundGravityRangeFactor,(v>L||d>L)&&(t.gravitationForceX=-this.gravityConstant*f*this.compoundGravityConstant,t.gravitationForceY=-this.gravityConstant*T*this.compoundGravityConstant))},i.prototype.isConverged=function(){var t,o=!1;return this.totalIterations>this.maxIterations/3&&(o=Math.abs(this.totalDisplacement-this.oldTotalDisplacement)<2),t=this.totalDisplacement<this.totalDisplacementThreshold,this.oldTotalDisplacement=this.totalDisplacement,t||o},i.prototype.animate=function(){this.animationDuringLayout&&!this.isSubLayout&&(this.notAnimatedIterations==this.animationPeriod?(this.update(),this.notAnimatedIterations=0):this.notAnimatedIterations++)},i.prototype.calcNoOfChildrenForAllNodes=function(){for(var t,o=this.graphManager.getAllNodes(),s=0;s<o.length;s++)t=o[s],t.noOfChildren=t.getNoOfChildren()},i.prototype.calcGrid=function(t){var o=0,s=0;o=parseInt(Math.ceil((t.getRight()-t.getLeft())/this.repulsionRange)),s=parseInt(Math.ceil((t.getBottom()-t.getTop())/this.repulsionRange));for(var c=new Array(o),f=0;f<o;f++)c[f]=new Array(s);for(var f=0;f<o;f++)for(var T=0;T<s;T++)c[f][T]=new Array;return c},i.prototype.addNodeToGrid=function(t,o,s){var c=0,f=0,T=0,v=0;c=parseInt(Math.floor((t.getRect().x-o)/this.repulsionRange)),f=parseInt(Math.floor((t.getRect().width+t.getRect().x-o)/this.repulsionRange)),T=parseInt(Math.floor((t.getRect().y-s)/this.repulsionRange)),v=parseInt(Math.floor((t.getRect().height+t.getRect().y-s)/this.repulsionRange));for(var d=c;d<=f;d++)for(var L=T;L<=v;L++)this.grid[d][L].push(t),t.setGridCoordinates(c,f,T,v)},i.prototype.updateGrid=function(){var t,o,s=this.getAllNodes();for(this.grid=this.calcGrid(this.graphManager.getRoot()),t=0;t<s.length;t++)o=s[t],this.addNodeToGrid(o,this.graphManager.getRoot().getLeft(),this.graphManager.getRoot().getTop())},i.prototype.calculateRepulsionForceOfANode=function(t,o,s,c){if(this.totalIterations%a.GRID_CALCULATION_CHECK_PERIOD==1&&s||c){var f=new Set;t.surrounding=new Array;for(var T,v=this.grid,d=t.startX-1;d<t.finishX+2;d++)for(var L=t.startY-1;L<t.finishY+2;L++)if(!(d<0||L<0||d>=v.length||L>=v[0].length)){for(var b=0;b<v[d][L].length;b++)if(T=v[d][L][b],!(t.getOwner()!=T.getOwner()||t==T)&&!o.has(T)&&!f.has(T)){var C=Math.abs(t.getCenterX()-T.getCenterX())-(t.getWidth()/2+T.getWidth()/2),G=Math.abs(t.getCenterY()-T.getCenterY())-(t.getHeight()/2+T.getHeight()/2);C<=this.repulsionRange&&G<=this.repulsionRange&&f.add(T)}}t.surrounding=[].concat(u(f))}for(d=0;d<t.surrounding.length;d++)this.calcRepulsionForce(t,t.surrounding[d])},i.prototype.calcRepulsionRange=function(){return 0},A.exports=i}),(function(A,P,N){var u=N(1),h=N(4);function a(r,l,i){u.call(this,r,l,i),this.idealLength=h.DEFAULT_EDGE_LENGTH,this.edgeElasticity=h.DEFAULT_SPRING_STRENGTH}a.prototype=Object.create(u.prototype);for(var e in u)a[e]=u[e];A.exports=a}),(function(A,P,N){var u=N(3),h=N(4);function a(r,l,i,g){u.call(this,r,l,i,g),this.nodeRepulsion=h.DEFAULT_REPULSION_STRENGTH,this.springForceX=0,this.springForceY=0,this.repulsionForceX=0,this.repulsionForceY=0,this.gravitationForceX=0,this.gravitationForceY=0,this.displacementX=0,this.displacementY=0,this.startX=0,this.finishX=0,this.startY=0,this.finishY=0,this.surrounding=[]}a.prototype=Object.create(u.prototype);for(var e in u)a[e]=u[e];a.prototype.setGridCoordinates=function(r,l,i,g){this.startX=r,this.finishX=l,this.startY=i,this.finishY=g},A.exports=a}),(function(A,P,N){function u(h,a){this.width=0,this.height=0,h!==null&&a!==null&&(this.height=a,this.width=h)}u.prototype.getWidth=function(){return this.width},u.prototype.setWidth=function(h){this.width=h},u.prototype.getHeight=function(){return this.height},u.prototype.setHeight=function(h){this.height=h},A.exports=u}),(function(A,P,N){var u=N(14);function h(){this.map={},this.keys=[]}h.prototype.put=function(a,e){var r=u.createID(a);this.contains(r)||(this.map[r]=e,this.keys.push(a))},h.prototype.contains=function(a){return u.createID(a),this.map[a]!=null},h.prototype.get=function(a){var e=u.createID(a);return this.map[e]},h.prototype.keySet=function(){return this.keys},A.exports=h}),(function(A,P,N){var u=N(14);function h(){this.set={}}h.prototype.add=function(a){var e=u.createID(a);this.contains(e)||(this.set[e]=a)},h.prototype.remove=function(a){delete this.set[u.createID(a)]},h.prototype.clear=function(){this.set={}},h.prototype.contains=function(a){return this.set[u.createID(a)]==a},h.prototype.isEmpty=function(){return this.size()===0},h.prototype.size=function(){return Object.keys(this.set).length},h.prototype.addAllTo=function(a){for(var e=Object.keys(this.set),r=e.length,l=0;l<r;l++)a.push(this.set[e[l]])},h.prototype.size=function(){return Object.keys(this.set).length},h.prototype.addAll=function(a){for(var e=a.length,r=0;r<e;r++){var l=a[r];this.add(l)}},A.exports=h}),(function(A,P,N){function u(){}u.multMat=function(h,a){for(var e=[],r=0;r<h.length;r++){e[r]=[];for(var l=0;l<a[0].length;l++){e[r][l]=0;for(var i=0;i<h[0].length;i++)e[r][l]+=h[r][i]*a[i][l]}}return e},u.transpose=function(h){for(var a=[],e=0;e<h[0].length;e++){a[e]=[];for(var r=0;r<h.length;r++)a[e][r]=h[r][e]}return a},u.multCons=function(h,a){for(var e=[],r=0;r<h.length;r++)e[r]=h[r]*a;return e},u.minusOp=function(h,a){for(var e=[],r=0;r<h.length;r++)e[r]=h[r]-a[r];return e},u.dotProduct=function(h,a){for(var e=0,r=0;r<h.length;r++)e+=h[r]*a[r];return e},u.mag=function(h){return Math.sqrt(this.dotProduct(h,h))},u.normalize=function(h){for(var a=[],e=this.mag(h),r=0;r<h.length;r++)a[r]=h[r]/e;return a},u.multGamma=function(h){for(var a=[],e=0,r=0;r<h.length;r++)e+=h[r];e*=-1/h.length;for(var l=0;l<h.length;l++)a[l]=e+h[l];return a},u.multL=function(h,a,e){for(var r=[],l=[],i=[],g=0;g<a[0].length;g++){for(var t=0,o=0;o<a.length;o++)t+=-.5*a[o][g]*h[o];l[g]=t}for(var s=0;s<e.length;s++){for(var c=0,f=0;f<e.length;f++)c+=e[s][f]*l[f];i[s]=c}for(var T=0;T<a.length;T++){for(var v=0,d=0;d<a[0].length;d++)v+=a[T][d]*i[d];r[T]=v}return r},A.exports=u}),(function(A,P,N){var u=(function(){function r(l,i){for(var g=0;g<i.length;g++){var t=i[g];t.enumerable=t.enumerable||!1,t.configurable=!0,"value"in t&&(t.writable=!0),Object.defineProperty(l,t.key,t)}}return function(l,i,g){return i&&r(l.prototype,i),g&&r(l,g),l}})();function h(r,l){if(!(r instanceof l))throw new TypeError("Cannot call a class as a function")}var a=N(11),e=(function(){function r(l,i){h(this,r),(i!==null||i!==void 0)&&(this.compareFunction=this._defaultCompareFunction);var g=void 0;l instanceof a?g=l.size():g=l.length,this._quicksort(l,0,g-1)}return u(r,[{key:"_quicksort",value:function(i,g,t){if(g<t){var o=this._partition(i,g,t);this._quicksort(i,g,o),this._quicksort(i,o+1,t)}}},{key:"_partition",value:function(i,g,t){for(var o=this._get(i,g),s=g,c=t;;){for(;this.compareFunction(o,this._get(i,c));)c--;for(;this.compareFunction(this._get(i,s),o);)s++;if(s<c)this._swap(i,s,c),s++,c--;else return c}}},{key:"_get",value:function(i,g){return i instanceof a?i.get_object_at(g):i[g]}},{key:"_set",value:function(i,g,t){i instanceof a?i.set_object_at(g,t):i[g]=t}},{key:"_swap",value:function(i,g,t){var o=this._get(i,g);this._set(i,g,this._get(i,t)),this._set(i,t,o)}},{key:"_defaultCompareFunction",value:function(i,g){return g>i}}]),r})();A.exports=e}),(function(A,P,N){function u(){}u.svd=function(h){this.U=null,this.V=null,this.s=null,this.m=0,this.n=0,this.m=h.length,this.n=h[0].length;var a=Math.min(this.m,this.n);this.s=(function(Tt){for(var Ct=[];Tt-- >0;)Ct.push(0);return Ct})(Math.min(this.m+1,this.n)),this.U=(function(Tt){var Ct=function Bt(bt){if(bt.length==0)return 0;for(var zt=[],St=0;St<bt[0];St++)zt.push(Bt(bt.slice(1)));return zt};return Ct(Tt)})([this.m,a]),this.V=(function(Tt){var Ct=function Bt(bt){if(bt.length==0)return 0;for(var zt=[],St=0;St<bt[0];St++)zt.push(Bt(bt.slice(1)));return zt};return Ct(Tt)})([this.n,this.n]);for(var e=(function(Tt){for(var Ct=[];Tt-- >0;)Ct.push(0);return Ct})(this.n),r=(function(Tt){for(var Ct=[];Tt-- >0;)Ct.push(0);return Ct})(this.m),l=!0,i=Math.min(this.m-1,this.n),g=Math.max(0,Math.min(this.n-2,this.m)),t=0;t<Math.max(i,g);t++){if(t<i){this.s[t]=0;for(var o=t;o<this.m;o++)this.s[t]=u.hypot(this.s[t],h[o][t]);if(this.s[t]!==0){h[t][t]<0&&(this.s[t]=-this.s[t]);for(var s=t;s<this.m;s++)h[s][t]/=this.s[t];h[t][t]+=1}this.s[t]=-this.s[t]}for(var c=t+1;c<this.n;c++){if((function(Tt,Ct){return Tt&&Ct})(t<i,this.s[t]!==0)){for(var f=0,T=t;T<this.m;T++)f+=h[T][t]*h[T][c];f=-f/h[t][t];for(var v=t;v<this.m;v++)h[v][c]+=f*h[v][t]}e[c]=h[t][c]}if((function(Tt,Ct){return Ct})(l,t<i))for(var d=t;d<this.m;d++)this.U[d][t]=h[d][t];if(t<g){e[t]=0;for(var L=t+1;L<this.n;L++)e[t]=u.hypot(e[t],e[L]);if(e[t]!==0){e[t+1]<0&&(e[t]=-e[t]);for(var b=t+1;b<this.n;b++)e[b]/=e[t];e[t+1]+=1}if(e[t]=-e[t],(function(Tt,Ct){return Tt&&Ct})(t+1<this.m,e[t]!==0)){for(var C=t+1;C<this.m;C++)r[C]=0;for(var G=t+1;G<this.n;G++)for(var k=t+1;k<this.m;k++)r[k]+=e[G]*h[k][G];for(var Y=t+1;Y<this.n;Y++)for(var K=-e[Y]/e[t+1],O=t+1;O<this.m;O++)h[O][Y]+=K*r[O]}for(var it=t+1;it<this.n;it++)this.V[it][t]=e[it]}}var n=Math.min(this.n,this.m+1);i<this.n&&(this.s[i]=h[i][i]),this.m<n&&(this.s[n-1]=0),g+1<n&&(e[g]=h[g][n-1]),e[n-1]=0;{for(var m=i;m<a;m++){for(var p=0;p<this.m;p++)this.U[p][m]=0;this.U[m][m]=1}for(var E=i-1;E>=0;E--)if(this.s[E]!==0){for(var y=E+1;y<a;y++){for(var R=0,M=E;M<this.m;M++)R+=this.U[M][E]*this.U[M][y];R=-R/this.U[E][E];for(var S=E;S<this.m;S++)this.U[S][y]+=R*this.U[S][E]}for(var W=E;W<this.m;W++)this.U[W][E]=-this.U[W][E];this.U[E][E]=1+this.U[E][E];for(var D=0;D<E-1;D++)this.U[D][E]=0}else{for(var q=0;q<this.m;q++)this.U[q][E]=0;this.U[E][E]=1}}for(var V=this.n-1;V>=0;V--){if((function(Tt,Ct){return Tt&&Ct})(V<g,e[V]!==0))for(var X=V+1;X<a;X++){for(var et=0,z=V+1;z<this.n;z++)et+=this.V[z][V]*this.V[z][X];et=-et/this.V[V+1][V];for(var w=V+1;w<this.n;w++)this.V[w][X]+=et*this.V[w][V]}for(var H=0;H<this.n;H++)this.V[H][V]=0;this.V[V][V]=1}for(var B=n-1,_=Math.pow(2,-52),ht=Math.pow(2,-966);n>0;){var Q=void 0,It=void 0;for(Q=n-2;Q>=-1&&Q!==-1;Q--)if(Math.abs(e[Q])<=ht+_*(Math.abs(this.s[Q])+Math.abs(this.s[Q+1]))){e[Q]=0;break}if(Q===n-2)It=4;else{var Nt=void 0;for(Nt=n-1;Nt>=Q&&Nt!==Q;Nt--){var dt=(Nt!==n?Math.abs(e[Nt]):0)+(Nt!==Q+1?Math.abs(e[Nt-1]):0);if(Math.abs(this.s[Nt])<=ht+_*dt){this.s[Nt]=0;break}}Nt===Q?It=3:Nt===n-1?It=1:(It=2,Q=Nt)}switch(Q++,It){case 1:{var rt=e[n-2];e[n-2]=0;for(var gt=n-2;gt>=Q;gt--){var mt=u.hypot(this.s[gt],rt),At=this.s[gt]/mt,Ot=rt/mt;this.s[gt]=mt,gt!==Q&&(rt=-Ot*e[gt-1],e[gt-1]=At*e[gt-1]);for(var Et=0;Et<this.n;Et++)mt=At*this.V[Et][gt]+Ot*this.V[Et][n-1],this.V[Et][n-1]=-Ot*this.V[Et][gt]+At*this.V[Et][n-1],this.V[Et][gt]=mt}}break;case 2:{var Dt=e[Q-1];e[Q-1]=0;for(var Rt=Q;Rt<n;Rt++){var Ht=u.hypot(this.s[Rt],Dt),Ut=this.s[Rt]/Ht,Pt=Dt/Ht;this.s[Rt]=Ht,Dt=-Pt*e[Rt],e[Rt]=Ut*e[Rt];for(var Ft=0;Ft<this.m;Ft++)Ht=Ut*this.U[Ft][Rt]+Pt*this.U[Ft][Q-1],this.U[Ft][Q-1]=-Pt*this.U[Ft][Rt]+Ut*this.U[Ft][Q-1],this.U[Ft][Rt]=Ht}}break;case 3:{var Yt=Math.max(Math.max(Math.max(Math.max(Math.abs(this.s[n-1]),Math.abs(this.s[n-2])),Math.abs(e[n-2])),Math.abs(this.s[Q])),Math.abs(e[Q])),Vt=this.s[n-1]/Yt,F=this.s[n-2]/Yt,U=e[n-2]/Yt,$=this.s[Q]/Yt,J=e[Q]/Yt,Z=((F+Vt)*(F-Vt)+U*U)/2,at=Vt*U*(Vt*U),ct=0;(function(Tt,Ct){return Tt||Ct})(Z!==0,at!==0)&&(ct=Math.sqrt(Z*Z+at),Z<0&&(ct=-ct),ct=at/(Z+ct));for(var nt=($+Vt)*($-Vt)+ct,tt=$*J,j=Q;j<n-1;j++){var ut=u.hypot(nt,tt),Mt=nt/ut,pt=tt/ut;j!==Q&&(e[j-1]=ut),nt=Mt*this.s[j]+pt*e[j],e[j]=Mt*e[j]-pt*this.s[j],tt=pt*this.s[j+1],this.s[j+1]=Mt*this.s[j+1];for(var xt=0;xt<this.n;xt++)ut=Mt*this.V[xt][j]+pt*this.V[xt][j+1],this.V[xt][j+1]=-pt*this.V[xt][j]+Mt*this.V[xt][j+1],this.V[xt][j]=ut;if(ut=u.hypot(nt,tt),Mt=nt/ut,pt=tt/ut,this.s[j]=ut,nt=Mt*e[j]+pt*this.s[j+1],this.s[j+1]=-pt*e[j]+Mt*this.s[j+1],tt=pt*e[j+1],e[j+1]=Mt*e[j+1],j<this.m-1)for(var lt=0;lt<this.m;lt++)ut=Mt*this.U[lt][j]+pt*this.U[lt][j+1],this.U[lt][j+1]=-pt*this.U[lt][j]+Mt*this.U[lt][j+1],this.U[lt][j]=ut}e[n-2]=nt}break;case 4:{if(this.s[Q]<=0){this.s[Q]=this.s[Q]<0?-this.s[Q]:0;for(var ot=0;ot<=B;ot++)this.V[ot][Q]=-this.V[ot][Q]}for(;Q<B&&!(this.s[Q]>=this.s[Q+1]);){var Lt=this.s[Q];if(this.s[Q]=this.s[Q+1],this.s[Q+1]=Lt,Q<this.n-1)for(var ft=0;ft<this.n;ft++)Lt=this.V[ft][Q+1],this.V[ft][Q+1]=this.V[ft][Q],this.V[ft][Q]=Lt;if(Q<this.m-1)for(var st=0;st<this.m;st++)Lt=this.U[st][Q+1],this.U[st][Q+1]=this.U[st][Q],this.U[st][Q]=Lt;Q++}n--}break}}var Xt={U:this.U,V:this.V,S:this.s};return Xt},u.hypot=function(h,a){var e=void 0;return Math.abs(h)>Math.abs(a)?(e=a/h,e=Math.abs(h)*Math.sqrt(1+e*e)):a!=0?(e=h/a,e=Math.abs(a)*Math.sqrt(1+e*e)):e=0,e},A.exports=u}),(function(A,P,N){var u=(function(){function e(r,l){for(var i=0;i<l.length;i++){var g=l[i];g.enumerable=g.enumerable||!1,g.configurable=!0,"value"in g&&(g.writable=!0),Object.defineProperty(r,g.key,g)}}return function(r,l,i){return l&&e(r.prototype,l),i&&e(r,i),r}})();function h(e,r){if(!(e instanceof r))throw new TypeError("Cannot call a class as a function")}var a=(function(){function e(r,l){var i=arguments.length>2&&arguments[2]!==void 0?arguments[2]:1,g=arguments.length>3&&arguments[3]!==void 0?arguments[3]:-1,t=arguments.length>4&&arguments[4]!==void 0?arguments[4]:-1;h(this,e),this.sequence1=r,this.sequence2=l,this.match_score=i,this.mismatch_penalty=g,this.gap_penalty=t,this.iMax=r.length+1,this.jMax=l.length+1,this.grid=new Array(this.iMax);for(var o=0;o<this.iMax;o++){this.grid[o]=new Array(this.jMax);for(var s=0;s<this.jMax;s++)this.grid[o][s]=0}this.tracebackGrid=new Array(this.iMax);for(var c=0;c<this.iMax;c++){this.tracebackGrid[c]=new Array(this.jMax);for(var f=0;f<this.jMax;f++)this.tracebackGrid[c][f]=[null,null,null]}this.alignments=[],this.score=-1,this.computeGrids()}return u(e,[{key:"getScore",value:function(){return this.score}},{key:"getAlignments",value:function(){return this.alignments}},{key:"computeGrids",value:function(){for(var l=1;l<this.jMax;l++)this.grid[0][l]=this.grid[0][l-1]+this.gap_penalty,this.tracebackGrid[0][l]=[!1,!1,!0];for(var i=1;i<this.iMax;i++)this.grid[i][0]=this.grid[i-1][0]+this.gap_penalty,this.tracebackGrid[i][0]=[!1,!0,!1];for(var g=1;g<this.iMax;g++)for(var t=1;t<this.jMax;t++){var o=void 0;this.sequence1[g-1]===this.sequence2[t-1]?o=this.grid[g-1][t-1]+this.match_score:o=this.grid[g-1][t-1]+this.mismatch_penalty;var s=this.grid[g-1][t]+this.gap_penalty,c=this.grid[g][t-1]+this.gap_penalty,f=[o,s,c],T=this.arrayAllMaxIndexes(f);this.grid[g][t]=f[T[0]],this.tracebackGrid[g][t]=[T.includes(0),T.includes(1),T.includes(2)]}this.score=this.grid[this.iMax-1][this.jMax-1]}},{key:"alignmentTraceback",value:function(){var l=[];for(l.push({pos:[this.sequence1.length,this.sequence2.length],seq1:"",seq2:""});l[0];){var i=l[0],g=this.tracebackGrid[i.pos[0]][i.pos[1]];g[0]&&l.push({pos:[i.pos[0]-1,i.pos[1]-1],seq1:this.sequence1[i.pos[0]-1]+i.seq1,seq2:this.sequence2[i.pos[1]-1]+i.seq2}),g[1]&&l.push({pos:[i.pos[0]-1,i.pos[1]],seq1:this.sequence1[i.pos[0]-1]+i.seq1,seq2:"-"+i.seq2}),g[2]&&l.push({pos:[i.pos[0],i.pos[1]-1],seq1:"-"+i.seq1,seq2:this.sequence2[i.pos[1]-1]+i.seq2}),i.pos[0]===0&&i.pos[1]===0&&this.alignments.push({sequence1:i.seq1,sequence2:i.seq2}),l.shift()}return this.alignments}},{key:"getAllIndexes",value:function(l,i){for(var g=[],t=-1;(t=l.indexOf(i,t+1))!==-1;)g.push(t);return g}},{key:"arrayAllMaxIndexes",value:function(l){return this.getAllIndexes(l,Math.max.apply(null,l))}}]),e})();A.exports=a}),(function(A,P,N){var u=function(){};u.FDLayout=N(18),u.FDLayoutConstants=N(4),u.FDLayoutEdge=N(19),u.FDLayoutNode=N(20),u.DimensionD=N(21),u.HashMap=N(22),u.HashSet=N(23),u.IGeometry=N(8),u.IMath=N(9),u.Integer=N(10),u.Point=N(12),u.PointD=N(5),u.RandomSeed=N(16),u.RectangleD=N(13),u.Transform=N(17),u.UniqueIDGeneretor=N(14),u.Quicksort=N(25),u.LinkedList=N(11),u.LGraphObject=N(2),u.LGraph=N(6),u.LEdge=N(1),u.LGraphManager=N(7),u.LNode=N(3),u.Layout=N(15),u.LayoutConstants=N(0),u.NeedlemanWunsch=N(27),u.Matrix=N(24),u.SVD=N(26),A.exports=u}),(function(A,P,N){function u(){this.listeners=[]}var h=u.prototype;h.addListener=function(a,e){this.listeners.push({event:a,callback:e})},h.removeListener=function(a,e){for(var r=this.listeners.length;r>=0;r--){var l=this.listeners[r];l.event===a&&l.callback===e&&this.listeners.splice(r,1)}},h.emit=function(a,e){for(var r=0;r<this.listeners.length;r++){var l=this.listeners[r];a===l.event&&l.callback(e)}},A.exports=u})])})})(fe)),fe.exports}var vr=le.exports,Oe;function dr(){return Oe||(Oe=1,(function(I,x){(function(P,N){I.exports=N(ur())})(vr,function(A){return(()=>{var P={45:((a,e,r)=>{var l={};l.layoutBase=r(551),l.CoSEConstants=r(806),l.CoSEEdge=r(767),l.CoSEGraph=r(880),l.CoSEGraphManager=r(578),l.CoSELayout=r(765),l.CoSENode=r(991),l.ConstraintHandler=r(902),a.exports=l}),806:((a,e,r)=>{var l=r(551).FDLayoutConstants;function i(){}for(var g in l)i[g]=l[g];i.DEFAULT_USE_MULTI_LEVEL_SCALING=!1,i.DEFAULT_RADIAL_SEPARATION=l.DEFAULT_EDGE_LENGTH,i.DEFAULT_COMPONENT_SEPERATION=60,i.TILE=!0,i.TILING_PADDING_VERTICAL=10,i.TILING_PADDING_HORIZONTAL=10,i.TRANSFORM_ON_CONSTRAINT_HANDLING=!0,i.ENFORCE_CONSTRAINTS=!0,i.APPLY_LAYOUT=!0,i.RELAX_MOVEMENT_ON_CONSTRAINTS=!0,i.TREE_REDUCTION_ON_INCREMENTAL=!0,i.PURE_INCREMENTAL=i.DEFAULT_INCREMENTAL,a.exports=i}),767:((a,e,r)=>{var l=r(551).FDLayoutEdge;function i(t,o,s){l.call(this,t,o,s)}i.prototype=Object.create(l.prototype);for(var g in l)i[g]=l[g];a.exports=i}),880:((a,e,r)=>{var l=r(551).LGraph;function i(t,o,s){l.call(this,t,o,s)}i.prototype=Object.create(l.prototype);for(var g in l)i[g]=l[g];a.exports=i}),578:((a,e,r)=>{var l=r(551).LGraphManager;function i(t){l.call(this,t)}i.prototype=Object.create(l.prototype);for(var g in l)i[g]=l[g];a.exports=i}),765:((a,e,r)=>{var l=r(551).FDLayout,i=r(578),g=r(880),t=r(991),o=r(767),s=r(806),c=r(902),f=r(551).FDLayoutConstants,T=r(551).LayoutConstants,v=r(551).Point,d=r(551).PointD,L=r(551).DimensionD,b=r(551).Layout,C=r(551).Integer,G=r(551).IGeometry,k=r(551).LGraph,Y=r(551).Transform,K=r(551).LinkedList;function O(){l.call(this),this.toBeTiled={},this.constraints={}}O.prototype=Object.create(l.prototype);for(var it in l)O[it]=l[it];O.prototype.newGraphManager=function(){var n=new i(this);return this.graphManager=n,n},O.prototype.newGraph=function(n){return new g(null,this.graphManager,n)},O.prototype.newNode=function(n){return new t(this.graphManager,n)},O.prototype.newEdge=function(n){return new o(null,null,n)},O.prototype.initParameters=function(){l.prototype.initParameters.call(this,arguments),this.isSubLayout||(s.DEFAULT_EDGE_LENGTH<10?this.idealEdgeLength=10:this.idealEdgeLength=s.DEFAULT_EDGE_LENGTH,this.useSmartIdealEdgeLengthCalculation=s.DEFAULT_USE_SMART_IDEAL_EDGE_LENGTH_CALCULATION,this.gravityConstant=f.DEFAULT_GRAVITY_STRENGTH,this.compoundGravityConstant=f.DEFAULT_COMPOUND_GRAVITY_STRENGTH,this.gravityRangeFactor=f.DEFAULT_GRAVITY_RANGE_FACTOR,this.compoundGravityRangeFactor=f.DEFAULT_COMPOUND_GRAVITY_RANGE_FACTOR,this.prunedNodesAll=[],this.growTreeIterations=0,this.afterGrowthIterations=0,this.isTreeGrowing=!1,this.isGrowthFinished=!1)},O.prototype.initSpringEmbedder=function(){l.prototype.initSpringEmbedder.call(this),this.coolingCycle=0,this.maxCoolingCycle=this.maxIterations/f.CONVERGENCE_CHECK_PERIOD,this.finalTemperature=.04,this.coolingAdjuster=1},O.prototype.layout=function(){var n=T.DEFAULT_CREATE_BENDS_AS_NEEDED;return n&&(this.createBendpoints(),this.graphManager.resetAllEdges()),this.level=0,this.classicLayout()},O.prototype.classicLayout=function(){if(this.nodesWithGravity=this.calculateNodesToApplyGravitationTo(),this.graphManager.setAllNodesToApplyGravitation(this.nodesWithGravity),this.calcNoOfChildrenForAllNodes(),this.graphManager.calcLowestCommonAncestors(),this.graphManager.calcInclusionTreeDepths(),this.graphManager.getRoot().calcEstimatedSize(),this.calcIdealEdgeLengths(),this.incremental){if(s.TREE_REDUCTION_ON_INCREMENTAL){this.reduceTrees(),this.graphManager.resetAllNodesToApplyGravitation();var m=new Set(this.getAllNodes()),p=this.nodesWithGravity.filter(function(R){return m.has(R)});this.graphManager.setAllNodesToApplyGravitation(p)}}else{var n=this.getFlatForest();if(n.length>0)this.positionNodesRadially(n);else{this.reduceTrees(),this.graphManager.resetAllNodesToApplyGravitation();var m=new Set(this.getAllNodes()),p=this.nodesWithGravity.filter(function(E){return m.has(E)});this.graphManager.setAllNodesToApplyGravitation(p),this.positionNodesRandomly()}}return Object.keys(this.constraints).length>0&&(c.handleConstraints(this),this.initConstraintVariables()),this.initSpringEmbedder(),s.APPLY_LAYOUT&&this.runSpringEmbedder(),!0},O.prototype.tick=function(){if(this.totalIterations++,this.totalIterations===this.maxIterations&&!this.isTreeGrowing&&!this.isGrowthFinished)if(this.prunedNodesAll.length>0)this.isTreeGrowing=!0;else return!0;if(this.totalIterations%f.CONVERGENCE_CHECK_PERIOD==0&&!this.isTreeGrowing&&!this.isGrowthFinished){if(this.isConverged())if(this.prunedNodesAll.length>0)this.isTreeGrowing=!0;else return!0;this.coolingCycle++,this.layoutQuality==0?this.coolingAdjuster=this.coolingCycle:this.layoutQuality==1&&(this.coolingAdjuster=this.coolingCycle/3),this.coolingFactor=Math.max(this.initialCoolingFactor-Math.pow(this.coolingCycle,Math.log(100*(this.initialCoolingFactor-this.finalTemperature))/Math.log(this.maxCoolingCycle))/100*this.coolingAdjuster,this.finalTemperature),this.animationPeriod=Math.ceil(this.initialAnimationPeriod*Math.sqrt(this.coolingFactor))}if(this.isTreeGrowing){if(this.growTreeIterations%10==0)if(this.prunedNodesAll.length>0){this.graphManager.updateBounds(),this.updateGrid(),this.growTree(this.prunedNodesAll),this.graphManager.resetAllNodesToApplyGravitation();var n=new Set(this.getAllNodes()),m=this.nodesWithGravity.filter(function(y){return n.has(y)});this.graphManager.setAllNodesToApplyGravitation(m),this.graphManager.updateBounds(),this.updateGrid(),s.PURE_INCREMENTAL?this.coolingFactor=f.DEFAULT_COOLING_FACTOR_INCREMENTAL/2:this.coolingFactor=f.DEFAULT_COOLING_FACTOR_INCREMENTAL}else this.isTreeGrowing=!1,this.isGrowthFinished=!0;this.growTreeIterations++}if(this.isGrowthFinished){if(this.isConverged())return!0;this.afterGrowthIterations%10==0&&(this.graphManager.updateBounds(),this.updateGrid()),s.PURE_INCREMENTAL?this.coolingFactor=f.DEFAULT_COOLING_FACTOR_INCREMENTAL/2*((100-this.afterGrowthIterations)/100):this.coolingFactor=f.DEFAULT_COOLING_FACTOR_INCREMENTAL*((100-this.afterGrowthIterations)/100),this.afterGrowthIterations++}var p=!this.isTreeGrowing&&!this.isGrowthFinished,E=this.growTreeIterations%10==1&&this.isTreeGrowing||this.afterGrowthIterations%10==1&&this.isGrowthFinished;return this.totalDisplacement=0,this.graphManager.updateBounds(),this.calcSpringForces(),this.calcRepulsionForces(p,E),this.calcGravitationalForces(),this.moveNodes(),this.animate(),!1},O.prototype.getPositionsData=function(){for(var n=this.graphManager.getAllNodes(),m={},p=0;p<n.length;p++){var E=n[p].rect,y=n[p].id;m[y]={id:y,x:E.getCenterX(),y:E.getCenterY(),w:E.width,h:E.height}}return m},O.prototype.runSpringEmbedder=function(){this.initialAnimationPeriod=25,this.animationPeriod=this.initialAnimationPeriod;var n=!1;if(f.ANIMATE==="during")this.emit("layoutstarted");else{for(;!n;)n=this.tick();this.graphManager.updateBounds()}},O.prototype.moveNodes=function(){for(var n=this.getAllNodes(),m,p=0;p<n.length;p++)m=n[p],m.calculateDisplacement();Object.keys(this.constraints).length>0&&this.updateDisplacements();for(var p=0;p<n.length;p++)m=n[p],m.move()},O.prototype.initConstraintVariables=function(){var n=this;this.idToNodeMap=new Map,this.fixedNodeSet=new Set;for(var m=this.graphManager.getAllNodes(),p=0;p<m.length;p++){var E=m[p];this.idToNodeMap.set(E.id,E)}var y=function w(H){for(var B=H.getChild().getNodes(),_,ht=0,Q=0;Q<B.length;Q++)_=B[Q],_.getChild()==null?n.fixedNodeSet.has(_.id)&&(ht+=100):ht+=w(_);return ht};if(this.constraints.fixedNodeConstraint){this.constraints.fixedNodeConstraint.forEach(function(B){n.fixedNodeSet.add(B.nodeId)});for(var m=this.graphManager.getAllNodes(),E,p=0;p<m.length;p++)if(E=m[p],E.getChild()!=null){var R=y(E);R>0&&(E.fixedNodeWeight=R)}}if(this.constraints.relativePlacementConstraint){var M=new Map,S=new Map;if(this.dummyToNodeForVerticalAlignment=new Map,this.dummyToNodeForHorizontalAlignment=new Map,this.fixedNodesOnHorizontal=new Set,this.fixedNodesOnVertical=new Set,this.fixedNodeSet.forEach(function(w){n.fixedNodesOnHorizontal.add(w),n.fixedNodesOnVertical.add(w)}),this.constraints.alignmentConstraint){if(this.constraints.alignmentConstraint.vertical)for(var W=this.constraints.alignmentConstraint.vertical,p=0;p<W.length;p++)this.dummyToNodeForVerticalAlignment.set("dummy"+p,[]),W[p].forEach(function(H){M.set(H,"dummy"+p),n.dummyToNodeForVerticalAlignment.get("dummy"+p).push(H),n.fixedNodeSet.has(H)&&n.fixedNodesOnHorizontal.add("dummy"+p)});if(this.constraints.alignmentConstraint.horizontal)for(var D=this.constraints.alignmentConstraint.horizontal,p=0;p<D.length;p++)this.dummyToNodeForHorizontalAlignment.set("dummy"+p,[]),D[p].forEach(function(H){S.set(H,"dummy"+p),n.dummyToNodeForHorizontalAlignment.get("dummy"+p).push(H),n.fixedNodeSet.has(H)&&n.fixedNodesOnVertical.add("dummy"+p)})}if(s.RELAX_MOVEMENT_ON_CONSTRAINTS)this.shuffle=function(w){var H,B,_;for(_=w.length-1;_>=2*w.length/3;_--)H=Math.floor(Math.random()*(_+1)),B=w[_],w[_]=w[H],w[H]=B;return w},this.nodesInRelativeHorizontal=[],this.nodesInRelativeVertical=[],this.nodeToRelativeConstraintMapHorizontal=new Map,this.nodeToRelativeConstraintMapVertical=new Map,this.nodeToTempPositionMapHorizontal=new Map,this.nodeToTempPositionMapVertical=new Map,this.constraints.relativePlacementConstraint.forEach(function(w){if(w.left){var H=M.has(w.left)?M.get(w.left):w.left,B=M.has(w.right)?M.get(w.right):w.right;n.nodesInRelativeHorizontal.includes(H)||(n.nodesInRelativeHorizontal.push(H),n.nodeToRelativeConstraintMapHorizontal.set(H,[]),n.dummyToNodeForVerticalAlignment.has(H)?n.nodeToTempPositionMapHorizontal.set(H,n.idToNodeMap.get(n.dummyToNodeForVerticalAlignment.get(H)[0]).getCenterX()):n.nodeToTempPositionMapHorizontal.set(H,n.idToNodeMap.get(H).getCenterX())),n.nodesInRelativeHorizontal.includes(B)||(n.nodesInRelativeHorizontal.push(B),n.nodeToRelativeConstraintMapHorizontal.set(B,[]),n.dummyToNodeForVerticalAlignment.has(B)?n.nodeToTempPositionMapHorizontal.set(B,n.idToNodeMap.get(n.dummyToNodeForVerticalAlignment.get(B)[0]).getCenterX()):n.nodeToTempPositionMapHorizontal.set(B,n.idToNodeMap.get(B).getCenterX())),n.nodeToRelativeConstraintMapHorizontal.get(H).push({right:B,gap:w.gap}),n.nodeToRelativeConstraintMapHorizontal.get(B).push({left:H,gap:w.gap})}else{var _=S.has(w.top)?S.get(w.top):w.top,ht=S.has(w.bottom)?S.get(w.bottom):w.bottom;n.nodesInRelativeVertical.includes(_)||(n.nodesInRelativeVertical.push(_),n.nodeToRelativeConstraintMapVertical.set(_,[]),n.dummyToNodeForHorizontalAlignment.has(_)?n.nodeToTempPositionMapVertical.set(_,n.idToNodeMap.get(n.dummyToNodeForHorizontalAlignment.get(_)[0]).getCenterY()):n.nodeToTempPositionMapVertical.set(_,n.idToNodeMap.get(_).getCenterY())),n.nodesInRelativeVertical.includes(ht)||(n.nodesInRelativeVertical.push(ht),n.nodeToRelativeConstraintMapVertical.set(ht,[]),n.dummyToNodeForHorizontalAlignment.has(ht)?n.nodeToTempPositionMapVertical.set(ht,n.idToNodeMap.get(n.dummyToNodeForHorizontalAlignment.get(ht)[0]).getCenterY()):n.nodeToTempPositionMapVertical.set(ht,n.idToNodeMap.get(ht).getCenterY())),n.nodeToRelativeConstraintMapVertical.get(_).push({bottom:ht,gap:w.gap}),n.nodeToRelativeConstraintMapVertical.get(ht).push({top:_,gap:w.gap})}});else{var q=new Map,V=new Map;this.constraints.relativePlacementConstraint.forEach(function(w){if(w.left){var H=M.has(w.left)?M.get(w.left):w.left,B=M.has(w.right)?M.get(w.right):w.right;q.has(H)?q.get(H).push(B):q.set(H,[B]),q.has(B)?q.get(B).push(H):q.set(B,[H])}else{var _=S.has(w.top)?S.get(w.top):w.top,ht=S.has(w.bottom)?S.get(w.bottom):w.bottom;V.has(_)?V.get(_).push(ht):V.set(_,[ht]),V.has(ht)?V.get(ht).push(_):V.set(ht,[_])}});var X=function(H,B){var _=[],ht=[],Q=new K,It=new Set,Nt=0;return H.forEach(function(dt,rt){if(!It.has(rt)){_[Nt]=[],ht[Nt]=!1;var gt=rt;for(Q.push(gt),It.add(gt),_[Nt].push(gt);Q.length!=0;){gt=Q.shift(),B.has(gt)&&(ht[Nt]=!0);var mt=H.get(gt);mt.forEach(function(At){It.has(At)||(Q.push(At),It.add(At),_[Nt].push(At))})}Nt++}}),{components:_,isFixed:ht}},et=X(q,n.fixedNodesOnHorizontal);this.componentsOnHorizontal=et.components,this.fixedComponentsOnHorizontal=et.isFixed;var z=X(V,n.fixedNodesOnVertical);this.componentsOnVertical=z.components,this.fixedComponentsOnVertical=z.isFixed}}},O.prototype.updateDisplacements=function(){var n=this;if(this.constraints.fixedNodeConstraint&&this.constraints.fixedNodeConstraint.forEach(function(z){var w=n.idToNodeMap.get(z.nodeId);w.displacementX=0,w.displacementY=0}),this.constraints.alignmentConstraint){if(this.constraints.alignmentConstraint.vertical)for(var m=this.constraints.alignmentConstraint.vertical,p=0;p<m.length;p++){for(var E=0,y=0;y<m[p].length;y++){if(this.fixedNodeSet.has(m[p][y])){E=0;break}E+=this.idToNodeMap.get(m[p][y]).displacementX}for(var R=E/m[p].length,y=0;y<m[p].length;y++)this.idToNodeMap.get(m[p][y]).displacementX=R}if(this.constraints.alignmentConstraint.horizontal)for(var M=this.constraints.alignmentConstraint.horizontal,p=0;p<M.length;p++){for(var S=0,y=0;y<M[p].length;y++){if(this.fixedNodeSet.has(M[p][y])){S=0;break}S+=this.idToNodeMap.get(M[p][y]).displacementY}for(var W=S/M[p].length,y=0;y<M[p].length;y++)this.idToNodeMap.get(M[p][y]).displacementY=W}}if(this.constraints.relativePlacementConstraint)if(s.RELAX_MOVEMENT_ON_CONSTRAINTS)this.totalIterations%10==0&&(this.shuffle(this.nodesInRelativeHorizontal),this.shuffle(this.nodesInRelativeVertical)),this.nodesInRelativeHorizontal.forEach(function(z){if(!n.fixedNodesOnHorizontal.has(z)){var w=0;n.dummyToNodeForVerticalAlignment.has(z)?w=n.idToNodeMap.get(n.dummyToNodeForVerticalAlignment.get(z)[0]).displacementX:w=n.idToNodeMap.get(z).displacementX,n.nodeToRelativeConstraintMapHorizontal.get(z).forEach(function(H){if(H.right){var B=n.nodeToTempPositionMapHorizontal.get(H.right)-n.nodeToTempPositionMapHorizontal.get(z)-w;B<H.gap&&(w-=H.gap-B)}else{var B=n.nodeToTempPositionMapHorizontal.get(z)-n.nodeToTempPositionMapHorizontal.get(H.left)+w;B<H.gap&&(w+=H.gap-B)}}),n.nodeToTempPositionMapHorizontal.set(z,n.nodeToTempPositionMapHorizontal.get(z)+w),n.dummyToNodeForVerticalAlignment.has(z)?n.dummyToNodeForVerticalAlignment.get(z).forEach(function(H){n.idToNodeMap.get(H).displacementX=w}):n.idToNodeMap.get(z).displacementX=w}}),this.nodesInRelativeVertical.forEach(function(z){if(!n.fixedNodesOnHorizontal.has(z)){var w=0;n.dummyToNodeForHorizontalAlignment.has(z)?w=n.idToNodeMap.get(n.dummyToNodeForHorizontalAlignment.get(z)[0]).displacementY:w=n.idToNodeMap.get(z).displacementY,n.nodeToRelativeConstraintMapVertical.get(z).forEach(function(H){if(H.bottom){var B=n.nodeToTempPositionMapVertical.get(H.bottom)-n.nodeToTempPositionMapVertical.get(z)-w;B<H.gap&&(w-=H.gap-B)}else{var B=n.nodeToTempPositionMapVertical.get(z)-n.nodeToTempPositionMapVertical.get(H.top)+w;B<H.gap&&(w+=H.gap-B)}}),n.nodeToTempPositionMapVertical.set(z,n.nodeToTempPositionMapVertical.get(z)+w),n.dummyToNodeForHorizontalAlignment.has(z)?n.dummyToNodeForHorizontalAlignment.get(z).forEach(function(H){n.idToNodeMap.get(H).displacementY=w}):n.idToNodeMap.get(z).displacementY=w}});else{for(var p=0;p<this.componentsOnHorizontal.length;p++){var D=this.componentsOnHorizontal[p];if(this.fixedComponentsOnHorizontal[p])for(var y=0;y<D.length;y++)this.dummyToNodeForVerticalAlignment.has(D[y])?this.dummyToNodeForVerticalAlignment.get(D[y]).forEach(function(H){n.idToNodeMap.get(H).displacementX=0}):this.idToNodeMap.get(D[y]).displacementX=0;else{for(var q=0,V=0,y=0;y<D.length;y++)if(this.dummyToNodeForVerticalAlignment.has(D[y])){var X=this.dummyToNodeForVerticalAlignment.get(D[y]);q+=X.length*this.idToNodeMap.get(X[0]).displacementX,V+=X.length}else q+=this.idToNodeMap.get(D[y]).displacementX,V++;for(var et=q/V,y=0;y<D.length;y++)this.dummyToNodeForVerticalAlignment.has(D[y])?this.dummyToNodeForVerticalAlignment.get(D[y]).forEach(function(H){n.idToNodeMap.get(H).displacementX=et}):this.idToNodeMap.get(D[y]).displacementX=et}}for(var p=0;p<this.componentsOnVertical.length;p++){var D=this.componentsOnVertical[p];if(this.fixedComponentsOnVertical[p])for(var y=0;y<D.length;y++)this.dummyToNodeForHorizontalAlignment.has(D[y])?this.dummyToNodeForHorizontalAlignment.get(D[y]).forEach(function(B){n.idToNodeMap.get(B).displacementY=0}):this.idToNodeMap.get(D[y]).displacementY=0;else{for(var q=0,V=0,y=0;y<D.length;y++)if(this.dummyToNodeForHorizontalAlignment.has(D[y])){var X=this.dummyToNodeForHorizontalAlignment.get(D[y]);q+=X.length*this.idToNodeMap.get(X[0]).displacementY,V+=X.length}else q+=this.idToNodeMap.get(D[y]).displacementY,V++;for(var et=q/V,y=0;y<D.length;y++)this.dummyToNodeForHorizontalAlignment.has(D[y])?this.dummyToNodeForHorizontalAlignment.get(D[y]).forEach(function(Q){n.idToNodeMap.get(Q).displacementY=et}):this.idToNodeMap.get(D[y]).displacementY=et}}}},O.prototype.calculateNodesToApplyGravitationTo=function(){var n=[],m,p=this.graphManager.getGraphs(),E=p.length,y;for(y=0;y<E;y++)m=p[y],m.updateConnected(),m.isConnected||(n=n.concat(m.getNodes()));return n},O.prototype.createBendpoints=function(){var n=[];n=n.concat(this.graphManager.getAllEdges());var m=new Set,p;for(p=0;p<n.length;p++){var E=n[p];if(!m.has(E)){var y=E.getSource(),R=E.getTarget();if(y==R)E.getBendpoints().push(new d),E.getBendpoints().push(new d),this.createDummyNodesForBendpoints(E),m.add(E);else{var M=[];if(M=M.concat(y.getEdgeListToNode(R)),M=M.concat(R.getEdgeListToNode(y)),!m.has(M[0])){if(M.length>1){var S;for(S=0;S<M.length;S++){var W=M[S];W.getBendpoints().push(new d),this.createDummyNodesForBendpoints(W)}}M.forEach(function(D){m.add(D)})}}}if(m.size==n.length)break}},O.prototype.positionNodesRadially=function(n){for(var m=new v(0,0),p=Math.ceil(Math.sqrt(n.length)),E=0,y=0,R=0,M=new d(0,0),S=0;S<n.length;S++){S%p==0&&(R=0,y=E,S!=0&&(y+=s.DEFAULT_COMPONENT_SEPERATION),E=0);var W=n[S],D=b.findCenterOfTree(W);m.x=R,m.y=y,M=O.radialLayout(W,D,m),M.y>E&&(E=Math.floor(M.y)),R=Math.floor(M.x+s.DEFAULT_COMPONENT_SEPERATION)}this.transform(new d(T.WORLD_CENTER_X-M.x/2,T.WORLD_CENTER_Y-M.y/2))},O.radialLayout=function(n,m,p){var E=Math.max(this.maxDiagonalInTree(n),s.DEFAULT_RADIAL_SEPARATION);O.branchRadialLayout(m,null,0,359,0,E);var y=k.calculateBounds(n),R=new Y;R.setDeviceOrgX(y.getMinX()),R.setDeviceOrgY(y.getMinY()),R.setWorldOrgX(p.x),R.setWorldOrgY(p.y);for(var M=0;M<n.length;M++){var S=n[M];S.transform(R)}var W=new d(y.getMaxX(),y.getMaxY());return R.inverseTransformPoint(W)},O.branchRadialLayout=function(n,m,p,E,y,R){var M=(E-p+1)/2;M<0&&(M+=180);var S=(M+p)%360,W=S*G.TWO_PI/360,D=y*Math.cos(W),q=y*Math.sin(W);n.setCenter(D,q);var V=[];V=V.concat(n.getEdges());var X=V.length;m!=null&&X--;for(var et=0,z=V.length,w,H=n.getEdgesBetween(m);H.length>1;){var B=H[0];H.splice(0,1);var _=V.indexOf(B);_>=0&&V.splice(_,1),z--,X--}m!=null?w=(V.indexOf(H[0])+1)%z:w=0;for(var ht=Math.abs(E-p)/X,Q=w;et!=X;Q=++Q%z){var It=V[Q].getOtherEnd(n);if(It!=m){var Nt=(p+et*ht)%360,dt=(Nt+ht)%360;O.branchRadialLayout(It,n,Nt,dt,y+R,R),et++}}},O.maxDiagonalInTree=function(n){for(var m=C.MIN_VALUE,p=0;p<n.length;p++){var E=n[p],y=E.getDiagonal();y>m&&(m=y)}return m},O.prototype.calcRepulsionRange=function(){return 2*(this.level+1)*this.idealEdgeLength},O.prototype.groupZeroDegreeMembers=function(){var n=this,m={};this.memberGroups={},this.idToDummyNode={};for(var p=[],E=this.graphManager.getAllNodes(),y=0;y<E.length;y++){var R=E[y],M=R.getParent();this.getNodeDegreeWithChildren(R)===0&&(M.id==null||!this.getToBeTiled(M))&&p.push(R)}for(var y=0;y<p.length;y++){var R=p[y],S=R.getParent().id;typeof m[S]>"u"&&(m[S]=[]),m[S]=m[S].concat(R)}Object.keys(m).forEach(function(W){if(m[W].length>1){var D="DummyCompound_"+W;n.memberGroups[D]=m[W];var q=m[W][0].getParent(),V=new t(n.graphManager);V.id=D,V.paddingLeft=q.paddingLeft||0,V.paddingRight=q.paddingRight||0,V.paddingBottom=q.paddingBottom||0,V.paddingTop=q.paddingTop||0,n.idToDummyNode[D]=V;var X=n.getGraphManager().add(n.newGraph(),V),et=q.getChild();et.add(V);for(var z=0;z<m[W].length;z++){var w=m[W][z];et.remove(w),X.add(w)}}})},O.prototype.clearCompounds=function(){var n={},m={};this.performDFSOnCompounds();for(var p=0;p<this.compoundOrder.length;p++)m[this.compoundOrder[p].id]=this.compoundOrder[p],n[this.compoundOrder[p].id]=[].concat(this.compoundOrder[p].getChild().getNodes()),this.graphManager.remove(this.compoundOrder[p].getChild()),this.compoundOrder[p].child=null;this.graphManager.resetAllNodes(),this.tileCompoundMembers(n,m)},O.prototype.clearZeroDegreeMembers=function(){var n=this,m=this.tiledZeroDegreePack=[];Object.keys(this.memberGroups).forEach(function(p){var E=n.idToDummyNode[p];if(m[p]=n.tileNodes(n.memberGroups[p],E.paddingLeft+E.paddingRight),E.rect.width=m[p].width,E.rect.height=m[p].height,E.setCenter(m[p].centerX,m[p].centerY),E.labelMarginLeft=0,E.labelMarginTop=0,s.NODE_DIMENSIONS_INCLUDE_LABELS){var y=E.rect.width,R=E.rect.height;E.labelWidth&&(E.labelPosHorizontal=="left"?(E.rect.x-=E.labelWidth,E.setWidth(y+E.labelWidth),E.labelMarginLeft=E.labelWidth):E.labelPosHorizontal=="center"&&E.labelWidth>y?(E.rect.x-=(E.labelWidth-y)/2,E.setWidth(E.labelWidth),E.labelMarginLeft=(E.labelWidth-y)/2):E.labelPosHorizontal=="right"&&E.setWidth(y+E.labelWidth)),E.labelHeight&&(E.labelPosVertical=="top"?(E.rect.y-=E.labelHeight,E.setHeight(R+E.labelHeight),E.labelMarginTop=E.labelHeight):E.labelPosVertical=="center"&&E.labelHeight>R?(E.rect.y-=(E.labelHeight-R)/2,E.setHeight(E.labelHeight),E.labelMarginTop=(E.labelHeight-R)/2):E.labelPosVertical=="bottom"&&E.setHeight(R+E.labelHeight))}})},O.prototype.repopulateCompounds=function(){for(var n=this.compoundOrder.length-1;n>=0;n--){var m=this.compoundOrder[n],p=m.id,E=m.paddingLeft,y=m.paddingTop,R=m.labelMarginLeft,M=m.labelMarginTop;this.adjustLocations(this.tiledMemberPack[p],m.rect.x,m.rect.y,E,y,R,M)}},O.prototype.repopulateZeroDegreeMembers=function(){var n=this,m=this.tiledZeroDegreePack;Object.keys(m).forEach(function(p){var E=n.idToDummyNode[p],y=E.paddingLeft,R=E.paddingTop,M=E.labelMarginLeft,S=E.labelMarginTop;n.adjustLocations(m[p],E.rect.x,E.rect.y,y,R,M,S)})},O.prototype.getToBeTiled=function(n){var m=n.id;if(this.toBeTiled[m]!=null)return this.toBeTiled[m];var p=n.getChild();if(p==null)return this.toBeTiled[m]=!1,!1;for(var E=p.getNodes(),y=0;y<E.length;y++){var R=E[y];if(this.getNodeDegree(R)>0)return this.toBeTiled[m]=!1,!1;if(R.getChild()==null){this.toBeTiled[R.id]=!1;continue}if(!this.getToBeTiled(R))return this.toBeTiled[m]=!1,!1}return this.toBeTiled[m]=!0,!0},O.prototype.getNodeDegree=function(n){n.id;for(var m=n.getEdges(),p=0,E=0;E<m.length;E++){var y=m[E];y.getSource().id!==y.getTarget().id&&(p=p+1)}return p},O.prototype.getNodeDegreeWithChildren=function(n){var m=this.getNodeDegree(n);if(n.getChild()==null)return m;for(var p=n.getChild().getNodes(),E=0;E<p.length;E++){var y=p[E];m+=this.getNodeDegreeWithChildren(y)}return m},O.prototype.performDFSOnCompounds=function(){this.compoundOrder=[],this.fillCompexOrderByDFS(this.graphManager.getRoot().getNodes())},O.prototype.fillCompexOrderByDFS=function(n){for(var m=0;m<n.length;m++){var p=n[m];p.getChild()!=null&&this.fillCompexOrderByDFS(p.getChild().getNodes()),this.getToBeTiled(p)&&this.compoundOrder.push(p)}},O.prototype.adjustLocations=function(n,m,p,E,y,R,M){m+=E+R,p+=y+M;for(var S=m,W=0;W<n.rows.length;W++){var D=n.rows[W];m=S;for(var q=0,V=0;V<D.length;V++){var X=D[V];X.rect.x=m,X.rect.y=p,m+=X.rect.width+n.horizontalPadding,X.rect.height>q&&(q=X.rect.height)}p+=q+n.verticalPadding}},O.prototype.tileCompoundMembers=function(n,m){var p=this;this.tiledMemberPack=[],Object.keys(n).forEach(function(E){var y=m[E];if(p.tiledMemberPack[E]=p.tileNodes(n[E],y.paddingLeft+y.paddingRight),y.rect.width=p.tiledMemberPack[E].width,y.rect.height=p.tiledMemberPack[E].height,y.setCenter(p.tiledMemberPack[E].centerX,p.tiledMemberPack[E].centerY),y.labelMarginLeft=0,y.labelMarginTop=0,s.NODE_DIMENSIONS_INCLUDE_LABELS){var R=y.rect.width,M=y.rect.height;y.labelWidth&&(y.labelPosHorizontal=="left"?(y.rect.x-=y.labelWidth,y.setWidth(R+y.labelWidth),y.labelMarginLeft=y.labelWidth):y.labelPosHorizontal=="center"&&y.labelWidth>R?(y.rect.x-=(y.labelWidth-R)/2,y.setWidth(y.labelWidth),y.labelMarginLeft=(y.labelWidth-R)/2):y.labelPosHorizontal=="right"&&y.setWidth(R+y.labelWidth)),y.labelHeight&&(y.labelPosVertical=="top"?(y.rect.y-=y.labelHeight,y.setHeight(M+y.labelHeight),y.labelMarginTop=y.labelHeight):y.labelPosVertical=="center"&&y.labelHeight>M?(y.rect.y-=(y.labelHeight-M)/2,y.setHeight(y.labelHeight),y.labelMarginTop=(y.labelHeight-M)/2):y.labelPosVertical=="bottom"&&y.setHeight(M+y.labelHeight))}})},O.prototype.tileNodes=function(n,m){var p=this.tileNodesByFavoringDim(n,m,!0),E=this.tileNodesByFavoringDim(n,m,!1),y=this.getOrgRatio(p),R=this.getOrgRatio(E),M;return R<y?M=E:M=p,M},O.prototype.getOrgRatio=function(n){var m=n.width,p=n.height,E=m/p;return E<1&&(E=1/E),E},O.prototype.calcIdealRowWidth=function(n,m){var p=s.TILING_PADDING_VERTICAL,E=s.TILING_PADDING_HORIZONTAL,y=n.length,R=0,M=0,S=0;n.forEach(function(z){R+=z.getWidth(),M+=z.getHeight(),z.getWidth()>S&&(S=z.getWidth())});var W=R/y,D=M/y,q=Math.pow(p-E,2)+4*(W+E)*(D+p)*y,V=(E-p+Math.sqrt(q))/(2*(W+E)),X;m?(X=Math.ceil(V),X==V&&X++):X=Math.floor(V);var et=X*(W+E)-E;return S>et&&(et=S),et+=E*2,et},O.prototype.tileNodesByFavoringDim=function(n,m,p){var E=s.TILING_PADDING_VERTICAL,y=s.TILING_PADDING_HORIZONTAL,R=s.TILING_COMPARE_BY,M={rows:[],rowWidth:[],rowHeight:[],width:0,height:m,verticalPadding:E,horizontalPadding:y,centerX:0,centerY:0};R&&(M.idealRowWidth=this.calcIdealRowWidth(n,p));var S=function(w){return w.rect.width*w.rect.height},W=function(w,H){return S(H)-S(w)};n.sort(function(z,w){var H=W;return M.idealRowWidth?(H=R,H(z.id,w.id)):H(z,w)});for(var D=0,q=0,V=0;V<n.length;V++){var X=n[V];D+=X.getCenterX(),q+=X.getCenterY()}M.centerX=D/n.length,M.centerY=q/n.length;for(var V=0;V<n.length;V++){var X=n[V];if(M.rows.length==0)this.insertNodeToRow(M,X,0,m);else if(this.canAddHorizontal(M,X.rect.width,X.rect.height)){var et=M.rows.length-1;M.idealRowWidth||(et=this.getShortestRowIndex(M)),this.insertNodeToRow(M,X,et,m)}else this.insertNodeToRow(M,X,M.rows.length,m);this.shiftToLastRow(M)}return M},O.prototype.insertNodeToRow=function(n,m,p,E){var y=E;if(p==n.rows.length){var R=[];n.rows.push(R),n.rowWidth.push(y),n.rowHeight.push(0)}var M=n.rowWidth[p]+m.rect.width;n.rows[p].length>0&&(M+=n.horizontalPadding),n.rowWidth[p]=M,n.width<M&&(n.width=M);var S=m.rect.height;p>0&&(S+=n.verticalPadding);var W=0;S>n.rowHeight[p]&&(W=n.rowHeight[p],n.rowHeight[p]=S,W=n.rowHeight[p]-W),n.height+=W,n.rows[p].push(m)},O.prototype.getShortestRowIndex=function(n){for(var m=-1,p=Number.MAX_VALUE,E=0;E<n.rows.length;E++)n.rowWidth[E]<p&&(m=E,p=n.rowWidth[E]);return m},O.prototype.getLongestRowIndex=function(n){for(var m=-1,p=Number.MIN_VALUE,E=0;E<n.rows.length;E++)n.rowWidth[E]>p&&(m=E,p=n.rowWidth[E]);return m},O.prototype.canAddHorizontal=function(n,m,p){if(n.idealRowWidth){var E=n.rows.length-1,y=n.rowWidth[E];return y+m+n.horizontalPadding<=n.idealRowWidth}var R=this.getShortestRowIndex(n);if(R<0)return!0;var M=n.rowWidth[R];if(M+n.horizontalPadding+m<=n.width)return!0;var S=0;n.rowHeight[R]<p&&R>0&&(S=p+n.verticalPadding-n.rowHeight[R]);var W;n.width-M>=m+n.horizontalPadding?W=(n.height+S)/(M+m+n.horizontalPadding):W=(n.height+S)/n.width,S=p+n.verticalPadding;var D;return n.width<m?D=(n.height+S)/m:D=(n.height+S)/n.width,D<1&&(D=1/D),W<1&&(W=1/W),W<D},O.prototype.shiftToLastRow=function(n){var m=this.getLongestRowIndex(n),p=n.rowWidth.length-1,E=n.rows[m],y=E[E.length-1],R=y.width+n.horizontalPadding;if(n.width-n.rowWidth[p]>R&&m!=p){E.splice(-1,1),n.rows[p].push(y),n.rowWidth[m]=n.rowWidth[m]-R,n.rowWidth[p]=n.rowWidth[p]+R,n.width=n.rowWidth[instance.getLongestRowIndex(n)];for(var M=Number.MIN_VALUE,S=0;S<E.length;S++)E[S].height>M&&(M=E[S].height);m>0&&(M+=n.verticalPadding);var W=n.rowHeight[m]+n.rowHeight[p];n.rowHeight[m]=M,n.rowHeight[p]<y.height+n.verticalPadding&&(n.rowHeight[p]=y.height+n.verticalPadding);var D=n.rowHeight[m]+n.rowHeight[p];n.height+=D-W,this.shiftToLastRow(n)}},O.prototype.tilingPreLayout=function(){s.TILE&&(this.groupZeroDegreeMembers(),this.clearCompounds(),this.clearZeroDegreeMembers())},O.prototype.tilingPostLayout=function(){s.TILE&&(this.repopulateZeroDegreeMembers(),this.repopulateCompounds())},O.prototype.reduceTrees=function(){for(var n=[],m=!0,p;m;){var E=this.graphManager.getAllNodes(),y=[];m=!1;for(var R=0;R<E.length;R++)if(p=E[R],p.getEdges().length==1&&!p.getEdges()[0].isInterGraph&&p.getChild()==null){if(s.PURE_INCREMENTAL){var M=p.getEdges()[0].getOtherEnd(p),S=new L(p.getCenterX()-M.getCenterX(),p.getCenterY()-M.getCenterY());y.push([p,p.getEdges()[0],p.getOwner(),S])}else y.push([p,p.getEdges()[0],p.getOwner()]);m=!0}if(m==!0){for(var W=[],D=0;D<y.length;D++)y[D][0].getEdges().length==1&&(W.push(y[D]),y[D][0].getOwner().remove(y[D][0]));n.push(W),this.graphManager.resetAllNodes(),this.graphManager.resetAllEdges()}}this.prunedNodesAll=n},O.prototype.growTree=function(n){for(var m=n.length,p=n[m-1],E,y=0;y<p.length;y++)E=p[y],this.findPlaceforPrunedNode(E),E[2].add(E[0]),E[2].add(E[1],E[1].source,E[1].target);n.splice(n.length-1,1),this.graphManager.resetAllNodes(),this.graphManager.resetAllEdges()},O.prototype.findPlaceforPrunedNode=function(n){var m,p,E=n[0];if(E==n[1].source?p=n[1].target:p=n[1].source,s.PURE_INCREMENTAL)E.setCenter(p.getCenterX()+n[3].getWidth(),p.getCenterY()+n[3].getHeight());else{var y=p.startX,R=p.finishX,M=p.startY,S=p.finishY,W=0,D=0,q=0,V=0,X=[W,q,D,V];if(M>0)for(var et=y;et<=R;et++)X[0]+=this.grid[et][M-1].length+this.grid[et][M].length-1;if(R<this.grid.length-1)for(var et=M;et<=S;et++)X[1]+=this.grid[R+1][et].length+this.grid[R][et].length-1;if(S<this.grid[0].length-1)for(var et=y;et<=R;et++)X[2]+=this.grid[et][S+1].length+this.grid[et][S].length-1;if(y>0)for(var et=M;et<=S;et++)X[3]+=this.grid[y-1][et].length+this.grid[y][et].length-1;for(var z=C.MAX_VALUE,w,H,B=0;B<X.length;B++)X[B]<z?(z=X[B],w=1,H=B):X[B]==z&&w++;if(w==3&&z==0)X[0]==0&&X[1]==0&&X[2]==0?m=1:X[0]==0&&X[1]==0&&X[3]==0?m=0:X[0]==0&&X[2]==0&&X[3]==0?m=3:X[1]==0&&X[2]==0&&X[3]==0&&(m=2);else if(w==2&&z==0){var _=Math.floor(Math.random()*2);X[0]==0&&X[1]==0?_==0?m=0:m=1:X[0]==0&&X[2]==0?_==0?m=0:m=2:X[0]==0&&X[3]==0?_==0?m=0:m=3:X[1]==0&&X[2]==0?_==0?m=1:m=2:X[1]==0&&X[3]==0?_==0?m=1:m=3:_==0?m=2:m=3}else if(w==4&&z==0){var _=Math.floor(Math.random()*4);m=_}else m=H;m==0?E.setCenter(p.getCenterX(),p.getCenterY()-p.getHeight()/2-f.DEFAULT_EDGE_LENGTH-E.getHeight()/2):m==1?E.setCenter(p.getCenterX()+p.getWidth()/2+f.DEFAULT_EDGE_LENGTH+E.getWidth()/2,p.getCenterY()):m==2?E.setCenter(p.getCenterX(),p.getCenterY()+p.getHeight()/2+f.DEFAULT_EDGE_LENGTH+E.getHeight()/2):E.setCenter(p.getCenterX()-p.getWidth()/2-f.DEFAULT_EDGE_LENGTH-E.getWidth()/2,p.getCenterY())}},a.exports=O}),991:((a,e,r)=>{var l=r(551).FDLayoutNode,i=r(551).IMath;function g(o,s,c,f){l.call(this,o,s,c,f)}g.prototype=Object.create(l.prototype);for(var t in l)g[t]=l[t];g.prototype.calculateDisplacement=function(){var o=this.graphManager.getLayout();this.getChild()!=null&&this.fixedNodeWeight?(this.displacementX+=o.coolingFactor*(this.springForceX+this.repulsionForceX+this.gravitationForceX)/this.fixedNodeWeight,this.displacementY+=o.coolingFactor*(this.springForceY+this.repulsionForceY+this.gravitationForceY)/this.fixedNodeWeight):(this.displacementX+=o.coolingFactor*(this.springForceX+this.repulsionForceX+this.gravitationForceX)/this.noOfChildren,this.displacementY+=o.coolingFactor*(this.springForceY+this.repulsionForceY+this.gravitationForceY)/this.noOfChildren),Math.abs(this.displacementX)>o.coolingFactor*o.maxNodeDisplacement&&(this.displacementX=o.coolingFactor*o.maxNodeDisplacement*i.sign(this.displacementX)),Math.abs(this.displacementY)>o.coolingFactor*o.maxNodeDisplacement&&(this.displacementY=o.coolingFactor*o.maxNodeDisplacement*i.sign(this.displacementY)),this.child&&this.child.getNodes().length>0&&this.propogateDisplacementToChildren(this.displacementX,this.displacementY)},g.prototype.propogateDisplacementToChildren=function(o,s){for(var c=this.getChild().getNodes(),f,T=0;T<c.length;T++)f=c[T],f.getChild()==null?(f.displacementX+=o,f.displacementY+=s):f.propogateDisplacementToChildren(o,s)},g.prototype.move=function(){var o=this.graphManager.getLayout();(this.child==null||this.child.getNodes().length==0)&&(this.moveBy(this.displacementX,this.displacementY),o.totalDisplacement+=Math.abs(this.displacementX)+Math.abs(this.displacementY)),this.springForceX=0,this.springForceY=0,this.repulsionForceX=0,this.repulsionForceY=0,this.gravitationForceX=0,this.gravitationForceY=0,this.displacementX=0,this.displacementY=0},g.prototype.setPred1=function(o){this.pred1=o},g.prototype.getPred1=function(){return pred1},g.prototype.getPred2=function(){return pred2},g.prototype.setNext=function(o){this.next=o},g.prototype.getNext=function(){return next},g.prototype.setProcessed=function(o){this.processed=o},g.prototype.isProcessed=function(){return processed},a.exports=g}),902:((a,e,r)=>{function l(c){if(Array.isArray(c)){for(var f=0,T=Array(c.length);f<c.length;f++)T[f]=c[f];return T}else return Array.from(c)}var i=r(806),g=r(551).LinkedList,t=r(551).Matrix,o=r(551).SVD;function s(){}s.handleConstraints=function(c){var f={};f.fixedNodeConstraint=c.constraints.fixedNodeConstraint,f.alignmentConstraint=c.constraints.alignmentConstraint,f.relativePlacementConstraint=c.constraints.relativePlacementConstraint;for(var T=new Map,v=new Map,d=[],L=[],b=c.getAllNodes(),C=0,G=0;G<b.length;G++){var k=b[G];k.getChild()==null&&(v.set(k.id,C++),d.push(k.getCenterX()),L.push(k.getCenterY()),T.set(k.id,k))}f.relativePlacementConstraint&&f.relativePlacementConstraint.forEach(function(F){!F.gap&&F.gap!=0&&(F.left?F.gap=i.DEFAULT_EDGE_LENGTH+T.get(F.left).getWidth()/2+T.get(F.right).getWidth()/2:F.gap=i.DEFAULT_EDGE_LENGTH+T.get(F.top).getHeight()/2+T.get(F.bottom).getHeight()/2)});var Y=function(U,$){return{x:U.x-$.x,y:U.y-$.y}},K=function(U){var $=0,J=0;return U.forEach(function(Z){$+=d[v.get(Z)],J+=L[v.get(Z)]}),{x:$/U.size,y:J/U.size}},O=function(U,$,J,Z,at){function ct(lt,ot){var Lt=new Set(lt),ft=!0,st=!1,Xt=void 0;try{for(var Tt=ot[Symbol.iterator](),Ct;!(ft=(Ct=Tt.next()).done);ft=!0){var Bt=Ct.value;Lt.add(Bt)}}catch(bt){st=!0,Xt=bt}finally{try{!ft&&Tt.return&&Tt.return()}finally{if(st)throw Xt}}return Lt}var nt=new Map;U.forEach(function(lt,ot){nt.set(ot,0)}),U.forEach(function(lt,ot){lt.forEach(function(Lt){nt.set(Lt.id,nt.get(Lt.id)+1)})});var tt=new Map,j=new Map,ut=new g;nt.forEach(function(lt,ot){lt==0?(ut.push(ot),J||($=="horizontal"?tt.set(ot,v.has(ot)?d[v.get(ot)]:Z.get(ot)):tt.set(ot,v.has(ot)?L[v.get(ot)]:Z.get(ot)))):tt.set(ot,Number.NEGATIVE_INFINITY),J&&j.set(ot,new Set([ot]))}),J&&at.forEach(function(lt){var ot=[];if(lt.forEach(function(st){J.has(st)&&ot.push(st)}),ot.length>0){var Lt=0;ot.forEach(function(st){$=="horizontal"?(tt.set(st,v.has(st)?d[v.get(st)]:Z.get(st)),Lt+=tt.get(st)):(tt.set(st,v.has(st)?L[v.get(st)]:Z.get(st)),Lt+=tt.get(st))}),Lt=Lt/ot.length,lt.forEach(function(st){J.has(st)||tt.set(st,Lt)})}else{var ft=0;lt.forEach(function(st){$=="horizontal"?ft+=v.has(st)?d[v.get(st)]:Z.get(st):ft+=v.has(st)?L[v.get(st)]:Z.get(st)}),ft=ft/lt.length,lt.forEach(function(st){tt.set(st,ft)})}});for(var Mt=function(){var ot=ut.shift(),Lt=U.get(ot);Lt.forEach(function(ft){if(tt.get(ft.id)<tt.get(ot)+ft.gap)if(J&&J.has(ft.id)){var st=void 0;if($=="horizontal"?st=v.has(ft.id)?d[v.get(ft.id)]:Z.get(ft.id):st=v.has(ft.id)?L[v.get(ft.id)]:Z.get(ft.id),tt.set(ft.id,st),st<tt.get(ot)+ft.gap){var Xt=tt.get(ot)+ft.gap-st;j.get(ot).forEach(function(Tt){tt.set(Tt,tt.get(Tt)-Xt)})}}else tt.set(ft.id,tt.get(ot)+ft.gap);nt.set(ft.id,nt.get(ft.id)-1),nt.get(ft.id)==0&&ut.push(ft.id),J&&j.set(ft.id,ct(j.get(ot),j.get(ft.id)))})};ut.length!=0;)Mt();if(J){var pt=new Set;U.forEach(function(lt,ot){lt.length==0&&pt.add(ot)});var xt=[];j.forEach(function(lt,ot){if(pt.has(ot)){var Lt=!1,ft=!0,st=!1,Xt=void 0;try{for(var Tt=lt[Symbol.iterator](),Ct;!(ft=(Ct=Tt.next()).done);ft=!0){var Bt=Ct.value;J.has(Bt)&&(Lt=!0)}}catch(St){st=!0,Xt=St}finally{try{!ft&&Tt.return&&Tt.return()}finally{if(st)throw Xt}}if(!Lt){var bt=!1,zt=void 0;xt.forEach(function(St,Zt){St.has([].concat(l(lt))[0])&&(bt=!0,zt=Zt)}),bt?lt.forEach(function(St){xt[zt].add(St)}):xt.push(new Set(lt))}}}),xt.forEach(function(lt,ot){var Lt=Number.POSITIVE_INFINITY,ft=Number.POSITIVE_INFINITY,st=Number.NEGATIVE_INFINITY,Xt=Number.NEGATIVE_INFINITY,Tt=!0,Ct=!1,Bt=void 0;try{for(var bt=lt[Symbol.iterator](),zt;!(Tt=(zt=bt.next()).done);Tt=!0){var St=zt.value,Zt=void 0;$=="horizontal"?Zt=v.has(St)?d[v.get(St)]:Z.get(St):Zt=v.has(St)?L[v.get(St)]:Z.get(St);var Kt=tt.get(St);Zt<Lt&&(Lt=Zt),Zt>st&&(st=Zt),Kt<ft&&(ft=Kt),Kt>Xt&&(Xt=Kt)}}catch(ee){Ct=!0,Bt=ee}finally{try{!Tt&&bt.return&&bt.return()}finally{if(Ct)throw Bt}}var ce=(Lt+st)/2-(ft+Xt)/2,Qt=!0,jt=!1,_t=void 0;try{for(var Jt=lt[Symbol.iterator](),oe;!(Qt=(oe=Jt.next()).done);Qt=!0){var te=oe.value;tt.set(te,tt.get(te)+ce)}}catch(ee){jt=!0,_t=ee}finally{try{!Qt&&Jt.return&&Jt.return()}finally{if(jt)throw _t}}})}return tt},it=function(U){var $=0,J=0,Z=0,at=0;if(U.forEach(function(j){j.left?d[v.get(j.left)]-d[v.get(j.right)]>=0?$++:J++:L[v.get(j.top)]-L[v.get(j.bottom)]>=0?Z++:at++}),$>J&&Z>at)for(var ct=0;ct<v.size;ct++)d[ct]=-1*d[ct],L[ct]=-1*L[ct];else if($>J)for(var nt=0;nt<v.size;nt++)d[nt]=-1*d[nt];else if(Z>at)for(var tt=0;tt<v.size;tt++)L[tt]=-1*L[tt]},n=function(U){var $=[],J=new g,Z=new Set,at=0;return U.forEach(function(ct,nt){if(!Z.has(nt)){$[at]=[];var tt=nt;for(J.push(tt),Z.add(tt),$[at].push(tt);J.length!=0;){tt=J.shift();var j=U.get(tt);j.forEach(function(ut){Z.has(ut.id)||(J.push(ut.id),Z.add(ut.id),$[at].push(ut.id))})}at++}}),$},m=function(U){var $=new Map;return U.forEach(function(J,Z){$.set(Z,[])}),U.forEach(function(J,Z){J.forEach(function(at){$.get(Z).push(at),$.get(at.id).push({id:Z,gap:at.gap,direction:at.direction})})}),$},p=function(U){var $=new Map;return U.forEach(function(J,Z){$.set(Z,[])}),U.forEach(function(J,Z){J.forEach(function(at){$.get(at.id).push({id:Z,gap:at.gap,direction:at.direction})})}),$},E=[],y=[],R=!1,M=!1,S=new Set,W=new Map,D=new Map,q=[];if(f.fixedNodeConstraint&&f.fixedNodeConstraint.forEach(function(F){S.add(F.nodeId)}),f.relativePlacementConstraint&&(f.relativePlacementConstraint.forEach(function(F){F.left?(W.has(F.left)?W.get(F.left).push({id:F.right,gap:F.gap,direction:"horizontal"}):W.set(F.left,[{id:F.right,gap:F.gap,direction:"horizontal"}]),W.has(F.right)||W.set(F.right,[])):(W.has(F.top)?W.get(F.top).push({id:F.bottom,gap:F.gap,direction:"vertical"}):W.set(F.top,[{id:F.bottom,gap:F.gap,direction:"vertical"}]),W.has(F.bottom)||W.set(F.bottom,[]))}),D=m(W),q=n(D)),i.TRANSFORM_ON_CONSTRAINT_HANDLING){if(f.fixedNodeConstraint&&f.fixedNodeConstraint.length>1)f.fixedNodeConstraint.forEach(function(F,U){E[U]=[F.position.x,F.position.y],y[U]=[d[v.get(F.nodeId)],L[v.get(F.nodeId)]]}),R=!0;else if(f.alignmentConstraint)(function(){var F=0;if(f.alignmentConstraint.vertical){for(var U=f.alignmentConstraint.vertical,$=function(tt){var j=new Set;U[tt].forEach(function(pt){j.add(pt)});var ut=new Set([].concat(l(j)).filter(function(pt){return S.has(pt)})),Mt=void 0;ut.size>0?Mt=d[v.get(ut.values().next().value)]:Mt=K(j).x,U[tt].forEach(function(pt){E[F]=[Mt,L[v.get(pt)]],y[F]=[d[v.get(pt)],L[v.get(pt)]],F++})},J=0;J<U.length;J++)$(J);R=!0}if(f.alignmentConstraint.horizontal){for(var Z=f.alignmentConstraint.horizontal,at=function(tt){var j=new Set;Z[tt].forEach(function(pt){j.add(pt)});var ut=new Set([].concat(l(j)).filter(function(pt){return S.has(pt)})),Mt=void 0;ut.size>0?Mt=d[v.get(ut.values().next().value)]:Mt=K(j).y,Z[tt].forEach(function(pt){E[F]=[d[v.get(pt)],Mt],y[F]=[d[v.get(pt)],L[v.get(pt)]],F++})},ct=0;ct<Z.length;ct++)at(ct);R=!0}f.relativePlacementConstraint&&(M=!0)})();else if(f.relativePlacementConstraint){for(var V=0,X=0,et=0;et<q.length;et++)q[et].length>V&&(V=q[et].length,X=et);if(V<D.size/2)it(f.relativePlacementConstraint),R=!1,M=!1;else{var z=new Map,w=new Map,H=[];q[X].forEach(function(F){W.get(F).forEach(function(U){U.direction=="horizontal"?(z.has(F)?z.get(F).push(U):z.set(F,[U]),z.has(U.id)||z.set(U.id,[]),H.push({left:F,right:U.id})):(w.has(F)?w.get(F).push(U):w.set(F,[U]),w.has(U.id)||w.set(U.id,[]),H.push({top:F,bottom:U.id}))})}),it(H),M=!1;var B=O(z,"horizontal"),_=O(w,"vertical");q[X].forEach(function(F,U){y[U]=[d[v.get(F)],L[v.get(F)]],E[U]=[],B.has(F)?E[U][0]=B.get(F):E[U][0]=d[v.get(F)],_.has(F)?E[U][1]=_.get(F):E[U][1]=L[v.get(F)]}),R=!0}}if(R){for(var ht=void 0,Q=t.transpose(E),It=t.transpose(y),Nt=0;Nt<Q.length;Nt++)Q[Nt]=t.multGamma(Q[Nt]),It[Nt]=t.multGamma(It[Nt]);var dt=t.multMat(Q,t.transpose(It)),rt=o.svd(dt);ht=t.multMat(rt.V,t.transpose(rt.U));for(var gt=0;gt<v.size;gt++){var mt=[d[gt],L[gt]],At=[ht[0][0],ht[1][0]],Ot=[ht[0][1],ht[1][1]];d[gt]=t.dotProduct(mt,At),L[gt]=t.dotProduct(mt,Ot)}M&&it(f.relativePlacementConstraint)}}if(i.ENFORCE_CONSTRAINTS){if(f.fixedNodeConstraint&&f.fixedNodeConstraint.length>0){var Et={x:0,y:0};f.fixedNodeConstraint.forEach(function(F,U){var $={x:d[v.get(F.nodeId)],y:L[v.get(F.nodeId)]},J=F.position,Z=Y(J,$);Et.x+=Z.x,Et.y+=Z.y}),Et.x/=f.fixedNodeConstraint.length,Et.y/=f.fixedNodeConstraint.length,d.forEach(function(F,U){d[U]+=Et.x}),L.forEach(function(F,U){L[U]+=Et.y}),f.fixedNodeConstraint.forEach(function(F){d[v.get(F.nodeId)]=F.position.x,L[v.get(F.nodeId)]=F.position.y})}if(f.alignmentConstraint){if(f.alignmentConstraint.vertical)for(var Dt=f.alignmentConstraint.vertical,Rt=function(U){var $=new Set;Dt[U].forEach(function(at){$.add(at)});var J=new Set([].concat(l($)).filter(function(at){return S.has(at)})),Z=void 0;J.size>0?Z=d[v.get(J.values().next().value)]:Z=K($).x,$.forEach(function(at){S.has(at)||(d[v.get(at)]=Z)})},Ht=0;Ht<Dt.length;Ht++)Rt(Ht);if(f.alignmentConstraint.horizontal)for(var Ut=f.alignmentConstraint.horizontal,Pt=function(U){var $=new Set;Ut[U].forEach(function(at){$.add(at)});var J=new Set([].concat(l($)).filter(function(at){return S.has(at)})),Z=void 0;J.size>0?Z=L[v.get(J.values().next().value)]:Z=K($).y,$.forEach(function(at){S.has(at)||(L[v.get(at)]=Z)})},Ft=0;Ft<Ut.length;Ft++)Pt(Ft)}f.relativePlacementConstraint&&(function(){var F=new Map,U=new Map,$=new Map,J=new Map,Z=new Map,at=new Map,ct=new Set,nt=new Set;if(S.forEach(function(Gt){ct.add(Gt),nt.add(Gt)}),f.alignmentConstraint){if(f.alignmentConstraint.vertical)for(var tt=f.alignmentConstraint.vertical,j=function(yt){$.set("dummy"+yt,[]),tt[yt].forEach(function(wt){F.set(wt,"dummy"+yt),$.get("dummy"+yt).push(wt),S.has(wt)&&ct.add("dummy"+yt)}),Z.set("dummy"+yt,d[v.get(tt[yt][0])])},ut=0;ut<tt.length;ut++)j(ut);if(f.alignmentConstraint.horizontal)for(var Mt=f.alignmentConstraint.horizontal,pt=function(yt){J.set("dummy"+yt,[]),Mt[yt].forEach(function(wt){U.set(wt,"dummy"+yt),J.get("dummy"+yt).push(wt),S.has(wt)&&nt.add("dummy"+yt)}),at.set("dummy"+yt,L[v.get(Mt[yt][0])])},xt=0;xt<Mt.length;xt++)pt(xt)}var lt=new Map,ot=new Map,Lt=function(yt){W.get(yt).forEach(function(wt){var kt=void 0,$t=void 0;wt.direction=="horizontal"?(kt=F.get(yt)?F.get(yt):yt,F.get(wt.id)?$t={id:F.get(wt.id),gap:wt.gap,direction:wt.direction}:$t=wt,lt.has(kt)?lt.get(kt).push($t):lt.set(kt,[$t]),lt.has($t.id)||lt.set($t.id,[])):(kt=U.get(yt)?U.get(yt):yt,U.get(wt.id)?$t={id:U.get(wt.id),gap:wt.gap,direction:wt.direction}:$t=wt,ot.has(kt)?ot.get(kt).push($t):ot.set(kt,[$t]),ot.has($t.id)||ot.set($t.id,[]))})},ft=!0,st=!1,Xt=void 0;try{for(var Tt=W.keys()[Symbol.iterator](),Ct;!(ft=(Ct=Tt.next()).done);ft=!0){var Bt=Ct.value;Lt(Bt)}}catch(Gt){st=!0,Xt=Gt}finally{try{!ft&&Tt.return&&Tt.return()}finally{if(st)throw Xt}}var bt=m(lt),zt=m(ot),St=n(bt),Zt=n(zt),Kt=p(lt),ce=p(ot),Qt=[],jt=[];St.forEach(function(Gt,yt){Qt[yt]=[],Gt.forEach(function(wt){Kt.get(wt).length==0&&Qt[yt].push(wt)})}),Zt.forEach(function(Gt,yt){jt[yt]=[],Gt.forEach(function(wt){ce.get(wt).length==0&&jt[yt].push(wt)})});var _t=O(lt,"horizontal",ct,Z,Qt),Jt=O(ot,"vertical",nt,at,jt),oe=function(yt){$.get(yt)?$.get(yt).forEach(function(wt){d[v.get(wt)]=_t.get(yt)}):d[v.get(yt)]=_t.get(yt)},te=!0,ee=!1,Ne=void 0;try{for(var ge=_t.keys()[Symbol.iterator](),Le;!(te=(Le=ge.next()).done);te=!0){var ue=Le.value;oe(ue)}}catch(Gt){ee=!0,Ne=Gt}finally{try{!te&&ge.return&&ge.return()}finally{if(ee)throw Ne}}var $e=function(yt){J.get(yt)?J.get(yt).forEach(function(wt){L[v.get(wt)]=Jt.get(yt)}):L[v.get(yt)]=Jt.get(yt)},ve=!0,Ce=!1,Ae=void 0;try{for(var de=Jt.keys()[Symbol.iterator](),Me;!(ve=(Me=de.next()).done);ve=!0){var ue=Me.value;$e(ue)}}catch(Gt){Ce=!0,Ae=Gt}finally{try{!ve&&de.return&&de.return()}finally{if(Ce)throw Ae}}})()}for(var Yt=0;Yt<b.length;Yt++){var Vt=b[Yt];Vt.getChild()==null&&Vt.setCenter(d[v.get(Vt.id)],L[v.get(Vt.id)])}},a.exports=s}),551:(a=>{a.exports=A})},N={};function u(a){var e=N[a];if(e!==void 0)return e.exports;var r=N[a]={exports:{}};return P[a](r,r.exports,u),r.exports}var h=u(45);return h})()})})(le)),le.exports}var pr=he.exports,De;function yr(){return De||(De=1,(function(I,x){(function(P,N){I.exports=N(dr())})(pr,function(A){return(()=>{var P={658:(a=>{a.exports=Object.assign!=null?Object.assign.bind(Object):function(e){for(var r=arguments.length,l=Array(r>1?r-1:0),i=1;i<r;i++)l[i-1]=arguments[i];return l.forEach(function(g){Object.keys(g).forEach(function(t){return e[t]=g[t]})}),e}}),548:((a,e,r)=>{var l=(function(){function t(o,s){var c=[],f=!0,T=!1,v=void 0;try{for(var d=o[Symbol.iterator](),L;!(f=(L=d.next()).done)&&(c.push(L.value),!(s&&c.length===s));f=!0);}catch(b){T=!0,v=b}finally{try{!f&&d.return&&d.return()}finally{if(T)throw v}}return c}return function(o,s){if(Array.isArray(o))return o;if(Symbol.iterator in Object(o))return t(o,s);throw new TypeError("Invalid attempt to destructure non-iterable instance")}})(),i=r(140).layoutBase.LinkedList,g={};g.getTopMostNodes=function(t){for(var o={},s=0;s<t.length;s++)o[t[s].id()]=!0;var c=t.filter(function(f,T){typeof f=="number"&&(f=T);for(var v=f.parent()[0];v!=null;){if(o[v.id()])return!1;v=v.parent()[0]}return!0});return c},g.connectComponents=function(t,o,s,c){var f=new i,T=new Set,v=[],d=void 0,L=void 0,b=void 0,C=!1,G=1,k=[],Y=[],K=function(){var it=t.collection();Y.push(it);var n=s[0],m=t.collection();m.merge(n).merge(n.descendants().intersection(o)),v.push(n),m.forEach(function(y){f.push(y),T.add(y),it.merge(y)});for(var p=function(){n=f.shift();var R=t.collection();n.neighborhood().nodes().forEach(function(D){o.intersection(n.edgesWith(D)).length>0&&R.merge(D)});for(var M=0;M<R.length;M++){var S=R[M];if(d=s.intersection(S.union(S.ancestors())),d!=null&&!T.has(d[0])){var W=d.union(d.descendants());W.forEach(function(D){f.push(D),T.add(D),it.merge(D),s.has(D)&&v.push(D)})}}};f.length!=0;)p();if(it.forEach(function(y){o.intersection(y.connectedEdges()).forEach(function(R){it.has(R.source())&&it.has(R.target())&&it.merge(R)})}),v.length==s.length&&(C=!0),!C||C&&G>1){L=v[0],b=L.connectedEdges().length,v.forEach(function(y){y.connectedEdges().length<b&&(b=y.connectedEdges().length,L=y)}),k.push(L.id());var E=t.collection();E.merge(v[0]),v.forEach(function(y){E.merge(y)}),v=[],s=s.difference(E),G++}};do K();while(!C);return c&&k.length>0&&c.set("dummy"+(c.size+1),k),Y},g.relocateComponent=function(t,o,s){if(!s.fixedNodeConstraint){var c=Number.POSITIVE_INFINITY,f=Number.NEGATIVE_INFINITY,T=Number.POSITIVE_INFINITY,v=Number.NEGATIVE_INFINITY;if(s.quality=="draft"){var d=!0,L=!1,b=void 0;try{for(var C=o.nodeIndexes[Symbol.iterator](),G;!(d=(G=C.next()).done);d=!0){var k=G.value,Y=l(k,2),K=Y[0],O=Y[1],it=s.cy.getElementById(K);if(it){var n=it.boundingBox(),m=o.xCoords[O]-n.w/2,p=o.xCoords[O]+n.w/2,E=o.yCoords[O]-n.h/2,y=o.yCoords[O]+n.h/2;m<c&&(c=m),p>f&&(f=p),E<T&&(T=E),y>v&&(v=y)}}}catch(D){L=!0,b=D}finally{try{!d&&C.return&&C.return()}finally{if(L)throw b}}var R=t.x-(f+c)/2,M=t.y-(v+T)/2;o.xCoords=o.xCoords.map(function(D){return D+R}),o.yCoords=o.yCoords.map(function(D){return D+M})}else{Object.keys(o).forEach(function(D){var q=o[D],V=q.getRect().x,X=q.getRect().x+q.getRect().width,et=q.getRect().y,z=q.getRect().y+q.getRect().height;V<c&&(c=V),X>f&&(f=X),et<T&&(T=et),z>v&&(v=z)});var S=t.x-(f+c)/2,W=t.y-(v+T)/2;Object.keys(o).forEach(function(D){var q=o[D];q.setCenter(q.getCenterX()+S,q.getCenterY()+W)})}}},g.calcBoundingBox=function(t,o,s,c){for(var f=Number.MAX_SAFE_INTEGER,T=Number.MIN_SAFE_INTEGER,v=Number.MAX_SAFE_INTEGER,d=Number.MIN_SAFE_INTEGER,L=void 0,b=void 0,C=void 0,G=void 0,k=t.descendants().not(":parent"),Y=k.length,K=0;K<Y;K++){var O=k[K];L=o[c.get(O.id())]-O.width()/2,b=o[c.get(O.id())]+O.width()/2,C=s[c.get(O.id())]-O.height()/2,G=s[c.get(O.id())]+O.height()/2,f>L&&(f=L),T<b&&(T=b),v>C&&(v=C),d<G&&(d=G)}var it={};return it.topLeftX=f,it.topLeftY=v,it.width=T-f,it.height=d-v,it},g.calcParentsWithoutChildren=function(t,o){var s=t.collection();return o.nodes(":parent").forEach(function(c){var f=!1;c.children().forEach(function(T){T.css("display")!="none"&&(f=!0)}),f||s.merge(c)}),s},a.exports=g}),816:((a,e,r)=>{var l=r(548),i=r(140).CoSELayout,g=r(140).CoSENode,t=r(140).layoutBase.PointD,o=r(140).layoutBase.DimensionD,s=r(140).layoutBase.LayoutConstants,c=r(140).layoutBase.FDLayoutConstants,f=r(140).CoSEConstants,T=function(d,L){var b=d.cy,C=d.eles,G=C.nodes(),k=C.edges(),Y=void 0,K=void 0,O=void 0,it={};d.randomize&&(Y=L.nodeIndexes,K=L.xCoords,O=L.yCoords);var n=function(D){return typeof D=="function"},m=function(D,q){return n(D)?D(q):D},p=l.calcParentsWithoutChildren(b,C),E=function W(D,q,V,X){for(var et=q.length,z=0;z<et;z++){var w=q[z],H=null;w.intersection(p).length==0&&(H=w.children());var B=void 0,_=w.layoutDimensions({nodeDimensionsIncludeLabels:X.nodeDimensionsIncludeLabels});if(w.outerWidth()!=null&&w.outerHeight()!=null)if(X.randomize)if(!w.isParent())B=D.add(new g(V.graphManager,new t(K[Y.get(w.id())]-_.w/2,O[Y.get(w.id())]-_.h/2),new o(parseFloat(_.w),parseFloat(_.h))));else{var ht=l.calcBoundingBox(w,K,O,Y);w.intersection(p).length==0?B=D.add(new g(V.graphManager,new t(ht.topLeftX,ht.topLeftY),new o(ht.width,ht.height))):B=D.add(new g(V.graphManager,new t(ht.topLeftX,ht.topLeftY),new o(parseFloat(_.w),parseFloat(_.h))))}else B=D.add(new g(V.graphManager,new t(w.position("x")-_.w/2,w.position("y")-_.h/2),new o(parseFloat(_.w),parseFloat(_.h))));else B=D.add(new g(this.graphManager));if(B.id=w.data("id"),B.nodeRepulsion=m(X.nodeRepulsion,w),B.paddingLeft=parseInt(w.css("padding")),B.paddingTop=parseInt(w.css("padding")),B.paddingRight=parseInt(w.css("padding")),B.paddingBottom=parseInt(w.css("padding")),X.nodeDimensionsIncludeLabels&&(B.labelWidth=w.boundingBox({includeLabels:!0,includeNodes:!1,includeOverlays:!1}).w,B.labelHeight=w.boundingBox({includeLabels:!0,includeNodes:!1,includeOverlays:!1}).h,B.labelPosVertical=w.css("text-valign"),B.labelPosHorizontal=w.css("text-halign")),it[w.data("id")]=B,isNaN(B.rect.x)&&(B.rect.x=0),isNaN(B.rect.y)&&(B.rect.y=0),H!=null&&H.length>0){var Q=void 0;Q=V.getGraphManager().add(V.newGraph(),B),W(Q,H,V,X)}}},y=function(D,q,V){for(var X=0,et=0,z=0;z<V.length;z++){var w=V[z],H=it[w.data("source")],B=it[w.data("target")];if(H&&B&&H!==B&&H.getEdgesBetween(B).length==0){var _=q.add(D.newEdge(),H,B);_.id=w.id(),_.idealLength=m(d.idealEdgeLength,w),_.edgeElasticity=m(d.edgeElasticity,w),X+=_.idealLength,et++}}d.idealEdgeLength!=null&&(et>0?f.DEFAULT_EDGE_LENGTH=c.DEFAULT_EDGE_LENGTH=X/et:n(d.idealEdgeLength)?f.DEFAULT_EDGE_LENGTH=c.DEFAULT_EDGE_LENGTH=50:f.DEFAULT_EDGE_LENGTH=c.DEFAULT_EDGE_LENGTH=d.idealEdgeLength,f.MIN_REPULSION_DIST=c.MIN_REPULSION_DIST=c.DEFAULT_EDGE_LENGTH/10,f.DEFAULT_RADIAL_SEPARATION=c.DEFAULT_EDGE_LENGTH)},R=function(D,q){q.fixedNodeConstraint&&(D.constraints.fixedNodeConstraint=q.fixedNodeConstraint),q.alignmentConstraint&&(D.constraints.alignmentConstraint=q.alignmentConstraint),q.relativePlacementConstraint&&(D.constraints.relativePlacementConstraint=q.relativePlacementConstraint)};d.nestingFactor!=null&&(f.PER_LEVEL_IDEAL_EDGE_LENGTH_FACTOR=c.PER_LEVEL_IDEAL_EDGE_LENGTH_FACTOR=d.nestingFactor),d.gravity!=null&&(f.DEFAULT_GRAVITY_STRENGTH=c.DEFAULT_GRAVITY_STRENGTH=d.gravity),d.numIter!=null&&(f.MAX_ITERATIONS=c.MAX_ITERATIONS=d.numIter),d.gravityRange!=null&&(f.DEFAULT_GRAVITY_RANGE_FACTOR=c.DEFAULT_GRAVITY_RANGE_FACTOR=d.gravityRange),d.gravityCompound!=null&&(f.DEFAULT_COMPOUND_GRAVITY_STRENGTH=c.DEFAULT_COMPOUND_GRAVITY_STRENGTH=d.gravityCompound),d.gravityRangeCompound!=null&&(f.DEFAULT_COMPOUND_GRAVITY_RANGE_FACTOR=c.DEFAULT_COMPOUND_GRAVITY_RANGE_FACTOR=d.gravityRangeCompound),d.initialEnergyOnIncremental!=null&&(f.DEFAULT_COOLING_FACTOR_INCREMENTAL=c.DEFAULT_COOLING_FACTOR_INCREMENTAL=d.initialEnergyOnIncremental),d.tilingCompareBy!=null&&(f.TILING_COMPARE_BY=d.tilingCompareBy),d.quality=="proof"?s.QUALITY=2:s.QUALITY=0,f.NODE_DIMENSIONS_INCLUDE_LABELS=c.NODE_DIMENSIONS_INCLUDE_LABELS=s.NODE_DIMENSIONS_INCLUDE_LABELS=d.nodeDimensionsIncludeLabels,f.DEFAULT_INCREMENTAL=c.DEFAULT_INCREMENTAL=s.DEFAULT_INCREMENTAL=!d.randomize,f.ANIMATE=c.ANIMATE=s.ANIMATE=d.animate,f.TILE=d.tile,f.TILING_PADDING_VERTICAL=typeof d.tilingPaddingVertical=="function"?d.tilingPaddingVertical.call():d.tilingPaddingVertical,f.TILING_PADDING_HORIZONTAL=typeof d.tilingPaddingHorizontal=="function"?d.tilingPaddingHorizontal.call():d.tilingPaddingHorizontal,f.DEFAULT_INCREMENTAL=c.DEFAULT_INCREMENTAL=s.DEFAULT_INCREMENTAL=!0,f.PURE_INCREMENTAL=!d.randomize,s.DEFAULT_UNIFORM_LEAF_NODE_SIZES=d.uniformNodeDimensions,d.step=="transformed"&&(f.TRANSFORM_ON_CONSTRAINT_HANDLING=!0,f.ENFORCE_CONSTRAINTS=!1,f.APPLY_LAYOUT=!1),d.step=="enforced"&&(f.TRANSFORM_ON_CONSTRAINT_HANDLING=!1,f.ENFORCE_CONSTRAINTS=!0,f.APPLY_LAYOUT=!1),d.step=="cose"&&(f.TRANSFORM_ON_CONSTRAINT_HANDLING=!1,f.ENFORCE_CONSTRAINTS=!1,f.APPLY_LAYOUT=!0),d.step=="all"&&(d.randomize?f.TRANSFORM_ON_CONSTRAINT_HANDLING=!0:f.TRANSFORM_ON_CONSTRAINT_HANDLING=!1,f.ENFORCE_CONSTRAINTS=!0,f.APPLY_LAYOUT=!0),d.fixedNodeConstraint||d.alignmentConstraint||d.relativePlacementConstraint?f.TREE_REDUCTION_ON_INCREMENTAL=!1:f.TREE_REDUCTION_ON_INCREMENTAL=!0;var M=new i,S=M.newGraphManager();return E(S.addRoot(),l.getTopMostNodes(G),M,d),y(M,S,k),R(M,d),M.runLayout(),it};a.exports={coseLayout:T}}),212:((a,e,r)=>{var l=(function(){function d(L,b){for(var C=0;C<b.length;C++){var G=b[C];G.enumerable=G.enumerable||!1,G.configurable=!0,"value"in G&&(G.writable=!0),Object.defineProperty(L,G.key,G)}}return function(L,b,C){return b&&d(L.prototype,b),C&&d(L,C),L}})();function i(d,L){if(!(d instanceof L))throw new TypeError("Cannot call a class as a function")}var g=r(658),t=r(548),o=r(657),s=o.spectralLayout,c=r(816),f=c.coseLayout,T=Object.freeze({quality:"default",randomize:!0,animate:!0,animationDuration:1e3,animationEasing:void 0,fit:!0,padding:30,nodeDimensionsIncludeLabels:!1,uniformNodeDimensions:!1,packComponents:!0,step:"all",samplingType:!0,sampleSize:25,nodeSeparation:75,piTol:1e-7,nodeRepulsion:function(L){return 4500},idealEdgeLength:function(L){return 50},edgeElasticity:function(L){return .45},nestingFactor:.1,gravity:.25,numIter:2500,tile:!0,tilingCompareBy:void 0,tilingPaddingVertical:10,tilingPaddingHorizontal:10,gravityRangeCompound:1.5,gravityCompound:1,gravityRange:3.8,initialEnergyOnIncremental:.3,fixedNodeConstraint:void 0,alignmentConstraint:void 0,relativePlacementConstraint:void 0,ready:function(){},stop:function(){}}),v=(function(){function d(L){i(this,d),this.options=g({},T,L)}return l(d,[{key:"run",value:function(){var b=this,C=this.options,G=C.cy,k=C.eles,Y=[],K=[],O=void 0,it=[];C.fixedNodeConstraint&&(!Array.isArray(C.fixedNodeConstraint)||C.fixedNodeConstraint.length==0)&&(C.fixedNodeConstraint=void 0),C.alignmentConstraint&&(C.alignmentConstraint.vertical&&(!Array.isArray(C.alignmentConstraint.vertical)||C.alignmentConstraint.vertical.length==0)&&(C.alignmentConstraint.vertical=void 0),C.alignmentConstraint.horizontal&&(!Array.isArray(C.alignmentConstraint.horizontal)||C.alignmentConstraint.horizontal.length==0)&&(C.alignmentConstraint.horizontal=void 0)),C.relativePlacementConstraint&&(!Array.isArray(C.relativePlacementConstraint)||C.relativePlacementConstraint.length==0)&&(C.relativePlacementConstraint=void 0);var n=C.fixedNodeConstraint||C.alignmentConstraint||C.relativePlacementConstraint;n&&(C.tile=!1,C.packComponents=!1);var m=void 0,p=!1;if(G.layoutUtilities&&C.packComponents&&(m=G.layoutUtilities("get"),m||(m=G.layoutUtilities()),p=!0),k.nodes().length>0)if(p){var R=t.getTopMostNodes(C.eles.nodes());if(O=t.connectComponents(G,C.eles,R),O.forEach(function(dt){var rt=dt.boundingBox();it.push({x:rt.x1+rt.w/2,y:rt.y1+rt.h/2})}),C.randomize&&O.forEach(function(dt){C.eles=dt,Y.push(s(C))}),C.quality=="default"||C.quality=="proof"){var M=G.collection();if(C.tile){var S=new Map,W=[],D=[],q=0,V={nodeIndexes:S,xCoords:W,yCoords:D},X=[];if(O.forEach(function(dt,rt){dt.edges().length==0&&(dt.nodes().forEach(function(gt,mt){M.merge(dt.nodes()[mt]),gt.isParent()||(V.nodeIndexes.set(dt.nodes()[mt].id(),q++),V.xCoords.push(dt.nodes()[0].position().x),V.yCoords.push(dt.nodes()[0].position().y))}),X.push(rt))}),M.length>1){var et=M.boundingBox();it.push({x:et.x1+et.w/2,y:et.y1+et.h/2}),O.push(M),Y.push(V);for(var z=X.length-1;z>=0;z--)O.splice(X[z],1),Y.splice(X[z],1),it.splice(X[z],1)}}O.forEach(function(dt,rt){C.eles=dt,K.push(f(C,Y[rt])),t.relocateComponent(it[rt],K[rt],C)})}else O.forEach(function(dt,rt){t.relocateComponent(it[rt],Y[rt],C)});var w=new Set;if(O.length>1){var H=[],B=k.filter(function(dt){return dt.css("display")=="none"});O.forEach(function(dt,rt){var gt=void 0;if(C.quality=="draft"&&(gt=Y[rt].nodeIndexes),dt.nodes().not(B).length>0){var mt={};mt.edges=[],mt.nodes=[];var At=void 0;dt.nodes().not(B).forEach(function(Ot){if(C.quality=="draft")if(!Ot.isParent())At=gt.get(Ot.id()),mt.nodes.push({x:Y[rt].xCoords[At]-Ot.boundingbox().w/2,y:Y[rt].yCoords[At]-Ot.boundingbox().h/2,width:Ot.boundingbox().w,height:Ot.boundingbox().h});else{var Et=t.calcBoundingBox(Ot,Y[rt].xCoords,Y[rt].yCoords,gt);mt.nodes.push({x:Et.topLeftX,y:Et.topLeftY,width:Et.width,height:Et.height})}else K[rt][Ot.id()]&&mt.nodes.push({x:K[rt][Ot.id()].getLeft(),y:K[rt][Ot.id()].getTop(),width:K[rt][Ot.id()].getWidth(),height:K[rt][Ot.id()].getHeight()})}),dt.edges().forEach(function(Ot){var Et=Ot.source(),Dt=Ot.target();if(Et.css("display")!="none"&&Dt.css("display")!="none")if(C.quality=="draft"){var Rt=gt.get(Et.id()),Ht=gt.get(Dt.id()),Ut=[],Pt=[];if(Et.isParent()){var Ft=t.calcBoundingBox(Et,Y[rt].xCoords,Y[rt].yCoords,gt);Ut.push(Ft.topLeftX+Ft.width/2),Ut.push(Ft.topLeftY+Ft.height/2)}else Ut.push(Y[rt].xCoords[Rt]),Ut.push(Y[rt].yCoords[Rt]);if(Dt.isParent()){var Yt=t.calcBoundingBox(Dt,Y[rt].xCoords,Y[rt].yCoords,gt);Pt.push(Yt.topLeftX+Yt.width/2),Pt.push(Yt.topLeftY+Yt.height/2)}else Pt.push(Y[rt].xCoords[Ht]),Pt.push(Y[rt].yCoords[Ht]);mt.edges.push({startX:Ut[0],startY:Ut[1],endX:Pt[0],endY:Pt[1]})}else K[rt][Et.id()]&&K[rt][Dt.id()]&&mt.edges.push({startX:K[rt][Et.id()].getCenterX(),startY:K[rt][Et.id()].getCenterY(),endX:K[rt][Dt.id()].getCenterX(),endY:K[rt][Dt.id()].getCenterY()})}),mt.nodes.length>0&&(H.push(mt),w.add(rt))}});var _=m.packComponents(H,C.randomize).shifts;if(C.quality=="draft")Y.forEach(function(dt,rt){var gt=dt.xCoords.map(function(At){return At+_[rt].dx}),mt=dt.yCoords.map(function(At){return At+_[rt].dy});dt.xCoords=gt,dt.yCoords=mt});else{var ht=0;w.forEach(function(dt){Object.keys(K[dt]).forEach(function(rt){var gt=K[dt][rt];gt.setCenter(gt.getCenterX()+_[ht].dx,gt.getCenterY()+_[ht].dy)}),ht++})}}}else{var E=C.eles.boundingBox();if(it.push({x:E.x1+E.w/2,y:E.y1+E.h/2}),C.randomize){var y=s(C);Y.push(y)}C.quality=="default"||C.quality=="proof"?(K.push(f(C,Y[0])),t.relocateComponent(it[0],K[0],C)):t.relocateComponent(it[0],Y[0],C)}var Q=function(rt,gt){if(C.quality=="default"||C.quality=="proof"){typeof rt=="number"&&(rt=gt);var mt=void 0,At=void 0,Ot=rt.data("id");return K.forEach(function(Dt){Ot in Dt&&(mt={x:Dt[Ot].getRect().getCenterX(),y:Dt[Ot].getRect().getCenterY()},At=Dt[Ot])}),C.nodeDimensionsIncludeLabels&&(At.labelWidth&&(At.labelPosHorizontal=="left"?mt.x+=At.labelWidth/2:At.labelPosHorizontal=="right"&&(mt.x-=At.labelWidth/2)),At.labelHeight&&(At.labelPosVertical=="top"?mt.y+=At.labelHeight/2:At.labelPosVertical=="bottom"&&(mt.y-=At.labelHeight/2))),mt==null&&(mt={x:rt.position("x"),y:rt.position("y")}),{x:mt.x,y:mt.y}}else{var Et=void 0;return Y.forEach(function(Dt){var Rt=Dt.nodeIndexes.get(rt.id());Rt!=null&&(Et={x:Dt.xCoords[Rt],y:Dt.yCoords[Rt]})}),Et==null&&(Et={x:rt.position("x"),y:rt.position("y")}),{x:Et.x,y:Et.y}}};if(C.quality=="default"||C.quality=="proof"||C.randomize){var It=t.calcParentsWithoutChildren(G,k),Nt=k.filter(function(dt){return dt.css("display")=="none"});C.eles=k.not(Nt),k.nodes().not(":parent").not(Nt).layoutPositions(b,C,Q),It.length>0&&It.forEach(function(dt){dt.position(Q(dt))})}else console.log("If randomize option is set to false, then quality option must be 'default' or 'proof'.")}}]),d})();a.exports=v}),657:((a,e,r)=>{var l=r(548),i=r(140).layoutBase.Matrix,g=r(140).layoutBase.SVD,t=function(s){var c=s.cy,f=s.eles,T=f.nodes(),v=f.nodes(":parent"),d=new Map,L=new Map,b=new Map,C=[],G=[],k=[],Y=[],K=[],O=[],it=[],n=[],m=void 0,p=1e8,E=1e-9,y=s.piTol,R=s.samplingType,M=s.nodeSeparation,S=void 0,W=function(){for(var U=0,$=0,J=!1;$<S;){U=Math.floor(Math.random()*m),J=!1;for(var Z=0;Z<$;Z++)if(Y[Z]==U){J=!0;break}if(!J)Y[$]=U,$++;else continue}},D=function(U,$,J){for(var Z=[],at=0,ct=0,nt=0,tt=void 0,j=[],ut=0,Mt=1,pt=0;pt<m;pt++)j[pt]=p;for(Z[ct]=U,j[U]=0;ct>=at;){nt=Z[at++];for(var xt=C[nt],lt=0;lt<xt.length;lt++)tt=L.get(xt[lt]),j[tt]==p&&(j[tt]=j[nt]+1,Z[++ct]=tt);O[nt][$]=j[nt]*M}if(J){for(var ot=0;ot<m;ot++)O[ot][$]<K[ot]&&(K[ot]=O[ot][$]);for(var Lt=0;Lt<m;Lt++)K[Lt]>ut&&(ut=K[Lt],Mt=Lt)}return Mt},q=function(U){var $=void 0;if(U){$=Math.floor(Math.random()*m);for(var Z=0;Z<m;Z++)K[Z]=p;for(var at=0;at<S;at++)Y[at]=$,$=D($,at,U)}else{W();for(var J=0;J<S;J++)D(Y[J],J,U)}for(var ct=0;ct<m;ct++)for(var nt=0;nt<S;nt++)O[ct][nt]*=O[ct][nt];for(var tt=0;tt<S;tt++)it[tt]=[];for(var j=0;j<S;j++)for(var ut=0;ut<S;ut++)it[j][ut]=O[Y[ut]][j]},V=function(){for(var U=g.svd(it),$=U.S,J=U.U,Z=U.V,at=$[0]*$[0]*$[0],ct=[],nt=0;nt<S;nt++){ct[nt]=[];for(var tt=0;tt<S;tt++)ct[nt][tt]=0,nt==tt&&(ct[nt][tt]=$[nt]/($[nt]*$[nt]+at/($[nt]*$[nt])))}n=i.multMat(i.multMat(Z,ct),i.transpose(J))},X=function(){for(var U=void 0,$=void 0,J=[],Z=[],at=[],ct=[],nt=0;nt<m;nt++)J[nt]=Math.random(),Z[nt]=Math.random();J=i.normalize(J),Z=i.normalize(Z);for(var tt=E,j=E,ut=void 0;;){for(var Mt=0;Mt<m;Mt++)at[Mt]=J[Mt];if(J=i.multGamma(i.multL(i.multGamma(at),O,n)),U=i.dotProduct(at,J),J=i.normalize(J),tt=i.dotProduct(at,J),ut=Math.abs(tt/j),ut<=1+y&&ut>=1)break;j=tt}for(var pt=0;pt<m;pt++)at[pt]=J[pt];for(j=E;;){for(var xt=0;xt<m;xt++)ct[xt]=Z[xt];if(ct=i.minusOp(ct,i.multCons(at,i.dotProduct(at,ct))),Z=i.multGamma(i.multL(i.multGamma(ct),O,n)),$=i.dotProduct(ct,Z),Z=i.normalize(Z),tt=i.dotProduct(ct,Z),ut=Math.abs(tt/j),ut<=1+y&&ut>=1)break;j=tt}for(var lt=0;lt<m;lt++)ct[lt]=Z[lt];G=i.multCons(at,Math.sqrt(Math.abs(U))),k=i.multCons(ct,Math.sqrt(Math.abs($)))};l.connectComponents(c,f,l.getTopMostNodes(T),d),v.forEach(function(F){l.connectComponents(c,f,l.getTopMostNodes(F.descendants().intersection(f)),d)});for(var et=0,z=0;z<T.length;z++)T[z].isParent()||L.set(T[z].id(),et++);var w=!0,H=!1,B=void 0;try{for(var _=d.keys()[Symbol.iterator](),ht;!(w=(ht=_.next()).done);w=!0){var Q=ht.value;L.set(Q,et++)}}catch(F){H=!0,B=F}finally{try{!w&&_.return&&_.return()}finally{if(H)throw B}}for(var It=0;It<L.size;It++)C[It]=[];v.forEach(function(F){for(var U=F.children().intersection(f);U.nodes(":childless").length==0;)U=U.nodes()[0].children().intersection(f);var $=0,J=U.nodes(":childless")[0].connectedEdges().length;U.nodes(":childless").forEach(function(Z,at){Z.connectedEdges().length<J&&(J=Z.connectedEdges().length,$=at)}),b.set(F.id(),U.nodes(":childless")[$].id())}),T.forEach(function(F){var U=void 0;F.isParent()?U=L.get(b.get(F.id())):U=L.get(F.id()),F.neighborhood().nodes().forEach(function($){f.intersection(F.edgesWith($)).length>0&&($.isParent()?C[U].push(b.get($.id())):C[U].push($.id()))})});var Nt=function(U){var $=L.get(U),J=void 0;d.get(U).forEach(function(Z){c.getElementById(Z).isParent()?J=b.get(Z):J=Z,C[$].push(J),C[L.get(J)].push(U)})},dt=!0,rt=!1,gt=void 0;try{for(var mt=d.keys()[Symbol.iterator](),At;!(dt=(At=mt.next()).done);dt=!0){var Ot=At.value;Nt(Ot)}}catch(F){rt=!0,gt=F}finally{try{!dt&&mt.return&&mt.return()}finally{if(rt)throw gt}}m=L.size;var Et=void 0;if(m>2){S=m<s.sampleSize?m:s.sampleSize;for(var Dt=0;Dt<m;Dt++)O[Dt]=[];for(var Rt=0;Rt<S;Rt++)n[Rt]=[];return s.quality=="draft"||s.step=="all"?(q(R),V(),X(),Et={nodeIndexes:L,xCoords:G,yCoords:k}):(L.forEach(function(F,U){G.push(c.getElementById(U).position("x")),k.push(c.getElementById(U).position("y"))}),Et={nodeIndexes:L,xCoords:G,yCoords:k}),Et}else{var Ht=L.keys(),Ut=c.getElementById(Ht.next().value),Pt=Ut.position(),Ft=Ut.outerWidth();if(G.push(Pt.x),k.push(Pt.y),m==2){var Yt=c.getElementById(Ht.next().value),Vt=Yt.outerWidth();G.push(Pt.x+Ft/2+Vt/2+s.idealEdgeLength),k.push(Pt.y)}return Et={nodeIndexes:L,xCoords:G,yCoords:k},Et}};a.exports={spectralLayout:t}}),579:((a,e,r)=>{var l=r(212),i=function(t){t&&t("layout","fcose",l)};typeof cytoscape<"u"&&i(cytoscape),a.exports=i}),140:(a=>{a.exports=A})},N={};function u(a){var e=N[a];if(e!==void 0)return e.exports;var r=N[a]={exports:{}};return P[a](r,r.exports,u),r.exports}var h=u(579);return h})()})})(he)),he.exports}var Er=yr();const mr=Ze(Er);var xe={L:"left",R:"right",T:"top",B:"bottom"},Ie={L:vt(I=>`${I},${I/2} 0,${I} 0,0`,"L"),R:vt(I=>`0,${I/2} ${I},0 ${I},${I}`,"R"),T:vt(I=>`0,0 ${I},0 ${I/2},${I}`,"T"),B:vt(I=>`${I/2},0 ${I},${I} 0,${I}`,"B")},se={L:vt((I,x)=>I-x+2,"L"),R:vt((I,x)=>I-2,"R"),T:vt((I,x)=>I-x+2,"T"),B:vt((I,x)=>I-2,"B")},Tr=vt(function(I){return Wt(I)?I==="L"?"R":"L":I==="T"?"B":"T"},"getOppositeArchitectureDirection"),Re=vt(function(I){const x=I;return x==="L"||x==="R"||x==="T"||x==="B"},"isArchitectureDirection"),Wt=vt(function(I){const x=I;return x==="L"||x==="R"},"isArchitectureDirectionX"),qt=vt(function(I){const x=I;return x==="T"||x==="B"},"isArchitectureDirectionY"),Te=vt(function(I,x){const A=Wt(I)&&qt(x),P=qt(I)&&Wt(x);return A||P},"isArchitectureDirectionXY"),Nr=vt(function(I){const x=I[0],A=I[1],P=Wt(x)&&qt(A),N=qt(x)&&Wt(A);return P||N},"isArchitecturePairXY"),Lr=vt(function(I){return I!=="LL"&&I!=="RR"&&I!=="TT"&&I!=="BB"},"isValidArchitectureDirectionPair"),ye=vt(function(I,x){const A=`${I}${x}`;return Lr(A)?A:void 0},"getArchitectureDirectionPair"),Cr=vt(function([I,x],A){const P=A[0],N=A[1];return Wt(P)?qt(N)?[I+(P==="L"?-1:1),x+(N==="T"?1:-1)]:[I+(P==="L"?-1:1),x]:Wt(N)?[I+(N==="L"?1:-1),x+(P==="T"?1:-1)]:[I,x+(P==="T"?1:-1)]},"shiftPositionByArchitectureDirectionPair"),Ar=vt(function(I){return I==="LT"||I==="TL"?[1,1]:I==="BL"||I==="LB"?[1,-1]:I==="BR"||I==="RB"?[-1,-1]:[-1,1]},"getArchitectureDirectionXYFactors"),Mr=vt(function(I,x){return Te(I,x)?"bend":Wt(I)?"horizontal":"vertical"},"getArchitectureDirectionAlignment"),wr=vt(function(I){return I.type==="service"},"isArchitectureService"),Or=vt(function(I){return I.type==="junction"},"isArchitectureJunction"),be=vt(I=>I.data(),"edgeData"),ie=vt(I=>I.data(),"nodeData"),Dr=ar.architecture,ae,Pe=(ae=class{constructor(){this.nodes={},this.groups={},this.edges=[],this.registeredIds={},this.elements={},this.setAccTitle=Qe,this.getAccTitle=Je,this.setDiagramTitle=Ke,this.getDiagramTitle=je,this.getAccDescription=_e,this.setAccDescription=tr,this.clear()}clear(){this.nodes={},this.groups={},this.edges=[],this.registeredIds={},this.dataStructures=void 0,this.elements={},er()}addService({id:x,icon:A,in:P,title:N,iconText:u}){if(this.registeredIds[x]!==void 0)throw new Error(`The service id [${x}] is already in use by another ${this.registeredIds[x]}`);if(P!==void 0){if(x===P)throw new Error(`The service [${x}] cannot be placed within itself`);if(this.registeredIds[P]===void 0)throw new Error(`The service [${x}]'s parent does not exist. Please make sure the parent is created before this service`);if(this.registeredIds[P]==="node")throw new Error(`The service [${x}]'s parent is not a group`)}this.registeredIds[x]="node",this.nodes[x]={id:x,type:"service",icon:A,iconText:u,title:N,edges:[],in:P}}getServices(){return Object.values(this.nodes).filter(wr)}addJunction({id:x,in:A}){this.registeredIds[x]="node",this.nodes[x]={id:x,type:"junction",edges:[],in:A}}getJunctions(){return Object.values(this.nodes).filter(Or)}getNodes(){return Object.values(this.nodes)}getNode(x){return this.nodes[x]??null}addGroup({id:x,icon:A,in:P,title:N}){if(this.registeredIds?.[x]!==void 0)throw new Error(`The group id [${x}] is already in use by another ${this.registeredIds[x]}`);if(P!==void 0){if(x===P)throw new Error(`The group [${x}] cannot be placed within itself`);if(this.registeredIds?.[P]===void 0)throw new Error(`The group [${x}]'s parent does not exist. Please make sure the parent is created before this group`);if(this.registeredIds?.[P]==="node")throw new Error(`The group [${x}]'s parent is not a group`)}this.registeredIds[x]="group",this.groups[x]={id:x,icon:A,title:N,in:P}}getGroups(){return Object.values(this.groups)}addEdge({lhsId:x,rhsId:A,lhsDir:P,rhsDir:N,lhsInto:u,rhsInto:h,lhsGroup:a,rhsGroup:e,title:r}){if(!Re(P))throw new Error(`Invalid direction given for left hand side of edge ${x}--${A}. Expected (L,R,T,B) got ${String(P)}`);if(!Re(N))throw new Error(`Invalid direction given for right hand side of edge ${x}--${A}. Expected (L,R,T,B) got ${String(N)}`);if(this.nodes[x]===void 0&&this.groups[x]===void 0)throw new Error(`The left-hand id [${x}] does not yet exist. Please create the service/group before declaring an edge to it.`);if(this.nodes[A]===void 0&&this.groups[A]===void 0)throw new Error(`The right-hand id [${A}] does not yet exist. Please create the service/group before declaring an edge to it.`);const l=this.nodes[x].in,i=this.nodes[A].in;if(a&&l&&i&&l==i)throw new Error(`The left-hand id [${x}] is modified to traverse the group boundary, but the edge does not pass through two groups.`);if(e&&l&&i&&l==i)throw new Error(`The right-hand id [${A}] is modified to traverse the group boundary, but the edge does not pass through two groups.`);const g={lhsId:x,lhsDir:P,lhsInto:u,lhsGroup:a,rhsId:A,rhsDir:N,rhsInto:h,rhsGroup:e,title:r};this.edges.push(g),this.nodes[x]&&this.nodes[A]&&(this.nodes[x].edges.push(this.edges[this.edges.length-1]),this.nodes[A].edges.push(this.edges[this.edges.length-1]))}getEdges(){return this.edges}getDataStructures(){if(this.dataStructures===void 0){const x={},A=Object.entries(this.nodes).reduce((e,[r,l])=>(e[r]=l.edges.reduce((i,g)=>{const t=this.getNode(g.lhsId)?.in,o=this.getNode(g.rhsId)?.in;if(t&&o&&t!==o){const s=Mr(g.lhsDir,g.rhsDir);s!=="bend"&&(x[t]??={},x[t][o]=s,x[o]??={},x[o][t]=s)}if(g.lhsId===r){const s=ye(g.lhsDir,g.rhsDir);s&&(i[s]=g.rhsId)}else{const s=ye(g.rhsDir,g.lhsDir);s&&(i[s]=g.lhsId)}return i},{}),e),{}),P=Object.keys(A)[0],N={[P]:1},u=Object.keys(A).reduce((e,r)=>r===P?e:{...e,[r]:1},{}),h=vt(e=>{const r={[e]:[0,0]},l=[e];for(;l.length>0;){const i=l.shift();if(i){N[i]=1,delete u[i];const g=A[i],[t,o]=r[i];Object.entries(g).forEach(([s,c])=>{N[c]||(r[c]=Cr([t,o],s),l.push(c))})}}return r},"BFS"),a=[h(P)];for(;Object.keys(u).length>0;)a.push(h(Object.keys(u)[0]));this.dataStructures={adjList:A,spatialMaps:a,groupAlignments:x}}return this.dataStructures}setElementForId(x,A){this.elements[x]=A}getElementById(x){return this.elements[x]}getConfig(){return rr({...Dr,...ir().architecture})}getConfigField(x){return this.getConfig()[x]}},vt(ae,"ArchitectureDB"),ae),xr=vt((I,x)=>{fr(I,x),I.groups.map(A=>x.addGroup(A)),I.services.map(A=>x.addService({...A,type:"service"})),I.junctions.map(A=>x.addJunction({...A,type:"junction"})),I.edges.map(A=>x.addEdge(A))},"populateDb"),Ge={parser:{yy:void 0},parse:vt(async I=>{const x=await cr("architecture",I);Se.debug(x);const A=Ge.parser?.yy;if(!(A instanceof Pe))throw new Error("parser.parser?.yy was not a ArchitectureDB. This is due to a bug within Mermaid, please report this issue at https://github.com/mermaid-js/mermaid/issues.");xr(x,A)},"parse")},Ir=vt(I=>`
-  .edge {
-    stroke-width: ${I.archEdgeWidth};
-    stroke: ${I.archEdgeColor};
-    fill: none;
-  }
-
-  .arrow {
-    fill: ${I.archEdgeArrowColor};
-  }
-
-  .node-bkg {
-    fill: none;
-    stroke: ${I.archGroupBorderColor};
-    stroke-width: ${I.archGroupBorderWidth};
-    stroke-dasharray: 8;
-  }
-  .node-icon-text {
-    display: flex; 
-    align-items: center;
-  }
-  
-  .node-icon-text > div {
-    color: #fff;
-    margin: 1px;
-    height: fit-content;
-    text-align: center;
-    overflow: hidden;
-    display: -webkit-box;
-    -webkit-box-orient: vertical;
-  }
-`,"getStyles"),Rr=Ir,re=vt(I=>`<g><rect width="80" height="80" style="fill: #087ebf; stroke-width: 0px;"/>${I}</g>`,"wrapIcon"),ne={prefix:"mermaid-architecture",height:80,width:80,icons:{database:{body:re('<path id="b" data-name="4" d="m20,57.86c0,3.94,8.95,7.14,20,7.14s20-3.2,20-7.14" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><path id="c" data-name="3" d="m20,45.95c0,3.94,8.95,7.14,20,7.14s20-3.2,20-7.14" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><path id="d" data-name="2" d="m20,34.05c0,3.94,8.95,7.14,20,7.14s20-3.2,20-7.14" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><ellipse id="e" data-name="1" cx="40" cy="22.14" rx="20" ry="7.14" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><line x1="20" y1="57.86" x2="20" y2="22.14" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><line x1="60" y1="57.86" x2="60" y2="22.14" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/>')},server:{body:re('<rect x="17.5" y="17.5" width="45" height="45" rx="2" ry="2" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><line x1="17.5" y1="32.5" x2="62.5" y2="32.5" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><line x1="17.5" y1="47.5" x2="62.5" y2="47.5" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><g><path d="m56.25,25c0,.27-.45.5-1,.5h-10.5c-.55,0-1-.23-1-.5s.45-.5,1-.5h10.5c.55,0,1,.23,1,.5Z" style="fill: #fff; stroke-width: 0px;"/><path d="m56.25,25c0,.27-.45.5-1,.5h-10.5c-.55,0-1-.23-1-.5s.45-.5,1-.5h10.5c.55,0,1,.23,1,.5Z" style="fill: none; stroke: #fff; stroke-miterlimit: 10;"/></g><g><path d="m56.25,40c0,.27-.45.5-1,.5h-10.5c-.55,0-1-.23-1-.5s.45-.5,1-.5h10.5c.55,0,1,.23,1,.5Z" style="fill: #fff; stroke-width: 0px;"/><path d="m56.25,40c0,.27-.45.5-1,.5h-10.5c-.55,0-1-.23-1-.5s.45-.5,1-.5h10.5c.55,0,1,.23,1,.5Z" style="fill: none; stroke: #fff; stroke-miterlimit: 10;"/></g><g><path d="m56.25,55c0,.27-.45.5-1,.5h-10.5c-.55,0-1-.23-1-.5s.45-.5,1-.5h10.5c.55,0,1,.23,1,.5Z" style="fill: #fff; stroke-width: 0px;"/><path d="m56.25,55c0,.27-.45.5-1,.5h-10.5c-.55,0-1-.23-1-.5s.45-.5,1-.5h10.5c.55,0,1,.23,1,.5Z" style="fill: none; stroke: #fff; stroke-miterlimit: 10;"/></g><g><circle cx="32.5" cy="25" r=".75" style="fill: #fff; stroke: #fff; stroke-miterlimit: 10;"/><circle cx="27.5" cy="25" r=".75" style="fill: #fff; stroke: #fff; stroke-miterlimit: 10;"/><circle cx="22.5" cy="25" r=".75" style="fill: #fff; stroke: #fff; stroke-miterlimit: 10;"/></g><g><circle cx="32.5" cy="40" r=".75" style="fill: #fff; stroke: #fff; stroke-miterlimit: 10;"/><circle cx="27.5" cy="40" r=".75" style="fill: #fff; stroke: #fff; stroke-miterlimit: 10;"/><circle cx="22.5" cy="40" r=".75" style="fill: #fff; stroke: #fff; stroke-miterlimit: 10;"/></g><g><circle cx="32.5" cy="55" r=".75" style="fill: #fff; stroke: #fff; stroke-miterlimit: 10;"/><circle cx="27.5" cy="55" r=".75" style="fill: #fff; stroke: #fff; stroke-miterlimit: 10;"/><circle cx="22.5" cy="55" r=".75" style="fill: #fff; stroke: #fff; stroke-miterlimit: 10;"/></g>')},disk:{body:re('<rect x="20" y="15" width="40" height="50" rx="1" ry="1" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><ellipse cx="24" cy="19.17" rx=".8" ry=".83" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><ellipse cx="56" cy="19.17" rx=".8" ry=".83" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><ellipse cx="24" cy="60.83" rx=".8" ry=".83" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><ellipse cx="56" cy="60.83" rx=".8" ry=".83" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><ellipse cx="40" cy="33.75" rx="14" ry="14.58" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><ellipse cx="40" cy="33.75" rx="4" ry="4.17" style="fill: #fff; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><path d="m37.51,42.52l-4.83,13.22c-.26.71-1.1,1.02-1.76.64l-4.18-2.42c-.66-.38-.81-1.26-.33-1.84l9.01-10.8c.88-1.05,2.56-.08,2.09,1.2Z" style="fill: #fff; stroke-width: 0px;"/>')},internet:{body:re('<circle cx="40" cy="40" r="22.5" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><line x1="40" y1="17.5" x2="40" y2="62.5" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><line x1="17.5" y1="40" x2="62.5" y2="40" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><path d="m39.99,17.51c-15.28,11.1-15.28,33.88,0,44.98" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><path d="m40.01,17.51c15.28,11.1,15.28,33.88,0,44.98" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><line x1="19.75" y1="30.1" x2="60.25" y2="30.1" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/><line x1="19.75" y1="49.9" x2="60.25" y2="49.9" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/>')},cloud:{body:re('<path d="m65,47.5c0,2.76-2.24,5-5,5H20c-2.76,0-5-2.24-5-5,0-1.87,1.03-3.51,2.56-4.36-.04-.21-.06-.42-.06-.64,0-2.6,2.48-4.74,5.65-4.97,1.65-4.51,6.34-7.76,11.85-7.76.86,0,1.69.08,2.5.23,2.09-1.57,4.69-2.5,7.5-2.5,6.1,0,11.19,4.38,12.28,10.17,2.14.56,3.72,2.51,3.72,4.83,0,.03,0,.07-.01.1,2.29.46,4.01,2.48,4.01,4.9Z" style="fill: none; stroke: #fff; stroke-miterlimit: 10; stroke-width: 2px;"/>')},unknown:lr,blank:{body:re("")}}},Sr=vt(async function(I,x,A){const P=A.getConfigField("padding"),N=A.getConfigField("iconSize"),u=N/2,h=N/6,a=h/2;await Promise.all(x.edges().map(async e=>{const{source:r,sourceDir:l,sourceArrow:i,sourceGroup:g,target:t,targetDir:o,targetArrow:s,targetGroup:c,label:f}=be(e);let{x:T,y:v}=e[0].sourceEndpoint();const{x:d,y:L}=e[0].midpoint();let{x:b,y:C}=e[0].targetEndpoint();const G=P+4;if(g&&(Wt(l)?T+=l==="L"?-G:G:v+=l==="T"?-G:G+18),c&&(Wt(o)?b+=o==="L"?-G:G:C+=o==="T"?-G:G+18),!g&&A.getNode(r)?.type==="junction"&&(Wt(l)?T+=l==="L"?u:-u:v+=l==="T"?u:-u),!c&&A.getNode(t)?.type==="junction"&&(Wt(o)?b+=o==="L"?u:-u:C+=o==="T"?u:-u),e[0]._private.rscratch){const k=I.insert("g");if(k.insert("path").attr("d",`M ${T},${v} L ${d},${L} L${b},${C} `).attr("class","edge").attr("id",sr(r,t,{prefix:"L"})),i){const Y=Wt(l)?se[l](T,h):T-a,K=qt(l)?se[l](v,h):v-a;k.insert("polygon").attr("points",Ie[l](h)).attr("transform",`translate(${Y},${K})`).attr("class","arrow")}if(s){const Y=Wt(o)?se[o](b,h):b-a,K=qt(o)?se[o](C,h):C-a;k.insert("polygon").attr("points",Ie[o](h)).attr("transform",`translate(${Y},${K})`).attr("class","arrow")}if(f){const Y=Te(l,o)?"XY":Wt(l)?"X":"Y";let K=0;Y==="X"?K=Math.abs(T-b):Y==="Y"?K=Math.abs(v-C)/1.5:K=Math.abs(T-b)/2;const O=k.append("g");if(await me(O,f,{useHtmlLabels:!1,width:K,classes:"architecture-service-label"},Ee()),O.attr("dy","1em").attr("alignment-baseline","middle").attr("dominant-baseline","middle").attr("text-anchor","middle"),Y==="X")O.attr("transform","translate("+d+", "+L+")");else if(Y==="Y")O.attr("transform","translate("+d+", "+L+") rotate(-90)");else if(Y==="XY"){const it=ye(l,o);if(it&&Nr(it)){const n=O.node().getBoundingClientRect(),[m,p]=Ar(it);O.attr("dominant-baseline","auto").attr("transform",`rotate(${-1*m*p*45})`);const E=O.node().getBoundingClientRect();O.attr("transform",`
-                translate(${d}, ${L-n.height/2})
-                translate(${m*E.width/2}, ${p*E.height/2})
-                rotate(${-1*m*p*45}, 0, ${n.height/2})
-              `)}}}}}))},"drawEdges"),Fr=vt(async function(I,x,A){const N=A.getConfigField("padding")*.75,u=A.getConfigField("fontSize"),a=A.getConfigField("iconSize")/2;await Promise.all(x.nodes().map(async e=>{const r=ie(e);if(r.type==="group"){const{h:l,w:i,x1:g,y1:t}=e.boundingBox(),o=I.append("rect");o.attr("id",`group-${r.id}`).attr("x",g+a).attr("y",t+a).attr("width",i).attr("height",l).attr("class","node-bkg");const s=I.append("g");let c=g,f=t;if(r.icon){const T=s.append("g");T.html(`<g>${await pe(r.icon,{height:N,width:N,fallbackPrefix:ne.prefix})}</g>`),T.attr("transform","translate("+(c+a+1)+", "+(f+a+1)+")"),c+=N,f+=u/2-1-2}if(r.label){const T=s.append("g");await me(T,r.label,{useHtmlLabels:!1,width:i,classes:"architecture-service-label"},Ee()),T.attr("dy","1em").attr("alignment-baseline","middle").attr("dominant-baseline","start").attr("text-anchor","start"),T.attr("transform","translate("+(c+a+4)+", "+(f+a+2)+")")}A.setElementForId(r.id,o)}}))},"drawGroups"),br=vt(async function(I,x,A){const P=Ee();for(const N of A){const u=x.append("g"),h=I.getConfigField("iconSize");if(N.title){const l=u.append("g");await me(l,N.title,{useHtmlLabels:!1,width:h*1.5,classes:"architecture-service-label"},P),l.attr("dy","1em").attr("alignment-baseline","middle").attr("dominant-baseline","middle").attr("text-anchor","middle"),l.attr("transform","translate("+h/2+", "+h+")")}const a=u.append("g");if(N.icon)a.html(`<g>${await pe(N.icon,{height:h,width:h,fallbackPrefix:ne.prefix})}</g>`);else if(N.iconText){a.html(`<g>${await pe("blank",{height:h,width:h,fallbackPrefix:ne.prefix})}</g>`);const g=a.append("g").append("foreignObject").attr("width",h).attr("height",h).append("div").attr("class","node-icon-text").attr("style",`height: ${h}px;`).append("div").html(nr(N.iconText,P)),t=parseInt(window.getComputedStyle(g.node(),null).getPropertyValue("font-size").replace(/\D/g,""))??16;g.attr("style",`-webkit-line-clamp: ${Math.floor((h-2)/t)};`)}else a.append("path").attr("class","node-bkg").attr("id","node-"+N.id).attr("d",`M0 ${h} v${-h} q0,-5 5,-5 h${h} q5,0 5,5 v${h} H0 Z`);u.attr("id",`service-${N.id}`).attr("class","architecture-service");const{width:e,height:r}=u.node().getBBox();N.width=e,N.height=r,I.setElementForId(N.id,u)}return 0},"drawServices"),Pr=vt(function(I,x,A){A.forEach(P=>{const N=x.append("g"),u=I.getConfigField("iconSize");N.append("g").append("rect").attr("id","node-"+P.id).attr("fill-opacity","0").attr("width",u).attr("height",u),N.attr("class","architecture-junction");const{width:a,height:e}=N._groups[0][0].getBBox();N.width=a,N.height=e,I.setElementForId(P.id,N)})},"drawJunctions");hr([{name:ne.prefix,icons:ne}]);Fe.use(mr);function Ue(I,x,A){I.forEach(P=>{x.add({group:"nodes",data:{type:"service",id:P.id,icon:P.icon,label:P.title,parent:P.in,width:A.getConfigField("iconSize"),height:A.getConfigField("iconSize")},classes:"node-service"})})}vt(Ue,"addServices");function Ye(I,x,A){I.forEach(P=>{x.add({group:"nodes",data:{type:"junction",id:P.id,parent:P.in,width:A.getConfigField("iconSize"),height:A.getConfigField("iconSize")},classes:"node-junction"})})}vt(Ye,"addJunctions");function Xe(I,x){x.nodes().map(A=>{const P=ie(A);if(P.type==="group")return;P.x=A.position().x,P.y=A.position().y,I.getElementById(P.id).attr("transform","translate("+(P.x||0)+","+(P.y||0)+")")})}vt(Xe,"positionNodes");function He(I,x){I.forEach(A=>{x.add({group:"nodes",data:{type:"group",id:A.id,icon:A.icon,label:A.title,parent:A.in},classes:"node-group"})})}vt(He,"addGroups");function We(I,x){I.forEach(A=>{const{lhsId:P,rhsId:N,lhsInto:u,lhsGroup:h,rhsInto:a,lhsDir:e,rhsDir:r,rhsGroup:l,title:i}=A,g=Te(A.lhsDir,A.rhsDir)?"segments":"straight",t={id:`${P}-${N}`,label:i,source:P,sourceDir:e,sourceArrow:u,sourceGroup:h,sourceEndpoint:e==="L"?"0 50%":e==="R"?"100% 50%":e==="T"?"50% 0":"50% 100%",target:N,targetDir:r,targetArrow:a,targetGroup:l,targetEndpoint:r==="L"?"0 50%":r==="R"?"100% 50%":r==="T"?"50% 0":"50% 100%"};x.add({group:"edges",data:t,classes:g})})}vt(We,"addEdges");function Ve(I,x,A){const P=vt((a,e)=>Object.entries(a).reduce((r,[l,i])=>{let g=0;const t=Object.entries(i);if(t.length===1)return r[l]=t[0][1],r;for(let o=0;o<t.length-1;o++)for(let s=o+1;s<t.length;s++){const[c,f]=t[o],[T,v]=t[s];if(A[c]?.[T]===e)r[l]??=[],r[l]=[...r[l],...f,...v];else if(c==="default"||T==="default")r[l]??=[],r[l]=[...r[l],...f,...v];else{const L=`${l}-${g++}`;r[L]=f;const b=`${l}-${g++}`;r[b]=v}}return r},{}),"flattenAlignments"),N=x.map(a=>{const e={},r={};return Object.entries(a).forEach(([l,[i,g]])=>{const t=I.getNode(l)?.in??"default";e[g]??={},e[g][t]??=[],e[g][t].push(l),r[i]??={},r[i][t]??=[],r[i][t].push(l)}),{horiz:Object.values(P(e,"horizontal")).filter(l=>l.length>1),vert:Object.values(P(r,"vertical")).filter(l=>l.length>1)}}),[u,h]=N.reduce(([a,e],{horiz:r,vert:l})=>[[...a,...r],[...e,...l]],[[],[]]);return{horizontal:u,vertical:h}}vt(Ve,"getAlignments");function ze(I,x){const A=[],P=vt(u=>`${u[0]},${u[1]}`,"posToStr"),N=vt(u=>u.split(",").map(h=>parseInt(h)),"strToPos");return I.forEach(u=>{const h=Object.fromEntries(Object.entries(u).map(([l,i])=>[P(i),l])),a=[P([0,0])],e={},r={L:[-1,0],R:[1,0],T:[0,1],B:[0,-1]};for(;a.length>0;){const l=a.shift();if(l){e[l]=1;const i=h[l];if(i){const g=N(l);Object.entries(r).forEach(([t,o])=>{const s=P([g[0]+o[0],g[1]+o[1]]),c=h[s];c&&!e[s]&&(a.push(s),A.push({[xe[t]]:c,[xe[Tr(t)]]:i,gap:1.5*x.getConfigField("iconSize")}))})}}}}),A}vt(ze,"getRelativeConstraints");function Be(I,x,A,P,N,{spatialMaps:u,groupAlignments:h}){return new Promise(a=>{const e=or("body").append("div").attr("id","cy").attr("style","display:none"),r=Fe({container:document.getElementById("cy"),style:[{selector:"edge",style:{"curve-style":"straight",label:"data(label)","source-endpoint":"data(sourceEndpoint)","target-endpoint":"data(targetEndpoint)"}},{selector:"edge.segments",style:{"curve-style":"segments","segment-weights":"0","segment-distances":[.5],"edge-distances":"endpoints","source-endpoint":"data(sourceEndpoint)","target-endpoint":"data(targetEndpoint)"}},{selector:"node",style:{"compound-sizing-wrt-labels":"include"}},{selector:"node[label]",style:{"text-valign":"bottom","text-halign":"center","font-size":`${N.getConfigField("fontSize")}px`}},{selector:".node-service",style:{label:"data(label)",width:"data(width)",height:"data(height)"}},{selector:".node-junction",style:{width:"data(width)",height:"data(height)"}},{selector:".node-group",style:{padding:`${N.getConfigField("padding")}px`}}],layout:{name:"grid",boundingBox:{x1:0,x2:100,y1:0,y2:100}}});e.remove(),He(A,r),Ue(I,r,N),Ye(x,r,N),We(P,r);const l=Ve(N,u,h),i=ze(u,N),g=r.layout({name:"fcose",quality:"proof",styleEnabled:!1,animate:!1,nodeDimensionsIncludeLabels:!1,idealEdgeLength(t){const[o,s]=t.connectedNodes(),{parent:c}=ie(o),{parent:f}=ie(s);return c===f?1.5*N.getConfigField("iconSize"):.5*N.getConfigField("iconSize")},edgeElasticity(t){const[o,s]=t.connectedNodes(),{parent:c}=ie(o),{parent:f}=ie(s);return c===f?.45:.001},alignmentConstraint:l,relativePlacementConstraint:i});g.one("layoutstop",()=>{function t(o,s,c,f){let T,v;const{x:d,y:L}=o,{x:b,y:C}=s;v=(f-L+(d-c)*(L-C)/(d-b))/Math.sqrt(1+Math.pow((L-C)/(d-b),2)),T=Math.sqrt(Math.pow(f-L,2)+Math.pow(c-d,2)-Math.pow(v,2));const G=Math.sqrt(Math.pow(b-d,2)+Math.pow(C-L,2));T=T/G;let k=(b-d)*(f-L)-(C-L)*(c-d);switch(!0){case k>=0:k=1;break;case k<0:k=-1;break}let Y=(b-d)*(c-d)+(C-L)*(f-L);switch(!0){case Y>=0:Y=1;break;case Y<0:Y=-1;break}return v=Math.abs(v)*k,T=T*Y,{distances:v,weights:T}}vt(t,"getSegmentWeights"),r.startBatch();for(const o of Object.values(r.edges()))if(o.data?.()){const{x:s,y:c}=o.source().position(),{x:f,y:T}=o.target().position();if(s!==f&&c!==T){const v=o.sourceEndpoint(),d=o.targetEndpoint(),{sourceDir:L}=be(o),[b,C]=qt(L)?[v.x,d.y]:[d.x,v.y],{weights:G,distances:k}=t(v,d,b,C);o.style("segment-distances",k),o.style("segment-weights",G)}}r.endBatch(),g.run()}),g.run(),r.ready(t=>{Se.info("Ready",t),a(r)})})}vt(Be,"layoutArchitecture");var Gr=vt(async(I,x,A,P)=>{const N=P.db,u=N.getServices(),h=N.getJunctions(),a=N.getGroups(),e=N.getEdges(),r=N.getDataStructures(),l=ke(x),i=l.append("g");i.attr("class","architecture-edges");const g=l.append("g");g.attr("class","architecture-services");const t=l.append("g");t.attr("class","architecture-groups"),await br(N,g,u),Pr(N,g,h);const o=await Be(u,h,a,e,N,r);await Sr(i,o,N),await Fr(t,o,N),Xe(N,o),qe(void 0,l,N.getConfigField("padding"),N.getConfigField("useMaxWidth"))},"draw"),Ur={draw:Gr},$r={parser:Ge,get db(){return new Pe},renderer:Ur,styles:Rr};export{$r as diagram};
diff --git a/docs/dist/assets/blockDiagram-VD42YOAC-RS0Yvfs6.js b/docs/dist/assets/blockDiagram-VD42YOAC-RS0Yvfs6.js
deleted file mode 100644
index 6e4f8933..00000000
--- a/docs/dist/assets/blockDiagram-VD42YOAC-RS0Yvfs6.js
+++ /dev/null
@@ -1,122 +0,0 @@
-import{g as oe}from"./chunk-FMBD7UC4-Bm3lI1XN.js";import{_ as d,E as rt,d as O,e as he,l as L,y as de,A as ge,c as R,ai as ue,R as pe,S as fe,O as xe,aj as j,ak as Wt,al as ye,u as $,k as be,am as we,an as xt,i as yt,ao as me}from"./index-BxX29htg.js";import{c as Le}from"./clone-BRV0rZiZ.js";import{G as Se}from"./graph-DQwMrrst.js";import{c as ke}from"./channel-kd1Rx1KT.js";import"./_baseUniq-CfjWcJYV.js";var bt=(function(){var e=d(function(D,y,g,f){for(g=g||{},f=D.length;f--;g[D[f]]=y);return g},"o"),t=[1,15],a=[1,7],i=[1,13],l=[1,14],s=[1,19],r=[1,16],n=[1,17],c=[1,18],u=[8,30],o=[8,10,21,28,29,30,31,39,43,46],x=[1,23],w=[1,24],b=[8,10,15,16,21,28,29,30,31,39,43,46],S=[8,10,15,16,21,27,28,29,30,31,39,43,46],v=[1,49],k={trace:d(function(){},"trace"),yy:{},symbols_:{error:2,spaceLines:3,SPACELINE:4,NL:5,separator:6,SPACE:7,EOF:8,start:9,BLOCK_DIAGRAM_KEY:10,document:11,stop:12,statement:13,link:14,LINK:15,START_LINK:16,LINK_LABEL:17,STR:18,nodeStatement:19,columnsStatement:20,SPACE_BLOCK:21,blockStatement:22,classDefStatement:23,cssClassStatement:24,styleStatement:25,node:26,SIZE:27,COLUMNS:28,"id-block":29,end:30,NODE_ID:31,nodeShapeNLabel:32,dirList:33,DIR:34,NODE_DSTART:35,NODE_DEND:36,BLOCK_ARROW_START:37,BLOCK_ARROW_END:38,classDef:39,CLASSDEF_ID:40,CLASSDEF_STYLEOPTS:41,DEFAULT:42,class:43,CLASSENTITY_IDS:44,STYLECLASS:45,style:46,STYLE_ENTITY_IDS:47,STYLE_DEFINITION_DATA:48,$accept:0,$end:1},terminals_:{2:"error",4:"SPACELINE",5:"NL",7:"SPACE",8:"EOF",10:"BLOCK_DIAGRAM_KEY",15:"LINK",16:"START_LINK",17:"LINK_LABEL",18:"STR",21:"SPACE_BLOCK",27:"SIZE",28:"COLUMNS",29:"id-block",30:"end",31:"NODE_ID",34:"DIR",35:"NODE_DSTART",36:"NODE_DEND",37:"BLOCK_ARROW_START",38:"BLOCK_ARROW_END",39:"classDef",40:"CLASSDEF_ID",41:"CLASSDEF_STYLEOPTS",42:"DEFAULT",43:"class",44:"CLASSENTITY_IDS",45:"STYLECLASS",46:"style",47:"STYLE_ENTITY_IDS",48:"STYLE_DEFINITION_DATA"},productions_:[0,[3,1],[3,2],[3,2],[6,1],[6,1],[6,1],[9,3],[12,1],[12,1],[12,2],[12,2],[11,1],[11,2],[14,1],[14,4],[13,1],[13,1],[13,1],[13,1],[13,1],[13,1],[13,1],[19,3],[19,2],[19,1],[20,1],[22,4],[22,3],[26,1],[26,2],[33,1],[33,2],[32,3],[32,4],[23,3],[23,3],[24,3],[25,3]],performAction:d(function(y,g,f,m,E,h,W){var p=h.length-1;switch(E){case 4:m.getLogger().debug("Rule: separator (NL) ");break;case 5:m.getLogger().debug("Rule: separator (Space) ");break;case 6:m.getLogger().debug("Rule: separator (EOF) ");break;case 7:m.getLogger().debug("Rule: hierarchy: ",h[p-1]),m.setHierarchy(h[p-1]);break;case 8:m.getLogger().debug("Stop NL ");break;case 9:m.getLogger().debug("Stop EOF ");break;case 10:m.getLogger().debug("Stop NL2 ");break;case 11:m.getLogger().debug("Stop EOF2 ");break;case 12:m.getLogger().debug("Rule: statement: ",h[p]),typeof h[p].length=="number"?this.$=h[p]:this.$=[h[p]];break;case 13:m.getLogger().debug("Rule: statement #2: ",h[p-1]),this.$=[h[p-1]].concat(h[p]);break;case 14:m.getLogger().debug("Rule: link: ",h[p],y),this.$={edgeTypeStr:h[p],label:""};break;case 15:m.getLogger().debug("Rule: LABEL link: ",h[p-3],h[p-1],h[p]),this.$={edgeTypeStr:h[p],label:h[p-1]};break;case 18:const I=parseInt(h[p]),Z=m.generateId();this.$={id:Z,type:"space",label:"",width:I,children:[]};break;case 23:m.getLogger().debug("Rule: (nodeStatement link node) ",h[p-2],h[p-1],h[p]," typestr: ",h[p-1].edgeTypeStr);const V=m.edgeStrToEdgeData(h[p-1].edgeTypeStr);this.$=[{id:h[p-2].id,label:h[p-2].label,type:h[p-2].type,directions:h[p-2].directions},{id:h[p-2].id+"-"+h[p].id,start:h[p-2].id,end:h[p].id,label:h[p-1].label,type:"edge",directions:h[p].directions,arrowTypeEnd:V,arrowTypeStart:"arrow_open"},{id:h[p].id,label:h[p].label,type:m.typeStr2Type(h[p].typeStr),directions:h[p].directions}];break;case 24:m.getLogger().debug("Rule: nodeStatement (abc88 node size) ",h[p-1],h[p]),this.$={id:h[p-1].id,label:h[p-1].label,type:m.typeStr2Type(h[p-1].typeStr),directions:h[p-1].directions,widthInColumns:parseInt(h[p],10)};break;case 25:m.getLogger().debug("Rule: nodeStatement (node) ",h[p]),this.$={id:h[p].id,label:h[p].label,type:m.typeStr2Type(h[p].typeStr),directions:h[p].directions,widthInColumns:1};break;case 26:m.getLogger().debug("APA123",this?this:"na"),m.getLogger().debug("COLUMNS: ",h[p]),this.$={type:"column-setting",columns:h[p]==="auto"?-1:parseInt(h[p])};break;case 27:m.getLogger().debug("Rule: id-block statement : ",h[p-2],h[p-1]),m.generateId(),this.$={...h[p-2],type:"composite",children:h[p-1]};break;case 28:m.getLogger().debug("Rule: blockStatement : ",h[p-2],h[p-1],h[p]);const at=m.generateId();this.$={id:at,type:"composite",label:"",children:h[p-1]};break;case 29:m.getLogger().debug("Rule: node (NODE_ID separator): ",h[p]),this.$={id:h[p]};break;case 30:m.getLogger().debug("Rule: node (NODE_ID nodeShapeNLabel separator): ",h[p-1],h[p]),this.$={id:h[p-1],label:h[p].label,typeStr:h[p].typeStr,directions:h[p].directions};break;case 31:m.getLogger().debug("Rule: dirList: ",h[p]),this.$=[h[p]];break;case 32:m.getLogger().debug("Rule: dirList: ",h[p-1],h[p]),this.$=[h[p-1]].concat(h[p]);break;case 33:m.getLogger().debug("Rule: nodeShapeNLabel: ",h[p-2],h[p-1],h[p]),this.$={typeStr:h[p-2]+h[p],label:h[p-1]};break;case 34:m.getLogger().debug("Rule: BLOCK_ARROW nodeShapeNLabel: ",h[p-3],h[p-2]," #3:",h[p-1],h[p]),this.$={typeStr:h[p-3]+h[p],label:h[p-2],directions:h[p-1]};break;case 35:case 36:this.$={type:"classDef",id:h[p-1].trim(),css:h[p].trim()};break;case 37:this.$={type:"applyClass",id:h[p-1].trim(),styleClass:h[p].trim()};break;case 38:this.$={type:"applyStyles",id:h[p-1].trim(),stylesStr:h[p].trim()};break}},"anonymous"),table:[{9:1,10:[1,2]},{1:[3]},{10:t,11:3,13:4,19:5,20:6,21:a,22:8,23:9,24:10,25:11,26:12,28:i,29:l,31:s,39:r,43:n,46:c},{8:[1,20]},e(u,[2,12],{13:4,19:5,20:6,22:8,23:9,24:10,25:11,26:12,11:21,10:t,21:a,28:i,29:l,31:s,39:r,43:n,46:c}),e(o,[2,16],{14:22,15:x,16:w}),e(o,[2,17]),e(o,[2,18]),e(o,[2,19]),e(o,[2,20]),e(o,[2,21]),e(o,[2,22]),e(b,[2,25],{27:[1,25]}),e(o,[2,26]),{19:26,26:12,31:s},{10:t,11:27,13:4,19:5,20:6,21:a,22:8,23:9,24:10,25:11,26:12,28:i,29:l,31:s,39:r,43:n,46:c},{40:[1,28],42:[1,29]},{44:[1,30]},{47:[1,31]},e(S,[2,29],{32:32,35:[1,33],37:[1,34]}),{1:[2,7]},e(u,[2,13]),{26:35,31:s},{31:[2,14]},{17:[1,36]},e(b,[2,24]),{10:t,11:37,13:4,14:22,15:x,16:w,19:5,20:6,21:a,22:8,23:9,24:10,25:11,26:12,28:i,29:l,31:s,39:r,43:n,46:c},{30:[1,38]},{41:[1,39]},{41:[1,40]},{45:[1,41]},{48:[1,42]},e(S,[2,30]),{18:[1,43]},{18:[1,44]},e(b,[2,23]),{18:[1,45]},{30:[1,46]},e(o,[2,28]),e(o,[2,35]),e(o,[2,36]),e(o,[2,37]),e(o,[2,38]),{36:[1,47]},{33:48,34:v},{15:[1,50]},e(o,[2,27]),e(S,[2,33]),{38:[1,51]},{33:52,34:v,38:[2,31]},{31:[2,15]},e(S,[2,34]),{38:[2,32]}],defaultActions:{20:[2,7],23:[2,14],50:[2,15],52:[2,32]},parseError:d(function(y,g){if(g.recoverable)this.trace(y);else{var f=new Error(y);throw f.hash=g,f}},"parseError"),parse:d(function(y){var g=this,f=[0],m=[],E=[null],h=[],W=this.table,p="",I=0,Z=0,V=2,at=1,ne=h.slice.call(arguments,1),z=Object.create(this.lexer),q={yy:{}};for(var gt in this.yy)Object.prototype.hasOwnProperty.call(this.yy,gt)&&(q.yy[gt]=this.yy[gt]);z.setInput(y,q.yy),q.yy.lexer=z,q.yy.parser=this,typeof z.yylloc>"u"&&(z.yylloc={});var ut=z.yylloc;h.push(ut);var le=z.options&&z.options.ranges;typeof q.yy.parseError=="function"?this.parseError=q.yy.parseError:this.parseError=Object.getPrototypeOf(this).parseError;function ce(P){f.length=f.length-2*P,E.length=E.length-P,h.length=h.length-P}d(ce,"popStack");function Nt(){var P;return P=m.pop()||z.lex()||at,typeof P!="number"&&(P instanceof Array&&(m=P,P=m.pop()),P=g.symbols_[P]||P),P}d(Nt,"lex");for(var F,J,H,pt,Q={},st,G,Tt,it;;){if(J=f[f.length-1],this.defaultActions[J]?H=this.defaultActions[J]:((F===null||typeof F>"u")&&(F=Nt()),H=W[J]&&W[J][F]),typeof H>"u"||!H.length||!H[0]){var ft="";it=[];for(st in W[J])this.terminals_[st]&&st>V&&it.push("'"+this.terminals_[st]+"'");z.showPosition?ft="Parse error on line "+(I+1)+`:
-`+z.showPosition()+`
-Expecting `+it.join(", ")+", got '"+(this.terminals_[F]||F)+"'":ft="Parse error on line "+(I+1)+": Unexpected "+(F==at?"end of input":"'"+(this.terminals_[F]||F)+"'"),this.parseError(ft,{text:z.match,token:this.terminals_[F]||F,line:z.yylineno,loc:ut,expected:it})}if(H[0]instanceof Array&&H.length>1)throw new Error("Parse Error: multiple actions possible at state: "+J+", token: "+F);switch(H[0]){case 1:f.push(F),E.push(z.yytext),h.push(z.yylloc),f.push(H[1]),F=null,Z=z.yyleng,p=z.yytext,I=z.yylineno,ut=z.yylloc;break;case 2:if(G=this.productions_[H[1]][1],Q.$=E[E.length-G],Q._$={first_line:h[h.length-(G||1)].first_line,last_line:h[h.length-1].last_line,first_column:h[h.length-(G||1)].first_column,last_column:h[h.length-1].last_column},le&&(Q._$.range=[h[h.length-(G||1)].range[0],h[h.length-1].range[1]]),pt=this.performAction.apply(Q,[p,Z,I,q.yy,H[1],E,h].concat(ne)),typeof pt<"u")return pt;G&&(f=f.slice(0,-1*G*2),E=E.slice(0,-1*G),h=h.slice(0,-1*G)),f.push(this.productions_[H[1]][0]),E.push(Q.$),h.push(Q._$),Tt=W[f[f.length-2]][f[f.length-1]],f.push(Tt);break;case 3:return!0}}return!0},"parse")},B=(function(){var D={EOF:1,parseError:d(function(g,f){if(this.yy.parser)this.yy.parser.parseError(g,f);else throw new Error(g)},"parseError"),setInput:d(function(y,g){return this.yy=g||this.yy||{},this._input=y,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},"setInput"),input:d(function(){var y=this._input[0];this.yytext+=y,this.yyleng++,this.offset++,this.match+=y,this.matched+=y;var g=y.match(/(?:\r\n?|\n).*/g);return g?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),y},"input"),unput:d(function(y){var g=y.length,f=y.split(/(?:\r\n?|\n)/g);this._input=y+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-g),this.offset-=g;var m=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),f.length-1&&(this.yylineno-=f.length-1);var E=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:f?(f.length===m.length?this.yylloc.first_column:0)+m[m.length-f.length].length-f[0].length:this.yylloc.first_column-g},this.options.ranges&&(this.yylloc.range=[E[0],E[0]+this.yyleng-g]),this.yyleng=this.yytext.length,this},"unput"),more:d(function(){return this._more=!0,this},"more"),reject:d(function(){if(this.options.backtrack_lexer)this._backtrack=!0;else return this.parseError("Lexical error on line "+(this.yylineno+1)+`. You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).
-`+this.showPosition(),{text:"",token:null,line:this.yylineno});return this},"reject"),less:d(function(y){this.unput(this.match.slice(y))},"less"),pastInput:d(function(){var y=this.matched.substr(0,this.matched.length-this.match.length);return(y.length>20?"...":"")+y.substr(-20).replace(/\n/g,"")},"pastInput"),upcomingInput:d(function(){var y=this.match;return y.length<20&&(y+=this._input.substr(0,20-y.length)),(y.substr(0,20)+(y.length>20?"...":"")).replace(/\n/g,"")},"upcomingInput"),showPosition:d(function(){var y=this.pastInput(),g=new Array(y.length+1).join("-");return y+this.upcomingInput()+`
-`+g+"^"},"showPosition"),test_match:d(function(y,g){var f,m,E;if(this.options.backtrack_lexer&&(E={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(E.yylloc.range=this.yylloc.range.slice(0))),m=y[0].match(/(?:\r\n?|\n).*/g),m&&(this.yylineno+=m.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:m?m[m.length-1].length-m[m.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+y[0].length},this.yytext+=y[0],this.match+=y[0],this.matches=y,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(y[0].length),this.matched+=y[0],f=this.performAction.call(this,this.yy,this,g,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),f)return f;if(this._backtrack){for(var h in E)this[h]=E[h];return!1}return!1},"test_match"),next:d(function(){if(this.done)return this.EOF;this._input||(this.done=!0);var y,g,f,m;this._more||(this.yytext="",this.match="");for(var E=this._currentRules(),h=0;h<E.length;h++)if(f=this._input.match(this.rules[E[h]]),f&&(!g||f[0].length>g[0].length)){if(g=f,m=h,this.options.backtrack_lexer){if(y=this.test_match(f,E[h]),y!==!1)return y;if(this._backtrack){g=!1;continue}else return!1}else if(!this.options.flex)break}return g?(y=this.test_match(g,E[m]),y!==!1?y:!1):this._input===""?this.EOF:this.parseError("Lexical error on line "+(this.yylineno+1)+`. Unrecognized text.
-`+this.showPosition(),{text:"",token:null,line:this.yylineno})},"next"),lex:d(function(){var g=this.next();return g||this.lex()},"lex"),begin:d(function(g){this.conditionStack.push(g)},"begin"),popState:d(function(){var g=this.conditionStack.length-1;return g>0?this.conditionStack.pop():this.conditionStack[0]},"popState"),_currentRules:d(function(){return this.conditionStack.length&&this.conditionStack[this.conditionStack.length-1]?this.conditions[this.conditionStack[this.conditionStack.length-1]].rules:this.conditions.INITIAL.rules},"_currentRules"),topState:d(function(g){return g=this.conditionStack.length-1-Math.abs(g||0),g>=0?this.conditionStack[g]:"INITIAL"},"topState"),pushState:d(function(g){this.begin(g)},"pushState"),stateStackSize:d(function(){return this.conditionStack.length},"stateStackSize"),options:{},performAction:d(function(g,f,m,E){switch(m){case 0:return g.getLogger().debug("Found block-beta"),10;case 1:return g.getLogger().debug("Found id-block"),29;case 2:return g.getLogger().debug("Found block"),10;case 3:g.getLogger().debug(".",f.yytext);break;case 4:g.getLogger().debug("_",f.yytext);break;case 5:return 5;case 6:return f.yytext=-1,28;case 7:return f.yytext=f.yytext.replace(/columns\s+/,""),g.getLogger().debug("COLUMNS (LEX)",f.yytext),28;case 8:this.pushState("md_string");break;case 9:return"MD_STR";case 10:this.popState();break;case 11:this.pushState("string");break;case 12:g.getLogger().debug("LEX: POPPING STR:",f.yytext),this.popState();break;case 13:return g.getLogger().debug("LEX: STR end:",f.yytext),"STR";case 14:return f.yytext=f.yytext.replace(/space\:/,""),g.getLogger().debug("SPACE NUM (LEX)",f.yytext),21;case 15:return f.yytext="1",g.getLogger().debug("COLUMNS (LEX)",f.yytext),21;case 16:return 42;case 17:return"LINKSTYLE";case 18:return"INTERPOLATE";case 19:return this.pushState("CLASSDEF"),39;case 20:return this.popState(),this.pushState("CLASSDEFID"),"DEFAULT_CLASSDEF_ID";case 21:return this.popState(),this.pushState("CLASSDEFID"),40;case 22:return this.popState(),41;case 23:return this.pushState("CLASS"),43;case 24:return this.popState(),this.pushState("CLASS_STYLE"),44;case 25:return this.popState(),45;case 26:return this.pushState("STYLE_STMNT"),46;case 27:return this.popState(),this.pushState("STYLE_DEFINITION"),47;case 28:return this.popState(),48;case 29:return this.pushState("acc_title"),"acc_title";case 30:return this.popState(),"acc_title_value";case 31:return this.pushState("acc_descr"),"acc_descr";case 32:return this.popState(),"acc_descr_value";case 33:this.pushState("acc_descr_multiline");break;case 34:this.popState();break;case 35:return"acc_descr_multiline_value";case 36:return 30;case 37:return this.popState(),g.getLogger().debug("Lex: (("),"NODE_DEND";case 38:return this.popState(),g.getLogger().debug("Lex: (("),"NODE_DEND";case 39:return this.popState(),g.getLogger().debug("Lex: ))"),"NODE_DEND";case 40:return this.popState(),g.getLogger().debug("Lex: (("),"NODE_DEND";case 41:return this.popState(),g.getLogger().debug("Lex: (("),"NODE_DEND";case 42:return this.popState(),g.getLogger().debug("Lex: (-"),"NODE_DEND";case 43:return this.popState(),g.getLogger().debug("Lex: -)"),"NODE_DEND";case 44:return this.popState(),g.getLogger().debug("Lex: (("),"NODE_DEND";case 45:return this.popState(),g.getLogger().debug("Lex: ]]"),"NODE_DEND";case 46:return this.popState(),g.getLogger().debug("Lex: ("),"NODE_DEND";case 47:return this.popState(),g.getLogger().debug("Lex: ])"),"NODE_DEND";case 48:return this.popState(),g.getLogger().debug("Lex: /]"),"NODE_DEND";case 49:return this.popState(),g.getLogger().debug("Lex: /]"),"NODE_DEND";case 50:return this.popState(),g.getLogger().debug("Lex: )]"),"NODE_DEND";case 51:return this.popState(),g.getLogger().debug("Lex: )"),"NODE_DEND";case 52:return this.popState(),g.getLogger().debug("Lex: ]>"),"NODE_DEND";case 53:return this.popState(),g.getLogger().debug("Lex: ]"),"NODE_DEND";case 54:return g.getLogger().debug("Lexa: -)"),this.pushState("NODE"),35;case 55:return g.getLogger().debug("Lexa: (-"),this.pushState("NODE"),35;case 56:return g.getLogger().debug("Lexa: ))"),this.pushState("NODE"),35;case 57:return g.getLogger().debug("Lexa: )"),this.pushState("NODE"),35;case 58:return g.getLogger().debug("Lex: ((("),this.pushState("NODE"),35;case 59:return g.getLogger().debug("Lexa: )"),this.pushState("NODE"),35;case 60:return g.getLogger().debug("Lexa: )"),this.pushState("NODE"),35;case 61:return g.getLogger().debug("Lexa: )"),this.pushState("NODE"),35;case 62:return g.getLogger().debug("Lexc: >"),this.pushState("NODE"),35;case 63:return g.getLogger().debug("Lexa: (["),this.pushState("NODE"),35;case 64:return g.getLogger().debug("Lexa: )"),this.pushState("NODE"),35;case 65:return this.pushState("NODE"),35;case 66:return this.pushState("NODE"),35;case 67:return this.pushState("NODE"),35;case 68:return this.pushState("NODE"),35;case 69:return this.pushState("NODE"),35;case 70:return this.pushState("NODE"),35;case 71:return this.pushState("NODE"),35;case 72:return g.getLogger().debug("Lexa: ["),this.pushState("NODE"),35;case 73:return this.pushState("BLOCK_ARROW"),g.getLogger().debug("LEX ARR START"),37;case 74:return g.getLogger().debug("Lex: NODE_ID",f.yytext),31;case 75:return g.getLogger().debug("Lex: EOF",f.yytext),8;case 76:this.pushState("md_string");break;case 77:this.pushState("md_string");break;case 78:return"NODE_DESCR";case 79:this.popState();break;case 80:g.getLogger().debug("Lex: Starting string"),this.pushState("string");break;case 81:g.getLogger().debug("LEX ARR: Starting string"),this.pushState("string");break;case 82:return g.getLogger().debug("LEX: NODE_DESCR:",f.yytext),"NODE_DESCR";case 83:g.getLogger().debug("LEX POPPING"),this.popState();break;case 84:g.getLogger().debug("Lex: =>BAE"),this.pushState("ARROW_DIR");break;case 85:return f.yytext=f.yytext.replace(/^,\s*/,""),g.getLogger().debug("Lex (right): dir:",f.yytext),"DIR";case 86:return f.yytext=f.yytext.replace(/^,\s*/,""),g.getLogger().debug("Lex (left):",f.yytext),"DIR";case 87:return f.yytext=f.yytext.replace(/^,\s*/,""),g.getLogger().debug("Lex (x):",f.yytext),"DIR";case 88:return f.yytext=f.yytext.replace(/^,\s*/,""),g.getLogger().debug("Lex (y):",f.yytext),"DIR";case 89:return f.yytext=f.yytext.replace(/^,\s*/,""),g.getLogger().debug("Lex (up):",f.yytext),"DIR";case 90:return f.yytext=f.yytext.replace(/^,\s*/,""),g.getLogger().debug("Lex (down):",f.yytext),"DIR";case 91:return f.yytext="]>",g.getLogger().debug("Lex (ARROW_DIR end):",f.yytext),this.popState(),this.popState(),"BLOCK_ARROW_END";case 92:return g.getLogger().debug("Lex: LINK","#"+f.yytext+"#"),15;case 93:return g.getLogger().debug("Lex: LINK",f.yytext),15;case 94:return g.getLogger().debug("Lex: LINK",f.yytext),15;case 95:return g.getLogger().debug("Lex: LINK",f.yytext),15;case 96:return g.getLogger().debug("Lex: START_LINK",f.yytext),this.pushState("LLABEL"),16;case 97:return g.getLogger().debug("Lex: START_LINK",f.yytext),this.pushState("LLABEL"),16;case 98:return g.getLogger().debug("Lex: START_LINK",f.yytext),this.pushState("LLABEL"),16;case 99:this.pushState("md_string");break;case 100:return g.getLogger().debug("Lex: Starting string"),this.pushState("string"),"LINK_LABEL";case 101:return this.popState(),g.getLogger().debug("Lex: LINK","#"+f.yytext+"#"),15;case 102:return this.popState(),g.getLogger().debug("Lex: LINK",f.yytext),15;case 103:return this.popState(),g.getLogger().debug("Lex: LINK",f.yytext),15;case 104:return g.getLogger().debug("Lex: COLON",f.yytext),f.yytext=f.yytext.slice(1),27}},"anonymous"),rules:[/^(?:block-beta\b)/,/^(?:block:)/,/^(?:block\b)/,/^(?:[\s]+)/,/^(?:[\n]+)/,/^(?:((\u000D\u000A)|(\u000A)))/,/^(?:columns\s+auto\b)/,/^(?:columns\s+[\d]+)/,/^(?:["][`])/,/^(?:[^`"]+)/,/^(?:[`]["])/,/^(?:["])/,/^(?:["])/,/^(?:[^"]*)/,/^(?:space[:]\d+)/,/^(?:space\b)/,/^(?:default\b)/,/^(?:linkStyle\b)/,/^(?:interpolate\b)/,/^(?:classDef\s+)/,/^(?:DEFAULT\s+)/,/^(?:\w+\s+)/,/^(?:[^\n]*)/,/^(?:class\s+)/,/^(?:(\w+)+((,\s*\w+)*))/,/^(?:[^\n]*)/,/^(?:style\s+)/,/^(?:(\w+)+((,\s*\w+)*))/,/^(?:[^\n]*)/,/^(?:accTitle\s*:\s*)/,/^(?:(?!\n||)*[^\n]*)/,/^(?:accDescr\s*:\s*)/,/^(?:(?!\n||)*[^\n]*)/,/^(?:accDescr\s*\{\s*)/,/^(?:[\}])/,/^(?:[^\}]*)/,/^(?:end\b\s*)/,/^(?:\(\(\()/,/^(?:\)\)\))/,/^(?:[\)]\))/,/^(?:\}\})/,/^(?:\})/,/^(?:\(-)/,/^(?:-\))/,/^(?:\(\()/,/^(?:\]\])/,/^(?:\()/,/^(?:\]\))/,/^(?:\\\])/,/^(?:\/\])/,/^(?:\)\])/,/^(?:[\)])/,/^(?:\]>)/,/^(?:[\]])/,/^(?:-\))/,/^(?:\(-)/,/^(?:\)\))/,/^(?:\))/,/^(?:\(\(\()/,/^(?:\(\()/,/^(?:\{\{)/,/^(?:\{)/,/^(?:>)/,/^(?:\(\[)/,/^(?:\()/,/^(?:\[\[)/,/^(?:\[\|)/,/^(?:\[\()/,/^(?:\)\)\))/,/^(?:\[\\)/,/^(?:\[\/)/,/^(?:\[\\)/,/^(?:\[)/,/^(?:<\[)/,/^(?:[^\(\[\n\-\)\{\}\s\<\>:]+)/,/^(?:$)/,/^(?:["][`])/,/^(?:["][`])/,/^(?:[^`"]+)/,/^(?:[`]["])/,/^(?:["])/,/^(?:["])/,/^(?:[^"]+)/,/^(?:["])/,/^(?:\]>\s*\()/,/^(?:,?\s*right\s*)/,/^(?:,?\s*left\s*)/,/^(?:,?\s*x\s*)/,/^(?:,?\s*y\s*)/,/^(?:,?\s*up\s*)/,/^(?:,?\s*down\s*)/,/^(?:\)\s*)/,/^(?:\s*[xo<]?--+[-xo>]\s*)/,/^(?:\s*[xo<]?==+[=xo>]\s*)/,/^(?:\s*[xo<]?-?\.+-[xo>]?\s*)/,/^(?:\s*~~[\~]+\s*)/,/^(?:\s*[xo<]?--\s*)/,/^(?:\s*[xo<]?==\s*)/,/^(?:\s*[xo<]?-\.\s*)/,/^(?:["][`])/,/^(?:["])/,/^(?:\s*[xo<]?--+[-xo>]\s*)/,/^(?:\s*[xo<]?==+[=xo>]\s*)/,/^(?:\s*[xo<]?-?\.+-[xo>]?\s*)/,/^(?::\d+)/],conditions:{STYLE_DEFINITION:{rules:[28],inclusive:!1},STYLE_STMNT:{rules:[27],inclusive:!1},CLASSDEFID:{rules:[22],inclusive:!1},CLASSDEF:{rules:[20,21],inclusive:!1},CLASS_STYLE:{rules:[25],inclusive:!1},CLASS:{rules:[24],inclusive:!1},LLABEL:{rules:[99,100,101,102,103],inclusive:!1},ARROW_DIR:{rules:[85,86,87,88,89,90,91],inclusive:!1},BLOCK_ARROW:{rules:[76,81,84],inclusive:!1},NODE:{rules:[37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,77,80],inclusive:!1},md_string:{rules:[9,10,78,79],inclusive:!1},space:{rules:[],inclusive:!1},string:{rules:[12,13,82,83],inclusive:!1},acc_descr_multiline:{rules:[34,35],inclusive:!1},acc_descr:{rules:[32],inclusive:!1},acc_title:{rules:[30],inclusive:!1},INITIAL:{rules:[0,1,2,3,4,5,6,7,8,11,14,15,16,17,18,19,23,26,29,31,33,36,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,92,93,94,95,96,97,98,104],inclusive:!0}}};return D})();k.lexer=B;function _(){this.yy={}}return d(_,"Parser"),_.prototype=k,k.Parser=_,new _})();bt.parser=bt;var ve=bt,X=new Map,kt=[],wt=new Map,Bt="color",Ct="fill",Ee="bgFill",Pt=",",_e=R(),ct=new Map,De=d(e=>be.sanitizeText(e,_e),"sanitizeText"),Ne=d(function(e,t=""){let a=ct.get(e);a||(a={id:e,styles:[],textStyles:[]},ct.set(e,a)),t?.split(Pt).forEach(i=>{const l=i.replace(/([^;]*);/,"$1").trim();if(RegExp(Bt).exec(i)){const r=l.replace(Ct,Ee).replace(Bt,Ct);a.textStyles.push(r)}a.styles.push(l)})},"addStyleClass"),Te=d(function(e,t=""){const a=X.get(e);t!=null&&(a.styles=t.split(Pt))},"addStyle2Node"),Be=d(function(e,t){e.split(",").forEach(function(a){let i=X.get(a);if(i===void 0){const l=a.trim();i={id:l,type:"na",children:[]},X.set(l,i)}i.classes||(i.classes=[]),i.classes.push(t)})},"setCssClass"),Yt=d((e,t)=>{const a=e.flat(),i=[],s=a.find(r=>r?.type==="column-setting")?.columns??-1;for(const r of a){if(typeof s=="number"&&s>0&&r.type!=="column-setting"&&typeof r.widthInColumns=="number"&&r.widthInColumns>s&&L.warn(`Block ${r.id} width ${r.widthInColumns} exceeds configured column width ${s}`),r.label&&(r.label=De(r.label)),r.type==="classDef"){Ne(r.id,r.css);continue}if(r.type==="applyClass"){Be(r.id,r?.styleClass??"");continue}if(r.type==="applyStyles"){r?.stylesStr&&Te(r.id,r?.stylesStr);continue}if(r.type==="column-setting")t.columns=r.columns??-1;else if(r.type==="edge"){const n=(wt.get(r.id)??0)+1;wt.set(r.id,n),r.id=n+"-"+r.id,kt.push(r)}else{r.label||(r.type==="composite"?r.label="":r.label=r.id);const n=X.get(r.id);if(n===void 0?X.set(r.id,r):(r.type!=="na"&&(n.type=r.type),r.label!==r.id&&(n.label=r.label)),r.children&&Yt(r.children,r),r.type==="space"){const c=r.width??1;for(let u=0;u<c;u++){const o=Le(r);o.id=o.id+"-"+u,X.set(o.id,o),i.push(o)}}else n===void 0&&i.push(r)}}t.children=i},"populateBlockDatabase"),vt=[],et={id:"root",type:"composite",children:[],columns:-1},Ce=d(()=>{L.debug("Clear called"),de(),et={id:"root",type:"composite",children:[],columns:-1},X=new Map([["root",et]]),vt=[],ct=new Map,kt=[],wt=new Map},"clear");function Ht(e){switch(L.debug("typeStr2Type",e),e){case"[]":return"square";case"()":return L.debug("we have a round"),"round";case"(())":return"circle";case">]":return"rect_left_inv_arrow";case"{}":return"diamond";case"{{}}":return"hexagon";case"([])":return"stadium";case"[[]]":return"subroutine";case"[()]":return"cylinder";case"((()))":return"doublecircle";case"[//]":return"lean_right";case"[\\\\]":return"lean_left";case"[/\\]":return"trapezoid";case"[\\/]":return"inv_trapezoid";case"<[]>":return"block_arrow";default:return"na"}}d(Ht,"typeStr2Type");function Kt(e){switch(L.debug("typeStr2Type",e),e){case"==":return"thick";default:return"normal"}}d(Kt,"edgeTypeStr2Type");function Xt(e){switch(e.replace(/^[\s-]+|[\s-]+$/g,"")){case"x":return"arrow_cross";case"o":return"arrow_circle";case">":return"arrow_point";default:return""}}d(Xt,"edgeStrToEdgeData");var It=0,Ie=d(()=>(It++,"id-"+Math.random().toString(36).substr(2,12)+"-"+It),"generateId"),Oe=d(e=>{et.children=e,Yt(e,et),vt=et.children},"setHierarchy"),Re=d(e=>{const t=X.get(e);return t?t.columns?t.columns:t.children?t.children.length:-1:-1},"getColumns"),ze=d(()=>[...X.values()],"getBlocksFlat"),Ae=d(()=>vt||[],"getBlocks"),Me=d(()=>kt,"getEdges"),Fe=d(e=>X.get(e),"getBlock"),We=d(e=>{X.set(e.id,e)},"setBlock"),Pe=d(()=>L,"getLogger"),Ye=d(function(){return ct},"getClasses"),He={getConfig:d(()=>rt().block,"getConfig"),typeStr2Type:Ht,edgeTypeStr2Type:Kt,edgeStrToEdgeData:Xt,getLogger:Pe,getBlocksFlat:ze,getBlocks:Ae,getEdges:Me,setHierarchy:Oe,getBlock:Fe,setBlock:We,getColumns:Re,getClasses:Ye,clear:Ce,generateId:Ie},Ke=He,nt=d((e,t)=>{const a=ke,i=a(e,"r"),l=a(e,"g"),s=a(e,"b");return ge(i,l,s,t)},"fade"),Xe=d(e=>`.label {
-    font-family: ${e.fontFamily};
-    color: ${e.nodeTextColor||e.textColor};
-  }
-  .cluster-label text {
-    fill: ${e.titleColor};
-  }
-  .cluster-label span,p {
-    color: ${e.titleColor};
-  }
-
-
-
-  .label text,span,p {
-    fill: ${e.nodeTextColor||e.textColor};
-    color: ${e.nodeTextColor||e.textColor};
-  }
-
-  .node rect,
-  .node circle,
-  .node ellipse,
-  .node polygon,
-  .node path {
-    fill: ${e.mainBkg};
-    stroke: ${e.nodeBorder};
-    stroke-width: 1px;
-  }
-  .flowchart-label text {
-    text-anchor: middle;
-  }
-  // .flowchart-label .text-outer-tspan {
-  //   text-anchor: middle;
-  // }
-  // .flowchart-label .text-inner-tspan {
-  //   text-anchor: start;
-  // }
-
-  .node .label {
-    text-align: center;
-  }
-  .node.clickable {
-    cursor: pointer;
-  }
-
-  .arrowheadPath {
-    fill: ${e.arrowheadColor};
-  }
-
-  .edgePath .path {
-    stroke: ${e.lineColor};
-    stroke-width: 2.0px;
-  }
-
-  .flowchart-link {
-    stroke: ${e.lineColor};
-    fill: none;
-  }
-
-  .edgeLabel {
-    background-color: ${e.edgeLabelBackground};
-    rect {
-      opacity: 0.5;
-      background-color: ${e.edgeLabelBackground};
-      fill: ${e.edgeLabelBackground};
-    }
-    text-align: center;
-  }
-
-  /* For html labels only */
-  .labelBkg {
-    background-color: ${nt(e.edgeLabelBackground,.5)};
-    // background-color:
-  }
-
-  .node .cluster {
-    // fill: ${nt(e.mainBkg,.5)};
-    fill: ${nt(e.clusterBkg,.5)};
-    stroke: ${nt(e.clusterBorder,.2)};
-    box-shadow: rgba(50, 50, 93, 0.25) 0px 13px 27px -5px, rgba(0, 0, 0, 0.3) 0px 8px 16px -8px;
-    stroke-width: 1px;
-  }
-
-  .cluster text {
-    fill: ${e.titleColor};
-  }
-
-  .cluster span,p {
-    color: ${e.titleColor};
-  }
-  /* .cluster div {
-    color: ${e.titleColor};
-  } */
-
-  div.mermaidTooltip {
-    position: absolute;
-    text-align: center;
-    max-width: 200px;
-    padding: 2px;
-    font-family: ${e.fontFamily};
-    font-size: 12px;
-    background: ${e.tertiaryColor};
-    border: 1px solid ${e.border2};
-    border-radius: 2px;
-    pointer-events: none;
-    z-index: 100;
-  }
-
-  .flowchartTitleText {
-    text-anchor: middle;
-    font-size: 18px;
-    fill: ${e.textColor};
-  }
-  ${oe()}
-`,"getStyles"),Ue=Xe,je=d((e,t,a,i)=>{t.forEach(l=>{rr[l](e,a,i)})},"insertMarkers"),Ve=d((e,t,a)=>{L.trace("Making markers for ",a),e.append("defs").append("marker").attr("id",a+"_"+t+"-extensionStart").attr("class","marker extension "+t).attr("refX",18).attr("refY",7).attr("markerWidth",190).attr("markerHeight",240).attr("orient","auto").append("path").attr("d","M 1,7 L18,13 V 1 Z"),e.append("defs").append("marker").attr("id",a+"_"+t+"-extensionEnd").attr("class","marker extension "+t).attr("refX",1).attr("refY",7).attr("markerWidth",20).attr("markerHeight",28).attr("orient","auto").append("path").attr("d","M 1,1 V 13 L18,7 Z")},"extension"),Ge=d((e,t,a)=>{e.append("defs").append("marker").attr("id",a+"_"+t+"-compositionStart").attr("class","marker composition "+t).attr("refX",18).attr("refY",7).attr("markerWidth",190).attr("markerHeight",240).attr("orient","auto").append("path").attr("d","M 18,7 L9,13 L1,7 L9,1 Z"),e.append("defs").append("marker").attr("id",a+"_"+t+"-compositionEnd").attr("class","marker composition "+t).attr("refX",1).attr("refY",7).attr("markerWidth",20).attr("markerHeight",28).attr("orient","auto").append("path").attr("d","M 18,7 L9,13 L1,7 L9,1 Z")},"composition"),Ze=d((e,t,a)=>{e.append("defs").append("marker").attr("id",a+"_"+t+"-aggregationStart").attr("class","marker aggregation "+t).attr("refX",18).attr("refY",7).attr("markerWidth",190).attr("markerHeight",240).attr("orient","auto").append("path").attr("d","M 18,7 L9,13 L1,7 L9,1 Z"),e.append("defs").append("marker").attr("id",a+"_"+t+"-aggregationEnd").attr("class","marker aggregation "+t).attr("refX",1).attr("refY",7).attr("markerWidth",20).attr("markerHeight",28).attr("orient","auto").append("path").attr("d","M 18,7 L9,13 L1,7 L9,1 Z")},"aggregation"),qe=d((e,t,a)=>{e.append("defs").append("marker").attr("id",a+"_"+t+"-dependencyStart").attr("class","marker dependency "+t).attr("refX",6).attr("refY",7).attr("markerWidth",190).attr("markerHeight",240).attr("orient","auto").append("path").attr("d","M 5,7 L9,13 L1,7 L9,1 Z"),e.append("defs").append("marker").attr("id",a+"_"+t+"-dependencyEnd").attr("class","marker dependency "+t).attr("refX",13).attr("refY",7).attr("markerWidth",20).attr("markerHeight",28).attr("orient","auto").append("path").attr("d","M 18,7 L9,13 L14,7 L9,1 Z")},"dependency"),Je=d((e,t,a)=>{e.append("defs").append("marker").attr("id",a+"_"+t+"-lollipopStart").attr("class","marker lollipop "+t).attr("refX",13).attr("refY",7).attr("markerWidth",190).attr("markerHeight",240).attr("orient","auto").append("circle").attr("stroke","black").attr("fill","transparent").attr("cx",7).attr("cy",7).attr("r",6),e.append("defs").append("marker").attr("id",a+"_"+t+"-lollipopEnd").attr("class","marker lollipop "+t).attr("refX",1).attr("refY",7).attr("markerWidth",190).attr("markerHeight",240).attr("orient","auto").append("circle").attr("stroke","black").attr("fill","transparent").attr("cx",7).attr("cy",7).attr("r",6)},"lollipop"),Qe=d((e,t,a)=>{e.append("marker").attr("id",a+"_"+t+"-pointEnd").attr("class","marker "+t).attr("viewBox","0 0 10 10").attr("refX",6).attr("refY",5).attr("markerUnits","userSpaceOnUse").attr("markerWidth",12).attr("markerHeight",12).attr("orient","auto").append("path").attr("d","M 0 0 L 10 5 L 0 10 z").attr("class","arrowMarkerPath").style("stroke-width",1).style("stroke-dasharray","1,0"),e.append("marker").attr("id",a+"_"+t+"-pointStart").attr("class","marker "+t).attr("viewBox","0 0 10 10").attr("refX",4.5).attr("refY",5).attr("markerUnits","userSpaceOnUse").attr("markerWidth",12).attr("markerHeight",12).attr("orient","auto").append("path").attr("d","M 0 5 L 10 10 L 10 0 z").attr("class","arrowMarkerPath").style("stroke-width",1).style("stroke-dasharray","1,0")},"point"),$e=d((e,t,a)=>{e.append("marker").attr("id",a+"_"+t+"-circleEnd").attr("class","marker "+t).attr("viewBox","0 0 10 10").attr("refX",11).attr("refY",5).attr("markerUnits","userSpaceOnUse").attr("markerWidth",11).attr("markerHeight",11).attr("orient","auto").append("circle").attr("cx","5").attr("cy","5").attr("r","5").attr("class","arrowMarkerPath").style("stroke-width",1).style("stroke-dasharray","1,0"),e.append("marker").attr("id",a+"_"+t+"-circleStart").attr("class","marker "+t).attr("viewBox","0 0 10 10").attr("refX",-1).attr("refY",5).attr("markerUnits","userSpaceOnUse").attr("markerWidth",11).attr("markerHeight",11).attr("orient","auto").append("circle").attr("cx","5").attr("cy","5").attr("r","5").attr("class","arrowMarkerPath").style("stroke-width",1).style("stroke-dasharray","1,0")},"circle"),tr=d((e,t,a)=>{e.append("marker").attr("id",a+"_"+t+"-crossEnd").attr("class","marker cross "+t).attr("viewBox","0 0 11 11").attr("refX",12).attr("refY",5.2).attr("markerUnits","userSpaceOnUse").attr("markerWidth",11).attr("markerHeight",11).attr("orient","auto").append("path").attr("d","M 1,1 l 9,9 M 10,1 l -9,9").attr("class","arrowMarkerPath").style("stroke-width",2).style("stroke-dasharray","1,0"),e.append("marker").attr("id",a+"_"+t+"-crossStart").attr("class","marker cross "+t).attr("viewBox","0 0 11 11").attr("refX",-1).attr("refY",5.2).attr("markerUnits","userSpaceOnUse").attr("markerWidth",11).attr("markerHeight",11).attr("orient","auto").append("path").attr("d","M 1,1 l 9,9 M 10,1 l -9,9").attr("class","arrowMarkerPath").style("stroke-width",2).style("stroke-dasharray","1,0")},"cross"),er=d((e,t,a)=>{e.append("defs").append("marker").attr("id",a+"_"+t+"-barbEnd").attr("refX",19).attr("refY",7).attr("markerWidth",20).attr("markerHeight",14).attr("markerUnits","strokeWidth").attr("orient","auto").append("path").attr("d","M 19,7 L9,13 L14,7 L9,1 Z")},"barb"),rr={extension:Ve,composition:Ge,aggregation:Ze,dependency:qe,lollipop:Je,point:Qe,circle:$e,cross:tr,barb:er},ar=je,C=R()?.block?.padding??8;function Ut(e,t){if(e===0||!Number.isInteger(e))throw new Error("Columns must be an integer !== 0.");if(t<0||!Number.isInteger(t))throw new Error("Position must be a non-negative integer."+t);if(e<0)return{px:t,py:0};if(e===1)return{px:0,py:t};const a=t%e,i=Math.floor(t/e);return{px:a,py:i}}d(Ut,"calculateBlockPosition");var sr=d(e=>{let t=0,a=0;for(const i of e.children){const{width:l,height:s,x:r,y:n}=i.size??{width:0,height:0,x:0,y:0};L.debug("getMaxChildSize abc95 child:",i.id,"width:",l,"height:",s,"x:",r,"y:",n,i.type),i.type!=="space"&&(l>t&&(t=l/(e.widthInColumns??1)),s>a&&(a=s))}return{width:t,height:a}},"getMaxChildSize");function ot(e,t,a=0,i=0){L.debug("setBlockSizes abc95 (start)",e.id,e?.size?.x,"block width =",e?.size,"siblingWidth",a),e?.size?.width||(e.size={width:a,height:i,x:0,y:0});let l=0,s=0;if(e.children?.length>0){for(const b of e.children)ot(b,t);const r=sr(e);l=r.width,s=r.height,L.debug("setBlockSizes abc95 maxWidth of",e.id,":s children is ",l,s);for(const b of e.children)b.size&&(L.debug(`abc95 Setting size of children of ${e.id} id=${b.id} ${l} ${s} ${JSON.stringify(b.size)}`),b.size.width=l*(b.widthInColumns??1)+C*((b.widthInColumns??1)-1),b.size.height=s,b.size.x=0,b.size.y=0,L.debug(`abc95 updating size of ${e.id} children child:${b.id} maxWidth:${l} maxHeight:${s}`));for(const b of e.children)ot(b,t,l,s);const n=e.columns??-1;let c=0;for(const b of e.children)c+=b.widthInColumns??1;let u=e.children.length;n>0&&n<c&&(u=n);const o=Math.ceil(c/u);let x=u*(l+C)+C,w=o*(s+C)+C;if(x<a){L.debug(`Detected to small sibling: abc95 ${e.id} siblingWidth ${a} siblingHeight ${i} width ${x}`),x=a,w=i;const b=(a-u*C-C)/u,S=(i-o*C-C)/o;L.debug("Size indata abc88",e.id,"childWidth",b,"maxWidth",l),L.debug("Size indata abc88",e.id,"childHeight",S,"maxHeight",s),L.debug("Size indata abc88 xSize",u,"padding",C);for(const v of e.children)v.size&&(v.size.width=b,v.size.height=S,v.size.x=0,v.size.y=0)}if(L.debug(`abc95 (finale calc) ${e.id} xSize ${u} ySize ${o} columns ${n}${e.children.length} width=${Math.max(x,e.size?.width||0)}`),x<(e?.size?.width||0)){x=e?.size?.width||0;const b=n>0?Math.min(e.children.length,n):e.children.length;if(b>0){const S=(x-b*C-C)/b;L.debug("abc95 (growing to fit) width",e.id,x,e.size?.width,S);for(const v of e.children)v.size&&(v.size.width=S)}}e.size={width:x,height:w,x:0,y:0}}L.debug("setBlockSizes abc94 (done)",e.id,e?.size?.x,e?.size?.width,e?.size?.y,e?.size?.height)}d(ot,"setBlockSizes");function Et(e,t){L.debug(`abc85 layout blocks (=>layoutBlocks) ${e.id} x: ${e?.size?.x} y: ${e?.size?.y} width: ${e?.size?.width}`);const a=e.columns??-1;if(L.debug("layoutBlocks columns abc95",e.id,"=>",a,e),e.children&&e.children.length>0){const i=e?.children[0]?.size?.width??0,l=e.children.length*i+(e.children.length-1)*C;L.debug("widthOfChildren 88",l,"posX");let s=0;L.debug("abc91 block?.size?.x",e.id,e?.size?.x);let r=e?.size?.x?e?.size?.x+(-e?.size?.width/2||0):-C,n=0;for(const c of e.children){const u=e;if(!c.size)continue;const{width:o,height:x}=c.size,{px:w,py:b}=Ut(a,s);if(b!=n&&(n=b,r=e?.size?.x?e?.size?.x+(-e?.size?.width/2||0):-C,L.debug("New row in layout for block",e.id," and child ",c.id,n)),L.debug(`abc89 layout blocks (child) id: ${c.id} Pos: ${s} (px, py) ${w},${b} (${u?.size?.x},${u?.size?.y}) parent: ${u.id} width: ${o}${C}`),u.size){const v=o/2;c.size.x=r+C+v,L.debug(`abc91 layout blocks (calc) px, pyid:${c.id} startingPos=X${r} new startingPosX${c.size.x} ${v} padding=${C} width=${o} halfWidth=${v} => x:${c.size.x} y:${c.size.y} ${c.widthInColumns} (width * (child?.w || 1)) / 2 ${o*(c?.widthInColumns??1)/2}`),r=c.size.x+v,c.size.y=u.size.y-u.size.height/2+b*(x+C)+x/2+C,L.debug(`abc88 layout blocks (calc) px, pyid:${c.id}startingPosX${r}${C}${v}=>x:${c.size.x}y:${c.size.y}${c.widthInColumns}(width * (child?.w || 1)) / 2${o*(c?.widthInColumns??1)/2}`)}c.children&&Et(c);let S=c?.widthInColumns??1;a>0&&(S=Math.min(S,a-s%a)),s+=S,L.debug("abc88 columnsPos",c,s)}}L.debug(`layout blocks (<==layoutBlocks) ${e.id} x: ${e?.size?.x} y: ${e?.size?.y} width: ${e?.size?.width}`)}d(Et,"layoutBlocks");function _t(e,{minX:t,minY:a,maxX:i,maxY:l}={minX:0,minY:0,maxX:0,maxY:0}){if(e.size&&e.id!=="root"){const{x:s,y:r,width:n,height:c}=e.size;s-n/2<t&&(t=s-n/2),r-c/2<a&&(a=r-c/2),s+n/2>i&&(i=s+n/2),r+c/2>l&&(l=r+c/2)}if(e.children)for(const s of e.children)({minX:t,minY:a,maxX:i,maxY:l}=_t(s,{minX:t,minY:a,maxX:i,maxY:l}));return{minX:t,minY:a,maxX:i,maxY:l}}d(_t,"findBounds");function jt(e){const t=e.getBlock("root");if(!t)return;ot(t,e,0,0),Et(t),L.debug("getBlocks",JSON.stringify(t,null,2));const{minX:a,minY:i,maxX:l,maxY:s}=_t(t),r=s-i,n=l-a;return{x:a,y:i,width:n,height:r}}d(jt,"layout");function mt(e,t){t&&e.attr("style",t)}d(mt,"applyStyle");function Vt(e,t){const a=O(document.createElementNS("http://www.w3.org/2000/svg","foreignObject")),i=a.append("xhtml:div"),l=e.label,s=e.isNode?"nodeLabel":"edgeLabel",r=i.append("span");return r.html(yt(l,t)),mt(r,e.labelStyle),r.attr("class",s),mt(i,e.labelStyle),i.style("display","inline-block"),i.style("white-space","nowrap"),i.attr("xmlns","http://www.w3.org/1999/xhtml"),a.node()}d(Vt,"addHtmlLabel");var ir=d(async(e,t,a,i)=>{let l=e||"";typeof l=="object"&&(l=l[0]);const s=R();if(j(s.flowchart.htmlLabels)){l=l.replace(/\\n|\n/g,"<br />"),L.debug("vertexText"+l);const r=await we(xt(l)),n={isNode:i,label:r,labelStyle:t.replace("fill:","color:")};return Vt(n,s)}else{const r=document.createElementNS("http://www.w3.org/2000/svg","text");r.setAttribute("style",t.replace("color:","fill:"));let n=[];typeof l=="string"?n=l.split(/\\n|\n|<br\s*\/?>/gi):Array.isArray(l)?n=l:n=[];for(const c of n){const u=document.createElementNS("http://www.w3.org/2000/svg","tspan");u.setAttributeNS("http://www.w3.org/XML/1998/namespace","xml:space","preserve"),u.setAttribute("dy","1em"),u.setAttribute("x","0"),a?u.setAttribute("class","title-row"):u.setAttribute("class","row"),u.textContent=c.trim(),r.appendChild(u)}return r}},"createLabel"),K=ir,nr=d((e,t,a,i,l)=>{t.arrowTypeStart&&Ot(e,"start",t.arrowTypeStart,a,i,l),t.arrowTypeEnd&&Ot(e,"end",t.arrowTypeEnd,a,i,l)},"addEdgeMarkers"),lr={arrow_cross:"cross",arrow_point:"point",arrow_barb:"barb",arrow_circle:"circle",aggregation:"aggregation",extension:"extension",composition:"composition",dependency:"dependency",lollipop:"lollipop"},Ot=d((e,t,a,i,l,s)=>{const r=lr[a];if(!r){L.warn(`Unknown arrow type: ${a}`);return}const n=t==="start"?"Start":"End";e.attr(`marker-${t}`,`url(${i}#${l}_${s}-${r}${n})`)},"addEdgeMarker"),Lt={},M={},cr=d(async(e,t)=>{const a=R(),i=j(a.flowchart.htmlLabels),l=t.labelType==="markdown"?Wt(e,t.label,{style:t.labelStyle,useHtmlLabels:i,addSvgBackground:!0},a):await K(t.label,t.labelStyle),s=e.insert("g").attr("class","edgeLabel"),r=s.insert("g").attr("class","label");r.node().appendChild(l);let n=l.getBBox();if(i){const u=l.children[0],o=O(l);n=u.getBoundingClientRect(),o.attr("width",n.width),o.attr("height",n.height)}r.attr("transform","translate("+-n.width/2+", "+-n.height/2+")"),Lt[t.id]=s,t.width=n.width,t.height=n.height;let c;if(t.startLabelLeft){const u=await K(t.startLabelLeft,t.labelStyle),o=e.insert("g").attr("class","edgeTerminals"),x=o.insert("g").attr("class","inner");c=x.node().appendChild(u);const w=u.getBBox();x.attr("transform","translate("+-w.width/2+", "+-w.height/2+")"),M[t.id]||(M[t.id]={}),M[t.id].startLeft=o,tt(c,t.startLabelLeft)}if(t.startLabelRight){const u=await K(t.startLabelRight,t.labelStyle),o=e.insert("g").attr("class","edgeTerminals"),x=o.insert("g").attr("class","inner");c=o.node().appendChild(u),x.node().appendChild(u);const w=u.getBBox();x.attr("transform","translate("+-w.width/2+", "+-w.height/2+")"),M[t.id]||(M[t.id]={}),M[t.id].startRight=o,tt(c,t.startLabelRight)}if(t.endLabelLeft){const u=await K(t.endLabelLeft,t.labelStyle),o=e.insert("g").attr("class","edgeTerminals"),x=o.insert("g").attr("class","inner");c=x.node().appendChild(u);const w=u.getBBox();x.attr("transform","translate("+-w.width/2+", "+-w.height/2+")"),o.node().appendChild(u),M[t.id]||(M[t.id]={}),M[t.id].endLeft=o,tt(c,t.endLabelLeft)}if(t.endLabelRight){const u=await K(t.endLabelRight,t.labelStyle),o=e.insert("g").attr("class","edgeTerminals"),x=o.insert("g").attr("class","inner");c=x.node().appendChild(u);const w=u.getBBox();x.attr("transform","translate("+-w.width/2+", "+-w.height/2+")"),o.node().appendChild(u),M[t.id]||(M[t.id]={}),M[t.id].endRight=o,tt(c,t.endLabelRight)}return l},"insertEdgeLabel");function tt(e,t){R().flowchart.htmlLabels&&e&&(e.style.width=t.length*9+"px",e.style.height="12px")}d(tt,"setTerminalWidth");var or=d((e,t)=>{L.debug("Moving label abc88 ",e.id,e.label,Lt[e.id],t);let a=t.updatedPath?t.updatedPath:t.originalPath;const i=R(),{subGraphTitleTotalMargin:l}=ye(i);if(e.label){const s=Lt[e.id];let r=e.x,n=e.y;if(a){const c=$.calcLabelPosition(a);L.debug("Moving label "+e.label+" from (",r,",",n,") to (",c.x,",",c.y,") abc88"),t.updatedPath&&(r=c.x,n=c.y)}s.attr("transform",`translate(${r}, ${n+l/2})`)}if(e.startLabelLeft){const s=M[e.id].startLeft;let r=e.x,n=e.y;if(a){const c=$.calcTerminalLabelPosition(e.arrowTypeStart?10:0,"start_left",a);r=c.x,n=c.y}s.attr("transform",`translate(${r}, ${n})`)}if(e.startLabelRight){const s=M[e.id].startRight;let r=e.x,n=e.y;if(a){const c=$.calcTerminalLabelPosition(e.arrowTypeStart?10:0,"start_right",a);r=c.x,n=c.y}s.attr("transform",`translate(${r}, ${n})`)}if(e.endLabelLeft){const s=M[e.id].endLeft;let r=e.x,n=e.y;if(a){const c=$.calcTerminalLabelPosition(e.arrowTypeEnd?10:0,"end_left",a);r=c.x,n=c.y}s.attr("transform",`translate(${r}, ${n})`)}if(e.endLabelRight){const s=M[e.id].endRight;let r=e.x,n=e.y;if(a){const c=$.calcTerminalLabelPosition(e.arrowTypeEnd?10:0,"end_right",a);r=c.x,n=c.y}s.attr("transform",`translate(${r}, ${n})`)}},"positionEdgeLabel"),hr=d((e,t)=>{const a=e.x,i=e.y,l=Math.abs(t.x-a),s=Math.abs(t.y-i),r=e.width/2,n=e.height/2;return l>=r||s>=n},"outsideNode"),dr=d((e,t,a)=>{L.debug(`intersection calc abc89:
-  outsidePoint: ${JSON.stringify(t)}
-  insidePoint : ${JSON.stringify(a)}
-  node        : x:${e.x} y:${e.y} w:${e.width} h:${e.height}`);const i=e.x,l=e.y,s=Math.abs(i-a.x),r=e.width/2;let n=a.x<t.x?r-s:r+s;const c=e.height/2,u=Math.abs(t.y-a.y),o=Math.abs(t.x-a.x);if(Math.abs(l-t.y)*r>Math.abs(i-t.x)*c){let x=a.y<t.y?t.y-c-l:l-c-t.y;n=o*x/u;const w={x:a.x<t.x?a.x+n:a.x-o+n,y:a.y<t.y?a.y+u-x:a.y-u+x};return n===0&&(w.x=t.x,w.y=t.y),o===0&&(w.x=t.x),u===0&&(w.y=t.y),L.debug(`abc89 topp/bott calc, Q ${u}, q ${x}, R ${o}, r ${n}`,w),w}else{a.x<t.x?n=t.x-r-i:n=i-r-t.x;let x=u*n/o,w=a.x<t.x?a.x+o-n:a.x-o+n,b=a.y<t.y?a.y+x:a.y-x;return L.debug(`sides calc abc89, Q ${u}, q ${x}, R ${o}, r ${n}`,{_x:w,_y:b}),n===0&&(w=t.x,b=t.y),o===0&&(w=t.x),u===0&&(b=t.y),{x:w,y:b}}},"intersection"),Rt=d((e,t)=>{L.debug("abc88 cutPathAtIntersect",e,t);let a=[],i=e[0],l=!1;return e.forEach(s=>{if(!hr(t,s)&&!l){const r=dr(t,i,s);let n=!1;a.forEach(c=>{n=n||c.x===r.x&&c.y===r.y}),a.some(c=>c.x===r.x&&c.y===r.y)||a.push(r),l=!0}else i=s,l||a.push(s)}),a},"cutPathAtIntersect"),gr=d(function(e,t,a,i,l,s,r){let n=a.points;L.debug("abc88 InsertEdge: edge=",a,"e=",t);let c=!1;const u=s.node(t.v);var o=s.node(t.w);o?.intersect&&u?.intersect&&(n=n.slice(1,a.points.length-1),n.unshift(u.intersect(n[0])),n.push(o.intersect(n[n.length-1]))),a.toCluster&&(L.debug("to cluster abc88",i[a.toCluster]),n=Rt(a.points,i[a.toCluster].node),c=!0),a.fromCluster&&(L.debug("from cluster abc88",i[a.fromCluster]),n=Rt(n.reverse(),i[a.fromCluster].node).reverse(),c=!0);const x=n.filter(y=>!Number.isNaN(y.y));let w=fe;a.curve&&(l==="graph"||l==="flowchart")&&(w=a.curve);const{x:b,y:S}=ue(a),v=pe().x(b).y(S).curve(w);let k;switch(a.thickness){case"normal":k="edge-thickness-normal";break;case"thick":k="edge-thickness-thick";break;case"invisible":k="edge-thickness-thick";break;default:k=""}switch(a.pattern){case"solid":k+=" edge-pattern-solid";break;case"dotted":k+=" edge-pattern-dotted";break;case"dashed":k+=" edge-pattern-dashed";break}const B=e.append("path").attr("d",v(x)).attr("id",a.id).attr("class"," "+k+(a.classes?" "+a.classes:"")).attr("style",a.style);let _="";(R().flowchart.arrowMarkerAbsolute||R().state.arrowMarkerAbsolute)&&(_=xe(!0)),nr(B,a,_,r,l);let D={};return c&&(D.updatedPath=n),D.originalPath=a.points,D},"insertEdge"),ur=d(e=>{const t=new Set;for(const a of e)switch(a){case"x":t.add("right"),t.add("left");break;case"y":t.add("up"),t.add("down");break;default:t.add(a);break}return t},"expandAndDeduplicateDirections"),pr=d((e,t,a)=>{const i=ur(e),l=2,s=t.height+2*a.padding,r=s/l,n=t.width+2*r+a.padding,c=a.padding/2;return i.has("right")&&i.has("left")&&i.has("up")&&i.has("down")?[{x:0,y:0},{x:r,y:0},{x:n/2,y:2*c},{x:n-r,y:0},{x:n,y:0},{x:n,y:-s/3},{x:n+2*c,y:-s/2},{x:n,y:-2*s/3},{x:n,y:-s},{x:n-r,y:-s},{x:n/2,y:-s-2*c},{x:r,y:-s},{x:0,y:-s},{x:0,y:-2*s/3},{x:-2*c,y:-s/2},{x:0,y:-s/3}]:i.has("right")&&i.has("left")&&i.has("up")?[{x:r,y:0},{x:n-r,y:0},{x:n,y:-s/2},{x:n-r,y:-s},{x:r,y:-s},{x:0,y:-s/2}]:i.has("right")&&i.has("left")&&i.has("down")?[{x:0,y:0},{x:r,y:-s},{x:n-r,y:-s},{x:n,y:0}]:i.has("right")&&i.has("up")&&i.has("down")?[{x:0,y:0},{x:n,y:-r},{x:n,y:-s+r},{x:0,y:-s}]:i.has("left")&&i.has("up")&&i.has("down")?[{x:n,y:0},{x:0,y:-r},{x:0,y:-s+r},{x:n,y:-s}]:i.has("right")&&i.has("left")?[{x:r,y:0},{x:r,y:-c},{x:n-r,y:-c},{x:n-r,y:0},{x:n,y:-s/2},{x:n-r,y:-s},{x:n-r,y:-s+c},{x:r,y:-s+c},{x:r,y:-s},{x:0,y:-s/2}]:i.has("up")&&i.has("down")?[{x:n/2,y:0},{x:0,y:-c},{x:r,y:-c},{x:r,y:-s+c},{x:0,y:-s+c},{x:n/2,y:-s},{x:n,y:-s+c},{x:n-r,y:-s+c},{x:n-r,y:-c},{x:n,y:-c}]:i.has("right")&&i.has("up")?[{x:0,y:0},{x:n,y:-r},{x:0,y:-s}]:i.has("right")&&i.has("down")?[{x:0,y:0},{x:n,y:0},{x:0,y:-s}]:i.has("left")&&i.has("up")?[{x:n,y:0},{x:0,y:-r},{x:n,y:-s}]:i.has("left")&&i.has("down")?[{x:n,y:0},{x:0,y:0},{x:n,y:-s}]:i.has("right")?[{x:r,y:-c},{x:r,y:-c},{x:n-r,y:-c},{x:n-r,y:0},{x:n,y:-s/2},{x:n-r,y:-s},{x:n-r,y:-s+c},{x:r,y:-s+c},{x:r,y:-s+c}]:i.has("left")?[{x:r,y:0},{x:r,y:-c},{x:n-r,y:-c},{x:n-r,y:-s+c},{x:r,y:-s+c},{x:r,y:-s},{x:0,y:-s/2}]:i.has("up")?[{x:r,y:-c},{x:r,y:-s+c},{x:0,y:-s+c},{x:n/2,y:-s},{x:n,y:-s+c},{x:n-r,y:-s+c},{x:n-r,y:-c}]:i.has("down")?[{x:n/2,y:0},{x:0,y:-c},{x:r,y:-c},{x:r,y:-s+c},{x:n-r,y:-s+c},{x:n-r,y:-c},{x:n,y:-c}]:[{x:0,y:0}]},"getArrowPoints");function Gt(e,t){return e.intersect(t)}d(Gt,"intersectNode");var fr=Gt;function Zt(e,t,a,i){var l=e.x,s=e.y,r=l-i.x,n=s-i.y,c=Math.sqrt(t*t*n*n+a*a*r*r),u=Math.abs(t*a*r/c);i.x<l&&(u=-u);var o=Math.abs(t*a*n/c);return i.y<s&&(o=-o),{x:l+u,y:s+o}}d(Zt,"intersectEllipse");var qt=Zt;function Jt(e,t,a){return qt(e,t,t,a)}d(Jt,"intersectCircle");var xr=Jt;function Qt(e,t,a,i){var l,s,r,n,c,u,o,x,w,b,S,v,k,B,_;if(l=t.y-e.y,r=e.x-t.x,c=t.x*e.y-e.x*t.y,w=l*a.x+r*a.y+c,b=l*i.x+r*i.y+c,!(w!==0&&b!==0&&St(w,b))&&(s=i.y-a.y,n=a.x-i.x,u=i.x*a.y-a.x*i.y,o=s*e.x+n*e.y+u,x=s*t.x+n*t.y+u,!(o!==0&&x!==0&&St(o,x))&&(S=l*n-s*r,S!==0)))return v=Math.abs(S/2),k=r*u-n*c,B=k<0?(k-v)/S:(k+v)/S,k=s*c-l*u,_=k<0?(k-v)/S:(k+v)/S,{x:B,y:_}}d(Qt,"intersectLine");function St(e,t){return e*t>0}d(St,"sameSign");var yr=Qt,br=$t;function $t(e,t,a){var i=e.x,l=e.y,s=[],r=Number.POSITIVE_INFINITY,n=Number.POSITIVE_INFINITY;typeof t.forEach=="function"?t.forEach(function(S){r=Math.min(r,S.x),n=Math.min(n,S.y)}):(r=Math.min(r,t.x),n=Math.min(n,t.y));for(var c=i-e.width/2-r,u=l-e.height/2-n,o=0;o<t.length;o++){var x=t[o],w=t[o<t.length-1?o+1:0],b=yr(e,a,{x:c+x.x,y:u+x.y},{x:c+w.x,y:u+w.y});b&&s.push(b)}return s.length?(s.length>1&&s.sort(function(S,v){var k=S.x-a.x,B=S.y-a.y,_=Math.sqrt(k*k+B*B),D=v.x-a.x,y=v.y-a.y,g=Math.sqrt(D*D+y*y);return _<g?-1:_===g?0:1}),s[0]):e}d($t,"intersectPolygon");var wr=d((e,t)=>{var a=e.x,i=e.y,l=t.x-a,s=t.y-i,r=e.width/2,n=e.height/2,c,u;return Math.abs(s)*r>Math.abs(l)*n?(s<0&&(n=-n),c=s===0?0:n*l/s,u=n):(l<0&&(r=-r),c=r,u=l===0?0:r*s/l),{x:a+c,y:i+u}},"intersectRect"),mr=wr,N={node:fr,circle:xr,ellipse:qt,polygon:br,rect:mr},A=d(async(e,t,a,i)=>{const l=R();let s;const r=t.useHtmlLabels||j(l.flowchart.htmlLabels);a?s=a:s="node default";const n=e.insert("g").attr("class",s).attr("id",t.domId||t.id),c=n.insert("g").attr("class","label").attr("style",t.labelStyle);let u;t.labelText===void 0?u="":u=typeof t.labelText=="string"?t.labelText:t.labelText[0];const o=c.node();let x;t.labelType==="markdown"?x=Wt(c,yt(xt(u),l),{useHtmlLabels:r,width:t.width||l.flowchart.wrappingWidth,classes:"markdown-node-label"},l):x=o.appendChild(await K(yt(xt(u),l),t.labelStyle,!1,i));let w=x.getBBox();const b=t.padding/2;if(j(l.flowchart.htmlLabels)){const S=x.children[0],v=O(x),k=S.getElementsByTagName("img");if(k){const B=u.replace(/<img[^>]*>/g,"").trim()==="";await Promise.all([...k].map(_=>new Promise(D=>{function y(){if(_.style.display="flex",_.style.flexDirection="column",B){const g=l.fontSize?l.fontSize:window.getComputedStyle(document.body).fontSize,m=parseInt(g,10)*5+"px";_.style.minWidth=m,_.style.maxWidth=m}else _.style.width="100%";D(_)}d(y,"setupImage"),setTimeout(()=>{_.complete&&y()}),_.addEventListener("error",y),_.addEventListener("load",y)})))}w=S.getBoundingClientRect(),v.attr("width",w.width),v.attr("height",w.height)}return r?c.attr("transform","translate("+-w.width/2+", "+-w.height/2+")"):c.attr("transform","translate(0, "+-w.height/2+")"),t.centerLabel&&c.attr("transform","translate("+-w.width/2+", "+-w.height/2+")"),c.insert("rect",":first-child"),{shapeSvg:n,bbox:w,halfPadding:b,label:c}},"labelHelper"),T=d((e,t)=>{const a=t.node().getBBox();e.width=a.width,e.height=a.height},"updateNodeBounds");function U(e,t,a,i){return e.insert("polygon",":first-child").attr("points",i.map(function(l){return l.x+","+l.y}).join(" ")).attr("class","label-container").attr("transform","translate("+-t/2+","+a/2+")")}d(U,"insertPolygonShape");var Lr=d(async(e,t)=>{t.useHtmlLabels||R().flowchart.htmlLabels||(t.centerLabel=!0);const{shapeSvg:i,bbox:l,halfPadding:s}=await A(e,t,"node "+t.classes,!0);L.info("Classes = ",t.classes);const r=i.insert("rect",":first-child");return r.attr("rx",t.rx).attr("ry",t.ry).attr("x",-l.width/2-s).attr("y",-l.height/2-s).attr("width",l.width+t.padding).attr("height",l.height+t.padding),T(t,r),t.intersect=function(n){return N.rect(t,n)},i},"note"),Sr=Lr,zt=d(e=>e?" "+e:"","formatClass"),Y=d((e,t)=>`${t||"node default"}${zt(e.classes)} ${zt(e.class)}`,"getClassesFromNode"),At=d(async(e,t)=>{const{shapeSvg:a,bbox:i}=await A(e,t,Y(t,void 0),!0),l=i.width+t.padding,s=i.height+t.padding,r=l+s,n=[{x:r/2,y:0},{x:r,y:-r/2},{x:r/2,y:-r},{x:0,y:-r/2}];L.info("Question main (Circle)");const c=U(a,r,r,n);return c.attr("style",t.style),T(t,c),t.intersect=function(u){return L.warn("Intersect called"),N.polygon(t,n,u)},a},"question"),kr=d((e,t)=>{const a=e.insert("g").attr("class","node default").attr("id",t.domId||t.id),i=28,l=[{x:0,y:i/2},{x:i/2,y:0},{x:0,y:-i/2},{x:-i/2,y:0}];return a.insert("polygon",":first-child").attr("points",l.map(function(r){return r.x+","+r.y}).join(" ")).attr("class","state-start").attr("r",7).attr("width",28).attr("height",28),t.width=28,t.height=28,t.intersect=function(r){return N.circle(t,14,r)},a},"choice"),vr=d(async(e,t)=>{const{shapeSvg:a,bbox:i}=await A(e,t,Y(t,void 0),!0),l=4,s=i.height+t.padding,r=s/l,n=i.width+2*r+t.padding,c=[{x:r,y:0},{x:n-r,y:0},{x:n,y:-s/2},{x:n-r,y:-s},{x:r,y:-s},{x:0,y:-s/2}],u=U(a,n,s,c);return u.attr("style",t.style),T(t,u),t.intersect=function(o){return N.polygon(t,c,o)},a},"hexagon"),Er=d(async(e,t)=>{const{shapeSvg:a,bbox:i}=await A(e,t,void 0,!0),l=2,s=i.height+2*t.padding,r=s/l,n=i.width+2*r+t.padding,c=pr(t.directions,i,t),u=U(a,n,s,c);return u.attr("style",t.style),T(t,u),t.intersect=function(o){return N.polygon(t,c,o)},a},"block_arrow"),_r=d(async(e,t)=>{const{shapeSvg:a,bbox:i}=await A(e,t,Y(t,void 0),!0),l=i.width+t.padding,s=i.height+t.padding,r=[{x:-s/2,y:0},{x:l,y:0},{x:l,y:-s},{x:-s/2,y:-s},{x:0,y:-s/2}];return U(a,l,s,r).attr("style",t.style),t.width=l+s,t.height=s,t.intersect=function(c){return N.polygon(t,r,c)},a},"rect_left_inv_arrow"),Dr=d(async(e,t)=>{const{shapeSvg:a,bbox:i}=await A(e,t,Y(t),!0),l=i.width+t.padding,s=i.height+t.padding,r=[{x:-2*s/6,y:0},{x:l-s/6,y:0},{x:l+2*s/6,y:-s},{x:s/6,y:-s}],n=U(a,l,s,r);return n.attr("style",t.style),T(t,n),t.intersect=function(c){return N.polygon(t,r,c)},a},"lean_right"),Nr=d(async(e,t)=>{const{shapeSvg:a,bbox:i}=await A(e,t,Y(t,void 0),!0),l=i.width+t.padding,s=i.height+t.padding,r=[{x:2*s/6,y:0},{x:l+s/6,y:0},{x:l-2*s/6,y:-s},{x:-s/6,y:-s}],n=U(a,l,s,r);return n.attr("style",t.style),T(t,n),t.intersect=function(c){return N.polygon(t,r,c)},a},"lean_left"),Tr=d(async(e,t)=>{const{shapeSvg:a,bbox:i}=await A(e,t,Y(t,void 0),!0),l=i.width+t.padding,s=i.height+t.padding,r=[{x:-2*s/6,y:0},{x:l+2*s/6,y:0},{x:l-s/6,y:-s},{x:s/6,y:-s}],n=U(a,l,s,r);return n.attr("style",t.style),T(t,n),t.intersect=function(c){return N.polygon(t,r,c)},a},"trapezoid"),Br=d(async(e,t)=>{const{shapeSvg:a,bbox:i}=await A(e,t,Y(t,void 0),!0),l=i.width+t.padding,s=i.height+t.padding,r=[{x:s/6,y:0},{x:l-s/6,y:0},{x:l+2*s/6,y:-s},{x:-2*s/6,y:-s}],n=U(a,l,s,r);return n.attr("style",t.style),T(t,n),t.intersect=function(c){return N.polygon(t,r,c)},a},"inv_trapezoid"),Cr=d(async(e,t)=>{const{shapeSvg:a,bbox:i}=await A(e,t,Y(t,void 0),!0),l=i.width+t.padding,s=i.height+t.padding,r=[{x:0,y:0},{x:l+s/2,y:0},{x:l,y:-s/2},{x:l+s/2,y:-s},{x:0,y:-s}],n=U(a,l,s,r);return n.attr("style",t.style),T(t,n),t.intersect=function(c){return N.polygon(t,r,c)},a},"rect_right_inv_arrow"),Ir=d(async(e,t)=>{const{shapeSvg:a,bbox:i}=await A(e,t,Y(t,void 0),!0),l=i.width+t.padding,s=l/2,r=s/(2.5+l/50),n=i.height+r+t.padding,c="M 0,"+r+" a "+s+","+r+" 0,0,0 "+l+" 0 a "+s+","+r+" 0,0,0 "+-l+" 0 l 0,"+n+" a "+s+","+r+" 0,0,0 "+l+" 0 l 0,"+-n,u=a.attr("label-offset-y",r).insert("path",":first-child").attr("style",t.style).attr("d",c).attr("transform","translate("+-l/2+","+-(n/2+r)+")");return T(t,u),t.intersect=function(o){const x=N.rect(t,o),w=x.x-t.x;if(s!=0&&(Math.abs(w)<t.width/2||Math.abs(w)==t.width/2&&Math.abs(x.y-t.y)>t.height/2-r)){let b=r*r*(1-w*w/(s*s));b!=0&&(b=Math.sqrt(b)),b=r-b,o.y-t.y>0&&(b=-b),x.y+=b}return x},a},"cylinder"),Or=d(async(e,t)=>{const{shapeSvg:a,bbox:i,halfPadding:l}=await A(e,t,"node "+t.classes+" "+t.class,!0),s=a.insert("rect",":first-child"),r=t.positioned?t.width:i.width+t.padding,n=t.positioned?t.height:i.height+t.padding,c=t.positioned?-r/2:-i.width/2-l,u=t.positioned?-n/2:-i.height/2-l;if(s.attr("class","basic label-container").attr("style",t.style).attr("rx",t.rx).attr("ry",t.ry).attr("x",c).attr("y",u).attr("width",r).attr("height",n),t.props){const o=new Set(Object.keys(t.props));t.props.borders&&(ht(s,t.props.borders,r,n),o.delete("borders")),o.forEach(x=>{L.warn(`Unknown node property ${x}`)})}return T(t,s),t.intersect=function(o){return N.rect(t,o)},a},"rect"),Rr=d(async(e,t)=>{const{shapeSvg:a,bbox:i,halfPadding:l}=await A(e,t,"node "+t.classes,!0),s=a.insert("rect",":first-child"),r=t.positioned?t.width:i.width+t.padding,n=t.positioned?t.height:i.height+t.padding,c=t.positioned?-r/2:-i.width/2-l,u=t.positioned?-n/2:-i.height/2-l;if(s.attr("class","basic cluster composite label-container").attr("style",t.style).attr("rx",t.rx).attr("ry",t.ry).attr("x",c).attr("y",u).attr("width",r).attr("height",n),t.props){const o=new Set(Object.keys(t.props));t.props.borders&&(ht(s,t.props.borders,r,n),o.delete("borders")),o.forEach(x=>{L.warn(`Unknown node property ${x}`)})}return T(t,s),t.intersect=function(o){return N.rect(t,o)},a},"composite"),zr=d(async(e,t)=>{const{shapeSvg:a}=await A(e,t,"label",!0);L.trace("Classes = ",t.class);const i=a.insert("rect",":first-child"),l=0,s=0;if(i.attr("width",l).attr("height",s),a.attr("class","label edgeLabel"),t.props){const r=new Set(Object.keys(t.props));t.props.borders&&(ht(i,t.props.borders,l,s),r.delete("borders")),r.forEach(n=>{L.warn(`Unknown node property ${n}`)})}return T(t,i),t.intersect=function(r){return N.rect(t,r)},a},"labelRect");function ht(e,t,a,i){const l=[],s=d(n=>{l.push(n,0)},"addBorder"),r=d(n=>{l.push(0,n)},"skipBorder");t.includes("t")?(L.debug("add top border"),s(a)):r(a),t.includes("r")?(L.debug("add right border"),s(i)):r(i),t.includes("b")?(L.debug("add bottom border"),s(a)):r(a),t.includes("l")?(L.debug("add left border"),s(i)):r(i),e.attr("stroke-dasharray",l.join(" "))}d(ht,"applyNodePropertyBorders");var Ar=d(async(e,t)=>{let a;t.classes?a="node "+t.classes:a="node default";const i=e.insert("g").attr("class",a).attr("id",t.domId||t.id),l=i.insert("rect",":first-child"),s=i.insert("line"),r=i.insert("g").attr("class","label"),n=t.labelText.flat?t.labelText.flat():t.labelText;let c="";typeof n=="object"?c=n[0]:c=n,L.info("Label text abc79",c,n,typeof n=="object");const u=r.node().appendChild(await K(c,t.labelStyle,!0,!0));let o={width:0,height:0};if(j(R().flowchart.htmlLabels)){const v=u.children[0],k=O(u);o=v.getBoundingClientRect(),k.attr("width",o.width),k.attr("height",o.height)}L.info("Text 2",n);const x=n.slice(1,n.length);let w=u.getBBox();const b=r.node().appendChild(await K(x.join?x.join("<br/>"):x,t.labelStyle,!0,!0));if(j(R().flowchart.htmlLabels)){const v=b.children[0],k=O(b);o=v.getBoundingClientRect(),k.attr("width",o.width),k.attr("height",o.height)}const S=t.padding/2;return O(b).attr("transform","translate( "+(o.width>w.width?0:(w.width-o.width)/2)+", "+(w.height+S+5)+")"),O(u).attr("transform","translate( "+(o.width<w.width?0:-(w.width-o.width)/2)+", 0)"),o=r.node().getBBox(),r.attr("transform","translate("+-o.width/2+", "+(-o.height/2-S+3)+")"),l.attr("class","outer title-state").attr("x",-o.width/2-S).attr("y",-o.height/2-S).attr("width",o.width+t.padding).attr("height",o.height+t.padding),s.attr("class","divider").attr("x1",-o.width/2-S).attr("x2",o.width/2+S).attr("y1",-o.height/2-S+w.height+S).attr("y2",-o.height/2-S+w.height+S),T(t,l),t.intersect=function(v){return N.rect(t,v)},i},"rectWithTitle"),Mr=d(async(e,t)=>{const{shapeSvg:a,bbox:i}=await A(e,t,Y(t,void 0),!0),l=i.height+t.padding,s=i.width+l/4+t.padding,r=a.insert("rect",":first-child").attr("style",t.style).attr("rx",l/2).attr("ry",l/2).attr("x",-s/2).attr("y",-l/2).attr("width",s).attr("height",l);return T(t,r),t.intersect=function(n){return N.rect(t,n)},a},"stadium"),Fr=d(async(e,t)=>{const{shapeSvg:a,bbox:i,halfPadding:l}=await A(e,t,Y(t,void 0),!0),s=a.insert("circle",":first-child");return s.attr("style",t.style).attr("rx",t.rx).attr("ry",t.ry).attr("r",i.width/2+l).attr("width",i.width+t.padding).attr("height",i.height+t.padding),L.info("Circle main"),T(t,s),t.intersect=function(r){return L.info("Circle intersect",t,i.width/2+l,r),N.circle(t,i.width/2+l,r)},a},"circle"),Wr=d(async(e,t)=>{const{shapeSvg:a,bbox:i,halfPadding:l}=await A(e,t,Y(t,void 0),!0),s=5,r=a.insert("g",":first-child"),n=r.insert("circle"),c=r.insert("circle");return r.attr("class",t.class),n.attr("style",t.style).attr("rx",t.rx).attr("ry",t.ry).attr("r",i.width/2+l+s).attr("width",i.width+t.padding+s*2).attr("height",i.height+t.padding+s*2),c.attr("style",t.style).attr("rx",t.rx).attr("ry",t.ry).attr("r",i.width/2+l).attr("width",i.width+t.padding).attr("height",i.height+t.padding),L.info("DoubleCircle main"),T(t,n),t.intersect=function(u){return L.info("DoubleCircle intersect",t,i.width/2+l+s,u),N.circle(t,i.width/2+l+s,u)},a},"doublecircle"),Pr=d(async(e,t)=>{const{shapeSvg:a,bbox:i}=await A(e,t,Y(t,void 0),!0),l=i.width+t.padding,s=i.height+t.padding,r=[{x:0,y:0},{x:l,y:0},{x:l,y:-s},{x:0,y:-s},{x:0,y:0},{x:-8,y:0},{x:l+8,y:0},{x:l+8,y:-s},{x:-8,y:-s},{x:-8,y:0}],n=U(a,l,s,r);return n.attr("style",t.style),T(t,n),t.intersect=function(c){return N.polygon(t,r,c)},a},"subroutine"),Yr=d((e,t)=>{const a=e.insert("g").attr("class","node default").attr("id",t.domId||t.id),i=a.insert("circle",":first-child");return i.attr("class","state-start").attr("r",7).attr("width",14).attr("height",14),T(t,i),t.intersect=function(l){return N.circle(t,7,l)},a},"start"),Mt=d((e,t,a)=>{const i=e.insert("g").attr("class","node default").attr("id",t.domId||t.id);let l=70,s=10;a==="LR"&&(l=10,s=70);const r=i.append("rect").attr("x",-1*l/2).attr("y",-1*s/2).attr("width",l).attr("height",s).attr("class","fork-join");return T(t,r),t.height=t.height+t.padding/2,t.width=t.width+t.padding/2,t.intersect=function(n){return N.rect(t,n)},i},"forkJoin"),Hr=d((e,t)=>{const a=e.insert("g").attr("class","node default").attr("id",t.domId||t.id),i=a.insert("circle",":first-child"),l=a.insert("circle",":first-child");return l.attr("class","state-start").attr("r",7).attr("width",14).attr("height",14),i.attr("class","state-end").attr("r",5).attr("width",10).attr("height",10),T(t,l),t.intersect=function(s){return N.circle(t,7,s)},a},"end"),Kr=d(async(e,t)=>{const a=t.padding/2,i=4,l=8;let s;t.classes?s="node "+t.classes:s="node default";const r=e.insert("g").attr("class",s).attr("id",t.domId||t.id),n=r.insert("rect",":first-child"),c=r.insert("line"),u=r.insert("line");let o=0,x=i;const w=r.insert("g").attr("class","label");let b=0;const S=t.classData.annotations?.[0],v=t.classData.annotations[0]?"«"+t.classData.annotations[0]+"»":"",k=w.node().appendChild(await K(v,t.labelStyle,!0,!0));let B=k.getBBox();if(j(R().flowchart.htmlLabels)){const E=k.children[0],h=O(k);B=E.getBoundingClientRect(),h.attr("width",B.width),h.attr("height",B.height)}t.classData.annotations[0]&&(x+=B.height+i,o+=B.width);let _=t.classData.label;t.classData.type!==void 0&&t.classData.type!==""&&(R().flowchart.htmlLabels?_+="&lt;"+t.classData.type+"&gt;":_+="<"+t.classData.type+">");const D=w.node().appendChild(await K(_,t.labelStyle,!0,!0));O(D).attr("class","classTitle");let y=D.getBBox();if(j(R().flowchart.htmlLabels)){const E=D.children[0],h=O(D);y=E.getBoundingClientRect(),h.attr("width",y.width),h.attr("height",y.height)}x+=y.height+i,y.width>o&&(o=y.width);const g=[];t.classData.members.forEach(async E=>{const h=E.getDisplayDetails();let W=h.displayText;R().flowchart.htmlLabels&&(W=W.replace(/</g,"&lt;").replace(/>/g,"&gt;"));const p=w.node().appendChild(await K(W,h.cssStyle?h.cssStyle:t.labelStyle,!0,!0));let I=p.getBBox();if(j(R().flowchart.htmlLabels)){const Z=p.children[0],V=O(p);I=Z.getBoundingClientRect(),V.attr("width",I.width),V.attr("height",I.height)}I.width>o&&(o=I.width),x+=I.height+i,g.push(p)}),x+=l;const f=[];if(t.classData.methods.forEach(async E=>{const h=E.getDisplayDetails();let W=h.displayText;R().flowchart.htmlLabels&&(W=W.replace(/</g,"&lt;").replace(/>/g,"&gt;"));const p=w.node().appendChild(await K(W,h.cssStyle?h.cssStyle:t.labelStyle,!0,!0));let I=p.getBBox();if(j(R().flowchart.htmlLabels)){const Z=p.children[0],V=O(p);I=Z.getBoundingClientRect(),V.attr("width",I.width),V.attr("height",I.height)}I.width>o&&(o=I.width),x+=I.height+i,f.push(p)}),x+=l,S){let E=(o-B.width)/2;O(k).attr("transform","translate( "+(-1*o/2+E)+", "+-1*x/2+")"),b=B.height+i}let m=(o-y.width)/2;return O(D).attr("transform","translate( "+(-1*o/2+m)+", "+(-1*x/2+b)+")"),b+=y.height+i,c.attr("class","divider").attr("x1",-o/2-a).attr("x2",o/2+a).attr("y1",-x/2-a+l+b).attr("y2",-x/2-a+l+b),b+=l,g.forEach(E=>{O(E).attr("transform","translate( "+-o/2+", "+(-1*x/2+b+l/2)+")");const h=E?.getBBox();b+=(h?.height??0)+i}),b+=l,u.attr("class","divider").attr("x1",-o/2-a).attr("x2",o/2+a).attr("y1",-x/2-a+l+b).attr("y2",-x/2-a+l+b),b+=l,f.forEach(E=>{O(E).attr("transform","translate( "+-o/2+", "+(-1*x/2+b)+")");const h=E?.getBBox();b+=(h?.height??0)+i}),n.attr("style",t.style).attr("class","outer title-state").attr("x",-o/2-a).attr("y",-(x/2)-a).attr("width",o+t.padding).attr("height",x+t.padding),T(t,n),t.intersect=function(E){return N.rect(t,E)},r},"class_box"),Ft={rhombus:At,composite:Rr,question:At,rect:Or,labelRect:zr,rectWithTitle:Ar,choice:kr,circle:Fr,doublecircle:Wr,stadium:Mr,hexagon:vr,block_arrow:Er,rect_left_inv_arrow:_r,lean_right:Dr,lean_left:Nr,trapezoid:Tr,inv_trapezoid:Br,rect_right_inv_arrow:Cr,cylinder:Ir,start:Yr,end:Hr,note:Sr,subroutine:Pr,fork:Mt,join:Mt,class_box:Kr},lt={},te=d(async(e,t,a)=>{let i,l;if(t.link){let s;R().securityLevel==="sandbox"?s="_top":t.linkTarget&&(s=t.linkTarget||"_blank"),i=e.insert("svg:a").attr("xlink:href",t.link).attr("target",s),l=await Ft[t.shape](i,t,a)}else l=await Ft[t.shape](e,t,a),i=l;return t.tooltip&&l.attr("title",t.tooltip),t.class&&l.attr("class","node default "+t.class),lt[t.id]=i,t.haveCallback&&lt[t.id].attr("class",lt[t.id].attr("class")+" clickable"),i},"insertNode"),Xr=d(e=>{const t=lt[e.id];L.trace("Transforming node",e.diff,e,"translate("+(e.x-e.width/2-5)+", "+e.width/2+")");const a=8,i=e.diff||0;return e.clusterNode?t.attr("transform","translate("+(e.x+i-e.width/2)+", "+(e.y-e.height/2-a)+")"):t.attr("transform","translate("+e.x+", "+e.y+")"),i},"positionNode");function Dt(e,t,a=!1){const i=e;let l="default";(i?.classes?.length||0)>0&&(l=(i?.classes??[]).join(" ")),l=l+" flowchart-label";let s=0,r="",n;switch(i.type){case"round":s=5,r="rect";break;case"composite":s=0,r="composite",n=0;break;case"square":r="rect";break;case"diamond":r="question";break;case"hexagon":r="hexagon";break;case"block_arrow":r="block_arrow";break;case"odd":r="rect_left_inv_arrow";break;case"lean_right":r="lean_right";break;case"lean_left":r="lean_left";break;case"trapezoid":r="trapezoid";break;case"inv_trapezoid":r="inv_trapezoid";break;case"rect_left_inv_arrow":r="rect_left_inv_arrow";break;case"circle":r="circle";break;case"ellipse":r="ellipse";break;case"stadium":r="stadium";break;case"subroutine":r="subroutine";break;case"cylinder":r="cylinder";break;case"group":r="rect";break;case"doublecircle":r="doublecircle";break;default:r="rect"}const c=me(i?.styles??[]),u=i.label,o=i.size??{width:0,height:0,x:0,y:0};return{labelStyle:c.labelStyle,shape:r,labelText:u,rx:s,ry:s,class:l,style:c.style,id:i.id,directions:i.directions,width:o.width,height:o.height,x:o.x,y:o.y,positioned:a,intersect:void 0,type:i.type,padding:n??rt()?.block?.padding??0}}d(Dt,"getNodeFromBlock");async function ee(e,t,a){const i=Dt(t,a,!1);if(i.type==="group")return;const l=rt(),s=await te(e,i,{config:l}),r=s.node().getBBox(),n=a.getBlock(i.id);n.size={width:r.width,height:r.height,x:0,y:0,node:s},a.setBlock(n),s.remove()}d(ee,"calculateBlockSize");async function re(e,t,a){const i=Dt(t,a,!0);if(a.getBlock(i.id).type!=="space"){const s=rt();await te(e,i,{config:s}),t.intersect=i?.intersect,Xr(i)}}d(re,"insertBlockPositioned");async function dt(e,t,a,i){for(const l of t)await i(e,l,a),l.children&&await dt(e,l.children,a,i)}d(dt,"performOperations");async function ae(e,t,a){await dt(e,t,a,ee)}d(ae,"calculateBlockSizes");async function se(e,t,a){await dt(e,t,a,re)}d(se,"insertBlocks");async function ie(e,t,a,i,l){const s=new Se({multigraph:!0,compound:!0});s.setGraph({rankdir:"TB",nodesep:10,ranksep:10,marginx:8,marginy:8});for(const r of a)r.size&&s.setNode(r.id,{width:r.size.width,height:r.size.height,intersect:r.intersect});for(const r of t)if(r.start&&r.end){const n=i.getBlock(r.start),c=i.getBlock(r.end);if(n?.size&&c?.size){const u=n.size,o=c.size,x=[{x:u.x,y:u.y},{x:u.x+(o.x-u.x)/2,y:u.y+(o.y-u.y)/2},{x:o.x,y:o.y}];gr(e,{v:r.start,w:r.end,name:r.id},{...r,arrowTypeEnd:r.arrowTypeEnd,arrowTypeStart:r.arrowTypeStart,points:x,classes:"edge-thickness-normal edge-pattern-solid flowchart-link LS-a1 LE-b1"},void 0,"block",s,l),r.label&&(await cr(e,{...r,label:r.label,labelStyle:"stroke: #333; stroke-width: 1.5px;fill:none;",arrowTypeEnd:r.arrowTypeEnd,arrowTypeStart:r.arrowTypeStart,points:x,classes:"edge-thickness-normal edge-pattern-solid flowchart-link LS-a1 LE-b1"}),or({...r,x:x[1].x,y:x[1].y},{originalPath:x}))}}}d(ie,"insertEdges");var Ur=d(function(e,t){return t.db.getClasses()},"getClasses"),jr=d(async function(e,t,a,i){const{securityLevel:l,block:s}=rt(),r=i.db;let n;l==="sandbox"&&(n=O("#i"+t));const c=l==="sandbox"?O(n.nodes()[0].contentDocument.body):O("body"),u=l==="sandbox"?c.select(`[id="${t}"]`):O(`[id="${t}"]`);ar(u,["point","circle","cross"],i.type,t);const x=r.getBlocks(),w=r.getBlocksFlat(),b=r.getEdges(),S=u.insert("g").attr("class","block");await ae(S,x,r);const v=jt(r);if(await se(S,x,r),await ie(S,b,w,r,t),v){const k=v,B=Math.max(1,Math.round(.125*(k.width/k.height))),_=k.height+B+10,D=k.width+10,{useMaxWidth:y}=s;he(u,_,D,!!y),L.debug("Here Bounds",v,k),u.attr("viewBox",`${k.x-5} ${k.y-5} ${k.width+10} ${k.height+10}`)}},"draw"),Vr={draw:jr,getClasses:Ur},ta={parser:ve,db:Ke,renderer:Vr,styles:Ue};export{ta as diagram};
diff --git a/docs/dist/assets/c4Diagram-YG6GDRKO-DYZ6VP6-.js b/docs/dist/assets/c4Diagram-YG6GDRKO-DYZ6VP6-.js
deleted file mode 100644
index 0b74db63..00000000
--- a/docs/dist/assets/c4Diagram-YG6GDRKO-DYZ6VP6-.js
+++ /dev/null
@@ -1,10 +0,0 @@
-import{g as Se,d as De}from"./chunk-TZMSLE5B-BkTUbDII.js";import{_ as g,s as Pe,g as Be,a as Ie,b as Me,c as Bt,d as jt,l as de,e as Le,f as Ne,h as Tt,i as ge,j as Ye,w as je,k as $t,m as fe}from"./index-BxX29htg.js";var Ft=(function(){var e=g(function(_t,x,m,v){for(m=m||{},v=_t.length;v--;m[_t[v]]=x);return m},"o"),t=[1,24],s=[1,25],o=[1,26],l=[1,27],a=[1,28],r=[1,63],n=[1,64],i=[1,65],u=[1,66],d=[1,67],y=[1,68],p=[1,69],E=[1,29],O=[1,30],S=[1,31],P=[1,32],M=[1,33],U=[1,34],H=[1,35],q=[1,36],G=[1,37],K=[1,38],J=[1,39],Z=[1,40],$=[1,41],tt=[1,42],et=[1,43],at=[1,44],it=[1,45],nt=[1,46],rt=[1,47],st=[1,48],lt=[1,50],ot=[1,51],ct=[1,52],ht=[1,53],ut=[1,54],dt=[1,55],ft=[1,56],pt=[1,57],yt=[1,58],gt=[1,59],bt=[1,60],Ct=[14,42],Qt=[14,34,36,37,38,39,40,41,42,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74],St=[12,14,34,36,37,38,39,40,41,42,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74],k=[1,82],A=[1,83],C=[1,84],w=[1,85],T=[12,14,42],le=[12,14,33,42],Mt=[12,14,33,42,76,77,79,80],vt=[12,33],Ht=[34,36,37,38,39,40,41,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74],qt={trace:g(function(){},"trace"),yy:{},symbols_:{error:2,start:3,mermaidDoc:4,direction:5,direction_tb:6,direction_bt:7,direction_rl:8,direction_lr:9,graphConfig:10,C4_CONTEXT:11,NEWLINE:12,statements:13,EOF:14,C4_CONTAINER:15,C4_COMPONENT:16,C4_DYNAMIC:17,C4_DEPLOYMENT:18,otherStatements:19,diagramStatements:20,otherStatement:21,title:22,accDescription:23,acc_title:24,acc_title_value:25,acc_descr:26,acc_descr_value:27,acc_descr_multiline_value:28,boundaryStatement:29,boundaryStartStatement:30,boundaryStopStatement:31,boundaryStart:32,LBRACE:33,ENTERPRISE_BOUNDARY:34,attributes:35,SYSTEM_BOUNDARY:36,BOUNDARY:37,CONTAINER_BOUNDARY:38,NODE:39,NODE_L:40,NODE_R:41,RBRACE:42,diagramStatement:43,PERSON:44,PERSON_EXT:45,SYSTEM:46,SYSTEM_DB:47,SYSTEM_QUEUE:48,SYSTEM_EXT:49,SYSTEM_EXT_DB:50,SYSTEM_EXT_QUEUE:51,CONTAINER:52,CONTAINER_DB:53,CONTAINER_QUEUE:54,CONTAINER_EXT:55,CONTAINER_EXT_DB:56,CONTAINER_EXT_QUEUE:57,COMPONENT:58,COMPONENT_DB:59,COMPONENT_QUEUE:60,COMPONENT_EXT:61,COMPONENT_EXT_DB:62,COMPONENT_EXT_QUEUE:63,REL:64,BIREL:65,REL_U:66,REL_D:67,REL_L:68,REL_R:69,REL_B:70,REL_INDEX:71,UPDATE_EL_STYLE:72,UPDATE_REL_STYLE:73,UPDATE_LAYOUT_CONFIG:74,attribute:75,STR:76,STR_KEY:77,STR_VALUE:78,ATTRIBUTE:79,ATTRIBUTE_EMPTY:80,$accept:0,$end:1},terminals_:{2:"error",6:"direction_tb",7:"direction_bt",8:"direction_rl",9:"direction_lr",11:"C4_CONTEXT",12:"NEWLINE",14:"EOF",15:"C4_CONTAINER",16:"C4_COMPONENT",17:"C4_DYNAMIC",18:"C4_DEPLOYMENT",22:"title",23:"accDescription",24:"acc_title",25:"acc_title_value",26:"acc_descr",27:"acc_descr_value",28:"acc_descr_multiline_value",33:"LBRACE",34:"ENTERPRISE_BOUNDARY",36:"SYSTEM_BOUNDARY",37:"BOUNDARY",38:"CONTAINER_BOUNDARY",39:"NODE",40:"NODE_L",41:"NODE_R",42:"RBRACE",44:"PERSON",45:"PERSON_EXT",46:"SYSTEM",47:"SYSTEM_DB",48:"SYSTEM_QUEUE",49:"SYSTEM_EXT",50:"SYSTEM_EXT_DB",51:"SYSTEM_EXT_QUEUE",52:"CONTAINER",53:"CONTAINER_DB",54:"CONTAINER_QUEUE",55:"CONTAINER_EXT",56:"CONTAINER_EXT_DB",57:"CONTAINER_EXT_QUEUE",58:"COMPONENT",59:"COMPONENT_DB",60:"COMPONENT_QUEUE",61:"COMPONENT_EXT",62:"COMPONENT_EXT_DB",63:"COMPONENT_EXT_QUEUE",64:"REL",65:"BIREL",66:"REL_U",67:"REL_D",68:"REL_L",69:"REL_R",70:"REL_B",71:"REL_INDEX",72:"UPDATE_EL_STYLE",73:"UPDATE_REL_STYLE",74:"UPDATE_LAYOUT_CONFIG",76:"STR",77:"STR_KEY",78:"STR_VALUE",79:"ATTRIBUTE",80:"ATTRIBUTE_EMPTY"},productions_:[0,[3,1],[3,1],[5,1],[5,1],[5,1],[5,1],[4,1],[10,4],[10,4],[10,4],[10,4],[10,4],[13,1],[13,1],[13,2],[19,1],[19,2],[19,3],[21,1],[21,1],[21,2],[21,2],[21,1],[29,3],[30,3],[30,3],[30,4],[32,2],[32,2],[32,2],[32,2],[32,2],[32,2],[32,2],[31,1],[20,1],[20,2],[20,3],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,1],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[43,2],[35,1],[35,2],[75,1],[75,2],[75,1],[75,1]],performAction:g(function(x,m,v,b,R,h,Dt){var f=h.length-1;switch(R){case 3:b.setDirection("TB");break;case 4:b.setDirection("BT");break;case 5:b.setDirection("RL");break;case 6:b.setDirection("LR");break;case 8:case 9:case 10:case 11:case 12:b.setC4Type(h[f-3]);break;case 19:b.setTitle(h[f].substring(6)),this.$=h[f].substring(6);break;case 20:b.setAccDescription(h[f].substring(15)),this.$=h[f].substring(15);break;case 21:this.$=h[f].trim(),b.setTitle(this.$);break;case 22:case 23:this.$=h[f].trim(),b.setAccDescription(this.$);break;case 28:h[f].splice(2,0,"ENTERPRISE"),b.addPersonOrSystemBoundary(...h[f]),this.$=h[f];break;case 29:h[f].splice(2,0,"SYSTEM"),b.addPersonOrSystemBoundary(...h[f]),this.$=h[f];break;case 30:b.addPersonOrSystemBoundary(...h[f]),this.$=h[f];break;case 31:h[f].splice(2,0,"CONTAINER"),b.addContainerBoundary(...h[f]),this.$=h[f];break;case 32:b.addDeploymentNode("node",...h[f]),this.$=h[f];break;case 33:b.addDeploymentNode("nodeL",...h[f]),this.$=h[f];break;case 34:b.addDeploymentNode("nodeR",...h[f]),this.$=h[f];break;case 35:b.popBoundaryParseStack();break;case 39:b.addPersonOrSystem("person",...h[f]),this.$=h[f];break;case 40:b.addPersonOrSystem("external_person",...h[f]),this.$=h[f];break;case 41:b.addPersonOrSystem("system",...h[f]),this.$=h[f];break;case 42:b.addPersonOrSystem("system_db",...h[f]),this.$=h[f];break;case 43:b.addPersonOrSystem("system_queue",...h[f]),this.$=h[f];break;case 44:b.addPersonOrSystem("external_system",...h[f]),this.$=h[f];break;case 45:b.addPersonOrSystem("external_system_db",...h[f]),this.$=h[f];break;case 46:b.addPersonOrSystem("external_system_queue",...h[f]),this.$=h[f];break;case 47:b.addContainer("container",...h[f]),this.$=h[f];break;case 48:b.addContainer("container_db",...h[f]),this.$=h[f];break;case 49:b.addContainer("container_queue",...h[f]),this.$=h[f];break;case 50:b.addContainer("external_container",...h[f]),this.$=h[f];break;case 51:b.addContainer("external_container_db",...h[f]),this.$=h[f];break;case 52:b.addContainer("external_container_queue",...h[f]),this.$=h[f];break;case 53:b.addComponent("component",...h[f]),this.$=h[f];break;case 54:b.addComponent("component_db",...h[f]),this.$=h[f];break;case 55:b.addComponent("component_queue",...h[f]),this.$=h[f];break;case 56:b.addComponent("external_component",...h[f]),this.$=h[f];break;case 57:b.addComponent("external_component_db",...h[f]),this.$=h[f];break;case 58:b.addComponent("external_component_queue",...h[f]),this.$=h[f];break;case 60:b.addRel("rel",...h[f]),this.$=h[f];break;case 61:b.addRel("birel",...h[f]),this.$=h[f];break;case 62:b.addRel("rel_u",...h[f]),this.$=h[f];break;case 63:b.addRel("rel_d",...h[f]),this.$=h[f];break;case 64:b.addRel("rel_l",...h[f]),this.$=h[f];break;case 65:b.addRel("rel_r",...h[f]),this.$=h[f];break;case 66:b.addRel("rel_b",...h[f]),this.$=h[f];break;case 67:h[f].splice(0,1),b.addRel("rel",...h[f]),this.$=h[f];break;case 68:b.updateElStyle("update_el_style",...h[f]),this.$=h[f];break;case 69:b.updateRelStyle("update_rel_style",...h[f]),this.$=h[f];break;case 70:b.updateLayoutConfig("update_layout_config",...h[f]),this.$=h[f];break;case 71:this.$=[h[f]];break;case 72:h[f].unshift(h[f-1]),this.$=h[f];break;case 73:case 75:this.$=h[f].trim();break;case 74:let Et={};Et[h[f-1].trim()]=h[f].trim(),this.$=Et;break;case 76:this.$="";break}},"anonymous"),table:[{3:1,4:2,5:3,6:[1,5],7:[1,6],8:[1,7],9:[1,8],10:4,11:[1,9],15:[1,10],16:[1,11],17:[1,12],18:[1,13]},{1:[3]},{1:[2,1]},{1:[2,2]},{1:[2,7]},{1:[2,3]},{1:[2,4]},{1:[2,5]},{1:[2,6]},{12:[1,14]},{12:[1,15]},{12:[1,16]},{12:[1,17]},{12:[1,18]},{13:19,19:20,20:21,21:22,22:t,23:s,24:o,26:l,28:a,29:49,30:61,32:62,34:r,36:n,37:i,38:u,39:d,40:y,41:p,43:23,44:E,45:O,46:S,47:P,48:M,49:U,50:H,51:q,52:G,53:K,54:J,55:Z,56:$,57:tt,58:et,59:at,60:it,61:nt,62:rt,63:st,64:lt,65:ot,66:ct,67:ht,68:ut,69:dt,70:ft,71:pt,72:yt,73:gt,74:bt},{13:70,19:20,20:21,21:22,22:t,23:s,24:o,26:l,28:a,29:49,30:61,32:62,34:r,36:n,37:i,38:u,39:d,40:y,41:p,43:23,44:E,45:O,46:S,47:P,48:M,49:U,50:H,51:q,52:G,53:K,54:J,55:Z,56:$,57:tt,58:et,59:at,60:it,61:nt,62:rt,63:st,64:lt,65:ot,66:ct,67:ht,68:ut,69:dt,70:ft,71:pt,72:yt,73:gt,74:bt},{13:71,19:20,20:21,21:22,22:t,23:s,24:o,26:l,28:a,29:49,30:61,32:62,34:r,36:n,37:i,38:u,39:d,40:y,41:p,43:23,44:E,45:O,46:S,47:P,48:M,49:U,50:H,51:q,52:G,53:K,54:J,55:Z,56:$,57:tt,58:et,59:at,60:it,61:nt,62:rt,63:st,64:lt,65:ot,66:ct,67:ht,68:ut,69:dt,70:ft,71:pt,72:yt,73:gt,74:bt},{13:72,19:20,20:21,21:22,22:t,23:s,24:o,26:l,28:a,29:49,30:61,32:62,34:r,36:n,37:i,38:u,39:d,40:y,41:p,43:23,44:E,45:O,46:S,47:P,48:M,49:U,50:H,51:q,52:G,53:K,54:J,55:Z,56:$,57:tt,58:et,59:at,60:it,61:nt,62:rt,63:st,64:lt,65:ot,66:ct,67:ht,68:ut,69:dt,70:ft,71:pt,72:yt,73:gt,74:bt},{13:73,19:20,20:21,21:22,22:t,23:s,24:o,26:l,28:a,29:49,30:61,32:62,34:r,36:n,37:i,38:u,39:d,40:y,41:p,43:23,44:E,45:O,46:S,47:P,48:M,49:U,50:H,51:q,52:G,53:K,54:J,55:Z,56:$,57:tt,58:et,59:at,60:it,61:nt,62:rt,63:st,64:lt,65:ot,66:ct,67:ht,68:ut,69:dt,70:ft,71:pt,72:yt,73:gt,74:bt},{14:[1,74]},e(Ct,[2,13],{43:23,29:49,30:61,32:62,20:75,34:r,36:n,37:i,38:u,39:d,40:y,41:p,44:E,45:O,46:S,47:P,48:M,49:U,50:H,51:q,52:G,53:K,54:J,55:Z,56:$,57:tt,58:et,59:at,60:it,61:nt,62:rt,63:st,64:lt,65:ot,66:ct,67:ht,68:ut,69:dt,70:ft,71:pt,72:yt,73:gt,74:bt}),e(Ct,[2,14]),e(Qt,[2,16],{12:[1,76]}),e(Ct,[2,36],{12:[1,77]}),e(St,[2,19]),e(St,[2,20]),{25:[1,78]},{27:[1,79]},e(St,[2,23]),{35:80,75:81,76:k,77:A,79:C,80:w},{35:86,75:81,76:k,77:A,79:C,80:w},{35:87,75:81,76:k,77:A,79:C,80:w},{35:88,75:81,76:k,77:A,79:C,80:w},{35:89,75:81,76:k,77:A,79:C,80:w},{35:90,75:81,76:k,77:A,79:C,80:w},{35:91,75:81,76:k,77:A,79:C,80:w},{35:92,75:81,76:k,77:A,79:C,80:w},{35:93,75:81,76:k,77:A,79:C,80:w},{35:94,75:81,76:k,77:A,79:C,80:w},{35:95,75:81,76:k,77:A,79:C,80:w},{35:96,75:81,76:k,77:A,79:C,80:w},{35:97,75:81,76:k,77:A,79:C,80:w},{35:98,75:81,76:k,77:A,79:C,80:w},{35:99,75:81,76:k,77:A,79:C,80:w},{35:100,75:81,76:k,77:A,79:C,80:w},{35:101,75:81,76:k,77:A,79:C,80:w},{35:102,75:81,76:k,77:A,79:C,80:w},{35:103,75:81,76:k,77:A,79:C,80:w},{35:104,75:81,76:k,77:A,79:C,80:w},e(T,[2,59]),{35:105,75:81,76:k,77:A,79:C,80:w},{35:106,75:81,76:k,77:A,79:C,80:w},{35:107,75:81,76:k,77:A,79:C,80:w},{35:108,75:81,76:k,77:A,79:C,80:w},{35:109,75:81,76:k,77:A,79:C,80:w},{35:110,75:81,76:k,77:A,79:C,80:w},{35:111,75:81,76:k,77:A,79:C,80:w},{35:112,75:81,76:k,77:A,79:C,80:w},{35:113,75:81,76:k,77:A,79:C,80:w},{35:114,75:81,76:k,77:A,79:C,80:w},{35:115,75:81,76:k,77:A,79:C,80:w},{20:116,29:49,30:61,32:62,34:r,36:n,37:i,38:u,39:d,40:y,41:p,43:23,44:E,45:O,46:S,47:P,48:M,49:U,50:H,51:q,52:G,53:K,54:J,55:Z,56:$,57:tt,58:et,59:at,60:it,61:nt,62:rt,63:st,64:lt,65:ot,66:ct,67:ht,68:ut,69:dt,70:ft,71:pt,72:yt,73:gt,74:bt},{12:[1,118],33:[1,117]},{35:119,75:81,76:k,77:A,79:C,80:w},{35:120,75:81,76:k,77:A,79:C,80:w},{35:121,75:81,76:k,77:A,79:C,80:w},{35:122,75:81,76:k,77:A,79:C,80:w},{35:123,75:81,76:k,77:A,79:C,80:w},{35:124,75:81,76:k,77:A,79:C,80:w},{35:125,75:81,76:k,77:A,79:C,80:w},{14:[1,126]},{14:[1,127]},{14:[1,128]},{14:[1,129]},{1:[2,8]},e(Ct,[2,15]),e(Qt,[2,17],{21:22,19:130,22:t,23:s,24:o,26:l,28:a}),e(Ct,[2,37],{19:20,20:21,21:22,43:23,29:49,30:61,32:62,13:131,22:t,23:s,24:o,26:l,28:a,34:r,36:n,37:i,38:u,39:d,40:y,41:p,44:E,45:O,46:S,47:P,48:M,49:U,50:H,51:q,52:G,53:K,54:J,55:Z,56:$,57:tt,58:et,59:at,60:it,61:nt,62:rt,63:st,64:lt,65:ot,66:ct,67:ht,68:ut,69:dt,70:ft,71:pt,72:yt,73:gt,74:bt}),e(St,[2,21]),e(St,[2,22]),e(T,[2,39]),e(le,[2,71],{75:81,35:132,76:k,77:A,79:C,80:w}),e(Mt,[2,73]),{78:[1,133]},e(Mt,[2,75]),e(Mt,[2,76]),e(T,[2,40]),e(T,[2,41]),e(T,[2,42]),e(T,[2,43]),e(T,[2,44]),e(T,[2,45]),e(T,[2,46]),e(T,[2,47]),e(T,[2,48]),e(T,[2,49]),e(T,[2,50]),e(T,[2,51]),e(T,[2,52]),e(T,[2,53]),e(T,[2,54]),e(T,[2,55]),e(T,[2,56]),e(T,[2,57]),e(T,[2,58]),e(T,[2,60]),e(T,[2,61]),e(T,[2,62]),e(T,[2,63]),e(T,[2,64]),e(T,[2,65]),e(T,[2,66]),e(T,[2,67]),e(T,[2,68]),e(T,[2,69]),e(T,[2,70]),{31:134,42:[1,135]},{12:[1,136]},{33:[1,137]},e(vt,[2,28]),e(vt,[2,29]),e(vt,[2,30]),e(vt,[2,31]),e(vt,[2,32]),e(vt,[2,33]),e(vt,[2,34]),{1:[2,9]},{1:[2,10]},{1:[2,11]},{1:[2,12]},e(Qt,[2,18]),e(Ct,[2,38]),e(le,[2,72]),e(Mt,[2,74]),e(T,[2,24]),e(T,[2,35]),e(Ht,[2,25]),e(Ht,[2,26],{12:[1,138]}),e(Ht,[2,27])],defaultActions:{2:[2,1],3:[2,2],4:[2,7],5:[2,3],6:[2,4],7:[2,5],8:[2,6],74:[2,8],126:[2,9],127:[2,10],128:[2,11],129:[2,12]},parseError:g(function(x,m){if(m.recoverable)this.trace(x);else{var v=new Error(x);throw v.hash=m,v}},"parseError"),parse:g(function(x){var m=this,v=[0],b=[],R=[null],h=[],Dt=this.table,f="",Et=0,oe=0,we=2,ce=1,Te=h.slice.call(arguments,1),D=Object.create(this.lexer),kt={yy:{}};for(var Gt in this.yy)Object.prototype.hasOwnProperty.call(this.yy,Gt)&&(kt.yy[Gt]=this.yy[Gt]);D.setInput(x,kt.yy),kt.yy.lexer=D,kt.yy.parser=this,typeof D.yylloc>"u"&&(D.yylloc={});var Kt=D.yylloc;h.push(Kt);var Oe=D.options&&D.options.ranges;typeof kt.yy.parseError=="function"?this.parseError=kt.yy.parseError:this.parseError=Object.getPrototypeOf(this).parseError;function Re(L){v.length=v.length-2*L,R.length=R.length-L,h.length=h.length-L}g(Re,"popStack");function he(){var L;return L=b.pop()||D.lex()||ce,typeof L!="number"&&(L instanceof Array&&(b=L,L=b.pop()),L=m.symbols_[L]||L),L}g(he,"lex");for(var I,At,N,Jt,wt={},Nt,W,ue,Yt;;){if(At=v[v.length-1],this.defaultActions[At]?N=this.defaultActions[At]:((I===null||typeof I>"u")&&(I=he()),N=Dt[At]&&Dt[At][I]),typeof N>"u"||!N.length||!N[0]){var Zt="";Yt=[];for(Nt in Dt[At])this.terminals_[Nt]&&Nt>we&&Yt.push("'"+this.terminals_[Nt]+"'");D.showPosition?Zt="Parse error on line "+(Et+1)+`:
-`+D.showPosition()+`
-Expecting `+Yt.join(", ")+", got '"+(this.terminals_[I]||I)+"'":Zt="Parse error on line "+(Et+1)+": Unexpected "+(I==ce?"end of input":"'"+(this.terminals_[I]||I)+"'"),this.parseError(Zt,{text:D.match,token:this.terminals_[I]||I,line:D.yylineno,loc:Kt,expected:Yt})}if(N[0]instanceof Array&&N.length>1)throw new Error("Parse Error: multiple actions possible at state: "+At+", token: "+I);switch(N[0]){case 1:v.push(I),R.push(D.yytext),h.push(D.yylloc),v.push(N[1]),I=null,oe=D.yyleng,f=D.yytext,Et=D.yylineno,Kt=D.yylloc;break;case 2:if(W=this.productions_[N[1]][1],wt.$=R[R.length-W],wt._$={first_line:h[h.length-(W||1)].first_line,last_line:h[h.length-1].last_line,first_column:h[h.length-(W||1)].first_column,last_column:h[h.length-1].last_column},Oe&&(wt._$.range=[h[h.length-(W||1)].range[0],h[h.length-1].range[1]]),Jt=this.performAction.apply(wt,[f,oe,Et,kt.yy,N[1],R,h].concat(Te)),typeof Jt<"u")return Jt;W&&(v=v.slice(0,-1*W*2),R=R.slice(0,-1*W),h=h.slice(0,-1*W)),v.push(this.productions_[N[1]][0]),R.push(wt.$),h.push(wt._$),ue=Dt[v[v.length-2]][v[v.length-1]],v.push(ue);break;case 3:return!0}}return!0},"parse")},Ce=(function(){var _t={EOF:1,parseError:g(function(m,v){if(this.yy.parser)this.yy.parser.parseError(m,v);else throw new Error(m)},"parseError"),setInput:g(function(x,m){return this.yy=m||this.yy||{},this._input=x,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},"setInput"),input:g(function(){var x=this._input[0];this.yytext+=x,this.yyleng++,this.offset++,this.match+=x,this.matched+=x;var m=x.match(/(?:\r\n?|\n).*/g);return m?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),x},"input"),unput:g(function(x){var m=x.length,v=x.split(/(?:\r\n?|\n)/g);this._input=x+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-m),this.offset-=m;var b=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),v.length-1&&(this.yylineno-=v.length-1);var R=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:v?(v.length===b.length?this.yylloc.first_column:0)+b[b.length-v.length].length-v[0].length:this.yylloc.first_column-m},this.options.ranges&&(this.yylloc.range=[R[0],R[0]+this.yyleng-m]),this.yyleng=this.yytext.length,this},"unput"),more:g(function(){return this._more=!0,this},"more"),reject:g(function(){if(this.options.backtrack_lexer)this._backtrack=!0;else return this.parseError("Lexical error on line "+(this.yylineno+1)+`. You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).
-`+this.showPosition(),{text:"",token:null,line:this.yylineno});return this},"reject"),less:g(function(x){this.unput(this.match.slice(x))},"less"),pastInput:g(function(){var x=this.matched.substr(0,this.matched.length-this.match.length);return(x.length>20?"...":"")+x.substr(-20).replace(/\n/g,"")},"pastInput"),upcomingInput:g(function(){var x=this.match;return x.length<20&&(x+=this._input.substr(0,20-x.length)),(x.substr(0,20)+(x.length>20?"...":"")).replace(/\n/g,"")},"upcomingInput"),showPosition:g(function(){var x=this.pastInput(),m=new Array(x.length+1).join("-");return x+this.upcomingInput()+`
-`+m+"^"},"showPosition"),test_match:g(function(x,m){var v,b,R;if(this.options.backtrack_lexer&&(R={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(R.yylloc.range=this.yylloc.range.slice(0))),b=x[0].match(/(?:\r\n?|\n).*/g),b&&(this.yylineno+=b.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:b?b[b.length-1].length-b[b.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+x[0].length},this.yytext+=x[0],this.match+=x[0],this.matches=x,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(x[0].length),this.matched+=x[0],v=this.performAction.call(this,this.yy,this,m,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),v)return v;if(this._backtrack){for(var h in R)this[h]=R[h];return!1}return!1},"test_match"),next:g(function(){if(this.done)return this.EOF;this._input||(this.done=!0);var x,m,v,b;this._more||(this.yytext="",this.match="");for(var R=this._currentRules(),h=0;h<R.length;h++)if(v=this._input.match(this.rules[R[h]]),v&&(!m||v[0].length>m[0].length)){if(m=v,b=h,this.options.backtrack_lexer){if(x=this.test_match(v,R[h]),x!==!1)return x;if(this._backtrack){m=!1;continue}else return!1}else if(!this.options.flex)break}return m?(x=this.test_match(m,R[b]),x!==!1?x:!1):this._input===""?this.EOF:this.parseError("Lexical error on line "+(this.yylineno+1)+`. Unrecognized text.
-`+this.showPosition(),{text:"",token:null,line:this.yylineno})},"next"),lex:g(function(){var m=this.next();return m||this.lex()},"lex"),begin:g(function(m){this.conditionStack.push(m)},"begin"),popState:g(function(){var m=this.conditionStack.length-1;return m>0?this.conditionStack.pop():this.conditionStack[0]},"popState"),_currentRules:g(function(){return this.conditionStack.length&&this.conditionStack[this.conditionStack.length-1]?this.conditions[this.conditionStack[this.conditionStack.length-1]].rules:this.conditions.INITIAL.rules},"_currentRules"),topState:g(function(m){return m=this.conditionStack.length-1-Math.abs(m||0),m>=0?this.conditionStack[m]:"INITIAL"},"topState"),pushState:g(function(m){this.begin(m)},"pushState"),stateStackSize:g(function(){return this.conditionStack.length},"stateStackSize"),options:{},performAction:g(function(m,v,b,R){switch(b){case 0:return 6;case 1:return 7;case 2:return 8;case 3:return 9;case 4:return 22;case 5:return 23;case 6:return this.begin("acc_title"),24;case 7:return this.popState(),"acc_title_value";case 8:return this.begin("acc_descr"),26;case 9:return this.popState(),"acc_descr_value";case 10:this.begin("acc_descr_multiline");break;case 11:this.popState();break;case 12:return"acc_descr_multiline_value";case 13:break;case 14:c;break;case 15:return 12;case 16:break;case 17:return 11;case 18:return 15;case 19:return 16;case 20:return 17;case 21:return 18;case 22:return this.begin("person_ext"),45;case 23:return this.begin("person"),44;case 24:return this.begin("system_ext_queue"),51;case 25:return this.begin("system_ext_db"),50;case 26:return this.begin("system_ext"),49;case 27:return this.begin("system_queue"),48;case 28:return this.begin("system_db"),47;case 29:return this.begin("system"),46;case 30:return this.begin("boundary"),37;case 31:return this.begin("enterprise_boundary"),34;case 32:return this.begin("system_boundary"),36;case 33:return this.begin("container_ext_queue"),57;case 34:return this.begin("container_ext_db"),56;case 35:return this.begin("container_ext"),55;case 36:return this.begin("container_queue"),54;case 37:return this.begin("container_db"),53;case 38:return this.begin("container"),52;case 39:return this.begin("container_boundary"),38;case 40:return this.begin("component_ext_queue"),63;case 41:return this.begin("component_ext_db"),62;case 42:return this.begin("component_ext"),61;case 43:return this.begin("component_queue"),60;case 44:return this.begin("component_db"),59;case 45:return this.begin("component"),58;case 46:return this.begin("node"),39;case 47:return this.begin("node"),39;case 48:return this.begin("node_l"),40;case 49:return this.begin("node_r"),41;case 50:return this.begin("rel"),64;case 51:return this.begin("birel"),65;case 52:return this.begin("rel_u"),66;case 53:return this.begin("rel_u"),66;case 54:return this.begin("rel_d"),67;case 55:return this.begin("rel_d"),67;case 56:return this.begin("rel_l"),68;case 57:return this.begin("rel_l"),68;case 58:return this.begin("rel_r"),69;case 59:return this.begin("rel_r"),69;case 60:return this.begin("rel_b"),70;case 61:return this.begin("rel_index"),71;case 62:return this.begin("update_el_style"),72;case 63:return this.begin("update_rel_style"),73;case 64:return this.begin("update_layout_config"),74;case 65:return"EOF_IN_STRUCT";case 66:return this.begin("attribute"),"ATTRIBUTE_EMPTY";case 67:this.begin("attribute");break;case 68:this.popState(),this.popState();break;case 69:return 80;case 70:break;case 71:return 80;case 72:this.begin("string");break;case 73:this.popState();break;case 74:return"STR";case 75:this.begin("string_kv");break;case 76:return this.begin("string_kv_key"),"STR_KEY";case 77:this.popState(),this.begin("string_kv_value");break;case 78:return"STR_VALUE";case 79:this.popState(),this.popState();break;case 80:return"STR";case 81:return"LBRACE";case 82:return"RBRACE";case 83:return"SPACE";case 84:return"EOL";case 85:return 14}},"anonymous"),rules:[/^(?:.*direction\s+TB[^\n]*)/,/^(?:.*direction\s+BT[^\n]*)/,/^(?:.*direction\s+RL[^\n]*)/,/^(?:.*direction\s+LR[^\n]*)/,/^(?:title\s[^#\n;]+)/,/^(?:accDescription\s[^#\n;]+)/,/^(?:accTitle\s*:\s*)/,/^(?:(?!\n||)*[^\n]*)/,/^(?:accDescr\s*:\s*)/,/^(?:(?!\n||)*[^\n]*)/,/^(?:accDescr\s*\{\s*)/,/^(?:[\}])/,/^(?:[^\}]*)/,/^(?:%%(?!\{)*[^\n]*(\r?\n?)+)/,/^(?:%%[^\n]*(\r?\n)*)/,/^(?:\s*(\r?\n)+)/,/^(?:\s+)/,/^(?:C4Context\b)/,/^(?:C4Container\b)/,/^(?:C4Component\b)/,/^(?:C4Dynamic\b)/,/^(?:C4Deployment\b)/,/^(?:Person_Ext\b)/,/^(?:Person\b)/,/^(?:SystemQueue_Ext\b)/,/^(?:SystemDb_Ext\b)/,/^(?:System_Ext\b)/,/^(?:SystemQueue\b)/,/^(?:SystemDb\b)/,/^(?:System\b)/,/^(?:Boundary\b)/,/^(?:Enterprise_Boundary\b)/,/^(?:System_Boundary\b)/,/^(?:ContainerQueue_Ext\b)/,/^(?:ContainerDb_Ext\b)/,/^(?:Container_Ext\b)/,/^(?:ContainerQueue\b)/,/^(?:ContainerDb\b)/,/^(?:Container\b)/,/^(?:Container_Boundary\b)/,/^(?:ComponentQueue_Ext\b)/,/^(?:ComponentDb_Ext\b)/,/^(?:Component_Ext\b)/,/^(?:ComponentQueue\b)/,/^(?:ComponentDb\b)/,/^(?:Component\b)/,/^(?:Deployment_Node\b)/,/^(?:Node\b)/,/^(?:Node_L\b)/,/^(?:Node_R\b)/,/^(?:Rel\b)/,/^(?:BiRel\b)/,/^(?:Rel_Up\b)/,/^(?:Rel_U\b)/,/^(?:Rel_Down\b)/,/^(?:Rel_D\b)/,/^(?:Rel_Left\b)/,/^(?:Rel_L\b)/,/^(?:Rel_Right\b)/,/^(?:Rel_R\b)/,/^(?:Rel_Back\b)/,/^(?:RelIndex\b)/,/^(?:UpdateElementStyle\b)/,/^(?:UpdateRelStyle\b)/,/^(?:UpdateLayoutConfig\b)/,/^(?:$)/,/^(?:[(][ ]*[,])/,/^(?:[(])/,/^(?:[)])/,/^(?:,,)/,/^(?:,)/,/^(?:[ ]*["]["])/,/^(?:[ ]*["])/,/^(?:["])/,/^(?:[^"]*)/,/^(?:[ ]*[\$])/,/^(?:[^=]*)/,/^(?:[=][ ]*["])/,/^(?:[^"]+)/,/^(?:["])/,/^(?:[^,]+)/,/^(?:\{)/,/^(?:\})/,/^(?:[\s]+)/,/^(?:[\n\r]+)/,/^(?:$)/],conditions:{acc_descr_multiline:{rules:[11,12],inclusive:!1},acc_descr:{rules:[9],inclusive:!1},acc_title:{rules:[7],inclusive:!1},string_kv_value:{rules:[78,79],inclusive:!1},string_kv_key:{rules:[77],inclusive:!1},string_kv:{rules:[76],inclusive:!1},string:{rules:[73,74],inclusive:!1},attribute:{rules:[68,69,70,71,72,75,80],inclusive:!1},update_layout_config:{rules:[65,66,67,68],inclusive:!1},update_rel_style:{rules:[65,66,67,68],inclusive:!1},update_el_style:{rules:[65,66,67,68],inclusive:!1},rel_b:{rules:[65,66,67,68],inclusive:!1},rel_r:{rules:[65,66,67,68],inclusive:!1},rel_l:{rules:[65,66,67,68],inclusive:!1},rel_d:{rules:[65,66,67,68],inclusive:!1},rel_u:{rules:[65,66,67,68],inclusive:!1},rel_bi:{rules:[],inclusive:!1},rel:{rules:[65,66,67,68],inclusive:!1},node_r:{rules:[65,66,67,68],inclusive:!1},node_l:{rules:[65,66,67,68],inclusive:!1},node:{rules:[65,66,67,68],inclusive:!1},index:{rules:[],inclusive:!1},rel_index:{rules:[65,66,67,68],inclusive:!1},component_ext_queue:{rules:[],inclusive:!1},component_ext_db:{rules:[65,66,67,68],inclusive:!1},component_ext:{rules:[65,66,67,68],inclusive:!1},component_queue:{rules:[65,66,67,68],inclusive:!1},component_db:{rules:[65,66,67,68],inclusive:!1},component:{rules:[65,66,67,68],inclusive:!1},container_boundary:{rules:[65,66,67,68],inclusive:!1},container_ext_queue:{rules:[65,66,67,68],inclusive:!1},container_ext_db:{rules:[65,66,67,68],inclusive:!1},container_ext:{rules:[65,66,67,68],inclusive:!1},container_queue:{rules:[65,66,67,68],inclusive:!1},container_db:{rules:[65,66,67,68],inclusive:!1},container:{rules:[65,66,67,68],inclusive:!1},birel:{rules:[65,66,67,68],inclusive:!1},system_boundary:{rules:[65,66,67,68],inclusive:!1},enterprise_boundary:{rules:[65,66,67,68],inclusive:!1},boundary:{rules:[65,66,67,68],inclusive:!1},system_ext_queue:{rules:[65,66,67,68],inclusive:!1},system_ext_db:{rules:[65,66,67,68],inclusive:!1},system_ext:{rules:[65,66,67,68],inclusive:!1},system_queue:{rules:[65,66,67,68],inclusive:!1},system_db:{rules:[65,66,67,68],inclusive:!1},system:{rules:[65,66,67,68],inclusive:!1},person_ext:{rules:[65,66,67,68],inclusive:!1},person:{rules:[65,66,67,68],inclusive:!1},INITIAL:{rules:[0,1,2,3,4,5,6,8,10,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,81,82,83,84,85],inclusive:!0}}};return _t})();qt.lexer=Ce;function Lt(){this.yy={}}return g(Lt,"Parser"),Lt.prototype=qt,qt.Parser=Lt,new Lt})();Ft.parser=Ft;var Ue=Ft,V=[],xt=[""],B="global",F="",X=[{alias:"global",label:{text:"global"},type:{text:"global"},tags:null,link:null,parentBoundary:""}],It=[],ie="",ne=!1,Vt=4,zt=2,be,Fe=g(function(){return be},"getC4Type"),Ve=g(function(e){be=ge(e,Bt())},"setC4Type"),ze=g(function(e,t,s,o,l,a,r,n,i){if(e==null||t===void 0||t===null||s===void 0||s===null||o===void 0||o===null)return;let u={};const d=It.find(y=>y.from===t&&y.to===s);if(d?u=d:It.push(u),u.type=e,u.from=t,u.to=s,u.label={text:o},l==null)u.techn={text:""};else if(typeof l=="object"){let[y,p]=Object.entries(l)[0];u[y]={text:p}}else u.techn={text:l};if(a==null)u.descr={text:""};else if(typeof a=="object"){let[y,p]=Object.entries(a)[0];u[y]={text:p}}else u.descr={text:a};if(typeof r=="object"){let[y,p]=Object.entries(r)[0];u[y]=p}else u.sprite=r;if(typeof n=="object"){let[y,p]=Object.entries(n)[0];u[y]=p}else u.tags=n;if(typeof i=="object"){let[y,p]=Object.entries(i)[0];u[y]=p}else u.link=i;u.wrap=mt()},"addRel"),Xe=g(function(e,t,s,o,l,a,r){if(t===null||s===null)return;let n={};const i=V.find(u=>u.alias===t);if(i&&t===i.alias?n=i:(n.alias=t,V.push(n)),s==null?n.label={text:""}:n.label={text:s},o==null)n.descr={text:""};else if(typeof o=="object"){let[u,d]=Object.entries(o)[0];n[u]={text:d}}else n.descr={text:o};if(typeof l=="object"){let[u,d]=Object.entries(l)[0];n[u]=d}else n.sprite=l;if(typeof a=="object"){let[u,d]=Object.entries(a)[0];n[u]=d}else n.tags=a;if(typeof r=="object"){let[u,d]=Object.entries(r)[0];n[u]=d}else n.link=r;n.typeC4Shape={text:e},n.parentBoundary=B,n.wrap=mt()},"addPersonOrSystem"),We=g(function(e,t,s,o,l,a,r,n){if(t===null||s===null)return;let i={};const u=V.find(d=>d.alias===t);if(u&&t===u.alias?i=u:(i.alias=t,V.push(i)),s==null?i.label={text:""}:i.label={text:s},o==null)i.techn={text:""};else if(typeof o=="object"){let[d,y]=Object.entries(o)[0];i[d]={text:y}}else i.techn={text:o};if(l==null)i.descr={text:""};else if(typeof l=="object"){let[d,y]=Object.entries(l)[0];i[d]={text:y}}else i.descr={text:l};if(typeof a=="object"){let[d,y]=Object.entries(a)[0];i[d]=y}else i.sprite=a;if(typeof r=="object"){let[d,y]=Object.entries(r)[0];i[d]=y}else i.tags=r;if(typeof n=="object"){let[d,y]=Object.entries(n)[0];i[d]=y}else i.link=n;i.wrap=mt(),i.typeC4Shape={text:e},i.parentBoundary=B},"addContainer"),Qe=g(function(e,t,s,o,l,a,r,n){if(t===null||s===null)return;let i={};const u=V.find(d=>d.alias===t);if(u&&t===u.alias?i=u:(i.alias=t,V.push(i)),s==null?i.label={text:""}:i.label={text:s},o==null)i.techn={text:""};else if(typeof o=="object"){let[d,y]=Object.entries(o)[0];i[d]={text:y}}else i.techn={text:o};if(l==null)i.descr={text:""};else if(typeof l=="object"){let[d,y]=Object.entries(l)[0];i[d]={text:y}}else i.descr={text:l};if(typeof a=="object"){let[d,y]=Object.entries(a)[0];i[d]=y}else i.sprite=a;if(typeof r=="object"){let[d,y]=Object.entries(r)[0];i[d]=y}else i.tags=r;if(typeof n=="object"){let[d,y]=Object.entries(n)[0];i[d]=y}else i.link=n;i.wrap=mt(),i.typeC4Shape={text:e},i.parentBoundary=B},"addComponent"),He=g(function(e,t,s,o,l){if(e===null||t===null)return;let a={};const r=X.find(n=>n.alias===e);if(r&&e===r.alias?a=r:(a.alias=e,X.push(a)),t==null?a.label={text:""}:a.label={text:t},s==null)a.type={text:"system"};else if(typeof s=="object"){let[n,i]=Object.entries(s)[0];a[n]={text:i}}else a.type={text:s};if(typeof o=="object"){let[n,i]=Object.entries(o)[0];a[n]=i}else a.tags=o;if(typeof l=="object"){let[n,i]=Object.entries(l)[0];a[n]=i}else a.link=l;a.parentBoundary=B,a.wrap=mt(),F=B,B=e,xt.push(F)},"addPersonOrSystemBoundary"),qe=g(function(e,t,s,o,l){if(e===null||t===null)return;let a={};const r=X.find(n=>n.alias===e);if(r&&e===r.alias?a=r:(a.alias=e,X.push(a)),t==null?a.label={text:""}:a.label={text:t},s==null)a.type={text:"container"};else if(typeof s=="object"){let[n,i]=Object.entries(s)[0];a[n]={text:i}}else a.type={text:s};if(typeof o=="object"){let[n,i]=Object.entries(o)[0];a[n]=i}else a.tags=o;if(typeof l=="object"){let[n,i]=Object.entries(l)[0];a[n]=i}else a.link=l;a.parentBoundary=B,a.wrap=mt(),F=B,B=e,xt.push(F)},"addContainerBoundary"),Ge=g(function(e,t,s,o,l,a,r,n){if(t===null||s===null)return;let i={};const u=X.find(d=>d.alias===t);if(u&&t===u.alias?i=u:(i.alias=t,X.push(i)),s==null?i.label={text:""}:i.label={text:s},o==null)i.type={text:"node"};else if(typeof o=="object"){let[d,y]=Object.entries(o)[0];i[d]={text:y}}else i.type={text:o};if(l==null)i.descr={text:""};else if(typeof l=="object"){let[d,y]=Object.entries(l)[0];i[d]={text:y}}else i.descr={text:l};if(typeof r=="object"){let[d,y]=Object.entries(r)[0];i[d]=y}else i.tags=r;if(typeof n=="object"){let[d,y]=Object.entries(n)[0];i[d]=y}else i.link=n;i.nodeType=e,i.parentBoundary=B,i.wrap=mt(),F=B,B=t,xt.push(F)},"addDeploymentNode"),Ke=g(function(){B=F,xt.pop(),F=xt.pop(),xt.push(F)},"popBoundaryParseStack"),Je=g(function(e,t,s,o,l,a,r,n,i,u,d){let y=V.find(p=>p.alias===t);if(!(y===void 0&&(y=X.find(p=>p.alias===t),y===void 0))){if(s!=null)if(typeof s=="object"){let[p,E]=Object.entries(s)[0];y[p]=E}else y.bgColor=s;if(o!=null)if(typeof o=="object"){let[p,E]=Object.entries(o)[0];y[p]=E}else y.fontColor=o;if(l!=null)if(typeof l=="object"){let[p,E]=Object.entries(l)[0];y[p]=E}else y.borderColor=l;if(a!=null)if(typeof a=="object"){let[p,E]=Object.entries(a)[0];y[p]=E}else y.shadowing=a;if(r!=null)if(typeof r=="object"){let[p,E]=Object.entries(r)[0];y[p]=E}else y.shape=r;if(n!=null)if(typeof n=="object"){let[p,E]=Object.entries(n)[0];y[p]=E}else y.sprite=n;if(i!=null)if(typeof i=="object"){let[p,E]=Object.entries(i)[0];y[p]=E}else y.techn=i;if(u!=null)if(typeof u=="object"){let[p,E]=Object.entries(u)[0];y[p]=E}else y.legendText=u;if(d!=null)if(typeof d=="object"){let[p,E]=Object.entries(d)[0];y[p]=E}else y.legendSprite=d}},"updateElStyle"),Ze=g(function(e,t,s,o,l,a,r){const n=It.find(i=>i.from===t&&i.to===s);if(n!==void 0){if(o!=null)if(typeof o=="object"){let[i,u]=Object.entries(o)[0];n[i]=u}else n.textColor=o;if(l!=null)if(typeof l=="object"){let[i,u]=Object.entries(l)[0];n[i]=u}else n.lineColor=l;if(a!=null)if(typeof a=="object"){let[i,u]=Object.entries(a)[0];n[i]=parseInt(u)}else n.offsetX=parseInt(a);if(r!=null)if(typeof r=="object"){let[i,u]=Object.entries(r)[0];n[i]=parseInt(u)}else n.offsetY=parseInt(r)}},"updateRelStyle"),$e=g(function(e,t,s){let o=Vt,l=zt;if(typeof t=="object"){const a=Object.values(t)[0];o=parseInt(a)}else o=parseInt(t);if(typeof s=="object"){const a=Object.values(s)[0];l=parseInt(a)}else l=parseInt(s);o>=1&&(Vt=o),l>=1&&(zt=l)},"updateLayoutConfig"),t0=g(function(){return Vt},"getC4ShapeInRow"),e0=g(function(){return zt},"getC4BoundaryInRow"),a0=g(function(){return B},"getCurrentBoundaryParse"),i0=g(function(){return F},"getParentBoundaryParse"),_e=g(function(e){return e==null?V:V.filter(t=>t.parentBoundary===e)},"getC4ShapeArray"),n0=g(function(e){return V.find(t=>t.alias===e)},"getC4Shape"),r0=g(function(e){return Object.keys(_e(e))},"getC4ShapeKeys"),xe=g(function(e){return e==null?X:X.filter(t=>t.parentBoundary===e)},"getBoundaries"),s0=xe,l0=g(function(){return It},"getRels"),o0=g(function(){return ie},"getTitle"),c0=g(function(e){ne=e},"setWrap"),mt=g(function(){return ne},"autoWrap"),h0=g(function(){V=[],X=[{alias:"global",label:{text:"global"},type:{text:"global"},tags:null,link:null,parentBoundary:""}],F="",B="global",xt=[""],It=[],xt=[""],ie="",ne=!1,Vt=4,zt=2},"clear"),u0={SOLID:0,DOTTED:1,NOTE:2,SOLID_CROSS:3,DOTTED_CROSS:4,SOLID_OPEN:5,DOTTED_OPEN:6,LOOP_START:10,LOOP_END:11,ALT_START:12,ALT_ELSE:13,ALT_END:14,OPT_START:15,OPT_END:16,ACTIVE_START:17,ACTIVE_END:18,PAR_START:19,PAR_AND:20,PAR_END:21,RECT_START:22,RECT_END:23,SOLID_POINT:24,DOTTED_POINT:25},d0={FILLED:0,OPEN:1},f0={LEFTOF:0,RIGHTOF:1,OVER:2},p0=g(function(e){ie=ge(e,Bt())},"setTitle"),te={addPersonOrSystem:Xe,addPersonOrSystemBoundary:He,addContainer:We,addContainerBoundary:qe,addComponent:Qe,addDeploymentNode:Ge,popBoundaryParseStack:Ke,addRel:ze,updateElStyle:Je,updateRelStyle:Ze,updateLayoutConfig:$e,autoWrap:mt,setWrap:c0,getC4ShapeArray:_e,getC4Shape:n0,getC4ShapeKeys:r0,getBoundaries:xe,getBoundarys:s0,getCurrentBoundaryParse:a0,getParentBoundaryParse:i0,getRels:l0,getTitle:o0,getC4Type:Fe,getC4ShapeInRow:t0,getC4BoundaryInRow:e0,setAccTitle:Me,getAccTitle:Ie,getAccDescription:Be,setAccDescription:Pe,getConfig:g(()=>Bt().c4,"getConfig"),clear:h0,LINETYPE:u0,ARROWTYPE:d0,PLACEMENT:f0,setTitle:p0,setC4Type:Ve},re=g(function(e,t){return De(e,t)},"drawRect"),me=g(function(e,t,s,o,l,a){const r=e.append("image");r.attr("width",t),r.attr("height",s),r.attr("x",o),r.attr("y",l);let n=a.startsWith("data:image/png;base64")?a:Ye.sanitizeUrl(a);r.attr("xlink:href",n)},"drawImage"),y0=g((e,t,s)=>{const o=e.append("g");let l=0;for(let a of t){let r=a.textColor?a.textColor:"#444444",n=a.lineColor?a.lineColor:"#444444",i=a.offsetX?parseInt(a.offsetX):0,u=a.offsetY?parseInt(a.offsetY):0,d="";if(l===0){let p=o.append("line");p.attr("x1",a.startPoint.x),p.attr("y1",a.startPoint.y),p.attr("x2",a.endPoint.x),p.attr("y2",a.endPoint.y),p.attr("stroke-width","1"),p.attr("stroke",n),p.style("fill","none"),a.type!=="rel_b"&&p.attr("marker-end","url("+d+"#arrowhead)"),(a.type==="birel"||a.type==="rel_b")&&p.attr("marker-start","url("+d+"#arrowend)"),l=-1}else{let p=o.append("path");p.attr("fill","none").attr("stroke-width","1").attr("stroke",n).attr("d","Mstartx,starty Qcontrolx,controly stopx,stopy ".replaceAll("startx",a.startPoint.x).replaceAll("starty",a.startPoint.y).replaceAll("controlx",a.startPoint.x+(a.endPoint.x-a.startPoint.x)/2-(a.endPoint.x-a.startPoint.x)/4).replaceAll("controly",a.startPoint.y+(a.endPoint.y-a.startPoint.y)/2).replaceAll("stopx",a.endPoint.x).replaceAll("stopy",a.endPoint.y)),a.type!=="rel_b"&&p.attr("marker-end","url("+d+"#arrowhead)"),(a.type==="birel"||a.type==="rel_b")&&p.attr("marker-start","url("+d+"#arrowend)")}let y=s.messageFont();Q(s)(a.label.text,o,Math.min(a.startPoint.x,a.endPoint.x)+Math.abs(a.endPoint.x-a.startPoint.x)/2+i,Math.min(a.startPoint.y,a.endPoint.y)+Math.abs(a.endPoint.y-a.startPoint.y)/2+u,a.label.width,a.label.height,{fill:r},y),a.techn&&a.techn.text!==""&&(y=s.messageFont(),Q(s)("["+a.techn.text+"]",o,Math.min(a.startPoint.x,a.endPoint.x)+Math.abs(a.endPoint.x-a.startPoint.x)/2+i,Math.min(a.startPoint.y,a.endPoint.y)+Math.abs(a.endPoint.y-a.startPoint.y)/2+s.messageFontSize+5+u,Math.max(a.label.width,a.techn.width),a.techn.height,{fill:r,"font-style":"italic"},y))}},"drawRels"),g0=g(function(e,t,s){const o=e.append("g");let l=t.bgColor?t.bgColor:"none",a=t.borderColor?t.borderColor:"#444444",r=t.fontColor?t.fontColor:"black",n={"stroke-width":1,"stroke-dasharray":"7.0,7.0"};t.nodeType&&(n={"stroke-width":1});let i={x:t.x,y:t.y,fill:l,stroke:a,width:t.width,height:t.height,rx:2.5,ry:2.5,attrs:n};re(o,i);let u=s.boundaryFont();u.fontWeight="bold",u.fontSize=u.fontSize+2,u.fontColor=r,Q(s)(t.label.text,o,t.x,t.y+t.label.Y,t.width,t.height,{fill:"#444444"},u),t.type&&t.type.text!==""&&(u=s.boundaryFont(),u.fontColor=r,Q(s)(t.type.text,o,t.x,t.y+t.type.Y,t.width,t.height,{fill:"#444444"},u)),t.descr&&t.descr.text!==""&&(u=s.boundaryFont(),u.fontSize=u.fontSize-2,u.fontColor=r,Q(s)(t.descr.text,o,t.x,t.y+t.descr.Y,t.width,t.height,{fill:"#444444"},u))},"drawBoundary"),b0=g(function(e,t,s){let o=t.bgColor?t.bgColor:s[t.typeC4Shape.text+"_bg_color"],l=t.borderColor?t.borderColor:s[t.typeC4Shape.text+"_border_color"],a=t.fontColor?t.fontColor:"#FFFFFF",r="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAIAAADYYG7QAAACD0lEQVR4Xu2YoU4EMRCGT+4j8Ai8AhaH4QHgAUjQuFMECUgMIUgwJAgMhgQsAYUiJCiQIBBY+EITsjfTdme6V24v4c8vyGbb+ZjOtN0bNcvjQXmkH83WvYBWto6PLm6v7p7uH1/w2fXD+PBycX1Pv2l3IdDm/vn7x+dXQiAubRzoURa7gRZWd0iGRIiJbOnhnfYBQZNJjNbuyY2eJG8fkDE3bbG4ep6MHUAsgYxmE3nVs6VsBWJSGccsOlFPmLIViMzLOB7pCVO2AtHJMohH7Fh6zqitQK7m0rJvAVYgGcEpe//PLdDz65sM4pF9N7ICcXDKIB5Nv6j7tD0NoSdM2QrU9Gg0ewE1LqBhHR3BBdvj2vapnidjHxD/q6vd7Pvhr31AwcY8eXMTXAKECZZJFXuEq27aLgQK5uLMohCenGGuGewOxSjBvYBqeG6B+Nqiblggdjnc+ZXDy+FNFpFzw76O3UBAROuXh6FoiAcf5g9eTvUgzy0nWg6I8cXHRUpg5bOVBCo+KDpFajOf23GgPme7RSQ+lacIENUgJ6gg1k6HjgOlqnLqip4tEuhv0hNEMXUD0clyXE3p6pZA0S2nnvTlXwLJEZWlb7cTQH1+USgTN4VhAenm/wea1OCAOmqo6fE1WCb9WSKBah+rbUWPWAmE2Rvk0ApiB45eOyNAzU8xcTvj8KvkKEoOaIYeHNA3ZuygAvFMUO0AAAAASUVORK5CYII=";switch(t.typeC4Shape.text){case"person":r="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAIAAADYYG7QAAACD0lEQVR4Xu2YoU4EMRCGT+4j8Ai8AhaH4QHgAUjQuFMECUgMIUgwJAgMhgQsAYUiJCiQIBBY+EITsjfTdme6V24v4c8vyGbb+ZjOtN0bNcvjQXmkH83WvYBWto6PLm6v7p7uH1/w2fXD+PBycX1Pv2l3IdDm/vn7x+dXQiAubRzoURa7gRZWd0iGRIiJbOnhnfYBQZNJjNbuyY2eJG8fkDE3bbG4ep6MHUAsgYxmE3nVs6VsBWJSGccsOlFPmLIViMzLOB7pCVO2AtHJMohH7Fh6zqitQK7m0rJvAVYgGcEpe//PLdDz65sM4pF9N7ICcXDKIB5Nv6j7tD0NoSdM2QrU9Gg0ewE1LqBhHR3BBdvj2vapnidjHxD/q6vd7Pvhr31AwcY8eXMTXAKECZZJFXuEq27aLgQK5uLMohCenGGuGewOxSjBvYBqeG6B+Nqiblggdjnc+ZXDy+FNFpFzw76O3UBAROuXh6FoiAcf5g9eTvUgzy0nWg6I8cXHRUpg5bOVBCo+KDpFajOf23GgPme7RSQ+lacIENUgJ6gg1k6HjgOlqnLqip4tEuhv0hNEMXUD0clyXE3p6pZA0S2nnvTlXwLJEZWlb7cTQH1+USgTN4VhAenm/wea1OCAOmqo6fE1WCb9WSKBah+rbUWPWAmE2Rvk0ApiB45eOyNAzU8xcTvj8KvkKEoOaIYeHNA3ZuygAvFMUO0AAAAASUVORK5CYII=";break;case"external_person":r="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAIAAADYYG7QAAAB6ElEQVR4Xu2YLY+EMBCG9+dWr0aj0Wg0Go1Go0+j8Xdv2uTCvv1gpt0ebHKPuhDaeW4605Z9mJvx4AdXUyTUdd08z+u6flmWZRnHsWkafk9DptAwDPu+f0eAYtu2PEaGWuj5fCIZrBAC2eLBAnRCsEkkxmeaJp7iDJ2QMDdHsLg8SxKFEJaAo8lAXnmuOFIhTMpxxKATebo4UiFknuNo4OniSIXQyRxEA3YsnjGCVEjVXD7yLUAqxBGUyPv/Y4W2beMgGuS7kVQIBycH0fD+oi5pezQETxdHKmQKGk1eQEYldK+jw5GxPfZ9z7Mk0Qnhf1W1m3w//EUn5BDmSZsbR44QQLBEqrBHqOrmSKaQAxdnLArCrxZcM7A7ZKs4ioRq8LFC+NpC3WCBJsvpVw5edm9iEXFuyNfxXAgSwfrFQ1c0iNda8AdejvUgnktOtJQQxmcfFzGglc5WVCj7oDgFqU18boeFSs52CUh8LE8BIVQDT1ABrB0HtgSEYlX5doJnCwv9TXocKCaKbnwhdDKPq4lf3SwU3HLq4V/+WYhHVMa/3b4IlfyikAduCkcBc7mQ3/z/Qq/cTuikhkzB12Ae/mcJC9U+Vo8Ej1gWAtgbeGgFsAMHr50BIWOLCbezvhpBFUdY6EJuJ/QDW0XoMX60zZ0AAAAASUVORK5CYII=";break}const n=e.append("g");n.attr("class","person-man");const i=Se();switch(t.typeC4Shape.text){case"person":case"external_person":case"system":case"external_system":case"container":case"external_container":case"component":case"external_component":i.x=t.x,i.y=t.y,i.fill=o,i.width=t.width,i.height=t.height,i.stroke=l,i.rx=2.5,i.ry=2.5,i.attrs={"stroke-width":.5},re(n,i);break;case"system_db":case"external_system_db":case"container_db":case"external_container_db":case"component_db":case"external_component_db":n.append("path").attr("fill",o).attr("stroke-width","0.5").attr("stroke",l).attr("d","Mstartx,startyc0,-10 half,-10 half,-10c0,0 half,0 half,10l0,heightc0,10 -half,10 -half,10c0,0 -half,0 -half,-10l0,-height".replaceAll("startx",t.x).replaceAll("starty",t.y).replaceAll("half",t.width/2).replaceAll("height",t.height)),n.append("path").attr("fill","none").attr("stroke-width","0.5").attr("stroke",l).attr("d","Mstartx,startyc0,10 half,10 half,10c0,0 half,0 half,-10".replaceAll("startx",t.x).replaceAll("starty",t.y).replaceAll("half",t.width/2));break;case"system_queue":case"external_system_queue":case"container_queue":case"external_container_queue":case"component_queue":case"external_component_queue":n.append("path").attr("fill",o).attr("stroke-width","0.5").attr("stroke",l).attr("d","Mstartx,startylwidth,0c5,0 5,half 5,halfc0,0 0,half -5,halfl-width,0c-5,0 -5,-half -5,-halfc0,0 0,-half 5,-half".replaceAll("startx",t.x).replaceAll("starty",t.y).replaceAll("width",t.width).replaceAll("half",t.height/2)),n.append("path").attr("fill","none").attr("stroke-width","0.5").attr("stroke",l).attr("d","Mstartx,startyc-5,0 -5,half -5,halfc0,half 5,half 5,half".replaceAll("startx",t.x+t.width).replaceAll("starty",t.y).replaceAll("half",t.height/2));break}let u=w0(s,t.typeC4Shape.text);switch(n.append("text").attr("fill",a).attr("font-family",u.fontFamily).attr("font-size",u.fontSize-2).attr("font-style","italic").attr("lengthAdjust","spacing").attr("textLength",t.typeC4Shape.width).attr("x",t.x+t.width/2-t.typeC4Shape.width/2).attr("y",t.y+t.typeC4Shape.Y).text("<<"+t.typeC4Shape.text+">>"),t.typeC4Shape.text){case"person":case"external_person":me(n,48,48,t.x+t.width/2-24,t.y+t.image.Y,r);break}let d=s[t.typeC4Shape.text+"Font"]();return d.fontWeight="bold",d.fontSize=d.fontSize+2,d.fontColor=a,Q(s)(t.label.text,n,t.x,t.y+t.label.Y,t.width,t.height,{fill:a},d),d=s[t.typeC4Shape.text+"Font"](),d.fontColor=a,t.techn&&t.techn?.text!==""?Q(s)(t.techn.text,n,t.x,t.y+t.techn.Y,t.width,t.height,{fill:a,"font-style":"italic"},d):t.type&&t.type.text!==""&&Q(s)(t.type.text,n,t.x,t.y+t.type.Y,t.width,t.height,{fill:a,"font-style":"italic"},d),t.descr&&t.descr.text!==""&&(d=s.personFont(),d.fontColor=a,Q(s)(t.descr.text,n,t.x,t.y+t.descr.Y,t.width,t.height,{fill:a},d)),t.height},"drawC4Shape"),_0=g(function(e){e.append("defs").append("symbol").attr("id","database").attr("fill-rule","evenodd").attr("clip-rule","evenodd").append("path").attr("transform","scale(.5)").attr("d","M12.258.001l.256.004.255.005.253.008.251.01.249.012.247.015.246.016.242.019.241.02.239.023.236.024.233.027.231.028.229.031.225.032.223.034.22.036.217.038.214.04.211.041.208.043.205.045.201.046.198.048.194.05.191.051.187.053.183.054.18.056.175.057.172.059.168.06.163.061.16.063.155.064.15.066.074.033.073.033.071.034.07.034.069.035.068.035.067.035.066.035.064.036.064.036.062.036.06.036.06.037.058.037.058.037.055.038.055.038.053.038.052.038.051.039.05.039.048.039.047.039.045.04.044.04.043.04.041.04.04.041.039.041.037.041.036.041.034.041.033.042.032.042.03.042.029.042.027.042.026.043.024.043.023.043.021.043.02.043.018.044.017.043.015.044.013.044.012.044.011.045.009.044.007.045.006.045.004.045.002.045.001.045v17l-.001.045-.002.045-.004.045-.006.045-.007.045-.009.044-.011.045-.012.044-.013.044-.015.044-.017.043-.018.044-.02.043-.021.043-.023.043-.024.043-.026.043-.027.042-.029.042-.03.042-.032.042-.033.042-.034.041-.036.041-.037.041-.039.041-.04.041-.041.04-.043.04-.044.04-.045.04-.047.039-.048.039-.05.039-.051.039-.052.038-.053.038-.055.038-.055.038-.058.037-.058.037-.06.037-.06.036-.062.036-.064.036-.064.036-.066.035-.067.035-.068.035-.069.035-.07.034-.071.034-.073.033-.074.033-.15.066-.155.064-.16.063-.163.061-.168.06-.172.059-.175.057-.18.056-.183.054-.187.053-.191.051-.194.05-.198.048-.201.046-.205.045-.208.043-.211.041-.214.04-.217.038-.22.036-.223.034-.225.032-.229.031-.231.028-.233.027-.236.024-.239.023-.241.02-.242.019-.246.016-.247.015-.249.012-.251.01-.253.008-.255.005-.256.004-.258.001-.258-.001-.256-.004-.255-.005-.253-.008-.251-.01-.249-.012-.247-.015-.245-.016-.243-.019-.241-.02-.238-.023-.236-.024-.234-.027-.231-.028-.228-.031-.226-.032-.223-.034-.22-.036-.217-.038-.214-.04-.211-.041-.208-.043-.204-.045-.201-.046-.198-.048-.195-.05-.19-.051-.187-.053-.184-.054-.179-.056-.176-.057-.172-.059-.167-.06-.164-.061-.159-.063-.155-.064-.151-.066-.074-.033-.072-.033-.072-.034-.07-.034-.069-.035-.068-.035-.067-.035-.066-.035-.064-.036-.063-.036-.062-.036-.061-.036-.06-.037-.058-.037-.057-.037-.056-.038-.055-.038-.053-.038-.052-.038-.051-.039-.049-.039-.049-.039-.046-.039-.046-.04-.044-.04-.043-.04-.041-.04-.04-.041-.039-.041-.037-.041-.036-.041-.034-.041-.033-.042-.032-.042-.03-.042-.029-.042-.027-.042-.026-.043-.024-.043-.023-.043-.021-.043-.02-.043-.018-.044-.017-.043-.015-.044-.013-.044-.012-.044-.011-.045-.009-.044-.007-.045-.006-.045-.004-.045-.002-.045-.001-.045v-17l.001-.045.002-.045.004-.045.006-.045.007-.045.009-.044.011-.045.012-.044.013-.044.015-.044.017-.043.018-.044.02-.043.021-.043.023-.043.024-.043.026-.043.027-.042.029-.042.03-.042.032-.042.033-.042.034-.041.036-.041.037-.041.039-.041.04-.041.041-.04.043-.04.044-.04.046-.04.046-.039.049-.039.049-.039.051-.039.052-.038.053-.038.055-.038.056-.038.057-.037.058-.037.06-.037.061-.036.062-.036.063-.036.064-.036.066-.035.067-.035.068-.035.069-.035.07-.034.072-.034.072-.033.074-.033.151-.066.155-.064.159-.063.164-.061.167-.06.172-.059.176-.057.179-.056.184-.054.187-.053.19-.051.195-.05.198-.048.201-.046.204-.045.208-.043.211-.041.214-.04.217-.038.22-.036.223-.034.226-.032.228-.031.231-.028.234-.027.236-.024.238-.023.241-.02.243-.019.245-.016.247-.015.249-.012.251-.01.253-.008.255-.005.256-.004.258-.001.258.001zm-9.258 20.499v.01l.001.021.003.021.004.022.005.021.006.022.007.022.009.023.01.022.011.023.012.023.013.023.015.023.016.024.017.023.018.024.019.024.021.024.022.025.023.024.024.025.052.049.056.05.061.051.066.051.07.051.075.051.079.052.084.052.088.052.092.052.097.052.102.051.105.052.11.052.114.051.119.051.123.051.127.05.131.05.135.05.139.048.144.049.147.047.152.047.155.047.16.045.163.045.167.043.171.043.176.041.178.041.183.039.187.039.19.037.194.035.197.035.202.033.204.031.209.03.212.029.216.027.219.025.222.024.226.021.23.02.233.018.236.016.24.015.243.012.246.01.249.008.253.005.256.004.259.001.26-.001.257-.004.254-.005.25-.008.247-.011.244-.012.241-.014.237-.016.233-.018.231-.021.226-.021.224-.024.22-.026.216-.027.212-.028.21-.031.205-.031.202-.034.198-.034.194-.036.191-.037.187-.039.183-.04.179-.04.175-.042.172-.043.168-.044.163-.045.16-.046.155-.046.152-.047.148-.048.143-.049.139-.049.136-.05.131-.05.126-.05.123-.051.118-.052.114-.051.11-.052.106-.052.101-.052.096-.052.092-.052.088-.053.083-.051.079-.052.074-.052.07-.051.065-.051.06-.051.056-.05.051-.05.023-.024.023-.025.021-.024.02-.024.019-.024.018-.024.017-.024.015-.023.014-.024.013-.023.012-.023.01-.023.01-.022.008-.022.006-.022.006-.022.004-.022.004-.021.001-.021.001-.021v-4.127l-.077.055-.08.053-.083.054-.085.053-.087.052-.09.052-.093.051-.095.05-.097.05-.1.049-.102.049-.105.048-.106.047-.109.047-.111.046-.114.045-.115.045-.118.044-.12.043-.122.042-.124.042-.126.041-.128.04-.13.04-.132.038-.134.038-.135.037-.138.037-.139.035-.142.035-.143.034-.144.033-.147.032-.148.031-.15.03-.151.03-.153.029-.154.027-.156.027-.158.026-.159.025-.161.024-.162.023-.163.022-.165.021-.166.02-.167.019-.169.018-.169.017-.171.016-.173.015-.173.014-.175.013-.175.012-.177.011-.178.01-.179.008-.179.008-.181.006-.182.005-.182.004-.184.003-.184.002h-.37l-.184-.002-.184-.003-.182-.004-.182-.005-.181-.006-.179-.008-.179-.008-.178-.01-.176-.011-.176-.012-.175-.013-.173-.014-.172-.015-.171-.016-.17-.017-.169-.018-.167-.019-.166-.02-.165-.021-.163-.022-.162-.023-.161-.024-.159-.025-.157-.026-.156-.027-.155-.027-.153-.029-.151-.03-.15-.03-.148-.031-.146-.032-.145-.033-.143-.034-.141-.035-.14-.035-.137-.037-.136-.037-.134-.038-.132-.038-.13-.04-.128-.04-.126-.041-.124-.042-.122-.042-.12-.044-.117-.043-.116-.045-.113-.045-.112-.046-.109-.047-.106-.047-.105-.048-.102-.049-.1-.049-.097-.05-.095-.05-.093-.052-.09-.051-.087-.052-.085-.053-.083-.054-.08-.054-.077-.054v4.127zm0-5.654v.011l.001.021.003.021.004.021.005.022.006.022.007.022.009.022.01.022.011.023.012.023.013.023.015.024.016.023.017.024.018.024.019.024.021.024.022.024.023.025.024.024.052.05.056.05.061.05.066.051.07.051.075.052.079.051.084.052.088.052.092.052.097.052.102.052.105.052.11.051.114.051.119.052.123.05.127.051.131.05.135.049.139.049.144.048.147.048.152.047.155.046.16.045.163.045.167.044.171.042.176.042.178.04.183.04.187.038.19.037.194.036.197.034.202.033.204.032.209.03.212.028.216.027.219.025.222.024.226.022.23.02.233.018.236.016.24.014.243.012.246.01.249.008.253.006.256.003.259.001.26-.001.257-.003.254-.006.25-.008.247-.01.244-.012.241-.015.237-.016.233-.018.231-.02.226-.022.224-.024.22-.025.216-.027.212-.029.21-.03.205-.032.202-.033.198-.035.194-.036.191-.037.187-.039.183-.039.179-.041.175-.042.172-.043.168-.044.163-.045.16-.045.155-.047.152-.047.148-.048.143-.048.139-.05.136-.049.131-.05.126-.051.123-.051.118-.051.114-.052.11-.052.106-.052.101-.052.096-.052.092-.052.088-.052.083-.052.079-.052.074-.051.07-.052.065-.051.06-.05.056-.051.051-.049.023-.025.023-.024.021-.025.02-.024.019-.024.018-.024.017-.024.015-.023.014-.023.013-.024.012-.022.01-.023.01-.023.008-.022.006-.022.006-.022.004-.021.004-.022.001-.021.001-.021v-4.139l-.077.054-.08.054-.083.054-.085.052-.087.053-.09.051-.093.051-.095.051-.097.05-.1.049-.102.049-.105.048-.106.047-.109.047-.111.046-.114.045-.115.044-.118.044-.12.044-.122.042-.124.042-.126.041-.128.04-.13.039-.132.039-.134.038-.135.037-.138.036-.139.036-.142.035-.143.033-.144.033-.147.033-.148.031-.15.03-.151.03-.153.028-.154.028-.156.027-.158.026-.159.025-.161.024-.162.023-.163.022-.165.021-.166.02-.167.019-.169.018-.169.017-.171.016-.173.015-.173.014-.175.013-.175.012-.177.011-.178.009-.179.009-.179.007-.181.007-.182.005-.182.004-.184.003-.184.002h-.37l-.184-.002-.184-.003-.182-.004-.182-.005-.181-.007-.179-.007-.179-.009-.178-.009-.176-.011-.176-.012-.175-.013-.173-.014-.172-.015-.171-.016-.17-.017-.169-.018-.167-.019-.166-.02-.165-.021-.163-.022-.162-.023-.161-.024-.159-.025-.157-.026-.156-.027-.155-.028-.153-.028-.151-.03-.15-.03-.148-.031-.146-.033-.145-.033-.143-.033-.141-.035-.14-.036-.137-.036-.136-.037-.134-.038-.132-.039-.13-.039-.128-.04-.126-.041-.124-.042-.122-.043-.12-.043-.117-.044-.116-.044-.113-.046-.112-.046-.109-.046-.106-.047-.105-.048-.102-.049-.1-.049-.097-.05-.095-.051-.093-.051-.09-.051-.087-.053-.085-.052-.083-.054-.08-.054-.077-.054v4.139zm0-5.666v.011l.001.02.003.022.004.021.005.022.006.021.007.022.009.023.01.022.011.023.012.023.013.023.015.023.016.024.017.024.018.023.019.024.021.025.022.024.023.024.024.025.052.05.056.05.061.05.066.051.07.051.075.052.079.051.084.052.088.052.092.052.097.052.102.052.105.051.11.052.114.051.119.051.123.051.127.05.131.05.135.05.139.049.144.048.147.048.152.047.155.046.16.045.163.045.167.043.171.043.176.042.178.04.183.04.187.038.19.037.194.036.197.034.202.033.204.032.209.03.212.028.216.027.219.025.222.024.226.021.23.02.233.018.236.017.24.014.243.012.246.01.249.008.253.006.256.003.259.001.26-.001.257-.003.254-.006.25-.008.247-.01.244-.013.241-.014.237-.016.233-.018.231-.02.226-.022.224-.024.22-.025.216-.027.212-.029.21-.03.205-.032.202-.033.198-.035.194-.036.191-.037.187-.039.183-.039.179-.041.175-.042.172-.043.168-.044.163-.045.16-.045.155-.047.152-.047.148-.048.143-.049.139-.049.136-.049.131-.051.126-.05.123-.051.118-.052.114-.051.11-.052.106-.052.101-.052.096-.052.092-.052.088-.052.083-.052.079-.052.074-.052.07-.051.065-.051.06-.051.056-.05.051-.049.023-.025.023-.025.021-.024.02-.024.019-.024.018-.024.017-.024.015-.023.014-.024.013-.023.012-.023.01-.022.01-.023.008-.022.006-.022.006-.022.004-.022.004-.021.001-.021.001-.021v-4.153l-.077.054-.08.054-.083.053-.085.053-.087.053-.09.051-.093.051-.095.051-.097.05-.1.049-.102.048-.105.048-.106.048-.109.046-.111.046-.114.046-.115.044-.118.044-.12.043-.122.043-.124.042-.126.041-.128.04-.13.039-.132.039-.134.038-.135.037-.138.036-.139.036-.142.034-.143.034-.144.033-.147.032-.148.032-.15.03-.151.03-.153.028-.154.028-.156.027-.158.026-.159.024-.161.024-.162.023-.163.023-.165.021-.166.02-.167.019-.169.018-.169.017-.171.016-.173.015-.173.014-.175.013-.175.012-.177.01-.178.01-.179.009-.179.007-.181.006-.182.006-.182.004-.184.003-.184.001-.185.001-.185-.001-.184-.001-.184-.003-.182-.004-.182-.006-.181-.006-.179-.007-.179-.009-.178-.01-.176-.01-.176-.012-.175-.013-.173-.014-.172-.015-.171-.016-.17-.017-.169-.018-.167-.019-.166-.02-.165-.021-.163-.023-.162-.023-.161-.024-.159-.024-.157-.026-.156-.027-.155-.028-.153-.028-.151-.03-.15-.03-.148-.032-.146-.032-.145-.033-.143-.034-.141-.034-.14-.036-.137-.036-.136-.037-.134-.038-.132-.039-.13-.039-.128-.041-.126-.041-.124-.041-.122-.043-.12-.043-.117-.044-.116-.044-.113-.046-.112-.046-.109-.046-.106-.048-.105-.048-.102-.048-.1-.05-.097-.049-.095-.051-.093-.051-.09-.052-.087-.052-.085-.053-.083-.053-.08-.054-.077-.054v4.153zm8.74-8.179l-.257.004-.254.005-.25.008-.247.011-.244.012-.241.014-.237.016-.233.018-.231.021-.226.022-.224.023-.22.026-.216.027-.212.028-.21.031-.205.032-.202.033-.198.034-.194.036-.191.038-.187.038-.183.04-.179.041-.175.042-.172.043-.168.043-.163.045-.16.046-.155.046-.152.048-.148.048-.143.048-.139.049-.136.05-.131.05-.126.051-.123.051-.118.051-.114.052-.11.052-.106.052-.101.052-.096.052-.092.052-.088.052-.083.052-.079.052-.074.051-.07.052-.065.051-.06.05-.056.05-.051.05-.023.025-.023.024-.021.024-.02.025-.019.024-.018.024-.017.023-.015.024-.014.023-.013.023-.012.023-.01.023-.01.022-.008.022-.006.023-.006.021-.004.022-.004.021-.001.021-.001.021.001.021.001.021.004.021.004.022.006.021.006.023.008.022.01.022.01.023.012.023.013.023.014.023.015.024.017.023.018.024.019.024.02.025.021.024.023.024.023.025.051.05.056.05.06.05.065.051.07.052.074.051.079.052.083.052.088.052.092.052.096.052.101.052.106.052.11.052.114.052.118.051.123.051.126.051.131.05.136.05.139.049.143.048.148.048.152.048.155.046.16.046.163.045.168.043.172.043.175.042.179.041.183.04.187.038.191.038.194.036.198.034.202.033.205.032.21.031.212.028.216.027.22.026.224.023.226.022.231.021.233.018.237.016.241.014.244.012.247.011.25.008.254.005.257.004.26.001.26-.001.257-.004.254-.005.25-.008.247-.011.244-.012.241-.014.237-.016.233-.018.231-.021.226-.022.224-.023.22-.026.216-.027.212-.028.21-.031.205-.032.202-.033.198-.034.194-.036.191-.038.187-.038.183-.04.179-.041.175-.042.172-.043.168-.043.163-.045.16-.046.155-.046.152-.048.148-.048.143-.048.139-.049.136-.05.131-.05.126-.051.123-.051.118-.051.114-.052.11-.052.106-.052.101-.052.096-.052.092-.052.088-.052.083-.052.079-.052.074-.051.07-.052.065-.051.06-.05.056-.05.051-.05.023-.025.023-.024.021-.024.02-.025.019-.024.018-.024.017-.023.015-.024.014-.023.013-.023.012-.023.01-.023.01-.022.008-.022.006-.023.006-.021.004-.022.004-.021.001-.021.001-.021-.001-.021-.001-.021-.004-.021-.004-.022-.006-.021-.006-.023-.008-.022-.01-.022-.01-.023-.012-.023-.013-.023-.014-.023-.015-.024-.017-.023-.018-.024-.019-.024-.02-.025-.021-.024-.023-.024-.023-.025-.051-.05-.056-.05-.06-.05-.065-.051-.07-.052-.074-.051-.079-.052-.083-.052-.088-.052-.092-.052-.096-.052-.101-.052-.106-.052-.11-.052-.114-.052-.118-.051-.123-.051-.126-.051-.131-.05-.136-.05-.139-.049-.143-.048-.148-.048-.152-.048-.155-.046-.16-.046-.163-.045-.168-.043-.172-.043-.175-.042-.179-.041-.183-.04-.187-.038-.191-.038-.194-.036-.198-.034-.202-.033-.205-.032-.21-.031-.212-.028-.216-.027-.22-.026-.224-.023-.226-.022-.231-.021-.233-.018-.237-.016-.241-.014-.244-.012-.247-.011-.25-.008-.254-.005-.257-.004-.26-.001-.26.001z")},"insertDatabaseIcon"),x0=g(function(e){e.append("defs").append("symbol").attr("id","computer").attr("width","24").attr("height","24").append("path").attr("transform","scale(.5)").attr("d","M2 2v13h20v-13h-20zm18 11h-16v-9h16v9zm-10.228 6l.466-1h3.524l.467 1h-4.457zm14.228 3h-24l2-6h2.104l-1.33 4h18.45l-1.297-4h2.073l2 6zm-5-10h-14v-7h14v7z")},"insertComputerIcon"),m0=g(function(e){e.append("defs").append("symbol").attr("id","clock").attr("width","24").attr("height","24").append("path").attr("transform","scale(.5)").attr("d","M12 2c5.514 0 10 4.486 10 10s-4.486 10-10 10-10-4.486-10-10 4.486-10 10-10zm0-2c-6.627 0-12 5.373-12 12s5.373 12 12 12 12-5.373 12-12-5.373-12-12-12zm5.848 12.459c.202.038.202.333.001.372-1.907.361-6.045 1.111-6.547 1.111-.719 0-1.301-.582-1.301-1.301 0-.512.77-5.447 1.125-7.445.034-.192.312-.181.343.014l.985 6.238 5.394 1.011z")},"insertClockIcon"),v0=g(function(e){e.append("defs").append("marker").attr("id","arrowhead").attr("refX",9).attr("refY",5).attr("markerUnits","userSpaceOnUse").attr("markerWidth",12).attr("markerHeight",12).attr("orient","auto").append("path").attr("d","M 0 0 L 10 5 L 0 10 z")},"insertArrowHead"),E0=g(function(e){e.append("defs").append("marker").attr("id","arrowend").attr("refX",1).attr("refY",5).attr("markerUnits","userSpaceOnUse").attr("markerWidth",12).attr("markerHeight",12).attr("orient","auto").append("path").attr("d","M 10 0 L 0 5 L 10 10 z")},"insertArrowEnd"),k0=g(function(e){e.append("defs").append("marker").attr("id","filled-head").attr("refX",18).attr("refY",7).attr("markerWidth",20).attr("markerHeight",28).attr("orient","auto").append("path").attr("d","M 18,7 L9,13 L14,7 L9,1 Z")},"insertArrowFilledHead"),A0=g(function(e){e.append("defs").append("marker").attr("id","sequencenumber").attr("refX",15).attr("refY",15).attr("markerWidth",60).attr("markerHeight",40).attr("orient","auto").append("circle").attr("cx",15).attr("cy",15).attr("r",6)},"insertDynamicNumber"),C0=g(function(e){const s=e.append("defs").append("marker").attr("id","crosshead").attr("markerWidth",15).attr("markerHeight",8).attr("orient","auto").attr("refX",16).attr("refY",4);s.append("path").attr("fill","black").attr("stroke","#000000").style("stroke-dasharray","0, 0").attr("stroke-width","1px").attr("d","M 9,2 V 6 L16,4 Z"),s.append("path").attr("fill","none").attr("stroke","#000000").style("stroke-dasharray","0, 0").attr("stroke-width","1px").attr("d","M 0,1 L 6,7 M 6,1 L 0,7")},"insertArrowCrossHead"),w0=g((e,t)=>({fontFamily:e[t+"FontFamily"],fontSize:e[t+"FontSize"],fontWeight:e[t+"FontWeight"]}),"getC4ShapeFont"),Q=(function(){function e(l,a,r,n,i,u,d){const y=a.append("text").attr("x",r+i/2).attr("y",n+u/2+5).style("text-anchor","middle").text(l);o(y,d)}g(e,"byText");function t(l,a,r,n,i,u,d,y){const{fontSize:p,fontFamily:E,fontWeight:O}=y,S=l.split($t.lineBreakRegex);for(let P=0;P<S.length;P++){const M=P*p-p*(S.length-1)/2,U=a.append("text").attr("x",r+i/2).attr("y",n).style("text-anchor","middle").attr("dominant-baseline","middle").style("font-size",p).style("font-weight",O).style("font-family",E);U.append("tspan").attr("dy",M).text(S[P]).attr("alignment-baseline","mathematical"),o(U,d)}}g(t,"byTspan");function s(l,a,r,n,i,u,d,y){const p=a.append("switch"),O=p.append("foreignObject").attr("x",r).attr("y",n).attr("width",i).attr("height",u).append("xhtml:div").style("display","table").style("height","100%").style("width","100%");O.append("div").style("display","table-cell").style("text-align","center").style("vertical-align","middle").text(l),t(l,p,r,n,i,u,d,y),o(O,d)}g(s,"byFo");function o(l,a){for(const r in a)a.hasOwnProperty(r)&&l.attr(r,a[r])}return g(o,"_setTextAttrs"),function(l){return l.textPlacement==="fo"?s:l.textPlacement==="old"?e:t}})(),z={drawRect:re,drawBoundary:g0,drawC4Shape:b0,drawRels:y0,drawImage:me,insertArrowHead:v0,insertArrowEnd:E0,insertArrowFilledHead:k0,insertDynamicNumber:A0,insertArrowCrossHead:C0,insertDatabaseIcon:_0,insertComputerIcon:x0,insertClockIcon:m0},Xt=0,Wt=0,ve=4,ee=2;Ft.yy=te;var _={},Ot,Ee=(Ot=class{constructor(t){this.name="",this.data={},this.data.startx=void 0,this.data.stopx=void 0,this.data.starty=void 0,this.data.stopy=void 0,this.data.widthLimit=void 0,this.nextData={},this.nextData.startx=void 0,this.nextData.stopx=void 0,this.nextData.starty=void 0,this.nextData.stopy=void 0,this.nextData.cnt=0,ae(t.db.getConfig())}setData(t,s,o,l){this.nextData.startx=this.data.startx=t,this.nextData.stopx=this.data.stopx=s,this.nextData.starty=this.data.starty=o,this.nextData.stopy=this.data.stopy=l}updateVal(t,s,o,l){t[s]===void 0?t[s]=o:t[s]=l(o,t[s])}insert(t){this.nextData.cnt=this.nextData.cnt+1;let s=this.nextData.startx===this.nextData.stopx?this.nextData.stopx+t.margin:this.nextData.stopx+t.margin*2,o=s+t.width,l=this.nextData.starty+t.margin*2,a=l+t.height;(s>=this.data.widthLimit||o>=this.data.widthLimit||this.nextData.cnt>ve)&&(s=this.nextData.startx+t.margin+_.nextLinePaddingX,l=this.nextData.stopy+t.margin*2,this.nextData.stopx=o=s+t.width,this.nextData.starty=this.nextData.stopy,this.nextData.stopy=a=l+t.height,this.nextData.cnt=1),t.x=s,t.y=l,this.updateVal(this.data,"startx",s,Math.min),this.updateVal(this.data,"starty",l,Math.min),this.updateVal(this.data,"stopx",o,Math.max),this.updateVal(this.data,"stopy",a,Math.max),this.updateVal(this.nextData,"startx",s,Math.min),this.updateVal(this.nextData,"starty",l,Math.min),this.updateVal(this.nextData,"stopx",o,Math.max),this.updateVal(this.nextData,"stopy",a,Math.max)}init(t){this.name="",this.data={startx:void 0,stopx:void 0,starty:void 0,stopy:void 0,widthLimit:void 0},this.nextData={startx:void 0,stopx:void 0,starty:void 0,stopy:void 0,cnt:0},ae(t.db.getConfig())}bumpLastMargin(t){this.data.stopx+=t,this.data.stopy+=t}},g(Ot,"Bounds"),Ot),ae=g(function(e){Ne(_,e),e.fontFamily&&(_.personFontFamily=_.systemFontFamily=_.messageFontFamily=e.fontFamily),e.fontSize&&(_.personFontSize=_.systemFontSize=_.messageFontSize=e.fontSize),e.fontWeight&&(_.personFontWeight=_.systemFontWeight=_.messageFontWeight=e.fontWeight)},"setConf"),Pt=g((e,t)=>({fontFamily:e[t+"FontFamily"],fontSize:e[t+"FontSize"],fontWeight:e[t+"FontWeight"]}),"c4ShapeFont"),Ut=g(e=>({fontFamily:e.boundaryFontFamily,fontSize:e.boundaryFontSize,fontWeight:e.boundaryFontWeight}),"boundaryFont"),T0=g(e=>({fontFamily:e.messageFontFamily,fontSize:e.messageFontSize,fontWeight:e.messageFontWeight}),"messageFont");function j(e,t,s,o,l){if(!t[e].width)if(s)t[e].text=je(t[e].text,l,o),t[e].textLines=t[e].text.split($t.lineBreakRegex).length,t[e].width=l,t[e].height=fe(t[e].text,o);else{let a=t[e].text.split($t.lineBreakRegex);t[e].textLines=a.length;let r=0;t[e].height=0,t[e].width=0;for(const n of a)t[e].width=Math.max(Tt(n,o),t[e].width),r=fe(n,o),t[e].height=t[e].height+r}}g(j,"calcC4ShapeTextWH");var ke=g(function(e,t,s){t.x=s.data.startx,t.y=s.data.starty,t.width=s.data.stopx-s.data.startx,t.height=s.data.stopy-s.data.starty,t.label.y=_.c4ShapeMargin-35;let o=t.wrap&&_.wrap,l=Ut(_);l.fontSize=l.fontSize+2,l.fontWeight="bold";let a=Tt(t.label.text,l);j("label",t,o,l,a),z.drawBoundary(e,t,_)},"drawBoundary"),Ae=g(function(e,t,s,o){let l=0;for(const a of o){l=0;const r=s[a];let n=Pt(_,r.typeC4Shape.text);switch(n.fontSize=n.fontSize-2,r.typeC4Shape.width=Tt("«"+r.typeC4Shape.text+"»",n),r.typeC4Shape.height=n.fontSize+2,r.typeC4Shape.Y=_.c4ShapePadding,l=r.typeC4Shape.Y+r.typeC4Shape.height-4,r.image={width:0,height:0,Y:0},r.typeC4Shape.text){case"person":case"external_person":r.image.width=48,r.image.height=48,r.image.Y=l,l=r.image.Y+r.image.height;break}r.sprite&&(r.image.width=48,r.image.height=48,r.image.Y=l,l=r.image.Y+r.image.height);let i=r.wrap&&_.wrap,u=_.width-_.c4ShapePadding*2,d=Pt(_,r.typeC4Shape.text);if(d.fontSize=d.fontSize+2,d.fontWeight="bold",j("label",r,i,d,u),r.label.Y=l+8,l=r.label.Y+r.label.height,r.type&&r.type.text!==""){r.type.text="["+r.type.text+"]";let E=Pt(_,r.typeC4Shape.text);j("type",r,i,E,u),r.type.Y=l+5,l=r.type.Y+r.type.height}else if(r.techn&&r.techn.text!==""){r.techn.text="["+r.techn.text+"]";let E=Pt(_,r.techn.text);j("techn",r,i,E,u),r.techn.Y=l+5,l=r.techn.Y+r.techn.height}let y=l,p=r.label.width;if(r.descr&&r.descr.text!==""){let E=Pt(_,r.typeC4Shape.text);j("descr",r,i,E,u),r.descr.Y=l+20,l=r.descr.Y+r.descr.height,p=Math.max(r.label.width,r.descr.width),y=l-r.descr.textLines*5}p=p+_.c4ShapePadding,r.width=Math.max(r.width||_.width,p,_.width),r.height=Math.max(r.height||_.height,y,_.height),r.margin=r.margin||_.c4ShapeMargin,e.insert(r),z.drawC4Shape(t,r,_)}e.bumpLastMargin(_.c4ShapeMargin)},"drawC4ShapeArray"),Rt,Y=(Rt=class{constructor(t,s){this.x=t,this.y=s}},g(Rt,"Point"),Rt),pe=g(function(e,t){let s=e.x,o=e.y,l=t.x,a=t.y,r=s+e.width/2,n=o+e.height/2,i=Math.abs(s-l),u=Math.abs(o-a),d=u/i,y=e.height/e.width,p=null;return o==a&&s<l?p=new Y(s+e.width,n):o==a&&s>l?p=new Y(s,n):s==l&&o<a?p=new Y(r,o+e.height):s==l&&o>a&&(p=new Y(r,o)),s>l&&o<a?y>=d?p=new Y(s,n+d*e.width/2):p=new Y(r-i/u*e.height/2,o+e.height):s<l&&o<a?y>=d?p=new Y(s+e.width,n+d*e.width/2):p=new Y(r+i/u*e.height/2,o+e.height):s<l&&o>a?y>=d?p=new Y(s+e.width,n-d*e.width/2):p=new Y(r+e.height/2*i/u,o):s>l&&o>a&&(y>=d?p=new Y(s,n-e.width/2*d):p=new Y(r-e.height/2*i/u,o)),p},"getIntersectPoint"),O0=g(function(e,t){let s={x:0,y:0};s.x=t.x+t.width/2,s.y=t.y+t.height/2;let o=pe(e,s);s.x=e.x+e.width/2,s.y=e.y+e.height/2;let l=pe(t,s);return{startPoint:o,endPoint:l}},"getIntersectPoints"),R0=g(function(e,t,s,o){let l=0;for(let a of t){l=l+1;let r=a.wrap&&_.wrap,n=T0(_);o.db.getC4Type()==="C4Dynamic"&&(a.label.text=l+": "+a.label.text);let u=Tt(a.label.text,n);j("label",a,r,n,u),a.techn&&a.techn.text!==""&&(u=Tt(a.techn.text,n),j("techn",a,r,n,u)),a.descr&&a.descr.text!==""&&(u=Tt(a.descr.text,n),j("descr",a,r,n,u));let d=s(a.from),y=s(a.to),p=O0(d,y);a.startPoint=p.startPoint,a.endPoint=p.endPoint}z.drawRels(e,t,_)},"drawRels");function se(e,t,s,o,l){let a=new Ee(l);a.data.widthLimit=s.data.widthLimit/Math.min(ee,o.length);for(let[r,n]of o.entries()){let i=0;n.image={width:0,height:0,Y:0},n.sprite&&(n.image.width=48,n.image.height=48,n.image.Y=i,i=n.image.Y+n.image.height);let u=n.wrap&&_.wrap,d=Ut(_);if(d.fontSize=d.fontSize+2,d.fontWeight="bold",j("label",n,u,d,a.data.widthLimit),n.label.Y=i+8,i=n.label.Y+n.label.height,n.type&&n.type.text!==""){n.type.text="["+n.type.text+"]";let O=Ut(_);j("type",n,u,O,a.data.widthLimit),n.type.Y=i+5,i=n.type.Y+n.type.height}if(n.descr&&n.descr.text!==""){let O=Ut(_);O.fontSize=O.fontSize-2,j("descr",n,u,O,a.data.widthLimit),n.descr.Y=i+20,i=n.descr.Y+n.descr.height}if(r==0||r%ee===0){let O=s.data.startx+_.diagramMarginX,S=s.data.stopy+_.diagramMarginY+i;a.setData(O,O,S,S)}else{let O=a.data.stopx!==a.data.startx?a.data.stopx+_.diagramMarginX:a.data.startx,S=a.data.starty;a.setData(O,O,S,S)}a.name=n.alias;let y=l.db.getC4ShapeArray(n.alias),p=l.db.getC4ShapeKeys(n.alias);p.length>0&&Ae(a,e,y,p),t=n.alias;let E=l.db.getBoundaries(t);E.length>0&&se(e,t,a,E,l),n.alias!=="global"&&ke(e,n,a),s.data.stopy=Math.max(a.data.stopy+_.c4ShapeMargin,s.data.stopy),s.data.stopx=Math.max(a.data.stopx+_.c4ShapeMargin,s.data.stopx),Xt=Math.max(Xt,s.data.stopx),Wt=Math.max(Wt,s.data.stopy)}}g(se,"drawInsideBoundary");var S0=g(function(e,t,s,o){_=Bt().c4;const l=Bt().securityLevel;let a;l==="sandbox"&&(a=jt("#i"+t));const r=l==="sandbox"?jt(a.nodes()[0].contentDocument.body):jt("body");let n=o.db;o.db.setWrap(_.wrap),ve=n.getC4ShapeInRow(),ee=n.getC4BoundaryInRow(),de.debug(`C:${JSON.stringify(_,null,2)}`);const i=l==="sandbox"?r.select(`[id="${t}"]`):jt(`[id="${t}"]`);z.insertComputerIcon(i),z.insertDatabaseIcon(i),z.insertClockIcon(i);let u=new Ee(o);u.setData(_.diagramMarginX,_.diagramMarginX,_.diagramMarginY,_.diagramMarginY),u.data.widthLimit=screen.availWidth,Xt=_.diagramMarginX,Wt=_.diagramMarginY;const d=o.db.getTitle();let y=o.db.getBoundaries("");se(i,"",u,y,o),z.insertArrowHead(i),z.insertArrowEnd(i),z.insertArrowCrossHead(i),z.insertArrowFilledHead(i),R0(i,o.db.getRels(),o.db.getC4Shape,o),u.data.stopx=Xt,u.data.stopy=Wt;const p=u.data;let O=p.stopy-p.starty+2*_.diagramMarginY;const P=p.stopx-p.startx+2*_.diagramMarginX;d&&i.append("text").text(d).attr("x",(p.stopx-p.startx)/2-4*_.diagramMarginX).attr("y",p.starty+_.diagramMarginY),Le(i,O,P,_.useMaxWidth);const M=d?60:0;i.attr("viewBox",p.startx-_.diagramMarginX+" -"+(_.diagramMarginY+M)+" "+P+" "+(O+M)),de.debug("models:",p)},"draw"),ye={drawPersonOrSystemArray:Ae,drawBoundary:ke,setConf:ae,draw:S0},D0=g(e=>`.person {
-    stroke: ${e.personBorder};
-    fill: ${e.personBkg};
-  }
-`,"getStyles"),P0=D0,M0={parser:Ue,db:te,renderer:ye,styles:P0,init:g(({c4:e,wrap:t})=>{ye.setConf(e),te.setWrap(t)},"init")};export{M0 as diagram};
diff --git a/docs/dist/assets/channel-kd1Rx1KT.js b/docs/dist/assets/channel-kd1Rx1KT.js
deleted file mode 100644
index 6d36bf84..00000000
--- a/docs/dist/assets/channel-kd1Rx1KT.js
+++ /dev/null
@@ -1 +0,0 @@
-import{ap as o,aq as n}from"./index-BxX29htg.js";const t=(a,r)=>o.lang.round(n.parse(a)[r]);export{t as c};
diff --git a/docs/dist/assets/chunk-4BX2VUAB-BU7cqk0M.js b/docs/dist/assets/chunk-4BX2VUAB-BU7cqk0M.js
deleted file mode 100644
index 6f5cbdb6..00000000
--- a/docs/dist/assets/chunk-4BX2VUAB-BU7cqk0M.js
+++ /dev/null
@@ -1 +0,0 @@
-import{_ as i}from"./index-BxX29htg.js";function t(c,e){c.accDescr&&e.setAccDescription?.(c.accDescr),c.accTitle&&e.setAccTitle?.(c.accTitle),c.title&&e.setDiagramTitle?.(c.title)}i(t,"populateCommonDb");export{t as p};
diff --git a/docs/dist/assets/chunk-55IACEB6-BE1gdz1f.js b/docs/dist/assets/chunk-55IACEB6-BE1gdz1f.js
deleted file mode 100644
index d9f83edf..00000000
--- a/docs/dist/assets/chunk-55IACEB6-BE1gdz1f.js
+++ /dev/null
@@ -1 +0,0 @@
-import{_ as a,d as o}from"./index-BxX29htg.js";var d=a((t,e)=>{let n;return e==="sandbox"&&(n=o("#i"+t)),(e==="sandbox"?o(n.nodes()[0].contentDocument.body):o("body")).select(`[id="${t}"]`)},"getDiagramElement");export{d as g};
diff --git a/docs/dist/assets/chunk-B4BG7PRW-DyUrByJj.js b/docs/dist/assets/chunk-B4BG7PRW-DyUrByJj.js
deleted file mode 100644
index fcd77589..00000000
--- a/docs/dist/assets/chunk-B4BG7PRW-DyUrByJj.js
+++ /dev/null
@@ -1,165 +0,0 @@
-import{g as et}from"./chunk-FMBD7UC4-Bm3lI1XN.js";import{g as tt}from"./chunk-55IACEB6-BE1gdz1f.js";import{s as st}from"./chunk-QN33PNHL-1s4FuBGd.js";import{_ as A,l as Oe,c as D,o as it,r as at,u as we,d as ee,b as nt,a as rt,s as ut,g as lt,p as ot,q as ct,k as v,y as ht,x as dt,i as pt,Q as R}from"./index-BxX29htg.js";var Ve=(function(){var s=A(function(I,o,c,d){for(c=c||{},d=I.length;d--;c[I[d]]=o);return c},"o"),i=[1,18],a=[1,19],u=[1,20],l=[1,41],n=[1,42],p=[1,26],f=[1,24],C=[1,25],B=[1,32],L=[1,33],Ae=[1,34],m=[1,45],fe=[1,35],ge=[1,36],Ce=[1,37],me=[1,38],be=[1,27],Ee=[1,28],ye=[1,29],Te=[1,30],ke=[1,31],b=[1,44],E=[1,46],y=[1,43],T=[1,47],De=[1,9],h=[1,8,9],te=[1,58],se=[1,59],ie=[1,60],ae=[1,61],ne=[1,62],Fe=[1,63],Be=[1,64],z=[1,8,9,41],Pe=[1,76],P=[1,8,9,12,13,22,39,41,44,68,69,70,71,72,73,74,79,81],re=[1,8,9,12,13,18,20,22,39,41,44,50,60,68,69,70,71,72,73,74,79,81,86,100,102,103],ue=[13,60,86,100,102,103],K=[13,60,73,74,86,100,102,103],Me=[13,60,68,69,70,71,72,86,100,102,103],_e=[1,100],Y=[1,117],Q=[1,113],W=[1,109],j=[1,115],X=[1,110],q=[1,111],H=[1,112],J=[1,114],Z=[1,116],Re=[22,48,60,61,82,86,87,88,89,90],Se=[1,8,9,39,41,44],le=[1,8,9,22],Ge=[1,145],Ue=[1,8,9,61],N=[1,8,9,22,48,60,61,82,86,87,88,89,90],Ne={trace:A(function(){},"trace"),yy:{},symbols_:{error:2,start:3,mermaidDoc:4,statements:5,graphConfig:6,CLASS_DIAGRAM:7,NEWLINE:8,EOF:9,statement:10,classLabel:11,SQS:12,STR:13,SQE:14,namespaceName:15,alphaNumToken:16,classLiteralName:17,DOT:18,className:19,GENERICTYPE:20,relationStatement:21,LABEL:22,namespaceStatement:23,classStatement:24,memberStatement:25,annotationStatement:26,clickStatement:27,styleStatement:28,cssClassStatement:29,noteStatement:30,classDefStatement:31,direction:32,acc_title:33,acc_title_value:34,acc_descr:35,acc_descr_value:36,acc_descr_multiline_value:37,namespaceIdentifier:38,STRUCT_START:39,classStatements:40,STRUCT_STOP:41,NAMESPACE:42,classIdentifier:43,STYLE_SEPARATOR:44,members:45,CLASS:46,emptyBody:47,SPACE:48,ANNOTATION_START:49,ANNOTATION_END:50,MEMBER:51,SEPARATOR:52,relation:53,NOTE_FOR:54,noteText:55,NOTE:56,CLASSDEF:57,classList:58,stylesOpt:59,ALPHA:60,COMMA:61,direction_tb:62,direction_bt:63,direction_rl:64,direction_lr:65,relationType:66,lineType:67,AGGREGATION:68,EXTENSION:69,COMPOSITION:70,DEPENDENCY:71,LOLLIPOP:72,LINE:73,DOTTED_LINE:74,CALLBACK:75,LINK:76,LINK_TARGET:77,CLICK:78,CALLBACK_NAME:79,CALLBACK_ARGS:80,HREF:81,STYLE:82,CSSCLASS:83,style:84,styleComponent:85,NUM:86,COLON:87,UNIT:88,BRKT:89,PCT:90,commentToken:91,textToken:92,graphCodeTokens:93,textNoTagsToken:94,TAGSTART:95,TAGEND:96,"==":97,"--":98,DEFAULT:99,MINUS:100,keywords:101,UNICODE_TEXT:102,BQUOTE_STR:103,$accept:0,$end:1},terminals_:{2:"error",7:"CLASS_DIAGRAM",8:"NEWLINE",9:"EOF",12:"SQS",13:"STR",14:"SQE",18:"DOT",20:"GENERICTYPE",22:"LABEL",33:"acc_title",34:"acc_title_value",35:"acc_descr",36:"acc_descr_value",37:"acc_descr_multiline_value",39:"STRUCT_START",41:"STRUCT_STOP",42:"NAMESPACE",44:"STYLE_SEPARATOR",46:"CLASS",48:"SPACE",49:"ANNOTATION_START",50:"ANNOTATION_END",51:"MEMBER",52:"SEPARATOR",54:"NOTE_FOR",56:"NOTE",57:"CLASSDEF",60:"ALPHA",61:"COMMA",62:"direction_tb",63:"direction_bt",64:"direction_rl",65:"direction_lr",68:"AGGREGATION",69:"EXTENSION",70:"COMPOSITION",71:"DEPENDENCY",72:"LOLLIPOP",73:"LINE",74:"DOTTED_LINE",75:"CALLBACK",76:"LINK",77:"LINK_TARGET",78:"CLICK",79:"CALLBACK_NAME",80:"CALLBACK_ARGS",81:"HREF",82:"STYLE",83:"CSSCLASS",86:"NUM",87:"COLON",88:"UNIT",89:"BRKT",90:"PCT",93:"graphCodeTokens",95:"TAGSTART",96:"TAGEND",97:"==",98:"--",99:"DEFAULT",100:"MINUS",101:"keywords",102:"UNICODE_TEXT",103:"BQUOTE_STR"},productions_:[0,[3,1],[3,1],[4,1],[6,4],[5,1],[5,2],[5,3],[11,3],[15,1],[15,1],[15,3],[15,2],[19,1],[19,3],[19,1],[19,2],[19,2],[19,2],[10,1],[10,2],[10,1],[10,1],[10,1],[10,1],[10,1],[10,1],[10,1],[10,1],[10,1],[10,1],[10,2],[10,2],[10,1],[23,4],[23,5],[38,2],[40,1],[40,2],[40,3],[24,1],[24,3],[24,4],[24,3],[24,6],[43,2],[43,3],[47,0],[47,2],[47,2],[26,4],[45,1],[45,2],[25,1],[25,2],[25,1],[25,1],[21,3],[21,4],[21,4],[21,5],[30,3],[30,2],[31,3],[58,1],[58,3],[32,1],[32,1],[32,1],[32,1],[53,3],[53,2],[53,2],[53,1],[66,1],[66,1],[66,1],[66,1],[66,1],[67,1],[67,1],[27,3],[27,4],[27,3],[27,4],[27,4],[27,5],[27,3],[27,4],[27,4],[27,5],[27,4],[27,5],[27,5],[27,6],[28,3],[29,3],[59,1],[59,3],[84,1],[84,2],[85,1],[85,1],[85,1],[85,1],[85,1],[85,1],[85,1],[85,1],[85,1],[91,1],[91,1],[92,1],[92,1],[92,1],[92,1],[92,1],[92,1],[92,1],[94,1],[94,1],[94,1],[94,1],[16,1],[16,1],[16,1],[16,1],[17,1],[55,1]],performAction:A(function(o,c,d,r,g,e,$){var t=e.length-1;switch(g){case 8:this.$=e[t-1];break;case 9:case 10:case 13:case 15:this.$=e[t];break;case 11:case 14:this.$=e[t-2]+"."+e[t];break;case 12:case 16:this.$=e[t-1]+e[t];break;case 17:case 18:this.$=e[t-1]+"~"+e[t]+"~";break;case 19:r.addRelation(e[t]);break;case 20:e[t-1].title=r.cleanupLabel(e[t]),r.addRelation(e[t-1]);break;case 31:this.$=e[t].trim(),r.setAccTitle(this.$);break;case 32:case 33:this.$=e[t].trim(),r.setAccDescription(this.$);break;case 34:r.addClassesToNamespace(e[t-3],e[t-1]);break;case 35:r.addClassesToNamespace(e[t-4],e[t-1]);break;case 36:this.$=e[t],r.addNamespace(e[t]);break;case 37:this.$=[e[t]];break;case 38:this.$=[e[t-1]];break;case 39:e[t].unshift(e[t-2]),this.$=e[t];break;case 41:r.setCssClass(e[t-2],e[t]);break;case 42:r.addMembers(e[t-3],e[t-1]);break;case 44:r.setCssClass(e[t-5],e[t-3]),r.addMembers(e[t-5],e[t-1]);break;case 45:this.$=e[t],r.addClass(e[t]);break;case 46:this.$=e[t-1],r.addClass(e[t-1]),r.setClassLabel(e[t-1],e[t]);break;case 50:r.addAnnotation(e[t],e[t-2]);break;case 51:case 64:this.$=[e[t]];break;case 52:e[t].push(e[t-1]),this.$=e[t];break;case 53:break;case 54:r.addMember(e[t-1],r.cleanupLabel(e[t]));break;case 55:break;case 56:break;case 57:this.$={id1:e[t-2],id2:e[t],relation:e[t-1],relationTitle1:"none",relationTitle2:"none"};break;case 58:this.$={id1:e[t-3],id2:e[t],relation:e[t-1],relationTitle1:e[t-2],relationTitle2:"none"};break;case 59:this.$={id1:e[t-3],id2:e[t],relation:e[t-2],relationTitle1:"none",relationTitle2:e[t-1]};break;case 60:this.$={id1:e[t-4],id2:e[t],relation:e[t-2],relationTitle1:e[t-3],relationTitle2:e[t-1]};break;case 61:r.addNote(e[t],e[t-1]);break;case 62:r.addNote(e[t]);break;case 63:this.$=e[t-2],r.defineClass(e[t-1],e[t]);break;case 65:this.$=e[t-2].concat([e[t]]);break;case 66:r.setDirection("TB");break;case 67:r.setDirection("BT");break;case 68:r.setDirection("RL");break;case 69:r.setDirection("LR");break;case 70:this.$={type1:e[t-2],type2:e[t],lineType:e[t-1]};break;case 71:this.$={type1:"none",type2:e[t],lineType:e[t-1]};break;case 72:this.$={type1:e[t-1],type2:"none",lineType:e[t]};break;case 73:this.$={type1:"none",type2:"none",lineType:e[t]};break;case 74:this.$=r.relationType.AGGREGATION;break;case 75:this.$=r.relationType.EXTENSION;break;case 76:this.$=r.relationType.COMPOSITION;break;case 77:this.$=r.relationType.DEPENDENCY;break;case 78:this.$=r.relationType.LOLLIPOP;break;case 79:this.$=r.lineType.LINE;break;case 80:this.$=r.lineType.DOTTED_LINE;break;case 81:case 87:this.$=e[t-2],r.setClickEvent(e[t-1],e[t]);break;case 82:case 88:this.$=e[t-3],r.setClickEvent(e[t-2],e[t-1]),r.setTooltip(e[t-2],e[t]);break;case 83:this.$=e[t-2],r.setLink(e[t-1],e[t]);break;case 84:this.$=e[t-3],r.setLink(e[t-2],e[t-1],e[t]);break;case 85:this.$=e[t-3],r.setLink(e[t-2],e[t-1]),r.setTooltip(e[t-2],e[t]);break;case 86:this.$=e[t-4],r.setLink(e[t-3],e[t-2],e[t]),r.setTooltip(e[t-3],e[t-1]);break;case 89:this.$=e[t-3],r.setClickEvent(e[t-2],e[t-1],e[t]);break;case 90:this.$=e[t-4],r.setClickEvent(e[t-3],e[t-2],e[t-1]),r.setTooltip(e[t-3],e[t]);break;case 91:this.$=e[t-3],r.setLink(e[t-2],e[t]);break;case 92:this.$=e[t-4],r.setLink(e[t-3],e[t-1],e[t]);break;case 93:this.$=e[t-4],r.setLink(e[t-3],e[t-1]),r.setTooltip(e[t-3],e[t]);break;case 94:this.$=e[t-5],r.setLink(e[t-4],e[t-2],e[t]),r.setTooltip(e[t-4],e[t-1]);break;case 95:this.$=e[t-2],r.setCssStyle(e[t-1],e[t]);break;case 96:r.setCssClass(e[t-1],e[t]);break;case 97:this.$=[e[t]];break;case 98:e[t-2].push(e[t]),this.$=e[t-2];break;case 100:this.$=e[t-1]+e[t];break}},"anonymous"),table:[{3:1,4:2,5:3,6:4,7:[1,6],10:5,16:39,17:40,19:21,21:7,23:8,24:9,25:10,26:11,27:12,28:13,29:14,30:15,31:16,32:17,33:i,35:a,37:u,38:22,42:l,43:23,46:n,49:p,51:f,52:C,54:B,56:L,57:Ae,60:m,62:fe,63:ge,64:Ce,65:me,75:be,76:Ee,78:ye,82:Te,83:ke,86:b,100:E,102:y,103:T},{1:[3]},{1:[2,1]},{1:[2,2]},{1:[2,3]},s(De,[2,5],{8:[1,48]}),{8:[1,49]},s(h,[2,19],{22:[1,50]}),s(h,[2,21]),s(h,[2,22]),s(h,[2,23]),s(h,[2,24]),s(h,[2,25]),s(h,[2,26]),s(h,[2,27]),s(h,[2,28]),s(h,[2,29]),s(h,[2,30]),{34:[1,51]},{36:[1,52]},s(h,[2,33]),s(h,[2,53],{53:53,66:56,67:57,13:[1,54],22:[1,55],68:te,69:se,70:ie,71:ae,72:ne,73:Fe,74:Be}),{39:[1,65]},s(z,[2,40],{39:[1,67],44:[1,66]}),s(h,[2,55]),s(h,[2,56]),{16:68,60:m,86:b,100:E,102:y},{16:39,17:40,19:69,60:m,86:b,100:E,102:y,103:T},{16:39,17:40,19:70,60:m,86:b,100:E,102:y,103:T},{16:39,17:40,19:71,60:m,86:b,100:E,102:y,103:T},{60:[1,72]},{13:[1,73]},{16:39,17:40,19:74,60:m,86:b,100:E,102:y,103:T},{13:Pe,55:75},{58:77,60:[1,78]},s(h,[2,66]),s(h,[2,67]),s(h,[2,68]),s(h,[2,69]),s(P,[2,13],{16:39,17:40,19:80,18:[1,79],20:[1,81],60:m,86:b,100:E,102:y,103:T}),s(P,[2,15],{20:[1,82]}),{15:83,16:84,17:85,60:m,86:b,100:E,102:y,103:T},{16:39,17:40,19:86,60:m,86:b,100:E,102:y,103:T},s(re,[2,123]),s(re,[2,124]),s(re,[2,125]),s(re,[2,126]),s([1,8,9,12,13,20,22,39,41,44,68,69,70,71,72,73,74,79,81],[2,127]),s(De,[2,6],{10:5,21:7,23:8,24:9,25:10,26:11,27:12,28:13,29:14,30:15,31:16,32:17,19:21,38:22,43:23,16:39,17:40,5:87,33:i,35:a,37:u,42:l,46:n,49:p,51:f,52:C,54:B,56:L,57:Ae,60:m,62:fe,63:ge,64:Ce,65:me,75:be,76:Ee,78:ye,82:Te,83:ke,86:b,100:E,102:y,103:T}),{5:88,10:5,16:39,17:40,19:21,21:7,23:8,24:9,25:10,26:11,27:12,28:13,29:14,30:15,31:16,32:17,33:i,35:a,37:u,38:22,42:l,43:23,46:n,49:p,51:f,52:C,54:B,56:L,57:Ae,60:m,62:fe,63:ge,64:Ce,65:me,75:be,76:Ee,78:ye,82:Te,83:ke,86:b,100:E,102:y,103:T},s(h,[2,20]),s(h,[2,31]),s(h,[2,32]),{13:[1,90],16:39,17:40,19:89,60:m,86:b,100:E,102:y,103:T},{53:91,66:56,67:57,68:te,69:se,70:ie,71:ae,72:ne,73:Fe,74:Be},s(h,[2,54]),{67:92,73:Fe,74:Be},s(ue,[2,73],{66:93,68:te,69:se,70:ie,71:ae,72:ne}),s(K,[2,74]),s(K,[2,75]),s(K,[2,76]),s(K,[2,77]),s(K,[2,78]),s(Me,[2,79]),s(Me,[2,80]),{8:[1,95],24:96,40:94,43:23,46:n},{16:97,60:m,86:b,100:E,102:y},{41:[1,99],45:98,51:_e},{50:[1,101]},{13:[1,102]},{13:[1,103]},{79:[1,104],81:[1,105]},{22:Y,48:Q,59:106,60:W,82:j,84:107,85:108,86:X,87:q,88:H,89:J,90:Z},{60:[1,118]},{13:Pe,55:119},s(h,[2,62]),s(h,[2,128]),{22:Y,48:Q,59:120,60:W,61:[1,121],82:j,84:107,85:108,86:X,87:q,88:H,89:J,90:Z},s(Re,[2,64]),{16:39,17:40,19:122,60:m,86:b,100:E,102:y,103:T},s(P,[2,16]),s(P,[2,17]),s(P,[2,18]),{39:[2,36]},{15:124,16:84,17:85,18:[1,123],39:[2,9],60:m,86:b,100:E,102:y,103:T},{39:[2,10]},s(Se,[2,45],{11:125,12:[1,126]}),s(De,[2,7]),{9:[1,127]},s(le,[2,57]),{16:39,17:40,19:128,60:m,86:b,100:E,102:y,103:T},{13:[1,130],16:39,17:40,19:129,60:m,86:b,100:E,102:y,103:T},s(ue,[2,72],{66:131,68:te,69:se,70:ie,71:ae,72:ne}),s(ue,[2,71]),{41:[1,132]},{24:96,40:133,43:23,46:n},{8:[1,134],41:[2,37]},s(z,[2,41],{39:[1,135]}),{41:[1,136]},s(z,[2,43]),{41:[2,51],45:137,51:_e},{16:39,17:40,19:138,60:m,86:b,100:E,102:y,103:T},s(h,[2,81],{13:[1,139]}),s(h,[2,83],{13:[1,141],77:[1,140]}),s(h,[2,87],{13:[1,142],80:[1,143]}),{13:[1,144]},s(h,[2,95],{61:Ge}),s(Ue,[2,97],{85:146,22:Y,48:Q,60:W,82:j,86:X,87:q,88:H,89:J,90:Z}),s(N,[2,99]),s(N,[2,101]),s(N,[2,102]),s(N,[2,103]),s(N,[2,104]),s(N,[2,105]),s(N,[2,106]),s(N,[2,107]),s(N,[2,108]),s(N,[2,109]),s(h,[2,96]),s(h,[2,61]),s(h,[2,63],{61:Ge}),{60:[1,147]},s(P,[2,14]),{15:148,16:84,17:85,60:m,86:b,100:E,102:y,103:T},{39:[2,12]},s(Se,[2,46]),{13:[1,149]},{1:[2,4]},s(le,[2,59]),s(le,[2,58]),{16:39,17:40,19:150,60:m,86:b,100:E,102:y,103:T},s(ue,[2,70]),s(h,[2,34]),{41:[1,151]},{24:96,40:152,41:[2,38],43:23,46:n},{45:153,51:_e},s(z,[2,42]),{41:[2,52]},s(h,[2,50]),s(h,[2,82]),s(h,[2,84]),s(h,[2,85],{77:[1,154]}),s(h,[2,88]),s(h,[2,89],{13:[1,155]}),s(h,[2,91],{13:[1,157],77:[1,156]}),{22:Y,48:Q,60:W,82:j,84:158,85:108,86:X,87:q,88:H,89:J,90:Z},s(N,[2,100]),s(Re,[2,65]),{39:[2,11]},{14:[1,159]},s(le,[2,60]),s(h,[2,35]),{41:[2,39]},{41:[1,160]},s(h,[2,86]),s(h,[2,90]),s(h,[2,92]),s(h,[2,93],{77:[1,161]}),s(Ue,[2,98],{85:146,22:Y,48:Q,60:W,82:j,86:X,87:q,88:H,89:J,90:Z}),s(Se,[2,8]),s(z,[2,44]),s(h,[2,94])],defaultActions:{2:[2,1],3:[2,2],4:[2,3],83:[2,36],85:[2,10],124:[2,12],127:[2,4],137:[2,52],148:[2,11],152:[2,39]},parseError:A(function(o,c){if(c.recoverable)this.trace(o);else{var d=new Error(o);throw d.hash=c,d}},"parseError"),parse:A(function(o){var c=this,d=[0],r=[],g=[null],e=[],$=this.table,t="",ce=0,ze=0,He=2,Ke=1,Je=e.slice.call(arguments,1),k=Object.create(this.lexer),O={yy:{}};for(var Le in this.yy)Object.prototype.hasOwnProperty.call(this.yy,Le)&&(O.yy[Le]=this.yy[Le]);k.setInput(o,O.yy),O.yy.lexer=k,O.yy.parser=this,typeof k.yylloc>"u"&&(k.yylloc={});var xe=k.yylloc;e.push(xe);var Ze=k.options&&k.options.ranges;typeof O.yy.parseError=="function"?this.parseError=O.yy.parseError:this.parseError=Object.getPrototypeOf(this).parseError;function $e(_){d.length=d.length-2*_,g.length=g.length-_,e.length=e.length-_}A($e,"popStack");function Ye(){var _;return _=r.pop()||k.lex()||Ke,typeof _!="number"&&(_ instanceof Array&&(r=_,_=r.pop()),_=c.symbols_[_]||_),_}A(Ye,"lex");for(var F,w,S,ve,M={},he,x,Qe,de;;){if(w=d[d.length-1],this.defaultActions[w]?S=this.defaultActions[w]:((F===null||typeof F>"u")&&(F=Ye()),S=$[w]&&$[w][F]),typeof S>"u"||!S.length||!S[0]){var Ie="";de=[];for(he in $[w])this.terminals_[he]&&he>He&&de.push("'"+this.terminals_[he]+"'");k.showPosition?Ie="Parse error on line "+(ce+1)+`:
-`+k.showPosition()+`
-Expecting `+de.join(", ")+", got '"+(this.terminals_[F]||F)+"'":Ie="Parse error on line "+(ce+1)+": Unexpected "+(F==Ke?"end of input":"'"+(this.terminals_[F]||F)+"'"),this.parseError(Ie,{text:k.match,token:this.terminals_[F]||F,line:k.yylineno,loc:xe,expected:de})}if(S[0]instanceof Array&&S.length>1)throw new Error("Parse Error: multiple actions possible at state: "+w+", token: "+F);switch(S[0]){case 1:d.push(F),g.push(k.yytext),e.push(k.yylloc),d.push(S[1]),F=null,ze=k.yyleng,t=k.yytext,ce=k.yylineno,xe=k.yylloc;break;case 2:if(x=this.productions_[S[1]][1],M.$=g[g.length-x],M._$={first_line:e[e.length-(x||1)].first_line,last_line:e[e.length-1].last_line,first_column:e[e.length-(x||1)].first_column,last_column:e[e.length-1].last_column},Ze&&(M._$.range=[e[e.length-(x||1)].range[0],e[e.length-1].range[1]]),ve=this.performAction.apply(M,[t,ze,ce,O.yy,S[1],g,e].concat(Je)),typeof ve<"u")return ve;x&&(d=d.slice(0,-1*x*2),g=g.slice(0,-1*x),e=e.slice(0,-1*x)),d.push(this.productions_[S[1]][0]),g.push(M.$),e.push(M._$),Qe=$[d[d.length-2]][d[d.length-1]],d.push(Qe);break;case 3:return!0}}return!0},"parse")},qe=(function(){var I={EOF:1,parseError:A(function(c,d){if(this.yy.parser)this.yy.parser.parseError(c,d);else throw new Error(c)},"parseError"),setInput:A(function(o,c){return this.yy=c||this.yy||{},this._input=o,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},"setInput"),input:A(function(){var o=this._input[0];this.yytext+=o,this.yyleng++,this.offset++,this.match+=o,this.matched+=o;var c=o.match(/(?:\r\n?|\n).*/g);return c?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),o},"input"),unput:A(function(o){var c=o.length,d=o.split(/(?:\r\n?|\n)/g);this._input=o+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-c),this.offset-=c;var r=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),d.length-1&&(this.yylineno-=d.length-1);var g=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:d?(d.length===r.length?this.yylloc.first_column:0)+r[r.length-d.length].length-d[0].length:this.yylloc.first_column-c},this.options.ranges&&(this.yylloc.range=[g[0],g[0]+this.yyleng-c]),this.yyleng=this.yytext.length,this},"unput"),more:A(function(){return this._more=!0,this},"more"),reject:A(function(){if(this.options.backtrack_lexer)this._backtrack=!0;else return this.parseError("Lexical error on line "+(this.yylineno+1)+`. You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).
-`+this.showPosition(),{text:"",token:null,line:this.yylineno});return this},"reject"),less:A(function(o){this.unput(this.match.slice(o))},"less"),pastInput:A(function(){var o=this.matched.substr(0,this.matched.length-this.match.length);return(o.length>20?"...":"")+o.substr(-20).replace(/\n/g,"")},"pastInput"),upcomingInput:A(function(){var o=this.match;return o.length<20&&(o+=this._input.substr(0,20-o.length)),(o.substr(0,20)+(o.length>20?"...":"")).replace(/\n/g,"")},"upcomingInput"),showPosition:A(function(){var o=this.pastInput(),c=new Array(o.length+1).join("-");return o+this.upcomingInput()+`
-`+c+"^"},"showPosition"),test_match:A(function(o,c){var d,r,g;if(this.options.backtrack_lexer&&(g={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(g.yylloc.range=this.yylloc.range.slice(0))),r=o[0].match(/(?:\r\n?|\n).*/g),r&&(this.yylineno+=r.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:r?r[r.length-1].length-r[r.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+o[0].length},this.yytext+=o[0],this.match+=o[0],this.matches=o,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(o[0].length),this.matched+=o[0],d=this.performAction.call(this,this.yy,this,c,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),d)return d;if(this._backtrack){for(var e in g)this[e]=g[e];return!1}return!1},"test_match"),next:A(function(){if(this.done)return this.EOF;this._input||(this.done=!0);var o,c,d,r;this._more||(this.yytext="",this.match="");for(var g=this._currentRules(),e=0;e<g.length;e++)if(d=this._input.match(this.rules[g[e]]),d&&(!c||d[0].length>c[0].length)){if(c=d,r=e,this.options.backtrack_lexer){if(o=this.test_match(d,g[e]),o!==!1)return o;if(this._backtrack){c=!1;continue}else return!1}else if(!this.options.flex)break}return c?(o=this.test_match(c,g[r]),o!==!1?o:!1):this._input===""?this.EOF:this.parseError("Lexical error on line "+(this.yylineno+1)+`. Unrecognized text.
-`+this.showPosition(),{text:"",token:null,line:this.yylineno})},"next"),lex:A(function(){var c=this.next();return c||this.lex()},"lex"),begin:A(function(c){this.conditionStack.push(c)},"begin"),popState:A(function(){var c=this.conditionStack.length-1;return c>0?this.conditionStack.pop():this.conditionStack[0]},"popState"),_currentRules:A(function(){return this.conditionStack.length&&this.conditionStack[this.conditionStack.length-1]?this.conditions[this.conditionStack[this.conditionStack.length-1]].rules:this.conditions.INITIAL.rules},"_currentRules"),topState:A(function(c){return c=this.conditionStack.length-1-Math.abs(c||0),c>=0?this.conditionStack[c]:"INITIAL"},"topState"),pushState:A(function(c){this.begin(c)},"pushState"),stateStackSize:A(function(){return this.conditionStack.length},"stateStackSize"),options:{},performAction:A(function(c,d,r,g){switch(r){case 0:return 62;case 1:return 63;case 2:return 64;case 3:return 65;case 4:break;case 5:break;case 6:return this.begin("acc_title"),33;case 7:return this.popState(),"acc_title_value";case 8:return this.begin("acc_descr"),35;case 9:return this.popState(),"acc_descr_value";case 10:this.begin("acc_descr_multiline");break;case 11:this.popState();break;case 12:return"acc_descr_multiline_value";case 13:return 8;case 14:break;case 15:return 7;case 16:return 7;case 17:return"EDGE_STATE";case 18:this.begin("callback_name");break;case 19:this.popState();break;case 20:this.popState(),this.begin("callback_args");break;case 21:return 79;case 22:this.popState();break;case 23:return 80;case 24:this.popState();break;case 25:return"STR";case 26:this.begin("string");break;case 27:return 82;case 28:return 57;case 29:return this.begin("namespace"),42;case 30:return this.popState(),8;case 31:break;case 32:return this.begin("namespace-body"),39;case 33:return this.popState(),41;case 34:return"EOF_IN_STRUCT";case 35:return 8;case 36:break;case 37:return"EDGE_STATE";case 38:return this.begin("class"),46;case 39:return this.popState(),8;case 40:break;case 41:return this.popState(),this.popState(),41;case 42:return this.begin("class-body"),39;case 43:return this.popState(),41;case 44:return"EOF_IN_STRUCT";case 45:return"EDGE_STATE";case 46:return"OPEN_IN_STRUCT";case 47:break;case 48:return"MEMBER";case 49:return 83;case 50:return 75;case 51:return 76;case 52:return 78;case 53:return 54;case 54:return 56;case 55:return 49;case 56:return 50;case 57:return 81;case 58:this.popState();break;case 59:return"GENERICTYPE";case 60:this.begin("generic");break;case 61:this.popState();break;case 62:return"BQUOTE_STR";case 63:this.begin("bqstring");break;case 64:return 77;case 65:return 77;case 66:return 77;case 67:return 77;case 68:return 69;case 69:return 69;case 70:return 71;case 71:return 71;case 72:return 70;case 73:return 68;case 74:return 72;case 75:return 73;case 76:return 74;case 77:return 22;case 78:return 44;case 79:return 100;case 80:return 18;case 81:return"PLUS";case 82:return 87;case 83:return 61;case 84:return 89;case 85:return 89;case 86:return 90;case 87:return"EQUALS";case 88:return"EQUALS";case 89:return 60;case 90:return 12;case 91:return 14;case 92:return"PUNCTUATION";case 93:return 86;case 94:return 102;case 95:return 48;case 96:return 48;case 97:return 9}},"anonymous"),rules:[/^(?:.*direction\s+TB[^\n]*)/,/^(?:.*direction\s+BT[^\n]*)/,/^(?:.*direction\s+RL[^\n]*)/,/^(?:.*direction\s+LR[^\n]*)/,/^(?:%%(?!\{)*[^\n]*(\r?\n?)+)/,/^(?:%%[^\n]*(\r?\n)*)/,/^(?:accTitle\s*:\s*)/,/^(?:(?!\n||)*[^\n]*)/,/^(?:accDescr\s*:\s*)/,/^(?:(?!\n||)*[^\n]*)/,/^(?:accDescr\s*\{\s*)/,/^(?:[\}])/,/^(?:[^\}]*)/,/^(?:\s*(\r?\n)+)/,/^(?:\s+)/,/^(?:classDiagram-v2\b)/,/^(?:classDiagram\b)/,/^(?:\[\*\])/,/^(?:call[\s]+)/,/^(?:\([\s]*\))/,/^(?:\()/,/^(?:[^(]*)/,/^(?:\))/,/^(?:[^)]*)/,/^(?:["])/,/^(?:[^"]*)/,/^(?:["])/,/^(?:style\b)/,/^(?:classDef\b)/,/^(?:namespace\b)/,/^(?:\s*(\r?\n)+)/,/^(?:\s+)/,/^(?:[{])/,/^(?:[}])/,/^(?:$)/,/^(?:\s*(\r?\n)+)/,/^(?:\s+)/,/^(?:\[\*\])/,/^(?:class\b)/,/^(?:\s*(\r?\n)+)/,/^(?:\s+)/,/^(?:[}])/,/^(?:[{])/,/^(?:[}])/,/^(?:$)/,/^(?:\[\*\])/,/^(?:[{])/,/^(?:[\n])/,/^(?:[^{}\n]*)/,/^(?:cssClass\b)/,/^(?:callback\b)/,/^(?:link\b)/,/^(?:click\b)/,/^(?:note for\b)/,/^(?:note\b)/,/^(?:<<)/,/^(?:>>)/,/^(?:href\b)/,/^(?:[~])/,/^(?:[^~]*)/,/^(?:~)/,/^(?:[`])/,/^(?:[^`]+)/,/^(?:[`])/,/^(?:_self\b)/,/^(?:_blank\b)/,/^(?:_parent\b)/,/^(?:_top\b)/,/^(?:\s*<\|)/,/^(?:\s*\|>)/,/^(?:\s*>)/,/^(?:\s*<)/,/^(?:\s*\*)/,/^(?:\s*o\b)/,/^(?:\s*\(\))/,/^(?:--)/,/^(?:\.\.)/,/^(?::{1}[^:\n;]+)/,/^(?::{3})/,/^(?:-)/,/^(?:\.)/,/^(?:\+)/,/^(?::)/,/^(?:,)/,/^(?:#)/,/^(?:#)/,/^(?:%)/,/^(?:=)/,/^(?:=)/,/^(?:\w+)/,/^(?:\[)/,/^(?:\])/,/^(?:[!"#$%&'*+,-.`?\\/])/,/^(?:[0-9]+)/,/^(?:[\u00AA\u00B5\u00BA\u00C0-\u00D6\u00D8-\u00F6]|[\u00F8-\u02C1\u02C6-\u02D1\u02E0-\u02E4\u02EC\u02EE\u0370-\u0374\u0376\u0377]|[\u037A-\u037D\u0386\u0388-\u038A\u038C\u038E-\u03A1\u03A3-\u03F5]|[\u03F7-\u0481\u048A-\u0527\u0531-\u0556\u0559\u0561-\u0587\u05D0-\u05EA]|[\u05F0-\u05F2\u0620-\u064A\u066E\u066F\u0671-\u06D3\u06D5\u06E5\u06E6\u06EE]|[\u06EF\u06FA-\u06FC\u06FF\u0710\u0712-\u072F\u074D-\u07A5\u07B1\u07CA-\u07EA]|[\u07F4\u07F5\u07FA\u0800-\u0815\u081A\u0824\u0828\u0840-\u0858\u08A0]|[\u08A2-\u08AC\u0904-\u0939\u093D\u0950\u0958-\u0961\u0971-\u0977]|[\u0979-\u097F\u0985-\u098C\u098F\u0990\u0993-\u09A8\u09AA-\u09B0\u09B2]|[\u09B6-\u09B9\u09BD\u09CE\u09DC\u09DD\u09DF-\u09E1\u09F0\u09F1\u0A05-\u0A0A]|[\u0A0F\u0A10\u0A13-\u0A28\u0A2A-\u0A30\u0A32\u0A33\u0A35\u0A36\u0A38\u0A39]|[\u0A59-\u0A5C\u0A5E\u0A72-\u0A74\u0A85-\u0A8D\u0A8F-\u0A91\u0A93-\u0AA8]|[\u0AAA-\u0AB0\u0AB2\u0AB3\u0AB5-\u0AB9\u0ABD\u0AD0\u0AE0\u0AE1\u0B05-\u0B0C]|[\u0B0F\u0B10\u0B13-\u0B28\u0B2A-\u0B30\u0B32\u0B33\u0B35-\u0B39\u0B3D\u0B5C]|[\u0B5D\u0B5F-\u0B61\u0B71\u0B83\u0B85-\u0B8A\u0B8E-\u0B90\u0B92-\u0B95\u0B99]|[\u0B9A\u0B9C\u0B9E\u0B9F\u0BA3\u0BA4\u0BA8-\u0BAA\u0BAE-\u0BB9\u0BD0]|[\u0C05-\u0C0C\u0C0E-\u0C10\u0C12-\u0C28\u0C2A-\u0C33\u0C35-\u0C39\u0C3D]|[\u0C58\u0C59\u0C60\u0C61\u0C85-\u0C8C\u0C8E-\u0C90\u0C92-\u0CA8\u0CAA-\u0CB3]|[\u0CB5-\u0CB9\u0CBD\u0CDE\u0CE0\u0CE1\u0CF1\u0CF2\u0D05-\u0D0C\u0D0E-\u0D10]|[\u0D12-\u0D3A\u0D3D\u0D4E\u0D60\u0D61\u0D7A-\u0D7F\u0D85-\u0D96\u0D9A-\u0DB1]|[\u0DB3-\u0DBB\u0DBD\u0DC0-\u0DC6\u0E01-\u0E30\u0E32\u0E33\u0E40-\u0E46\u0E81]|[\u0E82\u0E84\u0E87\u0E88\u0E8A\u0E8D\u0E94-\u0E97\u0E99-\u0E9F\u0EA1-\u0EA3]|[\u0EA5\u0EA7\u0EAA\u0EAB\u0EAD-\u0EB0\u0EB2\u0EB3\u0EBD\u0EC0-\u0EC4\u0EC6]|[\u0EDC-\u0EDF\u0F00\u0F40-\u0F47\u0F49-\u0F6C\u0F88-\u0F8C\u1000-\u102A]|[\u103F\u1050-\u1055\u105A-\u105D\u1061\u1065\u1066\u106E-\u1070\u1075-\u1081]|[\u108E\u10A0-\u10C5\u10C7\u10CD\u10D0-\u10FA\u10FC-\u1248\u124A-\u124D]|[\u1250-\u1256\u1258\u125A-\u125D\u1260-\u1288\u128A-\u128D\u1290-\u12B0]|[\u12B2-\u12B5\u12B8-\u12BE\u12C0\u12C2-\u12C5\u12C8-\u12D6\u12D8-\u1310]|[\u1312-\u1315\u1318-\u135A\u1380-\u138F\u13A0-\u13F4\u1401-\u166C]|[\u166F-\u167F\u1681-\u169A\u16A0-\u16EA\u1700-\u170C\u170E-\u1711]|[\u1720-\u1731\u1740-\u1751\u1760-\u176C\u176E-\u1770\u1780-\u17B3\u17D7]|[\u17DC\u1820-\u1877\u1880-\u18A8\u18AA\u18B0-\u18F5\u1900-\u191C]|[\u1950-\u196D\u1970-\u1974\u1980-\u19AB\u19C1-\u19C7\u1A00-\u1A16]|[\u1A20-\u1A54\u1AA7\u1B05-\u1B33\u1B45-\u1B4B\u1B83-\u1BA0\u1BAE\u1BAF]|[\u1BBA-\u1BE5\u1C00-\u1C23\u1C4D-\u1C4F\u1C5A-\u1C7D\u1CE9-\u1CEC]|[\u1CEE-\u1CF1\u1CF5\u1CF6\u1D00-\u1DBF\u1E00-\u1F15\u1F18-\u1F1D]|[\u1F20-\u1F45\u1F48-\u1F4D\u1F50-\u1F57\u1F59\u1F5B\u1F5D\u1F5F-\u1F7D]|[\u1F80-\u1FB4\u1FB6-\u1FBC\u1FBE\u1FC2-\u1FC4\u1FC6-\u1FCC\u1FD0-\u1FD3]|[\u1FD6-\u1FDB\u1FE0-\u1FEC\u1FF2-\u1FF4\u1FF6-\u1FFC\u2071\u207F]|[\u2090-\u209C\u2102\u2107\u210A-\u2113\u2115\u2119-\u211D\u2124\u2126\u2128]|[\u212A-\u212D\u212F-\u2139\u213C-\u213F\u2145-\u2149\u214E\u2183\u2184]|[\u2C00-\u2C2E\u2C30-\u2C5E\u2C60-\u2CE4\u2CEB-\u2CEE\u2CF2\u2CF3]|[\u2D00-\u2D25\u2D27\u2D2D\u2D30-\u2D67\u2D6F\u2D80-\u2D96\u2DA0-\u2DA6]|[\u2DA8-\u2DAE\u2DB0-\u2DB6\u2DB8-\u2DBE\u2DC0-\u2DC6\u2DC8-\u2DCE]|[\u2DD0-\u2DD6\u2DD8-\u2DDE\u2E2F\u3005\u3006\u3031-\u3035\u303B\u303C]|[\u3041-\u3096\u309D-\u309F\u30A1-\u30FA\u30FC-\u30FF\u3105-\u312D]|[\u3131-\u318E\u31A0-\u31BA\u31F0-\u31FF\u3400-\u4DB5\u4E00-\u9FCC]|[\uA000-\uA48C\uA4D0-\uA4FD\uA500-\uA60C\uA610-\uA61F\uA62A\uA62B]|[\uA640-\uA66E\uA67F-\uA697\uA6A0-\uA6E5\uA717-\uA71F\uA722-\uA788]|[\uA78B-\uA78E\uA790-\uA793\uA7A0-\uA7AA\uA7F8-\uA801\uA803-\uA805]|[\uA807-\uA80A\uA80C-\uA822\uA840-\uA873\uA882-\uA8B3\uA8F2-\uA8F7\uA8FB]|[\uA90A-\uA925\uA930-\uA946\uA960-\uA97C\uA984-\uA9B2\uA9CF\uAA00-\uAA28]|[\uAA40-\uAA42\uAA44-\uAA4B\uAA60-\uAA76\uAA7A\uAA80-\uAAAF\uAAB1\uAAB5]|[\uAAB6\uAAB9-\uAABD\uAAC0\uAAC2\uAADB-\uAADD\uAAE0-\uAAEA\uAAF2-\uAAF4]|[\uAB01-\uAB06\uAB09-\uAB0E\uAB11-\uAB16\uAB20-\uAB26\uAB28-\uAB2E]|[\uABC0-\uABE2\uAC00-\uD7A3\uD7B0-\uD7C6\uD7CB-\uD7FB\uF900-\uFA6D]|[\uFA70-\uFAD9\uFB00-\uFB06\uFB13-\uFB17\uFB1D\uFB1F-\uFB28\uFB2A-\uFB36]|[\uFB38-\uFB3C\uFB3E\uFB40\uFB41\uFB43\uFB44\uFB46-\uFBB1\uFBD3-\uFD3D]|[\uFD50-\uFD8F\uFD92-\uFDC7\uFDF0-\uFDFB\uFE70-\uFE74\uFE76-\uFEFC]|[\uFF21-\uFF3A\uFF41-\uFF5A\uFF66-\uFFBE\uFFC2-\uFFC7\uFFCA-\uFFCF]|[\uFFD2-\uFFD7\uFFDA-\uFFDC])/,/^(?:\s)/,/^(?:\s)/,/^(?:$)/],conditions:{"namespace-body":{rules:[26,33,34,35,36,37,38,49,50,51,52,53,54,55,56,57,60,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,86,87,88,89,90,91,92,93,94,95,97],inclusive:!1},namespace:{rules:[26,29,30,31,32,49,50,51,52,53,54,55,56,57,60,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,86,87,88,89,90,91,92,93,94,95,97],inclusive:!1},"class-body":{rules:[26,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,60,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,86,87,88,89,90,91,92,93,94,95,97],inclusive:!1},class:{rules:[26,39,40,41,42,49,50,51,52,53,54,55,56,57,60,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,86,87,88,89,90,91,92,93,94,95,97],inclusive:!1},acc_descr_multiline:{rules:[11,12,26,49,50,51,52,53,54,55,56,57,60,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,86,87,88,89,90,91,92,93,94,95,97],inclusive:!1},acc_descr:{rules:[9,26,49,50,51,52,53,54,55,56,57,60,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,86,87,88,89,90,91,92,93,94,95,97],inclusive:!1},acc_title:{rules:[7,26,49,50,51,52,53,54,55,56,57,60,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,86,87,88,89,90,91,92,93,94,95,97],inclusive:!1},callback_args:{rules:[22,23,26,49,50,51,52,53,54,55,56,57,60,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,86,87,88,89,90,91,92,93,94,95,97],inclusive:!1},callback_name:{rules:[19,20,21,26,49,50,51,52,53,54,55,56,57,60,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,86,87,88,89,90,91,92,93,94,95,97],inclusive:!1},href:{rules:[26,49,50,51,52,53,54,55,56,57,60,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,86,87,88,89,90,91,92,93,94,95,97],inclusive:!1},struct:{rules:[26,49,50,51,52,53,54,55,56,57,60,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,86,87,88,89,90,91,92,93,94,95,97],inclusive:!1},generic:{rules:[26,49,50,51,52,53,54,55,56,57,58,59,60,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,86,87,88,89,90,91,92,93,94,95,97],inclusive:!1},bqstring:{rules:[26,49,50,51,52,53,54,55,56,57,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,86,87,88,89,90,91,92,93,94,95,97],inclusive:!1},string:{rules:[24,25,26,49,50,51,52,53,54,55,56,57,60,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,86,87,88,89,90,91,92,93,94,95,97],inclusive:!1},INITIAL:{rules:[0,1,2,3,4,5,6,8,10,13,14,15,16,17,18,26,27,28,29,38,49,50,51,52,53,54,55,56,57,60,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97],inclusive:!0}}};return I})();Ne.lexer=qe;function oe(){this.yy={}}return A(oe,"Parser"),oe.prototype=Ne,Ne.Parser=oe,new oe})();Ve.parser=Ve;var Tt=Ve,We=["#","+","~","-",""],G,je=(G=class{constructor(i,a){this.memberType=a,this.visibility="",this.classifier="",this.text="";const u=pt(i,D());this.parseMember(u)}getDisplayDetails(){let i=this.visibility+R(this.id);this.memberType==="method"&&(i+=`(${R(this.parameters.trim())})`,this.returnType&&(i+=" : "+R(this.returnType))),i=i.trim();const a=this.parseClassifier();return{displayText:i,cssStyle:a}}parseMember(i){let a="";if(this.memberType==="method"){const n=/([#+~-])?(.+)\((.*)\)([\s$*])?(.*)([$*])?/.exec(i);if(n){const p=n[1]?n[1].trim():"";if(We.includes(p)&&(this.visibility=p),this.id=n[2],this.parameters=n[3]?n[3].trim():"",a=n[4]?n[4].trim():"",this.returnType=n[5]?n[5].trim():"",a===""){const f=this.returnType.substring(this.returnType.length-1);/[$*]/.exec(f)&&(a=f,this.returnType=this.returnType.substring(0,this.returnType.length-1))}}}else{const l=i.length,n=i.substring(0,1),p=i.substring(l-1);We.includes(n)&&(this.visibility=n),/[$*]/.exec(p)&&(a=p),this.id=i.substring(this.visibility===""?0:1,a===""?l:l-1)}this.classifier=a,this.id=this.id.startsWith(" ")?" "+this.id.trim():this.id.trim();const u=`${this.visibility?"\\"+this.visibility:""}${R(this.id)}${this.memberType==="method"?`(${R(this.parameters)})${this.returnType?" : "+R(this.returnType):""}`:""}`;this.text=u.replaceAll("<","&lt;").replaceAll(">","&gt;"),this.text.startsWith("\\&lt;")&&(this.text=this.text.replace("\\&lt;","~"))}parseClassifier(){switch(this.classifier){case"*":return"font-style:italic;";case"$":return"text-decoration:underline;";default:return""}}},A(G,"ClassMember"),G),pe="classId-",Xe=0,V=A(s=>v.sanitizeText(s,D()),"sanitizeText"),U,kt=(U=class{constructor(){this.relations=[],this.classes=new Map,this.styleClasses=new Map,this.notes=[],this.interfaces=[],this.namespaces=new Map,this.namespaceCounter=0,this.functions=[],this.lineType={LINE:0,DOTTED_LINE:1},this.relationType={AGGREGATION:0,EXTENSION:1,COMPOSITION:2,DEPENDENCY:3,LOLLIPOP:4},this.setupToolTips=A(i=>{let a=ee(".mermaidTooltip");(a._groups||a)[0][0]===null&&(a=ee("body").append("div").attr("class","mermaidTooltip").style("opacity",0)),ee(i).select("svg").selectAll("g.node").on("mouseover",n=>{const p=ee(n.currentTarget);if(p.attr("title")===null)return;const C=this.getBoundingClientRect();a.transition().duration(200).style("opacity",".9"),a.text(p.attr("title")).style("left",window.scrollX+C.left+(C.right-C.left)/2+"px").style("top",window.scrollY+C.top-14+document.body.scrollTop+"px"),a.html(a.html().replace(/&lt;br\/&gt;/g,"<br/>")),p.classed("hover",!0)}).on("mouseout",n=>{a.transition().duration(500).style("opacity",0),ee(n.currentTarget).classed("hover",!1)})},"setupToolTips"),this.direction="TB",this.setAccTitle=nt,this.getAccTitle=rt,this.setAccDescription=ut,this.getAccDescription=lt,this.setDiagramTitle=ot,this.getDiagramTitle=ct,this.getConfig=A(()=>D().class,"getConfig"),this.functions.push(this.setupToolTips.bind(this)),this.clear(),this.addRelation=this.addRelation.bind(this),this.addClassesToNamespace=this.addClassesToNamespace.bind(this),this.addNamespace=this.addNamespace.bind(this),this.setCssClass=this.setCssClass.bind(this),this.addMembers=this.addMembers.bind(this),this.addClass=this.addClass.bind(this),this.setClassLabel=this.setClassLabel.bind(this),this.addAnnotation=this.addAnnotation.bind(this),this.addMember=this.addMember.bind(this),this.cleanupLabel=this.cleanupLabel.bind(this),this.addNote=this.addNote.bind(this),this.defineClass=this.defineClass.bind(this),this.setDirection=this.setDirection.bind(this),this.setLink=this.setLink.bind(this),this.bindFunctions=this.bindFunctions.bind(this),this.clear=this.clear.bind(this),this.setTooltip=this.setTooltip.bind(this),this.setClickEvent=this.setClickEvent.bind(this),this.setCssStyle=this.setCssStyle.bind(this)}splitClassNameAndType(i){const a=v.sanitizeText(i,D());let u="",l=a;if(a.indexOf("~")>0){const n=a.split("~");l=V(n[0]),u=V(n[1])}return{className:l,type:u}}setClassLabel(i,a){const u=v.sanitizeText(i,D());a&&(a=V(a));const{className:l}=this.splitClassNameAndType(u);this.classes.get(l).label=a,this.classes.get(l).text=`${a}${this.classes.get(l).type?`<${this.classes.get(l).type}>`:""}`}addClass(i){const a=v.sanitizeText(i,D()),{className:u,type:l}=this.splitClassNameAndType(a);if(this.classes.has(u))return;const n=v.sanitizeText(u,D());this.classes.set(n,{id:n,type:l,label:n,text:`${n}${l?`&lt;${l}&gt;`:""}`,shape:"classBox",cssClasses:"default",methods:[],members:[],annotations:[],styles:[],domId:pe+n+"-"+Xe}),Xe++}addInterface(i,a){const u={id:`interface${this.interfaces.length}`,label:i,classId:a};this.interfaces.push(u)}lookUpDomId(i){const a=v.sanitizeText(i,D());if(this.classes.has(a))return this.classes.get(a).domId;throw new Error("Class not found: "+a)}clear(){this.relations=[],this.classes=new Map,this.notes=[],this.interfaces=[],this.functions=[],this.functions.push(this.setupToolTips.bind(this)),this.namespaces=new Map,this.namespaceCounter=0,this.direction="TB",ht()}getClass(i){return this.classes.get(i)}getClasses(){return this.classes}getRelations(){return this.relations}getNotes(){return this.notes}addRelation(i){Oe.debug("Adding relation: "+JSON.stringify(i));const a=[this.relationType.LOLLIPOP,this.relationType.AGGREGATION,this.relationType.COMPOSITION,this.relationType.DEPENDENCY,this.relationType.EXTENSION];i.relation.type1===this.relationType.LOLLIPOP&&!a.includes(i.relation.type2)?(this.addClass(i.id2),this.addInterface(i.id1,i.id2),i.id1=`interface${this.interfaces.length-1}`):i.relation.type2===this.relationType.LOLLIPOP&&!a.includes(i.relation.type1)?(this.addClass(i.id1),this.addInterface(i.id2,i.id1),i.id2=`interface${this.interfaces.length-1}`):(this.addClass(i.id1),this.addClass(i.id2)),i.id1=this.splitClassNameAndType(i.id1).className,i.id2=this.splitClassNameAndType(i.id2).className,i.relationTitle1=v.sanitizeText(i.relationTitle1.trim(),D()),i.relationTitle2=v.sanitizeText(i.relationTitle2.trim(),D()),this.relations.push(i)}addAnnotation(i,a){const u=this.splitClassNameAndType(i).className;this.classes.get(u).annotations.push(a)}addMember(i,a){this.addClass(i);const u=this.splitClassNameAndType(i).className,l=this.classes.get(u);if(typeof a=="string"){const n=a.trim();n.startsWith("<<")&&n.endsWith(">>")?l.annotations.push(V(n.substring(2,n.length-2))):n.indexOf(")")>0?l.methods.push(new je(n,"method")):n&&l.members.push(new je(n,"attribute"))}}addMembers(i,a){Array.isArray(a)&&(a.reverse(),a.forEach(u=>this.addMember(i,u)))}addNote(i,a){const u={id:`note${this.notes.length}`,class:a,text:i};this.notes.push(u)}cleanupLabel(i){return i.startsWith(":")&&(i=i.substring(1)),V(i.trim())}setCssClass(i,a){i.split(",").forEach(u=>{let l=u;/\d/.exec(u[0])&&(l=pe+l);const n=this.classes.get(l);n&&(n.cssClasses+=" "+a)})}defineClass(i,a){for(const u of i){let l=this.styleClasses.get(u);l===void 0&&(l={id:u,styles:[],textStyles:[]},this.styleClasses.set(u,l)),a&&a.forEach(n=>{if(/color/.exec(n)){const p=n.replace("fill","bgFill");l.textStyles.push(p)}l.styles.push(n)}),this.classes.forEach(n=>{n.cssClasses.includes(u)&&n.styles.push(...a.flatMap(p=>p.split(",")))})}}setTooltip(i,a){i.split(",").forEach(u=>{a!==void 0&&(this.classes.get(u).tooltip=V(a))})}getTooltip(i,a){return a&&this.namespaces.has(a)?this.namespaces.get(a).classes.get(i).tooltip:this.classes.get(i).tooltip}setLink(i,a,u){const l=D();i.split(",").forEach(n=>{let p=n;/\d/.exec(n[0])&&(p=pe+p);const f=this.classes.get(p);f&&(f.link=we.formatUrl(a,l),l.securityLevel==="sandbox"?f.linkTarget="_top":typeof u=="string"?f.linkTarget=V(u):f.linkTarget="_blank")}),this.setCssClass(i,"clickable")}setClickEvent(i,a,u){i.split(",").forEach(l=>{this.setClickFunc(l,a,u),this.classes.get(l).haveCallback=!0}),this.setCssClass(i,"clickable")}setClickFunc(i,a,u){const l=v.sanitizeText(i,D());if(D().securityLevel!=="loose"||a===void 0)return;const p=l;if(this.classes.has(p)){const f=this.lookUpDomId(p);let C=[];if(typeof u=="string"){C=u.split(/,(?=(?:(?:[^"]*"){2})*[^"]*$)/);for(let B=0;B<C.length;B++){let L=C[B].trim();L.startsWith('"')&&L.endsWith('"')&&(L=L.substr(1,L.length-2)),C[B]=L}}C.length===0&&C.push(f),this.functions.push(()=>{const B=document.querySelector(`[id="${f}"]`);B!==null&&B.addEventListener("click",()=>{we.runFunc(a,...C)},!1)})}}bindFunctions(i){this.functions.forEach(a=>{a(i)})}getDirection(){return this.direction}setDirection(i){this.direction=i}addNamespace(i){this.namespaces.has(i)||(this.namespaces.set(i,{id:i,classes:new Map,children:{},domId:pe+i+"-"+this.namespaceCounter}),this.namespaceCounter++)}getNamespace(i){return this.namespaces.get(i)}getNamespaces(){return this.namespaces}addClassesToNamespace(i,a){if(this.namespaces.has(i))for(const u of a){const{className:l}=this.splitClassNameAndType(u);this.classes.get(l).parent=i,this.namespaces.get(i).classes.set(l,this.classes.get(l))}}setCssStyle(i,a){const u=this.classes.get(i);if(!(!a||!u))for(const l of a)l.includes(",")?u.styles.push(...l.split(",")):u.styles.push(l)}getArrowMarker(i){let a;switch(i){case 0:a="aggregation";break;case 1:a="extension";break;case 2:a="composition";break;case 3:a="dependency";break;case 4:a="lollipop";break;default:a="none"}return a}getData(){const i=[],a=[],u=D();for(const n of this.namespaces.keys()){const p=this.namespaces.get(n);if(p){const f={id:p.id,label:p.id,isGroup:!0,padding:u.class.padding??16,shape:"rect",cssStyles:["fill: none","stroke: black"],look:u.look};i.push(f)}}for(const n of this.classes.keys()){const p=this.classes.get(n);if(p){const f=p;f.parentId=p.parent,f.look=u.look,i.push(f)}}let l=0;for(const n of this.notes){l++;const p={id:n.id,label:n.text,isGroup:!1,shape:"note",padding:u.class.padding??6,cssStyles:["text-align: left","white-space: nowrap",`fill: ${u.themeVariables.noteBkgColor}`,`stroke: ${u.themeVariables.noteBorderColor}`],look:u.look};i.push(p);const f=this.classes.get(n.class)?.id??"";if(f){const C={id:`edgeNote${l}`,start:n.id,end:f,type:"normal",thickness:"normal",classes:"relation",arrowTypeStart:"none",arrowTypeEnd:"none",arrowheadStyle:"",labelStyle:[""],style:["fill: none"],pattern:"dotted",look:u.look};a.push(C)}}for(const n of this.interfaces){const p={id:n.id,label:n.label,isGroup:!1,shape:"rect",cssStyles:["opacity: 0;"],look:u.look};i.push(p)}l=0;for(const n of this.relations){l++;const p={id:dt(n.id1,n.id2,{prefix:"id",counter:l}),start:n.id1,end:n.id2,type:"normal",label:n.title,labelpos:"c",thickness:"normal",classes:"relation",arrowTypeStart:this.getArrowMarker(n.relation.type1),arrowTypeEnd:this.getArrowMarker(n.relation.type2),startLabelRight:n.relationTitle1==="none"?"":n.relationTitle1,endLabelLeft:n.relationTitle2==="none"?"":n.relationTitle2,arrowheadStyle:"",labelStyle:["display: inline-block"],style:n.style||"",pattern:n.relation.lineType==1?"dashed":"solid",look:u.look};a.push(p)}return{nodes:i,edges:a,other:{},config:u,direction:this.getDirection()}}},A(U,"ClassDB"),U),At=A(s=>`g.classGroup text {
-  fill: ${s.nodeBorder||s.classText};
-  stroke: none;
-  font-family: ${s.fontFamily};
-  font-size: 10px;
-
-  .title {
-    font-weight: bolder;
-  }
-
-}
-
-.nodeLabel, .edgeLabel {
-  color: ${s.classText};
-}
-.edgeLabel .label rect {
-  fill: ${s.mainBkg};
-}
-.label text {
-  fill: ${s.classText};
-}
-
-.labelBkg {
-  background: ${s.mainBkg};
-}
-.edgeLabel .label span {
-  background: ${s.mainBkg};
-}
-
-.classTitle {
-  font-weight: bolder;
-}
-.node rect,
-  .node circle,
-  .node ellipse,
-  .node polygon,
-  .node path {
-    fill: ${s.mainBkg};
-    stroke: ${s.nodeBorder};
-    stroke-width: 1px;
-  }
-
-
-.divider {
-  stroke: ${s.nodeBorder};
-  stroke-width: 1;
-}
-
-g.clickable {
-  cursor: pointer;
-}
-
-g.classGroup rect {
-  fill: ${s.mainBkg};
-  stroke: ${s.nodeBorder};
-}
-
-g.classGroup line {
-  stroke: ${s.nodeBorder};
-  stroke-width: 1;
-}
-
-.classLabel .box {
-  stroke: none;
-  stroke-width: 0;
-  fill: ${s.mainBkg};
-  opacity: 0.5;
-}
-
-.classLabel .label {
-  fill: ${s.nodeBorder};
-  font-size: 10px;
-}
-
-.relation {
-  stroke: ${s.lineColor};
-  stroke-width: 1;
-  fill: none;
-}
-
-.dashed-line{
-  stroke-dasharray: 3;
-}
-
-.dotted-line{
-  stroke-dasharray: 1 2;
-}
-
-#compositionStart, .composition {
-  fill: ${s.lineColor} !important;
-  stroke: ${s.lineColor} !important;
-  stroke-width: 1;
-}
-
-#compositionEnd, .composition {
-  fill: ${s.lineColor} !important;
-  stroke: ${s.lineColor} !important;
-  stroke-width: 1;
-}
-
-#dependencyStart, .dependency {
-  fill: ${s.lineColor} !important;
-  stroke: ${s.lineColor} !important;
-  stroke-width: 1;
-}
-
-#dependencyStart, .dependency {
-  fill: ${s.lineColor} !important;
-  stroke: ${s.lineColor} !important;
-  stroke-width: 1;
-}
-
-#extensionStart, .extension {
-  fill: transparent !important;
-  stroke: ${s.lineColor} !important;
-  stroke-width: 1;
-}
-
-#extensionEnd, .extension {
-  fill: transparent !important;
-  stroke: ${s.lineColor} !important;
-  stroke-width: 1;
-}
-
-#aggregationStart, .aggregation {
-  fill: transparent !important;
-  stroke: ${s.lineColor} !important;
-  stroke-width: 1;
-}
-
-#aggregationEnd, .aggregation {
-  fill: transparent !important;
-  stroke: ${s.lineColor} !important;
-  stroke-width: 1;
-}
-
-#lollipopStart, .lollipop {
-  fill: ${s.mainBkg} !important;
-  stroke: ${s.lineColor} !important;
-  stroke-width: 1;
-}
-
-#lollipopEnd, .lollipop {
-  fill: ${s.mainBkg} !important;
-  stroke: ${s.lineColor} !important;
-  stroke-width: 1;
-}
-
-.edgeTerminals {
-  font-size: 11px;
-  line-height: initial;
-}
-
-.classTitleText {
-  text-anchor: middle;
-  font-size: 18px;
-  fill: ${s.textColor};
-}
-  ${et()}
-`,"getStyles"),Dt=At,ft=A((s,i="TB")=>{if(!s.doc)return i;let a=i;for(const u of s.doc)u.stmt==="dir"&&(a=u.value);return a},"getDir"),gt=A(function(s,i){return i.db.getClasses()},"getClasses"),Ct=A(async function(s,i,a,u){Oe.info("REF0:"),Oe.info("Drawing class diagram (v3)",i);const{securityLevel:l,state:n,layout:p}=D(),f=u.db.getData(),C=tt(i,l);f.type=u.type,f.layoutAlgorithm=it(p),f.nodeSpacing=n?.nodeSpacing||50,f.rankSpacing=n?.rankSpacing||50,f.markers=["aggregation","extension","composition","dependency","lollipop"],f.diagramId=i,await at(f,C);const B=8;we.insertTitle(C,"classDiagramTitleText",n?.titleTopMargin??25,u.db.getDiagramTitle()),st(C,B,"classDiagram",n?.useMaxWidth??!0)},"draw"),Ft={getClasses:gt,draw:Ct,getDir:ft};export{kt as C,Tt as a,Ft as c,Dt as s};
diff --git a/docs/dist/assets/chunk-DI55MBZ5-BODS175X.js b/docs/dist/assets/chunk-DI55MBZ5-BODS175X.js
deleted file mode 100644
index 933d60e9..00000000
--- a/docs/dist/assets/chunk-DI55MBZ5-BODS175X.js
+++ /dev/null
@@ -1,220 +0,0 @@
-import{g as te}from"./chunk-55IACEB6-BE1gdz1f.js";import{s as ee}from"./chunk-QN33PNHL-1s4FuBGd.js";import{_ as u,l as b,c as w,r as se,u as ie,a as re,b as ae,g as ne,s as oe,p as le,q as ce,T as he,k as U,y as ue}from"./index-BxX29htg.js";var vt=(function(){var t=u(function(Y,o,c,n){for(c=c||{},n=Y.length;n--;c[Y[n]]=o);return c},"o"),e=[1,2],s=[1,3],a=[1,4],r=[2,4],h=[1,9],d=[1,11],S=[1,16],f=[1,17],T=[1,18],_=[1,19],m=[1,33],A=[1,20],v=[1,21],p=[1,22],k=[1,23],R=[1,24],L=[1,26],$=[1,27],I=[1,28],P=[1,29],st=[1,30],it=[1,31],rt=[1,32],at=[1,35],nt=[1,36],ot=[1,37],lt=[1,38],H=[1,34],y=[1,4,5,16,17,19,21,22,24,25,26,27,28,29,33,35,37,38,41,45,48,51,52,53,54,57],ct=[1,4,5,14,15,16,17,19,21,22,24,25,26,27,28,29,33,35,37,38,39,40,41,45,48,51,52,53,54,57],xt=[4,5,16,17,19,21,22,24,25,26,27,28,29,33,35,37,38,41,45,48,51,52,53,54,57],gt={trace:u(function(){},"trace"),yy:{},symbols_:{error:2,start:3,SPACE:4,NL:5,SD:6,document:7,line:8,statement:9,classDefStatement:10,styleStatement:11,cssClassStatement:12,idStatement:13,DESCR:14,"-->":15,HIDE_EMPTY:16,scale:17,WIDTH:18,COMPOSIT_STATE:19,STRUCT_START:20,STRUCT_STOP:21,STATE_DESCR:22,AS:23,ID:24,FORK:25,JOIN:26,CHOICE:27,CONCURRENT:28,note:29,notePosition:30,NOTE_TEXT:31,direction:32,acc_title:33,acc_title_value:34,acc_descr:35,acc_descr_value:36,acc_descr_multiline_value:37,CLICK:38,STRING:39,HREF:40,classDef:41,CLASSDEF_ID:42,CLASSDEF_STYLEOPTS:43,DEFAULT:44,style:45,STYLE_IDS:46,STYLEDEF_STYLEOPTS:47,class:48,CLASSENTITY_IDS:49,STYLECLASS:50,direction_tb:51,direction_bt:52,direction_rl:53,direction_lr:54,eol:55,";":56,EDGE_STATE:57,STYLE_SEPARATOR:58,left_of:59,right_of:60,$accept:0,$end:1},terminals_:{2:"error",4:"SPACE",5:"NL",6:"SD",14:"DESCR",15:"-->",16:"HIDE_EMPTY",17:"scale",18:"WIDTH",19:"COMPOSIT_STATE",20:"STRUCT_START",21:"STRUCT_STOP",22:"STATE_DESCR",23:"AS",24:"ID",25:"FORK",26:"JOIN",27:"CHOICE",28:"CONCURRENT",29:"note",31:"NOTE_TEXT",33:"acc_title",34:"acc_title_value",35:"acc_descr",36:"acc_descr_value",37:"acc_descr_multiline_value",38:"CLICK",39:"STRING",40:"HREF",41:"classDef",42:"CLASSDEF_ID",43:"CLASSDEF_STYLEOPTS",44:"DEFAULT",45:"style",46:"STYLE_IDS",47:"STYLEDEF_STYLEOPTS",48:"class",49:"CLASSENTITY_IDS",50:"STYLECLASS",51:"direction_tb",52:"direction_bt",53:"direction_rl",54:"direction_lr",56:";",57:"EDGE_STATE",58:"STYLE_SEPARATOR",59:"left_of",60:"right_of"},productions_:[0,[3,2],[3,2],[3,2],[7,0],[7,2],[8,2],[8,1],[8,1],[9,1],[9,1],[9,1],[9,1],[9,2],[9,3],[9,4],[9,1],[9,2],[9,1],[9,4],[9,3],[9,6],[9,1],[9,1],[9,1],[9,1],[9,4],[9,4],[9,1],[9,2],[9,2],[9,1],[9,5],[9,5],[10,3],[10,3],[11,3],[12,3],[32,1],[32,1],[32,1],[32,1],[55,1],[55,1],[13,1],[13,1],[13,3],[13,3],[30,1],[30,1]],performAction:u(function(o,c,n,g,E,i,J){var l=i.length-1;switch(E){case 3:return g.setRootDoc(i[l]),i[l];case 4:this.$=[];break;case 5:i[l]!="nl"&&(i[l-1].push(i[l]),this.$=i[l-1]);break;case 6:case 7:this.$=i[l];break;case 8:this.$="nl";break;case 12:this.$=i[l];break;case 13:const q=i[l-1];q.description=g.trimColon(i[l]),this.$=q;break;case 14:this.$={stmt:"relation",state1:i[l-2],state2:i[l]};break;case 15:const Tt=g.trimColon(i[l]);this.$={stmt:"relation",state1:i[l-3],state2:i[l-1],description:Tt};break;case 19:this.$={stmt:"state",id:i[l-3],type:"default",description:"",doc:i[l-1]};break;case 20:var B=i[l],W=i[l-2].trim();if(i[l].match(":")){var ut=i[l].split(":");B=ut[0],W=[W,ut[1]]}this.$={stmt:"state",id:B,type:"default",description:W};break;case 21:this.$={stmt:"state",id:i[l-3],type:"default",description:i[l-5],doc:i[l-1]};break;case 22:this.$={stmt:"state",id:i[l],type:"fork"};break;case 23:this.$={stmt:"state",id:i[l],type:"join"};break;case 24:this.$={stmt:"state",id:i[l],type:"choice"};break;case 25:this.$={stmt:"state",id:g.getDividerId(),type:"divider"};break;case 26:this.$={stmt:"state",id:i[l-1].trim(),note:{position:i[l-2].trim(),text:i[l].trim()}};break;case 29:this.$=i[l].trim(),g.setAccTitle(this.$);break;case 30:case 31:this.$=i[l].trim(),g.setAccDescription(this.$);break;case 32:this.$={stmt:"click",id:i[l-3],url:i[l-2],tooltip:i[l-1]};break;case 33:this.$={stmt:"click",id:i[l-3],url:i[l-1],tooltip:""};break;case 34:case 35:this.$={stmt:"classDef",id:i[l-1].trim(),classes:i[l].trim()};break;case 36:this.$={stmt:"style",id:i[l-1].trim(),styleClass:i[l].trim()};break;case 37:this.$={stmt:"applyClass",id:i[l-1].trim(),styleClass:i[l].trim()};break;case 38:g.setDirection("TB"),this.$={stmt:"dir",value:"TB"};break;case 39:g.setDirection("BT"),this.$={stmt:"dir",value:"BT"};break;case 40:g.setDirection("RL"),this.$={stmt:"dir",value:"RL"};break;case 41:g.setDirection("LR"),this.$={stmt:"dir",value:"LR"};break;case 44:case 45:this.$={stmt:"state",id:i[l].trim(),type:"default",description:""};break;case 46:this.$={stmt:"state",id:i[l-2].trim(),classes:[i[l].trim()],type:"default",description:""};break;case 47:this.$={stmt:"state",id:i[l-2].trim(),classes:[i[l].trim()],type:"default",description:""};break}},"anonymous"),table:[{3:1,4:e,5:s,6:a},{1:[3]},{3:5,4:e,5:s,6:a},{3:6,4:e,5:s,6:a},t([1,4,5,16,17,19,22,24,25,26,27,28,29,33,35,37,38,41,45,48,51,52,53,54,57],r,{7:7}),{1:[2,1]},{1:[2,2]},{1:[2,3],4:h,5:d,8:8,9:10,10:12,11:13,12:14,13:15,16:S,17:f,19:T,22:_,24:m,25:A,26:v,27:p,28:k,29:R,32:25,33:L,35:$,37:I,38:P,41:st,45:it,48:rt,51:at,52:nt,53:ot,54:lt,57:H},t(y,[2,5]),{9:39,10:12,11:13,12:14,13:15,16:S,17:f,19:T,22:_,24:m,25:A,26:v,27:p,28:k,29:R,32:25,33:L,35:$,37:I,38:P,41:st,45:it,48:rt,51:at,52:nt,53:ot,54:lt,57:H},t(y,[2,7]),t(y,[2,8]),t(y,[2,9]),t(y,[2,10]),t(y,[2,11]),t(y,[2,12],{14:[1,40],15:[1,41]}),t(y,[2,16]),{18:[1,42]},t(y,[2,18],{20:[1,43]}),{23:[1,44]},t(y,[2,22]),t(y,[2,23]),t(y,[2,24]),t(y,[2,25]),{30:45,31:[1,46],59:[1,47],60:[1,48]},t(y,[2,28]),{34:[1,49]},{36:[1,50]},t(y,[2,31]),{13:51,24:m,57:H},{42:[1,52],44:[1,53]},{46:[1,54]},{49:[1,55]},t(ct,[2,44],{58:[1,56]}),t(ct,[2,45],{58:[1,57]}),t(y,[2,38]),t(y,[2,39]),t(y,[2,40]),t(y,[2,41]),t(y,[2,6]),t(y,[2,13]),{13:58,24:m,57:H},t(y,[2,17]),t(xt,r,{7:59}),{24:[1,60]},{24:[1,61]},{23:[1,62]},{24:[2,48]},{24:[2,49]},t(y,[2,29]),t(y,[2,30]),{39:[1,63],40:[1,64]},{43:[1,65]},{43:[1,66]},{47:[1,67]},{50:[1,68]},{24:[1,69]},{24:[1,70]},t(y,[2,14],{14:[1,71]}),{4:h,5:d,8:8,9:10,10:12,11:13,12:14,13:15,16:S,17:f,19:T,21:[1,72],22:_,24:m,25:A,26:v,27:p,28:k,29:R,32:25,33:L,35:$,37:I,38:P,41:st,45:it,48:rt,51:at,52:nt,53:ot,54:lt,57:H},t(y,[2,20],{20:[1,73]}),{31:[1,74]},{24:[1,75]},{39:[1,76]},{39:[1,77]},t(y,[2,34]),t(y,[2,35]),t(y,[2,36]),t(y,[2,37]),t(ct,[2,46]),t(ct,[2,47]),t(y,[2,15]),t(y,[2,19]),t(xt,r,{7:78}),t(y,[2,26]),t(y,[2,27]),{5:[1,79]},{5:[1,80]},{4:h,5:d,8:8,9:10,10:12,11:13,12:14,13:15,16:S,17:f,19:T,21:[1,81],22:_,24:m,25:A,26:v,27:p,28:k,29:R,32:25,33:L,35:$,37:I,38:P,41:st,45:it,48:rt,51:at,52:nt,53:ot,54:lt,57:H},t(y,[2,32]),t(y,[2,33]),t(y,[2,21])],defaultActions:{5:[2,1],6:[2,2],47:[2,48],48:[2,49]},parseError:u(function(o,c){if(c.recoverable)this.trace(o);else{var n=new Error(o);throw n.hash=c,n}},"parseError"),parse:u(function(o){var c=this,n=[0],g=[],E=[null],i=[],J=this.table,l="",B=0,W=0,ut=2,q=1,Tt=i.slice.call(arguments,1),D=Object.create(this.lexer),V={yy:{}};for(var Et in this.yy)Object.prototype.hasOwnProperty.call(this.yy,Et)&&(V.yy[Et]=this.yy[Et]);D.setInput(o,V.yy),V.yy.lexer=D,V.yy.parser=this,typeof D.yylloc>"u"&&(D.yylloc={});var _t=D.yylloc;i.push(_t);var Qt=D.options&&D.options.ranges;typeof V.yy.parseError=="function"?this.parseError=V.yy.parseError:this.parseError=Object.getPrototypeOf(this).parseError;function Zt(O){n.length=n.length-2*O,E.length=E.length-O,i.length=i.length-O}u(Zt,"popStack");function Lt(){var O;return O=g.pop()||D.lex()||q,typeof O!="number"&&(O instanceof Array&&(g=O,O=g.pop()),O=c.symbols_[O]||O),O}u(Lt,"lex");for(var x,M,N,mt,z={},dt,F,It,ft;;){if(M=n[n.length-1],this.defaultActions[M]?N=this.defaultActions[M]:((x===null||typeof x>"u")&&(x=Lt()),N=J[M]&&J[M][x]),typeof N>"u"||!N.length||!N[0]){var bt="";ft=[];for(dt in J[M])this.terminals_[dt]&&dt>ut&&ft.push("'"+this.terminals_[dt]+"'");D.showPosition?bt="Parse error on line "+(B+1)+`:
-`+D.showPosition()+`
-Expecting `+ft.join(", ")+", got '"+(this.terminals_[x]||x)+"'":bt="Parse error on line "+(B+1)+": Unexpected "+(x==q?"end of input":"'"+(this.terminals_[x]||x)+"'"),this.parseError(bt,{text:D.match,token:this.terminals_[x]||x,line:D.yylineno,loc:_t,expected:ft})}if(N[0]instanceof Array&&N.length>1)throw new Error("Parse Error: multiple actions possible at state: "+M+", token: "+x);switch(N[0]){case 1:n.push(x),E.push(D.yytext),i.push(D.yylloc),n.push(N[1]),x=null,W=D.yyleng,l=D.yytext,B=D.yylineno,_t=D.yylloc;break;case 2:if(F=this.productions_[N[1]][1],z.$=E[E.length-F],z._$={first_line:i[i.length-(F||1)].first_line,last_line:i[i.length-1].last_line,first_column:i[i.length-(F||1)].first_column,last_column:i[i.length-1].last_column},Qt&&(z._$.range=[i[i.length-(F||1)].range[0],i[i.length-1].range[1]]),mt=this.performAction.apply(z,[l,W,B,V.yy,N[1],E,i].concat(Tt)),typeof mt<"u")return mt;F&&(n=n.slice(0,-1*F*2),E=E.slice(0,-1*F),i=i.slice(0,-1*F)),n.push(this.productions_[N[1]][0]),E.push(z.$),i.push(z._$),It=J[n[n.length-2]][n[n.length-1]],n.push(It);break;case 3:return!0}}return!0},"parse")},qt=(function(){var Y={EOF:1,parseError:u(function(c,n){if(this.yy.parser)this.yy.parser.parseError(c,n);else throw new Error(c)},"parseError"),setInput:u(function(o,c){return this.yy=c||this.yy||{},this._input=o,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},"setInput"),input:u(function(){var o=this._input[0];this.yytext+=o,this.yyleng++,this.offset++,this.match+=o,this.matched+=o;var c=o.match(/(?:\r\n?|\n).*/g);return c?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),o},"input"),unput:u(function(o){var c=o.length,n=o.split(/(?:\r\n?|\n)/g);this._input=o+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-c),this.offset-=c;var g=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),n.length-1&&(this.yylineno-=n.length-1);var E=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:n?(n.length===g.length?this.yylloc.first_column:0)+g[g.length-n.length].length-n[0].length:this.yylloc.first_column-c},this.options.ranges&&(this.yylloc.range=[E[0],E[0]+this.yyleng-c]),this.yyleng=this.yytext.length,this},"unput"),more:u(function(){return this._more=!0,this},"more"),reject:u(function(){if(this.options.backtrack_lexer)this._backtrack=!0;else return this.parseError("Lexical error on line "+(this.yylineno+1)+`. You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).
-`+this.showPosition(),{text:"",token:null,line:this.yylineno});return this},"reject"),less:u(function(o){this.unput(this.match.slice(o))},"less"),pastInput:u(function(){var o=this.matched.substr(0,this.matched.length-this.match.length);return(o.length>20?"...":"")+o.substr(-20).replace(/\n/g,"")},"pastInput"),upcomingInput:u(function(){var o=this.match;return o.length<20&&(o+=this._input.substr(0,20-o.length)),(o.substr(0,20)+(o.length>20?"...":"")).replace(/\n/g,"")},"upcomingInput"),showPosition:u(function(){var o=this.pastInput(),c=new Array(o.length+1).join("-");return o+this.upcomingInput()+`
-`+c+"^"},"showPosition"),test_match:u(function(o,c){var n,g,E;if(this.options.backtrack_lexer&&(E={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(E.yylloc.range=this.yylloc.range.slice(0))),g=o[0].match(/(?:\r\n?|\n).*/g),g&&(this.yylineno+=g.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:g?g[g.length-1].length-g[g.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+o[0].length},this.yytext+=o[0],this.match+=o[0],this.matches=o,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(o[0].length),this.matched+=o[0],n=this.performAction.call(this,this.yy,this,c,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),n)return n;if(this._backtrack){for(var i in E)this[i]=E[i];return!1}return!1},"test_match"),next:u(function(){if(this.done)return this.EOF;this._input||(this.done=!0);var o,c,n,g;this._more||(this.yytext="",this.match="");for(var E=this._currentRules(),i=0;i<E.length;i++)if(n=this._input.match(this.rules[E[i]]),n&&(!c||n[0].length>c[0].length)){if(c=n,g=i,this.options.backtrack_lexer){if(o=this.test_match(n,E[i]),o!==!1)return o;if(this._backtrack){c=!1;continue}else return!1}else if(!this.options.flex)break}return c?(o=this.test_match(c,E[g]),o!==!1?o:!1):this._input===""?this.EOF:this.parseError("Lexical error on line "+(this.yylineno+1)+`. Unrecognized text.
-`+this.showPosition(),{text:"",token:null,line:this.yylineno})},"next"),lex:u(function(){var c=this.next();return c||this.lex()},"lex"),begin:u(function(c){this.conditionStack.push(c)},"begin"),popState:u(function(){var c=this.conditionStack.length-1;return c>0?this.conditionStack.pop():this.conditionStack[0]},"popState"),_currentRules:u(function(){return this.conditionStack.length&&this.conditionStack[this.conditionStack.length-1]?this.conditions[this.conditionStack[this.conditionStack.length-1]].rules:this.conditions.INITIAL.rules},"_currentRules"),topState:u(function(c){return c=this.conditionStack.length-1-Math.abs(c||0),c>=0?this.conditionStack[c]:"INITIAL"},"topState"),pushState:u(function(c){this.begin(c)},"pushState"),stateStackSize:u(function(){return this.conditionStack.length},"stateStackSize"),options:{"case-insensitive":!0},performAction:u(function(c,n,g,E){switch(g){case 0:return 38;case 1:return 40;case 2:return 39;case 3:return 44;case 4:return 51;case 5:return 52;case 6:return 53;case 7:return 54;case 8:break;case 9:break;case 10:return 5;case 11:break;case 12:break;case 13:break;case 14:break;case 15:return this.pushState("SCALE"),17;case 16:return 18;case 17:this.popState();break;case 18:return this.begin("acc_title"),33;case 19:return this.popState(),"acc_title_value";case 20:return this.begin("acc_descr"),35;case 21:return this.popState(),"acc_descr_value";case 22:this.begin("acc_descr_multiline");break;case 23:this.popState();break;case 24:return"acc_descr_multiline_value";case 25:return this.pushState("CLASSDEF"),41;case 26:return this.popState(),this.pushState("CLASSDEFID"),"DEFAULT_CLASSDEF_ID";case 27:return this.popState(),this.pushState("CLASSDEFID"),42;case 28:return this.popState(),43;case 29:return this.pushState("CLASS"),48;case 30:return this.popState(),this.pushState("CLASS_STYLE"),49;case 31:return this.popState(),50;case 32:return this.pushState("STYLE"),45;case 33:return this.popState(),this.pushState("STYLEDEF_STYLES"),46;case 34:return this.popState(),47;case 35:return this.pushState("SCALE"),17;case 36:return 18;case 37:this.popState();break;case 38:this.pushState("STATE");break;case 39:return this.popState(),n.yytext=n.yytext.slice(0,-8).trim(),25;case 40:return this.popState(),n.yytext=n.yytext.slice(0,-8).trim(),26;case 41:return this.popState(),n.yytext=n.yytext.slice(0,-10).trim(),27;case 42:return this.popState(),n.yytext=n.yytext.slice(0,-8).trim(),25;case 43:return this.popState(),n.yytext=n.yytext.slice(0,-8).trim(),26;case 44:return this.popState(),n.yytext=n.yytext.slice(0,-10).trim(),27;case 45:return 51;case 46:return 52;case 47:return 53;case 48:return 54;case 49:this.pushState("STATE_STRING");break;case 50:return this.pushState("STATE_ID"),"AS";case 51:return this.popState(),"ID";case 52:this.popState();break;case 53:return"STATE_DESCR";case 54:return 19;case 55:this.popState();break;case 56:return this.popState(),this.pushState("struct"),20;case 57:break;case 58:return this.popState(),21;case 59:break;case 60:return this.begin("NOTE"),29;case 61:return this.popState(),this.pushState("NOTE_ID"),59;case 62:return this.popState(),this.pushState("NOTE_ID"),60;case 63:this.popState(),this.pushState("FLOATING_NOTE");break;case 64:return this.popState(),this.pushState("FLOATING_NOTE_ID"),"AS";case 65:break;case 66:return"NOTE_TEXT";case 67:return this.popState(),"ID";case 68:return this.popState(),this.pushState("NOTE_TEXT"),24;case 69:return this.popState(),n.yytext=n.yytext.substr(2).trim(),31;case 70:return this.popState(),n.yytext=n.yytext.slice(0,-8).trim(),31;case 71:return 6;case 72:return 6;case 73:return 16;case 74:return 57;case 75:return 24;case 76:return n.yytext=n.yytext.trim(),14;case 77:return 15;case 78:return 28;case 79:return 58;case 80:return 5;case 81:return"INVALID"}},"anonymous"),rules:[/^(?:click\b)/i,/^(?:href\b)/i,/^(?:"[^"]*")/i,/^(?:default\b)/i,/^(?:.*direction\s+TB[^\n]*)/i,/^(?:.*direction\s+BT[^\n]*)/i,/^(?:.*direction\s+RL[^\n]*)/i,/^(?:.*direction\s+LR[^\n]*)/i,/^(?:%%(?!\{)[^\n]*)/i,/^(?:[^\}]%%[^\n]*)/i,/^(?:[\n]+)/i,/^(?:[\s]+)/i,/^(?:((?!\n)\s)+)/i,/^(?:#[^\n]*)/i,/^(?:%[^\n]*)/i,/^(?:scale\s+)/i,/^(?:\d+)/i,/^(?:\s+width\b)/i,/^(?:accTitle\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*\{\s*)/i,/^(?:[\}])/i,/^(?:[^\}]*)/i,/^(?:classDef\s+)/i,/^(?:DEFAULT\s+)/i,/^(?:\w+\s+)/i,/^(?:[^\n]*)/i,/^(?:class\s+)/i,/^(?:(\w+)+((,\s*\w+)*))/i,/^(?:[^\n]*)/i,/^(?:style\s+)/i,/^(?:[\w,]+\s+)/i,/^(?:[^\n]*)/i,/^(?:scale\s+)/i,/^(?:\d+)/i,/^(?:\s+width\b)/i,/^(?:state\s+)/i,/^(?:.*<<fork>>)/i,/^(?:.*<<join>>)/i,/^(?:.*<<choice>>)/i,/^(?:.*\[\[fork\]\])/i,/^(?:.*\[\[join\]\])/i,/^(?:.*\[\[choice\]\])/i,/^(?:.*direction\s+TB[^\n]*)/i,/^(?:.*direction\s+BT[^\n]*)/i,/^(?:.*direction\s+RL[^\n]*)/i,/^(?:.*direction\s+LR[^\n]*)/i,/^(?:["])/i,/^(?:\s*as\s+)/i,/^(?:[^\n\{]*)/i,/^(?:["])/i,/^(?:[^"]*)/i,/^(?:[^\n\s\{]+)/i,/^(?:\n)/i,/^(?:\{)/i,/^(?:%%(?!\{)[^\n]*)/i,/^(?:\})/i,/^(?:[\n])/i,/^(?:note\s+)/i,/^(?:left of\b)/i,/^(?:right of\b)/i,/^(?:")/i,/^(?:\s*as\s*)/i,/^(?:["])/i,/^(?:[^"]*)/i,/^(?:[^\n]*)/i,/^(?:\s*[^:\n\s\-]+)/i,/^(?:\s*:[^:\n;]+)/i,/^(?:[\s\S]*?end note\b)/i,/^(?:stateDiagram\s+)/i,/^(?:stateDiagram-v2\s+)/i,/^(?:hide empty description\b)/i,/^(?:\[\*\])/i,/^(?:[^:\n\s\-\{]+)/i,/^(?:\s*:[^:\n;]+)/i,/^(?:-->)/i,/^(?:--)/i,/^(?::::)/i,/^(?:$)/i,/^(?:.)/i],conditions:{LINE:{rules:[12,13],inclusive:!1},struct:{rules:[12,13,25,29,32,38,45,46,47,48,57,58,59,60,74,75,76,77,78],inclusive:!1},FLOATING_NOTE_ID:{rules:[67],inclusive:!1},FLOATING_NOTE:{rules:[64,65,66],inclusive:!1},NOTE_TEXT:{rules:[69,70],inclusive:!1},NOTE_ID:{rules:[68],inclusive:!1},NOTE:{rules:[61,62,63],inclusive:!1},STYLEDEF_STYLEOPTS:{rules:[],inclusive:!1},STYLEDEF_STYLES:{rules:[34],inclusive:!1},STYLE_IDS:{rules:[],inclusive:!1},STYLE:{rules:[33],inclusive:!1},CLASS_STYLE:{rules:[31],inclusive:!1},CLASS:{rules:[30],inclusive:!1},CLASSDEFID:{rules:[28],inclusive:!1},CLASSDEF:{rules:[26,27],inclusive:!1},acc_descr_multiline:{rules:[23,24],inclusive:!1},acc_descr:{rules:[21],inclusive:!1},acc_title:{rules:[19],inclusive:!1},SCALE:{rules:[16,17,36,37],inclusive:!1},ALIAS:{rules:[],inclusive:!1},STATE_ID:{rules:[51],inclusive:!1},STATE_STRING:{rules:[52,53],inclusive:!1},FORK_STATE:{rules:[],inclusive:!1},STATE:{rules:[12,13,39,40,41,42,43,44,49,50,54,55,56],inclusive:!1},ID:{rules:[12,13],inclusive:!1},INITIAL:{rules:[0,1,2,3,4,5,6,7,8,9,10,11,13,14,15,18,20,22,25,29,32,35,38,56,60,71,72,73,74,75,76,77,79,80,81],inclusive:!0}}};return Y})();gt.lexer=qt;function ht(){this.yy={}}return u(ht,"Parser"),ht.prototype=gt,gt.Parser=ht,new ht})();vt.parser=vt;var Be=vt,de="TB",Yt="TB",Ot="dir",X="state",K="root",Ct="relation",fe="classDef",pe="style",Se="applyClass",tt="default",Gt="divider",Bt="fill:none",Vt="fill: #333",Mt="c",Ut="text",jt="normal",Dt="rect",kt="rectWithTitle",ye="stateStart",ge="stateEnd",Rt="divider",Nt="roundedWithTitle",Te="note",Ee="noteGroup",et="statediagram",_e="state",me=`${et}-${_e}`,Ht="transition",be="note",De="note-edge",ke=`${Ht} ${De}`,ve=`${et}-${be}`,Ce="cluster",Ae=`${et}-${Ce}`,xe="cluster-alt",Le=`${et}-${xe}`,Wt="parent",zt="note",Ie="state",At="----",Oe=`${At}${zt}`,wt=`${At}${Wt}`,Kt=u((t,e=Yt)=>{if(!t.doc)return e;let s=e;for(const a of t.doc)a.stmt==="dir"&&(s=a.value);return s},"getDir"),Re=u(function(t,e){return e.db.getClasses()},"getClasses"),Ne=u(async function(t,e,s,a){b.info("REF0:"),b.info("Drawing state diagram (v2)",e);const{securityLevel:r,state:h,layout:d}=w();a.db.extract(a.db.getRootDocV2());const S=a.db.getData(),f=te(e,r);S.type=a.type,S.layoutAlgorithm=d,S.nodeSpacing=h?.nodeSpacing||50,S.rankSpacing=h?.rankSpacing||50,S.markers=["barb"],S.diagramId=e,await se(S,f);const T=8;try{(typeof a.db.getLinks=="function"?a.db.getLinks():new Map).forEach((m,A)=>{const v=typeof A=="string"?A:typeof A?.id=="string"?A.id:"";if(!v){b.warn("⚠️ Invalid or missing stateId from key:",JSON.stringify(A));return}const p=f.node()?.querySelectorAll("g");let k;if(p?.forEach(I=>{I.textContent?.trim()===v&&(k=I)}),!k){b.warn("⚠️ Could not find node matching text:",v);return}const R=k.parentNode;if(!R){b.warn("⚠️ Node has no parent, cannot wrap:",v);return}const L=document.createElementNS("http://www.w3.org/2000/svg","a"),$=m.url.replace(/^"+|"+$/g,"");if(L.setAttributeNS("http://www.w3.org/1999/xlink","xlink:href",$),L.setAttribute("target","_blank"),m.tooltip){const I=m.tooltip.replace(/^"+|"+$/g,"");L.setAttribute("title",I)}R.replaceChild(L,k),L.appendChild(k),b.info("🔗 Wrapped node in <a> tag for:",v,m.url)})}catch(_){b.error("❌ Error injecting clickable links:",_)}ie.insertTitle(f,"statediagramTitleText",h?.titleTopMargin??25,a.db.getDiagramTitle()),ee(f,T,et,h?.useMaxWidth??!0)},"draw"),Ve={getClasses:Re,draw:Ne,getDir:Kt},St=new Map,G=0;function yt(t="",e=0,s="",a=At){const r=s!==null&&s.length>0?`${a}${s}`:"";return`${Ie}-${t}${r}-${e}`}u(yt,"stateDomId");var we=u((t,e,s,a,r,h,d,S)=>{b.trace("items",e),e.forEach(f=>{switch(f.stmt){case X:Z(t,f,s,a,r,h,d,S);break;case tt:Z(t,f,s,a,r,h,d,S);break;case Ct:{Z(t,f.state1,s,a,r,h,d,S),Z(t,f.state2,s,a,r,h,d,S);const T={id:"edge"+G,start:f.state1.id,end:f.state2.id,arrowhead:"normal",arrowTypeEnd:"arrow_barb",style:Bt,labelStyle:"",label:U.sanitizeText(f.description??"",w()),arrowheadStyle:Vt,labelpos:Mt,labelType:Ut,thickness:jt,classes:Ht,look:d};r.push(T),G++}break}})},"setupDoc"),$t=u((t,e=Yt)=>{let s=e;if(t.doc)for(const a of t.doc)a.stmt==="dir"&&(s=a.value);return s},"getDir");function Q(t,e,s){if(!e.id||e.id==="</join></fork>"||e.id==="</choice>")return;e.cssClasses&&(Array.isArray(e.cssCompiledStyles)||(e.cssCompiledStyles=[]),e.cssClasses.split(" ").forEach(r=>{const h=s.get(r);h&&(e.cssCompiledStyles=[...e.cssCompiledStyles??[],...h.styles])}));const a=t.find(r=>r.id===e.id);a?Object.assign(a,e):t.push(e)}u(Q,"insertOrUpdateNode");function Xt(t){return t?.classes?.join(" ")??""}u(Xt,"getClassesFromDbInfo");function Jt(t){return t?.styles??[]}u(Jt,"getStylesFromDbInfo");var Z=u((t,e,s,a,r,h,d,S)=>{const f=e.id,T=s.get(f),_=Xt(T),m=Jt(T),A=w();if(b.info("dataFetcher parsedItem",e,T,m),f!=="root"){let v=Dt;e.start===!0?v=ye:e.start===!1&&(v=ge),e.type!==tt&&(v=e.type),St.get(f)||St.set(f,{id:f,shape:v,description:U.sanitizeText(f,A),cssClasses:`${_} ${me}`,cssStyles:m});const p=St.get(f);e.description&&(Array.isArray(p.description)?(p.shape=kt,p.description.push(e.description)):p.description?.length&&p.description.length>0?(p.shape=kt,p.description===f?p.description=[e.description]:p.description=[p.description,e.description]):(p.shape=Dt,p.description=e.description),p.description=U.sanitizeTextOrArray(p.description,A)),p.description?.length===1&&p.shape===kt&&(p.type==="group"?p.shape=Nt:p.shape=Dt),!p.type&&e.doc&&(b.info("Setting cluster for XCX",f,$t(e)),p.type="group",p.isGroup=!0,p.dir=$t(e),p.shape=e.type===Gt?Rt:Nt,p.cssClasses=`${p.cssClasses} ${Ae} ${h?Le:""}`);const k={labelStyle:"",shape:p.shape,label:p.description,cssClasses:p.cssClasses,cssCompiledStyles:[],cssStyles:p.cssStyles,id:f,dir:p.dir,domId:yt(f,G),type:p.type,isGroup:p.type==="group",padding:8,rx:10,ry:10,look:d};if(k.shape===Rt&&(k.label=""),t&&t.id!=="root"&&(b.trace("Setting node ",f," to be child of its parent ",t.id),k.parentId=t.id),k.centerLabel=!0,e.note){const R={labelStyle:"",shape:Te,label:e.note.text,cssClasses:ve,cssStyles:[],cssCompiledStyles:[],id:f+Oe+"-"+G,domId:yt(f,G,zt),type:p.type,isGroup:p.type==="group",padding:A.flowchart?.padding,look:d,position:e.note.position},L=f+wt,$={labelStyle:"",shape:Ee,label:e.note.text,cssClasses:p.cssClasses,cssStyles:[],id:f+wt,domId:yt(f,G,Wt),type:"group",isGroup:!0,padding:16,look:d,position:e.note.position};G++,$.id=L,R.parentId=L,Q(a,$,S),Q(a,R,S),Q(a,k,S);let I=f,P=R.id;e.note.position==="left of"&&(I=R.id,P=f),r.push({id:I+"-"+P,start:I,end:P,arrowhead:"none",arrowTypeEnd:"",style:Bt,labelStyle:"",classes:ke,arrowheadStyle:Vt,labelpos:Mt,labelType:Ut,thickness:jt,look:d})}else Q(a,k,S)}e.doc&&(b.trace("Adding nodes children "),we(e,e.doc,s,a,r,!h,d,S))},"dataFetcher"),$e=u(()=>{St.clear(),G=0},"reset"),C={START_NODE:"[*]",START_TYPE:"start",END_NODE:"[*]",END_TYPE:"end",COLOR_KEYWORD:"color",FILL_KEYWORD:"fill",BG_FILL:"bgFill",STYLECLASS_SEP:","},Pt=u(()=>new Map,"newClassesList"),Ft=u(()=>({relations:[],states:new Map,documents:{}}),"newDoc"),pt=u(t=>JSON.parse(JSON.stringify(t)),"clone"),j,Me=(j=class{constructor(e){this.version=e,this.nodes=[],this.edges=[],this.rootDoc=[],this.classes=Pt(),this.documents={root:Ft()},this.currentDocument=this.documents.root,this.startEndCount=0,this.dividerCnt=0,this.links=new Map,this.getAccTitle=re,this.setAccTitle=ae,this.getAccDescription=ne,this.setAccDescription=oe,this.setDiagramTitle=le,this.getDiagramTitle=ce,this.clear(),this.setRootDoc=this.setRootDoc.bind(this),this.getDividerId=this.getDividerId.bind(this),this.setDirection=this.setDirection.bind(this),this.trimColon=this.trimColon.bind(this)}extract(e){this.clear(!0);for(const r of Array.isArray(e)?e:e.doc)switch(r.stmt){case X:this.addState(r.id.trim(),r.type,r.doc,r.description,r.note);break;case Ct:this.addRelation(r.state1,r.state2,r.description);break;case fe:this.addStyleClass(r.id.trim(),r.classes);break;case pe:this.handleStyleDef(r);break;case Se:this.setCssClass(r.id.trim(),r.styleClass);break;case"click":this.addLink(r.id,r.url,r.tooltip);break}const s=this.getStates(),a=w();$e(),Z(void 0,this.getRootDocV2(),s,this.nodes,this.edges,!0,a.look,this.classes);for(const r of this.nodes)if(Array.isArray(r.label)){if(r.description=r.label.slice(1),r.isGroup&&r.description.length>0)throw new Error(`Group nodes can only have label. Remove the additional description for node [${r.id}]`);r.label=r.label[0]}}handleStyleDef(e){const s=e.id.trim().split(","),a=e.styleClass.split(",");for(const r of s){let h=this.getState(r);if(!h){const d=r.trim();this.addState(d),h=this.getState(d)}h&&(h.styles=a.map(d=>d.replace(/;/g,"")?.trim()))}}setRootDoc(e){b.info("Setting root doc",e),this.rootDoc=e,this.version===1?this.extract(e):this.extract(this.getRootDocV2())}docTranslator(e,s,a){if(s.stmt===Ct){this.docTranslator(e,s.state1,!0),this.docTranslator(e,s.state2,!1);return}if(s.stmt===X&&(s.id===C.START_NODE?(s.id=e.id+(a?"_start":"_end"),s.start=a):s.id=s.id.trim()),s.stmt!==K&&s.stmt!==X||!s.doc)return;const r=[];let h=[];for(const d of s.doc)if(d.type===Gt){const S=pt(d);S.doc=pt(h),r.push(S),h=[]}else h.push(d);if(r.length>0&&h.length>0){const d={stmt:X,id:he(),type:"divider",doc:pt(h)};r.push(pt(d)),s.doc=r}s.doc.forEach(d=>this.docTranslator(s,d,!0))}getRootDocV2(){return this.docTranslator({id:K,stmt:K},{id:K,stmt:K,doc:this.rootDoc},!0),{id:K,doc:this.rootDoc}}addState(e,s=tt,a=void 0,r=void 0,h=void 0,d=void 0,S=void 0,f=void 0){const T=e?.trim();if(!this.currentDocument.states.has(T))b.info("Adding state ",T,r),this.currentDocument.states.set(T,{stmt:X,id:T,descriptions:[],type:s,doc:a,note:h,classes:[],styles:[],textStyles:[]});else{const _=this.currentDocument.states.get(T);if(!_)throw new Error(`State not found: ${T}`);_.doc||(_.doc=a),_.type||(_.type=s)}if(r&&(b.info("Setting state description",T,r),(Array.isArray(r)?r:[r]).forEach(m=>this.addDescription(T,m.trim()))),h){const _=this.currentDocument.states.get(T);if(!_)throw new Error(`State not found: ${T}`);_.note=h,_.note.text=U.sanitizeText(_.note.text,w())}d&&(b.info("Setting state classes",T,d),(Array.isArray(d)?d:[d]).forEach(m=>this.setCssClass(T,m.trim()))),S&&(b.info("Setting state styles",T,S),(Array.isArray(S)?S:[S]).forEach(m=>this.setStyle(T,m.trim()))),f&&(b.info("Setting state styles",T,S),(Array.isArray(f)?f:[f]).forEach(m=>this.setTextStyle(T,m.trim())))}clear(e){this.nodes=[],this.edges=[],this.documents={root:Ft()},this.currentDocument=this.documents.root,this.startEndCount=0,this.classes=Pt(),e||(this.links=new Map,ue())}getState(e){return this.currentDocument.states.get(e)}getStates(){return this.currentDocument.states}logDocuments(){b.info("Documents = ",this.documents)}getRelations(){return this.currentDocument.relations}addLink(e,s,a){this.links.set(e,{url:s,tooltip:a}),b.warn("Adding link",e,s,a)}getLinks(){return this.links}startIdIfNeeded(e=""){return e===C.START_NODE?(this.startEndCount++,`${C.START_TYPE}${this.startEndCount}`):e}startTypeIfNeeded(e="",s=tt){return e===C.START_NODE?C.START_TYPE:s}endIdIfNeeded(e=""){return e===C.END_NODE?(this.startEndCount++,`${C.END_TYPE}${this.startEndCount}`):e}endTypeIfNeeded(e="",s=tt){return e===C.END_NODE?C.END_TYPE:s}addRelationObjs(e,s,a=""){const r=this.startIdIfNeeded(e.id.trim()),h=this.startTypeIfNeeded(e.id.trim(),e.type),d=this.startIdIfNeeded(s.id.trim()),S=this.startTypeIfNeeded(s.id.trim(),s.type);this.addState(r,h,e.doc,e.description,e.note,e.classes,e.styles,e.textStyles),this.addState(d,S,s.doc,s.description,s.note,s.classes,s.styles,s.textStyles),this.currentDocument.relations.push({id1:r,id2:d,relationTitle:U.sanitizeText(a,w())})}addRelation(e,s,a){if(typeof e=="object"&&typeof s=="object")this.addRelationObjs(e,s,a);else if(typeof e=="string"&&typeof s=="string"){const r=this.startIdIfNeeded(e.trim()),h=this.startTypeIfNeeded(e),d=this.endIdIfNeeded(s.trim()),S=this.endTypeIfNeeded(s);this.addState(r,h),this.addState(d,S),this.currentDocument.relations.push({id1:r,id2:d,relationTitle:a?U.sanitizeText(a,w()):void 0})}}addDescription(e,s){const a=this.currentDocument.states.get(e),r=s.startsWith(":")?s.replace(":","").trim():s;a?.descriptions?.push(U.sanitizeText(r,w()))}cleanupLabel(e){return e.startsWith(":")?e.slice(2).trim():e.trim()}getDividerId(){return this.dividerCnt++,`divider-id-${this.dividerCnt}`}addStyleClass(e,s=""){this.classes.has(e)||this.classes.set(e,{id:e,styles:[],textStyles:[]});const a=this.classes.get(e);s&&a&&s.split(C.STYLECLASS_SEP).forEach(r=>{const h=r.replace(/([^;]*);/,"$1").trim();if(RegExp(C.COLOR_KEYWORD).exec(r)){const S=h.replace(C.FILL_KEYWORD,C.BG_FILL).replace(C.COLOR_KEYWORD,C.FILL_KEYWORD);a.textStyles.push(S)}a.styles.push(h)})}getClasses(){return this.classes}setCssClass(e,s){e.split(",").forEach(a=>{let r=this.getState(a);if(!r){const h=a.trim();this.addState(h),r=this.getState(h)}r?.classes?.push(s)})}setStyle(e,s){this.getState(e)?.styles?.push(s)}setTextStyle(e,s){this.getState(e)?.textStyles?.push(s)}getDirectionStatement(){return this.rootDoc.find(e=>e.stmt===Ot)}getDirection(){return this.getDirectionStatement()?.value??de}setDirection(e){const s=this.getDirectionStatement();s?s.value=e:this.rootDoc.unshift({stmt:Ot,value:e})}trimColon(e){return e.startsWith(":")?e.slice(1).trim():e.trim()}getData(){const e=w();return{nodes:this.nodes,edges:this.edges,other:{},config:e,direction:Kt(this.getRootDocV2())}}getConfig(){return w().state}},u(j,"StateDB"),j.relationType={AGGREGATION:0,EXTENSION:1,COMPOSITION:2,DEPENDENCY:3},j),Pe=u(t=>`
-defs #statediagram-barbEnd {
-    fill: ${t.transitionColor};
-    stroke: ${t.transitionColor};
-  }
-g.stateGroup text {
-  fill: ${t.nodeBorder};
-  stroke: none;
-  font-size: 10px;
-}
-g.stateGroup text {
-  fill: ${t.textColor};
-  stroke: none;
-  font-size: 10px;
-
-}
-g.stateGroup .state-title {
-  font-weight: bolder;
-  fill: ${t.stateLabelColor};
-}
-
-g.stateGroup rect {
-  fill: ${t.mainBkg};
-  stroke: ${t.nodeBorder};
-}
-
-g.stateGroup line {
-  stroke: ${t.lineColor};
-  stroke-width: 1;
-}
-
-.transition {
-  stroke: ${t.transitionColor};
-  stroke-width: 1;
-  fill: none;
-}
-
-.stateGroup .composit {
-  fill: ${t.background};
-  border-bottom: 1px
-}
-
-.stateGroup .alt-composit {
-  fill: #e0e0e0;
-  border-bottom: 1px
-}
-
-.state-note {
-  stroke: ${t.noteBorderColor};
-  fill: ${t.noteBkgColor};
-
-  text {
-    fill: ${t.noteTextColor};
-    stroke: none;
-    font-size: 10px;
-  }
-}
-
-.stateLabel .box {
-  stroke: none;
-  stroke-width: 0;
-  fill: ${t.mainBkg};
-  opacity: 0.5;
-}
-
-.edgeLabel .label rect {
-  fill: ${t.labelBackgroundColor};
-  opacity: 0.5;
-}
-.edgeLabel {
-  background-color: ${t.edgeLabelBackground};
-  p {
-    background-color: ${t.edgeLabelBackground};
-  }
-  rect {
-    opacity: 0.5;
-    background-color: ${t.edgeLabelBackground};
-    fill: ${t.edgeLabelBackground};
-  }
-  text-align: center;
-}
-.edgeLabel .label text {
-  fill: ${t.transitionLabelColor||t.tertiaryTextColor};
-}
-.label div .edgeLabel {
-  color: ${t.transitionLabelColor||t.tertiaryTextColor};
-}
-
-.stateLabel text {
-  fill: ${t.stateLabelColor};
-  font-size: 10px;
-  font-weight: bold;
-}
-
-.node circle.state-start {
-  fill: ${t.specialStateColor};
-  stroke: ${t.specialStateColor};
-}
-
-.node .fork-join {
-  fill: ${t.specialStateColor};
-  stroke: ${t.specialStateColor};
-}
-
-.node circle.state-end {
-  fill: ${t.innerEndBackground};
-  stroke: ${t.background};
-  stroke-width: 1.5
-}
-.end-state-inner {
-  fill: ${t.compositeBackground||t.background};
-  // stroke: ${t.background};
-  stroke-width: 1.5
-}
-
-.node rect {
-  fill: ${t.stateBkg||t.mainBkg};
-  stroke: ${t.stateBorder||t.nodeBorder};
-  stroke-width: 1px;
-}
-.node polygon {
-  fill: ${t.mainBkg};
-  stroke: ${t.stateBorder||t.nodeBorder};;
-  stroke-width: 1px;
-}
-#statediagram-barbEnd {
-  fill: ${t.lineColor};
-}
-
-.statediagram-cluster rect {
-  fill: ${t.compositeTitleBackground};
-  stroke: ${t.stateBorder||t.nodeBorder};
-  stroke-width: 1px;
-}
-
-.cluster-label, .nodeLabel {
-  color: ${t.stateLabelColor};
-  // line-height: 1;
-}
-
-.statediagram-cluster rect.outer {
-  rx: 5px;
-  ry: 5px;
-}
-.statediagram-state .divider {
-  stroke: ${t.stateBorder||t.nodeBorder};
-}
-
-.statediagram-state .title-state {
-  rx: 5px;
-  ry: 5px;
-}
-.statediagram-cluster.statediagram-cluster .inner {
-  fill: ${t.compositeBackground||t.background};
-}
-.statediagram-cluster.statediagram-cluster-alt .inner {
-  fill: ${t.altBackground?t.altBackground:"#efefef"};
-}
-
-.statediagram-cluster .inner {
-  rx:0;
-  ry:0;
-}
-
-.statediagram-state rect.basic {
-  rx: 5px;
-  ry: 5px;
-}
-.statediagram-state rect.divider {
-  stroke-dasharray: 10,10;
-  fill: ${t.altBackground?t.altBackground:"#efefef"};
-}
-
-.note-edge {
-  stroke-dasharray: 5;
-}
-
-.statediagram-note rect {
-  fill: ${t.noteBkgColor};
-  stroke: ${t.noteBorderColor};
-  stroke-width: 1px;
-  rx: 0;
-  ry: 0;
-}
-.statediagram-note rect {
-  fill: ${t.noteBkgColor};
-  stroke: ${t.noteBorderColor};
-  stroke-width: 1px;
-  rx: 0;
-  ry: 0;
-}
-
-.statediagram-note text {
-  fill: ${t.noteTextColor};
-}
-
-.statediagram-note .nodeLabel {
-  color: ${t.noteTextColor};
-}
-.statediagram .edgeLabel {
-  color: red; // ${t.noteTextColor};
-}
-
-#dependencyStart, #dependencyEnd {
-  fill: ${t.lineColor};
-  stroke: ${t.lineColor};
-  stroke-width: 1;
-}
-
-.statediagramTitleText {
-  text-anchor: middle;
-  font-size: 18px;
-  fill: ${t.textColor};
-}
-`,"getStyles"),Ue=Pe;export{Me as S,Be as a,Ve as b,Ue as s};
diff --git a/docs/dist/assets/chunk-FMBD7UC4-Bm3lI1XN.js b/docs/dist/assets/chunk-FMBD7UC4-Bm3lI1XN.js
deleted file mode 100644
index c57298b2..00000000
--- a/docs/dist/assets/chunk-FMBD7UC4-Bm3lI1XN.js
+++ /dev/null
@@ -1,15 +0,0 @@
-import{_ as e}from"./index-BxX29htg.js";var l=e(()=>`
-  /* Font Awesome icon styling - consolidated */
-  .label-icon {
-    display: inline-block;
-    height: 1em;
-    overflow: visible;
-    vertical-align: -0.125em;
-  }
-  
-  .node .label-icon path {
-    fill: currentColor;
-    stroke: revert;
-    stroke-width: revert;
-  }
-`,"getIconStyles");export{l as g};
diff --git a/docs/dist/assets/chunk-QN33PNHL-1s4FuBGd.js b/docs/dist/assets/chunk-QN33PNHL-1s4FuBGd.js
deleted file mode 100644
index faa5afff..00000000
--- a/docs/dist/assets/chunk-QN33PNHL-1s4FuBGd.js
+++ /dev/null
@@ -1 +0,0 @@
-import{_ as a,e as w,l as x}from"./index-BxX29htg.js";var d=a((e,t,i,r)=>{e.attr("class",i);const{width:o,height:h,x:n,y:c}=u(e,t);w(e,h,o,r);const s=l(n,c,o,h,t);e.attr("viewBox",s),x.debug(`viewBox configured: ${s} with padding: ${t}`)},"setupViewPortForSVG"),u=a((e,t)=>{const i=e.node()?.getBBox()||{width:0,height:0,x:0,y:0};return{width:i.width+t*2,height:i.height+t*2,x:i.x,y:i.y}},"calculateDimensionsWithPadding"),l=a((e,t,i,r,o)=>`${e-o} ${t-o} ${i} ${r}`,"createViewBox");export{d as s};
diff --git a/docs/dist/assets/chunk-QZHKN3VN-CEAug577.js b/docs/dist/assets/chunk-QZHKN3VN-CEAug577.js
deleted file mode 100644
index 3d9e94e2..00000000
--- a/docs/dist/assets/chunk-QZHKN3VN-CEAug577.js
+++ /dev/null
@@ -1 +0,0 @@
-import{_ as s}from"./index-BxX29htg.js";var t,e=(t=class{constructor(i){this.init=i,this.records=this.init()}reset(){this.records=this.init()}},s(t,"ImperativeState"),t);export{e as I};
diff --git a/docs/dist/assets/chunk-TZMSLE5B-BkTUbDII.js b/docs/dist/assets/chunk-TZMSLE5B-BkTUbDII.js
deleted file mode 100644
index 08d999fc..00000000
--- a/docs/dist/assets/chunk-TZMSLE5B-BkTUbDII.js
+++ /dev/null
@@ -1 +0,0 @@
-import{_ as n,U as o,j as l}from"./index-BxX29htg.js";var x=n((s,t)=>{const e=s.append("rect");if(e.attr("x",t.x),e.attr("y",t.y),e.attr("fill",t.fill),e.attr("stroke",t.stroke),e.attr("width",t.width),e.attr("height",t.height),t.name&&e.attr("name",t.name),t.rx&&e.attr("rx",t.rx),t.ry&&e.attr("ry",t.ry),t.attrs!==void 0)for(const r in t.attrs)e.attr(r,t.attrs[r]);return t.class&&e.attr("class",t.class),e},"drawRect"),d=n((s,t)=>{const e={x:t.startx,y:t.starty,width:t.stopx-t.startx,height:t.stopy-t.starty,fill:t.fill,stroke:t.stroke,class:"rect"};x(s,e).lower()},"drawBackgroundRect"),g=n((s,t)=>{const e=t.text.replace(o," "),r=s.append("text");r.attr("x",t.x),r.attr("y",t.y),r.attr("class","legend"),r.style("text-anchor",t.anchor),t.class&&r.attr("class",t.class);const a=r.append("tspan");return a.attr("x",t.x+t.textMargin*2),a.text(e),r},"drawText"),h=n((s,t,e,r)=>{const a=s.append("image");a.attr("x",t),a.attr("y",e);const i=l.sanitizeUrl(r);a.attr("xlink:href",i)},"drawImage"),m=n((s,t,e,r)=>{const a=s.append("use");a.attr("x",t),a.attr("y",e);const i=l.sanitizeUrl(r);a.attr("xlink:href",`#${i}`)},"drawEmbeddedImage"),y=n(()=>({x:0,y:0,width:100,height:100,fill:"#EDF2AE",stroke:"#666",anchor:"start",rx:0,ry:0}),"getNoteRect"),p=n(()=>({x:0,y:0,width:100,height:100,"text-anchor":"start",style:"#666",textMargin:0,rx:0,ry:0,tspan:!0}),"getTextObj");export{d as a,p as b,m as c,x as d,h as e,g as f,y as g};
diff --git a/docs/dist/assets/classDiagram-2ON5EDUG-BfY8AvxO.js b/docs/dist/assets/classDiagram-2ON5EDUG-BfY8AvxO.js
deleted file mode 100644
index 7ee781cc..00000000
--- a/docs/dist/assets/classDiagram-2ON5EDUG-BfY8AvxO.js
+++ /dev/null
@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-B4BG7PRW-DyUrByJj.js";import{_ as i}from"./index-BxX29htg.js";import"./chunk-FMBD7UC4-Bm3lI1XN.js";import"./chunk-55IACEB6-BE1gdz1f.js";import"./chunk-QN33PNHL-1s4FuBGd.js";var p={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{p as diagram};
diff --git a/docs/dist/assets/classDiagram-v2-WZHVMYZB-BfY8AvxO.js b/docs/dist/assets/classDiagram-v2-WZHVMYZB-BfY8AvxO.js
deleted file mode 100644
index 7ee781cc..00000000
--- a/docs/dist/assets/classDiagram-v2-WZHVMYZB-BfY8AvxO.js
+++ /dev/null
@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-B4BG7PRW-DyUrByJj.js";import{_ as i}from"./index-BxX29htg.js";import"./chunk-FMBD7UC4-Bm3lI1XN.js";import"./chunk-55IACEB6-BE1gdz1f.js";import"./chunk-QN33PNHL-1s4FuBGd.js";var p={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{p as diagram};
diff --git a/docs/dist/assets/clone-BRV0rZiZ.js b/docs/dist/assets/clone-BRV0rZiZ.js
deleted file mode 100644
index 8ca7e66a..00000000
--- a/docs/dist/assets/clone-BRV0rZiZ.js
+++ /dev/null
@@ -1 +0,0 @@
-import{b as r}from"./_baseUniq-CfjWcJYV.js";var e=4;function a(o){return r(o,e)}export{a as c};
diff --git a/docs/dist/assets/cose-bilkent-S5V4N54A-DgZv4oG7.js b/docs/dist/assets/cose-bilkent-S5V4N54A-DgZv4oG7.js
deleted file mode 100644
index 8129b1c0..00000000
--- a/docs/dist/assets/cose-bilkent-S5V4N54A-DgZv4oG7.js
+++ /dev/null
@@ -1 +0,0 @@
-import{aI as lt,_ as V,l as k,d as gt}from"./index-BxX29htg.js";import{c as tt}from"./cytoscape.esm-CF_z7lu9.js";var $={exports:{}},Z={exports:{}},Q={exports:{}},ut=Q.exports,j;function ft(){return j||(j=1,(function(G,b){(function(I,L){G.exports=L()})(ut,function(){return(function(N){var I={};function L(o){if(I[o])return I[o].exports;var e=I[o]={i:o,l:!1,exports:{}};return N[o].call(e.exports,e,e.exports,L),e.l=!0,e.exports}return L.m=N,L.c=I,L.i=function(o){return o},L.d=function(o,e,t){L.o(o,e)||Object.defineProperty(o,e,{configurable:!1,enumerable:!0,get:t})},L.n=function(o){var e=o&&o.__esModule?(function(){return o.default}):(function(){return o});return L.d(e,"a",e),e},L.o=function(o,e){return Object.prototype.hasOwnProperty.call(o,e)},L.p="",L(L.s=26)})([(function(N,I,L){function o(){}o.QUALITY=1,o.DEFAULT_CREATE_BENDS_AS_NEEDED=!1,o.DEFAULT_INCREMENTAL=!1,o.DEFAULT_ANIMATION_ON_LAYOUT=!0,o.DEFAULT_ANIMATION_DURING_LAYOUT=!1,o.DEFAULT_ANIMATION_PERIOD=50,o.DEFAULT_UNIFORM_LEAF_NODE_SIZES=!1,o.DEFAULT_GRAPH_MARGIN=15,o.NODE_DIMENSIONS_INCLUDE_LABELS=!1,o.SIMPLE_NODE_SIZE=40,o.SIMPLE_NODE_HALF_SIZE=o.SIMPLE_NODE_SIZE/2,o.EMPTY_COMPOUND_NODE_SIZE=40,o.MIN_EDGE_LENGTH=1,o.WORLD_BOUNDARY=1e6,o.INITIAL_WORLD_BOUNDARY=o.WORLD_BOUNDARY/1e3,o.WORLD_CENTER_X=1200,o.WORLD_CENTER_Y=900,N.exports=o}),(function(N,I,L){var o=L(2),e=L(8),t=L(9);function i(g,n,d){o.call(this,d),this.isOverlapingSourceAndTarget=!1,this.vGraphObject=d,this.bendpoints=[],this.source=g,this.target=n}i.prototype=Object.create(o.prototype);for(var l in o)i[l]=o[l];i.prototype.getSource=function(){return this.source},i.prototype.getTarget=function(){return this.target},i.prototype.isInterGraph=function(){return this.isInterGraph},i.prototype.getLength=function(){return this.length},i.prototype.isOverlapingSourceAndTarget=function(){return this.isOverlapingSourceAndTarget},i.prototype.getBendpoints=function(){return this.bendpoints},i.prototype.getLca=function(){return this.lca},i.prototype.getSourceInLca=function(){return this.sourceInLca},i.prototype.getTargetInLca=function(){return this.targetInLca},i.prototype.getOtherEnd=function(g){if(this.source===g)return this.target;if(this.target===g)return this.source;throw"Node is not incident with this edge"},i.prototype.getOtherEndInGraph=function(g,n){for(var d=this.getOtherEnd(g),r=n.getGraphManager().getRoot();;){if(d.getOwner()==n)return d;if(d.getOwner()==r)break;d=d.getOwner().getParent()}return null},i.prototype.updateLength=function(){var g=new Array(4);this.isOverlapingSourceAndTarget=e.getIntersection(this.target.getRect(),this.source.getRect(),g),this.isOverlapingSourceAndTarget||(this.lengthX=g[0]-g[2],this.lengthY=g[1]-g[3],Math.abs(this.lengthX)<1&&(this.lengthX=t.sign(this.lengthX)),Math.abs(this.lengthY)<1&&(this.lengthY=t.sign(this.lengthY)),this.length=Math.sqrt(this.lengthX*this.lengthX+this.lengthY*this.lengthY))},i.prototype.updateLengthSimple=function(){this.lengthX=this.target.getCenterX()-this.source.getCenterX(),this.lengthY=this.target.getCenterY()-this.source.getCenterY(),Math.abs(this.lengthX)<1&&(this.lengthX=t.sign(this.lengthX)),Math.abs(this.lengthY)<1&&(this.lengthY=t.sign(this.lengthY)),this.length=Math.sqrt(this.lengthX*this.lengthX+this.lengthY*this.lengthY)},N.exports=i}),(function(N,I,L){function o(e){this.vGraphObject=e}N.exports=o}),(function(N,I,L){var o=L(2),e=L(10),t=L(13),i=L(0),l=L(16),g=L(4);function n(r,h,a,p){a==null&&p==null&&(p=h),o.call(this,p),r.graphManager!=null&&(r=r.graphManager),this.estimatedSize=e.MIN_VALUE,this.inclusionTreeDepth=e.MAX_VALUE,this.vGraphObject=p,this.edges=[],this.graphManager=r,a!=null&&h!=null?this.rect=new t(h.x,h.y,a.width,a.height):this.rect=new t}n.prototype=Object.create(o.prototype);for(var d in o)n[d]=o[d];n.prototype.getEdges=function(){return this.edges},n.prototype.getChild=function(){return this.child},n.prototype.getOwner=function(){return this.owner},n.prototype.getWidth=function(){return this.rect.width},n.prototype.setWidth=function(r){this.rect.width=r},n.prototype.getHeight=function(){return this.rect.height},n.prototype.setHeight=function(r){this.rect.height=r},n.prototype.getCenterX=function(){return this.rect.x+this.rect.width/2},n.prototype.getCenterY=function(){return this.rect.y+this.rect.height/2},n.prototype.getCenter=function(){return new g(this.rect.x+this.rect.width/2,this.rect.y+this.rect.height/2)},n.prototype.getLocation=function(){return new g(this.rect.x,this.rect.y)},n.prototype.getRect=function(){return this.rect},n.prototype.getDiagonal=function(){return Math.sqrt(this.rect.width*this.rect.width+this.rect.height*this.rect.height)},n.prototype.getHalfTheDiagonal=function(){return Math.sqrt(this.rect.height*this.rect.height+this.rect.width*this.rect.width)/2},n.prototype.setRect=function(r,h){this.rect.x=r.x,this.rect.y=r.y,this.rect.width=h.width,this.rect.height=h.height},n.prototype.setCenter=function(r,h){this.rect.x=r-this.rect.width/2,this.rect.y=h-this.rect.height/2},n.prototype.setLocation=function(r,h){this.rect.x=r,this.rect.y=h},n.prototype.moveBy=function(r,h){this.rect.x+=r,this.rect.y+=h},n.prototype.getEdgeListToNode=function(r){var h=[],a=this;return a.edges.forEach(function(p){if(p.target==r){if(p.source!=a)throw"Incorrect edge source!";h.push(p)}}),h},n.prototype.getEdgesBetween=function(r){var h=[],a=this;return a.edges.forEach(function(p){if(!(p.source==a||p.target==a))throw"Incorrect edge source and/or target";(p.target==r||p.source==r)&&h.push(p)}),h},n.prototype.getNeighborsList=function(){var r=new Set,h=this;return h.edges.forEach(function(a){if(a.source==h)r.add(a.target);else{if(a.target!=h)throw"Incorrect incidency!";r.add(a.source)}}),r},n.prototype.withChildren=function(){var r=new Set,h,a;if(r.add(this),this.child!=null)for(var p=this.child.getNodes(),v=0;v<p.length;v++)h=p[v],a=h.withChildren(),a.forEach(function(D){r.add(D)});return r},n.prototype.getNoOfChildren=function(){var r=0,h;if(this.child==null)r=1;else for(var a=this.child.getNodes(),p=0;p<a.length;p++)h=a[p],r+=h.getNoOfChildren();return r==0&&(r=1),r},n.prototype.getEstimatedSize=function(){if(this.estimatedSize==e.MIN_VALUE)throw"assert failed";return this.estimatedSize},n.prototype.calcEstimatedSize=function(){return this.child==null?this.estimatedSize=(this.rect.width+this.rect.height)/2:(this.estimatedSize=this.child.calcEstimatedSize(),this.rect.width=this.estimatedSize,this.rect.height=this.estimatedSize,this.estimatedSize)},n.prototype.scatter=function(){var r,h,a=-i.INITIAL_WORLD_BOUNDARY,p=i.INITIAL_WORLD_BOUNDARY;r=i.WORLD_CENTER_X+l.nextDouble()*(p-a)+a;var v=-i.INITIAL_WORLD_BOUNDARY,D=i.INITIAL_WORLD_BOUNDARY;h=i.WORLD_CENTER_Y+l.nextDouble()*(D-v)+v,this.rect.x=r,this.rect.y=h},n.prototype.updateBounds=function(){if(this.getChild()==null)throw"assert failed";if(this.getChild().getNodes().length!=0){var r=this.getChild();if(r.updateBounds(!0),this.rect.x=r.getLeft(),this.rect.y=r.getTop(),this.setWidth(r.getRight()-r.getLeft()),this.setHeight(r.getBottom()-r.getTop()),i.NODE_DIMENSIONS_INCLUDE_LABELS){var h=r.getRight()-r.getLeft(),a=r.getBottom()-r.getTop();this.labelWidth>h&&(this.rect.x-=(this.labelWidth-h)/2,this.setWidth(this.labelWidth)),this.labelHeight>a&&(this.labelPos=="center"?this.rect.y-=(this.labelHeight-a)/2:this.labelPos=="top"&&(this.rect.y-=this.labelHeight-a),this.setHeight(this.labelHeight))}}},n.prototype.getInclusionTreeDepth=function(){if(this.inclusionTreeDepth==e.MAX_VALUE)throw"assert failed";return this.inclusionTreeDepth},n.prototype.transform=function(r){var h=this.rect.x;h>i.WORLD_BOUNDARY?h=i.WORLD_BOUNDARY:h<-i.WORLD_BOUNDARY&&(h=-i.WORLD_BOUNDARY);var a=this.rect.y;a>i.WORLD_BOUNDARY?a=i.WORLD_BOUNDARY:a<-i.WORLD_BOUNDARY&&(a=-i.WORLD_BOUNDARY);var p=new g(h,a),v=r.inverseTransformPoint(p);this.setLocation(v.x,v.y)},n.prototype.getLeft=function(){return this.rect.x},n.prototype.getRight=function(){return this.rect.x+this.rect.width},n.prototype.getTop=function(){return this.rect.y},n.prototype.getBottom=function(){return this.rect.y+this.rect.height},n.prototype.getParent=function(){return this.owner==null?null:this.owner.getParent()},N.exports=n}),(function(N,I,L){function o(e,t){e==null&&t==null?(this.x=0,this.y=0):(this.x=e,this.y=t)}o.prototype.getX=function(){return this.x},o.prototype.getY=function(){return this.y},o.prototype.setX=function(e){this.x=e},o.prototype.setY=function(e){this.y=e},o.prototype.getDifference=function(e){return new DimensionD(this.x-e.x,this.y-e.y)},o.prototype.getCopy=function(){return new o(this.x,this.y)},o.prototype.translate=function(e){return this.x+=e.width,this.y+=e.height,this},N.exports=o}),(function(N,I,L){var o=L(2),e=L(10),t=L(0),i=L(6),l=L(3),g=L(1),n=L(13),d=L(12),r=L(11);function h(p,v,D){o.call(this,D),this.estimatedSize=e.MIN_VALUE,this.margin=t.DEFAULT_GRAPH_MARGIN,this.edges=[],this.nodes=[],this.isConnected=!1,this.parent=p,v!=null&&v instanceof i?this.graphManager=v:v!=null&&v instanceof Layout&&(this.graphManager=v.graphManager)}h.prototype=Object.create(o.prototype);for(var a in o)h[a]=o[a];h.prototype.getNodes=function(){return this.nodes},h.prototype.getEdges=function(){return this.edges},h.prototype.getGraphManager=function(){return this.graphManager},h.prototype.getParent=function(){return this.parent},h.prototype.getLeft=function(){return this.left},h.prototype.getRight=function(){return this.right},h.prototype.getTop=function(){return this.top},h.prototype.getBottom=function(){return this.bottom},h.prototype.isConnected=function(){return this.isConnected},h.prototype.add=function(p,v,D){if(v==null&&D==null){var u=p;if(this.graphManager==null)throw"Graph has no graph mgr!";if(this.getNodes().indexOf(u)>-1)throw"Node already in graph!";return u.owner=this,this.getNodes().push(u),u}else{var T=p;if(!(this.getNodes().indexOf(v)>-1&&this.getNodes().indexOf(D)>-1))throw"Source or target not in graph!";if(!(v.owner==D.owner&&v.owner==this))throw"Both owners must be this graph!";return v.owner!=D.owner?null:(T.source=v,T.target=D,T.isInterGraph=!1,this.getEdges().push(T),v.edges.push(T),D!=v&&D.edges.push(T),T)}},h.prototype.remove=function(p){var v=p;if(p instanceof l){if(v==null)throw"Node is null!";if(!(v.owner!=null&&v.owner==this))throw"Owner graph is invalid!";if(this.graphManager==null)throw"Owner graph manager is invalid!";for(var D=v.edges.slice(),u,T=D.length,y=0;y<T;y++)u=D[y],u.isInterGraph?this.graphManager.remove(u):u.source.owner.remove(u);var O=this.nodes.indexOf(v);if(O==-1)throw"Node not in owner node list!";this.nodes.splice(O,1)}else if(p instanceof g){var u=p;if(u==null)throw"Edge is null!";if(!(u.source!=null&&u.target!=null))throw"Source and/or target is null!";if(!(u.source.owner!=null&&u.target.owner!=null&&u.source.owner==this&&u.target.owner==this))throw"Source and/or target owner is invalid!";var s=u.source.edges.indexOf(u),f=u.target.edges.indexOf(u);if(!(s>-1&&f>-1))throw"Source and/or target doesn't know this edge!";u.source.edges.splice(s,1),u.target!=u.source&&u.target.edges.splice(f,1);var O=u.source.owner.getEdges().indexOf(u);if(O==-1)throw"Not in owner's edge list!";u.source.owner.getEdges().splice(O,1)}},h.prototype.updateLeftTop=function(){for(var p=e.MAX_VALUE,v=e.MAX_VALUE,D,u,T,y=this.getNodes(),O=y.length,s=0;s<O;s++){var f=y[s];D=f.getTop(),u=f.getLeft(),p>D&&(p=D),v>u&&(v=u)}return p==e.MAX_VALUE?null:(y[0].getParent().paddingLeft!=null?T=y[0].getParent().paddingLeft:T=this.margin,this.left=v-T,this.top=p-T,new d(this.left,this.top))},h.prototype.updateBounds=function(p){for(var v=e.MAX_VALUE,D=-e.MAX_VALUE,u=e.MAX_VALUE,T=-e.MAX_VALUE,y,O,s,f,c,E=this.nodes,A=E.length,m=0;m<A;m++){var C=E[m];p&&C.child!=null&&C.updateBounds(),y=C.getLeft(),O=C.getRight(),s=C.getTop(),f=C.getBottom(),v>y&&(v=y),D<O&&(D=O),u>s&&(u=s),T<f&&(T=f)}var R=new n(v,u,D-v,T-u);v==e.MAX_VALUE&&(this.left=this.parent.getLeft(),this.right=this.parent.getRight(),this.top=this.parent.getTop(),this.bottom=this.parent.getBottom()),E[0].getParent().paddingLeft!=null?c=E[0].getParent().paddingLeft:c=this.margin,this.left=R.x-c,this.right=R.x+R.width+c,this.top=R.y-c,this.bottom=R.y+R.height+c},h.calculateBounds=function(p){for(var v=e.MAX_VALUE,D=-e.MAX_VALUE,u=e.MAX_VALUE,T=-e.MAX_VALUE,y,O,s,f,c=p.length,E=0;E<c;E++){var A=p[E];y=A.getLeft(),O=A.getRight(),s=A.getTop(),f=A.getBottom(),v>y&&(v=y),D<O&&(D=O),u>s&&(u=s),T<f&&(T=f)}var m=new n(v,u,D-v,T-u);return m},h.prototype.getInclusionTreeDepth=function(){return this==this.graphManager.getRoot()?1:this.parent.getInclusionTreeDepth()},h.prototype.getEstimatedSize=function(){if(this.estimatedSize==e.MIN_VALUE)throw"assert failed";return this.estimatedSize},h.prototype.calcEstimatedSize=function(){for(var p=0,v=this.nodes,D=v.length,u=0;u<D;u++){var T=v[u];p+=T.calcEstimatedSize()}return p==0?this.estimatedSize=t.EMPTY_COMPOUND_NODE_SIZE:this.estimatedSize=p/Math.sqrt(this.nodes.length),this.estimatedSize},h.prototype.updateConnected=function(){var p=this;if(this.nodes.length==0){this.isConnected=!0;return}var v=new r,D=new Set,u=this.nodes[0],T,y,O=u.withChildren();for(O.forEach(function(m){v.push(m),D.add(m)});v.length!==0;){u=v.shift(),T=u.getEdges();for(var s=T.length,f=0;f<s;f++){var c=T[f];if(y=c.getOtherEndInGraph(u,this),y!=null&&!D.has(y)){var E=y.withChildren();E.forEach(function(m){v.push(m),D.add(m)})}}}if(this.isConnected=!1,D.size>=this.nodes.length){var A=0;D.forEach(function(m){m.owner==p&&A++}),A==this.nodes.length&&(this.isConnected=!0)}},N.exports=h}),(function(N,I,L){var o,e=L(1);function t(i){o=L(5),this.layout=i,this.graphs=[],this.edges=[]}t.prototype.addRoot=function(){var i=this.layout.newGraph(),l=this.layout.newNode(null),g=this.add(i,l);return this.setRootGraph(g),this.rootGraph},t.prototype.add=function(i,l,g,n,d){if(g==null&&n==null&&d==null){if(i==null)throw"Graph is null!";if(l==null)throw"Parent node is null!";if(this.graphs.indexOf(i)>-1)throw"Graph already in this graph mgr!";if(this.graphs.push(i),i.parent!=null)throw"Already has a parent!";if(l.child!=null)throw"Already has a child!";return i.parent=l,l.child=i,i}else{d=g,n=l,g=i;var r=n.getOwner(),h=d.getOwner();if(!(r!=null&&r.getGraphManager()==this))throw"Source not in this graph mgr!";if(!(h!=null&&h.getGraphManager()==this))throw"Target not in this graph mgr!";if(r==h)return g.isInterGraph=!1,r.add(g,n,d);if(g.isInterGraph=!0,g.source=n,g.target=d,this.edges.indexOf(g)>-1)throw"Edge already in inter-graph edge list!";if(this.edges.push(g),!(g.source!=null&&g.target!=null))throw"Edge source and/or target is null!";if(!(g.source.edges.indexOf(g)==-1&&g.target.edges.indexOf(g)==-1))throw"Edge already in source and/or target incidency list!";return g.source.edges.push(g),g.target.edges.push(g),g}},t.prototype.remove=function(i){if(i instanceof o){var l=i;if(l.getGraphManager()!=this)throw"Graph not in this graph mgr";if(!(l==this.rootGraph||l.parent!=null&&l.parent.graphManager==this))throw"Invalid parent node!";var g=[];g=g.concat(l.getEdges());for(var n,d=g.length,r=0;r<d;r++)n=g[r],l.remove(n);var h=[];h=h.concat(l.getNodes());var a;d=h.length;for(var r=0;r<d;r++)a=h[r],l.remove(a);l==this.rootGraph&&this.setRootGraph(null);var p=this.graphs.indexOf(l);this.graphs.splice(p,1),l.parent=null}else if(i instanceof e){if(n=i,n==null)throw"Edge is null!";if(!n.isInterGraph)throw"Not an inter-graph edge!";if(!(n.source!=null&&n.target!=null))throw"Source and/or target is null!";if(!(n.source.edges.indexOf(n)!=-1&&n.target.edges.indexOf(n)!=-1))throw"Source and/or target doesn't know this edge!";var p=n.source.edges.indexOf(n);if(n.source.edges.splice(p,1),p=n.target.edges.indexOf(n),n.target.edges.splice(p,1),!(n.source.owner!=null&&n.source.owner.getGraphManager()!=null))throw"Edge owner graph or owner graph manager is null!";if(n.source.owner.getGraphManager().edges.indexOf(n)==-1)throw"Not in owner graph manager's edge list!";var p=n.source.owner.getGraphManager().edges.indexOf(n);n.source.owner.getGraphManager().edges.splice(p,1)}},t.prototype.updateBounds=function(){this.rootGraph.updateBounds(!0)},t.prototype.getGraphs=function(){return this.graphs},t.prototype.getAllNodes=function(){if(this.allNodes==null){for(var i=[],l=this.getGraphs(),g=l.length,n=0;n<g;n++)i=i.concat(l[n].getNodes());this.allNodes=i}return this.allNodes},t.prototype.resetAllNodes=function(){this.allNodes=null},t.prototype.resetAllEdges=function(){this.allEdges=null},t.prototype.resetAllNodesToApplyGravitation=function(){this.allNodesToApplyGravitation=null},t.prototype.getAllEdges=function(){if(this.allEdges==null){var i=[],l=this.getGraphs();l.length;for(var g=0;g<l.length;g++)i=i.concat(l[g].getEdges());i=i.concat(this.edges),this.allEdges=i}return this.allEdges},t.prototype.getAllNodesToApplyGravitation=function(){return this.allNodesToApplyGravitation},t.prototype.setAllNodesToApplyGravitation=function(i){if(this.allNodesToApplyGravitation!=null)throw"assert failed";this.allNodesToApplyGravitation=i},t.prototype.getRoot=function(){return this.rootGraph},t.prototype.setRootGraph=function(i){if(i.getGraphManager()!=this)throw"Root not in this graph mgr!";this.rootGraph=i,i.parent==null&&(i.parent=this.layout.newNode("Root node"))},t.prototype.getLayout=function(){return this.layout},t.prototype.isOneAncestorOfOther=function(i,l){if(!(i!=null&&l!=null))throw"assert failed";if(i==l)return!0;var g=i.getOwner(),n;do{if(n=g.getParent(),n==null)break;if(n==l)return!0;if(g=n.getOwner(),g==null)break}while(!0);g=l.getOwner();do{if(n=g.getParent(),n==null)break;if(n==i)return!0;if(g=n.getOwner(),g==null)break}while(!0);return!1},t.prototype.calcLowestCommonAncestors=function(){for(var i,l,g,n,d,r=this.getAllEdges(),h=r.length,a=0;a<h;a++){if(i=r[a],l=i.source,g=i.target,i.lca=null,i.sourceInLca=l,i.targetInLca=g,l==g){i.lca=l.getOwner();continue}for(n=l.getOwner();i.lca==null;){for(i.targetInLca=g,d=g.getOwner();i.lca==null;){if(d==n){i.lca=d;break}if(d==this.rootGraph)break;if(i.lca!=null)throw"assert failed";i.targetInLca=d.getParent(),d=i.targetInLca.getOwner()}if(n==this.rootGraph)break;i.lca==null&&(i.sourceInLca=n.getParent(),n=i.sourceInLca.getOwner())}if(i.lca==null)throw"assert failed"}},t.prototype.calcLowestCommonAncestor=function(i,l){if(i==l)return i.getOwner();var g=i.getOwner();do{if(g==null)break;var n=l.getOwner();do{if(n==null)break;if(n==g)return n;n=n.getParent().getOwner()}while(!0);g=g.getParent().getOwner()}while(!0);return g},t.prototype.calcInclusionTreeDepths=function(i,l){i==null&&l==null&&(i=this.rootGraph,l=1);for(var g,n=i.getNodes(),d=n.length,r=0;r<d;r++)g=n[r],g.inclusionTreeDepth=l,g.child!=null&&this.calcInclusionTreeDepths(g.child,l+1)},t.prototype.includesInvalidEdge=function(){for(var i,l=this.edges.length,g=0;g<l;g++)if(i=this.edges[g],this.isOneAncestorOfOther(i.source,i.target))return!0;return!1},N.exports=t}),(function(N,I,L){var o=L(0);function e(){}for(var t in o)e[t]=o[t];e.MAX_ITERATIONS=2500,e.DEFAULT_EDGE_LENGTH=50,e.DEFAULT_SPRING_STRENGTH=.45,e.DEFAULT_REPULSION_STRENGTH=4500,e.DEFAULT_GRAVITY_STRENGTH=.4,e.DEFAULT_COMPOUND_GRAVITY_STRENGTH=1,e.DEFAULT_GRAVITY_RANGE_FACTOR=3.8,e.DEFAULT_COMPOUND_GRAVITY_RANGE_FACTOR=1.5,e.DEFAULT_USE_SMART_IDEAL_EDGE_LENGTH_CALCULATION=!0,e.DEFAULT_USE_SMART_REPULSION_RANGE_CALCULATION=!0,e.DEFAULT_COOLING_FACTOR_INCREMENTAL=.3,e.COOLING_ADAPTATION_FACTOR=.33,e.ADAPTATION_LOWER_NODE_LIMIT=1e3,e.ADAPTATION_UPPER_NODE_LIMIT=5e3,e.MAX_NODE_DISPLACEMENT_INCREMENTAL=100,e.MAX_NODE_DISPLACEMENT=e.MAX_NODE_DISPLACEMENT_INCREMENTAL*3,e.MIN_REPULSION_DIST=e.DEFAULT_EDGE_LENGTH/10,e.CONVERGENCE_CHECK_PERIOD=100,e.PER_LEVEL_IDEAL_EDGE_LENGTH_FACTOR=.1,e.MIN_EDGE_LENGTH=1,e.GRID_CALCULATION_CHECK_PERIOD=10,N.exports=e}),(function(N,I,L){var o=L(12);function e(){}e.calcSeparationAmount=function(t,i,l,g){if(!t.intersects(i))throw"assert failed";var n=new Array(2);this.decideDirectionsForOverlappingNodes(t,i,n),l[0]=Math.min(t.getRight(),i.getRight())-Math.max(t.x,i.x),l[1]=Math.min(t.getBottom(),i.getBottom())-Math.max(t.y,i.y),t.getX()<=i.getX()&&t.getRight()>=i.getRight()?l[0]+=Math.min(i.getX()-t.getX(),t.getRight()-i.getRight()):i.getX()<=t.getX()&&i.getRight()>=t.getRight()&&(l[0]+=Math.min(t.getX()-i.getX(),i.getRight()-t.getRight())),t.getY()<=i.getY()&&t.getBottom()>=i.getBottom()?l[1]+=Math.min(i.getY()-t.getY(),t.getBottom()-i.getBottom()):i.getY()<=t.getY()&&i.getBottom()>=t.getBottom()&&(l[1]+=Math.min(t.getY()-i.getY(),i.getBottom()-t.getBottom()));var d=Math.abs((i.getCenterY()-t.getCenterY())/(i.getCenterX()-t.getCenterX()));i.getCenterY()===t.getCenterY()&&i.getCenterX()===t.getCenterX()&&(d=1);var r=d*l[0],h=l[1]/d;l[0]<h?h=l[0]:r=l[1],l[0]=-1*n[0]*(h/2+g),l[1]=-1*n[1]*(r/2+g)},e.decideDirectionsForOverlappingNodes=function(t,i,l){t.getCenterX()<i.getCenterX()?l[0]=-1:l[0]=1,t.getCenterY()<i.getCenterY()?l[1]=-1:l[1]=1},e.getIntersection2=function(t,i,l){var g=t.getCenterX(),n=t.getCenterY(),d=i.getCenterX(),r=i.getCenterY();if(t.intersects(i))return l[0]=g,l[1]=n,l[2]=d,l[3]=r,!0;var h=t.getX(),a=t.getY(),p=t.getRight(),v=t.getX(),D=t.getBottom(),u=t.getRight(),T=t.getWidthHalf(),y=t.getHeightHalf(),O=i.getX(),s=i.getY(),f=i.getRight(),c=i.getX(),E=i.getBottom(),A=i.getRight(),m=i.getWidthHalf(),C=i.getHeightHalf(),R=!1,M=!1;if(g===d){if(n>r)return l[0]=g,l[1]=a,l[2]=d,l[3]=E,!1;if(n<r)return l[0]=g,l[1]=D,l[2]=d,l[3]=s,!1}else if(n===r){if(g>d)return l[0]=h,l[1]=n,l[2]=f,l[3]=r,!1;if(g<d)return l[0]=p,l[1]=n,l[2]=O,l[3]=r,!1}else{var S=t.height/t.width,Y=i.height/i.width,w=(r-n)/(d-g),x=void 0,F=void 0,U=void 0,P=void 0,_=void 0,X=void 0;if(-S===w?g>d?(l[0]=v,l[1]=D,R=!0):(l[0]=p,l[1]=a,R=!0):S===w&&(g>d?(l[0]=h,l[1]=a,R=!0):(l[0]=u,l[1]=D,R=!0)),-Y===w?d>g?(l[2]=c,l[3]=E,M=!0):(l[2]=f,l[3]=s,M=!0):Y===w&&(d>g?(l[2]=O,l[3]=s,M=!0):(l[2]=A,l[3]=E,M=!0)),R&&M)return!1;if(g>d?n>r?(x=this.getCardinalDirection(S,w,4),F=this.getCardinalDirection(Y,w,2)):(x=this.getCardinalDirection(-S,w,3),F=this.getCardinalDirection(-Y,w,1)):n>r?(x=this.getCardinalDirection(-S,w,1),F=this.getCardinalDirection(-Y,w,3)):(x=this.getCardinalDirection(S,w,2),F=this.getCardinalDirection(Y,w,4)),!R)switch(x){case 1:P=a,U=g+-y/w,l[0]=U,l[1]=P;break;case 2:U=u,P=n+T*w,l[0]=U,l[1]=P;break;case 3:P=D,U=g+y/w,l[0]=U,l[1]=P;break;case 4:U=v,P=n+-T*w,l[0]=U,l[1]=P;break}if(!M)switch(F){case 1:X=s,_=d+-C/w,l[2]=_,l[3]=X;break;case 2:_=A,X=r+m*w,l[2]=_,l[3]=X;break;case 3:X=E,_=d+C/w,l[2]=_,l[3]=X;break;case 4:_=c,X=r+-m*w,l[2]=_,l[3]=X;break}}return!1},e.getCardinalDirection=function(t,i,l){return t>i?l:1+l%4},e.getIntersection=function(t,i,l,g){if(g==null)return this.getIntersection2(t,i,l);var n=t.x,d=t.y,r=i.x,h=i.y,a=l.x,p=l.y,v=g.x,D=g.y,u=void 0,T=void 0,y=void 0,O=void 0,s=void 0,f=void 0,c=void 0,E=void 0,A=void 0;return y=h-d,s=n-r,c=r*d-n*h,O=D-p,f=a-v,E=v*p-a*D,A=y*f-O*s,A===0?null:(u=(s*E-f*c)/A,T=(O*c-y*E)/A,new o(u,T))},e.angleOfVector=function(t,i,l,g){var n=void 0;return t!==l?(n=Math.atan((g-i)/(l-t)),l<t?n+=Math.PI:g<i&&(n+=this.TWO_PI)):g<i?n=this.ONE_AND_HALF_PI:n=this.HALF_PI,n},e.doIntersect=function(t,i,l,g){var n=t.x,d=t.y,r=i.x,h=i.y,a=l.x,p=l.y,v=g.x,D=g.y,u=(r-n)*(D-p)-(v-a)*(h-d);if(u===0)return!1;var T=((D-p)*(v-n)+(a-v)*(D-d))/u,y=((d-h)*(v-n)+(r-n)*(D-d))/u;return 0<T&&T<1&&0<y&&y<1},e.HALF_PI=.5*Math.PI,e.ONE_AND_HALF_PI=1.5*Math.PI,e.TWO_PI=2*Math.PI,e.THREE_PI=3*Math.PI,N.exports=e}),(function(N,I,L){function o(){}o.sign=function(e){return e>0?1:e<0?-1:0},o.floor=function(e){return e<0?Math.ceil(e):Math.floor(e)},o.ceil=function(e){return e<0?Math.floor(e):Math.ceil(e)},N.exports=o}),(function(N,I,L){function o(){}o.MAX_VALUE=2147483647,o.MIN_VALUE=-2147483648,N.exports=o}),(function(N,I,L){var o=(function(){function n(d,r){for(var h=0;h<r.length;h++){var a=r[h];a.enumerable=a.enumerable||!1,a.configurable=!0,"value"in a&&(a.writable=!0),Object.defineProperty(d,a.key,a)}}return function(d,r,h){return r&&n(d.prototype,r),h&&n(d,h),d}})();function e(n,d){if(!(n instanceof d))throw new TypeError("Cannot call a class as a function")}var t=function(d){return{value:d,next:null,prev:null}},i=function(d,r,h,a){return d!==null?d.next=r:a.head=r,h!==null?h.prev=r:a.tail=r,r.prev=d,r.next=h,a.length++,r},l=function(d,r){var h=d.prev,a=d.next;return h!==null?h.next=a:r.head=a,a!==null?a.prev=h:r.tail=h,d.prev=d.next=null,r.length--,d},g=(function(){function n(d){var r=this;e(this,n),this.length=0,this.head=null,this.tail=null,d?.forEach(function(h){return r.push(h)})}return o(n,[{key:"size",value:function(){return this.length}},{key:"insertBefore",value:function(r,h){return i(h.prev,t(r),h,this)}},{key:"insertAfter",value:function(r,h){return i(h,t(r),h.next,this)}},{key:"insertNodeBefore",value:function(r,h){return i(h.prev,r,h,this)}},{key:"insertNodeAfter",value:function(r,h){return i(h,r,h.next,this)}},{key:"push",value:function(r){return i(this.tail,t(r),null,this)}},{key:"unshift",value:function(r){return i(null,t(r),this.head,this)}},{key:"remove",value:function(r){return l(r,this)}},{key:"pop",value:function(){return l(this.tail,this).value}},{key:"popNode",value:function(){return l(this.tail,this)}},{key:"shift",value:function(){return l(this.head,this).value}},{key:"shiftNode",value:function(){return l(this.head,this)}},{key:"get_object_at",value:function(r){if(r<=this.length()){for(var h=1,a=this.head;h<r;)a=a.next,h++;return a.value}}},{key:"set_object_at",value:function(r,h){if(r<=this.length()){for(var a=1,p=this.head;a<r;)p=p.next,a++;p.value=h}}}]),n})();N.exports=g}),(function(N,I,L){function o(e,t,i){this.x=null,this.y=null,e==null&&t==null&&i==null?(this.x=0,this.y=0):typeof e=="number"&&typeof t=="number"&&i==null?(this.x=e,this.y=t):e.constructor.name=="Point"&&t==null&&i==null&&(i=e,this.x=i.x,this.y=i.y)}o.prototype.getX=function(){return this.x},o.prototype.getY=function(){return this.y},o.prototype.getLocation=function(){return new o(this.x,this.y)},o.prototype.setLocation=function(e,t,i){e.constructor.name=="Point"&&t==null&&i==null?(i=e,this.setLocation(i.x,i.y)):typeof e=="number"&&typeof t=="number"&&i==null&&(parseInt(e)==e&&parseInt(t)==t?this.move(e,t):(this.x=Math.floor(e+.5),this.y=Math.floor(t+.5)))},o.prototype.move=function(e,t){this.x=e,this.y=t},o.prototype.translate=function(e,t){this.x+=e,this.y+=t},o.prototype.equals=function(e){if(e.constructor.name=="Point"){var t=e;return this.x==t.x&&this.y==t.y}return this==e},o.prototype.toString=function(){return new o().constructor.name+"[x="+this.x+",y="+this.y+"]"},N.exports=o}),(function(N,I,L){function o(e,t,i,l){this.x=0,this.y=0,this.width=0,this.height=0,e!=null&&t!=null&&i!=null&&l!=null&&(this.x=e,this.y=t,this.width=i,this.height=l)}o.prototype.getX=function(){return this.x},o.prototype.setX=function(e){this.x=e},o.prototype.getY=function(){return this.y},o.prototype.setY=function(e){this.y=e},o.prototype.getWidth=function(){return this.width},o.prototype.setWidth=function(e){this.width=e},o.prototype.getHeight=function(){return this.height},o.prototype.setHeight=function(e){this.height=e},o.prototype.getRight=function(){return this.x+this.width},o.prototype.getBottom=function(){return this.y+this.height},o.prototype.intersects=function(e){return!(this.getRight()<e.x||this.getBottom()<e.y||e.getRight()<this.x||e.getBottom()<this.y)},o.prototype.getCenterX=function(){return this.x+this.width/2},o.prototype.getMinX=function(){return this.getX()},o.prototype.getMaxX=function(){return this.getX()+this.width},o.prototype.getCenterY=function(){return this.y+this.height/2},o.prototype.getMinY=function(){return this.getY()},o.prototype.getMaxY=function(){return this.getY()+this.height},o.prototype.getWidthHalf=function(){return this.width/2},o.prototype.getHeightHalf=function(){return this.height/2},N.exports=o}),(function(N,I,L){var o=typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?function(t){return typeof t}:function(t){return t&&typeof Symbol=="function"&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t};function e(){}e.lastID=0,e.createID=function(t){return e.isPrimitive(t)?t:(t.uniqueID!=null||(t.uniqueID=e.getString(),e.lastID++),t.uniqueID)},e.getString=function(t){return t==null&&(t=e.lastID),"Object#"+t},e.isPrimitive=function(t){var i=typeof t>"u"?"undefined":o(t);return t==null||i!="object"&&i!="function"},N.exports=e}),(function(N,I,L){function o(a){if(Array.isArray(a)){for(var p=0,v=Array(a.length);p<a.length;p++)v[p]=a[p];return v}else return Array.from(a)}var e=L(0),t=L(6),i=L(3),l=L(1),g=L(5),n=L(4),d=L(17),r=L(27);function h(a){r.call(this),this.layoutQuality=e.QUALITY,this.createBendsAsNeeded=e.DEFAULT_CREATE_BENDS_AS_NEEDED,this.incremental=e.DEFAULT_INCREMENTAL,this.animationOnLayout=e.DEFAULT_ANIMATION_ON_LAYOUT,this.animationDuringLayout=e.DEFAULT_ANIMATION_DURING_LAYOUT,this.animationPeriod=e.DEFAULT_ANIMATION_PERIOD,this.uniformLeafNodeSizes=e.DEFAULT_UNIFORM_LEAF_NODE_SIZES,this.edgeToDummyNodes=new Map,this.graphManager=new t(this),this.isLayoutFinished=!1,this.isSubLayout=!1,this.isRemoteUse=!1,a!=null&&(this.isRemoteUse=a)}h.RANDOM_SEED=1,h.prototype=Object.create(r.prototype),h.prototype.getGraphManager=function(){return this.graphManager},h.prototype.getAllNodes=function(){return this.graphManager.getAllNodes()},h.prototype.getAllEdges=function(){return this.graphManager.getAllEdges()},h.prototype.getAllNodesToApplyGravitation=function(){return this.graphManager.getAllNodesToApplyGravitation()},h.prototype.newGraphManager=function(){var a=new t(this);return this.graphManager=a,a},h.prototype.newGraph=function(a){return new g(null,this.graphManager,a)},h.prototype.newNode=function(a){return new i(this.graphManager,a)},h.prototype.newEdge=function(a){return new l(null,null,a)},h.prototype.checkLayoutSuccess=function(){return this.graphManager.getRoot()==null||this.graphManager.getRoot().getNodes().length==0||this.graphManager.includesInvalidEdge()},h.prototype.runLayout=function(){this.isLayoutFinished=!1,this.tilingPreLayout&&this.tilingPreLayout(),this.initParameters();var a;return this.checkLayoutSuccess()?a=!1:a=this.layout(),e.ANIMATE==="during"?!1:(a&&(this.isSubLayout||this.doPostLayout()),this.tilingPostLayout&&this.tilingPostLayout(),this.isLayoutFinished=!0,a)},h.prototype.doPostLayout=function(){this.incremental||this.transform(),this.update()},h.prototype.update2=function(){if(this.createBendsAsNeeded&&(this.createBendpointsFromDummyNodes(),this.graphManager.resetAllEdges()),!this.isRemoteUse){for(var a=this.graphManager.getAllEdges(),p=0;p<a.length;p++)a[p];for(var v=this.graphManager.getRoot().getNodes(),p=0;p<v.length;p++)v[p];this.update(this.graphManager.getRoot())}},h.prototype.update=function(a){if(a==null)this.update2();else if(a instanceof i){var p=a;if(p.getChild()!=null)for(var v=p.getChild().getNodes(),D=0;D<v.length;D++)update(v[D]);if(p.vGraphObject!=null){var u=p.vGraphObject;u.update(p)}}else if(a instanceof l){var T=a;if(T.vGraphObject!=null){var y=T.vGraphObject;y.update(T)}}else if(a instanceof g){var O=a;if(O.vGraphObject!=null){var s=O.vGraphObject;s.update(O)}}},h.prototype.initParameters=function(){this.isSubLayout||(this.layoutQuality=e.QUALITY,this.animationDuringLayout=e.DEFAULT_ANIMATION_DURING_LAYOUT,this.animationPeriod=e.DEFAULT_ANIMATION_PERIOD,this.animationOnLayout=e.DEFAULT_ANIMATION_ON_LAYOUT,this.incremental=e.DEFAULT_INCREMENTAL,this.createBendsAsNeeded=e.DEFAULT_CREATE_BENDS_AS_NEEDED,this.uniformLeafNodeSizes=e.DEFAULT_UNIFORM_LEAF_NODE_SIZES),this.animationDuringLayout&&(this.animationOnLayout=!1)},h.prototype.transform=function(a){if(a==null)this.transform(new n(0,0));else{var p=new d,v=this.graphManager.getRoot().updateLeftTop();if(v!=null){p.setWorldOrgX(a.x),p.setWorldOrgY(a.y),p.setDeviceOrgX(v.x),p.setDeviceOrgY(v.y);for(var D=this.getAllNodes(),u,T=0;T<D.length;T++)u=D[T],u.transform(p)}}},h.prototype.positionNodesRandomly=function(a){if(a==null)this.positionNodesRandomly(this.getGraphManager().getRoot()),this.getGraphManager().getRoot().updateBounds(!0);else for(var p,v,D=a.getNodes(),u=0;u<D.length;u++)p=D[u],v=p.getChild(),v==null||v.getNodes().length==0?p.scatter():(this.positionNodesRandomly(v),p.updateBounds())},h.prototype.getFlatForest=function(){for(var a=[],p=!0,v=this.graphManager.getRoot().getNodes(),D=!0,u=0;u<v.length;u++)v[u].getChild()!=null&&(D=!1);if(!D)return a;var T=new Set,y=[],O=new Map,s=[];for(s=s.concat(v);s.length>0&&p;){for(y.push(s[0]);y.length>0&&p;){var f=y[0];y.splice(0,1),T.add(f);for(var c=f.getEdges(),u=0;u<c.length;u++){var E=c[u].getOtherEnd(f);if(O.get(f)!=E)if(!T.has(E))y.push(E),O.set(E,f);else{p=!1;break}}}if(!p)a=[];else{var A=[].concat(o(T));a.push(A);for(var u=0;u<A.length;u++){var m=A[u],C=s.indexOf(m);C>-1&&s.splice(C,1)}T=new Set,O=new Map}}return a},h.prototype.createDummyNodesForBendpoints=function(a){for(var p=[],v=a.source,D=this.graphManager.calcLowestCommonAncestor(a.source,a.target),u=0;u<a.bendpoints.length;u++){var T=this.newNode(null);T.setRect(new Point(0,0),new Dimension(1,1)),D.add(T);var y=this.newEdge(null);this.graphManager.add(y,v,T),p.add(T),v=T}var y=this.newEdge(null);return this.graphManager.add(y,v,a.target),this.edgeToDummyNodes.set(a,p),a.isInterGraph()?this.graphManager.remove(a):D.remove(a),p},h.prototype.createBendpointsFromDummyNodes=function(){var a=[];a=a.concat(this.graphManager.getAllEdges()),a=[].concat(o(this.edgeToDummyNodes.keys())).concat(a);for(var p=0;p<a.length;p++){var v=a[p];if(v.bendpoints.length>0){for(var D=this.edgeToDummyNodes.get(v),u=0;u<D.length;u++){var T=D[u],y=new n(T.getCenterX(),T.getCenterY()),O=v.bendpoints.get(u);O.x=y.x,O.y=y.y,T.getOwner().remove(T)}this.graphManager.add(v,v.source,v.target)}}},h.transform=function(a,p,v,D){if(v!=null&&D!=null){var u=p;if(a<=50){var T=p/v;u-=(p-T)/50*(50-a)}else{var y=p*D;u+=(y-p)/50*(a-50)}return u}else{var O,s;return a<=50?(O=9*p/500,s=p/10):(O=9*p/50,s=-8*p),O*a+s}},h.findCenterOfTree=function(a){var p=[];p=p.concat(a);var v=[],D=new Map,u=!1,T=null;(p.length==1||p.length==2)&&(u=!0,T=p[0]);for(var y=0;y<p.length;y++){var O=p[y],s=O.getNeighborsList().size;D.set(O,O.getNeighborsList().size),s==1&&v.push(O)}var f=[];for(f=f.concat(v);!u;){var c=[];c=c.concat(f),f=[];for(var y=0;y<p.length;y++){var O=p[y],E=p.indexOf(O);E>=0&&p.splice(E,1);var A=O.getNeighborsList();A.forEach(function(R){if(v.indexOf(R)<0){var M=D.get(R),S=M-1;S==1&&f.push(R),D.set(R,S)}})}v=v.concat(f),(p.length==1||p.length==2)&&(u=!0,T=p[0])}return T},h.prototype.setGraphManager=function(a){this.graphManager=a},N.exports=h}),(function(N,I,L){function o(){}o.seed=1,o.x=0,o.nextDouble=function(){return o.x=Math.sin(o.seed++)*1e4,o.x-Math.floor(o.x)},N.exports=o}),(function(N,I,L){var o=L(4);function e(t,i){this.lworldOrgX=0,this.lworldOrgY=0,this.ldeviceOrgX=0,this.ldeviceOrgY=0,this.lworldExtX=1,this.lworldExtY=1,this.ldeviceExtX=1,this.ldeviceExtY=1}e.prototype.getWorldOrgX=function(){return this.lworldOrgX},e.prototype.setWorldOrgX=function(t){this.lworldOrgX=t},e.prototype.getWorldOrgY=function(){return this.lworldOrgY},e.prototype.setWorldOrgY=function(t){this.lworldOrgY=t},e.prototype.getWorldExtX=function(){return this.lworldExtX},e.prototype.setWorldExtX=function(t){this.lworldExtX=t},e.prototype.getWorldExtY=function(){return this.lworldExtY},e.prototype.setWorldExtY=function(t){this.lworldExtY=t},e.prototype.getDeviceOrgX=function(){return this.ldeviceOrgX},e.prototype.setDeviceOrgX=function(t){this.ldeviceOrgX=t},e.prototype.getDeviceOrgY=function(){return this.ldeviceOrgY},e.prototype.setDeviceOrgY=function(t){this.ldeviceOrgY=t},e.prototype.getDeviceExtX=function(){return this.ldeviceExtX},e.prototype.setDeviceExtX=function(t){this.ldeviceExtX=t},e.prototype.getDeviceExtY=function(){return this.ldeviceExtY},e.prototype.setDeviceExtY=function(t){this.ldeviceExtY=t},e.prototype.transformX=function(t){var i=0,l=this.lworldExtX;return l!=0&&(i=this.ldeviceOrgX+(t-this.lworldOrgX)*this.ldeviceExtX/l),i},e.prototype.transformY=function(t){var i=0,l=this.lworldExtY;return l!=0&&(i=this.ldeviceOrgY+(t-this.lworldOrgY)*this.ldeviceExtY/l),i},e.prototype.inverseTransformX=function(t){var i=0,l=this.ldeviceExtX;return l!=0&&(i=this.lworldOrgX+(t-this.ldeviceOrgX)*this.lworldExtX/l),i},e.prototype.inverseTransformY=function(t){var i=0,l=this.ldeviceExtY;return l!=0&&(i=this.lworldOrgY+(t-this.ldeviceOrgY)*this.lworldExtY/l),i},e.prototype.inverseTransformPoint=function(t){var i=new o(this.inverseTransformX(t.x),this.inverseTransformY(t.y));return i},N.exports=e}),(function(N,I,L){function o(r){if(Array.isArray(r)){for(var h=0,a=Array(r.length);h<r.length;h++)a[h]=r[h];return a}else return Array.from(r)}var e=L(15),t=L(7),i=L(0),l=L(8),g=L(9);function n(){e.call(this),this.useSmartIdealEdgeLengthCalculation=t.DEFAULT_USE_SMART_IDEAL_EDGE_LENGTH_CALCULATION,this.idealEdgeLength=t.DEFAULT_EDGE_LENGTH,this.springConstant=t.DEFAULT_SPRING_STRENGTH,this.repulsionConstant=t.DEFAULT_REPULSION_STRENGTH,this.gravityConstant=t.DEFAULT_GRAVITY_STRENGTH,this.compoundGravityConstant=t.DEFAULT_COMPOUND_GRAVITY_STRENGTH,this.gravityRangeFactor=t.DEFAULT_GRAVITY_RANGE_FACTOR,this.compoundGravityRangeFactor=t.DEFAULT_COMPOUND_GRAVITY_RANGE_FACTOR,this.displacementThresholdPerNode=3*t.DEFAULT_EDGE_LENGTH/100,this.coolingFactor=t.DEFAULT_COOLING_FACTOR_INCREMENTAL,this.initialCoolingFactor=t.DEFAULT_COOLING_FACTOR_INCREMENTAL,this.totalDisplacement=0,this.oldTotalDisplacement=0,this.maxIterations=t.MAX_ITERATIONS}n.prototype=Object.create(e.prototype);for(var d in e)n[d]=e[d];n.prototype.initParameters=function(){e.prototype.initParameters.call(this,arguments),this.totalIterations=0,this.notAnimatedIterations=0,this.useFRGridVariant=t.DEFAULT_USE_SMART_REPULSION_RANGE_CALCULATION,this.grid=[]},n.prototype.calcIdealEdgeLengths=function(){for(var r,h,a,p,v,D,u=this.getGraphManager().getAllEdges(),T=0;T<u.length;T++)r=u[T],r.idealLength=this.idealEdgeLength,r.isInterGraph&&(a=r.getSource(),p=r.getTarget(),v=r.getSourceInLca().getEstimatedSize(),D=r.getTargetInLca().getEstimatedSize(),this.useSmartIdealEdgeLengthCalculation&&(r.idealLength+=v+D-2*i.SIMPLE_NODE_SIZE),h=r.getLca().getInclusionTreeDepth(),r.idealLength+=t.DEFAULT_EDGE_LENGTH*t.PER_LEVEL_IDEAL_EDGE_LENGTH_FACTOR*(a.getInclusionTreeDepth()+p.getInclusionTreeDepth()-2*h))},n.prototype.initSpringEmbedder=function(){var r=this.getAllNodes().length;this.incremental?(r>t.ADAPTATION_LOWER_NODE_LIMIT&&(this.coolingFactor=Math.max(this.coolingFactor*t.COOLING_ADAPTATION_FACTOR,this.coolingFactor-(r-t.ADAPTATION_LOWER_NODE_LIMIT)/(t.ADAPTATION_UPPER_NODE_LIMIT-t.ADAPTATION_LOWER_NODE_LIMIT)*this.coolingFactor*(1-t.COOLING_ADAPTATION_FACTOR))),this.maxNodeDisplacement=t.MAX_NODE_DISPLACEMENT_INCREMENTAL):(r>t.ADAPTATION_LOWER_NODE_LIMIT?this.coolingFactor=Math.max(t.COOLING_ADAPTATION_FACTOR,1-(r-t.ADAPTATION_LOWER_NODE_LIMIT)/(t.ADAPTATION_UPPER_NODE_LIMIT-t.ADAPTATION_LOWER_NODE_LIMIT)*(1-t.COOLING_ADAPTATION_FACTOR)):this.coolingFactor=1,this.initialCoolingFactor=this.coolingFactor,this.maxNodeDisplacement=t.MAX_NODE_DISPLACEMENT),this.maxIterations=Math.max(this.getAllNodes().length*5,this.maxIterations),this.totalDisplacementThreshold=this.displacementThresholdPerNode*this.getAllNodes().length,this.repulsionRange=this.calcRepulsionRange()},n.prototype.calcSpringForces=function(){for(var r=this.getAllEdges(),h,a=0;a<r.length;a++)h=r[a],this.calcSpringForce(h,h.idealLength)},n.prototype.calcRepulsionForces=function(){var r=arguments.length>0&&arguments[0]!==void 0?arguments[0]:!0,h=arguments.length>1&&arguments[1]!==void 0?arguments[1]:!1,a,p,v,D,u=this.getAllNodes(),T;if(this.useFRGridVariant)for(this.totalIterations%t.GRID_CALCULATION_CHECK_PERIOD==1&&r&&this.updateGrid(),T=new Set,a=0;a<u.length;a++)v=u[a],this.calculateRepulsionForceOfANode(v,T,r,h),T.add(v);else for(a=0;a<u.length;a++)for(v=u[a],p=a+1;p<u.length;p++)D=u[p],v.getOwner()==D.getOwner()&&this.calcRepulsionForce(v,D)},n.prototype.calcGravitationalForces=function(){for(var r,h=this.getAllNodesToApplyGravitation(),a=0;a<h.length;a++)r=h[a],this.calcGravitationalForce(r)},n.prototype.moveNodes=function(){for(var r=this.getAllNodes(),h,a=0;a<r.length;a++)h=r[a],h.move()},n.prototype.calcSpringForce=function(r,h){var a=r.getSource(),p=r.getTarget(),v,D,u,T;if(this.uniformLeafNodeSizes&&a.getChild()==null&&p.getChild()==null)r.updateLengthSimple();else if(r.updateLength(),r.isOverlapingSourceAndTarget)return;v=r.getLength(),v!=0&&(D=this.springConstant*(v-h),u=D*(r.lengthX/v),T=D*(r.lengthY/v),a.springForceX+=u,a.springForceY+=T,p.springForceX-=u,p.springForceY-=T)},n.prototype.calcRepulsionForce=function(r,h){var a=r.getRect(),p=h.getRect(),v=new Array(2),D=new Array(4),u,T,y,O,s,f,c;if(a.intersects(p)){l.calcSeparationAmount(a,p,v,t.DEFAULT_EDGE_LENGTH/2),f=2*v[0],c=2*v[1];var E=r.noOfChildren*h.noOfChildren/(r.noOfChildren+h.noOfChildren);r.repulsionForceX-=E*f,r.repulsionForceY-=E*c,h.repulsionForceX+=E*f,h.repulsionForceY+=E*c}else this.uniformLeafNodeSizes&&r.getChild()==null&&h.getChild()==null?(u=p.getCenterX()-a.getCenterX(),T=p.getCenterY()-a.getCenterY()):(l.getIntersection(a,p,D),u=D[2]-D[0],T=D[3]-D[1]),Math.abs(u)<t.MIN_REPULSION_DIST&&(u=g.sign(u)*t.MIN_REPULSION_DIST),Math.abs(T)<t.MIN_REPULSION_DIST&&(T=g.sign(T)*t.MIN_REPULSION_DIST),y=u*u+T*T,O=Math.sqrt(y),s=this.repulsionConstant*r.noOfChildren*h.noOfChildren/y,f=s*u/O,c=s*T/O,r.repulsionForceX-=f,r.repulsionForceY-=c,h.repulsionForceX+=f,h.repulsionForceY+=c},n.prototype.calcGravitationalForce=function(r){var h,a,p,v,D,u,T,y;h=r.getOwner(),a=(h.getRight()+h.getLeft())/2,p=(h.getTop()+h.getBottom())/2,v=r.getCenterX()-a,D=r.getCenterY()-p,u=Math.abs(v)+r.getWidth()/2,T=Math.abs(D)+r.getHeight()/2,r.getOwner()==this.graphManager.getRoot()?(y=h.getEstimatedSize()*this.gravityRangeFactor,(u>y||T>y)&&(r.gravitationForceX=-this.gravityConstant*v,r.gravitationForceY=-this.gravityConstant*D)):(y=h.getEstimatedSize()*this.compoundGravityRangeFactor,(u>y||T>y)&&(r.gravitationForceX=-this.gravityConstant*v*this.compoundGravityConstant,r.gravitationForceY=-this.gravityConstant*D*this.compoundGravityConstant))},n.prototype.isConverged=function(){var r,h=!1;return this.totalIterations>this.maxIterations/3&&(h=Math.abs(this.totalDisplacement-this.oldTotalDisplacement)<2),r=this.totalDisplacement<this.totalDisplacementThreshold,this.oldTotalDisplacement=this.totalDisplacement,r||h},n.prototype.animate=function(){this.animationDuringLayout&&!this.isSubLayout&&(this.notAnimatedIterations==this.animationPeriod?(this.update(),this.notAnimatedIterations=0):this.notAnimatedIterations++)},n.prototype.calcNoOfChildrenForAllNodes=function(){for(var r,h=this.graphManager.getAllNodes(),a=0;a<h.length;a++)r=h[a],r.noOfChildren=r.getNoOfChildren()},n.prototype.calcGrid=function(r){var h=0,a=0;h=parseInt(Math.ceil((r.getRight()-r.getLeft())/this.repulsionRange)),a=parseInt(Math.ceil((r.getBottom()-r.getTop())/this.repulsionRange));for(var p=new Array(h),v=0;v<h;v++)p[v]=new Array(a);for(var v=0;v<h;v++)for(var D=0;D<a;D++)p[v][D]=new Array;return p},n.prototype.addNodeToGrid=function(r,h,a){var p=0,v=0,D=0,u=0;p=parseInt(Math.floor((r.getRect().x-h)/this.repulsionRange)),v=parseInt(Math.floor((r.getRect().width+r.getRect().x-h)/this.repulsionRange)),D=parseInt(Math.floor((r.getRect().y-a)/this.repulsionRange)),u=parseInt(Math.floor((r.getRect().height+r.getRect().y-a)/this.repulsionRange));for(var T=p;T<=v;T++)for(var y=D;y<=u;y++)this.grid[T][y].push(r),r.setGridCoordinates(p,v,D,u)},n.prototype.updateGrid=function(){var r,h,a=this.getAllNodes();for(this.grid=this.calcGrid(this.graphManager.getRoot()),r=0;r<a.length;r++)h=a[r],this.addNodeToGrid(h,this.graphManager.getRoot().getLeft(),this.graphManager.getRoot().getTop())},n.prototype.calculateRepulsionForceOfANode=function(r,h,a,p){if(this.totalIterations%t.GRID_CALCULATION_CHECK_PERIOD==1&&a||p){var v=new Set;r.surrounding=new Array;for(var D,u=this.grid,T=r.startX-1;T<r.finishX+2;T++)for(var y=r.startY-1;y<r.finishY+2;y++)if(!(T<0||y<0||T>=u.length||y>=u[0].length)){for(var O=0;O<u[T][y].length;O++)if(D=u[T][y][O],!(r.getOwner()!=D.getOwner()||r==D)&&!h.has(D)&&!v.has(D)){var s=Math.abs(r.getCenterX()-D.getCenterX())-(r.getWidth()/2+D.getWidth()/2),f=Math.abs(r.getCenterY()-D.getCenterY())-(r.getHeight()/2+D.getHeight()/2);s<=this.repulsionRange&&f<=this.repulsionRange&&v.add(D)}}r.surrounding=[].concat(o(v))}for(T=0;T<r.surrounding.length;T++)this.calcRepulsionForce(r,r.surrounding[T])},n.prototype.calcRepulsionRange=function(){return 0},N.exports=n}),(function(N,I,L){var o=L(1),e=L(7);function t(l,g,n){o.call(this,l,g,n),this.idealLength=e.DEFAULT_EDGE_LENGTH}t.prototype=Object.create(o.prototype);for(var i in o)t[i]=o[i];N.exports=t}),(function(N,I,L){var o=L(3);function e(i,l,g,n){o.call(this,i,l,g,n),this.springForceX=0,this.springForceY=0,this.repulsionForceX=0,this.repulsionForceY=0,this.gravitationForceX=0,this.gravitationForceY=0,this.displacementX=0,this.displacementY=0,this.startX=0,this.finishX=0,this.startY=0,this.finishY=0,this.surrounding=[]}e.prototype=Object.create(o.prototype);for(var t in o)e[t]=o[t];e.prototype.setGridCoordinates=function(i,l,g,n){this.startX=i,this.finishX=l,this.startY=g,this.finishY=n},N.exports=e}),(function(N,I,L){function o(e,t){this.width=0,this.height=0,e!==null&&t!==null&&(this.height=t,this.width=e)}o.prototype.getWidth=function(){return this.width},o.prototype.setWidth=function(e){this.width=e},o.prototype.getHeight=function(){return this.height},o.prototype.setHeight=function(e){this.height=e},N.exports=o}),(function(N,I,L){var o=L(14);function e(){this.map={},this.keys=[]}e.prototype.put=function(t,i){var l=o.createID(t);this.contains(l)||(this.map[l]=i,this.keys.push(t))},e.prototype.contains=function(t){return o.createID(t),this.map[t]!=null},e.prototype.get=function(t){var i=o.createID(t);return this.map[i]},e.prototype.keySet=function(){return this.keys},N.exports=e}),(function(N,I,L){var o=L(14);function e(){this.set={}}e.prototype.add=function(t){var i=o.createID(t);this.contains(i)||(this.set[i]=t)},e.prototype.remove=function(t){delete this.set[o.createID(t)]},e.prototype.clear=function(){this.set={}},e.prototype.contains=function(t){return this.set[o.createID(t)]==t},e.prototype.isEmpty=function(){return this.size()===0},e.prototype.size=function(){return Object.keys(this.set).length},e.prototype.addAllTo=function(t){for(var i=Object.keys(this.set),l=i.length,g=0;g<l;g++)t.push(this.set[i[g]])},e.prototype.size=function(){return Object.keys(this.set).length},e.prototype.addAll=function(t){for(var i=t.length,l=0;l<i;l++){var g=t[l];this.add(g)}},N.exports=e}),(function(N,I,L){var o=(function(){function l(g,n){for(var d=0;d<n.length;d++){var r=n[d];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(g,r.key,r)}}return function(g,n,d){return n&&l(g.prototype,n),d&&l(g,d),g}})();function e(l,g){if(!(l instanceof g))throw new TypeError("Cannot call a class as a function")}var t=L(11),i=(function(){function l(g,n){e(this,l),(n!==null||n!==void 0)&&(this.compareFunction=this._defaultCompareFunction);var d=void 0;g instanceof t?d=g.size():d=g.length,this._quicksort(g,0,d-1)}return o(l,[{key:"_quicksort",value:function(n,d,r){if(d<r){var h=this._partition(n,d,r);this._quicksort(n,d,h),this._quicksort(n,h+1,r)}}},{key:"_partition",value:function(n,d,r){for(var h=this._get(n,d),a=d,p=r;;){for(;this.compareFunction(h,this._get(n,p));)p--;for(;this.compareFunction(this._get(n,a),h);)a++;if(a<p)this._swap(n,a,p),a++,p--;else return p}}},{key:"_get",value:function(n,d){return n instanceof t?n.get_object_at(d):n[d]}},{key:"_set",value:function(n,d,r){n instanceof t?n.set_object_at(d,r):n[d]=r}},{key:"_swap",value:function(n,d,r){var h=this._get(n,d);this._set(n,d,this._get(n,r)),this._set(n,r,h)}},{key:"_defaultCompareFunction",value:function(n,d){return d>n}}]),l})();N.exports=i}),(function(N,I,L){var o=(function(){function i(l,g){for(var n=0;n<g.length;n++){var d=g[n];d.enumerable=d.enumerable||!1,d.configurable=!0,"value"in d&&(d.writable=!0),Object.defineProperty(l,d.key,d)}}return function(l,g,n){return g&&i(l.prototype,g),n&&i(l,n),l}})();function e(i,l){if(!(i instanceof l))throw new TypeError("Cannot call a class as a function")}var t=(function(){function i(l,g){var n=arguments.length>2&&arguments[2]!==void 0?arguments[2]:1,d=arguments.length>3&&arguments[3]!==void 0?arguments[3]:-1,r=arguments.length>4&&arguments[4]!==void 0?arguments[4]:-1;e(this,i),this.sequence1=l,this.sequence2=g,this.match_score=n,this.mismatch_penalty=d,this.gap_penalty=r,this.iMax=l.length+1,this.jMax=g.length+1,this.grid=new Array(this.iMax);for(var h=0;h<this.iMax;h++){this.grid[h]=new Array(this.jMax);for(var a=0;a<this.jMax;a++)this.grid[h][a]=0}this.tracebackGrid=new Array(this.iMax);for(var p=0;p<this.iMax;p++){this.tracebackGrid[p]=new Array(this.jMax);for(var v=0;v<this.jMax;v++)this.tracebackGrid[p][v]=[null,null,null]}this.alignments=[],this.score=-1,this.computeGrids()}return o(i,[{key:"getScore",value:function(){return this.score}},{key:"getAlignments",value:function(){return this.alignments}},{key:"computeGrids",value:function(){for(var g=1;g<this.jMax;g++)this.grid[0][g]=this.grid[0][g-1]+this.gap_penalty,this.tracebackGrid[0][g]=[!1,!1,!0];for(var n=1;n<this.iMax;n++)this.grid[n][0]=this.grid[n-1][0]+this.gap_penalty,this.tracebackGrid[n][0]=[!1,!0,!1];for(var d=1;d<this.iMax;d++)for(var r=1;r<this.jMax;r++){var h=void 0;this.sequence1[d-1]===this.sequence2[r-1]?h=this.grid[d-1][r-1]+this.match_score:h=this.grid[d-1][r-1]+this.mismatch_penalty;var a=this.grid[d-1][r]+this.gap_penalty,p=this.grid[d][r-1]+this.gap_penalty,v=[h,a,p],D=this.arrayAllMaxIndexes(v);this.grid[d][r]=v[D[0]],this.tracebackGrid[d][r]=[D.includes(0),D.includes(1),D.includes(2)]}this.score=this.grid[this.iMax-1][this.jMax-1]}},{key:"alignmentTraceback",value:function(){var g=[];for(g.push({pos:[this.sequence1.length,this.sequence2.length],seq1:"",seq2:""});g[0];){var n=g[0],d=this.tracebackGrid[n.pos[0]][n.pos[1]];d[0]&&g.push({pos:[n.pos[0]-1,n.pos[1]-1],seq1:this.sequence1[n.pos[0]-1]+n.seq1,seq2:this.sequence2[n.pos[1]-1]+n.seq2}),d[1]&&g.push({pos:[n.pos[0]-1,n.pos[1]],seq1:this.sequence1[n.pos[0]-1]+n.seq1,seq2:"-"+n.seq2}),d[2]&&g.push({pos:[n.pos[0],n.pos[1]-1],seq1:"-"+n.seq1,seq2:this.sequence2[n.pos[1]-1]+n.seq2}),n.pos[0]===0&&n.pos[1]===0&&this.alignments.push({sequence1:n.seq1,sequence2:n.seq2}),g.shift()}return this.alignments}},{key:"getAllIndexes",value:function(g,n){for(var d=[],r=-1;(r=g.indexOf(n,r+1))!==-1;)d.push(r);return d}},{key:"arrayAllMaxIndexes",value:function(g){return this.getAllIndexes(g,Math.max.apply(null,g))}}]),i})();N.exports=t}),(function(N,I,L){var o=function(){};o.FDLayout=L(18),o.FDLayoutConstants=L(7),o.FDLayoutEdge=L(19),o.FDLayoutNode=L(20),o.DimensionD=L(21),o.HashMap=L(22),o.HashSet=L(23),o.IGeometry=L(8),o.IMath=L(9),o.Integer=L(10),o.Point=L(12),o.PointD=L(4),o.RandomSeed=L(16),o.RectangleD=L(13),o.Transform=L(17),o.UniqueIDGeneretor=L(14),o.Quicksort=L(24),o.LinkedList=L(11),o.LGraphObject=L(2),o.LGraph=L(5),o.LEdge=L(1),o.LGraphManager=L(6),o.LNode=L(3),o.Layout=L(15),o.LayoutConstants=L(0),o.NeedlemanWunsch=L(25),N.exports=o}),(function(N,I,L){function o(){this.listeners=[]}var e=o.prototype;e.addListener=function(t,i){this.listeners.push({event:t,callback:i})},e.removeListener=function(t,i){for(var l=this.listeners.length;l>=0;l--){var g=this.listeners[l];g.event===t&&g.callback===i&&this.listeners.splice(l,1)}},e.emit=function(t,i){for(var l=0;l<this.listeners.length;l++){var g=this.listeners[l];t===g.event&&g.callback(i)}},N.exports=o})])})})(Q)),Q.exports}var ct=Z.exports,z;function pt(){return z||(z=1,(function(G,b){(function(I,L){G.exports=L(ft())})(ct,function(N){return(function(I){var L={};function o(e){if(L[e])return L[e].exports;var t=L[e]={i:e,l:!1,exports:{}};return I[e].call(t.exports,t,t.exports,o),t.l=!0,t.exports}return o.m=I,o.c=L,o.i=function(e){return e},o.d=function(e,t,i){o.o(e,t)||Object.defineProperty(e,t,{configurable:!1,enumerable:!0,get:i})},o.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return o.d(t,"a",t),t},o.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},o.p="",o(o.s=7)})([(function(I,L){I.exports=N}),(function(I,L,o){var e=o(0).FDLayoutConstants;function t(){}for(var i in e)t[i]=e[i];t.DEFAULT_USE_MULTI_LEVEL_SCALING=!1,t.DEFAULT_RADIAL_SEPARATION=e.DEFAULT_EDGE_LENGTH,t.DEFAULT_COMPONENT_SEPERATION=60,t.TILE=!0,t.TILING_PADDING_VERTICAL=10,t.TILING_PADDING_HORIZONTAL=10,t.TREE_REDUCTION_ON_INCREMENTAL=!1,I.exports=t}),(function(I,L,o){var e=o(0).FDLayoutEdge;function t(l,g,n){e.call(this,l,g,n)}t.prototype=Object.create(e.prototype);for(var i in e)t[i]=e[i];I.exports=t}),(function(I,L,o){var e=o(0).LGraph;function t(l,g,n){e.call(this,l,g,n)}t.prototype=Object.create(e.prototype);for(var i in e)t[i]=e[i];I.exports=t}),(function(I,L,o){var e=o(0).LGraphManager;function t(l){e.call(this,l)}t.prototype=Object.create(e.prototype);for(var i in e)t[i]=e[i];I.exports=t}),(function(I,L,o){var e=o(0).FDLayoutNode,t=o(0).IMath;function i(g,n,d,r){e.call(this,g,n,d,r)}i.prototype=Object.create(e.prototype);for(var l in e)i[l]=e[l];i.prototype.move=function(){var g=this.graphManager.getLayout();this.displacementX=g.coolingFactor*(this.springForceX+this.repulsionForceX+this.gravitationForceX)/this.noOfChildren,this.displacementY=g.coolingFactor*(this.springForceY+this.repulsionForceY+this.gravitationForceY)/this.noOfChildren,Math.abs(this.displacementX)>g.coolingFactor*g.maxNodeDisplacement&&(this.displacementX=g.coolingFactor*g.maxNodeDisplacement*t.sign(this.displacementX)),Math.abs(this.displacementY)>g.coolingFactor*g.maxNodeDisplacement&&(this.displacementY=g.coolingFactor*g.maxNodeDisplacement*t.sign(this.displacementY)),this.child==null?this.moveBy(this.displacementX,this.displacementY):this.child.getNodes().length==0?this.moveBy(this.displacementX,this.displacementY):this.propogateDisplacementToChildren(this.displacementX,this.displacementY),g.totalDisplacement+=Math.abs(this.displacementX)+Math.abs(this.displacementY),this.springForceX=0,this.springForceY=0,this.repulsionForceX=0,this.repulsionForceY=0,this.gravitationForceX=0,this.gravitationForceY=0,this.displacementX=0,this.displacementY=0},i.prototype.propogateDisplacementToChildren=function(g,n){for(var d=this.getChild().getNodes(),r,h=0;h<d.length;h++)r=d[h],r.getChild()==null?(r.moveBy(g,n),r.displacementX+=g,r.displacementY+=n):r.propogateDisplacementToChildren(g,n)},i.prototype.setPred1=function(g){this.pred1=g},i.prototype.getPred1=function(){return pred1},i.prototype.getPred2=function(){return pred2},i.prototype.setNext=function(g){this.next=g},i.prototype.getNext=function(){return next},i.prototype.setProcessed=function(g){this.processed=g},i.prototype.isProcessed=function(){return processed},I.exports=i}),(function(I,L,o){var e=o(0).FDLayout,t=o(4),i=o(3),l=o(5),g=o(2),n=o(1),d=o(0).FDLayoutConstants,r=o(0).LayoutConstants,h=o(0).Point,a=o(0).PointD,p=o(0).Layout,v=o(0).Integer,D=o(0).IGeometry,u=o(0).LGraph,T=o(0).Transform;function y(){e.call(this),this.toBeTiled={}}y.prototype=Object.create(e.prototype);for(var O in e)y[O]=e[O];y.prototype.newGraphManager=function(){var s=new t(this);return this.graphManager=s,s},y.prototype.newGraph=function(s){return new i(null,this.graphManager,s)},y.prototype.newNode=function(s){return new l(this.graphManager,s)},y.prototype.newEdge=function(s){return new g(null,null,s)},y.prototype.initParameters=function(){e.prototype.initParameters.call(this,arguments),this.isSubLayout||(n.DEFAULT_EDGE_LENGTH<10?this.idealEdgeLength=10:this.idealEdgeLength=n.DEFAULT_EDGE_LENGTH,this.useSmartIdealEdgeLengthCalculation=n.DEFAULT_USE_SMART_IDEAL_EDGE_LENGTH_CALCULATION,this.springConstant=d.DEFAULT_SPRING_STRENGTH,this.repulsionConstant=d.DEFAULT_REPULSION_STRENGTH,this.gravityConstant=d.DEFAULT_GRAVITY_STRENGTH,this.compoundGravityConstant=d.DEFAULT_COMPOUND_GRAVITY_STRENGTH,this.gravityRangeFactor=d.DEFAULT_GRAVITY_RANGE_FACTOR,this.compoundGravityRangeFactor=d.DEFAULT_COMPOUND_GRAVITY_RANGE_FACTOR,this.prunedNodesAll=[],this.growTreeIterations=0,this.afterGrowthIterations=0,this.isTreeGrowing=!1,this.isGrowthFinished=!1,this.coolingCycle=0,this.maxCoolingCycle=this.maxIterations/d.CONVERGENCE_CHECK_PERIOD,this.finalTemperature=d.CONVERGENCE_CHECK_PERIOD/this.maxIterations,this.coolingAdjuster=1)},y.prototype.layout=function(){var s=r.DEFAULT_CREATE_BENDS_AS_NEEDED;return s&&(this.createBendpoints(),this.graphManager.resetAllEdges()),this.level=0,this.classicLayout()},y.prototype.classicLayout=function(){if(this.nodesWithGravity=this.calculateNodesToApplyGravitationTo(),this.graphManager.setAllNodesToApplyGravitation(this.nodesWithGravity),this.calcNoOfChildrenForAllNodes(),this.graphManager.calcLowestCommonAncestors(),this.graphManager.calcInclusionTreeDepths(),this.graphManager.getRoot().calcEstimatedSize(),this.calcIdealEdgeLengths(),this.incremental){if(n.TREE_REDUCTION_ON_INCREMENTAL){this.reduceTrees(),this.graphManager.resetAllNodesToApplyGravitation();var f=new Set(this.getAllNodes()),c=this.nodesWithGravity.filter(function(m){return f.has(m)});this.graphManager.setAllNodesToApplyGravitation(c)}}else{var s=this.getFlatForest();if(s.length>0)this.positionNodesRadially(s);else{this.reduceTrees(),this.graphManager.resetAllNodesToApplyGravitation();var f=new Set(this.getAllNodes()),c=this.nodesWithGravity.filter(function(E){return f.has(E)});this.graphManager.setAllNodesToApplyGravitation(c),this.positionNodesRandomly()}}return this.initSpringEmbedder(),this.runSpringEmbedder(),!0},y.prototype.tick=function(){if(this.totalIterations++,this.totalIterations===this.maxIterations&&!this.isTreeGrowing&&!this.isGrowthFinished)if(this.prunedNodesAll.length>0)this.isTreeGrowing=!0;else return!0;if(this.totalIterations%d.CONVERGENCE_CHECK_PERIOD==0&&!this.isTreeGrowing&&!this.isGrowthFinished){if(this.isConverged())if(this.prunedNodesAll.length>0)this.isTreeGrowing=!0;else return!0;this.coolingCycle++,this.layoutQuality==0?this.coolingAdjuster=this.coolingCycle:this.layoutQuality==1&&(this.coolingAdjuster=this.coolingCycle/3),this.coolingFactor=Math.max(this.initialCoolingFactor-Math.pow(this.coolingCycle,Math.log(100*(this.initialCoolingFactor-this.finalTemperature))/Math.log(this.maxCoolingCycle))/100*this.coolingAdjuster,this.finalTemperature),this.animationPeriod=Math.ceil(this.initialAnimationPeriod*Math.sqrt(this.coolingFactor))}if(this.isTreeGrowing){if(this.growTreeIterations%10==0)if(this.prunedNodesAll.length>0){this.graphManager.updateBounds(),this.updateGrid(),this.growTree(this.prunedNodesAll),this.graphManager.resetAllNodesToApplyGravitation();var s=new Set(this.getAllNodes()),f=this.nodesWithGravity.filter(function(A){return s.has(A)});this.graphManager.setAllNodesToApplyGravitation(f),this.graphManager.updateBounds(),this.updateGrid(),this.coolingFactor=d.DEFAULT_COOLING_FACTOR_INCREMENTAL}else this.isTreeGrowing=!1,this.isGrowthFinished=!0;this.growTreeIterations++}if(this.isGrowthFinished){if(this.isConverged())return!0;this.afterGrowthIterations%10==0&&(this.graphManager.updateBounds(),this.updateGrid()),this.coolingFactor=d.DEFAULT_COOLING_FACTOR_INCREMENTAL*((100-this.afterGrowthIterations)/100),this.afterGrowthIterations++}var c=!this.isTreeGrowing&&!this.isGrowthFinished,E=this.growTreeIterations%10==1&&this.isTreeGrowing||this.afterGrowthIterations%10==1&&this.isGrowthFinished;return this.totalDisplacement=0,this.graphManager.updateBounds(),this.calcSpringForces(),this.calcRepulsionForces(c,E),this.calcGravitationalForces(),this.moveNodes(),this.animate(),!1},y.prototype.getPositionsData=function(){for(var s=this.graphManager.getAllNodes(),f={},c=0;c<s.length;c++){var E=s[c].rect,A=s[c].id;f[A]={id:A,x:E.getCenterX(),y:E.getCenterY(),w:E.width,h:E.height}}return f},y.prototype.runSpringEmbedder=function(){this.initialAnimationPeriod=25,this.animationPeriod=this.initialAnimationPeriod;var s=!1;if(d.ANIMATE==="during")this.emit("layoutstarted");else{for(;!s;)s=this.tick();this.graphManager.updateBounds()}},y.prototype.calculateNodesToApplyGravitationTo=function(){var s=[],f,c=this.graphManager.getGraphs(),E=c.length,A;for(A=0;A<E;A++)f=c[A],f.updateConnected(),f.isConnected||(s=s.concat(f.getNodes()));return s},y.prototype.createBendpoints=function(){var s=[];s=s.concat(this.graphManager.getAllEdges());var f=new Set,c;for(c=0;c<s.length;c++){var E=s[c];if(!f.has(E)){var A=E.getSource(),m=E.getTarget();if(A==m)E.getBendpoints().push(new a),E.getBendpoints().push(new a),this.createDummyNodesForBendpoints(E),f.add(E);else{var C=[];if(C=C.concat(A.getEdgeListToNode(m)),C=C.concat(m.getEdgeListToNode(A)),!f.has(C[0])){if(C.length>1){var R;for(R=0;R<C.length;R++){var M=C[R];M.getBendpoints().push(new a),this.createDummyNodesForBendpoints(M)}}C.forEach(function(S){f.add(S)})}}}if(f.size==s.length)break}},y.prototype.positionNodesRadially=function(s){for(var f=new h(0,0),c=Math.ceil(Math.sqrt(s.length)),E=0,A=0,m=0,C=new a(0,0),R=0;R<s.length;R++){R%c==0&&(m=0,A=E,R!=0&&(A+=n.DEFAULT_COMPONENT_SEPERATION),E=0);var M=s[R],S=p.findCenterOfTree(M);f.x=m,f.y=A,C=y.radialLayout(M,S,f),C.y>E&&(E=Math.floor(C.y)),m=Math.floor(C.x+n.DEFAULT_COMPONENT_SEPERATION)}this.transform(new a(r.WORLD_CENTER_X-C.x/2,r.WORLD_CENTER_Y-C.y/2))},y.radialLayout=function(s,f,c){var E=Math.max(this.maxDiagonalInTree(s),n.DEFAULT_RADIAL_SEPARATION);y.branchRadialLayout(f,null,0,359,0,E);var A=u.calculateBounds(s),m=new T;m.setDeviceOrgX(A.getMinX()),m.setDeviceOrgY(A.getMinY()),m.setWorldOrgX(c.x),m.setWorldOrgY(c.y);for(var C=0;C<s.length;C++){var R=s[C];R.transform(m)}var M=new a(A.getMaxX(),A.getMaxY());return m.inverseTransformPoint(M)},y.branchRadialLayout=function(s,f,c,E,A,m){var C=(E-c+1)/2;C<0&&(C+=180);var R=(C+c)%360,M=R*D.TWO_PI/360,S=A*Math.cos(M),Y=A*Math.sin(M);s.setCenter(S,Y);var w=[];w=w.concat(s.getEdges());var x=w.length;f!=null&&x--;for(var F=0,U=w.length,P,_=s.getEdgesBetween(f);_.length>1;){var X=_[0];_.splice(0,1);var H=w.indexOf(X);H>=0&&w.splice(H,1),U--,x--}f!=null?P=(w.indexOf(_[0])+1)%U:P=0;for(var W=Math.abs(E-c)/x,B=P;F!=x;B=++B%U){var K=w[B].getOtherEnd(s);if(K!=f){var q=(c+F*W)%360,ht=(q+W)%360;y.branchRadialLayout(K,s,q,ht,A+m,m),F++}}},y.maxDiagonalInTree=function(s){for(var f=v.MIN_VALUE,c=0;c<s.length;c++){var E=s[c],A=E.getDiagonal();A>f&&(f=A)}return f},y.prototype.calcRepulsionRange=function(){return 2*(this.level+1)*this.idealEdgeLength},y.prototype.groupZeroDegreeMembers=function(){var s=this,f={};this.memberGroups={},this.idToDummyNode={};for(var c=[],E=this.graphManager.getAllNodes(),A=0;A<E.length;A++){var m=E[A],C=m.getParent();this.getNodeDegreeWithChildren(m)===0&&(C.id==null||!this.getToBeTiled(C))&&c.push(m)}for(var A=0;A<c.length;A++){var m=c[A],R=m.getParent().id;typeof f[R]>"u"&&(f[R]=[]),f[R]=f[R].concat(m)}Object.keys(f).forEach(function(M){if(f[M].length>1){var S="DummyCompound_"+M;s.memberGroups[S]=f[M];var Y=f[M][0].getParent(),w=new l(s.graphManager);w.id=S,w.paddingLeft=Y.paddingLeft||0,w.paddingRight=Y.paddingRight||0,w.paddingBottom=Y.paddingBottom||0,w.paddingTop=Y.paddingTop||0,s.idToDummyNode[S]=w;var x=s.getGraphManager().add(s.newGraph(),w),F=Y.getChild();F.add(w);for(var U=0;U<f[M].length;U++){var P=f[M][U];F.remove(P),x.add(P)}}})},y.prototype.clearCompounds=function(){var s={},f={};this.performDFSOnCompounds();for(var c=0;c<this.compoundOrder.length;c++)f[this.compoundOrder[c].id]=this.compoundOrder[c],s[this.compoundOrder[c].id]=[].concat(this.compoundOrder[c].getChild().getNodes()),this.graphManager.remove(this.compoundOrder[c].getChild()),this.compoundOrder[c].child=null;this.graphManager.resetAllNodes(),this.tileCompoundMembers(s,f)},y.prototype.clearZeroDegreeMembers=function(){var s=this,f=this.tiledZeroDegreePack=[];Object.keys(this.memberGroups).forEach(function(c){var E=s.idToDummyNode[c];f[c]=s.tileNodes(s.memberGroups[c],E.paddingLeft+E.paddingRight),E.rect.width=f[c].width,E.rect.height=f[c].height})},y.prototype.repopulateCompounds=function(){for(var s=this.compoundOrder.length-1;s>=0;s--){var f=this.compoundOrder[s],c=f.id,E=f.paddingLeft,A=f.paddingTop;this.adjustLocations(this.tiledMemberPack[c],f.rect.x,f.rect.y,E,A)}},y.prototype.repopulateZeroDegreeMembers=function(){var s=this,f=this.tiledZeroDegreePack;Object.keys(f).forEach(function(c){var E=s.idToDummyNode[c],A=E.paddingLeft,m=E.paddingTop;s.adjustLocations(f[c],E.rect.x,E.rect.y,A,m)})},y.prototype.getToBeTiled=function(s){var f=s.id;if(this.toBeTiled[f]!=null)return this.toBeTiled[f];var c=s.getChild();if(c==null)return this.toBeTiled[f]=!1,!1;for(var E=c.getNodes(),A=0;A<E.length;A++){var m=E[A];if(this.getNodeDegree(m)>0)return this.toBeTiled[f]=!1,!1;if(m.getChild()==null){this.toBeTiled[m.id]=!1;continue}if(!this.getToBeTiled(m))return this.toBeTiled[f]=!1,!1}return this.toBeTiled[f]=!0,!0},y.prototype.getNodeDegree=function(s){s.id;for(var f=s.getEdges(),c=0,E=0;E<f.length;E++){var A=f[E];A.getSource().id!==A.getTarget().id&&(c=c+1)}return c},y.prototype.getNodeDegreeWithChildren=function(s){var f=this.getNodeDegree(s);if(s.getChild()==null)return f;for(var c=s.getChild().getNodes(),E=0;E<c.length;E++){var A=c[E];f+=this.getNodeDegreeWithChildren(A)}return f},y.prototype.performDFSOnCompounds=function(){this.compoundOrder=[],this.fillCompexOrderByDFS(this.graphManager.getRoot().getNodes())},y.prototype.fillCompexOrderByDFS=function(s){for(var f=0;f<s.length;f++){var c=s[f];c.getChild()!=null&&this.fillCompexOrderByDFS(c.getChild().getNodes()),this.getToBeTiled(c)&&this.compoundOrder.push(c)}},y.prototype.adjustLocations=function(s,f,c,E,A){f+=E,c+=A;for(var m=f,C=0;C<s.rows.length;C++){var R=s.rows[C];f=m;for(var M=0,S=0;S<R.length;S++){var Y=R[S];Y.rect.x=f,Y.rect.y=c,f+=Y.rect.width+s.horizontalPadding,Y.rect.height>M&&(M=Y.rect.height)}c+=M+s.verticalPadding}},y.prototype.tileCompoundMembers=function(s,f){var c=this;this.tiledMemberPack=[],Object.keys(s).forEach(function(E){var A=f[E];c.tiledMemberPack[E]=c.tileNodes(s[E],A.paddingLeft+A.paddingRight),A.rect.width=c.tiledMemberPack[E].width,A.rect.height=c.tiledMemberPack[E].height})},y.prototype.tileNodes=function(s,f){var c=n.TILING_PADDING_VERTICAL,E=n.TILING_PADDING_HORIZONTAL,A={rows:[],rowWidth:[],rowHeight:[],width:0,height:f,verticalPadding:c,horizontalPadding:E};s.sort(function(R,M){return R.rect.width*R.rect.height>M.rect.width*M.rect.height?-1:R.rect.width*R.rect.height<M.rect.width*M.rect.height?1:0});for(var m=0;m<s.length;m++){var C=s[m];A.rows.length==0?this.insertNodeToRow(A,C,0,f):this.canAddHorizontal(A,C.rect.width,C.rect.height)?this.insertNodeToRow(A,C,this.getShortestRowIndex(A),f):this.insertNodeToRow(A,C,A.rows.length,f),this.shiftToLastRow(A)}return A},y.prototype.insertNodeToRow=function(s,f,c,E){var A=E;if(c==s.rows.length){var m=[];s.rows.push(m),s.rowWidth.push(A),s.rowHeight.push(0)}var C=s.rowWidth[c]+f.rect.width;s.rows[c].length>0&&(C+=s.horizontalPadding),s.rowWidth[c]=C,s.width<C&&(s.width=C);var R=f.rect.height;c>0&&(R+=s.verticalPadding);var M=0;R>s.rowHeight[c]&&(M=s.rowHeight[c],s.rowHeight[c]=R,M=s.rowHeight[c]-M),s.height+=M,s.rows[c].push(f)},y.prototype.getShortestRowIndex=function(s){for(var f=-1,c=Number.MAX_VALUE,E=0;E<s.rows.length;E++)s.rowWidth[E]<c&&(f=E,c=s.rowWidth[E]);return f},y.prototype.getLongestRowIndex=function(s){for(var f=-1,c=Number.MIN_VALUE,E=0;E<s.rows.length;E++)s.rowWidth[E]>c&&(f=E,c=s.rowWidth[E]);return f},y.prototype.canAddHorizontal=function(s,f,c){var E=this.getShortestRowIndex(s);if(E<0)return!0;var A=s.rowWidth[E];if(A+s.horizontalPadding+f<=s.width)return!0;var m=0;s.rowHeight[E]<c&&E>0&&(m=c+s.verticalPadding-s.rowHeight[E]);var C;s.width-A>=f+s.horizontalPadding?C=(s.height+m)/(A+f+s.horizontalPadding):C=(s.height+m)/s.width,m=c+s.verticalPadding;var R;return s.width<f?R=(s.height+m)/f:R=(s.height+m)/s.width,R<1&&(R=1/R),C<1&&(C=1/C),C<R},y.prototype.shiftToLastRow=function(s){var f=this.getLongestRowIndex(s),c=s.rowWidth.length-1,E=s.rows[f],A=E[E.length-1],m=A.width+s.horizontalPadding;if(s.width-s.rowWidth[c]>m&&f!=c){E.splice(-1,1),s.rows[c].push(A),s.rowWidth[f]=s.rowWidth[f]-m,s.rowWidth[c]=s.rowWidth[c]+m,s.width=s.rowWidth[instance.getLongestRowIndex(s)];for(var C=Number.MIN_VALUE,R=0;R<E.length;R++)E[R].height>C&&(C=E[R].height);f>0&&(C+=s.verticalPadding);var M=s.rowHeight[f]+s.rowHeight[c];s.rowHeight[f]=C,s.rowHeight[c]<A.height+s.verticalPadding&&(s.rowHeight[c]=A.height+s.verticalPadding);var S=s.rowHeight[f]+s.rowHeight[c];s.height+=S-M,this.shiftToLastRow(s)}},y.prototype.tilingPreLayout=function(){n.TILE&&(this.groupZeroDegreeMembers(),this.clearCompounds(),this.clearZeroDegreeMembers())},y.prototype.tilingPostLayout=function(){n.TILE&&(this.repopulateZeroDegreeMembers(),this.repopulateCompounds())},y.prototype.reduceTrees=function(){for(var s=[],f=!0,c;f;){var E=this.graphManager.getAllNodes(),A=[];f=!1;for(var m=0;m<E.length;m++)c=E[m],c.getEdges().length==1&&!c.getEdges()[0].isInterGraph&&c.getChild()==null&&(A.push([c,c.getEdges()[0],c.getOwner()]),f=!0);if(f==!0){for(var C=[],R=0;R<A.length;R++)A[R][0].getEdges().length==1&&(C.push(A[R]),A[R][0].getOwner().remove(A[R][0]));s.push(C),this.graphManager.resetAllNodes(),this.graphManager.resetAllEdges()}}this.prunedNodesAll=s},y.prototype.growTree=function(s){for(var f=s.length,c=s[f-1],E,A=0;A<c.length;A++)E=c[A],this.findPlaceforPrunedNode(E),E[2].add(E[0]),E[2].add(E[1],E[1].source,E[1].target);s.splice(s.length-1,1),this.graphManager.resetAllNodes(),this.graphManager.resetAllEdges()},y.prototype.findPlaceforPrunedNode=function(s){var f,c,E=s[0];E==s[1].source?c=s[1].target:c=s[1].source;var A=c.startX,m=c.finishX,C=c.startY,R=c.finishY,M=0,S=0,Y=0,w=0,x=[M,Y,S,w];if(C>0)for(var F=A;F<=m;F++)x[0]+=this.grid[F][C-1].length+this.grid[F][C].length-1;if(m<this.grid.length-1)for(var F=C;F<=R;F++)x[1]+=this.grid[m+1][F].length+this.grid[m][F].length-1;if(R<this.grid[0].length-1)for(var F=A;F<=m;F++)x[2]+=this.grid[F][R+1].length+this.grid[F][R].length-1;if(A>0)for(var F=C;F<=R;F++)x[3]+=this.grid[A-1][F].length+this.grid[A][F].length-1;for(var U=v.MAX_VALUE,P,_,X=0;X<x.length;X++)x[X]<U?(U=x[X],P=1,_=X):x[X]==U&&P++;if(P==3&&U==0)x[0]==0&&x[1]==0&&x[2]==0?f=1:x[0]==0&&x[1]==0&&x[3]==0?f=0:x[0]==0&&x[2]==0&&x[3]==0?f=3:x[1]==0&&x[2]==0&&x[3]==0&&(f=2);else if(P==2&&U==0){var H=Math.floor(Math.random()*2);x[0]==0&&x[1]==0?H==0?f=0:f=1:x[0]==0&&x[2]==0?H==0?f=0:f=2:x[0]==0&&x[3]==0?H==0?f=0:f=3:x[1]==0&&x[2]==0?H==0?f=1:f=2:x[1]==0&&x[3]==0?H==0?f=1:f=3:H==0?f=2:f=3}else if(P==4&&U==0){var H=Math.floor(Math.random()*4);f=H}else f=_;f==0?E.setCenter(c.getCenterX(),c.getCenterY()-c.getHeight()/2-d.DEFAULT_EDGE_LENGTH-E.getHeight()/2):f==1?E.setCenter(c.getCenterX()+c.getWidth()/2+d.DEFAULT_EDGE_LENGTH+E.getWidth()/2,c.getCenterY()):f==2?E.setCenter(c.getCenterX(),c.getCenterY()+c.getHeight()/2+d.DEFAULT_EDGE_LENGTH+E.getHeight()/2):E.setCenter(c.getCenterX()-c.getWidth()/2-d.DEFAULT_EDGE_LENGTH-E.getWidth()/2,c.getCenterY())},I.exports=y}),(function(I,L,o){var e={};e.layoutBase=o(0),e.CoSEConstants=o(1),e.CoSEEdge=o(2),e.CoSEGraph=o(3),e.CoSEGraphManager=o(4),e.CoSELayout=o(6),e.CoSENode=o(5),I.exports=e})])})})(Z)),Z.exports}var dt=$.exports,J;function vt(){return J||(J=1,(function(G,b){(function(I,L){G.exports=L(pt())})(dt,function(N){return(function(I){var L={};function o(e){if(L[e])return L[e].exports;var t=L[e]={i:e,l:!1,exports:{}};return I[e].call(t.exports,t,t.exports,o),t.l=!0,t.exports}return o.m=I,o.c=L,o.i=function(e){return e},o.d=function(e,t,i){o.o(e,t)||Object.defineProperty(e,t,{configurable:!1,enumerable:!0,get:i})},o.n=function(e){var t=e&&e.__esModule?(function(){return e.default}):(function(){return e});return o.d(t,"a",t),t},o.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},o.p="",o(o.s=1)})([(function(I,L){I.exports=N}),(function(I,L,o){var e=o(0).layoutBase.LayoutConstants,t=o(0).layoutBase.FDLayoutConstants,i=o(0).CoSEConstants,l=o(0).CoSELayout,g=o(0).CoSENode,n=o(0).layoutBase.PointD,d=o(0).layoutBase.DimensionD,r={ready:function(){},stop:function(){},quality:"default",nodeDimensionsIncludeLabels:!1,refresh:30,fit:!0,padding:10,randomize:!0,nodeRepulsion:4500,idealEdgeLength:50,edgeElasticity:.45,nestingFactor:.1,gravity:.25,numIter:2500,tile:!0,animate:"end",animationDuration:500,tilingPaddingVertical:10,tilingPaddingHorizontal:10,gravityRangeCompound:1.5,gravityCompound:1,gravityRange:3.8,initialEnergyOnIncremental:.5};function h(D,u){var T={};for(var y in D)T[y]=D[y];for(var y in u)T[y]=u[y];return T}function a(D){this.options=h(r,D),p(this.options)}var p=function(u){u.nodeRepulsion!=null&&(i.DEFAULT_REPULSION_STRENGTH=t.DEFAULT_REPULSION_STRENGTH=u.nodeRepulsion),u.idealEdgeLength!=null&&(i.DEFAULT_EDGE_LENGTH=t.DEFAULT_EDGE_LENGTH=u.idealEdgeLength),u.edgeElasticity!=null&&(i.DEFAULT_SPRING_STRENGTH=t.DEFAULT_SPRING_STRENGTH=u.edgeElasticity),u.nestingFactor!=null&&(i.PER_LEVEL_IDEAL_EDGE_LENGTH_FACTOR=t.PER_LEVEL_IDEAL_EDGE_LENGTH_FACTOR=u.nestingFactor),u.gravity!=null&&(i.DEFAULT_GRAVITY_STRENGTH=t.DEFAULT_GRAVITY_STRENGTH=u.gravity),u.numIter!=null&&(i.MAX_ITERATIONS=t.MAX_ITERATIONS=u.numIter),u.gravityRange!=null&&(i.DEFAULT_GRAVITY_RANGE_FACTOR=t.DEFAULT_GRAVITY_RANGE_FACTOR=u.gravityRange),u.gravityCompound!=null&&(i.DEFAULT_COMPOUND_GRAVITY_STRENGTH=t.DEFAULT_COMPOUND_GRAVITY_STRENGTH=u.gravityCompound),u.gravityRangeCompound!=null&&(i.DEFAULT_COMPOUND_GRAVITY_RANGE_FACTOR=t.DEFAULT_COMPOUND_GRAVITY_RANGE_FACTOR=u.gravityRangeCompound),u.initialEnergyOnIncremental!=null&&(i.DEFAULT_COOLING_FACTOR_INCREMENTAL=t.DEFAULT_COOLING_FACTOR_INCREMENTAL=u.initialEnergyOnIncremental),u.quality=="draft"?e.QUALITY=0:u.quality=="proof"?e.QUALITY=2:e.QUALITY=1,i.NODE_DIMENSIONS_INCLUDE_LABELS=t.NODE_DIMENSIONS_INCLUDE_LABELS=e.NODE_DIMENSIONS_INCLUDE_LABELS=u.nodeDimensionsIncludeLabels,i.DEFAULT_INCREMENTAL=t.DEFAULT_INCREMENTAL=e.DEFAULT_INCREMENTAL=!u.randomize,i.ANIMATE=t.ANIMATE=e.ANIMATE=u.animate,i.TILE=u.tile,i.TILING_PADDING_VERTICAL=typeof u.tilingPaddingVertical=="function"?u.tilingPaddingVertical.call():u.tilingPaddingVertical,i.TILING_PADDING_HORIZONTAL=typeof u.tilingPaddingHorizontal=="function"?u.tilingPaddingHorizontal.call():u.tilingPaddingHorizontal};a.prototype.run=function(){var D,u,T=this.options;this.idToLNode={};var y=this.layout=new l,O=this;O.stopped=!1,this.cy=this.options.cy,this.cy.trigger({type:"layoutstart",layout:this});var s=y.newGraphManager();this.gm=s;var f=this.options.eles.nodes(),c=this.options.eles.edges();this.root=s.addRoot(),this.processChildrenList(this.root,this.getTopMostNodes(f),y);for(var E=0;E<c.length;E++){var A=c[E],m=this.idToLNode[A.data("source")],C=this.idToLNode[A.data("target")];if(m!==C&&m.getEdgesBetween(C).length==0){var R=s.add(y.newEdge(),m,C);R.id=A.id()}}var M=function(w,x){typeof w=="number"&&(w=x);var F=w.data("id"),U=O.idToLNode[F];return{x:U.getRect().getCenterX(),y:U.getRect().getCenterY()}},S=function Y(){for(var w=function(){T.fit&&T.cy.fit(T.eles,T.padding),D||(D=!0,O.cy.one("layoutready",T.ready),O.cy.trigger({type:"layoutready",layout:O}))},x=O.options.refresh,F,U=0;U<x&&!F;U++)F=O.stopped||O.layout.tick();if(F){y.checkLayoutSuccess()&&!y.isSubLayout&&y.doPostLayout(),y.tilingPostLayout&&y.tilingPostLayout(),y.isLayoutFinished=!0,O.options.eles.nodes().positions(M),w(),O.cy.one("layoutstop",O.options.stop),O.cy.trigger({type:"layoutstop",layout:O}),u&&cancelAnimationFrame(u),D=!1;return}var P=O.layout.getPositionsData();T.eles.nodes().positions(function(_,X){if(typeof _=="number"&&(_=X),!_.isParent()){for(var H=_.id(),W=P[H],B=_;W==null&&(W=P[B.data("parent")]||P["DummyCompound_"+B.data("parent")],P[H]=W,B=B.parent()[0],B!=null););return W!=null?{x:W.x,y:W.y}:{x:_.position("x"),y:_.position("y")}}}),w(),u=requestAnimationFrame(Y)};return y.addListener("layoutstarted",function(){O.options.animate==="during"&&(u=requestAnimationFrame(S))}),y.runLayout(),this.options.animate!=="during"&&(O.options.eles.nodes().not(":parent").layoutPositions(O,O.options,M),D=!1),this},a.prototype.getTopMostNodes=function(D){for(var u={},T=0;T<D.length;T++)u[D[T].id()]=!0;var y=D.filter(function(O,s){typeof O=="number"&&(O=s);for(var f=O.parent()[0];f!=null;){if(u[f.id()])return!1;f=f.parent()[0]}return!0});return y},a.prototype.processChildrenList=function(D,u,T){for(var y=u.length,O=0;O<y;O++){var s=u[O],f=s.children(),c,E=s.layoutDimensions({nodeDimensionsIncludeLabels:this.options.nodeDimensionsIncludeLabels});if(s.outerWidth()!=null&&s.outerHeight()!=null?c=D.add(new g(T.graphManager,new n(s.position("x")-E.w/2,s.position("y")-E.h/2),new d(parseFloat(E.w),parseFloat(E.h)))):c=D.add(new g(this.graphManager)),c.id=s.data("id"),c.paddingLeft=parseInt(s.css("padding")),c.paddingTop=parseInt(s.css("padding")),c.paddingRight=parseInt(s.css("padding")),c.paddingBottom=parseInt(s.css("padding")),this.options.nodeDimensionsIncludeLabels&&s.isParent()){var A=s.boundingBox({includeLabels:!0,includeNodes:!1}).w,m=s.boundingBox({includeLabels:!0,includeNodes:!1}).h,C=s.css("text-halign");c.labelWidth=A,c.labelHeight=m,c.labelPos=C}if(this.idToLNode[s.data("id")]=c,isNaN(c.rect.x)&&(c.rect.x=0),isNaN(c.rect.y)&&(c.rect.y=0),f!=null&&f.length>0){var R;R=T.getGraphManager().add(T.newGraph(),c),this.processChildrenList(R,f,T)}}},a.prototype.stop=function(){return this.stopped=!0,this};var v=function(u){u("layout","cose-bilkent",a)};typeof cytoscape<"u"&&v(cytoscape),I.exports=v})])})})($)),$.exports}var yt=vt();const Et=lt(yt);tt.use(Et);function et(G,b){G.forEach(N=>{const I={id:N.id,labelText:N.label,height:N.height,width:N.width,padding:N.padding??0};Object.keys(N).forEach(L=>{["id","label","height","width","padding","x","y"].includes(L)||(I[L]=N[L])}),b.add({group:"nodes",data:I,position:{x:N.x??0,y:N.y??0}})})}V(et,"addNodes");function rt(G,b){G.forEach(N=>{const I={id:N.id,source:N.start,target:N.end};Object.keys(N).forEach(L=>{["id","start","end"].includes(L)||(I[L]=N[L])}),b.add({group:"edges",data:I})})}V(rt,"addEdges");function it(G){return new Promise(b=>{const N=gt("body").append("div").attr("id","cy").attr("style","display:none"),I=tt({container:document.getElementById("cy"),style:[{selector:"edge",style:{"curve-style":"bezier"}}]});N.remove(),et(G.nodes,I),rt(G.edges,I),I.nodes().forEach(function(o){o.layoutDimensions=()=>{const e=o.data();return{w:e.width,h:e.height}}});const L={name:"cose-bilkent",quality:"proof",styleEnabled:!1,animate:!1};I.layout(L).run(),I.ready(o=>{k.info("Cytoscape ready",o),b(I)})})}V(it,"createCytoscapeInstance");function nt(G){return G.nodes().map(b=>{const N=b.data(),I=b.position(),L={id:N.id,x:I.x,y:I.y};return Object.keys(N).forEach(o=>{o!=="id"&&(L[o]=N[o])}),L})}V(nt,"extractPositionedNodes");function ot(G){return G.edges().map(b=>{const N=b.data(),I=b._private.rscratch,L={id:N.id,source:N.source,target:N.target,startX:I.startX,startY:I.startY,midX:I.midX,midY:I.midY,endX:I.endX,endY:I.endY};return Object.keys(N).forEach(o=>{["id","source","target"].includes(o)||(L[o]=N[o])}),L})}V(ot,"extractPositionedEdges");async function st(G,b){k.debug("Starting cose-bilkent layout algorithm");try{at(G);const N=await it(G),I=nt(N),L=ot(N);return k.debug(`Layout completed: ${I.length} nodes, ${L.length} edges`),{nodes:I,edges:L}}catch(N){throw k.error("Error in cose-bilkent layout algorithm:",N),N}}V(st,"executeCoseBilkentLayout");function at(G){if(!G)throw new Error("Layout data is required");if(!G.config)throw new Error("Configuration is required in layout data");if(!G.rootNode)throw new Error("Root node is required");if(!G.nodes||!Array.isArray(G.nodes))throw new Error("No nodes found in layout data");if(!Array.isArray(G.edges))throw new Error("Edges array is required in layout data");return!0}V(at,"validateLayoutData");var Lt=V(async(G,b,{insertCluster:N,insertEdge:I,insertEdgeLabel:L,insertMarkers:o,insertNode:e,log:t,positionEdgeLabel:i},{algorithm:l})=>{const g={},n={},d=b.select("g");o(d,G.markers,G.type,G.diagramId);const r=d.insert("g").attr("class","subgraphs"),h=d.insert("g").attr("class","edgePaths"),a=d.insert("g").attr("class","edgeLabels"),p=d.insert("g").attr("class","nodes");t.debug("Inserting nodes into DOM for dimension calculation"),await Promise.all(G.nodes.map(async u=>{if(u.isGroup){const T={...u};n[u.id]=T,g[u.id]=T,await N(r,u)}else{const T={...u};g[u.id]=T;const y=await e(p,u,{config:G.config,dir:G.direction||"TB"}),O=y.node().getBBox();T.width=O.width,T.height=O.height,T.domId=y,t.debug(`Node ${u.id} dimensions: ${O.width}x${O.height}`)}})),t.debug("Running cose-bilkent layout algorithm");const v={...G,nodes:G.nodes.map(u=>{const T=g[u.id];return{...u,width:T.width,height:T.height}})},D=await st(v,G.config);t.debug("Positioning nodes based on layout results"),D.nodes.forEach(u=>{const T=g[u.id];T?.domId&&(T.domId.attr("transform",`translate(${u.x}, ${u.y})`),T.x=u.x,T.y=u.y,t.debug(`Positioned node ${T.id} at center (${u.x}, ${u.y})`))}),D.edges.forEach(u=>{const T=G.edges.find(y=>y.id===u.id);T&&(T.points=[{x:u.startX,y:u.startY},{x:u.midX,y:u.midY},{x:u.endX,y:u.endY}])}),t.debug("Inserting and positioning edges"),await Promise.all(G.edges.map(async u=>{await L(a,u);const T=g[u.start??""],y=g[u.end??""];if(T&&y){const O=D.edges.find(s=>s.id===u.id);if(O){t.debug("APA01 positionedEdge",O);const s={...u},f=I(h,s,n,G.type,T,y,G.diagramId);i(s,f)}else{const s={...u,points:[{x:T.x||0,y:T.y||0},{x:y.x||0,y:y.y||0}]},f=I(h,s,n,G.type,T,y,G.diagramId);i(s,f)}}})),t.debug("Cose-bilkent rendering completed")},"render"),At=Lt;export{At as render};
diff --git a/docs/dist/assets/cytoscape.esm-CF_z7lu9.js b/docs/dist/assets/cytoscape.esm-CF_z7lu9.js
deleted file mode 100644
index 6b66b828..00000000
--- a/docs/dist/assets/cytoscape.esm-CF_z7lu9.js
+++ /dev/null
@@ -1,321 +0,0 @@
-function Po(r,e){(e==null||e>r.length)&&(e=r.length);for(var t=0,a=Array(e);t<e;t++)a[t]=r[t];return a}function ec(r){if(Array.isArray(r))return r}function rc(r){if(Array.isArray(r))return Po(r)}function dt(r,e){if(!(r instanceof e))throw new TypeError("Cannot call a class as a function")}function tc(r,e){for(var t=0;t<e.length;t++){var a=e[t];a.enumerable=a.enumerable||!1,a.configurable=!0,"value"in a&&(a.writable=!0),Object.defineProperty(r,jl(a.key),a)}}function gt(r,e,t){return e&&tc(r.prototype,e),Object.defineProperty(r,"prototype",{writable:!1}),r}function kr(r,e){var t=typeof Symbol<"u"&&r[Symbol.iterator]||r["@@iterator"];if(!t){if(Array.isArray(r)||(t=Yo(r))||e){t&&(r=t);var a=0,n=function(){};return{s:n,n:function(){return a>=r.length?{done:!0}:{done:!1,value:r[a++]}},e:function(l){throw l},f:n}}throw new TypeError(`Invalid attempt to iterate non-iterable instance.
-In order to be iterable, non-array objects must have a [Symbol.iterator]() method.`)}var i,o=!0,s=!1;return{s:function(){t=t.call(r)},n:function(){var l=t.next();return o=l.done,l},e:function(l){s=!0,i=l},f:function(){try{o||t.return==null||t.return()}finally{if(s)throw i}}}}function Jl(r,e,t){return(e=jl(e))in r?Object.defineProperty(r,e,{value:t,enumerable:!0,configurable:!0,writable:!0}):r[e]=t,r}function ac(r){if(typeof Symbol<"u"&&r[Symbol.iterator]!=null||r["@@iterator"]!=null)return Array.from(r)}function nc(r,e){var t=r==null?null:typeof Symbol<"u"&&r[Symbol.iterator]||r["@@iterator"];if(t!=null){var a,n,i,o,s=[],l=!0,u=!1;try{if(i=(t=t.call(r)).next,e===0){if(Object(t)!==t)return;l=!1}else for(;!(l=(a=i.call(t)).done)&&(s.push(a.value),s.length!==e);l=!0);}catch(v){u=!0,n=v}finally{try{if(!l&&t.return!=null&&(o=t.return(),Object(o)!==o))return}finally{if(u)throw n}}return s}}function ic(){throw new TypeError(`Invalid attempt to destructure non-iterable instance.
-In order to be iterable, non-array objects must have a [Symbol.iterator]() method.`)}function oc(){throw new TypeError(`Invalid attempt to spread non-iterable instance.
-In order to be iterable, non-array objects must have a [Symbol.iterator]() method.`)}function Je(r,e){return ec(r)||nc(r,e)||Yo(r,e)||ic()}function mn(r){return rc(r)||ac(r)||Yo(r)||oc()}function sc(r,e){if(typeof r!="object"||!r)return r;var t=r[Symbol.toPrimitive];if(t!==void 0){var a=t.call(r,e);if(typeof a!="object")return a;throw new TypeError("@@toPrimitive must return a primitive value.")}return String(r)}function jl(r){var e=sc(r,"string");return typeof e=="symbol"?e:e+""}function ar(r){"@babel/helpers - typeof";return ar=typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?function(e){return typeof e}:function(e){return e&&typeof Symbol=="function"&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},ar(r)}function Yo(r,e){if(r){if(typeof r=="string")return Po(r,e);var t={}.toString.call(r).slice(8,-1);return t==="Object"&&r.constructor&&(t=r.constructor.name),t==="Map"||t==="Set"?Array.from(r):t==="Arguments"||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t)?Po(r,e):void 0}}var rr=typeof window>"u"?null:window,Ts=rr?rr.navigator:null;rr&&rr.document;var uc=ar(""),ev=ar({}),lc=ar(function(){}),vc=typeof HTMLElement>"u"?"undefined":ar(HTMLElement),La=function(e){return e&&e.instanceString&&Ue(e.instanceString)?e.instanceString():null},ge=function(e){return e!=null&&ar(e)==uc},Ue=function(e){return e!=null&&ar(e)===lc},_e=function(e){return!Dr(e)&&(Array.isArray?Array.isArray(e):e!=null&&e instanceof Array)},Le=function(e){return e!=null&&ar(e)===ev&&!_e(e)&&e.constructor===Object},fc=function(e){return e!=null&&ar(e)===ev},ae=function(e){return e!=null&&ar(e)===ar(1)&&!isNaN(e)},cc=function(e){return ae(e)&&Math.floor(e)===e},bn=function(e){if(vc!=="undefined")return e!=null&&e instanceof HTMLElement},Dr=function(e){return Ia(e)||rv(e)},Ia=function(e){return La(e)==="collection"&&e._private.single},rv=function(e){return La(e)==="collection"&&!e._private.single},Zo=function(e){return La(e)==="core"},tv=function(e){return La(e)==="stylesheet"},hc=function(e){return La(e)==="event"},ut=function(e){return e==null?!0:!!(e===""||e.match(/^\s+$/))},dc=function(e){return typeof HTMLElement>"u"?!1:e instanceof HTMLElement},gc=function(e){return Le(e)&&ae(e.x1)&&ae(e.x2)&&ae(e.y1)&&ae(e.y2)},pc=function(e){return fc(e)&&Ue(e.then)},yc=function(){return Ts&&Ts.userAgent.match(/msie|trident|edge/i)},Qt=function(e,t){t||(t=function(){if(arguments.length===1)return arguments[0];if(arguments.length===0)return"undefined";for(var i=[],o=0;o<arguments.length;o++)i.push(arguments[o]);return i.join("$")});var a=function(){var i=this,o=arguments,s,l=t.apply(i,o),u=a.cache;return(s=u[l])||(s=u[l]=e.apply(i,o)),s};return a.cache={},a},Qo=Qt(function(r){return r.replace(/([A-Z])/g,function(e){return"-"+e.toLowerCase()})}),Mn=Qt(function(r){return r.replace(/(-\w)/g,function(e){return e[1].toUpperCase()})}),av=Qt(function(r,e){return r+e[0].toUpperCase()+e.substring(1)},function(r,e){return r+"$"+e}),Ss=function(e){return ut(e)?e:e.charAt(0).toUpperCase()+e.substring(1)},at=function(e,t){return e.slice(-1*t.length)===t},tr="(?:[-+]?(?:(?:\\d+|\\d*\\.\\d+)(?:[Ee][+-]?\\d+)?))",mc="rgb[a]?\\(("+tr+"[%]?)\\s*,\\s*("+tr+"[%]?)\\s*,\\s*("+tr+"[%]?)(?:\\s*,\\s*("+tr+"))?\\)",bc="rgb[a]?\\((?:"+tr+"[%]?)\\s*,\\s*(?:"+tr+"[%]?)\\s*,\\s*(?:"+tr+"[%]?)(?:\\s*,\\s*(?:"+tr+"))?\\)",wc="hsl[a]?\\(("+tr+")\\s*,\\s*("+tr+"[%])\\s*,\\s*("+tr+"[%])(?:\\s*,\\s*("+tr+"))?\\)",xc="hsl[a]?\\((?:"+tr+")\\s*,\\s*(?:"+tr+"[%])\\s*,\\s*(?:"+tr+"[%])(?:\\s*,\\s*(?:"+tr+"))?\\)",Ec="\\#[0-9a-fA-F]{3}",Cc="\\#[0-9a-fA-F]{6}",nv=function(e,t){return e<t?-1:e>t?1:0},Tc=function(e,t){return-1*nv(e,t)},be=Object.assign!=null?Object.assign.bind(Object):function(r){for(var e=arguments,t=1;t<e.length;t++){var a=e[t];if(a!=null)for(var n=Object.keys(a),i=0;i<n.length;i++){var o=n[i];r[o]=a[o]}}return r},Sc=function(e){if(!(!(e.length===4||e.length===7)||e[0]!=="#")){var t=e.length===4,a,n,i,o=16;return t?(a=parseInt(e[1]+e[1],o),n=parseInt(e[2]+e[2],o),i=parseInt(e[3]+e[3],o)):(a=parseInt(e[1]+e[2],o),n=parseInt(e[3]+e[4],o),i=parseInt(e[5]+e[6],o)),[a,n,i]}},kc=function(e){var t,a,n,i,o,s,l,u;function v(h,y,g){return g<0&&(g+=1),g>1&&(g-=1),g<1/6?h+(y-h)*6*g:g<1/2?y:g<2/3?h+(y-h)*(2/3-g)*6:h}var f=new RegExp("^"+wc+"$").exec(e);if(f){if(a=parseInt(f[1]),a<0?a=(360- -1*a%360)%360:a>360&&(a=a%360),a/=360,n=parseFloat(f[2]),n<0||n>100||(n=n/100,i=parseFloat(f[3]),i<0||i>100)||(i=i/100,o=f[4],o!==void 0&&(o=parseFloat(o),o<0||o>1)))return;if(n===0)s=l=u=Math.round(i*255);else{var c=i<.5?i*(1+n):i+n-i*n,d=2*i-c;s=Math.round(255*v(d,c,a+1/3)),l=Math.round(255*v(d,c,a)),u=Math.round(255*v(d,c,a-1/3))}t=[s,l,u,o]}return t},Dc=function(e){var t,a=new RegExp("^"+mc+"$").exec(e);if(a){t=[];for(var n=[],i=1;i<=3;i++){var o=a[i];if(o[o.length-1]==="%"&&(n[i]=!0),o=parseFloat(o),n[i]&&(o=o/100*255),o<0||o>255)return;t.push(Math.floor(o))}var s=n[1]||n[2]||n[3],l=n[1]&&n[2]&&n[3];if(s&&!l)return;var u=a[4];if(u!==void 0){if(u=parseFloat(u),u<0||u>1)return;t.push(u)}}return t},Bc=function(e){return Pc[e.toLowerCase()]},iv=function(e){return(_e(e)?e:null)||Bc(e)||Sc(e)||Dc(e)||kc(e)},Pc={transparent:[0,0,0,0],aliceblue:[240,248,255],antiquewhite:[250,235,215],aqua:[0,255,255],aquamarine:[127,255,212],azure:[240,255,255],beige:[245,245,220],bisque:[255,228,196],black:[0,0,0],blanchedalmond:[255,235,205],blue:[0,0,255],blueviolet:[138,43,226],brown:[165,42,42],burlywood:[222,184,135],cadetblue:[95,158,160],chartreuse:[127,255,0],chocolate:[210,105,30],coral:[255,127,80],cornflowerblue:[100,149,237],cornsilk:[255,248,220],crimson:[220,20,60],cyan:[0,255,255],darkblue:[0,0,139],darkcyan:[0,139,139],darkgoldenrod:[184,134,11],darkgray:[169,169,169],darkgreen:[0,100,0],darkgrey:[169,169,169],darkkhaki:[189,183,107],darkmagenta:[139,0,139],darkolivegreen:[85,107,47],darkorange:[255,140,0],darkorchid:[153,50,204],darkred:[139,0,0],darksalmon:[233,150,122],darkseagreen:[143,188,143],darkslateblue:[72,61,139],darkslategray:[47,79,79],darkslategrey:[47,79,79],darkturquoise:[0,206,209],darkviolet:[148,0,211],deeppink:[255,20,147],deepskyblue:[0,191,255],dimgray:[105,105,105],dimgrey:[105,105,105],dodgerblue:[30,144,255],firebrick:[178,34,34],floralwhite:[255,250,240],forestgreen:[34,139,34],fuchsia:[255,0,255],gainsboro:[220,220,220],ghostwhite:[248,248,255],gold:[255,215,0],goldenrod:[218,165,32],gray:[128,128,128],grey:[128,128,128],green:[0,128,0],greenyellow:[173,255,47],honeydew:[240,255,240],hotpink:[255,105,180],indianred:[205,92,92],indigo:[75,0,130],ivory:[255,255,240],khaki:[240,230,140],lavender:[230,230,250],lavenderblush:[255,240,245],lawngreen:[124,252,0],lemonchiffon:[255,250,205],lightblue:[173,216,230],lightcoral:[240,128,128],lightcyan:[224,255,255],lightgoldenrodyellow:[250,250,210],lightgray:[211,211,211],lightgreen:[144,238,144],lightgrey:[211,211,211],lightpink:[255,182,193],lightsalmon:[255,160,122],lightseagreen:[32,178,170],lightskyblue:[135,206,250],lightslategray:[119,136,153],lightslategrey:[119,136,153],lightsteelblue:[176,196,222],lightyellow:[255,255,224],lime:[0,255,0],limegreen:[50,205,50],linen:[250,240,230],magenta:[255,0,255],maroon:[128,0,0],mediumaquamarine:[102,205,170],mediumblue:[0,0,205],mediumorchid:[186,85,211],mediumpurple:[147,112,219],mediumseagreen:[60,179,113],mediumslateblue:[123,104,238],mediumspringgreen:[0,250,154],mediumturquoise:[72,209,204],mediumvioletred:[199,21,133],midnightblue:[25,25,112],mintcream:[245,255,250],mistyrose:[255,228,225],moccasin:[255,228,181],navajowhite:[255,222,173],navy:[0,0,128],oldlace:[253,245,230],olive:[128,128,0],olivedrab:[107,142,35],orange:[255,165,0],orangered:[255,69,0],orchid:[218,112,214],palegoldenrod:[238,232,170],palegreen:[152,251,152],paleturquoise:[175,238,238],palevioletred:[219,112,147],papayawhip:[255,239,213],peachpuff:[255,218,185],peru:[205,133,63],pink:[255,192,203],plum:[221,160,221],powderblue:[176,224,230],purple:[128,0,128],red:[255,0,0],rosybrown:[188,143,143],royalblue:[65,105,225],saddlebrown:[139,69,19],salmon:[250,128,114],sandybrown:[244,164,96],seagreen:[46,139,87],seashell:[255,245,238],sienna:[160,82,45],silver:[192,192,192],skyblue:[135,206,235],slateblue:[106,90,205],slategray:[112,128,144],slategrey:[112,128,144],snow:[255,250,250],springgreen:[0,255,127],steelblue:[70,130,180],tan:[210,180,140],teal:[0,128,128],thistle:[216,191,216],tomato:[255,99,71],turquoise:[64,224,208],violet:[238,130,238],wheat:[245,222,179],white:[255,255,255],whitesmoke:[245,245,245],yellow:[255,255,0],yellowgreen:[154,205,50]},ov=function(e){for(var t=e.map,a=e.keys,n=a.length,i=0;i<n;i++){var o=a[i];if(Le(o))throw Error("Tried to set map with object key");i<a.length-1?(t[o]==null&&(t[o]={}),t=t[o]):t[o]=e.value}},sv=function(e){for(var t=e.map,a=e.keys,n=a.length,i=0;i<n;i++){var o=a[i];if(Le(o))throw Error("Tried to get map with object key");if(t=t[o],t==null)return t}return t},Ka=typeof globalThis<"u"?globalThis:typeof window<"u"?window:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{};function Oa(r){return r&&r.__esModule&&Object.prototype.hasOwnProperty.call(r,"default")?r.default:r}var Jn,ks;function Na(){if(ks)return Jn;ks=1;function r(e){var t=typeof e;return e!=null&&(t=="object"||t=="function")}return Jn=r,Jn}var jn,Ds;function Ac(){if(Ds)return jn;Ds=1;var r=typeof Ka=="object"&&Ka&&Ka.Object===Object&&Ka;return jn=r,jn}var ei,Bs;function Ln(){if(Bs)return ei;Bs=1;var r=Ac(),e=typeof self=="object"&&self&&self.Object===Object&&self,t=r||e||Function("return this")();return ei=t,ei}var ri,Ps;function Rc(){if(Ps)return ri;Ps=1;var r=Ln(),e=function(){return r.Date.now()};return ri=e,ri}var ti,As;function Mc(){if(As)return ti;As=1;var r=/\s/;function e(t){for(var a=t.length;a--&&r.test(t.charAt(a)););return a}return ti=e,ti}var ai,Rs;function Lc(){if(Rs)return ai;Rs=1;var r=Mc(),e=/^\s+/;function t(a){return a&&a.slice(0,r(a)+1).replace(e,"")}return ai=t,ai}var ni,Ms;function Jo(){if(Ms)return ni;Ms=1;var r=Ln(),e=r.Symbol;return ni=e,ni}var ii,Ls;function Ic(){if(Ls)return ii;Ls=1;var r=Jo(),e=Object.prototype,t=e.hasOwnProperty,a=e.toString,n=r?r.toStringTag:void 0;function i(o){var s=t.call(o,n),l=o[n];try{o[n]=void 0;var u=!0}catch{}var v=a.call(o);return u&&(s?o[n]=l:delete o[n]),v}return ii=i,ii}var oi,Is;function Oc(){if(Is)return oi;Is=1;var r=Object.prototype,e=r.toString;function t(a){return e.call(a)}return oi=t,oi}var si,Os;function uv(){if(Os)return si;Os=1;var r=Jo(),e=Ic(),t=Oc(),a="[object Null]",n="[object Undefined]",i=r?r.toStringTag:void 0;function o(s){return s==null?s===void 0?n:a:i&&i in Object(s)?e(s):t(s)}return si=o,si}var ui,Ns;function Nc(){if(Ns)return ui;Ns=1;function r(e){return e!=null&&typeof e=="object"}return ui=r,ui}var li,zs;function za(){if(zs)return li;zs=1;var r=uv(),e=Nc(),t="[object Symbol]";function a(n){return typeof n=="symbol"||e(n)&&r(n)==t}return li=a,li}var vi,Fs;function zc(){if(Fs)return vi;Fs=1;var r=Lc(),e=Na(),t=za(),a=NaN,n=/^[-+]0x[0-9a-f]+$/i,i=/^0b[01]+$/i,o=/^0o[0-7]+$/i,s=parseInt;function l(u){if(typeof u=="number")return u;if(t(u))return a;if(e(u)){var v=typeof u.valueOf=="function"?u.valueOf():u;u=e(v)?v+"":v}if(typeof u!="string")return u===0?u:+u;u=r(u);var f=i.test(u);return f||o.test(u)?s(u.slice(2),f?2:8):n.test(u)?a:+u}return vi=l,vi}var fi,Vs;function Fc(){if(Vs)return fi;Vs=1;var r=Na(),e=Rc(),t=zc(),a="Expected a function",n=Math.max,i=Math.min;function o(s,l,u){var v,f,c,d,h,y,g=0,p=!1,m=!1,b=!0;if(typeof s!="function")throw new TypeError(a);l=t(l)||0,r(u)&&(p=!!u.leading,m="maxWait"in u,c=m?n(t(u.maxWait)||0,l):c,b="trailing"in u?!!u.trailing:b);function w(A){var R=v,L=f;return v=f=void 0,g=A,d=s.apply(L,R),d}function E(A){return g=A,h=setTimeout(T,l),p?w(A):d}function C(A){var R=A-y,L=A-g,I=l-R;return m?i(I,c-L):I}function x(A){var R=A-y,L=A-g;return y===void 0||R>=l||R<0||m&&L>=c}function T(){var A=e();if(x(A))return k(A);h=setTimeout(T,C(A))}function k(A){return h=void 0,b&&v?w(A):(v=f=void 0,d)}function D(){h!==void 0&&clearTimeout(h),g=0,v=y=f=h=void 0}function B(){return h===void 0?d:k(e())}function P(){var A=e(),R=x(A);if(v=arguments,f=this,y=A,R){if(h===void 0)return E(y);if(m)return clearTimeout(h),h=setTimeout(T,l),w(y)}return h===void 0&&(h=setTimeout(T,l)),d}return P.cancel=D,P.flush=B,P}return fi=o,fi}var Vc=Fc(),Fa=Oa(Vc),ci=rr?rr.performance:null,lv=ci&&ci.now?function(){return ci.now()}:function(){return Date.now()},qc=(function(){if(rr){if(rr.requestAnimationFrame)return function(r){rr.requestAnimationFrame(r)};if(rr.mozRequestAnimationFrame)return function(r){rr.mozRequestAnimationFrame(r)};if(rr.webkitRequestAnimationFrame)return function(r){rr.webkitRequestAnimationFrame(r)};if(rr.msRequestAnimationFrame)return function(r){rr.msRequestAnimationFrame(r)}}return function(r){r&&setTimeout(function(){r(lv())},1e3/60)}})(),wn=function(e){return qc(e)},Yr=lv,Tt=9261,vv=65599,Ht=5381,fv=function(e){for(var t=arguments.length>1&&arguments[1]!==void 0?arguments[1]:Tt,a=t,n;n=e.next(),!n.done;)a=a*vv+n.value|0;return a},Ca=function(e){var t=arguments.length>1&&arguments[1]!==void 0?arguments[1]:Tt;return t*vv+e|0},Ta=function(e){var t=arguments.length>1&&arguments[1]!==void 0?arguments[1]:Ht;return(t<<5)+t+e|0},_c=function(e,t){return e*2097152+t},et=function(e){return e[0]*2097152+e[1]},Xa=function(e,t){return[Ca(e[0],t[0]),Ta(e[1],t[1])]},qs=function(e,t){var a={value:0,done:!1},n=0,i=e.length,o={next:function(){return n<i?a.value=e[n++]:a.done=!0,a}};return fv(o,t)},Dt=function(e,t){var a={value:0,done:!1},n=0,i=e.length,o={next:function(){return n<i?a.value=e.charCodeAt(n++):a.done=!0,a}};return fv(o,t)},cv=function(){return Gc(arguments)},Gc=function(e){for(var t,a=0;a<e.length;a++){var n=e[a];a===0?t=Dt(n):t=Dt(n,t)}return t};function Hc(r,e,t,a,n){var i=n*Math.PI/180,o=Math.cos(i)*(r-t)-Math.sin(i)*(e-a)+t,s=Math.sin(i)*(r-t)+Math.cos(i)*(e-a)+a;return{x:o,y:s}}var Wc=function(e,t,a,n,i,o){return{x:(e-a)*i+a,y:(t-n)*o+n}};function $c(r,e,t){if(t===0)return r;var a=(e.x1+e.x2)/2,n=(e.y1+e.y2)/2,i=e.w/e.h,o=1/i,s=Hc(r.x,r.y,a,n,t),l=Wc(s.x,s.y,a,n,i,o);return{x:l.x,y:l.y}}var _s=!0,Uc=console.warn!=null,Kc=console.trace!=null,jo=Number.MAX_SAFE_INTEGER||9007199254740991,hv=function(){return!0},xn=function(){return!1},Gs=function(){return 0},es=function(){},$e=function(e){throw new Error(e)},dv=function(e){if(e!==void 0)_s=!!e;else return _s},Ve=function(e){dv()&&(Uc?console.warn(e):(console.log(e),Kc&&console.trace()))},Xc=function(e){return be({},e)},qr=function(e){return e==null?e:_e(e)?e.slice():Le(e)?Xc(e):e},Yc=function(e){return e.slice()},gv=function(e,t){for(t=e="";e++<36;t+=e*51&52?(e^15?8^Math.random()*(e^20?16:4):4).toString(16):"-");return t},Zc={},pv=function(){return Zc},cr=function(e){var t=Object.keys(e);return function(a){for(var n={},i=0;i<t.length;i++){var o=t[i],s=a?.[o];n[o]=s===void 0?e[o]:s}return n}},lt=function(e,t,a){for(var n=e.length-1;n>=0;n--)e[n]===t&&e.splice(n,1)},rs=function(e){e.splice(0,e.length)},Qc=function(e,t){for(var a=0;a<t.length;a++){var n=t[a];e.push(n)}},Tr=function(e,t,a){return a&&(t=av(a,t)),e[t]},Kr=function(e,t,a,n){a&&(t=av(a,t)),e[t]=n},Jc=(function(){function r(){dt(this,r),this._obj={}}return gt(r,[{key:"set",value:function(t,a){return this._obj[t]=a,this}},{key:"delete",value:function(t){return this._obj[t]=void 0,this}},{key:"clear",value:function(){this._obj={}}},{key:"has",value:function(t){return this._obj[t]!==void 0}},{key:"get",value:function(t){return this._obj[t]}}])})(),Xr=typeof Map<"u"?Map:Jc,jc="undefined",eh=(function(){function r(e){if(dt(this,r),this._obj=Object.create(null),this.size=0,e!=null){var t;e.instanceString!=null&&e.instanceString()===this.instanceString()?t=e.toArray():t=e;for(var a=0;a<t.length;a++)this.add(t[a])}}return gt(r,[{key:"instanceString",value:function(){return"set"}},{key:"add",value:function(t){var a=this._obj;a[t]!==1&&(a[t]=1,this.size++)}},{key:"delete",value:function(t){var a=this._obj;a[t]===1&&(a[t]=0,this.size--)}},{key:"clear",value:function(){this._obj=Object.create(null)}},{key:"has",value:function(t){return this._obj[t]===1}},{key:"toArray",value:function(){var t=this;return Object.keys(this._obj).filter(function(a){return t.has(a)})}},{key:"forEach",value:function(t,a){return this.toArray().forEach(t,a)}}])})(),ra=(typeof Set>"u"?"undefined":ar(Set))!==jc?Set:eh,In=function(e,t){var a=arguments.length>2&&arguments[2]!==void 0?arguments[2]:!0;if(e===void 0||t===void 0||!Zo(e)){$e("An element must have a core reference and parameters set");return}var n=t.group;if(n==null&&(t.data&&t.data.source!=null&&t.data.target!=null?n="edges":n="nodes"),n!=="nodes"&&n!=="edges"){$e("An element must be of type `nodes` or `edges`; you specified `"+n+"`");return}this.length=1,this[0]=this;var i=this._private={cy:e,single:!0,data:t.data||{},position:t.position||{x:0,y:0},autoWidth:void 0,autoHeight:void 0,autoPadding:void 0,compoundBoundsClean:!1,listeners:[],group:n,style:{},rstyle:{},styleCxts:[],styleKeys:{},removed:!0,selected:!!t.selected,selectable:t.selectable===void 0?!0:!!t.selectable,locked:!!t.locked,grabbed:!1,grabbable:t.grabbable===void 0?!0:!!t.grabbable,pannable:t.pannable===void 0?n==="edges":!!t.pannable,active:!1,classes:new ra,animation:{current:[],queue:[]},rscratch:{},scratch:t.scratch||{},edges:[],children:[],parent:t.parent&&t.parent.isNode()?t.parent:null,traversalCache:{},backgrounding:!1,bbCache:null,bbCacheShift:{x:0,y:0},bodyBounds:null,overlayBounds:null,labelBounds:{all:null,source:null,target:null,main:null},arrowBounds:{source:null,target:null,"mid-source":null,"mid-target":null}};if(i.position.x==null&&(i.position.x=0),i.position.y==null&&(i.position.y=0),t.renderedPosition){var o=t.renderedPosition,s=e.pan(),l=e.zoom();i.position={x:(o.x-s.x)/l,y:(o.y-s.y)/l}}var u=[];_e(t.classes)?u=t.classes:ge(t.classes)&&(u=t.classes.split(/\s+/));for(var v=0,f=u.length;v<f;v++){var c=u[v];!c||c===""||i.classes.add(c)}this.createEmitter(),(a===void 0||a)&&this.restore();var d=t.style||t.css;d&&(Ve("Setting a `style` bypass at element creation should be done only when absolutely necessary.  Try to use the stylesheet instead."),this.style(d))},Hs=function(e){return e={bfs:e.bfs||!e.dfs,dfs:e.dfs||!e.bfs},function(a,n,i){var o;Le(a)&&!Dr(a)&&(o=a,a=o.roots||o.root,n=o.visit,i=o.directed),i=arguments.length===2&&!Ue(n)?n:i,n=Ue(n)?n:function(){};for(var s=this._private.cy,l=a=ge(a)?this.filter(a):a,u=[],v=[],f={},c={},d={},h=0,y,g=this.byGroup(),p=g.nodes,m=g.edges,b=0;b<l.length;b++){var w=l[b],E=w.id();w.isNode()&&(u.unshift(w),e.bfs&&(d[E]=!0,v.push(w)),c[E]=0)}for(var C=function(){var A=e.bfs?u.shift():u.pop(),R=A.id();if(e.dfs){if(d[R])return 0;d[R]=!0,v.push(A)}var L=c[R],I=f[R],M=I!=null?I.source():null,O=I!=null?I.target():null,V=I==null?void 0:A.same(M)?O[0]:M[0],G;if(G=n(A,I,V,h++,L),G===!0)return y=A,1;if(G===!1)return 1;for(var N=A.connectedEdges().filter(function(j){return(!i||j.source().same(A))&&m.has(j)}),F=0;F<N.length;F++){var U=N[F],Q=U.connectedNodes().filter(function(j){return!j.same(A)&&p.has(j)}),K=Q.id();Q.length!==0&&!d[K]&&(Q=Q[0],u.push(Q),e.bfs&&(d[K]=!0,v.push(Q)),f[K]=U,c[K]=c[R]+1)}},x;u.length!==0&&(x=C(),!(x!==0&&x===1)););for(var T=s.collection(),k=0;k<v.length;k++){var D=v[k],B=f[D.id()];B!=null&&T.push(B),T.push(D)}return{path:s.collection(T),found:s.collection(y)}}},Sa={breadthFirstSearch:Hs({bfs:!0}),depthFirstSearch:Hs({dfs:!0})};Sa.bfs=Sa.breadthFirstSearch;Sa.dfs=Sa.depthFirstSearch;var sn={exports:{}},rh=sn.exports,Ws;function th(){return Ws||(Ws=1,(function(r,e){(function(){var t,a,n,i,o,s,l,u,v,f,c,d,h,y,g;n=Math.floor,f=Math.min,a=function(p,m){return p<m?-1:p>m?1:0},v=function(p,m,b,w,E){var C;if(b==null&&(b=0),E==null&&(E=a),b<0)throw new Error("lo must be non-negative");for(w==null&&(w=p.length);b<w;)C=n((b+w)/2),E(m,p[C])<0?w=C:b=C+1;return[].splice.apply(p,[b,b-b].concat(m)),m},s=function(p,m,b){return b==null&&(b=a),p.push(m),y(p,0,p.length-1,b)},o=function(p,m){var b,w;return m==null&&(m=a),b=p.pop(),p.length?(w=p[0],p[0]=b,g(p,0,m)):w=b,w},u=function(p,m,b){var w;return b==null&&(b=a),w=p[0],p[0]=m,g(p,0,b),w},l=function(p,m,b){var w;return b==null&&(b=a),p.length&&b(p[0],m)<0&&(w=[p[0],m],m=w[0],p[0]=w[1],g(p,0,b)),m},i=function(p,m){var b,w,E,C,x,T;for(m==null&&(m=a),C=(function(){T=[];for(var k=0,D=n(p.length/2);0<=D?k<D:k>D;0<=D?k++:k--)T.push(k);return T}).apply(this).reverse(),x=[],w=0,E=C.length;w<E;w++)b=C[w],x.push(g(p,b,m));return x},h=function(p,m,b){var w;if(b==null&&(b=a),w=p.indexOf(m),w!==-1)return y(p,0,w,b),g(p,w,b)},c=function(p,m,b){var w,E,C,x,T;if(b==null&&(b=a),E=p.slice(0,m),!E.length)return E;for(i(E,b),T=p.slice(m),C=0,x=T.length;C<x;C++)w=T[C],l(E,w,b);return E.sort(b).reverse()},d=function(p,m,b){var w,E,C,x,T,k,D,B,P;if(b==null&&(b=a),m*10<=p.length){if(C=p.slice(0,m).sort(b),!C.length)return C;for(E=C[C.length-1],D=p.slice(m),x=0,k=D.length;x<k;x++)w=D[x],b(w,E)<0&&(v(C,w,0,null,b),C.pop(),E=C[C.length-1]);return C}for(i(p,b),P=[],T=0,B=f(m,p.length);0<=B?T<B:T>B;0<=B?++T:--T)P.push(o(p,b));return P},y=function(p,m,b,w){var E,C,x;for(w==null&&(w=a),E=p[b];b>m;){if(x=b-1>>1,C=p[x],w(E,C)<0){p[b]=C,b=x;continue}break}return p[b]=E},g=function(p,m,b){var w,E,C,x,T;for(b==null&&(b=a),E=p.length,T=m,C=p[m],w=2*m+1;w<E;)x=w+1,x<E&&!(b(p[w],p[x])<0)&&(w=x),p[m]=p[w],m=w,w=2*m+1;return p[m]=C,y(p,T,m,b)},t=(function(){p.push=s,p.pop=o,p.replace=u,p.pushpop=l,p.heapify=i,p.updateItem=h,p.nlargest=c,p.nsmallest=d;function p(m){this.cmp=m??a,this.nodes=[]}return p.prototype.push=function(m){return s(this.nodes,m,this.cmp)},p.prototype.pop=function(){return o(this.nodes,this.cmp)},p.prototype.peek=function(){return this.nodes[0]},p.prototype.contains=function(m){return this.nodes.indexOf(m)!==-1},p.prototype.replace=function(m){return u(this.nodes,m,this.cmp)},p.prototype.pushpop=function(m){return l(this.nodes,m,this.cmp)},p.prototype.heapify=function(){return i(this.nodes,this.cmp)},p.prototype.updateItem=function(m){return h(this.nodes,m,this.cmp)},p.prototype.clear=function(){return this.nodes=[]},p.prototype.empty=function(){return this.nodes.length===0},p.prototype.size=function(){return this.nodes.length},p.prototype.clone=function(){var m;return m=new p,m.nodes=this.nodes.slice(0),m},p.prototype.toArray=function(){return this.nodes.slice(0)},p.prototype.insert=p.prototype.push,p.prototype.top=p.prototype.peek,p.prototype.front=p.prototype.peek,p.prototype.has=p.prototype.contains,p.prototype.copy=p.prototype.clone,p})(),(function(p,m){return r.exports=m()})(this,function(){return t})}).call(rh)})(sn)),sn.exports}var hi,$s;function ah(){return $s||($s=1,hi=th()),hi}var nh=ah(),Va=Oa(nh),ih=cr({root:null,weight:function(e){return 1},directed:!1}),oh={dijkstra:function(e){if(!Le(e)){var t=arguments;e={root:t[0],weight:t[1],directed:t[2]}}var a=ih(e),n=a.root,i=a.weight,o=a.directed,s=this,l=i,u=ge(n)?this.filter(n)[0]:n[0],v={},f={},c={},d=this.byGroup(),h=d.nodes,y=d.edges;y.unmergeBy(function(L){return L.isLoop()});for(var g=function(I){return v[I.id()]},p=function(I,M){v[I.id()]=M,m.updateItem(I)},m=new Va(function(L,I){return g(L)-g(I)}),b=0;b<h.length;b++){var w=h[b];v[w.id()]=w.same(u)?0:1/0,m.push(w)}for(var E=function(I,M){for(var O=(o?I.edgesTo(M):I.edgesWith(M)).intersect(y),V=1/0,G,N=0;N<O.length;N++){var F=O[N],U=l(F);(U<V||!G)&&(V=U,G=F)}return{edge:G,dist:V}};m.size()>0;){var C=m.pop(),x=g(C),T=C.id();if(c[T]=x,x!==1/0)for(var k=C.neighborhood().intersect(h),D=0;D<k.length;D++){var B=k[D],P=B.id(),A=E(C,B),R=x+A.dist;R<g(B)&&(p(B,R),f[P]={node:C,edge:A.edge})}}return{distanceTo:function(I){var M=ge(I)?h.filter(I)[0]:I[0];return c[M.id()]},pathTo:function(I){var M=ge(I)?h.filter(I)[0]:I[0],O=[],V=M,G=V.id();if(M.length>0)for(O.unshift(M);f[G];){var N=f[G];O.unshift(N.edge),O.unshift(N.node),V=N.node,G=V.id()}return s.spawn(O)}}}},sh={kruskal:function(e){e=e||function(b){return 1};for(var t=this.byGroup(),a=t.nodes,n=t.edges,i=a.length,o=new Array(i),s=a,l=function(w){for(var E=0;E<o.length;E++){var C=o[E];if(C.has(w))return E}},u=0;u<i;u++)o[u]=this.spawn(a[u]);for(var v=n.sort(function(b,w){return e(b)-e(w)}),f=0;f<v.length;f++){var c=v[f],d=c.source()[0],h=c.target()[0],y=l(d),g=l(h),p=o[y],m=o[g];y!==g&&(s.merge(c),p.merge(m),o.splice(g,1))}return s}},uh=cr({root:null,goal:null,weight:function(e){return 1},heuristic:function(e){return 0},directed:!1}),lh={aStar:function(e){var t=this.cy(),a=uh(e),n=a.root,i=a.goal,o=a.heuristic,s=a.directed,l=a.weight;n=t.collection(n)[0],i=t.collection(i)[0];var u=n.id(),v=i.id(),f={},c={},d={},h=new Va(function(G,N){return c[G.id()]-c[N.id()]}),y=new ra,g={},p={},m=function(N,F){h.push(N),y.add(F)},b,w,E=function(){b=h.pop(),w=b.id(),y.delete(w)},C=function(N){return y.has(N)};m(n,u),f[u]=0,c[u]=o(n);for(var x=0;h.size()>0;){if(E(),x++,w===v){for(var T=[],k=i,D=v,B=p[D];T.unshift(k),B!=null&&T.unshift(B),k=g[D],k!=null;)D=k.id(),B=p[D];return{found:!0,distance:f[w],path:this.spawn(T),steps:x}}d[w]=!0;for(var P=b._private.edges,A=0;A<P.length;A++){var R=P[A];if(this.hasElementWithId(R.id())&&!(s&&R.data("source")!==w)){var L=R.source(),I=R.target(),M=L.id()!==w?L:I,O=M.id();if(this.hasElementWithId(O)&&!d[O]){var V=f[w]+l(R);if(!C(O)){f[O]=V,c[O]=V+o(M),m(M,O),g[O]=b,p[O]=R;continue}V<f[O]&&(f[O]=V,c[O]=V+o(M),g[O]=b,p[O]=R)}}}}return{found:!1,distance:void 0,path:void 0,steps:x}}},vh=cr({weight:function(e){return 1},directed:!1}),fh={floydWarshall:function(e){for(var t=this.cy(),a=vh(e),n=a.weight,i=a.directed,o=n,s=this.byGroup(),l=s.nodes,u=s.edges,v=l.length,f=v*v,c=function(U){return l.indexOf(U)},d=function(U){return l[U]},h=new Array(f),y=0;y<f;y++){var g=y%v,p=(y-g)/v;p===g?h[y]=0:h[y]=1/0}for(var m=new Array(f),b=new Array(f),w=0;w<u.length;w++){var E=u[w],C=E.source()[0],x=E.target()[0];if(C!==x){var T=c(C),k=c(x),D=T*v+k,B=o(E);if(h[D]>B&&(h[D]=B,m[D]=k,b[D]=E),!i){var P=k*v+T;!i&&h[P]>B&&(h[P]=B,m[P]=T,b[P]=E)}}}for(var A=0;A<v;A++)for(var R=0;R<v;R++)for(var L=R*v+A,I=0;I<v;I++){var M=R*v+I,O=A*v+I;h[L]+h[O]<h[M]&&(h[M]=h[L]+h[O],m[M]=m[L])}var V=function(U){return(ge(U)?t.filter(U):U)[0]},G=function(U){return c(V(U))},N={distance:function(U,Q){var K=G(U),j=G(Q);return h[K*v+j]},path:function(U,Q){var K=G(U),j=G(Q),re=d(K);if(K===j)return re.collection();if(m[K*v+j]==null)return t.collection();var ne=t.collection(),J=K,z;for(ne.merge(re);K!==j;)J=K,K=m[K*v+j],z=b[J*v+K],ne.merge(z),ne.merge(d(K));return ne}};return N}},ch=cr({weight:function(e){return 1},directed:!1,root:null}),hh={bellmanFord:function(e){var t=this,a=ch(e),n=a.weight,i=a.directed,o=a.root,s=n,l=this,u=this.cy(),v=this.byGroup(),f=v.edges,c=v.nodes,d=c.length,h=new Xr,y=!1,g=[];o=u.collection(o)[0],f.unmergeBy(function(Ce){return Ce.isLoop()});for(var p=f.length,m=function(we){var ye=h.get(we.id());return ye||(ye={},h.set(we.id(),ye)),ye},b=function(we){return(ge(we)?u.$(we):we)[0]},w=function(we){return m(b(we)).dist},E=function(we){for(var ye=arguments.length>1&&arguments[1]!==void 0?arguments[1]:o,ie=b(we),he=[],de=ie;;){if(de==null)return t.spawn();var Ee=m(de),pe=Ee.edge,Se=Ee.pred;if(he.unshift(de[0]),de.same(ye)&&he.length>0)break;pe!=null&&he.unshift(pe),de=Se}return l.spawn(he)},C=0;C<d;C++){var x=c[C],T=m(x);x.same(o)?T.dist=0:T.dist=1/0,T.pred=null,T.edge=null}for(var k=!1,D=function(we,ye,ie,he,de,Ee){var pe=he.dist+Ee;pe<de.dist&&!ie.same(he.edge)&&(de.dist=pe,de.pred=we,de.edge=ie,k=!0)},B=1;B<d;B++){k=!1;for(var P=0;P<p;P++){var A=f[P],R=A.source(),L=A.target(),I=s(A),M=m(R),O=m(L);D(R,L,A,M,O,I),i||D(L,R,A,O,M,I)}if(!k)break}if(k)for(var V=[],G=0;G<p;G++){var N=f[G],F=N.source(),U=N.target(),Q=s(N),K=m(F).dist,j=m(U).dist;if(K+Q<j||!i&&j+Q<K)if(y||(Ve("Graph contains a negative weight cycle for Bellman-Ford"),y=!0),e.findNegativeWeightCycles!==!1){var re=[];K+Q<j&&re.push(F),!i&&j+Q<K&&re.push(U);for(var ne=re.length,J=0;J<ne;J++){var z=re[J],q=[z];q.push(m(z).edge);for(var H=m(z).pred;q.indexOf(H)===-1;)q.push(H),q.push(m(H).edge),H=m(H).pred;q=q.slice(q.indexOf(H));for(var Y=q[0].id(),te=0,ce=2;ce<q.length;ce+=2)q[ce].id()<Y&&(Y=q[ce].id(),te=ce);q=q.slice(te).concat(q.slice(0,te)),q.push(q[0]);var Ae=q.map(function(Ce){return Ce.id()}).join(",");V.indexOf(Ae)===-1&&(g.push(l.spawn(q)),V.push(Ae))}}else break}return{distanceTo:w,pathTo:E,hasNegativeWeightCycle:y,negativeWeightCycles:g}}},dh=Math.sqrt(2),gh=function(e,t,a){a.length===0&&$e("Karger-Stein must be run on a connected (sub)graph");for(var n=a[e],i=n[1],o=n[2],s=t[i],l=t[o],u=a,v=u.length-1;v>=0;v--){var f=u[v],c=f[1],d=f[2];(t[c]===s&&t[d]===l||t[c]===l&&t[d]===s)&&u.splice(v,1)}for(var h=0;h<u.length;h++){var y=u[h];y[1]===l?(u[h]=y.slice(),u[h][1]=s):y[2]===l&&(u[h]=y.slice(),u[h][2]=s)}for(var g=0;g<t.length;g++)t[g]===l&&(t[g]=s);return u},di=function(e,t,a,n){for(;a>n;){var i=Math.floor(Math.random()*t.length);t=gh(i,e,t),a--}return t},ph={kargerStein:function(){var e=this,t=this.byGroup(),a=t.nodes,n=t.edges;n.unmergeBy(function(O){return O.isLoop()});var i=a.length,o=n.length,s=Math.ceil(Math.pow(Math.log(i)/Math.LN2,2)),l=Math.floor(i/dh);if(i<2){$e("At least 2 nodes are required for Karger-Stein algorithm");return}for(var u=[],v=0;v<o;v++){var f=n[v];u.push([v,a.indexOf(f.source()),a.indexOf(f.target())])}for(var c=1/0,d=[],h=new Array(i),y=new Array(i),g=new Array(i),p=function(V,G){for(var N=0;N<i;N++)G[N]=V[N]},m=0;m<=s;m++){for(var b=0;b<i;b++)y[b]=b;var w=di(y,u.slice(),i,l),E=w.slice();p(y,g);var C=di(y,w,l,2),x=di(g,E,l,2);C.length<=x.length&&C.length<c?(c=C.length,d=C,p(y,h)):x.length<=C.length&&x.length<c&&(c=x.length,d=x,p(g,h))}for(var T=this.spawn(d.map(function(O){return n[O[0]]})),k=this.spawn(),D=this.spawn(),B=h[0],P=0;P<h.length;P++){var A=h[P],R=a[P];A===B?k.merge(R):D.merge(R)}var L=function(V){var G=e.spawn();return V.forEach(function(N){G.merge(N),N.connectedEdges().forEach(function(F){e.contains(F)&&!T.contains(F)&&G.merge(F)})}),G},I=[L(k),L(D)],M={cut:T,components:I,partition1:k,partition2:D};return M}},gi,yh=function(e){return{x:e.x,y:e.y}},On=function(e,t,a){return{x:e.x*t+a.x,y:e.y*t+a.y}},yv=function(e,t,a){return{x:(e.x-a.x)/t,y:(e.y-a.y)/t}},Wt=function(e){return{x:e[0],y:e[1]}},mh=function(e){for(var t=arguments.length>1&&arguments[1]!==void 0?arguments[1]:0,a=arguments.length>2&&arguments[2]!==void 0?arguments[2]:e.length,n=1/0,i=t;i<a;i++){var o=e[i];isFinite(o)&&(n=Math.min(o,n))}return n},bh=function(e){for(var t=arguments.length>1&&arguments[1]!==void 0?arguments[1]:0,a=arguments.length>2&&arguments[2]!==void 0?arguments[2]:e.length,n=-1/0,i=t;i<a;i++){var o=e[i];isFinite(o)&&(n=Math.max(o,n))}return n},wh=function(e){for(var t=arguments.length>1&&arguments[1]!==void 0?arguments[1]:0,a=arguments.length>2&&arguments[2]!==void 0?arguments[2]:e.length,n=0,i=0,o=t;o<a;o++){var s=e[o];isFinite(s)&&(n+=s,i++)}return n/i},xh=function(e){var t=arguments.length>1&&arguments[1]!==void 0?arguments[1]:0,a=arguments.length>2&&arguments[2]!==void 0?arguments[2]:e.length,n=arguments.length>3&&arguments[3]!==void 0?arguments[3]:!0,i=arguments.length>4&&arguments[4]!==void 0?arguments[4]:!0,o=arguments.length>5&&arguments[5]!==void 0?arguments[5]:!0;n?e=e.slice(t,a):(a<e.length&&e.splice(a,e.length-a),t>0&&e.splice(0,t));for(var s=0,l=e.length-1;l>=0;l--){var u=e[l];o?isFinite(u)||(e[l]=-1/0,s++):e.splice(l,1)}i&&e.sort(function(c,d){return c-d});var v=e.length,f=Math.floor(v/2);return v%2!==0?e[f+1+s]:(e[f-1+s]+e[f+s])/2},Eh=function(e){return Math.PI*e/180},Ya=function(e,t){return Math.atan2(t,e)-Math.PI/2},ts=Math.log2||function(r){return Math.log(r)/Math.log(2)},as=function(e){return e>0?1:e<0?-1:0},Bt=function(e,t){return Math.sqrt(Et(e,t))},Et=function(e,t){var a=t.x-e.x,n=t.y-e.y;return a*a+n*n},Ch=function(e){for(var t=e.length,a=0,n=0;n<t;n++)a+=e[n];for(var i=0;i<t;i++)e[i]=e[i]/a;return e},or=function(e,t,a,n){return(1-n)*(1-n)*e+2*(1-n)*n*t+n*n*a},Kt=function(e,t,a,n){return{x:or(e.x,t.x,a.x,n),y:or(e.y,t.y,a.y,n)}},Th=function(e,t,a,n){var i={x:t.x-e.x,y:t.y-e.y},o=Bt(e,t),s={x:i.x/o,y:i.y/o};return a=a??0,n=n??a*o,{x:e.x+s.x*n,y:e.y+s.y*n}},ka=function(e,t,a){return Math.max(e,Math.min(a,t))},wr=function(e){if(e==null)return{x1:1/0,y1:1/0,x2:-1/0,y2:-1/0,w:0,h:0};if(e.x1!=null&&e.y1!=null){if(e.x2!=null&&e.y2!=null&&e.x2>=e.x1&&e.y2>=e.y1)return{x1:e.x1,y1:e.y1,x2:e.x2,y2:e.y2,w:e.x2-e.x1,h:e.y2-e.y1};if(e.w!=null&&e.h!=null&&e.w>=0&&e.h>=0)return{x1:e.x1,y1:e.y1,x2:e.x1+e.w,y2:e.y1+e.h,w:e.w,h:e.h}}},Sh=function(e){return{x1:e.x1,x2:e.x2,w:e.w,y1:e.y1,y2:e.y2,h:e.h}},kh=function(e){e.x1=1/0,e.y1=1/0,e.x2=-1/0,e.y2=-1/0,e.w=0,e.h=0},Dh=function(e,t){e.x1=Math.min(e.x1,t.x1),e.x2=Math.max(e.x2,t.x2),e.w=e.x2-e.x1,e.y1=Math.min(e.y1,t.y1),e.y2=Math.max(e.y2,t.y2),e.h=e.y2-e.y1},mv=function(e,t,a){e.x1=Math.min(e.x1,t),e.x2=Math.max(e.x2,t),e.w=e.x2-e.x1,e.y1=Math.min(e.y1,a),e.y2=Math.max(e.y2,a),e.h=e.y2-e.y1},un=function(e){var t=arguments.length>1&&arguments[1]!==void 0?arguments[1]:0;return e.x1-=t,e.x2+=t,e.y1-=t,e.y2+=t,e.w=e.x2-e.x1,e.h=e.y2-e.y1,e},ln=function(e){var t=arguments.length>1&&arguments[1]!==void 0?arguments[1]:[0],a,n,i,o;if(t.length===1)a=n=i=o=t[0];else if(t.length===2)a=i=t[0],o=n=t[1];else if(t.length===4){var s=Je(t,4);a=s[0],n=s[1],i=s[2],o=s[3]}return e.x1-=o,e.x2+=n,e.y1-=a,e.y2+=i,e.w=e.x2-e.x1,e.h=e.y2-e.y1,e},Us=function(e,t){e.x1=t.x1,e.y1=t.y1,e.x2=t.x2,e.y2=t.y2,e.w=e.x2-e.x1,e.h=e.y2-e.y1},ns=function(e,t){return!(e.x1>t.x2||t.x1>e.x2||e.x2<t.x1||t.x2<e.x1||e.y2<t.y1||t.y2<e.y1||e.y1>t.y2||t.y1>e.y2)},nt=function(e,t,a){return e.x1<=t&&t<=e.x2&&e.y1<=a&&a<=e.y2},Ks=function(e,t){return nt(e,t.x,t.y)},bv=function(e,t){return nt(e,t.x1,t.y1)&&nt(e,t.x2,t.y2)},Bh=(gi=Math.hypot)!==null&&gi!==void 0?gi:function(r,e){return Math.sqrt(r*r+e*e)};function Ph(r,e){if(r.length<3)throw new Error("Need at least 3 vertices");var t=function(T,k){return{x:T.x+k.x,y:T.y+k.y}},a=function(T,k){return{x:T.x-k.x,y:T.y-k.y}},n=function(T,k){return{x:T.x*k,y:T.y*k}},i=function(T,k){return T.x*k.y-T.y*k.x},o=function(T){var k=Bh(T.x,T.y);return k===0?{x:0,y:0}:{x:T.x/k,y:T.y/k}},s=function(T){for(var k=0,D=0;D<T.length;D++){var B=T[D],P=T[(D+1)%T.length];k+=B.x*P.y-P.x*B.y}return k/2},l=function(T,k,D,B){var P=a(k,T),A=a(B,D),R=i(P,A);if(Math.abs(R)<1e-9)return t(T,n(P,.5));var L=i(a(D,T),A)/R;return t(T,n(P,L))},u=r.map(function(x){return{x:x.x,y:x.y}});s(u)<0&&u.reverse();for(var v=u.length,f=[],c=0;c<v;c++){var d=u[c],h=u[(c+1)%v],y=a(h,d),g=o({x:y.y,y:-y.x});f.push(g)}for(var p=f.map(function(x,T){var k=t(u[T],n(x,e)),D=t(u[(T+1)%v],n(x,e));return{p1:k,p2:D}}),m=[],b=0;b<v;b++){var w=p[(b-1+v)%v],E=p[b],C=l(w.p1,w.p2,E.p1,E.p2);m.push(C)}return m}function Ah(r,e,t,a,n,i){var o=Vh(r,e,t,a,n),s=Ph(o,i),l=wr();return s.forEach(function(u){return mv(l,u.x,u.y)}),l}var wv=function(e,t,a,n,i,o,s){var l=arguments.length>7&&arguments[7]!==void 0?arguments[7]:"auto",u=l==="auto"?vt(i,o):l,v=i/2,f=o/2;u=Math.min(u,v,f);var c=u!==v,d=u!==f,h;if(c){var y=a-v+u-s,g=n-f-s,p=a+v-u+s,m=g;if(h=it(e,t,a,n,y,g,p,m,!1),h.length>0)return h}if(d){var b=a+v+s,w=n-f+u-s,E=b,C=n+f-u+s;if(h=it(e,t,a,n,b,w,E,C,!1),h.length>0)return h}if(c){var x=a-v+u-s,T=n+f+s,k=a+v-u+s,D=T;if(h=it(e,t,a,n,x,T,k,D,!1),h.length>0)return h}if(d){var B=a-v-s,P=n-f+u-s,A=B,R=n+f-u+s;if(h=it(e,t,a,n,B,P,A,R,!1),h.length>0)return h}var L;{var I=a-v+u,M=n-f+u;if(L=ya(e,t,a,n,I,M,u+s),L.length>0&&L[0]<=I&&L[1]<=M)return[L[0],L[1]]}{var O=a+v-u,V=n-f+u;if(L=ya(e,t,a,n,O,V,u+s),L.length>0&&L[0]>=O&&L[1]<=V)return[L[0],L[1]]}{var G=a+v-u,N=n+f-u;if(L=ya(e,t,a,n,G,N,u+s),L.length>0&&L[0]>=G&&L[1]>=N)return[L[0],L[1]]}{var F=a-v+u,U=n+f-u;if(L=ya(e,t,a,n,F,U,u+s),L.length>0&&L[0]<=F&&L[1]>=U)return[L[0],L[1]]}return[]},Rh=function(e,t,a,n,i,o,s){var l=s,u=Math.min(a,i),v=Math.max(a,i),f=Math.min(n,o),c=Math.max(n,o);return u-l<=e&&e<=v+l&&f-l<=t&&t<=c+l},Mh=function(e,t,a,n,i,o,s,l,u){var v={x1:Math.min(a,s,i)-u,x2:Math.max(a,s,i)+u,y1:Math.min(n,l,o)-u,y2:Math.max(n,l,o)+u};return!(e<v.x1||e>v.x2||t<v.y1||t>v.y2)},Lh=function(e,t,a,n){a-=n;var i=t*t-4*e*a;if(i<0)return[];var o=Math.sqrt(i),s=2*e,l=(-t+o)/s,u=(-t-o)/s;return[l,u]},Ih=function(e,t,a,n,i){var o=1e-5;e===0&&(e=o),t/=e,a/=e,n/=e;var s,l,u,v,f,c,d,h;if(l=(3*a-t*t)/9,u=-(27*n)+t*(9*a-2*(t*t)),u/=54,s=l*l*l+u*u,i[1]=0,d=t/3,s>0){f=u+Math.sqrt(s),f=f<0?-Math.pow(-f,1/3):Math.pow(f,1/3),c=u-Math.sqrt(s),c=c<0?-Math.pow(-c,1/3):Math.pow(c,1/3),i[0]=-d+f+c,d+=(f+c)/2,i[4]=i[2]=-d,d=Math.sqrt(3)*(-c+f)/2,i[3]=d,i[5]=-d;return}if(i[5]=i[3]=0,s===0){h=u<0?-Math.pow(-u,1/3):Math.pow(u,1/3),i[0]=-d+2*h,i[4]=i[2]=-(h+d);return}l=-l,v=l*l*l,v=Math.acos(u/Math.sqrt(v)),h=2*Math.sqrt(l),i[0]=-d+h*Math.cos(v/3),i[2]=-d+h*Math.cos((v+2*Math.PI)/3),i[4]=-d+h*Math.cos((v+4*Math.PI)/3)},Oh=function(e,t,a,n,i,o,s,l){var u=1*a*a-4*a*i+2*a*s+4*i*i-4*i*s+s*s+n*n-4*n*o+2*n*l+4*o*o-4*o*l+l*l,v=9*a*i-3*a*a-3*a*s-6*i*i+3*i*s+9*n*o-3*n*n-3*n*l-6*o*o+3*o*l,f=3*a*a-6*a*i+a*s-a*e+2*i*i+2*i*e-s*e+3*n*n-6*n*o+n*l-n*t+2*o*o+2*o*t-l*t,c=1*a*i-a*a+a*e-i*e+n*o-n*n+n*t-o*t,d=[];Ih(u,v,f,c,d);for(var h=1e-7,y=[],g=0;g<6;g+=2)Math.abs(d[g+1])<h&&d[g]>=0&&d[g]<=1&&y.push(d[g]);y.push(1),y.push(0);for(var p=-1,m,b,w,E=0;E<y.length;E++)m=Math.pow(1-y[E],2)*a+2*(1-y[E])*y[E]*i+y[E]*y[E]*s,b=Math.pow(1-y[E],2)*n+2*(1-y[E])*y[E]*o+y[E]*y[E]*l,w=Math.pow(m-e,2)+Math.pow(b-t,2),p>=0?w<p&&(p=w):p=w;return p},Nh=function(e,t,a,n,i,o){var s=[e-a,t-n],l=[i-a,o-n],u=l[0]*l[0]+l[1]*l[1],v=s[0]*s[0]+s[1]*s[1],f=s[0]*l[0]+s[1]*l[1],c=f*f/u;return f<0?v:c>u?(e-i)*(e-i)+(t-o)*(t-o):v-c},Sr=function(e,t,a){for(var n,i,o,s,l,u=0,v=0;v<a.length/2;v++)if(n=a[v*2],i=a[v*2+1],v+1<a.length/2?(o=a[(v+1)*2],s=a[(v+1)*2+1]):(o=a[(v+1-a.length/2)*2],s=a[(v+1-a.length/2)*2+1]),!(n==e&&o==e))if(n>=e&&e>=o||n<=e&&e<=o)l=(e-n)/(o-n)*(s-i)+i,l>t&&u++;else continue;return u%2!==0},Zr=function(e,t,a,n,i,o,s,l,u){var v=new Array(a.length),f;l[0]!=null?(f=Math.atan(l[1]/l[0]),l[0]<0?f=f+Math.PI/2:f=-f-Math.PI/2):f=l;for(var c=Math.cos(-f),d=Math.sin(-f),h=0;h<v.length/2;h++)v[h*2]=o/2*(a[h*2]*c-a[h*2+1]*d),v[h*2+1]=s/2*(a[h*2+1]*c+a[h*2]*d),v[h*2]+=n,v[h*2+1]+=i;var y;if(u>0){var g=Cn(v,-u);y=En(g)}else y=v;return Sr(e,t,y)},zh=function(e,t,a,n,i,o,s,l){for(var u=new Array(a.length*2),v=0;v<l.length;v++){var f=l[v];u[v*4+0]=f.startX,u[v*4+1]=f.startY,u[v*4+2]=f.stopX,u[v*4+3]=f.stopY;var c=Math.pow(f.cx-e,2)+Math.pow(f.cy-t,2);if(c<=Math.pow(f.radius,2))return!0}return Sr(e,t,u)},En=function(e){for(var t=new Array(e.length/2),a,n,i,o,s,l,u,v,f=0;f<e.length/4;f++){a=e[f*4],n=e[f*4+1],i=e[f*4+2],o=e[f*4+3],f<e.length/4-1?(s=e[(f+1)*4],l=e[(f+1)*4+1],u=e[(f+1)*4+2],v=e[(f+1)*4+3]):(s=e[0],l=e[1],u=e[2],v=e[3]);var c=it(a,n,i,o,s,l,u,v,!0);t[f*2]=c[0],t[f*2+1]=c[1]}return t},Cn=function(e,t){for(var a=new Array(e.length*2),n,i,o,s,l=0;l<e.length/2;l++){n=e[l*2],i=e[l*2+1],l<e.length/2-1?(o=e[(l+1)*2],s=e[(l+1)*2+1]):(o=e[0],s=e[1]);var u=s-i,v=-(o-n),f=Math.sqrt(u*u+v*v),c=u/f,d=v/f;a[l*4]=n+c*t,a[l*4+1]=i+d*t,a[l*4+2]=o+c*t,a[l*4+3]=s+d*t}return a},Fh=function(e,t,a,n,i,o){var s=a-e,l=n-t;s/=i,l/=o;var u=Math.sqrt(s*s+l*l),v=u-1;if(v<0)return[];var f=v/u;return[(a-e)*f+e,(n-t)*f+t]},kt=function(e,t,a,n,i,o,s){return e-=i,t-=o,e/=a/2+s,t/=n/2+s,e*e+t*t<=1},ya=function(e,t,a,n,i,o,s){var l=[a-e,n-t],u=[e-i,t-o],v=l[0]*l[0]+l[1]*l[1],f=2*(u[0]*l[0]+u[1]*l[1]),c=u[0]*u[0]+u[1]*u[1]-s*s,d=f*f-4*v*c;if(d<0)return[];var h=(-f+Math.sqrt(d))/(2*v),y=(-f-Math.sqrt(d))/(2*v),g=Math.min(h,y),p=Math.max(h,y),m=[];if(g>=0&&g<=1&&m.push(g),p>=0&&p<=1&&m.push(p),m.length===0)return[];var b=m[0]*l[0]+e,w=m[0]*l[1]+t;if(m.length>1){if(m[0]==m[1])return[b,w];var E=m[1]*l[0]+e,C=m[1]*l[1]+t;return[b,w,E,C]}else return[b,w]},pi=function(e,t,a){return t<=e&&e<=a||a<=e&&e<=t?e:e<=t&&t<=a||a<=t&&t<=e?t:a},it=function(e,t,a,n,i,o,s,l,u){var v=e-i,f=a-e,c=s-i,d=t-o,h=n-t,y=l-o,g=c*d-y*v,p=f*d-h*v,m=y*f-c*h;if(m!==0){var b=g/m,w=p/m,E=.001,C=0-E,x=1+E;return C<=b&&b<=x&&C<=w&&w<=x?[e+b*f,t+b*h]:u?[e+b*f,t+b*h]:[]}else return g===0||p===0?pi(e,a,s)===s?[s,l]:pi(e,a,i)===i?[i,o]:pi(i,s,a)===a?[a,n]:[]:[]},Vh=function(e,t,a,n,i){var o=[],s=n/2,l=i/2,u=t,v=a;o.push({x:u+s*e[0],y:v+l*e[1]});for(var f=1;f<e.length/2;f++)o.push({x:u+s*e[f*2],y:v+l*e[f*2+1]});return o},Da=function(e,t,a,n,i,o,s,l){var u=[],v,f=new Array(a.length),c=!0;o==null&&(c=!1);var d;if(c){for(var h=0;h<f.length/2;h++)f[h*2]=a[h*2]*o+n,f[h*2+1]=a[h*2+1]*s+i;if(l>0){var y=Cn(f,-l);d=En(y)}else d=f}else d=a;for(var g,p,m,b,w=0;w<d.length/2;w++)g=d[w*2],p=d[w*2+1],w<d.length/2-1?(m=d[(w+1)*2],b=d[(w+1)*2+1]):(m=d[0],b=d[1]),v=it(e,t,n,i,g,p,m,b),v.length!==0&&u.push(v[0],v[1]);return u},qh=function(e,t,a,n,i,o,s,l,u){var v=[],f,c=new Array(a.length*2);u.forEach(function(m,b){b===0?(c[c.length-2]=m.startX,c[c.length-1]=m.startY):(c[b*4-2]=m.startX,c[b*4-1]=m.startY),c[b*4]=m.stopX,c[b*4+1]=m.stopY,f=ya(e,t,n,i,m.cx,m.cy,m.radius),f.length!==0&&v.push(f[0],f[1])});for(var d=0;d<c.length/4;d++)f=it(e,t,n,i,c[d*4],c[d*4+1],c[d*4+2],c[d*4+3],!1),f.length!==0&&v.push(f[0],f[1]);if(v.length>2){for(var h=[v[0],v[1]],y=Math.pow(h[0]-e,2)+Math.pow(h[1]-t,2),g=1;g<v.length/2;g++){var p=Math.pow(v[g*2]-e,2)+Math.pow(v[g*2+1]-t,2);p<=y&&(h[0]=v[g*2],h[1]=v[g*2+1],y=p)}return h}return v},Za=function(e,t,a){var n=[e[0]-t[0],e[1]-t[1]],i=Math.sqrt(n[0]*n[0]+n[1]*n[1]),o=(i-a)/i;return o<0&&(o=1e-5),[t[0]+o*n[0],t[1]+o*n[1]]},br=function(e,t){var a=Ao(e,t);return a=xv(a),a},xv=function(e){for(var t,a,n=e.length/2,i=1/0,o=1/0,s=-1/0,l=-1/0,u=0;u<n;u++)t=e[2*u],a=e[2*u+1],i=Math.min(i,t),s=Math.max(s,t),o=Math.min(o,a),l=Math.max(l,a);for(var v=2/(s-i),f=2/(l-o),c=0;c<n;c++)t=e[2*c]=e[2*c]*v,a=e[2*c+1]=e[2*c+1]*f,i=Math.min(i,t),s=Math.max(s,t),o=Math.min(o,a),l=Math.max(l,a);if(o<-1)for(var d=0;d<n;d++)a=e[2*d+1]=e[2*d+1]+(-1-o);return e},Ao=function(e,t){var a=1/e*2*Math.PI,n=e%2===0?Math.PI/2+a/2:Math.PI/2;n+=t;for(var i=new Array(e*2),o,s=0;s<e;s++)o=s*a+n,i[2*s]=Math.cos(o),i[2*s+1]=Math.sin(-o);return i},vt=function(e,t){return Math.min(e/4,t/4,8)},Ev=function(e,t){return Math.min(e/10,t/10,8)},is=function(){return 8},_h=function(e,t,a){return[e-2*t+a,2*(t-e),e]},Ro=function(e,t){return{heightOffset:Math.min(15,.05*t),widthOffset:Math.min(100,.25*e),ctrlPtOffsetPct:.05}};function yi(r,e){function t(f){for(var c=[],d=0;d<f.length;d++){var h=f[d],y=f[(d+1)%f.length],g={x:y.x-h.x,y:y.y-h.y},p={x:-g.y,y:g.x},m=Math.sqrt(p.x*p.x+p.y*p.y);c.push({x:p.x/m,y:p.y/m})}return c}function a(f,c){var d=1/0,h=-1/0,y=kr(f),g;try{for(y.s();!(g=y.n()).done;){var p=g.value,m=p.x*c.x+p.y*c.y;d=Math.min(d,m),h=Math.max(h,m)}}catch(b){y.e(b)}finally{y.f()}return{min:d,max:h}}function n(f,c){return!(f.max<c.min||c.max<f.min)}var i=[].concat(mn(t(r)),mn(t(e))),o=kr(i),s;try{for(o.s();!(s=o.n()).done;){var l=s.value,u=a(r,l),v=a(e,l);if(!n(u,v))return!1}}catch(f){o.e(f)}finally{o.f()}return!0}var Gh=cr({dampingFactor:.8,precision:1e-6,iterations:200,weight:function(e){return 1}}),Hh={pageRank:function(e){for(var t=Gh(e),a=t.dampingFactor,n=t.precision,i=t.iterations,o=t.weight,s=this._private.cy,l=this.byGroup(),u=l.nodes,v=l.edges,f=u.length,c=f*f,d=v.length,h=new Array(c),y=new Array(f),g=(1-a)/f,p=0;p<f;p++){for(var m=0;m<f;m++){var b=p*f+m;h[b]=0}y[p]=0}for(var w=0;w<d;w++){var E=v[w],C=E.data("source"),x=E.data("target");if(C!==x){var T=u.indexOfId(C),k=u.indexOfId(x),D=o(E),B=k*f+T;h[B]+=D,y[T]+=D}}for(var P=1/f+g,A=0;A<f;A++)if(y[A]===0)for(var R=0;R<f;R++){var L=R*f+A;h[L]=P}else for(var I=0;I<f;I++){var M=I*f+A;h[M]=h[M]/y[A]+g}for(var O=new Array(f),V=new Array(f),G,N=0;N<f;N++)O[N]=1;for(var F=0;F<i;F++){for(var U=0;U<f;U++)V[U]=0;for(var Q=0;Q<f;Q++)for(var K=0;K<f;K++){var j=Q*f+K;V[Q]+=h[j]*O[K]}Ch(V),G=O,O=V,V=G;for(var re=0,ne=0;ne<f;ne++){var J=G[ne]-O[ne];re+=J*J}if(re<n)break}var z={rank:function(H){return H=s.collection(H)[0],O[u.indexOf(H)]}};return z}},Xs=cr({root:null,weight:function(e){return 1},directed:!1,alpha:0}),Xt={degreeCentralityNormalized:function(e){e=Xs(e);var t=this.cy(),a=this.nodes(),n=a.length;if(e.directed){for(var v={},f={},c=0,d=0,h=0;h<n;h++){var y=a[h],g=y.id();e.root=y;var p=this.degreeCentrality(e);c<p.indegree&&(c=p.indegree),d<p.outdegree&&(d=p.outdegree),v[g]=p.indegree,f[g]=p.outdegree}return{indegree:function(b){return c==0?0:(ge(b)&&(b=t.filter(b)),v[b.id()]/c)},outdegree:function(b){return d===0?0:(ge(b)&&(b=t.filter(b)),f[b.id()]/d)}}}else{for(var i={},o=0,s=0;s<n;s++){var l=a[s];e.root=l;var u=this.degreeCentrality(e);o<u.degree&&(o=u.degree),i[l.id()]=u.degree}return{degree:function(b){return o===0?0:(ge(b)&&(b=t.filter(b)),i[b.id()]/o)}}}},degreeCentrality:function(e){e=Xs(e);var t=this.cy(),a=this,n=e,i=n.root,o=n.weight,s=n.directed,l=n.alpha;if(i=t.collection(i)[0],s){for(var d=i.connectedEdges(),h=d.filter(function(C){return C.target().same(i)&&a.has(C)}),y=d.filter(function(C){return C.source().same(i)&&a.has(C)}),g=h.length,p=y.length,m=0,b=0,w=0;w<h.length;w++)m+=o(h[w]);for(var E=0;E<y.length;E++)b+=o(y[E]);return{indegree:Math.pow(g,1-l)*Math.pow(m,l),outdegree:Math.pow(p,1-l)*Math.pow(b,l)}}else{for(var u=i.connectedEdges().intersection(a),v=u.length,f=0,c=0;c<u.length;c++)f+=o(u[c]);return{degree:Math.pow(v,1-l)*Math.pow(f,l)}}}};Xt.dc=Xt.degreeCentrality;Xt.dcn=Xt.degreeCentralityNormalised=Xt.degreeCentralityNormalized;var Ys=cr({harmonic:!0,weight:function(){return 1},directed:!1,root:null}),Yt={closenessCentralityNormalized:function(e){for(var t=Ys(e),a=t.harmonic,n=t.weight,i=t.directed,o=this.cy(),s={},l=0,u=this.nodes(),v=this.floydWarshall({weight:n,directed:i}),f=0;f<u.length;f++){for(var c=0,d=u[f],h=0;h<u.length;h++)if(f!==h){var y=v.distance(d,u[h]);a?c+=1/y:c+=y}a||(c=1/c),l<c&&(l=c),s[d.id()]=c}return{closeness:function(p){return l==0?0:(ge(p)?p=o.filter(p)[0].id():p=p.id(),s[p]/l)}}},closenessCentrality:function(e){var t=Ys(e),a=t.root,n=t.weight,i=t.directed,o=t.harmonic;a=this.filter(a)[0];for(var s=this.dijkstra({root:a,weight:n,directed:i}),l=0,u=this.nodes(),v=0;v<u.length;v++){var f=u[v];if(!f.same(a)){var c=s.distanceTo(f);o?l+=1/c:l+=c}}return o?l:1/l}};Yt.cc=Yt.closenessCentrality;Yt.ccn=Yt.closenessCentralityNormalised=Yt.closenessCentralityNormalized;var Wh=cr({weight:null,directed:!1}),Mo={betweennessCentrality:function(e){for(var t=Wh(e),a=t.directed,n=t.weight,i=n!=null,o=this.cy(),s=this.nodes(),l={},u={},v=0,f={set:function(b,w){u[b]=w,w>v&&(v=w)},get:function(b){return u[b]}},c=0;c<s.length;c++){var d=s[c],h=d.id();a?l[h]=d.outgoers().nodes():l[h]=d.openNeighborhood().nodes(),f.set(h,0)}for(var y=function(){for(var b=s[g].id(),w=[],E={},C={},x={},T=new Va(function(Q,K){return x[Q]-x[K]}),k=0;k<s.length;k++){var D=s[k].id();E[D]=[],C[D]=0,x[D]=1/0}for(C[b]=1,x[b]=0,T.push(b);!T.empty();){var B=T.pop();if(w.push(B),i)for(var P=0;P<l[B].length;P++){var A=l[B][P],R=o.getElementById(B),L=void 0;R.edgesTo(A).length>0?L=R.edgesTo(A)[0]:L=A.edgesTo(R)[0];var I=n(L);A=A.id(),x[A]>x[B]+I&&(x[A]=x[B]+I,T.nodes.indexOf(A)<0?T.push(A):T.updateItem(A),C[A]=0,E[A]=[]),x[A]==x[B]+I&&(C[A]=C[A]+C[B],E[A].push(B))}else for(var M=0;M<l[B].length;M++){var O=l[B][M].id();x[O]==1/0&&(T.push(O),x[O]=x[B]+1),x[O]==x[B]+1&&(C[O]=C[O]+C[B],E[O].push(B))}}for(var V={},G=0;G<s.length;G++)V[s[G].id()]=0;for(;w.length>0;){for(var N=w.pop(),F=0;F<E[N].length;F++){var U=E[N][F];V[U]=V[U]+C[U]/C[N]*(1+V[N])}N!=s[g].id()&&f.set(N,f.get(N)+V[N])}},g=0;g<s.length;g++)y();var p={betweenness:function(b){var w=o.collection(b).id();return f.get(w)},betweennessNormalized:function(b){if(v==0)return 0;var w=o.collection(b).id();return f.get(w)/v}};return p.betweennessNormalised=p.betweennessNormalized,p}};Mo.bc=Mo.betweennessCentrality;var $h=cr({expandFactor:2,inflateFactor:2,multFactor:1,maxIterations:20,attributes:[function(r){return 1}]}),Uh=function(e){return $h(e)},Kh=function(e,t){for(var a=0,n=0;n<t.length;n++)a+=t[n](e);return a},Xh=function(e,t,a){for(var n=0;n<t;n++)e[n*t+n]=a},Cv=function(e,t){for(var a,n=0;n<t;n++){a=0;for(var i=0;i<t;i++)a+=e[i*t+n];for(var o=0;o<t;o++)e[o*t+n]=e[o*t+n]/a}},Yh=function(e,t,a){for(var n=new Array(a*a),i=0;i<a;i++){for(var o=0;o<a;o++)n[i*a+o]=0;for(var s=0;s<a;s++)for(var l=0;l<a;l++)n[i*a+l]+=e[i*a+s]*t[s*a+l]}return n},Zh=function(e,t,a){for(var n=e.slice(0),i=1;i<a;i++)e=Yh(e,n,t);return e},Qh=function(e,t,a){for(var n=new Array(t*t),i=0;i<t*t;i++)n[i]=Math.pow(e[i],a);return Cv(n,t),n},Jh=function(e,t,a,n){for(var i=0;i<a;i++){var o=Math.round(e[i]*Math.pow(10,n))/Math.pow(10,n),s=Math.round(t[i]*Math.pow(10,n))/Math.pow(10,n);if(o!==s)return!1}return!0},jh=function(e,t,a,n){for(var i=[],o=0;o<t;o++){for(var s=[],l=0;l<t;l++)Math.round(e[o*t+l]*1e3)/1e3>0&&s.push(a[l]);s.length!==0&&i.push(n.collection(s))}return i},ed=function(e,t){for(var a=0;a<e.length;a++)if(!t[a]||e[a].id()!==t[a].id())return!1;return!0},rd=function(e){for(var t=0;t<e.length;t++)for(var a=0;a<e.length;a++)t!=a&&ed(e[t],e[a])&&e.splice(a,1);return e},Zs=function(e){for(var t=this.nodes(),a=this.edges(),n=this.cy(),i=Uh(e),o={},s=0;s<t.length;s++)o[t[s].id()]=s;for(var l=t.length,u=l*l,v=new Array(u),f,c=0;c<u;c++)v[c]=0;for(var d=0;d<a.length;d++){var h=a[d],y=o[h.source().id()],g=o[h.target().id()],p=Kh(h,i.attributes);v[y*l+g]+=p,v[g*l+y]+=p}Xh(v,l,i.multFactor),Cv(v,l);for(var m=!0,b=0;m&&b<i.maxIterations;)m=!1,f=Zh(v,l,i.expandFactor),v=Qh(f,l,i.inflateFactor),Jh(v,f,u,4)||(m=!0),b++;var w=jh(v,l,t,n);return w=rd(w),w},td={markovClustering:Zs,mcl:Zs},ad=function(e){return e},Tv=function(e,t){return Math.abs(t-e)},Qs=function(e,t,a){return e+Tv(t,a)},Js=function(e,t,a){return e+Math.pow(a-t,2)},nd=function(e){return Math.sqrt(e)},id=function(e,t,a){return Math.max(e,Tv(t,a))},va=function(e,t,a,n,i){for(var o=arguments.length>5&&arguments[5]!==void 0?arguments[5]:ad,s=n,l,u,v=0;v<e;v++)l=t(v),u=a(v),s=i(s,l,u);return o(s)},Jt={euclidean:function(e,t,a){return e>=2?va(e,t,a,0,Js,nd):va(e,t,a,0,Qs)},squaredEuclidean:function(e,t,a){return va(e,t,a,0,Js)},manhattan:function(e,t,a){return va(e,t,a,0,Qs)},max:function(e,t,a){return va(e,t,a,-1/0,id)}};Jt["squared-euclidean"]=Jt.squaredEuclidean;Jt.squaredeuclidean=Jt.squaredEuclidean;function Nn(r,e,t,a,n,i){var o;return Ue(r)?o=r:o=Jt[r]||Jt.euclidean,e===0&&Ue(r)?o(n,i):o(e,t,a,n,i)}var od=cr({k:2,m:2,sensitivityThreshold:1e-4,distance:"euclidean",maxIterations:10,attributes:[],testMode:!1,testCentroids:null}),os=function(e){return od(e)},Tn=function(e,t,a,n,i){var o=i!=="kMedoids",s=o?function(f){return a[f]}:function(f){return n[f](a)},l=function(c){return n[c](t)},u=a,v=t;return Nn(e,n.length,s,l,u,v)},mi=function(e,t,a){for(var n=a.length,i=new Array(n),o=new Array(n),s=new Array(t),l=null,u=0;u<n;u++)i[u]=e.min(a[u]).value,o[u]=e.max(a[u]).value;for(var v=0;v<t;v++){l=[];for(var f=0;f<n;f++)l[f]=Math.random()*(o[f]-i[f])+i[f];s[v]=l}return s},Sv=function(e,t,a,n,i){for(var o=1/0,s=0,l=0;l<t.length;l++){var u=Tn(a,e,t[l],n,i);u<o&&(o=u,s=l)}return s},kv=function(e,t,a){for(var n=[],i=null,o=0;o<t.length;o++)i=t[o],a[i.id()]===e&&n.push(i);return n},sd=function(e,t,a){return Math.abs(t-e)<=a},ud=function(e,t,a){for(var n=0;n<e.length;n++)for(var i=0;i<e[n].length;i++){var o=Math.abs(e[n][i]-t[n][i]);if(o>a)return!1}return!0},ld=function(e,t,a){for(var n=0;n<a;n++)if(e===t[n])return!0;return!1},js=function(e,t){var a=new Array(t);if(e.length<50)for(var n=0;n<t;n++){for(var i=e[Math.floor(Math.random()*e.length)];ld(i,a,n);)i=e[Math.floor(Math.random()*e.length)];a[n]=i}else for(var o=0;o<t;o++)a[o]=e[Math.floor(Math.random()*e.length)];return a},eu=function(e,t,a){for(var n=0,i=0;i<t.length;i++)n+=Tn("manhattan",t[i],e,a,"kMedoids");return n},vd=function(e){var t=this.cy(),a=this.nodes(),n=null,i=os(e),o=new Array(i.k),s={},l;i.testMode?typeof i.testCentroids=="number"?(i.testCentroids,l=mi(a,i.k,i.attributes)):ar(i.testCentroids)==="object"?l=i.testCentroids:l=mi(a,i.k,i.attributes):l=mi(a,i.k,i.attributes);for(var u=!0,v=0;u&&v<i.maxIterations;){for(var f=0;f<a.length;f++)n=a[f],s[n.id()]=Sv(n,l,i.distance,i.attributes,"kMeans");u=!1;for(var c=0;c<i.k;c++){var d=kv(c,a,s);if(d.length!==0){for(var h=i.attributes.length,y=l[c],g=new Array(h),p=new Array(h),m=0;m<h;m++){p[m]=0;for(var b=0;b<d.length;b++)n=d[b],p[m]+=i.attributes[m](n);g[m]=p[m]/d.length,sd(g[m],y[m],i.sensitivityThreshold)||(u=!0)}l[c]=g,o[c]=t.collection(d)}}v++}return o},fd=function(e){var t=this.cy(),a=this.nodes(),n=null,i=os(e),o=new Array(i.k),s,l={},u,v=new Array(i.k);i.testMode?typeof i.testCentroids=="number"||(ar(i.testCentroids)==="object"?s=i.testCentroids:s=js(a,i.k)):s=js(a,i.k);for(var f=!0,c=0;f&&c<i.maxIterations;){for(var d=0;d<a.length;d++)n=a[d],l[n.id()]=Sv(n,s,i.distance,i.attributes,"kMedoids");f=!1;for(var h=0;h<s.length;h++){var y=kv(h,a,l);if(y.length!==0){v[h]=eu(s[h],y,i.attributes);for(var g=0;g<y.length;g++)u=eu(y[g],y,i.attributes),u<v[h]&&(v[h]=u,s[h]=y[g],f=!0);o[h]=t.collection(y)}}c++}return o},cd=function(e,t,a,n,i){for(var o,s,l=0;l<t.length;l++)for(var u=0;u<e.length;u++)n[l][u]=Math.pow(a[l][u],i.m);for(var v=0;v<e.length;v++)for(var f=0;f<i.attributes.length;f++){o=0,s=0;for(var c=0;c<t.length;c++)o+=n[c][v]*i.attributes[f](t[c]),s+=n[c][v];e[v][f]=o/s}},hd=function(e,t,a,n,i){for(var o=0;o<e.length;o++)t[o]=e[o].slice();for(var s,l,u,v=2/(i.m-1),f=0;f<a.length;f++)for(var c=0;c<n.length;c++){s=0;for(var d=0;d<a.length;d++)l=Tn(i.distance,n[c],a[f],i.attributes,"cmeans"),u=Tn(i.distance,n[c],a[d],i.attributes,"cmeans"),s+=Math.pow(l/u,v);e[c][f]=1/s}},dd=function(e,t,a,n){for(var i=new Array(a.k),o=0;o<i.length;o++)i[o]=[];for(var s,l,u=0;u<t.length;u++){s=-1/0,l=-1;for(var v=0;v<t[0].length;v++)t[u][v]>s&&(s=t[u][v],l=v);i[l].push(e[u])}for(var f=0;f<i.length;f++)i[f]=n.collection(i[f]);return i},ru=function(e){var t=this.cy(),a=this.nodes(),n=os(e),i,o,s,l,u;l=new Array(a.length);for(var v=0;v<a.length;v++)l[v]=new Array(n.k);s=new Array(a.length);for(var f=0;f<a.length;f++)s[f]=new Array(n.k);for(var c=0;c<a.length;c++){for(var d=0,h=0;h<n.k;h++)s[c][h]=Math.random(),d+=s[c][h];for(var y=0;y<n.k;y++)s[c][y]=s[c][y]/d}o=new Array(n.k);for(var g=0;g<n.k;g++)o[g]=new Array(n.attributes.length);u=new Array(a.length);for(var p=0;p<a.length;p++)u[p]=new Array(n.k);for(var m=!0,b=0;m&&b<n.maxIterations;)m=!1,cd(o,a,s,u,n),hd(s,l,o,a,n),ud(s,l,n.sensitivityThreshold)||(m=!0),b++;return i=dd(a,s,n,t),{clusters:i,degreeOfMembership:s}},gd={kMeans:vd,kMedoids:fd,fuzzyCMeans:ru,fcm:ru},pd=cr({distance:"euclidean",linkage:"min",mode:"threshold",threshold:1/0,addDendrogram:!1,dendrogramDepth:0,attributes:[]}),yd={single:"min",complete:"max"},md=function(e){var t=pd(e),a=yd[t.linkage];return a!=null&&(t.linkage=a),t},tu=function(e,t,a,n,i){for(var o=0,s=1/0,l,u=i.attributes,v=function(k,D){return Nn(i.distance,u.length,function(B){return u[B](k)},function(B){return u[B](D)},k,D)},f=0;f<e.length;f++){var c=e[f].key,d=a[c][n[c]];d<s&&(o=c,s=d)}if(i.mode==="threshold"&&s>=i.threshold||i.mode==="dendrogram"&&e.length===1)return!1;var h=t[o],y=t[n[o]],g;i.mode==="dendrogram"?g={left:h,right:y,key:h.key}:g={value:h.value.concat(y.value),key:h.key},e[h.index]=g,e.splice(y.index,1),t[h.key]=g;for(var p=0;p<e.length;p++){var m=e[p];h.key===m.key?l=1/0:i.linkage==="min"?(l=a[h.key][m.key],a[h.key][m.key]>a[y.key][m.key]&&(l=a[y.key][m.key])):i.linkage==="max"?(l=a[h.key][m.key],a[h.key][m.key]<a[y.key][m.key]&&(l=a[y.key][m.key])):i.linkage==="mean"?l=(a[h.key][m.key]*h.size+a[y.key][m.key]*y.size)/(h.size+y.size):i.mode==="dendrogram"?l=v(m.value,h.value):l=v(m.value[0],h.value[0]),a[h.key][m.key]=a[m.key][h.key]=l}for(var b=0;b<e.length;b++){var w=e[b].key;if(n[w]===h.key||n[w]===y.key){for(var E=w,C=0;C<e.length;C++){var x=e[C].key;a[w][x]<a[w][E]&&(E=x)}n[w]=E}e[b].index=b}return h.key=y.key=h.index=y.index=null,!0},$t=function(e,t,a){e&&(e.value?t.push(e.value):(e.left&&$t(e.left,t),e.right&&$t(e.right,t)))},Lo=function(e,t){if(!e)return"";if(e.left&&e.right){var a=Lo(e.left,t),n=Lo(e.right,t),i=t.add({group:"nodes",data:{id:a+","+n}});return t.add({group:"edges",data:{source:a,target:i.id()}}),t.add({group:"edges",data:{source:n,target:i.id()}}),i.id()}else if(e.value)return e.value.id()},Io=function(e,t,a){if(!e)return[];var n=[],i=[],o=[];return t===0?(e.left&&$t(e.left,n),e.right&&$t(e.right,i),o=n.concat(i),[a.collection(o)]):t===1?e.value?[a.collection(e.value)]:(e.left&&$t(e.left,n),e.right&&$t(e.right,i),[a.collection(n),a.collection(i)]):e.value?[a.collection(e.value)]:(e.left&&(n=Io(e.left,t-1,a)),e.right&&(i=Io(e.right,t-1,a)),n.concat(i))},au=function(e){for(var t=this.cy(),a=this.nodes(),n=md(e),i=n.attributes,o=function(b,w){return Nn(n.distance,i.length,function(E){return i[E](b)},function(E){return i[E](w)},b,w)},s=[],l=[],u=[],v=[],f=0;f<a.length;f++){var c={value:n.mode==="dendrogram"?a[f]:[a[f]],key:f,index:f};s[f]=c,v[f]=c,l[f]=[],u[f]=0}for(var d=0;d<s.length;d++)for(var h=0;h<=d;h++){var y=void 0;n.mode==="dendrogram"?y=d===h?1/0:o(s[d].value,s[h].value):y=d===h?1/0:o(s[d].value[0],s[h].value[0]),l[d][h]=y,l[h][d]=y,y<l[d][u[d]]&&(u[d]=h)}for(var g=tu(s,v,l,u,n);g;)g=tu(s,v,l,u,n);var p;return n.mode==="dendrogram"?(p=Io(s[0],n.dendrogramDepth,t),n.addDendrogram&&Lo(s[0],t)):(p=new Array(s.length),s.forEach(function(m,b){m.key=m.index=null,p[b]=t.collection(m.value)})),p},bd={hierarchicalClustering:au,hca:au},wd=cr({distance:"euclidean",preference:"median",damping:.8,maxIterations:1e3,minIterations:100,attributes:[]}),xd=function(e){var t=e.damping,a=e.preference;.5<=t&&t<1||$e("Damping must range on [0.5, 1).  Got: ".concat(t));var n=["median","mean","min","max"];return n.some(function(i){return i===a})||ae(a)||$e("Preference must be one of [".concat(n.map(function(i){return"'".concat(i,"'")}).join(", "),"] or a number.  Got: ").concat(a)),wd(e)},Ed=function(e,t,a,n){var i=function(s,l){return n[l](s)};return-Nn(e,n.length,function(o){return i(t,o)},function(o){return i(a,o)},t,a)},Cd=function(e,t){var a=null;return t==="median"?a=xh(e):t==="mean"?a=wh(e):t==="min"?a=mh(e):t==="max"?a=bh(e):a=t,a},Td=function(e,t,a){for(var n=[],i=0;i<e;i++)t[i*e+i]+a[i*e+i]>0&&n.push(i);return n},nu=function(e,t,a){for(var n=[],i=0;i<e;i++){for(var o=-1,s=-1/0,l=0;l<a.length;l++){var u=a[l];t[i*e+u]>s&&(o=u,s=t[i*e+u])}o>0&&n.push(o)}for(var v=0;v<a.length;v++)n[a[v]]=a[v];return n},Sd=function(e,t,a){for(var n=nu(e,t,a),i=0;i<a.length;i++){for(var o=[],s=0;s<n.length;s++)n[s]===a[i]&&o.push(s);for(var l=-1,u=-1/0,v=0;v<o.length;v++){for(var f=0,c=0;c<o.length;c++)f+=t[o[c]*e+o[v]];f>u&&(l=v,u=f)}a[i]=o[l]}return n=nu(e,t,a),n},iu=function(e){for(var t=this.cy(),a=this.nodes(),n=xd(e),i={},o=0;o<a.length;o++)i[a[o].id()]=o;var s,l,u,v,f,c;s=a.length,l=s*s,u=new Array(l);for(var d=0;d<l;d++)u[d]=-1/0;for(var h=0;h<s;h++)for(var y=0;y<s;y++)h!==y&&(u[h*s+y]=Ed(n.distance,a[h],a[y],n.attributes));v=Cd(u,n.preference);for(var g=0;g<s;g++)u[g*s+g]=v;f=new Array(l);for(var p=0;p<l;p++)f[p]=0;c=new Array(l);for(var m=0;m<l;m++)c[m]=0;for(var b=new Array(s),w=new Array(s),E=new Array(s),C=0;C<s;C++)b[C]=0,w[C]=0,E[C]=0;for(var x=new Array(s*n.minIterations),T=0;T<x.length;T++)x[T]=0;var k;for(k=0;k<n.maxIterations;k++){for(var D=0;D<s;D++){for(var B=-1/0,P=-1/0,A=-1,R=0,L=0;L<s;L++)b[L]=f[D*s+L],R=c[D*s+L]+u[D*s+L],R>=B?(P=B,B=R,A=L):R>P&&(P=R);for(var I=0;I<s;I++)f[D*s+I]=(1-n.damping)*(u[D*s+I]-B)+n.damping*b[I];f[D*s+A]=(1-n.damping)*(u[D*s+A]-P)+n.damping*b[A]}for(var M=0;M<s;M++){for(var O=0,V=0;V<s;V++)b[V]=c[V*s+M],w[V]=Math.max(0,f[V*s+M]),O+=w[V];O-=w[M],w[M]=f[M*s+M],O+=w[M];for(var G=0;G<s;G++)c[G*s+M]=(1-n.damping)*Math.min(0,O-w[G])+n.damping*b[G];c[M*s+M]=(1-n.damping)*(O-w[M])+n.damping*b[M]}for(var N=0,F=0;F<s;F++){var U=c[F*s+F]+f[F*s+F]>0?1:0;x[k%n.minIterations*s+F]=U,N+=U}if(N>0&&(k>=n.minIterations-1||k==n.maxIterations-1)){for(var Q=0,K=0;K<s;K++){E[K]=0;for(var j=0;j<n.minIterations;j++)E[K]+=x[j*s+K];(E[K]===0||E[K]===n.minIterations)&&Q++}if(Q===s)break}}for(var re=Td(s,f,c),ne=Sd(s,u,re),J={},z=0;z<re.length;z++)J[re[z]]=[];for(var q=0;q<a.length;q++){var H=i[a[q].id()],Y=ne[H];Y!=null&&J[Y].push(a[q])}for(var te=new Array(re.length),ce=0;ce<re.length;ce++)te[ce]=t.collection(J[re[ce]]);return te},kd={affinityPropagation:iu,ap:iu},Dd=cr({root:void 0,directed:!1}),Bd={hierholzer:function(e){if(!Le(e)){var t=arguments;e={root:t[0],directed:t[1]}}var a=Dd(e),n=a.root,i=a.directed,o=this,s=!1,l,u,v;n&&(v=ge(n)?this.filter(n)[0].id():n[0].id());var f={},c={};i?o.forEach(function(m){var b=m.id();if(m.isNode()){var w=m.indegree(!0),E=m.outdegree(!0),C=w-E,x=E-w;C==1?l?s=!0:l=b:x==1?u?s=!0:u=b:(x>1||C>1)&&(s=!0),f[b]=[],m.outgoers().forEach(function(T){T.isEdge()&&f[b].push(T.id())})}else c[b]=[void 0,m.target().id()]}):o.forEach(function(m){var b=m.id();if(m.isNode()){var w=m.degree(!0);w%2&&(l?u?s=!0:u=b:l=b),f[b]=[],m.connectedEdges().forEach(function(E){return f[b].push(E.id())})}else c[b]=[m.source().id(),m.target().id()]});var d={found:!1,trail:void 0};if(s)return d;if(u&&l)if(i){if(v&&u!=v)return d;v=u}else{if(v&&u!=v&&l!=v)return d;v||(v=u)}else v||(v=o[0].id());var h=function(b){for(var w=b,E=[b],C,x,T;f[w].length;)C=f[w].shift(),x=c[C][0],T=c[C][1],w!=T?(f[T]=f[T].filter(function(k){return k!=C}),w=T):!i&&w!=x&&(f[x]=f[x].filter(function(k){return k!=C}),w=x),E.unshift(C),E.unshift(w);return E},y=[],g=[];for(g=h(v);g.length!=1;)f[g[0]].length==0?(y.unshift(o.getElementById(g.shift())),y.unshift(o.getElementById(g.shift()))):g=h(g.shift()).concat(g);y.unshift(o.getElementById(g.shift()));for(var p in f)if(f[p].length)return d;return d.found=!0,d.trail=this.spawn(y,!0),d}},Qa=function(){var e=this,t={},a=0,n=0,i=[],o=[],s={},l=function(c,d){for(var h=o.length-1,y=[],g=e.spawn();o[h].x!=c||o[h].y!=d;)y.push(o.pop().edge),h--;y.push(o.pop().edge),y.forEach(function(p){var m=p.connectedNodes().intersection(e);g.merge(p),m.forEach(function(b){var w=b.id(),E=b.connectedEdges().intersection(e);g.merge(b),t[w].cutVertex?g.merge(E.filter(function(C){return C.isLoop()})):g.merge(E)})}),i.push(g)},u=function(c,d,h){c===h&&(n+=1),t[d]={id:a,low:a++,cutVertex:!1};var y=e.getElementById(d).connectedEdges().intersection(e);if(y.size()===0)i.push(e.spawn(e.getElementById(d)));else{var g,p,m,b;y.forEach(function(w){g=w.source().id(),p=w.target().id(),m=g===d?p:g,m!==h&&(b=w.id(),s[b]||(s[b]=!0,o.push({x:d,y:m,edge:w})),m in t?t[d].low=Math.min(t[d].low,t[m].id):(u(c,m,d),t[d].low=Math.min(t[d].low,t[m].low),t[d].id<=t[m].low&&(t[d].cutVertex=!0,l(d,m))))})}};e.forEach(function(f){if(f.isNode()){var c=f.id();c in t||(n=0,u(c,c),t[c].cutVertex=n>1)}});var v=Object.keys(t).filter(function(f){return t[f].cutVertex}).map(function(f){return e.getElementById(f)});return{cut:e.spawn(v),components:i}},Pd={hopcroftTarjanBiconnected:Qa,htbc:Qa,htb:Qa,hopcroftTarjanBiconnectedComponents:Qa},Ja=function(){var e=this,t={},a=0,n=[],i=[],o=e.spawn(e),s=function(u){i.push(u),t[u]={index:a,low:a++,explored:!1};var v=e.getElementById(u).connectedEdges().intersection(e);if(v.forEach(function(y){var g=y.target().id();g!==u&&(g in t||s(g),t[g].explored||(t[u].low=Math.min(t[u].low,t[g].low)))}),t[u].index===t[u].low){for(var f=e.spawn();;){var c=i.pop();if(f.merge(e.getElementById(c)),t[c].low=t[u].index,t[c].explored=!0,c===u)break}var d=f.edgesWith(f),h=f.merge(d);n.push(h),o=o.difference(h)}};return e.forEach(function(l){if(l.isNode()){var u=l.id();u in t||s(u)}}),{cut:o,components:n}},Ad={tarjanStronglyConnected:Ja,tsc:Ja,tscc:Ja,tarjanStronglyConnectedComponents:Ja},Dv={};[Sa,oh,sh,lh,fh,hh,ph,Hh,Xt,Yt,Mo,td,gd,bd,kd,Bd,Pd,Ad].forEach(function(r){be(Dv,r)});var Bv=0,Pv=1,Av=2,Nr=function(e){if(!(this instanceof Nr))return new Nr(e);this.id="Thenable/1.0.7",this.state=Bv,this.fulfillValue=void 0,this.rejectReason=void 0,this.onFulfilled=[],this.onRejected=[],this.proxy={then:this.then.bind(this)},typeof e=="function"&&e.call(this,this.fulfill.bind(this),this.reject.bind(this))};Nr.prototype={fulfill:function(e){return ou(this,Pv,"fulfillValue",e)},reject:function(e){return ou(this,Av,"rejectReason",e)},then:function(e,t){var a=this,n=new Nr;return a.onFulfilled.push(uu(e,n,"fulfill")),a.onRejected.push(uu(t,n,"reject")),Rv(a),n.proxy}};var ou=function(e,t,a,n){return e.state===Bv&&(e.state=t,e[a]=n,Rv(e)),e},Rv=function(e){e.state===Pv?su(e,"onFulfilled",e.fulfillValue):e.state===Av&&su(e,"onRejected",e.rejectReason)},su=function(e,t,a){if(e[t].length!==0){var n=e[t];e[t]=[];var i=function(){for(var s=0;s<n.length;s++)n[s](a)};typeof setImmediate=="function"?setImmediate(i):setTimeout(i,0)}},uu=function(e,t,a){return function(n){if(typeof e!="function")t[a].call(t,n);else{var i;try{i=e(n)}catch(o){t.reject(o);return}Mv(t,i)}}},Mv=function(e,t){if(e===t||e.proxy===t){e.reject(new TypeError("cannot resolve promise with itself"));return}var a;if(ar(t)==="object"&&t!==null||typeof t=="function")try{a=t.then}catch(i){e.reject(i);return}if(typeof a=="function"){var n=!1;try{a.call(t,function(i){n||(n=!0,i===t?e.reject(new TypeError("circular thenable chain")):Mv(e,i))},function(i){n||(n=!0,e.reject(i))})}catch(i){n||e.reject(i)}return}e.fulfill(t)};Nr.all=function(r){return new Nr(function(e,t){for(var a=new Array(r.length),n=0,i=function(l,u){a[l]=u,n++,n===r.length&&e(a)},o=0;o<r.length;o++)(function(s){var l=r[s],u=l!=null&&l.then!=null;if(u)l.then(function(f){i(s,f)},function(f){t(f)});else{var v=l;i(s,v)}})(o)})};Nr.resolve=function(r){return new Nr(function(e,t){e(r)})};Nr.reject=function(r){return new Nr(function(e,t){t(r)})};var ta=typeof Promise<"u"?Promise:Nr,Oo=function(e,t,a){var n=Zo(e),i=!n,o=this._private=be({duration:1e3},t,a);if(o.target=e,o.style=o.style||o.css,o.started=!1,o.playing=!1,o.hooked=!1,o.applying=!1,o.progress=0,o.completes=[],o.frames=[],o.complete&&Ue(o.complete)&&o.completes.push(o.complete),i){var s=e.position();o.startPosition=o.startPosition||{x:s.x,y:s.y},o.startStyle=o.startStyle||e.cy().style().getAnimationStartStyle(e,o.style)}if(n){var l=e.pan();o.startPan={x:l.x,y:l.y},o.startZoom=e.zoom()}this.length=1,this[0]=this},Pt=Oo.prototype;be(Pt,{instanceString:function(){return"animation"},hook:function(){var e=this._private;if(!e.hooked){var t,a=e.target._private.animation;e.queue?t=a.queue:t=a.current,t.push(this),Dr(e.target)&&e.target.cy().addToAnimationPool(e.target),e.hooked=!0}return this},play:function(){var e=this._private;return e.progress===1&&(e.progress=0),e.playing=!0,e.started=!1,e.stopped=!1,this.hook(),this},playing:function(){return this._private.playing},apply:function(){var e=this._private;return e.applying=!0,e.started=!1,e.stopped=!1,this.hook(),this},applying:function(){return this._private.applying},pause:function(){var e=this._private;return e.playing=!1,e.started=!1,this},stop:function(){var e=this._private;return e.playing=!1,e.started=!1,e.stopped=!0,this},rewind:function(){return this.progress(0)},fastforward:function(){return this.progress(1)},time:function(e){var t=this._private;return e===void 0?t.progress*t.duration:this.progress(e/t.duration)},progress:function(e){var t=this._private,a=t.playing;return e===void 0?t.progress:(a&&this.pause(),t.progress=e,t.started=!1,a&&this.play(),this)},completed:function(){return this._private.progress===1},reverse:function(){var e=this._private,t=e.playing;t&&this.pause(),e.progress=1-e.progress,e.started=!1;var a=function(u,v){var f=e[u];f!=null&&(e[u]=e[v],e[v]=f)};if(a("zoom","startZoom"),a("pan","startPan"),a("position","startPosition"),e.style)for(var n=0;n<e.style.length;n++){var i=e.style[n],o=i.name,s=e.startStyle[o];e.startStyle[o]=i,e.style[n]=s}return t&&this.play(),this},promise:function(e){var t=this._private,a;switch(e){case"frame":a=t.frames;break;default:case"complete":case"completed":a=t.completes}return new ta(function(n,i){a.push(function(){n()})})}});Pt.complete=Pt.completed;Pt.run=Pt.play;Pt.running=Pt.playing;var Rd={animated:function(){return function(){var t=this,a=t.length!==void 0,n=a?t:[t],i=this._private.cy||this;if(!i.styleEnabled())return!1;var o=n[0];if(o)return o._private.animation.current.length>0}},clearQueue:function(){return function(){var t=this,a=t.length!==void 0,n=a?t:[t],i=this._private.cy||this;if(!i.styleEnabled())return this;for(var o=0;o<n.length;o++){var s=n[o];s._private.animation.queue=[]}return this}},delay:function(){return function(t,a){var n=this._private.cy||this;return n.styleEnabled()?this.animate({delay:t,duration:t,complete:a}):this}},delayAnimation:function(){return function(t,a){var n=this._private.cy||this;return n.styleEnabled()?this.animation({delay:t,duration:t,complete:a}):this}},animation:function(){return function(t,a){var n=this,i=n.length!==void 0,o=i?n:[n],s=this._private.cy||this,l=!i,u=!l;if(!s.styleEnabled())return this;var v=s.style();t=be({},t,a);var f=Object.keys(t).length===0;if(f)return new Oo(o[0],t);switch(t.duration===void 0&&(t.duration=400),t.duration){case"slow":t.duration=600;break;case"fast":t.duration=200;break}if(u&&(t.style=v.getPropsList(t.style||t.css),t.css=void 0),u&&t.renderedPosition!=null){var c=t.renderedPosition,d=s.pan(),h=s.zoom();t.position=yv(c,h,d)}if(l&&t.panBy!=null){var y=t.panBy,g=s.pan();t.pan={x:g.x+y.x,y:g.y+y.y}}var p=t.center||t.centre;if(l&&p!=null){var m=s.getCenterPan(p.eles,t.zoom);m!=null&&(t.pan=m)}if(l&&t.fit!=null){var b=t.fit,w=s.getFitViewport(b.eles||b.boundingBox,b.padding);w!=null&&(t.pan=w.pan,t.zoom=w.zoom)}if(l&&Le(t.zoom)){var E=s.getZoomedViewport(t.zoom);E!=null?(E.zoomed&&(t.zoom=E.zoom),E.panned&&(t.pan=E.pan)):t.zoom=null}return new Oo(o[0],t)}},animate:function(){return function(t,a){var n=this,i=n.length!==void 0,o=i?n:[n],s=this._private.cy||this;if(!s.styleEnabled())return this;a&&(t=be({},t,a));for(var l=0;l<o.length;l++){var u=o[l],v=u.animated()&&(t.queue===void 0||t.queue),f=u.animation(t,v?{queue:!0}:void 0);f.play()}return this}},stop:function(){return function(t,a){var n=this,i=n.length!==void 0,o=i?n:[n],s=this._private.cy||this;if(!s.styleEnabled())return this;for(var l=0;l<o.length;l++){for(var u=o[l],v=u._private,f=v.animation.current,c=0;c<f.length;c++){var d=f[c],h=d._private;a&&(h.duration=0)}t&&(v.animation.queue=[]),a||(v.animation.current=[])}return s.notify("draw"),this}}},bi,lu;function zn(){if(lu)return bi;lu=1;var r=Array.isArray;return bi=r,bi}var wi,vu;function Md(){if(vu)return wi;vu=1;var r=zn(),e=za(),t=/\.|\[(?:[^[\]]*|(["'])(?:(?!\1)[^\\]|\\.)*?\1)\]/,a=/^\w*$/;function n(i,o){if(r(i))return!1;var s=typeof i;return s=="number"||s=="symbol"||s=="boolean"||i==null||e(i)?!0:a.test(i)||!t.test(i)||o!=null&&i in Object(o)}return wi=n,wi}var xi,fu;function Ld(){if(fu)return xi;fu=1;var r=uv(),e=Na(),t="[object AsyncFunction]",a="[object Function]",n="[object GeneratorFunction]",i="[object Proxy]";function o(s){if(!e(s))return!1;var l=r(s);return l==a||l==n||l==t||l==i}return xi=o,xi}var Ei,cu;function Id(){if(cu)return Ei;cu=1;var r=Ln(),e=r["__core-js_shared__"];return Ei=e,Ei}var Ci,hu;function Od(){if(hu)return Ci;hu=1;var r=Id(),e=(function(){var a=/[^.]+$/.exec(r&&r.keys&&r.keys.IE_PROTO||"");return a?"Symbol(src)_1."+a:""})();function t(a){return!!e&&e in a}return Ci=t,Ci}var Ti,du;function Nd(){if(du)return Ti;du=1;var r=Function.prototype,e=r.toString;function t(a){if(a!=null){try{return e.call(a)}catch{}try{return a+""}catch{}}return""}return Ti=t,Ti}var Si,gu;function zd(){if(gu)return Si;gu=1;var r=Ld(),e=Od(),t=Na(),a=Nd(),n=/[\\^$.*+?()[\]{}|]/g,i=/^\[object .+?Constructor\]$/,o=Function.prototype,s=Object.prototype,l=o.toString,u=s.hasOwnProperty,v=RegExp("^"+l.call(u).replace(n,"\\$&").replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g,"$1.*?")+"$");function f(c){if(!t(c)||e(c))return!1;var d=r(c)?v:i;return d.test(a(c))}return Si=f,Si}var ki,pu;function Fd(){if(pu)return ki;pu=1;function r(e,t){return e?.[t]}return ki=r,ki}var Di,yu;function ss(){if(yu)return Di;yu=1;var r=zd(),e=Fd();function t(a,n){var i=e(a,n);return r(i)?i:void 0}return Di=t,Di}var Bi,mu;function Fn(){if(mu)return Bi;mu=1;var r=ss(),e=r(Object,"create");return Bi=e,Bi}var Pi,bu;function Vd(){if(bu)return Pi;bu=1;var r=Fn();function e(){this.__data__=r?r(null):{},this.size=0}return Pi=e,Pi}var Ai,wu;function qd(){if(wu)return Ai;wu=1;function r(e){var t=this.has(e)&&delete this.__data__[e];return this.size-=t?1:0,t}return Ai=r,Ai}var Ri,xu;function _d(){if(xu)return Ri;xu=1;var r=Fn(),e="__lodash_hash_undefined__",t=Object.prototype,a=t.hasOwnProperty;function n(i){var o=this.__data__;if(r){var s=o[i];return s===e?void 0:s}return a.call(o,i)?o[i]:void 0}return Ri=n,Ri}var Mi,Eu;function Gd(){if(Eu)return Mi;Eu=1;var r=Fn(),e=Object.prototype,t=e.hasOwnProperty;function a(n){var i=this.__data__;return r?i[n]!==void 0:t.call(i,n)}return Mi=a,Mi}var Li,Cu;function Hd(){if(Cu)return Li;Cu=1;var r=Fn(),e="__lodash_hash_undefined__";function t(a,n){var i=this.__data__;return this.size+=this.has(a)?0:1,i[a]=r&&n===void 0?e:n,this}return Li=t,Li}var Ii,Tu;function Wd(){if(Tu)return Ii;Tu=1;var r=Vd(),e=qd(),t=_d(),a=Gd(),n=Hd();function i(o){var s=-1,l=o==null?0:o.length;for(this.clear();++s<l;){var u=o[s];this.set(u[0],u[1])}}return i.prototype.clear=r,i.prototype.delete=e,i.prototype.get=t,i.prototype.has=a,i.prototype.set=n,Ii=i,Ii}var Oi,Su;function $d(){if(Su)return Oi;Su=1;function r(){this.__data__=[],this.size=0}return Oi=r,Oi}var Ni,ku;function Lv(){if(ku)return Ni;ku=1;function r(e,t){return e===t||e!==e&&t!==t}return Ni=r,Ni}var zi,Du;function Vn(){if(Du)return zi;Du=1;var r=Lv();function e(t,a){for(var n=t.length;n--;)if(r(t[n][0],a))return n;return-1}return zi=e,zi}var Fi,Bu;function Ud(){if(Bu)return Fi;Bu=1;var r=Vn(),e=Array.prototype,t=e.splice;function a(n){var i=this.__data__,o=r(i,n);if(o<0)return!1;var s=i.length-1;return o==s?i.pop():t.call(i,o,1),--this.size,!0}return Fi=a,Fi}var Vi,Pu;function Kd(){if(Pu)return Vi;Pu=1;var r=Vn();function e(t){var a=this.__data__,n=r(a,t);return n<0?void 0:a[n][1]}return Vi=e,Vi}var qi,Au;function Xd(){if(Au)return qi;Au=1;var r=Vn();function e(t){return r(this.__data__,t)>-1}return qi=e,qi}var _i,Ru;function Yd(){if(Ru)return _i;Ru=1;var r=Vn();function e(t,a){var n=this.__data__,i=r(n,t);return i<0?(++this.size,n.push([t,a])):n[i][1]=a,this}return _i=e,_i}var Gi,Mu;function Zd(){if(Mu)return Gi;Mu=1;var r=$d(),e=Ud(),t=Kd(),a=Xd(),n=Yd();function i(o){var s=-1,l=o==null?0:o.length;for(this.clear();++s<l;){var u=o[s];this.set(u[0],u[1])}}return i.prototype.clear=r,i.prototype.delete=e,i.prototype.get=t,i.prototype.has=a,i.prototype.set=n,Gi=i,Gi}var Hi,Lu;function Qd(){if(Lu)return Hi;Lu=1;var r=ss(),e=Ln(),t=r(e,"Map");return Hi=t,Hi}var Wi,Iu;function Jd(){if(Iu)return Wi;Iu=1;var r=Wd(),e=Zd(),t=Qd();function a(){this.size=0,this.__data__={hash:new r,map:new(t||e),string:new r}}return Wi=a,Wi}var $i,Ou;function jd(){if(Ou)return $i;Ou=1;function r(e){var t=typeof e;return t=="string"||t=="number"||t=="symbol"||t=="boolean"?e!=="__proto__":e===null}return $i=r,$i}var Ui,Nu;function qn(){if(Nu)return Ui;Nu=1;var r=jd();function e(t,a){var n=t.__data__;return r(a)?n[typeof a=="string"?"string":"hash"]:n.map}return Ui=e,Ui}var Ki,zu;function eg(){if(zu)return Ki;zu=1;var r=qn();function e(t){var a=r(this,t).delete(t);return this.size-=a?1:0,a}return Ki=e,Ki}var Xi,Fu;function rg(){if(Fu)return Xi;Fu=1;var r=qn();function e(t){return r(this,t).get(t)}return Xi=e,Xi}var Yi,Vu;function tg(){if(Vu)return Yi;Vu=1;var r=qn();function e(t){return r(this,t).has(t)}return Yi=e,Yi}var Zi,qu;function ag(){if(qu)return Zi;qu=1;var r=qn();function e(t,a){var n=r(this,t),i=n.size;return n.set(t,a),this.size+=n.size==i?0:1,this}return Zi=e,Zi}var Qi,_u;function ng(){if(_u)return Qi;_u=1;var r=Jd(),e=eg(),t=rg(),a=tg(),n=ag();function i(o){var s=-1,l=o==null?0:o.length;for(this.clear();++s<l;){var u=o[s];this.set(u[0],u[1])}}return i.prototype.clear=r,i.prototype.delete=e,i.prototype.get=t,i.prototype.has=a,i.prototype.set=n,Qi=i,Qi}var Ji,Gu;function ig(){if(Gu)return Ji;Gu=1;var r=ng(),e="Expected a function";function t(a,n){if(typeof a!="function"||n!=null&&typeof n!="function")throw new TypeError(e);var i=function(){var o=arguments,s=n?n.apply(this,o):o[0],l=i.cache;if(l.has(s))return l.get(s);var u=a.apply(this,o);return i.cache=l.set(s,u)||l,u};return i.cache=new(t.Cache||r),i}return t.Cache=r,Ji=t,Ji}var ji,Hu;function og(){if(Hu)return ji;Hu=1;var r=ig(),e=500;function t(a){var n=r(a,function(o){return i.size===e&&i.clear(),o}),i=n.cache;return n}return ji=t,ji}var eo,Wu;function Iv(){if(Wu)return eo;Wu=1;var r=og(),e=/[^.[\]]+|\[(?:(-?\d+(?:\.\d+)?)|(["'])((?:(?!\2)[^\\]|\\.)*?)\2)\]|(?=(?:\.|\[\])(?:\.|\[\]|$))/g,t=/\\(\\)?/g,a=r(function(n){var i=[];return n.charCodeAt(0)===46&&i.push(""),n.replace(e,function(o,s,l,u){i.push(l?u.replace(t,"$1"):s||o)}),i});return eo=a,eo}var ro,$u;function Ov(){if($u)return ro;$u=1;function r(e,t){for(var a=-1,n=e==null?0:e.length,i=Array(n);++a<n;)i[a]=t(e[a],a,e);return i}return ro=r,ro}var to,Uu;function sg(){if(Uu)return to;Uu=1;var r=Jo(),e=Ov(),t=zn(),a=za(),n=r?r.prototype:void 0,i=n?n.toString:void 0;function o(s){if(typeof s=="string")return s;if(t(s))return e(s,o)+"";if(a(s))return i?i.call(s):"";var l=s+"";return l=="0"&&1/s==-1/0?"-0":l}return to=o,to}var ao,Ku;function Nv(){if(Ku)return ao;Ku=1;var r=sg();function e(t){return t==null?"":r(t)}return ao=e,ao}var no,Xu;function zv(){if(Xu)return no;Xu=1;var r=zn(),e=Md(),t=Iv(),a=Nv();function n(i,o){return r(i)?i:e(i,o)?[i]:t(a(i))}return no=n,no}var io,Yu;function us(){if(Yu)return io;Yu=1;var r=za();function e(t){if(typeof t=="string"||r(t))return t;var a=t+"";return a=="0"&&1/t==-1/0?"-0":a}return io=e,io}var oo,Zu;function ug(){if(Zu)return oo;Zu=1;var r=zv(),e=us();function t(a,n){n=r(n,a);for(var i=0,o=n.length;a!=null&&i<o;)a=a[e(n[i++])];return i&&i==o?a:void 0}return oo=t,oo}var so,Qu;function lg(){if(Qu)return so;Qu=1;var r=ug();function e(t,a,n){var i=t==null?void 0:r(t,a);return i===void 0?n:i}return so=e,so}var vg=lg(),fg=Oa(vg),uo,Ju;function cg(){if(Ju)return uo;Ju=1;var r=ss(),e=(function(){try{var t=r(Object,"defineProperty");return t({},"",{}),t}catch{}})();return uo=e,uo}var lo,ju;function hg(){if(ju)return lo;ju=1;var r=cg();function e(t,a,n){a=="__proto__"&&r?r(t,a,{configurable:!0,enumerable:!0,value:n,writable:!0}):t[a]=n}return lo=e,lo}var vo,el;function dg(){if(el)return vo;el=1;var r=hg(),e=Lv(),t=Object.prototype,a=t.hasOwnProperty;function n(i,o,s){var l=i[o];(!(a.call(i,o)&&e(l,s))||s===void 0&&!(o in i))&&r(i,o,s)}return vo=n,vo}var fo,rl;function gg(){if(rl)return fo;rl=1;var r=9007199254740991,e=/^(?:0|[1-9]\d*)$/;function t(a,n){var i=typeof a;return n=n??r,!!n&&(i=="number"||i!="symbol"&&e.test(a))&&a>-1&&a%1==0&&a<n}return fo=t,fo}var co,tl;function pg(){if(tl)return co;tl=1;var r=dg(),e=zv(),t=gg(),a=Na(),n=us();function i(o,s,l,u){if(!a(o))return o;s=e(s,o);for(var v=-1,f=s.length,c=f-1,d=o;d!=null&&++v<f;){var h=n(s[v]),y=l;if(h==="__proto__"||h==="constructor"||h==="prototype")return o;if(v!=c){var g=d[h];y=u?u(g,h,d):void 0,y===void 0&&(y=a(g)?g:t(s[v+1])?[]:{})}r(d,h,y),d=d[h]}return o}return co=i,co}var ho,al;function yg(){if(al)return ho;al=1;var r=pg();function e(t,a,n){return t==null?t:r(t,a,n)}return ho=e,ho}var mg=yg(),bg=Oa(mg),go,nl;function wg(){if(nl)return go;nl=1;function r(e,t){var a=-1,n=e.length;for(t||(t=Array(n));++a<n;)t[a]=e[a];return t}return go=r,go}var po,il;function xg(){if(il)return po;il=1;var r=Ov(),e=wg(),t=zn(),a=za(),n=Iv(),i=us(),o=Nv();function s(l){return t(l)?r(l,i):a(l)?[l]:e(n(o(l)))}return po=s,po}var Eg=xg(),Cg=Oa(Eg),Tg={data:function(e){var t={field:"data",bindingEvent:"data",allowBinding:!1,allowSetting:!1,allowGetting:!1,settingEvent:"data",settingTriggersEvent:!1,triggerFnName:"trigger",immutableKeys:{},updateStyle:!1,beforeGet:function(n){},beforeSet:function(n,i){},onSet:function(n){},canSet:function(n){return!0}};return e=be({},t,e),function(n,i){var o=e,s=this,l=s.length!==void 0,u=l?s:[s],v=l?s[0]:s;if(ge(n)){var f=n.indexOf(".")!==-1,c=f&&Cg(n);if(o.allowGetting&&i===void 0){var d;return v&&(o.beforeGet(v),c&&v._private[o.field][n]===void 0?d=fg(v._private[o.field],c):d=v._private[o.field][n]),d}else if(o.allowSetting&&i!==void 0){var h=!o.immutableKeys[n];if(h){var y=Jl({},n,i);o.beforeSet(s,y);for(var g=0,p=u.length;g<p;g++){var m=u[g];o.canSet(m)&&(c&&v._private[o.field][n]===void 0?bg(m._private[o.field],c,i):m._private[o.field][n]=i)}o.updateStyle&&s.updateStyle(),o.onSet(s),o.settingTriggersEvent&&s[o.triggerFnName](o.settingEvent)}}}else if(o.allowSetting&&Le(n)){var b=n,w,E,C=Object.keys(b);o.beforeSet(s,b);for(var x=0;x<C.length;x++){w=C[x],E=b[w];var T=!o.immutableKeys[w];if(T)for(var k=0;k<u.length;k++){var D=u[k];o.canSet(D)&&(D._private[o.field][w]=E)}}o.updateStyle&&s.updateStyle(),o.onSet(s),o.settingTriggersEvent&&s[o.triggerFnName](o.settingEvent)}else if(o.allowBinding&&Ue(n)){var B=n;s.on(o.bindingEvent,B)}else if(o.allowGetting&&n===void 0){var P;return v&&(o.beforeGet(v),P=v._private[o.field]),P}return s}},removeData:function(e){var t={field:"data",event:"data",triggerFnName:"trigger",triggerEvent:!1,immutableKeys:{}};return e=be({},t,e),function(n){var i=e,o=this,s=o.length!==void 0,l=s?o:[o];if(ge(n)){for(var u=n.split(/\s+/),v=u.length,f=0;f<v;f++){var c=u[f];if(!ut(c)){var d=!i.immutableKeys[c];if(d)for(var h=0,y=l.length;h<y;h++)l[h]._private[i.field][c]=void 0}}i.triggerEvent&&o[i.triggerFnName](i.event)}else if(n===void 0){for(var g=0,p=l.length;g<p;g++)for(var m=l[g]._private[i.field],b=Object.keys(m),w=0;w<b.length;w++){var E=b[w],C=!i.immutableKeys[E];C&&(m[E]=void 0)}i.triggerEvent&&o[i.triggerFnName](i.event)}return o}}},Sg={eventAliasesOn:function(e){var t=e;t.addListener=t.listen=t.bind=t.on,t.unlisten=t.unbind=t.off=t.removeListener,t.trigger=t.emit,t.pon=t.promiseOn=function(a,n){var i=this,o=Array.prototype.slice.call(arguments,0);return new ta(function(s,l){var u=function(d){i.off.apply(i,f),s(d)},v=o.concat([u]),f=v.concat([]);i.on.apply(i,v)})}}},Fe={};[Rd,Tg,Sg].forEach(function(r){be(Fe,r)});var kg={animate:Fe.animate(),animation:Fe.animation(),animated:Fe.animated(),clearQueue:Fe.clearQueue(),delay:Fe.delay(),delayAnimation:Fe.delayAnimation(),stop:Fe.stop()},vn={classes:function(e){var t=this;if(e===void 0){var a=[];return t[0]._private.classes.forEach(function(h){return a.push(h)}),a}else _e(e)||(e=(e||"").match(/\S+/g)||[]);for(var n=[],i=new ra(e),o=0;o<t.length;o++){for(var s=t[o],l=s._private,u=l.classes,v=!1,f=0;f<e.length;f++){var c=e[f],d=u.has(c);if(!d){v=!0;break}}v||(v=u.size!==e.length),v&&(l.classes=i,n.push(s))}return n.length>0&&this.spawn(n).updateStyle().emit("class"),t},addClass:function(e){return this.toggleClass(e,!0)},hasClass:function(e){var t=this[0];return t!=null&&t._private.classes.has(e)},toggleClass:function(e,t){_e(e)||(e=e.match(/\S+/g)||[]);for(var a=this,n=t===void 0,i=[],o=0,s=a.length;o<s;o++)for(var l=a[o],u=l._private.classes,v=!1,f=0;f<e.length;f++){var c=e[f],d=u.has(c),h=!1;t||n&&!d?(u.add(c),h=!0):(!t||n&&d)&&(u.delete(c),h=!0),!v&&h&&(i.push(l),v=!0)}return i.length>0&&this.spawn(i).updateStyle().emit("class"),a},removeClass:function(e){return this.toggleClass(e,!1)},flashClass:function(e,t){var a=this;if(t==null)t=250;else if(t===0)return a;return a.addClass(e),setTimeout(function(){a.removeClass(e)},t),a}};vn.className=vn.classNames=vn.classes;var Me={metaChar:"[\\!\\\"\\#\\$\\%\\&\\'\\(\\)\\*\\+\\,\\.\\/\\:\\;\\<\\=\\>\\?\\@\\[\\]\\^\\`\\{\\|\\}\\~]",comparatorOp:"=|\\!=|>|>=|<|<=|\\$=|\\^=|\\*=",boolOp:"\\?|\\!|\\^",string:`"(?:\\\\"|[^"])*"|'(?:\\\\'|[^'])*'`,number:tr,meta:"degree|indegree|outdegree",separator:"\\s*,\\s*",descendant:"\\s+",child:"\\s+>\\s+",subject:"\\$",group:"node|edge|\\*",directedEdge:"\\s+->\\s+",undirectedEdge:"\\s+<->\\s+"};Me.variable="(?:[\\w-.]|(?:\\\\"+Me.metaChar+"))+";Me.className="(?:[\\w-]|(?:\\\\"+Me.metaChar+"))+";Me.value=Me.string+"|"+Me.number;Me.id=Me.variable;(function(){var r,e,t;for(r=Me.comparatorOp.split("|"),t=0;t<r.length;t++)e=r[t],Me.comparatorOp+="|@"+e;for(r=Me.comparatorOp.split("|"),t=0;t<r.length;t++)e=r[t],!(e.indexOf("!")>=0)&&e!=="="&&(Me.comparatorOp+="|\\!"+e)})();var qe=function(){return{checks:[]}},oe={GROUP:0,COLLECTION:1,FILTER:2,DATA_COMPARE:3,DATA_EXIST:4,DATA_BOOL:5,META_COMPARE:6,STATE:7,ID:8,CLASS:9,UNDIRECTED_EDGE:10,DIRECTED_EDGE:11,NODE_SOURCE:12,NODE_TARGET:13,NODE_NEIGHBOR:14,CHILD:15,DESCENDANT:16,PARENT:17,ANCESTOR:18,COMPOUND_SPLIT:19,TRUE:20},No=[{selector:":selected",matches:function(e){return e.selected()}},{selector:":unselected",matches:function(e){return!e.selected()}},{selector:":selectable",matches:function(e){return e.selectable()}},{selector:":unselectable",matches:function(e){return!e.selectable()}},{selector:":locked",matches:function(e){return e.locked()}},{selector:":unlocked",matches:function(e){return!e.locked()}},{selector:":visible",matches:function(e){return e.visible()}},{selector:":hidden",matches:function(e){return!e.visible()}},{selector:":transparent",matches:function(e){return e.transparent()}},{selector:":grabbed",matches:function(e){return e.grabbed()}},{selector:":free",matches:function(e){return!e.grabbed()}},{selector:":removed",matches:function(e){return e.removed()}},{selector:":inside",matches:function(e){return!e.removed()}},{selector:":grabbable",matches:function(e){return e.grabbable()}},{selector:":ungrabbable",matches:function(e){return!e.grabbable()}},{selector:":animated",matches:function(e){return e.animated()}},{selector:":unanimated",matches:function(e){return!e.animated()}},{selector:":parent",matches:function(e){return e.isParent()}},{selector:":childless",matches:function(e){return e.isChildless()}},{selector:":child",matches:function(e){return e.isChild()}},{selector:":orphan",matches:function(e){return e.isOrphan()}},{selector:":nonorphan",matches:function(e){return e.isChild()}},{selector:":compound",matches:function(e){return e.isNode()?e.isParent():e.source().isParent()||e.target().isParent()}},{selector:":loop",matches:function(e){return e.isLoop()}},{selector:":simple",matches:function(e){return e.isSimple()}},{selector:":active",matches:function(e){return e.active()}},{selector:":inactive",matches:function(e){return!e.active()}},{selector:":backgrounding",matches:function(e){return e.backgrounding()}},{selector:":nonbackgrounding",matches:function(e){return!e.backgrounding()}}].sort(function(r,e){return Tc(r.selector,e.selector)}),Dg=(function(){for(var r={},e,t=0;t<No.length;t++)e=No[t],r[e.selector]=e.matches;return r})(),Bg=function(e,t){return Dg[e](t)},Pg="("+No.map(function(r){return r.selector}).join("|")+")",Ot=function(e){return e.replace(new RegExp("\\\\("+Me.metaChar+")","g"),function(t,a){return a})},rt=function(e,t,a){e[e.length-1]=a},zo=[{name:"group",query:!0,regex:"("+Me.group+")",populate:function(e,t,a){var n=Je(a,1),i=n[0];t.checks.push({type:oe.GROUP,value:i==="*"?i:i+"s"})}},{name:"state",query:!0,regex:Pg,populate:function(e,t,a){var n=Je(a,1),i=n[0];t.checks.push({type:oe.STATE,value:i})}},{name:"id",query:!0,regex:"\\#("+Me.id+")",populate:function(e,t,a){var n=Je(a,1),i=n[0];t.checks.push({type:oe.ID,value:Ot(i)})}},{name:"className",query:!0,regex:"\\.("+Me.className+")",populate:function(e,t,a){var n=Je(a,1),i=n[0];t.checks.push({type:oe.CLASS,value:Ot(i)})}},{name:"dataExists",query:!0,regex:"\\[\\s*("+Me.variable+")\\s*\\]",populate:function(e,t,a){var n=Je(a,1),i=n[0];t.checks.push({type:oe.DATA_EXIST,field:Ot(i)})}},{name:"dataCompare",query:!0,regex:"\\[\\s*("+Me.variable+")\\s*("+Me.comparatorOp+")\\s*("+Me.value+")\\s*\\]",populate:function(e,t,a){var n=Je(a,3),i=n[0],o=n[1],s=n[2],l=new RegExp("^"+Me.string+"$").exec(s)!=null;l?s=s.substring(1,s.length-1):s=parseFloat(s),t.checks.push({type:oe.DATA_COMPARE,field:Ot(i),operator:o,value:s})}},{name:"dataBool",query:!0,regex:"\\[\\s*("+Me.boolOp+")\\s*("+Me.variable+")\\s*\\]",populate:function(e,t,a){var n=Je(a,2),i=n[0],o=n[1];t.checks.push({type:oe.DATA_BOOL,field:Ot(o),operator:i})}},{name:"metaCompare",query:!0,regex:"\\[\\[\\s*("+Me.meta+")\\s*("+Me.comparatorOp+")\\s*("+Me.number+")\\s*\\]\\]",populate:function(e,t,a){var n=Je(a,3),i=n[0],o=n[1],s=n[2];t.checks.push({type:oe.META_COMPARE,field:Ot(i),operator:o,value:parseFloat(s)})}},{name:"nextQuery",separator:!0,regex:Me.separator,populate:function(e,t){var a=e.currentSubject,n=e.edgeCount,i=e.compoundCount,o=e[e.length-1];a!=null&&(o.subject=a,e.currentSubject=null),o.edgeCount=n,o.compoundCount=i,e.edgeCount=0,e.compoundCount=0;var s=e[e.length++]=qe();return s}},{name:"directedEdge",separator:!0,regex:Me.directedEdge,populate:function(e,t){if(e.currentSubject==null){var a=qe(),n=t,i=qe();return a.checks.push({type:oe.DIRECTED_EDGE,source:n,target:i}),rt(e,t,a),e.edgeCount++,i}else{var o=qe(),s=t,l=qe();return o.checks.push({type:oe.NODE_SOURCE,source:s,target:l}),rt(e,t,o),e.edgeCount++,l}}},{name:"undirectedEdge",separator:!0,regex:Me.undirectedEdge,populate:function(e,t){if(e.currentSubject==null){var a=qe(),n=t,i=qe();return a.checks.push({type:oe.UNDIRECTED_EDGE,nodes:[n,i]}),rt(e,t,a),e.edgeCount++,i}else{var o=qe(),s=t,l=qe();return o.checks.push({type:oe.NODE_NEIGHBOR,node:s,neighbor:l}),rt(e,t,o),l}}},{name:"child",separator:!0,regex:Me.child,populate:function(e,t){if(e.currentSubject==null){var a=qe(),n=qe(),i=e[e.length-1];return a.checks.push({type:oe.CHILD,parent:i,child:n}),rt(e,t,a),e.compoundCount++,n}else if(e.currentSubject===t){var o=qe(),s=e[e.length-1],l=qe(),u=qe(),v=qe(),f=qe();return o.checks.push({type:oe.COMPOUND_SPLIT,left:s,right:l,subject:u}),u.checks=t.checks,t.checks=[{type:oe.TRUE}],f.checks.push({type:oe.TRUE}),l.checks.push({type:oe.PARENT,parent:f,child:v}),rt(e,s,o),e.currentSubject=u,e.compoundCount++,v}else{var c=qe(),d=qe(),h=[{type:oe.PARENT,parent:c,child:d}];return c.checks=t.checks,t.checks=h,e.compoundCount++,d}}},{name:"descendant",separator:!0,regex:Me.descendant,populate:function(e,t){if(e.currentSubject==null){var a=qe(),n=qe(),i=e[e.length-1];return a.checks.push({type:oe.DESCENDANT,ancestor:i,descendant:n}),rt(e,t,a),e.compoundCount++,n}else if(e.currentSubject===t){var o=qe(),s=e[e.length-1],l=qe(),u=qe(),v=qe(),f=qe();return o.checks.push({type:oe.COMPOUND_SPLIT,left:s,right:l,subject:u}),u.checks=t.checks,t.checks=[{type:oe.TRUE}],f.checks.push({type:oe.TRUE}),l.checks.push({type:oe.ANCESTOR,ancestor:f,descendant:v}),rt(e,s,o),e.currentSubject=u,e.compoundCount++,v}else{var c=qe(),d=qe(),h=[{type:oe.ANCESTOR,ancestor:c,descendant:d}];return c.checks=t.checks,t.checks=h,e.compoundCount++,d}}},{name:"subject",modifier:!0,regex:Me.subject,populate:function(e,t){if(e.currentSubject!=null&&e.currentSubject!==t)return Ve("Redefinition of subject in selector `"+e.toString()+"`"),!1;e.currentSubject=t;var a=e[e.length-1],n=a.checks[0],i=n==null?null:n.type;i===oe.DIRECTED_EDGE?n.type=oe.NODE_TARGET:i===oe.UNDIRECTED_EDGE&&(n.type=oe.NODE_NEIGHBOR,n.node=n.nodes[1],n.neighbor=n.nodes[0],n.nodes=null)}}];zo.forEach(function(r){return r.regexObj=new RegExp("^"+r.regex)});var Ag=function(e){for(var t,a,n,i=0;i<zo.length;i++){var o=zo[i],s=o.name,l=e.match(o.regexObj);if(l!=null){a=l,t=o,n=s;var u=l[0];e=e.substring(u.length);break}}return{expr:t,match:a,name:n,remaining:e}},Rg=function(e){var t=e.match(/^\s+/);if(t){var a=t[0];e=e.substring(a.length)}return e},Mg=function(e){var t=this,a=t.inputText=e,n=t[0]=qe();for(t.length=1,a=Rg(a);;){var i=Ag(a);if(i.expr==null)return Ve("The selector `"+e+"`is invalid"),!1;var o=i.match.slice(1),s=i.expr.populate(t,n,o);if(s===!1)return!1;if(s!=null&&(n=s),a=i.remaining,a.match(/^\s*$/))break}var l=t[t.length-1];t.currentSubject!=null&&(l.subject=t.currentSubject),l.edgeCount=t.edgeCount,l.compoundCount=t.compoundCount;for(var u=0;u<t.length;u++){var v=t[u];if(v.compoundCount>0&&v.edgeCount>0)return Ve("The selector `"+e+"` is invalid because it uses both a compound selector and an edge selector"),!1;if(v.edgeCount>1)return Ve("The selector `"+e+"` is invalid because it uses multiple edge selectors"),!1;v.edgeCount===1&&Ve("The selector `"+e+"` is deprecated.  Edge selectors do not take effect on changes to source and target nodes after an edge is added, for performance reasons.  Use a class or data selector on edges instead, updating the class or data of an edge when your app detects a change in source or target nodes.")}return!0},Lg=function(){if(this.toStringCache!=null)return this.toStringCache;for(var e=function(v){return v??""},t=function(v){return ge(v)?'"'+v+'"':e(v)},a=function(v){return" "+v+" "},n=function(v,f){var c=v.type,d=v.value;switch(c){case oe.GROUP:{var h=e(d);return h.substring(0,h.length-1)}case oe.DATA_COMPARE:{var y=v.field,g=v.operator;return"["+y+a(e(g))+t(d)+"]"}case oe.DATA_BOOL:{var p=v.operator,m=v.field;return"["+e(p)+m+"]"}case oe.DATA_EXIST:{var b=v.field;return"["+b+"]"}case oe.META_COMPARE:{var w=v.operator,E=v.field;return"[["+E+a(e(w))+t(d)+"]]"}case oe.STATE:return d;case oe.ID:return"#"+d;case oe.CLASS:return"."+d;case oe.PARENT:case oe.CHILD:return i(v.parent,f)+a(">")+i(v.child,f);case oe.ANCESTOR:case oe.DESCENDANT:return i(v.ancestor,f)+" "+i(v.descendant,f);case oe.COMPOUND_SPLIT:{var C=i(v.left,f),x=i(v.subject,f),T=i(v.right,f);return C+(C.length>0?" ":"")+x+T}case oe.TRUE:return""}},i=function(v,f){return v.checks.reduce(function(c,d,h){return c+(f===v&&h===0?"$":"")+n(d,f)},"")},o="",s=0;s<this.length;s++){var l=this[s];o+=i(l,l.subject),this.length>1&&s<this.length-1&&(o+=", ")}return this.toStringCache=o,o},Ig={parse:Mg,toString:Lg},Fv=function(e,t,a){var n,i=ge(e),o=ae(e),s=ge(a),l,u,v=!1,f=!1,c=!1;switch(t.indexOf("!")>=0&&(t=t.replace("!",""),f=!0),t.indexOf("@")>=0&&(t=t.replace("@",""),v=!0),(i||s||v)&&(l=!i&&!o?"":""+e,u=""+a),v&&(e=l=l.toLowerCase(),a=u=u.toLowerCase()),t){case"*=":n=l.indexOf(u)>=0;break;case"$=":n=l.indexOf(u,l.length-u.length)>=0;break;case"^=":n=l.indexOf(u)===0;break;case"=":n=e===a;break;case">":c=!0,n=e>a;break;case">=":c=!0,n=e>=a;break;case"<":c=!0,n=e<a;break;case"<=":c=!0,n=e<=a;break;default:n=!1;break}return f&&(e!=null||!c)&&(n=!n),n},Og=function(e,t){switch(t){case"?":return!!e;case"!":return!e;case"^":return e===void 0}},Ng=function(e){return e!==void 0},ls=function(e,t){return e.data(t)},zg=function(e,t){return e[t]()},Xe=[],We=function(e,t){return e.checks.every(function(a){return Xe[a.type](a,t)})};Xe[oe.GROUP]=function(r,e){var t=r.value;return t==="*"||t===e.group()};Xe[oe.STATE]=function(r,e){var t=r.value;return Bg(t,e)};Xe[oe.ID]=function(r,e){var t=r.value;return e.id()===t};Xe[oe.CLASS]=function(r,e){var t=r.value;return e.hasClass(t)};Xe[oe.META_COMPARE]=function(r,e){var t=r.field,a=r.operator,n=r.value;return Fv(zg(e,t),a,n)};Xe[oe.DATA_COMPARE]=function(r,e){var t=r.field,a=r.operator,n=r.value;return Fv(ls(e,t),a,n)};Xe[oe.DATA_BOOL]=function(r,e){var t=r.field,a=r.operator;return Og(ls(e,t),a)};Xe[oe.DATA_EXIST]=function(r,e){var t=r.field;return r.operator,Ng(ls(e,t))};Xe[oe.UNDIRECTED_EDGE]=function(r,e){var t=r.nodes[0],a=r.nodes[1],n=e.source(),i=e.target();return We(t,n)&&We(a,i)||We(a,n)&&We(t,i)};Xe[oe.NODE_NEIGHBOR]=function(r,e){return We(r.node,e)&&e.neighborhood().some(function(t){return t.isNode()&&We(r.neighbor,t)})};Xe[oe.DIRECTED_EDGE]=function(r,e){return We(r.source,e.source())&&We(r.target,e.target())};Xe[oe.NODE_SOURCE]=function(r,e){return We(r.source,e)&&e.outgoers().some(function(t){return t.isNode()&&We(r.target,t)})};Xe[oe.NODE_TARGET]=function(r,e){return We(r.target,e)&&e.incomers().some(function(t){return t.isNode()&&We(r.source,t)})};Xe[oe.CHILD]=function(r,e){return We(r.child,e)&&We(r.parent,e.parent())};Xe[oe.PARENT]=function(r,e){return We(r.parent,e)&&e.children().some(function(t){return We(r.child,t)})};Xe[oe.DESCENDANT]=function(r,e){return We(r.descendant,e)&&e.ancestors().some(function(t){return We(r.ancestor,t)})};Xe[oe.ANCESTOR]=function(r,e){return We(r.ancestor,e)&&e.descendants().some(function(t){return We(r.descendant,t)})};Xe[oe.COMPOUND_SPLIT]=function(r,e){return We(r.subject,e)&&We(r.left,e)&&We(r.right,e)};Xe[oe.TRUE]=function(){return!0};Xe[oe.COLLECTION]=function(r,e){var t=r.value;return t.has(e)};Xe[oe.FILTER]=function(r,e){var t=r.value;return t(e)};var Fg=function(e){var t=this;if(t.length===1&&t[0].checks.length===1&&t[0].checks[0].type===oe.ID)return e.getElementById(t[0].checks[0].value).collection();var a=function(i){for(var o=0;o<t.length;o++){var s=t[o];if(We(s,i))return!0}return!1};return t.text()==null&&(a=function(){return!0}),e.filter(a)},Vg=function(e){for(var t=this,a=0;a<t.length;a++){var n=t[a];if(We(n,e))return!0}return!1},qg={matches:Vg,filter:Fg},ft=function(e){this.inputText=e,this.currentSubject=null,this.compoundCount=0,this.edgeCount=0,this.length=0,e==null||ge(e)&&e.match(/^\s*$/)||(Dr(e)?this.addQuery({checks:[{type:oe.COLLECTION,value:e.collection()}]}):Ue(e)?this.addQuery({checks:[{type:oe.FILTER,value:e}]}):ge(e)?this.parse(e)||(this.invalid=!0):$e("A selector must be created from a string; found "))},ct=ft.prototype;[Ig,qg].forEach(function(r){return be(ct,r)});ct.text=function(){return this.inputText};ct.size=function(){return this.length};ct.eq=function(r){return this[r]};ct.sameText=function(r){return!this.invalid&&!r.invalid&&this.text()===r.text()};ct.addQuery=function(r){this[this.length++]=r};ct.selector=ct.toString;var ot={allAre:function(e){var t=new ft(e);return this.every(function(a){return t.matches(a)})},is:function(e){var t=new ft(e);return this.some(function(a){return t.matches(a)})},some:function(e,t){for(var a=0;a<this.length;a++){var n=t?e.apply(t,[this[a],a,this]):e(this[a],a,this);if(n)return!0}return!1},every:function(e,t){for(var a=0;a<this.length;a++){var n=t?e.apply(t,[this[a],a,this]):e(this[a],a,this);if(!n)return!1}return!0},same:function(e){if(this===e)return!0;e=this.cy().collection(e);var t=this.length,a=e.length;return t!==a?!1:t===1?this[0]===e[0]:this.every(function(n){return e.hasElementWithId(n.id())})},anySame:function(e){return e=this.cy().collection(e),this.some(function(t){return e.hasElementWithId(t.id())})},allAreNeighbors:function(e){e=this.cy().collection(e);var t=this.neighborhood();return e.every(function(a){return t.hasElementWithId(a.id())})},contains:function(e){e=this.cy().collection(e);var t=this;return e.every(function(a){return t.hasElementWithId(a.id())})}};ot.allAreNeighbours=ot.allAreNeighbors;ot.has=ot.contains;ot.equal=ot.equals=ot.same;var Rr=function(e,t){return function(n,i,o,s){var l=n,u=this,v;if(l==null?v="":Dr(l)&&l.length===1&&(v=l.id()),u.length===1&&v){var f=u[0]._private,c=f.traversalCache=f.traversalCache||{},d=c[t]=c[t]||[],h=Dt(v),y=d[h];return y||(d[h]=e.call(u,n,i,o,s))}else return e.call(u,n,i,o,s)}},jt={parent:function(e){var t=[];if(this.length===1){var a=this[0]._private.parent;if(a)return a}for(var n=0;n<this.length;n++){var i=this[n],o=i._private.parent;o&&t.push(o)}return this.spawn(t,!0).filter(e)},parents:function(e){for(var t=[],a=this.parent();a.nonempty();){for(var n=0;n<a.length;n++){var i=a[n];t.push(i)}a=a.parent()}return this.spawn(t,!0).filter(e)},commonAncestors:function(e){for(var t,a=0;a<this.length;a++){var n=this[a],i=n.parents();t=t||i,t=t.intersect(i)}return t.filter(e)},orphans:function(e){return this.stdFilter(function(t){return t.isOrphan()}).filter(e)},nonorphans:function(e){return this.stdFilter(function(t){return t.isChild()}).filter(e)},children:Rr(function(r){for(var e=[],t=0;t<this.length;t++)for(var a=this[t],n=a._private.children,i=0;i<n.length;i++)e.push(n[i]);return this.spawn(e,!0).filter(r)},"children"),siblings:function(e){return this.parent().children().not(this).filter(e)},isParent:function(){var e=this[0];if(e)return e.isNode()&&e._private.children.length!==0},isChildless:function(){var e=this[0];if(e)return e.isNode()&&e._private.children.length===0},isChild:function(){var e=this[0];if(e)return e.isNode()&&e._private.parent!=null},isOrphan:function(){var e=this[0];if(e)return e.isNode()&&e._private.parent==null},descendants:function(e){var t=[];function a(n){for(var i=0;i<n.length;i++){var o=n[i];t.push(o),o.children().nonempty()&&a(o.children())}}return a(this.children()),this.spawn(t,!0).filter(e)}};function vs(r,e,t,a){for(var n=[],i=new ra,o=r.cy(),s=o.hasCompoundNodes(),l=0;l<r.length;l++){var u=r[l];t?n.push(u):s&&a(n,i,u)}for(;n.length>0;){var v=n.shift();e(v),i.add(v.id()),s&&a(n,i,v)}return r}function Vv(r,e,t){if(t.isParent())for(var a=t._private.children,n=0;n<a.length;n++){var i=a[n];e.has(i.id())||r.push(i)}}jt.forEachDown=function(r){var e=arguments.length>1&&arguments[1]!==void 0?arguments[1]:!0;return vs(this,r,e,Vv)};function qv(r,e,t){if(t.isChild()){var a=t._private.parent;e.has(a.id())||r.push(a)}}jt.forEachUp=function(r){var e=arguments.length>1&&arguments[1]!==void 0?arguments[1]:!0;return vs(this,r,e,qv)};function _g(r,e,t){qv(r,e,t),Vv(r,e,t)}jt.forEachUpAndDown=function(r){var e=arguments.length>1&&arguments[1]!==void 0?arguments[1]:!0;return vs(this,r,e,_g)};jt.ancestors=jt.parents;var Ba,_v;Ba=_v={data:Fe.data({field:"data",bindingEvent:"data",allowBinding:!0,allowSetting:!0,settingEvent:"data",settingTriggersEvent:!0,triggerFnName:"trigger",allowGetting:!0,immutableKeys:{id:!0,source:!0,target:!0,parent:!0},updateStyle:!0}),removeData:Fe.removeData({field:"data",event:"data",triggerFnName:"trigger",triggerEvent:!0,immutableKeys:{id:!0,source:!0,target:!0,parent:!0},updateStyle:!0}),scratch:Fe.data({field:"scratch",bindingEvent:"scratch",allowBinding:!0,allowSetting:!0,settingEvent:"scratch",settingTriggersEvent:!0,triggerFnName:"trigger",allowGetting:!0,updateStyle:!0}),removeScratch:Fe.removeData({field:"scratch",event:"scratch",triggerFnName:"trigger",triggerEvent:!0,updateStyle:!0}),rscratch:Fe.data({field:"rscratch",allowBinding:!1,allowSetting:!0,settingTriggersEvent:!1,allowGetting:!0}),removeRscratch:Fe.removeData({field:"rscratch",triggerEvent:!1}),id:function(){var e=this[0];if(e)return e._private.data.id}};Ba.attr=Ba.data;Ba.removeAttr=Ba.removeData;var Gg=_v,_n={};function yo(r){return function(e){var t=this;if(e===void 0&&(e=!0),t.length!==0)if(t.isNode()&&!t.removed()){for(var a=0,n=t[0],i=n._private.edges,o=0;o<i.length;o++){var s=i[o];!e&&s.isLoop()||(a+=r(n,s))}return a}else return}}be(_n,{degree:yo(function(r,e){return e.source().same(e.target())?2:1}),indegree:yo(function(r,e){return e.target().same(r)?1:0}),outdegree:yo(function(r,e){return e.source().same(r)?1:0})});function Nt(r,e){return function(t){for(var a,n=this.nodes(),i=0;i<n.length;i++){var o=n[i],s=o[r](t);s!==void 0&&(a===void 0||e(s,a))&&(a=s)}return a}}be(_n,{minDegree:Nt("degree",function(r,e){return r<e}),maxDegree:Nt("degree",function(r,e){return r>e}),minIndegree:Nt("indegree",function(r,e){return r<e}),maxIndegree:Nt("indegree",function(r,e){return r>e}),minOutdegree:Nt("outdegree",function(r,e){return r<e}),maxOutdegree:Nt("outdegree",function(r,e){return r>e})});be(_n,{totalDegree:function(e){for(var t=0,a=this.nodes(),n=0;n<a.length;n++)t+=a[n].degree(e);return t}});var Or,Gv,Hv=function(e,t,a){for(var n=0;n<e.length;n++){var i=e[n];if(!i.locked()){var o=i._private.position,s={x:t.x!=null?t.x-o.x:0,y:t.y!=null?t.y-o.y:0};i.isParent()&&!(s.x===0&&s.y===0)&&i.children().shift(s,a),i.dirtyBoundingBoxCache()}}},ol={field:"position",bindingEvent:"position",allowBinding:!0,allowSetting:!0,settingEvent:"position",settingTriggersEvent:!0,triggerFnName:"emitAndNotify",allowGetting:!0,validKeys:["x","y"],beforeGet:function(e){e.updateCompoundBounds()},beforeSet:function(e,t){Hv(e,t,!1)},onSet:function(e){e.dirtyCompoundBoundsCache()},canSet:function(e){return!e.locked()}};Or=Gv={position:Fe.data(ol),silentPosition:Fe.data(be({},ol,{allowBinding:!1,allowSetting:!0,settingTriggersEvent:!1,allowGetting:!1,beforeSet:function(e,t){Hv(e,t,!0)},onSet:function(e){e.dirtyCompoundBoundsCache()}})),positions:function(e,t){if(Le(e))t?this.silentPosition(e):this.position(e);else if(Ue(e)){var a=e,n=this.cy();n.startBatch();for(var i=0;i<this.length;i++){var o=this[i],s=void 0;(s=a(o,i))&&(t?o.silentPosition(s):o.position(s))}n.endBatch()}return this},silentPositions:function(e){return this.positions(e,!0)},shift:function(e,t,a){var n;if(Le(e)?(n={x:ae(e.x)?e.x:0,y:ae(e.y)?e.y:0},a=t):ge(e)&&ae(t)&&(n={x:0,y:0},n[e]=t),n!=null){var i=this.cy();i.startBatch();for(var o=0;o<this.length;o++){var s=this[o];if(!(i.hasCompoundNodes()&&s.isChild()&&s.ancestors().anySame(this))){var l=s.position(),u={x:l.x+n.x,y:l.y+n.y};a?s.silentPosition(u):s.position(u)}}i.endBatch()}return this},silentShift:function(e,t){return Le(e)?this.shift(e,!0):ge(e)&&ae(t)&&this.shift(e,t,!0),this},renderedPosition:function(e,t){var a=this[0],n=this.cy(),i=n.zoom(),o=n.pan(),s=Le(e)?e:void 0,l=s!==void 0||t!==void 0&&ge(e);if(a&&a.isNode())if(l)for(var u=0;u<this.length;u++){var v=this[u];t!==void 0?v.position(e,(t-o[e])/i):s!==void 0&&v.position(yv(s,i,o))}else{var f=a.position();return s=On(f,i,o),e===void 0?s:s[e]}else if(!l)return;return this},relativePosition:function(e,t){var a=this[0],n=this.cy(),i=Le(e)?e:void 0,o=i!==void 0||t!==void 0&&ge(e),s=n.hasCompoundNodes();if(a&&a.isNode())if(o)for(var l=0;l<this.length;l++){var u=this[l],v=s?u.parent():null,f=v&&v.length>0,c=f;f&&(v=v[0]);var d=c?v.position():{x:0,y:0};t!==void 0?u.position(e,t+d[e]):i!==void 0&&u.position({x:i.x+d.x,y:i.y+d.y})}else{var h=a.position(),y=s?a.parent():null,g=y&&y.length>0,p=g;g&&(y=y[0]);var m=p?y.position():{x:0,y:0};return i={x:h.x-m.x,y:h.y-m.y},e===void 0?i:i[e]}else if(!o)return;return this}};Or.modelPosition=Or.point=Or.position;Or.modelPositions=Or.points=Or.positions;Or.renderedPoint=Or.renderedPosition;Or.relativePoint=Or.relativePosition;var Hg=Gv,Zt,pt;Zt=pt={};pt.renderedBoundingBox=function(r){var e=this.boundingBox(r),t=this.cy(),a=t.zoom(),n=t.pan(),i=e.x1*a+n.x,o=e.x2*a+n.x,s=e.y1*a+n.y,l=e.y2*a+n.y;return{x1:i,x2:o,y1:s,y2:l,w:o-i,h:l-s}};pt.dirtyCompoundBoundsCache=function(){var r=arguments.length>0&&arguments[0]!==void 0?arguments[0]:!1,e=this.cy();return!e.styleEnabled()||!e.hasCompoundNodes()?this:(this.forEachUp(function(t){if(t.isParent()){var a=t._private;a.compoundBoundsClean=!1,a.bbCache=null,r||t.emitAndNotify("bounds")}}),this)};pt.updateCompoundBounds=function(){var r=arguments.length>0&&arguments[0]!==void 0?arguments[0]:!1,e=this.cy();if(!e.styleEnabled()||!e.hasCompoundNodes())return this;if(!r&&e.batching())return this;function t(o){if(!o.isParent())return;var s=o._private,l=o.children(),u=o.pstyle("compound-sizing-wrt-labels").value==="include",v={width:{val:o.pstyle("min-width").pfValue,left:o.pstyle("min-width-bias-left"),right:o.pstyle("min-width-bias-right")},height:{val:o.pstyle("min-height").pfValue,top:o.pstyle("min-height-bias-top"),bottom:o.pstyle("min-height-bias-bottom")}},f=l.boundingBox({includeLabels:u,includeOverlays:!1,useCache:!1}),c=s.position;(f.w===0||f.h===0)&&(f={w:o.pstyle("width").pfValue,h:o.pstyle("height").pfValue},f.x1=c.x-f.w/2,f.x2=c.x+f.w/2,f.y1=c.y-f.h/2,f.y2=c.y+f.h/2);function d(k,D,B){var P=0,A=0,R=D+B;return k>0&&R>0&&(P=D/R*k,A=B/R*k),{biasDiff:P,biasComplementDiff:A}}function h(k,D,B,P){if(B.units==="%")switch(P){case"width":return k>0?B.pfValue*k:0;case"height":return D>0?B.pfValue*D:0;case"average":return k>0&&D>0?B.pfValue*(k+D)/2:0;case"min":return k>0&&D>0?k>D?B.pfValue*D:B.pfValue*k:0;case"max":return k>0&&D>0?k>D?B.pfValue*k:B.pfValue*D:0;default:return 0}else return B.units==="px"?B.pfValue:0}var y=v.width.left.value;v.width.left.units==="px"&&v.width.val>0&&(y=y*100/v.width.val);var g=v.width.right.value;v.width.right.units==="px"&&v.width.val>0&&(g=g*100/v.width.val);var p=v.height.top.value;v.height.top.units==="px"&&v.height.val>0&&(p=p*100/v.height.val);var m=v.height.bottom.value;v.height.bottom.units==="px"&&v.height.val>0&&(m=m*100/v.height.val);var b=d(v.width.val-f.w,y,g),w=b.biasDiff,E=b.biasComplementDiff,C=d(v.height.val-f.h,p,m),x=C.biasDiff,T=C.biasComplementDiff;s.autoPadding=h(f.w,f.h,o.pstyle("padding"),o.pstyle("padding-relative-to").value),s.autoWidth=Math.max(f.w,v.width.val),c.x=(-w+f.x1+f.x2+E)/2,s.autoHeight=Math.max(f.h,v.height.val),c.y=(-x+f.y1+f.y2+T)/2}for(var a=0;a<this.length;a++){var n=this[a],i=n._private;(!i.compoundBoundsClean||r)&&(t(n),e.batching()||(i.compoundBoundsClean=!0))}return this};var Ar=function(e){return e===1/0||e===-1/0?0:e},Ir=function(e,t,a,n,i){n-t===0||i-a===0||t==null||a==null||n==null||i==null||(e.x1=t<e.x1?t:e.x1,e.x2=n>e.x2?n:e.x2,e.y1=a<e.y1?a:e.y1,e.y2=i>e.y2?i:e.y2,e.w=e.x2-e.x1,e.h=e.y2-e.y1)},tt=function(e,t){return t==null?e:Ir(e,t.x1,t.y1,t.x2,t.y2)},fa=function(e,t,a){return Tr(e,t,a)},ja=function(e,t,a){if(!t.cy().headless()){var n=t._private,i=n.rstyle,o=i.arrowWidth/2,s=t.pstyle(a+"-arrow-shape").value,l,u;if(s!=="none"){a==="source"?(l=i.srcX,u=i.srcY):a==="target"?(l=i.tgtX,u=i.tgtY):(l=i.midX,u=i.midY);var v=n.arrowBounds=n.arrowBounds||{},f=v[a]=v[a]||{};f.x1=l-o,f.y1=u-o,f.x2=l+o,f.y2=u+o,f.w=f.x2-f.x1,f.h=f.y2-f.y1,un(f,1),Ir(e,f.x1,f.y1,f.x2,f.y2)}}},mo=function(e,t,a){if(!t.cy().headless()){var n;a?n=a+"-":n="";var i=t._private,o=i.rstyle,s=t.pstyle(n+"label").strValue;if(s){var l=t.pstyle("text-halign"),u=t.pstyle("text-valign"),v=fa(o,"labelWidth",a),f=fa(o,"labelHeight",a),c=fa(o,"labelX",a),d=fa(o,"labelY",a),h=t.pstyle(n+"text-margin-x").pfValue,y=t.pstyle(n+"text-margin-y").pfValue,g=t.isEdge(),p=t.pstyle(n+"text-rotation"),m=t.pstyle("text-outline-width").pfValue,b=t.pstyle("text-border-width").pfValue,w=b/2,E=t.pstyle("text-background-padding").pfValue,C=2,x=f,T=v,k=T/2,D=x/2,B,P,A,R;if(g)B=c-k,P=c+k,A=d-D,R=d+D;else{switch(l.value){case"left":B=c-T,P=c;break;case"center":B=c-k,P=c+k;break;case"right":B=c,P=c+T;break}switch(u.value){case"top":A=d-x,R=d;break;case"center":A=d-D,R=d+D;break;case"bottom":A=d,R=d+x;break}}var L=h-Math.max(m,w)-E-C,I=h+Math.max(m,w)+E+C,M=y-Math.max(m,w)-E-C,O=y+Math.max(m,w)+E+C;B+=L,P+=I,A+=M,R+=O;var V=a||"main",G=i.labelBounds,N=G[V]=G[V]||{};N.x1=B,N.y1=A,N.x2=P,N.y2=R,N.w=P-B,N.h=R-A,N.leftPad=L,N.rightPad=I,N.topPad=M,N.botPad=O;var F=g&&p.strValue==="autorotate",U=p.pfValue!=null&&p.pfValue!==0;if(F||U){var Q=F?fa(i.rstyle,"labelAngle",a):p.pfValue,K=Math.cos(Q),j=Math.sin(Q),re=(B+P)/2,ne=(A+R)/2;if(!g){switch(l.value){case"left":re=P;break;case"right":re=B;break}switch(u.value){case"top":ne=R;break;case"bottom":ne=A;break}}var J=function(Ce,we){return Ce=Ce-re,we=we-ne,{x:Ce*K-we*j+re,y:Ce*j+we*K+ne}},z=J(B,A),q=J(B,R),H=J(P,A),Y=J(P,R);B=Math.min(z.x,q.x,H.x,Y.x),P=Math.max(z.x,q.x,H.x,Y.x),A=Math.min(z.y,q.y,H.y,Y.y),R=Math.max(z.y,q.y,H.y,Y.y)}var te=V+"Rot",ce=G[te]=G[te]||{};ce.x1=B,ce.y1=A,ce.x2=P,ce.y2=R,ce.w=P-B,ce.h=R-A,Ir(e,B,A,P,R),Ir(i.labelBounds.all,B,A,P,R)}return e}},sl=function(e,t){if(!t.cy().headless()){var a=t.pstyle("outline-opacity").value,n=t.pstyle("outline-width").value,i=t.pstyle("outline-offset").value,o=n+i;Wv(e,t,a,o,"outside",o/2)}},Wv=function(e,t,a,n,i,o){if(!(a===0||n<=0||i==="inside")){var s=t.cy(),l=t.pstyle("shape").value,u=s.renderer().nodeShapes[l],v=t.position(),f=v.x,c=v.y,d=t.width(),h=t.height();if(u.hasMiterBounds){i==="center"&&(n/=2);var y=u.miterBounds(f,c,d,h,n);tt(e,y)}else o!=null&&o>0&&ln(e,[o,o,o,o])}},Wg=function(e,t){if(!t.cy().headless()){var a=t.pstyle("border-opacity").value,n=t.pstyle("border-width").pfValue,i=t.pstyle("border-position").value;Wv(e,t,a,n,i)}},$g=function(e,t){var a=e._private.cy,n=a.styleEnabled(),i=a.headless(),o=wr(),s=e._private,l=e.isNode(),u=e.isEdge(),v,f,c,d,h,y,g=s.rstyle,p=l&&n?e.pstyle("bounds-expansion").pfValue:[0],m=function(Ae){return Ae.pstyle("display").value!=="none"},b=!n||m(e)&&(!u||m(e.source())&&m(e.target()));if(b){var w=0,E=0;n&&t.includeOverlays&&(w=e.pstyle("overlay-opacity").value,w!==0&&(E=e.pstyle("overlay-padding").value));var C=0,x=0;n&&t.includeUnderlays&&(C=e.pstyle("underlay-opacity").value,C!==0&&(x=e.pstyle("underlay-padding").value));var T=Math.max(E,x),k=0,D=0;if(n&&(k=e.pstyle("width").pfValue,D=k/2),l&&t.includeNodes){var B=e.position();h=B.x,y=B.y;var P=e.outerWidth(),A=P/2,R=e.outerHeight(),L=R/2;v=h-A,f=h+A,c=y-L,d=y+L,Ir(o,v,c,f,d),n&&sl(o,e),n&&t.includeOutlines&&!i&&sl(o,e),n&&Wg(o,e)}else if(u&&t.includeEdges)if(n&&!i){var I=e.pstyle("curve-style").strValue;if(v=Math.min(g.srcX,g.midX,g.tgtX),f=Math.max(g.srcX,g.midX,g.tgtX),c=Math.min(g.srcY,g.midY,g.tgtY),d=Math.max(g.srcY,g.midY,g.tgtY),v-=D,f+=D,c-=D,d+=D,Ir(o,v,c,f,d),I==="haystack"){var M=g.haystackPts;if(M&&M.length===2){if(v=M[0].x,c=M[0].y,f=M[1].x,d=M[1].y,v>f){var O=v;v=f,f=O}if(c>d){var V=c;c=d,d=V}Ir(o,v-D,c-D,f+D,d+D)}}else if(I==="bezier"||I==="unbundled-bezier"||at(I,"segments")||at(I,"taxi")){var G;switch(I){case"bezier":case"unbundled-bezier":G=g.bezierPts;break;case"segments":case"taxi":case"round-segments":case"round-taxi":G=g.linePts;break}if(G!=null)for(var N=0;N<G.length;N++){var F=G[N];v=F.x-D,f=F.x+D,c=F.y-D,d=F.y+D,Ir(o,v,c,f,d)}}}else{var U=e.source(),Q=U.position(),K=e.target(),j=K.position();if(v=Q.x,f=j.x,c=Q.y,d=j.y,v>f){var re=v;v=f,f=re}if(c>d){var ne=c;c=d,d=ne}v-=D,f+=D,c-=D,d+=D,Ir(o,v,c,f,d)}if(n&&t.includeEdges&&u&&(ja(o,e,"mid-source"),ja(o,e,"mid-target"),ja(o,e,"source"),ja(o,e,"target")),n){var J=e.pstyle("ghost").value==="yes";if(J){var z=e.pstyle("ghost-offset-x").pfValue,q=e.pstyle("ghost-offset-y").pfValue;Ir(o,o.x1+z,o.y1+q,o.x2+z,o.y2+q)}}var H=s.bodyBounds=s.bodyBounds||{};Us(H,o),ln(H,p),un(H,1),n&&(v=o.x1,f=o.x2,c=o.y1,d=o.y2,Ir(o,v-T,c-T,f+T,d+T));var Y=s.overlayBounds=s.overlayBounds||{};Us(Y,o),ln(Y,p),un(Y,1);var te=s.labelBounds=s.labelBounds||{};te.all!=null?kh(te.all):te.all=wr(),n&&t.includeLabels&&(t.includeMainLabels&&mo(o,e,null),u&&(t.includeSourceLabels&&mo(o,e,"source"),t.includeTargetLabels&&mo(o,e,"target")))}return o.x1=Ar(o.x1),o.y1=Ar(o.y1),o.x2=Ar(o.x2),o.y2=Ar(o.y2),o.w=Ar(o.x2-o.x1),o.h=Ar(o.y2-o.y1),o.w>0&&o.h>0&&b&&(ln(o,p),un(o,1)),o},$v=function(e){var t=0,a=function(o){return(o?1:0)<<t++},n=0;return n+=a(e.incudeNodes),n+=a(e.includeEdges),n+=a(e.includeLabels),n+=a(e.includeMainLabels),n+=a(e.includeSourceLabels),n+=a(e.includeTargetLabels),n+=a(e.includeOverlays),n+=a(e.includeOutlines),n},Uv=function(e){var t=function(s){return Math.round(s)};if(e.isEdge()){var a=e.source().position(),n=e.target().position();return qs([t(a.x),t(a.y),t(n.x),t(n.y)])}else{var i=e.position();return qs([t(i.x),t(i.y)])}},ul=function(e,t){var a=e._private,n,i=e.isEdge(),o=t==null?ll:$v(t),s=o===ll;if(a.bbCache==null?(n=$g(e,Pa),a.bbCache=n,a.bbCachePosKey=Uv(e)):n=a.bbCache,!s){var l=e.isNode();n=wr(),(t.includeNodes&&l||t.includeEdges&&!l)&&(t.includeOverlays?tt(n,a.overlayBounds):tt(n,a.bodyBounds)),t.includeLabels&&(t.includeMainLabels&&(!i||t.includeSourceLabels&&t.includeTargetLabels)?tt(n,a.labelBounds.all):(t.includeMainLabels&&tt(n,a.labelBounds.mainRot),t.includeSourceLabels&&tt(n,a.labelBounds.sourceRot),t.includeTargetLabels&&tt(n,a.labelBounds.targetRot))),n.w=n.x2-n.x1,n.h=n.y2-n.y1}return n},Pa={includeNodes:!0,includeEdges:!0,includeLabels:!0,includeMainLabels:!0,includeSourceLabels:!0,includeTargetLabels:!0,includeOverlays:!0,includeUnderlays:!0,includeOutlines:!0,useCache:!0},ll=$v(Pa),vl=cr(Pa);pt.boundingBox=function(r){var e,t=r===void 0||r.useCache===void 0||r.useCache===!0,a=Qt(function(v){var f=v._private;return f.bbCache==null||f.styleDirty||f.bbCachePosKey!==Uv(v)},function(v){return v.id()});if(t&&this.length===1&&!a(this[0]))r===void 0?r=Pa:r=vl(r),e=ul(this[0],r);else{e=wr(),r=r||Pa;var n=vl(r),i=this,o=i.cy(),s=o.styleEnabled();this.edges().forEach(a),this.nodes().forEach(a),s&&this.recalculateRenderedStyle(t),this.updateCompoundBounds(!t);for(var l=0;l<i.length;l++){var u=i[l];a(u)&&u.dirtyBoundingBoxCache(),tt(e,ul(u,n))}}return e.x1=Ar(e.x1),e.y1=Ar(e.y1),e.x2=Ar(e.x2),e.y2=Ar(e.y2),e.w=Ar(e.x2-e.x1),e.h=Ar(e.y2-e.y1),e};pt.dirtyBoundingBoxCache=function(){for(var r=0;r<this.length;r++){var e=this[r]._private;e.bbCache=null,e.bbCachePosKey=null,e.bodyBounds=null,e.overlayBounds=null,e.labelBounds.all=null,e.labelBounds.source=null,e.labelBounds.target=null,e.labelBounds.main=null,e.labelBounds.sourceRot=null,e.labelBounds.targetRot=null,e.labelBounds.mainRot=null,e.arrowBounds.source=null,e.arrowBounds.target=null,e.arrowBounds["mid-source"]=null,e.arrowBounds["mid-target"]=null}return this.emitAndNotify("bounds"),this};pt.boundingBoxAt=function(r){var e=this.nodes(),t=this.cy(),a=t.hasCompoundNodes(),n=t.collection();if(a&&(n=e.filter(function(u){return u.isParent()}),e=e.not(n)),Le(r)){var i=r;r=function(){return i}}var o=function(v,f){return v._private.bbAtOldPos=r(v,f)},s=function(v){return v._private.bbAtOldPos};t.startBatch(),e.forEach(o).silentPositions(r),a&&(n.dirtyCompoundBoundsCache(),n.dirtyBoundingBoxCache(),n.updateCompoundBounds(!0));var l=Sh(this.boundingBox({useCache:!1}));return e.silentPositions(s),a&&(n.dirtyCompoundBoundsCache(),n.dirtyBoundingBoxCache(),n.updateCompoundBounds(!0)),t.endBatch(),l};Zt.boundingbox=Zt.bb=Zt.boundingBox;Zt.renderedBoundingbox=Zt.renderedBoundingBox;var Ug=pt,ma,qa;ma=qa={};var Kv=function(e){e.uppercaseName=Ss(e.name),e.autoName="auto"+e.uppercaseName,e.labelName="label"+e.uppercaseName,e.outerName="outer"+e.uppercaseName,e.uppercaseOuterName=Ss(e.outerName),ma[e.name]=function(){var a=this[0],n=a._private,i=n.cy,o=i._private.styleEnabled;if(a)if(o){if(a.isParent())return a.updateCompoundBounds(),n[e.autoName]||0;var s=a.pstyle(e.name);switch(s.strValue){case"label":return a.recalculateRenderedStyle(),n.rstyle[e.labelName]||0;default:return s.pfValue}}else return 1},ma["outer"+e.uppercaseName]=function(){var a=this[0],n=a._private,i=n.cy,o=i._private.styleEnabled;if(a)if(o){var s=a[e.name](),l=a.pstyle("border-position").value,u;l==="center"?u=a.pstyle("border-width").pfValue:l==="outside"?u=2*a.pstyle("border-width").pfValue:u=0;var v=2*a.padding();return s+u+v}else return 1},ma["rendered"+e.uppercaseName]=function(){var a=this[0];if(a){var n=a[e.name]();return n*this.cy().zoom()}},ma["rendered"+e.uppercaseOuterName]=function(){var a=this[0];if(a){var n=a[e.outerName]();return n*this.cy().zoom()}}};Kv({name:"width"});Kv({name:"height"});qa.padding=function(){var r=this[0],e=r._private;return r.isParent()?(r.updateCompoundBounds(),e.autoPadding!==void 0?e.autoPadding:r.pstyle("padding").pfValue):r.pstyle("padding").pfValue};qa.paddedHeight=function(){var r=this[0];return r.height()+2*r.padding()};qa.paddedWidth=function(){var r=this[0];return r.width()+2*r.padding()};var Kg=qa,Xg=function(e,t){if(e.isEdge()&&e.takesUpSpace())return t(e)},Yg=function(e,t){if(e.isEdge()&&e.takesUpSpace()){var a=e.cy();return On(t(e),a.zoom(),a.pan())}},Zg=function(e,t){if(e.isEdge()&&e.takesUpSpace()){var a=e.cy(),n=a.pan(),i=a.zoom();return t(e).map(function(o){return On(o,i,n)})}},Qg=function(e){return e.renderer().getControlPoints(e)},Jg=function(e){return e.renderer().getSegmentPoints(e)},jg=function(e){return e.renderer().getSourceEndpoint(e)},ep=function(e){return e.renderer().getTargetEndpoint(e)},rp=function(e){return e.renderer().getEdgeMidpoint(e)},fl={controlPoints:{get:Qg,mult:!0},segmentPoints:{get:Jg,mult:!0},sourceEndpoint:{get:jg},targetEndpoint:{get:ep},midpoint:{get:rp}},tp=function(e){return"rendered"+e[0].toUpperCase()+e.substr(1)},ap=Object.keys(fl).reduce(function(r,e){var t=fl[e],a=tp(e);return r[e]=function(){return Xg(this,t.get)},t.mult?r[a]=function(){return Zg(this,t.get)}:r[a]=function(){return Yg(this,t.get)},r},{}),np=be({},Hg,Ug,Kg,ap);var Xv=function(e,t){this.recycle(e,t)};function ca(){return!1}function en(){return!0}Xv.prototype={instanceString:function(){return"event"},recycle:function(e,t){if(this.isImmediatePropagationStopped=this.isPropagationStopped=this.isDefaultPrevented=ca,e!=null&&e.preventDefault?(this.type=e.type,this.isDefaultPrevented=e.defaultPrevented?en:ca):e!=null&&e.type?t=e:this.type=e,t!=null&&(this.originalEvent=t.originalEvent,this.type=t.type!=null?t.type:this.type,this.cy=t.cy,this.target=t.target,this.position=t.position,this.renderedPosition=t.renderedPosition,this.namespace=t.namespace,this.layout=t.layout),this.cy!=null&&this.position!=null&&this.renderedPosition==null){var a=this.position,n=this.cy.zoom(),i=this.cy.pan();this.renderedPosition={x:a.x*n+i.x,y:a.y*n+i.y}}this.timeStamp=e&&e.timeStamp||Date.now()},preventDefault:function(){this.isDefaultPrevented=en;var e=this.originalEvent;e&&e.preventDefault&&e.preventDefault()},stopPropagation:function(){this.isPropagationStopped=en;var e=this.originalEvent;e&&e.stopPropagation&&e.stopPropagation()},stopImmediatePropagation:function(){this.isImmediatePropagationStopped=en,this.stopPropagation()},isDefaultPrevented:ca,isPropagationStopped:ca,isImmediatePropagationStopped:ca};var Yv=/^([^.]+)(\.(?:[^.]+))?$/,ip=".*",Zv={qualifierCompare:function(e,t){return e===t},eventMatches:function(){return!0},addEventFields:function(){},callbackContext:function(e){return e},beforeEmit:function(){},afterEmit:function(){},bubble:function(){return!1},parent:function(){return null},context:null},cl=Object.keys(Zv),op={};function Gn(){for(var r=arguments.length>0&&arguments[0]!==void 0?arguments[0]:op,e=arguments.length>1?arguments[1]:void 0,t=0;t<cl.length;t++){var a=cl[t];this[a]=r[a]||Zv[a]}this.context=e||this.context,this.listeners=[],this.emitting=0}var ht=Gn.prototype,Qv=function(e,t,a,n,i,o,s){Ue(n)&&(i=n,n=null),s&&(o==null?o=s:o=be({},o,s));for(var l=_e(a)?a:a.split(/\s+/),u=0;u<l.length;u++){var v=l[u];if(!ut(v)){var f=v.match(Yv);if(f){var c=f[1],d=f[2]?f[2]:null,h=t(e,v,c,d,n,i,o);if(h===!1)break}}}},hl=function(e,t){return e.addEventFields(e.context,t),new Xv(t.type,t)},sp=function(e,t,a){if(hc(a)){t(e,a);return}else if(Le(a)){t(e,hl(e,a));return}for(var n=_e(a)?a:a.split(/\s+/),i=0;i<n.length;i++){var o=n[i];if(!ut(o)){var s=o.match(Yv);if(s){var l=s[1],u=s[2]?s[2]:null,v=hl(e,{type:l,namespace:u,target:e.context});t(e,v)}}}};ht.on=ht.addListener=function(r,e,t,a,n){return Qv(this,function(i,o,s,l,u,v,f){Ue(v)&&i.listeners.push({event:o,callback:v,type:s,namespace:l,qualifier:u,conf:f})},r,e,t,a,n),this};ht.one=function(r,e,t,a){return this.on(r,e,t,a,{one:!0})};ht.removeListener=ht.off=function(r,e,t,a){var n=this;this.emitting!==0&&(this.listeners=Yc(this.listeners));for(var i=this.listeners,o=function(u){var v=i[u];Qv(n,function(f,c,d,h,y,g){if((v.type===d||r==="*")&&(!h&&v.namespace!==".*"||v.namespace===h)&&(!y||f.qualifierCompare(v.qualifier,y))&&(!g||v.callback===g))return i.splice(u,1),!1},r,e,t,a)},s=i.length-1;s>=0;s--)o(s);return this};ht.removeAllListeners=function(){return this.removeListener("*")};ht.emit=ht.trigger=function(r,e,t){var a=this.listeners,n=a.length;return this.emitting++,_e(e)||(e=[e]),sp(this,function(i,o){t!=null&&(a=[{event:o.event,type:o.type,namespace:o.namespace,callback:t}],n=a.length);for(var s=function(){var v=a[l];if(v.type===o.type&&(!v.namespace||v.namespace===o.namespace||v.namespace===ip)&&i.eventMatches(i.context,v,o)){var f=[o];e!=null&&Qc(f,e),i.beforeEmit(i.context,v,o),v.conf&&v.conf.one&&(i.listeners=i.listeners.filter(function(h){return h!==v}));var c=i.callbackContext(i.context,v,o),d=v.callback.apply(c,f);i.afterEmit(i.context,v,o),d===!1&&(o.stopPropagation(),o.preventDefault())}},l=0;l<n;l++)s();i.bubble(i.context)&&!o.isPropagationStopped()&&i.parent(i.context).emit(o,e)},r),this.emitting--,this};var up={qualifierCompare:function(e,t){return e==null||t==null?e==null&&t==null:e.sameText(t)},eventMatches:function(e,t,a){var n=t.qualifier;return n!=null?e!==a.target&&Ia(a.target)&&n.matches(a.target):!0},addEventFields:function(e,t){t.cy=e.cy(),t.target=e},callbackContext:function(e,t,a){return t.qualifier!=null?a.target:e},beforeEmit:function(e,t){t.conf&&t.conf.once&&t.conf.onceCollection.removeListener(t.event,t.qualifier,t.callback)},bubble:function(){return!0},parent:function(e){return e.isChild()?e.parent():e.cy()}},rn=function(e){return ge(e)?new ft(e):e},Jv={createEmitter:function(){for(var e=0;e<this.length;e++){var t=this[e],a=t._private;a.emitter||(a.emitter=new Gn(up,t))}return this},emitter:function(){return this._private.emitter},on:function(e,t,a){for(var n=rn(t),i=0;i<this.length;i++){var o=this[i];o.emitter().on(e,n,a)}return this},removeListener:function(e,t,a){for(var n=rn(t),i=0;i<this.length;i++){var o=this[i];o.emitter().removeListener(e,n,a)}return this},removeAllListeners:function(){for(var e=0;e<this.length;e++){var t=this[e];t.emitter().removeAllListeners()}return this},one:function(e,t,a){for(var n=rn(t),i=0;i<this.length;i++){var o=this[i];o.emitter().one(e,n,a)}return this},once:function(e,t,a){for(var n=rn(t),i=0;i<this.length;i++){var o=this[i];o.emitter().on(e,n,a,{once:!0,onceCollection:this})}},emit:function(e,t){for(var a=0;a<this.length;a++){var n=this[a];n.emitter().emit(e,t)}return this},emitAndNotify:function(e,t){if(this.length!==0)return this.cy().notify(e,this),this.emit(e,t),this}};Fe.eventAliasesOn(Jv);var jv={nodes:function(e){return this.filter(function(t){return t.isNode()}).filter(e)},edges:function(e){return this.filter(function(t){return t.isEdge()}).filter(e)},byGroup:function(){for(var e=this.spawn(),t=this.spawn(),a=0;a<this.length;a++){var n=this[a];n.isNode()?e.push(n):t.push(n)}return{nodes:e,edges:t}},filter:function(e,t){if(e===void 0)return this;if(ge(e)||Dr(e))return new ft(e).filter(this);if(Ue(e)){for(var a=this.spawn(),n=this,i=0;i<n.length;i++){var o=n[i],s=t?e.apply(t,[o,i,n]):e(o,i,n);s&&a.push(o)}return a}return this.spawn()},not:function(e){if(e){ge(e)&&(e=this.filter(e));for(var t=this.spawn(),a=0;a<this.length;a++){var n=this[a],i=e.has(n);i||t.push(n)}return t}else return this},absoluteComplement:function(){var e=this.cy();return e.mutableElements().not(this)},intersect:function(e){if(ge(e)){var t=e;return this.filter(t)}for(var a=this.spawn(),n=this,i=e,o=this.length<e.length,s=o?n:i,l=o?i:n,u=0;u<s.length;u++){var v=s[u];l.has(v)&&a.push(v)}return a},xor:function(e){var t=this._private.cy;ge(e)&&(e=t.$(e));var a=this.spawn(),n=this,i=e,o=function(l,u){for(var v=0;v<l.length;v++){var f=l[v],c=f._private.data.id,d=u.hasElementWithId(c);d||a.push(f)}};return o(n,i),o(i,n),a},diff:function(e){var t=this._private.cy;ge(e)&&(e=t.$(e));var a=this.spawn(),n=this.spawn(),i=this.spawn(),o=this,s=e,l=function(v,f,c){for(var d=0;d<v.length;d++){var h=v[d],y=h._private.data.id,g=f.hasElementWithId(y);g?i.merge(h):c.push(h)}};return l(o,s,a),l(s,o,n),{left:a,right:n,both:i}},add:function(e){var t=this._private.cy;if(!e)return this;if(ge(e)){var a=e;e=t.mutableElements().filter(a)}for(var n=this.spawnSelf(),i=0;i<e.length;i++){var o=e[i],s=!this.has(o);s&&n.push(o)}return n},merge:function(e){var t=this._private,a=t.cy;if(!e)return this;if(e&&ge(e)){var n=e;e=a.mutableElements().filter(n)}for(var i=t.map,o=0;o<e.length;o++){var s=e[o],l=s._private.data.id,u=!i.has(l);if(u){var v=this.length++;this[v]=s,i.set(l,{ele:s,index:v})}}return this},unmergeAt:function(e){var t=this[e],a=t.id(),n=this._private,i=n.map;this[e]=void 0,i.delete(a);var o=e===this.length-1;if(this.length>1&&!o){var s=this.length-1,l=this[s],u=l._private.data.id;this[s]=void 0,this[e]=l,i.set(u,{ele:l,index:e})}return this.length--,this},unmergeOne:function(e){e=e[0];var t=this._private,a=e._private.data.id,n=t.map,i=n.get(a);if(!i)return this;var o=i.index;return this.unmergeAt(o),this},unmerge:function(e){var t=this._private.cy;if(!e)return this;if(e&&ge(e)){var a=e;e=t.mutableElements().filter(a)}for(var n=0;n<e.length;n++)this.unmergeOne(e[n]);return this},unmergeBy:function(e){for(var t=this.length-1;t>=0;t--){var a=this[t];e(a)&&this.unmergeAt(t)}return this},map:function(e,t){for(var a=[],n=this,i=0;i<n.length;i++){var o=n[i],s=t?e.apply(t,[o,i,n]):e(o,i,n);a.push(s)}return a},reduce:function(e,t){for(var a=t,n=this,i=0;i<n.length;i++)a=e(a,n[i],i,n);return a},max:function(e,t){for(var a=-1/0,n,i=this,o=0;o<i.length;o++){var s=i[o],l=t?e.apply(t,[s,o,i]):e(s,o,i);l>a&&(a=l,n=s)}return{value:a,ele:n}},min:function(e,t){for(var a=1/0,n,i=this,o=0;o<i.length;o++){var s=i[o],l=t?e.apply(t,[s,o,i]):e(s,o,i);l<a&&(a=l,n=s)}return{value:a,ele:n}}},Ie=jv;Ie.u=Ie["|"]=Ie["+"]=Ie.union=Ie.or=Ie.add;Ie["\\"]=Ie["!"]=Ie["-"]=Ie.difference=Ie.relativeComplement=Ie.subtract=Ie.not;Ie.n=Ie["&"]=Ie["."]=Ie.and=Ie.intersection=Ie.intersect;Ie["^"]=Ie["(+)"]=Ie["(-)"]=Ie.symmetricDifference=Ie.symdiff=Ie.xor;Ie.fnFilter=Ie.filterFn=Ie.stdFilter=Ie.filter;Ie.complement=Ie.abscomp=Ie.absoluteComplement;var lp={isNode:function(){return this.group()==="nodes"},isEdge:function(){return this.group()==="edges"},isLoop:function(){return this.isEdge()&&this.source()[0]===this.target()[0]},isSimple:function(){return this.isEdge()&&this.source()[0]!==this.target()[0]},group:function(){var e=this[0];if(e)return e._private.group}},ef=function(e,t){var a=e.cy(),n=a.hasCompoundNodes();function i(v){var f=v.pstyle("z-compound-depth");return f.value==="auto"?n?v.zDepth():0:f.value==="bottom"?-1:f.value==="top"?jo:0}var o=i(e)-i(t);if(o!==0)return o;function s(v){var f=v.pstyle("z-index-compare");return f.value==="auto"&&v.isNode()?1:0}var l=s(e)-s(t);if(l!==0)return l;var u=e.pstyle("z-index").value-t.pstyle("z-index").value;return u!==0?u:e.poolIndex()-t.poolIndex()},Sn={forEach:function(e,t){if(Ue(e))for(var a=this.length,n=0;n<a;n++){var i=this[n],o=t?e.apply(t,[i,n,this]):e(i,n,this);if(o===!1)break}return this},toArray:function(){for(var e=[],t=0;t<this.length;t++)e.push(this[t]);return e},slice:function(e,t){var a=[],n=this.length;t==null&&(t=n),e==null&&(e=0),e<0&&(e=n+e),t<0&&(t=n+t);for(var i=e;i>=0&&i<t&&i<n;i++)a.push(this[i]);return this.spawn(a)},size:function(){return this.length},eq:function(e){return this[e]||this.spawn()},first:function(){return this[0]||this.spawn()},last:function(){return this[this.length-1]||this.spawn()},empty:function(){return this.length===0},nonempty:function(){return!this.empty()},sort:function(e){if(!Ue(e))return this;var t=this.toArray().sort(e);return this.spawn(t)},sortByZIndex:function(){return this.sort(ef)},zDepth:function(){var e=this[0];if(e){var t=e._private,a=t.group;if(a==="nodes"){var n=t.data.parent?e.parents().size():0;return e.isParent()?n:jo-1}else{var i=t.source,o=t.target,s=i.zDepth(),l=o.zDepth();return Math.max(s,l,0)}}}};Sn.each=Sn.forEach;var vp=function(){var e="undefined",t=(typeof Symbol>"u"?"undefined":ar(Symbol))!=e&&ar(Symbol.iterator)!=e;t&&(Sn[Symbol.iterator]=function(){var a=this,n={value:void 0,done:!1},i=0,o=this.length;return Jl({next:function(){return i<o?n.value=a[i++]:(n.value=void 0,n.done=!0),n}},Symbol.iterator,function(){return this})})};vp();var fp=cr({nodeDimensionsIncludeLabels:!1}),fn={layoutDimensions:function(e){e=fp(e);var t;if(!this.takesUpSpace())t={w:0,h:0};else if(e.nodeDimensionsIncludeLabels){var a=this.boundingBox();t={w:a.w,h:a.h}}else t={w:this.outerWidth(),h:this.outerHeight()};return(t.w===0||t.h===0)&&(t.w=t.h=1),t},layoutPositions:function(e,t,a){var n=this.nodes().filter(function(E){return!E.isParent()}),i=this.cy(),o=t.eles,s=function(C){return C.id()},l=Qt(a,s);e.emit({type:"layoutstart",layout:e}),e.animations=[];var u=function(C,x,T){var k={x:x.x1+x.w/2,y:x.y1+x.h/2},D={x:(T.x-k.x)*C,y:(T.y-k.y)*C};return{x:k.x+D.x,y:k.y+D.y}},v=t.spacingFactor&&t.spacingFactor!==1,f=function(){if(!v)return null;for(var C=wr(),x=0;x<n.length;x++){var T=n[x],k=l(T,x);mv(C,k.x,k.y)}return C},c=f(),d=Qt(function(E,C){var x=l(E,C);if(v){var T=Math.abs(t.spacingFactor);x=u(T,c,x)}return t.transform!=null&&(x=t.transform(E,x)),x},s);if(t.animate){for(var h=0;h<n.length;h++){var y=n[h],g=d(y,h),p=t.animateFilter==null||t.animateFilter(y,h);if(p){var m=y.animation({position:g,duration:t.animationDuration,easing:t.animationEasing});e.animations.push(m)}else y.position(g)}if(t.fit){var b=i.animation({fit:{boundingBox:o.boundingBoxAt(d),padding:t.padding},duration:t.animationDuration,easing:t.animationEasing});e.animations.push(b)}else if(t.zoom!==void 0&&t.pan!==void 0){var w=i.animation({zoom:t.zoom,pan:t.pan,duration:t.animationDuration,easing:t.animationEasing});e.animations.push(w)}e.animations.forEach(function(E){return E.play()}),e.one("layoutready",t.ready),e.emit({type:"layoutready",layout:e}),ta.all(e.animations.map(function(E){return E.promise()})).then(function(){e.one("layoutstop",t.stop),e.emit({type:"layoutstop",layout:e})})}else n.positions(d),t.fit&&i.fit(t.eles,t.padding),t.zoom!=null&&i.zoom(t.zoom),t.pan&&i.pan(t.pan),e.one("layoutready",t.ready),e.emit({type:"layoutready",layout:e}),e.one("layoutstop",t.stop),e.emit({type:"layoutstop",layout:e});return this},layout:function(e){var t=this.cy();return t.makeLayout(be({},e,{eles:this}))}};fn.createLayout=fn.makeLayout=fn.layout;function rf(r,e,t){var a=t._private,n=a.styleCache=a.styleCache||[],i;return(i=n[r])!=null||(i=n[r]=e(t)),i}function Hn(r,e){return r=Dt(r),function(a){return rf(r,e,a)}}function Wn(r,e){r=Dt(r);var t=function(n){return e.call(n)};return function(){var n=this[0];if(n)return rf(r,t,n)}}var vr={recalculateRenderedStyle:function(e){var t=this.cy(),a=t.renderer(),n=t.styleEnabled();return a&&n&&a.recalculateRenderedStyle(this,e),this},dirtyStyleCache:function(){var e=this.cy(),t=function(i){return i._private.styleCache=null};if(e.hasCompoundNodes()){var a;a=this.spawnSelf().merge(this.descendants()).merge(this.parents()),a.merge(a.connectedEdges()),a.forEach(t)}else this.forEach(function(n){t(n),n.connectedEdges().forEach(t)});return this},updateStyle:function(e){var t=this._private.cy;if(!t.styleEnabled())return this;if(t.batching()){var a=t._private.batchStyleEles;return a.merge(this),this}var n=t.hasCompoundNodes(),i=this;e=!!(e||e===void 0),n&&(i=this.spawnSelf().merge(this.descendants()).merge(this.parents()));var o=i;return e?o.emitAndNotify("style"):o.emit("style"),i.forEach(function(s){return s._private.styleDirty=!0}),this},cleanStyle:function(){var e=this.cy();if(e.styleEnabled())for(var t=0;t<this.length;t++){var a=this[t];a._private.styleDirty&&(a._private.styleDirty=!1,e.style().apply(a))}},parsedStyle:function(e){var t=arguments.length>1&&arguments[1]!==void 0?arguments[1]:!0,a=this[0],n=a.cy();if(n.styleEnabled()&&a){a._private.styleDirty&&(a._private.styleDirty=!1,n.style().apply(a));var i=a._private.style[e];return i??(t?n.style().getDefaultProperty(e):null)}},numericStyle:function(e){var t=this[0];if(t.cy().styleEnabled()&&t){var a=t.pstyle(e);return a.pfValue!==void 0?a.pfValue:a.value}},numericStyleUnits:function(e){var t=this[0];if(t.cy().styleEnabled()&&t)return t.pstyle(e).units},renderedStyle:function(e){var t=this.cy();if(!t.styleEnabled())return this;var a=this[0];if(a)return t.style().getRenderedStyle(a,e)},style:function(e,t){var a=this.cy();if(!a.styleEnabled())return this;var n=!1,i=a.style();if(Le(e)){var o=e;i.applyBypass(this,o,n),this.emitAndNotify("style")}else if(ge(e))if(t===void 0){var s=this[0];return s?i.getStylePropertyValue(s,e):void 0}else i.applyBypass(this,e,t,n),this.emitAndNotify("style");else if(e===void 0){var l=this[0];return l?i.getRawStyle(l):void 0}return this},removeStyle:function(e){var t=this.cy();if(!t.styleEnabled())return this;var a=!1,n=t.style(),i=this;if(e===void 0)for(var o=0;o<i.length;o++){var s=i[o];n.removeAllBypasses(s,a)}else{e=e.split(/\s+/);for(var l=0;l<i.length;l++){var u=i[l];n.removeBypasses(u,e,a)}}return this.emitAndNotify("style"),this},show:function(){return this.css("display","element"),this},hide:function(){return this.css("display","none"),this},effectiveOpacity:function(){var e=this.cy();if(!e.styleEnabled())return 1;var t=e.hasCompoundNodes(),a=this[0];if(a){var n=a._private,i=a.pstyle("opacity").value;if(!t)return i;var o=n.data.parent?a.parents():null;if(o)for(var s=0;s<o.length;s++){var l=o[s],u=l.pstyle("opacity").value;i=u*i}return i}},transparent:function(){var e=this.cy();if(!e.styleEnabled())return!1;var t=this[0],a=t.cy().hasCompoundNodes();if(t)return a?t.effectiveOpacity()===0:t.pstyle("opacity").value===0},backgrounding:function(){var e=this.cy();if(!e.styleEnabled())return!1;var t=this[0];return!!t._private.backgrounding}};function bo(r,e){var t=r._private,a=t.data.parent?r.parents():null;if(a)for(var n=0;n<a.length;n++){var i=a[n];if(!e(i))return!1}return!0}function fs(r){var e=r.ok,t=r.edgeOkViaNode||r.ok,a=r.parentOk||r.ok;return function(){var n=this.cy();if(!n.styleEnabled())return!0;var i=this[0],o=n.hasCompoundNodes();if(i){var s=i._private;if(!e(i))return!1;if(i.isNode())return!o||bo(i,a);var l=s.source,u=s.target;return t(l)&&(!o||bo(l,t))&&(l===u||t(u)&&(!o||bo(u,t)))}}}var aa=Hn("eleTakesUpSpace",function(r){return r.pstyle("display").value==="element"&&r.width()!==0&&(r.isNode()?r.height()!==0:!0)});vr.takesUpSpace=Wn("takesUpSpace",fs({ok:aa}));var cp=Hn("eleInteractive",function(r){return r.pstyle("events").value==="yes"&&r.pstyle("visibility").value==="visible"&&aa(r)}),hp=Hn("parentInteractive",function(r){return r.pstyle("visibility").value==="visible"&&aa(r)});vr.interactive=Wn("interactive",fs({ok:cp,parentOk:hp,edgeOkViaNode:aa}));vr.noninteractive=function(){var r=this[0];if(r)return!r.interactive()};var dp=Hn("eleVisible",function(r){return r.pstyle("visibility").value==="visible"&&r.pstyle("opacity").pfValue!==0&&aa(r)}),gp=aa;vr.visible=Wn("visible",fs({ok:dp,edgeOkViaNode:gp}));vr.hidden=function(){var r=this[0];if(r)return!r.visible()};vr.isBundledBezier=Wn("isBundledBezier",function(){return this.cy().styleEnabled()?!this.removed()&&this.pstyle("curve-style").value==="bezier"&&this.takesUpSpace():!1});vr.bypass=vr.css=vr.style;vr.renderedCss=vr.renderedStyle;vr.removeBypass=vr.removeCss=vr.removeStyle;vr.pstyle=vr.parsedStyle;var st={};function dl(r){return function(){var e=arguments,t=[];if(e.length===2){var a=e[0],n=e[1];this.on(r.event,a,n)}else if(e.length===1&&Ue(e[0])){var i=e[0];this.on(r.event,i)}else if(e.length===0||e.length===1&&_e(e[0])){for(var o=e.length===1?e[0]:null,s=0;s<this.length;s++){var l=this[s],u=!r.ableField||l._private[r.ableField],v=l._private[r.field]!=r.value;if(r.overrideAble){var f=r.overrideAble(l);if(f!==void 0&&(u=f,!f))return this}u&&(l._private[r.field]=r.value,v&&t.push(l))}var c=this.spawn(t);c.updateStyle(),c.emit(r.event),o&&c.emit(o)}return this}}function na(r){st[r.field]=function(){var e=this[0];if(e){if(r.overrideField){var t=r.overrideField(e);if(t!==void 0)return t}return e._private[r.field]}},st[r.on]=dl({event:r.on,field:r.field,ableField:r.ableField,overrideAble:r.overrideAble,value:!0}),st[r.off]=dl({event:r.off,field:r.field,ableField:r.ableField,overrideAble:r.overrideAble,value:!1})}na({field:"locked",overrideField:function(e){return e.cy().autolock()?!0:void 0},on:"lock",off:"unlock"});na({field:"grabbable",overrideField:function(e){return e.cy().autoungrabify()||e.pannable()?!1:void 0},on:"grabify",off:"ungrabify"});na({field:"selected",ableField:"selectable",overrideAble:function(e){return e.cy().autounselectify()?!1:void 0},on:"select",off:"unselect"});na({field:"selectable",overrideField:function(e){return e.cy().autounselectify()?!1:void 0},on:"selectify",off:"unselectify"});st.deselect=st.unselect;st.grabbed=function(){var r=this[0];if(r)return r._private.grabbed};na({field:"active",on:"activate",off:"unactivate"});na({field:"pannable",on:"panify",off:"unpanify"});st.inactive=function(){var r=this[0];if(r)return!r._private.active};var gr={},gl=function(e){return function(a){for(var n=this,i=[],o=0;o<n.length;o++){var s=n[o];if(s.isNode()){for(var l=!1,u=s.connectedEdges(),v=0;v<u.length;v++){var f=u[v],c=f.source(),d=f.target();if(e.noIncomingEdges&&d===s&&c!==s||e.noOutgoingEdges&&c===s&&d!==s){l=!0;break}}l||i.push(s)}}return this.spawn(i,!0).filter(a)}},pl=function(e){return function(t){for(var a=this,n=[],i=0;i<a.length;i++){var o=a[i];if(o.isNode())for(var s=o.connectedEdges(),l=0;l<s.length;l++){var u=s[l],v=u.source(),f=u.target();e.outgoing&&v===o?(n.push(u),n.push(f)):e.incoming&&f===o&&(n.push(u),n.push(v))}}return this.spawn(n,!0).filter(t)}},yl=function(e){return function(t){for(var a=this,n=[],i={};;){var o=e.outgoing?a.outgoers():a.incomers();if(o.length===0)break;for(var s=!1,l=0;l<o.length;l++){var u=o[l],v=u.id();i[v]||(i[v]=!0,n.push(u),s=!0)}if(!s)break;a=o}return this.spawn(n,!0).filter(t)}};gr.clearTraversalCache=function(){for(var r=0;r<this.length;r++)this[r]._private.traversalCache=null};be(gr,{roots:gl({noIncomingEdges:!0}),leaves:gl({noOutgoingEdges:!0}),outgoers:Rr(pl({outgoing:!0}),"outgoers"),successors:yl({outgoing:!0}),incomers:Rr(pl({incoming:!0}),"incomers"),predecessors:yl({})});be(gr,{neighborhood:Rr(function(r){for(var e=[],t=this.nodes(),a=0;a<t.length;a++)for(var n=t[a],i=n.connectedEdges(),o=0;o<i.length;o++){var s=i[o],l=s.source(),u=s.target(),v=n===l?u:l;v.length>0&&e.push(v[0]),e.push(s[0])}return this.spawn(e,!0).filter(r)},"neighborhood"),closedNeighborhood:function(e){return this.neighborhood().add(this).filter(e)},openNeighborhood:function(e){return this.neighborhood(e)}});gr.neighbourhood=gr.neighborhood;gr.closedNeighbourhood=gr.closedNeighborhood;gr.openNeighbourhood=gr.openNeighborhood;be(gr,{source:Rr(function(e){var t=this[0],a;return t&&(a=t._private.source||t.cy().collection()),a&&e?a.filter(e):a},"source"),target:Rr(function(e){var t=this[0],a;return t&&(a=t._private.target||t.cy().collection()),a&&e?a.filter(e):a},"target"),sources:ml({attr:"source"}),targets:ml({attr:"target"})});function ml(r){return function(t){for(var a=[],n=0;n<this.length;n++){var i=this[n],o=i._private[r.attr];o&&a.push(o)}return this.spawn(a,!0).filter(t)}}be(gr,{edgesWith:Rr(bl(),"edgesWith"),edgesTo:Rr(bl({thisIsSrc:!0}),"edgesTo")});function bl(r){return function(t){var a=[],n=this._private.cy,i=r||{};ge(t)&&(t=n.$(t));for(var o=0;o<t.length;o++)for(var s=t[o]._private.edges,l=0;l<s.length;l++){var u=s[l],v=u._private.data,f=this.hasElementWithId(v.source)&&t.hasElementWithId(v.target),c=t.hasElementWithId(v.source)&&this.hasElementWithId(v.target),d=f||c;d&&((i.thisIsSrc||i.thisIsTgt)&&(i.thisIsSrc&&!f||i.thisIsTgt&&!c)||a.push(u))}return this.spawn(a,!0)}}be(gr,{connectedEdges:Rr(function(r){for(var e=[],t=this,a=0;a<t.length;a++){var n=t[a];if(n.isNode())for(var i=n._private.edges,o=0;o<i.length;o++){var s=i[o];e.push(s)}}return this.spawn(e,!0).filter(r)},"connectedEdges"),connectedNodes:Rr(function(r){for(var e=[],t=this,a=0;a<t.length;a++){var n=t[a];n.isEdge()&&(e.push(n.source()[0]),e.push(n.target()[0]))}return this.spawn(e,!0).filter(r)},"connectedNodes"),parallelEdges:Rr(wl(),"parallelEdges"),codirectedEdges:Rr(wl({codirected:!0}),"codirectedEdges")});function wl(r){var e={codirected:!1};return r=be({},e,r),function(a){for(var n=[],i=this.edges(),o=r,s=0;s<i.length;s++)for(var l=i[s],u=l._private,v=u.source,f=v._private.data.id,c=u.data.target,d=v._private.edges,h=0;h<d.length;h++){var y=d[h],g=y._private.data,p=g.target,m=g.source,b=p===c&&m===f,w=f===p&&c===m;(o.codirected&&b||!o.codirected&&(b||w))&&n.push(y)}return this.spawn(n,!0).filter(a)}}be(gr,{components:function(e){var t=this,a=t.cy(),n=a.collection(),i=e==null?t.nodes():e.nodes(),o=[];e!=null&&i.empty()&&(i=e.sources());var s=function(v,f){n.merge(v),i.unmerge(v),f.merge(v)};if(i.empty())return t.spawn();var l=function(){var v=a.collection();o.push(v);var f=i[0];s(f,v),t.bfs({directed:!1,roots:f,visit:function(d){return s(d,v)}}),v.forEach(function(c){c.connectedEdges().forEach(function(d){t.has(d)&&v.has(d.source())&&v.has(d.target())&&v.merge(d)})})};do l();while(i.length>0);return o},component:function(){var e=this[0];return e.cy().mutableElements().components(e)[0]}});gr.componentsOf=gr.components;var fr=function(e,t){var a=arguments.length>2&&arguments[2]!==void 0?arguments[2]:!1,n=arguments.length>3&&arguments[3]!==void 0?arguments[3]:!1;if(e===void 0){$e("A collection must have a reference to the core");return}var i=new Xr,o=!1;if(!t)t=[];else if(t.length>0&&Le(t[0])&&!Ia(t[0])){o=!0;for(var s=[],l=new ra,u=0,v=t.length;u<v;u++){var f=t[u];f.data==null&&(f.data={});var c=f.data;if(c.id==null)c.id=gv();else if(e.hasElementWithId(c.id)||l.has(c.id))continue;var d=new In(e,f,!1);s.push(d),l.add(c.id)}t=s}this.length=0;for(var h=0,y=t.length;h<y;h++){var g=t[h][0];if(g!=null){var p=g._private.data.id;(!a||!i.has(p))&&(a&&i.set(p,{index:this.length,ele:g}),this[this.length]=g,this.length++)}}this._private={eles:this,cy:e,get map(){return this.lazyMap==null&&this.rebuildMap(),this.lazyMap},set map(m){this.lazyMap=m},rebuildMap:function(){for(var b=this.lazyMap=new Xr,w=this.eles,E=0;E<w.length;E++){var C=w[E];b.set(C.id(),{index:E,ele:C})}}},a&&(this._private.map=i),o&&!n&&this.restore()},He=In.prototype=fr.prototype=Object.create(Array.prototype);He.instanceString=function(){return"collection"};He.spawn=function(r,e){return new fr(this.cy(),r,e)};He.spawnSelf=function(){return this.spawn(this)};He.cy=function(){return this._private.cy};He.renderer=function(){return this._private.cy.renderer()};He.element=function(){return this[0]};He.collection=function(){return rv(this)?this:new fr(this._private.cy,[this])};He.unique=function(){return new fr(this._private.cy,this,!0)};He.hasElementWithId=function(r){return r=""+r,this._private.map.has(r)};He.getElementById=function(r){r=""+r;var e=this._private.cy,t=this._private.map.get(r);return t?t.ele:new fr(e)};He.$id=He.getElementById;He.poolIndex=function(){var r=this._private.cy,e=r._private.elements,t=this[0]._private.data.id;return e._private.map.get(t).index};He.indexOf=function(r){var e=r[0]._private.data.id;return this._private.map.get(e).index};He.indexOfId=function(r){return r=""+r,this._private.map.get(r).index};He.json=function(r){var e=this.element(),t=this.cy();if(e==null&&r)return this;if(e!=null){var a=e._private;if(Le(r)){if(t.startBatch(),r.data){e.data(r.data);var n=a.data;if(e.isEdge()){var i=!1,o={},s=r.data.source,l=r.data.target;s!=null&&s!=n.source&&(o.source=""+s,i=!0),l!=null&&l!=n.target&&(o.target=""+l,i=!0),i&&(e=e.move(o))}else{var u="parent"in r.data,v=r.data.parent;u&&(v!=null||n.parent!=null)&&v!=n.parent&&(v===void 0&&(v=null),v!=null&&(v=""+v),e=e.move({parent:v}))}}r.position&&e.position(r.position);var f=function(y,g,p){var m=r[y];m!=null&&m!==a[y]&&(m?e[g]():e[p]())};return f("removed","remove","restore"),f("selected","select","unselect"),f("selectable","selectify","unselectify"),f("locked","lock","unlock"),f("grabbable","grabify","ungrabify"),f("pannable","panify","unpanify"),r.classes!=null&&e.classes(r.classes),t.endBatch(),this}else if(r===void 0){var c={data:qr(a.data),position:qr(a.position),group:a.group,removed:a.removed,selected:a.selected,selectable:a.selectable,locked:a.locked,grabbable:a.grabbable,pannable:a.pannable,classes:null};c.classes="";var d=0;return a.classes.forEach(function(h){return c.classes+=d++===0?h:" "+h}),c}}};He.jsons=function(){for(var r=[],e=0;e<this.length;e++){var t=this[e],a=t.json();r.push(a)}return r};He.clone=function(){for(var r=this.cy(),e=[],t=0;t<this.length;t++){var a=this[t],n=a.json(),i=new In(r,n,!1);e.push(i)}return new fr(r,e)};He.copy=He.clone;He.restore=function(){for(var r=arguments.length>0&&arguments[0]!==void 0?arguments[0]:!0,e=arguments.length>1&&arguments[1]!==void 0?arguments[1]:!0,t=this,a=t.cy(),n=a._private,i=[],o=[],s,l=0,u=t.length;l<u;l++){var v=t[l];e&&!v.removed()||(v.isNode()?i.push(v):o.push(v))}s=i.concat(o);var f,c=function(){s.splice(f,1),f--};for(f=0;f<s.length;f++){var d=s[f],h=d._private,y=h.data;if(d.clearTraversalCache(),!(!e&&!h.removed)){if(y.id===void 0)y.id=gv();else if(ae(y.id))y.id=""+y.id;else if(ut(y.id)||!ge(y.id)){$e("Can not create element with invalid string ID `"+y.id+"`"),c();continue}else if(a.hasElementWithId(y.id)){$e("Can not create second element with ID `"+y.id+"`"),c();continue}}var g=y.id;if(d.isNode()){var p=h.position;p.x==null&&(p.x=0),p.y==null&&(p.y=0)}if(d.isEdge()){for(var m=d,b=["source","target"],w=b.length,E=!1,C=0;C<w;C++){var x=b[C],T=y[x];ae(T)&&(T=y[x]=""+y[x]),T==null||T===""?($e("Can not create edge `"+g+"` with unspecified "+x),E=!0):a.hasElementWithId(T)||($e("Can not create edge `"+g+"` with nonexistant "+x+" `"+T+"`"),E=!0)}if(E){c();continue}var k=a.getElementById(y.source),D=a.getElementById(y.target);k.same(D)?k._private.edges.push(m):(k._private.edges.push(m),D._private.edges.push(m)),m._private.source=k,m._private.target=D}h.map=new Xr,h.map.set(g,{ele:d,index:0}),h.removed=!1,e&&a.addToPool(d)}for(var B=0;B<i.length;B++){var P=i[B],A=P._private.data;ae(A.parent)&&(A.parent=""+A.parent);var R=A.parent,L=R!=null;if(L||P._private.parent){var I=P._private.parent?a.collection().merge(P._private.parent):a.getElementById(R);if(I.empty())A.parent=void 0;else if(I[0].removed())Ve("Node added with missing parent, reference to parent removed"),A.parent=void 0,P._private.parent=null;else{for(var M=!1,O=I;!O.empty();){if(P.same(O)){M=!0,A.parent=void 0;break}O=O.parent()}M||(I[0]._private.children.push(P),P._private.parent=I[0],n.hasCompoundNodes=!0)}}}if(s.length>0){for(var V=s.length===t.length?t:new fr(a,s),G=0;G<V.length;G++){var N=V[G];N.isNode()||(N.parallelEdges().clearTraversalCache(),N.source().clearTraversalCache(),N.target().clearTraversalCache())}var F;n.hasCompoundNodes?F=a.collection().merge(V).merge(V.connectedNodes()).merge(V.parent()):F=V,F.dirtyCompoundBoundsCache().dirtyBoundingBoxCache().updateStyle(r),r?V.emitAndNotify("add"):e&&V.emit("add")}return t};He.removed=function(){var r=this[0];return r&&r._private.removed};He.inside=function(){var r=this[0];return r&&!r._private.removed};He.remove=function(){var r=arguments.length>0&&arguments[0]!==void 0?arguments[0]:!0,e=arguments.length>1&&arguments[1]!==void 0?arguments[1]:!0,t=this,a=[],n={},i=t._private.cy;function o(R){for(var L=R._private.edges,I=0;I<L.length;I++)l(L[I])}function s(R){for(var L=R._private.children,I=0;I<L.length;I++)l(L[I])}function l(R){var L=n[R.id()];e&&R.removed()||L||(n[R.id()]=!0,R.isNode()?(a.push(R),o(R),s(R)):a.unshift(R))}for(var u=0,v=t.length;u<v;u++){var f=t[u];l(f)}function c(R,L){var I=R._private.edges;lt(I,L),R.clearTraversalCache()}function d(R){R.clearTraversalCache()}var h=[];h.ids={};function y(R,L){L=L[0],R=R[0];var I=R._private.children,M=R.id();lt(I,L),L._private.parent=null,h.ids[M]||(h.ids[M]=!0,h.push(R))}t.dirtyCompoundBoundsCache(),e&&i.removeFromPool(a);for(var g=0;g<a.length;g++){var p=a[g];if(p.isEdge()){var m=p.source()[0],b=p.target()[0];c(m,p),c(b,p);for(var w=p.parallelEdges(),E=0;E<w.length;E++){var C=w[E];d(C),C.isBundledBezier()&&C.dirtyBoundingBoxCache()}}else{var x=p.parent();x.length!==0&&y(x,p)}e&&(p._private.removed=!0)}var T=i._private.elements;i._private.hasCompoundNodes=!1;for(var k=0;k<T.length;k++){var D=T[k];if(D.isParent()){i._private.hasCompoundNodes=!0;break}}var B=new fr(this.cy(),a);B.size()>0&&(r?B.emitAndNotify("remove"):e&&B.emit("remove"));for(var P=0;P<h.length;P++){var A=h[P];(!e||!A.removed())&&A.updateStyle()}return B};He.move=function(r){var e=this._private.cy,t=this,a=!1,n=!1,i=function(h){return h==null?h:""+h};if(r.source!==void 0||r.target!==void 0){var o=i(r.source),s=i(r.target),l=o!=null&&e.hasElementWithId(o),u=s!=null&&e.hasElementWithId(s);(l||u)&&(e.batch(function(){t.remove(a,n),t.emitAndNotify("moveout");for(var d=0;d<t.length;d++){var h=t[d],y=h._private.data;h.isEdge()&&(l&&(y.source=o),u&&(y.target=s))}t.restore(a,n)}),t.emitAndNotify("move"))}else if(r.parent!==void 0){var v=i(r.parent),f=v===null||e.hasElementWithId(v);if(f){var c=v===null?void 0:v;e.batch(function(){var d=t.remove(a,n);d.emitAndNotify("moveout");for(var h=0;h<t.length;h++){var y=t[h],g=y._private.data;y.isNode()&&(g.parent=c)}d.restore(a,n)}),t.emitAndNotify("move")}}return this};[Dv,kg,vn,ot,jt,Gg,_n,np,Jv,jv,lp,Sn,fn,vr,st,gr].forEach(function(r){be(He,r)});var pp={add:function(e){var t,a=this;if(Dr(e)){var n=e;if(n._private.cy===a)t=n.restore();else{for(var i=[],o=0;o<n.length;o++){var s=n[o];i.push(s.json())}t=new fr(a,i)}}else if(_e(e)){var l=e;t=new fr(a,l)}else if(Le(e)&&(_e(e.nodes)||_e(e.edges))){for(var u=e,v=[],f=["nodes","edges"],c=0,d=f.length;c<d;c++){var h=f[c],y=u[h];if(_e(y))for(var g=0,p=y.length;g<p;g++){var m=be({group:h},y[g]);v.push(m)}}t=new fr(a,v)}else{var b=e;t=new In(a,b).collection()}return t},remove:function(e){if(!Dr(e)){if(ge(e)){var t=e;e=this.$(t)}}return e.remove()}};function yp(r,e,t,a){var n=4,i=.001,o=1e-7,s=10,l=11,u=1/(l-1),v=typeof Float32Array<"u";if(arguments.length!==4)return!1;for(var f=0;f<4;++f)if(typeof arguments[f]!="number"||isNaN(arguments[f])||!isFinite(arguments[f]))return!1;r=Math.min(r,1),t=Math.min(t,1),r=Math.max(r,0),t=Math.max(t,0);var c=v?new Float32Array(l):new Array(l);function d(D,B){return 1-3*B+3*D}function h(D,B){return 3*B-6*D}function y(D){return 3*D}function g(D,B,P){return((d(B,P)*D+h(B,P))*D+y(B))*D}function p(D,B,P){return 3*d(B,P)*D*D+2*h(B,P)*D+y(B)}function m(D,B){for(var P=0;P<n;++P){var A=p(B,r,t);if(A===0)return B;var R=g(B,r,t)-D;B-=R/A}return B}function b(){for(var D=0;D<l;++D)c[D]=g(D*u,r,t)}function w(D,B,P){var A,R,L=0;do R=B+(P-B)/2,A=g(R,r,t)-D,A>0?P=R:B=R;while(Math.abs(A)>o&&++L<s);return R}function E(D){for(var B=0,P=1,A=l-1;P!==A&&c[P]<=D;++P)B+=u;--P;var R=(D-c[P])/(c[P+1]-c[P]),L=B+R*u,I=p(L,r,t);return I>=i?m(D,L):I===0?L:w(D,B,B+u)}var C=!1;function x(){C=!0,(r!==e||t!==a)&&b()}var T=function(B){return C||x(),r===e&&t===a?B:B===0?0:B===1?1:g(E(B),e,a)};T.getControlPoints=function(){return[{x:r,y:e},{x:t,y:a}]};var k="generateBezier("+[r,e,t,a]+")";return T.toString=function(){return k},T}var mp=(function(){function r(a){return-a.tension*a.x-a.friction*a.v}function e(a,n,i){var o={x:a.x+i.dx*n,v:a.v+i.dv*n,tension:a.tension,friction:a.friction};return{dx:o.v,dv:r(o)}}function t(a,n){var i={dx:a.v,dv:r(a)},o=e(a,n*.5,i),s=e(a,n*.5,o),l=e(a,n,s),u=1/6*(i.dx+2*(o.dx+s.dx)+l.dx),v=1/6*(i.dv+2*(o.dv+s.dv)+l.dv);return a.x=a.x+u*n,a.v=a.v+v*n,a}return function a(n,i,o){var s={x:-1,v:0,tension:null,friction:null},l=[0],u=0,v=1/1e4,f=16/1e3,c,d,h;for(n=parseFloat(n)||500,i=parseFloat(i)||20,o=o||null,s.tension=n,s.friction=i,c=o!==null,c?(u=a(n,i),d=u/o*f):d=f;h=t(h||s,d),l.push(1+h.x),u+=16,Math.abs(h.x)>v&&Math.abs(h.v)>v;);return c?function(y){return l[y*(l.length-1)|0]}:u}})(),Ge=function(e,t,a,n){var i=yp(e,t,a,n);return function(o,s,l){return o+(s-o)*i(l)}},cn={linear:function(e,t,a){return e+(t-e)*a},ease:Ge(.25,.1,.25,1),"ease-in":Ge(.42,0,1,1),"ease-out":Ge(0,0,.58,1),"ease-in-out":Ge(.42,0,.58,1),"ease-in-sine":Ge(.47,0,.745,.715),"ease-out-sine":Ge(.39,.575,.565,1),"ease-in-out-sine":Ge(.445,.05,.55,.95),"ease-in-quad":Ge(.55,.085,.68,.53),"ease-out-quad":Ge(.25,.46,.45,.94),"ease-in-out-quad":Ge(.455,.03,.515,.955),"ease-in-cubic":Ge(.55,.055,.675,.19),"ease-out-cubic":Ge(.215,.61,.355,1),"ease-in-out-cubic":Ge(.645,.045,.355,1),"ease-in-quart":Ge(.895,.03,.685,.22),"ease-out-quart":Ge(.165,.84,.44,1),"ease-in-out-quart":Ge(.77,0,.175,1),"ease-in-quint":Ge(.755,.05,.855,.06),"ease-out-quint":Ge(.23,1,.32,1),"ease-in-out-quint":Ge(.86,0,.07,1),"ease-in-expo":Ge(.95,.05,.795,.035),"ease-out-expo":Ge(.19,1,.22,1),"ease-in-out-expo":Ge(1,0,0,1),"ease-in-circ":Ge(.6,.04,.98,.335),"ease-out-circ":Ge(.075,.82,.165,1),"ease-in-out-circ":Ge(.785,.135,.15,.86),spring:function(e,t,a){if(a===0)return cn.linear;var n=mp(e,t,a);return function(i,o,s){return i+(o-i)*n(s)}},"cubic-bezier":Ge};function xl(r,e,t,a,n){if(a===1||e===t)return t;var i=n(e,t,a);return r==null||((r.roundValue||r.color)&&(i=Math.round(i)),r.min!==void 0&&(i=Math.max(i,r.min)),r.max!==void 0&&(i=Math.min(i,r.max))),i}function El(r,e){return r.pfValue!=null||r.value!=null?r.pfValue!=null&&(e==null||e.type.units!=="%")?r.pfValue:r.value:r}function zt(r,e,t,a,n){var i=n!=null?n.type:null;t<0?t=0:t>1&&(t=1);var o=El(r,n),s=El(e,n);if(ae(o)&&ae(s))return xl(i,o,s,t,a);if(_e(o)&&_e(s)){for(var l=[],u=0;u<s.length;u++){var v=o[u],f=s[u];if(v!=null&&f!=null){var c=xl(i,v,f,t,a);l.push(c)}else l.push(f)}return l}}function bp(r,e,t,a){var n=!a,i=r._private,o=e._private,s=o.easing,l=o.startTime,u=a?r:r.cy(),v=u.style();if(!o.easingImpl)if(s==null)o.easingImpl=cn.linear;else{var f;if(ge(s)){var c=v.parse("transition-timing-function",s);f=c.value}else f=s;var d,h;ge(f)?(d=f,h=[]):(d=f[1],h=f.slice(2).map(function(V){return+V})),h.length>0?(d==="spring"&&h.push(o.duration),o.easingImpl=cn[d].apply(null,h)):o.easingImpl=cn[d]}var y=o.easingImpl,g;if(o.duration===0?g=1:g=(t-l)/o.duration,o.applying&&(g=o.progress),g<0?g=0:g>1&&(g=1),o.delay==null){var p=o.startPosition,m=o.position;if(m&&n&&!r.locked()){var b={};ha(p.x,m.x)&&(b.x=zt(p.x,m.x,g,y)),ha(p.y,m.y)&&(b.y=zt(p.y,m.y,g,y)),r.position(b)}var w=o.startPan,E=o.pan,C=i.pan,x=E!=null&&a;x&&(ha(w.x,E.x)&&(C.x=zt(w.x,E.x,g,y)),ha(w.y,E.y)&&(C.y=zt(w.y,E.y,g,y)),r.emit("pan"));var T=o.startZoom,k=o.zoom,D=k!=null&&a;D&&(ha(T,k)&&(i.zoom=ka(i.minZoom,zt(T,k,g,y),i.maxZoom)),r.emit("zoom")),(x||D)&&r.emit("viewport");var B=o.style;if(B&&B.length>0&&n){for(var P=0;P<B.length;P++){var A=B[P],R=A.name,L=A,I=o.startStyle[R],M=v.properties[I.name],O=zt(I,L,g,y,M);v.overrideBypass(r,R,O)}r.emit("style")}}return o.progress=g,g}function ha(r,e){return r==null||e==null?!1:ae(r)&&ae(e)?!0:!!(r&&e)}function wp(r,e,t,a){var n=e._private;n.started=!0,n.startTime=t-n.progress*n.duration}function Cl(r,e){var t=e._private.aniEles,a=[];function n(v,f){var c=v._private,d=c.animation.current,h=c.animation.queue,y=!1;if(d.length===0){var g=h.shift();g&&d.push(g)}for(var p=function(C){for(var x=C.length-1;x>=0;x--){var T=C[x];T()}C.splice(0,C.length)},m=d.length-1;m>=0;m--){var b=d[m],w=b._private;if(w.stopped){d.splice(m,1),w.hooked=!1,w.playing=!1,w.started=!1,p(w.frames);continue}!w.playing&&!w.applying||(w.playing&&w.applying&&(w.applying=!1),w.started||wp(v,b,r),bp(v,b,r,f),w.applying&&(w.applying=!1),p(w.frames),w.step!=null&&w.step(r),b.completed()&&(d.splice(m,1),w.hooked=!1,w.playing=!1,w.started=!1,p(w.completes)),y=!0)}return!f&&d.length===0&&h.length===0&&a.push(v),y}for(var i=!1,o=0;o<t.length;o++){var s=t[o],l=n(s);i=i||l}var u=n(e,!0);(i||u)&&(t.length>0?e.notify("draw",t):e.notify("draw")),t.unmerge(a),e.emit("step")}var xp={animate:Fe.animate(),animation:Fe.animation(),animated:Fe.animated(),clearQueue:Fe.clearQueue(),delay:Fe.delay(),delayAnimation:Fe.delayAnimation(),stop:Fe.stop(),addToAnimationPool:function(e){var t=this;t.styleEnabled()&&t._private.aniEles.merge(e)},stopAnimationLoop:function(){this._private.animationsRunning=!1},startAnimationLoop:function(){var e=this;if(e._private.animationsRunning=!0,!e.styleEnabled())return;function t(){e._private.animationsRunning&&wn(function(i){Cl(i,e),t()})}var a=e.renderer();a&&a.beforeRender?a.beforeRender(function(i,o){Cl(o,e)},a.beforeRenderPriorities.animations):t()}},Ep={qualifierCompare:function(e,t){return e==null||t==null?e==null&&t==null:e.sameText(t)},eventMatches:function(e,t,a){var n=t.qualifier;return n!=null?e!==a.target&&Ia(a.target)&&n.matches(a.target):!0},addEventFields:function(e,t){t.cy=e,t.target=e},callbackContext:function(e,t,a){return t.qualifier!=null?a.target:e}},tn=function(e){return ge(e)?new ft(e):e},tf={createEmitter:function(){var e=this._private;return e.emitter||(e.emitter=new Gn(Ep,this)),this},emitter:function(){return this._private.emitter},on:function(e,t,a){return this.emitter().on(e,tn(t),a),this},removeListener:function(e,t,a){return this.emitter().removeListener(e,tn(t),a),this},removeAllListeners:function(){return this.emitter().removeAllListeners(),this},one:function(e,t,a){return this.emitter().one(e,tn(t),a),this},once:function(e,t,a){return this.emitter().one(e,tn(t),a),this},emit:function(e,t){return this.emitter().emit(e,t),this},emitAndNotify:function(e,t){return this.emit(e),this.notify(e,t),this}};Fe.eventAliasesOn(tf);var Fo={png:function(e){var t=this._private.renderer;return e=e||{},t.png(e)},jpg:function(e){var t=this._private.renderer;return e=e||{},e.bg=e.bg||"#fff",t.jpg(e)}};Fo.jpeg=Fo.jpg;var hn={layout:function(e){var t=this;if(e==null){$e("Layout options must be specified to make a layout");return}if(e.name==null){$e("A `name` must be specified to make a layout");return}var a=e.name,n=t.extension("layout",a);if(n==null){$e("No such layout `"+a+"` found.  Did you forget to import it and `cytoscape.use()` it?");return}var i;ge(e.eles)?i=t.$(e.eles):i=e.eles!=null?e.eles:t.$();var o=new n(be({},e,{cy:t,eles:i}));return o}};hn.createLayout=hn.makeLayout=hn.layout;var Cp={notify:function(e,t){var a=this._private;if(this.batching()){a.batchNotifications=a.batchNotifications||{};var n=a.batchNotifications[e]=a.batchNotifications[e]||this.collection();t!=null&&n.merge(t);return}if(a.notificationsEnabled){var i=this.renderer();this.destroyed()||!i||i.notify(e,t)}},notifications:function(e){var t=this._private;return e===void 0?t.notificationsEnabled:(t.notificationsEnabled=!!e,this)},noNotifications:function(e){this.notifications(!1),e(),this.notifications(!0)},batching:function(){return this._private.batchCount>0},startBatch:function(){var e=this._private;return e.batchCount==null&&(e.batchCount=0),e.batchCount===0&&(e.batchStyleEles=this.collection(),e.batchNotifications={}),e.batchCount++,this},endBatch:function(){var e=this._private;if(e.batchCount===0)return this;if(e.batchCount--,e.batchCount===0){e.batchStyleEles.updateStyle();var t=this.renderer();Object.keys(e.batchNotifications).forEach(function(a){var n=e.batchNotifications[a];n.empty()?t.notify(a):t.notify(a,n)})}return this},batch:function(e){return this.startBatch(),e(),this.endBatch(),this},batchData:function(e){var t=this;return this.batch(function(){for(var a=Object.keys(e),n=0;n<a.length;n++){var i=a[n],o=e[i],s=t.getElementById(i);s.data(o)}})}},Tp=cr({hideEdgesOnViewport:!1,textureOnViewport:!1,motionBlur:!1,motionBlurOpacity:.05,pixelRatio:void 0,desktopTapThreshold:4,touchTapThreshold:8,wheelSensitivity:1,debug:!1,showFps:!1,webgl:!1,webglDebug:!1,webglDebugShowAtlases:!1,webglTexSize:2048,webglTexRows:36,webglTexRowsNodes:18,webglBatchSize:2048,webglTexPerBatch:14,webglBgColor:[255,255,255]}),Vo={renderTo:function(e,t,a,n){var i=this._private.renderer;return i.renderTo(e,t,a,n),this},renderer:function(){return this._private.renderer},forceRender:function(){return this.notify("draw"),this},resize:function(){return this.invalidateSize(),this.emitAndNotify("resize"),this},initRenderer:function(e){var t=this,a=t.extension("renderer",e.name);if(a==null){$e("Can not initialise: No such renderer `".concat(e.name,"` found. Did you forget to import it and `cytoscape.use()` it?"));return}e.wheelSensitivity!==void 0&&Ve("You have set a custom wheel sensitivity.  This will make your app zoom unnaturally when using mainstream mice.  You should change this value from the default only if you can guarantee that all your users will use the same hardware and OS configuration as your current machine.");var n=Tp(e);n.cy=t,t._private.renderer=new a(n),this.notify("init")},destroyRenderer:function(){var e=this;e.notify("destroy");var t=e.container();if(t)for(t._cyreg=null;t.childNodes.length>0;)t.removeChild(t.childNodes[0]);e._private.renderer=null,e.mutableElements().forEach(function(a){var n=a._private;n.rscratch={},n.rstyle={},n.animation.current=[],n.animation.queue=[]})},onRender:function(e){return this.on("render",e)},offRender:function(e){return this.off("render",e)}};Vo.invalidateDimensions=Vo.resize;var dn={collection:function(e,t){return ge(e)?this.$(e):Dr(e)?e.collection():_e(e)?(t||(t={}),new fr(this,e,t.unique,t.removed)):new fr(this)},nodes:function(e){var t=this.$(function(a){return a.isNode()});return e?t.filter(e):t},edges:function(e){var t=this.$(function(a){return a.isEdge()});return e?t.filter(e):t},$:function(e){var t=this._private.elements;return e?t.filter(e):t.spawnSelf()},mutableElements:function(){return this._private.elements}};dn.elements=dn.filter=dn.$;var ur={},wa="t",Sp="f";ur.apply=function(r){for(var e=this,t=e._private,a=t.cy,n=a.collection(),i=0;i<r.length;i++){var o=r[i],s=e.getContextMeta(o);if(!s.empty){var l=e.getContextStyle(s),u=e.applyContextStyle(s,l,o);o._private.appliedInitStyle?e.updateTransitions(o,u.diffProps):o._private.appliedInitStyle=!0;var v=e.updateStyleHints(o);v&&n.push(o)}}return n};ur.getPropertiesDiff=function(r,e){var t=this,a=t._private.propDiffs=t._private.propDiffs||{},n=r+"-"+e,i=a[n];if(i)return i;for(var o=[],s={},l=0;l<t.length;l++){var u=t[l],v=r[l]===wa,f=e[l]===wa,c=v!==f,d=u.mappedProperties.length>0;if(c||f&&d){var h=void 0;c&&d||c?h=u.properties:d&&(h=u.mappedProperties);for(var y=0;y<h.length;y++){for(var g=h[y],p=g.name,m=!1,b=l+1;b<t.length;b++){var w=t[b],E=e[b]===wa;if(E&&(m=w.properties[g.name]!=null,m))break}!s[p]&&!m&&(s[p]=!0,o.push(p))}}}return a[n]=o,o};ur.getContextMeta=function(r){for(var e=this,t="",a,n=r._private.styleCxtKey||"",i=0;i<e.length;i++){var o=e[i],s=o.selector&&o.selector.matches(r);s?t+=wa:t+=Sp}return a=e.getPropertiesDiff(n,t),r._private.styleCxtKey=t,{key:t,diffPropNames:a,empty:a.length===0}};ur.getContextStyle=function(r){var e=r.key,t=this,a=this._private.contextStyles=this._private.contextStyles||{};if(a[e])return a[e];for(var n={_private:{key:e}},i=0;i<t.length;i++){var o=t[i],s=e[i]===wa;if(s)for(var l=0;l<o.properties.length;l++){var u=o.properties[l];n[u.name]=u}}return a[e]=n,n};ur.applyContextStyle=function(r,e,t){for(var a=this,n=r.diffPropNames,i={},o=a.types,s=0;s<n.length;s++){var l=n[s],u=e[l],v=t.pstyle(l);if(!u)if(v)v.bypass?u={name:l,deleteBypassed:!0}:u={name:l,delete:!0};else continue;if(v!==u){if(u.mapped===o.fn&&v!=null&&v.mapping!=null&&v.mapping.value===u.value){var f=v.mapping,c=f.fnValue=u.value(t);if(c===f.prevFnValue)continue}var d=i[l]={prev:v};a.applyParsedProperty(t,u),d.next=t.pstyle(l),d.next&&d.next.bypass&&(d.next=d.next.bypassed)}}return{diffProps:i}};ur.updateStyleHints=function(r){var e=r._private,t=this,a=t.propertyGroupNames,n=t.propertyGroupKeys,i=function(H,Y,te){return t.getPropertiesHash(H,Y,te)},o=e.styleKey;if(r.removed())return!1;var s=e.group==="nodes",l=r._private.style;a=Object.keys(l);for(var u=0;u<n.length;u++){var v=n[u];e.styleKeys[v]=[Tt,Ht]}for(var f=function(H,Y){return e.styleKeys[Y][0]=Ca(H,e.styleKeys[Y][0])},c=function(H,Y){return e.styleKeys[Y][1]=Ta(H,e.styleKeys[Y][1])},d=function(H,Y){f(H,Y),c(H,Y)},h=function(H,Y){for(var te=0;te<H.length;te++){var ce=H.charCodeAt(te);f(ce,Y),c(ce,Y)}},y=2e9,g=function(H){return-128<H&&H<128&&Math.floor(H)!==H?y-(H*1024|0):H},p=0;p<a.length;p++){var m=a[p],b=l[m];if(b!=null){var w=this.properties[m],E=w.type,C=w.groupKey,x=void 0;w.hashOverride!=null?x=w.hashOverride(r,b):b.pfValue!=null&&(x=b.pfValue);var T=w.enums==null?b.value:null,k=x!=null,D=T!=null,B=k||D,P=b.units;if(E.number&&B&&!E.multiple){var A=k?x:T;d(g(A),C),!k&&P!=null&&h(P,C)}else h(b.strValue,C)}}for(var R=[Tt,Ht],L=0;L<n.length;L++){var I=n[L],M=e.styleKeys[I];R[0]=Ca(M[0],R[0]),R[1]=Ta(M[1],R[1])}e.styleKey=_c(R[0],R[1]);var O=e.styleKeys;e.labelDimsKey=et(O.labelDimensions);var V=i(r,["label"],O.labelDimensions);if(e.labelKey=et(V),e.labelStyleKey=et(Xa(O.commonLabel,V)),!s){var G=i(r,["source-label"],O.labelDimensions);e.sourceLabelKey=et(G),e.sourceLabelStyleKey=et(Xa(O.commonLabel,G));var N=i(r,["target-label"],O.labelDimensions);e.targetLabelKey=et(N),e.targetLabelStyleKey=et(Xa(O.commonLabel,N))}if(s){var F=e.styleKeys,U=F.nodeBody,Q=F.nodeBorder,K=F.nodeOutline,j=F.backgroundImage,re=F.compound,ne=F.pie,J=F.stripe,z=[U,Q,K,j,re,ne,J].filter(function(q){return q!=null}).reduce(Xa,[Tt,Ht]);e.nodeKey=et(z),e.hasPie=ne!=null&&ne[0]!==Tt&&ne[1]!==Ht,e.hasStripe=J!=null&&J[0]!==Tt&&J[1]!==Ht}return o!==e.styleKey};ur.clearStyleHints=function(r){var e=r._private;e.styleCxtKey="",e.styleKeys={},e.styleKey=null,e.labelKey=null,e.labelStyleKey=null,e.sourceLabelKey=null,e.sourceLabelStyleKey=null,e.targetLabelKey=null,e.targetLabelStyleKey=null,e.nodeKey=null,e.hasPie=null,e.hasStripe=null};ur.applyParsedProperty=function(r,e){var t=this,a=e,n=r._private.style,i,o=t.types,s=t.properties[a.name].type,l=a.bypass,u=n[a.name],v=u&&u.bypass,f=r._private,c="mapping",d=function(U){return U==null?null:U.pfValue!=null?U.pfValue:U.value},h=function(){var U=d(u),Q=d(a);t.checkTriggers(r,a.name,U,Q)};if(e.name==="curve-style"&&r.isEdge()&&(e.value!=="bezier"&&r.isLoop()||e.value==="haystack"&&(r.source().isParent()||r.target().isParent()))&&(a=e=this.parse(e.name,"bezier",l)),a.delete)return n[a.name]=void 0,h(),!0;if(a.deleteBypassed)return u?u.bypass?(u.bypassed=void 0,h(),!0):!1:(h(),!0);if(a.deleteBypass)return u?u.bypass?(n[a.name]=u.bypassed,h(),!0):!1:(h(),!0);var y=function(){Ve("Do not assign mappings to elements without corresponding data (i.e. ele `"+r.id()+"` has no mapping for property `"+a.name+"` with data field `"+a.field+"`); try a `["+a.field+"]` selector to limit scope to elements with `"+a.field+"` defined")};switch(a.mapped){case o.mapData:{for(var g=a.field.split("."),p=f.data,m=0;m<g.length&&p;m++){var b=g[m];p=p[b]}if(p==null)return y(),!1;var w;if(ae(p)){var E=a.fieldMax-a.fieldMin;E===0?w=0:w=(p-a.fieldMin)/E}else return Ve("Do not use continuous mappers without specifying numeric data (i.e. `"+a.field+": "+p+"` for `"+r.id()+"` is non-numeric)"),!1;if(w<0?w=0:w>1&&(w=1),s.color){var C=a.valueMin[0],x=a.valueMax[0],T=a.valueMin[1],k=a.valueMax[1],D=a.valueMin[2],B=a.valueMax[2],P=a.valueMin[3]==null?1:a.valueMin[3],A=a.valueMax[3]==null?1:a.valueMax[3],R=[Math.round(C+(x-C)*w),Math.round(T+(k-T)*w),Math.round(D+(B-D)*w),Math.round(P+(A-P)*w)];i={bypass:a.bypass,name:a.name,value:R,strValue:"rgb("+R[0]+", "+R[1]+", "+R[2]+")"}}else if(s.number){var L=a.valueMin+(a.valueMax-a.valueMin)*w;i=this.parse(a.name,L,a.bypass,c)}else return!1;if(!i)return y(),!1;i.mapping=a,a=i;break}case o.data:{for(var I=a.field.split("."),M=f.data,O=0;O<I.length&&M;O++){var V=I[O];M=M[V]}if(M!=null&&(i=this.parse(a.name,M,a.bypass,c)),!i)return y(),!1;i.mapping=a,a=i;break}case o.fn:{var G=a.value,N=a.fnValue!=null?a.fnValue:G(r);if(a.prevFnValue=N,N==null)return Ve("Custom function mappers may not return null (i.e. `"+a.name+"` for ele `"+r.id()+"` is null)"),!1;if(i=this.parse(a.name,N,a.bypass,c),!i)return Ve("Custom function mappers may not return invalid values for the property type (i.e. `"+a.name+"` for ele `"+r.id()+"` is invalid)"),!1;i.mapping=qr(a),a=i;break}case void 0:break;default:return!1}return l?(v?a.bypassed=u.bypassed:a.bypassed=u,n[a.name]=a):v?u.bypassed=a:n[a.name]=a,h(),!0};ur.cleanElements=function(r,e){for(var t=0;t<r.length;t++){var a=r[t];if(this.clearStyleHints(a),a.dirtyCompoundBoundsCache(),a.dirtyBoundingBoxCache(),!e)a._private.style={};else for(var n=a._private.style,i=Object.keys(n),o=0;o<i.length;o++){var s=i[o],l=n[s];l!=null&&(l.bypass?l.bypassed=null:n[s]=null)}}};ur.update=function(){var r=this._private.cy,e=r.mutableElements();e.updateStyle()};ur.updateTransitions=function(r,e){var t=this,a=r._private,n=r.pstyle("transition-property").value,i=r.pstyle("transition-duration").pfValue,o=r.pstyle("transition-delay").pfValue;if(n.length>0&&i>0){for(var s={},l=!1,u=0;u<n.length;u++){var v=n[u],f=r.pstyle(v),c=e[v];if(c){var d=c.prev,h=d,y=c.next!=null?c.next:f,g=!1,p=void 0,m=1e-6;h&&(ae(h.pfValue)&&ae(y.pfValue)?(g=y.pfValue-h.pfValue,p=h.pfValue+m*g):ae(h.value)&&ae(y.value)?(g=y.value-h.value,p=h.value+m*g):_e(h.value)&&_e(y.value)&&(g=h.value[0]!==y.value[0]||h.value[1]!==y.value[1]||h.value[2]!==y.value[2],p=h.strValue),g&&(s[v]=y.strValue,this.applyBypass(r,v,p),l=!0))}}if(!l)return;a.transitioning=!0,new ta(function(b){o>0?r.delayAnimation(o).play().promise().then(b):b()}).then(function(){return r.animation({style:s,duration:i,easing:r.pstyle("transition-timing-function").value,queue:!1}).play().promise()}).then(function(){t.removeBypasses(r,n),r.emitAndNotify("style"),a.transitioning=!1})}else a.transitioning&&(this.removeBypasses(r,n),r.emitAndNotify("style"),a.transitioning=!1)};ur.checkTrigger=function(r,e,t,a,n,i){var o=this.properties[e],s=n(o);r.removed()||s!=null&&s(t,a,r)&&i(o)};ur.checkZOrderTrigger=function(r,e,t,a){var n=this;this.checkTrigger(r,e,t,a,function(i){return i.triggersZOrder},function(){n._private.cy.notify("zorder",r)})};ur.checkBoundsTrigger=function(r,e,t,a){this.checkTrigger(r,e,t,a,function(n){return n.triggersBounds},function(n){r.dirtyCompoundBoundsCache(),r.dirtyBoundingBoxCache()})};ur.checkConnectedEdgesBoundsTrigger=function(r,e,t,a){this.checkTrigger(r,e,t,a,function(n){return n.triggersBoundsOfConnectedEdges},function(n){r.connectedEdges().forEach(function(i){i.dirtyBoundingBoxCache()})})};ur.checkParallelEdgesBoundsTrigger=function(r,e,t,a){this.checkTrigger(r,e,t,a,function(n){return n.triggersBoundsOfParallelEdges},function(n){r.parallelEdges().forEach(function(i){i.dirtyBoundingBoxCache()})})};ur.checkTriggers=function(r,e,t,a){r.dirtyStyleCache(),this.checkZOrderTrigger(r,e,t,a),this.checkBoundsTrigger(r,e,t,a),this.checkConnectedEdgesBoundsTrigger(r,e,t,a),this.checkParallelEdgesBoundsTrigger(r,e,t,a)};var _a={};_a.applyBypass=function(r,e,t,a){var n=this,i=[],o=!0;if(e==="*"||e==="**"){if(t!==void 0)for(var s=0;s<n.properties.length;s++){var l=n.properties[s],u=l.name,v=this.parse(u,t,!0);v&&i.push(v)}}else if(ge(e)){var f=this.parse(e,t,!0);f&&i.push(f)}else if(Le(e)){var c=e;a=t;for(var d=Object.keys(c),h=0;h<d.length;h++){var y=d[h],g=c[y];if(g===void 0&&(g=c[Mn(y)]),g!==void 0){var p=this.parse(y,g,!0);p&&i.push(p)}}}else return!1;if(i.length===0)return!1;for(var m=!1,b=0;b<r.length;b++){for(var w=r[b],E={},C=void 0,x=0;x<i.length;x++){var T=i[x];if(a){var k=w.pstyle(T.name);C=E[T.name]={prev:k}}m=this.applyParsedProperty(w,qr(T))||m,a&&(C.next=w.pstyle(T.name))}m&&this.updateStyleHints(w),a&&this.updateTransitions(w,E,o)}return m};_a.overrideBypass=function(r,e,t){e=Qo(e);for(var a=0;a<r.length;a++){var n=r[a],i=n._private.style[e],o=this.properties[e].type,s=o.color,l=o.mutiple,u=i?i.pfValue!=null?i.pfValue:i.value:null;!i||!i.bypass?this.applyBypass(n,e,t):(i.value=t,i.pfValue!=null&&(i.pfValue=t),s?i.strValue="rgb("+t.join(",")+")":l?i.strValue=t.join(" "):i.strValue=""+t,this.updateStyleHints(n)),this.checkTriggers(n,e,u,t)}};_a.removeAllBypasses=function(r,e){return this.removeBypasses(r,this.propertyNames,e)};_a.removeBypasses=function(r,e,t){for(var a=!0,n=0;n<r.length;n++){for(var i=r[n],o={},s=0;s<e.length;s++){var l=e[s],u=this.properties[l],v=i.pstyle(u.name);if(!(!v||!v.bypass)){var f="",c=this.parse(l,f,!0),d=o[u.name]={prev:v};this.applyParsedProperty(i,c),d.next=i.pstyle(u.name)}}this.updateStyleHints(i),t&&this.updateTransitions(i,o,a)}};var cs={};cs.getEmSizeInPixels=function(){var r=this.containerCss("font-size");return r!=null?parseFloat(r):1};cs.containerCss=function(r){var e=this._private.cy,t=e.container(),a=e.window();if(a&&t&&a.getComputedStyle)return a.getComputedStyle(t).getPropertyValue(r)};var _r={};_r.getRenderedStyle=function(r,e){return e?this.getStylePropertyValue(r,e,!0):this.getRawStyle(r,!0)};_r.getRawStyle=function(r,e){var t=this;if(r=r[0],r){for(var a={},n=0;n<t.properties.length;n++){var i=t.properties[n],o=t.getStylePropertyValue(r,i.name,e);o!=null&&(a[i.name]=o,a[Mn(i.name)]=o)}return a}};_r.getIndexedStyle=function(r,e,t,a){var n=r.pstyle(e)[t][a];return n??r.cy().style().getDefaultProperty(e)[t][0]};_r.getStylePropertyValue=function(r,e,t){var a=this;if(r=r[0],r){var n=a.properties[e];n.alias&&(n=n.pointsTo);var i=n.type,o=r.pstyle(n.name);if(o){var s=o.value,l=o.units,u=o.strValue;if(t&&i.number&&s!=null&&ae(s)){var v=r.cy().zoom(),f=function(g){return g*v},c=function(g,p){return f(g)+p},d=_e(s),h=d?l.every(function(y){return y!=null}):l!=null;return h?d?s.map(function(y,g){return c(y,l[g])}).join(" "):c(s,l):d?s.map(function(y){return ge(y)?y:""+f(y)}).join(" "):""+f(s)}else if(u!=null)return u}return null}};_r.getAnimationStartStyle=function(r,e){for(var t={},a=0;a<e.length;a++){var n=e[a],i=n.name,o=r.pstyle(i);o!==void 0&&(Le(o)?o=this.parse(i,o.strValue):o=this.parse(i,o)),o&&(t[i]=o)}return t};_r.getPropsList=function(r){var e=this,t=[],a=r,n=e.properties;if(a)for(var i=Object.keys(a),o=0;o<i.length;o++){var s=i[o],l=a[s],u=n[s]||n[Qo(s)],v=this.parse(u.name,l);v&&t.push(v)}return t};_r.getNonDefaultPropertiesHash=function(r,e,t){var a=t.slice(),n,i,o,s,l,u;for(l=0;l<e.length;l++)if(n=e[l],i=r.pstyle(n,!1),i!=null)if(i.pfValue!=null)a[0]=Ca(s,a[0]),a[1]=Ta(s,a[1]);else for(o=i.strValue,u=0;u<o.length;u++)s=o.charCodeAt(u),a[0]=Ca(s,a[0]),a[1]=Ta(s,a[1]);return a};_r.getPropertiesHash=_r.getNonDefaultPropertiesHash;var $n={};$n.appendFromJson=function(r){for(var e=this,t=0;t<r.length;t++){var a=r[t],n=a.selector,i=a.style||a.css,o=Object.keys(i);e.selector(n);for(var s=0;s<o.length;s++){var l=o[s],u=i[l];e.css(l,u)}}return e};$n.fromJson=function(r){var e=this;return e.resetToDefault(),e.appendFromJson(r),e};$n.json=function(){for(var r=[],e=this.defaultLength;e<this.length;e++){for(var t=this[e],a=t.selector,n=t.properties,i={},o=0;o<n.length;o++){var s=n[o];i[s.name]=s.strValue}r.push({selector:a?a.toString():"core",style:i})}return r};var hs={};hs.appendFromString=function(r){var e=this,t=this,a=""+r,n,i,o;a=a.replace(/[/][*](\s|.)+?[*][/]/g,"");function s(){a.length>n.length?a=a.substr(n.length):a=""}function l(){i.length>o.length?i=i.substr(o.length):i=""}for(;;){var u=a.match(/^\s*$/);if(u)break;var v=a.match(/^\s*((?:.|\s)+?)\s*\{((?:.|\s)+?)\}/);if(!v){Ve("Halting stylesheet parsing: String stylesheet contains more to parse but no selector and block found in: "+a);break}n=v[0];var f=v[1];if(f!=="core"){var c=new ft(f);if(c.invalid){Ve("Skipping parsing of block: Invalid selector found in string stylesheet: "+f),s();continue}}var d=v[2],h=!1;i=d;for(var y=[];;){var g=i.match(/^\s*$/);if(g)break;var p=i.match(/^\s*(.+?)\s*:\s*(.+?)(?:\s*;|\s*$)/);if(!p){Ve("Skipping parsing of block: Invalid formatting of style property and value definitions found in:"+d),h=!0;break}o=p[0];var m=p[1],b=p[2],w=e.properties[m];if(!w){Ve("Skipping property: Invalid property name in: "+o),l();continue}var E=t.parse(m,b);if(!E){Ve("Skipping property: Invalid property definition in: "+o),l();continue}y.push({name:m,val:b}),l()}if(h){s();break}t.selector(f);for(var C=0;C<y.length;C++){var x=y[C];t.css(x.name,x.val)}s()}return t};hs.fromString=function(r){var e=this;return e.resetToDefault(),e.appendFromString(r),e};var Qe={};(function(){var r=tr,e=bc,t=xc,a=Ec,n=Cc,i=function(q){return"^"+q+"\\s*\\(\\s*([\\w\\.]+)\\s*\\)$"},o=function(q){var H=r+"|\\w+|"+e+"|"+t+"|"+a+"|"+n;return"^"+q+"\\s*\\(([\\w\\.]+)\\s*\\,\\s*("+r+")\\s*\\,\\s*("+r+")\\s*,\\s*("+H+")\\s*\\,\\s*("+H+")\\)$"},s=[`^url\\s*\\(\\s*['"]?(.+?)['"]?\\s*\\)$`,"^(none)$","^(.+)$"];Qe.types={time:{number:!0,min:0,units:"s|ms",implicitUnits:"ms"},percent:{number:!0,min:0,max:100,units:"%",implicitUnits:"%"},percentages:{number:!0,min:0,max:100,units:"%",implicitUnits:"%",multiple:!0},zeroOneNumber:{number:!0,min:0,max:1,unitless:!0},zeroOneNumbers:{number:!0,min:0,max:1,unitless:!0,multiple:!0},nOneOneNumber:{number:!0,min:-1,max:1,unitless:!0},nonNegativeInt:{number:!0,min:0,integer:!0,unitless:!0},nonNegativeNumber:{number:!0,min:0,unitless:!0},position:{enums:["parent","origin"]},nodeSize:{number:!0,min:0,enums:["label"]},number:{number:!0,unitless:!0},numbers:{number:!0,unitless:!0,multiple:!0},positiveNumber:{number:!0,unitless:!0,min:0,strictMin:!0},size:{number:!0,min:0},bidirectionalSize:{number:!0},bidirectionalSizeMaybePercent:{number:!0,allowPercent:!0},bidirectionalSizes:{number:!0,multiple:!0},sizeMaybePercent:{number:!0,min:0,allowPercent:!0},axisDirection:{enums:["horizontal","leftward","rightward","vertical","upward","downward","auto"]},axisDirectionExplicit:{enums:["leftward","rightward","upward","downward"]},axisDirectionPrimary:{enums:["horizontal","vertical"]},paddingRelativeTo:{enums:["width","height","average","min","max"]},bgWH:{number:!0,min:0,allowPercent:!0,enums:["auto"],multiple:!0},bgPos:{number:!0,allowPercent:!0,multiple:!0},bgRelativeTo:{enums:["inner","include-padding"],multiple:!0},bgRepeat:{enums:["repeat","repeat-x","repeat-y","no-repeat"],multiple:!0},bgFit:{enums:["none","contain","cover"],multiple:!0},bgCrossOrigin:{enums:["anonymous","use-credentials","null"],multiple:!0},bgClip:{enums:["none","node"],multiple:!0},bgContainment:{enums:["inside","over"],multiple:!0},boxSelection:{enums:["contain","overlap","none"]},color:{color:!0},colors:{color:!0,multiple:!0},fill:{enums:["solid","linear-gradient","radial-gradient"]},bool:{enums:["yes","no"]},bools:{enums:["yes","no"],multiple:!0},lineStyle:{enums:["solid","dotted","dashed"]},lineCap:{enums:["butt","round","square"]},linePosition:{enums:["center","inside","outside"]},lineJoin:{enums:["round","bevel","miter"]},borderStyle:{enums:["solid","dotted","dashed","double"]},curveStyle:{enums:["bezier","unbundled-bezier","haystack","segments","straight","straight-triangle","taxi","round-segments","round-taxi"]},radiusType:{enums:["arc-radius","influence-radius"],multiple:!0},fontFamily:{regex:'^([\\w- \\"]+(?:\\s*,\\s*[\\w- \\"]+)*)$'},fontStyle:{enums:["italic","normal","oblique"]},fontWeight:{enums:["normal","bold","bolder","lighter","100","200","300","400","500","600","800","900",100,200,300,400,500,600,700,800,900]},textDecoration:{enums:["none","underline","overline","line-through"]},textTransform:{enums:["none","uppercase","lowercase"]},textWrap:{enums:["none","wrap","ellipsis"]},textOverflowWrap:{enums:["whitespace","anywhere"]},textBackgroundShape:{enums:["rectangle","roundrectangle","round-rectangle","circle"]},nodeShape:{enums:["rectangle","roundrectangle","round-rectangle","cutrectangle","cut-rectangle","bottomroundrectangle","bottom-round-rectangle","barrel","ellipse","triangle","round-triangle","square","pentagon","round-pentagon","hexagon","round-hexagon","concavehexagon","concave-hexagon","heptagon","round-heptagon","octagon","round-octagon","tag","round-tag","star","diamond","round-diamond","vee","rhomboid","right-rhomboid","polygon"]},overlayShape:{enums:["roundrectangle","round-rectangle","ellipse"]},cornerRadius:{number:!0,min:0,units:"px|em",implicitUnits:"px",enums:["auto"]},compoundIncludeLabels:{enums:["include","exclude"]},arrowShape:{enums:["tee","triangle","triangle-tee","circle-triangle","triangle-cross","triangle-backcurve","vee","square","circle","diamond","chevron","none"]},arrowFill:{enums:["filled","hollow"]},arrowWidth:{number:!0,units:"%|px|em",implicitUnits:"px",enums:["match-line"]},display:{enums:["element","none"]},visibility:{enums:["hidden","visible"]},zCompoundDepth:{enums:["bottom","orphan","auto","top"]},zIndexCompare:{enums:["auto","manual"]},valign:{enums:["top","center","bottom"]},halign:{enums:["left","center","right"]},justification:{enums:["left","center","right","auto"]},text:{string:!0},data:{mapping:!0,regex:i("data")},layoutData:{mapping:!0,regex:i("layoutData")},scratch:{mapping:!0,regex:i("scratch")},mapData:{mapping:!0,regex:o("mapData")},mapLayoutData:{mapping:!0,regex:o("mapLayoutData")},mapScratch:{mapping:!0,regex:o("mapScratch")},fn:{mapping:!0,fn:!0},url:{regexes:s,singleRegexMatchValue:!0},urls:{regexes:s,singleRegexMatchValue:!0,multiple:!0},propList:{propList:!0},angle:{number:!0,units:"deg|rad",implicitUnits:"rad"},textRotation:{number:!0,units:"deg|rad",implicitUnits:"rad",enums:["none","autorotate"]},polygonPointList:{number:!0,multiple:!0,evenMultiple:!0,min:-1,max:1,unitless:!0},edgeDistances:{enums:["intersection","node-position","endpoints"]},edgeEndpoint:{number:!0,multiple:!0,units:"%|px|em|deg|rad",implicitUnits:"px",enums:["inside-to-node","outside-to-node","outside-to-node-or-label","outside-to-line","outside-to-line-or-label"],singleEnum:!0,validate:function(q,H){switch(q.length){case 2:return H[0]!=="deg"&&H[0]!=="rad"&&H[1]!=="deg"&&H[1]!=="rad";case 1:return ge(q[0])||H[0]==="deg"||H[0]==="rad";default:return!1}}},easing:{regexes:["^(spring)\\s*\\(\\s*("+r+")\\s*,\\s*("+r+")\\s*\\)$","^(cubic-bezier)\\s*\\(\\s*("+r+")\\s*,\\s*("+r+")\\s*,\\s*("+r+")\\s*,\\s*("+r+")\\s*\\)$"],enums:["linear","ease","ease-in","ease-out","ease-in-out","ease-in-sine","ease-out-sine","ease-in-out-sine","ease-in-quad","ease-out-quad","ease-in-out-quad","ease-in-cubic","ease-out-cubic","ease-in-out-cubic","ease-in-quart","ease-out-quart","ease-in-out-quart","ease-in-quint","ease-out-quint","ease-in-out-quint","ease-in-expo","ease-out-expo","ease-in-out-expo","ease-in-circ","ease-out-circ","ease-in-out-circ"]},gradientDirection:{enums:["to-bottom","to-top","to-left","to-right","to-bottom-right","to-bottom-left","to-top-right","to-top-left","to-right-bottom","to-left-bottom","to-right-top","to-left-top"]},boundsExpansion:{number:!0,multiple:!0,min:0,validate:function(q){var H=q.length;return H===1||H===2||H===4}}};var l={zeroNonZero:function(q,H){return(q==null||H==null)&&q!==H||q==0&&H!=0?!0:q!=0&&H==0},any:function(q,H){return q!=H},emptyNonEmpty:function(q,H){var Y=ut(q),te=ut(H);return Y&&!te||!Y&&te}},u=Qe.types,v=[{name:"label",type:u.text,triggersBounds:l.any,triggersZOrder:l.emptyNonEmpty},{name:"text-rotation",type:u.textRotation,triggersBounds:l.any},{name:"text-margin-x",type:u.bidirectionalSize,triggersBounds:l.any},{name:"text-margin-y",type:u.bidirectionalSize,triggersBounds:l.any}],f=[{name:"source-label",type:u.text,triggersBounds:l.any},{name:"source-text-rotation",type:u.textRotation,triggersBounds:l.any},{name:"source-text-margin-x",type:u.bidirectionalSize,triggersBounds:l.any},{name:"source-text-margin-y",type:u.bidirectionalSize,triggersBounds:l.any},{name:"source-text-offset",type:u.size,triggersBounds:l.any}],c=[{name:"target-label",type:u.text,triggersBounds:l.any},{name:"target-text-rotation",type:u.textRotation,triggersBounds:l.any},{name:"target-text-margin-x",type:u.bidirectionalSize,triggersBounds:l.any},{name:"target-text-margin-y",type:u.bidirectionalSize,triggersBounds:l.any},{name:"target-text-offset",type:u.size,triggersBounds:l.any}],d=[{name:"font-family",type:u.fontFamily,triggersBounds:l.any},{name:"font-style",type:u.fontStyle,triggersBounds:l.any},{name:"font-weight",type:u.fontWeight,triggersBounds:l.any},{name:"font-size",type:u.size,triggersBounds:l.any},{name:"text-transform",type:u.textTransform,triggersBounds:l.any},{name:"text-wrap",type:u.textWrap,triggersBounds:l.any},{name:"text-overflow-wrap",type:u.textOverflowWrap,triggersBounds:l.any},{name:"text-max-width",type:u.size,triggersBounds:l.any},{name:"text-outline-width",type:u.size,triggersBounds:l.any},{name:"line-height",type:u.positiveNumber,triggersBounds:l.any}],h=[{name:"text-valign",type:u.valign,triggersBounds:l.any},{name:"text-halign",type:u.halign,triggersBounds:l.any},{name:"color",type:u.color},{name:"text-outline-color",type:u.color},{name:"text-outline-opacity",type:u.zeroOneNumber},{name:"text-background-color",type:u.color},{name:"text-background-opacity",type:u.zeroOneNumber},{name:"text-background-padding",type:u.size,triggersBounds:l.any},{name:"text-border-opacity",type:u.zeroOneNumber},{name:"text-border-color",type:u.color},{name:"text-border-width",type:u.size,triggersBounds:l.any},{name:"text-border-style",type:u.borderStyle,triggersBounds:l.any},{name:"text-background-shape",type:u.textBackgroundShape,triggersBounds:l.any},{name:"text-justification",type:u.justification},{name:"box-select-labels",type:u.bool,triggersBounds:l.any}],y=[{name:"events",type:u.bool,triggersZOrder:l.any},{name:"text-events",type:u.bool,triggersZOrder:l.any},{name:"box-selection",type:u.boxSelection,triggersZOrder:l.any}],g=[{name:"display",type:u.display,triggersZOrder:l.any,triggersBounds:l.any,triggersBoundsOfConnectedEdges:l.any,triggersBoundsOfParallelEdges:function(q,H,Y){return q===H?!1:Y.pstyle("curve-style").value==="bezier"}},{name:"visibility",type:u.visibility,triggersZOrder:l.any},{name:"opacity",type:u.zeroOneNumber,triggersZOrder:l.zeroNonZero},{name:"text-opacity",type:u.zeroOneNumber},{name:"min-zoomed-font-size",type:u.size},{name:"z-compound-depth",type:u.zCompoundDepth,triggersZOrder:l.any},{name:"z-index-compare",type:u.zIndexCompare,triggersZOrder:l.any},{name:"z-index",type:u.number,triggersZOrder:l.any}],p=[{name:"overlay-padding",type:u.size,triggersBounds:l.any},{name:"overlay-color",type:u.color},{name:"overlay-opacity",type:u.zeroOneNumber,triggersBounds:l.zeroNonZero},{name:"overlay-shape",type:u.overlayShape,triggersBounds:l.any},{name:"overlay-corner-radius",type:u.cornerRadius}],m=[{name:"underlay-padding",type:u.size,triggersBounds:l.any},{name:"underlay-color",type:u.color},{name:"underlay-opacity",type:u.zeroOneNumber,triggersBounds:l.zeroNonZero},{name:"underlay-shape",type:u.overlayShape,triggersBounds:l.any},{name:"underlay-corner-radius",type:u.cornerRadius}],b=[{name:"transition-property",type:u.propList},{name:"transition-duration",type:u.time},{name:"transition-delay",type:u.time},{name:"transition-timing-function",type:u.easing}],w=function(q,H){return H.value==="label"?-q.poolIndex():H.pfValue},E=[{name:"height",type:u.nodeSize,triggersBounds:l.any,hashOverride:w},{name:"width",type:u.nodeSize,triggersBounds:l.any,hashOverride:w},{name:"shape",type:u.nodeShape,triggersBounds:l.any},{name:"shape-polygon-points",type:u.polygonPointList,triggersBounds:l.any},{name:"corner-radius",type:u.cornerRadius},{name:"background-color",type:u.color},{name:"background-fill",type:u.fill},{name:"background-opacity",type:u.zeroOneNumber},{name:"background-blacken",type:u.nOneOneNumber},{name:"background-gradient-stop-colors",type:u.colors},{name:"background-gradient-stop-positions",type:u.percentages},{name:"background-gradient-direction",type:u.gradientDirection},{name:"padding",type:u.sizeMaybePercent,triggersBounds:l.any},{name:"padding-relative-to",type:u.paddingRelativeTo,triggersBounds:l.any},{name:"bounds-expansion",type:u.boundsExpansion,triggersBounds:l.any}],C=[{name:"border-color",type:u.color},{name:"border-opacity",type:u.zeroOneNumber},{name:"border-width",type:u.size,triggersBounds:l.any},{name:"border-style",type:u.borderStyle},{name:"border-cap",type:u.lineCap},{name:"border-join",type:u.lineJoin},{name:"border-dash-pattern",type:u.numbers},{name:"border-dash-offset",type:u.number},{name:"border-position",type:u.linePosition}],x=[{name:"outline-color",type:u.color},{name:"outline-opacity",type:u.zeroOneNumber},{name:"outline-width",type:u.size,triggersBounds:l.any},{name:"outline-style",type:u.borderStyle},{name:"outline-offset",type:u.size,triggersBounds:l.any}],T=[{name:"background-image",type:u.urls},{name:"background-image-crossorigin",type:u.bgCrossOrigin},{name:"background-image-opacity",type:u.zeroOneNumbers},{name:"background-image-containment",type:u.bgContainment},{name:"background-image-smoothing",type:u.bools},{name:"background-position-x",type:u.bgPos},{name:"background-position-y",type:u.bgPos},{name:"background-width-relative-to",type:u.bgRelativeTo},{name:"background-height-relative-to",type:u.bgRelativeTo},{name:"background-repeat",type:u.bgRepeat},{name:"background-fit",type:u.bgFit},{name:"background-clip",type:u.bgClip},{name:"background-width",type:u.bgWH},{name:"background-height",type:u.bgWH},{name:"background-offset-x",type:u.bgPos},{name:"background-offset-y",type:u.bgPos}],k=[{name:"position",type:u.position,triggersBounds:l.any},{name:"compound-sizing-wrt-labels",type:u.compoundIncludeLabels,triggersBounds:l.any},{name:"min-width",type:u.size,triggersBounds:l.any},{name:"min-width-bias-left",type:u.sizeMaybePercent,triggersBounds:l.any},{name:"min-width-bias-right",type:u.sizeMaybePercent,triggersBounds:l.any},{name:"min-height",type:u.size,triggersBounds:l.any},{name:"min-height-bias-top",type:u.sizeMaybePercent,triggersBounds:l.any},{name:"min-height-bias-bottom",type:u.sizeMaybePercent,triggersBounds:l.any}],D=[{name:"line-style",type:u.lineStyle},{name:"line-color",type:u.color},{name:"line-fill",type:u.fill},{name:"line-cap",type:u.lineCap},{name:"line-opacity",type:u.zeroOneNumber},{name:"line-dash-pattern",type:u.numbers},{name:"line-dash-offset",type:u.number},{name:"line-outline-width",type:u.size},{name:"line-outline-color",type:u.color},{name:"line-gradient-stop-colors",type:u.colors},{name:"line-gradient-stop-positions",type:u.percentages},{name:"curve-style",type:u.curveStyle,triggersBounds:l.any,triggersBoundsOfParallelEdges:function(q,H){return q===H?!1:q==="bezier"||H==="bezier"}},{name:"haystack-radius",type:u.zeroOneNumber,triggersBounds:l.any},{name:"source-endpoint",type:u.edgeEndpoint,triggersBounds:l.any},{name:"target-endpoint",type:u.edgeEndpoint,triggersBounds:l.any},{name:"control-point-step-size",type:u.size,triggersBounds:l.any},{name:"control-point-distances",type:u.bidirectionalSizes,triggersBounds:l.any},{name:"control-point-weights",type:u.numbers,triggersBounds:l.any},{name:"segment-distances",type:u.bidirectionalSizes,triggersBounds:l.any},{name:"segment-weights",type:u.numbers,triggersBounds:l.any},{name:"segment-radii",type:u.numbers,triggersBounds:l.any},{name:"radius-type",type:u.radiusType,triggersBounds:l.any},{name:"taxi-turn",type:u.bidirectionalSizeMaybePercent,triggersBounds:l.any},{name:"taxi-turn-min-distance",type:u.size,triggersBounds:l.any},{name:"taxi-direction",type:u.axisDirection,triggersBounds:l.any},{name:"taxi-radius",type:u.number,triggersBounds:l.any},{name:"edge-distances",type:u.edgeDistances,triggersBounds:l.any},{name:"arrow-scale",type:u.positiveNumber,triggersBounds:l.any},{name:"loop-direction",type:u.angle,triggersBounds:l.any},{name:"loop-sweep",type:u.angle,triggersBounds:l.any},{name:"source-distance-from-node",type:u.size,triggersBounds:l.any},{name:"target-distance-from-node",type:u.size,triggersBounds:l.any}],B=[{name:"ghost",type:u.bool,triggersBounds:l.any},{name:"ghost-offset-x",type:u.bidirectionalSize,triggersBounds:l.any},{name:"ghost-offset-y",type:u.bidirectionalSize,triggersBounds:l.any},{name:"ghost-opacity",type:u.zeroOneNumber}],P=[{name:"selection-box-color",type:u.color},{name:"selection-box-opacity",type:u.zeroOneNumber},{name:"selection-box-border-color",type:u.color},{name:"selection-box-border-width",type:u.size},{name:"active-bg-color",type:u.color},{name:"active-bg-opacity",type:u.zeroOneNumber},{name:"active-bg-size",type:u.size},{name:"outside-texture-bg-color",type:u.color},{name:"outside-texture-bg-opacity",type:u.zeroOneNumber}],A=[];Qe.pieBackgroundN=16,A.push({name:"pie-size",type:u.sizeMaybePercent}),A.push({name:"pie-hole",type:u.sizeMaybePercent}),A.push({name:"pie-start-angle",type:u.angle});for(var R=1;R<=Qe.pieBackgroundN;R++)A.push({name:"pie-"+R+"-background-color",type:u.color}),A.push({name:"pie-"+R+"-background-size",type:u.percent}),A.push({name:"pie-"+R+"-background-opacity",type:u.zeroOneNumber});var L=[];Qe.stripeBackgroundN=16,L.push({name:"stripe-size",type:u.sizeMaybePercent}),L.push({name:"stripe-direction",type:u.axisDirectionPrimary});for(var I=1;I<=Qe.stripeBackgroundN;I++)L.push({name:"stripe-"+I+"-background-color",type:u.color}),L.push({name:"stripe-"+I+"-background-size",type:u.percent}),L.push({name:"stripe-"+I+"-background-opacity",type:u.zeroOneNumber});var M=[],O=Qe.arrowPrefixes=["source","mid-source","target","mid-target"];[{name:"arrow-shape",type:u.arrowShape,triggersBounds:l.any},{name:"arrow-color",type:u.color},{name:"arrow-fill",type:u.arrowFill},{name:"arrow-width",type:u.arrowWidth}].forEach(function(z){O.forEach(function(q){var H=q+"-"+z.name,Y=z.type,te=z.triggersBounds;M.push({name:H,type:Y,triggersBounds:te})})},{});var V=Qe.properties=[].concat(y,b,g,p,m,B,h,d,v,f,c,E,C,x,T,A,L,k,D,M,P),G=Qe.propertyGroups={behavior:y,transition:b,visibility:g,overlay:p,underlay:m,ghost:B,commonLabel:h,labelDimensions:d,mainLabel:v,sourceLabel:f,targetLabel:c,nodeBody:E,nodeBorder:C,nodeOutline:x,backgroundImage:T,pie:A,stripe:L,compound:k,edgeLine:D,edgeArrow:M,core:P},N=Qe.propertyGroupNames={},F=Qe.propertyGroupKeys=Object.keys(G);F.forEach(function(z){N[z]=G[z].map(function(q){return q.name}),G[z].forEach(function(q){return q.groupKey=z})});var U=Qe.aliases=[{name:"content",pointsTo:"label"},{name:"control-point-distance",pointsTo:"control-point-distances"},{name:"control-point-weight",pointsTo:"control-point-weights"},{name:"segment-distance",pointsTo:"segment-distances"},{name:"segment-weight",pointsTo:"segment-weights"},{name:"segment-radius",pointsTo:"segment-radii"},{name:"edge-text-rotation",pointsTo:"text-rotation"},{name:"padding-left",pointsTo:"padding"},{name:"padding-right",pointsTo:"padding"},{name:"padding-top",pointsTo:"padding"},{name:"padding-bottom",pointsTo:"padding"}];Qe.propertyNames=V.map(function(z){return z.name});for(var Q=0;Q<V.length;Q++){var K=V[Q];V[K.name]=K}for(var j=0;j<U.length;j++){var re=U[j],ne=V[re.pointsTo],J={name:re.name,alias:!0,pointsTo:ne};V.push(J),V[re.name]=J}})();Qe.getDefaultProperty=function(r){return this.getDefaultProperties()[r]};Qe.getDefaultProperties=function(){var r=this._private;if(r.defaultProperties!=null)return r.defaultProperties;for(var e=be({"selection-box-color":"#ddd","selection-box-opacity":.65,"selection-box-border-color":"#aaa","selection-box-border-width":1,"active-bg-color":"black","active-bg-opacity":.15,"active-bg-size":30,"outside-texture-bg-color":"#000","outside-texture-bg-opacity":.125,events:"yes","text-events":"no","text-valign":"top","text-halign":"center","text-justification":"auto","line-height":1,color:"#000","box-selection":"contain","text-outline-color":"#000","text-outline-width":0,"text-outline-opacity":1,"text-opacity":1,"text-decoration":"none","text-transform":"none","text-wrap":"none","text-overflow-wrap":"whitespace","text-max-width":9999,"text-background-color":"#000","text-background-opacity":0,"text-background-shape":"rectangle","text-background-padding":0,"text-border-opacity":0,"text-border-width":0,"text-border-style":"solid","text-border-color":"#000","font-family":"Helvetica Neue, Helvetica, sans-serif","font-style":"normal","font-weight":"normal","font-size":16,"min-zoomed-font-size":0,"text-rotation":"none","source-text-rotation":"none","target-text-rotation":"none",visibility:"visible",display:"element",opacity:1,"z-compound-depth":"auto","z-index-compare":"auto","z-index":0,label:"","text-margin-x":0,"text-margin-y":0,"source-label":"","source-text-offset":0,"source-text-margin-x":0,"source-text-margin-y":0,"target-label":"","target-text-offset":0,"target-text-margin-x":0,"target-text-margin-y":0,"overlay-opacity":0,"overlay-color":"#000","overlay-padding":10,"overlay-shape":"round-rectangle","overlay-corner-radius":"auto","underlay-opacity":0,"underlay-color":"#000","underlay-padding":10,"underlay-shape":"round-rectangle","underlay-corner-radius":"auto","transition-property":"none","transition-duration":0,"transition-delay":0,"transition-timing-function":"linear","box-select-labels":"no","background-blacken":0,"background-color":"#999","background-fill":"solid","background-opacity":1,"background-image":"none","background-image-crossorigin":"anonymous","background-image-opacity":1,"background-image-containment":"inside","background-image-smoothing":"yes","background-position-x":"50%","background-position-y":"50%","background-offset-x":0,"background-offset-y":0,"background-width-relative-to":"include-padding","background-height-relative-to":"include-padding","background-repeat":"no-repeat","background-fit":"none","background-clip":"node","background-width":"auto","background-height":"auto","border-color":"#000","border-opacity":1,"border-width":0,"border-style":"solid","border-dash-pattern":[4,2],"border-dash-offset":0,"border-cap":"butt","border-join":"miter","border-position":"center","outline-color":"#999","outline-opacity":1,"outline-width":0,"outline-offset":0,"outline-style":"solid",height:30,width:30,shape:"ellipse","shape-polygon-points":"-1, -1,   1, -1,   1, 1,   -1, 1","corner-radius":"auto","bounds-expansion":0,"background-gradient-direction":"to-bottom","background-gradient-stop-colors":"#999","background-gradient-stop-positions":"0%",ghost:"no","ghost-offset-y":0,"ghost-offset-x":0,"ghost-opacity":0,padding:0,"padding-relative-to":"width",position:"origin","compound-sizing-wrt-labels":"include","min-width":0,"min-width-bias-left":0,"min-width-bias-right":0,"min-height":0,"min-height-bias-top":0,"min-height-bias-bottom":0},{"pie-size":"100%","pie-hole":0,"pie-start-angle":"0deg"},[{name:"pie-{{i}}-background-color",value:"black"},{name:"pie-{{i}}-background-size",value:"0%"},{name:"pie-{{i}}-background-opacity",value:1}].reduce(function(l,u){for(var v=1;v<=Qe.pieBackgroundN;v++){var f=u.name.replace("{{i}}",v),c=u.value;l[f]=c}return l},{}),{"stripe-size":"100%","stripe-direction":"horizontal"},[{name:"stripe-{{i}}-background-color",value:"black"},{name:"stripe-{{i}}-background-size",value:"0%"},{name:"stripe-{{i}}-background-opacity",value:1}].reduce(function(l,u){for(var v=1;v<=Qe.stripeBackgroundN;v++){var f=u.name.replace("{{i}}",v),c=u.value;l[f]=c}return l},{}),{"line-style":"solid","line-color":"#999","line-fill":"solid","line-cap":"butt","line-opacity":1,"line-outline-width":0,"line-outline-color":"#000","line-gradient-stop-colors":"#999","line-gradient-stop-positions":"0%","control-point-step-size":40,"control-point-weights":.5,"segment-weights":.5,"segment-distances":20,"segment-radii":15,"radius-type":"arc-radius","taxi-turn":"50%","taxi-radius":15,"taxi-turn-min-distance":10,"taxi-direction":"auto","edge-distances":"intersection","curve-style":"haystack","haystack-radius":0,"arrow-scale":1,"loop-direction":"-45deg","loop-sweep":"-90deg","source-distance-from-node":0,"target-distance-from-node":0,"source-endpoint":"outside-to-node","target-endpoint":"outside-to-node","line-dash-pattern":[6,3],"line-dash-offset":0},[{name:"arrow-shape",value:"none"},{name:"arrow-color",value:"#999"},{name:"arrow-fill",value:"filled"},{name:"arrow-width",value:1}].reduce(function(l,u){return Qe.arrowPrefixes.forEach(function(v){var f=v+"-"+u.name,c=u.value;l[f]=c}),l},{})),t={},a=0;a<this.properties.length;a++){var n=this.properties[a];if(!n.pointsTo){var i=n.name,o=e[i],s=this.parse(i,o);t[i]=s}}return r.defaultProperties=t,r.defaultProperties};Qe.addDefaultStylesheet=function(){this.selector(":parent").css({shape:"rectangle",padding:10,"background-color":"#eee","border-color":"#ccc","border-width":1}).selector("edge").css({width:3}).selector(":loop").css({"curve-style":"bezier"}).selector("edge:compound").css({"curve-style":"bezier","source-endpoint":"outside-to-line","target-endpoint":"outside-to-line"}).selector(":selected").css({"background-color":"#0169D9","line-color":"#0169D9","source-arrow-color":"#0169D9","target-arrow-color":"#0169D9","mid-source-arrow-color":"#0169D9","mid-target-arrow-color":"#0169D9"}).selector(":parent:selected").css({"background-color":"#CCE1F9","border-color":"#aec8e5"}).selector(":active").css({"overlay-color":"black","overlay-padding":10,"overlay-opacity":.25}),this.defaultLength=this.length};var Un={};Un.parse=function(r,e,t,a){var n=this;if(Ue(e))return n.parseImplWarn(r,e,t,a);var i=a==="mapping"||a===!0||a===!1||a==null?"dontcare":a,o=t?"t":"f",s=""+e,l=cv(r,s,o,i),u=n.propCache=n.propCache||[],v;return(v=u[l])||(v=u[l]=n.parseImplWarn(r,e,t,a)),(t||a==="mapping")&&(v=qr(v),v&&(v.value=qr(v.value))),v};Un.parseImplWarn=function(r,e,t,a){var n=this.parseImpl(r,e,t,a);return!n&&e!=null&&Ve("The style property `".concat(r,": ").concat(e,"` is invalid")),n&&(n.name==="width"||n.name==="height")&&e==="label"&&Ve("The style value of `label` is deprecated for `"+n.name+"`"),n};Un.parseImpl=function(r,e,t,a){var n=this;r=Qo(r);var i=n.properties[r],o=e,s=n.types;if(!i||e===void 0)return null;i.alias&&(i=i.pointsTo,r=i.name);var l=ge(e);l&&(e=e.trim());var u=i.type;if(!u)return null;if(t&&(e===""||e===null))return{name:r,value:e,bypass:!0,deleteBypass:!0};if(Ue(e))return{name:r,value:e,strValue:"fn",mapped:s.fn,bypass:t};var v,f;if(!(!l||a||e.length<7||e[1]!=="a")){if(e.length>=7&&e[0]==="d"&&(v=new RegExp(s.data.regex).exec(e))){if(t)return!1;var c=s.data;return{name:r,value:v,strValue:""+e,mapped:c,field:v[1],bypass:t}}else if(e.length>=10&&e[0]==="m"&&(f=new RegExp(s.mapData.regex).exec(e))){if(t||u.multiple)return!1;var d=s.mapData;if(!(u.color||u.number))return!1;var h=this.parse(r,f[4]);if(!h||h.mapped)return!1;var y=this.parse(r,f[5]);if(!y||y.mapped)return!1;if(h.pfValue===y.pfValue||h.strValue===y.strValue)return Ve("`"+r+": "+e+"` is not a valid mapper because the output range is zero; converting to `"+r+": "+h.strValue+"`"),this.parse(r,h.strValue);if(u.color){var g=h.value,p=y.value,m=g[0]===p[0]&&g[1]===p[1]&&g[2]===p[2]&&(g[3]===p[3]||(g[3]==null||g[3]===1)&&(p[3]==null||p[3]===1));if(m)return!1}return{name:r,value:f,strValue:""+e,mapped:d,field:f[1],fieldMin:parseFloat(f[2]),fieldMax:parseFloat(f[3]),valueMin:h.value,valueMax:y.value,bypass:t}}}if(u.multiple&&a!=="multiple"){var b;if(l?b=e.split(/\s+/):_e(e)?b=e:b=[e],u.evenMultiple&&b.length%2!==0)return null;for(var w=[],E=[],C=[],x="",T=!1,k=0;k<b.length;k++){var D=n.parse(r,b[k],t,"multiple");T=T||ge(D.value),w.push(D.value),C.push(D.pfValue!=null?D.pfValue:D.value),E.push(D.units),x+=(k>0?" ":"")+D.strValue}return u.validate&&!u.validate(w,E)?null:u.singleEnum&&T?w.length===1&&ge(w[0])?{name:r,value:w[0],strValue:w[0],bypass:t}:null:{name:r,value:w,pfValue:C,strValue:x,bypass:t,units:E}}var B=function(){for(var J=0;J<u.enums.length;J++){var z=u.enums[J];if(z===e)return{name:r,value:e,strValue:""+e,bypass:t}}return null};if(u.number){var P,A="px";if(u.units&&(P=u.units),u.implicitUnits&&(A=u.implicitUnits),!u.unitless)if(l){var R="px|em"+(u.allowPercent?"|\\%":"");P&&(R=P);var L=e.match("^("+tr+")("+R+")?$");L&&(e=L[1],P=L[2]||A)}else(!P||u.implicitUnits)&&(P=A);if(e=parseFloat(e),isNaN(e)&&u.enums===void 0)return null;if(isNaN(e)&&u.enums!==void 0)return e=o,B();if(u.integer&&!cc(e)||u.min!==void 0&&(e<u.min||u.strictMin&&e===u.min)||u.max!==void 0&&(e>u.max||u.strictMax&&e===u.max))return null;var I={name:r,value:e,strValue:""+e+(P||""),units:P,bypass:t};return u.unitless||P!=="px"&&P!=="em"?I.pfValue=e:I.pfValue=P==="px"||!P?e:this.getEmSizeInPixels()*e,(P==="ms"||P==="s")&&(I.pfValue=P==="ms"?e:1e3*e),(P==="deg"||P==="rad")&&(I.pfValue=P==="rad"?e:Eh(e)),P==="%"&&(I.pfValue=e/100),I}else if(u.propList){var M=[],O=""+e;if(O!=="none"){for(var V=O.split(/\s*,\s*|\s+/),G=0;G<V.length;G++){var N=V[G].trim();n.properties[N]?M.push(N):Ve("`"+N+"` is not a valid property name")}if(M.length===0)return null}return{name:r,value:M,strValue:M.length===0?"none":M.join(" "),bypass:t}}else if(u.color){var F=iv(e);return F?{name:r,value:F,pfValue:F,strValue:"rgb("+F[0]+","+F[1]+","+F[2]+")",bypass:t}:null}else if(u.regex||u.regexes){if(u.enums){var U=B();if(U)return U}for(var Q=u.regexes?u.regexes:[u.regex],K=0;K<Q.length;K++){var j=new RegExp(Q[K]),re=j.exec(e);if(re)return{name:r,value:u.singleRegexMatchValue?re[1]:re,strValue:""+e,bypass:t}}return null}else return u.string?{name:r,value:""+e,strValue:""+e,bypass:t}:u.enums?B():null};var sr=function(e){if(!(this instanceof sr))return new sr(e);if(!Zo(e)){$e("A style must have a core reference");return}this._private={cy:e,coreStyle:{}},this.length=0,this.resetToDefault()},pr=sr.prototype;pr.instanceString=function(){return"style"};pr.clear=function(){for(var r=this._private,e=r.cy,t=e.elements(),a=0;a<this.length;a++)this[a]=void 0;return this.length=0,r.contextStyles={},r.propDiffs={},this.cleanElements(t,!0),t.forEach(function(n){var i=n[0]._private;i.styleDirty=!0,i.appliedInitStyle=!1}),this};pr.resetToDefault=function(){return this.clear(),this.addDefaultStylesheet(),this};pr.core=function(r){return this._private.coreStyle[r]||this.getDefaultProperty(r)};pr.selector=function(r){var e=r==="core"?null:new ft(r),t=this.length++;return this[t]={selector:e,properties:[],mappedProperties:[],index:t},this};pr.css=function(){var r=this,e=arguments;if(e.length===1)for(var t=e[0],a=0;a<r.properties.length;a++){var n=r.properties[a],i=t[n.name];i===void 0&&(i=t[Mn(n.name)]),i!==void 0&&this.cssRule(n.name,i)}else e.length===2&&this.cssRule(e[0],e[1]);return this};pr.style=pr.css;pr.cssRule=function(r,e){var t=this.parse(r,e);if(t){var a=this.length-1;this[a].properties.push(t),this[a].properties[t.name]=t,t.name.match(/pie-(\d+)-background-size/)&&t.value&&(this._private.hasPie=!0),t.name.match(/stripe-(\d+)-background-size/)&&t.value&&(this._private.hasStripe=!0),t.mapped&&this[a].mappedProperties.push(t);var n=!this[a].selector;n&&(this._private.coreStyle[t.name]=t)}return this};pr.append=function(r){return tv(r)?r.appendToStyle(this):_e(r)?this.appendFromJson(r):ge(r)&&this.appendFromString(r),this};sr.fromJson=function(r,e){var t=new sr(r);return t.fromJson(e),t};sr.fromString=function(r,e){return new sr(r).fromString(e)};[ur,_a,cs,_r,$n,hs,Qe,Un].forEach(function(r){be(pr,r)});sr.types=pr.types;sr.properties=pr.properties;sr.propertyGroups=pr.propertyGroups;sr.propertyGroupNames=pr.propertyGroupNames;sr.propertyGroupKeys=pr.propertyGroupKeys;var kp={style:function(e){if(e){var t=this.setStyle(e);t.update()}return this._private.style},setStyle:function(e){var t=this._private;return tv(e)?t.style=e.generateStyle(this):_e(e)?t.style=sr.fromJson(this,e):ge(e)?t.style=sr.fromString(this,e):t.style=sr(this),t.style},updateStyle:function(){this.mutableElements().updateStyle()}},Dp="single",At={autolock:function(e){if(e!==void 0)this._private.autolock=!!e;else return this._private.autolock;return this},autoungrabify:function(e){if(e!==void 0)this._private.autoungrabify=!!e;else return this._private.autoungrabify;return this},autounselectify:function(e){if(e!==void 0)this._private.autounselectify=!!e;else return this._private.autounselectify;return this},selectionType:function(e){var t=this._private;if(t.selectionType==null&&(t.selectionType=Dp),e!==void 0)(e==="additive"||e==="single")&&(t.selectionType=e);else return t.selectionType;return this},panningEnabled:function(e){if(e!==void 0)this._private.panningEnabled=!!e;else return this._private.panningEnabled;return this},userPanningEnabled:function(e){if(e!==void 0)this._private.userPanningEnabled=!!e;else return this._private.userPanningEnabled;return this},zoomingEnabled:function(e){if(e!==void 0)this._private.zoomingEnabled=!!e;else return this._private.zoomingEnabled;return this},userZoomingEnabled:function(e){if(e!==void 0)this._private.userZoomingEnabled=!!e;else return this._private.userZoomingEnabled;return this},boxSelectionEnabled:function(e){if(e!==void 0)this._private.boxSelectionEnabled=!!e;else return this._private.boxSelectionEnabled;return this},pan:function(){var e=arguments,t=this._private.pan,a,n,i,o,s;switch(e.length){case 0:return t;case 1:if(ge(e[0]))return a=e[0],t[a];if(Le(e[0])){if(!this._private.panningEnabled)return this;i=e[0],o=i.x,s=i.y,ae(o)&&(t.x=o),ae(s)&&(t.y=s),this.emit("pan viewport")}break;case 2:if(!this._private.panningEnabled)return this;a=e[0],n=e[1],(a==="x"||a==="y")&&ae(n)&&(t[a]=n),this.emit("pan viewport");break}return this.notify("viewport"),this},panBy:function(e,t){var a=arguments,n=this._private.pan,i,o,s,l,u;if(!this._private.panningEnabled)return this;switch(a.length){case 1:Le(e)&&(s=a[0],l=s.x,u=s.y,ae(l)&&(n.x+=l),ae(u)&&(n.y+=u),this.emit("pan viewport"));break;case 2:i=e,o=t,(i==="x"||i==="y")&&ae(o)&&(n[i]+=o),this.emit("pan viewport");break}return this.notify("viewport"),this},gc:function(){this.notify("gc")},fit:function(e,t){var a=this.getFitViewport(e,t);if(a){var n=this._private;n.zoom=a.zoom,n.pan=a.pan,this.emit("pan zoom viewport"),this.notify("viewport")}return this},getFitViewport:function(e,t){if(ae(e)&&t===void 0&&(t=e,e=void 0),!(!this._private.panningEnabled||!this._private.zoomingEnabled)){var a;if(ge(e)){var n=e;e=this.$(n)}else if(gc(e)){var i=e;a={x1:i.x1,y1:i.y1,x2:i.x2,y2:i.y2},a.w=a.x2-a.x1,a.h=a.y2-a.y1}else Dr(e)||(e=this.mutableElements());if(!(Dr(e)&&e.empty())){a=a||e.boundingBox();var o=this.width(),s=this.height(),l;if(t=ae(t)?t:0,!isNaN(o)&&!isNaN(s)&&o>0&&s>0&&!isNaN(a.w)&&!isNaN(a.h)&&a.w>0&&a.h>0){l=Math.min((o-2*t)/a.w,(s-2*t)/a.h),l=l>this._private.maxZoom?this._private.maxZoom:l,l=l<this._private.minZoom?this._private.minZoom:l;var u={x:(o-l*(a.x1+a.x2))/2,y:(s-l*(a.y1+a.y2))/2};return{zoom:l,pan:u}}}}},zoomRange:function(e,t){var a=this._private;if(t==null){var n=e;e=n.min,t=n.max}return ae(e)&&ae(t)&&e<=t?(a.minZoom=e,a.maxZoom=t):ae(e)&&t===void 0&&e<=a.maxZoom?a.minZoom=e:ae(t)&&e===void 0&&t>=a.minZoom&&(a.maxZoom=t),this},minZoom:function(e){return e===void 0?this._private.minZoom:this.zoomRange({min:e})},maxZoom:function(e){return e===void 0?this._private.maxZoom:this.zoomRange({max:e})},getZoomedViewport:function(e){var t=this._private,a=t.pan,n=t.zoom,i,o,s=!1;if(t.zoomingEnabled||(s=!0),ae(e)?o=e:Le(e)&&(o=e.level,e.position!=null?i=On(e.position,n,a):e.renderedPosition!=null&&(i=e.renderedPosition),i!=null&&!t.panningEnabled&&(s=!0)),o=o>t.maxZoom?t.maxZoom:o,o=o<t.minZoom?t.minZoom:o,s||!ae(o)||o===n||i!=null&&(!ae(i.x)||!ae(i.y)))return null;if(i!=null){var l=a,u=n,v=o,f={x:-v/u*(i.x-l.x)+i.x,y:-v/u*(i.y-l.y)+i.y};return{zoomed:!0,panned:!0,zoom:v,pan:f}}else return{zoomed:!0,panned:!1,zoom:o,pan:a}},zoom:function(e){if(e===void 0)return this._private.zoom;var t=this.getZoomedViewport(e),a=this._private;return t==null||!t.zoomed?this:(a.zoom=t.zoom,t.panned&&(a.pan.x=t.pan.x,a.pan.y=t.pan.y),this.emit("zoom"+(t.panned?" pan":"")+" viewport"),this.notify("viewport"),this)},viewport:function(e){var t=this._private,a=!0,n=!0,i=[],o=!1,s=!1;if(!e)return this;if(ae(e.zoom)||(a=!1),Le(e.pan)||(n=!1),!a&&!n)return this;if(a){var l=e.zoom;l<t.minZoom||l>t.maxZoom||!t.zoomingEnabled?o=!0:(t.zoom=l,i.push("zoom"))}if(n&&(!o||!e.cancelOnFailedZoom)&&t.panningEnabled){var u=e.pan;ae(u.x)&&(t.pan.x=u.x,s=!1),ae(u.y)&&(t.pan.y=u.y,s=!1),s||i.push("pan")}return i.length>0&&(i.push("viewport"),this.emit(i.join(" ")),this.notify("viewport")),this},center:function(e){var t=this.getCenterPan(e);return t&&(this._private.pan=t,this.emit("pan viewport"),this.notify("viewport")),this},getCenterPan:function(e,t){if(this._private.panningEnabled){if(ge(e)){var a=e;e=this.mutableElements().filter(a)}else Dr(e)||(e=this.mutableElements());if(e.length!==0){var n=e.boundingBox(),i=this.width(),o=this.height();t=t===void 0?this._private.zoom:t;var s={x:(i-t*(n.x1+n.x2))/2,y:(o-t*(n.y1+n.y2))/2};return s}}},reset:function(){return!this._private.panningEnabled||!this._private.zoomingEnabled?this:(this.viewport({pan:{x:0,y:0},zoom:1}),this)},invalidateSize:function(){this._private.sizeCache=null},size:function(){var e=this._private,t=e.container,a=this;return e.sizeCache=e.sizeCache||(t?(function(){var n=a.window().getComputedStyle(t),i=function(s){return parseFloat(n.getPropertyValue(s))};return{width:t.clientWidth-i("padding-left")-i("padding-right"),height:t.clientHeight-i("padding-top")-i("padding-bottom")}})():{width:1,height:1})},width:function(){return this.size().width},height:function(){return this.size().height},extent:function(){var e=this._private.pan,t=this._private.zoom,a=this.renderedExtent(),n={x1:(a.x1-e.x)/t,x2:(a.x2-e.x)/t,y1:(a.y1-e.y)/t,y2:(a.y2-e.y)/t};return n.w=n.x2-n.x1,n.h=n.y2-n.y1,n},renderedExtent:function(){var e=this.width(),t=this.height();return{x1:0,y1:0,x2:e,y2:t,w:e,h:t}},multiClickDebounceTime:function(e){if(e)this._private.multiClickDebounceTime=e;else return this._private.multiClickDebounceTime;return this}};At.centre=At.center;At.autolockNodes=At.autolock;At.autoungrabifyNodes=At.autoungrabify;var Aa={data:Fe.data({field:"data",bindingEvent:"data",allowBinding:!0,allowSetting:!0,settingEvent:"data",settingTriggersEvent:!0,triggerFnName:"trigger",allowGetting:!0,updateStyle:!0}),removeData:Fe.removeData({field:"data",event:"data",triggerFnName:"trigger",triggerEvent:!0,updateStyle:!0}),scratch:Fe.data({field:"scratch",bindingEvent:"scratch",allowBinding:!0,allowSetting:!0,settingEvent:"scratch",settingTriggersEvent:!0,triggerFnName:"trigger",allowGetting:!0,updateStyle:!0}),removeScratch:Fe.removeData({field:"scratch",event:"scratch",triggerFnName:"trigger",triggerEvent:!0,updateStyle:!0})};Aa.attr=Aa.data;Aa.removeAttr=Aa.removeData;var Ra=function(e){var t=this;e=be({},e);var a=e.container;a&&!bn(a)&&bn(a[0])&&(a=a[0]);var n=a?a._cyreg:null;n=n||{},n&&n.cy&&(n.cy.destroy(),n={});var i=n.readies=n.readies||[];a&&(a._cyreg=n),n.cy=t;var o=rr!==void 0&&a!==void 0&&!e.headless,s=e;s.layout=be({name:o?"grid":"null"},s.layout),s.renderer=be({name:o?"canvas":"null"},s.renderer);var l=function(h,y,g){return y!==void 0?y:g!==void 0?g:h},u=this._private={container:a,ready:!1,options:s,elements:new fr(this),listeners:[],aniEles:new fr(this),data:s.data||{},scratch:{},layout:null,renderer:null,destroyed:!1,notificationsEnabled:!0,minZoom:1e-50,maxZoom:1e50,zoomingEnabled:l(!0,s.zoomingEnabled),userZoomingEnabled:l(!0,s.userZoomingEnabled),panningEnabled:l(!0,s.panningEnabled),userPanningEnabled:l(!0,s.userPanningEnabled),boxSelectionEnabled:l(!0,s.boxSelectionEnabled),autolock:l(!1,s.autolock,s.autolockNodes),autoungrabify:l(!1,s.autoungrabify,s.autoungrabifyNodes),autounselectify:l(!1,s.autounselectify),styleEnabled:s.styleEnabled===void 0?o:s.styleEnabled,zoom:ae(s.zoom)?s.zoom:1,pan:{x:Le(s.pan)&&ae(s.pan.x)?s.pan.x:0,y:Le(s.pan)&&ae(s.pan.y)?s.pan.y:0},animation:{current:[],queue:[]},hasCompoundNodes:!1,multiClickDebounceTime:l(250,s.multiClickDebounceTime)};this.createEmitter(),this.selectionType(s.selectionType),this.zoomRange({min:s.minZoom,max:s.maxZoom});var v=function(h,y){var g=h.some(pc);if(g)return ta.all(h).then(y);y(h)};u.styleEnabled&&t.setStyle([]);var f=be({},s,s.renderer);t.initRenderer(f);var c=function(h,y,g){t.notifications(!1);var p=t.mutableElements();p.length>0&&p.remove(),h!=null&&(Le(h)||_e(h))&&t.add(h),t.one("layoutready",function(b){t.notifications(!0),t.emit(b),t.one("load",y),t.emitAndNotify("load")}).one("layoutstop",function(){t.one("done",g),t.emit("done")});var m=be({},t._private.options.layout);m.eles=t.elements(),t.layout(m).run()};v([s.style,s.elements],function(d){var h=d[0],y=d[1];u.styleEnabled&&t.style().append(h),c(y,function(){t.startAnimationLoop(),u.ready=!0,Ue(s.ready)&&t.on("ready",s.ready);for(var g=0;g<i.length;g++){var p=i[g];t.on("ready",p)}n&&(n.readies=[]),t.emit("ready")},s.done)})},kn=Ra.prototype;be(kn,{instanceString:function(){return"core"},isReady:function(){return this._private.ready},destroyed:function(){return this._private.destroyed},ready:function(e){return this.isReady()?this.emitter().emit("ready",[],e):this.on("ready",e),this},destroy:function(){var e=this;if(!e.destroyed())return e.stopAnimationLoop(),e.destroyRenderer(),this.emit("destroy"),e._private.destroyed=!0,e},hasElementWithId:function(e){return this._private.elements.hasElementWithId(e)},getElementById:function(e){return this._private.elements.getElementById(e)},hasCompoundNodes:function(){return this._private.hasCompoundNodes},headless:function(){return this._private.renderer.isHeadless()},styleEnabled:function(){return this._private.styleEnabled},addToPool:function(e){return this._private.elements.merge(e),this},removeFromPool:function(e){return this._private.elements.unmerge(e),this},container:function(){return this._private.container||null},window:function(){var e=this._private.container;if(e==null)return rr;var t=this._private.container.ownerDocument;return t===void 0||t==null?rr:t.defaultView||rr},mount:function(e){if(e!=null){var t=this,a=t._private,n=a.options;return!bn(e)&&bn(e[0])&&(e=e[0]),t.stopAnimationLoop(),t.destroyRenderer(),a.container=e,a.styleEnabled=!0,t.invalidateSize(),t.initRenderer(be({},n,n.renderer,{name:n.renderer.name==="null"?"canvas":n.renderer.name})),t.startAnimationLoop(),t.style(n.style),t.emit("mount"),t}},unmount:function(){var e=this;return e.stopAnimationLoop(),e.destroyRenderer(),e.initRenderer({name:"null"}),e.emit("unmount"),e},options:function(){return qr(this._private.options)},json:function(e){var t=this,a=t._private,n=t.mutableElements(),i=function(w){return t.getElementById(w.id())};if(Le(e)){if(t.startBatch(),e.elements){var o={},s=function(w,E){for(var C=[],x=[],T=0;T<w.length;T++){var k=w[T];if(!k.data.id){Ve("cy.json() cannot handle elements without an ID attribute");continue}var D=""+k.data.id,B=t.getElementById(D);o[D]=!0,B.length!==0?x.push({ele:B,json:k}):(E&&(k.group=E),C.push(k))}t.add(C);for(var P=0;P<x.length;P++){var A=x[P],R=A.ele,L=A.json;R.json(L)}};if(_e(e.elements))s(e.elements);else for(var l=["nodes","edges"],u=0;u<l.length;u++){var v=l[u],f=e.elements[v];_e(f)&&s(f,v)}var c=t.collection();n.filter(function(b){return!o[b.id()]}).forEach(function(b){b.isParent()?c.merge(b):b.remove()}),c.forEach(function(b){return b.children().move({parent:null})}),c.forEach(function(b){return i(b).remove()})}e.style&&t.style(e.style),e.zoom!=null&&e.zoom!==a.zoom&&t.zoom(e.zoom),e.pan&&(e.pan.x!==a.pan.x||e.pan.y!==a.pan.y)&&t.pan(e.pan),e.data&&t.data(e.data);for(var d=["minZoom","maxZoom","zoomingEnabled","userZoomingEnabled","panningEnabled","userPanningEnabled","boxSelectionEnabled","autolock","autoungrabify","autounselectify","multiClickDebounceTime"],h=0;h<d.length;h++){var y=d[h];e[y]!=null&&t[y](e[y])}return t.endBatch(),this}else{var g=!!e,p={};g?p.elements=this.elements().map(function(b){return b.json()}):(p.elements={},n.forEach(function(b){var w=b.group();p.elements[w]||(p.elements[w]=[]),p.elements[w].push(b.json())})),this._private.styleEnabled&&(p.style=t.style().json()),p.data=qr(t.data());var m=a.options;return p.zoomingEnabled=a.zoomingEnabled,p.userZoomingEnabled=a.userZoomingEnabled,p.zoom=a.zoom,p.minZoom=a.minZoom,p.maxZoom=a.maxZoom,p.panningEnabled=a.panningEnabled,p.userPanningEnabled=a.userPanningEnabled,p.pan=qr(a.pan),p.boxSelectionEnabled=a.boxSelectionEnabled,p.renderer=qr(m.renderer),p.hideEdgesOnViewport=m.hideEdgesOnViewport,p.textureOnViewport=m.textureOnViewport,p.wheelSensitivity=m.wheelSensitivity,p.motionBlur=m.motionBlur,p.multiClickDebounceTime=m.multiClickDebounceTime,p}}});kn.$id=kn.getElementById;[pp,xp,tf,Fo,hn,Cp,Vo,dn,kp,At,Aa].forEach(function(r){be(kn,r)});var Bp={fit:!0,directed:!1,direction:"downward",padding:30,circle:!1,grid:!1,spacingFactor:1.75,boundingBox:void 0,avoidOverlap:!0,nodeDimensionsIncludeLabels:!1,roots:void 0,depthSort:void 0,animate:!1,animationDuration:500,animationEasing:void 0,animateFilter:function(e,t){return!0},ready:void 0,stop:void 0,transform:function(e,t){return t}},Pp={maximal:!1,acyclic:!1},Ft=function(e){return e.scratch("breadthfirst")},Tl=function(e,t){return e.scratch("breadthfirst",t)};function af(r){this.options=be({},Bp,Pp,r)}af.prototype.run=function(){var r=this.options,e=r.cy,t=r.eles,a=t.nodes().filter(function(ye){return ye.isChildless()}),n=t,i=r.directed,o=r.acyclic||r.maximal||r.maximalAdjustments>0,s=!!r.boundingBox,l=wr(s?r.boundingBox:structuredClone(e.extent())),u;if(Dr(r.roots))u=r.roots;else if(_e(r.roots)){for(var v=[],f=0;f<r.roots.length;f++){var c=r.roots[f],d=e.getElementById(c);v.push(d)}u=e.collection(v)}else if(ge(r.roots))u=e.$(r.roots);else if(i)u=a.roots();else{var h=t.components();u=e.collection();for(var y=function(){var ie=h[g],he=ie.maxDegree(!1),de=ie.filter(function(Ee){return Ee.degree(!1)===he});u=u.add(de)},g=0;g<h.length;g++)y()}var p=[],m={},b=function(ie,he){p[he]==null&&(p[he]=[]);var de=p[he].length;p[he].push(ie),Tl(ie,{index:de,depth:he})},w=function(ie,he){var de=Ft(ie),Ee=de.depth,pe=de.index;p[Ee][pe]=null,ie.isChildless()&&b(ie,he)};n.bfs({roots:u,directed:r.directed,visit:function(ie,he,de,Ee,pe){var Se=ie[0],Re=Se.id();Se.isChildless()&&b(Se,pe),m[Re]=!0}});for(var E=[],C=0;C<a.length;C++){var x=a[C];m[x.id()]||E.push(x)}var T=function(ie){for(var he=p[ie],de=0;de<he.length;de++){var Ee=he[de];if(Ee==null){he.splice(de,1),de--;continue}Tl(Ee,{depth:ie,index:de})}},k=function(ie,he){for(var de=Ft(ie),Ee=ie.incomers().filter(function(xe){return xe.isNode()&&t.has(xe)}),pe=-1,Se=ie.id(),Re=0;Re<Ee.length;Re++){var Oe=Ee[Re],Ne=Ft(Oe);pe=Math.max(pe,Ne.depth)}if(de.depth<=pe){if(!r.acyclic&&he[Se])return null;var ze=pe+1;return w(ie,ze),he[Se]=ze,!0}return!1};if(i&&o){var D=[],B={},P=function(ie){return D.push(ie)},A=function(){return D.shift()};for(a.forEach(function(ye){return D.push(ye)});D.length>0;){var R=A(),L=k(R,B);if(L)R.outgoers().filter(function(ye){return ye.isNode()&&t.has(ye)}).forEach(P);else if(L===null){Ve("Detected double maximal shift for node `"+R.id()+"`.  Bailing maximal adjustment due to cycle.  Use `options.maximal: true` only on DAGs.");break}}}var I=0;if(r.avoidOverlap)for(var M=0;M<a.length;M++){var O=a[M],V=O.layoutDimensions(r),G=V.w,N=V.h;I=Math.max(I,G,N)}var F={},U=function(ie){if(F[ie.id()])return F[ie.id()];for(var he=Ft(ie).depth,de=ie.neighborhood(),Ee=0,pe=0,Se=0;Se<de.length;Se++){var Re=de[Se];if(!(Re.isEdge()||Re.isParent()||!a.has(Re))){var Oe=Ft(Re);if(Oe!=null){var Ne=Oe.index,ze=Oe.depth;if(!(Ne==null||ze==null)){var xe=p[ze].length;ze<he&&(Ee+=Ne/xe,pe++)}}}}return pe=Math.max(1,pe),Ee=Ee/pe,pe===0&&(Ee=0),F[ie.id()]=Ee,Ee},Q=function(ie,he){var de=U(ie),Ee=U(he),pe=de-Ee;return pe===0?nv(ie.id(),he.id()):pe};r.depthSort!==void 0&&(Q=r.depthSort);for(var K=p.length,j=0;j<K;j++)p[j].sort(Q),T(j);for(var re=[],ne=0;ne<E.length;ne++)re.push(E[ne]);var J=function(){for(var ie=0;ie<K;ie++)T(ie)};re.length&&(p.unshift(re),K=p.length,J());for(var z=0,q=0;q<K;q++)z=Math.max(p[q].length,z);var H={x:l.x1+l.w/2,y:l.y1+l.h/2},Y=a.reduce(function(ye,ie){return(function(he){return{w:ye.w===-1?he.w:(ye.w+he.w)/2,h:ye.h===-1?he.h:(ye.h+he.h)/2}})(ie.boundingBox({includeLabels:r.nodeDimensionsIncludeLabels}))},{w:-1,h:-1}),te=Math.max(K===1?0:s?(l.h-r.padding*2-Y.h)/(K-1):(l.h-r.padding*2-Y.h)/(K+1),I),ce=p.reduce(function(ye,ie){return Math.max(ye,ie.length)},0),Ae=function(ie){var he=Ft(ie),de=he.depth,Ee=he.index;if(r.circle){var pe=Math.min(l.w/2/K,l.h/2/K);pe=Math.max(pe,I);var Se=pe*de+pe-(K>0&&p[0].length<=3?pe/2:0),Re=2*Math.PI/p[de].length*Ee;return de===0&&p[0].length===1&&(Se=1),{x:H.x+Se*Math.cos(Re),y:H.y+Se*Math.sin(Re)}}else{var Oe=p[de].length,Ne=Math.max(Oe===1?0:s?(l.w-r.padding*2-Y.w)/((r.grid?ce:Oe)-1):(l.w-r.padding*2-Y.w)/((r.grid?ce:Oe)+1),I),ze={x:H.x+(Ee+1-(Oe+1)/2)*Ne,y:H.y+(de+1-(K+1)/2)*te};return ze}},Ce={downward:0,leftward:90,upward:180,rightward:-90};Object.keys(Ce).indexOf(r.direction)===-1&&$e("Invalid direction '".concat(r.direction,"' specified for breadthfirst layout. Valid values are: ").concat(Object.keys(Ce).join(", ")));var we=function(ie){return $c(Ae(ie),l,Ce[r.direction])};return t.nodes().layoutPositions(this,r,we),this};var Ap={fit:!0,padding:30,boundingBox:void 0,avoidOverlap:!0,nodeDimensionsIncludeLabels:!1,spacingFactor:void 0,radius:void 0,startAngle:3/2*Math.PI,sweep:void 0,clockwise:!0,sort:void 0,animate:!1,animationDuration:500,animationEasing:void 0,animateFilter:function(e,t){return!0},ready:void 0,stop:void 0,transform:function(e,t){return t}};function nf(r){this.options=be({},Ap,r)}nf.prototype.run=function(){var r=this.options,e=r,t=r.cy,a=e.eles,n=e.counterclockwise!==void 0?!e.counterclockwise:e.clockwise,i=a.nodes().not(":parent");e.sort&&(i=i.sort(e.sort));for(var o=wr(e.boundingBox?e.boundingBox:{x1:0,y1:0,w:t.width(),h:t.height()}),s={x:o.x1+o.w/2,y:o.y1+o.h/2},l=e.sweep===void 0?2*Math.PI-2*Math.PI/i.length:e.sweep,u=l/Math.max(1,i.length-1),v,f=0,c=0;c<i.length;c++){var d=i[c],h=d.layoutDimensions(e),y=h.w,g=h.h;f=Math.max(f,y,g)}if(ae(e.radius)?v=e.radius:i.length<=1?v=0:v=Math.min(o.h,o.w)/2-f,i.length>1&&e.avoidOverlap){f*=1.75;var p=Math.cos(u)-Math.cos(0),m=Math.sin(u)-Math.sin(0),b=Math.sqrt(f*f/(p*p+m*m));v=Math.max(b,v)}var w=function(C,x){var T=e.startAngle+x*u*(n?1:-1),k=v*Math.cos(T),D=v*Math.sin(T),B={x:s.x+k,y:s.y+D};return B};return a.nodes().layoutPositions(this,e,w),this};var Rp={fit:!0,padding:30,startAngle:3/2*Math.PI,sweep:void 0,clockwise:!0,equidistant:!1,minNodeSpacing:10,boundingBox:void 0,avoidOverlap:!0,nodeDimensionsIncludeLabels:!1,height:void 0,width:void 0,spacingFactor:void 0,concentric:function(e){return e.degree()},levelWidth:function(e){return e.maxDegree()/4},animate:!1,animationDuration:500,animationEasing:void 0,animateFilter:function(e,t){return!0},ready:void 0,stop:void 0,transform:function(e,t){return t}};function of(r){this.options=be({},Rp,r)}of.prototype.run=function(){for(var r=this.options,e=r,t=e.counterclockwise!==void 0?!e.counterclockwise:e.clockwise,a=r.cy,n=e.eles,i=n.nodes().not(":parent"),o=wr(e.boundingBox?e.boundingBox:{x1:0,y1:0,w:a.width(),h:a.height()}),s={x:o.x1+o.w/2,y:o.y1+o.h/2},l=[],u=0,v=0;v<i.length;v++){var f=i[v],c=void 0;c=e.concentric(f),l.push({value:c,node:f}),f._private.scratch.concentric=c}i.updateStyle();for(var d=0;d<i.length;d++){var h=i[d],y=h.layoutDimensions(e);u=Math.max(u,y.w,y.h)}l.sort(function(te,ce){return ce.value-te.value});for(var g=e.levelWidth(i),p=[[]],m=p[0],b=0;b<l.length;b++){var w=l[b];if(m.length>0){var E=Math.abs(m[0].value-w.value);E>=g&&(m=[],p.push(m))}m.push(w)}var C=u+e.minNodeSpacing;if(!e.avoidOverlap){var x=p.length>0&&p[0].length>1,T=Math.min(o.w,o.h)/2-C,k=T/(p.length+x?1:0);C=Math.min(C,k)}for(var D=0,B=0;B<p.length;B++){var P=p[B],A=e.sweep===void 0?2*Math.PI-2*Math.PI/P.length:e.sweep,R=P.dTheta=A/Math.max(1,P.length-1);if(P.length>1&&e.avoidOverlap){var L=Math.cos(R)-Math.cos(0),I=Math.sin(R)-Math.sin(0),M=Math.sqrt(C*C/(L*L+I*I));D=Math.max(M,D)}P.r=D,D+=C}if(e.equidistant){for(var O=0,V=0,G=0;G<p.length;G++){var N=p[G],F=N.r-V;O=Math.max(O,F)}V=0;for(var U=0;U<p.length;U++){var Q=p[U];U===0&&(V=Q.r),Q.r=V,V+=O}}for(var K={},j=0;j<p.length;j++)for(var re=p[j],ne=re.dTheta,J=re.r,z=0;z<re.length;z++){var q=re[z],H=e.startAngle+(t?1:-1)*ne*z,Y={x:s.x+J*Math.cos(H),y:s.y+J*Math.sin(H)};K[q.node.id()]=Y}return n.nodes().layoutPositions(this,e,function(te){var ce=te.id();return K[ce]}),this};var wo,Mp={ready:function(){},stop:function(){},animate:!0,animationEasing:void 0,animationDuration:void 0,animateFilter:function(e,t){return!0},animationThreshold:250,refresh:20,fit:!0,padding:30,boundingBox:void 0,nodeDimensionsIncludeLabels:!1,randomize:!1,componentSpacing:40,nodeRepulsion:function(e){return 2048},nodeOverlap:4,idealEdgeLength:function(e){return 32},edgeElasticity:function(e){return 32},nestingFactor:1.2,gravity:1,numIter:1e3,initialTemp:1e3,coolingFactor:.99,minTemp:1};function Kn(r){this.options=be({},Mp,r),this.options.layout=this;var e=this.options.eles.nodes(),t=this.options.eles.edges(),a=t.filter(function(n){var i=n.source().data("id"),o=n.target().data("id"),s=e.some(function(u){return u.data("id")===i}),l=e.some(function(u){return u.data("id")===o});return!s||!l});this.options.eles=this.options.eles.not(a)}Kn.prototype.run=function(){var r=this.options,e=r.cy,t=this;t.stopped=!1,(r.animate===!0||r.animate===!1)&&t.emit({type:"layoutstart",layout:t}),r.debug===!0?wo=!0:wo=!1;var a=Lp(e,t,r);wo&&Op(a),r.randomize&&Np(a);var n=Yr(),i=function(){zp(a,e,r),r.fit===!0&&e.fit(r.padding)},o=function(c){return!(t.stopped||c>=r.numIter||(Fp(a,r),a.temperature=a.temperature*r.coolingFactor,a.temperature<r.minTemp))},s=function(){if(r.animate===!0||r.animate===!1)i(),t.one("layoutstop",r.stop),t.emit({type:"layoutstop",layout:t});else{var c=r.eles.nodes(),d=uf(a,r,c);c.layoutPositions(t,r,d)}},l=0,u=!0;if(r.animate===!0){var v=function(){for(var c=0;u&&c<r.refresh;)u=o(l),l++,c++;if(!u)kl(a,r),s();else{var d=Yr();d-n>=r.animationThreshold&&i(),wn(v)}};v()}else{for(;u;)u=o(l),l++;kl(a,r),s()}return this};Kn.prototype.stop=function(){return this.stopped=!0,this.thread&&this.thread.stop(),this.emit("layoutstop"),this};Kn.prototype.destroy=function(){return this.thread&&this.thread.stop(),this};var Lp=function(e,t,a){for(var n=a.eles.edges(),i=a.eles.nodes(),o=wr(a.boundingBox?a.boundingBox:{x1:0,y1:0,w:e.width(),h:e.height()}),s={isCompound:e.hasCompoundNodes(),layoutNodes:[],idToIndex:{},nodeSize:i.size(),graphSet:[],indexToGraph:[],layoutEdges:[],edgeSize:n.size(),temperature:a.initialTemp,clientWidth:o.w,clientHeight:o.h,boundingBox:o},l=a.eles.components(),u={},v=0;v<l.length;v++)for(var f=l[v],c=0;c<f.length;c++){var d=f[c];u[d.id()]=v}for(var v=0;v<s.nodeSize;v++){var h=i[v],y=h.layoutDimensions(a),g={};g.isLocked=h.locked(),g.id=h.data("id"),g.parentId=h.data("parent"),g.cmptId=u[h.id()],g.children=[],g.positionX=h.position("x"),g.positionY=h.position("y"),g.offsetX=0,g.offsetY=0,g.height=y.w,g.width=y.h,g.maxX=g.positionX+g.width/2,g.minX=g.positionX-g.width/2,g.maxY=g.positionY+g.height/2,g.minY=g.positionY-g.height/2,g.padLeft=parseFloat(h.style("padding")),g.padRight=parseFloat(h.style("padding")),g.padTop=parseFloat(h.style("padding")),g.padBottom=parseFloat(h.style("padding")),g.nodeRepulsion=Ue(a.nodeRepulsion)?a.nodeRepulsion(h):a.nodeRepulsion,s.layoutNodes.push(g),s.idToIndex[g.id]=v}for(var p=[],m=0,b=-1,w=[],v=0;v<s.nodeSize;v++){var h=s.layoutNodes[v],E=h.parentId;E!=null?s.layoutNodes[s.idToIndex[E]].children.push(h.id):(p[++b]=h.id,w.push(h.id))}for(s.graphSet.push(w);m<=b;){var C=p[m++],x=s.idToIndex[C],d=s.layoutNodes[x],T=d.children;if(T.length>0){s.graphSet.push(T);for(var v=0;v<T.length;v++)p[++b]=T[v]}}for(var v=0;v<s.graphSet.length;v++)for(var k=s.graphSet[v],c=0;c<k.length;c++){var D=s.idToIndex[k[c]];s.indexToGraph[D]=v}for(var v=0;v<s.edgeSize;v++){var B=n[v],P={};P.id=B.data("id"),P.sourceId=B.data("source"),P.targetId=B.data("target");var A=Ue(a.idealEdgeLength)?a.idealEdgeLength(B):a.idealEdgeLength,R=Ue(a.edgeElasticity)?a.edgeElasticity(B):a.edgeElasticity,L=s.idToIndex[P.sourceId],I=s.idToIndex[P.targetId],M=s.indexToGraph[L],O=s.indexToGraph[I];if(M!=O){for(var V=Ip(P.sourceId,P.targetId,s),G=s.graphSet[V],N=0,g=s.layoutNodes[L];G.indexOf(g.id)===-1;)g=s.layoutNodes[s.idToIndex[g.parentId]],N++;for(g=s.layoutNodes[I];G.indexOf(g.id)===-1;)g=s.layoutNodes[s.idToIndex[g.parentId]],N++;A*=N*a.nestingFactor}P.idealLength=A,P.elasticity=R,s.layoutEdges.push(P)}return s},Ip=function(e,t,a){var n=sf(e,t,0,a);return 2>n.count?0:n.graph},sf=function(e,t,a,n){var i=n.graphSet[a];if(-1<i.indexOf(e)&&-1<i.indexOf(t))return{count:2,graph:a};for(var o=0,s=0;s<i.length;s++){var l=i[s],u=n.idToIndex[l],v=n.layoutNodes[u].children;if(v.length!==0){var f=n.indexToGraph[n.idToIndex[v[0]]],c=sf(e,t,f,n);if(c.count!==0)if(c.count===1){if(o++,o===2)break}else return c}}return{count:o,graph:a}},Op,Np=function(e,t){for(var a=e.clientWidth,n=e.clientHeight,i=0;i<e.nodeSize;i++){var o=e.layoutNodes[i];o.children.length===0&&!o.isLocked&&(o.positionX=Math.random()*a,o.positionY=Math.random()*n)}},uf=function(e,t,a){var n=e.boundingBox,i={x1:1/0,x2:-1/0,y1:1/0,y2:-1/0};return t.boundingBox&&(a.forEach(function(o){var s=e.layoutNodes[e.idToIndex[o.data("id")]];i.x1=Math.min(i.x1,s.positionX),i.x2=Math.max(i.x2,s.positionX),i.y1=Math.min(i.y1,s.positionY),i.y2=Math.max(i.y2,s.positionY)}),i.w=i.x2-i.x1,i.h=i.y2-i.y1),function(o,s){var l=e.layoutNodes[e.idToIndex[o.data("id")]];if(t.boundingBox){var u=i.w===0?.5:(l.positionX-i.x1)/i.w,v=i.h===0?.5:(l.positionY-i.y1)/i.h;return{x:n.x1+u*n.w,y:n.y1+v*n.h}}else return{x:l.positionX,y:l.positionY}}},zp=function(e,t,a){var n=a.layout,i=a.eles.nodes(),o=uf(e,a,i);i.positions(o),e.ready!==!0&&(e.ready=!0,n.one("layoutready",a.ready),n.emit({type:"layoutready",layout:this}))},Fp=function(e,t,a){Vp(e,t),Gp(e),Hp(e,t),Wp(e),$p(e)},Vp=function(e,t){for(var a=0;a<e.graphSet.length;a++)for(var n=e.graphSet[a],i=n.length,o=0;o<i;o++)for(var s=e.layoutNodes[e.idToIndex[n[o]]],l=o+1;l<i;l++){var u=e.layoutNodes[e.idToIndex[n[l]]];qp(s,u,e,t)}},Sl=function(e){return-1+2*e*Math.random()},qp=function(e,t,a,n){var i=e.cmptId,o=t.cmptId;if(!(i!==o&&!a.isCompound)){var s=t.positionX-e.positionX,l=t.positionY-e.positionY,u=1;s===0&&l===0&&(s=Sl(u),l=Sl(u));var v=_p(e,t,s,l);if(v>0)var f=n.nodeOverlap*v,c=Math.sqrt(s*s+l*l),d=f*s/c,h=f*l/c;else var y=Dn(e,s,l),g=Dn(t,-1*s,-1*l),p=g.x-y.x,m=g.y-y.y,b=p*p+m*m,c=Math.sqrt(b),f=(e.nodeRepulsion+t.nodeRepulsion)/b,d=f*p/c,h=f*m/c;e.isLocked||(e.offsetX-=d,e.offsetY-=h),t.isLocked||(t.offsetX+=d,t.offsetY+=h)}},_p=function(e,t,a,n){if(a>0)var i=e.maxX-t.minX;else var i=t.maxX-e.minX;if(n>0)var o=e.maxY-t.minY;else var o=t.maxY-e.minY;return i>=0&&o>=0?Math.sqrt(i*i+o*o):0},Dn=function(e,t,a){var n=e.positionX,i=e.positionY,o=e.height||1,s=e.width||1,l=a/t,u=o/s,v={};return t===0&&0<a||t===0&&0>a?(v.x=n,v.y=i+o/2,v):0<t&&-1*u<=l&&l<=u?(v.x=n+s/2,v.y=i+s*a/2/t,v):0>t&&-1*u<=l&&l<=u?(v.x=n-s/2,v.y=i-s*a/2/t,v):0<a&&(l<=-1*u||l>=u)?(v.x=n+o*t/2/a,v.y=i+o/2,v):(0>a&&(l<=-1*u||l>=u)&&(v.x=n-o*t/2/a,v.y=i-o/2),v)},Gp=function(e,t){for(var a=0;a<e.edgeSize;a++){var n=e.layoutEdges[a],i=e.idToIndex[n.sourceId],o=e.layoutNodes[i],s=e.idToIndex[n.targetId],l=e.layoutNodes[s],u=l.positionX-o.positionX,v=l.positionY-o.positionY;if(!(u===0&&v===0)){var f=Dn(o,u,v),c=Dn(l,-1*u,-1*v),d=c.x-f.x,h=c.y-f.y,y=Math.sqrt(d*d+h*h),g=Math.pow(n.idealLength-y,2)/n.elasticity;if(y!==0)var p=g*d/y,m=g*h/y;else var p=0,m=0;o.isLocked||(o.offsetX+=p,o.offsetY+=m),l.isLocked||(l.offsetX-=p,l.offsetY-=m)}}},Hp=function(e,t){if(t.gravity!==0)for(var a=1,n=0;n<e.graphSet.length;n++){var i=e.graphSet[n],o=i.length;if(n===0)var s=e.clientHeight/2,l=e.clientWidth/2;else var u=e.layoutNodes[e.idToIndex[i[0]]],v=e.layoutNodes[e.idToIndex[u.parentId]],s=v.positionX,l=v.positionY;for(var f=0;f<o;f++){var c=e.layoutNodes[e.idToIndex[i[f]]];if(!c.isLocked){var d=s-c.positionX,h=l-c.positionY,y=Math.sqrt(d*d+h*h);if(y>a){var g=t.gravity*d/y,p=t.gravity*h/y;c.offsetX+=g,c.offsetY+=p}}}}},Wp=function(e,t){var a=[],n=0,i=-1;for(a.push.apply(a,e.graphSet[0]),i+=e.graphSet[0].length;n<=i;){var o=a[n++],s=e.idToIndex[o],l=e.layoutNodes[s],u=l.children;if(0<u.length&&!l.isLocked){for(var v=l.offsetX,f=l.offsetY,c=0;c<u.length;c++){var d=e.layoutNodes[e.idToIndex[u[c]]];d.offsetX+=v,d.offsetY+=f,a[++i]=u[c]}l.offsetX=0,l.offsetY=0}}},$p=function(e,t){for(var a=0;a<e.nodeSize;a++){var n=e.layoutNodes[a];0<n.children.length&&(n.maxX=void 0,n.minX=void 0,n.maxY=void 0,n.minY=void 0)}for(var a=0;a<e.nodeSize;a++){var n=e.layoutNodes[a];if(!(0<n.children.length||n.isLocked)){var i=Up(n.offsetX,n.offsetY,e.temperature);n.positionX+=i.x,n.positionY+=i.y,n.offsetX=0,n.offsetY=0,n.minX=n.positionX-n.width,n.maxX=n.positionX+n.width,n.minY=n.positionY-n.height,n.maxY=n.positionY+n.height,lf(n,e)}}for(var a=0;a<e.nodeSize;a++){var n=e.layoutNodes[a];0<n.children.length&&!n.isLocked&&(n.positionX=(n.maxX+n.minX)/2,n.positionY=(n.maxY+n.minY)/2,n.width=n.maxX-n.minX,n.height=n.maxY-n.minY)}},Up=function(e,t,a){var n=Math.sqrt(e*e+t*t);if(n>a)var i={x:a*e/n,y:a*t/n};else var i={x:e,y:t};return i},lf=function(e,t){var a=e.parentId;if(a!=null){var n=t.layoutNodes[t.idToIndex[a]],i=!1;if((n.maxX==null||e.maxX+n.padRight>n.maxX)&&(n.maxX=e.maxX+n.padRight,i=!0),(n.minX==null||e.minX-n.padLeft<n.minX)&&(n.minX=e.minX-n.padLeft,i=!0),(n.maxY==null||e.maxY+n.padBottom>n.maxY)&&(n.maxY=e.maxY+n.padBottom,i=!0),(n.minY==null||e.minY-n.padTop<n.minY)&&(n.minY=e.minY-n.padTop,i=!0),i)return lf(n,t)}},kl=function(e,t){for(var a=e.layoutNodes,n=[],i=0;i<a.length;i++){var o=a[i],s=o.cmptId,l=n[s]=n[s]||[];l.push(o)}for(var u=0,i=0;i<n.length;i++){var v=n[i];if(v){v.x1=1/0,v.x2=-1/0,v.y1=1/0,v.y2=-1/0;for(var f=0;f<v.length;f++){var c=v[f];v.x1=Math.min(v.x1,c.positionX-c.width/2),v.x2=Math.max(v.x2,c.positionX+c.width/2),v.y1=Math.min(v.y1,c.positionY-c.height/2),v.y2=Math.max(v.y2,c.positionY+c.height/2)}v.w=v.x2-v.x1,v.h=v.y2-v.y1,u+=v.w*v.h}}n.sort(function(m,b){return b.w*b.h-m.w*m.h});for(var d=0,h=0,y=0,g=0,p=Math.sqrt(u)*e.clientWidth/e.clientHeight,i=0;i<n.length;i++){var v=n[i];if(v){for(var f=0;f<v.length;f++){var c=v[f];c.isLocked||(c.positionX+=d-v.x1,c.positionY+=h-v.y1)}d+=v.w+t.componentSpacing,y+=v.w+t.componentSpacing,g=Math.max(g,v.h),y>p&&(h+=g+t.componentSpacing,d=0,y=0,g=0)}}},Kp={fit:!0,padding:30,boundingBox:void 0,avoidOverlap:!0,avoidOverlapPadding:10,nodeDimensionsIncludeLabels:!1,spacingFactor:void 0,condense:!1,rows:void 0,cols:void 0,position:function(e){},sort:void 0,animate:!1,animationDuration:500,animationEasing:void 0,animateFilter:function(e,t){return!0},ready:void 0,stop:void 0,transform:function(e,t){return t}};function vf(r){this.options=be({},Kp,r)}vf.prototype.run=function(){var r=this.options,e=r,t=r.cy,a=e.eles,n=a.nodes().not(":parent");e.sort&&(n=n.sort(e.sort));var i=wr(e.boundingBox?e.boundingBox:{x1:0,y1:0,w:t.width(),h:t.height()});if(i.h===0||i.w===0)a.nodes().layoutPositions(this,e,function(U){return{x:i.x1,y:i.y1}});else{var o=n.size(),s=Math.sqrt(o*i.h/i.w),l=Math.round(s),u=Math.round(i.w/i.h*s),v=function(Q){if(Q==null)return Math.min(l,u);var K=Math.min(l,u);K==l?l=Q:u=Q},f=function(Q){if(Q==null)return Math.max(l,u);var K=Math.max(l,u);K==l?l=Q:u=Q},c=e.rows,d=e.cols!=null?e.cols:e.columns;if(c!=null&&d!=null)l=c,u=d;else if(c!=null&&d==null)l=c,u=Math.ceil(o/l);else if(c==null&&d!=null)u=d,l=Math.ceil(o/u);else if(u*l>o){var h=v(),y=f();(h-1)*y>=o?v(h-1):(y-1)*h>=o&&f(y-1)}else for(;u*l<o;){var g=v(),p=f();(p+1)*g>=o?f(p+1):v(g+1)}var m=i.w/u,b=i.h/l;if(e.condense&&(m=0,b=0),e.avoidOverlap)for(var w=0;w<n.length;w++){var E=n[w],C=E._private.position;(C.x==null||C.y==null)&&(C.x=0,C.y=0);var x=E.layoutDimensions(e),T=e.avoidOverlapPadding,k=x.w+T,D=x.h+T;m=Math.max(m,k),b=Math.max(b,D)}for(var B={},P=function(Q,K){return!!B["c-"+Q+"-"+K]},A=function(Q,K){B["c-"+Q+"-"+K]=!0},R=0,L=0,I=function(){L++,L>=u&&(L=0,R++)},M={},O=0;O<n.length;O++){var V=n[O],G=e.position(V);if(G&&(G.row!==void 0||G.col!==void 0)){var N={row:G.row,col:G.col};if(N.col===void 0)for(N.col=0;P(N.row,N.col);)N.col++;else if(N.row===void 0)for(N.row=0;P(N.row,N.col);)N.row++;M[V.id()]=N,A(N.row,N.col)}}var F=function(Q,K){var j,re;if(Q.locked()||Q.isParent())return!1;var ne=M[Q.id()];if(ne)j=ne.col*m+m/2+i.x1,re=ne.row*b+b/2+i.y1;else{for(;P(R,L);)I();j=L*m+m/2+i.x1,re=R*b+b/2+i.y1,A(R,L),I()}return{x:j,y:re}};n.layoutPositions(this,e,F)}return this};var Xp={ready:function(){},stop:function(){}};function ds(r){this.options=be({},Xp,r)}ds.prototype.run=function(){var r=this.options,e=r.eles,t=this;return r.cy,t.emit("layoutstart"),e.nodes().positions(function(){return{x:0,y:0}}),t.one("layoutready",r.ready),t.emit("layoutready"),t.one("layoutstop",r.stop),t.emit("layoutstop"),this};ds.prototype.stop=function(){return this};var Yp={positions:void 0,zoom:void 0,pan:void 0,fit:!0,padding:30,spacingFactor:void 0,animate:!1,animationDuration:500,animationEasing:void 0,animateFilter:function(e,t){return!0},ready:void 0,stop:void 0,transform:function(e,t){return t}};function ff(r){this.options=be({},Yp,r)}ff.prototype.run=function(){var r=this.options,e=r.eles,t=e.nodes(),a=Ue(r.positions);function n(i){if(r.positions==null)return yh(i.position());if(a)return r.positions(i);var o=r.positions[i._private.data.id];return o??null}return t.layoutPositions(this,r,function(i,o){var s=n(i);return i.locked()||s==null?!1:s}),this};var Zp={fit:!0,padding:30,boundingBox:void 0,animate:!1,animationDuration:500,animationEasing:void 0,animateFilter:function(e,t){return!0},ready:void 0,stop:void 0,transform:function(e,t){return t}};function cf(r){this.options=be({},Zp,r)}cf.prototype.run=function(){var r=this.options,e=r.cy,t=r.eles,a=wr(r.boundingBox?r.boundingBox:{x1:0,y1:0,w:e.width(),h:e.height()}),n=function(o,s){return{x:a.x1+Math.round(Math.random()*a.w),y:a.y1+Math.round(Math.random()*a.h)}};return t.nodes().layoutPositions(this,r,n),this};var Qp=[{name:"breadthfirst",impl:af},{name:"circle",impl:nf},{name:"concentric",impl:of},{name:"cose",impl:Kn},{name:"grid",impl:vf},{name:"null",impl:ds},{name:"preset",impl:ff},{name:"random",impl:cf}];function hf(r){this.options=r,this.notifications=0}var Dl=function(){},Bl=function(){throw new Error("A headless instance can not render images")};hf.prototype={recalculateRenderedStyle:Dl,notify:function(){this.notifications++},init:Dl,isHeadless:function(){return!0},png:Bl,jpg:Bl};var gs={};gs.arrowShapeWidth=.3;gs.registerArrowShapes=function(){var r=this.arrowShapes={},e=this,t=function(u,v,f,c,d,h,y){var g=d.x-f/2-y,p=d.x+f/2+y,m=d.y-f/2-y,b=d.y+f/2+y,w=g<=u&&u<=p&&m<=v&&v<=b;return w},a=function(u,v,f,c,d){var h=u*Math.cos(c)-v*Math.sin(c),y=u*Math.sin(c)+v*Math.cos(c),g=h*f,p=y*f,m=g+d.x,b=p+d.y;return{x:m,y:b}},n=function(u,v,f,c){for(var d=[],h=0;h<u.length;h+=2){var y=u[h],g=u[h+1];d.push(a(y,g,v,f,c))}return d},i=function(u){for(var v=[],f=0;f<u.length;f++){var c=u[f];v.push(c.x,c.y)}return v},o=function(u){return u.pstyle("width").pfValue*u.pstyle("arrow-scale").pfValue*2},s=function(u,v){ge(v)&&(v=r[v]),r[u]=be({name:u,points:[-.15,-.3,.15,-.3,.15,.3,-.15,.3],collide:function(c,d,h,y,g,p){var m=i(n(this.points,h+2*p,y,g)),b=Sr(c,d,m);return b},roughCollide:t,draw:function(c,d,h,y){var g=n(this.points,d,h,y);e.arrowShapeImpl("polygon")(c,g)},spacing:function(c){return 0},gap:o},v)};s("none",{collide:xn,roughCollide:xn,draw:es,spacing:Gs,gap:Gs}),s("triangle",{points:[-.15,-.3,0,0,.15,-.3]}),s("arrow","triangle"),s("triangle-backcurve",{points:r.triangle.points,controlPoint:[0,-.15],roughCollide:t,draw:function(u,v,f,c,d){var h=n(this.points,v,f,c),y=this.controlPoint,g=a(y[0],y[1],v,f,c);e.arrowShapeImpl(this.name)(u,h,g)},gap:function(u){return o(u)*.8}}),s("triangle-tee",{points:[0,0,.15,-.3,-.15,-.3,0,0],pointsTee:[-.15,-.4,-.15,-.5,.15,-.5,.15,-.4],collide:function(u,v,f,c,d,h,y){var g=i(n(this.points,f+2*y,c,d)),p=i(n(this.pointsTee,f+2*y,c,d)),m=Sr(u,v,g)||Sr(u,v,p);return m},draw:function(u,v,f,c,d){var h=n(this.points,v,f,c),y=n(this.pointsTee,v,f,c);e.arrowShapeImpl(this.name)(u,h,y)}}),s("circle-triangle",{radius:.15,pointsTr:[0,-.15,.15,-.45,-.15,-.45,0,-.15],collide:function(u,v,f,c,d,h,y){var g=d,p=Math.pow(g.x-u,2)+Math.pow(g.y-v,2)<=Math.pow((f+2*y)*this.radius,2),m=i(n(this.points,f+2*y,c,d));return Sr(u,v,m)||p},draw:function(u,v,f,c,d){var h=n(this.pointsTr,v,f,c);e.arrowShapeImpl(this.name)(u,h,c.x,c.y,this.radius*v)},spacing:function(u){return e.getArrowWidth(u.pstyle("width").pfValue,u.pstyle("arrow-scale").value)*this.radius}}),s("triangle-cross",{points:[0,0,.15,-.3,-.15,-.3,0,0],baseCrossLinePts:[-.15,-.4,-.15,-.4,.15,-.4,.15,-.4],crossLinePts:function(u,v){var f=this.baseCrossLinePts.slice(),c=v/u,d=3,h=5;return f[d]=f[d]-c,f[h]=f[h]-c,f},collide:function(u,v,f,c,d,h,y){var g=i(n(this.points,f+2*y,c,d)),p=i(n(this.crossLinePts(f,h),f+2*y,c,d)),m=Sr(u,v,g)||Sr(u,v,p);return m},draw:function(u,v,f,c,d){var h=n(this.points,v,f,c),y=n(this.crossLinePts(v,d),v,f,c);e.arrowShapeImpl(this.name)(u,h,y)}}),s("vee",{points:[-.15,-.3,0,0,.15,-.3,0,-.15],gap:function(u){return o(u)*.525}}),s("circle",{radius:.15,collide:function(u,v,f,c,d,h,y){var g=d,p=Math.pow(g.x-u,2)+Math.pow(g.y-v,2)<=Math.pow((f+2*y)*this.radius,2);return p},draw:function(u,v,f,c,d){e.arrowShapeImpl(this.name)(u,c.x,c.y,this.radius*v)},spacing:function(u){return e.getArrowWidth(u.pstyle("width").pfValue,u.pstyle("arrow-scale").value)*this.radius}}),s("tee",{points:[-.15,0,-.15,-.1,.15,-.1,.15,0],spacing:function(u){return 1},gap:function(u){return 1}}),s("square",{points:[-.15,0,.15,0,.15,-.3,-.15,-.3]}),s("diamond",{points:[-.15,-.15,0,-.3,.15,-.15,0,0],gap:function(u){return u.pstyle("width").pfValue*u.pstyle("arrow-scale").value}}),s("chevron",{points:[0,0,-.15,-.15,-.1,-.2,0,-.1,.1,-.2,.15,-.15],gap:function(u){return .95*u.pstyle("width").pfValue*u.pstyle("arrow-scale").value}})};var Mt={};Mt.projectIntoViewport=function(r,e){var t=this.cy,a=this.findContainerClientCoords(),n=a[0],i=a[1],o=a[4],s=t.pan(),l=t.zoom(),u=((r-n)/o-s.x)/l,v=((e-i)/o-s.y)/l;return[u,v]};Mt.findContainerClientCoords=function(){if(this.containerBB)return this.containerBB;var r=this.container,e=r.getBoundingClientRect(),t=this.cy.window().getComputedStyle(r),a=function(p){return parseFloat(t.getPropertyValue(p))},n={left:a("padding-left"),right:a("padding-right"),top:a("padding-top"),bottom:a("padding-bottom")},i={left:a("border-left-width"),right:a("border-right-width"),top:a("border-top-width"),bottom:a("border-bottom-width")},o=r.clientWidth,s=r.clientHeight,l=n.left+n.right,u=n.top+n.bottom,v=i.left+i.right,f=e.width/(o+v),c=o-l,d=s-u,h=e.left+n.left+i.left,y=e.top+n.top+i.top;return this.containerBB=[h,y,c,d,f]};Mt.invalidateContainerClientCoordsCache=function(){this.containerBB=null};Mt.findNearestElement=function(r,e,t,a){return this.findNearestElements(r,e,t,a)[0]};Mt.findNearestElements=function(r,e,t,a){var n=this,i=this,o=i.getCachedZSortedEles(),s=[],l=i.cy.zoom(),u=i.cy.hasCompoundNodes(),v=(a?24:8)/l,f=(a?8:2)/l,c=(a?8:2)/l,d=1/0,h,y;t&&(o=o.interactive);function g(x,T){if(x.isNode()){if(y)return;y=x,s.push(x)}if(x.isEdge()&&(T==null||T<d))if(h){if(h.pstyle("z-compound-depth").value===x.pstyle("z-compound-depth").value&&h.pstyle("z-compound-depth").value===x.pstyle("z-compound-depth").value){for(var k=0;k<s.length;k++)if(s[k].isEdge()){s[k]=x,h=x,d=T??d;break}}}else s.push(x),h=x,d=T??d}function p(x){var T=x.outerWidth()+2*f,k=x.outerHeight()+2*f,D=T/2,B=k/2,P=x.position(),A=x.pstyle("corner-radius").value==="auto"?"auto":x.pstyle("corner-radius").pfValue,R=x._private.rscratch;if(P.x-D<=r&&r<=P.x+D&&P.y-B<=e&&e<=P.y+B){var L=i.nodeShapes[n.getNodeShape(x)];if(L.checkPoint(r,e,0,T,k,P.x,P.y,A,R))return g(x,0),!0}}function m(x){var T=x._private,k=T.rscratch,D=x.pstyle("width").pfValue,B=x.pstyle("arrow-scale").value,P=D/2+v,A=P*P,R=P*2,O=T.source,V=T.target,L;if(k.edgeType==="segments"||k.edgeType==="straight"||k.edgeType==="haystack"){for(var I=k.allpts,M=0;M+3<I.length;M+=2)if(Rh(r,e,I[M],I[M+1],I[M+2],I[M+3],R)&&A>(L=Nh(r,e,I[M],I[M+1],I[M+2],I[M+3])))return g(x,L),!0}else if(k.edgeType==="bezier"||k.edgeType==="multibezier"||k.edgeType==="self"||k.edgeType==="compound"){for(var I=k.allpts,M=0;M+5<k.allpts.length;M+=4)if(Mh(r,e,I[M],I[M+1],I[M+2],I[M+3],I[M+4],I[M+5],R)&&A>(L=Oh(r,e,I[M],I[M+1],I[M+2],I[M+3],I[M+4],I[M+5])))return g(x,L),!0}for(var O=O||T.source,V=V||T.target,G=n.getArrowWidth(D,B),N=[{name:"source",x:k.arrowStartX,y:k.arrowStartY,angle:k.srcArrowAngle},{name:"target",x:k.arrowEndX,y:k.arrowEndY,angle:k.tgtArrowAngle},{name:"mid-source",x:k.midX,y:k.midY,angle:k.midsrcArrowAngle},{name:"mid-target",x:k.midX,y:k.midY,angle:k.midtgtArrowAngle}],M=0;M<N.length;M++){var F=N[M],U=i.arrowShapes[x.pstyle(F.name+"-arrow-shape").value],Q=x.pstyle("width").pfValue;if(U.roughCollide(r,e,G,F.angle,{x:F.x,y:F.y},Q,v)&&U.collide(r,e,G,F.angle,{x:F.x,y:F.y},Q,v))return g(x),!0}u&&s.length>0&&(p(O),p(V))}function b(x,T,k){return Tr(x,T,k)}function w(x,T){var k=x._private,D=c,B;T?B=T+"-":B="",x.boundingBox();var P=k.labelBounds[T||"main"],A=x.pstyle(B+"label").value,R=x.pstyle("text-events").strValue==="yes";if(!(!R||!A)){var L=b(k.rscratch,"labelX",T),I=b(k.rscratch,"labelY",T),M=b(k.rscratch,"labelAngle",T),O=x.pstyle(B+"text-margin-x").pfValue,V=x.pstyle(B+"text-margin-y").pfValue,G=P.x1-D-O,N=P.x2+D-O,F=P.y1-D-V,U=P.y2+D-V;if(M){var Q=Math.cos(M),K=Math.sin(M),j=function(Y,te){return Y=Y-L,te=te-I,{x:Y*Q-te*K+L,y:Y*K+te*Q+I}},re=j(G,F),ne=j(G,U),J=j(N,F),z=j(N,U),q=[re.x+O,re.y+V,J.x+O,J.y+V,z.x+O,z.y+V,ne.x+O,ne.y+V];if(Sr(r,e,q))return g(x),!0}else if(nt(P,r,e))return g(x),!0}}for(var E=o.length-1;E>=0;E--){var C=o[E];C.isNode()?p(C)||w(C):m(C)||w(C)||w(C,"source")||w(C,"target")}return s};Mt.getAllInBox=function(r,e,t,a){var n=this.getCachedZSortedEles().interactive,i=this.cy.zoom(),o=2/i,s=[],l=Math.min(r,t),u=Math.max(r,t),v=Math.min(e,a),f=Math.max(e,a);r=l,t=u,e=v,a=f;var c=wr({x1:r,y1:e,x2:t,y2:a}),d=[{x:c.x1,y:c.y1},{x:c.x2,y:c.y1},{x:c.x2,y:c.y2},{x:c.x1,y:c.y2}],h=[[d[0],d[1]],[d[1],d[2]],[d[2],d[3]],[d[3],d[0]]];function y(Y,te,ce){return Tr(Y,te,ce)}function g(Y,te){var ce=Y._private,Ae=o,Ce="";Y.boundingBox();var we=ce.labelBounds.main;if(!we)return null;var ye=y(ce.rscratch,"labelX",te),ie=y(ce.rscratch,"labelY",te),he=y(ce.rscratch,"labelAngle",te),de=Y.pstyle(Ce+"text-margin-x").pfValue,Ee=Y.pstyle(Ce+"text-margin-y").pfValue,pe=we.x1-Ae-de,Se=we.x2+Ae-de,Re=we.y1-Ae-Ee,Oe=we.y2+Ae-Ee;if(he){var Ne=Math.cos(he),ze=Math.sin(he),xe=function(X,S){return X=X-ye,S=S-ie,{x:X*Ne-S*ze+ye,y:X*ze+S*Ne+ie}};return[xe(pe,Re),xe(Se,Re),xe(Se,Oe),xe(pe,Oe)]}else return[{x:pe,y:Re},{x:Se,y:Re},{x:Se,y:Oe},{x:pe,y:Oe}]}function p(Y,te,ce,Ae){function Ce(we,ye,ie){return(ie.y-we.y)*(ye.x-we.x)>(ye.y-we.y)*(ie.x-we.x)}return Ce(Y,ce,Ae)!==Ce(te,ce,Ae)&&Ce(Y,te,ce)!==Ce(Y,te,Ae)}for(var m=0;m<n.length;m++){var b=n[m];if(b.isNode()){var w=b,E=w.pstyle("text-events").strValue==="yes",C=w.pstyle("box-selection").strValue,x=w.pstyle("box-select-labels").strValue==="yes";if(C==="none")continue;var T=(C==="overlap"||x)&&E,k=w.boundingBox({includeNodes:!0,includeEdges:!1,includeLabels:T});if(C==="contain"){var D=!1;if(x&&E){var B=g(w);B&&yi(B,d)&&(s.push(w),D=!0)}!D&&bv(c,k)&&s.push(w)}else if(C==="overlap"&&ns(c,k)){var P=w.boundingBox({includeNodes:!0,includeEdges:!0,includeLabels:!1,includeMainLabels:!1,includeSourceLabels:!1,includeTargetLabels:!1}),A=[{x:P.x1,y:P.y1},{x:P.x2,y:P.y1},{x:P.x2,y:P.y2},{x:P.x1,y:P.y2}];if(yi(A,d))s.push(w);else{var R=g(w);R&&yi(R,d)&&s.push(w)}}}else{var L=b,I=L._private,M=I.rscratch,O=L.pstyle("box-selection").strValue;if(O==="none")continue;if(O==="contain"){if(M.startX!=null&&M.startY!=null&&!nt(c,M.startX,M.startY)||M.endX!=null&&M.endY!=null&&!nt(c,M.endX,M.endY))continue;if(M.edgeType==="bezier"||M.edgeType==="multibezier"||M.edgeType==="self"||M.edgeType==="compound"||M.edgeType==="segments"||M.edgeType==="haystack"){for(var V=I.rstyle.bezierPts||I.rstyle.linePts||I.rstyle.haystackPts,G=!0,N=0;N<V.length;N++)if(!Ks(c,V[N])){G=!1;break}G&&s.push(L)}else M.edgeType==="straight"&&s.push(L)}else if(O==="overlap"){var F=!1;if(M.startX!=null&&M.startY!=null&&M.endX!=null&&M.endY!=null&&(nt(c,M.startX,M.startY)||nt(c,M.endX,M.endY)))s.push(L),F=!0;else if(!F&&M.edgeType==="haystack"){for(var U=I.rstyle.haystackPts,Q=0;Q<U.length;Q++)if(Ks(c,U[Q])){s.push(L),F=!0;break}}if(!F){var K=I.rstyle.bezierPts||I.rstyle.linePts||I.rstyle.haystackPts;if((!K||K.length<2)&&M.edgeType==="straight"&&M.startX!=null&&M.startY!=null&&M.endX!=null&&M.endY!=null&&(K=[{x:M.startX,y:M.startY},{x:M.endX,y:M.endY}]),!K||K.length<2)continue;for(var j=0;j<K.length-1;j++){for(var re=K[j],ne=K[j+1],J=0;J<h.length;J++){var z=Je(h[J],2),q=z[0],H=z[1];if(p(re,ne,q,H)){s.push(L),F=!0;break}}if(F)break}}}}}return s};var Bn={};Bn.calculateArrowAngles=function(r){var e=r._private.rscratch,t=e.edgeType==="haystack",a=e.edgeType==="bezier",n=e.edgeType==="multibezier",i=e.edgeType==="segments",o=e.edgeType==="compound",s=e.edgeType==="self",l,u,v,f,c,d,p,m;if(t?(v=e.haystackPts[0],f=e.haystackPts[1],c=e.haystackPts[2],d=e.haystackPts[3]):(v=e.arrowStartX,f=e.arrowStartY,c=e.arrowEndX,d=e.arrowEndY),p=e.midX,m=e.midY,i)l=v-e.segpts[0],u=f-e.segpts[1];else if(n||o||s||a){var h=e.allpts,y=or(h[0],h[2],h[4],.1),g=or(h[1],h[3],h[5],.1);l=v-y,u=f-g}else l=v-p,u=f-m;e.srcArrowAngle=Ya(l,u);var p=e.midX,m=e.midY;if(t&&(p=(v+c)/2,m=(f+d)/2),l=c-v,u=d-f,i){var h=e.allpts;if(h.length/2%2===0){var b=h.length/2,w=b-2;l=h[b]-h[w],u=h[b+1]-h[w+1]}else if(e.isRound)l=e.midVector[1],u=-e.midVector[0];else{var b=h.length/2-1,w=b-2;l=h[b]-h[w],u=h[b+1]-h[w+1]}}else if(n||o||s){var h=e.allpts,E=e.ctrlpts,C,x,T,k;if(E.length/2%2===0){var D=h.length/2-1,B=D+2,P=B+2;C=or(h[D],h[B],h[P],0),x=or(h[D+1],h[B+1],h[P+1],0),T=or(h[D],h[B],h[P],1e-4),k=or(h[D+1],h[B+1],h[P+1],1e-4)}else{var B=h.length/2-1,D=B-2,P=B+2;C=or(h[D],h[B],h[P],.4999),x=or(h[D+1],h[B+1],h[P+1],.4999),T=or(h[D],h[B],h[P],.5),k=or(h[D+1],h[B+1],h[P+1],.5)}l=T-C,u=k-x}if(e.midtgtArrowAngle=Ya(l,u),e.midDispX=l,e.midDispY=u,l*=-1,u*=-1,i){var h=e.allpts;if(h.length/2%2!==0){if(!e.isRound){var b=h.length/2-1,A=b+2;l=-(h[A]-h[b]),u=-(h[A+1]-h[b+1])}}}if(e.midsrcArrowAngle=Ya(l,u),i)l=c-e.segpts[e.segpts.length-2],u=d-e.segpts[e.segpts.length-1];else if(n||o||s||a){var h=e.allpts,R=h.length,y=or(h[R-6],h[R-4],h[R-2],.9),g=or(h[R-5],h[R-3],h[R-1],.9);l=c-y,u=d-g}else l=c-p,u=d-m;e.tgtArrowAngle=Ya(l,u)};Bn.getArrowWidth=Bn.getArrowHeight=function(r,e){var t=this.arrowWidthCache=this.arrowWidthCache||{},a=t[r+", "+e];return a||(a=Math.max(Math.pow(r*13.37,.9),29)*e,t[r+", "+e]=a,a)};var qo,_o,Vr={},Pr={},Pl,Al,St,gn,Ur,wt,Ct,zr,Vt,an,df,gf,Go,Ho,Rl,Ml=function(e,t,a){a.x=t.x-e.x,a.y=t.y-e.y,a.len=Math.sqrt(a.x*a.x+a.y*a.y),a.nx=a.x/a.len,a.ny=a.y/a.len,a.ang=Math.atan2(a.ny,a.nx)},Jp=function(e,t){t.x=e.x*-1,t.y=e.y*-1,t.nx=e.nx*-1,t.ny=e.ny*-1,t.ang=e.ang>0?-(Math.PI-e.ang):Math.PI+e.ang},jp=function(e,t,a,n,i){if(e!==Rl?Ml(t,e,Vr):Jp(Pr,Vr),Ml(t,a,Pr),Pl=Vr.nx*Pr.ny-Vr.ny*Pr.nx,Al=Vr.nx*Pr.nx-Vr.ny*-Pr.ny,Ur=Math.asin(Math.max(-1,Math.min(1,Pl))),Math.abs(Ur)<1e-6){qo=t.x,_o=t.y,Ct=Vt=0;return}St=1,gn=!1,Al<0?Ur<0?Ur=Math.PI+Ur:(Ur=Math.PI-Ur,St=-1,gn=!0):Ur>0&&(St=-1,gn=!0),t.radius!==void 0?Vt=t.radius:Vt=n,wt=Ur/2,an=Math.min(Vr.len/2,Pr.len/2),i?(zr=Math.abs(Math.cos(wt)*Vt/Math.sin(wt)),zr>an?(zr=an,Ct=Math.abs(zr*Math.sin(wt)/Math.cos(wt))):Ct=Vt):(zr=Math.min(an,Vt),Ct=Math.abs(zr*Math.sin(wt)/Math.cos(wt))),Go=t.x+Pr.nx*zr,Ho=t.y+Pr.ny*zr,qo=Go-Pr.ny*Ct*St,_o=Ho+Pr.nx*Ct*St,df=t.x+Vr.nx*zr,gf=t.y+Vr.ny*zr,Rl=t};function pf(r,e){e.radius===0?r.lineTo(e.cx,e.cy):r.arc(e.cx,e.cy,e.radius,e.startAngle,e.endAngle,e.counterClockwise)}function ps(r,e,t,a){var n=arguments.length>4&&arguments[4]!==void 0?arguments[4]:!0;return a===0||e.radius===0?{cx:e.x,cy:e.y,radius:0,startX:e.x,startY:e.y,stopX:e.x,stopY:e.y,startAngle:void 0,endAngle:void 0,counterClockwise:void 0}:(jp(r,e,t,a,n),{cx:qo,cy:_o,radius:Ct,startX:df,startY:gf,stopX:Go,stopY:Ho,startAngle:Vr.ang+Math.PI/2*St,endAngle:Pr.ang-Math.PI/2*St,counterClockwise:gn})}var Ma=.01,ey=Math.sqrt(2*Ma),yr={};yr.findMidptPtsEtc=function(r,e){var t=e.posPts,a=e.intersectionPts,n=e.vectorNormInverse,i,o=r.pstyle("source-endpoint"),s=r.pstyle("target-endpoint"),l=o.units!=null&&s.units!=null,u=function(E,C,x,T){var k=T-C,D=x-E,B=Math.sqrt(D*D+k*k);return{x:-k/B,y:D/B}},v=r.pstyle("edge-distances").value;switch(v){case"node-position":i=t;break;case"intersection":i=a;break;case"endpoints":{if(l){var f=this.manualEndptToPx(r.source()[0],o),c=Je(f,2),d=c[0],h=c[1],y=this.manualEndptToPx(r.target()[0],s),g=Je(y,2),p=g[0],m=g[1],b={x1:d,y1:h,x2:p,y2:m};n=u(d,h,p,m),i=b}else Ve("Edge ".concat(r.id()," has edge-distances:endpoints specified without manual endpoints specified via source-endpoint and target-endpoint.  Falling back on edge-distances:intersection (default).")),i=a;break}}return{midptPts:i,vectorNormInverse:n}};yr.findHaystackPoints=function(r){for(var e=0;e<r.length;e++){var t=r[e],a=t._private,n=a.rscratch;if(!n.haystack){var i=Math.random()*2*Math.PI;n.source={x:Math.cos(i),y:Math.sin(i)},i=Math.random()*2*Math.PI,n.target={x:Math.cos(i),y:Math.sin(i)}}var o=a.source,s=a.target,l=o.position(),u=s.position(),v=o.width(),f=s.width(),c=o.height(),d=s.height(),h=t.pstyle("haystack-radius").value,y=h/2;n.haystackPts=n.allpts=[n.source.x*v*y+l.x,n.source.y*c*y+l.y,n.target.x*f*y+u.x,n.target.y*d*y+u.y],n.midX=(n.allpts[0]+n.allpts[2])/2,n.midY=(n.allpts[1]+n.allpts[3])/2,n.edgeType="haystack",n.haystack=!0,this.storeEdgeProjections(t),this.calculateArrowAngles(t),this.recalculateEdgeLabelProjections(t),this.calculateLabelAngles(t)}};yr.findSegmentsPoints=function(r,e){var t=r._private.rscratch,a=r.pstyle("segment-weights"),n=r.pstyle("segment-distances"),i=r.pstyle("segment-radii"),o=r.pstyle("radius-type"),s=Math.min(a.pfValue.length,n.pfValue.length),l=i.pfValue[i.pfValue.length-1],u=o.pfValue[o.pfValue.length-1];t.edgeType="segments",t.segpts=[],t.radii=[],t.isArcRadius=[];for(var v=0;v<s;v++){var f=a.pfValue[v],c=n.pfValue[v],d=1-f,h=f,y=this.findMidptPtsEtc(r,e),g=y.midptPts,p=y.vectorNormInverse,m={x:g.x1*d+g.x2*h,y:g.y1*d+g.y2*h};t.segpts.push(m.x+p.x*c,m.y+p.y*c),t.radii.push(i.pfValue[v]!==void 0?i.pfValue[v]:l),t.isArcRadius.push((o.pfValue[v]!==void 0?o.pfValue[v]:u)==="arc-radius")}};yr.findLoopPoints=function(r,e,t,a){var n=r._private.rscratch,i=e.dirCounts,o=e.srcPos,s=r.pstyle("control-point-distances"),l=s?s.pfValue[0]:void 0,u=r.pstyle("loop-direction").pfValue,v=r.pstyle("loop-sweep").pfValue,f=r.pstyle("control-point-step-size").pfValue;n.edgeType="self";var c=t,d=f;a&&(c=0,d=l);var h=u-Math.PI/2,y=h-v/2,g=h+v/2,p=u+"_"+v;c=i[p]===void 0?i[p]=0:++i[p],n.ctrlpts=[o.x+Math.cos(y)*1.4*d*(c/3+1),o.y+Math.sin(y)*1.4*d*(c/3+1),o.x+Math.cos(g)*1.4*d*(c/3+1),o.y+Math.sin(g)*1.4*d*(c/3+1)]};yr.findCompoundLoopPoints=function(r,e,t,a){var n=r._private.rscratch;n.edgeType="compound";var i=e.srcPos,o=e.tgtPos,s=e.srcW,l=e.srcH,u=e.tgtW,v=e.tgtH,f=r.pstyle("control-point-step-size").pfValue,c=r.pstyle("control-point-distances"),d=c?c.pfValue[0]:void 0,h=t,y=f;a&&(h=0,y=d);var g=50,p={x:i.x-s/2,y:i.y-l/2},m={x:o.x-u/2,y:o.y-v/2},b={x:Math.min(p.x,m.x),y:Math.min(p.y,m.y)},w=.5,E=Math.max(w,Math.log(s*Ma)),C=Math.max(w,Math.log(u*Ma));n.ctrlpts=[b.x,b.y-(1+Math.pow(g,1.12)/100)*y*(h/3+1)*E,b.x-(1+Math.pow(g,1.12)/100)*y*(h/3+1)*C,b.y]};yr.findStraightEdgePoints=function(r){r._private.rscratch.edgeType="straight"};yr.findBezierPoints=function(r,e,t,a,n){var i=r._private.rscratch,o=r.pstyle("control-point-step-size").pfValue,s=r.pstyle("control-point-distances"),l=r.pstyle("control-point-weights"),u=s&&l?Math.min(s.value.length,l.value.length):1,v=s?s.pfValue[0]:void 0,f=l.value[0],c=a;i.edgeType=c?"multibezier":"bezier",i.ctrlpts=[];for(var d=0;d<u;d++){var h=(.5-e.eles.length/2+t)*o*(n?-1:1),y=void 0,g=as(h);c&&(v=s?s.pfValue[d]:o,f=l.value[d]),a?y=v:y=v!==void 0?g*v:void 0;var p=y!==void 0?y:h,m=1-f,b=f,w=this.findMidptPtsEtc(r,e),E=w.midptPts,C=w.vectorNormInverse,x={x:E.x1*m+E.x2*b,y:E.y1*m+E.y2*b};i.ctrlpts.push(x.x+C.x*p,x.y+C.y*p)}};yr.findTaxiPoints=function(r,e){var t=r._private.rscratch;t.edgeType="segments";var a="vertical",n="horizontal",i="leftward",o="rightward",s="downward",l="upward",u="auto",v=e.posPts,f=e.srcW,c=e.srcH,d=e.tgtW,h=e.tgtH,y=r.pstyle("edge-distances").value,g=y!=="node-position",p=r.pstyle("taxi-direction").value,m=p,b=r.pstyle("taxi-turn"),w=b.units==="%",E=b.pfValue,C=E<0,x=r.pstyle("taxi-turn-min-distance").pfValue,T=g?(f+d)/2:0,k=g?(c+h)/2:0,D=v.x2-v.x1,B=v.y2-v.y1,P=function(S,_){return S>0?Math.max(S-_,0):Math.min(S+_,0)},A=P(D,T),R=P(B,k),L=!1;m===u?p=Math.abs(A)>Math.abs(R)?n:a:m===l||m===s?(p=a,L=!0):(m===i||m===o)&&(p=n,L=!0);var I=p===a,M=I?R:A,O=I?B:D,V=as(O),G=!1;!(L&&(w||C))&&(m===s&&O<0||m===l&&O>0||m===i&&O>0||m===o&&O<0)&&(V*=-1,M=V*Math.abs(M),G=!0);var N;if(w){var F=E<0?1+E:E;N=F*M}else{var U=E<0?M:0;N=U+E*V}var Q=function(S){return Math.abs(S)<x||Math.abs(S)>=Math.abs(M)},K=Q(N),j=Q(Math.abs(M)-Math.abs(N)),re=K||j;if(re&&!G)if(I){var ne=Math.abs(O)<=c/2,J=Math.abs(D)<=d/2;if(ne){var z=(v.x1+v.x2)/2,q=v.y1,H=v.y2;t.segpts=[z,q,z,H]}else if(J){var Y=(v.y1+v.y2)/2,te=v.x1,ce=v.x2;t.segpts=[te,Y,ce,Y]}else t.segpts=[v.x1,v.y2]}else{var Ae=Math.abs(O)<=f/2,Ce=Math.abs(B)<=h/2;if(Ae){var we=(v.y1+v.y2)/2,ye=v.x1,ie=v.x2;t.segpts=[ye,we,ie,we]}else if(Ce){var he=(v.x1+v.x2)/2,de=v.y1,Ee=v.y2;t.segpts=[he,de,he,Ee]}else t.segpts=[v.x2,v.y1]}else if(I){var pe=v.y1+N+(g?c/2*V:0),Se=v.x1,Re=v.x2;t.segpts=[Se,pe,Re,pe]}else{var Oe=v.x1+N+(g?f/2*V:0),Ne=v.y1,ze=v.y2;t.segpts=[Oe,Ne,Oe,ze]}if(t.isRound){var xe=r.pstyle("taxi-radius").value,ue=r.pstyle("radius-type").value[0]==="arc-radius";t.radii=new Array(t.segpts.length/2).fill(xe),t.isArcRadius=new Array(t.segpts.length/2).fill(ue)}};yr.tryToCorrectInvalidPoints=function(r,e){var t=r._private.rscratch;if(t.edgeType==="bezier"){var a=e.srcPos,n=e.tgtPos,i=e.srcW,o=e.srcH,s=e.tgtW,l=e.tgtH,u=e.srcShape,v=e.tgtShape,f=e.srcCornerRadius,c=e.tgtCornerRadius,d=e.srcRs,h=e.tgtRs,y=!ae(t.startX)||!ae(t.startY),g=!ae(t.arrowStartX)||!ae(t.arrowStartY),p=!ae(t.endX)||!ae(t.endY),m=!ae(t.arrowEndX)||!ae(t.arrowEndY),b=3,w=this.getArrowWidth(r.pstyle("width").pfValue,r.pstyle("arrow-scale").value)*this.arrowShapeWidth,E=b*w,C=Bt({x:t.ctrlpts[0],y:t.ctrlpts[1]},{x:t.startX,y:t.startY}),x=C<E,T=Bt({x:t.ctrlpts[0],y:t.ctrlpts[1]},{x:t.endX,y:t.endY}),k=T<E,D=!1;if(y||g||x){D=!0;var B={x:t.ctrlpts[0]-a.x,y:t.ctrlpts[1]-a.y},P=Math.sqrt(B.x*B.x+B.y*B.y),A={x:B.x/P,y:B.y/P},R=Math.max(i,o),L={x:t.ctrlpts[0]+A.x*2*R,y:t.ctrlpts[1]+A.y*2*R},I=u.intersectLine(a.x,a.y,i,o,L.x,L.y,0,f,d);x?(t.ctrlpts[0]=t.ctrlpts[0]+A.x*(E-C),t.ctrlpts[1]=t.ctrlpts[1]+A.y*(E-C)):(t.ctrlpts[0]=I[0]+A.x*E,t.ctrlpts[1]=I[1]+A.y*E)}if(p||m||k){D=!0;var M={x:t.ctrlpts[0]-n.x,y:t.ctrlpts[1]-n.y},O=Math.sqrt(M.x*M.x+M.y*M.y),V={x:M.x/O,y:M.y/O},G=Math.max(i,o),N={x:t.ctrlpts[0]+V.x*2*G,y:t.ctrlpts[1]+V.y*2*G},F=v.intersectLine(n.x,n.y,s,l,N.x,N.y,0,c,h);k?(t.ctrlpts[0]=t.ctrlpts[0]+V.x*(E-T),t.ctrlpts[1]=t.ctrlpts[1]+V.y*(E-T)):(t.ctrlpts[0]=F[0]+V.x*E,t.ctrlpts[1]=F[1]+V.y*E)}D&&this.findEndpoints(r)}};yr.storeAllpts=function(r){var e=r._private.rscratch;if(e.edgeType==="multibezier"||e.edgeType==="bezier"||e.edgeType==="self"||e.edgeType==="compound"){e.allpts=[],e.allpts.push(e.startX,e.startY);for(var t=0;t+1<e.ctrlpts.length;t+=2)e.allpts.push(e.ctrlpts[t],e.ctrlpts[t+1]),t+3<e.ctrlpts.length&&e.allpts.push((e.ctrlpts[t]+e.ctrlpts[t+2])/2,(e.ctrlpts[t+1]+e.ctrlpts[t+3])/2);e.allpts.push(e.endX,e.endY);var a,n;e.ctrlpts.length/2%2===0?(a=e.allpts.length/2-1,e.midX=e.allpts[a],e.midY=e.allpts[a+1]):(a=e.allpts.length/2-3,n=.5,e.midX=or(e.allpts[a],e.allpts[a+2],e.allpts[a+4],n),e.midY=or(e.allpts[a+1],e.allpts[a+3],e.allpts[a+5],n))}else if(e.edgeType==="straight")e.allpts=[e.startX,e.startY,e.endX,e.endY],e.midX=(e.startX+e.endX+e.arrowStartX+e.arrowEndX)/4,e.midY=(e.startY+e.endY+e.arrowStartY+e.arrowEndY)/4;else if(e.edgeType==="segments"){if(e.allpts=[],e.allpts.push(e.startX,e.startY),e.allpts.push.apply(e.allpts,e.segpts),e.allpts.push(e.endX,e.endY),e.isRound){e.roundCorners=[];for(var i=2;i+3<e.allpts.length;i+=2){var o=e.radii[i/2-1],s=e.isArcRadius[i/2-1];e.roundCorners.push(ps({x:e.allpts[i-2],y:e.allpts[i-1]},{x:e.allpts[i],y:e.allpts[i+1],radius:o},{x:e.allpts[i+2],y:e.allpts[i+3]},o,s))}}if(e.segpts.length%4===0){var l=e.segpts.length/2,u=l-2;e.midX=(e.segpts[u]+e.segpts[l])/2,e.midY=(e.segpts[u+1]+e.segpts[l+1])/2}else{var v=e.segpts.length/2-1;if(!e.isRound)e.midX=e.segpts[v],e.midY=e.segpts[v+1];else{var f={x:e.segpts[v],y:e.segpts[v+1]},c=e.roundCorners[v/2];if(c.radius===0){var d={x:e.segpts[v+2],y:e.segpts[v+3]};e.midX=f.x,e.midY=f.y,e.midVector=[f.y-d.y,d.x-f.x]}else{var h=[f.x-c.cx,f.y-c.cy],y=c.radius/Math.sqrt(Math.pow(h[0],2)+Math.pow(h[1],2));h=h.map(function(g){return g*y}),e.midX=c.cx+h[0],e.midY=c.cy+h[1],e.midVector=h}}}}};yr.checkForInvalidEdgeWarning=function(r){var e=r[0]._private.rscratch;e.nodesOverlap||ae(e.startX)&&ae(e.startY)&&ae(e.endX)&&ae(e.endY)?e.loggedErr=!1:e.loggedErr||(e.loggedErr=!0,Ve("Edge `"+r.id()+"` has invalid endpoints and so it is impossible to draw.  Adjust your edge style (e.g. control points) accordingly or use an alternative edge type.  This is expected behaviour when the source node and the target node overlap."))};yr.findEdgeControlPoints=function(r){var e=this;if(!(!r||r.length===0)){for(var t=this,a=t.cy,n=a.hasCompoundNodes(),i=new Xr,o=function(k,D){return[].concat(mn(k),[D?1:0]).join("-")},s=[],l=[],u=0;u<r.length;u++){var v=r[u],f=v._private,c=v.pstyle("curve-style").value;if(!(v.removed()||!v.takesUpSpace())){if(c==="haystack"){l.push(v);continue}var d=c==="unbundled-bezier"||at(c,"segments")||c==="straight"||c==="straight-triangle"||at(c,"taxi"),h=c==="unbundled-bezier"||c==="bezier",y=f.source,g=f.target,p=y.poolIndex(),m=g.poolIndex(),b=[p,m].sort(),w=o(b,d),E=i.get(w);E==null&&(E={eles:[]},s.push({pairId:b,edgeIsUnbundled:d}),i.set(w,E)),E.eles.push(v),d&&(E.hasUnbundled=!0),h&&(E.hasBezier=!0)}}for(var C=function(){var k=s[x],D=k.pairId,B=k.edgeIsUnbundled,P=o(D,B),A=i.get(P),R;if(!A.hasUnbundled){var L=A.eles[0].parallelEdges().filter(function(ue){return ue.isBundledBezier()});rs(A.eles),L.forEach(function(ue){return A.eles.push(ue)}),A.eles.sort(function(ue,X){return ue.poolIndex()-X.poolIndex()})}var I=A.eles[0],M=I.source(),O=I.target();if(M.poolIndex()>O.poolIndex()){var V=M;M=O,O=V}var G=A.srcPos=M.position(),N=A.tgtPos=O.position(),F=A.srcW=M.outerWidth(),U=A.srcH=M.outerHeight(),Q=A.tgtW=O.outerWidth(),K=A.tgtH=O.outerHeight(),j=A.srcShape=t.nodeShapes[e.getNodeShape(M)],re=A.tgtShape=t.nodeShapes[e.getNodeShape(O)],ne=A.srcCornerRadius=M.pstyle("corner-radius").value==="auto"?"auto":M.pstyle("corner-radius").pfValue,J=A.tgtCornerRadius=O.pstyle("corner-radius").value==="auto"?"auto":O.pstyle("corner-radius").pfValue,z=A.tgtRs=O._private.rscratch,q=A.srcRs=M._private.rscratch;A.dirCounts={north:0,west:0,south:0,east:0,northwest:0,southwest:0,northeast:0,southeast:0};for(var H=0;H<A.eles.length;H++){var Y=A.eles[H],te=Y[0]._private.rscratch,ce=Y.pstyle("curve-style").value,Ae=ce==="unbundled-bezier"||at(ce,"segments")||at(ce,"taxi"),Ce=!M.same(Y.source());if(!A.calculatedIntersection&&M!==O&&(A.hasBezier||A.hasUnbundled)){A.calculatedIntersection=!0;var we=j.intersectLine(G.x,G.y,F,U,N.x,N.y,0,ne,q),ye=A.srcIntn=we,ie=re.intersectLine(N.x,N.y,Q,K,G.x,G.y,0,J,z),he=A.tgtIntn=ie,de=A.intersectionPts={x1:we[0],x2:ie[0],y1:we[1],y2:ie[1]},Ee=A.posPts={x1:G.x,x2:N.x,y1:G.y,y2:N.y},pe=ie[1]-we[1],Se=ie[0]-we[0],Re=Math.sqrt(Se*Se+pe*pe);ae(Re)&&Re>=ey||(Re=Math.sqrt(Math.max(Se*Se,Ma)+Math.max(pe*pe,Ma)));var Oe=A.vector={x:Se,y:pe},Ne=A.vectorNorm={x:Oe.x/Re,y:Oe.y/Re},ze={x:-Ne.y,y:Ne.x};A.nodesOverlap=!ae(Re)||re.checkPoint(we[0],we[1],0,Q,K,N.x,N.y,J,z)||j.checkPoint(ie[0],ie[1],0,F,U,G.x,G.y,ne,q),A.vectorNormInverse=ze,R={nodesOverlap:A.nodesOverlap,dirCounts:A.dirCounts,calculatedIntersection:!0,hasBezier:A.hasBezier,hasUnbundled:A.hasUnbundled,eles:A.eles,srcPos:N,srcRs:z,tgtPos:G,tgtRs:q,srcW:Q,srcH:K,tgtW:F,tgtH:U,srcIntn:he,tgtIntn:ye,srcShape:re,tgtShape:j,posPts:{x1:Ee.x2,y1:Ee.y2,x2:Ee.x1,y2:Ee.y1},intersectionPts:{x1:de.x2,y1:de.y2,x2:de.x1,y2:de.y1},vector:{x:-Oe.x,y:-Oe.y},vectorNorm:{x:-Ne.x,y:-Ne.y},vectorNormInverse:{x:-ze.x,y:-ze.y}}}var xe=Ce?R:A;te.nodesOverlap=xe.nodesOverlap,te.srcIntn=xe.srcIntn,te.tgtIntn=xe.tgtIntn,te.isRound=ce.startsWith("round"),n&&(M.isParent()||M.isChild()||O.isParent()||O.isChild())&&(M.parents().anySame(O)||O.parents().anySame(M)||M.same(O)&&M.isParent())?e.findCompoundLoopPoints(Y,xe,H,Ae):M===O?e.findLoopPoints(Y,xe,H,Ae):ce.endsWith("segments")?e.findSegmentsPoints(Y,xe):ce.endsWith("taxi")?e.findTaxiPoints(Y,xe):ce==="straight"||!Ae&&A.eles.length%2===1&&H===Math.floor(A.eles.length/2)?e.findStraightEdgePoints(Y):e.findBezierPoints(Y,xe,H,Ae,Ce),e.findEndpoints(Y),e.tryToCorrectInvalidPoints(Y,xe),e.checkForInvalidEdgeWarning(Y),e.storeAllpts(Y),e.storeEdgeProjections(Y),e.calculateArrowAngles(Y),e.recalculateEdgeLabelProjections(Y),e.calculateLabelAngles(Y)}},x=0;x<s.length;x++)C();this.findHaystackPoints(l)}};function yf(r){var e=[];if(r!=null){for(var t=0;t<r.length;t+=2){var a=r[t],n=r[t+1];e.push({x:a,y:n})}return e}}yr.getSegmentPoints=function(r){var e=r[0]._private.rscratch;this.recalculateRenderedStyle(r);var t=e.edgeType;if(t==="segments")return yf(e.segpts)};yr.getControlPoints=function(r){var e=r[0]._private.rscratch;this.recalculateRenderedStyle(r);var t=e.edgeType;if(t==="bezier"||t==="multibezier"||t==="self"||t==="compound")return yf(e.ctrlpts)};yr.getEdgeMidpoint=function(r){var e=r[0]._private.rscratch;return this.recalculateRenderedStyle(r),{x:e.midX,y:e.midY}};var Ga={};Ga.manualEndptToPx=function(r,e){var t=this,a=r.position(),n=r.outerWidth(),i=r.outerHeight(),o=r._private.rscratch;if(e.value.length===2){var s=[e.pfValue[0],e.pfValue[1]];return e.units[0]==="%"&&(s[0]=s[0]*n),e.units[1]==="%"&&(s[1]=s[1]*i),s[0]+=a.x,s[1]+=a.y,s}else{var l=e.pfValue[0];l=-Math.PI/2+l;var u=2*Math.max(n,i),v=[a.x+Math.cos(l)*u,a.y+Math.sin(l)*u];return t.nodeShapes[this.getNodeShape(r)].intersectLine(a.x,a.y,n,i,v[0],v[1],0,r.pstyle("corner-radius").value==="auto"?"auto":r.pstyle("corner-radius").pfValue,o)}};Ga.findEndpoints=function(r){var e,t,a,n,i=this,o,s=r.source()[0],l=r.target()[0],u=s.position(),v=l.position(),f=r.pstyle("target-arrow-shape").value,c=r.pstyle("source-arrow-shape").value,d=r.pstyle("target-distance-from-node").pfValue,h=r.pstyle("source-distance-from-node").pfValue,y=s._private.rscratch,g=l._private.rscratch,p=r.pstyle("curve-style").value,m=r._private.rscratch,b=m.edgeType,w=at(p,"taxi"),E=b==="self"||b==="compound",C=b==="bezier"||b==="multibezier"||E,x=b!=="bezier",T=b==="straight"||b==="segments",k=b==="segments",D=C||x||T,B=E||w,P=r.pstyle("source-endpoint"),A=B?"outside-to-node":P.value,R=s.pstyle("corner-radius").value==="auto"?"auto":s.pstyle("corner-radius").pfValue,L=r.pstyle("target-endpoint"),I=B?"outside-to-node":L.value,M=l.pstyle("corner-radius").value==="auto"?"auto":l.pstyle("corner-radius").pfValue;m.srcManEndpt=P,m.tgtManEndpt=L;var O,V,G,N,F=(e=(L==null||(t=L.pfValue)===null||t===void 0?void 0:t.length)===2?L.pfValue:null)!==null&&e!==void 0?e:[0,0],U=(a=(P==null||(n=P.pfValue)===null||n===void 0?void 0:n.length)===2?P.pfValue:null)!==null&&a!==void 0?a:[0,0];if(C){var Q=[m.ctrlpts[0],m.ctrlpts[1]],K=x?[m.ctrlpts[m.ctrlpts.length-2],m.ctrlpts[m.ctrlpts.length-1]]:Q;O=K,V=Q}else if(T){var j=k?m.segpts.slice(0,2):[v.x+F[0],v.y+F[1]],re=k?m.segpts.slice(m.segpts.length-2):[u.x+U[0],u.y+U[1]];O=re,V=j}if(I==="inside-to-node")o=[v.x,v.y];else if(L.units)o=this.manualEndptToPx(l,L);else if(I==="outside-to-line")o=m.tgtIntn;else if(I==="outside-to-node"||I==="outside-to-node-or-label"?G=O:(I==="outside-to-line"||I==="outside-to-line-or-label")&&(G=[u.x,u.y]),o=i.nodeShapes[this.getNodeShape(l)].intersectLine(v.x,v.y,l.outerWidth(),l.outerHeight(),G[0],G[1],0,M,g),I==="outside-to-node-or-label"||I==="outside-to-line-or-label"){var ne=l._private.rscratch,J=ne.labelWidth,z=ne.labelHeight,q=ne.labelX,H=ne.labelY,Y=J/2,te=z/2,ce=l.pstyle("text-valign").value;ce==="top"?H-=te:ce==="bottom"&&(H+=te);var Ae=l.pstyle("text-halign").value;Ae==="left"?q-=Y:Ae==="right"&&(q+=Y);var Ce=Da(G[0],G[1],[q-Y,H-te,q+Y,H-te,q+Y,H+te,q-Y,H+te],v.x,v.y);if(Ce.length>0){var we=u,ye=Et(we,Wt(o)),ie=Et(we,Wt(Ce)),he=ye;if(ie<ye&&(o=Ce,he=ie),Ce.length>2){var de=Et(we,{x:Ce[2],y:Ce[3]});de<he&&(o=[Ce[2],Ce[3]])}}}var Ee=Za(o,O,i.arrowShapes[f].spacing(r)+d),pe=Za(o,O,i.arrowShapes[f].gap(r)+d);if(m.endX=pe[0],m.endY=pe[1],m.arrowEndX=Ee[0],m.arrowEndY=Ee[1],A==="inside-to-node")o=[u.x,u.y];else if(P.units)o=this.manualEndptToPx(s,P);else if(A==="outside-to-line")o=m.srcIntn;else if(A==="outside-to-node"||A==="outside-to-node-or-label"?N=V:(A==="outside-to-line"||A==="outside-to-line-or-label")&&(N=[v.x,v.y]),o=i.nodeShapes[this.getNodeShape(s)].intersectLine(u.x,u.y,s.outerWidth(),s.outerHeight(),N[0],N[1],0,R,y),A==="outside-to-node-or-label"||A==="outside-to-line-or-label"){var Se=s._private.rscratch,Re=Se.labelWidth,Oe=Se.labelHeight,Ne=Se.labelX,ze=Se.labelY,xe=Re/2,ue=Oe/2,X=s.pstyle("text-valign").value;X==="top"?ze-=ue:X==="bottom"&&(ze+=ue);var S=s.pstyle("text-halign").value;S==="left"?Ne-=xe:S==="right"&&(Ne+=xe);var _=Da(N[0],N[1],[Ne-xe,ze-ue,Ne+xe,ze-ue,Ne+xe,ze+ue,Ne-xe,ze+ue],u.x,u.y);if(_.length>0){var W=v,$=Et(W,Wt(o)),Z=Et(W,Wt(_)),se=$;if(Z<$&&(o=[_[0],_[1]],se=Z),_.length>2){var ee=Et(W,{x:_[2],y:_[3]});ee<se&&(o=[_[2],_[3]])}}}var ve=Za(o,V,i.arrowShapes[c].spacing(r)+h),le=Za(o,V,i.arrowShapes[c].gap(r)+h);m.startX=le[0],m.startY=le[1],m.arrowStartX=ve[0],m.arrowStartY=ve[1],D&&(!ae(m.startX)||!ae(m.startY)||!ae(m.endX)||!ae(m.endY)?m.badLine=!0:m.badLine=!1)};Ga.getSourceEndpoint=function(r){var e=r[0]._private.rscratch;switch(this.recalculateRenderedStyle(r),e.edgeType){case"haystack":return{x:e.haystackPts[0],y:e.haystackPts[1]};default:return{x:e.arrowStartX,y:e.arrowStartY}}};Ga.getTargetEndpoint=function(r){var e=r[0]._private.rscratch;switch(this.recalculateRenderedStyle(r),e.edgeType){case"haystack":return{x:e.haystackPts[2],y:e.haystackPts[3]};default:return{x:e.arrowEndX,y:e.arrowEndY}}};var ys={};function ry(r,e,t){for(var a=function(u,v,f,c){return or(u,v,f,c)},n=e._private,i=n.rstyle.bezierPts,o=0;o<r.bezierProjPcts.length;o++){var s=r.bezierProjPcts[o];i.push({x:a(t[0],t[2],t[4],s),y:a(t[1],t[3],t[5],s)})}}ys.storeEdgeProjections=function(r){var e=r._private,t=e.rscratch,a=t.edgeType;if(e.rstyle.bezierPts=null,e.rstyle.linePts=null,e.rstyle.haystackPts=null,a==="multibezier"||a==="bezier"||a==="self"||a==="compound"){e.rstyle.bezierPts=[];for(var n=0;n+5<t.allpts.length;n+=4)ry(this,r,t.allpts.slice(n,n+6))}else if(a==="segments")for(var i=e.rstyle.linePts=[],n=0;n+1<t.allpts.length;n+=2)i.push({x:t.allpts[n],y:t.allpts[n+1]});else if(a==="haystack"){var o=t.haystackPts;e.rstyle.haystackPts=[{x:o[0],y:o[1]},{x:o[2],y:o[3]}]}e.rstyle.arrowWidth=this.getArrowWidth(r.pstyle("width").pfValue,r.pstyle("arrow-scale").value)*this.arrowShapeWidth};ys.recalculateEdgeProjections=function(r){this.findEdgeControlPoints(r)};var Gr={};Gr.recalculateNodeLabelProjection=function(r){var e=r.pstyle("label").strValue;if(!ut(e)){var t,a,n=r._private,i=r.width(),o=r.height(),s=r.padding(),l=r.position(),u=r.pstyle("text-halign").strValue,v=r.pstyle("text-valign").strValue,f=n.rscratch,c=n.rstyle;switch(u){case"left":t=l.x-i/2-s;break;case"right":t=l.x+i/2+s;break;default:t=l.x}switch(v){case"top":a=l.y-o/2-s;break;case"bottom":a=l.y+o/2+s;break;default:a=l.y}f.labelX=t,f.labelY=a,c.labelX=t,c.labelY=a,this.calculateLabelAngles(r),this.applyLabelDimensions(r)}};var mf=function(e,t){var a=Math.atan(t/e);return e===0&&a<0&&(a=a*-1),a},bf=function(e,t){var a=t.x-e.x,n=t.y-e.y;return mf(a,n)},ty=function(e,t,a,n){var i=ka(0,n-.001,1),o=ka(0,n+.001,1),s=Kt(e,t,a,i),l=Kt(e,t,a,o);return bf(s,l)};Gr.recalculateEdgeLabelProjections=function(r){var e,t=r._private,a=t.rscratch,n=this,i={mid:r.pstyle("label").strValue,source:r.pstyle("source-label").strValue,target:r.pstyle("target-label").strValue};if(i.mid||i.source||i.target){e={x:a.midX,y:a.midY};var o=function(f,c,d){Kr(t.rscratch,f,c,d),Kr(t.rstyle,f,c,d)};o("labelX",null,e.x),o("labelY",null,e.y);var s=mf(a.midDispX,a.midDispY);o("labelAutoAngle",null,s);var l=function(){if(l.cache)return l.cache;for(var f=[],c=0;c+5<a.allpts.length;c+=4){var d={x:a.allpts[c],y:a.allpts[c+1]},h={x:a.allpts[c+2],y:a.allpts[c+3]},y={x:a.allpts[c+4],y:a.allpts[c+5]};f.push({p0:d,p1:h,p2:y,startDist:0,length:0,segments:[]})}var g=t.rstyle.bezierPts,p=n.bezierProjPcts.length;function m(x,T,k,D,B){var P=Bt(T,k),A=x.segments[x.segments.length-1],R={p0:T,p1:k,t0:D,t1:B,startDist:A?A.startDist+A.length:0,length:P};x.segments.push(R),x.length+=P}for(var b=0;b<f.length;b++){var w=f[b],E=f[b-1];E&&(w.startDist=E.startDist+E.length),m(w,w.p0,g[b*p],0,n.bezierProjPcts[0]);for(var C=0;C<p-1;C++)m(w,g[b*p+C],g[b*p+C+1],n.bezierProjPcts[C],n.bezierProjPcts[C+1]);m(w,g[b*p+p-1],w.p2,n.bezierProjPcts[p-1],1)}return l.cache=f},u=function(f){var c,d=f==="source";if(i[f]){var h=r.pstyle(f+"-text-offset").pfValue;switch(a.edgeType){case"self":case"compound":case"bezier":case"multibezier":{for(var y=l(),g,p=0,m=0,b=0;b<y.length;b++){for(var w=y[d?b:y.length-1-b],E=0;E<w.segments.length;E++){var C=w.segments[d?E:w.segments.length-1-E],x=b===y.length-1&&E===w.segments.length-1;if(p=m,m+=C.length,m>=h||x){g={cp:w,segment:C};break}}if(g)break}var T=g.cp,k=g.segment,D=(h-p)/k.length,B=k.t1-k.t0,P=d?k.t0+B*D:k.t1-B*D;P=ka(0,P,1),e=Kt(T.p0,T.p1,T.p2,P),c=ty(T.p0,T.p1,T.p2,P);break}case"straight":case"segments":case"haystack":{for(var A=0,R,L,I,M,O=a.allpts.length,V=0;V+3<O&&(d?(I={x:a.allpts[V],y:a.allpts[V+1]},M={x:a.allpts[V+2],y:a.allpts[V+3]}):(I={x:a.allpts[O-2-V],y:a.allpts[O-1-V]},M={x:a.allpts[O-4-V],y:a.allpts[O-3-V]}),R=Bt(I,M),L=A,A+=R,!(A>=h));V+=2);var G=h-L,N=G/R;N=ka(0,N,1),e=Th(I,M,N),c=bf(I,M);break}}o("labelX",f,e.x),o("labelY",f,e.y),o("labelAutoAngle",f,c)}};u("source"),u("target"),this.applyLabelDimensions(r)}};Gr.applyLabelDimensions=function(r){this.applyPrefixedLabelDimensions(r),r.isEdge()&&(this.applyPrefixedLabelDimensions(r,"source"),this.applyPrefixedLabelDimensions(r,"target"))};Gr.applyPrefixedLabelDimensions=function(r,e){var t=r._private,a=this.getLabelText(r,e),n=Dt(a,r._private.labelDimsKey);if(Tr(t.rscratch,"prefixedLabelDimsKey",e)!==n){Kr(t.rscratch,"prefixedLabelDimsKey",e,n);var i=this.calculateLabelDimensions(r,a),o=r.pstyle("line-height").pfValue,s=r.pstyle("text-wrap").strValue,l=Tr(t.rscratch,"labelWrapCachedLines",e)||[],u=s!=="wrap"?1:Math.max(l.length,1),v=i.height/u,f=v*o,c=i.width,d=i.height+(u-1)*(o-1)*v;Kr(t.rstyle,"labelWidth",e,c),Kr(t.rscratch,"labelWidth",e,c),Kr(t.rstyle,"labelHeight",e,d),Kr(t.rscratch,"labelHeight",e,d),Kr(t.rscratch,"labelLineHeight",e,f)}};Gr.getLabelText=function(r,e){var t=r._private,a=e?e+"-":"",n=r.pstyle(a+"label").strValue,i=r.pstyle("text-transform").value,o=function(U,Q){return Q?(Kr(t.rscratch,U,e,Q),Q):Tr(t.rscratch,U,e)};if(!n)return"";i=="none"||(i=="uppercase"?n=n.toUpperCase():i=="lowercase"&&(n=n.toLowerCase()));var s=r.pstyle("text-wrap").value;if(s==="wrap"){var l=o("labelKey");if(l!=null&&o("labelWrapKey")===l)return o("labelWrapCachedText");for(var u="​",v=n.split(`
-`),f=r.pstyle("text-max-width").pfValue,c=r.pstyle("text-overflow-wrap").value,d=c==="anywhere",h=[],y=/[\s\u200b]+|$/g,g=0;g<v.length;g++){var p=v[g],m=this.calculateLabelDimensions(r,p),b=m.width;if(d){var w=p.split("").join(u);p=w}if(b>f){var E=p.matchAll(y),C="",x=0,T=kr(E),k;try{for(T.s();!(k=T.n()).done;){var D=k.value,B=D[0],P=p.substring(x,D.index);x=D.index+B.length;var A=C.length===0?P:C+P+B,R=this.calculateLabelDimensions(r,A),L=R.width;L<=f?C+=P+B:(C&&h.push(C),C=P+B)}}catch(F){T.e(F)}finally{T.f()}C.match(/^[\s\u200b]+$/)||h.push(C)}else h.push(p)}o("labelWrapCachedLines",h),n=o("labelWrapCachedText",h.join(`
-`)),o("labelWrapKey",l)}else if(s==="ellipsis"){var I=r.pstyle("text-max-width").pfValue,M="",O="…",V=!1;if(this.calculateLabelDimensions(r,n).width<I)return n;for(var G=0;G<n.length;G++){var N=this.calculateLabelDimensions(r,M+n[G]+O).width;if(N>I)break;M+=n[G],G===n.length-1&&(V=!0)}return V||(M+=O),M}return n};Gr.getLabelJustification=function(r){var e=r.pstyle("text-justification").strValue,t=r.pstyle("text-halign").strValue;if(e==="auto")if(r.isNode())switch(t){case"left":return"right";case"right":return"left";default:return"center"}else return"center";else return e};Gr.calculateLabelDimensions=function(r,e){var t=this,a=t.cy.window(),n=a.document,i=0,o=r.pstyle("font-style").strValue,s=r.pstyle("font-size").pfValue,l=r.pstyle("font-family").strValue,u=r.pstyle("font-weight").strValue,v=this.labelCalcCanvas,f=this.labelCalcCanvasContext;if(!v){v=this.labelCalcCanvas=n.createElement("canvas"),f=this.labelCalcCanvasContext=v.getContext("2d");var c=v.style;c.position="absolute",c.left="-9999px",c.top="-9999px",c.zIndex="-1",c.visibility="hidden",c.pointerEvents="none"}f.font="".concat(o," ").concat(u," ").concat(s,"px ").concat(l);for(var d=0,h=0,y=e.split(`
-`),g=0;g<y.length;g++){var p=y[g],m=f.measureText(p),b=Math.ceil(m.width),w=s;d=Math.max(b,d),h+=w}return d+=i,h+=i,{width:d,height:h}};Gr.calculateLabelAngle=function(r,e){var t=r._private,a=t.rscratch,n=r.isEdge(),i=e?e+"-":"",o=r.pstyle(i+"text-rotation"),s=o.strValue;return s==="none"?0:n&&s==="autorotate"?a.labelAutoAngle:s==="autorotate"?0:o.pfValue};Gr.calculateLabelAngles=function(r){var e=this,t=r.isEdge(),a=r._private,n=a.rscratch;n.labelAngle=e.calculateLabelAngle(r),t&&(n.sourceLabelAngle=e.calculateLabelAngle(r,"source"),n.targetLabelAngle=e.calculateLabelAngle(r,"target"))};var wf={},Ll=28,Il=!1;wf.getNodeShape=function(r){var e=this,t=r.pstyle("shape").value;if(t==="cutrectangle"&&(r.width()<Ll||r.height()<Ll))return Il||(Ve("The `cutrectangle` node shape can not be used at small sizes so `rectangle` is used instead"),Il=!0),"rectangle";if(r.isParent())return t==="rectangle"||t==="roundrectangle"||t==="round-rectangle"||t==="cutrectangle"||t==="cut-rectangle"||t==="barrel"?t:"rectangle";if(t==="polygon"){var a=r.pstyle("shape-polygon-points").value;return e.nodeShapes.makePolygon(a).name}return t};var Xn={};Xn.registerCalculationListeners=function(){var r=this.cy,e=r.collection(),t=this,a=function(o){var s=arguments.length>1&&arguments[1]!==void 0?arguments[1]:!0;if(e.merge(o),s)for(var l=0;l<o.length;l++){var u=o[l],v=u._private,f=v.rstyle;f.clean=!1,f.cleanConnected=!1}};t.binder(r).on("bounds.* dirty.*",function(o){var s=o.target;a(s)}).on("style.* background.*",function(o){var s=o.target;a(s,!1)});var n=function(o){if(o){var s=t.onUpdateEleCalcsFns;e.cleanStyle();for(var l=0;l<e.length;l++){var u=e[l],v=u._private.rstyle;u.isNode()&&!v.cleanConnected&&(a(u.connectedEdges()),v.cleanConnected=!0)}if(s)for(var f=0;f<s.length;f++){var c=s[f];c(o,e)}t.recalculateRenderedStyle(e),e=r.collection()}};t.flushRenderedStyleQueue=function(){n(!0)},t.beforeRender(n,t.beforeRenderPriorities.eleCalcs)};Xn.onUpdateEleCalcs=function(r){var e=this.onUpdateEleCalcsFns=this.onUpdateEleCalcsFns||[];e.push(r)};Xn.recalculateRenderedStyle=function(r,e){var t=function(w){return w._private.rstyle.cleanConnected};if(r.length!==0){var a=[],n=[];if(!this.destroyed){e===void 0&&(e=!0);for(var i=0;i<r.length;i++){var o=r[i],s=o._private,l=s.rstyle;o.isEdge()&&(!t(o.source())||!t(o.target()))&&(l.clean=!1),o.isEdge()&&o.isBundledBezier()&&o.parallelEdges().some(function(b){return!b._private.rstyle.clean&&b.isBundledBezier()})&&(l.clean=!1),!(e&&l.clean||o.removed())&&o.pstyle("display").value!=="none"&&(s.group==="nodes"?n.push(o):a.push(o),l.clean=!0)}for(var u=0;u<n.length;u++){var v=n[u],f=v._private,c=f.rstyle,d=v.position();this.recalculateNodeLabelProjection(v),c.nodeX=d.x,c.nodeY=d.y,c.nodeW=v.pstyle("width").pfValue,c.nodeH=v.pstyle("height").pfValue}this.recalculateEdgeProjections(a);for(var h=0;h<a.length;h++){var y=a[h],g=y._private,p=g.rstyle,m=g.rscratch;p.srcX=m.arrowStartX,p.srcY=m.arrowStartY,p.tgtX=m.arrowEndX,p.tgtY=m.arrowEndY,p.midX=m.midX,p.midY=m.midY,p.labelAngle=m.labelAngle,p.sourceLabelAngle=m.sourceLabelAngle,p.targetLabelAngle=m.targetLabelAngle}}}};var Yn={};Yn.updateCachedGrabbedEles=function(){var r=this.cachedZSortedEles;if(r){r.drag=[],r.nondrag=[];for(var e=[],t=0;t<r.length;t++){var a=r[t],n=a._private.rscratch;a.grabbed()&&!a.isParent()?e.push(a):n.inDragLayer?r.drag.push(a):r.nondrag.push(a)}for(var t=0;t<e.length;t++){var a=e[t];r.drag.push(a)}}};Yn.invalidateCachedZSortedEles=function(){this.cachedZSortedEles=null};Yn.getCachedZSortedEles=function(r){if(r||!this.cachedZSortedEles){var e=this.cy.mutableElements().toArray();e.sort(ef),e.interactive=e.filter(function(t){return t.interactive()}),this.cachedZSortedEles=e,this.updateCachedGrabbedEles()}else e=this.cachedZSortedEles;return e};var xf={};[Mt,Bn,yr,Ga,ys,Gr,wf,Xn,Yn].forEach(function(r){be(xf,r)});var Ef={};Ef.getCachedImage=function(r,e,t){var a=this,n=a.imageCache=a.imageCache||{},i=n[r];if(i)return i.image.complete||i.image.addEventListener("load",t),i.image;i=n[r]=n[r]||{};var o=i.image=new Image;o.addEventListener("load",t),o.addEventListener("error",function(){o.error=!0});var s="data:",l=r.substring(0,s.length).toLowerCase()===s;return l||(e=e==="null"?null:e,o.crossOrigin=e),o.src=r,o};var ia={};ia.registerBinding=function(r,e,t,a){var n=Array.prototype.slice.apply(arguments,[1]);if(Array.isArray(r)){for(var i=[],o=0;o<r.length;o++){var s=r[o];if(s!==void 0){var l=this.binder(s);i.push(l.on.apply(l,n))}}return i}var l=this.binder(r);return l.on.apply(l,n)};ia.binder=function(r){var e=this,t=e.cy.window(),a=r===t||r===t.document||r===t.document.body||dc(r);if(e.supportsPassiveEvents==null){var n=!1;try{var i=Object.defineProperty({},"passive",{get:function(){return n=!0,!0}});t.addEventListener("test",null,i)}catch{}e.supportsPassiveEvents=n}var o=function(l,u,v){var f=Array.prototype.slice.call(arguments);return a&&e.supportsPassiveEvents&&(f[2]={capture:v??!1,passive:!1,once:!1}),e.bindings.push({target:r,args:f}),(r.addEventListener||r.on).apply(r,f),this};return{on:o,addEventListener:o,addListener:o,bind:o}};ia.nodeIsDraggable=function(r){return r&&r.isNode()&&!r.locked()&&r.grabbable()};ia.nodeIsGrabbable=function(r){return this.nodeIsDraggable(r)&&r.interactive()};ia.load=function(){var r=this,e=r.cy.window(),t=function(S){return S.selected()},a=function(S){var _=S.getRootNode();if(_&&_.nodeType===11&&_.host!==void 0)return _},n=function(S,_,W,$){S==null&&(S=r.cy);for(var Z=0;Z<_.length;Z++){var se=_[Z];S.emit({originalEvent:W,type:se,position:$})}},i=function(S){return S.shiftKey||S.metaKey||S.ctrlKey},o=function(S,_){var W=!0;if(r.cy.hasCompoundNodes()&&S&&S.pannable())for(var $=0;_&&$<_.length;$++){var S=_[$];if(S.isNode()&&S.isParent()&&!S.pannable()){W=!1;break}}else W=!0;return W},s=function(S){S[0]._private.grabbed=!0},l=function(S){S[0]._private.grabbed=!1},u=function(S){S[0]._private.rscratch.inDragLayer=!0},v=function(S){S[0]._private.rscratch.inDragLayer=!1},f=function(S){S[0]._private.rscratch.isGrabTarget=!0},c=function(S){S[0]._private.rscratch.isGrabTarget=!1},d=function(S,_){var W=_.addToList,$=W.has(S);!$&&S.grabbable()&&!S.locked()&&(W.merge(S),s(S))},h=function(S,_){if(S.cy().hasCompoundNodes()&&!(_.inDragLayer==null&&_.addToList==null)){var W=S.descendants();_.inDragLayer&&(W.forEach(u),W.connectedEdges().forEach(u)),_.addToList&&d(W,_)}},y=function(S,_){_=_||{};var W=S.cy().hasCompoundNodes();_.inDragLayer&&(S.forEach(u),S.neighborhood().stdFilter(function($){return!W||$.isEdge()}).forEach(u)),_.addToList&&S.forEach(function($){d($,_)}),h(S,_),m(S,{inDragLayer:_.inDragLayer}),r.updateCachedGrabbedEles()},g=y,p=function(S){S&&(r.getCachedZSortedEles().forEach(function(_){l(_),v(_),c(_)}),r.updateCachedGrabbedEles())},m=function(S,_){if(!(_.inDragLayer==null&&_.addToList==null)&&S.cy().hasCompoundNodes()){var W=S.ancestors().orphans();if(!W.same(S)){var $=W.descendants().spawnSelf().merge(W).unmerge(S).unmerge(S.descendants()),Z=$.connectedEdges();_.inDragLayer&&(Z.forEach(u),$.forEach(u)),_.addToList&&$.forEach(function(se){d(se,_)})}}},b=function(){document.activeElement!=null&&document.activeElement.blur!=null&&document.activeElement.blur()},w=typeof MutationObserver<"u",E=typeof ResizeObserver<"u";w?(r.removeObserver=new MutationObserver(function(X){for(var S=0;S<X.length;S++){var _=X[S],W=_.removedNodes;if(W)for(var $=0;$<W.length;$++){var Z=W[$];if(Z===r.container){r.destroy();break}}}}),r.container.parentNode&&r.removeObserver.observe(r.container.parentNode,{childList:!0})):r.registerBinding(r.container,"DOMNodeRemoved",function(X){r.destroy()});var C=Fa(function(){r.cy.resize()},100);w&&(r.styleObserver=new MutationObserver(C),r.styleObserver.observe(r.container,{attributes:!0})),r.registerBinding(e,"resize",C),E&&(r.resizeObserver=new ResizeObserver(C),r.resizeObserver.observe(r.container));var x=function(S,_){for(;S!=null;)_(S),S=S.parentNode},T=function(){r.invalidateContainerClientCoordsCache()};x(r.container,function(X){r.registerBinding(X,"transitionend",T),r.registerBinding(X,"animationend",T),r.registerBinding(X,"scroll",T)}),r.registerBinding(r.container,"contextmenu",function(X){X.preventDefault()});var k=function(){return r.selection[4]!==0},D=function(S){for(var _=r.findContainerClientCoords(),W=_[0],$=_[1],Z=_[2],se=_[3],ee=S.touches?S.touches:[S],ve=!1,le=0;le<ee.length;le++){var me=ee[le];if(W<=me.clientX&&me.clientX<=W+Z&&$<=me.clientY&&me.clientY<=$+se){ve=!0;break}}if(!ve)return!1;for(var De=r.container,Te=S.target,fe=Te.parentNode,Pe=!1;fe;){if(fe===De){Pe=!0;break}fe=fe.parentNode}return!!Pe};r.registerBinding(r.container,"mousedown",function(S){if(D(S)&&!(r.hoverData.which===1&&S.which!==1)){S.preventDefault(),b(),r.hoverData.capture=!0,r.hoverData.which=S.which;var _=r.cy,W=[S.clientX,S.clientY],$=r.projectIntoViewport(W[0],W[1]),Z=r.selection,se=r.findNearestElements($[0],$[1],!0,!1),ee=se[0],ve=r.dragData.possibleDragElements;r.hoverData.mdownPos=$,r.hoverData.mdownGPos=W;var le=function(Be){return{originalEvent:S,type:Be,position:{x:$[0],y:$[1]}}},me=function(){r.hoverData.tapholdCancelled=!1,clearTimeout(r.hoverData.tapholdTimeout),r.hoverData.tapholdTimeout=setTimeout(function(){if(!r.hoverData.tapholdCancelled){var Be=r.hoverData.down;Be?Be.emit(le("taphold")):_.emit(le("taphold"))}},r.tapholdDuration)};if(S.which==3){r.hoverData.cxtStarted=!0;var De={originalEvent:S,type:"cxttapstart",position:{x:$[0],y:$[1]}};ee?(ee.activate(),ee.emit(De),r.hoverData.down=ee):_.emit(De),r.hoverData.downTime=new Date().getTime(),r.hoverData.cxtDragged=!1}else if(S.which==1){ee&&ee.activate();{if(ee!=null&&r.nodeIsGrabbable(ee)){var Te=function(Be){Be.emit(le("grab"))};if(f(ee),!ee.selected())ve=r.dragData.possibleDragElements=_.collection(),g(ee,{addToList:ve}),ee.emit(le("grabon")).emit(le("grab"));else{ve=r.dragData.possibleDragElements=_.collection();var fe=_.$(function(Pe){return Pe.isNode()&&Pe.selected()&&r.nodeIsGrabbable(Pe)});y(fe,{addToList:ve}),ee.emit(le("grabon")),fe.forEach(Te)}r.redrawHint("eles",!0),r.redrawHint("drag",!0)}r.hoverData.down=ee,r.hoverData.downs=se,r.hoverData.downTime=new Date().getTime()}n(ee,["mousedown","tapstart","vmousedown"],S,{x:$[0],y:$[1]}),ee==null?(Z[4]=1,r.data.bgActivePosistion={x:$[0],y:$[1]},r.redrawHint("select",!0),r.redraw()):ee.pannable()&&(Z[4]=1),me()}Z[0]=Z[2]=$[0],Z[1]=Z[3]=$[1]}},!1);var B=a(r.container);r.registerBinding([e,B],"mousemove",function(S){var _=r.hoverData.capture;if(!(!_&&!D(S))){var W=!1,$=r.cy,Z=$.zoom(),se=[S.clientX,S.clientY],ee=r.projectIntoViewport(se[0],se[1]),ve=r.hoverData.mdownPos,le=r.hoverData.mdownGPos,me=r.selection,De=null;!r.hoverData.draggingEles&&!r.hoverData.dragging&&!r.hoverData.selecting&&(De=r.findNearestElement(ee[0],ee[1],!0,!1));var Te=r.hoverData.last,fe=r.hoverData.down,Pe=[ee[0]-me[2],ee[1]-me[3]],Be=r.dragData.possibleDragElements,je;if(le){var Ke=se[0]-le[0],mr=Ke*Ke,Ye=se[1]-le[1],ir=Ye*Ye,er=mr+ir;r.hoverData.isOverThresholdDrag=je=er>=r.desktopTapThreshold2}var lr=i(S);je&&(r.hoverData.tapholdCancelled=!0);var jr=function(){var Br=r.hoverData.dragDelta=r.hoverData.dragDelta||[];Br.length===0?(Br.push(Pe[0]),Br.push(Pe[1])):(Br[0]+=Pe[0],Br[1]+=Pe[1])};W=!0,n(De,["mousemove","vmousemove","tapdrag"],S,{x:ee[0],y:ee[1]});var Ze=function(Br){return{originalEvent:S,type:Br,position:{x:ee[0],y:ee[1]}}},Wr=function(){r.data.bgActivePosistion=void 0,r.hoverData.selecting||$.emit(Ze("boxstart")),me[4]=1,r.hoverData.selecting=!0,r.redrawHint("select",!0),r.redraw()};if(r.hoverData.which===3){if(je){var $r=Ze("cxtdrag");fe?fe.emit($r):$.emit($r),r.hoverData.cxtDragged=!0,(!r.hoverData.cxtOver||De!==r.hoverData.cxtOver)&&(r.hoverData.cxtOver&&r.hoverData.cxtOver.emit(Ze("cxtdragout")),r.hoverData.cxtOver=De,De&&De.emit(Ze("cxtdragover")))}}else if(r.hoverData.dragging){if(W=!0,$.panningEnabled()&&$.userPanningEnabled()){var It;if(r.hoverData.justStartedPan){var $a=r.hoverData.mdownPos;It={x:(ee[0]-$a[0])*Z,y:(ee[1]-$a[1])*Z},r.hoverData.justStartedPan=!1}else It={x:Pe[0]*Z,y:Pe[1]*Z};$.panBy(It),$.emit(Ze("dragpan")),r.hoverData.dragged=!0}ee=r.projectIntoViewport(S.clientX,S.clientY)}else if(me[4]==1&&(fe==null||fe.pannable())){if(je){if(!r.hoverData.dragging&&$.boxSelectionEnabled()&&(lr||!$.panningEnabled()||!$.userPanningEnabled()))Wr();else if(!r.hoverData.selecting&&$.panningEnabled()&&$.userPanningEnabled()){var bt=o(fe,r.hoverData.downs);bt&&(r.hoverData.dragging=!0,r.hoverData.justStartedPan=!0,me[4]=0,r.data.bgActivePosistion=Wt(ve),r.redrawHint("select",!0),r.redraw())}fe&&fe.pannable()&&fe.active()&&fe.unactivate()}}else{if(fe&&fe.pannable()&&fe.active()&&fe.unactivate(),(!fe||!fe.grabbed())&&De!=Te&&(Te&&n(Te,["mouseout","tapdragout"],S,{x:ee[0],y:ee[1]}),De&&n(De,["mouseover","tapdragover"],S,{x:ee[0],y:ee[1]}),r.hoverData.last=De),fe)if(je){if($.boxSelectionEnabled()&&lr)fe&&fe.grabbed()&&(p(Be),fe.emit(Ze("freeon")),Be.emit(Ze("free")),r.dragData.didDrag&&(fe.emit(Ze("dragfreeon")),Be.emit(Ze("dragfree")))),Wr();else if(fe&&fe.grabbed()&&r.nodeIsDraggable(fe)){var Er=!r.dragData.didDrag;Er&&r.redrawHint("eles",!0),r.dragData.didDrag=!0,r.hoverData.draggingEles||y(Be,{inDragLayer:!0});var dr={x:0,y:0};if(ae(Pe[0])&&ae(Pe[1])&&(dr.x+=Pe[0],dr.y+=Pe[1],Er)){var Cr=r.hoverData.dragDelta;Cr&&ae(Cr[0])&&ae(Cr[1])&&(dr.x+=Cr[0],dr.y+=Cr[1])}r.hoverData.draggingEles=!0,Be.silentShift(dr).emit(Ze("position")).emit(Ze("drag")),r.redrawHint("drag",!0),r.redraw()}}else jr();W=!0}if(me[2]=ee[0],me[3]=ee[1],W)return S.stopPropagation&&S.stopPropagation(),S.preventDefault&&S.preventDefault(),!1}},!1);var P,A,R;r.registerBinding(e,"mouseup",function(S){if(!(r.hoverData.which===1&&S.which!==1&&r.hoverData.capture)){var _=r.hoverData.capture;if(_){r.hoverData.capture=!1;var W=r.cy,$=r.projectIntoViewport(S.clientX,S.clientY),Z=r.selection,se=r.findNearestElement($[0],$[1],!0,!1),ee=r.dragData.possibleDragElements,ve=r.hoverData.down,le=i(S);r.data.bgActivePosistion&&(r.redrawHint("select",!0),r.redraw()),r.hoverData.tapholdCancelled=!0,r.data.bgActivePosistion=void 0,ve&&ve.unactivate();var me=function(Ke){return{originalEvent:S,type:Ke,position:{x:$[0],y:$[1]}}};if(r.hoverData.which===3){var De=me("cxttapend");if(ve?ve.emit(De):W.emit(De),!r.hoverData.cxtDragged){var Te=me("cxttap");ve?ve.emit(Te):W.emit(Te)}r.hoverData.cxtDragged=!1,r.hoverData.which=null}else if(r.hoverData.which===1){if(n(se,["mouseup","tapend","vmouseup"],S,{x:$[0],y:$[1]}),!r.dragData.didDrag&&!r.hoverData.dragged&&!r.hoverData.selecting&&!r.hoverData.isOverThresholdDrag&&(n(ve,["click","tap","vclick"],S,{x:$[0],y:$[1]}),A=!1,S.timeStamp-R<=W.multiClickDebounceTime()?(P&&clearTimeout(P),A=!0,R=null,n(ve,["dblclick","dbltap","vdblclick"],S,{x:$[0],y:$[1]})):(P=setTimeout(function(){A||n(ve,["oneclick","onetap","voneclick"],S,{x:$[0],y:$[1]})},W.multiClickDebounceTime()),R=S.timeStamp)),ve==null&&!r.dragData.didDrag&&!r.hoverData.selecting&&!r.hoverData.dragged&&!i(S)&&(W.$(t).unselect(["tapunselect"]),ee.length>0&&r.redrawHint("eles",!0),r.dragData.possibleDragElements=ee=W.collection()),se==ve&&!r.dragData.didDrag&&!r.hoverData.selecting&&se!=null&&se._private.selectable&&(r.hoverData.dragging||(W.selectionType()==="additive"||le?se.selected()?se.unselect(["tapunselect"]):se.select(["tapselect"]):le||(W.$(t).unmerge(se).unselect(["tapunselect"]),se.select(["tapselect"]))),r.redrawHint("eles",!0)),r.hoverData.selecting){var fe=W.collection(r.getAllInBox(Z[0],Z[1],Z[2],Z[3]));r.redrawHint("select",!0),fe.length>0&&r.redrawHint("eles",!0),W.emit(me("boxend"));var Pe=function(Ke){return Ke.selectable()&&!Ke.selected()};W.selectionType()==="additive"||le||W.$(t).unmerge(fe).unselect(),fe.emit(me("box")).stdFilter(Pe).select().emit(me("boxselect")),r.redraw()}if(r.hoverData.dragging&&(r.hoverData.dragging=!1,r.redrawHint("select",!0),r.redrawHint("eles",!0),r.redraw()),!Z[4]){r.redrawHint("drag",!0),r.redrawHint("eles",!0);var Be=ve&&ve.grabbed();p(ee),Be&&(ve.emit(me("freeon")),ee.emit(me("free")),r.dragData.didDrag&&(ve.emit(me("dragfreeon")),ee.emit(me("dragfree"))))}}Z[4]=0,r.hoverData.down=null,r.hoverData.cxtStarted=!1,r.hoverData.draggingEles=!1,r.hoverData.selecting=!1,r.hoverData.isOverThresholdDrag=!1,r.dragData.didDrag=!1,r.hoverData.dragged=!1,r.hoverData.dragDelta=[],r.hoverData.mdownPos=null,r.hoverData.mdownGPos=null,r.hoverData.which=null}}},!1);var L=[],I=4,M,O=1e5,V=function(S,_){for(var W=0;W<S.length;W++)if(S[W]%_!==0)return!1;return!0},G=function(S){for(var _=Math.abs(S[0]),W=1;W<S.length;W++)if(Math.abs(S[W])!==_)return!1;return!0},N=function(S){var _=!1,W=S.deltaY;if(W==null&&(S.wheelDeltaY!=null?W=S.wheelDeltaY/4:S.wheelDelta!=null&&(W=S.wheelDelta/4)),W!==0){if(M==null)if(L.length>=I){var $=L;if(M=V($,5),!M){var Z=Math.abs($[0]);M=G($)&&Z>5}if(M)for(var se=0;se<$.length;se++)O=Math.min(Math.abs($[se]),O)}else L.push(W),_=!0;else M&&(O=Math.min(Math.abs(W),O));if(!r.scrollingPage){var ee=r.cy,ve=ee.zoom(),le=ee.pan(),me=r.projectIntoViewport(S.clientX,S.clientY),De=[me[0]*ve+le.x,me[1]*ve+le.y];if(r.hoverData.draggingEles||r.hoverData.dragging||r.hoverData.cxtStarted||k()){S.preventDefault();return}if(ee.panningEnabled()&&ee.userPanningEnabled()&&ee.zoomingEnabled()&&ee.userZoomingEnabled()){S.preventDefault(),r.data.wheelZooming=!0,clearTimeout(r.data.wheelTimeout),r.data.wheelTimeout=setTimeout(function(){r.data.wheelZooming=!1,r.redrawHint("eles",!0),r.redraw()},150);var Te;_&&Math.abs(W)>5&&(W=as(W)*5),Te=W/-250,M&&(Te/=O,Te*=3),Te=Te*r.wheelSensitivity;var fe=S.deltaMode===1;fe&&(Te*=33);var Pe=ee.zoom()*Math.pow(10,Te);S.type==="gesturechange"&&(Pe=r.gestureStartZoom*S.scale),ee.zoom({level:Pe,renderedPosition:{x:De[0],y:De[1]}}),ee.emit({type:S.type==="gesturechange"?"pinchzoom":"scrollzoom",originalEvent:S,position:{x:me[0],y:me[1]}})}}}};r.registerBinding(r.container,"wheel",N,!0),r.registerBinding(e,"scroll",function(S){r.scrollingPage=!0,clearTimeout(r.scrollingPageTimeout),r.scrollingPageTimeout=setTimeout(function(){r.scrollingPage=!1},250)},!0),r.registerBinding(r.container,"gesturestart",function(S){r.gestureStartZoom=r.cy.zoom(),r.hasTouchStarted||S.preventDefault()},!0),r.registerBinding(r.container,"gesturechange",function(X){r.hasTouchStarted||N(X)},!0),r.registerBinding(r.container,"mouseout",function(S){var _=r.projectIntoViewport(S.clientX,S.clientY);r.cy.emit({originalEvent:S,type:"mouseout",position:{x:_[0],y:_[1]}})},!1),r.registerBinding(r.container,"mouseover",function(S){var _=r.projectIntoViewport(S.clientX,S.clientY);r.cy.emit({originalEvent:S,type:"mouseover",position:{x:_[0],y:_[1]}})},!1);var F,U,Q,K,j,re,ne,J,z,q,H,Y,te,ce=function(S,_,W,$){return Math.sqrt((W-S)*(W-S)+($-_)*($-_))},Ae=function(S,_,W,$){return(W-S)*(W-S)+($-_)*($-_)},Ce;r.registerBinding(r.container,"touchstart",Ce=function(S){if(r.hasTouchStarted=!0,!!D(S)){b(),r.touchData.capture=!0,r.data.bgActivePosistion=void 0;var _=r.cy,W=r.touchData.now,$=r.touchData.earlier;if(S.touches[0]){var Z=r.projectIntoViewport(S.touches[0].clientX,S.touches[0].clientY);W[0]=Z[0],W[1]=Z[1]}if(S.touches[1]){var Z=r.projectIntoViewport(S.touches[1].clientX,S.touches[1].clientY);W[2]=Z[0],W[3]=Z[1]}if(S.touches[2]){var Z=r.projectIntoViewport(S.touches[2].clientX,S.touches[2].clientY);W[4]=Z[0],W[5]=Z[1]}var se=function(lr){return{originalEvent:S,type:lr,position:{x:W[0],y:W[1]}}};if(S.touches[1]){r.touchData.singleTouchMoved=!0,p(r.dragData.touchDragEles);var ee=r.findContainerClientCoords();z=ee[0],q=ee[1],H=ee[2],Y=ee[3],F=S.touches[0].clientX-z,U=S.touches[0].clientY-q,Q=S.touches[1].clientX-z,K=S.touches[1].clientY-q,te=0<=F&&F<=H&&0<=Q&&Q<=H&&0<=U&&U<=Y&&0<=K&&K<=Y;var ve=_.pan(),le=_.zoom();j=ce(F,U,Q,K),re=Ae(F,U,Q,K),ne=[(F+Q)/2,(U+K)/2],J=[(ne[0]-ve.x)/le,(ne[1]-ve.y)/le];var me=200,De=me*me;if(re<De&&!S.touches[2]){var Te=r.findNearestElement(W[0],W[1],!0,!0),fe=r.findNearestElement(W[2],W[3],!0,!0);Te&&Te.isNode()?(Te.activate().emit(se("cxttapstart")),r.touchData.start=Te):fe&&fe.isNode()?(fe.activate().emit(se("cxttapstart")),r.touchData.start=fe):_.emit(se("cxttapstart")),r.touchData.start&&(r.touchData.start._private.grabbed=!1),r.touchData.cxt=!0,r.touchData.cxtDragged=!1,r.data.bgActivePosistion=void 0,r.redraw();return}}if(S.touches[2])_.boxSelectionEnabled()&&S.preventDefault();else if(!S.touches[1]){if(S.touches[0]){var Pe=r.findNearestElements(W[0],W[1],!0,!0),Be=Pe[0];if(Be!=null&&(Be.activate(),r.touchData.start=Be,r.touchData.starts=Pe,r.nodeIsGrabbable(Be))){var je=r.dragData.touchDragEles=_.collection(),Ke=null;r.redrawHint("eles",!0),r.redrawHint("drag",!0),Be.selected()?(Ke=_.$(function(er){return er.selected()&&r.nodeIsGrabbable(er)}),y(Ke,{addToList:je})):g(Be,{addToList:je}),f(Be),Be.emit(se("grabon")),Ke?Ke.forEach(function(er){er.emit(se("grab"))}):Be.emit(se("grab"))}n(Be,["touchstart","tapstart","vmousedown"],S,{x:W[0],y:W[1]}),Be==null&&(r.data.bgActivePosistion={x:Z[0],y:Z[1]},r.redrawHint("select",!0),r.redraw()),r.touchData.singleTouchMoved=!1,r.touchData.singleTouchStartTime=+new Date,clearTimeout(r.touchData.tapholdTimeout),r.touchData.tapholdTimeout=setTimeout(function(){r.touchData.singleTouchMoved===!1&&!r.pinching&&!r.touchData.selecting&&n(r.touchData.start,["taphold"],S,{x:W[0],y:W[1]})},r.tapholdDuration)}}if(S.touches.length>=1){for(var mr=r.touchData.startPosition=[null,null,null,null,null,null],Ye=0;Ye<W.length;Ye++)mr[Ye]=$[Ye]=W[Ye];var ir=S.touches[0];r.touchData.startGPosition=[ir.clientX,ir.clientY]}}},!1);var we;r.registerBinding(e,"touchmove",we=function(S){var _=r.touchData.capture;if(!(!_&&!D(S))){var W=r.selection,$=r.cy,Z=r.touchData.now,se=r.touchData.earlier,ee=$.zoom();if(S.touches[0]){var ve=r.projectIntoViewport(S.touches[0].clientX,S.touches[0].clientY);Z[0]=ve[0],Z[1]=ve[1]}if(S.touches[1]){var ve=r.projectIntoViewport(S.touches[1].clientX,S.touches[1].clientY);Z[2]=ve[0],Z[3]=ve[1]}if(S.touches[2]){var ve=r.projectIntoViewport(S.touches[2].clientX,S.touches[2].clientY);Z[4]=ve[0],Z[5]=ve[1]}var le=function(jf){return{originalEvent:S,type:jf,position:{x:Z[0],y:Z[1]}}},me=r.touchData.startGPosition,De;if(_&&S.touches[0]&&me){for(var Te=[],fe=0;fe<Z.length;fe++)Te[fe]=Z[fe]-se[fe];var Pe=S.touches[0].clientX-me[0],Be=Pe*Pe,je=S.touches[0].clientY-me[1],Ke=je*je,mr=Be+Ke;De=mr>=r.touchTapThreshold2}if(_&&r.touchData.cxt){S.preventDefault();var Ye=S.touches[0].clientX-z,ir=S.touches[0].clientY-q,er=S.touches[1].clientX-z,lr=S.touches[1].clientY-q,jr=Ae(Ye,ir,er,lr),Ze=jr/re,Wr=150,$r=Wr*Wr,It=1.5,$a=It*It;if(Ze>=$a||jr>=$r){r.touchData.cxt=!1,r.data.bgActivePosistion=void 0,r.redrawHint("select",!0);var bt=le("cxttapend");r.touchData.start?(r.touchData.start.unactivate().emit(bt),r.touchData.start=null):$.emit(bt)}}if(_&&r.touchData.cxt){var bt=le("cxtdrag");r.data.bgActivePosistion=void 0,r.redrawHint("select",!0),r.touchData.start?r.touchData.start.emit(bt):$.emit(bt),r.touchData.start&&(r.touchData.start._private.grabbed=!1),r.touchData.cxtDragged=!0;var Er=r.findNearestElement(Z[0],Z[1],!0,!0);(!r.touchData.cxtOver||Er!==r.touchData.cxtOver)&&(r.touchData.cxtOver&&r.touchData.cxtOver.emit(le("cxtdragout")),r.touchData.cxtOver=Er,Er&&Er.emit(le("cxtdragover")))}else if(_&&S.touches[2]&&$.boxSelectionEnabled())S.preventDefault(),r.data.bgActivePosistion=void 0,this.lastThreeTouch=+new Date,r.touchData.selecting||$.emit(le("boxstart")),r.touchData.selecting=!0,r.touchData.didSelect=!0,W[4]=1,!W||W.length===0||W[0]===void 0?(W[0]=(Z[0]+Z[2]+Z[4])/3,W[1]=(Z[1]+Z[3]+Z[5])/3,W[2]=(Z[0]+Z[2]+Z[4])/3+1,W[3]=(Z[1]+Z[3]+Z[5])/3+1):(W[2]=(Z[0]+Z[2]+Z[4])/3,W[3]=(Z[1]+Z[3]+Z[5])/3),r.redrawHint("select",!0),r.redraw();else if(_&&S.touches[1]&&!r.touchData.didSelect&&$.zoomingEnabled()&&$.panningEnabled()&&$.userZoomingEnabled()&&$.userPanningEnabled()){S.preventDefault(),r.data.bgActivePosistion=void 0,r.redrawHint("select",!0);var dr=r.dragData.touchDragEles;if(dr){r.redrawHint("drag",!0);for(var Cr=0;Cr<dr.length;Cr++){var sa=dr[Cr]._private;sa.grabbed=!1,sa.rscratch.inDragLayer=!1}}var Br=r.touchData.start,Ye=S.touches[0].clientX-z,ir=S.touches[0].clientY-q,er=S.touches[1].clientX-z,lr=S.touches[1].clientY-q,ws=ce(Ye,ir,er,lr),Wf=ws/j;if(te){var $f=Ye-F,Uf=ir-U,Kf=er-Q,Xf=lr-K,Yf=($f+Kf)/2,Zf=(Uf+Xf)/2,ua=$.zoom(),Zn=ua*Wf,Ua=$.pan(),xs=J[0]*ua+Ua.x,Es=J[1]*ua+Ua.y,Qf={x:-Zn/ua*(xs-Ua.x-Yf)+xs,y:-Zn/ua*(Es-Ua.y-Zf)+Es};if(Br&&Br.active()){var dr=r.dragData.touchDragEles;p(dr),r.redrawHint("drag",!0),r.redrawHint("eles",!0),Br.unactivate().emit(le("freeon")),dr.emit(le("free")),r.dragData.didDrag&&(Br.emit(le("dragfreeon")),dr.emit(le("dragfree")))}$.viewport({zoom:Zn,pan:Qf,cancelOnFailedZoom:!0}),$.emit(le("pinchzoom")),j=ws,F=Ye,U=ir,Q=er,K=lr,r.pinching=!0}if(S.touches[0]){var ve=r.projectIntoViewport(S.touches[0].clientX,S.touches[0].clientY);Z[0]=ve[0],Z[1]=ve[1]}if(S.touches[1]){var ve=r.projectIntoViewport(S.touches[1].clientX,S.touches[1].clientY);Z[2]=ve[0],Z[3]=ve[1]}if(S.touches[2]){var ve=r.projectIntoViewport(S.touches[2].clientX,S.touches[2].clientY);Z[4]=ve[0],Z[5]=ve[1]}}else if(S.touches[0]&&!r.touchData.didSelect){var Mr=r.touchData.start,Qn=r.touchData.last,Er;if(!r.hoverData.draggingEles&&!r.swipePanning&&(Er=r.findNearestElement(Z[0],Z[1],!0,!0)),_&&Mr!=null&&S.preventDefault(),_&&Mr!=null&&r.nodeIsDraggable(Mr))if(De){var dr=r.dragData.touchDragEles,Cs=!r.dragData.didDrag;Cs&&y(dr,{inDragLayer:!0}),r.dragData.didDrag=!0;var la={x:0,y:0};if(ae(Te[0])&&ae(Te[1])&&(la.x+=Te[0],la.y+=Te[1],Cs)){r.redrawHint("eles",!0);var Lr=r.touchData.dragDelta;Lr&&ae(Lr[0])&&ae(Lr[1])&&(la.x+=Lr[0],la.y+=Lr[1])}r.hoverData.draggingEles=!0,dr.silentShift(la).emit(le("position")).emit(le("drag")),r.redrawHint("drag",!0),r.touchData.startPosition[0]==se[0]&&r.touchData.startPosition[1]==se[1]&&r.redrawHint("eles",!0),r.redraw()}else{var Lr=r.touchData.dragDelta=r.touchData.dragDelta||[];Lr.length===0?(Lr.push(Te[0]),Lr.push(Te[1])):(Lr[0]+=Te[0],Lr[1]+=Te[1])}if(n(Mr||Er,["touchmove","tapdrag","vmousemove"],S,{x:Z[0],y:Z[1]}),(!Mr||!Mr.grabbed())&&Er!=Qn&&(Qn&&Qn.emit(le("tapdragout")),Er&&Er.emit(le("tapdragover"))),r.touchData.last=Er,_)for(var Cr=0;Cr<Z.length;Cr++)Z[Cr]&&r.touchData.startPosition[Cr]&&De&&(r.touchData.singleTouchMoved=!0);if(_&&(Mr==null||Mr.pannable())&&$.panningEnabled()&&$.userPanningEnabled()){var Jf=o(Mr,r.touchData.starts);Jf&&(S.preventDefault(),r.data.bgActivePosistion||(r.data.bgActivePosistion=Wt(r.touchData.startPosition)),r.swipePanning?($.panBy({x:Te[0]*ee,y:Te[1]*ee}),$.emit(le("dragpan"))):De&&(r.swipePanning=!0,$.panBy({x:Pe*ee,y:je*ee}),$.emit(le("dragpan")),Mr&&(Mr.unactivate(),r.redrawHint("select",!0),r.touchData.start=null)));var ve=r.projectIntoViewport(S.touches[0].clientX,S.touches[0].clientY);Z[0]=ve[0],Z[1]=ve[1]}}for(var fe=0;fe<Z.length;fe++)se[fe]=Z[fe];_&&S.touches.length>0&&!r.hoverData.draggingEles&&!r.swipePanning&&r.data.bgActivePosistion!=null&&(r.data.bgActivePosistion=void 0,r.redrawHint("select",!0),r.redraw())}},!1);var ye;r.registerBinding(e,"touchcancel",ye=function(S){var _=r.touchData.start;r.touchData.capture=!1,_&&_.unactivate()});var ie,he,de,Ee;if(r.registerBinding(e,"touchend",ie=function(S){var _=r.touchData.start,W=r.touchData.capture;if(W)S.touches.length===0&&(r.touchData.capture=!1),S.preventDefault();else return;var $=r.selection;r.swipePanning=!1,r.hoverData.draggingEles=!1;var Z=r.cy,se=Z.zoom(),ee=r.touchData.now,ve=r.touchData.earlier;if(S.touches[0]){var le=r.projectIntoViewport(S.touches[0].clientX,S.touches[0].clientY);ee[0]=le[0],ee[1]=le[1]}if(S.touches[1]){var le=r.projectIntoViewport(S.touches[1].clientX,S.touches[1].clientY);ee[2]=le[0],ee[3]=le[1]}if(S.touches[2]){var le=r.projectIntoViewport(S.touches[2].clientX,S.touches[2].clientY);ee[4]=le[0],ee[5]=le[1]}var me=function($r){return{originalEvent:S,type:$r,position:{x:ee[0],y:ee[1]}}};_&&_.unactivate();var De;if(r.touchData.cxt){if(De=me("cxttapend"),_?_.emit(De):Z.emit(De),!r.touchData.cxtDragged){var Te=me("cxttap");_?_.emit(Te):Z.emit(Te)}r.touchData.start&&(r.touchData.start._private.grabbed=!1),r.touchData.cxt=!1,r.touchData.start=null,r.redraw();return}if(!S.touches[2]&&Z.boxSelectionEnabled()&&r.touchData.selecting){r.touchData.selecting=!1;var fe=Z.collection(r.getAllInBox($[0],$[1],$[2],$[3]));$[0]=void 0,$[1]=void 0,$[2]=void 0,$[3]=void 0,$[4]=0,r.redrawHint("select",!0),Z.emit(me("boxend"));var Pe=function($r){return $r.selectable()&&!$r.selected()};fe.emit(me("box")).stdFilter(Pe).select().emit(me("boxselect")),fe.nonempty()&&r.redrawHint("eles",!0),r.redraw()}if(_?.unactivate(),S.touches[2])r.data.bgActivePosistion=void 0,r.redrawHint("select",!0);else if(!S.touches[1]){if(!S.touches[0]){if(!S.touches[0]){r.data.bgActivePosistion=void 0,r.redrawHint("select",!0);var Be=r.dragData.touchDragEles;if(_!=null){var je=_._private.grabbed;p(Be),r.redrawHint("drag",!0),r.redrawHint("eles",!0),je&&(_.emit(me("freeon")),Be.emit(me("free")),r.dragData.didDrag&&(_.emit(me("dragfreeon")),Be.emit(me("dragfree")))),n(_,["touchend","tapend","vmouseup","tapdragout"],S,{x:ee[0],y:ee[1]}),_.unactivate(),r.touchData.start=null}else{var Ke=r.findNearestElement(ee[0],ee[1],!0,!0);n(Ke,["touchend","tapend","vmouseup","tapdragout"],S,{x:ee[0],y:ee[1]})}var mr=r.touchData.startPosition[0]-ee[0],Ye=mr*mr,ir=r.touchData.startPosition[1]-ee[1],er=ir*ir,lr=Ye+er,jr=lr*se*se;r.touchData.singleTouchMoved||(_||Z.$(":selected").unselect(["tapunselect"]),n(_,["tap","vclick"],S,{x:ee[0],y:ee[1]}),he=!1,S.timeStamp-Ee<=Z.multiClickDebounceTime()?(de&&clearTimeout(de),he=!0,Ee=null,n(_,["dbltap","vdblclick"],S,{x:ee[0],y:ee[1]})):(de=setTimeout(function(){he||n(_,["onetap","voneclick"],S,{x:ee[0],y:ee[1]})},Z.multiClickDebounceTime()),Ee=S.timeStamp)),_!=null&&!r.dragData.didDrag&&_._private.selectable&&jr<r.touchTapThreshold2&&!r.pinching&&(Z.selectionType()==="single"?(Z.$(t).unmerge(_).unselect(["tapunselect"]),_.select(["tapselect"])):_.selected()?_.unselect(["tapunselect"]):_.select(["tapselect"]),r.redrawHint("eles",!0)),r.touchData.singleTouchMoved=!0}}}for(var Ze=0;Ze<ee.length;Ze++)ve[Ze]=ee[Ze];r.dragData.didDrag=!1,S.touches.length===0&&(r.touchData.dragDelta=[],r.touchData.startPosition=[null,null,null,null,null,null],r.touchData.startGPosition=null,r.touchData.didSelect=!1),S.touches.length<2&&(S.touches.length===1&&(r.touchData.startGPosition=[S.touches[0].clientX,S.touches[0].clientY]),r.pinching=!1,r.redrawHint("eles",!0),r.redraw())},!1),typeof TouchEvent>"u"){var pe=[],Se=function(S){return{clientX:S.clientX,clientY:S.clientY,force:1,identifier:S.pointerId,pageX:S.pageX,pageY:S.pageY,radiusX:S.width/2,radiusY:S.height/2,screenX:S.screenX,screenY:S.screenY,target:S.target}},Re=function(S){return{event:S,touch:Se(S)}},Oe=function(S){pe.push(Re(S))},Ne=function(S){for(var _=0;_<pe.length;_++){var W=pe[_];if(W.event.pointerId===S.pointerId){pe.splice(_,1);return}}},ze=function(S){var _=pe.filter(function(W){return W.event.pointerId===S.pointerId})[0];_.event=S,_.touch=Se(S)},xe=function(S){S.touches=pe.map(function(_){return _.touch})},ue=function(S){return S.pointerType==="mouse"||S.pointerType===4};r.registerBinding(r.container,"pointerdown",function(X){ue(X)||(X.preventDefault(),Oe(X),xe(X),Ce(X))}),r.registerBinding(r.container,"pointerup",function(X){ue(X)||(Ne(X),xe(X),ie(X))}),r.registerBinding(r.container,"pointercancel",function(X){ue(X)||(Ne(X),xe(X),ye(X))}),r.registerBinding(r.container,"pointermove",function(X){ue(X)||(X.preventDefault(),ze(X),xe(X),we(X))})}};var Qr={};Qr.generatePolygon=function(r,e){return this.nodeShapes[r]={renderer:this,name:r,points:e,draw:function(a,n,i,o,s,l){this.renderer.nodeShapeImpl("polygon",a,n,i,o,s,this.points)},intersectLine:function(a,n,i,o,s,l,u,v){return Da(s,l,this.points,a,n,i/2,o/2,u)},checkPoint:function(a,n,i,o,s,l,u,v){return Zr(a,n,this.points,l,u,o,s,[0,-1],i)},hasMiterBounds:r!=="rectangle",miterBounds:function(a,n,i,o,s,l){return Ah(this.points,a,n,i,o,s)}}};Qr.generateEllipse=function(){return this.nodeShapes.ellipse={renderer:this,name:"ellipse",draw:function(e,t,a,n,i,o){this.renderer.nodeShapeImpl(this.name,e,t,a,n,i)},intersectLine:function(e,t,a,n,i,o,s,l){return Fh(i,o,e,t,a/2+s,n/2+s)},checkPoint:function(e,t,a,n,i,o,s,l){return kt(e,t,n,i,o,s,a)}}};Qr.generateRoundPolygon=function(r,e){return this.nodeShapes[r]={renderer:this,name:r,points:e,getOrCreateCorners:function(a,n,i,o,s,l,u){if(l[u]!==void 0&&l[u+"-cx"]===a&&l[u+"-cy"]===n)return l[u];l[u]=new Array(e.length/2),l[u+"-cx"]=a,l[u+"-cy"]=n;var v=i/2,f=o/2;s=s==="auto"?Ev(i,o):s;for(var c=new Array(e.length/2),d=0;d<e.length/2;d++)c[d]={x:a+v*e[d*2],y:n+f*e[d*2+1]};var h,y,g,p,m=c.length;for(y=c[m-1],h=0;h<m;h++)g=c[h%m],p=c[(h+1)%m],l[u][h]=ps(y,g,p,s),y=g,g=p;return l[u]},draw:function(a,n,i,o,s,l,u){this.renderer.nodeShapeImpl("round-polygon",a,n,i,o,s,this.points,this.getOrCreateCorners(n,i,o,s,l,u,"drawCorners"))},intersectLine:function(a,n,i,o,s,l,u,v,f){return qh(s,l,this.points,a,n,i,o,u,this.getOrCreateCorners(a,n,i,o,v,f,"corners"))},checkPoint:function(a,n,i,o,s,l,u,v,f){return zh(a,n,this.points,l,u,o,s,this.getOrCreateCorners(l,u,o,s,v,f,"corners"))}}};Qr.generateRoundRectangle=function(){return this.nodeShapes["round-rectangle"]=this.nodeShapes.roundrectangle={renderer:this,name:"round-rectangle",points:br(4,0),draw:function(e,t,a,n,i,o){this.renderer.nodeShapeImpl(this.name,e,t,a,n,i,this.points,o)},intersectLine:function(e,t,a,n,i,o,s,l){return wv(i,o,e,t,a,n,s,l)},checkPoint:function(e,t,a,n,i,o,s,l){var u=n/2,v=i/2;l=l==="auto"?vt(n,i):l,l=Math.min(u,v,l);var f=l*2;return!!(Zr(e,t,this.points,o,s,n,i-f,[0,-1],a)||Zr(e,t,this.points,o,s,n-f,i,[0,-1],a)||kt(e,t,f,f,o-u+l,s-v+l,a)||kt(e,t,f,f,o+u-l,s-v+l,a)||kt(e,t,f,f,o+u-l,s+v-l,a)||kt(e,t,f,f,o-u+l,s+v-l,a))}}};Qr.generateCutRectangle=function(){return this.nodeShapes["cut-rectangle"]=this.nodeShapes.cutrectangle={renderer:this,name:"cut-rectangle",cornerLength:is(),points:br(4,0),draw:function(e,t,a,n,i,o){this.renderer.nodeShapeImpl(this.name,e,t,a,n,i,null,o)},generateCutTrianglePts:function(e,t,a,n,i){var o=i==="auto"?this.cornerLength:i,s=t/2,l=e/2,u=a-l,v=a+l,f=n-s,c=n+s;return{topLeft:[u,f+o,u+o,f,u+o,f+o],topRight:[v-o,f,v,f+o,v-o,f+o],bottomRight:[v,c-o,v-o,c,v-o,c-o],bottomLeft:[u+o,c,u,c-o,u+o,c-o]}},intersectLine:function(e,t,a,n,i,o,s,l){var u=this.generateCutTrianglePts(a+2*s,n+2*s,e,t,l),v=[].concat.apply([],[u.topLeft.splice(0,4),u.topRight.splice(0,4),u.bottomRight.splice(0,4),u.bottomLeft.splice(0,4)]);return Da(i,o,v,e,t)},checkPoint:function(e,t,a,n,i,o,s,l){var u=l==="auto"?this.cornerLength:l;if(Zr(e,t,this.points,o,s,n,i-2*u,[0,-1],a)||Zr(e,t,this.points,o,s,n-2*u,i,[0,-1],a))return!0;var v=this.generateCutTrianglePts(n,i,o,s);return Sr(e,t,v.topLeft)||Sr(e,t,v.topRight)||Sr(e,t,v.bottomRight)||Sr(e,t,v.bottomLeft)}}};Qr.generateBarrel=function(){return this.nodeShapes.barrel={renderer:this,name:"barrel",points:br(4,0),draw:function(e,t,a,n,i,o){this.renderer.nodeShapeImpl(this.name,e,t,a,n,i)},intersectLine:function(e,t,a,n,i,o,s,l){var u=.15,v=.5,f=.85,c=this.generateBarrelBezierPts(a+2*s,n+2*s,e,t),d=function(g){var p=Kt({x:g[0],y:g[1]},{x:g[2],y:g[3]},{x:g[4],y:g[5]},u),m=Kt({x:g[0],y:g[1]},{x:g[2],y:g[3]},{x:g[4],y:g[5]},v),b=Kt({x:g[0],y:g[1]},{x:g[2],y:g[3]},{x:g[4],y:g[5]},f);return[g[0],g[1],p.x,p.y,m.x,m.y,b.x,b.y,g[4],g[5]]},h=[].concat(d(c.topLeft),d(c.topRight),d(c.bottomRight),d(c.bottomLeft));return Da(i,o,h,e,t)},generateBarrelBezierPts:function(e,t,a,n){var i=t/2,o=e/2,s=a-o,l=a+o,u=n-i,v=n+i,f=Ro(e,t),c=f.heightOffset,d=f.widthOffset,h=f.ctrlPtOffsetPct*e,y={topLeft:[s,u+c,s+h,u,s+d,u],topRight:[l-d,u,l-h,u,l,u+c],bottomRight:[l,v-c,l-h,v,l-d,v],bottomLeft:[s+d,v,s+h,v,s,v-c]};return y.topLeft.isTop=!0,y.topRight.isTop=!0,y.bottomLeft.isBottom=!0,y.bottomRight.isBottom=!0,y},checkPoint:function(e,t,a,n,i,o,s,l){var u=Ro(n,i),v=u.heightOffset,f=u.widthOffset;if(Zr(e,t,this.points,o,s,n,i-2*v,[0,-1],a)||Zr(e,t,this.points,o,s,n-2*f,i,[0,-1],a))return!0;for(var c=this.generateBarrelBezierPts(n,i,o,s),d=function(T,k,D){var B=D[4],P=D[2],A=D[0],R=D[5],L=D[1],I=Math.min(B,A),M=Math.max(B,A),O=Math.min(R,L),V=Math.max(R,L);if(I<=T&&T<=M&&O<=k&&k<=V){var G=_h(B,P,A),N=Lh(G[0],G[1],G[2],T),F=N.filter(function(U){return 0<=U&&U<=1});if(F.length>0)return F[0]}return null},h=Object.keys(c),y=0;y<h.length;y++){var g=h[y],p=c[g],m=d(e,t,p);if(m!=null){var b=p[5],w=p[3],E=p[1],C=or(b,w,E,m);if(p.isTop&&C<=t||p.isBottom&&t<=C)return!0}}return!1}}};Qr.generateBottomRoundrectangle=function(){return this.nodeShapes["bottom-round-rectangle"]=this.nodeShapes.bottomroundrectangle={renderer:this,name:"bottom-round-rectangle",points:br(4,0),draw:function(e,t,a,n,i,o){this.renderer.nodeShapeImpl(this.name,e,t,a,n,i,this.points,o)},intersectLine:function(e,t,a,n,i,o,s,l){var u=e-(a/2+s),v=t-(n/2+s),f=v,c=e+(a/2+s),d=it(i,o,e,t,u,v,c,f,!1);return d.length>0?d:wv(i,o,e,t,a,n,s,l)},checkPoint:function(e,t,a,n,i,o,s,l){l=l==="auto"?vt(n,i):l;var u=2*l;if(Zr(e,t,this.points,o,s,n,i-u,[0,-1],a)||Zr(e,t,this.points,o,s,n-u,i,[0,-1],a))return!0;var v=n/2+2*a,f=i/2+2*a,c=[o-v,s-f,o-v,s,o+v,s,o+v,s-f];return!!(Sr(e,t,c)||kt(e,t,u,u,o+n/2-l,s+i/2-l,a)||kt(e,t,u,u,o-n/2+l,s+i/2-l,a))}}};Qr.registerNodeShapes=function(){var r=this.nodeShapes={},e=this;this.generateEllipse(),this.generatePolygon("triangle",br(3,0)),this.generateRoundPolygon("round-triangle",br(3,0)),this.generatePolygon("rectangle",br(4,0)),r.square=r.rectangle,this.generateRoundRectangle(),this.generateCutRectangle(),this.generateBarrel(),this.generateBottomRoundrectangle();{var t=[0,1,1,0,0,-1,-1,0];this.generatePolygon("diamond",t),this.generateRoundPolygon("round-diamond",t)}this.generatePolygon("pentagon",br(5,0)),this.generateRoundPolygon("round-pentagon",br(5,0)),this.generatePolygon("hexagon",br(6,0)),this.generateRoundPolygon("round-hexagon",br(6,0)),this.generatePolygon("heptagon",br(7,0)),this.generateRoundPolygon("round-heptagon",br(7,0)),this.generatePolygon("octagon",br(8,0)),this.generateRoundPolygon("round-octagon",br(8,0));var a=new Array(20);{var n=Ao(5,0),i=Ao(5,Math.PI/5),o=.5*(3-Math.sqrt(5));o*=1.57;for(var s=0;s<i.length/2;s++)i[s*2]*=o,i[s*2+1]*=o;for(var s=0;s<20/4;s++)a[s*4]=n[s*2],a[s*4+1]=n[s*2+1],a[s*4+2]=i[s*2],a[s*4+3]=i[s*2+1]}a=xv(a),this.generatePolygon("star",a),this.generatePolygon("vee",[-1,-1,0,-.333,1,-1,0,1]),this.generatePolygon("rhomboid",[-1,-1,.333,-1,1,1,-.333,1]),this.generatePolygon("right-rhomboid",[-.333,-1,1,-1,.333,1,-1,1]),this.nodeShapes.concavehexagon=this.generatePolygon("concave-hexagon",[-1,-.95,-.75,0,-1,.95,1,.95,.75,0,1,-.95]);{var l=[-1,-1,.25,-1,1,0,.25,1,-1,1];this.generatePolygon("tag",l),this.generateRoundPolygon("round-tag",l)}r.makePolygon=function(u){var v=u.join("$"),f="polygon-"+v,c;return(c=this[f])?c:e.generatePolygon(f,u)}};var Ha={};Ha.timeToRender=function(){return this.redrawTotalTime/this.redrawCount};Ha.redraw=function(r){r=r||pv();var e=this;e.averageRedrawTime===void 0&&(e.averageRedrawTime=0),e.lastRedrawTime===void 0&&(e.lastRedrawTime=0),e.lastDrawTime===void 0&&(e.lastDrawTime=0),e.requestedFrame=!0,e.renderOptions=r};Ha.beforeRender=function(r,e){if(!this.destroyed){e==null&&$e("Priority is not optional for beforeRender");var t=this.beforeRenderCallbacks;t.push({fn:r,priority:e}),t.sort(function(a,n){return n.priority-a.priority})}};var Ol=function(e,t,a){for(var n=e.beforeRenderCallbacks,i=0;i<n.length;i++)n[i].fn(t,a)};Ha.startRenderLoop=function(){var r=this,e=r.cy;if(!r.renderLoopStarted){r.renderLoopStarted=!0;var t=function(n){if(!r.destroyed){if(!e.batching())if(r.requestedFrame&&!r.skipFrame){Ol(r,!0,n);var i=Yr();r.render(r.renderOptions);var o=r.lastDrawTime=Yr();r.averageRedrawTime===void 0&&(r.averageRedrawTime=o-i),r.redrawCount===void 0&&(r.redrawCount=0),r.redrawCount++,r.redrawTotalTime===void 0&&(r.redrawTotalTime=0);var s=o-i;r.redrawTotalTime+=s,r.lastRedrawTime=s,r.averageRedrawTime=r.averageRedrawTime/2+s/2,r.requestedFrame=!1}else Ol(r,!1,n);r.skipFrame=!1,wn(t)}};wn(t)}};var ay=function(e){this.init(e)},Cf=ay,oa=Cf.prototype;oa.clientFunctions=["redrawHint","render","renderTo","matchCanvasSize","nodeShapeImpl","arrowShapeImpl"];oa.init=function(r){var e=this;e.options=r,e.cy=r.cy;var t=e.container=r.cy.container(),a=e.cy.window();if(a){var n=a.document,i=n.head,o="__________cytoscape_stylesheet",s="__________cytoscape_container",l=n.getElementById(o)!=null;if(t.className.indexOf(s)<0&&(t.className=(t.className||"")+" "+s),!l){var u=n.createElement("style");u.id=o,u.textContent="."+s+" { position: relative; }",i.insertBefore(u,i.children[0])}var v=a.getComputedStyle(t),f=v.getPropertyValue("position");f==="static"&&Ve("A Cytoscape container has style position:static and so can not use UI extensions properly")}e.selection=[void 0,void 0,void 0,void 0,0],e.bezierProjPcts=[.05,.225,.4,.5,.6,.775,.95],e.hoverData={down:null,last:null,downTime:null,triggerMode:null,dragging:!1,initialPan:[null,null],capture:!1},e.dragData={possibleDragElements:[]},e.touchData={start:null,capture:!1,startPosition:[null,null,null,null,null,null],singleTouchStartTime:null,singleTouchMoved:!0,now:[null,null,null,null,null,null],earlier:[null,null,null,null,null,null]},e.redraws=0,e.showFps=r.showFps,e.debug=r.debug,e.webgl=r.webgl,e.hideEdgesOnViewport=r.hideEdgesOnViewport,e.textureOnViewport=r.textureOnViewport,e.wheelSensitivity=r.wheelSensitivity,e.motionBlurEnabled=r.motionBlur,e.forcedPixelRatio=ae(r.pixelRatio)?r.pixelRatio:null,e.motionBlur=r.motionBlur,e.motionBlurOpacity=r.motionBlurOpacity,e.motionBlurTransparency=1-e.motionBlurOpacity,e.motionBlurPxRatio=1,e.mbPxRBlurry=1,e.minMbLowQualFrames=4,e.fullQualityMb=!1,e.clearedForMotionBlur=[],e.desktopTapThreshold=r.desktopTapThreshold,e.desktopTapThreshold2=r.desktopTapThreshold*r.desktopTapThreshold,e.touchTapThreshold=r.touchTapThreshold,e.touchTapThreshold2=r.touchTapThreshold*r.touchTapThreshold,e.tapholdDuration=500,e.bindings=[],e.beforeRenderCallbacks=[],e.beforeRenderPriorities={animations:400,eleCalcs:300,eleTxrDeq:200,lyrTxrDeq:150,lyrTxrSkip:100},e.registerNodeShapes(),e.registerArrowShapes(),e.registerCalculationListeners()};oa.notify=function(r,e){var t=this,a=t.cy;if(!this.destroyed){if(r==="init"){t.load();return}if(r==="destroy"){t.destroy();return}(r==="add"||r==="remove"||r==="move"&&a.hasCompoundNodes()||r==="load"||r==="zorder"||r==="mount")&&t.invalidateCachedZSortedEles(),r==="viewport"&&t.redrawHint("select",!0),r==="gc"&&t.redrawHint("gc",!0),(r==="load"||r==="resize"||r==="mount")&&(t.invalidateContainerClientCoordsCache(),t.matchCanvasSize(t.container)),t.redrawHint("eles",!0),t.redrawHint("drag",!0),this.startRenderLoop(),this.redraw()}};oa.destroy=function(){var r=this;r.destroyed=!0,r.cy.stopAnimationLoop();for(var e=0;e<r.bindings.length;e++){var t=r.bindings[e],a=t,n=a.target;(n.off||n.removeEventListener).apply(n,a.args)}if(r.bindings=[],r.beforeRenderCallbacks=[],r.onUpdateEleCalcsFns=[],r.removeObserver&&r.removeObserver.disconnect(),r.styleObserver&&r.styleObserver.disconnect(),r.resizeObserver&&r.resizeObserver.disconnect(),r.labelCalcDiv)try{document.body.removeChild(r.labelCalcDiv)}catch{}};oa.isHeadless=function(){return!1};[gs,xf,Ef,ia,Qr,Ha].forEach(function(r){be(oa,r)});var xo=1e3/60,Tf={setupDequeueing:function(e){return function(){var a=this,n=this.renderer;if(!a.dequeueingSetup){a.dequeueingSetup=!0;var i=Fa(function(){n.redrawHint("eles",!0),n.redrawHint("drag",!0),n.redraw()},e.deqRedrawThreshold),o=function(u,v){var f=Yr(),c=n.averageRedrawTime,d=n.lastRedrawTime,h=[],y=n.cy.extent(),g=n.getPixelRatio();for(u||n.flushRenderedStyleQueue();;){var p=Yr(),m=p-f,b=p-v;if(d<xo){var w=xo-(u?c:0);if(b>=e.deqFastCost*w)break}else if(u){if(m>=e.deqCost*d||m>=e.deqAvgCost*c)break}else if(b>=e.deqNoDrawCost*xo)break;var E=e.deq(a,g,y);if(E.length>0)for(var C=0;C<E.length;C++)h.push(E[C]);else break}h.length>0&&(e.onDeqd(a,h),!u&&e.shouldRedraw(a,h,g,y)&&i())},s=e.priority||es;n.beforeRender(o,s(a))}}}},ny=(function(){function r(e){var t=arguments.length>1&&arguments[1]!==void 0?arguments[1]:xn;dt(this,r),this.idsByKey=new Xr,this.keyForId=new Xr,this.cachesByLvl=new Xr,this.lvls=[],this.getKey=e,this.doesEleInvalidateKey=t}return gt(r,[{key:"getIdsFor",value:function(t){t==null&&$e("Can not get id list for null key");var a=this.idsByKey,n=this.idsByKey.get(t);return n||(n=new ra,a.set(t,n)),n}},{key:"addIdForKey",value:function(t,a){t!=null&&this.getIdsFor(t).add(a)}},{key:"deleteIdForKey",value:function(t,a){t!=null&&this.getIdsFor(t).delete(a)}},{key:"getNumberOfIdsForKey",value:function(t){return t==null?0:this.getIdsFor(t).size}},{key:"updateKeyMappingFor",value:function(t){var a=t.id(),n=this.keyForId.get(a),i=this.getKey(t);this.deleteIdForKey(n,a),this.addIdForKey(i,a),this.keyForId.set(a,i)}},{key:"deleteKeyMappingFor",value:function(t){var a=t.id(),n=this.keyForId.get(a);this.deleteIdForKey(n,a),this.keyForId.delete(a)}},{key:"keyHasChangedFor",value:function(t){var a=t.id(),n=this.keyForId.get(a),i=this.getKey(t);return n!==i}},{key:"isInvalid",value:function(t){return this.keyHasChangedFor(t)||this.doesEleInvalidateKey(t)}},{key:"getCachesAt",value:function(t){var a=this.cachesByLvl,n=this.lvls,i=a.get(t);return i||(i=new Xr,a.set(t,i),n.push(t)),i}},{key:"getCache",value:function(t,a){return this.getCachesAt(a).get(t)}},{key:"get",value:function(t,a){var n=this.getKey(t),i=this.getCache(n,a);return i!=null&&this.updateKeyMappingFor(t),i}},{key:"getForCachedKey",value:function(t,a){var n=this.keyForId.get(t.id()),i=this.getCache(n,a);return i}},{key:"hasCache",value:function(t,a){return this.getCachesAt(a).has(t)}},{key:"has",value:function(t,a){var n=this.getKey(t);return this.hasCache(n,a)}},{key:"setCache",value:function(t,a,n){n.key=t,this.getCachesAt(a).set(t,n)}},{key:"set",value:function(t,a,n){var i=this.getKey(t);this.setCache(i,a,n),this.updateKeyMappingFor(t)}},{key:"deleteCache",value:function(t,a){this.getCachesAt(a).delete(t)}},{key:"delete",value:function(t,a){var n=this.getKey(t);this.deleteCache(n,a)}},{key:"invalidateKey",value:function(t){var a=this;this.lvls.forEach(function(n){return a.deleteCache(t,n)})}},{key:"invalidate",value:function(t){var a=t.id(),n=this.keyForId.get(a);this.deleteKeyMappingFor(t);var i=this.doesEleInvalidateKey(t);return i&&this.invalidateKey(n),i||this.getNumberOfIdsForKey(n)===0}}])})(),Nl=25,nn=50,pn=-4,Wo=3,Sf=7.99,iy=8,oy=1024,sy=1024,uy=1024,ly=.2,vy=.8,fy=10,cy=.15,hy=.1,dy=.9,gy=.9,py=100,yy=1,Ut={dequeue:"dequeue",downscale:"downscale",highQuality:"highQuality"},my=cr({getKey:null,doesEleInvalidateKey:xn,drawElement:null,getBoundingBox:null,getRotationPoint:null,getRotationOffset:null,isVisible:hv,allowEdgeTxrCaching:!0,allowParentTxrCaching:!0}),ba=function(e,t){var a=this;a.renderer=e,a.onDequeues=[];var n=my(t);be(a,n),a.lookup=new ny(n.getKey,n.doesEleInvalidateKey),a.setupDequeueing()},nr=ba.prototype;nr.reasons=Ut;nr.getTextureQueue=function(r){var e=this;return e.eleImgCaches=e.eleImgCaches||{},e.eleImgCaches[r]=e.eleImgCaches[r]||[]};nr.getRetiredTextureQueue=function(r){var e=this,t=e.eleImgCaches.retired=e.eleImgCaches.retired||{},a=t[r]=t[r]||[];return a};nr.getElementQueue=function(){var r=this,e=r.eleCacheQueue=r.eleCacheQueue||new Va(function(t,a){return a.reqs-t.reqs});return e};nr.getElementKeyToQueue=function(){var r=this,e=r.eleKeyToCacheQueue=r.eleKeyToCacheQueue||{};return e};nr.getElement=function(r,e,t,a,n){var i=this,o=this.renderer,s=o.cy.zoom(),l=this.lookup;if(!e||e.w===0||e.h===0||isNaN(e.w)||isNaN(e.h)||!r.visible()||r.removed()||!i.allowEdgeTxrCaching&&r.isEdge()||!i.allowParentTxrCaching&&r.isParent())return null;if(a==null&&(a=Math.ceil(ts(s*t))),a<pn)a=pn;else if(s>=Sf||a>Wo)return null;var u=Math.pow(2,a),v=e.h*u,f=e.w*u,c=o.eleTextBiggerThanMin(r,u);if(!this.isVisible(r,c))return null;var d=l.get(r,a);if(d&&d.invalidated&&(d.invalidated=!1,d.texture.invalidatedWidth-=d.width),d)return d;var h;if(v<=Nl?h=Nl:v<=nn?h=nn:h=Math.ceil(v/nn)*nn,v>uy||f>sy)return null;var y=i.getTextureQueue(h),g=y[y.length-2],p=function(){return i.recycleTexture(h,f)||i.addTexture(h,f)};g||(g=y[y.length-1]),g||(g=p()),g.width-g.usedWidth<f&&(g=p());for(var m=function(I){return I&&I.scaledLabelShown===c},b=n&&n===Ut.dequeue,w=n&&n===Ut.highQuality,E=n&&n===Ut.downscale,C,x=a+1;x<=Wo;x++){var T=l.get(r,x);if(T){C=T;break}}var k=C&&C.level===a+1?C:null,D=function(){g.context.drawImage(k.texture.canvas,k.x,0,k.width,k.height,g.usedWidth,0,f,v)};if(g.context.setTransform(1,0,0,1,0,0),g.context.clearRect(g.usedWidth,0,f,h),m(k))D();else if(m(C))if(w){for(var B=C.level;B>a;B--)k=i.getElement(r,e,t,B,Ut.downscale);D()}else return i.queueElement(r,C.level-1),C;else{var P;if(!b&&!w&&!E)for(var A=a-1;A>=pn;A--){var R=l.get(r,A);if(R){P=R;break}}if(m(P))return i.queueElement(r,a),P;g.context.translate(g.usedWidth,0),g.context.scale(u,u),this.drawElement(g.context,r,e,c,!1),g.context.scale(1/u,1/u),g.context.translate(-g.usedWidth,0)}return d={x:g.usedWidth,texture:g,level:a,scale:u,width:f,height:v,scaledLabelShown:c},g.usedWidth+=Math.ceil(f+iy),g.eleCaches.push(d),l.set(r,a,d),i.checkTextureFullness(g),d};nr.invalidateElements=function(r){for(var e=0;e<r.length;e++)this.invalidateElement(r[e])};nr.invalidateElement=function(r){var e=this,t=e.lookup,a=[],n=t.isInvalid(r);if(n){for(var i=pn;i<=Wo;i++){var o=t.getForCachedKey(r,i);o&&a.push(o)}var s=t.invalidate(r);if(s)for(var l=0;l<a.length;l++){var u=a[l],v=u.texture;v.invalidatedWidth+=u.width,u.invalidated=!0,e.checkTextureUtility(v)}e.removeFromQueue(r)}};nr.checkTextureUtility=function(r){r.invalidatedWidth>=ly*r.width&&this.retireTexture(r)};nr.checkTextureFullness=function(r){var e=this,t=e.getTextureQueue(r.height);r.usedWidth/r.width>vy&&r.fullnessChecks>=fy?lt(t,r):r.fullnessChecks++};nr.retireTexture=function(r){var e=this,t=r.height,a=e.getTextureQueue(t),n=this.lookup;lt(a,r),r.retired=!0;for(var i=r.eleCaches,o=0;o<i.length;o++){var s=i[o];n.deleteCache(s.key,s.level)}rs(i);var l=e.getRetiredTextureQueue(t);l.push(r)};nr.addTexture=function(r,e){var t=this,a=t.getTextureQueue(r),n={};return a.push(n),n.eleCaches=[],n.height=r,n.width=Math.max(oy,e),n.usedWidth=0,n.invalidatedWidth=0,n.fullnessChecks=0,n.canvas=t.renderer.makeOffscreenCanvas(n.width,n.height),n.context=n.canvas.getContext("2d"),n};nr.recycleTexture=function(r,e){for(var t=this,a=t.getTextureQueue(r),n=t.getRetiredTextureQueue(r),i=0;i<n.length;i++){var o=n[i];if(o.width>=e)return o.retired=!1,o.usedWidth=0,o.invalidatedWidth=0,o.fullnessChecks=0,rs(o.eleCaches),o.context.setTransform(1,0,0,1,0,0),o.context.clearRect(0,0,o.width,o.height),lt(n,o),a.push(o),o}};nr.queueElement=function(r,e){var t=this,a=t.getElementQueue(),n=t.getElementKeyToQueue(),i=this.getKey(r),o=n[i];if(o)o.level=Math.max(o.level,e),o.eles.merge(r),o.reqs++,a.updateItem(o);else{var s={eles:r.spawn().merge(r),level:e,reqs:1,key:i};a.push(s),n[i]=s}};nr.dequeue=function(r){for(var e=this,t=e.getElementQueue(),a=e.getElementKeyToQueue(),n=[],i=e.lookup,o=0;o<yy&&t.size()>0;o++){var s=t.pop(),l=s.key,u=s.eles[0],v=i.hasCache(u,s.level);if(a[l]=null,v)continue;n.push(s);var f=e.getBoundingBox(u);e.getElement(u,f,r,s.level,Ut.dequeue)}return n};nr.removeFromQueue=function(r){var e=this,t=e.getElementQueue(),a=e.getElementKeyToQueue(),n=this.getKey(r),i=a[n];i!=null&&(i.eles.length===1?(i.reqs=jo,t.updateItem(i),t.pop(),a[n]=null):i.eles.unmerge(r))};nr.onDequeue=function(r){this.onDequeues.push(r)};nr.offDequeue=function(r){lt(this.onDequeues,r)};nr.setupDequeueing=Tf.setupDequeueing({deqRedrawThreshold:py,deqCost:cy,deqAvgCost:hy,deqNoDrawCost:dy,deqFastCost:gy,deq:function(e,t,a){return e.dequeue(t,a)},onDeqd:function(e,t){for(var a=0;a<e.onDequeues.length;a++){var n=e.onDequeues[a];n(t)}},shouldRedraw:function(e,t,a,n){for(var i=0;i<t.length;i++)for(var o=t[i].eles,s=0;s<o.length;s++){var l=o[s].boundingBox();if(ns(l,n))return!0}return!1},priority:function(e){return e.renderer.beforeRenderPriorities.eleTxrDeq}});var by=1,xa=-4,Pn=2,wy=3.99,xy=50,Ey=50,Cy=.15,Ty=.1,Sy=.9,ky=.9,Dy=1,zl=250,By=4e3*4e3,Fl=32767,Py=!0,kf=function(e){var t=this,a=t.renderer=e,n=a.cy;t.layersByLevel={},t.firstGet=!0,t.lastInvalidationTime=Yr()-2*zl,t.skipping=!1,t.eleTxrDeqs=n.collection(),t.scheduleElementRefinement=Fa(function(){t.refineElementTextures(t.eleTxrDeqs),t.eleTxrDeqs.unmerge(t.eleTxrDeqs)},Ey),a.beforeRender(function(o,s){s-t.lastInvalidationTime<=zl?t.skipping=!0:t.skipping=!1},a.beforeRenderPriorities.lyrTxrSkip);var i=function(s,l){return l.reqs-s.reqs};t.layersQueue=new Va(i),t.setupDequeueing()},hr=kf.prototype,Vl=0,Ay=Math.pow(2,53)-1;hr.makeLayer=function(r,e){var t=Math.pow(2,e),a=Math.ceil(r.w*t),n=Math.ceil(r.h*t),i=this.renderer.makeOffscreenCanvas(a,n),o={id:Vl=++Vl%Ay,bb:r,level:e,width:a,height:n,canvas:i,context:i.getContext("2d"),eles:[],elesQueue:[],reqs:0},s=o.context,l=-o.bb.x1,u=-o.bb.y1;return s.scale(t,t),s.translate(l,u),o};hr.getLayers=function(r,e,t){var a=this,n=a.renderer,i=n.cy,o=i.zoom(),s=a.firstGet;if(a.firstGet=!1,t==null){if(t=Math.ceil(ts(o*e)),t<xa)t=xa;else if(o>=wy||t>Pn)return null}a.validateLayersElesOrdering(t,r);var l=a.layersByLevel,u=Math.pow(2,t),v=l[t]=l[t]||[],f,c=a.levelIsComplete(t,r),d,h=function(){var D=function(L){if(a.validateLayersElesOrdering(L,r),a.levelIsComplete(L,r))return d=l[L],!0},B=function(L){if(!d)for(var I=t+L;xa<=I&&I<=Pn&&!D(I);I+=L);};B(1),B(-1);for(var P=v.length-1;P>=0;P--){var A=v[P];A.invalid&&lt(v,A)}};if(!c)h();else return v;var y=function(){if(!f){f=wr();for(var D=0;D<r.length;D++)Dh(f,r[D].boundingBox())}return f},g=function(D){D=D||{};var B=D.after;y();var P=Math.ceil(f.w*u),A=Math.ceil(f.h*u);if(P>Fl||A>Fl)return null;var R=P*A;if(R>By)return null;var L=a.makeLayer(f,t);if(B!=null){var I=v.indexOf(B)+1;v.splice(I,0,L)}else(D.insert===void 0||D.insert)&&v.unshift(L);return L};if(a.skipping&&!s)return null;for(var p=null,m=r.length/by,b=!s,w=0;w<r.length;w++){var E=r[w],C=E._private.rscratch,x=C.imgLayerCaches=C.imgLayerCaches||{},T=x[t];if(T){p=T;continue}if((!p||p.eles.length>=m||!bv(p.bb,E.boundingBox()))&&(p=g({insert:!0,after:p}),!p))return null;d||b?a.queueLayer(p,E):a.drawEleInLayer(p,E,t,e),p.eles.push(E),x[t]=p}return d||(b?null:v)};hr.getEleLevelForLayerLevel=function(r,e){return r};hr.drawEleInLayer=function(r,e,t,a){var n=this,i=this.renderer,o=r.context,s=e.boundingBox();s.w===0||s.h===0||!e.visible()||(t=n.getEleLevelForLayerLevel(t,a),i.setImgSmoothing(o,!1),i.drawCachedElement(o,e,null,null,t,Py),i.setImgSmoothing(o,!0))};hr.levelIsComplete=function(r,e){var t=this,a=t.layersByLevel[r];if(!a||a.length===0)return!1;for(var n=0,i=0;i<a.length;i++){var o=a[i];if(o.reqs>0||o.invalid)return!1;n+=o.eles.length}return n===e.length};hr.validateLayersElesOrdering=function(r,e){var t=this.layersByLevel[r];if(t)for(var a=0;a<t.length;a++){for(var n=t[a],i=-1,o=0;o<e.length;o++)if(n.eles[0]===e[o]){i=o;break}if(i<0){this.invalidateLayer(n);continue}for(var s=i,o=0;o<n.eles.length;o++)if(n.eles[o]!==e[s+o]){this.invalidateLayer(n);break}}};hr.updateElementsInLayers=function(r,e){for(var t=this,a=Ia(r[0]),n=0;n<r.length;n++)for(var i=a?null:r[n],o=a?r[n]:r[n].ele,s=o._private.rscratch,l=s.imgLayerCaches=s.imgLayerCaches||{},u=xa;u<=Pn;u++){var v=l[u];v&&(i&&t.getEleLevelForLayerLevel(v.level)!==i.level||e(v,o,i))}};hr.haveLayers=function(){for(var r=this,e=!1,t=xa;t<=Pn;t++){var a=r.layersByLevel[t];if(a&&a.length>0){e=!0;break}}return e};hr.invalidateElements=function(r){var e=this;r.length!==0&&(e.lastInvalidationTime=Yr(),!(r.length===0||!e.haveLayers())&&e.updateElementsInLayers(r,function(a,n,i){e.invalidateLayer(a)}))};hr.invalidateLayer=function(r){if(this.lastInvalidationTime=Yr(),!r.invalid){var e=r.level,t=r.eles,a=this.layersByLevel[e];lt(a,r),r.elesQueue=[],r.invalid=!0,r.replacement&&(r.replacement.invalid=!0);for(var n=0;n<t.length;n++){var i=t[n]._private.rscratch.imgLayerCaches;i&&(i[e]=null)}}};hr.refineElementTextures=function(r){var e=this;e.updateElementsInLayers(r,function(a,n,i){var o=a.replacement;if(o||(o=a.replacement=e.makeLayer(a.bb,a.level),o.replaces=a,o.eles=a.eles),!o.reqs)for(var s=0;s<o.eles.length;s++)e.queueLayer(o,o.eles[s])})};hr.enqueueElementRefinement=function(r){this.eleTxrDeqs.merge(r),this.scheduleElementRefinement()};hr.queueLayer=function(r,e){var t=this,a=t.layersQueue,n=r.elesQueue,i=n.hasId=n.hasId||{};if(!r.replacement){if(e){if(i[e.id()])return;n.push(e),i[e.id()]=!0}r.reqs?(r.reqs++,a.updateItem(r)):(r.reqs=1,a.push(r))}};hr.dequeue=function(r){for(var e=this,t=e.layersQueue,a=[],n=0;n<Dy&&t.size()!==0;){var i=t.peek();if(i.replacement){t.pop();continue}if(i.replaces&&i!==i.replaces.replacement){t.pop();continue}if(i.invalid){t.pop();continue}var o=i.elesQueue.shift();o&&(e.drawEleInLayer(i,o,i.level,r),n++),a.length===0&&a.push(!0),i.elesQueue.length===0&&(t.pop(),i.reqs=0,i.replaces&&e.applyLayerReplacement(i),e.requestRedraw())}return a};hr.applyLayerReplacement=function(r){var e=this,t=e.layersByLevel[r.level],a=r.replaces,n=t.indexOf(a);if(!(n<0||a.invalid)){t[n]=r;for(var i=0;i<r.eles.length;i++){var o=r.eles[i]._private,s=o.imgLayerCaches=o.imgLayerCaches||{};s&&(s[r.level]=r)}e.requestRedraw()}};hr.requestRedraw=Fa(function(){var r=this.renderer;r.redrawHint("eles",!0),r.redrawHint("drag",!0),r.redraw()},100);hr.setupDequeueing=Tf.setupDequeueing({deqRedrawThreshold:xy,deqCost:Cy,deqAvgCost:Ty,deqNoDrawCost:Sy,deqFastCost:ky,deq:function(e,t){return e.dequeue(t)},onDeqd:es,shouldRedraw:hv,priority:function(e){return e.renderer.beforeRenderPriorities.lyrTxrDeq}});var Df={},ql;function Ry(r,e){for(var t=0;t<e.length;t++){var a=e[t];r.lineTo(a.x,a.y)}}function My(r,e,t){for(var a,n=0;n<e.length;n++){var i=e[n];n===0&&(a=i),r.lineTo(i.x,i.y)}r.quadraticCurveTo(t.x,t.y,a.x,a.y)}function _l(r,e,t){r.beginPath&&r.beginPath();for(var a=e,n=0;n<a.length;n++){var i=a[n];r.lineTo(i.x,i.y)}var o=t,s=t[0];r.moveTo(s.x,s.y);for(var n=1;n<o.length;n++){var i=o[n];r.lineTo(i.x,i.y)}r.closePath&&r.closePath()}function Ly(r,e,t,a,n){r.beginPath&&r.beginPath(),r.arc(t,a,n,0,Math.PI*2,!1);var i=e,o=i[0];r.moveTo(o.x,o.y);for(var s=0;s<i.length;s++){var l=i[s];r.lineTo(l.x,l.y)}r.closePath&&r.closePath()}function Iy(r,e,t,a){r.arc(e,t,a,0,Math.PI*2,!1)}Df.arrowShapeImpl=function(r){return(ql||(ql={polygon:Ry,"triangle-backcurve":My,"triangle-tee":_l,"circle-triangle":Ly,"triangle-cross":_l,circle:Iy}))[r]};var Hr={};Hr.drawElement=function(r,e,t,a,n,i){var o=this;e.isNode()?o.drawNode(r,e,t,a,n,i):o.drawEdge(r,e,t,a,n,i)};Hr.drawElementOverlay=function(r,e){var t=this;e.isNode()?t.drawNodeOverlay(r,e):t.drawEdgeOverlay(r,e)};Hr.drawElementUnderlay=function(r,e){var t=this;e.isNode()?t.drawNodeUnderlay(r,e):t.drawEdgeUnderlay(r,e)};Hr.drawCachedElementPortion=function(r,e,t,a,n,i,o,s){var l=this,u=t.getBoundingBox(e);if(!(u.w===0||u.h===0)){var v=t.getElement(e,u,a,n,i);if(v!=null){var f=s(l,e);if(f===0)return;var c=o(l,e),d=u.x1,h=u.y1,y=u.w,g=u.h,p,m,b,w,E;if(c!==0){var C=t.getRotationPoint(e);b=C.x,w=C.y,r.translate(b,w),r.rotate(c),E=l.getImgSmoothing(r),E||l.setImgSmoothing(r,!0);var x=t.getRotationOffset(e);p=x.x,m=x.y}else p=d,m=h;var T;f!==1&&(T=r.globalAlpha,r.globalAlpha=T*f),r.drawImage(v.texture.canvas,v.x,0,v.width,v.height,p,m,y,g),f!==1&&(r.globalAlpha=T),c!==0&&(r.rotate(-c),r.translate(-b,-w),E||l.setImgSmoothing(r,!1))}else t.drawElement(r,e)}};var Oy=function(){return 0},Ny=function(e,t){return e.getTextAngle(t,null)},zy=function(e,t){return e.getTextAngle(t,"source")},Fy=function(e,t){return e.getTextAngle(t,"target")},Vy=function(e,t){return t.effectiveOpacity()},Eo=function(e,t){return t.pstyle("text-opacity").pfValue*t.effectiveOpacity()};Hr.drawCachedElement=function(r,e,t,a,n,i){var o=this,s=o.data,l=s.eleTxrCache,u=s.lblTxrCache,v=s.slbTxrCache,f=s.tlbTxrCache,c=e.boundingBox(),d=i===!0?l.reasons.highQuality:null;if(!(c.w===0||c.h===0||!e.visible())&&(!a||ns(c,a))){var h=e.isEdge(),y=e.element()._private.rscratch.badLine;o.drawElementUnderlay(r,e),o.drawCachedElementPortion(r,e,l,t,n,d,Oy,Vy),(!h||!y)&&o.drawCachedElementPortion(r,e,u,t,n,d,Ny,Eo),h&&!y&&(o.drawCachedElementPortion(r,e,v,t,n,d,zy,Eo),o.drawCachedElementPortion(r,e,f,t,n,d,Fy,Eo)),o.drawElementOverlay(r,e)}};Hr.drawElements=function(r,e){for(var t=this,a=0;a<e.length;a++){var n=e[a];t.drawElement(r,n)}};Hr.drawCachedElements=function(r,e,t,a){for(var n=this,i=0;i<e.length;i++){var o=e[i];n.drawCachedElement(r,o,t,a)}};Hr.drawCachedNodes=function(r,e,t,a){for(var n=this,i=0;i<e.length;i++){var o=e[i];o.isNode()&&n.drawCachedElement(r,o,t,a)}};Hr.drawLayeredElements=function(r,e,t,a){var n=this,i=n.data.lyrTxrCache.getLayers(e,t);if(i)for(var o=0;o<i.length;o++){var s=i[o],l=s.bb;l.w===0||l.h===0||r.drawImage(s.canvas,l.x1,l.y1,l.w,l.h)}else n.drawCachedElements(r,e,t,a)};var Jr={};Jr.drawEdge=function(r,e,t){var a=arguments.length>3&&arguments[3]!==void 0?arguments[3]:!0,n=arguments.length>4&&arguments[4]!==void 0?arguments[4]:!0,i=arguments.length>5&&arguments[5]!==void 0?arguments[5]:!0,o=this,s=e._private.rscratch;if(!(i&&!e.visible())&&!(s.badLine||s.allpts==null||isNaN(s.allpts[0]))){var l;t&&(l=t,r.translate(-l.x1,-l.y1));var u=i?e.pstyle("opacity").value:1,v=i?e.pstyle("line-opacity").value:1,f=e.pstyle("curve-style").value,c=e.pstyle("line-style").value,d=e.pstyle("width").pfValue,h=e.pstyle("line-cap").value,y=e.pstyle("line-outline-width").value,g=e.pstyle("line-outline-color").value,p=u*v,m=u*v,b=function(){var L=arguments.length>0&&arguments[0]!==void 0?arguments[0]:p;f==="straight-triangle"?(o.eleStrokeStyle(r,e,L),o.drawEdgeTrianglePath(e,r,s.allpts)):(r.lineWidth=d,r.lineCap=h,o.eleStrokeStyle(r,e,L),o.drawEdgePath(e,r,s.allpts,c),r.lineCap="butt")},w=function(){var L=arguments.length>0&&arguments[0]!==void 0?arguments[0]:p;if(r.lineWidth=d+y,r.lineCap=h,y>0)o.colorStrokeStyle(r,g[0],g[1],g[2],L);else{r.lineCap="butt";return}f==="straight-triangle"?o.drawEdgeTrianglePath(e,r,s.allpts):(o.drawEdgePath(e,r,s.allpts,c),r.lineCap="butt")},E=function(){n&&o.drawEdgeOverlay(r,e)},C=function(){n&&o.drawEdgeUnderlay(r,e)},x=function(){var L=arguments.length>0&&arguments[0]!==void 0?arguments[0]:m;o.drawArrowheads(r,e,L)},T=function(){o.drawElementText(r,e,null,a)};r.lineJoin="round";var k=e.pstyle("ghost").value==="yes";if(k){var D=e.pstyle("ghost-offset-x").pfValue,B=e.pstyle("ghost-offset-y").pfValue,P=e.pstyle("ghost-opacity").value,A=p*P;r.translate(D,B),b(A),x(A),r.translate(-D,-B)}else w();C(),b(),x(),E(),T(),t&&r.translate(l.x1,l.y1)}};var Bf=function(e){if(!["overlay","underlay"].includes(e))throw new Error("Invalid state");return function(t,a){if(a.visible()){var n=a.pstyle("".concat(e,"-opacity")).value;if(n!==0){var i=this,o=i.usePaths(),s=a._private.rscratch,l=a.pstyle("".concat(e,"-padding")).pfValue,u=2*l,v=a.pstyle("".concat(e,"-color")).value;t.lineWidth=u,s.edgeType==="self"&&!o?t.lineCap="butt":t.lineCap="round",i.colorStrokeStyle(t,v[0],v[1],v[2],n),i.drawEdgePath(a,t,s.allpts,"solid")}}}};Jr.drawEdgeOverlay=Bf("overlay");Jr.drawEdgeUnderlay=Bf("underlay");Jr.drawEdgePath=function(r,e,t,a){var n=r._private.rscratch,i=e,o,s=!1,l=this.usePaths(),u=r.pstyle("line-dash-pattern").pfValue,v=r.pstyle("line-dash-offset").pfValue;if(l){var f=t.join("$"),c=n.pathCacheKey&&n.pathCacheKey===f;c?(o=e=n.pathCache,s=!0):(o=e=new Path2D,n.pathCacheKey=f,n.pathCache=o)}if(i.setLineDash)switch(a){case"dotted":i.setLineDash([1,1]);break;case"dashed":i.setLineDash(u),i.lineDashOffset=v;break;case"solid":i.setLineDash([]);break}if(!s&&!n.badLine)switch(e.beginPath&&e.beginPath(),e.moveTo(t[0],t[1]),n.edgeType){case"bezier":case"self":case"compound":case"multibezier":for(var d=2;d+3<t.length;d+=4)e.quadraticCurveTo(t[d],t[d+1],t[d+2],t[d+3]);break;case"straight":case"haystack":for(var h=2;h+1<t.length;h+=2)e.lineTo(t[h],t[h+1]);break;case"segments":if(n.isRound){var y=kr(n.roundCorners),g;try{for(y.s();!(g=y.n()).done;){var p=g.value;pf(e,p)}}catch(b){y.e(b)}finally{y.f()}e.lineTo(t[t.length-2],t[t.length-1])}else for(var m=2;m+1<t.length;m+=2)e.lineTo(t[m],t[m+1]);break}e=i,l?e.stroke(o):e.stroke(),e.setLineDash&&e.setLineDash([])};Jr.drawEdgeTrianglePath=function(r,e,t){e.fillStyle=e.strokeStyle;for(var a=r.pstyle("width").pfValue,n=0;n+1<t.length;n+=2){var i=[t[n+2]-t[n],t[n+3]-t[n+1]],o=Math.sqrt(i[0]*i[0]+i[1]*i[1]),s=[i[1]/o,-i[0]/o],l=[s[0]*a/2,s[1]*a/2];e.beginPath(),e.moveTo(t[n]-l[0],t[n+1]-l[1]),e.lineTo(t[n]+l[0],t[n+1]+l[1]),e.lineTo(t[n+2],t[n+3]),e.closePath(),e.fill()}};Jr.drawArrowheads=function(r,e,t){var a=e._private.rscratch,n=a.edgeType==="haystack";n||this.drawArrowhead(r,e,"source",a.arrowStartX,a.arrowStartY,a.srcArrowAngle,t),this.drawArrowhead(r,e,"mid-target",a.midX,a.midY,a.midtgtArrowAngle,t),this.drawArrowhead(r,e,"mid-source",a.midX,a.midY,a.midsrcArrowAngle,t),n||this.drawArrowhead(r,e,"target",a.arrowEndX,a.arrowEndY,a.tgtArrowAngle,t)};Jr.drawArrowhead=function(r,e,t,a,n,i,o){if(!(isNaN(a)||a==null||isNaN(n)||n==null||isNaN(i)||i==null)){var s=this,l=e.pstyle(t+"-arrow-shape").value;if(l!=="none"){var u=e.pstyle(t+"-arrow-fill").value==="hollow"?"both":"filled",v=e.pstyle(t+"-arrow-fill").value,f=e.pstyle("width").pfValue,c=e.pstyle(t+"-arrow-width"),d=c.value==="match-line"?f:c.pfValue;c.units==="%"&&(d*=f);var h=e.pstyle("opacity").value;o===void 0&&(o=h);var y=r.globalCompositeOperation;(o!==1||v==="hollow")&&(r.globalCompositeOperation="destination-out",s.colorFillStyle(r,255,255,255,1),s.colorStrokeStyle(r,255,255,255,1),s.drawArrowShape(e,r,u,f,l,d,a,n,i),r.globalCompositeOperation=y);var g=e.pstyle(t+"-arrow-color").value;s.colorFillStyle(r,g[0],g[1],g[2],o),s.colorStrokeStyle(r,g[0],g[1],g[2],o),s.drawArrowShape(e,r,v,f,l,d,a,n,i)}}};Jr.drawArrowShape=function(r,e,t,a,n,i,o,s,l){var u=this,v=this.usePaths()&&n!=="triangle-cross",f=!1,c,d=e,h={x:o,y:s},y=r.pstyle("arrow-scale").value,g=this.getArrowWidth(a,y),p=u.arrowShapes[n];if(v){var m=u.arrowPathCache=u.arrowPathCache||[],b=Dt(n),w=m[b];w!=null?(c=e=w,f=!0):(c=e=new Path2D,m[b]=c)}f||(e.beginPath&&e.beginPath(),v?p.draw(e,1,0,{x:0,y:0},1):p.draw(e,g,l,h,a),e.closePath&&e.closePath()),e=d,v&&(e.translate(o,s),e.rotate(l),e.scale(g,g)),(t==="filled"||t==="both")&&(v?e.fill(c):e.fill()),(t==="hollow"||t==="both")&&(e.lineWidth=i/(v?g:1),e.lineJoin="miter",v?e.stroke(c):e.stroke()),v&&(e.scale(1/g,1/g),e.rotate(-l),e.translate(-o,-s))};var ms={};ms.safeDrawImage=function(r,e,t,a,n,i,o,s,l,u){if(!(n<=0||i<=0||l<=0||u<=0))try{r.drawImage(e,t,a,n,i,o,s,l,u)}catch(v){Ve(v)}};ms.drawInscribedImage=function(r,e,t,a,n){var i=this,o=t.position(),s=o.x,l=o.y,u=t.cy().style(),v=u.getIndexedStyle.bind(u),f=v(t,"background-fit","value",a),c=v(t,"background-repeat","value",a),d=t.width(),h=t.height(),y=t.padding()*2,g=d+(v(t,"background-width-relative-to","value",a)==="inner"?0:y),p=h+(v(t,"background-height-relative-to","value",a)==="inner"?0:y),m=t._private.rscratch,b=v(t,"background-clip","value",a),w=b==="node",E=v(t,"background-image-opacity","value",a)*n,C=v(t,"background-image-smoothing","value",a),x=t.pstyle("corner-radius").value;x!=="auto"&&(x=t.pstyle("corner-radius").pfValue);var T=e.width||e.cachedW,k=e.height||e.cachedH;(T==null||k==null)&&(document.body.appendChild(e),T=e.cachedW=e.width||e.offsetWidth,k=e.cachedH=e.height||e.offsetHeight,document.body.removeChild(e));var D=T,B=k;if(v(t,"background-width","value",a)!=="auto"&&(v(t,"background-width","units",a)==="%"?D=v(t,"background-width","pfValue",a)*g:D=v(t,"background-width","pfValue",a)),v(t,"background-height","value",a)!=="auto"&&(v(t,"background-height","units",a)==="%"?B=v(t,"background-height","pfValue",a)*p:B=v(t,"background-height","pfValue",a)),!(D===0||B===0)){if(f==="contain"){var P=Math.min(g/D,p/B);D*=P,B*=P}else if(f==="cover"){var P=Math.max(g/D,p/B);D*=P,B*=P}var A=s-g/2,R=v(t,"background-position-x","units",a),L=v(t,"background-position-x","pfValue",a);R==="%"?A+=(g-D)*L:A+=L;var I=v(t,"background-offset-x","units",a),M=v(t,"background-offset-x","pfValue",a);I==="%"?A+=(g-D)*M:A+=M;var O=l-p/2,V=v(t,"background-position-y","units",a),G=v(t,"background-position-y","pfValue",a);V==="%"?O+=(p-B)*G:O+=G;var N=v(t,"background-offset-y","units",a),F=v(t,"background-offset-y","pfValue",a);N==="%"?O+=(p-B)*F:O+=F,m.pathCache&&(A-=s,O-=l,s=0,l=0);var U=r.globalAlpha;r.globalAlpha=E;var Q=i.getImgSmoothing(r),K=!1;if(C==="no"&&Q?(i.setImgSmoothing(r,!1),K=!0):C==="yes"&&!Q&&(i.setImgSmoothing(r,!0),K=!0),c==="no-repeat")w&&(r.save(),m.pathCache?r.clip(m.pathCache):(i.nodeShapes[i.getNodeShape(t)].draw(r,s,l,g,p,x,m),r.clip())),i.safeDrawImage(r,e,0,0,T,k,A,O,D,B),w&&r.restore();else{var j=r.createPattern(e,c);r.fillStyle=j,i.nodeShapes[i.getNodeShape(t)].draw(r,s,l,g,p,x,m),r.translate(A,O),r.fill(),r.translate(-A,-O)}r.globalAlpha=U,K&&i.setImgSmoothing(r,Q)}};var Lt={};Lt.eleTextBiggerThanMin=function(r,e){if(!e){var t=r.cy().zoom(),a=this.getPixelRatio(),n=Math.ceil(ts(t*a));e=Math.pow(2,n)}var i=r.pstyle("font-size").pfValue*e,o=r.pstyle("min-zoomed-font-size").pfValue;return!(i<o)};Lt.drawElementText=function(r,e,t,a,n){var i=arguments.length>5&&arguments[5]!==void 0?arguments[5]:!0,o=this;if(a==null){if(i&&!o.eleTextBiggerThanMin(e))return}else if(a===!1)return;if(e.isNode()){var s=e.pstyle("label");if(!s||!s.value)return;var l=o.getLabelJustification(e);r.textAlign=l,r.textBaseline="bottom"}else{var u=e.element()._private.rscratch.badLine,v=e.pstyle("label"),f=e.pstyle("source-label"),c=e.pstyle("target-label");if(u||(!v||!v.value)&&(!f||!f.value)&&(!c||!c.value))return;r.textAlign="center",r.textBaseline="bottom"}var d=!t,h;t&&(h=t,r.translate(-h.x1,-h.y1)),n==null?(o.drawText(r,e,null,d,i),e.isEdge()&&(o.drawText(r,e,"source",d,i),o.drawText(r,e,"target",d,i))):o.drawText(r,e,n,d,i),t&&r.translate(h.x1,h.y1)};Lt.getFontCache=function(r){var e;this.fontCaches=this.fontCaches||[];for(var t=0;t<this.fontCaches.length;t++)if(e=this.fontCaches[t],e.context===r)return e;return e={context:r},this.fontCaches.push(e),e};Lt.setupTextStyle=function(r,e){var t=arguments.length>2&&arguments[2]!==void 0?arguments[2]:!0,a=e.pstyle("font-style").strValue,n=e.pstyle("font-size").pfValue+"px",i=e.pstyle("font-family").strValue,o=e.pstyle("font-weight").strValue,s=t?e.effectiveOpacity()*e.pstyle("text-opacity").value:1,l=e.pstyle("text-outline-opacity").value*s,u=e.pstyle("color").value,v=e.pstyle("text-outline-color").value;r.font=a+" "+o+" "+n+" "+i,r.lineJoin="round",this.colorFillStyle(r,u[0],u[1],u[2],s),this.colorStrokeStyle(r,v[0],v[1],v[2],l)};function qy(r,e,t,a,n){var i=Math.min(a,n),o=i/2,s=e+a/2,l=t+n/2;r.beginPath(),r.arc(s,l,o,0,Math.PI*2),r.closePath()}function Gl(r,e,t,a,n){var i=arguments.length>5&&arguments[5]!==void 0?arguments[5]:5,o=Math.min(i,a/2,n/2);r.beginPath(),r.moveTo(e+o,t),r.lineTo(e+a-o,t),r.quadraticCurveTo(e+a,t,e+a,t+o),r.lineTo(e+a,t+n-o),r.quadraticCurveTo(e+a,t+n,e+a-o,t+n),r.lineTo(e+o,t+n),r.quadraticCurveTo(e,t+n,e,t+n-o),r.lineTo(e,t+o),r.quadraticCurveTo(e,t,e+o,t),r.closePath()}Lt.getTextAngle=function(r,e){var t,a=r._private,n=a.rscratch,i=e?e+"-":"",o=r.pstyle(i+"text-rotation");if(o.strValue==="autorotate"){var s=Tr(n,"labelAngle",e);t=r.isEdge()?s:0}else o.strValue==="none"?t=0:t=o.pfValue;return t};Lt.drawText=function(r,e,t){var a=arguments.length>3&&arguments[3]!==void 0?arguments[3]:!0,n=arguments.length>4&&arguments[4]!==void 0?arguments[4]:!0,i=e._private,o=i.rscratch,s=n?e.effectiveOpacity():1;if(!(n&&(s===0||e.pstyle("text-opacity").value===0))){t==="main"&&(t=null);var l=Tr(o,"labelX",t),u=Tr(o,"labelY",t),v,f,c=this.getLabelText(e,t);if(c!=null&&c!==""&&!isNaN(l)&&!isNaN(u)){this.setupTextStyle(r,e,n);var d=t?t+"-":"",h=Tr(o,"labelWidth",t),y=Tr(o,"labelHeight",t),g=e.pstyle(d+"text-margin-x").pfValue,p=e.pstyle(d+"text-margin-y").pfValue,m=e.isEdge(),b=e.pstyle("text-halign").value,w=e.pstyle("text-valign").value;m&&(b="center",w="center"),l+=g,u+=p;var E;switch(a?E=this.getTextAngle(e,t):E=0,E!==0&&(v=l,f=u,r.translate(v,f),r.rotate(E),l=0,u=0),w){case"top":break;case"center":u+=y/2;break;case"bottom":u+=y;break}var C=e.pstyle("text-background-opacity").value,x=e.pstyle("text-border-opacity").value,T=e.pstyle("text-border-width").pfValue,k=e.pstyle("text-background-padding").pfValue,D=e.pstyle("text-background-shape").strValue,B=D==="round-rectangle"||D==="roundrectangle",P=D==="circle",A=2;if(C>0||T>0&&x>0){var R=r.fillStyle,L=r.strokeStyle,I=r.lineWidth,M=e.pstyle("text-background-color").value,O=e.pstyle("text-border-color").value,V=e.pstyle("text-border-style").value,G=C>0,N=T>0&&x>0,F=l-k;switch(b){case"left":F-=h;break;case"center":F-=h/2;break}var U=u-y-k,Q=h+2*k,K=y+2*k;if(G&&(r.fillStyle="rgba(".concat(M[0],",").concat(M[1],",").concat(M[2],",").concat(C*s,")")),N&&(r.strokeStyle="rgba(".concat(O[0],",").concat(O[1],",").concat(O[2],",").concat(x*s,")"),r.lineWidth=T,r.setLineDash))switch(V){case"dotted":r.setLineDash([1,1]);break;case"dashed":r.setLineDash([4,2]);break;case"double":r.lineWidth=T/4,r.setLineDash([]);break;case"solid":default:r.setLineDash([]);break}if(B?(r.beginPath(),Gl(r,F,U,Q,K,A)):P?(r.beginPath(),qy(r,F,U,Q,K)):(r.beginPath(),r.rect(F,U,Q,K)),G&&r.fill(),N&&r.stroke(),N&&V==="double"){var j=T/2;r.beginPath(),B?Gl(r,F+j,U+j,Q-2*j,K-2*j,A):r.rect(F+j,U+j,Q-2*j,K-2*j),r.stroke()}r.fillStyle=R,r.strokeStyle=L,r.lineWidth=I,r.setLineDash&&r.setLineDash([])}var re=2*e.pstyle("text-outline-width").pfValue;if(re>0&&(r.lineWidth=re),e.pstyle("text-wrap").value==="wrap"){var ne=Tr(o,"labelWrapCachedLines",t),J=Tr(o,"labelLineHeight",t),z=h/2,q=this.getLabelJustification(e);switch(q==="auto"||(b==="left"?q==="left"?l+=-h:q==="center"&&(l+=-z):b==="center"?q==="left"?l+=-z:q==="right"&&(l+=z):b==="right"&&(q==="center"?l+=z:q==="right"&&(l+=h))),w){case"top":u-=(ne.length-1)*J;break;case"center":case"bottom":u-=(ne.length-1)*J;break}for(var H=0;H<ne.length;H++)re>0&&r.strokeText(ne[H],l,u),r.fillText(ne[H],l,u),u+=J}else re>0&&r.strokeText(c,l,u),r.fillText(c,l,u);E!==0&&(r.rotate(-E),r.translate(-v,-f))}}};var yt={};yt.drawNode=function(r,e,t){var a=arguments.length>3&&arguments[3]!==void 0?arguments[3]:!0,n=arguments.length>4&&arguments[4]!==void 0?arguments[4]:!0,i=arguments.length>5&&arguments[5]!==void 0?arguments[5]:!0,o=this,s,l,u=e._private,v=u.rscratch,f=e.position();if(!(!ae(f.x)||!ae(f.y))&&!(i&&!e.visible())){var c=i?e.effectiveOpacity():1,d=o.usePaths(),h,y=!1,g=e.padding();s=e.width()+2*g,l=e.height()+2*g;var p;t&&(p=t,r.translate(-p.x1,-p.y1));for(var m=e.pstyle("background-image"),b=m.value,w=new Array(b.length),E=new Array(b.length),C=0,x=0;x<b.length;x++){var T=b[x],k=w[x]=T!=null&&T!=="none";if(k){var D=e.cy().style().getIndexedStyle(e,"background-image-crossorigin","value",x);C++,E[x]=o.getCachedImage(T,D,function(){u.backgroundTimestamp=Date.now(),e.emitAndNotify("background")})}}var B=e.pstyle("background-blacken").value,P=e.pstyle("border-width").pfValue,A=e.pstyle("background-opacity").value*c,R=e.pstyle("border-color").value,L=e.pstyle("border-style").value,I=e.pstyle("border-join").value,M=e.pstyle("border-cap").value,O=e.pstyle("border-position").value,V=e.pstyle("border-dash-pattern").pfValue,G=e.pstyle("border-dash-offset").pfValue,N=e.pstyle("border-opacity").value*c,F=e.pstyle("outline-width").pfValue,U=e.pstyle("outline-color").value,Q=e.pstyle("outline-style").value,K=e.pstyle("outline-opacity").value*c,j=e.pstyle("outline-offset").value,re=e.pstyle("corner-radius").value;re!=="auto"&&(re=e.pstyle("corner-radius").pfValue);var ne=function(){var ue=arguments.length>0&&arguments[0]!==void 0?arguments[0]:A;o.eleFillStyle(r,e,ue)},J=function(){var ue=arguments.length>0&&arguments[0]!==void 0?arguments[0]:N;o.colorStrokeStyle(r,R[0],R[1],R[2],ue)},z=function(){var ue=arguments.length>0&&arguments[0]!==void 0?arguments[0]:K;o.colorStrokeStyle(r,U[0],U[1],U[2],ue)},q=function(ue,X,S,_){var W=o.nodePathCache=o.nodePathCache||[],$=cv(S==="polygon"?S+","+_.join(","):S,""+X,""+ue,""+re),Z=W[$],se,ee=!1;return Z!=null?(se=Z,ee=!0,v.pathCache=se):(se=new Path2D,W[$]=v.pathCache=se),{path:se,cacheHit:ee}},H=e.pstyle("shape").strValue,Y=e.pstyle("shape-polygon-points").pfValue;if(d){r.translate(f.x,f.y);var te=q(s,l,H,Y);h=te.path,y=te.cacheHit}var ce=function(){if(!y){var ue=f;d&&(ue={x:0,y:0}),o.nodeShapes[o.getNodeShape(e)].draw(h||r,ue.x,ue.y,s,l,re,v)}d?r.fill(h):r.fill()},Ae=function(){for(var ue=arguments.length>0&&arguments[0]!==void 0?arguments[0]:c,X=arguments.length>1&&arguments[1]!==void 0?arguments[1]:!0,S=u.backgrounding,_=0,W=0;W<E.length;W++){var $=e.cy().style().getIndexedStyle(e,"background-image-containment","value",W);if(X&&$==="over"||!X&&$==="inside"){_++;continue}w[W]&&E[W].complete&&!E[W].error&&(_++,o.drawInscribedImage(r,E[W],e,W,ue))}u.backgrounding=_!==C,S!==u.backgrounding&&e.updateStyle(!1)},Ce=function(){var ue=arguments.length>0&&arguments[0]!==void 0?arguments[0]:!1,X=arguments.length>1&&arguments[1]!==void 0?arguments[1]:c;o.hasPie(e)&&(o.drawPie(r,e,X),ue&&(d||o.nodeShapes[o.getNodeShape(e)].draw(r,f.x,f.y,s,l,re,v)))},we=function(){var ue=arguments.length>0&&arguments[0]!==void 0?arguments[0]:!1,X=arguments.length>1&&arguments[1]!==void 0?arguments[1]:c;o.hasStripe(e)&&(r.save(),d?r.clip(v.pathCache):(o.nodeShapes[o.getNodeShape(e)].draw(r,f.x,f.y,s,l,re,v),r.clip()),o.drawStripe(r,e,X),r.restore(),ue&&(d||o.nodeShapes[o.getNodeShape(e)].draw(r,f.x,f.y,s,l,re,v)))},ye=function(){var ue=arguments.length>0&&arguments[0]!==void 0?arguments[0]:c,X=(B>0?B:-B)*ue,S=B>0?0:255;B!==0&&(o.colorFillStyle(r,S,S,S,X),d?r.fill(h):r.fill())},ie=function(){if(P>0){if(r.lineWidth=P,r.lineCap=M,r.lineJoin=I,r.setLineDash)switch(L){case"dotted":r.setLineDash([1,1]);break;case"dashed":r.setLineDash(V),r.lineDashOffset=G;break;case"solid":case"double":r.setLineDash([]);break}if(O!=="center"){if(r.save(),r.lineWidth*=2,O==="inside")d?r.clip(h):r.clip();else{var ue=new Path2D;ue.rect(-s/2-P,-l/2-P,s+2*P,l+2*P),ue.addPath(h),r.clip(ue,"evenodd")}d?r.stroke(h):r.stroke(),r.restore()}else d?r.stroke(h):r.stroke();if(L==="double"){r.lineWidth=P/3;var X=r.globalCompositeOperation;r.globalCompositeOperation="destination-out",d?r.stroke(h):r.stroke(),r.globalCompositeOperation=X}r.setLineDash&&r.setLineDash([])}},he=function(){if(F>0){if(r.lineWidth=F,r.lineCap="butt",r.setLineDash)switch(Q){case"dotted":r.setLineDash([1,1]);break;case"dashed":r.setLineDash([4,2]);break;case"solid":case"double":r.setLineDash([]);break}var ue=f;d&&(ue={x:0,y:0});var X=o.getNodeShape(e),S=P;O==="inside"&&(S=0),O==="outside"&&(S*=2);var _=(s+S+(F+j))/s,W=(l+S+(F+j))/l,$=s*_,Z=l*W,se=o.nodeShapes[X].points,ee;if(d){var ve=q($,Z,X,se);ee=ve.path}if(X==="ellipse")o.drawEllipsePath(ee||r,ue.x,ue.y,$,Z);else if(["round-diamond","round-heptagon","round-hexagon","round-octagon","round-pentagon","round-polygon","round-triangle","round-tag"].includes(X)){var le=0,me=0,De=0;X==="round-diamond"?le=(S+j+F)*1.4:X==="round-heptagon"?(le=(S+j+F)*1.075,De=-(S/2+j+F)/35):X==="round-hexagon"?le=(S+j+F)*1.12:X==="round-pentagon"?(le=(S+j+F)*1.13,De=-(S/2+j+F)/15):X==="round-tag"?(le=(S+j+F)*1.12,me=(S/2+F+j)*.07):X==="round-triangle"&&(le=(S+j+F)*(Math.PI/2),De=-(S+j/2+F)/Math.PI),le!==0&&(_=(s+le)/s,$=s*_,["round-hexagon","round-tag"].includes(X)||(W=(l+le)/l,Z=l*W)),re=re==="auto"?Ev($,Z):re;for(var Te=$/2,fe=Z/2,Pe=re+(S+F+j)/2,Be=new Array(se.length/2),je=new Array(se.length/2),Ke=0;Ke<se.length/2;Ke++)Be[Ke]={x:ue.x+me+Te*se[Ke*2],y:ue.y+De+fe*se[Ke*2+1]};var mr,Ye,ir,er,lr=Be.length;for(Ye=Be[lr-1],mr=0;mr<lr;mr++)ir=Be[mr%lr],er=Be[(mr+1)%lr],je[mr]=ps(Ye,ir,er,Pe),Ye=ir,ir=er;o.drawRoundPolygonPath(ee||r,ue.x+me,ue.y+De,s*_,l*W,se,je)}else if(["roundrectangle","round-rectangle"].includes(X))re=re==="auto"?vt($,Z):re,o.drawRoundRectanglePath(ee||r,ue.x,ue.y,$,Z,re+(S+F+j)/2);else if(["cutrectangle","cut-rectangle"].includes(X))re=re==="auto"?is():re,o.drawCutRectanglePath(ee||r,ue.x,ue.y,$,Z,null,re+(S+F+j)/4);else if(["bottomroundrectangle","bottom-round-rectangle"].includes(X))re=re==="auto"?vt($,Z):re,o.drawBottomRoundRectanglePath(ee||r,ue.x,ue.y,$,Z,re+(S+F+j)/2);else if(X==="barrel")o.drawBarrelPath(ee||r,ue.x,ue.y,$,Z);else if(X.startsWith("polygon")||["rhomboid","right-rhomboid","round-tag","tag","vee"].includes(X)){var jr=(S+F+j)/s;se=En(Cn(se,jr)),o.drawPolygonPath(ee||r,ue.x,ue.y,s,l,se)}else{var Ze=(S+F+j)/s;se=En(Cn(se,-Ze)),o.drawPolygonPath(ee||r,ue.x,ue.y,s,l,se)}if(d?r.stroke(ee):r.stroke(),Q==="double"){r.lineWidth=S/3;var Wr=r.globalCompositeOperation;r.globalCompositeOperation="destination-out",d?r.stroke(ee):r.stroke(),r.globalCompositeOperation=Wr}r.setLineDash&&r.setLineDash([])}},de=function(){n&&o.drawNodeOverlay(r,e,f,s,l)},Ee=function(){n&&o.drawNodeUnderlay(r,e,f,s,l)},pe=function(){o.drawElementText(r,e,null,a)},Se=e.pstyle("ghost").value==="yes";if(Se){var Re=e.pstyle("ghost-offset-x").pfValue,Oe=e.pstyle("ghost-offset-y").pfValue,Ne=e.pstyle("ghost-opacity").value,ze=Ne*c;r.translate(Re,Oe),z(),he(),ne(Ne*A),ce(),Ae(ze,!0),J(Ne*N),ie(),Ce(B!==0||P!==0),we(B!==0||P!==0),Ae(ze,!1),ye(ze),r.translate(-Re,-Oe)}d&&r.translate(-f.x,-f.y),Ee(),d&&r.translate(f.x,f.y),z(),he(),ne(),ce(),Ae(c,!0),J(),ie(),Ce(B!==0||P!==0),we(B!==0||P!==0),Ae(c,!1),ye(),d&&r.translate(-f.x,-f.y),pe(),de(),t&&r.translate(p.x1,p.y1)}};var Pf=function(e){if(!["overlay","underlay"].includes(e))throw new Error("Invalid state");return function(t,a,n,i,o){var s=this;if(a.visible()){var l=a.pstyle("".concat(e,"-padding")).pfValue,u=a.pstyle("".concat(e,"-opacity")).value,v=a.pstyle("".concat(e,"-color")).value,f=a.pstyle("".concat(e,"-shape")).value,c=a.pstyle("".concat(e,"-corner-radius")).value;if(u>0){if(n=n||a.position(),i==null||o==null){var d=a.padding();i=a.width()+2*d,o=a.height()+2*d}s.colorFillStyle(t,v[0],v[1],v[2],u),s.nodeShapes[f].draw(t,n.x,n.y,i+l*2,o+l*2,c),t.fill()}}}};yt.drawNodeOverlay=Pf("overlay");yt.drawNodeUnderlay=Pf("underlay");yt.hasPie=function(r){return r=r[0],r._private.hasPie};yt.hasStripe=function(r){return r=r[0],r._private.hasStripe};yt.drawPie=function(r,e,t,a){e=e[0],a=a||e.position();var n=e.cy().style(),i=e.pstyle("pie-size"),o=e.pstyle("pie-hole"),s=e.pstyle("pie-start-angle").pfValue,l=a.x,u=a.y,v=e.width(),f=e.height(),c=Math.min(v,f)/2,d,h=0,y=this.usePaths();if(y&&(l=0,u=0),i.units==="%"?c=c*i.pfValue:i.pfValue!==void 0&&(c=i.pfValue/2),o.units==="%"?d=c*o.pfValue:o.pfValue!==void 0&&(d=o.pfValue/2),!(d>=c))for(var g=1;g<=n.pieBackgroundN;g++){var p=e.pstyle("pie-"+g+"-background-size").value,m=e.pstyle("pie-"+g+"-background-color").value,b=e.pstyle("pie-"+g+"-background-opacity").value*t,w=p/100;w+h>1&&(w=1-h);var E=1.5*Math.PI+2*Math.PI*h;E+=s;var C=2*Math.PI*w,x=E+C;p===0||h>=1||h+w>1||(d===0?(r.beginPath(),r.moveTo(l,u),r.arc(l,u,c,E,x),r.closePath()):(r.beginPath(),r.arc(l,u,c,E,x),r.arc(l,u,d,x,E,!0),r.closePath()),this.colorFillStyle(r,m[0],m[1],m[2],b),r.fill(),h+=w)}};yt.drawStripe=function(r,e,t,a){e=e[0],a=a||e.position();var n=e.cy().style(),i=a.x,o=a.y,s=e.width(),l=e.height(),u=0,v=this.usePaths();r.save();var f=e.pstyle("stripe-direction").value,c=e.pstyle("stripe-size");switch(f){case"vertical":break;case"righward":r.rotate(-Math.PI/2);break}var d=s,h=l;c.units==="%"?(d=d*c.pfValue,h=h*c.pfValue):c.pfValue!==void 0&&(d=c.pfValue,h=c.pfValue),v&&(i=0,o=0),o-=d/2,i-=h/2;for(var y=1;y<=n.stripeBackgroundN;y++){var g=e.pstyle("stripe-"+y+"-background-size").value,p=e.pstyle("stripe-"+y+"-background-color").value,m=e.pstyle("stripe-"+y+"-background-opacity").value*t,b=g/100;b+u>1&&(b=1-u),!(g===0||u>=1||u+b>1)&&(r.beginPath(),r.rect(i,o+h*u,d,h*b),r.closePath(),this.colorFillStyle(r,p[0],p[1],p[2],m),r.fill(),u+=b)}r.restore()};var xr={},_y=100;xr.getPixelRatio=function(){var r=this.data.contexts[0];if(this.forcedPixelRatio!=null)return this.forcedPixelRatio;var e=this.cy.window(),t=r.backingStorePixelRatio||r.webkitBackingStorePixelRatio||r.mozBackingStorePixelRatio||r.msBackingStorePixelRatio||r.oBackingStorePixelRatio||r.backingStorePixelRatio||1;return(e.devicePixelRatio||1)/t};xr.paintCache=function(r){for(var e=this.paintCaches=this.paintCaches||[],t=!0,a,n=0;n<e.length;n++)if(a=e[n],a.context===r){t=!1;break}return t&&(a={context:r},e.push(a)),a};xr.createGradientStyleFor=function(r,e,t,a,n){var i,o=this.usePaths(),s=t.pstyle(e+"-gradient-stop-colors").value,l=t.pstyle(e+"-gradient-stop-positions").pfValue;if(a==="radial-gradient")if(t.isEdge()){var u=t.sourceEndpoint(),v=t.targetEndpoint(),f=t.midpoint(),c=Bt(u,f),d=Bt(v,f);i=r.createRadialGradient(f.x,f.y,0,f.x,f.y,Math.max(c,d))}else{var h=o?{x:0,y:0}:t.position(),y=t.paddedWidth(),g=t.paddedHeight();i=r.createRadialGradient(h.x,h.y,0,h.x,h.y,Math.max(y,g))}else if(t.isEdge()){var p=t.sourceEndpoint(),m=t.targetEndpoint();i=r.createLinearGradient(p.x,p.y,m.x,m.y)}else{var b=o?{x:0,y:0}:t.position(),w=t.paddedWidth(),E=t.paddedHeight(),C=w/2,x=E/2,T=t.pstyle("background-gradient-direction").value;switch(T){case"to-bottom":i=r.createLinearGradient(b.x,b.y-x,b.x,b.y+x);break;case"to-top":i=r.createLinearGradient(b.x,b.y+x,b.x,b.y-x);break;case"to-left":i=r.createLinearGradient(b.x+C,b.y,b.x-C,b.y);break;case"to-right":i=r.createLinearGradient(b.x-C,b.y,b.x+C,b.y);break;case"to-bottom-right":case"to-right-bottom":i=r.createLinearGradient(b.x-C,b.y-x,b.x+C,b.y+x);break;case"to-top-right":case"to-right-top":i=r.createLinearGradient(b.x-C,b.y+x,b.x+C,b.y-x);break;case"to-bottom-left":case"to-left-bottom":i=r.createLinearGradient(b.x+C,b.y-x,b.x-C,b.y+x);break;case"to-top-left":case"to-left-top":i=r.createLinearGradient(b.x+C,b.y+x,b.x-C,b.y-x);break}}if(!i)return null;for(var k=l.length===s.length,D=s.length,B=0;B<D;B++)i.addColorStop(k?l[B]:B/(D-1),"rgba("+s[B][0]+","+s[B][1]+","+s[B][2]+","+n+")");return i};xr.gradientFillStyle=function(r,e,t,a){var n=this.createGradientStyleFor(r,"background",e,t,a);if(!n)return null;r.fillStyle=n};xr.colorFillStyle=function(r,e,t,a,n){r.fillStyle="rgba("+e+","+t+","+a+","+n+")"};xr.eleFillStyle=function(r,e,t){var a=e.pstyle("background-fill").value;if(a==="linear-gradient"||a==="radial-gradient")this.gradientFillStyle(r,e,a,t);else{var n=e.pstyle("background-color").value;this.colorFillStyle(r,n[0],n[1],n[2],t)}};xr.gradientStrokeStyle=function(r,e,t,a){var n=this.createGradientStyleFor(r,"line",e,t,a);if(!n)return null;r.strokeStyle=n};xr.colorStrokeStyle=function(r,e,t,a,n){r.strokeStyle="rgba("+e+","+t+","+a+","+n+")"};xr.eleStrokeStyle=function(r,e,t){var a=e.pstyle("line-fill").value;if(a==="linear-gradient"||a==="radial-gradient")this.gradientStrokeStyle(r,e,a,t);else{var n=e.pstyle("line-color").value;this.colorStrokeStyle(r,n[0],n[1],n[2],t)}};xr.matchCanvasSize=function(r){var e=this,t=e.data,a=e.findContainerClientCoords(),n=a[2],i=a[3],o=e.getPixelRatio(),s=e.motionBlurPxRatio;(r===e.data.bufferCanvases[e.MOTIONBLUR_BUFFER_NODE]||r===e.data.bufferCanvases[e.MOTIONBLUR_BUFFER_DRAG])&&(o=s);var l=n*o,u=i*o,v;if(!(l===e.canvasWidth&&u===e.canvasHeight)){e.fontCaches=null;var f=t.canvasContainer;f.style.width=n+"px",f.style.height=i+"px";for(var c=0;c<e.CANVAS_LAYERS;c++)v=t.canvases[c],v.width=l,v.height=u,v.style.width=n+"px",v.style.height=i+"px";for(var c=0;c<e.BUFFER_COUNT;c++)v=t.bufferCanvases[c],v.width=l,v.height=u,v.style.width=n+"px",v.style.height=i+"px";e.textureMult=1,o<=1&&(v=t.bufferCanvases[e.TEXTURE_BUFFER],e.textureMult=2,v.width=l*e.textureMult,v.height=u*e.textureMult),e.canvasWidth=l,e.canvasHeight=u,e.pixelRatio=o}};xr.renderTo=function(r,e,t,a){this.render({forcedContext:r,forcedZoom:e,forcedPan:t,drawAllLayers:!0,forcedPxRatio:a})};xr.clearCanvas=function(){var r=this,e=r.data;function t(a){a.clearRect(0,0,r.canvasWidth,r.canvasHeight)}t(e.contexts[r.NODE]),t(e.contexts[r.DRAG])};xr.render=function(r){var e=this;r=r||pv();var t=e.cy,a=r.forcedContext,n=r.drawAllLayers,i=r.drawOnlyNodeLayer,o=r.forcedZoom,s=r.forcedPan,l=r.forcedPxRatio===void 0?this.getPixelRatio():r.forcedPxRatio,u=e.data,v=u.canvasNeedsRedraw,f=e.textureOnViewport&&!a&&(e.pinching||e.hoverData.dragging||e.swipePanning||e.data.wheelZooming),c=r.motionBlur!==void 0?r.motionBlur:e.motionBlur,d=e.motionBlurPxRatio,h=t.hasCompoundNodes(),y=e.hoverData.draggingEles,g=!!(e.hoverData.selecting||e.touchData.selecting);c=c&&!a&&e.motionBlurEnabled&&!g;var p=c;a||(e.prevPxRatio!==l&&(e.invalidateContainerClientCoordsCache(),e.matchCanvasSize(e.container),e.redrawHint("eles",!0),e.redrawHint("drag",!0)),e.prevPxRatio=l),!a&&e.motionBlurTimeout&&clearTimeout(e.motionBlurTimeout),c&&(e.mbFrames==null&&(e.mbFrames=0),e.mbFrames++,e.mbFrames<3&&(p=!1),e.mbFrames>e.minMbLowQualFrames&&(e.motionBlurPxRatio=e.mbPxRBlurry)),e.clearingMotionBlur&&(e.motionBlurPxRatio=1),e.textureDrawLastFrame&&!f&&(v[e.NODE]=!0,v[e.SELECT_BOX]=!0);var m=t.style(),b=t.zoom(),w=o!==void 0?o:b,E=t.pan(),C={x:E.x,y:E.y},x={zoom:b,pan:{x:E.x,y:E.y}},T=e.prevViewport,k=T===void 0||x.zoom!==T.zoom||x.pan.x!==T.pan.x||x.pan.y!==T.pan.y;!k&&!(y&&!h)&&(e.motionBlurPxRatio=1),s&&(C=s),w*=l,C.x*=l,C.y*=l;var D=e.getCachedZSortedEles();function B(J,z,q,H,Y){var te=J.globalCompositeOperation;J.globalCompositeOperation="destination-out",e.colorFillStyle(J,255,255,255,e.motionBlurTransparency),J.fillRect(z,q,H,Y),J.globalCompositeOperation=te}function P(J,z){var q,H,Y,te;!e.clearingMotionBlur&&(J===u.bufferContexts[e.MOTIONBLUR_BUFFER_NODE]||J===u.bufferContexts[e.MOTIONBLUR_BUFFER_DRAG])?(q={x:E.x*d,y:E.y*d},H=b*d,Y=e.canvasWidth*d,te=e.canvasHeight*d):(q=C,H=w,Y=e.canvasWidth,te=e.canvasHeight),J.setTransform(1,0,0,1,0,0),z==="motionBlur"?B(J,0,0,Y,te):!a&&(z===void 0||z)&&J.clearRect(0,0,Y,te),n||(J.translate(q.x,q.y),J.scale(H,H)),s&&J.translate(s.x,s.y),o&&J.scale(o,o)}if(f||(e.textureDrawLastFrame=!1),f){if(e.textureDrawLastFrame=!0,!e.textureCache){e.textureCache={},e.textureCache.bb=t.mutableElements().boundingBox(),e.textureCache.texture=e.data.bufferCanvases[e.TEXTURE_BUFFER];var A=e.data.bufferContexts[e.TEXTURE_BUFFER];A.setTransform(1,0,0,1,0,0),A.clearRect(0,0,e.canvasWidth*e.textureMult,e.canvasHeight*e.textureMult),e.render({forcedContext:A,drawOnlyNodeLayer:!0,forcedPxRatio:l*e.textureMult});var x=e.textureCache.viewport={zoom:t.zoom(),pan:t.pan(),width:e.canvasWidth,height:e.canvasHeight};x.mpan={x:(0-x.pan.x)/x.zoom,y:(0-x.pan.y)/x.zoom}}v[e.DRAG]=!1,v[e.NODE]=!1;var R=u.contexts[e.NODE],L=e.textureCache.texture,x=e.textureCache.viewport;R.setTransform(1,0,0,1,0,0),c?B(R,0,0,x.width,x.height):R.clearRect(0,0,x.width,x.height);var I=m.core("outside-texture-bg-color").value,M=m.core("outside-texture-bg-opacity").value;e.colorFillStyle(R,I[0],I[1],I[2],M),R.fillRect(0,0,x.width,x.height);var b=t.zoom();P(R,!1),R.clearRect(x.mpan.x,x.mpan.y,x.width/x.zoom/l,x.height/x.zoom/l),R.drawImage(L,x.mpan.x,x.mpan.y,x.width/x.zoom/l,x.height/x.zoom/l)}else e.textureOnViewport&&!a&&(e.textureCache=null);var O=t.extent(),V=e.pinching||e.hoverData.dragging||e.swipePanning||e.data.wheelZooming||e.hoverData.draggingEles||e.cy.animated(),G=e.hideEdgesOnViewport&&V,N=[];if(N[e.NODE]=!v[e.NODE]&&c&&!e.clearedForMotionBlur[e.NODE]||e.clearingMotionBlur,N[e.NODE]&&(e.clearedForMotionBlur[e.NODE]=!0),N[e.DRAG]=!v[e.DRAG]&&c&&!e.clearedForMotionBlur[e.DRAG]||e.clearingMotionBlur,N[e.DRAG]&&(e.clearedForMotionBlur[e.DRAG]=!0),v[e.NODE]||n||i||N[e.NODE]){var F=c&&!N[e.NODE]&&d!==1,R=a||(F?e.data.bufferContexts[e.MOTIONBLUR_BUFFER_NODE]:u.contexts[e.NODE]),U=c&&!F?"motionBlur":void 0;P(R,U),G?e.drawCachedNodes(R,D.nondrag,l,O):e.drawLayeredElements(R,D.nondrag,l,O),e.debug&&e.drawDebugPoints(R,D.nondrag),!n&&!c&&(v[e.NODE]=!1)}if(!i&&(v[e.DRAG]||n||N[e.DRAG])){var F=c&&!N[e.DRAG]&&d!==1,R=a||(F?e.data.bufferContexts[e.MOTIONBLUR_BUFFER_DRAG]:u.contexts[e.DRAG]);P(R,c&&!F?"motionBlur":void 0),G?e.drawCachedNodes(R,D.drag,l,O):e.drawCachedElements(R,D.drag,l,O),e.debug&&e.drawDebugPoints(R,D.drag),!n&&!c&&(v[e.DRAG]=!1)}if(this.drawSelectionRectangle(r,P),c&&d!==1){var Q=u.contexts[e.NODE],K=e.data.bufferCanvases[e.MOTIONBLUR_BUFFER_NODE],j=u.contexts[e.DRAG],re=e.data.bufferCanvases[e.MOTIONBLUR_BUFFER_DRAG],ne=function(z,q,H){z.setTransform(1,0,0,1,0,0),H||!p?z.clearRect(0,0,e.canvasWidth,e.canvasHeight):B(z,0,0,e.canvasWidth,e.canvasHeight);var Y=d;z.drawImage(q,0,0,e.canvasWidth*Y,e.canvasHeight*Y,0,0,e.canvasWidth,e.canvasHeight)};(v[e.NODE]||N[e.NODE])&&(ne(Q,K,N[e.NODE]),v[e.NODE]=!1),(v[e.DRAG]||N[e.DRAG])&&(ne(j,re,N[e.DRAG]),v[e.DRAG]=!1)}e.prevViewport=x,e.clearingMotionBlur&&(e.clearingMotionBlur=!1,e.motionBlurCleared=!0,e.motionBlur=!0),c&&(e.motionBlurTimeout=setTimeout(function(){e.motionBlurTimeout=null,e.clearedForMotionBlur[e.NODE]=!1,e.clearedForMotionBlur[e.DRAG]=!1,e.motionBlur=!1,e.clearingMotionBlur=!f,e.mbFrames=0,v[e.NODE]=!0,v[e.DRAG]=!0,e.redraw()},_y)),a||t.emit("render")};var da;xr.drawSelectionRectangle=function(r,e){var t=this,a=t.cy,n=t.data,i=a.style(),o=r.drawOnlyNodeLayer,s=r.drawAllLayers,l=n.canvasNeedsRedraw,u=r.forcedContext;if(t.showFps||!o&&l[t.SELECT_BOX]&&!s){var v=u||n.contexts[t.SELECT_BOX];if(e(v),t.selection[4]==1&&(t.hoverData.selecting||t.touchData.selecting)){var f=t.cy.zoom(),c=i.core("selection-box-border-width").value/f;v.lineWidth=c,v.fillStyle="rgba("+i.core("selection-box-color").value[0]+","+i.core("selection-box-color").value[1]+","+i.core("selection-box-color").value[2]+","+i.core("selection-box-opacity").value+")",v.fillRect(t.selection[0],t.selection[1],t.selection[2]-t.selection[0],t.selection[3]-t.selection[1]),c>0&&(v.strokeStyle="rgba("+i.core("selection-box-border-color").value[0]+","+i.core("selection-box-border-color").value[1]+","+i.core("selection-box-border-color").value[2]+","+i.core("selection-box-opacity").value+")",v.strokeRect(t.selection[0],t.selection[1],t.selection[2]-t.selection[0],t.selection[3]-t.selection[1]))}if(n.bgActivePosistion&&!t.hoverData.selecting){var f=t.cy.zoom(),d=n.bgActivePosistion;v.fillStyle="rgba("+i.core("active-bg-color").value[0]+","+i.core("active-bg-color").value[1]+","+i.core("active-bg-color").value[2]+","+i.core("active-bg-opacity").value+")",v.beginPath(),v.arc(d.x,d.y,i.core("active-bg-size").pfValue/f,0,2*Math.PI),v.fill()}var h=t.lastRedrawTime;if(t.showFps&&h){h=Math.round(h);var y=Math.round(1e3/h),g="1 frame = "+h+" ms = "+y+" fps";if(v.setTransform(1,0,0,1,0,0),v.fillStyle="rgba(255, 0, 0, 0.75)",v.strokeStyle="rgba(255, 0, 0, 0.75)",v.font="30px Arial",!da){var p=v.measureText(g);da=p.actualBoundingBoxAscent}v.fillText(g,0,da);var m=60;v.strokeRect(0,da+10,250,20),v.fillRect(0,da+10,250*Math.min(y/m,1),20)}s||(l[t.SELECT_BOX]=!1)}};function Hl(r,e,t){var a=r.createShader(e);if(r.shaderSource(a,t),r.compileShader(a),!r.getShaderParameter(a,r.COMPILE_STATUS))throw new Error(r.getShaderInfoLog(a));return a}function Gy(r,e,t){var a=Hl(r,r.VERTEX_SHADER,e),n=Hl(r,r.FRAGMENT_SHADER,t),i=r.createProgram();if(r.attachShader(i,a),r.attachShader(i,n),r.linkProgram(i),!r.getProgramParameter(i,r.LINK_STATUS))throw new Error("Could not initialize shaders");return i}function Hy(r,e,t){t===void 0&&(t=e);var a=r.makeOffscreenCanvas(e,t),n=a.context=a.getContext("2d");return a.clear=function(){return n.clearRect(0,0,a.width,a.height)},a.clear(),a}function bs(r){var e=r.pixelRatio,t=r.cy.zoom(),a=r.cy.pan();return{zoom:t*e,pan:{x:a.x*e,y:a.y*e}}}function Wy(r){var e=r.pixelRatio,t=r.cy.zoom();return t*e}function $y(r,e,t,a,n){var i=a*t+e.x,o=n*t+e.y;return o=Math.round(r.canvasHeight-o),[i,o]}function Uy(r){return r.pstyle("background-fill").value!=="solid"||r.pstyle("background-image").strValue!=="none"?!1:r.pstyle("border-width").value===0||r.pstyle("border-opacity").value===0?!0:r.pstyle("border-style").value==="solid"}function Ky(r,e){if(r.length!==e.length)return!1;for(var t=0;t<r.length;t++)if(r[t]!==e[t])return!1;return!0}function xt(r,e,t){var a=r[0]/255,n=r[1]/255,i=r[2]/255,o=e,s=t||new Array(4);return s[0]=a*o,s[1]=n*o,s[2]=i*o,s[3]=o,s}function qt(r,e){var t=e||new Array(4);return t[0]=(r>>0&255)/255,t[1]=(r>>8&255)/255,t[2]=(r>>16&255)/255,t[3]=(r>>24&255)/255,t}function Xy(r){return r[0]+(r[1]<<8)+(r[2]<<16)+(r[3]<<24)}function Yy(r,e){var t=r.createTexture();return t.buffer=function(a){r.bindTexture(r.TEXTURE_2D,t),r.texParameteri(r.TEXTURE_2D,r.TEXTURE_WRAP_S,r.CLAMP_TO_EDGE),r.texParameteri(r.TEXTURE_2D,r.TEXTURE_WRAP_T,r.CLAMP_TO_EDGE),r.texParameteri(r.TEXTURE_2D,r.TEXTURE_MAG_FILTER,r.LINEAR),r.texParameteri(r.TEXTURE_2D,r.TEXTURE_MIN_FILTER,r.LINEAR_MIPMAP_NEAREST),r.pixelStorei(r.UNPACK_PREMULTIPLY_ALPHA_WEBGL,!0),r.texImage2D(r.TEXTURE_2D,0,r.RGBA,r.RGBA,r.UNSIGNED_BYTE,a),r.generateMipmap(r.TEXTURE_2D),r.bindTexture(r.TEXTURE_2D,null)},t.deleteTexture=function(){r.deleteTexture(t)},t}function Af(r,e){switch(e){case"float":return[1,r.FLOAT,4];case"vec2":return[2,r.FLOAT,4];case"vec3":return[3,r.FLOAT,4];case"vec4":return[4,r.FLOAT,4];case"int":return[1,r.INT,4];case"ivec2":return[2,r.INT,4]}}function Rf(r,e,t){switch(e){case r.FLOAT:return new Float32Array(t);case r.INT:return new Int32Array(t)}}function Zy(r,e,t,a,n,i){switch(e){case r.FLOAT:return new Float32Array(t.buffer,i*a,n);case r.INT:return new Int32Array(t.buffer,i*a,n)}}function Qy(r,e,t,a){var n=Af(r,e),i=Je(n,2),o=i[0],s=i[1],l=Rf(r,s,a),u=r.createBuffer();return r.bindBuffer(r.ARRAY_BUFFER,u),r.bufferData(r.ARRAY_BUFFER,l,r.STATIC_DRAW),s===r.FLOAT?r.vertexAttribPointer(t,o,s,!1,0,0):s===r.INT&&r.vertexAttribIPointer(t,o,s,0,0),r.enableVertexAttribArray(t),r.bindBuffer(r.ARRAY_BUFFER,null),u}function Fr(r,e,t,a){var n=Af(r,t),i=Je(n,3),o=i[0],s=i[1],l=i[2],u=Rf(r,s,e*o),v=o*l,f=r.createBuffer();r.bindBuffer(r.ARRAY_BUFFER,f),r.bufferData(r.ARRAY_BUFFER,e*v,r.DYNAMIC_DRAW),r.enableVertexAttribArray(a),s===r.FLOAT?r.vertexAttribPointer(a,o,s,!1,v,0):s===r.INT&&r.vertexAttribIPointer(a,o,s,v,0),r.vertexAttribDivisor(a,1),r.bindBuffer(r.ARRAY_BUFFER,null);for(var c=new Array(e),d=0;d<e;d++)c[d]=Zy(r,s,u,v,o,d);return f.dataArray=u,f.stride=v,f.size=o,f.getView=function(h){return c[h]},f.setPoint=function(h,y,g){var p=c[h];p[0]=y,p[1]=g},f.bufferSubData=function(h){r.bindBuffer(r.ARRAY_BUFFER,f),h?r.bufferSubData(r.ARRAY_BUFFER,0,u,0,h*o):r.bufferSubData(r.ARRAY_BUFFER,0,u)},f}function Jy(r,e,t){for(var a=9,n=new Float32Array(e*a),i=new Array(e),o=0;o<e;o++){var s=o*a*4;i[o]=new Float32Array(n.buffer,s,a)}var l=r.createBuffer();r.bindBuffer(r.ARRAY_BUFFER,l),r.bufferData(r.ARRAY_BUFFER,n.byteLength,r.DYNAMIC_DRAW);for(var u=0;u<3;u++){var v=t+u;r.enableVertexAttribArray(v),r.vertexAttribPointer(v,3,r.FLOAT,!1,36,u*12),r.vertexAttribDivisor(v,1)}return r.bindBuffer(r.ARRAY_BUFFER,null),l.getMatrixView=function(f){return i[f]},l.setData=function(f,c){i[c].set(f,0)},l.bufferSubData=function(){r.bindBuffer(r.ARRAY_BUFFER,l),r.bufferSubData(r.ARRAY_BUFFER,0,n)},l}function jy(r){var e=r.createFramebuffer();r.bindFramebuffer(r.FRAMEBUFFER,e);var t=r.createTexture();return r.bindTexture(r.TEXTURE_2D,t),r.texParameteri(r.TEXTURE_2D,r.TEXTURE_MIN_FILTER,r.LINEAR),r.texParameteri(r.TEXTURE_2D,r.TEXTURE_WRAP_S,r.CLAMP_TO_EDGE),r.texParameteri(r.TEXTURE_2D,r.TEXTURE_WRAP_T,r.CLAMP_TO_EDGE),r.framebufferTexture2D(r.FRAMEBUFFER,r.COLOR_ATTACHMENT0,r.TEXTURE_2D,t,0),r.bindFramebuffer(r.FRAMEBUFFER,null),e.setFramebufferAttachmentSizes=function(a,n){r.bindTexture(r.TEXTURE_2D,t),r.texImage2D(r.TEXTURE_2D,0,r.RGBA,a,n,0,r.RGBA,r.UNSIGNED_BYTE,null)},e}var Wl=typeof Float32Array<"u"?Float32Array:Array;Math.hypot||(Math.hypot=function(){for(var r=0,e=arguments.length;e--;)r+=arguments[e]*arguments[e];return Math.sqrt(r)});function Co(){var r=new Wl(9);return Wl!=Float32Array&&(r[1]=0,r[2]=0,r[3]=0,r[5]=0,r[6]=0,r[7]=0),r[0]=1,r[4]=1,r[8]=1,r}function $l(r){return r[0]=1,r[1]=0,r[2]=0,r[3]=0,r[4]=1,r[5]=0,r[6]=0,r[7]=0,r[8]=1,r}function em(r,e,t){var a=e[0],n=e[1],i=e[2],o=e[3],s=e[4],l=e[5],u=e[6],v=e[7],f=e[8],c=t[0],d=t[1],h=t[2],y=t[3],g=t[4],p=t[5],m=t[6],b=t[7],w=t[8];return r[0]=c*a+d*o+h*u,r[1]=c*n+d*s+h*v,r[2]=c*i+d*l+h*f,r[3]=y*a+g*o+p*u,r[4]=y*n+g*s+p*v,r[5]=y*i+g*l+p*f,r[6]=m*a+b*o+w*u,r[7]=m*n+b*s+w*v,r[8]=m*i+b*l+w*f,r}function yn(r,e,t){var a=e[0],n=e[1],i=e[2],o=e[3],s=e[4],l=e[5],u=e[6],v=e[7],f=e[8],c=t[0],d=t[1];return r[0]=a,r[1]=n,r[2]=i,r[3]=o,r[4]=s,r[5]=l,r[6]=c*a+d*o+u,r[7]=c*n+d*s+v,r[8]=c*i+d*l+f,r}function Ul(r,e,t){var a=e[0],n=e[1],i=e[2],o=e[3],s=e[4],l=e[5],u=e[6],v=e[7],f=e[8],c=Math.sin(t),d=Math.cos(t);return r[0]=d*a+c*o,r[1]=d*n+c*s,r[2]=d*i+c*l,r[3]=d*o-c*a,r[4]=d*s-c*n,r[5]=d*l-c*i,r[6]=u,r[7]=v,r[8]=f,r}function $o(r,e,t){var a=t[0],n=t[1];return r[0]=a*e[0],r[1]=a*e[1],r[2]=a*e[2],r[3]=n*e[3],r[4]=n*e[4],r[5]=n*e[5],r[6]=e[6],r[7]=e[7],r[8]=e[8],r}function rm(r,e,t){return r[0]=2/e,r[1]=0,r[2]=0,r[3]=0,r[4]=-2/t,r[5]=0,r[6]=-1,r[7]=1,r[8]=1,r}var tm=(function(){function r(e,t,a,n){dt(this,r),this.debugID=Math.floor(Math.random()*1e4),this.r=e,this.texSize=t,this.texRows=a,this.texHeight=Math.floor(t/a),this.enableWrapping=!0,this.locked=!1,this.texture=null,this.needsBuffer=!0,this.freePointer={x:0,row:0},this.keyToLocation=new Map,this.canvas=n(e,t,t),this.scratch=n(e,t,this.texHeight,"scratch")}return gt(r,[{key:"lock",value:function(){this.locked=!0}},{key:"getKeys",value:function(){return new Set(this.keyToLocation.keys())}},{key:"getScale",value:function(t){var a=t.w,n=t.h,i=this.texHeight,o=this.texSize,s=i/n,l=a*s,u=n*s;return l>o&&(s=o/a,l=a*s,u=n*s),{scale:s,texW:l,texH:u}}},{key:"draw",value:function(t,a,n){var i=this;if(this.locked)throw new Error("can't draw, atlas is locked");var o=this.texSize,s=this.texRows,l=this.texHeight,u=this.getScale(a),v=u.scale,f=u.texW,c=u.texH,d=function(b,w){if(n&&w){var E=w.context,C=b.x,x=b.row,T=C,k=l*x;E.save(),E.translate(T,k),E.scale(v,v),n(E,a),E.restore()}},h=[null,null],y=function(){d(i.freePointer,i.canvas),h[0]={x:i.freePointer.x,y:i.freePointer.row*l,w:f,h:c},h[1]={x:i.freePointer.x+f,y:i.freePointer.row*l,w:0,h:c},i.freePointer.x+=f,i.freePointer.x==o&&(i.freePointer.x=0,i.freePointer.row++)},g=function(){var b=i.scratch,w=i.canvas;b.clear(),d({x:0,row:0},b);var E=o-i.freePointer.x,C=f-E,x=l;{var T=i.freePointer.x,k=i.freePointer.row*l,D=E;w.context.drawImage(b,0,0,D,x,T,k,D,x),h[0]={x:T,y:k,w:D,h:c}}{var B=E,P=(i.freePointer.row+1)*l,A=C;w&&w.context.drawImage(b,B,0,A,x,0,P,A,x),h[1]={x:0,y:P,w:A,h:c}}i.freePointer.x=C,i.freePointer.row++},p=function(){i.freePointer.x=0,i.freePointer.row++};if(this.freePointer.x+f<=o)y();else{if(this.freePointer.row>=s-1)return!1;this.freePointer.x===o?(p(),y()):this.enableWrapping?g():(p(),y())}return this.keyToLocation.set(t,h),this.needsBuffer=!0,h}},{key:"getOffsets",value:function(t){return this.keyToLocation.get(t)}},{key:"isEmpty",value:function(){return this.freePointer.x===0&&this.freePointer.row===0}},{key:"canFit",value:function(t){if(this.locked)return!1;var a=this.texSize,n=this.texRows,i=this.getScale(t),o=i.texW;return this.freePointer.x+o>a?this.freePointer.row<n-1:!0}},{key:"bufferIfNeeded",value:function(t){this.texture||(this.texture=Yy(t,this.debugID)),this.needsBuffer&&(this.texture.buffer(this.canvas),this.needsBuffer=!1,this.locked&&(this.canvas=null,this.scratch=null))}},{key:"dispose",value:function(){this.texture&&(this.texture.deleteTexture(),this.texture=null),this.canvas=null,this.scratch=null,this.locked=!0}}])})(),am=(function(){function r(e,t,a,n){dt(this,r),this.r=e,this.texSize=t,this.texRows=a,this.createTextureCanvas=n,this.atlases=[],this.styleKeyToAtlas=new Map,this.markedKeys=new Set}return gt(r,[{key:"getKeys",value:function(){return new Set(this.styleKeyToAtlas.keys())}},{key:"_createAtlas",value:function(){var t=this.r,a=this.texSize,n=this.texRows,i=this.createTextureCanvas;return new tm(t,a,n,i)}},{key:"_getScratchCanvas",value:function(){if(!this.scratch){var t=this.r,a=this.texSize,n=this.texRows,i=this.createTextureCanvas,o=Math.floor(a/n);this.scratch=i(t,a,o,"scratch")}return this.scratch}},{key:"draw",value:function(t,a,n){var i=this.styleKeyToAtlas.get(t);return i||(i=this.atlases[this.atlases.length-1],(!i||!i.canFit(a))&&(i&&i.lock(),i=this._createAtlas(),this.atlases.push(i)),i.draw(t,a,n),this.styleKeyToAtlas.set(t,i)),i}},{key:"getAtlas",value:function(t){return this.styleKeyToAtlas.get(t)}},{key:"hasAtlas",value:function(t){return this.styleKeyToAtlas.has(t)}},{key:"markKeyForGC",value:function(t){this.markedKeys.add(t)}},{key:"gc",value:function(){var t=this,a=this.markedKeys;if(a.size===0){console.log("nothing to garbage collect");return}var n=[],i=new Map,o=null,s=kr(this.atlases),l;try{var u=function(){var f=l.value,c=f.getKeys(),d=nm(a,c);if(d.size===0)return n.push(f),c.forEach(function(E){return i.set(E,f)}),1;o||(o=t._createAtlas(),n.push(o));var h=kr(c),y;try{for(h.s();!(y=h.n()).done;){var g=y.value;if(!d.has(g)){var p=f.getOffsets(g),m=Je(p,2),b=m[0],w=m[1];o.canFit({w:b.w+w.w,h:b.h})||(o.lock(),o=t._createAtlas(),n.push(o)),f.canvas&&(t._copyTextureToNewAtlas(g,f,o),i.set(g,o))}}}catch(E){h.e(E)}finally{h.f()}f.dispose()};for(s.s();!(l=s.n()).done;)u()}catch(v){s.e(v)}finally{s.f()}this.atlases=n,this.styleKeyToAtlas=i,this.markedKeys=new Set}},{key:"_copyTextureToNewAtlas",value:function(t,a,n){var i=a.getOffsets(t),o=Je(i,2),s=o[0],l=o[1];if(l.w===0)n.draw(t,s,function(c){c.drawImage(a.canvas,s.x,s.y,s.w,s.h,0,0,s.w,s.h)});else{var u=this._getScratchCanvas();u.clear(),u.context.drawImage(a.canvas,s.x,s.y,s.w,s.h,0,0,s.w,s.h),u.context.drawImage(a.canvas,l.x,l.y,l.w,l.h,s.w,0,l.w,l.h);var v=s.w+l.w,f=s.h;n.draw(t,{w:v,h:f},function(c){c.drawImage(u,0,0,v,f,0,0,v,f)})}}},{key:"getCounts",value:function(){return{keyCount:this.styleKeyToAtlas.size,atlasCount:new Set(this.styleKeyToAtlas.values()).size}}}])})();function nm(r,e){return r.intersection?r.intersection(e):new Set(mn(r).filter(function(t){return e.has(t)}))}var im=(function(){function r(e,t){dt(this,r),this.r=e,this.globalOptions=t,this.atlasSize=t.webglTexSize,this.maxAtlasesPerBatch=t.webglTexPerBatch,this.renderTypes=new Map,this.collections=new Map,this.typeAndIdToKey=new Map}return gt(r,[{key:"getAtlasSize",value:function(){return this.atlasSize}},{key:"addAtlasCollection",value:function(t,a){var n=this.globalOptions,i=n.webglTexSize,o=n.createTextureCanvas,s=a.texRows,l=this._cacheScratchCanvas(o),u=new am(this.r,i,s,l);this.collections.set(t,u)}},{key:"addRenderType",value:function(t,a){var n=a.collection;if(!this.collections.has(n))throw new Error("invalid atlas collection name '".concat(n,"'"));var i=this.collections.get(n),o=be({type:t,atlasCollection:i},a);this.renderTypes.set(t,o)}},{key:"getRenderTypeOpts",value:function(t){return this.renderTypes.get(t)}},{key:"getAtlasCollection",value:function(t){return this.collections.get(t)}},{key:"_cacheScratchCanvas",value:function(t){var a=-1,n=-1,i=null;return function(o,s,l,u){return u?((!i||s!=a||l!=n)&&(a=s,n=l,i=t(o,s,l)),i):t(o,s,l)}}},{key:"_key",value:function(t,a){return"".concat(t,"-").concat(a)}},{key:"invalidate",value:function(t){var a=this,n=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{},i=n.forceRedraw,o=i===void 0?!1:i,s=n.filterEle,l=s===void 0?function(){return!0}:s,u=n.filterType,v=u===void 0?function(){return!0}:u,f=!1,c=!1,d=kr(t),h;try{for(d.s();!(h=d.n()).done;){var y=h.value;if(l(y)){var g=kr(this.renderTypes.values()),p;try{var m=function(){var w=p.value,E=w.type;if(v(E)){var C=a.collections.get(w.collection),x=w.getKey(y),T=Array.isArray(x)?x:[x];if(o)T.forEach(function(P){return C.markKeyForGC(P)}),c=!0;else{var k=w.getID?w.getID(y):y.id(),D=a._key(E,k),B=a.typeAndIdToKey.get(D);B!==void 0&&!Ky(T,B)&&(f=!0,a.typeAndIdToKey.delete(D),B.forEach(function(P){return C.markKeyForGC(P)}))}}};for(g.s();!(p=g.n()).done;)m()}catch(b){g.e(b)}finally{g.f()}}}}catch(b){d.e(b)}finally{d.f()}return c&&(this.gc(),f=!1),f}},{key:"gc",value:function(){var t=kr(this.collections.values()),a;try{for(t.s();!(a=t.n()).done;){var n=a.value;n.gc()}}catch(i){t.e(i)}finally{t.f()}}},{key:"getOrCreateAtlas",value:function(t,a,n,i){var o=this.renderTypes.get(a),s=this.collections.get(o.collection),l=!1,u=s.draw(i,n,function(c){o.drawClipped?(c.save(),c.beginPath(),c.rect(0,0,n.w,n.h),c.clip(),o.drawElement(c,t,n,!0,!0),c.restore()):o.drawElement(c,t,n,!0,!0),l=!0});if(l){var v=o.getID?o.getID(t):t.id(),f=this._key(a,v);this.typeAndIdToKey.has(f)?this.typeAndIdToKey.get(f).push(i):this.typeAndIdToKey.set(f,[i])}return u}},{key:"getAtlasInfo",value:function(t,a){var n=this,i=this.renderTypes.get(a),o=i.getKey(t),s=Array.isArray(o)?o:[o];return s.map(function(l){var u=i.getBoundingBox(t,l),v=n.getOrCreateAtlas(t,a,u,l),f=v.getOffsets(l),c=Je(f,2),d=c[0],h=c[1];return{atlas:v,tex:d,tex1:d,tex2:h,bb:u}})}},{key:"getDebugInfo",value:function(){var t=[],a=kr(this.collections),n;try{for(a.s();!(n=a.n()).done;){var i=Je(n.value,2),o=i[0],s=i[1],l=s.getCounts(),u=l.keyCount,v=l.atlasCount;t.push({type:o,keyCount:u,atlasCount:v})}}catch(f){a.e(f)}finally{a.f()}return t}}])})(),om=(function(){function r(e){dt(this,r),this.globalOptions=e,this.atlasSize=e.webglTexSize,this.maxAtlasesPerBatch=e.webglTexPerBatch,this.batchAtlases=[]}return gt(r,[{key:"getMaxAtlasesPerBatch",value:function(){return this.maxAtlasesPerBatch}},{key:"getAtlasSize",value:function(){return this.atlasSize}},{key:"getIndexArray",value:function(){return Array.from({length:this.maxAtlasesPerBatch},function(t,a){return a})}},{key:"startBatch",value:function(){this.batchAtlases=[]}},{key:"getAtlasCount",value:function(){return this.batchAtlases.length}},{key:"getAtlases",value:function(){return this.batchAtlases}},{key:"canAddToCurrentBatch",value:function(t){return this.batchAtlases.length===this.maxAtlasesPerBatch?this.batchAtlases.includes(t):!0}},{key:"getAtlasIndexForBatch",value:function(t){var a=this.batchAtlases.indexOf(t);if(a<0){if(this.batchAtlases.length===this.maxAtlasesPerBatch)throw new Error("cannot add more atlases to batch");this.batchAtlases.push(t),a=this.batchAtlases.length-1}return a}}])})(),sm=`
-  float circleSD(vec2 p, float r) {
-    return distance(vec2(0), p) - r; // signed distance
-  }
-`,um=`
-  float rectangleSD(vec2 p, vec2 b) {
-    vec2 d = abs(p)-b;
-    return distance(vec2(0),max(d,0.0)) + min(max(d.x,d.y),0.0);
-  }
-`,lm=`
-  float roundRectangleSD(vec2 p, vec2 b, vec4 cr) {
-    cr.xy = (p.x > 0.0) ? cr.xy : cr.zw;
-    cr.x  = (p.y > 0.0) ? cr.x  : cr.y;
-    vec2 q = abs(p) - b + cr.x;
-    return min(max(q.x, q.y), 0.0) + distance(vec2(0), max(q, 0.0)) - cr.x;
-  }
-`,vm=`
-  float ellipseSD(vec2 p, vec2 ab) {
-    p = abs( p ); // symmetry
-
-    // find root with Newton solver
-    vec2 q = ab*(p-ab);
-    float w = (q.x<q.y)? 1.570796327 : 0.0;
-    for( int i=0; i<5; i++ ) {
-      vec2 cs = vec2(cos(w),sin(w));
-      vec2 u = ab*vec2( cs.x,cs.y);
-      vec2 v = ab*vec2(-cs.y,cs.x);
-      w = w + dot(p-u,v)/(dot(p-u,u)+dot(v,v));
-    }
-    
-    // compute final point and distance
-    float d = length(p-ab*vec2(cos(w),sin(w)));
-    
-    // return signed distance
-    return (dot(p/ab,p/ab)>1.0) ? d : -d;
-  }
-`,Ea={SCREEN:{name:"screen",screen:!0},PICKING:{name:"picking",picking:!0}},An={IGNORE:1,USE_BB:2},To=0,Kl=1,Xl=2,So=3,_t=4,on=5,ga=6,pa=7,fm=(function(){function r(e,t,a){dt(this,r),this.r=e,this.gl=t,this.maxInstances=a.webglBatchSize,this.atlasSize=a.webglTexSize,this.bgColor=a.bgColor,this.debug=a.webglDebug,this.batchDebugInfo=[],a.enableWrapping=!0,a.createTextureCanvas=Hy,this.atlasManager=new im(e,a),this.batchManager=new om(a),this.simpleShapeOptions=new Map,this.program=this._createShaderProgram(Ea.SCREEN),this.pickingProgram=this._createShaderProgram(Ea.PICKING),this.vao=this._createVAO()}return gt(r,[{key:"addAtlasCollection",value:function(t,a){this.atlasManager.addAtlasCollection(t,a)}},{key:"addTextureAtlasRenderType",value:function(t,a){this.atlasManager.addRenderType(t,a)}},{key:"addSimpleShapeRenderType",value:function(t,a){this.simpleShapeOptions.set(t,a)}},{key:"invalidate",value:function(t){var a=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{},n=a.type,i=this.atlasManager;return n?i.invalidate(t,{filterType:function(s){return s===n},forceRedraw:!0}):i.invalidate(t)}},{key:"gc",value:function(){this.atlasManager.gc()}},{key:"_createShaderProgram",value:function(t){var a=this.gl,n=`#version 300 es
-      precision highp float;
-
-      uniform mat3 uPanZoomMatrix;
-      uniform int  uAtlasSize;
-      
-      // instanced
-      in vec2 aPosition; // a vertex from the unit square
-      
-      in mat3 aTransform; // used to transform verticies, eg into a bounding box
-      in int aVertType; // the type of thing we are rendering
-
-      // the z-index that is output when using picking mode
-      in vec4 aIndex;
-      
-      // For textures
-      in int aAtlasId; // which shader unit/atlas to use
-      in vec4 aTex; // x/y/w/h of texture in atlas
-
-      // for edges
-      in vec4 aPointAPointB;
-      in vec4 aPointCPointD;
-      in vec2 aLineWidth; // also used for node border width
-
-      // simple shapes
-      in vec4 aCornerRadius; // for round-rectangle [top-right, bottom-right, top-left, bottom-left]
-      in vec4 aColor; // also used for edges
-      in vec4 aBorderColor; // aLineWidth is used for border width
-
-      // output values passed to the fragment shader
-      out vec2 vTexCoord;
-      out vec4 vColor;
-      out vec2 vPosition;
-      // flat values are not interpolated
-      flat out int vAtlasId; 
-      flat out int vVertType;
-      flat out vec2 vTopRight;
-      flat out vec2 vBotLeft;
-      flat out vec4 vCornerRadius;
-      flat out vec4 vBorderColor;
-      flat out vec2 vBorderWidth;
-      flat out vec4 vIndex;
-      
-      void main(void) {
-        int vid = gl_VertexID;
-        vec2 position = aPosition; // TODO make this a vec3, simplifies some code below
-
-        if(aVertType == `.concat(To,`) {
-          float texX = aTex.x; // texture coordinates
-          float texY = aTex.y;
-          float texW = aTex.z;
-          float texH = aTex.w;
-
-          if(vid == 1 || vid == 2 || vid == 4) {
-            texX += texW;
-          }
-          if(vid == 2 || vid == 4 || vid == 5) {
-            texY += texH;
-          }
-
-          float d = float(uAtlasSize);
-          vTexCoord = vec2(texX / d, texY / d); // tex coords must be between 0 and 1
-
-          gl_Position = vec4(uPanZoomMatrix * aTransform * vec3(position, 1.0), 1.0);
-        }
-        else if(aVertType == `).concat(_t," || aVertType == ").concat(pa,` 
-             || aVertType == `).concat(on," || aVertType == ").concat(ga,`) { // simple shapes
-
-          // the bounding box is needed by the fragment shader
-          vBotLeft  = (aTransform * vec3(0, 0, 1)).xy; // flat
-          vTopRight = (aTransform * vec3(1, 1, 1)).xy; // flat
-          vPosition = (aTransform * vec3(position, 1)).xy; // will be interpolated
-
-          // calculations are done in the fragment shader, just pass these along
-          vColor = aColor;
-          vCornerRadius = aCornerRadius;
-          vBorderColor = aBorderColor;
-          vBorderWidth = aLineWidth;
-
-          gl_Position = vec4(uPanZoomMatrix * aTransform * vec3(position, 1.0), 1.0);
-        }
-        else if(aVertType == `).concat(Kl,`) {
-          vec2 source = aPointAPointB.xy;
-          vec2 target = aPointAPointB.zw;
-
-          // adjust the geometry so that the line is centered on the edge
-          position.y = position.y - 0.5;
-
-          // stretch the unit square into a long skinny rectangle
-          vec2 xBasis = target - source;
-          vec2 yBasis = normalize(vec2(-xBasis.y, xBasis.x));
-          vec2 point = source + xBasis * position.x + yBasis * aLineWidth[0] * position.y;
-
-          gl_Position = vec4(uPanZoomMatrix * vec3(point, 1.0), 1.0);
-          vColor = aColor;
-        } 
-        else if(aVertType == `).concat(Xl,`) {
-          vec2 pointA = aPointAPointB.xy;
-          vec2 pointB = aPointAPointB.zw;
-          vec2 pointC = aPointCPointD.xy;
-          vec2 pointD = aPointCPointD.zw;
-
-          // adjust the geometry so that the line is centered on the edge
-          position.y = position.y - 0.5;
-
-          vec2 p0, p1, p2, pos;
-          if(position.x == 0.0) { // The left side of the unit square
-            p0 = pointA;
-            p1 = pointB;
-            p2 = pointC;
-            pos = position;
-          } else { // The right side of the unit square, use same approach but flip the geometry upside down
-            p0 = pointD;
-            p1 = pointC;
-            p2 = pointB;
-            pos = vec2(0.0, -position.y);
-          }
-
-          vec2 p01 = p1 - p0;
-          vec2 p12 = p2 - p1;
-          vec2 p21 = p1 - p2;
-
-          // Find the normal vector.
-          vec2 tangent = normalize(normalize(p12) + normalize(p01));
-          vec2 normal = vec2(-tangent.y, tangent.x);
-
-          // Find the vector perpendicular to p0 -> p1.
-          vec2 p01Norm = normalize(vec2(-p01.y, p01.x));
-
-          // Determine the bend direction.
-          float sigma = sign(dot(p01 + p21, normal));
-          float width = aLineWidth[0];
-
-          if(sign(pos.y) == -sigma) {
-            // This is an intersecting vertex. Adjust the position so that there's no overlap.
-            vec2 point = 0.5 * width * normal * -sigma / dot(normal, p01Norm);
-            gl_Position = vec4(uPanZoomMatrix * vec3(p1 + point, 1.0), 1.0);
-          } else {
-            // This is a non-intersecting vertex. Treat it like a mitre join.
-            vec2 point = 0.5 * width * normal * sigma * dot(normal, p01Norm);
-            gl_Position = vec4(uPanZoomMatrix * vec3(p1 + point, 1.0), 1.0);
-          }
-
-          vColor = aColor;
-        } 
-        else if(aVertType == `).concat(So,` && vid < 3) {
-          // massage the first triangle into an edge arrow
-          if(vid == 0)
-            position = vec2(-0.15, -0.3);
-          if(vid == 1)
-            position = vec2(  0.0,  0.0);
-          if(vid == 2)
-            position = vec2( 0.15, -0.3);
-
-          gl_Position = vec4(uPanZoomMatrix * aTransform * vec3(position, 1.0), 1.0);
-          vColor = aColor;
-        }
-        else {
-          gl_Position = vec4(2.0, 0.0, 0.0, 1.0); // discard vertex by putting it outside webgl clip space
-        }
-
-        vAtlasId = aAtlasId;
-        vVertType = aVertType;
-        vIndex = aIndex;
-      }
-    `),i=this.batchManager.getIndexArray(),o=`#version 300 es
-      precision highp float;
-
-      // declare texture unit for each texture atlas in the batch
-      `.concat(i.map(function(u){return"uniform sampler2D uTexture".concat(u,";")}).join(`
-	`),`
-
-      uniform vec4 uBGColor;
-      uniform float uZoom;
-
-      in vec2 vTexCoord;
-      in vec4 vColor;
-      in vec2 vPosition; // model coordinates
-
-      flat in int vAtlasId;
-      flat in vec4 vIndex;
-      flat in int vVertType;
-      flat in vec2 vTopRight;
-      flat in vec2 vBotLeft;
-      flat in vec4 vCornerRadius;
-      flat in vec4 vBorderColor;
-      flat in vec2 vBorderWidth;
-
-      out vec4 outColor;
-
-      `).concat(sm,`
-      `).concat(um,`
-      `).concat(lm,`
-      `).concat(vm,`
-
-      vec4 blend(vec4 top, vec4 bot) { // blend colors with premultiplied alpha
-        return vec4( 
-          top.rgb + (bot.rgb * (1.0 - top.a)),
-          top.a   + (bot.a   * (1.0 - top.a)) 
-        );
-      }
-
-      vec4 distInterp(vec4 cA, vec4 cB, float d) { // interpolate color using Signed Distance
-        // scale to the zoom level so that borders don't look blurry when zoomed in
-        // note 1.5 is an aribitrary value chosen because it looks good
-        return mix(cA, cB, 1.0 - smoothstep(0.0, 1.5 / uZoom, abs(d))); 
-      }
-
-      void main(void) {
-        if(vVertType == `).concat(To,`) {
-          // look up the texel from the texture unit
-          `).concat(i.map(function(u){return"if(vAtlasId == ".concat(u,") outColor = texture(uTexture").concat(u,", vTexCoord);")}).join(`
-	else `),`
-        } 
-        else if(vVertType == `).concat(So,`) {
-          // mimics how canvas renderer uses context.globalCompositeOperation = 'destination-out';
-          outColor = blend(vColor, uBGColor);
-          outColor.a = 1.0; // make opaque, masks out line under arrow
-        }
-        else if(vVertType == `).concat(_t,` && vBorderWidth == vec2(0.0)) { // simple rectangle with no border
-          outColor = vColor; // unit square is already transformed to the rectangle, nothing else needs to be done
-        }
-        else if(vVertType == `).concat(_t," || vVertType == ").concat(pa,` 
-          || vVertType == `).concat(on," || vVertType == ").concat(ga,`) { // use SDF
-
-          float outerBorder = vBorderWidth[0];
-          float innerBorder = vBorderWidth[1];
-          float borderPadding = outerBorder * 2.0;
-          float w = vTopRight.x - vBotLeft.x - borderPadding;
-          float h = vTopRight.y - vBotLeft.y - borderPadding;
-          vec2 b = vec2(w/2.0, h/2.0); // half width, half height
-          vec2 p = vPosition - vec2(vTopRight.x - b[0] - outerBorder, vTopRight.y - b[1] - outerBorder); // translate to center
-
-          float d; // signed distance
-          if(vVertType == `).concat(_t,`) {
-            d = rectangleSD(p, b);
-          } else if(vVertType == `).concat(pa,` && w == h) {
-            d = circleSD(p, b.x); // faster than ellipse
-          } else if(vVertType == `).concat(pa,`) {
-            d = ellipseSD(p, b);
-          } else {
-            d = roundRectangleSD(p, b, vCornerRadius.wzyx);
-          }
-
-          // use the distance to interpolate a color to smooth the edges of the shape, doesn't need multisampling
-          // we must smooth colors inwards, because we can't change pixels outside the shape's bounding box
-          if(d > 0.0) {
-            if(d > outerBorder) {
-              discard;
-            } else {
-              outColor = distInterp(vBorderColor, vec4(0), d - outerBorder);
-            }
-          } else {
-            if(d > innerBorder) {
-              vec4 outerColor = outerBorder == 0.0 ? vec4(0) : vBorderColor;
-              vec4 innerBorderColor = blend(vBorderColor, vColor);
-              outColor = distInterp(innerBorderColor, outerColor, d);
-            } 
-            else {
-              vec4 outerColor;
-              if(innerBorder == 0.0 && outerBorder == 0.0) {
-                outerColor = vec4(0);
-              } else if(innerBorder == 0.0) {
-                outerColor = vBorderColor;
-              } else {
-                outerColor = blend(vBorderColor, vColor);
-              }
-              outColor = distInterp(vColor, outerColor, d - innerBorder);
-            }
-          }
-        }
-        else {
-          outColor = vColor;
-        }
-
-        `).concat(t.picking?`if(outColor.a == 0.0) discard;
-             else outColor = vIndex;`:"",`
-      }
-    `),s=Gy(a,n,o);s.aPosition=a.getAttribLocation(s,"aPosition"),s.aIndex=a.getAttribLocation(s,"aIndex"),s.aVertType=a.getAttribLocation(s,"aVertType"),s.aTransform=a.getAttribLocation(s,"aTransform"),s.aAtlasId=a.getAttribLocation(s,"aAtlasId"),s.aTex=a.getAttribLocation(s,"aTex"),s.aPointAPointB=a.getAttribLocation(s,"aPointAPointB"),s.aPointCPointD=a.getAttribLocation(s,"aPointCPointD"),s.aLineWidth=a.getAttribLocation(s,"aLineWidth"),s.aColor=a.getAttribLocation(s,"aColor"),s.aCornerRadius=a.getAttribLocation(s,"aCornerRadius"),s.aBorderColor=a.getAttribLocation(s,"aBorderColor"),s.uPanZoomMatrix=a.getUniformLocation(s,"uPanZoomMatrix"),s.uAtlasSize=a.getUniformLocation(s,"uAtlasSize"),s.uBGColor=a.getUniformLocation(s,"uBGColor"),s.uZoom=a.getUniformLocation(s,"uZoom"),s.uTextures=[];for(var l=0;l<this.batchManager.getMaxAtlasesPerBatch();l++)s.uTextures.push(a.getUniformLocation(s,"uTexture".concat(l)));return s}},{key:"_createVAO",value:function(){var t=[0,0,1,0,1,1,0,0,1,1,0,1];this.vertexCount=t.length/2;var a=this.maxInstances,n=this.gl,i=this.program,o=n.createVertexArray();return n.bindVertexArray(o),Qy(n,"vec2",i.aPosition,t),this.transformBuffer=Jy(n,a,i.aTransform),this.indexBuffer=Fr(n,a,"vec4",i.aIndex),this.vertTypeBuffer=Fr(n,a,"int",i.aVertType),this.atlasIdBuffer=Fr(n,a,"int",i.aAtlasId),this.texBuffer=Fr(n,a,"vec4",i.aTex),this.pointAPointBBuffer=Fr(n,a,"vec4",i.aPointAPointB),this.pointCPointDBuffer=Fr(n,a,"vec4",i.aPointCPointD),this.lineWidthBuffer=Fr(n,a,"vec2",i.aLineWidth),this.colorBuffer=Fr(n,a,"vec4",i.aColor),this.cornerRadiusBuffer=Fr(n,a,"vec4",i.aCornerRadius),this.borderColorBuffer=Fr(n,a,"vec4",i.aBorderColor),n.bindVertexArray(null),o}},{key:"buffers",get:function(){var t=this;return this._buffers||(this._buffers=Object.keys(this).filter(function(a){return at(a,"Buffer")}).map(function(a){return t[a]})),this._buffers}},{key:"startFrame",value:function(t){var a=arguments.length>1&&arguments[1]!==void 0?arguments[1]:Ea.SCREEN;this.panZoomMatrix=t,this.renderTarget=a,this.batchDebugInfo=[],this.wrappedCount=0,this.simpleCount=0,this.startBatch()}},{key:"startBatch",value:function(){this.instanceCount=0,this.batchManager.startBatch()}},{key:"endFrame",value:function(){this.endBatch()}},{key:"_isVisible",value:function(t,a){return t.visible()?a&&a.isVisible?a.isVisible(t):!0:!1}},{key:"drawTexture",value:function(t,a,n){var i=this.atlasManager,o=this.batchManager,s=i.getRenderTypeOpts(n);if(this._isVisible(t,s)&&!(t.isEdge()&&!this._isValidEdge(t))){if(this.renderTarget.picking&&s.getTexPickingMode){var l=s.getTexPickingMode(t);if(l===An.IGNORE)return;if(l==An.USE_BB){this.drawPickingRectangle(t,a,n);return}}var u=i.getAtlasInfo(t,n),v=kr(u),f;try{for(v.s();!(f=v.n()).done;){var c=f.value,d=c.atlas,h=c.tex1,y=c.tex2;o.canAddToCurrentBatch(d)||this.endBatch();for(var g=o.getAtlasIndexForBatch(d),p=0,m=[[h,!0],[y,!1]];p<m.length;p++){var b=Je(m[p],2),w=b[0],E=b[1];if(w.w!=0){var C=this.instanceCount;this.vertTypeBuffer.getView(C)[0]=To;var x=this.indexBuffer.getView(C);qt(a,x);var T=this.atlasIdBuffer.getView(C);T[0]=g;var k=this.texBuffer.getView(C);k[0]=w.x,k[1]=w.y,k[2]=w.w,k[3]=w.h;var D=this.transformBuffer.getMatrixView(C);this.setTransformMatrix(t,D,s,c,E),this.instanceCount++,E||this.wrappedCount++,this.instanceCount>=this.maxInstances&&this.endBatch()}}}}catch(B){v.e(B)}finally{v.f()}}}},{key:"setTransformMatrix",value:function(t,a,n,i){var o=arguments.length>4&&arguments[4]!==void 0?arguments[4]:!0,s=0;if(n.shapeProps&&n.shapeProps.padding&&(s=t.pstyle(n.shapeProps.padding).pfValue),i){var l=i.bb,u=i.tex1,v=i.tex2,f=u.w/(u.w+v.w);o||(f=1-f);var c=this._getAdjustedBB(l,s,o,f);this._applyTransformMatrix(a,c,n,t)}else{var d=n.getBoundingBox(t),h=this._getAdjustedBB(d,s,!0,1);this._applyTransformMatrix(a,h,n,t)}}},{key:"_applyTransformMatrix",value:function(t,a,n,i){var o,s;$l(t);var l=n.getRotation?n.getRotation(i):0;if(l!==0){var u=n.getRotationPoint(i),v=u.x,f=u.y;yn(t,t,[v,f]),Ul(t,t,l);var c=n.getRotationOffset(i);o=c.x+(a.xOffset||0),s=c.y+(a.yOffset||0)}else o=a.x1,s=a.y1;yn(t,t,[o,s]),$o(t,t,[a.w,a.h])}},{key:"_getAdjustedBB",value:function(t,a,n,i){var o=t.x1,s=t.y1,l=t.w,u=t.h,v=t.yOffset;a&&(o-=a,s-=a,l+=2*a,u+=2*a);var f=0,c=l*i;return n&&i<1?l=c:!n&&i<1&&(f=l-c,o+=f,l=c),{x1:o,y1:s,w:l,h:u,xOffset:f,yOffset:v}}},{key:"drawPickingRectangle",value:function(t,a,n){var i=this.atlasManager.getRenderTypeOpts(n),o=this.instanceCount;this.vertTypeBuffer.getView(o)[0]=_t;var s=this.indexBuffer.getView(o);qt(a,s);var l=this.colorBuffer.getView(o);xt([0,0,0],1,l);var u=this.transformBuffer.getMatrixView(o);this.setTransformMatrix(t,u,i),this.simpleCount++,this.instanceCount++,this.instanceCount>=this.maxInstances&&this.endBatch()}},{key:"drawNode",value:function(t,a,n){var i=this.simpleShapeOptions.get(n);if(this._isVisible(t,i)){var o=i.shapeProps,s=this._getVertTypeForShape(t,o.shape);if(s===void 0||i.isSimple&&!i.isSimple(t)){this.drawTexture(t,a,n);return}var l=this.instanceCount;if(this.vertTypeBuffer.getView(l)[0]=s,s===on||s===ga){var u=i.getBoundingBox(t),v=this._getCornerRadius(t,o.radius,u),f=this.cornerRadiusBuffer.getView(l);f[0]=v,f[1]=v,f[2]=v,f[3]=v,s===ga&&(f[0]=0,f[2]=0)}var c=this.indexBuffer.getView(l);qt(a,c);var d=t.pstyle(o.color).value,h=t.pstyle(o.opacity).value,y=this.colorBuffer.getView(l);xt(d,h,y);var g=this.lineWidthBuffer.getView(l);if(g[0]=0,g[1]=0,o.border){var p=t.pstyle("border-width").value;if(p>0){var m=t.pstyle("border-color").value,b=t.pstyle("border-opacity").value,w=this.borderColorBuffer.getView(l);xt(m,b,w);var E=t.pstyle("border-position").value;if(E==="inside")g[0]=0,g[1]=-p;else if(E==="outside")g[0]=p,g[1]=0;else{var C=p/2;g[0]=C,g[1]=-C}}}var x=this.transformBuffer.getMatrixView(l);this.setTransformMatrix(t,x,i),this.simpleCount++,this.instanceCount++,this.instanceCount>=this.maxInstances&&this.endBatch()}}},{key:"_getVertTypeForShape",value:function(t,a){var n=t.pstyle(a).value;switch(n){case"rectangle":return _t;case"ellipse":return pa;case"roundrectangle":case"round-rectangle":return on;case"bottom-round-rectangle":return ga;default:return}}},{key:"_getCornerRadius",value:function(t,a,n){var i=n.w,o=n.h;if(t.pstyle(a).value==="auto")return vt(i,o);var s=t.pstyle(a).pfValue,l=i/2,u=o/2;return Math.min(s,u,l)}},{key:"drawEdgeArrow",value:function(t,a,n){if(t.visible()){var i=t._private.rscratch,o,s,l;if(n==="source"?(o=i.arrowStartX,s=i.arrowStartY,l=i.srcArrowAngle):(o=i.arrowEndX,s=i.arrowEndY,l=i.tgtArrowAngle),!(isNaN(o)||o==null||isNaN(s)||s==null||isNaN(l)||l==null)){var u=t.pstyle(n+"-arrow-shape").value;if(u!=="none"){var v=t.pstyle(n+"-arrow-color").value,f=t.pstyle("opacity").value,c=t.pstyle("line-opacity").value,d=f*c,h=t.pstyle("width").pfValue,y=t.pstyle("arrow-scale").value,g=this.r.getArrowWidth(h,y),p=this.instanceCount,m=this.transformBuffer.getMatrixView(p);$l(m),yn(m,m,[o,s]),$o(m,m,[g,g]),Ul(m,m,l),this.vertTypeBuffer.getView(p)[0]=So;var b=this.indexBuffer.getView(p);qt(a,b);var w=this.colorBuffer.getView(p);xt(v,d,w),this.instanceCount++,this.instanceCount>=this.maxInstances&&this.endBatch()}}}}},{key:"drawEdgeLine",value:function(t,a){if(t.visible()){var n=this._getEdgePoints(t);if(n){var i=t.pstyle("opacity").value,o=t.pstyle("line-opacity").value,s=t.pstyle("width").pfValue,l=t.pstyle("line-color").value,u=i*o;if(n.length/2+this.instanceCount>this.maxInstances&&this.endBatch(),n.length==4){var v=this.instanceCount;this.vertTypeBuffer.getView(v)[0]=Kl;var f=this.indexBuffer.getView(v);qt(a,f);var c=this.colorBuffer.getView(v);xt(l,u,c);var d=this.lineWidthBuffer.getView(v);d[0]=s;var h=this.pointAPointBBuffer.getView(v);h[0]=n[0],h[1]=n[1],h[2]=n[2],h[3]=n[3],this.instanceCount++,this.instanceCount>=this.maxInstances&&this.endBatch()}else for(var y=0;y<n.length-2;y+=2){var g=this.instanceCount;this.vertTypeBuffer.getView(g)[0]=Xl;var p=this.indexBuffer.getView(g);qt(a,p);var m=this.colorBuffer.getView(g);xt(l,u,m);var b=this.lineWidthBuffer.getView(g);b[0]=s;var w=n[y-2],E=n[y-1],C=n[y],x=n[y+1],T=n[y+2],k=n[y+3],D=n[y+4],B=n[y+5];y==0&&(w=2*C-T+.001,E=2*x-k+.001),y==n.length-4&&(D=2*T-C+.001,B=2*k-x+.001);var P=this.pointAPointBBuffer.getView(g);P[0]=w,P[1]=E,P[2]=C,P[3]=x;var A=this.pointCPointDBuffer.getView(g);A[0]=T,A[1]=k,A[2]=D,A[3]=B,this.instanceCount++,this.instanceCount>=this.maxInstances&&this.endBatch()}}}}},{key:"_isValidEdge",value:function(t){var a=t._private.rscratch;return!(a.badLine||a.allpts==null||isNaN(a.allpts[0]))}},{key:"_getEdgePoints",value:function(t){var a=t._private.rscratch;if(this._isValidEdge(t)){var n=a.allpts;if(n.length==4)return n;var i=this._getNumSegments(t);return this._getCurveSegmentPoints(n,i)}}},{key:"_getNumSegments",value:function(t){var a=15;return Math.min(Math.max(a,5),this.maxInstances)}},{key:"_getCurveSegmentPoints",value:function(t,a){if(t.length==4)return t;for(var n=Array((a+1)*2),i=0;i<=a;i++)if(i==0)n[0]=t[0],n[1]=t[1];else if(i==a)n[i*2]=t[t.length-2],n[i*2+1]=t[t.length-1];else{var o=i/a;this._setCurvePoint(t,o,n,i*2)}return n}},{key:"_setCurvePoint",value:function(t,a,n,i){if(t.length<=2)n[i]=t[0],n[i+1]=t[1];else{for(var o=Array(t.length-2),s=0;s<o.length;s+=2){var l=(1-a)*t[s]+a*t[s+2],u=(1-a)*t[s+1]+a*t[s+3];o[s]=l,o[s+1]=u}return this._setCurvePoint(o,a,n,i)}}},{key:"endBatch",value:function(){var t=this.gl,a=this.vao,n=this.vertexCount,i=this.instanceCount;if(i!==0){var o=this.renderTarget.picking?this.pickingProgram:this.program;t.useProgram(o),t.bindVertexArray(a);var s=kr(this.buffers),l;try{for(s.s();!(l=s.n()).done;){var u=l.value;u.bufferSubData(i)}}catch(h){s.e(h)}finally{s.f()}for(var v=this.batchManager.getAtlases(),f=0;f<v.length;f++)v[f].bufferIfNeeded(t);for(var c=0;c<v.length;c++)t.activeTexture(t.TEXTURE0+c),t.bindTexture(t.TEXTURE_2D,v[c].texture),t.uniform1i(o.uTextures[c],c);t.uniform1f(o.uZoom,Wy(this.r)),t.uniformMatrix3fv(o.uPanZoomMatrix,!1,this.panZoomMatrix),t.uniform1i(o.uAtlasSize,this.batchManager.getAtlasSize());var d=xt(this.bgColor,1);t.uniform4fv(o.uBGColor,d),t.drawArraysInstanced(t.TRIANGLES,0,n,i),t.bindVertexArray(null),t.bindTexture(t.TEXTURE_2D,null),this.debug&&this.batchDebugInfo.push({count:i,atlasCount:v.length}),this.startBatch()}}},{key:"getDebugInfo",value:function(){var t=this.atlasManager.getDebugInfo(),a=t.reduce(function(o,s){return o+s.atlasCount},0),n=this.batchDebugInfo,i=n.reduce(function(o,s){return o+s.count},0);return{atlasInfo:t,totalAtlases:a,wrappedCount:this.wrappedCount,simpleCount:this.simpleCount,batchCount:n.length,batchInfo:n,totalInstances:i}}}])})(),Mf={};Mf.initWebgl=function(r,e){var t=this,a=t.data.contexts[t.WEBGL];r.bgColor=cm(t),r.webglTexSize=Math.min(r.webglTexSize,a.getParameter(a.MAX_TEXTURE_SIZE)),r.webglTexRows=Math.min(r.webglTexRows,54),r.webglTexRowsNodes=Math.min(r.webglTexRowsNodes,54),r.webglBatchSize=Math.min(r.webglBatchSize,16384),r.webglTexPerBatch=Math.min(r.webglTexPerBatch,a.getParameter(a.MAX_TEXTURE_IMAGE_UNITS)),t.webglDebug=r.webglDebug,t.webglDebugShowAtlases=r.webglDebugShowAtlases,t.pickingFrameBuffer=jy(a),t.pickingFrameBuffer.needsDraw=!0,t.drawing=new fm(t,a,r);var n=function(f){return function(c){return t.getTextAngle(c,f)}},i=function(f){return function(c){var d=c.pstyle(f);return d&&d.value}},o=function(f){return function(c){return c.pstyle("".concat(f,"-opacity")).value>0}},s=function(f){var c=f.pstyle("text-events").strValue==="yes";return c?An.USE_BB:An.IGNORE},l=function(f){var c=f.position(),d=c.x,h=c.y,y=f.outerWidth(),g=f.outerHeight();return{w:y,h:g,x1:d-y/2,y1:h-g/2}};t.drawing.addAtlasCollection("node",{texRows:r.webglTexRowsNodes}),t.drawing.addAtlasCollection("label",{texRows:r.webglTexRows}),t.drawing.addTextureAtlasRenderType("node-body",{collection:"node",getKey:e.getStyleKey,getBoundingBox:e.getElementBox,drawElement:e.drawElement}),t.drawing.addSimpleShapeRenderType("node-body",{getBoundingBox:l,isSimple:Uy,shapeProps:{shape:"shape",color:"background-color",opacity:"background-opacity",radius:"corner-radius",border:!0}}),t.drawing.addSimpleShapeRenderType("node-overlay",{getBoundingBox:l,isVisible:o("overlay"),shapeProps:{shape:"overlay-shape",color:"overlay-color",opacity:"overlay-opacity",padding:"overlay-padding",radius:"overlay-corner-radius"}}),t.drawing.addSimpleShapeRenderType("node-underlay",{getBoundingBox:l,isVisible:o("underlay"),shapeProps:{shape:"underlay-shape",color:"underlay-color",opacity:"underlay-opacity",padding:"underlay-padding",radius:"underlay-corner-radius"}}),t.drawing.addTextureAtlasRenderType("label",{collection:"label",getTexPickingMode:s,getKey:ko(e.getLabelKey,null),getBoundingBox:Do(e.getLabelBox,null),drawClipped:!0,drawElement:e.drawLabel,getRotation:n(null),getRotationPoint:e.getLabelRotationPoint,getRotationOffset:e.getLabelRotationOffset,isVisible:i("label")}),t.drawing.addTextureAtlasRenderType("edge-source-label",{collection:"label",getTexPickingMode:s,getKey:ko(e.getSourceLabelKey,"source"),getBoundingBox:Do(e.getSourceLabelBox,"source"),drawClipped:!0,drawElement:e.drawSourceLabel,getRotation:n("source"),getRotationPoint:e.getSourceLabelRotationPoint,getRotationOffset:e.getSourceLabelRotationOffset,isVisible:i("source-label")}),t.drawing.addTextureAtlasRenderType("edge-target-label",{collection:"label",getTexPickingMode:s,getKey:ko(e.getTargetLabelKey,"target"),getBoundingBox:Do(e.getTargetLabelBox,"target"),drawClipped:!0,drawElement:e.drawTargetLabel,getRotation:n("target"),getRotationPoint:e.getTargetLabelRotationPoint,getRotationOffset:e.getTargetLabelRotationOffset,isVisible:i("target-label")});var u=Fa(function(){console.log("garbage collect flag set"),t.data.gc=!0},1e4);t.onUpdateEleCalcs(function(v,f){var c=!1;f&&f.length>0&&(c|=t.drawing.invalidate(f)),c&&u()}),hm(t)};function cm(r){var e=r.cy.container(),t=e&&e.style&&e.style.backgroundColor||"white";return iv(t)}function Lf(r,e){var t=r._private.rscratch;return Tr(t,"labelWrapCachedLines",e)||[]}var ko=function(e,t){return function(a){var n=e(a),i=Lf(a,t);return i.length>1?i.map(function(o,s){return"".concat(n,"_").concat(s)}):n}},Do=function(e,t){return function(a,n){var i=e(a);if(typeof n=="string"){var o=n.indexOf("_");if(o>0){var s=Number(n.substring(o+1)),l=Lf(a,t),u=i.h/l.length,v=u*s,f=i.y1+v;return{x1:i.x1,w:i.w,y1:f,h:u,yOffset:v}}}return i}};function hm(r){{var e=r.render;r.render=function(i){i=i||{};var o=r.cy;r.webgl&&(o.zoom()>Sf?(dm(r),e.call(r,i)):(gm(r),Of(r,i,Ea.SCREEN)))}}{var t=r.matchCanvasSize;r.matchCanvasSize=function(i){t.call(r,i),r.pickingFrameBuffer.setFramebufferAttachmentSizes(r.canvasWidth,r.canvasHeight),r.pickingFrameBuffer.needsDraw=!0}}r.findNearestElements=function(i,o,s,l){return xm(r,i,o)};{var a=r.invalidateCachedZSortedEles;r.invalidateCachedZSortedEles=function(){a.call(r),r.pickingFrameBuffer.needsDraw=!0}}{var n=r.notify;r.notify=function(i,o){n.call(r,i,o),i==="viewport"||i==="bounds"?r.pickingFrameBuffer.needsDraw=!0:i==="background"&&r.drawing.invalidate(o,{type:"node-body"})}}}function dm(r){var e=r.data.contexts[r.WEBGL];e.clear(e.COLOR_BUFFER_BIT|e.DEPTH_BUFFER_BIT)}function gm(r){var e=function(a){a.save(),a.setTransform(1,0,0,1,0,0),a.clearRect(0,0,r.canvasWidth,r.canvasHeight),a.restore()};e(r.data.contexts[r.NODE]),e(r.data.contexts[r.DRAG])}function pm(r){var e=r.canvasWidth,t=r.canvasHeight,a=bs(r),n=a.pan,i=a.zoom,o=Co();yn(o,o,[n.x,n.y]),$o(o,o,[i,i]);var s=Co();rm(s,e,t);var l=Co();return em(l,s,o),l}function If(r,e){var t=r.canvasWidth,a=r.canvasHeight,n=bs(r),i=n.pan,o=n.zoom;e.setTransform(1,0,0,1,0,0),e.clearRect(0,0,t,a),e.translate(i.x,i.y),e.scale(o,o)}function ym(r,e){r.drawSelectionRectangle(e,function(t){return If(r,t)})}function mm(r){var e=r.data.contexts[r.NODE];e.save(),If(r,e),e.strokeStyle="rgba(0, 0, 0, 0.3)",e.beginPath(),e.moveTo(-1e3,0),e.lineTo(1e3,0),e.stroke(),e.beginPath(),e.moveTo(0,-1e3),e.lineTo(0,1e3),e.stroke(),e.restore()}function bm(r){var e=function(n,i,o){for(var s=n.atlasManager.getAtlasCollection(i),l=r.data.contexts[r.NODE],u=s.atlases,v=0;v<u.length;v++){var f=u[v],c=f.canvas;if(c){var d=c.width,h=c.height,y=d*v,g=c.height*o,p=.4;l.save(),l.scale(p,p),l.drawImage(c,y,g),l.strokeStyle="black",l.rect(y,g,d,h),l.stroke(),l.restore()}}},t=0;e(r.drawing,"node",t++),e(r.drawing,"label",t++)}function wm(r,e,t,a,n){var i,o,s,l,u=bs(r),v=u.pan,f=u.zoom;{var c=$y(r,v,f,e,t),d=Je(c,2),h=d[0],y=d[1],g=6;i=h-g/2,o=y-g/2,s=g,l=g}if(s===0||l===0)return[];var p=r.data.contexts[r.WEBGL];p.bindFramebuffer(p.FRAMEBUFFER,r.pickingFrameBuffer),r.pickingFrameBuffer.needsDraw&&(p.viewport(0,0,p.canvas.width,p.canvas.height),Of(r,null,Ea.PICKING),r.pickingFrameBuffer.needsDraw=!1);var m=s*l,b=new Uint8Array(m*4);p.readPixels(i,o,s,l,p.RGBA,p.UNSIGNED_BYTE,b),p.bindFramebuffer(p.FRAMEBUFFER,null);for(var w=new Set,E=0;E<m;E++){var C=b.slice(E*4,E*4+4),x=Xy(C)-1;x>=0&&w.add(x)}return w}function xm(r,e,t){var a=wm(r,e,t),n=r.getCachedZSortedEles(),i,o,s=kr(a),l;try{for(s.s();!(l=s.n()).done;){var u=l.value,v=n[u];if(!i&&v.isNode()&&(i=v),!o&&v.isEdge()&&(o=v),i&&o)break}}catch(f){s.e(f)}finally{s.f()}return[i,o].filter(Boolean)}function Bo(r,e,t){var a=r.drawing;e+=1,t.isNode()?(a.drawNode(t,e,"node-underlay"),a.drawNode(t,e,"node-body"),a.drawTexture(t,e,"label"),a.drawNode(t,e,"node-overlay")):(a.drawEdgeLine(t,e),a.drawEdgeArrow(t,e,"source"),a.drawEdgeArrow(t,e,"target"),a.drawTexture(t,e,"label"),a.drawTexture(t,e,"edge-source-label"),a.drawTexture(t,e,"edge-target-label"))}function Of(r,e,t){var a;r.webglDebug&&(a=performance.now());var n=r.drawing,i=0;if(t.screen&&r.data.canvasNeedsRedraw[r.SELECT_BOX]&&ym(r,e),r.data.canvasNeedsRedraw[r.NODE]||t.picking){var o=r.data.contexts[r.WEBGL];t.screen?(o.clearColor(0,0,0,0),o.enable(o.BLEND),o.blendFunc(o.ONE,o.ONE_MINUS_SRC_ALPHA)):o.disable(o.BLEND),o.clear(o.COLOR_BUFFER_BIT|o.DEPTH_BUFFER_BIT),o.viewport(0,0,o.canvas.width,o.canvas.height);var s=pm(r),l=r.getCachedZSortedEles();if(i=l.length,n.startFrame(s,t),t.screen){for(var u=0;u<l.nondrag.length;u++)Bo(r,u,l.nondrag[u]);for(var v=0;v<l.drag.length;v++)Bo(r,v,l.drag[v])}else if(t.picking)for(var f=0;f<l.length;f++)Bo(r,f,l[f]);n.endFrame(),t.screen&&r.webglDebugShowAtlases&&(mm(r),bm(r)),r.data.canvasNeedsRedraw[r.NODE]=!1,r.data.canvasNeedsRedraw[r.DRAG]=!1}if(r.webglDebug){var c=performance.now(),d=!1,h=Math.ceil(c-a),y=n.getDebugInfo(),g=["".concat(i," elements"),"".concat(y.totalInstances," instances"),"".concat(y.batchCount," batches"),"".concat(y.totalAtlases," atlases"),"".concat(y.wrappedCount," wrapped textures"),"".concat(y.simpleCount," simple shapes")].join(", ");if(d)console.log("WebGL (".concat(t.name,") - time ").concat(h,"ms, ").concat(g));else{console.log("WebGL (".concat(t.name,") - frame time ").concat(h,"ms")),console.log("Totals:"),console.log("  ".concat(g)),console.log("Texture Atlases Used:");var p=y.atlasInfo,m=kr(p),b;try{for(m.s();!(b=m.n()).done;){var w=b.value;console.log("  ".concat(w.type,": ").concat(w.keyCount," keys, ").concat(w.atlasCount," atlases"))}}catch(E){m.e(E)}finally{m.f()}console.log("")}}r.data.gc&&(console.log("Garbage Collect!"),r.data.gc=!1,n.gc())}var mt={};mt.drawPolygonPath=function(r,e,t,a,n,i){var o=a/2,s=n/2;r.beginPath&&r.beginPath(),r.moveTo(e+o*i[0],t+s*i[1]);for(var l=1;l<i.length/2;l++)r.lineTo(e+o*i[l*2],t+s*i[l*2+1]);r.closePath()};mt.drawRoundPolygonPath=function(r,e,t,a,n,i,o){o.forEach(function(s){return pf(r,s)}),r.closePath()};mt.drawRoundRectanglePath=function(r,e,t,a,n,i){var o=a/2,s=n/2,l=i==="auto"?vt(a,n):Math.min(i,s,o);r.beginPath&&r.beginPath(),r.moveTo(e,t-s),r.arcTo(e+o,t-s,e+o,t,l),r.arcTo(e+o,t+s,e,t+s,l),r.arcTo(e-o,t+s,e-o,t,l),r.arcTo(e-o,t-s,e,t-s,l),r.lineTo(e,t-s),r.closePath()};mt.drawBottomRoundRectanglePath=function(r,e,t,a,n,i){var o=a/2,s=n/2,l=i==="auto"?vt(a,n):i;r.beginPath&&r.beginPath(),r.moveTo(e,t-s),r.lineTo(e+o,t-s),r.lineTo(e+o,t),r.arcTo(e+o,t+s,e,t+s,l),r.arcTo(e-o,t+s,e-o,t,l),r.lineTo(e-o,t-s),r.lineTo(e,t-s),r.closePath()};mt.drawCutRectanglePath=function(r,e,t,a,n,i,o){var s=a/2,l=n/2,u=o==="auto"?is():o;r.beginPath&&r.beginPath(),r.moveTo(e-s+u,t-l),r.lineTo(e+s-u,t-l),r.lineTo(e+s,t-l+u),r.lineTo(e+s,t+l-u),r.lineTo(e+s-u,t+l),r.lineTo(e-s+u,t+l),r.lineTo(e-s,t+l-u),r.lineTo(e-s,t-l+u),r.closePath()};mt.drawBarrelPath=function(r,e,t,a,n){var i=a/2,o=n/2,s=e-i,l=e+i,u=t-o,v=t+o,f=Ro(a,n),c=f.widthOffset,d=f.heightOffset,h=f.ctrlPtOffsetPct*c;r.beginPath&&r.beginPath(),r.moveTo(s,u+d),r.lineTo(s,v-d),r.quadraticCurveTo(s+h,v,s+c,v),r.lineTo(l-c,v),r.quadraticCurveTo(l-h,v,l,v-d),r.lineTo(l,u+d),r.quadraticCurveTo(l-h,u,l-c,u),r.lineTo(s+c,u),r.quadraticCurveTo(s+h,u,s,u+d),r.closePath()};var Yl=Math.sin(0),Zl=Math.cos(0),Uo={},Ko={},Nf=Math.PI/40;for(var Gt=0*Math.PI;Gt<2*Math.PI;Gt+=Nf)Uo[Gt]=Math.sin(Gt),Ko[Gt]=Math.cos(Gt);mt.drawEllipsePath=function(r,e,t,a,n){if(r.beginPath&&r.beginPath(),r.ellipse)r.ellipse(e,t,a/2,n/2,0,0,2*Math.PI);else for(var i,o,s=a/2,l=n/2,u=0*Math.PI;u<2*Math.PI;u+=Nf)i=e-s*Uo[u]*Yl+s*Ko[u]*Zl,o=t+l*Ko[u]*Yl+l*Uo[u]*Zl,u===0?r.moveTo(i,o):r.lineTo(i,o);r.closePath()};var Wa={};Wa.createBuffer=function(r,e){var t=document.createElement("canvas");return t.width=r,t.height=e,[t,t.getContext("2d")]};Wa.bufferCanvasImage=function(r){var e=this.cy,t=e.mutableElements(),a=t.boundingBox(),n=this.findContainerClientCoords(),i=r.full?Math.ceil(a.w):n[2],o=r.full?Math.ceil(a.h):n[3],s=ae(r.maxWidth)||ae(r.maxHeight),l=this.getPixelRatio(),u=1;if(r.scale!==void 0)i*=r.scale,o*=r.scale,u=r.scale;else if(s){var v=1/0,f=1/0;ae(r.maxWidth)&&(v=u*r.maxWidth/i),ae(r.maxHeight)&&(f=u*r.maxHeight/o),u=Math.min(v,f),i*=u,o*=u}s||(i*=l,o*=l,u*=l);var c=document.createElement("canvas");c.width=i,c.height=o,c.style.width=i+"px",c.style.height=o+"px";var d=c.getContext("2d");if(i>0&&o>0){d.clearRect(0,0,i,o),d.globalCompositeOperation="source-over";var h=this.getCachedZSortedEles();if(r.full)d.translate(-a.x1*u,-a.y1*u),d.scale(u,u),this.drawElements(d,h),d.scale(1/u,1/u),d.translate(a.x1*u,a.y1*u);else{var y=e.pan(),g={x:y.x*u,y:y.y*u};u*=e.zoom(),d.translate(g.x,g.y),d.scale(u,u),this.drawElements(d,h),d.scale(1/u,1/u),d.translate(-g.x,-g.y)}r.bg&&(d.globalCompositeOperation="destination-over",d.fillStyle=r.bg,d.rect(0,0,i,o),d.fill())}return c};function Em(r,e){for(var t=atob(r),a=new ArrayBuffer(t.length),n=new Uint8Array(a),i=0;i<t.length;i++)n[i]=t.charCodeAt(i);return new Blob([a],{type:e})}function Ql(r){var e=r.indexOf(",");return r.substr(e+1)}function zf(r,e,t){var a=function(){return e.toDataURL(t,r.quality)};switch(r.output){case"blob-promise":return new ta(function(n,i){try{e.toBlob(function(o){o!=null?n(o):i(new Error("`canvas.toBlob()` sent a null value in its callback"))},t,r.quality)}catch(o){i(o)}});case"blob":return Em(Ql(a()),t);case"base64":return Ql(a());case"base64uri":default:return a()}}Wa.png=function(r){return zf(r,this.bufferCanvasImage(r),"image/png")};Wa.jpg=function(r){return zf(r,this.bufferCanvasImage(r),"image/jpeg")};var Ff={};Ff.nodeShapeImpl=function(r,e,t,a,n,i,o,s){switch(r){case"ellipse":return this.drawEllipsePath(e,t,a,n,i);case"polygon":return this.drawPolygonPath(e,t,a,n,i,o);case"round-polygon":return this.drawRoundPolygonPath(e,t,a,n,i,o,s);case"roundrectangle":case"round-rectangle":return this.drawRoundRectanglePath(e,t,a,n,i,s);case"cutrectangle":case"cut-rectangle":return this.drawCutRectanglePath(e,t,a,n,i,o,s);case"bottomroundrectangle":case"bottom-round-rectangle":return this.drawBottomRoundRectanglePath(e,t,a,n,i,s);case"barrel":return this.drawBarrelPath(e,t,a,n,i)}};var Cm=Vf,ke=Vf.prototype;ke.CANVAS_LAYERS=3;ke.SELECT_BOX=0;ke.DRAG=1;ke.NODE=2;ke.WEBGL=3;ke.CANVAS_TYPES=["2d","2d","2d","webgl2"];ke.BUFFER_COUNT=3;ke.TEXTURE_BUFFER=0;ke.MOTIONBLUR_BUFFER_NODE=1;ke.MOTIONBLUR_BUFFER_DRAG=2;function Vf(r){var e=this,t=e.cy.window(),a=t.document;r.webgl&&(ke.CANVAS_LAYERS=e.CANVAS_LAYERS=4,console.log("webgl rendering enabled")),e.data={canvases:new Array(ke.CANVAS_LAYERS),contexts:new Array(ke.CANVAS_LAYERS),canvasNeedsRedraw:new Array(ke.CANVAS_LAYERS),bufferCanvases:new Array(ke.BUFFER_COUNT),bufferContexts:new Array(ke.CANVAS_LAYERS)};var n="-webkit-tap-highlight-color",i="rgba(0,0,0,0)";e.data.canvasContainer=a.createElement("div");var o=e.data.canvasContainer.style;e.data.canvasContainer.style[n]=i,o.position="relative",o.zIndex="0",o.overflow="hidden";var s=r.cy.container();s.appendChild(e.data.canvasContainer),s.style[n]=i;var l={"-webkit-user-select":"none","-moz-user-select":"-moz-none","user-select":"none","-webkit-tap-highlight-color":"rgba(0,0,0,0)","outline-style":"none"};yc()&&(l["-ms-touch-action"]="none",l["touch-action"]="none");for(var u=0;u<ke.CANVAS_LAYERS;u++){var v=e.data.canvases[u]=a.createElement("canvas"),f=ke.CANVAS_TYPES[u];e.data.contexts[u]=v.getContext(f),e.data.contexts[u]||$e("Could not create canvas of type "+f),Object.keys(l).forEach(function(J){v.style[J]=l[J]}),v.style.position="absolute",v.setAttribute("data-id","layer"+u),v.style.zIndex=String(ke.CANVAS_LAYERS-u),e.data.canvasContainer.appendChild(v),e.data.canvasNeedsRedraw[u]=!1}e.data.topCanvas=e.data.canvases[0],e.data.canvases[ke.NODE].setAttribute("data-id","layer"+ke.NODE+"-node"),e.data.canvases[ke.SELECT_BOX].setAttribute("data-id","layer"+ke.SELECT_BOX+"-selectbox"),e.data.canvases[ke.DRAG].setAttribute("data-id","layer"+ke.DRAG+"-drag"),e.data.canvases[ke.WEBGL]&&e.data.canvases[ke.WEBGL].setAttribute("data-id","layer"+ke.WEBGL+"-webgl");for(var u=0;u<ke.BUFFER_COUNT;u++)e.data.bufferCanvases[u]=a.createElement("canvas"),e.data.bufferContexts[u]=e.data.bufferCanvases[u].getContext("2d"),e.data.bufferCanvases[u].style.position="absolute",e.data.bufferCanvases[u].setAttribute("data-id","buffer"+u),e.data.bufferCanvases[u].style.zIndex=String(-u-1),e.data.bufferCanvases[u].style.visibility="hidden";e.pathsEnabled=!0;var c=wr(),d=function(z){return{x:(z.x1+z.x2)/2,y:(z.y1+z.y2)/2}},h=function(z){return{x:-z.w/2,y:-z.h/2}},y=function(z){var q=z[0]._private,H=q.oldBackgroundTimestamp===q.backgroundTimestamp;return!H},g=function(z){return z[0]._private.nodeKey},p=function(z){return z[0]._private.labelStyleKey},m=function(z){return z[0]._private.sourceLabelStyleKey},b=function(z){return z[0]._private.targetLabelStyleKey},w=function(z,q,H,Y,te){return e.drawElement(z,q,H,!1,!1,te)},E=function(z,q,H,Y,te){return e.drawElementText(z,q,H,Y,"main",te)},C=function(z,q,H,Y,te){return e.drawElementText(z,q,H,Y,"source",te)},x=function(z,q,H,Y,te){return e.drawElementText(z,q,H,Y,"target",te)},T=function(z){return z.boundingBox(),z[0]._private.bodyBounds},k=function(z){return z.boundingBox(),z[0]._private.labelBounds.main||c},D=function(z){return z.boundingBox(),z[0]._private.labelBounds.source||c},B=function(z){return z.boundingBox(),z[0]._private.labelBounds.target||c},P=function(z,q){return q},A=function(z){return d(T(z))},R=function(z,q,H){var Y=z?z+"-":"";return{x:q.x+H.pstyle(Y+"text-margin-x").pfValue,y:q.y+H.pstyle(Y+"text-margin-y").pfValue}},L=function(z,q,H){var Y=z[0]._private.rscratch;return{x:Y[q],y:Y[H]}},I=function(z){return R("",L(z,"labelX","labelY"),z)},M=function(z){return R("source",L(z,"sourceLabelX","sourceLabelY"),z)},O=function(z){return R("target",L(z,"targetLabelX","targetLabelY"),z)},V=function(z){return h(T(z))},G=function(z){return h(D(z))},N=function(z){return h(B(z))},F=function(z){var q=k(z),H=h(k(z));if(z.isNode()){switch(z.pstyle("text-halign").value){case"left":H.x=-q.w-(q.leftPad||0);break;case"right":H.x=-(q.rightPad||0);break}switch(z.pstyle("text-valign").value){case"top":H.y=-q.h-(q.topPad||0);break;case"bottom":H.y=-(q.botPad||0);break}}return H},U=e.data.eleTxrCache=new ba(e,{getKey:g,doesEleInvalidateKey:y,drawElement:w,getBoundingBox:T,getRotationPoint:A,getRotationOffset:V,allowEdgeTxrCaching:!1,allowParentTxrCaching:!1}),Q=e.data.lblTxrCache=new ba(e,{getKey:p,drawElement:E,getBoundingBox:k,getRotationPoint:I,getRotationOffset:F,isVisible:P}),K=e.data.slbTxrCache=new ba(e,{getKey:m,drawElement:C,getBoundingBox:D,getRotationPoint:M,getRotationOffset:G,isVisible:P}),j=e.data.tlbTxrCache=new ba(e,{getKey:b,drawElement:x,getBoundingBox:B,getRotationPoint:O,getRotationOffset:N,isVisible:P}),re=e.data.lyrTxrCache=new kf(e);e.onUpdateEleCalcs(function(z,q){U.invalidateElements(q),Q.invalidateElements(q),K.invalidateElements(q),j.invalidateElements(q),re.invalidateElements(q);for(var H=0;H<q.length;H++){var Y=q[H]._private;Y.oldBackgroundTimestamp=Y.backgroundTimestamp}});var ne=function(z){for(var q=0;q<z.length;q++)re.enqueueElementRefinement(z[q].ele)};U.onDequeue(ne),Q.onDequeue(ne),K.onDequeue(ne),j.onDequeue(ne),r.webgl&&e.initWebgl(r,{getStyleKey:g,getLabelKey:p,getSourceLabelKey:m,getTargetLabelKey:b,drawElement:w,drawLabel:E,drawSourceLabel:C,drawTargetLabel:x,getElementBox:T,getLabelBox:k,getSourceLabelBox:D,getTargetLabelBox:B,getElementRotationPoint:A,getElementRotationOffset:V,getLabelRotationPoint:I,getSourceLabelRotationPoint:M,getTargetLabelRotationPoint:O,getLabelRotationOffset:F,getSourceLabelRotationOffset:G,getTargetLabelRotationOffset:N})}ke.redrawHint=function(r,e){var t=this;switch(r){case"eles":t.data.canvasNeedsRedraw[ke.NODE]=e;break;case"drag":t.data.canvasNeedsRedraw[ke.DRAG]=e;break;case"select":t.data.canvasNeedsRedraw[ke.SELECT_BOX]=e;break;case"gc":t.data.gc=!0;break}};var Tm=typeof Path2D<"u";ke.path2dEnabled=function(r){if(r===void 0)return this.pathsEnabled;this.pathsEnabled=!!r};ke.usePaths=function(){return Tm&&this.pathsEnabled};ke.setImgSmoothing=function(r,e){r.imageSmoothingEnabled!=null?r.imageSmoothingEnabled=e:(r.webkitImageSmoothingEnabled=e,r.mozImageSmoothingEnabled=e,r.msImageSmoothingEnabled=e)};ke.getImgSmoothing=function(r){return r.imageSmoothingEnabled!=null?r.imageSmoothingEnabled:r.webkitImageSmoothingEnabled||r.mozImageSmoothingEnabled||r.msImageSmoothingEnabled};ke.makeOffscreenCanvas=function(r,e){var t;if((typeof OffscreenCanvas>"u"?"undefined":ar(OffscreenCanvas))!=="undefined")t=new OffscreenCanvas(r,e);else{var a=this.cy.window(),n=a.document;t=n.createElement("canvas"),t.width=r,t.height=e}return t};[Df,Hr,Jr,ms,Lt,yt,xr,Mf,mt,Wa,Ff].forEach(function(r){be(ke,r)});var Sm=[{name:"null",impl:hf},{name:"base",impl:Cf},{name:"canvas",impl:Cm}],km=[{type:"layout",extensions:Qp},{type:"renderer",extensions:Sm}],qf={},_f={};function Gf(r,e,t){var a=t,n=function(T){Ve("Can not register `"+e+"` for `"+r+"` since `"+T+"` already exists in the prototype and can not be overridden")};if(r==="core"){if(Ra.prototype[e])return n(e);Ra.prototype[e]=t}else if(r==="collection"){if(fr.prototype[e])return n(e);fr.prototype[e]=t}else if(r==="layout"){for(var i=function(T){this.options=T,t.call(this,T),Le(this._private)||(this._private={}),this._private.cy=T.cy,this._private.listeners=[],this.createEmitter()},o=i.prototype=Object.create(t.prototype),s=[],l=0;l<s.length;l++){var u=s[l];o[u]=o[u]||function(){return this}}o.start&&!o.run?o.run=function(){return this.start(),this}:!o.start&&o.run&&(o.start=function(){return this.run(),this});var v=t.prototype.stop;o.stop=function(){var x=this.options;if(x&&x.animate){var T=this.animations;if(T)for(var k=0;k<T.length;k++)T[k].stop()}return v?v.call(this):this.emit("layoutstop"),this},o.destroy||(o.destroy=function(){return this}),o.cy=function(){return this._private.cy};var f=function(T){return T._private.cy},c={addEventFields:function(T,k){k.layout=T,k.cy=f(T),k.target=T},bubble:function(){return!0},parent:function(T){return f(T)}};be(o,{createEmitter:function(){return this._private.emitter=new Gn(c,this),this},emitter:function(){return this._private.emitter},on:function(T,k){return this.emitter().on(T,k),this},one:function(T,k){return this.emitter().one(T,k),this},once:function(T,k){return this.emitter().one(T,k),this},removeListener:function(T,k){return this.emitter().removeListener(T,k),this},removeAllListeners:function(){return this.emitter().removeAllListeners(),this},emit:function(T,k){return this.emitter().emit(T,k),this}}),Fe.eventAliasesOn(o),a=i}else if(r==="renderer"&&e!=="null"&&e!=="base"){var d=Hf("renderer","base"),h=d.prototype,y=t,g=t.prototype,p=function(){d.apply(this,arguments),y.apply(this,arguments)},m=p.prototype;for(var b in h){var w=h[b],E=g[b]!=null;if(E)return n(b);m[b]=w}for(var C in g)m[C]=g[C];h.clientFunctions.forEach(function(x){m[x]=m[x]||function(){$e("Renderer does not implement `renderer."+x+"()` on its prototype")}}),a=p}else if(r==="__proto__"||r==="constructor"||r==="prototype")return $e(r+" is an illegal type to be registered, possibly lead to prototype pollutions");return ov({map:qf,keys:[r,e],value:a})}function Hf(r,e){return sv({map:qf,keys:[r,e]})}function Dm(r,e,t,a,n){return ov({map:_f,keys:[r,e,t,a],value:n})}function Bm(r,e,t,a){return sv({map:_f,keys:[r,e,t,a]})}var Xo=function(){if(arguments.length===2)return Hf.apply(null,arguments);if(arguments.length===3)return Gf.apply(null,arguments);if(arguments.length===4)return Bm.apply(null,arguments);if(arguments.length===5)return Dm.apply(null,arguments);$e("Invalid extension access syntax")};Ra.prototype.extension=Xo;km.forEach(function(r){r.extensions.forEach(function(e){Gf(r.type,e.name,e.impl)})});var Rn=function(){if(!(this instanceof Rn))return new Rn;this.length=0},Rt=Rn.prototype;Rt.instanceString=function(){return"stylesheet"};Rt.selector=function(r){var e=this.length++;return this[e]={selector:r,properties:[]},this};Rt.css=function(r,e){var t=this.length-1;if(ge(r))this[t].properties.push({name:r,value:e});else if(Le(r))for(var a=r,n=Object.keys(a),i=0;i<n.length;i++){var o=n[i],s=a[o];if(s!=null){var l=sr.properties[o]||sr.properties[Mn(o)];if(l!=null){var u=l.name,v=s;this[t].properties.push({name:u,value:v})}}}return this};Rt.style=Rt.css;Rt.generateStyle=function(r){var e=new sr(r);return this.appendToStyle(e)};Rt.appendToStyle=function(r){for(var e=0;e<this.length;e++){var t=this[e],a=t.selector,n=t.properties;r.selector(a);for(var i=0;i<n.length;i++){var o=n[i];r.css(o.name,o.value)}}return r};var Pm="3.33.1",ea=function(e){if(e===void 0&&(e={}),Le(e))return new Ra(e);if(ge(e))return Xo.apply(Xo,arguments)};ea.use=function(r){var e=Array.prototype.slice.call(arguments,1);return e.unshift(ea),r.apply(null,e),this};ea.warnings=function(r){return dv(r)};ea.version=Pm;ea.stylesheet=ea.Stylesheet=Rn;export{ea as c};
diff --git a/docs/dist/assets/dagre-6UL2VRFP-C6Co3lCr.js b/docs/dist/assets/dagre-6UL2VRFP-C6Co3lCr.js
deleted file mode 100644
index 9c2a2929..00000000
--- a/docs/dist/assets/dagre-6UL2VRFP-C6Co3lCr.js
+++ /dev/null
@@ -1,4 +0,0 @@
-import{_ as w,ar as F,as as Y,at as _,au as H,l as r,c as V,av as z,aw as U,ag as $,al as q,ah as P,af as K,ax as Q,ay as W,az as Z}from"./index-BxX29htg.js";import{G as B}from"./graph-DQwMrrst.js";import{l as I}from"./layout-Cg3H1pzX.js";import{i as b}from"./_baseUniq-CfjWcJYV.js";import{c as L}from"./clone-BRV0rZiZ.js";import{m as A}from"./_basePickBy-CqMtcO3s.js";function h(e){var t={options:{directed:e.isDirected(),multigraph:e.isMultigraph(),compound:e.isCompound()},nodes:ee(e),edges:ne(e)};return b(e.graph())||(t.value=L(e.graph())),t}function ee(e){return A(e.nodes(),function(t){var n=e.node(t),a=e.parent(t),i={v:t};return b(n)||(i.value=n),b(a)||(i.parent=a),i})}function ne(e){return A(e.edges(),function(t){var n=e.edge(t),a={v:t.v,w:t.w};return b(t.name)||(a.name=t.name),b(n)||(a.value=n),a})}var d=new Map,y=new Map,J=new Map,te=w(()=>{y.clear(),J.clear(),d.clear()},"clear"),D=w((e,t)=>{const n=y.get(t)||[];return r.trace("In isDescendant",t," ",e," = ",n.includes(e)),n.includes(e)},"isDescendant"),se=w((e,t)=>{const n=y.get(t)||[];return r.info("Descendants of ",t," is ",n),r.info("Edge is ",e),e.v===t||e.w===t?!1:n?n.includes(e.v)||D(e.v,t)||D(e.w,t)||n.includes(e.w):(r.debug("Tilt, ",t,",not in descendants"),!1)},"edgeInCluster"),G=w((e,t,n,a)=>{r.warn("Copying children of ",e,"root",a,"data",t.node(e),a);const i=t.children(e)||[];e!==a&&i.push(e),r.warn("Copying (nodes) clusterId",e,"nodes",i),i.forEach(o=>{if(t.children(o).length>0)G(o,t,n,a);else{const l=t.node(o);r.info("cp ",o," to ",a," with parent ",e),n.setNode(o,l),a!==t.parent(o)&&(r.warn("Setting parent",o,t.parent(o)),n.setParent(o,t.parent(o))),e!==a&&o!==e?(r.debug("Setting parent",o,e),n.setParent(o,e)):(r.info("In copy ",e,"root",a,"data",t.node(e),a),r.debug("Not Setting parent for node=",o,"cluster!==rootId",e!==a,"node!==clusterId",o!==e));const u=t.edges(o);r.debug("Copying Edges",u),u.forEach(c=>{r.info("Edge",c);const m=t.edge(c.v,c.w,c.name);r.info("Edge data",m,a);try{se(c,a)?(r.info("Copying as ",c.v,c.w,m,c.name),n.setEdge(c.v,c.w,m,c.name),r.info("newGraph edges ",n.edges(),n.edge(n.edges()[0]))):r.info("Skipping copy of edge ",c.v,"-->",c.w," rootId: ",a," clusterId:",e)}catch(v){r.error(v)}})}r.debug("Removing node",o),t.removeNode(o)})},"copy"),R=w((e,t)=>{const n=t.children(e);let a=[...n];for(const i of n)J.set(i,e),a=[...a,...R(i,t)];return a},"extractDescendants"),re=w((e,t,n)=>{const a=e.edges().filter(c=>c.v===t||c.w===t),i=e.edges().filter(c=>c.v===n||c.w===n),o=a.map(c=>({v:c.v===t?n:c.v,w:c.w===t?t:c.w})),l=i.map(c=>({v:c.v,w:c.w}));return o.filter(c=>l.some(m=>c.v===m.v&&c.w===m.w))},"findCommonEdges"),C=w((e,t,n)=>{const a=t.children(e);if(r.trace("Searching children of id ",e,a),a.length<1)return e;let i;for(const o of a){const l=C(o,t,n),u=re(t,n,l);if(l)if(u.length>0)i=l;else return l}return i},"findNonClusterChild"),k=w(e=>!d.has(e)||!d.get(e).externalConnections?e:d.has(e)?d.get(e).id:e,"getAnchorId"),ie=w((e,t)=>{if(!e||t>10){r.debug("Opting out, no graph ");return}else r.debug("Opting in, graph ");e.nodes().forEach(function(n){e.children(n).length>0&&(r.warn("Cluster identified",n," Replacement id in edges: ",C(n,e,n)),y.set(n,R(n,e)),d.set(n,{id:C(n,e,n),clusterData:e.node(n)}))}),e.nodes().forEach(function(n){const a=e.children(n),i=e.edges();a.length>0?(r.debug("Cluster identified",n,y),i.forEach(o=>{const l=D(o.v,n),u=D(o.w,n);l^u&&(r.warn("Edge: ",o," leaves cluster ",n),r.warn("Descendants of XXX ",n,": ",y.get(n)),d.get(n).externalConnections=!0)})):r.debug("Not a cluster ",n,y)});for(let n of d.keys()){const a=d.get(n).id,i=e.parent(a);i!==n&&d.has(i)&&!d.get(i).externalConnections&&(d.get(n).id=i)}e.edges().forEach(function(n){const a=e.edge(n);r.warn("Edge "+n.v+" -> "+n.w+": "+JSON.stringify(n)),r.warn("Edge "+n.v+" -> "+n.w+": "+JSON.stringify(e.edge(n)));let i=n.v,o=n.w;if(r.warn("Fix XXX",d,"ids:",n.v,n.w,"Translating: ",d.get(n.v)," --- ",d.get(n.w)),d.get(n.v)||d.get(n.w)){if(r.warn("Fixing and trying - removing XXX",n.v,n.w,n.name),i=k(n.v),o=k(n.w),e.removeEdge(n.v,n.w,n.name),i!==n.v){const l=e.parent(i);d.get(l).externalConnections=!0,a.fromCluster=n.v}if(o!==n.w){const l=e.parent(o);d.get(l).externalConnections=!0,a.toCluster=n.w}r.warn("Fix Replacing with XXX",i,o,n.name),e.setEdge(i,o,a,n.name)}}),r.warn("Adjusted Graph",h(e)),T(e,0),r.trace(d)},"adjustClustersAndEdges"),T=w((e,t)=>{if(r.warn("extractor - ",t,h(e),e.children("D")),t>10){r.error("Bailing out");return}let n=e.nodes(),a=!1;for(const i of n){const o=e.children(i);a=a||o.length>0}if(!a){r.debug("Done, no node has children",e.nodes());return}r.debug("Nodes = ",n,t);for(const i of n)if(r.debug("Extracting node",i,d,d.has(i)&&!d.get(i).externalConnections,!e.parent(i),e.node(i),e.children("D")," Depth ",t),!d.has(i))r.debug("Not a cluster",i,t);else if(!d.get(i).externalConnections&&e.children(i)&&e.children(i).length>0){r.warn("Cluster without external connections, without a parent and with children",i,t);let l=e.graph().rankdir==="TB"?"LR":"TB";d.get(i)?.clusterData?.dir&&(l=d.get(i).clusterData.dir,r.warn("Fixing dir",d.get(i).clusterData.dir,l));const u=new B({multigraph:!0,compound:!0}).setGraph({rankdir:l,nodesep:50,ranksep:50,marginx:8,marginy:8}).setDefaultEdgeLabel(function(){return{}});r.warn("Old graph before copy",h(e)),G(i,e,u,i),e.setNode(i,{clusterNode:!0,id:i,clusterData:d.get(i).clusterData,label:d.get(i).label,graph:u}),r.warn("New graph after copy node: (",i,")",h(u)),r.debug("Old graph after copy",h(e))}else r.warn("Cluster ** ",i," **not meeting the criteria !externalConnections:",!d.get(i).externalConnections," no parent: ",!e.parent(i)," children ",e.children(i)&&e.children(i).length>0,e.children("D"),t),r.debug(d);n=e.nodes(),r.warn("New list of nodes",n);for(const i of n){const o=e.node(i);r.warn(" Now next level",i,o),o?.clusterNode&&T(o.graph,t+1)}},"extractor"),M=w((e,t)=>{if(t.length===0)return[];let n=Object.assign([],t);return t.forEach(a=>{const i=e.children(a),o=M(e,i);n=[...n,...o]}),n},"sorter"),oe=w(e=>M(e,e.children()),"sortNodesByHierarchy"),j=w(async(e,t,n,a,i,o)=>{r.warn("Graph in recursive render:XAX",h(t),i);const l=t.graph().rankdir;r.trace("Dir in recursive render - dir:",l);const u=e.insert("g").attr("class","root");t.nodes()?r.info("Recursive render XXX",t.nodes()):r.info("No nodes found for",t),t.edges().length>0&&r.info("Recursive edges",t.edge(t.edges()[0]));const c=u.insert("g").attr("class","clusters"),m=u.insert("g").attr("class","edgePaths"),v=u.insert("g").attr("class","edgeLabels"),X=u.insert("g").attr("class","nodes");await Promise.all(t.nodes().map(async function(f){const s=t.node(f);if(i!==void 0){const g=JSON.parse(JSON.stringify(i.clusterData));r.trace(`Setting data for parent cluster XXX
- Node.id = `,f,`
- data=`,g.height,`
-Parent cluster`,i.height),t.setNode(i.id,g),t.parent(f)||(r.trace("Setting parent",f,i.id),t.setParent(f,i.id,g))}if(r.info("(Insert) Node XXX"+f+": "+JSON.stringify(t.node(f))),s?.clusterNode){r.info("Cluster identified XBX",f,s.width,t.node(f));const{ranksep:g,nodesep:E}=t.graph();s.graph.setGraph({...s.graph.graph(),ranksep:g+25,nodesep:E});const N=await j(X,s.graph,n,a,t.node(f),o),x=N.elem;z(s,x),s.diff=N.diff||0,r.info("New compound node after recursive render XAX",f,"width",s.width,"height",s.height),U(x,s)}else t.children(f).length>0?(r.trace("Cluster - the non recursive path XBX",f,s.id,s,s.width,"Graph:",t),r.trace(C(s.id,t)),d.set(s.id,{id:C(s.id,t),node:s})):(r.trace("Node - the non recursive path XAX",f,X,t.node(f),l),await $(X,t.node(f),{config:o,dir:l}))})),await w(async()=>{const f=t.edges().map(async function(s){const g=t.edge(s.v,s.w,s.name);r.info("Edge "+s.v+" -> "+s.w+": "+JSON.stringify(s)),r.info("Edge "+s.v+" -> "+s.w+": ",s," ",JSON.stringify(t.edge(s))),r.info("Fix",d,"ids:",s.v,s.w,"Translating: ",d.get(s.v),d.get(s.w)),await Z(v,g)});await Promise.all(f)},"processEdges")(),r.info("Graph before layout:",JSON.stringify(h(t))),r.info("############################################# XXX"),r.info("###                Layout                 ### XXX"),r.info("############################################# XXX"),I(t),r.info("Graph after layout:",JSON.stringify(h(t)));let O=0,{subGraphTitleTotalMargin:S}=q(o);return await Promise.all(oe(t).map(async function(f){const s=t.node(f);if(r.info("Position XBX => "+f+": ("+s.x,","+s.y,") width: ",s.width," height: ",s.height),s?.clusterNode)s.y+=S,r.info("A tainted cluster node XBX1",f,s.id,s.width,s.height,s.x,s.y,t.parent(f)),d.get(s.id).node=s,P(s);else if(t.children(f).length>0){r.info("A pure cluster node XBX1",f,s.id,s.x,s.y,s.width,s.height,t.parent(f)),s.height+=S,t.node(s.parentId);const g=s?.padding/2||0,E=s?.labelBBox?.height||0,N=E-g||0;r.debug("OffsetY",N,"labelHeight",E,"halfPadding",g),await K(c,s),d.get(s.id).node=s}else{const g=t.node(s.parentId);s.y+=S/2,r.info("A regular node XBX1 - using the padding",s.id,"parent",s.parentId,s.width,s.height,s.x,s.y,"offsetY",s.offsetY,"parent",g,g?.offsetY,s),P(s)}})),t.edges().forEach(function(f){const s=t.edge(f);r.info("Edge "+f.v+" -> "+f.w+": "+JSON.stringify(s),s),s.points.forEach(x=>x.y+=S/2);const g=t.node(f.v);var E=t.node(f.w);const N=Q(m,s,d,n,g,E,a);W(s,N)}),t.nodes().forEach(function(f){const s=t.node(f);r.info(f,s.type,s.diff),s.isGroup&&(O=s.diff)}),r.warn("Returning from recursive render XAX",u,O),{elem:u,diff:O}},"recursiveRender"),ge=w(async(e,t)=>{const n=new B({multigraph:!0,compound:!0}).setGraph({rankdir:e.direction,nodesep:e.config?.nodeSpacing||e.config?.flowchart?.nodeSpacing||e.nodeSpacing,ranksep:e.config?.rankSpacing||e.config?.flowchart?.rankSpacing||e.rankSpacing,marginx:8,marginy:8}).setDefaultEdgeLabel(function(){return{}}),a=t.select("g");F(a,e.markers,e.type,e.diagramId),Y(),_(),H(),te(),e.nodes.forEach(o=>{n.setNode(o.id,{...o}),o.parentId&&n.setParent(o.id,o.parentId)}),r.debug("Edges:",e.edges),e.edges.forEach(o=>{if(o.start===o.end){const l=o.start,u=l+"---"+l+"---1",c=l+"---"+l+"---2",m=n.node(l);n.setNode(u,{domId:u,id:u,parentId:m.parentId,labelStyle:"",label:"",padding:0,shape:"labelRect",style:"",width:10,height:10}),n.setParent(u,m.parentId),n.setNode(c,{domId:c,id:c,parentId:m.parentId,labelStyle:"",padding:0,shape:"labelRect",label:"",style:"",width:10,height:10}),n.setParent(c,m.parentId);const v=structuredClone(o),X=structuredClone(o),p=structuredClone(o);v.label="",v.arrowTypeEnd="none",v.id=l+"-cyclic-special-1",X.arrowTypeStart="none",X.arrowTypeEnd="none",X.id=l+"-cyclic-special-mid",p.label="",m.isGroup&&(v.fromCluster=l,p.toCluster=l),p.id=l+"-cyclic-special-2",p.arrowTypeStart="none",n.setEdge(l,u,v,l+"-cyclic-special-0"),n.setEdge(u,c,X,l+"-cyclic-special-1"),n.setEdge(c,l,p,l+"-cyc<lic-special-2")}else n.setEdge(o.start,o.end,{...o},o.id)}),r.warn("Graph at first:",JSON.stringify(h(n))),ie(n),r.warn("Graph after XAX:",JSON.stringify(h(n)));const i=V();await j(a,n,e.type,e.diagramId,void 0,i)},"render");export{ge as render};
diff --git a/docs/dist/assets/defaultLocale-C4B-KCzX.js b/docs/dist/assets/defaultLocale-C4B-KCzX.js
deleted file mode 100644
index c0818353..00000000
--- a/docs/dist/assets/defaultLocale-C4B-KCzX.js
+++ /dev/null
@@ -1 +0,0 @@
-function H(n){return Math.abs(n=Math.round(n))>=1e21?n.toLocaleString("en").replace(/,/g,""):n.toString(10)}function j(n,t){if((e=(n=t?n.toExponential(t-1):n.toExponential()).indexOf("e"))<0)return null;var e,i=n.slice(0,e);return[i.length>1?i[0]+i.slice(2):i,+n.slice(e+1)]}function J(n){return n=j(Math.abs(n)),n?n[1]:NaN}function K(n,t){return function(e,i){for(var o=e.length,f=[],c=0,u=n[0],p=0;o>0&&u>0&&(p+u+1>i&&(u=Math.max(1,i-p)),f.push(e.substring(o-=u,o+u)),!((p+=u+1)>i));)u=n[c=(c+1)%n.length];return f.reverse().join(t)}}function Q(n){return function(t){return t.replace(/[0-9]/g,function(e){return n[+e]})}}var V=/^(?:(.)?([<>=^]))?([+\-( ])?([$#])?(0)?(\d+)?(,)?(\.\d+)?(~)?([a-z%])?$/i;function N(n){if(!(t=V.exec(n)))throw new Error("invalid format: "+n);var t;return new $({fill:t[1],align:t[2],sign:t[3],symbol:t[4],zero:t[5],width:t[6],comma:t[7],precision:t[8]&&t[8].slice(1),trim:t[9],type:t[10]})}N.prototype=$.prototype;function $(n){this.fill=n.fill===void 0?" ":n.fill+"",this.align=n.align===void 0?">":n.align+"",this.sign=n.sign===void 0?"-":n.sign+"",this.symbol=n.symbol===void 0?"":n.symbol+"",this.zero=!!n.zero,this.width=n.width===void 0?void 0:+n.width,this.comma=!!n.comma,this.precision=n.precision===void 0?void 0:+n.precision,this.trim=!!n.trim,this.type=n.type===void 0?"":n.type+""}$.prototype.toString=function(){return this.fill+this.align+this.sign+this.symbol+(this.zero?"0":"")+(this.width===void 0?"":Math.max(1,this.width|0))+(this.comma?",":"")+(this.precision===void 0?"":"."+Math.max(0,this.precision|0))+(this.trim?"~":"")+this.type};function W(n){n:for(var t=n.length,e=1,i=-1,o;e<t;++e)switch(n[e]){case".":i=o=e;break;case"0":i===0&&(i=e),o=e;break;default:if(!+n[e])break n;i>0&&(i=0);break}return i>0?n.slice(0,i)+n.slice(o+1):n}var U;function _(n,t){var e=j(n,t);if(!e)return n+"";var i=e[0],o=e[1],f=o-(U=Math.max(-8,Math.min(8,Math.floor(o/3)))*3)+1,c=i.length;return f===c?i:f>c?i+new Array(f-c+1).join("0"):f>0?i.slice(0,f)+"."+i.slice(f):"0."+new Array(1-f).join("0")+j(n,Math.max(0,t+f-1))[0]}function G(n,t){var e=j(n,t);if(!e)return n+"";var i=e[0],o=e[1];return o<0?"0."+new Array(-o).join("0")+i:i.length>o+1?i.slice(0,o+1)+"."+i.slice(o+1):i+new Array(o-i.length+2).join("0")}const I={"%":(n,t)=>(n*100).toFixed(t),b:n=>Math.round(n).toString(2),c:n=>n+"",d:H,e:(n,t)=>n.toExponential(t),f:(n,t)=>n.toFixed(t),g:(n,t)=>n.toPrecision(t),o:n=>Math.round(n).toString(8),p:(n,t)=>G(n*100,t),r:G,s:_,X:n=>Math.round(n).toString(16).toUpperCase(),x:n=>Math.round(n).toString(16)};function X(n){return n}var O=Array.prototype.map,R=["y","z","a","f","p","n","µ","m","","k","M","G","T","P","E","Z","Y"];function v(n){var t=n.grouping===void 0||n.thousands===void 0?X:K(O.call(n.grouping,Number),n.thousands+""),e=n.currency===void 0?"":n.currency[0]+"",i=n.currency===void 0?"":n.currency[1]+"",o=n.decimal===void 0?".":n.decimal+"",f=n.numerals===void 0?X:Q(O.call(n.numerals,String)),c=n.percent===void 0?"%":n.percent+"",u=n.minus===void 0?"−":n.minus+"",p=n.nan===void 0?"NaN":n.nan+"";function F(a){a=N(a);var x=a.fill,M=a.align,m=a.sign,w=a.symbol,l=a.zero,S=a.width,E=a.comma,g=a.precision,L=a.trim,d=a.type;d==="n"?(E=!0,d="g"):I[d]||(g===void 0&&(g=12),L=!0,d="g"),(l||x==="0"&&M==="=")&&(l=!0,x="0",M="=");var Z=w==="$"?e:w==="#"&&/[boxX]/.test(d)?"0"+d.toLowerCase():"",q=w==="$"?i:/[%p]/.test(d)?c:"",T=I[d],B=/[defgprs%]/.test(d);g=g===void 0?6:/[gprs]/.test(d)?Math.max(1,Math.min(21,g)):Math.max(0,Math.min(20,g));function C(r){var y=Z,h=q,b,D,k;if(d==="c")h=T(r)+h,r="";else{r=+r;var P=r<0||1/r<0;if(r=isNaN(r)?p:T(Math.abs(r),g),L&&(r=W(r)),P&&+r==0&&m!=="+"&&(P=!1),y=(P?m==="("?m:u:m==="-"||m==="("?"":m)+y,h=(d==="s"?R[8+U/3]:"")+h+(P&&m==="("?")":""),B){for(b=-1,D=r.length;++b<D;)if(k=r.charCodeAt(b),48>k||k>57){h=(k===46?o+r.slice(b+1):r.slice(b))+h,r=r.slice(0,b);break}}}E&&!l&&(r=t(r,1/0));var z=y.length+r.length+h.length,s=z<S?new Array(S-z+1).join(x):"";switch(E&&l&&(r=t(s+r,s.length?S-h.length:1/0),s=""),M){case"<":r=y+r+h+s;break;case"=":r=y+s+r+h;break;case"^":r=s.slice(0,z=s.length>>1)+y+r+h+s.slice(z);break;default:r=s+y+r+h;break}return f(r)}return C.toString=function(){return a+""},C}function Y(a,x){var M=F((a=N(a),a.type="f",a)),m=Math.max(-8,Math.min(8,Math.floor(J(x)/3)))*3,w=Math.pow(10,-m),l=R[8+m/3];return function(S){return M(w*S)+l}}return{format:F,formatPrefix:Y}}var A,nn,tn;rn({thousands:",",grouping:[3],currency:["$",""]});function rn(n){return A=v(n),nn=A.format,tn=A.formatPrefix,A}export{tn as a,nn as b,J as e,N as f};
diff --git a/docs/dist/assets/diagram-PSM6KHXK-DJOM8VfI.js b/docs/dist/assets/diagram-PSM6KHXK-DJOM8VfI.js
deleted file mode 100644
index c99e25db..00000000
--- a/docs/dist/assets/diagram-PSM6KHXK-DJOM8VfI.js
+++ /dev/null
@@ -1,24 +0,0 @@
-import{_ as w,D as te,E as ae,H as he,e as ue,l as K,a_ as P,d as Y,b as pe,a as fe,p as me,q as ge,g as ye,s as Se,F as ve,a$ as xe,y as be}from"./index-BxX29htg.js";import{s as we}from"./chunk-QN33PNHL-1s4FuBGd.js";import{p as Ce}from"./chunk-4BX2VUAB-BU7cqk0M.js";import{p as Te}from"./treemap-KMMF4GRG-DFERHDZP.js";import{b as O}from"./defaultLocale-C4B-KCzX.js";import{o as J}from"./ordinal-Cboi1Yqb.js";import"./_baseUniq-CfjWcJYV.js";import"./_basePickBy-CqMtcO3s.js";import"./clone-BRV0rZiZ.js";import"./init-Gi6I4Gst.js";function Le(t){var a=0,l=t.children,n=l&&l.length;if(!n)a=1;else for(;--n>=0;)a+=l[n].value;t.value=a}function $e(){return this.eachAfter(Le)}function Ae(t,a){let l=-1;for(const n of this)t.call(a,n,++l,this);return this}function Fe(t,a){for(var l=this,n=[l],o,s,d=-1;l=n.pop();)if(t.call(a,l,++d,this),o=l.children)for(s=o.length-1;s>=0;--s)n.push(o[s]);return this}function ke(t,a){for(var l=this,n=[l],o=[],s,d,h,m=-1;l=n.pop();)if(o.push(l),s=l.children)for(d=0,h=s.length;d<h;++d)n.push(s[d]);for(;l=o.pop();)t.call(a,l,++m,this);return this}function Ne(t,a){let l=-1;for(const n of this)if(t.call(a,n,++l,this))return n}function Me(t){return this.eachAfter(function(a){for(var l=+t(a.data)||0,n=a.children,o=n&&n.length;--o>=0;)l+=n[o].value;a.value=l})}function _e(t){return this.eachBefore(function(a){a.children&&a.children.sort(t)})}function ze(t){for(var a=this,l=Ve(a,t),n=[a];a!==l;)a=a.parent,n.push(a);for(var o=n.length;t!==l;)n.splice(o,0,t),t=t.parent;return n}function Ve(t,a){if(t===a)return t;var l=t.ancestors(),n=a.ancestors(),o=null;for(t=l.pop(),a=n.pop();t===a;)o=t,t=l.pop(),a=n.pop();return o}function De(){for(var t=this,a=[t];t=t.parent;)a.push(t);return a}function Pe(){return Array.from(this)}function Be(){var t=[];return this.eachBefore(function(a){a.children||t.push(a)}),t}function Ee(){var t=this,a=[];return t.each(function(l){l!==t&&a.push({source:l.parent,target:l})}),a}function*Re(){var t=this,a,l=[t],n,o,s;do for(a=l.reverse(),l=[];t=a.pop();)if(yield t,n=t.children)for(o=0,s=n.length;o<s;++o)l.push(n[o]);while(l.length)}function Q(t,a){t instanceof Map?(t=[void 0,t],a===void 0&&(a=Ie)):a===void 0&&(a=He);for(var l=new U(t),n,o=[l],s,d,h,m;n=o.pop();)if((d=a(n.data))&&(m=(d=Array.from(d)).length))for(n.children=d,h=m-1;h>=0;--h)o.push(s=d[h]=new U(d[h])),s.parent=n,s.depth=n.depth+1;return l.eachBefore(qe)}function We(){return Q(this).eachBefore(Oe)}function He(t){return t.children}function Ie(t){return Array.isArray(t)?t[1]:null}function Oe(t){t.data.value!==void 0&&(t.value=t.data.value),t.data=t.data.data}function qe(t){var a=0;do t.height=a;while((t=t.parent)&&t.height<++a)}function U(t){this.data=t,this.depth=this.height=0,this.parent=null}U.prototype=Q.prototype={constructor:U,count:$e,each:Ae,eachAfter:ke,eachBefore:Fe,find:Ne,sum:Me,sort:_e,path:ze,ancestors:De,descendants:Pe,leaves:Be,links:Ee,copy:We,[Symbol.iterator]:Re};function Ge(t){if(typeof t!="function")throw new Error;return t}function q(){return 0}function G(t){return function(){return t}}function Xe(t){t.x0=Math.round(t.x0),t.y0=Math.round(t.y0),t.x1=Math.round(t.x1),t.y1=Math.round(t.y1)}function je(t,a,l,n,o){for(var s=t.children,d,h=-1,m=s.length,c=t.value&&(n-a)/t.value;++h<m;)d=s[h],d.y0=l,d.y1=o,d.x0=a,d.x1=a+=d.value*c}function Ye(t,a,l,n,o){for(var s=t.children,d,h=-1,m=s.length,c=t.value&&(o-l)/t.value;++h<m;)d=s[h],d.x0=a,d.x1=n,d.y0=l,d.y1=l+=d.value*c}var Ue=(1+Math.sqrt(5))/2;function Ze(t,a,l,n,o,s){for(var d=[],h=a.children,m,c,u=0,b=0,r=h.length,x,S,v=a.value,p,g,N,k,V,R,M;u<r;){x=o-l,S=s-n;do p=h[b++].value;while(!p&&b<r);for(g=N=p,R=Math.max(S/x,x/S)/(v*t),M=p*p*R,V=Math.max(N/M,M/g);b<r;++b){if(p+=c=h[b].value,c<g&&(g=c),c>N&&(N=c),M=p*p*R,k=Math.max(N/M,M/g),k>V){p-=c;break}V=k}d.push(m={value:p,dice:x<S,children:h.slice(u,b)}),m.dice?je(m,l,n,o,v?n+=S*p/v:s):Ye(m,l,n,v?l+=x*p/v:o,s),v-=p,u=b}return d}const Je=(function t(a){function l(n,o,s,d,h){Ze(a,n,o,s,d,h)}return l.ratio=function(n){return t((n=+n)>1?n:1)},l})(Ue);function Ke(){var t=Je,a=!1,l=1,n=1,o=[0],s=q,d=q,h=q,m=q,c=q;function u(r){return r.x0=r.y0=0,r.x1=l,r.y1=n,r.eachBefore(b),o=[0],a&&r.eachBefore(Xe),r}function b(r){var x=o[r.depth],S=r.x0+x,v=r.y0+x,p=r.x1-x,g=r.y1-x;p<S&&(S=p=(S+p)/2),g<v&&(v=g=(v+g)/2),r.x0=S,r.y0=v,r.x1=p,r.y1=g,r.children&&(x=o[r.depth+1]=s(r)/2,S+=c(r)-x,v+=d(r)-x,p-=h(r)-x,g-=m(r)-x,p<S&&(S=p=(S+p)/2),g<v&&(v=g=(v+g)/2),t(r,S,v,p,g))}return u.round=function(r){return arguments.length?(a=!!r,u):a},u.size=function(r){return arguments.length?(l=+r[0],n=+r[1],u):[l,n]},u.tile=function(r){return arguments.length?(t=Ge(r),u):t},u.padding=function(r){return arguments.length?u.paddingInner(r).paddingOuter(r):u.paddingInner()},u.paddingInner=function(r){return arguments.length?(s=typeof r=="function"?r:G(+r),u):s},u.paddingOuter=function(r){return arguments.length?u.paddingTop(r).paddingRight(r).paddingBottom(r).paddingLeft(r):u.paddingTop()},u.paddingTop=function(r){return arguments.length?(d=typeof r=="function"?r:G(+r),u):d},u.paddingRight=function(r){return arguments.length?(h=typeof r=="function"?r:G(+r),u):h},u.paddingBottom=function(r){return arguments.length?(m=typeof r=="function"?r:G(+r),u):m},u.paddingLeft=function(r){return arguments.length?(c=typeof r=="function"?r:G(+r),u):c},u}var E,ne=(E=class{constructor(){this.nodes=[],this.levels=new Map,this.outerNodes=[],this.classes=new Map,this.setAccTitle=pe,this.getAccTitle=fe,this.setDiagramTitle=me,this.getDiagramTitle=ge,this.getAccDescription=ye,this.setAccDescription=Se}getNodes(){return this.nodes}getConfig(){const a=ve,l=ae();return te({...a.treemap,...l.treemap??{}})}addNode(a,l){this.nodes.push(a),this.levels.set(a,l),l===0&&(this.outerNodes.push(a),this.root??=a)}getRoot(){return{name:"",children:this.outerNodes}}addClass(a,l){const n=this.classes.get(a)??{id:a,styles:[],textStyles:[]},o=l.replace(/\\,/g,"§§§").replace(/,/g,";").replace(/§§§/g,",").split(";");o&&o.forEach(s=>{xe(s)&&(n?.textStyles?n.textStyles.push(s):n.textStyles=[s]),n?.styles?n.styles.push(s):n.styles=[s]}),this.classes.set(a,n)}getClasses(){return this.classes}getStylesForClass(a){return this.classes.get(a)?.styles??[]}clear(){be(),this.nodes=[],this.levels=new Map,this.outerNodes=[],this.classes=new Map,this.root=void 0}},w(E,"TreeMapDB"),E);function le(t){if(!t.length)return[];const a=[],l=[];return t.forEach(n=>{const o={name:n.name,children:n.type==="Leaf"?void 0:[]};for(o.classSelector=n?.classSelector,n?.cssCompiledStyles&&(o.cssCompiledStyles=[n.cssCompiledStyles]),n.type==="Leaf"&&n.value!==void 0&&(o.value=n.value);l.length>0&&l[l.length-1].level>=n.level;)l.pop();if(l.length===0)a.push(o);else{const s=l[l.length-1].node;s.children?s.children.push(o):s.children=[o]}n.type!=="Leaf"&&l.push({node:o,level:n.level})}),a}w(le,"buildHierarchy");var Qe=w((t,a)=>{Ce(t,a);const l=[];for(const s of t.TreemapRows??[])s.$type==="ClassDefStatement"&&a.addClass(s.className??"",s.styleText??"");for(const s of t.TreemapRows??[]){const d=s.item;if(!d)continue;const h=s.indent?parseInt(s.indent):0,m=et(d),c=d.classSelector?a.getStylesForClass(d.classSelector):[],u=c.length>0?c.join(";"):void 0,b={level:h,name:m,type:d.$type,value:d.value,classSelector:d.classSelector,cssCompiledStyles:u};l.push(b)}const n=le(l),o=w((s,d)=>{for(const h of s)a.addNode(h,d),h.children&&h.children.length>0&&o(h.children,d+1)},"addNodesRecursively");o(n,0)},"populate"),et=w(t=>t.name?String(t.name):"","getItemName"),re={parser:{yy:void 0},parse:w(async t=>{try{const l=await Te("treemap",t);K.debug("Treemap AST:",l);const n=re.parser?.yy;if(!(n instanceof ne))throw new Error("parser.parser?.yy was not a TreemapDB. This is due to a bug within Mermaid, please report this issue at https://github.com/mermaid-js/mermaid/issues.");Qe(l,n)}catch(a){throw K.error("Error parsing treemap:",a),a}},"parse")},tt=10,B=10,X=25,at=w((t,a,l,n)=>{const o=n.db,s=o.getConfig(),d=s.padding??tt,h=o.getDiagramTitle(),m=o.getRoot(),{themeVariables:c}=ae();if(!m)return;const u=h?30:0,b=he(a),r=s.nodeWidth?s.nodeWidth*B:960,x=s.nodeHeight?s.nodeHeight*B:500,S=r,v=x+u;b.attr("viewBox",`0 0 ${S} ${v}`),ue(b,v,S,s.useMaxWidth);let p;try{const e=s.valueFormat||",";if(e==="$0,0")p=w(i=>"$"+O(",")(i),"valueFormat");else if(e.startsWith("$")&&e.includes(",")){const i=/\.\d+/.exec(e),f=i?i[0]:"";p=w(C=>"$"+O(","+f)(C),"valueFormat")}else if(e.startsWith("$")){const i=e.substring(1);p=w(f=>"$"+O(i||"")(f),"valueFormat")}else p=O(e)}catch(e){K.error("Error creating format function:",e),p=O(",")}const g=J().range(["transparent",c.cScale0,c.cScale1,c.cScale2,c.cScale3,c.cScale4,c.cScale5,c.cScale6,c.cScale7,c.cScale8,c.cScale9,c.cScale10,c.cScale11]),N=J().range(["transparent",c.cScalePeer0,c.cScalePeer1,c.cScalePeer2,c.cScalePeer3,c.cScalePeer4,c.cScalePeer5,c.cScalePeer6,c.cScalePeer7,c.cScalePeer8,c.cScalePeer9,c.cScalePeer10,c.cScalePeer11]),k=J().range([c.cScaleLabel0,c.cScaleLabel1,c.cScaleLabel2,c.cScaleLabel3,c.cScaleLabel4,c.cScaleLabel5,c.cScaleLabel6,c.cScaleLabel7,c.cScaleLabel8,c.cScaleLabel9,c.cScaleLabel10,c.cScaleLabel11]);h&&b.append("text").attr("x",S/2).attr("y",u/2).attr("class","treemapTitle").attr("text-anchor","middle").attr("dominant-baseline","middle").text(h);const V=b.append("g").attr("transform",`translate(0, ${u})`).attr("class","treemapContainer"),R=Q(m).sum(e=>e.value??0).sort((e,i)=>(i.value??0)-(e.value??0)),ee=Ke().size([r,x]).paddingTop(e=>e.children&&e.children.length>0?X+B:0).paddingInner(d).paddingLeft(e=>e.children&&e.children.length>0?B:0).paddingRight(e=>e.children&&e.children.length>0?B:0).paddingBottom(e=>e.children&&e.children.length>0?B:0).round(!0)(R),se=ee.descendants().filter(e=>e.children&&e.children.length>0),W=V.selectAll(".treemapSection").data(se).enter().append("g").attr("class","treemapSection").attr("transform",e=>`translate(${e.x0},${e.y0})`);W.append("rect").attr("width",e=>e.x1-e.x0).attr("height",X).attr("class","treemapSectionHeader").attr("fill","none").attr("fill-opacity",.6).attr("stroke-width",.6).attr("style",e=>e.depth===0?"display: none;":""),W.append("clipPath").attr("id",(e,i)=>`clip-section-${a}-${i}`).append("rect").attr("width",e=>Math.max(0,e.x1-e.x0-12)).attr("height",X),W.append("rect").attr("width",e=>e.x1-e.x0).attr("height",e=>e.y1-e.y0).attr("class",(e,i)=>`treemapSection section${i}`).attr("fill",e=>g(e.data.name)).attr("fill-opacity",.6).attr("stroke",e=>N(e.data.name)).attr("stroke-width",2).attr("stroke-opacity",.4).attr("style",e=>{if(e.depth===0)return"display: none;";const i=P({cssCompiledStyles:e.data.cssCompiledStyles});return i.nodeStyles+";"+i.borderStyles.join(";")}),W.append("text").attr("class","treemapSectionLabel").attr("x",6).attr("y",X/2).attr("dominant-baseline","middle").text(e=>e.depth===0?"":e.data.name).attr("font-weight","bold").attr("style",e=>{if(e.depth===0)return"display: none;";const i="dominant-baseline: middle; font-size: 12px; fill:"+k(e.data.name)+"; white-space: nowrap; overflow: hidden; text-overflow: ellipsis;",f=P({cssCompiledStyles:e.data.cssCompiledStyles});return i+f.labelStyles.replace("color:","fill:")}).each(function(e){if(e.depth===0)return;const i=Y(this),f=e.data.name;i.text(f);const C=e.x1-e.x0,L=6;let $;s.showValues!==!1&&e.value?$=C-10-30-10-L:$=C-L-6;const A=Math.max(15,$),y=i.node();if(y.getComputedTextLength()>A){let T=f;for(;T.length>0;){if(T=f.substring(0,T.length-1),T.length===0){i.text("..."),y.getComputedTextLength()>A&&i.text("");break}if(i.text(T+"..."),y.getComputedTextLength()<=A)break}}}),s.showValues!==!1&&W.append("text").attr("class","treemapSectionValue").attr("x",e=>e.x1-e.x0-10).attr("y",X/2).attr("text-anchor","end").attr("dominant-baseline","middle").text(e=>e.value?p(e.value):"").attr("font-style","italic").attr("style",e=>{if(e.depth===0)return"display: none;";const i="text-anchor: end; dominant-baseline: middle; font-size: 10px; fill:"+k(e.data.name)+"; white-space: nowrap; overflow: hidden; text-overflow: ellipsis;",f=P({cssCompiledStyles:e.data.cssCompiledStyles});return i+f.labelStyles.replace("color:","fill:")});const ie=ee.leaves(),j=V.selectAll(".treemapLeafGroup").data(ie).enter().append("g").attr("class",(e,i)=>`treemapNode treemapLeafGroup leaf${i}${e.data.classSelector?` ${e.data.classSelector}`:""}x`).attr("transform",e=>`translate(${e.x0},${e.y0})`);j.append("rect").attr("width",e=>e.x1-e.x0).attr("height",e=>e.y1-e.y0).attr("class","treemapLeaf").attr("fill",e=>e.parent?g(e.parent.data.name):g(e.data.name)).attr("style",e=>P({cssCompiledStyles:e.data.cssCompiledStyles}).nodeStyles).attr("fill-opacity",.3).attr("stroke",e=>e.parent?g(e.parent.data.name):g(e.data.name)).attr("stroke-width",3),j.append("clipPath").attr("id",(e,i)=>`clip-${a}-${i}`).append("rect").attr("width",e=>Math.max(0,e.x1-e.x0-4)).attr("height",e=>Math.max(0,e.y1-e.y0-4)),j.append("text").attr("class","treemapLabel").attr("x",e=>(e.x1-e.x0)/2).attr("y",e=>(e.y1-e.y0)/2).attr("style",e=>{const i="text-anchor: middle; dominant-baseline: middle; font-size: 38px;fill:"+k(e.data.name)+";",f=P({cssCompiledStyles:e.data.cssCompiledStyles});return i+f.labelStyles.replace("color:","fill:")}).attr("clip-path",(e,i)=>`url(#clip-${a}-${i})`).text(e=>e.data.name).each(function(e){const i=Y(this),f=e.x1-e.x0,C=e.y1-e.y0,L=i.node(),$=4,D=f-2*$,A=C-2*$;if(D<10||A<10){i.style("display","none");return}let y=parseInt(i.style("font-size"),10);const _=8,F=28,T=.6,z=6,H=2;for(;L.getComputedTextLength()>D&&y>_;)y--,i.style("font-size",`${y}px`);let I=Math.max(z,Math.min(F,Math.round(y*T))),Z=y+H+I;for(;Z>A&&y>_&&(y--,I=Math.max(z,Math.min(F,Math.round(y*T))),!(I<z&&y===_));)i.style("font-size",`${y}px`),Z=y+H+I;i.style("font-size",`${y}px`),(L.getComputedTextLength()>D||y<_||A<y)&&i.style("display","none")}),s.showValues!==!1&&j.append("text").attr("class","treemapValue").attr("x",i=>(i.x1-i.x0)/2).attr("y",function(i){return(i.y1-i.y0)/2}).attr("style",i=>{const f="text-anchor: middle; dominant-baseline: hanging; font-size: 28px;fill:"+k(i.data.name)+";",C=P({cssCompiledStyles:i.data.cssCompiledStyles});return f+C.labelStyles.replace("color:","fill:")}).attr("clip-path",(i,f)=>`url(#clip-${a}-${f})`).text(i=>i.value?p(i.value):"").each(function(i){const f=Y(this),C=this.parentNode;if(!C){f.style("display","none");return}const L=Y(C).select(".treemapLabel");if(L.empty()||L.style("display")==="none"){f.style("display","none");return}const $=parseFloat(L.style("font-size")),D=28,A=.6,y=6,_=2,F=Math.max(y,Math.min(D,Math.round($*A)));f.style("font-size",`${F}px`);const z=(i.y1-i.y0)/2+$/2+_;f.attr("y",z);const H=i.x1-i.x0,ce=i.y1-i.y0-4,de=H-8;f.node().getComputedTextLength()>de||z+F>ce||F<y?f.style("display","none"):f.style("display",null)});const oe=s.diagramPadding??8;we(b,oe,"flowchart",s?.useMaxWidth||!1)},"draw"),nt=w(function(t,a){return a.db.getClasses()},"getClasses"),lt={draw:at,getClasses:nt},rt={sectionStrokeColor:"black",sectionStrokeWidth:"1",sectionFillColor:"#efefef",leafStrokeColor:"black",leafStrokeWidth:"1",leafFillColor:"#efefef",labelColor:"black",labelFontSize:"12px",valueFontSize:"10px",valueColor:"black",titleColor:"black",titleFontSize:"14px"},st=w(({treemap:t}={})=>{const a=te(rt,t);return`
-  .treemapNode.section {
-    stroke: ${a.sectionStrokeColor};
-    stroke-width: ${a.sectionStrokeWidth};
-    fill: ${a.sectionFillColor};
-  }
-  .treemapNode.leaf {
-    stroke: ${a.leafStrokeColor};
-    stroke-width: ${a.leafStrokeWidth};
-    fill: ${a.leafFillColor};
-  }
-  .treemapLabel {
-    fill: ${a.labelColor};
-    font-size: ${a.labelFontSize};
-  }
-  .treemapValue {
-    fill: ${a.valueColor};
-    font-size: ${a.valueFontSize};
-  }
-  .treemapTitle {
-    fill: ${a.titleColor};
-    font-size: ${a.titleFontSize};
-  }
-  `},"getStyles"),it=st,vt={parser:re,get db(){return new ne},renderer:lt,styles:it};export{vt as diagram};
diff --git a/docs/dist/assets/diagram-QEK2KX5R-DkELOZ4d.js b/docs/dist/assets/diagram-QEK2KX5R-DkELOZ4d.js
deleted file mode 100644
index d666a744..00000000
--- a/docs/dist/assets/diagram-QEK2KX5R-DkELOZ4d.js
+++ /dev/null
@@ -1,43 +0,0 @@
-import{_ as l,s as k,g as R,q as E,p as F,a as I,b as _,H as D,y as G,D as f,E as C,F as P,l as z,K as H}from"./index-BxX29htg.js";import{p as V}from"./chunk-4BX2VUAB-BU7cqk0M.js";import{p as W}from"./treemap-KMMF4GRG-DFERHDZP.js";import"./_baseUniq-CfjWcJYV.js";import"./_basePickBy-CqMtcO3s.js";import"./clone-BRV0rZiZ.js";var h={showLegend:!0,ticks:5,max:null,min:0,graticule:"circle"},w={axes:[],curves:[],options:h},m=structuredClone(w),B=P.radar,j=l(()=>f({...B,...C().radar}),"getConfig"),b=l(()=>m.axes,"getAxes"),q=l(()=>m.curves,"getCurves"),K=l(()=>m.options,"getOptions"),N=l(a=>{m.axes=a.map(t=>({name:t.name,label:t.label??t.name}))},"setAxes"),U=l(a=>{m.curves=a.map(t=>({name:t.name,label:t.label??t.name,entries:X(t.entries)}))},"setCurves"),X=l(a=>{if(a[0].axis==null)return a.map(e=>e.value);const t=b();if(t.length===0)throw new Error("Axes must be populated before curves for reference entries");return t.map(e=>{const r=a.find(s=>s.axis?.$refText===e.name);if(r===void 0)throw new Error("Missing entry for axis "+e.label);return r.value})},"computeCurveEntries"),Y=l(a=>{const t=a.reduce((e,r)=>(e[r.name]=r,e),{});m.options={showLegend:t.showLegend?.value??h.showLegend,ticks:t.ticks?.value??h.ticks,max:t.max?.value??h.max,min:t.min?.value??h.min,graticule:t.graticule?.value??h.graticule}},"setOptions"),Z=l(()=>{G(),m=structuredClone(w)},"clear"),$={getAxes:b,getCurves:q,getOptions:K,setAxes:N,setCurves:U,setOptions:Y,getConfig:j,clear:Z,setAccTitle:_,getAccTitle:I,setDiagramTitle:F,getDiagramTitle:E,getAccDescription:R,setAccDescription:k},J=l(a=>{V(a,$);const{axes:t,curves:e,options:r}=a;$.setAxes(t),$.setCurves(e),$.setOptions(r)},"populate"),Q={parse:l(async a=>{const t=await W("radar",a);z.debug(t),J(t)},"parse")},tt=l((a,t,e,r)=>{const s=r.db,o=s.getAxes(),i=s.getCurves(),n=s.getOptions(),c=s.getConfig(),d=s.getDiagramTitle(),u=D(t),p=et(u,c),g=n.max??Math.max(...i.map(y=>Math.max(...y.entries))),x=n.min,v=Math.min(c.width,c.height)/2;at(p,o,v,n.ticks,n.graticule),rt(p,o,v,c),M(p,o,i,x,g,n.graticule,c),T(p,i,n.showLegend,c),p.append("text").attr("class","radarTitle").text(d).attr("x",0).attr("y",-c.height/2-c.marginTop)},"draw"),et=l((a,t)=>{const e=t.width+t.marginLeft+t.marginRight,r=t.height+t.marginTop+t.marginBottom,s={x:t.marginLeft+t.width/2,y:t.marginTop+t.height/2};return a.attr("viewbox",`0 0 ${e} ${r}`).attr("width",e).attr("height",r),a.append("g").attr("transform",`translate(${s.x}, ${s.y})`)},"drawFrame"),at=l((a,t,e,r,s)=>{if(s==="circle")for(let o=0;o<r;o++){const i=e*(o+1)/r;a.append("circle").attr("r",i).attr("class","radarGraticule")}else if(s==="polygon"){const o=t.length;for(let i=0;i<r;i++){const n=e*(i+1)/r,c=t.map((d,u)=>{const p=2*u*Math.PI/o-Math.PI/2,g=n*Math.cos(p),x=n*Math.sin(p);return`${g},${x}`}).join(" ");a.append("polygon").attr("points",c).attr("class","radarGraticule")}}},"drawGraticule"),rt=l((a,t,e,r)=>{const s=t.length;for(let o=0;o<s;o++){const i=t[o].label,n=2*o*Math.PI/s-Math.PI/2;a.append("line").attr("x1",0).attr("y1",0).attr("x2",e*r.axisScaleFactor*Math.cos(n)).attr("y2",e*r.axisScaleFactor*Math.sin(n)).attr("class","radarAxisLine"),a.append("text").text(i).attr("x",e*r.axisLabelFactor*Math.cos(n)).attr("y",e*r.axisLabelFactor*Math.sin(n)).attr("class","radarAxisLabel")}},"drawAxes");function M(a,t,e,r,s,o,i){const n=t.length,c=Math.min(i.width,i.height)/2;e.forEach((d,u)=>{if(d.entries.length!==n)return;const p=d.entries.map((g,x)=>{const v=2*Math.PI*x/n-Math.PI/2,y=A(g,r,s,c),O=y*Math.cos(v),S=y*Math.sin(v);return{x:O,y:S}});o==="circle"?a.append("path").attr("d",L(p,i.curveTension)).attr("class",`radarCurve-${u}`):o==="polygon"&&a.append("polygon").attr("points",p.map(g=>`${g.x},${g.y}`).join(" ")).attr("class",`radarCurve-${u}`)})}l(M,"drawCurves");function A(a,t,e,r){const s=Math.min(Math.max(a,t),e);return r*(s-t)/(e-t)}l(A,"relativeRadius");function L(a,t){const e=a.length;let r=`M${a[0].x},${a[0].y}`;for(let s=0;s<e;s++){const o=a[(s-1+e)%e],i=a[s],n=a[(s+1)%e],c=a[(s+2)%e],d={x:i.x+(n.x-o.x)*t,y:i.y+(n.y-o.y)*t},u={x:n.x-(c.x-i.x)*t,y:n.y-(c.y-i.y)*t};r+=` C${d.x},${d.y} ${u.x},${u.y} ${n.x},${n.y}`}return`${r} Z`}l(L,"closedRoundCurve");function T(a,t,e,r){if(!e)return;const s=(r.width/2+r.marginRight)*3/4,o=-(r.height/2+r.marginTop)*3/4,i=20;t.forEach((n,c)=>{const d=a.append("g").attr("transform",`translate(${s}, ${o+c*i})`);d.append("rect").attr("width",12).attr("height",12).attr("class",`radarLegendBox-${c}`),d.append("text").attr("x",16).attr("y",0).attr("class","radarLegendText").text(n.label)})}l(T,"drawLegend");var st={draw:tt},nt=l((a,t)=>{let e="";for(let r=0;r<a.THEME_COLOR_LIMIT;r++){const s=a[`cScale${r}`];e+=`
-		.radarCurve-${r} {
-			color: ${s};
-			fill: ${s};
-			fill-opacity: ${t.curveOpacity};
-			stroke: ${s};
-			stroke-width: ${t.curveStrokeWidth};
-		}
-		.radarLegendBox-${r} {
-			fill: ${s};
-			fill-opacity: ${t.curveOpacity};
-			stroke: ${s};
-		}
-		`}return e},"genIndexStyles"),ot=l(a=>{const t=H(),e=C(),r=f(t,e.themeVariables),s=f(r.radar,a);return{themeVariables:r,radarOptions:s}},"buildRadarStyleOptions"),it=l(({radar:a}={})=>{const{themeVariables:t,radarOptions:e}=ot(a);return`
-	.radarTitle {
-		font-size: ${t.fontSize};
-		color: ${t.titleColor};
-		dominant-baseline: hanging;
-		text-anchor: middle;
-	}
-	.radarAxisLine {
-		stroke: ${e.axisColor};
-		stroke-width: ${e.axisStrokeWidth};
-	}
-	.radarAxisLabel {
-		dominant-baseline: middle;
-		text-anchor: middle;
-		font-size: ${e.axisLabelFontSize}px;
-		color: ${e.axisColor};
-	}
-	.radarGraticule {
-		fill: ${e.graticuleColor};
-		fill-opacity: ${e.graticuleOpacity};
-		stroke: ${e.graticuleColor};
-		stroke-width: ${e.graticuleStrokeWidth};
-	}
-	.radarLegendText {
-		text-anchor: start;
-		font-size: ${e.legendFontSize}px;
-		dominant-baseline: hanging;
-	}
-	${nt(t,e)}
-	`},"styles"),mt={parser:Q,db:$,renderer:st,styles:it};export{mt as diagram};
diff --git a/docs/dist/assets/diagram-S2PKOQOG-DvFlKDlH.js b/docs/dist/assets/diagram-S2PKOQOG-DvFlKDlH.js
deleted file mode 100644
index d47cd40f..00000000
--- a/docs/dist/assets/diagram-S2PKOQOG-DvFlKDlH.js
+++ /dev/null
@@ -1,24 +0,0 @@
-import{_ as b,D as m,H as B,e as C,l as w,b as S,a as D,p as T,q as E,g as F,s as P,E as z,F as A,y as W}from"./index-BxX29htg.js";import{p as _}from"./chunk-4BX2VUAB-BU7cqk0M.js";import{p as N}from"./treemap-KMMF4GRG-DFERHDZP.js";import"./_baseUniq-CfjWcJYV.js";import"./_basePickBy-CqMtcO3s.js";import"./clone-BRV0rZiZ.js";var L=A.packet,u,v=(u=class{constructor(){this.packet=[],this.setAccTitle=S,this.getAccTitle=D,this.setDiagramTitle=T,this.getDiagramTitle=E,this.getAccDescription=F,this.setAccDescription=P}getConfig(){const t=m({...L,...z().packet});return t.showBits&&(t.paddingY+=10),t}getPacket(){return this.packet}pushWord(t){t.length>0&&this.packet.push(t)}clear(){W(),this.packet=[]}},b(u,"PacketDB"),u),M=1e4,Y=b((e,t)=>{_(e,t);let r=-1,o=[],n=1;const{bitsPerRow:l}=t.getConfig();for(let{start:a,end:i,bits:d,label:c}of e.blocks){if(a!==void 0&&i!==void 0&&i<a)throw new Error(`Packet block ${a} - ${i} is invalid. End must be greater than start.`);if(a??=r+1,a!==r+1)throw new Error(`Packet block ${a} - ${i??a} is not contiguous. It should start from ${r+1}.`);if(d===0)throw new Error(`Packet block ${a} is invalid. Cannot have a zero bit field.`);for(i??=a+(d??1)-1,d??=i-a+1,r=i,w.debug(`Packet block ${a} - ${r} with label ${c}`);o.length<=l+1&&t.getPacket().length<M;){const[p,s]=H({start:a,end:i,bits:d,label:c},n,l);if(o.push(p),p.end+1===n*l&&(t.pushWord(o),o=[],n++),!s)break;({start:a,end:i,bits:d,label:c}=s)}}t.pushWord(o)},"populate"),H=b((e,t,r)=>{if(e.start===void 0)throw new Error("start should have been set during first phase");if(e.end===void 0)throw new Error("end should have been set during first phase");if(e.start>e.end)throw new Error(`Block start ${e.start} is greater than block end ${e.end}.`);if(e.end+1<=t*r)return[e,void 0];const o=t*r-1,n=t*r;return[{start:e.start,end:o,label:e.label,bits:o-e.start},{start:n,end:e.end,label:e.label,bits:e.end-n}]},"getNextFittingBlock"),x={parser:{yy:void 0},parse:b(async e=>{const t=await N("packet",e),r=x.parser?.yy;if(!(r instanceof v))throw new Error("parser.parser?.yy was not a PacketDB. This is due to a bug within Mermaid, please report this issue at https://github.com/mermaid-js/mermaid/issues.");w.debug(t),Y(t,r)},"parse")},I=b((e,t,r,o)=>{const n=o.db,l=n.getConfig(),{rowHeight:a,paddingY:i,bitWidth:d,bitsPerRow:c}=l,p=n.getPacket(),s=n.getDiagramTitle(),h=a+i,g=h*(p.length+1)-(s?0:a),k=d*c+2,f=B(t);f.attr("viewbox",`0 0 ${k} ${g}`),C(f,g,k,l.useMaxWidth);for(const[y,$]of p.entries())O(f,$,y,l);f.append("text").text(s).attr("x",k/2).attr("y",g-h/2).attr("dominant-baseline","middle").attr("text-anchor","middle").attr("class","packetTitle")},"draw"),O=b((e,t,r,{rowHeight:o,paddingX:n,paddingY:l,bitWidth:a,bitsPerRow:i,showBits:d})=>{const c=e.append("g"),p=r*(o+l)+l;for(const s of t){const h=s.start%i*a+1,g=(s.end-s.start+1)*a-n;if(c.append("rect").attr("x",h).attr("y",p).attr("width",g).attr("height",o).attr("class","packetBlock"),c.append("text").attr("x",h+g/2).attr("y",p+o/2).attr("class","packetLabel").attr("dominant-baseline","middle").attr("text-anchor","middle").text(s.label),!d)continue;const k=s.end===s.start,f=p-2;c.append("text").attr("x",h+(k?g/2:0)).attr("y",f).attr("class","packetByte start").attr("dominant-baseline","auto").attr("text-anchor",k?"middle":"start").text(s.start),k||c.append("text").attr("x",h+g).attr("y",f).attr("class","packetByte end").attr("dominant-baseline","auto").attr("text-anchor","end").text(s.end)}},"drawWord"),j={draw:I},q={byteFontSize:"10px",startByteColor:"black",endByteColor:"black",labelColor:"black",labelFontSize:"12px",titleColor:"black",titleFontSize:"14px",blockStrokeColor:"black",blockStrokeWidth:"1",blockFillColor:"#efefef"},G=b(({packet:e}={})=>{const t=m(q,e);return`
-	.packetByte {
-		font-size: ${t.byteFontSize};
-	}
-	.packetByte.start {
-		fill: ${t.startByteColor};
-	}
-	.packetByte.end {
-		fill: ${t.endByteColor};
-	}
-	.packetLabel {
-		fill: ${t.labelColor};
-		font-size: ${t.labelFontSize};
-	}
-	.packetTitle {
-		fill: ${t.titleColor};
-		font-size: ${t.titleFontSize};
-	}
-	.packetBlock {
-		stroke: ${t.blockStrokeColor};
-		stroke-width: ${t.blockStrokeWidth};
-		fill: ${t.blockFillColor};
-	}
-	`},"styles"),V={parser:x,get db(){return new v},renderer:j,styles:G};export{V as diagram};
diff --git a/docs/dist/assets/erDiagram-Q2GNP2WA-B2qtJQLQ.js b/docs/dist/assets/erDiagram-Q2GNP2WA-B2qtJQLQ.js
deleted file mode 100644
index 45b8308e..00000000
--- a/docs/dist/assets/erDiagram-Q2GNP2WA-B2qtJQLQ.js
+++ /dev/null
@@ -1,60 +0,0 @@
-import{g as Dt}from"./chunk-55IACEB6-BE1gdz1f.js";import{s as wt}from"./chunk-QN33PNHL-1s4FuBGd.js";import{_ as u,b as Vt,a as Lt,s as Mt,g as Bt,p as Ft,q as Yt,c as tt,l as D,y as Pt,x as zt,A as Gt,B as Kt,o as Zt,r as Ut,d as jt,u as Wt}from"./index-BxX29htg.js";import{c as Qt}from"./channel-kd1Rx1KT.js";var dt=(function(){var s=u(function(R,n,a,c){for(a=a||{},c=R.length;c--;a[R[c]]=n);return a},"o"),i=[6,8,10,22,24,26,28,33,34,35,36,37,40,43,44,50],l=[1,10],d=[1,11],o=[1,12],h=[1,13],y=[1,20],_=[1,21],E=[1,22],V=[1,23],Z=[1,24],S=[1,19],et=[1,25],U=[1,26],T=[1,18],L=[1,33],st=[1,34],it=[1,35],rt=[1,36],nt=[1,37],pt=[6,8,10,13,15,17,20,21,22,24,26,28,33,34,35,36,37,40,43,44,50,63,64,65,66,67],O=[1,42],A=[1,43],M=[1,52],B=[40,50,68,69],F=[1,63],Y=[1,61],N=[1,58],P=[1,62],z=[1,64],j=[6,8,10,13,17,22,24,26,28,33,34,35,36,37,40,41,42,43,44,48,49,50,63,64,65,66,67],ft=[63,64,65,66,67],yt=[1,81],_t=[1,80],gt=[1,78],bt=[1,79],mt=[6,10,42,47],C=[6,10,13,41,42,47,48,49],W=[1,89],Q=[1,88],X=[1,87],G=[19,56],Et=[1,98],kt=[1,97],at=[19,56,58,60],ct={trace:u(function(){},"trace"),yy:{},symbols_:{error:2,start:3,ER_DIAGRAM:4,document:5,EOF:6,line:7,SPACE:8,statement:9,NEWLINE:10,entityName:11,relSpec:12,COLON:13,role:14,STYLE_SEPARATOR:15,idList:16,BLOCK_START:17,attributes:18,BLOCK_STOP:19,SQS:20,SQE:21,title:22,title_value:23,acc_title:24,acc_title_value:25,acc_descr:26,acc_descr_value:27,acc_descr_multiline_value:28,direction:29,classDefStatement:30,classStatement:31,styleStatement:32,direction_tb:33,direction_bt:34,direction_rl:35,direction_lr:36,CLASSDEF:37,stylesOpt:38,separator:39,UNICODE_TEXT:40,STYLE_TEXT:41,COMMA:42,CLASS:43,STYLE:44,style:45,styleComponent:46,SEMI:47,NUM:48,BRKT:49,ENTITY_NAME:50,attribute:51,attributeType:52,attributeName:53,attributeKeyTypeList:54,attributeComment:55,ATTRIBUTE_WORD:56,attributeKeyType:57,",":58,ATTRIBUTE_KEY:59,COMMENT:60,cardinality:61,relType:62,ZERO_OR_ONE:63,ZERO_OR_MORE:64,ONE_OR_MORE:65,ONLY_ONE:66,MD_PARENT:67,NON_IDENTIFYING:68,IDENTIFYING:69,WORD:70,$accept:0,$end:1},terminals_:{2:"error",4:"ER_DIAGRAM",6:"EOF",8:"SPACE",10:"NEWLINE",13:"COLON",15:"STYLE_SEPARATOR",17:"BLOCK_START",19:"BLOCK_STOP",20:"SQS",21:"SQE",22:"title",23:"title_value",24:"acc_title",25:"acc_title_value",26:"acc_descr",27:"acc_descr_value",28:"acc_descr_multiline_value",33:"direction_tb",34:"direction_bt",35:"direction_rl",36:"direction_lr",37:"CLASSDEF",40:"UNICODE_TEXT",41:"STYLE_TEXT",42:"COMMA",43:"CLASS",44:"STYLE",47:"SEMI",48:"NUM",49:"BRKT",50:"ENTITY_NAME",56:"ATTRIBUTE_WORD",58:",",59:"ATTRIBUTE_KEY",60:"COMMENT",63:"ZERO_OR_ONE",64:"ZERO_OR_MORE",65:"ONE_OR_MORE",66:"ONLY_ONE",67:"MD_PARENT",68:"NON_IDENTIFYING",69:"IDENTIFYING",70:"WORD"},productions_:[0,[3,3],[5,0],[5,2],[7,2],[7,1],[7,1],[7,1],[9,5],[9,9],[9,7],[9,7],[9,4],[9,6],[9,3],[9,5],[9,1],[9,3],[9,7],[9,9],[9,6],[9,8],[9,4],[9,6],[9,2],[9,2],[9,2],[9,1],[9,1],[9,1],[9,1],[9,1],[29,1],[29,1],[29,1],[29,1],[30,4],[16,1],[16,1],[16,3],[16,3],[31,3],[32,4],[38,1],[38,3],[45,1],[45,2],[39,1],[39,1],[39,1],[46,1],[46,1],[46,1],[46,1],[11,1],[11,1],[18,1],[18,2],[51,2],[51,3],[51,3],[51,4],[52,1],[53,1],[54,1],[54,3],[57,1],[55,1],[12,3],[61,1],[61,1],[61,1],[61,1],[61,1],[62,1],[62,1],[14,1],[14,1],[14,1]],performAction:u(function(n,a,c,r,p,t,K){var e=t.length-1;switch(p){case 1:break;case 2:this.$=[];break;case 3:t[e-1].push(t[e]),this.$=t[e-1];break;case 4:case 5:this.$=t[e];break;case 6:case 7:this.$=[];break;case 8:r.addEntity(t[e-4]),r.addEntity(t[e-2]),r.addRelationship(t[e-4],t[e],t[e-2],t[e-3]);break;case 9:r.addEntity(t[e-8]),r.addEntity(t[e-4]),r.addRelationship(t[e-8],t[e],t[e-4],t[e-5]),r.setClass([t[e-8]],t[e-6]),r.setClass([t[e-4]],t[e-2]);break;case 10:r.addEntity(t[e-6]),r.addEntity(t[e-2]),r.addRelationship(t[e-6],t[e],t[e-2],t[e-3]),r.setClass([t[e-6]],t[e-4]);break;case 11:r.addEntity(t[e-6]),r.addEntity(t[e-4]),r.addRelationship(t[e-6],t[e],t[e-4],t[e-5]),r.setClass([t[e-4]],t[e-2]);break;case 12:r.addEntity(t[e-3]),r.addAttributes(t[e-3],t[e-1]);break;case 13:r.addEntity(t[e-5]),r.addAttributes(t[e-5],t[e-1]),r.setClass([t[e-5]],t[e-3]);break;case 14:r.addEntity(t[e-2]);break;case 15:r.addEntity(t[e-4]),r.setClass([t[e-4]],t[e-2]);break;case 16:r.addEntity(t[e]);break;case 17:r.addEntity(t[e-2]),r.setClass([t[e-2]],t[e]);break;case 18:r.addEntity(t[e-6],t[e-4]),r.addAttributes(t[e-6],t[e-1]);break;case 19:r.addEntity(t[e-8],t[e-6]),r.addAttributes(t[e-8],t[e-1]),r.setClass([t[e-8]],t[e-3]);break;case 20:r.addEntity(t[e-5],t[e-3]);break;case 21:r.addEntity(t[e-7],t[e-5]),r.setClass([t[e-7]],t[e-2]);break;case 22:r.addEntity(t[e-3],t[e-1]);break;case 23:r.addEntity(t[e-5],t[e-3]),r.setClass([t[e-5]],t[e]);break;case 24:case 25:this.$=t[e].trim(),r.setAccTitle(this.$);break;case 26:case 27:this.$=t[e].trim(),r.setAccDescription(this.$);break;case 32:r.setDirection("TB");break;case 33:r.setDirection("BT");break;case 34:r.setDirection("RL");break;case 35:r.setDirection("LR");break;case 36:this.$=t[e-3],r.addClass(t[e-2],t[e-1]);break;case 37:case 38:case 56:case 64:this.$=[t[e]];break;case 39:case 40:this.$=t[e-2].concat([t[e]]);break;case 41:this.$=t[e-2],r.setClass(t[e-1],t[e]);break;case 42:this.$=t[e-3],r.addCssStyles(t[e-2],t[e-1]);break;case 43:this.$=[t[e]];break;case 44:t[e-2].push(t[e]),this.$=t[e-2];break;case 46:this.$=t[e-1]+t[e];break;case 54:case 76:case 77:this.$=t[e].replace(/"/g,"");break;case 55:case 78:this.$=t[e];break;case 57:t[e].push(t[e-1]),this.$=t[e];break;case 58:this.$={type:t[e-1],name:t[e]};break;case 59:this.$={type:t[e-2],name:t[e-1],keys:t[e]};break;case 60:this.$={type:t[e-2],name:t[e-1],comment:t[e]};break;case 61:this.$={type:t[e-3],name:t[e-2],keys:t[e-1],comment:t[e]};break;case 62:case 63:case 66:this.$=t[e];break;case 65:t[e-2].push(t[e]),this.$=t[e-2];break;case 67:this.$=t[e].replace(/"/g,"");break;case 68:this.$={cardA:t[e],relType:t[e-1],cardB:t[e-2]};break;case 69:this.$=r.Cardinality.ZERO_OR_ONE;break;case 70:this.$=r.Cardinality.ZERO_OR_MORE;break;case 71:this.$=r.Cardinality.ONE_OR_MORE;break;case 72:this.$=r.Cardinality.ONLY_ONE;break;case 73:this.$=r.Cardinality.MD_PARENT;break;case 74:this.$=r.Identification.NON_IDENTIFYING;break;case 75:this.$=r.Identification.IDENTIFYING;break}},"anonymous"),table:[{3:1,4:[1,2]},{1:[3]},s(i,[2,2],{5:3}),{6:[1,4],7:5,8:[1,6],9:7,10:[1,8],11:9,22:l,24:d,26:o,28:h,29:14,30:15,31:16,32:17,33:y,34:_,35:E,36:V,37:Z,40:S,43:et,44:U,50:T},s(i,[2,7],{1:[2,1]}),s(i,[2,3]),{9:27,11:9,22:l,24:d,26:o,28:h,29:14,30:15,31:16,32:17,33:y,34:_,35:E,36:V,37:Z,40:S,43:et,44:U,50:T},s(i,[2,5]),s(i,[2,6]),s(i,[2,16],{12:28,61:32,15:[1,29],17:[1,30],20:[1,31],63:L,64:st,65:it,66:rt,67:nt}),{23:[1,38]},{25:[1,39]},{27:[1,40]},s(i,[2,27]),s(i,[2,28]),s(i,[2,29]),s(i,[2,30]),s(i,[2,31]),s(pt,[2,54]),s(pt,[2,55]),s(i,[2,32]),s(i,[2,33]),s(i,[2,34]),s(i,[2,35]),{16:41,40:O,41:A},{16:44,40:O,41:A},{16:45,40:O,41:A},s(i,[2,4]),{11:46,40:S,50:T},{16:47,40:O,41:A},{18:48,19:[1,49],51:50,52:51,56:M},{11:53,40:S,50:T},{62:54,68:[1,55],69:[1,56]},s(B,[2,69]),s(B,[2,70]),s(B,[2,71]),s(B,[2,72]),s(B,[2,73]),s(i,[2,24]),s(i,[2,25]),s(i,[2,26]),{13:F,38:57,41:Y,42:N,45:59,46:60,48:P,49:z},s(j,[2,37]),s(j,[2,38]),{16:65,40:O,41:A,42:N},{13:F,38:66,41:Y,42:N,45:59,46:60,48:P,49:z},{13:[1,67],15:[1,68]},s(i,[2,17],{61:32,12:69,17:[1,70],42:N,63:L,64:st,65:it,66:rt,67:nt}),{19:[1,71]},s(i,[2,14]),{18:72,19:[2,56],51:50,52:51,56:M},{53:73,56:[1,74]},{56:[2,62]},{21:[1,75]},{61:76,63:L,64:st,65:it,66:rt,67:nt},s(ft,[2,74]),s(ft,[2,75]),{6:yt,10:_t,39:77,42:gt,47:bt},{40:[1,82],41:[1,83]},s(mt,[2,43],{46:84,13:F,41:Y,48:P,49:z}),s(C,[2,45]),s(C,[2,50]),s(C,[2,51]),s(C,[2,52]),s(C,[2,53]),s(i,[2,41],{42:N}),{6:yt,10:_t,39:85,42:gt,47:bt},{14:86,40:W,50:Q,70:X},{16:90,40:O,41:A},{11:91,40:S,50:T},{18:92,19:[1,93],51:50,52:51,56:M},s(i,[2,12]),{19:[2,57]},s(G,[2,58],{54:94,55:95,57:96,59:Et,60:kt}),s([19,56,59,60],[2,63]),s(i,[2,22],{15:[1,100],17:[1,99]}),s([40,50],[2,68]),s(i,[2,36]),{13:F,41:Y,45:101,46:60,48:P,49:z},s(i,[2,47]),s(i,[2,48]),s(i,[2,49]),s(j,[2,39]),s(j,[2,40]),s(C,[2,46]),s(i,[2,42]),s(i,[2,8]),s(i,[2,76]),s(i,[2,77]),s(i,[2,78]),{13:[1,102],42:N},{13:[1,104],15:[1,103]},{19:[1,105]},s(i,[2,15]),s(G,[2,59],{55:106,58:[1,107],60:kt}),s(G,[2,60]),s(at,[2,64]),s(G,[2,67]),s(at,[2,66]),{18:108,19:[1,109],51:50,52:51,56:M},{16:110,40:O,41:A},s(mt,[2,44],{46:84,13:F,41:Y,48:P,49:z}),{14:111,40:W,50:Q,70:X},{16:112,40:O,41:A},{14:113,40:W,50:Q,70:X},s(i,[2,13]),s(G,[2,61]),{57:114,59:Et},{19:[1,115]},s(i,[2,20]),s(i,[2,23],{17:[1,116],42:N}),s(i,[2,11]),{13:[1,117],42:N},s(i,[2,10]),s(at,[2,65]),s(i,[2,18]),{18:118,19:[1,119],51:50,52:51,56:M},{14:120,40:W,50:Q,70:X},{19:[1,121]},s(i,[2,21]),s(i,[2,9]),s(i,[2,19])],defaultActions:{52:[2,62],72:[2,57]},parseError:u(function(n,a){if(a.recoverable)this.trace(n);else{var c=new Error(n);throw c.hash=a,c}},"parseError"),parse:u(function(n){var a=this,c=[0],r=[],p=[null],t=[],K=this.table,e="",H=0,St=0,xt=2,Tt=1,It=t.slice.call(arguments,1),f=Object.create(this.lexer),x={yy:{}};for(var lt in this.yy)Object.prototype.hasOwnProperty.call(this.yy,lt)&&(x.yy[lt]=this.yy[lt]);f.setInput(n,x.yy),x.yy.lexer=f,x.yy.parser=this,typeof f.yylloc>"u"&&(f.yylloc={});var ot=f.yylloc;t.push(ot);var Ct=f.options&&f.options.ranges;typeof x.yy.parseError=="function"?this.parseError=x.yy.parseError:this.parseError=Object.getPrototypeOf(this).parseError;function vt(b){c.length=c.length-2*b,p.length=p.length-b,t.length=t.length-b}u(vt,"popStack");function Ot(){var b;return b=r.pop()||f.lex()||Tt,typeof b!="number"&&(b instanceof Array&&(r=b,b=r.pop()),b=a.symbols_[b]||b),b}u(Ot,"lex");for(var g,I,m,ht,v={},J,k,At,$;;){if(I=c[c.length-1],this.defaultActions[I]?m=this.defaultActions[I]:((g===null||typeof g>"u")&&(g=Ot()),m=K[I]&&K[I][g]),typeof m>"u"||!m.length||!m[0]){var ut="";$=[];for(J in K[I])this.terminals_[J]&&J>xt&&$.push("'"+this.terminals_[J]+"'");f.showPosition?ut="Parse error on line "+(H+1)+`:
-`+f.showPosition()+`
-Expecting `+$.join(", ")+", got '"+(this.terminals_[g]||g)+"'":ut="Parse error on line "+(H+1)+": Unexpected "+(g==Tt?"end of input":"'"+(this.terminals_[g]||g)+"'"),this.parseError(ut,{text:f.match,token:this.terminals_[g]||g,line:f.yylineno,loc:ot,expected:$})}if(m[0]instanceof Array&&m.length>1)throw new Error("Parse Error: multiple actions possible at state: "+I+", token: "+g);switch(m[0]){case 1:c.push(g),p.push(f.yytext),t.push(f.yylloc),c.push(m[1]),g=null,St=f.yyleng,e=f.yytext,H=f.yylineno,ot=f.yylloc;break;case 2:if(k=this.productions_[m[1]][1],v.$=p[p.length-k],v._$={first_line:t[t.length-(k||1)].first_line,last_line:t[t.length-1].last_line,first_column:t[t.length-(k||1)].first_column,last_column:t[t.length-1].last_column},Ct&&(v._$.range=[t[t.length-(k||1)].range[0],t[t.length-1].range[1]]),ht=this.performAction.apply(v,[e,St,H,x.yy,m[1],p,t].concat(It)),typeof ht<"u")return ht;k&&(c=c.slice(0,-1*k*2),p=p.slice(0,-1*k),t=t.slice(0,-1*k)),c.push(this.productions_[m[1]][0]),p.push(v.$),t.push(v._$),At=K[c[c.length-2]][c[c.length-1]],c.push(At);break;case 3:return!0}}return!0},"parse")},Rt=(function(){var R={EOF:1,parseError:u(function(a,c){if(this.yy.parser)this.yy.parser.parseError(a,c);else throw new Error(a)},"parseError"),setInput:u(function(n,a){return this.yy=a||this.yy||{},this._input=n,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},"setInput"),input:u(function(){var n=this._input[0];this.yytext+=n,this.yyleng++,this.offset++,this.match+=n,this.matched+=n;var a=n.match(/(?:\r\n?|\n).*/g);return a?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),n},"input"),unput:u(function(n){var a=n.length,c=n.split(/(?:\r\n?|\n)/g);this._input=n+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-a),this.offset-=a;var r=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),c.length-1&&(this.yylineno-=c.length-1);var p=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:c?(c.length===r.length?this.yylloc.first_column:0)+r[r.length-c.length].length-c[0].length:this.yylloc.first_column-a},this.options.ranges&&(this.yylloc.range=[p[0],p[0]+this.yyleng-a]),this.yyleng=this.yytext.length,this},"unput"),more:u(function(){return this._more=!0,this},"more"),reject:u(function(){if(this.options.backtrack_lexer)this._backtrack=!0;else return this.parseError("Lexical error on line "+(this.yylineno+1)+`. You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).
-`+this.showPosition(),{text:"",token:null,line:this.yylineno});return this},"reject"),less:u(function(n){this.unput(this.match.slice(n))},"less"),pastInput:u(function(){var n=this.matched.substr(0,this.matched.length-this.match.length);return(n.length>20?"...":"")+n.substr(-20).replace(/\n/g,"")},"pastInput"),upcomingInput:u(function(){var n=this.match;return n.length<20&&(n+=this._input.substr(0,20-n.length)),(n.substr(0,20)+(n.length>20?"...":"")).replace(/\n/g,"")},"upcomingInput"),showPosition:u(function(){var n=this.pastInput(),a=new Array(n.length+1).join("-");return n+this.upcomingInput()+`
-`+a+"^"},"showPosition"),test_match:u(function(n,a){var c,r,p;if(this.options.backtrack_lexer&&(p={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(p.yylloc.range=this.yylloc.range.slice(0))),r=n[0].match(/(?:\r\n?|\n).*/g),r&&(this.yylineno+=r.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:r?r[r.length-1].length-r[r.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+n[0].length},this.yytext+=n[0],this.match+=n[0],this.matches=n,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(n[0].length),this.matched+=n[0],c=this.performAction.call(this,this.yy,this,a,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),c)return c;if(this._backtrack){for(var t in p)this[t]=p[t];return!1}return!1},"test_match"),next:u(function(){if(this.done)return this.EOF;this._input||(this.done=!0);var n,a,c,r;this._more||(this.yytext="",this.match="");for(var p=this._currentRules(),t=0;t<p.length;t++)if(c=this._input.match(this.rules[p[t]]),c&&(!a||c[0].length>a[0].length)){if(a=c,r=t,this.options.backtrack_lexer){if(n=this.test_match(c,p[t]),n!==!1)return n;if(this._backtrack){a=!1;continue}else return!1}else if(!this.options.flex)break}return a?(n=this.test_match(a,p[r]),n!==!1?n:!1):this._input===""?this.EOF:this.parseError("Lexical error on line "+(this.yylineno+1)+`. Unrecognized text.
-`+this.showPosition(),{text:"",token:null,line:this.yylineno})},"next"),lex:u(function(){var a=this.next();return a||this.lex()},"lex"),begin:u(function(a){this.conditionStack.push(a)},"begin"),popState:u(function(){var a=this.conditionStack.length-1;return a>0?this.conditionStack.pop():this.conditionStack[0]},"popState"),_currentRules:u(function(){return this.conditionStack.length&&this.conditionStack[this.conditionStack.length-1]?this.conditions[this.conditionStack[this.conditionStack.length-1]].rules:this.conditions.INITIAL.rules},"_currentRules"),topState:u(function(a){return a=this.conditionStack.length-1-Math.abs(a||0),a>=0?this.conditionStack[a]:"INITIAL"},"topState"),pushState:u(function(a){this.begin(a)},"pushState"),stateStackSize:u(function(){return this.conditionStack.length},"stateStackSize"),options:{"case-insensitive":!0},performAction:u(function(a,c,r,p){switch(r){case 0:return this.begin("acc_title"),24;case 1:return this.popState(),"acc_title_value";case 2:return this.begin("acc_descr"),26;case 3:return this.popState(),"acc_descr_value";case 4:this.begin("acc_descr_multiline");break;case 5:this.popState();break;case 6:return"acc_descr_multiline_value";case 7:return 33;case 8:return 34;case 9:return 35;case 10:return 36;case 11:return 10;case 12:break;case 13:return 8;case 14:return 50;case 15:return 70;case 16:return 4;case 17:return this.begin("block"),17;case 18:return 49;case 19:return 49;case 20:return 42;case 21:return 15;case 22:return 13;case 23:break;case 24:return 59;case 25:return 56;case 26:return 56;case 27:return 60;case 28:break;case 29:return this.popState(),19;case 30:return c.yytext[0];case 31:return 20;case 32:return 21;case 33:return this.begin("style"),44;case 34:return this.popState(),10;case 35:break;case 36:return 13;case 37:return 42;case 38:return 49;case 39:return this.begin("style"),37;case 40:return 43;case 41:return 63;case 42:return 65;case 43:return 65;case 44:return 65;case 45:return 63;case 46:return 63;case 47:return 64;case 48:return 64;case 49:return 64;case 50:return 64;case 51:return 64;case 52:return 65;case 53:return 64;case 54:return 65;case 55:return 66;case 56:return 66;case 57:return 66;case 58:return 66;case 59:return 63;case 60:return 64;case 61:return 65;case 62:return 67;case 63:return 68;case 64:return 69;case 65:return 69;case 66:return 68;case 67:return 68;case 68:return 68;case 69:return 41;case 70:return 47;case 71:return 40;case 72:return 48;case 73:return c.yytext[0];case 74:return 6}},"anonymous"),rules:[/^(?:accTitle\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*\{\s*)/i,/^(?:[\}])/i,/^(?:[^\}]*)/i,/^(?:.*direction\s+TB[^\n]*)/i,/^(?:.*direction\s+BT[^\n]*)/i,/^(?:.*direction\s+RL[^\n]*)/i,/^(?:.*direction\s+LR[^\n]*)/i,/^(?:[\n]+)/i,/^(?:\s+)/i,/^(?:[\s]+)/i,/^(?:"[^"%\r\n\v\b\\]+")/i,/^(?:"[^"]*")/i,/^(?:erDiagram\b)/i,/^(?:\{)/i,/^(?:#)/i,/^(?:#)/i,/^(?:,)/i,/^(?::::)/i,/^(?::)/i,/^(?:\s+)/i,/^(?:\b((?:PK)|(?:FK)|(?:UK))\b)/i,/^(?:([^\s]*)[~].*[~]([^\s]*))/i,/^(?:([\*A-Za-z_\u00C0-\uFFFF][A-Za-z0-9\-\_\[\]\(\)\u00C0-\uFFFF\*]*))/i,/^(?:"[^"]*")/i,/^(?:[\n]+)/i,/^(?:\})/i,/^(?:.)/i,/^(?:\[)/i,/^(?:\])/i,/^(?:style\b)/i,/^(?:[\n]+)/i,/^(?:\s+)/i,/^(?::)/i,/^(?:,)/i,/^(?:#)/i,/^(?:classDef\b)/i,/^(?:class\b)/i,/^(?:one or zero\b)/i,/^(?:one or more\b)/i,/^(?:one or many\b)/i,/^(?:1\+)/i,/^(?:\|o\b)/i,/^(?:zero or one\b)/i,/^(?:zero or more\b)/i,/^(?:zero or many\b)/i,/^(?:0\+)/i,/^(?:\}o\b)/i,/^(?:many\(0\))/i,/^(?:many\(1\))/i,/^(?:many\b)/i,/^(?:\}\|)/i,/^(?:one\b)/i,/^(?:only one\b)/i,/^(?:1\b)/i,/^(?:\|\|)/i,/^(?:o\|)/i,/^(?:o\{)/i,/^(?:\|\{)/i,/^(?:\s*u\b)/i,/^(?:\.\.)/i,/^(?:--)/i,/^(?:to\b)/i,/^(?:optionally to\b)/i,/^(?:\.-)/i,/^(?:-\.)/i,/^(?:([^\x00-\x7F]|\w|-|\*)+)/i,/^(?:;)/i,/^(?:([^\x00-\x7F]|\w|-|\*)+)/i,/^(?:[0-9])/i,/^(?:.)/i,/^(?:$)/i],conditions:{style:{rules:[34,35,36,37,38,69,70],inclusive:!1},acc_descr_multiline:{rules:[5,6],inclusive:!1},acc_descr:{rules:[3],inclusive:!1},acc_title:{rules:[1],inclusive:!1},block:{rules:[23,24,25,26,27,28,29,30],inclusive:!1},INITIAL:{rules:[0,2,4,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,31,32,33,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,71,72,73,74],inclusive:!0}}};return R})();ct.lexer=Rt;function q(){this.yy={}}return u(q,"Parser"),q.prototype=ct,ct.Parser=q,new q})();dt.parser=dt;var Xt=dt,w,qt=(w=class{constructor(){this.entities=new Map,this.relationships=[],this.classes=new Map,this.direction="TB",this.Cardinality={ZERO_OR_ONE:"ZERO_OR_ONE",ZERO_OR_MORE:"ZERO_OR_MORE",ONE_OR_MORE:"ONE_OR_MORE",ONLY_ONE:"ONLY_ONE",MD_PARENT:"MD_PARENT"},this.Identification={NON_IDENTIFYING:"NON_IDENTIFYING",IDENTIFYING:"IDENTIFYING"},this.setAccTitle=Vt,this.getAccTitle=Lt,this.setAccDescription=Mt,this.getAccDescription=Bt,this.setDiagramTitle=Ft,this.getDiagramTitle=Yt,this.getConfig=u(()=>tt().er,"getConfig"),this.clear(),this.addEntity=this.addEntity.bind(this),this.addAttributes=this.addAttributes.bind(this),this.addRelationship=this.addRelationship.bind(this),this.setDirection=this.setDirection.bind(this),this.addCssStyles=this.addCssStyles.bind(this),this.addClass=this.addClass.bind(this),this.setClass=this.setClass.bind(this),this.setAccTitle=this.setAccTitle.bind(this),this.setAccDescription=this.setAccDescription.bind(this)}addEntity(i,l=""){return this.entities.has(i)?!this.entities.get(i)?.alias&&l&&(this.entities.get(i).alias=l,D.info(`Add alias '${l}' to entity '${i}'`)):(this.entities.set(i,{id:`entity-${i}-${this.entities.size}`,label:i,attributes:[],alias:l,shape:"erBox",look:tt().look??"default",cssClasses:"default",cssStyles:[]}),D.info("Added new entity :",i)),this.entities.get(i)}getEntity(i){return this.entities.get(i)}getEntities(){return this.entities}getClasses(){return this.classes}addAttributes(i,l){const d=this.addEntity(i);let o;for(o=l.length-1;o>=0;o--)l[o].keys||(l[o].keys=[]),l[o].comment||(l[o].comment=""),d.attributes.push(l[o]),D.debug("Added attribute ",l[o].name)}addRelationship(i,l,d,o){const h=this.entities.get(i),y=this.entities.get(d);if(!h||!y)return;const _={entityA:h.id,roleA:l,entityB:y.id,relSpec:o};this.relationships.push(_),D.debug("Added new relationship :",_)}getRelationships(){return this.relationships}getDirection(){return this.direction}setDirection(i){this.direction=i}getCompiledStyles(i){let l=[];for(const d of i){const o=this.classes.get(d);o?.styles&&(l=[...l,...o.styles??[]].map(h=>h.trim())),o?.textStyles&&(l=[...l,...o.textStyles??[]].map(h=>h.trim()))}return l}addCssStyles(i,l){for(const d of i){const o=this.entities.get(d);if(!l||!o)return;for(const h of l)o.cssStyles.push(h)}}addClass(i,l){i.forEach(d=>{let o=this.classes.get(d);o===void 0&&(o={id:d,styles:[],textStyles:[]},this.classes.set(d,o)),l&&l.forEach(function(h){if(/color/.exec(h)){const y=h.replace("fill","bgFill");o.textStyles.push(y)}o.styles.push(h)})})}setClass(i,l){for(const d of i){const o=this.entities.get(d);if(o)for(const h of l)o.cssClasses+=" "+h}}clear(){this.entities=new Map,this.classes=new Map,this.relationships=[],Pt()}getData(){const i=[],l=[],d=tt();for(const h of this.entities.keys()){const y=this.entities.get(h);y&&(y.cssCompiledStyles=this.getCompiledStyles(y.cssClasses.split(" ")),i.push(y))}let o=0;for(const h of this.relationships){const y={id:zt(h.entityA,h.entityB,{prefix:"id",counter:o++}),type:"normal",curve:"basis",start:h.entityA,end:h.entityB,label:h.roleA,labelpos:"c",thickness:"normal",classes:"relationshipLine",arrowTypeStart:h.relSpec.cardB.toLowerCase(),arrowTypeEnd:h.relSpec.cardA.toLowerCase(),pattern:h.relSpec.relType=="IDENTIFYING"?"solid":"dashed",look:d.look};l.push(y)}return{nodes:i,edges:l,other:{},config:d,direction:"TB"}}},u(w,"ErDB"),w),Nt={};Kt(Nt,{draw:()=>Ht});var Ht=u(async function(s,i,l,d){D.info("REF0:"),D.info("Drawing er diagram (unified)",i);const{securityLevel:o,er:h,layout:y}=tt(),_=d.db.getData(),E=Dt(i,o);_.type=d.type,_.layoutAlgorithm=Zt(y),_.config.flowchart.nodeSpacing=h?.nodeSpacing||140,_.config.flowchart.rankSpacing=h?.rankSpacing||80,_.direction=d.db.getDirection(),_.markers=["only_one","zero_or_one","one_or_more","zero_or_more"],_.diagramId=i,await Ut(_,E),_.layoutAlgorithm==="elk"&&E.select(".edges").lower();const V=E.selectAll('[id*="-background"]');Array.from(V).length>0&&V.each(function(){const S=jt(this),U=S.attr("id").replace("-background",""),T=E.select(`#${CSS.escape(U)}`);if(!T.empty()){const L=T.attr("transform");S.attr("transform",L)}});const Z=8;Wt.insertTitle(E,"erDiagramTitleText",h?.titleTopMargin??25,d.db.getDiagramTitle()),wt(E,Z,"erDiagram",h?.useMaxWidth??!0)},"draw"),Jt=u((s,i)=>{const l=Qt,d=l(s,"r"),o=l(s,"g"),h=l(s,"b");return Gt(d,o,h,i)},"fade"),$t=u(s=>`
-  .entityBox {
-    fill: ${s.mainBkg};
-    stroke: ${s.nodeBorder};
-  }
-
-  .relationshipLabelBox {
-    fill: ${s.tertiaryColor};
-    opacity: 0.7;
-    background-color: ${s.tertiaryColor};
-      rect {
-        opacity: 0.5;
-      }
-  }
-
-  .labelBkg {
-    background-color: ${Jt(s.tertiaryColor,.5)};
-  }
-
-  .edgeLabel .label {
-    fill: ${s.nodeBorder};
-    font-size: 14px;
-  }
-
-  .label {
-    font-family: ${s.fontFamily};
-    color: ${s.nodeTextColor||s.textColor};
-  }
-
-  .edge-pattern-dashed {
-    stroke-dasharray: 8,8;
-  }
-
-  .node rect,
-  .node circle,
-  .node ellipse,
-  .node polygon
-  {
-    fill: ${s.mainBkg};
-    stroke: ${s.nodeBorder};
-    stroke-width: 1px;
-  }
-
-  .relationshipLine {
-    stroke: ${s.lineColor};
-    stroke-width: 1;
-    fill: none;
-  }
-
-  .marker {
-    fill: none !important;
-    stroke: ${s.lineColor} !important;
-    stroke-width: 1;
-  }
-`,"getStyles"),te=$t,ne={parser:Xt,get db(){return new qt},renderer:Nt,styles:te};export{ne as diagram};
diff --git a/docs/dist/assets/flowDiagram-NV44I4VS-C8-lZvFy.js b/docs/dist/assets/flowDiagram-NV44I4VS-C8-lZvFy.js
deleted file mode 100644
index 3b795c83..00000000
--- a/docs/dist/assets/flowDiagram-NV44I4VS-C8-lZvFy.js
+++ /dev/null
@@ -1,162 +0,0 @@
-import{g as qt}from"./chunk-FMBD7UC4-Bm3lI1XN.js";import{_ as m,n as Ot,l as $,c as b1,d as E1,o as Ht,r as Xt,u as it,b as Qt,s as Jt,p as Zt,a as $t,g as te,q as ee,k as se,t as ie,J as re,v as ae,x as st,y as ne,z as ue,A as oe}from"./index-BxX29htg.js";import{g as le}from"./chunk-55IACEB6-BE1gdz1f.js";import{s as ce}from"./chunk-QN33PNHL-1s4FuBGd.js";import{c as he}from"./channel-kd1Rx1KT.js";var de="flowchart-",G1,pe=(G1=class{constructor(){this.vertexCounter=0,this.config=b1(),this.vertices=new Map,this.edges=[],this.classes=new Map,this.subGraphs=[],this.subGraphLookup=new Map,this.tooltips=new Map,this.subCount=0,this.firstGraphFlag=!0,this.secCount=-1,this.posCrossRef=[],this.funs=[],this.setAccTitle=Qt,this.setAccDescription=Jt,this.setDiagramTitle=Zt,this.getAccTitle=$t,this.getAccDescription=te,this.getDiagramTitle=ee,this.funs.push(this.setupToolTips.bind(this)),this.addVertex=this.addVertex.bind(this),this.firstGraph=this.firstGraph.bind(this),this.setDirection=this.setDirection.bind(this),this.addSubGraph=this.addSubGraph.bind(this),this.addLink=this.addLink.bind(this),this.setLink=this.setLink.bind(this),this.updateLink=this.updateLink.bind(this),this.addClass=this.addClass.bind(this),this.setClass=this.setClass.bind(this),this.destructLink=this.destructLink.bind(this),this.setClickEvent=this.setClickEvent.bind(this),this.setTooltip=this.setTooltip.bind(this),this.updateLinkInterpolate=this.updateLinkInterpolate.bind(this),this.setClickFun=this.setClickFun.bind(this),this.bindFunctions=this.bindFunctions.bind(this),this.lex={firstGraph:this.firstGraph.bind(this)},this.clear(),this.setGen("gen-2")}sanitizeText(i){return se.sanitizeText(i,this.config)}lookUpDomId(i){for(const r of this.vertices.values())if(r.id===i)return r.domId;return i}addVertex(i,r,a,n,l,g,c={},b){if(!i||i.trim().length===0)return;let u;if(b!==void 0){let k;b.includes(`
-`)?k=b+`
-`:k=`{
-`+b+`
-}`,u=ie(k,{schema:re})}const A=this.edges.find(k=>k.id===i);if(A){const k=u;k?.animate!==void 0&&(A.animate=k.animate),k?.animation!==void 0&&(A.animation=k.animation),k?.curve!==void 0&&(A.interpolate=k.curve);return}let y,f=this.vertices.get(i);if(f===void 0&&(f={id:i,labelType:"text",domId:de+i+"-"+this.vertexCounter,styles:[],classes:[]},this.vertices.set(i,f)),this.vertexCounter++,r!==void 0?(this.config=b1(),y=this.sanitizeText(r.text.trim()),f.labelType=r.type,y.startsWith('"')&&y.endsWith('"')&&(y=y.substring(1,y.length-1)),f.text=y):f.text===void 0&&(f.text=i),a!==void 0&&(f.type=a),n?.forEach(k=>{f.styles.push(k)}),l?.forEach(k=>{f.classes.push(k)}),g!==void 0&&(f.dir=g),f.props===void 0?f.props=c:c!==void 0&&Object.assign(f.props,c),u!==void 0){if(u.shape){if(u.shape!==u.shape.toLowerCase()||u.shape.includes("_"))throw new Error(`No such shape: ${u.shape}. Shape names should be lowercase.`);if(!ae(u.shape))throw new Error(`No such shape: ${u.shape}.`);f.type=u?.shape}u?.label&&(f.text=u?.label),u?.icon&&(f.icon=u?.icon,!u.label?.trim()&&f.text===i&&(f.text="")),u?.form&&(f.form=u?.form),u?.pos&&(f.pos=u?.pos),u?.img&&(f.img=u?.img,!u.label?.trim()&&f.text===i&&(f.text="")),u?.constraint&&(f.constraint=u.constraint),u.w&&(f.assetWidth=Number(u.w)),u.h&&(f.assetHeight=Number(u.h))}}addSingleLink(i,r,a,n){const c={start:i,end:r,type:void 0,text:"",labelType:"text",classes:[],isUserDefinedId:!1,interpolate:this.edges.defaultInterpolate};$.info("abc78 Got edge...",c);const b=a.text;if(b!==void 0&&(c.text=this.sanitizeText(b.text.trim()),c.text.startsWith('"')&&c.text.endsWith('"')&&(c.text=c.text.substring(1,c.text.length-1)),c.labelType=b.type),a!==void 0&&(c.type=a.type,c.stroke=a.stroke,c.length=a.length>10?10:a.length),n&&!this.edges.some(u=>u.id===n))c.id=n,c.isUserDefinedId=!0;else{const u=this.edges.filter(A=>A.start===c.start&&A.end===c.end);u.length===0?c.id=st(c.start,c.end,{counter:0,prefix:"L"}):c.id=st(c.start,c.end,{counter:u.length+1,prefix:"L"})}if(this.edges.length<(this.config.maxEdges??500))$.info("Pushing edge..."),this.edges.push(c);else throw new Error(`Edge limit exceeded. ${this.edges.length} edges found, but the limit is ${this.config.maxEdges}.
-
-Initialize mermaid with maxEdges set to a higher number to allow more edges.
-You cannot set this config via configuration inside the diagram as it is a secure config.
-You have to call mermaid.initialize.`)}isLinkData(i){return i!==null&&typeof i=="object"&&"id"in i&&typeof i.id=="string"}addLink(i,r,a){const n=this.isLinkData(a)?a.id.replace("@",""):void 0;$.info("addLink",i,r,n);for(const l of i)for(const g of r){const c=l===i[i.length-1],b=g===r[0];c&&b?this.addSingleLink(l,g,a,n):this.addSingleLink(l,g,a,void 0)}}updateLinkInterpolate(i,r){i.forEach(a=>{a==="default"?this.edges.defaultInterpolate=r:this.edges[a].interpolate=r})}updateLink(i,r){i.forEach(a=>{if(typeof a=="number"&&a>=this.edges.length)throw new Error(`The index ${a} for linkStyle is out of bounds. Valid indices for linkStyle are between 0 and ${this.edges.length-1}. (Help: Ensure that the index is within the range of existing edges.)`);a==="default"?this.edges.defaultStyle=r:(this.edges[a].style=r,(this.edges[a]?.style?.length??0)>0&&!this.edges[a]?.style?.some(n=>n?.startsWith("fill"))&&this.edges[a]?.style?.push("fill:none"))})}addClass(i,r){const a=r.join().replace(/\\,/g,"§§§").replace(/,/g,";").replace(/§§§/g,",").split(";");i.split(",").forEach(n=>{let l=this.classes.get(n);l===void 0&&(l={id:n,styles:[],textStyles:[]},this.classes.set(n,l)),a?.forEach(g=>{if(/color/.exec(g)){const c=g.replace("fill","bgFill");l.textStyles.push(c)}l.styles.push(g)})})}setDirection(i){this.direction=i.trim(),/.*</.exec(this.direction)&&(this.direction="RL"),/.*\^/.exec(this.direction)&&(this.direction="BT"),/.*>/.exec(this.direction)&&(this.direction="LR"),/.*v/.exec(this.direction)&&(this.direction="TB"),this.direction==="TD"&&(this.direction="TB")}setClass(i,r){for(const a of i.split(",")){const n=this.vertices.get(a);n&&n.classes.push(r);const l=this.edges.find(c=>c.id===a);l&&l.classes.push(r);const g=this.subGraphLookup.get(a);g&&g.classes.push(r)}}setTooltip(i,r){if(r!==void 0){r=this.sanitizeText(r);for(const a of i.split(","))this.tooltips.set(this.version==="gen-1"?this.lookUpDomId(a):a,r)}}setClickFun(i,r,a){const n=this.lookUpDomId(i);if(b1().securityLevel!=="loose"||r===void 0)return;let l=[];if(typeof a=="string"){l=a.split(/,(?=(?:(?:[^"]*"){2})*[^"]*$)/);for(let c=0;c<l.length;c++){let b=l[c].trim();b.startsWith('"')&&b.endsWith('"')&&(b=b.substr(1,b.length-2)),l[c]=b}}l.length===0&&l.push(i);const g=this.vertices.get(i);g&&(g.haveCallback=!0,this.funs.push(()=>{const c=document.querySelector(`[id="${n}"]`);c!==null&&c.addEventListener("click",()=>{it.runFunc(r,...l)},!1)}))}setLink(i,r,a){i.split(",").forEach(n=>{const l=this.vertices.get(n);l!==void 0&&(l.link=it.formatUrl(r,this.config),l.linkTarget=a)}),this.setClass(i,"clickable")}getTooltip(i){return this.tooltips.get(i)}setClickEvent(i,r,a){i.split(",").forEach(n=>{this.setClickFun(n,r,a)}),this.setClass(i,"clickable")}bindFunctions(i){this.funs.forEach(r=>{r(i)})}getDirection(){return this.direction?.trim()}getVertices(){return this.vertices}getEdges(){return this.edges}getClasses(){return this.classes}setupToolTips(i){let r=E1(".mermaidTooltip");(r._groups||r)[0][0]===null&&(r=E1("body").append("div").attr("class","mermaidTooltip").style("opacity",0)),E1(i).select("svg").selectAll("g.node").on("mouseover",l=>{const g=E1(l.currentTarget);if(g.attr("title")===null)return;const b=l.currentTarget?.getBoundingClientRect();r.transition().duration(200).style("opacity",".9"),r.text(g.attr("title")).style("left",window.scrollX+b.left+(b.right-b.left)/2+"px").style("top",window.scrollY+b.bottom+"px"),r.html(r.html().replace(/&lt;br\/&gt;/g,"<br/>")),g.classed("hover",!0)}).on("mouseout",l=>{r.transition().duration(500).style("opacity",0),E1(l.currentTarget).classed("hover",!1)})}clear(i="gen-2"){this.vertices=new Map,this.classes=new Map,this.edges=[],this.funs=[this.setupToolTips.bind(this)],this.subGraphs=[],this.subGraphLookup=new Map,this.subCount=0,this.tooltips=new Map,this.firstGraphFlag=!0,this.version=i,this.config=b1(),ne()}setGen(i){this.version=i||"gen-2"}defaultStyle(){return"fill:#ffa;stroke: #f66; stroke-width: 3px; stroke-dasharray: 5, 5;fill:#ffa;stroke: #666;"}addSubGraph(i,r,a){let n=i.text.trim(),l=a.text;i===a&&/\s/.exec(a.text)&&(n=void 0);const c=m(f=>{const k={boolean:{},number:{},string:{}},x=[];let T;return{nodeList:f.filter(function(W){const J=typeof W;return W.stmt&&W.stmt==="dir"?(T=W.value,!1):W.trim()===""?!1:J in k?k[J].hasOwnProperty(W)?!1:k[J][W]=!0:x.includes(W)?!1:x.push(W)}),dir:T}},"uniq")(r.flat()),b=c.nodeList;let u=c.dir;const A=b1().flowchart??{};if(u=u??(A.inheritDir?this.getDirection()??b1().direction??void 0:void 0),this.version==="gen-1")for(let f=0;f<b.length;f++)b[f]=this.lookUpDomId(b[f]);n=n??"subGraph"+this.subCount,l=l||"",l=this.sanitizeText(l),this.subCount=this.subCount+1;const y={id:n,nodes:b,title:l.trim(),classes:[],dir:u,labelType:a.type};return $.info("Adding",y.id,y.nodes,y.dir),y.nodes=this.makeUniq(y,this.subGraphs).nodes,this.subGraphs.push(y),this.subGraphLookup.set(n,y),n}getPosForId(i){for(const[r,a]of this.subGraphs.entries())if(a.id===i)return r;return-1}indexNodes2(i,r){const a=this.subGraphs[r].nodes;if(this.secCount=this.secCount+1,this.secCount>2e3)return{result:!1,count:0};if(this.posCrossRef[this.secCount]=r,this.subGraphs[r].id===i)return{result:!0,count:0};let n=0,l=1;for(;n<a.length;){const g=this.getPosForId(a[n]);if(g>=0){const c=this.indexNodes2(i,g);if(c.result)return{result:!0,count:l+c.count};l=l+c.count}n=n+1}return{result:!1,count:l}}getDepthFirstPos(i){return this.posCrossRef[i]}indexNodes(){this.secCount=-1,this.subGraphs.length>0&&this.indexNodes2("none",this.subGraphs.length-1)}getSubGraphs(){return this.subGraphs}firstGraph(){return this.firstGraphFlag?(this.firstGraphFlag=!1,!0):!1}destructStartLink(i){let r=i.trim(),a="arrow_open";switch(r[0]){case"<":a="arrow_point",r=r.slice(1);break;case"x":a="arrow_cross",r=r.slice(1);break;case"o":a="arrow_circle",r=r.slice(1);break}let n="normal";return r.includes("=")&&(n="thick"),r.includes(".")&&(n="dotted"),{type:a,stroke:n}}countChar(i,r){const a=r.length;let n=0;for(let l=0;l<a;++l)r[l]===i&&++n;return n}destructEndLink(i){const r=i.trim();let a=r.slice(0,-1),n="arrow_open";switch(r.slice(-1)){case"x":n="arrow_cross",r.startsWith("x")&&(n="double_"+n,a=a.slice(1));break;case">":n="arrow_point",r.startsWith("<")&&(n="double_"+n,a=a.slice(1));break;case"o":n="arrow_circle",r.startsWith("o")&&(n="double_"+n,a=a.slice(1));break}let l="normal",g=a.length-1;a.startsWith("=")&&(l="thick"),a.startsWith("~")&&(l="invisible");const c=this.countChar(".",a);return c&&(l="dotted",g=c),{type:n,stroke:l,length:g}}destructLink(i,r){const a=this.destructEndLink(i);let n;if(r){if(n=this.destructStartLink(r),n.stroke!==a.stroke)return{type:"INVALID",stroke:"INVALID"};if(n.type==="arrow_open")n.type=a.type;else{if(n.type!==a.type)return{type:"INVALID",stroke:"INVALID"};n.type="double_"+n.type}return n.type==="double_arrow"&&(n.type="double_arrow_point"),n.length=a.length,n}return a}exists(i,r){for(const a of i)if(a.nodes.includes(r))return!0;return!1}makeUniq(i,r){const a=[];return i.nodes.forEach((n,l)=>{this.exists(r,n)||a.push(i.nodes[l])}),{nodes:a}}getTypeFromVertex(i){if(i.img)return"imageSquare";if(i.icon)return i.form==="circle"?"iconCircle":i.form==="square"?"iconSquare":i.form==="rounded"?"iconRounded":"icon";switch(i.type){case"square":case void 0:return"squareRect";case"round":return"roundedRect";case"ellipse":return"ellipse";default:return i.type}}findNode(i,r){return i.find(a=>a.id===r)}destructEdgeType(i){let r="none",a="arrow_point";switch(i){case"arrow_point":case"arrow_circle":case"arrow_cross":a=i;break;case"double_arrow_point":case"double_arrow_circle":case"double_arrow_cross":r=i.replace("double_",""),a=r;break}return{arrowTypeStart:r,arrowTypeEnd:a}}addNodeFromVertex(i,r,a,n,l,g){const c=a.get(i.id),b=n.get(i.id)??!1,u=this.findNode(r,i.id);if(u)u.cssStyles=i.styles,u.cssCompiledStyles=this.getCompiledStyles(i.classes),u.cssClasses=i.classes.join(" ");else{const A={id:i.id,label:i.text,labelStyle:"",parentId:c,padding:l.flowchart?.padding||8,cssStyles:i.styles,cssCompiledStyles:this.getCompiledStyles(["default","node",...i.classes]),cssClasses:"default "+i.classes.join(" "),dir:i.dir,domId:i.domId,look:g,link:i.link,linkTarget:i.linkTarget,tooltip:this.getTooltip(i.id),icon:i.icon,pos:i.pos,img:i.img,assetWidth:i.assetWidth,assetHeight:i.assetHeight,constraint:i.constraint};b?r.push({...A,isGroup:!0,shape:"rect"}):r.push({...A,isGroup:!1,shape:this.getTypeFromVertex(i)})}}getCompiledStyles(i){let r=[];for(const a of i){const n=this.classes.get(a);n?.styles&&(r=[...r,...n.styles??[]].map(l=>l.trim())),n?.textStyles&&(r=[...r,...n.textStyles??[]].map(l=>l.trim()))}return r}getData(){const i=b1(),r=[],a=[],n=this.getSubGraphs(),l=new Map,g=new Map;for(let u=n.length-1;u>=0;u--){const A=n[u];A.nodes.length>0&&g.set(A.id,!0);for(const y of A.nodes)l.set(y,A.id)}for(let u=n.length-1;u>=0;u--){const A=n[u];r.push({id:A.id,label:A.title,labelStyle:"",parentId:l.get(A.id),padding:8,cssCompiledStyles:this.getCompiledStyles(A.classes),cssClasses:A.classes.join(" "),shape:"rect",dir:A.dir,isGroup:!0,look:i.look})}this.getVertices().forEach(u=>{this.addNodeFromVertex(u,r,l,g,i,i.look||"classic")});const b=this.getEdges();return b.forEach((u,A)=>{const{arrowTypeStart:y,arrowTypeEnd:f}=this.destructEdgeType(u.type),k=[...b.defaultStyle??[]];u.style&&k.push(...u.style);const x={id:st(u.start,u.end,{counter:A,prefix:"L"},u.id),isUserDefinedId:u.isUserDefinedId,start:u.start,end:u.end,type:u.type??"normal",label:u.text,labelpos:"c",thickness:u.stroke,minlen:u.length,classes:u?.stroke==="invisible"?"":"edge-thickness-normal edge-pattern-solid flowchart-link",arrowTypeStart:u?.stroke==="invisible"||u?.type==="arrow_open"?"none":y,arrowTypeEnd:u?.stroke==="invisible"||u?.type==="arrow_open"?"none":f,arrowheadStyle:"fill: #333",cssCompiledStyles:this.getCompiledStyles(u.classes),labelStyle:k,style:k,pattern:u.stroke,look:i.look,animate:u.animate,animation:u.animation,curve:u.interpolate||this.edges.defaultInterpolate||i.flowchart?.curve};a.push(x)}),{nodes:r,edges:a,other:{},config:i}}defaultConfig(){return ue.flowchart}},m(G1,"FlowDB"),G1),fe=m(function(s,i){return i.db.getClasses()},"getClasses"),ge=m(async function(s,i,r,a){$.info("REF0:"),$.info("Drawing state diagram (v2)",i);const{securityLevel:n,flowchart:l,layout:g}=b1();let c;n==="sandbox"&&(c=E1("#i"+i));const b=n==="sandbox"?c.nodes()[0].contentDocument:document;$.debug("Before getData: ");const u=a.db.getData();$.debug("Data: ",u);const A=le(i,n),y=a.db.getDirection();u.type=a.type,u.layoutAlgorithm=Ht(g),u.layoutAlgorithm==="dagre"&&g==="elk"&&$.warn("flowchart-elk was moved to an external package in Mermaid v11. Please refer [release notes](https://github.com/mermaid-js/mermaid/releases/tag/v11.0.0) for more details. This diagram will be rendered using `dagre` layout as a fallback."),u.direction=y,u.nodeSpacing=l?.nodeSpacing||50,u.rankSpacing=l?.rankSpacing||50,u.markers=["point","circle","cross"],u.diagramId=i,$.debug("REF1:",u),await Xt(u,A);const f=u.config.flowchart?.diagramPadding??8;it.insertTitle(A,"flowchartTitleText",l?.titleTopMargin||0,a.db.getDiagramTitle()),ce(A,f,"flowchart",l?.useMaxWidth||!1);for(const k of u.nodes){const x=E1(`#${i} [id="${k.id}"]`);if(!x||!k.link)continue;const T=b.createElementNS("http://www.w3.org/2000/svg","a");T.setAttributeNS("http://www.w3.org/2000/svg","class",k.cssClasses),T.setAttributeNS("http://www.w3.org/2000/svg","rel","noopener"),n==="sandbox"?T.setAttributeNS("http://www.w3.org/2000/svg","target","_top"):k.linkTarget&&T.setAttributeNS("http://www.w3.org/2000/svg","target",k.linkTarget);const d1=x.insert(function(){return T},":first-child"),W=x.select(".label-container");W&&d1.append(function(){return W.node()});const J=x.select(".label");J&&d1.append(function(){return J.node()})}},"draw"),be={getClasses:fe,draw:ge},rt=(function(){var s=m(function(g1,h,d,p){for(d=d||{},p=g1.length;p--;d[g1[p]]=h);return d},"o"),i=[1,4],r=[1,3],a=[1,5],n=[1,8,9,10,11,27,34,36,38,44,60,84,85,86,87,88,89,102,105,106,109,111,114,115,116,121,122,123,124],l=[2,2],g=[1,13],c=[1,14],b=[1,15],u=[1,16],A=[1,23],y=[1,25],f=[1,26],k=[1,27],x=[1,49],T=[1,48],d1=[1,29],W=[1,30],J=[1,31],O1=[1,32],M1=[1,33],V=[1,44],w=[1,46],I=[1,42],R=[1,47],N=[1,43],G=[1,50],P=[1,45],O=[1,51],M=[1,52],U1=[1,34],W1=[1,35],z1=[1,36],j1=[1,37],p1=[1,57],F=[1,8,9,10,11,27,32,34,36,38,44,60,84,85,86,87,88,89,102,105,106,109,111,114,115,116,121,122,123,124],t1=[1,61],e1=[1,60],s1=[1,62],C1=[8,9,11,75,77,78],at=[1,78],D1=[1,91],S1=[1,96],x1=[1,95],T1=[1,92],y1=[1,88],F1=[1,94],_1=[1,90],B1=[1,97],v1=[1,93],L1=[1,98],V1=[1,89],A1=[8,9,10,11,40,75,77,78],z=[8,9,10,11,40,46,75,77,78],q=[8,9,10,11,29,40,44,46,48,50,52,54,56,58,60,63,65,67,68,70,75,77,78,89,102,105,106,109,111,114,115,116],nt=[8,9,11,44,60,75,77,78,89,102,105,106,109,111,114,115,116],w1=[44,60,89,102,105,106,109,111,114,115,116],ut=[1,121],ot=[1,122],K1=[1,124],Y1=[1,123],lt=[44,60,62,74,89,102,105,106,109,111,114,115,116],ct=[1,133],ht=[1,147],dt=[1,148],pt=[1,149],ft=[1,150],gt=[1,135],bt=[1,137],At=[1,141],kt=[1,142],mt=[1,143],Et=[1,144],Ct=[1,145],Dt=[1,146],St=[1,151],xt=[1,152],Tt=[1,131],yt=[1,132],Ft=[1,139],_t=[1,134],Bt=[1,138],vt=[1,136],Q1=[8,9,10,11,27,32,34,36,38,44,60,84,85,86,87,88,89,102,105,106,109,111,114,115,116,121,122,123,124],Lt=[1,154],Vt=[1,156],v=[8,9,11],H=[8,9,10,11,14,44,60,89,105,106,109,111,114,115,116],E=[1,176],j=[1,172],K=[1,173],C=[1,177],D=[1,174],S=[1,175],I1=[77,116,119],_=[8,9,10,11,12,14,27,29,32,44,60,75,84,85,86,87,88,89,90,105,109,111,114,115,116],wt=[10,106],f1=[31,49,51,53,55,57,62,64,66,67,69,71,116,117,118],i1=[1,247],r1=[1,245],a1=[1,249],n1=[1,243],u1=[1,244],o1=[1,246],l1=[1,248],c1=[1,250],R1=[1,268],It=[8,9,11,106],Z=[8,9,10,11,60,84,105,106,109,110,111,112],J1={trace:m(function(){},"trace"),yy:{},symbols_:{error:2,start:3,graphConfig:4,document:5,line:6,statement:7,SEMI:8,NEWLINE:9,SPACE:10,EOF:11,GRAPH:12,NODIR:13,DIR:14,FirstStmtSeparator:15,ending:16,endToken:17,spaceList:18,spaceListNewline:19,vertexStatement:20,separator:21,styleStatement:22,linkStyleStatement:23,classDefStatement:24,classStatement:25,clickStatement:26,subgraph:27,textNoTags:28,SQS:29,text:30,SQE:31,end:32,direction:33,acc_title:34,acc_title_value:35,acc_descr:36,acc_descr_value:37,acc_descr_multiline_value:38,shapeData:39,SHAPE_DATA:40,link:41,node:42,styledVertex:43,AMP:44,vertex:45,STYLE_SEPARATOR:46,idString:47,DOUBLECIRCLESTART:48,DOUBLECIRCLEEND:49,PS:50,PE:51,"(-":52,"-)":53,STADIUMSTART:54,STADIUMEND:55,SUBROUTINESTART:56,SUBROUTINEEND:57,VERTEX_WITH_PROPS_START:58,"NODE_STRING[field]":59,COLON:60,"NODE_STRING[value]":61,PIPE:62,CYLINDERSTART:63,CYLINDEREND:64,DIAMOND_START:65,DIAMOND_STOP:66,TAGEND:67,TRAPSTART:68,TRAPEND:69,INVTRAPSTART:70,INVTRAPEND:71,linkStatement:72,arrowText:73,TESTSTR:74,START_LINK:75,edgeText:76,LINK:77,LINK_ID:78,edgeTextToken:79,STR:80,MD_STR:81,textToken:82,keywords:83,STYLE:84,LINKSTYLE:85,CLASSDEF:86,CLASS:87,CLICK:88,DOWN:89,UP:90,textNoTagsToken:91,stylesOpt:92,"idString[vertex]":93,"idString[class]":94,CALLBACKNAME:95,CALLBACKARGS:96,HREF:97,LINK_TARGET:98,"STR[link]":99,"STR[tooltip]":100,alphaNum:101,DEFAULT:102,numList:103,INTERPOLATE:104,NUM:105,COMMA:106,style:107,styleComponent:108,NODE_STRING:109,UNIT:110,BRKT:111,PCT:112,idStringToken:113,MINUS:114,MULT:115,UNICODE_TEXT:116,TEXT:117,TAGSTART:118,EDGE_TEXT:119,alphaNumToken:120,direction_tb:121,direction_bt:122,direction_rl:123,direction_lr:124,$accept:0,$end:1},terminals_:{2:"error",8:"SEMI",9:"NEWLINE",10:"SPACE",11:"EOF",12:"GRAPH",13:"NODIR",14:"DIR",27:"subgraph",29:"SQS",31:"SQE",32:"end",34:"acc_title",35:"acc_title_value",36:"acc_descr",37:"acc_descr_value",38:"acc_descr_multiline_value",40:"SHAPE_DATA",44:"AMP",46:"STYLE_SEPARATOR",48:"DOUBLECIRCLESTART",49:"DOUBLECIRCLEEND",50:"PS",51:"PE",52:"(-",53:"-)",54:"STADIUMSTART",55:"STADIUMEND",56:"SUBROUTINESTART",57:"SUBROUTINEEND",58:"VERTEX_WITH_PROPS_START",59:"NODE_STRING[field]",60:"COLON",61:"NODE_STRING[value]",62:"PIPE",63:"CYLINDERSTART",64:"CYLINDEREND",65:"DIAMOND_START",66:"DIAMOND_STOP",67:"TAGEND",68:"TRAPSTART",69:"TRAPEND",70:"INVTRAPSTART",71:"INVTRAPEND",74:"TESTSTR",75:"START_LINK",77:"LINK",78:"LINK_ID",80:"STR",81:"MD_STR",84:"STYLE",85:"LINKSTYLE",86:"CLASSDEF",87:"CLASS",88:"CLICK",89:"DOWN",90:"UP",93:"idString[vertex]",94:"idString[class]",95:"CALLBACKNAME",96:"CALLBACKARGS",97:"HREF",98:"LINK_TARGET",99:"STR[link]",100:"STR[tooltip]",102:"DEFAULT",104:"INTERPOLATE",105:"NUM",106:"COMMA",109:"NODE_STRING",110:"UNIT",111:"BRKT",112:"PCT",114:"MINUS",115:"MULT",116:"UNICODE_TEXT",117:"TEXT",118:"TAGSTART",119:"EDGE_TEXT",121:"direction_tb",122:"direction_bt",123:"direction_rl",124:"direction_lr"},productions_:[0,[3,2],[5,0],[5,2],[6,1],[6,1],[6,1],[6,1],[6,1],[4,2],[4,2],[4,2],[4,3],[16,2],[16,1],[17,1],[17,1],[17,1],[15,1],[15,1],[15,2],[19,2],[19,2],[19,1],[19,1],[18,2],[18,1],[7,2],[7,2],[7,2],[7,2],[7,2],[7,2],[7,9],[7,6],[7,4],[7,1],[7,2],[7,2],[7,1],[21,1],[21,1],[21,1],[39,2],[39,1],[20,4],[20,3],[20,4],[20,2],[20,2],[20,1],[42,1],[42,6],[42,5],[43,1],[43,3],[45,4],[45,4],[45,6],[45,4],[45,4],[45,4],[45,8],[45,4],[45,4],[45,4],[45,6],[45,4],[45,4],[45,4],[45,4],[45,4],[45,1],[41,2],[41,3],[41,3],[41,1],[41,3],[41,4],[76,1],[76,2],[76,1],[76,1],[72,1],[72,2],[73,3],[30,1],[30,2],[30,1],[30,1],[83,1],[83,1],[83,1],[83,1],[83,1],[83,1],[83,1],[83,1],[83,1],[83,1],[83,1],[28,1],[28,2],[28,1],[28,1],[24,5],[25,5],[26,2],[26,4],[26,3],[26,5],[26,3],[26,5],[26,5],[26,7],[26,2],[26,4],[26,2],[26,4],[26,4],[26,6],[22,5],[23,5],[23,5],[23,9],[23,9],[23,7],[23,7],[103,1],[103,3],[92,1],[92,3],[107,1],[107,2],[108,1],[108,1],[108,1],[108,1],[108,1],[108,1],[108,1],[108,1],[113,1],[113,1],[113,1],[113,1],[113,1],[113,1],[113,1],[113,1],[113,1],[113,1],[113,1],[82,1],[82,1],[82,1],[82,1],[91,1],[91,1],[91,1],[91,1],[91,1],[91,1],[91,1],[91,1],[91,1],[91,1],[91,1],[79,1],[79,1],[120,1],[120,1],[120,1],[120,1],[120,1],[120,1],[120,1],[120,1],[120,1],[120,1],[120,1],[47,1],[47,2],[101,1],[101,2],[33,1],[33,1],[33,1],[33,1]],performAction:m(function(h,d,p,o,B,t,P1){var e=t.length-1;switch(B){case 2:this.$=[];break;case 3:(!Array.isArray(t[e])||t[e].length>0)&&t[e-1].push(t[e]),this.$=t[e-1];break;case 4:case 183:this.$=t[e];break;case 11:o.setDirection("TB"),this.$="TB";break;case 12:o.setDirection(t[e-1]),this.$=t[e-1];break;case 27:this.$=t[e-1].nodes;break;case 28:case 29:case 30:case 31:case 32:this.$=[];break;case 33:this.$=o.addSubGraph(t[e-6],t[e-1],t[e-4]);break;case 34:this.$=o.addSubGraph(t[e-3],t[e-1],t[e-3]);break;case 35:this.$=o.addSubGraph(void 0,t[e-1],void 0);break;case 37:this.$=t[e].trim(),o.setAccTitle(this.$);break;case 38:case 39:this.$=t[e].trim(),o.setAccDescription(this.$);break;case 43:this.$=t[e-1]+t[e];break;case 44:this.$=t[e];break;case 45:o.addVertex(t[e-1][t[e-1].length-1],void 0,void 0,void 0,void 0,void 0,void 0,t[e]),o.addLink(t[e-3].stmt,t[e-1],t[e-2]),this.$={stmt:t[e-1],nodes:t[e-1].concat(t[e-3].nodes)};break;case 46:o.addLink(t[e-2].stmt,t[e],t[e-1]),this.$={stmt:t[e],nodes:t[e].concat(t[e-2].nodes)};break;case 47:o.addLink(t[e-3].stmt,t[e-1],t[e-2]),this.$={stmt:t[e-1],nodes:t[e-1].concat(t[e-3].nodes)};break;case 48:this.$={stmt:t[e-1],nodes:t[e-1]};break;case 49:o.addVertex(t[e-1][t[e-1].length-1],void 0,void 0,void 0,void 0,void 0,void 0,t[e]),this.$={stmt:t[e-1],nodes:t[e-1],shapeData:t[e]};break;case 50:this.$={stmt:t[e],nodes:t[e]};break;case 51:this.$=[t[e]];break;case 52:o.addVertex(t[e-5][t[e-5].length-1],void 0,void 0,void 0,void 0,void 0,void 0,t[e-4]),this.$=t[e-5].concat(t[e]);break;case 53:this.$=t[e-4].concat(t[e]);break;case 54:this.$=t[e];break;case 55:this.$=t[e-2],o.setClass(t[e-2],t[e]);break;case 56:this.$=t[e-3],o.addVertex(t[e-3],t[e-1],"square");break;case 57:this.$=t[e-3],o.addVertex(t[e-3],t[e-1],"doublecircle");break;case 58:this.$=t[e-5],o.addVertex(t[e-5],t[e-2],"circle");break;case 59:this.$=t[e-3],o.addVertex(t[e-3],t[e-1],"ellipse");break;case 60:this.$=t[e-3],o.addVertex(t[e-3],t[e-1],"stadium");break;case 61:this.$=t[e-3],o.addVertex(t[e-3],t[e-1],"subroutine");break;case 62:this.$=t[e-7],o.addVertex(t[e-7],t[e-1],"rect",void 0,void 0,void 0,Object.fromEntries([[t[e-5],t[e-3]]]));break;case 63:this.$=t[e-3],o.addVertex(t[e-3],t[e-1],"cylinder");break;case 64:this.$=t[e-3],o.addVertex(t[e-3],t[e-1],"round");break;case 65:this.$=t[e-3],o.addVertex(t[e-3],t[e-1],"diamond");break;case 66:this.$=t[e-5],o.addVertex(t[e-5],t[e-2],"hexagon");break;case 67:this.$=t[e-3],o.addVertex(t[e-3],t[e-1],"odd");break;case 68:this.$=t[e-3],o.addVertex(t[e-3],t[e-1],"trapezoid");break;case 69:this.$=t[e-3],o.addVertex(t[e-3],t[e-1],"inv_trapezoid");break;case 70:this.$=t[e-3],o.addVertex(t[e-3],t[e-1],"lean_right");break;case 71:this.$=t[e-3],o.addVertex(t[e-3],t[e-1],"lean_left");break;case 72:this.$=t[e],o.addVertex(t[e]);break;case 73:t[e-1].text=t[e],this.$=t[e-1];break;case 74:case 75:t[e-2].text=t[e-1],this.$=t[e-2];break;case 76:this.$=t[e];break;case 77:var L=o.destructLink(t[e],t[e-2]);this.$={type:L.type,stroke:L.stroke,length:L.length,text:t[e-1]};break;case 78:var L=o.destructLink(t[e],t[e-2]);this.$={type:L.type,stroke:L.stroke,length:L.length,text:t[e-1],id:t[e-3]};break;case 79:this.$={text:t[e],type:"text"};break;case 80:this.$={text:t[e-1].text+""+t[e],type:t[e-1].type};break;case 81:this.$={text:t[e],type:"string"};break;case 82:this.$={text:t[e],type:"markdown"};break;case 83:var L=o.destructLink(t[e]);this.$={type:L.type,stroke:L.stroke,length:L.length};break;case 84:var L=o.destructLink(t[e]);this.$={type:L.type,stroke:L.stroke,length:L.length,id:t[e-1]};break;case 85:this.$=t[e-1];break;case 86:this.$={text:t[e],type:"text"};break;case 87:this.$={text:t[e-1].text+""+t[e],type:t[e-1].type};break;case 88:this.$={text:t[e],type:"string"};break;case 89:case 104:this.$={text:t[e],type:"markdown"};break;case 101:this.$={text:t[e],type:"text"};break;case 102:this.$={text:t[e-1].text+""+t[e],type:t[e-1].type};break;case 103:this.$={text:t[e],type:"text"};break;case 105:this.$=t[e-4],o.addClass(t[e-2],t[e]);break;case 106:this.$=t[e-4],o.setClass(t[e-2],t[e]);break;case 107:case 115:this.$=t[e-1],o.setClickEvent(t[e-1],t[e]);break;case 108:case 116:this.$=t[e-3],o.setClickEvent(t[e-3],t[e-2]),o.setTooltip(t[e-3],t[e]);break;case 109:this.$=t[e-2],o.setClickEvent(t[e-2],t[e-1],t[e]);break;case 110:this.$=t[e-4],o.setClickEvent(t[e-4],t[e-3],t[e-2]),o.setTooltip(t[e-4],t[e]);break;case 111:this.$=t[e-2],o.setLink(t[e-2],t[e]);break;case 112:this.$=t[e-4],o.setLink(t[e-4],t[e-2]),o.setTooltip(t[e-4],t[e]);break;case 113:this.$=t[e-4],o.setLink(t[e-4],t[e-2],t[e]);break;case 114:this.$=t[e-6],o.setLink(t[e-6],t[e-4],t[e]),o.setTooltip(t[e-6],t[e-2]);break;case 117:this.$=t[e-1],o.setLink(t[e-1],t[e]);break;case 118:this.$=t[e-3],o.setLink(t[e-3],t[e-2]),o.setTooltip(t[e-3],t[e]);break;case 119:this.$=t[e-3],o.setLink(t[e-3],t[e-2],t[e]);break;case 120:this.$=t[e-5],o.setLink(t[e-5],t[e-4],t[e]),o.setTooltip(t[e-5],t[e-2]);break;case 121:this.$=t[e-4],o.addVertex(t[e-2],void 0,void 0,t[e]);break;case 122:this.$=t[e-4],o.updateLink([t[e-2]],t[e]);break;case 123:this.$=t[e-4],o.updateLink(t[e-2],t[e]);break;case 124:this.$=t[e-8],o.updateLinkInterpolate([t[e-6]],t[e-2]),o.updateLink([t[e-6]],t[e]);break;case 125:this.$=t[e-8],o.updateLinkInterpolate(t[e-6],t[e-2]),o.updateLink(t[e-6],t[e]);break;case 126:this.$=t[e-6],o.updateLinkInterpolate([t[e-4]],t[e]);break;case 127:this.$=t[e-6],o.updateLinkInterpolate(t[e-4],t[e]);break;case 128:case 130:this.$=[t[e]];break;case 129:case 131:t[e-2].push(t[e]),this.$=t[e-2];break;case 133:this.$=t[e-1]+t[e];break;case 181:this.$=t[e];break;case 182:this.$=t[e-1]+""+t[e];break;case 184:this.$=t[e-1]+""+t[e];break;case 185:this.$={stmt:"dir",value:"TB"};break;case 186:this.$={stmt:"dir",value:"BT"};break;case 187:this.$={stmt:"dir",value:"RL"};break;case 188:this.$={stmt:"dir",value:"LR"};break}},"anonymous"),table:[{3:1,4:2,9:i,10:r,12:a},{1:[3]},s(n,l,{5:6}),{4:7,9:i,10:r,12:a},{4:8,9:i,10:r,12:a},{13:[1,9],14:[1,10]},{1:[2,1],6:11,7:12,8:g,9:c,10:b,11:u,20:17,22:18,23:19,24:20,25:21,26:22,27:A,33:24,34:y,36:f,38:k,42:28,43:38,44:x,45:39,47:40,60:T,84:d1,85:W,86:J,87:O1,88:M1,89:V,102:w,105:I,106:R,109:N,111:G,113:41,114:P,115:O,116:M,121:U1,122:W1,123:z1,124:j1},s(n,[2,9]),s(n,[2,10]),s(n,[2,11]),{8:[1,54],9:[1,55],10:p1,15:53,18:56},s(F,[2,3]),s(F,[2,4]),s(F,[2,5]),s(F,[2,6]),s(F,[2,7]),s(F,[2,8]),{8:t1,9:e1,11:s1,21:58,41:59,72:63,75:[1,64],77:[1,66],78:[1,65]},{8:t1,9:e1,11:s1,21:67},{8:t1,9:e1,11:s1,21:68},{8:t1,9:e1,11:s1,21:69},{8:t1,9:e1,11:s1,21:70},{8:t1,9:e1,11:s1,21:71},{8:t1,9:e1,10:[1,72],11:s1,21:73},s(F,[2,36]),{35:[1,74]},{37:[1,75]},s(F,[2,39]),s(C1,[2,50],{18:76,39:77,10:p1,40:at}),{10:[1,79]},{10:[1,80]},{10:[1,81]},{10:[1,82]},{14:D1,44:S1,60:x1,80:[1,86],89:T1,95:[1,83],97:[1,84],101:85,105:y1,106:F1,109:_1,111:B1,114:v1,115:L1,116:V1,120:87},s(F,[2,185]),s(F,[2,186]),s(F,[2,187]),s(F,[2,188]),s(A1,[2,51]),s(A1,[2,54],{46:[1,99]}),s(z,[2,72],{113:112,29:[1,100],44:x,48:[1,101],50:[1,102],52:[1,103],54:[1,104],56:[1,105],58:[1,106],60:T,63:[1,107],65:[1,108],67:[1,109],68:[1,110],70:[1,111],89:V,102:w,105:I,106:R,109:N,111:G,114:P,115:O,116:M}),s(q,[2,181]),s(q,[2,142]),s(q,[2,143]),s(q,[2,144]),s(q,[2,145]),s(q,[2,146]),s(q,[2,147]),s(q,[2,148]),s(q,[2,149]),s(q,[2,150]),s(q,[2,151]),s(q,[2,152]),s(n,[2,12]),s(n,[2,18]),s(n,[2,19]),{9:[1,113]},s(nt,[2,26],{18:114,10:p1}),s(F,[2,27]),{42:115,43:38,44:x,45:39,47:40,60:T,89:V,102:w,105:I,106:R,109:N,111:G,113:41,114:P,115:O,116:M},s(F,[2,40]),s(F,[2,41]),s(F,[2,42]),s(w1,[2,76],{73:116,62:[1,118],74:[1,117]}),{76:119,79:120,80:ut,81:ot,116:K1,119:Y1},{75:[1,125],77:[1,126]},s(lt,[2,83]),s(F,[2,28]),s(F,[2,29]),s(F,[2,30]),s(F,[2,31]),s(F,[2,32]),{10:ct,12:ht,14:dt,27:pt,28:127,32:ft,44:gt,60:bt,75:At,80:[1,129],81:[1,130],83:140,84:kt,85:mt,86:Et,87:Ct,88:Dt,89:St,90:xt,91:128,105:Tt,109:yt,111:Ft,114:_t,115:Bt,116:vt},s(Q1,l,{5:153}),s(F,[2,37]),s(F,[2,38]),s(C1,[2,48],{44:Lt}),s(C1,[2,49],{18:155,10:p1,40:Vt}),s(A1,[2,44]),{44:x,47:157,60:T,89:V,102:w,105:I,106:R,109:N,111:G,113:41,114:P,115:O,116:M},{102:[1,158],103:159,105:[1,160]},{44:x,47:161,60:T,89:V,102:w,105:I,106:R,109:N,111:G,113:41,114:P,115:O,116:M},{44:x,47:162,60:T,89:V,102:w,105:I,106:R,109:N,111:G,113:41,114:P,115:O,116:M},s(v,[2,107],{10:[1,163],96:[1,164]}),{80:[1,165]},s(v,[2,115],{120:167,10:[1,166],14:D1,44:S1,60:x1,89:T1,105:y1,106:F1,109:_1,111:B1,114:v1,115:L1,116:V1}),s(v,[2,117],{10:[1,168]}),s(H,[2,183]),s(H,[2,170]),s(H,[2,171]),s(H,[2,172]),s(H,[2,173]),s(H,[2,174]),s(H,[2,175]),s(H,[2,176]),s(H,[2,177]),s(H,[2,178]),s(H,[2,179]),s(H,[2,180]),{44:x,47:169,60:T,89:V,102:w,105:I,106:R,109:N,111:G,113:41,114:P,115:O,116:M},{30:170,67:E,80:j,81:K,82:171,116:C,117:D,118:S},{30:178,67:E,80:j,81:K,82:171,116:C,117:D,118:S},{30:180,50:[1,179],67:E,80:j,81:K,82:171,116:C,117:D,118:S},{30:181,67:E,80:j,81:K,82:171,116:C,117:D,118:S},{30:182,67:E,80:j,81:K,82:171,116:C,117:D,118:S},{30:183,67:E,80:j,81:K,82:171,116:C,117:D,118:S},{109:[1,184]},{30:185,67:E,80:j,81:K,82:171,116:C,117:D,118:S},{30:186,65:[1,187],67:E,80:j,81:K,82:171,116:C,117:D,118:S},{30:188,67:E,80:j,81:K,82:171,116:C,117:D,118:S},{30:189,67:E,80:j,81:K,82:171,116:C,117:D,118:S},{30:190,67:E,80:j,81:K,82:171,116:C,117:D,118:S},s(q,[2,182]),s(n,[2,20]),s(nt,[2,25]),s(C1,[2,46],{39:191,18:192,10:p1,40:at}),s(w1,[2,73],{10:[1,193]}),{10:[1,194]},{30:195,67:E,80:j,81:K,82:171,116:C,117:D,118:S},{77:[1,196],79:197,116:K1,119:Y1},s(I1,[2,79]),s(I1,[2,81]),s(I1,[2,82]),s(I1,[2,168]),s(I1,[2,169]),{76:198,79:120,80:ut,81:ot,116:K1,119:Y1},s(lt,[2,84]),{8:t1,9:e1,10:ct,11:s1,12:ht,14:dt,21:200,27:pt,29:[1,199],32:ft,44:gt,60:bt,75:At,83:140,84:kt,85:mt,86:Et,87:Ct,88:Dt,89:St,90:xt,91:201,105:Tt,109:yt,111:Ft,114:_t,115:Bt,116:vt},s(_,[2,101]),s(_,[2,103]),s(_,[2,104]),s(_,[2,157]),s(_,[2,158]),s(_,[2,159]),s(_,[2,160]),s(_,[2,161]),s(_,[2,162]),s(_,[2,163]),s(_,[2,164]),s(_,[2,165]),s(_,[2,166]),s(_,[2,167]),s(_,[2,90]),s(_,[2,91]),s(_,[2,92]),s(_,[2,93]),s(_,[2,94]),s(_,[2,95]),s(_,[2,96]),s(_,[2,97]),s(_,[2,98]),s(_,[2,99]),s(_,[2,100]),{6:11,7:12,8:g,9:c,10:b,11:u,20:17,22:18,23:19,24:20,25:21,26:22,27:A,32:[1,202],33:24,34:y,36:f,38:k,42:28,43:38,44:x,45:39,47:40,60:T,84:d1,85:W,86:J,87:O1,88:M1,89:V,102:w,105:I,106:R,109:N,111:G,113:41,114:P,115:O,116:M,121:U1,122:W1,123:z1,124:j1},{10:p1,18:203},{44:[1,204]},s(A1,[2,43]),{10:[1,205],44:x,60:T,89:V,102:w,105:I,106:R,109:N,111:G,113:112,114:P,115:O,116:M},{10:[1,206]},{10:[1,207],106:[1,208]},s(wt,[2,128]),{10:[1,209],44:x,60:T,89:V,102:w,105:I,106:R,109:N,111:G,113:112,114:P,115:O,116:M},{10:[1,210],44:x,60:T,89:V,102:w,105:I,106:R,109:N,111:G,113:112,114:P,115:O,116:M},{80:[1,211]},s(v,[2,109],{10:[1,212]}),s(v,[2,111],{10:[1,213]}),{80:[1,214]},s(H,[2,184]),{80:[1,215],98:[1,216]},s(A1,[2,55],{113:112,44:x,60:T,89:V,102:w,105:I,106:R,109:N,111:G,114:P,115:O,116:M}),{31:[1,217],67:E,82:218,116:C,117:D,118:S},s(f1,[2,86]),s(f1,[2,88]),s(f1,[2,89]),s(f1,[2,153]),s(f1,[2,154]),s(f1,[2,155]),s(f1,[2,156]),{49:[1,219],67:E,82:218,116:C,117:D,118:S},{30:220,67:E,80:j,81:K,82:171,116:C,117:D,118:S},{51:[1,221],67:E,82:218,116:C,117:D,118:S},{53:[1,222],67:E,82:218,116:C,117:D,118:S},{55:[1,223],67:E,82:218,116:C,117:D,118:S},{57:[1,224],67:E,82:218,116:C,117:D,118:S},{60:[1,225]},{64:[1,226],67:E,82:218,116:C,117:D,118:S},{66:[1,227],67:E,82:218,116:C,117:D,118:S},{30:228,67:E,80:j,81:K,82:171,116:C,117:D,118:S},{31:[1,229],67:E,82:218,116:C,117:D,118:S},{67:E,69:[1,230],71:[1,231],82:218,116:C,117:D,118:S},{67:E,69:[1,233],71:[1,232],82:218,116:C,117:D,118:S},s(C1,[2,45],{18:155,10:p1,40:Vt}),s(C1,[2,47],{44:Lt}),s(w1,[2,75]),s(w1,[2,74]),{62:[1,234],67:E,82:218,116:C,117:D,118:S},s(w1,[2,77]),s(I1,[2,80]),{77:[1,235],79:197,116:K1,119:Y1},{30:236,67:E,80:j,81:K,82:171,116:C,117:D,118:S},s(Q1,l,{5:237}),s(_,[2,102]),s(F,[2,35]),{43:238,44:x,45:39,47:40,60:T,89:V,102:w,105:I,106:R,109:N,111:G,113:41,114:P,115:O,116:M},{10:p1,18:239},{10:i1,60:r1,84:a1,92:240,105:n1,107:241,108:242,109:u1,110:o1,111:l1,112:c1},{10:i1,60:r1,84:a1,92:251,104:[1,252],105:n1,107:241,108:242,109:u1,110:o1,111:l1,112:c1},{10:i1,60:r1,84:a1,92:253,104:[1,254],105:n1,107:241,108:242,109:u1,110:o1,111:l1,112:c1},{105:[1,255]},{10:i1,60:r1,84:a1,92:256,105:n1,107:241,108:242,109:u1,110:o1,111:l1,112:c1},{44:x,47:257,60:T,89:V,102:w,105:I,106:R,109:N,111:G,113:41,114:P,115:O,116:M},s(v,[2,108]),{80:[1,258]},{80:[1,259],98:[1,260]},s(v,[2,116]),s(v,[2,118],{10:[1,261]}),s(v,[2,119]),s(z,[2,56]),s(f1,[2,87]),s(z,[2,57]),{51:[1,262],67:E,82:218,116:C,117:D,118:S},s(z,[2,64]),s(z,[2,59]),s(z,[2,60]),s(z,[2,61]),{109:[1,263]},s(z,[2,63]),s(z,[2,65]),{66:[1,264],67:E,82:218,116:C,117:D,118:S},s(z,[2,67]),s(z,[2,68]),s(z,[2,70]),s(z,[2,69]),s(z,[2,71]),s([10,44,60,89,102,105,106,109,111,114,115,116],[2,85]),s(w1,[2,78]),{31:[1,265],67:E,82:218,116:C,117:D,118:S},{6:11,7:12,8:g,9:c,10:b,11:u,20:17,22:18,23:19,24:20,25:21,26:22,27:A,32:[1,266],33:24,34:y,36:f,38:k,42:28,43:38,44:x,45:39,47:40,60:T,84:d1,85:W,86:J,87:O1,88:M1,89:V,102:w,105:I,106:R,109:N,111:G,113:41,114:P,115:O,116:M,121:U1,122:W1,123:z1,124:j1},s(A1,[2,53]),{43:267,44:x,45:39,47:40,60:T,89:V,102:w,105:I,106:R,109:N,111:G,113:41,114:P,115:O,116:M},s(v,[2,121],{106:R1}),s(It,[2,130],{108:269,10:i1,60:r1,84:a1,105:n1,109:u1,110:o1,111:l1,112:c1}),s(Z,[2,132]),s(Z,[2,134]),s(Z,[2,135]),s(Z,[2,136]),s(Z,[2,137]),s(Z,[2,138]),s(Z,[2,139]),s(Z,[2,140]),s(Z,[2,141]),s(v,[2,122],{106:R1}),{10:[1,270]},s(v,[2,123],{106:R1}),{10:[1,271]},s(wt,[2,129]),s(v,[2,105],{106:R1}),s(v,[2,106],{113:112,44:x,60:T,89:V,102:w,105:I,106:R,109:N,111:G,114:P,115:O,116:M}),s(v,[2,110]),s(v,[2,112],{10:[1,272]}),s(v,[2,113]),{98:[1,273]},{51:[1,274]},{62:[1,275]},{66:[1,276]},{8:t1,9:e1,11:s1,21:277},s(F,[2,34]),s(A1,[2,52]),{10:i1,60:r1,84:a1,105:n1,107:278,108:242,109:u1,110:o1,111:l1,112:c1},s(Z,[2,133]),{14:D1,44:S1,60:x1,89:T1,101:279,105:y1,106:F1,109:_1,111:B1,114:v1,115:L1,116:V1,120:87},{14:D1,44:S1,60:x1,89:T1,101:280,105:y1,106:F1,109:_1,111:B1,114:v1,115:L1,116:V1,120:87},{98:[1,281]},s(v,[2,120]),s(z,[2,58]),{30:282,67:E,80:j,81:K,82:171,116:C,117:D,118:S},s(z,[2,66]),s(Q1,l,{5:283}),s(It,[2,131],{108:269,10:i1,60:r1,84:a1,105:n1,109:u1,110:o1,111:l1,112:c1}),s(v,[2,126],{120:167,10:[1,284],14:D1,44:S1,60:x1,89:T1,105:y1,106:F1,109:_1,111:B1,114:v1,115:L1,116:V1}),s(v,[2,127],{120:167,10:[1,285],14:D1,44:S1,60:x1,89:T1,105:y1,106:F1,109:_1,111:B1,114:v1,115:L1,116:V1}),s(v,[2,114]),{31:[1,286],67:E,82:218,116:C,117:D,118:S},{6:11,7:12,8:g,9:c,10:b,11:u,20:17,22:18,23:19,24:20,25:21,26:22,27:A,32:[1,287],33:24,34:y,36:f,38:k,42:28,43:38,44:x,45:39,47:40,60:T,84:d1,85:W,86:J,87:O1,88:M1,89:V,102:w,105:I,106:R,109:N,111:G,113:41,114:P,115:O,116:M,121:U1,122:W1,123:z1,124:j1},{10:i1,60:r1,84:a1,92:288,105:n1,107:241,108:242,109:u1,110:o1,111:l1,112:c1},{10:i1,60:r1,84:a1,92:289,105:n1,107:241,108:242,109:u1,110:o1,111:l1,112:c1},s(z,[2,62]),s(F,[2,33]),s(v,[2,124],{106:R1}),s(v,[2,125],{106:R1})],defaultActions:{},parseError:m(function(h,d){if(d.recoverable)this.trace(h);else{var p=new Error(h);throw p.hash=d,p}},"parseError"),parse:m(function(h){var d=this,p=[0],o=[],B=[null],t=[],P1=this.table,e="",L=0,Rt=0,zt=2,Nt=1,jt=t.slice.call(arguments,1),U=Object.create(this.lexer),k1={yy:{}};for(var Z1 in this.yy)Object.prototype.hasOwnProperty.call(this.yy,Z1)&&(k1.yy[Z1]=this.yy[Z1]);U.setInput(h,k1.yy),k1.yy.lexer=U,k1.yy.parser=this,typeof U.yylloc>"u"&&(U.yylloc={});var $1=U.yylloc;t.push($1);var Kt=U.options&&U.options.ranges;typeof k1.yy.parseError=="function"?this.parseError=k1.yy.parseError:this.parseError=Object.getPrototypeOf(this).parseError;function Yt(X){p.length=p.length-2*X,B.length=B.length-X,t.length=t.length-X}m(Yt,"popStack");function Gt(){var X;return X=o.pop()||U.lex()||Nt,typeof X!="number"&&(X instanceof Array&&(o=X,X=o.pop()),X=d.symbols_[X]||X),X}m(Gt,"lex");for(var Y,m1,Q,tt,N1={},H1,h1,Pt,X1;;){if(m1=p[p.length-1],this.defaultActions[m1]?Q=this.defaultActions[m1]:((Y===null||typeof Y>"u")&&(Y=Gt()),Q=P1[m1]&&P1[m1][Y]),typeof Q>"u"||!Q.length||!Q[0]){var et="";X1=[];for(H1 in P1[m1])this.terminals_[H1]&&H1>zt&&X1.push("'"+this.terminals_[H1]+"'");U.showPosition?et="Parse error on line "+(L+1)+`:
-`+U.showPosition()+`
-Expecting `+X1.join(", ")+", got '"+(this.terminals_[Y]||Y)+"'":et="Parse error on line "+(L+1)+": Unexpected "+(Y==Nt?"end of input":"'"+(this.terminals_[Y]||Y)+"'"),this.parseError(et,{text:U.match,token:this.terminals_[Y]||Y,line:U.yylineno,loc:$1,expected:X1})}if(Q[0]instanceof Array&&Q.length>1)throw new Error("Parse Error: multiple actions possible at state: "+m1+", token: "+Y);switch(Q[0]){case 1:p.push(Y),B.push(U.yytext),t.push(U.yylloc),p.push(Q[1]),Y=null,Rt=U.yyleng,e=U.yytext,L=U.yylineno,$1=U.yylloc;break;case 2:if(h1=this.productions_[Q[1]][1],N1.$=B[B.length-h1],N1._$={first_line:t[t.length-(h1||1)].first_line,last_line:t[t.length-1].last_line,first_column:t[t.length-(h1||1)].first_column,last_column:t[t.length-1].last_column},Kt&&(N1._$.range=[t[t.length-(h1||1)].range[0],t[t.length-1].range[1]]),tt=this.performAction.apply(N1,[e,Rt,L,k1.yy,Q[1],B,t].concat(jt)),typeof tt<"u")return tt;h1&&(p=p.slice(0,-1*h1*2),B=B.slice(0,-1*h1),t=t.slice(0,-1*h1)),p.push(this.productions_[Q[1]][0]),B.push(N1.$),t.push(N1._$),Pt=P1[p[p.length-2]][p[p.length-1]],p.push(Pt);break;case 3:return!0}}return!0},"parse")},Wt=(function(){var g1={EOF:1,parseError:m(function(d,p){if(this.yy.parser)this.yy.parser.parseError(d,p);else throw new Error(d)},"parseError"),setInput:m(function(h,d){return this.yy=d||this.yy||{},this._input=h,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},"setInput"),input:m(function(){var h=this._input[0];this.yytext+=h,this.yyleng++,this.offset++,this.match+=h,this.matched+=h;var d=h.match(/(?:\r\n?|\n).*/g);return d?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),h},"input"),unput:m(function(h){var d=h.length,p=h.split(/(?:\r\n?|\n)/g);this._input=h+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-d),this.offset-=d;var o=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),p.length-1&&(this.yylineno-=p.length-1);var B=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:p?(p.length===o.length?this.yylloc.first_column:0)+o[o.length-p.length].length-p[0].length:this.yylloc.first_column-d},this.options.ranges&&(this.yylloc.range=[B[0],B[0]+this.yyleng-d]),this.yyleng=this.yytext.length,this},"unput"),more:m(function(){return this._more=!0,this},"more"),reject:m(function(){if(this.options.backtrack_lexer)this._backtrack=!0;else return this.parseError("Lexical error on line "+(this.yylineno+1)+`. You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).
-`+this.showPosition(),{text:"",token:null,line:this.yylineno});return this},"reject"),less:m(function(h){this.unput(this.match.slice(h))},"less"),pastInput:m(function(){var h=this.matched.substr(0,this.matched.length-this.match.length);return(h.length>20?"...":"")+h.substr(-20).replace(/\n/g,"")},"pastInput"),upcomingInput:m(function(){var h=this.match;return h.length<20&&(h+=this._input.substr(0,20-h.length)),(h.substr(0,20)+(h.length>20?"...":"")).replace(/\n/g,"")},"upcomingInput"),showPosition:m(function(){var h=this.pastInput(),d=new Array(h.length+1).join("-");return h+this.upcomingInput()+`
-`+d+"^"},"showPosition"),test_match:m(function(h,d){var p,o,B;if(this.options.backtrack_lexer&&(B={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(B.yylloc.range=this.yylloc.range.slice(0))),o=h[0].match(/(?:\r\n?|\n).*/g),o&&(this.yylineno+=o.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:o?o[o.length-1].length-o[o.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+h[0].length},this.yytext+=h[0],this.match+=h[0],this.matches=h,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(h[0].length),this.matched+=h[0],p=this.performAction.call(this,this.yy,this,d,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),p)return p;if(this._backtrack){for(var t in B)this[t]=B[t];return!1}return!1},"test_match"),next:m(function(){if(this.done)return this.EOF;this._input||(this.done=!0);var h,d,p,o;this._more||(this.yytext="",this.match="");for(var B=this._currentRules(),t=0;t<B.length;t++)if(p=this._input.match(this.rules[B[t]]),p&&(!d||p[0].length>d[0].length)){if(d=p,o=t,this.options.backtrack_lexer){if(h=this.test_match(p,B[t]),h!==!1)return h;if(this._backtrack){d=!1;continue}else return!1}else if(!this.options.flex)break}return d?(h=this.test_match(d,B[o]),h!==!1?h:!1):this._input===""?this.EOF:this.parseError("Lexical error on line "+(this.yylineno+1)+`. Unrecognized text.
-`+this.showPosition(),{text:"",token:null,line:this.yylineno})},"next"),lex:m(function(){var d=this.next();return d||this.lex()},"lex"),begin:m(function(d){this.conditionStack.push(d)},"begin"),popState:m(function(){var d=this.conditionStack.length-1;return d>0?this.conditionStack.pop():this.conditionStack[0]},"popState"),_currentRules:m(function(){return this.conditionStack.length&&this.conditionStack[this.conditionStack.length-1]?this.conditions[this.conditionStack[this.conditionStack.length-1]].rules:this.conditions.INITIAL.rules},"_currentRules"),topState:m(function(d){return d=this.conditionStack.length-1-Math.abs(d||0),d>=0?this.conditionStack[d]:"INITIAL"},"topState"),pushState:m(function(d){this.begin(d)},"pushState"),stateStackSize:m(function(){return this.conditionStack.length},"stateStackSize"),options:{},performAction:m(function(d,p,o,B){switch(o){case 0:return this.begin("acc_title"),34;case 1:return this.popState(),"acc_title_value";case 2:return this.begin("acc_descr"),36;case 3:return this.popState(),"acc_descr_value";case 4:this.begin("acc_descr_multiline");break;case 5:this.popState();break;case 6:return"acc_descr_multiline_value";case 7:return this.pushState("shapeData"),p.yytext="",40;case 8:return this.pushState("shapeDataStr"),40;case 9:return this.popState(),40;case 10:const t=/\n\s*/g;return p.yytext=p.yytext.replace(t,"<br/>"),40;case 11:return 40;case 12:this.popState();break;case 13:this.begin("callbackname");break;case 14:this.popState();break;case 15:this.popState(),this.begin("callbackargs");break;case 16:return 95;case 17:this.popState();break;case 18:return 96;case 19:return"MD_STR";case 20:this.popState();break;case 21:this.begin("md_string");break;case 22:return"STR";case 23:this.popState();break;case 24:this.pushState("string");break;case 25:return 84;case 26:return 102;case 27:return 85;case 28:return 104;case 29:return 86;case 30:return 87;case 31:return 97;case 32:this.begin("click");break;case 33:this.popState();break;case 34:return 88;case 35:return d.lex.firstGraph()&&this.begin("dir"),12;case 36:return d.lex.firstGraph()&&this.begin("dir"),12;case 37:return d.lex.firstGraph()&&this.begin("dir"),12;case 38:return 27;case 39:return 32;case 40:return 98;case 41:return 98;case 42:return 98;case 43:return 98;case 44:return this.popState(),13;case 45:return this.popState(),14;case 46:return this.popState(),14;case 47:return this.popState(),14;case 48:return this.popState(),14;case 49:return this.popState(),14;case 50:return this.popState(),14;case 51:return this.popState(),14;case 52:return this.popState(),14;case 53:return this.popState(),14;case 54:return this.popState(),14;case 55:return 121;case 56:return 122;case 57:return 123;case 58:return 124;case 59:return 78;case 60:return 105;case 61:return 111;case 62:return 46;case 63:return 60;case 64:return 44;case 65:return 8;case 66:return 106;case 67:return 115;case 68:return this.popState(),77;case 69:return this.pushState("edgeText"),75;case 70:return 119;case 71:return this.popState(),77;case 72:return this.pushState("thickEdgeText"),75;case 73:return 119;case 74:return this.popState(),77;case 75:return this.pushState("dottedEdgeText"),75;case 76:return 119;case 77:return 77;case 78:return this.popState(),53;case 79:return"TEXT";case 80:return this.pushState("ellipseText"),52;case 81:return this.popState(),55;case 82:return this.pushState("text"),54;case 83:return this.popState(),57;case 84:return this.pushState("text"),56;case 85:return 58;case 86:return this.pushState("text"),67;case 87:return this.popState(),64;case 88:return this.pushState("text"),63;case 89:return this.popState(),49;case 90:return this.pushState("text"),48;case 91:return this.popState(),69;case 92:return this.popState(),71;case 93:return 117;case 94:return this.pushState("trapText"),68;case 95:return this.pushState("trapText"),70;case 96:return 118;case 97:return 67;case 98:return 90;case 99:return"SEP";case 100:return 89;case 101:return 115;case 102:return 111;case 103:return 44;case 104:return 109;case 105:return 114;case 106:return 116;case 107:return this.popState(),62;case 108:return this.pushState("text"),62;case 109:return this.popState(),51;case 110:return this.pushState("text"),50;case 111:return this.popState(),31;case 112:return this.pushState("text"),29;case 113:return this.popState(),66;case 114:return this.pushState("text"),65;case 115:return"TEXT";case 116:return"QUOTE";case 117:return 9;case 118:return 10;case 119:return 11}},"anonymous"),rules:[/^(?:accTitle\s*:\s*)/,/^(?:(?!\n||)*[^\n]*)/,/^(?:accDescr\s*:\s*)/,/^(?:(?!\n||)*[^\n]*)/,/^(?:accDescr\s*\{\s*)/,/^(?:[\}])/,/^(?:[^\}]*)/,/^(?:@\{)/,/^(?:["])/,/^(?:["])/,/^(?:[^\"]+)/,/^(?:[^}^"]+)/,/^(?:\})/,/^(?:call[\s]+)/,/^(?:\([\s]*\))/,/^(?:\()/,/^(?:[^(]*)/,/^(?:\))/,/^(?:[^)]*)/,/^(?:[^`"]+)/,/^(?:[`]["])/,/^(?:["][`])/,/^(?:[^"]+)/,/^(?:["])/,/^(?:["])/,/^(?:style\b)/,/^(?:default\b)/,/^(?:linkStyle\b)/,/^(?:interpolate\b)/,/^(?:classDef\b)/,/^(?:class\b)/,/^(?:href[\s])/,/^(?:click[\s]+)/,/^(?:[\s\n])/,/^(?:[^\s\n]*)/,/^(?:flowchart-elk\b)/,/^(?:graph\b)/,/^(?:flowchart\b)/,/^(?:subgraph\b)/,/^(?:end\b\s*)/,/^(?:_self\b)/,/^(?:_blank\b)/,/^(?:_parent\b)/,/^(?:_top\b)/,/^(?:(\r?\n)*\s*\n)/,/^(?:\s*LR\b)/,/^(?:\s*RL\b)/,/^(?:\s*TB\b)/,/^(?:\s*BT\b)/,/^(?:\s*TD\b)/,/^(?:\s*BR\b)/,/^(?:\s*<)/,/^(?:\s*>)/,/^(?:\s*\^)/,/^(?:\s*v\b)/,/^(?:.*direction\s+TB[^\n]*)/,/^(?:.*direction\s+BT[^\n]*)/,/^(?:.*direction\s+RL[^\n]*)/,/^(?:.*direction\s+LR[^\n]*)/,/^(?:[^\s\"]+@(?=[^\{\"]))/,/^(?:[0-9]+)/,/^(?:#)/,/^(?::::)/,/^(?::)/,/^(?:&)/,/^(?:;)/,/^(?:,)/,/^(?:\*)/,/^(?:\s*[xo<]?--+[-xo>]\s*)/,/^(?:\s*[xo<]?--\s*)/,/^(?:[^-]|-(?!-)+)/,/^(?:\s*[xo<]?==+[=xo>]\s*)/,/^(?:\s*[xo<]?==\s*)/,/^(?:[^=]|=(?!))/,/^(?:\s*[xo<]?-?\.+-[xo>]?\s*)/,/^(?:\s*[xo<]?-\.\s*)/,/^(?:[^\.]|\.(?!))/,/^(?:\s*~~[\~]+\s*)/,/^(?:[-/\)][\)])/,/^(?:[^\(\)\[\]\{\}]|!\)+)/,/^(?:\(-)/,/^(?:\]\))/,/^(?:\(\[)/,/^(?:\]\])/,/^(?:\[\[)/,/^(?:\[\|)/,/^(?:>)/,/^(?:\)\])/,/^(?:\[\()/,/^(?:\)\)\))/,/^(?:\(\(\()/,/^(?:[\\(?=\])][\]])/,/^(?:\/(?=\])\])/,/^(?:\/(?!\])|\\(?!\])|[^\\\[\]\(\)\{\}\/]+)/,/^(?:\[\/)/,/^(?:\[\\)/,/^(?:<)/,/^(?:>)/,/^(?:\^)/,/^(?:\\\|)/,/^(?:v\b)/,/^(?:\*)/,/^(?:#)/,/^(?:&)/,/^(?:([A-Za-z0-9!"\#$%&'*+\.`?\\_\/]|-(?=[^\>\-\.])|(?!))+)/,/^(?:-)/,/^(?:[\u00AA\u00B5\u00BA\u00C0-\u00D6\u00D8-\u00F6]|[\u00F8-\u02C1\u02C6-\u02D1\u02E0-\u02E4\u02EC\u02EE\u0370-\u0374\u0376\u0377]|[\u037A-\u037D\u0386\u0388-\u038A\u038C\u038E-\u03A1\u03A3-\u03F5]|[\u03F7-\u0481\u048A-\u0527\u0531-\u0556\u0559\u0561-\u0587\u05D0-\u05EA]|[\u05F0-\u05F2\u0620-\u064A\u066E\u066F\u0671-\u06D3\u06D5\u06E5\u06E6\u06EE]|[\u06EF\u06FA-\u06FC\u06FF\u0710\u0712-\u072F\u074D-\u07A5\u07B1\u07CA-\u07EA]|[\u07F4\u07F5\u07FA\u0800-\u0815\u081A\u0824\u0828\u0840-\u0858\u08A0]|[\u08A2-\u08AC\u0904-\u0939\u093D\u0950\u0958-\u0961\u0971-\u0977]|[\u0979-\u097F\u0985-\u098C\u098F\u0990\u0993-\u09A8\u09AA-\u09B0\u09B2]|[\u09B6-\u09B9\u09BD\u09CE\u09DC\u09DD\u09DF-\u09E1\u09F0\u09F1\u0A05-\u0A0A]|[\u0A0F\u0A10\u0A13-\u0A28\u0A2A-\u0A30\u0A32\u0A33\u0A35\u0A36\u0A38\u0A39]|[\u0A59-\u0A5C\u0A5E\u0A72-\u0A74\u0A85-\u0A8D\u0A8F-\u0A91\u0A93-\u0AA8]|[\u0AAA-\u0AB0\u0AB2\u0AB3\u0AB5-\u0AB9\u0ABD\u0AD0\u0AE0\u0AE1\u0B05-\u0B0C]|[\u0B0F\u0B10\u0B13-\u0B28\u0B2A-\u0B30\u0B32\u0B33\u0B35-\u0B39\u0B3D\u0B5C]|[\u0B5D\u0B5F-\u0B61\u0B71\u0B83\u0B85-\u0B8A\u0B8E-\u0B90\u0B92-\u0B95\u0B99]|[\u0B9A\u0B9C\u0B9E\u0B9F\u0BA3\u0BA4\u0BA8-\u0BAA\u0BAE-\u0BB9\u0BD0]|[\u0C05-\u0C0C\u0C0E-\u0C10\u0C12-\u0C28\u0C2A-\u0C33\u0C35-\u0C39\u0C3D]|[\u0C58\u0C59\u0C60\u0C61\u0C85-\u0C8C\u0C8E-\u0C90\u0C92-\u0CA8\u0CAA-\u0CB3]|[\u0CB5-\u0CB9\u0CBD\u0CDE\u0CE0\u0CE1\u0CF1\u0CF2\u0D05-\u0D0C\u0D0E-\u0D10]|[\u0D12-\u0D3A\u0D3D\u0D4E\u0D60\u0D61\u0D7A-\u0D7F\u0D85-\u0D96\u0D9A-\u0DB1]|[\u0DB3-\u0DBB\u0DBD\u0DC0-\u0DC6\u0E01-\u0E30\u0E32\u0E33\u0E40-\u0E46\u0E81]|[\u0E82\u0E84\u0E87\u0E88\u0E8A\u0E8D\u0E94-\u0E97\u0E99-\u0E9F\u0EA1-\u0EA3]|[\u0EA5\u0EA7\u0EAA\u0EAB\u0EAD-\u0EB0\u0EB2\u0EB3\u0EBD\u0EC0-\u0EC4\u0EC6]|[\u0EDC-\u0EDF\u0F00\u0F40-\u0F47\u0F49-\u0F6C\u0F88-\u0F8C\u1000-\u102A]|[\u103F\u1050-\u1055\u105A-\u105D\u1061\u1065\u1066\u106E-\u1070\u1075-\u1081]|[\u108E\u10A0-\u10C5\u10C7\u10CD\u10D0-\u10FA\u10FC-\u1248\u124A-\u124D]|[\u1250-\u1256\u1258\u125A-\u125D\u1260-\u1288\u128A-\u128D\u1290-\u12B0]|[\u12B2-\u12B5\u12B8-\u12BE\u12C0\u12C2-\u12C5\u12C8-\u12D6\u12D8-\u1310]|[\u1312-\u1315\u1318-\u135A\u1380-\u138F\u13A0-\u13F4\u1401-\u166C]|[\u166F-\u167F\u1681-\u169A\u16A0-\u16EA\u1700-\u170C\u170E-\u1711]|[\u1720-\u1731\u1740-\u1751\u1760-\u176C\u176E-\u1770\u1780-\u17B3\u17D7]|[\u17DC\u1820-\u1877\u1880-\u18A8\u18AA\u18B0-\u18F5\u1900-\u191C]|[\u1950-\u196D\u1970-\u1974\u1980-\u19AB\u19C1-\u19C7\u1A00-\u1A16]|[\u1A20-\u1A54\u1AA7\u1B05-\u1B33\u1B45-\u1B4B\u1B83-\u1BA0\u1BAE\u1BAF]|[\u1BBA-\u1BE5\u1C00-\u1C23\u1C4D-\u1C4F\u1C5A-\u1C7D\u1CE9-\u1CEC]|[\u1CEE-\u1CF1\u1CF5\u1CF6\u1D00-\u1DBF\u1E00-\u1F15\u1F18-\u1F1D]|[\u1F20-\u1F45\u1F48-\u1F4D\u1F50-\u1F57\u1F59\u1F5B\u1F5D\u1F5F-\u1F7D]|[\u1F80-\u1FB4\u1FB6-\u1FBC\u1FBE\u1FC2-\u1FC4\u1FC6-\u1FCC\u1FD0-\u1FD3]|[\u1FD6-\u1FDB\u1FE0-\u1FEC\u1FF2-\u1FF4\u1FF6-\u1FFC\u2071\u207F]|[\u2090-\u209C\u2102\u2107\u210A-\u2113\u2115\u2119-\u211D\u2124\u2126\u2128]|[\u212A-\u212D\u212F-\u2139\u213C-\u213F\u2145-\u2149\u214E\u2183\u2184]|[\u2C00-\u2C2E\u2C30-\u2C5E\u2C60-\u2CE4\u2CEB-\u2CEE\u2CF2\u2CF3]|[\u2D00-\u2D25\u2D27\u2D2D\u2D30-\u2D67\u2D6F\u2D80-\u2D96\u2DA0-\u2DA6]|[\u2DA8-\u2DAE\u2DB0-\u2DB6\u2DB8-\u2DBE\u2DC0-\u2DC6\u2DC8-\u2DCE]|[\u2DD0-\u2DD6\u2DD8-\u2DDE\u2E2F\u3005\u3006\u3031-\u3035\u303B\u303C]|[\u3041-\u3096\u309D-\u309F\u30A1-\u30FA\u30FC-\u30FF\u3105-\u312D]|[\u3131-\u318E\u31A0-\u31BA\u31F0-\u31FF\u3400-\u4DB5\u4E00-\u9FCC]|[\uA000-\uA48C\uA4D0-\uA4FD\uA500-\uA60C\uA610-\uA61F\uA62A\uA62B]|[\uA640-\uA66E\uA67F-\uA697\uA6A0-\uA6E5\uA717-\uA71F\uA722-\uA788]|[\uA78B-\uA78E\uA790-\uA793\uA7A0-\uA7AA\uA7F8-\uA801\uA803-\uA805]|[\uA807-\uA80A\uA80C-\uA822\uA840-\uA873\uA882-\uA8B3\uA8F2-\uA8F7\uA8FB]|[\uA90A-\uA925\uA930-\uA946\uA960-\uA97C\uA984-\uA9B2\uA9CF\uAA00-\uAA28]|[\uAA40-\uAA42\uAA44-\uAA4B\uAA60-\uAA76\uAA7A\uAA80-\uAAAF\uAAB1\uAAB5]|[\uAAB6\uAAB9-\uAABD\uAAC0\uAAC2\uAADB-\uAADD\uAAE0-\uAAEA\uAAF2-\uAAF4]|[\uAB01-\uAB06\uAB09-\uAB0E\uAB11-\uAB16\uAB20-\uAB26\uAB28-\uAB2E]|[\uABC0-\uABE2\uAC00-\uD7A3\uD7B0-\uD7C6\uD7CB-\uD7FB\uF900-\uFA6D]|[\uFA70-\uFAD9\uFB00-\uFB06\uFB13-\uFB17\uFB1D\uFB1F-\uFB28\uFB2A-\uFB36]|[\uFB38-\uFB3C\uFB3E\uFB40\uFB41\uFB43\uFB44\uFB46-\uFBB1\uFBD3-\uFD3D]|[\uFD50-\uFD8F\uFD92-\uFDC7\uFDF0-\uFDFB\uFE70-\uFE74\uFE76-\uFEFC]|[\uFF21-\uFF3A\uFF41-\uFF5A\uFF66-\uFFBE\uFFC2-\uFFC7\uFFCA-\uFFCF]|[\uFFD2-\uFFD7\uFFDA-\uFFDC])/,/^(?:\|)/,/^(?:\|)/,/^(?:\))/,/^(?:\()/,/^(?:\])/,/^(?:\[)/,/^(?:(\}))/,/^(?:\{)/,/^(?:[^\[\]\(\)\{\}\|\"]+)/,/^(?:")/,/^(?:(\r?\n)+)/,/^(?:\s)/,/^(?:$)/],conditions:{shapeDataEndBracket:{rules:[21,24,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},shapeDataStr:{rules:[9,10,21,24,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},shapeData:{rules:[8,11,12,21,24,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},callbackargs:{rules:[17,18,21,24,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},callbackname:{rules:[14,15,16,21,24,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},href:{rules:[21,24,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},click:{rules:[21,24,33,34,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},dottedEdgeText:{rules:[21,24,74,76,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},thickEdgeText:{rules:[21,24,71,73,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},edgeText:{rules:[21,24,68,70,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},trapText:{rules:[21,24,77,80,82,84,88,90,91,92,93,94,95,108,110,112,114],inclusive:!1},ellipseText:{rules:[21,24,77,78,79,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},text:{rules:[21,24,77,80,81,82,83,84,87,88,89,90,94,95,107,108,109,110,111,112,113,114,115],inclusive:!1},vertex:{rules:[21,24,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},dir:{rules:[21,24,44,45,46,47,48,49,50,51,52,53,54,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},acc_descr_multiline:{rules:[5,6,21,24,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},acc_descr:{rules:[3,21,24,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},acc_title:{rules:[1,21,24,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},md_string:{rules:[19,20,21,24,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},string:{rules:[21,22,23,24,77,80,82,84,88,90,94,95,108,110,112,114],inclusive:!1},INITIAL:{rules:[0,2,4,7,13,21,24,25,26,27,28,29,30,31,32,35,36,37,38,39,40,41,42,43,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,71,72,74,75,77,80,82,84,85,86,88,90,94,95,96,97,98,99,100,101,102,103,104,105,106,108,110,112,114,116,117,118,119],inclusive:!0}}};return g1})();J1.lexer=Wt;function q1(){this.yy={}}return m(q1,"Parser"),q1.prototype=J1,J1.Parser=q1,new q1})();rt.parser=rt;var Mt=rt,Ut=Object.assign({},Mt);Ut.parse=s=>{const i=s.replace(/}\s*\n/g,`}
-`);return Mt.parse(i)};var Ae=Ut,ke=m((s,i)=>{const r=he,a=r(s,"r"),n=r(s,"g"),l=r(s,"b");return oe(a,n,l,i)},"fade"),me=m(s=>`.label {
-    font-family: ${s.fontFamily};
-    color: ${s.nodeTextColor||s.textColor};
-  }
-  .cluster-label text {
-    fill: ${s.titleColor};
-  }
-  .cluster-label span {
-    color: ${s.titleColor};
-  }
-  .cluster-label span p {
-    background-color: transparent;
-  }
-
-  .label text,span {
-    fill: ${s.nodeTextColor||s.textColor};
-    color: ${s.nodeTextColor||s.textColor};
-  }
-
-  .node rect,
-  .node circle,
-  .node ellipse,
-  .node polygon,
-  .node path {
-    fill: ${s.mainBkg};
-    stroke: ${s.nodeBorder};
-    stroke-width: 1px;
-  }
-  .rough-node .label text , .node .label text, .image-shape .label, .icon-shape .label {
-    text-anchor: middle;
-  }
-  // .flowchart-label .text-outer-tspan {
-  //   text-anchor: middle;
-  // }
-  // .flowchart-label .text-inner-tspan {
-  //   text-anchor: start;
-  // }
-
-  .node .katex path {
-    fill: #000;
-    stroke: #000;
-    stroke-width: 1px;
-  }
-
-  .rough-node .label,.node .label, .image-shape .label, .icon-shape .label {
-    text-align: center;
-  }
-  .node.clickable {
-    cursor: pointer;
-  }
-
-
-  .root .anchor path {
-    fill: ${s.lineColor} !important;
-    stroke-width: 0;
-    stroke: ${s.lineColor};
-  }
-
-  .arrowheadPath {
-    fill: ${s.arrowheadColor};
-  }
-
-  .edgePath .path {
-    stroke: ${s.lineColor};
-    stroke-width: 2.0px;
-  }
-
-  .flowchart-link {
-    stroke: ${s.lineColor};
-    fill: none;
-  }
-
-  .edgeLabel {
-    background-color: ${s.edgeLabelBackground};
-    p {
-      background-color: ${s.edgeLabelBackground};
-    }
-    rect {
-      opacity: 0.5;
-      background-color: ${s.edgeLabelBackground};
-      fill: ${s.edgeLabelBackground};
-    }
-    text-align: center;
-  }
-
-  /* For html labels only */
-  .labelBkg {
-    background-color: ${ke(s.edgeLabelBackground,.5)};
-    // background-color:
-  }
-
-  .cluster rect {
-    fill: ${s.clusterBkg};
-    stroke: ${s.clusterBorder};
-    stroke-width: 1px;
-  }
-
-  .cluster text {
-    fill: ${s.titleColor};
-  }
-
-  .cluster span {
-    color: ${s.titleColor};
-  }
-  /* .cluster div {
-    color: ${s.titleColor};
-  } */
-
-  div.mermaidTooltip {
-    position: absolute;
-    text-align: center;
-    max-width: 200px;
-    padding: 2px;
-    font-family: ${s.fontFamily};
-    font-size: 12px;
-    background: ${s.tertiaryColor};
-    border: 1px solid ${s.border2};
-    border-radius: 2px;
-    pointer-events: none;
-    z-index: 100;
-  }
-
-  .flowchartTitleText {
-    text-anchor: middle;
-    font-size: 18px;
-    fill: ${s.textColor};
-  }
-
-  rect.text {
-    fill: none;
-    stroke-width: 0;
-  }
-
-  .icon-shape, .image-shape {
-    background-color: ${s.edgeLabelBackground};
-    p {
-      background-color: ${s.edgeLabelBackground};
-      padding: 2px;
-    }
-    rect {
-      opacity: 0.5;
-      background-color: ${s.edgeLabelBackground};
-      fill: ${s.edgeLabelBackground};
-    }
-    text-align: center;
-  }
-  ${qt()}
-`,"getStyles"),Ee=me,ye={parser:Ae,get db(){return new pe},renderer:be,styles:Ee,init:m(s=>{s.flowchart||(s.flowchart={}),s.layout&&Ot({layout:s.layout}),s.flowchart.arrowMarkerAbsolute=s.arrowMarkerAbsolute,Ot({flowchart:{arrowMarkerAbsolute:s.arrowMarkerAbsolute}})},"init")};export{ye as diagram};
diff --git a/docs/dist/assets/ganttDiagram-LVOFAZNH-xP4ejEuz.js b/docs/dist/assets/ganttDiagram-LVOFAZNH-xP4ejEuz.js
deleted file mode 100644
index 6f103b7f..00000000
--- a/docs/dist/assets/ganttDiagram-LVOFAZNH-xP4ejEuz.js
+++ /dev/null
@@ -1,267 +0,0 @@
-import{b0 as nn,b1 as Ln,b2 as rn,b3 as an,b4 as sn,b5 as se,b6 as An,aI as we,_ as h,g as In,s as Wn,q as On,p as Hn,a as Nn,b as Vn,c as _t,d as Bt,e as Pn,b7 as at,l as Kt,k as zn,j as Rn,y as qn,u as Bn}from"./index-BxX29htg.js";import{b as Zn,t as Oe,c as Xn,a as Gn,l as $n}from"./linear-hh6lJPrN.js";import{i as Qn}from"./init-Gi6I4Gst.js";import"./defaultLocale-C4B-KCzX.js";function jn(t,e){let n;if(e===void 0)for(const r of t)r!=null&&(n<r||n===void 0&&r>=r)&&(n=r);else{let r=-1;for(let a of t)(a=e(a,++r,t))!=null&&(n<a||n===void 0&&a>=a)&&(n=a)}return n}function Jn(t,e){let n;if(e===void 0)for(const r of t)r!=null&&(n>r||n===void 0&&r>=r)&&(n=r);else{let r=-1;for(let a of t)(a=e(a,++r,t))!=null&&(n>a||n===void 0&&a>=a)&&(n=a)}return n}function Kn(t){return t}var Xt=1,oe=2,ke=3,Zt=4,He=1e-6;function tr(t){return"translate("+t+",0)"}function er(t){return"translate(0,"+t+")"}function nr(t){return e=>+t(e)}function rr(t,e){return e=Math.max(0,t.bandwidth()-e*2)/2,t.round()&&(e=Math.round(e)),n=>+t(n)+e}function ar(){return!this.__axis}function on(t,e){var n=[],r=null,a=null,i=6,s=6,y=3,_=typeof window<"u"&&window.devicePixelRatio>1?0:.5,p=t===Xt||t===Zt?-1:1,g=t===Zt||t===oe?"x":"y",E=t===Xt||t===ke?tr:er;function C(b){var X=r??(e.ticks?e.ticks.apply(e,n):e.domain()),O=a??(e.tickFormat?e.tickFormat.apply(e,n):Kn),M=Math.max(i,0)+y,I=e.range(),V=+I[0]+_,W=+I[I.length-1]+_,B=(e.bandwidth?rr:nr)(e.copy(),_),Q=b.selection?b.selection():b,D=Q.selectAll(".domain").data([null]),H=Q.selectAll(".tick").data(X,e).order(),x=H.exit(),Y=H.enter().append("g").attr("class","tick"),F=H.select("line"),S=H.select("text");D=D.merge(D.enter().insert("path",".tick").attr("class","domain").attr("stroke","currentColor")),H=H.merge(Y),F=F.merge(Y.append("line").attr("stroke","currentColor").attr(g+"2",p*i)),S=S.merge(Y.append("text").attr("fill","currentColor").attr(g,p*M).attr("dy",t===Xt?"0em":t===ke?"0.71em":"0.32em")),b!==Q&&(D=D.transition(b),H=H.transition(b),F=F.transition(b),S=S.transition(b),x=x.transition(b).attr("opacity",He).attr("transform",function(v){return isFinite(v=B(v))?E(v+_):this.getAttribute("transform")}),Y.attr("opacity",He).attr("transform",function(v){var U=this.parentNode.__axis;return E((U&&isFinite(U=U(v))?U:B(v))+_)})),x.remove(),D.attr("d",t===Zt||t===oe?s?"M"+p*s+","+V+"H"+_+"V"+W+"H"+p*s:"M"+_+","+V+"V"+W:s?"M"+V+","+p*s+"V"+_+"H"+W+"V"+p*s:"M"+V+","+_+"H"+W),H.attr("opacity",1).attr("transform",function(v){return E(B(v)+_)}),F.attr(g+"2",p*i),S.attr(g,p*M).text(O),Q.filter(ar).attr("fill","none").attr("font-size",10).attr("font-family","sans-serif").attr("text-anchor",t===oe?"start":t===Zt?"end":"middle"),Q.each(function(){this.__axis=B})}return C.scale=function(b){return arguments.length?(e=b,C):e},C.ticks=function(){return n=Array.from(arguments),C},C.tickArguments=function(b){return arguments.length?(n=b==null?[]:Array.from(b),C):n.slice()},C.tickValues=function(b){return arguments.length?(r=b==null?null:Array.from(b),C):r&&r.slice()},C.tickFormat=function(b){return arguments.length?(a=b,C):a},C.tickSize=function(b){return arguments.length?(i=s=+b,C):i},C.tickSizeInner=function(b){return arguments.length?(i=+b,C):i},C.tickSizeOuter=function(b){return arguments.length?(s=+b,C):s},C.tickPadding=function(b){return arguments.length?(y=+b,C):y},C.offset=function(b){return arguments.length?(_=+b,C):_},C}function ir(t){return on(Xt,t)}function sr(t){return on(ke,t)}const or=Math.PI/180,cr=180/Math.PI,te=18,cn=.96422,un=1,ln=.82521,fn=4/29,St=6/29,hn=3*St*St,ur=St*St*St;function dn(t){if(t instanceof ft)return new ft(t.l,t.a,t.b,t.opacity);if(t instanceof dt)return mn(t);t instanceof nn||(t=Ln(t));var e=fe(t.r),n=fe(t.g),r=fe(t.b),a=ce((.2225045*e+.7168786*n+.0606169*r)/un),i,s;return e===n&&n===r?i=s=a:(i=ce((.4360747*e+.3850649*n+.1430804*r)/cn),s=ce((.0139322*e+.0971045*n+.7141733*r)/ln)),new ft(116*a-16,500*(i-a),200*(a-s),t.opacity)}function lr(t,e,n,r){return arguments.length===1?dn(t):new ft(t,e,n,r??1)}function ft(t,e,n,r){this.l=+t,this.a=+e,this.b=+n,this.opacity=+r}rn(ft,lr,an(sn,{brighter(t){return new ft(this.l+te*(t??1),this.a,this.b,this.opacity)},darker(t){return new ft(this.l-te*(t??1),this.a,this.b,this.opacity)},rgb(){var t=(this.l+16)/116,e=isNaN(this.a)?t:t+this.a/500,n=isNaN(this.b)?t:t-this.b/200;return e=cn*ue(e),t=un*ue(t),n=ln*ue(n),new nn(le(3.1338561*e-1.6168667*t-.4906146*n),le(-.9787684*e+1.9161415*t+.033454*n),le(.0719453*e-.2289914*t+1.4052427*n),this.opacity)}}));function ce(t){return t>ur?Math.pow(t,1/3):t/hn+fn}function ue(t){return t>St?t*t*t:hn*(t-fn)}function le(t){return 255*(t<=.0031308?12.92*t:1.055*Math.pow(t,1/2.4)-.055)}function fe(t){return(t/=255)<=.04045?t/12.92:Math.pow((t+.055)/1.055,2.4)}function fr(t){if(t instanceof dt)return new dt(t.h,t.c,t.l,t.opacity);if(t instanceof ft||(t=dn(t)),t.a===0&&t.b===0)return new dt(NaN,0<t.l&&t.l<100?0:NaN,t.l,t.opacity);var e=Math.atan2(t.b,t.a)*cr;return new dt(e<0?e+360:e,Math.sqrt(t.a*t.a+t.b*t.b),t.l,t.opacity)}function pe(t,e,n,r){return arguments.length===1?fr(t):new dt(t,e,n,r??1)}function dt(t,e,n,r){this.h=+t,this.c=+e,this.l=+n,this.opacity=+r}function mn(t){if(isNaN(t.h))return new ft(t.l,0,0,t.opacity);var e=t.h*or;return new ft(t.l,Math.cos(e)*t.c,Math.sin(e)*t.c,t.opacity)}rn(dt,pe,an(sn,{brighter(t){return new dt(this.h,this.c,this.l+te*(t??1),this.opacity)},darker(t){return new dt(this.h,this.c,this.l-te*(t??1),this.opacity)},rgb(){return mn(this).rgb()}}));function hr(t){return function(e,n){var r=t((e=pe(e)).h,(n=pe(n)).h),a=se(e.c,n.c),i=se(e.l,n.l),s=se(e.opacity,n.opacity);return function(y){return e.h=r(y),e.c=a(y),e.l=i(y),e.opacity=s(y),e+""}}}const dr=hr(An);function mr(t,e){t=t.slice();var n=0,r=t.length-1,a=t[n],i=t[r],s;return i<a&&(s=n,n=r,r=s,s=a,a=i,i=s),t[n]=e.floor(a),t[r]=e.ceil(i),t}const he=new Date,de=new Date;function et(t,e,n,r){function a(i){return t(i=arguments.length===0?new Date:new Date(+i)),i}return a.floor=i=>(t(i=new Date(+i)),i),a.ceil=i=>(t(i=new Date(i-1)),e(i,1),t(i),i),a.round=i=>{const s=a(i),y=a.ceil(i);return i-s<y-i?s:y},a.offset=(i,s)=>(e(i=new Date(+i),s==null?1:Math.floor(s)),i),a.range=(i,s,y)=>{const _=[];if(i=a.ceil(i),y=y==null?1:Math.floor(y),!(i<s)||!(y>0))return _;let p;do _.push(p=new Date(+i)),e(i,y),t(i);while(p<i&&i<s);return _},a.filter=i=>et(s=>{if(s>=s)for(;t(s),!i(s);)s.setTime(s-1)},(s,y)=>{if(s>=s)if(y<0)for(;++y<=0;)for(;e(s,-1),!i(s););else for(;--y>=0;)for(;e(s,1),!i(s););}),n&&(a.count=(i,s)=>(he.setTime(+i),de.setTime(+s),t(he),t(de),Math.floor(n(he,de))),a.every=i=>(i=Math.floor(i),!isFinite(i)||!(i>0)?null:i>1?a.filter(r?s=>r(s)%i===0:s=>a.count(0,s)%i===0):a)),a}const Yt=et(()=>{},(t,e)=>{t.setTime(+t+e)},(t,e)=>e-t);Yt.every=t=>(t=Math.floor(t),!isFinite(t)||!(t>0)?null:t>1?et(e=>{e.setTime(Math.floor(e/t)*t)},(e,n)=>{e.setTime(+e+n*t)},(e,n)=>(n-e)/t):Yt);Yt.range;const mt=1e3,ct=mt*60,gt=ct*60,yt=gt*24,De=yt*7,Ne=yt*30,me=yt*365,vt=et(t=>{t.setTime(t-t.getMilliseconds())},(t,e)=>{t.setTime(+t+e*mt)},(t,e)=>(e-t)/mt,t=>t.getUTCSeconds());vt.range;const Wt=et(t=>{t.setTime(t-t.getMilliseconds()-t.getSeconds()*mt)},(t,e)=>{t.setTime(+t+e*ct)},(t,e)=>(e-t)/ct,t=>t.getMinutes());Wt.range;const gr=et(t=>{t.setUTCSeconds(0,0)},(t,e)=>{t.setTime(+t+e*ct)},(t,e)=>(e-t)/ct,t=>t.getUTCMinutes());gr.range;const Ot=et(t=>{t.setTime(t-t.getMilliseconds()-t.getSeconds()*mt-t.getMinutes()*ct)},(t,e)=>{t.setTime(+t+e*gt)},(t,e)=>(e-t)/gt,t=>t.getHours());Ot.range;const yr=et(t=>{t.setUTCMinutes(0,0,0)},(t,e)=>{t.setTime(+t+e*gt)},(t,e)=>(e-t)/gt,t=>t.getUTCHours());yr.range;const Tt=et(t=>t.setHours(0,0,0,0),(t,e)=>t.setDate(t.getDate()+e),(t,e)=>(e-t-(e.getTimezoneOffset()-t.getTimezoneOffset())*ct)/yt,t=>t.getDate()-1);Tt.range;const Ce=et(t=>{t.setUTCHours(0,0,0,0)},(t,e)=>{t.setUTCDate(t.getUTCDate()+e)},(t,e)=>(e-t)/yt,t=>t.getUTCDate()-1);Ce.range;const kr=et(t=>{t.setUTCHours(0,0,0,0)},(t,e)=>{t.setUTCDate(t.getUTCDate()+e)},(t,e)=>(e-t)/yt,t=>Math.floor(t/yt));kr.range;function wt(t){return et(e=>{e.setDate(e.getDate()-(e.getDay()+7-t)%7),e.setHours(0,0,0,0)},(e,n)=>{e.setDate(e.getDate()+n*7)},(e,n)=>(n-e-(n.getTimezoneOffset()-e.getTimezoneOffset())*ct)/De)}const Vt=wt(0),Ht=wt(1),gn=wt(2),yn=wt(3),bt=wt(4),kn=wt(5),pn=wt(6);Vt.range;Ht.range;gn.range;yn.range;bt.range;kn.range;pn.range;function Dt(t){return et(e=>{e.setUTCDate(e.getUTCDate()-(e.getUTCDay()+7-t)%7),e.setUTCHours(0,0,0,0)},(e,n)=>{e.setUTCDate(e.getUTCDate()+n*7)},(e,n)=>(n-e)/De)}const vn=Dt(0),ee=Dt(1),pr=Dt(2),vr=Dt(3),Ut=Dt(4),Tr=Dt(5),br=Dt(6);vn.range;ee.range;pr.range;vr.range;Ut.range;Tr.range;br.range;const Nt=et(t=>{t.setDate(1),t.setHours(0,0,0,0)},(t,e)=>{t.setMonth(t.getMonth()+e)},(t,e)=>e.getMonth()-t.getMonth()+(e.getFullYear()-t.getFullYear())*12,t=>t.getMonth());Nt.range;const xr=et(t=>{t.setUTCDate(1),t.setUTCHours(0,0,0,0)},(t,e)=>{t.setUTCMonth(t.getUTCMonth()+e)},(t,e)=>e.getUTCMonth()-t.getUTCMonth()+(e.getUTCFullYear()-t.getUTCFullYear())*12,t=>t.getUTCMonth());xr.range;const kt=et(t=>{t.setMonth(0,1),t.setHours(0,0,0,0)},(t,e)=>{t.setFullYear(t.getFullYear()+e)},(t,e)=>e.getFullYear()-t.getFullYear(),t=>t.getFullYear());kt.every=t=>!isFinite(t=Math.floor(t))||!(t>0)?null:et(e=>{e.setFullYear(Math.floor(e.getFullYear()/t)*t),e.setMonth(0,1),e.setHours(0,0,0,0)},(e,n)=>{e.setFullYear(e.getFullYear()+n*t)});kt.range;const xt=et(t=>{t.setUTCMonth(0,1),t.setUTCHours(0,0,0,0)},(t,e)=>{t.setUTCFullYear(t.getUTCFullYear()+e)},(t,e)=>e.getUTCFullYear()-t.getUTCFullYear(),t=>t.getUTCFullYear());xt.every=t=>!isFinite(t=Math.floor(t))||!(t>0)?null:et(e=>{e.setUTCFullYear(Math.floor(e.getUTCFullYear()/t)*t),e.setUTCMonth(0,1),e.setUTCHours(0,0,0,0)},(e,n)=>{e.setUTCFullYear(e.getUTCFullYear()+n*t)});xt.range;function wr(t,e,n,r,a,i){const s=[[vt,1,mt],[vt,5,5*mt],[vt,15,15*mt],[vt,30,30*mt],[i,1,ct],[i,5,5*ct],[i,15,15*ct],[i,30,30*ct],[a,1,gt],[a,3,3*gt],[a,6,6*gt],[a,12,12*gt],[r,1,yt],[r,2,2*yt],[n,1,De],[e,1,Ne],[e,3,3*Ne],[t,1,me]];function y(p,g,E){const C=g<p;C&&([p,g]=[g,p]);const b=E&&typeof E.range=="function"?E:_(p,g,E),X=b?b.range(p,+g+1):[];return C?X.reverse():X}function _(p,g,E){const C=Math.abs(g-p)/E,b=Zn(([,,M])=>M).right(s,C);if(b===s.length)return t.every(Oe(p/me,g/me,E));if(b===0)return Yt.every(Math.max(Oe(p,g,E),1));const[X,O]=s[C/s[b-1][2]<s[b][2]/C?b-1:b];return X.every(O)}return[y,_]}const[Dr,Cr]=wr(kt,Nt,Vt,Tt,Ot,Wt);function ge(t){if(0<=t.y&&t.y<100){var e=new Date(-1,t.m,t.d,t.H,t.M,t.S,t.L);return e.setFullYear(t.y),e}return new Date(t.y,t.m,t.d,t.H,t.M,t.S,t.L)}function ye(t){if(0<=t.y&&t.y<100){var e=new Date(Date.UTC(-1,t.m,t.d,t.H,t.M,t.S,t.L));return e.setUTCFullYear(t.y),e}return new Date(Date.UTC(t.y,t.m,t.d,t.H,t.M,t.S,t.L))}function Lt(t,e,n){return{y:t,m:e,d:n,H:0,M:0,S:0,L:0}}function Mr(t){var e=t.dateTime,n=t.date,r=t.time,a=t.periods,i=t.days,s=t.shortDays,y=t.months,_=t.shortMonths,p=At(a),g=It(a),E=At(i),C=It(i),b=At(s),X=It(s),O=At(y),M=It(y),I=At(_),V=It(_),W={a:d,A:w,b:c,B:u,c:null,d:Be,e:Be,f:$r,g:ia,G:oa,H:Zr,I:Xr,j:Gr,L:Tn,m:Qr,M:jr,p:o,q:z,Q:Ge,s:$e,S:Jr,u:Kr,U:ta,V:ea,w:na,W:ra,x:null,X:null,y:aa,Y:sa,Z:ca,"%":Xe},B={a:P,A:R,b:K,B:G,c:null,d:Ze,e:Ze,f:ha,g:xa,G:Da,H:ua,I:la,j:fa,L:xn,m:da,M:ma,p:j,q:it,Q:Ge,s:$e,S:ga,u:ya,U:ka,V:pa,w:va,W:Ta,x:null,X:null,y:ba,Y:wa,Z:Ca,"%":Xe},Q={a:F,A:S,b:v,B:U,c:l,d:Re,e:Re,f:zr,g:ze,G:Pe,H:qe,I:qe,j:Hr,L:Pr,m:Or,M:Nr,p:Y,q:Wr,Q:qr,s:Br,S:Vr,u:Ur,U:Er,V:Lr,w:Yr,W:Ar,x:m,X:T,y:ze,Y:Pe,Z:Ir,"%":Rr};W.x=D(n,W),W.X=D(r,W),W.c=D(e,W),B.x=D(n,B),B.X=D(r,B),B.c=D(e,B);function D(k,A){return function(N){var f=[],J=-1,L=0,$=k.length,Z,rt,st;for(N instanceof Date||(N=new Date(+N));++J<$;)k.charCodeAt(J)===37&&(f.push(k.slice(L,J)),(rt=Ve[Z=k.charAt(++J)])!=null?Z=k.charAt(++J):rt=Z==="e"?" ":"0",(st=A[Z])&&(Z=st(N,rt)),f.push(Z),L=J+1);return f.push(k.slice(L,J)),f.join("")}}function H(k,A){return function(N){var f=Lt(1900,void 0,1),J=x(f,k,N+="",0),L,$;if(J!=N.length)return null;if("Q"in f)return new Date(f.Q);if("s"in f)return new Date(f.s*1e3+("L"in f?f.L:0));if(A&&!("Z"in f)&&(f.Z=0),"p"in f&&(f.H=f.H%12+f.p*12),f.m===void 0&&(f.m="q"in f?f.q:0),"V"in f){if(f.V<1||f.V>53)return null;"w"in f||(f.w=1),"Z"in f?(L=ye(Lt(f.y,0,1)),$=L.getUTCDay(),L=$>4||$===0?ee.ceil(L):ee(L),L=Ce.offset(L,(f.V-1)*7),f.y=L.getUTCFullYear(),f.m=L.getUTCMonth(),f.d=L.getUTCDate()+(f.w+6)%7):(L=ge(Lt(f.y,0,1)),$=L.getDay(),L=$>4||$===0?Ht.ceil(L):Ht(L),L=Tt.offset(L,(f.V-1)*7),f.y=L.getFullYear(),f.m=L.getMonth(),f.d=L.getDate()+(f.w+6)%7)}else("W"in f||"U"in f)&&("w"in f||(f.w="u"in f?f.u%7:"W"in f?1:0),$="Z"in f?ye(Lt(f.y,0,1)).getUTCDay():ge(Lt(f.y,0,1)).getDay(),f.m=0,f.d="W"in f?(f.w+6)%7+f.W*7-($+5)%7:f.w+f.U*7-($+6)%7);return"Z"in f?(f.H+=f.Z/100|0,f.M+=f.Z%100,ye(f)):ge(f)}}function x(k,A,N,f){for(var J=0,L=A.length,$=N.length,Z,rt;J<L;){if(f>=$)return-1;if(Z=A.charCodeAt(J++),Z===37){if(Z=A.charAt(J++),rt=Q[Z in Ve?A.charAt(J++):Z],!rt||(f=rt(k,N,f))<0)return-1}else if(Z!=N.charCodeAt(f++))return-1}return f}function Y(k,A,N){var f=p.exec(A.slice(N));return f?(k.p=g.get(f[0].toLowerCase()),N+f[0].length):-1}function F(k,A,N){var f=b.exec(A.slice(N));return f?(k.w=X.get(f[0].toLowerCase()),N+f[0].length):-1}function S(k,A,N){var f=E.exec(A.slice(N));return f?(k.w=C.get(f[0].toLowerCase()),N+f[0].length):-1}function v(k,A,N){var f=I.exec(A.slice(N));return f?(k.m=V.get(f[0].toLowerCase()),N+f[0].length):-1}function U(k,A,N){var f=O.exec(A.slice(N));return f?(k.m=M.get(f[0].toLowerCase()),N+f[0].length):-1}function l(k,A,N){return x(k,e,A,N)}function m(k,A,N){return x(k,n,A,N)}function T(k,A,N){return x(k,r,A,N)}function d(k){return s[k.getDay()]}function w(k){return i[k.getDay()]}function c(k){return _[k.getMonth()]}function u(k){return y[k.getMonth()]}function o(k){return a[+(k.getHours()>=12)]}function z(k){return 1+~~(k.getMonth()/3)}function P(k){return s[k.getUTCDay()]}function R(k){return i[k.getUTCDay()]}function K(k){return _[k.getUTCMonth()]}function G(k){return y[k.getUTCMonth()]}function j(k){return a[+(k.getUTCHours()>=12)]}function it(k){return 1+~~(k.getUTCMonth()/3)}return{format:function(k){var A=D(k+="",W);return A.toString=function(){return k},A},parse:function(k){var A=H(k+="",!1);return A.toString=function(){return k},A},utcFormat:function(k){var A=D(k+="",B);return A.toString=function(){return k},A},utcParse:function(k){var A=H(k+="",!0);return A.toString=function(){return k},A}}}var Ve={"-":"",_:" ",0:"0"},nt=/^\s*\d+/,_r=/^%/,Sr=/[\\^$*+?|[\]().{}]/g;function q(t,e,n){var r=t<0?"-":"",a=(r?-t:t)+"",i=a.length;return r+(i<n?new Array(n-i+1).join(e)+a:a)}function Fr(t){return t.replace(Sr,"\\$&")}function At(t){return new RegExp("^(?:"+t.map(Fr).join("|")+")","i")}function It(t){return new Map(t.map((e,n)=>[e.toLowerCase(),n]))}function Yr(t,e,n){var r=nt.exec(e.slice(n,n+1));return r?(t.w=+r[0],n+r[0].length):-1}function Ur(t,e,n){var r=nt.exec(e.slice(n,n+1));return r?(t.u=+r[0],n+r[0].length):-1}function Er(t,e,n){var r=nt.exec(e.slice(n,n+2));return r?(t.U=+r[0],n+r[0].length):-1}function Lr(t,e,n){var r=nt.exec(e.slice(n,n+2));return r?(t.V=+r[0],n+r[0].length):-1}function Ar(t,e,n){var r=nt.exec(e.slice(n,n+2));return r?(t.W=+r[0],n+r[0].length):-1}function Pe(t,e,n){var r=nt.exec(e.slice(n,n+4));return r?(t.y=+r[0],n+r[0].length):-1}function ze(t,e,n){var r=nt.exec(e.slice(n,n+2));return r?(t.y=+r[0]+(+r[0]>68?1900:2e3),n+r[0].length):-1}function Ir(t,e,n){var r=/^(Z)|([+-]\d\d)(?::?(\d\d))?/.exec(e.slice(n,n+6));return r?(t.Z=r[1]?0:-(r[2]+(r[3]||"00")),n+r[0].length):-1}function Wr(t,e,n){var r=nt.exec(e.slice(n,n+1));return r?(t.q=r[0]*3-3,n+r[0].length):-1}function Or(t,e,n){var r=nt.exec(e.slice(n,n+2));return r?(t.m=r[0]-1,n+r[0].length):-1}function Re(t,e,n){var r=nt.exec(e.slice(n,n+2));return r?(t.d=+r[0],n+r[0].length):-1}function Hr(t,e,n){var r=nt.exec(e.slice(n,n+3));return r?(t.m=0,t.d=+r[0],n+r[0].length):-1}function qe(t,e,n){var r=nt.exec(e.slice(n,n+2));return r?(t.H=+r[0],n+r[0].length):-1}function Nr(t,e,n){var r=nt.exec(e.slice(n,n+2));return r?(t.M=+r[0],n+r[0].length):-1}function Vr(t,e,n){var r=nt.exec(e.slice(n,n+2));return r?(t.S=+r[0],n+r[0].length):-1}function Pr(t,e,n){var r=nt.exec(e.slice(n,n+3));return r?(t.L=+r[0],n+r[0].length):-1}function zr(t,e,n){var r=nt.exec(e.slice(n,n+6));return r?(t.L=Math.floor(r[0]/1e3),n+r[0].length):-1}function Rr(t,e,n){var r=_r.exec(e.slice(n,n+1));return r?n+r[0].length:-1}function qr(t,e,n){var r=nt.exec(e.slice(n));return r?(t.Q=+r[0],n+r[0].length):-1}function Br(t,e,n){var r=nt.exec(e.slice(n));return r?(t.s=+r[0],n+r[0].length):-1}function Be(t,e){return q(t.getDate(),e,2)}function Zr(t,e){return q(t.getHours(),e,2)}function Xr(t,e){return q(t.getHours()%12||12,e,2)}function Gr(t,e){return q(1+Tt.count(kt(t),t),e,3)}function Tn(t,e){return q(t.getMilliseconds(),e,3)}function $r(t,e){return Tn(t,e)+"000"}function Qr(t,e){return q(t.getMonth()+1,e,2)}function jr(t,e){return q(t.getMinutes(),e,2)}function Jr(t,e){return q(t.getSeconds(),e,2)}function Kr(t){var e=t.getDay();return e===0?7:e}function ta(t,e){return q(Vt.count(kt(t)-1,t),e,2)}function bn(t){var e=t.getDay();return e>=4||e===0?bt(t):bt.ceil(t)}function ea(t,e){return t=bn(t),q(bt.count(kt(t),t)+(kt(t).getDay()===4),e,2)}function na(t){return t.getDay()}function ra(t,e){return q(Ht.count(kt(t)-1,t),e,2)}function aa(t,e){return q(t.getFullYear()%100,e,2)}function ia(t,e){return t=bn(t),q(t.getFullYear()%100,e,2)}function sa(t,e){return q(t.getFullYear()%1e4,e,4)}function oa(t,e){var n=t.getDay();return t=n>=4||n===0?bt(t):bt.ceil(t),q(t.getFullYear()%1e4,e,4)}function ca(t){var e=t.getTimezoneOffset();return(e>0?"-":(e*=-1,"+"))+q(e/60|0,"0",2)+q(e%60,"0",2)}function Ze(t,e){return q(t.getUTCDate(),e,2)}function ua(t,e){return q(t.getUTCHours(),e,2)}function la(t,e){return q(t.getUTCHours()%12||12,e,2)}function fa(t,e){return q(1+Ce.count(xt(t),t),e,3)}function xn(t,e){return q(t.getUTCMilliseconds(),e,3)}function ha(t,e){return xn(t,e)+"000"}function da(t,e){return q(t.getUTCMonth()+1,e,2)}function ma(t,e){return q(t.getUTCMinutes(),e,2)}function ga(t,e){return q(t.getUTCSeconds(),e,2)}function ya(t){var e=t.getUTCDay();return e===0?7:e}function ka(t,e){return q(vn.count(xt(t)-1,t),e,2)}function wn(t){var e=t.getUTCDay();return e>=4||e===0?Ut(t):Ut.ceil(t)}function pa(t,e){return t=wn(t),q(Ut.count(xt(t),t)+(xt(t).getUTCDay()===4),e,2)}function va(t){return t.getUTCDay()}function Ta(t,e){return q(ee.count(xt(t)-1,t),e,2)}function ba(t,e){return q(t.getUTCFullYear()%100,e,2)}function xa(t,e){return t=wn(t),q(t.getUTCFullYear()%100,e,2)}function wa(t,e){return q(t.getUTCFullYear()%1e4,e,4)}function Da(t,e){var n=t.getUTCDay();return t=n>=4||n===0?Ut(t):Ut.ceil(t),q(t.getUTCFullYear()%1e4,e,4)}function Ca(){return"+0000"}function Xe(){return"%"}function Ge(t){return+t}function $e(t){return Math.floor(+t/1e3)}var Mt,ne;Ma({dateTime:"%x, %X",date:"%-m/%-d/%Y",time:"%-I:%M:%S %p",periods:["AM","PM"],days:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],shortDays:["Sun","Mon","Tue","Wed","Thu","Fri","Sat"],months:["January","February","March","April","May","June","July","August","September","October","November","December"],shortMonths:["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"]});function Ma(t){return Mt=Mr(t),ne=Mt.format,Mt.parse,Mt.utcFormat,Mt.utcParse,Mt}function _a(t){return new Date(t)}function Sa(t){return t instanceof Date?+t:+new Date(+t)}function Dn(t,e,n,r,a,i,s,y,_,p){var g=Xn(),E=g.invert,C=g.domain,b=p(".%L"),X=p(":%S"),O=p("%I:%M"),M=p("%I %p"),I=p("%a %d"),V=p("%b %d"),W=p("%B"),B=p("%Y");function Q(D){return(_(D)<D?b:y(D)<D?X:s(D)<D?O:i(D)<D?M:r(D)<D?a(D)<D?I:V:n(D)<D?W:B)(D)}return g.invert=function(D){return new Date(E(D))},g.domain=function(D){return arguments.length?C(Array.from(D,Sa)):C().map(_a)},g.ticks=function(D){var H=C();return t(H[0],H[H.length-1],D??10)},g.tickFormat=function(D,H){return H==null?Q:p(H)},g.nice=function(D){var H=C();return(!D||typeof D.range!="function")&&(D=e(H[0],H[H.length-1],D??10)),D?C(mr(H,D)):g},g.copy=function(){return Gn(g,Dn(t,e,n,r,a,i,s,y,_,p))},g}function Fa(){return Qn.apply(Dn(Dr,Cr,kt,Nt,Vt,Tt,Ot,Wt,vt,ne).domain([new Date(2e3,0,1),new Date(2e3,0,2)]),arguments)}var Gt={exports:{}},Ya=Gt.exports,Qe;function Ua(){return Qe||(Qe=1,(function(t,e){(function(n,r){t.exports=r()})(Ya,(function(){var n="day";return function(r,a,i){var s=function(p){return p.add(4-p.isoWeekday(),n)},y=a.prototype;y.isoWeekYear=function(){return s(this).year()},y.isoWeek=function(p){if(!this.$utils().u(p))return this.add(7*(p-this.isoWeek()),n);var g,E,C,b,X=s(this),O=(g=this.isoWeekYear(),E=this.$u,C=(E?i.utc:i)().year(g).startOf("year"),b=4-C.isoWeekday(),C.isoWeekday()>4&&(b+=7),C.add(b,n));return X.diff(O,"week")+1},y.isoWeekday=function(p){return this.$utils().u(p)?this.day()||7:this.day(this.day()%7?p:p-7)};var _=y.startOf;y.startOf=function(p,g){var E=this.$utils(),C=!!E.u(g)||g;return E.p(p)==="isoweek"?C?this.date(this.date()-(this.isoWeekday()-1)).startOf("day"):this.date(this.date()-1-(this.isoWeekday()-1)+7).endOf("day"):_.bind(this)(p,g)}}}))})(Gt)),Gt.exports}var Ea=Ua();const La=we(Ea);var $t={exports:{}},Aa=$t.exports,je;function Ia(){return je||(je=1,(function(t,e){(function(n,r){t.exports=r()})(Aa,(function(){var n={LTS:"h:mm:ss A",LT:"h:mm A",L:"MM/DD/YYYY",LL:"MMMM D, YYYY",LLL:"MMMM D, YYYY h:mm A",LLLL:"dddd, MMMM D, YYYY h:mm A"},r=/(\[[^[]*\])|([-_:/.,()\s]+)|(A|a|Q|YYYY|YY?|ww?|MM?M?M?|Do|DD?|hh?|HH?|mm?|ss?|S{1,3}|z|ZZ?)/g,a=/\d/,i=/\d\d/,s=/\d\d?/,y=/\d*[^-_:/,()\s\d]+/,_={},p=function(M){return(M=+M)+(M>68?1900:2e3)},g=function(M){return function(I){this[M]=+I}},E=[/[+-]\d\d:?(\d\d)?|Z/,function(M){(this.zone||(this.zone={})).offset=(function(I){if(!I||I==="Z")return 0;var V=I.match(/([+-]|\d\d)/g),W=60*V[1]+(+V[2]||0);return W===0?0:V[0]==="+"?-W:W})(M)}],C=function(M){var I=_[M];return I&&(I.indexOf?I:I.s.concat(I.f))},b=function(M,I){var V,W=_.meridiem;if(W){for(var B=1;B<=24;B+=1)if(M.indexOf(W(B,0,I))>-1){V=B>12;break}}else V=M===(I?"pm":"PM");return V},X={A:[y,function(M){this.afternoon=b(M,!1)}],a:[y,function(M){this.afternoon=b(M,!0)}],Q:[a,function(M){this.month=3*(M-1)+1}],S:[a,function(M){this.milliseconds=100*+M}],SS:[i,function(M){this.milliseconds=10*+M}],SSS:[/\d{3}/,function(M){this.milliseconds=+M}],s:[s,g("seconds")],ss:[s,g("seconds")],m:[s,g("minutes")],mm:[s,g("minutes")],H:[s,g("hours")],h:[s,g("hours")],HH:[s,g("hours")],hh:[s,g("hours")],D:[s,g("day")],DD:[i,g("day")],Do:[y,function(M){var I=_.ordinal,V=M.match(/\d+/);if(this.day=V[0],I)for(var W=1;W<=31;W+=1)I(W).replace(/\[|\]/g,"")===M&&(this.day=W)}],w:[s,g("week")],ww:[i,g("week")],M:[s,g("month")],MM:[i,g("month")],MMM:[y,function(M){var I=C("months"),V=(C("monthsShort")||I.map((function(W){return W.slice(0,3)}))).indexOf(M)+1;if(V<1)throw new Error;this.month=V%12||V}],MMMM:[y,function(M){var I=C("months").indexOf(M)+1;if(I<1)throw new Error;this.month=I%12||I}],Y:[/[+-]?\d+/,g("year")],YY:[i,function(M){this.year=p(M)}],YYYY:[/\d{4}/,g("year")],Z:E,ZZ:E};function O(M){var I,V;I=M,V=_&&_.formats;for(var W=(M=I.replace(/(\[[^\]]+])|(LTS?|l{1,4}|L{1,4})/g,(function(F,S,v){var U=v&&v.toUpperCase();return S||V[v]||n[v]||V[U].replace(/(\[[^\]]+])|(MMMM|MM|DD|dddd)/g,(function(l,m,T){return m||T.slice(1)}))}))).match(r),B=W.length,Q=0;Q<B;Q+=1){var D=W[Q],H=X[D],x=H&&H[0],Y=H&&H[1];W[Q]=Y?{regex:x,parser:Y}:D.replace(/^\[|\]$/g,"")}return function(F){for(var S={},v=0,U=0;v<B;v+=1){var l=W[v];if(typeof l=="string")U+=l.length;else{var m=l.regex,T=l.parser,d=F.slice(U),w=m.exec(d)[0];T.call(S,w),F=F.replace(w,"")}}return(function(c){var u=c.afternoon;if(u!==void 0){var o=c.hours;u?o<12&&(c.hours+=12):o===12&&(c.hours=0),delete c.afternoon}})(S),S}}return function(M,I,V){V.p.customParseFormat=!0,M&&M.parseTwoDigitYear&&(p=M.parseTwoDigitYear);var W=I.prototype,B=W.parse;W.parse=function(Q){var D=Q.date,H=Q.utc,x=Q.args;this.$u=H;var Y=x[1];if(typeof Y=="string"){var F=x[2]===!0,S=x[3]===!0,v=F||S,U=x[2];S&&(U=x[2]),_=this.$locale(),!F&&U&&(_=V.Ls[U]),this.$d=(function(d,w,c,u){try{if(["x","X"].indexOf(w)>-1)return new Date((w==="X"?1e3:1)*d);var o=O(w)(d),z=o.year,P=o.month,R=o.day,K=o.hours,G=o.minutes,j=o.seconds,it=o.milliseconds,k=o.zone,A=o.week,N=new Date,f=R||(z||P?1:N.getDate()),J=z||N.getFullYear(),L=0;z&&!P||(L=P>0?P-1:N.getMonth());var $,Z=K||0,rt=G||0,st=j||0,pt=it||0;return k?new Date(Date.UTC(J,L,f,Z,rt,st,pt+60*k.offset*1e3)):c?new Date(Date.UTC(J,L,f,Z,rt,st,pt)):($=new Date(J,L,f,Z,rt,st,pt),A&&($=u($).week(A).toDate()),$)}catch{return new Date("")}})(D,Y,H,V),this.init(),U&&U!==!0&&(this.$L=this.locale(U).$L),v&&D!=this.format(Y)&&(this.$d=new Date("")),_={}}else if(Y instanceof Array)for(var l=Y.length,m=1;m<=l;m+=1){x[1]=Y[m-1];var T=V.apply(this,x);if(T.isValid()){this.$d=T.$d,this.$L=T.$L,this.init();break}m===l&&(this.$d=new Date(""))}else B.call(this,Q)}}}))})($t)),$t.exports}var Wa=Ia();const Oa=we(Wa);var Qt={exports:{}},Ha=Qt.exports,Je;function Na(){return Je||(Je=1,(function(t,e){(function(n,r){t.exports=r()})(Ha,(function(){return function(n,r){var a=r.prototype,i=a.format;a.format=function(s){var y=this,_=this.$locale();if(!this.isValid())return i.bind(this)(s);var p=this.$utils(),g=(s||"YYYY-MM-DDTHH:mm:ssZ").replace(/\[([^\]]+)]|Q|wo|ww|w|WW|W|zzz|z|gggg|GGGG|Do|X|x|k{1,2}|S/g,(function(E){switch(E){case"Q":return Math.ceil((y.$M+1)/3);case"Do":return _.ordinal(y.$D);case"gggg":return y.weekYear();case"GGGG":return y.isoWeekYear();case"wo":return _.ordinal(y.week(),"W");case"w":case"ww":return p.s(y.week(),E==="w"?1:2,"0");case"W":case"WW":return p.s(y.isoWeek(),E==="W"?1:2,"0");case"k":case"kk":return p.s(String(y.$H===0?24:y.$H),E==="k"?1:2,"0");case"X":return Math.floor(y.$d.getTime()/1e3);case"x":return y.$d.getTime();case"z":return"["+y.offsetName()+"]";case"zzz":return"["+y.offsetName("long")+"]";default:return E}}));return i.bind(this)(g)}}}))})(Qt)),Qt.exports}var Va=Na();const Pa=we(Va);var ve=(function(){var t=h(function(U,l,m,T){for(m=m||{},T=U.length;T--;m[U[T]]=l);return m},"o"),e=[6,8,10,12,13,14,15,16,17,18,20,21,22,23,24,25,26,27,28,29,30,31,33,35,36,38,40],n=[1,26],r=[1,27],a=[1,28],i=[1,29],s=[1,30],y=[1,31],_=[1,32],p=[1,33],g=[1,34],E=[1,9],C=[1,10],b=[1,11],X=[1,12],O=[1,13],M=[1,14],I=[1,15],V=[1,16],W=[1,19],B=[1,20],Q=[1,21],D=[1,22],H=[1,23],x=[1,25],Y=[1,35],F={trace:h(function(){},"trace"),yy:{},symbols_:{error:2,start:3,gantt:4,document:5,EOF:6,line:7,SPACE:8,statement:9,NL:10,weekday:11,weekday_monday:12,weekday_tuesday:13,weekday_wednesday:14,weekday_thursday:15,weekday_friday:16,weekday_saturday:17,weekday_sunday:18,weekend:19,weekend_friday:20,weekend_saturday:21,dateFormat:22,inclusiveEndDates:23,topAxis:24,axisFormat:25,tickInterval:26,excludes:27,includes:28,todayMarker:29,title:30,acc_title:31,acc_title_value:32,acc_descr:33,acc_descr_value:34,acc_descr_multiline_value:35,section:36,clickStatement:37,taskTxt:38,taskData:39,click:40,callbackname:41,callbackargs:42,href:43,clickStatementDebug:44,$accept:0,$end:1},terminals_:{2:"error",4:"gantt",6:"EOF",8:"SPACE",10:"NL",12:"weekday_monday",13:"weekday_tuesday",14:"weekday_wednesday",15:"weekday_thursday",16:"weekday_friday",17:"weekday_saturday",18:"weekday_sunday",20:"weekend_friday",21:"weekend_saturday",22:"dateFormat",23:"inclusiveEndDates",24:"topAxis",25:"axisFormat",26:"tickInterval",27:"excludes",28:"includes",29:"todayMarker",30:"title",31:"acc_title",32:"acc_title_value",33:"acc_descr",34:"acc_descr_value",35:"acc_descr_multiline_value",36:"section",38:"taskTxt",39:"taskData",40:"click",41:"callbackname",42:"callbackargs",43:"href"},productions_:[0,[3,3],[5,0],[5,2],[7,2],[7,1],[7,1],[7,1],[11,1],[11,1],[11,1],[11,1],[11,1],[11,1],[11,1],[19,1],[19,1],[9,1],[9,1],[9,1],[9,1],[9,1],[9,1],[9,1],[9,1],[9,1],[9,1],[9,1],[9,2],[9,2],[9,1],[9,1],[9,1],[9,2],[37,2],[37,3],[37,3],[37,4],[37,3],[37,4],[37,2],[44,2],[44,3],[44,3],[44,4],[44,3],[44,4],[44,2]],performAction:h(function(l,m,T,d,w,c,u){var o=c.length-1;switch(w){case 1:return c[o-1];case 2:this.$=[];break;case 3:c[o-1].push(c[o]),this.$=c[o-1];break;case 4:case 5:this.$=c[o];break;case 6:case 7:this.$=[];break;case 8:d.setWeekday("monday");break;case 9:d.setWeekday("tuesday");break;case 10:d.setWeekday("wednesday");break;case 11:d.setWeekday("thursday");break;case 12:d.setWeekday("friday");break;case 13:d.setWeekday("saturday");break;case 14:d.setWeekday("sunday");break;case 15:d.setWeekend("friday");break;case 16:d.setWeekend("saturday");break;case 17:d.setDateFormat(c[o].substr(11)),this.$=c[o].substr(11);break;case 18:d.enableInclusiveEndDates(),this.$=c[o].substr(18);break;case 19:d.TopAxis(),this.$=c[o].substr(8);break;case 20:d.setAxisFormat(c[o].substr(11)),this.$=c[o].substr(11);break;case 21:d.setTickInterval(c[o].substr(13)),this.$=c[o].substr(13);break;case 22:d.setExcludes(c[o].substr(9)),this.$=c[o].substr(9);break;case 23:d.setIncludes(c[o].substr(9)),this.$=c[o].substr(9);break;case 24:d.setTodayMarker(c[o].substr(12)),this.$=c[o].substr(12);break;case 27:d.setDiagramTitle(c[o].substr(6)),this.$=c[o].substr(6);break;case 28:this.$=c[o].trim(),d.setAccTitle(this.$);break;case 29:case 30:this.$=c[o].trim(),d.setAccDescription(this.$);break;case 31:d.addSection(c[o].substr(8)),this.$=c[o].substr(8);break;case 33:d.addTask(c[o-1],c[o]),this.$="task";break;case 34:this.$=c[o-1],d.setClickEvent(c[o-1],c[o],null);break;case 35:this.$=c[o-2],d.setClickEvent(c[o-2],c[o-1],c[o]);break;case 36:this.$=c[o-2],d.setClickEvent(c[o-2],c[o-1],null),d.setLink(c[o-2],c[o]);break;case 37:this.$=c[o-3],d.setClickEvent(c[o-3],c[o-2],c[o-1]),d.setLink(c[o-3],c[o]);break;case 38:this.$=c[o-2],d.setClickEvent(c[o-2],c[o],null),d.setLink(c[o-2],c[o-1]);break;case 39:this.$=c[o-3],d.setClickEvent(c[o-3],c[o-1],c[o]),d.setLink(c[o-3],c[o-2]);break;case 40:this.$=c[o-1],d.setLink(c[o-1],c[o]);break;case 41:case 47:this.$=c[o-1]+" "+c[o];break;case 42:case 43:case 45:this.$=c[o-2]+" "+c[o-1]+" "+c[o];break;case 44:case 46:this.$=c[o-3]+" "+c[o-2]+" "+c[o-1]+" "+c[o];break}},"anonymous"),table:[{3:1,4:[1,2]},{1:[3]},t(e,[2,2],{5:3}),{6:[1,4],7:5,8:[1,6],9:7,10:[1,8],11:17,12:n,13:r,14:a,15:i,16:s,17:y,18:_,19:18,20:p,21:g,22:E,23:C,24:b,25:X,26:O,27:M,28:I,29:V,30:W,31:B,33:Q,35:D,36:H,37:24,38:x,40:Y},t(e,[2,7],{1:[2,1]}),t(e,[2,3]),{9:36,11:17,12:n,13:r,14:a,15:i,16:s,17:y,18:_,19:18,20:p,21:g,22:E,23:C,24:b,25:X,26:O,27:M,28:I,29:V,30:W,31:B,33:Q,35:D,36:H,37:24,38:x,40:Y},t(e,[2,5]),t(e,[2,6]),t(e,[2,17]),t(e,[2,18]),t(e,[2,19]),t(e,[2,20]),t(e,[2,21]),t(e,[2,22]),t(e,[2,23]),t(e,[2,24]),t(e,[2,25]),t(e,[2,26]),t(e,[2,27]),{32:[1,37]},{34:[1,38]},t(e,[2,30]),t(e,[2,31]),t(e,[2,32]),{39:[1,39]},t(e,[2,8]),t(e,[2,9]),t(e,[2,10]),t(e,[2,11]),t(e,[2,12]),t(e,[2,13]),t(e,[2,14]),t(e,[2,15]),t(e,[2,16]),{41:[1,40],43:[1,41]},t(e,[2,4]),t(e,[2,28]),t(e,[2,29]),t(e,[2,33]),t(e,[2,34],{42:[1,42],43:[1,43]}),t(e,[2,40],{41:[1,44]}),t(e,[2,35],{43:[1,45]}),t(e,[2,36]),t(e,[2,38],{42:[1,46]}),t(e,[2,37]),t(e,[2,39])],defaultActions:{},parseError:h(function(l,m){if(m.recoverable)this.trace(l);else{var T=new Error(l);throw T.hash=m,T}},"parseError"),parse:h(function(l){var m=this,T=[0],d=[],w=[null],c=[],u=this.table,o="",z=0,P=0,R=2,K=1,G=c.slice.call(arguments,1),j=Object.create(this.lexer),it={yy:{}};for(var k in this.yy)Object.prototype.hasOwnProperty.call(this.yy,k)&&(it.yy[k]=this.yy[k]);j.setInput(l,it.yy),it.yy.lexer=j,it.yy.parser=this,typeof j.yylloc>"u"&&(j.yylloc={});var A=j.yylloc;c.push(A);var N=j.options&&j.options.ranges;typeof it.yy.parseError=="function"?this.parseError=it.yy.parseError:this.parseError=Object.getPrototypeOf(this).parseError;function f(ot){T.length=T.length-2*ot,w.length=w.length-ot,c.length=c.length-ot}h(f,"popStack");function J(){var ot;return ot=d.pop()||j.lex()||K,typeof ot!="number"&&(ot instanceof Array&&(d=ot,ot=d.pop()),ot=m.symbols_[ot]||ot),ot}h(J,"lex");for(var L,$,Z,rt,st={},pt,ut,We,qt;;){if($=T[T.length-1],this.defaultActions[$]?Z=this.defaultActions[$]:((L===null||typeof L>"u")&&(L=J()),Z=u[$]&&u[$][L]),typeof Z>"u"||!Z.length||!Z[0]){var ie="";qt=[];for(pt in u[$])this.terminals_[pt]&&pt>R&&qt.push("'"+this.terminals_[pt]+"'");j.showPosition?ie="Parse error on line "+(z+1)+`:
-`+j.showPosition()+`
-Expecting `+qt.join(", ")+", got '"+(this.terminals_[L]||L)+"'":ie="Parse error on line "+(z+1)+": Unexpected "+(L==K?"end of input":"'"+(this.terminals_[L]||L)+"'"),this.parseError(ie,{text:j.match,token:this.terminals_[L]||L,line:j.yylineno,loc:A,expected:qt})}if(Z[0]instanceof Array&&Z.length>1)throw new Error("Parse Error: multiple actions possible at state: "+$+", token: "+L);switch(Z[0]){case 1:T.push(L),w.push(j.yytext),c.push(j.yylloc),T.push(Z[1]),L=null,P=j.yyleng,o=j.yytext,z=j.yylineno,A=j.yylloc;break;case 2:if(ut=this.productions_[Z[1]][1],st.$=w[w.length-ut],st._$={first_line:c[c.length-(ut||1)].first_line,last_line:c[c.length-1].last_line,first_column:c[c.length-(ut||1)].first_column,last_column:c[c.length-1].last_column},N&&(st._$.range=[c[c.length-(ut||1)].range[0],c[c.length-1].range[1]]),rt=this.performAction.apply(st,[o,P,z,it.yy,Z[1],w,c].concat(G)),typeof rt<"u")return rt;ut&&(T=T.slice(0,-1*ut*2),w=w.slice(0,-1*ut),c=c.slice(0,-1*ut)),T.push(this.productions_[Z[1]][0]),w.push(st.$),c.push(st._$),We=u[T[T.length-2]][T[T.length-1]],T.push(We);break;case 3:return!0}}return!0},"parse")},S=(function(){var U={EOF:1,parseError:h(function(m,T){if(this.yy.parser)this.yy.parser.parseError(m,T);else throw new Error(m)},"parseError"),setInput:h(function(l,m){return this.yy=m||this.yy||{},this._input=l,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},"setInput"),input:h(function(){var l=this._input[0];this.yytext+=l,this.yyleng++,this.offset++,this.match+=l,this.matched+=l;var m=l.match(/(?:\r\n?|\n).*/g);return m?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),l},"input"),unput:h(function(l){var m=l.length,T=l.split(/(?:\r\n?|\n)/g);this._input=l+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-m),this.offset-=m;var d=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),T.length-1&&(this.yylineno-=T.length-1);var w=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:T?(T.length===d.length?this.yylloc.first_column:0)+d[d.length-T.length].length-T[0].length:this.yylloc.first_column-m},this.options.ranges&&(this.yylloc.range=[w[0],w[0]+this.yyleng-m]),this.yyleng=this.yytext.length,this},"unput"),more:h(function(){return this._more=!0,this},"more"),reject:h(function(){if(this.options.backtrack_lexer)this._backtrack=!0;else return this.parseError("Lexical error on line "+(this.yylineno+1)+`. You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).
-`+this.showPosition(),{text:"",token:null,line:this.yylineno});return this},"reject"),less:h(function(l){this.unput(this.match.slice(l))},"less"),pastInput:h(function(){var l=this.matched.substr(0,this.matched.length-this.match.length);return(l.length>20?"...":"")+l.substr(-20).replace(/\n/g,"")},"pastInput"),upcomingInput:h(function(){var l=this.match;return l.length<20&&(l+=this._input.substr(0,20-l.length)),(l.substr(0,20)+(l.length>20?"...":"")).replace(/\n/g,"")},"upcomingInput"),showPosition:h(function(){var l=this.pastInput(),m=new Array(l.length+1).join("-");return l+this.upcomingInput()+`
-`+m+"^"},"showPosition"),test_match:h(function(l,m){var T,d,w;if(this.options.backtrack_lexer&&(w={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(w.yylloc.range=this.yylloc.range.slice(0))),d=l[0].match(/(?:\r\n?|\n).*/g),d&&(this.yylineno+=d.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:d?d[d.length-1].length-d[d.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+l[0].length},this.yytext+=l[0],this.match+=l[0],this.matches=l,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(l[0].length),this.matched+=l[0],T=this.performAction.call(this,this.yy,this,m,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),T)return T;if(this._backtrack){for(var c in w)this[c]=w[c];return!1}return!1},"test_match"),next:h(function(){if(this.done)return this.EOF;this._input||(this.done=!0);var l,m,T,d;this._more||(this.yytext="",this.match="");for(var w=this._currentRules(),c=0;c<w.length;c++)if(T=this._input.match(this.rules[w[c]]),T&&(!m||T[0].length>m[0].length)){if(m=T,d=c,this.options.backtrack_lexer){if(l=this.test_match(T,w[c]),l!==!1)return l;if(this._backtrack){m=!1;continue}else return!1}else if(!this.options.flex)break}return m?(l=this.test_match(m,w[d]),l!==!1?l:!1):this._input===""?this.EOF:this.parseError("Lexical error on line "+(this.yylineno+1)+`. Unrecognized text.
-`+this.showPosition(),{text:"",token:null,line:this.yylineno})},"next"),lex:h(function(){var m=this.next();return m||this.lex()},"lex"),begin:h(function(m){this.conditionStack.push(m)},"begin"),popState:h(function(){var m=this.conditionStack.length-1;return m>0?this.conditionStack.pop():this.conditionStack[0]},"popState"),_currentRules:h(function(){return this.conditionStack.length&&this.conditionStack[this.conditionStack.length-1]?this.conditions[this.conditionStack[this.conditionStack.length-1]].rules:this.conditions.INITIAL.rules},"_currentRules"),topState:h(function(m){return m=this.conditionStack.length-1-Math.abs(m||0),m>=0?this.conditionStack[m]:"INITIAL"},"topState"),pushState:h(function(m){this.begin(m)},"pushState"),stateStackSize:h(function(){return this.conditionStack.length},"stateStackSize"),options:{"case-insensitive":!0},performAction:h(function(m,T,d,w){switch(d){case 0:return this.begin("open_directive"),"open_directive";case 1:return this.begin("acc_title"),31;case 2:return this.popState(),"acc_title_value";case 3:return this.begin("acc_descr"),33;case 4:return this.popState(),"acc_descr_value";case 5:this.begin("acc_descr_multiline");break;case 6:this.popState();break;case 7:return"acc_descr_multiline_value";case 8:break;case 9:break;case 10:break;case 11:return 10;case 12:break;case 13:break;case 14:this.begin("href");break;case 15:this.popState();break;case 16:return 43;case 17:this.begin("callbackname");break;case 18:this.popState();break;case 19:this.popState(),this.begin("callbackargs");break;case 20:return 41;case 21:this.popState();break;case 22:return 42;case 23:this.begin("click");break;case 24:this.popState();break;case 25:return 40;case 26:return 4;case 27:return 22;case 28:return 23;case 29:return 24;case 30:return 25;case 31:return 26;case 32:return 28;case 33:return 27;case 34:return 29;case 35:return 12;case 36:return 13;case 37:return 14;case 38:return 15;case 39:return 16;case 40:return 17;case 41:return 18;case 42:return 20;case 43:return 21;case 44:return"date";case 45:return 30;case 46:return"accDescription";case 47:return 36;case 48:return 38;case 49:return 39;case 50:return":";case 51:return 6;case 52:return"INVALID"}},"anonymous"),rules:[/^(?:%%\{)/i,/^(?:accTitle\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*\{\s*)/i,/^(?:[\}])/i,/^(?:[^\}]*)/i,/^(?:%%(?!\{)*[^\n]*)/i,/^(?:[^\}]%%*[^\n]*)/i,/^(?:%%*[^\n]*[\n]*)/i,/^(?:[\n]+)/i,/^(?:\s+)/i,/^(?:%[^\n]*)/i,/^(?:href[\s]+["])/i,/^(?:["])/i,/^(?:[^"]*)/i,/^(?:call[\s]+)/i,/^(?:\([\s]*\))/i,/^(?:\()/i,/^(?:[^(]*)/i,/^(?:\))/i,/^(?:[^)]*)/i,/^(?:click[\s]+)/i,/^(?:[\s\n])/i,/^(?:[^\s\n]*)/i,/^(?:gantt\b)/i,/^(?:dateFormat\s[^#\n;]+)/i,/^(?:inclusiveEndDates\b)/i,/^(?:topAxis\b)/i,/^(?:axisFormat\s[^#\n;]+)/i,/^(?:tickInterval\s[^#\n;]+)/i,/^(?:includes\s[^#\n;]+)/i,/^(?:excludes\s[^#\n;]+)/i,/^(?:todayMarker\s[^\n;]+)/i,/^(?:weekday\s+monday\b)/i,/^(?:weekday\s+tuesday\b)/i,/^(?:weekday\s+wednesday\b)/i,/^(?:weekday\s+thursday\b)/i,/^(?:weekday\s+friday\b)/i,/^(?:weekday\s+saturday\b)/i,/^(?:weekday\s+sunday\b)/i,/^(?:weekend\s+friday\b)/i,/^(?:weekend\s+saturday\b)/i,/^(?:\d\d\d\d-\d\d-\d\d\b)/i,/^(?:title\s[^\n]+)/i,/^(?:accDescription\s[^#\n;]+)/i,/^(?:section\s[^\n]+)/i,/^(?:[^:\n]+)/i,/^(?::[^#\n;]+)/i,/^(?::)/i,/^(?:$)/i,/^(?:.)/i],conditions:{acc_descr_multiline:{rules:[6,7],inclusive:!1},acc_descr:{rules:[4],inclusive:!1},acc_title:{rules:[2],inclusive:!1},callbackargs:{rules:[21,22],inclusive:!1},callbackname:{rules:[18,19,20],inclusive:!1},href:{rules:[15,16],inclusive:!1},click:{rules:[24,25],inclusive:!1},INITIAL:{rules:[0,1,3,5,8,9,10,11,12,13,14,17,23,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52],inclusive:!0}}};return U})();F.lexer=S;function v(){this.yy={}}return h(v,"Parser"),v.prototype=F,F.Parser=v,new v})();ve.parser=ve;var za=ve;at.extend(La);at.extend(Oa);at.extend(Pa);var Ke={friday:5,saturday:6},lt="",Me="",_e=void 0,Se="",Pt=[],zt=[],Fe=new Map,Ye=[],re=[],Et="",Ue="",Cn=["active","done","crit","milestone","vert"],Ee=[],Rt=!1,Le=!1,Ae="sunday",ae="saturday",Te=0,Ra=h(function(){Ye=[],re=[],Et="",Ee=[],jt=0,xe=void 0,Jt=void 0,tt=[],lt="",Me="",Ue="",_e=void 0,Se="",Pt=[],zt=[],Rt=!1,Le=!1,Te=0,Fe=new Map,qn(),Ae="sunday",ae="saturday"},"clear"),qa=h(function(t){Me=t},"setAxisFormat"),Ba=h(function(){return Me},"getAxisFormat"),Za=h(function(t){_e=t},"setTickInterval"),Xa=h(function(){return _e},"getTickInterval"),Ga=h(function(t){Se=t},"setTodayMarker"),$a=h(function(){return Se},"getTodayMarker"),Qa=h(function(t){lt=t},"setDateFormat"),ja=h(function(){Rt=!0},"enableInclusiveEndDates"),Ja=h(function(){return Rt},"endDatesAreInclusive"),Ka=h(function(){Le=!0},"enableTopAxis"),ti=h(function(){return Le},"topAxisEnabled"),ei=h(function(t){Ue=t},"setDisplayMode"),ni=h(function(){return Ue},"getDisplayMode"),ri=h(function(){return lt},"getDateFormat"),ai=h(function(t){Pt=t.toLowerCase().split(/[\s,]+/)},"setIncludes"),ii=h(function(){return Pt},"getIncludes"),si=h(function(t){zt=t.toLowerCase().split(/[\s,]+/)},"setExcludes"),oi=h(function(){return zt},"getExcludes"),ci=h(function(){return Fe},"getLinks"),ui=h(function(t){Et=t,Ye.push(t)},"addSection"),li=h(function(){return Ye},"getSections"),fi=h(function(){let t=tn();const e=10;let n=0;for(;!t&&n<e;)t=tn(),n++;return re=tt,re},"getTasks"),Mn=h(function(t,e,n,r){const a=t.format(e.trim()),i=t.format("YYYY-MM-DD");return r.includes(a)||r.includes(i)?!1:n.includes("weekends")&&(t.isoWeekday()===Ke[ae]||t.isoWeekday()===Ke[ae]+1)||n.includes(t.format("dddd").toLowerCase())?!0:n.includes(a)||n.includes(i)},"isInvalidDate"),hi=h(function(t){Ae=t},"setWeekday"),di=h(function(){return Ae},"getWeekday"),mi=h(function(t){ae=t},"setWeekend"),_n=h(function(t,e,n,r){if(!n.length||t.manualEndTime)return;let a;t.startTime instanceof Date?a=at(t.startTime):a=at(t.startTime,e,!0),a=a.add(1,"d");let i;t.endTime instanceof Date?i=at(t.endTime):i=at(t.endTime,e,!0);const[s,y]=gi(a,i,e,n,r);t.endTime=s.toDate(),t.renderEndTime=y},"checkTaskDates"),gi=h(function(t,e,n,r,a){let i=!1,s=null;for(;t<=e;)i||(s=e.toDate()),i=Mn(t,n,r,a),i&&(e=e.add(1,"d")),t=t.add(1,"d");return[e,s]},"fixTaskDates"),be=h(function(t,e,n){if(n=n.trim(),(e.trim()==="x"||e.trim()==="X")&&/^\d+$/.test(n))return new Date(Number(n));const a=/^after\s+(?<ids>[\d\w- ]+)/.exec(n);if(a!==null){let s=null;for(const _ of a.groups.ids.split(" ")){let p=Ct(_);p!==void 0&&(!s||p.endTime>s.endTime)&&(s=p)}if(s)return s.endTime;const y=new Date;return y.setHours(0,0,0,0),y}let i=at(n,e.trim(),!0);if(i.isValid())return i.toDate();{Kt.debug("Invalid date:"+n),Kt.debug("With date format:"+e.trim());const s=new Date(n);if(s===void 0||isNaN(s.getTime())||s.getFullYear()<-1e4||s.getFullYear()>1e4)throw new Error("Invalid date:"+n);return s}},"getStartDate"),Sn=h(function(t){const e=/^(\d+(?:\.\d+)?)([Mdhmswy]|ms)$/.exec(t.trim());return e!==null?[Number.parseFloat(e[1]),e[2]]:[NaN,"ms"]},"parseDuration"),Fn=h(function(t,e,n,r=!1){n=n.trim();const i=/^until\s+(?<ids>[\d\w- ]+)/.exec(n);if(i!==null){let g=null;for(const C of i.groups.ids.split(" ")){let b=Ct(C);b!==void 0&&(!g||b.startTime<g.startTime)&&(g=b)}if(g)return g.startTime;const E=new Date;return E.setHours(0,0,0,0),E}let s=at(n,e.trim(),!0);if(s.isValid())return r&&(s=s.add(1,"d")),s.toDate();let y=at(t);const[_,p]=Sn(n);if(!Number.isNaN(_)){const g=y.add(_,p);g.isValid()&&(y=g)}return y.toDate()},"getEndDate"),jt=0,Ft=h(function(t){return t===void 0?(jt=jt+1,"task"+jt):t},"parseId"),yi=h(function(t,e){let n;e.substr(0,1)===":"?n=e.substr(1,e.length):n=e;const r=n.split(","),a={};Ie(r,a,Cn);for(let s=0;s<r.length;s++)r[s]=r[s].trim();let i="";switch(r.length){case 1:a.id=Ft(),a.startTime=t.endTime,i=r[0];break;case 2:a.id=Ft(),a.startTime=be(void 0,lt,r[0]),i=r[1];break;case 3:a.id=Ft(r[0]),a.startTime=be(void 0,lt,r[1]),i=r[2];break}return i&&(a.endTime=Fn(a.startTime,lt,i,Rt),a.manualEndTime=at(i,"YYYY-MM-DD",!0).isValid(),_n(a,lt,zt,Pt)),a},"compileData"),ki=h(function(t,e){let n;e.substr(0,1)===":"?n=e.substr(1,e.length):n=e;const r=n.split(","),a={};Ie(r,a,Cn);for(let i=0;i<r.length;i++)r[i]=r[i].trim();switch(r.length){case 1:a.id=Ft(),a.startTime={type:"prevTaskEnd",id:t},a.endTime={data:r[0]};break;case 2:a.id=Ft(),a.startTime={type:"getStartDate",startData:r[0]},a.endTime={data:r[1]};break;case 3:a.id=Ft(r[0]),a.startTime={type:"getStartDate",startData:r[1]},a.endTime={data:r[2]};break}return a},"parseData"),xe,Jt,tt=[],Yn={},pi=h(function(t,e){const n={section:Et,type:Et,processed:!1,manualEndTime:!1,renderEndTime:null,raw:{data:e},task:t,classes:[]},r=ki(Jt,e);n.raw.startTime=r.startTime,n.raw.endTime=r.endTime,n.id=r.id,n.prevTaskId=Jt,n.active=r.active,n.done=r.done,n.crit=r.crit,n.milestone=r.milestone,n.vert=r.vert,n.order=Te,Te++;const a=tt.push(n);Jt=n.id,Yn[n.id]=a-1},"addTask"),Ct=h(function(t){const e=Yn[t];return tt[e]},"findTaskById"),vi=h(function(t,e){const n={section:Et,type:Et,description:t,task:t,classes:[]},r=yi(xe,e);n.startTime=r.startTime,n.endTime=r.endTime,n.id=r.id,n.active=r.active,n.done=r.done,n.crit=r.crit,n.milestone=r.milestone,n.vert=r.vert,xe=n,re.push(n)},"addTaskOrg"),tn=h(function(){const t=h(function(n){const r=tt[n];let a="";switch(tt[n].raw.startTime.type){case"prevTaskEnd":{const i=Ct(r.prevTaskId);r.startTime=i.endTime;break}case"getStartDate":a=be(void 0,lt,tt[n].raw.startTime.startData),a&&(tt[n].startTime=a);break}return tt[n].startTime&&(tt[n].endTime=Fn(tt[n].startTime,lt,tt[n].raw.endTime.data,Rt),tt[n].endTime&&(tt[n].processed=!0,tt[n].manualEndTime=at(tt[n].raw.endTime.data,"YYYY-MM-DD",!0).isValid(),_n(tt[n],lt,zt,Pt))),tt[n].processed},"compileTask");let e=!0;for(const[n,r]of tt.entries())t(n),e=e&&r.processed;return e},"compileTasks"),Ti=h(function(t,e){let n=e;_t().securityLevel!=="loose"&&(n=Rn.sanitizeUrl(e)),t.split(",").forEach(function(r){Ct(r)!==void 0&&(En(r,()=>{window.open(n,"_self")}),Fe.set(r,n))}),Un(t,"clickable")},"setLink"),Un=h(function(t,e){t.split(",").forEach(function(n){let r=Ct(n);r!==void 0&&r.classes.push(e)})},"setClass"),bi=h(function(t,e,n){if(_t().securityLevel!=="loose"||e===void 0)return;let r=[];if(typeof n=="string"){r=n.split(/,(?=(?:(?:[^"]*"){2})*[^"]*$)/);for(let i=0;i<r.length;i++){let s=r[i].trim();s.startsWith('"')&&s.endsWith('"')&&(s=s.substr(1,s.length-2)),r[i]=s}}r.length===0&&r.push(t),Ct(t)!==void 0&&En(t,()=>{Bn.runFunc(e,...r)})},"setClickFun"),En=h(function(t,e){Ee.push(function(){const n=document.querySelector(`[id="${t}"]`);n!==null&&n.addEventListener("click",function(){e()})},function(){const n=document.querySelector(`[id="${t}-text"]`);n!==null&&n.addEventListener("click",function(){e()})})},"pushFun"),xi=h(function(t,e,n){t.split(",").forEach(function(r){bi(r,e,n)}),Un(t,"clickable")},"setClickEvent"),wi=h(function(t){Ee.forEach(function(e){e(t)})},"bindFunctions"),Di={getConfig:h(()=>_t().gantt,"getConfig"),clear:Ra,setDateFormat:Qa,getDateFormat:ri,enableInclusiveEndDates:ja,endDatesAreInclusive:Ja,enableTopAxis:Ka,topAxisEnabled:ti,setAxisFormat:qa,getAxisFormat:Ba,setTickInterval:Za,getTickInterval:Xa,setTodayMarker:Ga,getTodayMarker:$a,setAccTitle:Vn,getAccTitle:Nn,setDiagramTitle:Hn,getDiagramTitle:On,setDisplayMode:ei,getDisplayMode:ni,setAccDescription:Wn,getAccDescription:In,addSection:ui,getSections:li,getTasks:fi,addTask:pi,findTaskById:Ct,addTaskOrg:vi,setIncludes:ai,getIncludes:ii,setExcludes:si,getExcludes:oi,setClickEvent:xi,setLink:Ti,getLinks:ci,bindFunctions:wi,parseDuration:Sn,isInvalidDate:Mn,setWeekday:hi,getWeekday:di,setWeekend:mi};function Ie(t,e,n){let r=!0;for(;r;)r=!1,n.forEach(function(a){const i="^\\s*"+a+"\\s*$",s=new RegExp(i);t[0].match(s)&&(e[a]=!0,t.shift(1),r=!0)})}h(Ie,"getTaskTags");var Ci=h(function(){Kt.debug("Something is calling, setConf, remove the call")},"setConf"),en={monday:Ht,tuesday:gn,wednesday:yn,thursday:bt,friday:kn,saturday:pn,sunday:Vt},Mi=h((t,e)=>{let n=[...t].map(()=>-1/0),r=[...t].sort((i,s)=>i.startTime-s.startTime||i.order-s.order),a=0;for(const i of r)for(let s=0;s<n.length;s++)if(i.startTime>=n[s]){n[s]=i.endTime,i.order=s+e,s>a&&(a=s);break}return a},"getMaxIntersections"),ht,_i=h(function(t,e,n,r){const a=_t().gantt,i=_t().securityLevel;let s;i==="sandbox"&&(s=Bt("#i"+e));const y=i==="sandbox"?Bt(s.nodes()[0].contentDocument.body):Bt("body"),_=i==="sandbox"?s.nodes()[0].contentDocument:document,p=_.getElementById(e);ht=p.parentElement.offsetWidth,ht===void 0&&(ht=1200),a.useWidth!==void 0&&(ht=a.useWidth);const g=r.db.getTasks();let E=[];for(const x of g)E.push(x.type);E=H(E);const C={};let b=2*a.topPadding;if(r.db.getDisplayMode()==="compact"||a.displayMode==="compact"){const x={};for(const F of g)x[F.section]===void 0?x[F.section]=[F]:x[F.section].push(F);let Y=0;for(const F of Object.keys(x)){const S=Mi(x[F],Y)+1;Y+=S,b+=S*(a.barHeight+a.barGap),C[F]=S}}else{b+=g.length*(a.barHeight+a.barGap);for(const x of E)C[x]=g.filter(Y=>Y.type===x).length}p.setAttribute("viewBox","0 0 "+ht+" "+b);const X=y.select(`[id="${e}"]`),O=Fa().domain([Jn(g,function(x){return x.startTime}),jn(g,function(x){return x.endTime})]).rangeRound([0,ht-a.leftPadding-a.rightPadding]);function M(x,Y){const F=x.startTime,S=Y.startTime;let v=0;return F>S?v=1:F<S&&(v=-1),v}h(M,"taskCompare"),g.sort(M),I(g,ht,b),Pn(X,b,ht,a.useMaxWidth),X.append("text").text(r.db.getDiagramTitle()).attr("x",ht/2).attr("y",a.titleTopMargin).attr("class","titleText");function I(x,Y,F){const S=a.barHeight,v=S+a.barGap,U=a.topPadding,l=a.leftPadding,m=$n().domain([0,E.length]).range(["#00B9FA","#F95002"]).interpolate(dr);W(v,U,l,Y,F,x,r.db.getExcludes(),r.db.getIncludes()),B(l,U,Y,F),V(x,v,U,l,S,m,Y),Q(v,U),D(l,U,Y,F)}h(I,"makeGantt");function V(x,Y,F,S,v,U,l){x.sort((u,o)=>u.vert===o.vert?0:u.vert?1:-1);const T=[...new Set(x.map(u=>u.order))].map(u=>x.find(o=>o.order===u));X.append("g").selectAll("rect").data(T).enter().append("rect").attr("x",0).attr("y",function(u,o){return o=u.order,o*Y+F-2}).attr("width",function(){return l-a.rightPadding/2}).attr("height",Y).attr("class",function(u){for(const[o,z]of E.entries())if(u.type===z)return"section section"+o%a.numberSectionStyles;return"section section0"}).enter();const d=X.append("g").selectAll("rect").data(x).enter(),w=r.db.getLinks();if(d.append("rect").attr("id",function(u){return u.id}).attr("rx",3).attr("ry",3).attr("x",function(u){return u.milestone?O(u.startTime)+S+.5*(O(u.endTime)-O(u.startTime))-.5*v:O(u.startTime)+S}).attr("y",function(u,o){return o=u.order,u.vert?a.gridLineStartPadding:o*Y+F}).attr("width",function(u){return u.milestone?v:u.vert?.08*v:O(u.renderEndTime||u.endTime)-O(u.startTime)}).attr("height",function(u){return u.vert?g.length*(a.barHeight+a.barGap)+a.barHeight*2:v}).attr("transform-origin",function(u,o){return o=u.order,(O(u.startTime)+S+.5*(O(u.endTime)-O(u.startTime))).toString()+"px "+(o*Y+F+.5*v).toString()+"px"}).attr("class",function(u){const o="task";let z="";u.classes.length>0&&(z=u.classes.join(" "));let P=0;for(const[K,G]of E.entries())u.type===G&&(P=K%a.numberSectionStyles);let R="";return u.active?u.crit?R+=" activeCrit":R=" active":u.done?u.crit?R=" doneCrit":R=" done":u.crit&&(R+=" crit"),R.length===0&&(R=" task"),u.milestone&&(R=" milestone "+R),u.vert&&(R=" vert "+R),R+=P,R+=" "+z,o+R}),d.append("text").attr("id",function(u){return u.id+"-text"}).text(function(u){return u.task}).attr("font-size",a.fontSize).attr("x",function(u){let o=O(u.startTime),z=O(u.renderEndTime||u.endTime);if(u.milestone&&(o+=.5*(O(u.endTime)-O(u.startTime))-.5*v,z=o+v),u.vert)return O(u.startTime)+S;const P=this.getBBox().width;return P>z-o?z+P+1.5*a.leftPadding>l?o+S-5:z+S+5:(z-o)/2+o+S}).attr("y",function(u,o){return u.vert?a.gridLineStartPadding+g.length*(a.barHeight+a.barGap)+60:(o=u.order,o*Y+a.barHeight/2+(a.fontSize/2-2)+F)}).attr("text-height",v).attr("class",function(u){const o=O(u.startTime);let z=O(u.endTime);u.milestone&&(z=o+v);const P=this.getBBox().width;let R="";u.classes.length>0&&(R=u.classes.join(" "));let K=0;for(const[j,it]of E.entries())u.type===it&&(K=j%a.numberSectionStyles);let G="";return u.active&&(u.crit?G="activeCritText"+K:G="activeText"+K),u.done?u.crit?G=G+" doneCritText"+K:G=G+" doneText"+K:u.crit&&(G=G+" critText"+K),u.milestone&&(G+=" milestoneText"),u.vert&&(G+=" vertText"),P>z-o?z+P+1.5*a.leftPadding>l?R+" taskTextOutsideLeft taskTextOutside"+K+" "+G:R+" taskTextOutsideRight taskTextOutside"+K+" "+G+" width-"+P:R+" taskText taskText"+K+" "+G+" width-"+P}),_t().securityLevel==="sandbox"){let u;u=Bt("#i"+e);const o=u.nodes()[0].contentDocument;d.filter(function(z){return w.has(z.id)}).each(function(z){var P=o.querySelector("#"+z.id),R=o.querySelector("#"+z.id+"-text");const K=P.parentNode;var G=o.createElement("a");G.setAttribute("xlink:href",w.get(z.id)),G.setAttribute("target","_top"),K.appendChild(G),G.appendChild(P),G.appendChild(R)})}}h(V,"drawRects");function W(x,Y,F,S,v,U,l,m){if(l.length===0&&m.length===0)return;let T,d;for(const{startTime:P,endTime:R}of U)(T===void 0||P<T)&&(T=P),(d===void 0||R>d)&&(d=R);if(!T||!d)return;if(at(d).diff(at(T),"year")>5){Kt.warn("The difference between the min and max time is more than 5 years. This will cause performance issues. Skipping drawing exclude days.");return}const w=r.db.getDateFormat(),c=[];let u=null,o=at(T);for(;o.valueOf()<=d;)r.db.isInvalidDate(o,w,l,m)?u?u.end=o:u={start:o,end:o}:u&&(c.push(u),u=null),o=o.add(1,"d");X.append("g").selectAll("rect").data(c).enter().append("rect").attr("id",P=>"exclude-"+P.start.format("YYYY-MM-DD")).attr("x",P=>O(P.start.startOf("day"))+F).attr("y",a.gridLineStartPadding).attr("width",P=>O(P.end.endOf("day"))-O(P.start.startOf("day"))).attr("height",v-Y-a.gridLineStartPadding).attr("transform-origin",function(P,R){return(O(P.start)+F+.5*(O(P.end)-O(P.start))).toString()+"px "+(R*x+.5*v).toString()+"px"}).attr("class","exclude-range")}h(W,"drawExcludeDays");function B(x,Y,F,S){const v=r.db.getDateFormat(),U=r.db.getAxisFormat();let l;U?l=U:v==="D"?l="%d":l=a.axisFormat??"%Y-%m-%d";let m=sr(O).tickSize(-S+Y+a.gridLineStartPadding).tickFormat(ne(l));const d=/^([1-9]\d*)(millisecond|second|minute|hour|day|week|month)$/.exec(r.db.getTickInterval()||a.tickInterval);if(d!==null){const w=d[1],c=d[2],u=r.db.getWeekday()||a.weekday;switch(c){case"millisecond":m.ticks(Yt.every(w));break;case"second":m.ticks(vt.every(w));break;case"minute":m.ticks(Wt.every(w));break;case"hour":m.ticks(Ot.every(w));break;case"day":m.ticks(Tt.every(w));break;case"week":m.ticks(en[u].every(w));break;case"month":m.ticks(Nt.every(w));break}}if(X.append("g").attr("class","grid").attr("transform","translate("+x+", "+(S-50)+")").call(m).selectAll("text").style("text-anchor","middle").attr("fill","#000").attr("stroke","none").attr("font-size",10).attr("dy","1em"),r.db.topAxisEnabled()||a.topAxis){let w=ir(O).tickSize(-S+Y+a.gridLineStartPadding).tickFormat(ne(l));if(d!==null){const c=d[1],u=d[2],o=r.db.getWeekday()||a.weekday;switch(u){case"millisecond":w.ticks(Yt.every(c));break;case"second":w.ticks(vt.every(c));break;case"minute":w.ticks(Wt.every(c));break;case"hour":w.ticks(Ot.every(c));break;case"day":w.ticks(Tt.every(c));break;case"week":w.ticks(en[o].every(c));break;case"month":w.ticks(Nt.every(c));break}}X.append("g").attr("class","grid").attr("transform","translate("+x+", "+Y+")").call(w).selectAll("text").style("text-anchor","middle").attr("fill","#000").attr("stroke","none").attr("font-size",10)}}h(B,"makeGrid");function Q(x,Y){let F=0;const S=Object.keys(C).map(v=>[v,C[v]]);X.append("g").selectAll("text").data(S).enter().append(function(v){const U=v[0].split(zn.lineBreakRegex),l=-(U.length-1)/2,m=_.createElementNS("http://www.w3.org/2000/svg","text");m.setAttribute("dy",l+"em");for(const[T,d]of U.entries()){const w=_.createElementNS("http://www.w3.org/2000/svg","tspan");w.setAttribute("alignment-baseline","central"),w.setAttribute("x","10"),T>0&&w.setAttribute("dy","1em"),w.textContent=d,m.appendChild(w)}return m}).attr("x",10).attr("y",function(v,U){if(U>0)for(let l=0;l<U;l++)return F+=S[U-1][1],v[1]*x/2+F*x+Y;else return v[1]*x/2+Y}).attr("font-size",a.sectionFontSize).attr("class",function(v){for(const[U,l]of E.entries())if(v[0]===l)return"sectionTitle sectionTitle"+U%a.numberSectionStyles;return"sectionTitle"})}h(Q,"vertLabels");function D(x,Y,F,S){const v=r.db.getTodayMarker();if(v==="off")return;const U=X.append("g").attr("class","today"),l=new Date,m=U.append("line");m.attr("x1",O(l)+x).attr("x2",O(l)+x).attr("y1",a.titleTopMargin).attr("y2",S-a.titleTopMargin).attr("class","today"),v!==""&&m.attr("style",v.replace(/,/g,";"))}h(D,"drawToday");function H(x){const Y={},F=[];for(let S=0,v=x.length;S<v;++S)Object.prototype.hasOwnProperty.call(Y,x[S])||(Y[x[S]]=!0,F.push(x[S]));return F}h(H,"checkUnique")},"draw"),Si={setConf:Ci,draw:_i},Fi=h(t=>`
-  .mermaid-main-font {
-        font-family: ${t.fontFamily};
-  }
-
-  .exclude-range {
-    fill: ${t.excludeBkgColor};
-  }
-
-  .section {
-    stroke: none;
-    opacity: 0.2;
-  }
-
-  .section0 {
-    fill: ${t.sectionBkgColor};
-  }
-
-  .section2 {
-    fill: ${t.sectionBkgColor2};
-  }
-
-  .section1,
-  .section3 {
-    fill: ${t.altSectionBkgColor};
-    opacity: 0.2;
-  }
-
-  .sectionTitle0 {
-    fill: ${t.titleColor};
-  }
-
-  .sectionTitle1 {
-    fill: ${t.titleColor};
-  }
-
-  .sectionTitle2 {
-    fill: ${t.titleColor};
-  }
-
-  .sectionTitle3 {
-    fill: ${t.titleColor};
-  }
-
-  .sectionTitle {
-    text-anchor: start;
-    font-family: ${t.fontFamily};
-  }
-
-
-  /* Grid and axis */
-
-  .grid .tick {
-    stroke: ${t.gridColor};
-    opacity: 0.8;
-    shape-rendering: crispEdges;
-  }
-
-  .grid .tick text {
-    font-family: ${t.fontFamily};
-    fill: ${t.textColor};
-  }
-
-  .grid path {
-    stroke-width: 0;
-  }
-
-
-  /* Today line */
-
-  .today {
-    fill: none;
-    stroke: ${t.todayLineColor};
-    stroke-width: 2px;
-  }
-
-
-  /* Task styling */
-
-  /* Default task */
-
-  .task {
-    stroke-width: 2;
-  }
-
-  .taskText {
-    text-anchor: middle;
-    font-family: ${t.fontFamily};
-  }
-
-  .taskTextOutsideRight {
-    fill: ${t.taskTextDarkColor};
-    text-anchor: start;
-    font-family: ${t.fontFamily};
-  }
-
-  .taskTextOutsideLeft {
-    fill: ${t.taskTextDarkColor};
-    text-anchor: end;
-  }
-
-
-  /* Special case clickable */
-
-  .task.clickable {
-    cursor: pointer;
-  }
-
-  .taskText.clickable {
-    cursor: pointer;
-    fill: ${t.taskTextClickableColor} !important;
-    font-weight: bold;
-  }
-
-  .taskTextOutsideLeft.clickable {
-    cursor: pointer;
-    fill: ${t.taskTextClickableColor} !important;
-    font-weight: bold;
-  }
-
-  .taskTextOutsideRight.clickable {
-    cursor: pointer;
-    fill: ${t.taskTextClickableColor} !important;
-    font-weight: bold;
-  }
-
-
-  /* Specific task settings for the sections*/
-
-  .taskText0,
-  .taskText1,
-  .taskText2,
-  .taskText3 {
-    fill: ${t.taskTextColor};
-  }
-
-  .task0,
-  .task1,
-  .task2,
-  .task3 {
-    fill: ${t.taskBkgColor};
-    stroke: ${t.taskBorderColor};
-  }
-
-  .taskTextOutside0,
-  .taskTextOutside2
-  {
-    fill: ${t.taskTextOutsideColor};
-  }
-
-  .taskTextOutside1,
-  .taskTextOutside3 {
-    fill: ${t.taskTextOutsideColor};
-  }
-
-
-  /* Active task */
-
-  .active0,
-  .active1,
-  .active2,
-  .active3 {
-    fill: ${t.activeTaskBkgColor};
-    stroke: ${t.activeTaskBorderColor};
-  }
-
-  .activeText0,
-  .activeText1,
-  .activeText2,
-  .activeText3 {
-    fill: ${t.taskTextDarkColor} !important;
-  }
-
-
-  /* Completed task */
-
-  .done0,
-  .done1,
-  .done2,
-  .done3 {
-    stroke: ${t.doneTaskBorderColor};
-    fill: ${t.doneTaskBkgColor};
-    stroke-width: 2;
-  }
-
-  .doneText0,
-  .doneText1,
-  .doneText2,
-  .doneText3 {
-    fill: ${t.taskTextDarkColor} !important;
-  }
-
-
-  /* Tasks on the critical line */
-
-  .crit0,
-  .crit1,
-  .crit2,
-  .crit3 {
-    stroke: ${t.critBorderColor};
-    fill: ${t.critBkgColor};
-    stroke-width: 2;
-  }
-
-  .activeCrit0,
-  .activeCrit1,
-  .activeCrit2,
-  .activeCrit3 {
-    stroke: ${t.critBorderColor};
-    fill: ${t.activeTaskBkgColor};
-    stroke-width: 2;
-  }
-
-  .doneCrit0,
-  .doneCrit1,
-  .doneCrit2,
-  .doneCrit3 {
-    stroke: ${t.critBorderColor};
-    fill: ${t.doneTaskBkgColor};
-    stroke-width: 2;
-    cursor: pointer;
-    shape-rendering: crispEdges;
-  }
-
-  .milestone {
-    transform: rotate(45deg) scale(0.8,0.8);
-  }
-
-  .milestoneText {
-    font-style: italic;
-  }
-  .doneCritText0,
-  .doneCritText1,
-  .doneCritText2,
-  .doneCritText3 {
-    fill: ${t.taskTextDarkColor} !important;
-  }
-
-  .vert {
-    stroke: ${t.vertLineColor};
-  }
-
-  .vertText {
-    font-size: 15px;
-    text-anchor: middle;
-    fill: ${t.vertLineColor} !important;
-  }
-
-  .activeCritText0,
-  .activeCritText1,
-  .activeCritText2,
-  .activeCritText3 {
-    fill: ${t.taskTextDarkColor} !important;
-  }
-
-  .titleText {
-    text-anchor: middle;
-    font-size: 18px;
-    fill: ${t.titleColor||t.textColor};
-    font-family: ${t.fontFamily};
-  }
-`,"getStyles"),Yi=Fi,Ii={parser:za,db:Di,renderer:Si,styles:Yi};export{Ii as diagram};
diff --git a/docs/dist/assets/gitGraphDiagram-NY62KEGX-Dx-Iakkv.js b/docs/dist/assets/gitGraphDiagram-NY62KEGX-Dx-Iakkv.js
deleted file mode 100644
index 41770044..00000000
--- a/docs/dist/assets/gitGraphDiagram-NY62KEGX-Dx-Iakkv.js
+++ /dev/null
@@ -1,65 +0,0 @@
-import{p as Y}from"./chunk-4BX2VUAB-BU7cqk0M.js";import{I as K}from"./chunk-QZHKN3VN-CEAug577.js";import{_ as l,q as U,p as V,s as X,g as J,a as Q,b as Z,l as m,c as rr,d as er,u as tr,C as ar,y as sr,k as C,D as nr,E as or,F as cr,G as ir}from"./index-BxX29htg.js";import{p as dr}from"./treemap-KMMF4GRG-DFERHDZP.js";import"./_baseUniq-CfjWcJYV.js";import"./_basePickBy-CqMtcO3s.js";import"./clone-BRV0rZiZ.js";var x={NORMAL:0,REVERSE:1,HIGHLIGHT:2,MERGE:3,CHERRY_PICK:4},hr=cr.gitGraph,I=l(()=>nr({...hr,...or().gitGraph}),"getConfig"),c=new K(()=>{const t=I(),r=t.mainBranchName,s=t.mainBranchOrder;return{mainBranchName:r,commits:new Map,head:null,branchConfig:new Map([[r,{name:r,order:s}]]),branches:new Map([[r,null]]),currBranch:r,direction:"LR",seq:0,options:{}}});function A(){return ir({length:7})}l(A,"getID");function F(t,r){const s=Object.create(null);return t.reduce((n,e)=>{const a=r(e);return s[a]||(s[a]=!0,n.push(e)),n},[])}l(F,"uniqBy");var lr=l(function(t){c.records.direction=t},"setDirection"),$r=l(function(t){m.debug("options str",t),t=t?.trim(),t=t||"{}";try{c.records.options=JSON.parse(t)}catch(r){m.error("error while parsing gitGraph options",r.message)}},"setOptions"),fr=l(function(){return c.records.options},"getOptions"),gr=l(function(t){let r=t.msg,s=t.id;const n=t.type;let e=t.tags;m.info("commit",r,s,n,e),m.debug("Entering commit:",r,s,n,e);const a=I();s=C.sanitizeText(s,a),r=C.sanitizeText(r,a),e=e?.map(o=>C.sanitizeText(o,a));const d={id:s||c.records.seq+"-"+A(),message:r,seq:c.records.seq++,type:n??x.NORMAL,tags:e??[],parents:c.records.head==null?[]:[c.records.head.id],branch:c.records.currBranch};c.records.head=d,m.info("main branch",a.mainBranchName),c.records.commits.has(d.id)&&m.warn(`Commit ID ${d.id} already exists`),c.records.commits.set(d.id,d),c.records.branches.set(c.records.currBranch,d.id),m.debug("in pushCommit "+d.id)},"commit"),yr=l(function(t){let r=t.name;const s=t.order;if(r=C.sanitizeText(r,I()),c.records.branches.has(r))throw new Error(`Trying to create an existing branch. (Help: Either use a new name if you want create a new branch or try using "checkout ${r}")`);c.records.branches.set(r,c.records.head!=null?c.records.head.id:null),c.records.branchConfig.set(r,{name:r,order:s}),z(r),m.debug("in createBranch")},"branch"),ur=l(t=>{let r=t.branch,s=t.id;const n=t.type,e=t.tags,a=I();r=C.sanitizeText(r,a),s&&(s=C.sanitizeText(s,a));const d=c.records.branches.get(c.records.currBranch),o=c.records.branches.get(r),f=d?c.records.commits.get(d):void 0,h=o?c.records.commits.get(o):void 0;if(f&&h&&f.branch===r)throw new Error(`Cannot merge branch '${r}' into itself.`);if(c.records.currBranch===r){const i=new Error('Incorrect usage of "merge". Cannot merge a branch to itself');throw i.hash={text:`merge ${r}`,token:`merge ${r}`,expected:["branch abc"]},i}if(f===void 0||!f){const i=new Error(`Incorrect usage of "merge". Current branch (${c.records.currBranch})has no commits`);throw i.hash={text:`merge ${r}`,token:`merge ${r}`,expected:["commit"]},i}if(!c.records.branches.has(r)){const i=new Error('Incorrect usage of "merge". Branch to be merged ('+r+") does not exist");throw i.hash={text:`merge ${r}`,token:`merge ${r}`,expected:[`branch ${r}`]},i}if(h===void 0||!h){const i=new Error('Incorrect usage of "merge". Branch to be merged ('+r+") has no commits");throw i.hash={text:`merge ${r}`,token:`merge ${r}`,expected:['"commit"']},i}if(f===h){const i=new Error('Incorrect usage of "merge". Both branches have same head');throw i.hash={text:`merge ${r}`,token:`merge ${r}`,expected:["branch abc"]},i}if(s&&c.records.commits.has(s)){const i=new Error('Incorrect usage of "merge". Commit with id:'+s+" already exists, use different custom id");throw i.hash={text:`merge ${r} ${s} ${n} ${e?.join(" ")}`,token:`merge ${r} ${s} ${n} ${e?.join(" ")}`,expected:[`merge ${r} ${s}_UNIQUE ${n} ${e?.join(" ")}`]},i}const $=o||"",g={id:s||`${c.records.seq}-${A()}`,message:`merged branch ${r} into ${c.records.currBranch}`,seq:c.records.seq++,parents:c.records.head==null?[]:[c.records.head.id,$],branch:c.records.currBranch,type:x.MERGE,customType:n,customId:!!s,tags:e??[]};c.records.head=g,c.records.commits.set(g.id,g),c.records.branches.set(c.records.currBranch,g.id),m.debug(c.records.branches),m.debug("in mergeBranch")},"merge"),pr=l(function(t){let r=t.id,s=t.targetId,n=t.tags,e=t.parent;m.debug("Entering cherryPick:",r,s,n);const a=I();if(r=C.sanitizeText(r,a),s=C.sanitizeText(s,a),n=n?.map(f=>C.sanitizeText(f,a)),e=C.sanitizeText(e,a),!r||!c.records.commits.has(r)){const f=new Error('Incorrect usage of "cherryPick". Source commit id should exist and provided');throw f.hash={text:`cherryPick ${r} ${s}`,token:`cherryPick ${r} ${s}`,expected:["cherry-pick abc"]},f}const d=c.records.commits.get(r);if(d===void 0||!d)throw new Error('Incorrect usage of "cherryPick". Source commit id should exist and provided');if(e&&!(Array.isArray(d.parents)&&d.parents.includes(e)))throw new Error("Invalid operation: The specified parent commit is not an immediate parent of the cherry-picked commit.");const o=d.branch;if(d.type===x.MERGE&&!e)throw new Error("Incorrect usage of cherry-pick: If the source commit is a merge commit, an immediate parent commit must be specified.");if(!s||!c.records.commits.has(s)){if(o===c.records.currBranch){const g=new Error('Incorrect usage of "cherryPick". Source commit is already on current branch');throw g.hash={text:`cherryPick ${r} ${s}`,token:`cherryPick ${r} ${s}`,expected:["cherry-pick abc"]},g}const f=c.records.branches.get(c.records.currBranch);if(f===void 0||!f){const g=new Error(`Incorrect usage of "cherry-pick". Current branch (${c.records.currBranch})has no commits`);throw g.hash={text:`cherryPick ${r} ${s}`,token:`cherryPick ${r} ${s}`,expected:["cherry-pick abc"]},g}const h=c.records.commits.get(f);if(h===void 0||!h){const g=new Error(`Incorrect usage of "cherry-pick". Current branch (${c.records.currBranch})has no commits`);throw g.hash={text:`cherryPick ${r} ${s}`,token:`cherryPick ${r} ${s}`,expected:["cherry-pick abc"]},g}const $={id:c.records.seq+"-"+A(),message:`cherry-picked ${d?.message} into ${c.records.currBranch}`,seq:c.records.seq++,parents:c.records.head==null?[]:[c.records.head.id,d.id],branch:c.records.currBranch,type:x.CHERRY_PICK,tags:n?n.filter(Boolean):[`cherry-pick:${d.id}${d.type===x.MERGE?`|parent:${e}`:""}`]};c.records.head=$,c.records.commits.set($.id,$),c.records.branches.set(c.records.currBranch,$.id),m.debug(c.records.branches),m.debug("in cherryPick")}},"cherryPick"),z=l(function(t){if(t=C.sanitizeText(t,I()),c.records.branches.has(t)){c.records.currBranch=t;const r=c.records.branches.get(c.records.currBranch);r===void 0||!r?c.records.head=null:c.records.head=c.records.commits.get(r)??null}else{const r=new Error(`Trying to checkout branch which is not yet created. (Help try using "branch ${t}")`);throw r.hash={text:`checkout ${t}`,token:`checkout ${t}`,expected:[`branch ${t}`]},r}},"checkout");function H(t,r,s){const n=t.indexOf(r);n===-1?t.push(s):t.splice(n,1,s)}l(H,"upsert");function P(t){const r=t.reduce((e,a)=>e.seq>a.seq?e:a,t[0]);let s="";t.forEach(function(e){e===r?s+="	*":s+="	|"});const n=[s,r.id,r.seq];for(const e in c.records.branches)c.records.branches.get(e)===r.id&&n.push(e);if(m.debug(n.join(" ")),r.parents&&r.parents.length==2&&r.parents[0]&&r.parents[1]){const e=c.records.commits.get(r.parents[0]);H(t,r,e),r.parents[1]&&t.push(c.records.commits.get(r.parents[1]))}else{if(r.parents.length==0)return;if(r.parents[0]){const e=c.records.commits.get(r.parents[0]);H(t,r,e)}}t=F(t,e=>e.id),P(t)}l(P,"prettyPrintCommitHistory");var xr=l(function(){m.debug(c.records.commits);const t=N()[0];P([t])},"prettyPrint"),mr=l(function(){c.reset(),sr()},"clear"),br=l(function(){return[...c.records.branchConfig.values()].map((r,s)=>r.order!==null&&r.order!==void 0?r:{...r,order:parseFloat(`0.${s}`)}).sort((r,s)=>(r.order??0)-(s.order??0)).map(({name:r})=>({name:r}))},"getBranchesAsObjArray"),wr=l(function(){return c.records.branches},"getBranches"),vr=l(function(){return c.records.commits},"getCommits"),N=l(function(){const t=[...c.records.commits.values()];return t.forEach(function(r){m.debug(r.id)}),t.sort((r,s)=>r.seq-s.seq),t},"getCommitsArray"),Cr=l(function(){return c.records.currBranch},"getCurrentBranch"),Er=l(function(){return c.records.direction},"getDirection"),Tr=l(function(){return c.records.head},"getHead"),S={commitType:x,getConfig:I,setDirection:lr,setOptions:$r,getOptions:fr,commit:gr,branch:yr,merge:ur,cherryPick:pr,checkout:z,prettyPrint:xr,clear:mr,getBranchesAsObjArray:br,getBranches:wr,getCommits:vr,getCommitsArray:N,getCurrentBranch:Cr,getDirection:Er,getHead:Tr,setAccTitle:Z,getAccTitle:Q,getAccDescription:J,setAccDescription:X,setDiagramTitle:V,getDiagramTitle:U},Br=l((t,r)=>{Y(t,r),t.dir&&r.setDirection(t.dir);for(const s of t.statements)Lr(s,r)},"populate"),Lr=l((t,r)=>{const n={Commit:l(e=>r.commit(kr(e)),"Commit"),Branch:l(e=>r.branch(Mr(e)),"Branch"),Merge:l(e=>r.merge(Ir(e)),"Merge"),Checkout:l(e=>r.checkout(Rr(e)),"Checkout"),CherryPicking:l(e=>r.cherryPick(Gr(e)),"CherryPicking")}[t.$type];n?n(t):m.error(`Unknown statement type: ${t.$type}`)},"parseStatement"),kr=l(t=>({id:t.id,msg:t.message??"",type:t.type!==void 0?x[t.type]:x.NORMAL,tags:t.tags??void 0}),"parseCommit"),Mr=l(t=>({name:t.name,order:t.order??0}),"parseBranch"),Ir=l(t=>({branch:t.branch,id:t.id??"",type:t.type!==void 0?x[t.type]:void 0,tags:t.tags??void 0}),"parseMerge"),Rr=l(t=>t.branch,"parseCheckout"),Gr=l(t=>({id:t.id,targetId:"",tags:t.tags?.length===0?void 0:t.tags,parent:t.parent}),"parseCherryPicking"),Or={parse:l(async t=>{const r=await dr("gitGraph",t);m.debug(r),Br(r,S)},"parse")},qr=rr(),v=qr?.gitGraph,L=10,k=40,E=4,T=2,M=8,b=new Map,w=new Map,O=30,R=new Map,q=[],B=0,u="LR",Ar=l(()=>{b.clear(),w.clear(),R.clear(),B=0,q=[],u="LR"},"clear"),W=l(t=>{const r=document.createElementNS("http://www.w3.org/2000/svg","text");return(typeof t=="string"?t.split(/\\n|\n|<br\s*\/?>/gi):t).forEach(n=>{const e=document.createElementNS("http://www.w3.org/2000/svg","tspan");e.setAttributeNS("http://www.w3.org/XML/1998/namespace","xml:space","preserve"),e.setAttribute("dy","1em"),e.setAttribute("x","0"),e.setAttribute("class","row"),e.textContent=n.trim(),r.appendChild(e)}),r},"drawText"),j=l(t=>{let r,s,n;return u==="BT"?(s=l((e,a)=>e<=a,"comparisonFunc"),n=1/0):(s=l((e,a)=>e>=a,"comparisonFunc"),n=0),t.forEach(e=>{const a=u==="TB"||u=="BT"?w.get(e)?.y:w.get(e)?.x;a!==void 0&&s(a,n)&&(r=e,n=a)}),r},"findClosestParent"),_r=l(t=>{let r="",s=1/0;return t.forEach(n=>{const e=w.get(n).y;e<=s&&(r=n,s=e)}),r||void 0},"findClosestParentBT"),Hr=l((t,r,s)=>{let n=s,e=s;const a=[];t.forEach(d=>{const o=r.get(d);if(!o)throw new Error(`Commit not found for key ${d}`);o.parents.length?(n=Dr(o),e=Math.max(n,e)):a.push(o),Fr(o,n)}),n=e,a.forEach(d=>{zr(d,n,s)}),t.forEach(d=>{const o=r.get(d);if(o?.parents.length){const f=_r(o.parents);n=w.get(f).y-k,n<=e&&(e=n);const h=b.get(o.branch).pos,$=n-L;w.set(o.id,{x:h,y:$})}})},"setParallelBTPos"),Pr=l(t=>{const r=j(t.parents.filter(n=>n!==null));if(!r)throw new Error(`Closest parent not found for commit ${t.id}`);const s=w.get(r)?.y;if(s===void 0)throw new Error(`Closest parent position not found for commit ${t.id}`);return s},"findClosestParentPos"),Dr=l(t=>Pr(t)+k,"calculateCommitPosition"),Fr=l((t,r)=>{const s=b.get(t.branch);if(!s)throw new Error(`Branch not found for commit ${t.id}`);const n=s.pos,e=r+L;return w.set(t.id,{x:n,y:e}),{x:n,y:e}},"setCommitPosition"),zr=l((t,r,s)=>{const n=b.get(t.branch);if(!n)throw new Error(`Branch not found for commit ${t.id}`);const e=r+s,a=n.pos;w.set(t.id,{x:a,y:e})},"setRootPosition"),Nr=l((t,r,s,n,e,a)=>{if(a===x.HIGHLIGHT)t.append("rect").attr("x",s.x-10).attr("y",s.y-10).attr("width",20).attr("height",20).attr("class",`commit ${r.id} commit-highlight${e%M} ${n}-outer`),t.append("rect").attr("x",s.x-6).attr("y",s.y-6).attr("width",12).attr("height",12).attr("class",`commit ${r.id} commit${e%M} ${n}-inner`);else if(a===x.CHERRY_PICK)t.append("circle").attr("cx",s.x).attr("cy",s.y).attr("r",10).attr("class",`commit ${r.id} ${n}`),t.append("circle").attr("cx",s.x-3).attr("cy",s.y+2).attr("r",2.75).attr("fill","#fff").attr("class",`commit ${r.id} ${n}`),t.append("circle").attr("cx",s.x+3).attr("cy",s.y+2).attr("r",2.75).attr("fill","#fff").attr("class",`commit ${r.id} ${n}`),t.append("line").attr("x1",s.x+3).attr("y1",s.y+1).attr("x2",s.x).attr("y2",s.y-5).attr("stroke","#fff").attr("class",`commit ${r.id} ${n}`),t.append("line").attr("x1",s.x-3).attr("y1",s.y+1).attr("x2",s.x).attr("y2",s.y-5).attr("stroke","#fff").attr("class",`commit ${r.id} ${n}`);else{const d=t.append("circle");if(d.attr("cx",s.x),d.attr("cy",s.y),d.attr("r",r.type===x.MERGE?9:10),d.attr("class",`commit ${r.id} commit${e%M}`),a===x.MERGE){const o=t.append("circle");o.attr("cx",s.x),o.attr("cy",s.y),o.attr("r",6),o.attr("class",`commit ${n} ${r.id} commit${e%M}`)}a===x.REVERSE&&t.append("path").attr("d",`M ${s.x-5},${s.y-5}L${s.x+5},${s.y+5}M${s.x-5},${s.y+5}L${s.x+5},${s.y-5}`).attr("class",`commit ${n} ${r.id} commit${e%M}`)}},"drawCommitBullet"),Sr=l((t,r,s,n)=>{if(r.type!==x.CHERRY_PICK&&(r.customId&&r.type===x.MERGE||r.type!==x.MERGE)&&v?.showCommitLabel){const e=t.append("g"),a=e.insert("rect").attr("class","commit-label-bkg"),d=e.append("text").attr("x",n).attr("y",s.y+25).attr("class","commit-label").text(r.id),o=d.node()?.getBBox();if(o&&(a.attr("x",s.posWithOffset-o.width/2-T).attr("y",s.y+13.5).attr("width",o.width+2*T).attr("height",o.height+2*T),u==="TB"||u==="BT"?(a.attr("x",s.x-(o.width+4*E+5)).attr("y",s.y-12),d.attr("x",s.x-(o.width+4*E)).attr("y",s.y+o.height-12)):d.attr("x",s.posWithOffset-o.width/2),v.rotateCommitLabel))if(u==="TB"||u==="BT")d.attr("transform","rotate(-45, "+s.x+", "+s.y+")"),a.attr("transform","rotate(-45, "+s.x+", "+s.y+")");else{const f=-7.5-(o.width+10)/25*9.5,h=10+o.width/25*8.5;e.attr("transform","translate("+f+", "+h+") rotate(-45, "+n+", "+s.y+")")}}},"drawCommitLabel"),Wr=l((t,r,s,n)=>{if(r.tags.length>0){let e=0,a=0,d=0;const o=[];for(const f of r.tags.reverse()){const h=t.insert("polygon"),$=t.append("circle"),g=t.append("text").attr("y",s.y-16-e).attr("class","tag-label").text(f),i=g.node()?.getBBox();if(!i)throw new Error("Tag bbox not found");a=Math.max(a,i.width),d=Math.max(d,i.height),g.attr("x",s.posWithOffset-i.width/2),o.push({tag:g,hole:$,rect:h,yOffset:e}),e+=20}for(const{tag:f,hole:h,rect:$,yOffset:g}of o){const i=d/2,y=s.y-19.2-g;if($.attr("class","tag-label-bkg").attr("points",`
-      ${n-a/2-E/2},${y+T}  
-      ${n-a/2-E/2},${y-T}
-      ${s.posWithOffset-a/2-E},${y-i-T}
-      ${s.posWithOffset+a/2+E},${y-i-T}
-      ${s.posWithOffset+a/2+E},${y+i+T}
-      ${s.posWithOffset-a/2-E},${y+i+T}`),h.attr("cy",y).attr("cx",n-a/2+E/2).attr("r",1.5).attr("class","tag-hole"),u==="TB"||u==="BT"){const p=n+g;$.attr("class","tag-label-bkg").attr("points",`
-        ${s.x},${p+2}
-        ${s.x},${p-2}
-        ${s.x+L},${p-i-2}
-        ${s.x+L+a+4},${p-i-2}
-        ${s.x+L+a+4},${p+i+2}
-        ${s.x+L},${p+i+2}`).attr("transform","translate(12,12) rotate(45, "+s.x+","+n+")"),h.attr("cx",s.x+E/2).attr("cy",p).attr("transform","translate(12,12) rotate(45, "+s.x+","+n+")"),f.attr("x",s.x+5).attr("y",p+3).attr("transform","translate(14,14) rotate(45, "+s.x+","+n+")")}}}},"drawCommitTags"),jr=l(t=>{switch(t.customType??t.type){case x.NORMAL:return"commit-normal";case x.REVERSE:return"commit-reverse";case x.HIGHLIGHT:return"commit-highlight";case x.MERGE:return"commit-merge";case x.CHERRY_PICK:return"commit-cherry-pick";default:return"commit-normal"}},"getCommitClassType"),Yr=l((t,r,s,n)=>{const e={x:0,y:0};if(t.parents.length>0){const a=j(t.parents);if(a){const d=n.get(a)??e;return r==="TB"?d.y+k:r==="BT"?(n.get(t.id)??e).y-k:d.x+k}}else return r==="TB"?O:r==="BT"?(n.get(t.id)??e).y-k:0;return 0},"calculatePosition"),Kr=l((t,r,s)=>{const n=u==="BT"&&s?r:r+L,e=u==="TB"||u==="BT"?n:b.get(t.branch)?.pos,a=u==="TB"||u==="BT"?b.get(t.branch)?.pos:n;if(a===void 0||e===void 0)throw new Error(`Position were undefined for commit ${t.id}`);return{x:a,y:e,posWithOffset:n}},"getCommitPosition"),D=l((t,r,s)=>{if(!v)throw new Error("GitGraph config not found");const n=t.append("g").attr("class","commit-bullets"),e=t.append("g").attr("class","commit-labels");let a=u==="TB"||u==="BT"?O:0;const d=[...r.keys()],o=v?.parallelCommits??!1,f=l(($,g)=>{const i=r.get($)?.seq,y=r.get(g)?.seq;return i!==void 0&&y!==void 0?i-y:0},"sortKeys");let h=d.sort(f);u==="BT"&&(o&&Hr(h,r,a),h=h.reverse()),h.forEach($=>{const g=r.get($);if(!g)throw new Error(`Commit not found for key ${$}`);o&&(a=Yr(g,u,a,w));const i=Kr(g,a,o);if(s){const y=jr(g),p=g.customType??g.type,_=b.get(g.branch)?.index??0;Nr(n,g,i,y,_,p),Sr(e,g,i,a),Wr(e,g,i,a)}u==="TB"||u==="BT"?w.set(g.id,{x:i.x,y:i.posWithOffset}):w.set(g.id,{x:i.posWithOffset,y:i.y}),a=u==="BT"&&o?a+k:a+k+L,a>B&&(B=a)})},"drawCommits"),Ur=l((t,r,s,n,e)=>{const d=(u==="TB"||u==="BT"?s.x<n.x:s.y<n.y)?r.branch:t.branch,o=l(h=>h.branch===d,"isOnBranchToGetCurve"),f=l(h=>h.seq>t.seq&&h.seq<r.seq,"isBetweenCommits");return[...e.values()].some(h=>f(h)&&o(h))},"shouldRerouteArrow"),G=l((t,r,s=0)=>{const n=t+Math.abs(t-r)/2;if(s>5)return n;if(q.every(d=>Math.abs(d-n)>=10))return q.push(n),n;const a=Math.abs(t-r);return G(t,r-a/5,s+1)},"findLane"),Vr=l((t,r,s,n)=>{const e=w.get(r.id),a=w.get(s.id);if(e===void 0||a===void 0)throw new Error(`Commit positions not found for commits ${r.id} and ${s.id}`);const d=Ur(r,s,e,a,n);let o="",f="",h=0,$=0,g=b.get(s.branch)?.index;s.type===x.MERGE&&r.id!==s.parents[0]&&(g=b.get(r.branch)?.index);let i;if(d){o="A 10 10, 0, 0, 0,",f="A 10 10, 0, 0, 1,",h=10,$=10;const y=e.y<a.y?G(e.y,a.y):G(a.y,e.y),p=e.x<a.x?G(e.x,a.x):G(a.x,e.x);u==="TB"?e.x<a.x?i=`M ${e.x} ${e.y} L ${p-h} ${e.y} ${f} ${p} ${e.y+$} L ${p} ${a.y-h} ${o} ${p+$} ${a.y} L ${a.x} ${a.y}`:(g=b.get(r.branch)?.index,i=`M ${e.x} ${e.y} L ${p+h} ${e.y} ${o} ${p} ${e.y+$} L ${p} ${a.y-h} ${f} ${p-$} ${a.y} L ${a.x} ${a.y}`):u==="BT"?e.x<a.x?i=`M ${e.x} ${e.y} L ${p-h} ${e.y} ${o} ${p} ${e.y-$} L ${p} ${a.y+h} ${f} ${p+$} ${a.y} L ${a.x} ${a.y}`:(g=b.get(r.branch)?.index,i=`M ${e.x} ${e.y} L ${p+h} ${e.y} ${f} ${p} ${e.y-$} L ${p} ${a.y+h} ${o} ${p-$} ${a.y} L ${a.x} ${a.y}`):e.y<a.y?i=`M ${e.x} ${e.y} L ${e.x} ${y-h} ${o} ${e.x+$} ${y} L ${a.x-h} ${y} ${f} ${a.x} ${y+$} L ${a.x} ${a.y}`:(g=b.get(r.branch)?.index,i=`M ${e.x} ${e.y} L ${e.x} ${y+h} ${f} ${e.x+$} ${y} L ${a.x-h} ${y} ${o} ${a.x} ${y-$} L ${a.x} ${a.y}`)}else o="A 20 20, 0, 0, 0,",f="A 20 20, 0, 0, 1,",h=20,$=20,u==="TB"?(e.x<a.x&&(s.type===x.MERGE&&r.id!==s.parents[0]?i=`M ${e.x} ${e.y} L ${e.x} ${a.y-h} ${o} ${e.x+$} ${a.y} L ${a.x} ${a.y}`:i=`M ${e.x} ${e.y} L ${a.x-h} ${e.y} ${f} ${a.x} ${e.y+$} L ${a.x} ${a.y}`),e.x>a.x&&(o="A 20 20, 0, 0, 0,",f="A 20 20, 0, 0, 1,",h=20,$=20,s.type===x.MERGE&&r.id!==s.parents[0]?i=`M ${e.x} ${e.y} L ${e.x} ${a.y-h} ${f} ${e.x-$} ${a.y} L ${a.x} ${a.y}`:i=`M ${e.x} ${e.y} L ${a.x+h} ${e.y} ${o} ${a.x} ${e.y+$} L ${a.x} ${a.y}`),e.x===a.x&&(i=`M ${e.x} ${e.y} L ${a.x} ${a.y}`)):u==="BT"?(e.x<a.x&&(s.type===x.MERGE&&r.id!==s.parents[0]?i=`M ${e.x} ${e.y} L ${e.x} ${a.y+h} ${f} ${e.x+$} ${a.y} L ${a.x} ${a.y}`:i=`M ${e.x} ${e.y} L ${a.x-h} ${e.y} ${o} ${a.x} ${e.y-$} L ${a.x} ${a.y}`),e.x>a.x&&(o="A 20 20, 0, 0, 0,",f="A 20 20, 0, 0, 1,",h=20,$=20,s.type===x.MERGE&&r.id!==s.parents[0]?i=`M ${e.x} ${e.y} L ${e.x} ${a.y+h} ${o} ${e.x-$} ${a.y} L ${a.x} ${a.y}`:i=`M ${e.x} ${e.y} L ${a.x-h} ${e.y} ${o} ${a.x} ${e.y-$} L ${a.x} ${a.y}`),e.x===a.x&&(i=`M ${e.x} ${e.y} L ${a.x} ${a.y}`)):(e.y<a.y&&(s.type===x.MERGE&&r.id!==s.parents[0]?i=`M ${e.x} ${e.y} L ${a.x-h} ${e.y} ${f} ${a.x} ${e.y+$} L ${a.x} ${a.y}`:i=`M ${e.x} ${e.y} L ${e.x} ${a.y-h} ${o} ${e.x+$} ${a.y} L ${a.x} ${a.y}`),e.y>a.y&&(s.type===x.MERGE&&r.id!==s.parents[0]?i=`M ${e.x} ${e.y} L ${a.x-h} ${e.y} ${o} ${a.x} ${e.y-$} L ${a.x} ${a.y}`:i=`M ${e.x} ${e.y} L ${e.x} ${a.y+h} ${f} ${e.x+$} ${a.y} L ${a.x} ${a.y}`),e.y===a.y&&(i=`M ${e.x} ${e.y} L ${a.x} ${a.y}`));if(i===void 0)throw new Error("Line definition not found");t.append("path").attr("d",i).attr("class","arrow arrow"+g%M)},"drawArrow"),Xr=l((t,r)=>{const s=t.append("g").attr("class","commit-arrows");[...r.keys()].forEach(n=>{const e=r.get(n);e.parents&&e.parents.length>0&&e.parents.forEach(a=>{Vr(s,r.get(a),e,r)})})},"drawArrows"),Jr=l((t,r)=>{const s=t.append("g");r.forEach((n,e)=>{const a=e%M,d=b.get(n.name)?.pos;if(d===void 0)throw new Error(`Position not found for branch ${n.name}`);const o=s.append("line");o.attr("x1",0),o.attr("y1",d),o.attr("x2",B),o.attr("y2",d),o.attr("class","branch branch"+a),u==="TB"?(o.attr("y1",O),o.attr("x1",d),o.attr("y2",B),o.attr("x2",d)):u==="BT"&&(o.attr("y1",B),o.attr("x1",d),o.attr("y2",O),o.attr("x2",d)),q.push(d);const f=n.name,h=W(f),$=s.insert("rect"),i=s.insert("g").attr("class","branchLabel").insert("g").attr("class","label branch-label"+a);i.node().appendChild(h);const y=h.getBBox();$.attr("class","branchLabelBkg label"+a).attr("rx",4).attr("ry",4).attr("x",-y.width-4-(v?.rotateCommitLabel===!0?30:0)).attr("y",-y.height/2+8).attr("width",y.width+18).attr("height",y.height+4),i.attr("transform","translate("+(-y.width-14-(v?.rotateCommitLabel===!0?30:0))+", "+(d-y.height/2-1)+")"),u==="TB"?($.attr("x",d-y.width/2-10).attr("y",0),i.attr("transform","translate("+(d-y.width/2-5)+", 0)")):u==="BT"?($.attr("x",d-y.width/2-10).attr("y",B),i.attr("transform","translate("+(d-y.width/2-5)+", "+B+")")):$.attr("transform","translate(-19, "+(d-y.height/2)+")")})},"drawBranches"),Qr=l(function(t,r,s,n,e){return b.set(t,{pos:r,index:s}),r+=50+(e?40:0)+(u==="TB"||u==="BT"?n.width/2:0),r},"setBranchPosition"),Zr=l(function(t,r,s,n){if(Ar(),m.debug("in gitgraph renderer",t+`
-`,"id:",r,s),!v)throw new Error("GitGraph config not found");const e=v.rotateCommitLabel??!1,a=n.db;R=a.getCommits();const d=a.getBranchesAsObjArray();u=a.getDirection();const o=er(`[id="${r}"]`);let f=0;d.forEach((h,$)=>{const g=W(h.name),i=o.append("g"),y=i.insert("g").attr("class","branchLabel"),p=y.insert("g").attr("class","label branch-label");p.node()?.appendChild(g);const _=g.getBBox();f=Qr(h.name,f,$,_,e),p.remove(),y.remove(),i.remove()}),D(o,R,!1),v.showBranches&&Jr(o,d),Xr(o,R),D(o,R,!0),tr.insertTitle(o,"gitTitleText",v.titleTopMargin??0,a.getDiagramTitle()),ar(void 0,o,v.diagramPadding,v.useMaxWidth)},"draw"),re={draw:Zr},ee=l(t=>`
-  .commit-id,
-  .commit-msg,
-  .branch-label {
-    fill: lightgrey;
-    color: lightgrey;
-    font-family: 'trebuchet ms', verdana, arial, sans-serif;
-    font-family: var(--mermaid-font-family);
-  }
-  ${[0,1,2,3,4,5,6,7].map(r=>`
-        .branch-label${r} { fill: ${t["gitBranchLabel"+r]}; }
-        .commit${r} { stroke: ${t["git"+r]}; fill: ${t["git"+r]}; }
-        .commit-highlight${r} { stroke: ${t["gitInv"+r]}; fill: ${t["gitInv"+r]}; }
-        .label${r}  { fill: ${t["git"+r]}; }
-        .arrow${r} { stroke: ${t["git"+r]}; }
-        `).join(`
-`)}
-
-  .branch {
-    stroke-width: 1;
-    stroke: ${t.lineColor};
-    stroke-dasharray: 2;
-  }
-  .commit-label { font-size: ${t.commitLabelFontSize}; fill: ${t.commitLabelColor};}
-  .commit-label-bkg { font-size: ${t.commitLabelFontSize}; fill: ${t.commitLabelBackground}; opacity: 0.5; }
-  .tag-label { font-size: ${t.tagLabelFontSize}; fill: ${t.tagLabelColor};}
-  .tag-label-bkg { fill: ${t.tagLabelBackground}; stroke: ${t.tagLabelBorder}; }
-  .tag-hole { fill: ${t.textColor}; }
-
-  .commit-merge {
-    stroke: ${t.primaryColor};
-    fill: ${t.primaryColor};
-  }
-  .commit-reverse {
-    stroke: ${t.primaryColor};
-    fill: ${t.primaryColor};
-    stroke-width: 3;
-  }
-  .commit-highlight-outer {
-  }
-  .commit-highlight-inner {
-    stroke: ${t.primaryColor};
-    fill: ${t.primaryColor};
-  }
-
-  .arrow { stroke-width: 8; stroke-linecap: round; fill: none}
-  .gitTitleText {
-    text-anchor: middle;
-    font-size: 18px;
-    fill: ${t.textColor};
-  }
-`,"getStyles"),te=ee,he={parser:Or,db:S,renderer:re,styles:te};export{he as diagram};
diff --git a/docs/dist/assets/graph-DQwMrrst.js b/docs/dist/assets/graph-DQwMrrst.js
deleted file mode 100644
index f5f8c679..00000000
--- a/docs/dist/assets/graph-DQwMrrst.js
+++ /dev/null
@@ -1 +0,0 @@
-import{aA as N,aB as j,aC as f,aD as b,aE as E}from"./index-BxX29htg.js";import{a as v,c as P,k as _,f as g,d,i as l,v as p,r as D}from"./_baseUniq-CfjWcJYV.js";var w=N(function(o){return v(P(o,1,j,!0))}),F="\0",a="\0",O="
";class L{constructor(e={}){this._isDirected=Object.prototype.hasOwnProperty.call(e,"directed")?e.directed:!0,this._isMultigraph=Object.prototype.hasOwnProperty.call(e,"multigraph")?e.multigraph:!1,this._isCompound=Object.prototype.hasOwnProperty.call(e,"compound")?e.compound:!1,this._label=void 0,this._defaultNodeLabelFn=f(void 0),this._defaultEdgeLabelFn=f(void 0),this._nodes={},this._isCompound&&(this._parent={},this._children={},this._children[a]={}),this._in={},this._preds={},this._out={},this._sucs={},this._edgeObjs={},this._edgeLabels={}}isDirected(){return this._isDirected}isMultigraph(){return this._isMultigraph}isCompound(){return this._isCompound}setGraph(e){return this._label=e,this}graph(){return this._label}setDefaultNodeLabel(e){return b(e)||(e=f(e)),this._defaultNodeLabelFn=e,this}nodeCount(){return this._nodeCount}nodes(){return _(this._nodes)}sources(){var e=this;return g(this.nodes(),function(t){return E(e._in[t])})}sinks(){var e=this;return g(this.nodes(),function(t){return E(e._out[t])})}setNodes(e,t){var s=arguments,i=this;return d(e,function(r){s.length>1?i.setNode(r,t):i.setNode(r)}),this}setNode(e,t){return Object.prototype.hasOwnProperty.call(this._nodes,e)?(arguments.length>1&&(this._nodes[e]=t),this):(this._nodes[e]=arguments.length>1?t:this._defaultNodeLabelFn(e),this._isCompound&&(this._parent[e]=a,this._children[e]={},this._children[a][e]=!0),this._in[e]={},this._preds[e]={},this._out[e]={},this._sucs[e]={},++this._nodeCount,this)}node(e){return this._nodes[e]}hasNode(e){return Object.prototype.hasOwnProperty.call(this._nodes,e)}removeNode(e){if(Object.prototype.hasOwnProperty.call(this._nodes,e)){var t=s=>this.removeEdge(this._edgeObjs[s]);delete this._nodes[e],this._isCompound&&(this._removeFromParentsChildList(e),delete this._parent[e],d(this.children(e),s=>{this.setParent(s)}),delete this._children[e]),d(_(this._in[e]),t),delete this._in[e],delete this._preds[e],d(_(this._out[e]),t),delete this._out[e],delete this._sucs[e],--this._nodeCount}return this}setParent(e,t){if(!this._isCompound)throw new Error("Cannot set parent in a non-compound graph");if(l(t))t=a;else{t+="";for(var s=t;!l(s);s=this.parent(s))if(s===e)throw new Error("Setting "+t+" as parent of "+e+" would create a cycle");this.setNode(t)}return this.setNode(e),this._removeFromParentsChildList(e),this._parent[e]=t,this._children[t][e]=!0,this}_removeFromParentsChildList(e){delete this._children[this._parent[e]][e]}parent(e){if(this._isCompound){var t=this._parent[e];if(t!==a)return t}}children(e){if(l(e)&&(e=a),this._isCompound){var t=this._children[e];if(t)return _(t)}else{if(e===a)return this.nodes();if(this.hasNode(e))return[]}}predecessors(e){var t=this._preds[e];if(t)return _(t)}successors(e){var t=this._sucs[e];if(t)return _(t)}neighbors(e){var t=this.predecessors(e);if(t)return w(t,this.successors(e))}isLeaf(e){var t;return this.isDirected()?t=this.successors(e):t=this.neighbors(e),t.length===0}filterNodes(e){var t=new this.constructor({directed:this._isDirected,multigraph:this._isMultigraph,compound:this._isCompound});t.setGraph(this.graph());var s=this;d(this._nodes,function(n,h){e(h)&&t.setNode(h,n)}),d(this._edgeObjs,function(n){t.hasNode(n.v)&&t.hasNode(n.w)&&t.setEdge(n,s.edge(n))});var i={};function r(n){var h=s.parent(n);return h===void 0||t.hasNode(h)?(i[n]=h,h):h in i?i[h]:r(h)}return this._isCompound&&d(t.nodes(),function(n){t.setParent(n,r(n))}),t}setDefaultEdgeLabel(e){return b(e)||(e=f(e)),this._defaultEdgeLabelFn=e,this}edgeCount(){return this._edgeCount}edges(){return p(this._edgeObjs)}setPath(e,t){var s=this,i=arguments;return D(e,function(r,n){return i.length>1?s.setEdge(r,n,t):s.setEdge(r,n),n}),this}setEdge(){var e,t,s,i,r=!1,n=arguments[0];typeof n=="object"&&n!==null&&"v"in n?(e=n.v,t=n.w,s=n.name,arguments.length===2&&(i=arguments[1],r=!0)):(e=n,t=arguments[1],s=arguments[3],arguments.length>2&&(i=arguments[2],r=!0)),e=""+e,t=""+t,l(s)||(s=""+s);var h=c(this._isDirected,e,t,s);if(Object.prototype.hasOwnProperty.call(this._edgeLabels,h))return r&&(this._edgeLabels[h]=i),this;if(!l(s)&&!this._isMultigraph)throw new Error("Cannot set a named edge when isMultigraph = false");this.setNode(e),this.setNode(t),this._edgeLabels[h]=r?i:this._defaultEdgeLabelFn(e,t,s);var u=M(this._isDirected,e,t,s);return e=u.v,t=u.w,Object.freeze(u),this._edgeObjs[h]=u,C(this._preds[t],e),C(this._sucs[e],t),this._in[t][h]=u,this._out[e][h]=u,this._edgeCount++,this}edge(e,t,s){var i=arguments.length===1?m(this._isDirected,arguments[0]):c(this._isDirected,e,t,s);return this._edgeLabels[i]}hasEdge(e,t,s){var i=arguments.length===1?m(this._isDirected,arguments[0]):c(this._isDirected,e,t,s);return Object.prototype.hasOwnProperty.call(this._edgeLabels,i)}removeEdge(e,t,s){var i=arguments.length===1?m(this._isDirected,arguments[0]):c(this._isDirected,e,t,s),r=this._edgeObjs[i];return r&&(e=r.v,t=r.w,delete this._edgeLabels[i],delete this._edgeObjs[i],y(this._preds[t],e),y(this._sucs[e],t),delete this._in[t][i],delete this._out[e][i],this._edgeCount--),this}inEdges(e,t){var s=this._in[e];if(s){var i=p(s);return t?g(i,function(r){return r.v===t}):i}}outEdges(e,t){var s=this._out[e];if(s){var i=p(s);return t?g(i,function(r){return r.w===t}):i}}nodeEdges(e,t){var s=this.inEdges(e,t);if(s)return s.concat(this.outEdges(e,t))}}L.prototype._nodeCount=0;L.prototype._edgeCount=0;function C(o,e){o[e]?o[e]++:o[e]=1}function y(o,e){--o[e]||delete o[e]}function c(o,e,t,s){var i=""+e,r=""+t;if(!o&&i>r){var n=i;i=r,r=n}return i+O+r+O+(l(s)?F:s)}function M(o,e,t,s){var i=""+e,r=""+t;if(!o&&i>r){var n=i;i=r,r=n}var h={v:i,w:r};return s&&(h.name=s),h}function m(o,e){return c(o,e.v,e.w,e.name)}export{L as G};
diff --git a/docs/dist/assets/index-BxX29htg.js b/docs/dist/assets/index-BxX29htg.js
deleted file mode 100644
index 49395d53..00000000
--- a/docs/dist/assets/index-BxX29htg.js
+++ /dev/null
@@ -1,344 +0,0 @@
-const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/dagre-6UL2VRFP-C6Co3lCr.js","assets/graph-DQwMrrst.js","assets/_baseUniq-CfjWcJYV.js","assets/layout-Cg3H1pzX.js","assets/_basePickBy-CqMtcO3s.js","assets/clone-BRV0rZiZ.js","assets/cose-bilkent-S5V4N54A-DgZv4oG7.js","assets/cytoscape.esm-CF_z7lu9.js","assets/c4Diagram-YG6GDRKO-DYZ6VP6-.js","assets/chunk-TZMSLE5B-BkTUbDII.js","assets/flowDiagram-NV44I4VS-C8-lZvFy.js","assets/chunk-FMBD7UC4-Bm3lI1XN.js","assets/chunk-55IACEB6-BE1gdz1f.js","assets/chunk-QN33PNHL-1s4FuBGd.js","assets/channel-kd1Rx1KT.js","assets/erDiagram-Q2GNP2WA-B2qtJQLQ.js","assets/gitGraphDiagram-NY62KEGX-Dx-Iakkv.js","assets/chunk-4BX2VUAB-BU7cqk0M.js","assets/chunk-QZHKN3VN-CEAug577.js","assets/treemap-KMMF4GRG-DFERHDZP.js","assets/ganttDiagram-LVOFAZNH-xP4ejEuz.js","assets/linear-hh6lJPrN.js","assets/init-Gi6I4Gst.js","assets/defaultLocale-C4B-KCzX.js","assets/infoDiagram-ER5ION4S-CVILutlg.js","assets/pieDiagram-ADFJNKIX-Bkw5yNqo.js","assets/arc-sXMYVGHN.js","assets/ordinal-Cboi1Yqb.js","assets/quadrantDiagram-AYHSOK5B-IIW4tBOO.js","assets/xychartDiagram-PRI3JC2R-DBIK1dAC.js","assets/requirementDiagram-UZGBJVZJ-CBieYl8c.js","assets/sequenceDiagram-WL72ISMW-C4G5dCz-.js","assets/classDiagram-2ON5EDUG-BfY8AvxO.js","assets/chunk-B4BG7PRW-DyUrByJj.js","assets/classDiagram-v2-WZHVMYZB-BfY8AvxO.js","assets/stateDiagram-FKZM4ZOC-BtO6UYX1.js","assets/chunk-DI55MBZ5-BODS175X.js","assets/stateDiagram-v2-4FDKWEC3-BYlkVy7J.js","assets/journeyDiagram-XKPGCS4Q-BHSnA7Cj.js","assets/timeline-definition-IT6M3QCI-DCes-M6t.js","assets/mindmap-definition-VGOIOE7T-WoULMqac.js","assets/kanban-definition-3W4ZIXB7-BCzaghRS.js","assets/sankeyDiagram-TZEHDZUN-CcPJsCNS.js","assets/diagram-S2PKOQOG-DvFlKDlH.js","assets/diagram-QEK2KX5R-DkELOZ4d.js","assets/blockDiagram-VD42YOAC-RS0Yvfs6.js","assets/architectureDiagram-VXUJARFQ-BsBPSHs1.js","assets/diagram-PSM6KHXK-DJOM8VfI.js"])))=>i.map(i=>d[i]);
-(function(){const it=document.createElement("link").relList;if(it&&it.supports&&it.supports("modulepreload"))return;for(const ut of document.querySelectorAll('link[rel="modulepreload"]'))dt(ut);new MutationObserver(ut=>{for(const pt of ut)if(pt.type==="childList")for(const yt of pt.addedNodes)yt.tagName==="LINK"&&yt.rel==="modulepreload"&&dt(yt)}).observe(document,{childList:!0,subtree:!0});function ct(ut){const pt={};return ut.integrity&&(pt.integrity=ut.integrity),ut.referrerPolicy&&(pt.referrerPolicy=ut.referrerPolicy),ut.crossOrigin==="use-credentials"?pt.credentials="include":ut.crossOrigin==="anonymous"?pt.credentials="omit":pt.credentials="same-origin",pt}function dt(ut){if(ut.ep)return;ut.ep=!0;const pt=ct(ut);fetch(ut.href,pt)}})();function getDefaultExportFromCjs(rt){return rt&&rt.__esModule&&Object.prototype.hasOwnProperty.call(rt,"default")?rt.default:rt}function getAugmentedNamespace(rt){if(Object.prototype.hasOwnProperty.call(rt,"__esModule"))return rt;var it=rt.default;if(typeof it=="function"){var ct=function dt(){var ut=!1;try{ut=this instanceof dt}catch{}return ut?Reflect.construct(it,arguments,this.constructor):it.apply(this,arguments)};ct.prototype=it.prototype}else ct={};return Object.defineProperty(ct,"__esModule",{value:!0}),Object.keys(rt).forEach(function(dt){var ut=Object.getOwnPropertyDescriptor(rt,dt);Object.defineProperty(ct,dt,ut.get?ut:{enumerable:!0,get:function(){return rt[dt]}})}),ct}var jsxRuntime={exports:{}},reactJsxRuntime_production={};var hasRequiredReactJsxRuntime_production;function requireReactJsxRuntime_production(){if(hasRequiredReactJsxRuntime_production)return reactJsxRuntime_production;hasRequiredReactJsxRuntime_production=1;var rt=Symbol.for("react.transitional.element"),it=Symbol.for("react.fragment");function ct(dt,ut,pt){var yt=null;if(pt!==void 0&&(yt=""+pt),ut.key!==void 0&&(yt=""+ut.key),"key"in ut){pt={};for(var ft in ut)ft!=="key"&&(pt[ft]=ut[ft])}else pt=ut;return ut=pt.ref,{$$typeof:rt,type:dt,key:yt,ref:ut!==void 0?ut:null,props:pt}}return reactJsxRuntime_production.Fragment=it,reactJsxRuntime_production.jsx=ct,reactJsxRuntime_production.jsxs=ct,reactJsxRuntime_production}var hasRequiredJsxRuntime;function requireJsxRuntime(){return hasRequiredJsxRuntime||(hasRequiredJsxRuntime=1,jsxRuntime.exports=requireReactJsxRuntime_production()),jsxRuntime.exports}var jsxRuntimeExports=requireJsxRuntime(),buffer={},base64Js={},hasRequiredBase64Js;function requireBase64Js(){if(hasRequiredBase64Js)return base64Js;hasRequiredBase64Js=1,base64Js.byteLength=ft,base64Js.toByteArray=kt,base64Js.fromByteArray=bt;for(var rt=[],it=[],ct=typeof Uint8Array<"u"?Uint8Array:Array,dt="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/",ut=0,pt=dt.length;ut<pt;++ut)rt[ut]=dt[ut],it[dt.charCodeAt(ut)]=ut;it[45]=62,it[95]=63;function yt(Mt){var wt=Mt.length;if(wt%4>0)throw new Error("Invalid string. Length must be a multiple of 4");var St=Mt.indexOf("=");St===-1&&(St=wt);var It=St===wt?0:4-St%4;return[St,It]}function ft(Mt){var wt=yt(Mt),St=wt[0],It=wt[1];return(St+It)*3/4-It}function mt(Mt,wt,St){return(wt+St)*3/4-St}function kt(Mt){var wt,St=yt(Mt),It=St[0],Nt=St[1],$t=new ct(mt(Mt,It,Nt)),Et=0,Ft=Nt>0?It-4:It,qt;for(qt=0;qt<Ft;qt+=4)wt=it[Mt.charCodeAt(qt)]<<18|it[Mt.charCodeAt(qt+1)]<<12|it[Mt.charCodeAt(qt+2)]<<6|it[Mt.charCodeAt(qt+3)],$t[Et++]=wt>>16&255,$t[Et++]=wt>>8&255,$t[Et++]=wt&255;return Nt===2&&(wt=it[Mt.charCodeAt(qt)]<<2|it[Mt.charCodeAt(qt+1)]>>4,$t[Et++]=wt&255),Nt===1&&(wt=it[Mt.charCodeAt(qt)]<<10|it[Mt.charCodeAt(qt+1)]<<4|it[Mt.charCodeAt(qt+2)]>>2,$t[Et++]=wt>>8&255,$t[Et++]=wt&255),$t}function _t(Mt){return rt[Mt>>18&63]+rt[Mt>>12&63]+rt[Mt>>6&63]+rt[Mt&63]}function vt(Mt,wt,St){for(var It,Nt=[],$t=wt;$t<St;$t+=3)It=(Mt[$t]<<16&16711680)+(Mt[$t+1]<<8&65280)+(Mt[$t+2]&255),Nt.push(_t(It));return Nt.join("")}function bt(Mt){for(var wt,St=Mt.length,It=St%3,Nt=[],$t=16383,Et=0,Ft=St-It;Et<Ft;Et+=$t)Nt.push(vt(Mt,Et,Et+$t>Ft?Ft:Et+$t));return It===1?(wt=Mt[St-1],Nt.push(rt[wt>>2]+rt[wt<<4&63]+"==")):It===2&&(wt=(Mt[St-2]<<8)+Mt[St-1],Nt.push(rt[wt>>10]+rt[wt>>4&63]+rt[wt<<2&63]+"=")),Nt.join("")}return base64Js}var ieee754={};var hasRequiredIeee754;function requireIeee754(){return hasRequiredIeee754||(hasRequiredIeee754=1,ieee754.read=function(rt,it,ct,dt,ut){var pt,yt,ft=ut*8-dt-1,mt=(1<<ft)-1,kt=mt>>1,_t=-7,vt=ct?ut-1:0,bt=ct?-1:1,Mt=rt[it+vt];for(vt+=bt,pt=Mt&(1<<-_t)-1,Mt>>=-_t,_t+=ft;_t>0;pt=pt*256+rt[it+vt],vt+=bt,_t-=8);for(yt=pt&(1<<-_t)-1,pt>>=-_t,_t+=dt;_t>0;yt=yt*256+rt[it+vt],vt+=bt,_t-=8);if(pt===0)pt=1-kt;else{if(pt===mt)return yt?NaN:(Mt?-1:1)*(1/0);yt=yt+Math.pow(2,dt),pt=pt-kt}return(Mt?-1:1)*yt*Math.pow(2,pt-dt)},ieee754.write=function(rt,it,ct,dt,ut,pt){var yt,ft,mt,kt=pt*8-ut-1,_t=(1<<kt)-1,vt=_t>>1,bt=ut===23?Math.pow(2,-24)-Math.pow(2,-77):0,Mt=dt?0:pt-1,wt=dt?1:-1,St=it<0||it===0&&1/it<0?1:0;for(it=Math.abs(it),isNaN(it)||it===1/0?(ft=isNaN(it)?1:0,yt=_t):(yt=Math.floor(Math.log(it)/Math.LN2),it*(mt=Math.pow(2,-yt))<1&&(yt--,mt*=2),yt+vt>=1?it+=bt/mt:it+=bt*Math.pow(2,1-vt),it*mt>=2&&(yt++,mt/=2),yt+vt>=_t?(ft=0,yt=_t):yt+vt>=1?(ft=(it*mt-1)*Math.pow(2,ut),yt=yt+vt):(ft=it*Math.pow(2,vt-1)*Math.pow(2,ut),yt=0));ut>=8;rt[ct+Mt]=ft&255,Mt+=wt,ft/=256,ut-=8);for(yt=yt<<ut|ft,kt+=ut;kt>0;rt[ct+Mt]=yt&255,Mt+=wt,yt/=256,kt-=8);rt[ct+Mt-wt]|=St*128}),ieee754}var hasRequiredBuffer;function requireBuffer(){return hasRequiredBuffer||(hasRequiredBuffer=1,(function(rt){const it=requireBase64Js(),ct=requireIeee754(),dt=typeof Symbol=="function"&&typeof Symbol.for=="function"?Symbol.for("nodejs.util.inspect.custom"):null;rt.Buffer=ft,rt.SlowBuffer=$t,rt.INSPECT_MAX_BYTES=50;const ut=2147483647;rt.kMaxLength=ut,ft.TYPED_ARRAY_SUPPORT=pt(),!ft.TYPED_ARRAY_SUPPORT&&typeof console<"u"&&typeof console.error=="function"&&console.error("This browser lacks typed array (Uint8Array) support which is required by `buffer` v5.x. Use `buffer` v4.x if you require old browser support.");function pt(){try{const Pt=new Uint8Array(1),At={foo:function(){return 42}};return Object.setPrototypeOf(At,Uint8Array.prototype),Object.setPrototypeOf(Pt,At),Pt.foo()===42}catch{return!1}}Object.defineProperty(ft.prototype,"parent",{enumerable:!0,get:function(){if(ft.isBuffer(this))return this.buffer}}),Object.defineProperty(ft.prototype,"offset",{enumerable:!0,get:function(){if(ft.isBuffer(this))return this.byteOffset}});function yt(Pt){if(Pt>ut)throw new RangeError('The value "'+Pt+'" is invalid for option "size"');const At=new Uint8Array(Pt);return Object.setPrototypeOf(At,ft.prototype),At}function ft(Pt,At,Rt){if(typeof Pt=="number"){if(typeof At=="string")throw new TypeError('The "string" argument must be of type string. Received type number');return vt(Pt)}return mt(Pt,At,Rt)}ft.poolSize=8192;function mt(Pt,At,Rt){if(typeof Pt=="string")return bt(Pt,At);if(ArrayBuffer.isView(Pt))return wt(Pt);if(Pt==null)throw new TypeError("The first argument must be one of type string, Buffer, ArrayBuffer, Array, or Array-like Object. Received type "+typeof Pt);if(Mn(Pt,ArrayBuffer)||Pt&&Mn(Pt.buffer,ArrayBuffer)||typeof SharedArrayBuffer<"u"&&(Mn(Pt,SharedArrayBuffer)||Pt&&Mn(Pt.buffer,SharedArrayBuffer)))return St(Pt,At,Rt);if(typeof Pt=="number")throw new TypeError('The "value" argument must not be of type number. Received type number');const Bt=Pt.valueOf&&Pt.valueOf();if(Bt!=null&&Bt!==Pt)return ft.from(Bt,At,Rt);const jt=It(Pt);if(jt)return jt;if(typeof Symbol<"u"&&Symbol.toPrimitive!=null&&typeof Pt[Symbol.toPrimitive]=="function")return ft.from(Pt[Symbol.toPrimitive]("string"),At,Rt);throw new TypeError("The first argument must be one of type string, Buffer, ArrayBuffer, Array, or Array-like Object. Received type "+typeof Pt)}ft.from=function(Pt,At,Rt){return mt(Pt,At,Rt)},Object.setPrototypeOf(ft.prototype,Uint8Array.prototype),Object.setPrototypeOf(ft,Uint8Array);function kt(Pt){if(typeof Pt!="number")throw new TypeError('"size" argument must be of type number');if(Pt<0)throw new RangeError('The value "'+Pt+'" is invalid for option "size"')}function _t(Pt,At,Rt){return kt(Pt),Pt<=0?yt(Pt):At!==void 0?typeof Rt=="string"?yt(Pt).fill(At,Rt):yt(Pt).fill(At):yt(Pt)}ft.alloc=function(Pt,At,Rt){return _t(Pt,At,Rt)};function vt(Pt){return kt(Pt),yt(Pt<0?0:Nt(Pt)|0)}ft.allocUnsafe=function(Pt){return vt(Pt)},ft.allocUnsafeSlow=function(Pt){return vt(Pt)};function bt(Pt,At){if((typeof At!="string"||At==="")&&(At="utf8"),!ft.isEncoding(At))throw new TypeError("Unknown encoding: "+At);const Rt=Et(Pt,At)|0;let Bt=yt(Rt);const jt=Bt.write(Pt,At);return jt!==Rt&&(Bt=Bt.slice(0,jt)),Bt}function Mt(Pt){const At=Pt.length<0?0:Nt(Pt.length)|0,Rt=yt(At);for(let Bt=0;Bt<At;Bt+=1)Rt[Bt]=Pt[Bt]&255;return Rt}function wt(Pt){if(Mn(Pt,Uint8Array)){const At=new Uint8Array(Pt);return St(At.buffer,At.byteOffset,At.byteLength)}return Mt(Pt)}function St(Pt,At,Rt){if(At<0||Pt.byteLength<At)throw new RangeError('"offset" is outside of buffer bounds');if(Pt.byteLength<At+(Rt||0))throw new RangeError('"length" is outside of buffer bounds');let Bt;return At===void 0&&Rt===void 0?Bt=new Uint8Array(Pt):Rt===void 0?Bt=new Uint8Array(Pt,At):Bt=new Uint8Array(Pt,At,Rt),Object.setPrototypeOf(Bt,ft.prototype),Bt}function It(Pt){if(ft.isBuffer(Pt)){const At=Nt(Pt.length)|0,Rt=yt(At);return Rt.length===0||Pt.copy(Rt,0,0,At),Rt}if(Pt.length!==void 0)return typeof Pt.length!="number"||vi(Pt.length)?yt(0):Mt(Pt);if(Pt.type==="Buffer"&&Array.isArray(Pt.data))return Mt(Pt.data)}function Nt(Pt){if(Pt>=ut)throw new RangeError("Attempt to allocate Buffer larger than maximum size: 0x"+ut.toString(16)+" bytes");return Pt|0}function $t(Pt){return+Pt!=Pt&&(Pt=0),ft.alloc(+Pt)}ft.isBuffer=function(At){return At!=null&&At._isBuffer===!0&&At!==ft.prototype},ft.compare=function(At,Rt){if(Mn(At,Uint8Array)&&(At=ft.from(At,At.offset,At.byteLength)),Mn(Rt,Uint8Array)&&(Rt=ft.from(Rt,Rt.offset,Rt.byteLength)),!ft.isBuffer(At)||!ft.isBuffer(Rt))throw new TypeError('The "buf1", "buf2" arguments must be one of type Buffer or Uint8Array');if(At===Rt)return 0;let Bt=At.length,jt=Rt.length;for(let Wt=0,Xt=Math.min(Bt,jt);Wt<Xt;++Wt)if(At[Wt]!==Rt[Wt]){Bt=At[Wt],jt=Rt[Wt];break}return Bt<jt?-1:jt<Bt?1:0},ft.isEncoding=function(At){switch(String(At).toLowerCase()){case"hex":case"utf8":case"utf-8":case"ascii":case"latin1":case"binary":case"base64":case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return!0;default:return!1}},ft.concat=function(At,Rt){if(!Array.isArray(At))throw new TypeError('"list" argument must be an Array of Buffers');if(At.length===0)return ft.alloc(0);let Bt;if(Rt===void 0)for(Rt=0,Bt=0;Bt<At.length;++Bt)Rt+=At[Bt].length;const jt=ft.allocUnsafe(Rt);let Wt=0;for(Bt=0;Bt<At.length;++Bt){let Xt=At[Bt];if(Mn(Xt,Uint8Array))Wt+Xt.length>jt.length?(ft.isBuffer(Xt)||(Xt=ft.from(Xt)),Xt.copy(jt,Wt)):Uint8Array.prototype.set.call(jt,Xt,Wt);else if(ft.isBuffer(Xt))Xt.copy(jt,Wt);else throw new TypeError('"list" argument must be an Array of Buffers');Wt+=Xt.length}return jt};function Et(Pt,At){if(ft.isBuffer(Pt))return Pt.length;if(ArrayBuffer.isView(Pt)||Mn(Pt,ArrayBuffer))return Pt.byteLength;if(typeof Pt!="string")throw new TypeError('The "string" argument must be one of type string, Buffer, or ArrayBuffer. Received type '+typeof Pt);const Rt=Pt.length,Bt=arguments.length>2&&arguments[2]===!0;if(!Bt&&Rt===0)return 0;let jt=!1;for(;;)switch(At){case"ascii":case"latin1":case"binary":return Rt;case"utf8":case"utf-8":return Jn(Pt).length;case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return Rt*2;case"hex":return Rt>>>1;case"base64":return jn(Pt).length;default:if(jt)return Bt?-1:Jn(Pt).length;At=(""+At).toLowerCase(),jt=!0}}ft.byteLength=Et;function Ft(Pt,At,Rt){let Bt=!1;if((At===void 0||At<0)&&(At=0),At>this.length||((Rt===void 0||Rt>this.length)&&(Rt=this.length),Rt<=0)||(Rt>>>=0,At>>>=0,Rt<=At))return"";for(Pt||(Pt="utf8");;)switch(Pt){case"hex":return _a(this,At,Rt);case"utf8":case"utf-8":return Kt(this,At,Rt);case"ascii":return ea(this,At,Rt);case"latin1":case"binary":return Gt(this,At,Rt);case"base64":return la(this,At,Rt);case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return Ca(this,At,Rt);default:if(Bt)throw new TypeError("Unknown encoding: "+Pt);Pt=(Pt+"").toLowerCase(),Bt=!0}}ft.prototype._isBuffer=!0;function qt(Pt,At,Rt){const Bt=Pt[At];Pt[At]=Pt[Rt],Pt[Rt]=Bt}ft.prototype.swap16=function(){const At=this.length;if(At%2!==0)throw new RangeError("Buffer size must be a multiple of 16-bits");for(let Rt=0;Rt<At;Rt+=2)qt(this,Rt,Rt+1);return this},ft.prototype.swap32=function(){const At=this.length;if(At%4!==0)throw new RangeError("Buffer size must be a multiple of 32-bits");for(let Rt=0;Rt<At;Rt+=4)qt(this,Rt,Rt+3),qt(this,Rt+1,Rt+2);return this},ft.prototype.swap64=function(){const At=this.length;if(At%8!==0)throw new RangeError("Buffer size must be a multiple of 64-bits");for(let Rt=0;Rt<At;Rt+=8)qt(this,Rt,Rt+7),qt(this,Rt+1,Rt+6),qt(this,Rt+2,Rt+5),qt(this,Rt+3,Rt+4);return this},ft.prototype.toString=function(){const At=this.length;return At===0?"":arguments.length===0?Kt(this,0,At):Ft.apply(this,arguments)},ft.prototype.toLocaleString=ft.prototype.toString,ft.prototype.equals=function(At){if(!ft.isBuffer(At))throw new TypeError("Argument must be a Buffer");return this===At?!0:ft.compare(this,At)===0},ft.prototype.inspect=function(){let At="";const Rt=rt.INSPECT_MAX_BYTES;return At=this.toString("hex",0,Rt).replace(/(.{2})/g,"$1 ").trim(),this.length>Rt&&(At+=" ... "),"<Buffer "+At+">"},dt&&(ft.prototype[dt]=ft.prototype.inspect),ft.prototype.compare=function(At,Rt,Bt,jt,Wt){if(Mn(At,Uint8Array)&&(At=ft.from(At,At.offset,At.byteLength)),!ft.isBuffer(At))throw new TypeError('The "target" argument must be one of type Buffer or Uint8Array. Received type '+typeof At);if(Rt===void 0&&(Rt=0),Bt===void 0&&(Bt=At?At.length:0),jt===void 0&&(jt=0),Wt===void 0&&(Wt=this.length),Rt<0||Bt>At.length||jt<0||Wt>this.length)throw new RangeError("out of range index");if(jt>=Wt&&Rt>=Bt)return 0;if(jt>=Wt)return-1;if(Rt>=Bt)return 1;if(Rt>>>=0,Bt>>>=0,jt>>>=0,Wt>>>=0,this===At)return 0;let Xt=Wt-jt,da=Bt-Rt;const ma=Math.min(Xt,da),pa=this.slice(jt,Wt),La=At.slice(Rt,Bt);for(let ba=0;ba<ma;++ba)if(pa[ba]!==La[ba]){Xt=pa[ba],da=La[ba];break}return Xt<da?-1:da<Xt?1:0};function Ht(Pt,At,Rt,Bt,jt){if(Pt.length===0)return-1;if(typeof Rt=="string"?(Bt=Rt,Rt=0):Rt>2147483647?Rt=2147483647:Rt<-2147483648&&(Rt=-2147483648),Rt=+Rt,vi(Rt)&&(Rt=jt?0:Pt.length-1),Rt<0&&(Rt=Pt.length+Rt),Rt>=Pt.length){if(jt)return-1;Rt=Pt.length-1}else if(Rt<0)if(jt)Rt=0;else return-1;if(typeof At=="string"&&(At=ft.from(At,Bt)),ft.isBuffer(At))return At.length===0?-1:Ot(Pt,At,Rt,Bt,jt);if(typeof At=="number")return At=At&255,typeof Uint8Array.prototype.indexOf=="function"?jt?Uint8Array.prototype.indexOf.call(Pt,At,Rt):Uint8Array.prototype.lastIndexOf.call(Pt,At,Rt):Ot(Pt,[At],Rt,Bt,jt);throw new TypeError("val must be string, number or Buffer")}function Ot(Pt,At,Rt,Bt,jt){let Wt=1,Xt=Pt.length,da=At.length;if(Bt!==void 0&&(Bt=String(Bt).toLowerCase(),Bt==="ucs2"||Bt==="ucs-2"||Bt==="utf16le"||Bt==="utf-16le")){if(Pt.length<2||At.length<2)return-1;Wt=2,Xt/=2,da/=2,Rt/=2}function ma(La,ba){return Wt===1?La[ba]:La.readUInt16BE(ba*Wt)}let pa;if(jt){let La=-1;for(pa=Rt;pa<Xt;pa++)if(ma(Pt,pa)===ma(At,La===-1?0:pa-La)){if(La===-1&&(La=pa),pa-La+1===da)return La*Wt}else La!==-1&&(pa-=pa-La),La=-1}else for(Rt+da>Xt&&(Rt=Xt-da),pa=Rt;pa>=0;pa--){let La=!0;for(let ba=0;ba<da;ba++)if(ma(Pt,pa+ba)!==ma(At,ba)){La=!1;break}if(La)return pa}return-1}ft.prototype.includes=function(At,Rt,Bt){return this.indexOf(At,Rt,Bt)!==-1},ft.prototype.indexOf=function(At,Rt,Bt){return Ht(this,At,Rt,Bt,!0)},ft.prototype.lastIndexOf=function(At,Rt,Bt){return Ht(this,At,Rt,Bt,!1)};function Zt(Pt,At,Rt,Bt){Rt=Number(Rt)||0;const jt=Pt.length-Rt;Bt?(Bt=Number(Bt),Bt>jt&&(Bt=jt)):Bt=jt;const Wt=At.length;Bt>Wt/2&&(Bt=Wt/2);let Xt;for(Xt=0;Xt<Bt;++Xt){const da=parseInt(At.substr(Xt*2,2),16);if(vi(da))return Xt;Pt[Rt+Xt]=da}return Xt}function Yt(Pt,At,Rt,Bt){return On(Jn(At,Pt.length-Rt),Pt,Rt,Bt)}function aa(Pt,At,Rt,Bt){return On(vn(At),Pt,Rt,Bt)}function Qt(Pt,At,Rt,Bt){return On(jn(At),Pt,Rt,Bt)}function oa(Pt,At,Rt,Bt){return On(Un(At,Pt.length-Rt),Pt,Rt,Bt)}ft.prototype.write=function(At,Rt,Bt,jt){if(Rt===void 0)jt="utf8",Bt=this.length,Rt=0;else if(Bt===void 0&&typeof Rt=="string")jt=Rt,Bt=this.length,Rt=0;else if(isFinite(Rt))Rt=Rt>>>0,isFinite(Bt)?(Bt=Bt>>>0,jt===void 0&&(jt="utf8")):(jt=Bt,Bt=void 0);else throw new Error("Buffer.write(string, encoding, offset[, length]) is no longer supported");const Wt=this.length-Rt;if((Bt===void 0||Bt>Wt)&&(Bt=Wt),At.length>0&&(Bt<0||Rt<0)||Rt>this.length)throw new RangeError("Attempt to write outside buffer bounds");jt||(jt="utf8");let Xt=!1;for(;;)switch(jt){case"hex":return Zt(this,At,Rt,Bt);case"utf8":case"utf-8":return Yt(this,At,Rt,Bt);case"ascii":case"latin1":case"binary":return aa(this,At,Rt,Bt);case"base64":return Qt(this,At,Rt,Bt);case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return oa(this,At,Rt,Bt);default:if(Xt)throw new TypeError("Unknown encoding: "+jt);jt=(""+jt).toLowerCase(),Xt=!0}},ft.prototype.toJSON=function(){return{type:"Buffer",data:Array.prototype.slice.call(this._arr||this,0)}};function la(Pt,At,Rt){return At===0&&Rt===Pt.length?it.fromByteArray(Pt):it.fromByteArray(Pt.slice(At,Rt))}function Kt(Pt,At,Rt){Rt=Math.min(Pt.length,Rt);const Bt=[];let jt=At;for(;jt<Rt;){const Wt=Pt[jt];let Xt=null,da=Wt>239?4:Wt>223?3:Wt>191?2:1;if(jt+da<=Rt){let ma,pa,La,ba;switch(da){case 1:Wt<128&&(Xt=Wt);break;case 2:ma=Pt[jt+1],(ma&192)===128&&(ba=(Wt&31)<<6|ma&63,ba>127&&(Xt=ba));break;case 3:ma=Pt[jt+1],pa=Pt[jt+2],(ma&192)===128&&(pa&192)===128&&(ba=(Wt&15)<<12|(ma&63)<<6|pa&63,ba>2047&&(ba<55296||ba>57343)&&(Xt=ba));break;case 4:ma=Pt[jt+1],pa=Pt[jt+2],La=Pt[jt+3],(ma&192)===128&&(pa&192)===128&&(La&192)===128&&(ba=(Wt&15)<<18|(ma&63)<<12|(pa&63)<<6|La&63,ba>65535&&ba<1114112&&(Xt=ba))}}Xt===null?(Xt=65533,da=1):Xt>65535&&(Xt-=65536,Bt.push(Xt>>>10&1023|55296),Xt=56320|Xt&1023),Bt.push(Xt),jt+=da}return Ut(Bt)}const ra=4096;function Ut(Pt){const At=Pt.length;if(At<=ra)return String.fromCharCode.apply(String,Pt);let Rt="",Bt=0;for(;Bt<At;)Rt+=String.fromCharCode.apply(String,Pt.slice(Bt,Bt+=ra));return Rt}function ea(Pt,At,Rt){let Bt="";Rt=Math.min(Pt.length,Rt);for(let jt=At;jt<Rt;++jt)Bt+=String.fromCharCode(Pt[jt]&127);return Bt}function Gt(Pt,At,Rt){let Bt="";Rt=Math.min(Pt.length,Rt);for(let jt=At;jt<Rt;++jt)Bt+=String.fromCharCode(Pt[jt]);return Bt}function _a(Pt,At,Rt){const Bt=Pt.length;(!At||At<0)&&(At=0),(!Rt||Rt<0||Rt>Bt)&&(Rt=Bt);let jt="";for(let Wt=At;Wt<Rt;++Wt)jt+=pn[Pt[Wt]];return jt}function Ca(Pt,At,Rt){const Bt=Pt.slice(At,Rt);let jt="";for(let Wt=0;Wt<Bt.length-1;Wt+=2)jt+=String.fromCharCode(Bt[Wt]+Bt[Wt+1]*256);return jt}ft.prototype.slice=function(At,Rt){const Bt=this.length;At=~~At,Rt=Rt===void 0?Bt:~~Rt,At<0?(At+=Bt,At<0&&(At=0)):At>Bt&&(At=Bt),Rt<0?(Rt+=Bt,Rt<0&&(Rt=0)):Rt>Bt&&(Rt=Bt),Rt<At&&(Rt=At);const jt=this.subarray(At,Rt);return Object.setPrototypeOf(jt,ft.prototype),jt};function Vt(Pt,At,Rt){if(Pt%1!==0||Pt<0)throw new RangeError("offset is not uint");if(Pt+At>Rt)throw new RangeError("Trying to access beyond buffer length")}ft.prototype.readUintLE=ft.prototype.readUIntLE=function(At,Rt,Bt){At=At>>>0,Rt=Rt>>>0,Bt||Vt(At,Rt,this.length);let jt=this[At],Wt=1,Xt=0;for(;++Xt<Rt&&(Wt*=256);)jt+=this[At+Xt]*Wt;return jt},ft.prototype.readUintBE=ft.prototype.readUIntBE=function(At,Rt,Bt){At=At>>>0,Rt=Rt>>>0,Bt||Vt(At,Rt,this.length);let jt=this[At+--Rt],Wt=1;for(;Rt>0&&(Wt*=256);)jt+=this[At+--Rt]*Wt;return jt},ft.prototype.readUint8=ft.prototype.readUInt8=function(At,Rt){return At=At>>>0,Rt||Vt(At,1,this.length),this[At]},ft.prototype.readUint16LE=ft.prototype.readUInt16LE=function(At,Rt){return At=At>>>0,Rt||Vt(At,2,this.length),this[At]|this[At+1]<<8},ft.prototype.readUint16BE=ft.prototype.readUInt16BE=function(At,Rt){return At=At>>>0,Rt||Vt(At,2,this.length),this[At]<<8|this[At+1]},ft.prototype.readUint32LE=ft.prototype.readUInt32LE=function(At,Rt){return At=At>>>0,Rt||Vt(At,4,this.length),(this[At]|this[At+1]<<8|this[At+2]<<16)+this[At+3]*16777216},ft.prototype.readUint32BE=ft.prototype.readUInt32BE=function(At,Rt){return At=At>>>0,Rt||Vt(At,4,this.length),this[At]*16777216+(this[At+1]<<16|this[At+2]<<8|this[At+3])},ft.prototype.readBigUInt64LE=Tt(function(At){At=At>>>0,Ja(At,"offset");const Rt=this[At],Bt=this[At+7];(Rt===void 0||Bt===void 0)&&kn(At,this.length-8);const jt=Rt+this[++At]*2**8+this[++At]*2**16+this[++At]*2**24,Wt=this[++At]+this[++At]*2**8+this[++At]*2**16+Bt*2**24;return BigInt(jt)+(BigInt(Wt)<<BigInt(32))}),ft.prototype.readBigUInt64BE=Tt(function(At){At=At>>>0,Ja(At,"offset");const Rt=this[At],Bt=this[At+7];(Rt===void 0||Bt===void 0)&&kn(At,this.length-8);const jt=Rt*2**24+this[++At]*2**16+this[++At]*2**8+this[++At],Wt=this[++At]*2**24+this[++At]*2**16+this[++At]*2**8+Bt;return(BigInt(jt)<<BigInt(32))+BigInt(Wt)}),ft.prototype.readIntLE=function(At,Rt,Bt){At=At>>>0,Rt=Rt>>>0,Bt||Vt(At,Rt,this.length);let jt=this[At],Wt=1,Xt=0;for(;++Xt<Rt&&(Wt*=256);)jt+=this[At+Xt]*Wt;return Wt*=128,jt>=Wt&&(jt-=Math.pow(2,8*Rt)),jt},ft.prototype.readIntBE=function(At,Rt,Bt){At=At>>>0,Rt=Rt>>>0,Bt||Vt(At,Rt,this.length);let jt=Rt,Wt=1,Xt=this[At+--jt];for(;jt>0&&(Wt*=256);)Xt+=this[At+--jt]*Wt;return Wt*=128,Xt>=Wt&&(Xt-=Math.pow(2,8*Rt)),Xt},ft.prototype.readInt8=function(At,Rt){return At=At>>>0,Rt||Vt(At,1,this.length),this[At]&128?(255-this[At]+1)*-1:this[At]},ft.prototype.readInt16LE=function(At,Rt){At=At>>>0,Rt||Vt(At,2,this.length);const Bt=this[At]|this[At+1]<<8;return Bt&32768?Bt|4294901760:Bt},ft.prototype.readInt16BE=function(At,Rt){At=At>>>0,Rt||Vt(At,2,this.length);const Bt=this[At+1]|this[At]<<8;return Bt&32768?Bt|4294901760:Bt},ft.prototype.readInt32LE=function(At,Rt){return At=At>>>0,Rt||Vt(At,4,this.length),this[At]|this[At+1]<<8|this[At+2]<<16|this[At+3]<<24},ft.prototype.readInt32BE=function(At,Rt){return At=At>>>0,Rt||Vt(At,4,this.length),this[At]<<24|this[At+1]<<16|this[At+2]<<8|this[At+3]},ft.prototype.readBigInt64LE=Tt(function(At){At=At>>>0,Ja(At,"offset");const Rt=this[At],Bt=this[At+7];(Rt===void 0||Bt===void 0)&&kn(At,this.length-8);const jt=this[At+4]+this[At+5]*2**8+this[At+6]*2**16+(Bt<<24);return(BigInt(jt)<<BigInt(32))+BigInt(Rt+this[++At]*2**8+this[++At]*2**16+this[++At]*2**24)}),ft.prototype.readBigInt64BE=Tt(function(At){At=At>>>0,Ja(At,"offset");const Rt=this[At],Bt=this[At+7];(Rt===void 0||Bt===void 0)&&kn(At,this.length-8);const jt=(Rt<<24)+this[++At]*2**16+this[++At]*2**8+this[++At];return(BigInt(jt)<<BigInt(32))+BigInt(this[++At]*2**24+this[++At]*2**16+this[++At]*2**8+Bt)}),ft.prototype.readFloatLE=function(At,Rt){return At=At>>>0,Rt||Vt(At,4,this.length),ct.read(this,At,!0,23,4)},ft.prototype.readFloatBE=function(At,Rt){return At=At>>>0,Rt||Vt(At,4,this.length),ct.read(this,At,!1,23,4)},ft.prototype.readDoubleLE=function(At,Rt){return At=At>>>0,Rt||Vt(At,8,this.length),ct.read(this,At,!0,52,8)},ft.prototype.readDoubleBE=function(At,Rt){return At=At>>>0,Rt||Vt(At,8,this.length),ct.read(this,At,!1,52,8)};function ta(Pt,At,Rt,Bt,jt,Wt){if(!ft.isBuffer(Pt))throw new TypeError('"buffer" argument must be a Buffer instance');if(At>jt||At<Wt)throw new RangeError('"value" argument is out of bounds');if(Rt+Bt>Pt.length)throw new RangeError("Index out of range")}ft.prototype.writeUintLE=ft.prototype.writeUIntLE=function(At,Rt,Bt,jt){if(At=+At,Rt=Rt>>>0,Bt=Bt>>>0,!jt){const da=Math.pow(2,8*Bt)-1;ta(this,At,Rt,Bt,da,0)}let Wt=1,Xt=0;for(this[Rt]=At&255;++Xt<Bt&&(Wt*=256);)this[Rt+Xt]=At/Wt&255;return Rt+Bt},ft.prototype.writeUintBE=ft.prototype.writeUIntBE=function(At,Rt,Bt,jt){if(At=+At,Rt=Rt>>>0,Bt=Bt>>>0,!jt){const da=Math.pow(2,8*Bt)-1;ta(this,At,Rt,Bt,da,0)}let Wt=Bt-1,Xt=1;for(this[Rt+Wt]=At&255;--Wt>=0&&(Xt*=256);)this[Rt+Wt]=At/Xt&255;return Rt+Bt},ft.prototype.writeUint8=ft.prototype.writeUInt8=function(At,Rt,Bt){return At=+At,Rt=Rt>>>0,Bt||ta(this,At,Rt,1,255,0),this[Rt]=At&255,Rt+1},ft.prototype.writeUint16LE=ft.prototype.writeUInt16LE=function(At,Rt,Bt){return At=+At,Rt=Rt>>>0,Bt||ta(this,At,Rt,2,65535,0),this[Rt]=At&255,this[Rt+1]=At>>>8,Rt+2},ft.prototype.writeUint16BE=ft.prototype.writeUInt16BE=function(At,Rt,Bt){return At=+At,Rt=Rt>>>0,Bt||ta(this,At,Rt,2,65535,0),this[Rt]=At>>>8,this[Rt+1]=At&255,Rt+2},ft.prototype.writeUint32LE=ft.prototype.writeUInt32LE=function(At,Rt,Bt){return At=+At,Rt=Rt>>>0,Bt||ta(this,At,Rt,4,4294967295,0),this[Rt+3]=At>>>24,this[Rt+2]=At>>>16,this[Rt+1]=At>>>8,this[Rt]=At&255,Rt+4},ft.prototype.writeUint32BE=ft.prototype.writeUInt32BE=function(At,Rt,Bt){return At=+At,Rt=Rt>>>0,Bt||ta(this,At,Rt,4,4294967295,0),this[Rt]=At>>>24,this[Rt+1]=At>>>16,this[Rt+2]=At>>>8,this[Rt+3]=At&255,Rt+4};function sa(Pt,At,Rt,Bt,jt){hn(At,Bt,jt,Pt,Rt,7);let Wt=Number(At&BigInt(4294967295));Pt[Rt++]=Wt,Wt=Wt>>8,Pt[Rt++]=Wt,Wt=Wt>>8,Pt[Rt++]=Wt,Wt=Wt>>8,Pt[Rt++]=Wt;let Xt=Number(At>>BigInt(32)&BigInt(4294967295));return Pt[Rt++]=Xt,Xt=Xt>>8,Pt[Rt++]=Xt,Xt=Xt>>8,Pt[Rt++]=Xt,Xt=Xt>>8,Pt[Rt++]=Xt,Rt}function xa(Pt,At,Rt,Bt,jt){hn(At,Bt,jt,Pt,Rt,7);let Wt=Number(At&BigInt(4294967295));Pt[Rt+7]=Wt,Wt=Wt>>8,Pt[Rt+6]=Wt,Wt=Wt>>8,Pt[Rt+5]=Wt,Wt=Wt>>8,Pt[Rt+4]=Wt;let Xt=Number(At>>BigInt(32)&BigInt(4294967295));return Pt[Rt+3]=Xt,Xt=Xt>>8,Pt[Rt+2]=Xt,Xt=Xt>>8,Pt[Rt+1]=Xt,Xt=Xt>>8,Pt[Rt]=Xt,Rt+8}ft.prototype.writeBigUInt64LE=Tt(function(At,Rt=0){return sa(this,At,Rt,BigInt(0),BigInt("0xffffffffffffffff"))}),ft.prototype.writeBigUInt64BE=Tt(function(At,Rt=0){return xa(this,At,Rt,BigInt(0),BigInt("0xffffffffffffffff"))}),ft.prototype.writeIntLE=function(At,Rt,Bt,jt){if(At=+At,Rt=Rt>>>0,!jt){const ma=Math.pow(2,8*Bt-1);ta(this,At,Rt,Bt,ma-1,-ma)}let Wt=0,Xt=1,da=0;for(this[Rt]=At&255;++Wt<Bt&&(Xt*=256);)At<0&&da===0&&this[Rt+Wt-1]!==0&&(da=1),this[Rt+Wt]=(At/Xt>>0)-da&255;return Rt+Bt},ft.prototype.writeIntBE=function(At,Rt,Bt,jt){if(At=+At,Rt=Rt>>>0,!jt){const ma=Math.pow(2,8*Bt-1);ta(this,At,Rt,Bt,ma-1,-ma)}let Wt=Bt-1,Xt=1,da=0;for(this[Rt+Wt]=At&255;--Wt>=0&&(Xt*=256);)At<0&&da===0&&this[Rt+Wt+1]!==0&&(da=1),this[Rt+Wt]=(At/Xt>>0)-da&255;return Rt+Bt},ft.prototype.writeInt8=function(At,Rt,Bt){return At=+At,Rt=Rt>>>0,Bt||ta(this,At,Rt,1,127,-128),At<0&&(At=255+At+1),this[Rt]=At&255,Rt+1},ft.prototype.writeInt16LE=function(At,Rt,Bt){return At=+At,Rt=Rt>>>0,Bt||ta(this,At,Rt,2,32767,-32768),this[Rt]=At&255,this[Rt+1]=At>>>8,Rt+2},ft.prototype.writeInt16BE=function(At,Rt,Bt){return At=+At,Rt=Rt>>>0,Bt||ta(this,At,Rt,2,32767,-32768),this[Rt]=At>>>8,this[Rt+1]=At&255,Rt+2},ft.prototype.writeInt32LE=function(At,Rt,Bt){return At=+At,Rt=Rt>>>0,Bt||ta(this,At,Rt,4,2147483647,-2147483648),this[Rt]=At&255,this[Rt+1]=At>>>8,this[Rt+2]=At>>>16,this[Rt+3]=At>>>24,Rt+4},ft.prototype.writeInt32BE=function(At,Rt,Bt){return At=+At,Rt=Rt>>>0,Bt||ta(this,At,Rt,4,2147483647,-2147483648),At<0&&(At=4294967295+At+1),this[Rt]=At>>>24,this[Rt+1]=At>>>16,this[Rt+2]=At>>>8,this[Rt+3]=At&255,Rt+4},ft.prototype.writeBigInt64LE=Tt(function(At,Rt=0){return sa(this,At,Rt,-BigInt("0x8000000000000000"),BigInt("0x7fffffffffffffff"))}),ft.prototype.writeBigInt64BE=Tt(function(At,Rt=0){return xa(this,At,Rt,-BigInt("0x8000000000000000"),BigInt("0x7fffffffffffffff"))});function ka(Pt,At,Rt,Bt,jt,Wt){if(Rt+Bt>Pt.length)throw new RangeError("Index out of range");if(Rt<0)throw new RangeError("Index out of range")}function $a(Pt,At,Rt,Bt,jt){return At=+At,Rt=Rt>>>0,jt||ka(Pt,At,Rt,4),ct.write(Pt,At,Rt,Bt,23,4),Rt+4}ft.prototype.writeFloatLE=function(At,Rt,Bt){return $a(this,At,Rt,!0,Bt)},ft.prototype.writeFloatBE=function(At,Rt,Bt){return $a(this,At,Rt,!1,Bt)};function Na(Pt,At,Rt,Bt,jt){return At=+At,Rt=Rt>>>0,jt||ka(Pt,At,Rt,8),ct.write(Pt,At,Rt,Bt,52,8),Rt+8}ft.prototype.writeDoubleLE=function(At,Rt,Bt){return Na(this,At,Rt,!0,Bt)},ft.prototype.writeDoubleBE=function(At,Rt,Bt){return Na(this,At,Rt,!1,Bt)},ft.prototype.copy=function(At,Rt,Bt,jt){if(!ft.isBuffer(At))throw new TypeError("argument should be a Buffer");if(Bt||(Bt=0),!jt&&jt!==0&&(jt=this.length),Rt>=At.length&&(Rt=At.length),Rt||(Rt=0),jt>0&&jt<Bt&&(jt=Bt),jt===Bt||At.length===0||this.length===0)return 0;if(Rt<0)throw new RangeError("targetStart out of bounds");if(Bt<0||Bt>=this.length)throw new RangeError("Index out of range");if(jt<0)throw new RangeError("sourceEnd out of bounds");jt>this.length&&(jt=this.length),At.length-Rt<jt-Bt&&(jt=At.length-Rt+Bt);const Wt=jt-Bt;return this===At&&typeof Uint8Array.prototype.copyWithin=="function"?this.copyWithin(Rt,Bt,jt):Uint8Array.prototype.set.call(At,this.subarray(Bt,jt),Rt),Wt},ft.prototype.fill=function(At,Rt,Bt,jt){if(typeof At=="string"){if(typeof Rt=="string"?(jt=Rt,Rt=0,Bt=this.length):typeof Bt=="string"&&(jt=Bt,Bt=this.length),jt!==void 0&&typeof jt!="string")throw new TypeError("encoding must be a string");if(typeof jt=="string"&&!ft.isEncoding(jt))throw new TypeError("Unknown encoding: "+jt);if(At.length===1){const Xt=At.charCodeAt(0);(jt==="utf8"&&Xt<128||jt==="latin1")&&(At=Xt)}}else typeof At=="number"?At=At&255:typeof At=="boolean"&&(At=Number(At));if(Rt<0||this.length<Rt||this.length<Bt)throw new RangeError("Out of range index");if(Bt<=Rt)return this;Rt=Rt>>>0,Bt=Bt===void 0?this.length:Bt>>>0,At||(At=0);let Wt;if(typeof At=="number")for(Wt=Rt;Wt<Bt;++Wt)this[Wt]=At;else{const Xt=ft.isBuffer(At)?At:ft.from(At,jt),da=Xt.length;if(da===0)throw new TypeError('The value "'+At+'" is invalid for argument "value"');for(Wt=0;Wt<Bt-Rt;++Wt)this[Wt+Rt]=Xt[Wt%da]}return this};const Fa={};function qa(Pt,At,Rt){Fa[Pt]=class extends Rt{constructor(){super(),Object.defineProperty(this,"message",{value:At.apply(this,arguments),writable:!0,configurable:!0}),this.name=`${this.name} [${Pt}]`,this.stack,delete this.name}get code(){return Pt}set code(jt){Object.defineProperty(this,"code",{configurable:!0,enumerable:!0,value:jt,writable:!0})}toString(){return`${this.name} [${Pt}]: ${this.message}`}}}qa("ERR_BUFFER_OUT_OF_BOUNDS",function(Pt){return Pt?`${Pt} is outside of buffer bounds`:"Attempt to access memory outside buffer bounds"},RangeError),qa("ERR_INVALID_ARG_TYPE",function(Pt,At){return`The "${Pt}" argument must be of type number. Received type ${typeof At}`},TypeError),qa("ERR_OUT_OF_RANGE",function(Pt,At,Rt){let Bt=`The value of "${Pt}" is out of range.`,jt=Rt;return Number.isInteger(Rt)&&Math.abs(Rt)>2**32?jt=Ha(String(Rt)):typeof Rt=="bigint"&&(jt=String(Rt),(Rt>BigInt(2)**BigInt(32)||Rt<-(BigInt(2)**BigInt(32)))&&(jt=Ha(jt)),jt+="n"),Bt+=` It must be ${At}. Received ${jt}`,Bt},RangeError);function Ha(Pt){let At="",Rt=Pt.length;const Bt=Pt[0]==="-"?1:0;for(;Rt>=Bt+4;Rt-=3)At=`_${Pt.slice(Rt-3,Rt)}${At}`;return`${Pt.slice(0,Rt)}${At}`}function rn(Pt,At,Rt){Ja(At,"offset"),(Pt[At]===void 0||Pt[At+Rt]===void 0)&&kn(At,Pt.length-(Rt+1))}function hn(Pt,At,Rt,Bt,jt,Wt){if(Pt>Rt||Pt<At){const Xt=typeof At=="bigint"?"n":"";let da;throw At===0||At===BigInt(0)?da=`>= 0${Xt} and < 2${Xt} ** ${(Wt+1)*8}${Xt}`:da=`>= -(2${Xt} ** ${(Wt+1)*8-1}${Xt}) and < 2 ** ${(Wt+1)*8-1}${Xt}`,new Fa.ERR_OUT_OF_RANGE("value",da,Pt)}rn(Bt,jt,Wt)}function Ja(Pt,At){if(typeof Pt!="number")throw new Fa.ERR_INVALID_ARG_TYPE(At,"number",Pt)}function kn(Pt,At,Rt){throw Math.floor(Pt)!==Pt?(Ja(Pt,Rt),new Fa.ERR_OUT_OF_RANGE("offset","an integer",Pt)):At<0?new Fa.ERR_BUFFER_OUT_OF_BOUNDS:new Fa.ERR_OUT_OF_RANGE("offset",`>= 0 and <= ${At}`,Pt)}const En=/[^+/0-9A-Za-z-_]/g;function Hn(Pt){if(Pt=Pt.split("=")[0],Pt=Pt.trim().replace(En,""),Pt.length<2)return"";for(;Pt.length%4!==0;)Pt=Pt+"=";return Pt}function Jn(Pt,At){At=At||1/0;let Rt;const Bt=Pt.length;let jt=null;const Wt=[];for(let Xt=0;Xt<Bt;++Xt){if(Rt=Pt.charCodeAt(Xt),Rt>55295&&Rt<57344){if(!jt){if(Rt>56319){(At-=3)>-1&&Wt.push(239,191,189);continue}else if(Xt+1===Bt){(At-=3)>-1&&Wt.push(239,191,189);continue}jt=Rt;continue}if(Rt<56320){(At-=3)>-1&&Wt.push(239,191,189),jt=Rt;continue}Rt=(jt-55296<<10|Rt-56320)+65536}else jt&&(At-=3)>-1&&Wt.push(239,191,189);if(jt=null,Rt<128){if((At-=1)<0)break;Wt.push(Rt)}else if(Rt<2048){if((At-=2)<0)break;Wt.push(Rt>>6|192,Rt&63|128)}else if(Rt<65536){if((At-=3)<0)break;Wt.push(Rt>>12|224,Rt>>6&63|128,Rt&63|128)}else if(Rt<1114112){if((At-=4)<0)break;Wt.push(Rt>>18|240,Rt>>12&63|128,Rt>>6&63|128,Rt&63|128)}else throw new Error("Invalid code point")}return Wt}function vn(Pt){const At=[];for(let Rt=0;Rt<Pt.length;++Rt)At.push(Pt.charCodeAt(Rt)&255);return At}function Un(Pt,At){let Rt,Bt,jt;const Wt=[];for(let Xt=0;Xt<Pt.length&&!((At-=2)<0);++Xt)Rt=Pt.charCodeAt(Xt),Bt=Rt>>8,jt=Rt%256,Wt.push(jt),Wt.push(Bt);return Wt}function jn(Pt){return it.toByteArray(Hn(Pt))}function On(Pt,At,Rt,Bt){let jt;for(jt=0;jt<Bt&&!(jt+Rt>=At.length||jt>=Pt.length);++jt)At[jt+Rt]=Pt[jt];return jt}function Mn(Pt,At){return Pt instanceof At||Pt!=null&&Pt.constructor!=null&&Pt.constructor.name!=null&&Pt.constructor.name===At.name}function vi(Pt){return Pt!==Pt}const pn=(function(){const Pt="0123456789abcdef",At=new Array(256);for(let Rt=0;Rt<16;++Rt){const Bt=Rt*16;for(let jt=0;jt<16;++jt)At[Bt+jt]=Pt[Rt]+Pt[jt]}return At})();function Tt(Pt){return typeof BigInt>"u"?fa:Pt}function fa(){throw new Error("BigInt not supported")}})(buffer)),buffer}var bufferExports=requireBuffer(),react={exports:{}},react_production={};var hasRequiredReact_production;function requireReact_production(){if(hasRequiredReact_production)return react_production;hasRequiredReact_production=1;var rt=Symbol.for("react.transitional.element"),it=Symbol.for("react.portal"),ct=Symbol.for("react.fragment"),dt=Symbol.for("react.strict_mode"),ut=Symbol.for("react.profiler"),pt=Symbol.for("react.consumer"),yt=Symbol.for("react.context"),ft=Symbol.for("react.forward_ref"),mt=Symbol.for("react.suspense"),kt=Symbol.for("react.memo"),_t=Symbol.for("react.lazy"),vt=Symbol.for("react.activity"),bt=Symbol.iterator;function Mt(Vt){return Vt===null||typeof Vt!="object"?null:(Vt=bt&&Vt[bt]||Vt["@@iterator"],typeof Vt=="function"?Vt:null)}var wt={isMounted:function(){return!1},enqueueForceUpdate:function(){},enqueueReplaceState:function(){},enqueueSetState:function(){}},St=Object.assign,It={};function Nt(Vt,ta,sa){this.props=Vt,this.context=ta,this.refs=It,this.updater=sa||wt}Nt.prototype.isReactComponent={},Nt.prototype.setState=function(Vt,ta){if(typeof Vt!="object"&&typeof Vt!="function"&&Vt!=null)throw Error("takes an object of state variables to update or a function which returns an object of state variables.");this.updater.enqueueSetState(this,Vt,ta,"setState")},Nt.prototype.forceUpdate=function(Vt){this.updater.enqueueForceUpdate(this,Vt,"forceUpdate")};function $t(){}$t.prototype=Nt.prototype;function Et(Vt,ta,sa){this.props=Vt,this.context=ta,this.refs=It,this.updater=sa||wt}var Ft=Et.prototype=new $t;Ft.constructor=Et,St(Ft,Nt.prototype),Ft.isPureReactComponent=!0;var qt=Array.isArray;function Ht(){}var Ot={H:null,A:null,T:null,S:null},Zt=Object.prototype.hasOwnProperty;function Yt(Vt,ta,sa){var xa=sa.ref;return{$$typeof:rt,type:Vt,key:ta,ref:xa!==void 0?xa:null,props:sa}}function aa(Vt,ta){return Yt(Vt.type,ta,Vt.props)}function Qt(Vt){return typeof Vt=="object"&&Vt!==null&&Vt.$$typeof===rt}function oa(Vt){var ta={"=":"=0",":":"=2"};return"$"+Vt.replace(/[=:]/g,function(sa){return ta[sa]})}var la=/\/+/g;function Kt(Vt,ta){return typeof Vt=="object"&&Vt!==null&&Vt.key!=null?oa(""+Vt.key):ta.toString(36)}function ra(Vt){switch(Vt.status){case"fulfilled":return Vt.value;case"rejected":throw Vt.reason;default:switch(typeof Vt.status=="string"?Vt.then(Ht,Ht):(Vt.status="pending",Vt.then(function(ta){Vt.status==="pending"&&(Vt.status="fulfilled",Vt.value=ta)},function(ta){Vt.status==="pending"&&(Vt.status="rejected",Vt.reason=ta)})),Vt.status){case"fulfilled":return Vt.value;case"rejected":throw Vt.reason}}throw Vt}function Ut(Vt,ta,sa,xa,ka){var $a=typeof Vt;($a==="undefined"||$a==="boolean")&&(Vt=null);var Na=!1;if(Vt===null)Na=!0;else switch($a){case"bigint":case"string":case"number":Na=!0;break;case"object":switch(Vt.$$typeof){case rt:case it:Na=!0;break;case _t:return Na=Vt._init,Ut(Na(Vt._payload),ta,sa,xa,ka)}}if(Na)return ka=ka(Vt),Na=xa===""?"."+Kt(Vt,0):xa,qt(ka)?(sa="",Na!=null&&(sa=Na.replace(la,"$&/")+"/"),Ut(ka,ta,sa,"",function(Ha){return Ha})):ka!=null&&(Qt(ka)&&(ka=aa(ka,sa+(ka.key==null||Vt&&Vt.key===ka.key?"":(""+ka.key).replace(la,"$&/")+"/")+Na)),ta.push(ka)),1;Na=0;var Fa=xa===""?".":xa+":";if(qt(Vt))for(var qa=0;qa<Vt.length;qa++)xa=Vt[qa],$a=Fa+Kt(xa,qa),Na+=Ut(xa,ta,sa,$a,ka);else if(qa=Mt(Vt),typeof qa=="function")for(Vt=qa.call(Vt),qa=0;!(xa=Vt.next()).done;)xa=xa.value,$a=Fa+Kt(xa,qa++),Na+=Ut(xa,ta,sa,$a,ka);else if($a==="object"){if(typeof Vt.then=="function")return Ut(ra(Vt),ta,sa,xa,ka);throw ta=String(Vt),Error("Objects are not valid as a React child (found: "+(ta==="[object Object]"?"object with keys {"+Object.keys(Vt).join(", ")+"}":ta)+"). If you meant to render a collection of children, use an array instead.")}return Na}function ea(Vt,ta,sa){if(Vt==null)return Vt;var xa=[],ka=0;return Ut(Vt,xa,"","",function($a){return ta.call(sa,$a,ka++)}),xa}function Gt(Vt){if(Vt._status===-1){var ta=Vt._result;ta=ta(),ta.then(function(sa){(Vt._status===0||Vt._status===-1)&&(Vt._status=1,Vt._result=sa)},function(sa){(Vt._status===0||Vt._status===-1)&&(Vt._status=2,Vt._result=sa)}),Vt._status===-1&&(Vt._status=0,Vt._result=ta)}if(Vt._status===1)return Vt._result.default;throw Vt._result}var _a=typeof reportError=="function"?reportError:function(Vt){if(typeof window=="object"&&typeof window.ErrorEvent=="function"){var ta=new window.ErrorEvent("error",{bubbles:!0,cancelable:!0,message:typeof Vt=="object"&&Vt!==null&&typeof Vt.message=="string"?String(Vt.message):String(Vt),error:Vt});if(!window.dispatchEvent(ta))return}else if(typeof process=="object"&&typeof process.emit=="function"){process.emit("uncaughtException",Vt);return}console.error(Vt)},Ca={map:ea,forEach:function(Vt,ta,sa){ea(Vt,function(){ta.apply(this,arguments)},sa)},count:function(Vt){var ta=0;return ea(Vt,function(){ta++}),ta},toArray:function(Vt){return ea(Vt,function(ta){return ta})||[]},only:function(Vt){if(!Qt(Vt))throw Error("React.Children.only expected to receive a single React element child.");return Vt}};return react_production.Activity=vt,react_production.Children=Ca,react_production.Component=Nt,react_production.Fragment=ct,react_production.Profiler=ut,react_production.PureComponent=Et,react_production.StrictMode=dt,react_production.Suspense=mt,react_production.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE=Ot,react_production.__COMPILER_RUNTIME={__proto__:null,c:function(Vt){return Ot.H.useMemoCache(Vt)}},react_production.cache=function(Vt){return function(){return Vt.apply(null,arguments)}},react_production.cacheSignal=function(){return null},react_production.cloneElement=function(Vt,ta,sa){if(Vt==null)throw Error("The argument must be a React element, but you passed "+Vt+".");var xa=St({},Vt.props),ka=Vt.key;if(ta!=null)for($a in ta.key!==void 0&&(ka=""+ta.key),ta)!Zt.call(ta,$a)||$a==="key"||$a==="__self"||$a==="__source"||$a==="ref"&&ta.ref===void 0||(xa[$a]=ta[$a]);var $a=arguments.length-2;if($a===1)xa.children=sa;else if(1<$a){for(var Na=Array($a),Fa=0;Fa<$a;Fa++)Na[Fa]=arguments[Fa+2];xa.children=Na}return Yt(Vt.type,ka,xa)},react_production.createContext=function(Vt){return Vt={$$typeof:yt,_currentValue:Vt,_currentValue2:Vt,_threadCount:0,Provider:null,Consumer:null},Vt.Provider=Vt,Vt.Consumer={$$typeof:pt,_context:Vt},Vt},react_production.createElement=function(Vt,ta,sa){var xa,ka={},$a=null;if(ta!=null)for(xa in ta.key!==void 0&&($a=""+ta.key),ta)Zt.call(ta,xa)&&xa!=="key"&&xa!=="__self"&&xa!=="__source"&&(ka[xa]=ta[xa]);var Na=arguments.length-2;if(Na===1)ka.children=sa;else if(1<Na){for(var Fa=Array(Na),qa=0;qa<Na;qa++)Fa[qa]=arguments[qa+2];ka.children=Fa}if(Vt&&Vt.defaultProps)for(xa in Na=Vt.defaultProps,Na)ka[xa]===void 0&&(ka[xa]=Na[xa]);return Yt(Vt,$a,ka)},react_production.createRef=function(){return{current:null}},react_production.forwardRef=function(Vt){return{$$typeof:ft,render:Vt}},react_production.isValidElement=Qt,react_production.lazy=function(Vt){return{$$typeof:_t,_payload:{_status:-1,_result:Vt},_init:Gt}},react_production.memo=function(Vt,ta){return{$$typeof:kt,type:Vt,compare:ta===void 0?null:ta}},react_production.startTransition=function(Vt){var ta=Ot.T,sa={};Ot.T=sa;try{var xa=Vt(),ka=Ot.S;ka!==null&&ka(sa,xa),typeof xa=="object"&&xa!==null&&typeof xa.then=="function"&&xa.then(Ht,_a)}catch($a){_a($a)}finally{ta!==null&&sa.types!==null&&(ta.types=sa.types),Ot.T=ta}},react_production.unstable_useCacheRefresh=function(){return Ot.H.useCacheRefresh()},react_production.use=function(Vt){return Ot.H.use(Vt)},react_production.useActionState=function(Vt,ta,sa){return Ot.H.useActionState(Vt,ta,sa)},react_production.useCallback=function(Vt,ta){return Ot.H.useCallback(Vt,ta)},react_production.useContext=function(Vt){return Ot.H.useContext(Vt)},react_production.useDebugValue=function(){},react_production.useDeferredValue=function(Vt,ta){return Ot.H.useDeferredValue(Vt,ta)},react_production.useEffect=function(Vt,ta){return Ot.H.useEffect(Vt,ta)},react_production.useEffectEvent=function(Vt){return Ot.H.useEffectEvent(Vt)},react_production.useId=function(){return Ot.H.useId()},react_production.useImperativeHandle=function(Vt,ta,sa){return Ot.H.useImperativeHandle(Vt,ta,sa)},react_production.useInsertionEffect=function(Vt,ta){return Ot.H.useInsertionEffect(Vt,ta)},react_production.useLayoutEffect=function(Vt,ta){return Ot.H.useLayoutEffect(Vt,ta)},react_production.useMemo=function(Vt,ta){return Ot.H.useMemo(Vt,ta)},react_production.useOptimistic=function(Vt,ta){return Ot.H.useOptimistic(Vt,ta)},react_production.useReducer=function(Vt,ta,sa){return Ot.H.useReducer(Vt,ta,sa)},react_production.useRef=function(Vt){return Ot.H.useRef(Vt)},react_production.useState=function(Vt){return Ot.H.useState(Vt)},react_production.useSyncExternalStore=function(Vt,ta,sa){return Ot.H.useSyncExternalStore(Vt,ta,sa)},react_production.useTransition=function(){return Ot.H.useTransition()},react_production.version="19.2.0",react_production}var hasRequiredReact;function requireReact(){return hasRequiredReact||(hasRequiredReact=1,react.exports=requireReact_production()),react.exports}var reactExports=requireReact();const React=getDefaultExportFromCjs(reactExports);var client={exports:{}},reactDomClient_production={},scheduler={exports:{}},scheduler_production={};var hasRequiredScheduler_production;function requireScheduler_production(){return hasRequiredScheduler_production||(hasRequiredScheduler_production=1,(function(rt){function it(Ut,ea){var Gt=Ut.length;Ut.push(ea);e:for(;0<Gt;){var _a=Gt-1>>>1,Ca=Ut[_a];if(0<ut(Ca,ea))Ut[_a]=ea,Ut[Gt]=Ca,Gt=_a;else break e}}function ct(Ut){return Ut.length===0?null:Ut[0]}function dt(Ut){if(Ut.length===0)return null;var ea=Ut[0],Gt=Ut.pop();if(Gt!==ea){Ut[0]=Gt;e:for(var _a=0,Ca=Ut.length,Vt=Ca>>>1;_a<Vt;){var ta=2*(_a+1)-1,sa=Ut[ta],xa=ta+1,ka=Ut[xa];if(0>ut(sa,Gt))xa<Ca&&0>ut(ka,sa)?(Ut[_a]=ka,Ut[xa]=Gt,_a=xa):(Ut[_a]=sa,Ut[ta]=Gt,_a=ta);else if(xa<Ca&&0>ut(ka,Gt))Ut[_a]=ka,Ut[xa]=Gt,_a=xa;else break e}}return ea}function ut(Ut,ea){var Gt=Ut.sortIndex-ea.sortIndex;return Gt!==0?Gt:Ut.id-ea.id}if(rt.unstable_now=void 0,typeof performance=="object"&&typeof performance.now=="function"){var pt=performance;rt.unstable_now=function(){return pt.now()}}else{var yt=Date,ft=yt.now();rt.unstable_now=function(){return yt.now()-ft}}var mt=[],kt=[],_t=1,vt=null,bt=3,Mt=!1,wt=!1,St=!1,It=!1,Nt=typeof setTimeout=="function"?setTimeout:null,$t=typeof clearTimeout=="function"?clearTimeout:null,Et=typeof setImmediate<"u"?setImmediate:null;function Ft(Ut){for(var ea=ct(kt);ea!==null;){if(ea.callback===null)dt(kt);else if(ea.startTime<=Ut)dt(kt),ea.sortIndex=ea.expirationTime,it(mt,ea);else break;ea=ct(kt)}}function qt(Ut){if(St=!1,Ft(Ut),!wt)if(ct(mt)!==null)wt=!0,Ht||(Ht=!0,oa());else{var ea=ct(kt);ea!==null&&ra(qt,ea.startTime-Ut)}}var Ht=!1,Ot=-1,Zt=5,Yt=-1;function aa(){return It?!0:!(rt.unstable_now()-Yt<Zt)}function Qt(){if(It=!1,Ht){var Ut=rt.unstable_now();Yt=Ut;var ea=!0;try{e:{wt=!1,St&&(St=!1,$t(Ot),Ot=-1),Mt=!0;var Gt=bt;try{t:{for(Ft(Ut),vt=ct(mt);vt!==null&&!(vt.expirationTime>Ut&&aa());){var _a=vt.callback;if(typeof _a=="function"){vt.callback=null,bt=vt.priorityLevel;var Ca=_a(vt.expirationTime<=Ut);if(Ut=rt.unstable_now(),typeof Ca=="function"){vt.callback=Ca,Ft(Ut),ea=!0;break t}vt===ct(mt)&&dt(mt),Ft(Ut)}else dt(mt);vt=ct(mt)}if(vt!==null)ea=!0;else{var Vt=ct(kt);Vt!==null&&ra(qt,Vt.startTime-Ut),ea=!1}}break e}finally{vt=null,bt=Gt,Mt=!1}ea=void 0}}finally{ea?oa():Ht=!1}}}var oa;if(typeof Et=="function")oa=function(){Et(Qt)};else if(typeof MessageChannel<"u"){var la=new MessageChannel,Kt=la.port2;la.port1.onmessage=Qt,oa=function(){Kt.postMessage(null)}}else oa=function(){Nt(Qt,0)};function ra(Ut,ea){Ot=Nt(function(){Ut(rt.unstable_now())},ea)}rt.unstable_IdlePriority=5,rt.unstable_ImmediatePriority=1,rt.unstable_LowPriority=4,rt.unstable_NormalPriority=3,rt.unstable_Profiling=null,rt.unstable_UserBlockingPriority=2,rt.unstable_cancelCallback=function(Ut){Ut.callback=null},rt.unstable_forceFrameRate=function(Ut){0>Ut||125<Ut?console.error("forceFrameRate takes a positive int between 0 and 125, forcing frame rates higher than 125 fps is not supported"):Zt=0<Ut?Math.floor(1e3/Ut):5},rt.unstable_getCurrentPriorityLevel=function(){return bt},rt.unstable_next=function(Ut){switch(bt){case 1:case 2:case 3:var ea=3;break;default:ea=bt}var Gt=bt;bt=ea;try{return Ut()}finally{bt=Gt}},rt.unstable_requestPaint=function(){It=!0},rt.unstable_runWithPriority=function(Ut,ea){switch(Ut){case 1:case 2:case 3:case 4:case 5:break;default:Ut=3}var Gt=bt;bt=Ut;try{return ea()}finally{bt=Gt}},rt.unstable_scheduleCallback=function(Ut,ea,Gt){var _a=rt.unstable_now();switch(typeof Gt=="object"&&Gt!==null?(Gt=Gt.delay,Gt=typeof Gt=="number"&&0<Gt?_a+Gt:_a):Gt=_a,Ut){case 1:var Ca=-1;break;case 2:Ca=250;break;case 5:Ca=1073741823;break;case 4:Ca=1e4;break;default:Ca=5e3}return Ca=Gt+Ca,Ut={id:_t++,callback:ea,priorityLevel:Ut,startTime:Gt,expirationTime:Ca,sortIndex:-1},Gt>_a?(Ut.sortIndex=Gt,it(kt,Ut),ct(mt)===null&&Ut===ct(kt)&&(St?($t(Ot),Ot=-1):St=!0,ra(qt,Gt-_a))):(Ut.sortIndex=Ca,it(mt,Ut),wt||Mt||(wt=!0,Ht||(Ht=!0,oa()))),Ut},rt.unstable_shouldYield=aa,rt.unstable_wrapCallback=function(Ut){var ea=bt;return function(){var Gt=bt;bt=ea;try{return Ut.apply(this,arguments)}finally{bt=Gt}}}})(scheduler_production)),scheduler_production}var hasRequiredScheduler;function requireScheduler(){return hasRequiredScheduler||(hasRequiredScheduler=1,scheduler.exports=requireScheduler_production()),scheduler.exports}var reactDom={exports:{}},reactDom_production={};var hasRequiredReactDom_production;function requireReactDom_production(){if(hasRequiredReactDom_production)return reactDom_production;hasRequiredReactDom_production=1;var rt=requireReact();function it(mt){var kt="https://react.dev/errors/"+mt;if(1<arguments.length){kt+="?args[]="+encodeURIComponent(arguments[1]);for(var _t=2;_t<arguments.length;_t++)kt+="&args[]="+encodeURIComponent(arguments[_t])}return"Minified React error #"+mt+"; visit "+kt+" for the full message or use the non-minified dev environment for full errors and additional helpful warnings."}function ct(){}var dt={d:{f:ct,r:function(){throw Error(it(522))},D:ct,C:ct,L:ct,m:ct,X:ct,S:ct,M:ct},p:0,findDOMNode:null},ut=Symbol.for("react.portal");function pt(mt,kt,_t){var vt=3<arguments.length&&arguments[3]!==void 0?arguments[3]:null;return{$$typeof:ut,key:vt==null?null:""+vt,children:mt,containerInfo:kt,implementation:_t}}var yt=rt.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE;function ft(mt,kt){if(mt==="font")return"";if(typeof kt=="string")return kt==="use-credentials"?kt:""}return reactDom_production.__DOM_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE=dt,reactDom_production.createPortal=function(mt,kt){var _t=2<arguments.length&&arguments[2]!==void 0?arguments[2]:null;if(!kt||kt.nodeType!==1&&kt.nodeType!==9&&kt.nodeType!==11)throw Error(it(299));return pt(mt,kt,null,_t)},reactDom_production.flushSync=function(mt){var kt=yt.T,_t=dt.p;try{if(yt.T=null,dt.p=2,mt)return mt()}finally{yt.T=kt,dt.p=_t,dt.d.f()}},reactDom_production.preconnect=function(mt,kt){typeof mt=="string"&&(kt?(kt=kt.crossOrigin,kt=typeof kt=="string"?kt==="use-credentials"?kt:"":void 0):kt=null,dt.d.C(mt,kt))},reactDom_production.prefetchDNS=function(mt){typeof mt=="string"&&dt.d.D(mt)},reactDom_production.preinit=function(mt,kt){if(typeof mt=="string"&&kt&&typeof kt.as=="string"){var _t=kt.as,vt=ft(_t,kt.crossOrigin),bt=typeof kt.integrity=="string"?kt.integrity:void 0,Mt=typeof kt.fetchPriority=="string"?kt.fetchPriority:void 0;_t==="style"?dt.d.S(mt,typeof kt.precedence=="string"?kt.precedence:void 0,{crossOrigin:vt,integrity:bt,fetchPriority:Mt}):_t==="script"&&dt.d.X(mt,{crossOrigin:vt,integrity:bt,fetchPriority:Mt,nonce:typeof kt.nonce=="string"?kt.nonce:void 0})}},reactDom_production.preinitModule=function(mt,kt){if(typeof mt=="string")if(typeof kt=="object"&&kt!==null){if(kt.as==null||kt.as==="script"){var _t=ft(kt.as,kt.crossOrigin);dt.d.M(mt,{crossOrigin:_t,integrity:typeof kt.integrity=="string"?kt.integrity:void 0,nonce:typeof kt.nonce=="string"?kt.nonce:void 0})}}else kt==null&&dt.d.M(mt)},reactDom_production.preload=function(mt,kt){if(typeof mt=="string"&&typeof kt=="object"&&kt!==null&&typeof kt.as=="string"){var _t=kt.as,vt=ft(_t,kt.crossOrigin);dt.d.L(mt,_t,{crossOrigin:vt,integrity:typeof kt.integrity=="string"?kt.integrity:void 0,nonce:typeof kt.nonce=="string"?kt.nonce:void 0,type:typeof kt.type=="string"?kt.type:void 0,fetchPriority:typeof kt.fetchPriority=="string"?kt.fetchPriority:void 0,referrerPolicy:typeof kt.referrerPolicy=="string"?kt.referrerPolicy:void 0,imageSrcSet:typeof kt.imageSrcSet=="string"?kt.imageSrcSet:void 0,imageSizes:typeof kt.imageSizes=="string"?kt.imageSizes:void 0,media:typeof kt.media=="string"?kt.media:void 0})}},reactDom_production.preloadModule=function(mt,kt){if(typeof mt=="string")if(kt){var _t=ft(kt.as,kt.crossOrigin);dt.d.m(mt,{as:typeof kt.as=="string"&&kt.as!=="script"?kt.as:void 0,crossOrigin:_t,integrity:typeof kt.integrity=="string"?kt.integrity:void 0})}else dt.d.m(mt)},reactDom_production.requestFormReset=function(mt){dt.d.r(mt)},reactDom_production.unstable_batchedUpdates=function(mt,kt){return mt(kt)},reactDom_production.useFormState=function(mt,kt,_t){return yt.H.useFormState(mt,kt,_t)},reactDom_production.useFormStatus=function(){return yt.H.useHostTransitionStatus()},reactDom_production.version="19.2.0",reactDom_production}var hasRequiredReactDom;function requireReactDom(){if(hasRequiredReactDom)return reactDom.exports;hasRequiredReactDom=1;function rt(){if(!(typeof __REACT_DEVTOOLS_GLOBAL_HOOK__>"u"||typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE!="function"))try{__REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE(rt)}catch(it){console.error(it)}}return rt(),reactDom.exports=requireReactDom_production(),reactDom.exports}var hasRequiredReactDomClient_production;function requireReactDomClient_production(){if(hasRequiredReactDomClient_production)return reactDomClient_production;hasRequiredReactDomClient_production=1;var rt=requireScheduler(),it=requireReact(),ct=requireReactDom();function dt(lt){var ht="https://react.dev/errors/"+lt;if(1<arguments.length){ht+="?args[]="+encodeURIComponent(arguments[1]);for(var gt=2;gt<arguments.length;gt++)ht+="&args[]="+encodeURIComponent(arguments[gt])}return"Minified React error #"+lt+"; visit "+ht+" for the full message or use the non-minified dev environment for full errors and additional helpful warnings."}function ut(lt){return!(!lt||lt.nodeType!==1&&lt.nodeType!==9&&lt.nodeType!==11)}function pt(lt){var ht=lt,gt=lt;if(lt.alternate)for(;ht.return;)ht=ht.return;else{lt=ht;do ht=lt,(ht.flags&4098)!==0&&(gt=ht.return),lt=ht.return;while(lt)}return ht.tag===3?gt:null}function yt(lt){if(lt.tag===13){var ht=lt.memoizedState;if(ht===null&&(lt=lt.alternate,lt!==null&&(ht=lt.memoizedState)),ht!==null)return ht.dehydrated}return null}function ft(lt){if(lt.tag===31){var ht=lt.memoizedState;if(ht===null&&(lt=lt.alternate,lt!==null&&(ht=lt.memoizedState)),ht!==null)return ht.dehydrated}return null}function mt(lt){if(pt(lt)!==lt)throw Error(dt(188))}function kt(lt){var ht=lt.alternate;if(!ht){if(ht=pt(lt),ht===null)throw Error(dt(188));return ht!==lt?null:lt}for(var gt=lt,xt=ht;;){var Ct=gt.return;if(Ct===null)break;var Lt=Ct.alternate;if(Lt===null){if(xt=Ct.return,xt!==null){gt=xt;continue}break}if(Ct.child===Lt.child){for(Lt=Ct.child;Lt;){if(Lt===gt)return mt(Ct),lt;if(Lt===xt)return mt(Ct),ht;Lt=Lt.sibling}throw Error(dt(188))}if(gt.return!==xt.return)gt=Ct,xt=Lt;else{for(var Dt=!1,zt=Ct.child;zt;){if(zt===gt){Dt=!0,gt=Ct,xt=Lt;break}if(zt===xt){Dt=!0,xt=Ct,gt=Lt;break}zt=zt.sibling}if(!Dt){for(zt=Lt.child;zt;){if(zt===gt){Dt=!0,gt=Lt,xt=Ct;break}if(zt===xt){Dt=!0,xt=Lt,gt=Ct;break}zt=zt.sibling}if(!Dt)throw Error(dt(189))}}if(gt.alternate!==xt)throw Error(dt(190))}if(gt.tag!==3)throw Error(dt(188));return gt.stateNode.current===gt?lt:ht}function _t(lt){var ht=lt.tag;if(ht===5||ht===26||ht===27||ht===6)return lt;for(lt=lt.child;lt!==null;){if(ht=_t(lt),ht!==null)return ht;lt=lt.sibling}return null}var vt=Object.assign,bt=Symbol.for("react.element"),Mt=Symbol.for("react.transitional.element"),wt=Symbol.for("react.portal"),St=Symbol.for("react.fragment"),It=Symbol.for("react.strict_mode"),Nt=Symbol.for("react.profiler"),$t=Symbol.for("react.consumer"),Et=Symbol.for("react.context"),Ft=Symbol.for("react.forward_ref"),qt=Symbol.for("react.suspense"),Ht=Symbol.for("react.suspense_list"),Ot=Symbol.for("react.memo"),Zt=Symbol.for("react.lazy"),Yt=Symbol.for("react.activity"),aa=Symbol.for("react.memo_cache_sentinel"),Qt=Symbol.iterator;function oa(lt){return lt===null||typeof lt!="object"?null:(lt=Qt&&lt[Qt]||lt["@@iterator"],typeof lt=="function"?lt:null)}var la=Symbol.for("react.client.reference");function Kt(lt){if(lt==null)return null;if(typeof lt=="function")return lt.$$typeof===la?null:lt.displayName||lt.name||null;if(typeof lt=="string")return lt;switch(lt){case St:return"Fragment";case Nt:return"Profiler";case It:return"StrictMode";case qt:return"Suspense";case Ht:return"SuspenseList";case Yt:return"Activity"}if(typeof lt=="object")switch(lt.$$typeof){case wt:return"Portal";case Et:return lt.displayName||"Context";case $t:return(lt._context.displayName||"Context")+".Consumer";case Ft:var ht=lt.render;return lt=lt.displayName,lt||(lt=ht.displayName||ht.name||"",lt=lt!==""?"ForwardRef("+lt+")":"ForwardRef"),lt;case Ot:return ht=lt.displayName||null,ht!==null?ht:Kt(lt.type)||"Memo";case Zt:ht=lt._payload,lt=lt._init;try{return Kt(lt(ht))}catch{}}return null}var ra=Array.isArray,Ut=it.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,ea=ct.__DOM_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,Gt={pending:!1,data:null,method:null,action:null},_a=[],Ca=-1;function Vt(lt){return{current:lt}}function ta(lt){0>Ca||(lt.current=_a[Ca],_a[Ca]=null,Ca--)}function sa(lt,ht){Ca++,_a[Ca]=lt.current,lt.current=ht}var xa=Vt(null),ka=Vt(null),$a=Vt(null),Na=Vt(null);function Fa(lt,ht){switch(sa($a,ht),sa(ka,lt),sa(xa,null),ht.nodeType){case 9:case 11:lt=(lt=ht.documentElement)&&(lt=lt.namespaceURI)?o0(lt):0;break;default:if(lt=ht.tagName,ht=ht.namespaceURI)ht=o0(ht),lt=c0(ht,lt);else switch(lt){case"svg":lt=1;break;case"math":lt=2;break;default:lt=0}}ta(xa),sa(xa,lt)}function qa(){ta(xa),ta(ka),ta($a)}function Ha(lt){lt.memoizedState!==null&&sa(Na,lt);var ht=xa.current,gt=c0(ht,lt.type);ht!==gt&&(sa(ka,lt),sa(xa,gt))}function rn(lt){ka.current===lt&&(ta(xa),ta(ka)),Na.current===lt&&(ta(Na),vc._currentValue=Gt)}var hn,Ja;function kn(lt){if(hn===void 0)try{throw Error()}catch(gt){var ht=gt.stack.trim().match(/\n( *(at )?)/);hn=ht&&ht[1]||"",Ja=-1<gt.stack.indexOf(`
-    at`)?" (<anonymous>)":-1<gt.stack.indexOf("@")?"@unknown:0:0":""}return`
-`+hn+lt+Ja}var En=!1;function Hn(lt,ht){if(!lt||En)return"";En=!0;var gt=Error.prepareStackTrace;Error.prepareStackTrace=void 0;try{var xt={DetermineComponentFrameRoot:function(){try{if(ht){var wa=function(){throw Error()};if(Object.defineProperty(wa.prototype,"props",{set:function(){throw Error()}}),typeof Reflect=="object"&&Reflect.construct){try{Reflect.construct(wa,[])}catch(ga){var ya=ga}Reflect.construct(lt,[],wa)}else{try{wa.call()}catch(ga){ya=ga}lt.call(wa.prototype)}}else{try{throw Error()}catch(ga){ya=ga}(wa=lt())&&typeof wa.catch=="function"&&wa.catch(function(){})}}catch(ga){if(ga&&ya&&typeof ga.stack=="string")return[ga.stack,ya.stack]}return[null,null]}};xt.DetermineComponentFrameRoot.displayName="DetermineComponentFrameRoot";var Ct=Object.getOwnPropertyDescriptor(xt.DetermineComponentFrameRoot,"name");Ct&&Ct.configurable&&Object.defineProperty(xt.DetermineComponentFrameRoot,"name",{value:"DetermineComponentFrameRoot"});var Lt=xt.DetermineComponentFrameRoot(),Dt=Lt[0],zt=Lt[1];if(Dt&&zt){var Jt=Dt.split(`
-`),ha=zt.split(`
-`);for(Ct=xt=0;xt<Jt.length&&!Jt[xt].includes("DetermineComponentFrameRoot");)xt++;for(;Ct<ha.length&&!ha[Ct].includes("DetermineComponentFrameRoot");)Ct++;if(xt===Jt.length||Ct===ha.length)for(xt=Jt.length-1,Ct=ha.length-1;1<=xt&&0<=Ct&&Jt[xt]!==ha[Ct];)Ct--;for(;1<=xt&&0<=Ct;xt--,Ct--)if(Jt[xt]!==ha[Ct]){if(xt!==1||Ct!==1)do if(xt--,Ct--,0>Ct||Jt[xt]!==ha[Ct]){var va=`
-`+Jt[xt].replace(" at new "," at ");return lt.displayName&&va.includes("<anonymous>")&&(va=va.replace("<anonymous>",lt.displayName)),va}while(1<=xt&&0<=Ct);break}}}finally{En=!1,Error.prepareStackTrace=gt}return(gt=lt?lt.displayName||lt.name:"")?kn(gt):""}function Jn(lt,ht){switch(lt.tag){case 26:case 27:case 5:return kn(lt.type);case 16:return kn("Lazy");case 13:return lt.child!==ht&&ht!==null?kn("Suspense Fallback"):kn("Suspense");case 19:return kn("SuspenseList");case 0:case 15:return Hn(lt.type,!1);case 11:return Hn(lt.type.render,!1);case 1:return Hn(lt.type,!0);case 31:return kn("Activity");default:return""}}function vn(lt){try{var ht="",gt=null;do ht+=Jn(lt,gt),gt=lt,lt=lt.return;while(lt);return ht}catch(xt){return`
-Error generating stack: `+xt.message+`
-`+xt.stack}}var Un=Object.prototype.hasOwnProperty,jn=rt.unstable_scheduleCallback,On=rt.unstable_cancelCallback,Mn=rt.unstable_shouldYield,vi=rt.unstable_requestPaint,pn=rt.unstable_now,Tt=rt.unstable_getCurrentPriorityLevel,fa=rt.unstable_ImmediatePriority,Pt=rt.unstable_UserBlockingPriority,At=rt.unstable_NormalPriority,Rt=rt.unstable_LowPriority,Bt=rt.unstable_IdlePriority,jt=rt.log,Wt=rt.unstable_setDisableYieldValue,Xt=null,da=null;function ma(lt){if(typeof jt=="function"&&Wt(lt),da&&typeof da.setStrictMode=="function")try{da.setStrictMode(Xt,lt)}catch{}}var pa=Math.clz32?Math.clz32:Ra,La=Math.log,ba=Math.LN2;function Ra(lt){return lt>>>=0,lt===0?32:31-(La(lt)/ba|0)|0}var ja=256,Pa=262144,gn=4194304;function ei(lt){var ht=lt&42;if(ht!==0)return ht;switch(lt&-lt){case 1:return 1;case 2:return 2;case 4:return 4;case 8:return 8;case 16:return 16;case 32:return 32;case 64:return 64;case 128:return 128;case 256:case 512:case 1024:case 2048:case 4096:case 8192:case 16384:case 32768:case 65536:case 131072:return lt&261888;case 262144:case 524288:case 1048576:case 2097152:return lt&3932160;case 4194304:case 8388608:case 16777216:case 33554432:return lt&62914560;case 67108864:return 67108864;case 134217728:return 134217728;case 268435456:return 268435456;case 536870912:return 536870912;case 1073741824:return 0;default:return lt}}function jr(lt,ht,gt){var xt=lt.pendingLanes;if(xt===0)return 0;var Ct=0,Lt=lt.suspendedLanes,Dt=lt.pingedLanes;lt=lt.warmLanes;var zt=xt&134217727;return zt!==0?(xt=zt&~Lt,xt!==0?Ct=ei(xt):(Dt&=zt,Dt!==0?Ct=ei(Dt):gt||(gt=zt&~lt,gt!==0&&(Ct=ei(gt))))):(zt=xt&~Lt,zt!==0?Ct=ei(zt):Dt!==0?Ct=ei(Dt):gt||(gt=xt&~lt,gt!==0&&(Ct=ei(gt)))),Ct===0?0:ht!==0&&ht!==Ct&&(ht&Lt)===0&&(Lt=Ct&-Ct,gt=ht&-ht,Lt>=gt||Lt===32&&(gt&4194048)!==0)?ht:Ct}function br(lt,ht){return(lt.pendingLanes&~(lt.suspendedLanes&~lt.pingedLanes)&ht)===0}function wn(lt,ht){switch(lt){case 1:case 2:case 4:case 8:case 64:return ht+250;case 16:case 32:case 128:case 256:case 512:case 1024:case 2048:case 4096:case 8192:case 16384:case 32768:case 65536:case 131072:case 262144:case 524288:case 1048576:case 2097152:return ht+5e3;case 4194304:case 8388608:case 16777216:case 33554432:return-1;case 67108864:case 134217728:case 268435456:case 536870912:case 1073741824:return-1;default:return-1}}function Ai(){var lt=gn;return gn<<=1,(gn&62914560)===0&&(gn=4194304),lt}function Io(lt){for(var ht=[],gt=0;31>gt;gt++)ht.push(lt);return ht}function Qi(lt,ht){lt.pendingLanes|=ht,ht!==268435456&&(lt.suspendedLanes=0,lt.pingedLanes=0,lt.warmLanes=0)}function Ao(lt,ht,gt,xt,Ct,Lt){var Dt=lt.pendingLanes;lt.pendingLanes=gt,lt.suspendedLanes=0,lt.pingedLanes=0,lt.warmLanes=0,lt.expiredLanes&=gt,lt.entangledLanes&=gt,lt.errorRecoveryDisabledLanes&=gt,lt.shellSuspendCounter=0;var zt=lt.entanglements,Jt=lt.expirationTimes,ha=lt.hiddenUpdates;for(gt=Dt&~gt;0<gt;){var va=31-pa(gt),wa=1<<va;zt[va]=0,Jt[va]=-1;var ya=ha[va];if(ya!==null)for(ha[va]=null,va=0;va<ya.length;va++){var ga=ya[va];ga!==null&&(ga.lane&=-536870913)}gt&=~wa}xt!==0&&To(lt,xt,0),Lt!==0&&Ct===0&&lt.tag!==0&&(lt.suspendedLanes|=Lt&~(Dt&~ht))}function To(lt,ht,gt){lt.pendingLanes|=ht,lt.suspendedLanes&=~ht;var xt=31-pa(ht);lt.entangledLanes|=ht,lt.entanglements[xt]=lt.entanglements[xt]|1073741824|gt&261930}function Eo(lt,ht){var gt=lt.entangledLanes|=ht;for(lt=lt.entanglements;gt;){var xt=31-pa(gt),Ct=1<<xt;Ct&ht|lt[xt]&ht&&(lt[xt]|=ht),gt&=~Ct}}function wc(lt,ht){var gt=ht&-ht;return gt=(gt&42)!==0?1:Vn(gt),(gt&(lt.suspendedLanes|ht))!==0?0:gt}function Vn(lt){switch(lt){case 2:lt=1;break;case 8:lt=4;break;case 32:lt=16;break;case 256:case 512:case 1024:case 2048:case 4096:case 8192:case 16384:case 32768:case 65536:case 131072:case 262144:case 524288:case 1048576:case 2097152:case 4194304:case 8388608:case 16777216:case 33554432:lt=128;break;case 268435456:lt=134217728;break;default:lt=0}return lt}function bi(lt){return lt&=-lt,2<lt?8<lt?(lt&134217727)!==0?32:268435456:8:2}function Ro(){var lt=ea.p;return lt!==0?lt:(lt=window.event,lt===void 0?32:I0(lt.type))}function Bo(lt,ht){var gt=ea.p;try{return ea.p=lt,ht()}finally{ea.p=gt}}var si=Math.random().toString(36).slice(2),Ln="__reactFiber$"+si,fn="__reactProps$"+si,Ti="__reactContainer$"+si,Or="__reactEvents$"+si,Lc="__reactListeners$"+si,Sc="__reactHandles$"+si,$c="__reactResources$"+si,Ta="__reactMarker$"+si;function na(lt){delete lt[Ln],delete lt[fn],delete lt[Or],delete lt[Lc],delete lt[Sc]}function Sa(lt){var ht=lt[Ln];if(ht)return ht;for(var gt=lt.parentNode;gt;){if(ht=gt[Ti]||gt[Ln]){if(gt=ht.alternate,ht.child!==null||gt!==null&&gt.child!==null)for(lt=f0(lt);lt!==null;){if(gt=lt[Ln])return gt;lt=f0(lt)}return ht}lt=gt,gt=lt.parentNode}return null}function Ia(lt){if(lt=lt[Ln]||lt[Ti]){var ht=lt.tag;if(ht===5||ht===6||ht===13||ht===31||ht===26||ht===27||ht===3)return lt}return null}function tn(lt){var ht=lt.tag;if(ht===5||ht===26||ht===27||ht===6)return lt.stateNode;throw Error(dt(33))}function mn(lt){var ht=lt[$c];return ht||(ht=lt[$c]={hoistableStyles:new Map,hoistableScripts:new Map}),ht}function Ua(lt){lt[Ta]=!0}var Bn=new Set,li={};function Gn(lt,ht){Li(lt,ht),Li(lt+"Capture",ht)}function Li(lt,ht){for(li[lt]=ht,lt=0;lt<ht.length;lt++)Bn.add(ht[lt])}var An=RegExp("^[:A-Z_a-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][:A-Z_a-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$"),Do={},Po={};function P0(lt){return Un.call(Po,lt)?!0:Un.call(Do,lt)?!1:An.test(lt)?Po[lt]=!0:(Do[lt]=!0,!1)}function Nc(lt,ht,gt){if(P0(ht))if(gt===null)lt.removeAttribute(ht);else{switch(typeof gt){case"undefined":case"function":case"symbol":lt.removeAttribute(ht);return;case"boolean":var xt=ht.toLowerCase().slice(0,5);if(xt!=="data-"&&xt!=="aria-"){lt.removeAttribute(ht);return}}lt.setAttribute(ht,""+gt)}}function Ic(lt,ht,gt){if(gt===null)lt.removeAttribute(ht);else{switch(typeof gt){case"undefined":case"function":case"symbol":case"boolean":lt.removeAttribute(ht);return}lt.setAttribute(ht,""+gt)}}function Ei(lt,ht,gt,xt){if(xt===null)lt.removeAttribute(gt);else{switch(typeof xt){case"undefined":case"function":case"symbol":case"boolean":lt.removeAttribute(gt);return}lt.setAttributeNS(ht,gt,""+xt)}}function di(lt){switch(typeof lt){case"bigint":case"boolean":case"number":case"string":case"undefined":return lt;case"object":return lt;default:return""}}function Z1(lt){var ht=lt.type;return(lt=lt.nodeName)&&lt.toLowerCase()==="input"&&(ht==="checkbox"||ht==="radio")}function F0(lt,ht,gt){var xt=Object.getOwnPropertyDescriptor(lt.constructor.prototype,ht);if(!lt.hasOwnProperty(ht)&&typeof xt<"u"&&typeof xt.get=="function"&&typeof xt.set=="function"){var Ct=xt.get,Lt=xt.set;return Object.defineProperty(lt,ht,{configurable:!0,get:function(){return Ct.call(this)},set:function(Dt){gt=""+Dt,Lt.call(this,Dt)}}),Object.defineProperty(lt,ht,{enumerable:xt.enumerable}),{getValue:function(){return gt},setValue:function(Dt){gt=""+Dt},stopTracking:function(){lt._valueTracker=null,delete lt[ht]}}}}function Os(lt){if(!lt._valueTracker){var ht=Z1(lt)?"checked":"value";lt._valueTracker=F0(lt,ht,""+lt[ht])}}function K1(lt){if(!lt)return!1;var ht=lt._valueTracker;if(!ht)return!0;var gt=ht.getValue(),xt="";return lt&&(xt=Z1(lt)?lt.checked?"true":"false":lt.value),lt=xt,lt!==gt?(ht.setValue(lt),!0):!1}function Ac(lt){if(lt=lt||(typeof document<"u"?document:void 0),typeof lt>"u")return null;try{return lt.activeElement||lt.body}catch{return lt.body}}var q0=/[\n"\\]/g;function ui(lt){return lt.replace(q0,function(ht){return"\\"+ht.charCodeAt(0).toString(16)+" "})}function zs(lt,ht,gt,xt,Ct,Lt,Dt,zt){lt.name="",Dt!=null&&typeof Dt!="function"&&typeof Dt!="symbol"&&typeof Dt!="boolean"?lt.type=Dt:lt.removeAttribute("type"),ht!=null?Dt==="number"?(ht===0&&lt.value===""||lt.value!=ht)&&(lt.value=""+di(ht)):lt.value!==""+di(ht)&&(lt.value=""+di(ht)):Dt!=="submit"&&Dt!=="reset"||lt.removeAttribute("value"),ht!=null?Hs(lt,Dt,di(ht)):gt!=null?Hs(lt,Dt,di(gt)):xt!=null&&lt.removeAttribute("value"),Ct==null&&Lt!=null&&(lt.defaultChecked=!!Lt),Ct!=null&&(lt.checked=Ct&&typeof Ct!="function"&&typeof Ct!="symbol"),zt!=null&&typeof zt!="function"&&typeof zt!="symbol"&&typeof zt!="boolean"?lt.name=""+di(zt):lt.removeAttribute("name")}function Q1(lt,ht,gt,xt,Ct,Lt,Dt,zt){if(Lt!=null&&typeof Lt!="function"&&typeof Lt!="symbol"&&typeof Lt!="boolean"&&(lt.type=Lt),ht!=null||gt!=null){if(!(Lt!=="submit"&&Lt!=="reset"||ht!=null)){Os(lt);return}gt=gt!=null?""+di(gt):"",ht=ht!=null?""+di(ht):gt,zt||ht===lt.value||(lt.value=ht),lt.defaultValue=ht}xt=xt??Ct,xt=typeof xt!="function"&&typeof xt!="symbol"&&!!xt,lt.checked=zt?lt.checked:!!xt,lt.defaultChecked=!!xt,Dt!=null&&typeof Dt!="function"&&typeof Dt!="symbol"&&typeof Dt!="boolean"&&(lt.name=Dt),Os(lt)}function Hs(lt,ht,gt){ht==="number"&&Ac(lt.ownerDocument)===lt||lt.defaultValue===""+gt||(lt.defaultValue=""+gt)}function zr(lt,ht,gt,xt){if(lt=lt.options,ht){ht={};for(var Ct=0;Ct<gt.length;Ct++)ht["$"+gt[Ct]]=!0;for(gt=0;gt<lt.length;gt++)Ct=ht.hasOwnProperty("$"+lt[gt].value),lt[gt].selected!==Ct&&(lt[gt].selected=Ct),Ct&&xt&&(lt[gt].defaultSelected=!0)}else{for(gt=""+di(gt),ht=null,Ct=0;Ct<lt.length;Ct++){if(lt[Ct].value===gt){lt[Ct].selected=!0,xt&&(lt[Ct].defaultSelected=!0);return}ht!==null||lt[Ct].disabled||(ht=lt[Ct])}ht!==null&&(ht.selected=!0)}}function J1(lt,ht,gt){if(ht!=null&&(ht=""+di(ht),ht!==lt.value&&(lt.value=ht),gt==null)){lt.defaultValue!==ht&&(lt.defaultValue=ht);return}lt.defaultValue=gt!=null?""+di(gt):""}function ed(lt,ht,gt,xt){if(ht==null){if(xt!=null){if(gt!=null)throw Error(dt(92));if(ra(xt)){if(1<xt.length)throw Error(dt(93));xt=xt[0]}gt=xt}gt==null&&(gt=""),ht=gt}gt=di(ht),lt.defaultValue=gt,xt=lt.textContent,xt===gt&&xt!==""&&xt!==null&&(lt.value=xt),Os(lt)}function Hr(lt,ht){if(ht){var gt=lt.firstChild;if(gt&&gt===lt.lastChild&&gt.nodeType===3){gt.nodeValue=ht;return}}lt.textContent=ht}var j0=new Set("animationIterationCount aspectRatio borderImageOutset borderImageSlice borderImageWidth boxFlex boxFlexGroup boxOrdinalGroup columnCount columns flex flexGrow flexPositive flexShrink flexNegative flexOrder gridArea gridRow gridRowEnd gridRowSpan gridRowStart gridColumn gridColumnEnd gridColumnSpan gridColumnStart fontWeight lineClamp lineHeight opacity order orphans scale tabSize widows zIndex zoom fillOpacity floodOpacity stopOpacity strokeDasharray strokeDashoffset strokeMiterlimit strokeOpacity strokeWidth MozAnimationIterationCount MozBoxFlex MozBoxFlexGroup MozLineClamp msAnimationIterationCount msFlex msZoom msFlexGrow msFlexNegative msFlexOrder msFlexPositive msFlexShrink msGridColumn msGridColumnSpan msGridRow msGridRowSpan WebkitAnimationIterationCount WebkitBoxFlex WebKitBoxFlexGroup WebkitBoxOrdinalGroup WebkitColumnCount WebkitColumns WebkitFlex WebkitFlexGrow WebkitFlexPositive WebkitFlexShrink WebkitLineClamp".split(" "));function td(lt,ht,gt){var xt=ht.indexOf("--")===0;gt==null||typeof gt=="boolean"||gt===""?xt?lt.setProperty(ht,""):ht==="float"?lt.cssFloat="":lt[ht]="":xt?lt.setProperty(ht,gt):typeof gt!="number"||gt===0||j0.has(ht)?ht==="float"?lt.cssFloat=gt:lt[ht]=(""+gt).trim():lt[ht]=gt+"px"}function ad(lt,ht,gt){if(ht!=null&&typeof ht!="object")throw Error(dt(62));if(lt=lt.style,gt!=null){for(var xt in gt)!gt.hasOwnProperty(xt)||ht!=null&&ht.hasOwnProperty(xt)||(xt.indexOf("--")===0?lt.setProperty(xt,""):xt==="float"?lt.cssFloat="":lt[xt]="");for(var Ct in ht)xt=ht[Ct],ht.hasOwnProperty(Ct)&&gt[Ct]!==xt&&td(lt,Ct,xt)}else for(var Lt in ht)ht.hasOwnProperty(Lt)&&td(lt,Lt,ht[Lt])}function Us(lt){if(lt.indexOf("-")===-1)return!1;switch(lt){case"annotation-xml":case"color-profile":case"font-face":case"font-face-src":case"font-face-uri":case"font-face-format":case"font-face-name":case"missing-glyph":return!1;default:return!0}}var O0=new Map([["acceptCharset","accept-charset"],["htmlFor","for"],["httpEquiv","http-equiv"],["crossOrigin","crossorigin"],["accentHeight","accent-height"],["alignmentBaseline","alignment-baseline"],["arabicForm","arabic-form"],["baselineShift","baseline-shift"],["capHeight","cap-height"],["clipPath","clip-path"],["clipRule","clip-rule"],["colorInterpolation","color-interpolation"],["colorInterpolationFilters","color-interpolation-filters"],["colorProfile","color-profile"],["colorRendering","color-rendering"],["dominantBaseline","dominant-baseline"],["enableBackground","enable-background"],["fillOpacity","fill-opacity"],["fillRule","fill-rule"],["floodColor","flood-color"],["floodOpacity","flood-opacity"],["fontFamily","font-family"],["fontSize","font-size"],["fontSizeAdjust","font-size-adjust"],["fontStretch","font-stretch"],["fontStyle","font-style"],["fontVariant","font-variant"],["fontWeight","font-weight"],["glyphName","glyph-name"],["glyphOrientationHorizontal","glyph-orientation-horizontal"],["glyphOrientationVertical","glyph-orientation-vertical"],["horizAdvX","horiz-adv-x"],["horizOriginX","horiz-origin-x"],["imageRendering","image-rendering"],["letterSpacing","letter-spacing"],["lightingColor","lighting-color"],["markerEnd","marker-end"],["markerMid","marker-mid"],["markerStart","marker-start"],["overlinePosition","overline-position"],["overlineThickness","overline-thickness"],["paintOrder","paint-order"],["panose-1","panose-1"],["pointerEvents","pointer-events"],["renderingIntent","rendering-intent"],["shapeRendering","shape-rendering"],["stopColor","stop-color"],["stopOpacity","stop-opacity"],["strikethroughPosition","strikethrough-position"],["strikethroughThickness","strikethrough-thickness"],["strokeDasharray","stroke-dasharray"],["strokeDashoffset","stroke-dashoffset"],["strokeLinecap","stroke-linecap"],["strokeLinejoin","stroke-linejoin"],["strokeMiterlimit","stroke-miterlimit"],["strokeOpacity","stroke-opacity"],["strokeWidth","stroke-width"],["textAnchor","text-anchor"],["textDecoration","text-decoration"],["textRendering","text-rendering"],["transformOrigin","transform-origin"],["underlinePosition","underline-position"],["underlineThickness","underline-thickness"],["unicodeBidi","unicode-bidi"],["unicodeRange","unicode-range"],["unitsPerEm","units-per-em"],["vAlphabetic","v-alphabetic"],["vHanging","v-hanging"],["vIdeographic","v-ideographic"],["vMathematical","v-mathematical"],["vectorEffect","vector-effect"],["vertAdvY","vert-adv-y"],["vertOriginX","vert-origin-x"],["vertOriginY","vert-origin-y"],["wordSpacing","word-spacing"],["writingMode","writing-mode"],["xmlnsXlink","xmlns:xlink"],["xHeight","x-height"]]),z0=/^[\u0000-\u001F ]*j[\r\n\t]*a[\r\n\t]*v[\r\n\t]*a[\r\n\t]*s[\r\n\t]*c[\r\n\t]*r[\r\n\t]*i[\r\n\t]*p[\r\n\t]*t[\r\n\t]*:/i;function Tc(lt){return z0.test(""+lt)?"javascript:throw new Error('React has blocked a javascript: URL as a security precaution.')":lt}function Ri(){}var Vs=null;function Gs(lt){return lt=lt.target||lt.srcElement||window,lt.correspondingUseElement&&(lt=lt.correspondingUseElement),lt.nodeType===3?lt.parentNode:lt}var Ur=null,Vr=null;function nd(lt){var ht=Ia(lt);if(ht&&(lt=ht.stateNode)){var gt=lt[fn]||null;e:switch(lt=ht.stateNode,ht.type){case"input":if(zs(lt,gt.value,gt.defaultValue,gt.defaultValue,gt.checked,gt.defaultChecked,gt.type,gt.name),ht=gt.name,gt.type==="radio"&&ht!=null){for(gt=lt;gt.parentNode;)gt=gt.parentNode;for(gt=gt.querySelectorAll('input[name="'+ui(""+ht)+'"][type="radio"]'),ht=0;ht<gt.length;ht++){var xt=gt[ht];if(xt!==lt&&xt.form===lt.form){var Ct=xt[fn]||null;if(!Ct)throw Error(dt(90));zs(xt,Ct.value,Ct.defaultValue,Ct.defaultValue,Ct.checked,Ct.defaultChecked,Ct.type,Ct.name)}}for(ht=0;ht<gt.length;ht++)xt=gt[ht],xt.form===lt.form&&K1(xt)}break e;case"textarea":J1(lt,gt.value,gt.defaultValue);break e;case"select":ht=gt.value,ht!=null&&zr(lt,!!gt.multiple,ht,!1)}}}var Ws=!1;function rd(lt,ht,gt){if(Ws)return lt(ht,gt);Ws=!0;try{var xt=lt(ht);return xt}finally{if(Ws=!1,(Ur!==null||Vr!==null)&&(_s(),Ur&&(ht=Ur,lt=Vr,Vr=Ur=null,nd(ht),lt)))for(ht=0;ht<lt.length;ht++)nd(lt[ht])}}function Fo(lt,ht){var gt=lt.stateNode;if(gt===null)return null;var xt=gt[fn]||null;if(xt===null)return null;gt=xt[ht];e:switch(ht){case"onClick":case"onClickCapture":case"onDoubleClick":case"onDoubleClickCapture":case"onMouseDown":case"onMouseDownCapture":case"onMouseMove":case"onMouseMoveCapture":case"onMouseUp":case"onMouseUpCapture":case"onMouseEnter":(xt=!xt.disabled)||(lt=lt.type,xt=!(lt==="button"||lt==="input"||lt==="select"||lt==="textarea")),lt=!xt;break e;default:lt=!1}if(lt)return null;if(gt&&typeof gt!="function")throw Error(dt(231,ht,typeof gt));return gt}var Bi=!(typeof window>"u"||typeof window.document>"u"||typeof window.document.createElement>"u"),Ys=!1;if(Bi)try{var qo={};Object.defineProperty(qo,"passive",{get:function(){Ys=!0}}),window.addEventListener("test",qo,qo),window.removeEventListener("test",qo,qo)}catch{Ys=!1}var Ji=null,Xs=null,Ec=null;function od(){if(Ec)return Ec;var lt,ht=Xs,gt=ht.length,xt,Ct="value"in Ji?Ji.value:Ji.textContent,Lt=Ct.length;for(lt=0;lt<gt&&ht[lt]===Ct[lt];lt++);var Dt=gt-lt;for(xt=1;xt<=Dt&&ht[gt-xt]===Ct[Lt-xt];xt++);return Ec=Ct.slice(lt,1<xt?1-xt:void 0)}function Rc(lt){var ht=lt.keyCode;return"charCode"in lt?(lt=lt.charCode,lt===0&&ht===13&&(lt=13)):lt=ht,lt===10&&(lt=13),32<=lt||lt===13?lt:0}function Bc(){return!0}function cd(){return!1}function Wn(lt){function ht(gt,xt,Ct,Lt,Dt){this._reactName=gt,this._targetInst=Ct,this.type=xt,this.nativeEvent=Lt,this.target=Dt,this.currentTarget=null;for(var zt in lt)lt.hasOwnProperty(zt)&&(gt=lt[zt],this[zt]=gt?gt(Lt):Lt[zt]);return this.isDefaultPrevented=(Lt.defaultPrevented!=null?Lt.defaultPrevented:Lt.returnValue===!1)?Bc:cd,this.isPropagationStopped=cd,this}return vt(ht.prototype,{preventDefault:function(){this.defaultPrevented=!0;var gt=this.nativeEvent;gt&&(gt.preventDefault?gt.preventDefault():typeof gt.returnValue!="unknown"&&(gt.returnValue=!1),this.isDefaultPrevented=Bc)},stopPropagation:function(){var gt=this.nativeEvent;gt&&(gt.stopPropagation?gt.stopPropagation():typeof gt.cancelBubble!="unknown"&&(gt.cancelBubble=!0),this.isPropagationStopped=Bc)},persist:function(){},isPersistent:Bc}),ht}var Cr={eventPhase:0,bubbles:0,cancelable:0,timeStamp:function(lt){return lt.timeStamp||Date.now()},defaultPrevented:0,isTrusted:0},Dc=Wn(Cr),jo=vt({},Cr,{view:0,detail:0}),H0=Wn(jo),Zs,Ks,Oo,Pc=vt({},jo,{screenX:0,screenY:0,clientX:0,clientY:0,pageX:0,pageY:0,ctrlKey:0,shiftKey:0,altKey:0,metaKey:0,getModifierState:Js,button:0,buttons:0,relatedTarget:function(lt){return lt.relatedTarget===void 0?lt.fromElement===lt.srcElement?lt.toElement:lt.fromElement:lt.relatedTarget},movementX:function(lt){return"movementX"in lt?lt.movementX:(lt!==Oo&&(Oo&&lt.type==="mousemove"?(Zs=lt.screenX-Oo.screenX,Ks=lt.screenY-Oo.screenY):Ks=Zs=0,Oo=lt),Zs)},movementY:function(lt){return"movementY"in lt?lt.movementY:Ks}}),sd=Wn(Pc),U0=vt({},Pc,{dataTransfer:0}),V0=Wn(U0),G0=vt({},jo,{relatedTarget:0}),Qs=Wn(G0),W0=vt({},Cr,{animationName:0,elapsedTime:0,pseudoElement:0}),Y0=Wn(W0),X0=vt({},Cr,{clipboardData:function(lt){return"clipboardData"in lt?lt.clipboardData:window.clipboardData}}),Z0=Wn(X0),K0=vt({},Cr,{data:0}),ld=Wn(K0),Q0={Esc:"Escape",Spacebar:" ",Left:"ArrowLeft",Up:"ArrowUp",Right:"ArrowRight",Down:"ArrowDown",Del:"Delete",Win:"OS",Menu:"ContextMenu",Apps:"ContextMenu",Scroll:"ScrollLock",MozPrintableKey:"Unidentified"},J0={8:"Backspace",9:"Tab",12:"Clear",13:"Enter",16:"Shift",17:"Control",18:"Alt",19:"Pause",20:"CapsLock",27:"Escape",32:" ",33:"PageUp",34:"PageDown",35:"End",36:"Home",37:"ArrowLeft",38:"ArrowUp",39:"ArrowRight",40:"ArrowDown",45:"Insert",46:"Delete",112:"F1",113:"F2",114:"F3",115:"F4",116:"F5",117:"F6",118:"F7",119:"F8",120:"F9",121:"F10",122:"F11",123:"F12",144:"NumLock",145:"ScrollLock",224:"Meta"},e2={Alt:"altKey",Control:"ctrlKey",Meta:"metaKey",Shift:"shiftKey"};function t2(lt){var ht=this.nativeEvent;return ht.getModifierState?ht.getModifierState(lt):(lt=e2[lt])?!!ht[lt]:!1}function Js(){return t2}var a2=vt({},jo,{key:function(lt){if(lt.key){var ht=Q0[lt.key]||lt.key;if(ht!=="Unidentified")return ht}return lt.type==="keypress"?(lt=Rc(lt),lt===13?"Enter":String.fromCharCode(lt)):lt.type==="keydown"||lt.type==="keyup"?J0[lt.keyCode]||"Unidentified":""},code:0,location:0,ctrlKey:0,shiftKey:0,altKey:0,metaKey:0,repeat:0,locale:0,getModifierState:Js,charCode:function(lt){return lt.type==="keypress"?Rc(lt):0},keyCode:function(lt){return lt.type==="keydown"||lt.type==="keyup"?lt.keyCode:0},which:function(lt){return lt.type==="keypress"?Rc(lt):lt.type==="keydown"||lt.type==="keyup"?lt.keyCode:0}}),n2=Wn(a2),i2=vt({},Pc,{pointerId:0,width:0,height:0,pressure:0,tangentialPressure:0,tiltX:0,tiltY:0,twist:0,pointerType:0,isPrimary:0}),dd=Wn(i2),r2=vt({},jo,{touches:0,targetTouches:0,changedTouches:0,altKey:0,metaKey:0,ctrlKey:0,shiftKey:0,getModifierState:Js}),o2=Wn(r2),c2=vt({},Cr,{propertyName:0,elapsedTime:0,pseudoElement:0}),s2=Wn(c2),l2=vt({},Pc,{deltaX:function(lt){return"deltaX"in lt?lt.deltaX:"wheelDeltaX"in lt?-lt.wheelDeltaX:0},deltaY:function(lt){return"deltaY"in lt?lt.deltaY:"wheelDeltaY"in lt?-lt.wheelDeltaY:"wheelDelta"in lt?-lt.wheelDelta:0},deltaZ:0,deltaMode:0}),d2=Wn(l2),u2=vt({},Cr,{newState:0,oldState:0}),h2=Wn(u2),p2=[9,13,27,32],el=Bi&&"CompositionEvent"in window,zo=null;Bi&&"documentMode"in document&&(zo=document.documentMode);var f2=Bi&&"TextEvent"in window&&!zo,ud=Bi&&(!el||zo&&8<zo&&11>=zo),hd=" ",pd=!1;function fd(lt,ht){switch(lt){case"keyup":return p2.indexOf(ht.keyCode)!==-1;case"keydown":return ht.keyCode!==229;case"keypress":case"mousedown":case"focusout":return!0;default:return!1}}function yd(lt){return lt=lt.detail,typeof lt=="object"&&"data"in lt?lt.data:null}var Gr=!1;function y2(lt,ht){switch(lt){case"compositionend":return yd(ht);case"keypress":return ht.which!==32?null:(pd=!0,hd);case"textInput":return lt=ht.data,lt===hd&&pd?null:lt;default:return null}}function g2(lt,ht){if(Gr)return lt==="compositionend"||!el&&fd(lt,ht)?(lt=od(),Ec=Xs=Ji=null,Gr=!1,lt):null;switch(lt){case"paste":return null;case"keypress":if(!(ht.ctrlKey||ht.altKey||ht.metaKey)||ht.ctrlKey&&ht.altKey){if(ht.char&&1<ht.char.length)return ht.char;if(ht.which)return String.fromCharCode(ht.which)}return null;case"compositionend":return ud&&ht.locale!=="ko"?null:ht.data;default:return null}}var m2={color:!0,date:!0,datetime:!0,"datetime-local":!0,email:!0,month:!0,number:!0,password:!0,range:!0,search:!0,tel:!0,text:!0,time:!0,url:!0,week:!0};function gd(lt){var ht=lt&&lt.nodeName&&lt.nodeName.toLowerCase();return ht==="input"?!!m2[lt.type]:ht==="textarea"}function md(lt,ht,gt,xt){Ur?Vr?Vr.push(xt):Vr=[xt]:Ur=xt,ht=Ls(ht,"onChange"),0<ht.length&&(gt=new Dc("onChange","change",null,gt,xt),lt.push({event:gt,listeners:ht}))}var Ho=null,Uo=null;function k2(lt){e0(lt,0)}function Fc(lt){var ht=tn(lt);if(K1(ht))return lt}function kd(lt,ht){if(lt==="change")return ht}var _d=!1;if(Bi){var tl;if(Bi){var al="oninput"in document;if(!al){var xd=document.createElement("div");xd.setAttribute("oninput","return;"),al=typeof xd.oninput=="function"}tl=al}else tl=!1;_d=tl&&(!document.documentMode||9<document.documentMode)}function vd(){Ho&&(Ho.detachEvent("onpropertychange",bd),Uo=Ho=null)}function bd(lt){if(lt.propertyName==="value"&&Fc(Uo)){var ht=[];md(ht,Uo,lt,Gs(lt)),rd(k2,ht)}}function _2(lt,ht,gt){lt==="focusin"?(vd(),Ho=ht,Uo=gt,Ho.attachEvent("onpropertychange",bd)):lt==="focusout"&&vd()}function x2(lt){if(lt==="selectionchange"||lt==="keyup"||lt==="keydown")return Fc(Uo)}function v2(lt,ht){if(lt==="click")return Fc(ht)}function b2(lt,ht){if(lt==="input"||lt==="change")return Fc(ht)}function C2(lt,ht){return lt===ht&&(lt!==0||1/lt===1/ht)||lt!==lt&&ht!==ht}var ti=typeof Object.is=="function"?Object.is:C2;function Vo(lt,ht){if(ti(lt,ht))return!0;if(typeof lt!="object"||lt===null||typeof ht!="object"||ht===null)return!1;var gt=Object.keys(lt),xt=Object.keys(ht);if(gt.length!==xt.length)return!1;for(xt=0;xt<gt.length;xt++){var Ct=gt[xt];if(!Un.call(ht,Ct)||!ti(lt[Ct],ht[Ct]))return!1}return!0}function Cd(lt){for(;lt&&lt.firstChild;)lt=lt.firstChild;return lt}function Md(lt,ht){var gt=Cd(lt);lt=0;for(var xt;gt;){if(gt.nodeType===3){if(xt=lt+gt.textContent.length,lt<=ht&&xt>=ht)return{node:gt,offset:ht-lt};lt=xt}e:{for(;gt;){if(gt.nextSibling){gt=gt.nextSibling;break e}gt=gt.parentNode}gt=void 0}gt=Cd(gt)}}function wd(lt,ht){return lt&&ht?lt===ht?!0:lt&&lt.nodeType===3?!1:ht&&ht.nodeType===3?wd(lt,ht.parentNode):"contains"in lt?lt.contains(ht):lt.compareDocumentPosition?!!(lt.compareDocumentPosition(ht)&16):!1:!1}function Ld(lt){lt=lt!=null&&lt.ownerDocument!=null&&lt.ownerDocument.defaultView!=null?lt.ownerDocument.defaultView:window;for(var ht=Ac(lt.document);ht instanceof lt.HTMLIFrameElement;){try{var gt=typeof ht.contentWindow.location.href=="string"}catch{gt=!1}if(gt)lt=ht.contentWindow;else break;ht=Ac(lt.document)}return ht}function nl(lt){var ht=lt&&lt.nodeName&&lt.nodeName.toLowerCase();return ht&&(ht==="input"&&(lt.type==="text"||lt.type==="search"||lt.type==="tel"||lt.type==="url"||lt.type==="password")||ht==="textarea"||lt.contentEditable==="true")}var M2=Bi&&"documentMode"in document&&11>=document.documentMode,Wr=null,il=null,Go=null,rl=!1;function Sd(lt,ht,gt){var xt=gt.window===gt?gt.document:gt.nodeType===9?gt:gt.ownerDocument;rl||Wr==null||Wr!==Ac(xt)||(xt=Wr,"selectionStart"in xt&&nl(xt)?xt={start:xt.selectionStart,end:xt.selectionEnd}:(xt=(xt.ownerDocument&&xt.ownerDocument.defaultView||window).getSelection(),xt={anchorNode:xt.anchorNode,anchorOffset:xt.anchorOffset,focusNode:xt.focusNode,focusOffset:xt.focusOffset}),Go&&Vo(Go,xt)||(Go=xt,xt=Ls(il,"onSelect"),0<xt.length&&(ht=new Dc("onSelect","select",null,ht,gt),lt.push({event:ht,listeners:xt}),ht.target=Wr)))}function Mr(lt,ht){var gt={};return gt[lt.toLowerCase()]=ht.toLowerCase(),gt["Webkit"+lt]="webkit"+ht,gt["Moz"+lt]="moz"+ht,gt}var Yr={animationend:Mr("Animation","AnimationEnd"),animationiteration:Mr("Animation","AnimationIteration"),animationstart:Mr("Animation","AnimationStart"),transitionrun:Mr("Transition","TransitionRun"),transitionstart:Mr("Transition","TransitionStart"),transitioncancel:Mr("Transition","TransitionCancel"),transitionend:Mr("Transition","TransitionEnd")},ol={},$d={};Bi&&($d=document.createElement("div").style,"AnimationEvent"in window||(delete Yr.animationend.animation,delete Yr.animationiteration.animation,delete Yr.animationstart.animation),"TransitionEvent"in window||delete Yr.transitionend.transition);function wr(lt){if(ol[lt])return ol[lt];if(!Yr[lt])return lt;var ht=Yr[lt],gt;for(gt in ht)if(ht.hasOwnProperty(gt)&&gt in $d)return ol[lt]=ht[gt];return lt}var Nd=wr("animationend"),Id=wr("animationiteration"),Ad=wr("animationstart"),w2=wr("transitionrun"),L2=wr("transitionstart"),S2=wr("transitioncancel"),Td=wr("transitionend"),Ed=new Map,cl="abort auxClick beforeToggle cancel canPlay canPlayThrough click close contextMenu copy cut drag dragEnd dragEnter dragExit dragLeave dragOver dragStart drop durationChange emptied encrypted ended error gotPointerCapture input invalid keyDown keyPress keyUp load loadedData loadedMetadata loadStart lostPointerCapture mouseDown mouseMove mouseOut mouseOver mouseUp paste pause play playing pointerCancel pointerDown pointerMove pointerOut pointerOver pointerUp progress rateChange reset resize seeked seeking stalled submit suspend timeUpdate touchCancel touchEnd touchStart volumeChange scroll toggle touchMove waiting wheel".split(" ");cl.push("scrollEnd");function Ci(lt,ht){Ed.set(lt,ht),Gn(ht,[lt])}var qc=typeof reportError=="function"?reportError:function(lt){if(typeof window=="object"&&typeof window.ErrorEvent=="function"){var ht=new window.ErrorEvent("error",{bubbles:!0,cancelable:!0,message:typeof lt=="object"&&lt!==null&&typeof lt.message=="string"?String(lt.message):String(lt),error:lt});if(!window.dispatchEvent(ht))return}else if(typeof process=="object"&&typeof process.emit=="function"){process.emit("uncaughtException",lt);return}console.error(lt)},hi=[],Xr=0,sl=0;function jc(){for(var lt=Xr,ht=sl=Xr=0;ht<lt;){var gt=hi[ht];hi[ht++]=null;var xt=hi[ht];hi[ht++]=null;var Ct=hi[ht];hi[ht++]=null;var Lt=hi[ht];if(hi[ht++]=null,xt!==null&&Ct!==null){var Dt=xt.pending;Dt===null?Ct.next=Ct:(Ct.next=Dt.next,Dt.next=Ct),xt.pending=Ct}Lt!==0&&Rd(gt,Ct,Lt)}}function Oc(lt,ht,gt,xt){hi[Xr++]=lt,hi[Xr++]=ht,hi[Xr++]=gt,hi[Xr++]=xt,sl|=xt,lt.lanes|=xt,lt=lt.alternate,lt!==null&&(lt.lanes|=xt)}function ll(lt,ht,gt,xt){return Oc(lt,ht,gt,xt),zc(lt)}function Lr(lt,ht){return Oc(lt,null,null,ht),zc(lt)}function Rd(lt,ht,gt){lt.lanes|=gt;var xt=lt.alternate;xt!==null&&(xt.lanes|=gt);for(var Ct=!1,Lt=lt.return;Lt!==null;)Lt.childLanes|=gt,xt=Lt.alternate,xt!==null&&(xt.childLanes|=gt),Lt.tag===22&&(lt=Lt.stateNode,lt===null||lt._visibility&1||(Ct=!0)),lt=Lt,Lt=Lt.return;return lt.tag===3?(Lt=lt.stateNode,Ct&&ht!==null&&(Ct=31-pa(gt),lt=Lt.hiddenUpdates,xt=lt[Ct],xt===null?lt[Ct]=[ht]:xt.push(ht),ht.lane=gt|536870912),Lt):null}function zc(lt){if(50<fc)throw fc=0,k1=null,Error(dt(185));for(var ht=lt.return;ht!==null;)lt=ht,ht=lt.return;return lt.tag===3?lt.stateNode:null}var Zr={};function $2(lt,ht,gt,xt){this.tag=lt,this.key=gt,this.sibling=this.child=this.return=this.stateNode=this.type=this.elementType=null,this.index=0,this.refCleanup=this.ref=null,this.pendingProps=ht,this.dependencies=this.memoizedState=this.updateQueue=this.memoizedProps=null,this.mode=xt,this.subtreeFlags=this.flags=0,this.deletions=null,this.childLanes=this.lanes=0,this.alternate=null}function ai(lt,ht,gt,xt){return new $2(lt,ht,gt,xt)}function dl(lt){return lt=lt.prototype,!(!lt||!lt.isReactComponent)}function Di(lt,ht){var gt=lt.alternate;return gt===null?(gt=ai(lt.tag,ht,lt.key,lt.mode),gt.elementType=lt.elementType,gt.type=lt.type,gt.stateNode=lt.stateNode,gt.alternate=lt,lt.alternate=gt):(gt.pendingProps=ht,gt.type=lt.type,gt.flags=0,gt.subtreeFlags=0,gt.deletions=null),gt.flags=lt.flags&65011712,gt.childLanes=lt.childLanes,gt.lanes=lt.lanes,gt.child=lt.child,gt.memoizedProps=lt.memoizedProps,gt.memoizedState=lt.memoizedState,gt.updateQueue=lt.updateQueue,ht=lt.dependencies,gt.dependencies=ht===null?null:{lanes:ht.lanes,firstContext:ht.firstContext},gt.sibling=lt.sibling,gt.index=lt.index,gt.ref=lt.ref,gt.refCleanup=lt.refCleanup,gt}function Bd(lt,ht){lt.flags&=65011714;var gt=lt.alternate;return gt===null?(lt.childLanes=0,lt.lanes=ht,lt.child=null,lt.subtreeFlags=0,lt.memoizedProps=null,lt.memoizedState=null,lt.updateQueue=null,lt.dependencies=null,lt.stateNode=null):(lt.childLanes=gt.childLanes,lt.lanes=gt.lanes,lt.child=gt.child,lt.subtreeFlags=0,lt.deletions=null,lt.memoizedProps=gt.memoizedProps,lt.memoizedState=gt.memoizedState,lt.updateQueue=gt.updateQueue,lt.type=gt.type,ht=gt.dependencies,lt.dependencies=ht===null?null:{lanes:ht.lanes,firstContext:ht.firstContext}),lt}function Hc(lt,ht,gt,xt,Ct,Lt){var Dt=0;if(xt=lt,typeof lt=="function")dl(lt)&&(Dt=1);else if(typeof lt=="string")Dt=Ep(lt,gt,xa.current)?26:lt==="html"||lt==="head"||lt==="body"?27:5;else e:switch(lt){case Yt:return lt=ai(31,gt,ht,Ct),lt.elementType=Yt,lt.lanes=Lt,lt;case St:return Sr(gt.children,Ct,Lt,ht);case It:Dt=8,Ct|=24;break;case Nt:return lt=ai(12,gt,ht,Ct|2),lt.elementType=Nt,lt.lanes=Lt,lt;case qt:return lt=ai(13,gt,ht,Ct),lt.elementType=qt,lt.lanes=Lt,lt;case Ht:return lt=ai(19,gt,ht,Ct),lt.elementType=Ht,lt.lanes=Lt,lt;default:if(typeof lt=="object"&&lt!==null)switch(lt.$$typeof){case Et:Dt=10;break e;case $t:Dt=9;break e;case Ft:Dt=11;break e;case Ot:Dt=14;break e;case Zt:Dt=16,xt=null;break e}Dt=29,gt=Error(dt(130,lt===null?"null":typeof lt,"")),xt=null}return ht=ai(Dt,gt,ht,Ct),ht.elementType=lt,ht.type=xt,ht.lanes=Lt,ht}function Sr(lt,ht,gt,xt){return lt=ai(7,lt,xt,ht),lt.lanes=gt,lt}function ul(lt,ht,gt){return lt=ai(6,lt,null,ht),lt.lanes=gt,lt}function Dd(lt){var ht=ai(18,null,null,0);return ht.stateNode=lt,ht}function hl(lt,ht,gt){return ht=ai(4,lt.children!==null?lt.children:[],lt.key,ht),ht.lanes=gt,ht.stateNode={containerInfo:lt.containerInfo,pendingChildren:null,implementation:lt.implementation},ht}var Pd=new WeakMap;function fi(lt,ht){if(typeof lt=="object"&&lt!==null){var gt=Pd.get(lt);return gt!==void 0?gt:(ht={value:lt,source:ht,stack:vn(ht)},Pd.set(lt,ht),ht)}return{value:lt,source:ht,stack:vn(ht)}}var Kr=[],Qr=0,Uc=null,Wo=0,yi=[],gi=0,er=null,Si=1,$i="";function Fi(lt,ht){Kr[Qr++]=Wo,Kr[Qr++]=Uc,Uc=lt,Wo=ht}function Fd(lt,ht,gt){yi[gi++]=Si,yi[gi++]=$i,yi[gi++]=er,er=lt;var xt=Si;lt=$i;var Ct=32-pa(xt)-1;xt&=~(1<<Ct),gt+=1;var Lt=32-pa(ht)+Ct;if(30<Lt){var Dt=Ct-Ct%5;Lt=(xt&(1<<Dt)-1).toString(32),xt>>=Dt,Ct-=Dt,Si=1<<32-pa(ht)+Ct|gt<<Ct|xt,$i=Lt+lt}else Si=1<<Lt|gt<<Ct|xt,$i=lt}function pl(lt){lt.return!==null&&(Fi(lt,1),Fd(lt,1,0))}function fl(lt){for(;lt===Uc;)Uc=Kr[--Qr],Kr[Qr]=null,Wo=Kr[--Qr],Kr[Qr]=null;for(;lt===er;)er=yi[--gi],yi[gi]=null,$i=yi[--gi],yi[gi]=null,Si=yi[--gi],yi[gi]=null}function qd(lt,ht){yi[gi++]=Si,yi[gi++]=$i,yi[gi++]=er,Si=ht.id,$i=ht.overflow,er=lt}var Dn=null,dn=null,Xa=!1,tr=null,mi=!1,yl=Error(dt(519));function ar(lt){var ht=Error(dt(418,1<arguments.length&&arguments[1]!==void 0&&arguments[1]?"text":"HTML",""));throw Yo(fi(ht,lt)),yl}function jd(lt){var ht=lt.stateNode,gt=lt.type,xt=lt.memoizedProps;switch(ht[Ln]=lt,ht[fn]=xt,gt){case"dialog":Ga("cancel",ht),Ga("close",ht);break;case"iframe":case"object":case"embed":Ga("load",ht);break;case"video":case"audio":for(gt=0;gt<gc.length;gt++)Ga(gc[gt],ht);break;case"source":Ga("error",ht);break;case"img":case"image":case"link":Ga("error",ht),Ga("load",ht);break;case"details":Ga("toggle",ht);break;case"input":Ga("invalid",ht),Q1(ht,xt.value,xt.defaultValue,xt.checked,xt.defaultChecked,xt.type,xt.name,!0);break;case"select":Ga("invalid",ht);break;case"textarea":Ga("invalid",ht),ed(ht,xt.value,xt.defaultValue,xt.children)}gt=xt.children,typeof gt!="string"&&typeof gt!="number"&&typeof gt!="bigint"||ht.textContent===""+gt||xt.suppressHydrationWarning===!0||i0(ht.textContent,gt)?(xt.popover!=null&&(Ga("beforetoggle",ht),Ga("toggle",ht)),xt.onScroll!=null&&Ga("scroll",ht),xt.onScrollEnd!=null&&Ga("scrollend",ht),xt.onClick!=null&&(ht.onclick=Ri),ht=!0):ht=!1,ht||ar(lt,!0)}function Od(lt){for(Dn=lt.return;Dn;)switch(Dn.tag){case 5:case 31:case 13:mi=!1;return;case 27:case 3:mi=!0;return;default:Dn=Dn.return}}function Jr(lt){if(lt!==Dn)return!1;if(!Xa)return Od(lt),Xa=!0,!1;var ht=lt.tag,gt;if((gt=ht!==3&&ht!==27)&&((gt=ht===5)&&(gt=lt.type,gt=!(gt!=="form"&&gt!=="button")||E1(lt.type,lt.memoizedProps)),gt=!gt),gt&&dn&&ar(lt),Od(lt),ht===13){if(lt=lt.memoizedState,lt=lt!==null?lt.dehydrated:null,!lt)throw Error(dt(317));dn=p0(lt)}else if(ht===31){if(lt=lt.memoizedState,lt=lt!==null?lt.dehydrated:null,!lt)throw Error(dt(317));dn=p0(lt)}else ht===27?(ht=dn,gr(lt.type)?(lt=F1,F1=null,dn=lt):dn=ht):dn=Dn?_i(lt.stateNode.nextSibling):null;return!0}function $r(){dn=Dn=null,Xa=!1}function gl(){var lt=tr;return lt!==null&&(Kn===null?Kn=lt:Kn.push.apply(Kn,lt),tr=null),lt}function Yo(lt){tr===null?tr=[lt]:tr.push(lt)}var ml=Vt(null),Nr=null,qi=null;function nr(lt,ht,gt){sa(ml,ht._currentValue),ht._currentValue=gt}function ji(lt){lt._currentValue=ml.current,ta(ml)}function kl(lt,ht,gt){for(;lt!==null;){var xt=lt.alternate;if((lt.childLanes&ht)!==ht?(lt.childLanes|=ht,xt!==null&&(xt.childLanes|=ht)):xt!==null&&(xt.childLanes&ht)!==ht&&(xt.childLanes|=ht),lt===gt)break;lt=lt.return}}function _l(lt,ht,gt,xt){var Ct=lt.child;for(Ct!==null&&(Ct.return=lt);Ct!==null;){var Lt=Ct.dependencies;if(Lt!==null){var Dt=Ct.child;Lt=Lt.firstContext;e:for(;Lt!==null;){var zt=Lt;Lt=Ct;for(var Jt=0;Jt<ht.length;Jt++)if(zt.context===ht[Jt]){Lt.lanes|=gt,zt=Lt.alternate,zt!==null&&(zt.lanes|=gt),kl(Lt.return,gt,lt),xt||(Dt=null);break e}Lt=zt.next}}else if(Ct.tag===18){if(Dt=Ct.return,Dt===null)throw Error(dt(341));Dt.lanes|=gt,Lt=Dt.alternate,Lt!==null&&(Lt.lanes|=gt),kl(Dt,gt,lt),Dt=null}else Dt=Ct.child;if(Dt!==null)Dt.return=Ct;else for(Dt=Ct;Dt!==null;){if(Dt===lt){Dt=null;break}if(Ct=Dt.sibling,Ct!==null){Ct.return=Dt.return,Dt=Ct;break}Dt=Dt.return}Ct=Dt}}function eo(lt,ht,gt,xt){lt=null;for(var Ct=ht,Lt=!1;Ct!==null;){if(!Lt){if((Ct.flags&524288)!==0)Lt=!0;else if((Ct.flags&262144)!==0)break}if(Ct.tag===10){var Dt=Ct.alternate;if(Dt===null)throw Error(dt(387));if(Dt=Dt.memoizedProps,Dt!==null){var zt=Ct.type;ti(Ct.pendingProps.value,Dt.value)||(lt!==null?lt.push(zt):lt=[zt])}}else if(Ct===Na.current){if(Dt=Ct.alternate,Dt===null)throw Error(dt(387));Dt.memoizedState.memoizedState!==Ct.memoizedState.memoizedState&&(lt!==null?lt.push(vc):lt=[vc])}Ct=Ct.return}lt!==null&&_l(ht,lt,gt,xt),ht.flags|=262144}function Vc(lt){for(lt=lt.firstContext;lt!==null;){if(!ti(lt.context._currentValue,lt.memoizedValue))return!0;lt=lt.next}return!1}function Ir(lt){Nr=lt,qi=null,lt=lt.dependencies,lt!==null&&(lt.firstContext=null)}function Pn(lt){return zd(Nr,lt)}function Gc(lt,ht){return Nr===null&&Ir(lt),zd(lt,ht)}function zd(lt,ht){var gt=ht._currentValue;if(ht={context:ht,memoizedValue:gt,next:null},qi===null){if(lt===null)throw Error(dt(308));qi=ht,lt.dependencies={lanes:0,firstContext:ht},lt.flags|=524288}else qi=qi.next=ht;return gt}var N2=typeof AbortController<"u"?AbortController:function(){var lt=[],ht=this.signal={aborted:!1,addEventListener:function(gt,xt){lt.push(xt)}};this.abort=function(){ht.aborted=!0,lt.forEach(function(gt){return gt()})}},I2=rt.unstable_scheduleCallback,A2=rt.unstable_NormalPriority,Sn={$$typeof:Et,Consumer:null,Provider:null,_currentValue:null,_currentValue2:null,_threadCount:0};function xl(){return{controller:new N2,data:new Map,refCount:0}}function Xo(lt){lt.refCount--,lt.refCount===0&&I2(A2,function(){lt.controller.abort()})}var Zo=null,vl=0,to=0,ao=null;function T2(lt,ht){if(Zo===null){var gt=Zo=[];vl=0,to=M1(),ao={status:"pending",value:void 0,then:function(xt){gt.push(xt)}}}return vl++,ht.then(Hd,Hd),ht}function Hd(){if(--vl===0&&Zo!==null){ao!==null&&(ao.status="fulfilled");var lt=Zo;Zo=null,to=0,ao=null;for(var ht=0;ht<lt.length;ht++)(0,lt[ht])()}}function E2(lt,ht){var gt=[],xt={status:"pending",value:null,reason:null,then:function(Ct){gt.push(Ct)}};return lt.then(function(){xt.status="fulfilled",xt.value=ht;for(var Ct=0;Ct<gt.length;Ct++)(0,gt[Ct])(ht)},function(Ct){for(xt.status="rejected",xt.reason=Ct,Ct=0;Ct<gt.length;Ct++)(0,gt[Ct])(void 0)}),xt}var Ud=Ut.S;Ut.S=function(lt,ht){$h=pn(),typeof ht=="object"&&ht!==null&&typeof ht.then=="function"&&T2(lt,ht),Ud!==null&&Ud(lt,ht)};var Ar=Vt(null);function bl(){var lt=Ar.current;return lt!==null?lt:ln.pooledCache}function Wc(lt,ht){ht===null?sa(Ar,Ar.current):sa(Ar,ht.pool)}function Vd(){var lt=bl();return lt===null?null:{parent:Sn._currentValue,pool:lt}}var no=Error(dt(460)),Cl=Error(dt(474)),Yc=Error(dt(542)),Xc={then:function(){}};function Gd(lt){return lt=lt.status,lt==="fulfilled"||lt==="rejected"}function Wd(lt,ht,gt){switch(gt=lt[gt],gt===void 0?lt.push(ht):gt!==ht&&(ht.then(Ri,Ri),ht=gt),ht.status){case"fulfilled":return ht.value;case"rejected":throw lt=ht.reason,Xd(lt),lt;default:if(typeof ht.status=="string")ht.then(Ri,Ri);else{if(lt=ln,lt!==null&&100<lt.shellSuspendCounter)throw Error(dt(482));lt=ht,lt.status="pending",lt.then(function(xt){if(ht.status==="pending"){var Ct=ht;Ct.status="fulfilled",Ct.value=xt}},function(xt){if(ht.status==="pending"){var Ct=ht;Ct.status="rejected",Ct.reason=xt}})}switch(ht.status){case"fulfilled":return ht.value;case"rejected":throw lt=ht.reason,Xd(lt),lt}throw Er=ht,no}}function Tr(lt){try{var ht=lt._init;return ht(lt._payload)}catch(gt){throw gt!==null&&typeof gt=="object"&&typeof gt.then=="function"?(Er=gt,no):gt}}var Er=null;function Yd(){if(Er===null)throw Error(dt(459));var lt=Er;return Er=null,lt}function Xd(lt){if(lt===no||lt===Yc)throw Error(dt(483))}var io=null,Ko=0;function Zc(lt){var ht=Ko;return Ko+=1,io===null&&(io=[]),Wd(io,lt,ht)}function Qo(lt,ht){ht=ht.props.ref,lt.ref=ht!==void 0?ht:null}function Kc(lt,ht){throw ht.$$typeof===bt?Error(dt(525)):(lt=Object.prototype.toString.call(ht),Error(dt(31,lt==="[object Object]"?"object with keys {"+Object.keys(ht).join(", ")+"}":lt)))}function Zd(lt){function ht(ca,ia){if(lt){var ua=ca.deletions;ua===null?(ca.deletions=[ia],ca.flags|=16):ua.push(ia)}}function gt(ca,ia){if(!lt)return null;for(;ia!==null;)ht(ca,ia),ia=ia.sibling;return null}function xt(ca){for(var ia=new Map;ca!==null;)ca.key!==null?ia.set(ca.key,ca):ia.set(ca.index,ca),ca=ca.sibling;return ia}function Ct(ca,ia){return ca=Di(ca,ia),ca.index=0,ca.sibling=null,ca}function Lt(ca,ia,ua){return ca.index=ua,lt?(ua=ca.alternate,ua!==null?(ua=ua.index,ua<ia?(ca.flags|=67108866,ia):ua):(ca.flags|=67108866,ia)):(ca.flags|=1048576,ia)}function Dt(ca){return lt&&ca.alternate===null&&(ca.flags|=67108866),ca}function zt(ca,ia,ua,Ma){return ia===null||ia.tag!==6?(ia=ul(ua,ca.mode,Ma),ia.return=ca,ia):(ia=Ct(ia,ua),ia.return=ca,ia)}function Jt(ca,ia,ua,Ma){var Ba=ua.type;return Ba===St?va(ca,ia,ua.props.children,Ma,ua.key):ia!==null&&(ia.elementType===Ba||typeof Ba=="object"&&Ba!==null&&Ba.$$typeof===Zt&&Tr(Ba)===ia.type)?(ia=Ct(ia,ua.props),Qo(ia,ua),ia.return=ca,ia):(ia=Hc(ua.type,ua.key,ua.props,null,ca.mode,Ma),Qo(ia,ua),ia.return=ca,ia)}function ha(ca,ia,ua,Ma){return ia===null||ia.tag!==4||ia.stateNode.containerInfo!==ua.containerInfo||ia.stateNode.implementation!==ua.implementation?(ia=hl(ua,ca.mode,Ma),ia.return=ca,ia):(ia=Ct(ia,ua.children||[]),ia.return=ca,ia)}function va(ca,ia,ua,Ma,Ba){return ia===null||ia.tag!==7?(ia=Sr(ua,ca.mode,Ma,Ba),ia.return=ca,ia):(ia=Ct(ia,ua),ia.return=ca,ia)}function wa(ca,ia,ua){if(typeof ia=="string"&&ia!==""||typeof ia=="number"||typeof ia=="bigint")return ia=ul(""+ia,ca.mode,ua),ia.return=ca,ia;if(typeof ia=="object"&&ia!==null){switch(ia.$$typeof){case Mt:return ua=Hc(ia.type,ia.key,ia.props,null,ca.mode,ua),Qo(ua,ia),ua.return=ca,ua;case wt:return ia=hl(ia,ca.mode,ua),ia.return=ca,ia;case Zt:return ia=Tr(ia),wa(ca,ia,ua)}if(ra(ia)||oa(ia))return ia=Sr(ia,ca.mode,ua,null),ia.return=ca,ia;if(typeof ia.then=="function")return wa(ca,Zc(ia),ua);if(ia.$$typeof===Et)return wa(ca,Gc(ca,ia),ua);Kc(ca,ia)}return null}function ya(ca,ia,ua,Ma){var Ba=ia!==null?ia.key:null;if(typeof ua=="string"&&ua!==""||typeof ua=="number"||typeof ua=="bigint")return Ba!==null?null:zt(ca,ia,""+ua,Ma);if(typeof ua=="object"&&ua!==null){switch(ua.$$typeof){case Mt:return ua.key===Ba?Jt(ca,ia,ua,Ma):null;case wt:return ua.key===Ba?ha(ca,ia,ua,Ma):null;case Zt:return ua=Tr(ua),ya(ca,ia,ua,Ma)}if(ra(ua)||oa(ua))return Ba!==null?null:va(ca,ia,ua,Ma,null);if(typeof ua.then=="function")return ya(ca,ia,Zc(ua),Ma);if(ua.$$typeof===Et)return ya(ca,ia,Gc(ca,ua),Ma);Kc(ca,ua)}return null}function ga(ca,ia,ua,Ma,Ba){if(typeof Ma=="string"&&Ma!==""||typeof Ma=="number"||typeof Ma=="bigint")return ca=ca.get(ua)||null,zt(ia,ca,""+Ma,Ba);if(typeof Ma=="object"&&Ma!==null){switch(Ma.$$typeof){case Mt:return ca=ca.get(Ma.key===null?ua:Ma.key)||null,Jt(ia,ca,Ma,Ba);case wt:return ca=ca.get(Ma.key===null?ua:Ma.key)||null,ha(ia,ca,Ma,Ba);case Zt:return Ma=Tr(Ma),ga(ca,ia,ua,Ma,Ba)}if(ra(Ma)||oa(Ma))return ca=ca.get(ua)||null,va(ia,ca,Ma,Ba,null);if(typeof Ma.then=="function")return ga(ca,ia,ua,Zc(Ma),Ba);if(Ma.$$typeof===Et)return ga(ca,ia,ua,Gc(ia,Ma),Ba);Kc(ia,Ma)}return null}function Aa(ca,ia,ua,Ma){for(var Ba=null,Za=null,Ea=ia,za=ia=0,Ya=null;Ea!==null&&za<ua.length;za++){Ea.index>za?(Ya=Ea,Ea=null):Ya=Ea.sibling;var Ka=ya(ca,Ea,ua[za],Ma);if(Ka===null){Ea===null&&(Ea=Ya);break}lt&&Ea&&Ka.alternate===null&&ht(ca,Ea),ia=Lt(Ka,ia,za),Za===null?Ba=Ka:Za.sibling=Ka,Za=Ka,Ea=Ya}if(za===ua.length)return gt(ca,Ea),Xa&&Fi(ca,za),Ba;if(Ea===null){for(;za<ua.length;za++)Ea=wa(ca,ua[za],Ma),Ea!==null&&(ia=Lt(Ea,ia,za),Za===null?Ba=Ea:Za.sibling=Ea,Za=Ea);return Xa&&Fi(ca,za),Ba}for(Ea=xt(Ea);za<ua.length;za++)Ya=ga(Ea,ca,za,ua[za],Ma),Ya!==null&&(lt&&Ya.alternate!==null&&Ea.delete(Ya.key===null?za:Ya.key),ia=Lt(Ya,ia,za),Za===null?Ba=Ya:Za.sibling=Ya,Za=Ya);return lt&&Ea.forEach(function(vr){return ht(ca,vr)}),Xa&&Fi(ca,za),Ba}function Da(ca,ia,ua,Ma){if(ua==null)throw Error(dt(151));for(var Ba=null,Za=null,Ea=ia,za=ia=0,Ya=null,Ka=ua.next();Ea!==null&&!Ka.done;za++,Ka=ua.next()){Ea.index>za?(Ya=Ea,Ea=null):Ya=Ea.sibling;var vr=ya(ca,Ea,Ka.value,Ma);if(vr===null){Ea===null&&(Ea=Ya);break}lt&&Ea&&vr.alternate===null&&ht(ca,Ea),ia=Lt(vr,ia,za),Za===null?Ba=vr:Za.sibling=vr,Za=vr,Ea=Ya}if(Ka.done)return gt(ca,Ea),Xa&&Fi(ca,za),Ba;if(Ea===null){for(;!Ka.done;za++,Ka=ua.next())Ka=wa(ca,Ka.value,Ma),Ka!==null&&(ia=Lt(Ka,ia,za),Za===null?Ba=Ka:Za.sibling=Ka,Za=Ka);return Xa&&Fi(ca,za),Ba}for(Ea=xt(Ea);!Ka.done;za++,Ka=ua.next())Ka=ga(Ea,ca,za,Ka.value,Ma),Ka!==null&&(lt&&Ka.alternate!==null&&Ea.delete(Ka.key===null?za:Ka.key),ia=Lt(Ka,ia,za),Za===null?Ba=Ka:Za.sibling=Ka,Za=Ka);return lt&&Ea.forEach(function(Up){return ht(ca,Up)}),Xa&&Fi(ca,za),Ba}function sn(ca,ia,ua,Ma){if(typeof ua=="object"&&ua!==null&&ua.type===St&&ua.key===null&&(ua=ua.props.children),typeof ua=="object"&&ua!==null){switch(ua.$$typeof){case Mt:e:{for(var Ba=ua.key;ia!==null;){if(ia.key===Ba){if(Ba=ua.type,Ba===St){if(ia.tag===7){gt(ca,ia.sibling),Ma=Ct(ia,ua.props.children),Ma.return=ca,ca=Ma;break e}}else if(ia.elementType===Ba||typeof Ba=="object"&&Ba!==null&&Ba.$$typeof===Zt&&Tr(Ba)===ia.type){gt(ca,ia.sibling),Ma=Ct(ia,ua.props),Qo(Ma,ua),Ma.return=ca,ca=Ma;break e}gt(ca,ia);break}else ht(ca,ia);ia=ia.sibling}ua.type===St?(Ma=Sr(ua.props.children,ca.mode,Ma,ua.key),Ma.return=ca,ca=Ma):(Ma=Hc(ua.type,ua.key,ua.props,null,ca.mode,Ma),Qo(Ma,ua),Ma.return=ca,ca=Ma)}return Dt(ca);case wt:e:{for(Ba=ua.key;ia!==null;){if(ia.key===Ba)if(ia.tag===4&&ia.stateNode.containerInfo===ua.containerInfo&&ia.stateNode.implementation===ua.implementation){gt(ca,ia.sibling),Ma=Ct(ia,ua.children||[]),Ma.return=ca,ca=Ma;break e}else{gt(ca,ia);break}else ht(ca,ia);ia=ia.sibling}Ma=hl(ua,ca.mode,Ma),Ma.return=ca,ca=Ma}return Dt(ca);case Zt:return ua=Tr(ua),sn(ca,ia,ua,Ma)}if(ra(ua))return Aa(ca,ia,ua,Ma);if(oa(ua)){if(Ba=oa(ua),typeof Ba!="function")throw Error(dt(150));return ua=Ba.call(ua),Da(ca,ia,ua,Ma)}if(typeof ua.then=="function")return sn(ca,ia,Zc(ua),Ma);if(ua.$$typeof===Et)return sn(ca,ia,Gc(ca,ua),Ma);Kc(ca,ua)}return typeof ua=="string"&&ua!==""||typeof ua=="number"||typeof ua=="bigint"?(ua=""+ua,ia!==null&&ia.tag===6?(gt(ca,ia.sibling),Ma=Ct(ia,ua),Ma.return=ca,ca=Ma):(gt(ca,ia),Ma=ul(ua,ca.mode,Ma),Ma.return=ca,ca=Ma),Dt(ca)):gt(ca,ia)}return function(ca,ia,ua,Ma){try{Ko=0;var Ba=sn(ca,ia,ua,Ma);return io=null,Ba}catch(Ea){if(Ea===no||Ea===Yc)throw Ea;var Za=ai(29,Ea,null,ca.mode);return Za.lanes=Ma,Za.return=ca,Za}finally{}}}var Rr=Zd(!0),Kd=Zd(!1),ir=!1;function Ml(lt){lt.updateQueue={baseState:lt.memoizedState,firstBaseUpdate:null,lastBaseUpdate:null,shared:{pending:null,lanes:0,hiddenCallbacks:null},callbacks:null}}function wl(lt,ht){lt=lt.updateQueue,ht.updateQueue===lt&&(ht.updateQueue={baseState:lt.baseState,firstBaseUpdate:lt.firstBaseUpdate,lastBaseUpdate:lt.lastBaseUpdate,shared:lt.shared,callbacks:null})}function rr(lt){return{lane:lt,tag:0,payload:null,callback:null,next:null}}function or(lt,ht,gt){var xt=lt.updateQueue;if(xt===null)return null;if(xt=xt.shared,(Qa&2)!==0){var Ct=xt.pending;return Ct===null?ht.next=ht:(ht.next=Ct.next,Ct.next=ht),xt.pending=ht,ht=zc(lt),Rd(lt,null,gt),ht}return Oc(lt,xt,ht,gt),zc(lt)}function Jo(lt,ht,gt){if(ht=ht.updateQueue,ht!==null&&(ht=ht.shared,(gt&4194048)!==0)){var xt=ht.lanes;xt&=lt.pendingLanes,gt|=xt,ht.lanes=gt,Eo(lt,gt)}}function Ll(lt,ht){var gt=lt.updateQueue,xt=lt.alternate;if(xt!==null&&(xt=xt.updateQueue,gt===xt)){var Ct=null,Lt=null;if(gt=gt.firstBaseUpdate,gt!==null){do{var Dt={lane:gt.lane,tag:gt.tag,payload:gt.payload,callback:null,next:null};Lt===null?Ct=Lt=Dt:Lt=Lt.next=Dt,gt=gt.next}while(gt!==null);Lt===null?Ct=Lt=ht:Lt=Lt.next=ht}else Ct=Lt=ht;gt={baseState:xt.baseState,firstBaseUpdate:Ct,lastBaseUpdate:Lt,shared:xt.shared,callbacks:xt.callbacks},lt.updateQueue=gt;return}lt=gt.lastBaseUpdate,lt===null?gt.firstBaseUpdate=ht:lt.next=ht,gt.lastBaseUpdate=ht}var Sl=!1;function ec(){if(Sl){var lt=ao;if(lt!==null)throw lt}}function tc(lt,ht,gt,xt){Sl=!1;var Ct=lt.updateQueue;ir=!1;var Lt=Ct.firstBaseUpdate,Dt=Ct.lastBaseUpdate,zt=Ct.shared.pending;if(zt!==null){Ct.shared.pending=null;var Jt=zt,ha=Jt.next;Jt.next=null,Dt===null?Lt=ha:Dt.next=ha,Dt=Jt;var va=lt.alternate;va!==null&&(va=va.updateQueue,zt=va.lastBaseUpdate,zt!==Dt&&(zt===null?va.firstBaseUpdate=ha:zt.next=ha,va.lastBaseUpdate=Jt))}if(Lt!==null){var wa=Ct.baseState;Dt=0,va=ha=Jt=null,zt=Lt;do{var ya=zt.lane&-536870913,ga=ya!==zt.lane;if(ga?(Wa&ya)===ya:(xt&ya)===ya){ya!==0&&ya===to&&(Sl=!0),va!==null&&(va=va.next={lane:0,tag:zt.tag,payload:zt.payload,callback:null,next:null});e:{var Aa=lt,Da=zt;ya=ht;var sn=gt;switch(Da.tag){case 1:if(Aa=Da.payload,typeof Aa=="function"){wa=Aa.call(sn,wa,ya);break e}wa=Aa;break e;case 3:Aa.flags=Aa.flags&-65537|128;case 0:if(Aa=Da.payload,ya=typeof Aa=="function"?Aa.call(sn,wa,ya):Aa,ya==null)break e;wa=vt({},wa,ya);break e;case 2:ir=!0}}ya=zt.callback,ya!==null&&(lt.flags|=64,ga&&(lt.flags|=8192),ga=Ct.callbacks,ga===null?Ct.callbacks=[ya]:ga.push(ya))}else ga={lane:ya,tag:zt.tag,payload:zt.payload,callback:zt.callback,next:null},va===null?(ha=va=ga,Jt=wa):va=va.next=ga,Dt|=ya;if(zt=zt.next,zt===null){if(zt=Ct.shared.pending,zt===null)break;ga=zt,zt=ga.next,ga.next=null,Ct.lastBaseUpdate=ga,Ct.shared.pending=null}}while(!0);va===null&&(Jt=wa),Ct.baseState=Jt,Ct.firstBaseUpdate=ha,Ct.lastBaseUpdate=va,Lt===null&&(Ct.shared.lanes=0),ur|=Dt,lt.lanes=Dt,lt.memoizedState=wa}}function Qd(lt,ht){if(typeof lt!="function")throw Error(dt(191,lt));lt.call(ht)}function Jd(lt,ht){var gt=lt.callbacks;if(gt!==null)for(lt.callbacks=null,lt=0;lt<gt.length;lt++)Qd(gt[lt],ht)}var ro=Vt(null),Qc=Vt(0);function eu(lt,ht){lt=Xi,sa(Qc,lt),sa(ro,ht),Xi=lt|ht.baseLanes}function $l(){sa(Qc,Xi),sa(ro,ro.current)}function Nl(){Xi=Qc.current,ta(ro),ta(Qc)}var ni=Vt(null),ki=null;function cr(lt){var ht=lt.alternate;sa(bn,bn.current&1),sa(ni,lt),ki===null&&(ht===null||ro.current!==null||ht.memoizedState!==null)&&(ki=lt)}function Il(lt){sa(bn,bn.current),sa(ni,lt),ki===null&&(ki=lt)}function tu(lt){lt.tag===22?(sa(bn,bn.current),sa(ni,lt),ki===null&&(ki=lt)):sr()}function sr(){sa(bn,bn.current),sa(ni,ni.current)}function ii(lt){ta(ni),ki===lt&&(ki=null),ta(bn)}var bn=Vt(0);function Jc(lt){for(var ht=lt;ht!==null;){if(ht.tag===13){var gt=ht.memoizedState;if(gt!==null&&(gt=gt.dehydrated,gt===null||D1(gt)||P1(gt)))return ht}else if(ht.tag===19&&(ht.memoizedProps.revealOrder==="forwards"||ht.memoizedProps.revealOrder==="backwards"||ht.memoizedProps.revealOrder==="unstable_legacy-backwards"||ht.memoizedProps.revealOrder==="together")){if((ht.flags&128)!==0)return ht}else if(ht.child!==null){ht.child.return=ht,ht=ht.child;continue}if(ht===lt)break;for(;ht.sibling===null;){if(ht.return===null||ht.return===lt)return null;ht=ht.return}ht.sibling.return=ht.return,ht=ht.sibling}return null}var Oi=0,Oa=null,on=null,$n=null,es=!1,oo=!1,Br=!1,ts=0,ac=0,co=null,R2=0;function _n(){throw Error(dt(321))}function Al(lt,ht){if(ht===null)return!1;for(var gt=0;gt<ht.length&&gt<lt.length;gt++)if(!ti(lt[gt],ht[gt]))return!1;return!0}function Tl(lt,ht,gt,xt,Ct,Lt){return Oi=Lt,Oa=ht,ht.memoizedState=null,ht.updateQueue=null,ht.lanes=0,Ut.H=lt===null||lt.memoizedState===null?qu:Wl,Br=!1,Lt=gt(xt,Ct),Br=!1,oo&&(Lt=nu(ht,gt,xt,Ct)),au(lt),Lt}function au(lt){Ut.H=rc;var ht=on!==null&&on.next!==null;if(Oi=0,$n=on=Oa=null,es=!1,ac=0,co=null,ht)throw Error(dt(300));lt===null||Nn||(lt=lt.dependencies,lt!==null&&Vc(lt)&&(Nn=!0))}function nu(lt,ht,gt,xt){Oa=lt;var Ct=0;do{if(oo&&(co=null),ac=0,oo=!1,25<=Ct)throw Error(dt(301));if(Ct+=1,$n=on=null,lt.updateQueue!=null){var Lt=lt.updateQueue;Lt.lastEffect=null,Lt.events=null,Lt.stores=null,Lt.memoCache!=null&&(Lt.memoCache.index=0)}Ut.H=ju,Lt=ht(gt,xt)}while(oo);return Lt}function B2(){var lt=Ut.H,ht=lt.useState()[0];return ht=typeof ht.then=="function"?nc(ht):ht,lt=lt.useState()[0],(on!==null?on.memoizedState:null)!==lt&&(Oa.flags|=1024),ht}function El(){var lt=ts!==0;return ts=0,lt}function Rl(lt,ht,gt){ht.updateQueue=lt.updateQueue,ht.flags&=-2053,lt.lanes&=~gt}function Bl(lt){if(es){for(lt=lt.memoizedState;lt!==null;){var ht=lt.queue;ht!==null&&(ht.pending=null),lt=lt.next}es=!1}Oi=0,$n=on=Oa=null,oo=!1,ac=ts=0,co=null}function zn(){var lt={memoizedState:null,baseState:null,baseQueue:null,queue:null,next:null};return $n===null?Oa.memoizedState=$n=lt:$n=$n.next=lt,$n}function Cn(){if(on===null){var lt=Oa.alternate;lt=lt!==null?lt.memoizedState:null}else lt=on.next;var ht=$n===null?Oa.memoizedState:$n.next;if(ht!==null)$n=ht,on=lt;else{if(lt===null)throw Oa.alternate===null?Error(dt(467)):Error(dt(310));on=lt,lt={memoizedState:on.memoizedState,baseState:on.baseState,baseQueue:on.baseQueue,queue:on.queue,next:null},$n===null?Oa.memoizedState=$n=lt:$n=$n.next=lt}return $n}function as(){return{lastEffect:null,events:null,stores:null,memoCache:null}}function nc(lt){var ht=ac;return ac+=1,co===null&&(co=[]),lt=Wd(co,lt,ht),ht=Oa,($n===null?ht.memoizedState:$n.next)===null&&(ht=ht.alternate,Ut.H=ht===null||ht.memoizedState===null?qu:Wl),lt}function ns(lt){if(lt!==null&&typeof lt=="object"){if(typeof lt.then=="function")return nc(lt);if(lt.$$typeof===Et)return Pn(lt)}throw Error(dt(438,String(lt)))}function Dl(lt){var ht=null,gt=Oa.updateQueue;if(gt!==null&&(ht=gt.memoCache),ht==null){var xt=Oa.alternate;xt!==null&&(xt=xt.updateQueue,xt!==null&&(xt=xt.memoCache,xt!=null&&(ht={data:xt.data.map(function(Ct){return Ct.slice()}),index:0})))}if(ht==null&&(ht={data:[],index:0}),gt===null&&(gt=as(),Oa.updateQueue=gt),gt.memoCache=ht,gt=ht.data[ht.index],gt===void 0)for(gt=ht.data[ht.index]=Array(lt),xt=0;xt<lt;xt++)gt[xt]=aa;return ht.index++,gt}function zi(lt,ht){return typeof ht=="function"?ht(lt):ht}function is(lt){var ht=Cn();return Pl(ht,on,lt)}function Pl(lt,ht,gt){var xt=lt.queue;if(xt===null)throw Error(dt(311));xt.lastRenderedReducer=gt;var Ct=lt.baseQueue,Lt=xt.pending;if(Lt!==null){if(Ct!==null){var Dt=Ct.next;Ct.next=Lt.next,Lt.next=Dt}ht.baseQueue=Ct=Lt,xt.pending=null}if(Lt=lt.baseState,Ct===null)lt.memoizedState=Lt;else{ht=Ct.next;var zt=Dt=null,Jt=null,ha=ht,va=!1;do{var wa=ha.lane&-536870913;if(wa!==ha.lane?(Wa&wa)===wa:(Oi&wa)===wa){var ya=ha.revertLane;if(ya===0)Jt!==null&&(Jt=Jt.next={lane:0,revertLane:0,gesture:null,action:ha.action,hasEagerState:ha.hasEagerState,eagerState:ha.eagerState,next:null}),wa===to&&(va=!0);else if((Oi&ya)===ya){ha=ha.next,ya===to&&(va=!0);continue}else wa={lane:0,revertLane:ha.revertLane,gesture:null,action:ha.action,hasEagerState:ha.hasEagerState,eagerState:ha.eagerState,next:null},Jt===null?(zt=Jt=wa,Dt=Lt):Jt=Jt.next=wa,Oa.lanes|=ya,ur|=ya;wa=ha.action,Br&&gt(Lt,wa),Lt=ha.hasEagerState?ha.eagerState:gt(Lt,wa)}else ya={lane:wa,revertLane:ha.revertLane,gesture:ha.gesture,action:ha.action,hasEagerState:ha.hasEagerState,eagerState:ha.eagerState,next:null},Jt===null?(zt=Jt=ya,Dt=Lt):Jt=Jt.next=ya,Oa.lanes|=wa,ur|=wa;ha=ha.next}while(ha!==null&&ha!==ht);if(Jt===null?Dt=Lt:Jt.next=zt,!ti(Lt,lt.memoizedState)&&(Nn=!0,va&&(gt=ao,gt!==null)))throw gt;lt.memoizedState=Lt,lt.baseState=Dt,lt.baseQueue=Jt,xt.lastRenderedState=Lt}return Ct===null&&(xt.lanes=0),[lt.memoizedState,xt.dispatch]}function Fl(lt){var ht=Cn(),gt=ht.queue;if(gt===null)throw Error(dt(311));gt.lastRenderedReducer=lt;var xt=gt.dispatch,Ct=gt.pending,Lt=ht.memoizedState;if(Ct!==null){gt.pending=null;var Dt=Ct=Ct.next;do Lt=lt(Lt,Dt.action),Dt=Dt.next;while(Dt!==Ct);ti(Lt,ht.memoizedState)||(Nn=!0),ht.memoizedState=Lt,ht.baseQueue===null&&(ht.baseState=Lt),gt.lastRenderedState=Lt}return[Lt,xt]}function iu(lt,ht,gt){var xt=Oa,Ct=Cn(),Lt=Xa;if(Lt){if(gt===void 0)throw Error(dt(407));gt=gt()}else gt=ht();var Dt=!ti((on||Ct).memoizedState,gt);if(Dt&&(Ct.memoizedState=gt,Nn=!0),Ct=Ct.queue,Ol(su.bind(null,xt,Ct,lt),[lt]),Ct.getSnapshot!==ht||Dt||$n!==null&&$n.memoizedState.tag&1){if(xt.flags|=2048,so(9,{destroy:void 0},cu.bind(null,xt,Ct,gt,ht),null),ln===null)throw Error(dt(349));Lt||(Oi&127)!==0||ou(xt,ht,gt)}return gt}function ou(lt,ht,gt){lt.flags|=16384,lt={getSnapshot:ht,value:gt},ht=Oa.updateQueue,ht===null?(ht=as(),Oa.updateQueue=ht,ht.stores=[lt]):(gt=ht.stores,gt===null?ht.stores=[lt]:gt.push(lt))}function cu(lt,ht,gt,xt){ht.value=gt,ht.getSnapshot=xt,lu(ht)&&du(lt)}function su(lt,ht,gt){return gt(function(){lu(ht)&&du(lt)})}function lu(lt){var ht=lt.getSnapshot;lt=lt.value;try{var gt=ht();return!ti(lt,gt)}catch{return!0}}function du(lt){var ht=Lr(lt,2);ht!==null&&Qn(ht,lt,2)}function ql(lt){var ht=zn();if(typeof lt=="function"){var gt=lt;if(lt=gt(),Br){ma(!0);try{gt()}finally{ma(!1)}}}return ht.memoizedState=ht.baseState=lt,ht.queue={pending:null,lanes:0,dispatch:null,lastRenderedReducer:zi,lastRenderedState:lt},ht}function uu(lt,ht,gt,xt){return lt.baseState=gt,Pl(lt,on,typeof xt=="function"?xt:zi)}function D2(lt,ht,gt,xt,Ct){if(cs(lt))throw Error(dt(485));if(lt=ht.action,lt!==null){var Lt={payload:Ct,action:lt,next:null,isTransition:!0,status:"pending",value:null,reason:null,listeners:[],then:function(Dt){Lt.listeners.push(Dt)}};Ut.T!==null?gt(!0):Lt.isTransition=!1,xt(Lt),gt=ht.pending,gt===null?(Lt.next=ht.pending=Lt,hu(ht,Lt)):(Lt.next=gt.next,ht.pending=gt.next=Lt)}}function hu(lt,ht){var gt=ht.action,xt=ht.payload,Ct=lt.state;if(ht.isTransition){var Lt=Ut.T,Dt={};Ut.T=Dt;try{var zt=gt(Ct,xt),Jt=Ut.S;Jt!==null&&Jt(Dt,zt),pu(lt,ht,zt)}catch(ha){jl(lt,ht,ha)}finally{Lt!==null&&Dt.types!==null&&(Lt.types=Dt.types),Ut.T=Lt}}else try{Lt=gt(Ct,xt),pu(lt,ht,Lt)}catch(ha){jl(lt,ht,ha)}}function pu(lt,ht,gt){gt!==null&&typeof gt=="object"&&typeof gt.then=="function"?gt.then(function(xt){fu(lt,ht,xt)},function(xt){return jl(lt,ht,xt)}):fu(lt,ht,gt)}function fu(lt,ht,gt){ht.status="fulfilled",ht.value=gt,yu(ht),lt.state=gt,ht=lt.pending,ht!==null&&(gt=ht.next,gt===ht?lt.pending=null:(gt=gt.next,ht.next=gt,hu(lt,gt)))}function jl(lt,ht,gt){var xt=lt.pending;if(lt.pending=null,xt!==null){xt=xt.next;do ht.status="rejected",ht.reason=gt,yu(ht),ht=ht.next;while(ht!==xt)}lt.action=null}function yu(lt){lt=lt.listeners;for(var ht=0;ht<lt.length;ht++)(0,lt[ht])()}function gu(lt,ht){return ht}function mu(lt,ht){if(Xa){var gt=ln.formState;if(gt!==null){e:{var xt=Oa;if(Xa){if(dn){t:{for(var Ct=dn,Lt=mi;Ct.nodeType!==8;){if(!Lt){Ct=null;break t}if(Ct=_i(Ct.nextSibling),Ct===null){Ct=null;break t}}Lt=Ct.data,Ct=Lt==="F!"||Lt==="F"?Ct:null}if(Ct){dn=_i(Ct.nextSibling),xt=Ct.data==="F!";break e}}ar(xt)}xt=!1}xt&&(ht=gt[0])}}return gt=zn(),gt.memoizedState=gt.baseState=ht,xt={pending:null,lanes:0,dispatch:null,lastRenderedReducer:gu,lastRenderedState:ht},gt.queue=xt,gt=Du.bind(null,Oa,xt),xt.dispatch=gt,xt=ql(!1),Lt=Gl.bind(null,Oa,!1,xt.queue),xt=zn(),Ct={state:ht,dispatch:null,action:lt,pending:null},xt.queue=Ct,gt=D2.bind(null,Oa,Ct,Lt,gt),Ct.dispatch=gt,xt.memoizedState=lt,[ht,gt,!1]}function ku(lt){var ht=Cn();return _u(ht,on,lt)}function _u(lt,ht,gt){if(ht=Pl(lt,ht,gu)[0],lt=is(zi)[0],typeof ht=="object"&&ht!==null&&typeof ht.then=="function")try{var xt=nc(ht)}catch(Dt){throw Dt===no?Yc:Dt}else xt=ht;ht=Cn();var Ct=ht.queue,Lt=Ct.dispatch;return gt!==ht.memoizedState&&(Oa.flags|=2048,so(9,{destroy:void 0},P2.bind(null,Ct,gt),null)),[xt,Lt,lt]}function P2(lt,ht){lt.action=ht}function xu(lt){var ht=Cn(),gt=on;if(gt!==null)return _u(ht,gt,lt);Cn(),ht=ht.memoizedState,gt=Cn();var xt=gt.queue.dispatch;return gt.memoizedState=lt,[ht,xt,!1]}function so(lt,ht,gt,xt){return lt={tag:lt,create:gt,deps:xt,inst:ht,next:null},ht=Oa.updateQueue,ht===null&&(ht=as(),Oa.updateQueue=ht),gt=ht.lastEffect,gt===null?ht.lastEffect=lt.next=lt:(xt=gt.next,gt.next=lt,lt.next=xt,ht.lastEffect=lt),lt}function vu(){return Cn().memoizedState}function rs(lt,ht,gt,xt){var Ct=zn();Oa.flags|=lt,Ct.memoizedState=so(1|ht,{destroy:void 0},gt,xt===void 0?null:xt)}function os(lt,ht,gt,xt){var Ct=Cn();xt=xt===void 0?null:xt;var Lt=Ct.memoizedState.inst;on!==null&&xt!==null&&Al(xt,on.memoizedState.deps)?Ct.memoizedState=so(ht,Lt,gt,xt):(Oa.flags|=lt,Ct.memoizedState=so(1|ht,Lt,gt,xt))}function bu(lt,ht){rs(8390656,8,lt,ht)}function Ol(lt,ht){os(2048,8,lt,ht)}function F2(lt){Oa.flags|=4;var ht=Oa.updateQueue;if(ht===null)ht=as(),Oa.updateQueue=ht,ht.events=[lt];else{var gt=ht.events;gt===null?ht.events=[lt]:gt.push(lt)}}function Cu(lt){var ht=Cn().memoizedState;return F2({ref:ht,nextImpl:lt}),function(){if((Qa&2)!==0)throw Error(dt(440));return ht.impl.apply(void 0,arguments)}}function Mu(lt,ht){return os(4,2,lt,ht)}function wu(lt,ht){return os(4,4,lt,ht)}function Lu(lt,ht){if(typeof ht=="function"){lt=lt();var gt=ht(lt);return function(){typeof gt=="function"?gt():ht(null)}}if(ht!=null)return lt=lt(),ht.current=lt,function(){ht.current=null}}function Su(lt,ht,gt){gt=gt!=null?gt.concat([lt]):null,os(4,4,Lu.bind(null,ht,lt),gt)}function zl(){}function $u(lt,ht){var gt=Cn();ht=ht===void 0?null:ht;var xt=gt.memoizedState;return ht!==null&&Al(ht,xt[1])?xt[0]:(gt.memoizedState=[lt,ht],lt)}function Nu(lt,ht){var gt=Cn();ht=ht===void 0?null:ht;var xt=gt.memoizedState;if(ht!==null&&Al(ht,xt[1]))return xt[0];if(xt=lt(),Br){ma(!0);try{lt()}finally{ma(!1)}}return gt.memoizedState=[xt,ht],xt}function Hl(lt,ht,gt){return gt===void 0||(Oi&1073741824)!==0&&(Wa&261930)===0?lt.memoizedState=ht:(lt.memoizedState=gt,lt=Ih(),Oa.lanes|=lt,ur|=lt,gt)}function Iu(lt,ht,gt,xt){return ti(gt,ht)?gt:ro.current!==null?(lt=Hl(lt,gt,xt),ti(lt,ht)||(Nn=!0),lt):(Oi&42)===0||(Oi&1073741824)!==0&&(Wa&261930)===0?(Nn=!0,lt.memoizedState=gt):(lt=Ih(),Oa.lanes|=lt,ur|=lt,ht)}function Au(lt,ht,gt,xt,Ct){var Lt=ea.p;ea.p=Lt!==0&&8>Lt?Lt:8;var Dt=Ut.T,zt={};Ut.T=zt,Gl(lt,!1,ht,gt);try{var Jt=Ct(),ha=Ut.S;if(ha!==null&&ha(zt,Jt),Jt!==null&&typeof Jt=="object"&&typeof Jt.then=="function"){var va=E2(Jt,xt);ic(lt,ht,va,ci(lt))}else ic(lt,ht,xt,ci(lt))}catch(wa){ic(lt,ht,{then:function(){},status:"rejected",reason:wa},ci())}finally{ea.p=Lt,Dt!==null&&zt.types!==null&&(Dt.types=zt.types),Ut.T=Dt}}function q2(){}function Ul(lt,ht,gt,xt){if(lt.tag!==5)throw Error(dt(476));var Ct=Tu(lt).queue;Au(lt,Ct,ht,Gt,gt===null?q2:function(){return Eu(lt),gt(xt)})}function Tu(lt){var ht=lt.memoizedState;if(ht!==null)return ht;ht={memoizedState:Gt,baseState:Gt,baseQueue:null,queue:{pending:null,lanes:0,dispatch:null,lastRenderedReducer:zi,lastRenderedState:Gt},next:null};var gt={};return ht.next={memoizedState:gt,baseState:gt,baseQueue:null,queue:{pending:null,lanes:0,dispatch:null,lastRenderedReducer:zi,lastRenderedState:gt},next:null},lt.memoizedState=ht,lt=lt.alternate,lt!==null&&(lt.memoizedState=ht),ht}function Eu(lt){var ht=Tu(lt);ht.next===null&&(ht=lt.alternate.memoizedState),ic(lt,ht.next.queue,{},ci())}function Vl(){return Pn(vc)}function Ru(){return Cn().memoizedState}function Bu(){return Cn().memoizedState}function j2(lt){for(var ht=lt.return;ht!==null;){switch(ht.tag){case 24:case 3:var gt=ci();lt=rr(gt);var xt=or(ht,lt,gt);xt!==null&&(Qn(xt,ht,gt),Jo(xt,ht,gt)),ht={cache:xl()},lt.payload=ht;return}ht=ht.return}}function O2(lt,ht,gt){var xt=ci();gt={lane:xt,revertLane:0,gesture:null,action:gt,hasEagerState:!1,eagerState:null,next:null},cs(lt)?Pu(ht,gt):(gt=ll(lt,ht,gt,xt),gt!==null&&(Qn(gt,lt,xt),Fu(gt,ht,xt)))}function Du(lt,ht,gt){var xt=ci();ic(lt,ht,gt,xt)}function ic(lt,ht,gt,xt){var Ct={lane:xt,revertLane:0,gesture:null,action:gt,hasEagerState:!1,eagerState:null,next:null};if(cs(lt))Pu(ht,Ct);else{var Lt=lt.alternate;if(lt.lanes===0&&(Lt===null||Lt.lanes===0)&&(Lt=ht.lastRenderedReducer,Lt!==null))try{var Dt=ht.lastRenderedState,zt=Lt(Dt,gt);if(Ct.hasEagerState=!0,Ct.eagerState=zt,ti(zt,Dt))return Oc(lt,ht,Ct,0),ln===null&&jc(),!1}catch{}finally{}if(gt=ll(lt,ht,Ct,xt),gt!==null)return Qn(gt,lt,xt),Fu(gt,ht,xt),!0}return!1}function Gl(lt,ht,gt,xt){if(xt={lane:2,revertLane:M1(),gesture:null,action:xt,hasEagerState:!1,eagerState:null,next:null},cs(lt)){if(ht)throw Error(dt(479))}else ht=ll(lt,gt,xt,2),ht!==null&&Qn(ht,lt,2)}function cs(lt){var ht=lt.alternate;return lt===Oa||ht!==null&&ht===Oa}function Pu(lt,ht){oo=es=!0;var gt=lt.pending;gt===null?ht.next=ht:(ht.next=gt.next,gt.next=ht),lt.pending=ht}function Fu(lt,ht,gt){if((gt&4194048)!==0){var xt=ht.lanes;xt&=lt.pendingLanes,gt|=xt,ht.lanes=gt,Eo(lt,gt)}}var rc={readContext:Pn,use:ns,useCallback:_n,useContext:_n,useEffect:_n,useImperativeHandle:_n,useLayoutEffect:_n,useInsertionEffect:_n,useMemo:_n,useReducer:_n,useRef:_n,useState:_n,useDebugValue:_n,useDeferredValue:_n,useTransition:_n,useSyncExternalStore:_n,useId:_n,useHostTransitionStatus:_n,useFormState:_n,useActionState:_n,useOptimistic:_n,useMemoCache:_n,useCacheRefresh:_n};rc.useEffectEvent=_n;var qu={readContext:Pn,use:ns,useCallback:function(lt,ht){return zn().memoizedState=[lt,ht===void 0?null:ht],lt},useContext:Pn,useEffect:bu,useImperativeHandle:function(lt,ht,gt){gt=gt!=null?gt.concat([lt]):null,rs(4194308,4,Lu.bind(null,ht,lt),gt)},useLayoutEffect:function(lt,ht){return rs(4194308,4,lt,ht)},useInsertionEffect:function(lt,ht){rs(4,2,lt,ht)},useMemo:function(lt,ht){var gt=zn();ht=ht===void 0?null:ht;var xt=lt();if(Br){ma(!0);try{lt()}finally{ma(!1)}}return gt.memoizedState=[xt,ht],xt},useReducer:function(lt,ht,gt){var xt=zn();if(gt!==void 0){var Ct=gt(ht);if(Br){ma(!0);try{gt(ht)}finally{ma(!1)}}}else Ct=ht;return xt.memoizedState=xt.baseState=Ct,lt={pending:null,lanes:0,dispatch:null,lastRenderedReducer:lt,lastRenderedState:Ct},xt.queue=lt,lt=lt.dispatch=O2.bind(null,Oa,lt),[xt.memoizedState,lt]},useRef:function(lt){var ht=zn();return lt={current:lt},ht.memoizedState=lt},useState:function(lt){lt=ql(lt);var ht=lt.queue,gt=Du.bind(null,Oa,ht);return ht.dispatch=gt,[lt.memoizedState,gt]},useDebugValue:zl,useDeferredValue:function(lt,ht){var gt=zn();return Hl(gt,lt,ht)},useTransition:function(){var lt=ql(!1);return lt=Au.bind(null,Oa,lt.queue,!0,!1),zn().memoizedState=lt,[!1,lt]},useSyncExternalStore:function(lt,ht,gt){var xt=Oa,Ct=zn();if(Xa){if(gt===void 0)throw Error(dt(407));gt=gt()}else{if(gt=ht(),ln===null)throw Error(dt(349));(Wa&127)!==0||ou(xt,ht,gt)}Ct.memoizedState=gt;var Lt={value:gt,getSnapshot:ht};return Ct.queue=Lt,bu(su.bind(null,xt,Lt,lt),[lt]),xt.flags|=2048,so(9,{destroy:void 0},cu.bind(null,xt,Lt,gt,ht),null),gt},useId:function(){var lt=zn(),ht=ln.identifierPrefix;if(Xa){var gt=$i,xt=Si;gt=(xt&~(1<<32-pa(xt)-1)).toString(32)+gt,ht="_"+ht+"R_"+gt,gt=ts++,0<gt&&(ht+="H"+gt.toString(32)),ht+="_"}else gt=R2++,ht="_"+ht+"r_"+gt.toString(32)+"_";return lt.memoizedState=ht},useHostTransitionStatus:Vl,useFormState:mu,useActionState:mu,useOptimistic:function(lt){var ht=zn();ht.memoizedState=ht.baseState=lt;var gt={pending:null,lanes:0,dispatch:null,lastRenderedReducer:null,lastRenderedState:null};return ht.queue=gt,ht=Gl.bind(null,Oa,!0,gt),gt.dispatch=ht,[lt,ht]},useMemoCache:Dl,useCacheRefresh:function(){return zn().memoizedState=j2.bind(null,Oa)},useEffectEvent:function(lt){var ht=zn(),gt={impl:lt};return ht.memoizedState=gt,function(){if((Qa&2)!==0)throw Error(dt(440));return gt.impl.apply(void 0,arguments)}}},Wl={readContext:Pn,use:ns,useCallback:$u,useContext:Pn,useEffect:Ol,useImperativeHandle:Su,useInsertionEffect:Mu,useLayoutEffect:wu,useMemo:Nu,useReducer:is,useRef:vu,useState:function(){return is(zi)},useDebugValue:zl,useDeferredValue:function(lt,ht){var gt=Cn();return Iu(gt,on.memoizedState,lt,ht)},useTransition:function(){var lt=is(zi)[0],ht=Cn().memoizedState;return[typeof lt=="boolean"?lt:nc(lt),ht]},useSyncExternalStore:iu,useId:Ru,useHostTransitionStatus:Vl,useFormState:ku,useActionState:ku,useOptimistic:function(lt,ht){var gt=Cn();return uu(gt,on,lt,ht)},useMemoCache:Dl,useCacheRefresh:Bu};Wl.useEffectEvent=Cu;var ju={readContext:Pn,use:ns,useCallback:$u,useContext:Pn,useEffect:Ol,useImperativeHandle:Su,useInsertionEffect:Mu,useLayoutEffect:wu,useMemo:Nu,useReducer:Fl,useRef:vu,useState:function(){return Fl(zi)},useDebugValue:zl,useDeferredValue:function(lt,ht){var gt=Cn();return on===null?Hl(gt,lt,ht):Iu(gt,on.memoizedState,lt,ht)},useTransition:function(){var lt=Fl(zi)[0],ht=Cn().memoizedState;return[typeof lt=="boolean"?lt:nc(lt),ht]},useSyncExternalStore:iu,useId:Ru,useHostTransitionStatus:Vl,useFormState:xu,useActionState:xu,useOptimistic:function(lt,ht){var gt=Cn();return on!==null?uu(gt,on,lt,ht):(gt.baseState=lt,[lt,gt.queue.dispatch])},useMemoCache:Dl,useCacheRefresh:Bu};ju.useEffectEvent=Cu;function Yl(lt,ht,gt,xt){ht=lt.memoizedState,gt=gt(xt,ht),gt=gt==null?ht:vt({},ht,gt),lt.memoizedState=gt,lt.lanes===0&&(lt.updateQueue.baseState=gt)}var Xl={enqueueSetState:function(lt,ht,gt){lt=lt._reactInternals;var xt=ci(),Ct=rr(xt);Ct.payload=ht,gt!=null&&(Ct.callback=gt),ht=or(lt,Ct,xt),ht!==null&&(Qn(ht,lt,xt),Jo(ht,lt,xt))},enqueueReplaceState:function(lt,ht,gt){lt=lt._reactInternals;var xt=ci(),Ct=rr(xt);Ct.tag=1,Ct.payload=ht,gt!=null&&(Ct.callback=gt),ht=or(lt,Ct,xt),ht!==null&&(Qn(ht,lt,xt),Jo(ht,lt,xt))},enqueueForceUpdate:function(lt,ht){lt=lt._reactInternals;var gt=ci(),xt=rr(gt);xt.tag=2,ht!=null&&(xt.callback=ht),ht=or(lt,xt,gt),ht!==null&&(Qn(ht,lt,gt),Jo(ht,lt,gt))}};function Ou(lt,ht,gt,xt,Ct,Lt,Dt){return lt=lt.stateNode,typeof lt.shouldComponentUpdate=="function"?lt.shouldComponentUpdate(xt,Lt,Dt):ht.prototype&&ht.prototype.isPureReactComponent?!Vo(gt,xt)||!Vo(Ct,Lt):!0}function zu(lt,ht,gt,xt){lt=ht.state,typeof ht.componentWillReceiveProps=="function"&&ht.componentWillReceiveProps(gt,xt),typeof ht.UNSAFE_componentWillReceiveProps=="function"&&ht.UNSAFE_componentWillReceiveProps(gt,xt),ht.state!==lt&&Xl.enqueueReplaceState(ht,ht.state,null)}function Dr(lt,ht){var gt=ht;if("ref"in ht){gt={};for(var xt in ht)xt!=="ref"&&(gt[xt]=ht[xt])}if(lt=lt.defaultProps){gt===ht&&(gt=vt({},gt));for(var Ct in lt)gt[Ct]===void 0&&(gt[Ct]=lt[Ct])}return gt}function Hu(lt){qc(lt)}function Uu(lt){console.error(lt)}function Vu(lt){qc(lt)}function ss(lt,ht){try{var gt=lt.onUncaughtError;gt(ht.value,{componentStack:ht.stack})}catch(xt){setTimeout(function(){throw xt})}}function Gu(lt,ht,gt){try{var xt=lt.onCaughtError;xt(gt.value,{componentStack:gt.stack,errorBoundary:ht.tag===1?ht.stateNode:null})}catch(Ct){setTimeout(function(){throw Ct})}}function Zl(lt,ht,gt){return gt=rr(gt),gt.tag=3,gt.payload={element:null},gt.callback=function(){ss(lt,ht)},gt}function Wu(lt){return lt=rr(lt),lt.tag=3,lt}function Yu(lt,ht,gt,xt){var Ct=gt.type.getDerivedStateFromError;if(typeof Ct=="function"){var Lt=xt.value;lt.payload=function(){return Ct(Lt)},lt.callback=function(){Gu(ht,gt,xt)}}var Dt=gt.stateNode;Dt!==null&&typeof Dt.componentDidCatch=="function"&&(lt.callback=function(){Gu(ht,gt,xt),typeof Ct!="function"&&(hr===null?hr=new Set([this]):hr.add(this));var zt=xt.stack;this.componentDidCatch(xt.value,{componentStack:zt!==null?zt:""})})}function z2(lt,ht,gt,xt,Ct){if(gt.flags|=32768,xt!==null&&typeof xt=="object"&&typeof xt.then=="function"){if(ht=gt.alternate,ht!==null&&eo(ht,gt,Ct,!0),gt=ni.current,gt!==null){switch(gt.tag){case 31:case 13:return ki===null?xs():gt.alternate===null&&xn===0&&(xn=3),gt.flags&=-257,gt.flags|=65536,gt.lanes=Ct,xt===Xc?gt.flags|=16384:(ht=gt.updateQueue,ht===null?gt.updateQueue=new Set([xt]):ht.add(xt),v1(lt,xt,Ct)),!1;case 22:return gt.flags|=65536,xt===Xc?gt.flags|=16384:(ht=gt.updateQueue,ht===null?(ht={transitions:null,markerInstances:null,retryQueue:new Set([xt])},gt.updateQueue=ht):(gt=ht.retryQueue,gt===null?ht.retryQueue=new Set([xt]):gt.add(xt)),v1(lt,xt,Ct)),!1}throw Error(dt(435,gt.tag))}return v1(lt,xt,Ct),xs(),!1}if(Xa)return ht=ni.current,ht!==null?((ht.flags&65536)===0&&(ht.flags|=256),ht.flags|=65536,ht.lanes=Ct,xt!==yl&&(lt=Error(dt(422),{cause:xt}),Yo(fi(lt,gt)))):(xt!==yl&&(ht=Error(dt(423),{cause:xt}),Yo(fi(ht,gt))),lt=lt.current.alternate,lt.flags|=65536,Ct&=-Ct,lt.lanes|=Ct,xt=fi(xt,gt),Ct=Zl(lt.stateNode,xt,Ct),Ll(lt,Ct),xn!==4&&(xn=2)),!1;var Lt=Error(dt(520),{cause:xt});if(Lt=fi(Lt,gt),pc===null?pc=[Lt]:pc.push(Lt),xn!==4&&(xn=2),ht===null)return!0;xt=fi(xt,gt),gt=ht;do{switch(gt.tag){case 3:return gt.flags|=65536,lt=Ct&-Ct,gt.lanes|=lt,lt=Zl(gt.stateNode,xt,lt),Ll(gt,lt),!1;case 1:if(ht=gt.type,Lt=gt.stateNode,(gt.flags&128)===0&&(typeof ht.getDerivedStateFromError=="function"||Lt!==null&&typeof Lt.componentDidCatch=="function"&&(hr===null||!hr.has(Lt))))return gt.flags|=65536,Ct&=-Ct,gt.lanes|=Ct,Ct=Wu(Ct),Yu(Ct,lt,gt,xt),Ll(gt,Ct),!1}gt=gt.return}while(gt!==null);return!1}var Kl=Error(dt(461)),Nn=!1;function Fn(lt,ht,gt,xt){ht.child=lt===null?Kd(ht,null,gt,xt):Rr(ht,lt.child,gt,xt)}function Xu(lt,ht,gt,xt,Ct){gt=gt.render;var Lt=ht.ref;if("ref"in xt){var Dt={};for(var zt in xt)zt!=="ref"&&(Dt[zt]=xt[zt])}else Dt=xt;return Ir(ht),xt=Tl(lt,ht,gt,Dt,Lt,Ct),zt=El(),lt!==null&&!Nn?(Rl(lt,ht,Ct),Hi(lt,ht,Ct)):(Xa&&zt&&pl(ht),ht.flags|=1,Fn(lt,ht,xt,Ct),ht.child)}function Zu(lt,ht,gt,xt,Ct){if(lt===null){var Lt=gt.type;return typeof Lt=="function"&&!dl(Lt)&&Lt.defaultProps===void 0&&gt.compare===null?(ht.tag=15,ht.type=Lt,Ku(lt,ht,Lt,xt,Ct)):(lt=Hc(gt.type,null,xt,ht,ht.mode,Ct),lt.ref=ht.ref,lt.return=ht,ht.child=lt)}if(Lt=lt.child,!r1(lt,Ct)){var Dt=Lt.memoizedProps;if(gt=gt.compare,gt=gt!==null?gt:Vo,gt(Dt,xt)&&lt.ref===ht.ref)return Hi(lt,ht,Ct)}return ht.flags|=1,lt=Di(Lt,xt),lt.ref=ht.ref,lt.return=ht,ht.child=lt}function Ku(lt,ht,gt,xt,Ct){if(lt!==null){var Lt=lt.memoizedProps;if(Vo(Lt,xt)&&lt.ref===ht.ref)if(Nn=!1,ht.pendingProps=xt=Lt,r1(lt,Ct))(lt.flags&131072)!==0&&(Nn=!0);else return ht.lanes=lt.lanes,Hi(lt,ht,Ct)}return Ql(lt,ht,gt,xt,Ct)}function Qu(lt,ht,gt,xt){var Ct=xt.children,Lt=lt!==null?lt.memoizedState:null;if(lt===null&&ht.stateNode===null&&(ht.stateNode={_visibility:1,_pendingMarkers:null,_retryCache:null,_transitions:null}),xt.mode==="hidden"){if((ht.flags&128)!==0){if(Lt=Lt!==null?Lt.baseLanes|gt:gt,lt!==null){for(xt=ht.child=lt.child,Ct=0;xt!==null;)Ct=Ct|xt.lanes|xt.childLanes,xt=xt.sibling;xt=Ct&~Lt}else xt=0,ht.child=null;return Ju(lt,ht,Lt,gt,xt)}if((gt&536870912)!==0)ht.memoizedState={baseLanes:0,cachePool:null},lt!==null&&Wc(ht,Lt!==null?Lt.cachePool:null),Lt!==null?eu(ht,Lt):$l(),tu(ht);else return xt=ht.lanes=536870912,Ju(lt,ht,Lt!==null?Lt.baseLanes|gt:gt,gt,xt)}else Lt!==null?(Wc(ht,Lt.cachePool),eu(ht,Lt),sr(),ht.memoizedState=null):(lt!==null&&Wc(ht,null),$l(),sr());return Fn(lt,ht,Ct,gt),ht.child}function oc(lt,ht){return lt!==null&&lt.tag===22||ht.stateNode!==null||(ht.stateNode={_visibility:1,_pendingMarkers:null,_retryCache:null,_transitions:null}),ht.sibling}function Ju(lt,ht,gt,xt,Ct){var Lt=bl();return Lt=Lt===null?null:{parent:Sn._currentValue,pool:Lt},ht.memoizedState={baseLanes:gt,cachePool:Lt},lt!==null&&Wc(ht,null),$l(),tu(ht),lt!==null&&eo(lt,ht,xt,!0),ht.childLanes=Ct,null}function ls(lt,ht){return ht=us({mode:ht.mode,children:ht.children},lt.mode),ht.ref=lt.ref,lt.child=ht,ht.return=lt,ht}function eh(lt,ht,gt){return Rr(ht,lt.child,null,gt),lt=ls(ht,ht.pendingProps),lt.flags|=2,ii(ht),ht.memoizedState=null,lt}function H2(lt,ht,gt){var xt=ht.pendingProps,Ct=(ht.flags&128)!==0;if(ht.flags&=-129,lt===null){if(Xa){if(xt.mode==="hidden")return lt=ls(ht,xt),ht.lanes=536870912,oc(null,lt);if(Il(ht),(lt=dn)?(lt=h0(lt,mi),lt=lt!==null&&lt.data==="&"?lt:null,lt!==null&&(ht.memoizedState={dehydrated:lt,treeContext:er!==null?{id:Si,overflow:$i}:null,retryLane:536870912,hydrationErrors:null},gt=Dd(lt),gt.return=ht,ht.child=gt,Dn=ht,dn=null)):lt=null,lt===null)throw ar(ht);return ht.lanes=536870912,null}return ls(ht,xt)}var Lt=lt.memoizedState;if(Lt!==null){var Dt=Lt.dehydrated;if(Il(ht),Ct)if(ht.flags&256)ht.flags&=-257,ht=eh(lt,ht,gt);else if(ht.memoizedState!==null)ht.child=lt.child,ht.flags|=128,ht=null;else throw Error(dt(558));else if(Nn||eo(lt,ht,gt,!1),Ct=(gt&lt.childLanes)!==0,Nn||Ct){if(xt=ln,xt!==null&&(Dt=wc(xt,gt),Dt!==0&&Dt!==Lt.retryLane))throw Lt.retryLane=Dt,Lr(lt,Dt),Qn(xt,lt,Dt),Kl;xs(),ht=eh(lt,ht,gt)}else lt=Lt.treeContext,dn=_i(Dt.nextSibling),Dn=ht,Xa=!0,tr=null,mi=!1,lt!==null&&qd(ht,lt),ht=ls(ht,xt),ht.flags|=4096;return ht}return lt=Di(lt.child,{mode:xt.mode,children:xt.children}),lt.ref=ht.ref,ht.child=lt,lt.return=ht,lt}function ds(lt,ht){var gt=ht.ref;if(gt===null)lt!==null&&lt.ref!==null&&(ht.flags|=4194816);else{if(typeof gt!="function"&&typeof gt!="object")throw Error(dt(284));(lt===null||lt.ref!==gt)&&(ht.flags|=4194816)}}function Ql(lt,ht,gt,xt,Ct){return Ir(ht),gt=Tl(lt,ht,gt,xt,void 0,Ct),xt=El(),lt!==null&&!Nn?(Rl(lt,ht,Ct),Hi(lt,ht,Ct)):(Xa&&xt&&pl(ht),ht.flags|=1,Fn(lt,ht,gt,Ct),ht.child)}function th(lt,ht,gt,xt,Ct,Lt){return Ir(ht),ht.updateQueue=null,gt=nu(ht,xt,gt,Ct),au(lt),xt=El(),lt!==null&&!Nn?(Rl(lt,ht,Lt),Hi(lt,ht,Lt)):(Xa&&xt&&pl(ht),ht.flags|=1,Fn(lt,ht,gt,Lt),ht.child)}function ah(lt,ht,gt,xt,Ct){if(Ir(ht),ht.stateNode===null){var Lt=Zr,Dt=gt.contextType;typeof Dt=="object"&&Dt!==null&&(Lt=Pn(Dt)),Lt=new gt(xt,Lt),ht.memoizedState=Lt.state!==null&&Lt.state!==void 0?Lt.state:null,Lt.updater=Xl,ht.stateNode=Lt,Lt._reactInternals=ht,Lt=ht.stateNode,Lt.props=xt,Lt.state=ht.memoizedState,Lt.refs={},Ml(ht),Dt=gt.contextType,Lt.context=typeof Dt=="object"&&Dt!==null?Pn(Dt):Zr,Lt.state=ht.memoizedState,Dt=gt.getDerivedStateFromProps,typeof Dt=="function"&&(Yl(ht,gt,Dt,xt),Lt.state=ht.memoizedState),typeof gt.getDerivedStateFromProps=="function"||typeof Lt.getSnapshotBeforeUpdate=="function"||typeof Lt.UNSAFE_componentWillMount!="function"&&typeof Lt.componentWillMount!="function"||(Dt=Lt.state,typeof Lt.componentWillMount=="function"&&Lt.componentWillMount(),typeof Lt.UNSAFE_componentWillMount=="function"&&Lt.UNSAFE_componentWillMount(),Dt!==Lt.state&&Xl.enqueueReplaceState(Lt,Lt.state,null),tc(ht,xt,Lt,Ct),ec(),Lt.state=ht.memoizedState),typeof Lt.componentDidMount=="function"&&(ht.flags|=4194308),xt=!0}else if(lt===null){Lt=ht.stateNode;var zt=ht.memoizedProps,Jt=Dr(gt,zt);Lt.props=Jt;var ha=Lt.context,va=gt.contextType;Dt=Zr,typeof va=="object"&&va!==null&&(Dt=Pn(va));var wa=gt.getDerivedStateFromProps;va=typeof wa=="function"||typeof Lt.getSnapshotBeforeUpdate=="function",zt=ht.pendingProps!==zt,va||typeof Lt.UNSAFE_componentWillReceiveProps!="function"&&typeof Lt.componentWillReceiveProps!="function"||(zt||ha!==Dt)&&zu(ht,Lt,xt,Dt),ir=!1;var ya=ht.memoizedState;Lt.state=ya,tc(ht,xt,Lt,Ct),ec(),ha=ht.memoizedState,zt||ya!==ha||ir?(typeof wa=="function"&&(Yl(ht,gt,wa,xt),ha=ht.memoizedState),(Jt=ir||Ou(ht,gt,Jt,xt,ya,ha,Dt))?(va||typeof Lt.UNSAFE_componentWillMount!="function"&&typeof Lt.componentWillMount!="function"||(typeof Lt.componentWillMount=="function"&&Lt.componentWillMount(),typeof Lt.UNSAFE_componentWillMount=="function"&&Lt.UNSAFE_componentWillMount()),typeof Lt.componentDidMount=="function"&&(ht.flags|=4194308)):(typeof Lt.componentDidMount=="function"&&(ht.flags|=4194308),ht.memoizedProps=xt,ht.memoizedState=ha),Lt.props=xt,Lt.state=ha,Lt.context=Dt,xt=Jt):(typeof Lt.componentDidMount=="function"&&(ht.flags|=4194308),xt=!1)}else{Lt=ht.stateNode,wl(lt,ht),Dt=ht.memoizedProps,va=Dr(gt,Dt),Lt.props=va,wa=ht.pendingProps,ya=Lt.context,ha=gt.contextType,Jt=Zr,typeof ha=="object"&&ha!==null&&(Jt=Pn(ha)),zt=gt.getDerivedStateFromProps,(ha=typeof zt=="function"||typeof Lt.getSnapshotBeforeUpdate=="function")||typeof Lt.UNSAFE_componentWillReceiveProps!="function"&&typeof Lt.componentWillReceiveProps!="function"||(Dt!==wa||ya!==Jt)&&zu(ht,Lt,xt,Jt),ir=!1,ya=ht.memoizedState,Lt.state=ya,tc(ht,xt,Lt,Ct),ec();var ga=ht.memoizedState;Dt!==wa||ya!==ga||ir||lt!==null&&lt.dependencies!==null&&Vc(lt.dependencies)?(typeof zt=="function"&&(Yl(ht,gt,zt,xt),ga=ht.memoizedState),(va=ir||Ou(ht,gt,va,xt,ya,ga,Jt)||lt!==null&&lt.dependencies!==null&&Vc(lt.dependencies))?(ha||typeof Lt.UNSAFE_componentWillUpdate!="function"&&typeof Lt.componentWillUpdate!="function"||(typeof Lt.componentWillUpdate=="function"&&Lt.componentWillUpdate(xt,ga,Jt),typeof Lt.UNSAFE_componentWillUpdate=="function"&&Lt.UNSAFE_componentWillUpdate(xt,ga,Jt)),typeof Lt.componentDidUpdate=="function"&&(ht.flags|=4),typeof Lt.getSnapshotBeforeUpdate=="function"&&(ht.flags|=1024)):(typeof Lt.componentDidUpdate!="function"||Dt===lt.memoizedProps&&ya===lt.memoizedState||(ht.flags|=4),typeof Lt.getSnapshotBeforeUpdate!="function"||Dt===lt.memoizedProps&&ya===lt.memoizedState||(ht.flags|=1024),ht.memoizedProps=xt,ht.memoizedState=ga),Lt.props=xt,Lt.state=ga,Lt.context=Jt,xt=va):(typeof Lt.componentDidUpdate!="function"||Dt===lt.memoizedProps&&ya===lt.memoizedState||(ht.flags|=4),typeof Lt.getSnapshotBeforeUpdate!="function"||Dt===lt.memoizedProps&&ya===lt.memoizedState||(ht.flags|=1024),xt=!1)}return Lt=xt,ds(lt,ht),xt=(ht.flags&128)!==0,Lt||xt?(Lt=ht.stateNode,gt=xt&&typeof gt.getDerivedStateFromError!="function"?null:Lt.render(),ht.flags|=1,lt!==null&&xt?(ht.child=Rr(ht,lt.child,null,Ct),ht.child=Rr(ht,null,gt,Ct)):Fn(lt,ht,gt,Ct),ht.memoizedState=Lt.state,lt=ht.child):lt=Hi(lt,ht,Ct),lt}function nh(lt,ht,gt,xt){return $r(),ht.flags|=256,Fn(lt,ht,gt,xt),ht.child}var Jl={dehydrated:null,treeContext:null,retryLane:0,hydrationErrors:null};function e1(lt){return{baseLanes:lt,cachePool:Vd()}}function t1(lt,ht,gt){return lt=lt!==null?lt.childLanes&~gt:0,ht&&(lt|=oi),lt}function ih(lt,ht,gt){var xt=ht.pendingProps,Ct=!1,Lt=(ht.flags&128)!==0,Dt;if((Dt=Lt)||(Dt=lt!==null&&lt.memoizedState===null?!1:(bn.current&2)!==0),Dt&&(Ct=!0,ht.flags&=-129),Dt=(ht.flags&32)!==0,ht.flags&=-33,lt===null){if(Xa){if(Ct?cr(ht):sr(),(lt=dn)?(lt=h0(lt,mi),lt=lt!==null&&lt.data!=="&"?lt:null,lt!==null&&(ht.memoizedState={dehydrated:lt,treeContext:er!==null?{id:Si,overflow:$i}:null,retryLane:536870912,hydrationErrors:null},gt=Dd(lt),gt.return=ht,ht.child=gt,Dn=ht,dn=null)):lt=null,lt===null)throw ar(ht);return P1(lt)?ht.lanes=32:ht.lanes=536870912,null}var zt=xt.children;return xt=xt.fallback,Ct?(sr(),Ct=ht.mode,zt=us({mode:"hidden",children:zt},Ct),xt=Sr(xt,Ct,gt,null),zt.return=ht,xt.return=ht,zt.sibling=xt,ht.child=zt,xt=ht.child,xt.memoizedState=e1(gt),xt.childLanes=t1(lt,Dt,gt),ht.memoizedState=Jl,oc(null,xt)):(cr(ht),a1(ht,zt))}var Jt=lt.memoizedState;if(Jt!==null&&(zt=Jt.dehydrated,zt!==null)){if(Lt)ht.flags&256?(cr(ht),ht.flags&=-257,ht=n1(lt,ht,gt)):ht.memoizedState!==null?(sr(),ht.child=lt.child,ht.flags|=128,ht=null):(sr(),zt=xt.fallback,Ct=ht.mode,xt=us({mode:"visible",children:xt.children},Ct),zt=Sr(zt,Ct,gt,null),zt.flags|=2,xt.return=ht,zt.return=ht,xt.sibling=zt,ht.child=xt,Rr(ht,lt.child,null,gt),xt=ht.child,xt.memoizedState=e1(gt),xt.childLanes=t1(lt,Dt,gt),ht.memoizedState=Jl,ht=oc(null,xt));else if(cr(ht),P1(zt)){if(Dt=zt.nextSibling&&zt.nextSibling.dataset,Dt)var ha=Dt.dgst;Dt=ha,xt=Error(dt(419)),xt.stack="",xt.digest=Dt,Yo({value:xt,source:null,stack:null}),ht=n1(lt,ht,gt)}else if(Nn||eo(lt,ht,gt,!1),Dt=(gt&lt.childLanes)!==0,Nn||Dt){if(Dt=ln,Dt!==null&&(xt=wc(Dt,gt),xt!==0&&xt!==Jt.retryLane))throw Jt.retryLane=xt,Lr(lt,xt),Qn(Dt,lt,xt),Kl;D1(zt)||xs(),ht=n1(lt,ht,gt)}else D1(zt)?(ht.flags|=192,ht.child=lt.child,ht=null):(lt=Jt.treeContext,dn=_i(zt.nextSibling),Dn=ht,Xa=!0,tr=null,mi=!1,lt!==null&&qd(ht,lt),ht=a1(ht,xt.children),ht.flags|=4096);return ht}return Ct?(sr(),zt=xt.fallback,Ct=ht.mode,Jt=lt.child,ha=Jt.sibling,xt=Di(Jt,{mode:"hidden",children:xt.children}),xt.subtreeFlags=Jt.subtreeFlags&65011712,ha!==null?zt=Di(ha,zt):(zt=Sr(zt,Ct,gt,null),zt.flags|=2),zt.return=ht,xt.return=ht,xt.sibling=zt,ht.child=xt,oc(null,xt),xt=ht.child,zt=lt.child.memoizedState,zt===null?zt=e1(gt):(Ct=zt.cachePool,Ct!==null?(Jt=Sn._currentValue,Ct=Ct.parent!==Jt?{parent:Jt,pool:Jt}:Ct):Ct=Vd(),zt={baseLanes:zt.baseLanes|gt,cachePool:Ct}),xt.memoizedState=zt,xt.childLanes=t1(lt,Dt,gt),ht.memoizedState=Jl,oc(lt.child,xt)):(cr(ht),gt=lt.child,lt=gt.sibling,gt=Di(gt,{mode:"visible",children:xt.children}),gt.return=ht,gt.sibling=null,lt!==null&&(Dt=ht.deletions,Dt===null?(ht.deletions=[lt],ht.flags|=16):Dt.push(lt)),ht.child=gt,ht.memoizedState=null,gt)}function a1(lt,ht){return ht=us({mode:"visible",children:ht},lt.mode),ht.return=lt,lt.child=ht}function us(lt,ht){return lt=ai(22,lt,null,ht),lt.lanes=0,lt}function n1(lt,ht,gt){return Rr(ht,lt.child,null,gt),lt=a1(ht,ht.pendingProps.children),lt.flags|=2,ht.memoizedState=null,lt}function rh(lt,ht,gt){lt.lanes|=ht;var xt=lt.alternate;xt!==null&&(xt.lanes|=ht),kl(lt.return,ht,gt)}function i1(lt,ht,gt,xt,Ct,Lt){var Dt=lt.memoizedState;Dt===null?lt.memoizedState={isBackwards:ht,rendering:null,renderingStartTime:0,last:xt,tail:gt,tailMode:Ct,treeForkCount:Lt}:(Dt.isBackwards=ht,Dt.rendering=null,Dt.renderingStartTime=0,Dt.last=xt,Dt.tail=gt,Dt.tailMode=Ct,Dt.treeForkCount=Lt)}function oh(lt,ht,gt){var xt=ht.pendingProps,Ct=xt.revealOrder,Lt=xt.tail;xt=xt.children;var Dt=bn.current,zt=(Dt&2)!==0;if(zt?(Dt=Dt&1|2,ht.flags|=128):Dt&=1,sa(bn,Dt),Fn(lt,ht,xt,gt),xt=Xa?Wo:0,!zt&&lt!==null&&(lt.flags&128)!==0)e:for(lt=ht.child;lt!==null;){if(lt.tag===13)lt.memoizedState!==null&&rh(lt,gt,ht);else if(lt.tag===19)rh(lt,gt,ht);else if(lt.child!==null){lt.child.return=lt,lt=lt.child;continue}if(lt===ht)break e;for(;lt.sibling===null;){if(lt.return===null||lt.return===ht)break e;lt=lt.return}lt.sibling.return=lt.return,lt=lt.sibling}switch(Ct){case"forwards":for(gt=ht.child,Ct=null;gt!==null;)lt=gt.alternate,lt!==null&&Jc(lt)===null&&(Ct=gt),gt=gt.sibling;gt=Ct,gt===null?(Ct=ht.child,ht.child=null):(Ct=gt.sibling,gt.sibling=null),i1(ht,!1,Ct,gt,Lt,xt);break;case"backwards":case"unstable_legacy-backwards":for(gt=null,Ct=ht.child,ht.child=null;Ct!==null;){if(lt=Ct.alternate,lt!==null&&Jc(lt)===null){ht.child=Ct;break}lt=Ct.sibling,Ct.sibling=gt,gt=Ct,Ct=lt}i1(ht,!0,gt,null,Lt,xt);break;case"together":i1(ht,!1,null,null,void 0,xt);break;default:ht.memoizedState=null}return ht.child}function Hi(lt,ht,gt){if(lt!==null&&(ht.dependencies=lt.dependencies),ur|=ht.lanes,(gt&ht.childLanes)===0)if(lt!==null){if(eo(lt,ht,gt,!1),(gt&ht.childLanes)===0)return null}else return null;if(lt!==null&&ht.child!==lt.child)throw Error(dt(153));if(ht.child!==null){for(lt=ht.child,gt=Di(lt,lt.pendingProps),ht.child=gt,gt.return=ht;lt.sibling!==null;)lt=lt.sibling,gt=gt.sibling=Di(lt,lt.pendingProps),gt.return=ht;gt.sibling=null}return ht.child}function r1(lt,ht){return(lt.lanes&ht)!==0?!0:(lt=lt.dependencies,!!(lt!==null&&Vc(lt)))}function U2(lt,ht,gt){switch(ht.tag){case 3:Fa(ht,ht.stateNode.containerInfo),nr(ht,Sn,lt.memoizedState.cache),$r();break;case 27:case 5:Ha(ht);break;case 4:Fa(ht,ht.stateNode.containerInfo);break;case 10:nr(ht,ht.type,ht.memoizedProps.value);break;case 31:if(ht.memoizedState!==null)return ht.flags|=128,Il(ht),null;break;case 13:var xt=ht.memoizedState;if(xt!==null)return xt.dehydrated!==null?(cr(ht),ht.flags|=128,null):(gt&ht.child.childLanes)!==0?ih(lt,ht,gt):(cr(ht),lt=Hi(lt,ht,gt),lt!==null?lt.sibling:null);cr(ht);break;case 19:var Ct=(lt.flags&128)!==0;if(xt=(gt&ht.childLanes)!==0,xt||(eo(lt,ht,gt,!1),xt=(gt&ht.childLanes)!==0),Ct){if(xt)return oh(lt,ht,gt);ht.flags|=128}if(Ct=ht.memoizedState,Ct!==null&&(Ct.rendering=null,Ct.tail=null,Ct.lastEffect=null),sa(bn,bn.current),xt)break;return null;case 22:return ht.lanes=0,Qu(lt,ht,gt,ht.pendingProps);case 24:nr(ht,Sn,lt.memoizedState.cache)}return Hi(lt,ht,gt)}function ch(lt,ht,gt){if(lt!==null)if(lt.memoizedProps!==ht.pendingProps)Nn=!0;else{if(!r1(lt,gt)&&(ht.flags&128)===0)return Nn=!1,U2(lt,ht,gt);Nn=(lt.flags&131072)!==0}else Nn=!1,Xa&&(ht.flags&1048576)!==0&&Fd(ht,Wo,ht.index);switch(ht.lanes=0,ht.tag){case 16:e:{var xt=ht.pendingProps;if(lt=Tr(ht.elementType),ht.type=lt,typeof lt=="function")dl(lt)?(xt=Dr(lt,xt),ht.tag=1,ht=ah(null,ht,lt,xt,gt)):(ht.tag=0,ht=Ql(null,ht,lt,xt,gt));else{if(lt!=null){var Ct=lt.$$typeof;if(Ct===Ft){ht.tag=11,ht=Xu(null,ht,lt,xt,gt);break e}else if(Ct===Ot){ht.tag=14,ht=Zu(null,ht,lt,xt,gt);break e}}throw ht=Kt(lt)||lt,Error(dt(306,ht,""))}}return ht;case 0:return Ql(lt,ht,ht.type,ht.pendingProps,gt);case 1:return xt=ht.type,Ct=Dr(xt,ht.pendingProps),ah(lt,ht,xt,Ct,gt);case 3:e:{if(Fa(ht,ht.stateNode.containerInfo),lt===null)throw Error(dt(387));xt=ht.pendingProps;var Lt=ht.memoizedState;Ct=Lt.element,wl(lt,ht),tc(ht,xt,null,gt);var Dt=ht.memoizedState;if(xt=Dt.cache,nr(ht,Sn,xt),xt!==Lt.cache&&_l(ht,[Sn],gt,!0),ec(),xt=Dt.element,Lt.isDehydrated)if(Lt={element:xt,isDehydrated:!1,cache:Dt.cache},ht.updateQueue.baseState=Lt,ht.memoizedState=Lt,ht.flags&256){ht=nh(lt,ht,xt,gt);break e}else if(xt!==Ct){Ct=fi(Error(dt(424)),ht),Yo(Ct),ht=nh(lt,ht,xt,gt);break e}else{switch(lt=ht.stateNode.containerInfo,lt.nodeType){case 9:lt=lt.body;break;default:lt=lt.nodeName==="HTML"?lt.ownerDocument.body:lt}for(dn=_i(lt.firstChild),Dn=ht,Xa=!0,tr=null,mi=!0,gt=Kd(ht,null,xt,gt),ht.child=gt;gt;)gt.flags=gt.flags&-3|4096,gt=gt.sibling}else{if($r(),xt===Ct){ht=Hi(lt,ht,gt);break e}Fn(lt,ht,xt,gt)}ht=ht.child}return ht;case 26:return ds(lt,ht),lt===null?(gt=k0(ht.type,null,ht.pendingProps,null))?ht.memoizedState=gt:Xa||(gt=ht.type,lt=ht.pendingProps,xt=Ss($a.current).createElement(gt),xt[Ln]=ht,xt[fn]=lt,qn(xt,gt,lt),Ua(xt),ht.stateNode=xt):ht.memoizedState=k0(ht.type,lt.memoizedProps,ht.pendingProps,lt.memoizedState),null;case 27:return Ha(ht),lt===null&&Xa&&(xt=ht.stateNode=y0(ht.type,ht.pendingProps,$a.current),Dn=ht,mi=!0,Ct=dn,gr(ht.type)?(F1=Ct,dn=_i(xt.firstChild)):dn=Ct),Fn(lt,ht,ht.pendingProps.children,gt),ds(lt,ht),lt===null&&(ht.flags|=4194304),ht.child;case 5:return lt===null&&Xa&&((Ct=xt=dn)&&(xt=xp(xt,ht.type,ht.pendingProps,mi),xt!==null?(ht.stateNode=xt,Dn=ht,dn=_i(xt.firstChild),mi=!1,Ct=!0):Ct=!1),Ct||ar(ht)),Ha(ht),Ct=ht.type,Lt=ht.pendingProps,Dt=lt!==null?lt.memoizedProps:null,xt=Lt.children,E1(Ct,Lt)?xt=null:Dt!==null&&E1(Ct,Dt)&&(ht.flags|=32),ht.memoizedState!==null&&(Ct=Tl(lt,ht,B2,null,null,gt),vc._currentValue=Ct),ds(lt,ht),Fn(lt,ht,xt,gt),ht.child;case 6:return lt===null&&Xa&&((lt=gt=dn)&&(gt=vp(gt,ht.pendingProps,mi),gt!==null?(ht.stateNode=gt,Dn=ht,dn=null,lt=!0):lt=!1),lt||ar(ht)),null;case 13:return ih(lt,ht,gt);case 4:return Fa(ht,ht.stateNode.containerInfo),xt=ht.pendingProps,lt===null?ht.child=Rr(ht,null,xt,gt):Fn(lt,ht,xt,gt),ht.child;case 11:return Xu(lt,ht,ht.type,ht.pendingProps,gt);case 7:return Fn(lt,ht,ht.pendingProps,gt),ht.child;case 8:return Fn(lt,ht,ht.pendingProps.children,gt),ht.child;case 12:return Fn(lt,ht,ht.pendingProps.children,gt),ht.child;case 10:return xt=ht.pendingProps,nr(ht,ht.type,xt.value),Fn(lt,ht,xt.children,gt),ht.child;case 9:return Ct=ht.type._context,xt=ht.pendingProps.children,Ir(ht),Ct=Pn(Ct),xt=xt(Ct),ht.flags|=1,Fn(lt,ht,xt,gt),ht.child;case 14:return Zu(lt,ht,ht.type,ht.pendingProps,gt);case 15:return Ku(lt,ht,ht.type,ht.pendingProps,gt);case 19:return oh(lt,ht,gt);case 31:return H2(lt,ht,gt);case 22:return Qu(lt,ht,gt,ht.pendingProps);case 24:return Ir(ht),xt=Pn(Sn),lt===null?(Ct=bl(),Ct===null&&(Ct=ln,Lt=xl(),Ct.pooledCache=Lt,Lt.refCount++,Lt!==null&&(Ct.pooledCacheLanes|=gt),Ct=Lt),ht.memoizedState={parent:xt,cache:Ct},Ml(ht),nr(ht,Sn,Ct)):((lt.lanes&gt)!==0&&(wl(lt,ht),tc(ht,null,null,gt),ec()),Ct=lt.memoizedState,Lt=ht.memoizedState,Ct.parent!==xt?(Ct={parent:xt,cache:xt},ht.memoizedState=Ct,ht.lanes===0&&(ht.memoizedState=ht.updateQueue.baseState=Ct),nr(ht,Sn,xt)):(xt=Lt.cache,nr(ht,Sn,xt),xt!==Ct.cache&&_l(ht,[Sn],gt,!0))),Fn(lt,ht,ht.pendingProps.children,gt),ht.child;case 29:throw ht.pendingProps}throw Error(dt(156,ht.tag))}function Ui(lt){lt.flags|=4}function o1(lt,ht,gt,xt,Ct){if((ht=(lt.mode&32)!==0)&&(ht=!1),ht){if(lt.flags|=16777216,(Ct&335544128)===Ct)if(lt.stateNode.complete)lt.flags|=8192;else if(Rh())lt.flags|=8192;else throw Er=Xc,Cl}else lt.flags&=-16777217}function sh(lt,ht){if(ht.type!=="stylesheet"||(ht.state.loading&4)!==0)lt.flags&=-16777217;else if(lt.flags|=16777216,!C0(ht))if(Rh())lt.flags|=8192;else throw Er=Xc,Cl}function hs(lt,ht){ht!==null&&(lt.flags|=4),lt.flags&16384&&(ht=lt.tag!==22?Ai():536870912,lt.lanes|=ht,po|=ht)}function cc(lt,ht){if(!Xa)switch(lt.tailMode){case"hidden":ht=lt.tail;for(var gt=null;ht!==null;)ht.alternate!==null&&(gt=ht),ht=ht.sibling;gt===null?lt.tail=null:gt.sibling=null;break;case"collapsed":gt=lt.tail;for(var xt=null;gt!==null;)gt.alternate!==null&&(xt=gt),gt=gt.sibling;xt===null?ht||lt.tail===null?lt.tail=null:lt.tail.sibling=null:xt.sibling=null}}function un(lt){var ht=lt.alternate!==null&&lt.alternate.child===lt.child,gt=0,xt=0;if(ht)for(var Ct=lt.child;Ct!==null;)gt|=Ct.lanes|Ct.childLanes,xt|=Ct.subtreeFlags&65011712,xt|=Ct.flags&65011712,Ct.return=lt,Ct=Ct.sibling;else for(Ct=lt.child;Ct!==null;)gt|=Ct.lanes|Ct.childLanes,xt|=Ct.subtreeFlags,xt|=Ct.flags,Ct.return=lt,Ct=Ct.sibling;return lt.subtreeFlags|=xt,lt.childLanes=gt,ht}function V2(lt,ht,gt){var xt=ht.pendingProps;switch(fl(ht),ht.tag){case 16:case 15:case 0:case 11:case 7:case 8:case 12:case 9:case 14:return un(ht),null;case 1:return un(ht),null;case 3:return gt=ht.stateNode,xt=null,lt!==null&&(xt=lt.memoizedState.cache),ht.memoizedState.cache!==xt&&(ht.flags|=2048),ji(Sn),qa(),gt.pendingContext&&(gt.context=gt.pendingContext,gt.pendingContext=null),(lt===null||lt.child===null)&&(Jr(ht)?Ui(ht):lt===null||lt.memoizedState.isDehydrated&&(ht.flags&256)===0||(ht.flags|=1024,gl())),un(ht),null;case 26:var Ct=ht.type,Lt=ht.memoizedState;return lt===null?(Ui(ht),Lt!==null?(un(ht),sh(ht,Lt)):(un(ht),o1(ht,Ct,null,xt,gt))):Lt?Lt!==lt.memoizedState?(Ui(ht),un(ht),sh(ht,Lt)):(un(ht),ht.flags&=-16777217):(lt=lt.memoizedProps,lt!==xt&&Ui(ht),un(ht),o1(ht,Ct,lt,xt,gt)),null;case 27:if(rn(ht),gt=$a.current,Ct=ht.type,lt!==null&&ht.stateNode!=null)lt.memoizedProps!==xt&&Ui(ht);else{if(!xt){if(ht.stateNode===null)throw Error(dt(166));return un(ht),null}lt=xa.current,Jr(ht)?jd(ht):(lt=y0(Ct,xt,gt),ht.stateNode=lt,Ui(ht))}return un(ht),null;case 5:if(rn(ht),Ct=ht.type,lt!==null&&ht.stateNode!=null)lt.memoizedProps!==xt&&Ui(ht);else{if(!xt){if(ht.stateNode===null)throw Error(dt(166));return un(ht),null}if(Lt=xa.current,Jr(ht))jd(ht);else{var Dt=Ss($a.current);switch(Lt){case 1:Lt=Dt.createElementNS("http://www.w3.org/2000/svg",Ct);break;case 2:Lt=Dt.createElementNS("http://www.w3.org/1998/Math/MathML",Ct);break;default:switch(Ct){case"svg":Lt=Dt.createElementNS("http://www.w3.org/2000/svg",Ct);break;case"math":Lt=Dt.createElementNS("http://www.w3.org/1998/Math/MathML",Ct);break;case"script":Lt=Dt.createElement("div"),Lt.innerHTML="<script><\/script>",Lt=Lt.removeChild(Lt.firstChild);break;case"select":Lt=typeof xt.is=="string"?Dt.createElement("select",{is:xt.is}):Dt.createElement("select"),xt.multiple?Lt.multiple=!0:xt.size&&(Lt.size=xt.size);break;default:Lt=typeof xt.is=="string"?Dt.createElement(Ct,{is:xt.is}):Dt.createElement(Ct)}}Lt[Ln]=ht,Lt[fn]=xt;e:for(Dt=ht.child;Dt!==null;){if(Dt.tag===5||Dt.tag===6)Lt.appendChild(Dt.stateNode);else if(Dt.tag!==4&&Dt.tag!==27&&Dt.child!==null){Dt.child.return=Dt,Dt=Dt.child;continue}if(Dt===ht)break e;for(;Dt.sibling===null;){if(Dt.return===null||Dt.return===ht)break e;Dt=Dt.return}Dt.sibling.return=Dt.return,Dt=Dt.sibling}ht.stateNode=Lt;e:switch(qn(Lt,Ct,xt),Ct){case"button":case"input":case"select":case"textarea":xt=!!xt.autoFocus;break e;case"img":xt=!0;break e;default:xt=!1}xt&&Ui(ht)}}return un(ht),o1(ht,ht.type,lt===null?null:lt.memoizedProps,ht.pendingProps,gt),null;case 6:if(lt&&ht.stateNode!=null)lt.memoizedProps!==xt&&Ui(ht);else{if(typeof xt!="string"&&ht.stateNode===null)throw Error(dt(166));if(lt=$a.current,Jr(ht)){if(lt=ht.stateNode,gt=ht.memoizedProps,xt=null,Ct=Dn,Ct!==null)switch(Ct.tag){case 27:case 5:xt=Ct.memoizedProps}lt[Ln]=ht,lt=!!(lt.nodeValue===gt||xt!==null&&xt.suppressHydrationWarning===!0||i0(lt.nodeValue,gt)),lt||ar(ht,!0)}else lt=Ss(lt).createTextNode(xt),lt[Ln]=ht,ht.stateNode=lt}return un(ht),null;case 31:if(gt=ht.memoizedState,lt===null||lt.memoizedState!==null){if(xt=Jr(ht),gt!==null){if(lt===null){if(!xt)throw Error(dt(318));if(lt=ht.memoizedState,lt=lt!==null?lt.dehydrated:null,!lt)throw Error(dt(557));lt[Ln]=ht}else $r(),(ht.flags&128)===0&&(ht.memoizedState=null),ht.flags|=4;un(ht),lt=!1}else gt=gl(),lt!==null&&lt.memoizedState!==null&&(lt.memoizedState.hydrationErrors=gt),lt=!0;if(!lt)return ht.flags&256?(ii(ht),ht):(ii(ht),null);if((ht.flags&128)!==0)throw Error(dt(558))}return un(ht),null;case 13:if(xt=ht.memoizedState,lt===null||lt.memoizedState!==null&&lt.memoizedState.dehydrated!==null){if(Ct=Jr(ht),xt!==null&&xt.dehydrated!==null){if(lt===null){if(!Ct)throw Error(dt(318));if(Ct=ht.memoizedState,Ct=Ct!==null?Ct.dehydrated:null,!Ct)throw Error(dt(317));Ct[Ln]=ht}else $r(),(ht.flags&128)===0&&(ht.memoizedState=null),ht.flags|=4;un(ht),Ct=!1}else Ct=gl(),lt!==null&&lt.memoizedState!==null&&(lt.memoizedState.hydrationErrors=Ct),Ct=!0;if(!Ct)return ht.flags&256?(ii(ht),ht):(ii(ht),null)}return ii(ht),(ht.flags&128)!==0?(ht.lanes=gt,ht):(gt=xt!==null,lt=lt!==null&&lt.memoizedState!==null,gt&&(xt=ht.child,Ct=null,xt.alternate!==null&&xt.alternate.memoizedState!==null&&xt.alternate.memoizedState.cachePool!==null&&(Ct=xt.alternate.memoizedState.cachePool.pool),Lt=null,xt.memoizedState!==null&&xt.memoizedState.cachePool!==null&&(Lt=xt.memoizedState.cachePool.pool),Lt!==Ct&&(xt.flags|=2048)),gt!==lt&&gt&&(ht.child.flags|=8192),hs(ht,ht.updateQueue),un(ht),null);case 4:return qa(),lt===null&&$1(ht.stateNode.containerInfo),un(ht),null;case 10:return ji(ht.type),un(ht),null;case 19:if(ta(bn),xt=ht.memoizedState,xt===null)return un(ht),null;if(Ct=(ht.flags&128)!==0,Lt=xt.rendering,Lt===null)if(Ct)cc(xt,!1);else{if(xn!==0||lt!==null&&(lt.flags&128)!==0)for(lt=ht.child;lt!==null;){if(Lt=Jc(lt),Lt!==null){for(ht.flags|=128,cc(xt,!1),lt=Lt.updateQueue,ht.updateQueue=lt,hs(ht,lt),ht.subtreeFlags=0,lt=gt,gt=ht.child;gt!==null;)Bd(gt,lt),gt=gt.sibling;return sa(bn,bn.current&1|2),Xa&&Fi(ht,xt.treeForkCount),ht.child}lt=lt.sibling}xt.tail!==null&&pn()>ms&&(ht.flags|=128,Ct=!0,cc(xt,!1),ht.lanes=4194304)}else{if(!Ct)if(lt=Jc(Lt),lt!==null){if(ht.flags|=128,Ct=!0,lt=lt.updateQueue,ht.updateQueue=lt,hs(ht,lt),cc(xt,!0),xt.tail===null&&xt.tailMode==="hidden"&&!Lt.alternate&&!Xa)return un(ht),null}else 2*pn()-xt.renderingStartTime>ms&&gt!==536870912&&(ht.flags|=128,Ct=!0,cc(xt,!1),ht.lanes=4194304);xt.isBackwards?(Lt.sibling=ht.child,ht.child=Lt):(lt=xt.last,lt!==null?lt.sibling=Lt:ht.child=Lt,xt.last=Lt)}return xt.tail!==null?(lt=xt.tail,xt.rendering=lt,xt.tail=lt.sibling,xt.renderingStartTime=pn(),lt.sibling=null,gt=bn.current,sa(bn,Ct?gt&1|2:gt&1),Xa&&Fi(ht,xt.treeForkCount),lt):(un(ht),null);case 22:case 23:return ii(ht),Nl(),xt=ht.memoizedState!==null,lt!==null?lt.memoizedState!==null!==xt&&(ht.flags|=8192):xt&&(ht.flags|=8192),xt?(gt&536870912)!==0&&(ht.flags&128)===0&&(un(ht),ht.subtreeFlags&6&&(ht.flags|=8192)):un(ht),gt=ht.updateQueue,gt!==null&&hs(ht,gt.retryQueue),gt=null,lt!==null&&lt.memoizedState!==null&&lt.memoizedState.cachePool!==null&&(gt=lt.memoizedState.cachePool.pool),xt=null,ht.memoizedState!==null&&ht.memoizedState.cachePool!==null&&(xt=ht.memoizedState.cachePool.pool),xt!==gt&&(ht.flags|=2048),lt!==null&&ta(Ar),null;case 24:return gt=null,lt!==null&&(gt=lt.memoizedState.cache),ht.memoizedState.cache!==gt&&(ht.flags|=2048),ji(Sn),un(ht),null;case 25:return null;case 30:return null}throw Error(dt(156,ht.tag))}function G2(lt,ht){switch(fl(ht),ht.tag){case 1:return lt=ht.flags,lt&65536?(ht.flags=lt&-65537|128,ht):null;case 3:return ji(Sn),qa(),lt=ht.flags,(lt&65536)!==0&&(lt&128)===0?(ht.flags=lt&-65537|128,ht):null;case 26:case 27:case 5:return rn(ht),null;case 31:if(ht.memoizedState!==null){if(ii(ht),ht.alternate===null)throw Error(dt(340));$r()}return lt=ht.flags,lt&65536?(ht.flags=lt&-65537|128,ht):null;case 13:if(ii(ht),lt=ht.memoizedState,lt!==null&&lt.dehydrated!==null){if(ht.alternate===null)throw Error(dt(340));$r()}return lt=ht.flags,lt&65536?(ht.flags=lt&-65537|128,ht):null;case 19:return ta(bn),null;case 4:return qa(),null;case 10:return ji(ht.type),null;case 22:case 23:return ii(ht),Nl(),lt!==null&&ta(Ar),lt=ht.flags,lt&65536?(ht.flags=lt&-65537|128,ht):null;case 24:return ji(Sn),null;case 25:return null;default:return null}}function lh(lt,ht){switch(fl(ht),ht.tag){case 3:ji(Sn),qa();break;case 26:case 27:case 5:rn(ht);break;case 4:qa();break;case 31:ht.memoizedState!==null&&ii(ht);break;case 13:ii(ht);break;case 19:ta(bn);break;case 10:ji(ht.type);break;case 22:case 23:ii(ht),Nl(),lt!==null&&ta(Ar);break;case 24:ji(Sn)}}function sc(lt,ht){try{var gt=ht.updateQueue,xt=gt!==null?gt.lastEffect:null;if(xt!==null){var Ct=xt.next;gt=Ct;do{if((gt.tag&lt)===lt){xt=void 0;var Lt=gt.create,Dt=gt.inst;xt=Lt(),Dt.destroy=xt}gt=gt.next}while(gt!==Ct)}}catch(zt){nn(ht,ht.return,zt)}}function lr(lt,ht,gt){try{var xt=ht.updateQueue,Ct=xt!==null?xt.lastEffect:null;if(Ct!==null){var Lt=Ct.next;xt=Lt;do{if((xt.tag&lt)===lt){var Dt=xt.inst,zt=Dt.destroy;if(zt!==void 0){Dt.destroy=void 0,Ct=ht;var Jt=gt,ha=zt;try{ha()}catch(va){nn(Ct,Jt,va)}}}xt=xt.next}while(xt!==Lt)}}catch(va){nn(ht,ht.return,va)}}function dh(lt){var ht=lt.updateQueue;if(ht!==null){var gt=lt.stateNode;try{Jd(ht,gt)}catch(xt){nn(lt,lt.return,xt)}}}function uh(lt,ht,gt){gt.props=Dr(lt.type,lt.memoizedProps),gt.state=lt.memoizedState;try{gt.componentWillUnmount()}catch(xt){nn(lt,ht,xt)}}function lc(lt,ht){try{var gt=lt.ref;if(gt!==null){switch(lt.tag){case 26:case 27:case 5:var xt=lt.stateNode;break;case 30:xt=lt.stateNode;break;default:xt=lt.stateNode}typeof gt=="function"?lt.refCleanup=gt(xt):gt.current=xt}}catch(Ct){nn(lt,ht,Ct)}}function Ni(lt,ht){var gt=lt.ref,xt=lt.refCleanup;if(gt!==null)if(typeof xt=="function")try{xt()}catch(Ct){nn(lt,ht,Ct)}finally{lt.refCleanup=null,lt=lt.alternate,lt!=null&&(lt.refCleanup=null)}else if(typeof gt=="function")try{gt(null)}catch(Ct){nn(lt,ht,Ct)}else gt.current=null}function hh(lt){var ht=lt.type,gt=lt.memoizedProps,xt=lt.stateNode;try{e:switch(ht){case"button":case"input":case"select":case"textarea":gt.autoFocus&&xt.focus();break e;case"img":gt.src?xt.src=gt.src:gt.srcSet&&(xt.srcset=gt.srcSet)}}catch(Ct){nn(lt,lt.return,Ct)}}function c1(lt,ht,gt){try{var xt=lt.stateNode;fp(xt,lt.type,gt,ht),xt[fn]=ht}catch(Ct){nn(lt,lt.return,Ct)}}function ph(lt){return lt.tag===5||lt.tag===3||lt.tag===26||lt.tag===27&&gr(lt.type)||lt.tag===4}function s1(lt){e:for(;;){for(;lt.sibling===null;){if(lt.return===null||ph(lt.return))return null;lt=lt.return}for(lt.sibling.return=lt.return,lt=lt.sibling;lt.tag!==5&&lt.tag!==6&&lt.tag!==18;){if(lt.tag===27&&gr(lt.type)||lt.flags&2||lt.child===null||lt.tag===4)continue e;lt.child.return=lt,lt=lt.child}if(!(lt.flags&2))return lt.stateNode}}function l1(lt,ht,gt){var xt=lt.tag;if(xt===5||xt===6)lt=lt.stateNode,ht?(gt.nodeType===9?gt.body:gt.nodeName==="HTML"?gt.ownerDocument.body:gt).insertBefore(lt,ht):(ht=gt.nodeType===9?gt.body:gt.nodeName==="HTML"?gt.ownerDocument.body:gt,ht.appendChild(lt),gt=gt._reactRootContainer,gt!=null||ht.onclick!==null||(ht.onclick=Ri));else if(xt!==4&&(xt===27&&gr(lt.type)&&(gt=lt.stateNode,ht=null),lt=lt.child,lt!==null))for(l1(lt,ht,gt),lt=lt.sibling;lt!==null;)l1(lt,ht,gt),lt=lt.sibling}function ps(lt,ht,gt){var xt=lt.tag;if(xt===5||xt===6)lt=lt.stateNode,ht?gt.insertBefore(lt,ht):gt.appendChild(lt);else if(xt!==4&&(xt===27&&gr(lt.type)&&(gt=lt.stateNode),lt=lt.child,lt!==null))for(ps(lt,ht,gt),lt=lt.sibling;lt!==null;)ps(lt,ht,gt),lt=lt.sibling}function fh(lt){var ht=lt.stateNode,gt=lt.memoizedProps;try{for(var xt=lt.type,Ct=ht.attributes;Ct.length;)ht.removeAttributeNode(Ct[0]);qn(ht,xt,gt),ht[Ln]=lt,ht[fn]=gt}catch(Lt){nn(lt,lt.return,Lt)}}var Vi=!1,In=!1,d1=!1,yh=typeof WeakSet=="function"?WeakSet:Set,Rn=null;function W2(lt,ht){if(lt=lt.containerInfo,A1=Rs,lt=Ld(lt),nl(lt)){if("selectionStart"in lt)var gt={start:lt.selectionStart,end:lt.selectionEnd};else e:{gt=(gt=lt.ownerDocument)&&gt.defaultView||window;var xt=gt.getSelection&&gt.getSelection();if(xt&&xt.rangeCount!==0){gt=xt.anchorNode;var Ct=xt.anchorOffset,Lt=xt.focusNode;xt=xt.focusOffset;try{gt.nodeType,Lt.nodeType}catch{gt=null;break e}var Dt=0,zt=-1,Jt=-1,ha=0,va=0,wa=lt,ya=null;t:for(;;){for(var ga;wa!==gt||Ct!==0&&wa.nodeType!==3||(zt=Dt+Ct),wa!==Lt||xt!==0&&wa.nodeType!==3||(Jt=Dt+xt),wa.nodeType===3&&(Dt+=wa.nodeValue.length),(ga=wa.firstChild)!==null;)ya=wa,wa=ga;for(;;){if(wa===lt)break t;if(ya===gt&&++ha===Ct&&(zt=Dt),ya===Lt&&++va===xt&&(Jt=Dt),(ga=wa.nextSibling)!==null)break;wa=ya,ya=wa.parentNode}wa=ga}gt=zt===-1||Jt===-1?null:{start:zt,end:Jt}}else gt=null}gt=gt||{start:0,end:0}}else gt=null;for(T1={focusedElem:lt,selectionRange:gt},Rs=!1,Rn=ht;Rn!==null;)if(ht=Rn,lt=ht.child,(ht.subtreeFlags&1028)!==0&&lt!==null)lt.return=ht,Rn=lt;else for(;Rn!==null;){switch(ht=Rn,Lt=ht.alternate,lt=ht.flags,ht.tag){case 0:if((lt&4)!==0&&(lt=ht.updateQueue,lt=lt!==null?lt.events:null,lt!==null))for(gt=0;gt<lt.length;gt++)Ct=lt[gt],Ct.ref.impl=Ct.nextImpl;break;case 11:case 15:break;case 1:if((lt&1024)!==0&&Lt!==null){lt=void 0,gt=ht,Ct=Lt.memoizedProps,Lt=Lt.memoizedState,xt=gt.stateNode;try{var Aa=Dr(gt.type,Ct);lt=xt.getSnapshotBeforeUpdate(Aa,Lt),xt.__reactInternalSnapshotBeforeUpdate=lt}catch(Da){nn(gt,gt.return,Da)}}break;case 3:if((lt&1024)!==0){if(lt=ht.stateNode.containerInfo,gt=lt.nodeType,gt===9)B1(lt);else if(gt===1)switch(lt.nodeName){case"HEAD":case"HTML":case"BODY":B1(lt);break;default:lt.textContent=""}}break;case 5:case 26:case 27:case 6:case 4:case 17:break;default:if((lt&1024)!==0)throw Error(dt(163))}if(lt=ht.sibling,lt!==null){lt.return=ht.return,Rn=lt;break}Rn=ht.return}}function gh(lt,ht,gt){var xt=gt.flags;switch(gt.tag){case 0:case 11:case 15:Wi(lt,gt),xt&4&&sc(5,gt);break;case 1:if(Wi(lt,gt),xt&4)if(lt=gt.stateNode,ht===null)try{lt.componentDidMount()}catch(Dt){nn(gt,gt.return,Dt)}else{var Ct=Dr(gt.type,ht.memoizedProps);ht=ht.memoizedState;try{lt.componentDidUpdate(Ct,ht,lt.__reactInternalSnapshotBeforeUpdate)}catch(Dt){nn(gt,gt.return,Dt)}}xt&64&&dh(gt),xt&512&&lc(gt,gt.return);break;case 3:if(Wi(lt,gt),xt&64&&(lt=gt.updateQueue,lt!==null)){if(ht=null,gt.child!==null)switch(gt.child.tag){case 27:case 5:ht=gt.child.stateNode;break;case 1:ht=gt.child.stateNode}try{Jd(lt,ht)}catch(Dt){nn(gt,gt.return,Dt)}}break;case 27:ht===null&&xt&4&&fh(gt);case 26:case 5:Wi(lt,gt),ht===null&&xt&4&&hh(gt),xt&512&&lc(gt,gt.return);break;case 12:Wi(lt,gt);break;case 31:Wi(lt,gt),xt&4&&_h(lt,gt);break;case 13:Wi(lt,gt),xt&4&&xh(lt,gt),xt&64&&(lt=gt.memoizedState,lt!==null&&(lt=lt.dehydrated,lt!==null&&(gt=ap.bind(null,gt),bp(lt,gt))));break;case 22:if(xt=gt.memoizedState!==null||Vi,!xt){ht=ht!==null&&ht.memoizedState!==null||In,Ct=Vi;var Lt=In;Vi=xt,(In=ht)&&!Lt?Yi(lt,gt,(gt.subtreeFlags&8772)!==0):Wi(lt,gt),Vi=Ct,In=Lt}break;case 30:break;default:Wi(lt,gt)}}function mh(lt){var ht=lt.alternate;ht!==null&&(lt.alternate=null,mh(ht)),lt.child=null,lt.deletions=null,lt.sibling=null,lt.tag===5&&(ht=lt.stateNode,ht!==null&&na(ht)),lt.stateNode=null,lt.return=null,lt.dependencies=null,lt.memoizedProps=null,lt.memoizedState=null,lt.pendingProps=null,lt.stateNode=null,lt.updateQueue=null}var yn=null,Yn=!1;function Gi(lt,ht,gt){for(gt=gt.child;gt!==null;)kh(lt,ht,gt),gt=gt.sibling}function kh(lt,ht,gt){if(da&&typeof da.onCommitFiberUnmount=="function")try{da.onCommitFiberUnmount(Xt,gt)}catch{}switch(gt.tag){case 26:In||Ni(gt,ht),Gi(lt,ht,gt),gt.memoizedState?gt.memoizedState.count--:gt.stateNode&&(gt=gt.stateNode,gt.parentNode.removeChild(gt));break;case 27:In||Ni(gt,ht);var xt=yn,Ct=Yn;gr(gt.type)&&(yn=gt.stateNode,Yn=!1),Gi(lt,ht,gt),kc(gt.stateNode),yn=xt,Yn=Ct;break;case 5:In||Ni(gt,ht);case 6:if(xt=yn,Ct=Yn,yn=null,Gi(lt,ht,gt),yn=xt,Yn=Ct,yn!==null)if(Yn)try{(yn.nodeType===9?yn.body:yn.nodeName==="HTML"?yn.ownerDocument.body:yn).removeChild(gt.stateNode)}catch(Lt){nn(gt,ht,Lt)}else try{yn.removeChild(gt.stateNode)}catch(Lt){nn(gt,ht,Lt)}break;case 18:yn!==null&&(Yn?(lt=yn,d0(lt.nodeType===9?lt.body:lt.nodeName==="HTML"?lt.ownerDocument.body:lt,gt.stateNode),vo(lt)):d0(yn,gt.stateNode));break;case 4:xt=yn,Ct=Yn,yn=gt.stateNode.containerInfo,Yn=!0,Gi(lt,ht,gt),yn=xt,Yn=Ct;break;case 0:case 11:case 14:case 15:lr(2,gt,ht),In||lr(4,gt,ht),Gi(lt,ht,gt);break;case 1:In||(Ni(gt,ht),xt=gt.stateNode,typeof xt.componentWillUnmount=="function"&&uh(gt,ht,xt)),Gi(lt,ht,gt);break;case 21:Gi(lt,ht,gt);break;case 22:In=(xt=In)||gt.memoizedState!==null,Gi(lt,ht,gt),In=xt;break;default:Gi(lt,ht,gt)}}function _h(lt,ht){if(ht.memoizedState===null&&(lt=ht.alternate,lt!==null&&(lt=lt.memoizedState,lt!==null))){lt=lt.dehydrated;try{vo(lt)}catch(gt){nn(ht,ht.return,gt)}}}function xh(lt,ht){if(ht.memoizedState===null&&(lt=ht.alternate,lt!==null&&(lt=lt.memoizedState,lt!==null&&(lt=lt.dehydrated,lt!==null))))try{vo(lt)}catch(gt){nn(ht,ht.return,gt)}}function Y2(lt){switch(lt.tag){case 31:case 13:case 19:var ht=lt.stateNode;return ht===null&&(ht=lt.stateNode=new yh),ht;case 22:return lt=lt.stateNode,ht=lt._retryCache,ht===null&&(ht=lt._retryCache=new yh),ht;default:throw Error(dt(435,lt.tag))}}function fs(lt,ht){var gt=Y2(lt);ht.forEach(function(xt){if(!gt.has(xt)){gt.add(xt);var Ct=np.bind(null,lt,xt);xt.then(Ct,Ct)}})}function Xn(lt,ht){var gt=ht.deletions;if(gt!==null)for(var xt=0;xt<gt.length;xt++){var Ct=gt[xt],Lt=lt,Dt=ht,zt=Dt;e:for(;zt!==null;){switch(zt.tag){case 27:if(gr(zt.type)){yn=zt.stateNode,Yn=!1;break e}break;case 5:yn=zt.stateNode,Yn=!1;break e;case 3:case 4:yn=zt.stateNode.containerInfo,Yn=!0;break e}zt=zt.return}if(yn===null)throw Error(dt(160));kh(Lt,Dt,Ct),yn=null,Yn=!1,Lt=Ct.alternate,Lt!==null&&(Lt.return=null),Ct.return=null}if(ht.subtreeFlags&13886)for(ht=ht.child;ht!==null;)vh(ht,lt),ht=ht.sibling}var Mi=null;function vh(lt,ht){var gt=lt.alternate,xt=lt.flags;switch(lt.tag){case 0:case 11:case 14:case 15:Xn(ht,lt),Zn(lt),xt&4&&(lr(3,lt,lt.return),sc(3,lt),lr(5,lt,lt.return));break;case 1:Xn(ht,lt),Zn(lt),xt&512&&(In||gt===null||Ni(gt,gt.return)),xt&64&&Vi&&(lt=lt.updateQueue,lt!==null&&(xt=lt.callbacks,xt!==null&&(gt=lt.shared.hiddenCallbacks,lt.shared.hiddenCallbacks=gt===null?xt:gt.concat(xt))));break;case 26:var Ct=Mi;if(Xn(ht,lt),Zn(lt),xt&512&&(In||gt===null||Ni(gt,gt.return)),xt&4){var Lt=gt!==null?gt.memoizedState:null;if(xt=lt.memoizedState,gt===null)if(xt===null)if(lt.stateNode===null){e:{xt=lt.type,gt=lt.memoizedProps,Ct=Ct.ownerDocument||Ct;t:switch(xt){case"title":Lt=Ct.getElementsByTagName("title")[0],(!Lt||Lt[Ta]||Lt[Ln]||Lt.namespaceURI==="http://www.w3.org/2000/svg"||Lt.hasAttribute("itemprop"))&&(Lt=Ct.createElement(xt),Ct.head.insertBefore(Lt,Ct.querySelector("head > title"))),qn(Lt,xt,gt),Lt[Ln]=lt,Ua(Lt),xt=Lt;break e;case"link":var Dt=v0("link","href",Ct).get(xt+(gt.href||""));if(Dt){for(var zt=0;zt<Dt.length;zt++)if(Lt=Dt[zt],Lt.getAttribute("href")===(gt.href==null||gt.href===""?null:gt.href)&&Lt.getAttribute("rel")===(gt.rel==null?null:gt.rel)&&Lt.getAttribute("title")===(gt.title==null?null:gt.title)&&Lt.getAttribute("crossorigin")===(gt.crossOrigin==null?null:gt.crossOrigin)){Dt.splice(zt,1);break t}}Lt=Ct.createElement(xt),qn(Lt,xt,gt),Ct.head.appendChild(Lt);break;case"meta":if(Dt=v0("meta","content",Ct).get(xt+(gt.content||""))){for(zt=0;zt<Dt.length;zt++)if(Lt=Dt[zt],Lt.getAttribute("content")===(gt.content==null?null:""+gt.content)&&Lt.getAttribute("name")===(gt.name==null?null:gt.name)&&Lt.getAttribute("property")===(gt.property==null?null:gt.property)&&Lt.getAttribute("http-equiv")===(gt.httpEquiv==null?null:gt.httpEquiv)&&Lt.getAttribute("charset")===(gt.charSet==null?null:gt.charSet)){Dt.splice(zt,1);break t}}Lt=Ct.createElement(xt),qn(Lt,xt,gt),Ct.head.appendChild(Lt);break;default:throw Error(dt(468,xt))}Lt[Ln]=lt,Ua(Lt),xt=Lt}lt.stateNode=xt}else b0(Ct,lt.type,lt.stateNode);else lt.stateNode=x0(Ct,xt,lt.memoizedProps);else Lt!==xt?(Lt===null?gt.stateNode!==null&&(gt=gt.stateNode,gt.parentNode.removeChild(gt)):Lt.count--,xt===null?b0(Ct,lt.type,lt.stateNode):x0(Ct,xt,lt.memoizedProps)):xt===null&&lt.stateNode!==null&&c1(lt,lt.memoizedProps,gt.memoizedProps)}break;case 27:Xn(ht,lt),Zn(lt),xt&512&&(In||gt===null||Ni(gt,gt.return)),gt!==null&&xt&4&&c1(lt,lt.memoizedProps,gt.memoizedProps);break;case 5:if(Xn(ht,lt),Zn(lt),xt&512&&(In||gt===null||Ni(gt,gt.return)),lt.flags&32){Ct=lt.stateNode;try{Hr(Ct,"")}catch(Aa){nn(lt,lt.return,Aa)}}xt&4&&lt.stateNode!=null&&(Ct=lt.memoizedProps,c1(lt,Ct,gt!==null?gt.memoizedProps:Ct)),xt&1024&&(d1=!0);break;case 6:if(Xn(ht,lt),Zn(lt),xt&4){if(lt.stateNode===null)throw Error(dt(162));xt=lt.memoizedProps,gt=lt.stateNode;try{gt.nodeValue=xt}catch(Aa){nn(lt,lt.return,Aa)}}break;case 3:if(Is=null,Ct=Mi,Mi=$s(ht.containerInfo),Xn(ht,lt),Mi=Ct,Zn(lt),xt&4&&gt!==null&&gt.memoizedState.isDehydrated)try{vo(ht.containerInfo)}catch(Aa){nn(lt,lt.return,Aa)}d1&&(d1=!1,bh(lt));break;case 4:xt=Mi,Mi=$s(lt.stateNode.containerInfo),Xn(ht,lt),Zn(lt),Mi=xt;break;case 12:Xn(ht,lt),Zn(lt);break;case 31:Xn(ht,lt),Zn(lt),xt&4&&(xt=lt.updateQueue,xt!==null&&(lt.updateQueue=null,fs(lt,xt)));break;case 13:Xn(ht,lt),Zn(lt),lt.child.flags&8192&&lt.memoizedState!==null!=(gt!==null&&gt.memoizedState!==null)&&(gs=pn()),xt&4&&(xt=lt.updateQueue,xt!==null&&(lt.updateQueue=null,fs(lt,xt)));break;case 22:Ct=lt.memoizedState!==null;var Jt=gt!==null&&gt.memoizedState!==null,ha=Vi,va=In;if(Vi=ha||Ct,In=va||Jt,Xn(ht,lt),In=va,Vi=ha,Zn(lt),xt&8192)e:for(ht=lt.stateNode,ht._visibility=Ct?ht._visibility&-2:ht._visibility|1,Ct&&(gt===null||Jt||Vi||In||Pr(lt)),gt=null,ht=lt;;){if(ht.tag===5||ht.tag===26){if(gt===null){Jt=gt=ht;try{if(Lt=Jt.stateNode,Ct)Dt=Lt.style,typeof Dt.setProperty=="function"?Dt.setProperty("display","none","important"):Dt.display="none";else{zt=Jt.stateNode;var wa=Jt.memoizedProps.style,ya=wa!=null&&wa.hasOwnProperty("display")?wa.display:null;zt.style.display=ya==null||typeof ya=="boolean"?"":(""+ya).trim()}}catch(Aa){nn(Jt,Jt.return,Aa)}}}else if(ht.tag===6){if(gt===null){Jt=ht;try{Jt.stateNode.nodeValue=Ct?"":Jt.memoizedProps}catch(Aa){nn(Jt,Jt.return,Aa)}}}else if(ht.tag===18){if(gt===null){Jt=ht;try{var ga=Jt.stateNode;Ct?u0(ga,!0):u0(Jt.stateNode,!1)}catch(Aa){nn(Jt,Jt.return,Aa)}}}else if((ht.tag!==22&&ht.tag!==23||ht.memoizedState===null||ht===lt)&&ht.child!==null){ht.child.return=ht,ht=ht.child;continue}if(ht===lt)break e;for(;ht.sibling===null;){if(ht.return===null||ht.return===lt)break e;gt===ht&&(gt=null),ht=ht.return}gt===ht&&(gt=null),ht.sibling.return=ht.return,ht=ht.sibling}xt&4&&(xt=lt.updateQueue,xt!==null&&(gt=xt.retryQueue,gt!==null&&(xt.retryQueue=null,fs(lt,gt))));break;case 19:Xn(ht,lt),Zn(lt),xt&4&&(xt=lt.updateQueue,xt!==null&&(lt.updateQueue=null,fs(lt,xt)));break;case 30:break;case 21:break;default:Xn(ht,lt),Zn(lt)}}function Zn(lt){var ht=lt.flags;if(ht&2){try{for(var gt,xt=lt.return;xt!==null;){if(ph(xt)){gt=xt;break}xt=xt.return}if(gt==null)throw Error(dt(160));switch(gt.tag){case 27:var Ct=gt.stateNode,Lt=s1(lt);ps(lt,Lt,Ct);break;case 5:var Dt=gt.stateNode;gt.flags&32&&(Hr(Dt,""),gt.flags&=-33);var zt=s1(lt);ps(lt,zt,Dt);break;case 3:case 4:var Jt=gt.stateNode.containerInfo,ha=s1(lt);l1(lt,ha,Jt);break;default:throw Error(dt(161))}}catch(va){nn(lt,lt.return,va)}lt.flags&=-3}ht&4096&&(lt.flags&=-4097)}function bh(lt){if(lt.subtreeFlags&1024)for(lt=lt.child;lt!==null;){var ht=lt;bh(ht),ht.tag===5&&ht.flags&1024&&ht.stateNode.reset(),lt=lt.sibling}}function Wi(lt,ht){if(ht.subtreeFlags&8772)for(ht=ht.child;ht!==null;)gh(lt,ht.alternate,ht),ht=ht.sibling}function Pr(lt){for(lt=lt.child;lt!==null;){var ht=lt;switch(ht.tag){case 0:case 11:case 14:case 15:lr(4,ht,ht.return),Pr(ht);break;case 1:Ni(ht,ht.return);var gt=ht.stateNode;typeof gt.componentWillUnmount=="function"&&uh(ht,ht.return,gt),Pr(ht);break;case 27:kc(ht.stateNode);case 26:case 5:Ni(ht,ht.return),Pr(ht);break;case 22:ht.memoizedState===null&&Pr(ht);break;case 30:Pr(ht);break;default:Pr(ht)}lt=lt.sibling}}function Yi(lt,ht,gt){for(gt=gt&&(ht.subtreeFlags&8772)!==0,ht=ht.child;ht!==null;){var xt=ht.alternate,Ct=lt,Lt=ht,Dt=Lt.flags;switch(Lt.tag){case 0:case 11:case 15:Yi(Ct,Lt,gt),sc(4,Lt);break;case 1:if(Yi(Ct,Lt,gt),xt=Lt,Ct=xt.stateNode,typeof Ct.componentDidMount=="function")try{Ct.componentDidMount()}catch(ha){nn(xt,xt.return,ha)}if(xt=Lt,Ct=xt.updateQueue,Ct!==null){var zt=xt.stateNode;try{var Jt=Ct.shared.hiddenCallbacks;if(Jt!==null)for(Ct.shared.hiddenCallbacks=null,Ct=0;Ct<Jt.length;Ct++)Qd(Jt[Ct],zt)}catch(ha){nn(xt,xt.return,ha)}}gt&&Dt&64&&dh(Lt),lc(Lt,Lt.return);break;case 27:fh(Lt);case 26:case 5:Yi(Ct,Lt,gt),gt&&xt===null&&Dt&4&&hh(Lt),lc(Lt,Lt.return);break;case 12:Yi(Ct,Lt,gt);break;case 31:Yi(Ct,Lt,gt),gt&&Dt&4&&_h(Ct,Lt);break;case 13:Yi(Ct,Lt,gt),gt&&Dt&4&&xh(Ct,Lt);break;case 22:Lt.memoizedState===null&&Yi(Ct,Lt,gt),lc(Lt,Lt.return);break;case 30:break;default:Yi(Ct,Lt,gt)}ht=ht.sibling}}function u1(lt,ht){var gt=null;lt!==null&&lt.memoizedState!==null&&lt.memoizedState.cachePool!==null&&(gt=lt.memoizedState.cachePool.pool),lt=null,ht.memoizedState!==null&&ht.memoizedState.cachePool!==null&&(lt=ht.memoizedState.cachePool.pool),lt!==gt&&(lt!=null&&lt.refCount++,gt!=null&&Xo(gt))}function h1(lt,ht){lt=null,ht.alternate!==null&&(lt=ht.alternate.memoizedState.cache),ht=ht.memoizedState.cache,ht!==lt&&(ht.refCount++,lt!=null&&Xo(lt))}function wi(lt,ht,gt,xt){if(ht.subtreeFlags&10256)for(ht=ht.child;ht!==null;)Ch(lt,ht,gt,xt),ht=ht.sibling}function Ch(lt,ht,gt,xt){var Ct=ht.flags;switch(ht.tag){case 0:case 11:case 15:wi(lt,ht,gt,xt),Ct&2048&&sc(9,ht);break;case 1:wi(lt,ht,gt,xt);break;case 3:wi(lt,ht,gt,xt),Ct&2048&&(lt=null,ht.alternate!==null&&(lt=ht.alternate.memoizedState.cache),ht=ht.memoizedState.cache,ht!==lt&&(ht.refCount++,lt!=null&&Xo(lt)));break;case 12:if(Ct&2048){wi(lt,ht,gt,xt),lt=ht.stateNode;try{var Lt=ht.memoizedProps,Dt=Lt.id,zt=Lt.onPostCommit;typeof zt=="function"&&zt(Dt,ht.alternate===null?"mount":"update",lt.passiveEffectDuration,-0)}catch(Jt){nn(ht,ht.return,Jt)}}else wi(lt,ht,gt,xt);break;case 31:wi(lt,ht,gt,xt);break;case 13:wi(lt,ht,gt,xt);break;case 23:break;case 22:Lt=ht.stateNode,Dt=ht.alternate,ht.memoizedState!==null?Lt._visibility&2?wi(lt,ht,gt,xt):dc(lt,ht):Lt._visibility&2?wi(lt,ht,gt,xt):(Lt._visibility|=2,lo(lt,ht,gt,xt,(ht.subtreeFlags&10256)!==0||!1)),Ct&2048&&u1(Dt,ht);break;case 24:wi(lt,ht,gt,xt),Ct&2048&&h1(ht.alternate,ht);break;default:wi(lt,ht,gt,xt)}}function lo(lt,ht,gt,xt,Ct){for(Ct=Ct&&((ht.subtreeFlags&10256)!==0||!1),ht=ht.child;ht!==null;){var Lt=lt,Dt=ht,zt=gt,Jt=xt,ha=Dt.flags;switch(Dt.tag){case 0:case 11:case 15:lo(Lt,Dt,zt,Jt,Ct),sc(8,Dt);break;case 23:break;case 22:var va=Dt.stateNode;Dt.memoizedState!==null?va._visibility&2?lo(Lt,Dt,zt,Jt,Ct):dc(Lt,Dt):(va._visibility|=2,lo(Lt,Dt,zt,Jt,Ct)),Ct&&ha&2048&&u1(Dt.alternate,Dt);break;case 24:lo(Lt,Dt,zt,Jt,Ct),Ct&&ha&2048&&h1(Dt.alternate,Dt);break;default:lo(Lt,Dt,zt,Jt,Ct)}ht=ht.sibling}}function dc(lt,ht){if(ht.subtreeFlags&10256)for(ht=ht.child;ht!==null;){var gt=lt,xt=ht,Ct=xt.flags;switch(xt.tag){case 22:dc(gt,xt),Ct&2048&&u1(xt.alternate,xt);break;case 24:dc(gt,xt),Ct&2048&&h1(xt.alternate,xt);break;default:dc(gt,xt)}ht=ht.sibling}}var uc=8192;function uo(lt,ht,gt){if(lt.subtreeFlags&uc)for(lt=lt.child;lt!==null;)Mh(lt,ht,gt),lt=lt.sibling}function Mh(lt,ht,gt){switch(lt.tag){case 26:uo(lt,ht,gt),lt.flags&uc&&lt.memoizedState!==null&&Rp(gt,Mi,lt.memoizedState,lt.memoizedProps);break;case 5:uo(lt,ht,gt);break;case 3:case 4:var xt=Mi;Mi=$s(lt.stateNode.containerInfo),uo(lt,ht,gt),Mi=xt;break;case 22:lt.memoizedState===null&&(xt=lt.alternate,xt!==null&&xt.memoizedState!==null?(xt=uc,uc=16777216,uo(lt,ht,gt),uc=xt):uo(lt,ht,gt));break;default:uo(lt,ht,gt)}}function wh(lt){var ht=lt.alternate;if(ht!==null&&(lt=ht.child,lt!==null)){ht.child=null;do ht=lt.sibling,lt.sibling=null,lt=ht;while(lt!==null)}}function hc(lt){var ht=lt.deletions;if((lt.flags&16)!==0){if(ht!==null)for(var gt=0;gt<ht.length;gt++){var xt=ht[gt];Rn=xt,Sh(xt,lt)}wh(lt)}if(lt.subtreeFlags&10256)for(lt=lt.child;lt!==null;)Lh(lt),lt=lt.sibling}function Lh(lt){switch(lt.tag){case 0:case 11:case 15:hc(lt),lt.flags&2048&&lr(9,lt,lt.return);break;case 3:hc(lt);break;case 12:hc(lt);break;case 22:var ht=lt.stateNode;lt.memoizedState!==null&&ht._visibility&2&&(lt.return===null||lt.return.tag!==13)?(ht._visibility&=-3,ys(lt)):hc(lt);break;default:hc(lt)}}function ys(lt){var ht=lt.deletions;if((lt.flags&16)!==0){if(ht!==null)for(var gt=0;gt<ht.length;gt++){var xt=ht[gt];Rn=xt,Sh(xt,lt)}wh(lt)}for(lt=lt.child;lt!==null;){switch(ht=lt,ht.tag){case 0:case 11:case 15:lr(8,ht,ht.return),ys(ht);break;case 22:gt=ht.stateNode,gt._visibility&2&&(gt._visibility&=-3,ys(ht));break;default:ys(ht)}lt=lt.sibling}}function Sh(lt,ht){for(;Rn!==null;){var gt=Rn;switch(gt.tag){case 0:case 11:case 15:lr(8,gt,ht);break;case 23:case 22:if(gt.memoizedState!==null&&gt.memoizedState.cachePool!==null){var xt=gt.memoizedState.cachePool.pool;xt!=null&&xt.refCount++}break;case 24:Xo(gt.memoizedState.cache)}if(xt=gt.child,xt!==null)xt.return=gt,Rn=xt;else e:for(gt=lt;Rn!==null;){xt=Rn;var Ct=xt.sibling,Lt=xt.return;if(mh(xt),xt===gt){Rn=null;break e}if(Ct!==null){Ct.return=Lt,Rn=Ct;break e}Rn=Lt}}}var X2={getCacheForType:function(lt){var ht=Pn(Sn),gt=ht.data.get(lt);return gt===void 0&&(gt=lt(),ht.data.set(lt,gt)),gt},cacheSignal:function(){return Pn(Sn).controller.signal}},Z2=typeof WeakMap=="function"?WeakMap:Map,Qa=0,ln=null,Va=null,Wa=0,an=0,ri=null,dr=!1,ho=!1,p1=!1,Xi=0,xn=0,ur=0,Fr=0,f1=0,oi=0,po=0,pc=null,Kn=null,y1=!1,gs=0,$h=0,ms=1/0,ks=null,hr=null,Tn=0,pr=null,fo=null,Zi=0,g1=0,m1=null,Nh=null,fc=0,k1=null;function ci(){return(Qa&2)!==0&&Wa!==0?Wa&-Wa:Ut.T!==null?M1():Ro()}function Ih(){if(oi===0)if((Wa&536870912)===0||Xa){var lt=Pa;Pa<<=1,(Pa&3932160)===0&&(Pa=262144),oi=lt}else oi=536870912;return lt=ni.current,lt!==null&&(lt.flags|=32),oi}function Qn(lt,ht,gt){(lt===ln&&(an===2||an===9)||lt.cancelPendingCommit!==null)&&(yo(lt,0),fr(lt,Wa,oi,!1)),Qi(lt,gt),((Qa&2)===0||lt!==ln)&&(lt===ln&&((Qa&2)===0&&(Fr|=gt),xn===4&&fr(lt,Wa,oi,!1)),Ii(lt))}function Ah(lt,ht,gt){if((Qa&6)!==0)throw Error(dt(327));var xt=!gt&&(ht&127)===0&&(ht&lt.expiredLanes)===0||br(lt,ht),Ct=xt?J2(lt,ht):x1(lt,ht,!0),Lt=xt;do{if(Ct===0){ho&&!xt&&fr(lt,ht,0,!1);break}else{if(gt=lt.current.alternate,Lt&&!K2(gt)){Ct=x1(lt,ht,!1),Lt=!1;continue}if(Ct===2){if(Lt=ht,lt.errorRecoveryDisabledLanes&Lt)var Dt=0;else Dt=lt.pendingLanes&-536870913,Dt=Dt!==0?Dt:Dt&536870912?536870912:0;if(Dt!==0){ht=Dt;e:{var zt=lt;Ct=pc;var Jt=zt.current.memoizedState.isDehydrated;if(Jt&&(yo(zt,Dt).flags|=256),Dt=x1(zt,Dt,!1),Dt!==2){if(p1&&!Jt){zt.errorRecoveryDisabledLanes|=Lt,Fr|=Lt,Ct=4;break e}Lt=Kn,Kn=Ct,Lt!==null&&(Kn===null?Kn=Lt:Kn.push.apply(Kn,Lt))}Ct=Dt}if(Lt=!1,Ct!==2)continue}}if(Ct===1){yo(lt,0),fr(lt,ht,0,!0);break}e:{switch(xt=lt,Lt=Ct,Lt){case 0:case 1:throw Error(dt(345));case 4:if((ht&4194048)!==ht)break;case 6:fr(xt,ht,oi,!dr);break e;case 2:Kn=null;break;case 3:case 5:break;default:throw Error(dt(329))}if((ht&62914560)===ht&&(Ct=gs+300-pn(),10<Ct)){if(fr(xt,ht,oi,!dr),jr(xt,0,!0)!==0)break e;Zi=ht,xt.timeoutHandle=s0(Th.bind(null,xt,gt,Kn,ks,y1,ht,oi,Fr,po,dr,Lt,"Throttled",-0,0),Ct);break e}Th(xt,gt,Kn,ks,y1,ht,oi,Fr,po,dr,Lt,null,-0,0)}}break}while(!0);Ii(lt)}function Th(lt,ht,gt,xt,Ct,Lt,Dt,zt,Jt,ha,va,wa,ya,ga){if(lt.timeoutHandle=-1,wa=ht.subtreeFlags,wa&8192||(wa&16785408)===16785408){wa={stylesheets:null,count:0,imgCount:0,imgBytes:0,suspenseyImages:[],waitingForImages:!0,waitingForViewTransition:!1,unsuspend:Ri},Mh(ht,Lt,wa);var Aa=(Lt&62914560)===Lt?gs-pn():(Lt&4194048)===Lt?$h-pn():0;if(Aa=Bp(wa,Aa),Aa!==null){Zi=Lt,lt.cancelPendingCommit=Aa(jh.bind(null,lt,ht,Lt,gt,xt,Ct,Dt,zt,Jt,va,wa,null,ya,ga)),fr(lt,Lt,Dt,!ha);return}}jh(lt,ht,Lt,gt,xt,Ct,Dt,zt,Jt)}function K2(lt){for(var ht=lt;;){var gt=ht.tag;if((gt===0||gt===11||gt===15)&&ht.flags&16384&&(gt=ht.updateQueue,gt!==null&&(gt=gt.stores,gt!==null)))for(var xt=0;xt<gt.length;xt++){var Ct=gt[xt],Lt=Ct.getSnapshot;Ct=Ct.value;try{if(!ti(Lt(),Ct))return!1}catch{return!1}}if(gt=ht.child,ht.subtreeFlags&16384&&gt!==null)gt.return=ht,ht=gt;else{if(ht===lt)break;for(;ht.sibling===null;){if(ht.return===null||ht.return===lt)return!0;ht=ht.return}ht.sibling.return=ht.return,ht=ht.sibling}}return!0}function fr(lt,ht,gt,xt){ht&=~f1,ht&=~Fr,lt.suspendedLanes|=ht,lt.pingedLanes&=~ht,xt&&(lt.warmLanes|=ht),xt=lt.expirationTimes;for(var Ct=ht;0<Ct;){var Lt=31-pa(Ct),Dt=1<<Lt;xt[Lt]=-1,Ct&=~Dt}gt!==0&&To(lt,gt,ht)}function _s(){return(Qa&6)===0?(yc(0),!1):!0}function _1(){if(Va!==null){if(an===0)var lt=Va.return;else lt=Va,qi=Nr=null,Bl(lt),io=null,Ko=0,lt=Va;for(;lt!==null;)lh(lt.alternate,lt),lt=lt.return;Va=null}}function yo(lt,ht){var gt=lt.timeoutHandle;gt!==-1&&(lt.timeoutHandle=-1,mp(gt)),gt=lt.cancelPendingCommit,gt!==null&&(lt.cancelPendingCommit=null,gt()),Zi=0,_1(),ln=lt,Va=gt=Di(lt.current,null),Wa=ht,an=0,ri=null,dr=!1,ho=br(lt,ht),p1=!1,po=oi=f1=Fr=ur=xn=0,Kn=pc=null,y1=!1,(ht&8)!==0&&(ht|=ht&32);var xt=lt.entangledLanes;if(xt!==0)for(lt=lt.entanglements,xt&=ht;0<xt;){var Ct=31-pa(xt),Lt=1<<Ct;ht|=lt[Ct],xt&=~Lt}return Xi=ht,jc(),gt}function Eh(lt,ht){Oa=null,Ut.H=rc,ht===no||ht===Yc?(ht=Yd(),an=3):ht===Cl?(ht=Yd(),an=4):an=ht===Kl?8:ht!==null&&typeof ht=="object"&&typeof ht.then=="function"?6:1,ri=ht,Va===null&&(xn=1,ss(lt,fi(ht,lt.current)))}function Rh(){var lt=ni.current;return lt===null?!0:(Wa&4194048)===Wa?ki===null:(Wa&62914560)===Wa||(Wa&536870912)!==0?lt===ki:!1}function Bh(){var lt=Ut.H;return Ut.H=rc,lt===null?rc:lt}function Dh(){var lt=Ut.A;return Ut.A=X2,lt}function xs(){xn=4,dr||(Wa&4194048)!==Wa&&ni.current!==null||(ho=!0),(ur&134217727)===0&&(Fr&134217727)===0||ln===null||fr(ln,Wa,oi,!1)}function x1(lt,ht,gt){var xt=Qa;Qa|=2;var Ct=Bh(),Lt=Dh();(ln!==lt||Wa!==ht)&&(ks=null,yo(lt,ht)),ht=!1;var Dt=xn;e:do try{if(an!==0&&Va!==null){var zt=Va,Jt=ri;switch(an){case 8:_1(),Dt=6;break e;case 3:case 2:case 9:case 6:ni.current===null&&(ht=!0);var ha=an;if(an=0,ri=null,go(lt,zt,Jt,ha),gt&&ho){Dt=0;break e}break;default:ha=an,an=0,ri=null,go(lt,zt,Jt,ha)}}Q2(),Dt=xn;break}catch(va){Eh(lt,va)}while(!0);return ht&&lt.shellSuspendCounter++,qi=Nr=null,Qa=xt,Ut.H=Ct,Ut.A=Lt,Va===null&&(ln=null,Wa=0,jc()),Dt}function Q2(){for(;Va!==null;)Ph(Va)}function J2(lt,ht){var gt=Qa;Qa|=2;var xt=Bh(),Ct=Dh();ln!==lt||Wa!==ht?(ks=null,ms=pn()+500,yo(lt,ht)):ho=br(lt,ht);e:do try{if(an!==0&&Va!==null){ht=Va;var Lt=ri;t:switch(an){case 1:an=0,ri=null,go(lt,ht,Lt,1);break;case 2:case 9:if(Gd(Lt)){an=0,ri=null,Fh(ht);break}ht=function(){an!==2&&an!==9||ln!==lt||(an=7),Ii(lt)},Lt.then(ht,ht);break e;case 3:an=7;break e;case 4:an=5;break e;case 7:Gd(Lt)?(an=0,ri=null,Fh(ht)):(an=0,ri=null,go(lt,ht,Lt,7));break;case 5:var Dt=null;switch(Va.tag){case 26:Dt=Va.memoizedState;case 5:case 27:var zt=Va;if(Dt?C0(Dt):zt.stateNode.complete){an=0,ri=null;var Jt=zt.sibling;if(Jt!==null)Va=Jt;else{var ha=zt.return;ha!==null?(Va=ha,vs(ha)):Va=null}break t}}an=0,ri=null,go(lt,ht,Lt,5);break;case 6:an=0,ri=null,go(lt,ht,Lt,6);break;case 8:_1(),xn=6;break e;default:throw Error(dt(462))}}ep();break}catch(va){Eh(lt,va)}while(!0);return qi=Nr=null,Ut.H=xt,Ut.A=Ct,Qa=gt,Va!==null?0:(ln=null,Wa=0,jc(),xn)}function ep(){for(;Va!==null&&!Mn();)Ph(Va)}function Ph(lt){var ht=ch(lt.alternate,lt,Xi);lt.memoizedProps=lt.pendingProps,ht===null?vs(lt):Va=ht}function Fh(lt){var ht=lt,gt=ht.alternate;switch(ht.tag){case 15:case 0:ht=th(gt,ht,ht.pendingProps,ht.type,void 0,Wa);break;case 11:ht=th(gt,ht,ht.pendingProps,ht.type.render,ht.ref,Wa);break;case 5:Bl(ht);default:lh(gt,ht),ht=Va=Bd(ht,Xi),ht=ch(gt,ht,Xi)}lt.memoizedProps=lt.pendingProps,ht===null?vs(lt):Va=ht}function go(lt,ht,gt,xt){qi=Nr=null,Bl(ht),io=null,Ko=0;var Ct=ht.return;try{if(z2(lt,Ct,ht,gt,Wa)){xn=1,ss(lt,fi(gt,lt.current)),Va=null;return}}catch(Lt){if(Ct!==null)throw Va=Ct,Lt;xn=1,ss(lt,fi(gt,lt.current)),Va=null;return}ht.flags&32768?(Xa||xt===1?lt=!0:ho||(Wa&536870912)!==0?lt=!1:(dr=lt=!0,(xt===2||xt===9||xt===3||xt===6)&&(xt=ni.current,xt!==null&&xt.tag===13&&(xt.flags|=16384))),qh(ht,lt)):vs(ht)}function vs(lt){var ht=lt;do{if((ht.flags&32768)!==0){qh(ht,dr);return}lt=ht.return;var gt=V2(ht.alternate,ht,Xi);if(gt!==null){Va=gt;return}if(ht=ht.sibling,ht!==null){Va=ht;return}Va=ht=lt}while(ht!==null);xn===0&&(xn=5)}function qh(lt,ht){do{var gt=G2(lt.alternate,lt);if(gt!==null){gt.flags&=32767,Va=gt;return}if(gt=lt.return,gt!==null&&(gt.flags|=32768,gt.subtreeFlags=0,gt.deletions=null),!ht&&(lt=lt.sibling,lt!==null)){Va=lt;return}Va=lt=gt}while(lt!==null);xn=6,Va=null}function jh(lt,ht,gt,xt,Ct,Lt,Dt,zt,Jt){lt.cancelPendingCommit=null;do bs();while(Tn!==0);if((Qa&6)!==0)throw Error(dt(327));if(ht!==null){if(ht===lt.current)throw Error(dt(177));if(Lt=ht.lanes|ht.childLanes,Lt|=sl,Ao(lt,gt,Lt,Dt,zt,Jt),lt===ln&&(Va=ln=null,Wa=0),fo=ht,pr=lt,Zi=gt,g1=Lt,m1=Ct,Nh=xt,(ht.subtreeFlags&10256)!==0||(ht.flags&10256)!==0?(lt.callbackNode=null,lt.callbackPriority=0,ip(At,function(){return Vh(),null})):(lt.callbackNode=null,lt.callbackPriority=0),xt=(ht.flags&13878)!==0,(ht.subtreeFlags&13878)!==0||xt){xt=Ut.T,Ut.T=null,Ct=ea.p,ea.p=2,Dt=Qa,Qa|=4;try{W2(lt,ht,gt)}finally{Qa=Dt,ea.p=Ct,Ut.T=xt}}Tn=1,Oh(),zh(),Hh()}}function Oh(){if(Tn===1){Tn=0;var lt=pr,ht=fo,gt=(ht.flags&13878)!==0;if((ht.subtreeFlags&13878)!==0||gt){gt=Ut.T,Ut.T=null;var xt=ea.p;ea.p=2;var Ct=Qa;Qa|=4;try{vh(ht,lt);var Lt=T1,Dt=Ld(lt.containerInfo),zt=Lt.focusedElem,Jt=Lt.selectionRange;if(Dt!==zt&&zt&&zt.ownerDocument&&wd(zt.ownerDocument.documentElement,zt)){if(Jt!==null&&nl(zt)){var ha=Jt.start,va=Jt.end;if(va===void 0&&(va=ha),"selectionStart"in zt)zt.selectionStart=ha,zt.selectionEnd=Math.min(va,zt.value.length);else{var wa=zt.ownerDocument||document,ya=wa&&wa.defaultView||window;if(ya.getSelection){var ga=ya.getSelection(),Aa=zt.textContent.length,Da=Math.min(Jt.start,Aa),sn=Jt.end===void 0?Da:Math.min(Jt.end,Aa);!ga.extend&&Da>sn&&(Dt=sn,sn=Da,Da=Dt);var ca=Md(zt,Da),ia=Md(zt,sn);if(ca&&ia&&(ga.rangeCount!==1||ga.anchorNode!==ca.node||ga.anchorOffset!==ca.offset||ga.focusNode!==ia.node||ga.focusOffset!==ia.offset)){var ua=wa.createRange();ua.setStart(ca.node,ca.offset),ga.removeAllRanges(),Da>sn?(ga.addRange(ua),ga.extend(ia.node,ia.offset)):(ua.setEnd(ia.node,ia.offset),ga.addRange(ua))}}}}for(wa=[],ga=zt;ga=ga.parentNode;)ga.nodeType===1&&wa.push({element:ga,left:ga.scrollLeft,top:ga.scrollTop});for(typeof zt.focus=="function"&&zt.focus(),zt=0;zt<wa.length;zt++){var Ma=wa[zt];Ma.element.scrollLeft=Ma.left,Ma.element.scrollTop=Ma.top}}Rs=!!A1,T1=A1=null}finally{Qa=Ct,ea.p=xt,Ut.T=gt}}lt.current=ht,Tn=2}}function zh(){if(Tn===2){Tn=0;var lt=pr,ht=fo,gt=(ht.flags&8772)!==0;if((ht.subtreeFlags&8772)!==0||gt){gt=Ut.T,Ut.T=null;var xt=ea.p;ea.p=2;var Ct=Qa;Qa|=4;try{gh(lt,ht.alternate,ht)}finally{Qa=Ct,ea.p=xt,Ut.T=gt}}Tn=3}}function Hh(){if(Tn===4||Tn===3){Tn=0,vi();var lt=pr,ht=fo,gt=Zi,xt=Nh;(ht.subtreeFlags&10256)!==0||(ht.flags&10256)!==0?Tn=5:(Tn=0,fo=pr=null,Uh(lt,lt.pendingLanes));var Ct=lt.pendingLanes;if(Ct===0&&(hr=null),bi(gt),ht=ht.stateNode,da&&typeof da.onCommitFiberRoot=="function")try{da.onCommitFiberRoot(Xt,ht,void 0,(ht.current.flags&128)===128)}catch{}if(xt!==null){ht=Ut.T,Ct=ea.p,ea.p=2,Ut.T=null;try{for(var Lt=lt.onRecoverableError,Dt=0;Dt<xt.length;Dt++){var zt=xt[Dt];Lt(zt.value,{componentStack:zt.stack})}}finally{Ut.T=ht,ea.p=Ct}}(Zi&3)!==0&&bs(),Ii(lt),Ct=lt.pendingLanes,(gt&261930)!==0&&(Ct&42)!==0?lt===k1?fc++:(fc=0,k1=lt):fc=0,yc(0)}}function Uh(lt,ht){(lt.pooledCacheLanes&=ht)===0&&(ht=lt.pooledCache,ht!=null&&(lt.pooledCache=null,Xo(ht)))}function bs(){return Oh(),zh(),Hh(),Vh()}function Vh(){if(Tn!==5)return!1;var lt=pr,ht=g1;g1=0;var gt=bi(Zi),xt=Ut.T,Ct=ea.p;try{ea.p=32>gt?32:gt,Ut.T=null,gt=m1,m1=null;var Lt=pr,Dt=Zi;if(Tn=0,fo=pr=null,Zi=0,(Qa&6)!==0)throw Error(dt(331));var zt=Qa;if(Qa|=4,Lh(Lt.current),Ch(Lt,Lt.current,Dt,gt),Qa=zt,yc(0,!1),da&&typeof da.onPostCommitFiberRoot=="function")try{da.onPostCommitFiberRoot(Xt,Lt)}catch{}return!0}finally{ea.p=Ct,Ut.T=xt,Uh(lt,ht)}}function Gh(lt,ht,gt){ht=fi(gt,ht),ht=Zl(lt.stateNode,ht,2),lt=or(lt,ht,2),lt!==null&&(Qi(lt,2),Ii(lt))}function nn(lt,ht,gt){if(lt.tag===3)Gh(lt,lt,gt);else for(;ht!==null;){if(ht.tag===3){Gh(ht,lt,gt);break}else if(ht.tag===1){var xt=ht.stateNode;if(typeof ht.type.getDerivedStateFromError=="function"||typeof xt.componentDidCatch=="function"&&(hr===null||!hr.has(xt))){lt=fi(gt,lt),gt=Wu(2),xt=or(ht,gt,2),xt!==null&&(Yu(gt,xt,ht,lt),Qi(xt,2),Ii(xt));break}}ht=ht.return}}function v1(lt,ht,gt){var xt=lt.pingCache;if(xt===null){xt=lt.pingCache=new Z2;var Ct=new Set;xt.set(ht,Ct)}else Ct=xt.get(ht),Ct===void 0&&(Ct=new Set,xt.set(ht,Ct));Ct.has(gt)||(p1=!0,Ct.add(gt),lt=tp.bind(null,lt,ht,gt),ht.then(lt,lt))}function tp(lt,ht,gt){var xt=lt.pingCache;xt!==null&&xt.delete(ht),lt.pingedLanes|=lt.suspendedLanes&gt,lt.warmLanes&=~gt,ln===lt&&(Wa&gt)===gt&&(xn===4||xn===3&&(Wa&62914560)===Wa&&300>pn()-gs?(Qa&2)===0&&yo(lt,0):f1|=gt,po===Wa&&(po=0)),Ii(lt)}function Wh(lt,ht){ht===0&&(ht=Ai()),lt=Lr(lt,ht),lt!==null&&(Qi(lt,ht),Ii(lt))}function ap(lt){var ht=lt.memoizedState,gt=0;ht!==null&&(gt=ht.retryLane),Wh(lt,gt)}function np(lt,ht){var gt=0;switch(lt.tag){case 31:case 13:var xt=lt.stateNode,Ct=lt.memoizedState;Ct!==null&&(gt=Ct.retryLane);break;case 19:xt=lt.stateNode;break;case 22:xt=lt.stateNode._retryCache;break;default:throw Error(dt(314))}xt!==null&&xt.delete(ht),Wh(lt,gt)}function ip(lt,ht){return jn(lt,ht)}var Cs=null,mo=null,b1=!1,Ms=!1,C1=!1,yr=0;function Ii(lt){lt!==mo&&lt.next===null&&(mo===null?Cs=mo=lt:mo=mo.next=lt),Ms=!0,b1||(b1=!0,op())}function yc(lt,ht){if(!C1&&Ms){C1=!0;do for(var gt=!1,xt=Cs;xt!==null;){if(lt!==0){var Ct=xt.pendingLanes;if(Ct===0)var Lt=0;else{var Dt=xt.suspendedLanes,zt=xt.pingedLanes;Lt=(1<<31-pa(42|lt)+1)-1,Lt&=Ct&~(Dt&~zt),Lt=Lt&201326741?Lt&201326741|1:Lt?Lt|2:0}Lt!==0&&(gt=!0,Kh(xt,Lt))}else Lt=Wa,Lt=jr(xt,xt===ln?Lt:0,xt.cancelPendingCommit!==null||xt.timeoutHandle!==-1),(Lt&3)===0||br(xt,Lt)||(gt=!0,Kh(xt,Lt));xt=xt.next}while(gt);C1=!1}}function rp(){Yh()}function Yh(){Ms=b1=!1;var lt=0;yr!==0&&gp()&&(lt=yr);for(var ht=pn(),gt=null,xt=Cs;xt!==null;){var Ct=xt.next,Lt=Xh(xt,ht);Lt===0?(xt.next=null,gt===null?Cs=Ct:gt.next=Ct,Ct===null&&(mo=gt)):(gt=xt,(lt!==0||(Lt&3)!==0)&&(Ms=!0)),xt=Ct}Tn!==0&&Tn!==5||yc(lt),yr!==0&&(yr=0)}function Xh(lt,ht){for(var gt=lt.suspendedLanes,xt=lt.pingedLanes,Ct=lt.expirationTimes,Lt=lt.pendingLanes&-62914561;0<Lt;){var Dt=31-pa(Lt),zt=1<<Dt,Jt=Ct[Dt];Jt===-1?((zt&gt)===0||(zt&xt)!==0)&&(Ct[Dt]=wn(zt,ht)):Jt<=ht&&(lt.expiredLanes|=zt),Lt&=~zt}if(ht=ln,gt=Wa,gt=jr(lt,lt===ht?gt:0,lt.cancelPendingCommit!==null||lt.timeoutHandle!==-1),xt=lt.callbackNode,gt===0||lt===ht&&(an===2||an===9)||lt.cancelPendingCommit!==null)return xt!==null&&xt!==null&&On(xt),lt.callbackNode=null,lt.callbackPriority=0;if((gt&3)===0||br(lt,gt)){if(ht=gt&-gt,ht===lt.callbackPriority)return ht;switch(xt!==null&&On(xt),bi(gt)){case 2:case 8:gt=Pt;break;case 32:gt=At;break;case 268435456:gt=Bt;break;default:gt=At}return xt=Zh.bind(null,lt),gt=jn(gt,xt),lt.callbackPriority=ht,lt.callbackNode=gt,ht}return xt!==null&&xt!==null&&On(xt),lt.callbackPriority=2,lt.callbackNode=null,2}function Zh(lt,ht){if(Tn!==0&&Tn!==5)return lt.callbackNode=null,lt.callbackPriority=0,null;var gt=lt.callbackNode;if(bs()&&lt.callbackNode!==gt)return null;var xt=Wa;return xt=jr(lt,lt===ln?xt:0,lt.cancelPendingCommit!==null||lt.timeoutHandle!==-1),xt===0?null:(Ah(lt,xt,ht),Xh(lt,pn()),lt.callbackNode!=null&&lt.callbackNode===gt?Zh.bind(null,lt):null)}function Kh(lt,ht){if(bs())return null;Ah(lt,ht,!0)}function op(){kp(function(){(Qa&6)!==0?jn(fa,rp):Yh()})}function M1(){if(yr===0){var lt=to;lt===0&&(lt=ja,ja<<=1,(ja&261888)===0&&(ja=256)),yr=lt}return yr}function Qh(lt){return lt==null||typeof lt=="symbol"||typeof lt=="boolean"?null:typeof lt=="function"?lt:Tc(""+lt)}function Jh(lt,ht){var gt=ht.ownerDocument.createElement("input");return gt.name=ht.name,gt.value=ht.value,lt.id&&gt.setAttribute("form",lt.id),ht.parentNode.insertBefore(gt,ht),lt=new FormData(lt),gt.parentNode.removeChild(gt),lt}function cp(lt,ht,gt,xt,Ct){if(ht==="submit"&&gt&&gt.stateNode===Ct){var Lt=Qh((Ct[fn]||null).action),Dt=xt.submitter;Dt&&(ht=(ht=Dt[fn]||null)?Qh(ht.formAction):Dt.getAttribute("formAction"),ht!==null&&(Lt=ht,Dt=null));var zt=new Dc("action","action",null,xt,Ct);lt.push({event:zt,listeners:[{instance:null,listener:function(){if(xt.defaultPrevented){if(yr!==0){var Jt=Dt?Jh(Ct,Dt):new FormData(Ct);Ul(gt,{pending:!0,data:Jt,method:Ct.method,action:Lt},null,Jt)}}else typeof Lt=="function"&&(zt.preventDefault(),Jt=Dt?Jh(Ct,Dt):new FormData(Ct),Ul(gt,{pending:!0,data:Jt,method:Ct.method,action:Lt},Lt,Jt))},currentTarget:Ct}]})}}for(var w1=0;w1<cl.length;w1++){var L1=cl[w1],sp=L1.toLowerCase(),lp=L1[0].toUpperCase()+L1.slice(1);Ci(sp,"on"+lp)}Ci(Nd,"onAnimationEnd"),Ci(Id,"onAnimationIteration"),Ci(Ad,"onAnimationStart"),Ci("dblclick","onDoubleClick"),Ci("focusin","onFocus"),Ci("focusout","onBlur"),Ci(w2,"onTransitionRun"),Ci(L2,"onTransitionStart"),Ci(S2,"onTransitionCancel"),Ci(Td,"onTransitionEnd"),Li("onMouseEnter",["mouseout","mouseover"]),Li("onMouseLeave",["mouseout","mouseover"]),Li("onPointerEnter",["pointerout","pointerover"]),Li("onPointerLeave",["pointerout","pointerover"]),Gn("onChange","change click focusin focusout input keydown keyup selectionchange".split(" ")),Gn("onSelect","focusout contextmenu dragend focusin keydown keyup mousedown mouseup selectionchange".split(" ")),Gn("onBeforeInput",["compositionend","keypress","textInput","paste"]),Gn("onCompositionEnd","compositionend focusout keydown keypress keyup mousedown".split(" ")),Gn("onCompositionStart","compositionstart focusout keydown keypress keyup mousedown".split(" ")),Gn("onCompositionUpdate","compositionupdate focusout keydown keypress keyup mousedown".split(" "));var gc="abort canplay canplaythrough durationchange emptied encrypted ended error loadeddata loadedmetadata loadstart pause play playing progress ratechange resize seeked seeking stalled suspend timeupdate volumechange waiting".split(" "),dp=new Set("beforetoggle cancel close invalid load scroll scrollend toggle".split(" ").concat(gc));function e0(lt,ht){ht=(ht&4)!==0;for(var gt=0;gt<lt.length;gt++){var xt=lt[gt],Ct=xt.event;xt=xt.listeners;e:{var Lt=void 0;if(ht)for(var Dt=xt.length-1;0<=Dt;Dt--){var zt=xt[Dt],Jt=zt.instance,ha=zt.currentTarget;if(zt=zt.listener,Jt!==Lt&&Ct.isPropagationStopped())break e;Lt=zt,Ct.currentTarget=ha;try{Lt(Ct)}catch(va){qc(va)}Ct.currentTarget=null,Lt=Jt}else for(Dt=0;Dt<xt.length;Dt++){if(zt=xt[Dt],Jt=zt.instance,ha=zt.currentTarget,zt=zt.listener,Jt!==Lt&&Ct.isPropagationStopped())break e;Lt=zt,Ct.currentTarget=ha;try{Lt(Ct)}catch(va){qc(va)}Ct.currentTarget=null,Lt=Jt}}}}function Ga(lt,ht){var gt=ht[Or];gt===void 0&&(gt=ht[Or]=new Set);var xt=lt+"__bubble";gt.has(xt)||(t0(ht,lt,2,!1),gt.add(xt))}function S1(lt,ht,gt){var xt=0;ht&&(xt|=4),t0(gt,lt,xt,ht)}var ws="_reactListening"+Math.random().toString(36).slice(2);function $1(lt){if(!lt[ws]){lt[ws]=!0,Bn.forEach(function(gt){gt!=="selectionchange"&&(dp.has(gt)||S1(gt,!1,lt),S1(gt,!0,lt))});var ht=lt.nodeType===9?lt:lt.ownerDocument;ht===null||ht[ws]||(ht[ws]=!0,S1("selectionchange",!1,ht))}}function t0(lt,ht,gt,xt){switch(I0(ht)){case 2:var Ct=Fp;break;case 8:Ct=qp;break;default:Ct=H1}gt=Ct.bind(null,ht,gt,lt),Ct=void 0,!Ys||ht!=="touchstart"&&ht!=="touchmove"&&ht!=="wheel"||(Ct=!0),xt?Ct!==void 0?lt.addEventListener(ht,gt,{capture:!0,passive:Ct}):lt.addEventListener(ht,gt,!0):Ct!==void 0?lt.addEventListener(ht,gt,{passive:Ct}):lt.addEventListener(ht,gt,!1)}function N1(lt,ht,gt,xt,Ct){var Lt=xt;if((ht&1)===0&&(ht&2)===0&&xt!==null)e:for(;;){if(xt===null)return;var Dt=xt.tag;if(Dt===3||Dt===4){var zt=xt.stateNode.containerInfo;if(zt===Ct)break;if(Dt===4)for(Dt=xt.return;Dt!==null;){var Jt=Dt.tag;if((Jt===3||Jt===4)&&Dt.stateNode.containerInfo===Ct)return;Dt=Dt.return}for(;zt!==null;){if(Dt=Sa(zt),Dt===null)return;if(Jt=Dt.tag,Jt===5||Jt===6||Jt===26||Jt===27){xt=Lt=Dt;continue e}zt=zt.parentNode}}xt=xt.return}rd(function(){var ha=Lt,va=Gs(gt),wa=[];e:{var ya=Ed.get(lt);if(ya!==void 0){var ga=Dc,Aa=lt;switch(lt){case"keypress":if(Rc(gt)===0)break e;case"keydown":case"keyup":ga=n2;break;case"focusin":Aa="focus",ga=Qs;break;case"focusout":Aa="blur",ga=Qs;break;case"beforeblur":case"afterblur":ga=Qs;break;case"click":if(gt.button===2)break e;case"auxclick":case"dblclick":case"mousedown":case"mousemove":case"mouseup":case"mouseout":case"mouseover":case"contextmenu":ga=sd;break;case"drag":case"dragend":case"dragenter":case"dragexit":case"dragleave":case"dragover":case"dragstart":case"drop":ga=V0;break;case"touchcancel":case"touchend":case"touchmove":case"touchstart":ga=o2;break;case Nd:case Id:case Ad:ga=Y0;break;case Td:ga=s2;break;case"scroll":case"scrollend":ga=H0;break;case"wheel":ga=d2;break;case"copy":case"cut":case"paste":ga=Z0;break;case"gotpointercapture":case"lostpointercapture":case"pointercancel":case"pointerdown":case"pointermove":case"pointerout":case"pointerover":case"pointerup":ga=dd;break;case"toggle":case"beforetoggle":ga=h2}var Da=(ht&4)!==0,sn=!Da&&(lt==="scroll"||lt==="scrollend"),ca=Da?ya!==null?ya+"Capture":null:ya;Da=[];for(var ia=ha,ua;ia!==null;){var Ma=ia;if(ua=Ma.stateNode,Ma=Ma.tag,Ma!==5&&Ma!==26&&Ma!==27||ua===null||ca===null||(Ma=Fo(ia,ca),Ma!=null&&Da.push(mc(ia,Ma,ua))),sn)break;ia=ia.return}0<Da.length&&(ya=new ga(ya,Aa,null,gt,va),wa.push({event:ya,listeners:Da}))}}if((ht&7)===0){e:{if(ya=lt==="mouseover"||lt==="pointerover",ga=lt==="mouseout"||lt==="pointerout",ya&&gt!==Vs&&(Aa=gt.relatedTarget||gt.fromElement)&&(Sa(Aa)||Aa[Ti]))break e;if((ga||ya)&&(ya=va.window===va?va:(ya=va.ownerDocument)?ya.defaultView||ya.parentWindow:window,ga?(Aa=gt.relatedTarget||gt.toElement,ga=ha,Aa=Aa?Sa(Aa):null,Aa!==null&&(sn=pt(Aa),Da=Aa.tag,Aa!==sn||Da!==5&&Da!==27&&Da!==6)&&(Aa=null)):(ga=null,Aa=ha),ga!==Aa)){if(Da=sd,Ma="onMouseLeave",ca="onMouseEnter",ia="mouse",(lt==="pointerout"||lt==="pointerover")&&(Da=dd,Ma="onPointerLeave",ca="onPointerEnter",ia="pointer"),sn=ga==null?ya:tn(ga),ua=Aa==null?ya:tn(Aa),ya=new Da(Ma,ia+"leave",ga,gt,va),ya.target=sn,ya.relatedTarget=ua,Ma=null,Sa(va)===ha&&(Da=new Da(ca,ia+"enter",Aa,gt,va),Da.target=ua,Da.relatedTarget=sn,Ma=Da),sn=Ma,ga&&Aa)t:{for(Da=up,ca=ga,ia=Aa,ua=0,Ma=ca;Ma;Ma=Da(Ma))ua++;Ma=0;for(var Ba=ia;Ba;Ba=Da(Ba))Ma++;for(;0<ua-Ma;)ca=Da(ca),ua--;for(;0<Ma-ua;)ia=Da(ia),Ma--;for(;ua--;){if(ca===ia||ia!==null&&ca===ia.alternate){Da=ca;break t}ca=Da(ca),ia=Da(ia)}Da=null}else Da=null;ga!==null&&a0(wa,ya,ga,Da,!1),Aa!==null&&sn!==null&&a0(wa,sn,Aa,Da,!0)}}e:{if(ya=ha?tn(ha):window,ga=ya.nodeName&&ya.nodeName.toLowerCase(),ga==="select"||ga==="input"&&ya.type==="file")var Za=kd;else if(gd(ya))if(_d)Za=b2;else{Za=x2;var Ea=_2}else ga=ya.nodeName,!ga||ga.toLowerCase()!=="input"||ya.type!=="checkbox"&&ya.type!=="radio"?ha&&Us(ha.elementType)&&(Za=kd):Za=v2;if(Za&&(Za=Za(lt,ha))){md(wa,Za,gt,va);break e}Ea&&Ea(lt,ya,ha),lt==="focusout"&&ha&&ya.type==="number"&&ha.memoizedProps.value!=null&&Hs(ya,"number",ya.value)}switch(Ea=ha?tn(ha):window,lt){case"focusin":(gd(Ea)||Ea.contentEditable==="true")&&(Wr=Ea,il=ha,Go=null);break;case"focusout":Go=il=Wr=null;break;case"mousedown":rl=!0;break;case"contextmenu":case"mouseup":case"dragend":rl=!1,Sd(wa,gt,va);break;case"selectionchange":if(M2)break;case"keydown":case"keyup":Sd(wa,gt,va)}var za;if(el)e:{switch(lt){case"compositionstart":var Ya="onCompositionStart";break e;case"compositionend":Ya="onCompositionEnd";break e;case"compositionupdate":Ya="onCompositionUpdate";break e}Ya=void 0}else Gr?fd(lt,gt)&&(Ya="onCompositionEnd"):lt==="keydown"&&gt.keyCode===229&&(Ya="onCompositionStart");Ya&&(ud&&gt.locale!=="ko"&&(Gr||Ya!=="onCompositionStart"?Ya==="onCompositionEnd"&&Gr&&(za=od()):(Ji=va,Xs="value"in Ji?Ji.value:Ji.textContent,Gr=!0)),Ea=Ls(ha,Ya),0<Ea.length&&(Ya=new ld(Ya,lt,null,gt,va),wa.push({event:Ya,listeners:Ea}),za?Ya.data=za:(za=yd(gt),za!==null&&(Ya.data=za)))),(za=f2?y2(lt,gt):g2(lt,gt))&&(Ya=Ls(ha,"onBeforeInput"),0<Ya.length&&(Ea=new ld("onBeforeInput","beforeinput",null,gt,va),wa.push({event:Ea,listeners:Ya}),Ea.data=za)),cp(wa,lt,ha,gt,va)}e0(wa,ht)})}function mc(lt,ht,gt){return{instance:lt,listener:ht,currentTarget:gt}}function Ls(lt,ht){for(var gt=ht+"Capture",xt=[];lt!==null;){var Ct=lt,Lt=Ct.stateNode;if(Ct=Ct.tag,Ct!==5&&Ct!==26&&Ct!==27||Lt===null||(Ct=Fo(lt,gt),Ct!=null&&xt.unshift(mc(lt,Ct,Lt)),Ct=Fo(lt,ht),Ct!=null&&xt.push(mc(lt,Ct,Lt))),lt.tag===3)return xt;lt=lt.return}return[]}function up(lt){if(lt===null)return null;do lt=lt.return;while(lt&&lt.tag!==5&&lt.tag!==27);return lt||null}function a0(lt,ht,gt,xt,Ct){for(var Lt=ht._reactName,Dt=[];gt!==null&&gt!==xt;){var zt=gt,Jt=zt.alternate,ha=zt.stateNode;if(zt=zt.tag,Jt!==null&&Jt===xt)break;zt!==5&&zt!==26&&zt!==27||ha===null||(Jt=ha,Ct?(ha=Fo(gt,Lt),ha!=null&&Dt.unshift(mc(gt,ha,Jt))):Ct||(ha=Fo(gt,Lt),ha!=null&&Dt.push(mc(gt,ha,Jt)))),gt=gt.return}Dt.length!==0&&lt.push({event:ht,listeners:Dt})}var hp=/\r\n?/g,pp=/\u0000|\uFFFD/g;function n0(lt){return(typeof lt=="string"?lt:""+lt).replace(hp,`
-`).replace(pp,"")}function i0(lt,ht){return ht=n0(ht),n0(lt)===ht}function cn(lt,ht,gt,xt,Ct,Lt){switch(gt){case"children":typeof xt=="string"?ht==="body"||ht==="textarea"&&xt===""||Hr(lt,xt):(typeof xt=="number"||typeof xt=="bigint")&&ht!=="body"&&Hr(lt,""+xt);break;case"className":Ic(lt,"class",xt);break;case"tabIndex":Ic(lt,"tabindex",xt);break;case"dir":case"role":case"viewBox":case"width":case"height":Ic(lt,gt,xt);break;case"style":ad(lt,xt,Lt);break;case"data":if(ht!=="object"){Ic(lt,"data",xt);break}case"src":case"href":if(xt===""&&(ht!=="a"||gt!=="href")){lt.removeAttribute(gt);break}if(xt==null||typeof xt=="function"||typeof xt=="symbol"||typeof xt=="boolean"){lt.removeAttribute(gt);break}xt=Tc(""+xt),lt.setAttribute(gt,xt);break;case"action":case"formAction":if(typeof xt=="function"){lt.setAttribute(gt,"javascript:throw new Error('A React form was unexpectedly submitted. If you called form.submit() manually, consider using form.requestSubmit() instead. If you\\'re trying to use event.stopPropagation() in a submit event handler, consider also calling event.preventDefault().')");break}else typeof Lt=="function"&&(gt==="formAction"?(ht!=="input"&&cn(lt,ht,"name",Ct.name,Ct,null),cn(lt,ht,"formEncType",Ct.formEncType,Ct,null),cn(lt,ht,"formMethod",Ct.formMethod,Ct,null),cn(lt,ht,"formTarget",Ct.formTarget,Ct,null)):(cn(lt,ht,"encType",Ct.encType,Ct,null),cn(lt,ht,"method",Ct.method,Ct,null),cn(lt,ht,"target",Ct.target,Ct,null)));if(xt==null||typeof xt=="symbol"||typeof xt=="boolean"){lt.removeAttribute(gt);break}xt=Tc(""+xt),lt.setAttribute(gt,xt);break;case"onClick":xt!=null&&(lt.onclick=Ri);break;case"onScroll":xt!=null&&Ga("scroll",lt);break;case"onScrollEnd":xt!=null&&Ga("scrollend",lt);break;case"dangerouslySetInnerHTML":if(xt!=null){if(typeof xt!="object"||!("__html"in xt))throw Error(dt(61));if(gt=xt.__html,gt!=null){if(Ct.children!=null)throw Error(dt(60));lt.innerHTML=gt}}break;case"multiple":lt.multiple=xt&&typeof xt!="function"&&typeof xt!="symbol";break;case"muted":lt.muted=xt&&typeof xt!="function"&&typeof xt!="symbol";break;case"suppressContentEditableWarning":case"suppressHydrationWarning":case"defaultValue":case"defaultChecked":case"innerHTML":case"ref":break;case"autoFocus":break;case"xlinkHref":if(xt==null||typeof xt=="function"||typeof xt=="boolean"||typeof xt=="symbol"){lt.removeAttribute("xlink:href");break}gt=Tc(""+xt),lt.setAttributeNS("http://www.w3.org/1999/xlink","xlink:href",gt);break;case"contentEditable":case"spellCheck":case"draggable":case"value":case"autoReverse":case"externalResourcesRequired":case"focusable":case"preserveAlpha":xt!=null&&typeof xt!="function"&&typeof xt!="symbol"?lt.setAttribute(gt,""+xt):lt.removeAttribute(gt);break;case"inert":case"allowFullScreen":case"async":case"autoPlay":case"controls":case"default":case"defer":case"disabled":case"disablePictureInPicture":case"disableRemotePlayback":case"formNoValidate":case"hidden":case"loop":case"noModule":case"noValidate":case"open":case"playsInline":case"readOnly":case"required":case"reversed":case"scoped":case"seamless":case"itemScope":xt&&typeof xt!="function"&&typeof xt!="symbol"?lt.setAttribute(gt,""):lt.removeAttribute(gt);break;case"capture":case"download":xt===!0?lt.setAttribute(gt,""):xt!==!1&&xt!=null&&typeof xt!="function"&&typeof xt!="symbol"?lt.setAttribute(gt,xt):lt.removeAttribute(gt);break;case"cols":case"rows":case"size":case"span":xt!=null&&typeof xt!="function"&&typeof xt!="symbol"&&!isNaN(xt)&&1<=xt?lt.setAttribute(gt,xt):lt.removeAttribute(gt);break;case"rowSpan":case"start":xt==null||typeof xt=="function"||typeof xt=="symbol"||isNaN(xt)?lt.removeAttribute(gt):lt.setAttribute(gt,xt);break;case"popover":Ga("beforetoggle",lt),Ga("toggle",lt),Nc(lt,"popover",xt);break;case"xlinkActuate":Ei(lt,"http://www.w3.org/1999/xlink","xlink:actuate",xt);break;case"xlinkArcrole":Ei(lt,"http://www.w3.org/1999/xlink","xlink:arcrole",xt);break;case"xlinkRole":Ei(lt,"http://www.w3.org/1999/xlink","xlink:role",xt);break;case"xlinkShow":Ei(lt,"http://www.w3.org/1999/xlink","xlink:show",xt);break;case"xlinkTitle":Ei(lt,"http://www.w3.org/1999/xlink","xlink:title",xt);break;case"xlinkType":Ei(lt,"http://www.w3.org/1999/xlink","xlink:type",xt);break;case"xmlBase":Ei(lt,"http://www.w3.org/XML/1998/namespace","xml:base",xt);break;case"xmlLang":Ei(lt,"http://www.w3.org/XML/1998/namespace","xml:lang",xt);break;case"xmlSpace":Ei(lt,"http://www.w3.org/XML/1998/namespace","xml:space",xt);break;case"is":Nc(lt,"is",xt);break;case"innerText":case"textContent":break;default:(!(2<gt.length)||gt[0]!=="o"&&gt[0]!=="O"||gt[1]!=="n"&&gt[1]!=="N")&&(gt=O0.get(gt)||gt,Nc(lt,gt,xt))}}function I1(lt,ht,gt,xt,Ct,Lt){switch(gt){case"style":ad(lt,xt,Lt);break;case"dangerouslySetInnerHTML":if(xt!=null){if(typeof xt!="object"||!("__html"in xt))throw Error(dt(61));if(gt=xt.__html,gt!=null){if(Ct.children!=null)throw Error(dt(60));lt.innerHTML=gt}}break;case"children":typeof xt=="string"?Hr(lt,xt):(typeof xt=="number"||typeof xt=="bigint")&&Hr(lt,""+xt);break;case"onScroll":xt!=null&&Ga("scroll",lt);break;case"onScrollEnd":xt!=null&&Ga("scrollend",lt);break;case"onClick":xt!=null&&(lt.onclick=Ri);break;case"suppressContentEditableWarning":case"suppressHydrationWarning":case"innerHTML":case"ref":break;case"innerText":case"textContent":break;default:if(!li.hasOwnProperty(gt))e:{if(gt[0]==="o"&&gt[1]==="n"&&(Ct=gt.endsWith("Capture"),ht=gt.slice(2,Ct?gt.length-7:void 0),Lt=lt[fn]||null,Lt=Lt!=null?Lt[gt]:null,typeof Lt=="function"&&lt.removeEventListener(ht,Lt,Ct),typeof xt=="function")){typeof Lt!="function"&&Lt!==null&&(gt in lt?lt[gt]=null:lt.hasAttribute(gt)&&lt.removeAttribute(gt)),lt.addEventListener(ht,xt,Ct);break e}gt in lt?lt[gt]=xt:xt===!0?lt.setAttribute(gt,""):Nc(lt,gt,xt)}}}function qn(lt,ht,gt){switch(ht){case"div":case"span":case"svg":case"path":case"a":case"g":case"p":case"li":break;case"img":Ga("error",lt),Ga("load",lt);var xt=!1,Ct=!1,Lt;for(Lt in gt)if(gt.hasOwnProperty(Lt)){var Dt=gt[Lt];if(Dt!=null)switch(Lt){case"src":xt=!0;break;case"srcSet":Ct=!0;break;case"children":case"dangerouslySetInnerHTML":throw Error(dt(137,ht));default:cn(lt,ht,Lt,Dt,gt,null)}}Ct&&cn(lt,ht,"srcSet",gt.srcSet,gt,null),xt&&cn(lt,ht,"src",gt.src,gt,null);return;case"input":Ga("invalid",lt);var zt=Lt=Dt=Ct=null,Jt=null,ha=null;for(xt in gt)if(gt.hasOwnProperty(xt)){var va=gt[xt];if(va!=null)switch(xt){case"name":Ct=va;break;case"type":Dt=va;break;case"checked":Jt=va;break;case"defaultChecked":ha=va;break;case"value":Lt=va;break;case"defaultValue":zt=va;break;case"children":case"dangerouslySetInnerHTML":if(va!=null)throw Error(dt(137,ht));break;default:cn(lt,ht,xt,va,gt,null)}}Q1(lt,Lt,zt,Jt,ha,Dt,Ct,!1);return;case"select":Ga("invalid",lt),xt=Dt=Lt=null;for(Ct in gt)if(gt.hasOwnProperty(Ct)&&(zt=gt[Ct],zt!=null))switch(Ct){case"value":Lt=zt;break;case"defaultValue":Dt=zt;break;case"multiple":xt=zt;default:cn(lt,ht,Ct,zt,gt,null)}ht=Lt,gt=Dt,lt.multiple=!!xt,ht!=null?zr(lt,!!xt,ht,!1):gt!=null&&zr(lt,!!xt,gt,!0);return;case"textarea":Ga("invalid",lt),Lt=Ct=xt=null;for(Dt in gt)if(gt.hasOwnProperty(Dt)&&(zt=gt[Dt],zt!=null))switch(Dt){case"value":xt=zt;break;case"defaultValue":Ct=zt;break;case"children":Lt=zt;break;case"dangerouslySetInnerHTML":if(zt!=null)throw Error(dt(91));break;default:cn(lt,ht,Dt,zt,gt,null)}ed(lt,xt,Ct,Lt);return;case"option":for(Jt in gt)if(gt.hasOwnProperty(Jt)&&(xt=gt[Jt],xt!=null))switch(Jt){case"selected":lt.selected=xt&&typeof xt!="function"&&typeof xt!="symbol";break;default:cn(lt,ht,Jt,xt,gt,null)}return;case"dialog":Ga("beforetoggle",lt),Ga("toggle",lt),Ga("cancel",lt),Ga("close",lt);break;case"iframe":case"object":Ga("load",lt);break;case"video":case"audio":for(xt=0;xt<gc.length;xt++)Ga(gc[xt],lt);break;case"image":Ga("error",lt),Ga("load",lt);break;case"details":Ga("toggle",lt);break;case"embed":case"source":case"link":Ga("error",lt),Ga("load",lt);case"area":case"base":case"br":case"col":case"hr":case"keygen":case"meta":case"param":case"track":case"wbr":case"menuitem":for(ha in gt)if(gt.hasOwnProperty(ha)&&(xt=gt[ha],xt!=null))switch(ha){case"children":case"dangerouslySetInnerHTML":throw Error(dt(137,ht));default:cn(lt,ht,ha,xt,gt,null)}return;default:if(Us(ht)){for(va in gt)gt.hasOwnProperty(va)&&(xt=gt[va],xt!==void 0&&I1(lt,ht,va,xt,gt,void 0));return}}for(zt in gt)gt.hasOwnProperty(zt)&&(xt=gt[zt],xt!=null&&cn(lt,ht,zt,xt,gt,null))}function fp(lt,ht,gt,xt){switch(ht){case"div":case"span":case"svg":case"path":case"a":case"g":case"p":case"li":break;case"input":var Ct=null,Lt=null,Dt=null,zt=null,Jt=null,ha=null,va=null;for(ga in gt){var wa=gt[ga];if(gt.hasOwnProperty(ga)&&wa!=null)switch(ga){case"checked":break;case"value":break;case"defaultValue":Jt=wa;default:xt.hasOwnProperty(ga)||cn(lt,ht,ga,null,xt,wa)}}for(var ya in xt){var ga=xt[ya];if(wa=gt[ya],xt.hasOwnProperty(ya)&&(ga!=null||wa!=null))switch(ya){case"type":Lt=ga;break;case"name":Ct=ga;break;case"checked":ha=ga;break;case"defaultChecked":va=ga;break;case"value":Dt=ga;break;case"defaultValue":zt=ga;break;case"children":case"dangerouslySetInnerHTML":if(ga!=null)throw Error(dt(137,ht));break;default:ga!==wa&&cn(lt,ht,ya,ga,xt,wa)}}zs(lt,Dt,zt,Jt,ha,va,Lt,Ct);return;case"select":ga=Dt=zt=ya=null;for(Lt in gt)if(Jt=gt[Lt],gt.hasOwnProperty(Lt)&&Jt!=null)switch(Lt){case"value":break;case"multiple":ga=Jt;default:xt.hasOwnProperty(Lt)||cn(lt,ht,Lt,null,xt,Jt)}for(Ct in xt)if(Lt=xt[Ct],Jt=gt[Ct],xt.hasOwnProperty(Ct)&&(Lt!=null||Jt!=null))switch(Ct){case"value":ya=Lt;break;case"defaultValue":zt=Lt;break;case"multiple":Dt=Lt;default:Lt!==Jt&&cn(lt,ht,Ct,Lt,xt,Jt)}ht=zt,gt=Dt,xt=ga,ya!=null?zr(lt,!!gt,ya,!1):!!xt!=!!gt&&(ht!=null?zr(lt,!!gt,ht,!0):zr(lt,!!gt,gt?[]:"",!1));return;case"textarea":ga=ya=null;for(zt in gt)if(Ct=gt[zt],gt.hasOwnProperty(zt)&&Ct!=null&&!xt.hasOwnProperty(zt))switch(zt){case"value":break;case"children":break;default:cn(lt,ht,zt,null,xt,Ct)}for(Dt in xt)if(Ct=xt[Dt],Lt=gt[Dt],xt.hasOwnProperty(Dt)&&(Ct!=null||Lt!=null))switch(Dt){case"value":ya=Ct;break;case"defaultValue":ga=Ct;break;case"children":break;case"dangerouslySetInnerHTML":if(Ct!=null)throw Error(dt(91));break;default:Ct!==Lt&&cn(lt,ht,Dt,Ct,xt,Lt)}J1(lt,ya,ga);return;case"option":for(var Aa in gt)if(ya=gt[Aa],gt.hasOwnProperty(Aa)&&ya!=null&&!xt.hasOwnProperty(Aa))switch(Aa){case"selected":lt.selected=!1;break;default:cn(lt,ht,Aa,null,xt,ya)}for(Jt in xt)if(ya=xt[Jt],ga=gt[Jt],xt.hasOwnProperty(Jt)&&ya!==ga&&(ya!=null||ga!=null))switch(Jt){case"selected":lt.selected=ya&&typeof ya!="function"&&typeof ya!="symbol";break;default:cn(lt,ht,Jt,ya,xt,ga)}return;case"img":case"link":case"area":case"base":case"br":case"col":case"embed":case"hr":case"keygen":case"meta":case"param":case"source":case"track":case"wbr":case"menuitem":for(var Da in gt)ya=gt[Da],gt.hasOwnProperty(Da)&&ya!=null&&!xt.hasOwnProperty(Da)&&cn(lt,ht,Da,null,xt,ya);for(ha in xt)if(ya=xt[ha],ga=gt[ha],xt.hasOwnProperty(ha)&&ya!==ga&&(ya!=null||ga!=null))switch(ha){case"children":case"dangerouslySetInnerHTML":if(ya!=null)throw Error(dt(137,ht));break;default:cn(lt,ht,ha,ya,xt,ga)}return;default:if(Us(ht)){for(var sn in gt)ya=gt[sn],gt.hasOwnProperty(sn)&&ya!==void 0&&!xt.hasOwnProperty(sn)&&I1(lt,ht,sn,void 0,xt,ya);for(va in xt)ya=xt[va],ga=gt[va],!xt.hasOwnProperty(va)||ya===ga||ya===void 0&&ga===void 0||I1(lt,ht,va,ya,xt,ga);return}}for(var ca in gt)ya=gt[ca],gt.hasOwnProperty(ca)&&ya!=null&&!xt.hasOwnProperty(ca)&&cn(lt,ht,ca,null,xt,ya);for(wa in xt)ya=xt[wa],ga=gt[wa],!xt.hasOwnProperty(wa)||ya===ga||ya==null&&ga==null||cn(lt,ht,wa,ya,xt,ga)}function r0(lt){switch(lt){case"css":case"script":case"font":case"img":case"image":case"input":case"link":return!0;default:return!1}}function yp(){if(typeof performance.getEntriesByType=="function"){for(var lt=0,ht=0,gt=performance.getEntriesByType("resource"),xt=0;xt<gt.length;xt++){var Ct=gt[xt],Lt=Ct.transferSize,Dt=Ct.initiatorType,zt=Ct.duration;if(Lt&&zt&&r0(Dt)){for(Dt=0,zt=Ct.responseEnd,xt+=1;xt<gt.length;xt++){var Jt=gt[xt],ha=Jt.startTime;if(ha>zt)break;var va=Jt.transferSize,wa=Jt.initiatorType;va&&r0(wa)&&(Jt=Jt.responseEnd,Dt+=va*(Jt<zt?1:(zt-ha)/(Jt-ha)))}if(--xt,ht+=8*(Lt+Dt)/(Ct.duration/1e3),lt++,10<lt)break}}if(0<lt)return ht/lt/1e6}return navigator.connection&&(lt=navigator.connection.downlink,typeof lt=="number")?lt:5}var A1=null,T1=null;function Ss(lt){return lt.nodeType===9?lt:lt.ownerDocument}function o0(lt){switch(lt){case"http://www.w3.org/2000/svg":return 1;case"http://www.w3.org/1998/Math/MathML":return 2;default:return 0}}function c0(lt,ht){if(lt===0)switch(ht){case"svg":return 1;case"math":return 2;default:return 0}return lt===1&&ht==="foreignObject"?0:lt}function E1(lt,ht){return lt==="textarea"||lt==="noscript"||typeof ht.children=="string"||typeof ht.children=="number"||typeof ht.children=="bigint"||typeof ht.dangerouslySetInnerHTML=="object"&&ht.dangerouslySetInnerHTML!==null&&ht.dangerouslySetInnerHTML.__html!=null}var R1=null;function gp(){var lt=window.event;return lt&&lt.type==="popstate"?lt===R1?!1:(R1=lt,!0):(R1=null,!1)}var s0=typeof setTimeout=="function"?setTimeout:void 0,mp=typeof clearTimeout=="function"?clearTimeout:void 0,l0=typeof Promise=="function"?Promise:void 0,kp=typeof queueMicrotask=="function"?queueMicrotask:typeof l0<"u"?function(lt){return l0.resolve(null).then(lt).catch(_p)}:s0;function _p(lt){setTimeout(function(){throw lt})}function gr(lt){return lt==="head"}function d0(lt,ht){var gt=ht,xt=0;do{var Ct=gt.nextSibling;if(lt.removeChild(gt),Ct&&Ct.nodeType===8)if(gt=Ct.data,gt==="/$"||gt==="/&"){if(xt===0){lt.removeChild(Ct),vo(ht);return}xt--}else if(gt==="$"||gt==="$?"||gt==="$~"||gt==="$!"||gt==="&")xt++;else if(gt==="html")kc(lt.ownerDocument.documentElement);else if(gt==="head"){gt=lt.ownerDocument.head,kc(gt);for(var Lt=gt.firstChild;Lt;){var Dt=Lt.nextSibling,zt=Lt.nodeName;Lt[Ta]||zt==="SCRIPT"||zt==="STYLE"||zt==="LINK"&&Lt.rel.toLowerCase()==="stylesheet"||gt.removeChild(Lt),Lt=Dt}}else gt==="body"&&kc(lt.ownerDocument.body);gt=Ct}while(gt);vo(ht)}function u0(lt,ht){var gt=lt;lt=0;do{var xt=gt.nextSibling;if(gt.nodeType===1?ht?(gt._stashedDisplay=gt.style.display,gt.style.display="none"):(gt.style.display=gt._stashedDisplay||"",gt.getAttribute("style")===""&&gt.removeAttribute("style")):gt.nodeType===3&&(ht?(gt._stashedText=gt.nodeValue,gt.nodeValue=""):gt.nodeValue=gt._stashedText||""),xt&&xt.nodeType===8)if(gt=xt.data,gt==="/$"){if(lt===0)break;lt--}else gt!=="$"&&gt!=="$?"&&gt!=="$~"&&gt!=="$!"||lt++;gt=xt}while(gt)}function B1(lt){var ht=lt.firstChild;for(ht&&ht.nodeType===10&&(ht=ht.nextSibling);ht;){var gt=ht;switch(ht=ht.nextSibling,gt.nodeName){case"HTML":case"HEAD":case"BODY":B1(gt),na(gt);continue;case"SCRIPT":case"STYLE":continue;case"LINK":if(gt.rel.toLowerCase()==="stylesheet")continue}lt.removeChild(gt)}}function xp(lt,ht,gt,xt){for(;lt.nodeType===1;){var Ct=gt;if(lt.nodeName.toLowerCase()!==ht.toLowerCase()){if(!xt&&(lt.nodeName!=="INPUT"||lt.type!=="hidden"))break}else if(xt){if(!lt[Ta])switch(ht){case"meta":if(!lt.hasAttribute("itemprop"))break;return lt;case"link":if(Lt=lt.getAttribute("rel"),Lt==="stylesheet"&&lt.hasAttribute("data-precedence"))break;if(Lt!==Ct.rel||lt.getAttribute("href")!==(Ct.href==null||Ct.href===""?null:Ct.href)||lt.getAttribute("crossorigin")!==(Ct.crossOrigin==null?null:Ct.crossOrigin)||lt.getAttribute("title")!==(Ct.title==null?null:Ct.title))break;return lt;case"style":if(lt.hasAttribute("data-precedence"))break;return lt;case"script":if(Lt=lt.getAttribute("src"),(Lt!==(Ct.src==null?null:Ct.src)||lt.getAttribute("type")!==(Ct.type==null?null:Ct.type)||lt.getAttribute("crossorigin")!==(Ct.crossOrigin==null?null:Ct.crossOrigin))&&Lt&&lt.hasAttribute("async")&&!lt.hasAttribute("itemprop"))break;return lt;default:return lt}}else if(ht==="input"&&lt.type==="hidden"){var Lt=Ct.name==null?null:""+Ct.name;if(Ct.type==="hidden"&&lt.getAttribute("name")===Lt)return lt}else return lt;if(lt=_i(lt.nextSibling),lt===null)break}return null}function vp(lt,ht,gt){if(ht==="")return null;for(;lt.nodeType!==3;)if((lt.nodeType!==1||lt.nodeName!=="INPUT"||lt.type!=="hidden")&&!gt||(lt=_i(lt.nextSibling),lt===null))return null;return lt}function h0(lt,ht){for(;lt.nodeType!==8;)if((lt.nodeType!==1||lt.nodeName!=="INPUT"||lt.type!=="hidden")&&!ht||(lt=_i(lt.nextSibling),lt===null))return null;return lt}function D1(lt){return lt.data==="$?"||lt.data==="$~"}function P1(lt){return lt.data==="$!"||lt.data==="$?"&&lt.ownerDocument.readyState!=="loading"}function bp(lt,ht){var gt=lt.ownerDocument;if(lt.data==="$~")lt._reactRetry=ht;else if(lt.data!=="$?"||gt.readyState!=="loading")ht();else{var xt=function(){ht(),gt.removeEventListener("DOMContentLoaded",xt)};gt.addEventListener("DOMContentLoaded",xt),lt._reactRetry=xt}}function _i(lt){for(;lt!=null;lt=lt.nextSibling){var ht=lt.nodeType;if(ht===1||ht===3)break;if(ht===8){if(ht=lt.data,ht==="$"||ht==="$!"||ht==="$?"||ht==="$~"||ht==="&"||ht==="F!"||ht==="F")break;if(ht==="/$"||ht==="/&")return null}}return lt}var F1=null;function p0(lt){lt=lt.nextSibling;for(var ht=0;lt;){if(lt.nodeType===8){var gt=lt.data;if(gt==="/$"||gt==="/&"){if(ht===0)return _i(lt.nextSibling);ht--}else gt!=="$"&&gt!=="$!"&&gt!=="$?"&&gt!=="$~"&&gt!=="&"||ht++}lt=lt.nextSibling}return null}function f0(lt){lt=lt.previousSibling;for(var ht=0;lt;){if(lt.nodeType===8){var gt=lt.data;if(gt==="$"||gt==="$!"||gt==="$?"||gt==="$~"||gt==="&"){if(ht===0)return lt;ht--}else gt!=="/$"&&gt!=="/&"||ht++}lt=lt.previousSibling}return null}function y0(lt,ht,gt){switch(ht=Ss(gt),lt){case"html":if(lt=ht.documentElement,!lt)throw Error(dt(452));return lt;case"head":if(lt=ht.head,!lt)throw Error(dt(453));return lt;case"body":if(lt=ht.body,!lt)throw Error(dt(454));return lt;default:throw Error(dt(451))}}function kc(lt){for(var ht=lt.attributes;ht.length;)lt.removeAttributeNode(ht[0]);na(lt)}var xi=new Map,g0=new Set;function $s(lt){return typeof lt.getRootNode=="function"?lt.getRootNode():lt.nodeType===9?lt:lt.ownerDocument}var Ki=ea.d;ea.d={f:Cp,r:Mp,D:wp,C:Lp,L:Sp,m:$p,X:Ip,S:Np,M:Ap};function Cp(){var lt=Ki.f(),ht=_s();return lt||ht}function Mp(lt){var ht=Ia(lt);ht!==null&&ht.tag===5&&ht.type==="form"?Eu(ht):Ki.r(lt)}var ko=typeof document>"u"?null:document;function m0(lt,ht,gt){var xt=ko;if(xt&&typeof ht=="string"&&ht){var Ct=ui(ht);Ct='link[rel="'+lt+'"][href="'+Ct+'"]',typeof gt=="string"&&(Ct+='[crossorigin="'+gt+'"]'),g0.has(Ct)||(g0.add(Ct),lt={rel:lt,crossOrigin:gt,href:ht},xt.querySelector(Ct)===null&&(ht=xt.createElement("link"),qn(ht,"link",lt),Ua(ht),xt.head.appendChild(ht)))}}function wp(lt){Ki.D(lt),m0("dns-prefetch",lt,null)}function Lp(lt,ht){Ki.C(lt,ht),m0("preconnect",lt,ht)}function Sp(lt,ht,gt){Ki.L(lt,ht,gt);var xt=ko;if(xt&&lt&&ht){var Ct='link[rel="preload"][as="'+ui(ht)+'"]';ht==="image"&&gt&&gt.imageSrcSet?(Ct+='[imagesrcset="'+ui(gt.imageSrcSet)+'"]',typeof gt.imageSizes=="string"&&(Ct+='[imagesizes="'+ui(gt.imageSizes)+'"]')):Ct+='[href="'+ui(lt)+'"]';var Lt=Ct;switch(ht){case"style":Lt=_o(lt);break;case"script":Lt=xo(lt)}xi.has(Lt)||(lt=vt({rel:"preload",href:ht==="image"&&gt&&gt.imageSrcSet?void 0:lt,as:ht},gt),xi.set(Lt,lt),xt.querySelector(Ct)!==null||ht==="style"&&xt.querySelector(_c(Lt))||ht==="script"&&xt.querySelector(xc(Lt))||(ht=xt.createElement("link"),qn(ht,"link",lt),Ua(ht),xt.head.appendChild(ht)))}}function $p(lt,ht){Ki.m(lt,ht);var gt=ko;if(gt&&lt){var xt=ht&&typeof ht.as=="string"?ht.as:"script",Ct='link[rel="modulepreload"][as="'+ui(xt)+'"][href="'+ui(lt)+'"]',Lt=Ct;switch(xt){case"audioworklet":case"paintworklet":case"serviceworker":case"sharedworker":case"worker":case"script":Lt=xo(lt)}if(!xi.has(Lt)&&(lt=vt({rel:"modulepreload",href:lt},ht),xi.set(Lt,lt),gt.querySelector(Ct)===null)){switch(xt){case"audioworklet":case"paintworklet":case"serviceworker":case"sharedworker":case"worker":case"script":if(gt.querySelector(xc(Lt)))return}xt=gt.createElement("link"),qn(xt,"link",lt),Ua(xt),gt.head.appendChild(xt)}}}function Np(lt,ht,gt){Ki.S(lt,ht,gt);var xt=ko;if(xt&&lt){var Ct=mn(xt).hoistableStyles,Lt=_o(lt);ht=ht||"default";var Dt=Ct.get(Lt);if(!Dt){var zt={loading:0,preload:null};if(Dt=xt.querySelector(_c(Lt)))zt.loading=5;else{lt=vt({rel:"stylesheet",href:lt,"data-precedence":ht},gt),(gt=xi.get(Lt))&&q1(lt,gt);var Jt=Dt=xt.createElement("link");Ua(Jt),qn(Jt,"link",lt),Jt._p=new Promise(function(ha,va){Jt.onload=ha,Jt.onerror=va}),Jt.addEventListener("load",function(){zt.loading|=1}),Jt.addEventListener("error",function(){zt.loading|=2}),zt.loading|=4,Ns(Dt,ht,xt)}Dt={type:"stylesheet",instance:Dt,count:1,state:zt},Ct.set(Lt,Dt)}}}function Ip(lt,ht){Ki.X(lt,ht);var gt=ko;if(gt&&lt){var xt=mn(gt).hoistableScripts,Ct=xo(lt),Lt=xt.get(Ct);Lt||(Lt=gt.querySelector(xc(Ct)),Lt||(lt=vt({src:lt,async:!0},ht),(ht=xi.get(Ct))&&j1(lt,ht),Lt=gt.createElement("script"),Ua(Lt),qn(Lt,"link",lt),gt.head.appendChild(Lt)),Lt={type:"script",instance:Lt,count:1,state:null},xt.set(Ct,Lt))}}function Ap(lt,ht){Ki.M(lt,ht);var gt=ko;if(gt&&lt){var xt=mn(gt).hoistableScripts,Ct=xo(lt),Lt=xt.get(Ct);Lt||(Lt=gt.querySelector(xc(Ct)),Lt||(lt=vt({src:lt,async:!0,type:"module"},ht),(ht=xi.get(Ct))&&j1(lt,ht),Lt=gt.createElement("script"),Ua(Lt),qn(Lt,"link",lt),gt.head.appendChild(Lt)),Lt={type:"script",instance:Lt,count:1,state:null},xt.set(Ct,Lt))}}function k0(lt,ht,gt,xt){var Ct=(Ct=$a.current)?$s(Ct):null;if(!Ct)throw Error(dt(446));switch(lt){case"meta":case"title":return null;case"style":return typeof gt.precedence=="string"&&typeof gt.href=="string"?(ht=_o(gt.href),gt=mn(Ct).hoistableStyles,xt=gt.get(ht),xt||(xt={type:"style",instance:null,count:0,state:null},gt.set(ht,xt)),xt):{type:"void",instance:null,count:0,state:null};case"link":if(gt.rel==="stylesheet"&&typeof gt.href=="string"&&typeof gt.precedence=="string"){lt=_o(gt.href);var Lt=mn(Ct).hoistableStyles,Dt=Lt.get(lt);if(Dt||(Ct=Ct.ownerDocument||Ct,Dt={type:"stylesheet",instance:null,count:0,state:{loading:0,preload:null}},Lt.set(lt,Dt),(Lt=Ct.querySelector(_c(lt)))&&!Lt._p&&(Dt.instance=Lt,Dt.state.loading=5),xi.has(lt)||(gt={rel:"preload",as:"style",href:gt.href,crossOrigin:gt.crossOrigin,integrity:gt.integrity,media:gt.media,hrefLang:gt.hrefLang,referrerPolicy:gt.referrerPolicy},xi.set(lt,gt),Lt||Tp(Ct,lt,gt,Dt.state))),ht&&xt===null)throw Error(dt(528,""));return Dt}if(ht&&xt!==null)throw Error(dt(529,""));return null;case"script":return ht=gt.async,gt=gt.src,typeof gt=="string"&&ht&&typeof ht!="function"&&typeof ht!="symbol"?(ht=xo(gt),gt=mn(Ct).hoistableScripts,xt=gt.get(ht),xt||(xt={type:"script",instance:null,count:0,state:null},gt.set(ht,xt)),xt):{type:"void",instance:null,count:0,state:null};default:throw Error(dt(444,lt))}}function _o(lt){return'href="'+ui(lt)+'"'}function _c(lt){return'link[rel="stylesheet"]['+lt+"]"}function _0(lt){return vt({},lt,{"data-precedence":lt.precedence,precedence:null})}function Tp(lt,ht,gt,xt){lt.querySelector('link[rel="preload"][as="style"]['+ht+"]")?xt.loading=1:(ht=lt.createElement("link"),xt.preload=ht,ht.addEventListener("load",function(){return xt.loading|=1}),ht.addEventListener("error",function(){return xt.loading|=2}),qn(ht,"link",gt),Ua(ht),lt.head.appendChild(ht))}function xo(lt){return'[src="'+ui(lt)+'"]'}function xc(lt){return"script[async]"+lt}function x0(lt,ht,gt){if(ht.count++,ht.instance===null)switch(ht.type){case"style":var xt=lt.querySelector('style[data-href~="'+ui(gt.href)+'"]');if(xt)return ht.instance=xt,Ua(xt),xt;var Ct=vt({},gt,{"data-href":gt.href,"data-precedence":gt.precedence,href:null,precedence:null});return xt=(lt.ownerDocument||lt).createElement("style"),Ua(xt),qn(xt,"style",Ct),Ns(xt,gt.precedence,lt),ht.instance=xt;case"stylesheet":Ct=_o(gt.href);var Lt=lt.querySelector(_c(Ct));if(Lt)return ht.state.loading|=4,ht.instance=Lt,Ua(Lt),Lt;xt=_0(gt),(Ct=xi.get(Ct))&&q1(xt,Ct),Lt=(lt.ownerDocument||lt).createElement("link"),Ua(Lt);var Dt=Lt;return Dt._p=new Promise(function(zt,Jt){Dt.onload=zt,Dt.onerror=Jt}),qn(Lt,"link",xt),ht.state.loading|=4,Ns(Lt,gt.precedence,lt),ht.instance=Lt;case"script":return Lt=xo(gt.src),(Ct=lt.querySelector(xc(Lt)))?(ht.instance=Ct,Ua(Ct),Ct):(xt=gt,(Ct=xi.get(Lt))&&(xt=vt({},gt),j1(xt,Ct)),lt=lt.ownerDocument||lt,Ct=lt.createElement("script"),Ua(Ct),qn(Ct,"link",xt),lt.head.appendChild(Ct),ht.instance=Ct);case"void":return null;default:throw Error(dt(443,ht.type))}else ht.type==="stylesheet"&&(ht.state.loading&4)===0&&(xt=ht.instance,ht.state.loading|=4,Ns(xt,gt.precedence,lt));return ht.instance}function Ns(lt,ht,gt){for(var xt=gt.querySelectorAll('link[rel="stylesheet"][data-precedence],style[data-precedence]'),Ct=xt.length?xt[xt.length-1]:null,Lt=Ct,Dt=0;Dt<xt.length;Dt++){var zt=xt[Dt];if(zt.dataset.precedence===ht)Lt=zt;else if(Lt!==Ct)break}Lt?Lt.parentNode.insertBefore(lt,Lt.nextSibling):(ht=gt.nodeType===9?gt.head:gt,ht.insertBefore(lt,ht.firstChild))}function q1(lt,ht){lt.crossOrigin==null&&(lt.crossOrigin=ht.crossOrigin),lt.referrerPolicy==null&&(lt.referrerPolicy=ht.referrerPolicy),lt.title==null&&(lt.title=ht.title)}function j1(lt,ht){lt.crossOrigin==null&&(lt.crossOrigin=ht.crossOrigin),lt.referrerPolicy==null&&(lt.referrerPolicy=ht.referrerPolicy),lt.integrity==null&&(lt.integrity=ht.integrity)}var Is=null;function v0(lt,ht,gt){if(Is===null){var xt=new Map,Ct=Is=new Map;Ct.set(gt,xt)}else Ct=Is,xt=Ct.get(gt),xt||(xt=new Map,Ct.set(gt,xt));if(xt.has(lt))return xt;for(xt.set(lt,null),gt=gt.getElementsByTagName(lt),Ct=0;Ct<gt.length;Ct++){var Lt=gt[Ct];if(!(Lt[Ta]||Lt[Ln]||lt==="link"&&Lt.getAttribute("rel")==="stylesheet")&&Lt.namespaceURI!=="http://www.w3.org/2000/svg"){var Dt=Lt.getAttribute(ht)||"";Dt=lt+Dt;var zt=xt.get(Dt);zt?zt.push(Lt):xt.set(Dt,[Lt])}}return xt}function b0(lt,ht,gt){lt=lt.ownerDocument||lt,lt.head.insertBefore(gt,ht==="title"?lt.querySelector("head > title"):null)}function Ep(lt,ht,gt){if(gt===1||ht.itemProp!=null)return!1;switch(lt){case"meta":case"title":return!0;case"style":if(typeof ht.precedence!="string"||typeof ht.href!="string"||ht.href==="")break;return!0;case"link":if(typeof ht.rel!="string"||typeof ht.href!="string"||ht.href===""||ht.onLoad||ht.onError)break;switch(ht.rel){case"stylesheet":return lt=ht.disabled,typeof ht.precedence=="string"&&lt==null;default:return!0}case"script":if(ht.async&&typeof ht.async!="function"&&typeof ht.async!="symbol"&&!ht.onLoad&&!ht.onError&&ht.src&&typeof ht.src=="string")return!0}return!1}function C0(lt){return!(lt.type==="stylesheet"&&(lt.state.loading&3)===0)}function Rp(lt,ht,gt,xt){if(gt.type==="stylesheet"&&(typeof xt.media!="string"||matchMedia(xt.media).matches!==!1)&&(gt.state.loading&4)===0){if(gt.instance===null){var Ct=_o(xt.href),Lt=ht.querySelector(_c(Ct));if(Lt){ht=Lt._p,ht!==null&&typeof ht=="object"&&typeof ht.then=="function"&&(lt.count++,lt=As.bind(lt),ht.then(lt,lt)),gt.state.loading|=4,gt.instance=Lt,Ua(Lt);return}Lt=ht.ownerDocument||ht,xt=_0(xt),(Ct=xi.get(Ct))&&q1(xt,Ct),Lt=Lt.createElement("link"),Ua(Lt);var Dt=Lt;Dt._p=new Promise(function(zt,Jt){Dt.onload=zt,Dt.onerror=Jt}),qn(Lt,"link",xt),gt.instance=Lt}lt.stylesheets===null&&(lt.stylesheets=new Map),lt.stylesheets.set(gt,ht),(ht=gt.state.preload)&&(gt.state.loading&3)===0&&(lt.count++,gt=As.bind(lt),ht.addEventListener("load",gt),ht.addEventListener("error",gt))}}var O1=0;function Bp(lt,ht){return lt.stylesheets&&lt.count===0&&Es(lt,lt.stylesheets),0<lt.count||0<lt.imgCount?function(gt){var xt=setTimeout(function(){if(lt.stylesheets&&Es(lt,lt.stylesheets),lt.unsuspend){var Lt=lt.unsuspend;lt.unsuspend=null,Lt()}},6e4+ht);0<lt.imgBytes&&O1===0&&(O1=62500*yp());var Ct=setTimeout(function(){if(lt.waitingForImages=!1,lt.count===0&&(lt.stylesheets&&Es(lt,lt.stylesheets),lt.unsuspend)){var Lt=lt.unsuspend;lt.unsuspend=null,Lt()}},(lt.imgBytes>O1?50:800)+ht);return lt.unsuspend=gt,function(){lt.unsuspend=null,clearTimeout(xt),clearTimeout(Ct)}}:null}function As(){if(this.count--,this.count===0&&(this.imgCount===0||!this.waitingForImages)){if(this.stylesheets)Es(this,this.stylesheets);else if(this.unsuspend){var lt=this.unsuspend;this.unsuspend=null,lt()}}}var Ts=null;function Es(lt,ht){lt.stylesheets=null,lt.unsuspend!==null&&(lt.count++,Ts=new Map,ht.forEach(Dp,lt),Ts=null,As.call(lt))}function Dp(lt,ht){if(!(ht.state.loading&4)){var gt=Ts.get(lt);if(gt)var xt=gt.get(null);else{gt=new Map,Ts.set(lt,gt);for(var Ct=lt.querySelectorAll("link[data-precedence],style[data-precedence]"),Lt=0;Lt<Ct.length;Lt++){var Dt=Ct[Lt];(Dt.nodeName==="LINK"||Dt.getAttribute("media")!=="not all")&&(gt.set(Dt.dataset.precedence,Dt),xt=Dt)}xt&&gt.set(null,xt)}Ct=ht.instance,Dt=Ct.getAttribute("data-precedence"),Lt=gt.get(Dt)||xt,Lt===xt&&gt.set(null,Ct),gt.set(Dt,Ct),this.count++,xt=As.bind(this),Ct.addEventListener("load",xt),Ct.addEventListener("error",xt),Lt?Lt.parentNode.insertBefore(Ct,Lt.nextSibling):(lt=lt.nodeType===9?lt.head:lt,lt.insertBefore(Ct,lt.firstChild)),ht.state.loading|=4}}var vc={$$typeof:Et,Provider:null,Consumer:null,_currentValue:Gt,_currentValue2:Gt,_threadCount:0};function Pp(lt,ht,gt,xt,Ct,Lt,Dt,zt,Jt){this.tag=1,this.containerInfo=lt,this.pingCache=this.current=this.pendingChildren=null,this.timeoutHandle=-1,this.callbackNode=this.next=this.pendingContext=this.context=this.cancelPendingCommit=null,this.callbackPriority=0,this.expirationTimes=Io(-1),this.entangledLanes=this.shellSuspendCounter=this.errorRecoveryDisabledLanes=this.expiredLanes=this.warmLanes=this.pingedLanes=this.suspendedLanes=this.pendingLanes=0,this.entanglements=Io(0),this.hiddenUpdates=Io(null),this.identifierPrefix=xt,this.onUncaughtError=Ct,this.onCaughtError=Lt,this.onRecoverableError=Dt,this.pooledCache=null,this.pooledCacheLanes=0,this.formState=Jt,this.incompleteTransitions=new Map}function M0(lt,ht,gt,xt,Ct,Lt,Dt,zt,Jt,ha,va,wa){return lt=new Pp(lt,ht,gt,Dt,Jt,ha,va,wa,zt),ht=1,Lt===!0&&(ht|=24),Lt=ai(3,null,null,ht),lt.current=Lt,Lt.stateNode=lt,ht=xl(),ht.refCount++,lt.pooledCache=ht,ht.refCount++,Lt.memoizedState={element:xt,isDehydrated:gt,cache:ht},Ml(Lt),lt}function w0(lt){return lt?(lt=Zr,lt):Zr}function L0(lt,ht,gt,xt,Ct,Lt){Ct=w0(Ct),xt.context===null?xt.context=Ct:xt.pendingContext=Ct,xt=rr(ht),xt.payload={element:gt},Lt=Lt===void 0?null:Lt,Lt!==null&&(xt.callback=Lt),gt=or(lt,xt,ht),gt!==null&&(Qn(gt,lt,ht),Jo(gt,lt,ht))}function S0(lt,ht){if(lt=lt.memoizedState,lt!==null&&lt.dehydrated!==null){var gt=lt.retryLane;lt.retryLane=gt!==0&&gt<ht?gt:ht}}function z1(lt,ht){S0(lt,ht),(lt=lt.alternate)&&S0(lt,ht)}function $0(lt){if(lt.tag===13||lt.tag===31){var ht=Lr(lt,67108864);ht!==null&&Qn(ht,lt,67108864),z1(lt,67108864)}}function N0(lt){if(lt.tag===13||lt.tag===31){var ht=ci();ht=Vn(ht);var gt=Lr(lt,ht);gt!==null&&Qn(gt,lt,ht),z1(lt,ht)}}var Rs=!0;function Fp(lt,ht,gt,xt){var Ct=Ut.T;Ut.T=null;var Lt=ea.p;try{ea.p=2,H1(lt,ht,gt,xt)}finally{ea.p=Lt,Ut.T=Ct}}function qp(lt,ht,gt,xt){var Ct=Ut.T;Ut.T=null;var Lt=ea.p;try{ea.p=8,H1(lt,ht,gt,xt)}finally{ea.p=Lt,Ut.T=Ct}}function H1(lt,ht,gt,xt){if(Rs){var Ct=U1(xt);if(Ct===null)N1(lt,ht,xt,Bs,gt),A0(lt,xt);else if(Op(Ct,lt,ht,gt,xt))xt.stopPropagation();else if(A0(lt,xt),ht&4&&-1<jp.indexOf(lt)){for(;Ct!==null;){var Lt=Ia(Ct);if(Lt!==null)switch(Lt.tag){case 3:if(Lt=Lt.stateNode,Lt.current.memoizedState.isDehydrated){var Dt=ei(Lt.pendingLanes);if(Dt!==0){var zt=Lt;for(zt.pendingLanes|=2,zt.entangledLanes|=2;Dt;){var Jt=1<<31-pa(Dt);zt.entanglements[1]|=Jt,Dt&=~Jt}Ii(Lt),(Qa&6)===0&&(ms=pn()+500,yc(0))}}break;case 31:case 13:zt=Lr(Lt,2),zt!==null&&Qn(zt,Lt,2),_s(),z1(Lt,2)}if(Lt=U1(xt),Lt===null&&N1(lt,ht,xt,Bs,gt),Lt===Ct)break;Ct=Lt}Ct!==null&&xt.stopPropagation()}else N1(lt,ht,xt,null,gt)}}function U1(lt){return lt=Gs(lt),V1(lt)}var Bs=null;function V1(lt){if(Bs=null,lt=Sa(lt),lt!==null){var ht=pt(lt);if(ht===null)lt=null;else{var gt=ht.tag;if(gt===13){if(lt=yt(ht),lt!==null)return lt;lt=null}else if(gt===31){if(lt=ft(ht),lt!==null)return lt;lt=null}else if(gt===3){if(ht.stateNode.current.memoizedState.isDehydrated)return ht.tag===3?ht.stateNode.containerInfo:null;lt=null}else ht!==lt&&(lt=null)}}return Bs=lt,null}function I0(lt){switch(lt){case"beforetoggle":case"cancel":case"click":case"close":case"contextmenu":case"copy":case"cut":case"auxclick":case"dblclick":case"dragend":case"dragstart":case"drop":case"focusin":case"focusout":case"input":case"invalid":case"keydown":case"keypress":case"keyup":case"mousedown":case"mouseup":case"paste":case"pause":case"play":case"pointercancel":case"pointerdown":case"pointerup":case"ratechange":case"reset":case"resize":case"seeked":case"submit":case"toggle":case"touchcancel":case"touchend":case"touchstart":case"volumechange":case"change":case"selectionchange":case"textInput":case"compositionstart":case"compositionend":case"compositionupdate":case"beforeblur":case"afterblur":case"beforeinput":case"blur":case"fullscreenchange":case"focus":case"hashchange":case"popstate":case"select":case"selectstart":return 2;case"drag":case"dragenter":case"dragexit":case"dragleave":case"dragover":case"mousemove":case"mouseout":case"mouseover":case"pointermove":case"pointerout":case"pointerover":case"scroll":case"touchmove":case"wheel":case"mouseenter":case"mouseleave":case"pointerenter":case"pointerleave":return 8;case"message":switch(Tt()){case fa:return 2;case Pt:return 8;case At:case Rt:return 32;case Bt:return 268435456;default:return 32}default:return 32}}var G1=!1,mr=null,kr=null,_r=null,bc=new Map,Cc=new Map,xr=[],jp="mousedown mouseup touchcancel touchend touchstart auxclick dblclick pointercancel pointerdown pointerup dragend dragstart drop compositionend compositionstart keydown keypress keyup input textInput copy cut paste click change contextmenu reset".split(" ");function A0(lt,ht){switch(lt){case"focusin":case"focusout":mr=null;break;case"dragenter":case"dragleave":kr=null;break;case"mouseover":case"mouseout":_r=null;break;case"pointerover":case"pointerout":bc.delete(ht.pointerId);break;case"gotpointercapture":case"lostpointercapture":Cc.delete(ht.pointerId)}}function Mc(lt,ht,gt,xt,Ct,Lt){return lt===null||lt.nativeEvent!==Lt?(lt={blockedOn:ht,domEventName:gt,eventSystemFlags:xt,nativeEvent:Lt,targetContainers:[Ct]},ht!==null&&(ht=Ia(ht),ht!==null&&$0(ht)),lt):(lt.eventSystemFlags|=xt,ht=lt.targetContainers,Ct!==null&&ht.indexOf(Ct)===-1&&ht.push(Ct),lt)}function Op(lt,ht,gt,xt,Ct){switch(ht){case"focusin":return mr=Mc(mr,lt,ht,gt,xt,Ct),!0;case"dragenter":return kr=Mc(kr,lt,ht,gt,xt,Ct),!0;case"mouseover":return _r=Mc(_r,lt,ht,gt,xt,Ct),!0;case"pointerover":var Lt=Ct.pointerId;return bc.set(Lt,Mc(bc.get(Lt)||null,lt,ht,gt,xt,Ct)),!0;case"gotpointercapture":return Lt=Ct.pointerId,Cc.set(Lt,Mc(Cc.get(Lt)||null,lt,ht,gt,xt,Ct)),!0}return!1}function T0(lt){var ht=Sa(lt.target);if(ht!==null){var gt=pt(ht);if(gt!==null){if(ht=gt.tag,ht===13){if(ht=yt(gt),ht!==null){lt.blockedOn=ht,Bo(lt.priority,function(){N0(gt)});return}}else if(ht===31){if(ht=ft(gt),ht!==null){lt.blockedOn=ht,Bo(lt.priority,function(){N0(gt)});return}}else if(ht===3&&gt.stateNode.current.memoizedState.isDehydrated){lt.blockedOn=gt.tag===3?gt.stateNode.containerInfo:null;return}}}lt.blockedOn=null}function Ds(lt){if(lt.blockedOn!==null)return!1;for(var ht=lt.targetContainers;0<ht.length;){var gt=U1(lt.nativeEvent);if(gt===null){gt=lt.nativeEvent;var xt=new gt.constructor(gt.type,gt);Vs=xt,gt.target.dispatchEvent(xt),Vs=null}else return ht=Ia(gt),ht!==null&&$0(ht),lt.blockedOn=gt,!1;ht.shift()}return!0}function E0(lt,ht,gt){Ds(lt)&&gt.delete(ht)}function zp(){G1=!1,mr!==null&&Ds(mr)&&(mr=null),kr!==null&&Ds(kr)&&(kr=null),_r!==null&&Ds(_r)&&(_r=null),bc.forEach(E0),Cc.forEach(E0)}function Ps(lt,ht){lt.blockedOn===ht&&(lt.blockedOn=null,G1||(G1=!0,rt.unstable_scheduleCallback(rt.unstable_NormalPriority,zp)))}var Fs=null;function R0(lt){Fs!==lt&&(Fs=lt,rt.unstable_scheduleCallback(rt.unstable_NormalPriority,function(){Fs===lt&&(Fs=null);for(var ht=0;ht<lt.length;ht+=3){var gt=lt[ht],xt=lt[ht+1],Ct=lt[ht+2];if(typeof xt!="function"){if(V1(xt||gt)===null)continue;break}var Lt=Ia(gt);Lt!==null&&(lt.splice(ht,3),ht-=3,Ul(Lt,{pending:!0,data:Ct,method:gt.method,action:xt},xt,Ct))}}))}function vo(lt){function ht(Jt){return Ps(Jt,lt)}mr!==null&&Ps(mr,lt),kr!==null&&Ps(kr,lt),_r!==null&&Ps(_r,lt),bc.forEach(ht),Cc.forEach(ht);for(var gt=0;gt<xr.length;gt++){var xt=xr[gt];xt.blockedOn===lt&&(xt.blockedOn=null)}for(;0<xr.length&&(gt=xr[0],gt.blockedOn===null);)T0(gt),gt.blockedOn===null&&xr.shift();if(gt=(lt.ownerDocument||lt).$$reactFormReplay,gt!=null)for(xt=0;xt<gt.length;xt+=3){var Ct=gt[xt],Lt=gt[xt+1],Dt=Ct[fn]||null;if(typeof Lt=="function")Dt||R0(gt);else if(Dt){var zt=null;if(Lt&&Lt.hasAttribute("formAction")){if(Ct=Lt,Dt=Lt[fn]||null)zt=Dt.formAction;else if(V1(Ct)!==null)continue}else zt=Dt.action;typeof zt=="function"?gt[xt+1]=zt:(gt.splice(xt,3),xt-=3),R0(gt)}}}function B0(){function lt(Lt){Lt.canIntercept&&Lt.info==="react-transition"&&Lt.intercept({handler:function(){return new Promise(function(Dt){return Ct=Dt})},focusReset:"manual",scroll:"manual"})}function ht(){Ct!==null&&(Ct(),Ct=null),xt||setTimeout(gt,20)}function gt(){if(!xt&&!navigation.transition){var Lt=navigation.currentEntry;Lt&&Lt.url!=null&&navigation.navigate(Lt.url,{state:Lt.getState(),info:"react-transition",history:"replace"})}}if(typeof navigation=="object"){var xt=!1,Ct=null;return navigation.addEventListener("navigate",lt),navigation.addEventListener("navigatesuccess",ht),navigation.addEventListener("navigateerror",ht),setTimeout(gt,100),function(){xt=!0,navigation.removeEventListener("navigate",lt),navigation.removeEventListener("navigatesuccess",ht),navigation.removeEventListener("navigateerror",ht),Ct!==null&&(Ct(),Ct=null)}}}function W1(lt){this._internalRoot=lt}qs.prototype.render=W1.prototype.render=function(lt){var ht=this._internalRoot;if(ht===null)throw Error(dt(409));var gt=ht.current,xt=ci();L0(gt,xt,lt,ht,null,null)},qs.prototype.unmount=W1.prototype.unmount=function(){var lt=this._internalRoot;if(lt!==null){this._internalRoot=null;var ht=lt.containerInfo;L0(lt.current,2,null,lt,null,null),_s(),ht[Ti]=null}};function qs(lt){this._internalRoot=lt}qs.prototype.unstable_scheduleHydration=function(lt){if(lt){var ht=Ro();lt={blockedOn:null,target:lt,priority:ht};for(var gt=0;gt<xr.length&&ht!==0&&ht<xr[gt].priority;gt++);xr.splice(gt,0,lt),gt===0&&T0(lt)}};var D0=it.version;if(D0!=="19.2.0")throw Error(dt(527,D0,"19.2.0"));ea.findDOMNode=function(lt){var ht=lt._reactInternals;if(ht===void 0)throw typeof lt.render=="function"?Error(dt(188)):(lt=Object.keys(lt).join(","),Error(dt(268,lt)));return lt=kt(ht),lt=lt!==null?_t(lt):null,lt=lt===null?null:lt.stateNode,lt};var Hp={bundleType:0,version:"19.2.0",rendererPackageName:"react-dom",currentDispatcherRef:Ut,reconcilerVersion:"19.2.0"};if(typeof __REACT_DEVTOOLS_GLOBAL_HOOK__<"u"){var js=__REACT_DEVTOOLS_GLOBAL_HOOK__;if(!js.isDisabled&&js.supportsFiber)try{Xt=js.inject(Hp),da=js}catch{}}return reactDomClient_production.createRoot=function(lt,ht){if(!ut(lt))throw Error(dt(299));var gt=!1,xt="",Ct=Hu,Lt=Uu,Dt=Vu;return ht!=null&&(ht.unstable_strictMode===!0&&(gt=!0),ht.identifierPrefix!==void 0&&(xt=ht.identifierPrefix),ht.onUncaughtError!==void 0&&(Ct=ht.onUncaughtError),ht.onCaughtError!==void 0&&(Lt=ht.onCaughtError),ht.onRecoverableError!==void 0&&(Dt=ht.onRecoverableError)),ht=M0(lt,1,!1,null,null,gt,xt,null,Ct,Lt,Dt,B0),lt[Ti]=ht.current,$1(lt),new W1(ht)},reactDomClient_production.hydrateRoot=function(lt,ht,gt){if(!ut(lt))throw Error(dt(299));var xt=!1,Ct="",Lt=Hu,Dt=Uu,zt=Vu,Jt=null;return gt!=null&&(gt.unstable_strictMode===!0&&(xt=!0),gt.identifierPrefix!==void 0&&(Ct=gt.identifierPrefix),gt.onUncaughtError!==void 0&&(Lt=gt.onUncaughtError),gt.onCaughtError!==void 0&&(Dt=gt.onCaughtError),gt.onRecoverableError!==void 0&&(zt=gt.onRecoverableError),gt.formState!==void 0&&(Jt=gt.formState)),ht=M0(lt,1,!0,ht,gt??null,xt,Ct,Jt,Lt,Dt,zt,B0),ht.context=w0(null),gt=ht.current,xt=ci(),xt=Vn(xt),Ct=rr(xt),Ct.callback=null,or(gt,Ct,xt),gt=xt,ht.current.lanes=gt,Qi(ht,gt),Ii(ht),lt[Ti]=ht.current,$1(lt),new qs(ht)},reactDomClient_production.version="19.2.0",reactDomClient_production}var hasRequiredClient;function requireClient(){if(hasRequiredClient)return client.exports;hasRequiredClient=1;function rt(){if(!(typeof __REACT_DEVTOOLS_GLOBAL_HOOK__>"u"||typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE!="function"))try{__REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE(rt)}catch(it){console.error(it)}}return rt(),client.exports=requireReactDomClient_production(),client.exports}var clientExports=requireClient();var PopStateEventType="popstate";function createBrowserHistory(rt={}){function it(dt,ut){let{pathname:pt,search:yt,hash:ft}=dt.location;return createLocation("",{pathname:pt,search:yt,hash:ft},ut.state&&ut.state.usr||null,ut.state&&ut.state.key||"default")}function ct(dt,ut){return typeof ut=="string"?ut:createPath(ut)}return getUrlBasedHistory(it,ct,null,rt)}function invariant(rt,it){if(rt===!1||rt===null||typeof rt>"u")throw new Error(it)}function warning(rt,it){if(!rt){typeof console<"u"&&console.warn(it);try{throw new Error(it)}catch{}}}function createKey$1(){return Math.random().toString(36).substring(2,10)}function getHistoryState(rt,it){return{usr:rt.state,key:rt.key,idx:it}}function createLocation(rt,it,ct=null,dt){return{pathname:typeof rt=="string"?rt:rt.pathname,search:"",hash:"",...typeof it=="string"?parsePath(it):it,state:ct,key:it&&it.key||dt||createKey$1()}}function createPath({pathname:rt="/",search:it="",hash:ct=""}){return it&&it!=="?"&&(rt+=it.charAt(0)==="?"?it:"?"+it),ct&&ct!=="#"&&(rt+=ct.charAt(0)==="#"?ct:"#"+ct),rt}function parsePath(rt){let it={};if(rt){let ct=rt.indexOf("#");ct>=0&&(it.hash=rt.substring(ct),rt=rt.substring(0,ct));let dt=rt.indexOf("?");dt>=0&&(it.search=rt.substring(dt),rt=rt.substring(0,dt)),rt&&(it.pathname=rt)}return it}function getUrlBasedHistory(rt,it,ct,dt={}){let{window:ut=document.defaultView,v5Compat:pt=!1}=dt,yt=ut.history,ft="POP",mt=null,kt=_t();kt==null&&(kt=0,yt.replaceState({...yt.state,idx:kt},""));function _t(){return(yt.state||{idx:null}).idx}function vt(){ft="POP";let It=_t(),Nt=It==null?null:It-kt;kt=It,mt&&mt({action:ft,location:St.location,delta:Nt})}function bt(It,Nt){ft="PUSH";let $t=createLocation(St.location,It,Nt);kt=_t()+1;let Et=getHistoryState($t,kt),Ft=St.createHref($t);try{yt.pushState(Et,"",Ft)}catch(qt){if(qt instanceof DOMException&&qt.name==="DataCloneError")throw qt;ut.location.assign(Ft)}pt&&mt&&mt({action:ft,location:St.location,delta:1})}function Mt(It,Nt){ft="REPLACE";let $t=createLocation(St.location,It,Nt);kt=_t();let Et=getHistoryState($t,kt),Ft=St.createHref($t);yt.replaceState(Et,"",Ft),pt&&mt&&mt({action:ft,location:St.location,delta:0})}function wt(It){return createBrowserURLImpl(It)}let St={get action(){return ft},get location(){return rt(ut,yt)},listen(It){if(mt)throw new Error("A history only accepts one active listener");return ut.addEventListener(PopStateEventType,vt),mt=It,()=>{ut.removeEventListener(PopStateEventType,vt),mt=null}},createHref(It){return it(ut,It)},createURL:wt,encodeLocation(It){let Nt=wt(It);return{pathname:Nt.pathname,search:Nt.search,hash:Nt.hash}},push:bt,replace:Mt,go(It){return yt.go(It)}};return St}function createBrowserURLImpl(rt,it=!1){let ct="http://localhost";typeof window<"u"&&(ct=window.location.origin!=="null"?window.location.origin:window.location.href),invariant(ct,"No window.location.(origin|href) available to create URL");let dt=typeof rt=="string"?rt:createPath(rt);return dt=dt.replace(/ $/,"%20"),!it&&dt.startsWith("//")&&(dt=ct+dt),new URL(dt,ct)}function matchRoutes(rt,it,ct="/"){return matchRoutesImpl(rt,it,ct,!1)}function matchRoutesImpl(rt,it,ct,dt){let ut=typeof it=="string"?parsePath(it):it,pt=stripBasename(ut.pathname||"/",ct);if(pt==null)return null;let yt=flattenRoutes(rt);rankRouteBranches(yt);let ft=null;for(let mt=0;ft==null&&mt<yt.length;++mt){let kt=decodePath(pt);ft=matchRouteBranch(yt[mt],kt,dt)}return ft}function flattenRoutes(rt,it=[],ct=[],dt="",ut=!1){let pt=(yt,ft,mt=ut,kt)=>{let _t={relativePath:kt===void 0?yt.path||"":kt,caseSensitive:yt.caseSensitive===!0,childrenIndex:ft,route:yt};if(_t.relativePath.startsWith("/")){if(!_t.relativePath.startsWith(dt)&&mt)return;invariant(_t.relativePath.startsWith(dt),`Absolute route path "${_t.relativePath}" nested under path "${dt}" is not valid. An absolute child route path must start with the combined path of all its parent routes.`),_t.relativePath=_t.relativePath.slice(dt.length)}let vt=joinPaths([dt,_t.relativePath]),bt=ct.concat(_t);yt.children&&yt.children.length>0&&(invariant(yt.index!==!0,`Index routes must not have child routes. Please remove all child routes from route path "${vt}".`),flattenRoutes(yt.children,it,bt,vt,mt)),!(yt.path==null&&!yt.index)&&it.push({path:vt,score:computeScore$2(vt,yt.index),routesMeta:bt})};return rt.forEach((yt,ft)=>{if(yt.path===""||!yt.path?.includes("?"))pt(yt,ft);else for(let mt of explodeOptionalSegments(yt.path))pt(yt,ft,!0,mt)}),it}function explodeOptionalSegments(rt){let it=rt.split("/");if(it.length===0)return[];let[ct,...dt]=it,ut=ct.endsWith("?"),pt=ct.replace(/\?$/,"");if(dt.length===0)return ut?[pt,""]:[pt];let yt=explodeOptionalSegments(dt.join("/")),ft=[];return ft.push(...yt.map(mt=>mt===""?pt:[pt,mt].join("/"))),ut&&ft.push(...yt),ft.map(mt=>rt.startsWith("/")&&mt===""?"/":mt)}function rankRouteBranches(rt){rt.sort((it,ct)=>it.score!==ct.score?ct.score-it.score:compareIndexes(it.routesMeta.map(dt=>dt.childrenIndex),ct.routesMeta.map(dt=>dt.childrenIndex)))}var paramRe=/^:[\w-]+$/,dynamicSegmentValue=3,indexRouteValue=2,emptySegmentValue=1,staticSegmentValue=10,splatPenalty=-2,isSplat=rt=>rt==="*";function computeScore$2(rt,it){let ct=rt.split("/"),dt=ct.length;return ct.some(isSplat)&&(dt+=splatPenalty),it&&(dt+=indexRouteValue),ct.filter(ut=>!isSplat(ut)).reduce((ut,pt)=>ut+(paramRe.test(pt)?dynamicSegmentValue:pt===""?emptySegmentValue:staticSegmentValue),dt)}function compareIndexes(rt,it){return rt.length===it.length&&rt.slice(0,-1).every((dt,ut)=>dt===it[ut])?rt[rt.length-1]-it[it.length-1]:0}function matchRouteBranch(rt,it,ct=!1){let{routesMeta:dt}=rt,ut={},pt="/",yt=[];for(let ft=0;ft<dt.length;++ft){let mt=dt[ft],kt=ft===dt.length-1,_t=pt==="/"?it:it.slice(pt.length)||"/",vt=matchPath({path:mt.relativePath,caseSensitive:mt.caseSensitive,end:kt},_t),bt=mt.route;if(!vt&&kt&&ct&&!dt[dt.length-1].route.index&&(vt=matchPath({path:mt.relativePath,caseSensitive:mt.caseSensitive,end:!1},_t)),!vt)return null;Object.assign(ut,vt.params),yt.push({params:ut,pathname:joinPaths([pt,vt.pathname]),pathnameBase:normalizePathname(joinPaths([pt,vt.pathnameBase])),route:bt}),vt.pathnameBase!=="/"&&(pt=joinPaths([pt,vt.pathnameBase]))}return yt}function matchPath(rt,it){typeof rt=="string"&&(rt={path:rt,caseSensitive:!1,end:!0});let[ct,dt]=compilePath(rt.path,rt.caseSensitive,rt.end),ut=it.match(ct);if(!ut)return null;let pt=ut[0],yt=pt.replace(/(.)\/+$/,"$1"),ft=ut.slice(1);return{params:dt.reduce((kt,{paramName:_t,isOptional:vt},bt)=>{if(_t==="*"){let wt=ft[bt]||"";yt=pt.slice(0,pt.length-wt.length).replace(/(.)\/+$/,"$1")}const Mt=ft[bt];return vt&&!Mt?kt[_t]=void 0:kt[_t]=(Mt||"").replace(/%2F/g,"/"),kt},{}),pathname:pt,pathnameBase:yt,pattern:rt}}function compilePath(rt,it=!1,ct=!0){warning(rt==="*"||!rt.endsWith("*")||rt.endsWith("/*"),`Route path "${rt}" will be treated as if it were "${rt.replace(/\*$/,"/*")}" because the \`*\` character must always follow a \`/\` in the pattern. To get rid of this warning, please change the route path to "${rt.replace(/\*$/,"/*")}".`);let dt=[],ut="^"+rt.replace(/\/*\*?$/,"").replace(/^\/*/,"/").replace(/[\\.*+^${}|()[\]]/g,"\\$&").replace(/\/:([\w-]+)(\?)?/g,(yt,ft,mt)=>(dt.push({paramName:ft,isOptional:mt!=null}),mt?"/?([^\\/]+)?":"/([^\\/]+)")).replace(/\/([\w-]+)\?(\/|$)/g,"(/$1)?$2");return rt.endsWith("*")?(dt.push({paramName:"*"}),ut+=rt==="*"||rt==="/*"?"(.*)$":"(?:\\/(.+)|\\/*)$"):ct?ut+="\\/*$":rt!==""&&rt!=="/"&&(ut+="(?:(?=\\/|$))"),[new RegExp(ut,it?void 0:"i"),dt]}function decodePath(rt){try{return rt.split("/").map(it=>decodeURIComponent(it).replace(/\//g,"%2F")).join("/")}catch(it){return warning(!1,`The URL path "${rt}" could not be decoded because it is a malformed URL segment. This is probably due to a bad percent encoding (${it}).`),rt}}function stripBasename(rt,it){if(it==="/")return rt;if(!rt.toLowerCase().startsWith(it.toLowerCase()))return null;let ct=it.endsWith("/")?it.length-1:it.length,dt=rt.charAt(ct);return dt&&dt!=="/"?null:rt.slice(ct)||"/"}var ABSOLUTE_URL_REGEX=/^(?:[a-z][a-z0-9+.-]*:|\/\/)/i,isAbsoluteUrl=rt=>ABSOLUTE_URL_REGEX.test(rt);function resolvePath(rt,it="/"){let{pathname:ct,search:dt="",hash:ut=""}=typeof rt=="string"?parsePath(rt):rt,pt;if(ct)if(isAbsoluteUrl(ct))pt=ct;else{if(ct.includes("//")){let yt=ct;ct=ct.replace(/\/\/+/g,"/"),warning(!1,`Pathnames cannot have embedded double slashes - normalizing ${yt} -> ${ct}`)}ct.startsWith("/")?pt=resolvePathname(ct.substring(1),"/"):pt=resolvePathname(ct,it)}else pt=it;return{pathname:pt,search:normalizeSearch(dt),hash:normalizeHash(ut)}}function resolvePathname(rt,it){let ct=it.replace(/\/+$/,"").split("/");return rt.split("/").forEach(ut=>{ut===".."?ct.length>1&&ct.pop():ut!=="."&&ct.push(ut)}),ct.length>1?ct.join("/"):"/"}function getInvalidPathError(rt,it,ct,dt){return`Cannot include a '${rt}' character in a manually specified \`to.${it}\` field [${JSON.stringify(dt)}].  Please separate it out to the \`to.${ct}\` field. Alternatively you may provide the full path as a string in <Link to="..."> and the router will parse it for you.`}function getPathContributingMatches(rt){return rt.filter((it,ct)=>ct===0||it.route.path&&it.route.path.length>0)}function getResolveToMatches(rt){let it=getPathContributingMatches(rt);return it.map((ct,dt)=>dt===it.length-1?ct.pathname:ct.pathnameBase)}function resolveTo(rt,it,ct,dt=!1){let ut;typeof rt=="string"?ut=parsePath(rt):(ut={...rt},invariant(!ut.pathname||!ut.pathname.includes("?"),getInvalidPathError("?","pathname","search",ut)),invariant(!ut.pathname||!ut.pathname.includes("#"),getInvalidPathError("#","pathname","hash",ut)),invariant(!ut.search||!ut.search.includes("#"),getInvalidPathError("#","search","hash",ut)));let pt=rt===""||ut.pathname==="",yt=pt?"/":ut.pathname,ft;if(yt==null)ft=ct;else{let vt=it.length-1;if(!dt&&yt.startsWith("..")){let bt=yt.split("/");for(;bt[0]==="..";)bt.shift(),vt-=1;ut.pathname=bt.join("/")}ft=vt>=0?it[vt]:"/"}let mt=resolvePath(ut,ft),kt=yt&&yt!=="/"&&yt.endsWith("/"),_t=(pt||yt===".")&&ct.endsWith("/");return!mt.pathname.endsWith("/")&&(kt||_t)&&(mt.pathname+="/"),mt}var joinPaths=rt=>rt.join("/").replace(/\/\/+/g,"/"),normalizePathname=rt=>rt.replace(/\/+$/,"").replace(/^\/*/,"/"),normalizeSearch=rt=>!rt||rt==="?"?"":rt.startsWith("?")?rt:"?"+rt,normalizeHash=rt=>!rt||rt==="#"?"":rt.startsWith("#")?rt:"#"+rt;function isRouteErrorResponse(rt){return rt!=null&&typeof rt.status=="number"&&typeof rt.statusText=="string"&&typeof rt.internal=="boolean"&&"data"in rt}Object.getOwnPropertyNames(Object.prototype).sort().join("\0");var validMutationMethodsArr=["POST","PUT","PATCH","DELETE"];new Set(validMutationMethodsArr);var validRequestMethodsArr=["GET",...validMutationMethodsArr];new Set(validRequestMethodsArr);var DataRouterContext=reactExports.createContext(null);DataRouterContext.displayName="DataRouter";var DataRouterStateContext=reactExports.createContext(null);DataRouterStateContext.displayName="DataRouterState";reactExports.createContext(!1);var ViewTransitionContext=reactExports.createContext({isTransitioning:!1});ViewTransitionContext.displayName="ViewTransition";var FetchersContext=reactExports.createContext(new Map);FetchersContext.displayName="Fetchers";var AwaitContext=reactExports.createContext(null);AwaitContext.displayName="Await";var NavigationContext=reactExports.createContext(null);NavigationContext.displayName="Navigation";var LocationContext=reactExports.createContext(null);LocationContext.displayName="Location";var RouteContext=reactExports.createContext({outlet:null,matches:[],isDataRoute:!1});RouteContext.displayName="Route";var RouteErrorContext=reactExports.createContext(null);RouteErrorContext.displayName="RouteError";function useHref(rt,{relative:it}={}){invariant(useInRouterContext(),"useHref() may be used only in the context of a <Router> component.");let{basename:ct,navigator:dt}=reactExports.useContext(NavigationContext),{hash:ut,pathname:pt,search:yt}=useResolvedPath(rt,{relative:it}),ft=pt;return ct!=="/"&&(ft=pt==="/"?ct:joinPaths([ct,pt])),dt.createHref({pathname:ft,search:yt,hash:ut})}function useInRouterContext(){return reactExports.useContext(LocationContext)!=null}function useLocation(){return invariant(useInRouterContext(),"useLocation() may be used only in the context of a <Router> component."),reactExports.useContext(LocationContext).location}var navigateEffectWarning="You should call navigate() in a React.useEffect(), not when your component is first rendered.";function useIsomorphicLayoutEffect(rt){reactExports.useContext(NavigationContext).static||reactExports.useLayoutEffect(rt)}function useNavigate(){let{isDataRoute:rt}=reactExports.useContext(RouteContext);return rt?useNavigateStable():useNavigateUnstable()}function useNavigateUnstable(){invariant(useInRouterContext(),"useNavigate() may be used only in the context of a <Router> component.");let rt=reactExports.useContext(DataRouterContext),{basename:it,navigator:ct}=reactExports.useContext(NavigationContext),{matches:dt}=reactExports.useContext(RouteContext),{pathname:ut}=useLocation(),pt=JSON.stringify(getResolveToMatches(dt)),yt=reactExports.useRef(!1);return useIsomorphicLayoutEffect(()=>{yt.current=!0}),reactExports.useCallback((mt,kt={})=>{if(warning(yt.current,navigateEffectWarning),!yt.current)return;if(typeof mt=="number"){ct.go(mt);return}let _t=resolveTo(mt,JSON.parse(pt),ut,kt.relative==="path");rt==null&&it!=="/"&&(_t.pathname=_t.pathname==="/"?it:joinPaths([it,_t.pathname])),(kt.replace?ct.replace:ct.push)(_t,kt.state,kt)},[it,ct,pt,ut,rt])}var OutletContext=reactExports.createContext(null);function useOutlet(rt){let it=reactExports.useContext(RouteContext).outlet;return reactExports.useMemo(()=>it&&reactExports.createElement(OutletContext.Provider,{value:rt},it),[it,rt])}function useParams(){let{matches:rt}=reactExports.useContext(RouteContext),it=rt[rt.length-1];return it?it.params:{}}function useResolvedPath(rt,{relative:it}={}){let{matches:ct}=reactExports.useContext(RouteContext),{pathname:dt}=useLocation(),ut=JSON.stringify(getResolveToMatches(ct));return reactExports.useMemo(()=>resolveTo(rt,JSON.parse(ut),dt,it==="path"),[rt,ut,dt,it])}function useRoutes(rt,it){return useRoutesImpl(rt,it)}function useRoutesImpl(rt,it,ct,dt,ut){invariant(useInRouterContext(),"useRoutes() may be used only in the context of a <Router> component.");let{navigator:pt}=reactExports.useContext(NavigationContext),{matches:yt}=reactExports.useContext(RouteContext),ft=yt[yt.length-1],mt=ft?ft.params:{},kt=ft?ft.pathname:"/",_t=ft?ft.pathnameBase:"/",vt=ft&&ft.route;{let $t=vt&&vt.path||"";warningOnce(kt,!vt||$t.endsWith("*")||$t.endsWith("*?"),`You rendered descendant <Routes> (or called \`useRoutes()\`) at "${kt}" (under <Route path="${$t}">) but the parent route path has no trailing "*". This means if you navigate deeper, the parent won't match anymore and therefore the child routes will never render.
-
-Please change the parent <Route path="${$t}"> to <Route path="${$t==="/"?"*":`${$t}/*`}">.`)}let bt=useLocation(),Mt;if(it){let $t=typeof it=="string"?parsePath(it):it;invariant(_t==="/"||$t.pathname?.startsWith(_t),`When overriding the location using \`<Routes location>\` or \`useRoutes(routes, location)\`, the location pathname must begin with the portion of the URL pathname that was matched by all parent routes. The current pathname base is "${_t}" but pathname "${$t.pathname}" was given in the \`location\` prop.`),Mt=$t}else Mt=bt;let wt=Mt.pathname||"/",St=wt;if(_t!=="/"){let $t=_t.replace(/^\//,"").split("/");St="/"+wt.replace(/^\//,"").split("/").slice($t.length).join("/")}let It=matchRoutes(rt,{pathname:St});warning(vt||It!=null,`No routes matched location "${Mt.pathname}${Mt.search}${Mt.hash}" `),warning(It==null||It[It.length-1].route.element!==void 0||It[It.length-1].route.Component!==void 0||It[It.length-1].route.lazy!==void 0,`Matched leaf route at location "${Mt.pathname}${Mt.search}${Mt.hash}" does not have an element or Component. This means it will render an <Outlet /> with a null value by default resulting in an "empty" page.`);let Nt=_renderMatches(It&&It.map($t=>Object.assign({},$t,{params:Object.assign({},mt,$t.params),pathname:joinPaths([_t,pt.encodeLocation?pt.encodeLocation($t.pathname.replace(/\?/g,"%3F").replace(/#/g,"%23")).pathname:$t.pathname]),pathnameBase:$t.pathnameBase==="/"?_t:joinPaths([_t,pt.encodeLocation?pt.encodeLocation($t.pathnameBase.replace(/\?/g,"%3F").replace(/#/g,"%23")).pathname:$t.pathnameBase])})),yt,ct,dt,ut);return it&&Nt?reactExports.createElement(LocationContext.Provider,{value:{location:{pathname:"/",search:"",hash:"",state:null,key:"default",...Mt},navigationType:"POP"}},Nt):Nt}function DefaultErrorComponent(){let rt=useRouteError(),it=isRouteErrorResponse(rt)?`${rt.status} ${rt.statusText}`:rt instanceof Error?rt.message:JSON.stringify(rt),ct=rt instanceof Error?rt.stack:null,dt="rgba(200,200,200, 0.5)",ut={padding:"0.5rem",backgroundColor:dt},pt={padding:"2px 4px",backgroundColor:dt},yt=null;return console.error("Error handled by React Router default ErrorBoundary:",rt),yt=reactExports.createElement(reactExports.Fragment,null,reactExports.createElement("p",null,"💿 Hey developer 👋"),reactExports.createElement("p",null,"You can provide a way better UX than this when your app throws errors by providing your own ",reactExports.createElement("code",{style:pt},"ErrorBoundary")," or"," ",reactExports.createElement("code",{style:pt},"errorElement")," prop on your route.")),reactExports.createElement(reactExports.Fragment,null,reactExports.createElement("h2",null,"Unexpected Application Error!"),reactExports.createElement("h3",{style:{fontStyle:"italic"}},it),ct?reactExports.createElement("pre",{style:ut},ct):null,yt)}var defaultErrorElement=reactExports.createElement(DefaultErrorComponent,null),RenderErrorBoundary=class extends reactExports.Component{constructor(rt){super(rt),this.state={location:rt.location,revalidation:rt.revalidation,error:rt.error}}static getDerivedStateFromError(rt){return{error:rt}}static getDerivedStateFromProps(rt,it){return it.location!==rt.location||it.revalidation!=="idle"&&rt.revalidation==="idle"?{error:rt.error,location:rt.location,revalidation:rt.revalidation}:{error:rt.error!==void 0?rt.error:it.error,location:it.location,revalidation:rt.revalidation||it.revalidation}}componentDidCatch(rt,it){this.props.onError?this.props.onError(rt,it):console.error("React Router caught the following error during render",rt)}render(){return this.state.error!==void 0?reactExports.createElement(RouteContext.Provider,{value:this.props.routeContext},reactExports.createElement(RouteErrorContext.Provider,{value:this.state.error,children:this.props.component})):this.props.children}};function RenderedRoute({routeContext:rt,match:it,children:ct}){let dt=reactExports.useContext(DataRouterContext);return dt&&dt.static&&dt.staticContext&&(it.route.errorElement||it.route.ErrorBoundary)&&(dt.staticContext._deepestRenderedBoundaryId=it.route.id),reactExports.createElement(RouteContext.Provider,{value:rt},ct)}function _renderMatches(rt,it=[],ct=null,dt=null,ut=null){if(rt==null){if(!ct)return null;if(ct.errors)rt=ct.matches;else if(it.length===0&&!ct.initialized&&ct.matches.length>0)rt=ct.matches;else return null}let pt=rt,yt=ct?.errors;if(yt!=null){let _t=pt.findIndex(vt=>vt.route.id&&yt?.[vt.route.id]!==void 0);invariant(_t>=0,`Could not find a matching route for errors on route IDs: ${Object.keys(yt).join(",")}`),pt=pt.slice(0,Math.min(pt.length,_t+1))}let ft=!1,mt=-1;if(ct)for(let _t=0;_t<pt.length;_t++){let vt=pt[_t];if((vt.route.HydrateFallback||vt.route.hydrateFallbackElement)&&(mt=_t),vt.route.id){let{loaderData:bt,errors:Mt}=ct,wt=vt.route.loader&&!bt.hasOwnProperty(vt.route.id)&&(!Mt||Mt[vt.route.id]===void 0);if(vt.route.lazy||wt){ft=!0,mt>=0?pt=pt.slice(0,mt+1):pt=[pt[0]];break}}}let kt=ct&&dt?(_t,vt)=>{dt(_t,{location:ct.location,params:ct.matches?.[0]?.params??{},errorInfo:vt})}:void 0;return pt.reduceRight((_t,vt,bt)=>{let Mt,wt=!1,St=null,It=null;ct&&(Mt=yt&&vt.route.id?yt[vt.route.id]:void 0,St=vt.route.errorElement||defaultErrorElement,ft&&(mt<0&&bt===0?(warningOnce("route-fallback",!1,"No `HydrateFallback` element provided to render during initial hydration"),wt=!0,It=null):mt===bt&&(wt=!0,It=vt.route.hydrateFallbackElement||null)));let Nt=it.concat(pt.slice(0,bt+1)),$t=()=>{let Et;return Mt?Et=St:wt?Et=It:vt.route.Component?Et=reactExports.createElement(vt.route.Component,null):vt.route.element?Et=vt.route.element:Et=_t,reactExports.createElement(RenderedRoute,{match:vt,routeContext:{outlet:_t,matches:Nt,isDataRoute:ct!=null},children:Et})};return ct&&(vt.route.ErrorBoundary||vt.route.errorElement||bt===0)?reactExports.createElement(RenderErrorBoundary,{location:ct.location,revalidation:ct.revalidation,component:St,error:Mt,children:$t(),routeContext:{outlet:null,matches:Nt,isDataRoute:!0},onError:kt}):$t()},null)}function getDataRouterConsoleError(rt){return`${rt} must be used within a data router.  See https://reactrouter.com/en/main/routers/picking-a-router.`}function useDataRouterContext(rt){let it=reactExports.useContext(DataRouterContext);return invariant(it,getDataRouterConsoleError(rt)),it}function useDataRouterState(rt){let it=reactExports.useContext(DataRouterStateContext);return invariant(it,getDataRouterConsoleError(rt)),it}function useRouteContext(rt){let it=reactExports.useContext(RouteContext);return invariant(it,getDataRouterConsoleError(rt)),it}function useCurrentRouteId(rt){let it=useRouteContext(rt),ct=it.matches[it.matches.length-1];return invariant(ct.route.id,`${rt} can only be used on routes that contain a unique "id"`),ct.route.id}function useRouteId(){return useCurrentRouteId("useRouteId")}function useRouteError(){let rt=reactExports.useContext(RouteErrorContext),it=useDataRouterState("useRouteError"),ct=useCurrentRouteId("useRouteError");return rt!==void 0?rt:it.errors?.[ct]}function useNavigateStable(){let{router:rt}=useDataRouterContext("useNavigate"),it=useCurrentRouteId("useNavigate"),ct=reactExports.useRef(!1);return useIsomorphicLayoutEffect(()=>{ct.current=!0}),reactExports.useCallback(async(ut,pt={})=>{warning(ct.current,navigateEffectWarning),ct.current&&(typeof ut=="number"?rt.navigate(ut):await rt.navigate(ut,{fromRouteId:it,...pt}))},[rt,it])}var alreadyWarned$1={};function warningOnce(rt,it,ct){!it&&!alreadyWarned$1[rt]&&(alreadyWarned$1[rt]=!0,warning(!1,ct))}reactExports.memo(DataRoutes);function DataRoutes({routes:rt,future:it,state:ct,unstable_onError:dt}){return useRoutesImpl(rt,void 0,ct,dt,it)}function Outlet(rt){return useOutlet(rt.context)}function Route$1(rt){invariant(!1,"A <Route> is only ever to be used as the child of <Routes> element, never rendered directly. Please wrap your <Route> in a <Routes>.")}function Router$1({basename:rt="/",children:it=null,location:ct,navigationType:dt="POP",navigator:ut,static:pt=!1}){invariant(!useInRouterContext(),"You cannot render a <Router> inside another <Router>. You should never have more than one in your app.");let yt=rt.replace(/^\/*/,"/"),ft=reactExports.useMemo(()=>({basename:yt,navigator:ut,static:pt,future:{}}),[yt,ut,pt]);typeof ct=="string"&&(ct=parsePath(ct));let{pathname:mt="/",search:kt="",hash:_t="",state:vt=null,key:bt="default"}=ct,Mt=reactExports.useMemo(()=>{let wt=stripBasename(mt,yt);return wt==null?null:{location:{pathname:wt,search:kt,hash:_t,state:vt,key:bt},navigationType:dt}},[yt,mt,kt,_t,vt,bt,dt]);return warning(Mt!=null,`<Router basename="${yt}"> is not able to match the URL "${mt}${kt}${_t}" because it does not start with the basename, so the <Router> won't render anything.`),Mt==null?null:reactExports.createElement(NavigationContext.Provider,{value:ft},reactExports.createElement(LocationContext.Provider,{children:it,value:Mt}))}function Routes({children:rt,location:it}){return useRoutes(createRoutesFromChildren(rt),it)}function createRoutesFromChildren(rt,it=[]){let ct=[];return reactExports.Children.forEach(rt,(dt,ut)=>{if(!reactExports.isValidElement(dt))return;let pt=[...it,ut];if(dt.type===reactExports.Fragment){ct.push.apply(ct,createRoutesFromChildren(dt.props.children,pt));return}invariant(dt.type===Route$1,`[${typeof dt.type=="string"?dt.type:dt.type.name}] is not a <Route> component. All component children of <Routes> must be a <Route> or <React.Fragment>`),invariant(!dt.props.index||!dt.props.children,"An index route cannot have child routes.");let yt={id:dt.props.id||pt.join("-"),caseSensitive:dt.props.caseSensitive,element:dt.props.element,Component:dt.props.Component,index:dt.props.index,path:dt.props.path,middleware:dt.props.middleware,loader:dt.props.loader,action:dt.props.action,hydrateFallbackElement:dt.props.hydrateFallbackElement,HydrateFallback:dt.props.HydrateFallback,errorElement:dt.props.errorElement,ErrorBoundary:dt.props.ErrorBoundary,hasErrorBoundary:dt.props.hasErrorBoundary===!0||dt.props.ErrorBoundary!=null||dt.props.errorElement!=null,shouldRevalidate:dt.props.shouldRevalidate,handle:dt.props.handle,lazy:dt.props.lazy};dt.props.children&&(yt.children=createRoutesFromChildren(dt.props.children,pt)),ct.push(yt)}),ct}var defaultMethod="get",defaultEncType="application/x-www-form-urlencoded";function isHtmlElement(rt){return rt!=null&&typeof rt.tagName=="string"}function isButtonElement(rt){return isHtmlElement(rt)&&rt.tagName.toLowerCase()==="button"}function isFormElement(rt){return isHtmlElement(rt)&&rt.tagName.toLowerCase()==="form"}function isInputElement(rt){return isHtmlElement(rt)&&rt.tagName.toLowerCase()==="input"}function isModifiedEvent(rt){return!!(rt.metaKey||rt.altKey||rt.ctrlKey||rt.shiftKey)}function shouldProcessLinkClick(rt,it){return rt.button===0&&(!it||it==="_self")&&!isModifiedEvent(rt)}var _formDataSupportsSubmitter=null;function isFormDataSubmitterSupported(){if(_formDataSupportsSubmitter===null)try{new FormData(document.createElement("form"),0),_formDataSupportsSubmitter=!1}catch{_formDataSupportsSubmitter=!0}return _formDataSupportsSubmitter}var supportedFormEncTypes=new Set(["application/x-www-form-urlencoded","multipart/form-data","text/plain"]);function getFormEncType(rt){return rt!=null&&!supportedFormEncTypes.has(rt)?(warning(!1,`"${rt}" is not a valid \`encType\` for \`<Form>\`/\`<fetcher.Form>\` and will default to "${defaultEncType}"`),null):rt}function getFormSubmissionInfo(rt,it){let ct,dt,ut,pt,yt;if(isFormElement(rt)){let ft=rt.getAttribute("action");dt=ft?stripBasename(ft,it):null,ct=rt.getAttribute("method")||defaultMethod,ut=getFormEncType(rt.getAttribute("enctype"))||defaultEncType,pt=new FormData(rt)}else if(isButtonElement(rt)||isInputElement(rt)&&(rt.type==="submit"||rt.type==="image")){let ft=rt.form;if(ft==null)throw new Error('Cannot submit a <button> or <input type="submit"> without a <form>');let mt=rt.getAttribute("formaction")||ft.getAttribute("action");if(dt=mt?stripBasename(mt,it):null,ct=rt.getAttribute("formmethod")||ft.getAttribute("method")||defaultMethod,ut=getFormEncType(rt.getAttribute("formenctype"))||getFormEncType(ft.getAttribute("enctype"))||defaultEncType,pt=new FormData(ft,rt),!isFormDataSubmitterSupported()){let{name:kt,type:_t,value:vt}=rt;if(_t==="image"){let bt=kt?`${kt}.`:"";pt.append(`${bt}x`,"0"),pt.append(`${bt}y`,"0")}else kt&&pt.append(kt,vt)}}else{if(isHtmlElement(rt))throw new Error('Cannot submit element that is not <form>, <button>, or <input type="submit|image">');ct=defaultMethod,dt=null,ut=defaultEncType,yt=rt}return pt&&ut==="text/plain"&&(yt=pt,pt=void 0),{action:dt,method:ct.toLowerCase(),encType:ut,formData:pt,body:yt}}Object.getOwnPropertyNames(Object.prototype).sort().join("\0");function invariant2(rt,it){if(rt===!1||rt===null||typeof rt>"u")throw new Error(it)}function singleFetchUrl(rt,it,ct){let dt=typeof rt=="string"?new URL(rt,typeof window>"u"?"server://singlefetch/":window.location.origin):rt;return dt.pathname==="/"?dt.pathname=`_root.${ct}`:it&&stripBasename(dt.pathname,it)==="/"?dt.pathname=`${it.replace(/\/$/,"")}/_root.${ct}`:dt.pathname=`${dt.pathname.replace(/\/$/,"")}.${ct}`,dt}async function loadRouteModule(rt,it){if(rt.id in it)return it[rt.id];try{let ct=await import(rt.module);return it[rt.id]=ct,ct}catch(ct){return console.error(`Error loading route module \`${rt.module}\`, reloading page...`),console.error(ct),window.__reactRouterContext&&window.__reactRouterContext.isSpaMode,window.location.reload(),new Promise(()=>{})}}function isHtmlLinkDescriptor(rt){return rt==null?!1:rt.href==null?rt.rel==="preload"&&typeof rt.imageSrcSet=="string"&&typeof rt.imageSizes=="string":typeof rt.rel=="string"&&typeof rt.href=="string"}async function getKeyedPrefetchLinks(rt,it,ct){let dt=await Promise.all(rt.map(async ut=>{let pt=it.routes[ut.route.id];if(pt){let yt=await loadRouteModule(pt,ct);return yt.links?yt.links():[]}return[]}));return dedupeLinkDescriptors(dt.flat(1).filter(isHtmlLinkDescriptor).filter(ut=>ut.rel==="stylesheet"||ut.rel==="preload").map(ut=>ut.rel==="stylesheet"?{...ut,rel:"prefetch",as:"style"}:{...ut,rel:"prefetch"}))}function getNewMatchesForLinks(rt,it,ct,dt,ut,pt){let yt=(mt,kt)=>ct[kt]?mt.route.id!==ct[kt].route.id:!0,ft=(mt,kt)=>ct[kt].pathname!==mt.pathname||ct[kt].route.path?.endsWith("*")&&ct[kt].params["*"]!==mt.params["*"];return pt==="assets"?it.filter((mt,kt)=>yt(mt,kt)||ft(mt,kt)):pt==="data"?it.filter((mt,kt)=>{let _t=dt.routes[mt.route.id];if(!_t||!_t.hasLoader)return!1;if(yt(mt,kt)||ft(mt,kt))return!0;if(mt.route.shouldRevalidate){let vt=mt.route.shouldRevalidate({currentUrl:new URL(ut.pathname+ut.search+ut.hash,window.origin),currentParams:ct[0]?.params||{},nextUrl:new URL(rt,window.origin),nextParams:mt.params,defaultShouldRevalidate:!0});if(typeof vt=="boolean")return vt}return!0}):[]}function getModuleLinkHrefs(rt,it,{includeHydrateFallback:ct}={}){return dedupeHrefs(rt.map(dt=>{let ut=it.routes[dt.route.id];if(!ut)return[];let pt=[ut.module];return ut.clientActionModule&&(pt=pt.concat(ut.clientActionModule)),ut.clientLoaderModule&&(pt=pt.concat(ut.clientLoaderModule)),ct&&ut.hydrateFallbackModule&&(pt=pt.concat(ut.hydrateFallbackModule)),ut.imports&&(pt=pt.concat(ut.imports)),pt}).flat(1))}function dedupeHrefs(rt){return[...new Set(rt)]}function sortKeys(rt){let it={},ct=Object.keys(rt).sort();for(let dt of ct)it[dt]=rt[dt];return it}function dedupeLinkDescriptors(rt,it){let ct=new Set;return new Set(it),rt.reduce((dt,ut)=>{let pt=JSON.stringify(sortKeys(ut));return ct.has(pt)||(ct.add(pt),dt.push({key:pt,link:ut})),dt},[])}function useDataRouterContext2(){let rt=reactExports.useContext(DataRouterContext);return invariant2(rt,"You must render this element inside a <DataRouterContext.Provider> element"),rt}function useDataRouterStateContext(){let rt=reactExports.useContext(DataRouterStateContext);return invariant2(rt,"You must render this element inside a <DataRouterStateContext.Provider> element"),rt}var FrameworkContext=reactExports.createContext(void 0);FrameworkContext.displayName="FrameworkContext";function useFrameworkContext(){let rt=reactExports.useContext(FrameworkContext);return invariant2(rt,"You must render this element inside a <HydratedRouter> element"),rt}function usePrefetchBehavior(rt,it){let ct=reactExports.useContext(FrameworkContext),[dt,ut]=reactExports.useState(!1),[pt,yt]=reactExports.useState(!1),{onFocus:ft,onBlur:mt,onMouseEnter:kt,onMouseLeave:_t,onTouchStart:vt}=it,bt=reactExports.useRef(null);reactExports.useEffect(()=>{if(rt==="render"&&yt(!0),rt==="viewport"){let St=Nt=>{Nt.forEach($t=>{yt($t.isIntersecting)})},It=new IntersectionObserver(St,{threshold:.5});return bt.current&&It.observe(bt.current),()=>{It.disconnect()}}},[rt]),reactExports.useEffect(()=>{if(dt){let St=setTimeout(()=>{yt(!0)},100);return()=>{clearTimeout(St)}}},[dt]);let Mt=()=>{ut(!0)},wt=()=>{ut(!1),yt(!1)};return ct?rt!=="intent"?[pt,bt,{}]:[pt,bt,{onFocus:composeEventHandlers(ft,Mt),onBlur:composeEventHandlers(mt,wt),onMouseEnter:composeEventHandlers(kt,Mt),onMouseLeave:composeEventHandlers(_t,wt),onTouchStart:composeEventHandlers(vt,Mt)}]:[!1,bt,{}]}function composeEventHandlers(rt,it){return ct=>{rt&&rt(ct),ct.defaultPrevented||it(ct)}}function PrefetchPageLinks({page:rt,...it}){let{router:ct}=useDataRouterContext2(),dt=reactExports.useMemo(()=>matchRoutes(ct.routes,rt,ct.basename),[ct.routes,rt,ct.basename]);return dt?reactExports.createElement(PrefetchPageLinksImpl,{page:rt,matches:dt,...it}):null}function useKeyedPrefetchLinks(rt){let{manifest:it,routeModules:ct}=useFrameworkContext(),[dt,ut]=reactExports.useState([]);return reactExports.useEffect(()=>{let pt=!1;return getKeyedPrefetchLinks(rt,it,ct).then(yt=>{pt||ut(yt)}),()=>{pt=!0}},[rt,it,ct]),dt}function PrefetchPageLinksImpl({page:rt,matches:it,...ct}){let dt=useLocation(),{manifest:ut,routeModules:pt}=useFrameworkContext(),{basename:yt}=useDataRouterContext2(),{loaderData:ft,matches:mt}=useDataRouterStateContext(),kt=reactExports.useMemo(()=>getNewMatchesForLinks(rt,it,mt,ut,dt,"data"),[rt,it,mt,ut,dt]),_t=reactExports.useMemo(()=>getNewMatchesForLinks(rt,it,mt,ut,dt,"assets"),[rt,it,mt,ut,dt]),vt=reactExports.useMemo(()=>{if(rt===dt.pathname+dt.search+dt.hash)return[];let wt=new Set,St=!1;if(it.forEach(Nt=>{let $t=ut.routes[Nt.route.id];!$t||!$t.hasLoader||(!kt.some(Et=>Et.route.id===Nt.route.id)&&Nt.route.id in ft&&pt[Nt.route.id]?.shouldRevalidate||$t.hasClientLoader?St=!0:wt.add(Nt.route.id))}),wt.size===0)return[];let It=singleFetchUrl(rt,yt,"data");return St&&wt.size>0&&It.searchParams.set("_routes",it.filter(Nt=>wt.has(Nt.route.id)).map(Nt=>Nt.route.id).join(",")),[It.pathname+It.search]},[yt,ft,dt,ut,kt,it,rt,pt]),bt=reactExports.useMemo(()=>getModuleLinkHrefs(_t,ut),[_t,ut]),Mt=useKeyedPrefetchLinks(_t);return reactExports.createElement(reactExports.Fragment,null,vt.map(wt=>reactExports.createElement("link",{key:wt,rel:"prefetch",as:"fetch",href:wt,...ct})),bt.map(wt=>reactExports.createElement("link",{key:wt,rel:"modulepreload",href:wt,...ct})),Mt.map(({key:wt,link:St})=>reactExports.createElement("link",{key:wt,nonce:ct.nonce,...St})))}function mergeRefs(...rt){return it=>{rt.forEach(ct=>{typeof ct=="function"?ct(it):ct!=null&&(ct.current=it)})}}var isBrowser=typeof window<"u"&&typeof window.document<"u"&&typeof window.document.createElement<"u";try{isBrowser&&(window.__reactRouterVersion="7.9.6")}catch{}function BrowserRouter({basename:rt,children:it,window:ct}){let dt=reactExports.useRef();dt.current==null&&(dt.current=createBrowserHistory({window:ct,v5Compat:!0}));let ut=dt.current,[pt,yt]=reactExports.useState({action:ut.action,location:ut.location}),ft=reactExports.useCallback(mt=>{reactExports.startTransition(()=>yt(mt))},[yt]);return reactExports.useLayoutEffect(()=>ut.listen(ft),[ut,ft]),reactExports.createElement(Router$1,{basename:rt,children:it,location:pt.location,navigationType:pt.action,navigator:ut})}var ABSOLUTE_URL_REGEX2=/^(?:[a-z][a-z0-9+.-]*:|\/\/)/i,Link$1=reactExports.forwardRef(function({onClick:it,discover:ct="render",prefetch:dt="none",relative:ut,reloadDocument:pt,replace:yt,state:ft,target:mt,to:kt,preventScrollReset:_t,viewTransition:vt,...bt},Mt){let{basename:wt}=reactExports.useContext(NavigationContext),St=typeof kt=="string"&&ABSOLUTE_URL_REGEX2.test(kt),It,Nt=!1;if(typeof kt=="string"&&St&&(It=kt,isBrowser))try{let Yt=new URL(window.location.href),aa=kt.startsWith("//")?new URL(Yt.protocol+kt):new URL(kt),Qt=stripBasename(aa.pathname,wt);aa.origin===Yt.origin&&Qt!=null?kt=Qt+aa.search+aa.hash:Nt=!0}catch{warning(!1,`<Link to="${kt}"> contains an invalid URL which will probably break when clicked - please update to a valid URL path.`)}let $t=useHref(kt,{relative:ut}),[Et,Ft,qt]=usePrefetchBehavior(dt,bt),Ht=useLinkClickHandler(kt,{replace:yt,state:ft,target:mt,preventScrollReset:_t,relative:ut,viewTransition:vt});function Ot(Yt){it&&it(Yt),Yt.defaultPrevented||Ht(Yt)}let Zt=reactExports.createElement("a",{...bt,...qt,href:It||$t,onClick:Nt||pt?it:Ot,ref:mergeRefs(Mt,Ft),target:mt,"data-discover":!St&&ct==="render"?"true":void 0});return Et&&!St?reactExports.createElement(reactExports.Fragment,null,Zt,reactExports.createElement(PrefetchPageLinks,{page:$t})):Zt});Link$1.displayName="Link";var NavLink=reactExports.forwardRef(function({"aria-current":it="page",caseSensitive:ct=!1,className:dt="",end:ut=!1,style:pt,to:yt,viewTransition:ft,children:mt,...kt},_t){let vt=useResolvedPath(yt,{relative:kt.relative}),bt=useLocation(),Mt=reactExports.useContext(DataRouterStateContext),{navigator:wt,basename:St}=reactExports.useContext(NavigationContext),It=Mt!=null&&useViewTransitionState(vt)&&ft===!0,Nt=wt.encodeLocation?wt.encodeLocation(vt).pathname:vt.pathname,$t=bt.pathname,Et=Mt&&Mt.navigation&&Mt.navigation.location?Mt.navigation.location.pathname:null;ct||($t=$t.toLowerCase(),Et=Et?Et.toLowerCase():null,Nt=Nt.toLowerCase()),Et&&St&&(Et=stripBasename(Et,St)||Et);const Ft=Nt!=="/"&&Nt.endsWith("/")?Nt.length-1:Nt.length;let qt=$t===Nt||!ut&&$t.startsWith(Nt)&&$t.charAt(Ft)==="/",Ht=Et!=null&&(Et===Nt||!ut&&Et.startsWith(Nt)&&Et.charAt(Nt.length)==="/"),Ot={isActive:qt,isPending:Ht,isTransitioning:It},Zt=qt?it:void 0,Yt;typeof dt=="function"?Yt=dt(Ot):Yt=[dt,qt?"active":null,Ht?"pending":null,It?"transitioning":null].filter(Boolean).join(" ");let aa=typeof pt=="function"?pt(Ot):pt;return reactExports.createElement(Link$1,{...kt,"aria-current":Zt,className:Yt,ref:_t,style:aa,to:yt,viewTransition:ft},typeof mt=="function"?mt(Ot):mt)});NavLink.displayName="NavLink";var Form=reactExports.forwardRef(({discover:rt="render",fetcherKey:it,navigate:ct,reloadDocument:dt,replace:ut,state:pt,method:yt=defaultMethod,action:ft,onSubmit:mt,relative:kt,preventScrollReset:_t,viewTransition:vt,...bt},Mt)=>{let wt=useSubmit(),St=useFormAction(ft,{relative:kt}),It=yt.toLowerCase()==="get"?"get":"post",Nt=typeof ft=="string"&&ABSOLUTE_URL_REGEX2.test(ft),$t=Et=>{if(mt&&mt(Et),Et.defaultPrevented)return;Et.preventDefault();let Ft=Et.nativeEvent.submitter,qt=Ft?.getAttribute("formmethod")||yt;wt(Ft||Et.currentTarget,{fetcherKey:it,method:qt,navigate:ct,replace:ut,state:pt,relative:kt,preventScrollReset:_t,viewTransition:vt})};return reactExports.createElement("form",{ref:Mt,method:It,action:St,onSubmit:dt?mt:$t,...bt,"data-discover":!Nt&&rt==="render"?"true":void 0})});Form.displayName="Form";function getDataRouterConsoleError2(rt){return`${rt} must be used within a data router.  See https://reactrouter.com/en/main/routers/picking-a-router.`}function useDataRouterContext3(rt){let it=reactExports.useContext(DataRouterContext);return invariant(it,getDataRouterConsoleError2(rt)),it}function useLinkClickHandler(rt,{target:it,replace:ct,state:dt,preventScrollReset:ut,relative:pt,viewTransition:yt}={}){let ft=useNavigate(),mt=useLocation(),kt=useResolvedPath(rt,{relative:pt});return reactExports.useCallback(_t=>{if(shouldProcessLinkClick(_t,it)){_t.preventDefault();let vt=ct!==void 0?ct:createPath(mt)===createPath(kt);ft(rt,{replace:vt,state:dt,preventScrollReset:ut,relative:pt,viewTransition:yt})}},[mt,ft,kt,ct,dt,it,rt,ut,pt,yt])}var fetcherId=0,getUniqueFetcherId=()=>`__${String(++fetcherId)}__`;function useSubmit(){let{router:rt}=useDataRouterContext3("useSubmit"),{basename:it}=reactExports.useContext(NavigationContext),ct=useRouteId();return reactExports.useCallback(async(dt,ut={})=>{let{action:pt,method:yt,encType:ft,formData:mt,body:kt}=getFormSubmissionInfo(dt,it);if(ut.navigate===!1){let _t=ut.fetcherKey||getUniqueFetcherId();await rt.fetch(_t,ct,ut.action||pt,{preventScrollReset:ut.preventScrollReset,formData:mt,body:kt,formMethod:ut.method||yt,formEncType:ut.encType||ft,flushSync:ut.flushSync})}else await rt.navigate(ut.action||pt,{preventScrollReset:ut.preventScrollReset,formData:mt,body:kt,formMethod:ut.method||yt,formEncType:ut.encType||ft,replace:ut.replace,state:ut.state,fromRouteId:ct,flushSync:ut.flushSync,viewTransition:ut.viewTransition})},[rt,it,ct])}function useFormAction(rt,{relative:it}={}){let{basename:ct}=reactExports.useContext(NavigationContext),dt=reactExports.useContext(RouteContext);invariant(dt,"useFormAction must be used inside a RouteContext");let[ut]=dt.matches.slice(-1),pt={...useResolvedPath(rt||".",{relative:it})},yt=useLocation();if(rt==null){pt.search=yt.search;let ft=new URLSearchParams(pt.search),mt=ft.getAll("index");if(mt.some(_t=>_t==="")){ft.delete("index"),mt.filter(vt=>vt).forEach(vt=>ft.append("index",vt));let _t=ft.toString();pt.search=_t?`?${_t}`:""}}return(!rt||rt===".")&&ut.route.index&&(pt.search=pt.search?pt.search.replace(/^\?/,"?index&"):"?index"),ct!=="/"&&(pt.pathname=pt.pathname==="/"?ct:joinPaths([ct,pt.pathname])),createPath(pt)}function useViewTransitionState(rt,{relative:it}={}){let ct=reactExports.useContext(ViewTransitionContext);invariant(ct!=null,"`useViewTransitionState` must be used within `react-router-dom`'s `RouterProvider`.  Did you accidentally import `RouterProvider` from `react-router`?");let{basename:dt}=useDataRouterContext3("useViewTransitionState"),ut=useResolvedPath(rt,{relative:it});if(!ct.isTransitioning)return!1;let pt=stripBasename(ct.currentLocation.pathname,dt)||ct.currentLocation.pathname,yt=stripBasename(ct.nextLocation.pathname,dt)||ct.nextLocation.pathname;return matchPath(ut.pathname,yt)!=null||matchPath(ut.pathname,pt)!=null}const toKebabCase=rt=>rt.replace(/([a-z0-9])([A-Z])/g,"$1-$2").toLowerCase(),toCamelCase=rt=>rt.replace(/^([A-Z])|[\s-_]+(\w)/g,(it,ct,dt)=>dt?dt.toUpperCase():ct.toLowerCase()),toPascalCase=rt=>{const it=toCamelCase(rt);return it.charAt(0).toUpperCase()+it.slice(1)},mergeClasses=(...rt)=>rt.filter((it,ct,dt)=>!!it&&it.trim()!==""&&dt.indexOf(it)===ct).join(" ").trim(),hasA11yProp=rt=>{for(const it in rt)if(it.startsWith("aria-")||it==="role"||it==="title")return!0};var defaultAttributes={xmlns:"http://www.w3.org/2000/svg",width:24,height:24,viewBox:"0 0 24 24",fill:"none",stroke:"currentColor",strokeWidth:2,strokeLinecap:"round",strokeLinejoin:"round"};const Icon=reactExports.forwardRef(({color:rt="currentColor",size:it=24,strokeWidth:ct=2,absoluteStrokeWidth:dt,className:ut="",children:pt,iconNode:yt,...ft},mt)=>reactExports.createElement("svg",{ref:mt,...defaultAttributes,width:it,height:it,stroke:rt,strokeWidth:dt?Number(ct)*24/Number(it):ct,className:mergeClasses("lucide",ut),...!pt&&!hasA11yProp(ft)&&{"aria-hidden":"true"},...ft},[...yt.map(([kt,_t])=>reactExports.createElement(kt,_t)),...Array.isArray(pt)?pt:[pt]]));const createLucideIcon=(rt,it)=>{const ct=reactExports.forwardRef(({className:dt,...ut},pt)=>reactExports.createElement(Icon,{ref:pt,iconNode:it,className:mergeClasses(`lucide-${toKebabCase(toPascalCase(rt))}`,`lucide-${rt}`,dt),...ut}));return ct.displayName=toPascalCase(rt),ct};const __iconNode$pL=[["path",{d:"m14 12 4 4 4-4",key:"buelq4"}],["path",{d:"M18 16V7",key:"ty0viw"}],["path",{d:"m2 16 4.039-9.69a.5.5 0 0 1 .923 0L11 16",key:"d5nyq2"}],["path",{d:"M3.304 13h6.392",key:"1q3zxz"}]],AArrowDown=createLucideIcon("a-arrow-down",__iconNode$pL);const __iconNode$pK=[["path",{d:"m15 16 2.536-7.328a1.02 1.02 1 0 1 1.928 0L22 16",key:"xik6mr"}],["path",{d:"M15.697 14h5.606",key:"1stdlc"}],["path",{d:"m2 16 4.039-9.69a.5.5 0 0 1 .923 0L11 16",key:"d5nyq2"}],["path",{d:"M3.304 13h6.392",key:"1q3zxz"}]],ALargeSmall=createLucideIcon("a-large-small",__iconNode$pK);const __iconNode$pJ=[["path",{d:"m14 11 4-4 4 4",key:"1pu57t"}],["path",{d:"M18 16V7",key:"ty0viw"}],["path",{d:"m2 16 4.039-9.69a.5.5 0 0 1 .923 0L11 16",key:"d5nyq2"}],["path",{d:"M3.304 13h6.392",key:"1q3zxz"}]],AArrowUp=createLucideIcon("a-arrow-up",__iconNode$pJ);const __iconNode$pI=[["circle",{cx:"16",cy:"4",r:"1",key:"1grugj"}],["path",{d:"m18 19 1-7-6 1",key:"r0i19z"}],["path",{d:"m5 8 3-3 5.5 3-2.36 3.5",key:"9ptxx2"}],["path",{d:"M4.24 14.5a5 5 0 0 0 6.88 6",key:"10kmtu"}],["path",{d:"M13.76 17.5a5 5 0 0 0-6.88-6",key:"2qq6rc"}]],Accessibility=createLucideIcon("accessibility",__iconNode$pI);const __iconNode$pH=[["path",{d:"M22 12h-2.48a2 2 0 0 0-1.93 1.46l-2.35 8.36a.25.25 0 0 1-.48 0L9.24 2.18a.25.25 0 0 0-.48 0l-2.35 8.36A2 2 0 0 1 4.49 12H2",key:"169zse"}]],Activity=createLucideIcon("activity",__iconNode$pH);const __iconNode$pG=[["path",{d:"M18 17.5a2.5 2.5 0 1 1-4 2.03V12",key:"yd12zl"}],["path",{d:"M6 12H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v5a2 2 0 0 1-2 2h-2",key:"larmp2"}],["path",{d:"M6 8h12",key:"6g4wlu"}],["path",{d:"M6.6 15.572A2 2 0 1 0 10 17v-5",key:"1x1kqn"}]],AirVent=createLucideIcon("air-vent",__iconNode$pG);const __iconNode$pF=[["path",{d:"M5 17H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2h-1",key:"ns4c3b"}],["path",{d:"m12 15 5 6H7Z",key:"14qnn2"}]],Airplay=createLucideIcon("airplay",__iconNode$pF);const __iconNode$pE=[["circle",{cx:"12",cy:"13",r:"8",key:"3y4lt7"}],["path",{d:"M5 3 2 6",key:"18tl5t"}],["path",{d:"m22 6-3-3",key:"1opdir"}],["path",{d:"M6.38 18.7 4 21",key:"17xu3x"}],["path",{d:"M17.64 18.67 20 21",key:"kv2oe2"}],["path",{d:"m9 13 2 2 4-4",key:"6343dt"}]],AlarmClockCheck=createLucideIcon("alarm-clock-check",__iconNode$pE);const __iconNode$pD=[["circle",{cx:"12",cy:"13",r:"8",key:"3y4lt7"}],["path",{d:"M5 3 2 6",key:"18tl5t"}],["path",{d:"m22 6-3-3",key:"1opdir"}],["path",{d:"M6.38 18.7 4 21",key:"17xu3x"}],["path",{d:"M17.64 18.67 20 21",key:"kv2oe2"}],["path",{d:"M9 13h6",key:"1uhe8q"}]],AlarmClockMinus=createLucideIcon("alarm-clock-minus",__iconNode$pD);const __iconNode$pC=[["path",{d:"M6.87 6.87a8 8 0 1 0 11.26 11.26",key:"3on8tj"}],["path",{d:"M19.9 14.25a8 8 0 0 0-9.15-9.15",key:"15ghsc"}],["path",{d:"m22 6-3-3",key:"1opdir"}],["path",{d:"M6.26 18.67 4 21",key:"yzmioq"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M4 4 2 6",key:"1ycko6"}]],AlarmClockOff=createLucideIcon("alarm-clock-off",__iconNode$pC);const __iconNode$pB=[["circle",{cx:"12",cy:"13",r:"8",key:"3y4lt7"}],["path",{d:"M12 9v4l2 2",key:"1c63tq"}],["path",{d:"M5 3 2 6",key:"18tl5t"}],["path",{d:"m22 6-3-3",key:"1opdir"}],["path",{d:"M6.38 18.7 4 21",key:"17xu3x"}],["path",{d:"M17.64 18.67 20 21",key:"kv2oe2"}]],AlarmClock=createLucideIcon("alarm-clock",__iconNode$pB);const __iconNode$pA=[["circle",{cx:"12",cy:"13",r:"8",key:"3y4lt7"}],["path",{d:"M5 3 2 6",key:"18tl5t"}],["path",{d:"m22 6-3-3",key:"1opdir"}],["path",{d:"M6.38 18.7 4 21",key:"17xu3x"}],["path",{d:"M17.64 18.67 20 21",key:"kv2oe2"}],["path",{d:"M12 10v6",key:"1bos4e"}],["path",{d:"M9 13h6",key:"1uhe8q"}]],AlarmClockPlus=createLucideIcon("alarm-clock-plus",__iconNode$pA);const __iconNode$pz=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",ry:"2",key:"1m3agn"}],["polyline",{points:"11 3 11 11 14 8 17 11 17 3",key:"1wcwz3"}]],Album=createLucideIcon("album",__iconNode$pz);const __iconNode$py=[["path",{d:"M11 21c0-2.5 2-2.5 2-5",key:"1sicvv"}],["path",{d:"M16 21c0-2.5 2-2.5 2-5",key:"1o3eny"}],["path",{d:"m19 8-.8 3a1.25 1.25 0 0 1-1.2 1H7a1.25 1.25 0 0 1-1.2-1L5 8",key:"1bvca4"}],["path",{d:"M21 3a1 1 0 0 1 1 1v2a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V4a1 1 0 0 1 1-1z",key:"x3qr1j"}],["path",{d:"M6 21c0-2.5 2-2.5 2-5",key:"i3w1gp"}]],AlarmSmoke=createLucideIcon("alarm-smoke",__iconNode$py);const __iconNode$px=[["path",{d:"M2 12h20",key:"9i4pu4"}],["path",{d:"M10 16v4a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2v-4",key:"11f1s0"}],["path",{d:"M10 8V4a2 2 0 0 0-2-2H6a2 2 0 0 0-2 2v4",key:"t14dx9"}],["path",{d:"M20 16v1a2 2 0 0 1-2 2h-2a2 2 0 0 1-2-2v-1",key:"1w07xs"}],["path",{d:"M14 8V7c0-1.1.9-2 2-2h2a2 2 0 0 1 2 2v1",key:"1apec2"}]],AlignCenterHorizontal=createLucideIcon("align-center-horizontal",__iconNode$px);const __iconNode$pw=[["path",{d:"M12 2v20",key:"t6zp3m"}],["path",{d:"M8 10H4a2 2 0 0 1-2-2V6c0-1.1.9-2 2-2h4",key:"14d6g8"}],["path",{d:"M16 10h4a2 2 0 0 0 2-2V6a2 2 0 0 0-2-2h-4",key:"1e2lrw"}],["path",{d:"M8 20H7a2 2 0 0 1-2-2v-2c0-1.1.9-2 2-2h1",key:"1fkdwx"}],["path",{d:"M16 14h1a2 2 0 0 1 2 2v2a2 2 0 0 1-2 2h-1",key:"1euafb"}]],AlignCenterVertical=createLucideIcon("align-center-vertical",__iconNode$pw);const __iconNode$pv=[["rect",{width:"6",height:"16",x:"4",y:"2",rx:"2",key:"z5wdxg"}],["rect",{width:"6",height:"9",x:"14",y:"9",rx:"2",key:"um7a8w"}],["path",{d:"M22 22H2",key:"19qnx5"}]],AlignEndHorizontal=createLucideIcon("align-end-horizontal",__iconNode$pv);const __iconNode$pu=[["rect",{width:"16",height:"6",x:"2",y:"4",rx:"2",key:"10wcwx"}],["rect",{width:"9",height:"6",x:"9",y:"14",rx:"2",key:"4p5bwg"}],["path",{d:"M22 22V2",key:"12ipfv"}]],AlignEndVertical=createLucideIcon("align-end-vertical",__iconNode$pu);const __iconNode$pt=[["rect",{width:"6",height:"14",x:"4",y:"5",rx:"2",key:"1wwnby"}],["rect",{width:"6",height:"10",x:"14",y:"7",rx:"2",key:"1fe6j6"}],["path",{d:"M17 22v-5",key:"4b6g73"}],["path",{d:"M17 7V2",key:"hnrr36"}],["path",{d:"M7 22v-3",key:"1r4jpn"}],["path",{d:"M7 5V2",key:"liy1u9"}]],AlignHorizontalDistributeCenter=createLucideIcon("align-horizontal-distribute-center",__iconNode$pt);const __iconNode$ps=[["rect",{width:"6",height:"14",x:"4",y:"5",rx:"2",key:"1wwnby"}],["rect",{width:"6",height:"10",x:"14",y:"7",rx:"2",key:"1fe6j6"}],["path",{d:"M10 2v20",key:"uyc634"}],["path",{d:"M20 2v20",key:"1tx262"}]],AlignHorizontalDistributeEnd=createLucideIcon("align-horizontal-distribute-end",__iconNode$ps);const __iconNode$pr=[["rect",{width:"6",height:"14",x:"4",y:"5",rx:"2",key:"1wwnby"}],["rect",{width:"6",height:"10",x:"14",y:"7",rx:"2",key:"1fe6j6"}],["path",{d:"M4 2v20",key:"gtpd5x"}],["path",{d:"M14 2v20",key:"tg6bpw"}]],AlignHorizontalDistributeStart=createLucideIcon("align-horizontal-distribute-start",__iconNode$pr);const __iconNode$pq=[["rect",{width:"6",height:"14",x:"2",y:"5",rx:"2",key:"dy24zr"}],["rect",{width:"6",height:"10",x:"16",y:"7",rx:"2",key:"13zkjt"}],["path",{d:"M12 2v20",key:"t6zp3m"}]],AlignHorizontalJustifyCenter=createLucideIcon("align-horizontal-justify-center",__iconNode$pq);const __iconNode$pp=[["rect",{width:"6",height:"14",x:"2",y:"5",rx:"2",key:"dy24zr"}],["rect",{width:"6",height:"10",x:"12",y:"7",rx:"2",key:"1ht384"}],["path",{d:"M22 2v20",key:"40qfg1"}]],AlignHorizontalJustifyEnd=createLucideIcon("align-horizontal-justify-end",__iconNode$pp);const __iconNode$po=[["rect",{width:"6",height:"14",x:"6",y:"5",rx:"2",key:"hsirpf"}],["rect",{width:"6",height:"10",x:"16",y:"7",rx:"2",key:"13zkjt"}],["path",{d:"M2 2v20",key:"1ivd8o"}]],AlignHorizontalJustifyStart=createLucideIcon("align-horizontal-justify-start",__iconNode$po);const __iconNode$pn=[["rect",{width:"6",height:"10",x:"9",y:"7",rx:"2",key:"yn7j0q"}],["path",{d:"M4 22V2",key:"tsjzd3"}],["path",{d:"M20 22V2",key:"1bnhr8"}]],AlignHorizontalSpaceAround=createLucideIcon("align-horizontal-space-around",__iconNode$pn);const __iconNode$pm=[["rect",{width:"6",height:"14",x:"3",y:"5",rx:"2",key:"j77dae"}],["rect",{width:"6",height:"10",x:"15",y:"7",rx:"2",key:"bq30hj"}],["path",{d:"M3 2v20",key:"1d2pfg"}],["path",{d:"M21 2v20",key:"p059bm"}]],AlignHorizontalSpaceBetween=createLucideIcon("align-horizontal-space-between",__iconNode$pm);const __iconNode$pl=[["rect",{width:"6",height:"16",x:"4",y:"6",rx:"2",key:"1n4dg1"}],["rect",{width:"6",height:"9",x:"14",y:"6",rx:"2",key:"17khns"}],["path",{d:"M22 2H2",key:"fhrpnj"}]],AlignStartHorizontal=createLucideIcon("align-start-horizontal",__iconNode$pl);const __iconNode$pk=[["rect",{width:"9",height:"6",x:"6",y:"14",rx:"2",key:"lpm2y7"}],["rect",{width:"16",height:"6",x:"6",y:"4",rx:"2",key:"rdj6ps"}],["path",{d:"M2 2v20",key:"1ivd8o"}]],AlignStartVertical=createLucideIcon("align-start-vertical",__iconNode$pk);const __iconNode$pj=[["path",{d:"M22 17h-3",key:"1lwga1"}],["path",{d:"M22 7h-5",key:"o2endc"}],["path",{d:"M5 17H2",key:"1gx9xc"}],["path",{d:"M7 7H2",key:"6bq26l"}],["rect",{x:"5",y:"14",width:"14",height:"6",rx:"2",key:"1qrzuf"}],["rect",{x:"7",y:"4",width:"10",height:"6",rx:"2",key:"we8e9z"}]],AlignVerticalDistributeCenter=createLucideIcon("align-vertical-distribute-center",__iconNode$pj);const __iconNode$pi=[["rect",{width:"14",height:"6",x:"5",y:"14",rx:"2",key:"jmoj9s"}],["rect",{width:"10",height:"6",x:"7",y:"4",rx:"2",key:"aza5on"}],["path",{d:"M2 20h20",key:"owomy5"}],["path",{d:"M2 10h20",key:"1ir3d8"}]],AlignVerticalDistributeEnd=createLucideIcon("align-vertical-distribute-end",__iconNode$pi);const __iconNode$ph=[["rect",{width:"14",height:"6",x:"5",y:"14",rx:"2",key:"jmoj9s"}],["rect",{width:"10",height:"6",x:"7",y:"4",rx:"2",key:"aza5on"}],["path",{d:"M2 14h20",key:"myj16y"}],["path",{d:"M2 4h20",key:"mda7wb"}]],AlignVerticalDistributeStart=createLucideIcon("align-vertical-distribute-start",__iconNode$ph);const __iconNode$pg=[["rect",{width:"14",height:"6",x:"5",y:"16",rx:"2",key:"1i8z2d"}],["rect",{width:"10",height:"6",x:"7",y:"2",rx:"2",key:"ypihtt"}],["path",{d:"M2 12h20",key:"9i4pu4"}]],AlignVerticalJustifyCenter=createLucideIcon("align-vertical-justify-center",__iconNode$pg);const __iconNode$pf=[["rect",{width:"14",height:"6",x:"5",y:"12",rx:"2",key:"4l4tp2"}],["rect",{width:"10",height:"6",x:"7",y:"2",rx:"2",key:"ypihtt"}],["path",{d:"M2 22h20",key:"272qi7"}]],AlignVerticalJustifyEnd=createLucideIcon("align-vertical-justify-end",__iconNode$pf);const __iconNode$pe=[["rect",{width:"14",height:"6",x:"5",y:"16",rx:"2",key:"1i8z2d"}],["rect",{width:"10",height:"6",x:"7",y:"6",rx:"2",key:"13squh"}],["path",{d:"M2 2h20",key:"1ennik"}]],AlignVerticalJustifyStart=createLucideIcon("align-vertical-justify-start",__iconNode$pe);const __iconNode$pd=[["rect",{width:"10",height:"6",x:"7",y:"9",rx:"2",key:"b1zbii"}],["path",{d:"M22 20H2",key:"1p1f7z"}],["path",{d:"M22 4H2",key:"1b7qnq"}]],AlignVerticalSpaceAround=createLucideIcon("align-vertical-space-around",__iconNode$pd);const __iconNode$pc=[["rect",{width:"14",height:"6",x:"5",y:"15",rx:"2",key:"1w91an"}],["rect",{width:"10",height:"6",x:"7",y:"3",rx:"2",key:"17wqzy"}],["path",{d:"M2 21h20",key:"1nyx9w"}],["path",{d:"M2 3h20",key:"91anmk"}]],AlignVerticalSpaceBetween=createLucideIcon("align-vertical-space-between",__iconNode$pc);const __iconNode$pb=[["path",{d:"M10 10H6",key:"1bsnug"}],["path",{d:"M14 18V6a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v11a1 1 0 0 0 1 1h2",key:"wrbu53"}],["path",{d:"M19 18h2a1 1 0 0 0 1-1v-3.28a1 1 0 0 0-.684-.948l-1.923-.641a1 1 0 0 1-.578-.502l-1.539-3.076A1 1 0 0 0 16.382 8H14",key:"lrkjwd"}],["path",{d:"M8 8v4",key:"1fwk8c"}],["path",{d:"M9 18h6",key:"x1upvd"}],["circle",{cx:"17",cy:"18",r:"2",key:"332jqn"}],["circle",{cx:"7",cy:"18",r:"2",key:"19iecd"}]],Ambulance=createLucideIcon("ambulance",__iconNode$pb);const __iconNode$pa=[["path",{d:"M16 12h3",key:"4uvgyw"}],["path",{d:"M17.5 12a8 8 0 0 1-8 8A4.5 4.5 0 0 1 5 15.5c0-6 8-4 8-8.5a3 3 0 1 0-6 0c0 3 2.5 8.5 12 13",key:"nfoe1t"}]],Ampersand=createLucideIcon("ampersand",__iconNode$pa);const __iconNode$p9=[["path",{d:"M10 17c-5-3-7-7-7-9a2 2 0 0 1 4 0c0 2.5-5 2.5-5 6 0 1.7 1.3 3 3 3 2.8 0 5-2.2 5-5",key:"12lh1k"}],["path",{d:"M22 17c-5-3-7-7-7-9a2 2 0 0 1 4 0c0 2.5-5 2.5-5 6 0 1.7 1.3 3 3 3 2.8 0 5-2.2 5-5",key:"173c68"}]],Ampersands=createLucideIcon("ampersands",__iconNode$p9);const __iconNode$p8=[["path",{d:"M10 2v5.632c0 .424-.272.795-.653.982A6 6 0 0 0 6 14c.006 4 3 7 5 8",key:"1h8rid"}],["path",{d:"M10 5H8a2 2 0 0 0 0 4h.68",key:"3ezsi6"}],["path",{d:"M14 2v5.632c0 .424.272.795.652.982A6 6 0 0 1 18 14c0 4-3 7-5 8",key:"yt6q09"}],["path",{d:"M14 5h2a2 2 0 0 1 0 4h-.68",key:"8f95yk"}],["path",{d:"M18 22H6",key:"mg6kv4"}],["path",{d:"M9 2h6",key:"1jrp98"}]],Amphora=createLucideIcon("amphora",__iconNode$p8);const __iconNode$p7=[["path",{d:"M12 6v16",key:"nqf5sj"}],["path",{d:"m19 13 2-1a9 9 0 0 1-18 0l2 1",key:"y7qv08"}],["path",{d:"M9 11h6",key:"1fldmi"}],["circle",{cx:"12",cy:"4",r:"2",key:"muu5ef"}]],Anchor=createLucideIcon("anchor",__iconNode$p7);const __iconNode$p6=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M16 16s-1.5-2-4-2-4 2-4 2",key:"epbg0q"}],["path",{d:"M7.5 8 10 9",key:"olxxln"}],["path",{d:"m14 9 2.5-1",key:"1j6cij"}],["path",{d:"M9 10h.01",key:"qbtxuw"}],["path",{d:"M15 10h.01",key:"1qmjsl"}]],Angry=createLucideIcon("angry",__iconNode$p6);const __iconNode$p5=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M8 15h8",key:"45n4r"}],["path",{d:"M8 9h2",key:"1g203m"}],["path",{d:"M14 9h2",key:"116p9w"}]],Annoyed=createLucideIcon("annoyed",__iconNode$p5);const __iconNode$p4=[["path",{d:"M2 12 7 2",key:"117k30"}],["path",{d:"m7 12 5-10",key:"1tvx22"}],["path",{d:"m12 12 5-10",key:"ev1o1a"}],["path",{d:"m17 12 5-10",key:"1e4ti3"}],["path",{d:"M4.5 7h15",key:"vlsxkz"}],["path",{d:"M12 16v6",key:"c8a4gj"}]],Antenna=createLucideIcon("antenna",__iconNode$p4);const __iconNode$p3=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m14.31 8 5.74 9.94",key:"1y6ab4"}],["path",{d:"M9.69 8h11.48",key:"1wxppr"}],["path",{d:"m7.38 12 5.74-9.94",key:"1grp0k"}],["path",{d:"M9.69 16 3.95 6.06",key:"libnyf"}],["path",{d:"M14.31 16H2.83",key:"x5fava"}],["path",{d:"m16.62 12-5.74 9.94",key:"1vwawt"}]],Aperture=createLucideIcon("aperture",__iconNode$p3);const __iconNode$p2=[["path",{d:"M7 10H6a4 4 0 0 1-4-4 1 1 0 0 1 1-1h4",key:"1hjpb6"}],["path",{d:"M7 5a1 1 0 0 1 1-1h13a1 1 0 0 1 1 1 7 7 0 0 1-7 7H8a1 1 0 0 1-1-1z",key:"1qn45f"}],["path",{d:"M9 12v5",key:"3anwtq"}],["path",{d:"M15 12v5",key:"5xh3zn"}],["path",{d:"M5 20a3 3 0 0 1 3-3h8a3 3 0 0 1 3 3 1 1 0 0 1-1 1H6a1 1 0 0 1-1-1",key:"1fi4x8"}]],Anvil=createLucideIcon("anvil",__iconNode$p2);const __iconNode$p1=[["rect",{width:"20",height:"16",x:"2",y:"4",rx:"2",key:"18n3k1"}],["path",{d:"M6 8h.01",key:"x9i8wu"}],["path",{d:"M10 8h.01",key:"1r9ogq"}],["path",{d:"M14 8h.01",key:"1primd"}]],AppWindowMac=createLucideIcon("app-window-mac",__iconNode$p1);const __iconNode$p0=[["rect",{x:"2",y:"4",width:"20",height:"16",rx:"2",key:"izxlao"}],["path",{d:"M10 4v4",key:"pp8u80"}],["path",{d:"M2 8h20",key:"d11cs7"}],["path",{d:"M6 4v4",key:"1svtjw"}]],AppWindow=createLucideIcon("app-window",__iconNode$p0);const __iconNode$o$=[["path",{d:"M12 6.528V3a1 1 0 0 1 1-1h0",key:"11qiee"}],["path",{d:"M18.237 21A15 15 0 0 0 22 11a6 6 0 0 0-10-4.472A6 6 0 0 0 2 11a15.1 15.1 0 0 0 3.763 10 3 3 0 0 0 3.648.648 5.5 5.5 0 0 1 5.178 0A3 3 0 0 0 18.237 21",key:"110c12"}]],Apple=createLucideIcon("apple",__iconNode$o$);const __iconNode$o_=[["rect",{width:"20",height:"5",x:"2",y:"3",rx:"1",key:"1wp1u1"}],["path",{d:"M4 8v11a2 2 0 0 0 2 2h2",key:"tvwodi"}],["path",{d:"M20 8v11a2 2 0 0 1-2 2h-2",key:"1gkqxj"}],["path",{d:"m9 15 3-3 3 3",key:"1pd0qc"}],["path",{d:"M12 12v9",key:"192myk"}]],ArchiveRestore=createLucideIcon("archive-restore",__iconNode$o_);const __iconNode$oZ=[["rect",{width:"20",height:"5",x:"2",y:"3",rx:"1",key:"1wp1u1"}],["path",{d:"M4 8v11a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8",key:"1s80jp"}],["path",{d:"m9.5 17 5-5",key:"nakeu6"}],["path",{d:"m9.5 12 5 5",key:"1hccrj"}]],ArchiveX=createLucideIcon("archive-x",__iconNode$oZ);const __iconNode$oY=[["rect",{width:"20",height:"5",x:"2",y:"3",rx:"1",key:"1wp1u1"}],["path",{d:"M4 8v11a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8",key:"1s80jp"}],["path",{d:"M10 12h4",key:"a56b0p"}]],Archive=createLucideIcon("archive",__iconNode$oY);const __iconNode$oX=[["path",{d:"M15 11a1 1 0 0 0 1 1h2.939a1 1 0 0 1 .75 1.811l-6.835 6.836a1.207 1.207 0 0 1-1.707 0L4.31 13.81a1 1 0 0 1 .75-1.811H8a1 1 0 0 0 1-1V9a1 1 0 0 1 1-1h4a1 1 0 0 1 1 1z",key:"1hy3w3"}],["path",{d:"M9 4h6",key:"10am2s"}]],ArrowBigDownDash=createLucideIcon("arrow-big-down-dash",__iconNode$oX);const __iconNode$oW=[["path",{d:"M19 9V6a2 2 0 0 0-2-2H7a2 2 0 0 0-2 2v3",key:"irtipd"}],["path",{d:"M3 16a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-5a2 2 0 0 0-4 0v1.5a.5.5 0 0 1-.5.5h-9a.5.5 0 0 1-.5-.5V11a2 2 0 0 0-4 0z",key:"1qyhux"}],["path",{d:"M5 18v2",key:"ppbyun"}],["path",{d:"M19 18v2",key:"gy7782"}]],Armchair=createLucideIcon("armchair",__iconNode$oW);const __iconNode$oV=[["path",{d:"M15 11a1 1 0 0 0 1 1h2.939a1 1 0 0 1 .75 1.811l-6.835 6.836a1.207 1.207 0 0 1-1.707 0L4.31 13.81a1 1 0 0 1 .75-1.811H8a1 1 0 0 0 1-1V5a1 1 0 0 1 1-1h4a1 1 0 0 1 1 1z",key:"1eaqc3"}]],ArrowBigDown=createLucideIcon("arrow-big-down",__iconNode$oV);const __iconNode$oU=[["path",{d:"M13 9a1 1 0 0 1-1-1V5.061a1 1 0 0 0-1.811-.75l-6.835 6.836a1.207 1.207 0 0 0 0 1.707l6.835 6.835a1 1 0 0 0 1.811-.75V16a1 1 0 0 1 1-1h2a1 1 0 0 0 1-1v-4a1 1 0 0 0-1-1z",key:"p8w4w5"}],["path",{d:"M20 9v6",key:"14roy0"}]],ArrowBigLeftDash=createLucideIcon("arrow-big-left-dash",__iconNode$oU);const __iconNode$oT=[["path",{d:"M13 9a1 1 0 0 1-1-1V5.061a1 1 0 0 0-1.811-.75l-6.835 6.836a1.207 1.207 0 0 0 0 1.707l6.835 6.835a1 1 0 0 0 1.811-.75V16a1 1 0 0 1 1-1h6a1 1 0 0 0 1-1v-4a1 1 0 0 0-1-1z",key:"aztept"}]],ArrowBigLeft=createLucideIcon("arrow-big-left",__iconNode$oT);const __iconNode$oS=[["path",{d:"M11 9a1 1 0 0 0 1-1V5.061a1 1 0 0 1 1.811-.75l6.836 6.836a1.207 1.207 0 0 1 0 1.707l-6.836 6.835a1 1 0 0 1-1.811-.75V16a1 1 0 0 0-1-1H9a1 1 0 0 1-1-1v-4a1 1 0 0 1 1-1z",key:"67vhrh"}],["path",{d:"M4 9v6",key:"bns7oa"}]],ArrowBigRightDash=createLucideIcon("arrow-big-right-dash",__iconNode$oS);const __iconNode$oR=[["path",{d:"M11 9a1 1 0 0 0 1-1V5.061a1 1 0 0 1 1.811-.75l6.836 6.836a1.207 1.207 0 0 1 0 1.707l-6.836 6.835a1 1 0 0 1-1.811-.75V16a1 1 0 0 0-1-1H5a1 1 0 0 1-1-1v-4a1 1 0 0 1 1-1z",key:"1232du"}]],ArrowBigRight=createLucideIcon("arrow-big-right",__iconNode$oR);const __iconNode$oQ=[["path",{d:"M9 13a1 1 0 0 0-1-1H5.061a1 1 0 0 1-.75-1.811l6.836-6.835a1.207 1.207 0 0 1 1.707 0l6.835 6.835a1 1 0 0 1-.75 1.811H16a1 1 0 0 0-1 1v2a1 1 0 0 1-1 1h-4a1 1 0 0 1-1-1z",key:"pnzqmc"}],["path",{d:"M9 20h6",key:"s66wpe"}]],ArrowBigUpDash=createLucideIcon("arrow-big-up-dash",__iconNode$oQ);const __iconNode$oP=[["path",{d:"M9 13a1 1 0 0 0-1-1H5.061a1 1 0 0 1-.75-1.811l6.836-6.835a1.207 1.207 0 0 1 1.707 0l6.835 6.835a1 1 0 0 1-.75 1.811H16a1 1 0 0 0-1 1v6a1 1 0 0 1-1 1h-4a1 1 0 0 1-1-1z",key:"lh0v7k"}]],ArrowBigUp=createLucideIcon("arrow-big-up",__iconNode$oP);const __iconNode$oO=[["path",{d:"m3 16 4 4 4-4",key:"1co6wj"}],["path",{d:"M7 20V4",key:"1yoxec"}],["rect",{x:"15",y:"4",width:"4",height:"6",ry:"2",key:"1bwicg"}],["path",{d:"M17 20v-6h-2",key:"1qp1so"}],["path",{d:"M15 20h4",key:"1j968p"}]],ArrowDown01=createLucideIcon("arrow-down-0-1",__iconNode$oO);const __iconNode$oN=[["path",{d:"m3 16 4 4 4-4",key:"1co6wj"}],["path",{d:"M7 20V4",key:"1yoxec"}],["path",{d:"M17 10V4h-2",key:"zcsr5x"}],["path",{d:"M15 10h4",key:"id2lce"}],["rect",{x:"15",y:"14",width:"4",height:"6",ry:"2",key:"33xykx"}]],ArrowDown10=createLucideIcon("arrow-down-1-0",__iconNode$oN);const __iconNode$oM=[["path",{d:"m3 16 4 4 4-4",key:"1co6wj"}],["path",{d:"M7 20V4",key:"1yoxec"}],["path",{d:"M20 8h-5",key:"1vsyxs"}],["path",{d:"M15 10V6.5a2.5 2.5 0 0 1 5 0V10",key:"ag13bf"}],["path",{d:"M15 14h5l-5 6h5",key:"ur5jdg"}]],ArrowDownAZ=createLucideIcon("arrow-down-a-z",__iconNode$oM);const __iconNode$oL=[["path",{d:"M19 3H5",key:"1236rx"}],["path",{d:"M12 21V7",key:"gj6g52"}],["path",{d:"m6 15 6 6 6-6",key:"h15q88"}]],ArrowDownFromLine=createLucideIcon("arrow-down-from-line",__iconNode$oL);const __iconNode$oK=[["path",{d:"M17 7 7 17",key:"15tmo1"}],["path",{d:"M17 17H7V7",key:"1org7z"}]],ArrowDownLeft=createLucideIcon("arrow-down-left",__iconNode$oK);const __iconNode$oJ=[["path",{d:"m3 16 4 4 4-4",key:"1co6wj"}],["path",{d:"M7 20V4",key:"1yoxec"}],["path",{d:"M11 4h4",key:"6d7r33"}],["path",{d:"M11 8h7",key:"djye34"}],["path",{d:"M11 12h10",key:"1438ji"}]],ArrowDownNarrowWide=createLucideIcon("arrow-down-narrow-wide",__iconNode$oJ);const __iconNode$oI=[["path",{d:"m7 7 10 10",key:"1fmybs"}],["path",{d:"M17 7v10H7",key:"6fjiku"}]],ArrowDownRight=createLucideIcon("arrow-down-right",__iconNode$oI);const __iconNode$oH=[["path",{d:"M12 2v14",key:"jyx4ut"}],["path",{d:"m19 9-7 7-7-7",key:"1oe3oy"}],["circle",{cx:"12",cy:"21",r:"1",key:"o0uj5v"}]],ArrowDownToDot=createLucideIcon("arrow-down-to-dot",__iconNode$oH);const __iconNode$oG=[["path",{d:"M12 17V3",key:"1cwfxf"}],["path",{d:"m6 11 6 6 6-6",key:"12ii2o"}],["path",{d:"M19 21H5",key:"150jfl"}]],ArrowDownToLine=createLucideIcon("arrow-down-to-line",__iconNode$oG);const __iconNode$oF=[["path",{d:"m3 16 4 4 4-4",key:"1co6wj"}],["path",{d:"M7 20V4",key:"1yoxec"}],["path",{d:"m21 8-4-4-4 4",key:"1c9v7m"}],["path",{d:"M17 4v16",key:"7dpous"}]],ArrowDownUp=createLucideIcon("arrow-down-up",__iconNode$oF);const __iconNode$oE=[["path",{d:"m3 16 4 4 4-4",key:"1co6wj"}],["path",{d:"M7 20V4",key:"1yoxec"}],["path",{d:"M11 4h10",key:"1w87gc"}],["path",{d:"M11 8h7",key:"djye34"}],["path",{d:"M11 12h4",key:"q8tih4"}]],ArrowDownWideNarrow=createLucideIcon("arrow-down-wide-narrow",__iconNode$oE);const __iconNode$oD=[["path",{d:"m3 16 4 4 4-4",key:"1co6wj"}],["path",{d:"M7 4v16",key:"1glfcx"}],["path",{d:"M15 4h5l-5 6h5",key:"8asdl1"}],["path",{d:"M15 20v-3.5a2.5 2.5 0 0 1 5 0V20",key:"r6l5cz"}],["path",{d:"M20 18h-5",key:"18j1r2"}]],ArrowDownZA=createLucideIcon("arrow-down-z-a",__iconNode$oD);const __iconNode$oC=[["path",{d:"M12 5v14",key:"s699le"}],["path",{d:"m19 12-7 7-7-7",key:"1idqje"}]],ArrowDown=createLucideIcon("arrow-down",__iconNode$oC);const __iconNode$oB=[["path",{d:"m9 6-6 6 6 6",key:"7v63n9"}],["path",{d:"M3 12h14",key:"13k4hi"}],["path",{d:"M21 19V5",key:"b4bplr"}]],ArrowLeftFromLine=createLucideIcon("arrow-left-from-line",__iconNode$oB);const __iconNode$oA=[["path",{d:"M8 3 4 7l4 4",key:"9rb6wj"}],["path",{d:"M4 7h16",key:"6tx8e3"}],["path",{d:"m16 21 4-4-4-4",key:"siv7j2"}],["path",{d:"M20 17H4",key:"h6l3hr"}]],ArrowLeftRight=createLucideIcon("arrow-left-right",__iconNode$oA);const __iconNode$oz=[["path",{d:"M3 19V5",key:"rwsyhb"}],["path",{d:"m13 6-6 6 6 6",key:"1yhaz7"}],["path",{d:"M7 12h14",key:"uoisry"}]],ArrowLeftToLine=createLucideIcon("arrow-left-to-line",__iconNode$oz);const __iconNode$oy=[["path",{d:"m12 19-7-7 7-7",key:"1l729n"}],["path",{d:"M19 12H5",key:"x3x0zl"}]],ArrowLeft=createLucideIcon("arrow-left",__iconNode$oy);const __iconNode$ox=[["path",{d:"M3 5v14",key:"1nt18q"}],["path",{d:"M21 12H7",key:"13ipq5"}],["path",{d:"m15 18 6-6-6-6",key:"6tx3qv"}]],ArrowRightFromLine=createLucideIcon("arrow-right-from-line",__iconNode$ox);const __iconNode$ow=[["path",{d:"m16 3 4 4-4 4",key:"1x1c3m"}],["path",{d:"M20 7H4",key:"zbl0bi"}],["path",{d:"m8 21-4-4 4-4",key:"h9nckh"}],["path",{d:"M4 17h16",key:"g4d7ey"}]],ArrowRightLeft=createLucideIcon("arrow-right-left",__iconNode$ow);const __iconNode$ov=[["path",{d:"M17 12H3",key:"8awo09"}],["path",{d:"m11 18 6-6-6-6",key:"8c2y43"}],["path",{d:"M21 5v14",key:"nzette"}]],ArrowRightToLine=createLucideIcon("arrow-right-to-line",__iconNode$ov);const __iconNode$ou=[["path",{d:"M5 12h14",key:"1ays0h"}],["path",{d:"m12 5 7 7-7 7",key:"xquz4c"}]],ArrowRight=createLucideIcon("arrow-right",__iconNode$ou);const __iconNode$ot=[["path",{d:"m3 8 4-4 4 4",key:"11wl7u"}],["path",{d:"M7 4v16",key:"1glfcx"}],["rect",{x:"15",y:"4",width:"4",height:"6",ry:"2",key:"1bwicg"}],["path",{d:"M17 20v-6h-2",key:"1qp1so"}],["path",{d:"M15 20h4",key:"1j968p"}]],ArrowUp01=createLucideIcon("arrow-up-0-1",__iconNode$ot);const __iconNode$os=[["path",{d:"m3 8 4-4 4 4",key:"11wl7u"}],["path",{d:"M7 4v16",key:"1glfcx"}],["path",{d:"M17 10V4h-2",key:"zcsr5x"}],["path",{d:"M15 10h4",key:"id2lce"}],["rect",{x:"15",y:"14",width:"4",height:"6",ry:"2",key:"33xykx"}]],ArrowUp10=createLucideIcon("arrow-up-1-0",__iconNode$os);const __iconNode$or=[["path",{d:"m3 8 4-4 4 4",key:"11wl7u"}],["path",{d:"M7 4v16",key:"1glfcx"}],["path",{d:"M20 8h-5",key:"1vsyxs"}],["path",{d:"M15 10V6.5a2.5 2.5 0 0 1 5 0V10",key:"ag13bf"}],["path",{d:"M15 14h5l-5 6h5",key:"ur5jdg"}]],ArrowUpAZ=createLucideIcon("arrow-up-a-z",__iconNode$or);const __iconNode$oq=[["path",{d:"m21 16-4 4-4-4",key:"f6ql7i"}],["path",{d:"M17 20V4",key:"1ejh1v"}],["path",{d:"m3 8 4-4 4 4",key:"11wl7u"}],["path",{d:"M7 4v16",key:"1glfcx"}]],ArrowUpDown=createLucideIcon("arrow-up-down",__iconNode$oq);const __iconNode$op=[["path",{d:"m5 9 7-7 7 7",key:"1hw5ic"}],["path",{d:"M12 16V2",key:"ywoabb"}],["circle",{cx:"12",cy:"21",r:"1",key:"o0uj5v"}]],ArrowUpFromDot=createLucideIcon("arrow-up-from-dot",__iconNode$op);const __iconNode$oo=[["path",{d:"m18 9-6-6-6 6",key:"kcunyi"}],["path",{d:"M12 3v14",key:"7cf3v8"}],["path",{d:"M5 21h14",key:"11awu3"}]],ArrowUpFromLine=createLucideIcon("arrow-up-from-line",__iconNode$oo);const __iconNode$on=[["path",{d:"M7 17V7h10",key:"11bw93"}],["path",{d:"M17 17 7 7",key:"2786uv"}]],ArrowUpLeft=createLucideIcon("arrow-up-left",__iconNode$on);const __iconNode$om=[["path",{d:"m3 8 4-4 4 4",key:"11wl7u"}],["path",{d:"M7 4v16",key:"1glfcx"}],["path",{d:"M11 12h4",key:"q8tih4"}],["path",{d:"M11 16h7",key:"uosisv"}],["path",{d:"M11 20h10",key:"jvxblo"}]],ArrowUpNarrowWide=createLucideIcon("arrow-up-narrow-wide",__iconNode$om);const __iconNode$ol=[["path",{d:"M7 7h10v10",key:"1tivn9"}],["path",{d:"M7 17 17 7",key:"1vkiza"}]],ArrowUpRight=createLucideIcon("arrow-up-right",__iconNode$ol);const __iconNode$ok=[["path",{d:"M5 3h14",key:"7usisc"}],["path",{d:"m18 13-6-6-6 6",key:"1kf1n9"}],["path",{d:"M12 7v14",key:"1akyts"}]],ArrowUpToLine=createLucideIcon("arrow-up-to-line",__iconNode$ok);const __iconNode$oj=[["path",{d:"m3 8 4-4 4 4",key:"11wl7u"}],["path",{d:"M7 4v16",key:"1glfcx"}],["path",{d:"M11 12h10",key:"1438ji"}],["path",{d:"M11 16h7",key:"uosisv"}],["path",{d:"M11 20h4",key:"1krc32"}]],ArrowUpWideNarrow=createLucideIcon("arrow-up-wide-narrow",__iconNode$oj);const __iconNode$oi=[["path",{d:"m5 12 7-7 7 7",key:"hav0vg"}],["path",{d:"M12 19V5",key:"x0mq9r"}]],ArrowUp=createLucideIcon("arrow-up",__iconNode$oi);const __iconNode$oh=[["path",{d:"m3 8 4-4 4 4",key:"11wl7u"}],["path",{d:"M7 4v16",key:"1glfcx"}],["path",{d:"M15 4h5l-5 6h5",key:"8asdl1"}],["path",{d:"M15 20v-3.5a2.5 2.5 0 0 1 5 0V20",key:"r6l5cz"}],["path",{d:"M20 18h-5",key:"18j1r2"}]],ArrowUpZA=createLucideIcon("arrow-up-z-a",__iconNode$oh);const __iconNode$og=[["path",{d:"m4 6 3-3 3 3",key:"9aidw8"}],["path",{d:"M7 17V3",key:"19qxw1"}],["path",{d:"m14 6 3-3 3 3",key:"6iy689"}],["path",{d:"M17 17V3",key:"o0fmgi"}],["path",{d:"M4 21h16",key:"1h09gz"}]],ArrowsUpFromLine=createLucideIcon("arrows-up-from-line",__iconNode$og);const __iconNode$of=[["path",{d:"M12 6v12",key:"1vza4d"}],["path",{d:"M17.196 9 6.804 15",key:"1ah31z"}],["path",{d:"m6.804 9 10.392 6",key:"1b6pxd"}]],Asterisk=createLucideIcon("asterisk",__iconNode$of);const __iconNode$oe=[["circle",{cx:"12",cy:"12",r:"4",key:"4exip2"}],["path",{d:"M16 8v5a3 3 0 0 0 6 0v-1a10 10 0 1 0-4 8",key:"7n84p3"}]],AtSign=createLucideIcon("at-sign",__iconNode$oe);const __iconNode$od=[["circle",{cx:"12",cy:"12",r:"1",key:"41hilf"}],["path",{d:"M20.2 20.2c2.04-2.03.02-7.36-4.5-11.9-4.54-4.52-9.87-6.54-11.9-4.5-2.04 2.03-.02 7.36 4.5 11.9 4.54 4.52 9.87 6.54 11.9 4.5Z",key:"1l2ple"}],["path",{d:"M15.7 15.7c4.52-4.54 6.54-9.87 4.5-11.9-2.03-2.04-7.36-.02-11.9 4.5-4.52 4.54-6.54 9.87-4.5 11.9 2.03 2.04 7.36.02 11.9-4.5Z",key:"1wam0m"}]],Atom=createLucideIcon("atom",__iconNode$od);const __iconNode$oc=[["path",{d:"M2 10v3",key:"1fnikh"}],["path",{d:"M6 6v11",key:"11sgs0"}],["path",{d:"M10 3v18",key:"yhl04a"}],["path",{d:"M14 8v7",key:"3a1oy3"}],["path",{d:"M18 5v13",key:"123xd1"}],["path",{d:"M22 10v3",key:"154ddg"}]],AudioLines=createLucideIcon("audio-lines",__iconNode$oc);const __iconNode$ob=[["path",{d:"M2 13a2 2 0 0 0 2-2V7a2 2 0 0 1 4 0v13a2 2 0 0 0 4 0V4a2 2 0 0 1 4 0v13a2 2 0 0 0 4 0v-4a2 2 0 0 1 2-2",key:"57tc96"}]],AudioWaveform=createLucideIcon("audio-waveform",__iconNode$ob);const __iconNode$oa=[["path",{d:"m15.477 12.89 1.515 8.526a.5.5 0 0 1-.81.47l-3.58-2.687a1 1 0 0 0-1.197 0l-3.586 2.686a.5.5 0 0 1-.81-.469l1.514-8.526",key:"1yiouv"}],["circle",{cx:"12",cy:"8",r:"6",key:"1vp47v"}]],Award=createLucideIcon("award",__iconNode$oa);const __iconNode$o9=[["path",{d:"m14 12-8.381 8.38a1 1 0 0 1-3.001-3L11 9",key:"5z9253"}],["path",{d:"M15 15.5a.5.5 0 0 0 .5.5A6.5 6.5 0 0 0 22 9.5a.5.5 0 0 0-.5-.5h-1.672a2 2 0 0 1-1.414-.586l-5.062-5.062a1.205 1.205 0 0 0-1.704 0L9.352 5.648a1.205 1.205 0 0 0 0 1.704l5.062 5.062A2 2 0 0 1 15 13.828z",key:"19zklq"}]],Axe=createLucideIcon("axe",__iconNode$o9);const __iconNode$o8=[["path",{d:"M13.5 10.5 15 9",key:"1nsxvm"}],["path",{d:"M4 4v15a1 1 0 0 0 1 1h15",key:"1w6lkd"}],["path",{d:"M4.293 19.707 6 18",key:"3g1p8c"}],["path",{d:"m9 15 1.5-1.5",key:"1xfbes"}]],Axis3d=createLucideIcon("axis-3d",__iconNode$o8);const __iconNode$o7=[["path",{d:"M10 16c.5.3 1.2.5 2 .5s1.5-.2 2-.5",key:"1u7htd"}],["path",{d:"M15 12h.01",key:"1k8ypt"}],["path",{d:"M19.38 6.813A9 9 0 0 1 20.8 10.2a2 2 0 0 1 0 3.6 9 9 0 0 1-17.6 0 2 2 0 0 1 0-3.6A9 9 0 0 1 12 3c2 0 3.5 1.1 3.5 2.5s-.9 2.5-2 2.5c-.8 0-1.5-.4-1.5-1",key:"11xh7x"}],["path",{d:"M9 12h.01",key:"157uk2"}]],Baby=createLucideIcon("baby",__iconNode$o7);const __iconNode$o6=[["path",{d:"M4 10a4 4 0 0 1 4-4h8a4 4 0 0 1 4 4v10a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2z",key:"1ol0lm"}],["path",{d:"M8 10h8",key:"c7uz4u"}],["path",{d:"M8 18h8",key:"1no2b1"}],["path",{d:"M8 22v-6a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v6",key:"1fr6do"}],["path",{d:"M9 6V4a2 2 0 0 1 2-2h2a2 2 0 0 1 2 2v2",key:"donm21"}]],Backpack=createLucideIcon("backpack",__iconNode$o6);const __iconNode$o5=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}],["line",{x1:"12",x2:"12",y1:"8",y2:"12",key:"1pkeuh"}],["line",{x1:"12",x2:"12.01",y1:"16",y2:"16",key:"4dfq90"}]],BadgeAlert=createLucideIcon("badge-alert",__iconNode$o5);const __iconNode$o4=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}],["path",{d:"M12 7v10",key:"jspqdw"}],["path",{d:"M15.4 10a4 4 0 1 0 0 4",key:"2eqtx8"}]],BadgeCent=createLucideIcon("badge-cent",__iconNode$o4);const __iconNode$o3=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],BadgeCheck=createLucideIcon("badge-check",__iconNode$o3);const __iconNode$o2=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}],["path",{d:"M16 8h-6a2 2 0 1 0 0 4h4a2 2 0 1 1 0 4H8",key:"1h4pet"}],["path",{d:"M12 18V6",key:"zqpxq5"}]],BadgeDollarSign=createLucideIcon("badge-dollar-sign",__iconNode$o2);const __iconNode$o1=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}],["path",{d:"M7 12h5",key:"gblrwe"}],["path",{d:"M15 9.4a4 4 0 1 0 0 5.2",key:"1makmb"}]],BadgeEuro=createLucideIcon("badge-euro",__iconNode$o1);const __iconNode$o0=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}],["path",{d:"M8 8h8",key:"1bis0t"}],["path",{d:"M8 12h8",key:"1wcyev"}],["path",{d:"m13 17-5-1h1a4 4 0 0 0 0-8",key:"nu2bwa"}]],BadgeIndianRupee=createLucideIcon("badge-indian-rupee",__iconNode$o0);const __iconNode$n$=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}],["line",{x1:"12",x2:"12",y1:"16",y2:"12",key:"1y1yb1"}],["line",{x1:"12",x2:"12.01",y1:"8",y2:"8",key:"110wyk"}]],BadgeInfo=createLucideIcon("badge-info",__iconNode$n$);const __iconNode$n_=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}],["path",{d:"m9 8 3 3v7",key:"17yadx"}],["path",{d:"m12 11 3-3",key:"p4cfq1"}],["path",{d:"M9 12h6",key:"1c52cq"}],["path",{d:"M9 16h6",key:"8wimt3"}]],BadgeJapaneseYen=createLucideIcon("badge-japanese-yen",__iconNode$n_);const __iconNode$nZ=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}],["line",{x1:"8",x2:"16",y1:"12",y2:"12",key:"1jonct"}]],BadgeMinus=createLucideIcon("badge-minus",__iconNode$nZ);const __iconNode$nY=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}],["path",{d:"m15 9-6 6",key:"1uzhvr"}],["path",{d:"M9 9h.01",key:"1q5me6"}],["path",{d:"M15 15h.01",key:"lqbp3k"}]],BadgePercent=createLucideIcon("badge-percent",__iconNode$nY);const __iconNode$nX=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}],["line",{x1:"12",x2:"12",y1:"8",y2:"16",key:"10p56q"}],["line",{x1:"8",x2:"16",y1:"12",y2:"12",key:"1jonct"}]],BadgePlus=createLucideIcon("badge-plus",__iconNode$nX);const __iconNode$nW=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}],["path",{d:"M8 12h4",key:"qz6y1c"}],["path",{d:"M10 16V9.5a2.5 2.5 0 0 1 5 0",key:"3mlbjk"}],["path",{d:"M8 16h7",key:"sbedsn"}]],BadgePoundSterling=createLucideIcon("badge-pound-sterling",__iconNode$nW);const __iconNode$nV=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}],["path",{d:"M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3",key:"1u773s"}],["line",{x1:"12",x2:"12.01",y1:"17",y2:"17",key:"io3f8k"}]],BadgeQuestionMark=createLucideIcon("badge-question-mark",__iconNode$nV);const __iconNode$nU=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}],["path",{d:"M9 16h5",key:"1syiyw"}],["path",{d:"M9 12h5a2 2 0 1 0 0-4h-3v9",key:"1ge9c1"}]],BadgeRussianRuble=createLucideIcon("badge-russian-ruble",__iconNode$nU);const __iconNode$nT=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}],["path",{d:"M11 17V8h4",key:"1bfq6y"}],["path",{d:"M11 12h3",key:"2eqnfz"}],["path",{d:"M9 16h4",key:"1skf3a"}]],BadgeSwissFranc=createLucideIcon("badge-swiss-franc",__iconNode$nT);const __iconNode$nS=[["path",{d:"M11 7v10a5 5 0 0 0 5-5",key:"1ja3ih"}],["path",{d:"m15 8-6 3",key:"4x0uwz"}],["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76",key:"18242g"}]],BadgeTurkishLira=createLucideIcon("badge-turkish-lira",__iconNode$nS);const __iconNode$nR=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}],["line",{x1:"15",x2:"9",y1:"9",y2:"15",key:"f7djnv"}],["line",{x1:"9",x2:"15",y1:"9",y2:"15",key:"1shsy8"}]],BadgeX=createLucideIcon("badge-x",__iconNode$nR);const __iconNode$nQ=[["path",{d:"M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.77 4.78 4 4 0 0 1-6.75 0 4 4 0 0 1-4.78-4.77 4 4 0 0 1 0-6.76Z",key:"3c2336"}]],Badge=createLucideIcon("badge",__iconNode$nQ);const __iconNode$nP=[["path",{d:"M22 18H6a2 2 0 0 1-2-2V7a2 2 0 0 0-2-2",key:"4irg2o"}],["path",{d:"M17 14V4a2 2 0 0 0-2-2h-1a2 2 0 0 0-2 2v10",key:"14fcyx"}],["rect",{width:"13",height:"8",x:"8",y:"6",rx:"1",key:"o6oiis"}],["circle",{cx:"18",cy:"20",r:"2",key:"t9985n"}],["circle",{cx:"9",cy:"20",r:"2",key:"e5v82j"}]],BaggageClaim=createLucideIcon("baggage-claim",__iconNode$nP);const __iconNode$nO=[["path",{d:"M4.929 4.929 19.07 19.071",key:"196cmz"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Ban=createLucideIcon("ban",__iconNode$nO);const __iconNode$nN=[["path",{d:"M4 13c3.5-2 8-2 10 2a5.5 5.5 0 0 1 8 5",key:"1cscit"}],["path",{d:"M5.15 17.89c5.52-1.52 8.65-6.89 7-12C11.55 4 11.5 2 13 2c3.22 0 5 5.5 5 8 0 6.5-4.2 12-10.49 12C5.11 22 2 22 2 20c0-1.5 1.14-1.55 3.15-2.11Z",key:"1y1nbv"}]],Banana=createLucideIcon("banana",__iconNode$nN);const __iconNode$nM=[["path",{d:"M12 18H4a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v5",key:"x6cv4u"}],["path",{d:"m16 19 3 3 3-3",key:"1ibux0"}],["path",{d:"M18 12h.01",key:"yjnet6"}],["path",{d:"M19 16v6",key:"tddt3s"}],["path",{d:"M6 12h.01",key:"c2rlol"}],["circle",{cx:"12",cy:"12",r:"2",key:"1c9p78"}]],BanknoteArrowDown=createLucideIcon("banknote-arrow-down",__iconNode$nM);const __iconNode$nL=[["path",{d:"M10 10.01h.01",key:"1e9xi7"}],["path",{d:"M10 14.01h.01",key:"ac23bv"}],["path",{d:"M14 10.01h.01",key:"2wfrvf"}],["path",{d:"M14 14.01h.01",key:"8tw8yn"}],["path",{d:"M18 6v11.5",key:"dkbidh"}],["path",{d:"M6 6v12",key:"vkc79e"}],["rect",{x:"2",y:"6",width:"20",height:"12",rx:"2",key:"1wpnh2"}]],Bandage=createLucideIcon("bandage",__iconNode$nL);const __iconNode$nK=[["path",{d:"M12 18H4a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v5",key:"x6cv4u"}],["path",{d:"M18 12h.01",key:"yjnet6"}],["path",{d:"M19 22v-6",key:"qhmiwi"}],["path",{d:"m22 19-3-3-3 3",key:"rn6bg2"}],["path",{d:"M6 12h.01",key:"c2rlol"}],["circle",{cx:"12",cy:"12",r:"2",key:"1c9p78"}]],BanknoteArrowUp=createLucideIcon("banknote-arrow-up",__iconNode$nK);const __iconNode$nJ=[["path",{d:"M13 18H4a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v5",key:"16nib6"}],["path",{d:"m17 17 5 5",key:"p7ous7"}],["path",{d:"M18 12h.01",key:"yjnet6"}],["path",{d:"m22 17-5 5",key:"gqnmv0"}],["path",{d:"M6 12h.01",key:"c2rlol"}],["circle",{cx:"12",cy:"12",r:"2",key:"1c9p78"}]],BanknoteX=createLucideIcon("banknote-x",__iconNode$nJ);const __iconNode$nI=[["rect",{width:"20",height:"12",x:"2",y:"6",rx:"2",key:"9lu3g6"}],["circle",{cx:"12",cy:"12",r:"2",key:"1c9p78"}],["path",{d:"M6 12h.01M18 12h.01",key:"113zkx"}]],Banknote=createLucideIcon("banknote",__iconNode$nI);const __iconNode$nH=[["path",{d:"M3 5v14",key:"1nt18q"}],["path",{d:"M8 5v14",key:"1ybrkv"}],["path",{d:"M12 5v14",key:"s699le"}],["path",{d:"M17 5v14",key:"ycjyhj"}],["path",{d:"M21 5v14",key:"nzette"}]],Barcode=createLucideIcon("barcode",__iconNode$nH);const __iconNode$nG=[["path",{d:"M10 3a41 41 0 0 0 0 18",key:"1qcnzb"}],["path",{d:"M14 3a41 41 0 0 1 0 18",key:"547vd4"}],["path",{d:"M17 3a2 2 0 0 1 1.68.92 15.25 15.25 0 0 1 0 16.16A2 2 0 0 1 17 21H7a2 2 0 0 1-1.68-.92 15.25 15.25 0 0 1 0-16.16A2 2 0 0 1 7 3z",key:"1wepyy"}],["path",{d:"M3.84 17h16.32",key:"1wh981"}],["path",{d:"M3.84 7h16.32",key:"19jf4x"}]],Barrel=createLucideIcon("barrel",__iconNode$nG);const __iconNode$nF=[["path",{d:"M4 20h16",key:"14thso"}],["path",{d:"m6 16 6-12 6 12",key:"1b4byz"}],["path",{d:"M8 12h8",key:"1wcyev"}]],Baseline=createLucideIcon("baseline",__iconNode$nF);const __iconNode$nE=[["path",{d:"M10 4 8 6",key:"1rru8s"}],["path",{d:"M17 19v2",key:"ts1sot"}],["path",{d:"M2 12h20",key:"9i4pu4"}],["path",{d:"M7 19v2",key:"12npes"}],["path",{d:"M9 5 7.621 3.621A2.121 2.121 0 0 0 4 5v12a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-5",key:"14ym8i"}]],Bath=createLucideIcon("bath",__iconNode$nE);const __iconNode$nD=[["path",{d:"m11 7-3 5h4l-3 5",key:"b4a64w"}],["path",{d:"M14.856 6H16a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2h-2.935",key:"lre1cr"}],["path",{d:"M22 14v-4",key:"14q9d5"}],["path",{d:"M5.14 18H4a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h2.936",key:"13q5k0"}]],BatteryCharging=createLucideIcon("battery-charging",__iconNode$nD);const __iconNode$nC=[["path",{d:"M10 10v4",key:"1mb2ec"}],["path",{d:"M14 10v4",key:"1nt88p"}],["path",{d:"M22 14v-4",key:"14q9d5"}],["path",{d:"M6 10v4",key:"1n77qd"}],["rect",{x:"2",y:"6",width:"16",height:"12",rx:"2",key:"13zb55"}]],BatteryFull=createLucideIcon("battery-full",__iconNode$nC);const __iconNode$nB=[["path",{d:"M22 14v-4",key:"14q9d5"}],["path",{d:"M6 14v-4",key:"14a6bd"}],["rect",{x:"2",y:"6",width:"16",height:"12",rx:"2",key:"13zb55"}]],BatteryLow=createLucideIcon("battery-low",__iconNode$nB);const __iconNode$nA=[["path",{d:"M10 14v-4",key:"suye4c"}],["path",{d:"M22 14v-4",key:"14q9d5"}],["path",{d:"M6 14v-4",key:"14a6bd"}],["rect",{x:"2",y:"6",width:"16",height:"12",rx:"2",key:"13zb55"}]],BatteryMedium=createLucideIcon("battery-medium",__iconNode$nA);const __iconNode$nz=[["path",{d:"M10 9v6",key:"17i7lo"}],["path",{d:"M12.543 6H16a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2h-3.605",key:"o09yah"}],["path",{d:"M22 14v-4",key:"14q9d5"}],["path",{d:"M7 12h6",key:"iekk3h"}],["path",{d:"M7.606 18H4a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h3.606",key:"xyqvf1"}]],BatteryPlus=createLucideIcon("battery-plus",__iconNode$nz);const __iconNode$ny=[["path",{d:"M10 17h.01",key:"nbq80n"}],["path",{d:"M10 7v6",key:"nne03l"}],["path",{d:"M14 6h2a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2h-2",key:"1m83kb"}],["path",{d:"M22 14v-4",key:"14q9d5"}],["path",{d:"M6 18H4a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h2",key:"h8lgfh"}]],BatteryWarning=createLucideIcon("battery-warning",__iconNode$ny);const __iconNode$nx=[["path",{d:"M 22 14 L 22 10",key:"nqc4tb"}],["rect",{x:"2",y:"6",width:"16",height:"12",rx:"2",key:"13zb55"}]],Battery=createLucideIcon("battery",__iconNode$nx);const __iconNode$nw=[["path",{d:"M4.5 3h15",key:"c7n0jr"}],["path",{d:"M6 3v16a2 2 0 0 0 2 2h8a2 2 0 0 0 2-2V3",key:"m1uhx7"}],["path",{d:"M6 14h12",key:"4cwo0f"}]],Beaker=createLucideIcon("beaker",__iconNode$nw);const __iconNode$nv=[["path",{d:"M9 9c-.64.64-1.521.954-2.402 1.165A6 6 0 0 0 8 22a13.96 13.96 0 0 0 9.9-4.1",key:"bq3udt"}],["path",{d:"M10.75 5.093A6 6 0 0 1 22 8c0 2.411-.61 4.68-1.683 6.66",key:"17ccse"}],["path",{d:"M5.341 10.62a4 4 0 0 0 6.487 1.208M10.62 5.341a4.015 4.015 0 0 1 2.039 2.04",key:"18zqgq"}],["line",{x1:"2",x2:"22",y1:"2",y2:"22",key:"a6p6uj"}]],BeanOff=createLucideIcon("bean-off",__iconNode$nv);const __iconNode$nu=[["path",{d:"M10.165 6.598C9.954 7.478 9.64 8.36 9 9c-.64.64-1.521.954-2.402 1.165A6 6 0 0 0 8 22c7.732 0 14-6.268 14-14a6 6 0 0 0-11.835-1.402Z",key:"1tvzk7"}],["path",{d:"M5.341 10.62a4 4 0 1 0 5.279-5.28",key:"2cyri2"}]],Bean=createLucideIcon("bean",__iconNode$nu);const __iconNode$nt=[["path",{d:"M2 20v-8a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v8",key:"1k78r4"}],["path",{d:"M4 10V6a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v4",key:"fb3tl2"}],["path",{d:"M12 4v6",key:"1dcgq2"}],["path",{d:"M2 18h20",key:"ajqnye"}]],BedDouble=createLucideIcon("bed-double",__iconNode$nt);const __iconNode$ns=[["path",{d:"M3 20v-8a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v8",key:"1wm6mi"}],["path",{d:"M5 10V6a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2v4",key:"4k93s5"}],["path",{d:"M3 18h18",key:"1h113x"}]],BedSingle=createLucideIcon("bed-single",__iconNode$ns);const __iconNode$nr=[["path",{d:"M2 4v16",key:"vw9hq8"}],["path",{d:"M2 8h18a2 2 0 0 1 2 2v10",key:"1dgv2r"}],["path",{d:"M2 17h20",key:"18nfp3"}],["path",{d:"M6 8v9",key:"1yriud"}]],Bed=createLucideIcon("bed",__iconNode$nr);const __iconNode$nq=[["path",{d:"M16.4 13.7A6.5 6.5 0 1 0 6.28 6.6c-1.1 3.13-.78 3.9-3.18 6.08A3 3 0 0 0 5 18c4 0 8.4-1.8 11.4-4.3",key:"cisjcv"}],["path",{d:"m18.5 6 2.19 4.5a6.48 6.48 0 0 1-2.29 7.2C15.4 20.2 11 22 7 22a3 3 0 0 1-2.68-1.66L2.4 16.5",key:"5byaag"}],["circle",{cx:"12.5",cy:"8.5",r:"2.5",key:"9738u8"}]],Beef=createLucideIcon("beef",__iconNode$nq);const __iconNode$np=[["path",{d:"M13 13v5",key:"igwfh0"}],["path",{d:"M17 11.47V8",key:"16yw0g"}],["path",{d:"M17 11h1a3 3 0 0 1 2.745 4.211",key:"1xbt65"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M5 8v12a2 2 0 0 0 2 2h8a2 2 0 0 0 2-2v-3",key:"c55o3e"}],["path",{d:"M7.536 7.535C6.766 7.649 6.154 8 5.5 8a2.5 2.5 0 0 1-1.768-4.268",key:"1ydug7"}],["path",{d:"M8.727 3.204C9.306 2.767 9.885 2 11 2c1.56 0 2 1.5 3 1.5s1.72-.5 2.5-.5a1 1 0 1 1 0 5c-.78 0-1.5-.5-2.5-.5a3.149 3.149 0 0 0-.842.12",key:"q81o7q"}],["path",{d:"M9 14.6V18",key:"20ek98"}]],BeerOff=createLucideIcon("beer-off",__iconNode$np);const __iconNode$no=[["path",{d:"M17 11h1a3 3 0 0 1 0 6h-1",key:"1yp76v"}],["path",{d:"M9 12v6",key:"1u1cab"}],["path",{d:"M13 12v6",key:"1sugkk"}],["path",{d:"M14 7.5c-1 0-1.44.5-3 .5s-2-.5-3-.5-1.72.5-2.5.5a2.5 2.5 0 0 1 0-5c.78 0 1.57.5 2.5.5S9.44 2 11 2s2 1.5 3 1.5 1.72-.5 2.5-.5a2.5 2.5 0 0 1 0 5c-.78 0-1.5-.5-2.5-.5Z",key:"1510fo"}],["path",{d:"M5 8v12a2 2 0 0 0 2 2h8a2 2 0 0 0 2-2V8",key:"19jb7n"}]],Beer=createLucideIcon("beer",__iconNode$no);const __iconNode$nn=[["path",{d:"M10.268 21a2 2 0 0 0 3.464 0",key:"vwvbt9"}],["path",{d:"M13.916 2.314A6 6 0 0 0 6 8c0 4.499-1.411 5.956-2.74 7.327A1 1 0 0 0 4 17h16a1 1 0 0 0 .74-1.673 9 9 0 0 1-.585-.665",key:"1tip0g"}],["circle",{cx:"18",cy:"8",r:"3",key:"1g0gzu"}]],BellDot=createLucideIcon("bell-dot",__iconNode$nn);const __iconNode$nm=[["path",{d:"M18.518 17.347A7 7 0 0 1 14 19",key:"1emhpo"}],["path",{d:"M18.8 4A11 11 0 0 1 20 9",key:"127b67"}],["path",{d:"M9 9h.01",key:"1q5me6"}],["circle",{cx:"20",cy:"16",r:"2",key:"1v9bxh"}],["circle",{cx:"9",cy:"9",r:"7",key:"p2h5vp"}],["rect",{x:"4",y:"16",width:"10",height:"6",rx:"2",key:"bfnviv"}]],BellElectric=createLucideIcon("bell-electric",__iconNode$nm);const __iconNode$nl=[["path",{d:"M10.268 21a2 2 0 0 0 3.464 0",key:"vwvbt9"}],["path",{d:"M17 17H4a1 1 0 0 1-.74-1.673C4.59 13.956 6 12.499 6 8a6 6 0 0 1 .258-1.742",key:"178tsu"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M8.668 3.01A6 6 0 0 1 18 8c0 2.687.77 4.653 1.707 6.05",key:"1hqiys"}]],BellOff=createLucideIcon("bell-off",__iconNode$nl);const __iconNode$nk=[["path",{d:"M10.268 21a2 2 0 0 0 3.464 0",key:"vwvbt9"}],["path",{d:"M15 8h6",key:"8ybuxh"}],["path",{d:"M16.243 3.757A6 6 0 0 0 6 8c0 4.499-1.411 5.956-2.738 7.326A1 1 0 0 0 4 17h16a1 1 0 0 0 .74-1.673A9.4 9.4 0 0 1 18.667 12",key:"bdwj86"}]],BellMinus=createLucideIcon("bell-minus",__iconNode$nk);const __iconNode$nj=[["path",{d:"M10.268 21a2 2 0 0 0 3.464 0",key:"vwvbt9"}],["path",{d:"M15 8h6",key:"8ybuxh"}],["path",{d:"M18 5v6",key:"g5ayrv"}],["path",{d:"M20.002 14.464a9 9 0 0 0 .738.863A1 1 0 0 1 20 17H4a1 1 0 0 1-.74-1.673C4.59 13.956 6 12.499 6 8a6 6 0 0 1 8.75-5.332",key:"1abcvy"}]],BellPlus=createLucideIcon("bell-plus",__iconNode$nj);const __iconNode$ni=[["path",{d:"M10.268 21a2 2 0 0 0 3.464 0",key:"vwvbt9"}],["path",{d:"M22 8c0-2.3-.8-4.3-2-6",key:"5bb3ad"}],["path",{d:"M3.262 15.326A1 1 0 0 0 4 17h16a1 1 0 0 0 .74-1.673C19.41 13.956 18 12.499 18 8A6 6 0 0 0 6 8c0 4.499-1.411 5.956-2.738 7.326",key:"11g9vi"}],["path",{d:"M4 2C2.8 3.7 2 5.7 2 8",key:"tap9e0"}]],BellRing=createLucideIcon("bell-ring",__iconNode$ni);const __iconNode$nh=[["path",{d:"M10.268 21a2 2 0 0 0 3.464 0",key:"vwvbt9"}],["path",{d:"M3.262 15.326A1 1 0 0 0 4 17h16a1 1 0 0 0 .74-1.673C19.41 13.956 18 12.499 18 8A6 6 0 0 0 6 8c0 4.499-1.411 5.956-2.738 7.326",key:"11g9vi"}]],Bell=createLucideIcon("bell",__iconNode$nh);const __iconNode$ng=[["rect",{width:"13",height:"7",x:"3",y:"3",rx:"1",key:"11xb64"}],["path",{d:"m22 15-3-3 3-3",key:"26chmm"}],["rect",{width:"13",height:"7",x:"3",y:"14",rx:"1",key:"k6ky7n"}]],BetweenHorizontalEnd=createLucideIcon("between-horizontal-end",__iconNode$ng);const __iconNode$nf=[["rect",{width:"13",height:"7",x:"8",y:"3",rx:"1",key:"pkso9a"}],["path",{d:"m2 9 3 3-3 3",key:"1agib5"}],["rect",{width:"13",height:"7",x:"8",y:"14",rx:"1",key:"1q5fc1"}]],BetweenHorizontalStart=createLucideIcon("between-horizontal-start",__iconNode$nf);const __iconNode$ne=[["rect",{width:"7",height:"13",x:"3",y:"3",rx:"1",key:"1fdu0f"}],["path",{d:"m9 22 3-3 3 3",key:"17z65a"}],["rect",{width:"7",height:"13",x:"14",y:"3",rx:"1",key:"1squn4"}]],BetweenVerticalEnd=createLucideIcon("between-vertical-end",__iconNode$ne);const __iconNode$nd=[["rect",{width:"7",height:"13",x:"3",y:"8",rx:"1",key:"1fjrkv"}],["path",{d:"m15 2-3 3-3-3",key:"1uh6eb"}],["rect",{width:"7",height:"13",x:"14",y:"8",rx:"1",key:"w3fjg8"}]],BetweenVerticalStart=createLucideIcon("between-vertical-start",__iconNode$nd);const __iconNode$nc=[["path",{d:"M12.409 13.017A5 5 0 0 1 22 15c0 3.866-4 7-9 7-4.077 0-8.153-.82-10.371-2.462-.426-.316-.631-.832-.62-1.362C2.118 12.723 2.627 2 10 2a3 3 0 0 1 3 3 2 2 0 0 1-2 2c-1.105 0-1.64-.444-2-1",key:"1pmlyh"}],["path",{d:"M15 14a5 5 0 0 0-7.584 2",key:"5rb254"}],["path",{d:"M9.964 6.825C8.019 7.977 9.5 13 8 15",key:"kbvsx9"}]],BicepsFlexed=createLucideIcon("biceps-flexed",__iconNode$nc);const __iconNode$nb=[["circle",{cx:"18.5",cy:"17.5",r:"3.5",key:"15x4ox"}],["circle",{cx:"5.5",cy:"17.5",r:"3.5",key:"1noe27"}],["circle",{cx:"15",cy:"5",r:"1",key:"19l28e"}],["path",{d:"M12 17.5V14l-3-3 4-3 2 3h2",key:"1npguv"}]],Bike=createLucideIcon("bike",__iconNode$nb);const __iconNode$na=[["rect",{x:"14",y:"14",width:"4",height:"6",rx:"2",key:"p02svl"}],["rect",{x:"6",y:"4",width:"4",height:"6",rx:"2",key:"xm4xkj"}],["path",{d:"M6 20h4",key:"1i6q5t"}],["path",{d:"M14 10h4",key:"ru81e7"}],["path",{d:"M6 14h2v6",key:"16z9wg"}],["path",{d:"M14 4h2v6",key:"1idq9u"}]],Binary=createLucideIcon("binary",__iconNode$na);const __iconNode$n9=[["path",{d:"M10 10h4",key:"tcdvrf"}],["path",{d:"M19 7V4a1 1 0 0 0-1-1h-2a1 1 0 0 0-1 1v3",key:"3apit1"}],["path",{d:"M20 21a2 2 0 0 0 2-2v-3.851c0-1.39-2-2.962-2-4.829V8a1 1 0 0 0-1-1h-4a1 1 0 0 0-1 1v11a2 2 0 0 0 2 2z",key:"rhpgnw"}],["path",{d:"M 22 16 L 2 16",key:"14lkq7"}],["path",{d:"M4 21a2 2 0 0 1-2-2v-3.851c0-1.39 2-2.962 2-4.829V8a1 1 0 0 1 1-1h4a1 1 0 0 1 1 1v11a2 2 0 0 1-2 2z",key:"104b3k"}],["path",{d:"M9 7V4a1 1 0 0 0-1-1H6a1 1 0 0 0-1 1v3",key:"14fczp"}]],Binoculars=createLucideIcon("binoculars",__iconNode$n9);const __iconNode$n8=[["circle",{cx:"12",cy:"11.9",r:"2",key:"e8h31w"}],["path",{d:"M6.7 3.4c-.9 2.5 0 5.2 2.2 6.7C6.5 9 3.7 9.6 2 11.6",key:"17bolr"}],["path",{d:"m8.9 10.1 1.4.8",key:"15ezny"}],["path",{d:"M17.3 3.4c.9 2.5 0 5.2-2.2 6.7 2.4-1.2 5.2-.6 6.9 1.5",key:"wtwa5u"}],["path",{d:"m15.1 10.1-1.4.8",key:"1r0b28"}],["path",{d:"M16.7 20.8c-2.6-.4-4.6-2.6-4.7-5.3-.2 2.6-2.1 4.8-4.7 5.2",key:"m7qszh"}],["path",{d:"M12 13.9v1.6",key:"zfyyim"}],["path",{d:"M13.5 5.4c-1-.2-2-.2-3 0",key:"1bi9q0"}],["path",{d:"M17 16.4c.7-.7 1.2-1.6 1.5-2.5",key:"1rhjqw"}],["path",{d:"M5.5 13.9c.3.9.8 1.8 1.5 2.5",key:"8gsud3"}]],Biohazard=createLucideIcon("biohazard",__iconNode$n8);const __iconNode$n7=[["path",{d:"M16 7h.01",key:"1kdx03"}],["path",{d:"M3.4 18H12a8 8 0 0 0 8-8V7a4 4 0 0 0-7.28-2.3L2 20",key:"oj1oa8"}],["path",{d:"m20 7 2 .5-2 .5",key:"12nv4d"}],["path",{d:"M10 18v3",key:"1yea0a"}],["path",{d:"M14 17.75V21",key:"1pymcb"}],["path",{d:"M7 18a6 6 0 0 0 3.84-10.61",key:"1npnn0"}]],Bird=createLucideIcon("bird",__iconNode$n7);const __iconNode$n6=[["path",{d:"M12 18v4",key:"jadmvz"}],["path",{d:"m17 18 1.956-11.468",key:"l5n2ro"}],["path",{d:"m3 8 7.82-5.615a2 2 0 0 1 2.36 0L21 8",key:"1sy6n7"}],["path",{d:"M4 18h16",key:"19g7jn"}],["path",{d:"M7 18 5.044 6.532",key:"1uqdf2"}],["circle",{cx:"12",cy:"10",r:"2",key:"1yojzk"}]],Birdhouse=createLucideIcon("birdhouse",__iconNode$n6);const __iconNode$n5=[["path",{d:"M11.767 19.089c4.924.868 6.14-6.025 1.216-6.894m-1.216 6.894L5.86 18.047m5.908 1.042-.347 1.97m1.563-8.864c4.924.869 6.14-6.025 1.215-6.893m-1.215 6.893-3.94-.694m5.155-6.2L8.29 4.26m5.908 1.042.348-1.97M7.48 20.364l3.126-17.727",key:"yr8idg"}]],Bitcoin=createLucideIcon("bitcoin",__iconNode$n5);const __iconNode$n4=[["circle",{cx:"9",cy:"9",r:"7",key:"p2h5vp"}],["circle",{cx:"15",cy:"15",r:"7",key:"19ennj"}]],Blend=createLucideIcon("blend",__iconNode$n4);const __iconNode$n3=[["path",{d:"M3 3h18",key:"o7r712"}],["path",{d:"M20 7H8",key:"gd2fo2"}],["path",{d:"M20 11H8",key:"1ynp89"}],["path",{d:"M10 19h10",key:"19hjk5"}],["path",{d:"M8 15h12",key:"1yqzne"}],["path",{d:"M4 3v14",key:"fggqzn"}],["circle",{cx:"4",cy:"19",r:"2",key:"p3m9r0"}]],Blinds=createLucideIcon("blinds",__iconNode$n3);const __iconNode$n2=[["path",{d:"M10 22V7a1 1 0 0 0-1-1H4a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-5a1 1 0 0 0-1-1H2",key:"1ah6g2"}],["rect",{x:"14",y:"2",width:"8",height:"8",rx:"1",key:"88lufb"}]],Blocks=createLucideIcon("blocks",__iconNode$n2);const __iconNode$n1=[["path",{d:"m7 7 10 10-5 5V2l5 5L7 17",key:"1q5490"}],["line",{x1:"18",x2:"21",y1:"12",y2:"12",key:"1rsjjs"}],["line",{x1:"3",x2:"6",y1:"12",y2:"12",key:"11yl8c"}]],BluetoothConnected=createLucideIcon("bluetooth-connected",__iconNode$n1);const __iconNode$n0=[["path",{d:"m17 17-5 5V12l-5 5",key:"v5aci6"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M14.5 9.5 17 7l-5-5v4.5",key:"1kddfz"}]],BluetoothOff=createLucideIcon("bluetooth-off",__iconNode$n0);const __iconNode$m$=[["path",{d:"m7 7 10 10-5 5V2l5 5L7 17",key:"1q5490"}],["path",{d:"M20.83 14.83a4 4 0 0 0 0-5.66",key:"k8tn1j"}],["path",{d:"M18 12h.01",key:"yjnet6"}]],BluetoothSearching=createLucideIcon("bluetooth-searching",__iconNode$m$);const __iconNode$m_=[["path",{d:"m7 7 10 10-5 5V2l5 5L7 17",key:"1q5490"}]],Bluetooth=createLucideIcon("bluetooth",__iconNode$m_);const __iconNode$mZ=[["path",{d:"M6 12h9a4 4 0 0 1 0 8H7a1 1 0 0 1-1-1V5a1 1 0 0 1 1-1h7a4 4 0 0 1 0 8",key:"mg9rjx"}]],Bold=createLucideIcon("bold",__iconNode$mZ);const __iconNode$mY=[["path",{d:"M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z",key:"yt0hxn"}],["circle",{cx:"12",cy:"12",r:"4",key:"4exip2"}]],Bolt=createLucideIcon("bolt",__iconNode$mY);const __iconNode$mX=[["circle",{cx:"11",cy:"13",r:"9",key:"hd149"}],["path",{d:"M14.35 4.65 16.3 2.7a2.41 2.41 0 0 1 3.4 0l1.6 1.6a2.4 2.4 0 0 1 0 3.4l-1.95 1.95",key:"jp4j1b"}],["path",{d:"m22 2-1.5 1.5",key:"ay92ug"}]],Bomb=createLucideIcon("bomb",__iconNode$mX);const __iconNode$mW=[["path",{d:"M17 10c.7-.7 1.69 0 2.5 0a2.5 2.5 0 1 0 0-5 .5.5 0 0 1-.5-.5 2.5 2.5 0 1 0-5 0c0 .81.7 1.8 0 2.5l-7 7c-.7.7-1.69 0-2.5 0a2.5 2.5 0 0 0 0 5c.28 0 .5.22.5.5a2.5 2.5 0 1 0 5 0c0-.81-.7-1.8 0-2.5Z",key:"w610uw"}]],Bone=createLucideIcon("bone",__iconNode$mW);const __iconNode$mV=[["path",{d:"M12 13h.01",key:"y0uutt"}],["path",{d:"M12 6v3",key:"1m4b9j"}],["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}]],BookAlert=createLucideIcon("book-alert",__iconNode$mV);const __iconNode$mU=[["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}],["path",{d:"m8 13 4-7 4 7",key:"4rari8"}],["path",{d:"M9.1 11h5.7",key:"1gkovt"}]],BookA=createLucideIcon("book-a",__iconNode$mU);const __iconNode$mT=[["path",{d:"M12 6v7",key:"1f6ttz"}],["path",{d:"M16 8v3",key:"gejaml"}],["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}],["path",{d:"M8 8v3",key:"1qzp49"}]],BookAudio=createLucideIcon("book-audio",__iconNode$mT);const __iconNode$mS=[["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}],["path",{d:"m9 9.5 2 2 4-4",key:"1dth82"}]],BookCheck=createLucideIcon("book-check",__iconNode$mS);const __iconNode$mR=[["path",{d:"M5 7a2 2 0 0 0-2 2v11",key:"1yhqjt"}],["path",{d:"M5.803 18H5a2 2 0 0 0 0 4h9.5a.5.5 0 0 0 .5-.5V21",key:"edzzo5"}],["path",{d:"M9 15V4a2 2 0 0 1 2-2h9.5a.5.5 0 0 1 .5.5v14a.5.5 0 0 1-.5.5H11a2 2 0 0 1 0-4h10",key:"1nwzrg"}]],BookCopy=createLucideIcon("book-copy",__iconNode$mR);const __iconNode$mQ=[["path",{d:"M12 17h1.5",key:"1gkc67"}],["path",{d:"M12 22h1.5",key:"1my7sn"}],["path",{d:"M12 2h1.5",key:"19tvb7"}],["path",{d:"M17.5 22H19a1 1 0 0 0 1-1",key:"10akbh"}],["path",{d:"M17.5 2H19a1 1 0 0 1 1 1v1.5",key:"1vrfjs"}],["path",{d:"M20 14v3h-2.5",key:"1naeju"}],["path",{d:"M20 8.5V10",key:"1ctpfu"}],["path",{d:"M4 10V8.5",key:"1o3zg5"}],["path",{d:"M4 19.5V14",key:"ob81pf"}],["path",{d:"M4 4.5A2.5 2.5 0 0 1 6.5 2H8",key:"s8vcyb"}],["path",{d:"M8 22H6.5a1 1 0 0 1 0-5H8",key:"1cu73q"}]],BookDashed=createLucideIcon("book-dashed",__iconNode$mQ);const __iconNode$mP=[["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}],["path",{d:"M8 12v-2a4 4 0 0 1 8 0v2",key:"1vsqkj"}],["circle",{cx:"15",cy:"12",r:"1",key:"1tmaij"}],["circle",{cx:"9",cy:"12",r:"1",key:"1vctgf"}]],BookHeadphones=createLucideIcon("book-headphones",__iconNode$mP);const __iconNode$mO=[["path",{d:"M12 13V7",key:"h0r20n"}],["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}],["path",{d:"m9 10 3 3 3-3",key:"zt5b4y"}]],BookDown=createLucideIcon("book-down",__iconNode$mO);const __iconNode$mN=[["path",{d:"m20 13.7-2.1-2.1a2 2 0 0 0-2.8 0L9.7 17",key:"q6ojf0"}],["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}],["circle",{cx:"10",cy:"8",r:"2",key:"2qkj4p"}]],BookImage=createLucideIcon("book-image",__iconNode$mN);const __iconNode$mM=[["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}],["path",{d:"M8.62 9.8A2.25 2.25 0 1 1 12 6.836a2.25 2.25 0 1 1 3.38 2.966l-2.626 2.856a.998.998 0 0 1-1.507 0z",key:"9v40y5"}]],BookHeart=createLucideIcon("book-heart",__iconNode$mM);const __iconNode$mL=[["path",{d:"m19 3 1 1",key:"ze14oc"}],["path",{d:"m20 2-4.5 4.5",key:"1sppr8"}],["path",{d:"M20 7.898V21a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"1xzogz"}],["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2h7.844",key:"vtdg6h"}],["circle",{cx:"14",cy:"8",r:"2",key:"u49eql"}]],BookKey=createLucideIcon("book-key",__iconNode$mL);const __iconNode$mK=[["path",{d:"M18 6V4a2 2 0 1 0-4 0v2",key:"1aquzs"}],["path",{d:"M20 15v6a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"1rkj32"}],["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H10",key:"18wgow"}],["rect",{x:"12",y:"6",width:"8",height:"5",rx:"1",key:"73l30o"}]],BookLock=createLucideIcon("book-lock",__iconNode$mK);const __iconNode$mJ=[["path",{d:"M10 2v8l3-3 3 3V2",key:"sqw3rj"}],["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}]],BookMarked=createLucideIcon("book-marked",__iconNode$mJ);const __iconNode$mI=[["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}],["path",{d:"M9 10h6",key:"9gxzsh"}]],BookMinus=createLucideIcon("book-minus",__iconNode$mI);const __iconNode$mH=[["path",{d:"M12 21V7",key:"gj6g52"}],["path",{d:"m16 12 2 2 4-4",key:"mdajum"}],["path",{d:"M22 6V4a1 1 0 0 0-1-1h-5a4 4 0 0 0-4 4 4 4 0 0 0-4-4H3a1 1 0 0 0-1 1v13a1 1 0 0 0 1 1h6a3 3 0 0 1 3 3 3 3 0 0 1 3-3h6a1 1 0 0 0 1-1v-1.3",key:"8arnkb"}]],BookOpenCheck=createLucideIcon("book-open-check",__iconNode$mH);const __iconNode$mG=[["path",{d:"M12 7v14",key:"1akyts"}],["path",{d:"M16 12h2",key:"7q9ll5"}],["path",{d:"M16 8h2",key:"msurwy"}],["path",{d:"M3 18a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h5a4 4 0 0 1 4 4 4 4 0 0 1 4-4h5a1 1 0 0 1 1 1v13a1 1 0 0 1-1 1h-6a3 3 0 0 0-3 3 3 3 0 0 0-3-3z",key:"ruj8y"}],["path",{d:"M6 12h2",key:"32wvfc"}],["path",{d:"M6 8h2",key:"30oboj"}]],BookOpenText=createLucideIcon("book-open-text",__iconNode$mG);const __iconNode$mF=[["path",{d:"M12 7v6",key:"lw1j43"}],["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}],["path",{d:"M9 10h6",key:"9gxzsh"}]],BookPlus=createLucideIcon("book-plus",__iconNode$mF);const __iconNode$mE=[["path",{d:"M12 7v14",key:"1akyts"}],["path",{d:"M3 18a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h5a4 4 0 0 1 4 4 4 4 0 0 1 4-4h5a1 1 0 0 1 1 1v13a1 1 0 0 1-1 1h-6a3 3 0 0 0-3 3 3 3 0 0 0-3-3z",key:"ruj8y"}]],BookOpen=createLucideIcon("book-open",__iconNode$mE);const __iconNode$mD=[["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}],["path",{d:"M8 11h8",key:"vwpz6n"}],["path",{d:"M8 7h6",key:"1f0q6e"}]],BookText=createLucideIcon("book-text",__iconNode$mD);const __iconNode$mC=[["path",{d:"M10 13h4",key:"ytezjc"}],["path",{d:"M12 6v7",key:"1f6ttz"}],["path",{d:"M16 8V6H8v2",key:"x8j6u4"}],["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}]],BookType=createLucideIcon("book-type",__iconNode$mC);const __iconNode$mB=[["path",{d:"M12 13V7",key:"h0r20n"}],["path",{d:"M18 2h1a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"161d7n"}],["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2",key:"1lorq7"}],["path",{d:"m9 10 3-3 3 3",key:"11gsxs"}],["path",{d:"m9 5 3-3 3 3",key:"l8vdw6"}]],BookUp2=createLucideIcon("book-up-2",__iconNode$mB);const __iconNode$mA=[["path",{d:"M12 13V7",key:"h0r20n"}],["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}],["path",{d:"m9 10 3-3 3 3",key:"11gsxs"}]],BookUp=createLucideIcon("book-up",__iconNode$mA);const __iconNode$mz=[["path",{d:"M15 13a3 3 0 1 0-6 0",key:"10j68g"}],["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}],["circle",{cx:"12",cy:"8",r:"2",key:"1822b1"}]],BookUser=createLucideIcon("book-user",__iconNode$mz);const __iconNode$my=[["path",{d:"m14.5 7-5 5",key:"dy991v"}],["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}],["path",{d:"m9.5 7 5 5",key:"s45iea"}]],BookX=createLucideIcon("book-x",__iconNode$my);const __iconNode$mx=[["path",{d:"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20",key:"k3hazp"}]],Book=createLucideIcon("book",__iconNode$mx);const __iconNode$mw=[["path",{d:"m19 21-7-4-7 4V5a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2Z",key:"169p4p"}],["path",{d:"m9 10 2 2 4-4",key:"1gnqz4"}]],BookmarkCheck=createLucideIcon("bookmark-check",__iconNode$mw);const __iconNode$mv=[["path",{d:"m19 21-7-4-7 4V5a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2v16z",key:"1fy3hk"}],["line",{x1:"15",x2:"9",y1:"10",y2:"10",key:"1gty7f"}]],BookmarkMinus=createLucideIcon("bookmark-minus",__iconNode$mv);const __iconNode$mu=[["path",{d:"m19 21-7-4-7 4V5a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2v16z",key:"1fy3hk"}],["line",{x1:"12",x2:"12",y1:"7",y2:"13",key:"1cppfj"}],["line",{x1:"15",x2:"9",y1:"10",y2:"10",key:"1gty7f"}]],BookmarkPlus=createLucideIcon("bookmark-plus",__iconNode$mu);const __iconNode$mt=[["path",{d:"m19 21-7-4-7 4V5a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2Z",key:"169p4p"}],["path",{d:"m14.5 7.5-5 5",key:"3lb6iw"}],["path",{d:"m9.5 7.5 5 5",key:"ko136h"}]],BookmarkX=createLucideIcon("bookmark-x",__iconNode$mt);const __iconNode$ms=[["path",{d:"m19 21-7-4-7 4V5a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2v16z",key:"1fy3hk"}]],Bookmark=createLucideIcon("bookmark",__iconNode$ms);const __iconNode$mr=[["path",{d:"M4 9V5a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v4",key:"vvzvr1"}],["path",{d:"M8 8v1",key:"xcqmfk"}],["path",{d:"M12 8v1",key:"1rj8u4"}],["path",{d:"M16 8v1",key:"1q12zr"}],["rect",{width:"20",height:"12",x:"2",y:"9",rx:"2",key:"igpb89"}],["circle",{cx:"8",cy:"15",r:"2",key:"fa4a8s"}],["circle",{cx:"16",cy:"15",r:"2",key:"14c3ya"}]],BoomBox=createLucideIcon("boom-box",__iconNode$mr);const __iconNode$mq=[["path",{d:"M12 6V2H8",key:"1155em"}],["path",{d:"M15 11v2",key:"i11awn"}],["path",{d:"M2 12h2",key:"1t8f8n"}],["path",{d:"M20 12h2",key:"1q8mjw"}],["path",{d:"M20 16a2 2 0 0 1-2 2H8.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 4 20.286V8a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2z",key:"11gyqh"}],["path",{d:"M9 11v2",key:"1ueba0"}]],BotMessageSquare=createLucideIcon("bot-message-square",__iconNode$mq);const __iconNode$mp=[["path",{d:"M13.67 8H18a2 2 0 0 1 2 2v4.33",key:"7az073"}],["path",{d:"M2 14h2",key:"vft8re"}],["path",{d:"M20 14h2",key:"4cs60a"}],["path",{d:"M22 22 2 2",key:"1r8tn9"}],["path",{d:"M8 8H6a2 2 0 0 0-2 2v8a2 2 0 0 0 2 2h12a2 2 0 0 0 1.414-.586",key:"s09a7a"}],["path",{d:"M9 13v2",key:"rq6x2g"}],["path",{d:"M9.67 4H12v2.33",key:"110xot"}]],BotOff=createLucideIcon("bot-off",__iconNode$mp);const __iconNode$mo=[["path",{d:"M10 3a1 1 0 0 1 1-1h2a1 1 0 0 1 1 1v2a6 6 0 0 0 1.2 3.6l.6.8A6 6 0 0 1 17 13v8a1 1 0 0 1-1 1H8a1 1 0 0 1-1-1v-8a6 6 0 0 1 1.2-3.6l.6-.8A6 6 0 0 0 10 5z",key:"blqgoc"}],["path",{d:"M17 13h-4a1 1 0 0 0-1 1v3a1 1 0 0 0 1 1h4",key:"43jbee"}]],BottleWine=createLucideIcon("bottle-wine",__iconNode$mo);const __iconNode$mn=[["path",{d:"M12 8V4H8",key:"hb8ula"}],["rect",{width:"16",height:"12",x:"4",y:"8",rx:"2",key:"enze0r"}],["path",{d:"M2 14h2",key:"vft8re"}],["path",{d:"M20 14h2",key:"4cs60a"}],["path",{d:"M15 13v2",key:"1xurst"}],["path",{d:"M9 13v2",key:"rq6x2g"}]],Bot=createLucideIcon("bot",__iconNode$mn);const __iconNode$mm=[["path",{d:"M17 3h4v4",key:"19p9u1"}],["path",{d:"M18.575 11.082a13 13 0 0 1 1.048 9.027 1.17 1.17 0 0 1-1.914.597L14 17",key:"12t3w9"}],["path",{d:"M7 10 3.29 6.29a1.17 1.17 0 0 1 .6-1.91 13 13 0 0 1 9.03 1.05",key:"ogng5l"}],["path",{d:"M7 14a1.7 1.7 0 0 0-1.207.5l-2.646 2.646A.5.5 0 0 0 3.5 18H5a1 1 0 0 1 1 1v1.5a.5.5 0 0 0 .854.354L9.5 18.207A1.7 1.7 0 0 0 10 17v-2a1 1 0 0 0-1-1z",key:"8v3fy2"}],["path",{d:"M9.707 14.293 21 3",key:"ydm3bn"}]],BowArrow=createLucideIcon("bow-arrow",__iconNode$mm);const __iconNode$ml=[["path",{d:"M21 8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16Z",key:"hh9hay"}],["path",{d:"m3.3 7 8.7 5 8.7-5",key:"g66t2b"}],["path",{d:"M12 22V12",key:"d0xqtd"}]],Box=createLucideIcon("box",__iconNode$ml);const __iconNode$mk=[["path",{d:"M2.97 12.92A2 2 0 0 0 2 14.63v3.24a2 2 0 0 0 .97 1.71l3 1.8a2 2 0 0 0 2.06 0L12 19v-5.5l-5-3-4.03 2.42Z",key:"lc1i9w"}],["path",{d:"m7 16.5-4.74-2.85",key:"1o9zyk"}],["path",{d:"m7 16.5 5-3",key:"va8pkn"}],["path",{d:"M7 16.5v5.17",key:"jnp8gn"}],["path",{d:"M12 13.5V19l3.97 2.38a2 2 0 0 0 2.06 0l3-1.8a2 2 0 0 0 .97-1.71v-3.24a2 2 0 0 0-.97-1.71L17 10.5l-5 3Z",key:"8zsnat"}],["path",{d:"m17 16.5-5-3",key:"8arw3v"}],["path",{d:"m17 16.5 4.74-2.85",key:"8rfmw"}],["path",{d:"M17 16.5v5.17",key:"k6z78m"}],["path",{d:"M7.97 4.42A2 2 0 0 0 7 6.13v4.37l5 3 5-3V6.13a2 2 0 0 0-.97-1.71l-3-1.8a2 2 0 0 0-2.06 0l-3 1.8Z",key:"1xygjf"}],["path",{d:"M12 8 7.26 5.15",key:"1vbdud"}],["path",{d:"m12 8 4.74-2.85",key:"3rx089"}],["path",{d:"M12 13.5V8",key:"1io7kd"}]],Boxes=createLucideIcon("boxes",__iconNode$mk);const __iconNode$mj=[["path",{d:"M8 3H7a2 2 0 0 0-2 2v5a2 2 0 0 1-2 2 2 2 0 0 1 2 2v5c0 1.1.9 2 2 2h1",key:"ezmyqa"}],["path",{d:"M16 21h1a2 2 0 0 0 2-2v-5c0-1.1.9-2 2-2a2 2 0 0 1-2-2V5a2 2 0 0 0-2-2h-1",key:"e1hn23"}]],Braces=createLucideIcon("braces",__iconNode$mj);const __iconNode$mi=[["path",{d:"M16 3h3a1 1 0 0 1 1 1v16a1 1 0 0 1-1 1h-3",key:"1kt8lf"}],["path",{d:"M8 21H5a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h3",key:"gduv9"}]],Brackets=createLucideIcon("brackets",__iconNode$mi);const __iconNode$mh=[["path",{d:"M12 5a3 3 0 1 0-5.997.125 4 4 0 0 0-2.526 5.77 4 4 0 0 0 .556 6.588A4 4 0 1 0 12 18Z",key:"l5xja"}],["path",{d:"M9 13a4.5 4.5 0 0 0 3-4",key:"10igwf"}],["path",{d:"M6.003 5.125A3 3 0 0 0 6.401 6.5",key:"105sqy"}],["path",{d:"M3.477 10.896a4 4 0 0 1 .585-.396",key:"ql3yin"}],["path",{d:"M6 18a4 4 0 0 1-1.967-.516",key:"2e4loj"}],["path",{d:"M12 13h4",key:"1ku699"}],["path",{d:"M12 18h6a2 2 0 0 1 2 2v1",key:"105ag5"}],["path",{d:"M12 8h8",key:"1lhi5i"}],["path",{d:"M16 8V5a2 2 0 0 1 2-2",key:"u6izg6"}],["circle",{cx:"16",cy:"13",r:".5",key:"ry7gng"}],["circle",{cx:"18",cy:"3",r:".5",key:"1aiba7"}],["circle",{cx:"20",cy:"21",r:".5",key:"yhc1fs"}],["circle",{cx:"20",cy:"8",r:".5",key:"1e43v0"}]],BrainCircuit=createLucideIcon("brain-circuit",__iconNode$mh);const __iconNode$mg=[["path",{d:"m10.852 14.772-.383.923",key:"11vil6"}],["path",{d:"m10.852 9.228-.383-.923",key:"1fjppe"}],["path",{d:"m13.148 14.772.382.924",key:"je3va1"}],["path",{d:"m13.531 8.305-.383.923",key:"18epck"}],["path",{d:"m14.772 10.852.923-.383",key:"k9m8cz"}],["path",{d:"m14.772 13.148.923.383",key:"1xvhww"}],["path",{d:"M17.598 6.5A3 3 0 1 0 12 5a3 3 0 0 0-5.63-1.446 3 3 0 0 0-.368 1.571 4 4 0 0 0-2.525 5.771",key:"jcbbz1"}],["path",{d:"M17.998 5.125a4 4 0 0 1 2.525 5.771",key:"1kkn7e"}],["path",{d:"M19.505 10.294a4 4 0 0 1-1.5 7.706",key:"18bmuc"}],["path",{d:"M4.032 17.483A4 4 0 0 0 11.464 20c.18-.311.892-.311 1.072 0a4 4 0 0 0 7.432-2.516",key:"uozx0d"}],["path",{d:"M4.5 10.291A4 4 0 0 0 6 18",key:"whdemb"}],["path",{d:"M6.002 5.125a3 3 0 0 0 .4 1.375",key:"1kqy2g"}],["path",{d:"m9.228 10.852-.923-.383",key:"1wtb30"}],["path",{d:"m9.228 13.148-.923.383",key:"1a830x"}],["circle",{cx:"12",cy:"12",r:"3",key:"1v7zrd"}]],BrainCog=createLucideIcon("brain-cog",__iconNode$mg);const __iconNode$mf=[["path",{d:"M12 18V5",key:"adv99a"}],["path",{d:"M15 13a4.17 4.17 0 0 1-3-4 4.17 4.17 0 0 1-3 4",key:"1e3is1"}],["path",{d:"M17.598 6.5A3 3 0 1 0 12 5a3 3 0 1 0-5.598 1.5",key:"1gqd8o"}],["path",{d:"M17.997 5.125a4 4 0 0 1 2.526 5.77",key:"iwvgf7"}],["path",{d:"M18 18a4 4 0 0 0 2-7.464",key:"efp6ie"}],["path",{d:"M19.967 17.483A4 4 0 1 1 12 18a4 4 0 1 1-7.967-.517",key:"1gq6am"}],["path",{d:"M6 18a4 4 0 0 1-2-7.464",key:"k1g0md"}],["path",{d:"M6.003 5.125a4 4 0 0 0-2.526 5.77",key:"q97ue3"}]],Brain=createLucideIcon("brain",__iconNode$mf);const __iconNode$me=[["path",{d:"M16 3v2.107",key:"gq8xun"}],["path",{d:"M17 9c1 3 2.5 3.5 3.5 4.5A5 5 0 0 1 22 17a5 5 0 0 1-10 0c0-.3 0-.6.1-.9a2 2 0 1 0 3.3-2C13 11.5 16 9 17 9",key:"1l2pih"}],["path",{d:"M21 8.274V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h3.938",key:"jrnqjp"}],["path",{d:"M3 15h5.253",key:"xqg7rb"}],["path",{d:"M3 9h8.228",key:"1ppb70"}],["path",{d:"M8 15v6",key:"1stoo3"}],["path",{d:"M8 3v6",key:"vlvjmk"}]],BrickWallFire=createLucideIcon("brick-wall-fire",__iconNode$me);const __iconNode$md=[["path",{d:"M12 9v1.258",key:"iwpddn"}],["path",{d:"M16 3v5.46",key:"d7ew98"}],["path",{d:"M21 9.118V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h5.75",key:"137t5x"}],["path",{d:"M22 17.5c0 2.499-1.75 3.749-3.83 4.474a.5.5 0 0 1-.335-.005c-2.085-.72-3.835-1.97-3.835-4.47V14a.5.5 0 0 1 .5-.499c1 0 2.25-.6 3.12-1.36a.6.6 0 0 1 .76-.001c.875.765 2.12 1.36 3.12 1.36a.5.5 0 0 1 .5.5z",key:"16j3tf"}],["path",{d:"M3 15h7",key:"1qldh6"}],["path",{d:"M3 9h12.142",key:"1yjd6m"}],["path",{d:"M8 15v6",key:"1stoo3"}],["path",{d:"M8 3v6",key:"vlvjmk"}]],BrickWallShield=createLucideIcon("brick-wall-shield",__iconNode$md);const __iconNode$mc=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M12 9v6",key:"199k2o"}],["path",{d:"M16 15v6",key:"8rj2es"}],["path",{d:"M16 3v6",key:"1j6rpj"}],["path",{d:"M3 15h18",key:"5xshup"}],["path",{d:"M3 9h18",key:"1pudct"}],["path",{d:"M8 15v6",key:"1stoo3"}],["path",{d:"M8 3v6",key:"vlvjmk"}]],BrickWall=createLucideIcon("brick-wall",__iconNode$mc);const __iconNode$mb=[["path",{d:"M12 12h.01",key:"1mp3jc"}],["path",{d:"M16 6V4a2 2 0 0 0-2-2h-4a2 2 0 0 0-2 2v2",key:"1ksdt3"}],["path",{d:"M22 13a18.15 18.15 0 0 1-20 0",key:"12hx5q"}],["rect",{width:"20",height:"14",x:"2",y:"6",rx:"2",key:"i6l2r4"}]],BriefcaseBusiness=createLucideIcon("briefcase-business",__iconNode$mb);const __iconNode$ma=[["path",{d:"M10 20v2",key:"1n8e1g"}],["path",{d:"M14 20v2",key:"1lq872"}],["path",{d:"M18 20v2",key:"10uadw"}],["path",{d:"M21 20H3",key:"kdqkdp"}],["path",{d:"M6 20v2",key:"a9bc87"}],["path",{d:"M8 16V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v12",key:"17n9tx"}],["rect",{x:"4",y:"6",width:"16",height:"10",rx:"2",key:"1097i5"}]],BriefcaseConveyorBelt=createLucideIcon("briefcase-conveyor-belt",__iconNode$ma);const __iconNode$m9=[["path",{d:"M12 11v4",key:"a6ujw6"}],["path",{d:"M14 13h-4",key:"1pl8zg"}],["path",{d:"M16 6V4a2 2 0 0 0-2-2h-4a2 2 0 0 0-2 2v2",key:"1ksdt3"}],["path",{d:"M18 6v14",key:"1mu4gy"}],["path",{d:"M6 6v14",key:"1s15cj"}],["rect",{width:"20",height:"14",x:"2",y:"6",rx:"2",key:"i6l2r4"}]],BriefcaseMedical=createLucideIcon("briefcase-medical",__iconNode$m9);const __iconNode$m8=[["path",{d:"M16 20V4a2 2 0 0 0-2-2h-4a2 2 0 0 0-2 2v16",key:"jecpp"}],["rect",{width:"20",height:"14",x:"2",y:"6",rx:"2",key:"i6l2r4"}]],Briefcase=createLucideIcon("briefcase",__iconNode$m8);const __iconNode$m7=[["rect",{x:"8",y:"8",width:"8",height:"8",rx:"2",key:"yj20xf"}],["path",{d:"M4 10a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2",key:"1ltk23"}],["path",{d:"M14 20a2 2 0 0 0 2 2h4a2 2 0 0 0 2-2v-4a2 2 0 0 0-2-2",key:"1q24h9"}]],BringToFront=createLucideIcon("bring-to-front",__iconNode$m7);const __iconNode$m6=[["path",{d:"m16 22-1-4",key:"1ow2iv"}],["path",{d:"M19 13.99a1 1 0 0 0 1-1V12a2 2 0 0 0-2-2h-3a1 1 0 0 1-1-1V4a2 2 0 0 0-4 0v5a1 1 0 0 1-1 1H6a2 2 0 0 0-2 2v.99a1 1 0 0 0 1 1",key:"iw8jdu"}],["path",{d:"M5 14h14l1.973 6.767A1 1 0 0 1 20 22H4a1 1 0 0 1-.973-1.233z",key:"1soew8"}],["path",{d:"m8 22 1-4",key:"s3unb"}]],BrushCleaning=createLucideIcon("brush-cleaning",__iconNode$m6);const __iconNode$m5=[["path",{d:"m11 10 3 3",key:"fzmg1i"}],["path",{d:"M6.5 21A3.5 3.5 0 1 0 3 17.5a2.62 2.62 0 0 1-.708 1.792A1 1 0 0 0 3 21z",key:"p4q2r7"}],["path",{d:"M9.969 17.031 21.378 5.624a1 1 0 0 0-3.002-3.002L6.967 14.031",key:"wy6l02"}]],Brush=createLucideIcon("brush",__iconNode$m5);const __iconNode$m4=[["path",{d:"M7.2 14.8a2 2 0 0 1 2 2",key:"1tw9gg"}],["circle",{cx:"18.5",cy:"8.5",r:"3.5",key:"1wadoa"}],["circle",{cx:"7.5",cy:"16.5",r:"5.5",key:"6mdt3g"}],["circle",{cx:"7.5",cy:"4.5",r:"2.5",key:"637s54"}]],Bubbles=createLucideIcon("bubbles",__iconNode$m4);const __iconNode$m3=[["path",{d:"M12 20v-8",key:"i3yub9"}],["path",{d:"M14.12 3.88 16 2",key:"qol33r"}],["path",{d:"M15 7.13V6a3 3 0 0 0-5.14-2.1L8 2",key:"vl8zik"}],["path",{d:"M18 12.34V11a4 4 0 0 0-4-4h-1.3",key:"sz915m"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M21 5a4 4 0 0 1-3.55 3.97",key:"5cxbf6"}],["path",{d:"M22 13h-3.34",key:"1y15gv"}],["path",{d:"M3 21a4 4 0 0 1 3.81-4",key:"1fjd4g"}],["path",{d:"M6 13H2",key:"82j7cp"}],["path",{d:"M7.7 7.7A4 4 0 0 0 6 11v3a6 6 0 0 0 11.13 3.13",key:"1njkjs"}]],BugOff=createLucideIcon("bug-off",__iconNode$m3);const __iconNode$m2=[["path",{d:"M10 19.655A6 6 0 0 1 6 14v-3a4 4 0 0 1 4-4h4a4 4 0 0 1 4 3.97",key:"1gnv52"}],["path",{d:"M14 15.003a1 1 0 0 1 1.517-.859l4.997 2.997a1 1 0 0 1 0 1.718l-4.997 2.997a1 1 0 0 1-1.517-.86z",key:"1weqy9"}],["path",{d:"M14.12 3.88 16 2",key:"qol33r"}],["path",{d:"M21 5a4 4 0 0 1-3.55 3.97",key:"5cxbf6"}],["path",{d:"M3 21a4 4 0 0 1 3.81-4",key:"1fjd4g"}],["path",{d:"M3 5a4 4 0 0 0 3.55 3.97",key:"1d7oge"}],["path",{d:"M6 13H2",key:"82j7cp"}],["path",{d:"m8 2 1.88 1.88",key:"fmnt4t"}],["path",{d:"M9 7.13V6a3 3 0 1 1 6 0v1.13",key:"1vgav8"}]],BugPlay=createLucideIcon("bug-play",__iconNode$m2);const __iconNode$m1=[["path",{d:"M12 20v-9",key:"1qisl0"}],["path",{d:"M14 7a4 4 0 0 1 4 4v3a6 6 0 0 1-12 0v-3a4 4 0 0 1 4-4z",key:"uouzyp"}],["path",{d:"M14.12 3.88 16 2",key:"qol33r"}],["path",{d:"M21 21a4 4 0 0 0-3.81-4",key:"1b0z45"}],["path",{d:"M21 5a4 4 0 0 1-3.55 3.97",key:"5cxbf6"}],["path",{d:"M22 13h-4",key:"1jl80f"}],["path",{d:"M3 21a4 4 0 0 1 3.81-4",key:"1fjd4g"}],["path",{d:"M3 5a4 4 0 0 0 3.55 3.97",key:"1d7oge"}],["path",{d:"M6 13H2",key:"82j7cp"}],["path",{d:"m8 2 1.88 1.88",key:"fmnt4t"}],["path",{d:"M9 7.13V6a3 3 0 1 1 6 0v1.13",key:"1vgav8"}]],Bug=createLucideIcon("bug",__iconNode$m1);const __iconNode$m0=[["path",{d:"M10 12h4",key:"a56b0p"}],["path",{d:"M10 8h4",key:"1sr2af"}],["path",{d:"M14 21v-3a2 2 0 0 0-4 0v3",key:"1rgiei"}],["path",{d:"M6 10H4a2 2 0 0 0-2 2v7a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-2",key:"secmi2"}],["path",{d:"M6 21V5a2 2 0 0 1 2-2h8a2 2 0 0 1 2 2v16",key:"16ra0t"}]],Building2=createLucideIcon("building-2",__iconNode$m0);const __iconNode$l$=[["path",{d:"M12 10h.01",key:"1nrarc"}],["path",{d:"M12 14h.01",key:"1etili"}],["path",{d:"M12 6h.01",key:"1vi96p"}],["path",{d:"M16 10h.01",key:"1m94wz"}],["path",{d:"M16 14h.01",key:"1gbofw"}],["path",{d:"M16 6h.01",key:"1x0f13"}],["path",{d:"M8 10h.01",key:"19clt8"}],["path",{d:"M8 14h.01",key:"6423bh"}],["path",{d:"M8 6h.01",key:"1dz90k"}],["path",{d:"M9 22v-3a1 1 0 0 1 1-1h4a1 1 0 0 1 1 1v3",key:"cabbwy"}],["rect",{x:"4",y:"2",width:"16",height:"20",rx:"2",key:"1uxh74"}]],Building=createLucideIcon("building",__iconNode$l$);const __iconNode$l_=[["path",{d:"M4 6 2 7",key:"1mqr15"}],["path",{d:"M10 6h4",key:"1itunk"}],["path",{d:"m22 7-2-1",key:"1umjhc"}],["rect",{width:"16",height:"16",x:"4",y:"3",rx:"2",key:"1wxw4b"}],["path",{d:"M4 11h16",key:"mpoxn0"}],["path",{d:"M8 15h.01",key:"a7atzg"}],["path",{d:"M16 15h.01",key:"rnfrdf"}],["path",{d:"M6 19v2",key:"1loha6"}],["path",{d:"M18 21v-2",key:"sqyl04"}]],BusFront=createLucideIcon("bus-front",__iconNode$l_);const __iconNode$lZ=[["path",{d:"M8 6v6",key:"18i7km"}],["path",{d:"M15 6v6",key:"1sg6z9"}],["path",{d:"M2 12h19.6",key:"de5uta"}],["path",{d:"M18 18h3s.5-1.7.8-2.8c.1-.4.2-.8.2-1.2 0-.4-.1-.8-.2-1.2l-1.4-5C20.1 6.8 19.1 6 18 6H4a2 2 0 0 0-2 2v10h3",key:"1wwztk"}],["circle",{cx:"7",cy:"18",r:"2",key:"19iecd"}],["path",{d:"M9 18h5",key:"lrx6i"}],["circle",{cx:"16",cy:"18",r:"2",key:"1v4tcr"}]],Bus=createLucideIcon("bus",__iconNode$lZ);const __iconNode$lY=[["path",{d:"M10 3h.01",key:"lbucoy"}],["path",{d:"M14 2h.01",key:"1k8aa1"}],["path",{d:"m2 9 20-5",key:"1kz0j5"}],["path",{d:"M12 12V6.5",key:"1vbrij"}],["rect",{width:"16",height:"10",x:"4",y:"12",rx:"3",key:"if91er"}],["path",{d:"M9 12v5",key:"3anwtq"}],["path",{d:"M15 12v5",key:"5xh3zn"}],["path",{d:"M4 17h16",key:"g4d7ey"}]],CableCar=createLucideIcon("cable-car",__iconNode$lY);const __iconNode$lX=[["path",{d:"M17 19a1 1 0 0 1-1-1v-2a2 2 0 0 1 2-2h2a2 2 0 0 1 2 2v2a1 1 0 0 1-1 1z",key:"trhst0"}],["path",{d:"M17 21v-2",key:"ds4u3f"}],["path",{d:"M19 14V6.5a1 1 0 0 0-7 0v11a1 1 0 0 1-7 0V10",key:"1mo9zo"}],["path",{d:"M21 21v-2",key:"eo0ou"}],["path",{d:"M3 5V3",key:"1k5hjh"}],["path",{d:"M4 10a2 2 0 0 1-2-2V6a1 1 0 0 1 1-1h4a1 1 0 0 1 1 1v2a2 2 0 0 1-2 2z",key:"1dd30t"}],["path",{d:"M7 5V3",key:"1t1388"}]],Cable=createLucideIcon("cable",__iconNode$lX);const __iconNode$lW=[["path",{d:"M16 13H3",key:"1wpj08"}],["path",{d:"M16 17H3",key:"3lvfcd"}],["path",{d:"m7.2 7.9-3.388 2.5A2 2 0 0 0 3 12.01V20a1 1 0 0 0 1 1h16a1 1 0 0 0 1-1v-8.654c0-2-2.44-6.026-6.44-8.026a1 1 0 0 0-1.082.057L10.4 5.6",key:"1gmhf7"}],["circle",{cx:"9",cy:"7",r:"2",key:"1305pl"}]],CakeSlice=createLucideIcon("cake-slice",__iconNode$lW);const __iconNode$lV=[["path",{d:"M20 21v-8a2 2 0 0 0-2-2H6a2 2 0 0 0-2 2v8",key:"1w3rig"}],["path",{d:"M4 16s.5-1 2-1 2.5 2 4 2 2.5-2 4-2 2.5 2 4 2 2-1 2-1",key:"n2jgmb"}],["path",{d:"M2 21h20",key:"1nyx9w"}],["path",{d:"M7 8v3",key:"1qtyvj"}],["path",{d:"M12 8v3",key:"hwp4zt"}],["path",{d:"M17 8v3",key:"1i6e5u"}],["path",{d:"M7 4h.01",key:"1bh4kh"}],["path",{d:"M12 4h.01",key:"1ujb9j"}],["path",{d:"M17 4h.01",key:"1upcoc"}]],Cake=createLucideIcon("cake",__iconNode$lV);const __iconNode$lU=[["rect",{width:"16",height:"20",x:"4",y:"2",rx:"2",key:"1nb95v"}],["line",{x1:"8",x2:"16",y1:"6",y2:"6",key:"x4nwl0"}],["line",{x1:"16",x2:"16",y1:"14",y2:"18",key:"wjye3r"}],["path",{d:"M16 10h.01",key:"1m94wz"}],["path",{d:"M12 10h.01",key:"1nrarc"}],["path",{d:"M8 10h.01",key:"19clt8"}],["path",{d:"M12 14h.01",key:"1etili"}],["path",{d:"M8 14h.01",key:"6423bh"}],["path",{d:"M12 18h.01",key:"mhygvu"}],["path",{d:"M8 18h.01",key:"lrp35t"}]],Calculator=createLucideIcon("calculator",__iconNode$lU);const __iconNode$lT=[["path",{d:"M11 14h1v4",key:"fy54vd"}],["path",{d:"M16 2v4",key:"4m81vk"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"M8 2v4",key:"1cmpym"}],["rect",{x:"3",y:"4",width:"18",height:"18",rx:"2",key:"12vinp"}]],Calendar1=createLucideIcon("calendar-1",__iconNode$lT);const __iconNode$lS=[["path",{d:"m14 18 4 4 4-4",key:"1waygx"}],["path",{d:"M16 2v4",key:"4m81vk"}],["path",{d:"M18 14v8",key:"irew45"}],["path",{d:"M21 11.354V6a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h7.343",key:"bse4f3"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"M8 2v4",key:"1cmpym"}]],CalendarArrowDown=createLucideIcon("calendar-arrow-down",__iconNode$lS);const __iconNode$lR=[["path",{d:"m14 18 4-4 4 4",key:"ftkppy"}],["path",{d:"M16 2v4",key:"4m81vk"}],["path",{d:"M18 22v-8",key:"su0gjh"}],["path",{d:"M21 11.343V6a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h9",key:"1exg90"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"M8 2v4",key:"1cmpym"}]],CalendarArrowUp=createLucideIcon("calendar-arrow-up",__iconNode$lR);const __iconNode$lQ=[["path",{d:"M8 2v4",key:"1cmpym"}],["path",{d:"M16 2v4",key:"4m81vk"}],["path",{d:"M21 14V6a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h8",key:"bce9hv"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"m16 20 2 2 4-4",key:"13tcca"}]],CalendarCheck2=createLucideIcon("calendar-check-2",__iconNode$lQ);const __iconNode$lP=[["path",{d:"M8 2v4",key:"1cmpym"}],["path",{d:"M16 2v4",key:"4m81vk"}],["rect",{width:"18",height:"18",x:"3",y:"4",rx:"2",key:"1hopcy"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"m9 16 2 2 4-4",key:"19s6y9"}]],CalendarCheck=createLucideIcon("calendar-check",__iconNode$lP);const __iconNode$lO=[["path",{d:"M16 14v2.2l1.6 1",key:"fo4ql5"}],["path",{d:"M16 2v4",key:"4m81vk"}],["path",{d:"M21 7.5V6a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h3.5",key:"1osxxc"}],["path",{d:"M3 10h5",key:"r794hk"}],["path",{d:"M8 2v4",key:"1cmpym"}],["circle",{cx:"16",cy:"16",r:"6",key:"qoo3c4"}]],CalendarClock=createLucideIcon("calendar-clock",__iconNode$lO);const __iconNode$lN=[["path",{d:"m15.228 16.852-.923-.383",key:"npixar"}],["path",{d:"m15.228 19.148-.923.383",key:"51cr3n"}],["path",{d:"M16 2v4",key:"4m81vk"}],["path",{d:"m16.47 14.305.382.923",key:"obybxd"}],["path",{d:"m16.852 20.772-.383.924",key:"dpfhf9"}],["path",{d:"m19.148 15.228.383-.923",key:"1reyyz"}],["path",{d:"m19.53 21.696-.382-.924",key:"1goivc"}],["path",{d:"m20.772 16.852.924-.383",key:"htqkph"}],["path",{d:"m20.772 19.148.924.383",key:"9w9pjp"}],["path",{d:"M21 10.592V6a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h6",key:"1pvbig"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"M8 2v4",key:"1cmpym"}],["circle",{cx:"18",cy:"18",r:"3",key:"1xkwt0"}]],CalendarCog=createLucideIcon("calendar-cog",__iconNode$lN);const __iconNode$lM=[["path",{d:"M8 2v4",key:"1cmpym"}],["path",{d:"M16 2v4",key:"4m81vk"}],["rect",{width:"18",height:"18",x:"3",y:"4",rx:"2",key:"1hopcy"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"M8 14h.01",key:"6423bh"}],["path",{d:"M12 14h.01",key:"1etili"}],["path",{d:"M16 14h.01",key:"1gbofw"}],["path",{d:"M8 18h.01",key:"lrp35t"}],["path",{d:"M12 18h.01",key:"mhygvu"}],["path",{d:"M16 18h.01",key:"kzsmim"}]],CalendarDays=createLucideIcon("calendar-days",__iconNode$lM);const __iconNode$lL=[["path",{d:"M3 20a2 2 0 0 0 2 2h10a2.4 2.4 0 0 0 1.706-.706l3.588-3.588A2.4 2.4 0 0 0 21 16V6a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2z",key:"r586nh"}],["path",{d:"M15 22v-5a1 1 0 0 1 1-1h5",key:"xl3app"}],["path",{d:"M8 2v4",key:"1cmpym"}],["path",{d:"M16 2v4",key:"4m81vk"}],["path",{d:"M3 10h18",key:"8toen8"}]],CalendarFold=createLucideIcon("calendar-fold",__iconNode$lL);const __iconNode$lK=[["path",{d:"M12.127 22H5a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v5.125",key:"vxdnp4"}],["path",{d:"M14.62 18.8A2.25 2.25 0 1 1 18 15.836a2.25 2.25 0 1 1 3.38 2.966l-2.626 2.856a.998.998 0 0 1-1.507 0z",key:"15cy7q"}],["path",{d:"M16 2v4",key:"4m81vk"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"M8 2v4",key:"1cmpym"}]],CalendarHeart=createLucideIcon("calendar-heart",__iconNode$lK);const __iconNode$lJ=[["path",{d:"M8 2v4",key:"1cmpym"}],["path",{d:"M16 2v4",key:"4m81vk"}],["rect",{width:"18",height:"18",x:"3",y:"4",rx:"2",key:"1hopcy"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"M10 16h4",key:"17e571"}]],CalendarMinus2=createLucideIcon("calendar-minus-2",__iconNode$lJ);const __iconNode$lI=[["path",{d:"M16 19h6",key:"xwg31i"}],["path",{d:"M16 2v4",key:"4m81vk"}],["path",{d:"M21 15V6a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h8.5",key:"1scpom"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"M8 2v4",key:"1cmpym"}]],CalendarMinus=createLucideIcon("calendar-minus",__iconNode$lI);const __iconNode$lH=[["path",{d:"M4.2 4.2A2 2 0 0 0 3 6v14a2 2 0 0 0 2 2h14a2 2 0 0 0 1.82-1.18",key:"16swn3"}],["path",{d:"M21 15.5V6a2 2 0 0 0-2-2H9.5",key:"yhw86o"}],["path",{d:"M16 2v4",key:"4m81vk"}],["path",{d:"M3 10h7",key:"1wap6i"}],["path",{d:"M21 10h-5.5",key:"quycpq"}],["path",{d:"m2 2 20 20",key:"1ooewy"}]],CalendarOff=createLucideIcon("calendar-off",__iconNode$lH);const __iconNode$lG=[["path",{d:"M8 2v4",key:"1cmpym"}],["path",{d:"M16 2v4",key:"4m81vk"}],["rect",{width:"18",height:"18",x:"3",y:"4",rx:"2",key:"1hopcy"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"M10 16h4",key:"17e571"}],["path",{d:"M12 14v4",key:"1thi36"}]],CalendarPlus2=createLucideIcon("calendar-plus-2",__iconNode$lG);const __iconNode$lF=[["path",{d:"M16 19h6",key:"xwg31i"}],["path",{d:"M16 2v4",key:"4m81vk"}],["path",{d:"M19 16v6",key:"tddt3s"}],["path",{d:"M21 12.598V6a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h8.5",key:"1glfrc"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"M8 2v4",key:"1cmpym"}]],CalendarPlus=createLucideIcon("calendar-plus",__iconNode$lF);const __iconNode$lE=[["rect",{width:"18",height:"18",x:"3",y:"4",rx:"2",key:"1hopcy"}],["path",{d:"M16 2v4",key:"4m81vk"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"M8 2v4",key:"1cmpym"}],["path",{d:"M17 14h-6",key:"bkmgh3"}],["path",{d:"M13 18H7",key:"bb0bb7"}],["path",{d:"M7 14h.01",key:"1qa3f1"}],["path",{d:"M17 18h.01",key:"1bdyru"}]],CalendarRange=createLucideIcon("calendar-range",__iconNode$lE);const __iconNode$lD=[["path",{d:"M16 2v4",key:"4m81vk"}],["path",{d:"M21 11.75V6a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h7.25",key:"1jrsq6"}],["path",{d:"m22 22-1.875-1.875",key:"13zax7"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"M8 2v4",key:"1cmpym"}],["circle",{cx:"18",cy:"18",r:"3",key:"1xkwt0"}]],CalendarSearch=createLucideIcon("calendar-search",__iconNode$lD);const __iconNode$lC=[["path",{d:"M11 10v4h4",key:"172dkj"}],["path",{d:"m11 14 1.535-1.605a5 5 0 0 1 8 1.5",key:"vu0qm5"}],["path",{d:"M16 2v4",key:"4m81vk"}],["path",{d:"m21 18-1.535 1.605a5 5 0 0 1-8-1.5",key:"1qgeyt"}],["path",{d:"M21 22v-4h-4",key:"hrummi"}],["path",{d:"M21 8.5V6a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h4.3",key:"mctw84"}],["path",{d:"M3 10h4",key:"1el30a"}],["path",{d:"M8 2v4",key:"1cmpym"}]],CalendarSync=createLucideIcon("calendar-sync",__iconNode$lC);const __iconNode$lB=[["path",{d:"M8 2v4",key:"1cmpym"}],["path",{d:"M16 2v4",key:"4m81vk"}],["path",{d:"M21 13V6a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h8",key:"3spt84"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"m17 22 5-5",key:"1k6ppv"}],["path",{d:"m17 17 5 5",key:"p7ous7"}]],CalendarX2=createLucideIcon("calendar-x-2",__iconNode$lB);const __iconNode$lA=[["path",{d:"M8 2v4",key:"1cmpym"}],["path",{d:"M16 2v4",key:"4m81vk"}],["rect",{width:"18",height:"18",x:"3",y:"4",rx:"2",key:"1hopcy"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"m14 14-4 4",key:"rymu2i"}],["path",{d:"m10 14 4 4",key:"3sz06r"}]],CalendarX=createLucideIcon("calendar-x",__iconNode$lA);const __iconNode$lz=[["path",{d:"M8 2v4",key:"1cmpym"}],["path",{d:"M16 2v4",key:"4m81vk"}],["rect",{width:"18",height:"18",x:"3",y:"4",rx:"2",key:"1hopcy"}],["path",{d:"M3 10h18",key:"8toen8"}]],Calendar=createLucideIcon("calendar",__iconNode$lz);const __iconNode$ly=[["path",{d:"M12 2v2",key:"tus03m"}],["path",{d:"M15.726 21.01A2 2 0 0 1 14 22H4a2 2 0 0 1-2-2V10a2 2 0 0 1 2-2",key:"j6srht"}],["path",{d:"M18 2v2",key:"1kh14s"}],["path",{d:"M8 8h14",key:"12jxz2"}],["rect",{x:"8",y:"3",width:"14",height:"14",rx:"2",key:"nsru6w"}]],Calendars=createLucideIcon("calendars",__iconNode$ly);const __iconNode$lx=[["path",{d:"M14.564 14.558a3 3 0 1 1-4.122-4.121",key:"1rnrzw"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M20 20H4a2 2 0 0 1-2-2V9a2 2 0 0 1 2-2h1.997a2 2 0 0 0 .819-.175",key:"1x3arw"}],["path",{d:"M9.695 4.024A2 2 0 0 1 10.004 4h3.993a2 2 0 0 1 1.76 1.05l.486.9A2 2 0 0 0 18.003 7H20a2 2 0 0 1 2 2v7.344",key:"1i84u0"}]],CameraOff=createLucideIcon("camera-off",__iconNode$lx);const __iconNode$lw=[["path",{d:"M13.997 4a2 2 0 0 1 1.76 1.05l.486.9A2 2 0 0 0 18.003 7H20a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V9a2 2 0 0 1 2-2h1.997a2 2 0 0 0 1.759-1.048l.489-.904A2 2 0 0 1 10.004 4z",key:"18u6gg"}],["circle",{cx:"12",cy:"13",r:"3",key:"1vg3eu"}]],Camera=createLucideIcon("camera",__iconNode$lw);const __iconNode$lv=[["path",{d:"M5.7 21a2 2 0 0 1-3.5-2l8.6-14a6 6 0 0 1 10.4 6 2 2 0 1 1-3.464-2 2 2 0 1 0-3.464-2Z",key:"isaq8g"}],["path",{d:"M17.75 7 15 2.1",key:"12x7e8"}],["path",{d:"M10.9 4.8 13 9",key:"100a87"}],["path",{d:"m7.9 9.7 2 4.4",key:"ntfhaj"}],["path",{d:"M4.9 14.7 7 18.9",key:"1x43jy"}]],CandyCane=createLucideIcon("candy-cane",__iconNode$lv);const __iconNode$lu=[["path",{d:"M10 10v7.9",key:"m8g9tt"}],["path",{d:"M11.802 6.145a5 5 0 0 1 6.053 6.053",key:"dn87i3"}],["path",{d:"M14 6.1v2.243",key:"1kzysn"}],["path",{d:"m15.5 15.571-.964.964a5 5 0 0 1-7.071 0 5 5 0 0 1 0-7.07l.964-.965",key:"3sxy18"}],["path",{d:"M16 7V3a1 1 0 0 1 1.707-.707 2.5 2.5 0 0 0 2.152.717 1 1 0 0 1 1.131 1.131 2.5 2.5 0 0 0 .717 2.152A1 1 0 0 1 21 8h-4",key:"gpb6xx"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M8 17v4a1 1 0 0 1-1.707.707 2.5 2.5 0 0 0-2.152-.717 1 1 0 0 1-1.131-1.131 2.5 2.5 0 0 0-.717-2.152A1 1 0 0 1 3 16h4",key:"qexcha"}]],CandyOff=createLucideIcon("candy-off",__iconNode$lu);const __iconNode$lt=[["path",{d:"M10 7v10.9",key:"1gynux"}],["path",{d:"M14 6.1V17",key:"116kdf"}],["path",{d:"M16 7V3a1 1 0 0 1 1.707-.707 2.5 2.5 0 0 0 2.152.717 1 1 0 0 1 1.131 1.131 2.5 2.5 0 0 0 .717 2.152A1 1 0 0 1 21 8h-4",key:"gpb6xx"}],["path",{d:"M16.536 7.465a5 5 0 0 0-7.072 0l-2 2a5 5 0 0 0 0 7.07 5 5 0 0 0 7.072 0l2-2a5 5 0 0 0 0-7.07",key:"1tsln4"}],["path",{d:"M8 17v4a1 1 0 0 1-1.707.707 2.5 2.5 0 0 0-2.152-.717 1 1 0 0 1-1.131-1.131 2.5 2.5 0 0 0-.717-2.152A1 1 0 0 1 3 16h4",key:"qexcha"}]],Candy=createLucideIcon("candy",__iconNode$lt);const __iconNode$ls=[["path",{d:"M12 22v-4",key:"1utk9m"}],["path",{d:"M7 12c-1.5 0-4.5 1.5-5 3 3.5 1.5 6 1 6 1-1.5 1.5-2 3.5-2 5 2.5 0 4.5-1.5 6-3 1.5 1.5 3.5 3 6 3 0-1.5-.5-3.5-2-5 0 0 2.5.5 6-1-.5-1.5-3.5-3-5-3 1.5-1 4-4 4-6-2.5 0-5.5 1.5-7 3 0-2.5-.5-5-2-7-1.5 2-2 4.5-2 7-1.5-1.5-4.5-3-7-3 0 2 2.5 5 4 6",key:"1mezod"}]],Cannabis=createLucideIcon("cannabis",__iconNode$ls);const __iconNode$lr=[["path",{d:"M10.5 5H19a2 2 0 0 1 2 2v8.5",key:"jqtk4d"}],["path",{d:"M17 11h-.5",key:"1961ue"}],["path",{d:"M19 19H5a2 2 0 0 1-2-2V7a2 2 0 0 1 2-2",key:"1keqsi"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M7 11h4",key:"1o1z6v"}],["path",{d:"M7 15h2.5",key:"1ina1g"}]],CaptionsOff=createLucideIcon("captions-off",__iconNode$lr);const __iconNode$lq=[["rect",{width:"18",height:"14",x:"3",y:"5",rx:"2",ry:"2",key:"12ruh7"}],["path",{d:"M7 15h4M15 15h2M7 11h2M13 11h4",key:"1ueiar"}]],Captions=createLucideIcon("captions",__iconNode$lq);const __iconNode$lp=[["path",{d:"m21 8-2 2-1.5-3.7A2 2 0 0 0 15.646 5H8.4a2 2 0 0 0-1.903 1.257L5 10 3 8",key:"1imjwt"}],["path",{d:"M7 14h.01",key:"1qa3f1"}],["path",{d:"M17 14h.01",key:"7oqj8z"}],["rect",{width:"18",height:"8",x:"3",y:"10",rx:"2",key:"a7itu8"}],["path",{d:"M5 18v2",key:"ppbyun"}],["path",{d:"M19 18v2",key:"gy7782"}]],CarFront=createLucideIcon("car-front",__iconNode$lp);const __iconNode$lo=[["path",{d:"M10 2h4",key:"n1abiw"}],["path",{d:"m21 8-2 2-1.5-3.7A2 2 0 0 0 15.646 5H8.4a2 2 0 0 0-1.903 1.257L5 10 3 8",key:"1imjwt"}],["path",{d:"M7 14h.01",key:"1qa3f1"}],["path",{d:"M17 14h.01",key:"7oqj8z"}],["rect",{width:"18",height:"8",x:"3",y:"10",rx:"2",key:"a7itu8"}],["path",{d:"M5 18v2",key:"ppbyun"}],["path",{d:"M19 18v2",key:"gy7782"}]],CarTaxiFront=createLucideIcon("car-taxi-front",__iconNode$lo);const __iconNode$ln=[["path",{d:"M19 17h2c.6 0 1-.4 1-1v-3c0-.9-.7-1.7-1.5-1.9C18.7 10.6 16 10 16 10s-1.3-1.4-2.2-2.3c-.5-.4-1.1-.7-1.8-.7H5c-.6 0-1.1.4-1.4.9l-1.4 2.9A3.7 3.7 0 0 0 2 12v4c0 .6.4 1 1 1h2",key:"5owen"}],["circle",{cx:"7",cy:"17",r:"2",key:"u2ysq9"}],["path",{d:"M9 17h6",key:"r8uit2"}],["circle",{cx:"17",cy:"17",r:"2",key:"axvx0g"}]],Car=createLucideIcon("car",__iconNode$ln);const __iconNode$lm=[["path",{d:"M18 19V9a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v8a2 2 0 0 0 2 2h2",key:"19jm3t"}],["path",{d:"M2 9h3a1 1 0 0 1 1 1v2a1 1 0 0 1-1 1H2",key:"13hakp"}],["path",{d:"M22 17v1a1 1 0 0 1-1 1H10v-9a1 1 0 0 1 1-1h2a1 1 0 0 1 1 1v9",key:"1crci8"}],["circle",{cx:"8",cy:"19",r:"2",key:"t8fc5s"}]],Caravan=createLucideIcon("caravan",__iconNode$lm);const __iconNode$ll=[["path",{d:"M12 14v4",key:"1thi36"}],["path",{d:"M14.172 2a2 2 0 0 1 1.414.586l3.828 3.828A2 2 0 0 1 20 7.828V20a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2z",key:"1o66bk"}],["path",{d:"M8 14h8",key:"1fgep2"}],["rect",{x:"8",y:"10",width:"8",height:"8",rx:"1",key:"1aonk6"}]],CardSim=createLucideIcon("card-sim",__iconNode$ll);const __iconNode$lk=[["path",{d:"M2.27 21.7s9.87-3.5 12.73-6.36a4.5 4.5 0 0 0-6.36-6.37C5.77 11.84 2.27 21.7 2.27 21.7zM8.64 14l-2.05-2.04M15.34 15l-2.46-2.46",key:"rfqxbe"}],["path",{d:"M22 9s-1.33-2-3.5-2C16.86 7 15 9 15 9s1.33 2 3.5 2S22 9 22 9z",key:"6b25w4"}],["path",{d:"M15 2s-2 1.33-2 3.5S15 9 15 9s2-1.84 2-3.5C17 3.33 15 2 15 2z",key:"fn65lo"}]],Carrot=createLucideIcon("carrot",__iconNode$lk);const __iconNode$lj=[["path",{d:"M10 9v7",key:"ylp826"}],["path",{d:"M14 6v10",key:"1jy4vg"}],["circle",{cx:"17.5",cy:"12.5",r:"3.5",key:"1a9481"}],["circle",{cx:"6.5",cy:"12.5",r:"3.5",key:"2jlv1r"}]],CaseLower=createLucideIcon("case-lower",__iconNode$lj);const __iconNode$li=[["path",{d:"m2 16 4.039-9.69a.5.5 0 0 1 .923 0L11 16",key:"d5nyq2"}],["path",{d:"M22 9v7",key:"pvm9v3"}],["path",{d:"M3.304 13h6.392",key:"1q3zxz"}],["circle",{cx:"18.5",cy:"12.5",r:"3.5",key:"z97x68"}]],CaseSensitive=createLucideIcon("case-sensitive",__iconNode$li);const __iconNode$lh=[["path",{d:"M15 11h4.5a1 1 0 0 1 0 5h-4a.5.5 0 0 1-.5-.5v-9a.5.5 0 0 1 .5-.5h3a1 1 0 0 1 0 5",key:"nxs35"}],["path",{d:"m2 16 4.039-9.69a.5.5 0 0 1 .923 0L11 16",key:"d5nyq2"}],["path",{d:"M3.304 13h6.392",key:"1q3zxz"}]],CaseUpper=createLucideIcon("case-upper",__iconNode$lh);const __iconNode$lg=[["rect",{width:"20",height:"16",x:"2",y:"4",rx:"2",key:"18n3k1"}],["circle",{cx:"8",cy:"10",r:"2",key:"1xl4ub"}],["path",{d:"M8 12h8",key:"1wcyev"}],["circle",{cx:"16",cy:"10",r:"2",key:"r14t7q"}],["path",{d:"m6 20 .7-2.9A1.4 1.4 0 0 1 8.1 16h7.8a1.4 1.4 0 0 1 1.4 1l.7 3",key:"l01ucn"}]],CassetteTape=createLucideIcon("cassette-tape",__iconNode$lg);const __iconNode$lf=[["path",{d:"M12 5c.67 0 1.35.09 2 .26 1.78-2 5.03-2.84 6.42-2.26 1.4.58-.42 7-.42 7 .57 1.07 1 2.24 1 3.44C21 17.9 16.97 21 12 21s-9-3-9-7.56c0-1.25.5-2.4 1-3.44 0 0-1.89-6.42-.5-7 1.39-.58 4.72.23 6.5 2.23A9.04 9.04 0 0 1 12 5Z",key:"x6xyqk"}],["path",{d:"M8 14v.5",key:"1nzgdb"}],["path",{d:"M16 14v.5",key:"1lajdz"}],["path",{d:"M11.25 16.25h1.5L12 17l-.75-.75Z",key:"12kq1m"}]],Cat=createLucideIcon("cat",__iconNode$lf);const __iconNode$le=[["path",{d:"M2 8V6a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v12a2 2 0 0 1-2 2h-6",key:"3zrzxg"}],["path",{d:"M2 12a9 9 0 0 1 8 8",key:"g6cvee"}],["path",{d:"M2 16a5 5 0 0 1 4 4",key:"1y1dii"}],["line",{x1:"2",x2:"2.01",y1:"20",y2:"20",key:"xu2jvo"}]],Cast=createLucideIcon("cast",__iconNode$le);const __iconNode$ld=[["path",{d:"M10 5V3",key:"1y54qe"}],["path",{d:"M14 5V3",key:"m6isi"}],["path",{d:"M15 21v-3a3 3 0 0 0-6 0v3",key:"lbp5hj"}],["path",{d:"M18 3v8",key:"2ollhf"}],["path",{d:"M18 5H6",key:"98imr9"}],["path",{d:"M22 11H2",key:"1lmjae"}],["path",{d:"M22 9v10a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V9",key:"1rly83"}],["path",{d:"M6 3v8",key:"csox7g"}]],Castle=createLucideIcon("castle",__iconNode$ld);const __iconNode$lc=[["path",{d:"M16.75 12h3.632a1 1 0 0 1 .894 1.447l-2.034 4.069a1 1 0 0 1-1.708.134l-2.124-2.97",key:"ir91b5"}],["path",{d:"M17.106 9.053a1 1 0 0 1 .447 1.341l-3.106 6.211a1 1 0 0 1-1.342.447L3.61 12.3a2.92 2.92 0 0 1-1.3-3.91L3.69 5.6a2.92 2.92 0 0 1 3.92-1.3z",key:"jlp8i1"}],["path",{d:"M2 19h3.76a2 2 0 0 0 1.8-1.1L9 15",key:"19bib8"}],["path",{d:"M2 21v-4",key:"l40lih"}],["path",{d:"M7 9h.01",key:"19b3jx"}]],Cctv=createLucideIcon("cctv",__iconNode$lc);const __iconNode$lb=[["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}],["path",{d:"M7 11.207a.5.5 0 0 1 .146-.353l2-2a.5.5 0 0 1 .708 0l3.292 3.292a.5.5 0 0 0 .708 0l4.292-4.292a.5.5 0 0 1 .854.353V16a1 1 0 0 1-1 1H8a1 1 0 0 1-1-1z",key:"q0gr47"}]],ChartArea=createLucideIcon("chart-area",__iconNode$lb);const __iconNode$la=[["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}],["rect",{x:"7",y:"13",width:"9",height:"4",rx:"1",key:"1iip1u"}],["rect",{x:"7",y:"5",width:"12",height:"4",rx:"1",key:"1anskk"}]],ChartBarBig=createLucideIcon("chart-bar-big",__iconNode$la);const __iconNode$l9=[["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}],["path",{d:"M7 11h8",key:"1feolt"}],["path",{d:"M7 16h3",key:"ur6vzw"}],["path",{d:"M7 6h12",key:"sz5b0d"}]],ChartBarDecreasing=createLucideIcon("chart-bar-decreasing",__iconNode$l9);const __iconNode$l8=[["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}],["path",{d:"M7 11h8",key:"1feolt"}],["path",{d:"M7 16h12",key:"wsnu98"}],["path",{d:"M7 6h3",key:"w9rmul"}]],ChartBarIncreasing=createLucideIcon("chart-bar-increasing",__iconNode$l8);const __iconNode$l7=[["path",{d:"M11 13v4",key:"vyy2rb"}],["path",{d:"M15 5v4",key:"1gx88a"}],["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}],["rect",{x:"7",y:"13",width:"9",height:"4",rx:"1",key:"1iip1u"}],["rect",{x:"7",y:"5",width:"12",height:"4",rx:"1",key:"1anskk"}]],ChartBarStacked=createLucideIcon("chart-bar-stacked",__iconNode$l7);const __iconNode$l6=[["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}],["path",{d:"M7 16h8",key:"srdodz"}],["path",{d:"M7 11h12",key:"127s9w"}],["path",{d:"M7 6h3",key:"w9rmul"}]],ChartBar=createLucideIcon("chart-bar",__iconNode$l6);const __iconNode$l5=[["path",{d:"M9 5v4",key:"14uxtq"}],["rect",{width:"4",height:"6",x:"7",y:"9",rx:"1",key:"f4fvz0"}],["path",{d:"M9 15v2",key:"r5rk32"}],["path",{d:"M17 3v2",key:"1l2re6"}],["rect",{width:"4",height:"8",x:"15",y:"5",rx:"1",key:"z38je5"}],["path",{d:"M17 13v3",key:"5l0wba"}],["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}]],ChartCandlestick=createLucideIcon("chart-candlestick",__iconNode$l5);const __iconNode$l4=[["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}],["rect",{x:"15",y:"5",width:"4",height:"12",rx:"1",key:"q8uenq"}],["rect",{x:"7",y:"8",width:"4",height:"9",rx:"1",key:"sr5ea"}]],ChartColumnBig=createLucideIcon("chart-column-big",__iconNode$l4);const __iconNode$l3=[["path",{d:"M13 17V9",key:"1fwyjl"}],["path",{d:"M18 17v-3",key:"1sqioe"}],["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}],["path",{d:"M8 17V5",key:"1wzmnc"}]],ChartColumnDecreasing=createLucideIcon("chart-column-decreasing",__iconNode$l3);const __iconNode$l2=[["path",{d:"M13 17V9",key:"1fwyjl"}],["path",{d:"M18 17V5",key:"sfb6ij"}],["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}],["path",{d:"M8 17v-3",key:"17ska0"}]],ChartColumnIncreasing=createLucideIcon("chart-column-increasing",__iconNode$l2);const __iconNode$l1=[["path",{d:"M11 13H7",key:"t0o9gq"}],["path",{d:"M19 9h-4",key:"rera1j"}],["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}],["rect",{x:"15",y:"5",width:"4",height:"12",rx:"1",key:"q8uenq"}],["rect",{x:"7",y:"8",width:"4",height:"9",rx:"1",key:"sr5ea"}]],ChartColumnStacked=createLucideIcon("chart-column-stacked",__iconNode$l1);const __iconNode$l0=[["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}],["path",{d:"M18 17V9",key:"2bz60n"}],["path",{d:"M13 17V5",key:"1frdt8"}],["path",{d:"M8 17v-3",key:"17ska0"}]],ChartColumn=createLucideIcon("chart-column",__iconNode$l0);const __iconNode$k$=[["path",{d:"M10 6h8",key:"zvc2xc"}],["path",{d:"M12 16h6",key:"yi5mkt"}],["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}],["path",{d:"M8 11h7",key:"wz2hg0"}]],ChartGantt=createLucideIcon("chart-gantt",__iconNode$k$);const __iconNode$k_=[["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}],["path",{d:"m19 9-5 5-4-4-3 3",key:"2osh9i"}]],ChartLine=createLucideIcon("chart-line",__iconNode$k_);const __iconNode$kZ=[["path",{d:"m13.11 7.664 1.78 2.672",key:"go2gg9"}],["path",{d:"m14.162 12.788-3.324 1.424",key:"11x848"}],["path",{d:"m20 4-6.06 1.515",key:"1wxxh7"}],["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}],["circle",{cx:"12",cy:"6",r:"2",key:"1jj5th"}],["circle",{cx:"16",cy:"12",r:"2",key:"4ma0v8"}],["circle",{cx:"9",cy:"15",r:"2",key:"lf2ghp"}]],ChartNetwork=createLucideIcon("chart-network",__iconNode$kZ);const __iconNode$kY=[["path",{d:"M5 21V3",key:"clc1r8"}],["path",{d:"M12 21V9",key:"uvy0l4"}],["path",{d:"M19 21v-6",key:"tkawy9"}]],ChartNoAxesColumnDecreasing=createLucideIcon("chart-no-axes-column-decreasing",__iconNode$kY);const __iconNode$kX=[["path",{d:"M5 21v-6",key:"1hz6c0"}],["path",{d:"M12 21V9",key:"uvy0l4"}],["path",{d:"M19 21V3",key:"11j9sm"}]],ChartNoAxesColumnIncreasing=createLucideIcon("chart-no-axes-column-increasing",__iconNode$kX);const __iconNode$kW=[["path",{d:"M5 21v-6",key:"1hz6c0"}],["path",{d:"M12 21V3",key:"1lcnhd"}],["path",{d:"M19 21V9",key:"unv183"}]],ChartNoAxesColumn=createLucideIcon("chart-no-axes-column",__iconNode$kW);const __iconNode$kV=[["path",{d:"M12 16v5",key:"zza2cw"}],["path",{d:"M16 14v7",key:"1g90b9"}],["path",{d:"M20 10v11",key:"1iqoj0"}],["path",{d:"m22 3-8.646 8.646a.5.5 0 0 1-.708 0L9.354 8.354a.5.5 0 0 0-.707 0L2 15",key:"1fw8x9"}],["path",{d:"M4 18v3",key:"1yp0dc"}],["path",{d:"M8 14v7",key:"n3cwzv"}]],ChartNoAxesCombined=createLucideIcon("chart-no-axes-combined",__iconNode$kV);const __iconNode$kU=[["path",{d:"M6 5h12",key:"fvfigv"}],["path",{d:"M4 12h10",key:"oujl3d"}],["path",{d:"M12 19h8",key:"baeox8"}]],ChartNoAxesGantt=createLucideIcon("chart-no-axes-gantt",__iconNode$kU);const __iconNode$kT=[["path",{d:"M21 12c.552 0 1.005-.449.95-.998a10 10 0 0 0-8.953-8.951c-.55-.055-.998.398-.998.95v8a1 1 0 0 0 1 1z",key:"pzmjnu"}],["path",{d:"M21.21 15.89A10 10 0 1 1 8 2.83",key:"k2fpak"}]],ChartPie=createLucideIcon("chart-pie",__iconNode$kT);const __iconNode$kS=[["circle",{cx:"7.5",cy:"7.5",r:".5",fill:"currentColor",key:"kqv944"}],["circle",{cx:"18.5",cy:"5.5",r:".5",fill:"currentColor",key:"lysivs"}],["circle",{cx:"11.5",cy:"11.5",r:".5",fill:"currentColor",key:"byv1b8"}],["circle",{cx:"7.5",cy:"16.5",r:".5",fill:"currentColor",key:"nkw3mc"}],["circle",{cx:"17.5",cy:"14.5",r:".5",fill:"currentColor",key:"1gjh6j"}],["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}]],ChartScatter=createLucideIcon("chart-scatter",__iconNode$kS);const __iconNode$kR=[["path",{d:"M3 3v16a2 2 0 0 0 2 2h16",key:"c24i48"}],["path",{d:"M7 16c.5-2 1.5-7 4-7 2 0 2 3 4 3 2.5 0 4.5-5 5-7",key:"lw07rv"}]],ChartSpline=createLucideIcon("chart-spline",__iconNode$kR);const __iconNode$kQ=[["path",{d:"M18 6 7 17l-5-5",key:"116fxf"}],["path",{d:"m22 10-7.5 7.5L13 16",key:"ke71qq"}]],CheckCheck=createLucideIcon("check-check",__iconNode$kQ);const __iconNode$kP=[["path",{d:"M20 4L9 15",key:"1qkx8z"}],["path",{d:"M21 19L3 19",key:"100sma"}],["path",{d:"M9 15L4 10",key:"9zxff7"}]],CheckLine=createLucideIcon("check-line",__iconNode$kP);const __iconNode$kO=[["path",{d:"M20 6 9 17l-5-5",key:"1gmf2c"}]],Check=createLucideIcon("check",__iconNode$kO);const __iconNode$kN=[["path",{d:"M17 21a1 1 0 0 0 1-1v-5.35c0-.457.316-.844.727-1.041a4 4 0 0 0-2.134-7.589 5 5 0 0 0-9.186 0 4 4 0 0 0-2.134 7.588c.411.198.727.585.727 1.041V20a1 1 0 0 0 1 1Z",key:"1qvrer"}],["path",{d:"M6 17h12",key:"1jwigz"}]],ChefHat=createLucideIcon("chef-hat",__iconNode$kN);const __iconNode$kM=[["path",{d:"M2 17a5 5 0 0 0 10 0c0-2.76-2.5-5-5-3-2.5-2-5 .24-5 3Z",key:"cvxqlc"}],["path",{d:"M12 17a5 5 0 0 0 10 0c0-2.76-2.5-5-5-3-2.5-2-5 .24-5 3Z",key:"1ostrc"}],["path",{d:"M7 14c3.22-2.91 4.29-8.75 5-12 1.66 2.38 4.94 9 5 12",key:"hqx58h"}],["path",{d:"M22 9c-4.29 0-7.14-2.33-10-7 5.71 0 10 4.67 10 7Z",key:"eykp1o"}]],Cherry=createLucideIcon("cherry",__iconNode$kM);const __iconNode$kL=[["path",{d:"M5 20a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2v1a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1z",key:"b89hwq"}],["path",{d:"M15 18c1.5-.615 3-2.461 3-4.923C18 8.769 14.5 4.462 12 2 9.5 4.462 6 8.77 6 13.077 6 15.539 7.5 17.385 9 18",key:"8jdkhx"}],["path",{d:"m16 7-2.5 2.5",key:"1jq90w"}],["path",{d:"M9 2h6",key:"1jrp98"}]],ChessBishop=createLucideIcon("chess-bishop",__iconNode$kL);const __iconNode$kK=[["path",{d:"M4 20a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v1a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1z",key:"mqzwx6"}],["path",{d:"m6.7 18-1-1C4.35 15.682 3 14.09 3 12a5 5 0 0 1 4.95-5c1.584 0 2.7.455 4.05 1.818C13.35 7.455 14.466 7 16.05 7A5 5 0 0 1 21 12c0 2.082-1.359 3.673-2.7 5l-1 1",key:"1gdt1g"}],["path",{d:"M10 4h4",key:"1xpv9s"}],["path",{d:"M12 2v6.818",key:"b17a49"}]],ChessKing=createLucideIcon("chess-king",__iconNode$kK);const __iconNode$kJ=[["path",{d:"M5 20a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2v1a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1z",key:"b89hwq"}],["path",{d:"M16.5 18c1-2 2.5-5 2.5-9a7 7 0 0 0-7-7H6.635a1 1 0 0 0-.768 1.64L7 5l-2.32 5.802a2 2 0 0 0 .95 2.526l2.87 1.456",key:"axbnlq"}],["path",{d:"m15 5 1.425-1.425",key:"15xz8w"}],["path",{d:"m17 8 1.53-1.53",key:"15zhqh"}],["path",{d:"M9.713 12.185 7 18",key:"1ocm0l"}]],ChessKnight=createLucideIcon("chess-knight",__iconNode$kJ);const __iconNode$kI=[["path",{d:"M5 20a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2v1a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1z",key:"b89hwq"}],["path",{d:"m14.5 10 1.5 8",key:"cim3qy"}],["path",{d:"M7 10h10",key:"1101jm"}],["path",{d:"m8 18 1.5-8",key:"ja3yjd"}],["circle",{cx:"12",cy:"6",r:"4",key:"1frrej"}]],ChessPawn=createLucideIcon("chess-pawn",__iconNode$kI);const __iconNode$kH=[["path",{d:"M4 20a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v1a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1z",key:"mqzwx6"}],["path",{d:"m12.474 5.943 1.567 5.34a1 1 0 0 0 1.75.328l2.616-3.402",key:"1js4gl"}],["path",{d:"m20 9-3 9",key:"r75r3f"}],["path",{d:"m5.594 8.209 2.615 3.403a1 1 0 0 0 1.75-.329l1.567-5.34",key:"1joj19"}],["path",{d:"M7 18 4 9",key:"1mfzj8"}],["circle",{cx:"12",cy:"4",r:"2",key:"muu5ef"}],["circle",{cx:"20",cy:"7",r:"2",key:"9w7p1x"}],["circle",{cx:"4",cy:"7",r:"2",key:"1d9wy8"}]],ChessQueen=createLucideIcon("chess-queen",__iconNode$kH);const __iconNode$kG=[["path",{d:"M5 20a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2v1a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1z",key:"b89hwq"}],["path",{d:"M10 2v2",key:"7u0qdc"}],["path",{d:"M14 2v2",key:"6buw04"}],["path",{d:"m17 18-1-9",key:"10nd7q"}],["path",{d:"M6 2v5a2 2 0 0 0 2 2h8a2 2 0 0 0 2-2V2",key:"uxf4yx"}],["path",{d:"M6 4h12",key:"1x2ag7"}],["path",{d:"m7 18 1-9",key:"1si9vq"}]],ChessRook=createLucideIcon("chess-rook",__iconNode$kG);const __iconNode$kF=[["path",{d:"m6 9 6 6 6-6",key:"qrunsl"}]],ChevronDown=createLucideIcon("chevron-down",__iconNode$kF);const __iconNode$kE=[["path",{d:"m17 18-6-6 6-6",key:"1yerx2"}],["path",{d:"M7 6v12",key:"1p53r6"}]],ChevronFirst=createLucideIcon("chevron-first",__iconNode$kE);const __iconNode$kD=[["path",{d:"m7 18 6-6-6-6",key:"lwmzdw"}],["path",{d:"M17 6v12",key:"1o0aio"}]],ChevronLast=createLucideIcon("chevron-last",__iconNode$kD);const __iconNode$kC=[["path",{d:"m15 18-6-6 6-6",key:"1wnfg3"}]],ChevronLeft=createLucideIcon("chevron-left",__iconNode$kC);const __iconNode$kB=[["path",{d:"m9 18 6-6-6-6",key:"mthhwq"}]],ChevronRight=createLucideIcon("chevron-right",__iconNode$kB);const __iconNode$kA=[["path",{d:"m18 15-6-6-6 6",key:"153udz"}]],ChevronUp=createLucideIcon("chevron-up",__iconNode$kA);const __iconNode$kz=[["path",{d:"m7 20 5-5 5 5",key:"13a0gw"}],["path",{d:"m7 4 5 5 5-5",key:"1kwcof"}]],ChevronsDownUp=createLucideIcon("chevrons-down-up",__iconNode$kz);const __iconNode$ky=[["path",{d:"m7 6 5 5 5-5",key:"1lc07p"}],["path",{d:"m7 13 5 5 5-5",key:"1d48rs"}]],ChevronsDown=createLucideIcon("chevrons-down",__iconNode$ky);const __iconNode$kx=[["path",{d:"M12 12h.01",key:"1mp3jc"}],["path",{d:"M16 12h.01",key:"1l6xoz"}],["path",{d:"m17 7 5 5-5 5",key:"1xlxn0"}],["path",{d:"m7 7-5 5 5 5",key:"19njba"}],["path",{d:"M8 12h.01",key:"czm47f"}]],ChevronsLeftRightEllipsis=createLucideIcon("chevrons-left-right-ellipsis",__iconNode$kx);const __iconNode$kw=[["path",{d:"m11 17-5-5 5-5",key:"13zhaf"}],["path",{d:"m18 17-5-5 5-5",key:"h8a8et"}]],ChevronsLeft=createLucideIcon("chevrons-left",__iconNode$kw);const __iconNode$kv=[["path",{d:"m9 7-5 5 5 5",key:"j5w590"}],["path",{d:"m15 7 5 5-5 5",key:"1bl6da"}]],ChevronsLeftRight=createLucideIcon("chevrons-left-right",__iconNode$kv);const __iconNode$ku=[["path",{d:"m20 17-5-5 5-5",key:"30x0n2"}],["path",{d:"m4 17 5-5-5-5",key:"16spf4"}]],ChevronsRightLeft=createLucideIcon("chevrons-right-left",__iconNode$ku);const __iconNode$kt=[["path",{d:"m6 17 5-5-5-5",key:"xnjwq"}],["path",{d:"m13 17 5-5-5-5",key:"17xmmf"}]],ChevronsRight=createLucideIcon("chevrons-right",__iconNode$kt);const __iconNode$ks=[["path",{d:"m7 15 5 5 5-5",key:"1hf1tw"}],["path",{d:"m7 9 5-5 5 5",key:"sgt6xg"}]],ChevronsUpDown=createLucideIcon("chevrons-up-down",__iconNode$ks);const __iconNode$kr=[["path",{d:"m17 11-5-5-5 5",key:"e8nh98"}],["path",{d:"m17 18-5-5-5 5",key:"2avn1x"}]],ChevronsUp=createLucideIcon("chevrons-up",__iconNode$kr);const __iconNode$kq=[["path",{d:"M10.88 21.94 15.46 14",key:"xkve6t"}],["path",{d:"M21.17 8H12",key:"19dcdn"}],["path",{d:"M3.95 6.06 8.54 14",key:"g8jz9m"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["circle",{cx:"12",cy:"12",r:"4",key:"4exip2"}]],Chromium=createLucideIcon("chromium",__iconNode$kq);const __iconNode$kp=[["path",{d:"M10 9h4",key:"u4k05v"}],["path",{d:"M12 7v5",key:"ma6bk"}],["path",{d:"M14 21v-3a2 2 0 0 0-4 0v3",key:"1rgiei"}],["path",{d:"m18 9 3.52 2.147a1 1 0 0 1 .48.854V19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2v-6.999a1 1 0 0 1 .48-.854L6 9",key:"flvdwo"}],["path",{d:"M6 21V7a1 1 0 0 1 .376-.782l5-3.999a1 1 0 0 1 1.249.001l5 4A1 1 0 0 1 18 7v14",key:"a5i0n2"}]],Church=createLucideIcon("church",__iconNode$kp);const __iconNode$ko=[["path",{d:"M12 12H3a1 1 0 0 0-1 1v2a1 1 0 0 0 1 1h13",key:"1gdiyg"}],["path",{d:"M18 8c0-2.5-2-2.5-2-5",key:"1il607"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M21 12a1 1 0 0 1 1 1v2a1 1 0 0 1-.5.866",key:"166zjj"}],["path",{d:"M22 8c0-2.5-2-2.5-2-5",key:"1gah44"}],["path",{d:"M7 12v4",key:"jqww69"}]],CigaretteOff=createLucideIcon("cigarette-off",__iconNode$ko);const __iconNode$kn=[["path",{d:"M17 12H3a1 1 0 0 0-1 1v2a1 1 0 0 0 1 1h14",key:"1mb5g1"}],["path",{d:"M18 8c0-2.5-2-2.5-2-5",key:"1il607"}],["path",{d:"M21 16a1 1 0 0 0 1-1v-2a1 1 0 0 0-1-1",key:"1yl5r7"}],["path",{d:"M22 8c0-2.5-2-2.5-2-5",key:"1gah44"}],["path",{d:"M7 12v4",key:"jqww69"}]],Cigarette=createLucideIcon("cigarette",__iconNode$kn);const __iconNode$km=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["line",{x1:"12",x2:"12",y1:"8",y2:"12",key:"1pkeuh"}],["line",{x1:"12",x2:"12.01",y1:"16",y2:"16",key:"4dfq90"}]],CircleAlert=createLucideIcon("circle-alert",__iconNode$km);const __iconNode$kl=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M12 8v8",key:"napkw2"}],["path",{d:"m8 12 4 4 4-4",key:"k98ssh"}]],CircleArrowDown=createLucideIcon("circle-arrow-down",__iconNode$kl);const __iconNode$kk=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m12 8-4 4 4 4",key:"15vm53"}],["path",{d:"M16 12H8",key:"1fr5h0"}]],CircleArrowLeft=createLucideIcon("circle-arrow-left",__iconNode$kk);const __iconNode$kj=[["path",{d:"M2 12a10 10 0 1 1 10 10",key:"1yn6ov"}],["path",{d:"m2 22 10-10",key:"28ilpk"}],["path",{d:"M8 22H2v-6",key:"sulq54"}]],CircleArrowOutDownLeft=createLucideIcon("circle-arrow-out-down-left",__iconNode$kj);const __iconNode$ki=[["path",{d:"M12 22a10 10 0 1 1 10-10",key:"130bv5"}],["path",{d:"M22 22 12 12",key:"131aw7"}],["path",{d:"M22 16v6h-6",key:"1gvm70"}]],CircleArrowOutDownRight=createLucideIcon("circle-arrow-out-down-right",__iconNode$ki);const __iconNode$kh=[["path",{d:"M2 8V2h6",key:"hiwtdz"}],["path",{d:"m2 2 10 10",key:"1oh8rs"}],["path",{d:"M12 2A10 10 0 1 1 2 12",key:"rrk4fa"}]],CircleArrowOutUpLeft=createLucideIcon("circle-arrow-out-up-left",__iconNode$kh);const __iconNode$kg=[["path",{d:"M22 12A10 10 0 1 1 12 2",key:"1fm58d"}],["path",{d:"M22 2 12 12",key:"yg2myt"}],["path",{d:"M16 2h6v6",key:"zan5cs"}]],CircleArrowOutUpRight=createLucideIcon("circle-arrow-out-up-right",__iconNode$kg);const __iconNode$kf=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m12 16 4-4-4-4",key:"1i9zcv"}],["path",{d:"M8 12h8",key:"1wcyev"}]],CircleArrowRight=createLucideIcon("circle-arrow-right",__iconNode$kf);const __iconNode$ke=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m16 12-4-4-4 4",key:"177agl"}],["path",{d:"M12 16V8",key:"1sbj14"}]],CircleArrowUp=createLucideIcon("circle-arrow-up",__iconNode$ke);const __iconNode$kd=[["path",{d:"M21.801 10A10 10 0 1 1 17 3.335",key:"yps3ct"}],["path",{d:"m9 11 3 3L22 4",key:"1pflzl"}]],CircleCheckBig=createLucideIcon("circle-check-big",__iconNode$kd);const __iconNode$kc=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],CircleCheck=createLucideIcon("circle-check",__iconNode$kc);const __iconNode$kb=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m16 10-4 4-4-4",key:"894hmk"}]],CircleChevronDown=createLucideIcon("circle-chevron-down",__iconNode$kb);const __iconNode$ka=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m14 16-4-4 4-4",key:"ojs7w8"}]],CircleChevronLeft=createLucideIcon("circle-chevron-left",__iconNode$ka);const __iconNode$k9=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m10 8 4 4-4 4",key:"1wy4r4"}]],CircleChevronRight=createLucideIcon("circle-chevron-right",__iconNode$k9);const __iconNode$k8=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m8 14 4-4 4 4",key:"fy2ptz"}]],CircleChevronUp=createLucideIcon("circle-chevron-up",__iconNode$k8);const __iconNode$k7=[["path",{d:"M10.1 2.182a10 10 0 0 1 3.8 0",key:"5ilxe3"}],["path",{d:"M13.9 21.818a10 10 0 0 1-3.8 0",key:"11zvb9"}],["path",{d:"M17.609 3.721a10 10 0 0 1 2.69 2.7",key:"1iw5b2"}],["path",{d:"M2.182 13.9a10 10 0 0 1 0-3.8",key:"c0bmvh"}],["path",{d:"M20.279 17.609a10 10 0 0 1-2.7 2.69",key:"1ruxm7"}],["path",{d:"M21.818 10.1a10 10 0 0 1 0 3.8",key:"qkgqxc"}],["path",{d:"M3.721 6.391a10 10 0 0 1 2.7-2.69",key:"1mcia2"}],["path",{d:"M6.391 20.279a10 10 0 0 1-2.69-2.7",key:"1fvljs"}]],CircleDashed=createLucideIcon("circle-dashed",__iconNode$k7);const __iconNode$k6=[["line",{x1:"8",x2:"16",y1:"12",y2:"12",key:"1jonct"}],["line",{x1:"12",x2:"12",y1:"16",y2:"16",key:"aqc6ln"}],["line",{x1:"12",x2:"12",y1:"8",y2:"8",key:"1mkcni"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],CircleDivide=createLucideIcon("circle-divide",__iconNode$k6);const __iconNode$k5=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M16 8h-6a2 2 0 1 0 0 4h4a2 2 0 1 1 0 4H8",key:"1h4pet"}],["path",{d:"M12 18V6",key:"zqpxq5"}]],CircleDollarSign=createLucideIcon("circle-dollar-sign",__iconNode$k5);const __iconNode$k4=[["path",{d:"M10.1 2.18a9.93 9.93 0 0 1 3.8 0",key:"1qdqn0"}],["path",{d:"M17.6 3.71a9.95 9.95 0 0 1 2.69 2.7",key:"1bq7p6"}],["path",{d:"M21.82 10.1a9.93 9.93 0 0 1 0 3.8",key:"1rlaqf"}],["path",{d:"M20.29 17.6a9.95 9.95 0 0 1-2.7 2.69",key:"1xk03u"}],["path",{d:"M13.9 21.82a9.94 9.94 0 0 1-3.8 0",key:"l7re25"}],["path",{d:"M6.4 20.29a9.95 9.95 0 0 1-2.69-2.7",key:"1v18p6"}],["path",{d:"M2.18 13.9a9.93 9.93 0 0 1 0-3.8",key:"xdo6bj"}],["path",{d:"M3.71 6.4a9.95 9.95 0 0 1 2.7-2.69",key:"1jjmaz"}],["circle",{cx:"12",cy:"12",r:"1",key:"41hilf"}]],CircleDotDashed=createLucideIcon("circle-dot-dashed",__iconNode$k4);const __iconNode$k3=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["circle",{cx:"12",cy:"12",r:"1",key:"41hilf"}]],CircleDot=createLucideIcon("circle-dot",__iconNode$k3);const __iconNode$k2=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M17 12h.01",key:"1m0b6t"}],["path",{d:"M12 12h.01",key:"1mp3jc"}],["path",{d:"M7 12h.01",key:"eqddd0"}]],CircleEllipsis=createLucideIcon("circle-ellipsis",__iconNode$k2);const __iconNode$k1=[["path",{d:"M7 10h10",key:"1101jm"}],["path",{d:"M7 14h10",key:"1mhdw3"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],CircleEqual=createLucideIcon("circle-equal",__iconNode$k1);const __iconNode$k0=[["path",{d:"M12 2a10 10 0 0 1 7.38 16.75",key:"175t95"}],["path",{d:"m16 12-4-4-4 4",key:"177agl"}],["path",{d:"M12 16V8",key:"1sbj14"}],["path",{d:"M2.5 8.875a10 10 0 0 0-.5 3",key:"1vce0s"}],["path",{d:"M2.83 16a10 10 0 0 0 2.43 3.4",key:"o3fkw4"}],["path",{d:"M4.636 5.235a10 10 0 0 1 .891-.857",key:"1szpfk"}],["path",{d:"M8.644 21.42a10 10 0 0 0 7.631-.38",key:"9yhvd4"}]],CircleFadingArrowUp=createLucideIcon("circle-fading-arrow-up",__iconNode$k0);const __iconNode$j$=[["path",{d:"M12 2a10 10 0 0 1 7.38 16.75",key:"175t95"}],["path",{d:"M12 8v8",key:"napkw2"}],["path",{d:"M16 12H8",key:"1fr5h0"}],["path",{d:"M2.5 8.875a10 10 0 0 0-.5 3",key:"1vce0s"}],["path",{d:"M2.83 16a10 10 0 0 0 2.43 3.4",key:"o3fkw4"}],["path",{d:"M4.636 5.235a10 10 0 0 1 .891-.857",key:"1szpfk"}],["path",{d:"M8.644 21.42a10 10 0 0 0 7.631-.38",key:"9yhvd4"}]],CircleFadingPlus=createLucideIcon("circle-fading-plus",__iconNode$j$);const __iconNode$j_=[["path",{d:"M15.6 2.7a10 10 0 1 0 5.7 5.7",key:"1e0p6d"}],["circle",{cx:"12",cy:"12",r:"2",key:"1c9p78"}],["path",{d:"M13.4 10.6 19 5",key:"1kr7tw"}]],CircleGauge=createLucideIcon("circle-gauge",__iconNode$j_);const __iconNode$jZ=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M8 12h8",key:"1wcyev"}]],CircleMinus=createLucideIcon("circle-minus",__iconNode$jZ);const __iconNode$jY=[["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M8.35 2.69A10 10 0 0 1 21.3 15.65",key:"1pfsoa"}],["path",{d:"M19.08 19.08A10 10 0 1 1 4.92 4.92",key:"1ablyi"}]],CircleOff=createLucideIcon("circle-off",__iconNode$jY);const __iconNode$jX=[["path",{d:"M12.656 7H13a3 3 0 0 1 2.984 3.307",key:"1sjx87"}],["path",{d:"M13 13H9",key:"e2beee"}],["path",{d:"M19.071 19.071A1 1 0 0 1 4.93 4.93",key:"1kb595"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M8.357 2.687a10 10 0 0 1 12.956 12.956",key:"5bsfdx"}],["path",{d:"M9 17V9",key:"ojradj"}]],CircleParkingOff=createLucideIcon("circle-parking-off",__iconNode$jX);const __iconNode$jW=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M9 17V7h4a3 3 0 0 1 0 6H9",key:"1dfk2c"}]],CircleParking=createLucideIcon("circle-parking",__iconNode$jW);const __iconNode$jV=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["line",{x1:"10",x2:"10",y1:"15",y2:"9",key:"c1nkhi"}],["line",{x1:"14",x2:"14",y1:"15",y2:"9",key:"h65svq"}]],CirclePause=createLucideIcon("circle-pause",__iconNode$jV);const __iconNode$jU=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m15 9-6 6",key:"1uzhvr"}],["path",{d:"M9 9h.01",key:"1q5me6"}],["path",{d:"M15 15h.01",key:"lqbp3k"}]],CirclePercent=createLucideIcon("circle-percent",__iconNode$jU);const __iconNode$jT=[["path",{d:"M9 9.003a1 1 0 0 1 1.517-.859l4.997 2.997a1 1 0 0 1 0 1.718l-4.997 2.997A1 1 0 0 1 9 14.996z",key:"kmsa83"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],CirclePlay=createLucideIcon("circle-play",__iconNode$jT);const __iconNode$jS=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M8 12h8",key:"1wcyev"}],["path",{d:"M12 8v8",key:"napkw2"}]],CirclePlus=createLucideIcon("circle-plus",__iconNode$jS);const __iconNode$jR=[["path",{d:"M10 16V9.5a1 1 0 0 1 5 0",key:"1i1are"}],["path",{d:"M8 12h4",key:"qz6y1c"}],["path",{d:"M8 16h7",key:"sbedsn"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],CirclePoundSterling=createLucideIcon("circle-pound-sterling",__iconNode$jR);const __iconNode$jQ=[["path",{d:"M12 7v4",key:"xawao1"}],["path",{d:"M7.998 9.003a5 5 0 1 0 8-.005",key:"1pek45"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],CirclePower=createLucideIcon("circle-power",__iconNode$jQ);const __iconNode$jP=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3",key:"1u773s"}],["path",{d:"M12 17h.01",key:"p32p05"}]],CircleQuestionMark=createLucideIcon("circle-question-mark",__iconNode$jP);const __iconNode$jO=[["path",{d:"M22 2 2 22",key:"y4kqgn"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],CircleSlash2=createLucideIcon("circle-slash-2",__iconNode$jO);const __iconNode$jN=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["line",{x1:"9",x2:"15",y1:"15",y2:"9",key:"1dfufj"}]],CircleSlash=createLucideIcon("circle-slash",__iconNode$jN);const __iconNode$jM=[["circle",{cx:"12",cy:"12",r:"6",key:"1vlfrh"}]],CircleSmall=createLucideIcon("circle-small",__iconNode$jM);const __iconNode$jL=[["path",{d:"M11.051 7.616a1 1 0 0 1 1.909.024l.737 1.452a1 1 0 0 0 .737.535l1.634.256a1 1 0 0 1 .588 1.806l-1.172 1.168a1 1 0 0 0-.282.866l.259 1.613a1 1 0 0 1-1.541 1.134l-1.465-.75a1 1 0 0 0-.912 0l-1.465.75a1 1 0 0 1-1.539-1.133l.258-1.613a1 1 0 0 0-.282-.867l-1.156-1.152a1 1 0 0 1 .572-1.822l1.633-.256a1 1 0 0 0 .737-.535z",key:"285bvi"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],CircleStar=createLucideIcon("circle-star",__iconNode$jL);const __iconNode$jK=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["rect",{x:"9",y:"9",width:"6",height:"6",rx:"1",key:"1ssd4o"}]],CircleStop=createLucideIcon("circle-stop",__iconNode$jK);const __iconNode$jJ=[["path",{d:"M18 20a6 6 0 0 0-12 0",key:"1qehca"}],["circle",{cx:"12",cy:"10",r:"4",key:"1h16sb"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],CircleUserRound=createLucideIcon("circle-user-round",__iconNode$jJ);const __iconNode$jI=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["circle",{cx:"12",cy:"10",r:"3",key:"ilqhr7"}],["path",{d:"M7 20.662V19a2 2 0 0 1 2-2h6a2 2 0 0 1 2 2v1.662",key:"154egf"}]],CircleUser=createLucideIcon("circle-user",__iconNode$jI);const __iconNode$jH=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m15 9-6 6",key:"1uzhvr"}],["path",{d:"m9 9 6 6",key:"z0biqf"}]],CircleX=createLucideIcon("circle-x",__iconNode$jH);const __iconNode$jG=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Circle=createLucideIcon("circle",__iconNode$jG);const __iconNode$jF=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M11 9h4a2 2 0 0 0 2-2V3",key:"1ve2rv"}],["circle",{cx:"9",cy:"9",r:"2",key:"af1f0g"}],["path",{d:"M7 21v-4a2 2 0 0 1 2-2h4",key:"1fwkro"}],["circle",{cx:"15",cy:"15",r:"2",key:"3i40o0"}]],CircuitBoard=createLucideIcon("circuit-board",__iconNode$jF);const __iconNode$jE=[["path",{d:"M21.66 17.67a1.08 1.08 0 0 1-.04 1.6A12 12 0 0 1 4.73 2.38a1.1 1.1 0 0 1 1.61-.04z",key:"4ite01"}],["path",{d:"M19.65 15.66A8 8 0 0 1 8.35 4.34",key:"1gxipu"}],["path",{d:"m14 10-5.5 5.5",key:"92pfem"}],["path",{d:"M14 17.85V10H6.15",key:"xqmtsk"}]],Citrus=createLucideIcon("citrus",__iconNode$jE);const __iconNode$jD=[["path",{d:"M20.2 6 3 11l-.9-2.4c-.3-1.1.3-2.2 1.3-2.5l13.5-4c1.1-.3 2.2.3 2.5 1.3Z",key:"1tn4o7"}],["path",{d:"m6.2 5.3 3.1 3.9",key:"iuk76l"}],["path",{d:"m12.4 3.4 3.1 4",key:"6hsd6n"}],["path",{d:"M3 11h18v8a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2Z",key:"ltgou9"}]],Clapperboard=createLucideIcon("clapperboard",__iconNode$jD);const __iconNode$jC=[["rect",{width:"8",height:"4",x:"8",y:"2",rx:"1",ry:"1",key:"tgr4d6"}],["path",{d:"M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2",key:"116196"}],["path",{d:"m9 14 2 2 4-4",key:"df797q"}]],ClipboardCheck=createLucideIcon("clipboard-check",__iconNode$jC);const __iconNode$jB=[["path",{d:"M16 14v2.2l1.6 1",key:"fo4ql5"}],["path",{d:"M16 4h2a2 2 0 0 1 2 2v.832",key:"1ujtp2"}],["path",{d:"M8 4H6a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h2",key:"qvpao1"}],["circle",{cx:"16",cy:"16",r:"6",key:"qoo3c4"}],["rect",{x:"8",y:"2",width:"8",height:"4",rx:"1",key:"ublpy"}]],ClipboardClock=createLucideIcon("clipboard-clock",__iconNode$jB);const __iconNode$jA=[["rect",{width:"8",height:"4",x:"8",y:"2",rx:"1",ry:"1",key:"tgr4d6"}],["path",{d:"M8 4H6a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-2",key:"4jdomd"}],["path",{d:"M16 4h2a2 2 0 0 1 2 2v4",key:"3hqy98"}],["path",{d:"M21 14H11",key:"1bme5i"}],["path",{d:"m15 10-4 4 4 4",key:"5dvupr"}]],ClipboardCopy=createLucideIcon("clipboard-copy",__iconNode$jA);const __iconNode$jz=[["rect",{width:"8",height:"4",x:"8",y:"2",rx:"1",ry:"1",key:"tgr4d6"}],["path",{d:"M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2",key:"116196"}],["path",{d:"M12 11h4",key:"1jrz19"}],["path",{d:"M12 16h4",key:"n85exb"}],["path",{d:"M8 11h.01",key:"1dfujw"}],["path",{d:"M8 16h.01",key:"18s6g9"}]],ClipboardList=createLucideIcon("clipboard-list",__iconNode$jz);const __iconNode$jy=[["rect",{width:"8",height:"4",x:"8",y:"2",rx:"1",ry:"1",key:"tgr4d6"}],["path",{d:"M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2",key:"116196"}],["path",{d:"M9 14h6",key:"159ibu"}]],ClipboardMinus=createLucideIcon("clipboard-minus",__iconNode$jy);const __iconNode$jx=[["path",{d:"M11 14h10",key:"1w8e9d"}],["path",{d:"M16 4h2a2 2 0 0 1 2 2v1.344",key:"1e62lh"}],["path",{d:"m17 18 4-4-4-4",key:"z2g111"}],["path",{d:"M8 4H6a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h12a2 2 0 0 0 1.793-1.113",key:"bjbb7m"}],["rect",{x:"8",y:"2",width:"8",height:"4",rx:"1",key:"ublpy"}]],ClipboardPaste=createLucideIcon("clipboard-paste",__iconNode$jx);const __iconNode$jw=[["rect",{width:"8",height:"4",x:"8",y:"2",rx:"1",key:"1oijnt"}],["path",{d:"M8 4H6a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-.5",key:"1but9f"}],["path",{d:"M16 4h2a2 2 0 0 1 1.73 1",key:"1p8n7l"}],["path",{d:"M8 18h1",key:"13wk12"}],["path",{d:"M21.378 12.626a1 1 0 0 0-3.004-3.004l-4.01 4.012a2 2 0 0 0-.506.854l-.837 2.87a.5.5 0 0 0 .62.62l2.87-.837a2 2 0 0 0 .854-.506z",key:"2t3380"}]],ClipboardPenLine=createLucideIcon("clipboard-pen-line",__iconNode$jw);const __iconNode$jv=[["rect",{width:"8",height:"4",x:"8",y:"2",rx:"1",key:"1oijnt"}],["path",{d:"M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2h-5.5",key:"cereej"}],["path",{d:"M4 13.5V6a2 2 0 0 1 2-2h2",key:"5ua5vh"}],["path",{d:"M13.378 15.626a1 1 0 1 0-3.004-3.004l-5.01 5.012a2 2 0 0 0-.506.854l-.837 2.87a.5.5 0 0 0 .62.62l2.87-.837a2 2 0 0 0 .854-.506z",key:"1y4qbx"}]],ClipboardPen=createLucideIcon("clipboard-pen",__iconNode$jv);const __iconNode$ju=[["rect",{width:"8",height:"4",x:"8",y:"2",rx:"1",ry:"1",key:"tgr4d6"}],["path",{d:"M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2",key:"116196"}],["path",{d:"M9 14h6",key:"159ibu"}],["path",{d:"M12 17v-6",key:"1y8rbf"}]],ClipboardPlus=createLucideIcon("clipboard-plus",__iconNode$ju);const __iconNode$jt=[["rect",{width:"8",height:"4",x:"8",y:"2",rx:"1",ry:"1",key:"tgr4d6"}],["path",{d:"M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2",key:"116196"}],["path",{d:"M9 12v-1h6v1",key:"iehl6m"}],["path",{d:"M11 17h2",key:"12w5me"}],["path",{d:"M12 11v6",key:"1bwqyc"}]],ClipboardType=createLucideIcon("clipboard-type",__iconNode$jt);const __iconNode$js=[["rect",{width:"8",height:"4",x:"8",y:"2",rx:"1",ry:"1",key:"tgr4d6"}],["path",{d:"M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2",key:"116196"}],["path",{d:"m15 11-6 6",key:"1toa9n"}],["path",{d:"m9 11 6 6",key:"wlibny"}]],ClipboardX=createLucideIcon("clipboard-x",__iconNode$js);const __iconNode$jr=[["rect",{width:"8",height:"4",x:"8",y:"2",rx:"1",ry:"1",key:"tgr4d6"}],["path",{d:"M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2",key:"116196"}]],Clipboard=createLucideIcon("clipboard",__iconNode$jr);const __iconNode$jq=[["path",{d:"M12 6v6l2-4",key:"miptyd"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Clock1=createLucideIcon("clock-1",__iconNode$jq);const __iconNode$jp=[["path",{d:"M12 6v6l-4-2",key:"cedpoo"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Clock10=createLucideIcon("clock-10",__iconNode$jp);const __iconNode$jo=[["path",{d:"M12 6v6l-2-4",key:"ns39ag"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Clock11=createLucideIcon("clock-11",__iconNode$jo);const __iconNode$jn=[["path",{d:"M12 6v6",key:"1ipuwl"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Clock12=createLucideIcon("clock-12",__iconNode$jn);const __iconNode$jm=[["path",{d:"M12 6v6l4-2",key:"1r2kuh"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Clock2=createLucideIcon("clock-2",__iconNode$jm);const __iconNode$jl=[["path",{d:"M12 6v6h4",key:"135r8i"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Clock3=createLucideIcon("clock-3",__iconNode$jl);const __iconNode$jk=[["path",{d:"M12 6v6l4 2",key:"mmk7yg"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Clock4=createLucideIcon("clock-4",__iconNode$jk);const __iconNode$jj=[["path",{d:"M12 6v6l2 4",key:"1287s9"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Clock5=createLucideIcon("clock-5",__iconNode$jj);const __iconNode$ji=[["path",{d:"M12 6v10",key:"wf7rdh"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Clock6=createLucideIcon("clock-6",__iconNode$ji);const __iconNode$jh=[["path",{d:"M12 6v6l-2 4",key:"1095bu"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Clock7=createLucideIcon("clock-7",__iconNode$jh);const __iconNode$jg=[["path",{d:"M12 6v6l-4 2",key:"imc3wl"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Clock8=createLucideIcon("clock-8",__iconNode$jg);const __iconNode$jf=[["path",{d:"M12 6v6H8",key:"u39vzm"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Clock9=createLucideIcon("clock-9",__iconNode$jf);const __iconNode$je=[["path",{d:"M12 6v6l2 1",key:"19cm8n"}],["path",{d:"M12.337 21.994a10 10 0 1 1 9.588-8.767",key:"28moa"}],["path",{d:"m14 18 4 4 4-4",key:"1waygx"}],["path",{d:"M18 14v8",key:"irew45"}]],ClockArrowDown=createLucideIcon("clock-arrow-down",__iconNode$je);const __iconNode$jd=[["path",{d:"M12 6v6l4 2",key:"mmk7yg"}],["path",{d:"M20 12v5",key:"12wsvk"}],["path",{d:"M20 21h.01",key:"1p6o6n"}],["path",{d:"M21.25 8.2A10 10 0 1 0 16 21.16",key:"17fp9f"}]],ClockAlert=createLucideIcon("clock-alert",__iconNode$jd);const __iconNode$jc=[["path",{d:"M12 6v6l1.56.78",key:"14ed3g"}],["path",{d:"M13.227 21.925a10 10 0 1 1 8.767-9.588",key:"jwkls1"}],["path",{d:"m14 18 4-4 4 4",key:"ftkppy"}],["path",{d:"M18 22v-8",key:"su0gjh"}]],ClockArrowUp=createLucideIcon("clock-arrow-up",__iconNode$jc);const __iconNode$jb=[["path",{d:"M12 6v6l4 2",key:"mmk7yg"}],["path",{d:"M22 12a10 10 0 1 0-11 9.95",key:"17dhok"}],["path",{d:"m22 16-5.5 5.5L14 19",key:"1eibut"}]],ClockCheck=createLucideIcon("clock-check",__iconNode$jb);const __iconNode$ja=[["path",{d:"M12 2a10 10 0 0 1 7.38 16.75",key:"175t95"}],["path",{d:"M12 6v6l4 2",key:"mmk7yg"}],["path",{d:"M2.5 8.875a10 10 0 0 0-.5 3",key:"1vce0s"}],["path",{d:"M2.83 16a10 10 0 0 0 2.43 3.4",key:"o3fkw4"}],["path",{d:"M4.636 5.235a10 10 0 0 1 .891-.857",key:"1szpfk"}],["path",{d:"M8.644 21.42a10 10 0 0 0 7.631-.38",key:"9yhvd4"}]],ClockFading=createLucideIcon("clock-fading",__iconNode$ja);const __iconNode$j9=[["path",{d:"M12 6v6l3.644 1.822",key:"1jmett"}],["path",{d:"M16 19h6",key:"xwg31i"}],["path",{d:"M19 16v6",key:"tddt3s"}],["path",{d:"M21.92 13.267a10 10 0 1 0-8.653 8.653",key:"1u0osk"}]],ClockPlus=createLucideIcon("clock-plus",__iconNode$j9);const __iconNode$j8=[["path",{d:"M12 6v6l4 2",key:"mmk7yg"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Clock=createLucideIcon("clock",__iconNode$j8);const __iconNode$j7=[["path",{d:"M10 9.17a3 3 0 1 0 0 5.66",key:"h9wayk"}],["path",{d:"M17 9.17a3 3 0 1 0 0 5.66",key:"1v6zke"}],["rect",{x:"2",y:"5",width:"20",height:"14",rx:"2",key:"qneu4z"}]],ClosedCaption=createLucideIcon("closed-caption",__iconNode$j7);const __iconNode$j6=[["path",{d:"M12 12v4",key:"tww15h"}],["path",{d:"M12 20h.01",key:"zekei9"}],["path",{d:"M17 18h.5a1 1 0 0 0 0-9h-1.79A7 7 0 1 0 7 17.708",key:"xsb5ju"}]],CloudAlert=createLucideIcon("cloud-alert",__iconNode$j6);const __iconNode$j5=[["path",{d:"m17 15-5.5 5.5L9 18",key:"15q87x"}],["path",{d:"M5 17.743A7 7 0 1 1 15.71 10h1.79a4.5 4.5 0 0 1 1.5 8.742",key:"9ho6ki"}]],CloudCheck=createLucideIcon("cloud-check",__iconNode$j5);const __iconNode$j4=[["path",{d:"m10.852 19.772-.383.924",key:"r7sl7d"}],["path",{d:"m13.148 14.228.383-.923",key:"1d5zpm"}],["path",{d:"M13.148 19.772a3 3 0 1 0-2.296-5.544l-.383-.923",key:"1ydik7"}],["path",{d:"m13.53 20.696-.382-.924a3 3 0 1 1-2.296-5.544",key:"1m1vsf"}],["path",{d:"m14.772 15.852.923-.383",key:"660p6e"}],["path",{d:"m14.772 18.148.923.383",key:"hrcpis"}],["path",{d:"M4.2 15.1a7 7 0 1 1 9.93-9.858A7 7 0 0 1 15.71 8h1.79a4.5 4.5 0 0 1 2.5 8.2",key:"j2q98n"}],["path",{d:"m9.228 15.852-.923-.383",key:"1p9ong"}],["path",{d:"m9.228 18.148-.923.383",key:"6558rz"}]],CloudCog=createLucideIcon("cloud-cog",__iconNode$j4);const __iconNode$j3=[["path",{d:"M12 13v8l-4-4",key:"1f5nwf"}],["path",{d:"m12 21 4-4",key:"1lfcce"}],["path",{d:"M4.393 15.269A7 7 0 1 1 15.71 8h1.79a4.5 4.5 0 0 1 2.436 8.284",key:"ui1hmy"}]],CloudDownload=createLucideIcon("cloud-download",__iconNode$j3);const __iconNode$j2=[["path",{d:"M4 14.899A7 7 0 1 1 15.71 8h1.79a4.5 4.5 0 0 1 2.5 8.242",key:"1pljnt"}],["path",{d:"M8 19v1",key:"1dk2by"}],["path",{d:"M8 14v1",key:"84yxot"}],["path",{d:"M16 19v1",key:"v220m7"}],["path",{d:"M16 14v1",key:"g12gj6"}],["path",{d:"M12 21v1",key:"q8vafk"}],["path",{d:"M12 16v1",key:"1mx6rx"}]],CloudDrizzle=createLucideIcon("cloud-drizzle",__iconNode$j2);const __iconNode$j1=[["path",{d:"M4 14.899A7 7 0 1 1 15.71 8h1.79a4.5 4.5 0 0 1 2.5 8.242",key:"1pljnt"}],["path",{d:"M16 17H7",key:"pygtm1"}],["path",{d:"M17 21H9",key:"1u2q02"}]],CloudFog=createLucideIcon("cloud-fog",__iconNode$j1);const __iconNode$j0=[["path",{d:"M4 14.899A7 7 0 1 1 15.71 8h1.79a4.5 4.5 0 0 1 2.5 8.242",key:"1pljnt"}],["path",{d:"M16 14v2",key:"a1is7l"}],["path",{d:"M8 14v2",key:"1e9m6t"}],["path",{d:"M16 20h.01",key:"xwek51"}],["path",{d:"M8 20h.01",key:"1vjney"}],["path",{d:"M12 16v2",key:"z66u1j"}],["path",{d:"M12 22h.01",key:"1urd7a"}]],CloudHail=createLucideIcon("cloud-hail",__iconNode$j0);const __iconNode$i$=[["path",{d:"M6 16.326A7 7 0 1 1 15.71 8h1.79a4.5 4.5 0 0 1 .5 8.973",key:"1cez44"}],["path",{d:"m13 12-3 5h4l-3 5",key:"1t22er"}]],CloudLightning=createLucideIcon("cloud-lightning",__iconNode$i$);const __iconNode$i_=[["path",{d:"M11 20v2",key:"174qtz"}],["path",{d:"M18.376 14.512a6 6 0 0 0 3.461-4.127c.148-.625-.659-.97-1.248-.714a4 4 0 0 1-5.259-5.26c.255-.589-.09-1.395-.716-1.248a6 6 0 0 0-4.594 5.36",key:"zwnc1e"}],["path",{d:"M3 20a5 5 0 1 1 8.9-4H13a3 3 0 0 1 2 5.24",key:"1qmrp3"}],["path",{d:"M7 19v2",key:"12npes"}]],CloudMoonRain=createLucideIcon("cloud-moon-rain",__iconNode$i_);const __iconNode$iZ=[["path",{d:"M13 16a3 3 0 0 1 0 6H7a5 5 0 1 1 4.9-6z",key:"ie2ih4"}],["path",{d:"M18.376 14.512a6 6 0 0 0 3.461-4.127c.148-.625-.659-.97-1.248-.714a4 4 0 0 1-5.259-5.26c.255-.589-.09-1.395-.716-1.248a6 6 0 0 0-4.594 5.36",key:"zwnc1e"}]],CloudMoon=createLucideIcon("cloud-moon",__iconNode$iZ);const __iconNode$iY=[["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M5.782 5.782A7 7 0 0 0 9 19h8.5a4.5 4.5 0 0 0 1.307-.193",key:"yfwify"}],["path",{d:"M21.532 16.5A4.5 4.5 0 0 0 17.5 10h-1.79A7.008 7.008 0 0 0 10 5.07",key:"jlfiyv"}]],CloudOff=createLucideIcon("cloud-off",__iconNode$iY);const __iconNode$iX=[["path",{d:"M4 14.899A7 7 0 1 1 15.71 8h1.79a4.5 4.5 0 0 1 2.5 8.242",key:"1pljnt"}],["path",{d:"M16 14v6",key:"1j4efv"}],["path",{d:"M8 14v6",key:"17c4r9"}],["path",{d:"M12 16v6",key:"c8a4gj"}]],CloudRain=createLucideIcon("cloud-rain",__iconNode$iX);const __iconNode$iW=[["path",{d:"M4 14.899A7 7 0 1 1 15.71 8h1.79a4.5 4.5 0 0 1 2.5 8.242",key:"1pljnt"}],["path",{d:"m9.2 22 3-7",key:"sb5f6j"}],["path",{d:"m9 13-3 7",key:"500co5"}],["path",{d:"m17 13-3 7",key:"8t2fiy"}]],CloudRainWind=createLucideIcon("cloud-rain-wind",__iconNode$iW);const __iconNode$iV=[["path",{d:"M4 14.899A7 7 0 1 1 15.71 8h1.79a4.5 4.5 0 0 1 2.5 8.242",key:"1pljnt"}],["path",{d:"M8 15h.01",key:"a7atzg"}],["path",{d:"M8 19h.01",key:"puxtts"}],["path",{d:"M12 17h.01",key:"p32p05"}],["path",{d:"M12 21h.01",key:"h35vbk"}],["path",{d:"M16 15h.01",key:"rnfrdf"}],["path",{d:"M16 19h.01",key:"1vcnzz"}]],CloudSnow=createLucideIcon("cloud-snow",__iconNode$iV);const __iconNode$iU=[["path",{d:"M12 2v2",key:"tus03m"}],["path",{d:"m4.93 4.93 1.41 1.41",key:"149t6j"}],["path",{d:"M20 12h2",key:"1q8mjw"}],["path",{d:"m19.07 4.93-1.41 1.41",key:"1shlcs"}],["path",{d:"M15.947 12.65a4 4 0 0 0-5.925-4.128",key:"dpwdj0"}],["path",{d:"M3 20a5 5 0 1 1 8.9-4H13a3 3 0 0 1 2 5.24",key:"1qmrp3"}],["path",{d:"M11 20v2",key:"174qtz"}],["path",{d:"M7 19v2",key:"12npes"}]],CloudSunRain=createLucideIcon("cloud-sun-rain",__iconNode$iU);const __iconNode$iT=[["path",{d:"M12 2v2",key:"tus03m"}],["path",{d:"m4.93 4.93 1.41 1.41",key:"149t6j"}],["path",{d:"M20 12h2",key:"1q8mjw"}],["path",{d:"m19.07 4.93-1.41 1.41",key:"1shlcs"}],["path",{d:"M15.947 12.65a4 4 0 0 0-5.925-4.128",key:"dpwdj0"}],["path",{d:"M13 22H7a5 5 0 1 1 4.9-6H13a3 3 0 0 1 0 6Z",key:"s09mg5"}]],CloudSun=createLucideIcon("cloud-sun",__iconNode$iT);const __iconNode$iS=[["path",{d:"M12 13v8",key:"1l5pq0"}],["path",{d:"M4 14.899A7 7 0 1 1 15.71 8h1.79a4.5 4.5 0 0 1 2.5 8.242",key:"1pljnt"}],["path",{d:"m8 17 4-4 4 4",key:"1quai1"}]],CloudUpload=createLucideIcon("cloud-upload",__iconNode$iS);const __iconNode$iR=[["path",{d:"M17.5 19H9a7 7 0 1 1 6.71-9h1.79a4.5 4.5 0 1 1 0 9Z",key:"p7xjir"}]],Cloud=createLucideIcon("cloud",__iconNode$iR);const __iconNode$iQ=[["path",{d:"M17.5 21H9a7 7 0 1 1 6.71-9h1.79a4.5 4.5 0 1 1 0 9Z",key:"gqqjvc"}],["path",{d:"M22 10a3 3 0 0 0-3-3h-2.207a5.502 5.502 0 0 0-10.702.5",key:"1p2s76"}]],Cloudy=createLucideIcon("cloudy",__iconNode$iQ);const __iconNode$iP=[["path",{d:"M16.17 7.83 2 22",key:"t58vo8"}],["path",{d:"M4.02 12a2.827 2.827 0 1 1 3.81-4.17A2.827 2.827 0 1 1 12 4.02a2.827 2.827 0 1 1 4.17 3.81A2.827 2.827 0 1 1 19.98 12a2.827 2.827 0 1 1-3.81 4.17A2.827 2.827 0 1 1 12 19.98a2.827 2.827 0 1 1-4.17-3.81A1 1 0 1 1 4 12",key:"17k36q"}],["path",{d:"m7.83 7.83 8.34 8.34",key:"1d7sxk"}]],Clover=createLucideIcon("clover",__iconNode$iP);const __iconNode$iO=[["path",{d:"M17.28 9.05a5.5 5.5 0 1 0-10.56 0A5.5 5.5 0 1 0 12 17.66a5.5 5.5 0 1 0 5.28-8.6Z",key:"27yuqz"}],["path",{d:"M12 17.66L12 22",key:"ogfahf"}]],Club=createLucideIcon("club",__iconNode$iO);const __iconNode$iN=[["path",{d:"m18 16 4-4-4-4",key:"1inbqp"}],["path",{d:"m6 8-4 4 4 4",key:"15zrgr"}],["path",{d:"m14.5 4-5 16",key:"e7oirm"}]],CodeXml=createLucideIcon("code-xml",__iconNode$iN);const __iconNode$iM=[["path",{d:"m16 18 6-6-6-6",key:"eg8j8"}],["path",{d:"m8 6-6 6 6 6",key:"ppft3o"}]],Code=createLucideIcon("code",__iconNode$iM);const __iconNode$iL=[["polygon",{points:"12 2 22 8.5 22 15.5 12 22 2 15.5 2 8.5 12 2",key:"srzb37"}],["line",{x1:"12",x2:"12",y1:"22",y2:"15.5",key:"1t73f2"}],["polyline",{points:"22 8.5 12 15.5 2 8.5",key:"ajlxae"}],["polyline",{points:"2 15.5 12 8.5 22 15.5",key:"susrui"}],["line",{x1:"12",x2:"12",y1:"2",y2:"8.5",key:"2cldga"}]],Codepen=createLucideIcon("codepen",__iconNode$iL);const __iconNode$iK=[["path",{d:"M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z",key:"yt0hxn"}],["polyline",{points:"7.5 4.21 12 6.81 16.5 4.21",key:"fabo96"}],["polyline",{points:"7.5 19.79 7.5 14.6 3 12",key:"z377f1"}],["polyline",{points:"21 12 16.5 14.6 16.5 19.79",key:"9nrev1"}],["polyline",{points:"3.27 6.96 12 12.01 20.73 6.96",key:"1180pa"}],["line",{x1:"12",x2:"12",y1:"22.08",y2:"12",key:"3z3uq6"}]],Codesandbox=createLucideIcon("codesandbox",__iconNode$iK);const __iconNode$iJ=[["path",{d:"M10 2v2",key:"7u0qdc"}],["path",{d:"M14 2v2",key:"6buw04"}],["path",{d:"M16 8a1 1 0 0 1 1 1v8a4 4 0 0 1-4 4H7a4 4 0 0 1-4-4V9a1 1 0 0 1 1-1h14a4 4 0 1 1 0 8h-1",key:"pwadti"}],["path",{d:"M6 2v2",key:"colzsn"}]],Coffee=createLucideIcon("coffee",__iconNode$iJ);const __iconNode$iI=[["path",{d:"M11 10.27 7 3.34",key:"16pf9h"}],["path",{d:"m11 13.73-4 6.93",key:"794ttg"}],["path",{d:"M12 22v-2",key:"1osdcq"}],["path",{d:"M12 2v2",key:"tus03m"}],["path",{d:"M14 12h8",key:"4f43i9"}],["path",{d:"m17 20.66-1-1.73",key:"eq3orb"}],["path",{d:"m17 3.34-1 1.73",key:"2wel8s"}],["path",{d:"M2 12h2",key:"1t8f8n"}],["path",{d:"m20.66 17-1.73-1",key:"sg0v6f"}],["path",{d:"m20.66 7-1.73 1",key:"1ow05n"}],["path",{d:"m3.34 17 1.73-1",key:"nuk764"}],["path",{d:"m3.34 7 1.73 1",key:"1ulond"}],["circle",{cx:"12",cy:"12",r:"2",key:"1c9p78"}],["circle",{cx:"12",cy:"12",r:"8",key:"46899m"}]],Cog=createLucideIcon("cog",__iconNode$iI);const __iconNode$iH=[["circle",{cx:"8",cy:"8",r:"6",key:"3yglwk"}],["path",{d:"M18.09 10.37A6 6 0 1 1 10.34 18",key:"t5s6rm"}],["path",{d:"M7 6h1v4",key:"1obek4"}],["path",{d:"m16.71 13.88.7.71-2.82 2.82",key:"1rbuyh"}]],Coins=createLucideIcon("coins",__iconNode$iH);const __iconNode$iG=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M12 3v18",key:"108xh3"}]],Columns2=createLucideIcon("columns-2",__iconNode$iG);const __iconNode$iF=[["path",{d:"M10.5 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v5.5",key:"1g2yzs"}],["path",{d:"m14.3 19.6 1-.4",key:"11sv9r"}],["path",{d:"M15 3v7.5",key:"7lm50a"}],["path",{d:"m15.2 16.9-.9-.3",key:"1t7mvx"}],["path",{d:"m16.6 21.7.3-.9",key:"1j67ps"}],["path",{d:"m16.8 15.3-.4-1",key:"1ei7r6"}],["path",{d:"m19.1 15.2.3-.9",key:"18r7jp"}],["path",{d:"m19.6 21.7-.4-1",key:"z2vh2"}],["path",{d:"m20.7 16.8 1-.4",key:"19m87a"}],["path",{d:"m21.7 19.4-.9-.3",key:"1qgwi9"}],["path",{d:"M9 3v18",key:"fh3hqa"}],["circle",{cx:"18",cy:"18",r:"3",key:"1xkwt0"}]],Columns3Cog=createLucideIcon("columns-3-cog",__iconNode$iF);const __iconNode$iE=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M9 3v18",key:"fh3hqa"}],["path",{d:"M15 3v18",key:"14nvp0"}]],Columns3=createLucideIcon("columns-3",__iconNode$iE);const __iconNode$iD=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M7.5 3v18",key:"w0wo6v"}],["path",{d:"M12 3v18",key:"108xh3"}],["path",{d:"M16.5 3v18",key:"10tjh1"}]],Columns4=createLucideIcon("columns-4",__iconNode$iD);const __iconNode$iC=[["path",{d:"M14 3a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1",key:"1l7d7l"}],["path",{d:"M19 3a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1",key:"9955pe"}],["path",{d:"m7 15 3 3",key:"4hkfgk"}],["path",{d:"m7 21 3-3H5a2 2 0 0 1-2-2v-2",key:"1xljwe"}],["rect",{x:"14",y:"14",width:"7",height:"7",rx:"1",key:"1cdgtw"}],["rect",{x:"3",y:"3",width:"7",height:"7",rx:"1",key:"zi3rio"}]],Combine=createLucideIcon("combine",__iconNode$iC);const __iconNode$iB=[["path",{d:"M15 6v12a3 3 0 1 0 3-3H6a3 3 0 1 0 3 3V6a3 3 0 1 0-3 3h12a3 3 0 1 0-3-3",key:"11bfej"}]],Command=createLucideIcon("command",__iconNode$iB);const __iconNode$iA=[["path",{d:"m16.24 7.76-1.804 5.411a2 2 0 0 1-1.265 1.265L7.76 16.24l1.804-5.411a2 2 0 0 1 1.265-1.265z",key:"9ktpf1"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Compass=createLucideIcon("compass",__iconNode$iA);const __iconNode$iz=[["path",{d:"M15.536 11.293a1 1 0 0 0 0 1.414l2.376 2.377a1 1 0 0 0 1.414 0l2.377-2.377a1 1 0 0 0 0-1.414l-2.377-2.377a1 1 0 0 0-1.414 0z",key:"1uwlt4"}],["path",{d:"M2.297 11.293a1 1 0 0 0 0 1.414l2.377 2.377a1 1 0 0 0 1.414 0l2.377-2.377a1 1 0 0 0 0-1.414L6.088 8.916a1 1 0 0 0-1.414 0z",key:"10291m"}],["path",{d:"M8.916 17.912a1 1 0 0 0 0 1.415l2.377 2.376a1 1 0 0 0 1.414 0l2.377-2.376a1 1 0 0 0 0-1.415l-2.377-2.376a1 1 0 0 0-1.414 0z",key:"1tqoq1"}],["path",{d:"M8.916 4.674a1 1 0 0 0 0 1.414l2.377 2.376a1 1 0 0 0 1.414 0l2.377-2.376a1 1 0 0 0 0-1.414l-2.377-2.377a1 1 0 0 0-1.414 0z",key:"1x6lto"}]],Component=createLucideIcon("component",__iconNode$iz);const __iconNode$iy=[["rect",{width:"14",height:"8",x:"5",y:"2",rx:"2",key:"wc9tft"}],["rect",{width:"20",height:"8",x:"2",y:"14",rx:"2",key:"w68u3i"}],["path",{d:"M6 18h2",key:"rwmk9e"}],["path",{d:"M12 18h6",key:"aqd8w3"}]],Computer=createLucideIcon("computer",__iconNode$iy);const __iconNode$ix=[["path",{d:"M3 20a1 1 0 0 1-1-1v-1a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v1a1 1 0 0 1-1 1Z",key:"1pvr1r"}],["path",{d:"M20 16a8 8 0 1 0-16 0",key:"1pa543"}],["path",{d:"M12 4v4",key:"1bq03y"}],["path",{d:"M10 4h4",key:"1xpv9s"}]],ConciergeBell=createLucideIcon("concierge-bell",__iconNode$ix);const __iconNode$iw=[["path",{d:"m20.9 18.55-8-15.98a1 1 0 0 0-1.8 0l-8 15.98",key:"53pte7"}],["ellipse",{cx:"12",cy:"19",rx:"9",ry:"3",key:"1ji25f"}]],Cone=createLucideIcon("cone",__iconNode$iw);const __iconNode$iv=[["rect",{x:"2",y:"6",width:"20",height:"8",rx:"1",key:"1estib"}],["path",{d:"M17 14v7",key:"7m2elx"}],["path",{d:"M7 14v7",key:"1cm7wv"}],["path",{d:"M17 3v3",key:"1v4jwn"}],["path",{d:"M7 3v3",key:"7o6guu"}],["path",{d:"M10 14 2.3 6.3",key:"1023jk"}],["path",{d:"m14 6 7.7 7.7",key:"1s8pl2"}],["path",{d:"m8 6 8 8",key:"hl96qh"}]],Construction=createLucideIcon("construction",__iconNode$iv);const __iconNode$iu=[["path",{d:"M16 2v2",key:"scm5qe"}],["path",{d:"M17.915 22a6 6 0 0 0-12 0",key:"suqz9p"}],["path",{d:"M8 2v2",key:"pbkmx"}],["circle",{cx:"12",cy:"12",r:"4",key:"4exip2"}],["rect",{x:"3",y:"4",width:"18",height:"18",rx:"2",key:"12vinp"}]],ContactRound=createLucideIcon("contact-round",__iconNode$iu);const __iconNode$it=[["path",{d:"M16 2v2",key:"scm5qe"}],["path",{d:"M7 22v-2a2 2 0 0 1 2-2h6a2 2 0 0 1 2 2v2",key:"1waht3"}],["path",{d:"M8 2v2",key:"pbkmx"}],["circle",{cx:"12",cy:"11",r:"3",key:"itu57m"}],["rect",{x:"3",y:"4",width:"18",height:"18",rx:"2",key:"12vinp"}]],Contact=createLucideIcon("contact",__iconNode$it);const __iconNode$is=[["path",{d:"M22 7.7c0-.6-.4-1.2-.8-1.5l-6.3-3.9a1.72 1.72 0 0 0-1.7 0l-10.3 6c-.5.2-.9.8-.9 1.4v6.6c0 .5.4 1.2.8 1.5l6.3 3.9a1.72 1.72 0 0 0 1.7 0l10.3-6c.5-.3.9-1 .9-1.5Z",key:"1t2lqe"}],["path",{d:"M10 21.9V14L2.1 9.1",key:"o7czzq"}],["path",{d:"m10 14 11.9-6.9",key:"zm5e20"}],["path",{d:"M14 19.8v-8.1",key:"159ecu"}],["path",{d:"M18 17.5V9.4",key:"11uown"}]],Container=createLucideIcon("container",__iconNode$is);const __iconNode$ir=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M12 18a6 6 0 0 0 0-12v12z",key:"j4l70d"}]],Contrast=createLucideIcon("contrast",__iconNode$ir);const __iconNode$iq=[["path",{d:"M12 2a10 10 0 1 0 10 10 4 4 0 0 1-5-5 4 4 0 0 1-5-5",key:"laymnq"}],["path",{d:"M8.5 8.5v.01",key:"ue8clq"}],["path",{d:"M16 15.5v.01",key:"14dtrp"}],["path",{d:"M12 12v.01",key:"u5ubse"}],["path",{d:"M11 17v.01",key:"1hyl5a"}],["path",{d:"M7 14v.01",key:"uct60s"}]],Cookie=createLucideIcon("cookie",__iconNode$iq);const __iconNode$ip=[["path",{d:"M2 12h20",key:"9i4pu4"}],["path",{d:"M20 12v8a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2v-8",key:"u0tga0"}],["path",{d:"m4 8 16-4",key:"16g0ng"}],["path",{d:"m8.86 6.78-.45-1.81a2 2 0 0 1 1.45-2.43l1.94-.48a2 2 0 0 1 2.43 1.46l.45 1.8",key:"12cejc"}]],CookingPot=createLucideIcon("cooking-pot",__iconNode$ip);const __iconNode$io=[["path",{d:"m12 15 2 2 4-4",key:"2c609p"}],["rect",{width:"14",height:"14",x:"8",y:"8",rx:"2",ry:"2",key:"17jyea"}],["path",{d:"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2",key:"zix9uf"}]],CopyCheck=createLucideIcon("copy-check",__iconNode$io);const __iconNode$in=[["line",{x1:"12",x2:"18",y1:"15",y2:"15",key:"1nscbv"}],["rect",{width:"14",height:"14",x:"8",y:"8",rx:"2",ry:"2",key:"17jyea"}],["path",{d:"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2",key:"zix9uf"}]],CopyMinus=createLucideIcon("copy-minus",__iconNode$in);const __iconNode$im=[["line",{x1:"12",x2:"18",y1:"18",y2:"12",key:"ebkxgr"}],["rect",{width:"14",height:"14",x:"8",y:"8",rx:"2",ry:"2",key:"17jyea"}],["path",{d:"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2",key:"zix9uf"}]],CopySlash=createLucideIcon("copy-slash",__iconNode$im);const __iconNode$il=[["line",{x1:"15",x2:"15",y1:"12",y2:"18",key:"1p7wdc"}],["line",{x1:"12",x2:"18",y1:"15",y2:"15",key:"1nscbv"}],["rect",{width:"14",height:"14",x:"8",y:"8",rx:"2",ry:"2",key:"17jyea"}],["path",{d:"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2",key:"zix9uf"}]],CopyPlus=createLucideIcon("copy-plus",__iconNode$il);const __iconNode$ik=[["line",{x1:"12",x2:"18",y1:"12",y2:"18",key:"1rg63v"}],["line",{x1:"12",x2:"18",y1:"18",y2:"12",key:"ebkxgr"}],["rect",{width:"14",height:"14",x:"8",y:"8",rx:"2",ry:"2",key:"17jyea"}],["path",{d:"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2",key:"zix9uf"}]],CopyX=createLucideIcon("copy-x",__iconNode$ik);const __iconNode$ij=[["rect",{width:"14",height:"14",x:"8",y:"8",rx:"2",ry:"2",key:"17jyea"}],["path",{d:"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2",key:"zix9uf"}]],Copy=createLucideIcon("copy",__iconNode$ij);const __iconNode$ii=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M9.17 14.83a4 4 0 1 0 0-5.66",key:"1sveal"}]],Copyleft=createLucideIcon("copyleft",__iconNode$ii);const __iconNode$ih=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M14.83 14.83a4 4 0 1 1 0-5.66",key:"1i56pz"}]],Copyright=createLucideIcon("copyright",__iconNode$ih);const __iconNode$ig=[["path",{d:"M20 4v7a4 4 0 0 1-4 4H4",key:"6o5b7l"}],["path",{d:"m9 10-5 5 5 5",key:"1kshq7"}]],CornerDownLeft=createLucideIcon("corner-down-left",__iconNode$ig);const __iconNode$if=[["path",{d:"m15 10 5 5-5 5",key:"qqa56n"}],["path",{d:"M4 4v7a4 4 0 0 0 4 4h12",key:"z08zvw"}]],CornerDownRight=createLucideIcon("corner-down-right",__iconNode$if);const __iconNode$ie=[["path",{d:"m14 15-5 5-5-5",key:"1eia93"}],["path",{d:"M20 4h-7a4 4 0 0 0-4 4v12",key:"nbpdq2"}]],CornerLeftDown=createLucideIcon("corner-left-down",__iconNode$ie);const __iconNode$id=[["path",{d:"M14 9 9 4 4 9",key:"1af5af"}],["path",{d:"M20 20h-7a4 4 0 0 1-4-4V4",key:"1blwi3"}]],CornerLeftUp=createLucideIcon("corner-left-up",__iconNode$id);const __iconNode$ic=[["path",{d:"m10 15 5 5 5-5",key:"1hpjnr"}],["path",{d:"M4 4h7a4 4 0 0 1 4 4v12",key:"wcbgct"}]],CornerRightDown=createLucideIcon("corner-right-down",__iconNode$ic);const __iconNode$ib=[["path",{d:"m10 9 5-5 5 5",key:"9ctzwi"}],["path",{d:"M4 20h7a4 4 0 0 0 4-4V4",key:"1plgdj"}]],CornerRightUp=createLucideIcon("corner-right-up",__iconNode$ib);const __iconNode$ia=[["path",{d:"M20 20v-7a4 4 0 0 0-4-4H4",key:"1nkjon"}],["path",{d:"M9 14 4 9l5-5",key:"102s5s"}]],CornerUpLeft=createLucideIcon("corner-up-left",__iconNode$ia);const __iconNode$i9=[["path",{d:"m15 14 5-5-5-5",key:"12vg1m"}],["path",{d:"M4 20v-7a4 4 0 0 1 4-4h12",key:"1lu4f8"}]],CornerUpRight=createLucideIcon("corner-up-right",__iconNode$i9);const __iconNode$i8=[["path",{d:"M12 20v2",key:"1lh1kg"}],["path",{d:"M12 2v2",key:"tus03m"}],["path",{d:"M17 20v2",key:"1rnc9c"}],["path",{d:"M17 2v2",key:"11trls"}],["path",{d:"M2 12h2",key:"1t8f8n"}],["path",{d:"M2 17h2",key:"7oei6x"}],["path",{d:"M2 7h2",key:"asdhe0"}],["path",{d:"M20 12h2",key:"1q8mjw"}],["path",{d:"M20 17h2",key:"1fpfkl"}],["path",{d:"M20 7h2",key:"1o8tra"}],["path",{d:"M7 20v2",key:"4gnj0m"}],["path",{d:"M7 2v2",key:"1i4yhu"}],["rect",{x:"4",y:"4",width:"16",height:"16",rx:"2",key:"1vbyd7"}],["rect",{x:"8",y:"8",width:"8",height:"8",rx:"1",key:"z9xiuo"}]],Cpu=createLucideIcon("cpu",__iconNode$i8);const __iconNode$i7=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M10 9.3a2.8 2.8 0 0 0-3.5 1 3.1 3.1 0 0 0 0 3.4 2.7 2.7 0 0 0 3.5 1",key:"1ss3eq"}],["path",{d:"M17 9.3a2.8 2.8 0 0 0-3.5 1 3.1 3.1 0 0 0 0 3.4 2.7 2.7 0 0 0 3.5 1",key:"1od56t"}]],CreativeCommons=createLucideIcon("creative-commons",__iconNode$i7);const __iconNode$i6=[["rect",{width:"20",height:"14",x:"2",y:"5",rx:"2",key:"ynyp8z"}],["line",{x1:"2",x2:"22",y1:"10",y2:"10",key:"1b3vmo"}]],CreditCard=createLucideIcon("credit-card",__iconNode$i6);const __iconNode$i5=[["path",{d:"M10.2 18H4.774a1.5 1.5 0 0 1-1.352-.97 11 11 0 0 1 .132-6.487",key:"14kkz9"}],["path",{d:"M18 10.2V4.774a1.5 1.5 0 0 0-.97-1.352 11 11 0 0 0-6.486.132",key:"1g7v07"}],["path",{d:"M18 5a4 3 0 0 1 4 3 2 2 0 0 1-2 2 10 10 0 0 0-5.139 1.42",key:"ratg6b"}],["path",{d:"M5 18a3 4 0 0 0 3 4 2 2 0 0 0 2-2 10 10 0 0 1 1.42-5.14",key:"4454f0"}],["path",{d:"M8.709 2.554a10 10 0 0 0-6.155 6.155 1.5 1.5 0 0 0 .676 1.626l9.807 5.42a2 2 0 0 0 2.718-2.718l-5.42-9.807a1.5 1.5 0 0 0-1.626-.676",key:"qmemie"}]],Croissant=createLucideIcon("croissant",__iconNode$i5);const __iconNode$i4=[["path",{d:"M4 9a2 2 0 0 0-2 2v2a2 2 0 0 0 2 2h4a1 1 0 0 1 1 1v4a2 2 0 0 0 2 2h2a2 2 0 0 0 2-2v-4a1 1 0 0 1 1-1h4a2 2 0 0 0 2-2v-2a2 2 0 0 0-2-2h-4a1 1 0 0 1-1-1V4a2 2 0 0 0-2-2h-2a2 2 0 0 0-2 2v4a1 1 0 0 1-1 1z",key:"1xbrqy"}]],Cross=createLucideIcon("cross",__iconNode$i4);const __iconNode$i3=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["line",{x1:"22",x2:"18",y1:"12",y2:"12",key:"l9bcsi"}],["line",{x1:"6",x2:"2",y1:"12",y2:"12",key:"13hhkx"}],["line",{x1:"12",x2:"12",y1:"6",y2:"2",key:"10w3f3"}],["line",{x1:"12",x2:"12",y1:"22",y2:"18",key:"15g9kq"}]],Crosshair=createLucideIcon("crosshair",__iconNode$i3);const __iconNode$i2=[["path",{d:"M6 2v14a2 2 0 0 0 2 2h14",key:"ron5a4"}],["path",{d:"M18 22V8a2 2 0 0 0-2-2H2",key:"7s9ehn"}]],Crop=createLucideIcon("crop",__iconNode$i2);const __iconNode$i1=[["path",{d:"M11.562 3.266a.5.5 0 0 1 .876 0L15.39 8.87a1 1 0 0 0 1.516.294L21.183 5.5a.5.5 0 0 1 .798.519l-2.834 10.246a1 1 0 0 1-.956.734H5.81a1 1 0 0 1-.957-.734L2.02 6.02a.5.5 0 0 1 .798-.519l4.276 3.664a1 1 0 0 0 1.516-.294z",key:"1vdc57"}],["path",{d:"M5 21h14",key:"11awu3"}]],Crown=createLucideIcon("crown",__iconNode$i1);const __iconNode$i0=[["path",{d:"m21.12 6.4-6.05-4.06a2 2 0 0 0-2.17-.05L2.95 8.41a2 2 0 0 0-.95 1.7v5.82a2 2 0 0 0 .88 1.66l6.05 4.07a2 2 0 0 0 2.17.05l9.95-6.12a2 2 0 0 0 .95-1.7V8.06a2 2 0 0 0-.88-1.66Z",key:"1u2ovd"}],["path",{d:"M10 22v-8L2.25 9.15",key:"11pn4q"}],["path",{d:"m10 14 11.77-6.87",key:"1kt1wh"}]],Cuboid=createLucideIcon("cuboid",__iconNode$i0);const __iconNode$h$=[["path",{d:"m6 8 1.75 12.28a2 2 0 0 0 2 1.72h4.54a2 2 0 0 0 2-1.72L18 8",key:"8166m8"}],["path",{d:"M5 8h14",key:"pcz4l3"}],["path",{d:"M7 15a6.47 6.47 0 0 1 5 0 6.47 6.47 0 0 0 5 0",key:"yjz344"}],["path",{d:"m12 8 1-6h2",key:"3ybfa4"}]],CupSoda=createLucideIcon("cup-soda",__iconNode$h$);const __iconNode$h_=[["ellipse",{cx:"12",cy:"5",rx:"9",ry:"3",key:"msslwz"}],["path",{d:"M3 5v14a9 3 0 0 0 18 0V5",key:"aqi0yr"}]],Cylinder=createLucideIcon("cylinder",__iconNode$h_);const __iconNode$hZ=[["circle",{cx:"12",cy:"12",r:"8",key:"46899m"}],["line",{x1:"3",x2:"6",y1:"3",y2:"6",key:"1jkytn"}],["line",{x1:"21",x2:"18",y1:"3",y2:"6",key:"14zfjt"}],["line",{x1:"3",x2:"6",y1:"21",y2:"18",key:"iusuec"}],["line",{x1:"21",x2:"18",y1:"21",y2:"18",key:"yj2dd7"}]],Currency=createLucideIcon("currency",__iconNode$hZ);const __iconNode$hY=[["path",{d:"M11 11.31c1.17.56 1.54 1.69 3.5 1.69 2.5 0 2.5-2 5-2 1.3 0 1.9.5 2.5 1",key:"157kva"}],["path",{d:"M11.75 18c.35.5 1.45 1 2.75 1 2.5 0 2.5-2 5-2 1.3 0 1.9.5 2.5 1",key:"d7q6m6"}],["path",{d:"M2 10h4",key:"l0bgd4"}],["path",{d:"M2 14h4",key:"1gsvsf"}],["path",{d:"M2 18h4",key:"1bu2t1"}],["path",{d:"M2 6h4",key:"aawbzj"}],["path",{d:"M7 3a1 1 0 0 0-1 1v16a1 1 0 0 0 1 1h4a1 1 0 0 0 1-1L10 4a1 1 0 0 0-1-1z",key:"pr6s65"}]],Dam=createLucideIcon("dam",__iconNode$hY);const __iconNode$hX=[["ellipse",{cx:"12",cy:"5",rx:"9",ry:"3",key:"msslwz"}],["path",{d:"M3 12a9 3 0 0 0 5 2.69",key:"1ui2ym"}],["path",{d:"M21 9.3V5",key:"6k6cib"}],["path",{d:"M3 5v14a9 3 0 0 0 6.47 2.88",key:"i62tjy"}],["path",{d:"M12 12v4h4",key:"1bxaet"}],["path",{d:"M13 20a5 5 0 0 0 9-3 4.5 4.5 0 0 0-4.5-4.5c-1.33 0-2.54.54-3.41 1.41L12 16",key:"1f4ei9"}]],DatabaseBackup=createLucideIcon("database-backup",__iconNode$hX);const __iconNode$hW=[["ellipse",{cx:"12",cy:"5",rx:"9",ry:"3",key:"msslwz"}],["path",{d:"M3 5V19A9 3 0 0 0 15 21.84",key:"14ibmq"}],["path",{d:"M21 5V8",key:"1marbg"}],["path",{d:"M21 12L18 17H22L19 22",key:"zafso"}],["path",{d:"M3 12A9 3 0 0 0 14.59 14.87",key:"1y4wr8"}]],DatabaseZap=createLucideIcon("database-zap",__iconNode$hW);const __iconNode$hV=[["ellipse",{cx:"12",cy:"5",rx:"9",ry:"3",key:"msslwz"}],["path",{d:"M3 5V19A9 3 0 0 0 21 19V5",key:"1wlel7"}],["path",{d:"M3 12A9 3 0 0 0 21 12",key:"mv7ke4"}]],Database=createLucideIcon("database",__iconNode$hV);const __iconNode$hU=[["path",{d:"m13 21-3-3 3-3",key:"s3o1nf"}],["path",{d:"M20 18H10",key:"14r3mt"}],["path",{d:"M3 11h.01",key:"1eifu7"}],["rect",{x:"6",y:"3",width:"5",height:"8",rx:"2.5",key:"v9paqo"}]],DecimalsArrowLeft=createLucideIcon("decimals-arrow-left",__iconNode$hU);const __iconNode$hT=[["path",{d:"M10 18h10",key:"1y5s8o"}],["path",{d:"m17 21 3-3-3-3",key:"1ammt0"}],["path",{d:"M3 11h.01",key:"1eifu7"}],["rect",{x:"15",y:"3",width:"5",height:"8",rx:"2.5",key:"76md6a"}],["rect",{x:"6",y:"3",width:"5",height:"8",rx:"2.5",key:"v9paqo"}]],DecimalsArrowRight=createLucideIcon("decimals-arrow-right",__iconNode$hT);const __iconNode$hS=[["path",{d:"M10 5a2 2 0 0 0-1.344.519l-6.328 5.74a1 1 0 0 0 0 1.481l6.328 5.741A2 2 0 0 0 10 19h10a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2z",key:"1yo7s0"}],["path",{d:"m12 9 6 6",key:"anjzzh"}],["path",{d:"m18 9-6 6",key:"1fp51s"}]],Delete=createLucideIcon("delete",__iconNode$hS);const __iconNode$hR=[["path",{d:"M10.162 3.167A10 10 0 0 0 2 13a2 2 0 0 0 4 0v-1a2 2 0 0 1 4 0v4a2 2 0 0 0 4 0v-4a2 2 0 0 1 4 0v1a2 2 0 0 0 4-.006 10 10 0 0 0-8.161-9.826",key:"xi88qy"}],["path",{d:"M20.804 14.869a9 9 0 0 1-17.608 0",key:"1r28rg"}],["circle",{cx:"12",cy:"4",r:"2",key:"muu5ef"}]],Dessert=createLucideIcon("dessert",__iconNode$hR);const __iconNode$hQ=[["circle",{cx:"19",cy:"19",r:"2",key:"17f5cg"}],["circle",{cx:"5",cy:"5",r:"2",key:"1gwv83"}],["path",{d:"M6.48 3.66a10 10 0 0 1 13.86 13.86",key:"xr8kdq"}],["path",{d:"m6.41 6.41 11.18 11.18",key:"uhpjw7"}],["path",{d:"M3.66 6.48a10 10 0 0 0 13.86 13.86",key:"cldpwv"}]],Diameter=createLucideIcon("diameter",__iconNode$hQ);const __iconNode$hP=[["path",{d:"M2.7 10.3a2.41 2.41 0 0 0 0 3.41l7.59 7.59a2.41 2.41 0 0 0 3.41 0l7.59-7.59a2.41 2.41 0 0 0 0-3.41L13.7 2.71a2.41 2.41 0 0 0-3.41 0z",key:"1ey20j"}],["path",{d:"M8 12h8",key:"1wcyev"}]],DiamondMinus=createLucideIcon("diamond-minus",__iconNode$hP);const __iconNode$hO=[["path",{d:"M2.7 10.3a2.41 2.41 0 0 0 0 3.41l7.59 7.59a2.41 2.41 0 0 0 3.41 0l7.59-7.59a2.41 2.41 0 0 0 0-3.41L13.7 2.71a2.41 2.41 0 0 0-3.41 0Z",key:"1tpxz2"}],["path",{d:"M9.2 9.2h.01",key:"1b7bvt"}],["path",{d:"m14.5 9.5-5 5",key:"17q4r4"}],["path",{d:"M14.7 14.8h.01",key:"17nsh4"}]],DiamondPercent=createLucideIcon("diamond-percent",__iconNode$hO);const __iconNode$hN=[["path",{d:"M12 8v8",key:"napkw2"}],["path",{d:"M2.7 10.3a2.41 2.41 0 0 0 0 3.41l7.59 7.59a2.41 2.41 0 0 0 3.41 0l7.59-7.59a2.41 2.41 0 0 0 0-3.41L13.7 2.71a2.41 2.41 0 0 0-3.41 0z",key:"1ey20j"}],["path",{d:"M8 12h8",key:"1wcyev"}]],DiamondPlus=createLucideIcon("diamond-plus",__iconNode$hN);const __iconNode$hM=[["path",{d:"M2.7 10.3a2.41 2.41 0 0 0 0 3.41l7.59 7.59a2.41 2.41 0 0 0 3.41 0l7.59-7.59a2.41 2.41 0 0 0 0-3.41l-7.59-7.59a2.41 2.41 0 0 0-3.41 0Z",key:"1f1r0c"}]],Diamond=createLucideIcon("diamond",__iconNode$hM);const __iconNode$hL=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",ry:"2",key:"1m3agn"}],["path",{d:"M12 12h.01",key:"1mp3jc"}]],Dice1=createLucideIcon("dice-1",__iconNode$hL);const __iconNode$hK=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",ry:"2",key:"1m3agn"}],["path",{d:"M15 9h.01",key:"x1ddxp"}],["path",{d:"M9 15h.01",key:"fzyn71"}]],Dice2=createLucideIcon("dice-2",__iconNode$hK);const __iconNode$hJ=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",ry:"2",key:"1m3agn"}],["path",{d:"M16 8h.01",key:"cr5u4v"}],["path",{d:"M12 12h.01",key:"1mp3jc"}],["path",{d:"M8 16h.01",key:"18s6g9"}]],Dice3=createLucideIcon("dice-3",__iconNode$hJ);const __iconNode$hI=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",ry:"2",key:"1m3agn"}],["path",{d:"M16 8h.01",key:"cr5u4v"}],["path",{d:"M8 8h.01",key:"1e4136"}],["path",{d:"M8 16h.01",key:"18s6g9"}],["path",{d:"M16 16h.01",key:"1f9h7w"}]],Dice4=createLucideIcon("dice-4",__iconNode$hI);const __iconNode$hH=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",ry:"2",key:"1m3agn"}],["path",{d:"M16 8h.01",key:"cr5u4v"}],["path",{d:"M8 8h.01",key:"1e4136"}],["path",{d:"M8 16h.01",key:"18s6g9"}],["path",{d:"M16 16h.01",key:"1f9h7w"}],["path",{d:"M12 12h.01",key:"1mp3jc"}]],Dice5=createLucideIcon("dice-5",__iconNode$hH);const __iconNode$hG=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",ry:"2",key:"1m3agn"}],["path",{d:"M16 8h.01",key:"cr5u4v"}],["path",{d:"M16 12h.01",key:"1l6xoz"}],["path",{d:"M16 16h.01",key:"1f9h7w"}],["path",{d:"M8 8h.01",key:"1e4136"}],["path",{d:"M8 12h.01",key:"czm47f"}],["path",{d:"M8 16h.01",key:"18s6g9"}]],Dice6=createLucideIcon("dice-6",__iconNode$hG);const __iconNode$hF=[["rect",{width:"12",height:"12",x:"2",y:"10",rx:"2",ry:"2",key:"6agr2n"}],["path",{d:"m17.92 14 3.5-3.5a2.24 2.24 0 0 0 0-3l-5-4.92a2.24 2.24 0 0 0-3 0L10 6",key:"1o487t"}],["path",{d:"M6 18h.01",key:"uhywen"}],["path",{d:"M10 14h.01",key:"ssrbsk"}],["path",{d:"M15 6h.01",key:"cblpky"}],["path",{d:"M18 9h.01",key:"2061c0"}]],Dices=createLucideIcon("dices",__iconNode$hF);const __iconNode$hE=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["circle",{cx:"12",cy:"12",r:"4",key:"4exip2"}],["path",{d:"M12 12h.01",key:"1mp3jc"}]],Disc2=createLucideIcon("disc-2",__iconNode$hE);const __iconNode$hD=[["path",{d:"M12 3v14",key:"7cf3v8"}],["path",{d:"M5 10h14",key:"elsbfy"}],["path",{d:"M5 21h14",key:"11awu3"}]],Diff=createLucideIcon("diff",__iconNode$hD);const __iconNode$hC=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M6 12c0-1.7.7-3.2 1.8-4.2",key:"oqkarx"}],["circle",{cx:"12",cy:"12",r:"2",key:"1c9p78"}],["path",{d:"M18 12c0 1.7-.7 3.2-1.8 4.2",key:"1eah9h"}]],Disc3=createLucideIcon("disc-3",__iconNode$hC);const __iconNode$hB=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["circle",{cx:"12",cy:"12",r:"5",key:"nd82uf"}],["path",{d:"M12 12h.01",key:"1mp3jc"}]],DiscAlbum=createLucideIcon("disc-album",__iconNode$hB);const __iconNode$hA=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["circle",{cx:"12",cy:"12",r:"2",key:"1c9p78"}]],Disc=createLucideIcon("disc",__iconNode$hA);const __iconNode$hz=[["circle",{cx:"12",cy:"6",r:"1",key:"1bh7o1"}],["line",{x1:"5",x2:"19",y1:"12",y2:"12",key:"13b5wn"}],["circle",{cx:"12",cy:"18",r:"1",key:"lqb9t5"}]],Divide=createLucideIcon("divide",__iconNode$hz);const __iconNode$hy=[["path",{d:"M15 2c-1.35 1.5-2.092 3-2.5 4.5L14 8",key:"1bivrr"}],["path",{d:"m17 6-2.891-2.891",key:"xu6p2f"}],["path",{d:"M2 15c3.333-3 6.667-3 10-3",key:"nxix30"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"m20 9 .891.891",key:"3xwk7g"}],["path",{d:"M22 9c-1.5 1.35-3 2.092-4.5 2.5l-1-1",key:"18cutr"}],["path",{d:"M3.109 14.109 4 15",key:"q76aoh"}],["path",{d:"m6.5 12.5 1 1",key:"cs35ky"}],["path",{d:"m7 18 2.891 2.891",key:"1sisit"}],["path",{d:"M9 22c1.35-1.5 2.092-3 2.5-4.5L10 16",key:"rlvei3"}]],DnaOff=createLucideIcon("dna-off",__iconNode$hy);const __iconNode$hx=[["path",{d:"m10 16 1.5 1.5",key:"11lckj"}],["path",{d:"m14 8-1.5-1.5",key:"1ohn8i"}],["path",{d:"M15 2c-1.798 1.998-2.518 3.995-2.807 5.993",key:"80uv8i"}],["path",{d:"m16.5 10.5 1 1",key:"696xn5"}],["path",{d:"m17 6-2.891-2.891",key:"xu6p2f"}],["path",{d:"M2 15c6.667-6 13.333 0 20-6",key:"1pyr53"}],["path",{d:"m20 9 .891.891",key:"3xwk7g"}],["path",{d:"M3.109 14.109 4 15",key:"q76aoh"}],["path",{d:"m6.5 12.5 1 1",key:"cs35ky"}],["path",{d:"m7 18 2.891 2.891",key:"1sisit"}],["path",{d:"M9 22c1.798-1.998 2.518-3.995 2.807-5.993",key:"q3hbxp"}]],Dna=createLucideIcon("dna",__iconNode$hx);const __iconNode$hw=[["path",{d:"M2 8h20",key:"d11cs7"}],["rect",{width:"20",height:"16",x:"2",y:"4",rx:"2",key:"18n3k1"}],["path",{d:"M6 16h12",key:"u522kt"}]],Dock=createLucideIcon("dock",__iconNode$hw);const __iconNode$hv=[["path",{d:"M11.25 16.25h1.5L12 17z",key:"w7jh35"}],["path",{d:"M16 14v.5",key:"1lajdz"}],["path",{d:"M4.42 11.247A13.152 13.152 0 0 0 4 14.556C4 18.728 7.582 21 12 21s8-2.272 8-6.444a11.702 11.702 0 0 0-.493-3.309",key:"u7s9ue"}],["path",{d:"M8 14v.5",key:"1nzgdb"}],["path",{d:"M8.5 8.5c-.384 1.05-1.083 2.028-2.344 2.5-1.931.722-3.576-.297-3.656-1-.113-.994 1.177-6.53 4-7 1.923-.321 3.651.845 3.651 2.235A7.497 7.497 0 0 1 14 5.277c0-1.39 1.844-2.598 3.767-2.277 2.823.47 4.113 6.006 4 7-.08.703-1.725 1.722-3.656 1-1.261-.472-1.855-1.45-2.239-2.5",key:"v8hric"}]],Dog=createLucideIcon("dog",__iconNode$hv);const __iconNode$hu=[["line",{x1:"12",x2:"12",y1:"2",y2:"22",key:"7eqyqh"}],["path",{d:"M17 5H9.5a3.5 3.5 0 0 0 0 7h5a3.5 3.5 0 0 1 0 7H6",key:"1b0p4s"}]],DollarSign=createLucideIcon("dollar-sign",__iconNode$hu);const __iconNode$ht=[["path",{d:"M20.5 10a2.5 2.5 0 0 1-2.4-3H18a2.95 2.95 0 0 1-2.6-4.4 10 10 0 1 0 6.3 7.1c-.3.2-.8.3-1.2.3",key:"19sr3x"}],["circle",{cx:"12",cy:"12",r:"3",key:"1v7zrd"}]],Donut=createLucideIcon("donut",__iconNode$ht);const __iconNode$hs=[["path",{d:"M10 12h.01",key:"1kxr2c"}],["path",{d:"M18 9V6a2 2 0 0 0-2-2H8a2 2 0 0 0-2 2v14",key:"1bnhmg"}],["path",{d:"M2 20h8",key:"10ntw1"}],["path",{d:"M20 17v-2a2 2 0 1 0-4 0v2",key:"pwaxnr"}],["rect",{x:"14",y:"17",width:"8",height:"5",rx:"1",key:"15pjcy"}]],DoorClosedLocked=createLucideIcon("door-closed-locked",__iconNode$hs);const __iconNode$hr=[["path",{d:"M11 20H2",key:"nlcfvz"}],["path",{d:"M11 4.562v16.157a1 1 0 0 0 1.242.97L19 20V5.562a2 2 0 0 0-1.515-1.94l-4-1A2 2 0 0 0 11 4.561z",key:"au4z13"}],["path",{d:"M11 4H8a2 2 0 0 0-2 2v14",key:"74r1mk"}],["path",{d:"M14 12h.01",key:"1jfl7z"}],["path",{d:"M22 20h-3",key:"vhrsz"}]],DoorOpen=createLucideIcon("door-open",__iconNode$hr);const __iconNode$hq=[["path",{d:"M10 12h.01",key:"1kxr2c"}],["path",{d:"M18 20V6a2 2 0 0 0-2-2H8a2 2 0 0 0-2 2v14",key:"36qu9e"}],["path",{d:"M2 20h20",key:"owomy5"}]],DoorClosed=createLucideIcon("door-closed",__iconNode$hq);const __iconNode$hp=[["circle",{cx:"12.1",cy:"12.1",r:"1",key:"18d7e5"}]],Dot=createLucideIcon("dot",__iconNode$hp);const __iconNode$ho=[["path",{d:"M12 15V3",key:"m9g1x1"}],["path",{d:"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4",key:"ih7n3h"}],["path",{d:"m7 10 5 5 5-5",key:"brsn70"}]],Download=createLucideIcon("download",__iconNode$ho);const __iconNode$hn=[["path",{d:"m12.99 6.74 1.93 3.44",key:"iwagvd"}],["path",{d:"M19.136 12a10 10 0 0 1-14.271 0",key:"ppmlo4"}],["path",{d:"m21 21-2.16-3.84",key:"vylbct"}],["path",{d:"m3 21 8.02-14.26",key:"1ssaw4"}],["circle",{cx:"12",cy:"5",r:"2",key:"f1ur92"}]],DraftingCompass=createLucideIcon("drafting-compass",__iconNode$hn);const __iconNode$hm=[["path",{d:"M10 11h.01",key:"d2at3l"}],["path",{d:"M14 6h.01",key:"k028ub"}],["path",{d:"M18 6h.01",key:"1v4wsw"}],["path",{d:"M6.5 13.1h.01",key:"1748ia"}],["path",{d:"M22 5c0 9-4 12-6 12s-6-3-6-12c0-2 2-3 6-3s6 1 6 3",key:"172yzv"}],["path",{d:"M17.4 9.9c-.8.8-2 .8-2.8 0",key:"1obv0w"}],["path",{d:"M10.1 7.1C9 7.2 7.7 7.7 6 8.6c-3.5 2-4.7 3.9-3.7 5.6 4.5 7.8 9.5 8.4 11.2 7.4.9-.5 1.9-2.1 1.9-4.7",key:"rqjl8i"}],["path",{d:"M9.1 16.5c.3-1.1 1.4-1.7 2.4-1.4",key:"1mr6wy"}]],Drama=createLucideIcon("drama",__iconNode$hm);const __iconNode$hl=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M19.13 5.09C15.22 9.14 10 10.44 2.25 10.94",key:"hpej1"}],["path",{d:"M21.75 12.84c-6.62-1.41-12.14 1-16.38 6.32",key:"1tr44o"}],["path",{d:"M8.56 2.75c4.37 6 6 9.42 8 17.72",key:"kbh691"}]],Dribbble=createLucideIcon("dribbble",__iconNode$hl);const __iconNode$hk=[["path",{d:"M10 18a1 1 0 0 1 1 1v2a1 1 0 0 1-1 1H5a3 3 0 0 1-3-3 1 1 0 0 1 1-1z",key:"ioqxb1"}],["path",{d:"M13 10H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a1 1 0 0 1 1 1v6a1 1 0 0 1-1 1l-.81 3.242a1 1 0 0 1-.97.758H8",key:"1rs59n"}],["path",{d:"M14 4h3a1 1 0 0 1 1 1v2a1 1 0 0 1-1 1h-3",key:"105ega"}],["path",{d:"M18 6h4",key:"66u95g"}],["path",{d:"m5 10-2 8",key:"xt2lic"}],["path",{d:"m7 18 2-8",key:"1bzku2"}]],Drill=createLucideIcon("drill",__iconNode$hk);const __iconNode$hj=[["path",{d:"M10 10 7 7",key:"zp14k7"}],["path",{d:"m10 14-3 3",key:"1jrpxk"}],["path",{d:"m14 10 3-3",key:"7tigam"}],["path",{d:"m14 14 3 3",key:"vm23p3"}],["path",{d:"M14.205 4.139a4 4 0 1 1 5.439 5.863",key:"1tm5p2"}],["path",{d:"M19.637 14a4 4 0 1 1-5.432 5.868",key:"16egi2"}],["path",{d:"M4.367 10a4 4 0 1 1 5.438-5.862",key:"1wta6a"}],["path",{d:"M9.795 19.862a4 4 0 1 1-5.429-5.873",key:"q39hpv"}],["rect",{x:"10",y:"8",width:"4",height:"8",rx:"1",key:"phrjt1"}]],Drone=createLucideIcon("drone",__iconNode$hj);const __iconNode$hi=[["path",{d:"M18.715 13.186C18.29 11.858 17.384 10.607 16 9.5c-2-1.6-3.5-4-4-6.5a10.7 10.7 0 0 1-.884 2.586",key:"8suz2t"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M8.795 8.797A11 11 0 0 1 8 9.5C6 11.1 5 13 5 15a7 7 0 0 0 13.222 3.208",key:"19dw9m"}]],DropletOff=createLucideIcon("droplet-off",__iconNode$hi);const __iconNode$hh=[["path",{d:"M12 22a7 7 0 0 0 7-7c0-2-1-3.9-3-5.5s-3.5-4-4-6.5c-.5 2.5-2 4.9-4 6.5C6 11.1 5 13 5 15a7 7 0 0 0 7 7z",key:"c7niix"}]],Droplet=createLucideIcon("droplet",__iconNode$hh);const __iconNode$hg=[["path",{d:"M7 16.3c2.2 0 4-1.83 4-4.05 0-1.16-.57-2.26-1.71-3.19S7.29 6.75 7 5.3c-.29 1.45-1.14 2.84-2.29 3.76S3 11.1 3 12.25c0 2.22 1.8 4.05 4 4.05z",key:"1ptgy4"}],["path",{d:"M12.56 6.6A10.97 10.97 0 0 0 14 3.02c.5 2.5 2 4.9 4 6.5s3 3.5 3 5.5a6.98 6.98 0 0 1-11.91 4.97",key:"1sl1rz"}]],Droplets=createLucideIcon("droplets",__iconNode$hg);const __iconNode$hf=[["path",{d:"m2 2 8 8",key:"1v6059"}],["path",{d:"m22 2-8 8",key:"173r8a"}],["ellipse",{cx:"12",cy:"9",rx:"10",ry:"5",key:"liohsx"}],["path",{d:"M7 13.4v7.9",key:"1yi6u9"}],["path",{d:"M12 14v8",key:"1tn2tj"}],["path",{d:"M17 13.4v7.9",key:"eqz2v3"}],["path",{d:"M2 9v8a10 5 0 0 0 20 0V9",key:"1750ul"}]],Drum=createLucideIcon("drum",__iconNode$hf);const __iconNode$he=[["path",{d:"M15.4 15.63a7.875 6 135 1 1 6.23-6.23 4.5 3.43 135 0 0-6.23 6.23",key:"1dtqwm"}],["path",{d:"m8.29 12.71-2.6 2.6a2.5 2.5 0 1 0-1.65 4.65A2.5 2.5 0 1 0 8.7 18.3l2.59-2.59",key:"1oq1fw"}]],Drumstick=createLucideIcon("drumstick",__iconNode$he);const __iconNode$hd=[["path",{d:"M17.596 12.768a2 2 0 1 0 2.829-2.829l-1.768-1.767a2 2 0 0 0 2.828-2.829l-2.828-2.828a2 2 0 0 0-2.829 2.828l-1.767-1.768a2 2 0 1 0-2.829 2.829z",key:"9m4mmf"}],["path",{d:"m2.5 21.5 1.4-1.4",key:"17g3f0"}],["path",{d:"m20.1 3.9 1.4-1.4",key:"1qn309"}],["path",{d:"M5.343 21.485a2 2 0 1 0 2.829-2.828l1.767 1.768a2 2 0 1 0 2.829-2.829l-6.364-6.364a2 2 0 1 0-2.829 2.829l1.768 1.767a2 2 0 0 0-2.828 2.829z",key:"1t2c92"}],["path",{d:"m9.6 14.4 4.8-4.8",key:"6umqxw"}]],Dumbbell=createLucideIcon("dumbbell",__iconNode$hd);const __iconNode$hc=[["path",{d:"M6 18.5a3.5 3.5 0 1 0 7 0c0-1.57.92-2.52 2.04-3.46",key:"1qngmn"}],["path",{d:"M6 8.5c0-.75.13-1.47.36-2.14",key:"b06bma"}],["path",{d:"M8.8 3.15A6.5 6.5 0 0 1 19 8.5c0 1.63-.44 2.81-1.09 3.76",key:"g10hsz"}],["path",{d:"M12.5 6A2.5 2.5 0 0 1 15 8.5M10 13a2 2 0 0 0 1.82-1.18",key:"ygzou7"}],["line",{x1:"2",x2:"22",y1:"2",y2:"22",key:"a6p6uj"}]],EarOff=createLucideIcon("ear-off",__iconNode$hc);const __iconNode$hb=[["path",{d:"M6 8.5a6.5 6.5 0 1 1 13 0c0 6-6 6-6 10a3.5 3.5 0 1 1-7 0",key:"1dfaln"}],["path",{d:"M15 8.5a2.5 2.5 0 0 0-5 0v1a2 2 0 1 1 0 4",key:"1qnva7"}]],Ear=createLucideIcon("ear",__iconNode$hb);const __iconNode$ha=[["path",{d:"M7 3.34V5a3 3 0 0 0 3 3",key:"w732o8"}],["path",{d:"M11 21.95V18a2 2 0 0 0-2-2 2 2 0 0 1-2-2v-1a2 2 0 0 0-2-2H2.05",key:"f02343"}],["path",{d:"M21.54 15H17a2 2 0 0 0-2 2v4.54",key:"1djwo0"}],["path",{d:"M12 2a10 10 0 1 0 9.54 13",key:"zjsr6q"}],["path",{d:"M20 6V4a2 2 0 1 0-4 0v2",key:"1of5e8"}],["rect",{width:"8",height:"5",x:"14",y:"6",rx:"1",key:"1fmf51"}]],EarthLock=createLucideIcon("earth-lock",__iconNode$ha);const __iconNode$h9=[["path",{d:"M21.54 15H17a2 2 0 0 0-2 2v4.54",key:"1djwo0"}],["path",{d:"M7 3.34V5a3 3 0 0 0 3 3a2 2 0 0 1 2 2c0 1.1.9 2 2 2a2 2 0 0 0 2-2c0-1.1.9-2 2-2h3.17",key:"1tzkfa"}],["path",{d:"M11 21.95V18a2 2 0 0 0-2-2a2 2 0 0 1-2-2v-1a2 2 0 0 0-2-2H2.05",key:"14pb5j"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Earth=createLucideIcon("earth",__iconNode$h9);const __iconNode$h8=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M12 2a7 7 0 1 0 10 10",key:"1yuj32"}]],Eclipse=createLucideIcon("eclipse",__iconNode$h8);const __iconNode$h7=[["circle",{cx:"11.5",cy:"12.5",r:"3.5",key:"1cl1mi"}],["path",{d:"M3 8c0-3.5 2.5-6 6.5-6 5 0 4.83 3 7.5 5s5 2 5 6c0 4.5-2.5 6.5-7 6.5-2.5 0-2.5 2.5-6 2.5s-7-2-7-5.5c0-3 1.5-3 1.5-5C3.5 10 3 9 3 8Z",key:"165ef9"}]],EggFried=createLucideIcon("egg-fried",__iconNode$h7);const __iconNode$h6=[["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M20 14.347V14c0-6-4-12-8-12-1.078 0-2.157.436-3.157 1.19",key:"13g2jy"}],["path",{d:"M6.206 6.21C4.871 8.4 4 11.2 4 14a8 8 0 0 0 14.568 4.568",key:"1581id"}]],EggOff=createLucideIcon("egg-off",__iconNode$h6);const __iconNode$h5=[["path",{d:"M12 2C8 2 4 8 4 14a8 8 0 0 0 16 0c0-6-4-12-8-12",key:"1le142"}]],Egg=createLucideIcon("egg",__iconNode$h5);const __iconNode$h4=[["circle",{cx:"12",cy:"12",r:"1",key:"41hilf"}],["circle",{cx:"12",cy:"5",r:"1",key:"gxeob9"}],["circle",{cx:"12",cy:"19",r:"1",key:"lyex9k"}]],EllipsisVertical=createLucideIcon("ellipsis-vertical",__iconNode$h4);const __iconNode$h3=[["circle",{cx:"12",cy:"12",r:"1",key:"41hilf"}],["circle",{cx:"19",cy:"12",r:"1",key:"1wjl8i"}],["circle",{cx:"5",cy:"12",r:"1",key:"1pcz8c"}]],Ellipsis=createLucideIcon("ellipsis",__iconNode$h3);const __iconNode$h2=[["path",{d:"M5 15a6.5 6.5 0 0 1 7 0 6.5 6.5 0 0 0 7 0",key:"yrdkhy"}],["path",{d:"M5 9a6.5 6.5 0 0 1 7 0 6.5 6.5 0 0 0 7 0",key:"gzkvyz"}]],EqualApproximately=createLucideIcon("equal-approximately",__iconNode$h2);const __iconNode$h1=[["line",{x1:"5",x2:"19",y1:"9",y2:"9",key:"1nwqeh"}],["line",{x1:"5",x2:"19",y1:"15",y2:"15",key:"g8yjpy"}],["line",{x1:"19",x2:"5",y1:"5",y2:"19",key:"1x9vlm"}]],EqualNot=createLucideIcon("equal-not",__iconNode$h1);const __iconNode$h0=[["line",{x1:"5",x2:"19",y1:"9",y2:"9",key:"1nwqeh"}],["line",{x1:"5",x2:"19",y1:"15",y2:"15",key:"g8yjpy"}]],Equal=createLucideIcon("equal",__iconNode$h0);const __iconNode$g$=[["path",{d:"M21 21H8a2 2 0 0 1-1.42-.587l-3.994-3.999a2 2 0 0 1 0-2.828l10-10a2 2 0 0 1 2.829 0l5.999 6a2 2 0 0 1 0 2.828L12.834 21",key:"g5wo59"}],["path",{d:"m5.082 11.09 8.828 8.828",key:"1wx5vj"}]],Eraser=createLucideIcon("eraser",__iconNode$g$);const __iconNode$g_=[["path",{d:"m15 20 3-3h2a2 2 0 0 0 2-2V6a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v9a2 2 0 0 0 2 2h2l3 3z",key:"rbahqx"}],["path",{d:"M6 8v1",key:"1636ez"}],["path",{d:"M10 8v1",key:"1talb4"}],["path",{d:"M14 8v1",key:"1rsfgr"}],["path",{d:"M18 8v1",key:"gnkwox"}]],EthernetPort=createLucideIcon("ethernet-port",__iconNode$g_);const __iconNode$gZ=[["path",{d:"M14 13h2a2 2 0 0 1 2 2v2a2 2 0 0 0 4 0v-6.998a2 2 0 0 0-.59-1.42L18 5",key:"1wtuz0"}],["path",{d:"M14 21V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v16",key:"e09ifn"}],["path",{d:"M2 21h13",key:"1x0fut"}],["path",{d:"M3 7h11",key:"19efrr"}],["path",{d:"m9 11-2 3h3l-2 3",key:"lmzxi1"}]],EvCharger=createLucideIcon("ev-charger",__iconNode$gZ);const __iconNode$gY=[["path",{d:"M4 10h12",key:"1y6xl8"}],["path",{d:"M4 14h9",key:"1loblj"}],["path",{d:"M19 6a7.7 7.7 0 0 0-5.2-2A7.9 7.9 0 0 0 6 12c0 4.4 3.5 8 7.8 8 2 0 3.8-.8 5.2-2",key:"1j6lzo"}]],Euro=createLucideIcon("euro",__iconNode$gY);const __iconNode$gX=[["path",{d:"m15 15 6 6",key:"1s409w"}],["path",{d:"m15 9 6-6",key:"ko1vev"}],["path",{d:"M21 16v5h-5",key:"1ck2sf"}],["path",{d:"M21 8V3h-5",key:"1qoq8a"}],["path",{d:"M3 16v5h5",key:"1t08am"}],["path",{d:"m3 21 6-6",key:"wwnumi"}],["path",{d:"M3 8V3h5",key:"1ln10m"}],["path",{d:"M9 9 3 3",key:"v551iv"}]],Expand=createLucideIcon("expand",__iconNode$gX);const __iconNode$gW=[["path",{d:"M15 3h6v6",key:"1q9fwt"}],["path",{d:"M10 14 21 3",key:"gplh6r"}],["path",{d:"M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6",key:"a6xqqp"}]],ExternalLink=createLucideIcon("external-link",__iconNode$gW);const __iconNode$gV=[["path",{d:"m15 18-.722-3.25",key:"1j64jw"}],["path",{d:"M2 8a10.645 10.645 0 0 0 20 0",key:"1e7gxb"}],["path",{d:"m20 15-1.726-2.05",key:"1cnuld"}],["path",{d:"m4 15 1.726-2.05",key:"1dsqqd"}],["path",{d:"m9 18 .722-3.25",key:"ypw2yx"}]],EyeClosed=createLucideIcon("eye-closed",__iconNode$gV);const __iconNode$gU=[["path",{d:"M10.733 5.076a10.744 10.744 0 0 1 11.205 6.575 1 1 0 0 1 0 .696 10.747 10.747 0 0 1-1.444 2.49",key:"ct8e1f"}],["path",{d:"M14.084 14.158a3 3 0 0 1-4.242-4.242",key:"151rxh"}],["path",{d:"M17.479 17.499a10.75 10.75 0 0 1-15.417-5.151 1 1 0 0 1 0-.696 10.75 10.75 0 0 1 4.446-5.143",key:"13bj9a"}],["path",{d:"m2 2 20 20",key:"1ooewy"}]],EyeOff=createLucideIcon("eye-off",__iconNode$gU);const __iconNode$gT=[["path",{d:"M2.062 12.348a1 1 0 0 1 0-.696 10.75 10.75 0 0 1 19.876 0 1 1 0 0 1 0 .696 10.75 10.75 0 0 1-19.876 0",key:"1nclc0"}],["circle",{cx:"12",cy:"12",r:"3",key:"1v7zrd"}]],Eye=createLucideIcon("eye",__iconNode$gT);const __iconNode$gS=[["path",{d:"M18 2h-3a5 5 0 0 0-5 5v3H7v4h3v8h4v-8h3l1-4h-4V7a1 1 0 0 1 1-1h3z",key:"1jg4f8"}]],Facebook=createLucideIcon("facebook",__iconNode$gS);const __iconNode$gR=[["path",{d:"M12 16h.01",key:"1drbdi"}],["path",{d:"M16 16h.01",key:"1f9h7w"}],["path",{d:"M3 19a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V8.5a.5.5 0 0 0-.769-.422l-4.462 2.844A.5.5 0 0 1 15 10.5v-2a.5.5 0 0 0-.769-.422L9.77 10.922A.5.5 0 0 1 9 10.5V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2z",key:"1iv0i2"}],["path",{d:"M8 16h.01",key:"18s6g9"}]],Factory=createLucideIcon("factory",__iconNode$gR);const __iconNode$gQ=[["path",{d:"M10.827 16.379a6.082 6.082 0 0 1-8.618-7.002l5.412 1.45a6.082 6.082 0 0 1 7.002-8.618l-1.45 5.412a6.082 6.082 0 0 1 8.618 7.002l-5.412-1.45a6.082 6.082 0 0 1-7.002 8.618l1.45-5.412Z",key:"484a7f"}],["path",{d:"M12 12v.01",key:"u5ubse"}]],Fan=createLucideIcon("fan",__iconNode$gQ);const __iconNode$gP=[["path",{d:"M12 6a2 2 0 0 1 3.414-1.414l6 6a2 2 0 0 1 0 2.828l-6 6A2 2 0 0 1 12 18z",key:"b19h5q"}],["path",{d:"M2 6a2 2 0 0 1 3.414-1.414l6 6a2 2 0 0 1 0 2.828l-6 6A2 2 0 0 1 2 18z",key:"h7h5ge"}]],FastForward=createLucideIcon("fast-forward",__iconNode$gP);const __iconNode$gO=[["path",{d:"M12.67 19a2 2 0 0 0 1.416-.588l6.154-6.172a6 6 0 0 0-8.49-8.49L5.586 9.914A2 2 0 0 0 5 11.328V18a1 1 0 0 0 1 1z",key:"18jl4k"}],["path",{d:"M16 8 2 22",key:"vp34q"}],["path",{d:"M17.5 15H9",key:"1oz8nu"}]],Feather=createLucideIcon("feather",__iconNode$gO);const __iconNode$gN=[["path",{d:"M4 3 2 5v15c0 .6.4 1 1 1h2c.6 0 1-.4 1-1V5Z",key:"1n2rgs"}],["path",{d:"M6 8h4",key:"utf9t1"}],["path",{d:"M6 18h4",key:"12yh4b"}],["path",{d:"m12 3-2 2v15c0 .6.4 1 1 1h2c.6 0 1-.4 1-1V5Z",key:"3ha7mj"}],["path",{d:"M14 8h4",key:"1r8wg2"}],["path",{d:"M14 18h4",key:"1t3kbu"}],["path",{d:"m20 3-2 2v15c0 .6.4 1 1 1h2c.6 0 1-.4 1-1V5Z",key:"dfd4e2"}]],Fence=createLucideIcon("fence",__iconNode$gN);const __iconNode$gM=[["circle",{cx:"12",cy:"12",r:"2",key:"1c9p78"}],["path",{d:"M12 2v4",key:"3427ic"}],["path",{d:"m6.8 15-3.5 2",key:"hjy98k"}],["path",{d:"m20.7 7-3.5 2",key:"f08gto"}],["path",{d:"M6.8 9 3.3 7",key:"1aevh4"}],["path",{d:"m20.7 17-3.5-2",key:"1liqo3"}],["path",{d:"m9 22 3-8 3 8",key:"wees03"}],["path",{d:"M8 22h8",key:"rmew8v"}],["path",{d:"M18 18.7a9 9 0 1 0-12 0",key:"dhzg4g"}]],FerrisWheel=createLucideIcon("ferris-wheel",__iconNode$gM);const __iconNode$gL=[["path",{d:"M5 5.5A3.5 3.5 0 0 1 8.5 2H12v7H8.5A3.5 3.5 0 0 1 5 5.5z",key:"1340ok"}],["path",{d:"M12 2h3.5a3.5 3.5 0 1 1 0 7H12V2z",key:"1hz3m3"}],["path",{d:"M12 12.5a3.5 3.5 0 1 1 7 0 3.5 3.5 0 1 1-7 0z",key:"1oz8n2"}],["path",{d:"M5 19.5A3.5 3.5 0 0 1 8.5 16H12v3.5a3.5 3.5 0 1 1-7 0z",key:"1ff65i"}],["path",{d:"M5 12.5A3.5 3.5 0 0 1 8.5 9H12v7H8.5A3.5 3.5 0 0 1 5 12.5z",key:"pdip6e"}]],Figma=createLucideIcon("figma",__iconNode$gL);const __iconNode$gK=[["path",{d:"M13.659 22H18a2 2 0 0 0 2-2V8a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v11.5",key:"4pqfef"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M8 12v-1",key:"1ej8lb"}],["path",{d:"M8 18v-2",key:"qcmpov"}],["path",{d:"M8 7V6",key:"1nbb54"}],["circle",{cx:"8",cy:"20",r:"2",key:"ckkr5m"}]],FileArchive=createLucideIcon("file-archive",__iconNode$gK);const __iconNode$gJ=[["path",{d:"M13 22h5a2 2 0 0 0 2-2V8a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v3.3",key:"cvl1xm"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"m7.69 16.479 1.29 4.88a.5.5 0 0 1-.698.591l-1.843-.849a1 1 0 0 0-.879.001l-1.846.85a.5.5 0 0 1-.692-.593l1.29-4.88",key:"1ff7gj"}],["circle",{cx:"6",cy:"14",r:"3",key:"a1xfv6"}]],FileBadge=createLucideIcon("file-badge",__iconNode$gJ);const __iconNode$gI=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"m8 18 4-4",key:"12zab0"}],["path",{d:"M8 10v8h8",key:"tlaukw"}]],FileAxis3d=createLucideIcon("file-axis-3d",__iconNode$gI);const __iconNode$gH=[["path",{d:"M14.5 22H18a2 2 0 0 0 2-2V8a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v3.8",key:"1kchwa"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M11.7 14.2 7 17l-4.7-2.8",key:"1yk8tc"}],["path",{d:"M3 13.1a2 2 0 0 0-.999 1.76v3.24a2 2 0 0 0 .969 1.78L6 21.7a2 2 0 0 0 2.03.01L11 19.9a2 2 0 0 0 1-1.76V14.9a2 2 0 0 0-.97-1.78L8 11.3a2 2 0 0 0-2.03-.01z",key:"19flxy"}],["path",{d:"M7 17v5",key:"1yj1jh"}]],FileBox=createLucideIcon("file-box",__iconNode$gH);const __iconNode$gG=[["path",{d:"M14 22h4a2 2 0 0 0 2-2V8a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v6",key:"14cnrg"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M5 14a1 1 0 0 0-1 1v2a1 1 0 0 1-1 1 1 1 0 0 1 1 1v2a1 1 0 0 0 1 1",key:"sr0ebq"}],["path",{d:"M9 22a1 1 0 0 0 1-1v-2a1 1 0 0 1 1-1 1 1 0 0 1-1-1v-2a1 1 0 0 0-1-1",key:"w793db"}]],FileBracesCorner=createLucideIcon("file-braces-corner",__iconNode$gG);const __iconNode$gF=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M10 12a1 1 0 0 0-1 1v1a1 1 0 0 1-1 1 1 1 0 0 1 1 1v1a1 1 0 0 0 1 1",key:"1oajmo"}],["path",{d:"M14 18a1 1 0 0 0 1-1v-1a1 1 0 0 1 1-1 1 1 0 0 1-1-1v-1a1 1 0 0 0-1-1",key:"mpwhp6"}]],FileBraces=createLucideIcon("file-braces",__iconNode$gF);const __iconNode$gE=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M8 18v-2",key:"qcmpov"}],["path",{d:"M12 18v-4",key:"q1q25u"}],["path",{d:"M16 18v-6",key:"15y0np"}]],FileChartColumnIncreasing=createLucideIcon("file-chart-column-increasing",__iconNode$gE);const __iconNode$gD=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M8 18v-1",key:"zg0ygc"}],["path",{d:"M12 18v-6",key:"17g6i2"}],["path",{d:"M16 18v-3",key:"j5jt4h"}]],FileChartColumn=createLucideIcon("file-chart-column",__iconNode$gD);const __iconNode$gC=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"m16 13-3.5 3.5-2-2L8 17",key:"zz7yod"}]],FileChartLine=createLucideIcon("file-chart-line",__iconNode$gC);const __iconNode$gB=[["path",{d:"M15.941 22H18a2 2 0 0 0 2-2V8a2.4 2.4 0 0 0-.706-1.704l-3.588-3.588A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v3.512",key:"13hoie"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M4.017 11.512a6 6 0 1 0 8.466 8.475",key:"s6vs5t"}],["path",{d:"M9 16a1 1 0 0 1-1-1v-4c0-.552.45-1.008.995-.917a6 6 0 0 1 4.922 4.922c.091.544-.365.995-.917.995z",key:"1dl6s6"}]],FileChartPie=createLucideIcon("file-chart-pie",__iconNode$gB);const __iconNode$gA=[["path",{d:"M10.5 22H6a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.706.706l3.588 3.588A2.4 2.4 0 0 1 20 8v6",key:"g5mvt7"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"m14 20 2 2 4-4",key:"15kota"}]],FileCheckCorner=createLucideIcon("file-check-corner",__iconNode$gA);const __iconNode$gz=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"m9 15 2 2 4-4",key:"1grp1n"}]],FileCheck=createLucideIcon("file-check",__iconNode$gz);const __iconNode$gy=[["path",{d:"M16 22h2a2 2 0 0 0 2-2V8a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v2.85",key:"ryk6xj"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M8 14v2.2l1.6 1",key:"6m4bie"}],["circle",{cx:"8",cy:"16",r:"6",key:"10v15b"}]],FileClock=createLucideIcon("file-clock",__iconNode$gy);const __iconNode$gx=[["path",{d:"M4 12.15V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.706.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2h-3.35",key:"1wthlu"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"m5 16-3 3 3 3",key:"331omg"}],["path",{d:"m9 22 3-3-3-3",key:"lsp7cz"}]],FileCodeCorner=createLucideIcon("file-code-corner",__iconNode$gx);const __iconNode$gw=[["path",{d:"M13.85 22H18a2 2 0 0 0 2-2V8a2 2 0 0 0-.586-1.414l-4-4A2 2 0 0 0 14 2H6a2 2 0 0 0-2 2v6.6",key:"1l4p50"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"m3.305 19.53.923-.382",key:"ao1pio"}],["path",{d:"m4.228 16.852-.924-.383",key:"1fv9zy"}],["path",{d:"m5.852 15.228-.383-.923",key:"1a9hc2"}],["path",{d:"m5.852 20.772-.383.924",key:"1sh9ke"}],["path",{d:"m8.148 15.228.383-.923",key:"4yu6lf"}],["path",{d:"m8.53 21.696-.382-.924",key:"18b0s9"}],["path",{d:"m9.773 16.852.922-.383",key:"ti6xop"}],["path",{d:"m9.773 19.148.922.383",key:"rws47d"}],["circle",{cx:"7",cy:"18",r:"3",key:"lvkj7j"}]],FileCog=createLucideIcon("file-cog",__iconNode$gw);const __iconNode$gv=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M10 12.5 8 15l2 2.5",key:"1tg20x"}],["path",{d:"m14 12.5 2 2.5-2 2.5",key:"yinavb"}]],FileCode=createLucideIcon("file-code",__iconNode$gv);const __iconNode$gu=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M9 10h6",key:"9gxzsh"}],["path",{d:"M12 13V7",key:"h0r20n"}],["path",{d:"M9 17h6",key:"r8uit2"}]],FileDiff=createLucideIcon("file-diff",__iconNode$gu);const __iconNode$gt=[["path",{d:"M4 12V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.706.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2",key:"jrl274"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M10 16h2v6",key:"1bxocy"}],["path",{d:"M10 22h4",key:"ceow96"}],["rect",{x:"2",y:"16",width:"4",height:"6",rx:"2",key:"r45zd0"}]],FileDigit=createLucideIcon("file-digit",__iconNode$gt);const __iconNode$gs=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M12 18v-6",key:"17g6i2"}],["path",{d:"m9 15 3 3 3-3",key:"1npd3o"}]],FileDown=createLucideIcon("file-down",__iconNode$gs);const __iconNode$gr=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M12 9v4",key:"juzpu7"}],["path",{d:"M12 17h.01",key:"p32p05"}]],FileExclamationPoint=createLucideIcon("file-exclamation-point",__iconNode$gr);const __iconNode$gq=[["path",{d:"M4 6.835V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.706.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2h-.343",key:"1vfytu"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M2 19a2 2 0 0 1 4 0v1a2 2 0 0 1-4 0v-4a6 6 0 0 1 12 0v4a2 2 0 0 1-4 0v-1a2 2 0 0 1 4 0",key:"1etmh7"}]],FileHeadphone=createLucideIcon("file-headphone",__iconNode$gq);const __iconNode$gp=[["path",{d:"M13 22h5a2 2 0 0 0 2-2V8a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v7",key:"oagw2b"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M3.62 18.8A2.25 2.25 0 1 1 7 15.836a2.25 2.25 0 1 1 3.38 2.966l-2.626 2.856a1 1 0 0 1-1.507 0z",key:"rg3psg"}]],FileHeart=createLucideIcon("file-heart",__iconNode$gp);const __iconNode$go=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["circle",{cx:"10",cy:"12",r:"2",key:"737tya"}],["path",{d:"m20 17-1.296-1.296a2.41 2.41 0 0 0-3.408 0L9 22",key:"wt3hpn"}]],FileImage=createLucideIcon("file-image",__iconNode$go);const __iconNode$gn=[["path",{d:"M4 11V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.706.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2v-1",key:"1q9hii"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M2 15h10",key:"jfw4w8"}],["path",{d:"m9 18 3-3-3-3",key:"112psh"}]],FileInput=createLucideIcon("file-input",__iconNode$gn);const __iconNode$gm=[["path",{d:"M10.65 22H18a2 2 0 0 0 2-2V8a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v10.1",key:"1a2hbp"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"m10 15 1 1",key:"1h4vmv"}],["path",{d:"m11 14-4.586 4.586",key:"maylof"}],["circle",{cx:"5",cy:"20",r:"2",key:"860zyv"}]],FileKey=createLucideIcon("file-key",__iconNode$gm);const __iconNode$gl=[["path",{d:"M4 9.8V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.706.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2h-3",key:"1432pc"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M9 17v-2a2 2 0 0 0-4 0v2",key:"168m41"}],["rect",{width:"8",height:"5",x:"3",y:"17",rx:"1",key:"o8vfew"}]],FileLock=createLucideIcon("file-lock",__iconNode$gl);const __iconNode$gk=[["path",{d:"M20 14V8a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12",key:"l9p8hp"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M14 18h6",key:"1m8k6r"}]],FileMinusCorner=createLucideIcon("file-minus-corner",__iconNode$gk);const __iconNode$gj=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M9 15h6",key:"cctwl0"}]],FileMinus=createLucideIcon("file-minus",__iconNode$gj);const __iconNode$gi=[["path",{d:"M11.65 22H18a2 2 0 0 0 2-2V8a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v10.35",key:"5ad7z2"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M8 20v-7l3 1.474",key:"1ggyb9"}],["circle",{cx:"6",cy:"20",r:"2",key:"j7wjp0"}]],FileMusic=createLucideIcon("file-music",__iconNode$gi);const __iconNode$gh=[["path",{d:"M4.226 20.925A2 2 0 0 0 6 22h12a2 2 0 0 0 2-2V8a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v3.127",key:"wfxp4w"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"m5 11-3 3",key:"1dgrs4"}],["path",{d:"m5 17-3-3h10",key:"1mvvaf"}]],FileOutput=createLucideIcon("file-output",__iconNode$gh);const __iconNode$gg=[["path",{d:"m18.226 5.226-2.52-2.52A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-.351",key:"1k2beg"}],["path",{d:"M21.378 12.626a1 1 0 0 0-3.004-3.004l-4.01 4.012a2 2 0 0 0-.506.854l-.837 2.87a.5.5 0 0 0 .62.62l2.87-.837a2 2 0 0 0 .854-.506z",key:"2t3380"}],["path",{d:"M8 18h1",key:"13wk12"}]],FilePenLine=createLucideIcon("file-pen-line",__iconNode$gg);const __iconNode$gf=[["path",{d:"M12.659 22H18a2 2 0 0 0 2-2V8a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v9.34",key:"o6klzx"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M10.378 12.622a1 1 0 0 1 3 3.003L8.36 20.637a2 2 0 0 1-.854.506l-2.867.837a.5.5 0 0 1-.62-.62l.836-2.869a2 2 0 0 1 .506-.853z",key:"zhnas1"}]],FilePen=createLucideIcon("file-pen",__iconNode$gf);const __iconNode$ge=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M15.033 13.44a.647.647 0 0 1 0 1.12l-4.065 2.352a.645.645 0 0 1-.968-.56v-4.704a.645.645 0 0 1 .967-.56z",key:"1tzo1f"}]],FilePlay=createLucideIcon("file-play",__iconNode$ge);const __iconNode$gd=[["path",{d:"M11.35 22H6a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.706.706l3.588 3.588A2.4 2.4 0 0 1 20 8v5.35",key:"17jvcc"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M14 19h6",key:"bvotb8"}],["path",{d:"M17 16v6",key:"18yu1i"}]],FilePlusCorner=createLucideIcon("file-plus-corner",__iconNode$gd);const __iconNode$gc=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M9 15h6",key:"cctwl0"}],["path",{d:"M12 18v-6",key:"17g6i2"}]],FilePlus=createLucideIcon("file-plus",__iconNode$gc);const __iconNode$gb=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M12 17h.01",key:"p32p05"}],["path",{d:"M9.1 9a3 3 0 0 1 5.82 1c0 2-3 3-3 3",key:"mhlwft"}]],FileQuestionMark=createLucideIcon("file-question-mark",__iconNode$gb);const __iconNode$ga=[["path",{d:"M20 10V8a2.4 2.4 0 0 0-.706-1.704l-3.588-3.588A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h4.35",key:"1cdjst"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M16 14a2 2 0 0 0-2 2",key:"ceaadl"}],["path",{d:"M16 22a2 2 0 0 1-2-2",key:"1wqh5n"}],["path",{d:"M20 14a2 2 0 0 1 2 2",key:"1ny6zw"}],["path",{d:"M20 22a2 2 0 0 0 2-2",key:"1l9q4k"}]],FileScan=createLucideIcon("file-scan",__iconNode$ga);const __iconNode$g9=[["path",{d:"M11.1 22H6a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.706.706l3.589 3.588A2.4 2.4 0 0 1 20 8v3.25",key:"uh4ikj"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"m21 22-2.88-2.88",key:"9dd25w"}],["circle",{cx:"16",cy:"17",r:"3",key:"11br10"}]],FileSearchCorner=createLucideIcon("file-search-corner",__iconNode$g9);const __iconNode$g8=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["circle",{cx:"11.5",cy:"14.5",r:"2.5",key:"1bq0ko"}],["path",{d:"M13.3 16.3 15 18",key:"2quom7"}]],FileSearch=createLucideIcon("file-search",__iconNode$g8);const __iconNode$g7=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M8 15h.01",key:"a7atzg"}],["path",{d:"M11.5 13.5a2.5 2.5 0 0 1 0 3",key:"1fccat"}],["path",{d:"M15 12a5 5 0 0 1 0 6",key:"ps46cm"}]],FileSignal=createLucideIcon("file-signal",__iconNode$g7);const __iconNode$g6=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M8 12h8",key:"1wcyev"}],["path",{d:"M10 11v2",key:"1s651w"}],["path",{d:"M8 17h8",key:"wh5c61"}],["path",{d:"M14 16v2",key:"12fp5e"}]],FileSliders=createLucideIcon("file-sliders",__iconNode$g6);const __iconNode$g5=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M8 13h2",key:"yr2amv"}],["path",{d:"M14 13h2",key:"un5t4a"}],["path",{d:"M8 17h2",key:"2yhykz"}],["path",{d:"M14 17h2",key:"10kma7"}]],FileSpreadsheet=createLucideIcon("file-spreadsheet",__iconNode$g5);const __iconNode$g4=[["path",{d:"M11 21a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1v-8a1 1 0 0 1 1-1",key:"likhh7"}],["path",{d:"M16 16a1 1 0 0 1-1 1H9a1 1 0 0 1-1-1V8a1 1 0 0 1 1-1",key:"17ky3x"}],["path",{d:"M21 6a2 2 0 0 0-.586-1.414l-2-2A2 2 0 0 0 17 2h-3a1 1 0 0 0-1 1v8a1 1 0 0 0 1 1h6a1 1 0 0 0 1-1z",key:"1hyeo0"}]],FileStack=createLucideIcon("file-stack",__iconNode$g4);const __iconNode$g3=[["path",{d:"M4 11V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.706.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2v-3a2 2 0 0 1 2-2h7",key:"huwfnr"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"m10 18 3-3-3-3",key:"18f6ys"}]],FileSymlink=createLucideIcon("file-symlink",__iconNode$g3);const __iconNode$g2=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"m8 16 2-2-2-2",key:"10vzyd"}],["path",{d:"M12 18h4",key:"1wd2n7"}]],FileTerminal=createLucideIcon("file-terminal",__iconNode$g2);const __iconNode$g1=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M10 9H8",key:"b1mrlr"}],["path",{d:"M16 13H8",key:"t4e002"}],["path",{d:"M16 17H8",key:"z1uh3a"}]],FileText=createLucideIcon("file-text",__iconNode$g1);const __iconNode$g0=[["path",{d:"M12 22h6a2 2 0 0 0 2-2V8a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v6",key:"15usau"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M3 16v-1.5a.5.5 0 0 1 .5-.5h7a.5.5 0 0 1 .5.5V16",key:"s1gz5"}],["path",{d:"M6 22h2",key:"194x9m"}],["path",{d:"M7 14v8",key:"11ixej"}]],FileTypeCorner=createLucideIcon("file-type-corner",__iconNode$g0);const __iconNode$f$=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M11 18h2",key:"12mj7e"}],["path",{d:"M12 12v6",key:"3ahymv"}],["path",{d:"M9 13v-.5a.5.5 0 0 1 .5-.5h5a.5.5 0 0 1 .5.5v.5",key:"qbrxap"}]],FileType=createLucideIcon("file-type",__iconNode$f$);const __iconNode$f_=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M12 12v6",key:"3ahymv"}],["path",{d:"m15 15-3-3-3 3",key:"15xj92"}]],FileUp=createLucideIcon("file-up",__iconNode$f_);const __iconNode$fZ=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M16 22a4 4 0 0 0-8 0",key:"7a83pg"}],["circle",{cx:"12",cy:"15",r:"3",key:"g36mzq"}]],FileUser=createLucideIcon("file-user",__iconNode$fZ);const __iconNode$fY=[["path",{d:"M4 12V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.706.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2",key:"jrl274"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"m10 17.843 3.033-1.755a.64.64 0 0 1 .967.56v4.704a.65.65 0 0 1-.967.56L10 20.157",key:"17aeo9"}],["rect",{width:"7",height:"6",x:"3",y:"16",rx:"1",key:"s27ndx"}]],FileVideoCamera=createLucideIcon("file-video-camera",__iconNode$fY);const __iconNode$fX=[["path",{d:"M4 11.55V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.706.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2h-1.95",key:"44gpjv"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M12 15a5 5 0 0 1 0 6",key:"oxg87a"}],["path",{d:"M8 14.502a.5.5 0 0 0-.826-.381l-1.893 1.631a1 1 0 0 1-.651.243H3.5a.5.5 0 0 0-.5.501v3.006a.5.5 0 0 0 .5.501h1.129a1 1 0 0 1 .652.243l1.893 1.633a.5.5 0 0 0 .826-.38z",key:"8rtoi1"}]],FileVolume=createLucideIcon("file-volume",__iconNode$fX);const __iconNode$fW=[["path",{d:"M11 22H6a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.706.706l3.588 3.588A2.4 2.4 0 0 1 20 8v5",key:"1jo35a"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"m15 17 5 5",key:"36xl1x"}],["path",{d:"m20 17-5 5",key:"vdz27y"}]],FileXCorner=createLucideIcon("file-x-corner",__iconNode$fW);const __iconNode$fV=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"m14.5 12.5-5 5",key:"b62r18"}],["path",{d:"m9.5 12.5 5 5",key:"1rk7el"}]],FileX=createLucideIcon("file-x",__iconNode$fV);const __iconNode$fU=[["path",{d:"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z",key:"1oefj6"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}]],File=createLucideIcon("file",__iconNode$fU);const __iconNode$fT=[["path",{d:"M15 2h-4a2 2 0 0 0-2 2v11a2 2 0 0 0 2 2h8a2 2 0 0 0 2-2V8",key:"14sh0y"}],["path",{d:"M16.706 2.706A2.4 2.4 0 0 0 15 2v5a1 1 0 0 0 1 1h5a2.4 2.4 0 0 0-.706-1.706z",key:"1970lx"}],["path",{d:"M5 7a2 2 0 0 0-2 2v11a2 2 0 0 0 2 2h8a2 2 0 0 0 1.732-1",key:"l4dndm"}]],Files=createLucideIcon("files",__iconNode$fT);const __iconNode$fS=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M7 3v18",key:"bbkbws"}],["path",{d:"M3 7.5h4",key:"zfgn84"}],["path",{d:"M3 12h18",key:"1i2n21"}],["path",{d:"M3 16.5h4",key:"1230mu"}],["path",{d:"M17 3v18",key:"in4fa5"}],["path",{d:"M17 7.5h4",key:"myr1c1"}],["path",{d:"M17 16.5h4",key:"go4c1d"}]],Film=createLucideIcon("film",__iconNode$fS);const __iconNode$fR=[["path",{d:"M12 10a2 2 0 0 0-2 2c0 1.02-.1 2.51-.26 4",key:"1nerag"}],["path",{d:"M14 13.12c0 2.38 0 6.38-1 8.88",key:"o46ks0"}],["path",{d:"M17.29 21.02c.12-.6.43-2.3.5-3.02",key:"ptglia"}],["path",{d:"M2 12a10 10 0 0 1 18-6",key:"ydlgp0"}],["path",{d:"M2 16h.01",key:"1gqxmh"}],["path",{d:"M21.8 16c.2-2 .131-5.354 0-6",key:"drycrb"}],["path",{d:"M5 19.5C5.5 18 6 15 6 12a6 6 0 0 1 .34-2",key:"1tidbn"}],["path",{d:"M8.65 22c.21-.66.45-1.32.57-2",key:"13wd9y"}],["path",{d:"M9 6.8a6 6 0 0 1 9 5.2v2",key:"1fr1j5"}]],FingerprintPattern=createLucideIcon("fingerprint-pattern",__iconNode$fR);const __iconNode$fQ=[["path",{d:"M15 6.5V3a1 1 0 0 0-1-1h-2a1 1 0 0 0-1 1v3.5",key:"sqyvz"}],["path",{d:"M9 18h8",key:"i7pszb"}],["path",{d:"M18 3h-3",key:"7idoqj"}],["path",{d:"M11 3a6 6 0 0 0-6 6v11",key:"1v5je3"}],["path",{d:"M5 13h4",key:"svpcxo"}],["path",{d:"M17 10a4 4 0 0 0-8 0v10a2 2 0 0 0 2 2h4a2 2 0 0 0 2-2Z",key:"vsjego"}]],FireExtinguisher=createLucideIcon("fire-extinguisher",__iconNode$fQ);const __iconNode$fP=[["path",{d:"M18 12.47v.03m0-.5v.47m-.475 5.056A6.744 6.744 0 0 1 15 18c-3.56 0-7.56-2.53-8.5-6 .348-1.28 1.114-2.433 2.121-3.38m3.444-2.088A8.802 8.802 0 0 1 15 6c3.56 0 6.06 2.54 7 6-.309 1.14-.786 2.177-1.413 3.058",key:"1j1hse"}],["path",{d:"M7 10.67C7 8 5.58 5.97 2.73 5.5c-1 1.5-1 5 .23 6.5-1.24 1.5-1.24 5-.23 6.5C5.58 18.03 7 16 7 13.33m7.48-4.372A9.77 9.77 0 0 1 16 6.07m0 11.86a9.77 9.77 0 0 1-1.728-3.618",key:"1q46z8"}],["path",{d:"m16.01 17.93-.23 1.4A2 2 0 0 1 13.8 21H9.5a5.96 5.96 0 0 0 1.49-3.98M8.53 3h5.27a2 2 0 0 1 1.98 1.67l.23 1.4M2 2l20 20",key:"1407gh"}]],FishOff=createLucideIcon("fish-off",__iconNode$fP);const __iconNode$fO=[["path",{d:"M2 16s9-15 20-4C11 23 2 8 2 8",key:"h4oh4o"}]],FishSymbol=createLucideIcon("fish-symbol",__iconNode$fO);const __iconNode$fN=[["path",{d:"M6.5 12c.94-3.46 4.94-6 8.5-6 3.56 0 6.06 2.54 7 6-.94 3.47-3.44 6-7 6s-7.56-2.53-8.5-6Z",key:"15baut"}],["path",{d:"M18 12v.5",key:"18hhni"}],["path",{d:"M16 17.93a9.77 9.77 0 0 1 0-11.86",key:"16dt7o"}],["path",{d:"M7 10.67C7 8 5.58 5.97 2.73 5.5c-1 1.5-1 5 .23 6.5-1.24 1.5-1.24 5-.23 6.5C5.58 18.03 7 16 7 13.33",key:"l9di03"}],["path",{d:"M10.46 7.26C10.2 5.88 9.17 4.24 8 3h5.8a2 2 0 0 1 1.98 1.67l.23 1.4",key:"1kjonw"}],["path",{d:"m16.01 17.93-.23 1.4A2 2 0 0 1 13.8 21H9.5a5.96 5.96 0 0 0 1.49-3.98",key:"1zlm23"}]],Fish=createLucideIcon("fish",__iconNode$fN);const __iconNode$fM=[["path",{d:"M16 16c-3 0-5-2-8-2a6 6 0 0 0-4 1.528",key:"1q158e"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M4 22V4",key:"1plyxx"}],["path",{d:"M7.656 2H8c3 0 5 2 7.333 2q2 0 3.067-.8A1 1 0 0 1 20 4v10.347",key:"xj1b71"}]],FlagOff=createLucideIcon("flag-off",__iconNode$fM);const __iconNode$fL=[["path",{d:"M18 22V2.8a.8.8 0 0 0-1.17-.71L5.45 7.78a.8.8 0 0 0 0 1.44L18 15.5",key:"rbbtmw"}]],FlagTriangleLeft=createLucideIcon("flag-triangle-left",__iconNode$fL);const __iconNode$fK=[["path",{d:"M6 22V2.8a.8.8 0 0 1 1.17-.71l11.38 5.69a.8.8 0 0 1 0 1.44L6 15.5",key:"kfjsu0"}]],FlagTriangleRight=createLucideIcon("flag-triangle-right",__iconNode$fK);const __iconNode$fJ=[["path",{d:"M4 22V4a1 1 0 0 1 .4-.8A6 6 0 0 1 8 2c3 0 5 2 7.333 2q2 0 3.067-.8A1 1 0 0 1 20 4v10a1 1 0 0 1-.4.8A6 6 0 0 1 16 16c-3 0-5-2-8-2a6 6 0 0 0-4 1.528",key:"1jaruq"}]],Flag=createLucideIcon("flag",__iconNode$fJ);const __iconNode$fI=[["path",{d:"M12 2c1 3 2.5 3.5 3.5 4.5A5 5 0 0 1 17 10a5 5 0 1 1-10 0c0-.3 0-.6.1-.9a2 2 0 1 0 3.3-2C8 4.5 11 2 12 2Z",key:"1ir223"}],["path",{d:"m5 22 14-4",key:"1brv4h"}],["path",{d:"m5 18 14 4",key:"lgyyje"}]],FlameKindling=createLucideIcon("flame-kindling",__iconNode$fI);const __iconNode$fH=[["path",{d:"M12 3q1 4 4 6.5t3 5.5a1 1 0 0 1-14 0 5 5 0 0 1 1-3 1 1 0 0 0 5 0c0-2-1.5-3-1.5-5q0-2 2.5-4",key:"1slcih"}]],Flame=createLucideIcon("flame",__iconNode$fH);const __iconNode$fG=[["path",{d:"M16 16v4a2 2 0 0 1-2 2h-4a2 2 0 0 1-2-2V10c0-2-2-2-2-4",key:"1r120k"}],["path",{d:"M7 2h11v4c0 2-2 2-2 4v1",key:"dz1920"}],["line",{x1:"11",x2:"18",y1:"6",y2:"6",key:"bi1vpe"}],["line",{x1:"2",x2:"22",y1:"2",y2:"22",key:"a6p6uj"}]],FlashlightOff=createLucideIcon("flashlight-off",__iconNode$fG);const __iconNode$fF=[["path",{d:"M18 6c0 2-2 2-2 4v10a2 2 0 0 1-2 2h-4a2 2 0 0 1-2-2V10c0-2-2-2-2-4V2h12z",key:"1orkel"}],["line",{x1:"6",x2:"18",y1:"6",y2:"6",key:"1z11jq"}],["line",{x1:"12",x2:"12",y1:"12",y2:"12",key:"1f4yc1"}]],Flashlight=createLucideIcon("flashlight",__iconNode$fF);const __iconNode$fE=[["path",{d:"M14 2v6a2 2 0 0 0 .245.96l5.51 10.08A2 2 0 0 1 18 22H6a2 2 0 0 1-1.755-2.96l5.51-10.08A2 2 0 0 0 10 8V2",key:"18mbvz"}],["path",{d:"M6.453 15h11.094",key:"3shlmq"}],["path",{d:"M8.5 2h7",key:"csnxdl"}]],FlaskConical=createLucideIcon("flask-conical",__iconNode$fE);const __iconNode$fD=[["path",{d:"M10 2v2.343",key:"15t272"}],["path",{d:"M14 2v6.343",key:"sxr80q"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M20 20a2 2 0 0 1-2 2H6a2 2 0 0 1-1.755-2.96l5.227-9.563",key:"k0duyd"}],["path",{d:"M6.453 15H15",key:"1f0z33"}],["path",{d:"M8.5 2h7",key:"csnxdl"}]],FlaskConicalOff=createLucideIcon("flask-conical-off",__iconNode$fD);const __iconNode$fC=[["path",{d:"M10 2v6.292a7 7 0 1 0 4 0V2",key:"1s42pc"}],["path",{d:"M5 15h14",key:"m0yey3"}],["path",{d:"M8.5 2h7",key:"csnxdl"}]],FlaskRound=createLucideIcon("flask-round",__iconNode$fC);const __iconNode$fB=[["path",{d:"m3 7 5 5-5 5V7",key:"couhi7"}],["path",{d:"m21 7-5 5 5 5V7",key:"6ouia7"}],["path",{d:"M12 20v2",key:"1lh1kg"}],["path",{d:"M12 14v2",key:"8jcxud"}],["path",{d:"M12 8v2",key:"1woqiv"}],["path",{d:"M12 2v2",key:"tus03m"}]],FlipHorizontal2=createLucideIcon("flip-horizontal-2",__iconNode$fB);const __iconNode$fA=[["path",{d:"M8 3H5a2 2 0 0 0-2 2v14c0 1.1.9 2 2 2h3",key:"1i73f7"}],["path",{d:"M16 3h3a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2h-3",key:"saxlbk"}],["path",{d:"M12 20v2",key:"1lh1kg"}],["path",{d:"M12 14v2",key:"8jcxud"}],["path",{d:"M12 8v2",key:"1woqiv"}],["path",{d:"M12 2v2",key:"tus03m"}]],FlipHorizontal=createLucideIcon("flip-horizontal",__iconNode$fA);const __iconNode$fz=[["path",{d:"m17 3-5 5-5-5h10",key:"1ftt6x"}],["path",{d:"m17 21-5-5-5 5h10",key:"1m0wmu"}],["path",{d:"M4 12H2",key:"rhcxmi"}],["path",{d:"M10 12H8",key:"s88cx1"}],["path",{d:"M16 12h-2",key:"10asgb"}],["path",{d:"M22 12h-2",key:"14jgyd"}]],FlipVertical2=createLucideIcon("flip-vertical-2",__iconNode$fz);const __iconNode$fy=[["path",{d:"M21 8V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v3",key:"14bfxa"}],["path",{d:"M21 16v3a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-3",key:"14rx03"}],["path",{d:"M4 12H2",key:"rhcxmi"}],["path",{d:"M10 12H8",key:"s88cx1"}],["path",{d:"M16 12h-2",key:"10asgb"}],["path",{d:"M22 12h-2",key:"14jgyd"}]],FlipVertical=createLucideIcon("flip-vertical",__iconNode$fy);const __iconNode$fx=[["circle",{cx:"12",cy:"12",r:"3",key:"1v7zrd"}],["path",{d:"M12 16.5A4.5 4.5 0 1 1 7.5 12 4.5 4.5 0 1 1 12 7.5a4.5 4.5 0 1 1 4.5 4.5 4.5 4.5 0 1 1-4.5 4.5",key:"14wa3c"}],["path",{d:"M12 7.5V9",key:"1oy5b0"}],["path",{d:"M7.5 12H9",key:"eltsq1"}],["path",{d:"M16.5 12H15",key:"vk5kw4"}],["path",{d:"M12 16.5V15",key:"k7eayi"}],["path",{d:"m8 8 1.88 1.88",key:"nxy4qf"}],["path",{d:"M14.12 9.88 16 8",key:"1lst6k"}],["path",{d:"m8 16 1.88-1.88",key:"h2eex1"}],["path",{d:"M14.12 14.12 16 16",key:"uqkrx3"}]],Flower=createLucideIcon("flower",__iconNode$fx);const __iconNode$fw=[["path",{d:"M12 5a3 3 0 1 1 3 3m-3-3a3 3 0 1 0-3 3m3-3v1M9 8a3 3 0 1 0 3 3M9 8h1m5 0a3 3 0 1 1-3 3m3-3h-1m-2 3v-1",key:"3pnvol"}],["circle",{cx:"12",cy:"8",r:"2",key:"1822b1"}],["path",{d:"M12 10v12",key:"6ubwww"}],["path",{d:"M12 22c4.2 0 7-1.667 7-5-4.2 0-7 1.667-7 5Z",key:"9hd38g"}],["path",{d:"M12 22c-4.2 0-7-1.667-7-5 4.2 0 7 1.667 7 5Z",key:"ufn41s"}]],Flower2=createLucideIcon("flower-2",__iconNode$fw);const __iconNode$fv=[["circle",{cx:"12",cy:"12",r:"3",key:"1v7zrd"}],["path",{d:"M3 7V5a2 2 0 0 1 2-2h2",key:"aa7l1z"}],["path",{d:"M17 3h2a2 2 0 0 1 2 2v2",key:"4qcy5o"}],["path",{d:"M21 17v2a2 2 0 0 1-2 2h-2",key:"6vwrx8"}],["path",{d:"M7 21H5a2 2 0 0 1-2-2v-2",key:"ioqczr"}]],Focus=createLucideIcon("focus",__iconNode$fv);const __iconNode$fu=[["path",{d:"M2 12h6",key:"1wqiqv"}],["path",{d:"M22 12h-6",key:"1eg9hc"}],["path",{d:"M12 2v2",key:"tus03m"}],["path",{d:"M12 8v2",key:"1woqiv"}],["path",{d:"M12 14v2",key:"8jcxud"}],["path",{d:"M12 20v2",key:"1lh1kg"}],["path",{d:"m19 9-3 3 3 3",key:"12ol22"}],["path",{d:"m5 15 3-3-3-3",key:"1kdhjc"}]],FoldHorizontal=createLucideIcon("fold-horizontal",__iconNode$fu);const __iconNode$ft=[["path",{d:"M12 22v-6",key:"6o8u61"}],["path",{d:"M12 8V2",key:"1wkif3"}],["path",{d:"M4 12H2",key:"rhcxmi"}],["path",{d:"M10 12H8",key:"s88cx1"}],["path",{d:"M16 12h-2",key:"10asgb"}],["path",{d:"M22 12h-2",key:"14jgyd"}],["path",{d:"m15 19-3-3-3 3",key:"e37ymu"}],["path",{d:"m15 5-3 3-3-3",key:"19d6lf"}]],FoldVertical=createLucideIcon("fold-vertical",__iconNode$ft);const __iconNode$fs=[["circle",{cx:"15",cy:"19",r:"2",key:"u2pros"}],["path",{d:"M20.9 19.8A2 2 0 0 0 22 18V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2h5.1",key:"1jj40k"}],["path",{d:"M15 11v-1",key:"cntcp"}],["path",{d:"M15 17v-2",key:"1279jj"}]],FolderArchive=createLucideIcon("folder-archive",__iconNode$fs);const __iconNode$fr=[["path",{d:"M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z",key:"1kt360"}],["path",{d:"m9 13 2 2 4-4",key:"6343dt"}]],FolderCheck=createLucideIcon("folder-check",__iconNode$fr);const __iconNode$fq=[["path",{d:"M16 14v2.2l1.6 1",key:"fo4ql5"}],["path",{d:"M7 20H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2",key:"1urifu"}],["circle",{cx:"16",cy:"16",r:"6",key:"qoo3c4"}]],FolderClock=createLucideIcon("folder-clock",__iconNode$fq);const __iconNode$fp=[["path",{d:"M10 10.5 8 13l2 2.5",key:"m4t9c1"}],["path",{d:"m14 10.5 2 2.5-2 2.5",key:"14w2eb"}],["path",{d:"M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2z",key:"1u1bxd"}]],FolderCode=createLucideIcon("folder-code",__iconNode$fp);const __iconNode$fo=[["path",{d:"M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z",key:"1kt360"}],["path",{d:"M2 10h20",key:"1ir3d8"}]],FolderClosed=createLucideIcon("folder-closed",__iconNode$fo);const __iconNode$fn=[["path",{d:"M10.3 20H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.98a2 2 0 0 1 1.69.9l.66 1.2A2 2 0 0 0 12 6h8a2 2 0 0 1 2 2v3.3",key:"128dxu"}],["path",{d:"m14.305 19.53.923-.382",key:"3m78fa"}],["path",{d:"m15.228 16.852-.923-.383",key:"npixar"}],["path",{d:"m16.852 15.228-.383-.923",key:"5xggr7"}],["path",{d:"m16.852 20.772-.383.924",key:"dpfhf9"}],["path",{d:"m19.148 15.228.383-.923",key:"1reyyz"}],["path",{d:"m19.53 21.696-.382-.924",key:"1goivc"}],["path",{d:"m20.772 16.852.924-.383",key:"htqkph"}],["path",{d:"m20.772 19.148.924.383",key:"9w9pjp"}],["circle",{cx:"18",cy:"18",r:"3",key:"1xkwt0"}]],FolderCog=createLucideIcon("folder-cog",__iconNode$fn);const __iconNode$fm=[["path",{d:"M4 20h16a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.93a2 2 0 0 1-1.66-.9l-.82-1.2A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13c0 1.1.9 2 2 2Z",key:"1fr9dc"}],["circle",{cx:"12",cy:"13",r:"1",key:"49l61u"}]],FolderDot=createLucideIcon("folder-dot",__iconNode$fm);const __iconNode$fl=[["path",{d:"M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z",key:"1kt360"}],["path",{d:"M12 10v6",key:"1bos4e"}],["path",{d:"m15 13-3 3-3-3",key:"6j2sf0"}]],FolderDown=createLucideIcon("folder-down",__iconNode$fl);const __iconNode$fk=[["path",{d:"M18 19a5 5 0 0 1-5-5v8",key:"sz5oeg"}],["path",{d:"M9 20H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v5",key:"1w6njk"}],["circle",{cx:"13",cy:"12",r:"2",key:"1j92g6"}],["circle",{cx:"20",cy:"19",r:"2",key:"1obnsp"}]],FolderGit2=createLucideIcon("folder-git-2",__iconNode$fk);const __iconNode$fj=[["circle",{cx:"12",cy:"13",r:"2",key:"1c1ljs"}],["path",{d:"M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z",key:"1kt360"}],["path",{d:"M14 13h3",key:"1dgedf"}],["path",{d:"M7 13h3",key:"1pygq7"}]],FolderGit=createLucideIcon("folder-git",__iconNode$fj);const __iconNode$fi=[["path",{d:"M10.638 20H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v3.417",key:"10r6g4"}],["path",{d:"M14.62 18.8A2.25 2.25 0 1 1 18 15.836a2.25 2.25 0 1 1 3.38 2.966l-2.626 2.856a.998.998 0 0 1-1.507 0z",key:"15cy7q"}]],FolderHeart=createLucideIcon("folder-heart",__iconNode$fi);const __iconNode$fh=[["path",{d:"M2 9V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2v-1",key:"fm4g5t"}],["path",{d:"M2 13h10",key:"pgb2dq"}],["path",{d:"m9 16 3-3-3-3",key:"6m91ic"}]],FolderInput=createLucideIcon("folder-input",__iconNode$fh);const __iconNode$fg=[["path",{d:"M4 20h16a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.93a2 2 0 0 1-1.66-.9l-.82-1.2A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13c0 1.1.9 2 2 2Z",key:"1fr9dc"}],["path",{d:"M8 10v4",key:"tgpxqk"}],["path",{d:"M12 10v2",key:"hh53o1"}],["path",{d:"M16 10v6",key:"1d6xys"}]],FolderKanban=createLucideIcon("folder-kanban",__iconNode$fg);const __iconNode$ff=[["circle",{cx:"16",cy:"20",r:"2",key:"1vifvg"}],["path",{d:"M10 20H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v2",key:"3hgo9p"}],["path",{d:"m22 14-4.5 4.5",key:"1ef6z8"}],["path",{d:"m21 15 1 1",key:"1ejcpy"}]],FolderKey=createLucideIcon("folder-key",__iconNode$ff);const __iconNode$fe=[["rect",{width:"8",height:"5",x:"14",y:"17",rx:"1",key:"19aais"}],["path",{d:"M10 20H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v2.5",key:"1w6v7t"}],["path",{d:"M20 17v-2a2 2 0 1 0-4 0v2",key:"pwaxnr"}]],FolderLock=createLucideIcon("folder-lock",__iconNode$fe);const __iconNode$fd=[["path",{d:"M9 13h6",key:"1uhe8q"}],["path",{d:"M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z",key:"1kt360"}]],FolderMinus=createLucideIcon("folder-minus",__iconNode$fd);const __iconNode$fc=[["path",{d:"m6 14 1.45-2.9A2 2 0 0 1 9.24 10H20a2 2 0 0 1 1.94 2.5l-1.55 6a2 2 0 0 1-1.94 1.5H4a2 2 0 0 1-2-2V5c0-1.1.9-2 2-2h3.93a2 2 0 0 1 1.66.9l.82 1.2a2 2 0 0 0 1.66.9H18a2 2 0 0 1 2 2v2",key:"1nmvlm"}],["circle",{cx:"14",cy:"15",r:"1",key:"1gm4qj"}]],FolderOpenDot=createLucideIcon("folder-open-dot",__iconNode$fc);const __iconNode$fb=[["path",{d:"m6 14 1.5-2.9A2 2 0 0 1 9.24 10H20a2 2 0 0 1 1.94 2.5l-1.54 6a2 2 0 0 1-1.95 1.5H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H18a2 2 0 0 1 2 2v2",key:"usdka0"}]],FolderOpen=createLucideIcon("folder-open",__iconNode$fb);const __iconNode$fa=[["path",{d:"M2 7.5V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H4a2 2 0 0 1-2-1.5",key:"1yk7aj"}],["path",{d:"M2 13h10",key:"pgb2dq"}],["path",{d:"m5 10-3 3 3 3",key:"1r8ie0"}]],FolderOutput=createLucideIcon("folder-output",__iconNode$fa);const __iconNode$f9=[["path",{d:"M2 11.5V5a2 2 0 0 1 2-2h3.9c.7 0 1.3.3 1.7.9l.8 1.2c.4.6 1 .9 1.7.9H20a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2h-9.5",key:"a8xqs0"}],["path",{d:"M11.378 13.626a1 1 0 1 0-3.004-3.004l-5.01 5.012a2 2 0 0 0-.506.854l-.837 2.87a.5.5 0 0 0 .62.62l2.87-.837a2 2 0 0 0 .854-.506z",key:"1saktj"}]],FolderPen=createLucideIcon("folder-pen",__iconNode$f9);const __iconNode$f8=[["path",{d:"M12 10v6",key:"1bos4e"}],["path",{d:"M9 13h6",key:"1uhe8q"}],["path",{d:"M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z",key:"1kt360"}]],FolderPlus=createLucideIcon("folder-plus",__iconNode$f8);const __iconNode$f7=[["path",{d:"M4 20h16a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.93a2 2 0 0 1-1.66-.9l-.82-1.2A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13c0 1.1.9 2 2 2Z",key:"1fr9dc"}],["circle",{cx:"12",cy:"13",r:"2",key:"1c1ljs"}],["path",{d:"M12 15v5",key:"11xva1"}]],FolderRoot=createLucideIcon("folder-root",__iconNode$f7);const __iconNode$f6=[["circle",{cx:"11.5",cy:"12.5",r:"2.5",key:"1ea5ju"}],["path",{d:"M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z",key:"1kt360"}],["path",{d:"M13.3 14.3 15 16",key:"1y4v1n"}]],FolderSearch2=createLucideIcon("folder-search-2",__iconNode$f6);const __iconNode$f5=[["path",{d:"M10.7 20H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v4.1",key:"1bw5m7"}],["path",{d:"m21 21-1.9-1.9",key:"1g2n9r"}],["circle",{cx:"17",cy:"17",r:"3",key:"18b49y"}]],FolderSearch=createLucideIcon("folder-search",__iconNode$f5);const __iconNode$f4=[["path",{d:"M2 9.35V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2v-3a2 2 0 0 1 2-2h7",key:"y8kt7d"}],["path",{d:"m8 16 3-3-3-3",key:"rlqrt1"}]],FolderSymlink=createLucideIcon("folder-symlink",__iconNode$f4);const __iconNode$f3=[["path",{d:"M9 20H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v.5",key:"1dkoa9"}],["path",{d:"M12 10v4h4",key:"1czhmt"}],["path",{d:"m12 14 1.535-1.605a5 5 0 0 1 8 1.5",key:"lvuxfi"}],["path",{d:"M22 22v-4h-4",key:"1ewp4q"}],["path",{d:"m22 18-1.535 1.605a5 5 0 0 1-8-1.5",key:"14ync0"}]],FolderSync=createLucideIcon("folder-sync",__iconNode$f3);const __iconNode$f2=[["path",{d:"M20 10a1 1 0 0 0 1-1V6a1 1 0 0 0-1-1h-2.5a1 1 0 0 1-.8-.4l-.9-1.2A1 1 0 0 0 15 3h-2a1 1 0 0 0-1 1v5a1 1 0 0 0 1 1Z",key:"hod4my"}],["path",{d:"M20 21a1 1 0 0 0 1-1v-3a1 1 0 0 0-1-1h-2.9a1 1 0 0 1-.88-.55l-.42-.85a1 1 0 0 0-.92-.6H13a1 1 0 0 0-1 1v5a1 1 0 0 0 1 1Z",key:"w4yl2u"}],["path",{d:"M3 5a2 2 0 0 0 2 2h3",key:"f2jnh7"}],["path",{d:"M3 3v13a2 2 0 0 0 2 2h3",key:"k8epm1"}]],FolderTree=createLucideIcon("folder-tree",__iconNode$f2);const __iconNode$f1=[["path",{d:"M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z",key:"1kt360"}],["path",{d:"M12 10v6",key:"1bos4e"}],["path",{d:"m9 13 3-3 3 3",key:"1pxg3c"}]],FolderUp=createLucideIcon("folder-up",__iconNode$f1);const __iconNode$f0=[["path",{d:"M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z",key:"1kt360"}],["path",{d:"m9.5 10.5 5 5",key:"ra9qjz"}],["path",{d:"m14.5 10.5-5 5",key:"l2rkpq"}]],FolderX=createLucideIcon("folder-x",__iconNode$f0);const __iconNode$e$=[["path",{d:"M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z",key:"1kt360"}]],Folder=createLucideIcon("folder",__iconNode$e$);const __iconNode$e_=[["path",{d:"M20 5a2 2 0 0 1 2 2v7a2 2 0 0 1-2 2H9a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h2.5a1.5 1.5 0 0 1 1.2.6l.6.8a1.5 1.5 0 0 0 1.2.6z",key:"a4852j"}],["path",{d:"M3 8.268a2 2 0 0 0-1 1.738V19a2 2 0 0 0 2 2h11a2 2 0 0 0 1.732-1",key:"yxbcw3"}]],Folders=createLucideIcon("folders",__iconNode$e_);const __iconNode$eZ=[["path",{d:"M4 16v-2.38C4 11.5 2.97 10.5 3 8c.03-2.72 1.49-6 4.5-6C9.37 2 10 3.8 10 5.5c0 3.11-2 5.66-2 8.68V16a2 2 0 1 1-4 0Z",key:"1dudjm"}],["path",{d:"M20 20v-2.38c0-2.12 1.03-3.12 1-5.62-.03-2.72-1.49-6-4.5-6C14.63 6 14 7.8 14 9.5c0 3.11 2 5.66 2 8.68V20a2 2 0 1 0 4 0Z",key:"l2t8xc"}],["path",{d:"M16 17h4",key:"1dejxt"}],["path",{d:"M4 13h4",key:"1bwh8b"}]],Footprints=createLucideIcon("footprints",__iconNode$eZ);const __iconNode$eY=[["path",{d:"M12 12H5a2 2 0 0 0-2 2v5",key:"7zsz91"}],["circle",{cx:"13",cy:"19",r:"2",key:"wjnkru"}],["circle",{cx:"5",cy:"19",r:"2",key:"v8kfzx"}],["path",{d:"M8 19h3m5-17v17h6M6 12V7c0-1.1.9-2 2-2h3l5 5",key:"13bk1p"}]],Forklift=createLucideIcon("forklift",__iconNode$eY);const __iconNode$eX=[["path",{d:"m15 17 5-5-5-5",key:"nf172w"}],["path",{d:"M4 18v-2a4 4 0 0 1 4-4h12",key:"jmiej9"}]],Forward=createLucideIcon("forward",__iconNode$eX);const __iconNode$eW=[["line",{x1:"22",x2:"2",y1:"6",y2:"6",key:"15w7dq"}],["line",{x1:"22",x2:"2",y1:"18",y2:"18",key:"1ip48p"}],["line",{x1:"6",x2:"6",y1:"2",y2:"22",key:"a2lnyx"}],["line",{x1:"18",x2:"18",y1:"2",y2:"22",key:"8vb6jd"}]],Frame=createLucideIcon("frame",__iconNode$eW);const __iconNode$eV=[["path",{d:"M5 16V9h14V2H5l14 14h-7m-7 0 7 7v-7m-7 0h7",key:"1a2nng"}]],Framer=createLucideIcon("framer",__iconNode$eV);const __iconNode$eU=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M16 16s-1.5-2-4-2-4 2-4 2",key:"epbg0q"}],["line",{x1:"9",x2:"9.01",y1:"9",y2:"9",key:"yxxnd0"}],["line",{x1:"15",x2:"15.01",y1:"9",y2:"9",key:"1p4y9e"}]],Frown=createLucideIcon("frown",__iconNode$eU);const __iconNode$eT=[["path",{d:"M14 13h2a2 2 0 0 1 2 2v2a2 2 0 0 0 4 0v-6.998a2 2 0 0 0-.59-1.42L18 5",key:"1wtuz0"}],["path",{d:"M14 21V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v16",key:"e09ifn"}],["path",{d:"M2 21h13",key:"1x0fut"}],["path",{d:"M3 9h11",key:"1p7c0w"}]],Fuel=createLucideIcon("fuel",__iconNode$eT);const __iconNode$eS=[["path",{d:"M3 7V5a2 2 0 0 1 2-2h2",key:"aa7l1z"}],["path",{d:"M17 3h2a2 2 0 0 1 2 2v2",key:"4qcy5o"}],["path",{d:"M21 17v2a2 2 0 0 1-2 2h-2",key:"6vwrx8"}],["path",{d:"M7 21H5a2 2 0 0 1-2-2v-2",key:"ioqczr"}],["rect",{width:"10",height:"8",x:"7",y:"8",rx:"1",key:"vys8me"}]],Fullscreen=createLucideIcon("fullscreen",__iconNode$eS);const __iconNode$eR=[["path",{d:"M12.531 3H3a1 1 0 0 0-.742 1.67l7.225 7.989A2 2 0 0 1 10 14v6a1 1 0 0 0 .553.895l2 1A1 1 0 0 0 14 21v-7a2 2 0 0 1 .517-1.341l.427-.473",key:"ol2ft2"}],["path",{d:"m16.5 3.5 5 5",key:"15e6fa"}],["path",{d:"m21.5 3.5-5 5",key:"m0lwru"}]],FunnelX=createLucideIcon("funnel-x",__iconNode$eR);const __iconNode$eQ=[["path",{d:"M13.354 3H3a1 1 0 0 0-.742 1.67l7.225 7.989A2 2 0 0 1 10 14v6a1 1 0 0 0 .553.895l2 1A1 1 0 0 0 14 21v-7a2 2 0 0 1 .517-1.341l1.218-1.348",key:"8mvsmf"}],["path",{d:"M16 6h6",key:"1dogtp"}],["path",{d:"M19 3v6",key:"1ytpjt"}]],FunnelPlus=createLucideIcon("funnel-plus",__iconNode$eQ);const __iconNode$eP=[["path",{d:"M2 7v10",key:"a2pl2d"}],["path",{d:"M6 5v14",key:"1kq3d7"}],["rect",{width:"12",height:"18",x:"10",y:"3",rx:"2",key:"13i7bc"}]],GalleryHorizontalEnd=createLucideIcon("gallery-horizontal-end",__iconNode$eP);const __iconNode$eO=[["path",{d:"M10 20a1 1 0 0 0 .553.895l2 1A1 1 0 0 0 14 21v-7a2 2 0 0 1 .517-1.341L21.74 4.67A1 1 0 0 0 21 3H3a1 1 0 0 0-.742 1.67l7.225 7.989A2 2 0 0 1 10 14z",key:"sc7q7i"}]],Funnel=createLucideIcon("funnel",__iconNode$eO);const __iconNode$eN=[["path",{d:"M2 3v18",key:"pzttux"}],["rect",{width:"12",height:"18",x:"6",y:"3",rx:"2",key:"btr8bg"}],["path",{d:"M22 3v18",key:"6jf3v"}]],GalleryHorizontal=createLucideIcon("gallery-horizontal",__iconNode$eN);const __iconNode$eM=[["rect",{width:"18",height:"14",x:"3",y:"3",rx:"2",key:"74y24f"}],["path",{d:"M4 21h1",key:"16zlid"}],["path",{d:"M9 21h1",key:"15o7lz"}],["path",{d:"M14 21h1",key:"v9vybs"}],["path",{d:"M19 21h1",key:"edywat"}]],GalleryThumbnails=createLucideIcon("gallery-thumbnails",__iconNode$eM);const __iconNode$eL=[["path",{d:"M7 2h10",key:"nczekb"}],["path",{d:"M5 6h14",key:"u2x4p"}],["rect",{width:"18",height:"12",x:"3",y:"10",rx:"2",key:"l0tzu3"}]],GalleryVerticalEnd=createLucideIcon("gallery-vertical-end",__iconNode$eL);const __iconNode$eK=[["path",{d:"M3 2h18",key:"15qxfx"}],["rect",{width:"18",height:"12",x:"3",y:"6",rx:"2",key:"1439r6"}],["path",{d:"M3 22h18",key:"8prr45"}]],GalleryVertical=createLucideIcon("gallery-vertical",__iconNode$eK);const __iconNode$eJ=[["line",{x1:"6",x2:"10",y1:"11",y2:"11",key:"1gktln"}],["line",{x1:"8",x2:"8",y1:"9",y2:"13",key:"qnk9ow"}],["line",{x1:"15",x2:"15.01",y1:"12",y2:"12",key:"krot7o"}],["line",{x1:"18",x2:"18.01",y1:"10",y2:"10",key:"1lcuu1"}],["path",{d:"M17.32 5H6.68a4 4 0 0 0-3.978 3.59c-.006.052-.01.101-.017.152C2.604 9.416 2 14.456 2 16a3 3 0 0 0 3 3c1 0 1.5-.5 2-1l1.414-1.414A2 2 0 0 1 9.828 16h4.344a2 2 0 0 1 1.414.586L17 18c.5.5 1 1 2 1a3 3 0 0 0 3-3c0-1.545-.604-6.584-.685-7.258-.007-.05-.011-.1-.017-.151A4 4 0 0 0 17.32 5z",key:"mfqc10"}]],Gamepad2=createLucideIcon("gamepad-2",__iconNode$eJ);const __iconNode$eI=[["path",{d:"M11.146 15.854a1.207 1.207 0 0 1 1.708 0l1.56 1.56A2 2 0 0 1 15 18.828V21a1 1 0 0 1-1 1h-4a1 1 0 0 1-1-1v-2.172a2 2 0 0 1 .586-1.414z",key:"1re2og"}],["path",{d:"M18.828 15a2 2 0 0 1-1.414-.586l-1.56-1.56a1.207 1.207 0 0 1 0-1.708l1.56-1.56A2 2 0 0 1 18.828 9H21a1 1 0 0 1 1 1v4a1 1 0 0 1-1 1z",key:"1pchrj"}],["path",{d:"M6.586 14.414A2 2 0 0 1 5.172 15H3a1 1 0 0 1-1-1v-4a1 1 0 0 1 1-1h2.172a2 2 0 0 1 1.414.586l1.56 1.56a1.207 1.207 0 0 1 0 1.708z",key:"16mt4c"}],["path",{d:"M9 3a1 1 0 0 1 1-1h4a1 1 0 0 1 1 1v2.172a2 2 0 0 1-.586 1.414l-1.56 1.56a1.207 1.207 0 0 1-1.708 0l-1.56-1.56A2 2 0 0 1 9 5.172z",key:"19ox6c"}]],GamepadDirectional=createLucideIcon("gamepad-directional",__iconNode$eI);const __iconNode$eH=[["line",{x1:"6",x2:"10",y1:"12",y2:"12",key:"161bw2"}],["line",{x1:"8",x2:"8",y1:"10",y2:"14",key:"1i6ji0"}],["line",{x1:"15",x2:"15.01",y1:"13",y2:"13",key:"dqpgro"}],["line",{x1:"18",x2:"18.01",y1:"11",y2:"11",key:"meh2c"}],["rect",{width:"20",height:"12",x:"2",y:"6",rx:"2",key:"9lu3g6"}]],Gamepad=createLucideIcon("gamepad",__iconNode$eH);const __iconNode$eG=[["path",{d:"m12 14 4-4",key:"9kzdfg"}],["path",{d:"M3.34 19a10 10 0 1 1 17.32 0",key:"19p75a"}]],Gauge=createLucideIcon("gauge",__iconNode$eG);const __iconNode$eF=[["path",{d:"m14 13-8.381 8.38a1 1 0 0 1-3.001-3l8.384-8.381",key:"pgg06f"}],["path",{d:"m16 16 6-6",key:"vzrcl6"}],["path",{d:"m21.5 10.5-8-8",key:"a17d9x"}],["path",{d:"m8 8 6-6",key:"18bi4p"}],["path",{d:"m8.5 7.5 8 8",key:"1oyaui"}]],Gavel=createLucideIcon("gavel",__iconNode$eF);const __iconNode$eE=[["path",{d:"M10.5 3 8 9l4 13 4-13-2.5-6",key:"b3dvk1"}],["path",{d:"M17 3a2 2 0 0 1 1.6.8l3 4a2 2 0 0 1 .013 2.382l-7.99 10.986a2 2 0 0 1-3.247 0l-7.99-10.986A2 2 0 0 1 2.4 7.8l2.998-3.997A2 2 0 0 1 7 3z",key:"7w4byz"}],["path",{d:"M2 9h20",key:"16fsjt"}]],Gem=createLucideIcon("gem",__iconNode$eE);const __iconNode$eD=[["path",{d:"M11.5 21a7.5 7.5 0 1 1 7.35-9",key:"1gyj8k"}],["path",{d:"M13 12V3",key:"18om2a"}],["path",{d:"M4 21h16",key:"1h09gz"}],["path",{d:"M9 12V3",key:"geutu0"}]],GeorgianLari=createLucideIcon("georgian-lari",__iconNode$eD);const __iconNode$eC=[["path",{d:"M9 10h.01",key:"qbtxuw"}],["path",{d:"M15 10h.01",key:"1qmjsl"}],["path",{d:"M12 2a8 8 0 0 0-8 8v12l3-3 2.5 2.5L12 19l2.5 2.5L17 19l3 3V10a8 8 0 0 0-8-8z",key:"uwwb07"}]],Ghost=createLucideIcon("ghost",__iconNode$eC);const __iconNode$eB=[["rect",{x:"3",y:"8",width:"18",height:"4",rx:"1",key:"bkv52"}],["path",{d:"M12 8v13",key:"1c76mn"}],["path",{d:"M19 12v7a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2v-7",key:"6wjy6b"}],["path",{d:"M7.5 8a2.5 2.5 0 0 1 0-5A4.8 8 0 0 1 12 8a4.8 8 0 0 1 4.5-5 2.5 2.5 0 0 1 0 5",key:"1ihvrl"}]],Gift=createLucideIcon("gift",__iconNode$eB);const __iconNode$eA=[["path",{d:"M15 6a9 9 0 0 0-9 9V3",key:"1cii5b"}],["path",{d:"M21 18h-6",key:"139f0c"}],["circle",{cx:"18",cy:"6",r:"3",key:"1h7g24"}],["circle",{cx:"6",cy:"18",r:"3",key:"fqmcym"}]],GitBranchMinus=createLucideIcon("git-branch-minus",__iconNode$eA);const __iconNode$ez=[["path",{d:"M6 3v12",key:"qpgusn"}],["path",{d:"M18 9a3 3 0 1 0 0-6 3 3 0 0 0 0 6z",key:"1d02ji"}],["path",{d:"M6 21a3 3 0 1 0 0-6 3 3 0 0 0 0 6z",key:"chk6ph"}],["path",{d:"M15 6a9 9 0 0 0-9 9",key:"or332x"}],["path",{d:"M18 15v6",key:"9wciyi"}],["path",{d:"M21 18h-6",key:"139f0c"}]],GitBranchPlus=createLucideIcon("git-branch-plus",__iconNode$ez);const __iconNode$ey=[["line",{x1:"6",x2:"6",y1:"3",y2:"15",key:"17qcm7"}],["circle",{cx:"18",cy:"6",r:"3",key:"1h7g24"}],["circle",{cx:"6",cy:"18",r:"3",key:"fqmcym"}],["path",{d:"M18 9a9 9 0 0 1-9 9",key:"n2h4wq"}]],GitBranch=createLucideIcon("git-branch",__iconNode$ey);const __iconNode$ex=[["circle",{cx:"12",cy:"12",r:"3",key:"1v7zrd"}],["line",{x1:"3",x2:"9",y1:"12",y2:"12",key:"1dyftd"}],["line",{x1:"15",x2:"21",y1:"12",y2:"12",key:"oup4p8"}]],GitCommitHorizontal=createLucideIcon("git-commit-horizontal",__iconNode$ex);const __iconNode$ew=[["path",{d:"M12 3v6",key:"1holv5"}],["circle",{cx:"12",cy:"12",r:"3",key:"1v7zrd"}],["path",{d:"M12 15v6",key:"a9ows0"}]],GitCommitVertical=createLucideIcon("git-commit-vertical",__iconNode$ew);const __iconNode$ev=[["circle",{cx:"5",cy:"6",r:"3",key:"1qnov2"}],["path",{d:"M12 6h5a2 2 0 0 1 2 2v7",key:"1yj91y"}],["path",{d:"m15 9-3-3 3-3",key:"1lwv8l"}],["circle",{cx:"19",cy:"18",r:"3",key:"1qljk2"}],["path",{d:"M12 18H7a2 2 0 0 1-2-2V9",key:"16sdep"}],["path",{d:"m9 15 3 3-3 3",key:"1m3kbl"}]],GitCompareArrows=createLucideIcon("git-compare-arrows",__iconNode$ev);const __iconNode$eu=[["circle",{cx:"18",cy:"18",r:"3",key:"1xkwt0"}],["circle",{cx:"6",cy:"6",r:"3",key:"1lh9wr"}],["path",{d:"M13 6h3a2 2 0 0 1 2 2v7",key:"1yeb86"}],["path",{d:"M11 18H8a2 2 0 0 1-2-2V9",key:"19pyzm"}]],GitCompare=createLucideIcon("git-compare",__iconNode$eu);const __iconNode$et=[["circle",{cx:"12",cy:"18",r:"3",key:"1mpf1b"}],["circle",{cx:"6",cy:"6",r:"3",key:"1lh9wr"}],["circle",{cx:"18",cy:"6",r:"3",key:"1h7g24"}],["path",{d:"M18 9v2c0 .6-.4 1-1 1H7c-.6 0-1-.4-1-1V9",key:"1uq4wg"}],["path",{d:"M12 12v3",key:"158kv8"}]],GitFork=createLucideIcon("git-fork",__iconNode$et);const __iconNode$es=[["circle",{cx:"5",cy:"6",r:"3",key:"1qnov2"}],["path",{d:"M5 9v6",key:"158jrl"}],["circle",{cx:"5",cy:"18",r:"3",key:"104gr9"}],["path",{d:"M12 3v18",key:"108xh3"}],["circle",{cx:"19",cy:"6",r:"3",key:"108a5v"}],["path",{d:"M16 15.7A9 9 0 0 0 19 9",key:"1e3vqb"}]],GitGraph=createLucideIcon("git-graph",__iconNode$es);const __iconNode$er=[["circle",{cx:"18",cy:"18",r:"3",key:"1xkwt0"}],["circle",{cx:"6",cy:"6",r:"3",key:"1lh9wr"}],["path",{d:"M6 21V9a9 9 0 0 0 9 9",key:"7kw0sc"}]],GitMerge=createLucideIcon("git-merge",__iconNode$er);const __iconNode$eq=[["circle",{cx:"5",cy:"6",r:"3",key:"1qnov2"}],["path",{d:"M5 9v12",key:"ih889a"}],["circle",{cx:"19",cy:"18",r:"3",key:"1qljk2"}],["path",{d:"m15 9-3-3 3-3",key:"1lwv8l"}],["path",{d:"M12 6h5a2 2 0 0 1 2 2v7",key:"1yj91y"}]],GitPullRequestArrow=createLucideIcon("git-pull-request-arrow",__iconNode$eq);const __iconNode$ep=[["circle",{cx:"6",cy:"6",r:"3",key:"1lh9wr"}],["path",{d:"M6 9v12",key:"1sc30k"}],["path",{d:"m21 3-6 6",key:"16nqsk"}],["path",{d:"m21 9-6-6",key:"9j17rh"}],["path",{d:"M18 11.5V15",key:"65xf6f"}],["circle",{cx:"18",cy:"18",r:"3",key:"1xkwt0"}]],GitPullRequestClosed=createLucideIcon("git-pull-request-closed",__iconNode$ep);const __iconNode$eo=[["circle",{cx:"5",cy:"6",r:"3",key:"1qnov2"}],["path",{d:"M5 9v12",key:"ih889a"}],["path",{d:"m15 9-3-3 3-3",key:"1lwv8l"}],["path",{d:"M12 6h5a2 2 0 0 1 2 2v3",key:"1rbwk6"}],["path",{d:"M19 15v6",key:"10aioa"}],["path",{d:"M22 18h-6",key:"1d5gi5"}]],GitPullRequestCreateArrow=createLucideIcon("git-pull-request-create-arrow",__iconNode$eo);const __iconNode$en=[["circle",{cx:"6",cy:"6",r:"3",key:"1lh9wr"}],["path",{d:"M6 9v12",key:"1sc30k"}],["path",{d:"M13 6h3a2 2 0 0 1 2 2v3",key:"1jb6z3"}],["path",{d:"M18 15v6",key:"9wciyi"}],["path",{d:"M21 18h-6",key:"139f0c"}]],GitPullRequestCreate=createLucideIcon("git-pull-request-create",__iconNode$en);const __iconNode$em=[["circle",{cx:"18",cy:"18",r:"3",key:"1xkwt0"}],["circle",{cx:"6",cy:"6",r:"3",key:"1lh9wr"}],["path",{d:"M18 6V5",key:"1oao2s"}],["path",{d:"M18 11v-1",key:"11c8tz"}],["line",{x1:"6",x2:"6",y1:"9",y2:"21",key:"rroup"}]],GitPullRequestDraft=createLucideIcon("git-pull-request-draft",__iconNode$em);const __iconNode$el=[["circle",{cx:"18",cy:"18",r:"3",key:"1xkwt0"}],["circle",{cx:"6",cy:"6",r:"3",key:"1lh9wr"}],["path",{d:"M13 6h3a2 2 0 0 1 2 2v7",key:"1yeb86"}],["line",{x1:"6",x2:"6",y1:"9",y2:"21",key:"rroup"}]],GitPullRequest=createLucideIcon("git-pull-request",__iconNode$el);const __iconNode$ek=[["path",{d:"M15 22v-4a4.8 4.8 0 0 0-1-3.5c3 0 6-2 6-5.5.08-1.25-.27-2.48-1-3.5.28-1.15.28-2.35 0-3.5 0 0-1 0-3 1.5-2.64-.5-5.36-.5-8 0C6 2 5 2 5 2c-.3 1.15-.3 2.35 0 3.5A5.403 5.403 0 0 0 4 9c0 3.5 3 5.5 6 5.5-.39.49-.68 1.05-.85 1.65-.17.6-.22 1.23-.15 1.85v4",key:"tonef"}],["path",{d:"M9 18c-4.51 2-5-2-7-2",key:"9comsn"}]],Github=createLucideIcon("github",__iconNode$ek);const __iconNode$ej=[["path",{d:"m22 13.29-3.33-10a.42.42 0 0 0-.14-.18.38.38 0 0 0-.22-.11.39.39 0 0 0-.23.07.42.42 0 0 0-.14.18l-2.26 6.67H8.32L6.1 3.26a.42.42 0 0 0-.1-.18.38.38 0 0 0-.26-.08.39.39 0 0 0-.23.07.42.42 0 0 0-.14.18L2 13.29a.74.74 0 0 0 .27.83L12 21l9.69-6.88a.71.71 0 0 0 .31-.83Z",key:"148pdi"}]],Gitlab=createLucideIcon("gitlab",__iconNode$ej);const __iconNode$ei=[["path",{d:"M5.116 4.104A1 1 0 0 1 6.11 3h11.78a1 1 0 0 1 .994 1.105L17.19 20.21A2 2 0 0 1 15.2 22H8.8a2 2 0 0 1-2-1.79z",key:"p55z4y"}],["path",{d:"M6 12a5 5 0 0 1 6 0 5 5 0 0 0 6 0",key:"mjntcy"}]],GlassWater=createLucideIcon("glass-water",__iconNode$ei);const __iconNode$eh=[["path",{d:"M15.686 15A14.5 14.5 0 0 1 12 22a14.5 14.5 0 0 1 0-20 10 10 0 1 0 9.542 13",key:"qkt0x6"}],["path",{d:"M2 12h8.5",key:"ovaggd"}],["path",{d:"M20 6V4a2 2 0 1 0-4 0v2",key:"1of5e8"}],["rect",{width:"8",height:"5",x:"14",y:"6",rx:"1",key:"1fmf51"}]],GlobeLock=createLucideIcon("globe-lock",__iconNode$eh);const __iconNode$eg=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20",key:"13o1zl"}],["path",{d:"M2 12h20",key:"9i4pu4"}]],Globe=createLucideIcon("globe",__iconNode$eg);const __iconNode$ef=[["circle",{cx:"6",cy:"15",r:"4",key:"vux9w4"}],["circle",{cx:"18",cy:"15",r:"4",key:"18o8ve"}],["path",{d:"M14 15a2 2 0 0 0-2-2 2 2 0 0 0-2 2",key:"1ag4bs"}],["path",{d:"M2.5 13 5 7c.7-1.3 1.4-2 3-2",key:"1hm1gs"}],["path",{d:"M21.5 13 19 7c-.7-1.3-1.5-2-3-2",key:"1r31ai"}]],Glasses=createLucideIcon("glasses",__iconNode$ef);const __iconNode$ee=[["path",{d:"M12 13V2l8 4-8 4",key:"5wlwwj"}],["path",{d:"M20.561 10.222a9 9 0 1 1-12.55-5.29",key:"1c0wjv"}],["path",{d:"M8.002 9.997a5 5 0 1 0 8.9 2.02",key:"gb1g7m"}]],Goal=createLucideIcon("goal",__iconNode$ee);const __iconNode$ed=[["path",{d:"M2 21V3",key:"1bzk4w"}],["path",{d:"M2 5h18a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2H2.26",key:"1d64pi"}],["path",{d:"M7 17v3a1 1 0 0 0 1 1h5a1 1 0 0 0 1-1v-3",key:"5hbqbf"}],["circle",{cx:"16",cy:"11",r:"2",key:"qt15rb"}],["circle",{cx:"8",cy:"11",r:"2",key:"ssideg"}]],Gpu=createLucideIcon("gpu",__iconNode$ed);const __iconNode$ec=[["path",{d:"M22 5V2l-5.89 5.89",key:"1eenpo"}],["circle",{cx:"16.6",cy:"15.89",r:"3",key:"xjtalx"}],["circle",{cx:"8.11",cy:"7.4",r:"3",key:"u2fv6i"}],["circle",{cx:"12.35",cy:"11.65",r:"3",key:"i6i8g7"}],["circle",{cx:"13.91",cy:"5.85",r:"3",key:"6ye0dv"}],["circle",{cx:"18.15",cy:"10.09",r:"3",key:"snx9no"}],["circle",{cx:"6.56",cy:"13.2",r:"3",key:"17x4xg"}],["circle",{cx:"10.8",cy:"17.44",r:"3",key:"1hogw9"}],["circle",{cx:"5",cy:"19",r:"3",key:"1sn6vo"}]],Grape=createLucideIcon("grape",__iconNode$ec);const __iconNode$eb=[["path",{d:"M21.42 10.922a1 1 0 0 0-.019-1.838L12.83 5.18a2 2 0 0 0-1.66 0L2.6 9.08a1 1 0 0 0 0 1.832l8.57 3.908a2 2 0 0 0 1.66 0z",key:"j76jl0"}],["path",{d:"M22 10v6",key:"1lu8f3"}],["path",{d:"M6 12.5V16a6 3 0 0 0 12 0v-3.5",key:"1r8lef"}]],GraduationCap=createLucideIcon("graduation-cap",__iconNode$eb);const __iconNode$ea=[["path",{d:"M12 3v17a1 1 0 0 1-1 1H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v6a1 1 0 0 1-1 1H3",key:"11za1p"}],["path",{d:"m16 19 2 2 4-4",key:"1b14m6"}]],Grid2x2Check=createLucideIcon("grid-2x2-check",__iconNode$ea);const __iconNode$e9=[["path",{d:"M12 3v17a1 1 0 0 1-1 1H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v6a1 1 0 0 1-1 1H3",key:"11za1p"}],["path",{d:"m16 16 5 5",key:"8tpb07"}],["path",{d:"m16 21 5-5",key:"193jll"}]],Grid2x2X=createLucideIcon("grid-2x2-x",__iconNode$e9);const __iconNode$e8=[["path",{d:"M12 3v17a1 1 0 0 1-1 1H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v6a1 1 0 0 1-1 1H3",key:"11za1p"}],["path",{d:"M16 19h6",key:"xwg31i"}],["path",{d:"M19 22v-6",key:"qhmiwi"}]],Grid2x2Plus=createLucideIcon("grid-2x2-plus",__iconNode$e8);const __iconNode$e7=[["path",{d:"M12 3v18",key:"108xh3"}],["path",{d:"M3 12h18",key:"1i2n21"}],["rect",{x:"3",y:"3",width:"18",height:"18",rx:"2",key:"h1oib"}]],Grid2x2=createLucideIcon("grid-2x2",__iconNode$e7);const __iconNode$e6=[["path",{d:"M15 3v18",key:"14nvp0"}],["path",{d:"M3 12h18",key:"1i2n21"}],["path",{d:"M9 3v18",key:"fh3hqa"}],["rect",{x:"3",y:"3",width:"18",height:"18",rx:"2",key:"h1oib"}]],Grid3x2=createLucideIcon("grid-3x2",__iconNode$e6);const __iconNode$e5=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M3 9h18",key:"1pudct"}],["path",{d:"M3 15h18",key:"5xshup"}],["path",{d:"M9 3v18",key:"fh3hqa"}],["path",{d:"M15 3v18",key:"14nvp0"}]],Grid3x3=createLucideIcon("grid-3x3",__iconNode$e5);const __iconNode$e4=[["circle",{cx:"12",cy:"9",r:"1",key:"124mty"}],["circle",{cx:"19",cy:"9",r:"1",key:"1ruzo2"}],["circle",{cx:"5",cy:"9",r:"1",key:"1a8b28"}],["circle",{cx:"12",cy:"15",r:"1",key:"1e56xg"}],["circle",{cx:"19",cy:"15",r:"1",key:"1a92ep"}],["circle",{cx:"5",cy:"15",r:"1",key:"5r1jwy"}]],GripHorizontal=createLucideIcon("grip-horizontal",__iconNode$e4);const __iconNode$e3=[["circle",{cx:"9",cy:"12",r:"1",key:"1vctgf"}],["circle",{cx:"9",cy:"5",r:"1",key:"hp0tcf"}],["circle",{cx:"9",cy:"19",r:"1",key:"fkjjf6"}],["circle",{cx:"15",cy:"12",r:"1",key:"1tmaij"}],["circle",{cx:"15",cy:"5",r:"1",key:"19l28e"}],["circle",{cx:"15",cy:"19",r:"1",key:"f4zoj3"}]],GripVertical=createLucideIcon("grip-vertical",__iconNode$e3);const __iconNode$e2=[["circle",{cx:"12",cy:"5",r:"1",key:"gxeob9"}],["circle",{cx:"19",cy:"5",r:"1",key:"w8mnmm"}],["circle",{cx:"5",cy:"5",r:"1",key:"lttvr7"}],["circle",{cx:"12",cy:"12",r:"1",key:"41hilf"}],["circle",{cx:"19",cy:"12",r:"1",key:"1wjl8i"}],["circle",{cx:"5",cy:"12",r:"1",key:"1pcz8c"}],["circle",{cx:"12",cy:"19",r:"1",key:"lyex9k"}],["circle",{cx:"19",cy:"19",r:"1",key:"shf9b7"}],["circle",{cx:"5",cy:"19",r:"1",key:"bfqh0e"}]],Grip=createLucideIcon("grip",__iconNode$e2);const __iconNode$e1=[["path",{d:"M3 7V5c0-1.1.9-2 2-2h2",key:"adw53z"}],["path",{d:"M17 3h2c1.1 0 2 .9 2 2v2",key:"an4l38"}],["path",{d:"M21 17v2c0 1.1-.9 2-2 2h-2",key:"144t0e"}],["path",{d:"M7 21H5c-1.1 0-2-.9-2-2v-2",key:"rtnfgi"}],["rect",{width:"7",height:"5",x:"7",y:"7",rx:"1",key:"1eyiv7"}],["rect",{width:"7",height:"5",x:"10",y:"12",rx:"1",key:"1qlmkx"}]],Group=createLucideIcon("group",__iconNode$e1);const __iconNode$e0=[["path",{d:"m11.9 12.1 4.514-4.514",key:"109xqo"}],["path",{d:"M20.1 2.3a1 1 0 0 0-1.4 0l-1.114 1.114A2 2 0 0 0 17 4.828v1.344a2 2 0 0 1-.586 1.414A2 2 0 0 1 17.828 7h1.344a2 2 0 0 0 1.414-.586L21.7 5.3a1 1 0 0 0 0-1.4z",key:"txyc8t"}],["path",{d:"m6 16 2 2",key:"16qmzd"}],["path",{d:"M8.23 9.85A3 3 0 0 1 11 8a5 5 0 0 1 5 5 3 3 0 0 1-1.85 2.77l-.92.38A2 2 0 0 0 12 18a4 4 0 0 1-4 4 6 6 0 0 1-6-6 4 4 0 0 1 4-4 2 2 0 0 0 1.85-1.23z",key:"1de1vg"}]],Guitar=createLucideIcon("guitar",__iconNode$e0);const __iconNode$d$=[["path",{d:"M13.144 21.144A7.274 10.445 45 1 0 2.856 10.856",key:"1k1t7q"}],["path",{d:"M13.144 21.144A7.274 4.365 45 0 0 2.856 10.856a7.274 4.365 45 0 0 10.288 10.288",key:"153t1g"}],["path",{d:"M16.565 10.435 18.6 8.4a2.501 2.501 0 1 0 1.65-4.65 2.5 2.5 0 1 0-4.66 1.66l-2.024 2.025",key:"gzrt0n"}],["path",{d:"m8.5 16.5-1-1",key:"otr954"}]],Ham=createLucideIcon("ham",__iconNode$d$);const __iconNode$d_=[["path",{d:"M12 16H4a2 2 0 1 1 0-4h16a2 2 0 1 1 0 4h-4.25",key:"5dloqd"}],["path",{d:"M5 12a2 2 0 0 1-2-2 9 7 0 0 1 18 0 2 2 0 0 1-2 2",key:"1vl3my"}],["path",{d:"M5 16a2 2 0 0 0-2 2 3 3 0 0 0 3 3h12a3 3 0 0 0 3-3 2 2 0 0 0-2-2q0 0 0 0",key:"1us75o"}],["path",{d:"m6.67 12 6.13 4.6a2 2 0 0 0 2.8-.4l3.15-4.2",key:"qqzweh"}]],Hamburger=createLucideIcon("hamburger",__iconNode$d_);const __iconNode$dZ=[["path",{d:"m15 12-9.373 9.373a1 1 0 0 1-3.001-3L12 9",key:"1hayfq"}],["path",{d:"m18 15 4-4",key:"16gjal"}],["path",{d:"m21.5 11.5-1.914-1.914A2 2 0 0 1 19 8.172v-.344a2 2 0 0 0-.586-1.414l-1.657-1.657A6 6 0 0 0 12.516 3H9l1.243 1.243A6 6 0 0 1 12 8.485V10l2 2h1.172a2 2 0 0 1 1.414.586L18.5 14.5",key:"15ts47"}]],Hammer=createLucideIcon("hammer",__iconNode$dZ);const __iconNode$dY=[["path",{d:"M11 15h2a2 2 0 1 0 0-4h-3c-.6 0-1.1.2-1.4.6L3 17",key:"geh8rc"}],["path",{d:"m7 21 1.6-1.4c.3-.4.8-.6 1.4-.6h4c1.1 0 2.1-.4 2.8-1.2l4.6-4.4a2 2 0 0 0-2.75-2.91l-4.2 3.9",key:"1fto5m"}],["path",{d:"m2 16 6 6",key:"1pfhp9"}],["circle",{cx:"16",cy:"9",r:"2.9",key:"1n0dlu"}],["circle",{cx:"6",cy:"5",r:"3",key:"151irh"}]],HandCoins=createLucideIcon("hand-coins",__iconNode$dY);const __iconNode$dX=[["path",{d:"M12.035 17.012a3 3 0 0 0-3-3l-.311-.002a.72.72 0 0 1-.505-1.229l1.195-1.195A2 2 0 0 1 10.828 11H12a2 2 0 0 0 0-4H9.243a3 3 0 0 0-2.122.879l-2.707 2.707A4.83 4.83 0 0 0 3 14a8 8 0 0 0 8 8h2a8 8 0 0 0 8-8V7a2 2 0 1 0-4 0v2a2 2 0 1 0 4 0",key:"1ff7rl"}],["path",{d:"M13.888 9.662A2 2 0 0 0 17 8V5A2 2 0 1 0 13 5",key:"1xmd21"}],["path",{d:"M9 5A2 2 0 1 0 5 5V10",key:"f3wfjw"}],["path",{d:"M9 7V4A2 2 0 1 1 13 4V7.268",key:"eaoucv"}]],HandFist=createLucideIcon("hand-fist",__iconNode$dX);const __iconNode$dW=[["path",{d:"M18 11.5V9a2 2 0 0 0-2-2a2 2 0 0 0-2 2v1.4",key:"edstyy"}],["path",{d:"M14 10V8a2 2 0 0 0-2-2a2 2 0 0 0-2 2v2",key:"19wdwo"}],["path",{d:"M10 9.9V9a2 2 0 0 0-2-2a2 2 0 0 0-2 2v5",key:"1lugqo"}],["path",{d:"M6 14a2 2 0 0 0-2-2a2 2 0 0 0-2 2",key:"1hbeus"}],["path",{d:"M18 11a2 2 0 1 1 4 0v3a8 8 0 0 1-8 8h-4a8 8 0 0 1-8-8 2 2 0 1 1 4 0",key:"1etffm"}]],HandGrab=createLucideIcon("hand-grab",__iconNode$dW);const __iconNode$dV=[["path",{d:"M11 14h2a2 2 0 0 0 0-4h-3c-.6 0-1.1.2-1.4.6L3 16",key:"1v1a37"}],["path",{d:"m14.45 13.39 5.05-4.694C20.196 8 21 6.85 21 5.75a2.75 2.75 0 0 0-4.797-1.837.276.276 0 0 1-.406 0A2.75 2.75 0 0 0 11 5.75c0 1.2.802 2.248 1.5 2.946L16 11.95",key:"fhfbnt"}],["path",{d:"m2 15 6 6",key:"10dquu"}],["path",{d:"m7 20 1.6-1.4c.3-.4.8-.6 1.4-.6h4c1.1 0 2.1-.4 2.8-1.2l4.6-4.4a1 1 0 0 0-2.75-2.91",key:"1x6kdw"}]],HandHeart=createLucideIcon("hand-heart",__iconNode$dV);const __iconNode$dU=[["path",{d:"M11 12h2a2 2 0 1 0 0-4h-3c-.6 0-1.1.2-1.4.6L3 14",key:"1j4xps"}],["path",{d:"m7 18 1.6-1.4c.3-.4.8-.6 1.4-.6h4c1.1 0 2.1-.4 2.8-1.2l4.6-4.4a2 2 0 0 0-2.75-2.91l-4.2 3.9",key:"uospg8"}],["path",{d:"m2 13 6 6",key:"16e5sb"}]],HandHelping=createLucideIcon("hand-helping",__iconNode$dU);const __iconNode$dT=[["path",{d:"M18 12.5V10a2 2 0 0 0-2-2a2 2 0 0 0-2 2v1.4",key:"wc6myp"}],["path",{d:"M14 11V9a2 2 0 1 0-4 0v2",key:"94qvcw"}],["path",{d:"M10 10.5V5a2 2 0 1 0-4 0v9",key:"m1ah89"}],["path",{d:"m7 15-1.76-1.76a2 2 0 0 0-2.83 2.82l3.6 3.6C7.5 21.14 9.2 22 12 22h2a8 8 0 0 0 8-8V7a2 2 0 1 0-4 0v5",key:"t1skq1"}]],HandMetal=createLucideIcon("hand-metal",__iconNode$dT);const __iconNode$dS=[["path",{d:"M18 11V6a2 2 0 0 0-2-2a2 2 0 0 0-2 2",key:"1fvzgz"}],["path",{d:"M14 10V4a2 2 0 0 0-2-2a2 2 0 0 0-2 2v2",key:"1kc0my"}],["path",{d:"M10 10.5V6a2 2 0 0 0-2-2a2 2 0 0 0-2 2v8",key:"10h0bg"}],["path",{d:"M18 8a2 2 0 1 1 4 0v6a8 8 0 0 1-8 8h-2c-2.8 0-4.5-.86-5.99-2.34l-3.6-3.6a2 2 0 0 1 2.83-2.82L7 15",key:"1s1gnw"}]],Hand=createLucideIcon("hand",__iconNode$dS);const __iconNode$dR=[["path",{d:"M12 3V2",key:"ar7q03"}],["path",{d:"m15.4 17.4 3.2-2.8a2 2 0 1 1 2.8 2.9l-3.6 3.3c-.7.8-1.7 1.2-2.8 1.2h-4c-1.1 0-2.1-.4-2.8-1.2l-1.302-1.464A1 1 0 0 0 6.151 19H5",key:"n2g93r"}],["path",{d:"M2 14h12a2 2 0 0 1 0 4h-2",key:"1o2jem"}],["path",{d:"M4 10h16",key:"img6z1"}],["path",{d:"M5 10a7 7 0 0 1 14 0",key:"1ega1o"}],["path",{d:"M5 14v6a1 1 0 0 1-1 1H2",key:"1hescx"}]],HandPlatter=createLucideIcon("hand-platter",__iconNode$dR);const __iconNode$dQ=[["path",{d:"M2.048 18.566A2 2 0 0 0 4 21h16a2 2 0 0 0 1.952-2.434l-2-9A2 2 0 0 0 18 8H6a2 2 0 0 0-1.952 1.566z",key:"1qbui5"}],["path",{d:"M8 11V6a4 4 0 0 1 8 0v5",key:"tcht90"}]],Handbag=createLucideIcon("handbag",__iconNode$dQ);const __iconNode$dP=[["path",{d:"m11 17 2 2a1 1 0 1 0 3-3",key:"efffak"}],["path",{d:"m14 14 2.5 2.5a1 1 0 1 0 3-3l-3.88-3.88a3 3 0 0 0-4.24 0l-.88.88a1 1 0 1 1-3-3l2.81-2.81a5.79 5.79 0 0 1 7.06-.87l.47.28a2 2 0 0 0 1.42.25L21 4",key:"9pr0kb"}],["path",{d:"m21 3 1 11h-2",key:"1tisrp"}],["path",{d:"M3 3 2 14l6.5 6.5a1 1 0 1 0 3-3",key:"1uvwmv"}],["path",{d:"M3 4h8",key:"1ep09j"}]],Handshake=createLucideIcon("handshake",__iconNode$dP);const __iconNode$dO=[["path",{d:"M12 2v8",key:"1q4o3n"}],["path",{d:"m16 6-4 4-4-4",key:"6wukr"}],["rect",{width:"20",height:"8",x:"2",y:"14",rx:"2",key:"w68u3i"}],["path",{d:"M6 18h.01",key:"uhywen"}],["path",{d:"M10 18h.01",key:"h775k"}]],HardDriveDownload=createLucideIcon("hard-drive-download",__iconNode$dO);const __iconNode$dN=[["path",{d:"m16 6-4-4-4 4",key:"13yo43"}],["path",{d:"M12 2v8",key:"1q4o3n"}],["rect",{width:"20",height:"8",x:"2",y:"14",rx:"2",key:"w68u3i"}],["path",{d:"M6 18h.01",key:"uhywen"}],["path",{d:"M10 18h.01",key:"h775k"}]],HardDriveUpload=createLucideIcon("hard-drive-upload",__iconNode$dN);const __iconNode$dM=[["line",{x1:"22",x2:"2",y1:"12",y2:"12",key:"1y58io"}],["path",{d:"M5.45 5.11 2 12v6a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-6l-3.45-6.89A2 2 0 0 0 16.76 4H7.24a2 2 0 0 0-1.79 1.11z",key:"oot6mr"}],["line",{x1:"6",x2:"6.01",y1:"16",y2:"16",key:"sgf278"}],["line",{x1:"10",x2:"10.01",y1:"16",y2:"16",key:"1l4acy"}]],HardDrive=createLucideIcon("hard-drive",__iconNode$dM);const __iconNode$dL=[["path",{d:"M10 10V5a1 1 0 0 1 1-1h2a1 1 0 0 1 1 1v5",key:"1p9q5i"}],["path",{d:"M14 6a6 6 0 0 1 6 6v3",key:"1hnv84"}],["path",{d:"M4 15v-3a6 6 0 0 1 6-6",key:"9ciidu"}],["rect",{x:"2",y:"15",width:"20",height:"4",rx:"1",key:"g3x8cw"}]],HardHat=createLucideIcon("hard-hat",__iconNode$dL);const __iconNode$dK=[["line",{x1:"4",x2:"20",y1:"9",y2:"9",key:"4lhtct"}],["line",{x1:"4",x2:"20",y1:"15",y2:"15",key:"vyu0kd"}],["line",{x1:"10",x2:"8",y1:"3",y2:"21",key:"1ggp8o"}],["line",{x1:"16",x2:"14",y1:"3",y2:"21",key:"weycgp"}]],Hash$1=createLucideIcon("hash",__iconNode$dK);const __iconNode$dJ=[["path",{d:"M14 18a2 2 0 0 0-4 0",key:"1v8fkw"}],["path",{d:"m19 11-2.11-6.657a2 2 0 0 0-2.752-1.148l-1.276.61A2 2 0 0 1 12 4H8.5a2 2 0 0 0-1.925 1.456L5 11",key:"1fkr7p"}],["path",{d:"M2 11h20",key:"3eubbj"}],["circle",{cx:"17",cy:"18",r:"3",key:"82mm0e"}],["circle",{cx:"7",cy:"18",r:"3",key:"lvkj7j"}]],HatGlasses=createLucideIcon("hat-glasses",__iconNode$dJ);const __iconNode$dI=[["path",{d:"m5.2 6.2 1.4 1.4",key:"17imol"}],["path",{d:"M2 13h2",key:"13gyu8"}],["path",{d:"M20 13h2",key:"16rner"}],["path",{d:"m17.4 7.6 1.4-1.4",key:"t4xlah"}],["path",{d:"M22 17H2",key:"1gtaj3"}],["path",{d:"M22 21H2",key:"1gy6en"}],["path",{d:"M16 13a4 4 0 0 0-8 0",key:"1dyczq"}],["path",{d:"M12 5V2.5",key:"1vytko"}]],Haze=createLucideIcon("haze",__iconNode$dI);const __iconNode$dH=[["path",{d:"M22 9a1 1 0 0 0-1-1H3a1 1 0 0 0-1 1v4a1 1 0 0 0 1 1h1l2 2h12l2-2h1a1 1 0 0 0 1-1Z",key:"2128wb"}],["path",{d:"M7.5 12h9",key:"1t0ckc"}]],HdmiPort=createLucideIcon("hdmi-port",__iconNode$dH);const __iconNode$dG=[["path",{d:"M4 12h8",key:"17cfdx"}],["path",{d:"M4 18V6",key:"1rz3zl"}],["path",{d:"M12 18V6",key:"zqpxq5"}],["path",{d:"m17 12 3-2v8",key:"1hhhft"}]],Heading1=createLucideIcon("heading-1",__iconNode$dG);const __iconNode$dF=[["path",{d:"M4 12h8",key:"17cfdx"}],["path",{d:"M4 18V6",key:"1rz3zl"}],["path",{d:"M12 18V6",key:"zqpxq5"}],["path",{d:"M21 18h-4c0-4 4-3 4-6 0-1.5-2-2.5-4-1",key:"9jr5yi"}]],Heading2=createLucideIcon("heading-2",__iconNode$dF);const __iconNode$dE=[["path",{d:"M4 12h8",key:"17cfdx"}],["path",{d:"M4 18V6",key:"1rz3zl"}],["path",{d:"M12 18V6",key:"zqpxq5"}],["path",{d:"M17.5 10.5c1.7-1 3.5 0 3.5 1.5a2 2 0 0 1-2 2",key:"68ncm8"}],["path",{d:"M17 17.5c2 1.5 4 .3 4-1.5a2 2 0 0 0-2-2",key:"1ejuhz"}]],Heading3=createLucideIcon("heading-3",__iconNode$dE);const __iconNode$dD=[["path",{d:"M12 18V6",key:"zqpxq5"}],["path",{d:"M17 10v3a1 1 0 0 0 1 1h3",key:"tj5zdr"}],["path",{d:"M21 10v8",key:"1kdml4"}],["path",{d:"M4 12h8",key:"17cfdx"}],["path",{d:"M4 18V6",key:"1rz3zl"}]],Heading4=createLucideIcon("heading-4",__iconNode$dD);const __iconNode$dC=[["path",{d:"M4 12h8",key:"17cfdx"}],["path",{d:"M4 18V6",key:"1rz3zl"}],["path",{d:"M12 18V6",key:"zqpxq5"}],["path",{d:"M17 13v-3h4",key:"1nvgqp"}],["path",{d:"M17 17.7c.4.2.8.3 1.3.3 1.5 0 2.7-1.1 2.7-2.5S19.8 13 18.3 13H17",key:"2nebdn"}]],Heading5=createLucideIcon("heading-5",__iconNode$dC);const __iconNode$dB=[["path",{d:"M4 12h8",key:"17cfdx"}],["path",{d:"M4 18V6",key:"1rz3zl"}],["path",{d:"M12 18V6",key:"zqpxq5"}],["circle",{cx:"19",cy:"16",r:"2",key:"15mx69"}],["path",{d:"M20 10c-2 2-3 3.5-3 6",key:"f35dl0"}]],Heading6=createLucideIcon("heading-6",__iconNode$dB);const __iconNode$dA=[["path",{d:"M6 12h12",key:"8npq4p"}],["path",{d:"M6 20V4",key:"1w1bmo"}],["path",{d:"M18 20V4",key:"o2hl4u"}]],Heading$1=createLucideIcon("heading",__iconNode$dA);const __iconNode$dz=[["path",{d:"M21 14h-1.343",key:"1jdnxi"}],["path",{d:"M9.128 3.47A9 9 0 0 1 21 12v3.343",key:"6kipu2"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M20.414 20.414A2 2 0 0 1 19 21h-1a2 2 0 0 1-2-2v-3",key:"9x50f4"}],["path",{d:"M3 14h3a2 2 0 0 1 2 2v3a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-7a9 9 0 0 1 2.636-6.364",key:"1bkxnm"}]],HeadphoneOff=createLucideIcon("headphone-off",__iconNode$dz);const __iconNode$dy=[["path",{d:"M3 14h3a2 2 0 0 1 2 2v3a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-7a9 9 0 0 1 18 0v7a2 2 0 0 1-2 2h-1a2 2 0 0 1-2-2v-3a2 2 0 0 1 2-2h3",key:"1xhozi"}]],Headphones=createLucideIcon("headphones",__iconNode$dy);const __iconNode$dx=[["path",{d:"M3 11h3a2 2 0 0 1 2 2v3a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-5Zm0 0a9 9 0 1 1 18 0m0 0v5a2 2 0 0 1-2 2h-1a2 2 0 0 1-2-2v-3a2 2 0 0 1 2-2h3Z",key:"12oyoe"}],["path",{d:"M21 16v2a4 4 0 0 1-4 4h-5",key:"1x7m43"}]],Headset=createLucideIcon("headset",__iconNode$dx);const __iconNode$dw=[["path",{d:"M12.409 5.824c-.702.792-1.15 1.496-1.415 2.166l2.153 2.156a.5.5 0 0 1 0 .707l-2.293 2.293a.5.5 0 0 0 0 .707L12 15",key:"idzbju"}],["path",{d:"M13.508 20.313a2 2 0 0 1-3 .019L5 15c-1.5-1.5-3-3.2-3-5.5a5.5 5.5 0 0 1 9.591-3.677.6.6 0 0 0 .818.001A5.5 5.5 0 0 1 22 9.5c0 2.29-1.5 4-3 5.5z",key:"1su70f"}]],HeartCrack=createLucideIcon("heart-crack",__iconNode$dw);const __iconNode$dv=[["path",{d:"m14.876 18.99-1.368 1.323a2 2 0 0 1-3 .019L5 15c-1.5-1.5-3-3.2-3-5.5a5.5 5.5 0 0 1 9.591-3.676.56.56 0 0 0 .818 0A5.49 5.49 0 0 1 22 9.5a5.2 5.2 0 0 1-.244 1.572",key:"15yztm"}],["path",{d:"M15 15h6",key:"1u4692"}]],HeartMinus=createLucideIcon("heart-minus",__iconNode$dv);const __iconNode$du=[["path",{d:"M19.414 14.414C21 12.828 22 11.5 22 9.5a5.5 5.5 0 0 0-9.591-3.676.6.6 0 0 1-.818.001A5.5 5.5 0 0 0 2 9.5c0 2.3 1.5 4 3 5.5l5.535 5.362a2 2 0 0 0 2.879.052 2.12 2.12 0 0 0-.004-3 2.124 2.124 0 1 0 3-3 2.124 2.124 0 0 0 3.004 0 2 2 0 0 0 0-2.828l-1.881-1.882a2.41 2.41 0 0 0-3.409 0l-1.71 1.71a2 2 0 0 1-2.828 0 2 2 0 0 1 0-2.828l2.823-2.762",key:"17lmqv"}]],HeartHandshake=createLucideIcon("heart-handshake",__iconNode$du);const __iconNode$dt=[["path",{d:"M10.5 4.893a5.5 5.5 0 0 1 1.091.931.56.56 0 0 0 .818 0A5.49 5.49 0 0 1 22 9.5c0 1.872-1.002 3.356-2.187 4.655",key:"1inpfl"}],["path",{d:"m16.967 16.967-3.459 3.346a2 2 0 0 1-3 .019L5 15c-1.5-1.5-3-3.2-3-5.5a5.5 5.5 0 0 1 2.747-4.761",key:"vbc6x7"}],["path",{d:"m2 2 20 20",key:"1ooewy"}]],HeartOff=createLucideIcon("heart-off",__iconNode$dt);const __iconNode$ds=[["path",{d:"m14.479 19.374-.971.939a2 2 0 0 1-3 .019L5 15c-1.5-1.5-3-3.2-3-5.5a5.5 5.5 0 0 1 9.591-3.676.56.56 0 0 0 .818 0A5.49 5.49 0 0 1 22 9.5a5.2 5.2 0 0 1-.219 1.49",key:"wg5jx"}],["path",{d:"M15 15h6",key:"1u4692"}],["path",{d:"M18 12v6",key:"1houu1"}]],HeartPlus=createLucideIcon("heart-plus",__iconNode$ds);const __iconNode$dr=[["path",{d:"M2 9.5a5.5 5.5 0 0 1 9.591-3.676.56.56 0 0 0 .818 0A5.49 5.49 0 0 1 22 9.5c0 2.29-1.5 4-3 5.5l-5.492 5.313a2 2 0 0 1-3 .019L5 15c-1.5-1.5-3-3.2-3-5.5",key:"mvr1a0"}],["path",{d:"M3.22 13H9.5l.5-1 2 4.5 2-7 1.5 3.5h5.27",key:"auskq0"}]],HeartPulse=createLucideIcon("heart-pulse",__iconNode$dr);const __iconNode$dq=[["path",{d:"M2 9.5a5.5 5.5 0 0 1 9.591-3.676.56.56 0 0 0 .818 0A5.49 5.49 0 0 1 22 9.5c0 2.29-1.5 4-3 5.5l-5.492 5.313a2 2 0 0 1-3 .019L5 15c-1.5-1.5-3-3.2-3-5.5",key:"mvr1a0"}]],Heart=createLucideIcon("heart",__iconNode$dq);const __iconNode$dp=[["path",{d:"M11 8c2-3-2-3 0-6",key:"1ldv5m"}],["path",{d:"M15.5 8c2-3-2-3 0-6",key:"1otqoz"}],["path",{d:"M6 10h.01",key:"1lbq93"}],["path",{d:"M6 14h.01",key:"zudwn7"}],["path",{d:"M10 16v-4",key:"1c25yv"}],["path",{d:"M14 16v-4",key:"1dkbt8"}],["path",{d:"M18 16v-4",key:"1yg9me"}],["path",{d:"M20 6a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h3",key:"1ubg90"}],["path",{d:"M5 20v2",key:"1abpe8"}],["path",{d:"M19 20v2",key:"kqn6ft"}]],Heater=createLucideIcon("heater",__iconNode$dp);const __iconNode$do=[["path",{d:"M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z",key:"yt0hxn"}]],Hexagon=createLucideIcon("hexagon",__iconNode$do);const __iconNode$dn=[["path",{d:"M11 17v4",key:"14wq8k"}],["path",{d:"M14 3v8a2 2 0 0 0 2 2h5.865",key:"12oo5h"}],["path",{d:"M17 17v4",key:"hdt4hh"}],["path",{d:"M18 17a4 4 0 0 0 4-4 8 6 0 0 0-8-6 6 5 0 0 0-6 5v3a2 2 0 0 0 2 2z",key:"yynif"}],["path",{d:"M2 10v5",key:"sa5akn"}],["path",{d:"M6 3h16",key:"27qw71"}],["path",{d:"M7 21h14",key:"1ugz0u"}],["path",{d:"M8 13H2",key:"1thz1o"}]],Helicopter=createLucideIcon("helicopter",__iconNode$dn);const __iconNode$dm=[["path",{d:"m9 11-6 6v3h9l3-3",key:"1a3l36"}],["path",{d:"m22 12-4.6 4.6a2 2 0 0 1-2.8 0l-5.2-5.2a2 2 0 0 1 0-2.8L14 4",key:"14a9rk"}]],Highlighter=createLucideIcon("highlighter",__iconNode$dm);const __iconNode$dl=[["path",{d:"M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8",key:"1357e3"}],["path",{d:"M3 3v5h5",key:"1xhq8a"}],["path",{d:"M12 7v5l4 2",key:"1fdv2h"}]],History=createLucideIcon("history",__iconNode$dl);const __iconNode$dk=[["path",{d:"M10.82 16.12c1.69.6 3.91.79 5.18.85.28.01.53-.09.7-.27",key:"qyzcap"}],["path",{d:"M11.14 20.57c.52.24 2.44 1.12 4.08 1.37.46.06.86-.25.9-.71.12-1.52-.3-3.43-.5-4.28",key:"y078lb"}],["path",{d:"M16.13 21.05c1.65.63 3.68.84 4.87.91a.9.9 0 0 0 .7-.26",key:"1utre3"}],["path",{d:"M17.99 5.52a20.83 20.83 0 0 1 3.15 4.5.8.8 0 0 1-.68 1.13c-1.17.1-2.5.02-3.9-.25",key:"17o9hm"}],["path",{d:"M20.57 11.14c.24.52 1.12 2.44 1.37 4.08.04.3-.08.59-.31.75",key:"1d1n4p"}],["path",{d:"M4.93 4.93a10 10 0 0 0-.67 13.4c.35.43.96.4 1.17-.12.69-1.71 1.07-5.07 1.07-6.71 1.34.45 3.1.9 4.88.62a.85.85 0 0 0 .48-.24",key:"9uv3tt"}],["path",{d:"M5.52 17.99c1.05.95 2.91 2.42 4.5 3.15a.8.8 0 0 0 1.13-.68c.2-2.34-.33-5.3-1.57-8.28",key:"1292wz"}],["path",{d:"M8.35 2.68a10 10 0 0 1 9.98 1.58c.43.35.4.96-.12 1.17-1.5.6-4.3.98-6.07 1.05",key:"7ozu9p"}],["path",{d:"m2 2 20 20",key:"1ooewy"}]],HopOff=createLucideIcon("hop-off",__iconNode$dk);const __iconNode$dj=[["path",{d:"M10.82 16.12c1.69.6 3.91.79 5.18.85.55.03 1-.42.97-.97-.06-1.27-.26-3.5-.85-5.18",key:"18lxf1"}],["path",{d:"M11.5 6.5c1.64 0 5-.38 6.71-1.07.52-.2.55-.82.12-1.17A10 10 0 0 0 4.26 18.33c.35.43.96.4 1.17-.12.69-1.71 1.07-5.07 1.07-6.71 1.34.45 3.1.9 4.88.62a.88.88 0 0 0 .73-.74c.3-2.14-.15-3.5-.61-4.88",key:"vtfxrw"}],["path",{d:"M15.62 16.95c.2.85.62 2.76.5 4.28a.77.77 0 0 1-.9.7 16.64 16.64 0 0 1-4.08-1.36",key:"13hl71"}],["path",{d:"M16.13 21.05c1.65.63 3.68.84 4.87.91a.9.9 0 0 0 .96-.96 17.68 17.68 0 0 0-.9-4.87",key:"1sl8oj"}],["path",{d:"M16.94 15.62c.86.2 2.77.62 4.29.5a.77.77 0 0 0 .7-.9 16.64 16.64 0 0 0-1.36-4.08",key:"19c6kt"}],["path",{d:"M17.99 5.52a20.82 20.82 0 0 1 3.15 4.5.8.8 0 0 1-.68 1.13c-2.33.2-5.3-.32-8.27-1.57",key:"85ghs3"}],["path",{d:"M4.93 4.93 3 3a.7.7 0 0 1 0-1",key:"x087yj"}],["path",{d:"M9.58 12.18c1.24 2.98 1.77 5.95 1.57 8.28a.8.8 0 0 1-1.13.68 20.82 20.82 0 0 1-4.5-3.15",key:"11xdqo"}]],Hop=createLucideIcon("hop",__iconNode$dj);const __iconNode$di=[["path",{d:"M12 7v4",key:"xawao1"}],["path",{d:"M14 21v-3a2 2 0 0 0-4 0v3",key:"1rgiei"}],["path",{d:"M14 9h-4",key:"1w2s2s"}],["path",{d:"M18 11h2a2 2 0 0 1 2 2v6a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2v-9a2 2 0 0 1 2-2h2",key:"1tthqt"}],["path",{d:"M18 21V5a2 2 0 0 0-2-2H8a2 2 0 0 0-2 2v16",key:"dw4p4i"}]],Hospital=createLucideIcon("hospital",__iconNode$di);const __iconNode$dh=[["path",{d:"M5 22h14",key:"ehvnwv"}],["path",{d:"M5 2h14",key:"pdyrp9"}],["path",{d:"M17 22v-4.172a2 2 0 0 0-.586-1.414L12 12l-4.414 4.414A2 2 0 0 0 7 17.828V22",key:"1d314k"}],["path",{d:"M7 2v4.172a2 2 0 0 0 .586 1.414L12 12l4.414-4.414A2 2 0 0 0 17 6.172V2",key:"1vvvr6"}]],Hourglass=createLucideIcon("hourglass",__iconNode$dh);const __iconNode$dg=[["path",{d:"M8.62 13.8A2.25 2.25 0 1 1 12 10.836a2.25 2.25 0 1 1 3.38 2.966l-2.626 2.856a.998.998 0 0 1-1.507 0z",key:"n9s7kx"}],["path",{d:"M3 10a2 2 0 0 1 .709-1.528l7-6a2 2 0 0 1 2.582 0l7 6A2 2 0 0 1 21 10v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z",key:"r6nss1"}]],HouseHeart=createLucideIcon("house-heart",__iconNode$dg);const __iconNode$df=[["path",{d:"M10 12V8.964",key:"1vll13"}],["path",{d:"M14 12V8.964",key:"1x3qvg"}],["path",{d:"M15 12a1 1 0 0 1 1 1v2a2 2 0 0 1-2 2h-4a2 2 0 0 1-2-2v-2a1 1 0 0 1 1-1z",key:"ppykja"}],["path",{d:"M8.5 21H5a2 2 0 0 1-2-2v-9a2 2 0 0 1 .709-1.528l7-6a2 2 0 0 1 2.582 0l7 6A2 2 0 0 1 21 10v9a2 2 0 0 1-2 2h-5a2 2 0 0 1-2-2v-2",key:"365xoy"}]],HousePlug=createLucideIcon("house-plug",__iconNode$df);const __iconNode$de=[["path",{d:"M10 22v-6.57",key:"1wmca3"}],["path",{d:"M12 11h.01",key:"z322tv"}],["path",{d:"M12 7h.01",key:"1ivr5q"}],["path",{d:"M14 15.43V22",key:"1q2vjd"}],["path",{d:"M15 16a5 5 0 0 0-6 0",key:"o9wqvi"}],["path",{d:"M16 11h.01",key:"xkw8gn"}],["path",{d:"M16 7h.01",key:"1kdx03"}],["path",{d:"M8 11h.01",key:"1dfujw"}],["path",{d:"M8 7h.01",key:"1vti4s"}],["rect",{x:"4",y:"2",width:"16",height:"20",rx:"2",key:"1uxh74"}]],Hotel=createLucideIcon("hotel",__iconNode$de);const __iconNode$dd=[["path",{d:"M12.35 21H5a2 2 0 0 1-2-2v-9a2 2 0 0 1 .71-1.53l7-6a2 2 0 0 1 2.58 0l7 6A2 2 0 0 1 21 10v2.35",key:"8ek5ge"}],["path",{d:"M14.8 12.4A1 1 0 0 0 14 12h-4a1 1 0 0 0-1 1v8",key:"1rbg29"}],["path",{d:"M15 18h6",key:"3b3c90"}],["path",{d:"M18 15v6",key:"9wciyi"}]],HousePlus=createLucideIcon("house-plus",__iconNode$dd);const __iconNode$dc=[["path",{d:"M9.5 13.866a4 4 0 0 1 5 .01",key:"1wy54i"}],["path",{d:"M12 17h.01",key:"p32p05"}],["path",{d:"M3 10a2 2 0 0 1 .709-1.528l7-6a2 2 0 0 1 2.582 0l7 6A2 2 0 0 1 21 10v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z",key:"r6nss1"}],["path",{d:"M7 10.754a8 8 0 0 1 10 0",key:"exoy2g"}]],HouseWifi=createLucideIcon("house-wifi",__iconNode$dc);const __iconNode$db=[["path",{d:"M15 21v-8a1 1 0 0 0-1-1h-4a1 1 0 0 0-1 1v8",key:"5wwlr5"}],["path",{d:"M3 10a2 2 0 0 1 .709-1.528l7-6a2 2 0 0 1 2.582 0l7 6A2 2 0 0 1 21 10v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z",key:"r6nss1"}]],House=createLucideIcon("house",__iconNode$db);const __iconNode$da=[["path",{d:"M12 17c5 0 8-2.69 8-6H4c0 3.31 3 6 8 6m-4 4h8m-4-3v3M5.14 11a3.5 3.5 0 1 1 6.71 0",key:"1uxfcu"}],["path",{d:"M12.14 11a3.5 3.5 0 1 1 6.71 0",key:"4k3m1s"}],["path",{d:"M15.5 6.5a3.5 3.5 0 1 0-7 0",key:"zmuahr"}]],IceCreamBowl=createLucideIcon("ice-cream-bowl",__iconNode$da);const __iconNode$d9=[["path",{d:"m7 11 4.08 10.35a1 1 0 0 0 1.84 0L17 11",key:"1v6356"}],["path",{d:"M17 7A5 5 0 0 0 7 7",key:"151p3v"}],["path",{d:"M17 7a2 2 0 0 1 0 4H7a2 2 0 0 1 0-4",key:"1sdaij"}]],IceCreamCone=createLucideIcon("ice-cream-cone",__iconNode$d9);const __iconNode$d8=[["path",{d:"M13.5 8h-3",key:"xvov4w"}],["path",{d:"m15 2-1 2h3a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h3",key:"16uttc"}],["path",{d:"M16.899 22A5 5 0 0 0 7.1 22",key:"1d0ppr"}],["path",{d:"m9 2 3 6",key:"1o7bd9"}],["circle",{cx:"12",cy:"15",r:"3",key:"g36mzq"}]],IdCardLanyard=createLucideIcon("id-card-lanyard",__iconNode$d8);const __iconNode$d7=[["path",{d:"M16 10h2",key:"8sgtl7"}],["path",{d:"M16 14h2",key:"epxaof"}],["path",{d:"M6.17 15a3 3 0 0 1 5.66 0",key:"n6f512"}],["circle",{cx:"9",cy:"11",r:"2",key:"yxgjnd"}],["rect",{x:"2",y:"5",width:"20",height:"14",rx:"2",key:"qneu4z"}]],IdCard=createLucideIcon("id-card",__iconNode$d7);const __iconNode$d6=[["path",{d:"M10.3 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v10l-3.1-3.1a2 2 0 0 0-2.814.014L6 21",key:"9csbqa"}],["path",{d:"m14 19 3 3v-5.5",key:"9ldu5r"}],["path",{d:"m17 22 3-3",key:"1nkfve"}],["circle",{cx:"9",cy:"9",r:"2",key:"af1f0g"}]],ImageDown=createLucideIcon("image-down",__iconNode$d6);const __iconNode$d5=[["path",{d:"M21 9v10a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h7",key:"m87ecr"}],["line",{x1:"16",x2:"22",y1:"5",y2:"5",key:"ez7e4s"}],["circle",{cx:"9",cy:"9",r:"2",key:"af1f0g"}],["path",{d:"m21 15-3.086-3.086a2 2 0 0 0-2.828 0L6 21",key:"1xmnt7"}]],ImageMinus=createLucideIcon("image-minus",__iconNode$d5);const __iconNode$d4=[["line",{x1:"2",x2:"22",y1:"2",y2:"22",key:"a6p6uj"}],["path",{d:"M10.41 10.41a2 2 0 1 1-2.83-2.83",key:"1bzlo9"}],["line",{x1:"13.5",x2:"6",y1:"13.5",y2:"21",key:"1q0aeu"}],["line",{x1:"18",x2:"21",y1:"12",y2:"15",key:"5mozeu"}],["path",{d:"M3.59 3.59A1.99 1.99 0 0 0 3 5v14a2 2 0 0 0 2 2h14c.55 0 1.052-.22 1.41-.59",key:"mmje98"}],["path",{d:"M21 15V5a2 2 0 0 0-2-2H9",key:"43el77"}]],ImageOff=createLucideIcon("image-off",__iconNode$d4);const __iconNode$d3=[["path",{d:"M15 15.003a1 1 0 0 1 1.517-.859l4.997 2.997a1 1 0 0 1 0 1.718l-4.997 2.997a1 1 0 0 1-1.517-.86z",key:"nrt1m3"}],["path",{d:"M21 12.17V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h6",key:"99hgts"}],["path",{d:"m6 21 5-5",key:"1wyjai"}],["circle",{cx:"9",cy:"9",r:"2",key:"af1f0g"}]],ImagePlay=createLucideIcon("image-play",__iconNode$d3);const __iconNode$d2=[["path",{d:"M16 5h6",key:"1vod17"}],["path",{d:"M19 2v6",key:"4bpg5p"}],["path",{d:"M21 11.5V19a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h7.5",key:"1ue2ih"}],["path",{d:"m21 15-3.086-3.086a2 2 0 0 0-2.828 0L6 21",key:"1xmnt7"}],["circle",{cx:"9",cy:"9",r:"2",key:"af1f0g"}]],ImagePlus=createLucideIcon("image-plus",__iconNode$d2);const __iconNode$d1=[["path",{d:"M10.3 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v10l-3.1-3.1a2 2 0 0 0-2.814.014L6 21",key:"9csbqa"}],["path",{d:"m14 19.5 3-3 3 3",key:"9vmjn0"}],["path",{d:"M17 22v-5.5",key:"1aa6fl"}],["circle",{cx:"9",cy:"9",r:"2",key:"af1f0g"}]],ImageUp=createLucideIcon("image-up",__iconNode$d1);const __iconNode$d0=[["path",{d:"M16 3h5v5",key:"1806ms"}],["path",{d:"M17 21h2a2 2 0 0 0 2-2",key:"130fy9"}],["path",{d:"M21 12v3",key:"1wzk3p"}],["path",{d:"m21 3-5 5",key:"1g5oa7"}],["path",{d:"M3 7V5a2 2 0 0 1 2-2",key:"kk3yz1"}],["path",{d:"m5 21 4.144-4.144a1.21 1.21 0 0 1 1.712 0L13 19",key:"fyekpt"}],["path",{d:"M9 3h3",key:"d52fa"}],["rect",{x:"3",y:"11",width:"10",height:"10",rx:"1",key:"1wpmix"}]],ImageUpscale=createLucideIcon("image-upscale",__iconNode$d0);const __iconNode$c$=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",ry:"2",key:"1m3agn"}],["circle",{cx:"9",cy:"9",r:"2",key:"af1f0g"}],["path",{d:"m21 15-3.086-3.086a2 2 0 0 0-2.828 0L6 21",key:"1xmnt7"}]],Image$1=createLucideIcon("image",__iconNode$c$);const __iconNode$c_=[["path",{d:"m22 11-1.296-1.296a2.4 2.4 0 0 0-3.408 0L11 16",key:"9kzy35"}],["path",{d:"M4 8a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2",key:"1t0f0t"}],["circle",{cx:"13",cy:"7",r:"1",fill:"currentColor",key:"1obus6"}],["rect",{x:"8",y:"2",width:"14",height:"14",rx:"2",key:"1gvhby"}]],Images=createLucideIcon("images",__iconNode$c_);const __iconNode$cZ=[["path",{d:"M12 3v12",key:"1x0j5s"}],["path",{d:"m8 11 4 4 4-4",key:"1dohi6"}],["path",{d:"M8 5H4a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2h-4",key:"1ywtjm"}]],Import=createLucideIcon("import",__iconNode$cZ);const __iconNode$cY=[["polyline",{points:"22 12 16 12 14 15 10 15 8 12 2 12",key:"o97t9d"}],["path",{d:"M5.45 5.11 2 12v6a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-6l-3.45-6.89A2 2 0 0 0 16.76 4H7.24a2 2 0 0 0-1.79 1.11z",key:"oot6mr"}]],Inbox=createLucideIcon("inbox",__iconNode$cY);const __iconNode$cX=[["path",{d:"M6 3h12",key:"ggurg9"}],["path",{d:"M6 8h12",key:"6g4wlu"}],["path",{d:"m6 13 8.5 8",key:"u1kupk"}],["path",{d:"M6 13h3",key:"wdp6ag"}],["path",{d:"M9 13c6.667 0 6.667-10 0-10",key:"1nkvk2"}]],IndianRupee=createLucideIcon("indian-rupee",__iconNode$cX);const __iconNode$cW=[["path",{d:"M6 16c5 0 7-8 12-8a4 4 0 0 1 0 8c-5 0-7-8-12-8a4 4 0 1 0 0 8",key:"18ogeb"}]],Infinity$1=createLucideIcon("infinity",__iconNode$cW);const __iconNode$cV=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M12 16v-4",key:"1dtifu"}],["path",{d:"M12 8h.01",key:"e9boi3"}]],Info=createLucideIcon("info",__iconNode$cV);const __iconNode$cU=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M7 7h.01",key:"7u93v4"}],["path",{d:"M17 7h.01",key:"14a9sn"}],["path",{d:"M7 17h.01",key:"19xn7k"}],["path",{d:"M17 17h.01",key:"1sd3ek"}]],InspectionPanel=createLucideIcon("inspection-panel",__iconNode$cU);const __iconNode$cT=[["rect",{width:"20",height:"20",x:"2",y:"2",rx:"5",ry:"5",key:"2e1cvw"}],["path",{d:"M16 11.37A4 4 0 1 1 12.63 8 4 4 0 0 1 16 11.37z",key:"9exkf1"}],["line",{x1:"17.5",x2:"17.51",y1:"6.5",y2:"6.5",key:"r4j83e"}]],Instagram=createLucideIcon("instagram",__iconNode$cT);const __iconNode$cS=[["line",{x1:"19",x2:"10",y1:"4",y2:"4",key:"15jd3p"}],["line",{x1:"14",x2:"5",y1:"20",y2:"20",key:"bu0au3"}],["line",{x1:"15",x2:"9",y1:"4",y2:"20",key:"uljnxc"}]],Italic=createLucideIcon("italic",__iconNode$cS);const __iconNode$cR=[["path",{d:"m16 14 4 4-4 4",key:"hkso8o"}],["path",{d:"M20 10a8 8 0 1 0-8 8h8",key:"1bik7b"}]],IterationCcw=createLucideIcon("iteration-ccw",__iconNode$cR);const __iconNode$cQ=[["path",{d:"M4 10a8 8 0 1 1 8 8H4",key:"svv66n"}],["path",{d:"m8 22-4-4 4-4",key:"6g7gki"}]],IterationCw=createLucideIcon("iteration-cw",__iconNode$cQ);const __iconNode$cP=[["path",{d:"M12 9.5V21m0-11.5L6 3m6 6.5L18 3",key:"2ej80x"}],["path",{d:"M6 15h12",key:"1hwgt5"}],["path",{d:"M6 11h12",key:"wf4gp6"}]],JapaneseYen=createLucideIcon("japanese-yen",__iconNode$cP);const __iconNode$cO=[["path",{d:"M21 17a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v2a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-2Z",key:"jg2n2t"}],["path",{d:"M6 15v-2",key:"gd6mvg"}],["path",{d:"M12 15V9",key:"8c7uyn"}],["circle",{cx:"12",cy:"6",r:"3",key:"1gm2ql"}]],Joystick=createLucideIcon("joystick",__iconNode$cO);const __iconNode$cN=[["path",{d:"M5 3v14",key:"9nsxs2"}],["path",{d:"M12 3v8",key:"1h2ygw"}],["path",{d:"M19 3v18",key:"1sk56x"}]],Kanban=createLucideIcon("kanban",__iconNode$cN);const __iconNode$cM=[["path",{d:"M2.586 17.414A2 2 0 0 0 2 18.828V21a1 1 0 0 0 1 1h3a1 1 0 0 0 1-1v-1a1 1 0 0 1 1-1h1a1 1 0 0 0 1-1v-1a1 1 0 0 1 1-1h.172a2 2 0 0 0 1.414-.586l.814-.814a6.5 6.5 0 1 0-4-4z",key:"1s6t7t"}],["circle",{cx:"16.5",cy:"7.5",r:".5",fill:"currentColor",key:"w0ekpg"}]],KeyRound=createLucideIcon("key-round",__iconNode$cM);const __iconNode$cL=[["path",{d:"M18 17a1 1 0 0 0-1 1v1a2 2 0 1 0 2-2z",key:"skzb1g"}],["path",{d:"M20.97 3.61a.45.45 0 0 0-.58-.58C10.2 6.6 6.6 10.2 3.03 20.39a.45.45 0 0 0 .58.58C13.8 17.4 17.4 13.8 20.97 3.61",key:"cv9jm7"}],["path",{d:"m6.707 6.707 10.586 10.586",key:"d2l993"}],["path",{d:"M7 5a2 2 0 1 0-2 2h1a1 1 0 0 0 1-1z",key:"i0et4n"}]],Kayak=createLucideIcon("kayak",__iconNode$cL);const __iconNode$cK=[["path",{d:"M12.4 2.7a2.5 2.5 0 0 1 3.4 0l5.5 5.5a2.5 2.5 0 0 1 0 3.4l-3.7 3.7a2.5 2.5 0 0 1-3.4 0L8.7 9.8a2.5 2.5 0 0 1 0-3.4z",key:"165ttr"}],["path",{d:"m14 7 3 3",key:"1r5n42"}],["path",{d:"m9.4 10.6-6.814 6.814A2 2 0 0 0 2 18.828V21a1 1 0 0 0 1 1h3a1 1 0 0 0 1-1v-1a1 1 0 0 1 1-1h1a1 1 0 0 0 1-1v-1a1 1 0 0 1 1-1h.172a2 2 0 0 0 1.414-.586l.814-.814",key:"1ubxi2"}]],KeySquare=createLucideIcon("key-square",__iconNode$cK);const __iconNode$cJ=[["path",{d:"m15.5 7.5 2.3 2.3a1 1 0 0 0 1.4 0l2.1-2.1a1 1 0 0 0 0-1.4L19 4",key:"g0fldk"}],["path",{d:"m21 2-9.6 9.6",key:"1j0ho8"}],["circle",{cx:"7.5",cy:"15.5",r:"5.5",key:"yqb3hr"}]],Key=createLucideIcon("key",__iconNode$cJ);const __iconNode$cI=[["rect",{width:"20",height:"16",x:"2",y:"4",rx:"2",key:"18n3k1"}],["path",{d:"M6 8h4",key:"utf9t1"}],["path",{d:"M14 8h.01",key:"1primd"}],["path",{d:"M18 8h.01",key:"emo2bl"}],["path",{d:"M2 12h20",key:"9i4pu4"}],["path",{d:"M6 12v4",key:"dy92yo"}],["path",{d:"M10 12v4",key:"1fxnav"}],["path",{d:"M14 12v4",key:"1hft58"}],["path",{d:"M18 12v4",key:"tjjnbz"}]],KeyboardMusic=createLucideIcon("keyboard-music",__iconNode$cI);const __iconNode$cH=[["path",{d:"M 20 4 A2 2 0 0 1 22 6",key:"1g1fkt"}],["path",{d:"M 22 6 L 22 16.41",key:"1qjg3w"}],["path",{d:"M 7 16 L 16 16",key:"n0yqwb"}],["path",{d:"M 9.69 4 L 20 4",key:"kbpcgx"}],["path",{d:"M14 8h.01",key:"1primd"}],["path",{d:"M18 8h.01",key:"emo2bl"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M20 20H4a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2",key:"s23sx2"}],["path",{d:"M6 8h.01",key:"x9i8wu"}],["path",{d:"M8 12h.01",key:"czm47f"}]],KeyboardOff=createLucideIcon("keyboard-off",__iconNode$cH);const __iconNode$cG=[["path",{d:"M12 2v5",key:"nd4vlx"}],["path",{d:"M14.829 15.998a3 3 0 1 1-5.658 0",key:"1pybiy"}],["path",{d:"M20.92 14.606A1 1 0 0 1 20 16H4a1 1 0 0 1-.92-1.394l3-7A1 1 0 0 1 7 7h10a1 1 0 0 1 .92.606z",key:"ma1wor"}]],LampCeiling=createLucideIcon("lamp-ceiling",__iconNode$cG);const __iconNode$cF=[["path",{d:"M10.293 2.293a1 1 0 0 1 1.414 0l2.5 2.5 5.994 1.227a1 1 0 0 1 .506 1.687l-7 7a1 1 0 0 1-1.687-.506l-1.227-5.994-2.5-2.5a1 1 0 0 1 0-1.414z",key:"sb8slu"}],["path",{d:"m14.207 4.793-3.414 3.414",key:"m2x3oj"}],["path",{d:"M3 20a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v1a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1z",key:"8b3myj"}],["path",{d:"m9.086 6.5-4.793 4.793a1 1 0 0 0-.18 1.17L7 18",key:"43s6cu"}]],LampDesk=createLucideIcon("lamp-desk",__iconNode$cF);const __iconNode$cE=[["path",{d:"M10 8h.01",key:"1r9ogq"}],["path",{d:"M12 12h.01",key:"1mp3jc"}],["path",{d:"M14 8h.01",key:"1primd"}],["path",{d:"M16 12h.01",key:"1l6xoz"}],["path",{d:"M18 8h.01",key:"emo2bl"}],["path",{d:"M6 8h.01",key:"x9i8wu"}],["path",{d:"M7 16h10",key:"wp8him"}],["path",{d:"M8 12h.01",key:"czm47f"}],["rect",{width:"20",height:"16",x:"2",y:"4",rx:"2",key:"18n3k1"}]],Keyboard=createLucideIcon("keyboard",__iconNode$cE);const __iconNode$cD=[["path",{d:"M12 10v12",key:"6ubwww"}],["path",{d:"M17.929 7.629A1 1 0 0 1 17 9H7a1 1 0 0 1-.928-1.371l2-5A1 1 0 0 1 9 2h6a1 1 0 0 1 .928.629z",key:"1o95gh"}],["path",{d:"M9 22h6",key:"1rlq3v"}]],LampFloor=createLucideIcon("lamp-floor",__iconNode$cD);const __iconNode$cC=[["path",{d:"M19.929 18.629A1 1 0 0 1 19 20H9a1 1 0 0 1-.928-1.371l2-5A1 1 0 0 1 11 13h6a1 1 0 0 1 .928.629z",key:"u4w2d7"}],["path",{d:"M6 3a2 2 0 0 1 2 2v2a2 2 0 0 1-2 2H5a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1z",key:"15356w"}],["path",{d:"M8 6h4a2 2 0 0 1 2 2v5",key:"1m6m7x"}]],LampWallDown=createLucideIcon("lamp-wall-down",__iconNode$cC);const __iconNode$cB=[["path",{d:"M19.929 9.629A1 1 0 0 1 19 11H9a1 1 0 0 1-.928-1.371l2-5A1 1 0 0 1 11 4h6a1 1 0 0 1 .928.629z",key:"1uvrbf"}],["path",{d:"M6 15a2 2 0 0 1 2 2v2a2 2 0 0 1-2 2H5a1 1 0 0 1-1-1v-4a1 1 0 0 1 1-1z",key:"154r2a"}],["path",{d:"M8 18h4a2 2 0 0 0 2-2v-5",key:"z9mbu0"}]],LampWallUp=createLucideIcon("lamp-wall-up",__iconNode$cB);const __iconNode$cA=[["path",{d:"M12 12v6",key:"3ahymv"}],["path",{d:"M4.077 10.615A1 1 0 0 0 5 12h14a1 1 0 0 0 .923-1.385l-3.077-7.384A2 2 0 0 0 15 2H9a2 2 0 0 0-1.846 1.23Z",key:"1l7kg2"}],["path",{d:"M8 20a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v1a1 1 0 0 1-1 1H9a1 1 0 0 1-1-1z",key:"1mmzpi"}]],Lamp=createLucideIcon("lamp",__iconNode$cA);const __iconNode$cz=[["path",{d:"m12 8 6-3-6-3v10",key:"mvpnpy"}],["path",{d:"m8 11.99-5.5 3.14a1 1 0 0 0 0 1.74l8.5 4.86a2 2 0 0 0 2 0l8.5-4.86a1 1 0 0 0 0-1.74L16 12",key:"ek95tt"}],["path",{d:"m6.49 12.85 11.02 6.3",key:"1kt42w"}],["path",{d:"M17.51 12.85 6.5 19.15",key:"v55bdg"}]],LandPlot=createLucideIcon("land-plot",__iconNode$cz);const __iconNode$cy=[["path",{d:"M10 18v-7",key:"wt116b"}],["path",{d:"M11.12 2.198a2 2 0 0 1 1.76.006l7.866 3.847c.476.233.31.949-.22.949H3.474c-.53 0-.695-.716-.22-.949z",key:"1m329m"}],["path",{d:"M14 18v-7",key:"vav6t3"}],["path",{d:"M18 18v-7",key:"aexdmj"}],["path",{d:"M3 22h18",key:"8prr45"}],["path",{d:"M6 18v-7",key:"1ivflk"}]],Landmark=createLucideIcon("landmark",__iconNode$cy);const __iconNode$cx=[["path",{d:"m5 8 6 6",key:"1wu5hv"}],["path",{d:"m4 14 6-6 2-3",key:"1k1g8d"}],["path",{d:"M2 5h12",key:"or177f"}],["path",{d:"M7 2h1",key:"1t2jsx"}],["path",{d:"m22 22-5-10-5 10",key:"don7ne"}],["path",{d:"M14 18h6",key:"1m8k6r"}]],Languages=createLucideIcon("languages",__iconNode$cx);const __iconNode$cw=[["path",{d:"M2 20h20",key:"owomy5"}],["path",{d:"m9 10 2 2 4-4",key:"1gnqz4"}],["rect",{x:"3",y:"4",width:"18",height:"12",rx:"2",key:"8ur36m"}]],LaptopMinimalCheck=createLucideIcon("laptop-minimal-check",__iconNode$cw);const __iconNode$cv=[["rect",{width:"18",height:"12",x:"3",y:"4",rx:"2",ry:"2",key:"1qhy41"}],["line",{x1:"2",x2:"22",y1:"20",y2:"20",key:"ni3hll"}]],LaptopMinimal=createLucideIcon("laptop-minimal",__iconNode$cv);const __iconNode$cu=[["path",{d:"M18 5a2 2 0 0 1 2 2v8.526a2 2 0 0 0 .212.897l1.068 2.127a1 1 0 0 1-.9 1.45H3.62a1 1 0 0 1-.9-1.45l1.068-2.127A2 2 0 0 0 4 15.526V7a2 2 0 0 1 2-2z",key:"1pdavp"}],["path",{d:"M20.054 15.987H3.946",key:"14rxg9"}]],Laptop=createLucideIcon("laptop",__iconNode$cu);const __iconNode$ct=[["path",{d:"M7 22a5 5 0 0 1-2-4",key:"umushi"}],["path",{d:"M7 16.93c.96.43 1.96.74 2.99.91",key:"ybbtv3"}],["path",{d:"M3.34 14A6.8 6.8 0 0 1 2 10c0-4.42 4.48-8 10-8s10 3.58 10 8a7.19 7.19 0 0 1-.33 2",key:"gt5e1w"}],["path",{d:"M5 18a2 2 0 1 0 0-4 2 2 0 0 0 0 4z",key:"bq3ynw"}],["path",{d:"M14.33 22h-.09a.35.35 0 0 1-.24-.32v-10a.34.34 0 0 1 .33-.34c.08 0 .15.03.21.08l7.34 6a.33.33 0 0 1-.21.59h-4.49l-2.57 3.85a.35.35 0 0 1-.28.14z",key:"72q637"}]],LassoSelect=createLucideIcon("lasso-select",__iconNode$ct);const __iconNode$cs=[["path",{d:"M3.704 14.467A10 8 0 0 1 2 10a10 8 0 0 1 20 0 10 8 0 0 1-10 8 10 8 0 0 1-5.181-1.158",key:"1yant3"}],["path",{d:"M7 22a5 5 0 0 1-2-3.994",key:"1xp6a4"}],["circle",{cx:"5",cy:"16",r:"2",key:"18csp3"}]],Lasso=createLucideIcon("lasso",__iconNode$cs);const __iconNode$cr=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M18 13a6 6 0 0 1-6 5 6 6 0 0 1-6-5h12Z",key:"b2q4dd"}],["line",{x1:"9",x2:"9.01",y1:"9",y2:"9",key:"yxxnd0"}],["line",{x1:"15",x2:"15.01",y1:"9",y2:"9",key:"1p4y9e"}]],Laugh=createLucideIcon("laugh",__iconNode$cr);const __iconNode$cq=[["path",{d:"M13 13.74a2 2 0 0 1-2 0L2.5 8.87a1 1 0 0 1 0-1.74L11 2.26a2 2 0 0 1 2 0l8.5 4.87a1 1 0 0 1 0 1.74z",key:"15q6uc"}],["path",{d:"m20 14.285 1.5.845a1 1 0 0 1 0 1.74L13 21.74a2 2 0 0 1-2 0l-8.5-4.87a1 1 0 0 1 0-1.74l1.5-.845",key:"byia6g"}]],Layers2=createLucideIcon("layers-2",__iconNode$cq);const __iconNode$cp=[["path",{d:"M12.83 2.18a2 2 0 0 0-1.66 0L2.6 6.08a1 1 0 0 0 0 1.83l8.58 3.91a2 2 0 0 0 1.66 0l8.58-3.9a1 1 0 0 0 0-1.83z",key:"zw3jo"}],["path",{d:"M2 12a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 12",key:"1wduqc"}],["path",{d:"M2 17a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 17",key:"kqbvx6"}]],Layers=createLucideIcon("layers",__iconNode$cp);const __iconNode$co=[["rect",{width:"7",height:"9",x:"3",y:"3",rx:"1",key:"10lvy0"}],["rect",{width:"7",height:"5",x:"14",y:"3",rx:"1",key:"16une8"}],["rect",{width:"7",height:"9",x:"14",y:"12",rx:"1",key:"1hutg5"}],["rect",{width:"7",height:"5",x:"3",y:"16",rx:"1",key:"ldoo1y"}]],LayoutDashboard=createLucideIcon("layout-dashboard",__iconNode$co);const __iconNode$cn=[["rect",{width:"7",height:"7",x:"3",y:"3",rx:"1",key:"1g98yp"}],["rect",{width:"7",height:"7",x:"3",y:"14",rx:"1",key:"1bb6yr"}],["path",{d:"M14 4h7",key:"3xa0d5"}],["path",{d:"M14 9h7",key:"1icrd9"}],["path",{d:"M14 15h7",key:"1mj8o2"}],["path",{d:"M14 20h7",key:"11slyb"}]],LayoutList=createLucideIcon("layout-list",__iconNode$cn);const __iconNode$cm=[["rect",{width:"7",height:"7",x:"3",y:"3",rx:"1",key:"1g98yp"}],["rect",{width:"7",height:"7",x:"14",y:"3",rx:"1",key:"6d4xhi"}],["rect",{width:"7",height:"7",x:"14",y:"14",rx:"1",key:"nxv5o0"}],["rect",{width:"7",height:"7",x:"3",y:"14",rx:"1",key:"1bb6yr"}]],LayoutGrid=createLucideIcon("layout-grid",__iconNode$cm);const __iconNode$cl=[["rect",{width:"7",height:"18",x:"3",y:"3",rx:"1",key:"2obqm"}],["rect",{width:"7",height:"7",x:"14",y:"3",rx:"1",key:"6d4xhi"}],["rect",{width:"7",height:"7",x:"14",y:"14",rx:"1",key:"nxv5o0"}]],LayoutPanelLeft=createLucideIcon("layout-panel-left",__iconNode$cl);const __iconNode$ck=[["rect",{width:"18",height:"7",x:"3",y:"3",rx:"1",key:"f1a2em"}],["rect",{width:"7",height:"7",x:"3",y:"14",rx:"1",key:"1bb6yr"}],["rect",{width:"7",height:"7",x:"14",y:"14",rx:"1",key:"nxv5o0"}]],LayoutPanelTop=createLucideIcon("layout-panel-top",__iconNode$ck);const __iconNode$cj=[["rect",{width:"18",height:"7",x:"3",y:"3",rx:"1",key:"f1a2em"}],["rect",{width:"9",height:"7",x:"3",y:"14",rx:"1",key:"jqznyg"}],["rect",{width:"5",height:"7",x:"16",y:"14",rx:"1",key:"q5h2i8"}]],LayoutTemplate=createLucideIcon("layout-template",__iconNode$cj);const __iconNode$ci=[["path",{d:"M11 20A7 7 0 0 1 9.8 6.1C15.5 5 17 4.48 19 2c1 2 2 4.18 2 8 0 5.5-4.78 10-10 10Z",key:"nnexq3"}],["path",{d:"M2 21c0-3 1.85-5.36 5.08-6C9.5 14.52 12 13 13 12",key:"mt58a7"}]],Leaf=createLucideIcon("leaf",__iconNode$ci);const __iconNode$ch=[["path",{d:"M2 22c1.25-.987 2.27-1.975 3.9-2.2a5.56 5.56 0 0 1 3.8 1.5 4 4 0 0 0 6.187-2.353 3.5 3.5 0 0 0 3.69-5.116A3.5 3.5 0 0 0 20.95 8 3.5 3.5 0 1 0 16 3.05a3.5 3.5 0 0 0-5.831 1.373 3.5 3.5 0 0 0-5.116 3.69 4 4 0 0 0-2.348 6.155C3.499 15.42 4.409 16.712 4.2 18.1 3.926 19.743 3.014 20.732 2 22",key:"1134nt"}],["path",{d:"M2 22 17 7",key:"1q7jp2"}]],LeafyGreen=createLucideIcon("leafy-green",__iconNode$ch);const __iconNode$cg=[["path",{d:"M16 12h3a2 2 0 0 0 1.902-1.38l1.056-3.333A1 1 0 0 0 21 6H3a1 1 0 0 0-.958 1.287l1.056 3.334A2 2 0 0 0 5 12h3",key:"13jjxg"}],["path",{d:"M18 6V3a1 1 0 0 0-1-1h-3",key:"1550fe"}],["rect",{width:"8",height:"12",x:"8",y:"10",rx:"1",key:"qmu8b6"}]],Lectern=createLucideIcon("lectern",__iconNode$cg);const __iconNode$cf=[["rect",{width:"8",height:"18",x:"3",y:"3",rx:"1",key:"oynpb5"}],["path",{d:"M7 3v18",key:"bbkbws"}],["path",{d:"M20.4 18.9c.2.5-.1 1.1-.6 1.3l-1.9.7c-.5.2-1.1-.1-1.3-.6L11.1 5.1c-.2-.5.1-1.1.6-1.3l1.9-.7c.5-.2 1.1.1 1.3.6Z",key:"1qboyk"}]],LibraryBig=createLucideIcon("library-big",__iconNode$cf);const __iconNode$ce=[["path",{d:"m16 6 4 14",key:"ji33uf"}],["path",{d:"M12 6v14",key:"1n7gus"}],["path",{d:"M8 8v12",key:"1gg7y9"}],["path",{d:"M4 4v16",key:"6qkkli"}]],Library=createLucideIcon("library",__iconNode$ce);const __iconNode$cd=[["path",{d:"M14 12h2v8",key:"c1fccl"}],["path",{d:"M14 20h4",key:"lzx1xo"}],["path",{d:"M6 12h4",key:"a4o3ry"}],["path",{d:"M6 20h4",key:"1i6q5t"}],["path",{d:"M8 20V8a4 4 0 0 1 7.464-2",key:"wk9t6r"}]],Ligature=createLucideIcon("ligature",__iconNode$cd);const __iconNode$cc=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m4.93 4.93 4.24 4.24",key:"1ymg45"}],["path",{d:"m14.83 9.17 4.24-4.24",key:"1cb5xl"}],["path",{d:"m14.83 14.83 4.24 4.24",key:"q42g0n"}],["path",{d:"m9.17 14.83-4.24 4.24",key:"bqpfvv"}],["circle",{cx:"12",cy:"12",r:"4",key:"4exip2"}]],LifeBuoy=createLucideIcon("life-buoy",__iconNode$cc);const __iconNode$cb=[["path",{d:"M16.8 11.2c.8-.9 1.2-2 1.2-3.2a6 6 0 0 0-9.3-5",key:"1fkcox"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M6.3 6.3a4.67 4.67 0 0 0 1.2 5.2c.7.7 1.3 1.5 1.5 2.5",key:"10m8kw"}],["path",{d:"M9 18h6",key:"x1upvd"}],["path",{d:"M10 22h4",key:"ceow96"}]],LightbulbOff=createLucideIcon("lightbulb-off",__iconNode$cb);const __iconNode$ca=[["path",{d:"M15 14c.2-1 .7-1.7 1.5-2.5 1-.9 1.5-2.2 1.5-3.5A6 6 0 0 0 6 8c0 1 .2 2.2 1.5 3.5.7.7 1.3 1.5 1.5 2.5",key:"1gvzjb"}],["path",{d:"M9 18h6",key:"x1upvd"}],["path",{d:"M10 22h4",key:"ceow96"}]],Lightbulb=createLucideIcon("lightbulb",__iconNode$ca);const __iconNode$c9=[["path",{d:"M7 3.5c5-2 7 2.5 3 4C1.5 10 2 15 5 16c5 2 9-10 14-7s.5 13.5-4 12c-5-2.5.5-11 6-2",key:"1lrphd"}]],LineSquiggle=createLucideIcon("line-squiggle",__iconNode$c9);const __iconNode$c8=[["path",{d:"M9 17H7A5 5 0 0 1 7 7h2",key:"8i5ue5"}],["path",{d:"M15 7h2a5 5 0 1 1 0 10h-2",key:"1b9ql8"}],["line",{x1:"8",x2:"16",y1:"12",y2:"12",key:"1jonct"}]],Link2=createLucideIcon("link-2",__iconNode$c8);const __iconNode$c7=[["path",{d:"M9 17H7A5 5 0 0 1 7 7",key:"10o201"}],["path",{d:"M15 7h2a5 5 0 0 1 4 8",key:"1d3206"}],["line",{x1:"8",x2:"12",y1:"12",y2:"12",key:"rvw6j4"}],["line",{x1:"2",x2:"22",y1:"2",y2:"22",key:"a6p6uj"}]],Link2Off=createLucideIcon("link-2-off",__iconNode$c7);const __iconNode$c6=[["path",{d:"M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71",key:"1cjeqo"}],["path",{d:"M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71",key:"19qd67"}]],Link=createLucideIcon("link",__iconNode$c6);const __iconNode$c5=[["path",{d:"M16 8a6 6 0 0 1 6 6v7h-4v-7a2 2 0 0 0-2-2 2 2 0 0 0-2 2v7h-4v-7a6 6 0 0 1 6-6z",key:"c2jq9f"}],["rect",{width:"4",height:"12",x:"2",y:"9",key:"mk3on5"}],["circle",{cx:"4",cy:"4",r:"2",key:"bt5ra8"}]],Linkedin=createLucideIcon("linkedin",__iconNode$c5);const __iconNode$c4=[["path",{d:"M16 5H3",key:"m91uny"}],["path",{d:"M16 12H3",key:"1a2rj7"}],["path",{d:"M11 19H3",key:"zflm78"}],["path",{d:"m15 18 2 2 4-4",key:"1szwhi"}]],ListCheck=createLucideIcon("list-check",__iconNode$c4);const __iconNode$c3=[["path",{d:"M13 5h8",key:"a7qcls"}],["path",{d:"M13 12h8",key:"h98zly"}],["path",{d:"M13 19h8",key:"c3s6r1"}],["path",{d:"m3 17 2 2 4-4",key:"1jhpwq"}],["path",{d:"m3 7 2 2 4-4",key:"1obspn"}]],ListChecks=createLucideIcon("list-checks",__iconNode$c3);const __iconNode$c2=[["path",{d:"M3 5h8",key:"18g2rq"}],["path",{d:"M3 12h8",key:"1xfjp6"}],["path",{d:"M3 19h8",key:"fpbke4"}],["path",{d:"m15 5 3 3 3-3",key:"1t4thf"}],["path",{d:"m15 19 3-3 3 3",key:"y4ckd2"}]],ListChevronsDownUp=createLucideIcon("list-chevrons-down-up",__iconNode$c2);const __iconNode$c1=[["path",{d:"M3 5h8",key:"18g2rq"}],["path",{d:"M3 12h8",key:"1xfjp6"}],["path",{d:"M3 19h8",key:"fpbke4"}],["path",{d:"m15 8 3-3 3 3",key:"bc4io6"}],["path",{d:"m15 16 3 3 3-3",key:"9wmg1l"}]],ListChevronsUpDown=createLucideIcon("list-chevrons-up-down",__iconNode$c1);const __iconNode$c0=[["path",{d:"M10 5h11",key:"1hkqpe"}],["path",{d:"M10 12h11",key:"6m4ad9"}],["path",{d:"M10 19h11",key:"14g2nv"}],["path",{d:"m3 10 3-3-3-3",key:"i7pm08"}],["path",{d:"m3 20 3-3-3-3",key:"20gx1n"}]],ListCollapse=createLucideIcon("list-collapse",__iconNode$c0);const __iconNode$b$=[["path",{d:"M12 5H2",key:"1o22fu"}],["path",{d:"M6 12h12",key:"8npq4p"}],["path",{d:"M9 19h6",key:"456am0"}],["path",{d:"M16 5h6",key:"1vod17"}],["path",{d:"M19 8V2",key:"1wcffq"}]],ListFilterPlus=createLucideIcon("list-filter-plus",__iconNode$b$);const __iconNode$b_=[["path",{d:"M16 5H3",key:"m91uny"}],["path",{d:"M16 12H3",key:"1a2rj7"}],["path",{d:"M9 19H3",key:"s61nz1"}],["path",{d:"m16 16-3 3 3 3",key:"117b85"}],["path",{d:"M21 5v12a2 2 0 0 1-2 2h-6",key:"hey24a"}]],ListEnd=createLucideIcon("list-end",__iconNode$b_);const __iconNode$bZ=[["path",{d:"M2 5h20",key:"1fs1ex"}],["path",{d:"M6 12h12",key:"8npq4p"}],["path",{d:"M9 19h6",key:"456am0"}]],ListFilter=createLucideIcon("list-filter",__iconNode$bZ);const __iconNode$bY=[["path",{d:"M21 5H11",key:"us1j55"}],["path",{d:"M21 12H11",key:"wd7e0v"}],["path",{d:"M21 19H11",key:"saa85w"}],["path",{d:"m7 8-4 4 4 4",key:"o5hrat"}]],ListIndentDecrease=createLucideIcon("list-indent-decrease",__iconNode$bY);const __iconNode$bX=[["path",{d:"M21 5H11",key:"us1j55"}],["path",{d:"M21 12H11",key:"wd7e0v"}],["path",{d:"M21 19H11",key:"saa85w"}],["path",{d:"m3 8 4 4-4 4",key:"1a3j6y"}]],ListIndentIncrease=createLucideIcon("list-indent-increase",__iconNode$bX);const __iconNode$bW=[["path",{d:"M16 5H3",key:"m91uny"}],["path",{d:"M11 12H3",key:"51ecnj"}],["path",{d:"M16 19H3",key:"zzsher"}],["path",{d:"M21 12h-6",key:"bt1uis"}]],ListMinus=createLucideIcon("list-minus",__iconNode$bW);const __iconNode$bV=[["path",{d:"M16 5H3",key:"m91uny"}],["path",{d:"M11 12H3",key:"51ecnj"}],["path",{d:"M11 19H3",key:"zflm78"}],["path",{d:"M21 16V5",key:"yxg4q8"}],["circle",{cx:"18",cy:"16",r:"3",key:"1hluhg"}]],ListMusic=createLucideIcon("list-music",__iconNode$bV);const __iconNode$bU=[["path",{d:"M11 5h10",key:"1cz7ny"}],["path",{d:"M11 12h10",key:"1438ji"}],["path",{d:"M11 19h10",key:"11t30w"}],["path",{d:"M4 4h1v5",key:"10yrso"}],["path",{d:"M4 9h2",key:"r1h2o0"}],["path",{d:"M6.5 20H3.4c0-1 2.6-1.925 2.6-3.5a1.5 1.5 0 0 0-2.6-1.02",key:"xtkcd5"}]],ListOrdered=createLucideIcon("list-ordered",__iconNode$bU);const __iconNode$bT=[["path",{d:"M16 5H3",key:"m91uny"}],["path",{d:"M11 12H3",key:"51ecnj"}],["path",{d:"M16 19H3",key:"zzsher"}],["path",{d:"M18 9v6",key:"1twb98"}],["path",{d:"M21 12h-6",key:"bt1uis"}]],ListPlus=createLucideIcon("list-plus",__iconNode$bT);const __iconNode$bS=[["path",{d:"M21 5H3",key:"1fi0y6"}],["path",{d:"M7 12H3",key:"13ou7f"}],["path",{d:"M7 19H3",key:"wbqt3n"}],["path",{d:"M12 18a5 5 0 0 0 9-3 4.5 4.5 0 0 0-4.5-4.5c-1.33 0-2.54.54-3.41 1.41L11 14",key:"qth677"}],["path",{d:"M11 10v4h4",key:"172dkj"}]],ListRestart=createLucideIcon("list-restart",__iconNode$bS);const __iconNode$bR=[["path",{d:"M3 5h6",key:"1ltk0q"}],["path",{d:"M3 12h13",key:"ppymz1"}],["path",{d:"M3 19h13",key:"bpdczq"}],["path",{d:"m16 8-3-3 3-3",key:"1pjpp6"}],["path",{d:"M21 19V7a2 2 0 0 0-2-2h-6",key:"4zzq67"}]],ListStart=createLucideIcon("list-start",__iconNode$bR);const __iconNode$bQ=[["path",{d:"M13 5h8",key:"a7qcls"}],["path",{d:"M13 12h8",key:"h98zly"}],["path",{d:"M13 19h8",key:"c3s6r1"}],["path",{d:"m3 17 2 2 4-4",key:"1jhpwq"}],["rect",{x:"3",y:"4",width:"6",height:"6",rx:"1",key:"cif1o7"}]],ListTodo=createLucideIcon("list-todo",__iconNode$bQ);const __iconNode$bP=[["path",{d:"M8 5h13",key:"1pao27"}],["path",{d:"M13 12h8",key:"h98zly"}],["path",{d:"M13 19h8",key:"c3s6r1"}],["path",{d:"M3 10a2 2 0 0 0 2 2h3",key:"1npucw"}],["path",{d:"M3 5v12a2 2 0 0 0 2 2h3",key:"x1gjn2"}]],ListTree=createLucideIcon("list-tree",__iconNode$bP);const __iconNode$bO=[["path",{d:"M21 5H3",key:"1fi0y6"}],["path",{d:"M10 12H3",key:"1ulcyk"}],["path",{d:"M10 19H3",key:"108z41"}],["path",{d:"M15 12.003a1 1 0 0 1 1.517-.859l4.997 2.997a1 1 0 0 1 0 1.718l-4.997 2.997a1 1 0 0 1-1.517-.86z",key:"ms4nik"}]],ListVideo=createLucideIcon("list-video",__iconNode$bO);const __iconNode$bN=[["path",{d:"M3 5h.01",key:"18ugdj"}],["path",{d:"M3 12h.01",key:"nlz23k"}],["path",{d:"M3 19h.01",key:"noohij"}],["path",{d:"M8 5h13",key:"1pao27"}],["path",{d:"M8 12h13",key:"1za7za"}],["path",{d:"M8 19h13",key:"m83p4d"}]],List=createLucideIcon("list",__iconNode$bN);const __iconNode$bM=[["path",{d:"M16 5H3",key:"m91uny"}],["path",{d:"M11 12H3",key:"51ecnj"}],["path",{d:"M16 19H3",key:"zzsher"}],["path",{d:"m15.5 9.5 5 5",key:"ytk86i"}],["path",{d:"m20.5 9.5-5 5",key:"17o44f"}]],ListX=createLucideIcon("list-x",__iconNode$bM);const __iconNode$bL=[["path",{d:"M22 12a1 1 0 0 1-10 0 1 1 0 0 0-10 0",key:"1lzz15"}],["path",{d:"M7 20.7a1 1 0 1 1 5-8.7 1 1 0 1 0 5-8.6",key:"1gnrpi"}],["path",{d:"M7 3.3a1 1 0 1 1 5 8.6 1 1 0 1 0 5 8.6",key:"u9yy5q"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],LoaderPinwheel=createLucideIcon("loader-pinwheel",__iconNode$bL);const __iconNode$bK=[["path",{d:"M21 12a9 9 0 1 1-6.219-8.56",key:"13zald"}]],LoaderCircle=createLucideIcon("loader-circle",__iconNode$bK);const __iconNode$bJ=[["path",{d:"M12 2v4",key:"3427ic"}],["path",{d:"m16.2 7.8 2.9-2.9",key:"r700ao"}],["path",{d:"M18 12h4",key:"wj9ykh"}],["path",{d:"m16.2 16.2 2.9 2.9",key:"1bxg5t"}],["path",{d:"M12 18v4",key:"jadmvz"}],["path",{d:"m4.9 19.1 2.9-2.9",key:"bwix9q"}],["path",{d:"M2 12h4",key:"j09sii"}],["path",{d:"m4.9 4.9 2.9 2.9",key:"giyufr"}]],Loader=createLucideIcon("loader",__iconNode$bJ);const __iconNode$bI=[["line",{x1:"2",x2:"5",y1:"12",y2:"12",key:"bvdh0s"}],["line",{x1:"19",x2:"22",y1:"12",y2:"12",key:"1tbv5k"}],["line",{x1:"12",x2:"12",y1:"2",y2:"5",key:"11lu5j"}],["line",{x1:"12",x2:"12",y1:"19",y2:"22",key:"x3vr5v"}],["circle",{cx:"12",cy:"12",r:"7",key:"fim9np"}],["circle",{cx:"12",cy:"12",r:"3",key:"1v7zrd"}]],LocateFixed=createLucideIcon("locate-fixed",__iconNode$bI);const __iconNode$bH=[["path",{d:"M12 19v3",key:"npa21l"}],["path",{d:"M12 2v3",key:"qbqxhf"}],["path",{d:"M18.89 13.24a7 7 0 0 0-8.13-8.13",key:"1v9jrh"}],["path",{d:"M19 12h3",key:"osuazr"}],["path",{d:"M2 12h3",key:"1wrr53"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M7.05 7.05a7 7 0 0 0 9.9 9.9",key:"rc5l2e"}]],LocateOff=createLucideIcon("locate-off",__iconNode$bH);const __iconNode$bG=[["line",{x1:"2",x2:"5",y1:"12",y2:"12",key:"bvdh0s"}],["line",{x1:"19",x2:"22",y1:"12",y2:"12",key:"1tbv5k"}],["line",{x1:"12",x2:"12",y1:"2",y2:"5",key:"11lu5j"}],["line",{x1:"12",x2:"12",y1:"19",y2:"22",key:"x3vr5v"}],["circle",{cx:"12",cy:"12",r:"7",key:"fim9np"}]],Locate=createLucideIcon("locate",__iconNode$bG);const __iconNode$bF=[["circle",{cx:"12",cy:"16",r:"1",key:"1au0dj"}],["rect",{width:"18",height:"12",x:"3",y:"10",rx:"2",key:"l0tzu3"}],["path",{d:"M7 10V7a5 5 0 0 1 9.33-2.5",key:"car5b7"}]],LockKeyholeOpen=createLucideIcon("lock-keyhole-open",__iconNode$bF);const __iconNode$bE=[["circle",{cx:"12",cy:"16",r:"1",key:"1au0dj"}],["rect",{x:"3",y:"10",width:"18",height:"12",rx:"2",key:"6s8ecr"}],["path",{d:"M7 10V7a5 5 0 0 1 10 0v3",key:"1pqi11"}]],LockKeyhole=createLucideIcon("lock-keyhole",__iconNode$bE);const __iconNode$bD=[["rect",{width:"18",height:"11",x:"3",y:"11",rx:"2",ry:"2",key:"1w4ew1"}],["path",{d:"M7 11V7a5 5 0 0 1 9.9-1",key:"1mm8w8"}]],LockOpen=createLucideIcon("lock-open",__iconNode$bD);const __iconNode$bC=[["path",{d:"m10 17 5-5-5-5",key:"1bsop3"}],["path",{d:"M15 12H3",key:"6jk70r"}],["path",{d:"M15 3h4a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2h-4",key:"u53s6r"}]],LogIn=createLucideIcon("log-in",__iconNode$bC);const __iconNode$bB=[["rect",{width:"18",height:"11",x:"3",y:"11",rx:"2",ry:"2",key:"1w4ew1"}],["path",{d:"M7 11V7a5 5 0 0 1 10 0v4",key:"fwvmzm"}]],Lock=createLucideIcon("lock",__iconNode$bB);const __iconNode$bA=[["path",{d:"m16 17 5-5-5-5",key:"1bji2h"}],["path",{d:"M21 12H9",key:"dn1m92"}],["path",{d:"M9 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h4",key:"1uf3rs"}]],LogOut=createLucideIcon("log-out",__iconNode$bA);const __iconNode$bz=[["path",{d:"M3 5h1",key:"1mv5vm"}],["path",{d:"M3 12h1",key:"lp3yf2"}],["path",{d:"M3 19h1",key:"w6f3n9"}],["path",{d:"M8 5h1",key:"1nxr5w"}],["path",{d:"M8 12h1",key:"1con00"}],["path",{d:"M8 19h1",key:"k7p10e"}],["path",{d:"M13 5h8",key:"a7qcls"}],["path",{d:"M13 12h8",key:"h98zly"}],["path",{d:"M13 19h8",key:"c3s6r1"}]],Logs=createLucideIcon("logs",__iconNode$bz);const __iconNode$by=[["path",{d:"m12 15 4 4",key:"lnac28"}],["path",{d:"M2.352 10.648a1.205 1.205 0 0 0 0 1.704l2.296 2.296a1.205 1.205 0 0 0 1.704 0l6.029-6.029a1 1 0 1 1 3 3l-6.029 6.029a1.205 1.205 0 0 0 0 1.704l2.296 2.296a1.205 1.205 0 0 0 1.704 0l6.365-6.367A1 1 0 0 0 8.716 4.282z",key:"nlhkjb"}],["path",{d:"m5 8 4 4",key:"j6kj7e"}]],Magnet=createLucideIcon("magnet",__iconNode$by);const __iconNode$bx=[["circle",{cx:"11",cy:"11",r:"8",key:"4ej97u"}],["path",{d:"m21 21-4.3-4.3",key:"1qie3q"}],["path",{d:"M11 11a2 2 0 0 0 4 0 4 4 0 0 0-8 0 6 6 0 0 0 12 0",key:"107gwy"}]],Lollipop=createLucideIcon("lollipop",__iconNode$bx);const __iconNode$bw=[["path",{d:"M6 20a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2",key:"1m57jg"}],["path",{d:"M8 18V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v14",key:"1l99gc"}],["path",{d:"M10 20h4",key:"ni2waw"}],["circle",{cx:"16",cy:"20",r:"2",key:"1vifvg"}],["circle",{cx:"8",cy:"20",r:"2",key:"ckkr5m"}]],Luggage=createLucideIcon("luggage",__iconNode$bw);const __iconNode$bv=[["path",{d:"M22 13V6a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v12c0 1.1.9 2 2 2h8",key:"12jkf8"}],["path",{d:"m22 7-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 7",key:"1ocrg3"}],["path",{d:"m16 19 2 2 4-4",key:"1b14m6"}]],MailCheck=createLucideIcon("mail-check",__iconNode$bv);const __iconNode$bu=[["path",{d:"M22 15V6a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v12c0 1.1.9 2 2 2h8",key:"fuxbkv"}],["path",{d:"m22 7-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 7",key:"1ocrg3"}],["path",{d:"M16 19h6",key:"xwg31i"}]],MailMinus=createLucideIcon("mail-minus",__iconNode$bu);const __iconNode$bt=[["path",{d:"M21.2 8.4c.5.38.8.97.8 1.6v10a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V10a2 2 0 0 1 .8-1.6l8-6a2 2 0 0 1 2.4 0l8 6Z",key:"1jhwl8"}],["path",{d:"m22 10-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 10",key:"1qfld7"}]],MailOpen=createLucideIcon("mail-open",__iconNode$bt);const __iconNode$bs=[["path",{d:"M22 13V6a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v12c0 1.1.9 2 2 2h8",key:"12jkf8"}],["path",{d:"m22 7-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 7",key:"1ocrg3"}],["path",{d:"M19 16v6",key:"tddt3s"}],["path",{d:"M16 19h6",key:"xwg31i"}]],MailPlus=createLucideIcon("mail-plus",__iconNode$bs);const __iconNode$br=[["path",{d:"M22 10.5V6a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v12c0 1.1.9 2 2 2h12.5",key:"e61zoh"}],["path",{d:"m22 7-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 7",key:"1ocrg3"}],["path",{d:"M18 15.28c.2-.4.5-.8.9-1a2.1 2.1 0 0 1 2.6.4c.3.4.5.8.5 1.3 0 1.3-2 2-2 2",key:"7z9rxb"}],["path",{d:"M20 22v.01",key:"12bgn6"}]],MailQuestionMark=createLucideIcon("mail-question-mark",__iconNode$br);const __iconNode$bq=[["path",{d:"M22 12.5V6a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v12c0 1.1.9 2 2 2h7.5",key:"w80f2v"}],["path",{d:"m22 7-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 7",key:"1ocrg3"}],["path",{d:"M18 21a3 3 0 1 0 0-6 3 3 0 0 0 0 6Z",key:"8lzu5m"}],["circle",{cx:"18",cy:"18",r:"3",key:"1xkwt0"}],["path",{d:"m22 22-1.5-1.5",key:"1x83k4"}]],MailSearch=createLucideIcon("mail-search",__iconNode$bq);const __iconNode$bp=[["path",{d:"M22 10.5V6a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v12c0 1.1.9 2 2 2h12.5",key:"e61zoh"}],["path",{d:"m22 7-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 7",key:"1ocrg3"}],["path",{d:"M20 14v4",key:"1hm744"}],["path",{d:"M20 22v.01",key:"12bgn6"}]],MailWarning=createLucideIcon("mail-warning",__iconNode$bp);const __iconNode$bo=[["path",{d:"M22 13V6a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v12c0 1.1.9 2 2 2h9",key:"1j9vog"}],["path",{d:"m22 7-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 7",key:"1ocrg3"}],["path",{d:"m17 17 4 4",key:"1b3523"}],["path",{d:"m21 17-4 4",key:"uinynz"}]],MailX=createLucideIcon("mail-x",__iconNode$bo);const __iconNode$bn=[["path",{d:"m22 7-8.991 5.727a2 2 0 0 1-2.009 0L2 7",key:"132q7q"}],["rect",{x:"2",y:"4",width:"20",height:"16",rx:"2",key:"izxlao"}]],Mail=createLucideIcon("mail",__iconNode$bn);const __iconNode$bm=[["path",{d:"M22 17a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V9.5C2 7 4 5 6.5 5H18c2.2 0 4 1.8 4 4v8Z",key:"1lbycx"}],["polyline",{points:"15,9 18,9 18,11",key:"1pm9c0"}],["path",{d:"M6.5 5C9 5 11 7 11 9.5V17a2 2 0 0 1-2 2",key:"15i455"}],["line",{x1:"6",x2:"7",y1:"10",y2:"10",key:"1e2scm"}]],Mailbox=createLucideIcon("mailbox",__iconNode$bm);const __iconNode$bl=[["path",{d:"M17 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2v-8a2 2 0 0 1 1-1.732",key:"1vyzll"}],["path",{d:"m22 5.5-6.419 4.179a2 2 0 0 1-2.162 0L7 5.5",key:"k7ramc"}],["rect",{x:"7",y:"3",width:"15",height:"12",rx:"2",key:"17196g"}]],Mails=createLucideIcon("mails",__iconNode$bl);const __iconNode$bk=[["path",{d:"m11 19-1.106-.552a2 2 0 0 0-1.788 0l-3.659 1.83A1 1 0 0 1 3 19.381V6.618a1 1 0 0 1 .553-.894l4.553-2.277a2 2 0 0 1 1.788 0l4.212 2.106a2 2 0 0 0 1.788 0l3.659-1.83A1 1 0 0 1 21 4.619V14",key:"40pylx"}],["path",{d:"M15 5.764V14",key:"1bab71"}],["path",{d:"M21 18h-6",key:"139f0c"}],["path",{d:"M9 3.236v15",key:"1uimfh"}]],MapMinus=createLucideIcon("map-minus",__iconNode$bk);const __iconNode$bj=[["path",{d:"M20 10c0 4.993-5.539 10.193-7.399 11.799a1 1 0 0 1-1.202 0C9.539 20.193 4 14.993 4 10a8 8 0 0 1 16 0",key:"1r0f0z"}],["path",{d:"m9 10 2 2 4-4",key:"1gnqz4"}]],MapPinCheckInside=createLucideIcon("map-pin-check-inside",__iconNode$bj);const __iconNode$bi=[["path",{d:"M19.43 12.935c.357-.967.57-1.955.57-2.935a8 8 0 0 0-16 0c0 4.993 5.539 10.193 7.399 11.799a1 1 0 0 0 1.202 0 32.197 32.197 0 0 0 .813-.728",key:"1dq61d"}],["circle",{cx:"12",cy:"10",r:"3",key:"ilqhr7"}],["path",{d:"m16 18 2 2 4-4",key:"1mkfmb"}]],MapPinCheck=createLucideIcon("map-pin-check",__iconNode$bi);const __iconNode$bh=[["path",{d:"M15 22a1 1 0 0 1-1-1v-4a1 1 0 0 1 .445-.832l3-2a1 1 0 0 1 1.11 0l3 2A1 1 0 0 1 22 17v4a1 1 0 0 1-1 1z",key:"1p1rcz"}],["path",{d:"M18 10a8 8 0 0 0-16 0c0 4.993 5.539 10.193 7.399 11.799a1 1 0 0 0 .601.2",key:"mcbcs9"}],["path",{d:"M18 22v-3",key:"1t1ugv"}],["circle",{cx:"10",cy:"10",r:"3",key:"1ns7v1"}]],MapPinHouse=createLucideIcon("map-pin-house",__iconNode$bh);const __iconNode$bg=[["path",{d:"M20 10c0 4.993-5.539 10.193-7.399 11.799a1 1 0 0 1-1.202 0C9.539 20.193 4 14.993 4 10a8 8 0 0 1 16 0",key:"1r0f0z"}],["path",{d:"M9 10h6",key:"9gxzsh"}]],MapPinMinusInside=createLucideIcon("map-pin-minus-inside",__iconNode$bg);const __iconNode$bf=[["path",{d:"M18.977 14C19.6 12.701 20 11.343 20 10a8 8 0 0 0-16 0c0 4.993 5.539 10.193 7.399 11.799a1 1 0 0 0 1.202 0 32 32 0 0 0 .824-.738",key:"11uxia"}],["circle",{cx:"12",cy:"10",r:"3",key:"ilqhr7"}],["path",{d:"M16 18h6",key:"987eiv"}]],MapPinMinus=createLucideIcon("map-pin-minus",__iconNode$bf);const __iconNode$be=[["path",{d:"M12.75 7.09a3 3 0 0 1 2.16 2.16",key:"1d4wjd"}],["path",{d:"M17.072 17.072c-1.634 2.17-3.527 3.912-4.471 4.727a1 1 0 0 1-1.202 0C9.539 20.193 4 14.993 4 10a8 8 0 0 1 1.432-4.568",key:"12yil7"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M8.475 2.818A8 8 0 0 1 20 10c0 1.183-.31 2.377-.81 3.533",key:"lhrkcz"}],["path",{d:"M9.13 9.13a3 3 0 0 0 3.74 3.74",key:"13wojd"}]],MapPinOff=createLucideIcon("map-pin-off",__iconNode$be);const __iconNode$bd=[["path",{d:"M17.97 9.304A8 8 0 0 0 2 10c0 4.69 4.887 9.562 7.022 11.468",key:"1fahp3"}],["path",{d:"M21.378 16.626a1 1 0 0 0-3.004-3.004l-4.01 4.012a2 2 0 0 0-.506.854l-.837 2.87a.5.5 0 0 0 .62.62l2.87-.837a2 2 0 0 0 .854-.506z",key:"1817ys"}],["circle",{cx:"10",cy:"10",r:"3",key:"1ns7v1"}]],MapPinPen=createLucideIcon("map-pin-pen",__iconNode$bd);const __iconNode$bc=[["path",{d:"M20 10c0 4.993-5.539 10.193-7.399 11.799a1 1 0 0 1-1.202 0C9.539 20.193 4 14.993 4 10a8 8 0 0 1 16 0",key:"1r0f0z"}],["path",{d:"M12 7v6",key:"lw1j43"}],["path",{d:"M9 10h6",key:"9gxzsh"}]],MapPinPlusInside=createLucideIcon("map-pin-plus-inside",__iconNode$bc);const __iconNode$bb=[["path",{d:"M19.914 11.105A7.298 7.298 0 0 0 20 10a8 8 0 0 0-16 0c0 4.993 5.539 10.193 7.399 11.799a1 1 0 0 0 1.202 0 32 32 0 0 0 .824-.738",key:"fcdtly"}],["circle",{cx:"12",cy:"10",r:"3",key:"ilqhr7"}],["path",{d:"M16 18h6",key:"987eiv"}],["path",{d:"M19 15v6",key:"10aioa"}]],MapPinPlus=createLucideIcon("map-pin-plus",__iconNode$bb);const __iconNode$ba=[["path",{d:"M20 10c0 4.993-5.539 10.193-7.399 11.799a1 1 0 0 1-1.202 0C9.539 20.193 4 14.993 4 10a8 8 0 0 1 16 0",key:"1r0f0z"}],["path",{d:"m14.5 7.5-5 5",key:"3lb6iw"}],["path",{d:"m9.5 7.5 5 5",key:"ko136h"}]],MapPinXInside=createLucideIcon("map-pin-x-inside",__iconNode$ba);const __iconNode$b9=[["path",{d:"M19.752 11.901A7.78 7.78 0 0 0 20 10a8 8 0 0 0-16 0c0 4.993 5.539 10.193 7.399 11.799a1 1 0 0 0 1.202 0 19 19 0 0 0 .09-.077",key:"y0ewhp"}],["circle",{cx:"12",cy:"10",r:"3",key:"ilqhr7"}],["path",{d:"m21.5 15.5-5 5",key:"11iqnx"}],["path",{d:"m21.5 20.5-5-5",key:"1bylgx"}]],MapPinX=createLucideIcon("map-pin-x",__iconNode$b9);const __iconNode$b8=[["path",{d:"M20 10c0 4.993-5.539 10.193-7.399 11.799a1 1 0 0 1-1.202 0C9.539 20.193 4 14.993 4 10a8 8 0 0 1 16 0",key:"1r0f0z"}],["circle",{cx:"12",cy:"10",r:"3",key:"ilqhr7"}]],MapPin=createLucideIcon("map-pin",__iconNode$b8);const __iconNode$b7=[["path",{d:"M18 8c0 3.613-3.869 7.429-5.393 8.795a1 1 0 0 1-1.214 0C9.87 15.429 6 11.613 6 8a6 6 0 0 1 12 0",key:"11u0oz"}],["circle",{cx:"12",cy:"8",r:"2",key:"1822b1"}],["path",{d:"M8.714 14h-3.71a1 1 0 0 0-.948.683l-2.004 6A1 1 0 0 0 3 22h18a1 1 0 0 0 .948-1.316l-2-6a1 1 0 0 0-.949-.684h-3.712",key:"q8zwxj"}]],MapPinned=createLucideIcon("map-pinned",__iconNode$b7);const __iconNode$b6=[["path",{d:"m11 19-1.106-.552a2 2 0 0 0-1.788 0l-3.659 1.83A1 1 0 0 1 3 19.381V6.618a1 1 0 0 1 .553-.894l4.553-2.277a2 2 0 0 1 1.788 0l4.212 2.106a2 2 0 0 0 1.788 0l3.659-1.83A1 1 0 0 1 21 4.619V12",key:"svfegj"}],["path",{d:"M15 5.764V12",key:"1ocw4k"}],["path",{d:"M18 15v6",key:"9wciyi"}],["path",{d:"M21 18h-6",key:"139f0c"}],["path",{d:"M9 3.236v15",key:"1uimfh"}]],MapPlus=createLucideIcon("map-plus",__iconNode$b6);const __iconNode$b5=[["path",{d:"M14.106 5.553a2 2 0 0 0 1.788 0l3.659-1.83A1 1 0 0 1 21 4.619v12.764a1 1 0 0 1-.553.894l-4.553 2.277a2 2 0 0 1-1.788 0l-4.212-2.106a2 2 0 0 0-1.788 0l-3.659 1.83A1 1 0 0 1 3 19.381V6.618a1 1 0 0 1 .553-.894l4.553-2.277a2 2 0 0 1 1.788 0z",key:"169xi5"}],["path",{d:"M15 5.764v15",key:"1pn4in"}],["path",{d:"M9 3.236v15",key:"1uimfh"}]],Map$2=createLucideIcon("map",__iconNode$b5);const __iconNode$b4=[["path",{d:"m14 6 4 4",key:"1q72g9"}],["path",{d:"M17 3h4v4",key:"19p9u1"}],["path",{d:"m21 3-7.75 7.75",key:"1cjbfd"}],["circle",{cx:"9",cy:"15",r:"6",key:"bx5svt"}]],MarsStroke=createLucideIcon("mars-stroke",__iconNode$b4);const __iconNode$b3=[["path",{d:"M16 3h5v5",key:"1806ms"}],["path",{d:"m21 3-6.75 6.75",key:"pv0uzu"}],["circle",{cx:"10",cy:"14",r:"6",key:"1qwbdc"}]],Mars=createLucideIcon("mars",__iconNode$b3);const __iconNode$b2=[["path",{d:"M8 22h8",key:"rmew8v"}],["path",{d:"M12 11v11",key:"ur9y6a"}],["path",{d:"m19 3-7 8-7-8Z",key:"1sgpiw"}]],Martini=createLucideIcon("martini",__iconNode$b2);const __iconNode$b1=[["path",{d:"M15 3h6v6",key:"1q9fwt"}],["path",{d:"m21 3-7 7",key:"1l2asr"}],["path",{d:"m3 21 7-7",key:"tjx5ai"}],["path",{d:"M9 21H3v-6",key:"wtvkvv"}]],Maximize2=createLucideIcon("maximize-2",__iconNode$b1);const __iconNode$b0=[["path",{d:"M8 3H5a2 2 0 0 0-2 2v3",key:"1dcmit"}],["path",{d:"M21 8V5a2 2 0 0 0-2-2h-3",key:"1e4gt3"}],["path",{d:"M3 16v3a2 2 0 0 0 2 2h3",key:"wsl5sc"}],["path",{d:"M16 21h3a2 2 0 0 0 2-2v-3",key:"18trek"}]],Maximize=createLucideIcon("maximize",__iconNode$b0);const __iconNode$a$=[["path",{d:"M7.21 15 2.66 7.14a2 2 0 0 1 .13-2.2L4.4 2.8A2 2 0 0 1 6 2h12a2 2 0 0 1 1.6.8l1.6 2.14a2 2 0 0 1 .14 2.2L16.79 15",key:"143lza"}],["path",{d:"M11 12 5.12 2.2",key:"qhuxz6"}],["path",{d:"m13 12 5.88-9.8",key:"hbye0f"}],["path",{d:"M8 7h8",key:"i86dvs"}],["circle",{cx:"12",cy:"17",r:"5",key:"qbz8iq"}],["path",{d:"M12 18v-2h-.5",key:"fawc4q"}]],Medal=createLucideIcon("medal",__iconNode$a$);const __iconNode$a_=[["path",{d:"M11.636 6A13 13 0 0 0 19.4 3.2 1 1 0 0 1 21 4v11.344",key:"bycexp"}],["path",{d:"M14.378 14.357A13 13 0 0 0 11 14H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h1",key:"1t17s6"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M6 14a12 12 0 0 0 2.4 7.2 2 2 0 0 0 3.2-2.4A8 8 0 0 1 10 14",key:"1853fq"}],["path",{d:"M8 8v6",key:"aieo6v"}]],MegaphoneOff=createLucideIcon("megaphone-off",__iconNode$a_);const __iconNode$aZ=[["path",{d:"M11 6a13 13 0 0 0 8.4-2.8A1 1 0 0 1 21 4v12a1 1 0 0 1-1.6.8A13 13 0 0 0 11 14H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2z",key:"q8bfy3"}],["path",{d:"M6 14a12 12 0 0 0 2.4 7.2 2 2 0 0 0 3.2-2.4A8 8 0 0 1 10 14",key:"1853fq"}],["path",{d:"M8 6v8",key:"15ugcq"}]],Megaphone=createLucideIcon("megaphone",__iconNode$aZ);const __iconNode$aY=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["line",{x1:"8",x2:"16",y1:"15",y2:"15",key:"1xb1d9"}],["line",{x1:"9",x2:"9.01",y1:"9",y2:"9",key:"yxxnd0"}],["line",{x1:"15",x2:"15.01",y1:"9",y2:"9",key:"1p4y9e"}]],Meh=createLucideIcon("meh",__iconNode$aY);const __iconNode$aX=[["path",{d:"M6 19v-3",key:"1nvgqn"}],["path",{d:"M10 19v-3",key:"iu8nkm"}],["path",{d:"M14 19v-3",key:"kcehxu"}],["path",{d:"M18 19v-3",key:"1vh91z"}],["path",{d:"M8 11V9",key:"63erz4"}],["path",{d:"M16 11V9",key:"fru6f3"}],["path",{d:"M12 11V9",key:"ha00sb"}],["path",{d:"M2 15h20",key:"16ne18"}],["path",{d:"M2 7a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v1.1a2 2 0 0 0 0 3.837V17a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2v-5.1a2 2 0 0 0 0-3.837Z",key:"lhddv3"}]],MemoryStick=createLucideIcon("memory-stick",__iconNode$aX);const __iconNode$aW=[["path",{d:"M4 5h16",key:"1tepv9"}],["path",{d:"M4 12h16",key:"1lakjw"}],["path",{d:"M4 19h16",key:"1djgab"}]],Menu=createLucideIcon("menu",__iconNode$aW);const __iconNode$aV=[["path",{d:"m8 6 4-4 4 4",key:"ybng9g"}],["path",{d:"M12 2v10.3a4 4 0 0 1-1.172 2.872L4 22",key:"1hyw0i"}],["path",{d:"m20 22-5-5",key:"1m27yz"}]],Merge=createLucideIcon("merge",__iconNode$aV);const __iconNode$aU=[["path",{d:"m10 9-3 3 3 3",key:"1oro0q"}],["path",{d:"m14 15 3-3-3-3",key:"bz13h7"}],["path",{d:"M2.992 16.342a2 2 0 0 1 .094 1.167l-1.065 3.29a1 1 0 0 0 1.236 1.168l3.413-.998a2 2 0 0 1 1.099.092 10 10 0 1 0-4.777-4.719",key:"1sd12s"}]],MessageCircleCode=createLucideIcon("message-circle-code",__iconNode$aU);const __iconNode$aT=[["path",{d:"M2.992 16.342a2 2 0 0 1 .094 1.167l-1.065 3.29a1 1 0 0 0 1.236 1.168l3.413-.998a2 2 0 0 1 1.099.092 10 10 0 1 0-4.777-4.719",key:"1sd12s"}],["path",{d:"M7.828 13.07A3 3 0 0 1 12 8.764a3 3 0 0 1 5.004 2.224 3 3 0 0 1-.832 2.083l-3.447 3.62a1 1 0 0 1-1.45-.001z",key:"hoo97p"}]],MessageCircleHeart=createLucideIcon("message-circle-heart",__iconNode$aT);const __iconNode$aS=[["path",{d:"M10.1 2.182a10 10 0 0 1 3.8 0",key:"5ilxe3"}],["path",{d:"M13.9 21.818a10 10 0 0 1-3.8 0",key:"11zvb9"}],["path",{d:"M17.609 3.72a10 10 0 0 1 2.69 2.7",key:"jiglxs"}],["path",{d:"M2.182 13.9a10 10 0 0 1 0-3.8",key:"c0bmvh"}],["path",{d:"M20.28 17.61a10 10 0 0 1-2.7 2.69",key:"elg7ff"}],["path",{d:"M21.818 10.1a10 10 0 0 1 0 3.8",key:"qkgqxc"}],["path",{d:"M3.721 6.391a10 10 0 0 1 2.7-2.69",key:"1mcia2"}],["path",{d:"m6.163 21.117-2.906.85a1 1 0 0 1-1.236-1.169l.965-2.98",key:"1qsu07"}]],MessageCircleDashed=createLucideIcon("message-circle-dashed",__iconNode$aS);const __iconNode$aR=[["path",{d:"M2.992 16.342a2 2 0 0 1 .094 1.167l-1.065 3.29a1 1 0 0 0 1.236 1.168l3.413-.998a2 2 0 0 1 1.099.092 10 10 0 1 0-4.777-4.719",key:"1sd12s"}],["path",{d:"M8 12h.01",key:"czm47f"}],["path",{d:"M12 12h.01",key:"1mp3jc"}],["path",{d:"M16 12h.01",key:"1l6xoz"}]],MessageCircleMore=createLucideIcon("message-circle-more",__iconNode$aR);const __iconNode$aQ=[["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M4.93 4.929a10 10 0 0 0-1.938 11.412 2 2 0 0 1 .094 1.167l-1.065 3.29a1 1 0 0 0 1.236 1.168l3.413-.998a2 2 0 0 1 1.099.092 10 10 0 0 0 11.302-1.989",key:"7il5tn"}],["path",{d:"M8.35 2.69A10 10 0 0 1 21.3 15.65",key:"1pfsoa"}]],MessageCircleOff=createLucideIcon("message-circle-off",__iconNode$aQ);const __iconNode$aP=[["path",{d:"M2.992 16.342a2 2 0 0 1 .094 1.167l-1.065 3.29a1 1 0 0 0 1.236 1.168l3.413-.998a2 2 0 0 1 1.099.092 10 10 0 1 0-4.777-4.719",key:"1sd12s"}],["path",{d:"M8 12h8",key:"1wcyev"}],["path",{d:"M12 8v8",key:"napkw2"}]],MessageCirclePlus=createLucideIcon("message-circle-plus",__iconNode$aP);const __iconNode$aO=[["path",{d:"M2.992 16.342a2 2 0 0 1 .094 1.167l-1.065 3.29a1 1 0 0 0 1.236 1.168l3.413-.998a2 2 0 0 1 1.099.092 10 10 0 1 0-4.777-4.719",key:"1sd12s"}],["path",{d:"M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3",key:"1u773s"}],["path",{d:"M12 17h.01",key:"p32p05"}]],MessageCircleQuestionMark=createLucideIcon("message-circle-question-mark",__iconNode$aO);const __iconNode$aN=[["path",{d:"M2.992 16.342a2 2 0 0 1 .094 1.167l-1.065 3.29a1 1 0 0 0 1.236 1.168l3.413-.998a2 2 0 0 1 1.099.092 10 10 0 1 0-4.777-4.719",key:"1sd12s"}],["path",{d:"m10 15-3-3 3-3",key:"1pgupc"}],["path",{d:"M7 12h8a2 2 0 0 1 2 2v1",key:"89sh1g"}]],MessageCircleReply=createLucideIcon("message-circle-reply",__iconNode$aN);const __iconNode$aM=[["path",{d:"M2.992 16.342a2 2 0 0 1 .094 1.167l-1.065 3.29a1 1 0 0 0 1.236 1.168l3.413-.998a2 2 0 0 1 1.099.092 10 10 0 1 0-4.777-4.719",key:"1sd12s"}],["path",{d:"m15 9-6 6",key:"1uzhvr"}],["path",{d:"m9 9 6 6",key:"z0biqf"}]],MessageCircleX=createLucideIcon("message-circle-x",__iconNode$aM);const __iconNode$aL=[["path",{d:"M2.992 16.342a2 2 0 0 1 .094 1.167l-1.065 3.29a1 1 0 0 0 1.236 1.168l3.413-.998a2 2 0 0 1 1.099.092 10 10 0 1 0-4.777-4.719",key:"1sd12s"}],["path",{d:"M12 8v4",key:"1got3b"}],["path",{d:"M12 16h.01",key:"1drbdi"}]],MessageCircleWarning=createLucideIcon("message-circle-warning",__iconNode$aL);const __iconNode$aK=[["path",{d:"M2.992 16.342a2 2 0 0 1 .094 1.167l-1.065 3.29a1 1 0 0 0 1.236 1.168l3.413-.998a2 2 0 0 1 1.099.092 10 10 0 1 0-4.777-4.719",key:"1sd12s"}]],MessageCircle=createLucideIcon("message-circle",__iconNode$aK);const __iconNode$aJ=[["path",{d:"M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z",key:"18887p"}],["path",{d:"m10 8-3 3 3 3",key:"fp6dz7"}],["path",{d:"m14 14 3-3-3-3",key:"1yrceu"}]],MessageSquareCode=createLucideIcon("message-square-code",__iconNode$aJ);const __iconNode$aI=[["path",{d:"M12 19h.01",key:"1wutuc"}],["path",{d:"M12 3h.01",key:"n36tog"}],["path",{d:"M16 19h.01",key:"1vcnzz"}],["path",{d:"M16 3h.01",key:"ll0zb8"}],["path",{d:"M2 13h.01",key:"1aptou"}],["path",{d:"M2 17v4.286a.71.71 0 0 0 1.212.502l2.202-2.202A2 2 0 0 1 6.828 19H8",key:"4cp7zq"}],["path",{d:"M2 5a2 2 0 0 1 2-2",key:"1iztiu"}],["path",{d:"M2 9h.01",key:"1nzd1v"}],["path",{d:"M20 3a2 2 0 0 1 2 2",key:"m48m3a"}],["path",{d:"M22 13h.01",key:"ke7esy"}],["path",{d:"M22 17a2 2 0 0 1-2 2",key:"17q5fo"}],["path",{d:"M22 9h.01",key:"npkp49"}],["path",{d:"M8 3h.01",key:"133hau"}]],MessageSquareDashed=createLucideIcon("message-square-dashed",__iconNode$aI);const __iconNode$aH=[["path",{d:"M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z",key:"18887p"}],["path",{d:"M10 15h4",key:"192ueg"}],["path",{d:"M10 9h4",key:"u4k05v"}],["path",{d:"M12 7v4",key:"xawao1"}]],MessageSquareDiff=createLucideIcon("message-square-diff",__iconNode$aH);const __iconNode$aG=[["path",{d:"M12.7 3H4a2 2 0 0 0-2 2v16.286a.71.71 0 0 0 1.212.502l2.202-2.202A2 2 0 0 1 6.828 19H20a2 2 0 0 0 2-2v-4.7",key:"wjb7ig"}],["circle",{cx:"19",cy:"6",r:"3",key:"108a5v"}]],MessageSquareDot=createLucideIcon("message-square-dot",__iconNode$aG);const __iconNode$aF=[["path",{d:"M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z",key:"18887p"}],["path",{d:"M7.5 9.5c0 .687.265 1.383.697 1.844l3.009 3.264a1.14 1.14 0 0 0 .407.314 1 1 0 0 0 .783-.004 1.14 1.14 0 0 0 .398-.31l3.008-3.264A2.77 2.77 0 0 0 16.5 9.5 2.5 2.5 0 0 0 12 8a2.5 2.5 0 0 0-4.5 1.5",key:"1faxuh"}]],MessageSquareHeart=createLucideIcon("message-square-heart",__iconNode$aF);const __iconNode$aE=[["path",{d:"M22 8.5V5a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v16.286a.71.71 0 0 0 1.212.502l2.202-2.202A2 2 0 0 1 6.828 19H10",key:"fu6chl"}],["path",{d:"M20 15v-2a2 2 0 0 0-4 0v2",key:"vl8a78"}],["rect",{x:"14",y:"15",width:"8",height:"5",rx:"1",key:"37aafw"}]],MessageSquareLock=createLucideIcon("message-square-lock",__iconNode$aE);const __iconNode$aD=[["path",{d:"M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z",key:"18887p"}],["path",{d:"M12 11h.01",key:"z322tv"}],["path",{d:"M16 11h.01",key:"xkw8gn"}],["path",{d:"M8 11h.01",key:"1dfujw"}]],MessageSquareMore=createLucideIcon("message-square-more",__iconNode$aD);const __iconNode$aC=[["path",{d:"M19 19H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.7.7 0 0 1 2 21.286V5a2 2 0 0 1 1.184-1.826",key:"1wyg69"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M8.656 3H20a2 2 0 0 1 2 2v11.344",key:"mhl4k6"}]],MessageSquareOff=createLucideIcon("message-square-off",__iconNode$aC);const __iconNode$aB=[["path",{d:"M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z",key:"18887p"}],["path",{d:"M12 8v6",key:"1ib9pf"}],["path",{d:"M9 11h6",key:"1fldmi"}]],MessageSquarePlus=createLucideIcon("message-square-plus",__iconNode$aB);const __iconNode$aA=[["path",{d:"M14 14a2 2 0 0 0 2-2V8h-2",key:"1r06pg"}],["path",{d:"M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z",key:"18887p"}],["path",{d:"M8 14a2 2 0 0 0 2-2V8H8",key:"1jzu5j"}]],MessageSquareQuote=createLucideIcon("message-square-quote",__iconNode$aA);const __iconNode$az=[["path",{d:"M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z",key:"18887p"}],["path",{d:"m10 8-3 3 3 3",key:"fp6dz7"}],["path",{d:"M17 14v-1a2 2 0 0 0-2-2H7",key:"1tkjnz"}]],MessageSquareReply=createLucideIcon("message-square-reply",__iconNode$az);const __iconNode$ay=[["path",{d:"M12 3H4a2 2 0 0 0-2 2v16.286a.71.71 0 0 0 1.212.502l2.202-2.202A2 2 0 0 1 6.828 19H20a2 2 0 0 0 2-2v-4",key:"11da1y"}],["path",{d:"M16 3h6v6",key:"1bx56c"}],["path",{d:"m16 9 6-6",key:"m4dnic"}]],MessageSquareShare=createLucideIcon("message-square-share",__iconNode$ay);const __iconNode$ax=[["path",{d:"M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z",key:"18887p"}],["path",{d:"M7 11h10",key:"1twpyw"}],["path",{d:"M7 15h6",key:"d9of3u"}],["path",{d:"M7 7h8",key:"af5zfr"}]],MessageSquareText=createLucideIcon("message-square-text",__iconNode$ax);const __iconNode$aw=[["path",{d:"M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z",key:"18887p"}],["path",{d:"M12 15h.01",key:"q59x07"}],["path",{d:"M12 7v4",key:"xawao1"}]],MessageSquareWarning=createLucideIcon("message-square-warning",__iconNode$aw);const __iconNode$av=[["path",{d:"M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z",key:"18887p"}],["path",{d:"m14.5 8.5-5 5",key:"19tnj2"}],["path",{d:"m9.5 8.5 5 5",key:"1oa8ql"}]],MessageSquareX=createLucideIcon("message-square-x",__iconNode$av);const __iconNode$au=[["path",{d:"M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z",key:"18887p"}]],MessageSquare=createLucideIcon("message-square",__iconNode$au);const __iconNode$at=[["path",{d:"M16 10a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 14.286V4a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2z",key:"1n2ejm"}],["path",{d:"M20 9a2 2 0 0 1 2 2v10.286a.71.71 0 0 1-1.212.502l-2.202-2.202A2 2 0 0 0 17.172 19H10a2 2 0 0 1-2-2v-1",key:"1qfcsi"}]],MessagesSquare=createLucideIcon("messages-square",__iconNode$at);const __iconNode$as=[["path",{d:"m11 7.601-5.994 8.19a1 1 0 0 0 .1 1.298l.817.818a1 1 0 0 0 1.314.087L15.09 12",key:"80a601"}],["path",{d:"M16.5 21.174C15.5 20.5 14.372 20 13 20c-2.058 0-3.928 2.356-6 2-2.072-.356-2.775-3.369-1.5-4.5",key:"j0ngtp"}],["circle",{cx:"16",cy:"7",r:"5",key:"d08jfb"}]],MicVocal=createLucideIcon("mic-vocal",__iconNode$as);const __iconNode$ar=[["path",{d:"M12 19v3",key:"npa21l"}],["path",{d:"M15 9.34V5a3 3 0 0 0-5.68-1.33",key:"1gzdoj"}],["path",{d:"M16.95 16.95A7 7 0 0 1 5 12v-2",key:"cqa7eg"}],["path",{d:"M18.89 13.23A7 7 0 0 0 19 12v-2",key:"16hl24"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M9 9v3a3 3 0 0 0 5.12 2.12",key:"r2i35w"}]],MicOff=createLucideIcon("mic-off",__iconNode$ar);const __iconNode$aq=[["path",{d:"M12 19v3",key:"npa21l"}],["path",{d:"M19 10v2a7 7 0 0 1-14 0v-2",key:"1vc78b"}],["rect",{x:"9",y:"2",width:"6",height:"13",rx:"3",key:"s6n7sd"}]],Mic=createLucideIcon("mic",__iconNode$aq);const __iconNode$ap=[["path",{d:"M18 12h2",key:"quuxs7"}],["path",{d:"M18 16h2",key:"zsn3lv"}],["path",{d:"M18 20h2",key:"9x5y9y"}],["path",{d:"M18 4h2",key:"1luxfb"}],["path",{d:"M18 8h2",key:"nxqzg"}],["path",{d:"M4 12h2",key:"1ltxp0"}],["path",{d:"M4 16h2",key:"8a5zha"}],["path",{d:"M4 20h2",key:"27dk57"}],["path",{d:"M4 4h2",key:"10groj"}],["path",{d:"M4 8h2",key:"18vq6w"}],["path",{d:"M8 2a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h8a2 2 0 0 0 2-2V4a2 2 0 0 0-2-2h-1.5c-.276 0-.494.227-.562.495a2 2 0 0 1-3.876 0C9.994 2.227 9.776 2 9.5 2z",key:"1681fp"}]],Microchip=createLucideIcon("microchip",__iconNode$ap);const __iconNode$ao=[["path",{d:"M6 18h8",key:"1borvv"}],["path",{d:"M3 22h18",key:"8prr45"}],["path",{d:"M14 22a7 7 0 1 0 0-14h-1",key:"1jwaiy"}],["path",{d:"M9 14h2",key:"197e7h"}],["path",{d:"M9 12a2 2 0 0 1-2-2V6h6v4a2 2 0 0 1-2 2Z",key:"1bmzmy"}],["path",{d:"M12 6V3a1 1 0 0 0-1-1H9a1 1 0 0 0-1 1v3",key:"1drr47"}]],Microscope=createLucideIcon("microscope",__iconNode$ao);const __iconNode$an=[["rect",{width:"20",height:"15",x:"2",y:"4",rx:"2",key:"2no95f"}],["rect",{width:"8",height:"7",x:"6",y:"8",rx:"1",key:"zh9wx"}],["path",{d:"M18 8v7",key:"o5zi4n"}],["path",{d:"M6 19v2",key:"1loha6"}],["path",{d:"M18 19v2",key:"1dawf0"}]],Microwave=createLucideIcon("microwave",__iconNode$an);const __iconNode$am=[["path",{d:"M12 13v8",key:"1l5pq0"}],["path",{d:"M12 3v3",key:"1n5kay"}],["path",{d:"M4 6a1 1 0 0 0-1 1v5a1 1 0 0 0 1 1h13a2 2 0 0 0 1.152-.365l3.424-2.317a1 1 0 0 0 0-1.635l-3.424-2.318A2 2 0 0 0 17 6z",key:"1btarq"}]],Milestone=createLucideIcon("milestone",__iconNode$am);const __iconNode$al=[["path",{d:"M8 2h8",key:"1ssgc1"}],["path",{d:"M9 2v1.343M15 2v2.789a4 4 0 0 0 .672 2.219l.656.984a4 4 0 0 1 .672 2.22v1.131M7.8 7.8l-.128.192A4 4 0 0 0 7 10.212V20a2 2 0 0 0 2 2h6a2 2 0 0 0 2-2v-3",key:"y0ejgx"}],["path",{d:"M7 15a6.47 6.47 0 0 1 5 0 6.472 6.472 0 0 0 3.435.435",key:"iaxqsy"}],["line",{x1:"2",x2:"22",y1:"2",y2:"22",key:"a6p6uj"}]],MilkOff=createLucideIcon("milk-off",__iconNode$al);const __iconNode$ak=[["path",{d:"M8 2h8",key:"1ssgc1"}],["path",{d:"M9 2v2.789a4 4 0 0 1-.672 2.219l-.656.984A4 4 0 0 0 7 10.212V20a2 2 0 0 0 2 2h6a2 2 0 0 0 2-2v-9.789a4 4 0 0 0-.672-2.219l-.656-.984A4 4 0 0 1 15 4.788V2",key:"qtp12x"}],["path",{d:"M7 15a6.472 6.472 0 0 1 5 0 6.47 6.47 0 0 0 5 0",key:"ygeh44"}]],Milk=createLucideIcon("milk",__iconNode$ak);const __iconNode$aj=[["path",{d:"m14 10 7-7",key:"oa77jy"}],["path",{d:"M20 10h-6V4",key:"mjg0md"}],["path",{d:"m3 21 7-7",key:"tjx5ai"}],["path",{d:"M4 14h6v6",key:"rmj7iw"}]],Minimize2=createLucideIcon("minimize-2",__iconNode$aj);const __iconNode$ai=[["path",{d:"M8 3v3a2 2 0 0 1-2 2H3",key:"hohbtr"}],["path",{d:"M21 8h-3a2 2 0 0 1-2-2V3",key:"5jw1f3"}],["path",{d:"M3 16h3a2 2 0 0 1 2 2v3",key:"198tvr"}],["path",{d:"M16 21v-3a2 2 0 0 1 2-2h3",key:"ph8mxp"}]],Minimize=createLucideIcon("minimize",__iconNode$ai);const __iconNode$ah=[["path",{d:"M5 12h14",key:"1ays0h"}]],Minus=createLucideIcon("minus",__iconNode$ah);const __iconNode$ag=[["path",{d:"m9 10 2 2 4-4",key:"1gnqz4"}],["rect",{width:"20",height:"14",x:"2",y:"3",rx:"2",key:"48i651"}],["path",{d:"M12 17v4",key:"1riwvh"}],["path",{d:"M8 21h8",key:"1ev6f3"}]],MonitorCheck=createLucideIcon("monitor-check",__iconNode$ag);const __iconNode$af=[["path",{d:"M11 13a3 3 0 1 1 2.83-4H14a2 2 0 0 1 0 4z",key:"1da4q6"}],["path",{d:"M12 17v4",key:"1riwvh"}],["path",{d:"M8 21h8",key:"1ev6f3"}],["rect",{x:"2",y:"3",width:"20",height:"14",rx:"2",key:"x3v2xh"}]],MonitorCloud=createLucideIcon("monitor-cloud",__iconNode$af);const __iconNode$ae=[["path",{d:"M12 17v4",key:"1riwvh"}],["path",{d:"m14.305 7.53.923-.382",key:"1mlnsw"}],["path",{d:"m15.228 4.852-.923-.383",key:"82mpwg"}],["path",{d:"m16.852 3.228-.383-.924",key:"ln4sir"}],["path",{d:"m16.852 8.772-.383.923",key:"1dejw0"}],["path",{d:"m19.148 3.228.383-.924",key:"192kgf"}],["path",{d:"m19.53 9.696-.382-.924",key:"fiavlr"}],["path",{d:"m20.772 4.852.924-.383",key:"1j8mgp"}],["path",{d:"m20.772 7.148.924.383",key:"zix9be"}],["path",{d:"M22 13v2a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h7",key:"1tnzv8"}],["path",{d:"M8 21h8",key:"1ev6f3"}],["circle",{cx:"18",cy:"6",r:"3",key:"1h7g24"}]],MonitorCog=createLucideIcon("monitor-cog",__iconNode$ae);const __iconNode$ad=[["path",{d:"M12 17v4",key:"1riwvh"}],["path",{d:"M22 12.307V15a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h8.693",key:"1dx6ho"}],["path",{d:"M8 21h8",key:"1ev6f3"}],["circle",{cx:"19",cy:"6",r:"3",key:"108a5v"}]],MonitorDot=createLucideIcon("monitor-dot",__iconNode$ad);const __iconNode$ac=[["path",{d:"M12 13V7",key:"h0r20n"}],["path",{d:"m15 10-3 3-3-3",key:"lzhmyn"}],["rect",{width:"20",height:"14",x:"2",y:"3",rx:"2",key:"48i651"}],["path",{d:"M12 17v4",key:"1riwvh"}],["path",{d:"M8 21h8",key:"1ev6f3"}]],MonitorDown=createLucideIcon("monitor-down",__iconNode$ac);const __iconNode$ab=[["path",{d:"M17 17H4a2 2 0 0 1-2-2V5c0-1.5 1-2 1-2",key:"k0q8oc"}],["path",{d:"M22 15V5a2 2 0 0 0-2-2H9",key:"cp1ac0"}],["path",{d:"M8 21h8",key:"1ev6f3"}],["path",{d:"M12 17v4",key:"1riwvh"}],["path",{d:"m2 2 20 20",key:"1ooewy"}]],MonitorOff=createLucideIcon("monitor-off",__iconNode$ab);const __iconNode$aa=[["path",{d:"M10 13V7",key:"1u13u9"}],["path",{d:"M14 13V7",key:"1vj9om"}],["rect",{width:"20",height:"14",x:"2",y:"3",rx:"2",key:"48i651"}],["path",{d:"M12 17v4",key:"1riwvh"}],["path",{d:"M8 21h8",key:"1ev6f3"}]],MonitorPause=createLucideIcon("monitor-pause",__iconNode$aa);const __iconNode$a9=[["path",{d:"M15.033 9.44a.647.647 0 0 1 0 1.12l-4.065 2.352a.645.645 0 0 1-.968-.56V7.648a.645.645 0 0 1 .967-.56z",key:"vbtd3f"}],["path",{d:"M12 17v4",key:"1riwvh"}],["path",{d:"M8 21h8",key:"1ev6f3"}],["rect",{x:"2",y:"3",width:"20",height:"14",rx:"2",key:"x3v2xh"}]],MonitorPlay=createLucideIcon("monitor-play",__iconNode$a9);const __iconNode$a8=[["path",{d:"M18 8V6a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v7a2 2 0 0 0 2 2h8",key:"10dyio"}],["path",{d:"M10 19v-3.96 3.15",key:"1irgej"}],["path",{d:"M7 19h5",key:"qswx4l"}],["rect",{width:"6",height:"10",x:"16",y:"12",rx:"2",key:"1egngj"}]],MonitorSmartphone=createLucideIcon("monitor-smartphone",__iconNode$a8);const __iconNode$a7=[["path",{d:"M5.5 20H8",key:"1k40s5"}],["path",{d:"M17 9h.01",key:"1j24nn"}],["rect",{width:"10",height:"16",x:"12",y:"4",rx:"2",key:"ixliua"}],["path",{d:"M8 6H4a2 2 0 0 0-2 2v6a2 2 0 0 0 2 2h4",key:"1mp6e1"}],["circle",{cx:"17",cy:"15",r:"1",key:"tqvash"}]],MonitorSpeaker=createLucideIcon("monitor-speaker",__iconNode$a7);const __iconNode$a6=[["path",{d:"M12 17v4",key:"1riwvh"}],["path",{d:"M8 21h8",key:"1ev6f3"}],["rect",{x:"2",y:"3",width:"20",height:"14",rx:"2",key:"x3v2xh"}],["rect",{x:"9",y:"7",width:"6",height:"6",rx:"1",key:"5m2oou"}]],MonitorStop=createLucideIcon("monitor-stop",__iconNode$a6);const __iconNode$a5=[["path",{d:"m9 10 3-3 3 3",key:"11gsxs"}],["path",{d:"M12 13V7",key:"h0r20n"}],["rect",{width:"20",height:"14",x:"2",y:"3",rx:"2",key:"48i651"}],["path",{d:"M12 17v4",key:"1riwvh"}],["path",{d:"M8 21h8",key:"1ev6f3"}]],MonitorUp=createLucideIcon("monitor-up",__iconNode$a5);const __iconNode$a4=[["path",{d:"m14.5 12.5-5-5",key:"1jahn5"}],["path",{d:"m9.5 12.5 5-5",key:"1k2t7b"}],["rect",{width:"20",height:"14",x:"2",y:"3",rx:"2",key:"48i651"}],["path",{d:"M12 17v4",key:"1riwvh"}],["path",{d:"M8 21h8",key:"1ev6f3"}]],MonitorX=createLucideIcon("monitor-x",__iconNode$a4);const __iconNode$a3=[["rect",{width:"20",height:"14",x:"2",y:"3",rx:"2",key:"48i651"}],["line",{x1:"8",x2:"16",y1:"21",y2:"21",key:"1svkeh"}],["line",{x1:"12",x2:"12",y1:"17",y2:"21",key:"vw1qmm"}]],Monitor=createLucideIcon("monitor",__iconNode$a3);const __iconNode$a2=[["path",{d:"M18 5h4",key:"1lhgn2"}],["path",{d:"M20 3v4",key:"1olli1"}],["path",{d:"M20.985 12.486a9 9 0 1 1-9.473-9.472c.405-.022.617.46.402.803a6 6 0 0 0 8.268 8.268c.344-.215.825-.004.803.401",key:"kfwtm"}]],MoonStar=createLucideIcon("moon-star",__iconNode$a2);const __iconNode$a1=[["path",{d:"M20.985 12.486a9 9 0 1 1-9.473-9.472c.405-.022.617.46.402.803a6 6 0 0 0 8.268 8.268c.344-.215.825-.004.803.401",key:"kfwtm"}]],Moon=createLucideIcon("moon",__iconNode$a1);const __iconNode$a0=[["path",{d:"m18 14-1-3",key:"bdajw9"}],["path",{d:"m3 9 6 2a2 2 0 0 1 2-2h2a2 2 0 0 1 1.99 1.81",key:"f5fotj"}],["path",{d:"M8 17h3a1 1 0 0 0 1-1 6 6 0 0 1 6-6 1 1 0 0 0 1-1v-.75A5 5 0 0 0 17 5",key:"3i90e2"}],["circle",{cx:"19",cy:"17",r:"3",key:"1otbdv"}],["circle",{cx:"5",cy:"17",r:"3",key:"1d8p0c"}]],Motorbike=createLucideIcon("motorbike",__iconNode$a0);const __iconNode$9$=[["path",{d:"m8 3 4 8 5-5 5 15H2L8 3z",key:"otkl63"}],["path",{d:"M4.14 15.08c2.62-1.57 5.24-1.43 7.86.42 2.74 1.94 5.49 2 8.23.19",key:"1pvmmp"}]],MountainSnow=createLucideIcon("mountain-snow",__iconNode$9$);const __iconNode$9_=[["path",{d:"m8 3 4 8 5-5 5 15H2L8 3z",key:"otkl63"}]],Mountain=createLucideIcon("mountain",__iconNode$9_);const __iconNode$9Z=[["path",{d:"M12 6v.343",key:"1gyhex"}],["path",{d:"M18.218 18.218A7 7 0 0 1 5 15V9a7 7 0 0 1 .782-3.218",key:"ukzz01"}],["path",{d:"M19 13.343V9A7 7 0 0 0 8.56 2.902",key:"104jy9"}],["path",{d:"M22 22 2 2",key:"1r8tn9"}]],MouseOff=createLucideIcon("mouse-off",__iconNode$9Z);const __iconNode$9Y=[["path",{d:"m15.55 8.45 5.138 2.087a.5.5 0 0 1-.063.947l-6.124 1.58a2 2 0 0 0-1.438 1.435l-1.579 6.126a.5.5 0 0 1-.947.063L8.45 15.551",key:"1qoshx"}],["path",{d:"M22 2 2 22",key:"y4kqgn"}],["path",{d:"m6.816 11.528-2.779-6.84a.495.495 0 0 1 .651-.651l6.84 2.779",key:"mymuvk"}]],MousePointer2Off=createLucideIcon("mouse-pointer-2-off",__iconNode$9Y);const __iconNode$9X=[["path",{d:"M4.037 4.688a.495.495 0 0 1 .651-.651l16 6.5a.5.5 0 0 1-.063.947l-6.124 1.58a2 2 0 0 0-1.438 1.435l-1.579 6.126a.5.5 0 0 1-.947.063z",key:"edeuup"}]],MousePointer2=createLucideIcon("mouse-pointer-2",__iconNode$9X);const __iconNode$9W=[["path",{d:"M2.034 2.681a.498.498 0 0 1 .647-.647l9 3.5a.5.5 0 0 1-.033.944L8.204 7.545a1 1 0 0 0-.66.66l-1.066 3.443a.5.5 0 0 1-.944.033z",key:"11pp1i"}],["circle",{cx:"16",cy:"16",r:"6",key:"qoo3c4"}],["path",{d:"m11.8 11.8 8.4 8.4",key:"oogvdj"}]],MousePointerBan=createLucideIcon("mouse-pointer-ban",__iconNode$9W);const __iconNode$9V=[["path",{d:"M14 4.1 12 6",key:"ita8i4"}],["path",{d:"m5.1 8-2.9-.8",key:"1go3kf"}],["path",{d:"m6 12-1.9 2",key:"mnht97"}],["path",{d:"M7.2 2.2 8 5.1",key:"1cfko1"}],["path",{d:"M9.037 9.69a.498.498 0 0 1 .653-.653l11 4.5a.5.5 0 0 1-.074.949l-4.349 1.041a1 1 0 0 0-.74.739l-1.04 4.35a.5.5 0 0 1-.95.074z",key:"s0h3yz"}]],MousePointerClick=createLucideIcon("mouse-pointer-click",__iconNode$9V);const __iconNode$9U=[["path",{d:"M12.586 12.586 19 19",key:"ea5xo7"}],["path",{d:"M3.688 3.037a.497.497 0 0 0-.651.651l6.5 15.999a.501.501 0 0 0 .947-.062l1.569-6.083a2 2 0 0 1 1.448-1.479l6.124-1.579a.5.5 0 0 0 .063-.947z",key:"277e5u"}]],MousePointer=createLucideIcon("mouse-pointer",__iconNode$9U);const __iconNode$9T=[["rect",{x:"5",y:"2",width:"14",height:"20",rx:"7",key:"11ol66"}],["path",{d:"M12 6v4",key:"16clxf"}]],Mouse=createLucideIcon("mouse",__iconNode$9T);const __iconNode$9S=[["path",{d:"M5 3v16h16",key:"1mqmf9"}],["path",{d:"m5 19 6-6",key:"jh6hbb"}],["path",{d:"m2 6 3-3 3 3",key:"tkyvxa"}],["path",{d:"m18 16 3 3-3 3",key:"1d4glt"}]],Move3d=createLucideIcon("move-3d",__iconNode$9S);const __iconNode$9R=[["path",{d:"M19 13v6h-6",key:"1hxl6d"}],["path",{d:"M5 11V5h6",key:"12e2xe"}],["path",{d:"m5 5 14 14",key:"11anup"}]],MoveDiagonal2=createLucideIcon("move-diagonal-2",__iconNode$9R);const __iconNode$9Q=[["path",{d:"M11 19H5v-6",key:"8awifj"}],["path",{d:"M13 5h6v6",key:"7voy1q"}],["path",{d:"M19 5 5 19",key:"wwaj1z"}]],MoveDiagonal=createLucideIcon("move-diagonal",__iconNode$9Q);const __iconNode$9P=[["path",{d:"M11 19H5V13",key:"1akmht"}],["path",{d:"M19 5L5 19",key:"72u4yj"}]],MoveDownLeft=createLucideIcon("move-down-left",__iconNode$9P);const __iconNode$9O=[["path",{d:"M19 13V19H13",key:"10vkzq"}],["path",{d:"M5 5L19 19",key:"5zm2fv"}]],MoveDownRight=createLucideIcon("move-down-right",__iconNode$9O);const __iconNode$9N=[["path",{d:"M8 18L12 22L16 18",key:"cskvfv"}],["path",{d:"M12 2V22",key:"r89rzk"}]],MoveDown=createLucideIcon("move-down",__iconNode$9N);const __iconNode$9M=[["path",{d:"m18 8 4 4-4 4",key:"1ak13k"}],["path",{d:"M2 12h20",key:"9i4pu4"}],["path",{d:"m6 8-4 4 4 4",key:"15zrgr"}]],MoveHorizontal=createLucideIcon("move-horizontal",__iconNode$9M);const __iconNode$9L=[["path",{d:"M6 8L2 12L6 16",key:"kyvwex"}],["path",{d:"M2 12H22",key:"1m8cig"}]],MoveLeft=createLucideIcon("move-left",__iconNode$9L);const __iconNode$9K=[["path",{d:"M18 8L22 12L18 16",key:"1r0oui"}],["path",{d:"M2 12H22",key:"1m8cig"}]],MoveRight=createLucideIcon("move-right",__iconNode$9K);const __iconNode$9J=[["path",{d:"M5 11V5H11",key:"3q78g9"}],["path",{d:"M5 5L19 19",key:"5zm2fv"}]],MoveUpLeft=createLucideIcon("move-up-left",__iconNode$9J);const __iconNode$9I=[["path",{d:"M13 5H19V11",key:"1n1gyv"}],["path",{d:"M19 5L5 19",key:"72u4yj"}]],MoveUpRight=createLucideIcon("move-up-right",__iconNode$9I);const __iconNode$9H=[["path",{d:"M12 2v20",key:"t6zp3m"}],["path",{d:"m8 18 4 4 4-4",key:"bh5tu3"}],["path",{d:"m8 6 4-4 4 4",key:"ybng9g"}]],MoveVertical=createLucideIcon("move-vertical",__iconNode$9H);const __iconNode$9G=[["path",{d:"M8 6L12 2L16 6",key:"1yvkyx"}],["path",{d:"M12 2V22",key:"r89rzk"}]],MoveUp=createLucideIcon("move-up",__iconNode$9G);const __iconNode$9F=[["path",{d:"M12 2v20",key:"t6zp3m"}],["path",{d:"m15 19-3 3-3-3",key:"11eu04"}],["path",{d:"m19 9 3 3-3 3",key:"1mg7y2"}],["path",{d:"M2 12h20",key:"9i4pu4"}],["path",{d:"m5 9-3 3 3 3",key:"j64kie"}],["path",{d:"m9 5 3-3 3 3",key:"l8vdw6"}]],Move=createLucideIcon("move",__iconNode$9F);const __iconNode$9E=[["circle",{cx:"8",cy:"18",r:"4",key:"1fc0mg"}],["path",{d:"M12 18V2l7 4",key:"g04rme"}]],Music2=createLucideIcon("music-2",__iconNode$9E);const __iconNode$9D=[["circle",{cx:"12",cy:"18",r:"4",key:"m3r9ws"}],["path",{d:"M16 18V2",key:"40x2m5"}]],Music3=createLucideIcon("music-3",__iconNode$9D);const __iconNode$9C=[["path",{d:"M9 18V5l12-2v13",key:"1jmyc2"}],["path",{d:"m9 9 12-2",key:"1e64n2"}],["circle",{cx:"6",cy:"18",r:"3",key:"fqmcym"}],["circle",{cx:"18",cy:"16",r:"3",key:"1hluhg"}]],Music4=createLucideIcon("music-4",__iconNode$9C);const __iconNode$9B=[["path",{d:"M9 18V5l12-2v13",key:"1jmyc2"}],["circle",{cx:"6",cy:"18",r:"3",key:"fqmcym"}],["circle",{cx:"18",cy:"16",r:"3",key:"1hluhg"}]],Music=createLucideIcon("music",__iconNode$9B);const __iconNode$9A=[["path",{d:"M9.31 9.31 5 21l7-4 7 4-1.17-3.17",key:"qoq2o2"}],["path",{d:"M14.53 8.88 12 2l-1.17 3.17",key:"k3sjzy"}],["line",{x1:"2",x2:"22",y1:"2",y2:"22",key:"a6p6uj"}]],Navigation2Off=createLucideIcon("navigation-2-off",__iconNode$9A);const __iconNode$9z=[["polygon",{points:"12 2 19 21 12 17 5 21 12 2",key:"x8c0qg"}]],Navigation2=createLucideIcon("navigation-2",__iconNode$9z);const __iconNode$9y=[["polygon",{points:"3 11 22 2 13 21 11 13 3 11",key:"1ltx0t"}]],Navigation=createLucideIcon("navigation",__iconNode$9y);const __iconNode$9x=[["path",{d:"M8.43 8.43 3 11l8 2 2 8 2.57-5.43",key:"1vdtb7"}],["path",{d:"M17.39 11.73 22 2l-9.73 4.61",key:"tya3r6"}],["line",{x1:"2",x2:"22",y1:"2",y2:"22",key:"a6p6uj"}]],NavigationOff=createLucideIcon("navigation-off",__iconNode$9x);const __iconNode$9w=[["rect",{x:"16",y:"16",width:"6",height:"6",rx:"1",key:"4q2zg0"}],["rect",{x:"2",y:"16",width:"6",height:"6",rx:"1",key:"8cvhb9"}],["rect",{x:"9",y:"2",width:"6",height:"6",rx:"1",key:"1egb70"}],["path",{d:"M5 16v-3a1 1 0 0 1 1-1h12a1 1 0 0 1 1 1v3",key:"1jsf9p"}],["path",{d:"M12 12V8",key:"2874zd"}]],Network=createLucideIcon("network",__iconNode$9w);const __iconNode$9v=[["path",{d:"M15 18h-5",key:"95g1m2"}],["path",{d:"M18 14h-8",key:"sponae"}],["path",{d:"M4 22h16a2 2 0 0 0 2-2V4a2 2 0 0 0-2-2H8a2 2 0 0 0-2 2v16a2 2 0 0 1-4 0v-9a2 2 0 0 1 2-2h2",key:"39pd36"}],["rect",{width:"8",height:"4",x:"10",y:"6",rx:"1",key:"aywv1n"}]],Newspaper=createLucideIcon("newspaper",__iconNode$9v);const __iconNode$9u=[["path",{d:"M6 8.32a7.43 7.43 0 0 1 0 7.36",key:"9iaqei"}],["path",{d:"M9.46 6.21a11.76 11.76 0 0 1 0 11.58",key:"1yha7l"}],["path",{d:"M12.91 4.1a15.91 15.91 0 0 1 .01 15.8",key:"4iu2gk"}],["path",{d:"M16.37 2a20.16 20.16 0 0 1 0 20",key:"sap9u2"}]],Nfc=createLucideIcon("nfc",__iconNode$9u);const __iconNode$9t=[["path",{d:"M13.4 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-7.4",key:"re6nr2"}],["path",{d:"M2 6h4",key:"aawbzj"}],["path",{d:"M2 10h4",key:"l0bgd4"}],["path",{d:"M2 14h4",key:"1gsvsf"}],["path",{d:"M2 18h4",key:"1bu2t1"}],["path",{d:"M21.378 5.626a1 1 0 1 0-3.004-3.004l-5.01 5.012a2 2 0 0 0-.506.854l-.837 2.87a.5.5 0 0 0 .62.62l2.87-.837a2 2 0 0 0 .854-.506z",key:"pqwjuv"}]],NotebookPen=createLucideIcon("notebook-pen",__iconNode$9t);const __iconNode$9s=[["path",{d:"M12 2v10",key:"mnfbl"}],["path",{d:"m8.5 4 7 4",key:"m1xjk3"}],["path",{d:"m8.5 8 7-4",key:"t0m5j6"}],["circle",{cx:"12",cy:"17",r:"5",key:"qbz8iq"}]],NonBinary=createLucideIcon("non-binary",__iconNode$9s);const __iconNode$9r=[["path",{d:"M2 6h4",key:"aawbzj"}],["path",{d:"M2 10h4",key:"l0bgd4"}],["path",{d:"M2 14h4",key:"1gsvsf"}],["path",{d:"M2 18h4",key:"1bu2t1"}],["rect",{width:"16",height:"20",x:"4",y:"2",rx:"2",key:"1nb95v"}],["path",{d:"M15 2v20",key:"dcj49h"}],["path",{d:"M15 7h5",key:"1xj5lc"}],["path",{d:"M15 12h5",key:"w5shd9"}],["path",{d:"M15 17h5",key:"1qaofu"}]],NotebookTabs=createLucideIcon("notebook-tabs",__iconNode$9r);const __iconNode$9q=[["path",{d:"M2 6h4",key:"aawbzj"}],["path",{d:"M2 10h4",key:"l0bgd4"}],["path",{d:"M2 14h4",key:"1gsvsf"}],["path",{d:"M2 18h4",key:"1bu2t1"}],["rect",{width:"16",height:"20",x:"4",y:"2",rx:"2",key:"1nb95v"}],["path",{d:"M16 2v20",key:"rotuqe"}]],Notebook=createLucideIcon("notebook",__iconNode$9q);const __iconNode$9p=[["path",{d:"M2 6h4",key:"aawbzj"}],["path",{d:"M2 10h4",key:"l0bgd4"}],["path",{d:"M2 14h4",key:"1gsvsf"}],["path",{d:"M2 18h4",key:"1bu2t1"}],["rect",{width:"16",height:"20",x:"4",y:"2",rx:"2",key:"1nb95v"}],["path",{d:"M9.5 8h5",key:"11mslq"}],["path",{d:"M9.5 12H16",key:"ktog6x"}],["path",{d:"M9.5 16H14",key:"p1seyn"}]],NotebookText=createLucideIcon("notebook-text",__iconNode$9p);const __iconNode$9o=[["path",{d:"M8 2v4",key:"1cmpym"}],["path",{d:"M12 2v4",key:"3427ic"}],["path",{d:"M16 2v4",key:"4m81vk"}],["path",{d:"M16 4h2a2 2 0 0 1 2 2v2",key:"j91f56"}],["path",{d:"M20 12v2",key:"w8o0tu"}],["path",{d:"M20 18v2a2 2 0 0 1-2 2h-1",key:"1c9ggx"}],["path",{d:"M13 22h-2",key:"191ugt"}],["path",{d:"M7 22H6a2 2 0 0 1-2-2v-2",key:"1rt9px"}],["path",{d:"M4 14v-2",key:"1v0sqh"}],["path",{d:"M4 8V6a2 2 0 0 1 2-2h2",key:"1mwabg"}],["path",{d:"M8 10h6",key:"3oa6kw"}],["path",{d:"M8 14h8",key:"1fgep2"}],["path",{d:"M8 18h5",key:"17enja"}]],NotepadTextDashed=createLucideIcon("notepad-text-dashed",__iconNode$9o);const __iconNode$9n=[["path",{d:"M8 2v4",key:"1cmpym"}],["path",{d:"M12 2v4",key:"3427ic"}],["path",{d:"M16 2v4",key:"4m81vk"}],["rect",{width:"16",height:"18",x:"4",y:"4",rx:"2",key:"1u9h20"}],["path",{d:"M8 10h6",key:"3oa6kw"}],["path",{d:"M8 14h8",key:"1fgep2"}],["path",{d:"M8 18h5",key:"17enja"}]],NotepadText=createLucideIcon("notepad-text",__iconNode$9n);const __iconNode$9m=[["path",{d:"M12 4V2",key:"1k5q1u"}],["path",{d:"M5 10v4a7.004 7.004 0 0 0 5.277 6.787c.412.104.802.292 1.102.592L12 22l.621-.621c.3-.3.69-.488 1.102-.592a7.01 7.01 0 0 0 4.125-2.939",key:"1xcvy9"}],["path",{d:"M19 10v3.343",key:"163tfc"}],["path",{d:"M12 12c-1.349-.573-1.905-1.005-2.5-2-.546.902-1.048 1.353-2.5 2-1.018-.644-1.46-1.08-2-2-1.028.71-1.69.918-3 1 1.081-1.048 1.757-2.03 2-3 .194-.776.84-1.551 1.79-2.21m11.654 5.997c.887-.457 1.28-.891 1.556-1.787 1.032.916 1.683 1.157 3 1-1.297-1.036-1.758-2.03-2-3-.5-2-4-4-8-4-.74 0-1.461.068-2.15.192",key:"17914v"}],["line",{x1:"2",x2:"22",y1:"2",y2:"22",key:"a6p6uj"}]],NutOff=createLucideIcon("nut-off",__iconNode$9m);const __iconNode$9l=[["path",{d:"M12 4V2",key:"1k5q1u"}],["path",{d:"M5 10v4a7.004 7.004 0 0 0 5.277 6.787c.412.104.802.292 1.102.592L12 22l.621-.621c.3-.3.69-.488 1.102-.592A7.003 7.003 0 0 0 19 14v-4",key:"1tgyif"}],["path",{d:"M12 4C8 4 4.5 6 4 8c-.243.97-.919 1.952-2 3 1.31-.082 1.972-.29 3-1 .54.92.982 1.356 2 2 1.452-.647 1.954-1.098 2.5-2 .595.995 1.151 1.427 2.5 2 1.31-.621 1.862-1.058 2.5-2 .629.977 1.162 1.423 2.5 2 1.209-.548 1.68-.967 2-2 1.032.916 1.683 1.157 3 1-1.297-1.036-1.758-2.03-2-3-.5-2-4-4-8-4Z",key:"tnsqj"}]],Nut=createLucideIcon("nut",__iconNode$9l);const __iconNode$9k=[["path",{d:"M12 16h.01",key:"1drbdi"}],["path",{d:"M12 8v4",key:"1got3b"}],["path",{d:"M15.312 2a2 2 0 0 1 1.414.586l4.688 4.688A2 2 0 0 1 22 8.688v6.624a2 2 0 0 1-.586 1.414l-4.688 4.688a2 2 0 0 1-1.414.586H8.688a2 2 0 0 1-1.414-.586l-4.688-4.688A2 2 0 0 1 2 15.312V8.688a2 2 0 0 1 .586-1.414l4.688-4.688A2 2 0 0 1 8.688 2z",key:"1fd625"}]],OctagonAlert=createLucideIcon("octagon-alert",__iconNode$9k);const __iconNode$9j=[["path",{d:"M2.586 16.726A2 2 0 0 1 2 15.312V8.688a2 2 0 0 1 .586-1.414l4.688-4.688A2 2 0 0 1 8.688 2h6.624a2 2 0 0 1 1.414.586l4.688 4.688A2 2 0 0 1 22 8.688v6.624a2 2 0 0 1-.586 1.414l-4.688 4.688a2 2 0 0 1-1.414.586H8.688a2 2 0 0 1-1.414-.586z",key:"2d38gg"}],["path",{d:"M8 12h8",key:"1wcyev"}]],OctagonMinus=createLucideIcon("octagon-minus",__iconNode$9j);const __iconNode$9i=[["path",{d:"M10 15V9",key:"1lckn7"}],["path",{d:"M14 15V9",key:"1muqhk"}],["path",{d:"M2.586 16.726A2 2 0 0 1 2 15.312V8.688a2 2 0 0 1 .586-1.414l4.688-4.688A2 2 0 0 1 8.688 2h6.624a2 2 0 0 1 1.414.586l4.688 4.688A2 2 0 0 1 22 8.688v6.624a2 2 0 0 1-.586 1.414l-4.688 4.688a2 2 0 0 1-1.414.586H8.688a2 2 0 0 1-1.414-.586z",key:"2d38gg"}]],OctagonPause=createLucideIcon("octagon-pause",__iconNode$9i);const __iconNode$9h=[["path",{d:"M2.586 16.726A2 2 0 0 1 2 15.312V8.688a2 2 0 0 1 .586-1.414l4.688-4.688A2 2 0 0 1 8.688 2h6.624a2 2 0 0 1 1.414.586l4.688 4.688A2 2 0 0 1 22 8.688v6.624a2 2 0 0 1-.586 1.414l-4.688 4.688a2 2 0 0 1-1.414.586H8.688a2 2 0 0 1-1.414-.586z",key:"2d38gg"}]],Octagon=createLucideIcon("octagon",__iconNode$9h);const __iconNode$9g=[["path",{d:"m15 9-6 6",key:"1uzhvr"}],["path",{d:"M2.586 16.726A2 2 0 0 1 2 15.312V8.688a2 2 0 0 1 .586-1.414l4.688-4.688A2 2 0 0 1 8.688 2h6.624a2 2 0 0 1 1.414.586l4.688 4.688A2 2 0 0 1 22 8.688v6.624a2 2 0 0 1-.586 1.414l-4.688 4.688a2 2 0 0 1-1.414.586H8.688a2 2 0 0 1-1.414-.586z",key:"2d38gg"}],["path",{d:"m9 9 6 6",key:"z0biqf"}]],OctagonX=createLucideIcon("octagon-x",__iconNode$9g);const __iconNode$9f=[["path",{d:"M3 20h4.5a.5.5 0 0 0 .5-.5v-.282a.52.52 0 0 0-.247-.437 8 8 0 1 1 8.494-.001.52.52 0 0 0-.247.438v.282a.5.5 0 0 0 .5.5H21",key:"1x94xo"}]],Omega=createLucideIcon("omega",__iconNode$9f);const __iconNode$9e=[["path",{d:"M3 3h6l6 18h6",key:"ph9rgk"}],["path",{d:"M14 3h7",key:"16f0ms"}]],Option=createLucideIcon("option",__iconNode$9e);const __iconNode$9d=[["path",{d:"M12 12V4a1 1 0 0 1 1-1h6.297a1 1 0 0 1 .651 1.759l-4.696 4.025",key:"1bx4vc"}],["path",{d:"m12 21-7.414-7.414A2 2 0 0 1 4 12.172V6.415a1.002 1.002 0 0 1 1.707-.707L20 20.009",key:"1h3km6"}],["path",{d:"m12.214 3.381 8.414 14.966a1 1 0 0 1-.167 1.199l-1.168 1.163a1 1 0 0 1-.706.291H6.351a1 1 0 0 1-.625-.219L3.25 18.8a1 1 0 0 1 .631-1.781l4.165.027",key:"1hj4wg"}]],Origami=createLucideIcon("origami",__iconNode$9d);const __iconNode$9c=[["path",{d:"M12 3v6",key:"1holv5"}],["path",{d:"M16.76 3a2 2 0 0 1 1.8 1.1l2.23 4.479a2 2 0 0 1 .21.891V19a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V9.472a2 2 0 0 1 .211-.894L5.45 4.1A2 2 0 0 1 7.24 3z",key:"187q7i"}],["path",{d:"M3.054 9.013h17.893",key:"grwhos"}]],Package2=createLucideIcon("package-2",__iconNode$9c);const __iconNode$9b=[["path",{d:"M20.341 6.484A10 10 0 0 1 10.266 21.85",key:"1enhxb"}],["path",{d:"M3.659 17.516A10 10 0 0 1 13.74 2.152",key:"1crzgf"}],["circle",{cx:"12",cy:"12",r:"3",key:"1v7zrd"}],["circle",{cx:"19",cy:"5",r:"2",key:"mhkx31"}],["circle",{cx:"5",cy:"19",r:"2",key:"v8kfzx"}]],Orbit=createLucideIcon("orbit",__iconNode$9b);const __iconNode$9a=[["path",{d:"m16 16 2 2 4-4",key:"gfu2re"}],["path",{d:"M21 10V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l2-1.14",key:"e7tb2h"}],["path",{d:"m7.5 4.27 9 5.15",key:"1c824w"}],["polyline",{points:"3.29 7 12 12 20.71 7",key:"ousv84"}],["line",{x1:"12",x2:"12",y1:"22",y2:"12",key:"a4e8g8"}]],PackageCheck=createLucideIcon("package-check",__iconNode$9a);const __iconNode$99=[["path",{d:"M16 16h6",key:"100bgy"}],["path",{d:"M21 10V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l2-1.14",key:"e7tb2h"}],["path",{d:"m7.5 4.27 9 5.15",key:"1c824w"}],["polyline",{points:"3.29 7 12 12 20.71 7",key:"ousv84"}],["line",{x1:"12",x2:"12",y1:"22",y2:"12",key:"a4e8g8"}]],PackageMinus=createLucideIcon("package-minus",__iconNode$99);const __iconNode$98=[["path",{d:"M12 22v-9",key:"x3hkom"}],["path",{d:"M15.17 2.21a1.67 1.67 0 0 1 1.63 0L21 4.57a1.93 1.93 0 0 1 0 3.36L8.82 14.79a1.655 1.655 0 0 1-1.64 0L3 12.43a1.93 1.93 0 0 1 0-3.36z",key:"2ntwy6"}],["path",{d:"M20 13v3.87a2.06 2.06 0 0 1-1.11 1.83l-6 3.08a1.93 1.93 0 0 1-1.78 0l-6-3.08A2.06 2.06 0 0 1 4 16.87V13",key:"1pmm1c"}],["path",{d:"M21 12.43a1.93 1.93 0 0 0 0-3.36L8.83 2.2a1.64 1.64 0 0 0-1.63 0L3 4.57a1.93 1.93 0 0 0 0 3.36l12.18 6.86a1.636 1.636 0 0 0 1.63 0z",key:"12ttoo"}]],PackageOpen=createLucideIcon("package-open",__iconNode$98);const __iconNode$97=[["path",{d:"M21 10V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l2-1.14",key:"e7tb2h"}],["path",{d:"m7.5 4.27 9 5.15",key:"1c824w"}],["polyline",{points:"3.29 7 12 12 20.71 7",key:"ousv84"}],["line",{x1:"12",x2:"12",y1:"22",y2:"12",key:"a4e8g8"}],["path",{d:"m17 13 5 5m-5 0 5-5",key:"im3w4b"}]],PackageX=createLucideIcon("package-x",__iconNode$97);const __iconNode$96=[["path",{d:"M21 10V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l2-1.14",key:"e7tb2h"}],["path",{d:"m7.5 4.27 9 5.15",key:"1c824w"}],["polyline",{points:"3.29 7 12 12 20.71 7",key:"ousv84"}],["line",{x1:"12",x2:"12",y1:"22",y2:"12",key:"a4e8g8"}],["circle",{cx:"18.5",cy:"15.5",r:"2.5",key:"b5zd12"}],["path",{d:"M20.27 17.27 22 19",key:"1l4muz"}]],PackageSearch=createLucideIcon("package-search",__iconNode$96);const __iconNode$95=[["path",{d:"M16 16h6",key:"100bgy"}],["path",{d:"M19 13v6",key:"85cyf1"}],["path",{d:"M21 10V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l2-1.14",key:"e7tb2h"}],["path",{d:"m7.5 4.27 9 5.15",key:"1c824w"}],["polyline",{points:"3.29 7 12 12 20.71 7",key:"ousv84"}],["line",{x1:"12",x2:"12",y1:"22",y2:"12",key:"a4e8g8"}]],PackagePlus=createLucideIcon("package-plus",__iconNode$95);const __iconNode$94=[["path",{d:"M11 21.73a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73z",key:"1a0edw"}],["path",{d:"M12 22V12",key:"d0xqtd"}],["polyline",{points:"3.29 7 12 12 20.71 7",key:"ousv84"}],["path",{d:"m7.5 4.27 9 5.15",key:"1c824w"}]],Package=createLucideIcon("package",__iconNode$94);const __iconNode$93=[["path",{d:"m19 11-8-8-8.6 8.6a2 2 0 0 0 0 2.8l5.2 5.2c.8.8 2 .8 2.8 0L19 11Z",key:"irua1i"}],["path",{d:"m5 2 5 5",key:"1lls2c"}],["path",{d:"M2 13h15",key:"1hkzvu"}],["path",{d:"M22 20a2 2 0 1 1-4 0c0-1.6 1.7-2.4 2-4 .3 1.6 2 2.4 2 4Z",key:"xk76lq"}]],PaintBucket=createLucideIcon("paint-bucket",__iconNode$93);const __iconNode$92=[["rect",{width:"16",height:"6",x:"2",y:"2",rx:"2",key:"jcyz7m"}],["path",{d:"M10 16v-2a2 2 0 0 1 2-2h8a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2h-2",key:"1b9h7c"}],["rect",{width:"4",height:"6",x:"8",y:"16",rx:"1",key:"d6e7yl"}]],PaintRoller=createLucideIcon("paint-roller",__iconNode$92);const __iconNode$91=[["path",{d:"M10 2v2",key:"7u0qdc"}],["path",{d:"M14 2v4",key:"qmzblu"}],["path",{d:"M17 2a1 1 0 0 1 1 1v9H6V3a1 1 0 0 1 1-1z",key:"ycvu00"}],["path",{d:"M6 12a1 1 0 0 0-1 1v1a2 2 0 0 0 2 2h2a1 1 0 0 1 1 1v2.9a2 2 0 1 0 4 0V17a1 1 0 0 1 1-1h2a2 2 0 0 0 2-2v-1a1 1 0 0 0-1-1",key:"iw4wnp"}]],PaintbrushVertical=createLucideIcon("paintbrush-vertical",__iconNode$91);const __iconNode$90=[["path",{d:"m14.622 17.897-10.68-2.913",key:"vj2p1u"}],["path",{d:"M18.376 2.622a1 1 0 1 1 3.002 3.002L17.36 9.643a.5.5 0 0 0 0 .707l.944.944a2.41 2.41 0 0 1 0 3.408l-.944.944a.5.5 0 0 1-.707 0L8.354 7.348a.5.5 0 0 1 0-.707l.944-.944a2.41 2.41 0 0 1 3.408 0l.944.944a.5.5 0 0 0 .707 0z",key:"18tc5c"}],["path",{d:"M9 8c-1.804 2.71-3.97 3.46-6.583 3.948a.507.507 0 0 0-.302.819l7.32 8.883a1 1 0 0 0 1.185.204C12.735 20.405 16 16.792 16 15",key:"ytzfxy"}]],Paintbrush=createLucideIcon("paintbrush",__iconNode$90);const __iconNode$8$=[["path",{d:"M12 22a1 1 0 0 1 0-20 10 9 0 0 1 10 9 5 5 0 0 1-5 5h-2.25a1.75 1.75 0 0 0-1.4 2.8l.3.4a1.75 1.75 0 0 1-1.4 2.8z",key:"e79jfc"}],["circle",{cx:"13.5",cy:"6.5",r:".5",fill:"currentColor",key:"1okk4w"}],["circle",{cx:"17.5",cy:"10.5",r:".5",fill:"currentColor",key:"f64h9f"}],["circle",{cx:"6.5",cy:"12.5",r:".5",fill:"currentColor",key:"qy21gx"}],["circle",{cx:"8.5",cy:"7.5",r:".5",fill:"currentColor",key:"fotxhn"}]],Palette=createLucideIcon("palette",__iconNode$8$);const __iconNode$8_=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M3 15h18",key:"5xshup"}],["path",{d:"m15 8-3 3-3-3",key:"1oxy1z"}]],PanelBottomClose=createLucideIcon("panel-bottom-close",__iconNode$8_);const __iconNode$8Z=[["path",{d:"M11.25 17.25h1.5L12 18z",key:"1wmwwj"}],["path",{d:"m15 12 2 2",key:"k60wz4"}],["path",{d:"M18 6.5a.5.5 0 0 0-.5-.5",key:"1ch4h4"}],["path",{d:"M20.69 9.67a4.5 4.5 0 1 0-7.04-5.5 8.35 8.35 0 0 0-3.3 0 4.5 4.5 0 1 0-7.04 5.5C2.49 11.2 2 12.88 2 14.5 2 19.47 6.48 22 12 22s10-2.53 10-7.5c0-1.62-.48-3.3-1.3-4.83",key:"1c660l"}],["path",{d:"M6 6.5a.495.495 0 0 1 .5-.5",key:"eviuep"}],["path",{d:"m9 12-2 2",key:"326nkw"}]],Panda=createLucideIcon("panda",__iconNode$8Z);const __iconNode$8Y=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M14 15h1",key:"171nev"}],["path",{d:"M19 15h2",key:"1vnucp"}],["path",{d:"M3 15h2",key:"8bym0q"}],["path",{d:"M9 15h1",key:"1tg3ks"}]],PanelBottomDashed=createLucideIcon("panel-bottom-dashed",__iconNode$8Y);const __iconNode$8X=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M3 15h18",key:"5xshup"}],["path",{d:"m9 10 3-3 3 3",key:"11gsxs"}]],PanelBottomOpen=createLucideIcon("panel-bottom-open",__iconNode$8X);const __iconNode$8W=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M3 15h18",key:"5xshup"}]],PanelBottom=createLucideIcon("panel-bottom",__iconNode$8W);const __iconNode$8V=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M9 14v1",key:"askpd8"}],["path",{d:"M9 19v2",key:"16tejx"}],["path",{d:"M9 3v2",key:"1noubl"}],["path",{d:"M9 9v1",key:"19ebxg"}]],PanelLeftDashed=createLucideIcon("panel-left-dashed",__iconNode$8V);const __iconNode$8U=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M9 3v18",key:"fh3hqa"}],["path",{d:"m16 15-3-3 3-3",key:"14y99z"}]],PanelLeftClose=createLucideIcon("panel-left-close",__iconNode$8U);const __iconNode$8T=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M9 3v18",key:"fh3hqa"}],["path",{d:"m14 9 3 3-3 3",key:"8010ee"}]],PanelLeftOpen=createLucideIcon("panel-left-open",__iconNode$8T);const __iconNode$8S=[["path",{d:"M15 10V9",key:"4dkmfx"}],["path",{d:"M15 15v-1",key:"6a4afx"}],["path",{d:"M15 21v-2",key:"1qshmc"}],["path",{d:"M15 5V3",key:"1fk0mb"}],["path",{d:"M9 10V9",key:"1lazqi"}],["path",{d:"M9 15v-1",key:"9lx740"}],["path",{d:"M9 21v-2",key:"1fwk0n"}],["path",{d:"M9 5V3",key:"2q8zi6"}],["rect",{x:"3",y:"3",width:"18",height:"18",rx:"2",key:"h1oib"}]],PanelLeftRightDashed=createLucideIcon("panel-left-right-dashed",__iconNode$8S);const __iconNode$8R=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M15 3v18",key:"14nvp0"}],["path",{d:"m8 9 3 3-3 3",key:"12hl5m"}]],PanelRightClose=createLucideIcon("panel-right-close",__iconNode$8R);const __iconNode$8Q=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M9 3v18",key:"fh3hqa"}]],PanelLeft=createLucideIcon("panel-left",__iconNode$8Q);const __iconNode$8P=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M15 14v1",key:"ilsfch"}],["path",{d:"M15 19v2",key:"1fst2f"}],["path",{d:"M15 3v2",key:"z204g4"}],["path",{d:"M15 9v1",key:"z2a8b1"}]],PanelRightDashed=createLucideIcon("panel-right-dashed",__iconNode$8P);const __iconNode$8O=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M15 3v18",key:"14nvp0"}],["path",{d:"m10 15-3-3 3-3",key:"1pgupc"}]],PanelRightOpen=createLucideIcon("panel-right-open",__iconNode$8O);const __iconNode$8N=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M15 3v18",key:"14nvp0"}]],PanelRight=createLucideIcon("panel-right",__iconNode$8N);const __iconNode$8M=[["path",{d:"M14 15h1",key:"171nev"}],["path",{d:"M14 9h1",key:"l0svgy"}],["path",{d:"M19 15h2",key:"1vnucp"}],["path",{d:"M19 9h2",key:"te2zfg"}],["path",{d:"M3 15h2",key:"8bym0q"}],["path",{d:"M3 9h2",key:"1h4ldw"}],["path",{d:"M9 15h1",key:"1tg3ks"}],["path",{d:"M9 9h1",key:"15jzuz"}],["rect",{x:"3",y:"3",width:"18",height:"18",rx:"2",key:"h1oib"}]],PanelTopBottomDashed=createLucideIcon("panel-top-bottom-dashed",__iconNode$8M);const __iconNode$8L=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M3 9h18",key:"1pudct"}],["path",{d:"m9 16 3-3 3 3",key:"1idcnm"}]],PanelTopClose=createLucideIcon("panel-top-close",__iconNode$8L);const __iconNode$8K=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M14 9h1",key:"l0svgy"}],["path",{d:"M19 9h2",key:"te2zfg"}],["path",{d:"M3 9h2",key:"1h4ldw"}],["path",{d:"M9 9h1",key:"15jzuz"}]],PanelTopDashed=createLucideIcon("panel-top-dashed",__iconNode$8K);const __iconNode$8J=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M3 9h18",key:"1pudct"}],["path",{d:"m15 14-3 3-3-3",key:"g215vf"}]],PanelTopOpen=createLucideIcon("panel-top-open",__iconNode$8J);const __iconNode$8I=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M3 9h18",key:"1pudct"}]],PanelTop=createLucideIcon("panel-top",__iconNode$8I);const __iconNode$8H=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M9 3v18",key:"fh3hqa"}],["path",{d:"M9 15h12",key:"5ijen5"}]],PanelsLeftBottom=createLucideIcon("panels-left-bottom",__iconNode$8H);const __iconNode$8G=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M3 9h18",key:"1pudct"}],["path",{d:"M9 21V9",key:"1oto5p"}]],PanelsTopLeft=createLucideIcon("panels-top-left",__iconNode$8G);const __iconNode$8F=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M3 15h12",key:"1wkqb3"}],["path",{d:"M15 3v18",key:"14nvp0"}]],PanelsRightBottom=createLucideIcon("panels-right-bottom",__iconNode$8F);const __iconNode$8E=[["path",{d:"m16 6-8.414 8.586a2 2 0 0 0 2.829 2.829l8.414-8.586a4 4 0 1 0-5.657-5.657l-8.379 8.551a6 6 0 1 0 8.485 8.485l8.379-8.551",key:"1miecu"}]],Paperclip=createLucideIcon("paperclip",__iconNode$8E);const __iconNode$8D=[["path",{d:"M8 21s-4-3-4-9 4-9 4-9",key:"uto9ud"}],["path",{d:"M16 3s4 3 4 9-4 9-4 9",key:"4w2vsq"}]],Parentheses=createLucideIcon("parentheses",__iconNode$8D);const __iconNode$8C=[["path",{d:"M11 15h2",key:"199qp6"}],["path",{d:"M12 12v3",key:"158kv8"}],["path",{d:"M12 19v3",key:"npa21l"}],["path",{d:"M15.282 19a1 1 0 0 0 .948-.68l2.37-6.988a7 7 0 1 0-13.2 0l2.37 6.988a1 1 0 0 0 .948.68z",key:"1jofit"}],["path",{d:"M9 9a3 3 0 1 1 6 0",key:"jdoeu8"}]],ParkingMeter=createLucideIcon("parking-meter",__iconNode$8C);const __iconNode$8B=[["path",{d:"M5.8 11.3 2 22l10.7-3.79",key:"gwxi1d"}],["path",{d:"M4 3h.01",key:"1vcuye"}],["path",{d:"M22 8h.01",key:"1mrtc2"}],["path",{d:"M15 2h.01",key:"1cjtqr"}],["path",{d:"M22 20h.01",key:"1mrys2"}],["path",{d:"m22 2-2.24.75a2.9 2.9 0 0 0-1.96 3.12c.1.86-.57 1.63-1.45 1.63h-.38c-.86 0-1.6.6-1.76 1.44L14 10",key:"hbicv8"}],["path",{d:"m22 13-.82-.33c-.86-.34-1.82.2-1.98 1.11c-.11.7-.72 1.22-1.43 1.22H17",key:"1i94pl"}],["path",{d:"m11 2 .33.82c.34.86-.2 1.82-1.11 1.98C9.52 4.9 9 5.52 9 6.23V7",key:"1cofks"}],["path",{d:"M11 13c1.93 1.93 2.83 4.17 2 5-.83.83-3.07-.07-5-2-1.93-1.93-2.83-4.17-2-5 .83-.83 3.07.07 5 2Z",key:"4kbmks"}]],PartyPopper=createLucideIcon("party-popper",__iconNode$8B);const __iconNode$8A=[["rect",{x:"14",y:"3",width:"5",height:"18",rx:"1",key:"kaeet6"}],["rect",{x:"5",y:"3",width:"5",height:"18",rx:"1",key:"1wsw3u"}]],Pause=createLucideIcon("pause",__iconNode$8A);const __iconNode$8z=[["circle",{cx:"11",cy:"4",r:"2",key:"vol9p0"}],["circle",{cx:"18",cy:"8",r:"2",key:"17gozi"}],["circle",{cx:"20",cy:"16",r:"2",key:"1v9bxh"}],["path",{d:"M9 10a5 5 0 0 1 5 5v3.5a3.5 3.5 0 0 1-6.84 1.045Q6.52 17.48 4.46 16.84A3.5 3.5 0 0 1 5.5 10Z",key:"1ydw1z"}]],PawPrint=createLucideIcon("paw-print",__iconNode$8z);const __iconNode$8y=[["rect",{width:"14",height:"20",x:"5",y:"2",rx:"2",key:"1uq1d7"}],["path",{d:"M15 14h.01",key:"1kp3bh"}],["path",{d:"M9 6h6",key:"dgm16u"}],["path",{d:"M9 10h6",key:"9gxzsh"}]],PcCase=createLucideIcon("pc-case",__iconNode$8y);const __iconNode$8x=[["path",{d:"M13 21h8",key:"1jsn5i"}],["path",{d:"M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497z",key:"1a8usu"}]],PenLine=createLucideIcon("pen-line",__iconNode$8x);const __iconNode$8w=[["path",{d:"m10 10-6.157 6.162a2 2 0 0 0-.5.833l-1.322 4.36a.5.5 0 0 0 .622.624l4.358-1.323a2 2 0 0 0 .83-.5L14 13.982",key:"bjo8r8"}],["path",{d:"m12.829 7.172 4.359-4.346a1 1 0 1 1 3.986 3.986l-4.353 4.353",key:"16h5ne"}],["path",{d:"m2 2 20 20",key:"1ooewy"}]],PenOff=createLucideIcon("pen-off",__iconNode$8w);const __iconNode$8v=[["path",{d:"M15.707 21.293a1 1 0 0 1-1.414 0l-1.586-1.586a1 1 0 0 1 0-1.414l5.586-5.586a1 1 0 0 1 1.414 0l1.586 1.586a1 1 0 0 1 0 1.414z",key:"nt11vn"}],["path",{d:"m18 13-1.375-6.874a1 1 0 0 0-.746-.776L3.235 2.028a1 1 0 0 0-1.207 1.207L5.35 15.879a1 1 0 0 0 .776.746L13 18",key:"15qc1e"}],["path",{d:"m2.3 2.3 7.286 7.286",key:"1wuzzi"}],["circle",{cx:"11",cy:"11",r:"2",key:"xmgehs"}]],PenTool=createLucideIcon("pen-tool",__iconNode$8v);const __iconNode$8u=[["path",{d:"M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497z",key:"1a8usu"}]],Pen=createLucideIcon("pen",__iconNode$8u);const __iconNode$8t=[["path",{d:"M13 21h8",key:"1jsn5i"}],["path",{d:"m15 5 4 4",key:"1mk7zo"}],["path",{d:"M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497z",key:"1a8usu"}]],PencilLine=createLucideIcon("pencil-line",__iconNode$8t);const __iconNode$8s=[["path",{d:"m10 10-6.157 6.162a2 2 0 0 0-.5.833l-1.322 4.36a.5.5 0 0 0 .622.624l4.358-1.323a2 2 0 0 0 .83-.5L14 13.982",key:"bjo8r8"}],["path",{d:"m12.829 7.172 4.359-4.346a1 1 0 1 1 3.986 3.986l-4.353 4.353",key:"16h5ne"}],["path",{d:"m15 5 4 4",key:"1mk7zo"}],["path",{d:"m2 2 20 20",key:"1ooewy"}]],PencilOff=createLucideIcon("pencil-off",__iconNode$8s);const __iconNode$8r=[["path",{d:"M13 7 8.7 2.7a2.41 2.41 0 0 0-3.4 0L2.7 5.3a2.41 2.41 0 0 0 0 3.4L7 13",key:"orapub"}],["path",{d:"m8 6 2-2",key:"115y1s"}],["path",{d:"m18 16 2-2",key:"ee94s4"}],["path",{d:"m17 11 4.3 4.3c.94.94.94 2.46 0 3.4l-2.6 2.6c-.94.94-2.46.94-3.4 0L11 17",key:"cfq27r"}],["path",{d:"M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497z",key:"1a8usu"}],["path",{d:"m15 5 4 4",key:"1mk7zo"}]],PencilRuler=createLucideIcon("pencil-ruler",__iconNode$8r);const __iconNode$8q=[["path",{d:"M10.83 2.38a2 2 0 0 1 2.34 0l8 5.74a2 2 0 0 1 .73 2.25l-3.04 9.26a2 2 0 0 1-1.9 1.37H7.04a2 2 0 0 1-1.9-1.37L2.1 10.37a2 2 0 0 1 .73-2.25z",key:"2hea0t"}]],Pentagon=createLucideIcon("pentagon",__iconNode$8q);const __iconNode$8p=[["path",{d:"M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497z",key:"1a8usu"}],["path",{d:"m15 5 4 4",key:"1mk7zo"}]],Pencil=createLucideIcon("pencil",__iconNode$8p);const __iconNode$8o=[["line",{x1:"19",x2:"5",y1:"5",y2:"19",key:"1x9vlm"}],["circle",{cx:"6.5",cy:"6.5",r:"2.5",key:"4mh3h7"}],["circle",{cx:"17.5",cy:"17.5",r:"2.5",key:"1mdrzq"}]],Percent=createLucideIcon("percent",__iconNode$8o);const __iconNode$8n=[["circle",{cx:"12",cy:"5",r:"1",key:"gxeob9"}],["path",{d:"m9 20 3-6 3 6",key:"se2kox"}],["path",{d:"m6 8 6 2 6-2",key:"4o3us4"}],["path",{d:"M12 10v4",key:"1kjpxc"}]],PersonStanding=createLucideIcon("person-standing",__iconNode$8n);const __iconNode$8m=[["path",{d:"M20 11H4",key:"6ut86h"}],["path",{d:"M20 7H4",key:"zbl0bi"}],["path",{d:"M7 21V4a1 1 0 0 1 1-1h4a1 1 0 0 1 0 12H7",key:"1ana5r"}]],PhilippinePeso=createLucideIcon("philippine-peso",__iconNode$8m);const __iconNode$8l=[["path",{d:"M13 2a9 9 0 0 1 9 9",key:"1itnx2"}],["path",{d:"M13 6a5 5 0 0 1 5 5",key:"11nki7"}],["path",{d:"M13.832 16.568a1 1 0 0 0 1.213-.303l.355-.465A2 2 0 0 1 17 15h3a2 2 0 0 1 2 2v3a2 2 0 0 1-2 2A18 18 0 0 1 2 4a2 2 0 0 1 2-2h3a2 2 0 0 1 2 2v3a2 2 0 0 1-.8 1.6l-.468.351a1 1 0 0 0-.292 1.233 14 14 0 0 0 6.392 6.384",key:"9njp5v"}]],PhoneCall=createLucideIcon("phone-call",__iconNode$8l);const __iconNode$8k=[["path",{d:"M14 6h8",key:"yd68k4"}],["path",{d:"m18 2 4 4-4 4",key:"pucp1d"}],["path",{d:"M13.832 16.568a1 1 0 0 0 1.213-.303l.355-.465A2 2 0 0 1 17 15h3a2 2 0 0 1 2 2v3a2 2 0 0 1-2 2A18 18 0 0 1 2 4a2 2 0 0 1 2-2h3a2 2 0 0 1 2 2v3a2 2 0 0 1-.8 1.6l-.468.351a1 1 0 0 0-.292 1.233 14 14 0 0 0 6.392 6.384",key:"9njp5v"}]],PhoneForwarded=createLucideIcon("phone-forwarded",__iconNode$8k);const __iconNode$8j=[["path",{d:"M16 2v6h6",key:"1mfrl5"}],["path",{d:"m22 2-6 6",key:"6f0sa0"}],["path",{d:"M13.832 16.568a1 1 0 0 0 1.213-.303l.355-.465A2 2 0 0 1 17 15h3a2 2 0 0 1 2 2v3a2 2 0 0 1-2 2A18 18 0 0 1 2 4a2 2 0 0 1 2-2h3a2 2 0 0 1 2 2v3a2 2 0 0 1-.8 1.6l-.468.351a1 1 0 0 0-.292 1.233 14 14 0 0 0 6.392 6.384",key:"9njp5v"}]],PhoneIncoming=createLucideIcon("phone-incoming",__iconNode$8j);const __iconNode$8i=[["path",{d:"m16 2 6 6",key:"1gw87d"}],["path",{d:"m22 2-6 6",key:"6f0sa0"}],["path",{d:"M13.832 16.568a1 1 0 0 0 1.213-.303l.355-.465A2 2 0 0 1 17 15h3a2 2 0 0 1 2 2v3a2 2 0 0 1-2 2A18 18 0 0 1 2 4a2 2 0 0 1 2-2h3a2 2 0 0 1 2 2v3a2 2 0 0 1-.8 1.6l-.468.351a1 1 0 0 0-.292 1.233 14 14 0 0 0 6.392 6.384",key:"9njp5v"}]],PhoneMissed=createLucideIcon("phone-missed",__iconNode$8i);const __iconNode$8h=[["path",{d:"M10.1 13.9a14 14 0 0 0 3.732 2.668 1 1 0 0 0 1.213-.303l.355-.465A2 2 0 0 1 17 15h3a2 2 0 0 1 2 2v3a2 2 0 0 1-2 2 18 18 0 0 1-12.728-5.272",key:"1wngk7"}],["path",{d:"M22 2 2 22",key:"y4kqgn"}],["path",{d:"M4.76 13.582A18 18 0 0 1 2 4a2 2 0 0 1 2-2h3a2 2 0 0 1 2 2v3a2 2 0 0 1-.8 1.6l-.468.351a1 1 0 0 0-.292 1.233 14 14 0 0 0 .244.473",key:"10hv5p"}]],PhoneOff=createLucideIcon("phone-off",__iconNode$8h);const __iconNode$8g=[["path",{d:"m16 8 6-6",key:"oawc05"}],["path",{d:"M22 8V2h-6",key:"oqy2zc"}],["path",{d:"M13.832 16.568a1 1 0 0 0 1.213-.303l.355-.465A2 2 0 0 1 17 15h3a2 2 0 0 1 2 2v3a2 2 0 0 1-2 2A18 18 0 0 1 2 4a2 2 0 0 1 2-2h3a2 2 0 0 1 2 2v3a2 2 0 0 1-.8 1.6l-.468.351a1 1 0 0 0-.292 1.233 14 14 0 0 0 6.392 6.384",key:"9njp5v"}]],PhoneOutgoing=createLucideIcon("phone-outgoing",__iconNode$8g);const __iconNode$8f=[["path",{d:"M13.832 16.568a1 1 0 0 0 1.213-.303l.355-.465A2 2 0 0 1 17 15h3a2 2 0 0 1 2 2v3a2 2 0 0 1-2 2A18 18 0 0 1 2 4a2 2 0 0 1 2-2h3a2 2 0 0 1 2 2v3a2 2 0 0 1-.8 1.6l-.468.351a1 1 0 0 0-.292 1.233 14 14 0 0 0 6.392 6.384",key:"9njp5v"}]],Phone=createLucideIcon("phone",__iconNode$8f);const __iconNode$8e=[["line",{x1:"9",x2:"9",y1:"4",y2:"20",key:"ovs5a5"}],["path",{d:"M4 7c0-1.7 1.3-3 3-3h13",key:"10pag4"}],["path",{d:"M18 20c-1.7 0-3-1.3-3-3V4",key:"1gaosr"}]],Pi=createLucideIcon("pi",__iconNode$8e);const __iconNode$8d=[["path",{d:"M18.5 8c-1.4 0-2.6-.8-3.2-2A6.87 6.87 0 0 0 2 9v11a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-8.5C22 9.6 20.4 8 18.5 8",key:"lag0yf"}],["path",{d:"M2 14h20",key:"myj16y"}],["path",{d:"M6 14v4",key:"9ng0ue"}],["path",{d:"M10 14v4",key:"1v8uk5"}],["path",{d:"M14 14v4",key:"1tqops"}],["path",{d:"M18 14v4",key:"18uqwm"}]],Piano=createLucideIcon("piano",__iconNode$8d);const __iconNode$8c=[["path",{d:"m14 13-8.381 8.38a1 1 0 0 1-3.001-3L11 9.999",key:"1lw9ds"}],["path",{d:"M15.973 4.027A13 13 0 0 0 5.902 2.373c-1.398.342-1.092 2.158.277 2.601a19.9 19.9 0 0 1 5.822 3.024",key:"ffj4ej"}],["path",{d:"M16.001 11.999a19.9 19.9 0 0 1 3.024 5.824c.444 1.369 2.26 1.676 2.603.278A13 13 0 0 0 20 8.069",key:"8tj4zw"}],["path",{d:"M18.352 3.352a1.205 1.205 0 0 0-1.704 0l-5.296 5.296a1.205 1.205 0 0 0 0 1.704l2.296 2.296a1.205 1.205 0 0 0 1.704 0l5.296-5.296a1.205 1.205 0 0 0 0-1.704z",key:"hh6h97"}]],Pickaxe=createLucideIcon("pickaxe",__iconNode$8c);const __iconNode$8b=[["path",{d:"M21 9V6a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v10c0 1.1.9 2 2 2h4",key:"daa4of"}],["rect",{width:"10",height:"7",x:"12",y:"13",rx:"2",key:"1nb8gs"}]],PictureInPicture2=createLucideIcon("picture-in-picture-2",__iconNode$8b);const __iconNode$8a=[["path",{d:"M2 10h6V4",key:"zwrco"}],["path",{d:"m2 4 6 6",key:"ug085t"}],["path",{d:"M21 10V7a2 2 0 0 0-2-2h-7",key:"git5jr"}],["path",{d:"M3 14v2a2 2 0 0 0 2 2h3",key:"1f7fh3"}],["rect",{x:"12",y:"14",width:"10",height:"7",rx:"1",key:"1wjs3o"}]],PictureInPicture=createLucideIcon("picture-in-picture",__iconNode$8a);const __iconNode$89=[["path",{d:"M11 17h3v2a1 1 0 0 0 1 1h2a1 1 0 0 0 1-1v-3a3.16 3.16 0 0 0 2-2h1a1 1 0 0 0 1-1v-2a1 1 0 0 0-1-1h-1a5 5 0 0 0-2-4V3a4 4 0 0 0-3.2 1.6l-.3.4H11a6 6 0 0 0-6 6v1a5 5 0 0 0 2 4v3a1 1 0 0 0 1 1h2a1 1 0 0 0 1-1z",key:"1piglc"}],["path",{d:"M16 10h.01",key:"1m94wz"}],["path",{d:"M2 8v1a2 2 0 0 0 2 2h1",key:"1env43"}]],PiggyBank=createLucideIcon("piggy-bank",__iconNode$89);const __iconNode$88=[["path",{d:"M14 3v11",key:"mlfb7b"}],["path",{d:"M14 9h-3a3 3 0 0 1 0-6h9",key:"1ulc19"}],["path",{d:"M18 3v11",key:"1phi0r"}],["path",{d:"M22 18H2l4-4",key:"yt65j9"}],["path",{d:"m6 22-4-4",key:"6jgyf5"}]],PilcrowLeft=createLucideIcon("pilcrow-left",__iconNode$88);const __iconNode$87=[["path",{d:"M10 3v11",key:"o3l5kj"}],["path",{d:"M10 9H7a1 1 0 0 1 0-6h8",key:"1wb1nc"}],["path",{d:"M14 3v11",key:"mlfb7b"}],["path",{d:"m18 14 4 4H2",key:"4r8io1"}],["path",{d:"m22 18-4 4",key:"1hjjrd"}]],PilcrowRight=createLucideIcon("pilcrow-right",__iconNode$87);const __iconNode$86=[["path",{d:"M13 4v16",key:"8vvj80"}],["path",{d:"M17 4v16",key:"7dpous"}],["path",{d:"M19 4H9.5a4.5 4.5 0 0 0 0 9H13",key:"sh4n9v"}]],Pilcrow=createLucideIcon("pilcrow",__iconNode$86);const __iconNode$85=[["path",{d:"M18 11h-4a1 1 0 0 0-1 1v5a1 1 0 0 0 1 1h4",key:"17ldeb"}],["path",{d:"M6 7v13a2 2 0 0 0 2 2h8a2 2 0 0 0 2-2V7",key:"nc37y6"}],["rect",{width:"16",height:"5",x:"4",y:"2",rx:"1",key:"3jeezo"}]],PillBottle=createLucideIcon("pill-bottle",__iconNode$85);const __iconNode$84=[["path",{d:"m10.5 20.5 10-10a4.95 4.95 0 1 0-7-7l-10 10a4.95 4.95 0 1 0 7 7Z",key:"wa1lgi"}],["path",{d:"m8.5 8.5 7 7",key:"rvfmvr"}]],Pill=createLucideIcon("pill",__iconNode$84);const __iconNode$83=[["path",{d:"M12 17v5",key:"bb1du9"}],["path",{d:"M15 9.34V7a1 1 0 0 1 1-1 2 2 0 0 0 0-4H7.89",key:"znwnzq"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M9 9v1.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24V16a1 1 0 0 0 1 1h11",key:"c9qhm2"}]],PinOff=createLucideIcon("pin-off",__iconNode$83);const __iconNode$82=[["path",{d:"M12 17v5",key:"bb1du9"}],["path",{d:"M9 10.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24V16a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-.76a2 2 0 0 0-1.11-1.79l-1.78-.9A2 2 0 0 1 15 10.76V7a1 1 0 0 1 1-1 2 2 0 0 0 0-4H8a2 2 0 0 0 0 4 1 1 0 0 1 1 1z",key:"1nkz8b"}]],Pin=createLucideIcon("pin",__iconNode$82);const __iconNode$81=[["path",{d:"m12 9-8.414 8.414A2 2 0 0 0 3 18.828v1.344a2 2 0 0 1-.586 1.414A2 2 0 0 1 3.828 21h1.344a2 2 0 0 0 1.414-.586L15 12",key:"1y3wsu"}],["path",{d:"m18 9 .4.4a1 1 0 1 1-3 3l-3.8-3.8a1 1 0 1 1 3-3l.4.4 3.4-3.4a1 1 0 1 1 3 3z",key:"110lr1"}],["path",{d:"m2 22 .414-.414",key:"jhxm08"}]],Pipette=createLucideIcon("pipette",__iconNode$81);const __iconNode$80=[["path",{d:"m12 14-1 1",key:"11onhr"}],["path",{d:"m13.75 18.25-1.25 1.42",key:"1yisr3"}],["path",{d:"M17.775 5.654a15.68 15.68 0 0 0-12.121 12.12",key:"1qtqk6"}],["path",{d:"M18.8 9.3a1 1 0 0 0 2.1 7.7",key:"fbbbr2"}],["path",{d:"M21.964 20.732a1 1 0 0 1-1.232 1.232l-18-5a1 1 0 0 1-.695-1.232A19.68 19.68 0 0 1 15.732 2.037a1 1 0 0 1 1.232.695z",key:"1hyfdd"}]],Pizza=createLucideIcon("pizza",__iconNode$80);const __iconNode$7$=[["path",{d:"M2 22h20",key:"272qi7"}],["path",{d:"M3.77 10.77 2 9l2-4.5 1.1.55c.55.28.9.84.9 1.45s.35 1.17.9 1.45L8 8.5l3-6 1.05.53a2 2 0 0 1 1.09 1.52l.72 5.4a2 2 0 0 0 1.09 1.52l4.4 2.2c.42.22.78.55 1.01.96l.6 1.03c.49.88-.06 1.98-1.06 2.1l-1.18.15c-.47.06-.95-.02-1.37-.24L4.29 11.15a2 2 0 0 1-.52-.38Z",key:"1ma21e"}]],PlaneLanding=createLucideIcon("plane-landing",__iconNode$7$);const __iconNode$7_=[["path",{d:"M2 22h20",key:"272qi7"}],["path",{d:"M6.36 17.4 4 17l-2-4 1.1-.55a2 2 0 0 1 1.8 0l.17.1a2 2 0 0 0 1.8 0L8 12 5 6l.9-.45a2 2 0 0 1 2.09.2l4.02 3a2 2 0 0 0 2.1.2l4.19-2.06a2.41 2.41 0 0 1 1.73-.17L21 7a1.4 1.4 0 0 1 .87 1.99l-.38.76c-.23.46-.6.84-1.07 1.08L7.58 17.2a2 2 0 0 1-1.22.18Z",key:"fkigj9"}]],PlaneTakeoff=createLucideIcon("plane-takeoff",__iconNode$7_);const __iconNode$7Z=[["path",{d:"M17.8 19.2 16 11l3.5-3.5C21 6 21.5 4 21 3c-1-.5-3 0-4.5 1.5L13 8 4.8 6.2c-.5-.1-.9.1-1.1.5l-.3.5c-.2.5-.1 1 .3 1.3L9 12l-2 3H4l-1 1 3 2 2 3 1-1v-3l3-2 3.5 5.3c.3.4.8.5 1.3.3l.5-.2c.4-.3.6-.7.5-1.2z",key:"1v9wt8"}]],Plane=createLucideIcon("plane",__iconNode$7Z);const __iconNode$7Y=[["path",{d:"M5 5a2 2 0 0 1 3.008-1.728l11.997 6.998a2 2 0 0 1 .003 3.458l-12 7A2 2 0 0 1 5 19z",key:"10ikf1"}]],Play=createLucideIcon("play",__iconNode$7Y);const __iconNode$7X=[["path",{d:"M9 2v6",key:"17ngun"}],["path",{d:"M15 2v6",key:"s7yy2p"}],["path",{d:"M12 17v5",key:"bb1du9"}],["path",{d:"M5 8h14",key:"pcz4l3"}],["path",{d:"M6 11V8h12v3a6 6 0 1 1-12 0Z",key:"wtfw2c"}]],Plug2=createLucideIcon("plug-2",__iconNode$7X);const __iconNode$7W=[["path",{d:"M6.3 20.3a2.4 2.4 0 0 0 3.4 0L12 18l-6-6-2.3 2.3a2.4 2.4 0 0 0 0 3.4Z",key:"goz73y"}],["path",{d:"m2 22 3-3",key:"19mgm9"}],["path",{d:"M7.5 13.5 10 11",key:"7xgeeb"}],["path",{d:"M10.5 16.5 13 14",key:"10btkg"}],["path",{d:"m18 3-4 4h6l-4 4",key:"16psg9"}]],PlugZap=createLucideIcon("plug-zap",__iconNode$7W);const __iconNode$7V=[["path",{d:"M12 22v-5",key:"1ega77"}],["path",{d:"M9 8V2",key:"14iosj"}],["path",{d:"M15 8V2",key:"18g5xt"}],["path",{d:"M18 8v5a4 4 0 0 1-4 4h-4a4 4 0 0 1-4-4V8Z",key:"osxo6l"}]],Plug=createLucideIcon("plug",__iconNode$7V);const __iconNode$7U=[["path",{d:"M5 12h14",key:"1ays0h"}],["path",{d:"M12 5v14",key:"s699le"}]],Plus=createLucideIcon("plus",__iconNode$7U);const __iconNode$7T=[["path",{d:"M3 2v1c0 1 2 1 2 2S3 6 3 7s2 1 2 2-2 1-2 2 2 1 2 2",key:"19w3oe"}],["path",{d:"M18 6h.01",key:"1v4wsw"}],["path",{d:"M6 18h.01",key:"uhywen"}],["path",{d:"M20.83 8.83a4 4 0 0 0-5.66-5.66l-12 12a4 4 0 1 0 5.66 5.66Z",key:"6fykxj"}],["path",{d:"M18 11.66V22a4 4 0 0 0 4-4V6",key:"1utzek"}]],PocketKnife=createLucideIcon("pocket-knife",__iconNode$7T);const __iconNode$7S=[["path",{d:"M20 3a2 2 0 0 1 2 2v6a1 1 0 0 1-20 0V5a2 2 0 0 1 2-2z",key:"1uodqw"}],["path",{d:"m8 10 4 4 4-4",key:"1mxd5q"}]],Pocket=createLucideIcon("pocket",__iconNode$7S);const __iconNode$7R=[["path",{d:"M13 17a1 1 0 1 0-2 0l.5 4.5a0.5 0.5 0 0 0 1 0z",fill:"currentColor",key:"x1mxqr"}],["path",{d:"M16.85 18.58a9 9 0 1 0-9.7 0",key:"d71mpg"}],["path",{d:"M8 14a5 5 0 1 1 8 0",key:"fc81rn"}],["circle",{cx:"12",cy:"11",r:"1",fill:"currentColor",key:"vqiwd"}]],Podcast=createLucideIcon("podcast",__iconNode$7R);const __iconNode$7Q=[["path",{d:"M10 4.5V4a2 2 0 0 0-2.41-1.957",key:"jsi14n"}],["path",{d:"M13.9 8.4a2 2 0 0 0-1.26-1.295",key:"hirc7f"}],["path",{d:"M21.7 16.2A8 8 0 0 0 22 14v-3a2 2 0 1 0-4 0v-1a2 2 0 0 0-3.63-1.158",key:"1jxb2e"}],["path",{d:"m7 15-1.8-1.8a2 2 0 0 0-2.79 2.86L6 19.7a7.74 7.74 0 0 0 6 2.3h2a8 8 0 0 0 5.657-2.343",key:"10r7hm"}],["path",{d:"M6 6v8",key:"tv5xkp"}],["path",{d:"m2 2 20 20",key:"1ooewy"}]],PointerOff=createLucideIcon("pointer-off",__iconNode$7Q);const __iconNode$7P=[["path",{d:"M22 14a8 8 0 0 1-8 8",key:"56vcr3"}],["path",{d:"M18 11v-1a2 2 0 0 0-2-2a2 2 0 0 0-2 2",key:"1agjmk"}],["path",{d:"M14 10V9a2 2 0 0 0-2-2a2 2 0 0 0-2 2v1",key:"wdbh2u"}],["path",{d:"M10 9.5V4a2 2 0 0 0-2-2a2 2 0 0 0-2 2v10",key:"1ibuk9"}],["path",{d:"M18 11a2 2 0 1 1 4 0v3a8 8 0 0 1-8 8h-2c-2.8 0-4.5-.86-5.99-2.34l-3.6-3.6a2 2 0 0 1 2.83-2.82L7 15",key:"g6ys72"}]],Pointer=createLucideIcon("pointer",__iconNode$7P);const __iconNode$7O=[["path",{d:"M18 8a2 2 0 0 0 0-4 2 2 0 0 0-4 0 2 2 0 0 0-4 0 2 2 0 0 0-4 0 2 2 0 0 0 0 4",key:"10td1f"}],["path",{d:"M10 22 9 8",key:"yjptiv"}],["path",{d:"m14 22 1-14",key:"8jwc8b"}],["path",{d:"M20 8c.5 0 .9.4.8 1l-2.6 12c-.1.5-.7 1-1.2 1H7c-.6 0-1.1-.4-1.2-1L3.2 9c-.1-.6.3-1 .8-1Z",key:"1qo33t"}]],Popcorn=createLucideIcon("popcorn",__iconNode$7O);const __iconNode$7N=[["path",{d:"M18.6 14.4c.8-.8.8-2 0-2.8l-8.1-8.1a4.95 4.95 0 1 0-7.1 7.1l8.1 8.1c.9.7 2.1.7 2.9-.1Z",key:"1o68ps"}],["path",{d:"m22 22-5.5-5.5",key:"17o70y"}]],Popsicle=createLucideIcon("popsicle",__iconNode$7N);const __iconNode$7M=[["path",{d:"M18 7c0-5.333-8-5.333-8 0",key:"1prm2n"}],["path",{d:"M10 7v14",key:"18tmcs"}],["path",{d:"M6 21h12",key:"4dkmi1"}],["path",{d:"M6 13h10",key:"ybwr4a"}]],PoundSterling=createLucideIcon("pound-sterling",__iconNode$7M);const __iconNode$7L=[["path",{d:"M18.36 6.64A9 9 0 0 1 20.77 15",key:"dxknvb"}],["path",{d:"M6.16 6.16a9 9 0 1 0 12.68 12.68",key:"1x7qb5"}],["path",{d:"M12 2v4",key:"3427ic"}],["path",{d:"m2 2 20 20",key:"1ooewy"}]],PowerOff=createLucideIcon("power-off",__iconNode$7L);const __iconNode$7K=[["path",{d:"M12 2v10",key:"mnfbl"}],["path",{d:"M18.4 6.6a9 9 0 1 1-12.77.04",key:"obofu9"}]],Power=createLucideIcon("power",__iconNode$7K);const __iconNode$7J=[["path",{d:"M2 3h20",key:"91anmk"}],["path",{d:"M21 3v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V3",key:"2k9sn8"}],["path",{d:"m7 21 5-5 5 5",key:"bip4we"}]],Presentation=createLucideIcon("presentation",__iconNode$7J);const __iconNode$7I=[["path",{d:"M6 18H4a2 2 0 0 1-2-2v-5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v5a2 2 0 0 1-2 2h-2",key:"143wyd"}],["path",{d:"M6 9V3a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v6",key:"1itne7"}],["rect",{x:"6",y:"14",width:"12",height:"8",rx:"1",key:"1ue0tg"}]],Printer=createLucideIcon("printer",__iconNode$7I);const __iconNode$7H=[["path",{d:"M13.5 22H7a1 1 0 0 1-1-1v-6a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v.5",key:"qeb09x"}],["path",{d:"m16 19 2 2 4-4",key:"1b14m6"}],["path",{d:"M6 18H4a2 2 0 0 1-2-2v-5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v2",key:"1md90i"}],["path",{d:"M6 9V3a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v6",key:"1itne7"}]],PrinterCheck=createLucideIcon("printer-check",__iconNode$7H);const __iconNode$7G=[["path",{d:"M5 7 3 5",key:"1yys58"}],["path",{d:"M9 6V3",key:"1ptz9u"}],["path",{d:"m13 7 2-2",key:"1w3vmq"}],["circle",{cx:"9",cy:"13",r:"3",key:"1mma13"}],["path",{d:"M11.83 12H20a2 2 0 0 1 2 2v4a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2v-4a2 2 0 0 1 2-2h2.17",key:"2frwzc"}],["path",{d:"M16 16h2",key:"dnq2od"}]],Projector=createLucideIcon("projector",__iconNode$7G);const __iconNode$7F=[["rect",{width:"20",height:"16",x:"2",y:"4",rx:"2",key:"18n3k1"}],["path",{d:"M12 9v11",key:"1fnkrn"}],["path",{d:"M2 9h13a2 2 0 0 1 2 2v9",key:"11z3ex"}]],Proportions=createLucideIcon("proportions",__iconNode$7F);const __iconNode$7E=[["path",{d:"M15.39 4.39a1 1 0 0 0 1.68-.474 2.5 2.5 0 1 1 3.014 3.015 1 1 0 0 0-.474 1.68l1.683 1.682a2.414 2.414 0 0 1 0 3.414L19.61 15.39a1 1 0 0 1-1.68-.474 2.5 2.5 0 1 0-3.014 3.015 1 1 0 0 1 .474 1.68l-1.683 1.682a2.414 2.414 0 0 1-3.414 0L8.61 19.61a1 1 0 0 0-1.68.474 2.5 2.5 0 1 1-3.014-3.015 1 1 0 0 0 .474-1.68l-1.683-1.682a2.414 2.414 0 0 1 0-3.414L4.39 8.61a1 1 0 0 1 1.68.474 2.5 2.5 0 1 0 3.014-3.015 1 1 0 0 1-.474-1.68l1.683-1.682a2.414 2.414 0 0 1 3.414 0z",key:"w46dr5"}]],Puzzle=createLucideIcon("puzzle",__iconNode$7E);const __iconNode$7D=[["path",{d:"M2.5 16.88a1 1 0 0 1-.32-1.43l9-13.02a1 1 0 0 1 1.64 0l9 13.01a1 1 0 0 1-.32 1.44l-8.51 4.86a2 2 0 0 1-1.98 0Z",key:"aenxs0"}],["path",{d:"M12 2v20",key:"t6zp3m"}]],Pyramid=createLucideIcon("pyramid",__iconNode$7D);const __iconNode$7C=[["rect",{width:"5",height:"5",x:"3",y:"3",rx:"1",key:"1tu5fj"}],["rect",{width:"5",height:"5",x:"16",y:"3",rx:"1",key:"1v8r4q"}],["rect",{width:"5",height:"5",x:"3",y:"16",rx:"1",key:"1x03jg"}],["path",{d:"M21 16h-3a2 2 0 0 0-2 2v3",key:"177gqh"}],["path",{d:"M21 21v.01",key:"ents32"}],["path",{d:"M12 7v3a2 2 0 0 1-2 2H7",key:"8crl2c"}],["path",{d:"M3 12h.01",key:"nlz23k"}],["path",{d:"M12 3h.01",key:"n36tog"}],["path",{d:"M12 16v.01",key:"133mhm"}],["path",{d:"M16 12h1",key:"1slzba"}],["path",{d:"M21 12v.01",key:"1lwtk9"}],["path",{d:"M12 21v-1",key:"1880an"}]],QrCode=createLucideIcon("qr-code",__iconNode$7C);const __iconNode$7B=[["path",{d:"M16 3a2 2 0 0 0-2 2v6a2 2 0 0 0 2 2 1 1 0 0 1 1 1v1a2 2 0 0 1-2 2 1 1 0 0 0-1 1v2a1 1 0 0 0 1 1 6 6 0 0 0 6-6V5a2 2 0 0 0-2-2z",key:"rib7q0"}],["path",{d:"M5 3a2 2 0 0 0-2 2v6a2 2 0 0 0 2 2 1 1 0 0 1 1 1v1a2 2 0 0 1-2 2 1 1 0 0 0-1 1v2a1 1 0 0 0 1 1 6 6 0 0 0 6-6V5a2 2 0 0 0-2-2z",key:"1ymkrd"}]],Quote=createLucideIcon("quote",__iconNode$7B);const __iconNode$7A=[["path",{d:"M13 16a3 3 0 0 1 2.24 5",key:"1epib5"}],["path",{d:"M18 12h.01",key:"yjnet6"}],["path",{d:"M18 21h-8a4 4 0 0 1-4-4 7 7 0 0 1 7-7h.2L9.6 6.4a1 1 0 1 1 2.8-2.8L15.8 7h.2c3.3 0 6 2.7 6 6v1a2 2 0 0 1-2 2h-1a3 3 0 0 0-3 3",key:"ue9ozu"}],["path",{d:"M20 8.54V4a2 2 0 1 0-4 0v3",key:"49iql8"}],["path",{d:"M7.612 12.524a3 3 0 1 0-1.6 4.3",key:"1e33i0"}]],Rabbit=createLucideIcon("rabbit",__iconNode$7A);const __iconNode$7z=[["path",{d:"M19.07 4.93A10 10 0 0 0 6.99 3.34",key:"z3du51"}],["path",{d:"M4 6h.01",key:"oypzma"}],["path",{d:"M2.29 9.62A10 10 0 1 0 21.31 8.35",key:"qzzz0"}],["path",{d:"M16.24 7.76A6 6 0 1 0 8.23 16.67",key:"1yjesh"}],["path",{d:"M12 18h.01",key:"mhygvu"}],["path",{d:"M17.99 11.66A6 6 0 0 1 15.77 16.67",key:"1u2y91"}],["circle",{cx:"12",cy:"12",r:"2",key:"1c9p78"}],["path",{d:"m13.41 10.59 5.66-5.66",key:"mhq4k0"}]],Radar=createLucideIcon("radar",__iconNode$7z);const __iconNode$7y=[["path",{d:"M12 12h.01",key:"1mp3jc"}],["path",{d:"M14 15.4641a4 4 0 0 1-4 0L7.52786 19.74597 A 1 1 0 0 0 7.99303 21.16211 10 10 0 0 0 16.00697 21.16211 1 1 0 0 0 16.47214 19.74597z",key:"1y4lzb"}],["path",{d:"M16 12a4 4 0 0 0-2-3.464l2.472-4.282a1 1 0 0 1 1.46-.305 10 10 0 0 1 4.006 6.94A1 1 0 0 1 21 12z",key:"163ggk"}],["path",{d:"M8 12a4 4 0 0 1 2-3.464L7.528 4.254a1 1 0 0 0-1.46-.305 10 10 0 0 0-4.006 6.94A1 1 0 0 0 3 12z",key:"1l9i0b"}]],Radiation=createLucideIcon("radiation",__iconNode$7y);const __iconNode$7x=[["path",{d:"M3 12h3.28a1 1 0 0 1 .948.684l2.298 7.934a.5.5 0 0 0 .96-.044L13.82 4.771A1 1 0 0 1 14.792 4H21",key:"1mqj8i"}]],Radical=createLucideIcon("radical",__iconNode$7x);const __iconNode$7w=[["path",{d:"M4.9 16.1C1 12.2 1 5.8 4.9 1.9",key:"s0qx1y"}],["path",{d:"M7.8 4.7a6.14 6.14 0 0 0-.8 7.5",key:"1idnkw"}],["circle",{cx:"12",cy:"9",r:"2",key:"1092wv"}],["path",{d:"M16.2 4.8c2 2 2.26 5.11.8 7.47",key:"ojru2q"}],["path",{d:"M19.1 1.9a9.96 9.96 0 0 1 0 14.1",key:"rhi7fg"}],["path",{d:"M9.5 18h5",key:"mfy3pd"}],["path",{d:"m8 22 4-11 4 11",key:"25yftu"}]],RadioTower=createLucideIcon("radio-tower",__iconNode$7w);const __iconNode$7v=[["path",{d:"M5 16v2",key:"g5qcv5"}],["path",{d:"M19 16v2",key:"1gbaio"}],["rect",{width:"20",height:"8",x:"2",y:"8",rx:"2",key:"vjsjur"}],["path",{d:"M18 12h.01",key:"yjnet6"}]],RadioReceiver=createLucideIcon("radio-receiver",__iconNode$7v);const __iconNode$7u=[["path",{d:"M16.247 7.761a6 6 0 0 1 0 8.478",key:"1fwjs5"}],["path",{d:"M19.075 4.933a10 10 0 0 1 0 14.134",key:"ehdyv1"}],["path",{d:"M4.925 19.067a10 10 0 0 1 0-14.134",key:"1q22gi"}],["path",{d:"M7.753 16.239a6 6 0 0 1 0-8.478",key:"r2q7qm"}],["circle",{cx:"12",cy:"12",r:"2",key:"1c9p78"}]],Radio=createLucideIcon("radio",__iconNode$7u);const __iconNode$7t=[["path",{d:"M20.34 17.52a10 10 0 1 0-2.82 2.82",key:"fydyku"}],["circle",{cx:"19",cy:"19",r:"2",key:"17f5cg"}],["path",{d:"m13.41 13.41 4.18 4.18",key:"1gqbwc"}],["circle",{cx:"12",cy:"12",r:"2",key:"1c9p78"}]],Radius=createLucideIcon("radius",__iconNode$7t);const __iconNode$7s=[["path",{d:"M5 15h14",key:"m0yey3"}],["path",{d:"M5 9h14",key:"7tsvo6"}],["path",{d:"m14 20-5-5 6-6-5-5",key:"1jo42i"}]],RailSymbol=createLucideIcon("rail-symbol",__iconNode$7s);const __iconNode$7r=[["path",{d:"M13 22H4a2 2 0 0 1 0-4h12",key:"bt3f23"}],["path",{d:"M13.236 18a3 3 0 0 0-2.2-5",key:"1tbvmo"}],["path",{d:"M16 9h.01",key:"1bdo4e"}],["path",{d:"M16.82 3.94a3 3 0 1 1 3.237 4.868l1.815 2.587a1.5 1.5 0 0 1-1.5 2.1l-2.872-.453a3 3 0 0 0-3.5 3",key:"9ch7kn"}],["path",{d:"M17 4.988a3 3 0 1 0-5.2 2.052A7 7 0 0 0 4 14.015 4 4 0 0 0 8 18",key:"3s7e9i"}]],Rat=createLucideIcon("rat",__iconNode$7r);const __iconNode$7q=[["path",{d:"M22 17a10 10 0 0 0-20 0",key:"ozegv"}],["path",{d:"M6 17a6 6 0 0 1 12 0",key:"5giftw"}],["path",{d:"M10 17a2 2 0 0 1 4 0",key:"gnsikk"}]],Rainbow=createLucideIcon("rainbow",__iconNode$7q);const __iconNode$7p=[["rect",{width:"12",height:"20",x:"6",y:"2",rx:"2",key:"1oxtiu"}],["rect",{width:"20",height:"12",x:"2",y:"6",rx:"2",key:"9lu3g6"}]],Ratio=createLucideIcon("ratio",__iconNode$7p);const __iconNode$7o=[["path",{d:"M4 2v20l2-1 2 1 2-1 2 1 2-1 2 1 2-1 2 1V2l-2 1-2-1-2 1-2-1-2 1-2-1-2 1Z",key:"q3az6g"}],["path",{d:"M12 6.5v11",key:"ecfhkf"}],["path",{d:"M15 9.4a4 4 0 1 0 0 5.2",key:"1makmb"}]],ReceiptCent=createLucideIcon("receipt-cent",__iconNode$7o);const __iconNode$7n=[["path",{d:"M4 2v20l2-1 2 1 2-1 2 1 2-1 2 1 2-1 2 1V2l-2 1-2-1-2 1-2-1-2 1-2-1-2 1Z",key:"q3az6g"}],["path",{d:"M8 12h5",key:"1g6qi8"}],["path",{d:"M16 9.5a4 4 0 1 0 0 5.2",key:"b2px4r"}]],ReceiptEuro=createLucideIcon("receipt-euro",__iconNode$7n);const __iconNode$7m=[["path",{d:"M4 2v20l2-1 2 1 2-1 2 1 2-1 2 1 2-1 2 1V2l-2 1-2-1-2 1-2-1-2 1-2-1-2 1Z",key:"q3az6g"}],["path",{d:"M8 7h8",key:"i86dvs"}],["path",{d:"M12 17.5 8 15h1a4 4 0 0 0 0-8",key:"grpkl4"}],["path",{d:"M8 11h8",key:"vwpz6n"}]],ReceiptIndianRupee=createLucideIcon("receipt-indian-rupee",__iconNode$7m);const __iconNode$7l=[["path",{d:"M4 2v20l2-1 2 1 2-1 2 1 2-1 2 1 2-1 2 1V2l-2 1-2-1-2 1-2-1-2 1-2-1-2 1Z",key:"q3az6g"}],["path",{d:"m12 10 3-3",key:"1mc12w"}],["path",{d:"m9 7 3 3v7.5",key:"39i0xv"}],["path",{d:"M9 11h6",key:"1fldmi"}],["path",{d:"M9 15h6",key:"cctwl0"}]],ReceiptJapaneseYen=createLucideIcon("receipt-japanese-yen",__iconNode$7l);const __iconNode$7k=[["path",{d:"M4 2v20l2-1 2 1 2-1 2 1 2-1 2 1 2-1 2 1V2l-2 1-2-1-2 1-2-1-2 1-2-1-2 1Z",key:"q3az6g"}],["path",{d:"M8 13h5",key:"1k9z8w"}],["path",{d:"M10 17V9.5a2.5 2.5 0 0 1 5 0",key:"1dzgp0"}],["path",{d:"M8 17h7",key:"8mjdqu"}]],ReceiptPoundSterling=createLucideIcon("receipt-pound-sterling",__iconNode$7k);const __iconNode$7j=[["path",{d:"M4 2v20l2-1 2 1 2-1 2 1 2-1 2 1 2-1 2 1V2l-2 1-2-1-2 1-2-1-2 1-2-1-2 1Z",key:"q3az6g"}],["path",{d:"M8 15h5",key:"vxg57a"}],["path",{d:"M8 11h5a2 2 0 1 0 0-4h-3v10",key:"1usi5u"}]],ReceiptRussianRuble=createLucideIcon("receipt-russian-ruble",__iconNode$7j);const __iconNode$7i=[["path",{d:"M13 16H8",key:"wsln4y"}],["path",{d:"M14 8H8",key:"1l3xfs"}],["path",{d:"M16 12H8",key:"1fr5h0"}],["path",{d:"M4 3a1 1 0 0 1 1-1 1.3 1.3 0 0 1 .7.2l.933.6a1.3 1.3 0 0 0 1.4 0l.934-.6a1.3 1.3 0 0 1 1.4 0l.933.6a1.3 1.3 0 0 0 1.4 0l.933-.6a1.3 1.3 0 0 1 1.4 0l.934.6a1.3 1.3 0 0 0 1.4 0l.933-.6A1.3 1.3 0 0 1 19 2a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1 1.3 1.3 0 0 1-.7-.2l-.933-.6a1.3 1.3 0 0 0-1.4 0l-.934.6a1.3 1.3 0 0 1-1.4 0l-.933-.6a1.3 1.3 0 0 0-1.4 0l-.933.6a1.3 1.3 0 0 1-1.4 0l-.934-.6a1.3 1.3 0 0 0-1.4 0l-.933.6a1.3 1.3 0 0 1-.7.2 1 1 0 0 1-1-1z",key:"ycz6yz"}]],ReceiptText=createLucideIcon("receipt-text",__iconNode$7i);const __iconNode$7h=[["path",{d:"M4 2v20l2-1 2 1 2-1 2 1 2-1 2 1 2-1 2 1V2l-2 1-2-1-2 1-2-1-2 1-2-1-2 1Z",key:"q3az6g"}],["path",{d:"M10 17V7h5",key:"k7jq18"}],["path",{d:"M10 11h4",key:"1i0mka"}],["path",{d:"M8 15h5",key:"vxg57a"}]],ReceiptSwissFranc=createLucideIcon("receipt-swiss-franc",__iconNode$7h);const __iconNode$7g=[["path",{d:"M10 6.5v11a5.5 5.5 0 0 0 5.5-5.5",key:"nw10mp"}],["path",{d:"m14 8-6 3",key:"2tb98i"}],["path",{d:"M4 2v20l2-1 2 1 2-1 2 1 2-1 2 1 2-1 2 1V2l-2 1-2-1-2 1-2-1-2 1-2-1-2 1z",key:"io9ry0"}]],ReceiptTurkishLira=createLucideIcon("receipt-turkish-lira",__iconNode$7g);const __iconNode$7f=[["path",{d:"M4 2v20l2-1 2 1 2-1 2 1 2-1 2 1 2-1 2 1V2l-2 1-2-1-2 1-2-1-2 1-2-1-2 1Z",key:"q3az6g"}],["path",{d:"M16 8h-6a2 2 0 1 0 0 4h4a2 2 0 1 1 0 4H8",key:"1h4pet"}],["path",{d:"M12 17.5v-11",key:"1jc1ny"}]],Receipt=createLucideIcon("receipt",__iconNode$7f);const __iconNode$7e=[["rect",{width:"20",height:"12",x:"2",y:"6",rx:"2",key:"9lu3g6"}],["path",{d:"M12 12h.01",key:"1mp3jc"}],["path",{d:"M17 12h.01",key:"1m0b6t"}],["path",{d:"M7 12h.01",key:"eqddd0"}]],RectangleEllipsis=createLucideIcon("rectangle-ellipsis",__iconNode$7e);const __iconNode$7d=[["path",{d:"M14 4v16H3a1 1 0 0 1-1-1V5a1 1 0 0 1 1-1z",key:"1m5n7q"}],["circle",{cx:"14",cy:"12",r:"8",key:"1pag6k"}]],RectangleCircle=createLucideIcon("rectangle-circle",__iconNode$7d);const __iconNode$7c=[["path",{d:"M20 6a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2h-4a2 2 0 0 1-1.6-.8l-1.6-2.13a1 1 0 0 0-1.6 0L9.6 17.2A2 2 0 0 1 8 18H4a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2z",key:"d5y1f"}]],RectangleGoggles=createLucideIcon("rectangle-goggles",__iconNode$7c);const __iconNode$7b=[["rect",{width:"20",height:"12",x:"2",y:"6",rx:"2",key:"9lu3g6"}]],RectangleHorizontal=createLucideIcon("rectangle-horizontal",__iconNode$7b);const __iconNode$7a=[["rect",{width:"12",height:"20",x:"6",y:"2",rx:"2",key:"1oxtiu"}]],RectangleVertical=createLucideIcon("rectangle-vertical",__iconNode$7a);const __iconNode$79=[["path",{d:"M7 19H4.815a1.83 1.83 0 0 1-1.57-.881 1.785 1.785 0 0 1-.004-1.784L7.196 9.5",key:"x6z5xu"}],["path",{d:"M11 19h8.203a1.83 1.83 0 0 0 1.556-.89 1.784 1.784 0 0 0 0-1.775l-1.226-2.12",key:"1x4zh5"}],["path",{d:"m14 16-3 3 3 3",key:"f6jyew"}],["path",{d:"M8.293 13.596 7.196 9.5 3.1 10.598",key:"wf1obh"}],["path",{d:"m9.344 5.811 1.093-1.892A1.83 1.83 0 0 1 11.985 3a1.784 1.784 0 0 1 1.546.888l3.943 6.843",key:"9tzpgr"}],["path",{d:"m13.378 9.633 4.096 1.098 1.097-4.096",key:"1oe83g"}]],Recycle=createLucideIcon("recycle",__iconNode$79);const __iconNode$78=[["path",{d:"m15 14 5-5-5-5",key:"12vg1m"}],["path",{d:"M20 9H9.5A5.5 5.5 0 0 0 4 14.5A5.5 5.5 0 0 0 9.5 20H13",key:"6uklza"}]],Redo2=createLucideIcon("redo-2",__iconNode$78);const __iconNode$77=[["circle",{cx:"12",cy:"17",r:"1",key:"1ixnty"}],["path",{d:"M21 7v6h-6",key:"3ptur4"}],["path",{d:"M3 17a9 9 0 0 1 9-9 9 9 0 0 1 6 2.3l3 2.7",key:"1kgawr"}]],RedoDot=createLucideIcon("redo-dot",__iconNode$77);const __iconNode$76=[["path",{d:"M21 7v6h-6",key:"3ptur4"}],["path",{d:"M3 17a9 9 0 0 1 9-9 9 9 0 0 1 6 2.3l3 2.7",key:"1kgawr"}]],Redo=createLucideIcon("redo",__iconNode$76);const __iconNode$75=[["path",{d:"M21 12a9 9 0 0 0-9-9 9.75 9.75 0 0 0-6.74 2.74L3 8",key:"14sxne"}],["path",{d:"M3 3v5h5",key:"1xhq8a"}],["path",{d:"M3 12a9 9 0 0 0 9 9 9.75 9.75 0 0 0 6.74-2.74L21 16",key:"1hlbsb"}],["path",{d:"M16 16h5v5",key:"ccwih5"}],["circle",{cx:"12",cy:"12",r:"1",key:"41hilf"}]],RefreshCcwDot=createLucideIcon("refresh-ccw-dot",__iconNode$75);const __iconNode$74=[["path",{d:"M21 12a9 9 0 0 0-9-9 9.75 9.75 0 0 0-6.74 2.74L3 8",key:"14sxne"}],["path",{d:"M3 3v5h5",key:"1xhq8a"}],["path",{d:"M3 12a9 9 0 0 0 9 9 9.75 9.75 0 0 0 6.74-2.74L21 16",key:"1hlbsb"}],["path",{d:"M16 16h5v5",key:"ccwih5"}]],RefreshCcw=createLucideIcon("refresh-ccw",__iconNode$74);const __iconNode$73=[["path",{d:"M21 8L18.74 5.74A9.75 9.75 0 0 0 12 3C11 3 10.03 3.16 9.13 3.47",key:"1krf6h"}],["path",{d:"M8 16H3v5",key:"1cv678"}],["path",{d:"M3 12C3 9.51 4 7.26 5.64 5.64",key:"ruvoct"}],["path",{d:"m3 16 2.26 2.26A9.75 9.75 0 0 0 12 21c2.49 0 4.74-1 6.36-2.64",key:"19q130"}],["path",{d:"M21 12c0 1-.16 1.97-.47 2.87",key:"4w8emr"}],["path",{d:"M21 3v5h-5",key:"1q7to0"}],["path",{d:"M22 22 2 2",key:"1r8tn9"}]],RefreshCwOff=createLucideIcon("refresh-cw-off",__iconNode$73);const __iconNode$72=[["path",{d:"M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8",key:"v9h5vc"}],["path",{d:"M21 3v5h-5",key:"1q7to0"}],["path",{d:"M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16",key:"3uifl3"}],["path",{d:"M8 16H3v5",key:"1cv678"}]],RefreshCw=createLucideIcon("refresh-cw",__iconNode$72);const __iconNode$71=[["path",{d:"M5 6a4 4 0 0 1 4-4h6a4 4 0 0 1 4 4v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6Z",key:"fpq118"}],["path",{d:"M5 10h14",key:"elsbfy"}],["path",{d:"M15 7v6",key:"1nx30x"}]],Refrigerator=createLucideIcon("refrigerator",__iconNode$71);const __iconNode$70=[["path",{d:"M17 3v10",key:"15fgeh"}],["path",{d:"m12.67 5.5 8.66 5",key:"1gpheq"}],["path",{d:"m12.67 10.5 8.66-5",key:"1dkfa6"}],["path",{d:"M9 17a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v2a2 2 0 0 0 2 2h2a2 2 0 0 0 2-2v-2z",key:"swwfx4"}]],Regex=createLucideIcon("regex",__iconNode$70);const __iconNode$6$=[["path",{d:"M4 7V4h16v3",key:"9msm58"}],["path",{d:"M5 20h6",key:"1h6pxn"}],["path",{d:"M13 4 8 20",key:"kqq6aj"}],["path",{d:"m15 15 5 5",key:"me55sn"}],["path",{d:"m20 15-5 5",key:"11p7ol"}]],RemoveFormatting=createLucideIcon("remove-formatting",__iconNode$6$);const __iconNode$6_=[["path",{d:"m17 2 4 4-4 4",key:"nntrym"}],["path",{d:"M3 11v-1a4 4 0 0 1 4-4h14",key:"84bu3i"}],["path",{d:"m7 22-4-4 4-4",key:"1wqhfi"}],["path",{d:"M21 13v1a4 4 0 0 1-4 4H3",key:"1rx37r"}],["path",{d:"M11 10h1v4",key:"70cz1p"}]],Repeat1=createLucideIcon("repeat-1",__iconNode$6_);const __iconNode$6Z=[["path",{d:"m2 9 3-3 3 3",key:"1ltn5i"}],["path",{d:"M13 18H7a2 2 0 0 1-2-2V6",key:"1r6tfw"}],["path",{d:"m22 15-3 3-3-3",key:"4rnwn2"}],["path",{d:"M11 6h6a2 2 0 0 1 2 2v10",key:"2f72bc"}]],Repeat2=createLucideIcon("repeat-2",__iconNode$6Z);const __iconNode$6Y=[["path",{d:"m17 2 4 4-4 4",key:"nntrym"}],["path",{d:"M3 11v-1a4 4 0 0 1 4-4h14",key:"84bu3i"}],["path",{d:"m7 22-4-4 4-4",key:"1wqhfi"}],["path",{d:"M21 13v1a4 4 0 0 1-4 4H3",key:"1rx37r"}]],Repeat=createLucideIcon("repeat",__iconNode$6Y);const __iconNode$6X=[["path",{d:"M14 14a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1",key:"zg1ipl"}],["path",{d:"M14 4a1 1 0 0 1 1-1",key:"dhj8ez"}],["path",{d:"M15 10a1 1 0 0 1-1-1",key:"1mnyi5"}],["path",{d:"M19 14a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1",key:"txt6k4"}],["path",{d:"M21 4a1 1 0 0 0-1-1",key:"sfs9ap"}],["path",{d:"M21 9a1 1 0 0 1-1 1",key:"mp6qeo"}],["path",{d:"m3 7 3 3 3-3",key:"x25e72"}],["path",{d:"M6 10V5a2 2 0 0 1 2-2h2",key:"15xut4"}],["rect",{x:"3",y:"14",width:"7",height:"7",rx:"1",key:"1bkyp8"}]],ReplaceAll=createLucideIcon("replace-all",__iconNode$6X);const __iconNode$6W=[["path",{d:"M14 4a1 1 0 0 1 1-1",key:"dhj8ez"}],["path",{d:"M15 10a1 1 0 0 1-1-1",key:"1mnyi5"}],["path",{d:"M21 4a1 1 0 0 0-1-1",key:"sfs9ap"}],["path",{d:"M21 9a1 1 0 0 1-1 1",key:"mp6qeo"}],["path",{d:"m3 7 3 3 3-3",key:"x25e72"}],["path",{d:"M6 10V5a2 2 0 0 1 2-2h2",key:"15xut4"}],["rect",{x:"3",y:"14",width:"7",height:"7",rx:"1",key:"1bkyp8"}]],Replace=createLucideIcon("replace",__iconNode$6W);const __iconNode$6V=[["path",{d:"m12 17-5-5 5-5",key:"1s3y5u"}],["path",{d:"M22 18v-2a4 4 0 0 0-4-4H7",key:"1fcyog"}],["path",{d:"m7 17-5-5 5-5",key:"1ed8i2"}]],ReplyAll=createLucideIcon("reply-all",__iconNode$6V);const __iconNode$6U=[["path",{d:"M20 18v-2a4 4 0 0 0-4-4H4",key:"5vmcpk"}],["path",{d:"m9 17-5-5 5-5",key:"nvlc11"}]],Reply=createLucideIcon("reply",__iconNode$6U);const __iconNode$6T=[["path",{d:"M12 6a2 2 0 0 0-3.414-1.414l-6 6a2 2 0 0 0 0 2.828l6 6A2 2 0 0 0 12 18z",key:"2a1g8i"}],["path",{d:"M22 6a2 2 0 0 0-3.414-1.414l-6 6a2 2 0 0 0 0 2.828l6 6A2 2 0 0 0 22 18z",key:"rg3s36"}]],Rewind=createLucideIcon("rewind",__iconNode$6T);const __iconNode$6S=[["path",{d:"M12 11.22C11 9.997 10 9 10 8a2 2 0 0 1 4 0c0 1-.998 2.002-2.01 3.22",key:"1rnhq3"}],["path",{d:"m12 18 2.57-3.5",key:"116vt7"}],["path",{d:"M6.243 9.016a7 7 0 0 1 11.507-.009",key:"10dq0b"}],["path",{d:"M9.35 14.53 12 11.22",key:"tdsyp2"}],["path",{d:"M9.35 14.53C7.728 12.246 6 10.221 6 7a6 5 0 0 1 12 0c-.005 3.22-1.778 5.235-3.43 7.5l3.557 4.527a1 1 0 0 1-.203 1.43l-1.894 1.36a1 1 0 0 1-1.384-.215L12 18l-2.679 3.593a1 1 0 0 1-1.39.213l-1.865-1.353a1 1 0 0 1-.203-1.422z",key:"nmifey"}]],Ribbon=createLucideIcon("ribbon",__iconNode$6S);const __iconNode$6R=[["path",{d:"M4.5 16.5c-1.5 1.26-2 5-2 5s3.74-.5 5-2c.71-.84.7-2.13-.09-2.91a2.18 2.18 0 0 0-2.91-.09z",key:"m3kijz"}],["path",{d:"m12 15-3-3a22 22 0 0 1 2-3.95A12.88 12.88 0 0 1 22 2c0 2.72-.78 7.5-6 11a22.35 22.35 0 0 1-4 2z",key:"1fmvmk"}],["path",{d:"M9 12H4s.55-3.03 2-4c1.62-1.08 5 0 5 0",key:"1f8sc4"}],["path",{d:"M12 15v5s3.03-.55 4-2c1.08-1.62 0-5 0-5",key:"qeys4"}]],Rocket=createLucideIcon("rocket",__iconNode$6R);const __iconNode$6Q=[["polyline",{points:"3.5 2 6.5 12.5 18 12.5",key:"y3iy52"}],["line",{x1:"9.5",x2:"5.5",y1:"12.5",y2:"20",key:"19vg5i"}],["line",{x1:"15",x2:"18.5",y1:"12.5",y2:"20",key:"1inpmv"}],["path",{d:"M2.75 18a13 13 0 0 0 18.5 0",key:"1nquas"}]],RockingChair=createLucideIcon("rocking-chair",__iconNode$6Q);const __iconNode$6P=[["path",{d:"M6 19V5",key:"1r845m"}],["path",{d:"M10 19V6.8",key:"9j2tfs"}],["path",{d:"M14 19v-7.8",key:"10s8qv"}],["path",{d:"M18 5v4",key:"1tajlv"}],["path",{d:"M18 19v-6",key:"ielfq3"}],["path",{d:"M22 19V9",key:"158nzp"}],["path",{d:"M2 19V9a4 4 0 0 1 4-4c2 0 4 1.33 6 4s4 4 6 4a4 4 0 1 0-3-6.65",key:"1930oh"}]],RollerCoaster=createLucideIcon("roller-coaster",__iconNode$6P);const __iconNode$6O=[["path",{d:"M17 10h-1a4 4 0 1 1 4-4v.534",key:"7qf5zm"}],["path",{d:"M17 6h1a4 4 0 0 1 1.42 7.74l-2.29.87a6 6 0 0 1-5.339-10.68l2.069-1.31",key:"1et29u"}],["path",{d:"M4.5 17c2.8-.5 4.4 0 5.5.8s1.8 2.2 2.3 3.7c-2 .4-3.5.4-4.8-.3-1.2-.6-2.3-1.9-3-4.2",key:"kiv2lz"}],["path",{d:"M9.77 12C4 15 2 22 2 22",key:"h28rw0"}],["circle",{cx:"17",cy:"8",r:"2",key:"1330xn"}]],Rose=createLucideIcon("rose",__iconNode$6O);const __iconNode$6N=[["path",{d:"M16.466 7.5C15.643 4.237 13.952 2 12 2 9.239 2 7 6.477 7 12s2.239 10 5 10c.342 0 .677-.069 1-.2",key:"10n0gc"}],["path",{d:"m15.194 13.707 3.814 1.86-1.86 3.814",key:"16shm9"}],["path",{d:"M19 15.57c-1.804.885-4.274 1.43-7 1.43-5.523 0-10-2.239-10-5s4.477-5 10-5c4.838 0 8.873 1.718 9.8 4",key:"1lxi77"}]],Rotate3d=createLucideIcon("rotate-3d",__iconNode$6N);const __iconNode$6M=[["path",{d:"m14.5 9.5 1 1",key:"159eiq"}],["path",{d:"m15.5 8.5-4 4",key:"iirg3q"}],["path",{d:"M3 12a9 9 0 1 0 9-9 9.74 9.74 0 0 0-6.74 2.74L3 8",key:"g2jlw"}],["path",{d:"M3 3v5h5",key:"1xhq8a"}],["circle",{cx:"10",cy:"14",r:"2",key:"1239so"}]],RotateCcwKey=createLucideIcon("rotate-ccw-key",__iconNode$6M);const __iconNode$6L=[["path",{d:"M20 9V7a2 2 0 0 0-2-2h-6",key:"19z8uc"}],["path",{d:"m15 2-3 3 3 3",key:"177bxs"}],["path",{d:"M20 13v5a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V7a2 2 0 0 1 2-2h2",key:"d36hnl"}]],RotateCcwSquare=createLucideIcon("rotate-ccw-square",__iconNode$6L);const __iconNode$6K=[["path",{d:"M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8",key:"1357e3"}],["path",{d:"M3 3v5h5",key:"1xhq8a"}]],RotateCcw=createLucideIcon("rotate-ccw",__iconNode$6K);const __iconNode$6J=[["path",{d:"M12 5H6a2 2 0 0 0-2 2v3",key:"l96uqu"}],["path",{d:"m9 8 3-3-3-3",key:"1gzgc3"}],["path",{d:"M4 14v4a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2h-2",key:"1w2k5h"}]],RotateCwSquare=createLucideIcon("rotate-cw-square",__iconNode$6J);const __iconNode$6I=[["path",{d:"M21 12a9 9 0 1 1-9-9c2.52 0 4.93 1 6.74 2.74L21 8",key:"1p45f6"}],["path",{d:"M21 3v5h-5",key:"1q7to0"}]],RotateCw=createLucideIcon("rotate-cw",__iconNode$6I);const __iconNode$6H=[["circle",{cx:"6",cy:"19",r:"3",key:"1kj8tv"}],["path",{d:"M9 19h8.5c.4 0 .9-.1 1.3-.2",key:"1effex"}],["path",{d:"M5.2 5.2A3.5 3.53 0 0 0 6.5 12H12",key:"k9y2ds"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M21 15.3a3.5 3.5 0 0 0-3.3-3.3",key:"11nlu2"}],["path",{d:"M15 5h-4.3",key:"6537je"}],["circle",{cx:"18",cy:"5",r:"3",key:"gq8acd"}]],RouteOff=createLucideIcon("route-off",__iconNode$6H);const __iconNode$6G=[["circle",{cx:"6",cy:"19",r:"3",key:"1kj8tv"}],["path",{d:"M9 19h8.5a3.5 3.5 0 0 0 0-7h-11a3.5 3.5 0 0 1 0-7H15",key:"1d8sl"}],["circle",{cx:"18",cy:"5",r:"3",key:"gq8acd"}]],Route=createLucideIcon("route",__iconNode$6G);const __iconNode$6F=[["rect",{width:"20",height:"8",x:"2",y:"14",rx:"2",key:"w68u3i"}],["path",{d:"M6.01 18H6",key:"19vcac"}],["path",{d:"M10.01 18H10",key:"uamcmx"}],["path",{d:"M15 10v4",key:"qjz1xs"}],["path",{d:"M17.84 7.17a4 4 0 0 0-5.66 0",key:"1rif40"}],["path",{d:"M20.66 4.34a8 8 0 0 0-11.31 0",key:"6a5xfq"}]],Router=createLucideIcon("router",__iconNode$6F);const __iconNode$6E=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M21 9H3",key:"1338ky"}],["path",{d:"M21 15H3",key:"9uk58r"}]],Rows3=createLucideIcon("rows-3",__iconNode$6E);const __iconNode$6D=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M3 12h18",key:"1i2n21"}]],Rows2=createLucideIcon("rows-2",__iconNode$6D);const __iconNode$6C=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M21 7.5H3",key:"1hm9pq"}],["path",{d:"M21 12H3",key:"2avoz0"}],["path",{d:"M21 16.5H3",key:"n7jzkj"}]],Rows4=createLucideIcon("rows-4",__iconNode$6C);const __iconNode$6B=[["path",{d:"M4 11a9 9 0 0 1 9 9",key:"pv89mb"}],["path",{d:"M4 4a16 16 0 0 1 16 16",key:"k0647b"}],["circle",{cx:"5",cy:"19",r:"1",key:"bfqh0e"}]],Rss=createLucideIcon("rss",__iconNode$6B);const __iconNode$6A=[["path",{d:"M10 15v-3",key:"1pjskw"}],["path",{d:"M14 15v-3",key:"1o1mqj"}],["path",{d:"M18 15v-3",key:"cws6he"}],["path",{d:"M2 8V4",key:"3jv1jz"}],["path",{d:"M22 6H2",key:"1iqbfk"}],["path",{d:"M22 8V4",key:"16f4ou"}],["path",{d:"M6 15v-3",key:"1ij1qe"}],["rect",{x:"2",y:"12",width:"20",height:"8",rx:"2",key:"1tqiko"}]],RulerDimensionLine=createLucideIcon("ruler-dimension-line",__iconNode$6A);const __iconNode$6z=[["path",{d:"M21.3 15.3a2.4 2.4 0 0 1 0 3.4l-2.6 2.6a2.4 2.4 0 0 1-3.4 0L2.7 8.7a2.41 2.41 0 0 1 0-3.4l2.6-2.6a2.41 2.41 0 0 1 3.4 0Z",key:"icamh8"}],["path",{d:"m14.5 12.5 2-2",key:"inckbg"}],["path",{d:"m11.5 9.5 2-2",key:"fmmyf7"}],["path",{d:"m8.5 6.5 2-2",key:"vc6u1g"}],["path",{d:"m17.5 15.5 2-2",key:"wo5hmg"}]],Ruler=createLucideIcon("ruler",__iconNode$6z);const __iconNode$6y=[["path",{d:"M10 2v15",key:"1qf71f"}],["path",{d:"M7 22a4 4 0 0 1-4-4 1 1 0 0 1 1-1h16a1 1 0 0 1 1 1 4 4 0 0 1-4 4z",key:"1pxcvx"}],["path",{d:"M9.159 2.46a1 1 0 0 1 1.521-.193l9.977 8.98A1 1 0 0 1 20 13H4a1 1 0 0 1-.824-1.567z",key:"5oog16"}]],Sailboat=createLucideIcon("sailboat",__iconNode$6y);const __iconNode$6x=[["path",{d:"M7 21h10",key:"1b0cd5"}],["path",{d:"M12 21a9 9 0 0 0 9-9H3a9 9 0 0 0 9 9Z",key:"4rw317"}],["path",{d:"M11.38 12a2.4 2.4 0 0 1-.4-4.77 2.4 2.4 0 0 1 3.2-2.77 2.4 2.4 0 0 1 3.47-.63 2.4 2.4 0 0 1 3.37 3.37 2.4 2.4 0 0 1-1.1 3.7 2.51 2.51 0 0 1 .03 1.1",key:"10xrj0"}],["path",{d:"m13 12 4-4",key:"1hckqy"}],["path",{d:"M10.9 7.25A3.99 3.99 0 0 0 4 10c0 .73.2 1.41.54 2",key:"1p4srx"}]],Salad=createLucideIcon("salad",__iconNode$6x);const __iconNode$6w=[["path",{d:"M6 11h8a4 4 0 0 0 0-8H9v18",key:"18ai8t"}],["path",{d:"M6 15h8",key:"1y8f6l"}]],RussianRuble=createLucideIcon("russian-ruble",__iconNode$6w);const __iconNode$6v=[["path",{d:"m2.37 11.223 8.372-6.777a2 2 0 0 1 2.516 0l8.371 6.777",key:"f1wd0e"}],["path",{d:"M21 15a1 1 0 0 1 1 1v2a1 1 0 0 1-1 1h-5.25",key:"1pfu07"}],["path",{d:"M3 15a1 1 0 0 0-1 1v2a1 1 0 0 0 1 1h9",key:"1oq9qw"}],["path",{d:"m6.67 15 6.13 4.6a2 2 0 0 0 2.8-.4l3.15-4.2",key:"1fnwu5"}],["rect",{width:"20",height:"4",x:"2",y:"11",rx:"1",key:"itshg"}]],Sandwich=createLucideIcon("sandwich",__iconNode$6v);const __iconNode$6u=[["path",{d:"M4 10a7.31 7.31 0 0 0 10 10Z",key:"1fzpp3"}],["path",{d:"m9 15 3-3",key:"88sc13"}],["path",{d:"M17 13a6 6 0 0 0-6-6",key:"15cc6u"}],["path",{d:"M21 13A10 10 0 0 0 11 3",key:"11nf8s"}]],SatelliteDish=createLucideIcon("satellite-dish",__iconNode$6u);const __iconNode$6t=[["path",{d:"m13.5 6.5-3.148-3.148a1.205 1.205 0 0 0-1.704 0L6.352 5.648a1.205 1.205 0 0 0 0 1.704L9.5 10.5",key:"dzhfyz"}],["path",{d:"M16.5 7.5 19 5",key:"1ltcjm"}],["path",{d:"m17.5 10.5 3.148 3.148a1.205 1.205 0 0 1 0 1.704l-2.296 2.296a1.205 1.205 0 0 1-1.704 0L13.5 14.5",key:"nfoymv"}],["path",{d:"M9 21a6 6 0 0 0-6-6",key:"1iajcf"}],["path",{d:"M9.352 10.648a1.205 1.205 0 0 0 0 1.704l2.296 2.296a1.205 1.205 0 0 0 1.704 0l4.296-4.296a1.205 1.205 0 0 0 0-1.704l-2.296-2.296a1.205 1.205 0 0 0-1.704 0z",key:"nv9zqy"}]],Satellite=createLucideIcon("satellite",__iconNode$6t);const __iconNode$6s=[["path",{d:"m20 19.5-5.5 1.2",key:"1aenhr"}],["path",{d:"M14.5 4v11.22a1 1 0 0 0 1.242.97L20 15.2",key:"2rtezt"}],["path",{d:"m2.978 19.351 5.549-1.363A2 2 0 0 0 10 16V2",key:"1kbm92"}],["path",{d:"M20 10 4 13.5",key:"8nums9"}]],SaudiRiyal=createLucideIcon("saudi-riyal",__iconNode$6s);const __iconNode$6r=[["path",{d:"M10 2v3a1 1 0 0 0 1 1h5",key:"1xspal"}],["path",{d:"M18 18v-6a1 1 0 0 0-1-1h-6a1 1 0 0 0-1 1v6",key:"1ra60u"}],["path",{d:"M18 22H4a2 2 0 0 1-2-2V6",key:"pblm9e"}],["path",{d:"M8 18a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9.172a2 2 0 0 1 1.414.586l2.828 2.828A2 2 0 0 1 22 6.828V16a2 2 0 0 1-2.01 2z",key:"1yve0x"}]],SaveAll=createLucideIcon("save-all",__iconNode$6r);const __iconNode$6q=[["path",{d:"M13 13H8a1 1 0 0 0-1 1v7",key:"h8g396"}],["path",{d:"M14 8h1",key:"1lfen6"}],["path",{d:"M17 21v-4",key:"1yknxs"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M20.41 20.41A2 2 0 0 1 19 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 .59-1.41",key:"1t4vdl"}],["path",{d:"M29.5 11.5s5 5 4 5",key:"zzn4i6"}],["path",{d:"M9 3h6.2a2 2 0 0 1 1.4.6l3.8 3.8a2 2 0 0 1 .6 1.4V15",key:"24cby9"}]],SaveOff=createLucideIcon("save-off",__iconNode$6q);const __iconNode$6p=[["path",{d:"M15.2 3a2 2 0 0 1 1.4.6l3.8 3.8a2 2 0 0 1 .6 1.4V19a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z",key:"1c8476"}],["path",{d:"M17 21v-7a1 1 0 0 0-1-1H8a1 1 0 0 0-1 1v7",key:"1ydtos"}],["path",{d:"M7 3v4a1 1 0 0 0 1 1h7",key:"t51u73"}]],Save=createLucideIcon("save",__iconNode$6p);const __iconNode$6o=[["path",{d:"M5 7v11a1 1 0 0 0 1 1h11",key:"13dt1j"}],["path",{d:"M5.293 18.707 11 13",key:"ezgbsx"}],["circle",{cx:"19",cy:"19",r:"2",key:"17f5cg"}],["circle",{cx:"5",cy:"5",r:"2",key:"1gwv83"}]],Scale3d=createLucideIcon("scale-3d",__iconNode$6o);const __iconNode$6n=[["path",{d:"m16 16 3-8 3 8c-.87.65-1.92 1-3 1s-2.13-.35-3-1Z",key:"7g6ntu"}],["path",{d:"m2 16 3-8 3 8c-.87.65-1.92 1-3 1s-2.13-.35-3-1Z",key:"ijws7r"}],["path",{d:"M7 21h10",key:"1b0cd5"}],["path",{d:"M12 3v18",key:"108xh3"}],["path",{d:"M3 7h2c2 0 5-1 7-2 2 1 5 2 7 2h2",key:"3gwbw2"}]],Scale=createLucideIcon("scale",__iconNode$6n);const __iconNode$6m=[["path",{d:"M12 3H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7",key:"1m0v6g"}],["path",{d:"M14 15H9v-5",key:"pi4jk9"}],["path",{d:"M16 3h5v5",key:"1806ms"}],["path",{d:"M21 3 9 15",key:"15kdhq"}]],Scaling=createLucideIcon("scaling",__iconNode$6m);const __iconNode$6l=[["path",{d:"M3 7V5a2 2 0 0 1 2-2h2",key:"aa7l1z"}],["path",{d:"M17 3h2a2 2 0 0 1 2 2v2",key:"4qcy5o"}],["path",{d:"M21 17v2a2 2 0 0 1-2 2h-2",key:"6vwrx8"}],["path",{d:"M7 21H5a2 2 0 0 1-2-2v-2",key:"ioqczr"}],["path",{d:"M8 7v10",key:"23sfjj"}],["path",{d:"M12 7v10",key:"jspqdw"}],["path",{d:"M17 7v10",key:"578dap"}]],ScanBarcode=createLucideIcon("scan-barcode",__iconNode$6l);const __iconNode$6k=[["path",{d:"M3 7V5a2 2 0 0 1 2-2h2",key:"aa7l1z"}],["path",{d:"M17 3h2a2 2 0 0 1 2 2v2",key:"4qcy5o"}],["path",{d:"M21 17v2a2 2 0 0 1-2 2h-2",key:"6vwrx8"}],["path",{d:"M7 21H5a2 2 0 0 1-2-2v-2",key:"ioqczr"}],["circle",{cx:"12",cy:"12",r:"1",key:"41hilf"}],["path",{d:"M18.944 12.33a1 1 0 0 0 0-.66 7.5 7.5 0 0 0-13.888 0 1 1 0 0 0 0 .66 7.5 7.5 0 0 0 13.888 0",key:"11ak4c"}]],ScanEye=createLucideIcon("scan-eye",__iconNode$6k);const __iconNode$6j=[["path",{d:"M3 7V5a2 2 0 0 1 2-2h2",key:"aa7l1z"}],["path",{d:"M17 3h2a2 2 0 0 1 2 2v2",key:"4qcy5o"}],["path",{d:"M21 17v2a2 2 0 0 1-2 2h-2",key:"6vwrx8"}],["path",{d:"M7 21H5a2 2 0 0 1-2-2v-2",key:"ioqczr"}],["path",{d:"M8 14s1.5 2 4 2 4-2 4-2",key:"1y1vjs"}],["path",{d:"M9 9h.01",key:"1q5me6"}],["path",{d:"M15 9h.01",key:"x1ddxp"}]],ScanFace=createLucideIcon("scan-face",__iconNode$6j);const __iconNode$6i=[["path",{d:"M17 3h2a2 2 0 0 1 2 2v2",key:"4qcy5o"}],["path",{d:"M21 17v2a2 2 0 0 1-2 2h-2",key:"6vwrx8"}],["path",{d:"M3 7V5a2 2 0 0 1 2-2h2",key:"aa7l1z"}],["path",{d:"M7 21H5a2 2 0 0 1-2-2v-2",key:"ioqczr"}],["path",{d:"M7.828 13.07A3 3 0 0 1 12 8.764a3 3 0 0 1 4.172 4.306l-3.447 3.62a1 1 0 0 1-1.449 0z",key:"1ak1ef"}]],ScanHeart=createLucideIcon("scan-heart",__iconNode$6i);const __iconNode$6h=[["path",{d:"M3 7V5a2 2 0 0 1 2-2h2",key:"aa7l1z"}],["path",{d:"M17 3h2a2 2 0 0 1 2 2v2",key:"4qcy5o"}],["path",{d:"M21 17v2a2 2 0 0 1-2 2h-2",key:"6vwrx8"}],["path",{d:"M7 21H5a2 2 0 0 1-2-2v-2",key:"ioqczr"}],["path",{d:"M7 12h10",key:"b7w52i"}]],ScanLine=createLucideIcon("scan-line",__iconNode$6h);const __iconNode$6g=[["path",{d:"M17 12v4a1 1 0 0 1-1 1h-4",key:"uk4fdo"}],["path",{d:"M17 3h2a2 2 0 0 1 2 2v2",key:"4qcy5o"}],["path",{d:"M17 8V7",key:"q2g9wo"}],["path",{d:"M21 17v2a2 2 0 0 1-2 2h-2",key:"6vwrx8"}],["path",{d:"M3 7V5a2 2 0 0 1 2-2h2",key:"aa7l1z"}],["path",{d:"M7 17h.01",key:"19xn7k"}],["path",{d:"M7 21H5a2 2 0 0 1-2-2v-2",key:"ioqczr"}],["rect",{x:"7",y:"7",width:"5",height:"5",rx:"1",key:"m9kyts"}]],ScanQrCode=createLucideIcon("scan-qr-code",__iconNode$6g);const __iconNode$6f=[["path",{d:"M3 7V5a2 2 0 0 1 2-2h2",key:"aa7l1z"}],["path",{d:"M17 3h2a2 2 0 0 1 2 2v2",key:"4qcy5o"}],["path",{d:"M21 17v2a2 2 0 0 1-2 2h-2",key:"6vwrx8"}],["path",{d:"M7 21H5a2 2 0 0 1-2-2v-2",key:"ioqczr"}],["path",{d:"M7 8h8",key:"1jbsf9"}],["path",{d:"M7 12h10",key:"b7w52i"}],["path",{d:"M7 16h6",key:"1vyc9m"}]],ScanText=createLucideIcon("scan-text",__iconNode$6f);const __iconNode$6e=[["path",{d:"M3 7V5a2 2 0 0 1 2-2h2",key:"aa7l1z"}],["path",{d:"M17 3h2a2 2 0 0 1 2 2v2",key:"4qcy5o"}],["path",{d:"M21 17v2a2 2 0 0 1-2 2h-2",key:"6vwrx8"}],["path",{d:"M7 21H5a2 2 0 0 1-2-2v-2",key:"ioqczr"}],["circle",{cx:"12",cy:"12",r:"3",key:"1v7zrd"}],["path",{d:"m16 16-1.9-1.9",key:"1dq9hf"}]],ScanSearch=createLucideIcon("scan-search",__iconNode$6e);const __iconNode$6d=[["path",{d:"M3 7V5a2 2 0 0 1 2-2h2",key:"aa7l1z"}],["path",{d:"M17 3h2a2 2 0 0 1 2 2v2",key:"4qcy5o"}],["path",{d:"M21 17v2a2 2 0 0 1-2 2h-2",key:"6vwrx8"}],["path",{d:"M7 21H5a2 2 0 0 1-2-2v-2",key:"ioqczr"}]],Scan=createLucideIcon("scan",__iconNode$6d);const __iconNode$6c=[["path",{d:"M14 21v-3a2 2 0 0 0-4 0v3",key:"1rgiei"}],["path",{d:"M18 5v16",key:"1ethyx"}],["path",{d:"m4 6 7.106-3.79a2 2 0 0 1 1.788 0L20 6",key:"zywc2d"}],["path",{d:"m6 11-3.52 2.147a1 1 0 0 0-.48.854V19a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-5a1 1 0 0 0-.48-.853L18 11",key:"1d4ql0"}],["path",{d:"M6 5v16",key:"1sn0nx"}],["circle",{cx:"12",cy:"9",r:"2",key:"1092wv"}]],School=createLucideIcon("school",__iconNode$6c);const __iconNode$6b=[["path",{d:"M5.42 9.42 8 12",key:"12pkuq"}],["circle",{cx:"4",cy:"8",r:"2",key:"107mxr"}],["path",{d:"m14 6-8.58 8.58",key:"gvzu5l"}],["circle",{cx:"4",cy:"16",r:"2",key:"1ehqvc"}],["path",{d:"M10.8 14.8 14 18",key:"ax7m9r"}],["path",{d:"M16 12h-2",key:"10asgb"}],["path",{d:"M22 12h-2",key:"14jgyd"}]],ScissorsLineDashed=createLucideIcon("scissors-line-dashed",__iconNode$6b);const __iconNode$6a=[["circle",{cx:"6",cy:"6",r:"3",key:"1lh9wr"}],["path",{d:"M8.12 8.12 12 12",key:"1alkpv"}],["path",{d:"M20 4 8.12 15.88",key:"xgtan2"}],["circle",{cx:"6",cy:"18",r:"3",key:"fqmcym"}],["path",{d:"M14.8 14.8 20 20",key:"ptml3r"}]],Scissors=createLucideIcon("scissors",__iconNode$6a);const __iconNode$69=[["path",{d:"M13 3H4a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-3",key:"i8wdob"}],["path",{d:"M8 21h8",key:"1ev6f3"}],["path",{d:"M12 17v4",key:"1riwvh"}],["path",{d:"m22 3-5 5",key:"12jva0"}],["path",{d:"m17 3 5 5",key:"k36vhe"}]],ScreenShareOff=createLucideIcon("screen-share-off",__iconNode$69);const __iconNode$68=[["path",{d:"M13 3H4a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-3",key:"i8wdob"}],["path",{d:"M8 21h8",key:"1ev6f3"}],["path",{d:"M12 17v4",key:"1riwvh"}],["path",{d:"m17 8 5-5",key:"fqif7o"}],["path",{d:"M17 3h5v5",key:"1o3tu8"}]],ScreenShare=createLucideIcon("screen-share",__iconNode$68);const __iconNode$67=[["path",{d:"M15 12h-5",key:"r7krc0"}],["path",{d:"M15 8h-5",key:"1khuty"}],["path",{d:"M19 17V5a2 2 0 0 0-2-2H4",key:"zz82l3"}],["path",{d:"M8 21h12a2 2 0 0 0 2-2v-1a1 1 0 0 0-1-1H11a1 1 0 0 0-1 1v1a2 2 0 1 1-4 0V5a2 2 0 1 0-4 0v2a1 1 0 0 0 1 1h3",key:"1ph1d7"}]],ScrollText=createLucideIcon("scroll-text",__iconNode$67);const __iconNode$66=[["path",{d:"M19 17V5a2 2 0 0 0-2-2H4",key:"zz82l3"}],["path",{d:"M8 21h12a2 2 0 0 0 2-2v-1a1 1 0 0 0-1-1H11a1 1 0 0 0-1 1v1a2 2 0 1 1-4 0V5a2 2 0 1 0-4 0v2a1 1 0 0 0 1 1h3",key:"1ph1d7"}]],Scroll=createLucideIcon("scroll",__iconNode$66);const __iconNode$65=[["path",{d:"m8 11 2 2 4-4",key:"1sed1v"}],["circle",{cx:"11",cy:"11",r:"8",key:"4ej97u"}],["path",{d:"m21 21-4.3-4.3",key:"1qie3q"}]],SearchCheck=createLucideIcon("search-check",__iconNode$65);const __iconNode$64=[["path",{d:"m13 13.5 2-2.5-2-2.5",key:"1rvxrh"}],["path",{d:"m21 21-4.3-4.3",key:"1qie3q"}],["path",{d:"M9 8.5 7 11l2 2.5",key:"6ffwbx"}],["circle",{cx:"11",cy:"11",r:"8",key:"4ej97u"}]],SearchCode=createLucideIcon("search-code",__iconNode$64);const __iconNode$63=[["path",{d:"m13.5 8.5-5 5",key:"1cs55j"}],["circle",{cx:"11",cy:"11",r:"8",key:"4ej97u"}],["path",{d:"m21 21-4.3-4.3",key:"1qie3q"}]],SearchSlash=createLucideIcon("search-slash",__iconNode$63);const __iconNode$62=[["path",{d:"m21 21-4.34-4.34",key:"14j7rj"}],["circle",{cx:"11",cy:"11",r:"8",key:"4ej97u"}]],Search=createLucideIcon("search",__iconNode$62);const __iconNode$61=[["path",{d:"m13.5 8.5-5 5",key:"1cs55j"}],["path",{d:"m8.5 8.5 5 5",key:"a8mexj"}],["circle",{cx:"11",cy:"11",r:"8",key:"4ej97u"}],["path",{d:"m21 21-4.3-4.3",key:"1qie3q"}]],SearchX=createLucideIcon("search-x",__iconNode$61);const __iconNode$60=[["path",{d:"M16 5a4 3 0 0 0-8 0c0 4 8 3 8 7a4 3 0 0 1-8 0",key:"vqan6v"}],["path",{d:"M8 19a4 3 0 0 0 8 0c0-4-8-3-8-7a4 3 0 0 1 8 0",key:"wdjd8o"}]],Section=createLucideIcon("section",__iconNode$60);const __iconNode$5$=[["path",{d:"M3.714 3.048a.498.498 0 0 0-.683.627l2.843 7.627a2 2 0 0 1 0 1.396l-2.842 7.627a.498.498 0 0 0 .682.627l18-8.5a.5.5 0 0 0 0-.904z",key:"117uat"}],["path",{d:"M6 12h16",key:"s4cdu5"}]],SendHorizontal=createLucideIcon("send-horizontal",__iconNode$5$);const __iconNode$5_=[["rect",{x:"14",y:"14",width:"8",height:"8",rx:"2",key:"1b0bso"}],["rect",{x:"2",y:"2",width:"8",height:"8",rx:"2",key:"1x09vl"}],["path",{d:"M7 14v1a2 2 0 0 0 2 2h1",key:"pao6x6"}],["path",{d:"M14 7h1a2 2 0 0 1 2 2v1",key:"19tdru"}]],SendToBack=createLucideIcon("send-to-back",__iconNode$5_);const __iconNode$5Z=[["path",{d:"M14.536 21.686a.5.5 0 0 0 .937-.024l6.5-19a.496.496 0 0 0-.635-.635l-19 6.5a.5.5 0 0 0-.024.937l7.93 3.18a2 2 0 0 1 1.112 1.11z",key:"1ffxy3"}],["path",{d:"m21.854 2.147-10.94 10.939",key:"12cjpa"}]],Send=createLucideIcon("send",__iconNode$5Z);const __iconNode$5Y=[["path",{d:"m16 16-4 4-4-4",key:"3dv8je"}],["path",{d:"M3 12h18",key:"1i2n21"}],["path",{d:"m8 8 4-4 4 4",key:"2bscm2"}]],SeparatorHorizontal=createLucideIcon("separator-horizontal",__iconNode$5Y);const __iconNode$5X=[["path",{d:"M12 3v18",key:"108xh3"}],["path",{d:"m16 16 4-4-4-4",key:"1js579"}],["path",{d:"m8 8-4 4 4 4",key:"1whems"}]],SeparatorVertical=createLucideIcon("separator-vertical",__iconNode$5X);const __iconNode$5W=[["path",{d:"m10.852 14.772-.383.923",key:"11vil6"}],["path",{d:"M13.148 14.772a3 3 0 1 0-2.296-5.544l-.383-.923",key:"1v3clb"}],["path",{d:"m13.148 9.228.383-.923",key:"t2zzyc"}],["path",{d:"m13.53 15.696-.382-.924a3 3 0 1 1-2.296-5.544",key:"1bxfiv"}],["path",{d:"m14.772 10.852.923-.383",key:"k9m8cz"}],["path",{d:"m14.772 13.148.923.383",key:"1xvhww"}],["path",{d:"M4.5 10H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v4a2 2 0 0 1-2 2h-.5",key:"tn8das"}],["path",{d:"M4.5 14H4a2 2 0 0 0-2 2v4a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-4a2 2 0 0 0-2-2h-.5",key:"1g2pve"}],["path",{d:"M6 18h.01",key:"uhywen"}],["path",{d:"M6 6h.01",key:"1utrut"}],["path",{d:"m9.228 10.852-.923-.383",key:"1wtb30"}],["path",{d:"m9.228 13.148-.923.383",key:"1a830x"}]],ServerCog=createLucideIcon("server-cog",__iconNode$5W);const __iconNode$5V=[["path",{d:"M7 2h13a2 2 0 0 1 2 2v4a2 2 0 0 1-2 2h-5",key:"bt2siv"}],["path",{d:"M10 10 2.5 2.5C2 2 2 2.5 2 5v3a2 2 0 0 0 2 2h6z",key:"1hjrv1"}],["path",{d:"M22 17v-1a2 2 0 0 0-2-2h-1",key:"1iynyr"}],["path",{d:"M4 14a2 2 0 0 0-2 2v4a2 2 0 0 0 2 2h16.5l1-.5.5.5-8-8H4z",key:"161ggg"}],["path",{d:"M6 18h.01",key:"uhywen"}],["path",{d:"m2 2 20 20",key:"1ooewy"}]],ServerOff=createLucideIcon("server-off",__iconNode$5V);const __iconNode$5U=[["path",{d:"M6 10H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v4a2 2 0 0 1-2 2h-2",key:"4b9dqc"}],["path",{d:"M6 14H4a2 2 0 0 0-2 2v4a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-4a2 2 0 0 0-2-2h-2",key:"22nnkd"}],["path",{d:"M6 6h.01",key:"1utrut"}],["path",{d:"M6 18h.01",key:"uhywen"}],["path",{d:"m13 6-4 6h6l-4 6",key:"14hqih"}]],ServerCrash=createLucideIcon("server-crash",__iconNode$5U);const __iconNode$5T=[["rect",{width:"20",height:"8",x:"2",y:"2",rx:"2",ry:"2",key:"ngkwjq"}],["rect",{width:"20",height:"8",x:"2",y:"14",rx:"2",ry:"2",key:"iecqi9"}],["line",{x1:"6",x2:"6.01",y1:"6",y2:"6",key:"16zg32"}],["line",{x1:"6",x2:"6.01",y1:"18",y2:"18",key:"nzw8ys"}]],Server=createLucideIcon("server",__iconNode$5T);const __iconNode$5S=[["path",{d:"M14 17H5",key:"gfn3mx"}],["path",{d:"M19 7h-9",key:"6i9tg"}],["circle",{cx:"17",cy:"17",r:"3",key:"18b49y"}],["circle",{cx:"7",cy:"7",r:"3",key:"dfmy0x"}]],Settings2=createLucideIcon("settings-2",__iconNode$5S);const __iconNode$5R=[["path",{d:"M9.671 4.136a2.34 2.34 0 0 1 4.659 0 2.34 2.34 0 0 0 3.319 1.915 2.34 2.34 0 0 1 2.33 4.033 2.34 2.34 0 0 0 0 3.831 2.34 2.34 0 0 1-2.33 4.033 2.34 2.34 0 0 0-3.319 1.915 2.34 2.34 0 0 1-4.659 0 2.34 2.34 0 0 0-3.32-1.915 2.34 2.34 0 0 1-2.33-4.033 2.34 2.34 0 0 0 0-3.831A2.34 2.34 0 0 1 6.35 6.051a2.34 2.34 0 0 0 3.319-1.915",key:"1i5ecw"}],["circle",{cx:"12",cy:"12",r:"3",key:"1v7zrd"}]],Settings=createLucideIcon("settings",__iconNode$5R);const __iconNode$5Q=[["path",{d:"M8.3 10a.7.7 0 0 1-.626-1.079L11.4 3a.7.7 0 0 1 1.198-.043L16.3 8.9a.7.7 0 0 1-.572 1.1Z",key:"1bo67w"}],["rect",{x:"3",y:"14",width:"7",height:"7",rx:"1",key:"1bkyp8"}],["circle",{cx:"17.5",cy:"17.5",r:"3.5",key:"w3z12y"}]],Shapes=createLucideIcon("shapes",__iconNode$5Q);const __iconNode$5P=[["circle",{cx:"18",cy:"5",r:"3",key:"gq8acd"}],["circle",{cx:"6",cy:"12",r:"3",key:"w7nqdw"}],["circle",{cx:"18",cy:"19",r:"3",key:"1xt0gg"}],["line",{x1:"8.59",x2:"15.42",y1:"13.51",y2:"17.49",key:"47mynk"}],["line",{x1:"15.41",x2:"8.59",y1:"6.51",y2:"10.49",key:"1n3mei"}]],Share2=createLucideIcon("share-2",__iconNode$5P);const __iconNode$5O=[["path",{d:"M12 2v13",key:"1km8f5"}],["path",{d:"m16 6-4-4-4 4",key:"13yo43"}],["path",{d:"M4 12v8a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-8",key:"1b2hhj"}]],Share=createLucideIcon("share",__iconNode$5O);const __iconNode$5N=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",ry:"2",key:"1m3agn"}],["line",{x1:"3",x2:"21",y1:"9",y2:"9",key:"1vqk6q"}],["line",{x1:"3",x2:"21",y1:"15",y2:"15",key:"o2sbyz"}],["line",{x1:"9",x2:"9",y1:"9",y2:"21",key:"1ib60c"}],["line",{x1:"15",x2:"15",y1:"9",y2:"21",key:"1n26ft"}]],Sheet=createLucideIcon("sheet",__iconNode$5N);const __iconNode$5M=[["path",{d:"M14 11a2 2 0 1 1-4 0 4 4 0 0 1 8 0 6 6 0 0 1-12 0 8 8 0 0 1 16 0 10 10 0 1 1-20 0 11.93 11.93 0 0 1 2.42-7.22 2 2 0 1 1 3.16 2.44",key:"1cn552"}]],Shell=createLucideIcon("shell",__iconNode$5M);const __iconNode$5L=[["path",{d:"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z",key:"oel41y"}],["path",{d:"M12 8v4",key:"1got3b"}],["path",{d:"M12 16h.01",key:"1drbdi"}]],ShieldAlert=createLucideIcon("shield-alert",__iconNode$5L);const __iconNode$5K=[["path",{d:"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z",key:"oel41y"}],["path",{d:"m4.243 5.21 14.39 12.472",key:"1c9a7c"}]],ShieldBan=createLucideIcon("shield-ban",__iconNode$5K);const __iconNode$5J=[["path",{d:"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z",key:"oel41y"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],ShieldCheck=createLucideIcon("shield-check",__iconNode$5J);const __iconNode$5I=[["path",{d:"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z",key:"oel41y"}],["path",{d:"M8 12h.01",key:"czm47f"}],["path",{d:"M12 12h.01",key:"1mp3jc"}],["path",{d:"M16 12h.01",key:"1l6xoz"}]],ShieldEllipsis=createLucideIcon("shield-ellipsis",__iconNode$5I);const __iconNode$5H=[["path",{d:"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z",key:"oel41y"}],["path",{d:"M12 22V2",key:"zs6s6o"}]],ShieldHalf=createLucideIcon("shield-half",__iconNode$5H);const __iconNode$5G=[["path",{d:"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z",key:"oel41y"}],["path",{d:"M9 12h6",key:"1c52cq"}]],ShieldMinus=createLucideIcon("shield-minus",__iconNode$5G);const __iconNode$5F=[["path",{d:"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z",key:"oel41y"}],["path",{d:"M9 12h6",key:"1c52cq"}],["path",{d:"M12 9v6",key:"199k2o"}]],ShieldPlus=createLucideIcon("shield-plus",__iconNode$5F);const __iconNode$5E=[["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M5 5a1 1 0 0 0-1 1v7c0 5 3.5 7.5 7.67 8.94a1 1 0 0 0 .67.01c2.35-.82 4.48-1.97 5.9-3.71",key:"1jlk70"}],["path",{d:"M9.309 3.652A12.252 12.252 0 0 0 11.24 2.28a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1v7a9.784 9.784 0 0 1-.08 1.264",key:"18rp1v"}]],ShieldOff=createLucideIcon("shield-off",__iconNode$5E);const __iconNode$5D=[["path",{d:"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z",key:"oel41y"}],["path",{d:"M6.376 18.91a6 6 0 0 1 11.249.003",key:"hnjrf2"}],["circle",{cx:"12",cy:"11",r:"4",key:"1gt34v"}]],ShieldUser=createLucideIcon("shield-user",__iconNode$5D);const __iconNode$5C=[["path",{d:"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z",key:"oel41y"}],["path",{d:"M9.1 9a3 3 0 0 1 5.82 1c0 2-3 3-3 3",key:"mhlwft"}],["path",{d:"M12 17h.01",key:"p32p05"}]],ShieldQuestionMark=createLucideIcon("shield-question-mark",__iconNode$5C);const __iconNode$5B=[["path",{d:"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z",key:"oel41y"}],["path",{d:"m14.5 9.5-5 5",key:"17q4r4"}],["path",{d:"m9.5 9.5 5 5",key:"18nt4w"}]],ShieldX=createLucideIcon("shield-x",__iconNode$5B);const __iconNode$5A=[["path",{d:"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z",key:"oel41y"}]],Shield=createLucideIcon("shield",__iconNode$5A);const __iconNode$5z=[["circle",{cx:"12",cy:"12",r:"8",key:"46899m"}],["path",{d:"M12 2v7.5",key:"1e5rl5"}],["path",{d:"m19 5-5.23 5.23",key:"1ezxxf"}],["path",{d:"M22 12h-7.5",key:"le1719"}],["path",{d:"m19 19-5.23-5.23",key:"p3fmgn"}],["path",{d:"M12 14.5V22",key:"dgcmos"}],["path",{d:"M10.23 13.77 5 19",key:"qwopd4"}],["path",{d:"M9.5 12H2",key:"r7bup8"}],["path",{d:"M10.23 10.23 5 5",key:"k2y7lj"}],["circle",{cx:"12",cy:"12",r:"2.5",key:"ix0uyj"}]],ShipWheel=createLucideIcon("ship-wheel",__iconNode$5z);const __iconNode$5y=[["path",{d:"M12 10.189V14",key:"1p8cqu"}],["path",{d:"M12 2v3",key:"qbqxhf"}],["path",{d:"M19 13V7a2 2 0 0 0-2-2H7a2 2 0 0 0-2 2v6",key:"qpkstq"}],["path",{d:"M19.38 20A11.6 11.6 0 0 0 21 14l-8.188-3.639a2 2 0 0 0-1.624 0L3 14a11.6 11.6 0 0 0 2.81 7.76",key:"7tigtc"}],["path",{d:"M2 21c.6.5 1.2 1 2.5 1 2.5 0 2.5-2 5-2 1.3 0 1.9.5 2.5 1s1.2 1 2.5 1c2.5 0 2.5-2 5-2 1.3 0 1.9.5 2.5 1",key:"1924j5"}]],Ship=createLucideIcon("ship",__iconNode$5y);const __iconNode$5x=[["path",{d:"M20.38 3.46 16 2a4 4 0 0 1-8 0L3.62 3.46a2 2 0 0 0-1.34 2.23l.58 3.47a1 1 0 0 0 .99.84H6v10c0 1.1.9 2 2 2h8a2 2 0 0 0 2-2V10h2.15a1 1 0 0 0 .99-.84l.58-3.47a2 2 0 0 0-1.34-2.23z",key:"1wgbhj"}]],Shirt=createLucideIcon("shirt",__iconNode$5x);const __iconNode$5w=[["path",{d:"M16 10a4 4 0 0 1-8 0",key:"1ltviw"}],["path",{d:"M3.103 6.034h17.794",key:"awc11p"}],["path",{d:"M3.4 5.467a2 2 0 0 0-.4 1.2V20a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V6.667a2 2 0 0 0-.4-1.2l-2-2.667A2 2 0 0 0 17 2H7a2 2 0 0 0-1.6.8z",key:"o988cm"}]],ShoppingBag=createLucideIcon("shopping-bag",__iconNode$5w);const __iconNode$5v=[["path",{d:"m15 11-1 9",key:"5wnq3a"}],["path",{d:"m19 11-4-7",key:"cnml18"}],["path",{d:"M2 11h20",key:"3eubbj"}],["path",{d:"m3.5 11 1.6 7.4a2 2 0 0 0 2 1.6h9.8a2 2 0 0 0 2-1.6l1.7-7.4",key:"yiazzp"}],["path",{d:"M4.5 15.5h15",key:"13mye1"}],["path",{d:"m5 11 4-7",key:"116ra9"}],["path",{d:"m9 11 1 9",key:"1ojof7"}]],ShoppingBasket=createLucideIcon("shopping-basket",__iconNode$5v);const __iconNode$5u=[["circle",{cx:"8",cy:"21",r:"1",key:"jimo8o"}],["circle",{cx:"19",cy:"21",r:"1",key:"13723u"}],["path",{d:"M2.05 2.05h2l2.66 12.42a2 2 0 0 0 2 1.58h9.78a2 2 0 0 0 1.95-1.57l1.65-7.43H5.12",key:"9zh506"}]],ShoppingCart=createLucideIcon("shopping-cart",__iconNode$5u);const __iconNode$5t=[["path",{d:"M21.56 4.56a1.5 1.5 0 0 1 0 2.122l-.47.47a3 3 0 0 1-4.212-.03 3 3 0 0 1 0-4.243l.44-.44a1.5 1.5 0 0 1 2.121 0z",key:"1gcedi"}],["path",{d:"M3 22a1 1 0 0 1-1-1v-3.586a1 1 0 0 1 .293-.707l3.355-3.355a1.205 1.205 0 0 1 1.704 0l3.296 3.296a1.205 1.205 0 0 1 0 1.704l-3.355 3.355a1 1 0 0 1-.707.293z",key:"pg9kv3"}],["path",{d:"m9 15 7.879-7.878",key:"1o1zgh"}]],Shovel=createLucideIcon("shovel",__iconNode$5t);const __iconNode$5s=[["path",{d:"m4 4 2.5 2.5",key:"uv2vmf"}],["path",{d:"M13.5 6.5a4.95 4.95 0 0 0-7 7",key:"frdkwv"}],["path",{d:"M15 5 5 15",key:"1ag8rq"}],["path",{d:"M14 17v.01",key:"eokfpp"}],["path",{d:"M10 16v.01",key:"14uyyl"}],["path",{d:"M13 13v.01",key:"1v1k97"}],["path",{d:"M16 10v.01",key:"5169yg"}],["path",{d:"M11 20v.01",key:"cj92p8"}],["path",{d:"M17 14v.01",key:"11cswd"}],["path",{d:"M20 11v.01",key:"19e0od"}]],ShowerHead=createLucideIcon("shower-head",__iconNode$5s);const __iconNode$5r=[["path",{d:"M4 13V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.706.706l3.588 3.588A2.4 2.4 0 0 1 20 8v5",key:"1eob4r"}],["path",{d:"M14 2v5a1 1 0 0 0 1 1h5",key:"wfsgrz"}],["path",{d:"M10 22v-5",key:"sfixh4"}],["path",{d:"M14 19v-2",key:"pdve8j"}],["path",{d:"M18 20v-3",key:"uox2gk"}],["path",{d:"M2 13h20",key:"5evz65"}],["path",{d:"M6 20v-3",key:"c6pdcb"}]],Shredder=createLucideIcon("shredder",__iconNode$5r);const __iconNode$5q=[["path",{d:"M11 12h.01",key:"1lr4k6"}],["path",{d:"M13 22c.5-.5 1.12-1 2.5-1-1.38 0-2-.5-2.5-1",key:"fatpdi"}],["path",{d:"M14 2a3.28 3.28 0 0 1-3.227 1.798l-6.17-.561A2.387 2.387 0 1 0 4.387 8H15.5a1 1 0 0 1 0 13 1 1 0 0 0 0-5H12a7 7 0 0 1-7-7V8",key:"kehrqe"}],["path",{d:"M14 8a8.5 8.5 0 0 1 0 8",key:"1imjx2"}],["path",{d:"M16 16c2 0 4.5-4 4-6",key:"z0nejz"}]],Shrimp=createLucideIcon("shrimp",__iconNode$5q);const __iconNode$5p=[["path",{d:"m15 15 6 6m-6-6v4.8m0-4.8h4.8",key:"17vawe"}],["path",{d:"M9 19.8V15m0 0H4.2M9 15l-6 6",key:"chjx8e"}],["path",{d:"M15 4.2V9m0 0h4.8M15 9l6-6",key:"lav6yq"}],["path",{d:"M9 4.2V9m0 0H4.2M9 9 3 3",key:"1pxi2q"}]],Shrink=createLucideIcon("shrink",__iconNode$5p);const __iconNode$5o=[["path",{d:"M12 22v-5.172a2 2 0 0 0-.586-1.414L9.5 13.5",key:"1p17fm"}],["path",{d:"M14.5 14.5 12 17",key:"dy5w4y"}],["path",{d:"M17 8.8A6 6 0 0 1 13.8 20H10A6.5 6.5 0 0 1 7 8a5 5 0 0 1 10 0z",key:"6z7b3o"}]],Shrub=createLucideIcon("shrub",__iconNode$5o);const __iconNode$5n=[["path",{d:"m18 14 4 4-4 4",key:"10pe0f"}],["path",{d:"m18 2 4 4-4 4",key:"pucp1d"}],["path",{d:"M2 18h1.973a4 4 0 0 0 3.3-1.7l5.454-8.6a4 4 0 0 1 3.3-1.7H22",key:"1ailkh"}],["path",{d:"M2 6h1.972a4 4 0 0 1 3.6 2.2",key:"km57vx"}],["path",{d:"M22 18h-6.041a4 4 0 0 1-3.3-1.8l-.359-.45",key:"os18l9"}]],Shuffle=createLucideIcon("shuffle",__iconNode$5n);const __iconNode$5m=[["path",{d:"M18 7V5a1 1 0 0 0-1-1H6.5a.5.5 0 0 0-.4.8l4.5 6a2 2 0 0 1 0 2.4l-4.5 6a.5.5 0 0 0 .4.8H17a1 1 0 0 0 1-1v-2",key:"wuwx1p"}]],Sigma=createLucideIcon("sigma",__iconNode$5m);const __iconNode$5l=[["path",{d:"M2 20h.01",key:"4haj6o"}],["path",{d:"M7 20v-4",key:"j294jx"}],["path",{d:"M12 20v-8",key:"i3yub9"}],["path",{d:"M17 20V8",key:"1tkaf5"}]],SignalHigh=createLucideIcon("signal-high",__iconNode$5l);const __iconNode$5k=[["path",{d:"M2 20h.01",key:"4haj6o"}],["path",{d:"M7 20v-4",key:"j294jx"}]],SignalLow=createLucideIcon("signal-low",__iconNode$5k);const __iconNode$5j=[["path",{d:"M2 20h.01",key:"4haj6o"}],["path",{d:"M7 20v-4",key:"j294jx"}],["path",{d:"M12 20v-8",key:"i3yub9"}]],SignalMedium=createLucideIcon("signal-medium",__iconNode$5j);const __iconNode$5i=[["path",{d:"M2 20h.01",key:"4haj6o"}]],SignalZero=createLucideIcon("signal-zero",__iconNode$5i);const __iconNode$5h=[["path",{d:"M2 20h.01",key:"4haj6o"}],["path",{d:"M7 20v-4",key:"j294jx"}],["path",{d:"M12 20v-8",key:"i3yub9"}],["path",{d:"M17 20V8",key:"1tkaf5"}],["path",{d:"M22 4v16",key:"sih9yq"}]],Signal=createLucideIcon("signal",__iconNode$5h);const __iconNode$5g=[["path",{d:"m21 17-2.156-1.868A.5.5 0 0 0 18 15.5v.5a1 1 0 0 1-1 1h-2a1 1 0 0 1-1-1c0-2.545-3.991-3.97-8.5-4a1 1 0 0 0 0 5c4.153 0 4.745-11.295 5.708-13.5a2.5 2.5 0 1 1 3.31 3.284",key:"y32ogt"}],["path",{d:"M3 21h18",key:"itz85i"}]],Signature=createLucideIcon("signature",__iconNode$5g);const __iconNode$5f=[["path",{d:"M10 9H4L2 7l2-2h6",key:"1hq7x2"}],["path",{d:"M14 5h6l2 2-2 2h-6",key:"bv62ej"}],["path",{d:"M10 22V4a2 2 0 1 1 4 0v18",key:"eqpcf2"}],["path",{d:"M8 22h8",key:"rmew8v"}]],SignpostBig=createLucideIcon("signpost-big",__iconNode$5f);const __iconNode$5e=[["path",{d:"M12 13v8",key:"1l5pq0"}],["path",{d:"M12 3v3",key:"1n5kay"}],["path",{d:"M18 6a2 2 0 0 1 1.387.56l2.307 2.22a1 1 0 0 1 0 1.44l-2.307 2.22A2 2 0 0 1 18 13H6a2 2 0 0 1-1.387-.56l-2.306-2.22a1 1 0 0 1 0-1.44l2.306-2.22A2 2 0 0 1 6 6z",key:"gqqp9m"}]],Signpost=createLucideIcon("signpost",__iconNode$5e);const __iconNode$5d=[["path",{d:"M7 18v-6a5 5 0 1 1 10 0v6",key:"pcx96s"}],["path",{d:"M5 21a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-1a2 2 0 0 0-2-2H7a2 2 0 0 0-2 2z",key:"1b4s83"}],["path",{d:"M21 12h1",key:"jtio3y"}],["path",{d:"M18.5 4.5 18 5",key:"g5sp9y"}],["path",{d:"M2 12h1",key:"1uaihz"}],["path",{d:"M12 2v1",key:"11qlp1"}],["path",{d:"m4.929 4.929.707.707",key:"1i51kw"}],["path",{d:"M12 12v6",key:"3ahymv"}]],Siren=createLucideIcon("siren",__iconNode$5d);const __iconNode$5c=[["path",{d:"M17.971 4.285A2 2 0 0 1 21 6v12a2 2 0 0 1-3.029 1.715l-9.997-5.998a2 2 0 0 1-.003-3.432z",key:"15892j"}],["path",{d:"M3 20V4",key:"1ptbpl"}]],SkipBack=createLucideIcon("skip-back",__iconNode$5c);const __iconNode$5b=[["path",{d:"M21 4v16",key:"7j8fe9"}],["path",{d:"M6.029 4.285A2 2 0 0 0 3 6v12a2 2 0 0 0 3.029 1.715l9.997-5.998a2 2 0 0 0 .003-3.432z",key:"zs4d6"}]],SkipForward=createLucideIcon("skip-forward",__iconNode$5b);const __iconNode$5a=[["path",{d:"m12.5 17-.5-1-.5 1h1z",key:"3me087"}],["path",{d:"M15 22a1 1 0 0 0 1-1v-1a2 2 0 0 0 1.56-3.25 8 8 0 1 0-11.12 0A2 2 0 0 0 8 20v1a1 1 0 0 0 1 1z",key:"1o5pge"}],["circle",{cx:"15",cy:"12",r:"1",key:"1tmaij"}],["circle",{cx:"9",cy:"12",r:"1",key:"1vctgf"}]],Skull=createLucideIcon("skull",__iconNode$5a);const __iconNode$59=[["rect",{width:"3",height:"8",x:"13",y:"2",rx:"1.5",key:"diqz80"}],["path",{d:"M19 8.5V10h1.5A1.5 1.5 0 1 0 19 8.5",key:"183iwg"}],["rect",{width:"3",height:"8",x:"8",y:"14",rx:"1.5",key:"hqg7r1"}],["path",{d:"M5 15.5V14H3.5A1.5 1.5 0 1 0 5 15.5",key:"76g71w"}],["rect",{width:"8",height:"3",x:"14",y:"13",rx:"1.5",key:"1kmz0a"}],["path",{d:"M15.5 19H14v1.5a1.5 1.5 0 1 0 1.5-1.5",key:"jc4sz0"}],["rect",{width:"8",height:"3",x:"2",y:"8",rx:"1.5",key:"1omvl4"}],["path",{d:"M8.5 5H10V3.5A1.5 1.5 0 1 0 8.5 5",key:"16f3cl"}]],Slack=createLucideIcon("slack",__iconNode$59);const __iconNode$58=[["path",{d:"M22 2 2 22",key:"y4kqgn"}]],Slash=createLucideIcon("slash",__iconNode$58);const __iconNode$57=[["path",{d:"M11 16.586V19a1 1 0 0 1-1 1H2L18.37 3.63a1 1 0 1 1 3 3l-9.663 9.663a1 1 0 0 1-1.414 0L8 14",key:"1sllp5"}]],Slice=createLucideIcon("slice",__iconNode$57);const __iconNode$56=[["path",{d:"M10 5H3",key:"1qgfaw"}],["path",{d:"M12 19H3",key:"yhmn1j"}],["path",{d:"M14 3v4",key:"1sua03"}],["path",{d:"M16 17v4",key:"1q0r14"}],["path",{d:"M21 12h-9",key:"1o4lsq"}],["path",{d:"M21 19h-5",key:"1rlt1p"}],["path",{d:"M21 5h-7",key:"1oszz2"}],["path",{d:"M8 10v4",key:"tgpxqk"}],["path",{d:"M8 12H3",key:"a7s4jb"}]],SlidersHorizontal=createLucideIcon("sliders-horizontal",__iconNode$56);const __iconNode$55=[["path",{d:"M10 8h4",key:"1sr2af"}],["path",{d:"M12 21v-9",key:"17s77i"}],["path",{d:"M12 8V3",key:"13r4qs"}],["path",{d:"M17 16h4",key:"h1uq16"}],["path",{d:"M19 12V3",key:"o1uvq1"}],["path",{d:"M19 21v-5",key:"qua636"}],["path",{d:"M3 14h4",key:"bcjad9"}],["path",{d:"M5 10V3",key:"cb8scm"}],["path",{d:"M5 21v-7",key:"1w1uti"}]],SlidersVertical=createLucideIcon("sliders-vertical",__iconNode$55);const __iconNode$54=[["rect",{width:"14",height:"20",x:"5",y:"2",rx:"2",ry:"2",key:"1yt0o3"}],["path",{d:"M12.667 8 10 12h4l-2.667 4",key:"h9lk2d"}]],SmartphoneCharging=createLucideIcon("smartphone-charging",__iconNode$54);const __iconNode$53=[["rect",{width:"7",height:"12",x:"2",y:"6",rx:"1",key:"5nje8w"}],["path",{d:"M13 8.32a7.43 7.43 0 0 1 0 7.36",key:"1g306n"}],["path",{d:"M16.46 6.21a11.76 11.76 0 0 1 0 11.58",key:"uqvjvo"}],["path",{d:"M19.91 4.1a15.91 15.91 0 0 1 .01 15.8",key:"ujntz3"}]],SmartphoneNfc=createLucideIcon("smartphone-nfc",__iconNode$53);const __iconNode$52=[["path",{d:"M22 11v1a10 10 0 1 1-9-10",key:"ew0xw9"}],["path",{d:"M8 14s1.5 2 4 2 4-2 4-2",key:"1y1vjs"}],["line",{x1:"9",x2:"9.01",y1:"9",y2:"9",key:"yxxnd0"}],["line",{x1:"15",x2:"15.01",y1:"9",y2:"9",key:"1p4y9e"}],["path",{d:"M16 5h6",key:"1vod17"}],["path",{d:"M19 2v6",key:"4bpg5p"}]],SmilePlus=createLucideIcon("smile-plus",__iconNode$52);const __iconNode$51=[["rect",{width:"14",height:"20",x:"5",y:"2",rx:"2",ry:"2",key:"1yt0o3"}],["path",{d:"M12 18h.01",key:"mhygvu"}]],Smartphone=createLucideIcon("smartphone",__iconNode$51);const __iconNode$50=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M8 14s1.5 2 4 2 4-2 4-2",key:"1y1vjs"}],["line",{x1:"9",x2:"9.01",y1:"9",y2:"9",key:"yxxnd0"}],["line",{x1:"15",x2:"15.01",y1:"9",y2:"9",key:"1p4y9e"}]],Smile=createLucideIcon("smile",__iconNode$50);const __iconNode$4$=[["path",{d:"M2 13a6 6 0 1 0 12 0 4 4 0 1 0-8 0 2 2 0 0 0 4 0",key:"hneq2s"}],["circle",{cx:"10",cy:"13",r:"8",key:"194lz3"}],["path",{d:"M2 21h12c4.4 0 8-3.6 8-8V7a2 2 0 1 0-4 0v6",key:"ixqyt7"}],["path",{d:"M18 3 19.1 5.2",key:"9tjm43"}],["path",{d:"M22 3 20.9 5.2",key:"j3odrs"}]],Snail=createLucideIcon("snail",__iconNode$4$);const __iconNode$4_=[["path",{d:"m10 20-1.25-2.5L6 18",key:"18frcb"}],["path",{d:"M10 4 8.75 6.5 6 6",key:"7mghy3"}],["path",{d:"m14 20 1.25-2.5L18 18",key:"1chtki"}],["path",{d:"m14 4 1.25 2.5L18 6",key:"1b4wsy"}],["path",{d:"m17 21-3-6h-4",key:"15hhxa"}],["path",{d:"m17 3-3 6 1.5 3",key:"11697g"}],["path",{d:"M2 12h6.5L10 9",key:"kv9z4n"}],["path",{d:"m20 10-1.5 2 1.5 2",key:"1swlpi"}],["path",{d:"M22 12h-6.5L14 15",key:"1mxi28"}],["path",{d:"m4 10 1.5 2L4 14",key:"k9enpj"}],["path",{d:"m7 21 3-6-1.5-3",key:"j8hb9u"}],["path",{d:"m7 3 3 6h4",key:"1otusx"}]],Snowflake=createLucideIcon("snowflake",__iconNode$4_);const __iconNode$4Z=[["path",{d:"M10.5 2v4",key:"1xt6in"}],["path",{d:"M14 2H7a2 2 0 0 0-2 2",key:"e6xig3"}],["path",{d:"M19.29 14.76A6.67 6.67 0 0 1 17 11a6.6 6.6 0 0 1-2.29 3.76c-1.15.92-1.71 2.04-1.71 3.19 0 2.22 1.8 4.05 4 4.05s4-1.83 4-4.05c0-1.16-.57-2.26-1.71-3.19",key:"adq7uc"}],["path",{d:"M9.607 21H6a2 2 0 0 1-2-2v-7a2 2 0 0 1 2-2h7V7a1 1 0 0 0-1-1H9a1 1 0 0 0-1 1v3",key:"t9hm96"}]],SoapDispenserDroplet=createLucideIcon("soap-dispenser-droplet",__iconNode$4Z);const __iconNode$4Y=[["path",{d:"M20 9V6a2 2 0 0 0-2-2H6a2 2 0 0 0-2 2v3",key:"1dgpiv"}],["path",{d:"M2 16a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-5a2 2 0 0 0-4 0v1.5a.5.5 0 0 1-.5.5h-11a.5.5 0 0 1-.5-.5V11a2 2 0 0 0-4 0z",key:"xacw8m"}],["path",{d:"M4 18v2",key:"jwo5n2"}],["path",{d:"M20 18v2",key:"1ar1qi"}],["path",{d:"M12 4v9",key:"oqhhn3"}]],Sofa=createLucideIcon("sofa",__iconNode$4Y);const __iconNode$4X=[["path",{d:"M11 2h2",key:"isr7bz"}],["path",{d:"m14.28 14-4.56 8",key:"4anwcf"}],["path",{d:"m21 22-1.558-4H4.558",key:"enk13h"}],["path",{d:"M3 10v2",key:"w8mti9"}],["path",{d:"M6.245 15.04A2 2 0 0 1 8 14h12a1 1 0 0 1 .864 1.505l-3.11 5.457A2 2 0 0 1 16 22H4a1 1 0 0 1-.863-1.506z",key:"pouggg"}],["path",{d:"M7 2a4 4 0 0 1-4 4",key:"78s8of"}],["path",{d:"m8.66 7.66 1.41 1.41",key:"1vaqj8"}]],SolarPanel=createLucideIcon("solar-panel",__iconNode$4X);const __iconNode$4W=[["path",{d:"M22 17v1c0 .5-.5 1-1 1H3c-.5 0-1-.5-1-1v-1",key:"lt2kga"}]],Space=createLucideIcon("space",__iconNode$4W);const __iconNode$4V=[["path",{d:"M12 21a9 9 0 0 0 9-9H3a9 9 0 0 0 9 9Z",key:"4rw317"}],["path",{d:"M7 21h10",key:"1b0cd5"}],["path",{d:"M19.5 12 22 6",key:"shfsr5"}],["path",{d:"M16.25 3c.27.1.8.53.75 1.36-.06.83-.93 1.2-1 2.02-.05.78.34 1.24.73 1.62",key:"rpc6vp"}],["path",{d:"M11.25 3c.27.1.8.53.74 1.36-.05.83-.93 1.2-.98 2.02-.06.78.33 1.24.72 1.62",key:"1lf63m"}],["path",{d:"M6.25 3c.27.1.8.53.75 1.36-.06.83-.93 1.2-1 2.02-.05.78.34 1.24.74 1.62",key:"97tijn"}]],Soup=createLucideIcon("soup",__iconNode$4V);const __iconNode$4U=[["path",{d:"M12 18v4",key:"jadmvz"}],["path",{d:"M2 14.499a5.5 5.5 0 0 0 9.591 3.675.6.6 0 0 1 .818.001A5.5 5.5 0 0 0 22 14.5c0-2.29-1.5-4-3-5.5l-5.492-5.312a2 2 0 0 0-3-.02L5 8.999c-1.5 1.5-3 3.2-3 5.5",key:"1aw2pz"}]],Spade=createLucideIcon("spade",__iconNode$4U);const __iconNode$4T=[["path",{d:"M11.017 2.814a1 1 0 0 1 1.966 0l1.051 5.558a2 2 0 0 0 1.594 1.594l5.558 1.051a1 1 0 0 1 0 1.966l-5.558 1.051a2 2 0 0 0-1.594 1.594l-1.051 5.558a1 1 0 0 1-1.966 0l-1.051-5.558a2 2 0 0 0-1.594-1.594l-5.558-1.051a1 1 0 0 1 0-1.966l5.558-1.051a2 2 0 0 0 1.594-1.594z",key:"1s2grr"}]],Sparkle=createLucideIcon("sparkle",__iconNode$4T);const __iconNode$4S=[["path",{d:"M11.017 2.814a1 1 0 0 1 1.966 0l1.051 5.558a2 2 0 0 0 1.594 1.594l5.558 1.051a1 1 0 0 1 0 1.966l-5.558 1.051a2 2 0 0 0-1.594 1.594l-1.051 5.558a1 1 0 0 1-1.966 0l-1.051-5.558a2 2 0 0 0-1.594-1.594l-5.558-1.051a1 1 0 0 1 0-1.966l5.558-1.051a2 2 0 0 0 1.594-1.594z",key:"1s2grr"}],["path",{d:"M20 2v4",key:"1rf3ol"}],["path",{d:"M22 4h-4",key:"gwowj6"}],["circle",{cx:"4",cy:"20",r:"2",key:"6kqj1y"}]],Sparkles=createLucideIcon("sparkles",__iconNode$4S);const __iconNode$4R=[["rect",{width:"16",height:"20",x:"4",y:"2",rx:"2",key:"1nb95v"}],["path",{d:"M12 6h.01",key:"1vi96p"}],["circle",{cx:"12",cy:"14",r:"4",key:"1jruaj"}],["path",{d:"M12 14h.01",key:"1etili"}]],Speaker=createLucideIcon("speaker",__iconNode$4R);const __iconNode$4Q=[["path",{d:"M8.8 20v-4.1l1.9.2a2.3 2.3 0 0 0 2.164-2.1V8.3A5.37 5.37 0 0 0 2 8.25c0 2.8.656 3.054 1 4.55a5.77 5.77 0 0 1 .029 2.758L2 20",key:"11atix"}],["path",{d:"M19.8 17.8a7.5 7.5 0 0 0 .003-10.603",key:"yol142"}],["path",{d:"M17 15a3.5 3.5 0 0 0-.025-4.975",key:"ssbmkc"}]],Speech=createLucideIcon("speech",__iconNode$4Q);const __iconNode$4P=[["path",{d:"m6 16 6-12 6 12",key:"1b4byz"}],["path",{d:"M8 12h8",key:"1wcyev"}],["path",{d:"m16 20 2 2 4-4",key:"13tcca"}]],SpellCheck=createLucideIcon("spell-check",__iconNode$4P);const __iconNode$4O=[["path",{d:"m6 16 6-12 6 12",key:"1b4byz"}],["path",{d:"M8 12h8",key:"1wcyev"}],["path",{d:"M4 21c1.1 0 1.1-1 2.3-1s1.1 1 2.3 1c1.1 0 1.1-1 2.3-1 1.1 0 1.1 1 2.3 1 1.1 0 1.1-1 2.3-1 1.1 0 1.1 1 2.3 1 1.1 0 1.1-1 2.3-1",key:"8mdmtu"}]],SpellCheck2=createLucideIcon("spell-check-2",__iconNode$4O);const __iconNode$4N=[["path",{d:"M12.034 12.681a.498.498 0 0 1 .647-.647l9 3.5a.5.5 0 0 1-.033.943l-3.444 1.068a1 1 0 0 0-.66.66l-1.067 3.443a.5.5 0 0 1-.943.033z",key:"xwnzip"}],["path",{d:"M5 17A12 12 0 0 1 17 5",key:"1okkup"}],["circle",{cx:"19",cy:"5",r:"2",key:"mhkx31"}],["circle",{cx:"5",cy:"19",r:"2",key:"v8kfzx"}]],SplinePointer=createLucideIcon("spline-pointer",__iconNode$4N);const __iconNode$4M=[["circle",{cx:"19",cy:"5",r:"2",key:"mhkx31"}],["circle",{cx:"5",cy:"19",r:"2",key:"v8kfzx"}],["path",{d:"M5 17A12 12 0 0 1 17 5",key:"1okkup"}]],Spline=createLucideIcon("spline",__iconNode$4M);const __iconNode$4L=[["path",{d:"M16 3h5v5",key:"1806ms"}],["path",{d:"M8 3H3v5",key:"15dfkv"}],["path",{d:"M12 22v-8.3a4 4 0 0 0-1.172-2.872L3 3",key:"1qrqzj"}],["path",{d:"m15 9 6-6",key:"ko1vev"}]],Split=createLucideIcon("split",__iconNode$4L);const __iconNode$4K=[["path",{d:"M17 13.44 4.442 17.082A2 2 0 0 0 4.982 21H19a2 2 0 0 0 .558-3.921l-1.115-.32A2 2 0 0 1 17 14.837V7.66",key:"13vns8"}],["path",{d:"m7 10.56 12.558-3.642A2 2 0 0 0 19.018 3H5a2 2 0 0 0-.558 3.921l1.115.32A2 2 0 0 1 7 9.163v7.178",key:"s8x3u0"}]],Spool=createLucideIcon("spool",__iconNode$4K);const __iconNode$4J=[["path",{d:"M15.295 19.562 16 22",key:"31jsb7"}],["path",{d:"m17 16 3.758 2.098",key:"121ar7"}],["path",{d:"m19 12.5 3.026-.598",key:"19ukd3"}],["path",{d:"M7.61 6.3a3 3 0 0 0-3.92 1.3l-1.38 2.79a3 3 0 0 0 1.3 3.91l6.89 3.597a1 1 0 0 0 1.342-.447l3.106-6.211a1 1 0 0 0-.447-1.341z",key:"lwb9l9"}],["path",{d:"M8 9V2",key:"1xa0v7"}]],Spotlight=createLucideIcon("spotlight",__iconNode$4J);const __iconNode$4I=[["path",{d:"M3 3h.01",key:"159qn6"}],["path",{d:"M7 5h.01",key:"1hq22a"}],["path",{d:"M11 7h.01",key:"1osv80"}],["path",{d:"M3 7h.01",key:"1xzrh3"}],["path",{d:"M7 9h.01",key:"19b3jx"}],["path",{d:"M3 11h.01",key:"1eifu7"}],["rect",{width:"4",height:"4",x:"15",y:"5",key:"mri9e4"}],["path",{d:"m19 9 2 2v10c0 .6-.4 1-1 1h-6c-.6 0-1-.4-1-1V11l2-2",key:"aib6hk"}],["path",{d:"m13 14 8-2",key:"1d7bmk"}],["path",{d:"m13 19 8-2",key:"1y2vml"}]],SprayCan=createLucideIcon("spray-can",__iconNode$4I);const __iconNode$4H=[["path",{d:"M14 9.536V7a4 4 0 0 1 4-4h1.5a.5.5 0 0 1 .5.5V5a4 4 0 0 1-4 4 4 4 0 0 0-4 4c0 2 1 3 1 5a5 5 0 0 1-1 3",key:"139s4v"}],["path",{d:"M4 9a5 5 0 0 1 8 4 5 5 0 0 1-8-4",key:"1dlkgp"}],["path",{d:"M5 21h14",key:"11awu3"}]],Sprout=createLucideIcon("sprout",__iconNode$4H);const __iconNode$4G=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M17 12h-2l-2 5-2-10-2 5H7",key:"15hlnc"}]],SquareActivity=createLucideIcon("square-activity",__iconNode$4G);const __iconNode$4F=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"m16 8-8 8",key:"166keh"}],["path",{d:"M16 16H8V8",key:"1w2ppm"}]],SquareArrowDownLeft=createLucideIcon("square-arrow-down-left",__iconNode$4F);const __iconNode$4E=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"m8 8 8 8",key:"1imecy"}],["path",{d:"M16 8v8H8",key:"1lbpgo"}]],SquareArrowDownRight=createLucideIcon("square-arrow-down-right",__iconNode$4E);const __iconNode$4D=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M12 8v8",key:"napkw2"}],["path",{d:"m8 12 4 4 4-4",key:"k98ssh"}]],SquareArrowDown=createLucideIcon("square-arrow-down",__iconNode$4D);const __iconNode$4C=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"m12 8-4 4 4 4",key:"15vm53"}],["path",{d:"M16 12H8",key:"1fr5h0"}]],SquareArrowLeft=createLucideIcon("square-arrow-left",__iconNode$4C);const __iconNode$4B=[["path",{d:"M13 21h6a2 2 0 0 0 2-2V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v6",key:"14qz4y"}],["path",{d:"m3 21 9-9",key:"1jfql5"}],["path",{d:"M9 21H3v-6",key:"wtvkvv"}]],SquareArrowOutDownLeft=createLucideIcon("square-arrow-out-down-left",__iconNode$4B);const __iconNode$4A=[["path",{d:"M21 11V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h6",key:"14rsvq"}],["path",{d:"m21 21-9-9",key:"1et2py"}],["path",{d:"M21 15v6h-6",key:"1jko0i"}]],SquareArrowOutDownRight=createLucideIcon("square-arrow-out-down-right",__iconNode$4A);const __iconNode$4z=[["path",{d:"M13 3h6a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-6",key:"14mv1t"}],["path",{d:"m3 3 9 9",key:"rks13r"}],["path",{d:"M3 9V3h6",key:"ira0h2"}]],SquareArrowOutUpLeft=createLucideIcon("square-arrow-out-up-left",__iconNode$4z);const __iconNode$4y=[["path",{d:"M21 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h6",key:"y09zxi"}],["path",{d:"m21 3-9 9",key:"mpx6sq"}],["path",{d:"M15 3h6v6",key:"1q9fwt"}]],SquareArrowOutUpRight=createLucideIcon("square-arrow-out-up-right",__iconNode$4y);const __iconNode$4x=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M8 12h8",key:"1wcyev"}],["path",{d:"m12 16 4-4-4-4",key:"1i9zcv"}]],SquareArrowRight=createLucideIcon("square-arrow-right",__iconNode$4x);const __iconNode$4w=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M8 16V8h8",key:"19xb1h"}],["path",{d:"M16 16 8 8",key:"1qdy8n"}]],SquareArrowUpLeft=createLucideIcon("square-arrow-up-left",__iconNode$4w);const __iconNode$4v=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M8 8h8v8",key:"b65dnt"}],["path",{d:"m8 16 8-8",key:"13b9ih"}]],SquareArrowUpRight=createLucideIcon("square-arrow-up-right",__iconNode$4v);const __iconNode$4u=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"m16 12-4-4-4 4",key:"177agl"}],["path",{d:"M12 16V8",key:"1sbj14"}]],SquareArrowUp=createLucideIcon("square-arrow-up",__iconNode$4u);const __iconNode$4t=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M12 8v8",key:"napkw2"}],["path",{d:"m8.5 14 7-4",key:"12hpby"}],["path",{d:"m8.5 10 7 4",key:"wwy2dy"}]],SquareAsterisk=createLucideIcon("square-asterisk",__iconNode$4t);const __iconNode$4s=[["path",{d:"M4 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v16a2 2 0 0 1-2 2",key:"1vzg26"}],["path",{d:"M10 22H8",key:"euku7a"}],["path",{d:"M16 22h-2",key:"18d249"}],["circle",{cx:"8",cy:"8",r:"2",key:"14cg06"}],["path",{d:"M9.414 9.414 12 12",key:"qz4lzr"}],["path",{d:"M14.8 14.8 18 18",key:"11flf1"}],["circle",{cx:"8",cy:"16",r:"2",key:"1acxsx"}],["path",{d:"m18 6-8.586 8.586",key:"11kzk1"}]],SquareBottomDashedScissors=createLucideIcon("square-bottom-dashed-scissors",__iconNode$4s);const __iconNode$4r=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M9 8h7",key:"kbo1nt"}],["path",{d:"M8 12h6",key:"ikassy"}],["path",{d:"M11 16h5",key:"oq65wt"}]],SquareChartGantt=createLucideIcon("square-chart-gantt",__iconNode$4r);const __iconNode$4q=[["path",{d:"M21 10.656V19a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h12.344",key:"2acyp4"}],["path",{d:"m9 11 3 3L22 4",key:"1pflzl"}]],SquareCheckBig=createLucideIcon("square-check-big",__iconNode$4q);const __iconNode$4p=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],SquareCheck=createLucideIcon("square-check",__iconNode$4p);const __iconNode$4o=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"m16 10-4 4-4-4",key:"894hmk"}]],SquareChevronDown=createLucideIcon("square-chevron-down",__iconNode$4o);const __iconNode$4n=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"m14 16-4-4 4-4",key:"ojs7w8"}]],SquareChevronLeft=createLucideIcon("square-chevron-left",__iconNode$4n);const __iconNode$4m=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"m10 8 4 4-4 4",key:"1wy4r4"}]],SquareChevronRight=createLucideIcon("square-chevron-right",__iconNode$4m);const __iconNode$4l=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"m8 14 4-4 4 4",key:"fy2ptz"}]],SquareChevronUp=createLucideIcon("square-chevron-up",__iconNode$4l);const __iconNode$4k=[["path",{d:"m10 9-3 3 3 3",key:"1oro0q"}],["path",{d:"m14 15 3-3-3-3",key:"bz13h7"}],["rect",{x:"3",y:"3",width:"18",height:"18",rx:"2",key:"h1oib"}]],SquareCode=createLucideIcon("square-code",__iconNode$4k);const __iconNode$4j=[["path",{d:"M10 9.5 8 12l2 2.5",key:"3mjy60"}],["path",{d:"M14 21h1",key:"v9vybs"}],["path",{d:"m14 9.5 2 2.5-2 2.5",key:"1bir2l"}],["path",{d:"M5 21a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2",key:"as5y1o"}],["path",{d:"M9 21h1",key:"15o7lz"}]],SquareDashedBottomCode=createLucideIcon("square-dashed-bottom-code",__iconNode$4j);const __iconNode$4i=[["path",{d:"M5 21a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2",key:"as5y1o"}],["path",{d:"M9 21h1",key:"15o7lz"}],["path",{d:"M14 21h1",key:"v9vybs"}]],SquareDashedBottom=createLucideIcon("square-dashed-bottom",__iconNode$4i);const __iconNode$4h=[["path",{d:"M8 7v7",key:"1x2jlm"}],["path",{d:"M12 7v4",key:"xawao1"}],["path",{d:"M16 7v9",key:"1hp2iy"}],["path",{d:"M5 3a2 2 0 0 0-2 2",key:"y57alp"}],["path",{d:"M9 3h1",key:"1yesri"}],["path",{d:"M14 3h1",key:"1ec4yj"}],["path",{d:"M19 3a2 2 0 0 1 2 2",key:"18rm91"}],["path",{d:"M21 9v1",key:"mxsmne"}],["path",{d:"M21 14v1",key:"169vum"}],["path",{d:"M21 19a2 2 0 0 1-2 2",key:"1j7049"}],["path",{d:"M14 21h1",key:"v9vybs"}],["path",{d:"M9 21h1",key:"15o7lz"}],["path",{d:"M5 21a2 2 0 0 1-2-2",key:"sbafld"}],["path",{d:"M3 14v1",key:"vnatye"}],["path",{d:"M3 9v1",key:"1r0deq"}]],SquareDashedKanban=createLucideIcon("square-dashed-kanban",__iconNode$4h);const __iconNode$4g=[["path",{d:"M12.034 12.681a.498.498 0 0 1 .647-.647l9 3.5a.5.5 0 0 1-.033.943l-3.444 1.068a1 1 0 0 0-.66.66l-1.067 3.443a.5.5 0 0 1-.943.033z",key:"xwnzip"}],["path",{d:"M5 3a2 2 0 0 0-2 2",key:"y57alp"}],["path",{d:"M19 3a2 2 0 0 1 2 2",key:"18rm91"}],["path",{d:"M5 21a2 2 0 0 1-2-2",key:"sbafld"}],["path",{d:"M9 3h1",key:"1yesri"}],["path",{d:"M9 21h2",key:"1qve2z"}],["path",{d:"M14 3h1",key:"1ec4yj"}],["path",{d:"M3 9v1",key:"1r0deq"}],["path",{d:"M21 9v2",key:"p14lih"}],["path",{d:"M3 14v1",key:"vnatye"}]],SquareDashedMousePointer=createLucideIcon("square-dashed-mouse-pointer",__iconNode$4g);const __iconNode$4f=[["path",{d:"M14 21h1",key:"v9vybs"}],["path",{d:"M21 14v1",key:"169vum"}],["path",{d:"M21 19a2 2 0 0 1-2 2",key:"1j7049"}],["path",{d:"M21 9v1",key:"mxsmne"}],["path",{d:"M3 14v1",key:"vnatye"}],["path",{d:"M3 5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2",key:"89voep"}],["path",{d:"M3 9v1",key:"1r0deq"}],["path",{d:"M5 21a2 2 0 0 1-2-2",key:"sbafld"}],["path",{d:"M9 21h1",key:"15o7lz"}]],SquareDashedTopSolid=createLucideIcon("square-dashed-top-solid",__iconNode$4f);const __iconNode$4e=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",ry:"2",key:"1m3agn"}],["line",{x1:"8",x2:"16",y1:"12",y2:"12",key:"1jonct"}],["line",{x1:"12",x2:"12",y1:"16",y2:"16",key:"aqc6ln"}],["line",{x1:"12",x2:"12",y1:"8",y2:"8",key:"1mkcni"}]],SquareDivide=createLucideIcon("square-divide",__iconNode$4e);const __iconNode$4d=[["path",{d:"M5 3a2 2 0 0 0-2 2",key:"y57alp"}],["path",{d:"M19 3a2 2 0 0 1 2 2",key:"18rm91"}],["path",{d:"M21 19a2 2 0 0 1-2 2",key:"1j7049"}],["path",{d:"M5 21a2 2 0 0 1-2-2",key:"sbafld"}],["path",{d:"M9 3h1",key:"1yesri"}],["path",{d:"M9 21h1",key:"15o7lz"}],["path",{d:"M14 3h1",key:"1ec4yj"}],["path",{d:"M14 21h1",key:"v9vybs"}],["path",{d:"M3 9v1",key:"1r0deq"}],["path",{d:"M21 9v1",key:"mxsmne"}],["path",{d:"M3 14v1",key:"vnatye"}],["path",{d:"M21 14v1",key:"169vum"}]],SquareDashed=createLucideIcon("square-dashed",__iconNode$4d);const __iconNode$4c=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["circle",{cx:"12",cy:"12",r:"1",key:"41hilf"}]],SquareDot=createLucideIcon("square-dot",__iconNode$4c);const __iconNode$4b=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M7 10h10",key:"1101jm"}],["path",{d:"M7 14h10",key:"1mhdw3"}]],SquareEqual=createLucideIcon("square-equal",__iconNode$4b);const __iconNode$4a=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",ry:"2",key:"1m3agn"}],["path",{d:"M9 17c2 0 2.8-1 2.8-2.8V10c0-2 1-3.3 3.2-3",key:"m1af9g"}],["path",{d:"M9 11.2h5.7",key:"3zgcl2"}]],SquareFunction=createLucideIcon("square-function",__iconNode$4a);const __iconNode$49=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M8 7v7",key:"1x2jlm"}],["path",{d:"M12 7v4",key:"xawao1"}],["path",{d:"M16 7v9",key:"1hp2iy"}]],SquareKanban=createLucideIcon("square-kanban",__iconNode$49);const __iconNode$48=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M7 7v10",key:"d5nglc"}],["path",{d:"M11 7v10",key:"pptsnr"}],["path",{d:"m15 7 2 10",key:"1m7qm5"}]],SquareLibrary=createLucideIcon("square-library",__iconNode$48);const __iconNode$47=[["path",{d:"M8 16V8.5a.5.5 0 0 1 .9-.3l2.7 3.599a.5.5 0 0 0 .8 0l2.7-3.6a.5.5 0 0 1 .9.3V16",key:"1ywlsj"}],["rect",{x:"3",y:"3",width:"18",height:"18",rx:"2",key:"h1oib"}]],SquareM=createLucideIcon("square-m",__iconNode$47);const __iconNode$46=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M7 8h10",key:"1jw688"}],["path",{d:"M7 12h10",key:"b7w52i"}],["path",{d:"M7 16h10",key:"wp8him"}]],SquareMenu=createLucideIcon("square-menu",__iconNode$46);const __iconNode$45=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M8 12h8",key:"1wcyev"}]],SquareMinus=createLucideIcon("square-minus",__iconNode$45);const __iconNode$44=[["path",{d:"M12.034 12.681a.498.498 0 0 1 .647-.647l9 3.5a.5.5 0 0 1-.033.943l-3.444 1.068a1 1 0 0 0-.66.66l-1.067 3.443a.5.5 0 0 1-.943.033z",key:"xwnzip"}],["path",{d:"M21 11V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h6",key:"14rsvq"}]],SquareMousePointer=createLucideIcon("square-mouse-pointer",__iconNode$44);const __iconNode$43=[["path",{d:"M3.6 3.6A2 2 0 0 1 5 3h14a2 2 0 0 1 2 2v14a2 2 0 0 1-.59 1.41",key:"9l1ft6"}],["path",{d:"M3 8.7V19a2 2 0 0 0 2 2h10.3",key:"17knke"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M13 13a3 3 0 1 0 0-6H9v2",key:"uoagbd"}],["path",{d:"M9 17v-2.3",key:"1jxgo2"}]],SquareParkingOff=createLucideIcon("square-parking-off",__iconNode$43);const __iconNode$42=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M9 17V7h4a3 3 0 0 1 0 6H9",key:"1dfk2c"}]],SquareParking=createLucideIcon("square-parking",__iconNode$42);const __iconNode$41=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["line",{x1:"10",x2:"10",y1:"15",y2:"9",key:"c1nkhi"}],["line",{x1:"14",x2:"14",y1:"15",y2:"9",key:"h65svq"}]],SquarePause=createLucideIcon("square-pause",__iconNode$41);const __iconNode$40=[["path",{d:"M12 3H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7",key:"1m0v6g"}],["path",{d:"M18.375 2.625a1 1 0 0 1 3 3l-9.013 9.014a2 2 0 0 1-.853.505l-2.873.84a.5.5 0 0 1-.62-.62l.84-2.873a2 2 0 0 1 .506-.852z",key:"ohrbg2"}]],SquarePen=createLucideIcon("square-pen",__iconNode$40);const __iconNode$3$=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M7 7h10",key:"udp07y"}],["path",{d:"M10 7v10",key:"i1d9ee"}],["path",{d:"M16 17a2 2 0 0 1-2-2V7",key:"ftwdc7"}]],SquarePi=createLucideIcon("square-pi",__iconNode$3$);const __iconNode$3_=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"m15 9-6 6",key:"1uzhvr"}],["path",{d:"M9 9h.01",key:"1q5me6"}],["path",{d:"M15 15h.01",key:"lqbp3k"}]],SquarePercent=createLucideIcon("square-percent",__iconNode$3_);const __iconNode$3Z=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M12 12H9.5a2.5 2.5 0 0 1 0-5H17",key:"1l9586"}],["path",{d:"M12 7v10",key:"jspqdw"}],["path",{d:"M16 7v10",key:"lavkr4"}]],SquarePilcrow=createLucideIcon("square-pilcrow",__iconNode$3Z);const __iconNode$3Y=[["rect",{x:"3",y:"3",width:"18",height:"18",rx:"2",key:"h1oib"}],["path",{d:"M9 9.003a1 1 0 0 1 1.517-.859l4.997 2.997a1 1 0 0 1 0 1.718l-4.997 2.997A1 1 0 0 1 9 14.996z",key:"kmsa83"}]],SquarePlay=createLucideIcon("square-play",__iconNode$3Y);const __iconNode$3X=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M8 12h8",key:"1wcyev"}],["path",{d:"M12 8v8",key:"napkw2"}]],SquarePlus=createLucideIcon("square-plus",__iconNode$3X);const __iconNode$3W=[["path",{d:"M12 7v4",key:"xawao1"}],["path",{d:"M7.998 9.003a5 5 0 1 0 8-.005",key:"1pek45"}],["rect",{x:"3",y:"3",width:"18",height:"18",rx:"2",key:"h1oib"}]],SquarePower=createLucideIcon("square-power",__iconNode$3W);const __iconNode$3V=[["path",{d:"M7 12h2l2 5 2-10h4",key:"1fxv6h"}],["rect",{x:"3",y:"3",width:"18",height:"18",rx:"2",key:"h1oib"}]],SquareRadical=createLucideIcon("square-radical",__iconNode$3V);const __iconNode$3U=[["rect",{width:"20",height:"20",x:"2",y:"2",rx:"2",key:"1btzen"}],["circle",{cx:"8",cy:"8",r:"2",key:"14cg06"}],["path",{d:"M9.414 9.414 12 12",key:"qz4lzr"}],["path",{d:"M14.8 14.8 18 18",key:"11flf1"}],["circle",{cx:"8",cy:"16",r:"2",key:"1acxsx"}],["path",{d:"m18 6-8.586 8.586",key:"11kzk1"}]],SquareScissors=createLucideIcon("square-scissors",__iconNode$3U);const __iconNode$3T=[["path",{d:"M21 11a8 8 0 0 0-8-8",key:"1lxwo5"}],["path",{d:"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h4",key:"1dv2y5"}]],SquareRoundCorner=createLucideIcon("square-round-corner",__iconNode$3T);const __iconNode$3S=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M16 8.9V7H8l4 5-4 5h8v-1.9",key:"9nih0i"}]],SquareSigma=createLucideIcon("square-sigma",__iconNode$3S);const __iconNode$3R=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["line",{x1:"9",x2:"15",y1:"15",y2:"9",key:"1dfufj"}]],SquareSlash=createLucideIcon("square-slash",__iconNode$3R);const __iconNode$3Q=[["path",{d:"M8 19H5c-1 0-2-1-2-2V7c0-1 1-2 2-2h3",key:"lubmu8"}],["path",{d:"M16 5h3c1 0 2 1 2 2v10c0 1-1 2-2 2h-3",key:"1ag34g"}],["line",{x1:"12",x2:"12",y1:"4",y2:"20",key:"1tx1rr"}]],SquareSplitHorizontal=createLucideIcon("square-split-horizontal",__iconNode$3Q);const __iconNode$3P=[["path",{d:"M5 8V5c0-1 1-2 2-2h10c1 0 2 1 2 2v3",key:"1pi83i"}],["path",{d:"M19 16v3c0 1-1 2-2 2H7c-1 0-2-1-2-2v-3",key:"ido5k7"}],["line",{x1:"4",x2:"20",y1:"12",y2:"12",key:"1e0a9i"}]],SquareSplitVertical=createLucideIcon("square-split-vertical",__iconNode$3P);const __iconNode$3O=[["rect",{x:"3",y:"3",width:"18",height:"18",rx:"2",key:"h1oib"}],["rect",{x:"8",y:"8",width:"8",height:"8",rx:"1",key:"z9xiuo"}]],SquareSquare=createLucideIcon("square-square",__iconNode$3O);const __iconNode$3N=[["path",{d:"M4 10c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h4c1.1 0 2 .9 2 2",key:"4i38lg"}],["path",{d:"M10 16c-1.1 0-2-.9-2-2v-4c0-1.1.9-2 2-2h4c1.1 0 2 .9 2 2",key:"mlte4a"}],["rect",{width:"8",height:"8",x:"14",y:"14",rx:"2",key:"1fa9i4"}]],SquareStack=createLucideIcon("square-stack",__iconNode$3N);const __iconNode$3M=[["path",{d:"M11.035 7.69a1 1 0 0 1 1.909.024l.737 1.452a1 1 0 0 0 .737.535l1.634.256a1 1 0 0 1 .588 1.806l-1.172 1.168a1 1 0 0 0-.282.866l.259 1.613a1 1 0 0 1-1.541 1.134l-1.465-.75a1 1 0 0 0-.912 0l-1.465.75a1 1 0 0 1-1.539-1.133l.258-1.613a1 1 0 0 0-.282-.866l-1.156-1.153a1 1 0 0 1 .572-1.822l1.633-.256a1 1 0 0 0 .737-.535z",key:"13edca"}],["rect",{x:"3",y:"3",width:"18",height:"18",rx:"2",key:"h1oib"}]],SquareStar=createLucideIcon("square-star",__iconNode$3M);const __iconNode$3L=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["rect",{x:"9",y:"9",width:"6",height:"6",rx:"1",key:"1ssd4o"}]],SquareStop=createLucideIcon("square-stop",__iconNode$3L);const __iconNode$3K=[["path",{d:"m7 11 2-2-2-2",key:"1lz0vl"}],["path",{d:"M11 13h4",key:"1p7l4v"}],["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",ry:"2",key:"1m3agn"}]],SquareTerminal=createLucideIcon("square-terminal",__iconNode$3K);const __iconNode$3J=[["path",{d:"M18 21a6 6 0 0 0-12 0",key:"kaz2du"}],["circle",{cx:"12",cy:"11",r:"4",key:"1gt34v"}],["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}]],SquareUserRound=createLucideIcon("square-user-round",__iconNode$3J);const __iconNode$3I=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["circle",{cx:"12",cy:"10",r:"3",key:"ilqhr7"}],["path",{d:"M7 21v-2a2 2 0 0 1 2-2h6a2 2 0 0 1 2 2v2",key:"1m6ac2"}]],SquareUser=createLucideIcon("square-user",__iconNode$3I);const __iconNode$3H=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",ry:"2",key:"1m3agn"}],["path",{d:"m15 9-6 6",key:"1uzhvr"}],["path",{d:"m9 9 6 6",key:"z0biqf"}]],SquareX=createLucideIcon("square-x",__iconNode$3H);const __iconNode$3G=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}]],Square=createLucideIcon("square",__iconNode$3G);const __iconNode$3F=[["path",{d:"M16 12v2a2 2 0 0 1-2 2H9a1 1 0 0 0-1 1v3a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V10a2 2 0 0 0-2-2h0",key:"1mcohs"}],["path",{d:"M4 16a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2v3a1 1 0 0 1-1 1h-5a2 2 0 0 0-2 2v2",key:"1r1efp"}]],SquaresExclude=createLucideIcon("squares-exclude",__iconNode$3F);const __iconNode$3E=[["path",{d:"M10 22a2 2 0 0 1-2-2",key:"i7yj1i"}],["path",{d:"M14 2a2 2 0 0 1 2 2",key:"170a0m"}],["path",{d:"M16 22h-2",key:"18d249"}],["path",{d:"M2 10V8",key:"7yj4fe"}],["path",{d:"M2 4a2 2 0 0 1 2-2",key:"ddgnws"}],["path",{d:"M20 8a2 2 0 0 1 2 2",key:"1770vt"}],["path",{d:"M22 14v2",key:"iot8ja"}],["path",{d:"M22 20a2 2 0 0 1-2 2",key:"qj8q6g"}],["path",{d:"M4 16a2 2 0 0 1-2-2",key:"1dnafg"}],["path",{d:"M8 10a2 2 0 0 1 2-2h5a1 1 0 0 1 1 1v5a2 2 0 0 1-2 2H9a1 1 0 0 1-1-1z",key:"ci6f0b"}],["path",{d:"M8 2h2",key:"1gmkwm"}]],SquaresIntersect=createLucideIcon("squares-intersect",__iconNode$3E);const __iconNode$3D=[["path",{d:"M10 22a2 2 0 0 1-2-2",key:"i7yj1i"}],["path",{d:"M16 22h-2",key:"18d249"}],["path",{d:"M16 4a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h3a1 1 0 0 0 1-1v-5a2 2 0 0 1 2-2h5a1 1 0 0 0 1-1z",key:"1njgbb"}],["path",{d:"M20 8a2 2 0 0 1 2 2",key:"1770vt"}],["path",{d:"M22 14v2",key:"iot8ja"}],["path",{d:"M22 20a2 2 0 0 1-2 2",key:"qj8q6g"}]],SquaresSubtract=createLucideIcon("squares-subtract",__iconNode$3D);const __iconNode$3C=[["path",{d:"M4 16a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2v3a1 1 0 0 0 1 1h3a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H10a2 2 0 0 1-2-2v-3a1 1 0 0 0-1-1z",key:"17jnth"}]],SquaresUnite=createLucideIcon("squares-unite",__iconNode$3C);const __iconNode$3B=[["path",{d:"M13.77 3.043a34 34 0 0 0-3.54 0",key:"1oaobr"}],["path",{d:"M13.771 20.956a33 33 0 0 1-3.541.001",key:"95iq0j"}],["path",{d:"M20.18 17.74c-.51 1.15-1.29 1.93-2.439 2.44",key:"1u6qty"}],["path",{d:"M20.18 6.259c-.51-1.148-1.291-1.929-2.44-2.438",key:"1ew6g6"}],["path",{d:"M20.957 10.23a33 33 0 0 1 0 3.54",key:"1l9npr"}],["path",{d:"M3.043 10.23a34 34 0 0 0 .001 3.541",key:"1it6jm"}],["path",{d:"M6.26 20.179c-1.15-.508-1.93-1.29-2.44-2.438",key:"14uchd"}],["path",{d:"M6.26 3.82c-1.149.51-1.93 1.291-2.44 2.44",key:"8k4agb"}]],SquircleDashed=createLucideIcon("squircle-dashed",__iconNode$3B);const __iconNode$3A=[["path",{d:"M12 3c7.2 0 9 1.8 9 9s-1.8 9-9 9-9-1.8-9-9 1.8-9 9-9",key:"garfkc"}]],Squircle=createLucideIcon("squircle",__iconNode$3A);const __iconNode$3z=[["path",{d:"M15.236 22a3 3 0 0 0-2.2-5",key:"21bitc"}],["path",{d:"M16 20a3 3 0 0 1 3-3h1a2 2 0 0 0 2-2v-2a4 4 0 0 0-4-4V4",key:"oh0fg0"}],["path",{d:"M18 13h.01",key:"9veqaj"}],["path",{d:"M18 6a4 4 0 0 0-4 4 7 7 0 0 0-7 7c0-5 4-5 4-10.5a4.5 4.5 0 1 0-9 0 2.5 2.5 0 0 0 5 0C7 10 3 11 3 17c0 2.8 2.2 5 5 5h10",key:"980v8a"}]],Squirrel=createLucideIcon("squirrel",__iconNode$3z);const __iconNode$3y=[["path",{d:"M14 13V8.5C14 7 15 7 15 5a3 3 0 0 0-6 0c0 2 1 2 1 3.5V13",key:"i9gjdv"}],["path",{d:"M20 15.5a2.5 2.5 0 0 0-2.5-2.5h-11A2.5 2.5 0 0 0 4 15.5V17a1 1 0 0 0 1 1h14a1 1 0 0 0 1-1z",key:"1vzg3v"}],["path",{d:"M5 22h14",key:"ehvnwv"}]],Stamp=createLucideIcon("stamp",__iconNode$3y);const __iconNode$3x=[["path",{d:"M12 18.338a2.1 2.1 0 0 0-.987.244L6.396 21.01a.53.53 0 0 1-.77-.56l.881-5.139a2.12 2.12 0 0 0-.611-1.879L2.16 9.795a.53.53 0 0 1 .294-.906l5.165-.755a2.12 2.12 0 0 0 1.597-1.16l2.309-4.679A.53.53 0 0 1 12 2",key:"2ksp49"}]],StarHalf=createLucideIcon("star-half",__iconNode$3x);const __iconNode$3w=[["path",{d:"M8.34 8.34 2 9.27l5 4.87L5.82 21 12 17.77 18.18 21l-.59-3.43",key:"16m0ql"}],["path",{d:"M18.42 12.76 22 9.27l-6.91-1L12 2l-1.44 2.91",key:"1vt8nq"}],["line",{x1:"2",x2:"22",y1:"2",y2:"22",key:"a6p6uj"}]],StarOff=createLucideIcon("star-off",__iconNode$3w);const __iconNode$3v=[["path",{d:"M11.525 2.295a.53.53 0 0 1 .95 0l2.31 4.679a2.123 2.123 0 0 0 1.595 1.16l5.166.756a.53.53 0 0 1 .294.904l-3.736 3.638a2.123 2.123 0 0 0-.611 1.878l.882 5.14a.53.53 0 0 1-.771.56l-4.618-2.428a2.122 2.122 0 0 0-1.973 0L6.396 21.01a.53.53 0 0 1-.77-.56l.881-5.139a2.122 2.122 0 0 0-.611-1.879L2.16 9.795a.53.53 0 0 1 .294-.906l5.165-.755a2.122 2.122 0 0 0 1.597-1.16z",key:"r04s7s"}]],Star=createLucideIcon("star",__iconNode$3v);const __iconNode$3u=[["path",{d:"M13.971 4.285A2 2 0 0 1 17 6v12a2 2 0 0 1-3.029 1.715l-9.997-5.998a2 2 0 0 1-.003-3.432z",key:"19qhus"}],["path",{d:"M21 20V4",key:"cb8qj8"}]],StepBack=createLucideIcon("step-back",__iconNode$3u);const __iconNode$3t=[["path",{d:"M10.029 4.285A2 2 0 0 0 7 6v12a2 2 0 0 0 3.029 1.715l9.997-5.998a2 2 0 0 0 .003-3.432z",key:"1ystz2"}],["path",{d:"M3 4v16",key:"1ph11n"}]],StepForward=createLucideIcon("step-forward",__iconNode$3t);const __iconNode$3s=[["path",{d:"M11 2v2",key:"1539x4"}],["path",{d:"M5 2v2",key:"1yf1q8"}],["path",{d:"M5 3H4a2 2 0 0 0-2 2v4a6 6 0 0 0 12 0V5a2 2 0 0 0-2-2h-1",key:"rb5t3r"}],["path",{d:"M8 15a6 6 0 0 0 12 0v-3",key:"x18d4x"}],["circle",{cx:"20",cy:"10",r:"2",key:"ts1r5v"}]],Stethoscope=createLucideIcon("stethoscope",__iconNode$3s);const __iconNode$3r=[["path",{d:"M21 9a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 15 3H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2z",key:"1dfntj"}],["path",{d:"M15 3v5a1 1 0 0 0 1 1h5",key:"6s6qgf"}],["path",{d:"M8 13h.01",key:"1sbv64"}],["path",{d:"M16 13h.01",key:"wip0gl"}],["path",{d:"M10 16s.8 1 2 1c1.3 0 2-1 2-1",key:"1vvgv3"}]],Sticker=createLucideIcon("sticker",__iconNode$3r);const __iconNode$3q=[["path",{d:"M21 9a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 15 3H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2z",key:"1dfntj"}],["path",{d:"M15 3v5a1 1 0 0 0 1 1h5",key:"6s6qgf"}]],StickyNote=createLucideIcon("sticky-note",__iconNode$3q);const __iconNode$3p=[["path",{d:"M15 21v-5a1 1 0 0 0-1-1h-4a1 1 0 0 0-1 1v5",key:"slp6dd"}],["path",{d:"M17.774 10.31a1.12 1.12 0 0 0-1.549 0 2.5 2.5 0 0 1-3.451 0 1.12 1.12 0 0 0-1.548 0 2.5 2.5 0 0 1-3.452 0 1.12 1.12 0 0 0-1.549 0 2.5 2.5 0 0 1-3.77-3.248l2.889-4.184A2 2 0 0 1 7 2h10a2 2 0 0 1 1.653.873l2.895 4.192a2.5 2.5 0 0 1-3.774 3.244",key:"o0xfot"}],["path",{d:"M4 10.95V19a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-8.05",key:"wn3emo"}]],Store=createLucideIcon("store",__iconNode$3p);const __iconNode$3o=[["rect",{width:"20",height:"6",x:"2",y:"4",rx:"2",key:"qdearl"}],["rect",{width:"20",height:"6",x:"2",y:"14",rx:"2",key:"1xrn6j"}]],StretchHorizontal=createLucideIcon("stretch-horizontal",__iconNode$3o);const __iconNode$3n=[["rect",{width:"6",height:"20",x:"4",y:"2",rx:"2",key:"19qu7m"}],["rect",{width:"6",height:"20",x:"14",y:"2",rx:"2",key:"24v0nk"}]],StretchVertical=createLucideIcon("stretch-vertical",__iconNode$3n);const __iconNode$3m=[["path",{d:"M16 4H9a3 3 0 0 0-2.83 4",key:"43sutm"}],["path",{d:"M14 12a4 4 0 0 1 0 8H6",key:"nlfj13"}],["line",{x1:"4",x2:"20",y1:"12",y2:"12",key:"1e0a9i"}]],Strikethrough=createLucideIcon("strikethrough",__iconNode$3m);const __iconNode$3l=[["path",{d:"m4 5 8 8",key:"1eunvl"}],["path",{d:"m12 5-8 8",key:"1ah0jp"}],["path",{d:"M20 19h-4c0-1.5.44-2 1.5-2.5S20 15.33 20 14c0-.47-.17-.93-.48-1.29a2.11 2.11 0 0 0-2.62-.44c-.42.24-.74.62-.9 1.07",key:"e8ta8j"}]],Subscript=createLucideIcon("subscript",__iconNode$3l);const __iconNode$3k=[["circle",{cx:"12",cy:"12",r:"4",key:"4exip2"}],["path",{d:"M12 4h.01",key:"1ujb9j"}],["path",{d:"M20 12h.01",key:"1ykeid"}],["path",{d:"M12 20h.01",key:"zekei9"}],["path",{d:"M4 12h.01",key:"158zrr"}],["path",{d:"M17.657 6.343h.01",key:"31pqzk"}],["path",{d:"M17.657 17.657h.01",key:"jehnf4"}],["path",{d:"M6.343 17.657h.01",key:"gdk6ow"}],["path",{d:"M6.343 6.343h.01",key:"1uurf0"}]],SunDim=createLucideIcon("sun-dim",__iconNode$3k);const __iconNode$3j=[["circle",{cx:"12",cy:"12",r:"4",key:"4exip2"}],["path",{d:"M12 3v1",key:"1asbbs"}],["path",{d:"M12 20v1",key:"1wcdkc"}],["path",{d:"M3 12h1",key:"lp3yf2"}],["path",{d:"M20 12h1",key:"1vloll"}],["path",{d:"m18.364 5.636-.707.707",key:"1hakh0"}],["path",{d:"m6.343 17.657-.707.707",key:"18m9nf"}],["path",{d:"m5.636 5.636.707.707",key:"1xv1c5"}],["path",{d:"m17.657 17.657.707.707",key:"vl76zb"}]],SunMedium=createLucideIcon("sun-medium",__iconNode$3j);const __iconNode$3i=[["path",{d:"M12 2v2",key:"tus03m"}],["path",{d:"M14.837 16.385a6 6 0 1 1-7.223-7.222c.624-.147.97.66.715 1.248a4 4 0 0 0 5.26 5.259c.589-.255 1.396.09 1.248.715",key:"xlf6rm"}],["path",{d:"M16 12a4 4 0 0 0-4-4",key:"6vsxu"}],["path",{d:"m19 5-1.256 1.256",key:"1yg6a6"}],["path",{d:"M20 12h2",key:"1q8mjw"}]],SunMoon=createLucideIcon("sun-moon",__iconNode$3i);const __iconNode$3h=[["path",{d:"M10 21v-1",key:"1u8rkd"}],["path",{d:"M10 4V3",key:"pkzwkn"}],["path",{d:"M10 9a3 3 0 0 0 0 6",key:"gv75dk"}],["path",{d:"m14 20 1.25-2.5L18 18",key:"1chtki"}],["path",{d:"m14 4 1.25 2.5L18 6",key:"1b4wsy"}],["path",{d:"m17 21-3-6 1.5-3H22",key:"o5qa3v"}],["path",{d:"m17 3-3 6 1.5 3",key:"11697g"}],["path",{d:"M2 12h1",key:"1uaihz"}],["path",{d:"m20 10-1.5 2 1.5 2",key:"1swlpi"}],["path",{d:"m3.64 18.36.7-.7",key:"105rm9"}],["path",{d:"m4.34 6.34-.7-.7",key:"d3unjp"}]],SunSnow=createLucideIcon("sun-snow",__iconNode$3h);const __iconNode$3g=[["path",{d:"M12 2v8",key:"1q4o3n"}],["path",{d:"m4.93 10.93 1.41 1.41",key:"2a7f42"}],["path",{d:"M2 18h2",key:"j10viu"}],["path",{d:"M20 18h2",key:"wocana"}],["path",{d:"m19.07 10.93-1.41 1.41",key:"15zs5n"}],["path",{d:"M22 22H2",key:"19qnx5"}],["path",{d:"m8 6 4-4 4 4",key:"ybng9g"}],["path",{d:"M16 18a4 4 0 0 0-8 0",key:"1lzouq"}]],Sunrise=createLucideIcon("sunrise",__iconNode$3g);const __iconNode$3f=[["circle",{cx:"12",cy:"12",r:"4",key:"4exip2"}],["path",{d:"M12 2v2",key:"tus03m"}],["path",{d:"M12 20v2",key:"1lh1kg"}],["path",{d:"m4.93 4.93 1.41 1.41",key:"149t6j"}],["path",{d:"m17.66 17.66 1.41 1.41",key:"ptbguv"}],["path",{d:"M2 12h2",key:"1t8f8n"}],["path",{d:"M20 12h2",key:"1q8mjw"}],["path",{d:"m6.34 17.66-1.41 1.41",key:"1m8zz5"}],["path",{d:"m19.07 4.93-1.41 1.41",key:"1shlcs"}]],Sun=createLucideIcon("sun",__iconNode$3f);const __iconNode$3e=[["path",{d:"M12 10V2",key:"16sf7g"}],["path",{d:"m4.93 10.93 1.41 1.41",key:"2a7f42"}],["path",{d:"M2 18h2",key:"j10viu"}],["path",{d:"M20 18h2",key:"wocana"}],["path",{d:"m19.07 10.93-1.41 1.41",key:"15zs5n"}],["path",{d:"M22 22H2",key:"19qnx5"}],["path",{d:"m16 6-4 4-4-4",key:"6wukr"}],["path",{d:"M16 18a4 4 0 0 0-8 0",key:"1lzouq"}]],Sunset=createLucideIcon("sunset",__iconNode$3e);const __iconNode$3d=[["path",{d:"m4 19 8-8",key:"hr47gm"}],["path",{d:"m12 19-8-8",key:"1dhhmo"}],["path",{d:"M20 12h-4c0-1.5.442-2 1.5-2.5S20 8.334 20 7.002c0-.472-.17-.93-.484-1.29a2.105 2.105 0 0 0-2.617-.436c-.42.239-.738.614-.899 1.06",key:"1dfcux"}]],Superscript=createLucideIcon("superscript",__iconNode$3d);const __iconNode$3c=[["path",{d:"M11 17a4 4 0 0 1-8 0V5a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2Z",key:"1ldrpk"}],["path",{d:"M16.7 13H19a2 2 0 0 1 2 2v4a2 2 0 0 1-2 2H7",key:"11i5po"}],["path",{d:"M 7 17h.01",key:"1euzgo"}],["path",{d:"m11 8 2.3-2.3a2.4 2.4 0 0 1 3.404.004L18.6 7.6a2.4 2.4 0 0 1 .026 3.434L9.9 19.8",key:"o2gii7"}]],SwatchBook=createLucideIcon("swatch-book",__iconNode$3c);const __iconNode$3b=[["path",{d:"M10 21V3h8",key:"br2l0g"}],["path",{d:"M6 16h9",key:"2py0wn"}],["path",{d:"M10 9.5h7",key:"13dmhz"}]],SwissFranc=createLucideIcon("swiss-franc",__iconNode$3b);const __iconNode$3a=[["path",{d:"M11 19H4a2 2 0 0 1-2-2V7a2 2 0 0 1 2-2h5",key:"mtk2lu"}],["path",{d:"M13 5h7a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2h-5",key:"120jsl"}],["circle",{cx:"12",cy:"12",r:"3",key:"1v7zrd"}],["path",{d:"m18 22-3-3 3-3",key:"kgdoj7"}],["path",{d:"m6 2 3 3-3 3",key:"1fnbkv"}]],SwitchCamera=createLucideIcon("switch-camera",__iconNode$3a);const __iconNode$39=[["path",{d:"m11 19-6-6",key:"s7kpr"}],["path",{d:"m5 21-2-2",key:"1kw20b"}],["path",{d:"m8 16-4 4",key:"1oqv8h"}],["path",{d:"M9.5 17.5 21 6V3h-3L6.5 14.5",key:"pkxemp"}]],Sword=createLucideIcon("sword",__iconNode$39);const __iconNode$38=[["path",{d:"m18 2 4 4",key:"22kx64"}],["path",{d:"m17 7 3-3",key:"1w1zoj"}],["path",{d:"M19 9 8.7 19.3c-1 1-2.5 1-3.4 0l-.6-.6c-1-1-1-2.5 0-3.4L15 5",key:"1exhtz"}],["path",{d:"m9 11 4 4",key:"rovt3i"}],["path",{d:"m5 19-3 3",key:"59f2uf"}],["path",{d:"m14 4 6 6",key:"yqp9t2"}]],Syringe=createLucideIcon("syringe",__iconNode$38);const __iconNode$37=[["polyline",{points:"14.5 17.5 3 6 3 3 6 3 17.5 14.5",key:"1hfsw2"}],["line",{x1:"13",x2:"19",y1:"19",y2:"13",key:"1vrmhu"}],["line",{x1:"16",x2:"20",y1:"16",y2:"20",key:"1bron3"}],["line",{x1:"19",x2:"21",y1:"21",y2:"19",key:"13pww6"}],["polyline",{points:"14.5 6.5 18 3 21 3 21 6 17.5 9.5",key:"hbey2j"}],["line",{x1:"5",x2:"9",y1:"14",y2:"18",key:"1hf58s"}],["line",{x1:"7",x2:"4",y1:"17",y2:"20",key:"pidxm4"}],["line",{x1:"3",x2:"5",y1:"19",y2:"21",key:"1pehsh"}]],Swords=createLucideIcon("swords",__iconNode$37);const __iconNode$36=[["path",{d:"M9 3H5a2 2 0 0 0-2 2v4m6-6h10a2 2 0 0 1 2 2v4M9 3v18m0 0h10a2 2 0 0 0 2-2V9M9 21H5a2 2 0 0 1-2-2V9m0 0h18",key:"gugj83"}]],Table2=createLucideIcon("table-2",__iconNode$36);const __iconNode$35=[["path",{d:"M12 21v-6",key:"lihzve"}],["path",{d:"M12 9V3",key:"da5inc"}],["path",{d:"M3 15h18",key:"5xshup"}],["path",{d:"M3 9h18",key:"1pudct"}],["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}]],TableCellsMerge=createLucideIcon("table-cells-merge",__iconNode$35);const __iconNode$34=[["path",{d:"M12 15V9",key:"8c7uyn"}],["path",{d:"M3 15h18",key:"5xshup"}],["path",{d:"M3 9h18",key:"1pudct"}],["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}]],TableCellsSplit=createLucideIcon("table-cells-split",__iconNode$34);const __iconNode$33=[["path",{d:"M14 14v2",key:"w2a1xv"}],["path",{d:"M14 20v2",key:"1lq872"}],["path",{d:"M14 2v2",key:"6buw04"}],["path",{d:"M14 8v2",key:"i67w9a"}],["path",{d:"M2 15h8",key:"82wtch"}],["path",{d:"M2 3h6a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H2",key:"up0l64"}],["path",{d:"M2 9h8",key:"yelfik"}],["path",{d:"M22 15h-4",key:"1es58f"}],["path",{d:"M22 3h-2a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h2",key:"pdjoqf"}],["path",{d:"M22 9h-4",key:"1luja7"}],["path",{d:"M5 3v18",key:"14hmio"}]],TableColumnsSplit=createLucideIcon("table-columns-split",__iconNode$33);const __iconNode$32=[["path",{d:"M16 5H3",key:"m91uny"}],["path",{d:"M16 12H3",key:"1a2rj7"}],["path",{d:"M16 19H3",key:"zzsher"}],["path",{d:"M21 5h.01",key:"wa75ra"}],["path",{d:"M21 12h.01",key:"msek7k"}],["path",{d:"M21 19h.01",key:"qvbq2j"}]],TableOfContents$1=createLucideIcon("table-of-contents",__iconNode$32);const __iconNode$31=[["path",{d:"M15 3v18",key:"14nvp0"}],["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M21 9H3",key:"1338ky"}],["path",{d:"M21 15H3",key:"9uk58r"}]],TableProperties=createLucideIcon("table-properties",__iconNode$31);const __iconNode$30=[["path",{d:"M14 10h2",key:"1lstlu"}],["path",{d:"M15 22v-8",key:"1fwwgm"}],["path",{d:"M15 2v4",key:"1044rn"}],["path",{d:"M2 10h2",key:"1r8dkt"}],["path",{d:"M20 10h2",key:"1ug425"}],["path",{d:"M3 19h18",key:"awlh7x"}],["path",{d:"M3 22v-6a2 2 135 0 1 2-2h14a2 2 45 0 1 2 2v6",key:"ibqhof"}],["path",{d:"M3 2v2a2 2 45 0 0 2 2h14a2 2 135 0 0 2-2V2",key:"1uenja"}],["path",{d:"M8 10h2",key:"66od0"}],["path",{d:"M9 22v-8",key:"fmnu31"}],["path",{d:"M9 2v4",key:"j1yeou"}]],TableRowsSplit=createLucideIcon("table-rows-split",__iconNode$30);const __iconNode$2$=[["path",{d:"M12 3v18",key:"108xh3"}],["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M3 9h18",key:"1pudct"}],["path",{d:"M3 15h18",key:"5xshup"}]],Table=createLucideIcon("table",__iconNode$2$);const __iconNode$2_=[["rect",{width:"10",height:"14",x:"3",y:"8",rx:"2",key:"1vrsiq"}],["path",{d:"M5 4a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v16a2 2 0 0 1-2 2h-2.4",key:"1j4zmg"}],["path",{d:"M8 18h.01",key:"lrp35t"}]],TabletSmartphone=createLucideIcon("tablet-smartphone",__iconNode$2_);const __iconNode$2Z=[["rect",{width:"16",height:"20",x:"4",y:"2",rx:"2",ry:"2",key:"76otgf"}],["line",{x1:"12",x2:"12.01",y1:"18",y2:"18",key:"1dp563"}]],Tablet=createLucideIcon("tablet",__iconNode$2Z);const __iconNode$2Y=[["circle",{cx:"7",cy:"7",r:"5",key:"x29byf"}],["circle",{cx:"17",cy:"17",r:"5",key:"1op1d2"}],["path",{d:"M12 17h10",key:"ls21zv"}],["path",{d:"m3.46 10.54 7.08-7.08",key:"1rehiu"}]],Tablets=createLucideIcon("tablets",__iconNode$2Y);const __iconNode$2X=[["path",{d:"M12.586 2.586A2 2 0 0 0 11.172 2H4a2 2 0 0 0-2 2v7.172a2 2 0 0 0 .586 1.414l8.704 8.704a2.426 2.426 0 0 0 3.42 0l6.58-6.58a2.426 2.426 0 0 0 0-3.42z",key:"vktsd0"}],["circle",{cx:"7.5",cy:"7.5",r:".5",fill:"currentColor",key:"kqv944"}]],Tag=createLucideIcon("tag",__iconNode$2X);const __iconNode$2W=[["path",{d:"M13.172 2a2 2 0 0 1 1.414.586l6.71 6.71a2.4 2.4 0 0 1 0 3.408l-4.592 4.592a2.4 2.4 0 0 1-3.408 0l-6.71-6.71A2 2 0 0 1 6 9.172V3a1 1 0 0 1 1-1z",key:"16rjxf"}],["path",{d:"M2 7v6.172a2 2 0 0 0 .586 1.414l6.71 6.71a2.4 2.4 0 0 0 3.191.193",key:"178nd4"}],["circle",{cx:"10.5",cy:"6.5",r:".5",fill:"currentColor",key:"12ikhr"}]],Tags=createLucideIcon("tags",__iconNode$2W);const __iconNode$2V=[["path",{d:"M4 4v16",key:"6qkkli"}]],Tally1=createLucideIcon("tally-1",__iconNode$2V);const __iconNode$2U=[["path",{d:"M4 4v16",key:"6qkkli"}],["path",{d:"M9 4v16",key:"81ygyz"}],["path",{d:"M14 4v16",key:"12vmem"}]],Tally3=createLucideIcon("tally-3",__iconNode$2U);const __iconNode$2T=[["path",{d:"M4 4v16",key:"6qkkli"}],["path",{d:"M9 4v16",key:"81ygyz"}]],Tally2=createLucideIcon("tally-2",__iconNode$2T);const __iconNode$2S=[["path",{d:"M4 4v16",key:"6qkkli"}],["path",{d:"M9 4v16",key:"81ygyz"}],["path",{d:"M14 4v16",key:"12vmem"}],["path",{d:"M19 4v16",key:"8ij5ei"}]],Tally4=createLucideIcon("tally-4",__iconNode$2S);const __iconNode$2R=[["path",{d:"M4 4v16",key:"6qkkli"}],["path",{d:"M9 4v16",key:"81ygyz"}],["path",{d:"M14 4v16",key:"12vmem"}],["path",{d:"M19 4v16",key:"8ij5ei"}],["path",{d:"M22 6 2 18",key:"h9moai"}]],Tally5=createLucideIcon("tally-5",__iconNode$2R);const __iconNode$2Q=[["circle",{cx:"17",cy:"4",r:"2",key:"y5j2s2"}],["path",{d:"M15.59 5.41 5.41 15.59",key:"l0vprr"}],["circle",{cx:"4",cy:"17",r:"2",key:"9p4efm"}],["path",{d:"M12 22s-4-9-1.5-11.5S22 12 22 12",key:"1twk4o"}]],Tangent=createLucideIcon("tangent",__iconNode$2Q);const __iconNode$2P=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["circle",{cx:"12",cy:"12",r:"6",key:"1vlfrh"}],["circle",{cx:"12",cy:"12",r:"2",key:"1c9p78"}]],Target=createLucideIcon("target",__iconNode$2P);const __iconNode$2O=[["path",{d:"m10.065 12.493-6.18 1.318a.934.934 0 0 1-1.108-.702l-.537-2.15a1.07 1.07 0 0 1 .691-1.265l13.504-4.44",key:"k4qptu"}],["path",{d:"m13.56 11.747 4.332-.924",key:"19l80z"}],["path",{d:"m16 21-3.105-6.21",key:"7oh9d"}],["path",{d:"M16.485 5.94a2 2 0 0 1 1.455-2.425l1.09-.272a1 1 0 0 1 1.212.727l1.515 6.06a1 1 0 0 1-.727 1.213l-1.09.272a2 2 0 0 1-2.425-1.455z",key:"m7xp4m"}],["path",{d:"m6.158 8.633 1.114 4.456",key:"74o979"}],["path",{d:"m8 21 3.105-6.21",key:"1fvxut"}],["circle",{cx:"12",cy:"13",r:"2",key:"1c1ljs"}]],Telescope=createLucideIcon("telescope",__iconNode$2O);const __iconNode$2N=[["circle",{cx:"4",cy:"4",r:"2",key:"bt5ra8"}],["path",{d:"m14 5 3-3 3 3",key:"1sorif"}],["path",{d:"m14 10 3-3 3 3",key:"1jyi9h"}],["path",{d:"M17 14V2",key:"8ymqnk"}],["path",{d:"M17 14H7l-5 8h20Z",key:"13ar7p"}],["path",{d:"M8 14v8",key:"1ghmqk"}],["path",{d:"m9 14 5 8",key:"13pgi6"}]],TentTree=createLucideIcon("tent-tree",__iconNode$2N);const __iconNode$2M=[["path",{d:"M3.5 21 14 3",key:"1szst5"}],["path",{d:"M20.5 21 10 3",key:"1310c3"}],["path",{d:"M15.5 21 12 15l-3.5 6",key:"1ddtfw"}],["path",{d:"M2 21h20",key:"1nyx9w"}]],Tent=createLucideIcon("tent",__iconNode$2M);const __iconNode$2L=[["path",{d:"M12 19h8",key:"baeox8"}],["path",{d:"m4 17 6-6-6-6",key:"1yngyt"}]],Terminal=createLucideIcon("terminal",__iconNode$2L);const __iconNode$2K=[["path",{d:"M21 7 6.82 21.18a2.83 2.83 0 0 1-3.99-.01a2.83 2.83 0 0 1 0-4L17 3",key:"1ub6xw"}],["path",{d:"m16 2 6 6",key:"1gw87d"}],["path",{d:"M12 16H4",key:"1cjfip"}]],TestTubeDiagonal=createLucideIcon("test-tube-diagonal",__iconNode$2K);const __iconNode$2J=[["path",{d:"M14.5 2v17.5c0 1.4-1.1 2.5-2.5 2.5c-1.4 0-2.5-1.1-2.5-2.5V2",key:"125lnx"}],["path",{d:"M8.5 2h7",key:"csnxdl"}],["path",{d:"M14.5 16h-5",key:"1ox875"}]],TestTube=createLucideIcon("test-tube",__iconNode$2J);const __iconNode$2I=[["path",{d:"M9 2v17.5A2.5 2.5 0 0 1 6.5 22A2.5 2.5 0 0 1 4 19.5V2",key:"1hjrqt"}],["path",{d:"M20 2v17.5a2.5 2.5 0 0 1-2.5 2.5a2.5 2.5 0 0 1-2.5-2.5V2",key:"16lc8n"}],["path",{d:"M3 2h7",key:"7s29d5"}],["path",{d:"M14 2h7",key:"7sicin"}],["path",{d:"M9 16H4",key:"1bfye3"}],["path",{d:"M20 16h-5",key:"ddnjpe"}]],TestTubes=createLucideIcon("test-tubes",__iconNode$2I);const __iconNode$2H=[["path",{d:"M21 5H3",key:"1fi0y6"}],["path",{d:"M17 12H7",key:"16if0g"}],["path",{d:"M19 19H5",key:"vjpgq2"}]],TextAlignCenter=createLucideIcon("text-align-center",__iconNode$2H);const __iconNode$2G=[["path",{d:"M21 5H3",key:"1fi0y6"}],["path",{d:"M21 12H9",key:"dn1m92"}],["path",{d:"M21 19H7",key:"4cu937"}]],TextAlignEnd=createLucideIcon("text-align-end",__iconNode$2G);const __iconNode$2F=[["path",{d:"M3 5h18",key:"1u36vt"}],["path",{d:"M3 12h18",key:"1i2n21"}],["path",{d:"M3 19h18",key:"awlh7x"}]],TextAlignJustify=createLucideIcon("text-align-justify",__iconNode$2F);const __iconNode$2E=[["path",{d:"M21 5H3",key:"1fi0y6"}],["path",{d:"M15 12H3",key:"6jk70r"}],["path",{d:"M17 19H3",key:"z6ezky"}]],TextAlignStart=createLucideIcon("text-align-start",__iconNode$2E);const __iconNode$2D=[["path",{d:"M12 20h-1a2 2 0 0 1-2-2 2 2 0 0 1-2 2H6",key:"1528k5"}],["path",{d:"M13 8h7a2 2 0 0 1 2 2v4a2 2 0 0 1-2 2h-7",key:"13ksps"}],["path",{d:"M5 16H4a2 2 0 0 1-2-2v-4a2 2 0 0 1 2-2h1",key:"1n9rhb"}],["path",{d:"M6 4h1a2 2 0 0 1 2 2 2 2 0 0 1 2-2h1",key:"1mj8rg"}],["path",{d:"M9 6v12",key:"velyjx"}]],TextCursorInput=createLucideIcon("text-cursor-input",__iconNode$2D);const __iconNode$2C=[["path",{d:"M17 22h-1a4 4 0 0 1-4-4V6a4 4 0 0 1 4-4h1",key:"uvaxm9"}],["path",{d:"M7 22h1a4 4 0 0 0 4-4v-1",key:"11xy8d"}],["path",{d:"M7 2h1a4 4 0 0 1 4 4v1",key:"1uw06m"}]],TextCursor=createLucideIcon("text-cursor",__iconNode$2C);const __iconNode$2B=[["path",{d:"M15 5h6",key:"1pr8yx"}],["path",{d:"M15 12h6",key:"upa0zy"}],["path",{d:"M3 19h18",key:"awlh7x"}],["path",{d:"m3 12 3.553-7.724a.5.5 0 0 1 .894 0L11 12",key:"6lvno8"}],["path",{d:"M3.92 10h6.16",key:"1tl8ex"}]],TextInitial=createLucideIcon("text-initial",__iconNode$2B);const __iconNode$2A=[["path",{d:"M17 5H3",key:"1cn7zz"}],["path",{d:"M21 12H8",key:"scolzb"}],["path",{d:"M21 19H8",key:"13qgcb"}],["path",{d:"M3 12v7",key:"1ri8j3"}]],TextQuote=createLucideIcon("text-quote",__iconNode$2A);const __iconNode$2z=[["path",{d:"M21 5H3",key:"1fi0y6"}],["path",{d:"M10 12H3",key:"1ulcyk"}],["path",{d:"M10 19H3",key:"108z41"}],["circle",{cx:"17",cy:"15",r:"3",key:"1upz2a"}],["path",{d:"m21 19-1.9-1.9",key:"dwi7p8"}]],TextSearch=createLucideIcon("text-search",__iconNode$2z);const __iconNode$2y=[["path",{d:"M14 21h1",key:"v9vybs"}],["path",{d:"M14 3h1",key:"1ec4yj"}],["path",{d:"M19 3a2 2 0 0 1 2 2",key:"18rm91"}],["path",{d:"M21 14v1",key:"169vum"}],["path",{d:"M21 19a2 2 0 0 1-2 2",key:"1j7049"}],["path",{d:"M21 9v1",key:"mxsmne"}],["path",{d:"M3 14v1",key:"vnatye"}],["path",{d:"M3 9v1",key:"1r0deq"}],["path",{d:"M5 21a2 2 0 0 1-2-2",key:"sbafld"}],["path",{d:"M5 3a2 2 0 0 0-2 2",key:"y57alp"}],["path",{d:"M7 12h10",key:"b7w52i"}],["path",{d:"M7 16h6",key:"1vyc9m"}],["path",{d:"M7 8h8",key:"1jbsf9"}],["path",{d:"M9 21h1",key:"15o7lz"}],["path",{d:"M9 3h1",key:"1yesri"}]],TextSelect=createLucideIcon("text-select",__iconNode$2y);const __iconNode$2x=[["path",{d:"m16 16-3 3 3 3",key:"117b85"}],["path",{d:"M3 12h14.5a1 1 0 0 1 0 7H13",key:"18xa6z"}],["path",{d:"M3 19h6",key:"1ygdsz"}],["path",{d:"M3 5h18",key:"1u36vt"}]],TextWrap=createLucideIcon("text-wrap",__iconNode$2x);const __iconNode$2w=[["path",{d:"M2 10s3-3 3-8",key:"3xiif0"}],["path",{d:"M22 10s-3-3-3-8",key:"ioaa5q"}],["path",{d:"M10 2c0 4.4-3.6 8-8 8",key:"16fkpi"}],["path",{d:"M14 2c0 4.4 3.6 8 8 8",key:"b9eulq"}],["path",{d:"M2 10s2 2 2 5",key:"1au1lb"}],["path",{d:"M22 10s-2 2-2 5",key:"qi2y5e"}],["path",{d:"M8 15h8",key:"45n4r"}],["path",{d:"M2 22v-1a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v1",key:"1vsc2m"}],["path",{d:"M14 22v-1a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v1",key:"hrha4u"}]],Theater=createLucideIcon("theater",__iconNode$2w);const __iconNode$2v=[["path",{d:"m10 20-1.25-2.5L6 18",key:"18frcb"}],["path",{d:"M10 4 8.75 6.5 6 6",key:"7mghy3"}],["path",{d:"M10.585 15H10",key:"4nqulp"}],["path",{d:"M2 12h6.5L10 9",key:"kv9z4n"}],["path",{d:"M20 14.54a4 4 0 1 1-4 0V4a2 2 0 0 1 4 0z",key:"yu0u2z"}],["path",{d:"m4 10 1.5 2L4 14",key:"k9enpj"}],["path",{d:"m7 21 3-6-1.5-3",key:"j8hb9u"}],["path",{d:"m7 3 3 6h2",key:"1bbqgq"}]],ThermometerSnowflake=createLucideIcon("thermometer-snowflake",__iconNode$2v);const __iconNode$2u=[["path",{d:"M12 9a4 4 0 0 0-2 7.5",key:"1jvsq6"}],["path",{d:"M12 3v2",key:"1w22ol"}],["path",{d:"m6.6 18.4-1.4 1.4",key:"w2yidj"}],["path",{d:"M20 4v10.54a4 4 0 1 1-4 0V4a2 2 0 0 1 4 0Z",key:"iof6y5"}],["path",{d:"M4 13H2",key:"118le4"}],["path",{d:"M6.34 7.34 4.93 5.93",key:"1brd51"}]],ThermometerSun=createLucideIcon("thermometer-sun",__iconNode$2u);const __iconNode$2t=[["path",{d:"M14 4v10.54a4 4 0 1 1-4 0V4a2 2 0 0 1 4 0Z",key:"17jzev"}]],Thermometer=createLucideIcon("thermometer",__iconNode$2t);const __iconNode$2s=[["path",{d:"M17 14V2",key:"8ymqnk"}],["path",{d:"M9 18.12 10 14H4.17a2 2 0 0 1-1.92-2.56l2.33-8A2 2 0 0 1 6.5 2H20a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2h-2.76a2 2 0 0 0-1.79 1.11L12 22a3.13 3.13 0 0 1-3-3.88Z",key:"m61m77"}]],ThumbsDown=createLucideIcon("thumbs-down",__iconNode$2s);const __iconNode$2r=[["path",{d:"M7 10v12",key:"1qc93n"}],["path",{d:"M15 5.88 14 10h5.83a2 2 0 0 1 1.92 2.56l-2.33 8A2 2 0 0 1 17.5 22H4a2 2 0 0 1-2-2v-8a2 2 0 0 1 2-2h2.76a2 2 0 0 0 1.79-1.11L12 2a3.13 3.13 0 0 1 3 3.88Z",key:"emmmcr"}]],ThumbsUp=createLucideIcon("thumbs-up",__iconNode$2r);const __iconNode$2q=[["path",{d:"M2 9a3 3 0 0 1 0 6v2a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-2a3 3 0 0 1 0-6V7a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2Z",key:"qn84l0"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],TicketCheck=createLucideIcon("ticket-check",__iconNode$2q);const __iconNode$2p=[["path",{d:"M2 9a3 3 0 0 1 0 6v2a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-2a3 3 0 0 1 0-6V7a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2Z",key:"qn84l0"}],["path",{d:"M9 12h6",key:"1c52cq"}]],TicketMinus=createLucideIcon("ticket-minus",__iconNode$2p);const __iconNode$2o=[["path",{d:"M2 9a3 3 0 1 1 0 6v2a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-2a3 3 0 1 1 0-6V7a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2Z",key:"1l48ns"}],["path",{d:"M9 9h.01",key:"1q5me6"}],["path",{d:"m15 9-6 6",key:"1uzhvr"}],["path",{d:"M15 15h.01",key:"lqbp3k"}]],TicketPercent=createLucideIcon("ticket-percent",__iconNode$2o);const __iconNode$2n=[["path",{d:"M2 9a3 3 0 0 1 0 6v2a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-2a3 3 0 0 1 0-6V7a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2Z",key:"qn84l0"}],["path",{d:"M9 12h6",key:"1c52cq"}],["path",{d:"M12 9v6",key:"199k2o"}]],TicketPlus=createLucideIcon("ticket-plus",__iconNode$2n);const __iconNode$2m=[["path",{d:"M2 9a3 3 0 0 1 0 6v2a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-2a3 3 0 0 1 0-6V7a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2Z",key:"qn84l0"}],["path",{d:"m9.5 14.5 5-5",key:"qviqfa"}],["path",{d:"m9.5 9.5 5 5",key:"18nt4w"}]],TicketX=createLucideIcon("ticket-x",__iconNode$2m);const __iconNode$2l=[["path",{d:"M2 9a3 3 0 0 1 0 6v2a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-2a3 3 0 0 1 0-6V7a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2Z",key:"qn84l0"}],["path",{d:"m9.5 14.5 5-5",key:"qviqfa"}]],TicketSlash=createLucideIcon("ticket-slash",__iconNode$2l);const __iconNode$2k=[["path",{d:"M10.5 17h1.227a2 2 0 0 0 1.345-.52L18 12",key:"16muxl"}],["path",{d:"m12 13.5 3.75.5",key:"1i9qhk"}],["path",{d:"m4.5 8 10.58-5.06a1 1 0 0 1 1.342.488L18.5 8",key:"12lg5p"}],["path",{d:"M6 10V8",key:"1y41hn"}],["path",{d:"M6 14v1",key:"cao2tf"}],["path",{d:"M6 19v2",key:"1loha6"}],["rect",{x:"2",y:"8",width:"20",height:"13",rx:"2",key:"p3bz5l"}]],TicketsPlane=createLucideIcon("tickets-plane",__iconNode$2k);const __iconNode$2j=[["path",{d:"M2 9a3 3 0 0 1 0 6v2a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-2a3 3 0 0 1 0-6V7a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2Z",key:"qn84l0"}],["path",{d:"M13 5v2",key:"dyzc3o"}],["path",{d:"M13 17v2",key:"1ont0d"}],["path",{d:"M13 11v2",key:"1wjjxi"}]],Ticket=createLucideIcon("ticket",__iconNode$2j);const __iconNode$2i=[["path",{d:"m4.5 8 10.58-5.06a1 1 0 0 1 1.342.488L18.5 8",key:"12lg5p"}],["path",{d:"M6 10V8",key:"1y41hn"}],["path",{d:"M6 14v1",key:"cao2tf"}],["path",{d:"M6 19v2",key:"1loha6"}],["rect",{x:"2",y:"8",width:"20",height:"13",rx:"2",key:"p3bz5l"}]],Tickets=createLucideIcon("tickets",__iconNode$2i);const __iconNode$2h=[["path",{d:"M10 2h4",key:"n1abiw"}],["path",{d:"M4.6 11a8 8 0 0 0 1.7 8.7 8 8 0 0 0 8.7 1.7",key:"10he05"}],["path",{d:"M7.4 7.4a8 8 0 0 1 10.3 1 8 8 0 0 1 .9 10.2",key:"15f7sh"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M12 12v-2",key:"fwoke6"}]],TimerOff=createLucideIcon("timer-off",__iconNode$2h);const __iconNode$2g=[["path",{d:"M10 2h4",key:"n1abiw"}],["path",{d:"M12 14v-4",key:"1evpnu"}],["path",{d:"M4 13a8 8 0 0 1 8-7 8 8 0 1 1-5.3 14L4 17.6",key:"1ts96g"}],["path",{d:"M9 17H4v5",key:"8t5av"}]],TimerReset=createLucideIcon("timer-reset",__iconNode$2g);const __iconNode$2f=[["line",{x1:"10",x2:"14",y1:"2",y2:"2",key:"14vaq8"}],["line",{x1:"12",x2:"15",y1:"14",y2:"11",key:"17fdiu"}],["circle",{cx:"12",cy:"14",r:"8",key:"1e1u0o"}]],Timer$1=createLucideIcon("timer",__iconNode$2f);const __iconNode$2e=[["circle",{cx:"9",cy:"12",r:"3",key:"u3jwor"}],["rect",{width:"20",height:"14",x:"2",y:"5",rx:"7",key:"g7kal2"}]],ToggleLeft=createLucideIcon("toggle-left",__iconNode$2e);const __iconNode$2d=[["circle",{cx:"15",cy:"12",r:"3",key:"1afu0r"}],["rect",{width:"20",height:"14",x:"2",y:"5",rx:"7",key:"g7kal2"}]],ToggleRight=createLucideIcon("toggle-right",__iconNode$2d);const __iconNode$2c=[["path",{d:"M7 12h13a1 1 0 0 1 1 1 5 5 0 0 1-5 5h-.598a.5.5 0 0 0-.424.765l1.544 2.47a.5.5 0 0 1-.424.765H5.402a.5.5 0 0 1-.424-.765L7 18",key:"kc4kqr"}],["path",{d:"M8 18a5 5 0 0 1-5-5V4a2 2 0 0 1 2-2h8a2 2 0 0 1 2 2v8",key:"1tqs57"}]],Toilet=createLucideIcon("toilet",__iconNode$2c);const __iconNode$2b=[["path",{d:"M10 15h4",key:"192ueg"}],["path",{d:"m14.817 10.995-.971-1.45 1.034-1.232a2 2 0 0 0-2.025-3.238l-1.82.364L9.91 3.885a2 2 0 0 0-3.625.748L6.141 6.55l-1.725.426a2 2 0 0 0-.19 3.756l.657.27",key:"xbnumr"}],["path",{d:"m18.822 10.995 2.26-5.38a1 1 0 0 0-.557-1.318L16.954 2.9a1 1 0 0 0-1.281.533l-.924 2.122",key:"eaw7gc"}],["path",{d:"M4 12.006A1 1 0 0 1 4.994 11H19a1 1 0 0 1 1 1v7a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2z",key:"1vaooh"}]],ToolCase=createLucideIcon("tool-case",__iconNode$2b);const __iconNode$2a=[["path",{d:"M21 4H3",key:"1hwok0"}],["path",{d:"M18 8H6",key:"41n648"}],["path",{d:"M19 12H9",key:"1g4lpz"}],["path",{d:"M16 16h-6",key:"1j5d54"}],["path",{d:"M11 20H9",key:"39obr8"}]],Tornado=createLucideIcon("tornado",__iconNode$2a);const __iconNode$29=[["ellipse",{cx:"12",cy:"11",rx:"3",ry:"2",key:"1b2qxu"}],["ellipse",{cx:"12",cy:"12.5",rx:"10",ry:"8.5",key:"h8emeu"}]],Torus=createLucideIcon("torus",__iconNode$29);const __iconNode$28=[["path",{d:"M12 20v-6",key:"1rm09r"}],["path",{d:"M19.656 14H22",key:"170xzr"}],["path",{d:"M2 14h12",key:"d8icqz"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M20 20H4a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2",key:"s23sx2"}],["path",{d:"M9.656 4H20a2 2 0 0 1 2 2v10.344",key:"ovjcvl"}]],TouchpadOff=createLucideIcon("touchpad-off",__iconNode$28);const __iconNode$27=[["rect",{width:"20",height:"16",x:"2",y:"4",rx:"2",key:"18n3k1"}],["path",{d:"M2 14h20",key:"myj16y"}],["path",{d:"M12 20v-6",key:"1rm09r"}]],Touchpad=createLucideIcon("touchpad",__iconNode$27);const __iconNode$26=[["path",{d:"M18.2 12.27 20 6H4l1.8 6.27a1 1 0 0 0 .95.73h10.5a1 1 0 0 0 .96-.73Z",key:"1pledb"}],["path",{d:"M8 13v9",key:"hmv0ci"}],["path",{d:"M16 22v-9",key:"ylnf1u"}],["path",{d:"m9 6 1 7",key:"dpdgam"}],["path",{d:"m15 6-1 7",key:"ls7zgu"}],["path",{d:"M12 6V2",key:"1pj48d"}],["path",{d:"M13 2h-2",key:"mj6ths"}]],TowerControl=createLucideIcon("tower-control",__iconNode$26);const __iconNode$25=[["rect",{width:"18",height:"12",x:"3",y:"8",rx:"1",key:"158fvp"}],["path",{d:"M10 8V5c0-.6-.4-1-1-1H6a1 1 0 0 0-1 1v3",key:"s0042v"}],["path",{d:"M19 8V5c0-.6-.4-1-1-1h-3a1 1 0 0 0-1 1v3",key:"9wmeh2"}]],ToyBrick=createLucideIcon("toy-brick",__iconNode$25);const __iconNode$24=[["path",{d:"m10 11 11 .9a1 1 0 0 1 .8 1.1l-.665 4.158a1 1 0 0 1-.988.842H20",key:"she1j9"}],["path",{d:"M16 18h-5",key:"bq60fd"}],["path",{d:"M18 5a1 1 0 0 0-1 1v5.573",key:"1kv8ia"}],["path",{d:"M3 4h8.129a1 1 0 0 1 .99.863L13 11.246",key:"1q1ert"}],["path",{d:"M4 11V4",key:"9ft8pt"}],["path",{d:"M7 15h.01",key:"k5ht0j"}],["path",{d:"M8 10.1V4",key:"1jgyzo"}],["circle",{cx:"18",cy:"18",r:"2",key:"1emm8v"}],["circle",{cx:"7",cy:"15",r:"5",key:"ddtuc"}]],Tractor=createLucideIcon("tractor",__iconNode$24);const __iconNode$23=[["path",{d:"M16.05 10.966a5 2.5 0 0 1-8.1 0",key:"m5jpwb"}],["path",{d:"m16.923 14.049 4.48 2.04a1 1 0 0 1 .001 1.831l-8.574 3.9a2 2 0 0 1-1.66 0l-8.574-3.91a1 1 0 0 1 0-1.83l4.484-2.04",key:"rbg3g8"}],["path",{d:"M16.949 14.14a5 2.5 0 1 1-9.9 0L10.063 3.5a2 2 0 0 1 3.874 0z",key:"vap8c8"}],["path",{d:"M9.194 6.57a5 2.5 0 0 0 5.61 0",key:"15hn5c"}]],TrafficCone=createLucideIcon("traffic-cone",__iconNode$23);const __iconNode$22=[["path",{d:"M2 22V12a10 10 0 1 1 20 0v10",key:"o0fyp0"}],["path",{d:"M15 6.8v1.4a3 2.8 0 1 1-6 0V6.8",key:"m8q3n9"}],["path",{d:"M10 15h.01",key:"44in9x"}],["path",{d:"M14 15h.01",key:"5mohn5"}],["path",{d:"M10 19a4 4 0 0 1-4-4v-3a6 6 0 1 1 12 0v3a4 4 0 0 1-4 4Z",key:"hckbmu"}],["path",{d:"m9 19-2 3",key:"iij7hm"}],["path",{d:"m15 19 2 3",key:"npx8sa"}]],TrainFrontTunnel=createLucideIcon("train-front-tunnel",__iconNode$22);const __iconNode$21=[["path",{d:"M8 3.1V7a4 4 0 0 0 8 0V3.1",key:"1v71zp"}],["path",{d:"m9 15-1-1",key:"1yrq24"}],["path",{d:"m15 15 1-1",key:"1t0d6s"}],["path",{d:"M9 19c-2.8 0-5-2.2-5-5v-4a8 8 0 0 1 16 0v4c0 2.8-2.2 5-5 5Z",key:"1p0hjs"}],["path",{d:"m8 19-2 3",key:"13i0xs"}],["path",{d:"m16 19 2 3",key:"xo31yx"}]],TrainFront=createLucideIcon("train-front",__iconNode$21);const __iconNode$20=[["path",{d:"M2 17 17 2",key:"18b09t"}],["path",{d:"m2 14 8 8",key:"1gv9hu"}],["path",{d:"m5 11 8 8",key:"189pqp"}],["path",{d:"m8 8 8 8",key:"1imecy"}],["path",{d:"m11 5 8 8",key:"ummqn6"}],["path",{d:"m14 2 8 8",key:"1vk7dn"}],["path",{d:"M7 22 22 7",key:"15mb1i"}]],TrainTrack=createLucideIcon("train-track",__iconNode$20);const __iconNode$1$=[["path",{d:"M12 16v6",key:"c8a4gj"}],["path",{d:"M14 20h-4",key:"m8m19d"}],["path",{d:"M18 2h4v4",key:"1341mj"}],["path",{d:"m2 2 7.17 7.17",key:"13q8l2"}],["path",{d:"M2 5.355V2h3.357",key:"18136r"}],["path",{d:"m22 2-7.17 7.17",key:"1epvy4"}],["path",{d:"M8 5 5 8",key:"mgbjhz"}],["circle",{cx:"12",cy:"12",r:"4",key:"4exip2"}]],Transgender=createLucideIcon("transgender",__iconNode$1$);const __iconNode$1_=[["rect",{width:"16",height:"16",x:"4",y:"3",rx:"2",key:"1wxw4b"}],["path",{d:"M4 11h16",key:"mpoxn0"}],["path",{d:"M12 3v8",key:"1h2ygw"}],["path",{d:"m8 19-2 3",key:"13i0xs"}],["path",{d:"m18 22-2-3",key:"1p0ohu"}],["path",{d:"M8 15h.01",key:"a7atzg"}],["path",{d:"M16 15h.01",key:"rnfrdf"}]],TramFront=createLucideIcon("tram-front",__iconNode$1_);const __iconNode$1Z=[["path",{d:"M10 11v6",key:"nco0om"}],["path",{d:"M14 11v6",key:"outv1u"}],["path",{d:"M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6",key:"miytrc"}],["path",{d:"M3 6h18",key:"d0wm0j"}],["path",{d:"M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2",key:"e791ji"}]],Trash2=createLucideIcon("trash-2",__iconNode$1Z);const __iconNode$1Y=[["path",{d:"M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6",key:"miytrc"}],["path",{d:"M3 6h18",key:"d0wm0j"}],["path",{d:"M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2",key:"e791ji"}]],Trash=createLucideIcon("trash",__iconNode$1Y);const __iconNode$1X=[["path",{d:"M8 19a4 4 0 0 1-2.24-7.32A3.5 3.5 0 0 1 9 6.03V6a3 3 0 1 1 6 0v.04a3.5 3.5 0 0 1 3.24 5.65A4 4 0 0 1 16 19Z",key:"oadzkq"}],["path",{d:"M12 19v3",key:"npa21l"}]],TreeDeciduous=createLucideIcon("tree-deciduous",__iconNode$1X);const __iconNode$1W=[["path",{d:"M13 8c0-2.76-2.46-5-5.5-5S2 5.24 2 8h2l1-1 1 1h4",key:"foxbe7"}],["path",{d:"M13 7.14A5.82 5.82 0 0 1 16.5 6c3.04 0 5.5 2.24 5.5 5h-3l-1-1-1 1h-3",key:"18arnh"}],["path",{d:"M5.89 9.71c-2.15 2.15-2.3 5.47-.35 7.43l4.24-4.25.7-.7.71-.71 2.12-2.12c-1.95-1.96-5.27-1.8-7.42.35",key:"ywahnh"}],["path",{d:"M11 15.5c.5 2.5-.17 4.5-1 6.5h4c2-5.5-.5-12-1-14",key:"ft0feo"}]],TreePalm=createLucideIcon("tree-palm",__iconNode$1W);const __iconNode$1V=[["path",{d:"m17 14 3 3.3a1 1 0 0 1-.7 1.7H4.7a1 1 0 0 1-.7-1.7L7 14h-.3a1 1 0 0 1-.7-1.7L9 9h-.2A1 1 0 0 1 8 7.3L12 3l4 4.3a1 1 0 0 1-.8 1.7H15l3 3.3a1 1 0 0 1-.7 1.7H17Z",key:"cpyugq"}],["path",{d:"M12 22v-3",key:"kmzjlo"}]],TreePine=createLucideIcon("tree-pine",__iconNode$1V);const __iconNode$1U=[["path",{d:"M10 10v.2A3 3 0 0 1 8.9 16H5a3 3 0 0 1-1-5.8V10a3 3 0 0 1 6 0Z",key:"1l6gj6"}],["path",{d:"M7 16v6",key:"1a82de"}],["path",{d:"M13 19v3",key:"13sx9i"}],["path",{d:"M12 19h8.3a1 1 0 0 0 .7-1.7L18 14h.3a1 1 0 0 0 .7-1.7L16 9h.2a1 1 0 0 0 .8-1.7L13 3l-1.4 1.5",key:"1sj9kv"}]],Trees=createLucideIcon("trees",__iconNode$1U);const __iconNode$1T=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",ry:"2",key:"1m3agn"}],["rect",{width:"3",height:"9",x:"7",y:"7",key:"14n3xi"}],["rect",{width:"3",height:"5",x:"14",y:"7",key:"s4azjd"}]],Trello=createLucideIcon("trello",__iconNode$1T);const __iconNode$1S=[["path",{d:"M16 17h6v-6",key:"t6n2it"}],["path",{d:"m22 17-8.5-8.5-5 5L2 7",key:"x473p"}]],TrendingDown=createLucideIcon("trending-down",__iconNode$1S);const __iconNode$1R=[["path",{d:"M14.828 14.828 21 21",key:"ar5fw7"}],["path",{d:"M21 16v5h-5",key:"1ck2sf"}],["path",{d:"m21 3-9 9-4-4-6 6",key:"1h02xo"}],["path",{d:"M21 8V3h-5",key:"1qoq8a"}]],TrendingUpDown=createLucideIcon("trending-up-down",__iconNode$1R);const __iconNode$1Q=[["path",{d:"M16 7h6v6",key:"box55l"}],["path",{d:"m22 7-8.5 8.5-5-5L2 17",key:"1t1m79"}]],TrendingUp=createLucideIcon("trending-up",__iconNode$1Q);const __iconNode$1P=[["path",{d:"m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3",key:"wmoenq"}],["path",{d:"M12 9v4",key:"juzpu7"}],["path",{d:"M12 17h.01",key:"p32p05"}]],TriangleAlert=createLucideIcon("triangle-alert",__iconNode$1P);const __iconNode$1O=[["path",{d:"M10.17 4.193a2 2 0 0 1 3.666.013",key:"pltmmw"}],["path",{d:"M14 21h2",key:"v4qezv"}],["path",{d:"m15.874 7.743 1 1.732",key:"10m0iw"}],["path",{d:"m18.849 12.952 1 1.732",key:"zadnam"}],["path",{d:"M21.824 18.18a2 2 0 0 1-1.835 2.824",key:"fvwuk4"}],["path",{d:"M4.024 21a2 2 0 0 1-1.839-2.839",key:"1e1kah"}],["path",{d:"m5.136 12.952-1 1.732",key:"1u4ldi"}],["path",{d:"M8 21h2",key:"i9zjee"}],["path",{d:"m8.102 7.743-1 1.732",key:"1zzo4u"}]],TriangleDashed=createLucideIcon("triangle-dashed",__iconNode$1O);const __iconNode$1N=[["path",{d:"M22 18a2 2 0 0 1-2 2H3c-1.1 0-1.3-.6-.4-1.3L20.4 4.3c.9-.7 1.6-.4 1.6.7Z",key:"183wce"}]],TriangleRight=createLucideIcon("triangle-right",__iconNode$1N);const __iconNode$1M=[["path",{d:"M13.73 4a2 2 0 0 0-3.46 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3Z",key:"14u9p9"}]],Triangle=createLucideIcon("triangle",__iconNode$1M);const __iconNode$1L=[["path",{d:"M10 14.66v1.626a2 2 0 0 1-.976 1.696A5 5 0 0 0 7 21.978",key:"1n3hpd"}],["path",{d:"M14 14.66v1.626a2 2 0 0 0 .976 1.696A5 5 0 0 1 17 21.978",key:"rfe1zi"}],["path",{d:"M18 9h1.5a1 1 0 0 0 0-5H18",key:"7xy6bh"}],["path",{d:"M4 22h16",key:"57wxv0"}],["path",{d:"M6 9a6 6 0 0 0 12 0V3a1 1 0 0 0-1-1H7a1 1 0 0 0-1 1z",key:"1mhfuq"}],["path",{d:"M6 9H4.5a1 1 0 0 1 0-5H6",key:"tex48p"}]],Trophy=createLucideIcon("trophy",__iconNode$1L);const __iconNode$1K=[["path",{d:"M14 19V7a2 2 0 0 0-2-2H9",key:"15peso"}],["path",{d:"M15 19H9",key:"18q6dt"}],["path",{d:"M19 19h2a1 1 0 0 0 1-1v-3.65a1 1 0 0 0-.22-.62L18.3 9.38a1 1 0 0 0-.78-.38H14",key:"1dkp3j"}],["path",{d:"M2 13v5a1 1 0 0 0 1 1h2",key:"pkmmzz"}],["path",{d:"M4 3 2.15 5.15a.495.495 0 0 0 .35.86h2.15a.47.47 0 0 1 .35.86L3 9.02",key:"1n26pd"}],["circle",{cx:"17",cy:"19",r:"2",key:"1nxcgd"}],["circle",{cx:"7",cy:"19",r:"2",key:"gzo7y7"}]],TruckElectric=createLucideIcon("truck-electric",__iconNode$1K);const __iconNode$1J=[["path",{d:"M14 18V6a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v11a1 1 0 0 0 1 1h2",key:"wrbu53"}],["path",{d:"M15 18H9",key:"1lyqi6"}],["path",{d:"M19 18h2a1 1 0 0 0 1-1v-3.65a1 1 0 0 0-.22-.624l-3.48-4.35A1 1 0 0 0 17.52 8H14",key:"lysw3i"}],["circle",{cx:"17",cy:"18",r:"2",key:"332jqn"}],["circle",{cx:"7",cy:"18",r:"2",key:"19iecd"}]],Truck=createLucideIcon("truck",__iconNode$1J);const __iconNode$1I=[["path",{d:"M15 4 5 9",key:"14bkc9"}],["path",{d:"m15 8.5-10 5",key:"1grtsx"}],["path",{d:"M18 12a9 9 0 0 1-9 9V3",key:"1sst7f"}]],TurkishLira=createLucideIcon("turkish-lira",__iconNode$1I);const __iconNode$1H=[["path",{d:"M10 12.01h.01",key:"7rp0yl"}],["path",{d:"M18 8v4a8 8 0 0 1-1.07 4",key:"1st48v"}],["circle",{cx:"10",cy:"12",r:"4",key:"19levz"}],["rect",{x:"2",y:"4",width:"20",height:"16",rx:"2",key:"izxlao"}]],Turntable=createLucideIcon("turntable",__iconNode$1H);const __iconNode$1G=[["path",{d:"m12 10 2 4v3a1 1 0 0 0 1 1h2a1 1 0 0 0 1-1v-3a8 8 0 1 0-16 0v3a1 1 0 0 0 1 1h2a1 1 0 0 0 1-1v-3l2-4h4Z",key:"1lbbv7"}],["path",{d:"M4.82 7.9 8 10",key:"m9wose"}],["path",{d:"M15.18 7.9 12 10",key:"p8dp2u"}],["path",{d:"M16.93 10H20a2 2 0 0 1 0 4H2",key:"12nsm7"}]],Turtle=createLucideIcon("turtle",__iconNode$1G);const __iconNode$1F=[["path",{d:"M15.033 9.44a.647.647 0 0 1 0 1.12l-4.065 2.352a.645.645 0 0 1-.968-.56V7.648a.645.645 0 0 1 .967-.56z",key:"vbtd3f"}],["path",{d:"M7 21h10",key:"1b0cd5"}],["rect",{width:"20",height:"14",x:"2",y:"3",rx:"2",key:"48i651"}]],TvMinimalPlay=createLucideIcon("tv-minimal-play",__iconNode$1F);const __iconNode$1E=[["path",{d:"M7 21h10",key:"1b0cd5"}],["rect",{width:"20",height:"14",x:"2",y:"3",rx:"2",key:"48i651"}]],TvMinimal=createLucideIcon("tv-minimal",__iconNode$1E);const __iconNode$1D=[["path",{d:"m17 2-5 5-5-5",key:"16satq"}],["rect",{width:"20",height:"15",x:"2",y:"7",rx:"2",key:"1e6viu"}]],Tv=createLucideIcon("tv",__iconNode$1D);const __iconNode$1C=[["path",{d:"M21 2H3v16h5v4l4-4h5l4-4V2zm-10 9V7m5 4V7",key:"c0yzno"}]],Twitch=createLucideIcon("twitch",__iconNode$1C);const __iconNode$1B=[["path",{d:"M22 4s-.7 2.1-2 3.4c1.6 10-9.4 17.3-18 11.6 2.2.1 4.4-.6 6-2C3 15.5.5 9.6 3 5c2.2 2.6 5.6 4.1 9 4-.9-4.2 4-6.6 7-3.8 1.1 0 3-1.2 3-1.2z",key:"pff0z6"}]],Twitter=createLucideIcon("twitter",__iconNode$1B);const __iconNode$1A=[["path",{d:"M14 16.5a.5.5 0 0 0 .5.5h.5a2 2 0 0 1 0 4H9a2 2 0 0 1 0-4h.5a.5.5 0 0 0 .5-.5v-9a.5.5 0 0 0-.5-.5h-3a.5.5 0 0 0-.5.5V8a2 2 0 0 1-4 0V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v3a2 2 0 0 1-4 0v-.5a.5.5 0 0 0-.5-.5h-3a.5.5 0 0 0-.5.5Z",key:"1reda3"}]],TypeOutline=createLucideIcon("type-outline",__iconNode$1A);const __iconNode$1z=[["path",{d:"M12 4v16",key:"1654pz"}],["path",{d:"M4 7V5a1 1 0 0 1 1-1h14a1 1 0 0 1 1 1v2",key:"e0r10z"}],["path",{d:"M9 20h6",key:"s66wpe"}]],Type$2=createLucideIcon("type",__iconNode$1z);const __iconNode$1y=[["path",{d:"M12 13v7a2 2 0 0 0 4 0",key:"rpgb42"}],["path",{d:"M12 2v2",key:"tus03m"}],["path",{d:"M18.656 13h2.336a1 1 0 0 0 .97-1.274 10.284 10.284 0 0 0-12.07-7.51",key:"yawknk"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"M5.961 5.957a10.28 10.28 0 0 0-3.922 5.769A1 1 0 0 0 3 13h10",key:"5sfalc"}]],UmbrellaOff=createLucideIcon("umbrella-off",__iconNode$1y);const __iconNode$1x=[["path",{d:"M12 13v7a2 2 0 0 0 4 0",key:"rpgb42"}],["path",{d:"M12 2v2",key:"tus03m"}],["path",{d:"M20.992 13a1 1 0 0 0 .97-1.274 10.284 10.284 0 0 0-19.923 0A1 1 0 0 0 3 13z",key:"124nyo"}]],Umbrella=createLucideIcon("umbrella",__iconNode$1x);const __iconNode$1w=[["path",{d:"M6 4v6a6 6 0 0 0 12 0V4",key:"9kb039"}],["line",{x1:"4",x2:"20",y1:"20",y2:"20",key:"nun2al"}]],Underline=createLucideIcon("underline",__iconNode$1w);const __iconNode$1v=[["path",{d:"M9 14 4 9l5-5",key:"102s5s"}],["path",{d:"M4 9h10.5a5.5 5.5 0 0 1 5.5 5.5a5.5 5.5 0 0 1-5.5 5.5H11",key:"f3b9sd"}]],Undo2=createLucideIcon("undo-2",__iconNode$1v);const __iconNode$1u=[["path",{d:"M21 17a9 9 0 0 0-15-6.7L3 13",key:"8mp6z9"}],["path",{d:"M3 7v6h6",key:"1v2h90"}],["circle",{cx:"12",cy:"17",r:"1",key:"1ixnty"}]],UndoDot=createLucideIcon("undo-dot",__iconNode$1u);const __iconNode$1t=[["path",{d:"M3 7v6h6",key:"1v2h90"}],["path",{d:"M21 17a9 9 0 0 0-9-9 9 9 0 0 0-6 2.3L3 13",key:"1r6uu6"}]],Undo=createLucideIcon("undo",__iconNode$1t);const __iconNode$1s=[["path",{d:"M16 12h6",key:"15xry1"}],["path",{d:"M8 12H2",key:"1jqql6"}],["path",{d:"M12 2v2",key:"tus03m"}],["path",{d:"M12 8v2",key:"1woqiv"}],["path",{d:"M12 14v2",key:"8jcxud"}],["path",{d:"M12 20v2",key:"1lh1kg"}],["path",{d:"m19 15 3-3-3-3",key:"wjy7rq"}],["path",{d:"m5 9-3 3 3 3",key:"j64kie"}]],UnfoldHorizontal=createLucideIcon("unfold-horizontal",__iconNode$1s);const __iconNode$1r=[["path",{d:"M12 22v-6",key:"6o8u61"}],["path",{d:"M12 8V2",key:"1wkif3"}],["path",{d:"M4 12H2",key:"rhcxmi"}],["path",{d:"M10 12H8",key:"s88cx1"}],["path",{d:"M16 12h-2",key:"10asgb"}],["path",{d:"M22 12h-2",key:"14jgyd"}],["path",{d:"m15 19-3 3-3-3",key:"11eu04"}],["path",{d:"m15 5-3-3-3 3",key:"itvq4r"}]],UnfoldVertical=createLucideIcon("unfold-vertical",__iconNode$1r);const __iconNode$1q=[["path",{d:"M14 21v-3a2 2 0 0 0-4 0v3",key:"1rgiei"}],["path",{d:"M18 12h.01",key:"yjnet6"}],["path",{d:"M18 16h.01",key:"plv8zi"}],["path",{d:"M22 7a1 1 0 0 0-1-1h-2a2 2 0 0 1-1.143-.359L13.143 2.36a2 2 0 0 0-2.286-.001L6.143 5.64A2 2 0 0 1 5 6H3a1 1 0 0 0-1 1v12a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2z",key:"1ogmi3"}],["path",{d:"M6 12h.01",key:"c2rlol"}],["path",{d:"M6 16h.01",key:"1pmjb7"}],["circle",{cx:"12",cy:"10",r:"2",key:"1yojzk"}]],University=createLucideIcon("university",__iconNode$1q);const __iconNode$1p=[["rect",{width:"8",height:"6",x:"5",y:"4",rx:"1",key:"nzclkv"}],["rect",{width:"8",height:"6",x:"11",y:"14",rx:"1",key:"4tytwb"}]],Ungroup=createLucideIcon("ungroup",__iconNode$1p);const __iconNode$1o=[["path",{d:"M15 7h2a5 5 0 0 1 0 10h-2m-6 0H7A5 5 0 0 1 7 7h2",key:"1re2ne"}]],Unlink2=createLucideIcon("unlink-2",__iconNode$1o);const __iconNode$1n=[["path",{d:"m18.84 12.25 1.72-1.71h-.02a5.004 5.004 0 0 0-.12-7.07 5.006 5.006 0 0 0-6.95 0l-1.72 1.71",key:"yqzxt4"}],["path",{d:"m5.17 11.75-1.71 1.71a5.004 5.004 0 0 0 .12 7.07 5.006 5.006 0 0 0 6.95 0l1.71-1.71",key:"4qinb0"}],["line",{x1:"8",x2:"8",y1:"2",y2:"5",key:"1041cp"}],["line",{x1:"2",x2:"5",y1:"8",y2:"8",key:"14m1p5"}],["line",{x1:"16",x2:"16",y1:"19",y2:"22",key:"rzdirn"}],["line",{x1:"19",x2:"22",y1:"16",y2:"16",key:"ox905f"}]],Unlink=createLucideIcon("unlink",__iconNode$1n);const __iconNode$1m=[["path",{d:"m19 5 3-3",key:"yk6iyv"}],["path",{d:"m2 22 3-3",key:"19mgm9"}],["path",{d:"M6.3 20.3a2.4 2.4 0 0 0 3.4 0L12 18l-6-6-2.3 2.3a2.4 2.4 0 0 0 0 3.4Z",key:"goz73y"}],["path",{d:"M7.5 13.5 10 11",key:"7xgeeb"}],["path",{d:"M10.5 16.5 13 14",key:"10btkg"}],["path",{d:"m12 6 6 6 2.3-2.3a2.4 2.4 0 0 0 0-3.4l-2.6-2.6a2.4 2.4 0 0 0-3.4 0Z",key:"1snsnr"}]],Unplug=createLucideIcon("unplug",__iconNode$1m);const __iconNode$1l=[["path",{d:"M12 3v12",key:"1x0j5s"}],["path",{d:"m17 8-5-5-5 5",key:"7q97r8"}],["path",{d:"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4",key:"ih7n3h"}]],Upload=createLucideIcon("upload",__iconNode$1l);const __iconNode$1k=[["circle",{cx:"10",cy:"7",r:"1",key:"dypaad"}],["circle",{cx:"4",cy:"20",r:"1",key:"22iqad"}],["path",{d:"M4.7 19.3 19 5",key:"1enqfc"}],["path",{d:"m21 3-3 1 2 2Z",key:"d3ov82"}],["path",{d:"M9.26 7.68 5 12l2 5",key:"1esawj"}],["path",{d:"m10 14 5 2 3.5-3.5",key:"v8oal5"}],["path",{d:"m18 12 1-1 1 1-1 1Z",key:"1bh22v"}]],Usb=createLucideIcon("usb",__iconNode$1k);const __iconNode$1j=[["path",{d:"m16 11 2 2 4-4",key:"9rsbq5"}],["path",{d:"M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2",key:"1yyitq"}],["circle",{cx:"9",cy:"7",r:"4",key:"nufk8"}]],UserCheck=createLucideIcon("user-check",__iconNode$1j);const __iconNode$1i=[["path",{d:"M10 15H6a4 4 0 0 0-4 4v2",key:"1nfge6"}],["path",{d:"m14.305 16.53.923-.382",key:"1itpsq"}],["path",{d:"m15.228 13.852-.923-.383",key:"eplpkm"}],["path",{d:"m16.852 12.228-.383-.923",key:"13v3q0"}],["path",{d:"m16.852 17.772-.383.924",key:"1i8mnm"}],["path",{d:"m19.148 12.228.383-.923",key:"1q8j1v"}],["path",{d:"m19.53 18.696-.382-.924",key:"vk1qj3"}],["path",{d:"m20.772 13.852.924-.383",key:"n880s0"}],["path",{d:"m20.772 16.148.924.383",key:"1g6xey"}],["circle",{cx:"18",cy:"15",r:"3",key:"gjjjvw"}],["circle",{cx:"9",cy:"7",r:"4",key:"nufk8"}]],UserCog=createLucideIcon("user-cog",__iconNode$1i);const __iconNode$1h=[["circle",{cx:"10",cy:"7",r:"4",key:"e45bow"}],["path",{d:"M10.3 15H7a4 4 0 0 0-4 4v2",key:"3bnktk"}],["path",{d:"M15 15.5V14a2 2 0 0 1 4 0v1.5",key:"12ym5i"}],["rect",{width:"8",height:"5",x:"13",y:"16",rx:".899",key:"4p176n"}]],UserLock=createLucideIcon("user-lock",__iconNode$1h);const __iconNode$1g=[["path",{d:"M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2",key:"1yyitq"}],["circle",{cx:"9",cy:"7",r:"4",key:"nufk8"}],["line",{x1:"22",x2:"16",y1:"11",y2:"11",key:"1shjgl"}]],UserMinus=createLucideIcon("user-minus",__iconNode$1g);const __iconNode$1f=[["path",{d:"M11.5 15H7a4 4 0 0 0-4 4v2",key:"15lzij"}],["path",{d:"M21.378 16.626a1 1 0 0 0-3.004-3.004l-4.01 4.012a2 2 0 0 0-.506.854l-.837 2.87a.5.5 0 0 0 .62.62l2.87-.837a2 2 0 0 0 .854-.506z",key:"1817ys"}],["circle",{cx:"10",cy:"7",r:"4",key:"e45bow"}]],UserPen=createLucideIcon("user-pen",__iconNode$1f);const __iconNode$1e=[["path",{d:"M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2",key:"1yyitq"}],["circle",{cx:"9",cy:"7",r:"4",key:"nufk8"}],["line",{x1:"19",x2:"19",y1:"8",y2:"14",key:"1bvyxn"}],["line",{x1:"22",x2:"16",y1:"11",y2:"11",key:"1shjgl"}]],UserPlus=createLucideIcon("user-plus",__iconNode$1e);const __iconNode$1d=[["path",{d:"M2 21a8 8 0 0 1 13.292-6",key:"bjp14o"}],["circle",{cx:"10",cy:"8",r:"5",key:"o932ke"}],["path",{d:"m16 19 2 2 4-4",key:"1b14m6"}]],UserRoundCheck=createLucideIcon("user-round-check",__iconNode$1d);const __iconNode$1c=[["path",{d:"m14.305 19.53.923-.382",key:"3m78fa"}],["path",{d:"m15.228 16.852-.923-.383",key:"npixar"}],["path",{d:"m16.852 15.228-.383-.923",key:"5xggr7"}],["path",{d:"m16.852 20.772-.383.924",key:"dpfhf9"}],["path",{d:"m19.148 15.228.383-.923",key:"1reyyz"}],["path",{d:"m19.53 21.696-.382-.924",key:"1goivc"}],["path",{d:"M2 21a8 8 0 0 1 10.434-7.62",key:"1yezr2"}],["path",{d:"m20.772 16.852.924-.383",key:"htqkph"}],["path",{d:"m20.772 19.148.924.383",key:"9w9pjp"}],["circle",{cx:"10",cy:"8",r:"5",key:"o932ke"}],["circle",{cx:"18",cy:"18",r:"3",key:"1xkwt0"}]],UserRoundCog=createLucideIcon("user-round-cog",__iconNode$1c);const __iconNode$1b=[["path",{d:"M2 21a8 8 0 0 1 13.292-6",key:"bjp14o"}],["circle",{cx:"10",cy:"8",r:"5",key:"o932ke"}],["path",{d:"M22 19h-6",key:"vcuq98"}]],UserRoundMinus=createLucideIcon("user-round-minus",__iconNode$1b);const __iconNode$1a=[["path",{d:"M2 21a8 8 0 0 1 10.821-7.487",key:"1c8h7z"}],["path",{d:"M21.378 16.626a1 1 0 0 0-3.004-3.004l-4.01 4.012a2 2 0 0 0-.506.854l-.837 2.87a.5.5 0 0 0 .62.62l2.87-.837a2 2 0 0 0 .854-.506z",key:"1817ys"}],["circle",{cx:"10",cy:"8",r:"5",key:"o932ke"}]],UserRoundPen=createLucideIcon("user-round-pen",__iconNode$1a);const __iconNode$19=[["path",{d:"M2 21a8 8 0 0 1 13.292-6",key:"bjp14o"}],["circle",{cx:"10",cy:"8",r:"5",key:"o932ke"}],["path",{d:"M19 16v6",key:"tddt3s"}],["path",{d:"M22 19h-6",key:"vcuq98"}]],UserRoundPlus=createLucideIcon("user-round-plus",__iconNode$19);const __iconNode$18=[["circle",{cx:"10",cy:"8",r:"5",key:"o932ke"}],["path",{d:"M2 21a8 8 0 0 1 10.434-7.62",key:"1yezr2"}],["circle",{cx:"18",cy:"18",r:"3",key:"1xkwt0"}],["path",{d:"m22 22-1.9-1.9",key:"1e5ubv"}]],UserRoundSearch=createLucideIcon("user-round-search",__iconNode$18);const __iconNode$17=[["path",{d:"M2 21a8 8 0 0 1 11.873-7",key:"74fkxq"}],["circle",{cx:"10",cy:"8",r:"5",key:"o932ke"}],["path",{d:"m17 17 5 5",key:"p7ous7"}],["path",{d:"m22 17-5 5",key:"gqnmv0"}]],UserRoundX=createLucideIcon("user-round-x",__iconNode$17);const __iconNode$16=[["circle",{cx:"12",cy:"8",r:"5",key:"1hypcn"}],["path",{d:"M20 21a8 8 0 0 0-16 0",key:"rfgkzh"}]],UserRound=createLucideIcon("user-round",__iconNode$16);const __iconNode$15=[["circle",{cx:"10",cy:"7",r:"4",key:"e45bow"}],["path",{d:"M10.3 15H7a4 4 0 0 0-4 4v2",key:"3bnktk"}],["circle",{cx:"17",cy:"17",r:"3",key:"18b49y"}],["path",{d:"m21 21-1.9-1.9",key:"1g2n9r"}]],UserSearch=createLucideIcon("user-search",__iconNode$15);const __iconNode$14=[["path",{d:"M16.051 12.616a1 1 0 0 1 1.909.024l.737 1.452a1 1 0 0 0 .737.535l1.634.256a1 1 0 0 1 .588 1.806l-1.172 1.168a1 1 0 0 0-.282.866l.259 1.613a1 1 0 0 1-1.541 1.134l-1.465-.75a1 1 0 0 0-.912 0l-1.465.75a1 1 0 0 1-1.539-1.133l.258-1.613a1 1 0 0 0-.282-.866l-1.156-1.153a1 1 0 0 1 .572-1.822l1.633-.256a1 1 0 0 0 .737-.535z",key:"1m8t9f"}],["path",{d:"M8 15H7a4 4 0 0 0-4 4v2",key:"l9tmp8"}],["circle",{cx:"10",cy:"7",r:"4",key:"e45bow"}]],UserStar=createLucideIcon("user-star",__iconNode$14);const __iconNode$13=[["path",{d:"M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2",key:"1yyitq"}],["circle",{cx:"9",cy:"7",r:"4",key:"nufk8"}],["line",{x1:"17",x2:"22",y1:"8",y2:"13",key:"3nzzx3"}],["line",{x1:"22",x2:"17",y1:"8",y2:"13",key:"1swrse"}]],UserX=createLucideIcon("user-x",__iconNode$13);const __iconNode$12=[["path",{d:"M19 21v-2a4 4 0 0 0-4-4H9a4 4 0 0 0-4 4v2",key:"975kel"}],["circle",{cx:"12",cy:"7",r:"4",key:"17ys0d"}]],User=createLucideIcon("user",__iconNode$12);const __iconNode$11=[["path",{d:"M18 21a8 8 0 0 0-16 0",key:"3ypg7q"}],["circle",{cx:"10",cy:"8",r:"5",key:"o932ke"}],["path",{d:"M22 20c0-3.37-2-6.5-4-8a5 5 0 0 0-.45-8.3",key:"10s06x"}]],UsersRound=createLucideIcon("users-round",__iconNode$11);const __iconNode$10=[["path",{d:"M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2",key:"1yyitq"}],["path",{d:"M16 3.128a4 4 0 0 1 0 7.744",key:"16gr8j"}],["path",{d:"M22 21v-2a4 4 0 0 0-3-3.87",key:"kshegd"}],["circle",{cx:"9",cy:"7",r:"4",key:"nufk8"}]],Users=createLucideIcon("users",__iconNode$10);const __iconNode$$=[["path",{d:"m16 2-2.3 2.3a3 3 0 0 0 0 4.2l1.8 1.8a3 3 0 0 0 4.2 0L22 8",key:"n7qcjb"}],["path",{d:"M15 15 3.3 3.3a4.2 4.2 0 0 0 0 6l7.3 7.3c.7.7 2 .7 2.8 0L15 15Zm0 0 7 7",key:"d0u48b"}],["path",{d:"m2.1 21.8 6.4-6.3",key:"yn04lh"}],["path",{d:"m19 5-7 7",key:"194lzd"}]],UtensilsCrossed=createLucideIcon("utensils-crossed",__iconNode$$);const __iconNode$_=[["path",{d:"M3 2v7c0 1.1.9 2 2 2h4a2 2 0 0 0 2-2V2",key:"cjf0a3"}],["path",{d:"M7 2v20",key:"1473qp"}],["path",{d:"M21 15V2a5 5 0 0 0-5 5v6c0 1.1.9 2 2 2h3Zm0 0v7",key:"j28e5"}]],Utensils=createLucideIcon("utensils",__iconNode$_);const __iconNode$Z=[["path",{d:"M12 2v20",key:"t6zp3m"}],["path",{d:"M2 5h20",key:"1fs1ex"}],["path",{d:"M3 3v2",key:"9imdir"}],["path",{d:"M7 3v2",key:"n0os7"}],["path",{d:"M17 3v2",key:"1l2re6"}],["path",{d:"M21 3v2",key:"1duuac"}],["path",{d:"m19 5-7 7-7-7",key:"133zxf"}]],UtilityPole=createLucideIcon("utility-pole",__iconNode$Z);const __iconNode$Y=[["path",{d:"M8 21s-4-3-4-9 4-9 4-9",key:"uto9ud"}],["path",{d:"M16 3s4 3 4 9-4 9-4 9",key:"4w2vsq"}],["line",{x1:"15",x2:"9",y1:"9",y2:"15",key:"f7djnv"}],["line",{x1:"9",x2:"15",y1:"9",y2:"15",key:"1shsy8"}]],Variable=createLucideIcon("variable",__iconNode$Y);const __iconNode$X=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["circle",{cx:"7.5",cy:"7.5",r:".5",fill:"currentColor",key:"kqv944"}],["path",{d:"m7.9 7.9 2.7 2.7",key:"hpeyl3"}],["circle",{cx:"16.5",cy:"7.5",r:".5",fill:"currentColor",key:"w0ekpg"}],["path",{d:"m13.4 10.6 2.7-2.7",key:"264c1n"}],["circle",{cx:"7.5",cy:"16.5",r:".5",fill:"currentColor",key:"nkw3mc"}],["path",{d:"m7.9 16.1 2.7-2.7",key:"p81g5e"}],["circle",{cx:"16.5",cy:"16.5",r:".5",fill:"currentColor",key:"fubopw"}],["path",{d:"m13.4 13.4 2.7 2.7",key:"abhel3"}],["circle",{cx:"12",cy:"12",r:"2",key:"1c9p78"}]],Vault=createLucideIcon("vault",__iconNode$X);const __iconNode$W=[["path",{d:"M19.5 7a24 24 0 0 1 0 10",key:"8n60xe"}],["path",{d:"M4.5 7a24 24 0 0 0 0 10",key:"2lmadr"}],["path",{d:"M7 19.5a24 24 0 0 0 10 0",key:"1q94o2"}],["path",{d:"M7 4.5a24 24 0 0 1 10 0",key:"2z8ypa"}],["rect",{x:"17",y:"17",width:"5",height:"5",rx:"1",key:"1ac74s"}],["rect",{x:"17",y:"2",width:"5",height:"5",rx:"1",key:"1e7h5j"}],["rect",{x:"2",y:"17",width:"5",height:"5",rx:"1",key:"1t4eah"}],["rect",{x:"2",y:"2",width:"5",height:"5",rx:"1",key:"940dhs"}]],VectorSquare=createLucideIcon("vector-square",__iconNode$W);const __iconNode$V=[["path",{d:"M16 8q6 0 6-6-6 0-6 6",key:"qsyyc4"}],["path",{d:"M17.41 3.59a10 10 0 1 0 3 3",key:"41m9h7"}],["path",{d:"M2 2a26.6 26.6 0 0 1 10 20c.9-6.82 1.5-9.5 4-14",key:"qiv7li"}]],Vegan=createLucideIcon("vegan",__iconNode$V);const __iconNode$U=[["path",{d:"M18 11c-1.5 0-2.5.5-3 2",key:"1fod00"}],["path",{d:"M4 6a2 2 0 0 0-2 2v4a5 5 0 0 0 5 5 8 8 0 0 1 5 2 8 8 0 0 1 5-2 5 5 0 0 0 5-5V8a2 2 0 0 0-2-2h-3a8 8 0 0 0-5 2 8 8 0 0 0-5-2z",key:"d70hit"}],["path",{d:"M6 11c1.5 0 2.5.5 3 2",key:"136fht"}]],VenetianMask=createLucideIcon("venetian-mask",__iconNode$U);const __iconNode$T=[["path",{d:"M10 20h4",key:"ni2waw"}],["path",{d:"M12 16v6",key:"c8a4gj"}],["path",{d:"M17 2h4v4",key:"vhe59"}],["path",{d:"m21 2-5.46 5.46",key:"19kypf"}],["circle",{cx:"12",cy:"11",r:"5",key:"16gxyc"}]],VenusAndMars=createLucideIcon("venus-and-mars",__iconNode$T);const __iconNode$S=[["path",{d:"M12 15v7",key:"t2xh3l"}],["path",{d:"M9 19h6",key:"456am0"}],["circle",{cx:"12",cy:"9",r:"6",key:"1nw4tq"}]],Venus=createLucideIcon("venus",__iconNode$S);const __iconNode$R=[["path",{d:"m2 8 2 2-2 2 2 2-2 2",key:"sv1b1"}],["path",{d:"m22 8-2 2 2 2-2 2 2 2",key:"101i4y"}],["path",{d:"M8 8v10c0 .55.45 1 1 1h6c.55 0 1-.45 1-1v-2",key:"1hbad5"}],["path",{d:"M16 10.34V6c0-.55-.45-1-1-1h-4.34",key:"1x5tf0"}],["line",{x1:"2",x2:"22",y1:"2",y2:"22",key:"a6p6uj"}]],VibrateOff=createLucideIcon("vibrate-off",__iconNode$R);const __iconNode$Q=[["path",{d:"m2 8 2 2-2 2 2 2-2 2",key:"sv1b1"}],["path",{d:"m22 8-2 2 2 2-2 2 2 2",key:"101i4y"}],["rect",{width:"8",height:"14",x:"8",y:"5",rx:"1",key:"1oyrl4"}]],Vibrate=createLucideIcon("vibrate",__iconNode$Q);const __iconNode$P=[["path",{d:"M10.66 6H14a2 2 0 0 1 2 2v2.5l5.248-3.062A.5.5 0 0 1 22 7.87v8.196",key:"w8jjjt"}],["path",{d:"M16 16a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h2",key:"1xawa7"}],["path",{d:"m2 2 20 20",key:"1ooewy"}]],VideoOff=createLucideIcon("video-off",__iconNode$P);const __iconNode$O=[["path",{d:"m16 13 5.223 3.482a.5.5 0 0 0 .777-.416V7.87a.5.5 0 0 0-.752-.432L16 10.5",key:"ftymec"}],["rect",{x:"2",y:"6",width:"14",height:"12",rx:"2",key:"158x01"}]],Video=createLucideIcon("video",__iconNode$O);const __iconNode$N=[["rect",{width:"20",height:"16",x:"2",y:"4",rx:"2",key:"18n3k1"}],["path",{d:"M2 8h20",key:"d11cs7"}],["circle",{cx:"8",cy:"14",r:"2",key:"1k2qr5"}],["path",{d:"M8 12h8",key:"1wcyev"}],["circle",{cx:"16",cy:"14",r:"2",key:"14k7lr"}]],Videotape=createLucideIcon("videotape",__iconNode$N);const __iconNode$M=[["path",{d:"M21 17v2a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-2",key:"mrq65r"}],["path",{d:"M21 7V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v2",key:"be3xqs"}],["circle",{cx:"12",cy:"12",r:"1",key:"41hilf"}],["path",{d:"M18.944 12.33a1 1 0 0 0 0-.66 7.5 7.5 0 0 0-13.888 0 1 1 0 0 0 0 .66 7.5 7.5 0 0 0 13.888 0",key:"11ak4c"}]],View=createLucideIcon("view",__iconNode$M);const __iconNode$L=[["circle",{cx:"6",cy:"12",r:"4",key:"1ehtga"}],["circle",{cx:"18",cy:"12",r:"4",key:"4vafl8"}],["line",{x1:"6",x2:"18",y1:"16",y2:"16",key:"pmt8us"}]],Voicemail=createLucideIcon("voicemail",__iconNode$L);const __iconNode$K=[["path",{d:"M11.1 7.1a16.55 16.55 0 0 1 10.9 4",key:"2880wi"}],["path",{d:"M12 12a12.6 12.6 0 0 1-8.7 5",key:"113sja"}],["path",{d:"M16.8 13.6a16.55 16.55 0 0 1-9 7.5",key:"1qmsgl"}],["path",{d:"M20.7 17a12.8 12.8 0 0 0-8.7-5 13.3 13.3 0 0 1 0-10",key:"1bmeqp"}],["path",{d:"M6.3 3.8a16.55 16.55 0 0 0 1.9 11.5",key:"iekzv9"}],["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}]],Volleyball=createLucideIcon("volleyball",__iconNode$K);const __iconNode$J=[["path",{d:"M11 4.702a.705.705 0 0 0-1.203-.498L6.413 7.587A1.4 1.4 0 0 1 5.416 8H3a1 1 0 0 0-1 1v6a1 1 0 0 0 1 1h2.416a1.4 1.4 0 0 1 .997.413l3.383 3.384A.705.705 0 0 0 11 19.298z",key:"uqj9uw"}],["path",{d:"M16 9a5 5 0 0 1 0 6",key:"1q6k2b"}]],Volume1=createLucideIcon("volume-1",__iconNode$J);const __iconNode$I=[["path",{d:"M11 4.702a.705.705 0 0 0-1.203-.498L6.413 7.587A1.4 1.4 0 0 1 5.416 8H3a1 1 0 0 0-1 1v6a1 1 0 0 0 1 1h2.416a1.4 1.4 0 0 1 .997.413l3.383 3.384A.705.705 0 0 0 11 19.298z",key:"uqj9uw"}],["path",{d:"M16 9a5 5 0 0 1 0 6",key:"1q6k2b"}],["path",{d:"M19.364 18.364a9 9 0 0 0 0-12.728",key:"ijwkga"}]],Volume2=createLucideIcon("volume-2",__iconNode$I);const __iconNode$H=[["path",{d:"M16 9a5 5 0 0 1 .95 2.293",key:"1fgyg8"}],["path",{d:"M19.364 5.636a9 9 0 0 1 1.889 9.96",key:"l3zxae"}],["path",{d:"m2 2 20 20",key:"1ooewy"}],["path",{d:"m7 7-.587.587A1.4 1.4 0 0 1 5.416 8H3a1 1 0 0 0-1 1v6a1 1 0 0 0 1 1h2.416a1.4 1.4 0 0 1 .997.413l3.383 3.384A.705.705 0 0 0 11 19.298V11",key:"1gbwow"}],["path",{d:"M9.828 4.172A.686.686 0 0 1 11 4.657v.686",key:"s2je0y"}]],VolumeOff=createLucideIcon("volume-off",__iconNode$H);const __iconNode$G=[["path",{d:"M11 4.702a.705.705 0 0 0-1.203-.498L6.413 7.587A1.4 1.4 0 0 1 5.416 8H3a1 1 0 0 0-1 1v6a1 1 0 0 0 1 1h2.416a1.4 1.4 0 0 1 .997.413l3.383 3.384A.705.705 0 0 0 11 19.298z",key:"uqj9uw"}],["line",{x1:"22",x2:"16",y1:"9",y2:"15",key:"1ewh16"}],["line",{x1:"16",x2:"22",y1:"9",y2:"15",key:"5ykzw1"}]],VolumeX=createLucideIcon("volume-x",__iconNode$G);const __iconNode$F=[["path",{d:"M11 4.702a.705.705 0 0 0-1.203-.498L6.413 7.587A1.4 1.4 0 0 1 5.416 8H3a1 1 0 0 0-1 1v6a1 1 0 0 0 1 1h2.416a1.4 1.4 0 0 1 .997.413l3.383 3.384A.705.705 0 0 0 11 19.298z",key:"uqj9uw"}]],Volume=createLucideIcon("volume",__iconNode$F);const __iconNode$E=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",key:"afitv7"}],["path",{d:"M3 9a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2",key:"4125el"}],["path",{d:"M3 11h3c.8 0 1.6.3 2.1.9l1.1.9c1.6 1.6 4.1 1.6 5.7 0l1.1-.9c.5-.5 1.3-.9 2.1-.9H21",key:"1dpki6"}]],WalletCards=createLucideIcon("wallet-cards",__iconNode$E);const __iconNode$D=[["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}],["path",{d:"M5 7c0-1.1.9-2 2-2h10a2 2 0 0 1 2 2v12H5V7Z",key:"1ezoue"}],["path",{d:"M22 19H2",key:"nuriw5"}]],Vote=createLucideIcon("vote",__iconNode$D);const __iconNode$C=[["path",{d:"M17 14h.01",key:"7oqj8z"}],["path",{d:"M7 7h12a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h14",key:"u1rqew"}]],WalletMinimal=createLucideIcon("wallet-minimal",__iconNode$C);const __iconNode$B=[["path",{d:"M19 7V4a1 1 0 0 0-1-1H5a2 2 0 0 0 0 4h15a1 1 0 0 1 1 1v4h-3a2 2 0 0 0 0 4h3a1 1 0 0 0 1-1v-2a1 1 0 0 0-1-1",key:"18etb6"}],["path",{d:"M3 5v14a2 2 0 0 0 2 2h15a1 1 0 0 0 1-1v-4",key:"xoc0q4"}]],Wallet=createLucideIcon("wallet",__iconNode$B);const __iconNode$A=[["path",{d:"M12 17v4",key:"1riwvh"}],["path",{d:"M8 21h8",key:"1ev6f3"}],["path",{d:"m9 17 6.1-6.1a2 2 0 0 1 2.81.01L22 15",key:"1sl52q"}],["circle",{cx:"8",cy:"9",r:"2",key:"gjzl9d"}],["rect",{x:"2",y:"3",width:"20",height:"14",rx:"2",key:"x3v2xh"}]],Wallpaper=createLucideIcon("wallpaper",__iconNode$A);const __iconNode$z=[["path",{d:"m21.64 3.64-1.28-1.28a1.21 1.21 0 0 0-1.72 0L2.36 18.64a1.21 1.21 0 0 0 0 1.72l1.28 1.28a1.2 1.2 0 0 0 1.72 0L21.64 5.36a1.2 1.2 0 0 0 0-1.72",key:"ul74o6"}],["path",{d:"m14 7 3 3",key:"1r5n42"}],["path",{d:"M5 6v4",key:"ilb8ba"}],["path",{d:"M19 14v4",key:"blhpug"}],["path",{d:"M10 2v2",key:"7u0qdc"}],["path",{d:"M7 8H3",key:"zfb6yr"}],["path",{d:"M21 16h-4",key:"1cnmox"}],["path",{d:"M11 3H9",key:"1obp7u"}]],WandSparkles=createLucideIcon("wand-sparkles",__iconNode$z);const __iconNode$y=[["path",{d:"M18 21V10a1 1 0 0 0-1-1H7a1 1 0 0 0-1 1v11",key:"pb2vm6"}],["path",{d:"M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V8a2 2 0 0 1 1.132-1.803l7.95-3.974a2 2 0 0 1 1.837 0l7.948 3.974A2 2 0 0 1 22 8z",key:"doq5xv"}],["path",{d:"M6 13h12",key:"yf64js"}],["path",{d:"M6 17h12",key:"1jwigz"}]],Warehouse=createLucideIcon("warehouse",__iconNode$y);const __iconNode$x=[["path",{d:"M15 4V2",key:"z1p9b7"}],["path",{d:"M15 16v-2",key:"px0unx"}],["path",{d:"M8 9h2",key:"1g203m"}],["path",{d:"M20 9h2",key:"19tzq7"}],["path",{d:"M17.8 11.8 19 13",key:"yihg8r"}],["path",{d:"M15 9h.01",key:"x1ddxp"}],["path",{d:"M17.8 6.2 19 5",key:"fd4us0"}],["path",{d:"m3 21 9-9",key:"1jfql5"}],["path",{d:"M12.2 6.2 11 5",key:"i3da3b"}]],Wand=createLucideIcon("wand",__iconNode$x);const __iconNode$w=[["path",{d:"M3 6h3",key:"155dbl"}],["path",{d:"M17 6h.01",key:"e2y6kg"}],["rect",{width:"18",height:"20",x:"3",y:"2",rx:"2",key:"od3kk9"}],["circle",{cx:"12",cy:"13",r:"5",key:"nlbqau"}],["path",{d:"M12 18a2.5 2.5 0 0 0 0-5 2.5 2.5 0 0 1 0-5",key:"17lach"}]],WashingMachine=createLucideIcon("washing-machine",__iconNode$w);const __iconNode$v=[["path",{d:"M12 10v2.2l1.6 1",key:"n3r21l"}],["path",{d:"m16.13 7.66-.81-4.05a2 2 0 0 0-2-1.61h-2.68a2 2 0 0 0-2 1.61l-.78 4.05",key:"18k57s"}],["path",{d:"m7.88 16.36.8 4a2 2 0 0 0 2 1.61h2.72a2 2 0 0 0 2-1.61l.81-4.05",key:"16ny36"}],["circle",{cx:"12",cy:"12",r:"6",key:"1vlfrh"}]],Watch=createLucideIcon("watch",__iconNode$v);const __iconNode$u=[["path",{d:"M19 5a2 2 0 0 0-2 2v11",key:"s41o68"}],["path",{d:"M2 18c.6.5 1.2 1 2.5 1 2.5 0 2.5-2 5-2 2.6 0 2.4 2 5 2 2.5 0 2.5-2 5-2 1.3 0 1.9.5 2.5 1",key:"rd2r6e"}],["path",{d:"M7 13h10",key:"1rwob1"}],["path",{d:"M7 9h10",key:"12czzb"}],["path",{d:"M9 5a2 2 0 0 0-2 2v11",key:"x0q4gh"}]],WavesLadder=createLucideIcon("waves-ladder",__iconNode$u);const __iconNode$t=[["path",{d:"M2 6c.6.5 1.2 1 2.5 1C7 7 7 5 9.5 5c2.6 0 2.4 2 5 2 2.5 0 2.5-2 5-2 1.3 0 1.9.5 2.5 1",key:"knzxuh"}],["path",{d:"M2 12c.6.5 1.2 1 2.5 1 2.5 0 2.5-2 5-2 2.6 0 2.4 2 5 2 2.5 0 2.5-2 5-2 1.3 0 1.9.5 2.5 1",key:"2jd2cc"}],["path",{d:"M2 18c.6.5 1.2 1 2.5 1 2.5 0 2.5-2 5-2 2.6 0 2.4 2 5 2 2.5 0 2.5-2 5-2 1.3 0 1.9.5 2.5 1",key:"rd2r6e"}]],Waves=createLucideIcon("waves",__iconNode$t);const __iconNode$s=[["circle",{cx:"12",cy:"4.5",r:"2.5",key:"r5ysbb"}],["path",{d:"m10.2 6.3-3.9 3.9",key:"1nzqf6"}],["circle",{cx:"4.5",cy:"12",r:"2.5",key:"jydg6v"}],["path",{d:"M7 12h10",key:"b7w52i"}],["circle",{cx:"19.5",cy:"12",r:"2.5",key:"1piiel"}],["path",{d:"m13.8 17.7 3.9-3.9",key:"1wyg1y"}],["circle",{cx:"12",cy:"19.5",r:"2.5",key:"13o1pw"}]],Waypoints=createLucideIcon("waypoints",__iconNode$s);const __iconNode$r=[["circle",{cx:"12",cy:"10",r:"8",key:"1gshiw"}],["circle",{cx:"12",cy:"10",r:"3",key:"ilqhr7"}],["path",{d:"M7 22h10",key:"10w4w3"}],["path",{d:"M12 22v-4",key:"1utk9m"}]],Webcam=createLucideIcon("webcam",__iconNode$r);const __iconNode$q=[["path",{d:"M17 17h-5c-1.09-.02-1.94.92-2.5 1.9A3 3 0 1 1 2.57 15",key:"1tvl6x"}],["path",{d:"M9 3.4a4 4 0 0 1 6.52.66",key:"q04jfq"}],["path",{d:"m6 17 3.1-5.8a2.5 2.5 0 0 0 .057-2.05",key:"azowf0"}],["path",{d:"M20.3 20.3a4 4 0 0 1-2.3.7",key:"5joiws"}],["path",{d:"M18.6 13a4 4 0 0 1 3.357 3.414",key:"cangb8"}],["path",{d:"m12 6 .6 1",key:"tpjl1n"}],["path",{d:"m2 2 20 20",key:"1ooewy"}]],WebhookOff=createLucideIcon("webhook-off",__iconNode$q);const __iconNode$p=[["path",{d:"M18 16.98h-5.99c-1.1 0-1.95.94-2.48 1.9A4 4 0 0 1 2 17c.01-.7.2-1.4.57-2",key:"q3hayz"}],["path",{d:"m6 17 3.13-5.78c.53-.97.1-2.18-.5-3.1a4 4 0 1 1 6.89-4.06",key:"1go1hn"}],["path",{d:"m12 6 3.13 5.73C15.66 12.7 16.9 13 18 13a4 4 0 0 1 0 8",key:"qlwsc0"}]],Webhook=createLucideIcon("webhook",__iconNode$p);const __iconNode$o=[["circle",{cx:"12",cy:"5",r:"3",key:"rqqgnr"}],["path",{d:"M6.5 8a2 2 0 0 0-1.905 1.46L2.1 18.5A2 2 0 0 0 4 21h16a2 2 0 0 0 1.925-2.54L19.4 9.5A2 2 0 0 0 17.48 8Z",key:"56o5sh"}]],Weight=createLucideIcon("weight",__iconNode$o);const __iconNode$n=[["path",{d:"m2 22 10-10",key:"28ilpk"}],["path",{d:"m16 8-1.17 1.17",key:"1qqm82"}],["path",{d:"M3.47 12.53 5 11l1.53 1.53a3.5 3.5 0 0 1 0 4.94L5 19l-1.53-1.53a3.5 3.5 0 0 1 0-4.94Z",key:"1rdhi6"}],["path",{d:"m8 8-.53.53a3.5 3.5 0 0 0 0 4.94L9 15l1.53-1.53c.55-.55.88-1.25.98-1.97",key:"4wz8re"}],["path",{d:"M10.91 5.26c.15-.26.34-.51.56-.73L13 3l1.53 1.53a3.5 3.5 0 0 1 .28 4.62",key:"rves66"}],["path",{d:"M20 2h2v2a4 4 0 0 1-4 4h-2V6a4 4 0 0 1 4-4Z",key:"19rau1"}],["path",{d:"M11.47 17.47 13 19l-1.53 1.53a3.5 3.5 0 0 1-4.94 0L5 19l1.53-1.53a3.5 3.5 0 0 1 4.94 0Z",key:"tc8ph9"}],["path",{d:"m16 16-.53.53a3.5 3.5 0 0 1-4.94 0L9 15l1.53-1.53a3.49 3.49 0 0 1 1.97-.98",key:"ak46r"}],["path",{d:"M18.74 13.09c.26-.15.51-.34.73-.56L21 11l-1.53-1.53a3.5 3.5 0 0 0-4.62-.28",key:"1tw520"}],["line",{x1:"2",x2:"22",y1:"2",y2:"22",key:"a6p6uj"}]],WheatOff=createLucideIcon("wheat-off",__iconNode$n);const __iconNode$m=[["path",{d:"M2 22 16 8",key:"60hf96"}],["path",{d:"M3.47 12.53 5 11l1.53 1.53a3.5 3.5 0 0 1 0 4.94L5 19l-1.53-1.53a3.5 3.5 0 0 1 0-4.94Z",key:"1rdhi6"}],["path",{d:"M7.47 8.53 9 7l1.53 1.53a3.5 3.5 0 0 1 0 4.94L9 15l-1.53-1.53a3.5 3.5 0 0 1 0-4.94Z",key:"1sdzmb"}],["path",{d:"M11.47 4.53 13 3l1.53 1.53a3.5 3.5 0 0 1 0 4.94L13 11l-1.53-1.53a3.5 3.5 0 0 1 0-4.94Z",key:"eoatbi"}],["path",{d:"M20 2h2v2a4 4 0 0 1-4 4h-2V6a4 4 0 0 1 4-4Z",key:"19rau1"}],["path",{d:"M11.47 17.47 13 19l-1.53 1.53a3.5 3.5 0 0 1-4.94 0L5 19l1.53-1.53a3.5 3.5 0 0 1 4.94 0Z",key:"tc8ph9"}],["path",{d:"M15.47 13.47 17 15l-1.53 1.53a3.5 3.5 0 0 1-4.94 0L9 15l1.53-1.53a3.5 3.5 0 0 1 4.94 0Z",key:"2m8kc5"}],["path",{d:"M19.47 9.47 21 11l-1.53 1.53a3.5 3.5 0 0 1-4.94 0L13 11l1.53-1.53a3.5 3.5 0 0 1 4.94 0Z",key:"vex3ng"}]],Wheat=createLucideIcon("wheat",__iconNode$m);const __iconNode$l=[["circle",{cx:"7",cy:"12",r:"3",key:"12clwm"}],["path",{d:"M10 9v6",key:"17i7lo"}],["circle",{cx:"17",cy:"12",r:"3",key:"gl7c2s"}],["path",{d:"M14 7v8",key:"dl84cr"}],["path",{d:"M22 17v1c0 .5-.5 1-1 1H3c-.5 0-1-.5-1-1v-1",key:"lt2kga"}]],WholeWord=createLucideIcon("whole-word",__iconNode$l);const __iconNode$k=[["path",{d:"m14.305 19.53.923-.382",key:"3m78fa"}],["path",{d:"m15.228 16.852-.923-.383",key:"npixar"}],["path",{d:"m16.852 15.228-.383-.923",key:"5xggr7"}],["path",{d:"m16.852 20.772-.383.924",key:"dpfhf9"}],["path",{d:"m19.148 15.228.383-.923",key:"1reyyz"}],["path",{d:"m19.53 21.696-.382-.924",key:"1goivc"}],["path",{d:"M2 7.82a15 15 0 0 1 20 0",key:"1ovjuk"}],["path",{d:"m20.772 16.852.924-.383",key:"htqkph"}],["path",{d:"m20.772 19.148.924.383",key:"9w9pjp"}],["path",{d:"M5 11.858a10 10 0 0 1 11.5-1.785",key:"3sn16i"}],["path",{d:"M8.5 15.429a5 5 0 0 1 2.413-1.31",key:"1pxovh"}],["circle",{cx:"18",cy:"18",r:"3",key:"1xkwt0"}]],WifiCog=createLucideIcon("wifi-cog",__iconNode$k);const __iconNode$j=[["path",{d:"M12 20h.01",key:"zekei9"}],["path",{d:"M5 12.859a10 10 0 0 1 14 0",key:"1x1e6c"}],["path",{d:"M8.5 16.429a5 5 0 0 1 7 0",key:"1bycff"}]],WifiHigh=createLucideIcon("wifi-high",__iconNode$j);const __iconNode$i=[["path",{d:"M12 20h.01",key:"zekei9"}],["path",{d:"M8.5 16.429a5 5 0 0 1 7 0",key:"1bycff"}]],WifiLow=createLucideIcon("wifi-low",__iconNode$i);const __iconNode$h=[["path",{d:"M12 20h.01",key:"zekei9"}],["path",{d:"M8.5 16.429a5 5 0 0 1 7 0",key:"1bycff"}],["path",{d:"M5 12.859a10 10 0 0 1 5.17-2.69",key:"1dl1wf"}],["path",{d:"M19 12.859a10 10 0 0 0-2.007-1.523",key:"4k23kn"}],["path",{d:"M2 8.82a15 15 0 0 1 4.177-2.643",key:"1grhjp"}],["path",{d:"M22 8.82a15 15 0 0 0-11.288-3.764",key:"z3jwby"}],["path",{d:"m2 2 20 20",key:"1ooewy"}]],WifiOff=createLucideIcon("wifi-off",__iconNode$h);const __iconNode$g=[["path",{d:"M2 8.82a15 15 0 0 1 20 0",key:"dnpr2z"}],["path",{d:"M21.378 16.626a1 1 0 0 0-3.004-3.004l-4.01 4.012a2 2 0 0 0-.506.854l-.837 2.87a.5.5 0 0 0 .62.62l2.87-.837a2 2 0 0 0 .854-.506z",key:"1817ys"}],["path",{d:"M5 12.859a10 10 0 0 1 10.5-2.222",key:"rpb7oy"}],["path",{d:"M8.5 16.429a5 5 0 0 1 3-1.406",key:"r8bmzl"}]],WifiPen=createLucideIcon("wifi-pen",__iconNode$g);const __iconNode$f=[["path",{d:"M11.965 10.105v4L13.5 12.5a5 5 0 0 1 8 1.5",key:"1immaq"}],["path",{d:"M11.965 14.105h4",key:"uejny8"}],["path",{d:"M17.965 18.105h4L20.43 19.71a5 5 0 0 1-8-1.5",key:"1i3a7e"}],["path",{d:"M2 8.82a15 15 0 0 1 20 0",key:"dnpr2z"}],["path",{d:"M21.965 22.105v-4",key:"1ku6vx"}],["path",{d:"M5 12.86a10 10 0 0 1 3-2.032",key:"pemdtu"}],["path",{d:"M8.5 16.429h.01",key:"2bm739"}]],WifiSync=createLucideIcon("wifi-sync",__iconNode$f);const __iconNode$e=[["path",{d:"M12 20h.01",key:"zekei9"}]],WifiZero=createLucideIcon("wifi-zero",__iconNode$e);const __iconNode$d=[["path",{d:"M12 20h.01",key:"zekei9"}],["path",{d:"M2 8.82a15 15 0 0 1 20 0",key:"dnpr2z"}],["path",{d:"M5 12.859a10 10 0 0 1 14 0",key:"1x1e6c"}],["path",{d:"M8.5 16.429a5 5 0 0 1 7 0",key:"1bycff"}]],Wifi=createLucideIcon("wifi",__iconNode$d);const __iconNode$c=[["path",{d:"M10 2v8",key:"d4bbey"}],["path",{d:"M12.8 21.6A2 2 0 1 0 14 18H2",key:"19kp1d"}],["path",{d:"M17.5 10a2.5 2.5 0 1 1 2 4H2",key:"19kpjc"}],["path",{d:"m6 6 4 4 4-4",key:"k13n16"}]],WindArrowDown=createLucideIcon("wind-arrow-down",__iconNode$c);const __iconNode$b=[["path",{d:"M12.8 19.6A2 2 0 1 0 14 16H2",key:"148xed"}],["path",{d:"M17.5 8a2.5 2.5 0 1 1 2 4H2",key:"1u4tom"}],["path",{d:"M9.8 4.4A2 2 0 1 1 11 8H2",key:"75valh"}]],Wind=createLucideIcon("wind",__iconNode$b);const __iconNode$a=[["path",{d:"M8 22h8",key:"rmew8v"}],["path",{d:"M7 10h3m7 0h-1.343",key:"v48bem"}],["path",{d:"M12 15v7",key:"t2xh3l"}],["path",{d:"M7.307 7.307A12.33 12.33 0 0 0 7 10a5 5 0 0 0 7.391 4.391M8.638 2.981C8.75 2.668 8.872 2.34 9 2h6c1.5 4 2 6 2 8 0 .407-.05.809-.145 1.198",key:"1ymjlu"}],["line",{x1:"2",x2:"22",y1:"2",y2:"22",key:"a6p6uj"}]],WineOff=createLucideIcon("wine-off",__iconNode$a);const __iconNode$9=[["path",{d:"M8 22h8",key:"rmew8v"}],["path",{d:"M7 10h10",key:"1101jm"}],["path",{d:"M12 15v7",key:"t2xh3l"}],["path",{d:"M12 15a5 5 0 0 0 5-5c0-2-.5-4-2-8H9c-1.5 4-2 6-2 8a5 5 0 0 0 5 5Z",key:"10ffi3"}]],Wine=createLucideIcon("wine",__iconNode$9);const __iconNode$8=[["rect",{width:"8",height:"8",x:"3",y:"3",rx:"2",key:"by2w9f"}],["path",{d:"M7 11v4a2 2 0 0 0 2 2h4",key:"xkn7yn"}],["rect",{width:"8",height:"8",x:"13",y:"13",rx:"2",key:"1cgmvn"}]],Workflow=createLucideIcon("workflow",__iconNode$8);const __iconNode$7=[["path",{d:"m19 12-1.5 3",key:"9bcu4o"}],["path",{d:"M19.63 18.81 22 20",key:"121v98"}],["path",{d:"M6.47 8.23a1.68 1.68 0 0 1 2.44 1.93l-.64 2.08a6.76 6.76 0 0 0 10.16 7.67l.42-.27a1 1 0 1 0-2.73-4.21l-.42.27a1.76 1.76 0 0 1-2.63-1.99l.64-2.08A6.66 6.66 0 0 0 3.94 3.9l-.7.4a1 1 0 1 0 2.55 4.34z",key:"1tij6q"}]],Worm=createLucideIcon("worm",__iconNode$7);const __iconNode$6=[["path",{d:"M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.106-3.105c.32-.322.863-.22.983.218a6 6 0 0 1-8.259 7.057l-7.91 7.91a1 1 0 0 1-2.999-3l7.91-7.91a6 6 0 0 1 7.057-8.259c.438.12.54.662.219.984z",key:"1ngwbx"}]],Wrench=createLucideIcon("wrench",__iconNode$6);const __iconNode$5=[["path",{d:"M18 6 6 18",key:"1bl5f8"}],["path",{d:"m6 6 12 12",key:"d8bk6v"}]],X$3=createLucideIcon("x",__iconNode$5);const __iconNode$4=[["path",{d:"M2.5 17a24.12 24.12 0 0 1 0-10 2 2 0 0 1 1.4-1.4 49.56 49.56 0 0 1 16.2 0A2 2 0 0 1 21.5 7a24.12 24.12 0 0 1 0 10 2 2 0 0 1-1.4 1.4 49.55 49.55 0 0 1-16.2 0A2 2 0 0 1 2.5 17",key:"1q2vi4"}],["path",{d:"m10 15 5-3-5-3z",key:"1jp15x"}]],Youtube=createLucideIcon("youtube",__iconNode$4);const __iconNode$3=[["path",{d:"M10.513 4.856 13.12 2.17a.5.5 0 0 1 .86.46l-1.377 4.317",key:"193nxd"}],["path",{d:"M15.656 10H20a1 1 0 0 1 .78 1.63l-1.72 1.773",key:"27a7lr"}],["path",{d:"M16.273 16.273 10.88 21.83a.5.5 0 0 1-.86-.46l1.92-6.02A1 1 0 0 0 11 14H4a1 1 0 0 1-.78-1.63l4.507-4.643",key:"1e0qe9"}],["path",{d:"m2 2 20 20",key:"1ooewy"}]],ZapOff=createLucideIcon("zap-off",__iconNode$3);const __iconNode$2=[["path",{d:"M4 14a1 1 0 0 1-.78-1.63l9.9-10.2a.5.5 0 0 1 .86.46l-1.92 6.02A1 1 0 0 0 13 10h7a1 1 0 0 1 .78 1.63l-9.9 10.2a.5.5 0 0 1-.86-.46l1.92-6.02A1 1 0 0 0 11 14z",key:"1xq2db"}]],Zap=createLucideIcon("zap",__iconNode$2);const __iconNode$1=[["circle",{cx:"11",cy:"11",r:"8",key:"4ej97u"}],["line",{x1:"21",x2:"16.65",y1:"21",y2:"16.65",key:"13gj7c"}],["line",{x1:"11",x2:"11",y1:"8",y2:"14",key:"1vmskp"}],["line",{x1:"8",x2:"14",y1:"11",y2:"11",key:"durymu"}]],ZoomIn=createLucideIcon("zoom-in",__iconNode$1);const __iconNode=[["circle",{cx:"11",cy:"11",r:"8",key:"4ej97u"}],["line",{x1:"21",x2:"16.65",y1:"21",y2:"16.65",key:"13gj7c"}],["line",{x1:"8",x2:"14",y1:"11",y2:"11",key:"durymu"}]],ZoomOut=createLucideIcon("zoom-out",__iconNode);const index=Object.freeze(Object.defineProperty({__proto__:null,AArrowDown,AArrowUp,ALargeSmall,Accessibility,Activity,AirVent,Airplay,AlarmClock,AlarmClockCheck,AlarmClockMinus,AlarmClockOff,AlarmClockPlus,AlarmSmoke,Album,AlignCenterHorizontal,AlignCenterVertical,AlignEndHorizontal,AlignEndVertical,AlignHorizontalDistributeCenter,AlignHorizontalDistributeEnd,AlignHorizontalDistributeStart,AlignHorizontalJustifyCenter,AlignHorizontalJustifyEnd,AlignHorizontalJustifyStart,AlignHorizontalSpaceAround,AlignHorizontalSpaceBetween,AlignStartHorizontal,AlignStartVertical,AlignVerticalDistributeCenter,AlignVerticalDistributeEnd,AlignVerticalDistributeStart,AlignVerticalJustifyCenter,AlignVerticalJustifyEnd,AlignVerticalJustifyStart,AlignVerticalSpaceAround,AlignVerticalSpaceBetween,Ambulance,Ampersand,Ampersands,Amphora,Anchor,Angry,Annoyed,Antenna,Anvil,Aperture,AppWindow,AppWindowMac,Apple,Archive,ArchiveRestore,ArchiveX,Armchair,ArrowBigDown,ArrowBigDownDash,ArrowBigLeft,ArrowBigLeftDash,ArrowBigRight,ArrowBigRightDash,ArrowBigUp,ArrowBigUpDash,ArrowDown,ArrowDown01,ArrowDown10,ArrowDownAZ,ArrowDownFromLine,ArrowDownLeft,ArrowDownNarrowWide,ArrowDownRight,ArrowDownToDot,ArrowDownToLine,ArrowDownUp,ArrowDownWideNarrow,ArrowDownZA,ArrowLeft,ArrowLeftFromLine,ArrowLeftRight,ArrowLeftToLine,ArrowRight,ArrowRightFromLine,ArrowRightLeft,ArrowRightToLine,ArrowUp,ArrowUp01,ArrowUp10,ArrowUpAZ,ArrowUpDown,ArrowUpFromDot,ArrowUpFromLine,ArrowUpLeft,ArrowUpNarrowWide,ArrowUpRight,ArrowUpToLine,ArrowUpWideNarrow,ArrowUpZA,ArrowsUpFromLine,Asterisk,AtSign,Atom,AudioLines,AudioWaveform,Award,Axe,Axis3d,Baby,Backpack,Badge,BadgeAlert,BadgeCent,BadgeCheck,BadgeDollarSign,BadgeEuro,BadgeIndianRupee,BadgeInfo,BadgeJapaneseYen,BadgeMinus,BadgePercent,BadgePlus,BadgePoundSterling,BadgeQuestionMark,BadgeRussianRuble,BadgeSwissFranc,BadgeTurkishLira,BadgeX,BaggageClaim,Ban,Banana,Bandage,Banknote,BanknoteArrowDown,BanknoteArrowUp,BanknoteX,Barcode,Barrel,Baseline,Bath,Battery,BatteryCharging,BatteryFull,BatteryLow,BatteryMedium,BatteryPlus,BatteryWarning,Beaker,Bean,BeanOff,Bed,BedDouble,BedSingle,Beef,Beer,BeerOff,Bell,BellDot,BellElectric,BellMinus,BellOff,BellPlus,BellRing,BetweenHorizontalEnd,BetweenHorizontalStart,BetweenVerticalEnd,BetweenVerticalStart,BicepsFlexed,Bike,Binary,Binoculars,Biohazard,Bird,Birdhouse,Bitcoin,Blend,Blinds,Blocks,Bluetooth,BluetoothConnected,BluetoothOff,BluetoothSearching,Bold,Bolt,Bomb,Bone,Book,BookA,BookAlert,BookAudio,BookCheck,BookCopy,BookDashed,BookDown,BookHeadphones,BookHeart,BookImage,BookKey,BookLock,BookMarked,BookMinus,BookOpen,BookOpenCheck,BookOpenText,BookPlus,BookText,BookType,BookUp,BookUp2,BookUser,BookX,Bookmark,BookmarkCheck,BookmarkMinus,BookmarkPlus,BookmarkX,BoomBox,Bot,BotMessageSquare,BotOff,BottleWine,BowArrow,Box,Boxes,Braces,Brackets,Brain,BrainCircuit,BrainCog,BrickWall,BrickWallFire,BrickWallShield,Briefcase,BriefcaseBusiness,BriefcaseConveyorBelt,BriefcaseMedical,BringToFront,Brush,BrushCleaning,Bubbles,Bug,BugOff,BugPlay,Building,Building2,Bus,BusFront,Cable,CableCar,Cake,CakeSlice,Calculator,Calendar,Calendar1,CalendarArrowDown,CalendarArrowUp,CalendarCheck,CalendarCheck2,CalendarClock,CalendarCog,CalendarDays,CalendarFold,CalendarHeart,CalendarMinus,CalendarMinus2,CalendarOff,CalendarPlus,CalendarPlus2,CalendarRange,CalendarSearch,CalendarSync,CalendarX,CalendarX2,Calendars,Camera,CameraOff,Candy,CandyCane,CandyOff,Cannabis,Captions,CaptionsOff,Car,CarFront,CarTaxiFront,Caravan,CardSim,Carrot,CaseLower,CaseSensitive,CaseUpper,CassetteTape,Cast,Castle,Cat,Cctv,ChartArea,ChartBar,ChartBarBig,ChartBarDecreasing,ChartBarIncreasing,ChartBarStacked,ChartCandlestick,ChartColumn,ChartColumnBig,ChartColumnDecreasing,ChartColumnIncreasing,ChartColumnStacked,ChartGantt,ChartLine,ChartNetwork,ChartNoAxesColumn,ChartNoAxesColumnDecreasing,ChartNoAxesColumnIncreasing,ChartNoAxesCombined,ChartNoAxesGantt,ChartPie,ChartScatter,ChartSpline,Check,CheckCheck,CheckLine,ChefHat,Cherry,ChessBishop,ChessKing,ChessKnight,ChessPawn,ChessQueen,ChessRook,ChevronDown,ChevronFirst,ChevronLast,ChevronLeft,ChevronRight,ChevronUp,ChevronsDown,ChevronsDownUp,ChevronsLeft,ChevronsLeftRight,ChevronsLeftRightEllipsis,ChevronsRight,ChevronsRightLeft,ChevronsUp,ChevronsUpDown,Chromium,Church,Cigarette,CigaretteOff,Circle,CircleAlert,CircleArrowDown,CircleArrowLeft,CircleArrowOutDownLeft,CircleArrowOutDownRight,CircleArrowOutUpLeft,CircleArrowOutUpRight,CircleArrowRight,CircleArrowUp,CircleCheck,CircleCheckBig,CircleChevronDown,CircleChevronLeft,CircleChevronRight,CircleChevronUp,CircleDashed,CircleDivide,CircleDollarSign,CircleDot,CircleDotDashed,CircleEllipsis,CircleEqual,CircleFadingArrowUp,CircleFadingPlus,CircleGauge,CircleMinus,CircleOff,CircleParking,CircleParkingOff,CirclePause,CirclePercent,CirclePlay,CirclePlus,CirclePoundSterling,CirclePower,CircleQuestionMark,CircleSlash,CircleSlash2,CircleSmall,CircleStar,CircleStop,CircleUser,CircleUserRound,CircleX,CircuitBoard,Citrus,Clapperboard,Clipboard,ClipboardCheck,ClipboardClock,ClipboardCopy,ClipboardList,ClipboardMinus,ClipboardPaste,ClipboardPen,ClipboardPenLine,ClipboardPlus,ClipboardType,ClipboardX,Clock,Clock1,Clock10,Clock11,Clock12,Clock2,Clock3,Clock4,Clock5,Clock6,Clock7,Clock8,Clock9,ClockAlert,ClockArrowDown,ClockArrowUp,ClockCheck,ClockFading,ClockPlus,ClosedCaption,Cloud,CloudAlert,CloudCheck,CloudCog,CloudDownload,CloudDrizzle,CloudFog,CloudHail,CloudLightning,CloudMoon,CloudMoonRain,CloudOff,CloudRain,CloudRainWind,CloudSnow,CloudSun,CloudSunRain,CloudUpload,Cloudy,Clover,Club,Code,CodeXml,Codepen,Codesandbox,Coffee,Cog,Coins,Columns2,Columns3,Columns3Cog,Columns4,Combine,Command,Compass,Component,Computer,ConciergeBell,Cone,Construction,Contact,ContactRound,Container,Contrast,Cookie,CookingPot,Copy,CopyCheck,CopyMinus,CopyPlus,CopySlash,CopyX,Copyleft,Copyright,CornerDownLeft,CornerDownRight,CornerLeftDown,CornerLeftUp,CornerRightDown,CornerRightUp,CornerUpLeft,CornerUpRight,Cpu,CreativeCommons,CreditCard,Croissant,Crop,Cross,Crosshair,Crown,Cuboid,CupSoda,Currency,Cylinder,Dam,Database,DatabaseBackup,DatabaseZap,DecimalsArrowLeft,DecimalsArrowRight,Delete,Dessert,Diameter,Diamond,DiamondMinus,DiamondPercent,DiamondPlus,Dice1,Dice2,Dice3,Dice4,Dice5,Dice6,Dices,Diff,Disc,Disc2,Disc3,DiscAlbum,Divide,Dna,DnaOff,Dock,Dog,DollarSign,Donut,DoorClosed,DoorClosedLocked,DoorOpen,Dot,Download,DraftingCompass,Drama,Dribbble,Drill,Drone,Droplet,DropletOff,Droplets,Drum,Drumstick,Dumbbell,Ear,EarOff,Earth,EarthLock,Eclipse,Egg,EggFried,EggOff,Ellipsis,EllipsisVertical,Equal,EqualApproximately,EqualNot,Eraser,EthernetPort,Euro,EvCharger,Expand,ExternalLink,Eye,EyeClosed,EyeOff,Facebook,Factory,Fan,FastForward,Feather,Fence,FerrisWheel,Figma,File,FileArchive,FileAxis3d,FileBadge,FileBox,FileBraces,FileBracesCorner,FileChartColumn,FileChartColumnIncreasing,FileChartLine,FileChartPie,FileCheck,FileCheckCorner,FileClock,FileCode,FileCodeCorner,FileCog,FileDiff,FileDigit,FileDown,FileExclamationPoint,FileHeadphone,FileHeart,FileImage,FileInput,FileKey,FileLock,FileMinus,FileMinusCorner,FileMusic,FileOutput,FilePen,FilePenLine,FilePlay,FilePlus,FilePlusCorner,FileQuestionMark,FileScan,FileSearch,FileSearchCorner,FileSignal,FileSliders,FileSpreadsheet,FileStack,FileSymlink,FileTerminal,FileText,FileType,FileTypeCorner,FileUp,FileUser,FileVideoCamera,FileVolume,FileX,FileXCorner,Files,Film,FingerprintPattern,FireExtinguisher,Fish,FishOff,FishSymbol,Flag,FlagOff,FlagTriangleLeft,FlagTriangleRight,Flame,FlameKindling,Flashlight,FlashlightOff,FlaskConical,FlaskConicalOff,FlaskRound,FlipHorizontal,FlipHorizontal2,FlipVertical,FlipVertical2,Flower,Flower2,Focus,FoldHorizontal,FoldVertical,Folder,FolderArchive,FolderCheck,FolderClock,FolderClosed,FolderCode,FolderCog,FolderDot,FolderDown,FolderGit,FolderGit2,FolderHeart,FolderInput,FolderKanban,FolderKey,FolderLock,FolderMinus,FolderOpen,FolderOpenDot,FolderOutput,FolderPen,FolderPlus,FolderRoot,FolderSearch,FolderSearch2,FolderSymlink,FolderSync,FolderTree,FolderUp,FolderX,Folders,Footprints,Forklift,Forward,Frame,Framer,Frown,Fuel,Fullscreen,Funnel,FunnelPlus,FunnelX,GalleryHorizontal,GalleryHorizontalEnd,GalleryThumbnails,GalleryVertical,GalleryVerticalEnd,Gamepad,Gamepad2,GamepadDirectional,Gauge,Gavel,Gem,GeorgianLari,Ghost,Gift,GitBranch,GitBranchMinus,GitBranchPlus,GitCommitHorizontal,GitCommitVertical,GitCompare,GitCompareArrows,GitFork,GitGraph,GitMerge,GitPullRequest,GitPullRequestArrow,GitPullRequestClosed,GitPullRequestCreate,GitPullRequestCreateArrow,GitPullRequestDraft,Github,Gitlab,GlassWater,Glasses,Globe,GlobeLock,Goal,Gpu,GraduationCap,Grape,Grid2x2,Grid2x2Check,Grid2x2Plus,Grid2x2X,Grid3x2,Grid3x3,Grip,GripHorizontal,GripVertical,Group,Guitar,Ham,Hamburger,Hammer,Hand,HandCoins,HandFist,HandGrab,HandHeart,HandHelping,HandMetal,HandPlatter,Handbag,Handshake,HardDrive,HardDriveDownload,HardDriveUpload,HardHat,Hash:Hash$1,HatGlasses,Haze,HdmiPort,Heading:Heading$1,Heading1,Heading2,Heading3,Heading4,Heading5,Heading6,HeadphoneOff,Headphones,Headset,Heart,HeartCrack,HeartHandshake,HeartMinus,HeartOff,HeartPlus,HeartPulse,Heater,Helicopter,Hexagon,Highlighter,History,Hop,HopOff,Hospital,Hotel,Hourglass,House,HouseHeart,HousePlug,HousePlus,HouseWifi,IceCreamBowl,IceCreamCone,IdCard,IdCardLanyard,Image:Image$1,ImageDown,ImageMinus,ImageOff,ImagePlay,ImagePlus,ImageUp,ImageUpscale,Images,Import,Inbox,IndianRupee,Infinity:Infinity$1,Info,InspectionPanel,Instagram,Italic,IterationCcw,IterationCw,JapaneseYen,Joystick,Kanban,Kayak,Key,KeyRound,KeySquare,Keyboard,KeyboardMusic,KeyboardOff,Lamp,LampCeiling,LampDesk,LampFloor,LampWallDown,LampWallUp,LandPlot,Landmark,Languages,Laptop,LaptopMinimal,LaptopMinimalCheck,Lasso,LassoSelect,Laugh,Layers,Layers2,LayoutDashboard,LayoutGrid,LayoutList,LayoutPanelLeft,LayoutPanelTop,LayoutTemplate,Leaf,LeafyGreen,Lectern,Library,LibraryBig,LifeBuoy,Ligature,Lightbulb,LightbulbOff,LineSquiggle,Link,Link2,Link2Off,Linkedin,List,ListCheck,ListChecks,ListChevronsDownUp,ListChevronsUpDown,ListCollapse,ListEnd,ListFilter,ListFilterPlus,ListIndentDecrease,ListIndentIncrease,ListMinus,ListMusic,ListOrdered,ListPlus,ListRestart,ListStart,ListTodo,ListTree,ListVideo,ListX,Loader,LoaderCircle,LoaderPinwheel,Locate,LocateFixed,LocateOff,Lock,LockKeyhole,LockKeyholeOpen,LockOpen,LogIn,LogOut,Logs,Lollipop,Luggage,Magnet,Mail,MailCheck,MailMinus,MailOpen,MailPlus,MailQuestionMark,MailSearch,MailWarning,MailX,Mailbox,Mails,Map:Map$2,MapMinus,MapPin,MapPinCheck,MapPinCheckInside,MapPinHouse,MapPinMinus,MapPinMinusInside,MapPinOff,MapPinPen,MapPinPlus,MapPinPlusInside,MapPinX,MapPinXInside,MapPinned,MapPlus,Mars,MarsStroke,Martini,Maximize,Maximize2,Medal,Megaphone,MegaphoneOff,Meh,MemoryStick,Menu,Merge,MessageCircle,MessageCircleCode,MessageCircleDashed,MessageCircleHeart,MessageCircleMore,MessageCircleOff,MessageCirclePlus,MessageCircleQuestionMark,MessageCircleReply,MessageCircleWarning,MessageCircleX,MessageSquare,MessageSquareCode,MessageSquareDashed,MessageSquareDiff,MessageSquareDot,MessageSquareHeart,MessageSquareLock,MessageSquareMore,MessageSquareOff,MessageSquarePlus,MessageSquareQuote,MessageSquareReply,MessageSquareShare,MessageSquareText,MessageSquareWarning,MessageSquareX,MessagesSquare,Mic,MicOff,MicVocal,Microchip,Microscope,Microwave,Milestone,Milk,MilkOff,Minimize,Minimize2,Minus,Monitor,MonitorCheck,MonitorCloud,MonitorCog,MonitorDot,MonitorDown,MonitorOff,MonitorPause,MonitorPlay,MonitorSmartphone,MonitorSpeaker,MonitorStop,MonitorUp,MonitorX,Moon,MoonStar,Motorbike,Mountain,MountainSnow,Mouse,MouseOff,MousePointer,MousePointer2,MousePointer2Off,MousePointerBan,MousePointerClick,Move,Move3d,MoveDiagonal,MoveDiagonal2,MoveDown,MoveDownLeft,MoveDownRight,MoveHorizontal,MoveLeft,MoveRight,MoveUp,MoveUpLeft,MoveUpRight,MoveVertical,Music,Music2,Music3,Music4,Navigation,Navigation2,Navigation2Off,NavigationOff,Network,Newspaper,Nfc,NonBinary,Notebook,NotebookPen,NotebookTabs,NotebookText,NotepadText,NotepadTextDashed,Nut,NutOff,Octagon,OctagonAlert,OctagonMinus,OctagonPause,OctagonX,Omega,Option,Orbit,Origami,Package,Package2,PackageCheck,PackageMinus,PackageOpen,PackagePlus,PackageSearch,PackageX,PaintBucket,PaintRoller,Paintbrush,PaintbrushVertical,Palette,Panda,PanelBottom,PanelBottomClose,PanelBottomDashed,PanelBottomOpen,PanelLeft,PanelLeftClose,PanelLeftDashed,PanelLeftOpen,PanelLeftRightDashed,PanelRight,PanelRightClose,PanelRightDashed,PanelRightOpen,PanelTop,PanelTopBottomDashed,PanelTopClose,PanelTopDashed,PanelTopOpen,PanelsLeftBottom,PanelsRightBottom,PanelsTopLeft,Paperclip,Parentheses,ParkingMeter,PartyPopper,Pause,PawPrint,PcCase,Pen,PenLine,PenOff,PenTool,Pencil,PencilLine,PencilOff,PencilRuler,Pentagon,Percent,PersonStanding,PhilippinePeso,Phone,PhoneCall,PhoneForwarded,PhoneIncoming,PhoneMissed,PhoneOff,PhoneOutgoing,Pi,Piano,Pickaxe,PictureInPicture,PictureInPicture2,PiggyBank,Pilcrow,PilcrowLeft,PilcrowRight,Pill,PillBottle,Pin,PinOff,Pipette,Pizza,Plane,PlaneLanding,PlaneTakeoff,Play,Plug,Plug2,PlugZap,Plus,Pocket,PocketKnife,Podcast,Pointer,PointerOff,Popcorn,Popsicle,PoundSterling,Power,PowerOff,Presentation,Printer,PrinterCheck,Projector,Proportions,Puzzle,Pyramid,QrCode,Quote,Rabbit,Radar,Radiation,Radical,Radio,RadioReceiver,RadioTower,Radius,RailSymbol,Rainbow,Rat,Ratio,Receipt,ReceiptCent,ReceiptEuro,ReceiptIndianRupee,ReceiptJapaneseYen,ReceiptPoundSterling,ReceiptRussianRuble,ReceiptSwissFranc,ReceiptText,ReceiptTurkishLira,RectangleCircle,RectangleEllipsis,RectangleGoggles,RectangleHorizontal,RectangleVertical,Recycle,Redo,Redo2,RedoDot,RefreshCcw,RefreshCcwDot,RefreshCw,RefreshCwOff,Refrigerator,Regex,RemoveFormatting,Repeat,Repeat1,Repeat2,Replace,ReplaceAll,Reply,ReplyAll,Rewind,Ribbon,Rocket,RockingChair,RollerCoaster,Rose,Rotate3d,RotateCcw,RotateCcwKey,RotateCcwSquare,RotateCw,RotateCwSquare,Route,RouteOff,Router,Rows2,Rows3,Rows4,Rss,Ruler,RulerDimensionLine,RussianRuble,Sailboat,Salad,Sandwich,Satellite,SatelliteDish,SaudiRiyal,Save,SaveAll,SaveOff,Scale,Scale3d,Scaling,Scan,ScanBarcode,ScanEye,ScanFace,ScanHeart,ScanLine,ScanQrCode,ScanSearch,ScanText,School,Scissors,ScissorsLineDashed,ScreenShare,ScreenShareOff,Scroll,ScrollText,Search,SearchCheck,SearchCode,SearchSlash,SearchX,Section,Send,SendHorizontal,SendToBack,SeparatorHorizontal,SeparatorVertical,Server,ServerCog,ServerCrash,ServerOff,Settings,Settings2,Shapes,Share,Share2,Sheet,Shell,Shield,ShieldAlert,ShieldBan,ShieldCheck,ShieldEllipsis,ShieldHalf,ShieldMinus,ShieldOff,ShieldPlus,ShieldQuestionMark,ShieldUser,ShieldX,Ship,ShipWheel,Shirt,ShoppingBag,ShoppingBasket,ShoppingCart,Shovel,ShowerHead,Shredder,Shrimp,Shrink,Shrub,Shuffle,Sigma,Signal,SignalHigh,SignalLow,SignalMedium,SignalZero,Signature,Signpost,SignpostBig,Siren,SkipBack,SkipForward,Skull,Slack,Slash,Slice,SlidersHorizontal,SlidersVertical,Smartphone,SmartphoneCharging,SmartphoneNfc,Smile,SmilePlus,Snail,Snowflake,SoapDispenserDroplet,Sofa,SolarPanel,Soup,Space,Spade,Sparkle,Sparkles,Speaker,Speech,SpellCheck,SpellCheck2,Spline,SplinePointer,Split,Spool,Spotlight,SprayCan,Sprout,Square,SquareActivity,SquareArrowDown,SquareArrowDownLeft,SquareArrowDownRight,SquareArrowLeft,SquareArrowOutDownLeft,SquareArrowOutDownRight,SquareArrowOutUpLeft,SquareArrowOutUpRight,SquareArrowRight,SquareArrowUp,SquareArrowUpLeft,SquareArrowUpRight,SquareAsterisk,SquareBottomDashedScissors,SquareChartGantt,SquareCheck,SquareCheckBig,SquareChevronDown,SquareChevronLeft,SquareChevronRight,SquareChevronUp,SquareCode,SquareDashed,SquareDashedBottom,SquareDashedBottomCode,SquareDashedKanban,SquareDashedMousePointer,SquareDashedTopSolid,SquareDivide,SquareDot,SquareEqual,SquareFunction,SquareKanban,SquareLibrary,SquareM,SquareMenu,SquareMinus,SquareMousePointer,SquareParking,SquareParkingOff,SquarePause,SquarePen,SquarePercent,SquarePi,SquarePilcrow,SquarePlay,SquarePlus,SquarePower,SquareRadical,SquareRoundCorner,SquareScissors,SquareSigma,SquareSlash,SquareSplitHorizontal,SquareSplitVertical,SquareSquare,SquareStack,SquareStar,SquareStop,SquareTerminal,SquareUser,SquareUserRound,SquareX,SquaresExclude,SquaresIntersect,SquaresSubtract,SquaresUnite,Squircle,SquircleDashed,Squirrel,Stamp,Star,StarHalf,StarOff,StepBack,StepForward,Stethoscope,Sticker,StickyNote,Store,StretchHorizontal,StretchVertical,Strikethrough,Subscript,Sun,SunDim,SunMedium,SunMoon,SunSnow,Sunrise,Sunset,Superscript,SwatchBook,SwissFranc,SwitchCamera,Sword,Swords,Syringe,Table,Table2,TableCellsMerge,TableCellsSplit,TableColumnsSplit,TableOfContents:TableOfContents$1,TableProperties,TableRowsSplit,Tablet,TabletSmartphone,Tablets,Tag,Tags,Tally1,Tally2,Tally3,Tally4,Tally5,Tangent,Target,Telescope,Tent,TentTree,Terminal,TestTube,TestTubeDiagonal,TestTubes,TextAlignCenter,TextAlignEnd,TextAlignJustify,TextAlignStart,TextCursor,TextCursorInput,TextInitial,TextQuote,TextSearch,TextSelect,TextWrap,Theater,Thermometer,ThermometerSnowflake,ThermometerSun,ThumbsDown,ThumbsUp,Ticket,TicketCheck,TicketMinus,TicketPercent,TicketPlus,TicketSlash,TicketX,Tickets,TicketsPlane,Timer:Timer$1,TimerOff,TimerReset,ToggleLeft,ToggleRight,Toilet,ToolCase,Tornado,Torus,Touchpad,TouchpadOff,TowerControl,ToyBrick,Tractor,TrafficCone,TrainFront,TrainFrontTunnel,TrainTrack,TramFront,Transgender,Trash,Trash2,TreeDeciduous,TreePalm,TreePine,Trees,Trello,TrendingDown,TrendingUp,TrendingUpDown,Triangle,TriangleAlert,TriangleDashed,TriangleRight,Trophy,Truck,TruckElectric,TurkishLira,Turntable,Turtle,Tv,TvMinimal,TvMinimalPlay,Twitch,Twitter,Type:Type$2,TypeOutline,Umbrella,UmbrellaOff,Underline,Undo,Undo2,UndoDot,UnfoldHorizontal,UnfoldVertical,Ungroup,University,Unlink,Unlink2,Unplug,Upload,Usb,User,UserCheck,UserCog,UserLock,UserMinus,UserPen,UserPlus,UserRound,UserRoundCheck,UserRoundCog,UserRoundMinus,UserRoundPen,UserRoundPlus,UserRoundSearch,UserRoundX,UserSearch,UserStar,UserX,Users,UsersRound,Utensils,UtensilsCrossed,UtilityPole,Variable,Vault,VectorSquare,Vegan,VenetianMask,Venus,VenusAndMars,Vibrate,VibrateOff,Video,VideoOff,Videotape,View,Voicemail,Volleyball,Volume,Volume1,Volume2,VolumeOff,VolumeX,Vote,Wallet,WalletCards,WalletMinimal,Wallpaper,Wand,WandSparkles,Warehouse,WashingMachine,Watch,Waves,WavesLadder,Waypoints,Webcam,Webhook,WebhookOff,Weight,Wheat,WheatOff,WholeWord,Wifi,WifiCog,WifiHigh,WifiLow,WifiOff,WifiPen,WifiSync,WifiZero,Wind,WindArrowDown,Wine,WineOff,Workflow,Worm,Wrench,X:X$3,Youtube,Zap,ZapOff,ZoomIn,ZoomOut},Symbol.toStringTag,{value:"Module"}));const Icons=Object.freeze(Object.defineProperty({__proto__:null,AArrowDown,AArrowDownIcon:AArrowDown,AArrowUp,AArrowUpIcon:AArrowUp,ALargeSmall,ALargeSmallIcon:ALargeSmall,Accessibility,AccessibilityIcon:Accessibility,Activity,ActivityIcon:Activity,ActivitySquare:SquareActivity,ActivitySquareIcon:SquareActivity,AirVent,AirVentIcon:AirVent,Airplay,AirplayIcon:Airplay,AlarmCheck:AlarmClockCheck,AlarmCheckIcon:AlarmClockCheck,AlarmClock,AlarmClockCheck,AlarmClockCheckIcon:AlarmClockCheck,AlarmClockIcon:AlarmClock,AlarmClockMinus,AlarmClockMinusIcon:AlarmClockMinus,AlarmClockOff,AlarmClockOffIcon:AlarmClockOff,AlarmClockPlus,AlarmClockPlusIcon:AlarmClockPlus,AlarmMinus:AlarmClockMinus,AlarmMinusIcon:AlarmClockMinus,AlarmPlus:AlarmClockPlus,AlarmPlusIcon:AlarmClockPlus,AlarmSmoke,AlarmSmokeIcon:AlarmSmoke,Album,AlbumIcon:Album,AlertCircle:CircleAlert,AlertCircleIcon:CircleAlert,AlertOctagon:OctagonAlert,AlertOctagonIcon:OctagonAlert,AlertTriangle:TriangleAlert,AlertTriangleIcon:TriangleAlert,AlignCenter:TextAlignCenter,AlignCenterHorizontal,AlignCenterHorizontalIcon:AlignCenterHorizontal,AlignCenterIcon:TextAlignCenter,AlignCenterVertical,AlignCenterVerticalIcon:AlignCenterVertical,AlignEndHorizontal,AlignEndHorizontalIcon:AlignEndHorizontal,AlignEndVertical,AlignEndVerticalIcon:AlignEndVertical,AlignHorizontalDistributeCenter,AlignHorizontalDistributeCenterIcon:AlignHorizontalDistributeCenter,AlignHorizontalDistributeEnd,AlignHorizontalDistributeEndIcon:AlignHorizontalDistributeEnd,AlignHorizontalDistributeStart,AlignHorizontalDistributeStartIcon:AlignHorizontalDistributeStart,AlignHorizontalJustifyCenter,AlignHorizontalJustifyCenterIcon:AlignHorizontalJustifyCenter,AlignHorizontalJustifyEnd,AlignHorizontalJustifyEndIcon:AlignHorizontalJustifyEnd,AlignHorizontalJustifyStart,AlignHorizontalJustifyStartIcon:AlignHorizontalJustifyStart,AlignHorizontalSpaceAround,AlignHorizontalSpaceAroundIcon:AlignHorizontalSpaceAround,AlignHorizontalSpaceBetween,AlignHorizontalSpaceBetweenIcon:AlignHorizontalSpaceBetween,AlignJustify:TextAlignJustify,AlignJustifyIcon:TextAlignJustify,AlignLeft:TextAlignStart,AlignLeftIcon:TextAlignStart,AlignRight:TextAlignEnd,AlignRightIcon:TextAlignEnd,AlignStartHorizontal,AlignStartHorizontalIcon:AlignStartHorizontal,AlignStartVertical,AlignStartVerticalIcon:AlignStartVertical,AlignVerticalDistributeCenter,AlignVerticalDistributeCenterIcon:AlignVerticalDistributeCenter,AlignVerticalDistributeEnd,AlignVerticalDistributeEndIcon:AlignVerticalDistributeEnd,AlignVerticalDistributeStart,AlignVerticalDistributeStartIcon:AlignVerticalDistributeStart,AlignVerticalJustifyCenter,AlignVerticalJustifyCenterIcon:AlignVerticalJustifyCenter,AlignVerticalJustifyEnd,AlignVerticalJustifyEndIcon:AlignVerticalJustifyEnd,AlignVerticalJustifyStart,AlignVerticalJustifyStartIcon:AlignVerticalJustifyStart,AlignVerticalSpaceAround,AlignVerticalSpaceAroundIcon:AlignVerticalSpaceAround,AlignVerticalSpaceBetween,AlignVerticalSpaceBetweenIcon:AlignVerticalSpaceBetween,Ambulance,AmbulanceIcon:Ambulance,Ampersand,AmpersandIcon:Ampersand,Ampersands,AmpersandsIcon:Ampersands,Amphora,AmphoraIcon:Amphora,Anchor,AnchorIcon:Anchor,Angry,AngryIcon:Angry,Annoyed,AnnoyedIcon:Annoyed,Antenna,AntennaIcon:Antenna,Anvil,AnvilIcon:Anvil,Aperture,ApertureIcon:Aperture,AppWindow,AppWindowIcon:AppWindow,AppWindowMac,AppWindowMacIcon:AppWindowMac,Apple,AppleIcon:Apple,Archive,ArchiveIcon:Archive,ArchiveRestore,ArchiveRestoreIcon:ArchiveRestore,ArchiveX,ArchiveXIcon:ArchiveX,AreaChart:ChartArea,AreaChartIcon:ChartArea,Armchair,ArmchairIcon:Armchair,ArrowBigDown,ArrowBigDownDash,ArrowBigDownDashIcon:ArrowBigDownDash,ArrowBigDownIcon:ArrowBigDown,ArrowBigLeft,ArrowBigLeftDash,ArrowBigLeftDashIcon:ArrowBigLeftDash,ArrowBigLeftIcon:ArrowBigLeft,ArrowBigRight,ArrowBigRightDash,ArrowBigRightDashIcon:ArrowBigRightDash,ArrowBigRightIcon:ArrowBigRight,ArrowBigUp,ArrowBigUpDash,ArrowBigUpDashIcon:ArrowBigUpDash,ArrowBigUpIcon:ArrowBigUp,ArrowDown,ArrowDown01,ArrowDown01Icon:ArrowDown01,ArrowDown10,ArrowDown10Icon:ArrowDown10,ArrowDownAZ,ArrowDownAZIcon:ArrowDownAZ,ArrowDownAz:ArrowDownAZ,ArrowDownAzIcon:ArrowDownAZ,ArrowDownCircle:CircleArrowDown,ArrowDownCircleIcon:CircleArrowDown,ArrowDownFromLine,ArrowDownFromLineIcon:ArrowDownFromLine,ArrowDownIcon:ArrowDown,ArrowDownLeft,ArrowDownLeftFromCircle:CircleArrowOutDownLeft,ArrowDownLeftFromCircleIcon:CircleArrowOutDownLeft,ArrowDownLeftFromSquare:SquareArrowOutDownLeft,ArrowDownLeftFromSquareIcon:SquareArrowOutDownLeft,ArrowDownLeftIcon:ArrowDownLeft,ArrowDownLeftSquare:SquareArrowDownLeft,ArrowDownLeftSquareIcon:SquareArrowDownLeft,ArrowDownNarrowWide,ArrowDownNarrowWideIcon:ArrowDownNarrowWide,ArrowDownRight,ArrowDownRightFromCircle:CircleArrowOutDownRight,ArrowDownRightFromCircleIcon:CircleArrowOutDownRight,ArrowDownRightFromSquare:SquareArrowOutDownRight,ArrowDownRightFromSquareIcon:SquareArrowOutDownRight,ArrowDownRightIcon:ArrowDownRight,ArrowDownRightSquare:SquareArrowDownRight,ArrowDownRightSquareIcon:SquareArrowDownRight,ArrowDownSquare:SquareArrowDown,ArrowDownSquareIcon:SquareArrowDown,ArrowDownToDot,ArrowDownToDotIcon:ArrowDownToDot,ArrowDownToLine,ArrowDownToLineIcon:ArrowDownToLine,ArrowDownUp,ArrowDownUpIcon:ArrowDownUp,ArrowDownWideNarrow,ArrowDownWideNarrowIcon:ArrowDownWideNarrow,ArrowDownZA,ArrowDownZAIcon:ArrowDownZA,ArrowDownZa:ArrowDownZA,ArrowDownZaIcon:ArrowDownZA,ArrowLeft,ArrowLeftCircle:CircleArrowLeft,ArrowLeftCircleIcon:CircleArrowLeft,ArrowLeftFromLine,ArrowLeftFromLineIcon:ArrowLeftFromLine,ArrowLeftIcon:ArrowLeft,ArrowLeftRight,ArrowLeftRightIcon:ArrowLeftRight,ArrowLeftSquare:SquareArrowLeft,ArrowLeftSquareIcon:SquareArrowLeft,ArrowLeftToLine,ArrowLeftToLineIcon:ArrowLeftToLine,ArrowRight,ArrowRightCircle:CircleArrowRight,ArrowRightCircleIcon:CircleArrowRight,ArrowRightFromLine,ArrowRightFromLineIcon:ArrowRightFromLine,ArrowRightIcon:ArrowRight,ArrowRightLeft,ArrowRightLeftIcon:ArrowRightLeft,ArrowRightSquare:SquareArrowRight,ArrowRightSquareIcon:SquareArrowRight,ArrowRightToLine,ArrowRightToLineIcon:ArrowRightToLine,ArrowUp,ArrowUp01,ArrowUp01Icon:ArrowUp01,ArrowUp10,ArrowUp10Icon:ArrowUp10,ArrowUpAZ,ArrowUpAZIcon:ArrowUpAZ,ArrowUpAz:ArrowUpAZ,ArrowUpAzIcon:ArrowUpAZ,ArrowUpCircle:CircleArrowUp,ArrowUpCircleIcon:CircleArrowUp,ArrowUpDown,ArrowUpDownIcon:ArrowUpDown,ArrowUpFromDot,ArrowUpFromDotIcon:ArrowUpFromDot,ArrowUpFromLine,ArrowUpFromLineIcon:ArrowUpFromLine,ArrowUpIcon:ArrowUp,ArrowUpLeft,ArrowUpLeftFromCircle:CircleArrowOutUpLeft,ArrowUpLeftFromCircleIcon:CircleArrowOutUpLeft,ArrowUpLeftFromSquare:SquareArrowOutUpLeft,ArrowUpLeftFromSquareIcon:SquareArrowOutUpLeft,ArrowUpLeftIcon:ArrowUpLeft,ArrowUpLeftSquare:SquareArrowUpLeft,ArrowUpLeftSquareIcon:SquareArrowUpLeft,ArrowUpNarrowWide,ArrowUpNarrowWideIcon:ArrowUpNarrowWide,ArrowUpRight,ArrowUpRightFromCircle:CircleArrowOutUpRight,ArrowUpRightFromCircleIcon:CircleArrowOutUpRight,ArrowUpRightFromSquare:SquareArrowOutUpRight,ArrowUpRightFromSquareIcon:SquareArrowOutUpRight,ArrowUpRightIcon:ArrowUpRight,ArrowUpRightSquare:SquareArrowUpRight,ArrowUpRightSquareIcon:SquareArrowUpRight,ArrowUpSquare:SquareArrowUp,ArrowUpSquareIcon:SquareArrowUp,ArrowUpToLine,ArrowUpToLineIcon:ArrowUpToLine,ArrowUpWideNarrow,ArrowUpWideNarrowIcon:ArrowUpWideNarrow,ArrowUpZA,ArrowUpZAIcon:ArrowUpZA,ArrowUpZa:ArrowUpZA,ArrowUpZaIcon:ArrowUpZA,ArrowsUpFromLine,ArrowsUpFromLineIcon:ArrowsUpFromLine,Asterisk,AsteriskIcon:Asterisk,AsteriskSquare:SquareAsterisk,AsteriskSquareIcon:SquareAsterisk,AtSign,AtSignIcon:AtSign,Atom,AtomIcon:Atom,AudioLines,AudioLinesIcon:AudioLines,AudioWaveform,AudioWaveformIcon:AudioWaveform,Award,AwardIcon:Award,Axe,AxeIcon:Axe,Axis3D:Axis3d,Axis3DIcon:Axis3d,Axis3d,Axis3dIcon:Axis3d,Baby,BabyIcon:Baby,Backpack,BackpackIcon:Backpack,Badge,BadgeAlert,BadgeAlertIcon:BadgeAlert,BadgeCent,BadgeCentIcon:BadgeCent,BadgeCheck,BadgeCheckIcon:BadgeCheck,BadgeDollarSign,BadgeDollarSignIcon:BadgeDollarSign,BadgeEuro,BadgeEuroIcon:BadgeEuro,BadgeHelp:BadgeQuestionMark,BadgeHelpIcon:BadgeQuestionMark,BadgeIcon:Badge,BadgeIndianRupee,BadgeIndianRupeeIcon:BadgeIndianRupee,BadgeInfo,BadgeInfoIcon:BadgeInfo,BadgeJapaneseYen,BadgeJapaneseYenIcon:BadgeJapaneseYen,BadgeMinus,BadgeMinusIcon:BadgeMinus,BadgePercent,BadgePercentIcon:BadgePercent,BadgePlus,BadgePlusIcon:BadgePlus,BadgePoundSterling,BadgePoundSterlingIcon:BadgePoundSterling,BadgeQuestionMark,BadgeQuestionMarkIcon:BadgeQuestionMark,BadgeRussianRuble,BadgeRussianRubleIcon:BadgeRussianRuble,BadgeSwissFranc,BadgeSwissFrancIcon:BadgeSwissFranc,BadgeTurkishLira,BadgeTurkishLiraIcon:BadgeTurkishLira,BadgeX,BadgeXIcon:BadgeX,BaggageClaim,BaggageClaimIcon:BaggageClaim,Ban,BanIcon:Ban,Banana,BananaIcon:Banana,Bandage,BandageIcon:Bandage,Banknote,BanknoteArrowDown,BanknoteArrowDownIcon:BanknoteArrowDown,BanknoteArrowUp,BanknoteArrowUpIcon:BanknoteArrowUp,BanknoteIcon:Banknote,BanknoteX,BanknoteXIcon:BanknoteX,BarChart:ChartNoAxesColumnIncreasing,BarChart2:ChartNoAxesColumn,BarChart2Icon:ChartNoAxesColumn,BarChart3:ChartColumn,BarChart3Icon:ChartColumn,BarChart4:ChartColumnIncreasing,BarChart4Icon:ChartColumnIncreasing,BarChartBig:ChartColumnBig,BarChartBigIcon:ChartColumnBig,BarChartHorizontal:ChartBar,BarChartHorizontalBig:ChartBarBig,BarChartHorizontalBigIcon:ChartBarBig,BarChartHorizontalIcon:ChartBar,BarChartIcon:ChartNoAxesColumnIncreasing,Barcode,BarcodeIcon:Barcode,Barrel,BarrelIcon:Barrel,Baseline,BaselineIcon:Baseline,Bath,BathIcon:Bath,Battery,BatteryCharging,BatteryChargingIcon:BatteryCharging,BatteryFull,BatteryFullIcon:BatteryFull,BatteryIcon:Battery,BatteryLow,BatteryLowIcon:BatteryLow,BatteryMedium,BatteryMediumIcon:BatteryMedium,BatteryPlus,BatteryPlusIcon:BatteryPlus,BatteryWarning,BatteryWarningIcon:BatteryWarning,Beaker,BeakerIcon:Beaker,Bean,BeanIcon:Bean,BeanOff,BeanOffIcon:BeanOff,Bed,BedDouble,BedDoubleIcon:BedDouble,BedIcon:Bed,BedSingle,BedSingleIcon:BedSingle,Beef,BeefIcon:Beef,Beer,BeerIcon:Beer,BeerOff,BeerOffIcon:BeerOff,Bell,BellDot,BellDotIcon:BellDot,BellElectric,BellElectricIcon:BellElectric,BellIcon:Bell,BellMinus,BellMinusIcon:BellMinus,BellOff,BellOffIcon:BellOff,BellPlus,BellPlusIcon:BellPlus,BellRing,BellRingIcon:BellRing,BetweenHorizonalEnd:BetweenHorizontalEnd,BetweenHorizonalEndIcon:BetweenHorizontalEnd,BetweenHorizonalStart:BetweenHorizontalStart,BetweenHorizonalStartIcon:BetweenHorizontalStart,BetweenHorizontalEnd,BetweenHorizontalEndIcon:BetweenHorizontalEnd,BetweenHorizontalStart,BetweenHorizontalStartIcon:BetweenHorizontalStart,BetweenVerticalEnd,BetweenVerticalEndIcon:BetweenVerticalEnd,BetweenVerticalStart,BetweenVerticalStartIcon:BetweenVerticalStart,BicepsFlexed,BicepsFlexedIcon:BicepsFlexed,Bike,BikeIcon:Bike,Binary,BinaryIcon:Binary,Binoculars,BinocularsIcon:Binoculars,Biohazard,BiohazardIcon:Biohazard,Bird,BirdIcon:Bird,Birdhouse,BirdhouseIcon:Birdhouse,Bitcoin,BitcoinIcon:Bitcoin,Blend,BlendIcon:Blend,Blinds,BlindsIcon:Blinds,Blocks,BlocksIcon:Blocks,Bluetooth,BluetoothConnected,BluetoothConnectedIcon:BluetoothConnected,BluetoothIcon:Bluetooth,BluetoothOff,BluetoothOffIcon:BluetoothOff,BluetoothSearching,BluetoothSearchingIcon:BluetoothSearching,Bold,BoldIcon:Bold,Bolt,BoltIcon:Bolt,Bomb,BombIcon:Bomb,Bone,BoneIcon:Bone,Book,BookA,BookAIcon:BookA,BookAlert,BookAlertIcon:BookAlert,BookAudio,BookAudioIcon:BookAudio,BookCheck,BookCheckIcon:BookCheck,BookCopy,BookCopyIcon:BookCopy,BookDashed,BookDashedIcon:BookDashed,BookDown,BookDownIcon:BookDown,BookHeadphones,BookHeadphonesIcon:BookHeadphones,BookHeart,BookHeartIcon:BookHeart,BookIcon:Book,BookImage,BookImageIcon:BookImage,BookKey,BookKeyIcon:BookKey,BookLock,BookLockIcon:BookLock,BookMarked,BookMarkedIcon:BookMarked,BookMinus,BookMinusIcon:BookMinus,BookOpen,BookOpenCheck,BookOpenCheckIcon:BookOpenCheck,BookOpenIcon:BookOpen,BookOpenText,BookOpenTextIcon:BookOpenText,BookPlus,BookPlusIcon:BookPlus,BookTemplate:BookDashed,BookTemplateIcon:BookDashed,BookText,BookTextIcon:BookText,BookType,BookTypeIcon:BookType,BookUp,BookUp2,BookUp2Icon:BookUp2,BookUpIcon:BookUp,BookUser,BookUserIcon:BookUser,BookX,BookXIcon:BookX,Bookmark,BookmarkCheck,BookmarkCheckIcon:BookmarkCheck,BookmarkIcon:Bookmark,BookmarkMinus,BookmarkMinusIcon:BookmarkMinus,BookmarkPlus,BookmarkPlusIcon:BookmarkPlus,BookmarkX,BookmarkXIcon:BookmarkX,BoomBox,BoomBoxIcon:BoomBox,Bot,BotIcon:Bot,BotMessageSquare,BotMessageSquareIcon:BotMessageSquare,BotOff,BotOffIcon:BotOff,BottleWine,BottleWineIcon:BottleWine,BowArrow,BowArrowIcon:BowArrow,Box,BoxIcon:Box,BoxSelect:SquareDashed,BoxSelectIcon:SquareDashed,Boxes,BoxesIcon:Boxes,Braces,BracesIcon:Braces,Brackets,BracketsIcon:Brackets,Brain,BrainCircuit,BrainCircuitIcon:BrainCircuit,BrainCog,BrainCogIcon:BrainCog,BrainIcon:Brain,BrickWall,BrickWallFire,BrickWallFireIcon:BrickWallFire,BrickWallIcon:BrickWall,BrickWallShield,BrickWallShieldIcon:BrickWallShield,Briefcase,BriefcaseBusiness,BriefcaseBusinessIcon:BriefcaseBusiness,BriefcaseConveyorBelt,BriefcaseConveyorBeltIcon:BriefcaseConveyorBelt,BriefcaseIcon:Briefcase,BriefcaseMedical,BriefcaseMedicalIcon:BriefcaseMedical,BringToFront,BringToFrontIcon:BringToFront,Brush,BrushCleaning,BrushCleaningIcon:BrushCleaning,BrushIcon:Brush,Bubbles,BubblesIcon:Bubbles,Bug,BugIcon:Bug,BugOff,BugOffIcon:BugOff,BugPlay,BugPlayIcon:BugPlay,Building,Building2,Building2Icon:Building2,BuildingIcon:Building,Bus,BusFront,BusFrontIcon:BusFront,BusIcon:Bus,Cable,CableCar,CableCarIcon:CableCar,CableIcon:Cable,Cake,CakeIcon:Cake,CakeSlice,CakeSliceIcon:CakeSlice,Calculator,CalculatorIcon:Calculator,Calendar,Calendar1,Calendar1Icon:Calendar1,CalendarArrowDown,CalendarArrowDownIcon:CalendarArrowDown,CalendarArrowUp,CalendarArrowUpIcon:CalendarArrowUp,CalendarCheck,CalendarCheck2,CalendarCheck2Icon:CalendarCheck2,CalendarCheckIcon:CalendarCheck,CalendarClock,CalendarClockIcon:CalendarClock,CalendarCog,CalendarCogIcon:CalendarCog,CalendarDays,CalendarDaysIcon:CalendarDays,CalendarFold,CalendarFoldIcon:CalendarFold,CalendarHeart,CalendarHeartIcon:CalendarHeart,CalendarIcon:Calendar,CalendarMinus,CalendarMinus2,CalendarMinus2Icon:CalendarMinus2,CalendarMinusIcon:CalendarMinus,CalendarOff,CalendarOffIcon:CalendarOff,CalendarPlus,CalendarPlus2,CalendarPlus2Icon:CalendarPlus2,CalendarPlusIcon:CalendarPlus,CalendarRange,CalendarRangeIcon:CalendarRange,CalendarSearch,CalendarSearchIcon:CalendarSearch,CalendarSync,CalendarSyncIcon:CalendarSync,CalendarX,CalendarX2,CalendarX2Icon:CalendarX2,CalendarXIcon:CalendarX,Calendars,CalendarsIcon:Calendars,Camera,CameraIcon:Camera,CameraOff,CameraOffIcon:CameraOff,CandlestickChart:ChartCandlestick,CandlestickChartIcon:ChartCandlestick,Candy,CandyCane,CandyCaneIcon:CandyCane,CandyIcon:Candy,CandyOff,CandyOffIcon:CandyOff,Cannabis,CannabisIcon:Cannabis,Captions,CaptionsIcon:Captions,CaptionsOff,CaptionsOffIcon:CaptionsOff,Car,CarFront,CarFrontIcon:CarFront,CarIcon:Car,CarTaxiFront,CarTaxiFrontIcon:CarTaxiFront,Caravan,CaravanIcon:Caravan,CardSim,CardSimIcon:CardSim,Carrot,CarrotIcon:Carrot,CaseLower,CaseLowerIcon:CaseLower,CaseSensitive,CaseSensitiveIcon:CaseSensitive,CaseUpper,CaseUpperIcon:CaseUpper,CassetteTape,CassetteTapeIcon:CassetteTape,Cast,CastIcon:Cast,Castle,CastleIcon:Castle,Cat,CatIcon:Cat,Cctv,CctvIcon:Cctv,ChartArea,ChartAreaIcon:ChartArea,ChartBar,ChartBarBig,ChartBarBigIcon:ChartBarBig,ChartBarDecreasing,ChartBarDecreasingIcon:ChartBarDecreasing,ChartBarIcon:ChartBar,ChartBarIncreasing,ChartBarIncreasingIcon:ChartBarIncreasing,ChartBarStacked,ChartBarStackedIcon:ChartBarStacked,ChartCandlestick,ChartCandlestickIcon:ChartCandlestick,ChartColumn,ChartColumnBig,ChartColumnBigIcon:ChartColumnBig,ChartColumnDecreasing,ChartColumnDecreasingIcon:ChartColumnDecreasing,ChartColumnIcon:ChartColumn,ChartColumnIncreasing,ChartColumnIncreasingIcon:ChartColumnIncreasing,ChartColumnStacked,ChartColumnStackedIcon:ChartColumnStacked,ChartGantt,ChartGanttIcon:ChartGantt,ChartLine,ChartLineIcon:ChartLine,ChartNetwork,ChartNetworkIcon:ChartNetwork,ChartNoAxesColumn,ChartNoAxesColumnDecreasing,ChartNoAxesColumnDecreasingIcon:ChartNoAxesColumnDecreasing,ChartNoAxesColumnIcon:ChartNoAxesColumn,ChartNoAxesColumnIncreasing,ChartNoAxesColumnIncreasingIcon:ChartNoAxesColumnIncreasing,ChartNoAxesCombined,ChartNoAxesCombinedIcon:ChartNoAxesCombined,ChartNoAxesGantt,ChartNoAxesGanttIcon:ChartNoAxesGantt,ChartPie,ChartPieIcon:ChartPie,ChartScatter,ChartScatterIcon:ChartScatter,ChartSpline,ChartSplineIcon:ChartSpline,Check,CheckCheck,CheckCheckIcon:CheckCheck,CheckCircle:CircleCheckBig,CheckCircle2:CircleCheck,CheckCircle2Icon:CircleCheck,CheckCircleIcon:CircleCheckBig,CheckIcon:Check,CheckLine,CheckLineIcon:CheckLine,CheckSquare:SquareCheckBig,CheckSquare2:SquareCheck,CheckSquare2Icon:SquareCheck,CheckSquareIcon:SquareCheckBig,ChefHat,ChefHatIcon:ChefHat,Cherry,CherryIcon:Cherry,ChessBishop,ChessBishopIcon:ChessBishop,ChessKing,ChessKingIcon:ChessKing,ChessKnight,ChessKnightIcon:ChessKnight,ChessPawn,ChessPawnIcon:ChessPawn,ChessQueen,ChessQueenIcon:ChessQueen,ChessRook,ChessRookIcon:ChessRook,ChevronDown,ChevronDownCircle:CircleChevronDown,ChevronDownCircleIcon:CircleChevronDown,ChevronDownIcon:ChevronDown,ChevronDownSquare:SquareChevronDown,ChevronDownSquareIcon:SquareChevronDown,ChevronFirst,ChevronFirstIcon:ChevronFirst,ChevronLast,ChevronLastIcon:ChevronLast,ChevronLeft,ChevronLeftCircle:CircleChevronLeft,ChevronLeftCircleIcon:CircleChevronLeft,ChevronLeftIcon:ChevronLeft,ChevronLeftSquare:SquareChevronLeft,ChevronLeftSquareIcon:SquareChevronLeft,ChevronRight,ChevronRightCircle:CircleChevronRight,ChevronRightCircleIcon:CircleChevronRight,ChevronRightIcon:ChevronRight,ChevronRightSquare:SquareChevronRight,ChevronRightSquareIcon:SquareChevronRight,ChevronUp,ChevronUpCircle:CircleChevronUp,ChevronUpCircleIcon:CircleChevronUp,ChevronUpIcon:ChevronUp,ChevronUpSquare:SquareChevronUp,ChevronUpSquareIcon:SquareChevronUp,ChevronsDown,ChevronsDownIcon:ChevronsDown,ChevronsDownUp,ChevronsDownUpIcon:ChevronsDownUp,ChevronsLeft,ChevronsLeftIcon:ChevronsLeft,ChevronsLeftRight,ChevronsLeftRightEllipsis,ChevronsLeftRightEllipsisIcon:ChevronsLeftRightEllipsis,ChevronsLeftRightIcon:ChevronsLeftRight,ChevronsRight,ChevronsRightIcon:ChevronsRight,ChevronsRightLeft,ChevronsRightLeftIcon:ChevronsRightLeft,ChevronsUp,ChevronsUpDown,ChevronsUpDownIcon:ChevronsUpDown,ChevronsUpIcon:ChevronsUp,Chrome:Chromium,ChromeIcon:Chromium,Chromium,ChromiumIcon:Chromium,Church,ChurchIcon:Church,Cigarette,CigaretteIcon:Cigarette,CigaretteOff,CigaretteOffIcon:CigaretteOff,Circle,CircleAlert,CircleAlertIcon:CircleAlert,CircleArrowDown,CircleArrowDownIcon:CircleArrowDown,CircleArrowLeft,CircleArrowLeftIcon:CircleArrowLeft,CircleArrowOutDownLeft,CircleArrowOutDownLeftIcon:CircleArrowOutDownLeft,CircleArrowOutDownRight,CircleArrowOutDownRightIcon:CircleArrowOutDownRight,CircleArrowOutUpLeft,CircleArrowOutUpLeftIcon:CircleArrowOutUpLeft,CircleArrowOutUpRight,CircleArrowOutUpRightIcon:CircleArrowOutUpRight,CircleArrowRight,CircleArrowRightIcon:CircleArrowRight,CircleArrowUp,CircleArrowUpIcon:CircleArrowUp,CircleCheck,CircleCheckBig,CircleCheckBigIcon:CircleCheckBig,CircleCheckIcon:CircleCheck,CircleChevronDown,CircleChevronDownIcon:CircleChevronDown,CircleChevronLeft,CircleChevronLeftIcon:CircleChevronLeft,CircleChevronRight,CircleChevronRightIcon:CircleChevronRight,CircleChevronUp,CircleChevronUpIcon:CircleChevronUp,CircleDashed,CircleDashedIcon:CircleDashed,CircleDivide,CircleDivideIcon:CircleDivide,CircleDollarSign,CircleDollarSignIcon:CircleDollarSign,CircleDot,CircleDotDashed,CircleDotDashedIcon:CircleDotDashed,CircleDotIcon:CircleDot,CircleEllipsis,CircleEllipsisIcon:CircleEllipsis,CircleEqual,CircleEqualIcon:CircleEqual,CircleFadingArrowUp,CircleFadingArrowUpIcon:CircleFadingArrowUp,CircleFadingPlus,CircleFadingPlusIcon:CircleFadingPlus,CircleGauge,CircleGaugeIcon:CircleGauge,CircleHelp:CircleQuestionMark,CircleHelpIcon:CircleQuestionMark,CircleIcon:Circle,CircleMinus,CircleMinusIcon:CircleMinus,CircleOff,CircleOffIcon:CircleOff,CircleParking,CircleParkingIcon:CircleParking,CircleParkingOff,CircleParkingOffIcon:CircleParkingOff,CirclePause,CirclePauseIcon:CirclePause,CirclePercent,CirclePercentIcon:CirclePercent,CirclePlay,CirclePlayIcon:CirclePlay,CirclePlus,CirclePlusIcon:CirclePlus,CirclePoundSterling,CirclePoundSterlingIcon:CirclePoundSterling,CirclePower,CirclePowerIcon:CirclePower,CircleQuestionMark,CircleQuestionMarkIcon:CircleQuestionMark,CircleSlash,CircleSlash2,CircleSlash2Icon:CircleSlash2,CircleSlashIcon:CircleSlash,CircleSlashed:CircleSlash2,CircleSlashedIcon:CircleSlash2,CircleSmall,CircleSmallIcon:CircleSmall,CircleStar,CircleStarIcon:CircleStar,CircleStop,CircleStopIcon:CircleStop,CircleUser,CircleUserIcon:CircleUser,CircleUserRound,CircleUserRoundIcon:CircleUserRound,CircleX,CircleXIcon:CircleX,CircuitBoard,CircuitBoardIcon:CircuitBoard,Citrus,CitrusIcon:Citrus,Clapperboard,ClapperboardIcon:Clapperboard,Clipboard,ClipboardCheck,ClipboardCheckIcon:ClipboardCheck,ClipboardClock,ClipboardClockIcon:ClipboardClock,ClipboardCopy,ClipboardCopyIcon:ClipboardCopy,ClipboardEdit:ClipboardPen,ClipboardEditIcon:ClipboardPen,ClipboardIcon:Clipboard,ClipboardList,ClipboardListIcon:ClipboardList,ClipboardMinus,ClipboardMinusIcon:ClipboardMinus,ClipboardPaste,ClipboardPasteIcon:ClipboardPaste,ClipboardPen,ClipboardPenIcon:ClipboardPen,ClipboardPenLine,ClipboardPenLineIcon:ClipboardPenLine,ClipboardPlus,ClipboardPlusIcon:ClipboardPlus,ClipboardSignature:ClipboardPenLine,ClipboardSignatureIcon:ClipboardPenLine,ClipboardType,ClipboardTypeIcon:ClipboardType,ClipboardX,ClipboardXIcon:ClipboardX,Clock,Clock1,Clock10,Clock10Icon:Clock10,Clock11,Clock11Icon:Clock11,Clock12,Clock12Icon:Clock12,Clock1Icon:Clock1,Clock2,Clock2Icon:Clock2,Clock3,Clock3Icon:Clock3,Clock4,Clock4Icon:Clock4,Clock5,Clock5Icon:Clock5,Clock6,Clock6Icon:Clock6,Clock7,Clock7Icon:Clock7,Clock8,Clock8Icon:Clock8,Clock9,Clock9Icon:Clock9,ClockAlert,ClockAlertIcon:ClockAlert,ClockArrowDown,ClockArrowDownIcon:ClockArrowDown,ClockArrowUp,ClockArrowUpIcon:ClockArrowUp,ClockCheck,ClockCheckIcon:ClockCheck,ClockFading,ClockFadingIcon:ClockFading,ClockIcon:Clock,ClockPlus,ClockPlusIcon:ClockPlus,ClosedCaption,ClosedCaptionIcon:ClosedCaption,Cloud,CloudAlert,CloudAlertIcon:CloudAlert,CloudCheck,CloudCheckIcon:CloudCheck,CloudCog,CloudCogIcon:CloudCog,CloudDownload,CloudDownloadIcon:CloudDownload,CloudDrizzle,CloudDrizzleIcon:CloudDrizzle,CloudFog,CloudFogIcon:CloudFog,CloudHail,CloudHailIcon:CloudHail,CloudIcon:Cloud,CloudLightning,CloudLightningIcon:CloudLightning,CloudMoon,CloudMoonIcon:CloudMoon,CloudMoonRain,CloudMoonRainIcon:CloudMoonRain,CloudOff,CloudOffIcon:CloudOff,CloudRain,CloudRainIcon:CloudRain,CloudRainWind,CloudRainWindIcon:CloudRainWind,CloudSnow,CloudSnowIcon:CloudSnow,CloudSun,CloudSunIcon:CloudSun,CloudSunRain,CloudSunRainIcon:CloudSunRain,CloudUpload,CloudUploadIcon:CloudUpload,Cloudy,CloudyIcon:Cloudy,Clover,CloverIcon:Clover,Club,ClubIcon:Club,Code,Code2:CodeXml,Code2Icon:CodeXml,CodeIcon:Code,CodeSquare:SquareCode,CodeSquareIcon:SquareCode,CodeXml,CodeXmlIcon:CodeXml,Codepen,CodepenIcon:Codepen,Codesandbox,CodesandboxIcon:Codesandbox,Coffee,CoffeeIcon:Coffee,Cog,CogIcon:Cog,Coins,CoinsIcon:Coins,Columns:Columns2,Columns2,Columns2Icon:Columns2,Columns3,Columns3Cog,Columns3CogIcon:Columns3Cog,Columns3Icon:Columns3,Columns4,Columns4Icon:Columns4,ColumnsIcon:Columns2,ColumnsSettings:Columns3Cog,ColumnsSettingsIcon:Columns3Cog,Combine,CombineIcon:Combine,Command,CommandIcon:Command,Compass,CompassIcon:Compass,Component,ComponentIcon:Component,Computer,ComputerIcon:Computer,ConciergeBell,ConciergeBellIcon:ConciergeBell,Cone,ConeIcon:Cone,Construction,ConstructionIcon:Construction,Contact,Contact2:ContactRound,Contact2Icon:ContactRound,ContactIcon:Contact,ContactRound,ContactRoundIcon:ContactRound,Container,ContainerIcon:Container,Contrast,ContrastIcon:Contrast,Cookie,CookieIcon:Cookie,CookingPot,CookingPotIcon:CookingPot,Copy,CopyCheck,CopyCheckIcon:CopyCheck,CopyIcon:Copy,CopyMinus,CopyMinusIcon:CopyMinus,CopyPlus,CopyPlusIcon:CopyPlus,CopySlash,CopySlashIcon:CopySlash,CopyX,CopyXIcon:CopyX,Copyleft,CopyleftIcon:Copyleft,Copyright,CopyrightIcon:Copyright,CornerDownLeft,CornerDownLeftIcon:CornerDownLeft,CornerDownRight,CornerDownRightIcon:CornerDownRight,CornerLeftDown,CornerLeftDownIcon:CornerLeftDown,CornerLeftUp,CornerLeftUpIcon:CornerLeftUp,CornerRightDown,CornerRightDownIcon:CornerRightDown,CornerRightUp,CornerRightUpIcon:CornerRightUp,CornerUpLeft,CornerUpLeftIcon:CornerUpLeft,CornerUpRight,CornerUpRightIcon:CornerUpRight,Cpu,CpuIcon:Cpu,CreativeCommons,CreativeCommonsIcon:CreativeCommons,CreditCard,CreditCardIcon:CreditCard,Croissant,CroissantIcon:Croissant,Crop,CropIcon:Crop,Cross,CrossIcon:Cross,Crosshair,CrosshairIcon:Crosshair,Crown,CrownIcon:Crown,Cuboid,CuboidIcon:Cuboid,CupSoda,CupSodaIcon:CupSoda,CurlyBraces:Braces,CurlyBracesIcon:Braces,Currency,CurrencyIcon:Currency,Cylinder,CylinderIcon:Cylinder,Dam,DamIcon:Dam,Database,DatabaseBackup,DatabaseBackupIcon:DatabaseBackup,DatabaseIcon:Database,DatabaseZap,DatabaseZapIcon:DatabaseZap,DecimalsArrowLeft,DecimalsArrowLeftIcon:DecimalsArrowLeft,DecimalsArrowRight,DecimalsArrowRightIcon:DecimalsArrowRight,Delete,DeleteIcon:Delete,Dessert,DessertIcon:Dessert,Diameter,DiameterIcon:Diameter,Diamond,DiamondIcon:Diamond,DiamondMinus,DiamondMinusIcon:DiamondMinus,DiamondPercent,DiamondPercentIcon:DiamondPercent,DiamondPlus,DiamondPlusIcon:DiamondPlus,Dice1,Dice1Icon:Dice1,Dice2,Dice2Icon:Dice2,Dice3,Dice3Icon:Dice3,Dice4,Dice4Icon:Dice4,Dice5,Dice5Icon:Dice5,Dice6,Dice6Icon:Dice6,Dices,DicesIcon:Dices,Diff,DiffIcon:Diff,Disc,Disc2,Disc2Icon:Disc2,Disc3,Disc3Icon:Disc3,DiscAlbum,DiscAlbumIcon:DiscAlbum,DiscIcon:Disc,Divide,DivideCircle:CircleDivide,DivideCircleIcon:CircleDivide,DivideIcon:Divide,DivideSquare:SquareDivide,DivideSquareIcon:SquareDivide,Dna,DnaIcon:Dna,DnaOff,DnaOffIcon:DnaOff,Dock,DockIcon:Dock,Dog,DogIcon:Dog,DollarSign,DollarSignIcon:DollarSign,Donut,DonutIcon:Donut,DoorClosed,DoorClosedIcon:DoorClosed,DoorClosedLocked,DoorClosedLockedIcon:DoorClosedLocked,DoorOpen,DoorOpenIcon:DoorOpen,Dot,DotIcon:Dot,DotSquare:SquareDot,DotSquareIcon:SquareDot,Download,DownloadCloud:CloudDownload,DownloadCloudIcon:CloudDownload,DownloadIcon:Download,DraftingCompass,DraftingCompassIcon:DraftingCompass,Drama,DramaIcon:Drama,Dribbble,DribbbleIcon:Dribbble,Drill,DrillIcon:Drill,Drone,DroneIcon:Drone,Droplet,DropletIcon:Droplet,DropletOff,DropletOffIcon:DropletOff,Droplets,DropletsIcon:Droplets,Drum,DrumIcon:Drum,Drumstick,DrumstickIcon:Drumstick,Dumbbell,DumbbellIcon:Dumbbell,Ear,EarIcon:Ear,EarOff,EarOffIcon:EarOff,Earth,EarthIcon:Earth,EarthLock,EarthLockIcon:EarthLock,Eclipse,EclipseIcon:Eclipse,Edit:SquarePen,Edit2:Pen,Edit2Icon:Pen,Edit3:PenLine,Edit3Icon:PenLine,EditIcon:SquarePen,Egg,EggFried,EggFriedIcon:EggFried,EggIcon:Egg,EggOff,EggOffIcon:EggOff,Ellipsis,EllipsisIcon:Ellipsis,EllipsisVertical,EllipsisVerticalIcon:EllipsisVertical,Equal,EqualApproximately,EqualApproximatelyIcon:EqualApproximately,EqualIcon:Equal,EqualNot,EqualNotIcon:EqualNot,EqualSquare:SquareEqual,EqualSquareIcon:SquareEqual,Eraser,EraserIcon:Eraser,EthernetPort,EthernetPortIcon:EthernetPort,Euro,EuroIcon:Euro,EvCharger,EvChargerIcon:EvCharger,Expand,ExpandIcon:Expand,ExternalLink,ExternalLinkIcon:ExternalLink,Eye,EyeClosed,EyeClosedIcon:EyeClosed,EyeIcon:Eye,EyeOff,EyeOffIcon:EyeOff,Facebook,FacebookIcon:Facebook,Factory,FactoryIcon:Factory,Fan,FanIcon:Fan,FastForward,FastForwardIcon:FastForward,Feather,FeatherIcon:Feather,Fence,FenceIcon:Fence,FerrisWheel,FerrisWheelIcon:FerrisWheel,Figma,FigmaIcon:Figma,File,FileArchive,FileArchiveIcon:FileArchive,FileAudio:FileHeadphone,FileAudio2:FileHeadphone,FileAudio2Icon:FileHeadphone,FileAudioIcon:FileHeadphone,FileAxis3D:FileAxis3d,FileAxis3DIcon:FileAxis3d,FileAxis3d,FileAxis3dIcon:FileAxis3d,FileBadge,FileBadge2:FileBadge,FileBadge2Icon:FileBadge,FileBadgeIcon:FileBadge,FileBarChart:FileChartColumnIncreasing,FileBarChart2:FileChartColumn,FileBarChart2Icon:FileChartColumn,FileBarChartIcon:FileChartColumnIncreasing,FileBox,FileBoxIcon:FileBox,FileBraces,FileBracesCorner,FileBracesCornerIcon:FileBracesCorner,FileBracesIcon:FileBraces,FileChartColumn,FileChartColumnIcon:FileChartColumn,FileChartColumnIncreasing,FileChartColumnIncreasingIcon:FileChartColumnIncreasing,FileChartLine,FileChartLineIcon:FileChartLine,FileChartPie,FileChartPieIcon:FileChartPie,FileCheck,FileCheck2:FileCheckCorner,FileCheck2Icon:FileCheckCorner,FileCheckCorner,FileCheckCornerIcon:FileCheckCorner,FileCheckIcon:FileCheck,FileClock,FileClockIcon:FileClock,FileCode,FileCode2:FileCodeCorner,FileCode2Icon:FileCodeCorner,FileCodeCorner,FileCodeCornerIcon:FileCodeCorner,FileCodeIcon:FileCode,FileCog,FileCog2:FileCog,FileCog2Icon:FileCog,FileCogIcon:FileCog,FileDiff,FileDiffIcon:FileDiff,FileDigit,FileDigitIcon:FileDigit,FileDown,FileDownIcon:FileDown,FileEdit:FilePen,FileEditIcon:FilePen,FileExclamationPoint,FileExclamationPointIcon:FileExclamationPoint,FileHeadphone,FileHeadphoneIcon:FileHeadphone,FileHeart,FileHeartIcon:FileHeart,FileIcon:File,FileImage,FileImageIcon:FileImage,FileInput,FileInputIcon:FileInput,FileJson:FileBraces,FileJson2:FileBracesCorner,FileJson2Icon:FileBracesCorner,FileJsonIcon:FileBraces,FileKey,FileKey2:FileKey,FileKey2Icon:FileKey,FileKeyIcon:FileKey,FileLineChart:FileChartLine,FileLineChartIcon:FileChartLine,FileLock,FileLock2:FileLock,FileLock2Icon:FileLock,FileLockIcon:FileLock,FileMinus,FileMinus2:FileMinusCorner,FileMinus2Icon:FileMinusCorner,FileMinusCorner,FileMinusCornerIcon:FileMinusCorner,FileMinusIcon:FileMinus,FileMusic,FileMusicIcon:FileMusic,FileOutput,FileOutputIcon:FileOutput,FilePen,FilePenIcon:FilePen,FilePenLine,FilePenLineIcon:FilePenLine,FilePieChart:FileChartPie,FilePieChartIcon:FileChartPie,FilePlay,FilePlayIcon:FilePlay,FilePlus,FilePlus2:FilePlusCorner,FilePlus2Icon:FilePlusCorner,FilePlusCorner,FilePlusCornerIcon:FilePlusCorner,FilePlusIcon:FilePlus,FileQuestion:FileQuestionMark,FileQuestionIcon:FileQuestionMark,FileQuestionMark,FileQuestionMarkIcon:FileQuestionMark,FileScan,FileScanIcon:FileScan,FileSearch,FileSearch2:FileSearchCorner,FileSearch2Icon:FileSearchCorner,FileSearchCorner,FileSearchCornerIcon:FileSearchCorner,FileSearchIcon:FileSearch,FileSignal,FileSignalIcon:FileSignal,FileSignature:FilePenLine,FileSignatureIcon:FilePenLine,FileSliders,FileSlidersIcon:FileSliders,FileSpreadsheet,FileSpreadsheetIcon:FileSpreadsheet,FileStack,FileStackIcon:FileStack,FileSymlink,FileSymlinkIcon:FileSymlink,FileTerminal,FileTerminalIcon:FileTerminal,FileText,FileTextIcon:FileText,FileType,FileType2:FileTypeCorner,FileType2Icon:FileTypeCorner,FileTypeCorner,FileTypeCornerIcon:FileTypeCorner,FileTypeIcon:FileType,FileUp,FileUpIcon:FileUp,FileUser,FileUserIcon:FileUser,FileVideo:FilePlay,FileVideo2:FileVideoCamera,FileVideo2Icon:FileVideoCamera,FileVideoCamera,FileVideoCameraIcon:FileVideoCamera,FileVideoIcon:FilePlay,FileVolume,FileVolume2:FileSignal,FileVolume2Icon:FileSignal,FileVolumeIcon:FileVolume,FileWarning:FileExclamationPoint,FileWarningIcon:FileExclamationPoint,FileX,FileX2:FileXCorner,FileX2Icon:FileXCorner,FileXCorner,FileXCornerIcon:FileXCorner,FileXIcon:FileX,Files,FilesIcon:Files,Film,FilmIcon:Film,Filter:Funnel,FilterIcon:Funnel,FilterX:FunnelX,FilterXIcon:FunnelX,Fingerprint:FingerprintPattern,FingerprintIcon:FingerprintPattern,FingerprintPattern,FingerprintPatternIcon:FingerprintPattern,FireExtinguisher,FireExtinguisherIcon:FireExtinguisher,Fish,FishIcon:Fish,FishOff,FishOffIcon:FishOff,FishSymbol,FishSymbolIcon:FishSymbol,Flag,FlagIcon:Flag,FlagOff,FlagOffIcon:FlagOff,FlagTriangleLeft,FlagTriangleLeftIcon:FlagTriangleLeft,FlagTriangleRight,FlagTriangleRightIcon:FlagTriangleRight,Flame,FlameIcon:Flame,FlameKindling,FlameKindlingIcon:FlameKindling,Flashlight,FlashlightIcon:Flashlight,FlashlightOff,FlashlightOffIcon:FlashlightOff,FlaskConical,FlaskConicalIcon:FlaskConical,FlaskConicalOff,FlaskConicalOffIcon:FlaskConicalOff,FlaskRound,FlaskRoundIcon:FlaskRound,FlipHorizontal,FlipHorizontal2,FlipHorizontal2Icon:FlipHorizontal2,FlipHorizontalIcon:FlipHorizontal,FlipVertical,FlipVertical2,FlipVertical2Icon:FlipVertical2,FlipVerticalIcon:FlipVertical,Flower,Flower2,Flower2Icon:Flower2,FlowerIcon:Flower,Focus,FocusIcon:Focus,FoldHorizontal,FoldHorizontalIcon:FoldHorizontal,FoldVertical,FoldVerticalIcon:FoldVertical,Folder,FolderArchive,FolderArchiveIcon:FolderArchive,FolderCheck,FolderCheckIcon:FolderCheck,FolderClock,FolderClockIcon:FolderClock,FolderClosed,FolderClosedIcon:FolderClosed,FolderCode,FolderCodeIcon:FolderCode,FolderCog,FolderCog2:FolderCog,FolderCog2Icon:FolderCog,FolderCogIcon:FolderCog,FolderDot,FolderDotIcon:FolderDot,FolderDown,FolderDownIcon:FolderDown,FolderEdit:FolderPen,FolderEditIcon:FolderPen,FolderGit,FolderGit2,FolderGit2Icon:FolderGit2,FolderGitIcon:FolderGit,FolderHeart,FolderHeartIcon:FolderHeart,FolderIcon:Folder,FolderInput,FolderInputIcon:FolderInput,FolderKanban,FolderKanbanIcon:FolderKanban,FolderKey,FolderKeyIcon:FolderKey,FolderLock,FolderLockIcon:FolderLock,FolderMinus,FolderMinusIcon:FolderMinus,FolderOpen,FolderOpenDot,FolderOpenDotIcon:FolderOpenDot,FolderOpenIcon:FolderOpen,FolderOutput,FolderOutputIcon:FolderOutput,FolderPen,FolderPenIcon:FolderPen,FolderPlus,FolderPlusIcon:FolderPlus,FolderRoot,FolderRootIcon:FolderRoot,FolderSearch,FolderSearch2,FolderSearch2Icon:FolderSearch2,FolderSearchIcon:FolderSearch,FolderSymlink,FolderSymlinkIcon:FolderSymlink,FolderSync,FolderSyncIcon:FolderSync,FolderTree,FolderTreeIcon:FolderTree,FolderUp,FolderUpIcon:FolderUp,FolderX,FolderXIcon:FolderX,Folders,FoldersIcon:Folders,Footprints,FootprintsIcon:Footprints,ForkKnife:Utensils,ForkKnifeCrossed:UtensilsCrossed,ForkKnifeCrossedIcon:UtensilsCrossed,ForkKnifeIcon:Utensils,Forklift,ForkliftIcon:Forklift,FormInput:RectangleEllipsis,FormInputIcon:RectangleEllipsis,Forward,ForwardIcon:Forward,Frame,FrameIcon:Frame,Framer,FramerIcon:Framer,Frown,FrownIcon:Frown,Fuel,FuelIcon:Fuel,Fullscreen,FullscreenIcon:Fullscreen,FunctionSquare:SquareFunction,FunctionSquareIcon:SquareFunction,Funnel,FunnelIcon:Funnel,FunnelPlus,FunnelPlusIcon:FunnelPlus,FunnelX,FunnelXIcon:FunnelX,GalleryHorizontal,GalleryHorizontalEnd,GalleryHorizontalEndIcon:GalleryHorizontalEnd,GalleryHorizontalIcon:GalleryHorizontal,GalleryThumbnails,GalleryThumbnailsIcon:GalleryThumbnails,GalleryVertical,GalleryVerticalEnd,GalleryVerticalEndIcon:GalleryVerticalEnd,GalleryVerticalIcon:GalleryVertical,Gamepad,Gamepad2,Gamepad2Icon:Gamepad2,GamepadDirectional,GamepadDirectionalIcon:GamepadDirectional,GamepadIcon:Gamepad,GanttChart:ChartNoAxesGantt,GanttChartIcon:ChartNoAxesGantt,GanttChartSquare:SquareChartGantt,GanttChartSquareIcon:SquareChartGantt,Gauge,GaugeCircle:CircleGauge,GaugeCircleIcon:CircleGauge,GaugeIcon:Gauge,Gavel,GavelIcon:Gavel,Gem,GemIcon:Gem,GeorgianLari,GeorgianLariIcon:GeorgianLari,Ghost,GhostIcon:Ghost,Gift,GiftIcon:Gift,GitBranch,GitBranchIcon:GitBranch,GitBranchMinus,GitBranchMinusIcon:GitBranchMinus,GitBranchPlus,GitBranchPlusIcon:GitBranchPlus,GitCommit:GitCommitHorizontal,GitCommitHorizontal,GitCommitHorizontalIcon:GitCommitHorizontal,GitCommitIcon:GitCommitHorizontal,GitCommitVertical,GitCommitVerticalIcon:GitCommitVertical,GitCompare,GitCompareArrows,GitCompareArrowsIcon:GitCompareArrows,GitCompareIcon:GitCompare,GitFork,GitForkIcon:GitFork,GitGraph,GitGraphIcon:GitGraph,GitMerge,GitMergeIcon:GitMerge,GitPullRequest,GitPullRequestArrow,GitPullRequestArrowIcon:GitPullRequestArrow,GitPullRequestClosed,GitPullRequestClosedIcon:GitPullRequestClosed,GitPullRequestCreate,GitPullRequestCreateArrow,GitPullRequestCreateArrowIcon:GitPullRequestCreateArrow,GitPullRequestCreateIcon:GitPullRequestCreate,GitPullRequestDraft,GitPullRequestDraftIcon:GitPullRequestDraft,GitPullRequestIcon:GitPullRequest,Github,GithubIcon:Github,Gitlab,GitlabIcon:Gitlab,GlassWater,GlassWaterIcon:GlassWater,Glasses,GlassesIcon:Glasses,Globe,Globe2:Earth,Globe2Icon:Earth,GlobeIcon:Globe,GlobeLock,GlobeLockIcon:GlobeLock,Goal,GoalIcon:Goal,Gpu,GpuIcon:Gpu,Grab:HandGrab,GrabIcon:HandGrab,GraduationCap,GraduationCapIcon:GraduationCap,Grape,GrapeIcon:Grape,Grid:Grid3x3,Grid2X2:Grid2x2,Grid2X2Check:Grid2x2Check,Grid2X2CheckIcon:Grid2x2Check,Grid2X2Icon:Grid2x2,Grid2X2Plus:Grid2x2Plus,Grid2X2PlusIcon:Grid2x2Plus,Grid2X2X:Grid2x2X,Grid2X2XIcon:Grid2x2X,Grid2x2,Grid2x2Check,Grid2x2CheckIcon:Grid2x2Check,Grid2x2Icon:Grid2x2,Grid2x2Plus,Grid2x2PlusIcon:Grid2x2Plus,Grid2x2X,Grid2x2XIcon:Grid2x2X,Grid3X3:Grid3x3,Grid3X3Icon:Grid3x3,Grid3x2,Grid3x2Icon:Grid3x2,Grid3x3,Grid3x3Icon:Grid3x3,GridIcon:Grid3x3,Grip,GripHorizontal,GripHorizontalIcon:GripHorizontal,GripIcon:Grip,GripVertical,GripVerticalIcon:GripVertical,Group,GroupIcon:Group,Guitar,GuitarIcon:Guitar,Ham,HamIcon:Ham,Hamburger,HamburgerIcon:Hamburger,Hammer,HammerIcon:Hammer,Hand,HandCoins,HandCoinsIcon:HandCoins,HandFist,HandFistIcon:HandFist,HandGrab,HandGrabIcon:HandGrab,HandHeart,HandHeartIcon:HandHeart,HandHelping,HandHelpingIcon:HandHelping,HandIcon:Hand,HandMetal,HandMetalIcon:HandMetal,HandPlatter,HandPlatterIcon:HandPlatter,Handbag,HandbagIcon:Handbag,Handshake,HandshakeIcon:Handshake,HardDrive,HardDriveDownload,HardDriveDownloadIcon:HardDriveDownload,HardDriveIcon:HardDrive,HardDriveUpload,HardDriveUploadIcon:HardDriveUpload,HardHat,HardHatIcon:HardHat,Hash:Hash$1,HashIcon:Hash$1,HatGlasses,HatGlassesIcon:HatGlasses,Haze,HazeIcon:Haze,HdmiPort,HdmiPortIcon:HdmiPort,Heading:Heading$1,Heading1,Heading1Icon:Heading1,Heading2,Heading2Icon:Heading2,Heading3,Heading3Icon:Heading3,Heading4,Heading4Icon:Heading4,Heading5,Heading5Icon:Heading5,Heading6,Heading6Icon:Heading6,HeadingIcon:Heading$1,HeadphoneOff,HeadphoneOffIcon:HeadphoneOff,Headphones,HeadphonesIcon:Headphones,Headset,HeadsetIcon:Headset,Heart,HeartCrack,HeartCrackIcon:HeartCrack,HeartHandshake,HeartHandshakeIcon:HeartHandshake,HeartIcon:Heart,HeartMinus,HeartMinusIcon:HeartMinus,HeartOff,HeartOffIcon:HeartOff,HeartPlus,HeartPlusIcon:HeartPlus,HeartPulse,HeartPulseIcon:HeartPulse,Heater,HeaterIcon:Heater,Helicopter,HelicopterIcon:Helicopter,HelpCircle:CircleQuestionMark,HelpCircleIcon:CircleQuestionMark,HelpingHand:HandHelping,HelpingHandIcon:HandHelping,Hexagon,HexagonIcon:Hexagon,Highlighter,HighlighterIcon:Highlighter,History,HistoryIcon:History,Home:House,HomeIcon:House,Hop,HopIcon:Hop,HopOff,HopOffIcon:HopOff,Hospital,HospitalIcon:Hospital,Hotel,HotelIcon:Hotel,Hourglass,HourglassIcon:Hourglass,House,HouseHeart,HouseHeartIcon:HouseHeart,HouseIcon:House,HousePlug,HousePlugIcon:HousePlug,HousePlus,HousePlusIcon:HousePlus,HouseWifi,HouseWifiIcon:HouseWifi,IceCream:IceCreamCone,IceCream2:IceCreamBowl,IceCream2Icon:IceCreamBowl,IceCreamBowl,IceCreamBowlIcon:IceCreamBowl,IceCreamCone,IceCreamConeIcon:IceCreamCone,IceCreamIcon:IceCreamCone,Icon,IdCard,IdCardIcon:IdCard,IdCardLanyard,IdCardLanyardIcon:IdCardLanyard,Image:Image$1,ImageDown,ImageDownIcon:ImageDown,ImageIcon:Image$1,ImageMinus,ImageMinusIcon:ImageMinus,ImageOff,ImageOffIcon:ImageOff,ImagePlay,ImagePlayIcon:ImagePlay,ImagePlus,ImagePlusIcon:ImagePlus,ImageUp,ImageUpIcon:ImageUp,ImageUpscale,ImageUpscaleIcon:ImageUpscale,Images,ImagesIcon:Images,Import,ImportIcon:Import,Inbox,InboxIcon:Inbox,Indent:ListIndentIncrease,IndentDecrease:ListIndentDecrease,IndentDecreaseIcon:ListIndentDecrease,IndentIcon:ListIndentIncrease,IndentIncrease:ListIndentIncrease,IndentIncreaseIcon:ListIndentIncrease,IndianRupee,IndianRupeeIcon:IndianRupee,Infinity:Infinity$1,InfinityIcon:Infinity$1,Info,InfoIcon:Info,Inspect:SquareMousePointer,InspectIcon:SquareMousePointer,InspectionPanel,InspectionPanelIcon:InspectionPanel,Instagram,InstagramIcon:Instagram,Italic,ItalicIcon:Italic,IterationCcw,IterationCcwIcon:IterationCcw,IterationCw,IterationCwIcon:IterationCw,JapaneseYen,JapaneseYenIcon:JapaneseYen,Joystick,JoystickIcon:Joystick,Kanban,KanbanIcon:Kanban,KanbanSquare:SquareKanban,KanbanSquareDashed:SquareDashedKanban,KanbanSquareDashedIcon:SquareDashedKanban,KanbanSquareIcon:SquareKanban,Kayak,KayakIcon:Kayak,Key,KeyIcon:Key,KeyRound,KeyRoundIcon:KeyRound,KeySquare,KeySquareIcon:KeySquare,Keyboard,KeyboardIcon:Keyboard,KeyboardMusic,KeyboardMusicIcon:KeyboardMusic,KeyboardOff,KeyboardOffIcon:KeyboardOff,Lamp,LampCeiling,LampCeilingIcon:LampCeiling,LampDesk,LampDeskIcon:LampDesk,LampFloor,LampFloorIcon:LampFloor,LampIcon:Lamp,LampWallDown,LampWallDownIcon:LampWallDown,LampWallUp,LampWallUpIcon:LampWallUp,LandPlot,LandPlotIcon:LandPlot,Landmark,LandmarkIcon:Landmark,Languages,LanguagesIcon:Languages,Laptop,Laptop2:LaptopMinimal,Laptop2Icon:LaptopMinimal,LaptopIcon:Laptop,LaptopMinimal,LaptopMinimalCheck,LaptopMinimalCheckIcon:LaptopMinimalCheck,LaptopMinimalIcon:LaptopMinimal,Lasso,LassoIcon:Lasso,LassoSelect,LassoSelectIcon:LassoSelect,Laugh,LaughIcon:Laugh,Layers,Layers2,Layers2Icon:Layers2,Layers3:Layers,Layers3Icon:Layers,LayersIcon:Layers,Layout:PanelsTopLeft,LayoutDashboard,LayoutDashboardIcon:LayoutDashboard,LayoutGrid,LayoutGridIcon:LayoutGrid,LayoutIcon:PanelsTopLeft,LayoutList,LayoutListIcon:LayoutList,LayoutPanelLeft,LayoutPanelLeftIcon:LayoutPanelLeft,LayoutPanelTop,LayoutPanelTopIcon:LayoutPanelTop,LayoutTemplate,LayoutTemplateIcon:LayoutTemplate,Leaf,LeafIcon:Leaf,LeafyGreen,LeafyGreenIcon:LeafyGreen,Lectern,LecternIcon:Lectern,LetterText:TextInitial,LetterTextIcon:TextInitial,Library,LibraryBig,LibraryBigIcon:LibraryBig,LibraryIcon:Library,LibrarySquare:SquareLibrary,LibrarySquareIcon:SquareLibrary,LifeBuoy,LifeBuoyIcon:LifeBuoy,Ligature,LigatureIcon:Ligature,Lightbulb,LightbulbIcon:Lightbulb,LightbulbOff,LightbulbOffIcon:LightbulbOff,LineChart:ChartLine,LineChartIcon:ChartLine,LineSquiggle,LineSquiggleIcon:LineSquiggle,Link,Link2,Link2Icon:Link2,Link2Off,Link2OffIcon:Link2Off,LinkIcon:Link,Linkedin,LinkedinIcon:Linkedin,List,ListCheck,ListCheckIcon:ListCheck,ListChecks,ListChecksIcon:ListChecks,ListChevronsDownUp,ListChevronsDownUpIcon:ListChevronsDownUp,ListChevronsUpDown,ListChevronsUpDownIcon:ListChevronsUpDown,ListCollapse,ListCollapseIcon:ListCollapse,ListEnd,ListEndIcon:ListEnd,ListFilter,ListFilterIcon:ListFilter,ListFilterPlus,ListFilterPlusIcon:ListFilterPlus,ListIcon:List,ListIndentDecrease,ListIndentDecreaseIcon:ListIndentDecrease,ListIndentIncrease,ListIndentIncreaseIcon:ListIndentIncrease,ListMinus,ListMinusIcon:ListMinus,ListMusic,ListMusicIcon:ListMusic,ListOrdered,ListOrderedIcon:ListOrdered,ListPlus,ListPlusIcon:ListPlus,ListRestart,ListRestartIcon:ListRestart,ListStart,ListStartIcon:ListStart,ListTodo,ListTodoIcon:ListTodo,ListTree,ListTreeIcon:ListTree,ListVideo,ListVideoIcon:ListVideo,ListX,ListXIcon:ListX,Loader,Loader2:LoaderCircle,Loader2Icon:LoaderCircle,LoaderCircle,LoaderCircleIcon:LoaderCircle,LoaderIcon:Loader,LoaderPinwheel,LoaderPinwheelIcon:LoaderPinwheel,Locate,LocateFixed,LocateFixedIcon:LocateFixed,LocateIcon:Locate,LocateOff,LocateOffIcon:LocateOff,LocationEdit:MapPinPen,LocationEditIcon:MapPinPen,Lock,LockIcon:Lock,LockKeyhole,LockKeyholeIcon:LockKeyhole,LockKeyholeOpen,LockKeyholeOpenIcon:LockKeyholeOpen,LockOpen,LockOpenIcon:LockOpen,LogIn,LogInIcon:LogIn,LogOut,LogOutIcon:LogOut,Logs,LogsIcon:Logs,Lollipop,LollipopIcon:Lollipop,LucideAArrowDown:AArrowDown,LucideAArrowUp:AArrowUp,LucideALargeSmall:ALargeSmall,LucideAccessibility:Accessibility,LucideActivity:Activity,LucideActivitySquare:SquareActivity,LucideAirVent:AirVent,LucideAirplay:Airplay,LucideAlarmCheck:AlarmClockCheck,LucideAlarmClock:AlarmClock,LucideAlarmClockCheck:AlarmClockCheck,LucideAlarmClockMinus:AlarmClockMinus,LucideAlarmClockOff:AlarmClockOff,LucideAlarmClockPlus:AlarmClockPlus,LucideAlarmMinus:AlarmClockMinus,LucideAlarmPlus:AlarmClockPlus,LucideAlarmSmoke:AlarmSmoke,LucideAlbum:Album,LucideAlertCircle:CircleAlert,LucideAlertOctagon:OctagonAlert,LucideAlertTriangle:TriangleAlert,LucideAlignCenter:TextAlignCenter,LucideAlignCenterHorizontal:AlignCenterHorizontal,LucideAlignCenterVertical:AlignCenterVertical,LucideAlignEndHorizontal:AlignEndHorizontal,LucideAlignEndVertical:AlignEndVertical,LucideAlignHorizontalDistributeCenter:AlignHorizontalDistributeCenter,LucideAlignHorizontalDistributeEnd:AlignHorizontalDistributeEnd,LucideAlignHorizontalDistributeStart:AlignHorizontalDistributeStart,LucideAlignHorizontalJustifyCenter:AlignHorizontalJustifyCenter,LucideAlignHorizontalJustifyEnd:AlignHorizontalJustifyEnd,LucideAlignHorizontalJustifyStart:AlignHorizontalJustifyStart,LucideAlignHorizontalSpaceAround:AlignHorizontalSpaceAround,LucideAlignHorizontalSpaceBetween:AlignHorizontalSpaceBetween,LucideAlignJustify:TextAlignJustify,LucideAlignLeft:TextAlignStart,LucideAlignRight:TextAlignEnd,LucideAlignStartHorizontal:AlignStartHorizontal,LucideAlignStartVertical:AlignStartVertical,LucideAlignVerticalDistributeCenter:AlignVerticalDistributeCenter,LucideAlignVerticalDistributeEnd:AlignVerticalDistributeEnd,LucideAlignVerticalDistributeStart:AlignVerticalDistributeStart,LucideAlignVerticalJustifyCenter:AlignVerticalJustifyCenter,LucideAlignVerticalJustifyEnd:AlignVerticalJustifyEnd,LucideAlignVerticalJustifyStart:AlignVerticalJustifyStart,LucideAlignVerticalSpaceAround:AlignVerticalSpaceAround,LucideAlignVerticalSpaceBetween:AlignVerticalSpaceBetween,LucideAmbulance:Ambulance,LucideAmpersand:Ampersand,LucideAmpersands:Ampersands,LucideAmphora:Amphora,LucideAnchor:Anchor,LucideAngry:Angry,LucideAnnoyed:Annoyed,LucideAntenna:Antenna,LucideAnvil:Anvil,LucideAperture:Aperture,LucideAppWindow:AppWindow,LucideAppWindowMac:AppWindowMac,LucideApple:Apple,LucideArchive:Archive,LucideArchiveRestore:ArchiveRestore,LucideArchiveX:ArchiveX,LucideAreaChart:ChartArea,LucideArmchair:Armchair,LucideArrowBigDown:ArrowBigDown,LucideArrowBigDownDash:ArrowBigDownDash,LucideArrowBigLeft:ArrowBigLeft,LucideArrowBigLeftDash:ArrowBigLeftDash,LucideArrowBigRight:ArrowBigRight,LucideArrowBigRightDash:ArrowBigRightDash,LucideArrowBigUp:ArrowBigUp,LucideArrowBigUpDash:ArrowBigUpDash,LucideArrowDown:ArrowDown,LucideArrowDown01:ArrowDown01,LucideArrowDown10:ArrowDown10,LucideArrowDownAZ:ArrowDownAZ,LucideArrowDownAz:ArrowDownAZ,LucideArrowDownCircle:CircleArrowDown,LucideArrowDownFromLine:ArrowDownFromLine,LucideArrowDownLeft:ArrowDownLeft,LucideArrowDownLeftFromCircle:CircleArrowOutDownLeft,LucideArrowDownLeftFromSquare:SquareArrowOutDownLeft,LucideArrowDownLeftSquare:SquareArrowDownLeft,LucideArrowDownNarrowWide:ArrowDownNarrowWide,LucideArrowDownRight:ArrowDownRight,LucideArrowDownRightFromCircle:CircleArrowOutDownRight,LucideArrowDownRightFromSquare:SquareArrowOutDownRight,LucideArrowDownRightSquare:SquareArrowDownRight,LucideArrowDownSquare:SquareArrowDown,LucideArrowDownToDot:ArrowDownToDot,LucideArrowDownToLine:ArrowDownToLine,LucideArrowDownUp:ArrowDownUp,LucideArrowDownWideNarrow:ArrowDownWideNarrow,LucideArrowDownZA:ArrowDownZA,LucideArrowDownZa:ArrowDownZA,LucideArrowLeft:ArrowLeft,LucideArrowLeftCircle:CircleArrowLeft,LucideArrowLeftFromLine:ArrowLeftFromLine,LucideArrowLeftRight:ArrowLeftRight,LucideArrowLeftSquare:SquareArrowLeft,LucideArrowLeftToLine:ArrowLeftToLine,LucideArrowRight:ArrowRight,LucideArrowRightCircle:CircleArrowRight,LucideArrowRightFromLine:ArrowRightFromLine,LucideArrowRightLeft:ArrowRightLeft,LucideArrowRightSquare:SquareArrowRight,LucideArrowRightToLine:ArrowRightToLine,LucideArrowUp:ArrowUp,LucideArrowUp01:ArrowUp01,LucideArrowUp10:ArrowUp10,LucideArrowUpAZ:ArrowUpAZ,LucideArrowUpAz:ArrowUpAZ,LucideArrowUpCircle:CircleArrowUp,LucideArrowUpDown:ArrowUpDown,LucideArrowUpFromDot:ArrowUpFromDot,LucideArrowUpFromLine:ArrowUpFromLine,LucideArrowUpLeft:ArrowUpLeft,LucideArrowUpLeftFromCircle:CircleArrowOutUpLeft,LucideArrowUpLeftFromSquare:SquareArrowOutUpLeft,LucideArrowUpLeftSquare:SquareArrowUpLeft,LucideArrowUpNarrowWide:ArrowUpNarrowWide,LucideArrowUpRight:ArrowUpRight,LucideArrowUpRightFromCircle:CircleArrowOutUpRight,LucideArrowUpRightFromSquare:SquareArrowOutUpRight,LucideArrowUpRightSquare:SquareArrowUpRight,LucideArrowUpSquare:SquareArrowUp,LucideArrowUpToLine:ArrowUpToLine,LucideArrowUpWideNarrow:ArrowUpWideNarrow,LucideArrowUpZA:ArrowUpZA,LucideArrowUpZa:ArrowUpZA,LucideArrowsUpFromLine:ArrowsUpFromLine,LucideAsterisk:Asterisk,LucideAsteriskSquare:SquareAsterisk,LucideAtSign:AtSign,LucideAtom:Atom,LucideAudioLines:AudioLines,LucideAudioWaveform:AudioWaveform,LucideAward:Award,LucideAxe:Axe,LucideAxis3D:Axis3d,LucideAxis3d:Axis3d,LucideBaby:Baby,LucideBackpack:Backpack,LucideBadge:Badge,LucideBadgeAlert:BadgeAlert,LucideBadgeCent:BadgeCent,LucideBadgeCheck:BadgeCheck,LucideBadgeDollarSign:BadgeDollarSign,LucideBadgeEuro:BadgeEuro,LucideBadgeHelp:BadgeQuestionMark,LucideBadgeIndianRupee:BadgeIndianRupee,LucideBadgeInfo:BadgeInfo,LucideBadgeJapaneseYen:BadgeJapaneseYen,LucideBadgeMinus:BadgeMinus,LucideBadgePercent:BadgePercent,LucideBadgePlus:BadgePlus,LucideBadgePoundSterling:BadgePoundSterling,LucideBadgeQuestionMark:BadgeQuestionMark,LucideBadgeRussianRuble:BadgeRussianRuble,LucideBadgeSwissFranc:BadgeSwissFranc,LucideBadgeTurkishLira:BadgeTurkishLira,LucideBadgeX:BadgeX,LucideBaggageClaim:BaggageClaim,LucideBan:Ban,LucideBanana:Banana,LucideBandage:Bandage,LucideBanknote:Banknote,LucideBanknoteArrowDown:BanknoteArrowDown,LucideBanknoteArrowUp:BanknoteArrowUp,LucideBanknoteX:BanknoteX,LucideBarChart:ChartNoAxesColumnIncreasing,LucideBarChart2:ChartNoAxesColumn,LucideBarChart3:ChartColumn,LucideBarChart4:ChartColumnIncreasing,LucideBarChartBig:ChartColumnBig,LucideBarChartHorizontal:ChartBar,LucideBarChartHorizontalBig:ChartBarBig,LucideBarcode:Barcode,LucideBarrel:Barrel,LucideBaseline:Baseline,LucideBath:Bath,LucideBattery:Battery,LucideBatteryCharging:BatteryCharging,LucideBatteryFull:BatteryFull,LucideBatteryLow:BatteryLow,LucideBatteryMedium:BatteryMedium,LucideBatteryPlus:BatteryPlus,LucideBatteryWarning:BatteryWarning,LucideBeaker:Beaker,LucideBean:Bean,LucideBeanOff:BeanOff,LucideBed:Bed,LucideBedDouble:BedDouble,LucideBedSingle:BedSingle,LucideBeef:Beef,LucideBeer:Beer,LucideBeerOff:BeerOff,LucideBell:Bell,LucideBellDot:BellDot,LucideBellElectric:BellElectric,LucideBellMinus:BellMinus,LucideBellOff:BellOff,LucideBellPlus:BellPlus,LucideBellRing:BellRing,LucideBetweenHorizonalEnd:BetweenHorizontalEnd,LucideBetweenHorizonalStart:BetweenHorizontalStart,LucideBetweenHorizontalEnd:BetweenHorizontalEnd,LucideBetweenHorizontalStart:BetweenHorizontalStart,LucideBetweenVerticalEnd:BetweenVerticalEnd,LucideBetweenVerticalStart:BetweenVerticalStart,LucideBicepsFlexed:BicepsFlexed,LucideBike:Bike,LucideBinary:Binary,LucideBinoculars:Binoculars,LucideBiohazard:Biohazard,LucideBird:Bird,LucideBirdhouse:Birdhouse,LucideBitcoin:Bitcoin,LucideBlend:Blend,LucideBlinds:Blinds,LucideBlocks:Blocks,LucideBluetooth:Bluetooth,LucideBluetoothConnected:BluetoothConnected,LucideBluetoothOff:BluetoothOff,LucideBluetoothSearching:BluetoothSearching,LucideBold:Bold,LucideBolt:Bolt,LucideBomb:Bomb,LucideBone:Bone,LucideBook:Book,LucideBookA:BookA,LucideBookAlert:BookAlert,LucideBookAudio:BookAudio,LucideBookCheck:BookCheck,LucideBookCopy:BookCopy,LucideBookDashed:BookDashed,LucideBookDown:BookDown,LucideBookHeadphones:BookHeadphones,LucideBookHeart:BookHeart,LucideBookImage:BookImage,LucideBookKey:BookKey,LucideBookLock:BookLock,LucideBookMarked:BookMarked,LucideBookMinus:BookMinus,LucideBookOpen:BookOpen,LucideBookOpenCheck:BookOpenCheck,LucideBookOpenText:BookOpenText,LucideBookPlus:BookPlus,LucideBookTemplate:BookDashed,LucideBookText:BookText,LucideBookType:BookType,LucideBookUp:BookUp,LucideBookUp2:BookUp2,LucideBookUser:BookUser,LucideBookX:BookX,LucideBookmark:Bookmark,LucideBookmarkCheck:BookmarkCheck,LucideBookmarkMinus:BookmarkMinus,LucideBookmarkPlus:BookmarkPlus,LucideBookmarkX:BookmarkX,LucideBoomBox:BoomBox,LucideBot:Bot,LucideBotMessageSquare:BotMessageSquare,LucideBotOff:BotOff,LucideBottleWine:BottleWine,LucideBowArrow:BowArrow,LucideBox:Box,LucideBoxSelect:SquareDashed,LucideBoxes:Boxes,LucideBraces:Braces,LucideBrackets:Brackets,LucideBrain:Brain,LucideBrainCircuit:BrainCircuit,LucideBrainCog:BrainCog,LucideBrickWall:BrickWall,LucideBrickWallFire:BrickWallFire,LucideBrickWallShield:BrickWallShield,LucideBriefcase:Briefcase,LucideBriefcaseBusiness:BriefcaseBusiness,LucideBriefcaseConveyorBelt:BriefcaseConveyorBelt,LucideBriefcaseMedical:BriefcaseMedical,LucideBringToFront:BringToFront,LucideBrush:Brush,LucideBrushCleaning:BrushCleaning,LucideBubbles:Bubbles,LucideBug:Bug,LucideBugOff:BugOff,LucideBugPlay:BugPlay,LucideBuilding:Building,LucideBuilding2:Building2,LucideBus:Bus,LucideBusFront:BusFront,LucideCable:Cable,LucideCableCar:CableCar,LucideCake:Cake,LucideCakeSlice:CakeSlice,LucideCalculator:Calculator,LucideCalendar:Calendar,LucideCalendar1:Calendar1,LucideCalendarArrowDown:CalendarArrowDown,LucideCalendarArrowUp:CalendarArrowUp,LucideCalendarCheck:CalendarCheck,LucideCalendarCheck2:CalendarCheck2,LucideCalendarClock:CalendarClock,LucideCalendarCog:CalendarCog,LucideCalendarDays:CalendarDays,LucideCalendarFold:CalendarFold,LucideCalendarHeart:CalendarHeart,LucideCalendarMinus:CalendarMinus,LucideCalendarMinus2:CalendarMinus2,LucideCalendarOff:CalendarOff,LucideCalendarPlus:CalendarPlus,LucideCalendarPlus2:CalendarPlus2,LucideCalendarRange:CalendarRange,LucideCalendarSearch:CalendarSearch,LucideCalendarSync:CalendarSync,LucideCalendarX:CalendarX,LucideCalendarX2:CalendarX2,LucideCalendars:Calendars,LucideCamera:Camera,LucideCameraOff:CameraOff,LucideCandlestickChart:ChartCandlestick,LucideCandy:Candy,LucideCandyCane:CandyCane,LucideCandyOff:CandyOff,LucideCannabis:Cannabis,LucideCaptions:Captions,LucideCaptionsOff:CaptionsOff,LucideCar:Car,LucideCarFront:CarFront,LucideCarTaxiFront:CarTaxiFront,LucideCaravan:Caravan,LucideCardSim:CardSim,LucideCarrot:Carrot,LucideCaseLower:CaseLower,LucideCaseSensitive:CaseSensitive,LucideCaseUpper:CaseUpper,LucideCassetteTape:CassetteTape,LucideCast:Cast,LucideCastle:Castle,LucideCat:Cat,LucideCctv:Cctv,LucideChartArea:ChartArea,LucideChartBar:ChartBar,LucideChartBarBig:ChartBarBig,LucideChartBarDecreasing:ChartBarDecreasing,LucideChartBarIncreasing:ChartBarIncreasing,LucideChartBarStacked:ChartBarStacked,LucideChartCandlestick:ChartCandlestick,LucideChartColumn:ChartColumn,LucideChartColumnBig:ChartColumnBig,LucideChartColumnDecreasing:ChartColumnDecreasing,LucideChartColumnIncreasing:ChartColumnIncreasing,LucideChartColumnStacked:ChartColumnStacked,LucideChartGantt:ChartGantt,LucideChartLine:ChartLine,LucideChartNetwork:ChartNetwork,LucideChartNoAxesColumn:ChartNoAxesColumn,LucideChartNoAxesColumnDecreasing:ChartNoAxesColumnDecreasing,LucideChartNoAxesColumnIncreasing:ChartNoAxesColumnIncreasing,LucideChartNoAxesCombined:ChartNoAxesCombined,LucideChartNoAxesGantt:ChartNoAxesGantt,LucideChartPie:ChartPie,LucideChartScatter:ChartScatter,LucideChartSpline:ChartSpline,LucideCheck:Check,LucideCheckCheck:CheckCheck,LucideCheckCircle:CircleCheckBig,LucideCheckCircle2:CircleCheck,LucideCheckLine:CheckLine,LucideCheckSquare:SquareCheckBig,LucideCheckSquare2:SquareCheck,LucideChefHat:ChefHat,LucideCherry:Cherry,LucideChessBishop:ChessBishop,LucideChessKing:ChessKing,LucideChessKnight:ChessKnight,LucideChessPawn:ChessPawn,LucideChessQueen:ChessQueen,LucideChessRook:ChessRook,LucideChevronDown:ChevronDown,LucideChevronDownCircle:CircleChevronDown,LucideChevronDownSquare:SquareChevronDown,LucideChevronFirst:ChevronFirst,LucideChevronLast:ChevronLast,LucideChevronLeft:ChevronLeft,LucideChevronLeftCircle:CircleChevronLeft,LucideChevronLeftSquare:SquareChevronLeft,LucideChevronRight:ChevronRight,LucideChevronRightCircle:CircleChevronRight,LucideChevronRightSquare:SquareChevronRight,LucideChevronUp:ChevronUp,LucideChevronUpCircle:CircleChevronUp,LucideChevronUpSquare:SquareChevronUp,LucideChevronsDown:ChevronsDown,LucideChevronsDownUp:ChevronsDownUp,LucideChevronsLeft:ChevronsLeft,LucideChevronsLeftRight:ChevronsLeftRight,LucideChevronsLeftRightEllipsis:ChevronsLeftRightEllipsis,LucideChevronsRight:ChevronsRight,LucideChevronsRightLeft:ChevronsRightLeft,LucideChevronsUp:ChevronsUp,LucideChevronsUpDown:ChevronsUpDown,LucideChrome:Chromium,LucideChromium:Chromium,LucideChurch:Church,LucideCigarette:Cigarette,LucideCigaretteOff:CigaretteOff,LucideCircle:Circle,LucideCircleAlert:CircleAlert,LucideCircleArrowDown:CircleArrowDown,LucideCircleArrowLeft:CircleArrowLeft,LucideCircleArrowOutDownLeft:CircleArrowOutDownLeft,LucideCircleArrowOutDownRight:CircleArrowOutDownRight,LucideCircleArrowOutUpLeft:CircleArrowOutUpLeft,LucideCircleArrowOutUpRight:CircleArrowOutUpRight,LucideCircleArrowRight:CircleArrowRight,LucideCircleArrowUp:CircleArrowUp,LucideCircleCheck:CircleCheck,LucideCircleCheckBig:CircleCheckBig,LucideCircleChevronDown:CircleChevronDown,LucideCircleChevronLeft:CircleChevronLeft,LucideCircleChevronRight:CircleChevronRight,LucideCircleChevronUp:CircleChevronUp,LucideCircleDashed:CircleDashed,LucideCircleDivide:CircleDivide,LucideCircleDollarSign:CircleDollarSign,LucideCircleDot:CircleDot,LucideCircleDotDashed:CircleDotDashed,LucideCircleEllipsis:CircleEllipsis,LucideCircleEqual:CircleEqual,LucideCircleFadingArrowUp:CircleFadingArrowUp,LucideCircleFadingPlus:CircleFadingPlus,LucideCircleGauge:CircleGauge,LucideCircleHelp:CircleQuestionMark,LucideCircleMinus:CircleMinus,LucideCircleOff:CircleOff,LucideCircleParking:CircleParking,LucideCircleParkingOff:CircleParkingOff,LucideCirclePause:CirclePause,LucideCirclePercent:CirclePercent,LucideCirclePlay:CirclePlay,LucideCirclePlus:CirclePlus,LucideCirclePoundSterling:CirclePoundSterling,LucideCirclePower:CirclePower,LucideCircleQuestionMark:CircleQuestionMark,LucideCircleSlash:CircleSlash,LucideCircleSlash2:CircleSlash2,LucideCircleSlashed:CircleSlash2,LucideCircleSmall:CircleSmall,LucideCircleStar:CircleStar,LucideCircleStop:CircleStop,LucideCircleUser:CircleUser,LucideCircleUserRound:CircleUserRound,LucideCircleX:CircleX,LucideCircuitBoard:CircuitBoard,LucideCitrus:Citrus,LucideClapperboard:Clapperboard,LucideClipboard:Clipboard,LucideClipboardCheck:ClipboardCheck,LucideClipboardClock:ClipboardClock,LucideClipboardCopy:ClipboardCopy,LucideClipboardEdit:ClipboardPen,LucideClipboardList:ClipboardList,LucideClipboardMinus:ClipboardMinus,LucideClipboardPaste:ClipboardPaste,LucideClipboardPen:ClipboardPen,LucideClipboardPenLine:ClipboardPenLine,LucideClipboardPlus:ClipboardPlus,LucideClipboardSignature:ClipboardPenLine,LucideClipboardType:ClipboardType,LucideClipboardX:ClipboardX,LucideClock:Clock,LucideClock1:Clock1,LucideClock10:Clock10,LucideClock11:Clock11,LucideClock12:Clock12,LucideClock2:Clock2,LucideClock3:Clock3,LucideClock4:Clock4,LucideClock5:Clock5,LucideClock6:Clock6,LucideClock7:Clock7,LucideClock8:Clock8,LucideClock9:Clock9,LucideClockAlert:ClockAlert,LucideClockArrowDown:ClockArrowDown,LucideClockArrowUp:ClockArrowUp,LucideClockCheck:ClockCheck,LucideClockFading:ClockFading,LucideClockPlus:ClockPlus,LucideClosedCaption:ClosedCaption,LucideCloud:Cloud,LucideCloudAlert:CloudAlert,LucideCloudCheck:CloudCheck,LucideCloudCog:CloudCog,LucideCloudDownload:CloudDownload,LucideCloudDrizzle:CloudDrizzle,LucideCloudFog:CloudFog,LucideCloudHail:CloudHail,LucideCloudLightning:CloudLightning,LucideCloudMoon:CloudMoon,LucideCloudMoonRain:CloudMoonRain,LucideCloudOff:CloudOff,LucideCloudRain:CloudRain,LucideCloudRainWind:CloudRainWind,LucideCloudSnow:CloudSnow,LucideCloudSun:CloudSun,LucideCloudSunRain:CloudSunRain,LucideCloudUpload:CloudUpload,LucideCloudy:Cloudy,LucideClover:Clover,LucideClub:Club,LucideCode:Code,LucideCode2:CodeXml,LucideCodeSquare:SquareCode,LucideCodeXml:CodeXml,LucideCodepen:Codepen,LucideCodesandbox:Codesandbox,LucideCoffee:Coffee,LucideCog:Cog,LucideCoins:Coins,LucideColumns:Columns2,LucideColumns2:Columns2,LucideColumns3:Columns3,LucideColumns3Cog:Columns3Cog,LucideColumns4:Columns4,LucideColumnsSettings:Columns3Cog,LucideCombine:Combine,LucideCommand:Command,LucideCompass:Compass,LucideComponent:Component,LucideComputer:Computer,LucideConciergeBell:ConciergeBell,LucideCone:Cone,LucideConstruction:Construction,LucideContact:Contact,LucideContact2:ContactRound,LucideContactRound:ContactRound,LucideContainer:Container,LucideContrast:Contrast,LucideCookie:Cookie,LucideCookingPot:CookingPot,LucideCopy:Copy,LucideCopyCheck:CopyCheck,LucideCopyMinus:CopyMinus,LucideCopyPlus:CopyPlus,LucideCopySlash:CopySlash,LucideCopyX:CopyX,LucideCopyleft:Copyleft,LucideCopyright:Copyright,LucideCornerDownLeft:CornerDownLeft,LucideCornerDownRight:CornerDownRight,LucideCornerLeftDown:CornerLeftDown,LucideCornerLeftUp:CornerLeftUp,LucideCornerRightDown:CornerRightDown,LucideCornerRightUp:CornerRightUp,LucideCornerUpLeft:CornerUpLeft,LucideCornerUpRight:CornerUpRight,LucideCpu:Cpu,LucideCreativeCommons:CreativeCommons,LucideCreditCard:CreditCard,LucideCroissant:Croissant,LucideCrop:Crop,LucideCross:Cross,LucideCrosshair:Crosshair,LucideCrown:Crown,LucideCuboid:Cuboid,LucideCupSoda:CupSoda,LucideCurlyBraces:Braces,LucideCurrency:Currency,LucideCylinder:Cylinder,LucideDam:Dam,LucideDatabase:Database,LucideDatabaseBackup:DatabaseBackup,LucideDatabaseZap:DatabaseZap,LucideDecimalsArrowLeft:DecimalsArrowLeft,LucideDecimalsArrowRight:DecimalsArrowRight,LucideDelete:Delete,LucideDessert:Dessert,LucideDiameter:Diameter,LucideDiamond:Diamond,LucideDiamondMinus:DiamondMinus,LucideDiamondPercent:DiamondPercent,LucideDiamondPlus:DiamondPlus,LucideDice1:Dice1,LucideDice2:Dice2,LucideDice3:Dice3,LucideDice4:Dice4,LucideDice5:Dice5,LucideDice6:Dice6,LucideDices:Dices,LucideDiff:Diff,LucideDisc:Disc,LucideDisc2:Disc2,LucideDisc3:Disc3,LucideDiscAlbum:DiscAlbum,LucideDivide:Divide,LucideDivideCircle:CircleDivide,LucideDivideSquare:SquareDivide,LucideDna:Dna,LucideDnaOff:DnaOff,LucideDock:Dock,LucideDog:Dog,LucideDollarSign:DollarSign,LucideDonut:Donut,LucideDoorClosed:DoorClosed,LucideDoorClosedLocked:DoorClosedLocked,LucideDoorOpen:DoorOpen,LucideDot:Dot,LucideDotSquare:SquareDot,LucideDownload:Download,LucideDownloadCloud:CloudDownload,LucideDraftingCompass:DraftingCompass,LucideDrama:Drama,LucideDribbble:Dribbble,LucideDrill:Drill,LucideDrone:Drone,LucideDroplet:Droplet,LucideDropletOff:DropletOff,LucideDroplets:Droplets,LucideDrum:Drum,LucideDrumstick:Drumstick,LucideDumbbell:Dumbbell,LucideEar:Ear,LucideEarOff:EarOff,LucideEarth:Earth,LucideEarthLock:EarthLock,LucideEclipse:Eclipse,LucideEdit:SquarePen,LucideEdit2:Pen,LucideEdit3:PenLine,LucideEgg:Egg,LucideEggFried:EggFried,LucideEggOff:EggOff,LucideEllipsis:Ellipsis,LucideEllipsisVertical:EllipsisVertical,LucideEqual:Equal,LucideEqualApproximately:EqualApproximately,LucideEqualNot:EqualNot,LucideEqualSquare:SquareEqual,LucideEraser:Eraser,LucideEthernetPort:EthernetPort,LucideEuro:Euro,LucideEvCharger:EvCharger,LucideExpand:Expand,LucideExternalLink:ExternalLink,LucideEye:Eye,LucideEyeClosed:EyeClosed,LucideEyeOff:EyeOff,LucideFacebook:Facebook,LucideFactory:Factory,LucideFan:Fan,LucideFastForward:FastForward,LucideFeather:Feather,LucideFence:Fence,LucideFerrisWheel:FerrisWheel,LucideFigma:Figma,LucideFile:File,LucideFileArchive:FileArchive,LucideFileAudio:FileHeadphone,LucideFileAudio2:FileHeadphone,LucideFileAxis3D:FileAxis3d,LucideFileAxis3d:FileAxis3d,LucideFileBadge:FileBadge,LucideFileBadge2:FileBadge,LucideFileBarChart:FileChartColumnIncreasing,LucideFileBarChart2:FileChartColumn,LucideFileBox:FileBox,LucideFileBraces:FileBraces,LucideFileBracesCorner:FileBracesCorner,LucideFileChartColumn:FileChartColumn,LucideFileChartColumnIncreasing:FileChartColumnIncreasing,LucideFileChartLine:FileChartLine,LucideFileChartPie:FileChartPie,LucideFileCheck:FileCheck,LucideFileCheck2:FileCheckCorner,LucideFileCheckCorner:FileCheckCorner,LucideFileClock:FileClock,LucideFileCode:FileCode,LucideFileCode2:FileCodeCorner,LucideFileCodeCorner:FileCodeCorner,LucideFileCog:FileCog,LucideFileCog2:FileCog,LucideFileDiff:FileDiff,LucideFileDigit:FileDigit,LucideFileDown:FileDown,LucideFileEdit:FilePen,LucideFileExclamationPoint:FileExclamationPoint,LucideFileHeadphone:FileHeadphone,LucideFileHeart:FileHeart,LucideFileImage:FileImage,LucideFileInput:FileInput,LucideFileJson:FileBraces,LucideFileJson2:FileBracesCorner,LucideFileKey:FileKey,LucideFileKey2:FileKey,LucideFileLineChart:FileChartLine,LucideFileLock:FileLock,LucideFileLock2:FileLock,LucideFileMinus:FileMinus,LucideFileMinus2:FileMinusCorner,LucideFileMinusCorner:FileMinusCorner,LucideFileMusic:FileMusic,LucideFileOutput:FileOutput,LucideFilePen:FilePen,LucideFilePenLine:FilePenLine,LucideFilePieChart:FileChartPie,LucideFilePlay:FilePlay,LucideFilePlus:FilePlus,LucideFilePlus2:FilePlusCorner,LucideFilePlusCorner:FilePlusCorner,LucideFileQuestion:FileQuestionMark,LucideFileQuestionMark:FileQuestionMark,LucideFileScan:FileScan,LucideFileSearch:FileSearch,LucideFileSearch2:FileSearchCorner,LucideFileSearchCorner:FileSearchCorner,LucideFileSignal:FileSignal,LucideFileSignature:FilePenLine,LucideFileSliders:FileSliders,LucideFileSpreadsheet:FileSpreadsheet,LucideFileStack:FileStack,LucideFileSymlink:FileSymlink,LucideFileTerminal:FileTerminal,LucideFileText:FileText,LucideFileType:FileType,LucideFileType2:FileTypeCorner,LucideFileTypeCorner:FileTypeCorner,LucideFileUp:FileUp,LucideFileUser:FileUser,LucideFileVideo:FilePlay,LucideFileVideo2:FileVideoCamera,LucideFileVideoCamera:FileVideoCamera,LucideFileVolume:FileVolume,LucideFileVolume2:FileSignal,LucideFileWarning:FileExclamationPoint,LucideFileX:FileX,LucideFileX2:FileXCorner,LucideFileXCorner:FileXCorner,LucideFiles:Files,LucideFilm:Film,LucideFilter:Funnel,LucideFilterX:FunnelX,LucideFingerprint:FingerprintPattern,LucideFingerprintPattern:FingerprintPattern,LucideFireExtinguisher:FireExtinguisher,LucideFish:Fish,LucideFishOff:FishOff,LucideFishSymbol:FishSymbol,LucideFlag:Flag,LucideFlagOff:FlagOff,LucideFlagTriangleLeft:FlagTriangleLeft,LucideFlagTriangleRight:FlagTriangleRight,LucideFlame:Flame,LucideFlameKindling:FlameKindling,LucideFlashlight:Flashlight,LucideFlashlightOff:FlashlightOff,LucideFlaskConical:FlaskConical,LucideFlaskConicalOff:FlaskConicalOff,LucideFlaskRound:FlaskRound,LucideFlipHorizontal:FlipHorizontal,LucideFlipHorizontal2:FlipHorizontal2,LucideFlipVertical:FlipVertical,LucideFlipVertical2:FlipVertical2,LucideFlower:Flower,LucideFlower2:Flower2,LucideFocus:Focus,LucideFoldHorizontal:FoldHorizontal,LucideFoldVertical:FoldVertical,LucideFolder:Folder,LucideFolderArchive:FolderArchive,LucideFolderCheck:FolderCheck,LucideFolderClock:FolderClock,LucideFolderClosed:FolderClosed,LucideFolderCode:FolderCode,LucideFolderCog:FolderCog,LucideFolderCog2:FolderCog,LucideFolderDot:FolderDot,LucideFolderDown:FolderDown,LucideFolderEdit:FolderPen,LucideFolderGit:FolderGit,LucideFolderGit2:FolderGit2,LucideFolderHeart:FolderHeart,LucideFolderInput:FolderInput,LucideFolderKanban:FolderKanban,LucideFolderKey:FolderKey,LucideFolderLock:FolderLock,LucideFolderMinus:FolderMinus,LucideFolderOpen:FolderOpen,LucideFolderOpenDot:FolderOpenDot,LucideFolderOutput:FolderOutput,LucideFolderPen:FolderPen,LucideFolderPlus:FolderPlus,LucideFolderRoot:FolderRoot,LucideFolderSearch:FolderSearch,LucideFolderSearch2:FolderSearch2,LucideFolderSymlink:FolderSymlink,LucideFolderSync:FolderSync,LucideFolderTree:FolderTree,LucideFolderUp:FolderUp,LucideFolderX:FolderX,LucideFolders:Folders,LucideFootprints:Footprints,LucideForkKnife:Utensils,LucideForkKnifeCrossed:UtensilsCrossed,LucideForklift:Forklift,LucideFormInput:RectangleEllipsis,LucideForward:Forward,LucideFrame:Frame,LucideFramer:Framer,LucideFrown:Frown,LucideFuel:Fuel,LucideFullscreen:Fullscreen,LucideFunctionSquare:SquareFunction,LucideFunnel:Funnel,LucideFunnelPlus:FunnelPlus,LucideFunnelX:FunnelX,LucideGalleryHorizontal:GalleryHorizontal,LucideGalleryHorizontalEnd:GalleryHorizontalEnd,LucideGalleryThumbnails:GalleryThumbnails,LucideGalleryVertical:GalleryVertical,LucideGalleryVerticalEnd:GalleryVerticalEnd,LucideGamepad:Gamepad,LucideGamepad2:Gamepad2,LucideGamepadDirectional:GamepadDirectional,LucideGanttChart:ChartNoAxesGantt,LucideGanttChartSquare:SquareChartGantt,LucideGauge:Gauge,LucideGaugeCircle:CircleGauge,LucideGavel:Gavel,LucideGem:Gem,LucideGeorgianLari:GeorgianLari,LucideGhost:Ghost,LucideGift:Gift,LucideGitBranch:GitBranch,LucideGitBranchMinus:GitBranchMinus,LucideGitBranchPlus:GitBranchPlus,LucideGitCommit:GitCommitHorizontal,LucideGitCommitHorizontal:GitCommitHorizontal,LucideGitCommitVertical:GitCommitVertical,LucideGitCompare:GitCompare,LucideGitCompareArrows:GitCompareArrows,LucideGitFork:GitFork,LucideGitGraph:GitGraph,LucideGitMerge:GitMerge,LucideGitPullRequest:GitPullRequest,LucideGitPullRequestArrow:GitPullRequestArrow,LucideGitPullRequestClosed:GitPullRequestClosed,LucideGitPullRequestCreate:GitPullRequestCreate,LucideGitPullRequestCreateArrow:GitPullRequestCreateArrow,LucideGitPullRequestDraft:GitPullRequestDraft,LucideGithub:Github,LucideGitlab:Gitlab,LucideGlassWater:GlassWater,LucideGlasses:Glasses,LucideGlobe:Globe,LucideGlobe2:Earth,LucideGlobeLock:GlobeLock,LucideGoal:Goal,LucideGpu:Gpu,LucideGrab:HandGrab,LucideGraduationCap:GraduationCap,LucideGrape:Grape,LucideGrid:Grid3x3,LucideGrid2X2:Grid2x2,LucideGrid2X2Check:Grid2x2Check,LucideGrid2X2Plus:Grid2x2Plus,LucideGrid2X2X:Grid2x2X,LucideGrid2x2:Grid2x2,LucideGrid2x2Check:Grid2x2Check,LucideGrid2x2Plus:Grid2x2Plus,LucideGrid2x2X:Grid2x2X,LucideGrid3X3:Grid3x3,LucideGrid3x2:Grid3x2,LucideGrid3x3:Grid3x3,LucideGrip:Grip,LucideGripHorizontal:GripHorizontal,LucideGripVertical:GripVertical,LucideGroup:Group,LucideGuitar:Guitar,LucideHam:Ham,LucideHamburger:Hamburger,LucideHammer:Hammer,LucideHand:Hand,LucideHandCoins:HandCoins,LucideHandFist:HandFist,LucideHandGrab:HandGrab,LucideHandHeart:HandHeart,LucideHandHelping:HandHelping,LucideHandMetal:HandMetal,LucideHandPlatter:HandPlatter,LucideHandbag:Handbag,LucideHandshake:Handshake,LucideHardDrive:HardDrive,LucideHardDriveDownload:HardDriveDownload,LucideHardDriveUpload:HardDriveUpload,LucideHardHat:HardHat,LucideHash:Hash$1,LucideHatGlasses:HatGlasses,LucideHaze:Haze,LucideHdmiPort:HdmiPort,LucideHeading:Heading$1,LucideHeading1:Heading1,LucideHeading2:Heading2,LucideHeading3:Heading3,LucideHeading4:Heading4,LucideHeading5:Heading5,LucideHeading6:Heading6,LucideHeadphoneOff:HeadphoneOff,LucideHeadphones:Headphones,LucideHeadset:Headset,LucideHeart:Heart,LucideHeartCrack:HeartCrack,LucideHeartHandshake:HeartHandshake,LucideHeartMinus:HeartMinus,LucideHeartOff:HeartOff,LucideHeartPlus:HeartPlus,LucideHeartPulse:HeartPulse,LucideHeater:Heater,LucideHelicopter:Helicopter,LucideHelpCircle:CircleQuestionMark,LucideHelpingHand:HandHelping,LucideHexagon:Hexagon,LucideHighlighter:Highlighter,LucideHistory:History,LucideHome:House,LucideHop:Hop,LucideHopOff:HopOff,LucideHospital:Hospital,LucideHotel:Hotel,LucideHourglass:Hourglass,LucideHouse:House,LucideHouseHeart:HouseHeart,LucideHousePlug:HousePlug,LucideHousePlus:HousePlus,LucideHouseWifi:HouseWifi,LucideIceCream:IceCreamCone,LucideIceCream2:IceCreamBowl,LucideIceCreamBowl:IceCreamBowl,LucideIceCreamCone:IceCreamCone,LucideIdCard:IdCard,LucideIdCardLanyard:IdCardLanyard,LucideImage:Image$1,LucideImageDown:ImageDown,LucideImageMinus:ImageMinus,LucideImageOff:ImageOff,LucideImagePlay:ImagePlay,LucideImagePlus:ImagePlus,LucideImageUp:ImageUp,LucideImageUpscale:ImageUpscale,LucideImages:Images,LucideImport:Import,LucideInbox:Inbox,LucideIndent:ListIndentIncrease,LucideIndentDecrease:ListIndentDecrease,LucideIndentIncrease:ListIndentIncrease,LucideIndianRupee:IndianRupee,LucideInfinity:Infinity$1,LucideInfo:Info,LucideInspect:SquareMousePointer,LucideInspectionPanel:InspectionPanel,LucideInstagram:Instagram,LucideItalic:Italic,LucideIterationCcw:IterationCcw,LucideIterationCw:IterationCw,LucideJapaneseYen:JapaneseYen,LucideJoystick:Joystick,LucideKanban:Kanban,LucideKanbanSquare:SquareKanban,LucideKanbanSquareDashed:SquareDashedKanban,LucideKayak:Kayak,LucideKey:Key,LucideKeyRound:KeyRound,LucideKeySquare:KeySquare,LucideKeyboard:Keyboard,LucideKeyboardMusic:KeyboardMusic,LucideKeyboardOff:KeyboardOff,LucideLamp:Lamp,LucideLampCeiling:LampCeiling,LucideLampDesk:LampDesk,LucideLampFloor:LampFloor,LucideLampWallDown:LampWallDown,LucideLampWallUp:LampWallUp,LucideLandPlot:LandPlot,LucideLandmark:Landmark,LucideLanguages:Languages,LucideLaptop:Laptop,LucideLaptop2:LaptopMinimal,LucideLaptopMinimal:LaptopMinimal,LucideLaptopMinimalCheck:LaptopMinimalCheck,LucideLasso:Lasso,LucideLassoSelect:LassoSelect,LucideLaugh:Laugh,LucideLayers:Layers,LucideLayers2:Layers2,LucideLayers3:Layers,LucideLayout:PanelsTopLeft,LucideLayoutDashboard:LayoutDashboard,LucideLayoutGrid:LayoutGrid,LucideLayoutList:LayoutList,LucideLayoutPanelLeft:LayoutPanelLeft,LucideLayoutPanelTop:LayoutPanelTop,LucideLayoutTemplate:LayoutTemplate,LucideLeaf:Leaf,LucideLeafyGreen:LeafyGreen,LucideLectern:Lectern,LucideLetterText:TextInitial,LucideLibrary:Library,LucideLibraryBig:LibraryBig,LucideLibrarySquare:SquareLibrary,LucideLifeBuoy:LifeBuoy,LucideLigature:Ligature,LucideLightbulb:Lightbulb,LucideLightbulbOff:LightbulbOff,LucideLineChart:ChartLine,LucideLineSquiggle:LineSquiggle,LucideLink:Link,LucideLink2:Link2,LucideLink2Off:Link2Off,LucideLinkedin:Linkedin,LucideList:List,LucideListCheck:ListCheck,LucideListChecks:ListChecks,LucideListChevronsDownUp:ListChevronsDownUp,LucideListChevronsUpDown:ListChevronsUpDown,LucideListCollapse:ListCollapse,LucideListEnd:ListEnd,LucideListFilter:ListFilter,LucideListFilterPlus:ListFilterPlus,LucideListIndentDecrease:ListIndentDecrease,LucideListIndentIncrease:ListIndentIncrease,LucideListMinus:ListMinus,LucideListMusic:ListMusic,LucideListOrdered:ListOrdered,LucideListPlus:ListPlus,LucideListRestart:ListRestart,LucideListStart:ListStart,LucideListTodo:ListTodo,LucideListTree:ListTree,LucideListVideo:ListVideo,LucideListX:ListX,LucideLoader:Loader,LucideLoader2:LoaderCircle,LucideLoaderCircle:LoaderCircle,LucideLoaderPinwheel:LoaderPinwheel,LucideLocate:Locate,LucideLocateFixed:LocateFixed,LucideLocateOff:LocateOff,LucideLocationEdit:MapPinPen,LucideLock:Lock,LucideLockKeyhole:LockKeyhole,LucideLockKeyholeOpen:LockKeyholeOpen,LucideLockOpen:LockOpen,LucideLogIn:LogIn,LucideLogOut:LogOut,LucideLogs:Logs,LucideLollipop:Lollipop,LucideLuggage:Luggage,LucideMSquare:SquareM,LucideMagnet:Magnet,LucideMail:Mail,LucideMailCheck:MailCheck,LucideMailMinus:MailMinus,LucideMailOpen:MailOpen,LucideMailPlus:MailPlus,LucideMailQuestion:MailQuestionMark,LucideMailQuestionMark:MailQuestionMark,LucideMailSearch:MailSearch,LucideMailWarning:MailWarning,LucideMailX:MailX,LucideMailbox:Mailbox,LucideMails:Mails,LucideMap:Map$2,LucideMapMinus:MapMinus,LucideMapPin:MapPin,LucideMapPinCheck:MapPinCheck,LucideMapPinCheckInside:MapPinCheckInside,LucideMapPinHouse:MapPinHouse,LucideMapPinMinus:MapPinMinus,LucideMapPinMinusInside:MapPinMinusInside,LucideMapPinOff:MapPinOff,LucideMapPinPen:MapPinPen,LucideMapPinPlus:MapPinPlus,LucideMapPinPlusInside:MapPinPlusInside,LucideMapPinX:MapPinX,LucideMapPinXInside:MapPinXInside,LucideMapPinned:MapPinned,LucideMapPlus:MapPlus,LucideMars:Mars,LucideMarsStroke:MarsStroke,LucideMartini:Martini,LucideMaximize:Maximize,LucideMaximize2:Maximize2,LucideMedal:Medal,LucideMegaphone:Megaphone,LucideMegaphoneOff:MegaphoneOff,LucideMeh:Meh,LucideMemoryStick:MemoryStick,LucideMenu:Menu,LucideMenuSquare:SquareMenu,LucideMerge:Merge,LucideMessageCircle:MessageCircle,LucideMessageCircleCode:MessageCircleCode,LucideMessageCircleDashed:MessageCircleDashed,LucideMessageCircleHeart:MessageCircleHeart,LucideMessageCircleMore:MessageCircleMore,LucideMessageCircleOff:MessageCircleOff,LucideMessageCirclePlus:MessageCirclePlus,LucideMessageCircleQuestion:MessageCircleQuestionMark,LucideMessageCircleQuestionMark:MessageCircleQuestionMark,LucideMessageCircleReply:MessageCircleReply,LucideMessageCircleWarning:MessageCircleWarning,LucideMessageCircleX:MessageCircleX,LucideMessageSquare:MessageSquare,LucideMessageSquareCode:MessageSquareCode,LucideMessageSquareDashed:MessageSquareDashed,LucideMessageSquareDiff:MessageSquareDiff,LucideMessageSquareDot:MessageSquareDot,LucideMessageSquareHeart:MessageSquareHeart,LucideMessageSquareLock:MessageSquareLock,LucideMessageSquareMore:MessageSquareMore,LucideMessageSquareOff:MessageSquareOff,LucideMessageSquarePlus:MessageSquarePlus,LucideMessageSquareQuote:MessageSquareQuote,LucideMessageSquareReply:MessageSquareReply,LucideMessageSquareShare:MessageSquareShare,LucideMessageSquareText:MessageSquareText,LucideMessageSquareWarning:MessageSquareWarning,LucideMessageSquareX:MessageSquareX,LucideMessagesSquare:MessagesSquare,LucideMic:Mic,LucideMic2:MicVocal,LucideMicOff:MicOff,LucideMicVocal:MicVocal,LucideMicrochip:Microchip,LucideMicroscope:Microscope,LucideMicrowave:Microwave,LucideMilestone:Milestone,LucideMilk:Milk,LucideMilkOff:MilkOff,LucideMinimize:Minimize,LucideMinimize2:Minimize2,LucideMinus:Minus,LucideMinusCircle:CircleMinus,LucideMinusSquare:SquareMinus,LucideMonitor:Monitor,LucideMonitorCheck:MonitorCheck,LucideMonitorCloud:MonitorCloud,LucideMonitorCog:MonitorCog,LucideMonitorDot:MonitorDot,LucideMonitorDown:MonitorDown,LucideMonitorOff:MonitorOff,LucideMonitorPause:MonitorPause,LucideMonitorPlay:MonitorPlay,LucideMonitorSmartphone:MonitorSmartphone,LucideMonitorSpeaker:MonitorSpeaker,LucideMonitorStop:MonitorStop,LucideMonitorUp:MonitorUp,LucideMonitorX:MonitorX,LucideMoon:Moon,LucideMoonStar:MoonStar,LucideMoreHorizontal:Ellipsis,LucideMoreVertical:EllipsisVertical,LucideMotorbike:Motorbike,LucideMountain:Mountain,LucideMountainSnow:MountainSnow,LucideMouse:Mouse,LucideMouseOff:MouseOff,LucideMousePointer:MousePointer,LucideMousePointer2:MousePointer2,LucideMousePointer2Off:MousePointer2Off,LucideMousePointerBan:MousePointerBan,LucideMousePointerClick:MousePointerClick,LucideMousePointerSquareDashed:SquareDashedMousePointer,LucideMove:Move,LucideMove3D:Move3d,LucideMove3d:Move3d,LucideMoveDiagonal:MoveDiagonal,LucideMoveDiagonal2:MoveDiagonal2,LucideMoveDown:MoveDown,LucideMoveDownLeft:MoveDownLeft,LucideMoveDownRight:MoveDownRight,LucideMoveHorizontal:MoveHorizontal,LucideMoveLeft:MoveLeft,LucideMoveRight:MoveRight,LucideMoveUp:MoveUp,LucideMoveUpLeft:MoveUpLeft,LucideMoveUpRight:MoveUpRight,LucideMoveVertical:MoveVertical,LucideMusic:Music,LucideMusic2:Music2,LucideMusic3:Music3,LucideMusic4:Music4,LucideNavigation:Navigation,LucideNavigation2:Navigation2,LucideNavigation2Off:Navigation2Off,LucideNavigationOff:NavigationOff,LucideNetwork:Network,LucideNewspaper:Newspaper,LucideNfc:Nfc,LucideNonBinary:NonBinary,LucideNotebook:Notebook,LucideNotebookPen:NotebookPen,LucideNotebookTabs:NotebookTabs,LucideNotebookText:NotebookText,LucideNotepadText:NotepadText,LucideNotepadTextDashed:NotepadTextDashed,LucideNut:Nut,LucideNutOff:NutOff,LucideOctagon:Octagon,LucideOctagonAlert:OctagonAlert,LucideOctagonMinus:OctagonMinus,LucideOctagonPause:OctagonPause,LucideOctagonX:OctagonX,LucideOmega:Omega,LucideOption:Option,LucideOrbit:Orbit,LucideOrigami:Origami,LucideOutdent:ListIndentDecrease,LucidePackage:Package,LucidePackage2:Package2,LucidePackageCheck:PackageCheck,LucidePackageMinus:PackageMinus,LucidePackageOpen:PackageOpen,LucidePackagePlus:PackagePlus,LucidePackageSearch:PackageSearch,LucidePackageX:PackageX,LucidePaintBucket:PaintBucket,LucidePaintRoller:PaintRoller,LucidePaintbrush:Paintbrush,LucidePaintbrush2:PaintbrushVertical,LucidePaintbrushVertical:PaintbrushVertical,LucidePalette:Palette,LucidePalmtree:TreePalm,LucidePanda:Panda,LucidePanelBottom:PanelBottom,LucidePanelBottomClose:PanelBottomClose,LucidePanelBottomDashed:PanelBottomDashed,LucidePanelBottomInactive:PanelBottomDashed,LucidePanelBottomOpen:PanelBottomOpen,LucidePanelLeft:PanelLeft,LucidePanelLeftClose:PanelLeftClose,LucidePanelLeftDashed:PanelLeftDashed,LucidePanelLeftInactive:PanelLeftDashed,LucidePanelLeftOpen:PanelLeftOpen,LucidePanelLeftRightDashed:PanelLeftRightDashed,LucidePanelRight:PanelRight,LucidePanelRightClose:PanelRightClose,LucidePanelRightDashed:PanelRightDashed,LucidePanelRightInactive:PanelRightDashed,LucidePanelRightOpen:PanelRightOpen,LucidePanelTop:PanelTop,LucidePanelTopBottomDashed:PanelTopBottomDashed,LucidePanelTopClose:PanelTopClose,LucidePanelTopDashed:PanelTopDashed,LucidePanelTopInactive:PanelTopDashed,LucidePanelTopOpen:PanelTopOpen,LucidePanelsLeftBottom:PanelsLeftBottom,LucidePanelsLeftRight:Columns3,LucidePanelsRightBottom:PanelsRightBottom,LucidePanelsTopBottom:Rows3,LucidePanelsTopLeft:PanelsTopLeft,LucidePaperclip:Paperclip,LucideParentheses:Parentheses,LucideParkingCircle:CircleParking,LucideParkingCircleOff:CircleParkingOff,LucideParkingMeter:ParkingMeter,LucideParkingSquare:SquareParking,LucideParkingSquareOff:SquareParkingOff,LucidePartyPopper:PartyPopper,LucidePause:Pause,LucidePauseCircle:CirclePause,LucidePauseOctagon:OctagonPause,LucidePawPrint:PawPrint,LucidePcCase:PcCase,LucidePen:Pen,LucidePenBox:SquarePen,LucidePenLine:PenLine,LucidePenOff:PenOff,LucidePenSquare:SquarePen,LucidePenTool:PenTool,LucidePencil:Pencil,LucidePencilLine:PencilLine,LucidePencilOff:PencilOff,LucidePencilRuler:PencilRuler,LucidePentagon:Pentagon,LucidePercent:Percent,LucidePercentCircle:CirclePercent,LucidePercentDiamond:DiamondPercent,LucidePercentSquare:SquarePercent,LucidePersonStanding:PersonStanding,LucidePhilippinePeso:PhilippinePeso,LucidePhone:Phone,LucidePhoneCall:PhoneCall,LucidePhoneForwarded:PhoneForwarded,LucidePhoneIncoming:PhoneIncoming,LucidePhoneMissed:PhoneMissed,LucidePhoneOff:PhoneOff,LucidePhoneOutgoing:PhoneOutgoing,LucidePi:Pi,LucidePiSquare:SquarePi,LucidePiano:Piano,LucidePickaxe:Pickaxe,LucidePictureInPicture:PictureInPicture,LucidePictureInPicture2:PictureInPicture2,LucidePieChart:ChartPie,LucidePiggyBank:PiggyBank,LucidePilcrow:Pilcrow,LucidePilcrowLeft:PilcrowLeft,LucidePilcrowRight:PilcrowRight,LucidePilcrowSquare:SquarePilcrow,LucidePill:Pill,LucidePillBottle:PillBottle,LucidePin:Pin,LucidePinOff:PinOff,LucidePipette:Pipette,LucidePizza:Pizza,LucidePlane:Plane,LucidePlaneLanding:PlaneLanding,LucidePlaneTakeoff:PlaneTakeoff,LucidePlay:Play,LucidePlayCircle:CirclePlay,LucidePlaySquare:SquarePlay,LucidePlug:Plug,LucidePlug2:Plug2,LucidePlugZap:PlugZap,LucidePlugZap2:PlugZap,LucidePlus:Plus,LucidePlusCircle:CirclePlus,LucidePlusSquare:SquarePlus,LucidePocket:Pocket,LucidePocketKnife:PocketKnife,LucidePodcast:Podcast,LucidePointer:Pointer,LucidePointerOff:PointerOff,LucidePopcorn:Popcorn,LucidePopsicle:Popsicle,LucidePoundSterling:PoundSterling,LucidePower:Power,LucidePowerCircle:CirclePower,LucidePowerOff:PowerOff,LucidePowerSquare:SquarePower,LucidePresentation:Presentation,LucidePrinter:Printer,LucidePrinterCheck:PrinterCheck,LucideProjector:Projector,LucideProportions:Proportions,LucidePuzzle:Puzzle,LucidePyramid:Pyramid,LucideQrCode:QrCode,LucideQuote:Quote,LucideRabbit:Rabbit,LucideRadar:Radar,LucideRadiation:Radiation,LucideRadical:Radical,LucideRadio:Radio,LucideRadioReceiver:RadioReceiver,LucideRadioTower:RadioTower,LucideRadius:Radius,LucideRailSymbol:RailSymbol,LucideRainbow:Rainbow,LucideRat:Rat,LucideRatio:Ratio,LucideReceipt:Receipt,LucideReceiptCent:ReceiptCent,LucideReceiptEuro:ReceiptEuro,LucideReceiptIndianRupee:ReceiptIndianRupee,LucideReceiptJapaneseYen:ReceiptJapaneseYen,LucideReceiptPoundSterling:ReceiptPoundSterling,LucideReceiptRussianRuble:ReceiptRussianRuble,LucideReceiptSwissFranc:ReceiptSwissFranc,LucideReceiptText:ReceiptText,LucideReceiptTurkishLira:ReceiptTurkishLira,LucideRectangleCircle:RectangleCircle,LucideRectangleEllipsis:RectangleEllipsis,LucideRectangleGoggles:RectangleGoggles,LucideRectangleHorizontal:RectangleHorizontal,LucideRectangleVertical:RectangleVertical,LucideRecycle:Recycle,LucideRedo:Redo,LucideRedo2:Redo2,LucideRedoDot:RedoDot,LucideRefreshCcw:RefreshCcw,LucideRefreshCcwDot:RefreshCcwDot,LucideRefreshCw:RefreshCw,LucideRefreshCwOff:RefreshCwOff,LucideRefrigerator:Refrigerator,LucideRegex:Regex,LucideRemoveFormatting:RemoveFormatting,LucideRepeat:Repeat,LucideRepeat1:Repeat1,LucideRepeat2:Repeat2,LucideReplace:Replace,LucideReplaceAll:ReplaceAll,LucideReply:Reply,LucideReplyAll:ReplyAll,LucideRewind:Rewind,LucideRibbon:Ribbon,LucideRocket:Rocket,LucideRockingChair:RockingChair,LucideRollerCoaster:RollerCoaster,LucideRose:Rose,LucideRotate3D:Rotate3d,LucideRotate3d:Rotate3d,LucideRotateCcw:RotateCcw,LucideRotateCcwKey:RotateCcwKey,LucideRotateCcwSquare:RotateCcwSquare,LucideRotateCw:RotateCw,LucideRotateCwSquare:RotateCwSquare,LucideRoute:Route,LucideRouteOff:RouteOff,LucideRouter:Router,LucideRows:Rows2,LucideRows2:Rows2,LucideRows3:Rows3,LucideRows4:Rows4,LucideRss:Rss,LucideRuler:Ruler,LucideRulerDimensionLine:RulerDimensionLine,LucideRussianRuble:RussianRuble,LucideSailboat:Sailboat,LucideSalad:Salad,LucideSandwich:Sandwich,LucideSatellite:Satellite,LucideSatelliteDish:SatelliteDish,LucideSaudiRiyal:SaudiRiyal,LucideSave:Save,LucideSaveAll:SaveAll,LucideSaveOff:SaveOff,LucideScale:Scale,LucideScale3D:Scale3d,LucideScale3d:Scale3d,LucideScaling:Scaling,LucideScan:Scan,LucideScanBarcode:ScanBarcode,LucideScanEye:ScanEye,LucideScanFace:ScanFace,LucideScanHeart:ScanHeart,LucideScanLine:ScanLine,LucideScanQrCode:ScanQrCode,LucideScanSearch:ScanSearch,LucideScanText:ScanText,LucideScatterChart:ChartScatter,LucideSchool:School,LucideSchool2:University,LucideScissors:Scissors,LucideScissorsLineDashed:ScissorsLineDashed,LucideScissorsSquare:SquareScissors,LucideScissorsSquareDashedBottom:SquareBottomDashedScissors,LucideScreenShare:ScreenShare,LucideScreenShareOff:ScreenShareOff,LucideScroll:Scroll,LucideScrollText:ScrollText,LucideSearch:Search,LucideSearchCheck:SearchCheck,LucideSearchCode:SearchCode,LucideSearchSlash:SearchSlash,LucideSearchX:SearchX,LucideSection:Section,LucideSend:Send,LucideSendHorizonal:SendHorizontal,LucideSendHorizontal:SendHorizontal,LucideSendToBack:SendToBack,LucideSeparatorHorizontal:SeparatorHorizontal,LucideSeparatorVertical:SeparatorVertical,LucideServer:Server,LucideServerCog:ServerCog,LucideServerCrash:ServerCrash,LucideServerOff:ServerOff,LucideSettings:Settings,LucideSettings2:Settings2,LucideShapes:Shapes,LucideShare:Share,LucideShare2:Share2,LucideSheet:Sheet,LucideShell:Shell,LucideShield:Shield,LucideShieldAlert:ShieldAlert,LucideShieldBan:ShieldBan,LucideShieldCheck:ShieldCheck,LucideShieldClose:ShieldX,LucideShieldEllipsis:ShieldEllipsis,LucideShieldHalf:ShieldHalf,LucideShieldMinus:ShieldMinus,LucideShieldOff:ShieldOff,LucideShieldPlus:ShieldPlus,LucideShieldQuestion:ShieldQuestionMark,LucideShieldQuestionMark:ShieldQuestionMark,LucideShieldUser:ShieldUser,LucideShieldX:ShieldX,LucideShip:Ship,LucideShipWheel:ShipWheel,LucideShirt:Shirt,LucideShoppingBag:ShoppingBag,LucideShoppingBasket:ShoppingBasket,LucideShoppingCart:ShoppingCart,LucideShovel:Shovel,LucideShowerHead:ShowerHead,LucideShredder:Shredder,LucideShrimp:Shrimp,LucideShrink:Shrink,LucideShrub:Shrub,LucideShuffle:Shuffle,LucideSidebar:PanelLeft,LucideSidebarClose:PanelLeftClose,LucideSidebarOpen:PanelLeftOpen,LucideSigma:Sigma,LucideSigmaSquare:SquareSigma,LucideSignal:Signal,LucideSignalHigh:SignalHigh,LucideSignalLow:SignalLow,LucideSignalMedium:SignalMedium,LucideSignalZero:SignalZero,LucideSignature:Signature,LucideSignpost:Signpost,LucideSignpostBig:SignpostBig,LucideSiren:Siren,LucideSkipBack:SkipBack,LucideSkipForward:SkipForward,LucideSkull:Skull,LucideSlack:Slack,LucideSlash:Slash,LucideSlashSquare:SquareSlash,LucideSlice:Slice,LucideSliders:SlidersVertical,LucideSlidersHorizontal:SlidersHorizontal,LucideSlidersVertical:SlidersVertical,LucideSmartphone:Smartphone,LucideSmartphoneCharging:SmartphoneCharging,LucideSmartphoneNfc:SmartphoneNfc,LucideSmile:Smile,LucideSmilePlus:SmilePlus,LucideSnail:Snail,LucideSnowflake:Snowflake,LucideSoapDispenserDroplet:SoapDispenserDroplet,LucideSofa:Sofa,LucideSolarPanel:SolarPanel,LucideSortAsc:ArrowUpNarrowWide,LucideSortDesc:ArrowDownWideNarrow,LucideSoup:Soup,LucideSpace:Space,LucideSpade:Spade,LucideSparkle:Sparkle,LucideSparkles:Sparkles,LucideSpeaker:Speaker,LucideSpeech:Speech,LucideSpellCheck:SpellCheck,LucideSpellCheck2:SpellCheck2,LucideSpline:Spline,LucideSplinePointer:SplinePointer,LucideSplit:Split,LucideSplitSquareHorizontal:SquareSplitHorizontal,LucideSplitSquareVertical:SquareSplitVertical,LucideSpool:Spool,LucideSpotlight:Spotlight,LucideSprayCan:SprayCan,LucideSprout:Sprout,LucideSquare:Square,LucideSquareActivity:SquareActivity,LucideSquareArrowDown:SquareArrowDown,LucideSquareArrowDownLeft:SquareArrowDownLeft,LucideSquareArrowDownRight:SquareArrowDownRight,LucideSquareArrowLeft:SquareArrowLeft,LucideSquareArrowOutDownLeft:SquareArrowOutDownLeft,LucideSquareArrowOutDownRight:SquareArrowOutDownRight,LucideSquareArrowOutUpLeft:SquareArrowOutUpLeft,LucideSquareArrowOutUpRight:SquareArrowOutUpRight,LucideSquareArrowRight:SquareArrowRight,LucideSquareArrowUp:SquareArrowUp,LucideSquareArrowUpLeft:SquareArrowUpLeft,LucideSquareArrowUpRight:SquareArrowUpRight,LucideSquareAsterisk:SquareAsterisk,LucideSquareBottomDashedScissors:SquareBottomDashedScissors,LucideSquareChartGantt:SquareChartGantt,LucideSquareCheck:SquareCheck,LucideSquareCheckBig:SquareCheckBig,LucideSquareChevronDown:SquareChevronDown,LucideSquareChevronLeft:SquareChevronLeft,LucideSquareChevronRight:SquareChevronRight,LucideSquareChevronUp:SquareChevronUp,LucideSquareCode:SquareCode,LucideSquareDashed:SquareDashed,LucideSquareDashedBottom:SquareDashedBottom,LucideSquareDashedBottomCode:SquareDashedBottomCode,LucideSquareDashedKanban:SquareDashedKanban,LucideSquareDashedMousePointer:SquareDashedMousePointer,LucideSquareDashedTopSolid:SquareDashedTopSolid,LucideSquareDivide:SquareDivide,LucideSquareDot:SquareDot,LucideSquareEqual:SquareEqual,LucideSquareFunction:SquareFunction,LucideSquareGanttChart:SquareChartGantt,LucideSquareKanban:SquareKanban,LucideSquareLibrary:SquareLibrary,LucideSquareM:SquareM,LucideSquareMenu:SquareMenu,LucideSquareMinus:SquareMinus,LucideSquareMousePointer:SquareMousePointer,LucideSquareParking:SquareParking,LucideSquareParkingOff:SquareParkingOff,LucideSquarePause:SquarePause,LucideSquarePen:SquarePen,LucideSquarePercent:SquarePercent,LucideSquarePi:SquarePi,LucideSquarePilcrow:SquarePilcrow,LucideSquarePlay:SquarePlay,LucideSquarePlus:SquarePlus,LucideSquarePower:SquarePower,LucideSquareRadical:SquareRadical,LucideSquareRoundCorner:SquareRoundCorner,LucideSquareScissors:SquareScissors,LucideSquareSigma:SquareSigma,LucideSquareSlash:SquareSlash,LucideSquareSplitHorizontal:SquareSplitHorizontal,LucideSquareSplitVertical:SquareSplitVertical,LucideSquareSquare:SquareSquare,LucideSquareStack:SquareStack,LucideSquareStar:SquareStar,LucideSquareStop:SquareStop,LucideSquareTerminal:SquareTerminal,LucideSquareUser:SquareUser,LucideSquareUserRound:SquareUserRound,LucideSquareX:SquareX,LucideSquaresExclude:SquaresExclude,LucideSquaresIntersect:SquaresIntersect,LucideSquaresSubtract:SquaresSubtract,LucideSquaresUnite:SquaresUnite,LucideSquircle:Squircle,LucideSquircleDashed:SquircleDashed,LucideSquirrel:Squirrel,LucideStamp:Stamp,LucideStar:Star,LucideStarHalf:StarHalf,LucideStarOff:StarOff,LucideStars:Sparkles,LucideStepBack:StepBack,LucideStepForward:StepForward,LucideStethoscope:Stethoscope,LucideSticker:Sticker,LucideStickyNote:StickyNote,LucideStopCircle:CircleStop,LucideStore:Store,LucideStretchHorizontal:StretchHorizontal,LucideStretchVertical:StretchVertical,LucideStrikethrough:Strikethrough,LucideSubscript:Subscript,LucideSubtitles:Captions,LucideSun:Sun,LucideSunDim:SunDim,LucideSunMedium:SunMedium,LucideSunMoon:SunMoon,LucideSunSnow:SunSnow,LucideSunrise:Sunrise,LucideSunset:Sunset,LucideSuperscript:Superscript,LucideSwatchBook:SwatchBook,LucideSwissFranc:SwissFranc,LucideSwitchCamera:SwitchCamera,LucideSword:Sword,LucideSwords:Swords,LucideSyringe:Syringe,LucideTable:Table,LucideTable2:Table2,LucideTableCellsMerge:TableCellsMerge,LucideTableCellsSplit:TableCellsSplit,LucideTableColumnsSplit:TableColumnsSplit,LucideTableConfig:Columns3Cog,LucideTableOfContents:TableOfContents$1,LucideTableProperties:TableProperties,LucideTableRowsSplit:TableRowsSplit,LucideTablet:Tablet,LucideTabletSmartphone:TabletSmartphone,LucideTablets:Tablets,LucideTag:Tag,LucideTags:Tags,LucideTally1:Tally1,LucideTally2:Tally2,LucideTally3:Tally3,LucideTally4:Tally4,LucideTally5:Tally5,LucideTangent:Tangent,LucideTarget:Target,LucideTelescope:Telescope,LucideTent:Tent,LucideTentTree:TentTree,LucideTerminal:Terminal,LucideTerminalSquare:SquareTerminal,LucideTestTube:TestTube,LucideTestTube2:TestTubeDiagonal,LucideTestTubeDiagonal:TestTubeDiagonal,LucideTestTubes:TestTubes,LucideText:TextAlignStart,LucideTextAlignCenter:TextAlignCenter,LucideTextAlignEnd:TextAlignEnd,LucideTextAlignJustify:TextAlignJustify,LucideTextAlignStart:TextAlignStart,LucideTextCursor:TextCursor,LucideTextCursorInput:TextCursorInput,LucideTextInitial:TextInitial,LucideTextQuote:TextQuote,LucideTextSearch:TextSearch,LucideTextSelect:TextSelect,LucideTextSelection:TextSelect,LucideTextWrap:TextWrap,LucideTheater:Theater,LucideThermometer:Thermometer,LucideThermometerSnowflake:ThermometerSnowflake,LucideThermometerSun:ThermometerSun,LucideThumbsDown:ThumbsDown,LucideThumbsUp:ThumbsUp,LucideTicket:Ticket,LucideTicketCheck:TicketCheck,LucideTicketMinus:TicketMinus,LucideTicketPercent:TicketPercent,LucideTicketPlus:TicketPlus,LucideTicketSlash:TicketSlash,LucideTicketX:TicketX,LucideTickets:Tickets,LucideTicketsPlane:TicketsPlane,LucideTimer:Timer$1,LucideTimerOff:TimerOff,LucideTimerReset:TimerReset,LucideToggleLeft:ToggleLeft,LucideToggleRight:ToggleRight,LucideToilet:Toilet,LucideToolCase:ToolCase,LucideTornado:Tornado,LucideTorus:Torus,LucideTouchpad:Touchpad,LucideTouchpadOff:TouchpadOff,LucideTowerControl:TowerControl,LucideToyBrick:ToyBrick,LucideTractor:Tractor,LucideTrafficCone:TrafficCone,LucideTrain:TramFront,LucideTrainFront:TrainFront,LucideTrainFrontTunnel:TrainFrontTunnel,LucideTrainTrack:TrainTrack,LucideTramFront:TramFront,LucideTransgender:Transgender,LucideTrash:Trash,LucideTrash2:Trash2,LucideTreeDeciduous:TreeDeciduous,LucideTreePalm:TreePalm,LucideTreePine:TreePine,LucideTrees:Trees,LucideTrello:Trello,LucideTrendingDown:TrendingDown,LucideTrendingUp:TrendingUp,LucideTrendingUpDown:TrendingUpDown,LucideTriangle:Triangle,LucideTriangleAlert:TriangleAlert,LucideTriangleDashed:TriangleDashed,LucideTriangleRight:TriangleRight,LucideTrophy:Trophy,LucideTruck:Truck,LucideTruckElectric:TruckElectric,LucideTurkishLira:TurkishLira,LucideTurntable:Turntable,LucideTurtle:Turtle,LucideTv:Tv,LucideTv2:TvMinimal,LucideTvMinimal:TvMinimal,LucideTvMinimalPlay:TvMinimalPlay,LucideTwitch:Twitch,LucideTwitter:Twitter,LucideType:Type$2,LucideTypeOutline:TypeOutline,LucideUmbrella:Umbrella,LucideUmbrellaOff:UmbrellaOff,LucideUnderline:Underline,LucideUndo:Undo,LucideUndo2:Undo2,LucideUndoDot:UndoDot,LucideUnfoldHorizontal:UnfoldHorizontal,LucideUnfoldVertical:UnfoldVertical,LucideUngroup:Ungroup,LucideUniversity:University,LucideUnlink:Unlink,LucideUnlink2:Unlink2,LucideUnlock:LockOpen,LucideUnlockKeyhole:LockKeyholeOpen,LucideUnplug:Unplug,LucideUpload:Upload,LucideUploadCloud:CloudUpload,LucideUsb:Usb,LucideUser:User,LucideUser2:UserRound,LucideUserCheck:UserCheck,LucideUserCheck2:UserRoundCheck,LucideUserCircle:CircleUser,LucideUserCircle2:CircleUserRound,LucideUserCog:UserCog,LucideUserCog2:UserRoundCog,LucideUserLock:UserLock,LucideUserMinus:UserMinus,LucideUserMinus2:UserRoundMinus,LucideUserPen:UserPen,LucideUserPlus:UserPlus,LucideUserPlus2:UserRoundPlus,LucideUserRound:UserRound,LucideUserRoundCheck:UserRoundCheck,LucideUserRoundCog:UserRoundCog,LucideUserRoundMinus:UserRoundMinus,LucideUserRoundPen:UserRoundPen,LucideUserRoundPlus:UserRoundPlus,LucideUserRoundSearch:UserRoundSearch,LucideUserRoundX:UserRoundX,LucideUserSearch:UserSearch,LucideUserSquare:SquareUser,LucideUserSquare2:SquareUserRound,LucideUserStar:UserStar,LucideUserX:UserX,LucideUserX2:UserRoundX,LucideUsers:Users,LucideUsers2:UsersRound,LucideUsersRound:UsersRound,LucideUtensils:Utensils,LucideUtensilsCrossed:UtensilsCrossed,LucideUtilityPole:UtilityPole,LucideVariable:Variable,LucideVault:Vault,LucideVectorSquare:VectorSquare,LucideVegan:Vegan,LucideVenetianMask:VenetianMask,LucideVenus:Venus,LucideVenusAndMars:VenusAndMars,LucideVerified:BadgeCheck,LucideVibrate:Vibrate,LucideVibrateOff:VibrateOff,LucideVideo:Video,LucideVideoOff:VideoOff,LucideVideotape:Videotape,LucideView:View,LucideVoicemail:Voicemail,LucideVolleyball:Volleyball,LucideVolume:Volume,LucideVolume1:Volume1,LucideVolume2:Volume2,LucideVolumeOff:VolumeOff,LucideVolumeX:VolumeX,LucideVote:Vote,LucideWallet:Wallet,LucideWallet2:WalletMinimal,LucideWalletCards:WalletCards,LucideWalletMinimal:WalletMinimal,LucideWallpaper:Wallpaper,LucideWand:Wand,LucideWand2:WandSparkles,LucideWandSparkles:WandSparkles,LucideWarehouse:Warehouse,LucideWashingMachine:WashingMachine,LucideWatch:Watch,LucideWaves:Waves,LucideWavesLadder:WavesLadder,LucideWaypoints:Waypoints,LucideWebcam:Webcam,LucideWebhook:Webhook,LucideWebhookOff:WebhookOff,LucideWeight:Weight,LucideWheat:Wheat,LucideWheatOff:WheatOff,LucideWholeWord:WholeWord,LucideWifi:Wifi,LucideWifiCog:WifiCog,LucideWifiHigh:WifiHigh,LucideWifiLow:WifiLow,LucideWifiOff:WifiOff,LucideWifiPen:WifiPen,LucideWifiSync:WifiSync,LucideWifiZero:WifiZero,LucideWind:Wind,LucideWindArrowDown:WindArrowDown,LucideWine:Wine,LucideWineOff:WineOff,LucideWorkflow:Workflow,LucideWorm:Worm,LucideWrapText:TextWrap,LucideWrench:Wrench,LucideX:X$3,LucideXCircle:CircleX,LucideXOctagon:OctagonX,LucideXSquare:SquareX,LucideYoutube:Youtube,LucideZap:Zap,LucideZapOff:ZapOff,LucideZoomIn:ZoomIn,LucideZoomOut:ZoomOut,Luggage,LuggageIcon:Luggage,MSquare:SquareM,MSquareIcon:SquareM,Magnet,MagnetIcon:Magnet,Mail,MailCheck,MailCheckIcon:MailCheck,MailIcon:Mail,MailMinus,MailMinusIcon:MailMinus,MailOpen,MailOpenIcon:MailOpen,MailPlus,MailPlusIcon:MailPlus,MailQuestion:MailQuestionMark,MailQuestionIcon:MailQuestionMark,MailQuestionMark,MailQuestionMarkIcon:MailQuestionMark,MailSearch,MailSearchIcon:MailSearch,MailWarning,MailWarningIcon:MailWarning,MailX,MailXIcon:MailX,Mailbox,MailboxIcon:Mailbox,Mails,MailsIcon:Mails,Map:Map$2,MapIcon:Map$2,MapMinus,MapMinusIcon:MapMinus,MapPin,MapPinCheck,MapPinCheckIcon:MapPinCheck,MapPinCheckInside,MapPinCheckInsideIcon:MapPinCheckInside,MapPinHouse,MapPinHouseIcon:MapPinHouse,MapPinIcon:MapPin,MapPinMinus,MapPinMinusIcon:MapPinMinus,MapPinMinusInside,MapPinMinusInsideIcon:MapPinMinusInside,MapPinOff,MapPinOffIcon:MapPinOff,MapPinPen,MapPinPenIcon:MapPinPen,MapPinPlus,MapPinPlusIcon:MapPinPlus,MapPinPlusInside,MapPinPlusInsideIcon:MapPinPlusInside,MapPinX,MapPinXIcon:MapPinX,MapPinXInside,MapPinXInsideIcon:MapPinXInside,MapPinned,MapPinnedIcon:MapPinned,MapPlus,MapPlusIcon:MapPlus,Mars,MarsIcon:Mars,MarsStroke,MarsStrokeIcon:MarsStroke,Martini,MartiniIcon:Martini,Maximize,Maximize2,Maximize2Icon:Maximize2,MaximizeIcon:Maximize,Medal,MedalIcon:Medal,Megaphone,MegaphoneIcon:Megaphone,MegaphoneOff,MegaphoneOffIcon:MegaphoneOff,Meh,MehIcon:Meh,MemoryStick,MemoryStickIcon:MemoryStick,Menu,MenuIcon:Menu,MenuSquare:SquareMenu,MenuSquareIcon:SquareMenu,Merge,MergeIcon:Merge,MessageCircle,MessageCircleCode,MessageCircleCodeIcon:MessageCircleCode,MessageCircleDashed,MessageCircleDashedIcon:MessageCircleDashed,MessageCircleHeart,MessageCircleHeartIcon:MessageCircleHeart,MessageCircleIcon:MessageCircle,MessageCircleMore,MessageCircleMoreIcon:MessageCircleMore,MessageCircleOff,MessageCircleOffIcon:MessageCircleOff,MessageCirclePlus,MessageCirclePlusIcon:MessageCirclePlus,MessageCircleQuestion:MessageCircleQuestionMark,MessageCircleQuestionIcon:MessageCircleQuestionMark,MessageCircleQuestionMark,MessageCircleQuestionMarkIcon:MessageCircleQuestionMark,MessageCircleReply,MessageCircleReplyIcon:MessageCircleReply,MessageCircleWarning,MessageCircleWarningIcon:MessageCircleWarning,MessageCircleX,MessageCircleXIcon:MessageCircleX,MessageSquare,MessageSquareCode,MessageSquareCodeIcon:MessageSquareCode,MessageSquareDashed,MessageSquareDashedIcon:MessageSquareDashed,MessageSquareDiff,MessageSquareDiffIcon:MessageSquareDiff,MessageSquareDot,MessageSquareDotIcon:MessageSquareDot,MessageSquareHeart,MessageSquareHeartIcon:MessageSquareHeart,MessageSquareIcon:MessageSquare,MessageSquareLock,MessageSquareLockIcon:MessageSquareLock,MessageSquareMore,MessageSquareMoreIcon:MessageSquareMore,MessageSquareOff,MessageSquareOffIcon:MessageSquareOff,MessageSquarePlus,MessageSquarePlusIcon:MessageSquarePlus,MessageSquareQuote,MessageSquareQuoteIcon:MessageSquareQuote,MessageSquareReply,MessageSquareReplyIcon:MessageSquareReply,MessageSquareShare,MessageSquareShareIcon:MessageSquareShare,MessageSquareText,MessageSquareTextIcon:MessageSquareText,MessageSquareWarning,MessageSquareWarningIcon:MessageSquareWarning,MessageSquareX,MessageSquareXIcon:MessageSquareX,MessagesSquare,MessagesSquareIcon:MessagesSquare,Mic,Mic2:MicVocal,Mic2Icon:MicVocal,MicIcon:Mic,MicOff,MicOffIcon:MicOff,MicVocal,MicVocalIcon:MicVocal,Microchip,MicrochipIcon:Microchip,Microscope,MicroscopeIcon:Microscope,Microwave,MicrowaveIcon:Microwave,Milestone,MilestoneIcon:Milestone,Milk,MilkIcon:Milk,MilkOff,MilkOffIcon:MilkOff,Minimize,Minimize2,Minimize2Icon:Minimize2,MinimizeIcon:Minimize,Minus,MinusCircle:CircleMinus,MinusCircleIcon:CircleMinus,MinusIcon:Minus,MinusSquare:SquareMinus,MinusSquareIcon:SquareMinus,Monitor,MonitorCheck,MonitorCheckIcon:MonitorCheck,MonitorCloud,MonitorCloudIcon:MonitorCloud,MonitorCog,MonitorCogIcon:MonitorCog,MonitorDot,MonitorDotIcon:MonitorDot,MonitorDown,MonitorDownIcon:MonitorDown,MonitorIcon:Monitor,MonitorOff,MonitorOffIcon:MonitorOff,MonitorPause,MonitorPauseIcon:MonitorPause,MonitorPlay,MonitorPlayIcon:MonitorPlay,MonitorSmartphone,MonitorSmartphoneIcon:MonitorSmartphone,MonitorSpeaker,MonitorSpeakerIcon:MonitorSpeaker,MonitorStop,MonitorStopIcon:MonitorStop,MonitorUp,MonitorUpIcon:MonitorUp,MonitorX,MonitorXIcon:MonitorX,Moon,MoonIcon:Moon,MoonStar,MoonStarIcon:MoonStar,MoreHorizontal:Ellipsis,MoreHorizontalIcon:Ellipsis,MoreVertical:EllipsisVertical,MoreVerticalIcon:EllipsisVertical,Motorbike,MotorbikeIcon:Motorbike,Mountain,MountainIcon:Mountain,MountainSnow,MountainSnowIcon:MountainSnow,Mouse,MouseIcon:Mouse,MouseOff,MouseOffIcon:MouseOff,MousePointer,MousePointer2,MousePointer2Icon:MousePointer2,MousePointer2Off,MousePointer2OffIcon:MousePointer2Off,MousePointerBan,MousePointerBanIcon:MousePointerBan,MousePointerClick,MousePointerClickIcon:MousePointerClick,MousePointerIcon:MousePointer,MousePointerSquareDashed:SquareDashedMousePointer,MousePointerSquareDashedIcon:SquareDashedMousePointer,Move,Move3D:Move3d,Move3DIcon:Move3d,Move3d,Move3dIcon:Move3d,MoveDiagonal,MoveDiagonal2,MoveDiagonal2Icon:MoveDiagonal2,MoveDiagonalIcon:MoveDiagonal,MoveDown,MoveDownIcon:MoveDown,MoveDownLeft,MoveDownLeftIcon:MoveDownLeft,MoveDownRight,MoveDownRightIcon:MoveDownRight,MoveHorizontal,MoveHorizontalIcon:MoveHorizontal,MoveIcon:Move,MoveLeft,MoveLeftIcon:MoveLeft,MoveRight,MoveRightIcon:MoveRight,MoveUp,MoveUpIcon:MoveUp,MoveUpLeft,MoveUpLeftIcon:MoveUpLeft,MoveUpRight,MoveUpRightIcon:MoveUpRight,MoveVertical,MoveVerticalIcon:MoveVertical,Music,Music2,Music2Icon:Music2,Music3,Music3Icon:Music3,Music4,Music4Icon:Music4,MusicIcon:Music,Navigation,Navigation2,Navigation2Icon:Navigation2,Navigation2Off,Navigation2OffIcon:Navigation2Off,NavigationIcon:Navigation,NavigationOff,NavigationOffIcon:NavigationOff,Network,NetworkIcon:Network,Newspaper,NewspaperIcon:Newspaper,Nfc,NfcIcon:Nfc,NonBinary,NonBinaryIcon:NonBinary,Notebook,NotebookIcon:Notebook,NotebookPen,NotebookPenIcon:NotebookPen,NotebookTabs,NotebookTabsIcon:NotebookTabs,NotebookText,NotebookTextIcon:NotebookText,NotepadText,NotepadTextDashed,NotepadTextDashedIcon:NotepadTextDashed,NotepadTextIcon:NotepadText,Nut,NutIcon:Nut,NutOff,NutOffIcon:NutOff,Octagon,OctagonAlert,OctagonAlertIcon:OctagonAlert,OctagonIcon:Octagon,OctagonMinus,OctagonMinusIcon:OctagonMinus,OctagonPause,OctagonPauseIcon:OctagonPause,OctagonX,OctagonXIcon:OctagonX,Omega,OmegaIcon:Omega,Option,OptionIcon:Option,Orbit,OrbitIcon:Orbit,Origami,OrigamiIcon:Origami,Outdent:ListIndentDecrease,OutdentIcon:ListIndentDecrease,Package,Package2,Package2Icon:Package2,PackageCheck,PackageCheckIcon:PackageCheck,PackageIcon:Package,PackageMinus,PackageMinusIcon:PackageMinus,PackageOpen,PackageOpenIcon:PackageOpen,PackagePlus,PackagePlusIcon:PackagePlus,PackageSearch,PackageSearchIcon:PackageSearch,PackageX,PackageXIcon:PackageX,PaintBucket,PaintBucketIcon:PaintBucket,PaintRoller,PaintRollerIcon:PaintRoller,Paintbrush,Paintbrush2:PaintbrushVertical,Paintbrush2Icon:PaintbrushVertical,PaintbrushIcon:Paintbrush,PaintbrushVertical,PaintbrushVerticalIcon:PaintbrushVertical,Palette,PaletteIcon:Palette,Palmtree:TreePalm,PalmtreeIcon:TreePalm,Panda,PandaIcon:Panda,PanelBottom,PanelBottomClose,PanelBottomCloseIcon:PanelBottomClose,PanelBottomDashed,PanelBottomDashedIcon:PanelBottomDashed,PanelBottomIcon:PanelBottom,PanelBottomInactive:PanelBottomDashed,PanelBottomInactiveIcon:PanelBottomDashed,PanelBottomOpen,PanelBottomOpenIcon:PanelBottomOpen,PanelLeft,PanelLeftClose,PanelLeftCloseIcon:PanelLeftClose,PanelLeftDashed,PanelLeftDashedIcon:PanelLeftDashed,PanelLeftIcon:PanelLeft,PanelLeftInactive:PanelLeftDashed,PanelLeftInactiveIcon:PanelLeftDashed,PanelLeftOpen,PanelLeftOpenIcon:PanelLeftOpen,PanelLeftRightDashed,PanelLeftRightDashedIcon:PanelLeftRightDashed,PanelRight,PanelRightClose,PanelRightCloseIcon:PanelRightClose,PanelRightDashed,PanelRightDashedIcon:PanelRightDashed,PanelRightIcon:PanelRight,PanelRightInactive:PanelRightDashed,PanelRightInactiveIcon:PanelRightDashed,PanelRightOpen,PanelRightOpenIcon:PanelRightOpen,PanelTop,PanelTopBottomDashed,PanelTopBottomDashedIcon:PanelTopBottomDashed,PanelTopClose,PanelTopCloseIcon:PanelTopClose,PanelTopDashed,PanelTopDashedIcon:PanelTopDashed,PanelTopIcon:PanelTop,PanelTopInactive:PanelTopDashed,PanelTopInactiveIcon:PanelTopDashed,PanelTopOpen,PanelTopOpenIcon:PanelTopOpen,PanelsLeftBottom,PanelsLeftBottomIcon:PanelsLeftBottom,PanelsLeftRight:Columns3,PanelsLeftRightIcon:Columns3,PanelsRightBottom,PanelsRightBottomIcon:PanelsRightBottom,PanelsTopBottom:Rows3,PanelsTopBottomIcon:Rows3,PanelsTopLeft,PanelsTopLeftIcon:PanelsTopLeft,Paperclip,PaperclipIcon:Paperclip,Parentheses,ParenthesesIcon:Parentheses,ParkingCircle:CircleParking,ParkingCircleIcon:CircleParking,ParkingCircleOff:CircleParkingOff,ParkingCircleOffIcon:CircleParkingOff,ParkingMeter,ParkingMeterIcon:ParkingMeter,ParkingSquare:SquareParking,ParkingSquareIcon:SquareParking,ParkingSquareOff:SquareParkingOff,ParkingSquareOffIcon:SquareParkingOff,PartyPopper,PartyPopperIcon:PartyPopper,Pause,PauseCircle:CirclePause,PauseCircleIcon:CirclePause,PauseIcon:Pause,PauseOctagon:OctagonPause,PauseOctagonIcon:OctagonPause,PawPrint,PawPrintIcon:PawPrint,PcCase,PcCaseIcon:PcCase,Pen,PenBox:SquarePen,PenBoxIcon:SquarePen,PenIcon:Pen,PenLine,PenLineIcon:PenLine,PenOff,PenOffIcon:PenOff,PenSquare:SquarePen,PenSquareIcon:SquarePen,PenTool,PenToolIcon:PenTool,Pencil,PencilIcon:Pencil,PencilLine,PencilLineIcon:PencilLine,PencilOff,PencilOffIcon:PencilOff,PencilRuler,PencilRulerIcon:PencilRuler,Pentagon,PentagonIcon:Pentagon,Percent,PercentCircle:CirclePercent,PercentCircleIcon:CirclePercent,PercentDiamond:DiamondPercent,PercentDiamondIcon:DiamondPercent,PercentIcon:Percent,PercentSquare:SquarePercent,PercentSquareIcon:SquarePercent,PersonStanding,PersonStandingIcon:PersonStanding,PhilippinePeso,PhilippinePesoIcon:PhilippinePeso,Phone,PhoneCall,PhoneCallIcon:PhoneCall,PhoneForwarded,PhoneForwardedIcon:PhoneForwarded,PhoneIcon:Phone,PhoneIncoming,PhoneIncomingIcon:PhoneIncoming,PhoneMissed,PhoneMissedIcon:PhoneMissed,PhoneOff,PhoneOffIcon:PhoneOff,PhoneOutgoing,PhoneOutgoingIcon:PhoneOutgoing,Pi,PiIcon:Pi,PiSquare:SquarePi,PiSquareIcon:SquarePi,Piano,PianoIcon:Piano,Pickaxe,PickaxeIcon:Pickaxe,PictureInPicture,PictureInPicture2,PictureInPicture2Icon:PictureInPicture2,PictureInPictureIcon:PictureInPicture,PieChart:ChartPie,PieChartIcon:ChartPie,PiggyBank,PiggyBankIcon:PiggyBank,Pilcrow,PilcrowIcon:Pilcrow,PilcrowLeft,PilcrowLeftIcon:PilcrowLeft,PilcrowRight,PilcrowRightIcon:PilcrowRight,PilcrowSquare:SquarePilcrow,PilcrowSquareIcon:SquarePilcrow,Pill,PillBottle,PillBottleIcon:PillBottle,PillIcon:Pill,Pin,PinIcon:Pin,PinOff,PinOffIcon:PinOff,Pipette,PipetteIcon:Pipette,Pizza,PizzaIcon:Pizza,Plane,PlaneIcon:Plane,PlaneLanding,PlaneLandingIcon:PlaneLanding,PlaneTakeoff,PlaneTakeoffIcon:PlaneTakeoff,Play,PlayCircle:CirclePlay,PlayCircleIcon:CirclePlay,PlayIcon:Play,PlaySquare:SquarePlay,PlaySquareIcon:SquarePlay,Plug,Plug2,Plug2Icon:Plug2,PlugIcon:Plug,PlugZap,PlugZap2:PlugZap,PlugZap2Icon:PlugZap,PlugZapIcon:PlugZap,Plus,PlusCircle:CirclePlus,PlusCircleIcon:CirclePlus,PlusIcon:Plus,PlusSquare:SquarePlus,PlusSquareIcon:SquarePlus,Pocket,PocketIcon:Pocket,PocketKnife,PocketKnifeIcon:PocketKnife,Podcast,PodcastIcon:Podcast,Pointer,PointerIcon:Pointer,PointerOff,PointerOffIcon:PointerOff,Popcorn,PopcornIcon:Popcorn,Popsicle,PopsicleIcon:Popsicle,PoundSterling,PoundSterlingIcon:PoundSterling,Power,PowerCircle:CirclePower,PowerCircleIcon:CirclePower,PowerIcon:Power,PowerOff,PowerOffIcon:PowerOff,PowerSquare:SquarePower,PowerSquareIcon:SquarePower,Presentation,PresentationIcon:Presentation,Printer,PrinterCheck,PrinterCheckIcon:PrinterCheck,PrinterIcon:Printer,Projector,ProjectorIcon:Projector,Proportions,ProportionsIcon:Proportions,Puzzle,PuzzleIcon:Puzzle,Pyramid,PyramidIcon:Pyramid,QrCode,QrCodeIcon:QrCode,Quote,QuoteIcon:Quote,Rabbit,RabbitIcon:Rabbit,Radar,RadarIcon:Radar,Radiation,RadiationIcon:Radiation,Radical,RadicalIcon:Radical,Radio,RadioIcon:Radio,RadioReceiver,RadioReceiverIcon:RadioReceiver,RadioTower,RadioTowerIcon:RadioTower,Radius,RadiusIcon:Radius,RailSymbol,RailSymbolIcon:RailSymbol,Rainbow,RainbowIcon:Rainbow,Rat,RatIcon:Rat,Ratio,RatioIcon:Ratio,Receipt,ReceiptCent,ReceiptCentIcon:ReceiptCent,ReceiptEuro,ReceiptEuroIcon:ReceiptEuro,ReceiptIcon:Receipt,ReceiptIndianRupee,ReceiptIndianRupeeIcon:ReceiptIndianRupee,ReceiptJapaneseYen,ReceiptJapaneseYenIcon:ReceiptJapaneseYen,ReceiptPoundSterling,ReceiptPoundSterlingIcon:ReceiptPoundSterling,ReceiptRussianRuble,ReceiptRussianRubleIcon:ReceiptRussianRuble,ReceiptSwissFranc,ReceiptSwissFrancIcon:ReceiptSwissFranc,ReceiptText,ReceiptTextIcon:ReceiptText,ReceiptTurkishLira,ReceiptTurkishLiraIcon:ReceiptTurkishLira,RectangleCircle,RectangleCircleIcon:RectangleCircle,RectangleEllipsis,RectangleEllipsisIcon:RectangleEllipsis,RectangleGoggles,RectangleGogglesIcon:RectangleGoggles,RectangleHorizontal,RectangleHorizontalIcon:RectangleHorizontal,RectangleVertical,RectangleVerticalIcon:RectangleVertical,Recycle,RecycleIcon:Recycle,Redo,Redo2,Redo2Icon:Redo2,RedoDot,RedoDotIcon:RedoDot,RedoIcon:Redo,RefreshCcw,RefreshCcwDot,RefreshCcwDotIcon:RefreshCcwDot,RefreshCcwIcon:RefreshCcw,RefreshCw,RefreshCwIcon:RefreshCw,RefreshCwOff,RefreshCwOffIcon:RefreshCwOff,Refrigerator,RefrigeratorIcon:Refrigerator,Regex,RegexIcon:Regex,RemoveFormatting,RemoveFormattingIcon:RemoveFormatting,Repeat,Repeat1,Repeat1Icon:Repeat1,Repeat2,Repeat2Icon:Repeat2,RepeatIcon:Repeat,Replace,ReplaceAll,ReplaceAllIcon:ReplaceAll,ReplaceIcon:Replace,Reply,ReplyAll,ReplyAllIcon:ReplyAll,ReplyIcon:Reply,Rewind,RewindIcon:Rewind,Ribbon,RibbonIcon:Ribbon,Rocket,RocketIcon:Rocket,RockingChair,RockingChairIcon:RockingChair,RollerCoaster,RollerCoasterIcon:RollerCoaster,Rose,RoseIcon:Rose,Rotate3D:Rotate3d,Rotate3DIcon:Rotate3d,Rotate3d,Rotate3dIcon:Rotate3d,RotateCcw,RotateCcwIcon:RotateCcw,RotateCcwKey,RotateCcwKeyIcon:RotateCcwKey,RotateCcwSquare,RotateCcwSquareIcon:RotateCcwSquare,RotateCw,RotateCwIcon:RotateCw,RotateCwSquare,RotateCwSquareIcon:RotateCwSquare,Route,RouteIcon:Route,RouteOff,RouteOffIcon:RouteOff,Router,RouterIcon:Router,Rows:Rows2,Rows2,Rows2Icon:Rows2,Rows3,Rows3Icon:Rows3,Rows4,Rows4Icon:Rows4,RowsIcon:Rows2,Rss,RssIcon:Rss,Ruler,RulerDimensionLine,RulerDimensionLineIcon:RulerDimensionLine,RulerIcon:Ruler,RussianRuble,RussianRubleIcon:RussianRuble,Sailboat,SailboatIcon:Sailboat,Salad,SaladIcon:Salad,Sandwich,SandwichIcon:Sandwich,Satellite,SatelliteDish,SatelliteDishIcon:SatelliteDish,SatelliteIcon:Satellite,SaudiRiyal,SaudiRiyalIcon:SaudiRiyal,Save,SaveAll,SaveAllIcon:SaveAll,SaveIcon:Save,SaveOff,SaveOffIcon:SaveOff,Scale,Scale3D:Scale3d,Scale3DIcon:Scale3d,Scale3d,Scale3dIcon:Scale3d,ScaleIcon:Scale,Scaling,ScalingIcon:Scaling,Scan,ScanBarcode,ScanBarcodeIcon:ScanBarcode,ScanEye,ScanEyeIcon:ScanEye,ScanFace,ScanFaceIcon:ScanFace,ScanHeart,ScanHeartIcon:ScanHeart,ScanIcon:Scan,ScanLine,ScanLineIcon:ScanLine,ScanQrCode,ScanQrCodeIcon:ScanQrCode,ScanSearch,ScanSearchIcon:ScanSearch,ScanText,ScanTextIcon:ScanText,ScatterChart:ChartScatter,ScatterChartIcon:ChartScatter,School,School2:University,School2Icon:University,SchoolIcon:School,Scissors,ScissorsIcon:Scissors,ScissorsLineDashed,ScissorsLineDashedIcon:ScissorsLineDashed,ScissorsSquare:SquareScissors,ScissorsSquareDashedBottom:SquareBottomDashedScissors,ScissorsSquareDashedBottomIcon:SquareBottomDashedScissors,ScissorsSquareIcon:SquareScissors,ScreenShare,ScreenShareIcon:ScreenShare,ScreenShareOff,ScreenShareOffIcon:ScreenShareOff,Scroll,ScrollIcon:Scroll,ScrollText,ScrollTextIcon:ScrollText,Search,SearchCheck,SearchCheckIcon:SearchCheck,SearchCode,SearchCodeIcon:SearchCode,SearchIcon:Search,SearchSlash,SearchSlashIcon:SearchSlash,SearchX,SearchXIcon:SearchX,Section,SectionIcon:Section,Send,SendHorizonal:SendHorizontal,SendHorizonalIcon:SendHorizontal,SendHorizontal,SendHorizontalIcon:SendHorizontal,SendIcon:Send,SendToBack,SendToBackIcon:SendToBack,SeparatorHorizontal,SeparatorHorizontalIcon:SeparatorHorizontal,SeparatorVertical,SeparatorVerticalIcon:SeparatorVertical,Server,ServerCog,ServerCogIcon:ServerCog,ServerCrash,ServerCrashIcon:ServerCrash,ServerIcon:Server,ServerOff,ServerOffIcon:ServerOff,Settings,Settings2,Settings2Icon:Settings2,SettingsIcon:Settings,Shapes,ShapesIcon:Shapes,Share,Share2,Share2Icon:Share2,ShareIcon:Share,Sheet,SheetIcon:Sheet,Shell,ShellIcon:Shell,Shield,ShieldAlert,ShieldAlertIcon:ShieldAlert,ShieldBan,ShieldBanIcon:ShieldBan,ShieldCheck,ShieldCheckIcon:ShieldCheck,ShieldClose:ShieldX,ShieldCloseIcon:ShieldX,ShieldEllipsis,ShieldEllipsisIcon:ShieldEllipsis,ShieldHalf,ShieldHalfIcon:ShieldHalf,ShieldIcon:Shield,ShieldMinus,ShieldMinusIcon:ShieldMinus,ShieldOff,ShieldOffIcon:ShieldOff,ShieldPlus,ShieldPlusIcon:ShieldPlus,ShieldQuestion:ShieldQuestionMark,ShieldQuestionIcon:ShieldQuestionMark,ShieldQuestionMark,ShieldQuestionMarkIcon:ShieldQuestionMark,ShieldUser,ShieldUserIcon:ShieldUser,ShieldX,ShieldXIcon:ShieldX,Ship,ShipIcon:Ship,ShipWheel,ShipWheelIcon:ShipWheel,Shirt,ShirtIcon:Shirt,ShoppingBag,ShoppingBagIcon:ShoppingBag,ShoppingBasket,ShoppingBasketIcon:ShoppingBasket,ShoppingCart,ShoppingCartIcon:ShoppingCart,Shovel,ShovelIcon:Shovel,ShowerHead,ShowerHeadIcon:ShowerHead,Shredder,ShredderIcon:Shredder,Shrimp,ShrimpIcon:Shrimp,Shrink,ShrinkIcon:Shrink,Shrub,ShrubIcon:Shrub,Shuffle,ShuffleIcon:Shuffle,Sidebar:PanelLeft,SidebarClose:PanelLeftClose,SidebarCloseIcon:PanelLeftClose,SidebarIcon:PanelLeft,SidebarOpen:PanelLeftOpen,SidebarOpenIcon:PanelLeftOpen,Sigma,SigmaIcon:Sigma,SigmaSquare:SquareSigma,SigmaSquareIcon:SquareSigma,Signal,SignalHigh,SignalHighIcon:SignalHigh,SignalIcon:Signal,SignalLow,SignalLowIcon:SignalLow,SignalMedium,SignalMediumIcon:SignalMedium,SignalZero,SignalZeroIcon:SignalZero,Signature,SignatureIcon:Signature,Signpost,SignpostBig,SignpostBigIcon:SignpostBig,SignpostIcon:Signpost,Siren,SirenIcon:Siren,SkipBack,SkipBackIcon:SkipBack,SkipForward,SkipForwardIcon:SkipForward,Skull,SkullIcon:Skull,Slack,SlackIcon:Slack,Slash,SlashIcon:Slash,SlashSquare:SquareSlash,SlashSquareIcon:SquareSlash,Slice,SliceIcon:Slice,Sliders:SlidersVertical,SlidersHorizontal,SlidersHorizontalIcon:SlidersHorizontal,SlidersIcon:SlidersVertical,SlidersVertical,SlidersVerticalIcon:SlidersVertical,Smartphone,SmartphoneCharging,SmartphoneChargingIcon:SmartphoneCharging,SmartphoneIcon:Smartphone,SmartphoneNfc,SmartphoneNfcIcon:SmartphoneNfc,Smile,SmileIcon:Smile,SmilePlus,SmilePlusIcon:SmilePlus,Snail,SnailIcon:Snail,Snowflake,SnowflakeIcon:Snowflake,SoapDispenserDroplet,SoapDispenserDropletIcon:SoapDispenserDroplet,Sofa,SofaIcon:Sofa,SolarPanel,SolarPanelIcon:SolarPanel,SortAsc:ArrowUpNarrowWide,SortAscIcon:ArrowUpNarrowWide,SortDesc:ArrowDownWideNarrow,SortDescIcon:ArrowDownWideNarrow,Soup,SoupIcon:Soup,Space,SpaceIcon:Space,Spade,SpadeIcon:Spade,Sparkle,SparkleIcon:Sparkle,Sparkles,SparklesIcon:Sparkles,Speaker,SpeakerIcon:Speaker,Speech,SpeechIcon:Speech,SpellCheck,SpellCheck2,SpellCheck2Icon:SpellCheck2,SpellCheckIcon:SpellCheck,Spline,SplineIcon:Spline,SplinePointer,SplinePointerIcon:SplinePointer,Split,SplitIcon:Split,SplitSquareHorizontal:SquareSplitHorizontal,SplitSquareHorizontalIcon:SquareSplitHorizontal,SplitSquareVertical:SquareSplitVertical,SplitSquareVerticalIcon:SquareSplitVertical,Spool,SpoolIcon:Spool,Spotlight,SpotlightIcon:Spotlight,SprayCan,SprayCanIcon:SprayCan,Sprout,SproutIcon:Sprout,Square,SquareActivity,SquareActivityIcon:SquareActivity,SquareArrowDown,SquareArrowDownIcon:SquareArrowDown,SquareArrowDownLeft,SquareArrowDownLeftIcon:SquareArrowDownLeft,SquareArrowDownRight,SquareArrowDownRightIcon:SquareArrowDownRight,SquareArrowLeft,SquareArrowLeftIcon:SquareArrowLeft,SquareArrowOutDownLeft,SquareArrowOutDownLeftIcon:SquareArrowOutDownLeft,SquareArrowOutDownRight,SquareArrowOutDownRightIcon:SquareArrowOutDownRight,SquareArrowOutUpLeft,SquareArrowOutUpLeftIcon:SquareArrowOutUpLeft,SquareArrowOutUpRight,SquareArrowOutUpRightIcon:SquareArrowOutUpRight,SquareArrowRight,SquareArrowRightIcon:SquareArrowRight,SquareArrowUp,SquareArrowUpIcon:SquareArrowUp,SquareArrowUpLeft,SquareArrowUpLeftIcon:SquareArrowUpLeft,SquareArrowUpRight,SquareArrowUpRightIcon:SquareArrowUpRight,SquareAsterisk,SquareAsteriskIcon:SquareAsterisk,SquareBottomDashedScissors,SquareBottomDashedScissorsIcon:SquareBottomDashedScissors,SquareChartGantt,SquareChartGanttIcon:SquareChartGantt,SquareCheck,SquareCheckBig,SquareCheckBigIcon:SquareCheckBig,SquareCheckIcon:SquareCheck,SquareChevronDown,SquareChevronDownIcon:SquareChevronDown,SquareChevronLeft,SquareChevronLeftIcon:SquareChevronLeft,SquareChevronRight,SquareChevronRightIcon:SquareChevronRight,SquareChevronUp,SquareChevronUpIcon:SquareChevronUp,SquareCode,SquareCodeIcon:SquareCode,SquareDashed,SquareDashedBottom,SquareDashedBottomCode,SquareDashedBottomCodeIcon:SquareDashedBottomCode,SquareDashedBottomIcon:SquareDashedBottom,SquareDashedIcon:SquareDashed,SquareDashedKanban,SquareDashedKanbanIcon:SquareDashedKanban,SquareDashedMousePointer,SquareDashedMousePointerIcon:SquareDashedMousePointer,SquareDashedTopSolid,SquareDashedTopSolidIcon:SquareDashedTopSolid,SquareDivide,SquareDivideIcon:SquareDivide,SquareDot,SquareDotIcon:SquareDot,SquareEqual,SquareEqualIcon:SquareEqual,SquareFunction,SquareFunctionIcon:SquareFunction,SquareGanttChart:SquareChartGantt,SquareGanttChartIcon:SquareChartGantt,SquareIcon:Square,SquareKanban,SquareKanbanIcon:SquareKanban,SquareLibrary,SquareLibraryIcon:SquareLibrary,SquareM,SquareMIcon:SquareM,SquareMenu,SquareMenuIcon:SquareMenu,SquareMinus,SquareMinusIcon:SquareMinus,SquareMousePointer,SquareMousePointerIcon:SquareMousePointer,SquareParking,SquareParkingIcon:SquareParking,SquareParkingOff,SquareParkingOffIcon:SquareParkingOff,SquarePause,SquarePauseIcon:SquarePause,SquarePen,SquarePenIcon:SquarePen,SquarePercent,SquarePercentIcon:SquarePercent,SquarePi,SquarePiIcon:SquarePi,SquarePilcrow,SquarePilcrowIcon:SquarePilcrow,SquarePlay,SquarePlayIcon:SquarePlay,SquarePlus,SquarePlusIcon:SquarePlus,SquarePower,SquarePowerIcon:SquarePower,SquareRadical,SquareRadicalIcon:SquareRadical,SquareRoundCorner,SquareRoundCornerIcon:SquareRoundCorner,SquareScissors,SquareScissorsIcon:SquareScissors,SquareSigma,SquareSigmaIcon:SquareSigma,SquareSlash,SquareSlashIcon:SquareSlash,SquareSplitHorizontal,SquareSplitHorizontalIcon:SquareSplitHorizontal,SquareSplitVertical,SquareSplitVerticalIcon:SquareSplitVertical,SquareSquare,SquareSquareIcon:SquareSquare,SquareStack,SquareStackIcon:SquareStack,SquareStar,SquareStarIcon:SquareStar,SquareStop,SquareStopIcon:SquareStop,SquareTerminal,SquareTerminalIcon:SquareTerminal,SquareUser,SquareUserIcon:SquareUser,SquareUserRound,SquareUserRoundIcon:SquareUserRound,SquareX,SquareXIcon:SquareX,SquaresExclude,SquaresExcludeIcon:SquaresExclude,SquaresIntersect,SquaresIntersectIcon:SquaresIntersect,SquaresSubtract,SquaresSubtractIcon:SquaresSubtract,SquaresUnite,SquaresUniteIcon:SquaresUnite,Squircle,SquircleDashed,SquircleDashedIcon:SquircleDashed,SquircleIcon:Squircle,Squirrel,SquirrelIcon:Squirrel,Stamp,StampIcon:Stamp,Star,StarHalf,StarHalfIcon:StarHalf,StarIcon:Star,StarOff,StarOffIcon:StarOff,Stars:Sparkles,StarsIcon:Sparkles,StepBack,StepBackIcon:StepBack,StepForward,StepForwardIcon:StepForward,Stethoscope,StethoscopeIcon:Stethoscope,Sticker,StickerIcon:Sticker,StickyNote,StickyNoteIcon:StickyNote,StopCircle:CircleStop,StopCircleIcon:CircleStop,Store,StoreIcon:Store,StretchHorizontal,StretchHorizontalIcon:StretchHorizontal,StretchVertical,StretchVerticalIcon:StretchVertical,Strikethrough,StrikethroughIcon:Strikethrough,Subscript,SubscriptIcon:Subscript,Subtitles:Captions,SubtitlesIcon:Captions,Sun,SunDim,SunDimIcon:SunDim,SunIcon:Sun,SunMedium,SunMediumIcon:SunMedium,SunMoon,SunMoonIcon:SunMoon,SunSnow,SunSnowIcon:SunSnow,Sunrise,SunriseIcon:Sunrise,Sunset,SunsetIcon:Sunset,Superscript,SuperscriptIcon:Superscript,SwatchBook,SwatchBookIcon:SwatchBook,SwissFranc,SwissFrancIcon:SwissFranc,SwitchCamera,SwitchCameraIcon:SwitchCamera,Sword,SwordIcon:Sword,Swords,SwordsIcon:Swords,Syringe,SyringeIcon:Syringe,Table,Table2,Table2Icon:Table2,TableCellsMerge,TableCellsMergeIcon:TableCellsMerge,TableCellsSplit,TableCellsSplitIcon:TableCellsSplit,TableColumnsSplit,TableColumnsSplitIcon:TableColumnsSplit,TableConfig:Columns3Cog,TableConfigIcon:Columns3Cog,TableIcon:Table,TableOfContents:TableOfContents$1,TableOfContentsIcon:TableOfContents$1,TableProperties,TablePropertiesIcon:TableProperties,TableRowsSplit,TableRowsSplitIcon:TableRowsSplit,Tablet,TabletIcon:Tablet,TabletSmartphone,TabletSmartphoneIcon:TabletSmartphone,Tablets,TabletsIcon:Tablets,Tag,TagIcon:Tag,Tags,TagsIcon:Tags,Tally1,Tally1Icon:Tally1,Tally2,Tally2Icon:Tally2,Tally3,Tally3Icon:Tally3,Tally4,Tally4Icon:Tally4,Tally5,Tally5Icon:Tally5,Tangent,TangentIcon:Tangent,Target,TargetIcon:Target,Telescope,TelescopeIcon:Telescope,Tent,TentIcon:Tent,TentTree,TentTreeIcon:TentTree,Terminal,TerminalIcon:Terminal,TerminalSquare:SquareTerminal,TerminalSquareIcon:SquareTerminal,TestTube,TestTube2:TestTubeDiagonal,TestTube2Icon:TestTubeDiagonal,TestTubeDiagonal,TestTubeDiagonalIcon:TestTubeDiagonal,TestTubeIcon:TestTube,TestTubes,TestTubesIcon:TestTubes,Text:TextAlignStart,TextAlignCenter,TextAlignCenterIcon:TextAlignCenter,TextAlignEnd,TextAlignEndIcon:TextAlignEnd,TextAlignJustify,TextAlignJustifyIcon:TextAlignJustify,TextAlignStart,TextAlignStartIcon:TextAlignStart,TextCursor,TextCursorIcon:TextCursor,TextCursorInput,TextCursorInputIcon:TextCursorInput,TextIcon:TextAlignStart,TextInitial,TextInitialIcon:TextInitial,TextQuote,TextQuoteIcon:TextQuote,TextSearch,TextSearchIcon:TextSearch,TextSelect,TextSelectIcon:TextSelect,TextSelection:TextSelect,TextSelectionIcon:TextSelect,TextWrap,TextWrapIcon:TextWrap,Theater,TheaterIcon:Theater,Thermometer,ThermometerIcon:Thermometer,ThermometerSnowflake,ThermometerSnowflakeIcon:ThermometerSnowflake,ThermometerSun,ThermometerSunIcon:ThermometerSun,ThumbsDown,ThumbsDownIcon:ThumbsDown,ThumbsUp,ThumbsUpIcon:ThumbsUp,Ticket,TicketCheck,TicketCheckIcon:TicketCheck,TicketIcon:Ticket,TicketMinus,TicketMinusIcon:TicketMinus,TicketPercent,TicketPercentIcon:TicketPercent,TicketPlus,TicketPlusIcon:TicketPlus,TicketSlash,TicketSlashIcon:TicketSlash,TicketX,TicketXIcon:TicketX,Tickets,TicketsIcon:Tickets,TicketsPlane,TicketsPlaneIcon:TicketsPlane,Timer:Timer$1,TimerIcon:Timer$1,TimerOff,TimerOffIcon:TimerOff,TimerReset,TimerResetIcon:TimerReset,ToggleLeft,ToggleLeftIcon:ToggleLeft,ToggleRight,ToggleRightIcon:ToggleRight,Toilet,ToiletIcon:Toilet,ToolCase,ToolCaseIcon:ToolCase,Tornado,TornadoIcon:Tornado,Torus,TorusIcon:Torus,Touchpad,TouchpadIcon:Touchpad,TouchpadOff,TouchpadOffIcon:TouchpadOff,TowerControl,TowerControlIcon:TowerControl,ToyBrick,ToyBrickIcon:ToyBrick,Tractor,TractorIcon:Tractor,TrafficCone,TrafficConeIcon:TrafficCone,Train:TramFront,TrainFront,TrainFrontIcon:TrainFront,TrainFrontTunnel,TrainFrontTunnelIcon:TrainFrontTunnel,TrainIcon:TramFront,TrainTrack,TrainTrackIcon:TrainTrack,TramFront,TramFrontIcon:TramFront,Transgender,TransgenderIcon:Transgender,Trash,Trash2,Trash2Icon:Trash2,TrashIcon:Trash,TreeDeciduous,TreeDeciduousIcon:TreeDeciduous,TreePalm,TreePalmIcon:TreePalm,TreePine,TreePineIcon:TreePine,Trees,TreesIcon:Trees,Trello,TrelloIcon:Trello,TrendingDown,TrendingDownIcon:TrendingDown,TrendingUp,TrendingUpDown,TrendingUpDownIcon:TrendingUpDown,TrendingUpIcon:TrendingUp,Triangle,TriangleAlert,TriangleAlertIcon:TriangleAlert,TriangleDashed,TriangleDashedIcon:TriangleDashed,TriangleIcon:Triangle,TriangleRight,TriangleRightIcon:TriangleRight,Trophy,TrophyIcon:Trophy,Truck,TruckElectric,TruckElectricIcon:TruckElectric,TruckIcon:Truck,TurkishLira,TurkishLiraIcon:TurkishLira,Turntable,TurntableIcon:Turntable,Turtle,TurtleIcon:Turtle,Tv,Tv2:TvMinimal,Tv2Icon:TvMinimal,TvIcon:Tv,TvMinimal,TvMinimalIcon:TvMinimal,TvMinimalPlay,TvMinimalPlayIcon:TvMinimalPlay,Twitch,TwitchIcon:Twitch,Twitter,TwitterIcon:Twitter,Type:Type$2,TypeIcon:Type$2,TypeOutline,TypeOutlineIcon:TypeOutline,Umbrella,UmbrellaIcon:Umbrella,UmbrellaOff,UmbrellaOffIcon:UmbrellaOff,Underline,UnderlineIcon:Underline,Undo,Undo2,Undo2Icon:Undo2,UndoDot,UndoDotIcon:UndoDot,UndoIcon:Undo,UnfoldHorizontal,UnfoldHorizontalIcon:UnfoldHorizontal,UnfoldVertical,UnfoldVerticalIcon:UnfoldVertical,Ungroup,UngroupIcon:Ungroup,University,UniversityIcon:University,Unlink,Unlink2,Unlink2Icon:Unlink2,UnlinkIcon:Unlink,Unlock:LockOpen,UnlockIcon:LockOpen,UnlockKeyhole:LockKeyholeOpen,UnlockKeyholeIcon:LockKeyholeOpen,Unplug,UnplugIcon:Unplug,Upload,UploadCloud:CloudUpload,UploadCloudIcon:CloudUpload,UploadIcon:Upload,Usb,UsbIcon:Usb,User,User2:UserRound,User2Icon:UserRound,UserCheck,UserCheck2:UserRoundCheck,UserCheck2Icon:UserRoundCheck,UserCheckIcon:UserCheck,UserCircle:CircleUser,UserCircle2:CircleUserRound,UserCircle2Icon:CircleUserRound,UserCircleIcon:CircleUser,UserCog,UserCog2:UserRoundCog,UserCog2Icon:UserRoundCog,UserCogIcon:UserCog,UserIcon:User,UserLock,UserLockIcon:UserLock,UserMinus,UserMinus2:UserRoundMinus,UserMinus2Icon:UserRoundMinus,UserMinusIcon:UserMinus,UserPen,UserPenIcon:UserPen,UserPlus,UserPlus2:UserRoundPlus,UserPlus2Icon:UserRoundPlus,UserPlusIcon:UserPlus,UserRound,UserRoundCheck,UserRoundCheckIcon:UserRoundCheck,UserRoundCog,UserRoundCogIcon:UserRoundCog,UserRoundIcon:UserRound,UserRoundMinus,UserRoundMinusIcon:UserRoundMinus,UserRoundPen,UserRoundPenIcon:UserRoundPen,UserRoundPlus,UserRoundPlusIcon:UserRoundPlus,UserRoundSearch,UserRoundSearchIcon:UserRoundSearch,UserRoundX,UserRoundXIcon:UserRoundX,UserSearch,UserSearchIcon:UserSearch,UserSquare:SquareUser,UserSquare2:SquareUserRound,UserSquare2Icon:SquareUserRound,UserSquareIcon:SquareUser,UserStar,UserStarIcon:UserStar,UserX,UserX2:UserRoundX,UserX2Icon:UserRoundX,UserXIcon:UserX,Users,Users2:UsersRound,Users2Icon:UsersRound,UsersIcon:Users,UsersRound,UsersRoundIcon:UsersRound,Utensils,UtensilsCrossed,UtensilsCrossedIcon:UtensilsCrossed,UtensilsIcon:Utensils,UtilityPole,UtilityPoleIcon:UtilityPole,Variable,VariableIcon:Variable,Vault,VaultIcon:Vault,VectorSquare,VectorSquareIcon:VectorSquare,Vegan,VeganIcon:Vegan,VenetianMask,VenetianMaskIcon:VenetianMask,Venus,VenusAndMars,VenusAndMarsIcon:VenusAndMars,VenusIcon:Venus,Verified:BadgeCheck,VerifiedIcon:BadgeCheck,Vibrate,VibrateIcon:Vibrate,VibrateOff,VibrateOffIcon:VibrateOff,Video,VideoIcon:Video,VideoOff,VideoOffIcon:VideoOff,Videotape,VideotapeIcon:Videotape,View,ViewIcon:View,Voicemail,VoicemailIcon:Voicemail,Volleyball,VolleyballIcon:Volleyball,Volume,Volume1,Volume1Icon:Volume1,Volume2,Volume2Icon:Volume2,VolumeIcon:Volume,VolumeOff,VolumeOffIcon:VolumeOff,VolumeX,VolumeXIcon:VolumeX,Vote,VoteIcon:Vote,Wallet,Wallet2:WalletMinimal,Wallet2Icon:WalletMinimal,WalletCards,WalletCardsIcon:WalletCards,WalletIcon:Wallet,WalletMinimal,WalletMinimalIcon:WalletMinimal,Wallpaper,WallpaperIcon:Wallpaper,Wand,Wand2:WandSparkles,Wand2Icon:WandSparkles,WandIcon:Wand,WandSparkles,WandSparklesIcon:WandSparkles,Warehouse,WarehouseIcon:Warehouse,WashingMachine,WashingMachineIcon:WashingMachine,Watch,WatchIcon:Watch,Waves,WavesIcon:Waves,WavesLadder,WavesLadderIcon:WavesLadder,Waypoints,WaypointsIcon:Waypoints,Webcam,WebcamIcon:Webcam,Webhook,WebhookIcon:Webhook,WebhookOff,WebhookOffIcon:WebhookOff,Weight,WeightIcon:Weight,Wheat,WheatIcon:Wheat,WheatOff,WheatOffIcon:WheatOff,WholeWord,WholeWordIcon:WholeWord,Wifi,WifiCog,WifiCogIcon:WifiCog,WifiHigh,WifiHighIcon:WifiHigh,WifiIcon:Wifi,WifiLow,WifiLowIcon:WifiLow,WifiOff,WifiOffIcon:WifiOff,WifiPen,WifiPenIcon:WifiPen,WifiSync,WifiSyncIcon:WifiSync,WifiZero,WifiZeroIcon:WifiZero,Wind,WindArrowDown,WindArrowDownIcon:WindArrowDown,WindIcon:Wind,Wine,WineIcon:Wine,WineOff,WineOffIcon:WineOff,Workflow,WorkflowIcon:Workflow,Worm,WormIcon:Worm,WrapText:TextWrap,WrapTextIcon:TextWrap,Wrench,WrenchIcon:Wrench,X:X$3,XCircle:CircleX,XCircleIcon:CircleX,XIcon:X$3,XOctagon:OctagonX,XOctagonIcon:OctagonX,XSquare:SquareX,XSquareIcon:SquareX,Youtube,YoutubeIcon:Youtube,Zap,ZapIcon:Zap,ZapOff,ZapOffIcon:ZapOff,ZoomIn,ZoomInIcon:ZoomIn,ZoomOut,ZoomOutIcon:ZoomOut,createLucideIcon,icons:index},Symbol.toStringTag,{value:"Module"})),isString$2=rt=>typeof rt=="string",defer=()=>{let rt,it;const ct=new Promise((dt,ut)=>{rt=dt,it=ut});return ct.resolve=rt,ct.reject=it,ct},makeString=rt=>rt==null?"":""+rt,copy=(rt,it,ct)=>{rt.forEach(dt=>{it[dt]&&(ct[dt]=it[dt])})},lastOfPathSeparatorRegExp=/###/g,cleanKey=rt=>rt&&rt.indexOf("###")>-1?rt.replace(lastOfPathSeparatorRegExp,"."):rt,canNotTraverseDeeper=rt=>!rt||isString$2(rt),getLastOfPath=(rt,it,ct)=>{const dt=isString$2(it)?it.split("."):it;let ut=0;for(;ut<dt.length-1;){if(canNotTraverseDeeper(rt))return{};const pt=cleanKey(dt[ut]);!rt[pt]&&ct&&(rt[pt]=new ct),Object.prototype.hasOwnProperty.call(rt,pt)?rt=rt[pt]:rt={},++ut}return canNotTraverseDeeper(rt)?{}:{obj:rt,k:cleanKey(dt[ut])}},setPath=(rt,it,ct)=>{const{obj:dt,k:ut}=getLastOfPath(rt,it,Object);if(dt!==void 0||it.length===1){dt[ut]=ct;return}let pt=it[it.length-1],yt=it.slice(0,it.length-1),ft=getLastOfPath(rt,yt,Object);for(;ft.obj===void 0&&yt.length;)pt=`${yt[yt.length-1]}.${pt}`,yt=yt.slice(0,yt.length-1),ft=getLastOfPath(rt,yt,Object),ft?.obj&&typeof ft.obj[`${ft.k}.${pt}`]<"u"&&(ft.obj=void 0);ft.obj[`${ft.k}.${pt}`]=ct},pushPath=(rt,it,ct,dt)=>{const{obj:ut,k:pt}=getLastOfPath(rt,it,Object);ut[pt]=ut[pt]||[],ut[pt].push(ct)},getPath=(rt,it)=>{const{obj:ct,k:dt}=getLastOfPath(rt,it);if(ct&&Object.prototype.hasOwnProperty.call(ct,dt))return ct[dt]},getPathWithDefaults=(rt,it,ct)=>{const dt=getPath(rt,ct);return dt!==void 0?dt:getPath(it,ct)},deepExtend=(rt,it,ct)=>{for(const dt in it)dt!=="__proto__"&&dt!=="constructor"&&(dt in rt?isString$2(rt[dt])||rt[dt]instanceof String||isString$2(it[dt])||it[dt]instanceof String?ct&&(rt[dt]=it[dt]):deepExtend(rt[dt],it[dt],ct):rt[dt]=it[dt]);return rt},regexEscape=rt=>rt.replace(/[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g,"\\$&");var _entityMap={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;","/":"&#x2F;"};const escape$1=rt=>isString$2(rt)?rt.replace(/[&<>"'\/]/g,it=>_entityMap[it]):rt;class RegExpCache{constructor(it){this.capacity=it,this.regExpMap=new Map,this.regExpQueue=[]}getRegExp(it){const ct=this.regExpMap.get(it);if(ct!==void 0)return ct;const dt=new RegExp(it);return this.regExpQueue.length===this.capacity&&this.regExpMap.delete(this.regExpQueue.shift()),this.regExpMap.set(it,dt),this.regExpQueue.push(it),dt}}const chars=[" ",",","?","!",";"],looksLikeObjectPathRegExpCache=new RegExpCache(20),looksLikeObjectPath=(rt,it,ct)=>{it=it||"",ct=ct||"";const dt=chars.filter(yt=>it.indexOf(yt)<0&&ct.indexOf(yt)<0);if(dt.length===0)return!0;const ut=looksLikeObjectPathRegExpCache.getRegExp(`(${dt.map(yt=>yt==="?"?"\\?":yt).join("|")})`);let pt=!ut.test(rt);if(!pt){const yt=rt.indexOf(ct);yt>0&&!ut.test(rt.substring(0,yt))&&(pt=!0)}return pt},deepFind=(rt,it,ct=".")=>{if(!rt)return;if(rt[it])return Object.prototype.hasOwnProperty.call(rt,it)?rt[it]:void 0;const dt=it.split(ct);let ut=rt;for(let pt=0;pt<dt.length;){if(!ut||typeof ut!="object")return;let yt,ft="";for(let mt=pt;mt<dt.length;++mt)if(mt!==pt&&(ft+=ct),ft+=dt[mt],yt=ut[ft],yt!==void 0){if(["string","number","boolean"].indexOf(typeof yt)>-1&&mt<dt.length-1)continue;pt+=mt-pt+1;break}ut=yt}return ut},getCleanedCode=rt=>rt?.replace("_","-"),consoleLogger={type:"logger",log(rt){this.output("log",rt)},warn(rt){this.output("warn",rt)},error(rt){this.output("error",rt)},output(rt,it){console?.[rt]?.apply?.(console,it)}};class Logger{constructor(it,ct={}){this.init(it,ct)}init(it,ct={}){this.prefix=ct.prefix||"i18next:",this.logger=it||consoleLogger,this.options=ct,this.debug=ct.debug}log(...it){return this.forward(it,"log","",!0)}warn(...it){return this.forward(it,"warn","",!0)}error(...it){return this.forward(it,"error","")}deprecate(...it){return this.forward(it,"warn","WARNING DEPRECATED: ",!0)}forward(it,ct,dt,ut){return ut&&!this.debug?null:(isString$2(it[0])&&(it[0]=`${dt}${this.prefix} ${it[0]}`),this.logger[ct](it))}create(it){return new Logger(this.logger,{prefix:`${this.prefix}:${it}:`,...this.options})}clone(it){return it=it||this.options,it.prefix=it.prefix||this.prefix,new Logger(this.logger,it)}}var baseLogger=new Logger;class EventEmitter{constructor(){this.observers={}}on(it,ct){return it.split(" ").forEach(dt=>{this.observers[dt]||(this.observers[dt]=new Map);const ut=this.observers[dt].get(ct)||0;this.observers[dt].set(ct,ut+1)}),this}off(it,ct){if(this.observers[it]){if(!ct){delete this.observers[it];return}this.observers[it].delete(ct)}}emit(it,...ct){this.observers[it]&&Array.from(this.observers[it].entries()).forEach(([ut,pt])=>{for(let yt=0;yt<pt;yt++)ut(...ct)}),this.observers["*"]&&Array.from(this.observers["*"].entries()).forEach(([ut,pt])=>{for(let yt=0;yt<pt;yt++)ut.apply(ut,[it,...ct])})}}class ResourceStore extends EventEmitter{constructor(it,ct={ns:["translation"],defaultNS:"translation"}){super(),this.data=it||{},this.options=ct,this.options.keySeparator===void 0&&(this.options.keySeparator="."),this.options.ignoreJSONStructure===void 0&&(this.options.ignoreJSONStructure=!0)}addNamespaces(it){this.options.ns.indexOf(it)<0&&this.options.ns.push(it)}removeNamespaces(it){const ct=this.options.ns.indexOf(it);ct>-1&&this.options.ns.splice(ct,1)}getResource(it,ct,dt,ut={}){const pt=ut.keySeparator!==void 0?ut.keySeparator:this.options.keySeparator,yt=ut.ignoreJSONStructure!==void 0?ut.ignoreJSONStructure:this.options.ignoreJSONStructure;let ft;it.indexOf(".")>-1?ft=it.split("."):(ft=[it,ct],dt&&(Array.isArray(dt)?ft.push(...dt):isString$2(dt)&&pt?ft.push(...dt.split(pt)):ft.push(dt)));const mt=getPath(this.data,ft);return!mt&&!ct&&!dt&&it.indexOf(".")>-1&&(it=ft[0],ct=ft[1],dt=ft.slice(2).join(".")),mt||!yt||!isString$2(dt)?mt:deepFind(this.data?.[it]?.[ct],dt,pt)}addResource(it,ct,dt,ut,pt={silent:!1}){const yt=pt.keySeparator!==void 0?pt.keySeparator:this.options.keySeparator;let ft=[it,ct];dt&&(ft=ft.concat(yt?dt.split(yt):dt)),it.indexOf(".")>-1&&(ft=it.split("."),ut=ct,ct=ft[1]),this.addNamespaces(ct),setPath(this.data,ft,ut),pt.silent||this.emit("added",it,ct,dt,ut)}addResources(it,ct,dt,ut={silent:!1}){for(const pt in dt)(isString$2(dt[pt])||Array.isArray(dt[pt]))&&this.addResource(it,ct,pt,dt[pt],{silent:!0});ut.silent||this.emit("added",it,ct,dt)}addResourceBundle(it,ct,dt,ut,pt,yt={silent:!1,skipCopy:!1}){let ft=[it,ct];it.indexOf(".")>-1&&(ft=it.split("."),ut=dt,dt=ct,ct=ft[1]),this.addNamespaces(ct);let mt=getPath(this.data,ft)||{};yt.skipCopy||(dt=JSON.parse(JSON.stringify(dt))),ut?deepExtend(mt,dt,pt):mt={...mt,...dt},setPath(this.data,ft,mt),yt.silent||this.emit("added",it,ct,dt)}removeResourceBundle(it,ct){this.hasResourceBundle(it,ct)&&delete this.data[it][ct],this.removeNamespaces(ct),this.emit("removed",it,ct)}hasResourceBundle(it,ct){return this.getResource(it,ct)!==void 0}getResourceBundle(it,ct){return ct||(ct=this.options.defaultNS),this.getResource(it,ct)}getDataByLanguage(it){return this.data[it]}hasLanguageSomeTranslations(it){const ct=this.getDataByLanguage(it);return!!(ct&&Object.keys(ct)||[]).find(ut=>ct[ut]&&Object.keys(ct[ut]).length>0)}toJSON(){return this.data}}var postProcessor={processors:{},addPostProcessor(rt){this.processors[rt.name]=rt},handle(rt,it,ct,dt,ut){return rt.forEach(pt=>{it=this.processors[pt]?.process(it,ct,dt,ut)??it}),it}};const PATH_KEY=Symbol("i18next/PATH_KEY");function createProxy(){const rt=[],it=Object.create(null);let ct;return it.get=(dt,ut)=>(ct?.revoke?.(),ut===PATH_KEY?rt:(rt.push(ut),ct=Proxy.revocable(dt,it),ct.proxy)),Proxy.revocable(Object.create(null),it).proxy}function keysFromSelector(rt,it){const{[PATH_KEY]:ct}=rt(createProxy());return ct.join(it?.keySeparator??".")}const checkedLoadedFor={},shouldHandleAsObject=rt=>!isString$2(rt)&&typeof rt!="boolean"&&typeof rt!="number";class Translator extends EventEmitter{constructor(it,ct={}){super(),copy(["resourceStore","languageUtils","pluralResolver","interpolator","backendConnector","i18nFormat","utils"],it,this),this.options=ct,this.options.keySeparator===void 0&&(this.options.keySeparator="."),this.logger=baseLogger.create("translator")}changeLanguage(it){it&&(this.language=it)}exists(it,ct={interpolation:{}}){const dt={...ct};if(it==null)return!1;const ut=this.resolve(it,dt);if(ut?.res===void 0)return!1;const pt=shouldHandleAsObject(ut.res);return!(dt.returnObjects===!1&&pt)}extractFromKey(it,ct){let dt=ct.nsSeparator!==void 0?ct.nsSeparator:this.options.nsSeparator;dt===void 0&&(dt=":");const ut=ct.keySeparator!==void 0?ct.keySeparator:this.options.keySeparator;let pt=ct.ns||this.options.defaultNS||[];const yt=dt&&it.indexOf(dt)>-1,ft=!this.options.userDefinedKeySeparator&&!ct.keySeparator&&!this.options.userDefinedNsSeparator&&!ct.nsSeparator&&!looksLikeObjectPath(it,dt,ut);if(yt&&!ft){const mt=it.match(this.interpolator.nestingRegexp);if(mt&&mt.length>0)return{key:it,namespaces:isString$2(pt)?[pt]:pt};const kt=it.split(dt);(dt!==ut||dt===ut&&this.options.ns.indexOf(kt[0])>-1)&&(pt=kt.shift()),it=kt.join(ut)}return{key:it,namespaces:isString$2(pt)?[pt]:pt}}translate(it,ct,dt){let ut=typeof ct=="object"?{...ct}:ct;if(typeof ut!="object"&&this.options.overloadTranslationOptionHandler&&(ut=this.options.overloadTranslationOptionHandler(arguments)),typeof ut=="object"&&(ut={...ut}),ut||(ut={}),it==null)return"";typeof it=="function"&&(it=keysFromSelector(it,{...this.options,...ut})),Array.isArray(it)||(it=[String(it)]);const pt=ut.returnDetails!==void 0?ut.returnDetails:this.options.returnDetails,yt=ut.keySeparator!==void 0?ut.keySeparator:this.options.keySeparator,{key:ft,namespaces:mt}=this.extractFromKey(it[it.length-1],ut),kt=mt[mt.length-1];let _t=ut.nsSeparator!==void 0?ut.nsSeparator:this.options.nsSeparator;_t===void 0&&(_t=":");const vt=ut.lng||this.language,bt=ut.appendNamespaceToCIMode||this.options.appendNamespaceToCIMode;if(vt?.toLowerCase()==="cimode")return bt?pt?{res:`${kt}${_t}${ft}`,usedKey:ft,exactUsedKey:ft,usedLng:vt,usedNS:kt,usedParams:this.getUsedParamsDetails(ut)}:`${kt}${_t}${ft}`:pt?{res:ft,usedKey:ft,exactUsedKey:ft,usedLng:vt,usedNS:kt,usedParams:this.getUsedParamsDetails(ut)}:ft;const Mt=this.resolve(it,ut);let wt=Mt?.res;const St=Mt?.usedKey||ft,It=Mt?.exactUsedKey||ft,Nt=["[object Number]","[object Function]","[object RegExp]"],$t=ut.joinArrays!==void 0?ut.joinArrays:this.options.joinArrays,Et=!this.i18nFormat||this.i18nFormat.handleAsObject,Ft=ut.count!==void 0&&!isString$2(ut.count),qt=Translator.hasDefaultValue(ut),Ht=Ft?this.pluralResolver.getSuffix(vt,ut.count,ut):"",Ot=ut.ordinal&&Ft?this.pluralResolver.getSuffix(vt,ut.count,{ordinal:!1}):"",Zt=Ft&&!ut.ordinal&&ut.count===0,Yt=Zt&&ut[`defaultValue${this.options.pluralSeparator}zero`]||ut[`defaultValue${Ht}`]||ut[`defaultValue${Ot}`]||ut.defaultValue;let aa=wt;Et&&!wt&&qt&&(aa=Yt);const Qt=shouldHandleAsObject(aa),oa=Object.prototype.toString.apply(aa);if(Et&&aa&&Qt&&Nt.indexOf(oa)<0&&!(isString$2($t)&&Array.isArray(aa))){if(!ut.returnObjects&&!this.options.returnObjects){this.options.returnedObjectHandler||this.logger.warn("accessing an object - but returnObjects options is not enabled!");const la=this.options.returnedObjectHandler?this.options.returnedObjectHandler(St,aa,{...ut,ns:mt}):`key '${ft} (${this.language})' returned an object instead of string.`;return pt?(Mt.res=la,Mt.usedParams=this.getUsedParamsDetails(ut),Mt):la}if(yt){const la=Array.isArray(aa),Kt=la?[]:{},ra=la?It:St;for(const Ut in aa)if(Object.prototype.hasOwnProperty.call(aa,Ut)){const ea=`${ra}${yt}${Ut}`;qt&&!wt?Kt[Ut]=this.translate(ea,{...ut,defaultValue:shouldHandleAsObject(Yt)?Yt[Ut]:void 0,joinArrays:!1,ns:mt}):Kt[Ut]=this.translate(ea,{...ut,joinArrays:!1,ns:mt}),Kt[Ut]===ea&&(Kt[Ut]=aa[Ut])}wt=Kt}}else if(Et&&isString$2($t)&&Array.isArray(wt))wt=wt.join($t),wt&&(wt=this.extendTranslation(wt,it,ut,dt));else{let la=!1,Kt=!1;!this.isValidLookup(wt)&&qt&&(la=!0,wt=Yt),this.isValidLookup(wt)||(Kt=!0,wt=ft);const Ut=(ut.missingKeyNoValueFallbackToKey||this.options.missingKeyNoValueFallbackToKey)&&Kt?void 0:wt,ea=qt&&Yt!==wt&&this.options.updateMissing;if(Kt||la||ea){if(this.logger.log(ea?"updateKey":"missingKey",vt,kt,ft,ea?Yt:wt),yt){const Vt=this.resolve(ft,{...ut,keySeparator:!1});Vt&&Vt.res&&this.logger.warn("Seems the loaded translations were in flat JSON format instead of nested. Either set keySeparator: false on init or make sure your translations are published in nested format.")}let Gt=[];const _a=this.languageUtils.getFallbackCodes(this.options.fallbackLng,ut.lng||this.language);if(this.options.saveMissingTo==="fallback"&&_a&&_a[0])for(let Vt=0;Vt<_a.length;Vt++)Gt.push(_a[Vt]);else this.options.saveMissingTo==="all"?Gt=this.languageUtils.toResolveHierarchy(ut.lng||this.language):Gt.push(ut.lng||this.language);const Ca=(Vt,ta,sa)=>{const xa=qt&&sa!==wt?sa:Ut;this.options.missingKeyHandler?this.options.missingKeyHandler(Vt,kt,ta,xa,ea,ut):this.backendConnector?.saveMissing&&this.backendConnector.saveMissing(Vt,kt,ta,xa,ea,ut),this.emit("missingKey",Vt,kt,ta,wt)};this.options.saveMissing&&(this.options.saveMissingPlurals&&Ft?Gt.forEach(Vt=>{const ta=this.pluralResolver.getSuffixes(Vt,ut);Zt&&ut[`defaultValue${this.options.pluralSeparator}zero`]&&ta.indexOf(`${this.options.pluralSeparator}zero`)<0&&ta.push(`${this.options.pluralSeparator}zero`),ta.forEach(sa=>{Ca([Vt],ft+sa,ut[`defaultValue${sa}`]||Yt)})}):Ca(Gt,ft,Yt))}wt=this.extendTranslation(wt,it,ut,Mt,dt),Kt&&wt===ft&&this.options.appendNamespaceToMissingKey&&(wt=`${kt}${_t}${ft}`),(Kt||la)&&this.options.parseMissingKeyHandler&&(wt=this.options.parseMissingKeyHandler(this.options.appendNamespaceToMissingKey?`${kt}${_t}${ft}`:ft,la?wt:void 0,ut))}return pt?(Mt.res=wt,Mt.usedParams=this.getUsedParamsDetails(ut),Mt):wt}extendTranslation(it,ct,dt,ut,pt){if(this.i18nFormat?.parse)it=this.i18nFormat.parse(it,{...this.options.interpolation.defaultVariables,...dt},dt.lng||this.language||ut.usedLng,ut.usedNS,ut.usedKey,{resolved:ut});else if(!dt.skipInterpolation){dt.interpolation&&this.interpolator.init({...dt,interpolation:{...this.options.interpolation,...dt.interpolation}});const mt=isString$2(it)&&(dt?.interpolation?.skipOnVariables!==void 0?dt.interpolation.skipOnVariables:this.options.interpolation.skipOnVariables);let kt;if(mt){const vt=it.match(this.interpolator.nestingRegexp);kt=vt&&vt.length}let _t=dt.replace&&!isString$2(dt.replace)?dt.replace:dt;if(this.options.interpolation.defaultVariables&&(_t={...this.options.interpolation.defaultVariables,..._t}),it=this.interpolator.interpolate(it,_t,dt.lng||this.language||ut.usedLng,dt),mt){const vt=it.match(this.interpolator.nestingRegexp),bt=vt&&vt.length;kt<bt&&(dt.nest=!1)}!dt.lng&&ut&&ut.res&&(dt.lng=this.language||ut.usedLng),dt.nest!==!1&&(it=this.interpolator.nest(it,(...vt)=>pt?.[0]===vt[0]&&!dt.context?(this.logger.warn(`It seems you are nesting recursively key: ${vt[0]} in key: ${ct[0]}`),null):this.translate(...vt,ct),dt)),dt.interpolation&&this.interpolator.reset()}const yt=dt.postProcess||this.options.postProcess,ft=isString$2(yt)?[yt]:yt;return it!=null&&ft?.length&&dt.applyPostProcessor!==!1&&(it=postProcessor.handle(ft,it,ct,this.options&&this.options.postProcessPassResolved?{i18nResolved:{...ut,usedParams:this.getUsedParamsDetails(dt)},...dt}:dt,this)),it}resolve(it,ct={}){let dt,ut,pt,yt,ft;return isString$2(it)&&(it=[it]),it.forEach(mt=>{if(this.isValidLookup(dt))return;const kt=this.extractFromKey(mt,ct),_t=kt.key;ut=_t;let vt=kt.namespaces;this.options.fallbackNS&&(vt=vt.concat(this.options.fallbackNS));const bt=ct.count!==void 0&&!isString$2(ct.count),Mt=bt&&!ct.ordinal&&ct.count===0,wt=ct.context!==void 0&&(isString$2(ct.context)||typeof ct.context=="number")&&ct.context!=="",St=ct.lngs?ct.lngs:this.languageUtils.toResolveHierarchy(ct.lng||this.language,ct.fallbackLng);vt.forEach(It=>{this.isValidLookup(dt)||(ft=It,!checkedLoadedFor[`${St[0]}-${It}`]&&this.utils?.hasLoadedNamespace&&!this.utils?.hasLoadedNamespace(ft)&&(checkedLoadedFor[`${St[0]}-${It}`]=!0,this.logger.warn(`key "${ut}" for languages "${St.join(", ")}" won't get resolved as namespace "${ft}" was not yet loaded`,"This means something IS WRONG in your setup. You access the t function before i18next.init / i18next.loadNamespace / i18next.changeLanguage was done. Wait for the callback or Promise to resolve before accessing it!!!")),St.forEach(Nt=>{if(this.isValidLookup(dt))return;yt=Nt;const $t=[_t];if(this.i18nFormat?.addLookupKeys)this.i18nFormat.addLookupKeys($t,_t,Nt,It,ct);else{let Ft;bt&&(Ft=this.pluralResolver.getSuffix(Nt,ct.count,ct));const qt=`${this.options.pluralSeparator}zero`,Ht=`${this.options.pluralSeparator}ordinal${this.options.pluralSeparator}`;if(bt&&(ct.ordinal&&Ft.indexOf(Ht)===0&&$t.push(_t+Ft.replace(Ht,this.options.pluralSeparator)),$t.push(_t+Ft),Mt&&$t.push(_t+qt)),wt){const Ot=`${_t}${this.options.contextSeparator||"_"}${ct.context}`;$t.push(Ot),bt&&(ct.ordinal&&Ft.indexOf(Ht)===0&&$t.push(Ot+Ft.replace(Ht,this.options.pluralSeparator)),$t.push(Ot+Ft),Mt&&$t.push(Ot+qt))}}let Et;for(;Et=$t.pop();)this.isValidLookup(dt)||(pt=Et,dt=this.getResource(Nt,It,Et,ct))}))})}),{res:dt,usedKey:ut,exactUsedKey:pt,usedLng:yt,usedNS:ft}}isValidLookup(it){return it!==void 0&&!(!this.options.returnNull&&it===null)&&!(!this.options.returnEmptyString&&it==="")}getResource(it,ct,dt,ut={}){return this.i18nFormat?.getResource?this.i18nFormat.getResource(it,ct,dt,ut):this.resourceStore.getResource(it,ct,dt,ut)}getUsedParamsDetails(it={}){const ct=["defaultValue","ordinal","context","replace","lng","lngs","fallbackLng","ns","keySeparator","nsSeparator","returnObjects","returnDetails","joinArrays","postProcess","interpolation"],dt=it.replace&&!isString$2(it.replace);let ut=dt?it.replace:it;if(dt&&typeof it.count<"u"&&(ut.count=it.count),this.options.interpolation.defaultVariables&&(ut={...this.options.interpolation.defaultVariables,...ut}),!dt){ut={...ut};for(const pt of ct)delete ut[pt]}return ut}static hasDefaultValue(it){const ct="defaultValue";for(const dt in it)if(Object.prototype.hasOwnProperty.call(it,dt)&&ct===dt.substring(0,ct.length)&&it[dt]!==void 0)return!0;return!1}}class LanguageUtil{constructor(it){this.options=it,this.supportedLngs=this.options.supportedLngs||!1,this.logger=baseLogger.create("languageUtils")}getScriptPartFromCode(it){if(it=getCleanedCode(it),!it||it.indexOf("-")<0)return null;const ct=it.split("-");return ct.length===2||(ct.pop(),ct[ct.length-1].toLowerCase()==="x")?null:this.formatLanguageCode(ct.join("-"))}getLanguagePartFromCode(it){if(it=getCleanedCode(it),!it||it.indexOf("-")<0)return it;const ct=it.split("-");return this.formatLanguageCode(ct[0])}formatLanguageCode(it){if(isString$2(it)&&it.indexOf("-")>-1){let ct;try{ct=Intl.getCanonicalLocales(it)[0]}catch{}return ct&&this.options.lowerCaseLng&&(ct=ct.toLowerCase()),ct||(this.options.lowerCaseLng?it.toLowerCase():it)}return this.options.cleanCode||this.options.lowerCaseLng?it.toLowerCase():it}isSupportedCode(it){return(this.options.load==="languageOnly"||this.options.nonExplicitSupportedLngs)&&(it=this.getLanguagePartFromCode(it)),!this.supportedLngs||!this.supportedLngs.length||this.supportedLngs.indexOf(it)>-1}getBestMatchFromCodes(it){if(!it)return null;let ct;return it.forEach(dt=>{if(ct)return;const ut=this.formatLanguageCode(dt);(!this.options.supportedLngs||this.isSupportedCode(ut))&&(ct=ut)}),!ct&&this.options.supportedLngs&&it.forEach(dt=>{if(ct)return;const ut=this.getScriptPartFromCode(dt);if(this.isSupportedCode(ut))return ct=ut;const pt=this.getLanguagePartFromCode(dt);if(this.isSupportedCode(pt))return ct=pt;ct=this.options.supportedLngs.find(yt=>{if(yt===pt)return yt;if(!(yt.indexOf("-")<0&&pt.indexOf("-")<0)&&(yt.indexOf("-")>0&&pt.indexOf("-")<0&&yt.substring(0,yt.indexOf("-"))===pt||yt.indexOf(pt)===0&&pt.length>1))return yt})}),ct||(ct=this.getFallbackCodes(this.options.fallbackLng)[0]),ct}getFallbackCodes(it,ct){if(!it)return[];if(typeof it=="function"&&(it=it(ct)),isString$2(it)&&(it=[it]),Array.isArray(it))return it;if(!ct)return it.default||[];let dt=it[ct];return dt||(dt=it[this.getScriptPartFromCode(ct)]),dt||(dt=it[this.formatLanguageCode(ct)]),dt||(dt=it[this.getLanguagePartFromCode(ct)]),dt||(dt=it.default),dt||[]}toResolveHierarchy(it,ct){const dt=this.getFallbackCodes((ct===!1?[]:ct)||this.options.fallbackLng||[],it),ut=[],pt=yt=>{yt&&(this.isSupportedCode(yt)?ut.push(yt):this.logger.warn(`rejecting language code not found in supportedLngs: ${yt}`))};return isString$2(it)&&(it.indexOf("-")>-1||it.indexOf("_")>-1)?(this.options.load!=="languageOnly"&&pt(this.formatLanguageCode(it)),this.options.load!=="languageOnly"&&this.options.load!=="currentOnly"&&pt(this.getScriptPartFromCode(it)),this.options.load!=="currentOnly"&&pt(this.getLanguagePartFromCode(it))):isString$2(it)&&pt(this.formatLanguageCode(it)),dt.forEach(yt=>{ut.indexOf(yt)<0&&pt(this.formatLanguageCode(yt))}),ut}}const suffixesOrder={zero:0,one:1,two:2,few:3,many:4,other:5},dummyRule={select:rt=>rt===1?"one":"other",resolvedOptions:()=>({pluralCategories:["one","other"]})};class PluralResolver{constructor(it,ct={}){this.languageUtils=it,this.options=ct,this.logger=baseLogger.create("pluralResolver"),this.pluralRulesCache={}}addRule(it,ct){this.rules[it]=ct}clearCache(){this.pluralRulesCache={}}getRule(it,ct={}){const dt=getCleanedCode(it==="dev"?"en":it),ut=ct.ordinal?"ordinal":"cardinal",pt=JSON.stringify({cleanedCode:dt,type:ut});if(pt in this.pluralRulesCache)return this.pluralRulesCache[pt];let yt;try{yt=new Intl.PluralRules(dt,{type:ut})}catch{if(!Intl)return this.logger.error("No Intl support, please use an Intl polyfill!"),dummyRule;if(!it.match(/-|_/))return dummyRule;const mt=this.languageUtils.getLanguagePartFromCode(it);yt=this.getRule(mt,ct)}return this.pluralRulesCache[pt]=yt,yt}needsPlural(it,ct={}){let dt=this.getRule(it,ct);return dt||(dt=this.getRule("dev",ct)),dt?.resolvedOptions().pluralCategories.length>1}getPluralFormsOfKey(it,ct,dt={}){return this.getSuffixes(it,dt).map(ut=>`${ct}${ut}`)}getSuffixes(it,ct={}){let dt=this.getRule(it,ct);return dt||(dt=this.getRule("dev",ct)),dt?dt.resolvedOptions().pluralCategories.sort((ut,pt)=>suffixesOrder[ut]-suffixesOrder[pt]).map(ut=>`${this.options.prepend}${ct.ordinal?`ordinal${this.options.prepend}`:""}${ut}`):[]}getSuffix(it,ct,dt={}){const ut=this.getRule(it,dt);return ut?`${this.options.prepend}${dt.ordinal?`ordinal${this.options.prepend}`:""}${ut.select(ct)}`:(this.logger.warn(`no plural rule found for: ${it}`),this.getSuffix("dev",ct,dt))}}const deepFindWithDefaults=(rt,it,ct,dt=".",ut=!0)=>{let pt=getPathWithDefaults(rt,it,ct);return!pt&&ut&&isString$2(ct)&&(pt=deepFind(rt,ct,dt),pt===void 0&&(pt=deepFind(it,ct,dt))),pt},regexSafe=rt=>rt.replace(/\$/g,"$$$$");class Interpolator{constructor(it={}){this.logger=baseLogger.create("interpolator"),this.options=it,this.format=it?.interpolation?.format||(ct=>ct),this.init(it)}init(it={}){it.interpolation||(it.interpolation={escapeValue:!0});const{escape:ct,escapeValue:dt,useRawValueToEscape:ut,prefix:pt,prefixEscaped:yt,suffix:ft,suffixEscaped:mt,formatSeparator:kt,unescapeSuffix:_t,unescapePrefix:vt,nestingPrefix:bt,nestingPrefixEscaped:Mt,nestingSuffix:wt,nestingSuffixEscaped:St,nestingOptionsSeparator:It,maxReplaces:Nt,alwaysFormat:$t}=it.interpolation;this.escape=ct!==void 0?ct:escape$1,this.escapeValue=dt!==void 0?dt:!0,this.useRawValueToEscape=ut!==void 0?ut:!1,this.prefix=pt?regexEscape(pt):yt||"{{",this.suffix=ft?regexEscape(ft):mt||"}}",this.formatSeparator=kt||",",this.unescapePrefix=_t?"":vt||"-",this.unescapeSuffix=this.unescapePrefix?"":_t||"",this.nestingPrefix=bt?regexEscape(bt):Mt||regexEscape("$t("),this.nestingSuffix=wt?regexEscape(wt):St||regexEscape(")"),this.nestingOptionsSeparator=It||",",this.maxReplaces=Nt||1e3,this.alwaysFormat=$t!==void 0?$t:!1,this.resetRegExp()}reset(){this.options&&this.init(this.options)}resetRegExp(){const it=(ct,dt)=>ct?.source===dt?(ct.lastIndex=0,ct):new RegExp(dt,"g");this.regexp=it(this.regexp,`${this.prefix}(.+?)${this.suffix}`),this.regexpUnescape=it(this.regexpUnescape,`${this.prefix}${this.unescapePrefix}(.+?)${this.unescapeSuffix}${this.suffix}`),this.nestingRegexp=it(this.nestingRegexp,`${this.nestingPrefix}((?:[^()"']+|"[^"]*"|'[^']*'|\\((?:[^()]|"[^"]*"|'[^']*')*\\))*?)${this.nestingSuffix}`)}interpolate(it,ct,dt,ut){let pt,yt,ft;const mt=this.options&&this.options.interpolation&&this.options.interpolation.defaultVariables||{},kt=Mt=>{if(Mt.indexOf(this.formatSeparator)<0){const Nt=deepFindWithDefaults(ct,mt,Mt,this.options.keySeparator,this.options.ignoreJSONStructure);return this.alwaysFormat?this.format(Nt,void 0,dt,{...ut,...ct,interpolationkey:Mt}):Nt}const wt=Mt.split(this.formatSeparator),St=wt.shift().trim(),It=wt.join(this.formatSeparator).trim();return this.format(deepFindWithDefaults(ct,mt,St,this.options.keySeparator,this.options.ignoreJSONStructure),It,dt,{...ut,...ct,interpolationkey:St})};this.resetRegExp();const _t=ut?.missingInterpolationHandler||this.options.missingInterpolationHandler,vt=ut?.interpolation?.skipOnVariables!==void 0?ut.interpolation.skipOnVariables:this.options.interpolation.skipOnVariables;return[{regex:this.regexpUnescape,safeValue:Mt=>regexSafe(Mt)},{regex:this.regexp,safeValue:Mt=>this.escapeValue?regexSafe(this.escape(Mt)):regexSafe(Mt)}].forEach(Mt=>{for(ft=0;pt=Mt.regex.exec(it);){const wt=pt[1].trim();if(yt=kt(wt),yt===void 0)if(typeof _t=="function"){const It=_t(it,pt,ut);yt=isString$2(It)?It:""}else if(ut&&Object.prototype.hasOwnProperty.call(ut,wt))yt="";else if(vt){yt=pt[0];continue}else this.logger.warn(`missed to pass in variable ${wt} for interpolating ${it}`),yt="";else!isString$2(yt)&&!this.useRawValueToEscape&&(yt=makeString(yt));const St=Mt.safeValue(yt);if(it=it.replace(pt[0],St),vt?(Mt.regex.lastIndex+=yt.length,Mt.regex.lastIndex-=pt[0].length):Mt.regex.lastIndex=0,ft++,ft>=this.maxReplaces)break}}),it}nest(it,ct,dt={}){let ut,pt,yt;const ft=(mt,kt)=>{const _t=this.nestingOptionsSeparator;if(mt.indexOf(_t)<0)return mt;const vt=mt.split(new RegExp(`${_t}[ ]*{`));let bt=`{${vt[1]}`;mt=vt[0],bt=this.interpolate(bt,yt);const Mt=bt.match(/'/g),wt=bt.match(/"/g);((Mt?.length??0)%2===0&&!wt||wt.length%2!==0)&&(bt=bt.replace(/'/g,'"'));try{yt=JSON.parse(bt),kt&&(yt={...kt,...yt})}catch(St){return this.logger.warn(`failed parsing options string in nesting for key ${mt}`,St),`${mt}${_t}${bt}`}return yt.defaultValue&&yt.defaultValue.indexOf(this.prefix)>-1&&delete yt.defaultValue,mt};for(;ut=this.nestingRegexp.exec(it);){let mt=[];yt={...dt},yt=yt.replace&&!isString$2(yt.replace)?yt.replace:yt,yt.applyPostProcessor=!1,delete yt.defaultValue;const kt=/{.*}/.test(ut[1])?ut[1].lastIndexOf("}")+1:ut[1].indexOf(this.formatSeparator);if(kt!==-1&&(mt=ut[1].slice(kt).split(this.formatSeparator).map(_t=>_t.trim()).filter(Boolean),ut[1]=ut[1].slice(0,kt)),pt=ct(ft.call(this,ut[1].trim(),yt),yt),pt&&ut[0]===it&&!isString$2(pt))return pt;isString$2(pt)||(pt=makeString(pt)),pt||(this.logger.warn(`missed to resolve ${ut[1]} for nesting ${it}`),pt=""),mt.length&&(pt=mt.reduce((_t,vt)=>this.format(_t,vt,dt.lng,{...dt,interpolationkey:ut[1].trim()}),pt.trim())),it=it.replace(ut[0],pt),this.regexp.lastIndex=0}return it}}const parseFormatStr=rt=>{let it=rt.toLowerCase().trim();const ct={};if(rt.indexOf("(")>-1){const dt=rt.split("(");it=dt[0].toLowerCase().trim();const ut=dt[1].substring(0,dt[1].length-1);it==="currency"&&ut.indexOf(":")<0?ct.currency||(ct.currency=ut.trim()):it==="relativetime"&&ut.indexOf(":")<0?ct.range||(ct.range=ut.trim()):ut.split(";").forEach(yt=>{if(yt){const[ft,...mt]=yt.split(":"),kt=mt.join(":").trim().replace(/^'+|'+$/g,""),_t=ft.trim();ct[_t]||(ct[_t]=kt),kt==="false"&&(ct[_t]=!1),kt==="true"&&(ct[_t]=!0),isNaN(kt)||(ct[_t]=parseInt(kt,10))}})}return{formatName:it,formatOptions:ct}},createCachedFormatter=rt=>{const it={};return(ct,dt,ut)=>{let pt=ut;ut&&ut.interpolationkey&&ut.formatParams&&ut.formatParams[ut.interpolationkey]&&ut[ut.interpolationkey]&&(pt={...pt,[ut.interpolationkey]:void 0});const yt=dt+JSON.stringify(pt);let ft=it[yt];return ft||(ft=rt(getCleanedCode(dt),ut),it[yt]=ft),ft(ct)}},createNonCachedFormatter=rt=>(it,ct,dt)=>rt(getCleanedCode(ct),dt)(it);class Formatter{constructor(it={}){this.logger=baseLogger.create("formatter"),this.options=it,this.init(it)}init(it,ct={interpolation:{}}){this.formatSeparator=ct.interpolation.formatSeparator||",";const dt=ct.cacheInBuiltFormats?createCachedFormatter:createNonCachedFormatter;this.formats={number:dt((ut,pt)=>{const yt=new Intl.NumberFormat(ut,{...pt});return ft=>yt.format(ft)}),currency:dt((ut,pt)=>{const yt=new Intl.NumberFormat(ut,{...pt,style:"currency"});return ft=>yt.format(ft)}),datetime:dt((ut,pt)=>{const yt=new Intl.DateTimeFormat(ut,{...pt});return ft=>yt.format(ft)}),relativetime:dt((ut,pt)=>{const yt=new Intl.RelativeTimeFormat(ut,{...pt});return ft=>yt.format(ft,pt.range||"day")}),list:dt((ut,pt)=>{const yt=new Intl.ListFormat(ut,{...pt});return ft=>yt.format(ft)})}}add(it,ct){this.formats[it.toLowerCase().trim()]=ct}addCached(it,ct){this.formats[it.toLowerCase().trim()]=createCachedFormatter(ct)}format(it,ct,dt,ut={}){const pt=ct.split(this.formatSeparator);if(pt.length>1&&pt[0].indexOf("(")>1&&pt[0].indexOf(")")<0&&pt.find(ft=>ft.indexOf(")")>-1)){const ft=pt.findIndex(mt=>mt.indexOf(")")>-1);pt[0]=[pt[0],...pt.splice(1,ft)].join(this.formatSeparator)}return pt.reduce((ft,mt)=>{const{formatName:kt,formatOptions:_t}=parseFormatStr(mt);if(this.formats[kt]){let vt=ft;try{const bt=ut?.formatParams?.[ut.interpolationkey]||{},Mt=bt.locale||bt.lng||ut.locale||ut.lng||dt;vt=this.formats[kt](ft,Mt,{..._t,...ut,...bt})}catch(bt){this.logger.warn(bt)}return vt}else this.logger.warn(`there was no format function for ${kt}`);return ft},it)}}const removePending=(rt,it)=>{rt.pending[it]!==void 0&&(delete rt.pending[it],rt.pendingCount--)};class Connector extends EventEmitter{constructor(it,ct,dt,ut={}){super(),this.backend=it,this.store=ct,this.services=dt,this.languageUtils=dt.languageUtils,this.options=ut,this.logger=baseLogger.create("backendConnector"),this.waitingReads=[],this.maxParallelReads=ut.maxParallelReads||10,this.readingCalls=0,this.maxRetries=ut.maxRetries>=0?ut.maxRetries:5,this.retryTimeout=ut.retryTimeout>=1?ut.retryTimeout:350,this.state={},this.queue=[],this.backend?.init?.(dt,ut.backend,ut)}queueLoad(it,ct,dt,ut){const pt={},yt={},ft={},mt={};return it.forEach(kt=>{let _t=!0;ct.forEach(vt=>{const bt=`${kt}|${vt}`;!dt.reload&&this.store.hasResourceBundle(kt,vt)?this.state[bt]=2:this.state[bt]<0||(this.state[bt]===1?yt[bt]===void 0&&(yt[bt]=!0):(this.state[bt]=1,_t=!1,yt[bt]===void 0&&(yt[bt]=!0),pt[bt]===void 0&&(pt[bt]=!0),mt[vt]===void 0&&(mt[vt]=!0)))}),_t||(ft[kt]=!0)}),(Object.keys(pt).length||Object.keys(yt).length)&&this.queue.push({pending:yt,pendingCount:Object.keys(yt).length,loaded:{},errors:[],callback:ut}),{toLoad:Object.keys(pt),pending:Object.keys(yt),toLoadLanguages:Object.keys(ft),toLoadNamespaces:Object.keys(mt)}}loaded(it,ct,dt){const ut=it.split("|"),pt=ut[0],yt=ut[1];ct&&this.emit("failedLoading",pt,yt,ct),!ct&&dt&&this.store.addResourceBundle(pt,yt,dt,void 0,void 0,{skipCopy:!0}),this.state[it]=ct?-1:2,ct&&dt&&(this.state[it]=0);const ft={};this.queue.forEach(mt=>{pushPath(mt.loaded,[pt],yt),removePending(mt,it),ct&&mt.errors.push(ct),mt.pendingCount===0&&!mt.done&&(Object.keys(mt.loaded).forEach(kt=>{ft[kt]||(ft[kt]={});const _t=mt.loaded[kt];_t.length&&_t.forEach(vt=>{ft[kt][vt]===void 0&&(ft[kt][vt]=!0)})}),mt.done=!0,mt.errors.length?mt.callback(mt.errors):mt.callback())}),this.emit("loaded",ft),this.queue=this.queue.filter(mt=>!mt.done)}read(it,ct,dt,ut=0,pt=this.retryTimeout,yt){if(!it.length)return yt(null,{});if(this.readingCalls>=this.maxParallelReads){this.waitingReads.push({lng:it,ns:ct,fcName:dt,tried:ut,wait:pt,callback:yt});return}this.readingCalls++;const ft=(kt,_t)=>{if(this.readingCalls--,this.waitingReads.length>0){const vt=this.waitingReads.shift();this.read(vt.lng,vt.ns,vt.fcName,vt.tried,vt.wait,vt.callback)}if(kt&&_t&&ut<this.maxRetries){setTimeout(()=>{this.read.call(this,it,ct,dt,ut+1,pt*2,yt)},pt);return}yt(kt,_t)},mt=this.backend[dt].bind(this.backend);if(mt.length===2){try{const kt=mt(it,ct);kt&&typeof kt.then=="function"?kt.then(_t=>ft(null,_t)).catch(ft):ft(null,kt)}catch(kt){ft(kt)}return}return mt(it,ct,ft)}prepareLoading(it,ct,dt={},ut){if(!this.backend)return this.logger.warn("No backend was added via i18next.use. Will not load resources."),ut&&ut();isString$2(it)&&(it=this.languageUtils.toResolveHierarchy(it)),isString$2(ct)&&(ct=[ct]);const pt=this.queueLoad(it,ct,dt,ut);if(!pt.toLoad.length)return pt.pending.length||ut(),null;pt.toLoad.forEach(yt=>{this.loadOne(yt)})}load(it,ct,dt){this.prepareLoading(it,ct,{},dt)}reload(it,ct,dt){this.prepareLoading(it,ct,{reload:!0},dt)}loadOne(it,ct=""){const dt=it.split("|"),ut=dt[0],pt=dt[1];this.read(ut,pt,"read",void 0,void 0,(yt,ft)=>{yt&&this.logger.warn(`${ct}loading namespace ${pt} for language ${ut} failed`,yt),!yt&&ft&&this.logger.log(`${ct}loaded namespace ${pt} for language ${ut}`,ft),this.loaded(it,yt,ft)})}saveMissing(it,ct,dt,ut,pt,yt={},ft=()=>{}){if(this.services?.utils?.hasLoadedNamespace&&!this.services?.utils?.hasLoadedNamespace(ct)){this.logger.warn(`did not save key "${dt}" as the namespace "${ct}" was not yet loaded`,"This means something IS WRONG in your setup. You access the t function before i18next.init / i18next.loadNamespace / i18next.changeLanguage was done. Wait for the callback or Promise to resolve before accessing it!!!");return}if(!(dt==null||dt==="")){if(this.backend?.create){const mt={...yt,isUpdate:pt},kt=this.backend.create.bind(this.backend);if(kt.length<6)try{let _t;kt.length===5?_t=kt(it,ct,dt,ut,mt):_t=kt(it,ct,dt,ut),_t&&typeof _t.then=="function"?_t.then(vt=>ft(null,vt)).catch(ft):ft(null,_t)}catch(_t){ft(_t)}else kt(it,ct,dt,ut,ft,mt)}!it||!it[0]||this.store.addResource(it[0],ct,dt,ut)}}}const get$3=()=>({debug:!1,initAsync:!0,ns:["translation"],defaultNS:["translation"],fallbackLng:["dev"],fallbackNS:!1,supportedLngs:!1,nonExplicitSupportedLngs:!1,load:"all",preload:!1,simplifyPluralSuffix:!0,keySeparator:".",nsSeparator:":",pluralSeparator:"_",contextSeparator:"_",partialBundledLanguages:!1,saveMissing:!1,updateMissing:!1,saveMissingTo:"fallback",saveMissingPlurals:!0,missingKeyHandler:!1,missingInterpolationHandler:!1,postProcess:!1,postProcessPassResolved:!1,returnNull:!1,returnEmptyString:!0,returnObjects:!1,joinArrays:!1,returnedObjectHandler:!1,parseMissingKeyHandler:!1,appendNamespaceToMissingKey:!1,appendNamespaceToCIMode:!1,overloadTranslationOptionHandler:rt=>{let it={};if(typeof rt[1]=="object"&&(it=rt[1]),isString$2(rt[1])&&(it.defaultValue=rt[1]),isString$2(rt[2])&&(it.tDescription=rt[2]),typeof rt[2]=="object"||typeof rt[3]=="object"){const ct=rt[3]||rt[2];Object.keys(ct).forEach(dt=>{it[dt]=ct[dt]})}return it},interpolation:{escapeValue:!0,format:rt=>rt,prefix:"{{",suffix:"}}",formatSeparator:",",unescapePrefix:"-",nestingPrefix:"$t(",nestingSuffix:")",nestingOptionsSeparator:",",maxReplaces:1e3,skipOnVariables:!0},cacheInBuiltFormats:!0}),transformOptions=rt=>(isString$2(rt.ns)&&(rt.ns=[rt.ns]),isString$2(rt.fallbackLng)&&(rt.fallbackLng=[rt.fallbackLng]),isString$2(rt.fallbackNS)&&(rt.fallbackNS=[rt.fallbackNS]),rt.supportedLngs?.indexOf?.("cimode")<0&&(rt.supportedLngs=rt.supportedLngs.concat(["cimode"])),typeof rt.initImmediate=="boolean"&&(rt.initAsync=rt.initImmediate),rt),noop$2=()=>{},bindMemberFunctions=rt=>{Object.getOwnPropertyNames(Object.getPrototypeOf(rt)).forEach(ct=>{typeof rt[ct]=="function"&&(rt[ct]=rt[ct].bind(rt))})};class I18n extends EventEmitter{constructor(it={},ct){if(super(),this.options=transformOptions(it),this.services={},this.logger=baseLogger,this.modules={external:[]},bindMemberFunctions(this),ct&&!this.isInitialized&&!it.isClone){if(!this.options.initAsync)return this.init(it,ct),this;setTimeout(()=>{this.init(it,ct)},0)}}init(it={},ct){this.isInitializing=!0,typeof it=="function"&&(ct=it,it={}),it.defaultNS==null&&it.ns&&(isString$2(it.ns)?it.defaultNS=it.ns:it.ns.indexOf("translation")<0&&(it.defaultNS=it.ns[0]));const dt=get$3();this.options={...dt,...this.options,...transformOptions(it)},this.options.interpolation={...dt.interpolation,...this.options.interpolation},it.keySeparator!==void 0&&(this.options.userDefinedKeySeparator=it.keySeparator),it.nsSeparator!==void 0&&(this.options.userDefinedNsSeparator=it.nsSeparator);const ut=kt=>kt?typeof kt=="function"?new kt:kt:null;if(!this.options.isClone){this.modules.logger?baseLogger.init(ut(this.modules.logger),this.options):baseLogger.init(null,this.options);let kt;this.modules.formatter?kt=this.modules.formatter:kt=Formatter;const _t=new LanguageUtil(this.options);this.store=new ResourceStore(this.options.resources,this.options);const vt=this.services;vt.logger=baseLogger,vt.resourceStore=this.store,vt.languageUtils=_t,vt.pluralResolver=new PluralResolver(_t,{prepend:this.options.pluralSeparator,simplifyPluralSuffix:this.options.simplifyPluralSuffix}),this.options.interpolation.format&&this.options.interpolation.format!==dt.interpolation.format&&this.logger.deprecate("init: you are still using the legacy format function, please use the new approach: https://www.i18next.com/translation-function/formatting"),kt&&(!this.options.interpolation.format||this.options.interpolation.format===dt.interpolation.format)&&(vt.formatter=ut(kt),vt.formatter.init&&vt.formatter.init(vt,this.options),this.options.interpolation.format=vt.formatter.format.bind(vt.formatter)),vt.interpolator=new Interpolator(this.options),vt.utils={hasLoadedNamespace:this.hasLoadedNamespace.bind(this)},vt.backendConnector=new Connector(ut(this.modules.backend),vt.resourceStore,vt,this.options),vt.backendConnector.on("*",(Mt,...wt)=>{this.emit(Mt,...wt)}),this.modules.languageDetector&&(vt.languageDetector=ut(this.modules.languageDetector),vt.languageDetector.init&&vt.languageDetector.init(vt,this.options.detection,this.options)),this.modules.i18nFormat&&(vt.i18nFormat=ut(this.modules.i18nFormat),vt.i18nFormat.init&&vt.i18nFormat.init(this)),this.translator=new Translator(this.services,this.options),this.translator.on("*",(Mt,...wt)=>{this.emit(Mt,...wt)}),this.modules.external.forEach(Mt=>{Mt.init&&Mt.init(this)})}if(this.format=this.options.interpolation.format,ct||(ct=noop$2),this.options.fallbackLng&&!this.services.languageDetector&&!this.options.lng){const kt=this.services.languageUtils.getFallbackCodes(this.options.fallbackLng);kt.length>0&&kt[0]!=="dev"&&(this.options.lng=kt[0])}!this.services.languageDetector&&!this.options.lng&&this.logger.warn("init: no languageDetector is used and no lng is defined"),["getResource","hasResourceBundle","getResourceBundle","getDataByLanguage"].forEach(kt=>{this[kt]=(..._t)=>this.store[kt](..._t)}),["addResource","addResources","addResourceBundle","removeResourceBundle"].forEach(kt=>{this[kt]=(..._t)=>(this.store[kt](..._t),this)});const ft=defer(),mt=()=>{const kt=(_t,vt)=>{this.isInitializing=!1,this.isInitialized&&!this.initializedStoreOnce&&this.logger.warn("init: i18next is already initialized. You should call init just once!"),this.isInitialized=!0,this.options.isClone||this.logger.log("initialized",this.options),this.emit("initialized",this.options),ft.resolve(vt),ct(_t,vt)};if(this.languages&&!this.isInitialized)return kt(null,this.t.bind(this));this.changeLanguage(this.options.lng,kt)};return this.options.resources||!this.options.initAsync?mt():setTimeout(mt,0),ft}loadResources(it,ct=noop$2){let dt=ct;const ut=isString$2(it)?it:this.language;if(typeof it=="function"&&(dt=it),!this.options.resources||this.options.partialBundledLanguages){if(ut?.toLowerCase()==="cimode"&&(!this.options.preload||this.options.preload.length===0))return dt();const pt=[],yt=ft=>{if(!ft||ft==="cimode")return;this.services.languageUtils.toResolveHierarchy(ft).forEach(kt=>{kt!=="cimode"&&pt.indexOf(kt)<0&&pt.push(kt)})};ut?yt(ut):this.services.languageUtils.getFallbackCodes(this.options.fallbackLng).forEach(mt=>yt(mt)),this.options.preload?.forEach?.(ft=>yt(ft)),this.services.backendConnector.load(pt,this.options.ns,ft=>{!ft&&!this.resolvedLanguage&&this.language&&this.setResolvedLanguage(this.language),dt(ft)})}else dt(null)}reloadResources(it,ct,dt){const ut=defer();return typeof it=="function"&&(dt=it,it=void 0),typeof ct=="function"&&(dt=ct,ct=void 0),it||(it=this.languages),ct||(ct=this.options.ns),dt||(dt=noop$2),this.services.backendConnector.reload(it,ct,pt=>{ut.resolve(),dt(pt)}),ut}use(it){if(!it)throw new Error("You are passing an undefined module! Please check the object you are passing to i18next.use()");if(!it.type)throw new Error("You are passing a wrong module! Please check the object you are passing to i18next.use()");return it.type==="backend"&&(this.modules.backend=it),(it.type==="logger"||it.log&&it.warn&&it.error)&&(this.modules.logger=it),it.type==="languageDetector"&&(this.modules.languageDetector=it),it.type==="i18nFormat"&&(this.modules.i18nFormat=it),it.type==="postProcessor"&&postProcessor.addPostProcessor(it),it.type==="formatter"&&(this.modules.formatter=it),it.type==="3rdParty"&&this.modules.external.push(it),this}setResolvedLanguage(it){if(!(!it||!this.languages)&&!(["cimode","dev"].indexOf(it)>-1)){for(let ct=0;ct<this.languages.length;ct++){const dt=this.languages[ct];if(!(["cimode","dev"].indexOf(dt)>-1)&&this.store.hasLanguageSomeTranslations(dt)){this.resolvedLanguage=dt;break}}!this.resolvedLanguage&&this.languages.indexOf(it)<0&&this.store.hasLanguageSomeTranslations(it)&&(this.resolvedLanguage=it,this.languages.unshift(it))}}changeLanguage(it,ct){this.isLanguageChangingTo=it;const dt=defer();this.emit("languageChanging",it);const ut=ft=>{this.language=ft,this.languages=this.services.languageUtils.toResolveHierarchy(ft),this.resolvedLanguage=void 0,this.setResolvedLanguage(ft)},pt=(ft,mt)=>{mt?this.isLanguageChangingTo===it&&(ut(mt),this.translator.changeLanguage(mt),this.isLanguageChangingTo=void 0,this.emit("languageChanged",mt),this.logger.log("languageChanged",mt)):this.isLanguageChangingTo=void 0,dt.resolve((...kt)=>this.t(...kt)),ct&&ct(ft,(...kt)=>this.t(...kt))},yt=ft=>{!it&&!ft&&this.services.languageDetector&&(ft=[]);const mt=isString$2(ft)?ft:ft&&ft[0],kt=this.store.hasLanguageSomeTranslations(mt)?mt:this.services.languageUtils.getBestMatchFromCodes(isString$2(ft)?[ft]:ft);kt&&(this.language||ut(kt),this.translator.language||this.translator.changeLanguage(kt),this.services.languageDetector?.cacheUserLanguage?.(kt)),this.loadResources(kt,_t=>{pt(_t,kt)})};return!it&&this.services.languageDetector&&!this.services.languageDetector.async?yt(this.services.languageDetector.detect()):!it&&this.services.languageDetector&&this.services.languageDetector.async?this.services.languageDetector.detect.length===0?this.services.languageDetector.detect().then(yt):this.services.languageDetector.detect(yt):yt(it),dt}getFixedT(it,ct,dt){const ut=(pt,yt,...ft)=>{let mt;typeof yt!="object"?mt=this.options.overloadTranslationOptionHandler([pt,yt].concat(ft)):mt={...yt},mt.lng=mt.lng||ut.lng,mt.lngs=mt.lngs||ut.lngs,mt.ns=mt.ns||ut.ns,mt.keyPrefix!==""&&(mt.keyPrefix=mt.keyPrefix||dt||ut.keyPrefix);const kt=this.options.keySeparator||".";let _t;return mt.keyPrefix&&Array.isArray(pt)?_t=pt.map(vt=>(typeof vt=="function"&&(vt=keysFromSelector(vt,{...this.options,...yt})),`${mt.keyPrefix}${kt}${vt}`)):(typeof pt=="function"&&(pt=keysFromSelector(pt,{...this.options,...yt})),_t=mt.keyPrefix?`${mt.keyPrefix}${kt}${pt}`:pt),this.t(_t,mt)};return isString$2(it)?ut.lng=it:ut.lngs=it,ut.ns=ct,ut.keyPrefix=dt,ut}t(...it){return this.translator?.translate(...it)}exists(...it){return this.translator?.exists(...it)}setDefaultNamespace(it){this.options.defaultNS=it}hasLoadedNamespace(it,ct={}){if(!this.isInitialized)return this.logger.warn("hasLoadedNamespace: i18next was not initialized",this.languages),!1;if(!this.languages||!this.languages.length)return this.logger.warn("hasLoadedNamespace: i18n.languages were undefined or empty",this.languages),!1;const dt=ct.lng||this.resolvedLanguage||this.languages[0],ut=this.options?this.options.fallbackLng:!1,pt=this.languages[this.languages.length-1];if(dt.toLowerCase()==="cimode")return!0;const yt=(ft,mt)=>{const kt=this.services.backendConnector.state[`${ft}|${mt}`];return kt===-1||kt===0||kt===2};if(ct.precheck){const ft=ct.precheck(this,yt);if(ft!==void 0)return ft}return!!(this.hasResourceBundle(dt,it)||!this.services.backendConnector.backend||this.options.resources&&!this.options.partialBundledLanguages||yt(dt,it)&&(!ut||yt(pt,it)))}loadNamespaces(it,ct){const dt=defer();return this.options.ns?(isString$2(it)&&(it=[it]),it.forEach(ut=>{this.options.ns.indexOf(ut)<0&&this.options.ns.push(ut)}),this.loadResources(ut=>{dt.resolve(),ct&&ct(ut)}),dt):(ct&&ct(),Promise.resolve())}loadLanguages(it,ct){const dt=defer();isString$2(it)&&(it=[it]);const ut=this.options.preload||[],pt=it.filter(yt=>ut.indexOf(yt)<0&&this.services.languageUtils.isSupportedCode(yt));return pt.length?(this.options.preload=ut.concat(pt),this.loadResources(yt=>{dt.resolve(),ct&&ct(yt)}),dt):(ct&&ct(),Promise.resolve())}dir(it){if(it||(it=this.resolvedLanguage||(this.languages?.length>0?this.languages[0]:this.language)),!it)return"rtl";try{const ut=new Intl.Locale(it);if(ut&&ut.getTextInfo){const pt=ut.getTextInfo();if(pt&&pt.direction)return pt.direction}}catch{}const ct=["ar","shu","sqr","ssh","xaa","yhd","yud","aao","abh","abv","acm","acq","acw","acx","acy","adf","ads","aeb","aec","afb","ajp","apc","apd","arb","arq","ars","ary","arz","auz","avl","ayh","ayl","ayn","ayp","bbz","pga","he","iw","ps","pbt","pbu","pst","prp","prd","ug","ur","ydd","yds","yih","ji","yi","hbo","men","xmn","fa","jpr","peo","pes","prs","dv","sam","ckb"],dt=this.services?.languageUtils||new LanguageUtil(get$3());return it.toLowerCase().indexOf("-latn")>1?"ltr":ct.indexOf(dt.getLanguagePartFromCode(it))>-1||it.toLowerCase().indexOf("-arab")>1?"rtl":"ltr"}static createInstance(it={},ct){const dt=new I18n(it,ct);return dt.createInstance=I18n.createInstance,dt}cloneInstance(it={},ct=noop$2){const dt=it.forkResourceStore;dt&&delete it.forkResourceStore;const ut={...this.options,...it,isClone:!0},pt=new I18n(ut);if((it.debug!==void 0||it.prefix!==void 0)&&(pt.logger=pt.logger.clone(it)),["store","services","language"].forEach(ft=>{pt[ft]=this[ft]}),pt.services={...this.services},pt.services.utils={hasLoadedNamespace:pt.hasLoadedNamespace.bind(pt)},dt){const ft=Object.keys(this.store.data).reduce((mt,kt)=>(mt[kt]={...this.store.data[kt]},mt[kt]=Object.keys(mt[kt]).reduce((_t,vt)=>(_t[vt]={...mt[kt][vt]},_t),mt[kt]),mt),{});pt.store=new ResourceStore(ft,ut),pt.services.resourceStore=pt.store}return pt.translator=new Translator(pt.services,ut),pt.translator.on("*",(ft,...mt)=>{pt.emit(ft,...mt)}),pt.init(ut,ct),pt.translator.options=ut,pt.translator.backendConnector.services.utils={hasLoadedNamespace:pt.hasLoadedNamespace.bind(pt)},pt}toJSON(){return{options:this.options,store:this.store,language:this.language,languages:this.languages,resolvedLanguage:this.resolvedLanguage}}}const instance=I18n.createInstance();instance.createInstance;instance.dir;instance.init;instance.loadResources;instance.reloadResources;instance.use;instance.changeLanguage;instance.getFixedT;instance.t;instance.exists;instance.setDefaultNamespace;instance.hasLoadedNamespace;instance.loadNamespaces;instance.loadLanguages;const warn=(rt,it,ct,dt)=>{const ut=[ct,{code:it,...dt||{}}];if(rt?.services?.logger?.forward)return rt.services.logger.forward(ut,"warn","react-i18next::",!0);isString$1(ut[0])&&(ut[0]=`react-i18next:: ${ut[0]}`),rt?.services?.logger?.warn?rt.services.logger.warn(...ut):console?.warn&&console.warn(...ut)},alreadyWarned={},warnOnce=(rt,it,ct,dt)=>{isString$1(ct)&&alreadyWarned[ct]||(isString$1(ct)&&(alreadyWarned[ct]=new Date),warn(rt,it,ct,dt))},loadedClb=(rt,it)=>()=>{if(rt.isInitialized)it();else{const ct=()=>{setTimeout(()=>{rt.off("initialized",ct)},0),it()};rt.on("initialized",ct)}},loadNamespaces=(rt,it,ct)=>{rt.loadNamespaces(it,loadedClb(rt,ct))},loadLanguages=(rt,it,ct,dt)=>{if(isString$1(ct)&&(ct=[ct]),rt.options.preload&&rt.options.preload.indexOf(it)>-1)return loadNamespaces(rt,ct,dt);ct.forEach(ut=>{rt.options.ns.indexOf(ut)<0&&rt.options.ns.push(ut)}),rt.loadLanguages(it,loadedClb(rt,dt))},hasLoadedNamespace=(rt,it,ct={})=>!it.languages||!it.languages.length?(warnOnce(it,"NO_LANGUAGES","i18n.languages were undefined or empty",{languages:it.languages}),!0):it.hasLoadedNamespace(rt,{lng:ct.lng,precheck:(dt,ut)=>{if(ct.bindI18n&&ct.bindI18n.indexOf("languageChanging")>-1&&dt.services.backendConnector.backend&&dt.isLanguageChangingTo&&!ut(dt.isLanguageChangingTo,rt))return!1}}),isString$1=rt=>typeof rt=="string",isObject$3=rt=>typeof rt=="object"&&rt!==null,matchHtmlEntity=/&(?:amp|#38|lt|#60|gt|#62|apos|#39|quot|#34|nbsp|#160|copy|#169|reg|#174|hellip|#8230|#x2F|#47);/g,htmlEntities={"&amp;":"&","&#38;":"&","&lt;":"<","&#60;":"<","&gt;":">","&#62;":">","&apos;":"'","&#39;":"'","&quot;":'"',"&#34;":'"',"&nbsp;":" ","&#160;":" ","&copy;":"©","&#169;":"©","&reg;":"®","&#174;":"®","&hellip;":"…","&#8230;":"…","&#x2F;":"/","&#47;":"/"},unescapeHtmlEntity=rt=>htmlEntities[rt],unescape$1=rt=>rt.replace(matchHtmlEntity,unescapeHtmlEntity);let defaultOptions={bindI18n:"languageChanged",bindI18nStore:"",transEmptyNodeValue:"",transSupportBasicHtmlNodes:!0,transWrapTextNodes:"",transKeepBasicHtmlNodesFor:["br","strong","i","p"],useSuspense:!0,unescape:unescape$1};const setDefaults=(rt={})=>{defaultOptions={...defaultOptions,...rt}},getDefaults=()=>defaultOptions;let i18nInstance;const setI18n=rt=>{i18nInstance=rt},getI18n=()=>i18nInstance,initReactI18next={type:"3rdParty",init(rt){setDefaults(rt.options.react),setI18n(rt)}},I18nContext=reactExports.createContext();class ReportNamespaces{constructor(){this.usedNamespaces={}}addUsedNamespaces(it){it.forEach(ct=>{this.usedNamespaces[ct]||(this.usedNamespaces[ct]=!0)})}getUsedNamespaces(){return Object.keys(this.usedNamespaces)}}var shim={exports:{}},useSyncExternalStoreShim_production={};var hasRequiredUseSyncExternalStoreShim_production;function requireUseSyncExternalStoreShim_production(){if(hasRequiredUseSyncExternalStoreShim_production)return useSyncExternalStoreShim_production;hasRequiredUseSyncExternalStoreShim_production=1;var rt=requireReact();function it(vt,bt){return vt===bt&&(vt!==0||1/vt===1/bt)||vt!==vt&&bt!==bt}var ct=typeof Object.is=="function"?Object.is:it,dt=rt.useState,ut=rt.useEffect,pt=rt.useLayoutEffect,yt=rt.useDebugValue;function ft(vt,bt){var Mt=bt(),wt=dt({inst:{value:Mt,getSnapshot:bt}}),St=wt[0].inst,It=wt[1];return pt(function(){St.value=Mt,St.getSnapshot=bt,mt(St)&&It({inst:St})},[vt,Mt,bt]),ut(function(){return mt(St)&&It({inst:St}),vt(function(){mt(St)&&It({inst:St})})},[vt]),yt(Mt),Mt}function mt(vt){var bt=vt.getSnapshot;vt=vt.value;try{var Mt=bt();return!ct(vt,Mt)}catch{return!0}}function kt(vt,bt){return bt()}var _t=typeof window>"u"||typeof window.document>"u"||typeof window.document.createElement>"u"?kt:ft;return useSyncExternalStoreShim_production.useSyncExternalStore=rt.useSyncExternalStore!==void 0?rt.useSyncExternalStore:_t,useSyncExternalStoreShim_production}var hasRequiredShim;function requireShim(){return hasRequiredShim||(hasRequiredShim=1,shim.exports=requireUseSyncExternalStoreShim_production()),shim.exports}var shimExports=requireShim();const notReadyT=(rt,it)=>isString$1(it)?it:isObject$3(it)&&isString$1(it.defaultValue)?it.defaultValue:Array.isArray(rt)?rt[rt.length-1]:rt,notReadySnapshot={t:notReadyT,ready:!1},dummySubscribe=()=>()=>{},useTranslation=(rt,it={})=>{const{i18n:ct}=it,{i18n:dt,defaultNS:ut}=reactExports.useContext(I18nContext)||{},pt=ct||dt||getI18n();pt&&!pt.reportNamespaces&&(pt.reportNamespaces=new ReportNamespaces),pt||warnOnce(pt,"NO_I18NEXT_INSTANCE","useTranslation: You will need to pass in an i18next instance by using initReactI18next");const yt=reactExports.useMemo(()=>({...getDefaults(),...pt?.options?.react,...it}),[pt,it]),{useSuspense:ft,keyPrefix:mt}=yt,kt=ut||pt?.options?.defaultNS,_t=isString$1(kt)?[kt]:kt||["translation"],vt=reactExports.useMemo(()=>_t,_t);pt?.reportNamespaces?.addUsedNamespaces?.(vt);const bt=reactExports.useRef(0),Mt=reactExports.useCallback(Yt=>{if(!pt)return dummySubscribe;const{bindI18n:aa,bindI18nStore:Qt}=yt,oa=()=>{bt.current+=1,Yt()};return aa&&pt.on(aa,oa),Qt&&pt.store.on(Qt,oa),()=>{aa&&aa.split(" ").forEach(la=>pt.off(la,oa)),Qt&&Qt.split(" ").forEach(la=>pt.store.off(la,oa))}},[pt,yt]),wt=reactExports.useRef(),St=reactExports.useCallback(()=>{if(!pt)return notReadySnapshot;const Yt=!!(pt.isInitialized||pt.initializedStoreOnce)&&vt.every(ra=>hasLoadedNamespace(ra,pt,yt)),aa=it.lng||pt.language,Qt=bt.current,oa=wt.current;if(oa&&oa.ready===Yt&&oa.lng===aa&&oa.keyPrefix===mt&&oa.revision===Qt)return oa;const Kt={t:pt.getFixedT(aa,yt.nsMode==="fallback"?vt:vt[0],mt),ready:Yt,lng:aa,keyPrefix:mt,revision:Qt};return wt.current=Kt,Kt},[pt,vt,mt,yt,it.lng]),[It,Nt]=reactExports.useState(0),{t:$t,ready:Et}=shimExports.useSyncExternalStore(Mt,St,St);reactExports.useEffect(()=>{if(pt&&!Et&&!ft){const Yt=()=>Nt(aa=>aa+1);it.lng?loadLanguages(pt,it.lng,vt,Yt):loadNamespaces(pt,vt,Yt)}},[pt,it.lng,vt,Et,ft,It]);const Ft=pt||{},qt=reactExports.useRef(null),Ht=reactExports.useRef(),Ot=Yt=>{const aa=Object.getOwnPropertyDescriptors(Yt);aa.__original&&delete aa.__original;const Qt=Object.create(Object.getPrototypeOf(Yt),aa);if(!Object.prototype.hasOwnProperty.call(Qt,"__original"))try{Object.defineProperty(Qt,"__original",{value:Yt,writable:!1,enumerable:!1,configurable:!1})}catch{}return Qt},Zt=reactExports.useMemo(()=>{const Yt=Ft,aa=Yt?.language;let Qt=Yt;Yt&&(qt.current&&qt.current.__original===Yt?Ht.current!==aa?(Qt=Ot(Yt),qt.current=Qt,Ht.current=aa):Qt=qt.current:(Qt=Ot(Yt),qt.current=Qt,Ht.current=aa));const oa=[$t,Qt,Et];return oa.t=$t,oa.i18n=Qt,oa.ready=Et,oa},[$t,Ft,Et,Ft.resolvedLanguage,Ft.language,Ft.languages]);if(pt&&ft&&!Et)throw new Promise(Yt=>{const aa=()=>Yt();it.lng?loadLanguages(pt,it.lng,vt,aa):loadNamespaces(pt,vt,aa)});return Zt};function LanguageSwitcher(){const{i18n:rt}=useTranslation(),[it,ct]=reactExports.useState(!1),dt=reactExports.useRef(null),ut=[{code:"en",label:"English",disabled:!1},{code:"ru",label:"Русский",disabled:!1}],pt=ut.find(ft=>ft.code===rt.language)||ut[0];reactExports.useEffect(()=>{const ft=mt=>{dt.current&&!dt.current.contains(mt.target)&&ct(!1)};return document.addEventListener("mousedown",ft),()=>document.removeEventListener("mousedown",ft)},[]);const yt=(ft,mt)=>{mt||(rt.changeLanguage(ft),ct(!1))};return jsxRuntimeExports.jsxs("div",{className:"relative",ref:dt,children:[jsxRuntimeExports.jsxs("button",{onClick:()=>ct(!it),className:"flex items-center gap-2 px-3 py-2 rounded-lg hover:bg-slate-800 transition-colors text-slate-400 hover:text-white",title:"Change language",children:[jsxRuntimeExports.jsx(Globe,{size:18}),jsxRuntimeExports.jsx("span",{className:"text-sm font-medium",children:pt.code.toUpperCase()})]}),it&&jsxRuntimeExports.jsx("div",{className:"absolute right-0 top-full mt-2 w-40 bg-slate-900 border border-slate-800 rounded-xl shadow-2xl overflow-hidden z-50",children:jsxRuntimeExports.jsx("div",{className:"py-1",children:ut.map(ft=>jsxRuntimeExports.jsxs("button",{onClick:()=>yt(ft.code,ft.disabled),disabled:ft.disabled,className:`w-full text-left px-4 py-3 text-sm transition-colors flex items-center justify-between ${rt.language===ft.code?"bg-primary/10 text-primary font-medium":ft.disabled?"text-slate-600 cursor-not-allowed opacity-50":"text-slate-300 hover:bg-slate-800 hover:text-white"}`,children:[jsxRuntimeExports.jsx("span",{className:ft.disabled?"line-through":"",children:ft.label}),rt.language===ft.code&&!ft.disabled&&jsxRuntimeExports.jsx(Check,{size:16,className:"text-primary"})]},ft.code))})})]})}function Navbar(){const{t:rt}=useTranslation(),it=useLocation(),ct=useNavigate(),dt=it.pathname==="/",ut=()=>{dt?window.scrollTo({top:0,behavior:"smooth"}):(ct("/"),window.scrollTo(0,0))};return jsxRuntimeExports.jsx("nav",{className:"fixed top-0 w-full z-50 glass-panel border-b-0 border-white/5",children:jsxRuntimeExports.jsx("div",{className:"max-w-7xl mx-auto px-6",children:jsxRuntimeExports.jsxs("div",{className:"flex items-center justify-between h-16",children:[jsxRuntimeExports.jsxs("div",{className:"flex items-center gap-8",children:[jsxRuntimeExports.jsxs("div",{onClick:ut,className:"flex items-center gap-2 cursor-pointer hover:opacity-80 transition-opacity",children:[jsxRuntimeExports.jsx("div",{className:"w-8 h-8 bg-primary/20 rounded-lg flex items-center justify-center border border-primary/30",children:jsxRuntimeExports.jsx("span",{className:"font-bold text-primary text-sm",children:"EP"})}),jsxRuntimeExports.jsx("span",{className:"font-semibold text-lg tracking-tight text-white",children:"EasyP"})]}),jsxRuntimeExports.jsx("a",{href:"/docs",className:"text-sm font-medium text-slate-400 hover:text-white transition-colors",children:rt("nav.documentation")}),jsxRuntimeExports.jsx("a",{href:"/blog",className:"text-sm font-medium text-slate-400 hover:text-white transition-colors",children:rt("nav.blog")})]}),jsxRuntimeExports.jsx("div",{className:"flex-1"}),jsxRuntimeExports.jsxs("div",{className:"flex items-center gap-4",children:[jsxRuntimeExports.jsxs("a",{href:"https://github.com/easyp-tech/easyp",className:"hidden sm:flex items-center gap-2 text-sm font-medium text-slate-400 hover:text-white transition-colors",children:[jsxRuntimeExports.jsx(Code,{size:16})," ",rt("nav.github")]}),jsxRuntimeExports.jsx(LanguageSwitcher,{})]})]})})})}async function GetLatestRelease(){try{const rt=await fetch("https://api.github.com/repos/easyp-tech/easyp/tags");if(!rt.ok)throw new Error(`GitHub API returned status code ${rt.status}`);const it=await rt.json();if(it.length===0)throw new Error("No tags found for this repository");const ct=it.filter(dt=>{const ut=dt.name.toLowerCase();return!ut.includes("-rc")&&!ut.includes("-alpha")&&!ut.includes("-beta")&&!ut.includes("-pre")&&!ut.includes("-dev")});return ct.length===0?it[0].name:ct[0].name}catch(rt){return console.error(rt),"unknown version"}}function Hero(){const{t:rt}=useTranslation(),[it,ct]=reactExports.useState("brew"),[dt,ut]=reactExports.useState(!1),[pt,yt]=reactExports.useState("vX.X.X"),ft=reactExports.useRef(null),mt=[{id:"brew",label:"brew",fullLabel:"macOS (homebrew)",cmd:"brew install easyp-tech/tap/easyp"},{id:"go",label:"go",fullLabel:"go Install (any OS)",cmd:"go install github.com/easyp-tech/easyp/cmd/easyp@latest"},{id:"docker",label:"docker",fullLabel:"docker",cmd:"docker pull easyp/easyp:latest"}],kt=mt.find(vt=>vt.id===it)||mt[0];reactExports.useEffect(()=>{const vt=navigator.platform.toLowerCase(),bt=navigator.userAgent.toLowerCase();vt.includes("mac")||bt.includes("mac")?ct("brew"):(vt.includes("linux")||bt.includes("linux")||vt.includes("win")||bt.includes("win"),ct("go"));const Mt=wt=>{ft.current&&!ft.current.contains(wt.target)&&ut(!1)};return document.addEventListener("mousedown",Mt),()=>document.removeEventListener("mousedown",Mt)},[]),reactExports.useEffect(()=>{GetLatestRelease().then(vt=>{vt!=="unknown version"&&yt(vt)})},[]);const _t=()=>{navigator.clipboard.writeText(kt.cmd)};return jsxRuntimeExports.jsxs("section",{className:"relative pt-32 pb-20 lg:pt-48 lg:pb-32 overflow-hidden",children:[jsxRuntimeExports.jsx("div",{className:"absolute top-0 left-1/2 -translate-x-1/2 w-[1000px] h-[600px] bg-primary/20 rounded-full blur-[120px] opacity-30 pointer-events-none"}),jsxRuntimeExports.jsxs("div",{className:"max-w-7xl mx-auto px-6 relative z-10",children:[jsxRuntimeExports.jsxs("div",{className:"flex flex-col items-center text-center mb-16",children:[jsxRuntimeExports.jsxs("div",{className:"flex gap-3 mb-8 animate-fade-in-up",children:[jsxRuntimeExports.jsxs("div",{className:"inline-flex items-center gap-2 px-3 py-1 rounded-full bg-slate-800/50 border border-slate-700/50 text-primary text-xs font-medium",children:[jsxRuntimeExports.jsxs("span",{className:"relative flex h-2 w-2",children:[jsxRuntimeExports.jsx("span",{className:"animate-ping absolute inline-flex h-full w-full rounded-full bg-primary opacity-75"}),jsxRuntimeExports.jsx("span",{className:"relative inline-flex rounded-full h-2 w-2 bg-primary"})]}),pt]}),jsxRuntimeExports.jsxs("div",{className:"inline-flex items-center gap-2 px-3 py-1 rounded-full bg-slate-800/50 border border-slate-700/50 text-slate-300 text-xs font-medium",children:[jsxRuntimeExports.jsx(Shield,{size:12,className:"text-emerald-400"}),rt("hero.badge.license")]})]}),jsxRuntimeExports.jsxs("h1",{className:"text-5xl lg:text-7xl font-bold text-white tracking-tight leading-[1.1] mb-6 max-w-4xl animate-fade-in-up [animation-delay:100ms]",children:[rt("hero.title")," ",jsxRuntimeExports.jsx("br",{}),jsxRuntimeExports.jsx("span",{className:"text-gradient",children:rt("hero.titleHighlight")})]}),jsxRuntimeExports.jsx("p",{className:"text-lg text-slate-400 max-w-2xl mb-10 leading-relaxed animate-fade-in-up [animation-delay:200ms]",children:rt("hero.subtitle")}),jsxRuntimeExports.jsxs("div",{className:"flex flex-col sm:flex-row items-center gap-4 animate-fade-in-up [animation-delay:300ms] w-full max-w-2xl relative z-20",children:[jsxRuntimeExports.jsxs("div",{className:"relative w-full sm:w-auto flex-grow group",ref:ft,children:[jsxRuntimeExports.jsxs("div",{className:"flex items-center bg-slate-900 border border-slate-800 rounded-xl px-1 py-1 pr-2 shadow-xl w-full group-hover:border-slate-600 transition-colors",children:[jsxRuntimeExports.jsxs("button",{onClick:()=>ut(!dt),className:"flex items-center gap-2 text-slate-300 hover:text-white hover:bg-slate-800 transition-all text-sm font-medium px-3 py-2 rounded-lg shrink-0 border-r border-slate-800/50 mr-2",title:"Select installation method",children:[jsxRuntimeExports.jsx("span",{children:kt.label}),jsxRuntimeExports.jsx(ChevronDown,{size:14,className:`text-slate-500 transition-transform duration-200 ${dt?"rotate-180":""}`})]}),jsxRuntimeExports.jsxs("div",{className:"flex-grow overflow-hidden flex items-center",children:[jsxRuntimeExports.jsx(ChevronRight,{size:14,className:"text-slate-600 mr-2 shrink-0"}),jsxRuntimeExports.jsx("code",{className:"font-mono text-sm text-slate-300 whitespace-nowrap overflow-x-auto no-scrollbar block selection:bg-primary/30 selection:text-white",children:kt.cmd})]}),jsxRuntimeExports.jsx("button",{className:"p-2 hover:bg-slate-800 rounded-lg transition-colors text-slate-500 hover:text-white shrink-0 ml-2",title:"Copy to clipboard",onClick:_t,children:jsxRuntimeExports.jsx(Copy,{size:16})})]}),dt&&jsxRuntimeExports.jsx("div",{className:"absolute top-full left-0 mt-2 w-64 bg-slate-900 border border-slate-800 rounded-xl shadow-2xl overflow-hidden z-30",children:jsxRuntimeExports.jsx("div",{className:"py-1",children:mt.map(vt=>jsxRuntimeExports.jsxs("button",{onClick:()=>{ct(vt.id),ut(!1)},className:`w-full text-left px-4 py-3 text-sm transition-colors flex items-center justify-between group ${it===vt.id?"bg-primary/10":"hover:bg-slate-800"}`,children:[jsxRuntimeExports.jsx("span",{className:`${it===vt.id?"text-primary font-medium":"text-slate-300 group-hover:text-white"}`,children:vt.fullLabel}),it===vt.id&&jsxRuntimeExports.jsx(CircleCheckBig,{size:16,className:"text-primary"})]},vt.id))})})]}),jsxRuntimeExports.jsx(Link$1,{to:"/docs",className:"w-full sm:w-auto px-6 py-3 rounded-full bg-primary/10 text-primary font-medium hover:bg-primary/20 transition-colors border border-primary/20 whitespace-nowrap text-center inline-block",children:rt("hero.exploreDocs")})]})]}),jsxRuntimeExports.jsxs("div",{className:"relative max-w-5xl mx-auto rounded-xl border border-slate-800 bg-slate-950/80 shadow-2xl shadow-primary/10 overflow-hidden animate-fade-in-up [animation-delay:500ms]",children:[jsxRuntimeExports.jsxs("div",{className:"flex items-center px-4 py-3 border-b border-slate-800 bg-slate-900/50 gap-2",children:[jsxRuntimeExports.jsx("div",{className:"w-3 h-3 rounded-full bg-slate-700"}),jsxRuntimeExports.jsx("div",{className:"w-3 h-3 rounded-full bg-slate-700"}),jsxRuntimeExports.jsx("div",{className:"w-3 h-3 rounded-full bg-slate-700"}),jsxRuntimeExports.jsx("div",{className:"ml-4 text-xs text-slate-500 font-mono",children:"easyp — zsh"})]}),jsxRuntimeExports.jsxs("div",{className:"p-6 sm:p-10 font-mono text-sm sm:text-base leading-loose",children:[jsxRuntimeExports.jsxs("div",{className:"flex items-start gap-2",children:[jsxRuntimeExports.jsx("span",{className:"text-primary font-bold",children:"➜"}),jsxRuntimeExports.jsx("span",{className:"text-slate-300",children:"easyp generate -v"})]}),jsxRuntimeExports.jsxs("div",{className:"text-slate-400 mt-2 pl-4 border-l-2 border-slate-800",children:[jsxRuntimeExports.jsxs("div",{className:"flex items-center gap-2",children:[jsxRuntimeExports.jsx("span",{className:"text-emerald-400",children:"✔"}),jsxRuntimeExports.jsxs("span",{children:["Resolving dependencies from ",jsxRuntimeExports.jsx("span",{className:"text-slate-300 underline decoration-slate-700",children:"easyp.lock"}),"..."]})]}),jsxRuntimeExports.jsxs("div",{className:"flex items-center gap-2 mt-1",children:[jsxRuntimeExports.jsx("span",{className:"text-emerald-400",children:"✔"}),jsxRuntimeExports.jsxs("span",{children:["Connecting to EasyP Service... ",jsxRuntimeExports.jsx("span",{className:"text-xs bg-emerald-500/10 text-emerald-400 px-1.5 py-0.5 rounded",children:"Connected"})]})]}),jsxRuntimeExports.jsxs("div",{className:"mt-2",children:[jsxRuntimeExports.jsx("span",{className:"text-blue-400",children:"[INFO]"})," Dispatching plugins:",jsxRuntimeExports.jsxs("div",{className:"pl-4 mt-1 text-slate-500",children:["├─ protoc-gen-go (v1.31) ",jsxRuntimeExports.jsx("span",{className:"text-xs border border-slate-700 px-1 rounded text-slate-400",children:"WASM"}),jsxRuntimeExports.jsx("br",{}),"└─ custom-java-gen (v2.0) ",jsxRuntimeExports.jsx("span",{className:"text-xs border border-slate-700 px-1 rounded text-slate-400",children:"DOCKER"})]})]}),jsxRuntimeExports.jsxs("div",{className:"mt-2 text-slate-300",children:["✨ Generation complete in ",jsxRuntimeExports.jsx("span",{className:"text-primary",children:"420ms"}),"."]})]}),jsxRuntimeExports.jsxs("div",{className:"flex items-start gap-2 mt-4 animate-pulse",children:[jsxRuntimeExports.jsx("span",{className:"text-primary font-bold",children:"➜"}),jsxRuntimeExports.jsx("span",{className:"w-2 h-5 bg-slate-500 inline-block align-middle"})]})]})]})]})]})}const partners=[{name:"comazo",url:"https://comazo.ru/site_new/index.php",logo:"/assets/partners/comazo.svg"},{name:"YADRO",url:"https://yadro.com/",logo:"/assets/partners/yadro.png"},{name:"h3",url:"https://h3llo.cloud/",logo:"/assets/partners/h3.png"},{name:"OpenIDE",url:"https://openide.ru/",logo:"/assets/partners/openide.png"},{name:"Positive Tech",url:"https://ptsecurity.com/",logo:"/assets/partners/pt.png"}];function PartnerItem({partner:rt}){const[it,ct]=reactExports.useState(!1);return jsxRuntimeExports.jsx("a",{href:rt.url,target:"_blank",rel:"noopener noreferrer",className:"opacity-40 grayscale whitespace-nowrap flex-shrink-0 hover:opacity-70 transition-opacity",children:rt.logo&&!it?jsxRuntimeExports.jsx("img",{src:rt.logo,alt:rt.name,className:"h-8 w-auto",onError:()=>ct(!0)}):jsxRuntimeExports.jsx("span",{className:"text-xl font-bold text-white",children:rt.name})})}function TrustedBy(){const{t:rt}=useTranslation(),it=[...partners,...partners,...partners,...partners];return jsxRuntimeExports.jsx("section",{className:"py-12 border-y border-white/5 bg-slate-900/30 relative overflow-hidden",children:jsxRuntimeExports.jsxs("div",{className:"max-w-7xl mx-auto px-6 text-center",children:[jsxRuntimeExports.jsx("p",{className:"text-sm font-medium text-slate-500 mb-8 uppercase tracking-wider",children:rt("trustedBy.title")}),jsxRuntimeExports.jsxs("div",{className:"relative",children:[jsxRuntimeExports.jsx("div",{className:"absolute left-0 top-0 bottom-0 w-[100px] bg-gradient-to-r from-background to-transparent z-10 pointer-events-none"}),jsxRuntimeExports.jsx("div",{className:"absolute right-0 top-0 bottom-0 w-[100px] bg-gradient-to-l from-background to-transparent z-10 pointer-events-none"}),jsxRuntimeExports.jsx("div",{className:"flex items-center gap-12 animate-marquee hover:[animation-play-state:paused]",children:it.map((ct,dt)=>jsxRuntimeExports.jsx(PartnerItem,{partner:ct},`${ct.name}-${dt}`))})]})]})})}function FeatureSwitcher(){const{t:rt}=useTranslation(),[it,ct]=reactExports.useState("cli");return jsxRuntimeExports.jsx("section",{id:"features",className:"py-32 bg-background relative",children:jsxRuntimeExports.jsxs("div",{className:"max-w-7xl mx-auto px-6",children:[jsxRuntimeExports.jsxs("div",{className:"text-center mb-16",children:[jsxRuntimeExports.jsxs("h2",{className:"text-3xl md:text-4xl font-bold text-white mb-4",children:[rt("features.title")," ",jsxRuntimeExports.jsx("span",{className:"text-primary",children:rt("features.titleHighlight")})]}),jsxRuntimeExports.jsx("p",{className:"text-slate-400 text-lg max-w-2xl mx-auto",children:rt("features.subtitle")})]}),jsxRuntimeExports.jsx("div",{className:"flex justify-center mb-16",children:jsxRuntimeExports.jsxs("div",{className:"bg-slate-900 p-1.5 rounded-full border border-slate-800 inline-flex shadow-inner",children:[jsxRuntimeExports.jsx("button",{onClick:()=>ct("cli"),className:`px-8 py-2.5 rounded-full text-sm font-medium transition-all duration-300 ${it==="cli"?"bg-white text-black shadow-lg":"text-slate-400 hover:text-white"}`,children:rt("features.localDev")}),jsxRuntimeExports.jsx("button",{onClick:()=>ct("server"),className:`px-8 py-2.5 rounded-full text-sm font-medium transition-all duration-300 ${it==="server"?"bg-white text-black shadow-lg":"text-slate-400 hover:text-white"}`,children:rt("features.remoteInfra")})]})}),jsxRuntimeExports.jsxs("div",{className:"grid lg:grid-cols-2 gap-12 items-center",children:[jsxRuntimeExports.jsx("div",{className:"space-y-8",children:it==="cli"?jsxRuntimeExports.jsxs("div",{className:"animate-fade-in-up",children:[jsxRuntimeExports.jsx("h3",{className:"text-2xl font-semibold text-white mb-4",children:rt("features.cli.title")}),jsxRuntimeExports.jsx("p",{className:"text-slate-400 text-lg leading-relaxed mb-8",children:rt("features.cli.description")}),jsxRuntimeExports.jsxs("ul",{className:"space-y-4",children:[jsxRuntimeExports.jsxs("li",{className:"flex gap-4",children:[jsxRuntimeExports.jsx("div",{className:"w-6 h-6 rounded-full bg-primary/10 flex items-center justify-center shrink-0 text-primary mt-1",children:jsxRuntimeExports.jsx(Package,{size:14})}),jsxRuntimeExports.jsxs("div",{children:[jsxRuntimeExports.jsx("h4",{className:"text-white font-medium",children:rt("features.cli.packageManager.title")}),jsxRuntimeExports.jsx("p",{className:"text-sm text-slate-500",children:rt("features.cli.packageManager.desc")})]})]}),jsxRuntimeExports.jsxs("li",{className:"flex gap-4",children:[jsxRuntimeExports.jsx("div",{className:"w-6 h-6 rounded-full bg-primary/10 flex items-center justify-center shrink-0 text-primary mt-1",children:jsxRuntimeExports.jsx(CircleCheckBig,{size:14})}),jsxRuntimeExports.jsxs("div",{children:[jsxRuntimeExports.jsx("h4",{className:"text-white font-medium",children:rt("features.cli.linting.title")}),jsxRuntimeExports.jsx("p",{className:"text-sm text-slate-500",children:rt("features.cli.linting.desc")})]})]}),jsxRuntimeExports.jsxs("li",{className:"flex gap-4",children:[jsxRuntimeExports.jsx("div",{className:"w-6 h-6 rounded-full bg-primary/10 flex items-center justify-center shrink-0 text-primary mt-1",children:jsxRuntimeExports.jsx(CircleCheckBig,{size:14})}),jsxRuntimeExports.jsxs("div",{children:[jsxRuntimeExports.jsx("h4",{className:"text-white font-medium",children:rt("features.cli.apiSafety.title")}),jsxRuntimeExports.jsx("p",{className:"text-sm text-slate-500",children:rt("features.cli.apiSafety.desc")})]})]})]})]}):jsxRuntimeExports.jsxs("div",{className:"animate-fade-in-up",children:[jsxRuntimeExports.jsx("h3",{className:"text-2xl font-semibold text-white mb-4",children:rt("features.server.title")}),jsxRuntimeExports.jsx("p",{className:"text-slate-400 text-lg leading-relaxed mb-8",children:rt("features.server.description")}),jsxRuntimeExports.jsxs("ul",{className:"space-y-4",children:[jsxRuntimeExports.jsxs("li",{className:"flex gap-4",children:[jsxRuntimeExports.jsx("div",{className:"w-6 h-6 rounded-full bg-secondary/10 flex items-center justify-center shrink-0 text-secondary mt-1",children:jsxRuntimeExports.jsx(Shield,{size:14})}),jsxRuntimeExports.jsxs("div",{children:[jsxRuntimeExports.jsx("h4",{className:"text-white font-medium",children:rt("features.server.dockerNative.title")}),jsxRuntimeExports.jsx("p",{className:"text-sm text-slate-500",children:rt("features.server.dockerNative.desc")})]})]}),jsxRuntimeExports.jsxs("li",{className:"flex gap-4",children:[jsxRuntimeExports.jsx("div",{className:"w-6 h-6 rounded-full bg-secondary/10 flex items-center justify-center shrink-0 text-secondary mt-1",children:jsxRuntimeExports.jsx(Shield,{size:14})}),jsxRuntimeExports.jsxs("div",{children:[jsxRuntimeExports.jsx("h4",{className:"text-white font-medium",children:rt("features.server.airGap.title")}),jsxRuntimeExports.jsx("p",{className:"text-sm text-slate-500",children:rt("features.server.airGap.desc")})]})]}),jsxRuntimeExports.jsxs("li",{className:"flex gap-4",children:[jsxRuntimeExports.jsx("div",{className:"w-6 h-6 rounded-full bg-secondary/10 flex items-center justify-center shrink-0 text-secondary mt-1",children:jsxRuntimeExports.jsx(Shield,{size:14})}),jsxRuntimeExports.jsxs("div",{children:[jsxRuntimeExports.jsx("h4",{className:"text-white font-medium",children:rt("features.server.costEffective.title")}),jsxRuntimeExports.jsx("p",{className:"text-sm text-slate-500",children:rt("features.server.costEffective.desc")})]})]})]})]})}),jsxRuntimeExports.jsxs("div",{className:"relative group",children:[jsxRuntimeExports.jsx("div",{className:"absolute -inset-1 bg-gradient-to-r from-primary to-secondary rounded-2xl blur opacity-20 group-hover:opacity-40 transition duration-1000 group-hover:duration-200"}),jsxRuntimeExports.jsxs("div",{className:"relative rounded-xl bg-slate-900 border border-slate-800 overflow-hidden shadow-2xl h-[400px] flex flex-col",children:[jsxRuntimeExports.jsxs("div",{className:"flex items-center px-4 py-3 border-b border-slate-800 bg-slate-900/50 gap-2",children:[jsxRuntimeExports.jsx("div",{className:"w-3 h-3 rounded-full bg-slate-700"}),jsxRuntimeExports.jsx("div",{className:"w-3 h-3 rounded-full bg-slate-700"})]}),jsxRuntimeExports.jsx("div",{className:"p-6 font-mono text-sm flex-grow overflow-hidden",children:it==="cli"?jsxRuntimeExports.jsxs("div",{className:"space-y-2",children:[jsxRuntimeExports.jsx("div",{className:"text-slate-400",children:"# easyp.yaml configuration"}),jsxRuntimeExports.jsxs("div",{className:"text-purple-400",children:["version: ",jsxRuntimeExports.jsx("span",{className:"text-green-400",children:"v1"})]}),jsxRuntimeExports.jsx("div",{className:"text-purple-400",children:"deps:"}),jsxRuntimeExports.jsx("div",{className:"pl-4 text-slate-300",children:"- github.com/googleapis/googleapis@v1.0"}),jsxRuntimeExports.jsx("div",{className:"text-purple-400 mt-2",children:"lint:"}),jsxRuntimeExports.jsx("div",{className:"pl-4 text-blue-400",children:"use:"}),jsxRuntimeExports.jsx("div",{className:"pl-8 text-slate-300",children:"- STANDARD"}),jsxRuntimeExports.jsx("div",{className:"pl-8 text-slate-300",children:"- COMMENTS"}),jsxRuntimeExports.jsx("div",{className:"text-purple-400 mt-4",children:"breaking:"}),jsxRuntimeExports.jsx("div",{className:"pl-4 text-blue-400",children:"ignore:"}),jsxRuntimeExports.jsx("div",{className:"pl-8 text-slate-300",children:'- "proto/alfa/v1"'})]}):jsxRuntimeExports.jsxs("div",{className:"space-y-2",children:[jsxRuntimeExports.jsx("div",{className:"text-slate-400",children:"# Server Infrastructure"}),jsxRuntimeExports.jsxs("div",{className:"flex items-center gap-2 py-2 border-b border-slate-800/50",children:[jsxRuntimeExports.jsx(Box,{size:16,className:"text-blue-400"}),jsxRuntimeExports.jsx("span",{className:"text-slate-200",children:"EasyP Service"}),jsxRuntimeExports.jsx("span",{className:"ml-auto text-xs bg-green-500/10 text-green-500 px-2 rounded-full",children:"Healthy"})]}),jsxRuntimeExports.jsxs("div",{className:"pl-4 border-l border-slate-800 space-y-3 mt-3",children:[jsxRuntimeExports.jsxs("div",{className:"flex items-center gap-2",children:[jsxRuntimeExports.jsx("div",{className:"w-2 h-2 bg-slate-600 rounded-full"}),jsxRuntimeExports.jsx("span",{className:"text-slate-400",children:"Registry:"}),jsxRuntimeExports.jsx("span",{className:"text-slate-200",children:"Local Docker"})]}),jsxRuntimeExports.jsxs("div",{className:"flex items-center gap-2",children:[jsxRuntimeExports.jsx("div",{className:"w-2 h-2 bg-slate-600 rounded-full"}),jsxRuntimeExports.jsx("span",{className:"text-slate-400",children:"Plugins:"}),jsxRuntimeExports.jsx("span",{className:"text-slate-200",children:"14 Loaded"})]}),jsxRuntimeExports.jsxs("div",{className:"flex items-center gap-2",children:[jsxRuntimeExports.jsx("div",{className:"w-2 h-2 bg-slate-600 rounded-full"}),jsxRuntimeExports.jsx("span",{className:"text-slate-400",children:"Uptime:"}),jsxRuntimeExports.jsx("span",{className:"text-slate-200",children:"42d 12h"})]})]})]})})]})]})]})]})})}function ArchitectureComparison(){const{t:rt}=useTranslation(),it=[{icon:Globe,titleKey:"architecture.dataSovereignty.title",descriptionKey:"architecture.dataSovereignty.description",iconBg:"bg-blue-500/10",iconColor:"text-blue-400",hoverBorder:"hover:border-blue-500/30"},{icon:Layers,titleKey:"architecture.hybridRuntime.title",descriptionKey:"architecture.hybridRuntime.description",iconBg:"bg-purple-500/10",iconColor:"text-purple-400",hoverBorder:"hover:border-purple-500/30"},{icon:Lock,titleKey:"architecture.noVendorLock.title",descriptionKey:"architecture.noVendorLock.description",iconBg:"bg-emerald-500/10",iconColor:"text-emerald-400",hoverBorder:"hover:border-emerald-500/30"}];return jsxRuntimeExports.jsxs("section",{className:"py-32 bg-slate-950/50 relative overflow-hidden",children:[jsxRuntimeExports.jsx("div",{className:"absolute top-1/2 left-1/2 -translate-x-1/2 -translate-y-1/2 w-[800px] h-[800px] bg-primary/10 rounded-full blur-[150px] opacity-20 pointer-events-none"}),jsxRuntimeExports.jsxs("div",{className:"max-w-7xl mx-auto px-6 relative z-10",children:[jsxRuntimeExports.jsxs("div",{className:"text-center mb-20",children:[jsxRuntimeExports.jsx("h2",{className:"text-3xl md:text-5xl font-bold text-white mb-5",children:rt("architecture.title")}),jsxRuntimeExports.jsx("p",{className:"text-slate-400 text-lg max-w-2xl mx-auto",children:rt("architecture.subtitle")})]}),jsxRuntimeExports.jsx("div",{className:"grid md:grid-cols-3 gap-8",children:it.map((ct,dt)=>{const ut=ct.icon;return jsxRuntimeExports.jsxs("div",{className:`glass-panel p-8 rounded-2xl border border-white/5 ${ct.hoverBorder} transition-colors group`,children:[jsxRuntimeExports.jsx("div",{className:`w-14 h-14 ${ct.iconBg} rounded-xl flex items-center justify-center ${ct.iconColor} mb-6 group-hover:scale-110 transition-transform`,children:jsxRuntimeExports.jsx(ut,{size:28})}),jsxRuntimeExports.jsx("h3",{className:"text-xl font-semibold text-white mb-3",children:rt(ct.titleKey)}),jsxRuntimeExports.jsx("p",{className:"text-slate-400 leading-relaxed",dangerouslySetInnerHTML:{__html:rt(ct.descriptionKey).replace(/\*\*(.+?)\*\*/g,"<strong>$1</strong>")}})]},dt)})})]})]})}function Footer(){const{t:rt}=useTranslation();return jsxRuntimeExports.jsx("footer",{className:"bg-slate-950 border-t border-slate-800 py-16",children:jsxRuntimeExports.jsxs("div",{className:"max-w-7xl mx-auto px-6",children:[jsxRuntimeExports.jsxs("div",{className:"grid md:grid-cols-4 gap-12",children:[jsxRuntimeExports.jsxs("div",{className:"col-span-2",children:[jsxRuntimeExports.jsxs("div",{className:"flex items-center gap-2 mb-6",children:[jsxRuntimeExports.jsx("div",{className:"w-6 h-6 bg-primary/20 rounded flex items-center justify-center text-primary text-xs font-bold",children:"E"}),jsxRuntimeExports.jsx("span",{className:"font-bold text-white",children:"EasyP"})]}),jsxRuntimeExports.jsx("p",{className:"text-slate-400 text-sm max-w-xs leading-relaxed mb-4",children:rt("footer.description")}),jsxRuntimeExports.jsxs("div",{className:"flex items-center gap-2 text-xs text-slate-500",children:[jsxRuntimeExports.jsx(Shield,{size:12})," ",rt("footer.license")]})]}),jsxRuntimeExports.jsxs("div",{children:[jsxRuntimeExports.jsx("h4",{className:"text-white font-medium mb-4",children:rt("footer.product.title")}),jsxRuntimeExports.jsxs("ul",{className:"space-y-3 text-sm text-slate-400",children:[jsxRuntimeExports.jsx("li",{children:jsxRuntimeExports.jsx("a",{href:"/docs/guide/cli/linter/linter",className:"hover:text-primary",children:rt("footer.product.cliTool")})}),jsxRuntimeExports.jsx("li",{children:jsxRuntimeExports.jsx("a",{href:"/docs/guide/api-service/overview",className:"hover:text-primary",children:rt("footer.product.apiService")})}),jsxRuntimeExports.jsx("li",{children:jsxRuntimeExports.jsx("a",{href:"/docs",className:"hover:text-primary",children:rt("footer.product.documentation")})})]})]}),jsxRuntimeExports.jsxs("div",{children:[jsxRuntimeExports.jsx("h4",{className:"text-white font-medium mb-4",children:rt("footer.community.title")}),jsxRuntimeExports.jsxs("ul",{className:"space-y-3 text-sm text-slate-400",children:[jsxRuntimeExports.jsx("li",{children:jsxRuntimeExports.jsx("a",{href:"https://github.com/easyp-tech/easyp",className:"hover:text-primary",children:rt("footer.community.github")})}),jsxRuntimeExports.jsx("li",{children:jsxRuntimeExports.jsx("a",{href:"https://t.me/easyptech",className:"hover:text-primary",children:rt("footer.community.telegram")})})]})]})]}),jsxRuntimeExports.jsx("div",{className:"border-t border-slate-800 mt-16 pt-8 flex flex-col md:flex-row justify-between items-center text-xs text-slate-600",children:jsxRuntimeExports.jsx("p",{children:rt("footer.rights")})})]})})}function HomePage(){return jsxRuntimeExports.jsxs("div",{className:"min-h-screen bg-background text-white",children:[jsxRuntimeExports.jsx(Navbar,{}),jsxRuntimeExports.jsx(Hero,{}),jsxRuntimeExports.jsx(TrustedBy,{}),jsxRuntimeExports.jsx(FeatureSwitcher,{}),jsxRuntimeExports.jsx(ArchitectureComparison,{}),jsxRuntimeExports.jsx(Footer,{})]})}const blogPosts=[{title:"Let's Work with Proto Errors Correctly :)",titleRu:"Давайте работать с proto ошибками правильно :)",slug:"working-with-proto-errors-correctly",date:"2025-11-30",excerpt:"Best practices for handling errors in gRPC and Protocol Buffers",excerptRu:"Лучшие практики обработки ошибок в gRPC и Protocol Buffers"},{title:"Finally, give up gin, echo and <your other framework>",titleRu:"Откажитесь уже наконец от gin, echo и <иной ваш фреймворк>",slug:"finally-give-up-gin-echo",date:"2025-11-29",excerpt:"Why it's time to reconsider your web framework choices",excerptRu:"Почему пора пересмотреть выбор вашего веб-фреймворка"}];function BlogPage(){const{i18n:rt}=useTranslation(),it=rt.language==="ru";return jsxRuntimeExports.jsxs("div",{className:"min-h-screen bg-gradient-to-b from-slate-950 via-slate-900 to-slate-950",children:[jsxRuntimeExports.jsx(Navbar,{}),jsxRuntimeExports.jsxs("div",{className:"max-w-4xl mx-auto px-6 pt-32 pb-20",children:[jsxRuntimeExports.jsxs("div",{className:"mb-16",children:[jsxRuntimeExports.jsx("h1",{className:"text-5xl font-bold text-white mb-4",children:it?"Блог":"Blog"}),jsxRuntimeExports.jsx("p",{className:"text-xl text-slate-400",children:it?"Статьи о современных подходах к разработке":"Articles about modern development approaches"})]}),jsxRuntimeExports.jsx("div",{className:"space-y-8",children:blogPosts.map(ct=>jsxRuntimeExports.jsxs(Link$1,{to:`/blog/${ct.slug}`,className:"group block glass-panel p-8 rounded-2xl border border-white/5 hover:border-primary/30 transition-all duration-300 hover:scale-[1.02]",children:[jsxRuntimeExports.jsxs("div",{className:"flex items-start justify-between gap-4 mb-4",children:[jsxRuntimeExports.jsx("h2",{className:"text-2xl font-bold text-white group-hover:text-primary transition-colors",children:it?ct.titleRu:ct.title}),jsxRuntimeExports.jsx(ArrowRight,{className:"w-6 h-6 text-slate-400 group-hover:text-primary group-hover:translate-x-1 transition-all flex-shrink-0"})]}),jsxRuntimeExports.jsx("p",{className:"text-slate-400 mb-4",children:it?ct.excerptRu:ct.excerpt}),jsxRuntimeExports.jsxs("div",{className:"flex items-center text-sm text-slate-500",children:[jsxRuntimeExports.jsx(Calendar,{className:"w-4 h-4 mr-2"}),new Date(ct.date).toLocaleDateString(it?"ru-RU":"en-US",{year:"numeric",month:"long",day:"numeric"})]})]},ct.slug))}),blogPosts.length===0&&jsxRuntimeExports.jsx("div",{className:"text-center py-20",children:jsxRuntimeExports.jsx("p",{className:"text-slate-400 text-lg",children:it?"Статьи скоро появятся":"Articles coming soon"})})]})]})}const __viteBrowserExternal={},__viteBrowserExternal$1=Object.freeze(Object.defineProperty({__proto__:null,default:__viteBrowserExternal},Symbol.toStringTag,{value:"Module"})),require$$0=getAugmentedNamespace(__viteBrowserExternal$1);var kindOf,hasRequiredKindOf;function requireKindOf(){if(hasRequiredKindOf)return kindOf;hasRequiredKindOf=1;var rt=Object.prototype.toString;kindOf=function(vt){if(vt===void 0)return"undefined";if(vt===null)return"null";var bt=typeof vt;if(bt==="boolean")return"boolean";if(bt==="string")return"string";if(bt==="number")return"number";if(bt==="symbol")return"symbol";if(bt==="function")return yt(vt)?"generatorfunction":"function";if(ct(vt))return"array";if(kt(vt))return"buffer";if(mt(vt))return"arguments";if(ut(vt))return"date";if(dt(vt))return"error";if(pt(vt))return"regexp";switch(it(vt)){case"Symbol":return"symbol";case"Promise":return"promise";case"WeakMap":return"weakmap";case"WeakSet":return"weakset";case"Map":return"map";case"Set":return"set";case"Int8Array":return"int8array";case"Uint8Array":return"uint8array";case"Uint8ClampedArray":return"uint8clampedarray";case"Int16Array":return"int16array";case"Uint16Array":return"uint16array";case"Int32Array":return"int32array";case"Uint32Array":return"uint32array";case"Float32Array":return"float32array";case"Float64Array":return"float64array"}if(ft(vt))return"generator";switch(bt=rt.call(vt),bt){case"[object Object]":return"object";case"[object Map Iterator]":return"mapiterator";case"[object Set Iterator]":return"setiterator";case"[object String Iterator]":return"stringiterator";case"[object Array Iterator]":return"arrayiterator"}return bt.slice(8,-1).toLowerCase().replace(/\s/g,"")};function it(_t){return typeof _t.constructor=="function"?_t.constructor.name:null}function ct(_t){return Array.isArray?Array.isArray(_t):_t instanceof Array}function dt(_t){return _t instanceof Error||typeof _t.message=="string"&&_t.constructor&&typeof _t.constructor.stackTraceLimit=="number"}function ut(_t){return _t instanceof Date?!0:typeof _t.toDateString=="function"&&typeof _t.getDate=="function"&&typeof _t.setDate=="function"}function pt(_t){return _t instanceof RegExp?!0:typeof _t.flags=="string"&&typeof _t.ignoreCase=="boolean"&&typeof _t.multiline=="boolean"&&typeof _t.global=="boolean"}function yt(_t,vt){return it(_t)==="GeneratorFunction"}function ft(_t){return typeof _t.throw=="function"&&typeof _t.return=="function"&&typeof _t.next=="function"}function mt(_t){try{if(typeof _t.length=="number"&&typeof _t.callee=="function")return!0}catch(vt){if(vt.message.indexOf("callee")!==-1)return!0}return!1}function kt(_t){return _t.constructor&&typeof _t.constructor.isBuffer=="function"?_t.constructor.isBuffer(_t):!1}return kindOf}var isExtendable,hasRequiredIsExtendable;function requireIsExtendable(){return hasRequiredIsExtendable||(hasRequiredIsExtendable=1,isExtendable=function(it){return typeof it<"u"&&it!==null&&(typeof it=="object"||typeof it=="function")}),isExtendable}var extendShallow,hasRequiredExtendShallow;function requireExtendShallow(){if(hasRequiredExtendShallow)return extendShallow;hasRequiredExtendShallow=1;var rt=requireIsExtendable();extendShallow=function(ut){rt(ut)||(ut={});for(var pt=arguments.length,yt=1;yt<pt;yt++){var ft=arguments[yt];rt(ft)&&it(ut,ft)}return ut};function it(dt,ut){for(var pt in ut)ct(ut,pt)&&(dt[pt]=ut[pt])}function ct(dt,ut){return Object.prototype.hasOwnProperty.call(dt,ut)}return extendShallow}var sectionMatter,hasRequiredSectionMatter;function requireSectionMatter(){if(hasRequiredSectionMatter)return sectionMatter;hasRequiredSectionMatter=1;var rt=requireKindOf(),it=requireExtendShallow();sectionMatter=function(mt,kt){typeof kt=="function"&&(kt={parse:kt});var _t=dt(mt),vt={section_delimiter:"---",parse:yt},bt=it({},vt,kt),Mt=bt.section_delimiter,wt=_t.content.split(/\r?\n/),St=null,It=pt(),Nt=[],$t=[];function Et(Yt){_t.content=Yt,St=[],Nt=[]}function Ft(Yt){$t.length&&(It.key=ut($t[0],Mt),It.content=Yt,bt.parse(It,St),St.push(It),It=pt(),Nt=[],$t=[])}for(var qt=0;qt<wt.length;qt++){var Ht=wt[qt],Ot=$t.length,Zt=Ht.trim();if(ct(Zt,Mt)){if(Zt.length===3&&qt!==0){if(Ot===0||Ot===2){Nt.push(Ht);continue}$t.push(Zt),It.data=Nt.join(`
-`),Nt=[];continue}St===null&&Et(Nt.join(`
-`)),Ot===2&&Ft(Nt.join(`
-`)),$t.push(Zt);continue}Nt.push(Ht)}return St===null?Et(Nt.join(`
-`)):Ft(Nt.join(`
-`)),_t.sections=St,_t};function ct(mt,kt){return!(mt.slice(0,kt.length)!==kt||mt.charAt(kt.length+1)===kt.slice(-1))}function dt(mt){if(rt(mt)!=="object"&&(mt={content:mt}),typeof mt.content!="string"&&!ft(mt.content))throw new TypeError("expected a buffer or string");return mt.content=mt.content.toString(),mt.sections=[],mt}function ut(mt,kt){return mt?mt.slice(kt.length).trim():""}function pt(){return{key:"",data:"",content:""}}function yt(mt){return mt}function ft(mt){return mt&&mt.constructor&&typeof mt.constructor.isBuffer=="function"?mt.constructor.isBuffer(mt):!1}return sectionMatter}var engines={exports:{}},jsYaml$1={},loader$2={},common$1={},hasRequiredCommon;function requireCommon(){if(hasRequiredCommon)return common$1;hasRequiredCommon=1;function rt(yt){return typeof yt>"u"||yt===null}function it(yt){return typeof yt=="object"&&yt!==null}function ct(yt){return Array.isArray(yt)?yt:rt(yt)?[]:[yt]}function dt(yt,ft){var mt,kt,_t,vt;if(ft)for(vt=Object.keys(ft),mt=0,kt=vt.length;mt<kt;mt+=1)_t=vt[mt],yt[_t]=ft[_t];return yt}function ut(yt,ft){var mt="",kt;for(kt=0;kt<ft;kt+=1)mt+=yt;return mt}function pt(yt){return yt===0&&Number.NEGATIVE_INFINITY===1/yt}return common$1.isNothing=rt,common$1.isObject=it,common$1.toArray=ct,common$1.repeat=ut,common$1.isNegativeZero=pt,common$1.extend=dt,common$1}var exception$1,hasRequiredException;function requireException(){if(hasRequiredException)return exception$1;hasRequiredException=1;function rt(it,ct){Error.call(this),this.name="YAMLException",this.reason=it,this.mark=ct,this.message=(this.reason||"(unknown reason)")+(this.mark?" "+this.mark.toString():""),Error.captureStackTrace?Error.captureStackTrace(this,this.constructor):this.stack=new Error().stack||""}return rt.prototype=Object.create(Error.prototype),rt.prototype.constructor=rt,rt.prototype.toString=function(ct){var dt=this.name+": ";return dt+=this.reason||"(unknown reason)",!ct&&this.mark&&(dt+=" "+this.mark.toString()),dt},exception$1=rt,exception$1}var mark,hasRequiredMark;function requireMark(){if(hasRequiredMark)return mark;hasRequiredMark=1;var rt=requireCommon();function it(ct,dt,ut,pt,yt){this.name=ct,this.buffer=dt,this.position=ut,this.line=pt,this.column=yt}return it.prototype.getSnippet=function(dt,ut){var pt,yt,ft,mt,kt;if(!this.buffer)return null;for(dt=dt||4,ut=ut||75,pt="",yt=this.position;yt>0&&`\0\r
-…\u2028\u2029`.indexOf(this.buffer.charAt(yt-1))===-1;)if(yt-=1,this.position-yt>ut/2-1){pt=" ... ",yt+=5;break}for(ft="",mt=this.position;mt<this.buffer.length&&`\0\r
-…\u2028\u2029`.indexOf(this.buffer.charAt(mt))===-1;)if(mt+=1,mt-this.position>ut/2-1){ft=" ... ",mt-=5;break}return kt=this.buffer.slice(yt,mt),rt.repeat(" ",dt)+pt+kt+ft+`
-`+rt.repeat(" ",dt+this.position-yt+pt.length)+"^"},it.prototype.toString=function(dt){var ut,pt="";return this.name&&(pt+='in "'+this.name+'" '),pt+="at line "+(this.line+1)+", column "+(this.column+1),dt||(ut=this.getSnippet(),ut&&(pt+=`:
-`+ut)),pt},mark=it,mark}var type$1,hasRequiredType;function requireType(){if(hasRequiredType)return type$1;hasRequiredType=1;var rt=requireException(),it=["kind","resolve","construct","instanceOf","predicate","represent","defaultStyle","styleAliases"],ct=["scalar","sequence","mapping"];function dt(pt){var yt={};return pt!==null&&Object.keys(pt).forEach(function(ft){pt[ft].forEach(function(mt){yt[String(mt)]=ft})}),yt}function ut(pt,yt){if(yt=yt||{},Object.keys(yt).forEach(function(ft){if(it.indexOf(ft)===-1)throw new rt('Unknown option "'+ft+'" is met in definition of "'+pt+'" YAML type.')}),this.tag=pt,this.kind=yt.kind||null,this.resolve=yt.resolve||function(){return!0},this.construct=yt.construct||function(ft){return ft},this.instanceOf=yt.instanceOf||null,this.predicate=yt.predicate||null,this.represent=yt.represent||null,this.defaultStyle=yt.defaultStyle||null,this.styleAliases=dt(yt.styleAliases||null),ct.indexOf(this.kind)===-1)throw new rt('Unknown kind "'+this.kind+'" is specified for "'+pt+'" YAML type.')}return type$1=ut,type$1}var schema$1,hasRequiredSchema;function requireSchema(){if(hasRequiredSchema)return schema$1;hasRequiredSchema=1;var rt=requireCommon(),it=requireException(),ct=requireType();function dt(yt,ft,mt){var kt=[];return yt.include.forEach(function(_t){mt=dt(_t,ft,mt)}),yt[ft].forEach(function(_t){mt.forEach(function(vt,bt){vt.tag===_t.tag&&vt.kind===_t.kind&&kt.push(bt)}),mt.push(_t)}),mt.filter(function(_t,vt){return kt.indexOf(vt)===-1})}function ut(){var yt={scalar:{},sequence:{},mapping:{},fallback:{}},ft,mt;function kt(_t){yt[_t.kind][_t.tag]=yt.fallback[_t.tag]=_t}for(ft=0,mt=arguments.length;ft<mt;ft+=1)arguments[ft].forEach(kt);return yt}function pt(yt){this.include=yt.include||[],this.implicit=yt.implicit||[],this.explicit=yt.explicit||[],this.implicit.forEach(function(ft){if(ft.loadKind&&ft.loadKind!=="scalar")throw new it("There is a non-scalar type in the implicit list of a schema. Implicit resolving of such types is not supported.")}),this.compiledImplicit=dt(this,"implicit",[]),this.compiledExplicit=dt(this,"explicit",[]),this.compiledTypeMap=ut(this.compiledImplicit,this.compiledExplicit)}return pt.DEFAULT=null,pt.create=function(){var ft,mt;switch(arguments.length){case 1:ft=pt.DEFAULT,mt=arguments[0];break;case 2:ft=arguments[0],mt=arguments[1];break;default:throw new it("Wrong number of arguments for Schema.create function")}if(ft=rt.toArray(ft),mt=rt.toArray(mt),!ft.every(function(kt){return kt instanceof pt}))throw new it("Specified list of super schemas (or a single Schema object) contains a non-Schema object.");if(!mt.every(function(kt){return kt instanceof ct}))throw new it("Specified list of YAML types (or a single Type object) contains a non-Type object.");return new pt({include:ft,explicit:mt})},schema$1=pt,schema$1}var str$1,hasRequiredStr;function requireStr(){if(hasRequiredStr)return str$1;hasRequiredStr=1;var rt=requireType();return str$1=new rt("tag:yaml.org,2002:str",{kind:"scalar",construct:function(it){return it!==null?it:""}}),str$1}var seq$1,hasRequiredSeq;function requireSeq(){if(hasRequiredSeq)return seq$1;hasRequiredSeq=1;var rt=requireType();return seq$1=new rt("tag:yaml.org,2002:seq",{kind:"sequence",construct:function(it){return it!==null?it:[]}}),seq$1}var map$1,hasRequiredMap;function requireMap(){if(hasRequiredMap)return map$1;hasRequiredMap=1;var rt=requireType();return map$1=new rt("tag:yaml.org,2002:map",{kind:"mapping",construct:function(it){return it!==null?it:{}}}),map$1}var failsafe$1,hasRequiredFailsafe;function requireFailsafe(){if(hasRequiredFailsafe)return failsafe$1;hasRequiredFailsafe=1;var rt=requireSchema();return failsafe$1=new rt({explicit:[requireStr(),requireSeq(),requireMap()]}),failsafe$1}var _null$1,hasRequired_null;function require_null(){if(hasRequired_null)return _null$1;hasRequired_null=1;var rt=requireType();function it(ut){if(ut===null)return!0;var pt=ut.length;return pt===1&&ut==="~"||pt===4&&(ut==="null"||ut==="Null"||ut==="NULL")}function ct(){return null}function dt(ut){return ut===null}return _null$1=new rt("tag:yaml.org,2002:null",{kind:"scalar",resolve:it,construct:ct,predicate:dt,represent:{canonical:function(){return"~"},lowercase:function(){return"null"},uppercase:function(){return"NULL"},camelcase:function(){return"Null"}},defaultStyle:"lowercase"}),_null$1}var bool$1,hasRequiredBool;function requireBool(){if(hasRequiredBool)return bool$1;hasRequiredBool=1;var rt=requireType();function it(ut){if(ut===null)return!1;var pt=ut.length;return pt===4&&(ut==="true"||ut==="True"||ut==="TRUE")||pt===5&&(ut==="false"||ut==="False"||ut==="FALSE")}function ct(ut){return ut==="true"||ut==="True"||ut==="TRUE"}function dt(ut){return Object.prototype.toString.call(ut)==="[object Boolean]"}return bool$1=new rt("tag:yaml.org,2002:bool",{kind:"scalar",resolve:it,construct:ct,predicate:dt,represent:{lowercase:function(ut){return ut?"true":"false"},uppercase:function(ut){return ut?"TRUE":"FALSE"},camelcase:function(ut){return ut?"True":"False"}},defaultStyle:"lowercase"}),bool$1}var int$1,hasRequiredInt;function requireInt(){if(hasRequiredInt)return int$1;hasRequiredInt=1;var rt=requireCommon(),it=requireType();function ct(mt){return 48<=mt&&mt<=57||65<=mt&&mt<=70||97<=mt&&mt<=102}function dt(mt){return 48<=mt&&mt<=55}function ut(mt){return 48<=mt&&mt<=57}function pt(mt){if(mt===null)return!1;var kt=mt.length,_t=0,vt=!1,bt;if(!kt)return!1;if(bt=mt[_t],(bt==="-"||bt==="+")&&(bt=mt[++_t]),bt==="0"){if(_t+1===kt)return!0;if(bt=mt[++_t],bt==="b"){for(_t++;_t<kt;_t++)if(bt=mt[_t],bt!=="_"){if(bt!=="0"&&bt!=="1")return!1;vt=!0}return vt&&bt!=="_"}if(bt==="x"){for(_t++;_t<kt;_t++)if(bt=mt[_t],bt!=="_"){if(!ct(mt.charCodeAt(_t)))return!1;vt=!0}return vt&&bt!=="_"}for(;_t<kt;_t++)if(bt=mt[_t],bt!=="_"){if(!dt(mt.charCodeAt(_t)))return!1;vt=!0}return vt&&bt!=="_"}if(bt==="_")return!1;for(;_t<kt;_t++)if(bt=mt[_t],bt!=="_"){if(bt===":")break;if(!ut(mt.charCodeAt(_t)))return!1;vt=!0}return!vt||bt==="_"?!1:bt!==":"?!0:/^(:[0-5]?[0-9])+$/.test(mt.slice(_t))}function yt(mt){var kt=mt,_t=1,vt,bt,Mt=[];return kt.indexOf("_")!==-1&&(kt=kt.replace(/_/g,"")),vt=kt[0],(vt==="-"||vt==="+")&&(vt==="-"&&(_t=-1),kt=kt.slice(1),vt=kt[0]),kt==="0"?0:vt==="0"?kt[1]==="b"?_t*parseInt(kt.slice(2),2):kt[1]==="x"?_t*parseInt(kt,16):_t*parseInt(kt,8):kt.indexOf(":")!==-1?(kt.split(":").forEach(function(wt){Mt.unshift(parseInt(wt,10))}),kt=0,bt=1,Mt.forEach(function(wt){kt+=wt*bt,bt*=60}),_t*kt):_t*parseInt(kt,10)}function ft(mt){return Object.prototype.toString.call(mt)==="[object Number]"&&mt%1===0&&!rt.isNegativeZero(mt)}return int$1=new it("tag:yaml.org,2002:int",{kind:"scalar",resolve:pt,construct:yt,predicate:ft,represent:{binary:function(mt){return mt>=0?"0b"+mt.toString(2):"-0b"+mt.toString(2).slice(1)},octal:function(mt){return mt>=0?"0"+mt.toString(8):"-0"+mt.toString(8).slice(1)},decimal:function(mt){return mt.toString(10)},hexadecimal:function(mt){return mt>=0?"0x"+mt.toString(16).toUpperCase():"-0x"+mt.toString(16).toUpperCase().slice(1)}},defaultStyle:"decimal",styleAliases:{binary:[2,"bin"],octal:[8,"oct"],decimal:[10,"dec"],hexadecimal:[16,"hex"]}}),int$1}var float$1,hasRequiredFloat;function requireFloat(){if(hasRequiredFloat)return float$1;hasRequiredFloat=1;var rt=requireCommon(),it=requireType(),ct=new RegExp("^(?:[-+]?(?:0|[1-9][0-9_]*)(?:\\.[0-9_]*)?(?:[eE][-+]?[0-9]+)?|\\.[0-9_]+(?:[eE][-+]?[0-9]+)?|[-+]?[0-9][0-9_]*(?::[0-5]?[0-9])+\\.[0-9_]*|[-+]?\\.(?:inf|Inf|INF)|\\.(?:nan|NaN|NAN))$");function dt(mt){return!(mt===null||!ct.test(mt)||mt[mt.length-1]==="_")}function ut(mt){var kt,_t,vt,bt;return kt=mt.replace(/_/g,"").toLowerCase(),_t=kt[0]==="-"?-1:1,bt=[],"+-".indexOf(kt[0])>=0&&(kt=kt.slice(1)),kt===".inf"?_t===1?Number.POSITIVE_INFINITY:Number.NEGATIVE_INFINITY:kt===".nan"?NaN:kt.indexOf(":")>=0?(kt.split(":").forEach(function(Mt){bt.unshift(parseFloat(Mt,10))}),kt=0,vt=1,bt.forEach(function(Mt){kt+=Mt*vt,vt*=60}),_t*kt):_t*parseFloat(kt,10)}var pt=/^[-+]?[0-9]+e/;function yt(mt,kt){var _t;if(isNaN(mt))switch(kt){case"lowercase":return".nan";case"uppercase":return".NAN";case"camelcase":return".NaN"}else if(Number.POSITIVE_INFINITY===mt)switch(kt){case"lowercase":return".inf";case"uppercase":return".INF";case"camelcase":return".Inf"}else if(Number.NEGATIVE_INFINITY===mt)switch(kt){case"lowercase":return"-.inf";case"uppercase":return"-.INF";case"camelcase":return"-.Inf"}else if(rt.isNegativeZero(mt))return"-0.0";return _t=mt.toString(10),pt.test(_t)?_t.replace("e",".e"):_t}function ft(mt){return Object.prototype.toString.call(mt)==="[object Number]"&&(mt%1!==0||rt.isNegativeZero(mt))}return float$1=new it("tag:yaml.org,2002:float",{kind:"scalar",resolve:dt,construct:ut,predicate:ft,represent:yt,defaultStyle:"lowercase"}),float$1}var json$1,hasRequiredJson;function requireJson(){if(hasRequiredJson)return json$1;hasRequiredJson=1;var rt=requireSchema();return json$1=new rt({include:[requireFailsafe()],implicit:[require_null(),requireBool(),requireInt(),requireFloat()]}),json$1}var core$1,hasRequiredCore;function requireCore(){if(hasRequiredCore)return core$1;hasRequiredCore=1;var rt=requireSchema();return core$1=new rt({include:[requireJson()]}),core$1}var timestamp$1,hasRequiredTimestamp;function requireTimestamp(){if(hasRequiredTimestamp)return timestamp$1;hasRequiredTimestamp=1;var rt=requireType(),it=new RegExp("^([0-9][0-9][0-9][0-9])-([0-9][0-9])-([0-9][0-9])$"),ct=new RegExp("^([0-9][0-9][0-9][0-9])-([0-9][0-9]?)-([0-9][0-9]?)(?:[Tt]|[ \\t]+)([0-9][0-9]?):([0-9][0-9]):([0-9][0-9])(?:\\.([0-9]*))?(?:[ \\t]*(Z|([-+])([0-9][0-9]?)(?::([0-9][0-9]))?))?$");function dt(yt){return yt===null?!1:it.exec(yt)!==null||ct.exec(yt)!==null}function ut(yt){var ft,mt,kt,_t,vt,bt,Mt,wt=0,St=null,It,Nt,$t;if(ft=it.exec(yt),ft===null&&(ft=ct.exec(yt)),ft===null)throw new Error("Date resolve error");if(mt=+ft[1],kt=+ft[2]-1,_t=+ft[3],!ft[4])return new Date(Date.UTC(mt,kt,_t));if(vt=+ft[4],bt=+ft[5],Mt=+ft[6],ft[7]){for(wt=ft[7].slice(0,3);wt.length<3;)wt+="0";wt=+wt}return ft[9]&&(It=+ft[10],Nt=+(ft[11]||0),St=(It*60+Nt)*6e4,ft[9]==="-"&&(St=-St)),$t=new Date(Date.UTC(mt,kt,_t,vt,bt,Mt,wt)),St&&$t.setTime($t.getTime()-St),$t}function pt(yt){return yt.toISOString()}return timestamp$1=new rt("tag:yaml.org,2002:timestamp",{kind:"scalar",resolve:dt,construct:ut,instanceOf:Date,represent:pt}),timestamp$1}var merge$2,hasRequiredMerge;function requireMerge(){if(hasRequiredMerge)return merge$2;hasRequiredMerge=1;var rt=requireType();function it(ct){return ct==="<<"||ct===null}return merge$2=new rt("tag:yaml.org,2002:merge",{kind:"scalar",resolve:it}),merge$2}function commonjsRequire(rt){throw new Error('Could not dynamically require "'+rt+'". Please configure the dynamicRequireTargets or/and ignoreDynamicRequires option of @rollup/plugin-commonjs appropriately for this require call to work.')}var binary$1,hasRequiredBinary;function requireBinary(){if(hasRequiredBinary)return binary$1;hasRequiredBinary=1;var rt;try{var it=commonjsRequire;rt=it("buffer").Buffer}catch{}var ct=requireType(),dt=`ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=
-\r`;function ut(mt){if(mt===null)return!1;var kt,_t,vt=0,bt=mt.length,Mt=dt;for(_t=0;_t<bt;_t++)if(kt=Mt.indexOf(mt.charAt(_t)),!(kt>64)){if(kt<0)return!1;vt+=6}return vt%8===0}function pt(mt){var kt,_t,vt=mt.replace(/[\r\n=]/g,""),bt=vt.length,Mt=dt,wt=0,St=[];for(kt=0;kt<bt;kt++)kt%4===0&&kt&&(St.push(wt>>16&255),St.push(wt>>8&255),St.push(wt&255)),wt=wt<<6|Mt.indexOf(vt.charAt(kt));return _t=bt%4*6,_t===0?(St.push(wt>>16&255),St.push(wt>>8&255),St.push(wt&255)):_t===18?(St.push(wt>>10&255),St.push(wt>>2&255)):_t===12&&St.push(wt>>4&255),rt?rt.from?rt.from(St):new rt(St):St}function yt(mt){var kt="",_t=0,vt,bt,Mt=mt.length,wt=dt;for(vt=0;vt<Mt;vt++)vt%3===0&&vt&&(kt+=wt[_t>>18&63],kt+=wt[_t>>12&63],kt+=wt[_t>>6&63],kt+=wt[_t&63]),_t=(_t<<8)+mt[vt];return bt=Mt%3,bt===0?(kt+=wt[_t>>18&63],kt+=wt[_t>>12&63],kt+=wt[_t>>6&63],kt+=wt[_t&63]):bt===2?(kt+=wt[_t>>10&63],kt+=wt[_t>>4&63],kt+=wt[_t<<2&63],kt+=wt[64]):bt===1&&(kt+=wt[_t>>2&63],kt+=wt[_t<<4&63],kt+=wt[64],kt+=wt[64]),kt}function ft(mt){return rt&&rt.isBuffer(mt)}return binary$1=new ct("tag:yaml.org,2002:binary",{kind:"scalar",resolve:ut,construct:pt,predicate:ft,represent:yt}),binary$1}var omap$1,hasRequiredOmap;function requireOmap(){if(hasRequiredOmap)return omap$1;hasRequiredOmap=1;var rt=requireType(),it=Object.prototype.hasOwnProperty,ct=Object.prototype.toString;function dt(pt){if(pt===null)return!0;var yt=[],ft,mt,kt,_t,vt,bt=pt;for(ft=0,mt=bt.length;ft<mt;ft+=1){if(kt=bt[ft],vt=!1,ct.call(kt)!=="[object Object]")return!1;for(_t in kt)if(it.call(kt,_t))if(!vt)vt=!0;else return!1;if(!vt)return!1;if(yt.indexOf(_t)===-1)yt.push(_t);else return!1}return!0}function ut(pt){return pt!==null?pt:[]}return omap$1=new rt("tag:yaml.org,2002:omap",{kind:"sequence",resolve:dt,construct:ut}),omap$1}var pairs$1,hasRequiredPairs;function requirePairs(){if(hasRequiredPairs)return pairs$1;hasRequiredPairs=1;var rt=requireType(),it=Object.prototype.toString;function ct(ut){if(ut===null)return!0;var pt,yt,ft,mt,kt,_t=ut;for(kt=new Array(_t.length),pt=0,yt=_t.length;pt<yt;pt+=1){if(ft=_t[pt],it.call(ft)!=="[object Object]"||(mt=Object.keys(ft),mt.length!==1))return!1;kt[pt]=[mt[0],ft[mt[0]]]}return!0}function dt(ut){if(ut===null)return[];var pt,yt,ft,mt,kt,_t=ut;for(kt=new Array(_t.length),pt=0,yt=_t.length;pt<yt;pt+=1)ft=_t[pt],mt=Object.keys(ft),kt[pt]=[mt[0],ft[mt[0]]];return kt}return pairs$1=new rt("tag:yaml.org,2002:pairs",{kind:"sequence",resolve:ct,construct:dt}),pairs$1}var set$3,hasRequiredSet;function requireSet(){if(hasRequiredSet)return set$3;hasRequiredSet=1;var rt=requireType(),it=Object.prototype.hasOwnProperty;function ct(ut){if(ut===null)return!0;var pt,yt=ut;for(pt in yt)if(it.call(yt,pt)&&yt[pt]!==null)return!1;return!0}function dt(ut){return ut!==null?ut:{}}return set$3=new rt("tag:yaml.org,2002:set",{kind:"mapping",resolve:ct,construct:dt}),set$3}var default_safe,hasRequiredDefault_safe;function requireDefault_safe(){if(hasRequiredDefault_safe)return default_safe;hasRequiredDefault_safe=1;var rt=requireSchema();return default_safe=new rt({include:[requireCore()],implicit:[requireTimestamp(),requireMerge()],explicit:[requireBinary(),requireOmap(),requirePairs(),requireSet()]}),default_safe}var _undefined,hasRequired_undefined;function require_undefined(){if(hasRequired_undefined)return _undefined;hasRequired_undefined=1;var rt=requireType();function it(){return!0}function ct(){}function dt(){return""}function ut(pt){return typeof pt>"u"}return _undefined=new rt("tag:yaml.org,2002:js/undefined",{kind:"scalar",resolve:it,construct:ct,predicate:ut,represent:dt}),_undefined}var regexp,hasRequiredRegexp;function requireRegexp(){if(hasRequiredRegexp)return regexp;hasRequiredRegexp=1;var rt=requireType();function it(pt){if(pt===null||pt.length===0)return!1;var yt=pt,ft=/\/([gim]*)$/.exec(pt),mt="";return!(yt[0]==="/"&&(ft&&(mt=ft[1]),mt.length>3||yt[yt.length-mt.length-1]!=="/"))}function ct(pt){var yt=pt,ft=/\/([gim]*)$/.exec(pt),mt="";return yt[0]==="/"&&(ft&&(mt=ft[1]),yt=yt.slice(1,yt.length-mt.length-1)),new RegExp(yt,mt)}function dt(pt){var yt="/"+pt.source+"/";return pt.global&&(yt+="g"),pt.multiline&&(yt+="m"),pt.ignoreCase&&(yt+="i"),yt}function ut(pt){return Object.prototype.toString.call(pt)==="[object RegExp]"}return regexp=new rt("tag:yaml.org,2002:js/regexp",{kind:"scalar",resolve:it,construct:ct,predicate:ut,represent:dt}),regexp}var _function,hasRequired_function;function require_function(){if(hasRequired_function)return _function;hasRequired_function=1;var rt;try{var it=commonjsRequire;rt=it("esprima")}catch{typeof window<"u"&&(rt=window.esprima)}var ct=requireType();function dt(ft){if(ft===null)return!1;try{var mt="("+ft+")",kt=rt.parse(mt,{range:!0});return!(kt.type!=="Program"||kt.body.length!==1||kt.body[0].type!=="ExpressionStatement"||kt.body[0].expression.type!=="ArrowFunctionExpression"&&kt.body[0].expression.type!=="FunctionExpression")}catch{return!1}}function ut(ft){var mt="("+ft+")",kt=rt.parse(mt,{range:!0}),_t=[],vt;if(kt.type!=="Program"||kt.body.length!==1||kt.body[0].type!=="ExpressionStatement"||kt.body[0].expression.type!=="ArrowFunctionExpression"&&kt.body[0].expression.type!=="FunctionExpression")throw new Error("Failed to resolve function");return kt.body[0].expression.params.forEach(function(bt){_t.push(bt.name)}),vt=kt.body[0].expression.body.range,kt.body[0].expression.body.type==="BlockStatement"?new Function(_t,mt.slice(vt[0]+1,vt[1]-1)):new Function(_t,"return "+mt.slice(vt[0],vt[1]))}function pt(ft){return ft.toString()}function yt(ft){return Object.prototype.toString.call(ft)==="[object Function]"}return _function=new ct("tag:yaml.org,2002:js/function",{kind:"scalar",resolve:dt,construct:ut,predicate:yt,represent:pt}),_function}var default_full,hasRequiredDefault_full;function requireDefault_full(){if(hasRequiredDefault_full)return default_full;hasRequiredDefault_full=1;var rt=requireSchema();return default_full=rt.DEFAULT=new rt({include:[requireDefault_safe()],explicit:[require_undefined(),requireRegexp(),require_function()]}),default_full}var hasRequiredLoader;function requireLoader(){if(hasRequiredLoader)return loader$2;hasRequiredLoader=1;var rt=requireCommon(),it=requireException(),ct=requireMark(),dt=requireDefault_safe(),ut=requireDefault_full(),pt=Object.prototype.hasOwnProperty,yt=1,ft=2,mt=3,kt=4,_t=1,vt=2,bt=3,Mt=/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F-\x84\x86-\x9F\uFFFE\uFFFF]|[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?:[^\uD800-\uDBFF]|^)[\uDC00-\uDFFF]/,wt=/[\x85\u2028\u2029]/,St=/[,\[\]\{\}]/,It=/^(?:!|!!|![a-z\-]+!)$/i,Nt=/^(?:!|[^,\[\]\{\}])(?:%[0-9a-f]{2}|[0-9a-z\-#;\/\?:@&=\+\$,_\.!~\*'\(\)\[\]])*$/i;function $t(Tt){return Object.prototype.toString.call(Tt)}function Et(Tt){return Tt===10||Tt===13}function Ft(Tt){return Tt===9||Tt===32}function qt(Tt){return Tt===9||Tt===32||Tt===10||Tt===13}function Ht(Tt){return Tt===44||Tt===91||Tt===93||Tt===123||Tt===125}function Ot(Tt){var fa;return 48<=Tt&&Tt<=57?Tt-48:(fa=Tt|32,97<=fa&&fa<=102?fa-97+10:-1)}function Zt(Tt){return Tt===120?2:Tt===117?4:Tt===85?8:0}function Yt(Tt){return 48<=Tt&&Tt<=57?Tt-48:-1}function aa(Tt){return Tt===48?"\0":Tt===97?"\x07":Tt===98?"\b":Tt===116||Tt===9?"	":Tt===110?`
-`:Tt===118?"\v":Tt===102?"\f":Tt===114?"\r":Tt===101?"\x1B":Tt===32?" ":Tt===34?'"':Tt===47?"/":Tt===92?"\\":Tt===78?"…":Tt===95?" ":Tt===76?"\u2028":Tt===80?"\u2029":""}function Qt(Tt){return Tt<=65535?String.fromCharCode(Tt):String.fromCharCode((Tt-65536>>10)+55296,(Tt-65536&1023)+56320)}function oa(Tt,fa,Pt){fa==="__proto__"?Object.defineProperty(Tt,fa,{configurable:!0,enumerable:!0,writable:!0,value:Pt}):Tt[fa]=Pt}for(var la=new Array(256),Kt=new Array(256),ra=0;ra<256;ra++)la[ra]=aa(ra)?1:0,Kt[ra]=aa(ra);function Ut(Tt,fa){this.input=Tt,this.filename=fa.filename||null,this.schema=fa.schema||ut,this.onWarning=fa.onWarning||null,this.legacy=fa.legacy||!1,this.json=fa.json||!1,this.listener=fa.listener||null,this.implicitTypes=this.schema.compiledImplicit,this.typeMap=this.schema.compiledTypeMap,this.length=Tt.length,this.position=0,this.line=0,this.lineStart=0,this.lineIndent=0,this.documents=[]}function ea(Tt,fa){return new it(fa,new ct(Tt.filename,Tt.input,Tt.position,Tt.line,Tt.position-Tt.lineStart))}function Gt(Tt,fa){throw ea(Tt,fa)}function _a(Tt,fa){Tt.onWarning&&Tt.onWarning.call(null,ea(Tt,fa))}var Ca={YAML:function(fa,Pt,At){var Rt,Bt,jt;fa.version!==null&&Gt(fa,"duplication of %YAML directive"),At.length!==1&&Gt(fa,"YAML directive accepts exactly one argument"),Rt=/^([0-9]+)\.([0-9]+)$/.exec(At[0]),Rt===null&&Gt(fa,"ill-formed argument of the YAML directive"),Bt=parseInt(Rt[1],10),jt=parseInt(Rt[2],10),Bt!==1&&Gt(fa,"unacceptable YAML version of the document"),fa.version=At[0],fa.checkLineBreaks=jt<2,jt!==1&&jt!==2&&_a(fa,"unsupported YAML version of the document")},TAG:function(fa,Pt,At){var Rt,Bt;At.length!==2&&Gt(fa,"TAG directive accepts exactly two arguments"),Rt=At[0],Bt=At[1],It.test(Rt)||Gt(fa,"ill-formed tag handle (first argument) of the TAG directive"),pt.call(fa.tagMap,Rt)&&Gt(fa,'there is a previously declared suffix for "'+Rt+'" tag handle'),Nt.test(Bt)||Gt(fa,"ill-formed tag prefix (second argument) of the TAG directive"),fa.tagMap[Rt]=Bt}};function Vt(Tt,fa,Pt,At){var Rt,Bt,jt,Wt;if(fa<Pt){if(Wt=Tt.input.slice(fa,Pt),At)for(Rt=0,Bt=Wt.length;Rt<Bt;Rt+=1)jt=Wt.charCodeAt(Rt),jt===9||32<=jt&&jt<=1114111||Gt(Tt,"expected valid JSON character");else Mt.test(Wt)&&Gt(Tt,"the stream contains non-printable characters");Tt.result+=Wt}}function ta(Tt,fa,Pt,At){var Rt,Bt,jt,Wt;for(rt.isObject(Pt)||Gt(Tt,"cannot merge mappings; the provided source object is unacceptable"),Rt=Object.keys(Pt),jt=0,Wt=Rt.length;jt<Wt;jt+=1)Bt=Rt[jt],pt.call(fa,Bt)||(oa(fa,Bt,Pt[Bt]),At[Bt]=!0)}function sa(Tt,fa,Pt,At,Rt,Bt,jt,Wt){var Xt,da;if(Array.isArray(Rt))for(Rt=Array.prototype.slice.call(Rt),Xt=0,da=Rt.length;Xt<da;Xt+=1)Array.isArray(Rt[Xt])&&Gt(Tt,"nested arrays are not supported inside keys"),typeof Rt=="object"&&$t(Rt[Xt])==="[object Object]"&&(Rt[Xt]="[object Object]");if(typeof Rt=="object"&&$t(Rt)==="[object Object]"&&(Rt="[object Object]"),Rt=String(Rt),fa===null&&(fa={}),At==="tag:yaml.org,2002:merge")if(Array.isArray(Bt))for(Xt=0,da=Bt.length;Xt<da;Xt+=1)ta(Tt,fa,Bt[Xt],Pt);else ta(Tt,fa,Bt,Pt);else!Tt.json&&!pt.call(Pt,Rt)&&pt.call(fa,Rt)&&(Tt.line=jt||Tt.line,Tt.position=Wt||Tt.position,Gt(Tt,"duplicated mapping key")),oa(fa,Rt,Bt),delete Pt[Rt];return fa}function xa(Tt){var fa;fa=Tt.input.charCodeAt(Tt.position),fa===10?Tt.position++:fa===13?(Tt.position++,Tt.input.charCodeAt(Tt.position)===10&&Tt.position++):Gt(Tt,"a line break is expected"),Tt.line+=1,Tt.lineStart=Tt.position}function ka(Tt,fa,Pt){for(var At=0,Rt=Tt.input.charCodeAt(Tt.position);Rt!==0;){for(;Ft(Rt);)Rt=Tt.input.charCodeAt(++Tt.position);if(fa&&Rt===35)do Rt=Tt.input.charCodeAt(++Tt.position);while(Rt!==10&&Rt!==13&&Rt!==0);if(Et(Rt))for(xa(Tt),Rt=Tt.input.charCodeAt(Tt.position),At++,Tt.lineIndent=0;Rt===32;)Tt.lineIndent++,Rt=Tt.input.charCodeAt(++Tt.position);else break}return Pt!==-1&&At!==0&&Tt.lineIndent<Pt&&_a(Tt,"deficient indentation"),At}function $a(Tt){var fa=Tt.position,Pt;return Pt=Tt.input.charCodeAt(fa),!!((Pt===45||Pt===46)&&Pt===Tt.input.charCodeAt(fa+1)&&Pt===Tt.input.charCodeAt(fa+2)&&(fa+=3,Pt=Tt.input.charCodeAt(fa),Pt===0||qt(Pt)))}function Na(Tt,fa){fa===1?Tt.result+=" ":fa>1&&(Tt.result+=rt.repeat(`
-`,fa-1))}function Fa(Tt,fa,Pt){var At,Rt,Bt,jt,Wt,Xt,da,ma,pa=Tt.kind,La=Tt.result,ba;if(ba=Tt.input.charCodeAt(Tt.position),qt(ba)||Ht(ba)||ba===35||ba===38||ba===42||ba===33||ba===124||ba===62||ba===39||ba===34||ba===37||ba===64||ba===96||(ba===63||ba===45)&&(Rt=Tt.input.charCodeAt(Tt.position+1),qt(Rt)||Pt&&Ht(Rt)))return!1;for(Tt.kind="scalar",Tt.result="",Bt=jt=Tt.position,Wt=!1;ba!==0;){if(ba===58){if(Rt=Tt.input.charCodeAt(Tt.position+1),qt(Rt)||Pt&&Ht(Rt))break}else if(ba===35){if(At=Tt.input.charCodeAt(Tt.position-1),qt(At))break}else{if(Tt.position===Tt.lineStart&&$a(Tt)||Pt&&Ht(ba))break;if(Et(ba))if(Xt=Tt.line,da=Tt.lineStart,ma=Tt.lineIndent,ka(Tt,!1,-1),Tt.lineIndent>=fa){Wt=!0,ba=Tt.input.charCodeAt(Tt.position);continue}else{Tt.position=jt,Tt.line=Xt,Tt.lineStart=da,Tt.lineIndent=ma;break}}Wt&&(Vt(Tt,Bt,jt,!1),Na(Tt,Tt.line-Xt),Bt=jt=Tt.position,Wt=!1),Ft(ba)||(jt=Tt.position+1),ba=Tt.input.charCodeAt(++Tt.position)}return Vt(Tt,Bt,jt,!1),Tt.result?!0:(Tt.kind=pa,Tt.result=La,!1)}function qa(Tt,fa){var Pt,At,Rt;if(Pt=Tt.input.charCodeAt(Tt.position),Pt!==39)return!1;for(Tt.kind="scalar",Tt.result="",Tt.position++,At=Rt=Tt.position;(Pt=Tt.input.charCodeAt(Tt.position))!==0;)if(Pt===39)if(Vt(Tt,At,Tt.position,!0),Pt=Tt.input.charCodeAt(++Tt.position),Pt===39)At=Tt.position,Tt.position++,Rt=Tt.position;else return!0;else Et(Pt)?(Vt(Tt,At,Rt,!0),Na(Tt,ka(Tt,!1,fa)),At=Rt=Tt.position):Tt.position===Tt.lineStart&&$a(Tt)?Gt(Tt,"unexpected end of the document within a single quoted scalar"):(Tt.position++,Rt=Tt.position);Gt(Tt,"unexpected end of the stream within a single quoted scalar")}function Ha(Tt,fa){var Pt,At,Rt,Bt,jt,Wt;if(Wt=Tt.input.charCodeAt(Tt.position),Wt!==34)return!1;for(Tt.kind="scalar",Tt.result="",Tt.position++,Pt=At=Tt.position;(Wt=Tt.input.charCodeAt(Tt.position))!==0;){if(Wt===34)return Vt(Tt,Pt,Tt.position,!0),Tt.position++,!0;if(Wt===92){if(Vt(Tt,Pt,Tt.position,!0),Wt=Tt.input.charCodeAt(++Tt.position),Et(Wt))ka(Tt,!1,fa);else if(Wt<256&&la[Wt])Tt.result+=Kt[Wt],Tt.position++;else if((jt=Zt(Wt))>0){for(Rt=jt,Bt=0;Rt>0;Rt--)Wt=Tt.input.charCodeAt(++Tt.position),(jt=Ot(Wt))>=0?Bt=(Bt<<4)+jt:Gt(Tt,"expected hexadecimal character");Tt.result+=Qt(Bt),Tt.position++}else Gt(Tt,"unknown escape sequence");Pt=At=Tt.position}else Et(Wt)?(Vt(Tt,Pt,At,!0),Na(Tt,ka(Tt,!1,fa)),Pt=At=Tt.position):Tt.position===Tt.lineStart&&$a(Tt)?Gt(Tt,"unexpected end of the document within a double quoted scalar"):(Tt.position++,At=Tt.position)}Gt(Tt,"unexpected end of the stream within a double quoted scalar")}function rn(Tt,fa){var Pt=!0,At,Rt=Tt.tag,Bt,jt=Tt.anchor,Wt,Xt,da,ma,pa,La={},ba,Ra,ja,Pa;if(Pa=Tt.input.charCodeAt(Tt.position),Pa===91)Xt=93,pa=!1,Bt=[];else if(Pa===123)Xt=125,pa=!0,Bt={};else return!1;for(Tt.anchor!==null&&(Tt.anchorMap[Tt.anchor]=Bt),Pa=Tt.input.charCodeAt(++Tt.position);Pa!==0;){if(ka(Tt,!0,fa),Pa=Tt.input.charCodeAt(Tt.position),Pa===Xt)return Tt.position++,Tt.tag=Rt,Tt.anchor=jt,Tt.kind=pa?"mapping":"sequence",Tt.result=Bt,!0;Pt||Gt(Tt,"missed comma between flow collection entries"),Ra=ba=ja=null,da=ma=!1,Pa===63&&(Wt=Tt.input.charCodeAt(Tt.position+1),qt(Wt)&&(da=ma=!0,Tt.position++,ka(Tt,!0,fa))),At=Tt.line,vn(Tt,fa,yt,!1,!0),Ra=Tt.tag,ba=Tt.result,ka(Tt,!0,fa),Pa=Tt.input.charCodeAt(Tt.position),(ma||Tt.line===At)&&Pa===58&&(da=!0,Pa=Tt.input.charCodeAt(++Tt.position),ka(Tt,!0,fa),vn(Tt,fa,yt,!1,!0),ja=Tt.result),pa?sa(Tt,Bt,La,Ra,ba,ja):da?Bt.push(sa(Tt,null,La,Ra,ba,ja)):Bt.push(ba),ka(Tt,!0,fa),Pa=Tt.input.charCodeAt(Tt.position),Pa===44?(Pt=!0,Pa=Tt.input.charCodeAt(++Tt.position)):Pt=!1}Gt(Tt,"unexpected end of the stream within a flow collection")}function hn(Tt,fa){var Pt,At,Rt=_t,Bt=!1,jt=!1,Wt=fa,Xt=0,da=!1,ma,pa;if(pa=Tt.input.charCodeAt(Tt.position),pa===124)At=!1;else if(pa===62)At=!0;else return!1;for(Tt.kind="scalar",Tt.result="";pa!==0;)if(pa=Tt.input.charCodeAt(++Tt.position),pa===43||pa===45)_t===Rt?Rt=pa===43?bt:vt:Gt(Tt,"repeat of a chomping mode identifier");else if((ma=Yt(pa))>=0)ma===0?Gt(Tt,"bad explicit indentation width of a block scalar; it cannot be less than one"):jt?Gt(Tt,"repeat of an indentation width identifier"):(Wt=fa+ma-1,jt=!0);else break;if(Ft(pa)){do pa=Tt.input.charCodeAt(++Tt.position);while(Ft(pa));if(pa===35)do pa=Tt.input.charCodeAt(++Tt.position);while(!Et(pa)&&pa!==0)}for(;pa!==0;){for(xa(Tt),Tt.lineIndent=0,pa=Tt.input.charCodeAt(Tt.position);(!jt||Tt.lineIndent<Wt)&&pa===32;)Tt.lineIndent++,pa=Tt.input.charCodeAt(++Tt.position);if(!jt&&Tt.lineIndent>Wt&&(Wt=Tt.lineIndent),Et(pa)){Xt++;continue}if(Tt.lineIndent<Wt){Rt===bt?Tt.result+=rt.repeat(`
-`,Bt?1+Xt:Xt):Rt===_t&&Bt&&(Tt.result+=`
-`);break}for(At?Ft(pa)?(da=!0,Tt.result+=rt.repeat(`
-`,Bt?1+Xt:Xt)):da?(da=!1,Tt.result+=rt.repeat(`
-`,Xt+1)):Xt===0?Bt&&(Tt.result+=" "):Tt.result+=rt.repeat(`
-`,Xt):Tt.result+=rt.repeat(`
-`,Bt?1+Xt:Xt),Bt=!0,jt=!0,Xt=0,Pt=Tt.position;!Et(pa)&&pa!==0;)pa=Tt.input.charCodeAt(++Tt.position);Vt(Tt,Pt,Tt.position,!1)}return!0}function Ja(Tt,fa){var Pt,At=Tt.tag,Rt=Tt.anchor,Bt=[],jt,Wt=!1,Xt;for(Tt.anchor!==null&&(Tt.anchorMap[Tt.anchor]=Bt),Xt=Tt.input.charCodeAt(Tt.position);Xt!==0&&!(Xt!==45||(jt=Tt.input.charCodeAt(Tt.position+1),!qt(jt)));){if(Wt=!0,Tt.position++,ka(Tt,!0,-1)&&Tt.lineIndent<=fa){Bt.push(null),Xt=Tt.input.charCodeAt(Tt.position);continue}if(Pt=Tt.line,vn(Tt,fa,mt,!1,!0),Bt.push(Tt.result),ka(Tt,!0,-1),Xt=Tt.input.charCodeAt(Tt.position),(Tt.line===Pt||Tt.lineIndent>fa)&&Xt!==0)Gt(Tt,"bad indentation of a sequence entry");else if(Tt.lineIndent<fa)break}return Wt?(Tt.tag=At,Tt.anchor=Rt,Tt.kind="sequence",Tt.result=Bt,!0):!1}function kn(Tt,fa,Pt){var At,Rt,Bt,jt,Wt=Tt.tag,Xt=Tt.anchor,da={},ma={},pa=null,La=null,ba=null,Ra=!1,ja=!1,Pa;for(Tt.anchor!==null&&(Tt.anchorMap[Tt.anchor]=da),Pa=Tt.input.charCodeAt(Tt.position);Pa!==0;){if(At=Tt.input.charCodeAt(Tt.position+1),Bt=Tt.line,jt=Tt.position,(Pa===63||Pa===58)&&qt(At))Pa===63?(Ra&&(sa(Tt,da,ma,pa,La,null),pa=La=ba=null),ja=!0,Ra=!0,Rt=!0):Ra?(Ra=!1,Rt=!0):Gt(Tt,"incomplete explicit mapping pair; a key node is missed; or followed by a non-tabulated empty line"),Tt.position+=1,Pa=At;else if(vn(Tt,Pt,ft,!1,!0))if(Tt.line===Bt){for(Pa=Tt.input.charCodeAt(Tt.position);Ft(Pa);)Pa=Tt.input.charCodeAt(++Tt.position);if(Pa===58)Pa=Tt.input.charCodeAt(++Tt.position),qt(Pa)||Gt(Tt,"a whitespace character is expected after the key-value separator within a block mapping"),Ra&&(sa(Tt,da,ma,pa,La,null),pa=La=ba=null),ja=!0,Ra=!1,Rt=!1,pa=Tt.tag,La=Tt.result;else if(ja)Gt(Tt,"can not read an implicit mapping pair; a colon is missed");else return Tt.tag=Wt,Tt.anchor=Xt,!0}else if(ja)Gt(Tt,"can not read a block mapping entry; a multiline key may not be an implicit key");else return Tt.tag=Wt,Tt.anchor=Xt,!0;else break;if((Tt.line===Bt||Tt.lineIndent>fa)&&(vn(Tt,fa,kt,!0,Rt)&&(Ra?La=Tt.result:ba=Tt.result),Ra||(sa(Tt,da,ma,pa,La,ba,Bt,jt),pa=La=ba=null),ka(Tt,!0,-1),Pa=Tt.input.charCodeAt(Tt.position)),Tt.lineIndent>fa&&Pa!==0)Gt(Tt,"bad indentation of a mapping entry");else if(Tt.lineIndent<fa)break}return Ra&&sa(Tt,da,ma,pa,La,null),ja&&(Tt.tag=Wt,Tt.anchor=Xt,Tt.kind="mapping",Tt.result=da),ja}function En(Tt){var fa,Pt=!1,At=!1,Rt,Bt,jt;if(jt=Tt.input.charCodeAt(Tt.position),jt!==33)return!1;if(Tt.tag!==null&&Gt(Tt,"duplication of a tag property"),jt=Tt.input.charCodeAt(++Tt.position),jt===60?(Pt=!0,jt=Tt.input.charCodeAt(++Tt.position)):jt===33?(At=!0,Rt="!!",jt=Tt.input.charCodeAt(++Tt.position)):Rt="!",fa=Tt.position,Pt){do jt=Tt.input.charCodeAt(++Tt.position);while(jt!==0&&jt!==62);Tt.position<Tt.length?(Bt=Tt.input.slice(fa,Tt.position),jt=Tt.input.charCodeAt(++Tt.position)):Gt(Tt,"unexpected end of the stream within a verbatim tag")}else{for(;jt!==0&&!qt(jt);)jt===33&&(At?Gt(Tt,"tag suffix cannot contain exclamation marks"):(Rt=Tt.input.slice(fa-1,Tt.position+1),It.test(Rt)||Gt(Tt,"named tag handle cannot contain such characters"),At=!0,fa=Tt.position+1)),jt=Tt.input.charCodeAt(++Tt.position);Bt=Tt.input.slice(fa,Tt.position),St.test(Bt)&&Gt(Tt,"tag suffix cannot contain flow indicator characters")}return Bt&&!Nt.test(Bt)&&Gt(Tt,"tag name cannot contain such characters: "+Bt),Pt?Tt.tag=Bt:pt.call(Tt.tagMap,Rt)?Tt.tag=Tt.tagMap[Rt]+Bt:Rt==="!"?Tt.tag="!"+Bt:Rt==="!!"?Tt.tag="tag:yaml.org,2002:"+Bt:Gt(Tt,'undeclared tag handle "'+Rt+'"'),!0}function Hn(Tt){var fa,Pt;if(Pt=Tt.input.charCodeAt(Tt.position),Pt!==38)return!1;for(Tt.anchor!==null&&Gt(Tt,"duplication of an anchor property"),Pt=Tt.input.charCodeAt(++Tt.position),fa=Tt.position;Pt!==0&&!qt(Pt)&&!Ht(Pt);)Pt=Tt.input.charCodeAt(++Tt.position);return Tt.position===fa&&Gt(Tt,"name of an anchor node must contain at least one character"),Tt.anchor=Tt.input.slice(fa,Tt.position),!0}function Jn(Tt){var fa,Pt,At;if(At=Tt.input.charCodeAt(Tt.position),At!==42)return!1;for(At=Tt.input.charCodeAt(++Tt.position),fa=Tt.position;At!==0&&!qt(At)&&!Ht(At);)At=Tt.input.charCodeAt(++Tt.position);return Tt.position===fa&&Gt(Tt,"name of an alias node must contain at least one character"),Pt=Tt.input.slice(fa,Tt.position),pt.call(Tt.anchorMap,Pt)||Gt(Tt,'unidentified alias "'+Pt+'"'),Tt.result=Tt.anchorMap[Pt],ka(Tt,!0,-1),!0}function vn(Tt,fa,Pt,At,Rt){var Bt,jt,Wt,Xt=1,da=!1,ma=!1,pa,La,ba,Ra,ja;if(Tt.listener!==null&&Tt.listener("open",Tt),Tt.tag=null,Tt.anchor=null,Tt.kind=null,Tt.result=null,Bt=jt=Wt=kt===Pt||mt===Pt,At&&ka(Tt,!0,-1)&&(da=!0,Tt.lineIndent>fa?Xt=1:Tt.lineIndent===fa?Xt=0:Tt.lineIndent<fa&&(Xt=-1)),Xt===1)for(;En(Tt)||Hn(Tt);)ka(Tt,!0,-1)?(da=!0,Wt=Bt,Tt.lineIndent>fa?Xt=1:Tt.lineIndent===fa?Xt=0:Tt.lineIndent<fa&&(Xt=-1)):Wt=!1;if(Wt&&(Wt=da||Rt),(Xt===1||kt===Pt)&&(yt===Pt||ft===Pt?Ra=fa:Ra=fa+1,ja=Tt.position-Tt.lineStart,Xt===1?Wt&&(Ja(Tt,ja)||kn(Tt,ja,Ra))||rn(Tt,Ra)?ma=!0:(jt&&hn(Tt,Ra)||qa(Tt,Ra)||Ha(Tt,Ra)?ma=!0:Jn(Tt)?(ma=!0,(Tt.tag!==null||Tt.anchor!==null)&&Gt(Tt,"alias node should not have any properties")):Fa(Tt,Ra,yt===Pt)&&(ma=!0,Tt.tag===null&&(Tt.tag="?")),Tt.anchor!==null&&(Tt.anchorMap[Tt.anchor]=Tt.result)):Xt===0&&(ma=Wt&&Ja(Tt,ja))),Tt.tag!==null&&Tt.tag!=="!")if(Tt.tag==="?"){for(Tt.result!==null&&Tt.kind!=="scalar"&&Gt(Tt,'unacceptable node kind for !<?> tag; it should be "scalar", not "'+Tt.kind+'"'),pa=0,La=Tt.implicitTypes.length;pa<La;pa+=1)if(ba=Tt.implicitTypes[pa],ba.resolve(Tt.result)){Tt.result=ba.construct(Tt.result),Tt.tag=ba.tag,Tt.anchor!==null&&(Tt.anchorMap[Tt.anchor]=Tt.result);break}}else pt.call(Tt.typeMap[Tt.kind||"fallback"],Tt.tag)?(ba=Tt.typeMap[Tt.kind||"fallback"][Tt.tag],Tt.result!==null&&ba.kind!==Tt.kind&&Gt(Tt,"unacceptable node kind for !<"+Tt.tag+'> tag; it should be "'+ba.kind+'", not "'+Tt.kind+'"'),ba.resolve(Tt.result)?(Tt.result=ba.construct(Tt.result),Tt.anchor!==null&&(Tt.anchorMap[Tt.anchor]=Tt.result)):Gt(Tt,"cannot resolve a node with !<"+Tt.tag+"> explicit tag")):Gt(Tt,"unknown tag !<"+Tt.tag+">");return Tt.listener!==null&&Tt.listener("close",Tt),Tt.tag!==null||Tt.anchor!==null||ma}function Un(Tt){var fa=Tt.position,Pt,At,Rt,Bt=!1,jt;for(Tt.version=null,Tt.checkLineBreaks=Tt.legacy,Tt.tagMap={},Tt.anchorMap={};(jt=Tt.input.charCodeAt(Tt.position))!==0&&(ka(Tt,!0,-1),jt=Tt.input.charCodeAt(Tt.position),!(Tt.lineIndent>0||jt!==37));){for(Bt=!0,jt=Tt.input.charCodeAt(++Tt.position),Pt=Tt.position;jt!==0&&!qt(jt);)jt=Tt.input.charCodeAt(++Tt.position);for(At=Tt.input.slice(Pt,Tt.position),Rt=[],At.length<1&&Gt(Tt,"directive name must not be less than one character in length");jt!==0;){for(;Ft(jt);)jt=Tt.input.charCodeAt(++Tt.position);if(jt===35){do jt=Tt.input.charCodeAt(++Tt.position);while(jt!==0&&!Et(jt));break}if(Et(jt))break;for(Pt=Tt.position;jt!==0&&!qt(jt);)jt=Tt.input.charCodeAt(++Tt.position);Rt.push(Tt.input.slice(Pt,Tt.position))}jt!==0&&xa(Tt),pt.call(Ca,At)?Ca[At](Tt,At,Rt):_a(Tt,'unknown document directive "'+At+'"')}if(ka(Tt,!0,-1),Tt.lineIndent===0&&Tt.input.charCodeAt(Tt.position)===45&&Tt.input.charCodeAt(Tt.position+1)===45&&Tt.input.charCodeAt(Tt.position+2)===45?(Tt.position+=3,ka(Tt,!0,-1)):Bt&&Gt(Tt,"directives end mark is expected"),vn(Tt,Tt.lineIndent-1,kt,!1,!0),ka(Tt,!0,-1),Tt.checkLineBreaks&&wt.test(Tt.input.slice(fa,Tt.position))&&_a(Tt,"non-ASCII line breaks are interpreted as content"),Tt.documents.push(Tt.result),Tt.position===Tt.lineStart&&$a(Tt)){Tt.input.charCodeAt(Tt.position)===46&&(Tt.position+=3,ka(Tt,!0,-1));return}if(Tt.position<Tt.length-1)Gt(Tt,"end of the stream or a document separator is expected");else return}function jn(Tt,fa){Tt=String(Tt),fa=fa||{},Tt.length!==0&&(Tt.charCodeAt(Tt.length-1)!==10&&Tt.charCodeAt(Tt.length-1)!==13&&(Tt+=`
-`),Tt.charCodeAt(0)===65279&&(Tt=Tt.slice(1)));var Pt=new Ut(Tt,fa),At=Tt.indexOf("\0");for(At!==-1&&(Pt.position=At,Gt(Pt,"null byte is not allowed in input")),Pt.input+="\0";Pt.input.charCodeAt(Pt.position)===32;)Pt.lineIndent+=1,Pt.position+=1;for(;Pt.position<Pt.length-1;)Un(Pt);return Pt.documents}function On(Tt,fa,Pt){fa!==null&&typeof fa=="object"&&typeof Pt>"u"&&(Pt=fa,fa=null);var At=jn(Tt,Pt);if(typeof fa!="function")return At;for(var Rt=0,Bt=At.length;Rt<Bt;Rt+=1)fa(At[Rt])}function Mn(Tt,fa){var Pt=jn(Tt,fa);if(Pt.length!==0){if(Pt.length===1)return Pt[0];throw new it("expected a single document in the stream, but found more")}}function vi(Tt,fa,Pt){return typeof fa=="object"&&fa!==null&&typeof Pt>"u"&&(Pt=fa,fa=null),On(Tt,fa,rt.extend({schema:dt},Pt))}function pn(Tt,fa){return Mn(Tt,rt.extend({schema:dt},fa))}return loader$2.loadAll=On,loader$2.load=Mn,loader$2.safeLoadAll=vi,loader$2.safeLoad=pn,loader$2}var dumper={},hasRequiredDumper;function requireDumper(){if(hasRequiredDumper)return dumper;hasRequiredDumper=1;var rt=requireCommon(),it=requireException(),ct=requireDefault_full(),dt=requireDefault_safe(),ut=Object.prototype.toString,pt=Object.prototype.hasOwnProperty,yt=9,ft=10,mt=13,kt=32,_t=33,vt=34,bt=35,Mt=37,wt=38,St=39,It=42,Nt=44,$t=45,Et=58,Ft=61,qt=62,Ht=63,Ot=64,Zt=91,Yt=93,aa=96,Qt=123,oa=124,la=125,Kt={};Kt[0]="\\0",Kt[7]="\\a",Kt[8]="\\b",Kt[9]="\\t",Kt[10]="\\n",Kt[11]="\\v",Kt[12]="\\f",Kt[13]="\\r",Kt[27]="\\e",Kt[34]='\\"',Kt[92]="\\\\",Kt[133]="\\N",Kt[160]="\\_",Kt[8232]="\\L",Kt[8233]="\\P";var ra=["y","Y","yes","Yes","YES","on","On","ON","n","N","no","No","NO","off","Off","OFF"];function Ut(Bt,jt){var Wt,Xt,da,ma,pa,La,ba;if(jt===null)return{};for(Wt={},Xt=Object.keys(jt),da=0,ma=Xt.length;da<ma;da+=1)pa=Xt[da],La=String(jt[pa]),pa.slice(0,2)==="!!"&&(pa="tag:yaml.org,2002:"+pa.slice(2)),ba=Bt.compiledTypeMap.fallback[pa],ba&&pt.call(ba.styleAliases,La)&&(La=ba.styleAliases[La]),Wt[pa]=La;return Wt}function ea(Bt){var jt,Wt,Xt;if(jt=Bt.toString(16).toUpperCase(),Bt<=255)Wt="x",Xt=2;else if(Bt<=65535)Wt="u",Xt=4;else if(Bt<=4294967295)Wt="U",Xt=8;else throw new it("code point within a string may not be greater than 0xFFFFFFFF");return"\\"+Wt+rt.repeat("0",Xt-jt.length)+jt}function Gt(Bt){this.schema=Bt.schema||ct,this.indent=Math.max(1,Bt.indent||2),this.noArrayIndent=Bt.noArrayIndent||!1,this.skipInvalid=Bt.skipInvalid||!1,this.flowLevel=rt.isNothing(Bt.flowLevel)?-1:Bt.flowLevel,this.styleMap=Ut(this.schema,Bt.styles||null),this.sortKeys=Bt.sortKeys||!1,this.lineWidth=Bt.lineWidth||80,this.noRefs=Bt.noRefs||!1,this.noCompatMode=Bt.noCompatMode||!1,this.condenseFlow=Bt.condenseFlow||!1,this.implicitTypes=this.schema.compiledImplicit,this.explicitTypes=this.schema.compiledExplicit,this.tag=null,this.result="",this.duplicates=[],this.usedDuplicates=null}function _a(Bt,jt){for(var Wt=rt.repeat(" ",jt),Xt=0,da=-1,ma="",pa,La=Bt.length;Xt<La;)da=Bt.indexOf(`
-`,Xt),da===-1?(pa=Bt.slice(Xt),Xt=La):(pa=Bt.slice(Xt,da+1),Xt=da+1),pa.length&&pa!==`
-`&&(ma+=Wt),ma+=pa;return ma}function Ca(Bt,jt){return`
-`+rt.repeat(" ",Bt.indent*jt)}function Vt(Bt,jt){var Wt,Xt,da;for(Wt=0,Xt=Bt.implicitTypes.length;Wt<Xt;Wt+=1)if(da=Bt.implicitTypes[Wt],da.resolve(jt))return!0;return!1}function ta(Bt){return Bt===kt||Bt===yt}function sa(Bt){return 32<=Bt&&Bt<=126||161<=Bt&&Bt<=55295&&Bt!==8232&&Bt!==8233||57344<=Bt&&Bt<=65533&&Bt!==65279||65536<=Bt&&Bt<=1114111}function xa(Bt){return sa(Bt)&&!ta(Bt)&&Bt!==65279&&Bt!==mt&&Bt!==ft}function ka(Bt,jt){return sa(Bt)&&Bt!==65279&&Bt!==Nt&&Bt!==Zt&&Bt!==Yt&&Bt!==Qt&&Bt!==la&&Bt!==Et&&(Bt!==bt||jt&&xa(jt))}function $a(Bt){return sa(Bt)&&Bt!==65279&&!ta(Bt)&&Bt!==$t&&Bt!==Ht&&Bt!==Et&&Bt!==Nt&&Bt!==Zt&&Bt!==Yt&&Bt!==Qt&&Bt!==la&&Bt!==bt&&Bt!==wt&&Bt!==It&&Bt!==_t&&Bt!==oa&&Bt!==Ft&&Bt!==qt&&Bt!==St&&Bt!==vt&&Bt!==Mt&&Bt!==Ot&&Bt!==aa}function Na(Bt){var jt=/^\n* /;return jt.test(Bt)}var Fa=1,qa=2,Ha=3,rn=4,hn=5;function Ja(Bt,jt,Wt,Xt,da){var ma,pa,La,ba=!1,Ra=!1,ja=Xt!==-1,Pa=-1,gn=$a(Bt.charCodeAt(0))&&!ta(Bt.charCodeAt(Bt.length-1));if(jt)for(ma=0;ma<Bt.length;ma++){if(pa=Bt.charCodeAt(ma),!sa(pa))return hn;La=ma>0?Bt.charCodeAt(ma-1):null,gn=gn&&ka(pa,La)}else{for(ma=0;ma<Bt.length;ma++){if(pa=Bt.charCodeAt(ma),pa===ft)ba=!0,ja&&(Ra=Ra||ma-Pa-1>Xt&&Bt[Pa+1]!==" ",Pa=ma);else if(!sa(pa))return hn;La=ma>0?Bt.charCodeAt(ma-1):null,gn=gn&&ka(pa,La)}Ra=Ra||ja&&ma-Pa-1>Xt&&Bt[Pa+1]!==" "}return!ba&&!Ra?gn&&!da(Bt)?Fa:qa:Wt>9&&Na(Bt)?hn:Ra?rn:Ha}function kn(Bt,jt,Wt,Xt){Bt.dump=(function(){if(jt.length===0)return"''";if(!Bt.noCompatMode&&ra.indexOf(jt)!==-1)return"'"+jt+"'";var da=Bt.indent*Math.max(1,Wt),ma=Bt.lineWidth===-1?-1:Math.max(Math.min(Bt.lineWidth,40),Bt.lineWidth-da),pa=Xt||Bt.flowLevel>-1&&Wt>=Bt.flowLevel;function La(ba){return Vt(Bt,ba)}switch(Ja(jt,pa,Bt.indent,ma,La)){case Fa:return jt;case qa:return"'"+jt.replace(/'/g,"''")+"'";case Ha:return"|"+En(jt,Bt.indent)+Hn(_a(jt,da));case rn:return">"+En(jt,Bt.indent)+Hn(_a(Jn(jt,ma),da));case hn:return'"'+Un(jt)+'"';default:throw new it("impossible error: invalid scalar style")}})()}function En(Bt,jt){var Wt=Na(Bt)?String(jt):"",Xt=Bt[Bt.length-1]===`
-`,da=Xt&&(Bt[Bt.length-2]===`
-`||Bt===`
-`),ma=da?"+":Xt?"":"-";return Wt+ma+`
-`}function Hn(Bt){return Bt[Bt.length-1]===`
-`?Bt.slice(0,-1):Bt}function Jn(Bt,jt){for(var Wt=/(\n+)([^\n]*)/g,Xt=(function(){var Ra=Bt.indexOf(`
-`);return Ra=Ra!==-1?Ra:Bt.length,Wt.lastIndex=Ra,vn(Bt.slice(0,Ra),jt)})(),da=Bt[0]===`
-`||Bt[0]===" ",ma,pa;pa=Wt.exec(Bt);){var La=pa[1],ba=pa[2];ma=ba[0]===" ",Xt+=La+(!da&&!ma&&ba!==""?`
-`:"")+vn(ba,jt),da=ma}return Xt}function vn(Bt,jt){if(Bt===""||Bt[0]===" ")return Bt;for(var Wt=/ [^ ]/g,Xt,da=0,ma,pa=0,La=0,ba="";Xt=Wt.exec(Bt);)La=Xt.index,La-da>jt&&(ma=pa>da?pa:La,ba+=`
-`+Bt.slice(da,ma),da=ma+1),pa=La;return ba+=`
-`,Bt.length-da>jt&&pa>da?ba+=Bt.slice(da,pa)+`
-`+Bt.slice(pa+1):ba+=Bt.slice(da),ba.slice(1)}function Un(Bt){for(var jt="",Wt,Xt,da,ma=0;ma<Bt.length;ma++){if(Wt=Bt.charCodeAt(ma),Wt>=55296&&Wt<=56319&&(Xt=Bt.charCodeAt(ma+1),Xt>=56320&&Xt<=57343)){jt+=ea((Wt-55296)*1024+Xt-56320+65536),ma++;continue}da=Kt[Wt],jt+=!da&&sa(Wt)?Bt[ma]:da||ea(Wt)}return jt}function jn(Bt,jt,Wt){var Xt="",da=Bt.tag,ma,pa;for(ma=0,pa=Wt.length;ma<pa;ma+=1)Tt(Bt,jt,Wt[ma],!1,!1)&&(ma!==0&&(Xt+=","+(Bt.condenseFlow?"":" ")),Xt+=Bt.dump);Bt.tag=da,Bt.dump="["+Xt+"]"}function On(Bt,jt,Wt,Xt){var da="",ma=Bt.tag,pa,La;for(pa=0,La=Wt.length;pa<La;pa+=1)Tt(Bt,jt+1,Wt[pa],!0,!0)&&((!Xt||pa!==0)&&(da+=Ca(Bt,jt)),Bt.dump&&ft===Bt.dump.charCodeAt(0)?da+="-":da+="- ",da+=Bt.dump);Bt.tag=ma,Bt.dump=da||"[]"}function Mn(Bt,jt,Wt){var Xt="",da=Bt.tag,ma=Object.keys(Wt),pa,La,ba,Ra,ja;for(pa=0,La=ma.length;pa<La;pa+=1)ja="",pa!==0&&(ja+=", "),Bt.condenseFlow&&(ja+='"'),ba=ma[pa],Ra=Wt[ba],Tt(Bt,jt,ba,!1,!1)&&(Bt.dump.length>1024&&(ja+="? "),ja+=Bt.dump+(Bt.condenseFlow?'"':"")+":"+(Bt.condenseFlow?"":" "),Tt(Bt,jt,Ra,!1,!1)&&(ja+=Bt.dump,Xt+=ja));Bt.tag=da,Bt.dump="{"+Xt+"}"}function vi(Bt,jt,Wt,Xt){var da="",ma=Bt.tag,pa=Object.keys(Wt),La,ba,Ra,ja,Pa,gn;if(Bt.sortKeys===!0)pa.sort();else if(typeof Bt.sortKeys=="function")pa.sort(Bt.sortKeys);else if(Bt.sortKeys)throw new it("sortKeys must be a boolean or a function");for(La=0,ba=pa.length;La<ba;La+=1)gn="",(!Xt||La!==0)&&(gn+=Ca(Bt,jt)),Ra=pa[La],ja=Wt[Ra],Tt(Bt,jt+1,Ra,!0,!0,!0)&&(Pa=Bt.tag!==null&&Bt.tag!=="?"||Bt.dump&&Bt.dump.length>1024,Pa&&(Bt.dump&&ft===Bt.dump.charCodeAt(0)?gn+="?":gn+="? "),gn+=Bt.dump,Pa&&(gn+=Ca(Bt,jt)),Tt(Bt,jt+1,ja,!0,Pa)&&(Bt.dump&&ft===Bt.dump.charCodeAt(0)?gn+=":":gn+=": ",gn+=Bt.dump,da+=gn));Bt.tag=ma,Bt.dump=da||"{}"}function pn(Bt,jt,Wt){var Xt,da,ma,pa,La,ba;for(da=Wt?Bt.explicitTypes:Bt.implicitTypes,ma=0,pa=da.length;ma<pa;ma+=1)if(La=da[ma],(La.instanceOf||La.predicate)&&(!La.instanceOf||typeof jt=="object"&&jt instanceof La.instanceOf)&&(!La.predicate||La.predicate(jt))){if(Bt.tag=Wt?La.tag:"?",La.represent){if(ba=Bt.styleMap[La.tag]||La.defaultStyle,ut.call(La.represent)==="[object Function]")Xt=La.represent(jt,ba);else if(pt.call(La.represent,ba))Xt=La.represent[ba](jt,ba);else throw new it("!<"+La.tag+'> tag resolver accepts not "'+ba+'" style');Bt.dump=Xt}return!0}return!1}function Tt(Bt,jt,Wt,Xt,da,ma){Bt.tag=null,Bt.dump=Wt,pn(Bt,Wt,!1)||pn(Bt,Wt,!0);var pa=ut.call(Bt.dump);Xt&&(Xt=Bt.flowLevel<0||Bt.flowLevel>jt);var La=pa==="[object Object]"||pa==="[object Array]",ba,Ra;if(La&&(ba=Bt.duplicates.indexOf(Wt),Ra=ba!==-1),(Bt.tag!==null&&Bt.tag!=="?"||Ra||Bt.indent!==2&&jt>0)&&(da=!1),Ra&&Bt.usedDuplicates[ba])Bt.dump="*ref_"+ba;else{if(La&&Ra&&!Bt.usedDuplicates[ba]&&(Bt.usedDuplicates[ba]=!0),pa==="[object Object]")Xt&&Object.keys(Bt.dump).length!==0?(vi(Bt,jt,Bt.dump,da),Ra&&(Bt.dump="&ref_"+ba+Bt.dump)):(Mn(Bt,jt,Bt.dump),Ra&&(Bt.dump="&ref_"+ba+" "+Bt.dump));else if(pa==="[object Array]"){var ja=Bt.noArrayIndent&&jt>0?jt-1:jt;Xt&&Bt.dump.length!==0?(On(Bt,ja,Bt.dump,da),Ra&&(Bt.dump="&ref_"+ba+Bt.dump)):(jn(Bt,ja,Bt.dump),Ra&&(Bt.dump="&ref_"+ba+" "+Bt.dump))}else if(pa==="[object String]")Bt.tag!=="?"&&kn(Bt,Bt.dump,jt,ma);else{if(Bt.skipInvalid)return!1;throw new it("unacceptable kind of an object to dump "+pa)}Bt.tag!==null&&Bt.tag!=="?"&&(Bt.dump="!<"+Bt.tag+"> "+Bt.dump)}return!0}function fa(Bt,jt){var Wt=[],Xt=[],da,ma;for(Pt(Bt,Wt,Xt),da=0,ma=Xt.length;da<ma;da+=1)jt.duplicates.push(Wt[Xt[da]]);jt.usedDuplicates=new Array(ma)}function Pt(Bt,jt,Wt){var Xt,da,ma;if(Bt!==null&&typeof Bt=="object")if(da=jt.indexOf(Bt),da!==-1)Wt.indexOf(da)===-1&&Wt.push(da);else if(jt.push(Bt),Array.isArray(Bt))for(da=0,ma=Bt.length;da<ma;da+=1)Pt(Bt[da],jt,Wt);else for(Xt=Object.keys(Bt),da=0,ma=Xt.length;da<ma;da+=1)Pt(Bt[Xt[da]],jt,Wt)}function At(Bt,jt){jt=jt||{};var Wt=new Gt(jt);return Wt.noRefs||fa(Bt,Wt),Tt(Wt,0,Bt,!0,!0)?Wt.dump+`
-`:""}function Rt(Bt,jt){return At(Bt,rt.extend({schema:dt},jt))}return dumper.dump=At,dumper.safeDump=Rt,dumper}var hasRequiredJsYaml$1;function requireJsYaml$1(){if(hasRequiredJsYaml$1)return jsYaml$1;hasRequiredJsYaml$1=1;var rt=requireLoader(),it=requireDumper();function ct(dt){return function(){throw new Error("Function "+dt+" is deprecated and cannot be used.")}}return jsYaml$1.Type=requireType(),jsYaml$1.Schema=requireSchema(),jsYaml$1.FAILSAFE_SCHEMA=requireFailsafe(),jsYaml$1.JSON_SCHEMA=requireJson(),jsYaml$1.CORE_SCHEMA=requireCore(),jsYaml$1.DEFAULT_SAFE_SCHEMA=requireDefault_safe(),jsYaml$1.DEFAULT_FULL_SCHEMA=requireDefault_full(),jsYaml$1.load=rt.load,jsYaml$1.loadAll=rt.loadAll,jsYaml$1.safeLoad=rt.safeLoad,jsYaml$1.safeLoadAll=rt.safeLoadAll,jsYaml$1.dump=it.dump,jsYaml$1.safeDump=it.safeDump,jsYaml$1.YAMLException=requireException(),jsYaml$1.MINIMAL_SCHEMA=requireFailsafe(),jsYaml$1.SAFE_SCHEMA=requireDefault_safe(),jsYaml$1.DEFAULT_SCHEMA=requireDefault_full(),jsYaml$1.scan=ct("scan"),jsYaml$1.parse=ct("parse"),jsYaml$1.compose=ct("compose"),jsYaml$1.addConstructor=ct("addConstructor"),jsYaml$1}var jsYaml,hasRequiredJsYaml;function requireJsYaml(){if(hasRequiredJsYaml)return jsYaml;hasRequiredJsYaml=1;var rt=requireJsYaml$1();return jsYaml=rt,jsYaml}var hasRequiredEngines;function requireEngines(){return hasRequiredEngines||(hasRequiredEngines=1,(function(module,exports$1){const yaml=requireJsYaml(),engines=module.exports;engines.yaml={parse:yaml.safeLoad.bind(yaml),stringify:yaml.safeDump.bind(yaml)},engines.json={parse:JSON.parse.bind(JSON),stringify:function(rt,it){const ct=Object.assign({replacer:null,space:2},it);return JSON.stringify(rt,ct.replacer,ct.space)}},engines.javascript={parse:function parse(str,options,wrap){try{return wrap!==!1&&(str=`(function() {
-return `+str.trim()+`;
-}());`),eval(str)||{}}catch(rt){if(wrap!==!1&&/(unexpected|identifier)/i.test(rt.message))return parse(str,options,!1);throw new SyntaxError(rt)}},stringify:function(){throw new Error("stringifying JavaScript is not supported")}}})(engines)),engines.exports}var utils={};var stripBomString,hasRequiredStripBomString;function requireStripBomString(){return hasRequiredStripBomString||(hasRequiredStripBomString=1,stripBomString=function(rt){return typeof rt=="string"&&rt.charAt(0)==="\uFEFF"?rt.slice(1):rt}),stripBomString}var hasRequiredUtils;function requireUtils(){return hasRequiredUtils||(hasRequiredUtils=1,(function(rt){const it=requireStripBomString(),ct=requireKindOf();rt.define=function(dt,ut,pt){Reflect.defineProperty(dt,ut,{enumerable:!1,configurable:!0,writable:!0,value:pt})},rt.isBuffer=function(dt){return ct(dt)==="buffer"},rt.isObject=function(dt){return ct(dt)==="object"},rt.toBuffer=function(dt){return typeof dt=="string"?Buffer.from(dt):dt},rt.toString=function(dt){if(rt.isBuffer(dt))return it(String(dt));if(typeof dt!="string")throw new TypeError("expected input to be a string or buffer");return it(dt)},rt.arrayify=function(dt){return dt?Array.isArray(dt)?dt:[dt]:[]},rt.startsWith=function(dt,ut,pt){return typeof pt!="number"&&(pt=ut.length),dt.slice(0,pt)===ut}})(utils)),utils}var defaults,hasRequiredDefaults;function requireDefaults(){if(hasRequiredDefaults)return defaults;hasRequiredDefaults=1;const rt=requireEngines(),it=requireUtils();return defaults=function(ct){const dt=Object.assign({},ct);return dt.delimiters=it.arrayify(dt.delims||dt.delimiters||"---"),dt.delimiters.length===1&&dt.delimiters.push(dt.delimiters[0]),dt.language=(dt.language||dt.lang||"yaml").toLowerCase(),dt.engines=Object.assign({},rt,dt.parsers,dt.engines),dt},defaults}var engine,hasRequiredEngine;function requireEngine(){if(hasRequiredEngine)return engine;hasRequiredEngine=1,engine=function(it,ct){let dt=ct.engines[it]||ct.engines[rt(it)];if(typeof dt>"u")throw new Error('gray-matter engine "'+it+'" is not registered');return typeof dt=="function"&&(dt={parse:dt}),dt};function rt(it){switch(it.toLowerCase()){case"js":case"javascript":return"javascript";case"coffee":case"coffeescript":case"cson":return"coffee";case"yaml":case"yml":return"yaml";default:return it}}return engine}var stringify$1,hasRequiredStringify;function requireStringify(){if(hasRequiredStringify)return stringify$1;hasRequiredStringify=1;const rt=requireKindOf(),it=requireEngine(),ct=requireDefaults();stringify$1=function(ut,pt,yt){if(pt==null&&yt==null)switch(rt(ut)){case"object":pt=ut.data,yt={};break;case"string":return ut;default:throw new TypeError("expected file to be a string or object")}const ft=ut.content,mt=ct(yt);if(pt==null){if(!mt.data)return ut;pt=mt.data}const kt=ut.language||mt.language,_t=it(kt,mt);if(typeof _t.stringify!="function")throw new TypeError('expected "'+kt+'.stringify" to be a function');pt=Object.assign({},ut.data,pt);const vt=mt.delimiters[0],bt=mt.delimiters[1],Mt=_t.stringify(pt,yt).trim();let wt="";return Mt!=="{}"&&(wt=dt(vt)+dt(Mt)+dt(bt)),typeof ut.excerpt=="string"&&ut.excerpt!==""&&ft.indexOf(ut.excerpt.trim())===-1&&(wt+=dt(ut.excerpt)+dt(bt)),wt+dt(ft)};function dt(ut){return ut.slice(-1)!==`
-`?ut+`
-`:ut}return stringify$1}var excerpt,hasRequiredExcerpt;function requireExcerpt(){if(hasRequiredExcerpt)return excerpt;hasRequiredExcerpt=1;const rt=requireDefaults();return excerpt=function(it,ct){const dt=rt(ct);if(it.data==null&&(it.data={}),typeof dt.excerpt=="function")return dt.excerpt(it,dt);const ut=it.data.excerpt_separator||dt.excerpt_separator;if(ut==null&&(dt.excerpt===!1||dt.excerpt==null))return it;const pt=typeof dt.excerpt=="string"?dt.excerpt:ut||dt.delimiters[0],yt=it.content.indexOf(pt);return yt!==-1&&(it.excerpt=it.content.slice(0,yt)),it},excerpt}var toFile,hasRequiredToFile;function requireToFile(){if(hasRequiredToFile)return toFile;hasRequiredToFile=1;const rt=requireKindOf(),it=requireStringify(),ct=requireUtils();return toFile=function(dt){return rt(dt)!=="object"&&(dt={content:dt}),rt(dt.data)!=="object"&&(dt.data={}),dt.contents&&dt.content==null&&(dt.content=dt.contents),ct.define(dt,"orig",ct.toBuffer(dt.content)),ct.define(dt,"language",dt.language||""),ct.define(dt,"matter",dt.matter||""),ct.define(dt,"stringify",function(ut,pt){return pt&&pt.language&&(dt.language=pt.language),it(dt,ut,pt)}),dt.content=ct.toString(dt.content),dt.isEmpty=!1,dt.excerpt="",dt},toFile}var parse$3,hasRequiredParse;function requireParse(){if(hasRequiredParse)return parse$3;hasRequiredParse=1;const rt=requireEngine(),it=requireDefaults();return parse$3=function(ct,dt,ut){const pt=it(ut),yt=rt(ct,pt);if(typeof yt.parse!="function")throw new TypeError('expected "'+ct+'.parse" to be a function');return yt.parse(dt,pt)},parse$3}var grayMatter,hasRequiredGrayMatter;function requireGrayMatter(){if(hasRequiredGrayMatter)return grayMatter;hasRequiredGrayMatter=1;const rt=require$$0,it=requireSectionMatter(),ct=requireDefaults(),dt=requireStringify(),ut=requireExcerpt(),pt=requireEngines(),yt=requireToFile(),ft=requireParse(),mt=requireUtils();function kt(vt,bt){if(vt==="")return{data:{},content:vt,excerpt:"",orig:vt};let Mt=yt(vt);const wt=kt.cache[Mt.content];if(!bt){if(wt)return Mt=Object.assign({},wt),Mt.orig=wt.orig,Mt;kt.cache[Mt.content]=Mt}return _t(Mt,bt)}function _t(vt,bt){const Mt=ct(bt),wt=Mt.delimiters[0],St=`
-`+Mt.delimiters[1];let It=vt.content;Mt.language&&(vt.language=Mt.language);const Nt=wt.length;if(!mt.startsWith(It,wt,Nt))return ut(vt,Mt),vt;if(It.charAt(Nt)===wt.slice(-1))return vt;It=It.slice(Nt);const $t=It.length,Et=kt.language(It,Mt);Et.name&&(vt.language=Et.name,It=It.slice(Et.raw.length));let Ft=It.indexOf(St);return Ft===-1&&(Ft=$t),vt.matter=It.slice(0,Ft),vt.matter.replace(/^\s*#[^\n]+/gm,"").trim()===""?(vt.isEmpty=!0,vt.empty=vt.content,vt.data={}):vt.data=ft(vt.language,vt.matter,Mt),Ft===$t?vt.content="":(vt.content=It.slice(Ft+St.length),vt.content[0]==="\r"&&(vt.content=vt.content.slice(1)),vt.content[0]===`
-`&&(vt.content=vt.content.slice(1))),ut(vt,Mt),(Mt.sections===!0||typeof Mt.section=="function")&&it(vt,Mt.section),vt}return kt.engines=pt,kt.stringify=function(vt,bt,Mt){return typeof vt=="string"&&(vt=kt(vt,Mt)),dt(vt,bt,Mt)},kt.read=function(vt,bt){const Mt=rt.readFileSync(vt,"utf8"),wt=kt(Mt,bt);return wt.path=vt,wt},kt.test=function(vt,bt){return mt.startsWith(vt,ct(bt).delimiters[0])},kt.language=function(vt,bt){const wt=ct(bt).delimiters[0];kt.test(vt)&&(vt=vt.slice(wt.length));const St=vt.slice(0,vt.search(/\r?\n/));return{raw:St,name:St?St.trim():""}},kt.cache={},kt.clearCache=function(){kt.cache={}},grayMatter=kt,grayMatter}var grayMatterExports=requireGrayMatter();const matter=getDefaultExportFromCjs(grayMatterExports);function parseFrontmatter(rt){try{const it=matter(rt),ct={...it.data},dt=ct.toc===!0,ut=it.content.includes("[[toc]]"),pt=dt||ut;return{content:it.content,frontmatter:ct,hasToc:pt}}catch(it){console.warn("Failed to parse frontmatter:",it);const ct=rt.includes("[[toc]]");return{content:rt,frontmatter:{},hasToc:ct}}}function removeTocPlaceholder(rt){return rt.replace(/\[\[toc\]\]/g,"").trim()}function extractTextFromChildren(rt){return typeof rt=="string"?rt:Array.isArray(rt)?rt.map(extractTextFromChildren).join(""):rt&&typeof rt=="object"&&rt.props?extractTextFromChildren(rt.props.children):""}function generateHeadingId(rt){return extractTextFromChildren(rt).toLowerCase().replace(/[^\w\s-]/g,"").replace(/\s+/g,"-").replace(/-+/g,"-").replace(/^-|-$/g,"")}function extractHeadings(rt,it=2,ct=4){const dt=[],ut=rt.split(`
-`);for(const pt of ut){const yt=pt.match(/^(#{1,6})\s+(.+)$/);if(yt){const ft=yt[1].length,mt=yt[2].trim();if(ft>=it&&ft<=ct){const kt=generateHeadingId(mt);dt.push({id:kt,text:mt,level:ft,element:null})}}}return dt}function buildTocStructure(rt){const it=[],ct=[];for(const dt of rt){const ut={id:dt.id,text:dt.text,level:dt.level,children:[]};for(;ct.length>0&&ct[ct.length-1].level>=dt.level;)ct.pop();if(ct.length===0)it.push(ut);else{const pt=ct[ct.length-1];pt.children||(pt.children=[]),pt.children.push(ut)}ct.push(ut)}return it}function generateToc(rt,it=2,ct=4){const dt=extractHeadings(rt,it,ct);return buildTocStructure(dt)}function CustomBlock({type:rt,title:it,children:ct,className:dt=""}){const ut=`custom-block custom-block--${rt} ${dt}`,pt=()=>{switch(rt){case"tip":return"TIP";case"warning":return"WARNING";case"danger":return"DANGER";case"details":return"DETAILS";default:return""}},yt=()=>{switch(rt){case"tip":return jsxRuntimeExports.jsxs("svg",{className:"custom-block__icon",viewBox:"0 0 24 24",fill:"none",children:[jsxRuntimeExports.jsx("path",{d:"M12 2L2 7V17L12 22L22 17V7L12 2Z",stroke:"currentColor",strokeWidth:"2",strokeLinecap:"round",strokeLinejoin:"round"}),jsxRuntimeExports.jsx("path",{d:"M12 8V12",stroke:"currentColor",strokeWidth:"2",strokeLinecap:"round",strokeLinejoin:"round"}),jsxRuntimeExports.jsx("circle",{cx:"12",cy:"16",r:"1",fill:"currentColor"})]});case"warning":return jsxRuntimeExports.jsxs("svg",{className:"custom-block__icon",viewBox:"0 0 24 24",fill:"none",children:[jsxRuntimeExports.jsx("path",{d:"M10.29 3.86L1.82 18A2 2 0 003.54 21H20.46A2 2 0 0022.18 18L13.71 3.86A2 2 0 0010.29 3.86Z",stroke:"currentColor",strokeWidth:"2",strokeLinecap:"round",strokeLinejoin:"round"}),jsxRuntimeExports.jsx("path",{d:"M12 9V13",stroke:"currentColor",strokeWidth:"2",strokeLinecap:"round",strokeLinejoin:"round"}),jsxRuntimeExports.jsx("circle",{cx:"12",cy:"17",r:"1",fill:"currentColor"})]});case"danger":return jsxRuntimeExports.jsxs("svg",{className:"custom-block__icon",viewBox:"0 0 24 24",fill:"none",children:[jsxRuntimeExports.jsx("circle",{cx:"12",cy:"12",r:"10",stroke:"currentColor",strokeWidth:"2"}),jsxRuntimeExports.jsx("path",{d:"M15 9L9 15",stroke:"currentColor",strokeWidth:"2",strokeLinecap:"round",strokeLinejoin:"round"}),jsxRuntimeExports.jsx("path",{d:"M9 9L15 15",stroke:"currentColor",strokeWidth:"2",strokeLinecap:"round",strokeLinejoin:"round"})]});case"details":return jsxRuntimeExports.jsxs("svg",{className:"custom-block__icon",viewBox:"0 0 24 24",fill:"none",children:[jsxRuntimeExports.jsx("circle",{cx:"12",cy:"12",r:"10",stroke:"currentColor",strokeWidth:"2"}),jsxRuntimeExports.jsx("path",{d:"M12 16V12",stroke:"currentColor",strokeWidth:"2",strokeLinecap:"round",strokeLinejoin:"round"}),jsxRuntimeExports.jsx("circle",{cx:"12",cy:"8",r:"1",fill:"currentColor"})]});default:return null}},ft=it||pt();return rt==="details"?jsxRuntimeExports.jsxs("details",{className:ut,children:[jsxRuntimeExports.jsxs("summary",{className:"custom-block__summary",children:[yt(),jsxRuntimeExports.jsx("span",{className:"custom-block__title",children:ft})]}),jsxRuntimeExports.jsx("div",{className:"custom-block__content",children:ct})]}):jsxRuntimeExports.jsxs("div",{className:ut,children:[ft&&jsxRuntimeExports.jsxs("div",{className:"custom-block__header",children:[yt(),jsxRuntimeExports.jsx("span",{className:"custom-block__title",children:ft})]}),jsxRuntimeExports.jsx("div",{className:"custom-block__content",children:ct})]})}function parseCustomBlockDiv(rt){const{className:it,children:ct,style:dt,...ut}=rt;if(typeof it=="string"&&it.includes("custom-block")){const pt=it.split(" ");let yt=null;if(pt.includes("tip")?yt="tip":pt.includes("warning")?yt="warning":pt.includes("danger")?yt="danger":pt.includes("details")&&(yt="details"),yt){let ft,mt=ct;if(React.Children.count(ct)>0){const kt=React.Children.toArray(ct)[0];if(React.isValidElement(kt)&&(kt.type==="h3"||kt.type==="h4"||kt.type==="strong")){const _t=kt.props;ft=typeof _t.children=="string"?_t.children:void 0,mt=React.Children.toArray(ct).slice(1)}}return jsxRuntimeExports.jsx(CustomBlock,{type:yt,title:ft,className:it.replace("custom-block","").replace(yt,"").trim(),...ut,children:mt})}}return jsxRuntimeExports.jsx("div",{className:it,style:dt,...ut,children:ct})}function isExternalUrl(rt){try{return new URL(rt),!0}catch{return!1}}function isAnchorLink(rt){return rt.startsWith("#")}function LinkComponent({href:rt="",children:it,className:ct="",title:dt,...ut}){const pt=isExternalUrl(rt),yt=isAnchorLink(rt);if(pt)return jsxRuntimeExports.jsxs("a",{href:rt,className:`markdown-link markdown-link--external ${ct}`,title:dt,target:"_blank",rel:"noopener noreferrer",...ut,children:[it,jsxRuntimeExports.jsx(ExternalLinkIcon,{})]});if(yt){const mt=kt=>{kt.preventDefault();const _t=rt.substring(1),vt=document.getElementById(_t);vt&&(vt.scrollIntoView({behavior:"smooth",block:"start"}),window.history.pushState&&window.history.pushState(null,"",rt))};return jsxRuntimeExports.jsx("a",{href:rt,className:`markdown-link markdown-link--anchor ${ct}`,title:dt,onClick:mt,...ut,children:it})}const ft=mt=>{typeof window<"u"&&window.routerNavigate&&(mt.preventDefault(),window.routerNavigate(rt))};return jsxRuntimeExports.jsx("a",{href:rt,className:`markdown-link markdown-link--internal ${ct}`,title:dt,onClick:ft,...ut,children:it})}function ExternalLinkIcon(){return jsxRuntimeExports.jsxs("svg",{className:"external-link-icon",viewBox:"0 0 24 24",fill:"none",stroke:"currentColor",strokeWidth:"2",strokeLinecap:"round",strokeLinejoin:"round","aria-hidden":"true",children:[jsxRuntimeExports.jsx("path",{d:"M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"}),jsxRuntimeExports.jsx("polyline",{points:"15,3 21,3 21,9"}),jsxRuntimeExports.jsx("line",{x1:"10",y1:"14",x2:"21",y2:"3"})]})}const scriptRel="modulepreload",assetsURL=function(rt){return"/"+rt},seen={},__vitePreload=function rt(it,ct,dt){let ut=Promise.resolve();if(ct&&ct.length>0){let mt=function(kt){return Promise.all(kt.map(_t=>Promise.resolve(_t).then(vt=>({status:"fulfilled",value:vt}),vt=>({status:"rejected",reason:vt}))))};document.getElementsByTagName("link");const yt=document.querySelector("meta[property=csp-nonce]"),ft=yt?.nonce||yt?.getAttribute("nonce");ut=mt(ct.map(kt=>{if(kt=assetsURL(kt),kt in seen)return;seen[kt]=!0;const _t=kt.endsWith(".css"),vt=_t?'[rel="stylesheet"]':"";if(document.querySelector(`link[href="${kt}"]${vt}`))return;const bt=document.createElement("link");if(bt.rel=_t?"stylesheet":scriptRel,_t||(bt.as="script"),bt.crossOrigin="",bt.href=kt,ft&&bt.setAttribute("nonce",ft),document.head.appendChild(bt),_t)return new Promise((Mt,wt)=>{bt.addEventListener("load",Mt),bt.addEventListener("error",()=>wt(new Error(`Unable to preload CSS for ${kt}`)))})}))}function pt(yt){const ft=new Event("vite:preloadError",{cancelable:!0});if(ft.payload=yt,window.dispatchEvent(ft),!ft.defaultPrevented)throw yt}return ut.then(yt=>{for(const ft of yt||[])ft.status==="rejected"&&pt(ft.reason);return it().catch(pt)})};var package_default={name:"mermaid",version:"11.12.1",description:"Markdown-ish syntax for generating flowcharts, mindmaps, sequence diagrams, class diagrams, gantt charts, git graphs and more.",type:"module",module:"./dist/mermaid.core.mjs",types:"./dist/mermaid.d.ts",exports:{".":{types:"./dist/mermaid.d.ts",import:"./dist/mermaid.core.mjs",default:"./dist/mermaid.core.mjs"},"./*":"./*"},keywords:["diagram","markdown","flowchart","sequence diagram","gantt","class diagram","git graph","mindmap","packet diagram","c4 diagram","er diagram","pie chart","pie diagram","quadrant chart","requirement diagram","graph"],scripts:{clean:"rimraf dist",dev:"pnpm -w dev","docs:code":"typedoc src/defaultConfig.ts src/config.ts src/mermaid.ts && prettier --write ./src/docs/config/setup","docs:build":"rimraf ../../docs && pnpm docs:code && pnpm docs:spellcheck && tsx scripts/docs.cli.mts","docs:verify":"pnpm docs:code && pnpm docs:spellcheck && tsx scripts/docs.cli.mts --verify","docs:pre:vitepress":"pnpm --filter ./src/docs prefetch && rimraf src/vitepress && pnpm docs:code && tsx scripts/docs.cli.mts --vitepress && pnpm --filter ./src/vitepress install --no-frozen-lockfile --ignore-scripts","docs:build:vitepress":"pnpm docs:pre:vitepress && (cd src/vitepress && pnpm run build) && cpy --flat src/docs/landing/ ./src/vitepress/.vitepress/dist/landing","docs:dev":'pnpm docs:pre:vitepress && concurrently "pnpm --filter ./src/vitepress dev" "tsx scripts/docs.cli.mts --watch --vitepress"',"docs:dev:docker":'pnpm docs:pre:vitepress && concurrently "pnpm --filter ./src/vitepress dev:docker" "tsx scripts/docs.cli.mts --watch --vitepress"',"docs:serve":"pnpm docs:build:vitepress && vitepress serve src/vitepress","docs:spellcheck":'cspell "src/docs/**/*.md"',"docs:release-version":"tsx scripts/update-release-version.mts","docs:verify-version":"tsx scripts/update-release-version.mts --verify","types:build-config":"tsx scripts/create-types-from-json-schema.mts","types:verify-config":"tsx scripts/create-types-from-json-schema.mts --verify",checkCircle:"npx madge --circular ./src",prepublishOnly:"pnpm docs:verify-version"},repository:{type:"git",url:"https://github.com/mermaid-js/mermaid"},author:"Knut Sveidqvist",license:"MIT",standard:{ignore:["**/parser/*.js","dist/**/*.js","cypress/**/*.js"],globals:["page"]},dependencies:{"@braintree/sanitize-url":"^7.1.1","@iconify/utils":"^3.0.1","@mermaid-js/parser":"workspace:^","@types/d3":"^7.4.3",cytoscape:"^3.29.3","cytoscape-cose-bilkent":"^4.1.0","cytoscape-fcose":"^2.2.0",d3:"^7.9.0","d3-sankey":"^0.12.3","dagre-d3-es":"7.0.13",dayjs:"^1.11.18",dompurify:"^3.2.5",katex:"^0.16.22",khroma:"^2.1.0","lodash-es":"^4.17.21",marked:"^16.2.1",roughjs:"^4.6.6",stylis:"^4.3.6","ts-dedent":"^2.2.0",uuid:"^11.1.0"},devDependencies:{"@adobe/jsonschema2md":"^8.0.5","@iconify/types":"^2.0.0","@types/cytoscape":"^3.21.9","@types/cytoscape-fcose":"^2.2.4","@types/d3-sankey":"^0.12.4","@types/d3-scale":"^4.0.9","@types/d3-scale-chromatic":"^3.1.0","@types/d3-selection":"^3.0.11","@types/d3-shape":"^3.1.7","@types/jsdom":"^21.1.7","@types/katex":"^0.16.7","@types/lodash-es":"^4.17.12","@types/micromatch":"^4.0.9","@types/stylis":"^4.2.7","@types/uuid":"^10.0.0",ajv:"^8.17.1",canvas:"^3.1.2",chokidar:"3.6.0",concurrently:"^9.1.2","csstree-validator":"^4.0.1",globby:"^14.1.0",jison:"^0.4.18","js-base64":"^3.7.8",jsdom:"^26.1.0","json-schema-to-typescript":"^15.0.4",micromatch:"^4.0.8","path-browserify":"^1.0.1",prettier:"^3.5.3",remark:"^15.0.1","remark-frontmatter":"^5.0.0","remark-gfm":"^4.0.1",rimraf:"^6.0.1","start-server-and-test":"^2.0.13","type-fest":"^4.35.0",typedoc:"^0.28.12","typedoc-plugin-markdown":"^4.8.1",typescript:"~5.7.3","unist-util-flatmap":"^1.0.0","unist-util-visit":"^5.0.0",vitepress:"^1.6.4","vitepress-plugin-search":"1.0.4-alpha.22"},files:["dist/","README.md"],publishConfig:{access:"public"}},dayjs_min$1={exports:{}},dayjs_min=dayjs_min$1.exports,hasRequiredDayjs_min;function requireDayjs_min(){return hasRequiredDayjs_min||(hasRequiredDayjs_min=1,(function(rt,it){(function(ct,dt){rt.exports=dt()})(dayjs_min,(function(){var ct=1e3,dt=6e4,ut=36e5,pt="millisecond",yt="second",ft="minute",mt="hour",kt="day",_t="week",vt="month",bt="quarter",Mt="year",wt="date",St="Invalid Date",It=/^(\d{4})[-/]?(\d{1,2})?[-/]?(\d{0,2})[Tt\s]*(\d{1,2})?:?(\d{1,2})?:?(\d{1,2})?[.:]?(\d+)?$/,Nt=/\[([^\]]+)]|Y{1,4}|M{1,4}|D{1,2}|d{1,4}|H{1,2}|h{1,2}|a|A|m{1,2}|s{1,2}|Z{1,2}|SSS/g,$t={name:"en",weekdays:"Sunday_Monday_Tuesday_Wednesday_Thursday_Friday_Saturday".split("_"),months:"January_February_March_April_May_June_July_August_September_October_November_December".split("_"),ordinal:function(Kt){var ra=["th","st","nd","rd"],Ut=Kt%100;return"["+Kt+(ra[(Ut-20)%10]||ra[Ut]||ra[0])+"]"}},Et=function(Kt,ra,Ut){var ea=String(Kt);return!ea||ea.length>=ra?Kt:""+Array(ra+1-ea.length).join(Ut)+Kt},Ft={s:Et,z:function(Kt){var ra=-Kt.utcOffset(),Ut=Math.abs(ra),ea=Math.floor(Ut/60),Gt=Ut%60;return(ra<=0?"+":"-")+Et(ea,2,"0")+":"+Et(Gt,2,"0")},m:function Kt(ra,Ut){if(ra.date()<Ut.date())return-Kt(Ut,ra);var ea=12*(Ut.year()-ra.year())+(Ut.month()-ra.month()),Gt=ra.clone().add(ea,vt),_a=Ut-Gt<0,Ca=ra.clone().add(ea+(_a?-1:1),vt);return+(-(ea+(Ut-Gt)/(_a?Gt-Ca:Ca-Gt))||0)},a:function(Kt){return Kt<0?Math.ceil(Kt)||0:Math.floor(Kt)},p:function(Kt){return{M:vt,y:Mt,w:_t,d:kt,D:wt,h:mt,m:ft,s:yt,ms:pt,Q:bt}[Kt]||String(Kt||"").toLowerCase().replace(/s$/,"")},u:function(Kt){return Kt===void 0}},qt="en",Ht={};Ht[qt]=$t;var Ot="$isDayjsObject",Zt=function(Kt){return Kt instanceof oa||!(!Kt||!Kt[Ot])},Yt=function Kt(ra,Ut,ea){var Gt;if(!ra)return qt;if(typeof ra=="string"){var _a=ra.toLowerCase();Ht[_a]&&(Gt=_a),Ut&&(Ht[_a]=Ut,Gt=_a);var Ca=ra.split("-");if(!Gt&&Ca.length>1)return Kt(Ca[0])}else{var Vt=ra.name;Ht[Vt]=ra,Gt=Vt}return!ea&&Gt&&(qt=Gt),Gt||!ea&&qt},aa=function(Kt,ra){if(Zt(Kt))return Kt.clone();var Ut=typeof ra=="object"?ra:{};return Ut.date=Kt,Ut.args=arguments,new oa(Ut)},Qt=Ft;Qt.l=Yt,Qt.i=Zt,Qt.w=function(Kt,ra){return aa(Kt,{locale:ra.$L,utc:ra.$u,x:ra.$x,$offset:ra.$offset})};var oa=(function(){function Kt(Ut){this.$L=Yt(Ut.locale,null,!0),this.parse(Ut),this.$x=this.$x||Ut.x||{},this[Ot]=!0}var ra=Kt.prototype;return ra.parse=function(Ut){this.$d=(function(ea){var Gt=ea.date,_a=ea.utc;if(Gt===null)return new Date(NaN);if(Qt.u(Gt))return new Date;if(Gt instanceof Date)return new Date(Gt);if(typeof Gt=="string"&&!/Z$/i.test(Gt)){var Ca=Gt.match(It);if(Ca){var Vt=Ca[2]-1||0,ta=(Ca[7]||"0").substring(0,3);return _a?new Date(Date.UTC(Ca[1],Vt,Ca[3]||1,Ca[4]||0,Ca[5]||0,Ca[6]||0,ta)):new Date(Ca[1],Vt,Ca[3]||1,Ca[4]||0,Ca[5]||0,Ca[6]||0,ta)}}return new Date(Gt)})(Ut),this.init()},ra.init=function(){var Ut=this.$d;this.$y=Ut.getFullYear(),this.$M=Ut.getMonth(),this.$D=Ut.getDate(),this.$W=Ut.getDay(),this.$H=Ut.getHours(),this.$m=Ut.getMinutes(),this.$s=Ut.getSeconds(),this.$ms=Ut.getMilliseconds()},ra.$utils=function(){return Qt},ra.isValid=function(){return this.$d.toString()!==St},ra.isSame=function(Ut,ea){var Gt=aa(Ut);return this.startOf(ea)<=Gt&&Gt<=this.endOf(ea)},ra.isAfter=function(Ut,ea){return aa(Ut)<this.startOf(ea)},ra.isBefore=function(Ut,ea){return this.endOf(ea)<aa(Ut)},ra.$g=function(Ut,ea,Gt){return Qt.u(Ut)?this[ea]:this.set(Gt,Ut)},ra.unix=function(){return Math.floor(this.valueOf()/1e3)},ra.valueOf=function(){return this.$d.getTime()},ra.startOf=function(Ut,ea){var Gt=this,_a=!!Qt.u(ea)||ea,Ca=Qt.p(Ut),Vt=function(qa,Ha){var rn=Qt.w(Gt.$u?Date.UTC(Gt.$y,Ha,qa):new Date(Gt.$y,Ha,qa),Gt);return _a?rn:rn.endOf(kt)},ta=function(qa,Ha){return Qt.w(Gt.toDate()[qa].apply(Gt.toDate("s"),(_a?[0,0,0,0]:[23,59,59,999]).slice(Ha)),Gt)},sa=this.$W,xa=this.$M,ka=this.$D,$a="set"+(this.$u?"UTC":"");switch(Ca){case Mt:return _a?Vt(1,0):Vt(31,11);case vt:return _a?Vt(1,xa):Vt(0,xa+1);case _t:var Na=this.$locale().weekStart||0,Fa=(sa<Na?sa+7:sa)-Na;return Vt(_a?ka-Fa:ka+(6-Fa),xa);case kt:case wt:return ta($a+"Hours",0);case mt:return ta($a+"Minutes",1);case ft:return ta($a+"Seconds",2);case yt:return ta($a+"Milliseconds",3);default:return this.clone()}},ra.endOf=function(Ut){return this.startOf(Ut,!1)},ra.$set=function(Ut,ea){var Gt,_a=Qt.p(Ut),Ca="set"+(this.$u?"UTC":""),Vt=(Gt={},Gt[kt]=Ca+"Date",Gt[wt]=Ca+"Date",Gt[vt]=Ca+"Month",Gt[Mt]=Ca+"FullYear",Gt[mt]=Ca+"Hours",Gt[ft]=Ca+"Minutes",Gt[yt]=Ca+"Seconds",Gt[pt]=Ca+"Milliseconds",Gt)[_a],ta=_a===kt?this.$D+(ea-this.$W):ea;if(_a===vt||_a===Mt){var sa=this.clone().set(wt,1);sa.$d[Vt](ta),sa.init(),this.$d=sa.set(wt,Math.min(this.$D,sa.daysInMonth())).$d}else Vt&&this.$d[Vt](ta);return this.init(),this},ra.set=function(Ut,ea){return this.clone().$set(Ut,ea)},ra.get=function(Ut){return this[Qt.p(Ut)]()},ra.add=function(Ut,ea){var Gt,_a=this;Ut=Number(Ut);var Ca=Qt.p(ea),Vt=function(xa){var ka=aa(_a);return Qt.w(ka.date(ka.date()+Math.round(xa*Ut)),_a)};if(Ca===vt)return this.set(vt,this.$M+Ut);if(Ca===Mt)return this.set(Mt,this.$y+Ut);if(Ca===kt)return Vt(1);if(Ca===_t)return Vt(7);var ta=(Gt={},Gt[ft]=dt,Gt[mt]=ut,Gt[yt]=ct,Gt)[Ca]||1,sa=this.$d.getTime()+Ut*ta;return Qt.w(sa,this)},ra.subtract=function(Ut,ea){return this.add(-1*Ut,ea)},ra.format=function(Ut){var ea=this,Gt=this.$locale();if(!this.isValid())return Gt.invalidDate||St;var _a=Ut||"YYYY-MM-DDTHH:mm:ssZ",Ca=Qt.z(this),Vt=this.$H,ta=this.$m,sa=this.$M,xa=Gt.weekdays,ka=Gt.months,$a=Gt.meridiem,Na=function(Ha,rn,hn,Ja){return Ha&&(Ha[rn]||Ha(ea,_a))||hn[rn].slice(0,Ja)},Fa=function(Ha){return Qt.s(Vt%12||12,Ha,"0")},qa=$a||function(Ha,rn,hn){var Ja=Ha<12?"AM":"PM";return hn?Ja.toLowerCase():Ja};return _a.replace(Nt,(function(Ha,rn){return rn||(function(hn){switch(hn){case"YY":return String(ea.$y).slice(-2);case"YYYY":return Qt.s(ea.$y,4,"0");case"M":return sa+1;case"MM":return Qt.s(sa+1,2,"0");case"MMM":return Na(Gt.monthsShort,sa,ka,3);case"MMMM":return Na(ka,sa);case"D":return ea.$D;case"DD":return Qt.s(ea.$D,2,"0");case"d":return String(ea.$W);case"dd":return Na(Gt.weekdaysMin,ea.$W,xa,2);case"ddd":return Na(Gt.weekdaysShort,ea.$W,xa,3);case"dddd":return xa[ea.$W];case"H":return String(Vt);case"HH":return Qt.s(Vt,2,"0");case"h":return Fa(1);case"hh":return Fa(2);case"a":return qa(Vt,ta,!0);case"A":return qa(Vt,ta,!1);case"m":return String(ta);case"mm":return Qt.s(ta,2,"0");case"s":return String(ea.$s);case"ss":return Qt.s(ea.$s,2,"0");case"SSS":return Qt.s(ea.$ms,3,"0");case"Z":return Ca}return null})(Ha)||Ca.replace(":","")}))},ra.utcOffset=function(){return 15*-Math.round(this.$d.getTimezoneOffset()/15)},ra.diff=function(Ut,ea,Gt){var _a,Ca=this,Vt=Qt.p(ea),ta=aa(Ut),sa=(ta.utcOffset()-this.utcOffset())*dt,xa=this-ta,ka=function(){return Qt.m(Ca,ta)};switch(Vt){case Mt:_a=ka()/12;break;case vt:_a=ka();break;case bt:_a=ka()/3;break;case _t:_a=(xa-sa)/6048e5;break;case kt:_a=(xa-sa)/864e5;break;case mt:_a=xa/ut;break;case ft:_a=xa/dt;break;case yt:_a=xa/ct;break;default:_a=xa}return Gt?_a:Qt.a(_a)},ra.daysInMonth=function(){return this.endOf(vt).$D},ra.$locale=function(){return Ht[this.$L]},ra.locale=function(Ut,ea){if(!Ut)return this.$L;var Gt=this.clone(),_a=Yt(Ut,ea,!0);return _a&&(Gt.$L=_a),Gt},ra.clone=function(){return Qt.w(this.$d,this)},ra.toDate=function(){return new Date(this.valueOf())},ra.toJSON=function(){return this.isValid()?this.toISOString():null},ra.toISOString=function(){return this.$d.toISOString()},ra.toString=function(){return this.$d.toUTCString()},Kt})(),la=oa.prototype;return aa.prototype=la,[["$ms",pt],["$s",yt],["$m",ft],["$H",mt],["$W",kt],["$M",vt],["$y",Mt],["$D",wt]].forEach((function(Kt){la[Kt[1]]=function(ra){return this.$g(ra,Kt[0],Kt[1])}})),aa.extend=function(Kt,ra){return Kt.$i||(Kt(ra,oa,aa),Kt.$i=!0),aa},aa.locale=Yt,aa.isDayjs=Zt,aa.unix=function(Kt){return aa(1e3*Kt)},aa.en=Ht[qt],aa.Ls=Ht,aa.p={},aa}))})(dayjs_min$1)),dayjs_min$1.exports}var dayjs_minExports=requireDayjs_min();const dayjs2=getDefaultExportFromCjs(dayjs_minExports);var __defProp$1=Object.defineProperty,__name=(rt,it)=>__defProp$1(rt,"name",{value:it,configurable:!0}),__export$1=(rt,it)=>{for(var ct in it)__defProp$1(rt,ct,{get:it[ct],enumerable:!0})},LEVELS={trace:0,debug:1,info:2,warn:3,error:4,fatal:5},log={trace:__name((...rt)=>{},"trace"),debug:__name((...rt)=>{},"debug"),info:__name((...rt)=>{},"info"),warn:__name((...rt)=>{},"warn"),error:__name((...rt)=>{},"error"),fatal:__name((...rt)=>{},"fatal")},setLogLevel=__name(function(rt="fatal"){let it=LEVELS.fatal;typeof rt=="string"?rt.toLowerCase()in LEVELS&&(it=LEVELS[rt]):typeof rt=="number"&&(it=rt),log.trace=()=>{},log.debug=()=>{},log.info=()=>{},log.warn=()=>{},log.error=()=>{},log.fatal=()=>{},it<=LEVELS.fatal&&(log.fatal=console.error?console.error.bind(console,format$1("FATAL"),"color: orange"):console.log.bind(console,"\x1B[35m",format$1("FATAL"))),it<=LEVELS.error&&(log.error=console.error?console.error.bind(console,format$1("ERROR"),"color: orange"):console.log.bind(console,"\x1B[31m",format$1("ERROR"))),it<=LEVELS.warn&&(log.warn=console.warn?console.warn.bind(console,format$1("WARN"),"color: orange"):console.log.bind(console,"\x1B[33m",format$1("WARN"))),it<=LEVELS.info&&(log.info=console.info?console.info.bind(console,format$1("INFO"),"color: lightblue"):console.log.bind(console,"\x1B[34m",format$1("INFO"))),it<=LEVELS.debug&&(log.debug=console.debug?console.debug.bind(console,format$1("DEBUG"),"color: lightgreen"):console.log.bind(console,"\x1B[32m",format$1("DEBUG"))),it<=LEVELS.trace&&(log.trace=console.debug?console.debug.bind(console,format$1("TRACE"),"color: lightgreen"):console.log.bind(console,"\x1B[32m",format$1("TRACE")))},"setLogLevel"),format$1=__name(rt=>`%c${dayjs2().format("ss.SSS")} : ${rt} : `,"format");const Channel={min:{r:0,g:0,b:0,s:0,l:0,a:0},max:{r:255,g:255,b:255,h:360,s:100,l:100,a:1},clamp:{r:rt=>rt>=255?255:rt<0?0:rt,g:rt=>rt>=255?255:rt<0?0:rt,b:rt=>rt>=255?255:rt<0?0:rt,h:rt=>rt%360,s:rt=>rt>=100?100:rt<0?0:rt,l:rt=>rt>=100?100:rt<0?0:rt,a:rt=>rt>=1?1:rt<0?0:rt},toLinear:rt=>{const it=rt/255;return rt>.03928?Math.pow((it+.055)/1.055,2.4):it/12.92},hue2rgb:(rt,it,ct)=>(ct<0&&(ct+=1),ct>1&&(ct-=1),ct<1/6?rt+(it-rt)*6*ct:ct<1/2?it:ct<2/3?rt+(it-rt)*(2/3-ct)*6:rt),hsl2rgb:({h:rt,s:it,l:ct},dt)=>{if(!it)return ct*2.55;rt/=360,it/=100,ct/=100;const ut=ct<.5?ct*(1+it):ct+it-ct*it,pt=2*ct-ut;switch(dt){case"r":return Channel.hue2rgb(pt,ut,rt+1/3)*255;case"g":return Channel.hue2rgb(pt,ut,rt)*255;case"b":return Channel.hue2rgb(pt,ut,rt-1/3)*255}},rgb2hsl:({r:rt,g:it,b:ct},dt)=>{rt/=255,it/=255,ct/=255;const ut=Math.max(rt,it,ct),pt=Math.min(rt,it,ct),yt=(ut+pt)/2;if(dt==="l")return yt*100;if(ut===pt)return 0;const ft=ut-pt,mt=yt>.5?ft/(2-ut-pt):ft/(ut+pt);if(dt==="s")return mt*100;switch(ut){case rt:return((it-ct)/ft+(it<ct?6:0))*60;case it:return((ct-rt)/ft+2)*60;case ct:return((rt-it)/ft+4)*60;default:return-1}}},Lang={clamp:(rt,it,ct)=>it>ct?Math.min(it,Math.max(ct,rt)):Math.min(ct,Math.max(it,rt)),round:rt=>Math.round(rt*1e10)/1e10},Unit={dec2hex:rt=>{const it=Math.round(rt).toString(16);return it.length>1?it:`0${it}`}},Utils={channel:Channel,lang:Lang,unit:Unit},DEC2HEX={};for(let rt=0;rt<=255;rt++)DEC2HEX[rt]=Utils.unit.dec2hex(rt);const TYPE={ALL:0,RGB:1,HSL:2};class Type{constructor(){this.type=TYPE.ALL}get(){return this.type}set(it){if(this.type&&this.type!==it)throw new Error("Cannot change both RGB and HSL channels at the same time");this.type=it}reset(){this.type=TYPE.ALL}is(it){return this.type===it}}class Channels{constructor(it,ct){this.color=ct,this.changed=!1,this.data=it,this.type=new Type}set(it,ct){return this.color=ct,this.changed=!1,this.data=it,this.type.type=TYPE.ALL,this}_ensureHSL(){const it=this.data,{h:ct,s:dt,l:ut}=it;ct===void 0&&(it.h=Utils.channel.rgb2hsl(it,"h")),dt===void 0&&(it.s=Utils.channel.rgb2hsl(it,"s")),ut===void 0&&(it.l=Utils.channel.rgb2hsl(it,"l"))}_ensureRGB(){const it=this.data,{r:ct,g:dt,b:ut}=it;ct===void 0&&(it.r=Utils.channel.hsl2rgb(it,"r")),dt===void 0&&(it.g=Utils.channel.hsl2rgb(it,"g")),ut===void 0&&(it.b=Utils.channel.hsl2rgb(it,"b"))}get r(){const it=this.data,ct=it.r;return!this.type.is(TYPE.HSL)&&ct!==void 0?ct:(this._ensureHSL(),Utils.channel.hsl2rgb(it,"r"))}get g(){const it=this.data,ct=it.g;return!this.type.is(TYPE.HSL)&&ct!==void 0?ct:(this._ensureHSL(),Utils.channel.hsl2rgb(it,"g"))}get b(){const it=this.data,ct=it.b;return!this.type.is(TYPE.HSL)&&ct!==void 0?ct:(this._ensureHSL(),Utils.channel.hsl2rgb(it,"b"))}get h(){const it=this.data,ct=it.h;return!this.type.is(TYPE.RGB)&&ct!==void 0?ct:(this._ensureRGB(),Utils.channel.rgb2hsl(it,"h"))}get s(){const it=this.data,ct=it.s;return!this.type.is(TYPE.RGB)&&ct!==void 0?ct:(this._ensureRGB(),Utils.channel.rgb2hsl(it,"s"))}get l(){const it=this.data,ct=it.l;return!this.type.is(TYPE.RGB)&&ct!==void 0?ct:(this._ensureRGB(),Utils.channel.rgb2hsl(it,"l"))}get a(){return this.data.a}set r(it){this.type.set(TYPE.RGB),this.changed=!0,this.data.r=it}set g(it){this.type.set(TYPE.RGB),this.changed=!0,this.data.g=it}set b(it){this.type.set(TYPE.RGB),this.changed=!0,this.data.b=it}set h(it){this.type.set(TYPE.HSL),this.changed=!0,this.data.h=it}set s(it){this.type.set(TYPE.HSL),this.changed=!0,this.data.s=it}set l(it){this.type.set(TYPE.HSL),this.changed=!0,this.data.l=it}set a(it){this.changed=!0,this.data.a=it}}const channels=new Channels({r:0,g:0,b:0,a:0},"transparent"),Hex={re:/^#((?:[a-f0-9]{2}){2,4}|[a-f0-9]{3})$/i,parse:rt=>{if(rt.charCodeAt(0)!==35)return;const it=rt.match(Hex.re);if(!it)return;const ct=it[1],dt=parseInt(ct,16),ut=ct.length,pt=ut%4===0,yt=ut>4,ft=yt?1:17,mt=yt?8:4,kt=pt?0:-1,_t=yt?255:15;return channels.set({r:(dt>>mt*(kt+3)&_t)*ft,g:(dt>>mt*(kt+2)&_t)*ft,b:(dt>>mt*(kt+1)&_t)*ft,a:pt?(dt&_t)*ft/255:1},rt)},stringify:rt=>{const{r:it,g:ct,b:dt,a:ut}=rt;return ut<1?`#${DEC2HEX[Math.round(it)]}${DEC2HEX[Math.round(ct)]}${DEC2HEX[Math.round(dt)]}${DEC2HEX[Math.round(ut*255)]}`:`#${DEC2HEX[Math.round(it)]}${DEC2HEX[Math.round(ct)]}${DEC2HEX[Math.round(dt)]}`}},HSL={re:/^hsla?\(\s*?(-?(?:\d+(?:\.\d+)?|(?:\.\d+))(?:e-?\d+)?(?:deg|grad|rad|turn)?)\s*?(?:,|\s)\s*?(-?(?:\d+(?:\.\d+)?|(?:\.\d+))(?:e-?\d+)?%)\s*?(?:,|\s)\s*?(-?(?:\d+(?:\.\d+)?|(?:\.\d+))(?:e-?\d+)?%)(?:\s*?(?:,|\/)\s*?\+?(-?(?:\d+(?:\.\d+)?|(?:\.\d+))(?:e-?\d+)?(%)?))?\s*?\)$/i,hueRe:/^(.+?)(deg|grad|rad|turn)$/i,_hue2deg:rt=>{const it=rt.match(HSL.hueRe);if(it){const[,ct,dt]=it;switch(dt){case"grad":return Utils.channel.clamp.h(parseFloat(ct)*.9);case"rad":return Utils.channel.clamp.h(parseFloat(ct)*180/Math.PI);case"turn":return Utils.channel.clamp.h(parseFloat(ct)*360)}}return Utils.channel.clamp.h(parseFloat(rt))},parse:rt=>{const it=rt.charCodeAt(0);if(it!==104&&it!==72)return;const ct=rt.match(HSL.re);if(!ct)return;const[,dt,ut,pt,yt,ft]=ct;return channels.set({h:HSL._hue2deg(dt),s:Utils.channel.clamp.s(parseFloat(ut)),l:Utils.channel.clamp.l(parseFloat(pt)),a:yt?Utils.channel.clamp.a(ft?parseFloat(yt)/100:parseFloat(yt)):1},rt)},stringify:rt=>{const{h:it,s:ct,l:dt,a:ut}=rt;return ut<1?`hsla(${Utils.lang.round(it)}, ${Utils.lang.round(ct)}%, ${Utils.lang.round(dt)}%, ${ut})`:`hsl(${Utils.lang.round(it)}, ${Utils.lang.round(ct)}%, ${Utils.lang.round(dt)}%)`}},Keyword={colors:{aliceblue:"#f0f8ff",antiquewhite:"#faebd7",aqua:"#00ffff",aquamarine:"#7fffd4",azure:"#f0ffff",beige:"#f5f5dc",bisque:"#ffe4c4",black:"#000000",blanchedalmond:"#ffebcd",blue:"#0000ff",blueviolet:"#8a2be2",brown:"#a52a2a",burlywood:"#deb887",cadetblue:"#5f9ea0",chartreuse:"#7fff00",chocolate:"#d2691e",coral:"#ff7f50",cornflowerblue:"#6495ed",cornsilk:"#fff8dc",crimson:"#dc143c",cyanaqua:"#00ffff",darkblue:"#00008b",darkcyan:"#008b8b",darkgoldenrod:"#b8860b",darkgray:"#a9a9a9",darkgreen:"#006400",darkgrey:"#a9a9a9",darkkhaki:"#bdb76b",darkmagenta:"#8b008b",darkolivegreen:"#556b2f",darkorange:"#ff8c00",darkorchid:"#9932cc",darkred:"#8b0000",darksalmon:"#e9967a",darkseagreen:"#8fbc8f",darkslateblue:"#483d8b",darkslategray:"#2f4f4f",darkslategrey:"#2f4f4f",darkturquoise:"#00ced1",darkviolet:"#9400d3",deeppink:"#ff1493",deepskyblue:"#00bfff",dimgray:"#696969",dimgrey:"#696969",dodgerblue:"#1e90ff",firebrick:"#b22222",floralwhite:"#fffaf0",forestgreen:"#228b22",fuchsia:"#ff00ff",gainsboro:"#dcdcdc",ghostwhite:"#f8f8ff",gold:"#ffd700",goldenrod:"#daa520",gray:"#808080",green:"#008000",greenyellow:"#adff2f",grey:"#808080",honeydew:"#f0fff0",hotpink:"#ff69b4",indianred:"#cd5c5c",indigo:"#4b0082",ivory:"#fffff0",khaki:"#f0e68c",lavender:"#e6e6fa",lavenderblush:"#fff0f5",lawngreen:"#7cfc00",lemonchiffon:"#fffacd",lightblue:"#add8e6",lightcoral:"#f08080",lightcyan:"#e0ffff",lightgoldenrodyellow:"#fafad2",lightgray:"#d3d3d3",lightgreen:"#90ee90",lightgrey:"#d3d3d3",lightpink:"#ffb6c1",lightsalmon:"#ffa07a",lightseagreen:"#20b2aa",lightskyblue:"#87cefa",lightslategray:"#778899",lightslategrey:"#778899",lightsteelblue:"#b0c4de",lightyellow:"#ffffe0",lime:"#00ff00",limegreen:"#32cd32",linen:"#faf0e6",magenta:"#ff00ff",maroon:"#800000",mediumaquamarine:"#66cdaa",mediumblue:"#0000cd",mediumorchid:"#ba55d3",mediumpurple:"#9370db",mediumseagreen:"#3cb371",mediumslateblue:"#7b68ee",mediumspringgreen:"#00fa9a",mediumturquoise:"#48d1cc",mediumvioletred:"#c71585",midnightblue:"#191970",mintcream:"#f5fffa",mistyrose:"#ffe4e1",moccasin:"#ffe4b5",navajowhite:"#ffdead",navy:"#000080",oldlace:"#fdf5e6",olive:"#808000",olivedrab:"#6b8e23",orange:"#ffa500",orangered:"#ff4500",orchid:"#da70d6",palegoldenrod:"#eee8aa",palegreen:"#98fb98",paleturquoise:"#afeeee",palevioletred:"#db7093",papayawhip:"#ffefd5",peachpuff:"#ffdab9",peru:"#cd853f",pink:"#ffc0cb",plum:"#dda0dd",powderblue:"#b0e0e6",purple:"#800080",rebeccapurple:"#663399",red:"#ff0000",rosybrown:"#bc8f8f",royalblue:"#4169e1",saddlebrown:"#8b4513",salmon:"#fa8072",sandybrown:"#f4a460",seagreen:"#2e8b57",seashell:"#fff5ee",sienna:"#a0522d",silver:"#c0c0c0",skyblue:"#87ceeb",slateblue:"#6a5acd",slategray:"#708090",slategrey:"#708090",snow:"#fffafa",springgreen:"#00ff7f",tan:"#d2b48c",teal:"#008080",thistle:"#d8bfd8",transparent:"#00000000",turquoise:"#40e0d0",violet:"#ee82ee",wheat:"#f5deb3",white:"#ffffff",whitesmoke:"#f5f5f5",yellow:"#ffff00",yellowgreen:"#9acd32"},parse:rt=>{rt=rt.toLowerCase();const it=Keyword.colors[rt];if(it)return Hex.parse(it)},stringify:rt=>{const it=Hex.stringify(rt);for(const ct in Keyword.colors)if(Keyword.colors[ct]===it)return ct}},RGB={re:/^rgba?\(\s*?(-?(?:\d+(?:\.\d+)?|(?:\.\d+))(?:e\d+)?(%?))\s*?(?:,|\s)\s*?(-?(?:\d+(?:\.\d+)?|(?:\.\d+))(?:e\d+)?(%?))\s*?(?:,|\s)\s*?(-?(?:\d+(?:\.\d+)?|(?:\.\d+))(?:e\d+)?(%?))(?:\s*?(?:,|\/)\s*?\+?(-?(?:\d+(?:\.\d+)?|(?:\.\d+))(?:e\d+)?(%?)))?\s*?\)$/i,parse:rt=>{const it=rt.charCodeAt(0);if(it!==114&&it!==82)return;const ct=rt.match(RGB.re);if(!ct)return;const[,dt,ut,pt,yt,ft,mt,kt,_t]=ct;return channels.set({r:Utils.channel.clamp.r(ut?parseFloat(dt)*2.55:parseFloat(dt)),g:Utils.channel.clamp.g(yt?parseFloat(pt)*2.55:parseFloat(pt)),b:Utils.channel.clamp.b(mt?parseFloat(ft)*2.55:parseFloat(ft)),a:kt?Utils.channel.clamp.a(_t?parseFloat(kt)/100:parseFloat(kt)):1},rt)},stringify:rt=>{const{r:it,g:ct,b:dt,a:ut}=rt;return ut<1?`rgba(${Utils.lang.round(it)}, ${Utils.lang.round(ct)}, ${Utils.lang.round(dt)}, ${Utils.lang.round(ut)})`:`rgb(${Utils.lang.round(it)}, ${Utils.lang.round(ct)}, ${Utils.lang.round(dt)})`}},Color$1={format:{keyword:Keyword,hex:Hex,rgb:RGB,rgba:RGB,hsl:HSL,hsla:HSL},parse:rt=>{if(typeof rt!="string")return rt;const it=Hex.parse(rt)||RGB.parse(rt)||HSL.parse(rt)||Keyword.parse(rt);if(it)return it;throw new Error(`Unsupported color format: "${rt}"`)},stringify:rt=>!rt.changed&&rt.color?rt.color:rt.type.is(TYPE.HSL)||rt.data.r===void 0?HSL.stringify(rt):rt.a<1||!Number.isInteger(rt.r)||!Number.isInteger(rt.g)||!Number.isInteger(rt.b)?RGB.stringify(rt):Hex.stringify(rt)},change=(rt,it)=>{const ct=Color$1.parse(rt);for(const dt in it)ct[dt]=Utils.channel.clamp[dt](it[dt]);return Color$1.stringify(ct)},rgba$1=(rt,it,ct=0,dt=1)=>{if(typeof rt!="number")return change(rt,{a:it});const ut=channels.set({r:Utils.channel.clamp.r(rt),g:Utils.channel.clamp.g(it),b:Utils.channel.clamp.b(ct),a:Utils.channel.clamp.a(dt)});return Color$1.stringify(ut)},luminance=rt=>{const{r:it,g:ct,b:dt}=Color$1.parse(rt),ut=.2126*Utils.channel.toLinear(it)+.7152*Utils.channel.toLinear(ct)+.0722*Utils.channel.toLinear(dt);return Utils.lang.round(ut)},isLight=rt=>luminance(rt)>=.5,isDark=rt=>!isLight(rt),adjustChannel=(rt,it,ct)=>{const dt=Color$1.parse(rt),ut=dt[it],pt=Utils.channel.clamp[it](ut+ct);return ut!==pt&&(dt[it]=pt),Color$1.stringify(dt)},lighten=(rt,it)=>adjustChannel(rt,"l",it),darken=(rt,it)=>adjustChannel(rt,"l",-it),adjust=(rt,it)=>{const ct=Color$1.parse(rt),dt={};for(const ut in it)it[ut]&&(dt[ut]=ct[ut]+it[ut]);return change(rt,dt)},mix=(rt,it,ct=50)=>{const{r:dt,g:ut,b:pt,a:yt}=Color$1.parse(rt),{r:ft,g:mt,b:kt,a:_t}=Color$1.parse(it),vt=ct/100,bt=vt*2-1,Mt=yt-_t,St=((bt*Mt===-1?bt:(bt+Mt)/(1+bt*Mt))+1)/2,It=1-St,Nt=dt*St+ft*It,$t=ut*St+mt*It,Et=pt*St+kt*It,Ft=yt*vt+_t*(1-vt);return rgba$1(Nt,$t,Et,Ft)},invert=(rt,it=100)=>{const ct=Color$1.parse(rt);return ct.r=255-ct.r,ct.g=255-ct.g,ct.b=255-ct.b,mix(ct,rt,it)};const{entries,setPrototypeOf,isFrozen,getPrototypeOf,getOwnPropertyDescriptor}=Object;let{freeze,seal,create:create$1}=Object,{apply:apply$1,construct}=typeof Reflect<"u"&&Reflect;freeze||(freeze=function(it){return it});seal||(seal=function(it){return it});apply$1||(apply$1=function(it,ct){for(var dt=arguments.length,ut=new Array(dt>2?dt-2:0),pt=2;pt<dt;pt++)ut[pt-2]=arguments[pt];return it.apply(ct,ut)});construct||(construct=function(it){for(var ct=arguments.length,dt=new Array(ct>1?ct-1:0),ut=1;ut<ct;ut++)dt[ut-1]=arguments[ut];return new it(...dt)});const arrayForEach=unapply(Array.prototype.forEach),arrayLastIndexOf=unapply(Array.prototype.lastIndexOf),arrayPop=unapply(Array.prototype.pop),arrayPush=unapply(Array.prototype.push),arraySplice=unapply(Array.prototype.splice),stringToLowerCase=unapply(String.prototype.toLowerCase),stringToString=unapply(String.prototype.toString),stringMatch=unapply(String.prototype.match),stringReplace=unapply(String.prototype.replace),stringIndexOf=unapply(String.prototype.indexOf),stringTrim=unapply(String.prototype.trim),objectHasOwnProperty=unapply(Object.prototype.hasOwnProperty),regExpTest=unapply(RegExp.prototype.test),typeErrorCreate=unconstruct(TypeError);function unapply(rt){return function(it){it instanceof RegExp&&(it.lastIndex=0);for(var ct=arguments.length,dt=new Array(ct>1?ct-1:0),ut=1;ut<ct;ut++)dt[ut-1]=arguments[ut];return apply$1(rt,it,dt)}}function unconstruct(rt){return function(){for(var it=arguments.length,ct=new Array(it),dt=0;dt<it;dt++)ct[dt]=arguments[dt];return construct(rt,ct)}}function addToSet(rt,it){let ct=arguments.length>2&&arguments[2]!==void 0?arguments[2]:stringToLowerCase;setPrototypeOf&&setPrototypeOf(rt,null);let dt=it.length;for(;dt--;){let ut=it[dt];if(typeof ut=="string"){const pt=ct(ut);pt!==ut&&(isFrozen(it)||(it[dt]=pt),ut=pt)}rt[ut]=!0}return rt}function cleanArray(rt){for(let it=0;it<rt.length;it++)objectHasOwnProperty(rt,it)||(rt[it]=null);return rt}function clone(rt){const it=create$1(null);for(const[ct,dt]of entries(rt))objectHasOwnProperty(rt,ct)&&(Array.isArray(dt)?it[ct]=cleanArray(dt):dt&&typeof dt=="object"&&dt.constructor===Object?it[ct]=clone(dt):it[ct]=dt);return it}function lookupGetter(rt,it){for(;rt!==null;){const dt=getOwnPropertyDescriptor(rt,it);if(dt){if(dt.get)return unapply(dt.get);if(typeof dt.value=="function")return unapply(dt.value)}rt=getPrototypeOf(rt)}function ct(){return null}return ct}const html$1=freeze(["a","abbr","acronym","address","area","article","aside","audio","b","bdi","bdo","big","blink","blockquote","body","br","button","canvas","caption","center","cite","code","col","colgroup","content","data","datalist","dd","decorator","del","details","dfn","dialog","dir","div","dl","dt","element","em","fieldset","figcaption","figure","font","footer","form","h1","h2","h3","h4","h5","h6","head","header","hgroup","hr","html","i","img","input","ins","kbd","label","legend","li","main","map","mark","marquee","menu","menuitem","meter","nav","nobr","ol","optgroup","option","output","p","picture","pre","progress","q","rp","rt","ruby","s","samp","search","section","select","shadow","slot","small","source","spacer","span","strike","strong","style","sub","summary","sup","table","tbody","td","template","textarea","tfoot","th","thead","time","tr","track","tt","u","ul","var","video","wbr"]),svg$1=freeze(["svg","a","altglyph","altglyphdef","altglyphitem","animatecolor","animatemotion","animatetransform","circle","clippath","defs","desc","ellipse","enterkeyhint","exportparts","filter","font","g","glyph","glyphref","hkern","image","inputmode","line","lineargradient","marker","mask","metadata","mpath","part","path","pattern","polygon","polyline","radialgradient","rect","stop","style","switch","symbol","text","textpath","title","tref","tspan","view","vkern"]),svgFilters=freeze(["feBlend","feColorMatrix","feComponentTransfer","feComposite","feConvolveMatrix","feDiffuseLighting","feDisplacementMap","feDistantLight","feDropShadow","feFlood","feFuncA","feFuncB","feFuncG","feFuncR","feGaussianBlur","feImage","feMerge","feMergeNode","feMorphology","feOffset","fePointLight","feSpecularLighting","feSpotLight","feTile","feTurbulence"]),svgDisallowed=freeze(["animate","color-profile","cursor","discard","font-face","font-face-format","font-face-name","font-face-src","font-face-uri","foreignobject","hatch","hatchpath","mesh","meshgradient","meshpatch","meshrow","missing-glyph","script","set","solidcolor","unknown","use"]),mathMl$1=freeze(["math","menclose","merror","mfenced","mfrac","mglyph","mi","mlabeledtr","mmultiscripts","mn","mo","mover","mpadded","mphantom","mroot","mrow","ms","mspace","msqrt","mstyle","msub","msup","msubsup","mtable","mtd","mtext","mtr","munder","munderover","mprescripts"]),mathMlDisallowed=freeze(["maction","maligngroup","malignmark","mlongdiv","mscarries","mscarry","msgroup","mstack","msline","msrow","semantics","annotation","annotation-xml","mprescripts","none"]),text$1=freeze(["#text"]),html=freeze(["accept","action","align","alt","autocapitalize","autocomplete","autopictureinpicture","autoplay","background","bgcolor","border","capture","cellpadding","cellspacing","checked","cite","class","clear","color","cols","colspan","controls","controlslist","coords","crossorigin","datetime","decoding","default","dir","disabled","disablepictureinpicture","disableremoteplayback","download","draggable","enctype","enterkeyhint","exportparts","face","for","headers","height","hidden","high","href","hreflang","id","inert","inputmode","integrity","ismap","kind","label","lang","list","loading","loop","low","max","maxlength","media","method","min","minlength","multiple","muted","name","nonce","noshade","novalidate","nowrap","open","optimum","part","pattern","placeholder","playsinline","popover","popovertarget","popovertargetaction","poster","preload","pubdate","radiogroup","readonly","rel","required","rev","reversed","role","rows","rowspan","spellcheck","scope","selected","shape","size","sizes","slot","span","srclang","start","src","srcset","step","style","summary","tabindex","title","translate","type","usemap","valign","value","width","wrap","xmlns","slot"]),svg=freeze(["accent-height","accumulate","additive","alignment-baseline","amplitude","ascent","attributename","attributetype","azimuth","basefrequency","baseline-shift","begin","bias","by","class","clip","clippathunits","clip-path","clip-rule","color","color-interpolation","color-interpolation-filters","color-profile","color-rendering","cx","cy","d","dx","dy","diffuseconstant","direction","display","divisor","dur","edgemode","elevation","end","exponent","fill","fill-opacity","fill-rule","filter","filterunits","flood-color","flood-opacity","font-family","font-size","font-size-adjust","font-stretch","font-style","font-variant","font-weight","fx","fy","g1","g2","glyph-name","glyphref","gradientunits","gradienttransform","height","href","id","image-rendering","in","in2","intercept","k","k1","k2","k3","k4","kerning","keypoints","keysplines","keytimes","lang","lengthadjust","letter-spacing","kernelmatrix","kernelunitlength","lighting-color","local","marker-end","marker-mid","marker-start","markerheight","markerunits","markerwidth","maskcontentunits","maskunits","max","mask","mask-type","media","method","mode","min","name","numoctaves","offset","operator","opacity","order","orient","orientation","origin","overflow","paint-order","path","pathlength","patterncontentunits","patterntransform","patternunits","points","preservealpha","preserveaspectratio","primitiveunits","r","rx","ry","radius","refx","refy","repeatcount","repeatdur","restart","result","rotate","scale","seed","shape-rendering","slope","specularconstant","specularexponent","spreadmethod","startoffset","stddeviation","stitchtiles","stop-color","stop-opacity","stroke-dasharray","stroke-dashoffset","stroke-linecap","stroke-linejoin","stroke-miterlimit","stroke-opacity","stroke","stroke-width","style","surfacescale","systemlanguage","tabindex","tablevalues","targetx","targety","transform","transform-origin","text-anchor","text-decoration","text-rendering","textlength","type","u1","u2","unicode","values","viewbox","visibility","version","vert-adv-y","vert-origin-x","vert-origin-y","width","word-spacing","wrap","writing-mode","xchannelselector","ychannelselector","x","x1","x2","xmlns","y","y1","y2","z","zoomandpan"]),mathMl=freeze(["accent","accentunder","align","bevelled","close","columnsalign","columnlines","columnspan","denomalign","depth","dir","display","displaystyle","encoding","fence","frame","height","href","id","largeop","length","linethickness","lspace","lquote","mathbackground","mathcolor","mathsize","mathvariant","maxsize","minsize","movablelimits","notation","numalign","open","rowalign","rowlines","rowspacing","rowspan","rspace","rquote","scriptlevel","scriptminsize","scriptsizemultiplier","selection","separator","separators","stretchy","subscriptshift","supscriptshift","symmetric","voffset","width","xmlns"]),xml=freeze(["xlink:href","xml:id","xlink:title","xml:space","xmlns:xlink"]),MUSTACHE_EXPR=seal(/\{\{[\w\W]*|[\w\W]*\}\}/gm),ERB_EXPR=seal(/<%[\w\W]*|[\w\W]*%>/gm),TMPLIT_EXPR=seal(/\$\{[\w\W]*/gm),DATA_ATTR=seal(/^data-[\-\w.\u00B7-\uFFFF]+$/),ARIA_ATTR=seal(/^aria-[\-\w]+$/),IS_ALLOWED_URI=seal(/^(?:(?:(?:f|ht)tps?|mailto|tel|callto|sms|cid|xmpp|matrix):|[^a-z]|[a-z+.\-]+(?:[^a-z+.\-:]|$))/i),IS_SCRIPT_OR_DATA=seal(/^(?:\w+script|data):/i),ATTR_WHITESPACE=seal(/[\u0000-\u0020\u00A0\u1680\u180E\u2000-\u2029\u205F\u3000]/g),DOCTYPE_NAME=seal(/^html$/i),CUSTOM_ELEMENT=seal(/^[a-z][.\w]*(-[.\w]+)+$/i);var EXPRESSIONS=Object.freeze({__proto__:null,ARIA_ATTR,ATTR_WHITESPACE,CUSTOM_ELEMENT,DATA_ATTR,DOCTYPE_NAME,ERB_EXPR,IS_ALLOWED_URI,IS_SCRIPT_OR_DATA,MUSTACHE_EXPR,TMPLIT_EXPR});const NODE_TYPE={element:1,text:3,progressingInstruction:7,comment:8,document:9},getGlobal=function rt(){return typeof window>"u"?null:window},_createTrustedTypesPolicy=function rt(it,ct){if(typeof it!="object"||typeof it.createPolicy!="function")return null;let dt=null;const ut="data-tt-policy-suffix";ct&&ct.hasAttribute(ut)&&(dt=ct.getAttribute(ut));const pt="dompurify"+(dt?"#"+dt:"");try{return it.createPolicy(pt,{createHTML(yt){return yt},createScriptURL(yt){return yt}})}catch{return console.warn("TrustedTypes policy "+pt+" could not be created."),null}},_createHooksMap=function rt(){return{afterSanitizeAttributes:[],afterSanitizeElements:[],afterSanitizeShadowDOM:[],beforeSanitizeAttributes:[],beforeSanitizeElements:[],beforeSanitizeShadowDOM:[],uponSanitizeAttribute:[],uponSanitizeElement:[],uponSanitizeShadowNode:[]}};function createDOMPurify(){let rt=arguments.length>0&&arguments[0]!==void 0?arguments[0]:getGlobal();const it=Ta=>createDOMPurify(Ta);if(it.version="3.3.0",it.removed=[],!rt||!rt.document||rt.document.nodeType!==NODE_TYPE.document||!rt.Element)return it.isSupported=!1,it;let{document:ct}=rt;const dt=ct,ut=dt.currentScript,{DocumentFragment:pt,HTMLTemplateElement:yt,Node:ft,Element:mt,NodeFilter:kt,NamedNodeMap:_t=rt.NamedNodeMap||rt.MozNamedAttrMap,HTMLFormElement:vt,DOMParser:bt,trustedTypes:Mt}=rt,wt=mt.prototype,St=lookupGetter(wt,"cloneNode"),It=lookupGetter(wt,"remove"),Nt=lookupGetter(wt,"nextSibling"),$t=lookupGetter(wt,"childNodes"),Et=lookupGetter(wt,"parentNode");if(typeof yt=="function"){const Ta=ct.createElement("template");Ta.content&&Ta.content.ownerDocument&&(ct=Ta.content.ownerDocument)}let Ft,qt="";const{implementation:Ht,createNodeIterator:Ot,createDocumentFragment:Zt,getElementsByTagName:Yt}=ct,{importNode:aa}=dt;let Qt=_createHooksMap();it.isSupported=typeof entries=="function"&&typeof Et=="function"&&Ht&&Ht.createHTMLDocument!==void 0;const{MUSTACHE_EXPR:oa,ERB_EXPR:la,TMPLIT_EXPR:Kt,DATA_ATTR:ra,ARIA_ATTR:Ut,IS_SCRIPT_OR_DATA:ea,ATTR_WHITESPACE:Gt,CUSTOM_ELEMENT:_a}=EXPRESSIONS;let{IS_ALLOWED_URI:Ca}=EXPRESSIONS,Vt=null;const ta=addToSet({},[...html$1,...svg$1,...svgFilters,...mathMl$1,...text$1]);let sa=null;const xa=addToSet({},[...html,...svg,...mathMl,...xml]);let ka=Object.seal(create$1(null,{tagNameCheck:{writable:!0,configurable:!1,enumerable:!0,value:null},attributeNameCheck:{writable:!0,configurable:!1,enumerable:!0,value:null},allowCustomizedBuiltInElements:{writable:!0,configurable:!1,enumerable:!0,value:!1}})),$a=null,Na=null;const Fa=Object.seal(create$1(null,{tagCheck:{writable:!0,configurable:!1,enumerable:!0,value:null},attributeCheck:{writable:!0,configurable:!1,enumerable:!0,value:null}}));let qa=!0,Ha=!0,rn=!1,hn=!0,Ja=!1,kn=!0,En=!1,Hn=!1,Jn=!1,vn=!1,Un=!1,jn=!1,On=!0,Mn=!1;const vi="user-content-";let pn=!0,Tt=!1,fa={},Pt=null;const At=addToSet({},["annotation-xml","audio","colgroup","desc","foreignobject","head","iframe","math","mi","mn","mo","ms","mtext","noembed","noframes","noscript","plaintext","script","style","svg","template","thead","title","video","xmp"]);let Rt=null;const Bt=addToSet({},["audio","video","img","source","image","track"]);let jt=null;const Wt=addToSet({},["alt","class","for","id","label","name","pattern","placeholder","role","summary","title","value","style","xmlns"]),Xt="http://www.w3.org/1998/Math/MathML",da="http://www.w3.org/2000/svg",ma="http://www.w3.org/1999/xhtml";let pa=ma,La=!1,ba=null;const Ra=addToSet({},[Xt,da,ma],stringToString);let ja=addToSet({},["mi","mo","mn","ms","mtext"]),Pa=addToSet({},["annotation-xml"]);const gn=addToSet({},["title","style","font","a","script"]);let ei=null;const jr=["application/xhtml+xml","text/html"],br="text/html";let wn=null,Ai=null;const Io=ct.createElement("form"),Qi=function(na){return na instanceof RegExp||na instanceof Function},Ao=function(){let na=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{};if(!(Ai&&Ai===na)){if((!na||typeof na!="object")&&(na={}),na=clone(na),ei=jr.indexOf(na.PARSER_MEDIA_TYPE)===-1?br:na.PARSER_MEDIA_TYPE,wn=ei==="application/xhtml+xml"?stringToString:stringToLowerCase,Vt=objectHasOwnProperty(na,"ALLOWED_TAGS")?addToSet({},na.ALLOWED_TAGS,wn):ta,sa=objectHasOwnProperty(na,"ALLOWED_ATTR")?addToSet({},na.ALLOWED_ATTR,wn):xa,ba=objectHasOwnProperty(na,"ALLOWED_NAMESPACES")?addToSet({},na.ALLOWED_NAMESPACES,stringToString):Ra,jt=objectHasOwnProperty(na,"ADD_URI_SAFE_ATTR")?addToSet(clone(Wt),na.ADD_URI_SAFE_ATTR,wn):Wt,Rt=objectHasOwnProperty(na,"ADD_DATA_URI_TAGS")?addToSet(clone(Bt),na.ADD_DATA_URI_TAGS,wn):Bt,Pt=objectHasOwnProperty(na,"FORBID_CONTENTS")?addToSet({},na.FORBID_CONTENTS,wn):At,$a=objectHasOwnProperty(na,"FORBID_TAGS")?addToSet({},na.FORBID_TAGS,wn):clone({}),Na=objectHasOwnProperty(na,"FORBID_ATTR")?addToSet({},na.FORBID_ATTR,wn):clone({}),fa=objectHasOwnProperty(na,"USE_PROFILES")?na.USE_PROFILES:!1,qa=na.ALLOW_ARIA_ATTR!==!1,Ha=na.ALLOW_DATA_ATTR!==!1,rn=na.ALLOW_UNKNOWN_PROTOCOLS||!1,hn=na.ALLOW_SELF_CLOSE_IN_ATTR!==!1,Ja=na.SAFE_FOR_TEMPLATES||!1,kn=na.SAFE_FOR_XML!==!1,En=na.WHOLE_DOCUMENT||!1,vn=na.RETURN_DOM||!1,Un=na.RETURN_DOM_FRAGMENT||!1,jn=na.RETURN_TRUSTED_TYPE||!1,Jn=na.FORCE_BODY||!1,On=na.SANITIZE_DOM!==!1,Mn=na.SANITIZE_NAMED_PROPS||!1,pn=na.KEEP_CONTENT!==!1,Tt=na.IN_PLACE||!1,Ca=na.ALLOWED_URI_REGEXP||IS_ALLOWED_URI,pa=na.NAMESPACE||ma,ja=na.MATHML_TEXT_INTEGRATION_POINTS||ja,Pa=na.HTML_INTEGRATION_POINTS||Pa,ka=na.CUSTOM_ELEMENT_HANDLING||{},na.CUSTOM_ELEMENT_HANDLING&&Qi(na.CUSTOM_ELEMENT_HANDLING.tagNameCheck)&&(ka.tagNameCheck=na.CUSTOM_ELEMENT_HANDLING.tagNameCheck),na.CUSTOM_ELEMENT_HANDLING&&Qi(na.CUSTOM_ELEMENT_HANDLING.attributeNameCheck)&&(ka.attributeNameCheck=na.CUSTOM_ELEMENT_HANDLING.attributeNameCheck),na.CUSTOM_ELEMENT_HANDLING&&typeof na.CUSTOM_ELEMENT_HANDLING.allowCustomizedBuiltInElements=="boolean"&&(ka.allowCustomizedBuiltInElements=na.CUSTOM_ELEMENT_HANDLING.allowCustomizedBuiltInElements),Ja&&(Ha=!1),Un&&(vn=!0),fa&&(Vt=addToSet({},text$1),sa=[],fa.html===!0&&(addToSet(Vt,html$1),addToSet(sa,html)),fa.svg===!0&&(addToSet(Vt,svg$1),addToSet(sa,svg),addToSet(sa,xml)),fa.svgFilters===!0&&(addToSet(Vt,svgFilters),addToSet(sa,svg),addToSet(sa,xml)),fa.mathMl===!0&&(addToSet(Vt,mathMl$1),addToSet(sa,mathMl),addToSet(sa,xml))),na.ADD_TAGS&&(typeof na.ADD_TAGS=="function"?Fa.tagCheck=na.ADD_TAGS:(Vt===ta&&(Vt=clone(Vt)),addToSet(Vt,na.ADD_TAGS,wn))),na.ADD_ATTR&&(typeof na.ADD_ATTR=="function"?Fa.attributeCheck=na.ADD_ATTR:(sa===xa&&(sa=clone(sa)),addToSet(sa,na.ADD_ATTR,wn))),na.ADD_URI_SAFE_ATTR&&addToSet(jt,na.ADD_URI_SAFE_ATTR,wn),na.FORBID_CONTENTS&&(Pt===At&&(Pt=clone(Pt)),addToSet(Pt,na.FORBID_CONTENTS,wn)),pn&&(Vt["#text"]=!0),En&&addToSet(Vt,["html","head","body"]),Vt.table&&(addToSet(Vt,["tbody"]),delete $a.tbody),na.TRUSTED_TYPES_POLICY){if(typeof na.TRUSTED_TYPES_POLICY.createHTML!="function")throw typeErrorCreate('TRUSTED_TYPES_POLICY configuration option must provide a "createHTML" hook.');if(typeof na.TRUSTED_TYPES_POLICY.createScriptURL!="function")throw typeErrorCreate('TRUSTED_TYPES_POLICY configuration option must provide a "createScriptURL" hook.');Ft=na.TRUSTED_TYPES_POLICY,qt=Ft.createHTML("")}else Ft===void 0&&(Ft=_createTrustedTypesPolicy(Mt,ut)),Ft!==null&&typeof qt=="string"&&(qt=Ft.createHTML(""));freeze&&freeze(na),Ai=na}},To=addToSet({},[...svg$1,...svgFilters,...svgDisallowed]),Eo=addToSet({},[...mathMl$1,...mathMlDisallowed]),wc=function(na){let Sa=Et(na);(!Sa||!Sa.tagName)&&(Sa={namespaceURI:pa,tagName:"template"});const Ia=stringToLowerCase(na.tagName),tn=stringToLowerCase(Sa.tagName);return ba[na.namespaceURI]?na.namespaceURI===da?Sa.namespaceURI===ma?Ia==="svg":Sa.namespaceURI===Xt?Ia==="svg"&&(tn==="annotation-xml"||ja[tn]):!!To[Ia]:na.namespaceURI===Xt?Sa.namespaceURI===ma?Ia==="math":Sa.namespaceURI===da?Ia==="math"&&Pa[tn]:!!Eo[Ia]:na.namespaceURI===ma?Sa.namespaceURI===da&&!Pa[tn]||Sa.namespaceURI===Xt&&!ja[tn]?!1:!Eo[Ia]&&(gn[Ia]||!To[Ia]):!!(ei==="application/xhtml+xml"&&ba[na.namespaceURI]):!1},Vn=function(na){arrayPush(it.removed,{element:na});try{Et(na).removeChild(na)}catch{It(na)}},bi=function(na,Sa){try{arrayPush(it.removed,{attribute:Sa.getAttributeNode(na),from:Sa})}catch{arrayPush(it.removed,{attribute:null,from:Sa})}if(Sa.removeAttribute(na),na==="is")if(vn||Un)try{Vn(Sa)}catch{}else try{Sa.setAttribute(na,"")}catch{}},Ro=function(na){let Sa=null,Ia=null;if(Jn)na="<remove></remove>"+na;else{const Ua=stringMatch(na,/^[\r\n\t ]+/);Ia=Ua&&Ua[0]}ei==="application/xhtml+xml"&&pa===ma&&(na='<html xmlns="http://www.w3.org/1999/xhtml"><head></head><body>'+na+"</body></html>");const tn=Ft?Ft.createHTML(na):na;if(pa===ma)try{Sa=new bt().parseFromString(tn,ei)}catch{}if(!Sa||!Sa.documentElement){Sa=Ht.createDocument(pa,"template",null);try{Sa.documentElement.innerHTML=La?qt:tn}catch{}}const mn=Sa.body||Sa.documentElement;return na&&Ia&&mn.insertBefore(ct.createTextNode(Ia),mn.childNodes[0]||null),pa===ma?Yt.call(Sa,En?"html":"body")[0]:En?Sa.documentElement:mn},Bo=function(na){return Ot.call(na.ownerDocument||na,na,kt.SHOW_ELEMENT|kt.SHOW_COMMENT|kt.SHOW_TEXT|kt.SHOW_PROCESSING_INSTRUCTION|kt.SHOW_CDATA_SECTION,null)},si=function(na){return na instanceof vt&&(typeof na.nodeName!="string"||typeof na.textContent!="string"||typeof na.removeChild!="function"||!(na.attributes instanceof _t)||typeof na.removeAttribute!="function"||typeof na.setAttribute!="function"||typeof na.namespaceURI!="string"||typeof na.insertBefore!="function"||typeof na.hasChildNodes!="function")},Ln=function(na){return typeof ft=="function"&&na instanceof ft};function fn(Ta,na,Sa){arrayForEach(Ta,Ia=>{Ia.call(it,na,Sa,Ai)})}const Ti=function(na){let Sa=null;if(fn(Qt.beforeSanitizeElements,na,null),si(na))return Vn(na),!0;const Ia=wn(na.nodeName);if(fn(Qt.uponSanitizeElement,na,{tagName:Ia,allowedTags:Vt}),kn&&na.hasChildNodes()&&!Ln(na.firstElementChild)&&regExpTest(/<[/\w!]/g,na.innerHTML)&&regExpTest(/<[/\w!]/g,na.textContent)||na.nodeType===NODE_TYPE.progressingInstruction||kn&&na.nodeType===NODE_TYPE.comment&&regExpTest(/<[/\w]/g,na.data))return Vn(na),!0;if(!(Fa.tagCheck instanceof Function&&Fa.tagCheck(Ia))&&(!Vt[Ia]||$a[Ia])){if(!$a[Ia]&&Lc(Ia)&&(ka.tagNameCheck instanceof RegExp&&regExpTest(ka.tagNameCheck,Ia)||ka.tagNameCheck instanceof Function&&ka.tagNameCheck(Ia)))return!1;if(pn&&!Pt[Ia]){const tn=Et(na)||na.parentNode,mn=$t(na)||na.childNodes;if(mn&&tn){const Ua=mn.length;for(let Bn=Ua-1;Bn>=0;--Bn){const li=St(mn[Bn],!0);li.__removalCount=(na.__removalCount||0)+1,tn.insertBefore(li,Nt(na))}}}return Vn(na),!0}return na instanceof mt&&!wc(na)||(Ia==="noscript"||Ia==="noembed"||Ia==="noframes")&&regExpTest(/<\/no(script|embed|frames)/i,na.innerHTML)?(Vn(na),!0):(Ja&&na.nodeType===NODE_TYPE.text&&(Sa=na.textContent,arrayForEach([oa,la,Kt],tn=>{Sa=stringReplace(Sa,tn," ")}),na.textContent!==Sa&&(arrayPush(it.removed,{element:na.cloneNode()}),na.textContent=Sa)),fn(Qt.afterSanitizeElements,na,null),!1)},Or=function(na,Sa,Ia){if(On&&(Sa==="id"||Sa==="name")&&(Ia in ct||Ia in Io))return!1;if(!(Ha&&!Na[Sa]&&regExpTest(ra,Sa))){if(!(qa&&regExpTest(Ut,Sa))){if(!(Fa.attributeCheck instanceof Function&&Fa.attributeCheck(Sa,na))){if(!sa[Sa]||Na[Sa]){if(!(Lc(na)&&(ka.tagNameCheck instanceof RegExp&&regExpTest(ka.tagNameCheck,na)||ka.tagNameCheck instanceof Function&&ka.tagNameCheck(na))&&(ka.attributeNameCheck instanceof RegExp&&regExpTest(ka.attributeNameCheck,Sa)||ka.attributeNameCheck instanceof Function&&ka.attributeNameCheck(Sa,na))||Sa==="is"&&ka.allowCustomizedBuiltInElements&&(ka.tagNameCheck instanceof RegExp&&regExpTest(ka.tagNameCheck,Ia)||ka.tagNameCheck instanceof Function&&ka.tagNameCheck(Ia))))return!1}else if(!jt[Sa]){if(!regExpTest(Ca,stringReplace(Ia,Gt,""))){if(!((Sa==="src"||Sa==="xlink:href"||Sa==="href")&&na!=="script"&&stringIndexOf(Ia,"data:")===0&&Rt[na])){if(!(rn&&!regExpTest(ea,stringReplace(Ia,Gt,"")))){if(Ia)return!1}}}}}}}return!0},Lc=function(na){return na!=="annotation-xml"&&stringMatch(na,_a)},Sc=function(na){fn(Qt.beforeSanitizeAttributes,na,null);const{attributes:Sa}=na;if(!Sa||si(na))return;const Ia={attrName:"",attrValue:"",keepAttr:!0,allowedAttributes:sa,forceKeepAttr:void 0};let tn=Sa.length;for(;tn--;){const mn=Sa[tn],{name:Ua,namespaceURI:Bn,value:li}=mn,Gn=wn(Ua),Li=li;let An=Ua==="value"?Li:stringTrim(Li);if(Ia.attrName=Gn,Ia.attrValue=An,Ia.keepAttr=!0,Ia.forceKeepAttr=void 0,fn(Qt.uponSanitizeAttribute,na,Ia),An=Ia.attrValue,Mn&&(Gn==="id"||Gn==="name")&&(bi(Ua,na),An=vi+An),kn&&regExpTest(/((--!?|])>)|<\/(style|title|textarea)/i,An)){bi(Ua,na);continue}if(Gn==="attributename"&&stringMatch(An,"href")){bi(Ua,na);continue}if(Ia.forceKeepAttr)continue;if(!Ia.keepAttr){bi(Ua,na);continue}if(!hn&&regExpTest(/\/>/i,An)){bi(Ua,na);continue}Ja&&arrayForEach([oa,la,Kt],Po=>{An=stringReplace(An,Po," ")});const Do=wn(na.nodeName);if(!Or(Do,Gn,An)){bi(Ua,na);continue}if(Ft&&typeof Mt=="object"&&typeof Mt.getAttributeType=="function"&&!Bn)switch(Mt.getAttributeType(Do,Gn)){case"TrustedHTML":{An=Ft.createHTML(An);break}case"TrustedScriptURL":{An=Ft.createScriptURL(An);break}}if(An!==Li)try{Bn?na.setAttributeNS(Bn,Ua,An):na.setAttribute(Ua,An),si(na)?Vn(na):arrayPop(it.removed)}catch{bi(Ua,na)}}fn(Qt.afterSanitizeAttributes,na,null)},$c=function Ta(na){let Sa=null;const Ia=Bo(na);for(fn(Qt.beforeSanitizeShadowDOM,na,null);Sa=Ia.nextNode();)fn(Qt.uponSanitizeShadowNode,Sa,null),Ti(Sa),Sc(Sa),Sa.content instanceof pt&&Ta(Sa.content);fn(Qt.afterSanitizeShadowDOM,na,null)};return it.sanitize=function(Ta){let na=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{},Sa=null,Ia=null,tn=null,mn=null;if(La=!Ta,La&&(Ta="<!-->"),typeof Ta!="string"&&!Ln(Ta))if(typeof Ta.toString=="function"){if(Ta=Ta.toString(),typeof Ta!="string")throw typeErrorCreate("dirty is not a string, aborting")}else throw typeErrorCreate("toString is not a function");if(!it.isSupported)return Ta;if(Hn||Ao(na),it.removed=[],typeof Ta=="string"&&(Tt=!1),Tt){if(Ta.nodeName){const li=wn(Ta.nodeName);if(!Vt[li]||$a[li])throw typeErrorCreate("root node is forbidden and cannot be sanitized in-place")}}else if(Ta instanceof ft)Sa=Ro("<!---->"),Ia=Sa.ownerDocument.importNode(Ta,!0),Ia.nodeType===NODE_TYPE.element&&Ia.nodeName==="BODY"||Ia.nodeName==="HTML"?Sa=Ia:Sa.appendChild(Ia);else{if(!vn&&!Ja&&!En&&Ta.indexOf("<")===-1)return Ft&&jn?Ft.createHTML(Ta):Ta;if(Sa=Ro(Ta),!Sa)return vn?null:jn?qt:""}Sa&&Jn&&Vn(Sa.firstChild);const Ua=Bo(Tt?Ta:Sa);for(;tn=Ua.nextNode();)Ti(tn),Sc(tn),tn.content instanceof pt&&$c(tn.content);if(Tt)return Ta;if(vn){if(Un)for(mn=Zt.call(Sa.ownerDocument);Sa.firstChild;)mn.appendChild(Sa.firstChild);else mn=Sa;return(sa.shadowroot||sa.shadowrootmode)&&(mn=aa.call(dt,mn,!0)),mn}let Bn=En?Sa.outerHTML:Sa.innerHTML;return En&&Vt["!doctype"]&&Sa.ownerDocument&&Sa.ownerDocument.doctype&&Sa.ownerDocument.doctype.name&&regExpTest(DOCTYPE_NAME,Sa.ownerDocument.doctype.name)&&(Bn="<!DOCTYPE "+Sa.ownerDocument.doctype.name+`>
-`+Bn),Ja&&arrayForEach([oa,la,Kt],li=>{Bn=stringReplace(Bn,li," ")}),Ft&&jn?Ft.createHTML(Bn):Bn},it.setConfig=function(){let Ta=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{};Ao(Ta),Hn=!0},it.clearConfig=function(){Ai=null,Hn=!1},it.isValidAttribute=function(Ta,na,Sa){Ai||Ao({});const Ia=wn(Ta),tn=wn(na);return Or(Ia,tn,Sa)},it.addHook=function(Ta,na){typeof na=="function"&&arrayPush(Qt[Ta],na)},it.removeHook=function(Ta,na){if(na!==void 0){const Sa=arrayLastIndexOf(Qt[Ta],na);return Sa===-1?void 0:arraySplice(Qt[Ta],Sa,1)[0]}return arrayPop(Qt[Ta])},it.removeHooks=function(Ta){Qt[Ta]=[]},it.removeAllHooks=function(){Qt=_createHooksMap()},it}var purify=createDOMPurify(),frontMatterRegex=/^-{3}\s*[\n\r](.*?)[\n\r]-{3}\s*[\n\r]+/s,directiveRegex=/%{2}{\s*(?:(\w+)\s*:|(\w+))\s*(?:(\w+)|((?:(?!}%{2}).|\r?\n)*))?\s*(?:}%{2})?/gi,anyCommentRegex=/\s*%%.*\n/gm,bo,UnknownDiagramError=(bo=class extends Error{constructor(it){super(it),this.name="UnknownDiagramError"}},__name(bo,"UnknownDiagramError"),bo),detectors={},detectType$1=__name(function(rt,it){rt=rt.replace(frontMatterRegex,"").replace(directiveRegex,"").replace(anyCommentRegex,`
-`);for(const[ct,{detector:dt}]of Object.entries(detectors))if(dt(rt,it))return ct;throw new UnknownDiagramError(`No diagram type detected matching given configuration for text: ${rt}`)},"detectType"),registerLazyLoadedDiagrams=__name((...rt)=>{for(const{id:it,detector:ct,loader:dt}of rt)addDetector(it,ct,dt)},"registerLazyLoadedDiagrams"),addDetector=__name((rt,it,ct)=>{detectors[rt]&&log.warn(`Detector with key ${rt} already exists. Overwriting.`),detectors[rt]={detector:it,loader:ct},log.debug(`Detector with key ${rt} added${ct?" with loader":""}`)},"addDetector"),getDiagramLoader=__name(rt=>detectors[rt].loader,"getDiagramLoader"),assignWithDepth=__name((rt,it,{depth:ct=2,clobber:dt=!1}={})=>{const ut={depth:ct,clobber:dt};return Array.isArray(it)&&!Array.isArray(rt)?(it.forEach(pt=>assignWithDepth(rt,pt,ut)),rt):Array.isArray(it)&&Array.isArray(rt)?(it.forEach(pt=>{rt.includes(pt)||rt.push(pt)}),rt):rt===void 0||ct<=0?rt!=null&&typeof rt=="object"&&typeof it=="object"?Object.assign(rt,it):it:(it!==void 0&&typeof rt=="object"&&typeof it=="object"&&Object.keys(it).forEach(pt=>{typeof it[pt]=="object"&&(rt[pt]===void 0||typeof rt[pt]=="object")?(rt[pt]===void 0&&(rt[pt]=Array.isArray(it[pt])?[]:{}),rt[pt]=assignWithDepth(rt[pt],it[pt],{depth:ct-1,clobber:dt})):(dt||typeof rt[pt]!="object"&&typeof it[pt]!="object")&&(rt[pt]=it[pt])}),rt)},"assignWithDepth"),assignWithDepth_default=assignWithDepth,oldAttributeBackgroundColorOdd="#ffffff",oldAttributeBackgroundColorEven="#f2f2f2",mkBorder=__name((rt,it)=>it?adjust(rt,{s:-40,l:10}):adjust(rt,{s:-40,l:-10}),"mkBorder"),Co,Theme=(Co=class{constructor(){this.background="#f4f4f4",this.primaryColor="#fff4dd",this.noteBkgColor="#fff5ad",this.noteTextColor="#333",this.THEME_COLOR_LIMIT=12,this.fontFamily='"trebuchet ms", verdana, arial, sans-serif',this.fontSize="16px"}updateColors(){if(this.primaryTextColor=this.primaryTextColor||(this.darkMode?"#eee":"#333"),this.secondaryColor=this.secondaryColor||adjust(this.primaryColor,{h:-120}),this.tertiaryColor=this.tertiaryColor||adjust(this.primaryColor,{h:180,l:5}),this.primaryBorderColor=this.primaryBorderColor||mkBorder(this.primaryColor,this.darkMode),this.secondaryBorderColor=this.secondaryBorderColor||mkBorder(this.secondaryColor,this.darkMode),this.tertiaryBorderColor=this.tertiaryBorderColor||mkBorder(this.tertiaryColor,this.darkMode),this.noteBorderColor=this.noteBorderColor||mkBorder(this.noteBkgColor,this.darkMode),this.noteBkgColor=this.noteBkgColor||"#fff5ad",this.noteTextColor=this.noteTextColor||"#333",this.secondaryTextColor=this.secondaryTextColor||invert(this.secondaryColor),this.tertiaryTextColor=this.tertiaryTextColor||invert(this.tertiaryColor),this.lineColor=this.lineColor||invert(this.background),this.arrowheadColor=this.arrowheadColor||invert(this.background),this.textColor=this.textColor||this.primaryTextColor,this.border2=this.border2||this.tertiaryBorderColor,this.nodeBkg=this.nodeBkg||this.primaryColor,this.mainBkg=this.mainBkg||this.primaryColor,this.nodeBorder=this.nodeBorder||this.primaryBorderColor,this.clusterBkg=this.clusterBkg||this.tertiaryColor,this.clusterBorder=this.clusterBorder||this.tertiaryBorderColor,this.defaultLinkColor=this.defaultLinkColor||this.lineColor,this.titleColor=this.titleColor||this.tertiaryTextColor,this.edgeLabelBackground=this.edgeLabelBackground||(this.darkMode?darken(this.secondaryColor,30):this.secondaryColor),this.nodeTextColor=this.nodeTextColor||this.primaryTextColor,this.actorBorder=this.actorBorder||this.primaryBorderColor,this.actorBkg=this.actorBkg||this.mainBkg,this.actorTextColor=this.actorTextColor||this.primaryTextColor,this.actorLineColor=this.actorLineColor||this.actorBorder,this.labelBoxBkgColor=this.labelBoxBkgColor||this.actorBkg,this.signalColor=this.signalColor||this.textColor,this.signalTextColor=this.signalTextColor||this.textColor,this.labelBoxBorderColor=this.labelBoxBorderColor||this.actorBorder,this.labelTextColor=this.labelTextColor||this.actorTextColor,this.loopTextColor=this.loopTextColor||this.actorTextColor,this.activationBorderColor=this.activationBorderColor||darken(this.secondaryColor,10),this.activationBkgColor=this.activationBkgColor||this.secondaryColor,this.sequenceNumberColor=this.sequenceNumberColor||invert(this.lineColor),this.sectionBkgColor=this.sectionBkgColor||this.tertiaryColor,this.altSectionBkgColor=this.altSectionBkgColor||"white",this.sectionBkgColor=this.sectionBkgColor||this.secondaryColor,this.sectionBkgColor2=this.sectionBkgColor2||this.primaryColor,this.excludeBkgColor=this.excludeBkgColor||"#eeeeee",this.taskBorderColor=this.taskBorderColor||this.primaryBorderColor,this.taskBkgColor=this.taskBkgColor||this.primaryColor,this.activeTaskBorderColor=this.activeTaskBorderColor||this.primaryColor,this.activeTaskBkgColor=this.activeTaskBkgColor||lighten(this.primaryColor,23),this.gridColor=this.gridColor||"lightgrey",this.doneTaskBkgColor=this.doneTaskBkgColor||"lightgrey",this.doneTaskBorderColor=this.doneTaskBorderColor||"grey",this.critBorderColor=this.critBorderColor||"#ff8888",this.critBkgColor=this.critBkgColor||"red",this.todayLineColor=this.todayLineColor||"red",this.vertLineColor=this.vertLineColor||"navy",this.taskTextColor=this.taskTextColor||this.textColor,this.taskTextOutsideColor=this.taskTextOutsideColor||this.textColor,this.taskTextLightColor=this.taskTextLightColor||this.textColor,this.taskTextColor=this.taskTextColor||this.primaryTextColor,this.taskTextDarkColor=this.taskTextDarkColor||this.textColor,this.taskTextClickableColor=this.taskTextClickableColor||"#003163",this.personBorder=this.personBorder||this.primaryBorderColor,this.personBkg=this.personBkg||this.mainBkg,this.darkMode?(this.rowOdd=this.rowOdd||darken(this.mainBkg,5)||"#ffffff",this.rowEven=this.rowEven||darken(this.mainBkg,10)):(this.rowOdd=this.rowOdd||lighten(this.mainBkg,75)||"#ffffff",this.rowEven=this.rowEven||lighten(this.mainBkg,5)),this.transitionColor=this.transitionColor||this.lineColor,this.transitionLabelColor=this.transitionLabelColor||this.textColor,this.stateLabelColor=this.stateLabelColor||this.stateBkg||this.primaryTextColor,this.stateBkg=this.stateBkg||this.mainBkg,this.labelBackgroundColor=this.labelBackgroundColor||this.stateBkg,this.compositeBackground=this.compositeBackground||this.background||this.tertiaryColor,this.altBackground=this.altBackground||this.tertiaryColor,this.compositeTitleBackground=this.compositeTitleBackground||this.mainBkg,this.compositeBorder=this.compositeBorder||this.nodeBorder,this.innerEndBackground=this.nodeBorder,this.errorBkgColor=this.errorBkgColor||this.tertiaryColor,this.errorTextColor=this.errorTextColor||this.tertiaryTextColor,this.transitionColor=this.transitionColor||this.lineColor,this.specialStateColor=this.lineColor,this.cScale0=this.cScale0||this.primaryColor,this.cScale1=this.cScale1||this.secondaryColor,this.cScale2=this.cScale2||this.tertiaryColor,this.cScale3=this.cScale3||adjust(this.primaryColor,{h:30}),this.cScale4=this.cScale4||adjust(this.primaryColor,{h:60}),this.cScale5=this.cScale5||adjust(this.primaryColor,{h:90}),this.cScale6=this.cScale6||adjust(this.primaryColor,{h:120}),this.cScale7=this.cScale7||adjust(this.primaryColor,{h:150}),this.cScale8=this.cScale8||adjust(this.primaryColor,{h:210,l:150}),this.cScale9=this.cScale9||adjust(this.primaryColor,{h:270}),this.cScale10=this.cScale10||adjust(this.primaryColor,{h:300}),this.cScale11=this.cScale11||adjust(this.primaryColor,{h:330}),this.darkMode)for(let ct=0;ct<this.THEME_COLOR_LIMIT;ct++)this["cScale"+ct]=darken(this["cScale"+ct],75);else for(let ct=0;ct<this.THEME_COLOR_LIMIT;ct++)this["cScale"+ct]=darken(this["cScale"+ct],25);for(let ct=0;ct<this.THEME_COLOR_LIMIT;ct++)this["cScaleInv"+ct]=this["cScaleInv"+ct]||invert(this["cScale"+ct]);for(let ct=0;ct<this.THEME_COLOR_LIMIT;ct++)this.darkMode?this["cScalePeer"+ct]=this["cScalePeer"+ct]||lighten(this["cScale"+ct],10):this["cScalePeer"+ct]=this["cScalePeer"+ct]||darken(this["cScale"+ct],10);this.scaleLabelColor=this.scaleLabelColor||this.labelTextColor;for(let ct=0;ct<this.THEME_COLOR_LIMIT;ct++)this["cScaleLabel"+ct]=this["cScaleLabel"+ct]||this.scaleLabelColor;const it=this.darkMode?-4:-1;for(let ct=0;ct<5;ct++)this["surface"+ct]=this["surface"+ct]||adjust(this.mainBkg,{h:180,s:-15,l:it*(5+ct*3)}),this["surfacePeer"+ct]=this["surfacePeer"+ct]||adjust(this.mainBkg,{h:180,s:-15,l:it*(8+ct*3)});this.classText=this.classText||this.textColor,this.fillType0=this.fillType0||this.primaryColor,this.fillType1=this.fillType1||this.secondaryColor,this.fillType2=this.fillType2||adjust(this.primaryColor,{h:64}),this.fillType3=this.fillType3||adjust(this.secondaryColor,{h:64}),this.fillType4=this.fillType4||adjust(this.primaryColor,{h:-64}),this.fillType5=this.fillType5||adjust(this.secondaryColor,{h:-64}),this.fillType6=this.fillType6||adjust(this.primaryColor,{h:128}),this.fillType7=this.fillType7||adjust(this.secondaryColor,{h:128}),this.pie1=this.pie1||this.primaryColor,this.pie2=this.pie2||this.secondaryColor,this.pie3=this.pie3||this.tertiaryColor,this.pie4=this.pie4||adjust(this.primaryColor,{l:-10}),this.pie5=this.pie5||adjust(this.secondaryColor,{l:-10}),this.pie6=this.pie6||adjust(this.tertiaryColor,{l:-10}),this.pie7=this.pie7||adjust(this.primaryColor,{h:60,l:-10}),this.pie8=this.pie8||adjust(this.primaryColor,{h:-60,l:-10}),this.pie9=this.pie9||adjust(this.primaryColor,{h:120,l:0}),this.pie10=this.pie10||adjust(this.primaryColor,{h:60,l:-20}),this.pie11=this.pie11||adjust(this.primaryColor,{h:-60,l:-20}),this.pie12=this.pie12||adjust(this.primaryColor,{h:120,l:-10}),this.pieTitleTextSize=this.pieTitleTextSize||"25px",this.pieTitleTextColor=this.pieTitleTextColor||this.taskTextDarkColor,this.pieSectionTextSize=this.pieSectionTextSize||"17px",this.pieSectionTextColor=this.pieSectionTextColor||this.textColor,this.pieLegendTextSize=this.pieLegendTextSize||"17px",this.pieLegendTextColor=this.pieLegendTextColor||this.taskTextDarkColor,this.pieStrokeColor=this.pieStrokeColor||"black",this.pieStrokeWidth=this.pieStrokeWidth||"2px",this.pieOuterStrokeWidth=this.pieOuterStrokeWidth||"2px",this.pieOuterStrokeColor=this.pieOuterStrokeColor||"black",this.pieOpacity=this.pieOpacity||"0.7",this.radar={axisColor:this.radar?.axisColor||this.lineColor,axisStrokeWidth:this.radar?.axisStrokeWidth||2,axisLabelFontSize:this.radar?.axisLabelFontSize||12,curveOpacity:this.radar?.curveOpacity||.5,curveStrokeWidth:this.radar?.curveStrokeWidth||2,graticuleColor:this.radar?.graticuleColor||"#DEDEDE",graticuleStrokeWidth:this.radar?.graticuleStrokeWidth||1,graticuleOpacity:this.radar?.graticuleOpacity||.3,legendBoxSize:this.radar?.legendBoxSize||12,legendFontSize:this.radar?.legendFontSize||12},this.archEdgeColor=this.archEdgeColor||"#777",this.archEdgeArrowColor=this.archEdgeArrowColor||"#777",this.archEdgeWidth=this.archEdgeWidth||"3",this.archGroupBorderColor=this.archGroupBorderColor||"#000",this.archGroupBorderWidth=this.archGroupBorderWidth||"2px",this.quadrant1Fill=this.quadrant1Fill||this.primaryColor,this.quadrant2Fill=this.quadrant2Fill||adjust(this.primaryColor,{r:5,g:5,b:5}),this.quadrant3Fill=this.quadrant3Fill||adjust(this.primaryColor,{r:10,g:10,b:10}),this.quadrant4Fill=this.quadrant4Fill||adjust(this.primaryColor,{r:15,g:15,b:15}),this.quadrant1TextFill=this.quadrant1TextFill||this.primaryTextColor,this.quadrant2TextFill=this.quadrant2TextFill||adjust(this.primaryTextColor,{r:-5,g:-5,b:-5}),this.quadrant3TextFill=this.quadrant3TextFill||adjust(this.primaryTextColor,{r:-10,g:-10,b:-10}),this.quadrant4TextFill=this.quadrant4TextFill||adjust(this.primaryTextColor,{r:-15,g:-15,b:-15}),this.quadrantPointFill=this.quadrantPointFill||isDark(this.quadrant1Fill)?lighten(this.quadrant1Fill):darken(this.quadrant1Fill),this.quadrantPointTextFill=this.quadrantPointTextFill||this.primaryTextColor,this.quadrantXAxisTextFill=this.quadrantXAxisTextFill||this.primaryTextColor,this.quadrantYAxisTextFill=this.quadrantYAxisTextFill||this.primaryTextColor,this.quadrantInternalBorderStrokeFill=this.quadrantInternalBorderStrokeFill||this.primaryBorderColor,this.quadrantExternalBorderStrokeFill=this.quadrantExternalBorderStrokeFill||this.primaryBorderColor,this.quadrantTitleFill=this.quadrantTitleFill||this.primaryTextColor,this.xyChart={backgroundColor:this.xyChart?.backgroundColor||this.background,titleColor:this.xyChart?.titleColor||this.primaryTextColor,xAxisTitleColor:this.xyChart?.xAxisTitleColor||this.primaryTextColor,xAxisLabelColor:this.xyChart?.xAxisLabelColor||this.primaryTextColor,xAxisTickColor:this.xyChart?.xAxisTickColor||this.primaryTextColor,xAxisLineColor:this.xyChart?.xAxisLineColor||this.primaryTextColor,yAxisTitleColor:this.xyChart?.yAxisTitleColor||this.primaryTextColor,yAxisLabelColor:this.xyChart?.yAxisLabelColor||this.primaryTextColor,yAxisTickColor:this.xyChart?.yAxisTickColor||this.primaryTextColor,yAxisLineColor:this.xyChart?.yAxisLineColor||this.primaryTextColor,plotColorPalette:this.xyChart?.plotColorPalette||"#FFF4DD,#FFD8B1,#FFA07A,#ECEFF1,#D6DBDF,#C3E0A8,#FFB6A4,#FFD74D,#738FA7,#FFFFF0"},this.requirementBackground=this.requirementBackground||this.primaryColor,this.requirementBorderColor=this.requirementBorderColor||this.primaryBorderColor,this.requirementBorderSize=this.requirementBorderSize||"1",this.requirementTextColor=this.requirementTextColor||this.primaryTextColor,this.relationColor=this.relationColor||this.lineColor,this.relationLabelBackground=this.relationLabelBackground||(this.darkMode?darken(this.secondaryColor,30):this.secondaryColor),this.relationLabelColor=this.relationLabelColor||this.actorTextColor,this.git0=this.git0||this.primaryColor,this.git1=this.git1||this.secondaryColor,this.git2=this.git2||this.tertiaryColor,this.git3=this.git3||adjust(this.primaryColor,{h:-30}),this.git4=this.git4||adjust(this.primaryColor,{h:-60}),this.git5=this.git5||adjust(this.primaryColor,{h:-90}),this.git6=this.git6||adjust(this.primaryColor,{h:60}),this.git7=this.git7||adjust(this.primaryColor,{h:120}),this.darkMode?(this.git0=lighten(this.git0,25),this.git1=lighten(this.git1,25),this.git2=lighten(this.git2,25),this.git3=lighten(this.git3,25),this.git4=lighten(this.git4,25),this.git5=lighten(this.git5,25),this.git6=lighten(this.git6,25),this.git7=lighten(this.git7,25)):(this.git0=darken(this.git0,25),this.git1=darken(this.git1,25),this.git2=darken(this.git2,25),this.git3=darken(this.git3,25),this.git4=darken(this.git4,25),this.git5=darken(this.git5,25),this.git6=darken(this.git6,25),this.git7=darken(this.git7,25)),this.gitInv0=this.gitInv0||invert(this.git0),this.gitInv1=this.gitInv1||invert(this.git1),this.gitInv2=this.gitInv2||invert(this.git2),this.gitInv3=this.gitInv3||invert(this.git3),this.gitInv4=this.gitInv4||invert(this.git4),this.gitInv5=this.gitInv5||invert(this.git5),this.gitInv6=this.gitInv6||invert(this.git6),this.gitInv7=this.gitInv7||invert(this.git7),this.branchLabelColor=this.branchLabelColor||(this.darkMode?"black":this.labelTextColor),this.gitBranchLabel0=this.gitBranchLabel0||this.branchLabelColor,this.gitBranchLabel1=this.gitBranchLabel1||this.branchLabelColor,this.gitBranchLabel2=this.gitBranchLabel2||this.branchLabelColor,this.gitBranchLabel3=this.gitBranchLabel3||this.branchLabelColor,this.gitBranchLabel4=this.gitBranchLabel4||this.branchLabelColor,this.gitBranchLabel5=this.gitBranchLabel5||this.branchLabelColor,this.gitBranchLabel6=this.gitBranchLabel6||this.branchLabelColor,this.gitBranchLabel7=this.gitBranchLabel7||this.branchLabelColor,this.tagLabelColor=this.tagLabelColor||this.primaryTextColor,this.tagLabelBackground=this.tagLabelBackground||this.primaryColor,this.tagLabelBorder=this.tagBorder||this.primaryBorderColor,this.tagLabelFontSize=this.tagLabelFontSize||"10px",this.commitLabelColor=this.commitLabelColor||this.secondaryTextColor,this.commitLabelBackground=this.commitLabelBackground||this.secondaryColor,this.commitLabelFontSize=this.commitLabelFontSize||"10px",this.attributeBackgroundColorOdd=this.attributeBackgroundColorOdd||oldAttributeBackgroundColorOdd,this.attributeBackgroundColorEven=this.attributeBackgroundColorEven||oldAttributeBackgroundColorEven}calculate(it){if(typeof it!="object"){this.updateColors();return}const ct=Object.keys(it);ct.forEach(dt=>{this[dt]=it[dt]}),this.updateColors(),ct.forEach(dt=>{this[dt]=it[dt]})}},__name(Co,"Theme"),Co),getThemeVariables=__name(rt=>{const it=new Theme;return it.calculate(rt),it},"getThemeVariables"),Mo,Theme2=(Mo=class{constructor(){this.background="#333",this.primaryColor="#1f2020",this.secondaryColor=lighten(this.primaryColor,16),this.tertiaryColor=adjust(this.primaryColor,{h:-160}),this.primaryBorderColor=invert(this.background),this.secondaryBorderColor=mkBorder(this.secondaryColor,this.darkMode),this.tertiaryBorderColor=mkBorder(this.tertiaryColor,this.darkMode),this.primaryTextColor=invert(this.primaryColor),this.secondaryTextColor=invert(this.secondaryColor),this.tertiaryTextColor=invert(this.tertiaryColor),this.lineColor=invert(this.background),this.textColor=invert(this.background),this.mainBkg="#1f2020",this.secondBkg="calculated",this.mainContrastColor="lightgrey",this.darkTextColor=lighten(invert("#323D47"),10),this.lineColor="calculated",this.border1="#ccc",this.border2=rgba$1(255,255,255,.25),this.arrowheadColor="calculated",this.fontFamily='"trebuchet ms", verdana, arial, sans-serif',this.fontSize="16px",this.labelBackground="#181818",this.textColor="#ccc",this.THEME_COLOR_LIMIT=12,this.nodeBkg="calculated",this.nodeBorder="calculated",this.clusterBkg="calculated",this.clusterBorder="calculated",this.defaultLinkColor="calculated",this.titleColor="#F9FFFE",this.edgeLabelBackground="calculated",this.actorBorder="calculated",this.actorBkg="calculated",this.actorTextColor="calculated",this.actorLineColor="calculated",this.signalColor="calculated",this.signalTextColor="calculated",this.labelBoxBkgColor="calculated",this.labelBoxBorderColor="calculated",this.labelTextColor="calculated",this.loopTextColor="calculated",this.noteBorderColor="calculated",this.noteBkgColor="#fff5ad",this.noteTextColor="calculated",this.activationBorderColor="calculated",this.activationBkgColor="calculated",this.sequenceNumberColor="black",this.sectionBkgColor=darken("#EAE8D9",30),this.altSectionBkgColor="calculated",this.sectionBkgColor2="#EAE8D9",this.excludeBkgColor=darken(this.sectionBkgColor,10),this.taskBorderColor=rgba$1(255,255,255,70),this.taskBkgColor="calculated",this.taskTextColor="calculated",this.taskTextLightColor="calculated",this.taskTextOutsideColor="calculated",this.taskTextClickableColor="#003163",this.activeTaskBorderColor=rgba$1(255,255,255,50),this.activeTaskBkgColor="#81B1DB",this.gridColor="calculated",this.doneTaskBkgColor="calculated",this.doneTaskBorderColor="grey",this.critBorderColor="#E83737",this.critBkgColor="#E83737",this.taskTextDarkColor="calculated",this.todayLineColor="#DB5757",this.vertLineColor="#00BFFF",this.personBorder=this.primaryBorderColor,this.personBkg=this.mainBkg,this.archEdgeColor="calculated",this.archEdgeArrowColor="calculated",this.archEdgeWidth="3",this.archGroupBorderColor=this.primaryBorderColor,this.archGroupBorderWidth="2px",this.rowOdd=this.rowOdd||lighten(this.mainBkg,5)||"#ffffff",this.rowEven=this.rowEven||darken(this.mainBkg,10),this.labelColor="calculated",this.errorBkgColor="#a44141",this.errorTextColor="#ddd"}updateColors(){this.secondBkg=lighten(this.mainBkg,16),this.lineColor=this.mainContrastColor,this.arrowheadColor=this.mainContrastColor,this.nodeBkg=this.mainBkg,this.nodeBorder=this.border1,this.clusterBkg=this.secondBkg,this.clusterBorder=this.border2,this.defaultLinkColor=this.lineColor,this.edgeLabelBackground=lighten(this.labelBackground,25),this.actorBorder=this.border1,this.actorBkg=this.mainBkg,this.actorTextColor=this.mainContrastColor,this.actorLineColor=this.actorBorder,this.signalColor=this.mainContrastColor,this.signalTextColor=this.mainContrastColor,this.labelBoxBkgColor=this.actorBkg,this.labelBoxBorderColor=this.actorBorder,this.labelTextColor=this.mainContrastColor,this.loopTextColor=this.mainContrastColor,this.noteBorderColor=this.secondaryBorderColor,this.noteBkgColor=this.secondBkg,this.noteTextColor=this.secondaryTextColor,this.activationBorderColor=this.border1,this.activationBkgColor=this.secondBkg,this.altSectionBkgColor=this.background,this.taskBkgColor=lighten(this.mainBkg,23),this.taskTextColor=this.darkTextColor,this.taskTextLightColor=this.mainContrastColor,this.taskTextOutsideColor=this.taskTextLightColor,this.gridColor=this.mainContrastColor,this.doneTaskBkgColor=this.mainContrastColor,this.taskTextDarkColor=this.darkTextColor,this.archEdgeColor=this.lineColor,this.archEdgeArrowColor=this.lineColor,this.transitionColor=this.transitionColor||this.lineColor,this.transitionLabelColor=this.transitionLabelColor||this.textColor,this.stateLabelColor=this.stateLabelColor||this.stateBkg||this.primaryTextColor,this.stateBkg=this.stateBkg||this.mainBkg,this.labelBackgroundColor=this.labelBackgroundColor||this.stateBkg,this.compositeBackground=this.compositeBackground||this.background||this.tertiaryColor,this.altBackground=this.altBackground||"#555",this.compositeTitleBackground=this.compositeTitleBackground||this.mainBkg,this.compositeBorder=this.compositeBorder||this.nodeBorder,this.innerEndBackground=this.primaryBorderColor,this.specialStateColor="#f4f4f4",this.errorBkgColor=this.errorBkgColor||this.tertiaryColor,this.errorTextColor=this.errorTextColor||this.tertiaryTextColor,this.fillType0=this.primaryColor,this.fillType1=this.secondaryColor,this.fillType2=adjust(this.primaryColor,{h:64}),this.fillType3=adjust(this.secondaryColor,{h:64}),this.fillType4=adjust(this.primaryColor,{h:-64}),this.fillType5=adjust(this.secondaryColor,{h:-64}),this.fillType6=adjust(this.primaryColor,{h:128}),this.fillType7=adjust(this.secondaryColor,{h:128}),this.cScale1=this.cScale1||"#0b0000",this.cScale2=this.cScale2||"#4d1037",this.cScale3=this.cScale3||"#3f5258",this.cScale4=this.cScale4||"#4f2f1b",this.cScale5=this.cScale5||"#6e0a0a",this.cScale6=this.cScale6||"#3b0048",this.cScale7=this.cScale7||"#995a01",this.cScale8=this.cScale8||"#154706",this.cScale9=this.cScale9||"#161722",this.cScale10=this.cScale10||"#00296f",this.cScale11=this.cScale11||"#01629c",this.cScale12=this.cScale12||"#010029",this.cScale0=this.cScale0||this.primaryColor,this.cScale1=this.cScale1||this.secondaryColor,this.cScale2=this.cScale2||this.tertiaryColor,this.cScale3=this.cScale3||adjust(this.primaryColor,{h:30}),this.cScale4=this.cScale4||adjust(this.primaryColor,{h:60}),this.cScale5=this.cScale5||adjust(this.primaryColor,{h:90}),this.cScale6=this.cScale6||adjust(this.primaryColor,{h:120}),this.cScale7=this.cScale7||adjust(this.primaryColor,{h:150}),this.cScale8=this.cScale8||adjust(this.primaryColor,{h:210}),this.cScale9=this.cScale9||adjust(this.primaryColor,{h:270}),this.cScale10=this.cScale10||adjust(this.primaryColor,{h:300}),this.cScale11=this.cScale11||adjust(this.primaryColor,{h:330});for(let it=0;it<this.THEME_COLOR_LIMIT;it++)this["cScaleInv"+it]=this["cScaleInv"+it]||invert(this["cScale"+it]);for(let it=0;it<this.THEME_COLOR_LIMIT;it++)this["cScalePeer"+it]=this["cScalePeer"+it]||lighten(this["cScale"+it],10);for(let it=0;it<5;it++)this["surface"+it]=this["surface"+it]||adjust(this.mainBkg,{h:30,s:-30,l:-(-10+it*4)}),this["surfacePeer"+it]=this["surfacePeer"+it]||adjust(this.mainBkg,{h:30,s:-30,l:-(-7+it*4)});this.scaleLabelColor=this.scaleLabelColor||(this.darkMode?"black":this.labelTextColor);for(let it=0;it<this.THEME_COLOR_LIMIT;it++)this["cScaleLabel"+it]=this["cScaleLabel"+it]||this.scaleLabelColor;for(let it=0;it<this.THEME_COLOR_LIMIT;it++)this["pie"+it]=this["cScale"+it];this.pieTitleTextSize=this.pieTitleTextSize||"25px",this.pieTitleTextColor=this.pieTitleTextColor||this.taskTextDarkColor,this.pieSectionTextSize=this.pieSectionTextSize||"17px",this.pieSectionTextColor=this.pieSectionTextColor||this.textColor,this.pieLegendTextSize=this.pieLegendTextSize||"17px",this.pieLegendTextColor=this.pieLegendTextColor||this.taskTextDarkColor,this.pieStrokeColor=this.pieStrokeColor||"black",this.pieStrokeWidth=this.pieStrokeWidth||"2px",this.pieOuterStrokeWidth=this.pieOuterStrokeWidth||"2px",this.pieOuterStrokeColor=this.pieOuterStrokeColor||"black",this.pieOpacity=this.pieOpacity||"0.7",this.quadrant1Fill=this.quadrant1Fill||this.primaryColor,this.quadrant2Fill=this.quadrant2Fill||adjust(this.primaryColor,{r:5,g:5,b:5}),this.quadrant3Fill=this.quadrant3Fill||adjust(this.primaryColor,{r:10,g:10,b:10}),this.quadrant4Fill=this.quadrant4Fill||adjust(this.primaryColor,{r:15,g:15,b:15}),this.quadrant1TextFill=this.quadrant1TextFill||this.primaryTextColor,this.quadrant2TextFill=this.quadrant2TextFill||adjust(this.primaryTextColor,{r:-5,g:-5,b:-5}),this.quadrant3TextFill=this.quadrant3TextFill||adjust(this.primaryTextColor,{r:-10,g:-10,b:-10}),this.quadrant4TextFill=this.quadrant4TextFill||adjust(this.primaryTextColor,{r:-15,g:-15,b:-15}),this.quadrantPointFill=this.quadrantPointFill||isDark(this.quadrant1Fill)?lighten(this.quadrant1Fill):darken(this.quadrant1Fill),this.quadrantPointTextFill=this.quadrantPointTextFill||this.primaryTextColor,this.quadrantXAxisTextFill=this.quadrantXAxisTextFill||this.primaryTextColor,this.quadrantYAxisTextFill=this.quadrantYAxisTextFill||this.primaryTextColor,this.quadrantInternalBorderStrokeFill=this.quadrantInternalBorderStrokeFill||this.primaryBorderColor,this.quadrantExternalBorderStrokeFill=this.quadrantExternalBorderStrokeFill||this.primaryBorderColor,this.quadrantTitleFill=this.quadrantTitleFill||this.primaryTextColor,this.xyChart={backgroundColor:this.xyChart?.backgroundColor||this.background,titleColor:this.xyChart?.titleColor||this.primaryTextColor,xAxisTitleColor:this.xyChart?.xAxisTitleColor||this.primaryTextColor,xAxisLabelColor:this.xyChart?.xAxisLabelColor||this.primaryTextColor,xAxisTickColor:this.xyChart?.xAxisTickColor||this.primaryTextColor,xAxisLineColor:this.xyChart?.xAxisLineColor||this.primaryTextColor,yAxisTitleColor:this.xyChart?.yAxisTitleColor||this.primaryTextColor,yAxisLabelColor:this.xyChart?.yAxisLabelColor||this.primaryTextColor,yAxisTickColor:this.xyChart?.yAxisTickColor||this.primaryTextColor,yAxisLineColor:this.xyChart?.yAxisLineColor||this.primaryTextColor,plotColorPalette:this.xyChart?.plotColorPalette||"#3498db,#2ecc71,#e74c3c,#f1c40f,#bdc3c7,#ffffff,#34495e,#9b59b6,#1abc9c,#e67e22"},this.packet={startByteColor:this.primaryTextColor,endByteColor:this.primaryTextColor,labelColor:this.primaryTextColor,titleColor:this.primaryTextColor,blockStrokeColor:this.primaryTextColor,blockFillColor:this.background},this.radar={axisColor:this.radar?.axisColor||this.lineColor,axisStrokeWidth:this.radar?.axisStrokeWidth||2,axisLabelFontSize:this.radar?.axisLabelFontSize||12,curveOpacity:this.radar?.curveOpacity||.5,curveStrokeWidth:this.radar?.curveStrokeWidth||2,graticuleColor:this.radar?.graticuleColor||"#DEDEDE",graticuleStrokeWidth:this.radar?.graticuleStrokeWidth||1,graticuleOpacity:this.radar?.graticuleOpacity||.3,legendBoxSize:this.radar?.legendBoxSize||12,legendFontSize:this.radar?.legendFontSize||12},this.classText=this.primaryTextColor,this.requirementBackground=this.requirementBackground||this.primaryColor,this.requirementBorderColor=this.requirementBorderColor||this.primaryBorderColor,this.requirementBorderSize=this.requirementBorderSize||"1",this.requirementTextColor=this.requirementTextColor||this.primaryTextColor,this.relationColor=this.relationColor||this.lineColor,this.relationLabelBackground=this.relationLabelBackground||(this.darkMode?darken(this.secondaryColor,30):this.secondaryColor),this.relationLabelColor=this.relationLabelColor||this.actorTextColor,this.git0=lighten(this.secondaryColor,20),this.git1=lighten(this.pie2||this.secondaryColor,20),this.git2=lighten(this.pie3||this.tertiaryColor,20),this.git3=lighten(this.pie4||adjust(this.primaryColor,{h:-30}),20),this.git4=lighten(this.pie5||adjust(this.primaryColor,{h:-60}),20),this.git5=lighten(this.pie6||adjust(this.primaryColor,{h:-90}),10),this.git6=lighten(this.pie7||adjust(this.primaryColor,{h:60}),10),this.git7=lighten(this.pie8||adjust(this.primaryColor,{h:120}),20),this.gitInv0=this.gitInv0||invert(this.git0),this.gitInv1=this.gitInv1||invert(this.git1),this.gitInv2=this.gitInv2||invert(this.git2),this.gitInv3=this.gitInv3||invert(this.git3),this.gitInv4=this.gitInv4||invert(this.git4),this.gitInv5=this.gitInv5||invert(this.git5),this.gitInv6=this.gitInv6||invert(this.git6),this.gitInv7=this.gitInv7||invert(this.git7),this.gitBranchLabel0=this.gitBranchLabel0||invert(this.labelTextColor),this.gitBranchLabel1=this.gitBranchLabel1||this.labelTextColor,this.gitBranchLabel2=this.gitBranchLabel2||this.labelTextColor,this.gitBranchLabel3=this.gitBranchLabel3||invert(this.labelTextColor),this.gitBranchLabel4=this.gitBranchLabel4||this.labelTextColor,this.gitBranchLabel5=this.gitBranchLabel5||this.labelTextColor,this.gitBranchLabel6=this.gitBranchLabel6||this.labelTextColor,this.gitBranchLabel7=this.gitBranchLabel7||this.labelTextColor,this.tagLabelColor=this.tagLabelColor||this.primaryTextColor,this.tagLabelBackground=this.tagLabelBackground||this.primaryColor,this.tagLabelBorder=this.tagBorder||this.primaryBorderColor,this.tagLabelFontSize=this.tagLabelFontSize||"10px",this.commitLabelColor=this.commitLabelColor||this.secondaryTextColor,this.commitLabelBackground=this.commitLabelBackground||this.secondaryColor,this.commitLabelFontSize=this.commitLabelFontSize||"10px",this.attributeBackgroundColorOdd=this.attributeBackgroundColorOdd||lighten(this.background,12),this.attributeBackgroundColorEven=this.attributeBackgroundColorEven||lighten(this.background,2),this.nodeBorder=this.nodeBorder||"#999"}calculate(it){if(typeof it!="object"){this.updateColors();return}const ct=Object.keys(it);ct.forEach(dt=>{this[dt]=it[dt]}),this.updateColors(),ct.forEach(dt=>{this[dt]=it[dt]})}},__name(Mo,"Theme"),Mo),getThemeVariables2=__name(rt=>{const it=new Theme2;return it.calculate(rt),it},"getThemeVariables"),wo,Theme3=(wo=class{constructor(){this.background="#f4f4f4",this.primaryColor="#ECECFF",this.secondaryColor=adjust(this.primaryColor,{h:120}),this.secondaryColor="#ffffde",this.tertiaryColor=adjust(this.primaryColor,{h:-160}),this.primaryBorderColor=mkBorder(this.primaryColor,this.darkMode),this.secondaryBorderColor=mkBorder(this.secondaryColor,this.darkMode),this.tertiaryBorderColor=mkBorder(this.tertiaryColor,this.darkMode),this.primaryTextColor=invert(this.primaryColor),this.secondaryTextColor=invert(this.secondaryColor),this.tertiaryTextColor=invert(this.tertiaryColor),this.lineColor=invert(this.background),this.textColor=invert(this.background),this.background="white",this.mainBkg="#ECECFF",this.secondBkg="#ffffde",this.lineColor="#333333",this.border1="#9370DB",this.border2="#aaaa33",this.arrowheadColor="#333333",this.fontFamily='"trebuchet ms", verdana, arial, sans-serif',this.fontSize="16px",this.labelBackground="rgba(232,232,232, 0.8)",this.textColor="#333",this.THEME_COLOR_LIMIT=12,this.nodeBkg="calculated",this.nodeBorder="calculated",this.clusterBkg="calculated",this.clusterBorder="calculated",this.defaultLinkColor="calculated",this.titleColor="calculated",this.edgeLabelBackground="calculated",this.actorBorder="calculated",this.actorBkg="calculated",this.actorTextColor="black",this.actorLineColor="calculated",this.signalColor="calculated",this.signalTextColor="calculated",this.labelBoxBkgColor="calculated",this.labelBoxBorderColor="calculated",this.labelTextColor="calculated",this.loopTextColor="calculated",this.noteBorderColor="calculated",this.noteBkgColor="#fff5ad",this.noteTextColor="calculated",this.activationBorderColor="#666",this.activationBkgColor="#f4f4f4",this.sequenceNumberColor="white",this.sectionBkgColor="calculated",this.altSectionBkgColor="calculated",this.sectionBkgColor2="calculated",this.excludeBkgColor="#eeeeee",this.taskBorderColor="calculated",this.taskBkgColor="calculated",this.taskTextLightColor="calculated",this.taskTextColor=this.taskTextLightColor,this.taskTextDarkColor="calculated",this.taskTextOutsideColor=this.taskTextDarkColor,this.taskTextClickableColor="calculated",this.activeTaskBorderColor="calculated",this.activeTaskBkgColor="calculated",this.gridColor="calculated",this.doneTaskBkgColor="calculated",this.doneTaskBorderColor="calculated",this.critBorderColor="calculated",this.critBkgColor="calculated",this.todayLineColor="calculated",this.vertLineColor="calculated",this.sectionBkgColor=rgba$1(102,102,255,.49),this.altSectionBkgColor="white",this.sectionBkgColor2="#fff400",this.taskBorderColor="#534fbc",this.taskBkgColor="#8a90dd",this.taskTextLightColor="white",this.taskTextColor="calculated",this.taskTextDarkColor="black",this.taskTextOutsideColor="calculated",this.taskTextClickableColor="#003163",this.activeTaskBorderColor="#534fbc",this.activeTaskBkgColor="#bfc7ff",this.gridColor="lightgrey",this.doneTaskBkgColor="lightgrey",this.doneTaskBorderColor="grey",this.critBorderColor="#ff8888",this.critBkgColor="red",this.todayLineColor="red",this.vertLineColor="navy",this.personBorder=this.primaryBorderColor,this.personBkg=this.mainBkg,this.archEdgeColor="calculated",this.archEdgeArrowColor="calculated",this.archEdgeWidth="3",this.archGroupBorderColor=this.primaryBorderColor,this.archGroupBorderWidth="2px",this.rowOdd="calculated",this.rowEven="calculated",this.labelColor="black",this.errorBkgColor="#552222",this.errorTextColor="#552222",this.updateColors()}updateColors(){this.cScale0=this.cScale0||this.primaryColor,this.cScale1=this.cScale1||this.secondaryColor,this.cScale2=this.cScale2||this.tertiaryColor,this.cScale3=this.cScale3||adjust(this.primaryColor,{h:30}),this.cScale4=this.cScale4||adjust(this.primaryColor,{h:60}),this.cScale5=this.cScale5||adjust(this.primaryColor,{h:90}),this.cScale6=this.cScale6||adjust(this.primaryColor,{h:120}),this.cScale7=this.cScale7||adjust(this.primaryColor,{h:150}),this.cScale8=this.cScale8||adjust(this.primaryColor,{h:210}),this.cScale9=this.cScale9||adjust(this.primaryColor,{h:270}),this.cScale10=this.cScale10||adjust(this.primaryColor,{h:300}),this.cScale11=this.cScale11||adjust(this.primaryColor,{h:330}),this.cScalePeer1=this.cScalePeer1||darken(this.secondaryColor,45),this.cScalePeer2=this.cScalePeer2||darken(this.tertiaryColor,40);for(let it=0;it<this.THEME_COLOR_LIMIT;it++)this["cScale"+it]=darken(this["cScale"+it],10),this["cScalePeer"+it]=this["cScalePeer"+it]||darken(this["cScale"+it],25);for(let it=0;it<this.THEME_COLOR_LIMIT;it++)this["cScaleInv"+it]=this["cScaleInv"+it]||adjust(this["cScale"+it],{h:180});for(let it=0;it<5;it++)this["surface"+it]=this["surface"+it]||adjust(this.mainBkg,{h:30,l:-(5+it*5)}),this["surfacePeer"+it]=this["surfacePeer"+it]||adjust(this.mainBkg,{h:30,l:-(7+it*5)});if(this.scaleLabelColor=this.scaleLabelColor!=="calculated"&&this.scaleLabelColor?this.scaleLabelColor:this.labelTextColor,this.labelTextColor!=="calculated"){this.cScaleLabel0=this.cScaleLabel0||invert(this.labelTextColor),this.cScaleLabel3=this.cScaleLabel3||invert(this.labelTextColor);for(let it=0;it<this.THEME_COLOR_LIMIT;it++)this["cScaleLabel"+it]=this["cScaleLabel"+it]||this.labelTextColor}this.nodeBkg=this.mainBkg,this.nodeBorder=this.border1,this.clusterBkg=this.secondBkg,this.clusterBorder=this.border2,this.defaultLinkColor=this.lineColor,this.titleColor=this.textColor,this.edgeLabelBackground=this.labelBackground,this.actorBorder=lighten(this.border1,23),this.actorBkg=this.mainBkg,this.labelBoxBkgColor=this.actorBkg,this.signalColor=this.textColor,this.signalTextColor=this.textColor,this.labelBoxBorderColor=this.actorBorder,this.labelTextColor=this.actorTextColor,this.loopTextColor=this.actorTextColor,this.noteBorderColor=this.border2,this.noteTextColor=this.actorTextColor,this.actorLineColor=this.actorBorder,this.taskTextColor=this.taskTextLightColor,this.taskTextOutsideColor=this.taskTextDarkColor,this.archEdgeColor=this.lineColor,this.archEdgeArrowColor=this.lineColor,this.rowOdd=this.rowOdd||lighten(this.primaryColor,75)||"#ffffff",this.rowEven=this.rowEven||lighten(this.primaryColor,1),this.transitionColor=this.transitionColor||this.lineColor,this.transitionLabelColor=this.transitionLabelColor||this.textColor,this.stateLabelColor=this.stateLabelColor||this.stateBkg||this.primaryTextColor,this.stateBkg=this.stateBkg||this.mainBkg,this.labelBackgroundColor=this.labelBackgroundColor||this.stateBkg,this.compositeBackground=this.compositeBackground||this.background||this.tertiaryColor,this.altBackground=this.altBackground||"#f0f0f0",this.compositeTitleBackground=this.compositeTitleBackground||this.mainBkg,this.compositeBorder=this.compositeBorder||this.nodeBorder,this.innerEndBackground=this.nodeBorder,this.specialStateColor=this.lineColor,this.errorBkgColor=this.errorBkgColor||this.tertiaryColor,this.errorTextColor=this.errorTextColor||this.tertiaryTextColor,this.transitionColor=this.transitionColor||this.lineColor,this.classText=this.primaryTextColor,this.fillType0=this.primaryColor,this.fillType1=this.secondaryColor,this.fillType2=adjust(this.primaryColor,{h:64}),this.fillType3=adjust(this.secondaryColor,{h:64}),this.fillType4=adjust(this.primaryColor,{h:-64}),this.fillType5=adjust(this.secondaryColor,{h:-64}),this.fillType6=adjust(this.primaryColor,{h:128}),this.fillType7=adjust(this.secondaryColor,{h:128}),this.pie1=this.pie1||this.primaryColor,this.pie2=this.pie2||this.secondaryColor,this.pie3=this.pie3||adjust(this.tertiaryColor,{l:-40}),this.pie4=this.pie4||adjust(this.primaryColor,{l:-10}),this.pie5=this.pie5||adjust(this.secondaryColor,{l:-30}),this.pie6=this.pie6||adjust(this.tertiaryColor,{l:-20}),this.pie7=this.pie7||adjust(this.primaryColor,{h:60,l:-20}),this.pie8=this.pie8||adjust(this.primaryColor,{h:-60,l:-40}),this.pie9=this.pie9||adjust(this.primaryColor,{h:120,l:-40}),this.pie10=this.pie10||adjust(this.primaryColor,{h:60,l:-40}),this.pie11=this.pie11||adjust(this.primaryColor,{h:-90,l:-40}),this.pie12=this.pie12||adjust(this.primaryColor,{h:120,l:-30}),this.pieTitleTextSize=this.pieTitleTextSize||"25px",this.pieTitleTextColor=this.pieTitleTextColor||this.taskTextDarkColor,this.pieSectionTextSize=this.pieSectionTextSize||"17px",this.pieSectionTextColor=this.pieSectionTextColor||this.textColor,this.pieLegendTextSize=this.pieLegendTextSize||"17px",this.pieLegendTextColor=this.pieLegendTextColor||this.taskTextDarkColor,this.pieStrokeColor=this.pieStrokeColor||"black",this.pieStrokeWidth=this.pieStrokeWidth||"2px",this.pieOuterStrokeWidth=this.pieOuterStrokeWidth||"2px",this.pieOuterStrokeColor=this.pieOuterStrokeColor||"black",this.pieOpacity=this.pieOpacity||"0.7",this.quadrant1Fill=this.quadrant1Fill||this.primaryColor,this.quadrant2Fill=this.quadrant2Fill||adjust(this.primaryColor,{r:5,g:5,b:5}),this.quadrant3Fill=this.quadrant3Fill||adjust(this.primaryColor,{r:10,g:10,b:10}),this.quadrant4Fill=this.quadrant4Fill||adjust(this.primaryColor,{r:15,g:15,b:15}),this.quadrant1TextFill=this.quadrant1TextFill||this.primaryTextColor,this.quadrant2TextFill=this.quadrant2TextFill||adjust(this.primaryTextColor,{r:-5,g:-5,b:-5}),this.quadrant3TextFill=this.quadrant3TextFill||adjust(this.primaryTextColor,{r:-10,g:-10,b:-10}),this.quadrant4TextFill=this.quadrant4TextFill||adjust(this.primaryTextColor,{r:-15,g:-15,b:-15}),this.quadrantPointFill=this.quadrantPointFill||isDark(this.quadrant1Fill)?lighten(this.quadrant1Fill):darken(this.quadrant1Fill),this.quadrantPointTextFill=this.quadrantPointTextFill||this.primaryTextColor,this.quadrantXAxisTextFill=this.quadrantXAxisTextFill||this.primaryTextColor,this.quadrantYAxisTextFill=this.quadrantYAxisTextFill||this.primaryTextColor,this.quadrantInternalBorderStrokeFill=this.quadrantInternalBorderStrokeFill||this.primaryBorderColor,this.quadrantExternalBorderStrokeFill=this.quadrantExternalBorderStrokeFill||this.primaryBorderColor,this.quadrantTitleFill=this.quadrantTitleFill||this.primaryTextColor,this.radar={axisColor:this.radar?.axisColor||this.lineColor,axisStrokeWidth:this.radar?.axisStrokeWidth||2,axisLabelFontSize:this.radar?.axisLabelFontSize||12,curveOpacity:this.radar?.curveOpacity||.5,curveStrokeWidth:this.radar?.curveStrokeWidth||2,graticuleColor:this.radar?.graticuleColor||"#DEDEDE",graticuleStrokeWidth:this.radar?.graticuleStrokeWidth||1,graticuleOpacity:this.radar?.graticuleOpacity||.3,legendBoxSize:this.radar?.legendBoxSize||12,legendFontSize:this.radar?.legendFontSize||12},this.xyChart={backgroundColor:this.xyChart?.backgroundColor||this.background,titleColor:this.xyChart?.titleColor||this.primaryTextColor,xAxisTitleColor:this.xyChart?.xAxisTitleColor||this.primaryTextColor,xAxisLabelColor:this.xyChart?.xAxisLabelColor||this.primaryTextColor,xAxisTickColor:this.xyChart?.xAxisTickColor||this.primaryTextColor,xAxisLineColor:this.xyChart?.xAxisLineColor||this.primaryTextColor,yAxisTitleColor:this.xyChart?.yAxisTitleColor||this.primaryTextColor,yAxisLabelColor:this.xyChart?.yAxisLabelColor||this.primaryTextColor,yAxisTickColor:this.xyChart?.yAxisTickColor||this.primaryTextColor,yAxisLineColor:this.xyChart?.yAxisLineColor||this.primaryTextColor,plotColorPalette:this.xyChart?.plotColorPalette||"#ECECFF,#8493A6,#FFC3A0,#DCDDE1,#B8E994,#D1A36F,#C3CDE6,#FFB6C1,#496078,#F8F3E3"},this.requirementBackground=this.requirementBackground||this.primaryColor,this.requirementBorderColor=this.requirementBorderColor||this.primaryBorderColor,this.requirementBorderSize=this.requirementBorderSize||"1",this.requirementTextColor=this.requirementTextColor||this.primaryTextColor,this.relationColor=this.relationColor||this.lineColor,this.relationLabelBackground=this.relationLabelBackground||this.labelBackground,this.relationLabelColor=this.relationLabelColor||this.actorTextColor,this.git0=this.git0||this.primaryColor,this.git1=this.git1||this.secondaryColor,this.git2=this.git2||this.tertiaryColor,this.git3=this.git3||adjust(this.primaryColor,{h:-30}),this.git4=this.git4||adjust(this.primaryColor,{h:-60}),this.git5=this.git5||adjust(this.primaryColor,{h:-90}),this.git6=this.git6||adjust(this.primaryColor,{h:60}),this.git7=this.git7||adjust(this.primaryColor,{h:120}),this.darkMode?(this.git0=lighten(this.git0,25),this.git1=lighten(this.git1,25),this.git2=lighten(this.git2,25),this.git3=lighten(this.git3,25),this.git4=lighten(this.git4,25),this.git5=lighten(this.git5,25),this.git6=lighten(this.git6,25),this.git7=lighten(this.git7,25)):(this.git0=darken(this.git0,25),this.git1=darken(this.git1,25),this.git2=darken(this.git2,25),this.git3=darken(this.git3,25),this.git4=darken(this.git4,25),this.git5=darken(this.git5,25),this.git6=darken(this.git6,25),this.git7=darken(this.git7,25)),this.gitInv0=this.gitInv0||darken(invert(this.git0),25),this.gitInv1=this.gitInv1||invert(this.git1),this.gitInv2=this.gitInv2||invert(this.git2),this.gitInv3=this.gitInv3||invert(this.git3),this.gitInv4=this.gitInv4||invert(this.git4),this.gitInv5=this.gitInv5||invert(this.git5),this.gitInv6=this.gitInv6||invert(this.git6),this.gitInv7=this.gitInv7||invert(this.git7),this.gitBranchLabel0=this.gitBranchLabel0||invert(this.labelTextColor),this.gitBranchLabel1=this.gitBranchLabel1||this.labelTextColor,this.gitBranchLabel2=this.gitBranchLabel2||this.labelTextColor,this.gitBranchLabel3=this.gitBranchLabel3||invert(this.labelTextColor),this.gitBranchLabel4=this.gitBranchLabel4||this.labelTextColor,this.gitBranchLabel5=this.gitBranchLabel5||this.labelTextColor,this.gitBranchLabel6=this.gitBranchLabel6||this.labelTextColor,this.gitBranchLabel7=this.gitBranchLabel7||this.labelTextColor,this.tagLabelColor=this.tagLabelColor||this.primaryTextColor,this.tagLabelBackground=this.tagLabelBackground||this.primaryColor,this.tagLabelBorder=this.tagBorder||this.primaryBorderColor,this.tagLabelFontSize=this.tagLabelFontSize||"10px",this.commitLabelColor=this.commitLabelColor||this.secondaryTextColor,this.commitLabelBackground=this.commitLabelBackground||this.secondaryColor,this.commitLabelFontSize=this.commitLabelFontSize||"10px",this.attributeBackgroundColorOdd=this.attributeBackgroundColorOdd||oldAttributeBackgroundColorOdd,this.attributeBackgroundColorEven=this.attributeBackgroundColorEven||oldAttributeBackgroundColorEven}calculate(it){if(Object.keys(this).forEach(dt=>{this[dt]==="calculated"&&(this[dt]=void 0)}),typeof it!="object"){this.updateColors();return}const ct=Object.keys(it);ct.forEach(dt=>{this[dt]=it[dt]}),this.updateColors(),ct.forEach(dt=>{this[dt]=it[dt]})}},__name(wo,"Theme"),wo),getThemeVariables3=__name(rt=>{const it=new Theme3;return it.calculate(rt),it},"getThemeVariables"),Lo,Theme4=(Lo=class{constructor(){this.background="#f4f4f4",this.primaryColor="#cde498",this.secondaryColor="#cdffb2",this.background="white",this.mainBkg="#cde498",this.secondBkg="#cdffb2",this.lineColor="green",this.border1="#13540c",this.border2="#6eaa49",this.arrowheadColor="green",this.fontFamily='"trebuchet ms", verdana, arial, sans-serif',this.fontSize="16px",this.tertiaryColor=lighten("#cde498",10),this.primaryBorderColor=mkBorder(this.primaryColor,this.darkMode),this.secondaryBorderColor=mkBorder(this.secondaryColor,this.darkMode),this.tertiaryBorderColor=mkBorder(this.tertiaryColor,this.darkMode),this.primaryTextColor=invert(this.primaryColor),this.secondaryTextColor=invert(this.secondaryColor),this.tertiaryTextColor=invert(this.primaryColor),this.lineColor=invert(this.background),this.textColor=invert(this.background),this.THEME_COLOR_LIMIT=12,this.nodeBkg="calculated",this.nodeBorder="calculated",this.clusterBkg="calculated",this.clusterBorder="calculated",this.defaultLinkColor="calculated",this.titleColor="#333",this.edgeLabelBackground="#e8e8e8",this.actorBorder="calculated",this.actorBkg="calculated",this.actorTextColor="black",this.actorLineColor="calculated",this.signalColor="#333",this.signalTextColor="#333",this.labelBoxBkgColor="calculated",this.labelBoxBorderColor="#326932",this.labelTextColor="calculated",this.loopTextColor="calculated",this.noteBorderColor="calculated",this.noteBkgColor="#fff5ad",this.noteTextColor="calculated",this.activationBorderColor="#666",this.activationBkgColor="#f4f4f4",this.sequenceNumberColor="white",this.sectionBkgColor="#6eaa49",this.altSectionBkgColor="white",this.sectionBkgColor2="#6eaa49",this.excludeBkgColor="#eeeeee",this.taskBorderColor="calculated",this.taskBkgColor="#487e3a",this.taskTextLightColor="white",this.taskTextColor="calculated",this.taskTextDarkColor="black",this.taskTextOutsideColor="calculated",this.taskTextClickableColor="#003163",this.activeTaskBorderColor="calculated",this.activeTaskBkgColor="calculated",this.gridColor="lightgrey",this.doneTaskBkgColor="lightgrey",this.doneTaskBorderColor="grey",this.critBorderColor="#ff8888",this.critBkgColor="red",this.todayLineColor="red",this.vertLineColor="#00BFFF",this.personBorder=this.primaryBorderColor,this.personBkg=this.mainBkg,this.archEdgeColor="calculated",this.archEdgeArrowColor="calculated",this.archEdgeWidth="3",this.archGroupBorderColor=this.primaryBorderColor,this.archGroupBorderWidth="2px",this.labelColor="black",this.errorBkgColor="#552222",this.errorTextColor="#552222"}updateColors(){this.actorBorder=darken(this.mainBkg,20),this.actorBkg=this.mainBkg,this.labelBoxBkgColor=this.actorBkg,this.labelTextColor=this.actorTextColor,this.loopTextColor=this.actorTextColor,this.noteBorderColor=this.border2,this.noteTextColor=this.actorTextColor,this.actorLineColor=this.actorBorder,this.cScale0=this.cScale0||this.primaryColor,this.cScale1=this.cScale1||this.secondaryColor,this.cScale2=this.cScale2||this.tertiaryColor,this.cScale3=this.cScale3||adjust(this.primaryColor,{h:30}),this.cScale4=this.cScale4||adjust(this.primaryColor,{h:60}),this.cScale5=this.cScale5||adjust(this.primaryColor,{h:90}),this.cScale6=this.cScale6||adjust(this.primaryColor,{h:120}),this.cScale7=this.cScale7||adjust(this.primaryColor,{h:150}),this.cScale8=this.cScale8||adjust(this.primaryColor,{h:210}),this.cScale9=this.cScale9||adjust(this.primaryColor,{h:270}),this.cScale10=this.cScale10||adjust(this.primaryColor,{h:300}),this.cScale11=this.cScale11||adjust(this.primaryColor,{h:330}),this.cScalePeer1=this.cScalePeer1||darken(this.secondaryColor,45),this.cScalePeer2=this.cScalePeer2||darken(this.tertiaryColor,40);for(let it=0;it<this.THEME_COLOR_LIMIT;it++)this["cScale"+it]=darken(this["cScale"+it],10),this["cScalePeer"+it]=this["cScalePeer"+it]||darken(this["cScale"+it],25);for(let it=0;it<this.THEME_COLOR_LIMIT;it++)this["cScaleInv"+it]=this["cScaleInv"+it]||adjust(this["cScale"+it],{h:180});this.scaleLabelColor=this.scaleLabelColor!=="calculated"&&this.scaleLabelColor?this.scaleLabelColor:this.labelTextColor;for(let it=0;it<this.THEME_COLOR_LIMIT;it++)this["cScaleLabel"+it]=this["cScaleLabel"+it]||this.scaleLabelColor;for(let it=0;it<5;it++)this["surface"+it]=this["surface"+it]||adjust(this.mainBkg,{h:30,s:-30,l:-(5+it*5)}),this["surfacePeer"+it]=this["surfacePeer"+it]||adjust(this.mainBkg,{h:30,s:-30,l:-(8+it*5)});this.nodeBkg=this.mainBkg,this.nodeBorder=this.border1,this.clusterBkg=this.secondBkg,this.clusterBorder=this.border2,this.defaultLinkColor=this.lineColor,this.taskBorderColor=this.border1,this.taskTextColor=this.taskTextLightColor,this.taskTextOutsideColor=this.taskTextDarkColor,this.activeTaskBorderColor=this.taskBorderColor,this.activeTaskBkgColor=this.mainBkg,this.archEdgeColor=this.lineColor,this.archEdgeArrowColor=this.lineColor,this.rowOdd=this.rowOdd||lighten(this.mainBkg,75)||"#ffffff",this.rowEven=this.rowEven||lighten(this.mainBkg,20),this.transitionColor=this.transitionColor||this.lineColor,this.transitionLabelColor=this.transitionLabelColor||this.textColor,this.stateLabelColor=this.stateLabelColor||this.stateBkg||this.primaryTextColor,this.stateBkg=this.stateBkg||this.mainBkg,this.labelBackgroundColor=this.labelBackgroundColor||this.stateBkg,this.compositeBackground=this.compositeBackground||this.background||this.tertiaryColor,this.altBackground=this.altBackground||"#f0f0f0",this.compositeTitleBackground=this.compositeTitleBackground||this.mainBkg,this.compositeBorder=this.compositeBorder||this.nodeBorder,this.innerEndBackground=this.primaryBorderColor,this.specialStateColor=this.lineColor,this.errorBkgColor=this.errorBkgColor||this.tertiaryColor,this.errorTextColor=this.errorTextColor||this.tertiaryTextColor,this.transitionColor=this.transitionColor||this.lineColor,this.classText=this.primaryTextColor,this.fillType0=this.primaryColor,this.fillType1=this.secondaryColor,this.fillType2=adjust(this.primaryColor,{h:64}),this.fillType3=adjust(this.secondaryColor,{h:64}),this.fillType4=adjust(this.primaryColor,{h:-64}),this.fillType5=adjust(this.secondaryColor,{h:-64}),this.fillType6=adjust(this.primaryColor,{h:128}),this.fillType7=adjust(this.secondaryColor,{h:128}),this.pie1=this.pie1||this.primaryColor,this.pie2=this.pie2||this.secondaryColor,this.pie3=this.pie3||this.tertiaryColor,this.pie4=this.pie4||adjust(this.primaryColor,{l:-30}),this.pie5=this.pie5||adjust(this.secondaryColor,{l:-30}),this.pie6=this.pie6||adjust(this.tertiaryColor,{h:40,l:-40}),this.pie7=this.pie7||adjust(this.primaryColor,{h:60,l:-10}),this.pie8=this.pie8||adjust(this.primaryColor,{h:-60,l:-10}),this.pie9=this.pie9||adjust(this.primaryColor,{h:120,l:0}),this.pie10=this.pie10||adjust(this.primaryColor,{h:60,l:-50}),this.pie11=this.pie11||adjust(this.primaryColor,{h:-60,l:-50}),this.pie12=this.pie12||adjust(this.primaryColor,{h:120,l:-50}),this.pieTitleTextSize=this.pieTitleTextSize||"25px",this.pieTitleTextColor=this.pieTitleTextColor||this.taskTextDarkColor,this.pieSectionTextSize=this.pieSectionTextSize||"17px",this.pieSectionTextColor=this.pieSectionTextColor||this.textColor,this.pieLegendTextSize=this.pieLegendTextSize||"17px",this.pieLegendTextColor=this.pieLegendTextColor||this.taskTextDarkColor,this.pieStrokeColor=this.pieStrokeColor||"black",this.pieStrokeWidth=this.pieStrokeWidth||"2px",this.pieOuterStrokeWidth=this.pieOuterStrokeWidth||"2px",this.pieOuterStrokeColor=this.pieOuterStrokeColor||"black",this.pieOpacity=this.pieOpacity||"0.7",this.quadrant1Fill=this.quadrant1Fill||this.primaryColor,this.quadrant2Fill=this.quadrant2Fill||adjust(this.primaryColor,{r:5,g:5,b:5}),this.quadrant3Fill=this.quadrant3Fill||adjust(this.primaryColor,{r:10,g:10,b:10}),this.quadrant4Fill=this.quadrant4Fill||adjust(this.primaryColor,{r:15,g:15,b:15}),this.quadrant1TextFill=this.quadrant1TextFill||this.primaryTextColor,this.quadrant2TextFill=this.quadrant2TextFill||adjust(this.primaryTextColor,{r:-5,g:-5,b:-5}),this.quadrant3TextFill=this.quadrant3TextFill||adjust(this.primaryTextColor,{r:-10,g:-10,b:-10}),this.quadrant4TextFill=this.quadrant4TextFill||adjust(this.primaryTextColor,{r:-15,g:-15,b:-15}),this.quadrantPointFill=this.quadrantPointFill||isDark(this.quadrant1Fill)?lighten(this.quadrant1Fill):darken(this.quadrant1Fill),this.quadrantPointTextFill=this.quadrantPointTextFill||this.primaryTextColor,this.quadrantXAxisTextFill=this.quadrantXAxisTextFill||this.primaryTextColor,this.quadrantYAxisTextFill=this.quadrantYAxisTextFill||this.primaryTextColor,this.quadrantInternalBorderStrokeFill=this.quadrantInternalBorderStrokeFill||this.primaryBorderColor,this.quadrantExternalBorderStrokeFill=this.quadrantExternalBorderStrokeFill||this.primaryBorderColor,this.quadrantTitleFill=this.quadrantTitleFill||this.primaryTextColor,this.packet={startByteColor:this.primaryTextColor,endByteColor:this.primaryTextColor,labelColor:this.primaryTextColor,titleColor:this.primaryTextColor,blockStrokeColor:this.primaryTextColor,blockFillColor:this.mainBkg},this.radar={axisColor:this.radar?.axisColor||this.lineColor,axisStrokeWidth:this.radar?.axisStrokeWidth||2,axisLabelFontSize:this.radar?.axisLabelFontSize||12,curveOpacity:this.radar?.curveOpacity||.5,curveStrokeWidth:this.radar?.curveStrokeWidth||2,graticuleColor:this.radar?.graticuleColor||"#DEDEDE",graticuleStrokeWidth:this.radar?.graticuleStrokeWidth||1,graticuleOpacity:this.radar?.graticuleOpacity||.3,legendBoxSize:this.radar?.legendBoxSize||12,legendFontSize:this.radar?.legendFontSize||12},this.xyChart={backgroundColor:this.xyChart?.backgroundColor||this.background,titleColor:this.xyChart?.titleColor||this.primaryTextColor,xAxisTitleColor:this.xyChart?.xAxisTitleColor||this.primaryTextColor,xAxisLabelColor:this.xyChart?.xAxisLabelColor||this.primaryTextColor,xAxisTickColor:this.xyChart?.xAxisTickColor||this.primaryTextColor,xAxisLineColor:this.xyChart?.xAxisLineColor||this.primaryTextColor,yAxisTitleColor:this.xyChart?.yAxisTitleColor||this.primaryTextColor,yAxisLabelColor:this.xyChart?.yAxisLabelColor||this.primaryTextColor,yAxisTickColor:this.xyChart?.yAxisTickColor||this.primaryTextColor,yAxisLineColor:this.xyChart?.yAxisLineColor||this.primaryTextColor,plotColorPalette:this.xyChart?.plotColorPalette||"#CDE498,#FF6B6B,#A0D2DB,#D7BDE2,#F0F0F0,#FFC3A0,#7FD8BE,#FF9A8B,#FAF3E0,#FFF176"},this.requirementBackground=this.requirementBackground||this.primaryColor,this.requirementBorderColor=this.requirementBorderColor||this.primaryBorderColor,this.requirementBorderSize=this.requirementBorderSize||"1",this.requirementTextColor=this.requirementTextColor||this.primaryTextColor,this.relationColor=this.relationColor||this.lineColor,this.relationLabelBackground=this.relationLabelBackground||this.edgeLabelBackground,this.relationLabelColor=this.relationLabelColor||this.actorTextColor,this.git0=this.git0||this.primaryColor,this.git1=this.git1||this.secondaryColor,this.git2=this.git2||this.tertiaryColor,this.git3=this.git3||adjust(this.primaryColor,{h:-30}),this.git4=this.git4||adjust(this.primaryColor,{h:-60}),this.git5=this.git5||adjust(this.primaryColor,{h:-90}),this.git6=this.git6||adjust(this.primaryColor,{h:60}),this.git7=this.git7||adjust(this.primaryColor,{h:120}),this.darkMode?(this.git0=lighten(this.git0,25),this.git1=lighten(this.git1,25),this.git2=lighten(this.git2,25),this.git3=lighten(this.git3,25),this.git4=lighten(this.git4,25),this.git5=lighten(this.git5,25),this.git6=lighten(this.git6,25),this.git7=lighten(this.git7,25)):(this.git0=darken(this.git0,25),this.git1=darken(this.git1,25),this.git2=darken(this.git2,25),this.git3=darken(this.git3,25),this.git4=darken(this.git4,25),this.git5=darken(this.git5,25),this.git6=darken(this.git6,25),this.git7=darken(this.git7,25)),this.gitInv0=this.gitInv0||invert(this.git0),this.gitInv1=this.gitInv1||invert(this.git1),this.gitInv2=this.gitInv2||invert(this.git2),this.gitInv3=this.gitInv3||invert(this.git3),this.gitInv4=this.gitInv4||invert(this.git4),this.gitInv5=this.gitInv5||invert(this.git5),this.gitInv6=this.gitInv6||invert(this.git6),this.gitInv7=this.gitInv7||invert(this.git7),this.gitBranchLabel0=this.gitBranchLabel0||invert(this.labelTextColor),this.gitBranchLabel1=this.gitBranchLabel1||this.labelTextColor,this.gitBranchLabel2=this.gitBranchLabel2||this.labelTextColor,this.gitBranchLabel3=this.gitBranchLabel3||invert(this.labelTextColor),this.gitBranchLabel4=this.gitBranchLabel4||this.labelTextColor,this.gitBranchLabel5=this.gitBranchLabel5||this.labelTextColor,this.gitBranchLabel6=this.gitBranchLabel6||this.labelTextColor,this.gitBranchLabel7=this.gitBranchLabel7||this.labelTextColor,this.tagLabelColor=this.tagLabelColor||this.primaryTextColor,this.tagLabelBackground=this.tagLabelBackground||this.primaryColor,this.tagLabelBorder=this.tagBorder||this.primaryBorderColor,this.tagLabelFontSize=this.tagLabelFontSize||"10px",this.commitLabelColor=this.commitLabelColor||this.secondaryTextColor,this.commitLabelBackground=this.commitLabelBackground||this.secondaryColor,this.commitLabelFontSize=this.commitLabelFontSize||"10px",this.attributeBackgroundColorOdd=this.attributeBackgroundColorOdd||oldAttributeBackgroundColorOdd,this.attributeBackgroundColorEven=this.attributeBackgroundColorEven||oldAttributeBackgroundColorEven}calculate(it){if(typeof it!="object"){this.updateColors();return}const ct=Object.keys(it);ct.forEach(dt=>{this[dt]=it[dt]}),this.updateColors(),ct.forEach(dt=>{this[dt]=it[dt]})}},__name(Lo,"Theme"),Lo),getThemeVariables4=__name(rt=>{const it=new Theme4;return it.calculate(rt),it},"getThemeVariables"),So,Theme5=(So=class{constructor(){this.primaryColor="#eee",this.contrast="#707070",this.secondaryColor=lighten(this.contrast,55),this.background="#ffffff",this.tertiaryColor=adjust(this.primaryColor,{h:-160}),this.primaryBorderColor=mkBorder(this.primaryColor,this.darkMode),this.secondaryBorderColor=mkBorder(this.secondaryColor,this.darkMode),this.tertiaryBorderColor=mkBorder(this.tertiaryColor,this.darkMode),this.primaryTextColor=invert(this.primaryColor),this.secondaryTextColor=invert(this.secondaryColor),this.tertiaryTextColor=invert(this.tertiaryColor),this.lineColor=invert(this.background),this.textColor=invert(this.background),this.mainBkg="#eee",this.secondBkg="calculated",this.lineColor="#666",this.border1="#999",this.border2="calculated",this.note="#ffa",this.text="#333",this.critical="#d42",this.done="#bbb",this.arrowheadColor="#333333",this.fontFamily='"trebuchet ms", verdana, arial, sans-serif',this.fontSize="16px",this.THEME_COLOR_LIMIT=12,this.nodeBkg="calculated",this.nodeBorder="calculated",this.clusterBkg="calculated",this.clusterBorder="calculated",this.defaultLinkColor="calculated",this.titleColor="calculated",this.edgeLabelBackground="white",this.actorBorder="calculated",this.actorBkg="calculated",this.actorTextColor="calculated",this.actorLineColor=this.actorBorder,this.signalColor="calculated",this.signalTextColor="calculated",this.labelBoxBkgColor="calculated",this.labelBoxBorderColor="calculated",this.labelTextColor="calculated",this.loopTextColor="calculated",this.noteBorderColor="calculated",this.noteBkgColor="calculated",this.noteTextColor="calculated",this.activationBorderColor="#666",this.activationBkgColor="#f4f4f4",this.sequenceNumberColor="white",this.sectionBkgColor="calculated",this.altSectionBkgColor="white",this.sectionBkgColor2="calculated",this.excludeBkgColor="#eeeeee",this.taskBorderColor="calculated",this.taskBkgColor="calculated",this.taskTextLightColor="white",this.taskTextColor="calculated",this.taskTextDarkColor="calculated",this.taskTextOutsideColor="calculated",this.taskTextClickableColor="#003163",this.activeTaskBorderColor="calculated",this.activeTaskBkgColor="calculated",this.gridColor="calculated",this.doneTaskBkgColor="calculated",this.doneTaskBorderColor="calculated",this.critBkgColor="calculated",this.critBorderColor="calculated",this.todayLineColor="calculated",this.vertLineColor="calculated",this.personBorder=this.primaryBorderColor,this.personBkg=this.mainBkg,this.archEdgeColor="calculated",this.archEdgeArrowColor="calculated",this.archEdgeWidth="3",this.archGroupBorderColor=this.primaryBorderColor,this.archGroupBorderWidth="2px",this.rowOdd=this.rowOdd||lighten(this.mainBkg,75)||"#ffffff",this.rowEven=this.rowEven||"#f4f4f4",this.labelColor="black",this.errorBkgColor="#552222",this.errorTextColor="#552222"}updateColors(){this.secondBkg=lighten(this.contrast,55),this.border2=this.contrast,this.actorBorder=lighten(this.border1,23),this.actorBkg=this.mainBkg,this.actorTextColor=this.text,this.actorLineColor=this.actorBorder,this.signalColor=this.text,this.signalTextColor=this.text,this.labelBoxBkgColor=this.actorBkg,this.labelBoxBorderColor=this.actorBorder,this.labelTextColor=this.text,this.loopTextColor=this.text,this.noteBorderColor="#999",this.noteBkgColor="#666",this.noteTextColor="#fff",this.cScale0=this.cScale0||"#555",this.cScale1=this.cScale1||"#F4F4F4",this.cScale2=this.cScale2||"#555",this.cScale3=this.cScale3||"#BBB",this.cScale4=this.cScale4||"#777",this.cScale5=this.cScale5||"#999",this.cScale6=this.cScale6||"#DDD",this.cScale7=this.cScale7||"#FFF",this.cScale8=this.cScale8||"#DDD",this.cScale9=this.cScale9||"#BBB",this.cScale10=this.cScale10||"#999",this.cScale11=this.cScale11||"#777";for(let it=0;it<this.THEME_COLOR_LIMIT;it++)this["cScaleInv"+it]=this["cScaleInv"+it]||invert(this["cScale"+it]);for(let it=0;it<this.THEME_COLOR_LIMIT;it++)this.darkMode?this["cScalePeer"+it]=this["cScalePeer"+it]||lighten(this["cScale"+it],10):this["cScalePeer"+it]=this["cScalePeer"+it]||darken(this["cScale"+it],10);this.scaleLabelColor=this.scaleLabelColor||(this.darkMode?"black":this.labelTextColor),this.cScaleLabel0=this.cScaleLabel0||this.cScale1,this.cScaleLabel2=this.cScaleLabel2||this.cScale1;for(let it=0;it<this.THEME_COLOR_LIMIT;it++)this["cScaleLabel"+it]=this["cScaleLabel"+it]||this.scaleLabelColor;for(let it=0;it<5;it++)this["surface"+it]=this["surface"+it]||adjust(this.mainBkg,{l:-(5+it*5)}),this["surfacePeer"+it]=this["surfacePeer"+it]||adjust(this.mainBkg,{l:-(8+it*5)});this.nodeBkg=this.mainBkg,this.nodeBorder=this.border1,this.clusterBkg=this.secondBkg,this.clusterBorder=this.border2,this.defaultLinkColor=this.lineColor,this.titleColor=this.text,this.sectionBkgColor=lighten(this.contrast,30),this.sectionBkgColor2=lighten(this.contrast,30),this.taskBorderColor=darken(this.contrast,10),this.taskBkgColor=this.contrast,this.taskTextColor=this.taskTextLightColor,this.taskTextDarkColor=this.text,this.taskTextOutsideColor=this.taskTextDarkColor,this.activeTaskBorderColor=this.taskBorderColor,this.activeTaskBkgColor=this.mainBkg,this.gridColor=lighten(this.border1,30),this.doneTaskBkgColor=this.done,this.doneTaskBorderColor=this.lineColor,this.critBkgColor=this.critical,this.critBorderColor=darken(this.critBkgColor,10),this.todayLineColor=this.critBkgColor,this.vertLineColor=this.critBkgColor,this.archEdgeColor=this.lineColor,this.archEdgeArrowColor=this.lineColor,this.transitionColor=this.transitionColor||"#000",this.transitionLabelColor=this.transitionLabelColor||this.textColor,this.stateLabelColor=this.stateLabelColor||this.stateBkg||this.primaryTextColor,this.stateBkg=this.stateBkg||this.mainBkg,this.labelBackgroundColor=this.labelBackgroundColor||this.stateBkg,this.compositeBackground=this.compositeBackground||this.background||this.tertiaryColor,this.altBackground=this.altBackground||"#f4f4f4",this.compositeTitleBackground=this.compositeTitleBackground||this.mainBkg,this.stateBorder=this.stateBorder||"#000",this.innerEndBackground=this.primaryBorderColor,this.specialStateColor="#222",this.errorBkgColor=this.errorBkgColor||this.tertiaryColor,this.errorTextColor=this.errorTextColor||this.tertiaryTextColor,this.classText=this.primaryTextColor,this.fillType0=this.primaryColor,this.fillType1=this.secondaryColor,this.fillType2=adjust(this.primaryColor,{h:64}),this.fillType3=adjust(this.secondaryColor,{h:64}),this.fillType4=adjust(this.primaryColor,{h:-64}),this.fillType5=adjust(this.secondaryColor,{h:-64}),this.fillType6=adjust(this.primaryColor,{h:128}),this.fillType7=adjust(this.secondaryColor,{h:128});for(let it=0;it<this.THEME_COLOR_LIMIT;it++)this["pie"+it]=this["cScale"+it];this.pie12=this.pie0,this.pieTitleTextSize=this.pieTitleTextSize||"25px",this.pieTitleTextColor=this.pieTitleTextColor||this.taskTextDarkColor,this.pieSectionTextSize=this.pieSectionTextSize||"17px",this.pieSectionTextColor=this.pieSectionTextColor||this.textColor,this.pieLegendTextSize=this.pieLegendTextSize||"17px",this.pieLegendTextColor=this.pieLegendTextColor||this.taskTextDarkColor,this.pieStrokeColor=this.pieStrokeColor||"black",this.pieStrokeWidth=this.pieStrokeWidth||"2px",this.pieOuterStrokeWidth=this.pieOuterStrokeWidth||"2px",this.pieOuterStrokeColor=this.pieOuterStrokeColor||"black",this.pieOpacity=this.pieOpacity||"0.7",this.quadrant1Fill=this.quadrant1Fill||this.primaryColor,this.quadrant2Fill=this.quadrant2Fill||adjust(this.primaryColor,{r:5,g:5,b:5}),this.quadrant3Fill=this.quadrant3Fill||adjust(this.primaryColor,{r:10,g:10,b:10}),this.quadrant4Fill=this.quadrant4Fill||adjust(this.primaryColor,{r:15,g:15,b:15}),this.quadrant1TextFill=this.quadrant1TextFill||this.primaryTextColor,this.quadrant2TextFill=this.quadrant2TextFill||adjust(this.primaryTextColor,{r:-5,g:-5,b:-5}),this.quadrant3TextFill=this.quadrant3TextFill||adjust(this.primaryTextColor,{r:-10,g:-10,b:-10}),this.quadrant4TextFill=this.quadrant4TextFill||adjust(this.primaryTextColor,{r:-15,g:-15,b:-15}),this.quadrantPointFill=this.quadrantPointFill||isDark(this.quadrant1Fill)?lighten(this.quadrant1Fill):darken(this.quadrant1Fill),this.quadrantPointTextFill=this.quadrantPointTextFill||this.primaryTextColor,this.quadrantXAxisTextFill=this.quadrantXAxisTextFill||this.primaryTextColor,this.quadrantYAxisTextFill=this.quadrantYAxisTextFill||this.primaryTextColor,this.quadrantInternalBorderStrokeFill=this.quadrantInternalBorderStrokeFill||this.primaryBorderColor,this.quadrantExternalBorderStrokeFill=this.quadrantExternalBorderStrokeFill||this.primaryBorderColor,this.quadrantTitleFill=this.quadrantTitleFill||this.primaryTextColor,this.xyChart={backgroundColor:this.xyChart?.backgroundColor||this.background,titleColor:this.xyChart?.titleColor||this.primaryTextColor,xAxisTitleColor:this.xyChart?.xAxisTitleColor||this.primaryTextColor,xAxisLabelColor:this.xyChart?.xAxisLabelColor||this.primaryTextColor,xAxisTickColor:this.xyChart?.xAxisTickColor||this.primaryTextColor,xAxisLineColor:this.xyChart?.xAxisLineColor||this.primaryTextColor,yAxisTitleColor:this.xyChart?.yAxisTitleColor||this.primaryTextColor,yAxisLabelColor:this.xyChart?.yAxisLabelColor||this.primaryTextColor,yAxisTickColor:this.xyChart?.yAxisTickColor||this.primaryTextColor,yAxisLineColor:this.xyChart?.yAxisLineColor||this.primaryTextColor,plotColorPalette:this.xyChart?.plotColorPalette||"#EEE,#6BB8E4,#8ACB88,#C7ACD6,#E8DCC2,#FFB2A8,#FFF380,#7E8D91,#FFD8B1,#FAF3E0"},this.radar={axisColor:this.radar?.axisColor||this.lineColor,axisStrokeWidth:this.radar?.axisStrokeWidth||2,axisLabelFontSize:this.radar?.axisLabelFontSize||12,curveOpacity:this.radar?.curveOpacity||.5,curveStrokeWidth:this.radar?.curveStrokeWidth||2,graticuleColor:this.radar?.graticuleColor||"#DEDEDE",graticuleStrokeWidth:this.radar?.graticuleStrokeWidth||1,graticuleOpacity:this.radar?.graticuleOpacity||.3,legendBoxSize:this.radar?.legendBoxSize||12,legendFontSize:this.radar?.legendFontSize||12},this.requirementBackground=this.requirementBackground||this.primaryColor,this.requirementBorderColor=this.requirementBorderColor||this.primaryBorderColor,this.requirementBorderSize=this.requirementBorderSize||"1",this.requirementTextColor=this.requirementTextColor||this.primaryTextColor,this.relationColor=this.relationColor||this.lineColor,this.relationLabelBackground=this.relationLabelBackground||this.edgeLabelBackground,this.relationLabelColor=this.relationLabelColor||this.actorTextColor,this.git0=darken(this.pie1,25)||this.primaryColor,this.git1=this.pie2||this.secondaryColor,this.git2=this.pie3||this.tertiaryColor,this.git3=this.pie4||adjust(this.primaryColor,{h:-30}),this.git4=this.pie5||adjust(this.primaryColor,{h:-60}),this.git5=this.pie6||adjust(this.primaryColor,{h:-90}),this.git6=this.pie7||adjust(this.primaryColor,{h:60}),this.git7=this.pie8||adjust(this.primaryColor,{h:120}),this.gitInv0=this.gitInv0||invert(this.git0),this.gitInv1=this.gitInv1||invert(this.git1),this.gitInv2=this.gitInv2||invert(this.git2),this.gitInv3=this.gitInv3||invert(this.git3),this.gitInv4=this.gitInv4||invert(this.git4),this.gitInv5=this.gitInv5||invert(this.git5),this.gitInv6=this.gitInv6||invert(this.git6),this.gitInv7=this.gitInv7||invert(this.git7),this.branchLabelColor=this.branchLabelColor||this.labelTextColor,this.gitBranchLabel0=this.branchLabelColor,this.gitBranchLabel1="white",this.gitBranchLabel2=this.branchLabelColor,this.gitBranchLabel3="white",this.gitBranchLabel4=this.branchLabelColor,this.gitBranchLabel5=this.branchLabelColor,this.gitBranchLabel6=this.branchLabelColor,this.gitBranchLabel7=this.branchLabelColor,this.tagLabelColor=this.tagLabelColor||this.primaryTextColor,this.tagLabelBackground=this.tagLabelBackground||this.primaryColor,this.tagLabelBorder=this.tagBorder||this.primaryBorderColor,this.tagLabelFontSize=this.tagLabelFontSize||"10px",this.commitLabelColor=this.commitLabelColor||this.secondaryTextColor,this.commitLabelBackground=this.commitLabelBackground||this.secondaryColor,this.commitLabelFontSize=this.commitLabelFontSize||"10px",this.attributeBackgroundColorOdd=this.attributeBackgroundColorOdd||oldAttributeBackgroundColorOdd,this.attributeBackgroundColorEven=this.attributeBackgroundColorEven||oldAttributeBackgroundColorEven}calculate(it){if(typeof it!="object"){this.updateColors();return}const ct=Object.keys(it);ct.forEach(dt=>{this[dt]=it[dt]}),this.updateColors(),ct.forEach(dt=>{this[dt]=it[dt]})}},__name(So,"Theme"),So),getThemeVariables5=__name(rt=>{const it=new Theme5;return it.calculate(rt),it},"getThemeVariables"),themes_default={base:{getThemeVariables},dark:{getThemeVariables:getThemeVariables2},default:{getThemeVariables:getThemeVariables3},forest:{getThemeVariables:getThemeVariables4},neutral:{getThemeVariables:getThemeVariables5}},config_schema_default={flowchart:{useMaxWidth:!0,titleTopMargin:25,subGraphTitleMargin:{top:0,bottom:0},diagramPadding:8,htmlLabels:!0,nodeSpacing:50,rankSpacing:50,curve:"basis",padding:15,defaultRenderer:"dagre-wrapper",wrappingWidth:200,inheritDir:!1},sequence:{useMaxWidth:!0,hideUnusedParticipants:!1,activationWidth:10,diagramMarginX:50,diagramMarginY:10,actorMargin:50,width:150,height:65,boxMargin:10,boxTextMargin:5,noteMargin:10,messageMargin:35,messageAlign:"center",mirrorActors:!0,forceMenus:!1,bottomMarginAdj:1,rightAngles:!1,showSequenceNumbers:!1,actorFontSize:14,actorFontFamily:'"Open Sans", sans-serif',actorFontWeight:400,noteFontSize:14,noteFontFamily:'"trebuchet ms", verdana, arial, sans-serif',noteFontWeight:400,noteAlign:"center",messageFontSize:16,messageFontFamily:'"trebuchet ms", verdana, arial, sans-serif',messageFontWeight:400,wrap:!1,wrapPadding:10,labelBoxWidth:50,labelBoxHeight:20},gantt:{useMaxWidth:!0,titleTopMargin:25,barHeight:20,barGap:4,topPadding:50,rightPadding:75,leftPadding:75,gridLineStartPadding:35,fontSize:11,sectionFontSize:11,numberSectionStyles:4,axisFormat:"%Y-%m-%d",topAxis:!1,displayMode:"",weekday:"sunday"},journey:{useMaxWidth:!0,diagramMarginX:50,diagramMarginY:10,leftMargin:150,maxLabelWidth:360,width:150,height:50,boxMargin:10,boxTextMargin:5,noteMargin:10,messageMargin:35,messageAlign:"center",bottomMarginAdj:1,rightAngles:!1,taskFontSize:14,taskFontFamily:'"Open Sans", sans-serif',taskMargin:50,activationWidth:10,textPlacement:"fo",actorColours:["#8FBC8F","#7CFC00","#00FFFF","#20B2AA","#B0E0E6","#FFFFE0"],sectionFills:["#191970","#8B008B","#4B0082","#2F4F4F","#800000","#8B4513","#00008B"],sectionColours:["#fff"],titleColor:"",titleFontFamily:'"trebuchet ms", verdana, arial, sans-serif',titleFontSize:"4ex"},class:{useMaxWidth:!0,titleTopMargin:25,arrowMarkerAbsolute:!1,dividerMargin:10,padding:5,textHeight:10,defaultRenderer:"dagre-wrapper",htmlLabels:!1,hideEmptyMembersBox:!1},state:{useMaxWidth:!0,titleTopMargin:25,dividerMargin:10,sizeUnit:5,padding:8,textHeight:10,titleShift:-15,noteMargin:10,forkWidth:70,forkHeight:7,miniPadding:2,fontSizeFactor:5.02,fontSize:24,labelHeight:16,edgeLengthFactor:"20",compositTitleSize:35,radius:5,defaultRenderer:"dagre-wrapper"},er:{useMaxWidth:!0,titleTopMargin:25,diagramPadding:20,layoutDirection:"TB",minEntityWidth:100,minEntityHeight:75,entityPadding:15,nodeSpacing:140,rankSpacing:80,stroke:"gray",fill:"honeydew",fontSize:12},pie:{useMaxWidth:!0,textPosition:.75},quadrantChart:{useMaxWidth:!0,chartWidth:500,chartHeight:500,titleFontSize:20,titlePadding:10,quadrantPadding:5,xAxisLabelPadding:5,yAxisLabelPadding:5,xAxisLabelFontSize:16,yAxisLabelFontSize:16,quadrantLabelFontSize:16,quadrantTextTopPadding:5,pointTextPadding:5,pointLabelFontSize:12,pointRadius:5,xAxisPosition:"top",yAxisPosition:"left",quadrantInternalBorderStrokeWidth:1,quadrantExternalBorderStrokeWidth:2},xyChart:{useMaxWidth:!0,width:700,height:500,titleFontSize:20,titlePadding:10,showDataLabel:!1,showTitle:!0,xAxis:{$ref:"#/$defs/XYChartAxisConfig",showLabel:!0,labelFontSize:14,labelPadding:5,showTitle:!0,titleFontSize:16,titlePadding:5,showTick:!0,tickLength:5,tickWidth:2,showAxisLine:!0,axisLineWidth:2},yAxis:{$ref:"#/$defs/XYChartAxisConfig",showLabel:!0,labelFontSize:14,labelPadding:5,showTitle:!0,titleFontSize:16,titlePadding:5,showTick:!0,tickLength:5,tickWidth:2,showAxisLine:!0,axisLineWidth:2},chartOrientation:"vertical",plotReservedSpacePercent:50},requirement:{useMaxWidth:!0,rect_fill:"#f9f9f9",text_color:"#333",rect_border_size:"0.5px",rect_border_color:"#bbb",rect_min_width:200,rect_min_height:200,fontSize:14,rect_padding:10,line_height:20},mindmap:{useMaxWidth:!0,padding:10,maxNodeWidth:200,layoutAlgorithm:"cose-bilkent"},kanban:{useMaxWidth:!0,padding:8,sectionWidth:200,ticketBaseUrl:""},timeline:{useMaxWidth:!0,diagramMarginX:50,diagramMarginY:10,leftMargin:150,width:150,height:50,boxMargin:10,boxTextMargin:5,noteMargin:10,messageMargin:35,messageAlign:"center",bottomMarginAdj:1,rightAngles:!1,taskFontSize:14,taskFontFamily:'"Open Sans", sans-serif',taskMargin:50,activationWidth:10,textPlacement:"fo",actorColours:["#8FBC8F","#7CFC00","#00FFFF","#20B2AA","#B0E0E6","#FFFFE0"],sectionFills:["#191970","#8B008B","#4B0082","#2F4F4F","#800000","#8B4513","#00008B"],sectionColours:["#fff"],disableMulticolor:!1},gitGraph:{useMaxWidth:!0,titleTopMargin:25,diagramPadding:8,nodeLabel:{width:75,height:100,x:-25,y:0},mainBranchName:"main",mainBranchOrder:0,showCommitLabel:!0,showBranches:!0,rotateCommitLabel:!0,parallelCommits:!1,arrowMarkerAbsolute:!1},c4:{useMaxWidth:!0,diagramMarginX:50,diagramMarginY:10,c4ShapeMargin:50,c4ShapePadding:20,width:216,height:60,boxMargin:10,c4ShapeInRow:4,nextLinePaddingX:0,c4BoundaryInRow:2,personFontSize:14,personFontFamily:'"Open Sans", sans-serif',personFontWeight:"normal",external_personFontSize:14,external_personFontFamily:'"Open Sans", sans-serif',external_personFontWeight:"normal",systemFontSize:14,systemFontFamily:'"Open Sans", sans-serif',systemFontWeight:"normal",external_systemFontSize:14,external_systemFontFamily:'"Open Sans", sans-serif',external_systemFontWeight:"normal",system_dbFontSize:14,system_dbFontFamily:'"Open Sans", sans-serif',system_dbFontWeight:"normal",external_system_dbFontSize:14,external_system_dbFontFamily:'"Open Sans", sans-serif',external_system_dbFontWeight:"normal",system_queueFontSize:14,system_queueFontFamily:'"Open Sans", sans-serif',system_queueFontWeight:"normal",external_system_queueFontSize:14,external_system_queueFontFamily:'"Open Sans", sans-serif',external_system_queueFontWeight:"normal",boundaryFontSize:14,boundaryFontFamily:'"Open Sans", sans-serif',boundaryFontWeight:"normal",messageFontSize:12,messageFontFamily:'"Open Sans", sans-serif',messageFontWeight:"normal",containerFontSize:14,containerFontFamily:'"Open Sans", sans-serif',containerFontWeight:"normal",external_containerFontSize:14,external_containerFontFamily:'"Open Sans", sans-serif',external_containerFontWeight:"normal",container_dbFontSize:14,container_dbFontFamily:'"Open Sans", sans-serif',container_dbFontWeight:"normal",external_container_dbFontSize:14,external_container_dbFontFamily:'"Open Sans", sans-serif',external_container_dbFontWeight:"normal",container_queueFontSize:14,container_queueFontFamily:'"Open Sans", sans-serif',container_queueFontWeight:"normal",external_container_queueFontSize:14,external_container_queueFontFamily:'"Open Sans", sans-serif',external_container_queueFontWeight:"normal",componentFontSize:14,componentFontFamily:'"Open Sans", sans-serif',componentFontWeight:"normal",external_componentFontSize:14,external_componentFontFamily:'"Open Sans", sans-serif',external_componentFontWeight:"normal",component_dbFontSize:14,component_dbFontFamily:'"Open Sans", sans-serif',component_dbFontWeight:"normal",external_component_dbFontSize:14,external_component_dbFontFamily:'"Open Sans", sans-serif',external_component_dbFontWeight:"normal",component_queueFontSize:14,component_queueFontFamily:'"Open Sans", sans-serif',component_queueFontWeight:"normal",external_component_queueFontSize:14,external_component_queueFontFamily:'"Open Sans", sans-serif',external_component_queueFontWeight:"normal",wrap:!0,wrapPadding:10,person_bg_color:"#08427B",person_border_color:"#073B6F",external_person_bg_color:"#686868",external_person_border_color:"#8A8A8A",system_bg_color:"#1168BD",system_border_color:"#3C7FC0",system_db_bg_color:"#1168BD",system_db_border_color:"#3C7FC0",system_queue_bg_color:"#1168BD",system_queue_border_color:"#3C7FC0",external_system_bg_color:"#999999",external_system_border_color:"#8A8A8A",external_system_db_bg_color:"#999999",external_system_db_border_color:"#8A8A8A",external_system_queue_bg_color:"#999999",external_system_queue_border_color:"#8A8A8A",container_bg_color:"#438DD5",container_border_color:"#3C7FC0",container_db_bg_color:"#438DD5",container_db_border_color:"#3C7FC0",container_queue_bg_color:"#438DD5",container_queue_border_color:"#3C7FC0",external_container_bg_color:"#B3B3B3",external_container_border_color:"#A6A6A6",external_container_db_bg_color:"#B3B3B3",external_container_db_border_color:"#A6A6A6",external_container_queue_bg_color:"#B3B3B3",external_container_queue_border_color:"#A6A6A6",component_bg_color:"#85BBF0",component_border_color:"#78A8D8",component_db_bg_color:"#85BBF0",component_db_border_color:"#78A8D8",component_queue_bg_color:"#85BBF0",component_queue_border_color:"#78A8D8",external_component_bg_color:"#CCCCCC",external_component_border_color:"#BFBFBF",external_component_db_bg_color:"#CCCCCC",external_component_db_border_color:"#BFBFBF",external_component_queue_bg_color:"#CCCCCC",external_component_queue_border_color:"#BFBFBF"},sankey:{useMaxWidth:!0,width:600,height:400,linkColor:"gradient",nodeAlignment:"justify",showValues:!0,prefix:"",suffix:""},block:{useMaxWidth:!0,padding:8},packet:{useMaxWidth:!0,rowHeight:32,bitWidth:32,bitsPerRow:32,showBits:!0,paddingX:5,paddingY:5},architecture:{useMaxWidth:!0,padding:40,iconSize:80,fontSize:16},radar:{useMaxWidth:!0,width:600,height:600,marginTop:50,marginRight:50,marginBottom:50,marginLeft:50,axisScaleFactor:1,axisLabelFactor:1.05,curveTension:.17},theme:"default",look:"classic",handDrawnSeed:0,layout:"dagre",maxTextSize:5e4,maxEdges:500,darkMode:!1,fontFamily:'"trebuchet ms", verdana, arial, sans-serif;',logLevel:5,securityLevel:"strict",startOnLoad:!0,arrowMarkerAbsolute:!1,secure:["secure","securityLevel","startOnLoad","maxTextSize","suppressErrorRendering","maxEdges"],legacyMathML:!1,forceLegacyMathML:!1,deterministicIds:!1,fontSize:16,markdownAutoWrap:!0,suppressErrorRendering:!1},config={...config_schema_default,deterministicIDSeed:void 0,elk:{mergeEdges:!1,nodePlacementStrategy:"BRANDES_KOEPF",forceNodeModelOrder:!1,considerModelOrder:"NODES_AND_EDGES"},themeCSS:void 0,themeVariables:themes_default.default.getThemeVariables(),sequence:{...config_schema_default.sequence,messageFont:__name(function(){return{fontFamily:this.messageFontFamily,fontSize:this.messageFontSize,fontWeight:this.messageFontWeight}},"messageFont"),noteFont:__name(function(){return{fontFamily:this.noteFontFamily,fontSize:this.noteFontSize,fontWeight:this.noteFontWeight}},"noteFont"),actorFont:__name(function(){return{fontFamily:this.actorFontFamily,fontSize:this.actorFontSize,fontWeight:this.actorFontWeight}},"actorFont")},class:{hideEmptyMembersBox:!1},gantt:{...config_schema_default.gantt,tickInterval:void 0,useWidth:void 0},c4:{...config_schema_default.c4,useWidth:void 0,personFont:__name(function(){return{fontFamily:this.personFontFamily,fontSize:this.personFontSize,fontWeight:this.personFontWeight}},"personFont"),flowchart:{...config_schema_default.flowchart,inheritDir:!1},external_personFont:__name(function(){return{fontFamily:this.external_personFontFamily,fontSize:this.external_personFontSize,fontWeight:this.external_personFontWeight}},"external_personFont"),systemFont:__name(function(){return{fontFamily:this.systemFontFamily,fontSize:this.systemFontSize,fontWeight:this.systemFontWeight}},"systemFont"),external_systemFont:__name(function(){return{fontFamily:this.external_systemFontFamily,fontSize:this.external_systemFontSize,fontWeight:this.external_systemFontWeight}},"external_systemFont"),system_dbFont:__name(function(){return{fontFamily:this.system_dbFontFamily,fontSize:this.system_dbFontSize,fontWeight:this.system_dbFontWeight}},"system_dbFont"),external_system_dbFont:__name(function(){return{fontFamily:this.external_system_dbFontFamily,fontSize:this.external_system_dbFontSize,fontWeight:this.external_system_dbFontWeight}},"external_system_dbFont"),system_queueFont:__name(function(){return{fontFamily:this.system_queueFontFamily,fontSize:this.system_queueFontSize,fontWeight:this.system_queueFontWeight}},"system_queueFont"),external_system_queueFont:__name(function(){return{fontFamily:this.external_system_queueFontFamily,fontSize:this.external_system_queueFontSize,fontWeight:this.external_system_queueFontWeight}},"external_system_queueFont"),containerFont:__name(function(){return{fontFamily:this.containerFontFamily,fontSize:this.containerFontSize,fontWeight:this.containerFontWeight}},"containerFont"),external_containerFont:__name(function(){return{fontFamily:this.external_containerFontFamily,fontSize:this.external_containerFontSize,fontWeight:this.external_containerFontWeight}},"external_containerFont"),container_dbFont:__name(function(){return{fontFamily:this.container_dbFontFamily,fontSize:this.container_dbFontSize,fontWeight:this.container_dbFontWeight}},"container_dbFont"),external_container_dbFont:__name(function(){return{fontFamily:this.external_container_dbFontFamily,fontSize:this.external_container_dbFontSize,fontWeight:this.external_container_dbFontWeight}},"external_container_dbFont"),container_queueFont:__name(function(){return{fontFamily:this.container_queueFontFamily,fontSize:this.container_queueFontSize,fontWeight:this.container_queueFontWeight}},"container_queueFont"),external_container_queueFont:__name(function(){return{fontFamily:this.external_container_queueFontFamily,fontSize:this.external_container_queueFontSize,fontWeight:this.external_container_queueFontWeight}},"external_container_queueFont"),componentFont:__name(function(){return{fontFamily:this.componentFontFamily,fontSize:this.componentFontSize,fontWeight:this.componentFontWeight}},"componentFont"),external_componentFont:__name(function(){return{fontFamily:this.external_componentFontFamily,fontSize:this.external_componentFontSize,fontWeight:this.external_componentFontWeight}},"external_componentFont"),component_dbFont:__name(function(){return{fontFamily:this.component_dbFontFamily,fontSize:this.component_dbFontSize,fontWeight:this.component_dbFontWeight}},"component_dbFont"),external_component_dbFont:__name(function(){return{fontFamily:this.external_component_dbFontFamily,fontSize:this.external_component_dbFontSize,fontWeight:this.external_component_dbFontWeight}},"external_component_dbFont"),component_queueFont:__name(function(){return{fontFamily:this.component_queueFontFamily,fontSize:this.component_queueFontSize,fontWeight:this.component_queueFontWeight}},"component_queueFont"),external_component_queueFont:__name(function(){return{fontFamily:this.external_component_queueFontFamily,fontSize:this.external_component_queueFontSize,fontWeight:this.external_component_queueFontWeight}},"external_component_queueFont"),boundaryFont:__name(function(){return{fontFamily:this.boundaryFontFamily,fontSize:this.boundaryFontSize,fontWeight:this.boundaryFontWeight}},"boundaryFont"),messageFont:__name(function(){return{fontFamily:this.messageFontFamily,fontSize:this.messageFontSize,fontWeight:this.messageFontWeight}},"messageFont")},pie:{...config_schema_default.pie,useWidth:984},xyChart:{...config_schema_default.xyChart,useWidth:void 0},requirement:{...config_schema_default.requirement,useWidth:void 0},packet:{...config_schema_default.packet},radar:{...config_schema_default.radar},treemap:{useMaxWidth:!0,padding:10,diagramPadding:8,showValues:!0,nodeWidth:100,nodeHeight:40,borderWidth:1,valueFontSize:12,labelFontSize:14,valueFormat:","}},keyify=__name((rt,it="")=>Object.keys(rt).reduce((ct,dt)=>Array.isArray(rt[dt])?ct:typeof rt[dt]=="object"&&rt[dt]!==null?[...ct,it+dt,...keyify(rt[dt],"")]:[...ct,it+dt],[]),"keyify"),configKeys=new Set(keyify(config,"")),defaultConfig_default=config,sanitizeDirective=__name(rt=>{if(log.debug("sanitizeDirective called with",rt),!(typeof rt!="object"||rt==null)){if(Array.isArray(rt)){rt.forEach(it=>sanitizeDirective(it));return}for(const it of Object.keys(rt)){if(log.debug("Checking key",it),it.startsWith("__")||it.includes("proto")||it.includes("constr")||!configKeys.has(it)||rt[it]==null){log.debug("sanitize deleting key: ",it),delete rt[it];continue}if(typeof rt[it]=="object"){log.debug("sanitizing object",it),sanitizeDirective(rt[it]);continue}const ct=["themeCSS","fontFamily","altFontFamily"];for(const dt of ct)it.includes(dt)&&(log.debug("sanitizing css option",it),rt[it]=sanitizeCss(rt[it]))}if(rt.themeVariables)for(const it of Object.keys(rt.themeVariables)){const ct=rt.themeVariables[it];ct?.match&&!ct.match(/^[\d "#%(),.;A-Za-z]+$/)&&(rt.themeVariables[it]="")}log.debug("After sanitization",rt)}},"sanitizeDirective"),sanitizeCss=__name(rt=>{let it=0,ct=0;for(const dt of rt){if(it<ct)return"{ /* ERROR: Unbalanced CSS */ }";dt==="{"?it++:dt==="}"&&ct++}return it!==ct?"{ /* ERROR: Unbalanced CSS */ }":rt},"sanitizeCss"),defaultConfig=Object.freeze(defaultConfig_default),siteConfig=assignWithDepth_default({},defaultConfig),configFromInitialize,directives=[],currentConfig=assignWithDepth_default({},defaultConfig),updateCurrentConfig=__name((rt,it)=>{let ct=assignWithDepth_default({},rt),dt={};for(const ut of it)sanitize(ut),dt=assignWithDepth_default(dt,ut);if(ct=assignWithDepth_default(ct,dt),dt.theme&&dt.theme in themes_default){const ut=assignWithDepth_default({},configFromInitialize),pt=assignWithDepth_default(ut.themeVariables||{},dt.themeVariables);ct.theme&&ct.theme in themes_default&&(ct.themeVariables=themes_default[ct.theme].getThemeVariables(pt))}return currentConfig=ct,checkConfig(currentConfig),currentConfig},"updateCurrentConfig"),setSiteConfig=__name(rt=>(siteConfig=assignWithDepth_default({},defaultConfig),siteConfig=assignWithDepth_default(siteConfig,rt),rt.theme&&themes_default[rt.theme]&&(siteConfig.themeVariables=themes_default[rt.theme].getThemeVariables(rt.themeVariables)),updateCurrentConfig(siteConfig,directives),siteConfig),"setSiteConfig"),saveConfigFromInitialize=__name(rt=>{configFromInitialize=assignWithDepth_default({},rt)},"saveConfigFromInitialize"),updateSiteConfig=__name(rt=>(siteConfig=assignWithDepth_default(siteConfig,rt),updateCurrentConfig(siteConfig,directives),siteConfig),"updateSiteConfig"),getSiteConfig=__name(()=>assignWithDepth_default({},siteConfig),"getSiteConfig"),setConfig=__name(rt=>(checkConfig(rt),assignWithDepth_default(currentConfig,rt),getConfig()),"setConfig"),getConfig=__name(()=>assignWithDepth_default({},currentConfig),"getConfig"),sanitize=__name(rt=>{rt&&(["secure",...siteConfig.secure??[]].forEach(it=>{Object.hasOwn(rt,it)&&(log.debug(`Denied attempt to modify a secure key ${it}`,rt[it]),delete rt[it])}),Object.keys(rt).forEach(it=>{it.startsWith("__")&&delete rt[it]}),Object.keys(rt).forEach(it=>{typeof rt[it]=="string"&&(rt[it].includes("<")||rt[it].includes(">")||rt[it].includes("url(data:"))&&delete rt[it],typeof rt[it]=="object"&&sanitize(rt[it])}))},"sanitize"),addDirective=__name(rt=>{sanitizeDirective(rt),rt.fontFamily&&!rt.themeVariables?.fontFamily&&(rt.themeVariables={...rt.themeVariables,fontFamily:rt.fontFamily}),directives.push(rt),updateCurrentConfig(siteConfig,directives)},"addDirective"),reset=__name((rt=siteConfig)=>{directives=[],updateCurrentConfig(rt,directives)},"reset"),ConfigWarning={LAZY_LOAD_DEPRECATED:"The configuration options lazyLoadedDiagrams and loadExternalDiagramsAtStartup are deprecated. Please use registerExternalDiagrams instead."},issuedWarnings={},issueWarning=__name(rt=>{issuedWarnings[rt]||(log.warn(ConfigWarning[rt]),issuedWarnings[rt]=!0)},"issueWarning"),checkConfig=__name(rt=>{rt&&(rt.lazyLoadedDiagrams||rt.loadExternalDiagramsAtStartup)&&issueWarning("LAZY_LOAD_DEPRECATED")},"checkConfig"),getUserDefinedConfig=__name(()=>{let rt={};configFromInitialize&&(rt=assignWithDepth_default(rt,configFromInitialize));for(const it of directives)rt=assignWithDepth_default(rt,it);return rt},"getUserDefinedConfig"),lineBreakRegex=/<br\s*\/?>/gi,getRows=__name(rt=>rt?breakToPlaceholder(rt).replace(/\\n/g,"#br#").split("#br#"):[""],"getRows"),setupDompurifyHooksIfNotSetup=(()=>{let rt=!1;return()=>{rt||(setupDompurifyHooks(),rt=!0)}})();function setupDompurifyHooks(){const rt="data-temp-href-target";purify.addHook("beforeSanitizeAttributes",it=>{it.tagName==="A"&&it.hasAttribute("target")&&it.setAttribute(rt,it.getAttribute("target")??"")}),purify.addHook("afterSanitizeAttributes",it=>{it.tagName==="A"&&it.hasAttribute(rt)&&(it.setAttribute("target",it.getAttribute(rt)??""),it.removeAttribute(rt),it.getAttribute("target")==="_blank"&&it.setAttribute("rel","noopener"))})}__name(setupDompurifyHooks,"setupDompurifyHooks");var removeScript=__name(rt=>(setupDompurifyHooksIfNotSetup(),purify.sanitize(rt)),"removeScript"),sanitizeMore=__name((rt,it)=>{if(it.flowchart?.htmlLabels!==!1){const ct=it.securityLevel;ct==="antiscript"||ct==="strict"?rt=removeScript(rt):ct!=="loose"&&(rt=breakToPlaceholder(rt),rt=rt.replace(/</g,"&lt;").replace(/>/g,"&gt;"),rt=rt.replace(/=/g,"&equals;"),rt=placeholderToBreak(rt))}return rt},"sanitizeMore"),sanitizeText=__name((rt,it)=>rt&&(it.dompurifyConfig?rt=purify.sanitize(sanitizeMore(rt,it),it.dompurifyConfig).toString():rt=purify.sanitize(sanitizeMore(rt,it),{FORBID_TAGS:["style"]}).toString(),rt),"sanitizeText"),sanitizeTextOrArray=__name((rt,it)=>typeof rt=="string"?sanitizeText(rt,it):rt.flat().map(ct=>sanitizeText(ct,it)),"sanitizeTextOrArray"),hasBreaks=__name(rt=>lineBreakRegex.test(rt),"hasBreaks"),splitBreaks=__name(rt=>rt.split(lineBreakRegex),"splitBreaks"),placeholderToBreak=__name(rt=>rt.replace(/#br#/g,"<br/>"),"placeholderToBreak"),breakToPlaceholder=__name(rt=>rt.replace(lineBreakRegex,"#br#"),"breakToPlaceholder"),getUrl=__name(rt=>{let it="";return rt&&(it=window.location.protocol+"//"+window.location.host+window.location.pathname+window.location.search,it=CSS.escape(it)),it},"getUrl"),evaluate=__name(rt=>!(rt===!1||["false","null","0"].includes(String(rt).trim().toLowerCase())),"evaluate"),getMax=__name(function(...rt){const it=rt.filter(ct=>!isNaN(ct));return Math.max(...it)},"getMax"),getMin=__name(function(...rt){const it=rt.filter(ct=>!isNaN(ct));return Math.min(...it)},"getMin"),parseGenericTypes=__name(function(rt){const it=rt.split(/(,)/),ct=[];for(let dt=0;dt<it.length;dt++){let ut=it[dt];if(ut===","&&dt>0&&dt+1<it.length){const pt=it[dt-1],yt=it[dt+1];shouldCombineSets(pt,yt)&&(ut=pt+","+yt,dt++,ct.pop())}ct.push(processSet(ut))}return ct.join("")},"parseGenericTypes"),countOccurrence=__name((rt,it)=>Math.max(0,rt.split(it).length-1),"countOccurrence"),shouldCombineSets=__name((rt,it)=>{const ct=countOccurrence(rt,"~"),dt=countOccurrence(it,"~");return ct===1&&dt===1},"shouldCombineSets"),processSet=__name(rt=>{const it=countOccurrence(rt,"~");let ct=!1;if(it<=1)return rt;it%2!==0&&rt.startsWith("~")&&(rt=rt.substring(1),ct=!0);const dt=[...rt];let ut=dt.indexOf("~"),pt=dt.lastIndexOf("~");for(;ut!==-1&&pt!==-1&&ut!==pt;)dt[ut]="<",dt[pt]=">",ut=dt.indexOf("~"),pt=dt.lastIndexOf("~");return ct&&dt.unshift("~"),dt.join("")},"processSet"),isMathMLSupported=__name(()=>window.MathMLElement!==void 0,"isMathMLSupported"),katexRegex=/\$\$(.*)\$\$/g,hasKatex=__name(rt=>(rt.match(katexRegex)?.length??0)>0,"hasKatex"),calculateMathMLDimensions=__name(async(rt,it)=>{const ct=document.createElement("div");ct.innerHTML=await renderKatexSanitized(rt,it),ct.id="katex-temp",ct.style.visibility="hidden",ct.style.position="absolute",ct.style.top="0",document.querySelector("body")?.insertAdjacentElement("beforeend",ct);const ut={width:ct.clientWidth,height:ct.clientHeight};return ct.remove(),ut},"calculateMathMLDimensions"),renderKatexUnsanitized=__name(async(rt,it)=>{if(!hasKatex(rt))return rt;if(!(isMathMLSupported()||it.legacyMathML||it.forceLegacyMathML))return rt.replace(katexRegex,"MathML is unsupported in this environment.");{const{default:ct}=await __vitePreload(async()=>{const{default:ut}=await import("./katex-CbqxIyal.js");return{default:ut}},[]),dt=it.forceLegacyMathML||!isMathMLSupported()&&it.legacyMathML?"htmlAndMathml":"mathml";return rt.split(lineBreakRegex).map(ut=>hasKatex(ut)?`<div style="display: flex; align-items: center; justify-content: center; white-space: nowrap;">${ut}</div>`:`<div>${ut}</div>`).join("").replace(katexRegex,(ut,pt)=>ct.renderToString(pt,{throwOnError:!0,displayMode:!0,output:dt}).replace(/\n/g," ").replace(/<annotation.*<\/annotation>/g,""))}},"renderKatexUnsanitized"),renderKatexSanitized=__name(async(rt,it)=>sanitizeText(await renderKatexUnsanitized(rt,it),it),"renderKatexSanitized"),common_default={getRows,sanitizeText,sanitizeTextOrArray,hasBreaks,splitBreaks,lineBreakRegex,removeScript,getUrl,evaluate,getMax,getMin},d3Attrs=__name(function(rt,it){for(let ct of it)rt.attr(ct[0],ct[1])},"d3Attrs"),calculateSvgSizeAttrs=__name(function(rt,it,ct){let dt=new Map;return ct?(dt.set("width","100%"),dt.set("style",`max-width: ${it}px;`)):(dt.set("height",rt),dt.set("width",it)),dt},"calculateSvgSizeAttrs"),configureSvgSize=__name(function(rt,it,ct,dt){const ut=calculateSvgSizeAttrs(it,ct,dt);d3Attrs(rt,ut)},"configureSvgSize"),setupGraphViewbox=__name(function(rt,it,ct,dt){const ut=it.node().getBBox(),pt=ut.width,yt=ut.height;log.info(`SVG bounds: ${pt}x${yt}`,ut);let ft=0,mt=0;log.info(`Graph bounds: ${ft}x${mt}`,rt),ft=pt+ct*2,mt=yt+ct*2,log.info(`Calculated bounds: ${ft}x${mt}`),configureSvgSize(it,mt,ft,dt);const kt=`${ut.x-ct} ${ut.y-ct} ${ut.width+2*ct} ${ut.height+2*ct}`;it.attr("viewBox",kt)},"setupGraphViewbox"),themes={},getStyles=__name((rt,it,ct)=>{let dt="";return rt in themes&&themes[rt]?dt=themes[rt](ct):log.warn(`No theme found for ${rt}`),` & {
-    font-family: ${ct.fontFamily};
-    font-size: ${ct.fontSize};
-    fill: ${ct.textColor}
-  }
-  @keyframes edge-animation-frame {
-    from {
-      stroke-dashoffset: 0;
-    }
-  }
-  @keyframes dash {
-    to {
-      stroke-dashoffset: 0;
-    }
-  }
-  & .edge-animation-slow {
-    stroke-dasharray: 9,5 !important;
-    stroke-dashoffset: 900;
-    animation: dash 50s linear infinite;
-    stroke-linecap: round;
-  }
-  & .edge-animation-fast {
-    stroke-dasharray: 9,5 !important;
-    stroke-dashoffset: 900;
-    animation: dash 20s linear infinite;
-    stroke-linecap: round;
-  }
-  /* Classes common for multiple diagrams */
-
-  & .error-icon {
-    fill: ${ct.errorBkgColor};
-  }
-  & .error-text {
-    fill: ${ct.errorTextColor};
-    stroke: ${ct.errorTextColor};
-  }
-
-  & .edge-thickness-normal {
-    stroke-width: 1px;
-  }
-  & .edge-thickness-thick {
-    stroke-width: 3.5px
-  }
-  & .edge-pattern-solid {
-    stroke-dasharray: 0;
-  }
-  & .edge-thickness-invisible {
-    stroke-width: 0;
-    fill: none;
-  }
-  & .edge-pattern-dashed{
-    stroke-dasharray: 3;
-  }
-  .edge-pattern-dotted {
-    stroke-dasharray: 2;
-  }
-
-  & .marker {
-    fill: ${ct.lineColor};
-    stroke: ${ct.lineColor};
-  }
-  & .marker.cross {
-    stroke: ${ct.lineColor};
-  }
-
-  & svg {
-    font-family: ${ct.fontFamily};
-    font-size: ${ct.fontSize};
-  }
-   & p {
-    margin: 0
-   }
-
-  ${dt}
-
-  ${it}
-`},"getStyles"),addStylesForDiagram=__name((rt,it)=>{it!==void 0&&(themes[rt]=it)},"addStylesForDiagram"),styles_default=getStyles,commonDb_exports={};__export$1(commonDb_exports,{clear:()=>clear$2,getAccDescription:()=>getAccDescription,getAccTitle:()=>getAccTitle,getDiagramTitle:()=>getDiagramTitle,setAccDescription:()=>setAccDescription,setAccTitle:()=>setAccTitle,setDiagramTitle:()=>setDiagramTitle});var accTitle="",diagramTitle="",accDescription="",sanitizeText2=__name(rt=>sanitizeText(rt,getConfig()),"sanitizeText"),clear$2=__name(()=>{accTitle="",accDescription="",diagramTitle=""},"clear"),setAccTitle=__name(rt=>{accTitle=sanitizeText2(rt).replace(/^\s+/g,"")},"setAccTitle"),getAccTitle=__name(()=>accTitle,"getAccTitle"),setAccDescription=__name(rt=>{accDescription=sanitizeText2(rt).replace(/\n\s+/g,`
-`)},"setAccDescription"),getAccDescription=__name(()=>accDescription,"getAccDescription"),setDiagramTitle=__name(rt=>{diagramTitle=sanitizeText2(rt)},"setDiagramTitle"),getDiagramTitle=__name(()=>diagramTitle,"getDiagramTitle"),log2=log,setLogLevel2=setLogLevel,getConfig2=getConfig,setConfig2=setConfig,defaultConfig2=defaultConfig,sanitizeText3=__name(rt=>sanitizeText(rt,getConfig2()),"sanitizeText"),setupGraphViewbox2=setupGraphViewbox,getCommonDb=__name(()=>commonDb_exports,"getCommonDb"),diagrams={},registerDiagram=__name((rt,it,ct)=>{diagrams[rt]&&log2.warn(`Diagram with id ${rt} already registered. Overwriting.`),diagrams[rt]=it,ct&&addDetector(rt,ct),addStylesForDiagram(rt,it.styles),it.injectUtils?.(log2,setLogLevel2,getConfig2,sanitizeText3,setupGraphViewbox2,getCommonDb(),()=>{})},"registerDiagram"),getDiagram=__name(rt=>{if(rt in diagrams)return diagrams[rt];throw new DiagramNotFoundError(rt)},"getDiagram"),$o,DiagramNotFoundError=($o=class extends Error{constructor(it){super(`Diagram ${it} not found.`)}},__name($o,"DiagramNotFoundError"),$o),noop$1={value:()=>{}};function dispatch(){for(var rt=0,it=arguments.length,ct={},dt;rt<it;++rt){if(!(dt=arguments[rt]+"")||dt in ct||/[\s.]/.test(dt))throw new Error("illegal type: "+dt);ct[dt]=[]}return new Dispatch(ct)}function Dispatch(rt){this._=rt}function parseTypenames$1(rt,it){return rt.trim().split(/^|\s+/).map(function(ct){var dt="",ut=ct.indexOf(".");if(ut>=0&&(dt=ct.slice(ut+1),ct=ct.slice(0,ut)),ct&&!it.hasOwnProperty(ct))throw new Error("unknown type: "+ct);return{type:ct,name:dt}})}Dispatch.prototype=dispatch.prototype={constructor:Dispatch,on:function(rt,it){var ct=this._,dt=parseTypenames$1(rt+"",ct),ut,pt=-1,yt=dt.length;if(arguments.length<2){for(;++pt<yt;)if((ut=(rt=dt[pt]).type)&&(ut=get$2(ct[ut],rt.name)))return ut;return}if(it!=null&&typeof it!="function")throw new Error("invalid callback: "+it);for(;++pt<yt;)if(ut=(rt=dt[pt]).type)ct[ut]=set$2(ct[ut],rt.name,it);else if(it==null)for(ut in ct)ct[ut]=set$2(ct[ut],rt.name,null);return this},copy:function(){var rt={},it=this._;for(var ct in it)rt[ct]=it[ct].slice();return new Dispatch(rt)},call:function(rt,it){if((ut=arguments.length-2)>0)for(var ct=new Array(ut),dt=0,ut,pt;dt<ut;++dt)ct[dt]=arguments[dt+2];if(!this._.hasOwnProperty(rt))throw new Error("unknown type: "+rt);for(pt=this._[rt],dt=0,ut=pt.length;dt<ut;++dt)pt[dt].value.apply(it,ct)},apply:function(rt,it,ct){if(!this._.hasOwnProperty(rt))throw new Error("unknown type: "+rt);for(var dt=this._[rt],ut=0,pt=dt.length;ut<pt;++ut)dt[ut].value.apply(it,ct)}};function get$2(rt,it){for(var ct=0,dt=rt.length,ut;ct<dt;++ct)if((ut=rt[ct]).name===it)return ut.value}function set$2(rt,it,ct){for(var dt=0,ut=rt.length;dt<ut;++dt)if(rt[dt].name===it){rt[dt]=noop$1,rt=rt.slice(0,dt).concat(rt.slice(dt+1));break}return ct!=null&&rt.push({name:it,value:ct}),rt}var xhtml="http://www.w3.org/1999/xhtml";const namespaces={svg:"http://www.w3.org/2000/svg",xhtml,xlink:"http://www.w3.org/1999/xlink",xml:"http://www.w3.org/XML/1998/namespace",xmlns:"http://www.w3.org/2000/xmlns/"};function namespace(rt){var it=rt+="",ct=it.indexOf(":");return ct>=0&&(it=rt.slice(0,ct))!=="xmlns"&&(rt=rt.slice(ct+1)),namespaces.hasOwnProperty(it)?{space:namespaces[it],local:rt}:rt}function creatorInherit(rt){return function(){var it=this.ownerDocument,ct=this.namespaceURI;return ct===xhtml&&it.documentElement.namespaceURI===xhtml?it.createElement(rt):it.createElementNS(ct,rt)}}function creatorFixed(rt){return function(){return this.ownerDocument.createElementNS(rt.space,rt.local)}}function creator(rt){var it=namespace(rt);return(it.local?creatorFixed:creatorInherit)(it)}function none(){}function selector(rt){return rt==null?none:function(){return this.querySelector(rt)}}function selection_select(rt){typeof rt!="function"&&(rt=selector(rt));for(var it=this._groups,ct=it.length,dt=new Array(ct),ut=0;ut<ct;++ut)for(var pt=it[ut],yt=pt.length,ft=dt[ut]=new Array(yt),mt,kt,_t=0;_t<yt;++_t)(mt=pt[_t])&&(kt=rt.call(mt,mt.__data__,_t,pt))&&("__data__"in mt&&(kt.__data__=mt.__data__),ft[_t]=kt);return new Selection$1(dt,this._parents)}function array$1(rt){return rt==null?[]:Array.isArray(rt)?rt:Array.from(rt)}function empty(){return[]}function selectorAll(rt){return rt==null?empty:function(){return this.querySelectorAll(rt)}}function arrayAll(rt){return function(){return array$1(rt.apply(this,arguments))}}function selection_selectAll(rt){typeof rt=="function"?rt=arrayAll(rt):rt=selectorAll(rt);for(var it=this._groups,ct=it.length,dt=[],ut=[],pt=0;pt<ct;++pt)for(var yt=it[pt],ft=yt.length,mt,kt=0;kt<ft;++kt)(mt=yt[kt])&&(dt.push(rt.call(mt,mt.__data__,kt,yt)),ut.push(mt));return new Selection$1(dt,ut)}function matcher(rt){return function(){return this.matches(rt)}}function childMatcher(rt){return function(it){return it.matches(rt)}}var find=Array.prototype.find;function childFind(rt){return function(){return find.call(this.children,rt)}}function childFirst(){return this.firstElementChild}function selection_selectChild(rt){return this.select(rt==null?childFirst:childFind(typeof rt=="function"?rt:childMatcher(rt)))}var filter=Array.prototype.filter;function children(){return Array.from(this.children)}function childrenFilter(rt){return function(){return filter.call(this.children,rt)}}function selection_selectChildren(rt){return this.selectAll(rt==null?children:childrenFilter(typeof rt=="function"?rt:childMatcher(rt)))}function selection_filter(rt){typeof rt!="function"&&(rt=matcher(rt));for(var it=this._groups,ct=it.length,dt=new Array(ct),ut=0;ut<ct;++ut)for(var pt=it[ut],yt=pt.length,ft=dt[ut]=[],mt,kt=0;kt<yt;++kt)(mt=pt[kt])&&rt.call(mt,mt.__data__,kt,pt)&&ft.push(mt);return new Selection$1(dt,this._parents)}function sparse(rt){return new Array(rt.length)}function selection_enter(){return new Selection$1(this._enter||this._groups.map(sparse),this._parents)}function EnterNode(rt,it){this.ownerDocument=rt.ownerDocument,this.namespaceURI=rt.namespaceURI,this._next=null,this._parent=rt,this.__data__=it}EnterNode.prototype={constructor:EnterNode,appendChild:function(rt){return this._parent.insertBefore(rt,this._next)},insertBefore:function(rt,it){return this._parent.insertBefore(rt,it)},querySelector:function(rt){return this._parent.querySelector(rt)},querySelectorAll:function(rt){return this._parent.querySelectorAll(rt)}};function constant$3(rt){return function(){return rt}}function bindIndex(rt,it,ct,dt,ut,pt){for(var yt=0,ft,mt=it.length,kt=pt.length;yt<kt;++yt)(ft=it[yt])?(ft.__data__=pt[yt],dt[yt]=ft):ct[yt]=new EnterNode(rt,pt[yt]);for(;yt<mt;++yt)(ft=it[yt])&&(ut[yt]=ft)}function bindKey(rt,it,ct,dt,ut,pt,yt){var ft,mt,kt=new Map,_t=it.length,vt=pt.length,bt=new Array(_t),Mt;for(ft=0;ft<_t;++ft)(mt=it[ft])&&(bt[ft]=Mt=yt.call(mt,mt.__data__,ft,it)+"",kt.has(Mt)?ut[ft]=mt:kt.set(Mt,mt));for(ft=0;ft<vt;++ft)Mt=yt.call(rt,pt[ft],ft,pt)+"",(mt=kt.get(Mt))?(dt[ft]=mt,mt.__data__=pt[ft],kt.delete(Mt)):ct[ft]=new EnterNode(rt,pt[ft]);for(ft=0;ft<_t;++ft)(mt=it[ft])&&kt.get(bt[ft])===mt&&(ut[ft]=mt)}function datum(rt){return rt.__data__}function selection_data(rt,it){if(!arguments.length)return Array.from(this,datum);var ct=it?bindKey:bindIndex,dt=this._parents,ut=this._groups;typeof rt!="function"&&(rt=constant$3(rt));for(var pt=ut.length,yt=new Array(pt),ft=new Array(pt),mt=new Array(pt),kt=0;kt<pt;++kt){var _t=dt[kt],vt=ut[kt],bt=vt.length,Mt=arraylike(rt.call(_t,_t&&_t.__data__,kt,dt)),wt=Mt.length,St=ft[kt]=new Array(wt),It=yt[kt]=new Array(wt),Nt=mt[kt]=new Array(bt);ct(_t,vt,St,It,Nt,Mt,it);for(var $t=0,Et=0,Ft,qt;$t<wt;++$t)if(Ft=St[$t]){for($t>=Et&&(Et=$t+1);!(qt=It[Et])&&++Et<wt;);Ft._next=qt||null}}return yt=new Selection$1(yt,dt),yt._enter=ft,yt._exit=mt,yt}function arraylike(rt){return typeof rt=="object"&&"length"in rt?rt:Array.from(rt)}function selection_exit(){return new Selection$1(this._exit||this._groups.map(sparse),this._parents)}function selection_join(rt,it,ct){var dt=this.enter(),ut=this,pt=this.exit();return typeof rt=="function"?(dt=rt(dt),dt&&(dt=dt.selection())):dt=dt.append(rt+""),it!=null&&(ut=it(ut),ut&&(ut=ut.selection())),ct==null?pt.remove():ct(pt),dt&&ut?dt.merge(ut).order():ut}function selection_merge(rt){for(var it=rt.selection?rt.selection():rt,ct=this._groups,dt=it._groups,ut=ct.length,pt=dt.length,yt=Math.min(ut,pt),ft=new Array(ut),mt=0;mt<yt;++mt)for(var kt=ct[mt],_t=dt[mt],vt=kt.length,bt=ft[mt]=new Array(vt),Mt,wt=0;wt<vt;++wt)(Mt=kt[wt]||_t[wt])&&(bt[wt]=Mt);for(;mt<ut;++mt)ft[mt]=ct[mt];return new Selection$1(ft,this._parents)}function selection_order(){for(var rt=this._groups,it=-1,ct=rt.length;++it<ct;)for(var dt=rt[it],ut=dt.length-1,pt=dt[ut],yt;--ut>=0;)(yt=dt[ut])&&(pt&&yt.compareDocumentPosition(pt)^4&&pt.parentNode.insertBefore(yt,pt),pt=yt);return this}function selection_sort(rt){rt||(rt=ascending);function it(vt,bt){return vt&&bt?rt(vt.__data__,bt.__data__):!vt-!bt}for(var ct=this._groups,dt=ct.length,ut=new Array(dt),pt=0;pt<dt;++pt){for(var yt=ct[pt],ft=yt.length,mt=ut[pt]=new Array(ft),kt,_t=0;_t<ft;++_t)(kt=yt[_t])&&(mt[_t]=kt);mt.sort(it)}return new Selection$1(ut,this._parents).order()}function ascending(rt,it){return rt<it?-1:rt>it?1:rt>=it?0:NaN}function selection_call(){var rt=arguments[0];return arguments[0]=this,rt.apply(null,arguments),this}function selection_nodes(){return Array.from(this)}function selection_node(){for(var rt=this._groups,it=0,ct=rt.length;it<ct;++it)for(var dt=rt[it],ut=0,pt=dt.length;ut<pt;++ut){var yt=dt[ut];if(yt)return yt}return null}function selection_size(){let rt=0;for(const it of this)++rt;return rt}function selection_empty(){return!this.node()}function selection_each(rt){for(var it=this._groups,ct=0,dt=it.length;ct<dt;++ct)for(var ut=it[ct],pt=0,yt=ut.length,ft;pt<yt;++pt)(ft=ut[pt])&&rt.call(ft,ft.__data__,pt,ut);return this}function attrRemove$1(rt){return function(){this.removeAttribute(rt)}}function attrRemoveNS$1(rt){return function(){this.removeAttributeNS(rt.space,rt.local)}}function attrConstant$1(rt,it){return function(){this.setAttribute(rt,it)}}function attrConstantNS$1(rt,it){return function(){this.setAttributeNS(rt.space,rt.local,it)}}function attrFunction$1(rt,it){return function(){var ct=it.apply(this,arguments);ct==null?this.removeAttribute(rt):this.setAttribute(rt,ct)}}function attrFunctionNS$1(rt,it){return function(){var ct=it.apply(this,arguments);ct==null?this.removeAttributeNS(rt.space,rt.local):this.setAttributeNS(rt.space,rt.local,ct)}}function selection_attr(rt,it){var ct=namespace(rt);if(arguments.length<2){var dt=this.node();return ct.local?dt.getAttributeNS(ct.space,ct.local):dt.getAttribute(ct)}return this.each((it==null?ct.local?attrRemoveNS$1:attrRemove$1:typeof it=="function"?ct.local?attrFunctionNS$1:attrFunction$1:ct.local?attrConstantNS$1:attrConstant$1)(ct,it))}function defaultView(rt){return rt.ownerDocument&&rt.ownerDocument.defaultView||rt.document&&rt||rt.defaultView}function styleRemove$1(rt){return function(){this.style.removeProperty(rt)}}function styleConstant$1(rt,it,ct){return function(){this.style.setProperty(rt,it,ct)}}function styleFunction$1(rt,it,ct){return function(){var dt=it.apply(this,arguments);dt==null?this.style.removeProperty(rt):this.style.setProperty(rt,dt,ct)}}function selection_style(rt,it,ct){return arguments.length>1?this.each((it==null?styleRemove$1:typeof it=="function"?styleFunction$1:styleConstant$1)(rt,it,ct??"")):styleValue(this.node(),rt)}function styleValue(rt,it){return rt.style.getPropertyValue(it)||defaultView(rt).getComputedStyle(rt,null).getPropertyValue(it)}function propertyRemove(rt){return function(){delete this[rt]}}function propertyConstant(rt,it){return function(){this[rt]=it}}function propertyFunction(rt,it){return function(){var ct=it.apply(this,arguments);ct==null?delete this[rt]:this[rt]=ct}}function selection_property(rt,it){return arguments.length>1?this.each((it==null?propertyRemove:typeof it=="function"?propertyFunction:propertyConstant)(rt,it)):this.node()[rt]}function classArray(rt){return rt.trim().split(/^|\s+/)}function classList(rt){return rt.classList||new ClassList(rt)}function ClassList(rt){this._node=rt,this._names=classArray(rt.getAttribute("class")||"")}ClassList.prototype={add:function(rt){var it=this._names.indexOf(rt);it<0&&(this._names.push(rt),this._node.setAttribute("class",this._names.join(" ")))},remove:function(rt){var it=this._names.indexOf(rt);it>=0&&(this._names.splice(it,1),this._node.setAttribute("class",this._names.join(" ")))},contains:function(rt){return this._names.indexOf(rt)>=0}};function classedAdd(rt,it){for(var ct=classList(rt),dt=-1,ut=it.length;++dt<ut;)ct.add(it[dt])}function classedRemove(rt,it){for(var ct=classList(rt),dt=-1,ut=it.length;++dt<ut;)ct.remove(it[dt])}function classedTrue(rt){return function(){classedAdd(this,rt)}}function classedFalse(rt){return function(){classedRemove(this,rt)}}function classedFunction(rt,it){return function(){(it.apply(this,arguments)?classedAdd:classedRemove)(this,rt)}}function selection_classed(rt,it){var ct=classArray(rt+"");if(arguments.length<2){for(var dt=classList(this.node()),ut=-1,pt=ct.length;++ut<pt;)if(!dt.contains(ct[ut]))return!1;return!0}return this.each((typeof it=="function"?classedFunction:it?classedTrue:classedFalse)(ct,it))}function textRemove(){this.textContent=""}function textConstant$1(rt){return function(){this.textContent=rt}}function textFunction$1(rt){return function(){var it=rt.apply(this,arguments);this.textContent=it??""}}function selection_text(rt){return arguments.length?this.each(rt==null?textRemove:(typeof rt=="function"?textFunction$1:textConstant$1)(rt)):this.node().textContent}function htmlRemove(){this.innerHTML=""}function htmlConstant(rt){return function(){this.innerHTML=rt}}function htmlFunction(rt){return function(){var it=rt.apply(this,arguments);this.innerHTML=it??""}}function selection_html(rt){return arguments.length?this.each(rt==null?htmlRemove:(typeof rt=="function"?htmlFunction:htmlConstant)(rt)):this.node().innerHTML}function raise(){this.nextSibling&&this.parentNode.appendChild(this)}function selection_raise(){return this.each(raise)}function lower(){this.previousSibling&&this.parentNode.insertBefore(this,this.parentNode.firstChild)}function selection_lower(){return this.each(lower)}function selection_append(rt){var it=typeof rt=="function"?rt:creator(rt);return this.select(function(){return this.appendChild(it.apply(this,arguments))})}function constantNull(){return null}function selection_insert(rt,it){var ct=typeof rt=="function"?rt:creator(rt),dt=it==null?constantNull:typeof it=="function"?it:selector(it);return this.select(function(){return this.insertBefore(ct.apply(this,arguments),dt.apply(this,arguments)||null)})}function remove(){var rt=this.parentNode;rt&&rt.removeChild(this)}function selection_remove(){return this.each(remove)}function selection_cloneShallow(){var rt=this.cloneNode(!1),it=this.parentNode;return it?it.insertBefore(rt,this.nextSibling):rt}function selection_cloneDeep(){var rt=this.cloneNode(!0),it=this.parentNode;return it?it.insertBefore(rt,this.nextSibling):rt}function selection_clone(rt){return this.select(rt?selection_cloneDeep:selection_cloneShallow)}function selection_datum(rt){return arguments.length?this.property("__data__",rt):this.node().__data__}function contextListener(rt){return function(it){rt.call(this,it,this.__data__)}}function parseTypenames(rt){return rt.trim().split(/^|\s+/).map(function(it){var ct="",dt=it.indexOf(".");return dt>=0&&(ct=it.slice(dt+1),it=it.slice(0,dt)),{type:it,name:ct}})}function onRemove(rt){return function(){var it=this.__on;if(it){for(var ct=0,dt=-1,ut=it.length,pt;ct<ut;++ct)pt=it[ct],(!rt.type||pt.type===rt.type)&&pt.name===rt.name?this.removeEventListener(pt.type,pt.listener,pt.options):it[++dt]=pt;++dt?it.length=dt:delete this.__on}}}function onAdd(rt,it,ct){return function(){var dt=this.__on,ut,pt=contextListener(it);if(dt){for(var yt=0,ft=dt.length;yt<ft;++yt)if((ut=dt[yt]).type===rt.type&&ut.name===rt.name){this.removeEventListener(ut.type,ut.listener,ut.options),this.addEventListener(ut.type,ut.listener=pt,ut.options=ct),ut.value=it;return}}this.addEventListener(rt.type,pt,ct),ut={type:rt.type,name:rt.name,value:it,listener:pt,options:ct},dt?dt.push(ut):this.__on=[ut]}}function selection_on(rt,it,ct){var dt=parseTypenames(rt+""),ut,pt=dt.length,yt;if(arguments.length<2){var ft=this.node().__on;if(ft){for(var mt=0,kt=ft.length,_t;mt<kt;++mt)for(ut=0,_t=ft[mt];ut<pt;++ut)if((yt=dt[ut]).type===_t.type&&yt.name===_t.name)return _t.value}return}for(ft=it?onAdd:onRemove,ut=0;ut<pt;++ut)this.each(ft(dt[ut],it,ct));return this}function dispatchEvent(rt,it,ct){var dt=defaultView(rt),ut=dt.CustomEvent;typeof ut=="function"?ut=new ut(it,ct):(ut=dt.document.createEvent("Event"),ct?(ut.initEvent(it,ct.bubbles,ct.cancelable),ut.detail=ct.detail):ut.initEvent(it,!1,!1)),rt.dispatchEvent(ut)}function dispatchConstant(rt,it){return function(){return dispatchEvent(this,rt,it)}}function dispatchFunction(rt,it){return function(){return dispatchEvent(this,rt,it.apply(this,arguments))}}function selection_dispatch(rt,it){return this.each((typeof it=="function"?dispatchFunction:dispatchConstant)(rt,it))}function*selection_iterator(){for(var rt=this._groups,it=0,ct=rt.length;it<ct;++it)for(var dt=rt[it],ut=0,pt=dt.length,yt;ut<pt;++ut)(yt=dt[ut])&&(yield yt)}var root$1=[null];function Selection$1(rt,it){this._groups=rt,this._parents=it}function selection(){return new Selection$1([[document.documentElement]],root$1)}function selection_selection(){return this}Selection$1.prototype=selection.prototype={constructor:Selection$1,select:selection_select,selectAll:selection_selectAll,selectChild:selection_selectChild,selectChildren:selection_selectChildren,filter:selection_filter,data:selection_data,enter:selection_enter,exit:selection_exit,join:selection_join,merge:selection_merge,selection:selection_selection,order:selection_order,sort:selection_sort,call:selection_call,nodes:selection_nodes,node:selection_node,size:selection_size,empty:selection_empty,each:selection_each,attr:selection_attr,style:selection_style,property:selection_property,classed:selection_classed,text:selection_text,html:selection_html,raise:selection_raise,lower:selection_lower,append:selection_append,insert:selection_insert,remove:selection_remove,clone:selection_clone,datum:selection_datum,on:selection_on,dispatch:selection_dispatch,[Symbol.iterator]:selection_iterator};function select(rt){return typeof rt=="string"?new Selection$1([[document.querySelector(rt)]],[document.documentElement]):new Selection$1([[rt]],root$1)}function define(rt,it,ct){rt.prototype=it.prototype=ct,ct.constructor=rt}function extend$1(rt,it){var ct=Object.create(rt.prototype);for(var dt in it)ct[dt]=it[dt];return ct}function Color(){}var darker=.7,brighter=1/darker,reI="\\s*([+-]?\\d+)\\s*",reN="\\s*([+-]?(?:\\d*\\.)?\\d+(?:[eE][+-]?\\d+)?)\\s*",reP="\\s*([+-]?(?:\\d*\\.)?\\d+(?:[eE][+-]?\\d+)?)%\\s*",reHex=/^#([0-9a-f]{3,8})$/,reRgbInteger=new RegExp(`^rgb\\(${reI},${reI},${reI}\\)$`),reRgbPercent=new RegExp(`^rgb\\(${reP},${reP},${reP}\\)$`),reRgbaInteger=new RegExp(`^rgba\\(${reI},${reI},${reI},${reN}\\)$`),reRgbaPercent=new RegExp(`^rgba\\(${reP},${reP},${reP},${reN}\\)$`),reHslPercent=new RegExp(`^hsl\\(${reN},${reP},${reP}\\)$`),reHslaPercent=new RegExp(`^hsla\\(${reN},${reP},${reP},${reN}\\)$`),named={aliceblue:15792383,antiquewhite:16444375,aqua:65535,aquamarine:8388564,azure:15794175,beige:16119260,bisque:16770244,black:0,blanchedalmond:16772045,blue:255,blueviolet:9055202,brown:10824234,burlywood:14596231,cadetblue:6266528,chartreuse:8388352,chocolate:13789470,coral:16744272,cornflowerblue:6591981,cornsilk:16775388,crimson:14423100,cyan:65535,darkblue:139,darkcyan:35723,darkgoldenrod:12092939,darkgray:11119017,darkgreen:25600,darkgrey:11119017,darkkhaki:12433259,darkmagenta:9109643,darkolivegreen:5597999,darkorange:16747520,darkorchid:10040012,darkred:9109504,darksalmon:15308410,darkseagreen:9419919,darkslateblue:4734347,darkslategray:3100495,darkslategrey:3100495,darkturquoise:52945,darkviolet:9699539,deeppink:16716947,deepskyblue:49151,dimgray:6908265,dimgrey:6908265,dodgerblue:2003199,firebrick:11674146,floralwhite:16775920,forestgreen:2263842,fuchsia:16711935,gainsboro:14474460,ghostwhite:16316671,gold:16766720,goldenrod:14329120,gray:8421504,green:32768,greenyellow:11403055,grey:8421504,honeydew:15794160,hotpink:16738740,indianred:13458524,indigo:4915330,ivory:16777200,khaki:15787660,lavender:15132410,lavenderblush:16773365,lawngreen:8190976,lemonchiffon:16775885,lightblue:11393254,lightcoral:15761536,lightcyan:14745599,lightgoldenrodyellow:16448210,lightgray:13882323,lightgreen:9498256,lightgrey:13882323,lightpink:16758465,lightsalmon:16752762,lightseagreen:2142890,lightskyblue:8900346,lightslategray:7833753,lightslategrey:7833753,lightsteelblue:11584734,lightyellow:16777184,lime:65280,limegreen:3329330,linen:16445670,magenta:16711935,maroon:8388608,mediumaquamarine:6737322,mediumblue:205,mediumorchid:12211667,mediumpurple:9662683,mediumseagreen:3978097,mediumslateblue:8087790,mediumspringgreen:64154,mediumturquoise:4772300,mediumvioletred:13047173,midnightblue:1644912,mintcream:16121850,mistyrose:16770273,moccasin:16770229,navajowhite:16768685,navy:128,oldlace:16643558,olive:8421376,olivedrab:7048739,orange:16753920,orangered:16729344,orchid:14315734,palegoldenrod:15657130,palegreen:10025880,paleturquoise:11529966,palevioletred:14381203,papayawhip:16773077,peachpuff:16767673,peru:13468991,pink:16761035,plum:14524637,powderblue:11591910,purple:8388736,rebeccapurple:6697881,red:16711680,rosybrown:12357519,royalblue:4286945,saddlebrown:9127187,salmon:16416882,sandybrown:16032864,seagreen:3050327,seashell:16774638,sienna:10506797,silver:12632256,skyblue:8900331,slateblue:6970061,slategray:7372944,slategrey:7372944,snow:16775930,springgreen:65407,steelblue:4620980,tan:13808780,teal:32896,thistle:14204888,tomato:16737095,turquoise:4251856,violet:15631086,wheat:16113331,white:16777215,whitesmoke:16119285,yellow:16776960,yellowgreen:10145074};define(Color,color,{copy(rt){return Object.assign(new this.constructor,this,rt)},displayable(){return this.rgb().displayable()},hex:color_formatHex,formatHex:color_formatHex,formatHex8:color_formatHex8,formatHsl:color_formatHsl,formatRgb:color_formatRgb,toString:color_formatRgb});function color_formatHex(){return this.rgb().formatHex()}function color_formatHex8(){return this.rgb().formatHex8()}function color_formatHsl(){return hslConvert(this).formatHsl()}function color_formatRgb(){return this.rgb().formatRgb()}function color(rt){var it,ct;return rt=(rt+"").trim().toLowerCase(),(it=reHex.exec(rt))?(ct=it[1].length,it=parseInt(it[1],16),ct===6?rgbn(it):ct===3?new Rgb(it>>8&15|it>>4&240,it>>4&15|it&240,(it&15)<<4|it&15,1):ct===8?rgba(it>>24&255,it>>16&255,it>>8&255,(it&255)/255):ct===4?rgba(it>>12&15|it>>8&240,it>>8&15|it>>4&240,it>>4&15|it&240,((it&15)<<4|it&15)/255):null):(it=reRgbInteger.exec(rt))?new Rgb(it[1],it[2],it[3],1):(it=reRgbPercent.exec(rt))?new Rgb(it[1]*255/100,it[2]*255/100,it[3]*255/100,1):(it=reRgbaInteger.exec(rt))?rgba(it[1],it[2],it[3],it[4]):(it=reRgbaPercent.exec(rt))?rgba(it[1]*255/100,it[2]*255/100,it[3]*255/100,it[4]):(it=reHslPercent.exec(rt))?hsla(it[1],it[2]/100,it[3]/100,1):(it=reHslaPercent.exec(rt))?hsla(it[1],it[2]/100,it[3]/100,it[4]):named.hasOwnProperty(rt)?rgbn(named[rt]):rt==="transparent"?new Rgb(NaN,NaN,NaN,0):null}function rgbn(rt){return new Rgb(rt>>16&255,rt>>8&255,rt&255,1)}function rgba(rt,it,ct,dt){return dt<=0&&(rt=it=ct=NaN),new Rgb(rt,it,ct,dt)}function rgbConvert(rt){return rt instanceof Color||(rt=color(rt)),rt?(rt=rt.rgb(),new Rgb(rt.r,rt.g,rt.b,rt.opacity)):new Rgb}function rgb(rt,it,ct,dt){return arguments.length===1?rgbConvert(rt):new Rgb(rt,it,ct,dt??1)}function Rgb(rt,it,ct,dt){this.r=+rt,this.g=+it,this.b=+ct,this.opacity=+dt}define(Rgb,rgb,extend$1(Color,{brighter(rt){return rt=rt==null?brighter:Math.pow(brighter,rt),new Rgb(this.r*rt,this.g*rt,this.b*rt,this.opacity)},darker(rt){return rt=rt==null?darker:Math.pow(darker,rt),new Rgb(this.r*rt,this.g*rt,this.b*rt,this.opacity)},rgb(){return this},clamp(){return new Rgb(clampi(this.r),clampi(this.g),clampi(this.b),clampa(this.opacity))},displayable(){return-.5<=this.r&&this.r<255.5&&-.5<=this.g&&this.g<255.5&&-.5<=this.b&&this.b<255.5&&0<=this.opacity&&this.opacity<=1},hex:rgb_formatHex,formatHex:rgb_formatHex,formatHex8:rgb_formatHex8,formatRgb:rgb_formatRgb,toString:rgb_formatRgb}));function rgb_formatHex(){return`#${hex(this.r)}${hex(this.g)}${hex(this.b)}`}function rgb_formatHex8(){return`#${hex(this.r)}${hex(this.g)}${hex(this.b)}${hex((isNaN(this.opacity)?1:this.opacity)*255)}`}function rgb_formatRgb(){const rt=clampa(this.opacity);return`${rt===1?"rgb(":"rgba("}${clampi(this.r)}, ${clampi(this.g)}, ${clampi(this.b)}${rt===1?")":`, ${rt})`}`}function clampa(rt){return isNaN(rt)?1:Math.max(0,Math.min(1,rt))}function clampi(rt){return Math.max(0,Math.min(255,Math.round(rt)||0))}function hex(rt){return rt=clampi(rt),(rt<16?"0":"")+rt.toString(16)}function hsla(rt,it,ct,dt){return dt<=0?rt=it=ct=NaN:ct<=0||ct>=1?rt=it=NaN:it<=0&&(rt=NaN),new Hsl(rt,it,ct,dt)}function hslConvert(rt){if(rt instanceof Hsl)return new Hsl(rt.h,rt.s,rt.l,rt.opacity);if(rt instanceof Color||(rt=color(rt)),!rt)return new Hsl;if(rt instanceof Hsl)return rt;rt=rt.rgb();var it=rt.r/255,ct=rt.g/255,dt=rt.b/255,ut=Math.min(it,ct,dt),pt=Math.max(it,ct,dt),yt=NaN,ft=pt-ut,mt=(pt+ut)/2;return ft?(it===pt?yt=(ct-dt)/ft+(ct<dt)*6:ct===pt?yt=(dt-it)/ft+2:yt=(it-ct)/ft+4,ft/=mt<.5?pt+ut:2-pt-ut,yt*=60):ft=mt>0&&mt<1?0:yt,new Hsl(yt,ft,mt,rt.opacity)}function hsl(rt,it,ct,dt){return arguments.length===1?hslConvert(rt):new Hsl(rt,it,ct,dt??1)}function Hsl(rt,it,ct,dt){this.h=+rt,this.s=+it,this.l=+ct,this.opacity=+dt}define(Hsl,hsl,extend$1(Color,{brighter(rt){return rt=rt==null?brighter:Math.pow(brighter,rt),new Hsl(this.h,this.s,this.l*rt,this.opacity)},darker(rt){return rt=rt==null?darker:Math.pow(darker,rt),new Hsl(this.h,this.s,this.l*rt,this.opacity)},rgb(){var rt=this.h%360+(this.h<0)*360,it=isNaN(rt)||isNaN(this.s)?0:this.s,ct=this.l,dt=ct+(ct<.5?ct:1-ct)*it,ut=2*ct-dt;return new Rgb(hsl2rgb(rt>=240?rt-240:rt+120,ut,dt),hsl2rgb(rt,ut,dt),hsl2rgb(rt<120?rt+240:rt-120,ut,dt),this.opacity)},clamp(){return new Hsl(clamph(this.h),clampt(this.s),clampt(this.l),clampa(this.opacity))},displayable(){return(0<=this.s&&this.s<=1||isNaN(this.s))&&0<=this.l&&this.l<=1&&0<=this.opacity&&this.opacity<=1},formatHsl(){const rt=clampa(this.opacity);return`${rt===1?"hsl(":"hsla("}${clamph(this.h)}, ${clampt(this.s)*100}%, ${clampt(this.l)*100}%${rt===1?")":`, ${rt})`}`}}));function clamph(rt){return rt=(rt||0)%360,rt<0?rt+360:rt}function clampt(rt){return Math.max(0,Math.min(1,rt||0))}function hsl2rgb(rt,it,ct){return(rt<60?it+(ct-it)*rt/60:rt<180?ct:rt<240?it+(ct-it)*(240-rt)/60:it)*255}const constant$2=rt=>()=>rt;function linear(rt,it){return function(ct){return rt+ct*it}}function exponential(rt,it,ct){return rt=Math.pow(rt,ct),it=Math.pow(it,ct)-rt,ct=1/ct,function(dt){return Math.pow(rt+dt*it,ct)}}function hue(rt,it){var ct=it-rt;return ct?linear(rt,ct>180||ct<-180?ct-360*Math.round(ct/360):ct):constant$2(isNaN(rt)?it:rt)}function gamma(rt){return(rt=+rt)==1?nogamma:function(it,ct){return ct-it?exponential(it,ct,rt):constant$2(isNaN(it)?ct:it)}}function nogamma(rt,it){var ct=it-rt;return ct?linear(rt,ct):constant$2(isNaN(rt)?it:rt)}const interpolateRgb=(function rt(it){var ct=gamma(it);function dt(ut,pt){var yt=ct((ut=rgb(ut)).r,(pt=rgb(pt)).r),ft=ct(ut.g,pt.g),mt=ct(ut.b,pt.b),kt=nogamma(ut.opacity,pt.opacity);return function(_t){return ut.r=yt(_t),ut.g=ft(_t),ut.b=mt(_t),ut.opacity=kt(_t),ut+""}}return dt.gamma=rt,dt})(1);function interpolateNumber(rt,it){return rt=+rt,it=+it,function(ct){return rt*(1-ct)+it*ct}}var reA=/[-+]?(?:\d+\.?\d*|\.?\d+)(?:[eE][-+]?\d+)?/g,reB=new RegExp(reA.source,"g");function zero(rt){return function(){return rt}}function one(rt){return function(it){return rt(it)+""}}function interpolateString(rt,it){var ct=reA.lastIndex=reB.lastIndex=0,dt,ut,pt,yt=-1,ft=[],mt=[];for(rt=rt+"",it=it+"";(dt=reA.exec(rt))&&(ut=reB.exec(it));)(pt=ut.index)>ct&&(pt=it.slice(ct,pt),ft[yt]?ft[yt]+=pt:ft[++yt]=pt),(dt=dt[0])===(ut=ut[0])?ft[yt]?ft[yt]+=ut:ft[++yt]=ut:(ft[++yt]=null,mt.push({i:yt,x:interpolateNumber(dt,ut)})),ct=reB.lastIndex;return ct<it.length&&(pt=it.slice(ct),ft[yt]?ft[yt]+=pt:ft[++yt]=pt),ft.length<2?mt[0]?one(mt[0].x):zero(it):(it=mt.length,function(kt){for(var _t=0,vt;_t<it;++_t)ft[(vt=mt[_t]).i]=vt.x(kt);return ft.join("")})}var degrees=180/Math.PI,identity$1={translateX:0,translateY:0,rotate:0,skewX:0,scaleX:1,scaleY:1};function decompose(rt,it,ct,dt,ut,pt){var yt,ft,mt;return(yt=Math.sqrt(rt*rt+it*it))&&(rt/=yt,it/=yt),(mt=rt*ct+it*dt)&&(ct-=rt*mt,dt-=it*mt),(ft=Math.sqrt(ct*ct+dt*dt))&&(ct/=ft,dt/=ft,mt/=ft),rt*dt<it*ct&&(rt=-rt,it=-it,mt=-mt,yt=-yt),{translateX:ut,translateY:pt,rotate:Math.atan2(it,rt)*degrees,skewX:Math.atan(mt)*degrees,scaleX:yt,scaleY:ft}}var svgNode;function parseCss(rt){const it=new(typeof DOMMatrix=="function"?DOMMatrix:WebKitCSSMatrix)(rt+"");return it.isIdentity?identity$1:decompose(it.a,it.b,it.c,it.d,it.e,it.f)}function parseSvg(rt){return rt==null||(svgNode||(svgNode=document.createElementNS("http://www.w3.org/2000/svg","g")),svgNode.setAttribute("transform",rt),!(rt=svgNode.transform.baseVal.consolidate()))?identity$1:(rt=rt.matrix,decompose(rt.a,rt.b,rt.c,rt.d,rt.e,rt.f))}function interpolateTransform(rt,it,ct,dt){function ut(kt){return kt.length?kt.pop()+" ":""}function pt(kt,_t,vt,bt,Mt,wt){if(kt!==vt||_t!==bt){var St=Mt.push("translate(",null,it,null,ct);wt.push({i:St-4,x:interpolateNumber(kt,vt)},{i:St-2,x:interpolateNumber(_t,bt)})}else(vt||bt)&&Mt.push("translate("+vt+it+bt+ct)}function yt(kt,_t,vt,bt){kt!==_t?(kt-_t>180?_t+=360:_t-kt>180&&(kt+=360),bt.push({i:vt.push(ut(vt)+"rotate(",null,dt)-2,x:interpolateNumber(kt,_t)})):_t&&vt.push(ut(vt)+"rotate("+_t+dt)}function ft(kt,_t,vt,bt){kt!==_t?bt.push({i:vt.push(ut(vt)+"skewX(",null,dt)-2,x:interpolateNumber(kt,_t)}):_t&&vt.push(ut(vt)+"skewX("+_t+dt)}function mt(kt,_t,vt,bt,Mt,wt){if(kt!==vt||_t!==bt){var St=Mt.push(ut(Mt)+"scale(",null,",",null,")");wt.push({i:St-4,x:interpolateNumber(kt,vt)},{i:St-2,x:interpolateNumber(_t,bt)})}else(vt!==1||bt!==1)&&Mt.push(ut(Mt)+"scale("+vt+","+bt+")")}return function(kt,_t){var vt=[],bt=[];return kt=rt(kt),_t=rt(_t),pt(kt.translateX,kt.translateY,_t.translateX,_t.translateY,vt,bt),yt(kt.rotate,_t.rotate,vt,bt),ft(kt.skewX,_t.skewX,vt,bt),mt(kt.scaleX,kt.scaleY,_t.scaleX,_t.scaleY,vt,bt),kt=_t=null,function(Mt){for(var wt=-1,St=bt.length,It;++wt<St;)vt[(It=bt[wt]).i]=It.x(Mt);return vt.join("")}}}var interpolateTransformCss=interpolateTransform(parseCss,"px, ","px)","deg)"),interpolateTransformSvg=interpolateTransform(parseSvg,", ",")",")"),frame=0,timeout$1=0,interval=0,pokeDelay=1e3,taskHead,taskTail,clockLast=0,clockNow=0,clockSkew=0,clock=typeof performance=="object"&&performance.now?performance:Date,setFrame=typeof window=="object"&&window.requestAnimationFrame?window.requestAnimationFrame.bind(window):function(rt){setTimeout(rt,17)};function now(){return clockNow||(setFrame(clearNow),clockNow=clock.now()+clockSkew)}function clearNow(){clockNow=0}function Timer(){this._call=this._time=this._next=null}Timer.prototype=timer.prototype={constructor:Timer,restart:function(rt,it,ct){if(typeof rt!="function")throw new TypeError("callback is not a function");ct=(ct==null?now():+ct)+(it==null?0:+it),!this._next&&taskTail!==this&&(taskTail?taskTail._next=this:taskHead=this,taskTail=this),this._call=rt,this._time=ct,sleep()},stop:function(){this._call&&(this._call=null,this._time=1/0,sleep())}};function timer(rt,it,ct){var dt=new Timer;return dt.restart(rt,it,ct),dt}function timerFlush(){now(),++frame;for(var rt=taskHead,it;rt;)(it=clockNow-rt._time)>=0&&rt._call.call(void 0,it),rt=rt._next;--frame}function wake(){clockNow=(clockLast=clock.now())+clockSkew,frame=timeout$1=0;try{timerFlush()}finally{frame=0,nap(),clockNow=0}}function poke(){var rt=clock.now(),it=rt-clockLast;it>pokeDelay&&(clockSkew-=it,clockLast=rt)}function nap(){for(var rt,it=taskHead,ct,dt=1/0;it;)it._call?(dt>it._time&&(dt=it._time),rt=it,it=it._next):(ct=it._next,it._next=null,it=rt?rt._next=ct:taskHead=ct);taskTail=rt,sleep(dt)}function sleep(rt){if(!frame){timeout$1&&(timeout$1=clearTimeout(timeout$1));var it=rt-clockNow;it>24?(rt<1/0&&(timeout$1=setTimeout(wake,rt-clock.now()-clockSkew)),interval&&(interval=clearInterval(interval))):(interval||(clockLast=clock.now(),interval=setInterval(poke,pokeDelay)),frame=1,setFrame(wake))}}function timeout(rt,it,ct){var dt=new Timer;return it=it==null?0:+it,dt.restart(ut=>{dt.stop(),rt(ut+it)},it,ct),dt}var emptyOn=dispatch("start","end","cancel","interrupt"),emptyTween=[],CREATED=0,SCHEDULED=1,STARTING=2,STARTED=3,RUNNING=4,ENDING=5,ENDED=6;function schedule(rt,it,ct,dt,ut,pt){var yt=rt.__transition;if(!yt)rt.__transition={};else if(ct in yt)return;create(rt,ct,{name:it,index:dt,group:ut,on:emptyOn,tween:emptyTween,time:pt.time,delay:pt.delay,duration:pt.duration,ease:pt.ease,timer:null,state:CREATED})}function init$1(rt,it){var ct=get$1(rt,it);if(ct.state>CREATED)throw new Error("too late; already scheduled");return ct}function set$1(rt,it){var ct=get$1(rt,it);if(ct.state>STARTED)throw new Error("too late; already running");return ct}function get$1(rt,it){var ct=rt.__transition;if(!ct||!(ct=ct[it]))throw new Error("transition not found");return ct}function create(rt,it,ct){var dt=rt.__transition,ut;dt[it]=ct,ct.timer=timer(pt,0,ct.time);function pt(kt){ct.state=SCHEDULED,ct.timer.restart(yt,ct.delay,ct.time),ct.delay<=kt&&yt(kt-ct.delay)}function yt(kt){var _t,vt,bt,Mt;if(ct.state!==SCHEDULED)return mt();for(_t in dt)if(Mt=dt[_t],Mt.name===ct.name){if(Mt.state===STARTED)return timeout(yt);Mt.state===RUNNING?(Mt.state=ENDED,Mt.timer.stop(),Mt.on.call("interrupt",rt,rt.__data__,Mt.index,Mt.group),delete dt[_t]):+_t<it&&(Mt.state=ENDED,Mt.timer.stop(),Mt.on.call("cancel",rt,rt.__data__,Mt.index,Mt.group),delete dt[_t])}if(timeout(function(){ct.state===STARTED&&(ct.state=RUNNING,ct.timer.restart(ft,ct.delay,ct.time),ft(kt))}),ct.state=STARTING,ct.on.call("start",rt,rt.__data__,ct.index,ct.group),ct.state===STARTING){for(ct.state=STARTED,ut=new Array(bt=ct.tween.length),_t=0,vt=-1;_t<bt;++_t)(Mt=ct.tween[_t].value.call(rt,rt.__data__,ct.index,ct.group))&&(ut[++vt]=Mt);ut.length=vt+1}}function ft(kt){for(var _t=kt<ct.duration?ct.ease.call(null,kt/ct.duration):(ct.timer.restart(mt),ct.state=ENDING,1),vt=-1,bt=ut.length;++vt<bt;)ut[vt].call(rt,_t);ct.state===ENDING&&(ct.on.call("end",rt,rt.__data__,ct.index,ct.group),mt())}function mt(){ct.state=ENDED,ct.timer.stop(),delete dt[it];for(var kt in dt)return;delete rt.__transition}}function interrupt(rt,it){var ct=rt.__transition,dt,ut,pt=!0,yt;if(ct){it=it==null?null:it+"";for(yt in ct){if((dt=ct[yt]).name!==it){pt=!1;continue}ut=dt.state>STARTING&&dt.state<ENDING,dt.state=ENDED,dt.timer.stop(),dt.on.call(ut?"interrupt":"cancel",rt,rt.__data__,dt.index,dt.group),delete ct[yt]}pt&&delete rt.__transition}}function selection_interrupt(rt){return this.each(function(){interrupt(this,rt)})}function tweenRemove(rt,it){var ct,dt;return function(){var ut=set$1(this,rt),pt=ut.tween;if(pt!==ct){dt=ct=pt;for(var yt=0,ft=dt.length;yt<ft;++yt)if(dt[yt].name===it){dt=dt.slice(),dt.splice(yt,1);break}}ut.tween=dt}}function tweenFunction(rt,it,ct){var dt,ut;if(typeof ct!="function")throw new Error;return function(){var pt=set$1(this,rt),yt=pt.tween;if(yt!==dt){ut=(dt=yt).slice();for(var ft={name:it,value:ct},mt=0,kt=ut.length;mt<kt;++mt)if(ut[mt].name===it){ut[mt]=ft;break}mt===kt&&ut.push(ft)}pt.tween=ut}}function transition_tween(rt,it){var ct=this._id;if(rt+="",arguments.length<2){for(var dt=get$1(this.node(),ct).tween,ut=0,pt=dt.length,yt;ut<pt;++ut)if((yt=dt[ut]).name===rt)return yt.value;return null}return this.each((it==null?tweenRemove:tweenFunction)(ct,rt,it))}function tweenValue(rt,it,ct){var dt=rt._id;return rt.each(function(){var ut=set$1(this,dt);(ut.value||(ut.value={}))[it]=ct.apply(this,arguments)}),function(ut){return get$1(ut,dt).value[it]}}function interpolate(rt,it){var ct;return(typeof it=="number"?interpolateNumber:it instanceof color?interpolateRgb:(ct=color(it))?(it=ct,interpolateRgb):interpolateString)(rt,it)}function attrRemove(rt){return function(){this.removeAttribute(rt)}}function attrRemoveNS(rt){return function(){this.removeAttributeNS(rt.space,rt.local)}}function attrConstant(rt,it,ct){var dt,ut=ct+"",pt;return function(){var yt=this.getAttribute(rt);return yt===ut?null:yt===dt?pt:pt=it(dt=yt,ct)}}function attrConstantNS(rt,it,ct){var dt,ut=ct+"",pt;return function(){var yt=this.getAttributeNS(rt.space,rt.local);return yt===ut?null:yt===dt?pt:pt=it(dt=yt,ct)}}function attrFunction(rt,it,ct){var dt,ut,pt;return function(){var yt,ft=ct(this),mt;return ft==null?void this.removeAttribute(rt):(yt=this.getAttribute(rt),mt=ft+"",yt===mt?null:yt===dt&&mt===ut?pt:(ut=mt,pt=it(dt=yt,ft)))}}function attrFunctionNS(rt,it,ct){var dt,ut,pt;return function(){var yt,ft=ct(this),mt;return ft==null?void this.removeAttributeNS(rt.space,rt.local):(yt=this.getAttributeNS(rt.space,rt.local),mt=ft+"",yt===mt?null:yt===dt&&mt===ut?pt:(ut=mt,pt=it(dt=yt,ft)))}}function transition_attr(rt,it){var ct=namespace(rt),dt=ct==="transform"?interpolateTransformSvg:interpolate;return this.attrTween(rt,typeof it=="function"?(ct.local?attrFunctionNS:attrFunction)(ct,dt,tweenValue(this,"attr."+rt,it)):it==null?(ct.local?attrRemoveNS:attrRemove)(ct):(ct.local?attrConstantNS:attrConstant)(ct,dt,it))}function attrInterpolate(rt,it){return function(ct){this.setAttribute(rt,it.call(this,ct))}}function attrInterpolateNS(rt,it){return function(ct){this.setAttributeNS(rt.space,rt.local,it.call(this,ct))}}function attrTweenNS(rt,it){var ct,dt;function ut(){var pt=it.apply(this,arguments);return pt!==dt&&(ct=(dt=pt)&&attrInterpolateNS(rt,pt)),ct}return ut._value=it,ut}function attrTween(rt,it){var ct,dt;function ut(){var pt=it.apply(this,arguments);return pt!==dt&&(ct=(dt=pt)&&attrInterpolate(rt,pt)),ct}return ut._value=it,ut}function transition_attrTween(rt,it){var ct="attr."+rt;if(arguments.length<2)return(ct=this.tween(ct))&&ct._value;if(it==null)return this.tween(ct,null);if(typeof it!="function")throw new Error;var dt=namespace(rt);return this.tween(ct,(dt.local?attrTweenNS:attrTween)(dt,it))}function delayFunction(rt,it){return function(){init$1(this,rt).delay=+it.apply(this,arguments)}}function delayConstant(rt,it){return it=+it,function(){init$1(this,rt).delay=it}}function transition_delay(rt){var it=this._id;return arguments.length?this.each((typeof rt=="function"?delayFunction:delayConstant)(it,rt)):get$1(this.node(),it).delay}function durationFunction(rt,it){return function(){set$1(this,rt).duration=+it.apply(this,arguments)}}function durationConstant(rt,it){return it=+it,function(){set$1(this,rt).duration=it}}function transition_duration(rt){var it=this._id;return arguments.length?this.each((typeof rt=="function"?durationFunction:durationConstant)(it,rt)):get$1(this.node(),it).duration}function easeConstant(rt,it){if(typeof it!="function")throw new Error;return function(){set$1(this,rt).ease=it}}function transition_ease(rt){var it=this._id;return arguments.length?this.each(easeConstant(it,rt)):get$1(this.node(),it).ease}function easeVarying(rt,it){return function(){var ct=it.apply(this,arguments);if(typeof ct!="function")throw new Error;set$1(this,rt).ease=ct}}function transition_easeVarying(rt){if(typeof rt!="function")throw new Error;return this.each(easeVarying(this._id,rt))}function transition_filter(rt){typeof rt!="function"&&(rt=matcher(rt));for(var it=this._groups,ct=it.length,dt=new Array(ct),ut=0;ut<ct;++ut)for(var pt=it[ut],yt=pt.length,ft=dt[ut]=[],mt,kt=0;kt<yt;++kt)(mt=pt[kt])&&rt.call(mt,mt.__data__,kt,pt)&&ft.push(mt);return new Transition(dt,this._parents,this._name,this._id)}function transition_merge(rt){if(rt._id!==this._id)throw new Error;for(var it=this._groups,ct=rt._groups,dt=it.length,ut=ct.length,pt=Math.min(dt,ut),yt=new Array(dt),ft=0;ft<pt;++ft)for(var mt=it[ft],kt=ct[ft],_t=mt.length,vt=yt[ft]=new Array(_t),bt,Mt=0;Mt<_t;++Mt)(bt=mt[Mt]||kt[Mt])&&(vt[Mt]=bt);for(;ft<dt;++ft)yt[ft]=it[ft];return new Transition(yt,this._parents,this._name,this._id)}function start(rt){return(rt+"").trim().split(/^|\s+/).every(function(it){var ct=it.indexOf(".");return ct>=0&&(it=it.slice(0,ct)),!it||it==="start"})}function onFunction(rt,it,ct){var dt,ut,pt=start(it)?init$1:set$1;return function(){var yt=pt(this,rt),ft=yt.on;ft!==dt&&(ut=(dt=ft).copy()).on(it,ct),yt.on=ut}}function transition_on(rt,it){var ct=this._id;return arguments.length<2?get$1(this.node(),ct).on.on(rt):this.each(onFunction(ct,rt,it))}function removeFunction(rt){return function(){var it=this.parentNode;for(var ct in this.__transition)if(+ct!==rt)return;it&&it.removeChild(this)}}function transition_remove(){return this.on("end.remove",removeFunction(this._id))}function transition_select(rt){var it=this._name,ct=this._id;typeof rt!="function"&&(rt=selector(rt));for(var dt=this._groups,ut=dt.length,pt=new Array(ut),yt=0;yt<ut;++yt)for(var ft=dt[yt],mt=ft.length,kt=pt[yt]=new Array(mt),_t,vt,bt=0;bt<mt;++bt)(_t=ft[bt])&&(vt=rt.call(_t,_t.__data__,bt,ft))&&("__data__"in _t&&(vt.__data__=_t.__data__),kt[bt]=vt,schedule(kt[bt],it,ct,bt,kt,get$1(_t,ct)));return new Transition(pt,this._parents,it,ct)}function transition_selectAll(rt){var it=this._name,ct=this._id;typeof rt!="function"&&(rt=selectorAll(rt));for(var dt=this._groups,ut=dt.length,pt=[],yt=[],ft=0;ft<ut;++ft)for(var mt=dt[ft],kt=mt.length,_t,vt=0;vt<kt;++vt)if(_t=mt[vt]){for(var bt=rt.call(_t,_t.__data__,vt,mt),Mt,wt=get$1(_t,ct),St=0,It=bt.length;St<It;++St)(Mt=bt[St])&&schedule(Mt,it,ct,St,bt,wt);pt.push(bt),yt.push(_t)}return new Transition(pt,yt,it,ct)}var Selection=selection.prototype.constructor;function transition_selection(){return new Selection(this._groups,this._parents)}function styleNull(rt,it){var ct,dt,ut;return function(){var pt=styleValue(this,rt),yt=(this.style.removeProperty(rt),styleValue(this,rt));return pt===yt?null:pt===ct&&yt===dt?ut:ut=it(ct=pt,dt=yt)}}function styleRemove(rt){return function(){this.style.removeProperty(rt)}}function styleConstant(rt,it,ct){var dt,ut=ct+"",pt;return function(){var yt=styleValue(this,rt);return yt===ut?null:yt===dt?pt:pt=it(dt=yt,ct)}}function styleFunction(rt,it,ct){var dt,ut,pt;return function(){var yt=styleValue(this,rt),ft=ct(this),mt=ft+"";return ft==null&&(mt=ft=(this.style.removeProperty(rt),styleValue(this,rt))),yt===mt?null:yt===dt&&mt===ut?pt:(ut=mt,pt=it(dt=yt,ft))}}function styleMaybeRemove(rt,it){var ct,dt,ut,pt="style."+it,yt="end."+pt,ft;return function(){var mt=set$1(this,rt),kt=mt.on,_t=mt.value[pt]==null?ft||(ft=styleRemove(it)):void 0;(kt!==ct||ut!==_t)&&(dt=(ct=kt).copy()).on(yt,ut=_t),mt.on=dt}}function transition_style(rt,it,ct){var dt=(rt+="")=="transform"?interpolateTransformCss:interpolate;return it==null?this.styleTween(rt,styleNull(rt,dt)).on("end.style."+rt,styleRemove(rt)):typeof it=="function"?this.styleTween(rt,styleFunction(rt,dt,tweenValue(this,"style."+rt,it))).each(styleMaybeRemove(this._id,rt)):this.styleTween(rt,styleConstant(rt,dt,it),ct).on("end.style."+rt,null)}function styleInterpolate(rt,it,ct){return function(dt){this.style.setProperty(rt,it.call(this,dt),ct)}}function styleTween(rt,it,ct){var dt,ut;function pt(){var yt=it.apply(this,arguments);return yt!==ut&&(dt=(ut=yt)&&styleInterpolate(rt,yt,ct)),dt}return pt._value=it,pt}function transition_styleTween(rt,it,ct){var dt="style."+(rt+="");if(arguments.length<2)return(dt=this.tween(dt))&&dt._value;if(it==null)return this.tween(dt,null);if(typeof it!="function")throw new Error;return this.tween(dt,styleTween(rt,it,ct??""))}function textConstant(rt){return function(){this.textContent=rt}}function textFunction(rt){return function(){var it=rt(this);this.textContent=it??""}}function transition_text(rt){return this.tween("text",typeof rt=="function"?textFunction(tweenValue(this,"text",rt)):textConstant(rt==null?"":rt+""))}function textInterpolate(rt){return function(it){this.textContent=rt.call(this,it)}}function textTween(rt){var it,ct;function dt(){var ut=rt.apply(this,arguments);return ut!==ct&&(it=(ct=ut)&&textInterpolate(ut)),it}return dt._value=rt,dt}function transition_textTween(rt){var it="text";if(arguments.length<1)return(it=this.tween(it))&&it._value;if(rt==null)return this.tween(it,null);if(typeof rt!="function")throw new Error;return this.tween(it,textTween(rt))}function transition_transition(){for(var rt=this._name,it=this._id,ct=newId(),dt=this._groups,ut=dt.length,pt=0;pt<ut;++pt)for(var yt=dt[pt],ft=yt.length,mt,kt=0;kt<ft;++kt)if(mt=yt[kt]){var _t=get$1(mt,it);schedule(mt,rt,ct,kt,yt,{time:_t.time+_t.delay+_t.duration,delay:0,duration:_t.duration,ease:_t.ease})}return new Transition(dt,this._parents,rt,ct)}function transition_end(){var rt,it,ct=this,dt=ct._id,ut=ct.size();return new Promise(function(pt,yt){var ft={value:yt},mt={value:function(){--ut===0&&pt()}};ct.each(function(){var kt=set$1(this,dt),_t=kt.on;_t!==rt&&(it=(rt=_t).copy(),it._.cancel.push(ft),it._.interrupt.push(ft),it._.end.push(mt)),kt.on=it}),ut===0&&pt()})}var id$1=0;function Transition(rt,it,ct,dt){this._groups=rt,this._parents=it,this._name=ct,this._id=dt}function newId(){return++id$1}var selection_prototype=selection.prototype;Transition.prototype={constructor:Transition,select:transition_select,selectAll:transition_selectAll,selectChild:selection_prototype.selectChild,selectChildren:selection_prototype.selectChildren,filter:transition_filter,merge:transition_merge,selection:transition_selection,transition:transition_transition,call:selection_prototype.call,nodes:selection_prototype.nodes,node:selection_prototype.node,size:selection_prototype.size,empty:selection_prototype.empty,each:selection_prototype.each,on:transition_on,attr:transition_attr,attrTween:transition_attrTween,style:transition_style,styleTween:transition_styleTween,text:transition_text,textTween:transition_textTween,remove:transition_remove,tween:transition_tween,delay:transition_delay,duration:transition_duration,ease:transition_ease,easeVarying:transition_easeVarying,end:transition_end,[Symbol.iterator]:selection_prototype[Symbol.iterator]};function cubicInOut(rt){return((rt*=2)<=1?rt*rt*rt:(rt-=2)*rt*rt+2)/2}var defaultTiming={time:null,delay:0,duration:250,ease:cubicInOut};function inherit(rt,it){for(var ct;!(ct=rt.__transition)||!(ct=ct[it]);)if(!(rt=rt.parentNode))throw new Error(`transition ${it} not found`);return ct}function selection_transition(rt){var it,ct;rt instanceof Transition?(it=rt._id,rt=rt._name):(it=newId(),(ct=defaultTiming).time=now(),rt=rt==null?null:rt+"");for(var dt=this._groups,ut=dt.length,pt=0;pt<ut;++pt)for(var yt=dt[pt],ft=yt.length,mt,kt=0;kt<ft;++kt)(mt=yt[kt])&&schedule(mt,rt,it,kt,yt,ct||inherit(mt,it));return new Transition(dt,this._parents,rt,it)}selection.prototype.interrupt=selection_interrupt;selection.prototype.transition=selection_transition;const pi$1=Math.PI,tau$1=2*pi$1,epsilon$1=1e-6,tauEpsilon=tau$1-epsilon$1;function append$1(rt){this._+=rt[0];for(let it=1,ct=rt.length;it<ct;++it)this._+=arguments[it]+rt[it]}function appendRound(rt){let it=Math.floor(rt);if(!(it>=0))throw new Error(`invalid digits: ${rt}`);if(it>15)return append$1;const ct=10**it;return function(dt){this._+=dt[0];for(let ut=1,pt=dt.length;ut<pt;++ut)this._+=Math.round(arguments[ut]*ct)/ct+dt[ut]}}class Path{constructor(it){this._x0=this._y0=this._x1=this._y1=null,this._="",this._append=it==null?append$1:appendRound(it)}moveTo(it,ct){this._append`M${this._x0=this._x1=+it},${this._y0=this._y1=+ct}`}closePath(){this._x1!==null&&(this._x1=this._x0,this._y1=this._y0,this._append`Z`)}lineTo(it,ct){this._append`L${this._x1=+it},${this._y1=+ct}`}quadraticCurveTo(it,ct,dt,ut){this._append`Q${+it},${+ct},${this._x1=+dt},${this._y1=+ut}`}bezierCurveTo(it,ct,dt,ut,pt,yt){this._append`C${+it},${+ct},${+dt},${+ut},${this._x1=+pt},${this._y1=+yt}`}arcTo(it,ct,dt,ut,pt){if(it=+it,ct=+ct,dt=+dt,ut=+ut,pt=+pt,pt<0)throw new Error(`negative radius: ${pt}`);let yt=this._x1,ft=this._y1,mt=dt-it,kt=ut-ct,_t=yt-it,vt=ft-ct,bt=_t*_t+vt*vt;if(this._x1===null)this._append`M${this._x1=it},${this._y1=ct}`;else if(bt>epsilon$1)if(!(Math.abs(vt*mt-kt*_t)>epsilon$1)||!pt)this._append`L${this._x1=it},${this._y1=ct}`;else{let Mt=dt-yt,wt=ut-ft,St=mt*mt+kt*kt,It=Mt*Mt+wt*wt,Nt=Math.sqrt(St),$t=Math.sqrt(bt),Et=pt*Math.tan((pi$1-Math.acos((St+bt-It)/(2*Nt*$t)))/2),Ft=Et/$t,qt=Et/Nt;Math.abs(Ft-1)>epsilon$1&&this._append`L${it+Ft*_t},${ct+Ft*vt}`,this._append`A${pt},${pt},0,0,${+(vt*Mt>_t*wt)},${this._x1=it+qt*mt},${this._y1=ct+qt*kt}`}}arc(it,ct,dt,ut,pt,yt){if(it=+it,ct=+ct,dt=+dt,yt=!!yt,dt<0)throw new Error(`negative radius: ${dt}`);let ft=dt*Math.cos(ut),mt=dt*Math.sin(ut),kt=it+ft,_t=ct+mt,vt=1^yt,bt=yt?ut-pt:pt-ut;this._x1===null?this._append`M${kt},${_t}`:(Math.abs(this._x1-kt)>epsilon$1||Math.abs(this._y1-_t)>epsilon$1)&&this._append`L${kt},${_t}`,dt&&(bt<0&&(bt=bt%tau$1+tau$1),bt>tauEpsilon?this._append`A${dt},${dt},0,1,${vt},${it-ft},${ct-mt}A${dt},${dt},0,1,${vt},${this._x1=kt},${this._y1=_t}`:bt>epsilon$1&&this._append`A${dt},${dt},0,${+(bt>=pi$1)},${vt},${this._x1=it+dt*Math.cos(pt)},${this._y1=ct+dt*Math.sin(pt)}`)}rect(it,ct,dt,ut){this._append`M${this._x0=this._x1=+it},${this._y0=this._y1=+ct}h${dt=+dt}v${+ut}h${-dt}Z`}toString(){return this._}}function constant$1(rt){return function(){return rt}}const abs$1=Math.abs,atan2=Math.atan2,cos=Math.cos,max=Math.max,min=Math.min,sin=Math.sin,sqrt=Math.sqrt,epsilon=1e-12,pi=Math.PI,halfPi=pi/2,tau=2*pi;function acos(rt){return rt>1?0:rt<-1?pi:Math.acos(rt)}function asin(rt){return rt>=1?halfPi:rt<=-1?-halfPi:Math.asin(rt)}function withPath(rt){let it=3;return rt.digits=function(ct){if(!arguments.length)return it;if(ct==null)it=null;else{const dt=Math.floor(ct);if(!(dt>=0))throw new RangeError(`invalid digits: ${ct}`);it=dt}return rt},()=>new Path(it)}function array(rt){return typeof rt=="object"&&"length"in rt?rt:Array.from(rt)}function Linear(rt){this._context=rt}Linear.prototype={areaStart:function(){this._line=0},areaEnd:function(){this._line=NaN},lineStart:function(){this._point=0},lineEnd:function(){(this._line||this._line!==0&&this._point===1)&&this._context.closePath(),this._line=1-this._line},point:function(rt,it){switch(rt=+rt,it=+it,this._point){case 0:this._point=1,this._line?this._context.lineTo(rt,it):this._context.moveTo(rt,it);break;case 1:this._point=2;default:this._context.lineTo(rt,it);break}}};function curveLinear(rt){return new Linear(rt)}function x$3(rt){return rt[0]}function y$3(rt){return rt[1]}function line$1(rt,it){var ct=constant$1(!0),dt=null,ut=curveLinear,pt=null,yt=withPath(ft);rt=typeof rt=="function"?rt:rt===void 0?x$3:constant$1(rt),it=typeof it=="function"?it:it===void 0?y$3:constant$1(it);function ft(mt){var kt,_t=(mt=array(mt)).length,vt,bt=!1,Mt;for(dt==null&&(pt=ut(Mt=yt())),kt=0;kt<=_t;++kt)!(kt<_t&&ct(vt=mt[kt],kt,mt))===bt&&((bt=!bt)?pt.lineStart():pt.lineEnd()),bt&&pt.point(+rt(vt,kt,mt),+it(vt,kt,mt));if(Mt)return pt=null,Mt+""||null}return ft.x=function(mt){return arguments.length?(rt=typeof mt=="function"?mt:constant$1(+mt),ft):rt},ft.y=function(mt){return arguments.length?(it=typeof mt=="function"?mt:constant$1(+mt),ft):it},ft.defined=function(mt){return arguments.length?(ct=typeof mt=="function"?mt:constant$1(!!mt),ft):ct},ft.curve=function(mt){return arguments.length?(ut=mt,dt!=null&&(pt=ut(dt)),ft):ut},ft.context=function(mt){return arguments.length?(mt==null?dt=pt=null:pt=ut(dt=mt),ft):dt},ft}class Bump{constructor(it,ct){this._context=it,this._x=ct}areaStart(){this._line=0}areaEnd(){this._line=NaN}lineStart(){this._point=0}lineEnd(){(this._line||this._line!==0&&this._point===1)&&this._context.closePath(),this._line=1-this._line}point(it,ct){switch(it=+it,ct=+ct,this._point){case 0:{this._point=1,this._line?this._context.lineTo(it,ct):this._context.moveTo(it,ct);break}case 1:this._point=2;default:{this._x?this._context.bezierCurveTo(this._x0=(this._x0+it)/2,this._y0,this._x0,ct,it,ct):this._context.bezierCurveTo(this._x0,this._y0=(this._y0+ct)/2,it,this._y0,it,ct);break}}this._x0=it,this._y0=ct}}function bumpX(rt){return new Bump(rt,!0)}function bumpY(rt){return new Bump(rt,!1)}function noop(){}function point$4(rt,it,ct){rt._context.bezierCurveTo((2*rt._x0+rt._x1)/3,(2*rt._y0+rt._y1)/3,(rt._x0+2*rt._x1)/3,(rt._y0+2*rt._y1)/3,(rt._x0+4*rt._x1+it)/6,(rt._y0+4*rt._y1+ct)/6)}function Basis(rt){this._context=rt}Basis.prototype={areaStart:function(){this._line=0},areaEnd:function(){this._line=NaN},lineStart:function(){this._x0=this._x1=this._y0=this._y1=NaN,this._point=0},lineEnd:function(){switch(this._point){case 3:point$4(this,this._x1,this._y1);case 2:this._context.lineTo(this._x1,this._y1);break}(this._line||this._line!==0&&this._point===1)&&this._context.closePath(),this._line=1-this._line},point:function(rt,it){switch(rt=+rt,it=+it,this._point){case 0:this._point=1,this._line?this._context.lineTo(rt,it):this._context.moveTo(rt,it);break;case 1:this._point=2;break;case 2:this._point=3,this._context.lineTo((5*this._x0+this._x1)/6,(5*this._y0+this._y1)/6);default:point$4(this,rt,it);break}this._x0=this._x1,this._x1=rt,this._y0=this._y1,this._y1=it}};function curveBasis(rt){return new Basis(rt)}function BasisClosed(rt){this._context=rt}BasisClosed.prototype={areaStart:noop,areaEnd:noop,lineStart:function(){this._x0=this._x1=this._x2=this._x3=this._x4=this._y0=this._y1=this._y2=this._y3=this._y4=NaN,this._point=0},lineEnd:function(){switch(this._point){case 1:{this._context.moveTo(this._x2,this._y2),this._context.closePath();break}case 2:{this._context.moveTo((this._x2+2*this._x3)/3,(this._y2+2*this._y3)/3),this._context.lineTo((this._x3+2*this._x2)/3,(this._y3+2*this._y2)/3),this._context.closePath();break}case 3:{this.point(this._x2,this._y2),this.point(this._x3,this._y3),this.point(this._x4,this._y4);break}}},point:function(rt,it){switch(rt=+rt,it=+it,this._point){case 0:this._point=1,this._x2=rt,this._y2=it;break;case 1:this._point=2,this._x3=rt,this._y3=it;break;case 2:this._point=3,this._x4=rt,this._y4=it,this._context.moveTo((this._x0+4*this._x1+rt)/6,(this._y0+4*this._y1+it)/6);break;default:point$4(this,rt,it);break}this._x0=this._x1,this._x1=rt,this._y0=this._y1,this._y1=it}};function curveBasisClosed(rt){return new BasisClosed(rt)}function BasisOpen(rt){this._context=rt}BasisOpen.prototype={areaStart:function(){this._line=0},areaEnd:function(){this._line=NaN},lineStart:function(){this._x0=this._x1=this._y0=this._y1=NaN,this._point=0},lineEnd:function(){(this._line||this._line!==0&&this._point===3)&&this._context.closePath(),this._line=1-this._line},point:function(rt,it){switch(rt=+rt,it=+it,this._point){case 0:this._point=1;break;case 1:this._point=2;break;case 2:this._point=3;var ct=(this._x0+4*this._x1+rt)/6,dt=(this._y0+4*this._y1+it)/6;this._line?this._context.lineTo(ct,dt):this._context.moveTo(ct,dt);break;case 3:this._point=4;default:point$4(this,rt,it);break}this._x0=this._x1,this._x1=rt,this._y0=this._y1,this._y1=it}};function curveBasisOpen(rt){return new BasisOpen(rt)}function Bundle(rt,it){this._basis=new Basis(rt),this._beta=it}Bundle.prototype={lineStart:function(){this._x=[],this._y=[],this._basis.lineStart()},lineEnd:function(){var rt=this._x,it=this._y,ct=rt.length-1;if(ct>0)for(var dt=rt[0],ut=it[0],pt=rt[ct]-dt,yt=it[ct]-ut,ft=-1,mt;++ft<=ct;)mt=ft/ct,this._basis.point(this._beta*rt[ft]+(1-this._beta)*(dt+mt*pt),this._beta*it[ft]+(1-this._beta)*(ut+mt*yt));this._x=this._y=null,this._basis.lineEnd()},point:function(rt,it){this._x.push(+rt),this._y.push(+it)}};const curveBundle=(function rt(it){function ct(dt){return it===1?new Basis(dt):new Bundle(dt,it)}return ct.beta=function(dt){return rt(+dt)},ct})(.85);function point$3(rt,it,ct){rt._context.bezierCurveTo(rt._x1+rt._k*(rt._x2-rt._x0),rt._y1+rt._k*(rt._y2-rt._y0),rt._x2+rt._k*(rt._x1-it),rt._y2+rt._k*(rt._y1-ct),rt._x2,rt._y2)}function Cardinal(rt,it){this._context=rt,this._k=(1-it)/6}Cardinal.prototype={areaStart:function(){this._line=0},areaEnd:function(){this._line=NaN},lineStart:function(){this._x0=this._x1=this._x2=this._y0=this._y1=this._y2=NaN,this._point=0},lineEnd:function(){switch(this._point){case 2:this._context.lineTo(this._x2,this._y2);break;case 3:point$3(this,this._x1,this._y1);break}(this._line||this._line!==0&&this._point===1)&&this._context.closePath(),this._line=1-this._line},point:function(rt,it){switch(rt=+rt,it=+it,this._point){case 0:this._point=1,this._line?this._context.lineTo(rt,it):this._context.moveTo(rt,it);break;case 1:this._point=2,this._x1=rt,this._y1=it;break;case 2:this._point=3;default:point$3(this,rt,it);break}this._x0=this._x1,this._x1=this._x2,this._x2=rt,this._y0=this._y1,this._y1=this._y2,this._y2=it}};const curveCardinal=(function rt(it){function ct(dt){return new Cardinal(dt,it)}return ct.tension=function(dt){return rt(+dt)},ct})(0);function CardinalClosed(rt,it){this._context=rt,this._k=(1-it)/6}CardinalClosed.prototype={areaStart:noop,areaEnd:noop,lineStart:function(){this._x0=this._x1=this._x2=this._x3=this._x4=this._x5=this._y0=this._y1=this._y2=this._y3=this._y4=this._y5=NaN,this._point=0},lineEnd:function(){switch(this._point){case 1:{this._context.moveTo(this._x3,this._y3),this._context.closePath();break}case 2:{this._context.lineTo(this._x3,this._y3),this._context.closePath();break}case 3:{this.point(this._x3,this._y3),this.point(this._x4,this._y4),this.point(this._x5,this._y5);break}}},point:function(rt,it){switch(rt=+rt,it=+it,this._point){case 0:this._point=1,this._x3=rt,this._y3=it;break;case 1:this._point=2,this._context.moveTo(this._x4=rt,this._y4=it);break;case 2:this._point=3,this._x5=rt,this._y5=it;break;default:point$3(this,rt,it);break}this._x0=this._x1,this._x1=this._x2,this._x2=rt,this._y0=this._y1,this._y1=this._y2,this._y2=it}};const curveCardinalClosed=(function rt(it){function ct(dt){return new CardinalClosed(dt,it)}return ct.tension=function(dt){return rt(+dt)},ct})(0);function CardinalOpen(rt,it){this._context=rt,this._k=(1-it)/6}CardinalOpen.prototype={areaStart:function(){this._line=0},areaEnd:function(){this._line=NaN},lineStart:function(){this._x0=this._x1=this._x2=this._y0=this._y1=this._y2=NaN,this._point=0},lineEnd:function(){(this._line||this._line!==0&&this._point===3)&&this._context.closePath(),this._line=1-this._line},point:function(rt,it){switch(rt=+rt,it=+it,this._point){case 0:this._point=1;break;case 1:this._point=2;break;case 2:this._point=3,this._line?this._context.lineTo(this._x2,this._y2):this._context.moveTo(this._x2,this._y2);break;case 3:this._point=4;default:point$3(this,rt,it);break}this._x0=this._x1,this._x1=this._x2,this._x2=rt,this._y0=this._y1,this._y1=this._y2,this._y2=it}};const curveCardinalOpen=(function rt(it){function ct(dt){return new CardinalOpen(dt,it)}return ct.tension=function(dt){return rt(+dt)},ct})(0);function point$2(rt,it,ct){var dt=rt._x1,ut=rt._y1,pt=rt._x2,yt=rt._y2;if(rt._l01_a>epsilon){var ft=2*rt._l01_2a+3*rt._l01_a*rt._l12_a+rt._l12_2a,mt=3*rt._l01_a*(rt._l01_a+rt._l12_a);dt=(dt*ft-rt._x0*rt._l12_2a+rt._x2*rt._l01_2a)/mt,ut=(ut*ft-rt._y0*rt._l12_2a+rt._y2*rt._l01_2a)/mt}if(rt._l23_a>epsilon){var kt=2*rt._l23_2a+3*rt._l23_a*rt._l12_a+rt._l12_2a,_t=3*rt._l23_a*(rt._l23_a+rt._l12_a);pt=(pt*kt+rt._x1*rt._l23_2a-it*rt._l12_2a)/_t,yt=(yt*kt+rt._y1*rt._l23_2a-ct*rt._l12_2a)/_t}rt._context.bezierCurveTo(dt,ut,pt,yt,rt._x2,rt._y2)}function CatmullRom(rt,it){this._context=rt,this._alpha=it}CatmullRom.prototype={areaStart:function(){this._line=0},areaEnd:function(){this._line=NaN},lineStart:function(){this._x0=this._x1=this._x2=this._y0=this._y1=this._y2=NaN,this._l01_a=this._l12_a=this._l23_a=this._l01_2a=this._l12_2a=this._l23_2a=this._point=0},lineEnd:function(){switch(this._point){case 2:this._context.lineTo(this._x2,this._y2);break;case 3:this.point(this._x2,this._y2);break}(this._line||this._line!==0&&this._point===1)&&this._context.closePath(),this._line=1-this._line},point:function(rt,it){if(rt=+rt,it=+it,this._point){var ct=this._x2-rt,dt=this._y2-it;this._l23_a=Math.sqrt(this._l23_2a=Math.pow(ct*ct+dt*dt,this._alpha))}switch(this._point){case 0:this._point=1,this._line?this._context.lineTo(rt,it):this._context.moveTo(rt,it);break;case 1:this._point=2;break;case 2:this._point=3;default:point$2(this,rt,it);break}this._l01_a=this._l12_a,this._l12_a=this._l23_a,this._l01_2a=this._l12_2a,this._l12_2a=this._l23_2a,this._x0=this._x1,this._x1=this._x2,this._x2=rt,this._y0=this._y1,this._y1=this._y2,this._y2=it}};const curveCatmullRom=(function rt(it){function ct(dt){return it?new CatmullRom(dt,it):new Cardinal(dt,0)}return ct.alpha=function(dt){return rt(+dt)},ct})(.5);function CatmullRomClosed(rt,it){this._context=rt,this._alpha=it}CatmullRomClosed.prototype={areaStart:noop,areaEnd:noop,lineStart:function(){this._x0=this._x1=this._x2=this._x3=this._x4=this._x5=this._y0=this._y1=this._y2=this._y3=this._y4=this._y5=NaN,this._l01_a=this._l12_a=this._l23_a=this._l01_2a=this._l12_2a=this._l23_2a=this._point=0},lineEnd:function(){switch(this._point){case 1:{this._context.moveTo(this._x3,this._y3),this._context.closePath();break}case 2:{this._context.lineTo(this._x3,this._y3),this._context.closePath();break}case 3:{this.point(this._x3,this._y3),this.point(this._x4,this._y4),this.point(this._x5,this._y5);break}}},point:function(rt,it){if(rt=+rt,it=+it,this._point){var ct=this._x2-rt,dt=this._y2-it;this._l23_a=Math.sqrt(this._l23_2a=Math.pow(ct*ct+dt*dt,this._alpha))}switch(this._point){case 0:this._point=1,this._x3=rt,this._y3=it;break;case 1:this._point=2,this._context.moveTo(this._x4=rt,this._y4=it);break;case 2:this._point=3,this._x5=rt,this._y5=it;break;default:point$2(this,rt,it);break}this._l01_a=this._l12_a,this._l12_a=this._l23_a,this._l01_2a=this._l12_2a,this._l12_2a=this._l23_2a,this._x0=this._x1,this._x1=this._x2,this._x2=rt,this._y0=this._y1,this._y1=this._y2,this._y2=it}};const curveCatmullRomClosed=(function rt(it){function ct(dt){return it?new CatmullRomClosed(dt,it):new CardinalClosed(dt,0)}return ct.alpha=function(dt){return rt(+dt)},ct})(.5);function CatmullRomOpen(rt,it){this._context=rt,this._alpha=it}CatmullRomOpen.prototype={areaStart:function(){this._line=0},areaEnd:function(){this._line=NaN},lineStart:function(){this._x0=this._x1=this._x2=this._y0=this._y1=this._y2=NaN,this._l01_a=this._l12_a=this._l23_a=this._l01_2a=this._l12_2a=this._l23_2a=this._point=0},lineEnd:function(){(this._line||this._line!==0&&this._point===3)&&this._context.closePath(),this._line=1-this._line},point:function(rt,it){if(rt=+rt,it=+it,this._point){var ct=this._x2-rt,dt=this._y2-it;this._l23_a=Math.sqrt(this._l23_2a=Math.pow(ct*ct+dt*dt,this._alpha))}switch(this._point){case 0:this._point=1;break;case 1:this._point=2;break;case 2:this._point=3,this._line?this._context.lineTo(this._x2,this._y2):this._context.moveTo(this._x2,this._y2);break;case 3:this._point=4;default:point$2(this,rt,it);break}this._l01_a=this._l12_a,this._l12_a=this._l23_a,this._l01_2a=this._l12_2a,this._l12_2a=this._l23_2a,this._x0=this._x1,this._x1=this._x2,this._x2=rt,this._y0=this._y1,this._y1=this._y2,this._y2=it}};const curveCatmullRomOpen=(function rt(it){function ct(dt){return it?new CatmullRomOpen(dt,it):new CardinalOpen(dt,0)}return ct.alpha=function(dt){return rt(+dt)},ct})(.5);function LinearClosed(rt){this._context=rt}LinearClosed.prototype={areaStart:noop,areaEnd:noop,lineStart:function(){this._point=0},lineEnd:function(){this._point&&this._context.closePath()},point:function(rt,it){rt=+rt,it=+it,this._point?this._context.lineTo(rt,it):(this._point=1,this._context.moveTo(rt,it))}};function curveLinearClosed(rt){return new LinearClosed(rt)}function sign(rt){return rt<0?-1:1}function slope3(rt,it,ct){var dt=rt._x1-rt._x0,ut=it-rt._x1,pt=(rt._y1-rt._y0)/(dt||ut<0&&-0),yt=(ct-rt._y1)/(ut||dt<0&&-0),ft=(pt*ut+yt*dt)/(dt+ut);return(sign(pt)+sign(yt))*Math.min(Math.abs(pt),Math.abs(yt),.5*Math.abs(ft))||0}function slope2(rt,it){var ct=rt._x1-rt._x0;return ct?(3*(rt._y1-rt._y0)/ct-it)/2:it}function point$1(rt,it,ct){var dt=rt._x0,ut=rt._y0,pt=rt._x1,yt=rt._y1,ft=(pt-dt)/3;rt._context.bezierCurveTo(dt+ft,ut+ft*it,pt-ft,yt-ft*ct,pt,yt)}function MonotoneX(rt){this._context=rt}MonotoneX.prototype={areaStart:function(){this._line=0},areaEnd:function(){this._line=NaN},lineStart:function(){this._x0=this._x1=this._y0=this._y1=this._t0=NaN,this._point=0},lineEnd:function(){switch(this._point){case 2:this._context.lineTo(this._x1,this._y1);break;case 3:point$1(this,this._t0,slope2(this,this._t0));break}(this._line||this._line!==0&&this._point===1)&&this._context.closePath(),this._line=1-this._line},point:function(rt,it){var ct=NaN;if(rt=+rt,it=+it,!(rt===this._x1&&it===this._y1)){switch(this._point){case 0:this._point=1,this._line?this._context.lineTo(rt,it):this._context.moveTo(rt,it);break;case 1:this._point=2;break;case 2:this._point=3,point$1(this,slope2(this,ct=slope3(this,rt,it)),ct);break;default:point$1(this,this._t0,ct=slope3(this,rt,it));break}this._x0=this._x1,this._x1=rt,this._y0=this._y1,this._y1=it,this._t0=ct}}};function MonotoneY(rt){this._context=new ReflectContext(rt)}(MonotoneY.prototype=Object.create(MonotoneX.prototype)).point=function(rt,it){MonotoneX.prototype.point.call(this,it,rt)};function ReflectContext(rt){this._context=rt}ReflectContext.prototype={moveTo:function(rt,it){this._context.moveTo(it,rt)},closePath:function(){this._context.closePath()},lineTo:function(rt,it){this._context.lineTo(it,rt)},bezierCurveTo:function(rt,it,ct,dt,ut,pt){this._context.bezierCurveTo(it,rt,dt,ct,pt,ut)}};function monotoneX(rt){return new MonotoneX(rt)}function monotoneY(rt){return new MonotoneY(rt)}function Natural(rt){this._context=rt}Natural.prototype={areaStart:function(){this._line=0},areaEnd:function(){this._line=NaN},lineStart:function(){this._x=[],this._y=[]},lineEnd:function(){var rt=this._x,it=this._y,ct=rt.length;if(ct)if(this._line?this._context.lineTo(rt[0],it[0]):this._context.moveTo(rt[0],it[0]),ct===2)this._context.lineTo(rt[1],it[1]);else for(var dt=controlPoints(rt),ut=controlPoints(it),pt=0,yt=1;yt<ct;++pt,++yt)this._context.bezierCurveTo(dt[0][pt],ut[0][pt],dt[1][pt],ut[1][pt],rt[yt],it[yt]);(this._line||this._line!==0&&ct===1)&&this._context.closePath(),this._line=1-this._line,this._x=this._y=null},point:function(rt,it){this._x.push(+rt),this._y.push(+it)}};function controlPoints(rt){var it,ct=rt.length-1,dt,ut=new Array(ct),pt=new Array(ct),yt=new Array(ct);for(ut[0]=0,pt[0]=2,yt[0]=rt[0]+2*rt[1],it=1;it<ct-1;++it)ut[it]=1,pt[it]=4,yt[it]=4*rt[it]+2*rt[it+1];for(ut[ct-1]=2,pt[ct-1]=7,yt[ct-1]=8*rt[ct-1]+rt[ct],it=1;it<ct;++it)dt=ut[it]/pt[it-1],pt[it]-=dt,yt[it]-=dt*yt[it-1];for(ut[ct-1]=yt[ct-1]/pt[ct-1],it=ct-2;it>=0;--it)ut[it]=(yt[it]-ut[it+1])/pt[it];for(pt[ct-1]=(rt[ct]+ut[ct-1])/2,it=0;it<ct-1;++it)pt[it]=2*rt[it+1]-ut[it+1];return[ut,pt]}function curveNatural(rt){return new Natural(rt)}function Step(rt,it){this._context=rt,this._t=it}Step.prototype={areaStart:function(){this._line=0},areaEnd:function(){this._line=NaN},lineStart:function(){this._x=this._y=NaN,this._point=0},lineEnd:function(){0<this._t&&this._t<1&&this._point===2&&this._context.lineTo(this._x,this._y),(this._line||this._line!==0&&this._point===1)&&this._context.closePath(),this._line>=0&&(this._t=1-this._t,this._line=1-this._line)},point:function(rt,it){switch(rt=+rt,it=+it,this._point){case 0:this._point=1,this._line?this._context.lineTo(rt,it):this._context.moveTo(rt,it);break;case 1:this._point=2;default:{if(this._t<=0)this._context.lineTo(this._x,it),this._context.lineTo(rt,it);else{var ct=this._x*(1-this._t)+rt*this._t;this._context.lineTo(ct,this._y),this._context.lineTo(ct,it)}break}}this._x=rt,this._y=it}};function curveStep(rt){return new Step(rt,.5)}function stepBefore(rt){return new Step(rt,0)}function stepAfter(rt){return new Step(rt,1)}function Transform(rt,it,ct){this.k=rt,this.x=it,this.y=ct}Transform.prototype={constructor:Transform,scale:function(rt){return rt===1?this:new Transform(this.k*rt,this.x,this.y)},translate:function(rt,it){return rt===0&it===0?this:new Transform(this.k,this.x+this.k*rt,this.y+this.k*it)},apply:function(rt){return[rt[0]*this.k+this.x,rt[1]*this.k+this.y]},applyX:function(rt){return rt*this.k+this.x},applyY:function(rt){return rt*this.k+this.y},invert:function(rt){return[(rt[0]-this.x)/this.k,(rt[1]-this.y)/this.k]},invertX:function(rt){return(rt-this.x)/this.k},invertY:function(rt){return(rt-this.y)/this.k},rescaleX:function(rt){return rt.copy().domain(rt.range().map(this.invertX,this).map(rt.invert,rt))},rescaleY:function(rt){return rt.copy().domain(rt.range().map(this.invertY,this).map(rt.invert,rt))},toString:function(){return"translate("+this.x+","+this.y+") scale("+this.k+")"}};Transform.prototype;var selectSvgElement=__name(rt=>{const{securityLevel:it}=getConfig2();let ct=select("body");if(it==="sandbox"){const pt=select(`#i${rt}`).node()?.contentDocument??document;ct=select(pt.body)}return ct.select(`#${rt}`)},"selectSvgElement");function isNothing(rt){return typeof rt>"u"||rt===null}__name(isNothing,"isNothing");function isObject$2(rt){return typeof rt=="object"&&rt!==null}__name(isObject$2,"isObject");function toArray(rt){return Array.isArray(rt)?rt:isNothing(rt)?[]:[rt]}__name(toArray,"toArray");function extend(rt,it){var ct,dt,ut,pt;if(it)for(pt=Object.keys(it),ct=0,dt=pt.length;ct<dt;ct+=1)ut=pt[ct],rt[ut]=it[ut];return rt}__name(extend,"extend");function repeat(rt,it){var ct="",dt;for(dt=0;dt<it;dt+=1)ct+=rt;return ct}__name(repeat,"repeat");function isNegativeZero(rt){return rt===0&&Number.NEGATIVE_INFINITY===1/rt}__name(isNegativeZero,"isNegativeZero");var isNothing_1=isNothing,isObject_1=isObject$2,toArray_1=toArray,repeat_1=repeat,isNegativeZero_1=isNegativeZero,extend_1=extend,common={isNothing:isNothing_1,isObject:isObject_1,toArray:toArray_1,repeat:repeat_1,isNegativeZero:isNegativeZero_1,extend:extend_1};function formatError(rt,it){var ct="",dt=rt.reason||"(unknown reason)";return rt.mark?(rt.mark.name&&(ct+='in "'+rt.mark.name+'" '),ct+="("+(rt.mark.line+1)+":"+(rt.mark.column+1)+")",!it&&rt.mark.snippet&&(ct+=`
-
-`+rt.mark.snippet),dt+" "+ct):dt}__name(formatError,"formatError");function YAMLException$1(rt,it){Error.call(this),this.name="YAMLException",this.reason=rt,this.mark=it,this.message=formatError(this,!1),Error.captureStackTrace?Error.captureStackTrace(this,this.constructor):this.stack=new Error().stack||""}__name(YAMLException$1,"YAMLException$1");YAMLException$1.prototype=Object.create(Error.prototype);YAMLException$1.prototype.constructor=YAMLException$1;YAMLException$1.prototype.toString=__name(function rt(it){return this.name+": "+formatError(this,it)},"toString");var exception=YAMLException$1;function getLine(rt,it,ct,dt,ut){var pt="",yt="",ft=Math.floor(ut/2)-1;return dt-it>ft&&(pt=" ... ",it=dt-ft+pt.length),ct-dt>ft&&(yt=" ...",ct=dt+ft-yt.length),{str:pt+rt.slice(it,ct).replace(/\t/g,"→")+yt,pos:dt-it+pt.length}}__name(getLine,"getLine");function padStart(rt,it){return common.repeat(" ",it-rt.length)+rt}__name(padStart,"padStart");function makeSnippet(rt,it){if(it=Object.create(it||null),!rt.buffer)return null;it.maxLength||(it.maxLength=79),typeof it.indent!="number"&&(it.indent=1),typeof it.linesBefore!="number"&&(it.linesBefore=3),typeof it.linesAfter!="number"&&(it.linesAfter=2);for(var ct=/\r?\n|\r|\0/g,dt=[0],ut=[],pt,yt=-1;pt=ct.exec(rt.buffer);)ut.push(pt.index),dt.push(pt.index+pt[0].length),rt.position<=pt.index&&yt<0&&(yt=dt.length-2);yt<0&&(yt=dt.length-1);var ft="",mt,kt,_t=Math.min(rt.line+it.linesAfter,ut.length).toString().length,vt=it.maxLength-(it.indent+_t+3);for(mt=1;mt<=it.linesBefore&&!(yt-mt<0);mt++)kt=getLine(rt.buffer,dt[yt-mt],ut[yt-mt],rt.position-(dt[yt]-dt[yt-mt]),vt),ft=common.repeat(" ",it.indent)+padStart((rt.line-mt+1).toString(),_t)+" | "+kt.str+`
-`+ft;for(kt=getLine(rt.buffer,dt[yt],ut[yt],rt.position,vt),ft+=common.repeat(" ",it.indent)+padStart((rt.line+1).toString(),_t)+" | "+kt.str+`
-`,ft+=common.repeat("-",it.indent+_t+3+kt.pos)+`^
-`,mt=1;mt<=it.linesAfter&&!(yt+mt>=ut.length);mt++)kt=getLine(rt.buffer,dt[yt+mt],ut[yt+mt],rt.position-(dt[yt]-dt[yt+mt]),vt),ft+=common.repeat(" ",it.indent)+padStart((rt.line+mt+1).toString(),_t)+" | "+kt.str+`
-`;return ft.replace(/\n$/,"")}__name(makeSnippet,"makeSnippet");var snippet=makeSnippet,TYPE_CONSTRUCTOR_OPTIONS=["kind","multi","resolve","construct","instanceOf","predicate","represent","representName","defaultStyle","styleAliases"],YAML_NODE_KINDS=["scalar","sequence","mapping"];function compileStyleAliases(rt){var it={};return rt!==null&&Object.keys(rt).forEach(function(ct){rt[ct].forEach(function(dt){it[String(dt)]=ct})}),it}__name(compileStyleAliases,"compileStyleAliases");function Type$1(rt,it){if(it=it||{},Object.keys(it).forEach(function(ct){if(TYPE_CONSTRUCTOR_OPTIONS.indexOf(ct)===-1)throw new exception('Unknown option "'+ct+'" is met in definition of "'+rt+'" YAML type.')}),this.options=it,this.tag=rt,this.kind=it.kind||null,this.resolve=it.resolve||function(){return!0},this.construct=it.construct||function(ct){return ct},this.instanceOf=it.instanceOf||null,this.predicate=it.predicate||null,this.represent=it.represent||null,this.representName=it.representName||null,this.defaultStyle=it.defaultStyle||null,this.multi=it.multi||!1,this.styleAliases=compileStyleAliases(it.styleAliases||null),YAML_NODE_KINDS.indexOf(this.kind)===-1)throw new exception('Unknown kind "'+this.kind+'" is specified for "'+rt+'" YAML type.')}__name(Type$1,"Type$1");var type=Type$1;function compileList(rt,it){var ct=[];return rt[it].forEach(function(dt){var ut=ct.length;ct.forEach(function(pt,yt){pt.tag===dt.tag&&pt.kind===dt.kind&&pt.multi===dt.multi&&(ut=yt)}),ct[ut]=dt}),ct}__name(compileList,"compileList");function compileMap(){var rt={scalar:{},sequence:{},mapping:{},fallback:{},multi:{scalar:[],sequence:[],mapping:[],fallback:[]}},it,ct;function dt(ut){ut.multi?(rt.multi[ut.kind].push(ut),rt.multi.fallback.push(ut)):rt[ut.kind][ut.tag]=rt.fallback[ut.tag]=ut}for(__name(dt,"collectType"),it=0,ct=arguments.length;it<ct;it+=1)arguments[it].forEach(dt);return rt}__name(compileMap,"compileMap");function Schema$1(rt){return this.extend(rt)}__name(Schema$1,"Schema$1");Schema$1.prototype.extend=__name(function rt(it){var ct=[],dt=[];if(it instanceof type)dt.push(it);else if(Array.isArray(it))dt=dt.concat(it);else if(it&&(Array.isArray(it.implicit)||Array.isArray(it.explicit)))it.implicit&&(ct=ct.concat(it.implicit)),it.explicit&&(dt=dt.concat(it.explicit));else throw new exception("Schema.extend argument should be a Type, [ Type ], or a schema definition ({ implicit: [...], explicit: [...] })");ct.forEach(function(pt){if(!(pt instanceof type))throw new exception("Specified list of YAML types (or a single Type object) contains a non-Type object.");if(pt.loadKind&&pt.loadKind!=="scalar")throw new exception("There is a non-scalar type in the implicit list of a schema. Implicit resolving of such types is not supported.");if(pt.multi)throw new exception("There is a multi type in the implicit list of a schema. Multi tags can only be listed as explicit.")}),dt.forEach(function(pt){if(!(pt instanceof type))throw new exception("Specified list of YAML types (or a single Type object) contains a non-Type object.")});var ut=Object.create(Schema$1.prototype);return ut.implicit=(this.implicit||[]).concat(ct),ut.explicit=(this.explicit||[]).concat(dt),ut.compiledImplicit=compileList(ut,"implicit"),ut.compiledExplicit=compileList(ut,"explicit"),ut.compiledTypeMap=compileMap(ut.compiledImplicit,ut.compiledExplicit),ut},"extend");var schema=Schema$1,str=new type("tag:yaml.org,2002:str",{kind:"scalar",construct:__name(function(rt){return rt!==null?rt:""},"construct")}),seq=new type("tag:yaml.org,2002:seq",{kind:"sequence",construct:__name(function(rt){return rt!==null?rt:[]},"construct")}),map=new type("tag:yaml.org,2002:map",{kind:"mapping",construct:__name(function(rt){return rt!==null?rt:{}},"construct")}),failsafe=new schema({explicit:[str,seq,map]});function resolveYamlNull(rt){if(rt===null)return!0;var it=rt.length;return it===1&&rt==="~"||it===4&&(rt==="null"||rt==="Null"||rt==="NULL")}__name(resolveYamlNull,"resolveYamlNull");function constructYamlNull(){return null}__name(constructYamlNull,"constructYamlNull");function isNull(rt){return rt===null}__name(isNull,"isNull");var _null=new type("tag:yaml.org,2002:null",{kind:"scalar",resolve:resolveYamlNull,construct:constructYamlNull,predicate:isNull,represent:{canonical:__name(function(){return"~"},"canonical"),lowercase:__name(function(){return"null"},"lowercase"),uppercase:__name(function(){return"NULL"},"uppercase"),camelcase:__name(function(){return"Null"},"camelcase"),empty:__name(function(){return""},"empty")},defaultStyle:"lowercase"});function resolveYamlBoolean(rt){if(rt===null)return!1;var it=rt.length;return it===4&&(rt==="true"||rt==="True"||rt==="TRUE")||it===5&&(rt==="false"||rt==="False"||rt==="FALSE")}__name(resolveYamlBoolean,"resolveYamlBoolean");function constructYamlBoolean(rt){return rt==="true"||rt==="True"||rt==="TRUE"}__name(constructYamlBoolean,"constructYamlBoolean");function isBoolean$1(rt){return Object.prototype.toString.call(rt)==="[object Boolean]"}__name(isBoolean$1,"isBoolean");var bool=new type("tag:yaml.org,2002:bool",{kind:"scalar",resolve:resolveYamlBoolean,construct:constructYamlBoolean,predicate:isBoolean$1,represent:{lowercase:__name(function(rt){return rt?"true":"false"},"lowercase"),uppercase:__name(function(rt){return rt?"TRUE":"FALSE"},"uppercase"),camelcase:__name(function(rt){return rt?"True":"False"},"camelcase")},defaultStyle:"lowercase"});function isHexCode(rt){return 48<=rt&&rt<=57||65<=rt&&rt<=70||97<=rt&&rt<=102}__name(isHexCode,"isHexCode");function isOctCode(rt){return 48<=rt&&rt<=55}__name(isOctCode,"isOctCode");function isDecCode(rt){return 48<=rt&&rt<=57}__name(isDecCode,"isDecCode");function resolveYamlInteger(rt){if(rt===null)return!1;var it=rt.length,ct=0,dt=!1,ut;if(!it)return!1;if(ut=rt[ct],(ut==="-"||ut==="+")&&(ut=rt[++ct]),ut==="0"){if(ct+1===it)return!0;if(ut=rt[++ct],ut==="b"){for(ct++;ct<it;ct++)if(ut=rt[ct],ut!=="_"){if(ut!=="0"&&ut!=="1")return!1;dt=!0}return dt&&ut!=="_"}if(ut==="x"){for(ct++;ct<it;ct++)if(ut=rt[ct],ut!=="_"){if(!isHexCode(rt.charCodeAt(ct)))return!1;dt=!0}return dt&&ut!=="_"}if(ut==="o"){for(ct++;ct<it;ct++)if(ut=rt[ct],ut!=="_"){if(!isOctCode(rt.charCodeAt(ct)))return!1;dt=!0}return dt&&ut!=="_"}}if(ut==="_")return!1;for(;ct<it;ct++)if(ut=rt[ct],ut!=="_"){if(!isDecCode(rt.charCodeAt(ct)))return!1;dt=!0}return!(!dt||ut==="_")}__name(resolveYamlInteger,"resolveYamlInteger");function constructYamlInteger(rt){var it=rt,ct=1,dt;if(it.indexOf("_")!==-1&&(it=it.replace(/_/g,"")),dt=it[0],(dt==="-"||dt==="+")&&(dt==="-"&&(ct=-1),it=it.slice(1),dt=it[0]),it==="0")return 0;if(dt==="0"){if(it[1]==="b")return ct*parseInt(it.slice(2),2);if(it[1]==="x")return ct*parseInt(it.slice(2),16);if(it[1]==="o")return ct*parseInt(it.slice(2),8)}return ct*parseInt(it,10)}__name(constructYamlInteger,"constructYamlInteger");function isInteger(rt){return Object.prototype.toString.call(rt)==="[object Number]"&&rt%1===0&&!common.isNegativeZero(rt)}__name(isInteger,"isInteger");var int=new type("tag:yaml.org,2002:int",{kind:"scalar",resolve:resolveYamlInteger,construct:constructYamlInteger,predicate:isInteger,represent:{binary:__name(function(rt){return rt>=0?"0b"+rt.toString(2):"-0b"+rt.toString(2).slice(1)},"binary"),octal:__name(function(rt){return rt>=0?"0o"+rt.toString(8):"-0o"+rt.toString(8).slice(1)},"octal"),decimal:__name(function(rt){return rt.toString(10)},"decimal"),hexadecimal:__name(function(rt){return rt>=0?"0x"+rt.toString(16).toUpperCase():"-0x"+rt.toString(16).toUpperCase().slice(1)},"hexadecimal")},defaultStyle:"decimal",styleAliases:{binary:[2,"bin"],octal:[8,"oct"],decimal:[10,"dec"],hexadecimal:[16,"hex"]}}),YAML_FLOAT_PATTERN=new RegExp("^(?:[-+]?(?:[0-9][0-9_]*)(?:\\.[0-9_]*)?(?:[eE][-+]?[0-9]+)?|\\.[0-9_]+(?:[eE][-+]?[0-9]+)?|[-+]?\\.(?:inf|Inf|INF)|\\.(?:nan|NaN|NAN))$");function resolveYamlFloat(rt){return!(rt===null||!YAML_FLOAT_PATTERN.test(rt)||rt[rt.length-1]==="_")}__name(resolveYamlFloat,"resolveYamlFloat");function constructYamlFloat(rt){var it,ct;return it=rt.replace(/_/g,"").toLowerCase(),ct=it[0]==="-"?-1:1,"+-".indexOf(it[0])>=0&&(it=it.slice(1)),it===".inf"?ct===1?Number.POSITIVE_INFINITY:Number.NEGATIVE_INFINITY:it===".nan"?NaN:ct*parseFloat(it,10)}__name(constructYamlFloat,"constructYamlFloat");var SCIENTIFIC_WITHOUT_DOT=/^[-+]?[0-9]+e/;function representYamlFloat(rt,it){var ct;if(isNaN(rt))switch(it){case"lowercase":return".nan";case"uppercase":return".NAN";case"camelcase":return".NaN"}else if(Number.POSITIVE_INFINITY===rt)switch(it){case"lowercase":return".inf";case"uppercase":return".INF";case"camelcase":return".Inf"}else if(Number.NEGATIVE_INFINITY===rt)switch(it){case"lowercase":return"-.inf";case"uppercase":return"-.INF";case"camelcase":return"-.Inf"}else if(common.isNegativeZero(rt))return"-0.0";return ct=rt.toString(10),SCIENTIFIC_WITHOUT_DOT.test(ct)?ct.replace("e",".e"):ct}__name(representYamlFloat,"representYamlFloat");function isFloat(rt){return Object.prototype.toString.call(rt)==="[object Number]"&&(rt%1!==0||common.isNegativeZero(rt))}__name(isFloat,"isFloat");var float=new type("tag:yaml.org,2002:float",{kind:"scalar",resolve:resolveYamlFloat,construct:constructYamlFloat,predicate:isFloat,represent:representYamlFloat,defaultStyle:"lowercase"}),json=failsafe.extend({implicit:[_null,bool,int,float]}),core=json,YAML_DATE_REGEXP=new RegExp("^([0-9][0-9][0-9][0-9])-([0-9][0-9])-([0-9][0-9])$"),YAML_TIMESTAMP_REGEXP=new RegExp("^([0-9][0-9][0-9][0-9])-([0-9][0-9]?)-([0-9][0-9]?)(?:[Tt]|[ \\t]+)([0-9][0-9]?):([0-9][0-9]):([0-9][0-9])(?:\\.([0-9]*))?(?:[ \\t]*(Z|([-+])([0-9][0-9]?)(?::([0-9][0-9]))?))?$");function resolveYamlTimestamp(rt){return rt===null?!1:YAML_DATE_REGEXP.exec(rt)!==null||YAML_TIMESTAMP_REGEXP.exec(rt)!==null}__name(resolveYamlTimestamp,"resolveYamlTimestamp");function constructYamlTimestamp(rt){var it,ct,dt,ut,pt,yt,ft,mt=0,kt=null,_t,vt,bt;if(it=YAML_DATE_REGEXP.exec(rt),it===null&&(it=YAML_TIMESTAMP_REGEXP.exec(rt)),it===null)throw new Error("Date resolve error");if(ct=+it[1],dt=+it[2]-1,ut=+it[3],!it[4])return new Date(Date.UTC(ct,dt,ut));if(pt=+it[4],yt=+it[5],ft=+it[6],it[7]){for(mt=it[7].slice(0,3);mt.length<3;)mt+="0";mt=+mt}return it[9]&&(_t=+it[10],vt=+(it[11]||0),kt=(_t*60+vt)*6e4,it[9]==="-"&&(kt=-kt)),bt=new Date(Date.UTC(ct,dt,ut,pt,yt,ft,mt)),kt&&bt.setTime(bt.getTime()-kt),bt}__name(constructYamlTimestamp,"constructYamlTimestamp");function representYamlTimestamp(rt){return rt.toISOString()}__name(representYamlTimestamp,"representYamlTimestamp");var timestamp=new type("tag:yaml.org,2002:timestamp",{kind:"scalar",resolve:resolveYamlTimestamp,construct:constructYamlTimestamp,instanceOf:Date,represent:representYamlTimestamp});function resolveYamlMerge(rt){return rt==="<<"||rt===null}__name(resolveYamlMerge,"resolveYamlMerge");var merge$1=new type("tag:yaml.org,2002:merge",{kind:"scalar",resolve:resolveYamlMerge}),BASE64_MAP=`ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=
-\r`;function resolveYamlBinary(rt){if(rt===null)return!1;var it,ct,dt=0,ut=rt.length,pt=BASE64_MAP;for(ct=0;ct<ut;ct++)if(it=pt.indexOf(rt.charAt(ct)),!(it>64)){if(it<0)return!1;dt+=6}return dt%8===0}__name(resolveYamlBinary,"resolveYamlBinary");function constructYamlBinary(rt){var it,ct,dt=rt.replace(/[\r\n=]/g,""),ut=dt.length,pt=BASE64_MAP,yt=0,ft=[];for(it=0;it<ut;it++)it%4===0&&it&&(ft.push(yt>>16&255),ft.push(yt>>8&255),ft.push(yt&255)),yt=yt<<6|pt.indexOf(dt.charAt(it));return ct=ut%4*6,ct===0?(ft.push(yt>>16&255),ft.push(yt>>8&255),ft.push(yt&255)):ct===18?(ft.push(yt>>10&255),ft.push(yt>>2&255)):ct===12&&ft.push(yt>>4&255),new Uint8Array(ft)}__name(constructYamlBinary,"constructYamlBinary");function representYamlBinary(rt){var it="",ct=0,dt,ut,pt=rt.length,yt=BASE64_MAP;for(dt=0;dt<pt;dt++)dt%3===0&&dt&&(it+=yt[ct>>18&63],it+=yt[ct>>12&63],it+=yt[ct>>6&63],it+=yt[ct&63]),ct=(ct<<8)+rt[dt];return ut=pt%3,ut===0?(it+=yt[ct>>18&63],it+=yt[ct>>12&63],it+=yt[ct>>6&63],it+=yt[ct&63]):ut===2?(it+=yt[ct>>10&63],it+=yt[ct>>4&63],it+=yt[ct<<2&63],it+=yt[64]):ut===1&&(it+=yt[ct>>2&63],it+=yt[ct<<4&63],it+=yt[64],it+=yt[64]),it}__name(representYamlBinary,"representYamlBinary");function isBinary(rt){return Object.prototype.toString.call(rt)==="[object Uint8Array]"}__name(isBinary,"isBinary");var binary=new type("tag:yaml.org,2002:binary",{kind:"scalar",resolve:resolveYamlBinary,construct:constructYamlBinary,predicate:isBinary,represent:representYamlBinary}),_hasOwnProperty$3=Object.prototype.hasOwnProperty,_toString$2=Object.prototype.toString;function resolveYamlOmap(rt){if(rt===null)return!0;var it=[],ct,dt,ut,pt,yt,ft=rt;for(ct=0,dt=ft.length;ct<dt;ct+=1){if(ut=ft[ct],yt=!1,_toString$2.call(ut)!=="[object Object]")return!1;for(pt in ut)if(_hasOwnProperty$3.call(ut,pt))if(!yt)yt=!0;else return!1;if(!yt)return!1;if(it.indexOf(pt)===-1)it.push(pt);else return!1}return!0}__name(resolveYamlOmap,"resolveYamlOmap");function constructYamlOmap(rt){return rt!==null?rt:[]}__name(constructYamlOmap,"constructYamlOmap");var omap=new type("tag:yaml.org,2002:omap",{kind:"sequence",resolve:resolveYamlOmap,construct:constructYamlOmap}),_toString$1=Object.prototype.toString;function resolveYamlPairs(rt){if(rt===null)return!0;var it,ct,dt,ut,pt,yt=rt;for(pt=new Array(yt.length),it=0,ct=yt.length;it<ct;it+=1){if(dt=yt[it],_toString$1.call(dt)!=="[object Object]"||(ut=Object.keys(dt),ut.length!==1))return!1;pt[it]=[ut[0],dt[ut[0]]]}return!0}__name(resolveYamlPairs,"resolveYamlPairs");function constructYamlPairs(rt){if(rt===null)return[];var it,ct,dt,ut,pt,yt=rt;for(pt=new Array(yt.length),it=0,ct=yt.length;it<ct;it+=1)dt=yt[it],ut=Object.keys(dt),pt[it]=[ut[0],dt[ut[0]]];return pt}__name(constructYamlPairs,"constructYamlPairs");var pairs=new type("tag:yaml.org,2002:pairs",{kind:"sequence",resolve:resolveYamlPairs,construct:constructYamlPairs}),_hasOwnProperty$2=Object.prototype.hasOwnProperty;function resolveYamlSet(rt){if(rt===null)return!0;var it,ct=rt;for(it in ct)if(_hasOwnProperty$2.call(ct,it)&&ct[it]!==null)return!1;return!0}__name(resolveYamlSet,"resolveYamlSet");function constructYamlSet(rt){return rt!==null?rt:{}}__name(constructYamlSet,"constructYamlSet");var set=new type("tag:yaml.org,2002:set",{kind:"mapping",resolve:resolveYamlSet,construct:constructYamlSet}),_default=core.extend({implicit:[timestamp,merge$1],explicit:[binary,omap,pairs,set]}),_hasOwnProperty$1=Object.prototype.hasOwnProperty,CONTEXT_FLOW_IN=1,CONTEXT_FLOW_OUT=2,CONTEXT_BLOCK_IN=3,CONTEXT_BLOCK_OUT=4,CHOMPING_CLIP=1,CHOMPING_STRIP=2,CHOMPING_KEEP=3,PATTERN_NON_PRINTABLE=/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F-\x84\x86-\x9F\uFFFE\uFFFF]|[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?:[^\uD800-\uDBFF]|^)[\uDC00-\uDFFF]/,PATTERN_NON_ASCII_LINE_BREAKS=/[\x85\u2028\u2029]/,PATTERN_FLOW_INDICATORS=/[,\[\]\{\}]/,PATTERN_TAG_HANDLE=/^(?:!|!!|![a-z\-]+!)$/i,PATTERN_TAG_URI=/^(?:!|[^,\[\]\{\}])(?:%[0-9a-f]{2}|[0-9a-z\-#;\/\?:@&=\+\$,_\.!~\*'\(\)\[\]])*$/i;function _class(rt){return Object.prototype.toString.call(rt)}__name(_class,"_class");function is_EOL(rt){return rt===10||rt===13}__name(is_EOL,"is_EOL");function is_WHITE_SPACE(rt){return rt===9||rt===32}__name(is_WHITE_SPACE,"is_WHITE_SPACE");function is_WS_OR_EOL(rt){return rt===9||rt===32||rt===10||rt===13}__name(is_WS_OR_EOL,"is_WS_OR_EOL");function is_FLOW_INDICATOR(rt){return rt===44||rt===91||rt===93||rt===123||rt===125}__name(is_FLOW_INDICATOR,"is_FLOW_INDICATOR");function fromHexCode(rt){var it;return 48<=rt&&rt<=57?rt-48:(it=rt|32,97<=it&&it<=102?it-97+10:-1)}__name(fromHexCode,"fromHexCode");function escapedHexLen(rt){return rt===120?2:rt===117?4:rt===85?8:0}__name(escapedHexLen,"escapedHexLen");function fromDecimalCode(rt){return 48<=rt&&rt<=57?rt-48:-1}__name(fromDecimalCode,"fromDecimalCode");function simpleEscapeSequence(rt){return rt===48?"\0":rt===97?"\x07":rt===98?"\b":rt===116||rt===9?"	":rt===110?`
-`:rt===118?"\v":rt===102?"\f":rt===114?"\r":rt===101?"\x1B":rt===32?" ":rt===34?'"':rt===47?"/":rt===92?"\\":rt===78?"…":rt===95?" ":rt===76?"\u2028":rt===80?"\u2029":""}__name(simpleEscapeSequence,"simpleEscapeSequence");function charFromCodepoint(rt){return rt<=65535?String.fromCharCode(rt):String.fromCharCode((rt-65536>>10)+55296,(rt-65536&1023)+56320)}__name(charFromCodepoint,"charFromCodepoint");var simpleEscapeCheck=new Array(256),simpleEscapeMap=new Array(256);for(i$2=0;i$2<256;i$2++)simpleEscapeCheck[i$2]=simpleEscapeSequence(i$2)?1:0,simpleEscapeMap[i$2]=simpleEscapeSequence(i$2);var i$2;function State$1(rt,it){this.input=rt,this.filename=it.filename||null,this.schema=it.schema||_default,this.onWarning=it.onWarning||null,this.legacy=it.legacy||!1,this.json=it.json||!1,this.listener=it.listener||null,this.implicitTypes=this.schema.compiledImplicit,this.typeMap=this.schema.compiledTypeMap,this.length=rt.length,this.position=0,this.line=0,this.lineStart=0,this.lineIndent=0,this.firstTabInLine=-1,this.documents=[]}__name(State$1,"State$1");function generateError(rt,it){var ct={name:rt.filename,buffer:rt.input.slice(0,-1),position:rt.position,line:rt.line,column:rt.position-rt.lineStart};return ct.snippet=snippet(ct),new exception(it,ct)}__name(generateError,"generateError");function throwError(rt,it){throw generateError(rt,it)}__name(throwError,"throwError");function throwWarning(rt,it){rt.onWarning&&rt.onWarning.call(null,generateError(rt,it))}__name(throwWarning,"throwWarning");var directiveHandlers={YAML:__name(function rt(it,ct,dt){var ut,pt,yt;it.version!==null&&throwError(it,"duplication of %YAML directive"),dt.length!==1&&throwError(it,"YAML directive accepts exactly one argument"),ut=/^([0-9]+)\.([0-9]+)$/.exec(dt[0]),ut===null&&throwError(it,"ill-formed argument of the YAML directive"),pt=parseInt(ut[1],10),yt=parseInt(ut[2],10),pt!==1&&throwError(it,"unacceptable YAML version of the document"),it.version=dt[0],it.checkLineBreaks=yt<2,yt!==1&&yt!==2&&throwWarning(it,"unsupported YAML version of the document")},"handleYamlDirective"),TAG:__name(function rt(it,ct,dt){var ut,pt;dt.length!==2&&throwError(it,"TAG directive accepts exactly two arguments"),ut=dt[0],pt=dt[1],PATTERN_TAG_HANDLE.test(ut)||throwError(it,"ill-formed tag handle (first argument) of the TAG directive"),_hasOwnProperty$1.call(it.tagMap,ut)&&throwError(it,'there is a previously declared suffix for "'+ut+'" tag handle'),PATTERN_TAG_URI.test(pt)||throwError(it,"ill-formed tag prefix (second argument) of the TAG directive");try{pt=decodeURIComponent(pt)}catch{throwError(it,"tag prefix is malformed: "+pt)}it.tagMap[ut]=pt},"handleTagDirective")};function captureSegment(rt,it,ct,dt){var ut,pt,yt,ft;if(it<ct){if(ft=rt.input.slice(it,ct),dt)for(ut=0,pt=ft.length;ut<pt;ut+=1)yt=ft.charCodeAt(ut),yt===9||32<=yt&&yt<=1114111||throwError(rt,"expected valid JSON character");else PATTERN_NON_PRINTABLE.test(ft)&&throwError(rt,"the stream contains non-printable characters");rt.result+=ft}}__name(captureSegment,"captureSegment");function mergeMappings(rt,it,ct,dt){var ut,pt,yt,ft;for(common.isObject(ct)||throwError(rt,"cannot merge mappings; the provided source object is unacceptable"),ut=Object.keys(ct),yt=0,ft=ut.length;yt<ft;yt+=1)pt=ut[yt],_hasOwnProperty$1.call(it,pt)||(it[pt]=ct[pt],dt[pt]=!0)}__name(mergeMappings,"mergeMappings");function storeMappingPair(rt,it,ct,dt,ut,pt,yt,ft,mt){var kt,_t;if(Array.isArray(ut))for(ut=Array.prototype.slice.call(ut),kt=0,_t=ut.length;kt<_t;kt+=1)Array.isArray(ut[kt])&&throwError(rt,"nested arrays are not supported inside keys"),typeof ut=="object"&&_class(ut[kt])==="[object Object]"&&(ut[kt]="[object Object]");if(typeof ut=="object"&&_class(ut)==="[object Object]"&&(ut="[object Object]"),ut=String(ut),it===null&&(it={}),dt==="tag:yaml.org,2002:merge")if(Array.isArray(pt))for(kt=0,_t=pt.length;kt<_t;kt+=1)mergeMappings(rt,it,pt[kt],ct);else mergeMappings(rt,it,pt,ct);else!rt.json&&!_hasOwnProperty$1.call(ct,ut)&&_hasOwnProperty$1.call(it,ut)&&(rt.line=yt||rt.line,rt.lineStart=ft||rt.lineStart,rt.position=mt||rt.position,throwError(rt,"duplicated mapping key")),ut==="__proto__"?Object.defineProperty(it,ut,{configurable:!0,enumerable:!0,writable:!0,value:pt}):it[ut]=pt,delete ct[ut];return it}__name(storeMappingPair,"storeMappingPair");function readLineBreak(rt){var it;it=rt.input.charCodeAt(rt.position),it===10?rt.position++:it===13?(rt.position++,rt.input.charCodeAt(rt.position)===10&&rt.position++):throwError(rt,"a line break is expected"),rt.line+=1,rt.lineStart=rt.position,rt.firstTabInLine=-1}__name(readLineBreak,"readLineBreak");function skipSeparationSpace(rt,it,ct){for(var dt=0,ut=rt.input.charCodeAt(rt.position);ut!==0;){for(;is_WHITE_SPACE(ut);)ut===9&&rt.firstTabInLine===-1&&(rt.firstTabInLine=rt.position),ut=rt.input.charCodeAt(++rt.position);if(it&&ut===35)do ut=rt.input.charCodeAt(++rt.position);while(ut!==10&&ut!==13&&ut!==0);if(is_EOL(ut))for(readLineBreak(rt),ut=rt.input.charCodeAt(rt.position),dt++,rt.lineIndent=0;ut===32;)rt.lineIndent++,ut=rt.input.charCodeAt(++rt.position);else break}return ct!==-1&&dt!==0&&rt.lineIndent<ct&&throwWarning(rt,"deficient indentation"),dt}__name(skipSeparationSpace,"skipSeparationSpace");function testDocumentSeparator(rt){var it=rt.position,ct;return ct=rt.input.charCodeAt(it),!!((ct===45||ct===46)&&ct===rt.input.charCodeAt(it+1)&&ct===rt.input.charCodeAt(it+2)&&(it+=3,ct=rt.input.charCodeAt(it),ct===0||is_WS_OR_EOL(ct)))}__name(testDocumentSeparator,"testDocumentSeparator");function writeFoldedLines(rt,it){it===1?rt.result+=" ":it>1&&(rt.result+=common.repeat(`
-`,it-1))}__name(writeFoldedLines,"writeFoldedLines");function readPlainScalar(rt,it,ct){var dt,ut,pt,yt,ft,mt,kt,_t,vt=rt.kind,bt=rt.result,Mt;if(Mt=rt.input.charCodeAt(rt.position),is_WS_OR_EOL(Mt)||is_FLOW_INDICATOR(Mt)||Mt===35||Mt===38||Mt===42||Mt===33||Mt===124||Mt===62||Mt===39||Mt===34||Mt===37||Mt===64||Mt===96||(Mt===63||Mt===45)&&(ut=rt.input.charCodeAt(rt.position+1),is_WS_OR_EOL(ut)||ct&&is_FLOW_INDICATOR(ut)))return!1;for(rt.kind="scalar",rt.result="",pt=yt=rt.position,ft=!1;Mt!==0;){if(Mt===58){if(ut=rt.input.charCodeAt(rt.position+1),is_WS_OR_EOL(ut)||ct&&is_FLOW_INDICATOR(ut))break}else if(Mt===35){if(dt=rt.input.charCodeAt(rt.position-1),is_WS_OR_EOL(dt))break}else{if(rt.position===rt.lineStart&&testDocumentSeparator(rt)||ct&&is_FLOW_INDICATOR(Mt))break;if(is_EOL(Mt))if(mt=rt.line,kt=rt.lineStart,_t=rt.lineIndent,skipSeparationSpace(rt,!1,-1),rt.lineIndent>=it){ft=!0,Mt=rt.input.charCodeAt(rt.position);continue}else{rt.position=yt,rt.line=mt,rt.lineStart=kt,rt.lineIndent=_t;break}}ft&&(captureSegment(rt,pt,yt,!1),writeFoldedLines(rt,rt.line-mt),pt=yt=rt.position,ft=!1),is_WHITE_SPACE(Mt)||(yt=rt.position+1),Mt=rt.input.charCodeAt(++rt.position)}return captureSegment(rt,pt,yt,!1),rt.result?!0:(rt.kind=vt,rt.result=bt,!1)}__name(readPlainScalar,"readPlainScalar");function readSingleQuotedScalar(rt,it){var ct,dt,ut;if(ct=rt.input.charCodeAt(rt.position),ct!==39)return!1;for(rt.kind="scalar",rt.result="",rt.position++,dt=ut=rt.position;(ct=rt.input.charCodeAt(rt.position))!==0;)if(ct===39)if(captureSegment(rt,dt,rt.position,!0),ct=rt.input.charCodeAt(++rt.position),ct===39)dt=rt.position,rt.position++,ut=rt.position;else return!0;else is_EOL(ct)?(captureSegment(rt,dt,ut,!0),writeFoldedLines(rt,skipSeparationSpace(rt,!1,it)),dt=ut=rt.position):rt.position===rt.lineStart&&testDocumentSeparator(rt)?throwError(rt,"unexpected end of the document within a single quoted scalar"):(rt.position++,ut=rt.position);throwError(rt,"unexpected end of the stream within a single quoted scalar")}__name(readSingleQuotedScalar,"readSingleQuotedScalar");function readDoubleQuotedScalar(rt,it){var ct,dt,ut,pt,yt,ft;if(ft=rt.input.charCodeAt(rt.position),ft!==34)return!1;for(rt.kind="scalar",rt.result="",rt.position++,ct=dt=rt.position;(ft=rt.input.charCodeAt(rt.position))!==0;){if(ft===34)return captureSegment(rt,ct,rt.position,!0),rt.position++,!0;if(ft===92){if(captureSegment(rt,ct,rt.position,!0),ft=rt.input.charCodeAt(++rt.position),is_EOL(ft))skipSeparationSpace(rt,!1,it);else if(ft<256&&simpleEscapeCheck[ft])rt.result+=simpleEscapeMap[ft],rt.position++;else if((yt=escapedHexLen(ft))>0){for(ut=yt,pt=0;ut>0;ut--)ft=rt.input.charCodeAt(++rt.position),(yt=fromHexCode(ft))>=0?pt=(pt<<4)+yt:throwError(rt,"expected hexadecimal character");rt.result+=charFromCodepoint(pt),rt.position++}else throwError(rt,"unknown escape sequence");ct=dt=rt.position}else is_EOL(ft)?(captureSegment(rt,ct,dt,!0),writeFoldedLines(rt,skipSeparationSpace(rt,!1,it)),ct=dt=rt.position):rt.position===rt.lineStart&&testDocumentSeparator(rt)?throwError(rt,"unexpected end of the document within a double quoted scalar"):(rt.position++,dt=rt.position)}throwError(rt,"unexpected end of the stream within a double quoted scalar")}__name(readDoubleQuotedScalar,"readDoubleQuotedScalar");function readFlowCollection(rt,it){var ct=!0,dt,ut,pt,yt=rt.tag,ft,mt=rt.anchor,kt,_t,vt,bt,Mt,wt=Object.create(null),St,It,Nt,$t;if($t=rt.input.charCodeAt(rt.position),$t===91)_t=93,Mt=!1,ft=[];else if($t===123)_t=125,Mt=!0,ft={};else return!1;for(rt.anchor!==null&&(rt.anchorMap[rt.anchor]=ft),$t=rt.input.charCodeAt(++rt.position);$t!==0;){if(skipSeparationSpace(rt,!0,it),$t=rt.input.charCodeAt(rt.position),$t===_t)return rt.position++,rt.tag=yt,rt.anchor=mt,rt.kind=Mt?"mapping":"sequence",rt.result=ft,!0;ct?$t===44&&throwError(rt,"expected the node content, but found ','"):throwError(rt,"missed comma between flow collection entries"),It=St=Nt=null,vt=bt=!1,$t===63&&(kt=rt.input.charCodeAt(rt.position+1),is_WS_OR_EOL(kt)&&(vt=bt=!0,rt.position++,skipSeparationSpace(rt,!0,it))),dt=rt.line,ut=rt.lineStart,pt=rt.position,composeNode(rt,it,CONTEXT_FLOW_IN,!1,!0),It=rt.tag,St=rt.result,skipSeparationSpace(rt,!0,it),$t=rt.input.charCodeAt(rt.position),(bt||rt.line===dt)&&$t===58&&(vt=!0,$t=rt.input.charCodeAt(++rt.position),skipSeparationSpace(rt,!0,it),composeNode(rt,it,CONTEXT_FLOW_IN,!1,!0),Nt=rt.result),Mt?storeMappingPair(rt,ft,wt,It,St,Nt,dt,ut,pt):vt?ft.push(storeMappingPair(rt,null,wt,It,St,Nt,dt,ut,pt)):ft.push(St),skipSeparationSpace(rt,!0,it),$t=rt.input.charCodeAt(rt.position),$t===44?(ct=!0,$t=rt.input.charCodeAt(++rt.position)):ct=!1}throwError(rt,"unexpected end of the stream within a flow collection")}__name(readFlowCollection,"readFlowCollection");function readBlockScalar(rt,it){var ct,dt,ut=CHOMPING_CLIP,pt=!1,yt=!1,ft=it,mt=0,kt=!1,_t,vt;if(vt=rt.input.charCodeAt(rt.position),vt===124)dt=!1;else if(vt===62)dt=!0;else return!1;for(rt.kind="scalar",rt.result="";vt!==0;)if(vt=rt.input.charCodeAt(++rt.position),vt===43||vt===45)CHOMPING_CLIP===ut?ut=vt===43?CHOMPING_KEEP:CHOMPING_STRIP:throwError(rt,"repeat of a chomping mode identifier");else if((_t=fromDecimalCode(vt))>=0)_t===0?throwError(rt,"bad explicit indentation width of a block scalar; it cannot be less than one"):yt?throwError(rt,"repeat of an indentation width identifier"):(ft=it+_t-1,yt=!0);else break;if(is_WHITE_SPACE(vt)){do vt=rt.input.charCodeAt(++rt.position);while(is_WHITE_SPACE(vt));if(vt===35)do vt=rt.input.charCodeAt(++rt.position);while(!is_EOL(vt)&&vt!==0)}for(;vt!==0;){for(readLineBreak(rt),rt.lineIndent=0,vt=rt.input.charCodeAt(rt.position);(!yt||rt.lineIndent<ft)&&vt===32;)rt.lineIndent++,vt=rt.input.charCodeAt(++rt.position);if(!yt&&rt.lineIndent>ft&&(ft=rt.lineIndent),is_EOL(vt)){mt++;continue}if(rt.lineIndent<ft){ut===CHOMPING_KEEP?rt.result+=common.repeat(`
-`,pt?1+mt:mt):ut===CHOMPING_CLIP&&pt&&(rt.result+=`
-`);break}for(dt?is_WHITE_SPACE(vt)?(kt=!0,rt.result+=common.repeat(`
-`,pt?1+mt:mt)):kt?(kt=!1,rt.result+=common.repeat(`
-`,mt+1)):mt===0?pt&&(rt.result+=" "):rt.result+=common.repeat(`
-`,mt):rt.result+=common.repeat(`
-`,pt?1+mt:mt),pt=!0,yt=!0,mt=0,ct=rt.position;!is_EOL(vt)&&vt!==0;)vt=rt.input.charCodeAt(++rt.position);captureSegment(rt,ct,rt.position,!1)}return!0}__name(readBlockScalar,"readBlockScalar");function readBlockSequence(rt,it){var ct,dt=rt.tag,ut=rt.anchor,pt=[],yt,ft=!1,mt;if(rt.firstTabInLine!==-1)return!1;for(rt.anchor!==null&&(rt.anchorMap[rt.anchor]=pt),mt=rt.input.charCodeAt(rt.position);mt!==0&&(rt.firstTabInLine!==-1&&(rt.position=rt.firstTabInLine,throwError(rt,"tab characters must not be used in indentation")),!(mt!==45||(yt=rt.input.charCodeAt(rt.position+1),!is_WS_OR_EOL(yt))));){if(ft=!0,rt.position++,skipSeparationSpace(rt,!0,-1)&&rt.lineIndent<=it){pt.push(null),mt=rt.input.charCodeAt(rt.position);continue}if(ct=rt.line,composeNode(rt,it,CONTEXT_BLOCK_IN,!1,!0),pt.push(rt.result),skipSeparationSpace(rt,!0,-1),mt=rt.input.charCodeAt(rt.position),(rt.line===ct||rt.lineIndent>it)&&mt!==0)throwError(rt,"bad indentation of a sequence entry");else if(rt.lineIndent<it)break}return ft?(rt.tag=dt,rt.anchor=ut,rt.kind="sequence",rt.result=pt,!0):!1}__name(readBlockSequence,"readBlockSequence");function readBlockMapping(rt,it,ct){var dt,ut,pt,yt,ft,mt,kt=rt.tag,_t=rt.anchor,vt={},bt=Object.create(null),Mt=null,wt=null,St=null,It=!1,Nt=!1,$t;if(rt.firstTabInLine!==-1)return!1;for(rt.anchor!==null&&(rt.anchorMap[rt.anchor]=vt),$t=rt.input.charCodeAt(rt.position);$t!==0;){if(!It&&rt.firstTabInLine!==-1&&(rt.position=rt.firstTabInLine,throwError(rt,"tab characters must not be used in indentation")),dt=rt.input.charCodeAt(rt.position+1),pt=rt.line,($t===63||$t===58)&&is_WS_OR_EOL(dt))$t===63?(It&&(storeMappingPair(rt,vt,bt,Mt,wt,null,yt,ft,mt),Mt=wt=St=null),Nt=!0,It=!0,ut=!0):It?(It=!1,ut=!0):throwError(rt,"incomplete explicit mapping pair; a key node is missed; or followed by a non-tabulated empty line"),rt.position+=1,$t=dt;else{if(yt=rt.line,ft=rt.lineStart,mt=rt.position,!composeNode(rt,ct,CONTEXT_FLOW_OUT,!1,!0))break;if(rt.line===pt){for($t=rt.input.charCodeAt(rt.position);is_WHITE_SPACE($t);)$t=rt.input.charCodeAt(++rt.position);if($t===58)$t=rt.input.charCodeAt(++rt.position),is_WS_OR_EOL($t)||throwError(rt,"a whitespace character is expected after the key-value separator within a block mapping"),It&&(storeMappingPair(rt,vt,bt,Mt,wt,null,yt,ft,mt),Mt=wt=St=null),Nt=!0,It=!1,ut=!1,Mt=rt.tag,wt=rt.result;else if(Nt)throwError(rt,"can not read an implicit mapping pair; a colon is missed");else return rt.tag=kt,rt.anchor=_t,!0}else if(Nt)throwError(rt,"can not read a block mapping entry; a multiline key may not be an implicit key");else return rt.tag=kt,rt.anchor=_t,!0}if((rt.line===pt||rt.lineIndent>it)&&(It&&(yt=rt.line,ft=rt.lineStart,mt=rt.position),composeNode(rt,it,CONTEXT_BLOCK_OUT,!0,ut)&&(It?wt=rt.result:St=rt.result),It||(storeMappingPair(rt,vt,bt,Mt,wt,St,yt,ft,mt),Mt=wt=St=null),skipSeparationSpace(rt,!0,-1),$t=rt.input.charCodeAt(rt.position)),(rt.line===pt||rt.lineIndent>it)&&$t!==0)throwError(rt,"bad indentation of a mapping entry");else if(rt.lineIndent<it)break}return It&&storeMappingPair(rt,vt,bt,Mt,wt,null,yt,ft,mt),Nt&&(rt.tag=kt,rt.anchor=_t,rt.kind="mapping",rt.result=vt),Nt}__name(readBlockMapping,"readBlockMapping");function readTagProperty(rt){var it,ct=!1,dt=!1,ut,pt,yt;if(yt=rt.input.charCodeAt(rt.position),yt!==33)return!1;if(rt.tag!==null&&throwError(rt,"duplication of a tag property"),yt=rt.input.charCodeAt(++rt.position),yt===60?(ct=!0,yt=rt.input.charCodeAt(++rt.position)):yt===33?(dt=!0,ut="!!",yt=rt.input.charCodeAt(++rt.position)):ut="!",it=rt.position,ct){do yt=rt.input.charCodeAt(++rt.position);while(yt!==0&&yt!==62);rt.position<rt.length?(pt=rt.input.slice(it,rt.position),yt=rt.input.charCodeAt(++rt.position)):throwError(rt,"unexpected end of the stream within a verbatim tag")}else{for(;yt!==0&&!is_WS_OR_EOL(yt);)yt===33&&(dt?throwError(rt,"tag suffix cannot contain exclamation marks"):(ut=rt.input.slice(it-1,rt.position+1),PATTERN_TAG_HANDLE.test(ut)||throwError(rt,"named tag handle cannot contain such characters"),dt=!0,it=rt.position+1)),yt=rt.input.charCodeAt(++rt.position);pt=rt.input.slice(it,rt.position),PATTERN_FLOW_INDICATORS.test(pt)&&throwError(rt,"tag suffix cannot contain flow indicator characters")}pt&&!PATTERN_TAG_URI.test(pt)&&throwError(rt,"tag name cannot contain such characters: "+pt);try{pt=decodeURIComponent(pt)}catch{throwError(rt,"tag name is malformed: "+pt)}return ct?rt.tag=pt:_hasOwnProperty$1.call(rt.tagMap,ut)?rt.tag=rt.tagMap[ut]+pt:ut==="!"?rt.tag="!"+pt:ut==="!!"?rt.tag="tag:yaml.org,2002:"+pt:throwError(rt,'undeclared tag handle "'+ut+'"'),!0}__name(readTagProperty,"readTagProperty");function readAnchorProperty(rt){var it,ct;if(ct=rt.input.charCodeAt(rt.position),ct!==38)return!1;for(rt.anchor!==null&&throwError(rt,"duplication of an anchor property"),ct=rt.input.charCodeAt(++rt.position),it=rt.position;ct!==0&&!is_WS_OR_EOL(ct)&&!is_FLOW_INDICATOR(ct);)ct=rt.input.charCodeAt(++rt.position);return rt.position===it&&throwError(rt,"name of an anchor node must contain at least one character"),rt.anchor=rt.input.slice(it,rt.position),!0}__name(readAnchorProperty,"readAnchorProperty");function readAlias(rt){var it,ct,dt;if(dt=rt.input.charCodeAt(rt.position),dt!==42)return!1;for(dt=rt.input.charCodeAt(++rt.position),it=rt.position;dt!==0&&!is_WS_OR_EOL(dt)&&!is_FLOW_INDICATOR(dt);)dt=rt.input.charCodeAt(++rt.position);return rt.position===it&&throwError(rt,"name of an alias node must contain at least one character"),ct=rt.input.slice(it,rt.position),_hasOwnProperty$1.call(rt.anchorMap,ct)||throwError(rt,'unidentified alias "'+ct+'"'),rt.result=rt.anchorMap[ct],skipSeparationSpace(rt,!0,-1),!0}__name(readAlias,"readAlias");function composeNode(rt,it,ct,dt,ut){var pt,yt,ft,mt=1,kt=!1,_t=!1,vt,bt,Mt,wt,St,It;if(rt.listener!==null&&rt.listener("open",rt),rt.tag=null,rt.anchor=null,rt.kind=null,rt.result=null,pt=yt=ft=CONTEXT_BLOCK_OUT===ct||CONTEXT_BLOCK_IN===ct,dt&&skipSeparationSpace(rt,!0,-1)&&(kt=!0,rt.lineIndent>it?mt=1:rt.lineIndent===it?mt=0:rt.lineIndent<it&&(mt=-1)),mt===1)for(;readTagProperty(rt)||readAnchorProperty(rt);)skipSeparationSpace(rt,!0,-1)?(kt=!0,ft=pt,rt.lineIndent>it?mt=1:rt.lineIndent===it?mt=0:rt.lineIndent<it&&(mt=-1)):ft=!1;if(ft&&(ft=kt||ut),(mt===1||CONTEXT_BLOCK_OUT===ct)&&(CONTEXT_FLOW_IN===ct||CONTEXT_FLOW_OUT===ct?St=it:St=it+1,It=rt.position-rt.lineStart,mt===1?ft&&(readBlockSequence(rt,It)||readBlockMapping(rt,It,St))||readFlowCollection(rt,St)?_t=!0:(yt&&readBlockScalar(rt,St)||readSingleQuotedScalar(rt,St)||readDoubleQuotedScalar(rt,St)?_t=!0:readAlias(rt)?(_t=!0,(rt.tag!==null||rt.anchor!==null)&&throwError(rt,"alias node should not have any properties")):readPlainScalar(rt,St,CONTEXT_FLOW_IN===ct)&&(_t=!0,rt.tag===null&&(rt.tag="?")),rt.anchor!==null&&(rt.anchorMap[rt.anchor]=rt.result)):mt===0&&(_t=ft&&readBlockSequence(rt,It))),rt.tag===null)rt.anchor!==null&&(rt.anchorMap[rt.anchor]=rt.result);else if(rt.tag==="?"){for(rt.result!==null&&rt.kind!=="scalar"&&throwError(rt,'unacceptable node kind for !<?> tag; it should be "scalar", not "'+rt.kind+'"'),vt=0,bt=rt.implicitTypes.length;vt<bt;vt+=1)if(wt=rt.implicitTypes[vt],wt.resolve(rt.result)){rt.result=wt.construct(rt.result),rt.tag=wt.tag,rt.anchor!==null&&(rt.anchorMap[rt.anchor]=rt.result);break}}else if(rt.tag!=="!"){if(_hasOwnProperty$1.call(rt.typeMap[rt.kind||"fallback"],rt.tag))wt=rt.typeMap[rt.kind||"fallback"][rt.tag];else for(wt=null,Mt=rt.typeMap.multi[rt.kind||"fallback"],vt=0,bt=Mt.length;vt<bt;vt+=1)if(rt.tag.slice(0,Mt[vt].tag.length)===Mt[vt].tag){wt=Mt[vt];break}wt||throwError(rt,"unknown tag !<"+rt.tag+">"),rt.result!==null&&wt.kind!==rt.kind&&throwError(rt,"unacceptable node kind for !<"+rt.tag+'> tag; it should be "'+wt.kind+'", not "'+rt.kind+'"'),wt.resolve(rt.result,rt.tag)?(rt.result=wt.construct(rt.result,rt.tag),rt.anchor!==null&&(rt.anchorMap[rt.anchor]=rt.result)):throwError(rt,"cannot resolve a node with !<"+rt.tag+"> explicit tag")}return rt.listener!==null&&rt.listener("close",rt),rt.tag!==null||rt.anchor!==null||_t}__name(composeNode,"composeNode");function readDocument(rt){var it=rt.position,ct,dt,ut,pt=!1,yt;for(rt.version=null,rt.checkLineBreaks=rt.legacy,rt.tagMap=Object.create(null),rt.anchorMap=Object.create(null);(yt=rt.input.charCodeAt(rt.position))!==0&&(skipSeparationSpace(rt,!0,-1),yt=rt.input.charCodeAt(rt.position),!(rt.lineIndent>0||yt!==37));){for(pt=!0,yt=rt.input.charCodeAt(++rt.position),ct=rt.position;yt!==0&&!is_WS_OR_EOL(yt);)yt=rt.input.charCodeAt(++rt.position);for(dt=rt.input.slice(ct,rt.position),ut=[],dt.length<1&&throwError(rt,"directive name must not be less than one character in length");yt!==0;){for(;is_WHITE_SPACE(yt);)yt=rt.input.charCodeAt(++rt.position);if(yt===35){do yt=rt.input.charCodeAt(++rt.position);while(yt!==0&&!is_EOL(yt));break}if(is_EOL(yt))break;for(ct=rt.position;yt!==0&&!is_WS_OR_EOL(yt);)yt=rt.input.charCodeAt(++rt.position);ut.push(rt.input.slice(ct,rt.position))}yt!==0&&readLineBreak(rt),_hasOwnProperty$1.call(directiveHandlers,dt)?directiveHandlers[dt](rt,dt,ut):throwWarning(rt,'unknown document directive "'+dt+'"')}if(skipSeparationSpace(rt,!0,-1),rt.lineIndent===0&&rt.input.charCodeAt(rt.position)===45&&rt.input.charCodeAt(rt.position+1)===45&&rt.input.charCodeAt(rt.position+2)===45?(rt.position+=3,skipSeparationSpace(rt,!0,-1)):pt&&throwError(rt,"directives end mark is expected"),composeNode(rt,rt.lineIndent-1,CONTEXT_BLOCK_OUT,!1,!0),skipSeparationSpace(rt,!0,-1),rt.checkLineBreaks&&PATTERN_NON_ASCII_LINE_BREAKS.test(rt.input.slice(it,rt.position))&&throwWarning(rt,"non-ASCII line breaks are interpreted as content"),rt.documents.push(rt.result),rt.position===rt.lineStart&&testDocumentSeparator(rt)){rt.input.charCodeAt(rt.position)===46&&(rt.position+=3,skipSeparationSpace(rt,!0,-1));return}if(rt.position<rt.length-1)throwError(rt,"end of the stream or a document separator is expected");else return}__name(readDocument,"readDocument");function loadDocuments(rt,it){rt=String(rt),it=it||{},rt.length!==0&&(rt.charCodeAt(rt.length-1)!==10&&rt.charCodeAt(rt.length-1)!==13&&(rt+=`
-`),rt.charCodeAt(0)===65279&&(rt=rt.slice(1)));var ct=new State$1(rt,it),dt=rt.indexOf("\0");for(dt!==-1&&(ct.position=dt,throwError(ct,"null byte is not allowed in input")),ct.input+="\0";ct.input.charCodeAt(ct.position)===32;)ct.lineIndent+=1,ct.position+=1;for(;ct.position<ct.length-1;)readDocument(ct);return ct.documents}__name(loadDocuments,"loadDocuments");function loadAll$1(rt,it,ct){it!==null&&typeof it=="object"&&typeof ct>"u"&&(ct=it,it=null);var dt=loadDocuments(rt,ct);if(typeof it!="function")return dt;for(var ut=0,pt=dt.length;ut<pt;ut+=1)it(dt[ut])}__name(loadAll$1,"loadAll$1");function load$1(rt,it){var ct=loadDocuments(rt,it);if(ct.length!==0){if(ct.length===1)return ct[0];throw new exception("expected a single document in the stream, but found more")}}__name(load$1,"load$1");var load_1=load$1,loader$1={load:load_1},_toString=Object.prototype.toString,_hasOwnProperty=Object.prototype.hasOwnProperty,CHAR_BOM=65279,CHAR_TAB=9,CHAR_LINE_FEED=10,CHAR_CARRIAGE_RETURN=13,CHAR_SPACE=32,CHAR_EXCLAMATION=33,CHAR_DOUBLE_QUOTE=34,CHAR_SHARP=35,CHAR_PERCENT=37,CHAR_AMPERSAND=38,CHAR_SINGLE_QUOTE=39,CHAR_ASTERISK=42,CHAR_COMMA=44,CHAR_MINUS=45,CHAR_COLON=58,CHAR_EQUALS=61,CHAR_GREATER_THAN=62,CHAR_QUESTION=63,CHAR_COMMERCIAL_AT=64,CHAR_LEFT_SQUARE_BRACKET=91,CHAR_RIGHT_SQUARE_BRACKET=93,CHAR_GRAVE_ACCENT=96,CHAR_LEFT_CURLY_BRACKET=123,CHAR_VERTICAL_LINE=124,CHAR_RIGHT_CURLY_BRACKET=125,ESCAPE_SEQUENCES={};ESCAPE_SEQUENCES[0]="\\0";ESCAPE_SEQUENCES[7]="\\a";ESCAPE_SEQUENCES[8]="\\b";ESCAPE_SEQUENCES[9]="\\t";ESCAPE_SEQUENCES[10]="\\n";ESCAPE_SEQUENCES[11]="\\v";ESCAPE_SEQUENCES[12]="\\f";ESCAPE_SEQUENCES[13]="\\r";ESCAPE_SEQUENCES[27]="\\e";ESCAPE_SEQUENCES[34]='\\"';ESCAPE_SEQUENCES[92]="\\\\";ESCAPE_SEQUENCES[133]="\\N";ESCAPE_SEQUENCES[160]="\\_";ESCAPE_SEQUENCES[8232]="\\L";ESCAPE_SEQUENCES[8233]="\\P";var DEPRECATED_BOOLEANS_SYNTAX=["y","Y","yes","Yes","YES","on","On","ON","n","N","no","No","NO","off","Off","OFF"],DEPRECATED_BASE60_SYNTAX=/^[-+]?[0-9_]+(?::[0-9_]+)+(?:\.[0-9_]*)?$/;function compileStyleMap(rt,it){var ct,dt,ut,pt,yt,ft,mt;if(it===null)return{};for(ct={},dt=Object.keys(it),ut=0,pt=dt.length;ut<pt;ut+=1)yt=dt[ut],ft=String(it[yt]),yt.slice(0,2)==="!!"&&(yt="tag:yaml.org,2002:"+yt.slice(2)),mt=rt.compiledTypeMap.fallback[yt],mt&&_hasOwnProperty.call(mt.styleAliases,ft)&&(ft=mt.styleAliases[ft]),ct[yt]=ft;return ct}__name(compileStyleMap,"compileStyleMap");function encodeHex(rt){var it,ct,dt;if(it=rt.toString(16).toUpperCase(),rt<=255)ct="x",dt=2;else if(rt<=65535)ct="u",dt=4;else if(rt<=4294967295)ct="U",dt=8;else throw new exception("code point within a string may not be greater than 0xFFFFFFFF");return"\\"+ct+common.repeat("0",dt-it.length)+it}__name(encodeHex,"encodeHex");var QUOTING_TYPE_SINGLE=1,QUOTING_TYPE_DOUBLE=2;function State(rt){this.schema=rt.schema||_default,this.indent=Math.max(1,rt.indent||2),this.noArrayIndent=rt.noArrayIndent||!1,this.skipInvalid=rt.skipInvalid||!1,this.flowLevel=common.isNothing(rt.flowLevel)?-1:rt.flowLevel,this.styleMap=compileStyleMap(this.schema,rt.styles||null),this.sortKeys=rt.sortKeys||!1,this.lineWidth=rt.lineWidth||80,this.noRefs=rt.noRefs||!1,this.noCompatMode=rt.noCompatMode||!1,this.condenseFlow=rt.condenseFlow||!1,this.quotingType=rt.quotingType==='"'?QUOTING_TYPE_DOUBLE:QUOTING_TYPE_SINGLE,this.forceQuotes=rt.forceQuotes||!1,this.replacer=typeof rt.replacer=="function"?rt.replacer:null,this.implicitTypes=this.schema.compiledImplicit,this.explicitTypes=this.schema.compiledExplicit,this.tag=null,this.result="",this.duplicates=[],this.usedDuplicates=null}__name(State,"State");function indentString(rt,it){for(var ct=common.repeat(" ",it),dt=0,ut=-1,pt="",yt,ft=rt.length;dt<ft;)ut=rt.indexOf(`
-`,dt),ut===-1?(yt=rt.slice(dt),dt=ft):(yt=rt.slice(dt,ut+1),dt=ut+1),yt.length&&yt!==`
-`&&(pt+=ct),pt+=yt;return pt}__name(indentString,"indentString");function generateNextLine(rt,it){return`
-`+common.repeat(" ",rt.indent*it)}__name(generateNextLine,"generateNextLine");function testImplicitResolving(rt,it){var ct,dt,ut;for(ct=0,dt=rt.implicitTypes.length;ct<dt;ct+=1)if(ut=rt.implicitTypes[ct],ut.resolve(it))return!0;return!1}__name(testImplicitResolving,"testImplicitResolving");function isWhitespace(rt){return rt===CHAR_SPACE||rt===CHAR_TAB}__name(isWhitespace,"isWhitespace");function isPrintable(rt){return 32<=rt&&rt<=126||161<=rt&&rt<=55295&&rt!==8232&&rt!==8233||57344<=rt&&rt<=65533&&rt!==CHAR_BOM||65536<=rt&&rt<=1114111}__name(isPrintable,"isPrintable");function isNsCharOrWhitespace(rt){return isPrintable(rt)&&rt!==CHAR_BOM&&rt!==CHAR_CARRIAGE_RETURN&&rt!==CHAR_LINE_FEED}__name(isNsCharOrWhitespace,"isNsCharOrWhitespace");function isPlainSafe(rt,it,ct){var dt=isNsCharOrWhitespace(rt),ut=dt&&!isWhitespace(rt);return(ct?dt:dt&&rt!==CHAR_COMMA&&rt!==CHAR_LEFT_SQUARE_BRACKET&&rt!==CHAR_RIGHT_SQUARE_BRACKET&&rt!==CHAR_LEFT_CURLY_BRACKET&&rt!==CHAR_RIGHT_CURLY_BRACKET)&&rt!==CHAR_SHARP&&!(it===CHAR_COLON&&!ut)||isNsCharOrWhitespace(it)&&!isWhitespace(it)&&rt===CHAR_SHARP||it===CHAR_COLON&&ut}__name(isPlainSafe,"isPlainSafe");function isPlainSafeFirst(rt){return isPrintable(rt)&&rt!==CHAR_BOM&&!isWhitespace(rt)&&rt!==CHAR_MINUS&&rt!==CHAR_QUESTION&&rt!==CHAR_COLON&&rt!==CHAR_COMMA&&rt!==CHAR_LEFT_SQUARE_BRACKET&&rt!==CHAR_RIGHT_SQUARE_BRACKET&&rt!==CHAR_LEFT_CURLY_BRACKET&&rt!==CHAR_RIGHT_CURLY_BRACKET&&rt!==CHAR_SHARP&&rt!==CHAR_AMPERSAND&&rt!==CHAR_ASTERISK&&rt!==CHAR_EXCLAMATION&&rt!==CHAR_VERTICAL_LINE&&rt!==CHAR_EQUALS&&rt!==CHAR_GREATER_THAN&&rt!==CHAR_SINGLE_QUOTE&&rt!==CHAR_DOUBLE_QUOTE&&rt!==CHAR_PERCENT&&rt!==CHAR_COMMERCIAL_AT&&rt!==CHAR_GRAVE_ACCENT}__name(isPlainSafeFirst,"isPlainSafeFirst");function isPlainSafeLast(rt){return!isWhitespace(rt)&&rt!==CHAR_COLON}__name(isPlainSafeLast,"isPlainSafeLast");function codePointAt(rt,it){var ct=rt.charCodeAt(it),dt;return ct>=55296&&ct<=56319&&it+1<rt.length&&(dt=rt.charCodeAt(it+1),dt>=56320&&dt<=57343)?(ct-55296)*1024+dt-56320+65536:ct}__name(codePointAt,"codePointAt");function needIndentIndicator(rt){var it=/^\n* /;return it.test(rt)}__name(needIndentIndicator,"needIndentIndicator");var STYLE_PLAIN=1,STYLE_SINGLE=2,STYLE_LITERAL=3,STYLE_FOLDED=4,STYLE_DOUBLE=5;function chooseScalarStyle(rt,it,ct,dt,ut,pt,yt,ft){var mt,kt=0,_t=null,vt=!1,bt=!1,Mt=dt!==-1,wt=-1,St=isPlainSafeFirst(codePointAt(rt,0))&&isPlainSafeLast(codePointAt(rt,rt.length-1));if(it||yt)for(mt=0;mt<rt.length;kt>=65536?mt+=2:mt++){if(kt=codePointAt(rt,mt),!isPrintable(kt))return STYLE_DOUBLE;St=St&&isPlainSafe(kt,_t,ft),_t=kt}else{for(mt=0;mt<rt.length;kt>=65536?mt+=2:mt++){if(kt=codePointAt(rt,mt),kt===CHAR_LINE_FEED)vt=!0,Mt&&(bt=bt||mt-wt-1>dt&&rt[wt+1]!==" ",wt=mt);else if(!isPrintable(kt))return STYLE_DOUBLE;St=St&&isPlainSafe(kt,_t,ft),_t=kt}bt=bt||Mt&&mt-wt-1>dt&&rt[wt+1]!==" "}return!vt&&!bt?St&&!yt&&!ut(rt)?STYLE_PLAIN:pt===QUOTING_TYPE_DOUBLE?STYLE_DOUBLE:STYLE_SINGLE:ct>9&&needIndentIndicator(rt)?STYLE_DOUBLE:yt?pt===QUOTING_TYPE_DOUBLE?STYLE_DOUBLE:STYLE_SINGLE:bt?STYLE_FOLDED:STYLE_LITERAL}__name(chooseScalarStyle,"chooseScalarStyle");function writeScalar(rt,it,ct,dt,ut){rt.dump=(function(){if(it.length===0)return rt.quotingType===QUOTING_TYPE_DOUBLE?'""':"''";if(!rt.noCompatMode&&(DEPRECATED_BOOLEANS_SYNTAX.indexOf(it)!==-1||DEPRECATED_BASE60_SYNTAX.test(it)))return rt.quotingType===QUOTING_TYPE_DOUBLE?'"'+it+'"':"'"+it+"'";var pt=rt.indent*Math.max(1,ct),yt=rt.lineWidth===-1?-1:Math.max(Math.min(rt.lineWidth,40),rt.lineWidth-pt),ft=dt||rt.flowLevel>-1&&ct>=rt.flowLevel;function mt(kt){return testImplicitResolving(rt,kt)}switch(__name(mt,"testAmbiguity"),chooseScalarStyle(it,ft,rt.indent,yt,mt,rt.quotingType,rt.forceQuotes&&!dt,ut)){case STYLE_PLAIN:return it;case STYLE_SINGLE:return"'"+it.replace(/'/g,"''")+"'";case STYLE_LITERAL:return"|"+blockHeader(it,rt.indent)+dropEndingNewline(indentString(it,pt));case STYLE_FOLDED:return">"+blockHeader(it,rt.indent)+dropEndingNewline(indentString(foldString(it,yt),pt));case STYLE_DOUBLE:return'"'+escapeString(it)+'"';default:throw new exception("impossible error: invalid scalar style")}})()}__name(writeScalar,"writeScalar");function blockHeader(rt,it){var ct=needIndentIndicator(rt)?String(it):"",dt=rt[rt.length-1]===`
-`,ut=dt&&(rt[rt.length-2]===`
-`||rt===`
-`),pt=ut?"+":dt?"":"-";return ct+pt+`
-`}__name(blockHeader,"blockHeader");function dropEndingNewline(rt){return rt[rt.length-1]===`
-`?rt.slice(0,-1):rt}__name(dropEndingNewline,"dropEndingNewline");function foldString(rt,it){for(var ct=/(\n+)([^\n]*)/g,dt=(function(){var kt=rt.indexOf(`
-`);return kt=kt!==-1?kt:rt.length,ct.lastIndex=kt,foldLine(rt.slice(0,kt),it)})(),ut=rt[0]===`
-`||rt[0]===" ",pt,yt;yt=ct.exec(rt);){var ft=yt[1],mt=yt[2];pt=mt[0]===" ",dt+=ft+(!ut&&!pt&&mt!==""?`
-`:"")+foldLine(mt,it),ut=pt}return dt}__name(foldString,"foldString");function foldLine(rt,it){if(rt===""||rt[0]===" ")return rt;for(var ct=/ [^ ]/g,dt,ut=0,pt,yt=0,ft=0,mt="";dt=ct.exec(rt);)ft=dt.index,ft-ut>it&&(pt=yt>ut?yt:ft,mt+=`
-`+rt.slice(ut,pt),ut=pt+1),yt=ft;return mt+=`
-`,rt.length-ut>it&&yt>ut?mt+=rt.slice(ut,yt)+`
-`+rt.slice(yt+1):mt+=rt.slice(ut),mt.slice(1)}__name(foldLine,"foldLine");function escapeString(rt){for(var it="",ct=0,dt,ut=0;ut<rt.length;ct>=65536?ut+=2:ut++)ct=codePointAt(rt,ut),dt=ESCAPE_SEQUENCES[ct],!dt&&isPrintable(ct)?(it+=rt[ut],ct>=65536&&(it+=rt[ut+1])):it+=dt||encodeHex(ct);return it}__name(escapeString,"escapeString");function writeFlowSequence(rt,it,ct){var dt="",ut=rt.tag,pt,yt,ft;for(pt=0,yt=ct.length;pt<yt;pt+=1)ft=ct[pt],rt.replacer&&(ft=rt.replacer.call(ct,String(pt),ft)),(writeNode(rt,it,ft,!1,!1)||typeof ft>"u"&&writeNode(rt,it,null,!1,!1))&&(dt!==""&&(dt+=","+(rt.condenseFlow?"":" ")),dt+=rt.dump);rt.tag=ut,rt.dump="["+dt+"]"}__name(writeFlowSequence,"writeFlowSequence");function writeBlockSequence(rt,it,ct,dt){var ut="",pt=rt.tag,yt,ft,mt;for(yt=0,ft=ct.length;yt<ft;yt+=1)mt=ct[yt],rt.replacer&&(mt=rt.replacer.call(ct,String(yt),mt)),(writeNode(rt,it+1,mt,!0,!0,!1,!0)||typeof mt>"u"&&writeNode(rt,it+1,null,!0,!0,!1,!0))&&((!dt||ut!=="")&&(ut+=generateNextLine(rt,it)),rt.dump&&CHAR_LINE_FEED===rt.dump.charCodeAt(0)?ut+="-":ut+="- ",ut+=rt.dump);rt.tag=pt,rt.dump=ut||"[]"}__name(writeBlockSequence,"writeBlockSequence");function writeFlowMapping(rt,it,ct){var dt="",ut=rt.tag,pt=Object.keys(ct),yt,ft,mt,kt,_t;for(yt=0,ft=pt.length;yt<ft;yt+=1)_t="",dt!==""&&(_t+=", "),rt.condenseFlow&&(_t+='"'),mt=pt[yt],kt=ct[mt],rt.replacer&&(kt=rt.replacer.call(ct,mt,kt)),writeNode(rt,it,mt,!1,!1)&&(rt.dump.length>1024&&(_t+="? "),_t+=rt.dump+(rt.condenseFlow?'"':"")+":"+(rt.condenseFlow?"":" "),writeNode(rt,it,kt,!1,!1)&&(_t+=rt.dump,dt+=_t));rt.tag=ut,rt.dump="{"+dt+"}"}__name(writeFlowMapping,"writeFlowMapping");function writeBlockMapping(rt,it,ct,dt){var ut="",pt=rt.tag,yt=Object.keys(ct),ft,mt,kt,_t,vt,bt;if(rt.sortKeys===!0)yt.sort();else if(typeof rt.sortKeys=="function")yt.sort(rt.sortKeys);else if(rt.sortKeys)throw new exception("sortKeys must be a boolean or a function");for(ft=0,mt=yt.length;ft<mt;ft+=1)bt="",(!dt||ut!=="")&&(bt+=generateNextLine(rt,it)),kt=yt[ft],_t=ct[kt],rt.replacer&&(_t=rt.replacer.call(ct,kt,_t)),writeNode(rt,it+1,kt,!0,!0,!0)&&(vt=rt.tag!==null&&rt.tag!=="?"||rt.dump&&rt.dump.length>1024,vt&&(rt.dump&&CHAR_LINE_FEED===rt.dump.charCodeAt(0)?bt+="?":bt+="? "),bt+=rt.dump,vt&&(bt+=generateNextLine(rt,it)),writeNode(rt,it+1,_t,!0,vt)&&(rt.dump&&CHAR_LINE_FEED===rt.dump.charCodeAt(0)?bt+=":":bt+=": ",bt+=rt.dump,ut+=bt));rt.tag=pt,rt.dump=ut||"{}"}__name(writeBlockMapping,"writeBlockMapping");function detectType(rt,it,ct){var dt,ut,pt,yt,ft,mt;for(ut=ct?rt.explicitTypes:rt.implicitTypes,pt=0,yt=ut.length;pt<yt;pt+=1)if(ft=ut[pt],(ft.instanceOf||ft.predicate)&&(!ft.instanceOf||typeof it=="object"&&it instanceof ft.instanceOf)&&(!ft.predicate||ft.predicate(it))){if(ct?ft.multi&&ft.representName?rt.tag=ft.representName(it):rt.tag=ft.tag:rt.tag="?",ft.represent){if(mt=rt.styleMap[ft.tag]||ft.defaultStyle,_toString.call(ft.represent)==="[object Function]")dt=ft.represent(it,mt);else if(_hasOwnProperty.call(ft.represent,mt))dt=ft.represent[mt](it,mt);else throw new exception("!<"+ft.tag+'> tag resolver accepts not "'+mt+'" style');rt.dump=dt}return!0}return!1}__name(detectType,"detectType");function writeNode(rt,it,ct,dt,ut,pt,yt){rt.tag=null,rt.dump=ct,detectType(rt,ct,!1)||detectType(rt,ct,!0);var ft=_toString.call(rt.dump),mt=dt,kt;dt&&(dt=rt.flowLevel<0||rt.flowLevel>it);var _t=ft==="[object Object]"||ft==="[object Array]",vt,bt;if(_t&&(vt=rt.duplicates.indexOf(ct),bt=vt!==-1),(rt.tag!==null&&rt.tag!=="?"||bt||rt.indent!==2&&it>0)&&(ut=!1),bt&&rt.usedDuplicates[vt])rt.dump="*ref_"+vt;else{if(_t&&bt&&!rt.usedDuplicates[vt]&&(rt.usedDuplicates[vt]=!0),ft==="[object Object]")dt&&Object.keys(rt.dump).length!==0?(writeBlockMapping(rt,it,rt.dump,ut),bt&&(rt.dump="&ref_"+vt+rt.dump)):(writeFlowMapping(rt,it,rt.dump),bt&&(rt.dump="&ref_"+vt+" "+rt.dump));else if(ft==="[object Array]")dt&&rt.dump.length!==0?(rt.noArrayIndent&&!yt&&it>0?writeBlockSequence(rt,it-1,rt.dump,ut):writeBlockSequence(rt,it,rt.dump,ut),bt&&(rt.dump="&ref_"+vt+rt.dump)):(writeFlowSequence(rt,it,rt.dump),bt&&(rt.dump="&ref_"+vt+" "+rt.dump));else if(ft==="[object String]")rt.tag!=="?"&&writeScalar(rt,rt.dump,it,pt,mt);else{if(ft==="[object Undefined]")return!1;if(rt.skipInvalid)return!1;throw new exception("unacceptable kind of an object to dump "+ft)}rt.tag!==null&&rt.tag!=="?"&&(kt=encodeURI(rt.tag[0]==="!"?rt.tag.slice(1):rt.tag).replace(/!/g,"%21"),rt.tag[0]==="!"?kt="!"+kt:kt.slice(0,18)==="tag:yaml.org,2002:"?kt="!!"+kt.slice(18):kt="!<"+kt+">",rt.dump=kt+" "+rt.dump)}return!0}__name(writeNode,"writeNode");function getDuplicateReferences(rt,it){var ct=[],dt=[],ut,pt;for(inspectNode(rt,ct,dt),ut=0,pt=dt.length;ut<pt;ut+=1)it.duplicates.push(ct[dt[ut]]);it.usedDuplicates=new Array(pt)}__name(getDuplicateReferences,"getDuplicateReferences");function inspectNode(rt,it,ct){var dt,ut,pt;if(rt!==null&&typeof rt=="object")if(ut=it.indexOf(rt),ut!==-1)ct.indexOf(ut)===-1&&ct.push(ut);else if(it.push(rt),Array.isArray(rt))for(ut=0,pt=rt.length;ut<pt;ut+=1)inspectNode(rt[ut],it,ct);else for(dt=Object.keys(rt),ut=0,pt=dt.length;ut<pt;ut+=1)inspectNode(rt[dt[ut]],it,ct)}__name(inspectNode,"inspectNode");function dump$1(rt,it){it=it||{};var ct=new State(it);ct.noRefs||getDuplicateReferences(rt,ct);var dt=rt;return ct.replacer&&(dt=ct.replacer.call({"":dt},"",dt)),writeNode(ct,0,dt,!0,!0)?ct.dump+`
-`:""}__name(dump$1,"dump$1");function renamed(rt,it){return function(){throw new Error("Function yaml."+rt+" is removed in js-yaml 4. Use yaml."+it+" instead, which is now safe by default.")}}__name(renamed,"renamed");var JSON_SCHEMA=json,load=loader$1.load;var markerOffsets={aggregation:17.25,extension:17.25,composition:17.25,dependency:6,lollipop:13.5,arrow_point:4},markerOffsets2={arrow_point:9,arrow_cross:12.5,arrow_circle:12.5};function calculateDeltaAndAngle$1(rt,it){if(rt===void 0||it===void 0)return{angle:0,deltaX:0,deltaY:0};rt=pointTransformer(rt),it=pointTransformer(it);const[ct,dt]=[rt.x,rt.y],[ut,pt]=[it.x,it.y],yt=ut-ct,ft=pt-dt;return{angle:Math.atan(ft/yt),deltaX:yt,deltaY:ft}}__name(calculateDeltaAndAngle$1,"calculateDeltaAndAngle");var pointTransformer=__name(rt=>Array.isArray(rt)?{x:rt[0],y:rt[1]}:rt,"pointTransformer"),getLineFunctionsWithOffset=__name(rt=>({x:__name(function(it,ct,dt){let ut=0;const pt=pointTransformer(dt[0]).x<pointTransformer(dt[dt.length-1]).x?"left":"right";if(ct===0&&Object.hasOwn(markerOffsets,rt.arrowTypeStart)){const{angle:Mt,deltaX:wt}=calculateDeltaAndAngle$1(dt[0],dt[1]);ut=markerOffsets[rt.arrowTypeStart]*Math.cos(Mt)*(wt>=0?1:-1)}else if(ct===dt.length-1&&Object.hasOwn(markerOffsets,rt.arrowTypeEnd)){const{angle:Mt,deltaX:wt}=calculateDeltaAndAngle$1(dt[dt.length-1],dt[dt.length-2]);ut=markerOffsets[rt.arrowTypeEnd]*Math.cos(Mt)*(wt>=0?1:-1)}const yt=Math.abs(pointTransformer(it).x-pointTransformer(dt[dt.length-1]).x),ft=Math.abs(pointTransformer(it).y-pointTransformer(dt[dt.length-1]).y),mt=Math.abs(pointTransformer(it).x-pointTransformer(dt[0]).x),kt=Math.abs(pointTransformer(it).y-pointTransformer(dt[0]).y),_t=markerOffsets[rt.arrowTypeStart],vt=markerOffsets[rt.arrowTypeEnd],bt=1;if(yt<vt&&yt>0&&ft<vt){let Mt=vt+bt-yt;Mt*=pt==="right"?-1:1,ut-=Mt}if(mt<_t&&mt>0&&kt<_t){let Mt=_t+bt-mt;Mt*=pt==="right"?-1:1,ut+=Mt}return pointTransformer(it).x+ut},"x"),y:__name(function(it,ct,dt){let ut=0;const pt=pointTransformer(dt[0]).y<pointTransformer(dt[dt.length-1]).y?"down":"up";if(ct===0&&Object.hasOwn(markerOffsets,rt.arrowTypeStart)){const{angle:Mt,deltaY:wt}=calculateDeltaAndAngle$1(dt[0],dt[1]);ut=markerOffsets[rt.arrowTypeStart]*Math.abs(Math.sin(Mt))*(wt>=0?1:-1)}else if(ct===dt.length-1&&Object.hasOwn(markerOffsets,rt.arrowTypeEnd)){const{angle:Mt,deltaY:wt}=calculateDeltaAndAngle$1(dt[dt.length-1],dt[dt.length-2]);ut=markerOffsets[rt.arrowTypeEnd]*Math.abs(Math.sin(Mt))*(wt>=0?1:-1)}const yt=Math.abs(pointTransformer(it).y-pointTransformer(dt[dt.length-1]).y),ft=Math.abs(pointTransformer(it).x-pointTransformer(dt[dt.length-1]).x),mt=Math.abs(pointTransformer(it).y-pointTransformer(dt[0]).y),kt=Math.abs(pointTransformer(it).x-pointTransformer(dt[0]).x),_t=markerOffsets[rt.arrowTypeStart],vt=markerOffsets[rt.arrowTypeEnd],bt=1;if(yt<vt&&yt>0&&ft<vt){let Mt=vt+bt-yt;Mt*=pt==="up"?-1:1,ut-=Mt}if(mt<_t&&mt>0&&kt<_t){let Mt=_t+bt-mt;Mt*=pt==="up"?-1:1,ut+=Mt}return pointTransformer(it).y+ut},"y")}),"getLineFunctionsWithOffset"),getSubGraphTitleMargins=__name(({flowchart:rt})=>{const it=rt?.subGraphTitleMargin?.top??0,ct=rt?.subGraphTitleMargin?.bottom??0,dt=it+ct;return{subGraphTitleTopMargin:it,subGraphTitleBottomMargin:ct,subGraphTitleTotalMargin:dt}},"getSubGraphTitleMargins"),solidStateFill=__name(rt=>{const{handDrawnSeed:it}=getConfig2();return{fill:rt,hachureAngle:120,hachureGap:4,fillWeight:2,roughness:.7,stroke:rt,seed:it}},"solidStateFill"),compileStyles=__name(rt=>{const it=styles2Map([...rt.cssCompiledStyles||[],...rt.cssStyles||[],...rt.labelStyle||[]]);return{stylesMap:it,stylesArray:[...it]}},"compileStyles"),styles2Map=__name(rt=>{const it=new Map;return rt.forEach(ct=>{const[dt,ut]=ct.split(":");it.set(dt.trim(),ut?.trim())}),it},"styles2Map"),isLabelStyle=__name(rt=>rt==="color"||rt==="font-size"||rt==="font-family"||rt==="font-weight"||rt==="font-style"||rt==="text-decoration"||rt==="text-align"||rt==="text-transform"||rt==="line-height"||rt==="letter-spacing"||rt==="word-spacing"||rt==="text-shadow"||rt==="text-overflow"||rt==="white-space"||rt==="word-wrap"||rt==="word-break"||rt==="overflow-wrap"||rt==="hyphens","isLabelStyle"),styles2String=__name(rt=>{const{stylesArray:it}=compileStyles(rt),ct=[],dt=[],ut=[],pt=[];return it.forEach(yt=>{const ft=yt[0];isLabelStyle(ft)?ct.push(yt.join(":")+" !important"):(dt.push(yt.join(":")+" !important"),ft.includes("stroke")&&ut.push(yt.join(":")+" !important"),ft==="fill"&&pt.push(yt.join(":")+" !important"))}),{labelStyles:ct.join(";"),nodeStyles:dt.join(";"),stylesArray:it,borderStyles:ut,backgroundStyles:pt}},"styles2String"),userNodeOverrides=__name((rt,it)=>{const{themeVariables:ct,handDrawnSeed:dt}=getConfig2(),{nodeBorder:ut,mainBkg:pt}=ct,{stylesMap:yt}=compileStyles(rt);return Object.assign({roughness:.7,fill:yt.get("fill")||pt,fillStyle:"hachure",fillWeight:4,hachureGap:5.2,stroke:yt.get("stroke")||ut,seed:dt,strokeWidth:yt.get("stroke-width")?.replace("px","")||1.3,fillLineDash:[0,0],strokeLineDash:getStrokeDashArray(yt.get("stroke-dasharray"))},it)},"userNodeOverrides"),getStrokeDashArray=__name(rt=>{if(!rt)return[0,0];const it=rt.trim().split(/\s+/).map(Number);if(it.length===1){const ut=isNaN(it[0])?0:it[0];return[ut,ut]}const ct=isNaN(it[0])?0:it[0],dt=isNaN(it[1])?0:it[1];return[ct,dt]},"getStrokeDashArray"),dist={},constants={},hasRequiredConstants;function requireConstants(){return hasRequiredConstants||(hasRequiredConstants=1,Object.defineProperty(constants,"__esModule",{value:!0}),constants.BLANK_URL=constants.relativeFirstCharacters=constants.whitespaceEscapeCharsRegex=constants.urlSchemeRegex=constants.ctrlCharactersRegex=constants.htmlCtrlEntityRegex=constants.htmlEntitiesRegex=constants.invalidProtocolRegex=void 0,constants.invalidProtocolRegex=/^([^\w]*)(javascript|data|vbscript)/im,constants.htmlEntitiesRegex=/&#(\w+)(^\w|;)?/g,constants.htmlCtrlEntityRegex=/&(newline|tab);/gi,constants.ctrlCharactersRegex=/[\u0000-\u001F\u007F-\u009F\u2000-\u200D\uFEFF]/gim,constants.urlSchemeRegex=/^.+(:|&colon;)/gim,constants.whitespaceEscapeCharsRegex=/(\\|%5[cC])((%(6[eE]|72|74))|[nrt])/g,constants.relativeFirstCharacters=[".","/"],constants.BLANK_URL="about:blank"),constants}var hasRequiredDist;function requireDist(){if(hasRequiredDist)return dist;hasRequiredDist=1,Object.defineProperty(dist,"__esModule",{value:!0}),dist.sanitizeUrl=void 0;var rt=requireConstants();function it(yt){return rt.relativeFirstCharacters.indexOf(yt[0])>-1}function ct(yt){var ft=yt.replace(rt.ctrlCharactersRegex,"");return ft.replace(rt.htmlEntitiesRegex,function(mt,kt){return String.fromCharCode(kt)})}function dt(yt){return URL.canParse(yt)}function ut(yt){try{return decodeURIComponent(yt)}catch{return yt}}function pt(yt){if(!yt)return rt.BLANK_URL;var ft,mt=ut(yt.trim());do mt=ct(mt).replace(rt.htmlCtrlEntityRegex,"").replace(rt.ctrlCharactersRegex,"").replace(rt.whitespaceEscapeCharsRegex,"").trim(),mt=ut(mt),ft=mt.match(rt.ctrlCharactersRegex)||mt.match(rt.htmlEntitiesRegex)||mt.match(rt.htmlCtrlEntityRegex)||mt.match(rt.whitespaceEscapeCharsRegex);while(ft&&ft.length>0);var kt=mt;if(!kt)return rt.BLANK_URL;if(it(kt))return kt;var _t=kt.trimStart(),vt=_t.match(rt.urlSchemeRegex);if(!vt)return kt;var bt=vt[0].toLowerCase().trim();if(rt.invalidProtocolRegex.test(bt))return rt.BLANK_URL;var Mt=_t.replace(/\\/g,"/");if(bt==="mailto:"||bt.includes("://"))return Mt;if(bt==="http:"||bt==="https:"){if(!dt(Mt))return rt.BLANK_URL;var wt=new URL(Mt);return wt.protocol=wt.protocol.toLowerCase(),wt.hostname=wt.hostname.toLowerCase(),wt.toString()}return Mt}return dist.sanitizeUrl=pt,dist}var distExports=requireDist(),freeGlobal=typeof globalThis=="object"&&globalThis&&globalThis.Object===Object&&globalThis,freeSelf=typeof self=="object"&&self&&self.Object===Object&&self,root=freeGlobal||freeSelf||Function("return this")(),Symbol$1=root.Symbol,objectProto$c=Object.prototype,hasOwnProperty$a=objectProto$c.hasOwnProperty,nativeObjectToString$1=objectProto$c.toString,symToStringTag$1=Symbol$1?Symbol$1.toStringTag:void 0;function getRawTag(rt){var it=hasOwnProperty$a.call(rt,symToStringTag$1),ct=rt[symToStringTag$1];try{rt[symToStringTag$1]=void 0;var dt=!0}catch{}var ut=nativeObjectToString$1.call(rt);return dt&&(it?rt[symToStringTag$1]=ct:delete rt[symToStringTag$1]),ut}var objectProto$b=Object.prototype,nativeObjectToString=objectProto$b.toString;function objectToString(rt){return nativeObjectToString.call(rt)}var nullTag="[object Null]",undefinedTag="[object Undefined]",symToStringTag=Symbol$1?Symbol$1.toStringTag:void 0;function baseGetTag(rt){return rt==null?rt===void 0?undefinedTag:nullTag:symToStringTag&&symToStringTag in Object(rt)?getRawTag(rt):objectToString(rt)}function isObject$1(rt){var it=typeof rt;return rt!=null&&(it=="object"||it=="function")}var asyncTag="[object AsyncFunction]",funcTag$1="[object Function]",genTag="[object GeneratorFunction]",proxyTag="[object Proxy]";function isFunction(rt){if(!isObject$1(rt))return!1;var it=baseGetTag(rt);return it==funcTag$1||it==genTag||it==asyncTag||it==proxyTag}var coreJsData=root["__core-js_shared__"],maskSrcKey=(function(){var rt=/[^.]+$/.exec(coreJsData&&coreJsData.keys&&coreJsData.keys.IE_PROTO||"");return rt?"Symbol(src)_1."+rt:""})();function isMasked(rt){return!!maskSrcKey&&maskSrcKey in rt}var funcProto$2=Function.prototype,funcToString$2=funcProto$2.toString;function toSource(rt){if(rt!=null){try{return funcToString$2.call(rt)}catch{}try{return rt+""}catch{}}return""}var reRegExpChar=/[\\^$.*+?()[\]{}|]/g,reIsHostCtor=/^\[object .+?Constructor\]$/,funcProto$1=Function.prototype,objectProto$a=Object.prototype,funcToString$1=funcProto$1.toString,hasOwnProperty$9=objectProto$a.hasOwnProperty,reIsNative=RegExp("^"+funcToString$1.call(hasOwnProperty$9).replace(reRegExpChar,"\\$&").replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g,"$1.*?")+"$");function baseIsNative(rt){if(!isObject$1(rt)||isMasked(rt))return!1;var it=isFunction(rt)?reIsNative:reIsHostCtor;return it.test(toSource(rt))}function getValue(rt,it){return rt?.[it]}function getNative(rt,it){var ct=getValue(rt,it);return baseIsNative(ct)?ct:void 0}var nativeCreate=getNative(Object,"create");function hashClear(){this.__data__=nativeCreate?nativeCreate(null):{},this.size=0}function hashDelete(rt){var it=this.has(rt)&&delete this.__data__[rt];return this.size-=it?1:0,it}var HASH_UNDEFINED$1="__lodash_hash_undefined__",objectProto$9=Object.prototype,hasOwnProperty$8=objectProto$9.hasOwnProperty;function hashGet(rt){var it=this.__data__;if(nativeCreate){var ct=it[rt];return ct===HASH_UNDEFINED$1?void 0:ct}return hasOwnProperty$8.call(it,rt)?it[rt]:void 0}var objectProto$8=Object.prototype,hasOwnProperty$7=objectProto$8.hasOwnProperty;function hashHas(rt){var it=this.__data__;return nativeCreate?it[rt]!==void 0:hasOwnProperty$7.call(it,rt)}var HASH_UNDEFINED="__lodash_hash_undefined__";function hashSet(rt,it){var ct=this.__data__;return this.size+=this.has(rt)?0:1,ct[rt]=nativeCreate&&it===void 0?HASH_UNDEFINED:it,this}function Hash(rt){var it=-1,ct=rt==null?0:rt.length;for(this.clear();++it<ct;){var dt=rt[it];this.set(dt[0],dt[1])}}Hash.prototype.clear=hashClear;Hash.prototype.delete=hashDelete;Hash.prototype.get=hashGet;Hash.prototype.has=hashHas;Hash.prototype.set=hashSet;function listCacheClear(){this.__data__=[],this.size=0}function eq(rt,it){return rt===it||rt!==rt&&it!==it}function assocIndexOf(rt,it){for(var ct=rt.length;ct--;)if(eq(rt[ct][0],it))return ct;return-1}var arrayProto=Array.prototype,splice=arrayProto.splice;function listCacheDelete(rt){var it=this.__data__,ct=assocIndexOf(it,rt);if(ct<0)return!1;var dt=it.length-1;return ct==dt?it.pop():splice.call(it,ct,1),--this.size,!0}function listCacheGet(rt){var it=this.__data__,ct=assocIndexOf(it,rt);return ct<0?void 0:it[ct][1]}function listCacheHas(rt){return assocIndexOf(this.__data__,rt)>-1}function listCacheSet(rt,it){var ct=this.__data__,dt=assocIndexOf(ct,rt);return dt<0?(++this.size,ct.push([rt,it])):ct[dt][1]=it,this}function ListCache(rt){var it=-1,ct=rt==null?0:rt.length;for(this.clear();++it<ct;){var dt=rt[it];this.set(dt[0],dt[1])}}ListCache.prototype.clear=listCacheClear;ListCache.prototype.delete=listCacheDelete;ListCache.prototype.get=listCacheGet;ListCache.prototype.has=listCacheHas;ListCache.prototype.set=listCacheSet;var Map$1=getNative(root,"Map");function mapCacheClear(){this.size=0,this.__data__={hash:new Hash,map:new(Map$1||ListCache),string:new Hash}}function isKeyable(rt){var it=typeof rt;return it=="string"||it=="number"||it=="symbol"||it=="boolean"?rt!=="__proto__":rt===null}function getMapData(rt,it){var ct=rt.__data__;return isKeyable(it)?ct[typeof it=="string"?"string":"hash"]:ct.map}function mapCacheDelete(rt){var it=getMapData(this,rt).delete(rt);return this.size-=it?1:0,it}function mapCacheGet(rt){return getMapData(this,rt).get(rt)}function mapCacheHas(rt){return getMapData(this,rt).has(rt)}function mapCacheSet(rt,it){var ct=getMapData(this,rt),dt=ct.size;return ct.set(rt,it),this.size+=ct.size==dt?0:1,this}function MapCache(rt){var it=-1,ct=rt==null?0:rt.length;for(this.clear();++it<ct;){var dt=rt[it];this.set(dt[0],dt[1])}}MapCache.prototype.clear=mapCacheClear;MapCache.prototype.delete=mapCacheDelete;MapCache.prototype.get=mapCacheGet;MapCache.prototype.has=mapCacheHas;MapCache.prototype.set=mapCacheSet;var FUNC_ERROR_TEXT="Expected a function";function memoize(rt,it){if(typeof rt!="function"||it!=null&&typeof it!="function")throw new TypeError(FUNC_ERROR_TEXT);var ct=function(){var dt=arguments,ut=it?it.apply(this,dt):dt[0],pt=ct.cache;if(pt.has(ut))return pt.get(ut);var yt=rt.apply(this,dt);return ct.cache=pt.set(ut,yt)||pt,yt};return ct.cache=new(memoize.Cache||MapCache),ct}memoize.Cache=MapCache;function stackClear(){this.__data__=new ListCache,this.size=0}function stackDelete(rt){var it=this.__data__,ct=it.delete(rt);return this.size=it.size,ct}function stackGet(rt){return this.__data__.get(rt)}function stackHas(rt){return this.__data__.has(rt)}var LARGE_ARRAY_SIZE=200;function stackSet(rt,it){var ct=this.__data__;if(ct instanceof ListCache){var dt=ct.__data__;if(!Map$1||dt.length<LARGE_ARRAY_SIZE-1)return dt.push([rt,it]),this.size=++ct.size,this;ct=this.__data__=new MapCache(dt)}return ct.set(rt,it),this.size=ct.size,this}function Stack(rt){var it=this.__data__=new ListCache(rt);this.size=it.size}Stack.prototype.clear=stackClear;Stack.prototype.delete=stackDelete;Stack.prototype.get=stackGet;Stack.prototype.has=stackHas;Stack.prototype.set=stackSet;var defineProperty=(function(){try{var rt=getNative(Object,"defineProperty");return rt({},"",{}),rt}catch{}})();function baseAssignValue(rt,it,ct){it=="__proto__"&&defineProperty?defineProperty(rt,it,{configurable:!0,enumerable:!0,value:ct,writable:!0}):rt[it]=ct}function assignMergeValue(rt,it,ct){(ct!==void 0&&!eq(rt[it],ct)||ct===void 0&&!(it in rt))&&baseAssignValue(rt,it,ct)}function createBaseFor(rt){return function(it,ct,dt){for(var ut=-1,pt=Object(it),yt=dt(it),ft=yt.length;ft--;){var mt=yt[++ut];if(ct(pt[mt],mt,pt)===!1)break}return it}}var baseFor=createBaseFor(),freeExports$2=typeof exports=="object"&&exports&&!exports.nodeType&&exports,freeModule$2=freeExports$2&&typeof module=="object"&&module&&!module.nodeType&&module,moduleExports$2=freeModule$2&&freeModule$2.exports===freeExports$2,Buffer$2=moduleExports$2?root.Buffer:void 0,allocUnsafe=Buffer$2?Buffer$2.allocUnsafe:void 0;function cloneBuffer(rt,it){if(it)return rt.slice();var ct=rt.length,dt=allocUnsafe?allocUnsafe(ct):new rt.constructor(ct);return rt.copy(dt),dt}var Uint8Array$1=root.Uint8Array;function cloneArrayBuffer(rt){var it=new rt.constructor(rt.byteLength);return new Uint8Array$1(it).set(new Uint8Array$1(rt)),it}function cloneTypedArray(rt,it){var ct=it?cloneArrayBuffer(rt.buffer):rt.buffer;return new rt.constructor(ct,rt.byteOffset,rt.length)}function copyArray(rt,it){var ct=-1,dt=rt.length;for(it||(it=Array(dt));++ct<dt;)it[ct]=rt[ct];return it}var objectCreate=Object.create,baseCreate=(function(){function rt(){}return function(it){if(!isObject$1(it))return{};if(objectCreate)return objectCreate(it);rt.prototype=it;var ct=new rt;return rt.prototype=void 0,ct}})();function overArg(rt,it){return function(ct){return rt(it(ct))}}var getPrototype=overArg(Object.getPrototypeOf,Object),objectProto$7=Object.prototype;function isPrototype(rt){var it=rt&&rt.constructor,ct=typeof it=="function"&&it.prototype||objectProto$7;return rt===ct}function initCloneObject(rt){return typeof rt.constructor=="function"&&!isPrototype(rt)?baseCreate(getPrototype(rt)):{}}function isObjectLike$1(rt){return rt!=null&&typeof rt=="object"}var argsTag$1="[object Arguments]";function baseIsArguments(rt){return isObjectLike$1(rt)&&baseGetTag(rt)==argsTag$1}var objectProto$6=Object.prototype,hasOwnProperty$6=objectProto$6.hasOwnProperty,propertyIsEnumerable=objectProto$6.propertyIsEnumerable,isArguments=baseIsArguments((function(){return arguments})())?baseIsArguments:function(rt){return isObjectLike$1(rt)&&hasOwnProperty$6.call(rt,"callee")&&!propertyIsEnumerable.call(rt,"callee")},isArray$1=Array.isArray,MAX_SAFE_INTEGER$1=9007199254740991;function isLength(rt){return typeof rt=="number"&&rt>-1&&rt%1==0&&rt<=MAX_SAFE_INTEGER$1}function isArrayLike(rt){return rt!=null&&isLength(rt.length)&&!isFunction(rt)}function isArrayLikeObject(rt){return isObjectLike$1(rt)&&isArrayLike(rt)}function stubFalse(){return!1}var freeExports$1=typeof exports=="object"&&exports&&!exports.nodeType&&exports,freeModule$1=freeExports$1&&typeof module=="object"&&module&&!module.nodeType&&module,moduleExports$1=freeModule$1&&freeModule$1.exports===freeExports$1,Buffer$1=moduleExports$1?root.Buffer:void 0,nativeIsBuffer=Buffer$1?Buffer$1.isBuffer:void 0,isBuffer=nativeIsBuffer||stubFalse,objectTag$2="[object Object]",funcProto=Function.prototype,objectProto$5=Object.prototype,funcToString=funcProto.toString,hasOwnProperty$5=objectProto$5.hasOwnProperty,objectCtorString=funcToString.call(Object);function isPlainObject(rt){if(!isObjectLike$1(rt)||baseGetTag(rt)!=objectTag$2)return!1;var it=getPrototype(rt);if(it===null)return!0;var ct=hasOwnProperty$5.call(it,"constructor")&&it.constructor;return typeof ct=="function"&&ct instanceof ct&&funcToString.call(ct)==objectCtorString}var argsTag="[object Arguments]",arrayTag="[object Array]",boolTag="[object Boolean]",dateTag="[object Date]",errorTag="[object Error]",funcTag="[object Function]",mapTag$2="[object Map]",numberTag="[object Number]",objectTag$1="[object Object]",regexpTag="[object RegExp]",setTag$2="[object Set]",stringTag="[object String]",weakMapTag$1="[object WeakMap]",arrayBufferTag="[object ArrayBuffer]",dataViewTag$1="[object DataView]",float32Tag="[object Float32Array]",float64Tag="[object Float64Array]",int8Tag="[object Int8Array]",int16Tag="[object Int16Array]",int32Tag="[object Int32Array]",uint8Tag="[object Uint8Array]",uint8ClampedTag="[object Uint8ClampedArray]",uint16Tag="[object Uint16Array]",uint32Tag="[object Uint32Array]",typedArrayTags={};typedArrayTags[float32Tag]=typedArrayTags[float64Tag]=typedArrayTags[int8Tag]=typedArrayTags[int16Tag]=typedArrayTags[int32Tag]=typedArrayTags[uint8Tag]=typedArrayTags[uint8ClampedTag]=typedArrayTags[uint16Tag]=typedArrayTags[uint32Tag]=!0;typedArrayTags[argsTag]=typedArrayTags[arrayTag]=typedArrayTags[arrayBufferTag]=typedArrayTags[boolTag]=typedArrayTags[dataViewTag$1]=typedArrayTags[dateTag]=typedArrayTags[errorTag]=typedArrayTags[funcTag]=typedArrayTags[mapTag$2]=typedArrayTags[numberTag]=typedArrayTags[objectTag$1]=typedArrayTags[regexpTag]=typedArrayTags[setTag$2]=typedArrayTags[stringTag]=typedArrayTags[weakMapTag$1]=!1;function baseIsTypedArray(rt){return isObjectLike$1(rt)&&isLength(rt.length)&&!!typedArrayTags[baseGetTag(rt)]}function baseUnary(rt){return function(it){return rt(it)}}var freeExports=typeof exports=="object"&&exports&&!exports.nodeType&&exports,freeModule=freeExports&&typeof module=="object"&&module&&!module.nodeType&&module,moduleExports=freeModule&&freeModule.exports===freeExports,freeProcess=moduleExports&&freeGlobal.process,nodeUtil=(function(){try{var rt=freeModule&&freeModule.require&&freeModule.require("util").types;return rt||freeProcess&&freeProcess.binding&&freeProcess.binding("util")}catch{}})(),nodeIsTypedArray=nodeUtil&&nodeUtil.isTypedArray,isTypedArray=nodeIsTypedArray?baseUnary(nodeIsTypedArray):baseIsTypedArray;function safeGet(rt,it){if(!(it==="constructor"&&typeof rt[it]=="function")&&it!="__proto__")return rt[it]}var objectProto$4=Object.prototype,hasOwnProperty$4=objectProto$4.hasOwnProperty;function assignValue(rt,it,ct){var dt=rt[it];(!(hasOwnProperty$4.call(rt,it)&&eq(dt,ct))||ct===void 0&&!(it in rt))&&baseAssignValue(rt,it,ct)}function copyObject(rt,it,ct,dt){var ut=!ct;ct||(ct={});for(var pt=-1,yt=it.length;++pt<yt;){var ft=it[pt],mt=void 0;mt===void 0&&(mt=rt[ft]),ut?baseAssignValue(ct,ft,mt):assignValue(ct,ft,mt)}return ct}function baseTimes(rt,it){for(var ct=-1,dt=Array(rt);++ct<rt;)dt[ct]=it(ct);return dt}var MAX_SAFE_INTEGER=9007199254740991,reIsUint=/^(?:0|[1-9]\d*)$/;function isIndex(rt,it){var ct=typeof rt;return it=it??MAX_SAFE_INTEGER,!!it&&(ct=="number"||ct!="symbol"&&reIsUint.test(rt))&&rt>-1&&rt%1==0&&rt<it}var objectProto$3=Object.prototype,hasOwnProperty$3=objectProto$3.hasOwnProperty;function arrayLikeKeys(rt,it){var ct=isArray$1(rt),dt=!ct&&isArguments(rt),ut=!ct&&!dt&&isBuffer(rt),pt=!ct&&!dt&&!ut&&isTypedArray(rt),yt=ct||dt||ut||pt,ft=yt?baseTimes(rt.length,String):[],mt=ft.length;for(var kt in rt)(it||hasOwnProperty$3.call(rt,kt))&&!(yt&&(kt=="length"||ut&&(kt=="offset"||kt=="parent")||pt&&(kt=="buffer"||kt=="byteLength"||kt=="byteOffset")||isIndex(kt,mt)))&&ft.push(kt);return ft}function nativeKeysIn(rt){var it=[];if(rt!=null)for(var ct in Object(rt))it.push(ct);return it}var objectProto$2=Object.prototype,hasOwnProperty$2=objectProto$2.hasOwnProperty;function baseKeysIn(rt){if(!isObject$1(rt))return nativeKeysIn(rt);var it=isPrototype(rt),ct=[];for(var dt in rt)dt=="constructor"&&(it||!hasOwnProperty$2.call(rt,dt))||ct.push(dt);return ct}function keysIn(rt){return isArrayLike(rt)?arrayLikeKeys(rt,!0):baseKeysIn(rt)}function toPlainObject(rt){return copyObject(rt,keysIn(rt))}function baseMergeDeep(rt,it,ct,dt,ut,pt,yt){var ft=safeGet(rt,ct),mt=safeGet(it,ct),kt=yt.get(mt);if(kt){assignMergeValue(rt,ct,kt);return}var _t=pt?pt(ft,mt,ct+"",rt,it,yt):void 0,vt=_t===void 0;if(vt){var bt=isArray$1(mt),Mt=!bt&&isBuffer(mt),wt=!bt&&!Mt&&isTypedArray(mt);_t=mt,bt||Mt||wt?isArray$1(ft)?_t=ft:isArrayLikeObject(ft)?_t=copyArray(ft):Mt?(vt=!1,_t=cloneBuffer(mt,!0)):wt?(vt=!1,_t=cloneTypedArray(mt,!0)):_t=[]:isPlainObject(mt)||isArguments(mt)?(_t=ft,isArguments(ft)?_t=toPlainObject(ft):(!isObject$1(ft)||isFunction(ft))&&(_t=initCloneObject(mt))):vt=!1}vt&&(yt.set(mt,_t),ut(_t,mt,dt,pt,yt),yt.delete(mt)),assignMergeValue(rt,ct,_t)}function baseMerge(rt,it,ct,dt,ut){rt!==it&&baseFor(it,function(pt,yt){if(ut||(ut=new Stack),isObject$1(pt))baseMergeDeep(rt,it,yt,ct,baseMerge,dt,ut);else{var ft=dt?dt(safeGet(rt,yt),pt,yt+"",rt,it,ut):void 0;ft===void 0&&(ft=pt),assignMergeValue(rt,yt,ft)}},keysIn)}function identity(rt){return rt}function apply(rt,it,ct){switch(ct.length){case 0:return rt.call(it);case 1:return rt.call(it,ct[0]);case 2:return rt.call(it,ct[0],ct[1]);case 3:return rt.call(it,ct[0],ct[1],ct[2])}return rt.apply(it,ct)}var nativeMax=Math.max;function overRest(rt,it,ct){return it=nativeMax(it===void 0?rt.length-1:it,0),function(){for(var dt=arguments,ut=-1,pt=nativeMax(dt.length-it,0),yt=Array(pt);++ut<pt;)yt[ut]=dt[it+ut];ut=-1;for(var ft=Array(it+1);++ut<it;)ft[ut]=dt[ut];return ft[it]=ct(yt),apply(rt,this,ft)}}function constant(rt){return function(){return rt}}var baseSetToString=defineProperty?function(rt,it){return defineProperty(rt,"toString",{configurable:!0,enumerable:!1,value:constant(it),writable:!0})}:identity,HOT_COUNT=800,HOT_SPAN=16,nativeNow=Date.now;function shortOut(rt){var it=0,ct=0;return function(){var dt=nativeNow(),ut=HOT_SPAN-(dt-ct);if(ct=dt,ut>0){if(++it>=HOT_COUNT)return arguments[0]}else it=0;return rt.apply(void 0,arguments)}}var setToString=shortOut(baseSetToString);function baseRest(rt,it){return setToString(overRest(rt,it,identity),rt+"")}function isIterateeCall(rt,it,ct){if(!isObject$1(ct))return!1;var dt=typeof it;return(dt=="number"?isArrayLike(ct)&&isIndex(it,ct.length):dt=="string"&&it in ct)?eq(ct[it],rt):!1}function createAssigner(rt){return baseRest(function(it,ct){var dt=-1,ut=ct.length,pt=ut>1?ct[ut-1]:void 0,yt=ut>2?ct[2]:void 0;for(pt=rt.length>3&&typeof pt=="function"?(ut--,pt):void 0,yt&&isIterateeCall(ct[0],ct[1],yt)&&(pt=ut<3?void 0:pt,ut=1),it=Object(it);++dt<ut;){var ft=ct[dt];ft&&rt(it,ft,dt,pt)}return it})}var merge=createAssigner(function(rt,it,ct){baseMerge(rt,it,ct)}),ZERO_WIDTH_SPACE="​",d3CurveTypes={curveBasis,curveBasisClosed,curveBasisOpen,curveBumpX:bumpX,curveBumpY:bumpY,curveBundle,curveCardinalClosed,curveCardinalOpen,curveCardinal,curveCatmullRomClosed,curveCatmullRomOpen,curveCatmullRom,curveLinear,curveLinearClosed,curveMonotoneX:monotoneX,curveMonotoneY:monotoneY,curveNatural,curveStep,curveStepAfter:stepAfter,curveStepBefore:stepBefore},directiveWithoutOpen=/\s*(?:(\w+)(?=:):|(\w+))\s*(?:(\w+)|((?:(?!}%{2}).|\r?\n)*))?\s*(?:}%{2})?/gi,detectInit=__name(function(rt,it){const ct=detectDirective(rt,/(?:init\b)|(?:initialize\b)/);let dt={};if(Array.isArray(ct)){const yt=ct.map(ft=>ft.args);sanitizeDirective(yt),dt=assignWithDepth_default(dt,[...yt])}else dt=ct.args;if(!dt)return;let ut=detectType$1(rt,it);const pt="config";return dt[pt]!==void 0&&(ut==="flowchart-v2"&&(ut="flowchart"),dt[ut]=dt[pt],delete dt[pt]),dt},"detectInit"),detectDirective=__name(function(rt,it=null){try{const ct=new RegExp(`[%]{2}(?![{]${directiveWithoutOpen.source})(?=[}][%]{2}).*
-`,"ig");rt=rt.trim().replace(ct,"").replace(/'/gm,'"'),log.debug(`Detecting diagram directive${it!==null?" type:"+it:""} based on the text:${rt}`);let dt;const ut=[];for(;(dt=directiveRegex.exec(rt))!==null;)if(dt.index===directiveRegex.lastIndex&&directiveRegex.lastIndex++,dt&&!it||it&&dt[1]?.match(it)||it&&dt[2]?.match(it)){const pt=dt[1]?dt[1]:dt[2],yt=dt[3]?dt[3].trim():dt[4]?JSON.parse(dt[4].trim()):null;ut.push({type:pt,args:yt})}return ut.length===0?{type:rt,args:null}:ut.length===1?ut[0]:ut}catch(ct){return log.error(`ERROR: ${ct.message} - Unable to parse directive type: '${it}' based on the text: '${rt}'`),{type:void 0,args:null}}},"detectDirective"),removeDirectives=__name(function(rt){return rt.replace(directiveRegex,"")},"removeDirectives"),isSubstringInArray=__name(function(rt,it){for(const[ct,dt]of it.entries())if(dt.match(rt))return ct;return-1},"isSubstringInArray");function interpolateToCurve(rt,it){if(!rt)return it;const ct=`curve${rt.charAt(0).toUpperCase()+rt.slice(1)}`;return d3CurveTypes[ct]??it}__name(interpolateToCurve,"interpolateToCurve");function formatUrl(rt,it){const ct=rt.trim();if(ct)return it.securityLevel!=="loose"?distExports.sanitizeUrl(ct):ct}__name(formatUrl,"formatUrl");var runFunc=__name((rt,...it)=>{const ct=rt.split("."),dt=ct.length-1,ut=ct[dt];let pt=window;for(let yt=0;yt<dt;yt++)if(pt=pt[ct[yt]],!pt){log.error(`Function name: ${rt} not found in window`);return}pt[ut](...it)},"runFunc");function distance(rt,it){return!rt||!it?0:Math.sqrt(Math.pow(it.x-rt.x,2)+Math.pow(it.y-rt.y,2))}__name(distance,"distance");function traverseEdge(rt){let it,ct=0;rt.forEach(ut=>{ct+=distance(ut,it),it=ut});const dt=ct/2;return calculatePoint(rt,dt)}__name(traverseEdge,"traverseEdge");function calcLabelPosition(rt){return rt.length===1?rt[0]:traverseEdge(rt)}__name(calcLabelPosition,"calcLabelPosition");var roundNumber=__name((rt,it=2)=>{const ct=Math.pow(10,it);return Math.round(rt*ct)/ct},"roundNumber"),calculatePoint=__name((rt,it)=>{let ct,dt=it;for(const ut of rt){if(ct){const pt=distance(ut,ct);if(pt===0)return ct;if(pt<dt)dt-=pt;else{const yt=dt/pt;if(yt<=0)return ct;if(yt>=1)return{x:ut.x,y:ut.y};if(yt>0&&yt<1)return{x:roundNumber((1-yt)*ct.x+yt*ut.x,5),y:roundNumber((1-yt)*ct.y+yt*ut.y,5)}}}ct=ut}throw new Error("Could not find a suitable point for the given distance")},"calculatePoint"),calcCardinalityPosition=__name((rt,it,ct)=>{log.info(`our points ${JSON.stringify(it)}`),it[0]!==ct&&(it=it.reverse());const ut=calculatePoint(it,25),pt=rt?10:5,yt=Math.atan2(it[0].y-ut.y,it[0].x-ut.x),ft={x:0,y:0};return ft.x=Math.sin(yt)*pt+(it[0].x+ut.x)/2,ft.y=-Math.cos(yt)*pt+(it[0].y+ut.y)/2,ft},"calcCardinalityPosition");function calcTerminalLabelPosition(rt,it,ct){const dt=structuredClone(ct);log.info("our points",dt),it!=="start_left"&&it!=="start_right"&&dt.reverse();const ut=25+rt,pt=calculatePoint(dt,ut),yt=10+rt*.5,ft=Math.atan2(dt[0].y-pt.y,dt[0].x-pt.x),mt={x:0,y:0};return it==="start_left"?(mt.x=Math.sin(ft+Math.PI)*yt+(dt[0].x+pt.x)/2,mt.y=-Math.cos(ft+Math.PI)*yt+(dt[0].y+pt.y)/2):it==="end_right"?(mt.x=Math.sin(ft-Math.PI)*yt+(dt[0].x+pt.x)/2-5,mt.y=-Math.cos(ft-Math.PI)*yt+(dt[0].y+pt.y)/2-5):it==="end_left"?(mt.x=Math.sin(ft)*yt+(dt[0].x+pt.x)/2-5,mt.y=-Math.cos(ft)*yt+(dt[0].y+pt.y)/2-5):(mt.x=Math.sin(ft)*yt+(dt[0].x+pt.x)/2,mt.y=-Math.cos(ft)*yt+(dt[0].y+pt.y)/2),mt}__name(calcTerminalLabelPosition,"calcTerminalLabelPosition");function getStylesFromArray(rt){let it="",ct="";for(const dt of rt)dt!==void 0&&(dt.startsWith("color:")||dt.startsWith("text-align:")?ct=ct+dt+";":it=it+dt+";");return{style:it,labelStyle:ct}}__name(getStylesFromArray,"getStylesFromArray");var cnt=0,generateId=__name(()=>(cnt++,"id-"+Math.random().toString(36).substr(2,12)+"-"+cnt),"generateId");function makeRandomHex(rt){let it="";const ct="0123456789abcdef",dt=ct.length;for(let ut=0;ut<rt;ut++)it+=ct.charAt(Math.floor(Math.random()*dt));return it}__name(makeRandomHex,"makeRandomHex");var random=__name(rt=>makeRandomHex(rt.length),"random"),getTextObj=__name(function(){return{x:0,y:0,fill:void 0,anchor:"start",style:"#666",width:100,height:100,textMargin:0,rx:0,ry:0,valign:void 0,text:""}},"getTextObj"),drawSimpleText=__name(function(rt,it){const ct=it.text.replace(common_default.lineBreakRegex," "),[,dt]=parseFontSize(it.fontSize),ut=rt.append("text");ut.attr("x",it.x),ut.attr("y",it.y),ut.style("text-anchor",it.anchor),ut.style("font-family",it.fontFamily),ut.style("font-size",dt),ut.style("font-weight",it.fontWeight),ut.attr("fill",it.fill),it.class!==void 0&&ut.attr("class",it.class);const pt=ut.append("tspan");return pt.attr("x",it.x+it.textMargin*2),pt.attr("fill",it.fill),pt.text(ct),ut},"drawSimpleText"),wrapLabel=memoize((rt,it,ct)=>{if(!rt||(ct=Object.assign({fontSize:12,fontWeight:400,fontFamily:"Arial",joinWith:"<br/>"},ct),common_default.lineBreakRegex.test(rt)))return rt;const dt=rt.split(" ").filter(Boolean),ut=[];let pt="";return dt.forEach((yt,ft)=>{const mt=calculateTextWidth(`${yt} `,ct),kt=calculateTextWidth(pt,ct);if(mt>it){const{hyphenatedStrings:bt,remainingWord:Mt}=breakString(yt,it,"-",ct);ut.push(pt,...bt),pt=Mt}else kt+mt>=it?(ut.push(pt),pt=yt):pt=[pt,yt].filter(Boolean).join(" ");ft+1===dt.length&&ut.push(pt)}),ut.filter(yt=>yt!=="").join(ct.joinWith)},(rt,it,ct)=>`${rt}${it}${ct.fontSize}${ct.fontWeight}${ct.fontFamily}${ct.joinWith}`),breakString=memoize((rt,it,ct="-",dt)=>{dt=Object.assign({fontSize:12,fontWeight:400,fontFamily:"Arial",margin:0},dt);const ut=[...rt],pt=[];let yt="";return ut.forEach((ft,mt)=>{const kt=`${yt}${ft}`;if(calculateTextWidth(kt,dt)>=it){const vt=mt+1,bt=ut.length===vt,Mt=`${kt}${ct}`;pt.push(bt?kt:Mt),yt=""}else yt=kt}),{hyphenatedStrings:pt,remainingWord:yt}},(rt,it,ct="-",dt)=>`${rt}${it}${ct}${dt.fontSize}${dt.fontWeight}${dt.fontFamily}`);function calculateTextHeight(rt,it){return calculateTextDimensions(rt,it).height}__name(calculateTextHeight,"calculateTextHeight");function calculateTextWidth(rt,it){return calculateTextDimensions(rt,it).width}__name(calculateTextWidth,"calculateTextWidth");var calculateTextDimensions=memoize((rt,it)=>{const{fontSize:ct=12,fontFamily:dt="Arial",fontWeight:ut=400}=it;if(!rt)return{width:0,height:0};const[,pt]=parseFontSize(ct),yt=["sans-serif",dt],ft=rt.split(common_default.lineBreakRegex),mt=[],kt=select("body");if(!kt.remove)return{width:0,height:0,lineHeight:0};const _t=kt.append("svg");for(const bt of yt){let Mt=0;const wt={width:0,height:0,lineHeight:0};for(const St of ft){const It=getTextObj();It.text=St||ZERO_WIDTH_SPACE;const Nt=drawSimpleText(_t,It).style("font-size",pt).style("font-weight",ut).style("font-family",bt),$t=(Nt._groups||Nt)[0][0].getBBox();if($t.width===0&&$t.height===0)throw new Error("svg element not in render tree");wt.width=Math.round(Math.max(wt.width,$t.width)),Mt=Math.round($t.height),wt.height+=Mt,wt.lineHeight=Math.round(Math.max(wt.lineHeight,Mt))}mt.push(wt)}_t.remove();const vt=isNaN(mt[1].height)||isNaN(mt[1].width)||isNaN(mt[1].lineHeight)||mt[0].height>mt[1].height&&mt[0].width>mt[1].width&&mt[0].lineHeight>mt[1].lineHeight?0:1;return mt[vt]},(rt,it)=>`${rt}${it.fontSize}${it.fontWeight}${it.fontFamily}`),No,InitIDGenerator=(No=class{constructor(it=!1,ct){this.count=0,this.count=ct?ct.length:0,this.next=it?()=>this.count++:()=>Date.now()}},__name(No,"InitIDGenerator"),No),decoder,entityDecode=__name(function(rt){return decoder=decoder||document.createElement("div"),rt=escape(rt).replace(/%26/g,"&").replace(/%23/g,"#").replace(/%3B/g,";"),decoder.innerHTML=rt,unescape(decoder.textContent)},"entityDecode");function isDetailedError(rt){return"str"in rt}__name(isDetailedError,"isDetailedError");var insertTitle=__name((rt,it,ct,dt)=>{if(!dt)return;const ut=rt.node()?.getBBox();ut&&rt.append("text").text(dt).attr("text-anchor","middle").attr("x",ut.x+ut.width/2).attr("y",-ct).attr("class",it)},"insertTitle"),parseFontSize=__name(rt=>{if(typeof rt=="number")return[rt,rt+"px"];const it=parseInt(rt??"",10);return Number.isNaN(it)?[void 0,void 0]:rt===String(it)?[it,rt+"px"]:[it,rt]},"parseFontSize");function cleanAndMerge(rt,it){return merge({},rt,it)}__name(cleanAndMerge,"cleanAndMerge");var utils_default={assignWithDepth:assignWithDepth_default,wrapLabel,calculateTextHeight,calculateTextWidth,calculateTextDimensions,cleanAndMerge,detectInit,detectDirective,isSubstringInArray,interpolateToCurve,calcLabelPosition,calcCardinalityPosition,calcTerminalLabelPosition,formatUrl,getStylesFromArray,generateId,random,runFunc,entityDecode,insertTitle,isLabelCoordinateInPath,parseFontSize,InitIDGenerator},encodeEntities=__name(function(rt){let it=rt;return it=it.replace(/style.*:\S*#.*;/g,function(ct){return ct.substring(0,ct.length-1)}),it=it.replace(/classDef.*:\S*#.*;/g,function(ct){return ct.substring(0,ct.length-1)}),it=it.replace(/#\w+;/g,function(ct){const dt=ct.substring(1,ct.length-1);return/^\+?\d+$/.test(dt)?"fl°°"+dt+"¶ß":"fl°"+dt+"¶ß"}),it},"encodeEntities"),decodeEntities=__name(function(rt){return rt.replace(/fl°°/g,"&#").replace(/fl°/g,"&").replace(/¶ß/g,";")},"decodeEntities"),getEdgeId=__name((rt,it,{counter:ct=0,prefix:dt,suffix:ut},pt)=>pt||`${dt?`${dt}_`:""}${rt}_${it}_${ct}${ut?`_${ut}`:""}`,"getEdgeId");function handleUndefinedAttr(rt){return rt??null}__name(handleUndefinedAttr,"handleUndefinedAttr");function isLabelCoordinateInPath(rt,it){const ct=Math.round(rt.x),dt=Math.round(rt.y),ut=it.replace(/(\d+\.\d+)/g,pt=>Math.round(parseFloat(pt)).toString());return ut.includes(ct.toString())||ut.includes(dt.toString())}__name(isLabelCoordinateInPath,"isLabelCoordinateInPath");const defaultIconDimensions=Object.freeze({left:0,top:0,width:16,height:16}),defaultIconTransformations=Object.freeze({rotate:0,vFlip:!1,hFlip:!1}),defaultIconProps=Object.freeze({...defaultIconDimensions,...defaultIconTransformations}),defaultExtendedIconProps=Object.freeze({...defaultIconProps,body:"",hidden:!1}),defaultIconSizeCustomisations=Object.freeze({width:null,height:null}),defaultIconCustomisations=Object.freeze({...defaultIconSizeCustomisations,...defaultIconTransformations}),stringToIcon=(rt,it,ct,dt="")=>{const ut=rt.split(":");if(rt.slice(0,1)==="@"){if(ut.length<2||ut.length>3)return null;dt=ut.shift().slice(1)}if(ut.length>3||!ut.length)return null;if(ut.length>1){const ft=ut.pop(),mt=ut.pop(),kt={provider:ut.length>0?ut[0]:dt,prefix:mt,name:ft};return validateIconName(kt)?kt:null}const pt=ut[0],yt=pt.split("-");if(yt.length>1){const ft={provider:dt,prefix:yt.shift(),name:yt.join("-")};return validateIconName(ft)?ft:null}if(ct&&dt===""){const ft={provider:dt,prefix:"",name:pt};return validateIconName(ft,ct)?ft:null}return null},validateIconName=(rt,it)=>rt?!!((it&&rt.prefix===""||rt.prefix)&&rt.name):!1;function mergeIconTransformations(rt,it){const ct={};!rt.hFlip!=!it.hFlip&&(ct.hFlip=!0),!rt.vFlip!=!it.vFlip&&(ct.vFlip=!0);const dt=((rt.rotate||0)+(it.rotate||0))%4;return dt&&(ct.rotate=dt),ct}function mergeIconData(rt,it){const ct=mergeIconTransformations(rt,it);for(const dt in defaultExtendedIconProps)dt in defaultIconTransformations?dt in rt&&!(dt in ct)&&(ct[dt]=defaultIconTransformations[dt]):dt in it?ct[dt]=it[dt]:dt in rt&&(ct[dt]=rt[dt]);return ct}function getIconsTree(rt,it){const ct=rt.icons,dt=rt.aliases||Object.create(null),ut=Object.create(null);function pt(yt){if(ct[yt])return ut[yt]=[];if(!(yt in ut)){ut[yt]=null;const ft=dt[yt]&&dt[yt].parent,mt=ft&&pt(ft);mt&&(ut[yt]=[ft].concat(mt))}return ut[yt]}return(it||Object.keys(ct).concat(Object.keys(dt))).forEach(pt),ut}function internalGetIconData(rt,it,ct){const dt=rt.icons,ut=rt.aliases||Object.create(null);let pt={};function yt(ft){pt=mergeIconData(dt[ft]||ut[ft],pt)}return yt(it),ct.forEach(yt),mergeIconData(rt,pt)}function getIconData(rt,it){if(rt.icons[it])return internalGetIconData(rt,it,[]);const ct=getIconsTree(rt,[it])[it];return ct?internalGetIconData(rt,it,ct):null}const unitsSplit=/(-?[0-9.]*[0-9]+[0-9.]*)/g,unitsTest=/^-?[0-9.]*[0-9]+[0-9.]*$/g;function calculateSize(rt,it,ct){if(it===1)return rt;if(ct=ct||100,typeof rt=="number")return Math.ceil(rt*it*ct)/ct;if(typeof rt!="string")return rt;const dt=rt.split(unitsSplit);if(dt===null||!dt.length)return rt;const ut=[];let pt=dt.shift(),yt=unitsTest.test(pt);for(;;){if(yt){const ft=parseFloat(pt);isNaN(ft)?ut.push(pt):ut.push(Math.ceil(ft*it*ct)/ct)}else ut.push(pt);if(pt=dt.shift(),pt===void 0)return ut.join("");yt=!yt}}function splitSVGDefs(rt,it="defs"){let ct="";const dt=rt.indexOf("<"+it);for(;dt>=0;){const ut=rt.indexOf(">",dt),pt=rt.indexOf("</"+it);if(ut===-1||pt===-1)break;const yt=rt.indexOf(">",pt);if(yt===-1)break;ct+=rt.slice(ut+1,pt).trim(),rt=rt.slice(0,dt).trim()+rt.slice(yt+1)}return{defs:ct,content:rt}}function mergeDefsAndContent(rt,it){return rt?"<defs>"+rt+"</defs>"+it:it}function wrapSVGContent(rt,it,ct){const dt=splitSVGDefs(rt);return mergeDefsAndContent(dt.defs,it+dt.content+ct)}const isUnsetKeyword=rt=>rt==="unset"||rt==="undefined"||rt==="none";function iconToSVG(rt,it){const ct={...defaultIconProps,...rt},dt={...defaultIconCustomisations,...it},ut={left:ct.left,top:ct.top,width:ct.width,height:ct.height};let pt=ct.body;[ct,dt].forEach(St=>{const It=[],Nt=St.hFlip,$t=St.vFlip;let Et=St.rotate;Nt?$t?Et+=2:(It.push("translate("+(ut.width+ut.left).toString()+" "+(0-ut.top).toString()+")"),It.push("scale(-1 1)"),ut.top=ut.left=0):$t&&(It.push("translate("+(0-ut.left).toString()+" "+(ut.height+ut.top).toString()+")"),It.push("scale(1 -1)"),ut.top=ut.left=0);let Ft;switch(Et<0&&(Et-=Math.floor(Et/4)*4),Et=Et%4,Et){case 1:Ft=ut.height/2+ut.top,It.unshift("rotate(90 "+Ft.toString()+" "+Ft.toString()+")");break;case 2:It.unshift("rotate(180 "+(ut.width/2+ut.left).toString()+" "+(ut.height/2+ut.top).toString()+")");break;case 3:Ft=ut.width/2+ut.left,It.unshift("rotate(-90 "+Ft.toString()+" "+Ft.toString()+")");break}Et%2===1&&(ut.left!==ut.top&&(Ft=ut.left,ut.left=ut.top,ut.top=Ft),ut.width!==ut.height&&(Ft=ut.width,ut.width=ut.height,ut.height=Ft)),It.length&&(pt=wrapSVGContent(pt,'<g transform="'+It.join(" ")+'">',"</g>"))});const yt=dt.width,ft=dt.height,mt=ut.width,kt=ut.height;let _t,vt;yt===null?(vt=ft===null?"1em":ft==="auto"?kt:ft,_t=calculateSize(vt,mt/kt)):(_t=yt==="auto"?mt:yt,vt=ft===null?calculateSize(_t,kt/mt):ft==="auto"?kt:ft);const bt={},Mt=(St,It)=>{isUnsetKeyword(It)||(bt[St]=It.toString())};Mt("width",_t),Mt("height",vt);const wt=[ut.left,ut.top,mt,kt];return bt.viewBox=wt.join(" "),{attributes:bt,viewBox:wt,body:pt}}const regex=/\sid="(\S+)"/g,randomPrefix="IconifyId"+Date.now().toString(16)+(Math.random()*16777216|0).toString(16);let counter=0;function replaceIDs(rt,it=randomPrefix){const ct=[];let dt;for(;dt=regex.exec(rt);)ct.push(dt[1]);if(!ct.length)return rt;const ut="suffix"+(Math.random()*16777216|Date.now()).toString(16);return ct.forEach(pt=>{const yt=typeof it=="function"?it(pt):it+(counter++).toString(),ft=pt.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");rt=rt.replace(new RegExp('([#;"])('+ft+')([")]|\\.[a-z])',"g"),"$1"+yt+ut+"$3")}),rt=rt.replace(new RegExp(ut,"g"),""),rt}function iconToHTML(rt,it){let ct=rt.indexOf("xlink:")===-1?"":' xmlns:xlink="http://www.w3.org/1999/xlink"';for(const dt in it)ct+=" "+dt+'="'+it[dt]+'"';return'<svg xmlns="http://www.w3.org/2000/svg"'+ct+">"+rt+"</svg>"}function L$2(){return{async:!1,breaks:!1,extensions:null,gfm:!0,hooks:null,pedantic:!1,renderer:null,silent:!1,tokenizer:null,walkTokens:null}}var T$2=L$2();function G$2(rt){T$2=rt}var E$2={exec:()=>null};function d$2(rt,it=""){let ct=typeof rt=="string"?rt:rt.source,dt={replace:(ut,pt)=>{let yt=typeof pt=="string"?pt:pt.source;return yt=yt.replace(m$2.caret,"$1"),ct=ct.replace(ut,yt),dt},getRegex:()=>new RegExp(ct,it)};return dt}var be$1=(()=>{try{return!!new RegExp("(?<=1)(?<!1)")}catch{return!1}})(),m$2={codeRemoveIndent:/^(?: {1,4}| {0,3}\t)/gm,outputLinkReplace:/\\([\[\]])/g,indentCodeCompensation:/^(\s+)(?:```)/,beginningSpace:/^\s+/,endingHash:/#$/,startingSpaceChar:/^ /,endingSpaceChar:/ $/,nonSpaceChar:/[^ ]/,newLineCharGlobal:/\n/g,tabCharGlobal:/\t/g,multipleSpaceGlobal:/\s+/g,blankLine:/^[ \t]*$/,doubleBlankLine:/\n[ \t]*\n[ \t]*$/,blockquoteStart:/^ {0,3}>/,blockquoteSetextReplace:/\n {0,3}((?:=+|-+) *)(?=\n|$)/g,blockquoteSetextReplace2:/^ {0,3}>[ \t]?/gm,listReplaceTabs:/^\t+/,listReplaceNesting:/^ {1,4}(?=( {4})*[^ ])/g,listIsTask:/^\[[ xX]\] /,listReplaceTask:/^\[[ xX]\] +/,anyLine:/\n.*\n/,hrefBrackets:/^<(.*)>$/,tableDelimiter:/[:|]/,tableAlignChars:/^\||\| *$/g,tableRowBlankLine:/\n[ \t]*$/,tableAlignRight:/^ *-+: *$/,tableAlignCenter:/^ *:-+: *$/,tableAlignLeft:/^ *:-+ *$/,startATag:/^<a /i,endATag:/^<\/a>/i,startPreScriptTag:/^<(pre|code|kbd|script)(\s|>)/i,endPreScriptTag:/^<\/(pre|code|kbd|script)(\s|>)/i,startAngleBracket:/^</,endAngleBracket:/>$/,pedanticHrefTitle:/^([^'"]*[^\s])\s+(['"])(.*)\2/,unicodeAlphaNumeric:/[\p{L}\p{N}]/u,escapeTest:/[&<>"']/,escapeReplace:/[&<>"']/g,escapeTestNoEncode:/[<>"']|&(?!(#\d{1,7}|#[Xx][a-fA-F0-9]{1,6}|\w+);)/,escapeReplaceNoEncode:/[<>"']|&(?!(#\d{1,7}|#[Xx][a-fA-F0-9]{1,6}|\w+);)/g,unescapeTest:/&(#(?:\d+)|(?:#x[0-9A-Fa-f]+)|(?:\w+));?/ig,caret:/(^|[^\[])\^/g,percentDecode:/%25/g,findPipe:/\|/g,splitPipe:/ \|/,slashPipe:/\\\|/g,carriageReturn:/\r\n|\r/g,spaceLine:/^ +$/gm,notSpaceStart:/^\S*/,endingNewline:/\n$/,listItemRegex:rt=>new RegExp(`^( {0,3}${rt})((?:[	 ][^\\n]*)?(?:\\n|$))`),nextBulletRegex:rt=>new RegExp(`^ {0,${Math.min(3,rt-1)}}(?:[*+-]|\\d{1,9}[.)])((?:[ 	][^\\n]*)?(?:\\n|$))`),hrRegex:rt=>new RegExp(`^ {0,${Math.min(3,rt-1)}}((?:- *){3,}|(?:_ *){3,}|(?:\\* *){3,})(?:\\n+|$)`),fencesBeginRegex:rt=>new RegExp(`^ {0,${Math.min(3,rt-1)}}(?:\`\`\`|~~~)`),headingBeginRegex:rt=>new RegExp(`^ {0,${Math.min(3,rt-1)}}#`),htmlBeginRegex:rt=>new RegExp(`^ {0,${Math.min(3,rt-1)}}<(?:[a-z].*>|!--)`,"i")},Re$1=/^(?:[ \t]*(?:\n|$))+/,Te$1=/^((?: {4}| {0,3}\t)[^\n]+(?:\n(?:[ \t]*(?:\n|$))*)?)+/,Oe$1=/^ {0,3}(`{3,}(?=[^`\n]*(?:\n|$))|~{3,})([^\n]*)(?:\n|$)(?:|([\s\S]*?)(?:\n|$))(?: {0,3}\1[~`]* *(?=\n|$)|$)/,I$2=/^ {0,3}((?:-[\t ]*){3,}|(?:_[ \t]*){3,}|(?:\*[ \t]*){3,})(?:\n+|$)/,we$1=/^ {0,3}(#{1,6})(?=\s|$)(.*)(?:\n+|$)/,F$2=/(?:[*+-]|\d{1,9}[.)])/,ie$1=/^(?!bull |blockCode|fences|blockquote|heading|html|table)((?:.|\n(?!\s*?\n|bull |blockCode|fences|blockquote|heading|html|table))+?)\n {0,3}(=+|-+) *(?:\n+|$)/,oe$1=d$2(ie$1).replace(/bull/g,F$2).replace(/blockCode/g,/(?: {4}| {0,3}\t)/).replace(/fences/g,/ {0,3}(?:`{3,}|~{3,})/).replace(/blockquote/g,/ {0,3}>/).replace(/heading/g,/ {0,3}#{1,6}/).replace(/html/g,/ {0,3}<[^\n>]+>\n/).replace(/\|table/g,"").getRegex(),ye$1=d$2(ie$1).replace(/bull/g,F$2).replace(/blockCode/g,/(?: {4}| {0,3}\t)/).replace(/fences/g,/ {0,3}(?:`{3,}|~{3,})/).replace(/blockquote/g,/ {0,3}>/).replace(/heading/g,/ {0,3}#{1,6}/).replace(/html/g,/ {0,3}<[^\n>]+>\n/).replace(/table/g,/ {0,3}\|?(?:[:\- ]*\|)+[\:\- ]*\n/).getRegex(),j$2=/^([^\n]+(?:\n(?!hr|heading|lheading|blockquote|fences|list|html|table| +\n)[^\n]+)*)/,Pe$1=/^[^\n]+/,Q$2=/(?!\s*\])(?:\\[\s\S]|[^\[\]\\])+/,Se$1=d$2(/^ {0,3}\[(label)\]: *(?:\n[ \t]*)?([^<\s][^\s]*|<.*?>)(?:(?: +(?:\n[ \t]*)?| *\n[ \t]*)(title))? *(?:\n+|$)/).replace("label",Q$2).replace("title",/(?:"(?:\\"?|[^"\\])*"|'[^'\n]*(?:\n[^'\n]+)*\n?'|\([^()]*\))/).getRegex(),$e$1=d$2(/^( {0,3}bull)([ \t][^\n]+?)?(?:\n|$)/).replace(/bull/g,F$2).getRegex(),v$2="address|article|aside|base|basefont|blockquote|body|caption|center|col|colgroup|dd|details|dialog|dir|div|dl|dt|fieldset|figcaption|figure|footer|form|frame|frameset|h[1-6]|head|header|hr|html|iframe|legend|li|link|main|menu|menuitem|meta|nav|noframes|ol|optgroup|option|p|param|search|section|summary|table|tbody|td|tfoot|th|thead|title|tr|track|ul",U$2=/<!--(?:-?>|[\s\S]*?(?:-->|$))/,_e$1=d$2("^ {0,3}(?:<(script|pre|style|textarea)[\\s>][\\s\\S]*?(?:</\\1>[^\\n]*\\n+|$)|comment[^\\n]*(\\n+|$)|<\\?[\\s\\S]*?(?:\\?>\\n*|$)|<![A-Z][\\s\\S]*?(?:>\\n*|$)|<!\\[CDATA\\[[\\s\\S]*?(?:\\]\\]>\\n*|$)|</?(tag)(?: +|\\n|/?>)[\\s\\S]*?(?:(?:\\n[ 	]*)+\\n|$)|<(?!script|pre|style|textarea)([a-z][\\w-]*)(?:attribute)*? */?>(?=[ \\t]*(?:\\n|$))[\\s\\S]*?(?:(?:\\n[ 	]*)+\\n|$)|</(?!script|pre|style|textarea)[a-z][\\w-]*\\s*>(?=[ \\t]*(?:\\n|$))[\\s\\S]*?(?:(?:\\n[ 	]*)+\\n|$))","i").replace("comment",U$2).replace("tag",v$2).replace("attribute",/ +[a-zA-Z:_][\w.:-]*(?: *= *"[^"\n]*"| *= *'[^'\n]*'| *= *[^\s"'=<>`]+)?/).getRegex(),ae$1=d$2(j$2).replace("hr",I$2).replace("heading"," {0,3}#{1,6}(?:\\s|$)").replace("|lheading","").replace("|table","").replace("blockquote"," {0,3}>").replace("fences"," {0,3}(?:`{3,}(?=[^`\\n]*\\n)|~{3,})[^\\n]*\\n").replace("list"," {0,3}(?:[*+-]|1[.)]) ").replace("html","</?(?:tag)(?: +|\\n|/?>)|<(?:script|pre|style|textarea|!--)").replace("tag",v$2).getRegex(),Le$1=d$2(/^( {0,3}> ?(paragraph|[^\n]*)(?:\n|$))+/).replace("paragraph",ae$1).getRegex(),K$2={blockquote:Le$1,code:Te$1,def:Se$1,fences:Oe$1,heading:we$1,hr:I$2,html:_e$1,lheading:oe$1,list:$e$1,newline:Re$1,paragraph:ae$1,table:E$2,text:Pe$1},re$1=d$2("^ *([^\\n ].*)\\n {0,3}((?:\\| *)?:?-+:? *(?:\\| *:?-+:? *)*(?:\\| *)?)(?:\\n((?:(?! *\\n|hr|heading|blockquote|code|fences|list|html).*(?:\\n|$))*)\\n*|$)").replace("hr",I$2).replace("heading"," {0,3}#{1,6}(?:\\s|$)").replace("blockquote"," {0,3}>").replace("code","(?: {4}| {0,3}	)[^\\n]").replace("fences"," {0,3}(?:`{3,}(?=[^`\\n]*\\n)|~{3,})[^\\n]*\\n").replace("list"," {0,3}(?:[*+-]|1[.)]) ").replace("html","</?(?:tag)(?: +|\\n|/?>)|<(?:script|pre|style|textarea|!--)").replace("tag",v$2).getRegex(),Me$1={...K$2,lheading:ye$1,table:re$1,paragraph:d$2(j$2).replace("hr",I$2).replace("heading"," {0,3}#{1,6}(?:\\s|$)").replace("|lheading","").replace("table",re$1).replace("blockquote"," {0,3}>").replace("fences"," {0,3}(?:`{3,}(?=[^`\\n]*\\n)|~{3,})[^\\n]*\\n").replace("list"," {0,3}(?:[*+-]|1[.)]) ").replace("html","</?(?:tag)(?: +|\\n|/?>)|<(?:script|pre|style|textarea|!--)").replace("tag",v$2).getRegex()},ze$1={...K$2,html:d$2(`^ *(?:comment *(?:\\n|\\s*$)|<(tag)[\\s\\S]+?</\\1> *(?:\\n{2,}|\\s*$)|<tag(?:"[^"]*"|'[^']*'|\\s[^'"/>\\s]*)*?/?> *(?:\\n{2,}|\\s*$))`).replace("comment",U$2).replace(/tag/g,"(?!(?:a|em|strong|small|s|cite|q|dfn|abbr|data|time|code|var|samp|kbd|sub|sup|i|b|u|mark|ruby|rt|rp|bdi|bdo|span|br|wbr|ins|del|img)\\b)\\w+(?!:|[^\\w\\s@]*@)\\b").getRegex(),def:/^ *\[([^\]]+)\]: *<?([^\s>]+)>?(?: +(["(][^\n]+[")]))? *(?:\n+|$)/,heading:/^(#{1,6})(.*)(?:\n+|$)/,fences:E$2,lheading:/^(.+?)\n {0,3}(=+|-+) *(?:\n+|$)/,paragraph:d$2(j$2).replace("hr",I$2).replace("heading",` *#{1,6} *[^
-]`).replace("lheading",oe$1).replace("|table","").replace("blockquote"," {0,3}>").replace("|fences","").replace("|list","").replace("|html","").replace("|tag","").getRegex()},Ae$1=/^\\([!"#$%&'()*+,\-./:;<=>?@\[\]\\^_`{|}~])/,Ee$1=/^(`+)([^`]|[^`][\s\S]*?[^`])\1(?!`)/,le$1=/^( {2,}|\\)\n(?!\s*$)/,Ie$1=/^(`+|[^`])(?:(?= {2,}\n)|[\s\S]*?(?:(?=[\\<!\[`*_]|\b_|$)|[^ ](?= {2,}\n)))/,D$2=/[\p{P}\p{S}]/u,W$2=/[\s\p{P}\p{S}]/u,ue$1=/[^\s\p{P}\p{S}]/u,Ce$1=d$2(/^((?![*_])punctSpace)/,"u").replace(/punctSpace/g,W$2).getRegex(),pe$1=/(?!~)[\p{P}\p{S}]/u,Be$1=/(?!~)[\s\p{P}\p{S}]/u,qe$1=/(?:[^\s\p{P}\p{S}]|~)/u,ve$1=d$2(/link|precode-code|html/,"g").replace("link",/\[(?:[^\[\]`]|(?<a>`+)[^`]+\k<a>(?!`))*?\]\((?:\\[\s\S]|[^\\\(\)]|\((?:\\[\s\S]|[^\\\(\)])*\))*\)/).replace("precode-",be$1?"(?<!`)()":"(^^|[^`])").replace("code",/(?<b>`+)[^`]+\k<b>(?!`)/).replace("html",/<(?! )[^<>]*?>/).getRegex(),ce$1=/^(?:\*+(?:((?!\*)punct)|[^\s*]))|^_+(?:((?!_)punct)|([^\s_]))/,De$1=d$2(ce$1,"u").replace(/punct/g,D$2).getRegex(),He$1=d$2(ce$1,"u").replace(/punct/g,pe$1).getRegex(),he$1="^[^_*]*?__[^_*]*?\\*[^_*]*?(?=__)|[^*]+(?=[^*])|(?!\\*)punct(\\*+)(?=[\\s]|$)|notPunctSpace(\\*+)(?!\\*)(?=punctSpace|$)|(?!\\*)punctSpace(\\*+)(?=notPunctSpace)|[\\s](\\*+)(?!\\*)(?=punct)|(?!\\*)punct(\\*+)(?!\\*)(?=punct)|notPunctSpace(\\*+)(?=notPunctSpace)",Ze$1=d$2(he$1,"gu").replace(/notPunctSpace/g,ue$1).replace(/punctSpace/g,W$2).replace(/punct/g,D$2).getRegex(),Ge$1=d$2(he$1,"gu").replace(/notPunctSpace/g,qe$1).replace(/punctSpace/g,Be$1).replace(/punct/g,pe$1).getRegex(),Ne$1=d$2("^[^_*]*?\\*\\*[^_*]*?_[^_*]*?(?=\\*\\*)|[^_]+(?=[^_])|(?!_)punct(_+)(?=[\\s]|$)|notPunctSpace(_+)(?!_)(?=punctSpace|$)|(?!_)punctSpace(_+)(?=notPunctSpace)|[\\s](_+)(?!_)(?=punct)|(?!_)punct(_+)(?!_)(?=punct)","gu").replace(/notPunctSpace/g,ue$1).replace(/punctSpace/g,W$2).replace(/punct/g,D$2).getRegex(),Fe$1=d$2(/\\(punct)/,"gu").replace(/punct/g,D$2).getRegex(),je$1=d$2(/^<(scheme:[^\s\x00-\x1f<>]*|email)>/).replace("scheme",/[a-zA-Z][a-zA-Z0-9+.-]{1,31}/).replace("email",/[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+(@)[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+(?![-_])/).getRegex(),Qe$1=d$2(U$2).replace("(?:-->|$)","-->").getRegex(),Ue$1=d$2("^comment|^</[a-zA-Z][\\w:-]*\\s*>|^<[a-zA-Z][\\w-]*(?:attribute)*?\\s*/?>|^<\\?[\\s\\S]*?\\?>|^<![a-zA-Z]+\\s[\\s\\S]*?>|^<!\\[CDATA\\[[\\s\\S]*?\\]\\]>").replace("comment",Qe$1).replace("attribute",/\s+[a-zA-Z:_][\w.:-]*(?:\s*=\s*"[^"]*"|\s*=\s*'[^']*'|\s*=\s*[^\s"'=<>`]+)?/).getRegex(),q$2=/(?:\[(?:\\[\s\S]|[^\[\]\\])*\]|\\[\s\S]|`+[^`]*?`+(?!`)|[^\[\]\\`])*?/,Ke=d$2(/^!?\[(label)\]\(\s*(href)(?:(?:[ \t]*(?:\n[ \t]*)?)(title))?\s*\)/).replace("label",q$2).replace("href",/<(?:\\.|[^\n<>\\])+>|[^ \t\n\x00-\x1f]*/).replace("title",/"(?:\\"?|[^"\\])*"|'(?:\\'?|[^'\\])*'|\((?:\\\)?|[^)\\])*\)/).getRegex(),de$1=d$2(/^!?\[(label)\]\[(ref)\]/).replace("label",q$2).replace("ref",Q$2).getRegex(),ke$1=d$2(/^!?\[(ref)\](?:\[\])?/).replace("ref",Q$2).getRegex(),We$1=d$2("reflink|nolink(?!\\()","g").replace("reflink",de$1).replace("nolink",ke$1).getRegex(),se$1=/[hH][tT][tT][pP][sS]?|[fF][tT][pP]/,X$2={_backpedal:E$2,anyPunctuation:Fe$1,autolink:je$1,blockSkip:ve$1,br:le$1,code:Ee$1,del:E$2,emStrongLDelim:De$1,emStrongRDelimAst:Ze$1,emStrongRDelimUnd:Ne$1,escape:Ae$1,link:Ke,nolink:ke$1,punctuation:Ce$1,reflink:de$1,reflinkSearch:We$1,tag:Ue$1,text:Ie$1,url:E$2},Xe={...X$2,link:d$2(/^!?\[(label)\]\((.*?)\)/).replace("label",q$2).getRegex(),reflink:d$2(/^!?\[(label)\]\s*\[([^\]]*)\]/).replace("label",q$2).getRegex()},N$2={...X$2,emStrongRDelimAst:Ge$1,emStrongLDelim:He$1,url:d$2(/^((?:protocol):\/\/|www\.)(?:[a-zA-Z0-9\-]+\.?)+[^\s<]*|^email/).replace("protocol",se$1).replace("email",/[A-Za-z0-9._+-]+(@)[a-zA-Z0-9-_]+(?:\.[a-zA-Z0-9-_]*[a-zA-Z0-9])+(?![-_])/).getRegex(),_backpedal:/(?:[^?!.,:;*_'"~()&]+|\([^)]*\)|&(?![a-zA-Z0-9]+;$)|[?!.,:;*_'"~)]+(?!$))+/,del:/^(~~?)(?=[^\s~])((?:\\[\s\S]|[^\\])*?(?:\\[\s\S]|[^\s~\\]))\1(?=[^~]|$)/,text:d$2(/^([`~]+|[^`~])(?:(?= {2,}\n)|(?=[a-zA-Z0-9.!#$%&'*+\/=?_`{\|}~-]+@)|[\s\S]*?(?:(?=[\\<!\[`*~_]|\b_|protocol:\/\/|www\.|$)|[^ ](?= {2,}\n)|[^a-zA-Z0-9.!#$%&'*+\/=?_`{\|}~-](?=[a-zA-Z0-9.!#$%&'*+\/=?_`{\|}~-]+@)))/).replace("protocol",se$1).getRegex()},Je={...N$2,br:d$2(le$1).replace("{2,}","*").getRegex(),text:d$2(N$2.text).replace("\\b_","\\b_| {2,}\\n").replace(/\{2,\}/g,"*").getRegex()},C$2={normal:K$2,gfm:Me$1,pedantic:ze$1},M$2={normal:X$2,gfm:N$2,breaks:Je,pedantic:Xe},Ve$1={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"},ge$1=rt=>Ve$1[rt];function w$2(rt,it){if(it){if(m$2.escapeTest.test(rt))return rt.replace(m$2.escapeReplace,ge$1)}else if(m$2.escapeTestNoEncode.test(rt))return rt.replace(m$2.escapeReplaceNoEncode,ge$1);return rt}function J$2(rt){try{rt=encodeURI(rt).replace(m$2.percentDecode,"%")}catch{return null}return rt}function V$2(rt,it){let ct=rt.replace(m$2.findPipe,(pt,yt,ft)=>{let mt=!1,kt=yt;for(;--kt>=0&&ft[kt]==="\\";)mt=!mt;return mt?"|":" |"}),dt=ct.split(m$2.splitPipe),ut=0;if(dt[0].trim()||dt.shift(),dt.length>0&&!dt.at(-1)?.trim()&&dt.pop(),it)if(dt.length>it)dt.splice(it);else for(;dt.length<it;)dt.push("");for(;ut<dt.length;ut++)dt[ut]=dt[ut].trim().replace(m$2.slashPipe,"|");return dt}function z$2(rt,it,ct){let dt=rt.length;if(dt===0)return"";let ut=0;for(;ut<dt&&rt.charAt(dt-ut-1)===it;)ut++;return rt.slice(0,dt-ut)}function fe$1(rt,it){if(rt.indexOf(it[1])===-1)return-1;let ct=0;for(let dt=0;dt<rt.length;dt++)if(rt[dt]==="\\")dt++;else if(rt[dt]===it[0])ct++;else if(rt[dt]===it[1]&&(ct--,ct<0))return dt;return ct>0?-2:-1}function me$1(rt,it,ct,dt,ut){let pt=it.href,yt=it.title||null,ft=rt[1].replace(ut.other.outputLinkReplace,"$1");dt.state.inLink=!0;let mt={type:rt[0].charAt(0)==="!"?"image":"link",raw:ct,href:pt,title:yt,text:ft,tokens:dt.inlineTokens(ft)};return dt.state.inLink=!1,mt}function Ye(rt,it,ct){let dt=rt.match(ct.other.indentCodeCompensation);if(dt===null)return it;let ut=dt[1];return it.split(`
-`).map(pt=>{let yt=pt.match(ct.other.beginningSpace);if(yt===null)return pt;let[ft]=yt;return ft.length>=ut.length?pt.slice(ut.length):pt}).join(`
-`)}var y$2=class{options;rules;lexer;constructor(it){this.options=it||T$2}space(it){let ct=this.rules.block.newline.exec(it);if(ct&&ct[0].length>0)return{type:"space",raw:ct[0]}}code(it){let ct=this.rules.block.code.exec(it);if(ct){let dt=ct[0].replace(this.rules.other.codeRemoveIndent,"");return{type:"code",raw:ct[0],codeBlockStyle:"indented",text:this.options.pedantic?dt:z$2(dt,`
-`)}}}fences(it){let ct=this.rules.block.fences.exec(it);if(ct){let dt=ct[0],ut=Ye(dt,ct[3]||"",this.rules);return{type:"code",raw:dt,lang:ct[2]?ct[2].trim().replace(this.rules.inline.anyPunctuation,"$1"):ct[2],text:ut}}}heading(it){let ct=this.rules.block.heading.exec(it);if(ct){let dt=ct[2].trim();if(this.rules.other.endingHash.test(dt)){let ut=z$2(dt,"#");(this.options.pedantic||!ut||this.rules.other.endingSpaceChar.test(ut))&&(dt=ut.trim())}return{type:"heading",raw:ct[0],depth:ct[1].length,text:dt,tokens:this.lexer.inline(dt)}}}hr(it){let ct=this.rules.block.hr.exec(it);if(ct)return{type:"hr",raw:z$2(ct[0],`
-`)}}blockquote(it){let ct=this.rules.block.blockquote.exec(it);if(ct){let dt=z$2(ct[0],`
-`).split(`
-`),ut="",pt="",yt=[];for(;dt.length>0;){let ft=!1,mt=[],kt;for(kt=0;kt<dt.length;kt++)if(this.rules.other.blockquoteStart.test(dt[kt]))mt.push(dt[kt]),ft=!0;else if(!ft)mt.push(dt[kt]);else break;dt=dt.slice(kt);let _t=mt.join(`
-`),vt=_t.replace(this.rules.other.blockquoteSetextReplace,`
-    $1`).replace(this.rules.other.blockquoteSetextReplace2,"");ut=ut?`${ut}
-${_t}`:_t,pt=pt?`${pt}
-${vt}`:vt;let bt=this.lexer.state.top;if(this.lexer.state.top=!0,this.lexer.blockTokens(vt,yt,!0),this.lexer.state.top=bt,dt.length===0)break;let Mt=yt.at(-1);if(Mt?.type==="code")break;if(Mt?.type==="blockquote"){let wt=Mt,St=wt.raw+`
-`+dt.join(`
-`),It=this.blockquote(St);yt[yt.length-1]=It,ut=ut.substring(0,ut.length-wt.raw.length)+It.raw,pt=pt.substring(0,pt.length-wt.text.length)+It.text;break}else if(Mt?.type==="list"){let wt=Mt,St=wt.raw+`
-`+dt.join(`
-`),It=this.list(St);yt[yt.length-1]=It,ut=ut.substring(0,ut.length-Mt.raw.length)+It.raw,pt=pt.substring(0,pt.length-wt.raw.length)+It.raw,dt=St.substring(yt.at(-1).raw.length).split(`
-`);continue}}return{type:"blockquote",raw:ut,tokens:yt,text:pt}}}list(it){let ct=this.rules.block.list.exec(it);if(ct){let dt=ct[1].trim(),ut=dt.length>1,pt={type:"list",raw:"",ordered:ut,start:ut?+dt.slice(0,-1):"",loose:!1,items:[]};dt=ut?`\\d{1,9}\\${dt.slice(-1)}`:`\\${dt}`,this.options.pedantic&&(dt=ut?dt:"[*+-]");let yt=this.rules.other.listItemRegex(dt),ft=!1;for(;it;){let kt=!1,_t="",vt="";if(!(ct=yt.exec(it))||this.rules.block.hr.test(it))break;_t=ct[0],it=it.substring(_t.length);let bt=ct[2].split(`
-`,1)[0].replace(this.rules.other.listReplaceTabs,$t=>" ".repeat(3*$t.length)),Mt=it.split(`
-`,1)[0],wt=!bt.trim(),St=0;if(this.options.pedantic?(St=2,vt=bt.trimStart()):wt?St=ct[1].length+1:(St=ct[2].search(this.rules.other.nonSpaceChar),St=St>4?1:St,vt=bt.slice(St),St+=ct[1].length),wt&&this.rules.other.blankLine.test(Mt)&&(_t+=Mt+`
-`,it=it.substring(Mt.length+1),kt=!0),!kt){let $t=this.rules.other.nextBulletRegex(St),Et=this.rules.other.hrRegex(St),Ft=this.rules.other.fencesBeginRegex(St),qt=this.rules.other.headingBeginRegex(St),Ht=this.rules.other.htmlBeginRegex(St);for(;it;){let Ot=it.split(`
-`,1)[0],Zt;if(Mt=Ot,this.options.pedantic?(Mt=Mt.replace(this.rules.other.listReplaceNesting,"  "),Zt=Mt):Zt=Mt.replace(this.rules.other.tabCharGlobal,"    "),Ft.test(Mt)||qt.test(Mt)||Ht.test(Mt)||$t.test(Mt)||Et.test(Mt))break;if(Zt.search(this.rules.other.nonSpaceChar)>=St||!Mt.trim())vt+=`
-`+Zt.slice(St);else{if(wt||bt.replace(this.rules.other.tabCharGlobal,"    ").search(this.rules.other.nonSpaceChar)>=4||Ft.test(bt)||qt.test(bt)||Et.test(bt))break;vt+=`
-`+Mt}!wt&&!Mt.trim()&&(wt=!0),_t+=Ot+`
-`,it=it.substring(Ot.length+1),bt=Zt.slice(St)}}pt.loose||(ft?pt.loose=!0:this.rules.other.doubleBlankLine.test(_t)&&(ft=!0));let It=null,Nt;this.options.gfm&&(It=this.rules.other.listIsTask.exec(vt),It&&(Nt=It[0]!=="[ ] ",vt=vt.replace(this.rules.other.listReplaceTask,""))),pt.items.push({type:"list_item",raw:_t,task:!!It,checked:Nt,loose:!1,text:vt,tokens:[]}),pt.raw+=_t}let mt=pt.items.at(-1);if(mt)mt.raw=mt.raw.trimEnd(),mt.text=mt.text.trimEnd();else return;pt.raw=pt.raw.trimEnd();for(let kt=0;kt<pt.items.length;kt++)if(this.lexer.state.top=!1,pt.items[kt].tokens=this.lexer.blockTokens(pt.items[kt].text,[]),!pt.loose){let _t=pt.items[kt].tokens.filter(bt=>bt.type==="space"),vt=_t.length>0&&_t.some(bt=>this.rules.other.anyLine.test(bt.raw));pt.loose=vt}if(pt.loose)for(let kt=0;kt<pt.items.length;kt++)pt.items[kt].loose=!0;return pt}}html(it){let ct=this.rules.block.html.exec(it);if(ct)return{type:"html",block:!0,raw:ct[0],pre:ct[1]==="pre"||ct[1]==="script"||ct[1]==="style",text:ct[0]}}def(it){let ct=this.rules.block.def.exec(it);if(ct){let dt=ct[1].toLowerCase().replace(this.rules.other.multipleSpaceGlobal," "),ut=ct[2]?ct[2].replace(this.rules.other.hrefBrackets,"$1").replace(this.rules.inline.anyPunctuation,"$1"):"",pt=ct[3]?ct[3].substring(1,ct[3].length-1).replace(this.rules.inline.anyPunctuation,"$1"):ct[3];return{type:"def",tag:dt,raw:ct[0],href:ut,title:pt}}}table(it){let ct=this.rules.block.table.exec(it);if(!ct||!this.rules.other.tableDelimiter.test(ct[2]))return;let dt=V$2(ct[1]),ut=ct[2].replace(this.rules.other.tableAlignChars,"").split("|"),pt=ct[3]?.trim()?ct[3].replace(this.rules.other.tableRowBlankLine,"").split(`
-`):[],yt={type:"table",raw:ct[0],header:[],align:[],rows:[]};if(dt.length===ut.length){for(let ft of ut)this.rules.other.tableAlignRight.test(ft)?yt.align.push("right"):this.rules.other.tableAlignCenter.test(ft)?yt.align.push("center"):this.rules.other.tableAlignLeft.test(ft)?yt.align.push("left"):yt.align.push(null);for(let ft=0;ft<dt.length;ft++)yt.header.push({text:dt[ft],tokens:this.lexer.inline(dt[ft]),header:!0,align:yt.align[ft]});for(let ft of pt)yt.rows.push(V$2(ft,yt.header.length).map((mt,kt)=>({text:mt,tokens:this.lexer.inline(mt),header:!1,align:yt.align[kt]})));return yt}}lheading(it){let ct=this.rules.block.lheading.exec(it);if(ct)return{type:"heading",raw:ct[0],depth:ct[2].charAt(0)==="="?1:2,text:ct[1],tokens:this.lexer.inline(ct[1])}}paragraph(it){let ct=this.rules.block.paragraph.exec(it);if(ct){let dt=ct[1].charAt(ct[1].length-1)===`
-`?ct[1].slice(0,-1):ct[1];return{type:"paragraph",raw:ct[0],text:dt,tokens:this.lexer.inline(dt)}}}text(it){let ct=this.rules.block.text.exec(it);if(ct)return{type:"text",raw:ct[0],text:ct[0],tokens:this.lexer.inline(ct[0])}}escape(it){let ct=this.rules.inline.escape.exec(it);if(ct)return{type:"escape",raw:ct[0],text:ct[1]}}tag(it){let ct=this.rules.inline.tag.exec(it);if(ct)return!this.lexer.state.inLink&&this.rules.other.startATag.test(ct[0])?this.lexer.state.inLink=!0:this.lexer.state.inLink&&this.rules.other.endATag.test(ct[0])&&(this.lexer.state.inLink=!1),!this.lexer.state.inRawBlock&&this.rules.other.startPreScriptTag.test(ct[0])?this.lexer.state.inRawBlock=!0:this.lexer.state.inRawBlock&&this.rules.other.endPreScriptTag.test(ct[0])&&(this.lexer.state.inRawBlock=!1),{type:"html",raw:ct[0],inLink:this.lexer.state.inLink,inRawBlock:this.lexer.state.inRawBlock,block:!1,text:ct[0]}}link(it){let ct=this.rules.inline.link.exec(it);if(ct){let dt=ct[2].trim();if(!this.options.pedantic&&this.rules.other.startAngleBracket.test(dt)){if(!this.rules.other.endAngleBracket.test(dt))return;let yt=z$2(dt.slice(0,-1),"\\");if((dt.length-yt.length)%2===0)return}else{let yt=fe$1(ct[2],"()");if(yt===-2)return;if(yt>-1){let ft=(ct[0].indexOf("!")===0?5:4)+ct[1].length+yt;ct[2]=ct[2].substring(0,yt),ct[0]=ct[0].substring(0,ft).trim(),ct[3]=""}}let ut=ct[2],pt="";if(this.options.pedantic){let yt=this.rules.other.pedanticHrefTitle.exec(ut);yt&&(ut=yt[1],pt=yt[3])}else pt=ct[3]?ct[3].slice(1,-1):"";return ut=ut.trim(),this.rules.other.startAngleBracket.test(ut)&&(this.options.pedantic&&!this.rules.other.endAngleBracket.test(dt)?ut=ut.slice(1):ut=ut.slice(1,-1)),me$1(ct,{href:ut&&ut.replace(this.rules.inline.anyPunctuation,"$1"),title:pt&&pt.replace(this.rules.inline.anyPunctuation,"$1")},ct[0],this.lexer,this.rules)}}reflink(it,ct){let dt;if((dt=this.rules.inline.reflink.exec(it))||(dt=this.rules.inline.nolink.exec(it))){let ut=(dt[2]||dt[1]).replace(this.rules.other.multipleSpaceGlobal," "),pt=ct[ut.toLowerCase()];if(!pt){let yt=dt[0].charAt(0);return{type:"text",raw:yt,text:yt}}return me$1(dt,pt,dt[0],this.lexer,this.rules)}}emStrong(it,ct,dt=""){let ut=this.rules.inline.emStrongLDelim.exec(it);if(!(!ut||ut[3]&&dt.match(this.rules.other.unicodeAlphaNumeric))&&(!(ut[1]||ut[2])||!dt||this.rules.inline.punctuation.exec(dt))){let pt=[...ut[0]].length-1,yt,ft,mt=pt,kt=0,_t=ut[0][0]==="*"?this.rules.inline.emStrongRDelimAst:this.rules.inline.emStrongRDelimUnd;for(_t.lastIndex=0,ct=ct.slice(-1*it.length+pt);(ut=_t.exec(ct))!=null;){if(yt=ut[1]||ut[2]||ut[3]||ut[4]||ut[5]||ut[6],!yt)continue;if(ft=[...yt].length,ut[3]||ut[4]){mt+=ft;continue}else if((ut[5]||ut[6])&&pt%3&&!((pt+ft)%3)){kt+=ft;continue}if(mt-=ft,mt>0)continue;ft=Math.min(ft,ft+mt+kt);let vt=[...ut[0]][0].length,bt=it.slice(0,pt+ut.index+vt+ft);if(Math.min(pt,ft)%2){let wt=bt.slice(1,-1);return{type:"em",raw:bt,text:wt,tokens:this.lexer.inlineTokens(wt)}}let Mt=bt.slice(2,-2);return{type:"strong",raw:bt,text:Mt,tokens:this.lexer.inlineTokens(Mt)}}}}codespan(it){let ct=this.rules.inline.code.exec(it);if(ct){let dt=ct[2].replace(this.rules.other.newLineCharGlobal," "),ut=this.rules.other.nonSpaceChar.test(dt),pt=this.rules.other.startingSpaceChar.test(dt)&&this.rules.other.endingSpaceChar.test(dt);return ut&&pt&&(dt=dt.substring(1,dt.length-1)),{type:"codespan",raw:ct[0],text:dt}}}br(it){let ct=this.rules.inline.br.exec(it);if(ct)return{type:"br",raw:ct[0]}}del(it){let ct=this.rules.inline.del.exec(it);if(ct)return{type:"del",raw:ct[0],text:ct[2],tokens:this.lexer.inlineTokens(ct[2])}}autolink(it){let ct=this.rules.inline.autolink.exec(it);if(ct){let dt,ut;return ct[2]==="@"?(dt=ct[1],ut="mailto:"+dt):(dt=ct[1],ut=dt),{type:"link",raw:ct[0],text:dt,href:ut,tokens:[{type:"text",raw:dt,text:dt}]}}}url(it){let ct;if(ct=this.rules.inline.url.exec(it)){let dt,ut;if(ct[2]==="@")dt=ct[0],ut="mailto:"+dt;else{let pt;do pt=ct[0],ct[0]=this.rules.inline._backpedal.exec(ct[0])?.[0]??"";while(pt!==ct[0]);dt=ct[0],ct[1]==="www."?ut="http://"+ct[0]:ut=ct[0]}return{type:"link",raw:ct[0],text:dt,href:ut,tokens:[{type:"text",raw:dt,text:dt}]}}}inlineText(it){let ct=this.rules.inline.text.exec(it);if(ct){let dt=this.lexer.state.inRawBlock;return{type:"text",raw:ct[0],text:ct[0],escaped:dt}}}},x$2=class Y1{tokens;options;state;tokenizer;inlineQueue;constructor(it){this.tokens=[],this.tokens.links=Object.create(null),this.options=it||T$2,this.options.tokenizer=this.options.tokenizer||new y$2,this.tokenizer=this.options.tokenizer,this.tokenizer.options=this.options,this.tokenizer.lexer=this,this.inlineQueue=[],this.state={inLink:!1,inRawBlock:!1,top:!0};let ct={other:m$2,block:C$2.normal,inline:M$2.normal};this.options.pedantic?(ct.block=C$2.pedantic,ct.inline=M$2.pedantic):this.options.gfm&&(ct.block=C$2.gfm,this.options.breaks?ct.inline=M$2.breaks:ct.inline=M$2.gfm),this.tokenizer.rules=ct}static get rules(){return{block:C$2,inline:M$2}}static lex(it,ct){return new Y1(ct).lex(it)}static lexInline(it,ct){return new Y1(ct).inlineTokens(it)}lex(it){it=it.replace(m$2.carriageReturn,`
-`),this.blockTokens(it,this.tokens);for(let ct=0;ct<this.inlineQueue.length;ct++){let dt=this.inlineQueue[ct];this.inlineTokens(dt.src,dt.tokens)}return this.inlineQueue=[],this.tokens}blockTokens(it,ct=[],dt=!1){for(this.options.pedantic&&(it=it.replace(m$2.tabCharGlobal,"    ").replace(m$2.spaceLine,""));it;){let ut;if(this.options.extensions?.block?.some(yt=>(ut=yt.call({lexer:this},it,ct))?(it=it.substring(ut.raw.length),ct.push(ut),!0):!1))continue;if(ut=this.tokenizer.space(it)){it=it.substring(ut.raw.length);let yt=ct.at(-1);ut.raw.length===1&&yt!==void 0?yt.raw+=`
-`:ct.push(ut);continue}if(ut=this.tokenizer.code(it)){it=it.substring(ut.raw.length);let yt=ct.at(-1);yt?.type==="paragraph"||yt?.type==="text"?(yt.raw+=(yt.raw.endsWith(`
-`)?"":`
-`)+ut.raw,yt.text+=`
-`+ut.text,this.inlineQueue.at(-1).src=yt.text):ct.push(ut);continue}if(ut=this.tokenizer.fences(it)){it=it.substring(ut.raw.length),ct.push(ut);continue}if(ut=this.tokenizer.heading(it)){it=it.substring(ut.raw.length),ct.push(ut);continue}if(ut=this.tokenizer.hr(it)){it=it.substring(ut.raw.length),ct.push(ut);continue}if(ut=this.tokenizer.blockquote(it)){it=it.substring(ut.raw.length),ct.push(ut);continue}if(ut=this.tokenizer.list(it)){it=it.substring(ut.raw.length),ct.push(ut);continue}if(ut=this.tokenizer.html(it)){it=it.substring(ut.raw.length),ct.push(ut);continue}if(ut=this.tokenizer.def(it)){it=it.substring(ut.raw.length);let yt=ct.at(-1);yt?.type==="paragraph"||yt?.type==="text"?(yt.raw+=(yt.raw.endsWith(`
-`)?"":`
-`)+ut.raw,yt.text+=`
-`+ut.raw,this.inlineQueue.at(-1).src=yt.text):this.tokens.links[ut.tag]||(this.tokens.links[ut.tag]={href:ut.href,title:ut.title},ct.push(ut));continue}if(ut=this.tokenizer.table(it)){it=it.substring(ut.raw.length),ct.push(ut);continue}if(ut=this.tokenizer.lheading(it)){it=it.substring(ut.raw.length),ct.push(ut);continue}let pt=it;if(this.options.extensions?.startBlock){let yt=1/0,ft=it.slice(1),mt;this.options.extensions.startBlock.forEach(kt=>{mt=kt.call({lexer:this},ft),typeof mt=="number"&&mt>=0&&(yt=Math.min(yt,mt))}),yt<1/0&&yt>=0&&(pt=it.substring(0,yt+1))}if(this.state.top&&(ut=this.tokenizer.paragraph(pt))){let yt=ct.at(-1);dt&&yt?.type==="paragraph"?(yt.raw+=(yt.raw.endsWith(`
-`)?"":`
-`)+ut.raw,yt.text+=`
-`+ut.text,this.inlineQueue.pop(),this.inlineQueue.at(-1).src=yt.text):ct.push(ut),dt=pt.length!==it.length,it=it.substring(ut.raw.length);continue}if(ut=this.tokenizer.text(it)){it=it.substring(ut.raw.length);let yt=ct.at(-1);yt?.type==="text"?(yt.raw+=(yt.raw.endsWith(`
-`)?"":`
-`)+ut.raw,yt.text+=`
-`+ut.text,this.inlineQueue.pop(),this.inlineQueue.at(-1).src=yt.text):ct.push(ut);continue}if(it){let yt="Infinite loop on byte: "+it.charCodeAt(0);if(this.options.silent){console.error(yt);break}else throw new Error(yt)}}return this.state.top=!0,ct}inline(it,ct=[]){return this.inlineQueue.push({src:it,tokens:ct}),ct}inlineTokens(it,ct=[]){let dt=it,ut=null;if(this.tokens.links){let mt=Object.keys(this.tokens.links);if(mt.length>0)for(;(ut=this.tokenizer.rules.inline.reflinkSearch.exec(dt))!=null;)mt.includes(ut[0].slice(ut[0].lastIndexOf("[")+1,-1))&&(dt=dt.slice(0,ut.index)+"["+"a".repeat(ut[0].length-2)+"]"+dt.slice(this.tokenizer.rules.inline.reflinkSearch.lastIndex))}for(;(ut=this.tokenizer.rules.inline.anyPunctuation.exec(dt))!=null;)dt=dt.slice(0,ut.index)+"++"+dt.slice(this.tokenizer.rules.inline.anyPunctuation.lastIndex);let pt;for(;(ut=this.tokenizer.rules.inline.blockSkip.exec(dt))!=null;)pt=ut[2]?ut[2].length:0,dt=dt.slice(0,ut.index+pt)+"["+"a".repeat(ut[0].length-pt-2)+"]"+dt.slice(this.tokenizer.rules.inline.blockSkip.lastIndex);dt=this.options.hooks?.emStrongMask?.call({lexer:this},dt)??dt;let yt=!1,ft="";for(;it;){yt||(ft=""),yt=!1;let mt;if(this.options.extensions?.inline?.some(_t=>(mt=_t.call({lexer:this},it,ct))?(it=it.substring(mt.raw.length),ct.push(mt),!0):!1))continue;if(mt=this.tokenizer.escape(it)){it=it.substring(mt.raw.length),ct.push(mt);continue}if(mt=this.tokenizer.tag(it)){it=it.substring(mt.raw.length),ct.push(mt);continue}if(mt=this.tokenizer.link(it)){it=it.substring(mt.raw.length),ct.push(mt);continue}if(mt=this.tokenizer.reflink(it,this.tokens.links)){it=it.substring(mt.raw.length);let _t=ct.at(-1);mt.type==="text"&&_t?.type==="text"?(_t.raw+=mt.raw,_t.text+=mt.text):ct.push(mt);continue}if(mt=this.tokenizer.emStrong(it,dt,ft)){it=it.substring(mt.raw.length),ct.push(mt);continue}if(mt=this.tokenizer.codespan(it)){it=it.substring(mt.raw.length),ct.push(mt);continue}if(mt=this.tokenizer.br(it)){it=it.substring(mt.raw.length),ct.push(mt);continue}if(mt=this.tokenizer.del(it)){it=it.substring(mt.raw.length),ct.push(mt);continue}if(mt=this.tokenizer.autolink(it)){it=it.substring(mt.raw.length),ct.push(mt);continue}if(!this.state.inLink&&(mt=this.tokenizer.url(it))){it=it.substring(mt.raw.length),ct.push(mt);continue}let kt=it;if(this.options.extensions?.startInline){let _t=1/0,vt=it.slice(1),bt;this.options.extensions.startInline.forEach(Mt=>{bt=Mt.call({lexer:this},vt),typeof bt=="number"&&bt>=0&&(_t=Math.min(_t,bt))}),_t<1/0&&_t>=0&&(kt=it.substring(0,_t+1))}if(mt=this.tokenizer.inlineText(kt)){it=it.substring(mt.raw.length),mt.raw.slice(-1)!=="_"&&(ft=mt.raw.slice(-1)),yt=!0;let _t=ct.at(-1);_t?.type==="text"?(_t.raw+=mt.raw,_t.text+=mt.text):ct.push(mt);continue}if(it){let _t="Infinite loop on byte: "+it.charCodeAt(0);if(this.options.silent){console.error(_t);break}else throw new Error(_t)}}return ct}},P$2=class{options;parser;constructor(it){this.options=it||T$2}space(it){return""}code({text:it,lang:ct,escaped:dt}){let ut=(ct||"").match(m$2.notSpaceStart)?.[0],pt=it.replace(m$2.endingNewline,"")+`
-`;return ut?'<pre><code class="language-'+w$2(ut)+'">'+(dt?pt:w$2(pt,!0))+`</code></pre>
-`:"<pre><code>"+(dt?pt:w$2(pt,!0))+`</code></pre>
-`}blockquote({tokens:it}){return`<blockquote>
-${this.parser.parse(it)}</blockquote>
-`}html({text:it}){return it}def(it){return""}heading({tokens:it,depth:ct}){return`<h${ct}>${this.parser.parseInline(it)}</h${ct}>
-`}hr(it){return`<hr>
-`}list(it){let ct=it.ordered,dt=it.start,ut="";for(let ft=0;ft<it.items.length;ft++){let mt=it.items[ft];ut+=this.listitem(mt)}let pt=ct?"ol":"ul",yt=ct&&dt!==1?' start="'+dt+'"':"";return"<"+pt+yt+`>
-`+ut+"</"+pt+`>
-`}listitem(it){let ct="";if(it.task){let dt=this.checkbox({checked:!!it.checked});it.loose?it.tokens[0]?.type==="paragraph"?(it.tokens[0].text=dt+" "+it.tokens[0].text,it.tokens[0].tokens&&it.tokens[0].tokens.length>0&&it.tokens[0].tokens[0].type==="text"&&(it.tokens[0].tokens[0].text=dt+" "+w$2(it.tokens[0].tokens[0].text),it.tokens[0].tokens[0].escaped=!0)):it.tokens.unshift({type:"text",raw:dt+" ",text:dt+" ",escaped:!0}):ct+=dt+" "}return ct+=this.parser.parse(it.tokens,!!it.loose),`<li>${ct}</li>
-`}checkbox({checked:it}){return"<input "+(it?'checked="" ':"")+'disabled="" type="checkbox">'}paragraph({tokens:it}){return`<p>${this.parser.parseInline(it)}</p>
-`}table(it){let ct="",dt="";for(let pt=0;pt<it.header.length;pt++)dt+=this.tablecell(it.header[pt]);ct+=this.tablerow({text:dt});let ut="";for(let pt=0;pt<it.rows.length;pt++){let yt=it.rows[pt];dt="";for(let ft=0;ft<yt.length;ft++)dt+=this.tablecell(yt[ft]);ut+=this.tablerow({text:dt})}return ut&&(ut=`<tbody>${ut}</tbody>`),`<table>
-<thead>
-`+ct+`</thead>
-`+ut+`</table>
-`}tablerow({text:it}){return`<tr>
-${it}</tr>
-`}tablecell(it){let ct=this.parser.parseInline(it.tokens),dt=it.header?"th":"td";return(it.align?`<${dt} align="${it.align}">`:`<${dt}>`)+ct+`</${dt}>
-`}strong({tokens:it}){return`<strong>${this.parser.parseInline(it)}</strong>`}em({tokens:it}){return`<em>${this.parser.parseInline(it)}</em>`}codespan({text:it}){return`<code>${w$2(it,!0)}</code>`}br(it){return"<br>"}del({tokens:it}){return`<del>${this.parser.parseInline(it)}</del>`}link({href:it,title:ct,tokens:dt}){let ut=this.parser.parseInline(dt),pt=J$2(it);if(pt===null)return ut;it=pt;let yt='<a href="'+it+'"';return ct&&(yt+=' title="'+w$2(ct)+'"'),yt+=">"+ut+"</a>",yt}image({href:it,title:ct,text:dt,tokens:ut}){ut&&(dt=this.parser.parseInline(ut,this.parser.textRenderer));let pt=J$2(it);if(pt===null)return w$2(dt);it=pt;let yt=`<img src="${it}" alt="${dt}"`;return ct&&(yt+=` title="${w$2(ct)}"`),yt+=">",yt}text(it){return"tokens"in it&&it.tokens?this.parser.parseInline(it.tokens):"escaped"in it&&it.escaped?it.text:w$2(it.text)}},$$2=class{strong({text:it}){return it}em({text:it}){return it}codespan({text:it}){return it}del({text:it}){return it}html({text:it}){return it}text({text:it}){return it}link({text:it}){return""+it}image({text:it}){return""+it}br(){return""}},b$2=class X1{options;renderer;textRenderer;constructor(it){this.options=it||T$2,this.options.renderer=this.options.renderer||new P$2,this.renderer=this.options.renderer,this.renderer.options=this.options,this.renderer.parser=this,this.textRenderer=new $$2}static parse(it,ct){return new X1(ct).parse(it)}static parseInline(it,ct){return new X1(ct).parseInline(it)}parse(it,ct=!0){let dt="";for(let ut=0;ut<it.length;ut++){let pt=it[ut];if(this.options.extensions?.renderers?.[pt.type]){let ft=pt,mt=this.options.extensions.renderers[ft.type].call({parser:this},ft);if(mt!==!1||!["space","hr","heading","code","table","blockquote","list","html","def","paragraph","text"].includes(ft.type)){dt+=mt||"";continue}}let yt=pt;switch(yt.type){case"space":{dt+=this.renderer.space(yt);continue}case"hr":{dt+=this.renderer.hr(yt);continue}case"heading":{dt+=this.renderer.heading(yt);continue}case"code":{dt+=this.renderer.code(yt);continue}case"table":{dt+=this.renderer.table(yt);continue}case"blockquote":{dt+=this.renderer.blockquote(yt);continue}case"list":{dt+=this.renderer.list(yt);continue}case"html":{dt+=this.renderer.html(yt);continue}case"def":{dt+=this.renderer.def(yt);continue}case"paragraph":{dt+=this.renderer.paragraph(yt);continue}case"text":{let ft=yt,mt=this.renderer.text(ft);for(;ut+1<it.length&&it[ut+1].type==="text";)ft=it[++ut],mt+=`
-`+this.renderer.text(ft);ct?dt+=this.renderer.paragraph({type:"paragraph",raw:mt,text:mt,tokens:[{type:"text",raw:mt,text:mt,escaped:!0}]}):dt+=mt;continue}default:{let ft='Token with "'+yt.type+'" type was not found.';if(this.options.silent)return console.error(ft),"";throw new Error(ft)}}}return dt}parseInline(it,ct=this.renderer){let dt="";for(let ut=0;ut<it.length;ut++){let pt=it[ut];if(this.options.extensions?.renderers?.[pt.type]){let ft=this.options.extensions.renderers[pt.type].call({parser:this},pt);if(ft!==!1||!["escape","html","link","image","strong","em","codespan","br","del","text"].includes(pt.type)){dt+=ft||"";continue}}let yt=pt;switch(yt.type){case"escape":{dt+=ct.text(yt);break}case"html":{dt+=ct.html(yt);break}case"link":{dt+=ct.link(yt);break}case"image":{dt+=ct.image(yt);break}case"strong":{dt+=ct.strong(yt);break}case"em":{dt+=ct.em(yt);break}case"codespan":{dt+=ct.codespan(yt);break}case"br":{dt+=ct.br(yt);break}case"del":{dt+=ct.del(yt);break}case"text":{dt+=ct.text(yt);break}default:{let ft='Token with "'+yt.type+'" type was not found.';if(this.options.silent)return console.error(ft),"";throw new Error(ft)}}}return dt}},S$2=class{options;block;constructor(it){this.options=it||T$2}static passThroughHooks=new Set(["preprocess","postprocess","processAllTokens","emStrongMask"]);static passThroughHooksRespectAsync=new Set(["preprocess","postprocess","processAllTokens"]);preprocess(it){return it}postprocess(it){return it}processAllTokens(it){return it}emStrongMask(it){return it}provideLexer(){return this.block?x$2.lex:x$2.lexInline}provideParser(){return this.block?b$2.parse:b$2.parseInline}},B$2=class{defaults=L$2();options=this.setOptions;parse=this.parseMarkdown(!0);parseInline=this.parseMarkdown(!1);Parser=b$2;Renderer=P$2;TextRenderer=$$2;Lexer=x$2;Tokenizer=y$2;Hooks=S$2;constructor(...it){this.use(...it)}walkTokens(it,ct){let dt=[];for(let ut of it)switch(dt=dt.concat(ct.call(this,ut)),ut.type){case"table":{let pt=ut;for(let yt of pt.header)dt=dt.concat(this.walkTokens(yt.tokens,ct));for(let yt of pt.rows)for(let ft of yt)dt=dt.concat(this.walkTokens(ft.tokens,ct));break}case"list":{let pt=ut;dt=dt.concat(this.walkTokens(pt.items,ct));break}default:{let pt=ut;this.defaults.extensions?.childTokens?.[pt.type]?this.defaults.extensions.childTokens[pt.type].forEach(yt=>{let ft=pt[yt].flat(1/0);dt=dt.concat(this.walkTokens(ft,ct))}):pt.tokens&&(dt=dt.concat(this.walkTokens(pt.tokens,ct)))}}return dt}use(...it){let ct=this.defaults.extensions||{renderers:{},childTokens:{}};return it.forEach(dt=>{let ut={...dt};if(ut.async=this.defaults.async||ut.async||!1,dt.extensions&&(dt.extensions.forEach(pt=>{if(!pt.name)throw new Error("extension name required");if("renderer"in pt){let yt=ct.renderers[pt.name];yt?ct.renderers[pt.name]=function(...ft){let mt=pt.renderer.apply(this,ft);return mt===!1&&(mt=yt.apply(this,ft)),mt}:ct.renderers[pt.name]=pt.renderer}if("tokenizer"in pt){if(!pt.level||pt.level!=="block"&&pt.level!=="inline")throw new Error("extension level must be 'block' or 'inline'");let yt=ct[pt.level];yt?yt.unshift(pt.tokenizer):ct[pt.level]=[pt.tokenizer],pt.start&&(pt.level==="block"?ct.startBlock?ct.startBlock.push(pt.start):ct.startBlock=[pt.start]:pt.level==="inline"&&(ct.startInline?ct.startInline.push(pt.start):ct.startInline=[pt.start]))}"childTokens"in pt&&pt.childTokens&&(ct.childTokens[pt.name]=pt.childTokens)}),ut.extensions=ct),dt.renderer){let pt=this.defaults.renderer||new P$2(this.defaults);for(let yt in dt.renderer){if(!(yt in pt))throw new Error(`renderer '${yt}' does not exist`);if(["options","parser"].includes(yt))continue;let ft=yt,mt=dt.renderer[ft],kt=pt[ft];pt[ft]=(..._t)=>{let vt=mt.apply(pt,_t);return vt===!1&&(vt=kt.apply(pt,_t)),vt||""}}ut.renderer=pt}if(dt.tokenizer){let pt=this.defaults.tokenizer||new y$2(this.defaults);for(let yt in dt.tokenizer){if(!(yt in pt))throw new Error(`tokenizer '${yt}' does not exist`);if(["options","rules","lexer"].includes(yt))continue;let ft=yt,mt=dt.tokenizer[ft],kt=pt[ft];pt[ft]=(..._t)=>{let vt=mt.apply(pt,_t);return vt===!1&&(vt=kt.apply(pt,_t)),vt}}ut.tokenizer=pt}if(dt.hooks){let pt=this.defaults.hooks||new S$2;for(let yt in dt.hooks){if(!(yt in pt))throw new Error(`hook '${yt}' does not exist`);if(["options","block"].includes(yt))continue;let ft=yt,mt=dt.hooks[ft],kt=pt[ft];S$2.passThroughHooks.has(yt)?pt[ft]=_t=>{if(this.defaults.async&&S$2.passThroughHooksRespectAsync.has(yt))return(async()=>{let bt=await mt.call(pt,_t);return kt.call(pt,bt)})();let vt=mt.call(pt,_t);return kt.call(pt,vt)}:pt[ft]=(..._t)=>{if(this.defaults.async)return(async()=>{let bt=await mt.apply(pt,_t);return bt===!1&&(bt=await kt.apply(pt,_t)),bt})();let vt=mt.apply(pt,_t);return vt===!1&&(vt=kt.apply(pt,_t)),vt}}ut.hooks=pt}if(dt.walkTokens){let pt=this.defaults.walkTokens,yt=dt.walkTokens;ut.walkTokens=function(ft){let mt=[];return mt.push(yt.call(this,ft)),pt&&(mt=mt.concat(pt.call(this,ft))),mt}}this.defaults={...this.defaults,...ut}}),this}setOptions(it){return this.defaults={...this.defaults,...it},this}lexer(it,ct){return x$2.lex(it,ct??this.defaults)}parser(it,ct){return b$2.parse(it,ct??this.defaults)}parseMarkdown(it){return(ct,dt)=>{let ut={...dt},pt={...this.defaults,...ut},yt=this.onError(!!pt.silent,!!pt.async);if(this.defaults.async===!0&&ut.async===!1)return yt(new Error("marked(): The async option was set to true by an extension. Remove async: false from the parse options object to return a Promise."));if(typeof ct>"u"||ct===null)return yt(new Error("marked(): input parameter is undefined or null"));if(typeof ct!="string")return yt(new Error("marked(): input parameter is of type "+Object.prototype.toString.call(ct)+", string expected"));if(pt.hooks&&(pt.hooks.options=pt,pt.hooks.block=it),pt.async)return(async()=>{let ft=pt.hooks?await pt.hooks.preprocess(ct):ct,mt=await(pt.hooks?await pt.hooks.provideLexer():it?x$2.lex:x$2.lexInline)(ft,pt),kt=pt.hooks?await pt.hooks.processAllTokens(mt):mt;pt.walkTokens&&await Promise.all(this.walkTokens(kt,pt.walkTokens));let _t=await(pt.hooks?await pt.hooks.provideParser():it?b$2.parse:b$2.parseInline)(kt,pt);return pt.hooks?await pt.hooks.postprocess(_t):_t})().catch(yt);try{pt.hooks&&(ct=pt.hooks.preprocess(ct));let ft=(pt.hooks?pt.hooks.provideLexer():it?x$2.lex:x$2.lexInline)(ct,pt);pt.hooks&&(ft=pt.hooks.processAllTokens(ft)),pt.walkTokens&&this.walkTokens(ft,pt.walkTokens);let mt=(pt.hooks?pt.hooks.provideParser():it?b$2.parse:b$2.parseInline)(ft,pt);return pt.hooks&&(mt=pt.hooks.postprocess(mt)),mt}catch(ft){return yt(ft)}}}onError(it,ct){return dt=>{if(dt.message+=`
-Please report this to https://github.com/markedjs/marked.`,it){let ut="<p>An error occurred:</p><pre>"+w$2(dt.message+"",!0)+"</pre>";return ct?Promise.resolve(ut):ut}if(ct)return Promise.reject(dt);throw dt}}},_$2=new B$2;function k$2(rt,it){return _$2.parse(rt,it)}k$2.options=k$2.setOptions=function(rt){return _$2.setOptions(rt),k$2.defaults=_$2.defaults,G$2(k$2.defaults),k$2};k$2.getDefaults=L$2;k$2.defaults=T$2;k$2.use=function(...rt){return _$2.use(...rt),k$2.defaults=_$2.defaults,G$2(k$2.defaults),k$2};k$2.walkTokens=function(rt,it){return _$2.walkTokens(rt,it)};k$2.parseInline=_$2.parseInline;k$2.Parser=b$2;k$2.parser=b$2.parse;k$2.Renderer=P$2;k$2.TextRenderer=$$2;k$2.Lexer=x$2;k$2.lexer=x$2.lex;k$2.Tokenizer=y$2;k$2.Hooks=S$2;k$2.parse=k$2;k$2.options;k$2.setOptions;k$2.use;k$2.walkTokens;k$2.parseInline;b$2.parse;x$2.lex;function dedent(rt){for(var it=[],ct=1;ct<arguments.length;ct++)it[ct-1]=arguments[ct];var dt=Array.from(typeof rt=="string"?[rt]:rt);dt[dt.length-1]=dt[dt.length-1].replace(/\r?\n([\t ]*)$/,"");var ut=dt.reduce(function(ft,mt){var kt=mt.match(/\n([\t ]+|(?!\s).)/g);return kt?ft.concat(kt.map(function(_t){var vt,bt;return(bt=(vt=_t.match(/[\t ]/g))===null||vt===void 0?void 0:vt.length)!==null&&bt!==void 0?bt:0})):ft},[]);if(ut.length){var pt=new RegExp(`
-[	 ]{`+Math.min.apply(Math,ut)+"}","g");dt=dt.map(function(ft){return ft.replace(pt,`
-`)})}dt[0]=dt[0].replace(/^\r?\n/,"");var yt=dt[0];return it.forEach(function(ft,mt){var kt=yt.match(/(?:^|\n)( *)$/),_t=kt?kt[1]:"",vt=ft;typeof ft=="string"&&ft.includes(`
-`)&&(vt=String(ft).split(`
-`).map(function(bt,Mt){return Mt===0?bt:""+_t+bt}).join(`
-`)),yt+=vt+dt[mt+1]}),yt}var unknownIcon={body:'<g><rect width="80" height="80" style="fill: #087ebf; stroke-width: 0px;"/><text transform="translate(21.16 64.67)" style="fill: #fff; font-family: ArialMT, Arial; font-size: 67.75px;"><tspan x="0" y="0">?</tspan></text></g>',height:80,width:80},iconsStore=new Map,loaderStore=new Map,registerIconPacks=__name(rt=>{for(const it of rt){if(!it.name)throw new Error('Invalid icon loader. Must have a "name" property with non-empty string value.');if(log.debug("Registering icon pack:",it.name),"loader"in it)loaderStore.set(it.name,it.loader);else if("icons"in it)iconsStore.set(it.name,it.icons);else throw log.error("Invalid icon loader:",it),new Error('Invalid icon loader. Must have either "icons" or "loader" property.')}},"registerIconPacks"),getRegisteredIconData=__name(async(rt,it)=>{const ct=stringToIcon(rt,!0,it!==void 0);if(!ct)throw new Error(`Invalid icon name: ${rt}`);const dt=ct.prefix||it;if(!dt)throw new Error(`Icon name must contain a prefix: ${rt}`);let ut=iconsStore.get(dt);if(!ut){const yt=loaderStore.get(dt);if(!yt)throw new Error(`Icon set not found: ${ct.prefix}`);try{ut={...await yt(),prefix:dt},iconsStore.set(dt,ut)}catch(ft){throw log.error(ft),new Error(`Failed to load icon set: ${ct.prefix}`)}}const pt=getIconData(ut,ct.name);if(!pt)throw new Error(`Icon not found: ${rt}`);return pt},"getRegisteredIconData"),isIconAvailable=__name(async rt=>{try{return await getRegisteredIconData(rt),!0}catch{return!1}},"isIconAvailable"),getIconSVG=__name(async(rt,it,ct)=>{let dt;try{dt=await getRegisteredIconData(rt,it?.fallbackPrefix)}catch(yt){log.error(yt),dt=unknownIcon}const ut=iconToSVG(dt,it),pt=iconToHTML(replaceIDs(ut.body),{...ut.attributes,...ct});return sanitizeText(pt,getConfig())},"getIconSVG");function preprocessMarkdown(rt,{markdownAutoWrap:it}){const dt=rt.replace(/<br\/>/g,`
-`).replace(/\n{2,}/g,`
-`),ut=dedent(dt);return it===!1?ut.replace(/ /g,"&nbsp;"):ut}__name(preprocessMarkdown,"preprocessMarkdown");function markdownToLines(rt,it={}){const ct=preprocessMarkdown(rt,it),dt=k$2.lexer(ct),ut=[[]];let pt=0;function yt(ft,mt="normal"){ft.type==="text"?ft.text.split(`
-`).forEach((_t,vt)=>{vt!==0&&(pt++,ut.push([])),_t.split(" ").forEach(bt=>{bt=bt.replace(/&#39;/g,"'"),bt&&ut[pt].push({content:bt,type:mt})})}):ft.type==="strong"||ft.type==="em"?ft.tokens.forEach(kt=>{yt(kt,ft.type)}):ft.type==="html"&&ut[pt].push({content:ft.text,type:"normal"})}return __name(yt,"processNode"),dt.forEach(ft=>{ft.type==="paragraph"?ft.tokens?.forEach(mt=>{yt(mt)}):ft.type==="html"?ut[pt].push({content:ft.text,type:"normal"}):ut[pt].push({content:ft.raw,type:"normal"})}),ut}__name(markdownToLines,"markdownToLines");function markdownToHTML(rt,{markdownAutoWrap:it}={}){const ct=k$2.lexer(rt);function dt(ut){return ut.type==="text"?it===!1?ut.text.replace(/\n */g,"<br/>").replace(/ /g,"&nbsp;"):ut.text.replace(/\n */g,"<br/>"):ut.type==="strong"?`<strong>${ut.tokens?.map(dt).join("")}</strong>`:ut.type==="em"?`<em>${ut.tokens?.map(dt).join("")}</em>`:ut.type==="paragraph"?`<p>${ut.tokens?.map(dt).join("")}</p>`:ut.type==="space"?"":ut.type==="html"?`${ut.text}`:ut.type==="escape"?ut.text:(log.warn(`Unsupported markdown: ${ut.type}`),ut.raw)}return __name(dt,"output"),ct.map(dt).join("")}__name(markdownToHTML,"markdownToHTML");function splitTextToChars(rt){return Intl.Segmenter?[...new Intl.Segmenter().segment(rt)].map(it=>it.segment):[...rt]}__name(splitTextToChars,"splitTextToChars");function splitWordToFitWidth(rt,it){const ct=splitTextToChars(it.content);return splitWordToFitWidthRecursion(rt,[],ct,it.type)}__name(splitWordToFitWidth,"splitWordToFitWidth");function splitWordToFitWidthRecursion(rt,it,ct,dt){if(ct.length===0)return[{content:it.join(""),type:dt},{content:"",type:dt}];const[ut,...pt]=ct,yt=[...it,ut];return rt([{content:yt.join(""),type:dt}])?splitWordToFitWidthRecursion(rt,yt,pt,dt):(it.length===0&&ut&&(it.push(ut),ct.shift()),[{content:it.join(""),type:dt},{content:ct.join(""),type:dt}])}__name(splitWordToFitWidthRecursion,"splitWordToFitWidthRecursion");function splitLineToFitWidth(rt,it){if(rt.some(({content:ct})=>ct.includes(`
-`)))throw new Error("splitLineToFitWidth does not support newlines in the line");return splitLineToFitWidthRecursion(rt,it)}__name(splitLineToFitWidth,"splitLineToFitWidth");function splitLineToFitWidthRecursion(rt,it,ct=[],dt=[]){if(rt.length===0)return dt.length>0&&ct.push(dt),ct.length>0?ct:[];let ut="";rt[0].content===" "&&(ut=" ",rt.shift());const pt=rt.shift()??{content:" ",type:"normal"},yt=[...dt];if(ut!==""&&yt.push({content:ut,type:"normal"}),yt.push(pt),it(yt))return splitLineToFitWidthRecursion(rt,it,ct,yt);if(dt.length>0)ct.push(dt),rt.unshift(pt);else if(pt.content){const[ft,mt]=splitWordToFitWidth(it,pt);ct.push([ft]),mt.content&&rt.unshift(mt)}return splitLineToFitWidthRecursion(rt,it,ct)}__name(splitLineToFitWidthRecursion,"splitLineToFitWidthRecursion");function applyStyle$1(rt,it){it&&rt.attr("style",it)}__name(applyStyle$1,"applyStyle");async function addHtmlSpan(rt,it,ct,dt,ut=!1,pt=getConfig()){const yt=rt.append("foreignObject");yt.attr("width",`${10*ct}px`),yt.attr("height",`${10*ct}px`);const ft=yt.append("xhtml:div"),mt=hasKatex(it.label)?await renderKatexSanitized(it.label.replace(common_default.lineBreakRegex,`
-`),pt):sanitizeText(it.label,pt),kt=it.isNode?"nodeLabel":"edgeLabel",_t=ft.append("span");_t.html(mt),applyStyle$1(_t,it.labelStyle),_t.attr("class",`${kt} ${dt}`),applyStyle$1(ft,it.labelStyle),ft.style("display","table-cell"),ft.style("white-space","nowrap"),ft.style("line-height","1.5"),ft.style("max-width",ct+"px"),ft.style("text-align","center"),ft.attr("xmlns","http://www.w3.org/1999/xhtml"),ut&&ft.attr("class","labelBkg");let vt=ft.node().getBoundingClientRect();return vt.width===ct&&(ft.style("display","table"),ft.style("white-space","break-spaces"),ft.style("width",ct+"px"),vt=ft.node().getBoundingClientRect()),yt.node()}__name(addHtmlSpan,"addHtmlSpan");function createTspan(rt,it,ct){return rt.append("tspan").attr("class","text-outer-tspan").attr("x",0).attr("y",it*ct-.1+"em").attr("dy",ct+"em")}__name(createTspan,"createTspan");function computeWidthOfText(rt,it,ct){const dt=rt.append("text"),ut=createTspan(dt,1,it);updateTextContentAndStyles(ut,ct);const pt=ut.node().getComputedTextLength();return dt.remove(),pt}__name(computeWidthOfText,"computeWidthOfText");function computeDimensionOfText(rt,it,ct){const dt=rt.append("text"),ut=createTspan(dt,1,it);updateTextContentAndStyles(ut,[{content:ct,type:"normal"}]);const pt=ut.node()?.getBoundingClientRect();return pt&&dt.remove(),pt}__name(computeDimensionOfText,"computeDimensionOfText");function createFormattedText(rt,it,ct,dt=!1){const pt=it.append("g"),yt=pt.insert("rect").attr("class","background").attr("style","stroke: none"),ft=pt.append("text").attr("y","-10.1");let mt=0;for(const kt of ct){const _t=__name(bt=>computeWidthOfText(pt,1.1,bt)<=rt,"checkWidth"),vt=_t(kt)?[kt]:splitLineToFitWidth(kt,_t);for(const bt of vt){const Mt=createTspan(ft,mt,1.1);updateTextContentAndStyles(Mt,bt),mt++}}if(dt){const kt=ft.node().getBBox(),_t=2;return yt.attr("x",kt.x-_t).attr("y",kt.y-_t).attr("width",kt.width+2*_t).attr("height",kt.height+2*_t),pt.node()}else return ft.node()}__name(createFormattedText,"createFormattedText");function updateTextContentAndStyles(rt,it){rt.text(""),it.forEach((ct,dt)=>{const ut=rt.append("tspan").attr("font-style",ct.type==="em"?"italic":"normal").attr("class","text-inner-tspan").attr("font-weight",ct.type==="strong"?"bold":"normal");dt===0?ut.text(ct.content):ut.text(" "+ct.content)})}__name(updateTextContentAndStyles,"updateTextContentAndStyles");async function replaceIconSubstring(rt,it={}){const ct=[];rt.replace(/(fa[bklrs]?):fa-([\w-]+)/g,(ut,pt,yt)=>(ct.push((async()=>{const ft=`${pt}:${yt}`;return await isIconAvailable(ft)?await getIconSVG(ft,void 0,{class:"label-icon"}):`<i class='${sanitizeText(ut,it).replace(":"," ")}'></i>`})()),ut));const dt=await Promise.all(ct);return rt.replace(/(fa[bklrs]?):fa-([\w-]+)/g,()=>dt.shift()??"")}__name(replaceIconSubstring,"replaceIconSubstring");var createText=__name(async(rt,it="",{style:ct="",isTitle:dt=!1,classes:ut="",useHtmlLabels:pt=!0,isNode:yt=!0,width:ft=200,addSvgBackground:mt=!1}={},kt)=>{if(log.debug("XYZ createText",it,ct,dt,ut,pt,yt,"addSvgBackground: ",mt),pt){const _t=markdownToHTML(it,kt),vt=await replaceIconSubstring(decodeEntities(_t),kt),bt=it.replace(/\\\\/g,"\\"),Mt={isNode:yt,label:hasKatex(it)?bt:vt,labelStyle:ct.replace("fill:","color:")};return await addHtmlSpan(rt,Mt,ft,ut,mt,kt)}else{const _t=it.replace(/<br\s*\/?>/g,"<br/>"),vt=markdownToLines(_t.replace("<br>","<br/>"),kt),bt=createFormattedText(ft,rt,vt,it?mt:!1);if(yt){/stroke:/.exec(ct)&&(ct=ct.replace("stroke:","lineColor:"));const Mt=ct.replace(/stroke:[^;]+;?/g,"").replace(/stroke-width:[^;]+;?/g,"").replace(/fill:[^;]+;?/g,"").replace(/color:/g,"fill:");select(bt).attr("style",Mt)}else{const Mt=ct.replace(/stroke:[^;]+;?/g,"").replace(/stroke-width:[^;]+;?/g,"").replace(/fill:[^;]+;?/g,"").replace(/background:/g,"fill:");select(bt).select("rect").attr("style",Mt.replace(/background:/g,"fill:"));const wt=ct.replace(/stroke:[^;]+;?/g,"").replace(/stroke-width:[^;]+;?/g,"").replace(/fill:[^;]+;?/g,"").replace(/color:/g,"fill:");select(bt).select("text").attr("style",wt)}return bt}},"createText");function t(rt,it,ct){if(rt&&rt.length){const[dt,ut]=it,pt=Math.PI/180*ct,yt=Math.cos(pt),ft=Math.sin(pt);for(const mt of rt){const[kt,_t]=mt;mt[0]=(kt-dt)*yt-(_t-ut)*ft+dt,mt[1]=(kt-dt)*ft+(_t-ut)*yt+ut}}}function e(rt,it){return rt[0]===it[0]&&rt[1]===it[1]}function s$1(rt,it,ct,dt=1){const ut=ct,pt=Math.max(it,.1),yt=rt[0]&&rt[0][0]&&typeof rt[0][0]=="number"?[rt]:rt,ft=[0,0];if(ut)for(const kt of yt)t(kt,ft,ut);const mt=(function(kt,_t,vt){const bt=[];for(const $t of kt){const Et=[...$t];e(Et[0],Et[Et.length-1])||Et.push([Et[0][0],Et[0][1]]),Et.length>2&&bt.push(Et)}const Mt=[];_t=Math.max(_t,.1);const wt=[];for(const $t of bt)for(let Et=0;Et<$t.length-1;Et++){const Ft=$t[Et],qt=$t[Et+1];if(Ft[1]!==qt[1]){const Ht=Math.min(Ft[1],qt[1]);wt.push({ymin:Ht,ymax:Math.max(Ft[1],qt[1]),x:Ht===Ft[1]?Ft[0]:qt[0],islope:(qt[0]-Ft[0])/(qt[1]-Ft[1])})}}if(wt.sort((($t,Et)=>$t.ymin<Et.ymin?-1:$t.ymin>Et.ymin?1:$t.x<Et.x?-1:$t.x>Et.x?1:$t.ymax===Et.ymax?0:($t.ymax-Et.ymax)/Math.abs($t.ymax-Et.ymax))),!wt.length)return Mt;let St=[],It=wt[0].ymin,Nt=0;for(;St.length||wt.length;){if(wt.length){let $t=-1;for(let Et=0;Et<wt.length&&!(wt[Et].ymin>It);Et++)$t=Et;wt.splice(0,$t+1).forEach((Et=>{St.push({s:It,edge:Et})}))}if(St=St.filter(($t=>!($t.edge.ymax<=It))),St.sort((($t,Et)=>$t.edge.x===Et.edge.x?0:($t.edge.x-Et.edge.x)/Math.abs($t.edge.x-Et.edge.x))),(vt!==1||Nt%_t==0)&&St.length>1)for(let $t=0;$t<St.length;$t+=2){const Et=$t+1;if(Et>=St.length)break;const Ft=St[$t].edge,qt=St[Et].edge;Mt.push([[Math.round(Ft.x),It],[Math.round(qt.x),It]])}It+=vt,St.forEach(($t=>{$t.edge.x=$t.edge.x+vt*$t.edge.islope})),Nt++}return Mt})(yt,pt,dt);if(ut){for(const kt of yt)t(kt,ft,-ut);(function(kt,_t,vt){const bt=[];kt.forEach((Mt=>bt.push(...Mt))),t(bt,_t,vt)})(mt,ft,-ut)}return mt}function n$1(rt,it){var ct;const dt=it.hachureAngle+90;let ut=it.hachureGap;ut<0&&(ut=4*it.strokeWidth),ut=Math.round(Math.max(ut,.1));let pt=1;return it.roughness>=1&&(((ct=it.randomizer)===null||ct===void 0?void 0:ct.next())||Math.random())>.7&&(pt=ut),s$1(rt,ut,dt,pt||1)}let o$1=class{constructor(it){this.helper=it}fillPolygons(it,ct){return this._fillPolygons(it,ct)}_fillPolygons(it,ct){const dt=n$1(it,ct);return{type:"fillSketch",ops:this.renderLines(dt,ct)}}renderLines(it,ct){const dt=[];for(const ut of it)dt.push(...this.helper.doubleLineOps(ut[0][0],ut[0][1],ut[1][0],ut[1][1],ct));return dt}};function a$1(rt){const it=rt[0],ct=rt[1];return Math.sqrt(Math.pow(it[0]-ct[0],2)+Math.pow(it[1]-ct[1],2))}let h$1=class extends o$1{fillPolygons(it,ct){let dt=ct.hachureGap;dt<0&&(dt=4*ct.strokeWidth),dt=Math.max(dt,.1);const ut=n$1(it,Object.assign({},ct,{hachureGap:dt})),pt=Math.PI/180*ct.hachureAngle,yt=[],ft=.5*dt*Math.cos(pt),mt=.5*dt*Math.sin(pt);for(const[kt,_t]of ut)a$1([kt,_t])&&yt.push([[kt[0]-ft,kt[1]+mt],[..._t]],[[kt[0]+ft,kt[1]-mt],[..._t]]);return{type:"fillSketch",ops:this.renderLines(yt,ct)}}},r$2=class extends o$1{fillPolygons(it,ct){const dt=this._fillPolygons(it,ct),ut=Object.assign({},ct,{hachureAngle:ct.hachureAngle+90}),pt=this._fillPolygons(it,ut);return dt.ops=dt.ops.concat(pt.ops),dt}},i$1=class{constructor(it){this.helper=it}fillPolygons(it,ct){const dt=n$1(it,ct=Object.assign({},ct,{hachureAngle:0}));return this.dotsOnLines(dt,ct)}dotsOnLines(it,ct){const dt=[];let ut=ct.hachureGap;ut<0&&(ut=4*ct.strokeWidth),ut=Math.max(ut,.1);let pt=ct.fillWeight;pt<0&&(pt=ct.strokeWidth/2);const yt=ut/4;for(const ft of it){const mt=a$1(ft),kt=mt/ut,_t=Math.ceil(kt)-1,vt=mt-_t*ut,bt=(ft[0][0]+ft[1][0])/2-ut/4,Mt=Math.min(ft[0][1],ft[1][1]);for(let wt=0;wt<_t;wt++){const St=Mt+vt+wt*ut,It=bt-yt+2*Math.random()*yt,Nt=St-yt+2*Math.random()*yt,$t=this.helper.ellipse(It,Nt,pt,pt,ct);dt.push(...$t.ops)}}return{type:"fillSketch",ops:dt}}},c$1=class{constructor(it){this.helper=it}fillPolygons(it,ct){const dt=n$1(it,ct);return{type:"fillSketch",ops:this.dashedLine(dt,ct)}}dashedLine(it,ct){const dt=ct.dashOffset<0?ct.hachureGap<0?4*ct.strokeWidth:ct.hachureGap:ct.dashOffset,ut=ct.dashGap<0?ct.hachureGap<0?4*ct.strokeWidth:ct.hachureGap:ct.dashGap,pt=[];return it.forEach((yt=>{const ft=a$1(yt),mt=Math.floor(ft/(dt+ut)),kt=(ft+ut-mt*(dt+ut))/2;let _t=yt[0],vt=yt[1];_t[0]>vt[0]&&(_t=yt[1],vt=yt[0]);const bt=Math.atan((vt[1]-_t[1])/(vt[0]-_t[0]));for(let Mt=0;Mt<mt;Mt++){const wt=Mt*(dt+ut),St=wt+dt,It=[_t[0]+wt*Math.cos(bt)+kt*Math.cos(bt),_t[1]+wt*Math.sin(bt)+kt*Math.sin(bt)],Nt=[_t[0]+St*Math.cos(bt)+kt*Math.cos(bt),_t[1]+St*Math.sin(bt)+kt*Math.sin(bt)];pt.push(...this.helper.doubleLineOps(It[0],It[1],Nt[0],Nt[1],ct))}})),pt}},l$1=class{constructor(it){this.helper=it}fillPolygons(it,ct){const dt=ct.hachureGap<0?4*ct.strokeWidth:ct.hachureGap,ut=ct.zigzagOffset<0?dt:ct.zigzagOffset,pt=n$1(it,ct=Object.assign({},ct,{hachureGap:dt+ut}));return{type:"fillSketch",ops:this.zigzagLines(pt,ut,ct)}}zigzagLines(it,ct,dt){const ut=[];return it.forEach((pt=>{const yt=a$1(pt),ft=Math.round(yt/(2*ct));let mt=pt[0],kt=pt[1];mt[0]>kt[0]&&(mt=pt[1],kt=pt[0]);const _t=Math.atan((kt[1]-mt[1])/(kt[0]-mt[0]));for(let vt=0;vt<ft;vt++){const bt=2*vt*ct,Mt=2*(vt+1)*ct,wt=Math.sqrt(2*Math.pow(ct,2)),St=[mt[0]+bt*Math.cos(_t),mt[1]+bt*Math.sin(_t)],It=[mt[0]+Mt*Math.cos(_t),mt[1]+Mt*Math.sin(_t)],Nt=[St[0]+wt*Math.cos(_t+Math.PI/4),St[1]+wt*Math.sin(_t+Math.PI/4)];ut.push(...this.helper.doubleLineOps(St[0],St[1],Nt[0],Nt[1],dt),...this.helper.doubleLineOps(Nt[0],Nt[1],It[0],It[1],dt))}})),ut}};const u$1={};let p$1=class{constructor(it){this.seed=it}next(){return this.seed?(2**31-1&(this.seed=Math.imul(48271,this.seed)))/2**31:Math.random()}};const f$1=0,d$1=1,g$1=2,M$1={A:7,a:7,C:6,c:6,H:1,h:1,L:2,l:2,M:2,m:2,Q:4,q:4,S:4,s:4,T:2,t:2,V:1,v:1,Z:0,z:0};function k$1(rt,it){return rt.type===it}function b$1(rt){const it=[],ct=(function(yt){const ft=new Array;for(;yt!=="";)if(yt.match(/^([ \t\r\n,]+)/))yt=yt.substr(RegExp.$1.length);else if(yt.match(/^([aAcChHlLmMqQsStTvVzZ])/))ft[ft.length]={type:f$1,text:RegExp.$1},yt=yt.substr(RegExp.$1.length);else{if(!yt.match(/^(([-+]?[0-9]+(\.[0-9]*)?|[-+]?\.[0-9]+)([eE][-+]?[0-9]+)?)/))return[];ft[ft.length]={type:d$1,text:`${parseFloat(RegExp.$1)}`},yt=yt.substr(RegExp.$1.length)}return ft[ft.length]={type:g$1,text:""},ft})(rt);let dt="BOD",ut=0,pt=ct[ut];for(;!k$1(pt,g$1);){let yt=0;const ft=[];if(dt==="BOD"){if(pt.text!=="M"&&pt.text!=="m")return b$1("M0,0"+rt);ut++,yt=M$1[pt.text],dt=pt.text}else k$1(pt,d$1)?yt=M$1[dt]:(ut++,yt=M$1[pt.text],dt=pt.text);if(!(ut+yt<ct.length))throw new Error("Path data ended short");for(let mt=ut;mt<ut+yt;mt++){const kt=ct[mt];if(!k$1(kt,d$1))throw new Error("Param not a number: "+dt+","+kt.text);ft[ft.length]=+kt.text}if(typeof M$1[dt]!="number")throw new Error("Bad segment: "+dt);{const mt={key:dt,data:ft};it.push(mt),ut+=yt,pt=ct[ut],dt==="M"&&(dt="L"),dt==="m"&&(dt="l")}}return it}function y$1(rt){let it=0,ct=0,dt=0,ut=0;const pt=[];for(const{key:yt,data:ft}of rt)switch(yt){case"M":pt.push({key:"M",data:[...ft]}),[it,ct]=ft,[dt,ut]=ft;break;case"m":it+=ft[0],ct+=ft[1],pt.push({key:"M",data:[it,ct]}),dt=it,ut=ct;break;case"L":pt.push({key:"L",data:[...ft]}),[it,ct]=ft;break;case"l":it+=ft[0],ct+=ft[1],pt.push({key:"L",data:[it,ct]});break;case"C":pt.push({key:"C",data:[...ft]}),it=ft[4],ct=ft[5];break;case"c":{const mt=ft.map(((kt,_t)=>_t%2?kt+ct:kt+it));pt.push({key:"C",data:mt}),it=mt[4],ct=mt[5];break}case"Q":pt.push({key:"Q",data:[...ft]}),it=ft[2],ct=ft[3];break;case"q":{const mt=ft.map(((kt,_t)=>_t%2?kt+ct:kt+it));pt.push({key:"Q",data:mt}),it=mt[2],ct=mt[3];break}case"A":pt.push({key:"A",data:[...ft]}),it=ft[5],ct=ft[6];break;case"a":it+=ft[5],ct+=ft[6],pt.push({key:"A",data:[ft[0],ft[1],ft[2],ft[3],ft[4],it,ct]});break;case"H":pt.push({key:"H",data:[...ft]}),it=ft[0];break;case"h":it+=ft[0],pt.push({key:"H",data:[it]});break;case"V":pt.push({key:"V",data:[...ft]}),ct=ft[0];break;case"v":ct+=ft[0],pt.push({key:"V",data:[ct]});break;case"S":pt.push({key:"S",data:[...ft]}),it=ft[2],ct=ft[3];break;case"s":{const mt=ft.map(((kt,_t)=>_t%2?kt+ct:kt+it));pt.push({key:"S",data:mt}),it=mt[2],ct=mt[3];break}case"T":pt.push({key:"T",data:[...ft]}),it=ft[0],ct=ft[1];break;case"t":it+=ft[0],ct+=ft[1],pt.push({key:"T",data:[it,ct]});break;case"Z":case"z":pt.push({key:"Z",data:[]}),it=dt,ct=ut}return pt}function m$1(rt){const it=[];let ct="",dt=0,ut=0,pt=0,yt=0,ft=0,mt=0;for(const{key:kt,data:_t}of rt){switch(kt){case"M":it.push({key:"M",data:[..._t]}),[dt,ut]=_t,[pt,yt]=_t;break;case"C":it.push({key:"C",data:[..._t]}),dt=_t[4],ut=_t[5],ft=_t[2],mt=_t[3];break;case"L":it.push({key:"L",data:[..._t]}),[dt,ut]=_t;break;case"H":dt=_t[0],it.push({key:"L",data:[dt,ut]});break;case"V":ut=_t[0],it.push({key:"L",data:[dt,ut]});break;case"S":{let vt=0,bt=0;ct==="C"||ct==="S"?(vt=dt+(dt-ft),bt=ut+(ut-mt)):(vt=dt,bt=ut),it.push({key:"C",data:[vt,bt,..._t]}),ft=_t[0],mt=_t[1],dt=_t[2],ut=_t[3];break}case"T":{const[vt,bt]=_t;let Mt=0,wt=0;ct==="Q"||ct==="T"?(Mt=dt+(dt-ft),wt=ut+(ut-mt)):(Mt=dt,wt=ut);const St=dt+2*(Mt-dt)/3,It=ut+2*(wt-ut)/3,Nt=vt+2*(Mt-vt)/3,$t=bt+2*(wt-bt)/3;it.push({key:"C",data:[St,It,Nt,$t,vt,bt]}),ft=Mt,mt=wt,dt=vt,ut=bt;break}case"Q":{const[vt,bt,Mt,wt]=_t,St=dt+2*(vt-dt)/3,It=ut+2*(bt-ut)/3,Nt=Mt+2*(vt-Mt)/3,$t=wt+2*(bt-wt)/3;it.push({key:"C",data:[St,It,Nt,$t,Mt,wt]}),ft=vt,mt=bt,dt=Mt,ut=wt;break}case"A":{const vt=Math.abs(_t[0]),bt=Math.abs(_t[1]),Mt=_t[2],wt=_t[3],St=_t[4],It=_t[5],Nt=_t[6];vt===0||bt===0?(it.push({key:"C",data:[dt,ut,It,Nt,It,Nt]}),dt=It,ut=Nt):(dt!==It||ut!==Nt)&&(x$1(dt,ut,It,Nt,vt,bt,Mt,wt,St).forEach((function($t){it.push({key:"C",data:$t})})),dt=It,ut=Nt);break}case"Z":it.push({key:"Z",data:[]}),dt=pt,ut=yt}ct=kt}return it}function w$1(rt,it,ct){return[rt*Math.cos(ct)-it*Math.sin(ct),rt*Math.sin(ct)+it*Math.cos(ct)]}function x$1(rt,it,ct,dt,ut,pt,yt,ft,mt,kt){const _t=(vt=yt,Math.PI*vt/180);var vt;let bt=[],Mt=0,wt=0,St=0,It=0;if(kt)[Mt,wt,St,It]=kt;else{[rt,it]=w$1(rt,it,-_t),[ct,dt]=w$1(ct,dt,-_t);const la=(rt-ct)/2,Kt=(it-dt)/2;let ra=la*la/(ut*ut)+Kt*Kt/(pt*pt);ra>1&&(ra=Math.sqrt(ra),ut*=ra,pt*=ra);const Ut=ut*ut,ea=pt*pt,Gt=Ut*ea-Ut*Kt*Kt-ea*la*la,_a=Ut*Kt*Kt+ea*la*la,Ca=(ft===mt?-1:1)*Math.sqrt(Math.abs(Gt/_a));St=Ca*ut*Kt/pt+(rt+ct)/2,It=Ca*-pt*la/ut+(it+dt)/2,Mt=Math.asin(parseFloat(((it-It)/pt).toFixed(9))),wt=Math.asin(parseFloat(((dt-It)/pt).toFixed(9))),rt<St&&(Mt=Math.PI-Mt),ct<St&&(wt=Math.PI-wt),Mt<0&&(Mt=2*Math.PI+Mt),wt<0&&(wt=2*Math.PI+wt),mt&&Mt>wt&&(Mt-=2*Math.PI),!mt&&wt>Mt&&(wt-=2*Math.PI)}let Nt=wt-Mt;if(Math.abs(Nt)>120*Math.PI/180){const la=wt,Kt=ct,ra=dt;wt=mt&&wt>Mt?Mt+120*Math.PI/180*1:Mt+120*Math.PI/180*-1,bt=x$1(ct=St+ut*Math.cos(wt),dt=It+pt*Math.sin(wt),Kt,ra,ut,pt,yt,0,mt,[wt,la,St,It])}Nt=wt-Mt;const $t=Math.cos(Mt),Et=Math.sin(Mt),Ft=Math.cos(wt),qt=Math.sin(wt),Ht=Math.tan(Nt/4),Ot=4/3*ut*Ht,Zt=4/3*pt*Ht,Yt=[rt,it],aa=[rt+Ot*Et,it-Zt*$t],Qt=[ct+Ot*qt,dt-Zt*Ft],oa=[ct,dt];if(aa[0]=2*Yt[0]-aa[0],aa[1]=2*Yt[1]-aa[1],kt)return[aa,Qt,oa].concat(bt);{bt=[aa,Qt,oa].concat(bt);const la=[];for(let Kt=0;Kt<bt.length;Kt+=3){const ra=w$1(bt[Kt][0],bt[Kt][1],_t),Ut=w$1(bt[Kt+1][0],bt[Kt+1][1],_t),ea=w$1(bt[Kt+2][0],bt[Kt+2][1],_t);la.push([ra[0],ra[1],Ut[0],Ut[1],ea[0],ea[1]])}return la}}const P$1={randOffset:function(rt,it){return G$1(rt,it)},randOffsetWithRange:function(rt,it,ct){return E$1(rt,it,ct)},ellipse:function(rt,it,ct,dt,ut){const pt=T$1(ct,dt,ut);return D$1(rt,it,ut,pt).opset},doubleLineOps:function(rt,it,ct,dt,ut){return $$1(rt,it,ct,dt,ut,!0)}};function v$1(rt,it,ct,dt,ut){return{type:"path",ops:$$1(rt,it,ct,dt,ut)}}function S$1(rt,it,ct){const dt=(rt||[]).length;if(dt>2){const ut=[];for(let pt=0;pt<dt-1;pt++)ut.push(...$$1(rt[pt][0],rt[pt][1],rt[pt+1][0],rt[pt+1][1],ct));return it&&ut.push(...$$1(rt[dt-1][0],rt[dt-1][1],rt[0][0],rt[0][1],ct)),{type:"path",ops:ut}}return dt===2?v$1(rt[0][0],rt[0][1],rt[1][0],rt[1][1],ct):{type:"path",ops:[]}}function O$1(rt,it,ct,dt,ut){return(function(pt,yt){return S$1(pt,!0,yt)})([[rt,it],[rt+ct,it],[rt+ct,it+dt],[rt,it+dt]],ut)}function L$1(rt,it){if(rt.length){const ct=typeof rt[0][0]=="number"?[rt]:rt,dt=j$1(ct[0],1*(1+.2*it.roughness),it),ut=it.disableMultiStroke?[]:j$1(ct[0],1.5*(1+.22*it.roughness),z$1(it));for(let pt=1;pt<ct.length;pt++){const yt=ct[pt];if(yt.length){const ft=j$1(yt,1*(1+.2*it.roughness),it),mt=it.disableMultiStroke?[]:j$1(yt,1.5*(1+.22*it.roughness),z$1(it));for(const kt of ft)kt.op!=="move"&&dt.push(kt);for(const kt of mt)kt.op!=="move"&&ut.push(kt)}}return{type:"path",ops:dt.concat(ut)}}return{type:"path",ops:[]}}function T$1(rt,it,ct){const dt=Math.sqrt(2*Math.PI*Math.sqrt((Math.pow(rt/2,2)+Math.pow(it/2,2))/2)),ut=Math.ceil(Math.max(ct.curveStepCount,ct.curveStepCount/Math.sqrt(200)*dt)),pt=2*Math.PI/ut;let yt=Math.abs(rt/2),ft=Math.abs(it/2);const mt=1-ct.curveFitting;return yt+=G$1(yt*mt,ct),ft+=G$1(ft*mt,ct),{increment:pt,rx:yt,ry:ft}}function D$1(rt,it,ct,dt){const[ut,pt]=F$1(dt.increment,rt,it,dt.rx,dt.ry,1,dt.increment*E$1(.1,E$1(.4,1,ct),ct),ct);let yt=q$1(ut,null,ct);if(!ct.disableMultiStroke&&ct.roughness!==0){const[ft]=F$1(dt.increment,rt,it,dt.rx,dt.ry,1.5,0,ct),mt=q$1(ft,null,ct);yt=yt.concat(mt)}return{estimatedPoints:pt,opset:{type:"path",ops:yt}}}function A$1(rt,it,ct,dt,ut,pt,yt,ft,mt){const kt=rt,_t=it;let vt=Math.abs(ct/2),bt=Math.abs(dt/2);vt+=G$1(.01*vt,mt),bt+=G$1(.01*bt,mt);let Mt=ut,wt=pt;for(;Mt<0;)Mt+=2*Math.PI,wt+=2*Math.PI;wt-Mt>2*Math.PI&&(Mt=0,wt=2*Math.PI);const St=2*Math.PI/mt.curveStepCount,It=Math.min(St/2,(wt-Mt)/2),Nt=V$1(It,kt,_t,vt,bt,Mt,wt,1,mt);if(!mt.disableMultiStroke){const $t=V$1(It,kt,_t,vt,bt,Mt,wt,1.5,mt);Nt.push(...$t)}return yt&&(ft?Nt.push(...$$1(kt,_t,kt+vt*Math.cos(Mt),_t+bt*Math.sin(Mt),mt),...$$1(kt,_t,kt+vt*Math.cos(wt),_t+bt*Math.sin(wt),mt)):Nt.push({op:"lineTo",data:[kt,_t]},{op:"lineTo",data:[kt+vt*Math.cos(Mt),_t+bt*Math.sin(Mt)]})),{type:"path",ops:Nt}}function _$1(rt,it){const ct=m$1(y$1(b$1(rt))),dt=[];let ut=[0,0],pt=[0,0];for(const{key:yt,data:ft}of ct)switch(yt){case"M":pt=[ft[0],ft[1]],ut=[ft[0],ft[1]];break;case"L":dt.push(...$$1(pt[0],pt[1],ft[0],ft[1],it)),pt=[ft[0],ft[1]];break;case"C":{const[mt,kt,_t,vt,bt,Mt]=ft;dt.push(...Z$1(mt,kt,_t,vt,bt,Mt,pt,it)),pt=[bt,Mt];break}case"Z":dt.push(...$$1(pt[0],pt[1],ut[0],ut[1],it)),pt=[ut[0],ut[1]]}return{type:"path",ops:dt}}function I$1(rt,it){const ct=[];for(const dt of rt)if(dt.length){const ut=it.maxRandomnessOffset||0,pt=dt.length;if(pt>2){ct.push({op:"move",data:[dt[0][0]+G$1(ut,it),dt[0][1]+G$1(ut,it)]});for(let yt=1;yt<pt;yt++)ct.push({op:"lineTo",data:[dt[yt][0]+G$1(ut,it),dt[yt][1]+G$1(ut,it)]})}}return{type:"fillPath",ops:ct}}function C$1(rt,it){return(function(ct,dt){let ut=ct.fillStyle||"hachure";if(!u$1[ut])switch(ut){case"zigzag":u$1[ut]||(u$1[ut]=new h$1(dt));break;case"cross-hatch":u$1[ut]||(u$1[ut]=new r$2(dt));break;case"dots":u$1[ut]||(u$1[ut]=new i$1(dt));break;case"dashed":u$1[ut]||(u$1[ut]=new c$1(dt));break;case"zigzag-line":u$1[ut]||(u$1[ut]=new l$1(dt));break;default:ut="hachure",u$1[ut]||(u$1[ut]=new o$1(dt))}return u$1[ut]})(it,P$1).fillPolygons(rt,it)}function z$1(rt){const it=Object.assign({},rt);return it.randomizer=void 0,rt.seed&&(it.seed=rt.seed+1),it}function W$1(rt){return rt.randomizer||(rt.randomizer=new p$1(rt.seed||0)),rt.randomizer.next()}function E$1(rt,it,ct,dt=1){return ct.roughness*dt*(W$1(ct)*(it-rt)+rt)}function G$1(rt,it,ct=1){return E$1(-rt,rt,it,ct)}function $$1(rt,it,ct,dt,ut,pt=!1){const yt=pt?ut.disableMultiStrokeFill:ut.disableMultiStroke,ft=R$1(rt,it,ct,dt,ut,!0,!1);if(yt)return ft;const mt=R$1(rt,it,ct,dt,ut,!0,!0);return ft.concat(mt)}function R$1(rt,it,ct,dt,ut,pt,yt){const ft=Math.pow(rt-ct,2)+Math.pow(it-dt,2),mt=Math.sqrt(ft);let kt=1;kt=mt<200?1:mt>500?.4:-.0016668*mt+1.233334;let _t=ut.maxRandomnessOffset||0;_t*_t*100>ft&&(_t=mt/10);const vt=_t/2,bt=.2+.2*W$1(ut);let Mt=ut.bowing*ut.maxRandomnessOffset*(dt-it)/200,wt=ut.bowing*ut.maxRandomnessOffset*(rt-ct)/200;Mt=G$1(Mt,ut,kt),wt=G$1(wt,ut,kt);const St=[],It=()=>G$1(vt,ut,kt),Nt=()=>G$1(_t,ut,kt),$t=ut.preserveVertices;return yt?St.push({op:"move",data:[rt+($t?0:It()),it+($t?0:It())]}):St.push({op:"move",data:[rt+($t?0:G$1(_t,ut,kt)),it+($t?0:G$1(_t,ut,kt))]}),yt?St.push({op:"bcurveTo",data:[Mt+rt+(ct-rt)*bt+It(),wt+it+(dt-it)*bt+It(),Mt+rt+2*(ct-rt)*bt+It(),wt+it+2*(dt-it)*bt+It(),ct+($t?0:It()),dt+($t?0:It())]}):St.push({op:"bcurveTo",data:[Mt+rt+(ct-rt)*bt+Nt(),wt+it+(dt-it)*bt+Nt(),Mt+rt+2*(ct-rt)*bt+Nt(),wt+it+2*(dt-it)*bt+Nt(),ct+($t?0:Nt()),dt+($t?0:Nt())]}),St}function j$1(rt,it,ct){if(!rt.length)return[];const dt=[];dt.push([rt[0][0]+G$1(it,ct),rt[0][1]+G$1(it,ct)]),dt.push([rt[0][0]+G$1(it,ct),rt[0][1]+G$1(it,ct)]);for(let ut=1;ut<rt.length;ut++)dt.push([rt[ut][0]+G$1(it,ct),rt[ut][1]+G$1(it,ct)]),ut===rt.length-1&&dt.push([rt[ut][0]+G$1(it,ct),rt[ut][1]+G$1(it,ct)]);return q$1(dt,null,ct)}function q$1(rt,it,ct){const dt=rt.length,ut=[];if(dt>3){const pt=[],yt=1-ct.curveTightness;ut.push({op:"move",data:[rt[1][0],rt[1][1]]});for(let ft=1;ft+2<dt;ft++){const mt=rt[ft];pt[0]=[mt[0],mt[1]],pt[1]=[mt[0]+(yt*rt[ft+1][0]-yt*rt[ft-1][0])/6,mt[1]+(yt*rt[ft+1][1]-yt*rt[ft-1][1])/6],pt[2]=[rt[ft+1][0]+(yt*rt[ft][0]-yt*rt[ft+2][0])/6,rt[ft+1][1]+(yt*rt[ft][1]-yt*rt[ft+2][1])/6],pt[3]=[rt[ft+1][0],rt[ft+1][1]],ut.push({op:"bcurveTo",data:[pt[1][0],pt[1][1],pt[2][0],pt[2][1],pt[3][0],pt[3][1]]})}}else dt===3?(ut.push({op:"move",data:[rt[1][0],rt[1][1]]}),ut.push({op:"bcurveTo",data:[rt[1][0],rt[1][1],rt[2][0],rt[2][1],rt[2][0],rt[2][1]]})):dt===2&&ut.push(...R$1(rt[0][0],rt[0][1],rt[1][0],rt[1][1],ct,!0,!0));return ut}function F$1(rt,it,ct,dt,ut,pt,yt,ft){const mt=[],kt=[];if(ft.roughness===0){rt/=4,kt.push([it+dt*Math.cos(-rt),ct+ut*Math.sin(-rt)]);for(let _t=0;_t<=2*Math.PI;_t+=rt){const vt=[it+dt*Math.cos(_t),ct+ut*Math.sin(_t)];mt.push(vt),kt.push(vt)}kt.push([it+dt*Math.cos(0),ct+ut*Math.sin(0)]),kt.push([it+dt*Math.cos(rt),ct+ut*Math.sin(rt)])}else{const _t=G$1(.5,ft)-Math.PI/2;kt.push([G$1(pt,ft)+it+.9*dt*Math.cos(_t-rt),G$1(pt,ft)+ct+.9*ut*Math.sin(_t-rt)]);const vt=2*Math.PI+_t-.01;for(let bt=_t;bt<vt;bt+=rt){const Mt=[G$1(pt,ft)+it+dt*Math.cos(bt),G$1(pt,ft)+ct+ut*Math.sin(bt)];mt.push(Mt),kt.push(Mt)}kt.push([G$1(pt,ft)+it+dt*Math.cos(_t+2*Math.PI+.5*yt),G$1(pt,ft)+ct+ut*Math.sin(_t+2*Math.PI+.5*yt)]),kt.push([G$1(pt,ft)+it+.98*dt*Math.cos(_t+yt),G$1(pt,ft)+ct+.98*ut*Math.sin(_t+yt)]),kt.push([G$1(pt,ft)+it+.9*dt*Math.cos(_t+.5*yt),G$1(pt,ft)+ct+.9*ut*Math.sin(_t+.5*yt)])}return[kt,mt]}function V$1(rt,it,ct,dt,ut,pt,yt,ft,mt){const kt=pt+G$1(.1,mt),_t=[];_t.push([G$1(ft,mt)+it+.9*dt*Math.cos(kt-rt),G$1(ft,mt)+ct+.9*ut*Math.sin(kt-rt)]);for(let vt=kt;vt<=yt;vt+=rt)_t.push([G$1(ft,mt)+it+dt*Math.cos(vt),G$1(ft,mt)+ct+ut*Math.sin(vt)]);return _t.push([it+dt*Math.cos(yt),ct+ut*Math.sin(yt)]),_t.push([it+dt*Math.cos(yt),ct+ut*Math.sin(yt)]),q$1(_t,null,mt)}function Z$1(rt,it,ct,dt,ut,pt,yt,ft){const mt=[],kt=[ft.maxRandomnessOffset||1,(ft.maxRandomnessOffset||1)+.3];let _t=[0,0];const vt=ft.disableMultiStroke?1:2,bt=ft.preserveVertices;for(let Mt=0;Mt<vt;Mt++)Mt===0?mt.push({op:"move",data:[yt[0],yt[1]]}):mt.push({op:"move",data:[yt[0]+(bt?0:G$1(kt[0],ft)),yt[1]+(bt?0:G$1(kt[0],ft))]}),_t=bt?[ut,pt]:[ut+G$1(kt[Mt],ft),pt+G$1(kt[Mt],ft)],mt.push({op:"bcurveTo",data:[rt+G$1(kt[Mt],ft),it+G$1(kt[Mt],ft),ct+G$1(kt[Mt],ft),dt+G$1(kt[Mt],ft),_t[0],_t[1]]});return mt}function Q$1(rt){return[...rt]}function H$1(rt,it=0){const ct=rt.length;if(ct<3)throw new Error("A curve must have at least three points.");const dt=[];if(ct===3)dt.push(Q$1(rt[0]),Q$1(rt[1]),Q$1(rt[2]),Q$1(rt[2]));else{const ut=[];ut.push(rt[0],rt[0]);for(let ft=1;ft<rt.length;ft++)ut.push(rt[ft]),ft===rt.length-1&&ut.push(rt[ft]);const pt=[],yt=1-it;dt.push(Q$1(ut[0]));for(let ft=1;ft+2<ut.length;ft++){const mt=ut[ft];pt[0]=[mt[0],mt[1]],pt[1]=[mt[0]+(yt*ut[ft+1][0]-yt*ut[ft-1][0])/6,mt[1]+(yt*ut[ft+1][1]-yt*ut[ft-1][1])/6],pt[2]=[ut[ft+1][0]+(yt*ut[ft][0]-yt*ut[ft+2][0])/6,ut[ft+1][1]+(yt*ut[ft][1]-yt*ut[ft+2][1])/6],pt[3]=[ut[ft+1][0],ut[ft+1][1]],dt.push(pt[1],pt[2],pt[3])}}return dt}function N$1(rt,it){return Math.pow(rt[0]-it[0],2)+Math.pow(rt[1]-it[1],2)}function B$1(rt,it,ct){const dt=N$1(it,ct);if(dt===0)return N$1(rt,it);let ut=((rt[0]-it[0])*(ct[0]-it[0])+(rt[1]-it[1])*(ct[1]-it[1]))/dt;return ut=Math.max(0,Math.min(1,ut)),N$1(rt,J$1(it,ct,ut))}function J$1(rt,it,ct){return[rt[0]+(it[0]-rt[0])*ct,rt[1]+(it[1]-rt[1])*ct]}function K$1(rt,it,ct,dt){const ut=dt||[];if((function(ft,mt){const kt=ft[mt+0],_t=ft[mt+1],vt=ft[mt+2],bt=ft[mt+3];let Mt=3*_t[0]-2*kt[0]-bt[0];Mt*=Mt;let wt=3*_t[1]-2*kt[1]-bt[1];wt*=wt;let St=3*vt[0]-2*bt[0]-kt[0];St*=St;let It=3*vt[1]-2*bt[1]-kt[1];return It*=It,Mt<St&&(Mt=St),wt<It&&(wt=It),Mt+wt})(rt,it)<ct){const ft=rt[it+0];ut.length?(pt=ut[ut.length-1],yt=ft,Math.sqrt(N$1(pt,yt))>1&&ut.push(ft)):ut.push(ft),ut.push(rt[it+3])}else{const mt=rt[it+0],kt=rt[it+1],_t=rt[it+2],vt=rt[it+3],bt=J$1(mt,kt,.5),Mt=J$1(kt,_t,.5),wt=J$1(_t,vt,.5),St=J$1(bt,Mt,.5),It=J$1(Mt,wt,.5),Nt=J$1(St,It,.5);K$1([mt,bt,St,Nt],0,ct,ut),K$1([Nt,It,wt,vt],0,ct,ut)}var pt,yt;return ut}function U$1(rt,it){return X$1(rt,0,rt.length,it)}function X$1(rt,it,ct,dt,ut){const pt=ut||[],yt=rt[it],ft=rt[ct-1];let mt=0,kt=1;for(let _t=it+1;_t<ct-1;++_t){const vt=B$1(rt[_t],yt,ft);vt>mt&&(mt=vt,kt=_t)}return Math.sqrt(mt)>dt?(X$1(rt,it,kt+1,dt,pt),X$1(rt,kt,ct,dt,pt)):(pt.length||pt.push(yt),pt.push(ft)),pt}function Y$1(rt,it=.15,ct){const dt=[],ut=(rt.length-1)/3;for(let pt=0;pt<ut;pt++)K$1(rt,3*pt,it,dt);return ct&&ct>0?X$1(dt,0,dt.length,ct):dt}const tt="none";class et{constructor(it){this.defaultOptions={maxRandomnessOffset:2,roughness:1,bowing:1,stroke:"#000",strokeWidth:1,curveTightness:0,curveFitting:.95,curveStepCount:9,fillStyle:"hachure",fillWeight:-1,hachureAngle:-41,hachureGap:-1,dashOffset:-1,dashGap:-1,zigzagOffset:-1,seed:0,disableMultiStroke:!1,disableMultiStrokeFill:!1,preserveVertices:!1,fillShapeRoughnessGain:.8},this.config=it||{},this.config.options&&(this.defaultOptions=this._o(this.config.options))}static newSeed(){return Math.floor(Math.random()*2**31)}_o(it){return it?Object.assign({},this.defaultOptions,it):this.defaultOptions}_d(it,ct,dt){return{shape:it,sets:ct||[],options:dt||this.defaultOptions}}line(it,ct,dt,ut,pt){const yt=this._o(pt);return this._d("line",[v$1(it,ct,dt,ut,yt)],yt)}rectangle(it,ct,dt,ut,pt){const yt=this._o(pt),ft=[],mt=O$1(it,ct,dt,ut,yt);if(yt.fill){const kt=[[it,ct],[it+dt,ct],[it+dt,ct+ut],[it,ct+ut]];yt.fillStyle==="solid"?ft.push(I$1([kt],yt)):ft.push(C$1([kt],yt))}return yt.stroke!==tt&&ft.push(mt),this._d("rectangle",ft,yt)}ellipse(it,ct,dt,ut,pt){const yt=this._o(pt),ft=[],mt=T$1(dt,ut,yt),kt=D$1(it,ct,yt,mt);if(yt.fill)if(yt.fillStyle==="solid"){const _t=D$1(it,ct,yt,mt).opset;_t.type="fillPath",ft.push(_t)}else ft.push(C$1([kt.estimatedPoints],yt));return yt.stroke!==tt&&ft.push(kt.opset),this._d("ellipse",ft,yt)}circle(it,ct,dt,ut){const pt=this.ellipse(it,ct,dt,dt,ut);return pt.shape="circle",pt}linearPath(it,ct){const dt=this._o(ct);return this._d("linearPath",[S$1(it,!1,dt)],dt)}arc(it,ct,dt,ut,pt,yt,ft=!1,mt){const kt=this._o(mt),_t=[],vt=A$1(it,ct,dt,ut,pt,yt,ft,!0,kt);if(ft&&kt.fill)if(kt.fillStyle==="solid"){const bt=Object.assign({},kt);bt.disableMultiStroke=!0;const Mt=A$1(it,ct,dt,ut,pt,yt,!0,!1,bt);Mt.type="fillPath",_t.push(Mt)}else _t.push((function(bt,Mt,wt,St,It,Nt,$t){const Et=bt,Ft=Mt;let qt=Math.abs(wt/2),Ht=Math.abs(St/2);qt+=G$1(.01*qt,$t),Ht+=G$1(.01*Ht,$t);let Ot=It,Zt=Nt;for(;Ot<0;)Ot+=2*Math.PI,Zt+=2*Math.PI;Zt-Ot>2*Math.PI&&(Ot=0,Zt=2*Math.PI);const Yt=(Zt-Ot)/$t.curveStepCount,aa=[];for(let Qt=Ot;Qt<=Zt;Qt+=Yt)aa.push([Et+qt*Math.cos(Qt),Ft+Ht*Math.sin(Qt)]);return aa.push([Et+qt*Math.cos(Zt),Ft+Ht*Math.sin(Zt)]),aa.push([Et,Ft]),C$1([aa],$t)})(it,ct,dt,ut,pt,yt,kt));return kt.stroke!==tt&&_t.push(vt),this._d("arc",_t,kt)}curve(it,ct){const dt=this._o(ct),ut=[],pt=L$1(it,dt);if(dt.fill&&dt.fill!==tt)if(dt.fillStyle==="solid"){const yt=L$1(it,Object.assign(Object.assign({},dt),{disableMultiStroke:!0,roughness:dt.roughness?dt.roughness+dt.fillShapeRoughnessGain:0}));ut.push({type:"fillPath",ops:this._mergedShape(yt.ops)})}else{const yt=[],ft=it;if(ft.length){const mt=typeof ft[0][0]=="number"?[ft]:ft;for(const kt of mt)kt.length<3?yt.push(...kt):kt.length===3?yt.push(...Y$1(H$1([kt[0],kt[0],kt[1],kt[2]]),10,(1+dt.roughness)/2)):yt.push(...Y$1(H$1(kt),10,(1+dt.roughness)/2))}yt.length&&ut.push(C$1([yt],dt))}return dt.stroke!==tt&&ut.push(pt),this._d("curve",ut,dt)}polygon(it,ct){const dt=this._o(ct),ut=[],pt=S$1(it,!0,dt);return dt.fill&&(dt.fillStyle==="solid"?ut.push(I$1([it],dt)):ut.push(C$1([it],dt))),dt.stroke!==tt&&ut.push(pt),this._d("polygon",ut,dt)}path(it,ct){const dt=this._o(ct),ut=[];if(!it)return this._d("path",ut,dt);it=(it||"").replace(/\n/g," ").replace(/(-\s)/g,"-").replace("/(ss)/g"," ");const pt=dt.fill&&dt.fill!=="transparent"&&dt.fill!==tt,yt=dt.stroke!==tt,ft=!!(dt.simplification&&dt.simplification<1),mt=(function(_t,vt,bt){const Mt=m$1(y$1(b$1(_t))),wt=[];let St=[],It=[0,0],Nt=[];const $t=()=>{Nt.length>=4&&St.push(...Y$1(Nt,vt)),Nt=[]},Et=()=>{$t(),St.length&&(wt.push(St),St=[])};for(const{key:qt,data:Ht}of Mt)switch(qt){case"M":Et(),It=[Ht[0],Ht[1]],St.push(It);break;case"L":$t(),St.push([Ht[0],Ht[1]]);break;case"C":if(!Nt.length){const Ot=St.length?St[St.length-1]:It;Nt.push([Ot[0],Ot[1]])}Nt.push([Ht[0],Ht[1]]),Nt.push([Ht[2],Ht[3]]),Nt.push([Ht[4],Ht[5]]);break;case"Z":$t(),St.push([It[0],It[1]])}if(Et(),!bt)return wt;const Ft=[];for(const qt of wt){const Ht=U$1(qt,bt);Ht.length&&Ft.push(Ht)}return Ft})(it,1,ft?4-4*(dt.simplification||1):(1+dt.roughness)/2),kt=_$1(it,dt);if(pt)if(dt.fillStyle==="solid")if(mt.length===1){const _t=_$1(it,Object.assign(Object.assign({},dt),{disableMultiStroke:!0,roughness:dt.roughness?dt.roughness+dt.fillShapeRoughnessGain:0}));ut.push({type:"fillPath",ops:this._mergedShape(_t.ops)})}else ut.push(I$1(mt,dt));else ut.push(C$1(mt,dt));return yt&&(ft?mt.forEach((_t=>{ut.push(S$1(_t,!1,dt))})):ut.push(kt)),this._d("path",ut,dt)}opsToPath(it,ct){let dt="";for(const ut of it.ops){const pt=typeof ct=="number"&&ct>=0?ut.data.map((yt=>+yt.toFixed(ct))):ut.data;switch(ut.op){case"move":dt+=`M${pt[0]} ${pt[1]} `;break;case"bcurveTo":dt+=`C${pt[0]} ${pt[1]}, ${pt[2]} ${pt[3]}, ${pt[4]} ${pt[5]} `;break;case"lineTo":dt+=`L${pt[0]} ${pt[1]} `}}return dt.trim()}toPaths(it){const ct=it.sets||[],dt=it.options||this.defaultOptions,ut=[];for(const pt of ct){let yt=null;switch(pt.type){case"path":yt={d:this.opsToPath(pt),stroke:dt.stroke,strokeWidth:dt.strokeWidth,fill:tt};break;case"fillPath":yt={d:this.opsToPath(pt),stroke:tt,strokeWidth:0,fill:dt.fill||tt};break;case"fillSketch":yt=this.fillSketch(pt,dt)}yt&&ut.push(yt)}return ut}fillSketch(it,ct){let dt=ct.fillWeight;return dt<0&&(dt=ct.strokeWidth/2),{d:this.opsToPath(it),stroke:ct.fill||tt,strokeWidth:dt,fill:tt}}_mergedShape(it){return it.filter(((ct,dt)=>dt===0||ct.op!=="move"))}}class st{constructor(it,ct){this.canvas=it,this.ctx=this.canvas.getContext("2d"),this.gen=new et(ct)}draw(it){const ct=it.sets||[],dt=it.options||this.getDefaultOptions(),ut=this.ctx,pt=it.options.fixedDecimalPlaceDigits;for(const yt of ct)switch(yt.type){case"path":ut.save(),ut.strokeStyle=dt.stroke==="none"?"transparent":dt.stroke,ut.lineWidth=dt.strokeWidth,dt.strokeLineDash&&ut.setLineDash(dt.strokeLineDash),dt.strokeLineDashOffset&&(ut.lineDashOffset=dt.strokeLineDashOffset),this._drawToContext(ut,yt,pt),ut.restore();break;case"fillPath":{ut.save(),ut.fillStyle=dt.fill||"";const ft=it.shape==="curve"||it.shape==="polygon"||it.shape==="path"?"evenodd":"nonzero";this._drawToContext(ut,yt,pt,ft),ut.restore();break}case"fillSketch":this.fillSketch(ut,yt,dt)}}fillSketch(it,ct,dt){let ut=dt.fillWeight;ut<0&&(ut=dt.strokeWidth/2),it.save(),dt.fillLineDash&&it.setLineDash(dt.fillLineDash),dt.fillLineDashOffset&&(it.lineDashOffset=dt.fillLineDashOffset),it.strokeStyle=dt.fill||"",it.lineWidth=ut,this._drawToContext(it,ct,dt.fixedDecimalPlaceDigits),it.restore()}_drawToContext(it,ct,dt,ut="nonzero"){it.beginPath();for(const pt of ct.ops){const yt=typeof dt=="number"&&dt>=0?pt.data.map((ft=>+ft.toFixed(dt))):pt.data;switch(pt.op){case"move":it.moveTo(yt[0],yt[1]);break;case"bcurveTo":it.bezierCurveTo(yt[0],yt[1],yt[2],yt[3],yt[4],yt[5]);break;case"lineTo":it.lineTo(yt[0],yt[1])}}ct.type==="fillPath"?it.fill(ut):it.stroke()}get generator(){return this.gen}getDefaultOptions(){return this.gen.defaultOptions}line(it,ct,dt,ut,pt){const yt=this.gen.line(it,ct,dt,ut,pt);return this.draw(yt),yt}rectangle(it,ct,dt,ut,pt){const yt=this.gen.rectangle(it,ct,dt,ut,pt);return this.draw(yt),yt}ellipse(it,ct,dt,ut,pt){const yt=this.gen.ellipse(it,ct,dt,ut,pt);return this.draw(yt),yt}circle(it,ct,dt,ut){const pt=this.gen.circle(it,ct,dt,ut);return this.draw(pt),pt}linearPath(it,ct){const dt=this.gen.linearPath(it,ct);return this.draw(dt),dt}polygon(it,ct){const dt=this.gen.polygon(it,ct);return this.draw(dt),dt}arc(it,ct,dt,ut,pt,yt,ft=!1,mt){const kt=this.gen.arc(it,ct,dt,ut,pt,yt,ft,mt);return this.draw(kt),kt}curve(it,ct){const dt=this.gen.curve(it,ct);return this.draw(dt),dt}path(it,ct){const dt=this.gen.path(it,ct);return this.draw(dt),dt}}const nt="http://www.w3.org/2000/svg";class ot{constructor(it,ct){this.svg=it,this.gen=new et(ct)}draw(it){const ct=it.sets||[],dt=it.options||this.getDefaultOptions(),ut=this.svg.ownerDocument||window.document,pt=ut.createElementNS(nt,"g"),yt=it.options.fixedDecimalPlaceDigits;for(const ft of ct){let mt=null;switch(ft.type){case"path":mt=ut.createElementNS(nt,"path"),mt.setAttribute("d",this.opsToPath(ft,yt)),mt.setAttribute("stroke",dt.stroke),mt.setAttribute("stroke-width",dt.strokeWidth+""),mt.setAttribute("fill","none"),dt.strokeLineDash&&mt.setAttribute("stroke-dasharray",dt.strokeLineDash.join(" ").trim()),dt.strokeLineDashOffset&&mt.setAttribute("stroke-dashoffset",`${dt.strokeLineDashOffset}`);break;case"fillPath":mt=ut.createElementNS(nt,"path"),mt.setAttribute("d",this.opsToPath(ft,yt)),mt.setAttribute("stroke","none"),mt.setAttribute("stroke-width","0"),mt.setAttribute("fill",dt.fill||""),it.shape!=="curve"&&it.shape!=="polygon"||mt.setAttribute("fill-rule","evenodd");break;case"fillSketch":mt=this.fillSketch(ut,ft,dt)}mt&&pt.appendChild(mt)}return pt}fillSketch(it,ct,dt){let ut=dt.fillWeight;ut<0&&(ut=dt.strokeWidth/2);const pt=it.createElementNS(nt,"path");return pt.setAttribute("d",this.opsToPath(ct,dt.fixedDecimalPlaceDigits)),pt.setAttribute("stroke",dt.fill||""),pt.setAttribute("stroke-width",ut+""),pt.setAttribute("fill","none"),dt.fillLineDash&&pt.setAttribute("stroke-dasharray",dt.fillLineDash.join(" ").trim()),dt.fillLineDashOffset&&pt.setAttribute("stroke-dashoffset",`${dt.fillLineDashOffset}`),pt}get generator(){return this.gen}getDefaultOptions(){return this.gen.defaultOptions}opsToPath(it,ct){return this.gen.opsToPath(it,ct)}line(it,ct,dt,ut,pt){const yt=this.gen.line(it,ct,dt,ut,pt);return this.draw(yt)}rectangle(it,ct,dt,ut,pt){const yt=this.gen.rectangle(it,ct,dt,ut,pt);return this.draw(yt)}ellipse(it,ct,dt,ut,pt){const yt=this.gen.ellipse(it,ct,dt,ut,pt);return this.draw(yt)}circle(it,ct,dt,ut){const pt=this.gen.circle(it,ct,dt,ut);return this.draw(pt)}linearPath(it,ct){const dt=this.gen.linearPath(it,ct);return this.draw(dt)}polygon(it,ct){const dt=this.gen.polygon(it,ct);return this.draw(dt)}arc(it,ct,dt,ut,pt,yt,ft=!1,mt){const kt=this.gen.arc(it,ct,dt,ut,pt,yt,ft,mt);return this.draw(kt)}curve(it,ct){const dt=this.gen.curve(it,ct);return this.draw(dt)}path(it,ct){const dt=this.gen.path(it,ct);return this.draw(dt)}}var at={canvas:(rt,it)=>new st(rt,it),svg:(rt,it)=>new ot(rt,it),generator:rt=>new et(rt),newSeed:()=>et.newSeed()},labelHelper=__name(async(rt,it,ct)=>{let dt;const ut=it.useHtmlLabels||evaluate(getConfig2()?.htmlLabels);ct?dt=ct:dt="node default";const pt=rt.insert("g").attr("class",dt).attr("id",it.domId||it.id),yt=pt.insert("g").attr("class","label").attr("style",handleUndefinedAttr(it.labelStyle));let ft;it.label===void 0?ft="":ft=typeof it.label=="string"?it.label:it.label[0];const mt=await createText(yt,sanitizeText(decodeEntities(ft),getConfig2()),{useHtmlLabels:ut,width:it.width||getConfig2().flowchart?.wrappingWidth,cssClasses:"markdown-node-label",style:it.labelStyle,addSvgBackground:!!it.icon||!!it.img});let kt=mt.getBBox();const _t=(it?.padding??0)/2;if(ut){const vt=mt.children[0],bt=select(mt),Mt=vt.getElementsByTagName("img");if(Mt){const wt=ft.replace(/<img[^>]*>/g,"").trim()==="";await Promise.all([...Mt].map(St=>new Promise(It=>{function Nt(){if(St.style.display="flex",St.style.flexDirection="column",wt){const $t=getConfig2().fontSize?getConfig2().fontSize:window.getComputedStyle(document.body).fontSize,Et=5,[Ft=defaultConfig_default.fontSize]=parseFontSize($t),qt=Ft*Et+"px";St.style.minWidth=qt,St.style.maxWidth=qt}else St.style.width="100%";It(St)}__name(Nt,"setupImage"),setTimeout(()=>{St.complete&&Nt()}),St.addEventListener("error",Nt),St.addEventListener("load",Nt)})))}kt=vt.getBoundingClientRect(),bt.attr("width",kt.width),bt.attr("height",kt.height)}return ut?yt.attr("transform","translate("+-kt.width/2+", "+-kt.height/2+")"):yt.attr("transform","translate(0, "+-kt.height/2+")"),it.centerLabel&&yt.attr("transform","translate("+-kt.width/2+", "+-kt.height/2+")"),yt.insert("rect",":first-child"),{shapeSvg:pt,bbox:kt,halfPadding:_t,label:yt}},"labelHelper"),insertLabel=__name(async(rt,it,ct)=>{const dt=ct.useHtmlLabels||evaluate(getConfig2()?.flowchart?.htmlLabels),ut=rt.insert("g").attr("class","label").attr("style",ct.labelStyle||""),pt=await createText(ut,sanitizeText(decodeEntities(it),getConfig2()),{useHtmlLabels:dt,width:ct.width||getConfig2()?.flowchart?.wrappingWidth,style:ct.labelStyle,addSvgBackground:!!ct.icon||!!ct.img});let yt=pt.getBBox();const ft=ct.padding/2;if(evaluate(getConfig2()?.flowchart?.htmlLabels)){const mt=pt.children[0],kt=select(pt);yt=mt.getBoundingClientRect(),kt.attr("width",yt.width),kt.attr("height",yt.height)}return dt?ut.attr("transform","translate("+-yt.width/2+", "+-yt.height/2+")"):ut.attr("transform","translate(0, "+-yt.height/2+")"),ct.centerLabel&&ut.attr("transform","translate("+-yt.width/2+", "+-yt.height/2+")"),ut.insert("rect",":first-child"),{shapeSvg:rt,bbox:yt,halfPadding:ft,label:ut}},"insertLabel"),updateNodeBounds=__name((rt,it)=>{const ct=it.node().getBBox();rt.width=ct.width,rt.height=ct.height},"updateNodeBounds"),getNodeClasses=__name((rt,it)=>(rt.look==="handDrawn"?"rough-node":"node")+" "+rt.cssClasses+" "+(it||""),"getNodeClasses");function createPathFromPoints(rt){const it=rt.map((ct,dt)=>`${dt===0?"M":"L"}${ct.x},${ct.y}`);return it.push("Z"),it.join(" ")}__name(createPathFromPoints,"createPathFromPoints");function generateFullSineWavePoints(rt,it,ct,dt,ut,pt){const yt=[],mt=ct-rt,kt=dt-it,_t=mt/pt,vt=2*Math.PI/_t,bt=it+kt/2;for(let Mt=0;Mt<=50;Mt++){const wt=Mt/50,St=rt+wt*mt,It=bt+ut*Math.sin(vt*(St-rt));yt.push({x:St,y:It})}return yt}__name(generateFullSineWavePoints,"generateFullSineWavePoints");function generateCirclePoints(rt,it,ct,dt,ut,pt){const yt=[],ft=ut*Math.PI/180,_t=(pt*Math.PI/180-ft)/(dt-1);for(let vt=0;vt<dt;vt++){const bt=ft+vt*_t,Mt=rt+ct*Math.cos(bt),wt=it+ct*Math.sin(bt);yt.push({x:-Mt,y:-wt})}return yt}__name(generateCirclePoints,"generateCirclePoints");var intersectRect=__name((rt,it)=>{var ct=rt.x,dt=rt.y,ut=it.x-ct,pt=it.y-dt,yt=rt.width/2,ft=rt.height/2,mt,kt;return Math.abs(pt)*yt>Math.abs(ut)*ft?(pt<0&&(ft=-ft),mt=pt===0?0:ft*ut/pt,kt=ft):(ut<0&&(yt=-yt),mt=yt,kt=ut===0?0:yt*pt/ut),{x:ct+mt,y:dt+kt}},"intersectRect"),intersect_rect_default=intersectRect;function applyStyle(rt,it){it&&rt.attr("style",it)}__name(applyStyle,"applyStyle");async function addHtmlLabel(rt){const it=select(document.createElementNS("http://www.w3.org/2000/svg","foreignObject")),ct=it.append("xhtml:div"),dt=getConfig2();let ut=rt.label;rt.label&&hasKatex(rt.label)&&(ut=await renderKatexSanitized(rt.label.replace(common_default.lineBreakRegex,`
-`),dt));const yt='<span class="'+(rt.isNode?"nodeLabel":"edgeLabel")+'" '+(rt.labelStyle?'style="'+rt.labelStyle+'"':"")+">"+ut+"</span>";return ct.html(sanitizeText(yt,dt)),applyStyle(ct,rt.labelStyle),ct.style("display","inline-block"),ct.style("padding-right","1px"),ct.style("white-space","nowrap"),ct.attr("xmlns","http://www.w3.org/1999/xhtml"),it.node()}__name(addHtmlLabel,"addHtmlLabel");var createLabel=__name(async(rt,it,ct,dt)=>{let ut=rt||"";if(typeof ut=="object"&&(ut=ut[0]),evaluate(getConfig2().flowchart.htmlLabels)){ut=ut.replace(/\\n|\n/g,"<br />"),log.info("vertexText"+ut);const pt={isNode:dt,label:decodeEntities(ut).replace(/fa[blrs]?:fa-[\w-]+/g,ft=>`<i class='${ft.replace(":"," ")}'></i>`),labelStyle:it&&it.replace("fill:","color:")};return await addHtmlLabel(pt)}else{const pt=document.createElementNS("http://www.w3.org/2000/svg","text");pt.setAttribute("style",it.replace("color:","fill:"));let yt=[];typeof ut=="string"?yt=ut.split(/\\n|\n|<br\s*\/?>/gi):Array.isArray(ut)?yt=ut:yt=[];for(const ft of yt){const mt=document.createElementNS("http://www.w3.org/2000/svg","tspan");mt.setAttributeNS("http://www.w3.org/XML/1998/namespace","xml:space","preserve"),mt.setAttribute("dy","1em"),mt.setAttribute("x","0"),ct?mt.setAttribute("class","title-row"):mt.setAttribute("class","row"),mt.textContent=ft.trim(),pt.appendChild(mt)}return pt}},"createLabel"),createLabel_default=createLabel,createRoundedRectPathD=__name((rt,it,ct,dt,ut)=>["M",rt+ut,it,"H",rt+ct-ut,"A",ut,ut,0,0,1,rt+ct,it+ut,"V",it+dt-ut,"A",ut,ut,0,0,1,rt+ct-ut,it+dt,"H",rt+ut,"A",ut,ut,0,0,1,rt,it+dt-ut,"V",it+ut,"A",ut,ut,0,0,1,rt+ut,it,"Z"].join(" "),"createRoundedRectPathD"),rect=__name(async(rt,it)=>{log.info("Creating subgraph rect for ",it.id,it);const ct=getConfig2(),{themeVariables:dt,handDrawnSeed:ut}=ct,{clusterBkg:pt,clusterBorder:yt}=dt,{labelStyles:ft,nodeStyles:mt,borderStyles:kt,backgroundStyles:_t}=styles2String(it),vt=rt.insert("g").attr("class","cluster "+it.cssClasses).attr("id",it.id).attr("data-look",it.look),bt=evaluate(ct.flowchart.htmlLabels),Mt=vt.insert("g").attr("class","cluster-label "),wt=await createText(Mt,it.label,{style:it.labelStyle,useHtmlLabels:bt,isNode:!0});let St=wt.getBBox();if(evaluate(ct.flowchart.htmlLabels)){const Ot=wt.children[0],Zt=select(wt);St=Ot.getBoundingClientRect(),Zt.attr("width",St.width),Zt.attr("height",St.height)}const It=it.width<=St.width+it.padding?St.width+it.padding:it.width;it.width<=St.width+it.padding?it.diff=(It-it.width)/2-it.padding:it.diff=-it.padding;const Nt=it.height,$t=it.x-It/2,Et=it.y-Nt/2;log.trace("Data ",it,JSON.stringify(it));let Ft;if(it.look==="handDrawn"){const Ot=at.svg(vt),Zt=userNodeOverrides(it,{roughness:.7,fill:pt,stroke:yt,fillWeight:3,seed:ut}),Yt=Ot.path(createRoundedRectPathD($t,Et,It,Nt,0),Zt);Ft=vt.insert(()=>(log.debug("Rough node insert CXC",Yt),Yt),":first-child"),Ft.select("path:nth-child(2)").attr("style",kt.join(";")),Ft.select("path").attr("style",_t.join(";").replace("fill","stroke"))}else Ft=vt.insert("rect",":first-child"),Ft.attr("style",mt).attr("rx",it.rx).attr("ry",it.ry).attr("x",$t).attr("y",Et).attr("width",It).attr("height",Nt);const{subGraphTitleTopMargin:qt}=getSubGraphTitleMargins(ct);if(Mt.attr("transform",`translate(${it.x-St.width/2}, ${it.y-it.height/2+qt})`),ft){const Ot=Mt.select("span");Ot&&Ot.attr("style",ft)}const Ht=Ft.node().getBBox();return it.offsetX=0,it.width=Ht.width,it.height=Ht.height,it.offsetY=St.height-it.padding/2,it.intersect=function(Ot){return intersect_rect_default(it,Ot)},{cluster:vt,labelBBox:St}},"rect"),noteGroup=__name((rt,it)=>{const ct=rt.insert("g").attr("class","note-cluster").attr("id",it.id),dt=ct.insert("rect",":first-child"),ut=0*it.padding,pt=ut/2;dt.attr("rx",it.rx).attr("ry",it.ry).attr("x",it.x-it.width/2-pt).attr("y",it.y-it.height/2-pt).attr("width",it.width+ut).attr("height",it.height+ut).attr("fill","none");const yt=dt.node().getBBox();return it.width=yt.width,it.height=yt.height,it.intersect=function(ft){return intersect_rect_default(it,ft)},{cluster:ct,labelBBox:{width:0,height:0}}},"noteGroup"),roundedWithTitle=__name(async(rt,it)=>{const ct=getConfig2(),{themeVariables:dt,handDrawnSeed:ut}=ct,{altBackground:pt,compositeBackground:yt,compositeTitleBackground:ft,nodeBorder:mt}=dt,kt=rt.insert("g").attr("class",it.cssClasses).attr("id",it.id).attr("data-id",it.id).attr("data-look",it.look),_t=kt.insert("g",":first-child"),vt=kt.insert("g").attr("class","cluster-label");let bt=kt.append("rect");const Mt=vt.node().appendChild(await createLabel_default(it.label,it.labelStyle,void 0,!0));let wt=Mt.getBBox();if(evaluate(ct.flowchart.htmlLabels)){const Yt=Mt.children[0],aa=select(Mt);wt=Yt.getBoundingClientRect(),aa.attr("width",wt.width),aa.attr("height",wt.height)}const St=0*it.padding,It=St/2,Nt=(it.width<=wt.width+it.padding?wt.width+it.padding:it.width)+St;it.width<=wt.width+it.padding?it.diff=(Nt-it.width)/2-it.padding:it.diff=-it.padding;const $t=it.height+St,Et=it.height+St-wt.height-6,Ft=it.x-Nt/2,qt=it.y-$t/2;it.width=Nt;const Ht=it.y-it.height/2-It+wt.height+2;let Ot;if(it.look==="handDrawn"){const Yt=it.cssClasses.includes("statediagram-cluster-alt"),aa=at.svg(kt),Qt=it.rx||it.ry?aa.path(createRoundedRectPathD(Ft,qt,Nt,$t,10),{roughness:.7,fill:ft,fillStyle:"solid",stroke:mt,seed:ut}):aa.rectangle(Ft,qt,Nt,$t,{seed:ut});Ot=kt.insert(()=>Qt,":first-child");const oa=aa.rectangle(Ft,Ht,Nt,Et,{fill:Yt?pt:yt,fillStyle:Yt?"hachure":"solid",stroke:mt,seed:ut});Ot=kt.insert(()=>Qt,":first-child"),bt=kt.insert(()=>oa)}else Ot=_t.insert("rect",":first-child"),Ot.attr("class","outer").attr("x",Ft).attr("y",qt).attr("width",Nt).attr("height",$t).attr("data-look",it.look),bt.attr("class","inner").attr("x",Ft).attr("y",Ht).attr("width",Nt).attr("height",Et);vt.attr("transform",`translate(${it.x-wt.width/2}, ${qt+1-(evaluate(ct.flowchart.htmlLabels)?0:3)})`);const Zt=Ot.node().getBBox();return it.height=Zt.height,it.offsetX=0,it.offsetY=wt.height-it.padding/2,it.labelBBox=wt,it.intersect=function(Yt){return intersect_rect_default(it,Yt)},{cluster:kt,labelBBox:wt}},"roundedWithTitle"),kanbanSection=__name(async(rt,it)=>{log.info("Creating subgraph rect for ",it.id,it);const ct=getConfig2(),{themeVariables:dt,handDrawnSeed:ut}=ct,{clusterBkg:pt,clusterBorder:yt}=dt,{labelStyles:ft,nodeStyles:mt,borderStyles:kt,backgroundStyles:_t}=styles2String(it),vt=rt.insert("g").attr("class","cluster "+it.cssClasses).attr("id",it.id).attr("data-look",it.look),bt=evaluate(ct.flowchart.htmlLabels),Mt=vt.insert("g").attr("class","cluster-label "),wt=await createText(Mt,it.label,{style:it.labelStyle,useHtmlLabels:bt,isNode:!0,width:it.width});let St=wt.getBBox();if(evaluate(ct.flowchart.htmlLabels)){const Ot=wt.children[0],Zt=select(wt);St=Ot.getBoundingClientRect(),Zt.attr("width",St.width),Zt.attr("height",St.height)}const It=it.width<=St.width+it.padding?St.width+it.padding:it.width;it.width<=St.width+it.padding?it.diff=(It-it.width)/2-it.padding:it.diff=-it.padding;const Nt=it.height,$t=it.x-It/2,Et=it.y-Nt/2;log.trace("Data ",it,JSON.stringify(it));let Ft;if(it.look==="handDrawn"){const Ot=at.svg(vt),Zt=userNodeOverrides(it,{roughness:.7,fill:pt,stroke:yt,fillWeight:4,seed:ut}),Yt=Ot.path(createRoundedRectPathD($t,Et,It,Nt,it.rx),Zt);Ft=vt.insert(()=>(log.debug("Rough node insert CXC",Yt),Yt),":first-child"),Ft.select("path:nth-child(2)").attr("style",kt.join(";")),Ft.select("path").attr("style",_t.join(";").replace("fill","stroke"))}else Ft=vt.insert("rect",":first-child"),Ft.attr("style",mt).attr("rx",it.rx).attr("ry",it.ry).attr("x",$t).attr("y",Et).attr("width",It).attr("height",Nt);const{subGraphTitleTopMargin:qt}=getSubGraphTitleMargins(ct);if(Mt.attr("transform",`translate(${it.x-St.width/2}, ${it.y-it.height/2+qt})`),ft){const Ot=Mt.select("span");Ot&&Ot.attr("style",ft)}const Ht=Ft.node().getBBox();return it.offsetX=0,it.width=Ht.width,it.height=Ht.height,it.offsetY=St.height-it.padding/2,it.intersect=function(Ot){return intersect_rect_default(it,Ot)},{cluster:vt,labelBBox:St}},"kanbanSection"),divider=__name((rt,it)=>{const ct=getConfig2(),{themeVariables:dt,handDrawnSeed:ut}=ct,{nodeBorder:pt}=dt,yt=rt.insert("g").attr("class",it.cssClasses).attr("id",it.id).attr("data-look",it.look),ft=yt.insert("g",":first-child"),mt=0*it.padding,kt=it.width+mt;it.diff=-it.padding;const _t=it.height+mt,vt=it.x-kt/2,bt=it.y-_t/2;it.width=kt;let Mt;if(it.look==="handDrawn"){const It=at.svg(yt).rectangle(vt,bt,kt,_t,{fill:"lightgrey",roughness:.5,strokeLineDash:[5],stroke:pt,seed:ut});Mt=yt.insert(()=>It,":first-child")}else Mt=ft.insert("rect",":first-child"),Mt.attr("class","divider").attr("x",vt).attr("y",bt).attr("width",kt).attr("height",_t).attr("data-look",it.look);const wt=Mt.node().getBBox();return it.height=wt.height,it.offsetX=0,it.offsetY=0,it.intersect=function(St){return intersect_rect_default(it,St)},{cluster:yt,labelBBox:{}}},"divider"),squareRect=rect,shapes={rect,squareRect,roundedWithTitle,noteGroup,divider,kanbanSection},clusterElems=new Map,insertCluster=__name(async(rt,it)=>{const ct=it.shape||"rect",dt=await shapes[ct](rt,it);return clusterElems.set(it.id,dt),dt},"insertCluster"),clear$1=__name(()=>{clusterElems=new Map},"clear");function intersectNode(rt,it){return rt.intersect(it)}__name(intersectNode,"intersectNode");var intersect_node_default=intersectNode;function intersectEllipse(rt,it,ct,dt){var ut=rt.x,pt=rt.y,yt=ut-dt.x,ft=pt-dt.y,mt=Math.sqrt(it*it*ft*ft+ct*ct*yt*yt),kt=Math.abs(it*ct*yt/mt);dt.x<ut&&(kt=-kt);var _t=Math.abs(it*ct*ft/mt);return dt.y<pt&&(_t=-_t),{x:ut+kt,y:pt+_t}}__name(intersectEllipse,"intersectEllipse");var intersect_ellipse_default=intersectEllipse;function intersectCircle(rt,it,ct){return intersect_ellipse_default(rt,it,it,ct)}__name(intersectCircle,"intersectCircle");var intersect_circle_default=intersectCircle;function intersectLine(rt,it,ct,dt){{const ut=it.y-rt.y,pt=rt.x-it.x,yt=it.x*rt.y-rt.x*it.y,ft=ut*ct.x+pt*ct.y+yt,mt=ut*dt.x+pt*dt.y+yt,kt=1e-6;if(ft!==0&&mt!==0&&sameSign(ft,mt))return;const _t=dt.y-ct.y,vt=ct.x-dt.x,bt=dt.x*ct.y-ct.x*dt.y,Mt=_t*rt.x+vt*rt.y+bt,wt=_t*it.x+vt*it.y+bt;if(Math.abs(Mt)<kt&&Math.abs(wt)<kt&&sameSign(Mt,wt))return;const St=ut*vt-_t*pt;if(St===0)return;const It=Math.abs(St/2);let Nt=pt*bt-vt*yt;const $t=Nt<0?(Nt-It)/St:(Nt+It)/St;Nt=_t*yt-ut*bt;const Et=Nt<0?(Nt-It)/St:(Nt+It)/St;return{x:$t,y:Et}}}__name(intersectLine,"intersectLine");function sameSign(rt,it){return rt*it>0}__name(sameSign,"sameSign");var intersect_line_default=intersectLine;function intersectPolygon(rt,it,ct){let dt=rt.x,ut=rt.y,pt=[],yt=Number.POSITIVE_INFINITY,ft=Number.POSITIVE_INFINITY;typeof it.forEach=="function"?it.forEach(function(_t){yt=Math.min(yt,_t.x),ft=Math.min(ft,_t.y)}):(yt=Math.min(yt,it.x),ft=Math.min(ft,it.y));let mt=dt-rt.width/2-yt,kt=ut-rt.height/2-ft;for(let _t=0;_t<it.length;_t++){let vt=it[_t],bt=it[_t<it.length-1?_t+1:0],Mt=intersect_line_default(rt,ct,{x:mt+vt.x,y:kt+vt.y},{x:mt+bt.x,y:kt+bt.y});Mt&&pt.push(Mt)}return pt.length?(pt.length>1&&pt.sort(function(_t,vt){let bt=_t.x-ct.x,Mt=_t.y-ct.y,wt=Math.sqrt(bt*bt+Mt*Mt),St=vt.x-ct.x,It=vt.y-ct.y,Nt=Math.sqrt(St*St+It*It);return wt<Nt?-1:wt===Nt?0:1}),pt[0]):rt}__name(intersectPolygon,"intersectPolygon");var intersect_polygon_default=intersectPolygon,intersect_default={node:intersect_node_default,circle:intersect_circle_default,ellipse:intersect_ellipse_default,polygon:intersect_polygon_default,rect:intersect_rect_default};function anchor(rt,it){const{labelStyles:ct}=styles2String(it);it.labelStyle=ct;const dt=getNodeClasses(it);let ut=dt;dt||(ut="anchor");const pt=rt.insert("g").attr("class",ut).attr("id",it.domId||it.id),yt=1,{cssStyles:ft}=it,mt=at.svg(pt),kt=userNodeOverrides(it,{fill:"black",stroke:"none",fillStyle:"solid"});it.look!=="handDrawn"&&(kt.roughness=0);const _t=mt.circle(0,0,yt*2,kt),vt=pt.insert(()=>_t,":first-child");return vt.attr("class","anchor").attr("style",handleUndefinedAttr(ft)),updateNodeBounds(it,vt),it.intersect=function(bt){return log.info("Circle intersect",it,yt,bt),intersect_default.circle(it,yt,bt)},pt}__name(anchor,"anchor");function generateArcPoints(rt,it,ct,dt,ut,pt,yt){const mt=(rt+ct)/2,kt=(it+dt)/2,_t=Math.atan2(dt-it,ct-rt),vt=(ct-rt)/2,bt=(dt-it)/2,Mt=vt/ut,wt=bt/pt,St=Math.sqrt(Mt**2+wt**2);if(St>1)throw new Error("The given radii are too small to create an arc between the points.");const It=Math.sqrt(1-St**2),Nt=mt+It*pt*Math.sin(_t)*(yt?-1:1),$t=kt-It*ut*Math.cos(_t)*(yt?-1:1),Et=Math.atan2((it-$t)/pt,(rt-Nt)/ut);let qt=Math.atan2((dt-$t)/pt,(ct-Nt)/ut)-Et;yt&&qt<0&&(qt+=2*Math.PI),!yt&&qt>0&&(qt-=2*Math.PI);const Ht=[];for(let Ot=0;Ot<20;Ot++){const Zt=Ot/19,Yt=Et+Zt*qt,aa=Nt+ut*Math.cos(Yt),Qt=$t+pt*Math.sin(Yt);Ht.push({x:aa,y:Qt})}return Ht}__name(generateArcPoints,"generateArcPoints");async function bowTieRect(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt}=await labelHelper(rt,it,getNodeClasses(it)),yt=pt.width+it.padding+20,ft=pt.height+it.padding,mt=ft/2,kt=mt/(2.5+ft/50),{cssStyles:_t}=it,vt=[{x:yt/2,y:-ft/2},{x:-yt/2,y:-ft/2},...generateArcPoints(-yt/2,-ft/2,-yt/2,ft/2,kt,mt,!1),{x:yt/2,y:ft/2},...generateArcPoints(yt/2,ft/2,yt/2,-ft/2,kt,mt,!0)],bt=at.svg(ut),Mt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(Mt.roughness=0,Mt.fillStyle="solid");const wt=createPathFromPoints(vt),St=bt.path(wt,Mt),It=ut.insert(()=>St,":first-child");return It.attr("class","basic label-container"),_t&&it.look!=="handDrawn"&&It.selectAll("path").attr("style",_t),dt&&it.look!=="handDrawn"&&It.selectAll("path").attr("style",dt),It.attr("transform",`translate(${kt/2}, 0)`),updateNodeBounds(it,It),it.intersect=function(Nt){return intersect_default.polygon(it,vt,Nt)},ut}__name(bowTieRect,"bowTieRect");function insertPolygonShape(rt,it,ct,dt){return rt.insert("polygon",":first-child").attr("points",dt.map(function(ut){return ut.x+","+ut.y}).join(" ")).attr("class","label-container").attr("transform","translate("+-it/2+","+ct/2+")")}__name(insertPolygonShape,"insertPolygonShape");async function card(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt}=await labelHelper(rt,it,getNodeClasses(it)),yt=pt.height+it.padding,ft=12,mt=pt.width+it.padding+ft,kt=0,_t=mt,vt=-yt,bt=0,Mt=[{x:kt+ft,y:vt},{x:_t,y:vt},{x:_t,y:bt},{x:kt,y:bt},{x:kt,y:vt+ft},{x:kt+ft,y:vt}];let wt;const{cssStyles:St}=it;if(it.look==="handDrawn"){const It=at.svg(ut),Nt=userNodeOverrides(it,{}),$t=createPathFromPoints(Mt),Et=It.path($t,Nt);wt=ut.insert(()=>Et,":first-child").attr("transform",`translate(${-mt/2}, ${yt/2})`),St&&wt.attr("style",St)}else wt=insertPolygonShape(ut,mt,yt,Mt);return dt&&wt.attr("style",dt),updateNodeBounds(it,wt),it.intersect=function(It){return intersect_default.polygon(it,Mt,It)},ut}__name(card,"card");function choice(rt,it){const{nodeStyles:ct}=styles2String(it);it.label="";const dt=rt.insert("g").attr("class",getNodeClasses(it)).attr("id",it.domId??it.id),{cssStyles:ut}=it,pt=Math.max(28,it.width??0),yt=[{x:0,y:pt/2},{x:pt/2,y:0},{x:0,y:-pt/2},{x:-pt/2,y:0}],ft=at.svg(dt),mt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(mt.roughness=0,mt.fillStyle="solid");const kt=createPathFromPoints(yt),_t=ft.path(kt,mt),vt=dt.insert(()=>_t,":first-child");return ut&&it.look!=="handDrawn"&&vt.selectAll("path").attr("style",ut),ct&&it.look!=="handDrawn"&&vt.selectAll("path").attr("style",ct),it.width=28,it.height=28,it.intersect=function(bt){return intersect_default.polygon(it,yt,bt)},dt}__name(choice,"choice");async function circle$1(rt,it,ct){const{labelStyles:dt,nodeStyles:ut}=styles2String(it);it.labelStyle=dt;const{shapeSvg:pt,bbox:yt,halfPadding:ft}=await labelHelper(rt,it,getNodeClasses(it)),mt=ct?.padding??ft,kt=yt.width/2+mt;let _t;const{cssStyles:vt}=it;if(it.look==="handDrawn"){const bt=at.svg(pt),Mt=userNodeOverrides(it,{}),wt=bt.circle(0,0,kt*2,Mt);_t=pt.insert(()=>wt,":first-child"),_t.attr("class","basic label-container").attr("style",handleUndefinedAttr(vt))}else _t=pt.insert("circle",":first-child").attr("class","basic label-container").attr("style",ut).attr("r",kt).attr("cx",0).attr("cy",0);return updateNodeBounds(it,_t),it.calcIntersect=function(bt,Mt){const wt=bt.width/2;return intersect_default.circle(bt,wt,Mt)},it.intersect=function(bt){return log.info("Circle intersect",it,kt,bt),intersect_default.circle(it,kt,bt)},pt}__name(circle$1,"circle");function createLine(rt){const it=Math.cos(Math.PI/4),ct=Math.sin(Math.PI/4),dt=rt*2,ut={x:dt/2*it,y:dt/2*ct},pt={x:-(dt/2)*it,y:dt/2*ct},yt={x:-(dt/2)*it,y:-(dt/2)*ct},ft={x:dt/2*it,y:-(dt/2)*ct};return`M ${pt.x},${pt.y} L ${ft.x},${ft.y}
-                   M ${ut.x},${ut.y} L ${yt.x},${yt.y}`}__name(createLine,"createLine");function crossedCircle(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct,it.label="";const ut=rt.insert("g").attr("class",getNodeClasses(it)).attr("id",it.domId??it.id),pt=Math.max(30,it?.width??0),{cssStyles:yt}=it,ft=at.svg(ut),mt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(mt.roughness=0,mt.fillStyle="solid");const kt=ft.circle(0,0,pt*2,mt),_t=createLine(pt),vt=ft.path(_t,mt),bt=ut.insert(()=>kt,":first-child");return bt.insert(()=>vt),yt&&it.look!=="handDrawn"&&bt.selectAll("path").attr("style",yt),dt&&it.look!=="handDrawn"&&bt.selectAll("path").attr("style",dt),updateNodeBounds(it,bt),it.intersect=function(Mt){return log.info("crossedCircle intersect",it,{radius:pt,point:Mt}),intersect_default.circle(it,pt,Mt)},ut}__name(crossedCircle,"crossedCircle");function generateCirclePoints2(rt,it,ct,dt=100,ut=0,pt=180){const yt=[],ft=ut*Math.PI/180,_t=(pt*Math.PI/180-ft)/(dt-1);for(let vt=0;vt<dt;vt++){const bt=ft+vt*_t,Mt=rt+ct*Math.cos(bt),wt=it+ct*Math.sin(bt);yt.push({x:-Mt,y:-wt})}return yt}__name(generateCirclePoints2,"generateCirclePoints");async function curlyBraceLeft(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=pt.width+(it.padding??0),mt=pt.height+(it.padding??0),kt=Math.max(5,mt*.1),{cssStyles:_t}=it,vt=[...generateCirclePoints2(ft/2,-mt/2,kt,30,-90,0),{x:-ft/2-kt,y:kt},...generateCirclePoints2(ft/2+kt*2,-kt,kt,20,-180,-270),...generateCirclePoints2(ft/2+kt*2,kt,kt,20,-90,-180),{x:-ft/2-kt,y:-mt/2},...generateCirclePoints2(ft/2,mt/2,kt,20,0,90)],bt=[{x:ft/2,y:-mt/2-kt},{x:-ft/2,y:-mt/2-kt},...generateCirclePoints2(ft/2,-mt/2,kt,20,-90,0),{x:-ft/2-kt,y:-kt},...generateCirclePoints2(ft/2+ft*.1,-kt,kt,20,-180,-270),...generateCirclePoints2(ft/2+ft*.1,kt,kt,20,-90,-180),{x:-ft/2-kt,y:mt/2},...generateCirclePoints2(ft/2,mt/2,kt,20,0,90),{x:-ft/2,y:mt/2+kt},{x:ft/2,y:mt/2+kt}],Mt=at.svg(ut),wt=userNodeOverrides(it,{fill:"none"});it.look!=="handDrawn"&&(wt.roughness=0,wt.fillStyle="solid");const It=createPathFromPoints(vt).replace("Z",""),Nt=Mt.path(It,wt),$t=createPathFromPoints(bt),Et=Mt.path($t,{...wt}),Ft=ut.insert("g",":first-child");return Ft.insert(()=>Et,":first-child").attr("stroke-opacity",0),Ft.insert(()=>Nt,":first-child"),Ft.attr("class","text"),_t&&it.look!=="handDrawn"&&Ft.selectAll("path").attr("style",_t),dt&&it.look!=="handDrawn"&&Ft.selectAll("path").attr("style",dt),Ft.attr("transform",`translate(${kt}, 0)`),yt.attr("transform",`translate(${-ft/2+kt-(pt.x-(pt.left??0))},${-mt/2+(it.padding??0)/2-(pt.y-(pt.top??0))})`),updateNodeBounds(it,Ft),it.intersect=function(qt){return intersect_default.polygon(it,bt,qt)},ut}__name(curlyBraceLeft,"curlyBraceLeft");function generateCirclePoints3(rt,it,ct,dt=100,ut=0,pt=180){const yt=[],ft=ut*Math.PI/180,_t=(pt*Math.PI/180-ft)/(dt-1);for(let vt=0;vt<dt;vt++){const bt=ft+vt*_t,Mt=rt+ct*Math.cos(bt),wt=it+ct*Math.sin(bt);yt.push({x:Mt,y:wt})}return yt}__name(generateCirclePoints3,"generateCirclePoints");async function curlyBraceRight(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=pt.width+(it.padding??0),mt=pt.height+(it.padding??0),kt=Math.max(5,mt*.1),{cssStyles:_t}=it,vt=[...generateCirclePoints3(ft/2,-mt/2,kt,20,-90,0),{x:ft/2+kt,y:-kt},...generateCirclePoints3(ft/2+kt*2,-kt,kt,20,-180,-270),...generateCirclePoints3(ft/2+kt*2,kt,kt,20,-90,-180),{x:ft/2+kt,y:mt/2},...generateCirclePoints3(ft/2,mt/2,kt,20,0,90)],bt=[{x:-ft/2,y:-mt/2-kt},{x:ft/2,y:-mt/2-kt},...generateCirclePoints3(ft/2,-mt/2,kt,20,-90,0),{x:ft/2+kt,y:-kt},...generateCirclePoints3(ft/2+kt*2,-kt,kt,20,-180,-270),...generateCirclePoints3(ft/2+kt*2,kt,kt,20,-90,-180),{x:ft/2+kt,y:mt/2},...generateCirclePoints3(ft/2,mt/2,kt,20,0,90),{x:ft/2,y:mt/2+kt},{x:-ft/2,y:mt/2+kt}],Mt=at.svg(ut),wt=userNodeOverrides(it,{fill:"none"});it.look!=="handDrawn"&&(wt.roughness=0,wt.fillStyle="solid");const It=createPathFromPoints(vt).replace("Z",""),Nt=Mt.path(It,wt),$t=createPathFromPoints(bt),Et=Mt.path($t,{...wt}),Ft=ut.insert("g",":first-child");return Ft.insert(()=>Et,":first-child").attr("stroke-opacity",0),Ft.insert(()=>Nt,":first-child"),Ft.attr("class","text"),_t&&it.look!=="handDrawn"&&Ft.selectAll("path").attr("style",_t),dt&&it.look!=="handDrawn"&&Ft.selectAll("path").attr("style",dt),Ft.attr("transform",`translate(${-kt}, 0)`),yt.attr("transform",`translate(${-ft/2+(it.padding??0)/2-(pt.x-(pt.left??0))},${-mt/2+(it.padding??0)/2-(pt.y-(pt.top??0))})`),updateNodeBounds(it,Ft),it.intersect=function(qt){return intersect_default.polygon(it,bt,qt)},ut}__name(curlyBraceRight,"curlyBraceRight");function generateCirclePoints4(rt,it,ct,dt=100,ut=0,pt=180){const yt=[],ft=ut*Math.PI/180,_t=(pt*Math.PI/180-ft)/(dt-1);for(let vt=0;vt<dt;vt++){const bt=ft+vt*_t,Mt=rt+ct*Math.cos(bt),wt=it+ct*Math.sin(bt);yt.push({x:-Mt,y:-wt})}return yt}__name(generateCirclePoints4,"generateCirclePoints");async function curlyBraces(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=pt.width+(it.padding??0),mt=pt.height+(it.padding??0),kt=Math.max(5,mt*.1),{cssStyles:_t}=it,vt=[...generateCirclePoints4(ft/2,-mt/2,kt,30,-90,0),{x:-ft/2-kt,y:kt},...generateCirclePoints4(ft/2+kt*2,-kt,kt,20,-180,-270),...generateCirclePoints4(ft/2+kt*2,kt,kt,20,-90,-180),{x:-ft/2-kt,y:-mt/2},...generateCirclePoints4(ft/2,mt/2,kt,20,0,90)],bt=[...generateCirclePoints4(-ft/2+kt+kt/2,-mt/2,kt,20,-90,-180),{x:ft/2-kt/2,y:kt},...generateCirclePoints4(-ft/2-kt/2,-kt,kt,20,0,90),...generateCirclePoints4(-ft/2-kt/2,kt,kt,20,-90,0),{x:ft/2-kt/2,y:-kt},...generateCirclePoints4(-ft/2+kt+kt/2,mt/2,kt,30,-180,-270)],Mt=[{x:ft/2,y:-mt/2-kt},{x:-ft/2,y:-mt/2-kt},...generateCirclePoints4(ft/2,-mt/2,kt,20,-90,0),{x:-ft/2-kt,y:-kt},...generateCirclePoints4(ft/2+kt*2,-kt,kt,20,-180,-270),...generateCirclePoints4(ft/2+kt*2,kt,kt,20,-90,-180),{x:-ft/2-kt,y:mt/2},...generateCirclePoints4(ft/2,mt/2,kt,20,0,90),{x:-ft/2,y:mt/2+kt},{x:ft/2-kt-kt/2,y:mt/2+kt},...generateCirclePoints4(-ft/2+kt+kt/2,-mt/2,kt,20,-90,-180),{x:ft/2-kt/2,y:kt},...generateCirclePoints4(-ft/2-kt/2,-kt,kt,20,0,90),...generateCirclePoints4(-ft/2-kt/2,kt,kt,20,-90,0),{x:ft/2-kt/2,y:-kt},...generateCirclePoints4(-ft/2+kt+kt/2,mt/2,kt,30,-180,-270)],wt=at.svg(ut),St=userNodeOverrides(it,{fill:"none"});it.look!=="handDrawn"&&(St.roughness=0,St.fillStyle="solid");const Nt=createPathFromPoints(vt).replace("Z",""),$t=wt.path(Nt,St),Ft=createPathFromPoints(bt).replace("Z",""),qt=wt.path(Ft,St),Ht=createPathFromPoints(Mt),Ot=wt.path(Ht,{...St}),Zt=ut.insert("g",":first-child");return Zt.insert(()=>Ot,":first-child").attr("stroke-opacity",0),Zt.insert(()=>$t,":first-child"),Zt.insert(()=>qt,":first-child"),Zt.attr("class","text"),_t&&it.look!=="handDrawn"&&Zt.selectAll("path").attr("style",_t),dt&&it.look!=="handDrawn"&&Zt.selectAll("path").attr("style",dt),Zt.attr("transform",`translate(${kt-kt/4}, 0)`),yt.attr("transform",`translate(${-ft/2+(it.padding??0)/2-(pt.x-(pt.left??0))},${-mt/2+(it.padding??0)/2-(pt.y-(pt.top??0))})`),updateNodeBounds(it,Zt),it.intersect=function(Yt){return intersect_default.polygon(it,Mt,Yt)},ut}__name(curlyBraces,"curlyBraces");async function curvedTrapezoid(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt}=await labelHelper(rt,it,getNodeClasses(it)),yt=80,ft=20,mt=Math.max(yt,(pt.width+(it.padding??0)*2)*1.25,it?.width??0),kt=Math.max(ft,pt.height+(it.padding??0)*2,it?.height??0),_t=kt/2,{cssStyles:vt}=it,bt=at.svg(ut),Mt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(Mt.roughness=0,Mt.fillStyle="solid");const wt=mt,St=kt,It=wt-_t,Nt=St/4,$t=[{x:It,y:0},{x:Nt,y:0},{x:0,y:St/2},{x:Nt,y:St},{x:It,y:St},...generateCirclePoints(-It,-St/2,_t,50,270,90)],Et=createPathFromPoints($t),Ft=bt.path(Et,Mt),qt=ut.insert(()=>Ft,":first-child");return qt.attr("class","basic label-container"),vt&&it.look!=="handDrawn"&&qt.selectChildren("path").attr("style",vt),dt&&it.look!=="handDrawn"&&qt.selectChildren("path").attr("style",dt),qt.attr("transform",`translate(${-mt/2}, ${-kt/2})`),updateNodeBounds(it,qt),it.intersect=function(Ht){return intersect_default.polygon(it,$t,Ht)},ut}__name(curvedTrapezoid,"curvedTrapezoid");var createCylinderPathD=__name((rt,it,ct,dt,ut,pt)=>[`M${rt},${it+pt}`,`a${ut},${pt} 0,0,0 ${ct},0`,`a${ut},${pt} 0,0,0 ${-ct},0`,`l0,${dt}`,`a${ut},${pt} 0,0,0 ${ct},0`,`l0,${-dt}`].join(" "),"createCylinderPathD"),createOuterCylinderPathD=__name((rt,it,ct,dt,ut,pt)=>[`M${rt},${it+pt}`,`M${rt+ct},${it+pt}`,`a${ut},${pt} 0,0,0 ${-ct},0`,`l0,${dt}`,`a${ut},${pt} 0,0,0 ${ct},0`,`l0,${-dt}`].join(" "),"createOuterCylinderPathD"),createInnerCylinderPathD=__name((rt,it,ct,dt,ut,pt)=>[`M${rt-ct/2},${-dt/2}`,`a${ut},${pt} 0,0,0 ${ct},0`].join(" "),"createInnerCylinderPathD");async function cylinder(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=Math.max(pt.width+it.padding,it.width??0),mt=ft/2,kt=mt/(2.5+ft/50),_t=Math.max(pt.height+kt+it.padding,it.height??0);let vt;const{cssStyles:bt}=it;if(it.look==="handDrawn"){const Mt=at.svg(ut),wt=createOuterCylinderPathD(0,0,ft,_t,mt,kt),St=createInnerCylinderPathD(0,kt,ft,_t,mt,kt),It=Mt.path(wt,userNodeOverrides(it,{})),Nt=Mt.path(St,userNodeOverrides(it,{fill:"none"}));vt=ut.insert(()=>Nt,":first-child"),vt=ut.insert(()=>It,":first-child"),vt.attr("class","basic label-container"),bt&&vt.attr("style",bt)}else{const Mt=createCylinderPathD(0,0,ft,_t,mt,kt);vt=ut.insert("path",":first-child").attr("d",Mt).attr("class","basic label-container").attr("style",handleUndefinedAttr(bt)).attr("style",dt)}return vt.attr("label-offset-y",kt),vt.attr("transform",`translate(${-ft/2}, ${-(_t/2+kt)})`),updateNodeBounds(it,vt),yt.attr("transform",`translate(${-(pt.width/2)-(pt.x-(pt.left??0))}, ${-(pt.height/2)+(it.padding??0)/1.5-(pt.y-(pt.top??0))})`),it.intersect=function(Mt){const wt=intersect_default.rect(it,Mt),St=wt.x-(it.x??0);if(mt!=0&&(Math.abs(St)<(it.width??0)/2||Math.abs(St)==(it.width??0)/2&&Math.abs(wt.y-(it.y??0))>(it.height??0)/2-kt)){let It=kt*kt*(1-St*St/(mt*mt));It>0&&(It=Math.sqrt(It)),It=kt-It,Mt.y-(it.y??0)>0&&(It=-It),wt.y+=It}return wt},ut}__name(cylinder,"cylinder");async function dividedRectangle(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=pt.width+it.padding,mt=pt.height+it.padding,kt=mt*.2,_t=-ft/2,vt=-mt/2-kt/2,{cssStyles:bt}=it,Mt=at.svg(ut),wt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(wt.roughness=0,wt.fillStyle="solid");const St=[{x:_t,y:vt+kt},{x:-_t,y:vt+kt},{x:-_t,y:-vt},{x:_t,y:-vt},{x:_t,y:vt},{x:-_t,y:vt},{x:-_t,y:vt+kt}],It=Mt.polygon(St.map($t=>[$t.x,$t.y]),wt),Nt=ut.insert(()=>It,":first-child");return Nt.attr("class","basic label-container"),bt&&it.look!=="handDrawn"&&Nt.selectAll("path").attr("style",bt),dt&&it.look!=="handDrawn"&&Nt.selectAll("path").attr("style",dt),yt.attr("transform",`translate(${_t+(it.padding??0)/2-(pt.x-(pt.left??0))}, ${vt+kt+(it.padding??0)/2-(pt.y-(pt.top??0))})`),updateNodeBounds(it,Nt),it.intersect=function($t){return intersect_default.rect(it,$t)},ut}__name(dividedRectangle,"dividedRectangle");async function doublecircle(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,halfPadding:yt}=await labelHelper(rt,it,getNodeClasses(it)),mt=pt.width/2+yt+5,kt=pt.width/2+yt;let _t;const{cssStyles:vt}=it;if(it.look==="handDrawn"){const bt=at.svg(ut),Mt=userNodeOverrides(it,{roughness:.2,strokeWidth:2.5}),wt=userNodeOverrides(it,{roughness:.2,strokeWidth:1.5}),St=bt.circle(0,0,mt*2,Mt),It=bt.circle(0,0,kt*2,wt);_t=ut.insert("g",":first-child"),_t.attr("class",handleUndefinedAttr(it.cssClasses)).attr("style",handleUndefinedAttr(vt)),_t.node()?.appendChild(St),_t.node()?.appendChild(It)}else{_t=ut.insert("g",":first-child");const bt=_t.insert("circle",":first-child"),Mt=_t.insert("circle");_t.attr("class","basic label-container").attr("style",dt),bt.attr("class","outer-circle").attr("style",dt).attr("r",mt).attr("cx",0).attr("cy",0),Mt.attr("class","inner-circle").attr("style",dt).attr("r",kt).attr("cx",0).attr("cy",0)}return updateNodeBounds(it,_t),it.intersect=function(bt){return log.info("DoubleCircle intersect",it,mt,bt),intersect_default.circle(it,mt,bt)},ut}__name(doublecircle,"doublecircle");function filledCircle(rt,it,{config:{themeVariables:ct}}){const{labelStyles:dt,nodeStyles:ut}=styles2String(it);it.label="",it.labelStyle=dt;const pt=rt.insert("g").attr("class",getNodeClasses(it)).attr("id",it.domId??it.id),yt=7,{cssStyles:ft}=it,mt=at.svg(pt),{nodeBorder:kt}=ct,_t=userNodeOverrides(it,{fillStyle:"solid"});it.look!=="handDrawn"&&(_t.roughness=0);const vt=mt.circle(0,0,yt*2,_t),bt=pt.insert(()=>vt,":first-child");return bt.selectAll("path").attr("style",`fill: ${kt} !important;`),ft&&ft.length>0&&it.look!=="handDrawn"&&bt.selectAll("path").attr("style",ft),ut&&it.look!=="handDrawn"&&bt.selectAll("path").attr("style",ut),updateNodeBounds(it,bt),it.intersect=function(Mt){return log.info("filledCircle intersect",it,{radius:yt,point:Mt}),intersect_default.circle(it,yt,Mt)},pt}__name(filledCircle,"filledCircle");async function flippedTriangle(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=pt.width+(it.padding??0),mt=ft+pt.height,kt=ft+pt.height,_t=[{x:0,y:-mt},{x:kt,y:-mt},{x:kt/2,y:0}],{cssStyles:vt}=it,bt=at.svg(ut),Mt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(Mt.roughness=0,Mt.fillStyle="solid");const wt=createPathFromPoints(_t),St=bt.path(wt,Mt),It=ut.insert(()=>St,":first-child").attr("transform",`translate(${-mt/2}, ${mt/2})`);return vt&&it.look!=="handDrawn"&&It.selectChildren("path").attr("style",vt),dt&&it.look!=="handDrawn"&&It.selectChildren("path").attr("style",dt),it.width=ft,it.height=mt,updateNodeBounds(it,It),yt.attr("transform",`translate(${-pt.width/2-(pt.x-(pt.left??0))}, ${-mt/2+(it.padding??0)/2+(pt.y-(pt.top??0))})`),it.intersect=function(Nt){return log.info("Triangle intersect",it,_t,Nt),intersect_default.polygon(it,_t,Nt)},ut}__name(flippedTriangle,"flippedTriangle");function forkJoin(rt,it,{dir:ct,config:{state:dt,themeVariables:ut}}){const{nodeStyles:pt}=styles2String(it);it.label="";const yt=rt.insert("g").attr("class",getNodeClasses(it)).attr("id",it.domId??it.id),{cssStyles:ft}=it;let mt=Math.max(70,it?.width??0),kt=Math.max(10,it?.height??0);ct==="LR"&&(mt=Math.max(10,it?.width??0),kt=Math.max(70,it?.height??0));const _t=-1*mt/2,vt=-1*kt/2,bt=at.svg(yt),Mt=userNodeOverrides(it,{stroke:ut.lineColor,fill:ut.lineColor});it.look!=="handDrawn"&&(Mt.roughness=0,Mt.fillStyle="solid");const wt=bt.rectangle(_t,vt,mt,kt,Mt),St=yt.insert(()=>wt,":first-child");ft&&it.look!=="handDrawn"&&St.selectAll("path").attr("style",ft),pt&&it.look!=="handDrawn"&&St.selectAll("path").attr("style",pt),updateNodeBounds(it,St);const It=dt?.padding??0;return it.width&&it.height&&(it.width+=It/2||0,it.height+=It/2||0),it.intersect=function(Nt){return intersect_default.rect(it,Nt)},yt}__name(forkJoin,"forkJoin");async function halfRoundedRectangle(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const ut=80,pt=50,{shapeSvg:yt,bbox:ft}=await labelHelper(rt,it,getNodeClasses(it)),mt=Math.max(ut,ft.width+(it.padding??0)*2,it?.width??0),kt=Math.max(pt,ft.height+(it.padding??0)*2,it?.height??0),_t=kt/2,{cssStyles:vt}=it,bt=at.svg(yt),Mt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(Mt.roughness=0,Mt.fillStyle="solid");const wt=[{x:-mt/2,y:-kt/2},{x:mt/2-_t,y:-kt/2},...generateCirclePoints(-mt/2+_t,0,_t,50,90,270),{x:mt/2-_t,y:kt/2},{x:-mt/2,y:kt/2}],St=createPathFromPoints(wt),It=bt.path(St,Mt),Nt=yt.insert(()=>It,":first-child");return Nt.attr("class","basic label-container"),vt&&it.look!=="handDrawn"&&Nt.selectChildren("path").attr("style",vt),dt&&it.look!=="handDrawn"&&Nt.selectChildren("path").attr("style",dt),updateNodeBounds(it,Nt),it.intersect=function($t){return log.info("Pill intersect",it,{radius:_t,point:$t}),intersect_default.polygon(it,wt,$t)},yt}__name(halfRoundedRectangle,"halfRoundedRectangle");async function hexagon(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt}=await labelHelper(rt,it,getNodeClasses(it)),yt=pt.height+(it.padding??0),ft=pt.width+(it.padding??0)*2.5,{cssStyles:mt}=it,kt=at.svg(ut),_t=userNodeOverrides(it,{});it.look!=="handDrawn"&&(_t.roughness=0,_t.fillStyle="solid");let vt=ft/2;const bt=vt/6;vt=vt+bt;const Mt=yt/2,wt=Mt/2,St=vt-wt,It=[{x:-St,y:-Mt},{x:0,y:-Mt},{x:St,y:-Mt},{x:vt,y:0},{x:St,y:Mt},{x:0,y:Mt},{x:-St,y:Mt},{x:-vt,y:0}],Nt=createPathFromPoints(It),$t=kt.path(Nt,_t),Et=ut.insert(()=>$t,":first-child");return Et.attr("class","basic label-container"),mt&&it.look!=="handDrawn"&&Et.selectChildren("path").attr("style",mt),dt&&it.look!=="handDrawn"&&Et.selectChildren("path").attr("style",dt),it.width=ft,it.height=yt,updateNodeBounds(it,Et),it.intersect=function(Ft){return intersect_default.polygon(it,It,Ft)},ut}__name(hexagon,"hexagon");async function hourglass(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.label="",it.labelStyle=ct;const{shapeSvg:ut}=await labelHelper(rt,it,getNodeClasses(it)),pt=Math.max(30,it?.width??0),yt=Math.max(30,it?.height??0),{cssStyles:ft}=it,mt=at.svg(ut),kt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(kt.roughness=0,kt.fillStyle="solid");const _t=[{x:0,y:0},{x:pt,y:0},{x:0,y:yt},{x:pt,y:yt}],vt=createPathFromPoints(_t),bt=mt.path(vt,kt),Mt=ut.insert(()=>bt,":first-child");return Mt.attr("class","basic label-container"),ft&&it.look!=="handDrawn"&&Mt.selectChildren("path").attr("style",ft),dt&&it.look!=="handDrawn"&&Mt.selectChildren("path").attr("style",dt),Mt.attr("transform",`translate(${-pt/2}, ${-yt/2})`),updateNodeBounds(it,Mt),it.intersect=function(wt){return log.info("Pill intersect",it,{points:_t}),intersect_default.polygon(it,_t,wt)},ut}__name(hourglass,"hourglass");async function icon(rt,it,{config:{themeVariables:ct,flowchart:dt}}){const{labelStyles:ut}=styles2String(it);it.labelStyle=ut;const pt=it.assetHeight??48,yt=it.assetWidth??48,ft=Math.max(pt,yt),mt=dt?.wrappingWidth;it.width=Math.max(ft,mt??0);const{shapeSvg:kt,bbox:_t,label:vt}=await labelHelper(rt,it,"icon-shape default"),bt=it.pos==="t",Mt=ft,wt=ft,{nodeBorder:St}=ct,{stylesMap:It}=compileStyles(it),Nt=-wt/2,$t=-Mt/2,Et=it.label?8:0,Ft=at.svg(kt),qt=userNodeOverrides(it,{stroke:"none",fill:"none"});it.look!=="handDrawn"&&(qt.roughness=0,qt.fillStyle="solid");const Ht=Ft.rectangle(Nt,$t,wt,Mt,qt),Ot=Math.max(wt,_t.width),Zt=Mt+_t.height+Et,Yt=Ft.rectangle(-Ot/2,-Zt/2,Ot,Zt,{...qt,fill:"transparent",stroke:"none"}),aa=kt.insert(()=>Ht,":first-child"),Qt=kt.insert(()=>Yt);if(it.icon){const oa=kt.append("g");oa.html(`<g>${await getIconSVG(it.icon,{height:ft,width:ft,fallbackPrefix:""})}</g>`);const la=oa.node().getBBox(),Kt=la.width,ra=la.height,Ut=la.x,ea=la.y;oa.attr("transform",`translate(${-Kt/2-Ut},${bt?_t.height/2+Et/2-ra/2-ea:-_t.height/2-Et/2-ra/2-ea})`),oa.attr("style",`color: ${It.get("stroke")??St};`)}return vt.attr("transform",`translate(${-_t.width/2-(_t.x-(_t.left??0))},${bt?-Zt/2:Zt/2-_t.height})`),aa.attr("transform",`translate(0,${bt?_t.height/2+Et/2:-_t.height/2-Et/2})`),updateNodeBounds(it,Qt),it.intersect=function(oa){if(log.info("iconSquare intersect",it,oa),!it.label)return intersect_default.rect(it,oa);const la=it.x??0,Kt=it.y??0,ra=it.height??0;let Ut=[];return bt?Ut=[{x:la-_t.width/2,y:Kt-ra/2},{x:la+_t.width/2,y:Kt-ra/2},{x:la+_t.width/2,y:Kt-ra/2+_t.height+Et},{x:la+wt/2,y:Kt-ra/2+_t.height+Et},{x:la+wt/2,y:Kt+ra/2},{x:la-wt/2,y:Kt+ra/2},{x:la-wt/2,y:Kt-ra/2+_t.height+Et},{x:la-_t.width/2,y:Kt-ra/2+_t.height+Et}]:Ut=[{x:la-wt/2,y:Kt-ra/2},{x:la+wt/2,y:Kt-ra/2},{x:la+wt/2,y:Kt-ra/2+Mt},{x:la+_t.width/2,y:Kt-ra/2+Mt},{x:la+_t.width/2/2,y:Kt+ra/2},{x:la-_t.width/2,y:Kt+ra/2},{x:la-_t.width/2,y:Kt-ra/2+Mt},{x:la-wt/2,y:Kt-ra/2+Mt}],intersect_default.polygon(it,Ut,oa)},kt}__name(icon,"icon");async function iconCircle(rt,it,{config:{themeVariables:ct,flowchart:dt}}){const{labelStyles:ut}=styles2String(it);it.labelStyle=ut;const pt=it.assetHeight??48,yt=it.assetWidth??48,ft=Math.max(pt,yt),mt=dt?.wrappingWidth;it.width=Math.max(ft,mt??0);const{shapeSvg:kt,bbox:_t,label:vt}=await labelHelper(rt,it,"icon-shape default"),bt=20,Mt=it.label?8:0,wt=it.pos==="t",{nodeBorder:St,mainBkg:It}=ct,{stylesMap:Nt}=compileStyles(it),$t=at.svg(kt),Et=userNodeOverrides(it,{});it.look!=="handDrawn"&&(Et.roughness=0,Et.fillStyle="solid");const Ft=Nt.get("fill");Et.stroke=Ft??It;const qt=kt.append("g");it.icon&&qt.html(`<g>${await getIconSVG(it.icon,{height:ft,width:ft,fallbackPrefix:""})}</g>`);const Ht=qt.node().getBBox(),Ot=Ht.width,Zt=Ht.height,Yt=Ht.x,aa=Ht.y,Qt=Math.max(Ot,Zt)*Math.SQRT2+bt*2,oa=$t.circle(0,0,Qt,Et),la=Math.max(Qt,_t.width),Kt=Qt+_t.height+Mt,ra=$t.rectangle(-la/2,-Kt/2,la,Kt,{...Et,fill:"transparent",stroke:"none"}),Ut=kt.insert(()=>oa,":first-child"),ea=kt.insert(()=>ra);return qt.attr("transform",`translate(${-Ot/2-Yt},${wt?_t.height/2+Mt/2-Zt/2-aa:-_t.height/2-Mt/2-Zt/2-aa})`),qt.attr("style",`color: ${Nt.get("stroke")??St};`),vt.attr("transform",`translate(${-_t.width/2-(_t.x-(_t.left??0))},${wt?-Kt/2:Kt/2-_t.height})`),Ut.attr("transform",`translate(0,${wt?_t.height/2+Mt/2:-_t.height/2-Mt/2})`),updateNodeBounds(it,ea),it.intersect=function(Gt){return log.info("iconSquare intersect",it,Gt),intersect_default.rect(it,Gt)},kt}__name(iconCircle,"iconCircle");async function iconRounded(rt,it,{config:{themeVariables:ct,flowchart:dt}}){const{labelStyles:ut}=styles2String(it);it.labelStyle=ut;const pt=it.assetHeight??48,yt=it.assetWidth??48,ft=Math.max(pt,yt),mt=dt?.wrappingWidth;it.width=Math.max(ft,mt??0);const{shapeSvg:kt,bbox:_t,halfPadding:vt,label:bt}=await labelHelper(rt,it,"icon-shape default"),Mt=it.pos==="t",wt=ft+vt*2,St=ft+vt*2,{nodeBorder:It,mainBkg:Nt}=ct,{stylesMap:$t}=compileStyles(it),Et=-St/2,Ft=-wt/2,qt=it.label?8:0,Ht=at.svg(kt),Ot=userNodeOverrides(it,{});it.look!=="handDrawn"&&(Ot.roughness=0,Ot.fillStyle="solid");const Zt=$t.get("fill");Ot.stroke=Zt??Nt;const Yt=Ht.path(createRoundedRectPathD(Et,Ft,St,wt,5),Ot),aa=Math.max(St,_t.width),Qt=wt+_t.height+qt,oa=Ht.rectangle(-aa/2,-Qt/2,aa,Qt,{...Ot,fill:"transparent",stroke:"none"}),la=kt.insert(()=>Yt,":first-child").attr("class","icon-shape2"),Kt=kt.insert(()=>oa);if(it.icon){const ra=kt.append("g");ra.html(`<g>${await getIconSVG(it.icon,{height:ft,width:ft,fallbackPrefix:""})}</g>`);const Ut=ra.node().getBBox(),ea=Ut.width,Gt=Ut.height,_a=Ut.x,Ca=Ut.y;ra.attr("transform",`translate(${-ea/2-_a},${Mt?_t.height/2+qt/2-Gt/2-Ca:-_t.height/2-qt/2-Gt/2-Ca})`),ra.attr("style",`color: ${$t.get("stroke")??It};`)}return bt.attr("transform",`translate(${-_t.width/2-(_t.x-(_t.left??0))},${Mt?-Qt/2:Qt/2-_t.height})`),la.attr("transform",`translate(0,${Mt?_t.height/2+qt/2:-_t.height/2-qt/2})`),updateNodeBounds(it,Kt),it.intersect=function(ra){if(log.info("iconSquare intersect",it,ra),!it.label)return intersect_default.rect(it,ra);const Ut=it.x??0,ea=it.y??0,Gt=it.height??0;let _a=[];return Mt?_a=[{x:Ut-_t.width/2,y:ea-Gt/2},{x:Ut+_t.width/2,y:ea-Gt/2},{x:Ut+_t.width/2,y:ea-Gt/2+_t.height+qt},{x:Ut+St/2,y:ea-Gt/2+_t.height+qt},{x:Ut+St/2,y:ea+Gt/2},{x:Ut-St/2,y:ea+Gt/2},{x:Ut-St/2,y:ea-Gt/2+_t.height+qt},{x:Ut-_t.width/2,y:ea-Gt/2+_t.height+qt}]:_a=[{x:Ut-St/2,y:ea-Gt/2},{x:Ut+St/2,y:ea-Gt/2},{x:Ut+St/2,y:ea-Gt/2+wt},{x:Ut+_t.width/2,y:ea-Gt/2+wt},{x:Ut+_t.width/2/2,y:ea+Gt/2},{x:Ut-_t.width/2,y:ea+Gt/2},{x:Ut-_t.width/2,y:ea-Gt/2+wt},{x:Ut-St/2,y:ea-Gt/2+wt}],intersect_default.polygon(it,_a,ra)},kt}__name(iconRounded,"iconRounded");async function iconSquare(rt,it,{config:{themeVariables:ct,flowchart:dt}}){const{labelStyles:ut}=styles2String(it);it.labelStyle=ut;const pt=it.assetHeight??48,yt=it.assetWidth??48,ft=Math.max(pt,yt),mt=dt?.wrappingWidth;it.width=Math.max(ft,mt??0);const{shapeSvg:kt,bbox:_t,halfPadding:vt,label:bt}=await labelHelper(rt,it,"icon-shape default"),Mt=it.pos==="t",wt=ft+vt*2,St=ft+vt*2,{nodeBorder:It,mainBkg:Nt}=ct,{stylesMap:$t}=compileStyles(it),Et=-St/2,Ft=-wt/2,qt=it.label?8:0,Ht=at.svg(kt),Ot=userNodeOverrides(it,{});it.look!=="handDrawn"&&(Ot.roughness=0,Ot.fillStyle="solid");const Zt=$t.get("fill");Ot.stroke=Zt??Nt;const Yt=Ht.path(createRoundedRectPathD(Et,Ft,St,wt,.1),Ot),aa=Math.max(St,_t.width),Qt=wt+_t.height+qt,oa=Ht.rectangle(-aa/2,-Qt/2,aa,Qt,{...Ot,fill:"transparent",stroke:"none"}),la=kt.insert(()=>Yt,":first-child"),Kt=kt.insert(()=>oa);if(it.icon){const ra=kt.append("g");ra.html(`<g>${await getIconSVG(it.icon,{height:ft,width:ft,fallbackPrefix:""})}</g>`);const Ut=ra.node().getBBox(),ea=Ut.width,Gt=Ut.height,_a=Ut.x,Ca=Ut.y;ra.attr("transform",`translate(${-ea/2-_a},${Mt?_t.height/2+qt/2-Gt/2-Ca:-_t.height/2-qt/2-Gt/2-Ca})`),ra.attr("style",`color: ${$t.get("stroke")??It};`)}return bt.attr("transform",`translate(${-_t.width/2-(_t.x-(_t.left??0))},${Mt?-Qt/2:Qt/2-_t.height})`),la.attr("transform",`translate(0,${Mt?_t.height/2+qt/2:-_t.height/2-qt/2})`),updateNodeBounds(it,Kt),it.intersect=function(ra){if(log.info("iconSquare intersect",it,ra),!it.label)return intersect_default.rect(it,ra);const Ut=it.x??0,ea=it.y??0,Gt=it.height??0;let _a=[];return Mt?_a=[{x:Ut-_t.width/2,y:ea-Gt/2},{x:Ut+_t.width/2,y:ea-Gt/2},{x:Ut+_t.width/2,y:ea-Gt/2+_t.height+qt},{x:Ut+St/2,y:ea-Gt/2+_t.height+qt},{x:Ut+St/2,y:ea+Gt/2},{x:Ut-St/2,y:ea+Gt/2},{x:Ut-St/2,y:ea-Gt/2+_t.height+qt},{x:Ut-_t.width/2,y:ea-Gt/2+_t.height+qt}]:_a=[{x:Ut-St/2,y:ea-Gt/2},{x:Ut+St/2,y:ea-Gt/2},{x:Ut+St/2,y:ea-Gt/2+wt},{x:Ut+_t.width/2,y:ea-Gt/2+wt},{x:Ut+_t.width/2/2,y:ea+Gt/2},{x:Ut-_t.width/2,y:ea+Gt/2},{x:Ut-_t.width/2,y:ea-Gt/2+wt},{x:Ut-St/2,y:ea-Gt/2+wt}],intersect_default.polygon(it,_a,ra)},kt}__name(iconSquare,"iconSquare");async function imageSquare(rt,it,{config:{flowchart:ct}}){const dt=new Image;dt.src=it?.img??"",await dt.decode();const ut=Number(dt.naturalWidth.toString().replace("px","")),pt=Number(dt.naturalHeight.toString().replace("px",""));it.imageAspectRatio=ut/pt;const{labelStyles:yt}=styles2String(it);it.labelStyle=yt;const ft=ct?.wrappingWidth;it.defaultWidth=ct?.wrappingWidth;const mt=Math.max(it.label?ft??0:0,it?.assetWidth??ut),kt=it.constraint==="on"&&it?.assetHeight?it.assetHeight*it.imageAspectRatio:mt,_t=it.constraint==="on"?kt/it.imageAspectRatio:it?.assetHeight??pt;it.width=Math.max(kt,ft??0);const{shapeSvg:vt,bbox:bt,label:Mt}=await labelHelper(rt,it,"image-shape default"),wt=it.pos==="t",St=-kt/2,It=-_t/2,Nt=it.label?8:0,$t=at.svg(vt),Et=userNodeOverrides(it,{});it.look!=="handDrawn"&&(Et.roughness=0,Et.fillStyle="solid");const Ft=$t.rectangle(St,It,kt,_t,Et),qt=Math.max(kt,bt.width),Ht=_t+bt.height+Nt,Ot=$t.rectangle(-qt/2,-Ht/2,qt,Ht,{...Et,fill:"none",stroke:"none"}),Zt=vt.insert(()=>Ft,":first-child"),Yt=vt.insert(()=>Ot);if(it.img){const aa=vt.append("image");aa.attr("href",it.img),aa.attr("width",kt),aa.attr("height",_t),aa.attr("preserveAspectRatio","none"),aa.attr("transform",`translate(${-kt/2},${wt?Ht/2-_t:-Ht/2})`)}return Mt.attr("transform",`translate(${-bt.width/2-(bt.x-(bt.left??0))},${wt?-_t/2-bt.height/2-Nt/2:_t/2-bt.height/2+Nt/2})`),Zt.attr("transform",`translate(0,${wt?bt.height/2+Nt/2:-bt.height/2-Nt/2})`),updateNodeBounds(it,Yt),it.intersect=function(aa){if(log.info("iconSquare intersect",it,aa),!it.label)return intersect_default.rect(it,aa);const Qt=it.x??0,oa=it.y??0,la=it.height??0;let Kt=[];return wt?Kt=[{x:Qt-bt.width/2,y:oa-la/2},{x:Qt+bt.width/2,y:oa-la/2},{x:Qt+bt.width/2,y:oa-la/2+bt.height+Nt},{x:Qt+kt/2,y:oa-la/2+bt.height+Nt},{x:Qt+kt/2,y:oa+la/2},{x:Qt-kt/2,y:oa+la/2},{x:Qt-kt/2,y:oa-la/2+bt.height+Nt},{x:Qt-bt.width/2,y:oa-la/2+bt.height+Nt}]:Kt=[{x:Qt-kt/2,y:oa-la/2},{x:Qt+kt/2,y:oa-la/2},{x:Qt+kt/2,y:oa-la/2+_t},{x:Qt+bt.width/2,y:oa-la/2+_t},{x:Qt+bt.width/2/2,y:oa+la/2},{x:Qt-bt.width/2,y:oa+la/2},{x:Qt-bt.width/2,y:oa-la/2+_t},{x:Qt-kt/2,y:oa-la/2+_t}],intersect_default.polygon(it,Kt,aa)},vt}__name(imageSquare,"imageSquare");async function inv_trapezoid(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt}=await labelHelper(rt,it,getNodeClasses(it)),yt=Math.max(pt.width+(it.padding??0)*2,it?.width??0),ft=Math.max(pt.height+(it.padding??0)*2,it?.height??0),mt=[{x:0,y:0},{x:yt,y:0},{x:yt+3*ft/6,y:-ft},{x:-3*ft/6,y:-ft}];let kt;const{cssStyles:_t}=it;if(it.look==="handDrawn"){const vt=at.svg(ut),bt=userNodeOverrides(it,{}),Mt=createPathFromPoints(mt),wt=vt.path(Mt,bt);kt=ut.insert(()=>wt,":first-child").attr("transform",`translate(${-yt/2}, ${ft/2})`),_t&&kt.attr("style",_t)}else kt=insertPolygonShape(ut,yt,ft,mt);return dt&&kt.attr("style",dt),it.width=yt,it.height=ft,updateNodeBounds(it,kt),it.intersect=function(vt){return intersect_default.polygon(it,mt,vt)},ut}__name(inv_trapezoid,"inv_trapezoid");async function drawRect(rt,it,ct){const{labelStyles:dt,nodeStyles:ut}=styles2String(it);it.labelStyle=dt;const{shapeSvg:pt,bbox:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=Math.max(yt.width+ct.labelPaddingX*2,it?.width||0),mt=Math.max(yt.height+ct.labelPaddingY*2,it?.height||0),kt=-ft/2,_t=-mt/2;let vt,{rx:bt,ry:Mt}=it;const{cssStyles:wt}=it;if(ct?.rx&&ct.ry&&(bt=ct.rx,Mt=ct.ry),it.look==="handDrawn"){const St=at.svg(pt),It=userNodeOverrides(it,{}),Nt=bt||Mt?St.path(createRoundedRectPathD(kt,_t,ft,mt,bt||0),It):St.rectangle(kt,_t,ft,mt,It);vt=pt.insert(()=>Nt,":first-child"),vt.attr("class","basic label-container").attr("style",handleUndefinedAttr(wt))}else vt=pt.insert("rect",":first-child"),vt.attr("class","basic label-container").attr("style",ut).attr("rx",handleUndefinedAttr(bt)).attr("ry",handleUndefinedAttr(Mt)).attr("x",kt).attr("y",_t).attr("width",ft).attr("height",mt);return updateNodeBounds(it,vt),it.calcIntersect=function(St,It){return intersect_default.rect(St,It)},it.intersect=function(St){return intersect_default.rect(it,St)},pt}__name(drawRect,"drawRect");async function labelRect(rt,it){const{shapeSvg:ct,bbox:dt,label:ut}=await labelHelper(rt,it,"label"),pt=ct.insert("rect",":first-child");return pt.attr("width",.1).attr("height",.1),ct.attr("class","label edgeLabel"),ut.attr("transform",`translate(${-(dt.width/2)-(dt.x-(dt.left??0))}, ${-(dt.height/2)-(dt.y-(dt.top??0))})`),updateNodeBounds(it,pt),it.intersect=function(mt){return intersect_default.rect(it,mt)},ct}__name(labelRect,"labelRect");async function lean_left(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt}=await labelHelper(rt,it,getNodeClasses(it)),yt=Math.max(pt.width+(it.padding??0),it?.width??0),ft=Math.max(pt.height+(it.padding??0),it?.height??0),mt=[{x:0,y:0},{x:yt+3*ft/6,y:0},{x:yt,y:-ft},{x:-(3*ft)/6,y:-ft}];let kt;const{cssStyles:_t}=it;if(it.look==="handDrawn"){const vt=at.svg(ut),bt=userNodeOverrides(it,{}),Mt=createPathFromPoints(mt),wt=vt.path(Mt,bt);kt=ut.insert(()=>wt,":first-child").attr("transform",`translate(${-yt/2}, ${ft/2})`),_t&&kt.attr("style",_t)}else kt=insertPolygonShape(ut,yt,ft,mt);return dt&&kt.attr("style",dt),it.width=yt,it.height=ft,updateNodeBounds(it,kt),it.intersect=function(vt){return intersect_default.polygon(it,mt,vt)},ut}__name(lean_left,"lean_left");async function lean_right(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt}=await labelHelper(rt,it,getNodeClasses(it)),yt=Math.max(pt.width+(it.padding??0),it?.width??0),ft=Math.max(pt.height+(it.padding??0),it?.height??0),mt=[{x:-3*ft/6,y:0},{x:yt,y:0},{x:yt+3*ft/6,y:-ft},{x:0,y:-ft}];let kt;const{cssStyles:_t}=it;if(it.look==="handDrawn"){const vt=at.svg(ut),bt=userNodeOverrides(it,{}),Mt=createPathFromPoints(mt),wt=vt.path(Mt,bt);kt=ut.insert(()=>wt,":first-child").attr("transform",`translate(${-yt/2}, ${ft/2})`),_t&&kt.attr("style",_t)}else kt=insertPolygonShape(ut,yt,ft,mt);return dt&&kt.attr("style",dt),it.width=yt,it.height=ft,updateNodeBounds(it,kt),it.intersect=function(vt){return intersect_default.polygon(it,mt,vt)},ut}__name(lean_right,"lean_right");function lightningBolt(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.label="",it.labelStyle=ct;const ut=rt.insert("g").attr("class",getNodeClasses(it)).attr("id",it.domId??it.id),{cssStyles:pt}=it,yt=Math.max(35,it?.width??0),ft=Math.max(35,it?.height??0),mt=7,kt=[{x:yt,y:0},{x:0,y:ft+mt/2},{x:yt-2*mt,y:ft+mt/2},{x:0,y:2*ft},{x:yt,y:ft-mt/2},{x:2*mt,y:ft-mt/2}],_t=at.svg(ut),vt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(vt.roughness=0,vt.fillStyle="solid");const bt=createPathFromPoints(kt),Mt=_t.path(bt,vt),wt=ut.insert(()=>Mt,":first-child");return pt&&it.look!=="handDrawn"&&wt.selectAll("path").attr("style",pt),dt&&it.look!=="handDrawn"&&wt.selectAll("path").attr("style",dt),wt.attr("transform",`translate(-${yt/2},${-ft})`),updateNodeBounds(it,wt),it.intersect=function(St){return log.info("lightningBolt intersect",it,St),intersect_default.polygon(it,kt,St)},ut}__name(lightningBolt,"lightningBolt");var createCylinderPathD2=__name((rt,it,ct,dt,ut,pt,yt)=>[`M${rt},${it+pt}`,`a${ut},${pt} 0,0,0 ${ct},0`,`a${ut},${pt} 0,0,0 ${-ct},0`,`l0,${dt}`,`a${ut},${pt} 0,0,0 ${ct},0`,`l0,${-dt}`,`M${rt},${it+pt+yt}`,`a${ut},${pt} 0,0,0 ${ct},0`].join(" "),"createCylinderPathD"),createOuterCylinderPathD2=__name((rt,it,ct,dt,ut,pt,yt)=>[`M${rt},${it+pt}`,`M${rt+ct},${it+pt}`,`a${ut},${pt} 0,0,0 ${-ct},0`,`l0,${dt}`,`a${ut},${pt} 0,0,0 ${ct},0`,`l0,${-dt}`,`M${rt},${it+pt+yt}`,`a${ut},${pt} 0,0,0 ${ct},0`].join(" "),"createOuterCylinderPathD"),createInnerCylinderPathD2=__name((rt,it,ct,dt,ut,pt)=>[`M${rt-ct/2},${-dt/2}`,`a${ut},${pt} 0,0,0 ${ct},0`].join(" "),"createInnerCylinderPathD");async function linedCylinder(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=Math.max(pt.width+(it.padding??0),it.width??0),mt=ft/2,kt=mt/(2.5+ft/50),_t=Math.max(pt.height+kt+(it.padding??0),it.height??0),vt=_t*.1;let bt;const{cssStyles:Mt}=it;if(it.look==="handDrawn"){const wt=at.svg(ut),St=createOuterCylinderPathD2(0,0,ft,_t,mt,kt,vt),It=createInnerCylinderPathD2(0,kt,ft,_t,mt,kt),Nt=userNodeOverrides(it,{}),$t=wt.path(St,Nt),Et=wt.path(It,Nt);ut.insert(()=>Et,":first-child").attr("class","line"),bt=ut.insert(()=>$t,":first-child"),bt.attr("class","basic label-container"),Mt&&bt.attr("style",Mt)}else{const wt=createCylinderPathD2(0,0,ft,_t,mt,kt,vt);bt=ut.insert("path",":first-child").attr("d",wt).attr("class","basic label-container").attr("style",handleUndefinedAttr(Mt)).attr("style",dt)}return bt.attr("label-offset-y",kt),bt.attr("transform",`translate(${-ft/2}, ${-(_t/2+kt)})`),updateNodeBounds(it,bt),yt.attr("transform",`translate(${-(pt.width/2)-(pt.x-(pt.left??0))}, ${-(pt.height/2)+kt-(pt.y-(pt.top??0))})`),it.intersect=function(wt){const St=intersect_default.rect(it,wt),It=St.x-(it.x??0);if(mt!=0&&(Math.abs(It)<(it.width??0)/2||Math.abs(It)==(it.width??0)/2&&Math.abs(St.y-(it.y??0))>(it.height??0)/2-kt)){let Nt=kt*kt*(1-It*It/(mt*mt));Nt>0&&(Nt=Math.sqrt(Nt)),Nt=kt-Nt,wt.y-(it.y??0)>0&&(Nt=-Nt),St.y+=Nt}return St},ut}__name(linedCylinder,"linedCylinder");async function linedWaveEdgedRect(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=Math.max(pt.width+(it.padding??0)*2,it?.width??0),mt=Math.max(pt.height+(it.padding??0)*2,it?.height??0),kt=mt/4,_t=mt+kt,{cssStyles:vt}=it,bt=at.svg(ut),Mt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(Mt.roughness=0,Mt.fillStyle="solid");const wt=[{x:-ft/2-ft/2*.1,y:-_t/2},{x:-ft/2-ft/2*.1,y:_t/2},...generateFullSineWavePoints(-ft/2-ft/2*.1,_t/2,ft/2+ft/2*.1,_t/2,kt,.8),{x:ft/2+ft/2*.1,y:-_t/2},{x:-ft/2-ft/2*.1,y:-_t/2},{x:-ft/2,y:-_t/2},{x:-ft/2,y:_t/2*1.1},{x:-ft/2,y:-_t/2}],St=bt.polygon(wt.map(Nt=>[Nt.x,Nt.y]),Mt),It=ut.insert(()=>St,":first-child");return It.attr("class","basic label-container"),vt&&it.look!=="handDrawn"&&It.selectAll("path").attr("style",vt),dt&&it.look!=="handDrawn"&&It.selectAll("path").attr("style",dt),It.attr("transform",`translate(0,${-kt/2})`),yt.attr("transform",`translate(${-ft/2+(it.padding??0)+ft/2*.1/2-(pt.x-(pt.left??0))},${-mt/2+(it.padding??0)-kt/2-(pt.y-(pt.top??0))})`),updateNodeBounds(it,It),it.intersect=function(Nt){return intersect_default.polygon(it,wt,Nt)},ut}__name(linedWaveEdgedRect,"linedWaveEdgedRect");async function multiRect(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=Math.max(pt.width+(it.padding??0)*2,it?.width??0),mt=Math.max(pt.height+(it.padding??0)*2,it?.height??0),kt=5,_t=-ft/2,vt=-mt/2,{cssStyles:bt}=it,Mt=at.svg(ut),wt=userNodeOverrides(it,{}),St=[{x:_t-kt,y:vt+kt},{x:_t-kt,y:vt+mt+kt},{x:_t+ft-kt,y:vt+mt+kt},{x:_t+ft-kt,y:vt+mt},{x:_t+ft,y:vt+mt},{x:_t+ft,y:vt+mt-kt},{x:_t+ft+kt,y:vt+mt-kt},{x:_t+ft+kt,y:vt-kt},{x:_t+kt,y:vt-kt},{x:_t+kt,y:vt},{x:_t,y:vt},{x:_t,y:vt+kt}],It=[{x:_t,y:vt+kt},{x:_t+ft-kt,y:vt+kt},{x:_t+ft-kt,y:vt+mt},{x:_t+ft,y:vt+mt},{x:_t+ft,y:vt},{x:_t,y:vt}];it.look!=="handDrawn"&&(wt.roughness=0,wt.fillStyle="solid");const Nt=createPathFromPoints(St),$t=Mt.path(Nt,wt),Et=createPathFromPoints(It),Ft=Mt.path(Et,{...wt,fill:"none"}),qt=ut.insert(()=>Ft,":first-child");return qt.insert(()=>$t,":first-child"),qt.attr("class","basic label-container"),bt&&it.look!=="handDrawn"&&qt.selectAll("path").attr("style",bt),dt&&it.look!=="handDrawn"&&qt.selectAll("path").attr("style",dt),yt.attr("transform",`translate(${-(pt.width/2)-kt-(pt.x-(pt.left??0))}, ${-(pt.height/2)+kt-(pt.y-(pt.top??0))})`),updateNodeBounds(it,qt),it.intersect=function(Ht){return intersect_default.polygon(it,St,Ht)},ut}__name(multiRect,"multiRect");async function multiWaveEdgedRectangle(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=Math.max(pt.width+(it.padding??0)*2,it?.width??0),mt=Math.max(pt.height+(it.padding??0)*2,it?.height??0),kt=mt/4,_t=mt+kt,vt=-ft/2,bt=-_t/2,Mt=5,{cssStyles:wt}=it,St=generateFullSineWavePoints(vt-Mt,bt+_t+Mt,vt+ft-Mt,bt+_t+Mt,kt,.8),It=St?.[St.length-1],Nt=[{x:vt-Mt,y:bt+Mt},{x:vt-Mt,y:bt+_t+Mt},...St,{x:vt+ft-Mt,y:It.y-Mt},{x:vt+ft,y:It.y-Mt},{x:vt+ft,y:It.y-2*Mt},{x:vt+ft+Mt,y:It.y-2*Mt},{x:vt+ft+Mt,y:bt-Mt},{x:vt+Mt,y:bt-Mt},{x:vt+Mt,y:bt},{x:vt,y:bt},{x:vt,y:bt+Mt}],$t=[{x:vt,y:bt+Mt},{x:vt+ft-Mt,y:bt+Mt},{x:vt+ft-Mt,y:It.y-Mt},{x:vt+ft,y:It.y-Mt},{x:vt+ft,y:bt},{x:vt,y:bt}],Et=at.svg(ut),Ft=userNodeOverrides(it,{});it.look!=="handDrawn"&&(Ft.roughness=0,Ft.fillStyle="solid");const qt=createPathFromPoints(Nt),Ht=Et.path(qt,Ft),Ot=createPathFromPoints($t),Zt=Et.path(Ot,Ft),Yt=ut.insert(()=>Ht,":first-child");return Yt.insert(()=>Zt),Yt.attr("class","basic label-container"),wt&&it.look!=="handDrawn"&&Yt.selectAll("path").attr("style",wt),dt&&it.look!=="handDrawn"&&Yt.selectAll("path").attr("style",dt),Yt.attr("transform",`translate(0,${-kt/2})`),yt.attr("transform",`translate(${-(pt.width/2)-Mt-(pt.x-(pt.left??0))}, ${-(pt.height/2)+Mt-kt/2-(pt.y-(pt.top??0))})`),updateNodeBounds(it,Yt),it.intersect=function(aa){return intersect_default.polygon(it,Nt,aa)},ut}__name(multiWaveEdgedRectangle,"multiWaveEdgedRectangle");async function note(rt,it,{config:{themeVariables:ct}}){const{labelStyles:dt,nodeStyles:ut}=styles2String(it);it.labelStyle=dt,it.useHtmlLabels||getConfig().flowchart?.htmlLabels!==!1||(it.centerLabel=!0);const{shapeSvg:yt,bbox:ft,label:mt}=await labelHelper(rt,it,getNodeClasses(it)),kt=Math.max(ft.width+(it.padding??0)*2,it?.width??0),_t=Math.max(ft.height+(it.padding??0)*2,it?.height??0),vt=-kt/2,bt=-_t/2,{cssStyles:Mt}=it,wt=at.svg(yt),St=userNodeOverrides(it,{fill:ct.noteBkgColor,stroke:ct.noteBorderColor});it.look!=="handDrawn"&&(St.roughness=0,St.fillStyle="solid");const It=wt.rectangle(vt,bt,kt,_t,St),Nt=yt.insert(()=>It,":first-child");return Nt.attr("class","basic label-container"),Mt&&it.look!=="handDrawn"&&Nt.selectAll("path").attr("style",Mt),ut&&it.look!=="handDrawn"&&Nt.selectAll("path").attr("style",ut),mt.attr("transform",`translate(${-ft.width/2-(ft.x-(ft.left??0))}, ${-(ft.height/2)-(ft.y-(ft.top??0))})`),updateNodeBounds(it,Nt),it.intersect=function($t){return intersect_default.rect(it,$t)},yt}__name(note,"note");var createDecisionBoxPathD=__name((rt,it,ct)=>[`M${rt+ct/2},${it}`,`L${rt+ct},${it-ct/2}`,`L${rt+ct/2},${it-ct}`,`L${rt},${it-ct/2}`,"Z"].join(" "),"createDecisionBoxPathD");async function question(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt}=await labelHelper(rt,it,getNodeClasses(it)),yt=pt.width+it.padding,ft=pt.height+it.padding,mt=yt+ft,kt=.5,_t=[{x:mt/2,y:0},{x:mt,y:-mt/2},{x:mt/2,y:-mt},{x:0,y:-mt/2}];let vt;const{cssStyles:bt}=it;if(it.look==="handDrawn"){const Mt=at.svg(ut),wt=userNodeOverrides(it,{}),St=createDecisionBoxPathD(0,0,mt),It=Mt.path(St,wt);vt=ut.insert(()=>It,":first-child").attr("transform",`translate(${-mt/2+kt}, ${mt/2})`),bt&&vt.attr("style",bt)}else vt=insertPolygonShape(ut,mt,mt,_t),vt.attr("transform",`translate(${-mt/2+kt}, ${mt/2})`);return dt&&vt.attr("style",dt),updateNodeBounds(it,vt),it.calcIntersect=function(Mt,wt){const St=Mt.width,It=[{x:St/2,y:0},{x:St,y:-St/2},{x:St/2,y:-St},{x:0,y:-St/2}],Nt=intersect_default.polygon(Mt,It,wt);return{x:Nt.x-.5,y:Nt.y-.5}},it.intersect=function(Mt){return this.calcIntersect(it,Mt)},ut}__name(question,"question");async function rect_left_inv_arrow(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=Math.max(pt.width+(it.padding??0),it?.width??0),mt=Math.max(pt.height+(it.padding??0),it?.height??0),kt=-ft/2,_t=-mt/2,vt=_t/2,bt=[{x:kt+vt,y:_t},{x:kt,y:0},{x:kt+vt,y:-_t},{x:-kt,y:-_t},{x:-kt,y:_t}],{cssStyles:Mt}=it,wt=at.svg(ut),St=userNodeOverrides(it,{});it.look!=="handDrawn"&&(St.roughness=0,St.fillStyle="solid");const It=createPathFromPoints(bt),Nt=wt.path(It,St),$t=ut.insert(()=>Nt,":first-child");return $t.attr("class","basic label-container"),Mt&&it.look!=="handDrawn"&&$t.selectAll("path").attr("style",Mt),dt&&it.look!=="handDrawn"&&$t.selectAll("path").attr("style",dt),$t.attr("transform",`translate(${-vt/2},0)`),yt.attr("transform",`translate(${-vt/2-pt.width/2-(pt.x-(pt.left??0))}, ${-(pt.height/2)-(pt.y-(pt.top??0))})`),updateNodeBounds(it,$t),it.intersect=function(Et){return intersect_default.polygon(it,bt,Et)},ut}__name(rect_left_inv_arrow,"rect_left_inv_arrow");async function rectWithTitle(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;let ut;it.cssClasses?ut="node "+it.cssClasses:ut="node default";const pt=rt.insert("g").attr("class",ut).attr("id",it.domId||it.id),yt=pt.insert("g"),ft=pt.insert("g").attr("class","label").attr("style",dt),mt=it.description,kt=it.label,_t=ft.node().appendChild(await createLabel_default(kt,it.labelStyle,!0,!0));let vt={width:0,height:0};if(evaluate(getConfig2()?.flowchart?.htmlLabels)){const Zt=_t.children[0],Yt=select(_t);vt=Zt.getBoundingClientRect(),Yt.attr("width",vt.width),Yt.attr("height",vt.height)}log.info("Text 2",mt);const bt=mt||[],Mt=_t.getBBox(),wt=ft.node().appendChild(await createLabel_default(bt.join?bt.join("<br/>"):bt,it.labelStyle,!0,!0)),St=wt.children[0],It=select(wt);vt=St.getBoundingClientRect(),It.attr("width",vt.width),It.attr("height",vt.height);const Nt=(it.padding||0)/2;select(wt).attr("transform","translate( "+(vt.width>Mt.width?0:(Mt.width-vt.width)/2)+", "+(Mt.height+Nt+5)+")"),select(_t).attr("transform","translate( "+(vt.width<Mt.width?0:-(Mt.width-vt.width)/2)+", 0)"),vt=ft.node().getBBox(),ft.attr("transform","translate("+-vt.width/2+", "+(-vt.height/2-Nt+3)+")");const $t=vt.width+(it.padding||0),Et=vt.height+(it.padding||0),Ft=-vt.width/2-Nt,qt=-vt.height/2-Nt;let Ht,Ot;if(it.look==="handDrawn"){const Zt=at.svg(pt),Yt=userNodeOverrides(it,{}),aa=Zt.path(createRoundedRectPathD(Ft,qt,$t,Et,it.rx||0),Yt),Qt=Zt.line(-vt.width/2-Nt,-vt.height/2-Nt+Mt.height+Nt,vt.width/2+Nt,-vt.height/2-Nt+Mt.height+Nt,Yt);Ot=pt.insert(()=>(log.debug("Rough node insert CXC",aa),Qt),":first-child"),Ht=pt.insert(()=>(log.debug("Rough node insert CXC",aa),aa),":first-child")}else Ht=yt.insert("rect",":first-child"),Ot=yt.insert("line"),Ht.attr("class","outer title-state").attr("style",dt).attr("x",-vt.width/2-Nt).attr("y",-vt.height/2-Nt).attr("width",vt.width+(it.padding||0)).attr("height",vt.height+(it.padding||0)),Ot.attr("class","divider").attr("x1",-vt.width/2-Nt).attr("x2",vt.width/2+Nt).attr("y1",-vt.height/2-Nt+Mt.height+Nt).attr("y2",-vt.height/2-Nt+Mt.height+Nt);return updateNodeBounds(it,Ht),it.intersect=function(Zt){return intersect_default.rect(it,Zt)},pt}__name(rectWithTitle,"rectWithTitle");function generateArcPoints2(rt,it,ct,dt,ut,pt,yt){const mt=(rt+ct)/2,kt=(it+dt)/2,_t=Math.atan2(dt-it,ct-rt),vt=(ct-rt)/2,bt=(dt-it)/2,Mt=vt/ut,wt=bt/pt,St=Math.sqrt(Mt**2+wt**2);if(St>1)throw new Error("The given radii are too small to create an arc between the points.");const It=Math.sqrt(1-St**2),Nt=mt+It*pt*Math.sin(_t)*(yt?-1:1),$t=kt-It*ut*Math.cos(_t)*(yt?-1:1),Et=Math.atan2((it-$t)/pt,(rt-Nt)/ut);let qt=Math.atan2((dt-$t)/pt,(ct-Nt)/ut)-Et;yt&&qt<0&&(qt+=2*Math.PI),!yt&&qt>0&&(qt-=2*Math.PI);const Ht=[];for(let Ot=0;Ot<20;Ot++){const Zt=Ot/19,Yt=Et+Zt*qt,aa=Nt+ut*Math.cos(Yt),Qt=$t+pt*Math.sin(Yt);Ht.push({x:aa,y:Qt})}return Ht}__name(generateArcPoints2,"generateArcPoints");async function roundedRect(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt}=await labelHelper(rt,it,getNodeClasses(it)),yt=it?.padding??0,ft=it?.padding??0,mt=(it?.width?it?.width:pt.width)+yt*2,kt=(it?.height?it?.height:pt.height)+ft*2,_t=it.radius||5,vt=it.taper||5,{cssStyles:bt}=it,Mt=at.svg(ut),wt=userNodeOverrides(it,{});it.stroke&&(wt.stroke=it.stroke),it.look!=="handDrawn"&&(wt.roughness=0,wt.fillStyle="solid");const St=[{x:-mt/2+vt,y:-kt/2},{x:mt/2-vt,y:-kt/2},...generateArcPoints2(mt/2-vt,-kt/2,mt/2,-kt/2+vt,_t,_t,!0),{x:mt/2,y:-kt/2+vt},{x:mt/2,y:kt/2-vt},...generateArcPoints2(mt/2,kt/2-vt,mt/2-vt,kt/2,_t,_t,!0),{x:mt/2-vt,y:kt/2},{x:-mt/2+vt,y:kt/2},...generateArcPoints2(-mt/2+vt,kt/2,-mt/2,kt/2-vt,_t,_t,!0),{x:-mt/2,y:kt/2-vt},{x:-mt/2,y:-kt/2+vt},...generateArcPoints2(-mt/2,-kt/2+vt,-mt/2+vt,-kt/2,_t,_t,!0)],It=createPathFromPoints(St),Nt=Mt.path(It,wt),$t=ut.insert(()=>Nt,":first-child");return $t.attr("class","basic label-container outer-path"),bt&&it.look!=="handDrawn"&&$t.selectChildren("path").attr("style",bt),dt&&it.look!=="handDrawn"&&$t.selectChildren("path").attr("style",dt),updateNodeBounds(it,$t),it.intersect=function(Et){return intersect_default.polygon(it,St,Et)},ut}__name(roundedRect,"roundedRect");async function shadedProcess(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=it?.padding??0,mt=Math.max(pt.width+(it.padding??0)*2,it?.width??0),kt=Math.max(pt.height+(it.padding??0)*2,it?.height??0),_t=-pt.width/2-ft,vt=-pt.height/2-ft,{cssStyles:bt}=it,Mt=at.svg(ut),wt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(wt.roughness=0,wt.fillStyle="solid");const St=[{x:_t,y:vt},{x:_t+mt+8,y:vt},{x:_t+mt+8,y:vt+kt},{x:_t-8,y:vt+kt},{x:_t-8,y:vt},{x:_t,y:vt},{x:_t,y:vt+kt}],It=Mt.polygon(St.map($t=>[$t.x,$t.y]),wt),Nt=ut.insert(()=>It,":first-child");return Nt.attr("class","basic label-container").attr("style",handleUndefinedAttr(bt)),dt&&it.look!=="handDrawn"&&Nt.selectAll("path").attr("style",dt),bt&&it.look!=="handDrawn"&&Nt.selectAll("path").attr("style",dt),yt.attr("transform",`translate(${-mt/2+4+(it.padding??0)-(pt.x-(pt.left??0))},${-kt/2+(it.padding??0)-(pt.y-(pt.top??0))})`),updateNodeBounds(it,Nt),it.intersect=function($t){return intersect_default.rect(it,$t)},ut}__name(shadedProcess,"shadedProcess");async function slopedRect(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=Math.max(pt.width+(it.padding??0)*2,it?.width??0),mt=Math.max(pt.height+(it.padding??0)*2,it?.height??0),kt=-ft/2,_t=-mt/2,{cssStyles:vt}=it,bt=at.svg(ut),Mt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(Mt.roughness=0,Mt.fillStyle="solid");const wt=[{x:kt,y:_t},{x:kt,y:_t+mt},{x:kt+ft,y:_t+mt},{x:kt+ft,y:_t-mt/2}],St=createPathFromPoints(wt),It=bt.path(St,Mt),Nt=ut.insert(()=>It,":first-child");return Nt.attr("class","basic label-container"),vt&&it.look!=="handDrawn"&&Nt.selectChildren("path").attr("style",vt),dt&&it.look!=="handDrawn"&&Nt.selectChildren("path").attr("style",dt),Nt.attr("transform",`translate(0, ${mt/4})`),yt.attr("transform",`translate(${-ft/2+(it.padding??0)-(pt.x-(pt.left??0))}, ${-mt/4+(it.padding??0)-(pt.y-(pt.top??0))})`),updateNodeBounds(it,Nt),it.intersect=function($t){return intersect_default.polygon(it,wt,$t)},ut}__name(slopedRect,"slopedRect");async function squareRect2(rt,it){const ct={rx:0,ry:0,labelPaddingX:it.labelPaddingX??(it?.padding||0)*2,labelPaddingY:(it?.padding||0)*1};return drawRect(rt,it,ct)}__name(squareRect2,"squareRect");async function stadium(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt}=await labelHelper(rt,it,getNodeClasses(it)),yt=pt.height+it.padding,ft=pt.width+yt/4+it.padding,mt=yt/2,{cssStyles:kt}=it,_t=at.svg(ut),vt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(vt.roughness=0,vt.fillStyle="solid");const bt=[{x:-ft/2+mt,y:-yt/2},{x:ft/2-mt,y:-yt/2},...generateCirclePoints(-ft/2+mt,0,mt,50,90,270),{x:ft/2-mt,y:yt/2},...generateCirclePoints(ft/2-mt,0,mt,50,270,450)],Mt=createPathFromPoints(bt),wt=_t.path(Mt,vt),St=ut.insert(()=>wt,":first-child");return St.attr("class","basic label-container outer-path"),kt&&it.look!=="handDrawn"&&St.selectChildren("path").attr("style",kt),dt&&it.look!=="handDrawn"&&St.selectChildren("path").attr("style",dt),updateNodeBounds(it,St),it.intersect=function(It){return intersect_default.polygon(it,bt,It)},ut}__name(stadium,"stadium");async function state(rt,it){return drawRect(rt,it,{rx:5,ry:5})}__name(state,"state");function stateEnd(rt,it,{config:{themeVariables:ct}}){const{labelStyles:dt,nodeStyles:ut}=styles2String(it);it.labelStyle=dt;const{cssStyles:pt}=it,{lineColor:yt,stateBorder:ft,nodeBorder:mt}=ct,kt=rt.insert("g").attr("class","node default").attr("id",it.domId||it.id),_t=at.svg(kt),vt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(vt.roughness=0,vt.fillStyle="solid");const bt=_t.circle(0,0,14,{...vt,stroke:yt,strokeWidth:2}),Mt=ft??mt,wt=_t.circle(0,0,5,{...vt,fill:Mt,stroke:Mt,strokeWidth:2,fillStyle:"solid"}),St=kt.insert(()=>bt,":first-child");return St.insert(()=>wt),pt&&St.selectAll("path").attr("style",pt),ut&&St.selectAll("path").attr("style",ut),updateNodeBounds(it,St),it.intersect=function(It){return intersect_default.circle(it,7,It)},kt}__name(stateEnd,"stateEnd");function stateStart(rt,it,{config:{themeVariables:ct}}){const{lineColor:dt}=ct,ut=rt.insert("g").attr("class","node default").attr("id",it.domId||it.id);let pt;if(it.look==="handDrawn"){const ft=at.svg(ut).circle(0,0,14,solidStateFill(dt));pt=ut.insert(()=>ft),pt.attr("class","state-start").attr("r",7).attr("width",14).attr("height",14)}else pt=ut.insert("circle",":first-child"),pt.attr("class","state-start").attr("r",7).attr("width",14).attr("height",14);return updateNodeBounds(it,pt),it.intersect=function(yt){return intersect_default.circle(it,7,yt)},ut}__name(stateStart,"stateStart");async function subroutine(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt}=await labelHelper(rt,it,getNodeClasses(it)),yt=(it?.padding||0)/2,ft=pt.width+it.padding,mt=pt.height+it.padding,kt=-pt.width/2-yt,_t=-pt.height/2-yt,vt=[{x:0,y:0},{x:ft,y:0},{x:ft,y:-mt},{x:0,y:-mt},{x:0,y:0},{x:-8,y:0},{x:ft+8,y:0},{x:ft+8,y:-mt},{x:-8,y:-mt},{x:-8,y:0}];if(it.look==="handDrawn"){const bt=at.svg(ut),Mt=userNodeOverrides(it,{}),wt=bt.rectangle(kt-8,_t,ft+16,mt,Mt),St=bt.line(kt,_t,kt,_t+mt,Mt),It=bt.line(kt+ft,_t,kt+ft,_t+mt,Mt);ut.insert(()=>St,":first-child"),ut.insert(()=>It,":first-child");const Nt=ut.insert(()=>wt,":first-child"),{cssStyles:$t}=it;Nt.attr("class","basic label-container").attr("style",handleUndefinedAttr($t)),updateNodeBounds(it,Nt)}else{const bt=insertPolygonShape(ut,ft,mt,vt);dt&&bt.attr("style",dt),updateNodeBounds(it,bt)}return it.intersect=function(bt){return intersect_default.polygon(it,vt,bt)},ut}__name(subroutine,"subroutine");async function taggedRect(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt}=await labelHelper(rt,it,getNodeClasses(it)),yt=Math.max(pt.width+(it.padding??0)*2,it?.width??0),ft=Math.max(pt.height+(it.padding??0)*2,it?.height??0),mt=-yt/2,kt=-ft/2,_t=.2*ft,vt=.2*ft,{cssStyles:bt}=it,Mt=at.svg(ut),wt=userNodeOverrides(it,{}),St=[{x:mt-_t/2,y:kt},{x:mt+yt+_t/2,y:kt},{x:mt+yt+_t/2,y:kt+ft},{x:mt-_t/2,y:kt+ft}],It=[{x:mt+yt-_t/2,y:kt+ft},{x:mt+yt+_t/2,y:kt+ft},{x:mt+yt+_t/2,y:kt+ft-vt}];it.look!=="handDrawn"&&(wt.roughness=0,wt.fillStyle="solid");const Nt=createPathFromPoints(St),$t=Mt.path(Nt,wt),Et=createPathFromPoints(It),Ft=Mt.path(Et,{...wt,fillStyle:"solid"}),qt=ut.insert(()=>Ft,":first-child");return qt.insert(()=>$t,":first-child"),qt.attr("class","basic label-container"),bt&&it.look!=="handDrawn"&&qt.selectAll("path").attr("style",bt),dt&&it.look!=="handDrawn"&&qt.selectAll("path").attr("style",dt),updateNodeBounds(it,qt),it.intersect=function(Ht){return intersect_default.polygon(it,St,Ht)},ut}__name(taggedRect,"taggedRect");async function taggedWaveEdgedRectangle(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=Math.max(pt.width+(it.padding??0)*2,it?.width??0),mt=Math.max(pt.height+(it.padding??0)*2,it?.height??0),kt=mt/4,_t=.2*ft,vt=.2*mt,bt=mt+kt,{cssStyles:Mt}=it,wt=at.svg(ut),St=userNodeOverrides(it,{});it.look!=="handDrawn"&&(St.roughness=0,St.fillStyle="solid");const It=[{x:-ft/2-ft/2*.1,y:bt/2},...generateFullSineWavePoints(-ft/2-ft/2*.1,bt/2,ft/2+ft/2*.1,bt/2,kt,.8),{x:ft/2+ft/2*.1,y:-bt/2},{x:-ft/2-ft/2*.1,y:-bt/2}],Nt=-ft/2+ft/2*.1,$t=-bt/2-vt*.4,Et=[{x:Nt+ft-_t,y:($t+mt)*1.4},{x:Nt+ft,y:$t+mt-vt},{x:Nt+ft,y:($t+mt)*.9},...generateFullSineWavePoints(Nt+ft,($t+mt)*1.3,Nt+ft-_t,($t+mt)*1.5,-mt*.03,.5)],Ft=createPathFromPoints(It),qt=wt.path(Ft,St),Ht=createPathFromPoints(Et),Ot=wt.path(Ht,{...St,fillStyle:"solid"}),Zt=ut.insert(()=>Ot,":first-child");return Zt.insert(()=>qt,":first-child"),Zt.attr("class","basic label-container"),Mt&&it.look!=="handDrawn"&&Zt.selectAll("path").attr("style",Mt),dt&&it.look!=="handDrawn"&&Zt.selectAll("path").attr("style",dt),Zt.attr("transform",`translate(0,${-kt/2})`),yt.attr("transform",`translate(${-ft/2+(it.padding??0)-(pt.x-(pt.left??0))},${-mt/2+(it.padding??0)-kt/2-(pt.y-(pt.top??0))})`),updateNodeBounds(it,Zt),it.intersect=function(Yt){return intersect_default.polygon(it,It,Yt)},ut}__name(taggedWaveEdgedRectangle,"taggedWaveEdgedRectangle");async function text(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt}=await labelHelper(rt,it,getNodeClasses(it)),yt=Math.max(pt.width+it.padding,it?.width||0),ft=Math.max(pt.height+it.padding,it?.height||0),mt=-yt/2,kt=-ft/2,_t=ut.insert("rect",":first-child");return _t.attr("class","text").attr("style",dt).attr("rx",0).attr("ry",0).attr("x",mt).attr("y",kt).attr("width",yt).attr("height",ft),updateNodeBounds(it,_t),it.intersect=function(vt){return intersect_default.rect(it,vt)},ut}__name(text,"text");var createCylinderPathD3=__name((rt,it,ct,dt,ut,pt)=>`M${rt},${it}
-    a${ut},${pt} 0,0,1 0,${-dt}
-    l${ct},0
-    a${ut},${pt} 0,0,1 0,${dt}
-    M${ct},${-dt}
-    a${ut},${pt} 0,0,0 0,${dt}
-    l${-ct},0`,"createCylinderPathD"),createOuterCylinderPathD3=__name((rt,it,ct,dt,ut,pt)=>[`M${rt},${it}`,`M${rt+ct},${it}`,`a${ut},${pt} 0,0,0 0,${-dt}`,`l${-ct},0`,`a${ut},${pt} 0,0,0 0,${dt}`,`l${ct},0`].join(" "),"createOuterCylinderPathD"),createInnerCylinderPathD3=__name((rt,it,ct,dt,ut,pt)=>[`M${rt+ct/2},${-dt/2}`,`a${ut},${pt} 0,0,0 0,${dt}`].join(" "),"createInnerCylinderPathD");async function tiltedCylinder(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt,halfPadding:ft}=await labelHelper(rt,it,getNodeClasses(it)),mt=it.look==="neo"?ft*2:ft,kt=pt.height+mt,_t=kt/2,vt=_t/(2.5+kt/50),bt=pt.width+vt+mt,{cssStyles:Mt}=it;let wt;if(it.look==="handDrawn"){const St=at.svg(ut),It=createOuterCylinderPathD3(0,0,bt,kt,vt,_t),Nt=createInnerCylinderPathD3(0,0,bt,kt,vt,_t),$t=St.path(It,userNodeOverrides(it,{})),Et=St.path(Nt,userNodeOverrides(it,{fill:"none"}));wt=ut.insert(()=>Et,":first-child"),wt=ut.insert(()=>$t,":first-child"),wt.attr("class","basic label-container"),Mt&&wt.attr("style",Mt)}else{const St=createCylinderPathD3(0,0,bt,kt,vt,_t);wt=ut.insert("path",":first-child").attr("d",St).attr("class","basic label-container").attr("style",handleUndefinedAttr(Mt)).attr("style",dt),wt.attr("class","basic label-container"),Mt&&wt.selectAll("path").attr("style",Mt),dt&&wt.selectAll("path").attr("style",dt)}return wt.attr("label-offset-x",vt),wt.attr("transform",`translate(${-bt/2}, ${kt/2} )`),yt.attr("transform",`translate(${-(pt.width/2)-vt-(pt.x-(pt.left??0))}, ${-(pt.height/2)-(pt.y-(pt.top??0))})`),updateNodeBounds(it,wt),it.intersect=function(St){const It=intersect_default.rect(it,St),Nt=It.y-(it.y??0);if(_t!=0&&(Math.abs(Nt)<(it.height??0)/2||Math.abs(Nt)==(it.height??0)/2&&Math.abs(It.x-(it.x??0))>(it.width??0)/2-vt)){let $t=vt*vt*(1-Nt*Nt/(_t*_t));$t!=0&&($t=Math.sqrt(Math.abs($t))),$t=vt-$t,St.x-(it.x??0)>0&&($t=-$t),It.x+=$t}return It},ut}__name(tiltedCylinder,"tiltedCylinder");async function trapezoid(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt}=await labelHelper(rt,it,getNodeClasses(it)),yt=pt.width+it.padding,ft=pt.height+it.padding,mt=[{x:-3*ft/6,y:0},{x:yt+3*ft/6,y:0},{x:yt,y:-ft},{x:0,y:-ft}];let kt;const{cssStyles:_t}=it;if(it.look==="handDrawn"){const vt=at.svg(ut),bt=userNodeOverrides(it,{}),Mt=createPathFromPoints(mt),wt=vt.path(Mt,bt);kt=ut.insert(()=>wt,":first-child").attr("transform",`translate(${-yt/2}, ${ft/2})`),_t&&kt.attr("style",_t)}else kt=insertPolygonShape(ut,yt,ft,mt);return dt&&kt.attr("style",dt),it.width=yt,it.height=ft,updateNodeBounds(it,kt),it.intersect=function(vt){return intersect_default.polygon(it,mt,vt)},ut}__name(trapezoid,"trapezoid");async function trapezoidalPentagon(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt}=await labelHelper(rt,it,getNodeClasses(it)),yt=60,ft=20,mt=Math.max(yt,pt.width+(it.padding??0)*2,it?.width??0),kt=Math.max(ft,pt.height+(it.padding??0)*2,it?.height??0),{cssStyles:_t}=it,vt=at.svg(ut),bt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(bt.roughness=0,bt.fillStyle="solid");const Mt=[{x:-mt/2*.8,y:-kt/2},{x:mt/2*.8,y:-kt/2},{x:mt/2,y:-kt/2*.6},{x:mt/2,y:kt/2},{x:-mt/2,y:kt/2},{x:-mt/2,y:-kt/2*.6}],wt=createPathFromPoints(Mt),St=vt.path(wt,bt),It=ut.insert(()=>St,":first-child");return It.attr("class","basic label-container"),_t&&it.look!=="handDrawn"&&It.selectChildren("path").attr("style",_t),dt&&it.look!=="handDrawn"&&It.selectChildren("path").attr("style",dt),updateNodeBounds(it,It),it.intersect=function(Nt){return intersect_default.polygon(it,Mt,Nt)},ut}__name(trapezoidalPentagon,"trapezoidalPentagon");async function triangle(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=evaluate(getConfig2().flowchart?.htmlLabels),mt=pt.width+(it.padding??0),kt=mt+pt.height,_t=mt+pt.height,vt=[{x:0,y:0},{x:_t,y:0},{x:_t/2,y:-kt}],{cssStyles:bt}=it,Mt=at.svg(ut),wt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(wt.roughness=0,wt.fillStyle="solid");const St=createPathFromPoints(vt),It=Mt.path(St,wt),Nt=ut.insert(()=>It,":first-child").attr("transform",`translate(${-kt/2}, ${kt/2})`);return bt&&it.look!=="handDrawn"&&Nt.selectChildren("path").attr("style",bt),dt&&it.look!=="handDrawn"&&Nt.selectChildren("path").attr("style",dt),it.width=mt,it.height=kt,updateNodeBounds(it,Nt),yt.attr("transform",`translate(${-pt.width/2-(pt.x-(pt.left??0))}, ${kt/2-(pt.height+(it.padding??0)/(ft?2:1)-(pt.y-(pt.top??0)))})`),it.intersect=function($t){return log.info("Triangle intersect",it,vt,$t),intersect_default.polygon(it,vt,$t)},ut}__name(triangle,"triangle");async function waveEdgedRectangle(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=Math.max(pt.width+(it.padding??0)*2,it?.width??0),mt=Math.max(pt.height+(it.padding??0)*2,it?.height??0),kt=mt/8,_t=mt+kt,{cssStyles:vt}=it,Mt=70-ft,wt=Mt>0?Mt/2:0,St=at.svg(ut),It=userNodeOverrides(it,{});it.look!=="handDrawn"&&(It.roughness=0,It.fillStyle="solid");const Nt=[{x:-ft/2-wt,y:_t/2},...generateFullSineWavePoints(-ft/2-wt,_t/2,ft/2+wt,_t/2,kt,.8),{x:ft/2+wt,y:-_t/2},{x:-ft/2-wt,y:-_t/2}],$t=createPathFromPoints(Nt),Et=St.path($t,It),Ft=ut.insert(()=>Et,":first-child");return Ft.attr("class","basic label-container"),vt&&it.look!=="handDrawn"&&Ft.selectAll("path").attr("style",vt),dt&&it.look!=="handDrawn"&&Ft.selectAll("path").attr("style",dt),Ft.attr("transform",`translate(0,${-kt/2})`),yt.attr("transform",`translate(${-ft/2+(it.padding??0)-(pt.x-(pt.left??0))},${-mt/2+(it.padding??0)-kt-(pt.y-(pt.top??0))})`),updateNodeBounds(it,Ft),it.intersect=function(qt){return intersect_default.polygon(it,Nt,qt)},ut}__name(waveEdgedRectangle,"waveEdgedRectangle");async function waveRectangle(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt}=await labelHelper(rt,it,getNodeClasses(it)),yt=100,ft=50,mt=Math.max(pt.width+(it.padding??0)*2,it?.width??0),kt=Math.max(pt.height+(it.padding??0)*2,it?.height??0),_t=mt/kt;let vt=mt,bt=kt;vt>bt*_t?bt=vt/_t:vt=bt*_t,vt=Math.max(vt,yt),bt=Math.max(bt,ft);const Mt=Math.min(bt*.2,bt/4),wt=bt+Mt*2,{cssStyles:St}=it,It=at.svg(ut),Nt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(Nt.roughness=0,Nt.fillStyle="solid");const $t=[{x:-vt/2,y:wt/2},...generateFullSineWavePoints(-vt/2,wt/2,vt/2,wt/2,Mt,1),{x:vt/2,y:-wt/2},...generateFullSineWavePoints(vt/2,-wt/2,-vt/2,-wt/2,Mt,-1)],Et=createPathFromPoints($t),Ft=It.path(Et,Nt),qt=ut.insert(()=>Ft,":first-child");return qt.attr("class","basic label-container"),St&&it.look!=="handDrawn"&&qt.selectAll("path").attr("style",St),dt&&it.look!=="handDrawn"&&qt.selectAll("path").attr("style",dt),updateNodeBounds(it,qt),it.intersect=function(Ht){return intersect_default.polygon(it,$t,Ht)},ut}__name(waveRectangle,"waveRectangle");async function windowPane(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,label:yt}=await labelHelper(rt,it,getNodeClasses(it)),ft=Math.max(pt.width+(it.padding??0)*2,it?.width??0),mt=Math.max(pt.height+(it.padding??0)*2,it?.height??0),kt=5,_t=-ft/2,vt=-mt/2,{cssStyles:bt}=it,Mt=at.svg(ut),wt=userNodeOverrides(it,{}),St=[{x:_t-kt,y:vt-kt},{x:_t-kt,y:vt+mt},{x:_t+ft,y:vt+mt},{x:_t+ft,y:vt-kt}],It=`M${_t-kt},${vt-kt} L${_t+ft},${vt-kt} L${_t+ft},${vt+mt} L${_t-kt},${vt+mt} L${_t-kt},${vt-kt}
-                M${_t-kt},${vt} L${_t+ft},${vt}
-                M${_t},${vt-kt} L${_t},${vt+mt}`;it.look!=="handDrawn"&&(wt.roughness=0,wt.fillStyle="solid");const Nt=Mt.path(It,wt),$t=ut.insert(()=>Nt,":first-child");return $t.attr("transform",`translate(${kt/2}, ${kt/2})`),$t.attr("class","basic label-container"),bt&&it.look!=="handDrawn"&&$t.selectAll("path").attr("style",bt),dt&&it.look!=="handDrawn"&&$t.selectAll("path").attr("style",dt),yt.attr("transform",`translate(${-(pt.width/2)+kt/2-(pt.x-(pt.left??0))}, ${-(pt.height/2)+kt/2-(pt.y-(pt.top??0))})`),updateNodeBounds(it,$t),it.intersect=function(Et){return intersect_default.polygon(it,St,Et)},ut}__name(windowPane,"windowPane");async function erBox(rt,it){const ct=it;if(ct.alias&&(it.label=ct.alias),it.look==="handDrawn"){const{themeVariables:ta}=getConfig(),{background:sa}=ta,xa={...it,id:it.id+"-background",look:"default",cssStyles:["stroke: none",`fill: ${sa}`]};await erBox(rt,xa)}const dt=getConfig();it.useHtmlLabels=dt.htmlLabels;let ut=dt.er?.diagramPadding??10,pt=dt.er?.entityPadding??6;const{cssStyles:yt}=it,{labelStyles:ft,nodeStyles:mt}=styles2String(it);if(ct.attributes.length===0&&it.label){const ta={rx:0,ry:0,labelPaddingX:ut,labelPaddingY:ut*1.5};calculateTextWidth(it.label,dt)+ta.labelPaddingX*2<dt.er.minEntityWidth&&(it.width=dt.er.minEntityWidth);const sa=await drawRect(rt,it,ta);if(!evaluate(dt.htmlLabels)){const xa=sa.select("text"),ka=xa.node()?.getBBox();xa.attr("transform",`translate(${-ka.width/2}, 0)`)}return sa}dt.htmlLabels||(ut*=1.25,pt*=1.25);let kt=getNodeClasses(it);kt||(kt="node default");const _t=rt.insert("g").attr("class",kt).attr("id",it.domId||it.id),vt=await addText(_t,it.label??"",dt,0,0,["name"],ft);vt.height+=pt;let bt=0;const Mt=[],wt=[];let St=0,It=0,Nt=0,$t=0,Et=!0,Ft=!0;for(const ta of ct.attributes){const sa=await addText(_t,ta.type,dt,0,bt,["attribute-type"],ft);St=Math.max(St,sa.width+ut);const xa=await addText(_t,ta.name,dt,0,bt,["attribute-name"],ft);It=Math.max(It,xa.width+ut);const ka=await addText(_t,ta.keys.join(),dt,0,bt,["attribute-keys"],ft);Nt=Math.max(Nt,ka.width+ut);const $a=await addText(_t,ta.comment,dt,0,bt,["attribute-comment"],ft);$t=Math.max($t,$a.width+ut);const Na=Math.max(sa.height,xa.height,ka.height,$a.height)+pt;wt.push({yOffset:bt,rowHeight:Na}),bt+=Na}let qt=4;Nt<=ut&&(Et=!1,Nt=0,qt--),$t<=ut&&(Ft=!1,$t=0,qt--);const Ht=_t.node().getBBox();if(vt.width+ut*2-(St+It+Nt+$t)>0){const ta=vt.width+ut*2-(St+It+Nt+$t);St+=ta/qt,It+=ta/qt,Nt>0&&(Nt+=ta/qt),$t>0&&($t+=ta/qt)}const Ot=St+It+Nt+$t,Zt=at.svg(_t),Yt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(Yt.roughness=0,Yt.fillStyle="solid");let aa=0;wt.length>0&&(aa=wt.reduce((ta,sa)=>ta+(sa?.rowHeight??0),0));const Qt=Math.max(Ht.width+ut*2,it?.width||0,Ot),oa=Math.max((aa??0)+vt.height,it?.height||0),la=-Qt/2,Kt=-oa/2;_t.selectAll("g:not(:first-child)").each((ta,sa,xa)=>{const ka=select(xa[sa]),$a=ka.attr("transform");let Na=0,Fa=0;if($a){const Ha=RegExp(/translate\(([^,]+),([^)]+)\)/).exec($a);Ha&&(Na=parseFloat(Ha[1]),Fa=parseFloat(Ha[2]),ka.attr("class").includes("attribute-name")?Na+=St:ka.attr("class").includes("attribute-keys")?Na+=St+It:ka.attr("class").includes("attribute-comment")&&(Na+=St+It+Nt))}ka.attr("transform",`translate(${la+ut/2+Na}, ${Fa+Kt+vt.height+pt/2})`)}),_t.select(".name").attr("transform","translate("+-vt.width/2+", "+(Kt+pt/2)+")");const ra=Zt.rectangle(la,Kt,Qt,oa,Yt),Ut=_t.insert(()=>ra,":first-child").attr("style",yt.join("")),{themeVariables:ea}=getConfig(),{rowEven:Gt,rowOdd:_a,nodeBorder:Ca}=ea;Mt.push(0);for(const[ta,sa]of wt.entries()){const ka=(ta+1)%2===0&&sa.yOffset!==0,$a=Zt.rectangle(la,vt.height+Kt+sa?.yOffset,Qt,sa?.rowHeight,{...Yt,fill:ka?Gt:_a,stroke:Ca});_t.insert(()=>$a,"g.label").attr("style",yt.join("")).attr("class",`row-rect-${ka?"even":"odd"}`)}let Vt=Zt.line(la,vt.height+Kt,Qt+la,vt.height+Kt,Yt);_t.insert(()=>Vt).attr("class","divider"),Vt=Zt.line(St+la,vt.height+Kt,St+la,oa+Kt,Yt),_t.insert(()=>Vt).attr("class","divider"),Et&&(Vt=Zt.line(St+It+la,vt.height+Kt,St+It+la,oa+Kt,Yt),_t.insert(()=>Vt).attr("class","divider")),Ft&&(Vt=Zt.line(St+It+Nt+la,vt.height+Kt,St+It+Nt+la,oa+Kt,Yt),_t.insert(()=>Vt).attr("class","divider"));for(const ta of Mt)Vt=Zt.line(la,vt.height+Kt+ta,Qt+la,vt.height+Kt+ta,Yt),_t.insert(()=>Vt).attr("class","divider");if(updateNodeBounds(it,Ut),mt&&it.look!=="handDrawn"){const sa=mt.split(";")?.filter(xa=>xa.includes("stroke"))?.map(xa=>`${xa}`).join("; ");_t.selectAll("path").attr("style",sa??""),_t.selectAll(".row-rect-even path").attr("style",mt)}return it.intersect=function(ta){return intersect_default.rect(it,ta)},_t}__name(erBox,"erBox");async function addText(rt,it,ct,dt=0,ut=0,pt=[],yt=""){const ft=rt.insert("g").attr("class",`label ${pt.join(" ")}`).attr("transform",`translate(${dt}, ${ut})`).attr("style",yt);it!==parseGenericTypes(it)&&(it=parseGenericTypes(it),it=it.replaceAll("<","&lt;").replaceAll(">","&gt;"));const mt=ft.node().appendChild(await createText(ft,it,{width:calculateTextWidth(it,ct)+100,style:yt,useHtmlLabels:ct.htmlLabels},ct));if(it.includes("&lt;")||it.includes("&gt;")){let _t=mt.children[0];for(_t.textContent=_t.textContent.replaceAll("&lt;","<").replaceAll("&gt;",">");_t.childNodes[0];)_t=_t.childNodes[0],_t.textContent=_t.textContent.replaceAll("&lt;","<").replaceAll("&gt;",">")}let kt=mt.getBBox();if(evaluate(ct.htmlLabels)){const _t=mt.children[0];_t.style.textAlign="start";const vt=select(mt);kt=_t.getBoundingClientRect(),vt.attr("width",kt.width),vt.attr("height",kt.height)}return kt}__name(addText,"addText");async function textHelper(rt,it,ct,dt,ut=ct.class.padding??12){const pt=dt?0:3,yt=rt.insert("g").attr("class",getNodeClasses(it)).attr("id",it.domId||it.id);let ft=null,mt=null,kt=null,_t=null,vt=0,bt=0,Mt=0;if(ft=yt.insert("g").attr("class","annotation-group text"),it.annotations.length>0){const $t=it.annotations[0];await addText2(ft,{text:`«${$t}»`},0),vt=ft.node().getBBox().height}mt=yt.insert("g").attr("class","label-group text"),await addText2(mt,it,0,["font-weight: bolder"]);const wt=mt.node().getBBox();bt=wt.height,kt=yt.insert("g").attr("class","members-group text");let St=0;for(const $t of it.members){const Et=await addText2(kt,$t,St,[$t.parseClassifier()]);St+=Et+pt}Mt=kt.node().getBBox().height,Mt<=0&&(Mt=ut/2),_t=yt.insert("g").attr("class","methods-group text");let It=0;for(const $t of it.methods){const Et=await addText2(_t,$t,It,[$t.parseClassifier()]);It+=Et+pt}let Nt=yt.node().getBBox();if(ft!==null){const $t=ft.node().getBBox();ft.attr("transform",`translate(${-$t.width/2})`)}return mt.attr("transform",`translate(${-wt.width/2}, ${vt})`),Nt=yt.node().getBBox(),kt.attr("transform",`translate(0, ${vt+bt+ut*2})`),Nt=yt.node().getBBox(),_t.attr("transform",`translate(0, ${vt+bt+(Mt?Mt+ut*4:ut*2)})`),Nt=yt.node().getBBox(),{shapeSvg:yt,bbox:Nt}}__name(textHelper,"textHelper");async function addText2(rt,it,ct,dt=[]){const ut=rt.insert("g").attr("class","label").attr("style",dt.join("; ")),pt=getConfig();let yt="useHtmlLabels"in it?it.useHtmlLabels:evaluate(pt.htmlLabels)??!0,ft="";"text"in it?ft=it.text:ft=it.label,!yt&&ft.startsWith("\\")&&(ft=ft.substring(1)),hasKatex(ft)&&(yt=!0);const mt=await createText(ut,sanitizeText3(decodeEntities(ft)),{width:calculateTextWidth(ft,pt)+50,classes:"markdown-node-label",useHtmlLabels:yt},pt);let kt,_t=1;if(yt){const vt=mt.children[0],bt=select(mt);_t=vt.innerHTML.split("<br>").length,vt.innerHTML.includes("</math>")&&(_t+=vt.innerHTML.split("<mrow>").length-1);const Mt=vt.getElementsByTagName("img");if(Mt){const wt=ft.replace(/<img[^>]*>/g,"").trim()==="";await Promise.all([...Mt].map(St=>new Promise(It=>{function Nt(){if(St.style.display="flex",St.style.flexDirection="column",wt){const $t=pt.fontSize?.toString()??window.getComputedStyle(document.body).fontSize,Ft=parseInt($t,10)*5+"px";St.style.minWidth=Ft,St.style.maxWidth=Ft}else St.style.width="100%";It(St)}__name(Nt,"setupImage"),setTimeout(()=>{St.complete&&Nt()}),St.addEventListener("error",Nt),St.addEventListener("load",Nt)})))}kt=vt.getBoundingClientRect(),bt.attr("width",kt.width),bt.attr("height",kt.height)}else{dt.includes("font-weight: bolder")&&select(mt).selectAll("tspan").attr("font-weight",""),_t=mt.children.length;const vt=mt.children[0];(mt.textContent===""||mt.textContent.includes("&gt"))&&(vt.textContent=ft[0]+ft.substring(1).replaceAll("&gt;",">").replaceAll("&lt;","<").trim(),ft[1]===" "&&(vt.textContent=vt.textContent[0]+" "+vt.textContent.substring(1))),vt.textContent==="undefined"&&(vt.textContent=""),kt=mt.getBBox()}return ut.attr("transform","translate(0,"+(-kt.height/(2*_t)+ct)+")"),kt.height}__name(addText2,"addText");async function classBox(rt,it){const ct=getConfig2(),dt=ct.class.padding??12,ut=dt,pt=it.useHtmlLabels??evaluate(ct.htmlLabels)??!0,yt=it;yt.annotations=yt.annotations??[],yt.members=yt.members??[],yt.methods=yt.methods??[];const{shapeSvg:ft,bbox:mt}=await textHelper(rt,it,ct,pt,ut),{labelStyles:kt,nodeStyles:_t}=styles2String(it);it.labelStyle=kt,it.cssStyles=yt.styles||"";const vt=yt.styles?.join(";")||_t||"";it.cssStyles||(it.cssStyles=vt.replaceAll("!important","").split(";"));const bt=yt.members.length===0&&yt.methods.length===0&&!ct.class?.hideEmptyMembersBox,Mt=at.svg(ft),wt=userNodeOverrides(it,{});it.look!=="handDrawn"&&(wt.roughness=0,wt.fillStyle="solid");const St=mt.width;let It=mt.height;yt.members.length===0&&yt.methods.length===0?It+=ut:yt.members.length>0&&yt.methods.length===0&&(It+=ut*2);const Nt=-St/2,$t=-It/2,Et=Mt.rectangle(Nt-dt,$t-dt-(bt?dt:yt.members.length===0&&yt.methods.length===0?-dt/2:0),St+2*dt,It+2*dt+(bt?dt*2:yt.members.length===0&&yt.methods.length===0?-dt:0),wt),Ft=ft.insert(()=>Et,":first-child");Ft.attr("class","basic label-container");const qt=Ft.node().getBBox();ft.selectAll(".text").each((Yt,aa,Qt)=>{const oa=select(Qt[aa]),la=oa.attr("transform");let Kt=0;if(la){const Gt=RegExp(/translate\(([^,]+),([^)]+)\)/).exec(la);Gt&&(Kt=parseFloat(Gt[2]))}let ra=Kt+$t+dt-(bt?dt:yt.members.length===0&&yt.methods.length===0?-dt/2:0);pt||(ra-=4);let Ut=Nt;(oa.attr("class").includes("label-group")||oa.attr("class").includes("annotation-group"))&&(Ut=-oa.node()?.getBBox().width/2||0,ft.selectAll("text").each(function(ea,Gt,_a){window.getComputedStyle(_a[Gt]).textAnchor==="middle"&&(Ut=0)})),oa.attr("transform",`translate(${Ut}, ${ra})`)});const Ht=ft.select(".annotation-group").node().getBBox().height-(bt?dt/2:0)||0,Ot=ft.select(".label-group").node().getBBox().height-(bt?dt/2:0)||0,Zt=ft.select(".members-group").node().getBBox().height-(bt?dt/2:0)||0;if(yt.members.length>0||yt.methods.length>0||bt){const Yt=Mt.line(qt.x,Ht+Ot+$t+dt,qt.x+qt.width,Ht+Ot+$t+dt,wt);ft.insert(()=>Yt).attr("class","divider").attr("style",vt)}if(bt||yt.members.length>0||yt.methods.length>0){const Yt=Mt.line(qt.x,Ht+Ot+Zt+$t+ut*2+dt,qt.x+qt.width,Ht+Ot+Zt+$t+dt+ut*2,wt);ft.insert(()=>Yt).attr("class","divider").attr("style",vt)}if(yt.look!=="handDrawn"&&ft.selectAll("path").attr("style",vt),Ft.select(":nth-child(2)").attr("style",vt),ft.selectAll(".divider").select("path").attr("style",vt),it.labelStyle?ft.selectAll("span").attr("style",it.labelStyle):ft.selectAll("span").attr("style",vt),!pt){const Yt=RegExp(/color\s*:\s*([^;]*)/),aa=Yt.exec(vt);if(aa){const Qt=aa[0].replace("color","fill");ft.selectAll("tspan").attr("style",Qt)}else if(kt){const Qt=Yt.exec(kt);if(Qt){const oa=Qt[0].replace("color","fill");ft.selectAll("tspan").attr("style",oa)}}}return updateNodeBounds(it,Ft),it.intersect=function(Yt){return intersect_default.rect(it,Yt)},ft}__name(classBox,"classBox");async function requirementBox(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const ut=it,pt=it,yt=20,ft=20,mt="verifyMethod"in it,kt=getNodeClasses(it),_t=rt.insert("g").attr("class",kt).attr("id",it.domId??it.id);let vt;mt?vt=await addText3(_t,`&lt;&lt;${ut.type}&gt;&gt;`,0,it.labelStyle):vt=await addText3(_t,"&lt;&lt;Element&gt;&gt;",0,it.labelStyle);let bt=vt;const Mt=await addText3(_t,ut.name,bt,it.labelStyle+"; font-weight: bold;");if(bt+=Mt+ft,mt){const Ht=await addText3(_t,`${ut.requirementId?`ID: ${ut.requirementId}`:""}`,bt,it.labelStyle);bt+=Ht;const Ot=await addText3(_t,`${ut.text?`Text: ${ut.text}`:""}`,bt,it.labelStyle);bt+=Ot;const Zt=await addText3(_t,`${ut.risk?`Risk: ${ut.risk}`:""}`,bt,it.labelStyle);bt+=Zt,await addText3(_t,`${ut.verifyMethod?`Verification: ${ut.verifyMethod}`:""}`,bt,it.labelStyle)}else{const Ht=await addText3(_t,`${pt.type?`Type: ${pt.type}`:""}`,bt,it.labelStyle);bt+=Ht,await addText3(_t,`${pt.docRef?`Doc Ref: ${pt.docRef}`:""}`,bt,it.labelStyle)}const wt=(_t.node()?.getBBox().width??200)+yt,St=(_t.node()?.getBBox().height??200)+yt,It=-wt/2,Nt=-St/2,$t=at.svg(_t),Et=userNodeOverrides(it,{});it.look!=="handDrawn"&&(Et.roughness=0,Et.fillStyle="solid");const Ft=$t.rectangle(It,Nt,wt,St,Et),qt=_t.insert(()=>Ft,":first-child");if(qt.attr("class","basic label-container").attr("style",dt),_t.selectAll(".label").each((Ht,Ot,Zt)=>{const Yt=select(Zt[Ot]),aa=Yt.attr("transform");let Qt=0,oa=0;if(aa){const Ut=RegExp(/translate\(([^,]+),([^)]+)\)/).exec(aa);Ut&&(Qt=parseFloat(Ut[1]),oa=parseFloat(Ut[2]))}const la=oa-St/2;let Kt=It+yt/2;(Ot===0||Ot===1)&&(Kt=Qt),Yt.attr("transform",`translate(${Kt}, ${la+yt})`)}),bt>vt+Mt+ft){const Ht=$t.line(It,Nt+vt+Mt+ft,It+wt,Nt+vt+Mt+ft,Et);_t.insert(()=>Ht).attr("style",dt)}return updateNodeBounds(it,qt),it.intersect=function(Ht){return intersect_default.rect(it,Ht)},_t}__name(requirementBox,"requirementBox");async function addText3(rt,it,ct,dt=""){if(it==="")return 0;const ut=rt.insert("g").attr("class","label").attr("style",dt),pt=getConfig2(),yt=pt.htmlLabels??!0,ft=await createText(ut,sanitizeText3(decodeEntities(it)),{width:calculateTextWidth(it,pt)+50,classes:"markdown-node-label",useHtmlLabels:yt,style:dt},pt);let mt;if(yt){const kt=ft.children[0],_t=select(ft);mt=kt.getBoundingClientRect(),_t.attr("width",mt.width),_t.attr("height",mt.height)}else{const kt=ft.children[0];for(const _t of kt.children)_t.textContent=_t.textContent.replaceAll("&gt;",">").replaceAll("&lt;","<"),dt&&_t.setAttribute("style",dt);mt=ft.getBBox(),mt.height+=6}return ut.attr("transform",`translate(${-mt.width/2},${-mt.height/2+ct})`),mt.height}__name(addText3,"addText");var colorFromPriority=__name(rt=>{switch(rt){case"Very High":return"red";case"High":return"orange";case"Medium":return null;case"Low":return"blue";case"Very Low":return"lightblue"}},"colorFromPriority");async function kanbanItem(rt,it,{config:ct}){const{labelStyles:dt,nodeStyles:ut}=styles2String(it);it.labelStyle=dt||"";const pt=10,yt=it.width;it.width=(it.width??200)-10;const{shapeSvg:ft,bbox:mt,label:kt}=await labelHelper(rt,it,getNodeClasses(it)),_t=it.padding||10;let vt="",bt;"ticket"in it&&it.ticket&&ct?.kanban?.ticketBaseUrl&&(vt=ct?.kanban?.ticketBaseUrl.replace("#TICKET#",it.ticket),bt=ft.insert("svg:a",":first-child").attr("class","kanban-ticket-link").attr("xlink:href",vt).attr("target","_blank"));const Mt={useHtmlLabels:it.useHtmlLabels,labelStyle:it.labelStyle||"",width:it.width,img:it.img,padding:it.padding||8,centerLabel:!1};let wt,St;bt?{label:wt,bbox:St}=await insertLabel(bt,"ticket"in it&&it.ticket||"",Mt):{label:wt,bbox:St}=await insertLabel(ft,"ticket"in it&&it.ticket||"",Mt);const{label:It,bbox:Nt}=await insertLabel(ft,"assigned"in it&&it.assigned||"",Mt);it.width=yt;const $t=10,Et=it?.width||0,Ft=Math.max(St.height,Nt.height)/2,qt=Math.max(mt.height+$t*2,it?.height||0)+Ft,Ht=-Et/2,Ot=-qt/2;kt.attr("transform","translate("+(_t-Et/2)+", "+(-Ft-mt.height/2)+")"),wt.attr("transform","translate("+(_t-Et/2)+", "+(-Ft+mt.height/2)+")"),It.attr("transform","translate("+(_t+Et/2-Nt.width-2*pt)+", "+(-Ft+mt.height/2)+")");let Zt;const{rx:Yt,ry:aa}=it,{cssStyles:Qt}=it;if(it.look==="handDrawn"){const oa=at.svg(ft),la=userNodeOverrides(it,{}),Kt=Yt||aa?oa.path(createRoundedRectPathD(Ht,Ot,Et,qt,Yt||0),la):oa.rectangle(Ht,Ot,Et,qt,la);Zt=ft.insert(()=>Kt,":first-child"),Zt.attr("class","basic label-container").attr("style",Qt||null)}else{Zt=ft.insert("rect",":first-child"),Zt.attr("class","basic label-container __APA__").attr("style",ut).attr("rx",Yt??5).attr("ry",aa??5).attr("x",Ht).attr("y",Ot).attr("width",Et).attr("height",qt);const oa="priority"in it&&it.priority;if(oa){const la=ft.append("line"),Kt=Ht+2,ra=Ot+Math.floor((Yt??0)/2),Ut=Ot+qt-Math.floor((Yt??0)/2);la.attr("x1",Kt).attr("y1",ra).attr("x2",Kt).attr("y2",Ut).attr("stroke-width","4").attr("stroke",colorFromPriority(oa))}}return updateNodeBounds(it,Zt),it.height=qt,it.intersect=function(oa){return intersect_default.rect(it,oa)},ft}__name(kanbanItem,"kanbanItem");async function bang(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,halfPadding:yt,label:ft}=await labelHelper(rt,it,getNodeClasses(it)),mt=pt.width+10*yt,kt=pt.height+8*yt,_t=.15*mt,{cssStyles:vt}=it,bt=pt.width+20,Mt=pt.height+20,wt=Math.max(mt,bt),St=Math.max(kt,Mt);ft.attr("transform",`translate(${-pt.width/2}, ${-pt.height/2})`);let It;const Nt=`M0 0 
-    a${_t},${_t} 1 0,0 ${wt*.25},${-1*St*.1}
-    a${_t},${_t} 1 0,0 ${wt*.25},0
-    a${_t},${_t} 1 0,0 ${wt*.25},0
-    a${_t},${_t} 1 0,0 ${wt*.25},${St*.1}
-
-    a${_t},${_t} 1 0,0 ${wt*.15},${St*.33}
-    a${_t*.8},${_t*.8} 1 0,0 0,${St*.34}
-    a${_t},${_t} 1 0,0 ${-1*wt*.15},${St*.33}
-
-    a${_t},${_t} 1 0,0 ${-1*wt*.25},${St*.15}
-    a${_t},${_t} 1 0,0 ${-1*wt*.25},0
-    a${_t},${_t} 1 0,0 ${-1*wt*.25},0
-    a${_t},${_t} 1 0,0 ${-1*wt*.25},${-1*St*.15}
-
-    a${_t},${_t} 1 0,0 ${-1*wt*.1},${-1*St*.33}
-    a${_t*.8},${_t*.8} 1 0,0 0,${-1*St*.34}
-    a${_t},${_t} 1 0,0 ${wt*.1},${-1*St*.33}
-  H0 V0 Z`;if(it.look==="handDrawn"){const $t=at.svg(ut),Et=userNodeOverrides(it,{}),Ft=$t.path(Nt,Et);It=ut.insert(()=>Ft,":first-child"),It.attr("class","basic label-container").attr("style",handleUndefinedAttr(vt))}else It=ut.insert("path",":first-child").attr("class","basic label-container").attr("style",dt).attr("d",Nt);return It.attr("transform",`translate(${-wt/2}, ${-St/2})`),updateNodeBounds(it,It),it.calcIntersect=function($t,Et){return intersect_default.rect($t,Et)},it.intersect=function($t){return log.info("Bang intersect",it,$t),intersect_default.rect(it,$t)},ut}__name(bang,"bang");async function cloud(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,halfPadding:yt,label:ft}=await labelHelper(rt,it,getNodeClasses(it)),mt=pt.width+2*yt,kt=pt.height+2*yt,_t=.15*mt,vt=.25*mt,bt=.35*mt,Mt=.2*mt,{cssStyles:wt}=it;let St;const It=`M0 0 
-    a${_t},${_t} 0 0,1 ${mt*.25},${-1*mt*.1}
-    a${bt},${bt} 1 0,1 ${mt*.4},${-1*mt*.1}
-    a${vt},${vt} 1 0,1 ${mt*.35},${mt*.2}
-
-    a${_t},${_t} 1 0,1 ${mt*.15},${kt*.35}
-    a${Mt},${Mt} 1 0,1 ${-1*mt*.15},${kt*.65}
-
-    a${vt},${_t} 1 0,1 ${-1*mt*.25},${mt*.15}
-    a${bt},${bt} 1 0,1 ${-1*mt*.5},0
-    a${_t},${_t} 1 0,1 ${-1*mt*.25},${-1*mt*.15}
-
-    a${_t},${_t} 1 0,1 ${-1*mt*.1},${-1*kt*.35}
-    a${Mt},${Mt} 1 0,1 ${mt*.1},${-1*kt*.65}
-  H0 V0 Z`;if(it.look==="handDrawn"){const Nt=at.svg(ut),$t=userNodeOverrides(it,{}),Et=Nt.path(It,$t);St=ut.insert(()=>Et,":first-child"),St.attr("class","basic label-container").attr("style",handleUndefinedAttr(wt))}else St=ut.insert("path",":first-child").attr("class","basic label-container").attr("style",dt).attr("d",It);return ft.attr("transform",`translate(${-pt.width/2}, ${-pt.height/2})`),St.attr("transform",`translate(${-mt/2}, ${-kt/2})`),updateNodeBounds(it,St),it.calcIntersect=function(Nt,$t){return intersect_default.rect(Nt,$t)},it.intersect=function(Nt){return log.info("Cloud intersect",it,Nt),intersect_default.rect(it,Nt)},ut}__name(cloud,"cloud");async function defaultMindmapNode(rt,it){const{labelStyles:ct,nodeStyles:dt}=styles2String(it);it.labelStyle=ct;const{shapeSvg:ut,bbox:pt,halfPadding:yt,label:ft}=await labelHelper(rt,it,getNodeClasses(it)),mt=pt.width+8*yt,kt=pt.height+2*yt,_t=5,vt=`
-    M${-mt/2} ${kt/2-_t}
-    v${-kt+2*_t}
-    q0,-${_t} ${_t},-${_t}
-    h${mt-2*_t}
-    q${_t},0 ${_t},${_t}
-    v${kt-2*_t}
-    q0,${_t} -${_t},${_t}
-    h${-mt+2*_t}
-    q-${_t},0 -${_t},-${_t}
-    Z
-  `,bt=ut.append("path").attr("id","node-"+it.id).attr("class","node-bkg node-"+it.type).attr("style",dt).attr("d",vt);return ut.append("line").attr("class","node-line-").attr("x1",-mt/2).attr("y1",kt/2).attr("x2",mt/2).attr("y2",kt/2),ft.attr("transform",`translate(${-pt.width/2}, ${-pt.height/2})`),ut.append(()=>ft.node()),updateNodeBounds(it,bt),it.calcIntersect=function(Mt,wt){return intersect_default.rect(Mt,wt)},it.intersect=function(Mt){return intersect_default.rect(it,Mt)},ut}__name(defaultMindmapNode,"defaultMindmapNode");async function mindmapCircle(rt,it){const ct={padding:it.padding??0};return circle$1(rt,it,ct)}__name(mindmapCircle,"mindmapCircle");var shapesDefs=[{semanticName:"Process",name:"Rectangle",shortName:"rect",description:"Standard process shape",aliases:["proc","process","rectangle"],internalAliases:["squareRect"],handler:squareRect2},{semanticName:"Event",name:"Rounded Rectangle",shortName:"rounded",description:"Represents an event",aliases:["event"],internalAliases:["roundedRect"],handler:roundedRect},{semanticName:"Terminal Point",name:"Stadium",shortName:"stadium",description:"Terminal point",aliases:["terminal","pill"],handler:stadium},{semanticName:"Subprocess",name:"Framed Rectangle",shortName:"fr-rect",description:"Subprocess",aliases:["subprocess","subproc","framed-rectangle","subroutine"],handler:subroutine},{semanticName:"Database",name:"Cylinder",shortName:"cyl",description:"Database storage",aliases:["db","database","cylinder"],handler:cylinder},{semanticName:"Start",name:"Circle",shortName:"circle",description:"Starting point",aliases:["circ"],handler:circle$1},{semanticName:"Bang",name:"Bang",shortName:"bang",description:"Bang",aliases:["bang"],handler:bang},{semanticName:"Cloud",name:"Cloud",shortName:"cloud",description:"cloud",aliases:["cloud"],handler:cloud},{semanticName:"Decision",name:"Diamond",shortName:"diam",description:"Decision-making step",aliases:["decision","diamond","question"],handler:question},{semanticName:"Prepare Conditional",name:"Hexagon",shortName:"hex",description:"Preparation or condition step",aliases:["hexagon","prepare"],handler:hexagon},{semanticName:"Data Input/Output",name:"Lean Right",shortName:"lean-r",description:"Represents input or output",aliases:["lean-right","in-out"],internalAliases:["lean_right"],handler:lean_right},{semanticName:"Data Input/Output",name:"Lean Left",shortName:"lean-l",description:"Represents output or input",aliases:["lean-left","out-in"],internalAliases:["lean_left"],handler:lean_left},{semanticName:"Priority Action",name:"Trapezoid Base Bottom",shortName:"trap-b",description:"Priority action",aliases:["priority","trapezoid-bottom","trapezoid"],handler:trapezoid},{semanticName:"Manual Operation",name:"Trapezoid Base Top",shortName:"trap-t",description:"Represents a manual task",aliases:["manual","trapezoid-top","inv-trapezoid"],internalAliases:["inv_trapezoid"],handler:inv_trapezoid},{semanticName:"Stop",name:"Double Circle",shortName:"dbl-circ",description:"Represents a stop point",aliases:["double-circle"],internalAliases:["doublecircle"],handler:doublecircle},{semanticName:"Text Block",name:"Text Block",shortName:"text",description:"Text block",handler:text},{semanticName:"Card",name:"Notched Rectangle",shortName:"notch-rect",description:"Represents a card",aliases:["card","notched-rectangle"],handler:card},{semanticName:"Lined/Shaded Process",name:"Lined Rectangle",shortName:"lin-rect",description:"Lined process shape",aliases:["lined-rectangle","lined-process","lin-proc","shaded-process"],handler:shadedProcess},{semanticName:"Start",name:"Small Circle",shortName:"sm-circ",description:"Small starting point",aliases:["start","small-circle"],internalAliases:["stateStart"],handler:stateStart},{semanticName:"Stop",name:"Framed Circle",shortName:"fr-circ",description:"Stop point",aliases:["stop","framed-circle"],internalAliases:["stateEnd"],handler:stateEnd},{semanticName:"Fork/Join",name:"Filled Rectangle",shortName:"fork",description:"Fork or join in process flow",aliases:["join"],internalAliases:["forkJoin"],handler:forkJoin},{semanticName:"Collate",name:"Hourglass",shortName:"hourglass",description:"Represents a collate operation",aliases:["hourglass","collate"],handler:hourglass},{semanticName:"Comment",name:"Curly Brace",shortName:"brace",description:"Adds a comment",aliases:["comment","brace-l"],handler:curlyBraceLeft},{semanticName:"Comment Right",name:"Curly Brace",shortName:"brace-r",description:"Adds a comment",handler:curlyBraceRight},{semanticName:"Comment with braces on both sides",name:"Curly Braces",shortName:"braces",description:"Adds a comment",handler:curlyBraces},{semanticName:"Com Link",name:"Lightning Bolt",shortName:"bolt",description:"Communication link",aliases:["com-link","lightning-bolt"],handler:lightningBolt},{semanticName:"Document",name:"Document",shortName:"doc",description:"Represents a document",aliases:["doc","document"],handler:waveEdgedRectangle},{semanticName:"Delay",name:"Half-Rounded Rectangle",shortName:"delay",description:"Represents a delay",aliases:["half-rounded-rectangle"],handler:halfRoundedRectangle},{semanticName:"Direct Access Storage",name:"Horizontal Cylinder",shortName:"h-cyl",description:"Direct access storage",aliases:["das","horizontal-cylinder"],handler:tiltedCylinder},{semanticName:"Disk Storage",name:"Lined Cylinder",shortName:"lin-cyl",description:"Disk storage",aliases:["disk","lined-cylinder"],handler:linedCylinder},{semanticName:"Display",name:"Curved Trapezoid",shortName:"curv-trap",description:"Represents a display",aliases:["curved-trapezoid","display"],handler:curvedTrapezoid},{semanticName:"Divided Process",name:"Divided Rectangle",shortName:"div-rect",description:"Divided process shape",aliases:["div-proc","divided-rectangle","divided-process"],handler:dividedRectangle},{semanticName:"Extract",name:"Triangle",shortName:"tri",description:"Extraction process",aliases:["extract","triangle"],handler:triangle},{semanticName:"Internal Storage",name:"Window Pane",shortName:"win-pane",description:"Internal storage",aliases:["internal-storage","window-pane"],handler:windowPane},{semanticName:"Junction",name:"Filled Circle",shortName:"f-circ",description:"Junction point",aliases:["junction","filled-circle"],handler:filledCircle},{semanticName:"Loop Limit",name:"Trapezoidal Pentagon",shortName:"notch-pent",description:"Loop limit step",aliases:["loop-limit","notched-pentagon"],handler:trapezoidalPentagon},{semanticName:"Manual File",name:"Flipped Triangle",shortName:"flip-tri",description:"Manual file operation",aliases:["manual-file","flipped-triangle"],handler:flippedTriangle},{semanticName:"Manual Input",name:"Sloped Rectangle",shortName:"sl-rect",description:"Manual input step",aliases:["manual-input","sloped-rectangle"],handler:slopedRect},{semanticName:"Multi-Document",name:"Stacked Document",shortName:"docs",description:"Multiple documents",aliases:["documents","st-doc","stacked-document"],handler:multiWaveEdgedRectangle},{semanticName:"Multi-Process",name:"Stacked Rectangle",shortName:"st-rect",description:"Multiple processes",aliases:["procs","processes","stacked-rectangle"],handler:multiRect},{semanticName:"Stored Data",name:"Bow Tie Rectangle",shortName:"bow-rect",description:"Stored data",aliases:["stored-data","bow-tie-rectangle"],handler:bowTieRect},{semanticName:"Summary",name:"Crossed Circle",shortName:"cross-circ",description:"Summary",aliases:["summary","crossed-circle"],handler:crossedCircle},{semanticName:"Tagged Document",name:"Tagged Document",shortName:"tag-doc",description:"Tagged document",aliases:["tag-doc","tagged-document"],handler:taggedWaveEdgedRectangle},{semanticName:"Tagged Process",name:"Tagged Rectangle",shortName:"tag-rect",description:"Tagged process",aliases:["tagged-rectangle","tag-proc","tagged-process"],handler:taggedRect},{semanticName:"Paper Tape",name:"Flag",shortName:"flag",description:"Paper tape",aliases:["paper-tape"],handler:waveRectangle},{semanticName:"Odd",name:"Odd",shortName:"odd",description:"Odd shape",internalAliases:["rect_left_inv_arrow"],handler:rect_left_inv_arrow},{semanticName:"Lined Document",name:"Lined Document",shortName:"lin-doc",description:"Lined document",aliases:["lined-document"],handler:linedWaveEdgedRect}],generateShapeMap=__name(()=>{const it=[...Object.entries({state,choice,note,rectWithTitle,labelRect,iconSquare,iconCircle,icon,iconRounded,imageSquare,anchor,kanbanItem,mindmapCircle,defaultMindmapNode,classBox,erBox,requirementBox}),...shapesDefs.flatMap(ct=>[ct.shortName,..."aliases"in ct?ct.aliases:[],..."internalAliases"in ct?ct.internalAliases:[]].map(ut=>[ut,ct.handler]))];return Object.fromEntries(it)},"generateShapeMap"),shapes2=generateShapeMap();function isValidShape(rt){return rt in shapes2}__name(isValidShape,"isValidShape");var nodeElems=new Map;async function insertNode(rt,it,ct){let dt,ut;it.shape==="rect"&&(it.rx&&it.ry?it.shape="roundedRect":it.shape="squareRect");const pt=it.shape?shapes2[it.shape]:void 0;if(!pt)throw new Error(`No such shape: ${it.shape}. Please check your syntax.`);if(it.link){let yt;ct.config.securityLevel==="sandbox"?yt="_top":it.linkTarget&&(yt=it.linkTarget||"_blank"),dt=rt.insert("svg:a").attr("xlink:href",it.link).attr("target",yt??null),ut=await pt(dt,it,ct)}else ut=await pt(rt,it,ct),dt=ut;return it.tooltip&&ut.attr("title",it.tooltip),nodeElems.set(it.id,dt),it.haveCallback&&dt.attr("class",dt.attr("class")+" clickable"),dt}__name(insertNode,"insertNode");var setNodeElem=__name((rt,it)=>{nodeElems.set(it.id,rt)},"setNodeElem"),clear2=__name(()=>{nodeElems.clear()},"clear"),positionNode=__name(rt=>{const it=nodeElems.get(rt.id);log.trace("Transforming node",rt.diff,rt,"translate("+(rt.x-rt.width/2-5)+", "+rt.width/2+")");const ct=8,dt=rt.diff||0;return rt.clusterNode?it.attr("transform","translate("+(rt.x+dt-rt.width/2)+", "+(rt.y-rt.height/2-ct)+")"):it.attr("transform","translate("+rt.x+", "+rt.y+")"),dt},"positionNode"),addEdgeMarkers=__name((rt,it,ct,dt,ut,pt)=>{it.arrowTypeStart&&addEdgeMarker(rt,"start",it.arrowTypeStart,ct,dt,ut,pt),it.arrowTypeEnd&&addEdgeMarker(rt,"end",it.arrowTypeEnd,ct,dt,ut,pt)},"addEdgeMarkers"),arrowTypesMap={arrow_cross:{type:"cross",fill:!1},arrow_point:{type:"point",fill:!0},arrow_barb:{type:"barb",fill:!0},arrow_circle:{type:"circle",fill:!1},aggregation:{type:"aggregation",fill:!1},extension:{type:"extension",fill:!1},composition:{type:"composition",fill:!0},dependency:{type:"dependency",fill:!0},lollipop:{type:"lollipop",fill:!1},only_one:{type:"onlyOne",fill:!1},zero_or_one:{type:"zeroOrOne",fill:!1},one_or_more:{type:"oneOrMore",fill:!1},zero_or_more:{type:"zeroOrMore",fill:!1},requirement_arrow:{type:"requirement_arrow",fill:!1},requirement_contains:{type:"requirement_contains",fill:!1}},addEdgeMarker=__name((rt,it,ct,dt,ut,pt,yt)=>{const ft=arrowTypesMap[ct];if(!ft){log.warn(`Unknown arrow type: ${ct}`);return}const mt=ft.type,_t=`${ut}_${pt}-${mt}${it==="start"?"Start":"End"}`;if(yt&&yt.trim()!==""){const vt=yt.replace(/[^\dA-Za-z]/g,"_"),bt=`${_t}_${vt}`;if(!document.getElementById(bt)){const Mt=document.getElementById(_t);if(Mt){const wt=Mt.cloneNode(!0);wt.id=bt,wt.querySelectorAll("path, circle, line").forEach(It=>{It.setAttribute("stroke",yt),ft.fill&&It.setAttribute("fill",yt)}),Mt.parentNode?.appendChild(wt)}}rt.attr(`marker-${it}`,`url(${dt}#${bt})`)}else rt.attr(`marker-${it}`,`url(${dt}#${_t})`)},"addEdgeMarker"),edgeLabels=new Map,terminalLabels=new Map,clear=__name(()=>{edgeLabels.clear(),terminalLabels.clear()},"clear"),getLabelStyles=__name(rt=>rt?rt.reduce((ct,dt)=>ct+";"+dt,""):"","getLabelStyles"),insertEdgeLabel=__name(async(rt,it)=>{let ct=evaluate(getConfig2().flowchart.htmlLabels);const{labelStyles:dt}=styles2String(it);it.labelStyle=dt;const ut=await createText(rt,it.label,{style:it.labelStyle,useHtmlLabels:ct,addSvgBackground:!0,isNode:!1});log.info("abc82",it,it.labelType);const pt=rt.insert("g").attr("class","edgeLabel"),yt=pt.insert("g").attr("class","label").attr("data-id",it.id);yt.node().appendChild(ut);let ft=ut.getBBox();if(ct){const kt=ut.children[0],_t=select(ut);ft=kt.getBoundingClientRect(),_t.attr("width",ft.width),_t.attr("height",ft.height)}yt.attr("transform","translate("+-ft.width/2+", "+-ft.height/2+")"),edgeLabels.set(it.id,pt),it.width=ft.width,it.height=ft.height;let mt;if(it.startLabelLeft){const kt=await createLabel_default(it.startLabelLeft,getLabelStyles(it.labelStyle)),_t=rt.insert("g").attr("class","edgeTerminals"),vt=_t.insert("g").attr("class","inner");mt=vt.node().appendChild(kt);const bt=kt.getBBox();vt.attr("transform","translate("+-bt.width/2+", "+-bt.height/2+")"),terminalLabels.get(it.id)||terminalLabels.set(it.id,{}),terminalLabels.get(it.id).startLeft=_t,setTerminalWidth(mt,it.startLabelLeft)}if(it.startLabelRight){const kt=await createLabel_default(it.startLabelRight,getLabelStyles(it.labelStyle)),_t=rt.insert("g").attr("class","edgeTerminals"),vt=_t.insert("g").attr("class","inner");mt=_t.node().appendChild(kt),vt.node().appendChild(kt);const bt=kt.getBBox();vt.attr("transform","translate("+-bt.width/2+", "+-bt.height/2+")"),terminalLabels.get(it.id)||terminalLabels.set(it.id,{}),terminalLabels.get(it.id).startRight=_t,setTerminalWidth(mt,it.startLabelRight)}if(it.endLabelLeft){const kt=await createLabel_default(it.endLabelLeft,getLabelStyles(it.labelStyle)),_t=rt.insert("g").attr("class","edgeTerminals"),vt=_t.insert("g").attr("class","inner");mt=vt.node().appendChild(kt);const bt=kt.getBBox();vt.attr("transform","translate("+-bt.width/2+", "+-bt.height/2+")"),_t.node().appendChild(kt),terminalLabels.get(it.id)||terminalLabels.set(it.id,{}),terminalLabels.get(it.id).endLeft=_t,setTerminalWidth(mt,it.endLabelLeft)}if(it.endLabelRight){const kt=await createLabel_default(it.endLabelRight,getLabelStyles(it.labelStyle)),_t=rt.insert("g").attr("class","edgeTerminals"),vt=_t.insert("g").attr("class","inner");mt=vt.node().appendChild(kt);const bt=kt.getBBox();vt.attr("transform","translate("+-bt.width/2+", "+-bt.height/2+")"),_t.node().appendChild(kt),terminalLabels.get(it.id)||terminalLabels.set(it.id,{}),terminalLabels.get(it.id).endRight=_t,setTerminalWidth(mt,it.endLabelRight)}return ut},"insertEdgeLabel");function setTerminalWidth(rt,it){getConfig2().flowchart.htmlLabels&&rt&&(rt.style.width=it.length*9+"px",rt.style.height="12px")}__name(setTerminalWidth,"setTerminalWidth");var positionEdgeLabel=__name((rt,it)=>{log.debug("Moving label abc88 ",rt.id,rt.label,edgeLabels.get(rt.id),it);let ct=it.updatedPath?it.updatedPath:it.originalPath;const dt=getConfig2(),{subGraphTitleTotalMargin:ut}=getSubGraphTitleMargins(dt);if(rt.label){const pt=edgeLabels.get(rt.id);let yt=rt.x,ft=rt.y;if(ct){const mt=utils_default.calcLabelPosition(ct);log.debug("Moving label "+rt.label+" from (",yt,",",ft,") to (",mt.x,",",mt.y,") abc88"),it.updatedPath&&(yt=mt.x,ft=mt.y)}pt.attr("transform",`translate(${yt}, ${ft+ut/2})`)}if(rt.startLabelLeft){const pt=terminalLabels.get(rt.id).startLeft;let yt=rt.x,ft=rt.y;if(ct){const mt=utils_default.calcTerminalLabelPosition(rt.arrowTypeStart?10:0,"start_left",ct);yt=mt.x,ft=mt.y}pt.attr("transform",`translate(${yt}, ${ft})`)}if(rt.startLabelRight){const pt=terminalLabels.get(rt.id).startRight;let yt=rt.x,ft=rt.y;if(ct){const mt=utils_default.calcTerminalLabelPosition(rt.arrowTypeStart?10:0,"start_right",ct);yt=mt.x,ft=mt.y}pt.attr("transform",`translate(${yt}, ${ft})`)}if(rt.endLabelLeft){const pt=terminalLabels.get(rt.id).endLeft;let yt=rt.x,ft=rt.y;if(ct){const mt=utils_default.calcTerminalLabelPosition(rt.arrowTypeEnd?10:0,"end_left",ct);yt=mt.x,ft=mt.y}pt.attr("transform",`translate(${yt}, ${ft})`)}if(rt.endLabelRight){const pt=terminalLabels.get(rt.id).endRight;let yt=rt.x,ft=rt.y;if(ct){const mt=utils_default.calcTerminalLabelPosition(rt.arrowTypeEnd?10:0,"end_right",ct);yt=mt.x,ft=mt.y}pt.attr("transform",`translate(${yt}, ${ft})`)}},"positionEdgeLabel"),outsideNode=__name((rt,it)=>{const ct=rt.x,dt=rt.y,ut=Math.abs(it.x-ct),pt=Math.abs(it.y-dt),yt=rt.width/2,ft=rt.height/2;return ut>=yt||pt>=ft},"outsideNode"),intersection=__name((rt,it,ct)=>{log.debug(`intersection calc abc89:
-  outsidePoint: ${JSON.stringify(it)}
-  insidePoint : ${JSON.stringify(ct)}
-  node        : x:${rt.x} y:${rt.y} w:${rt.width} h:${rt.height}`);const dt=rt.x,ut=rt.y,pt=Math.abs(dt-ct.x),yt=rt.width/2;let ft=ct.x<it.x?yt-pt:yt+pt;const mt=rt.height/2,kt=Math.abs(it.y-ct.y),_t=Math.abs(it.x-ct.x);if(Math.abs(ut-it.y)*yt>Math.abs(dt-it.x)*mt){let vt=ct.y<it.y?it.y-mt-ut:ut-mt-it.y;ft=_t*vt/kt;const bt={x:ct.x<it.x?ct.x+ft:ct.x-_t+ft,y:ct.y<it.y?ct.y+kt-vt:ct.y-kt+vt};return ft===0&&(bt.x=it.x,bt.y=it.y),_t===0&&(bt.x=it.x),kt===0&&(bt.y=it.y),log.debug(`abc89 top/bottom calc, Q ${kt}, q ${vt}, R ${_t}, r ${ft}`,bt),bt}else{ct.x<it.x?ft=it.x-yt-dt:ft=dt-yt-it.x;let vt=kt*ft/_t,bt=ct.x<it.x?ct.x+_t-ft:ct.x-_t+ft,Mt=ct.y<it.y?ct.y+vt:ct.y-vt;return log.debug(`sides calc abc89, Q ${kt}, q ${vt}, R ${_t}, r ${ft}`,{_x:bt,_y:Mt}),ft===0&&(bt=it.x,Mt=it.y),_t===0&&(bt=it.x),kt===0&&(Mt=it.y),{x:bt,y:Mt}}},"intersection"),cutPathAtIntersect=__name((rt,it)=>{log.warn("abc88 cutPathAtIntersect",rt,it);let ct=[],dt=rt[0],ut=!1;return rt.forEach(pt=>{if(log.info("abc88 checking point",pt,it),!outsideNode(it,pt)&&!ut){const yt=intersection(it,dt,pt);log.debug("abc88 inside",pt,dt,yt),log.debug("abc88 intersection",yt,it);let ft=!1;ct.forEach(mt=>{ft=ft||mt.x===yt.x&&mt.y===yt.y}),ct.some(mt=>mt.x===yt.x&&mt.y===yt.y)?log.warn("abc88 no intersect",yt,ct):ct.push(yt),ut=!0}else log.warn("abc88 outside",pt,dt),dt=pt,ut||ct.push(pt)}),log.debug("returning points",ct),ct},"cutPathAtIntersect");function extractCornerPoints(rt){const it=[],ct=[];for(let dt=1;dt<rt.length-1;dt++){const ut=rt[dt-1],pt=rt[dt],yt=rt[dt+1];(ut.x===pt.x&&pt.y===yt.y&&Math.abs(pt.x-yt.x)>5&&Math.abs(pt.y-ut.y)>5||ut.y===pt.y&&pt.x===yt.x&&Math.abs(pt.x-ut.x)>5&&Math.abs(pt.y-yt.y)>5)&&(it.push(pt),ct.push(dt))}return{cornerPoints:it,cornerPointPositions:ct}}__name(extractCornerPoints,"extractCornerPoints");var findAdjacentPoint=__name(function(rt,it,ct){const dt=it.x-rt.x,ut=it.y-rt.y,pt=Math.sqrt(dt*dt+ut*ut),yt=ct/pt;return{x:it.x-yt*dt,y:it.y-yt*ut}},"findAdjacentPoint"),fixCorners=__name(function(rt){const{cornerPointPositions:it}=extractCornerPoints(rt),ct=[];for(let dt=0;dt<rt.length;dt++)if(it.includes(dt)){const ut=rt[dt-1],pt=rt[dt+1],yt=rt[dt],ft=findAdjacentPoint(ut,yt,5),mt=findAdjacentPoint(pt,yt,5),kt=mt.x-ft.x,_t=mt.y-ft.y;ct.push(ft);const vt=Math.sqrt(2)*2;let bt={x:yt.x,y:yt.y};if(Math.abs(pt.x-ut.x)>10&&Math.abs(pt.y-ut.y)>=10){log.debug("Corner point fixing",Math.abs(pt.x-ut.x),Math.abs(pt.y-ut.y));const Mt=5;yt.x===ft.x?bt={x:kt<0?ft.x-Mt+vt:ft.x+Mt-vt,y:_t<0?ft.y-vt:ft.y+vt}:bt={x:kt<0?ft.x-vt:ft.x+vt,y:_t<0?ft.y-Mt+vt:ft.y+Mt-vt}}else log.debug("Corner point skipping fixing",Math.abs(pt.x-ut.x),Math.abs(pt.y-ut.y));ct.push(bt,mt)}else ct.push(rt[dt]);return ct},"fixCorners"),generateDashArray=__name((rt,it,ct)=>{const dt=rt-it-ct,ut=2,pt=2,yt=ut+pt,ft=Math.floor(dt/yt),mt=Array(ft).fill(`${ut} ${pt}`).join(" ");return`0 ${it} ${mt} ${ct}`},"generateDashArray"),insertEdge=__name(function(rt,it,ct,dt,ut,pt,yt,ft=!1){const{handDrawnSeed:mt}=getConfig2();let kt=it.points,_t=!1;const vt=ut;var bt=pt;const Mt=[];for(const Kt in it.cssCompiledStyles)isLabelStyle(Kt)||Mt.push(it.cssCompiledStyles[Kt]);log.debug("UIO intersect check",it.points,bt.x,vt.x),bt.intersect&&vt.intersect&&!ft&&(kt=kt.slice(1,it.points.length-1),kt.unshift(vt.intersect(kt[0])),log.debug("Last point UIO",it.start,"-->",it.end,kt[kt.length-1],bt,bt.intersect(kt[kt.length-1])),kt.push(bt.intersect(kt[kt.length-1])));const wt=btoa(JSON.stringify(kt));it.toCluster&&(log.info("to cluster abc88",ct.get(it.toCluster)),kt=cutPathAtIntersect(it.points,ct.get(it.toCluster).node),_t=!0),it.fromCluster&&(log.debug("from cluster abc88",ct.get(it.fromCluster),JSON.stringify(kt,null,2)),kt=cutPathAtIntersect(kt.reverse(),ct.get(it.fromCluster).node).reverse(),_t=!0);let St=kt.filter(Kt=>!Number.isNaN(Kt.y));St=fixCorners(St);let It=curveBasis;switch(It=curveLinear,it.curve){case"linear":It=curveLinear;break;case"basis":It=curveBasis;break;case"cardinal":It=curveCardinal;break;case"bumpX":It=bumpX;break;case"bumpY":It=bumpY;break;case"catmullRom":It=curveCatmullRom;break;case"monotoneX":It=monotoneX;break;case"monotoneY":It=monotoneY;break;case"natural":It=curveNatural;break;case"step":It=curveStep;break;case"stepAfter":It=stepAfter;break;case"stepBefore":It=stepBefore;break;default:It=curveBasis}const{x:Nt,y:$t}=getLineFunctionsWithOffset(it),Et=line$1().x(Nt).y($t).curve(It);let Ft;switch(it.thickness){case"normal":Ft="edge-thickness-normal";break;case"thick":Ft="edge-thickness-thick";break;case"invisible":Ft="edge-thickness-invisible";break;default:Ft="edge-thickness-normal"}switch(it.pattern){case"solid":Ft+=" edge-pattern-solid";break;case"dotted":Ft+=" edge-pattern-dotted";break;case"dashed":Ft+=" edge-pattern-dashed";break;default:Ft+=" edge-pattern-solid"}let qt,Ht=it.curve==="rounded"?generateRoundedPath(applyMarkerOffsetsToPoints(St,it),5):Et(St);const Ot=Array.isArray(it.style)?it.style:[it.style];let Zt=Ot.find(Kt=>Kt?.startsWith("stroke:")),Yt=!1;if(it.look==="handDrawn"){const Kt=at.svg(rt);Object.assign([],St);const ra=Kt.path(Ht,{roughness:.3,seed:mt});Ft+=" transition",qt=select(ra).select("path").attr("id",it.id).attr("class"," "+Ft+(it.classes?" "+it.classes:"")).attr("style",Ot?Ot.reduce((ea,Gt)=>ea+";"+Gt,""):"");let Ut=qt.attr("d");qt.attr("d",Ut),rt.node().appendChild(qt.node())}else{const Kt=Mt.join(";"),ra=Ot?Ot.reduce((ta,sa)=>ta+sa+";",""):"";let Ut="";it.animate&&(Ut=" edge-animation-fast"),it.animation&&(Ut=" edge-animation-"+it.animation);const ea=(Kt?Kt+";"+ra+";":ra)+";"+(Ot?Ot.reduce((ta,sa)=>ta+";"+sa,""):"");qt=rt.append("path").attr("d",Ht).attr("id",it.id).attr("class"," "+Ft+(it.classes?" "+it.classes:"")+(Ut??"")).attr("style",ea),Zt=ea.match(/stroke:([^;]+)/)?.[1],Yt=it.animate===!0||!!it.animation||Kt.includes("animation");const Gt=qt.node(),_a=typeof Gt.getTotalLength=="function"?Gt.getTotalLength():0,Ca=markerOffsets2[it.arrowTypeStart]||0,Vt=markerOffsets2[it.arrowTypeEnd]||0;if(it.look==="neo"&&!Yt){const sa=`stroke-dasharray: ${it.pattern==="dotted"||it.pattern==="dashed"?generateDashArray(_a,Ca,Vt):`0 ${Ca} ${_a-Ca-Vt} ${Vt}`}; stroke-dashoffset: 0;`;qt.attr("style",sa+qt.attr("style"))}}qt.attr("data-edge",!0),qt.attr("data-et","edge"),qt.attr("data-id",it.id),qt.attr("data-points",wt),it.showPoints&&St.forEach(Kt=>{rt.append("circle").style("stroke","red").style("fill","red").attr("r",1).attr("cx",Kt.x).attr("cy",Kt.y)});let aa="";(getConfig2().flowchart.arrowMarkerAbsolute||getConfig2().state.arrowMarkerAbsolute)&&(aa=window.location.protocol+"//"+window.location.host+window.location.pathname+window.location.search,aa=aa.replace(/\(/g,"\\(").replace(/\)/g,"\\)")),log.info("arrowTypeStart",it.arrowTypeStart),log.info("arrowTypeEnd",it.arrowTypeEnd),addEdgeMarkers(qt,it,aa,yt,dt,Zt);const Qt=Math.floor(kt.length/2),oa=kt[Qt];utils_default.isLabelCoordinateInPath(oa,qt.attr("d"))||(_t=!0);let la={};return _t&&(la.updatedPath=kt),la.originalPath=it.points,la},"insertEdge");function generateRoundedPath(rt,it){if(rt.length<2)return"";let ct="";const dt=rt.length,ut=1e-5;for(let pt=0;pt<dt;pt++){const yt=rt[pt],ft=rt[pt-1],mt=rt[pt+1];if(pt===0)ct+=`M${yt.x},${yt.y}`;else if(pt===dt-1)ct+=`L${yt.x},${yt.y}`;else{const kt=yt.x-ft.x,_t=yt.y-ft.y,vt=mt.x-yt.x,bt=mt.y-yt.y,Mt=Math.hypot(kt,_t),wt=Math.hypot(vt,bt);if(Mt<ut||wt<ut){ct+=`L${yt.x},${yt.y}`;continue}const St=kt/Mt,It=_t/Mt,Nt=vt/wt,$t=bt/wt,Et=St*Nt+It*$t,Ft=Math.max(-1,Math.min(1,Et)),qt=Math.acos(Ft);if(qt<ut||Math.abs(Math.PI-qt)<ut){ct+=`L${yt.x},${yt.y}`;continue}const Ht=Math.min(it/Math.sin(qt/2),Mt/2,wt/2),Ot=yt.x-St*Ht,Zt=yt.y-It*Ht,Yt=yt.x+Nt*Ht,aa=yt.y+$t*Ht;ct+=`L${Ot},${Zt}`,ct+=`Q${yt.x},${yt.y} ${Yt},${aa}`}}return ct}__name(generateRoundedPath,"generateRoundedPath");function calculateDeltaAndAngle(rt,it){if(!rt||!it)return{angle:0,deltaX:0,deltaY:0};const ct=it.x-rt.x,dt=it.y-rt.y;return{angle:Math.atan2(dt,ct),deltaX:ct,deltaY:dt}}__name(calculateDeltaAndAngle,"calculateDeltaAndAngle");function applyMarkerOffsetsToPoints(rt,it){const ct=rt.map(ut=>({...ut}));if(rt.length>=2&&markerOffsets[it.arrowTypeStart]){const ut=markerOffsets[it.arrowTypeStart],pt=rt[0],yt=rt[1],{angle:ft}=calculateDeltaAndAngle(pt,yt),mt=ut*Math.cos(ft),kt=ut*Math.sin(ft);ct[0].x=pt.x+mt,ct[0].y=pt.y+kt}const dt=rt.length;if(dt>=2&&markerOffsets[it.arrowTypeEnd]){const ut=markerOffsets[it.arrowTypeEnd],pt=rt[dt-1],yt=rt[dt-2],{angle:ft}=calculateDeltaAndAngle(yt,pt),mt=ut*Math.cos(ft),kt=ut*Math.sin(ft);ct[dt-1].x=pt.x-mt,ct[dt-1].y=pt.y-kt}return ct}__name(applyMarkerOffsetsToPoints,"applyMarkerOffsetsToPoints");var insertMarkers=__name((rt,it,ct,dt)=>{it.forEach(ut=>{markers[ut](rt,ct,dt)})},"insertMarkers"),extension=__name((rt,it,ct)=>{log.trace("Making markers for ",ct),rt.append("defs").append("marker").attr("id",ct+"_"+it+"-extensionStart").attr("class","marker extension "+it).attr("refX",18).attr("refY",7).attr("markerWidth",190).attr("markerHeight",240).attr("orient","auto").append("path").attr("d","M 1,7 L18,13 V 1 Z"),rt.append("defs").append("marker").attr("id",ct+"_"+it+"-extensionEnd").attr("class","marker extension "+it).attr("refX",1).attr("refY",7).attr("markerWidth",20).attr("markerHeight",28).attr("orient","auto").append("path").attr("d","M 1,1 V 13 L18,7 Z")},"extension"),composition=__name((rt,it,ct)=>{rt.append("defs").append("marker").attr("id",ct+"_"+it+"-compositionStart").attr("class","marker composition "+it).attr("refX",18).attr("refY",7).attr("markerWidth",190).attr("markerHeight",240).attr("orient","auto").append("path").attr("d","M 18,7 L9,13 L1,7 L9,1 Z"),rt.append("defs").append("marker").attr("id",ct+"_"+it+"-compositionEnd").attr("class","marker composition "+it).attr("refX",1).attr("refY",7).attr("markerWidth",20).attr("markerHeight",28).attr("orient","auto").append("path").attr("d","M 18,7 L9,13 L1,7 L9,1 Z")},"composition"),aggregation=__name((rt,it,ct)=>{rt.append("defs").append("marker").attr("id",ct+"_"+it+"-aggregationStart").attr("class","marker aggregation "+it).attr("refX",18).attr("refY",7).attr("markerWidth",190).attr("markerHeight",240).attr("orient","auto").append("path").attr("d","M 18,7 L9,13 L1,7 L9,1 Z"),rt.append("defs").append("marker").attr("id",ct+"_"+it+"-aggregationEnd").attr("class","marker aggregation "+it).attr("refX",1).attr("refY",7).attr("markerWidth",20).attr("markerHeight",28).attr("orient","auto").append("path").attr("d","M 18,7 L9,13 L1,7 L9,1 Z")},"aggregation"),dependency=__name((rt,it,ct)=>{rt.append("defs").append("marker").attr("id",ct+"_"+it+"-dependencyStart").attr("class","marker dependency "+it).attr("refX",6).attr("refY",7).attr("markerWidth",190).attr("markerHeight",240).attr("orient","auto").append("path").attr("d","M 5,7 L9,13 L1,7 L9,1 Z"),rt.append("defs").append("marker").attr("id",ct+"_"+it+"-dependencyEnd").attr("class","marker dependency "+it).attr("refX",13).attr("refY",7).attr("markerWidth",20).attr("markerHeight",28).attr("orient","auto").append("path").attr("d","M 18,7 L9,13 L14,7 L9,1 Z")},"dependency"),lollipop=__name((rt,it,ct)=>{rt.append("defs").append("marker").attr("id",ct+"_"+it+"-lollipopStart").attr("class","marker lollipop "+it).attr("refX",13).attr("refY",7).attr("markerWidth",190).attr("markerHeight",240).attr("orient","auto").append("circle").attr("stroke","black").attr("fill","transparent").attr("cx",7).attr("cy",7).attr("r",6),rt.append("defs").append("marker").attr("id",ct+"_"+it+"-lollipopEnd").attr("class","marker lollipop "+it).attr("refX",1).attr("refY",7).attr("markerWidth",190).attr("markerHeight",240).attr("orient","auto").append("circle").attr("stroke","black").attr("fill","transparent").attr("cx",7).attr("cy",7).attr("r",6)},"lollipop"),point=__name((rt,it,ct)=>{rt.append("marker").attr("id",ct+"_"+it+"-pointEnd").attr("class","marker "+it).attr("viewBox","0 0 10 10").attr("refX",5).attr("refY",5).attr("markerUnits","userSpaceOnUse").attr("markerWidth",8).attr("markerHeight",8).attr("orient","auto").append("path").attr("d","M 0 0 L 10 5 L 0 10 z").attr("class","arrowMarkerPath").style("stroke-width",1).style("stroke-dasharray","1,0"),rt.append("marker").attr("id",ct+"_"+it+"-pointStart").attr("class","marker "+it).attr("viewBox","0 0 10 10").attr("refX",4.5).attr("refY",5).attr("markerUnits","userSpaceOnUse").attr("markerWidth",8).attr("markerHeight",8).attr("orient","auto").append("path").attr("d","M 0 5 L 10 10 L 10 0 z").attr("class","arrowMarkerPath").style("stroke-width",1).style("stroke-dasharray","1,0")},"point"),circle=__name((rt,it,ct)=>{rt.append("marker").attr("id",ct+"_"+it+"-circleEnd").attr("class","marker "+it).attr("viewBox","0 0 10 10").attr("refX",11).attr("refY",5).attr("markerUnits","userSpaceOnUse").attr("markerWidth",11).attr("markerHeight",11).attr("orient","auto").append("circle").attr("cx","5").attr("cy","5").attr("r","5").attr("class","arrowMarkerPath").style("stroke-width",1).style("stroke-dasharray","1,0"),rt.append("marker").attr("id",ct+"_"+it+"-circleStart").attr("class","marker "+it).attr("viewBox","0 0 10 10").attr("refX",-1).attr("refY",5).attr("markerUnits","userSpaceOnUse").attr("markerWidth",11).attr("markerHeight",11).attr("orient","auto").append("circle").attr("cx","5").attr("cy","5").attr("r","5").attr("class","arrowMarkerPath").style("stroke-width",1).style("stroke-dasharray","1,0")},"circle"),cross=__name((rt,it,ct)=>{rt.append("marker").attr("id",ct+"_"+it+"-crossEnd").attr("class","marker cross "+it).attr("viewBox","0 0 11 11").attr("refX",12).attr("refY",5.2).attr("markerUnits","userSpaceOnUse").attr("markerWidth",11).attr("markerHeight",11).attr("orient","auto").append("path").attr("d","M 1,1 l 9,9 M 10,1 l -9,9").attr("class","arrowMarkerPath").style("stroke-width",2).style("stroke-dasharray","1,0"),rt.append("marker").attr("id",ct+"_"+it+"-crossStart").attr("class","marker cross "+it).attr("viewBox","0 0 11 11").attr("refX",-1).attr("refY",5.2).attr("markerUnits","userSpaceOnUse").attr("markerWidth",11).attr("markerHeight",11).attr("orient","auto").append("path").attr("d","M 1,1 l 9,9 M 10,1 l -9,9").attr("class","arrowMarkerPath").style("stroke-width",2).style("stroke-dasharray","1,0")},"cross"),barb=__name((rt,it,ct)=>{rt.append("defs").append("marker").attr("id",ct+"_"+it+"-barbEnd").attr("refX",19).attr("refY",7).attr("markerWidth",20).attr("markerHeight",14).attr("markerUnits","userSpaceOnUse").attr("orient","auto").append("path").attr("d","M 19,7 L9,13 L14,7 L9,1 Z")},"barb"),only_one=__name((rt,it,ct)=>{rt.append("defs").append("marker").attr("id",ct+"_"+it+"-onlyOneStart").attr("class","marker onlyOne "+it).attr("refX",0).attr("refY",9).attr("markerWidth",18).attr("markerHeight",18).attr("orient","auto").append("path").attr("d","M9,0 L9,18 M15,0 L15,18"),rt.append("defs").append("marker").attr("id",ct+"_"+it+"-onlyOneEnd").attr("class","marker onlyOne "+it).attr("refX",18).attr("refY",9).attr("markerWidth",18).attr("markerHeight",18).attr("orient","auto").append("path").attr("d","M3,0 L3,18 M9,0 L9,18")},"only_one"),zero_or_one=__name((rt,it,ct)=>{const dt=rt.append("defs").append("marker").attr("id",ct+"_"+it+"-zeroOrOneStart").attr("class","marker zeroOrOne "+it).attr("refX",0).attr("refY",9).attr("markerWidth",30).attr("markerHeight",18).attr("orient","auto");dt.append("circle").attr("fill","white").attr("cx",21).attr("cy",9).attr("r",6),dt.append("path").attr("d","M9,0 L9,18");const ut=rt.append("defs").append("marker").attr("id",ct+"_"+it+"-zeroOrOneEnd").attr("class","marker zeroOrOne "+it).attr("refX",30).attr("refY",9).attr("markerWidth",30).attr("markerHeight",18).attr("orient","auto");ut.append("circle").attr("fill","white").attr("cx",9).attr("cy",9).attr("r",6),ut.append("path").attr("d","M21,0 L21,18")},"zero_or_one"),one_or_more=__name((rt,it,ct)=>{rt.append("defs").append("marker").attr("id",ct+"_"+it+"-oneOrMoreStart").attr("class","marker oneOrMore "+it).attr("refX",18).attr("refY",18).attr("markerWidth",45).attr("markerHeight",36).attr("orient","auto").append("path").attr("d","M0,18 Q 18,0 36,18 Q 18,36 0,18 M42,9 L42,27"),rt.append("defs").append("marker").attr("id",ct+"_"+it+"-oneOrMoreEnd").attr("class","marker oneOrMore "+it).attr("refX",27).attr("refY",18).attr("markerWidth",45).attr("markerHeight",36).attr("orient","auto").append("path").attr("d","M3,9 L3,27 M9,18 Q27,0 45,18 Q27,36 9,18")},"one_or_more"),zero_or_more=__name((rt,it,ct)=>{const dt=rt.append("defs").append("marker").attr("id",ct+"_"+it+"-zeroOrMoreStart").attr("class","marker zeroOrMore "+it).attr("refX",18).attr("refY",18).attr("markerWidth",57).attr("markerHeight",36).attr("orient","auto");dt.append("circle").attr("fill","white").attr("cx",48).attr("cy",18).attr("r",6),dt.append("path").attr("d","M0,18 Q18,0 36,18 Q18,36 0,18");const ut=rt.append("defs").append("marker").attr("id",ct+"_"+it+"-zeroOrMoreEnd").attr("class","marker zeroOrMore "+it).attr("refX",39).attr("refY",18).attr("markerWidth",57).attr("markerHeight",36).attr("orient","auto");ut.append("circle").attr("fill","white").attr("cx",9).attr("cy",18).attr("r",6),ut.append("path").attr("d","M21,18 Q39,0 57,18 Q39,36 21,18")},"zero_or_more"),requirement_arrow=__name((rt,it,ct)=>{rt.append("defs").append("marker").attr("id",ct+"_"+it+"-requirement_arrowEnd").attr("refX",20).attr("refY",10).attr("markerWidth",20).attr("markerHeight",20).attr("orient","auto").append("path").attr("d",`M0,0
-      L20,10
-      M20,10
-      L0,20`)},"requirement_arrow"),requirement_contains=__name((rt,it,ct)=>{const dt=rt.append("defs").append("marker").attr("id",ct+"_"+it+"-requirement_containsStart").attr("refX",0).attr("refY",10).attr("markerWidth",20).attr("markerHeight",20).attr("orient","auto").append("g");dt.append("circle").attr("cx",10).attr("cy",10).attr("r",9).attr("fill","none"),dt.append("line").attr("x1",1).attr("x2",19).attr("y1",10).attr("y2",10),dt.append("line").attr("y1",1).attr("y2",19).attr("x1",10).attr("x2",10)},"requirement_contains"),markers={extension,composition,aggregation,dependency,lollipop,point,circle,cross,barb,only_one,zero_or_one,one_or_more,zero_or_more,requirement_arrow,requirement_contains},markers_default=insertMarkers,internalHelpers={common:common_default,getConfig,insertCluster,insertEdge,insertEdgeLabel,insertMarkers:markers_default,insertNode,interpolateToCurve,labelHelper,log,positionEdgeLabel},layoutAlgorithms={},registerLayoutLoaders=__name(rt=>{for(const it of rt)layoutAlgorithms[it.name]=it},"registerLayoutLoaders"),registerDefaultLayoutLoaders=__name(()=>{registerLayoutLoaders([{name:"dagre",loader:__name(async()=>await __vitePreload(()=>import("./dagre-6UL2VRFP-C6Co3lCr.js"),__vite__mapDeps([0,1,2,3,4,5])),"loader")},{name:"cose-bilkent",loader:__name(async()=>await __vitePreload(()=>import("./cose-bilkent-S5V4N54A-DgZv4oG7.js"),__vite__mapDeps([6,7])),"loader")}])},"registerDefaultLayoutLoaders");registerDefaultLayoutLoaders();var render$1=__name(async(rt,it)=>{if(!(rt.layoutAlgorithm in layoutAlgorithms))throw new Error(`Unknown layout algorithm: ${rt.layoutAlgorithm}`);const ct=layoutAlgorithms[rt.layoutAlgorithm];return(await ct.loader()).render(rt,it,internalHelpers,{algorithm:ct.algorithm})},"render"),getRegisteredLayoutAlgorithm=__name((rt="",{fallback:it="dagre"}={})=>{if(rt in layoutAlgorithms)return rt;if(it in layoutAlgorithms)return log.warn(`Layout algorithm ${rt} is not registered. Using ${it} as fallback.`),it;throw new Error(`Both layout algorithms ${rt} and ${it} are not registered.`)},"getRegisteredLayoutAlgorithm"),COMMENT="comm",RULESET="rule",DECLARATION="decl",IMPORT="@import",NAMESPACE="@namespace",KEYFRAMES="@keyframes",LAYER="@layer",abs=Math.abs,from=String.fromCharCode;function trim(rt){return rt.trim()}function replace(rt,it,ct){return rt.replace(it,ct)}function indexof(rt,it,ct){return rt.indexOf(it,ct)}function charat(rt,it){return rt.charCodeAt(it)|0}function substr(rt,it,ct){return rt.slice(it,ct)}function strlen(rt){return rt.length}function sizeof(rt){return rt.length}function append(rt,it){return it.push(rt),rt}var line=1,column=1,length=0,position=0,character=0,characters="";function node(rt,it,ct,dt,ut,pt,yt,ft){return{value:rt,root:it,parent:ct,type:dt,props:ut,children:pt,line,column,length:yt,return:"",siblings:ft}}function char(){return character}function prev(){return character=position>0?charat(characters,--position):0,column--,character===10&&(column=1,line--),character}function next(){return character=position<length?charat(characters,position++):0,column++,character===10&&(column=1,line++),character}function peek(){return charat(characters,position)}function caret(){return position}function slice(rt,it){return substr(characters,rt,it)}function token(rt){switch(rt){case 0:case 9:case 10:case 13:case 32:return 5;case 33:case 43:case 44:case 47:case 62:case 64:case 126:case 59:case 123:case 125:return 4;case 58:return 3;case 34:case 39:case 40:case 91:return 2;case 41:case 93:return 1}return 0}function alloc(rt){return line=column=1,length=strlen(characters=rt),position=0,[]}function dealloc(rt){return characters="",rt}function delimit(rt){return trim(slice(position-1,delimiter(rt===91?rt+2:rt===40?rt+1:rt)))}function whitespace(rt){for(;(character=peek())&&character<33;)next();return token(rt)>2||token(character)>3?"":" "}function escaping(rt,it){for(;--it&&next()&&!(character<48||character>102||character>57&&character<65||character>70&&character<97););return slice(rt,caret()+(it<6&&peek()==32&&next()==32))}function delimiter(rt){for(;next();)switch(character){case rt:return position;case 34:case 39:rt!==34&&rt!==39&&delimiter(character);break;case 40:rt===41&&delimiter(rt);break;case 92:next();break}return position}function commenter(rt,it){for(;next()&&rt+character!==57;)if(rt+character===84&&peek()===47)break;return"/*"+slice(it,position-1)+"*"+from(rt===47?rt:next())}function identifier(rt){for(;!token(peek());)next();return slice(rt,position)}function compile(rt){return dealloc(parse$2("",null,null,null,[""],rt=alloc(rt),0,[0],rt))}function parse$2(rt,it,ct,dt,ut,pt,yt,ft,mt){for(var kt=0,_t=0,vt=yt,bt=0,Mt=0,wt=0,St=1,It=1,Nt=1,$t=0,Et="",Ft=ut,qt=pt,Ht=dt,Ot=Et;It;)switch(wt=$t,$t=next()){case 40:if(wt!=108&&charat(Ot,vt-1)==58){indexof(Ot+=replace(delimit($t),"&","&\f"),"&\f",abs(kt?ft[kt-1]:0))!=-1&&(Nt=-1);break}case 34:case 39:case 91:Ot+=delimit($t);break;case 9:case 10:case 13:case 32:Ot+=whitespace(wt);break;case 92:Ot+=escaping(caret()-1,7);continue;case 47:switch(peek()){case 42:case 47:append(comment(commenter(next(),caret()),it,ct,mt),mt),(token(wt||1)==5||token(peek()||1)==5)&&strlen(Ot)&&substr(Ot,-1,void 0)!==" "&&(Ot+=" ");break;default:Ot+="/"}break;case 123*St:ft[kt++]=strlen(Ot)*Nt;case 125*St:case 59:case 0:switch($t){case 0:case 125:It=0;case 59+_t:Nt==-1&&(Ot=replace(Ot,/\f/g,"")),Mt>0&&(strlen(Ot)-vt||St===0&&wt===47)&&append(Mt>32?declaration(Ot+";",dt,ct,vt-1,mt):declaration(replace(Ot," ","")+";",dt,ct,vt-2,mt),mt);break;case 59:Ot+=";";default:if(append(Ht=ruleset(Ot,it,ct,kt,_t,ut,ft,Et,Ft=[],qt=[],vt,pt),pt),$t===123)if(_t===0)parse$2(Ot,it,Ht,Ht,Ft,pt,vt,ft,qt);else{switch(bt){case 99:if(charat(Ot,3)===110)break;case 108:if(charat(Ot,2)===97)break;default:_t=0;case 100:case 109:case 115:}_t?parse$2(rt,Ht,Ht,dt&&append(ruleset(rt,Ht,Ht,0,0,ut,ft,Et,ut,Ft=[],vt,qt),qt),ut,qt,vt,ft,dt?Ft:qt):parse$2(Ot,Ht,Ht,Ht,[""],qt,0,ft,qt)}}kt=_t=Mt=0,St=Nt=1,Et=Ot="",vt=yt;break;case 58:vt=1+strlen(Ot),Mt=wt;default:if(St<1){if($t==123)--St;else if($t==125&&St++==0&&prev()==125)continue}switch(Ot+=from($t),$t*St){case 38:Nt=_t>0?1:(Ot+="\f",-1);break;case 44:ft[kt++]=(strlen(Ot)-1)*Nt,Nt=1;break;case 64:peek()===45&&(Ot+=delimit(next())),bt=peek(),_t=vt=strlen(Et=Ot+=identifier(caret())),$t++;break;case 45:wt===45&&strlen(Ot)==2&&(St=0)}}return pt}function ruleset(rt,it,ct,dt,ut,pt,yt,ft,mt,kt,_t,vt){for(var bt=ut-1,Mt=ut===0?pt:[""],wt=sizeof(Mt),St=0,It=0,Nt=0;St<dt;++St)for(var $t=0,Et=substr(rt,bt+1,bt=abs(It=yt[St])),Ft=rt;$t<wt;++$t)(Ft=trim(It>0?Mt[$t]+" "+Et:replace(Et,/&\f/g,Mt[$t])))&&(mt[Nt++]=Ft);return node(rt,it,ct,ut===0?RULESET:ft,mt,kt,_t,vt)}function comment(rt,it,ct,dt){return node(rt,it,ct,COMMENT,from(char()),substr(rt,2,-2),0,dt)}function declaration(rt,it,ct,dt,ut){return node(rt,it,ct,DECLARATION,substr(rt,0,dt),substr(rt,dt+1,-1),dt,ut)}function serialize(rt,it){for(var ct="",dt=0;dt<rt.length;dt++)ct+=it(rt[dt],dt,rt,it)||"";return ct}function stringify(rt,it,ct,dt){switch(rt.type){case LAYER:if(rt.children.length)break;case IMPORT:case NAMESPACE:case DECLARATION:return rt.return=rt.return||rt.value;case COMMENT:return"";case KEYFRAMES:return rt.return=rt.value+"{"+serialize(rt.children,dt)+"}";case RULESET:if(!strlen(rt.value=rt.props.join(",")))return""}return strlen(ct=serialize(rt.children,dt))?rt.return=rt.value+"{"+ct+"}":""}var nativeKeys=overArg(Object.keys,Object),objectProto$1=Object.prototype,hasOwnProperty$1=objectProto$1.hasOwnProperty;function baseKeys(rt){if(!isPrototype(rt))return nativeKeys(rt);var it=[];for(var ct in Object(rt))hasOwnProperty$1.call(rt,ct)&&ct!="constructor"&&it.push(ct);return it}var DataView=getNative(root,"DataView"),Promise$1=getNative(root,"Promise"),Set$1=getNative(root,"Set"),WeakMap$1=getNative(root,"WeakMap"),mapTag$1="[object Map]",objectTag="[object Object]",promiseTag="[object Promise]",setTag$1="[object Set]",weakMapTag="[object WeakMap]",dataViewTag="[object DataView]",dataViewCtorString=toSource(DataView),mapCtorString=toSource(Map$1),promiseCtorString=toSource(Promise$1),setCtorString=toSource(Set$1),weakMapCtorString=toSource(WeakMap$1),getTag$1=baseGetTag;(DataView&&getTag$1(new DataView(new ArrayBuffer(1)))!=dataViewTag||Map$1&&getTag$1(new Map$1)!=mapTag$1||Promise$1&&getTag$1(Promise$1.resolve())!=promiseTag||Set$1&&getTag$1(new Set$1)!=setTag$1||WeakMap$1&&getTag$1(new WeakMap$1)!=weakMapTag)&&(getTag$1=function(rt){var it=baseGetTag(rt),ct=it==objectTag?rt.constructor:void 0,dt=ct?toSource(ct):"";if(dt)switch(dt){case dataViewCtorString:return dataViewTag;case mapCtorString:return mapTag$1;case promiseCtorString:return promiseTag;case setCtorString:return setTag$1;case weakMapCtorString:return weakMapTag}return it});var mapTag="[object Map]",setTag="[object Set]",objectProto=Object.prototype,hasOwnProperty=objectProto.hasOwnProperty;function isEmpty(rt){if(rt==null)return!0;if(isArrayLike(rt)&&(isArray$1(rt)||typeof rt=="string"||typeof rt.splice=="function"||isBuffer(rt)||isTypedArray(rt)||isArguments(rt)))return!rt.length;var it=getTag$1(rt);if(it==mapTag||it==setTag)return!rt.size;if(isPrototype(rt))return!baseKeys(rt).length;for(var ct in rt)if(hasOwnProperty.call(rt,ct))return!1;return!0}var id="c4",detector=__name(rt=>/^\s*C4Context|C4Container|C4Component|C4Dynamic|C4Deployment/.test(rt),"detector"),loader=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./c4Diagram-YG6GDRKO-DYZ6VP6-.js");return{diagram:it}},__vite__mapDeps([8,9]));return{id,diagram:rt}},"loader"),plugin={id,detector,loader},c4Detector_default=plugin,id2="flowchart",detector2=__name((rt,it)=>it?.flowchart?.defaultRenderer==="dagre-wrapper"||it?.flowchart?.defaultRenderer==="elk"?!1:/^\s*graph/.test(rt),"detector"),loader2=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./flowDiagram-NV44I4VS-C8-lZvFy.js");return{diagram:it}},__vite__mapDeps([10,11,12,13,14]));return{id:id2,diagram:rt}},"loader"),plugin2={id:id2,detector:detector2,loader:loader2},flowDetector_default=plugin2,id3="flowchart-v2",detector3=__name((rt,it)=>it?.flowchart?.defaultRenderer==="dagre-d3"?!1:(it?.flowchart?.defaultRenderer==="elk"&&(it.layout="elk"),/^\s*graph/.test(rt)&&it?.flowchart?.defaultRenderer==="dagre-wrapper"?!0:/^\s*flowchart/.test(rt)),"detector"),loader3=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./flowDiagram-NV44I4VS-C8-lZvFy.js");return{diagram:it}},__vite__mapDeps([10,11,12,13,14]));return{id:id3,diagram:rt}},"loader"),plugin3={id:id3,detector:detector3,loader:loader3},flowDetector_v2_default=plugin3,id4="er",detector4=__name(rt=>/^\s*erDiagram/.test(rt),"detector"),loader4=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./erDiagram-Q2GNP2WA-B2qtJQLQ.js");return{diagram:it}},__vite__mapDeps([15,12,13,14]));return{id:id4,diagram:rt}},"loader"),plugin4={id:id4,detector:detector4,loader:loader4},erDetector_default=plugin4,id5="gitGraph",detector5=__name(rt=>/^\s*gitGraph/.test(rt),"detector"),loader5=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./gitGraphDiagram-NY62KEGX-Dx-Iakkv.js");return{diagram:it}},__vite__mapDeps([16,17,18,19,2,4,5]));return{id:id5,diagram:rt}},"loader"),plugin5={id:id5,detector:detector5,loader:loader5},gitGraphDetector_default=plugin5,id6="gantt",detector6=__name(rt=>/^\s*gantt/.test(rt),"detector"),loader6=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./ganttDiagram-LVOFAZNH-xP4ejEuz.js");return{diagram:it}},__vite__mapDeps([20,21,22,23]));return{id:id6,diagram:rt}},"loader"),plugin6={id:id6,detector:detector6,loader:loader6},ganttDetector_default=plugin6,id7="info",detector7=__name(rt=>/^\s*info/.test(rt),"detector"),loader7=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./infoDiagram-ER5ION4S-CVILutlg.js");return{diagram:it}},__vite__mapDeps([24,19,2,4,5]));return{id:id7,diagram:rt}},"loader"),info={id:id7,detector:detector7,loader:loader7},id8="pie",detector8=__name(rt=>/^\s*pie/.test(rt),"detector"),loader8=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./pieDiagram-ADFJNKIX-Bkw5yNqo.js");return{diagram:it}},__vite__mapDeps([25,17,19,2,4,5,26,27,22]));return{id:id8,diagram:rt}},"loader"),pie={id:id8,detector:detector8,loader:loader8},id9="quadrantChart",detector9=__name(rt=>/^\s*quadrantChart/.test(rt),"detector"),loader9=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./quadrantDiagram-AYHSOK5B-IIW4tBOO.js");return{diagram:it}},__vite__mapDeps([28,21,22,23]));return{id:id9,diagram:rt}},"loader"),plugin7={id:id9,detector:detector9,loader:loader9},quadrantDetector_default=plugin7,id10="xychart",detector10=__name(rt=>/^\s*xychart(-beta)?/.test(rt),"detector"),loader10=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./xychartDiagram-PRI3JC2R-DBIK1dAC.js");return{diagram:it}},__vite__mapDeps([29,22,27,21,23]));return{id:id10,diagram:rt}},"loader"),plugin8={id:id10,detector:detector10,loader:loader10},xychartDetector_default=plugin8,id11="requirement",detector11=__name(rt=>/^\s*requirement(Diagram)?/.test(rt),"detector"),loader11=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./requirementDiagram-UZGBJVZJ-CBieYl8c.js");return{diagram:it}},__vite__mapDeps([30,12,13]));return{id:id11,diagram:rt}},"loader"),plugin9={id:id11,detector:detector11,loader:loader11},requirementDetector_default=plugin9,id12="sequence",detector12=__name(rt=>/^\s*sequenceDiagram/.test(rt),"detector"),loader12=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./sequenceDiagram-WL72ISMW-C4G5dCz-.js");return{diagram:it}},__vite__mapDeps([31,9,18]));return{id:id12,diagram:rt}},"loader"),plugin10={id:id12,detector:detector12,loader:loader12},sequenceDetector_default=plugin10,id13="class",detector13=__name((rt,it)=>it?.class?.defaultRenderer==="dagre-wrapper"?!1:/^\s*classDiagram/.test(rt),"detector"),loader13=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./classDiagram-2ON5EDUG-BfY8AvxO.js");return{diagram:it}},__vite__mapDeps([32,33,11,12,13]));return{id:id13,diagram:rt}},"loader"),plugin11={id:id13,detector:detector13,loader:loader13},classDetector_default=plugin11,id14="classDiagram",detector14=__name((rt,it)=>/^\s*classDiagram/.test(rt)&&it?.class?.defaultRenderer==="dagre-wrapper"?!0:/^\s*classDiagram-v2/.test(rt),"detector"),loader14=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./classDiagram-v2-WZHVMYZB-BfY8AvxO.js");return{diagram:it}},__vite__mapDeps([34,33,11,12,13]));return{id:id14,diagram:rt}},"loader"),plugin12={id:id14,detector:detector14,loader:loader14},classDetector_V2_default=plugin12,id15="state",detector15=__name((rt,it)=>it?.state?.defaultRenderer==="dagre-wrapper"?!1:/^\s*stateDiagram/.test(rt),"detector"),loader15=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./stateDiagram-FKZM4ZOC-BtO6UYX1.js");return{diagram:it}},__vite__mapDeps([35,36,12,13,1,2,3,4]));return{id:id15,diagram:rt}},"loader"),plugin13={id:id15,detector:detector15,loader:loader15},stateDetector_default=plugin13,id16="stateDiagram",detector16=__name((rt,it)=>!!(/^\s*stateDiagram-v2/.test(rt)||/^\s*stateDiagram/.test(rt)&&it?.state?.defaultRenderer==="dagre-wrapper"),"detector"),loader16=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./stateDiagram-v2-4FDKWEC3-BYlkVy7J.js");return{diagram:it}},__vite__mapDeps([37,36,12,13]));return{id:id16,diagram:rt}},"loader"),plugin14={id:id16,detector:detector16,loader:loader16},stateDetector_V2_default=plugin14,id17="journey",detector17=__name(rt=>/^\s*journey/.test(rt),"detector"),loader17=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./journeyDiagram-XKPGCS4Q-BHSnA7Cj.js");return{diagram:it}},__vite__mapDeps([38,9,11,26]));return{id:id17,diagram:rt}},"loader"),plugin15={id:id17,detector:detector17,loader:loader17},journeyDetector_default=plugin15,draw=__name((rt,it,ct)=>{log.debug(`rendering svg for syntax error
-`);const dt=selectSvgElement(it),ut=dt.append("g");dt.attr("viewBox","0 0 2412 512"),configureSvgSize(dt,100,512,!0),ut.append("path").attr("class","error-icon").attr("d","m411.313,123.313c6.25-6.25 6.25-16.375 0-22.625s-16.375-6.25-22.625,0l-32,32-9.375,9.375-20.688-20.688c-12.484-12.5-32.766-12.5-45.25,0l-16,16c-1.261,1.261-2.304,2.648-3.31,4.051-21.739-8.561-45.324-13.426-70.065-13.426-105.867,0-192,86.133-192,192s86.133,192 192,192 192-86.133 192-192c0-24.741-4.864-48.327-13.426-70.065 1.402-1.007 2.79-2.049 4.051-3.31l16-16c12.5-12.492 12.5-32.758 0-45.25l-20.688-20.688 9.375-9.375 32.001-31.999zm-219.313,100.687c-52.938,0-96,43.063-96,96 0,8.836-7.164,16-16,16s-16-7.164-16-16c0-70.578 57.422-128 128-128 8.836,0 16,7.164 16,16s-7.164,16-16,16z"),ut.append("path").attr("class","error-icon").attr("d","m459.02,148.98c-6.25-6.25-16.375-6.25-22.625,0s-6.25,16.375 0,22.625l16,16c3.125,3.125 7.219,4.688 11.313,4.688 4.094,0 8.188-1.563 11.313-4.688 6.25-6.25 6.25-16.375 0-22.625l-16.001-16z"),ut.append("path").attr("class","error-icon").attr("d","m340.395,75.605c3.125,3.125 7.219,4.688 11.313,4.688 4.094,0 8.188-1.563 11.313-4.688 6.25-6.25 6.25-16.375 0-22.625l-16-16c-6.25-6.25-16.375-6.25-22.625,0s-6.25,16.375 0,22.625l15.999,16z"),ut.append("path").attr("class","error-icon").attr("d","m400,64c8.844,0 16-7.164 16-16v-32c0-8.836-7.156-16-16-16-8.844,0-16,7.164-16,16v32c0,8.836 7.156,16 16,16z"),ut.append("path").attr("class","error-icon").attr("d","m496,96.586h-32c-8.844,0-16,7.164-16,16 0,8.836 7.156,16 16,16h32c8.844,0 16-7.164 16-16 0-8.836-7.156-16-16-16z"),ut.append("path").attr("class","error-icon").attr("d","m436.98,75.605c3.125,3.125 7.219,4.688 11.313,4.688 4.094,0 8.188-1.563 11.313-4.688l32-32c6.25-6.25 6.25-16.375 0-22.625s-16.375-6.25-22.625,0l-32,32c-6.251,6.25-6.251,16.375-0.001,22.625z"),ut.append("text").attr("class","error-text").attr("x",1440).attr("y",250).attr("font-size","150px").style("text-anchor","middle").text("Syntax error in text"),ut.append("text").attr("class","error-text").attr("x",1250).attr("y",400).attr("font-size","100px").style("text-anchor","middle").text(`mermaid version ${ct}`)},"draw"),renderer={draw},errorRenderer_default=renderer,diagram={db:{},renderer,parser:{parse:__name(()=>{},"parse")}},errorDiagram_default=diagram,id18="flowchart-elk",detector18=__name((rt,it={})=>/^\s*flowchart-elk/.test(rt)||/^\s*(flowchart|graph)/.test(rt)&&it?.flowchart?.defaultRenderer==="elk"?(it.layout="elk",!0):!1,"detector"),loader18=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./flowDiagram-NV44I4VS-C8-lZvFy.js");return{diagram:it}},__vite__mapDeps([10,11,12,13,14]));return{id:id18,diagram:rt}},"loader"),plugin16={id:id18,detector:detector18,loader:loader18},detector_default=plugin16,id19="timeline",detector19=__name(rt=>/^\s*timeline/.test(rt),"detector"),loader19=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./timeline-definition-IT6M3QCI-DCes-M6t.js");return{diagram:it}},__vite__mapDeps([39,26]));return{id:id19,diagram:rt}},"loader"),plugin17={id:id19,detector:detector19,loader:loader19},detector_default2=plugin17,id20="mindmap",detector20=__name(rt=>/^\s*mindmap/.test(rt),"detector"),loader20=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./mindmap-definition-VGOIOE7T-WoULMqac.js");return{diagram:it}},__vite__mapDeps([40,12,13]));return{id:id20,diagram:rt}},"loader"),plugin18={id:id20,detector:detector20,loader:loader20},detector_default3=plugin18,id21="kanban",detector21=__name(rt=>/^\s*kanban/.test(rt),"detector"),loader21=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./kanban-definition-3W4ZIXB7-BCzaghRS.js");return{diagram:it}},__vite__mapDeps([41,11]));return{id:id21,diagram:rt}},"loader"),plugin19={id:id21,detector:detector21,loader:loader21},detector_default4=plugin19,id22="sankey",detector22=__name(rt=>/^\s*sankey(-beta)?/.test(rt),"detector"),loader22=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./sankeyDiagram-TZEHDZUN-CcPJsCNS.js");return{diagram:it}},__vite__mapDeps([42,27,22]));return{id:id22,diagram:rt}},"loader"),plugin20={id:id22,detector:detector22,loader:loader22},sankeyDetector_default=plugin20,id23="packet",detector23=__name(rt=>/^\s*packet(-beta)?/.test(rt),"detector"),loader23=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./diagram-S2PKOQOG-DvFlKDlH.js");return{diagram:it}},__vite__mapDeps([43,17,19,2,4,5]));return{id:id23,diagram:rt}},"loader"),packet={id:id23,detector:detector23,loader:loader23},id24="radar",detector24=__name(rt=>/^\s*radar-beta/.test(rt),"detector"),loader24=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./diagram-QEK2KX5R-DkELOZ4d.js");return{diagram:it}},__vite__mapDeps([44,17,19,2,4,5]));return{id:id24,diagram:rt}},"loader"),radar={id:id24,detector:detector24,loader:loader24},id25="block",detector25=__name(rt=>/^\s*block(-beta)?/.test(rt),"detector"),loader25=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./blockDiagram-VD42YOAC-RS0Yvfs6.js");return{diagram:it}},__vite__mapDeps([45,11,5,2,1,14]));return{id:id25,diagram:rt}},"loader"),plugin21={id:id25,detector:detector25,loader:loader25},blockDetector_default=plugin21,id26="architecture",detector26=__name(rt=>/^\s*architecture/.test(rt),"detector"),loader26=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./architectureDiagram-VXUJARFQ-BsBPSHs1.js");return{diagram:it}},__vite__mapDeps([46,17,19,2,4,5,7]));return{id:id26,diagram:rt}},"loader"),architecture$2={id:id26,detector:detector26,loader:loader26},architectureDetector_default=architecture$2,id27="treemap",detector27=__name(rt=>/^\s*treemap/.test(rt),"detector"),loader27=__name(async()=>{const{diagram:rt}=await __vitePreload(async()=>{const{diagram:it}=await import("./diagram-PSM6KHXK-DJOM8VfI.js");return{diagram:it}},__vite__mapDeps([47,13,17,19,2,4,5,23,27,22]));return{id:id27,diagram:rt}},"loader"),treemap={id:id27,detector:detector27,loader:loader27},hasLoadedDiagrams=!1,addDiagrams=__name(()=>{hasLoadedDiagrams||(hasLoadedDiagrams=!0,registerDiagram("error",errorDiagram_default,rt=>rt.toLowerCase().trim()==="error"),registerDiagram("---",{db:{clear:__name(()=>{},"clear")},styles:{},renderer:{draw:__name(()=>{},"draw")},parser:{parse:__name(()=>{throw new Error("Diagrams beginning with --- are not valid. If you were trying to use a YAML front-matter, please ensure that you've correctly opened and closed the YAML front-matter with un-indented `---` blocks")},"parse")},init:__name(()=>null,"init")},rt=>rt.toLowerCase().trimStart().startsWith("---")),registerLazyLoadedDiagrams(detector_default,detector_default3,architectureDetector_default),registerLazyLoadedDiagrams(c4Detector_default,detector_default4,classDetector_V2_default,classDetector_default,erDetector_default,ganttDetector_default,info,pie,requirementDetector_default,sequenceDetector_default,flowDetector_v2_default,flowDetector_default,detector_default2,gitGraphDetector_default,stateDetector_V2_default,stateDetector_default,journeyDetector_default,quadrantDetector_default,sankeyDetector_default,packet,xychartDetector_default,blockDetector_default,radar,treemap))},"addDiagrams"),loadRegisteredDiagrams=__name(async()=>{log.debug("Loading registered diagrams");const it=(await Promise.allSettled(Object.entries(detectors).map(async([ct,{detector:dt,loader:ut}])=>{if(ut)try{getDiagram(ct)}catch{try{const{diagram:pt,id:yt}=await ut();registerDiagram(yt,pt,dt)}catch(pt){throw log.error(`Failed to load external diagram with key ${ct}. Removing from detectors.`),delete detectors[ct],pt}}}))).filter(ct=>ct.status==="rejected");if(it.length>0){log.error(`Failed to load ${it.length} external diagrams`);for(const ct of it)log.error(ct);throw new Error(`Failed to load ${it.length} external diagrams`)}},"loadRegisteredDiagrams"),SVG_ROLE="graphics-document document";function setA11yDiagramInfo(rt,it){rt.attr("role",SVG_ROLE),it!==""&&rt.attr("aria-roledescription",it)}__name(setA11yDiagramInfo,"setA11yDiagramInfo");function addSVGa11yTitleDescription(rt,it,ct,dt){if(rt.insert!==void 0){if(ct){const ut=`chart-desc-${dt}`;rt.attr("aria-describedby",ut),rt.insert("desc",":first-child").attr("id",ut).text(ct)}if(it){const ut=`chart-title-${dt}`;rt.attr("aria-labelledby",ut),rt.insert("title",":first-child").attr("id",ut).text(it)}}}__name(addSVGa11yTitleDescription,"addSVGa11yTitleDescription");var qr,Diagram=(qr=class{constructor(it,ct,dt,ut,pt){this.type=it,this.text=ct,this.db=dt,this.parser=ut,this.renderer=pt}static async fromText(it,ct={}){const dt=getConfig(),ut=detectType$1(it,dt);it=encodeEntities(it)+`
-`;try{getDiagram(ut)}catch{const kt=getDiagramLoader(ut);if(!kt)throw new UnknownDiagramError(`Diagram ${ut} not found.`);const{id:_t,diagram:vt}=await kt();registerDiagram(_t,vt)}const{db:pt,parser:yt,renderer:ft,init:mt}=getDiagram(ut);return yt.parser&&(yt.parser.yy=pt),pt.clear?.(),mt?.(dt),ct.title&&pt.setDiagramTitle?.(ct.title),await yt.parse(it),new qr(ut,it,pt,yt,ft)}async render(it,ct){await this.renderer.draw(this.text,it,ct,this)}getParser(){return this.parser}getType(){return this.type}},__name(qr,"Diagram"),qr),interactionFunctions=[],attachFunctions=__name(()=>{interactionFunctions.forEach(rt=>{rt()}),interactionFunctions=[]},"attachFunctions"),cleanupComments=__name(rt=>rt.replace(/^\s*%%(?!{)[^\n]+\n?/gm,"").trimStart(),"cleanupComments");function extractFrontMatter(rt){const it=rt.match(frontMatterRegex);if(!it)return{text:rt,metadata:{}};let ct=load(it[1],{schema:JSON_SCHEMA})??{};ct=typeof ct=="object"&&!Array.isArray(ct)?ct:{};const dt={};return ct.displayMode&&(dt.displayMode=ct.displayMode.toString()),ct.title&&(dt.title=ct.title.toString()),ct.config&&(dt.config=ct.config),{text:rt.slice(it[0].length),metadata:dt}}__name(extractFrontMatter,"extractFrontMatter");var cleanupText=__name(rt=>rt.replace(/\r\n?/g,`
-`).replace(/<(\w+)([^>]*)>/g,(it,ct,dt)=>"<"+ct+dt.replace(/="([^"]*)"/g,"='$1'")+">"),"cleanupText"),processFrontmatter=__name(rt=>{const{text:it,metadata:ct}=extractFrontMatter(rt),{displayMode:dt,title:ut,config:pt={}}=ct;return dt&&(pt.gantt||(pt.gantt={}),pt.gantt.displayMode=dt),{title:ut,config:pt,text:it}},"processFrontmatter"),processDirectives=__name(rt=>{const it=utils_default.detectInit(rt)??{},ct=utils_default.detectDirective(rt,"wrap");return Array.isArray(ct)?it.wrap=ct.some(({type:dt})=>dt==="wrap"):ct?.type==="wrap"&&(it.wrap=!0),{text:removeDirectives(rt),directive:it}},"processDirectives");function preprocessDiagram(rt){const it=cleanupText(rt),ct=processFrontmatter(it),dt=processDirectives(ct.text),ut=cleanAndMerge(ct.config,dt.directive);return rt=cleanupComments(dt.text),{code:rt,title:ct.title,config:ut}}__name(preprocessDiagram,"preprocessDiagram");function toBase64(rt){const it=new TextEncoder().encode(rt),ct=Array.from(it,dt=>String.fromCodePoint(dt)).join("");return btoa(ct)}__name(toBase64,"toBase64");var MAX_TEXTLENGTH=5e4,MAX_TEXTLENGTH_EXCEEDED_MSG="graph TB;a[Maximum text size in diagram exceeded];style a fill:#faa",SECURITY_LVL_SANDBOX="sandbox",SECURITY_LVL_LOOSE="loose",XMLNS_SVG_STD="http://www.w3.org/2000/svg",XMLNS_XLINK_STD="http://www.w3.org/1999/xlink",XMLNS_XHTML_STD="http://www.w3.org/1999/xhtml",IFRAME_WIDTH="100%",IFRAME_HEIGHT="100%",IFRAME_STYLES="border:0;margin:0;",IFRAME_BODY_STYLE="margin:0",IFRAME_SANDBOX_OPTS="allow-top-navigation-by-user-activation allow-popups",IFRAME_NOT_SUPPORTED_MSG='The "iframe" tag is not supported by your browser.',DOMPURIFY_TAGS=["foreignobject"],DOMPURIFY_ATTR=["dominant-baseline"];function processAndSetConfigs(rt){const it=preprocessDiagram(rt);return reset(),addDirective(it.config??{}),it}__name(processAndSetConfigs,"processAndSetConfigs");async function parse$1(rt,it){addDiagrams();try{const{code:ct,config:dt}=processAndSetConfigs(rt);return{diagramType:(await getDiagramFromText(ct)).type,config:dt}}catch(ct){if(it?.suppressErrors)return!1;throw ct}}__name(parse$1,"parse");var cssImportantStyles=__name((rt,it,ct=[])=>`
-.${rt} ${it} { ${ct.join(" !important; ")} !important; }`,"cssImportantStyles"),createCssStyles=__name((rt,it=new Map)=>{let ct="";if(rt.themeCSS!==void 0&&(ct+=`
-${rt.themeCSS}`),rt.fontFamily!==void 0&&(ct+=`
-:root { --mermaid-font-family: ${rt.fontFamily}}`),rt.altFontFamily!==void 0&&(ct+=`
-:root { --mermaid-alt-font-family: ${rt.altFontFamily}}`),it instanceof Map){const yt=rt.htmlLabels??rt.flowchart?.htmlLabels?["> *","span"]:["rect","polygon","ellipse","circle","path"];it.forEach(ft=>{isEmpty(ft.styles)||yt.forEach(mt=>{ct+=cssImportantStyles(ft.id,mt,ft.styles)}),isEmpty(ft.textStyles)||(ct+=cssImportantStyles(ft.id,"tspan",(ft?.textStyles||[]).map(mt=>mt.replace("color","fill"))))})}return ct},"createCssStyles"),createUserStyles=__name((rt,it,ct,dt)=>{const ut=createCssStyles(rt,ct),pt=styles_default(it,ut,rt.themeVariables);return serialize(compile(`${dt}{${pt}}`),stringify)},"createUserStyles"),cleanUpSvgCode=__name((rt="",it,ct)=>{let dt=rt;return!ct&&!it&&(dt=dt.replace(/marker-end="url\([\d+./:=?A-Za-z-]*?#/g,'marker-end="url(#')),dt=decodeEntities(dt),dt=dt.replace(/<br>/g,"<br/>"),dt},"cleanUpSvgCode"),putIntoIFrame=__name((rt="",it)=>{const ct=it?.viewBox?.baseVal?.height?it.viewBox.baseVal.height+"px":IFRAME_HEIGHT,dt=toBase64(`<body style="${IFRAME_BODY_STYLE}">${rt}</body>`);return`<iframe style="width:${IFRAME_WIDTH};height:${ct};${IFRAME_STYLES}" src="data:text/html;charset=UTF-8;base64,${dt}" sandbox="${IFRAME_SANDBOX_OPTS}">
-  ${IFRAME_NOT_SUPPORTED_MSG}
-</iframe>`},"putIntoIFrame"),appendDivSvgG=__name((rt,it,ct,dt,ut)=>{const pt=rt.append("div");pt.attr("id",ct),dt&&pt.attr("style",dt);const yt=pt.append("svg").attr("id",it).attr("width","100%").attr("xmlns",XMLNS_SVG_STD);return ut&&yt.attr("xmlns:xlink",ut),yt.append("g"),rt},"appendDivSvgG");function sandboxedIframe(rt,it){return rt.append("iframe").attr("id",it).attr("style","width: 100%; height: 100%;").attr("sandbox","")}__name(sandboxedIframe,"sandboxedIframe");var removeExistingElements=__name((rt,it,ct,dt)=>{rt.getElementById(it)?.remove(),rt.getElementById(ct)?.remove(),rt.getElementById(dt)?.remove()},"removeExistingElements"),render=__name(async function(rt,it,ct){addDiagrams();const dt=processAndSetConfigs(it);it=dt.code;const ut=getConfig();log.debug(ut),it.length>(ut?.maxTextSize??MAX_TEXTLENGTH)&&(it=MAX_TEXTLENGTH_EXCEEDED_MSG);const pt="#"+rt,yt="i"+rt,ft="#"+yt,mt="d"+rt,kt="#"+mt,_t=__name(()=>{const la=select(bt?ft:kt).node();la&&"remove"in la&&la.remove()},"removeTempElements");let vt=select("body");const bt=ut.securityLevel===SECURITY_LVL_SANDBOX,Mt=ut.securityLevel===SECURITY_LVL_LOOSE,wt=ut.fontFamily;if(ct!==void 0){if(ct&&(ct.innerHTML=""),bt){const oa=sandboxedIframe(select(ct),yt);vt=select(oa.nodes()[0].contentDocument.body),vt.node().style.margin=0}else vt=select(ct);appendDivSvgG(vt,rt,mt,`font-family: ${wt}`,XMLNS_XLINK_STD)}else{if(removeExistingElements(document,rt,mt,yt),bt){const oa=sandboxedIframe(select("body"),yt);vt=select(oa.nodes()[0].contentDocument.body),vt.node().style.margin=0}else vt=select("body");appendDivSvgG(vt,rt,mt)}let St,It;try{St=await Diagram.fromText(it,{title:dt.title})}catch(oa){if(ut.suppressErrorRendering)throw _t(),oa;St=await Diagram.fromText("error"),It=oa}const Nt=vt.select(kt).node(),$t=St.type,Et=Nt.firstChild,Ft=Et.firstChild,qt=St.renderer.getClasses?.(it,St),Ht=createUserStyles(ut,$t,qt,pt),Ot=document.createElement("style");Ot.innerHTML=Ht,Et.insertBefore(Ot,Ft);try{await St.renderer.draw(it,rt,package_default.version,St)}catch(oa){throw ut.suppressErrorRendering?_t():errorRenderer_default.draw(it,rt,package_default.version),oa}const Zt=vt.select(`${kt} svg`),Yt=St.db.getAccTitle?.(),aa=St.db.getAccDescription?.();addA11yInfo($t,Zt,Yt,aa),vt.select(`[id="${rt}"]`).selectAll("foreignobject > *").attr("xmlns",XMLNS_XHTML_STD);let Qt=vt.select(kt).node().innerHTML;if(log.debug("config.arrowMarkerAbsolute",ut.arrowMarkerAbsolute),Qt=cleanUpSvgCode(Qt,bt,evaluate(ut.arrowMarkerAbsolute)),bt){const oa=vt.select(kt+" svg").node();Qt=putIntoIFrame(Qt,oa)}else Mt||(Qt=purify.sanitize(Qt,{ADD_TAGS:DOMPURIFY_TAGS,ADD_ATTR:DOMPURIFY_ATTR,HTML_INTEGRATION_POINTS:{foreignobject:!0}}));if(attachFunctions(),It)throw It;return _t(),{diagramType:$t,svg:Qt,bindFunctions:St.db.bindFunctions}},"render");function initialize(rt={}){const it=assignWithDepth_default({},rt);it?.fontFamily&&!it.themeVariables?.fontFamily&&(it.themeVariables||(it.themeVariables={}),it.themeVariables.fontFamily=it.fontFamily),saveConfigFromInitialize(it),it?.theme&&it.theme in themes_default?it.themeVariables=themes_default[it.theme].getThemeVariables(it.themeVariables):it&&(it.themeVariables=themes_default.default.getThemeVariables(it.themeVariables));const ct=typeof it=="object"?setSiteConfig(it):getSiteConfig();setLogLevel(ct.logLevel),addDiagrams()}__name(initialize,"initialize");var getDiagramFromText=__name((rt,it={})=>{const{code:ct}=preprocessDiagram(rt);return Diagram.fromText(ct,it)},"getDiagramFromText");function addA11yInfo(rt,it,ct,dt){setA11yDiagramInfo(it,rt),addSVGa11yTitleDescription(it,ct,dt,it.attr("id"))}__name(addA11yInfo,"addA11yInfo");var mermaidAPI=Object.freeze({render,parse:parse$1,getDiagramFromText,initialize,getConfig,setConfig,getSiteConfig,updateSiteConfig,reset:__name(()=>{reset()},"reset"),globalReset:__name(()=>{reset(defaultConfig)},"globalReset"),defaultConfig});setLogLevel(getConfig().logLevel);reset(getConfig());var handleError=__name((rt,it,ct)=>{log.warn(rt),isDetailedError(rt)?(ct&&ct(rt.str,rt.hash),it.push({...rt,message:rt.str,error:rt})):(ct&&ct(rt),rt instanceof Error&&it.push({str:rt.message,message:rt.message,hash:rt.name,error:rt}))},"handleError"),run=__name(async function(rt={querySelector:".mermaid"}){try{await runThrowsErrors(rt)}catch(it){if(isDetailedError(it)&&log.error(it.str),mermaid.parseError&&mermaid.parseError(it),!rt.suppressErrors)throw log.error("Use the suppressErrors option to suppress these errors"),it}},"run"),runThrowsErrors=__name(async function({postRenderCallback:rt,querySelector:it,nodes:ct}={querySelector:".mermaid"}){const dt=mermaidAPI.getConfig();log.debug(`${rt?"":"No "}Callback function found`);let ut;if(ct)ut=ct;else if(it)ut=document.querySelectorAll(it);else throw new Error("Nodes and querySelector are both undefined");log.debug(`Found ${ut.length} diagrams`),dt?.startOnLoad!==void 0&&(log.debug("Start On Load: "+dt?.startOnLoad),mermaidAPI.updateSiteConfig({startOnLoad:dt?.startOnLoad}));const pt=new utils_default.InitIDGenerator(dt.deterministicIds,dt.deterministicIDSeed);let yt;const ft=[];for(const mt of Array.from(ut)){if(log.info("Rendering diagram: "+mt.id),mt.getAttribute("data-processed"))continue;mt.setAttribute("data-processed","true");const kt=`mermaid-${pt.next()}`;yt=mt.innerHTML,yt=dedent(utils_default.entityDecode(yt)).trim().replace(/<br\s*\/?>/gi,"<br/>");const _t=utils_default.detectInit(yt);_t&&log.debug("Detected early reinit: ",_t);try{const{svg:vt,bindFunctions:bt}=await render2(kt,yt,mt);mt.innerHTML=vt,rt&&await rt(kt),bt&&bt(mt)}catch(vt){handleError(vt,ft,mermaid.parseError)}}if(ft.length>0)throw ft[0]},"runThrowsErrors"),initialize2=__name(function(rt){mermaidAPI.initialize(rt)},"initialize"),init=__name(async function(rt,it,ct){log.warn("mermaid.init is deprecated. Please use run instead."),rt&&initialize2(rt);const dt={postRenderCallback:ct,querySelector:".mermaid"};typeof it=="string"?dt.querySelector=it:it&&(it instanceof HTMLElement?dt.nodes=[it]:dt.nodes=it),await run(dt)},"init"),registerExternalDiagrams=__name(async(rt,{lazyLoad:it=!0}={})=>{addDiagrams(),registerLazyLoadedDiagrams(...rt),it===!1&&await loadRegisteredDiagrams()},"registerExternalDiagrams"),contentLoaded=__name(function(){if(mermaid.startOnLoad){const{startOnLoad:rt}=mermaidAPI.getConfig();rt&&mermaid.run().catch(it=>log.error("Mermaid failed to initialize",it))}},"contentLoaded");typeof document<"u"&&window.addEventListener("load",contentLoaded,!1);var setParseErrorHandler=__name(function(rt){mermaid.parseError=rt},"setParseErrorHandler"),executionQueue=[],executionQueueRunning=!1,executeQueue=__name(async()=>{if(!executionQueueRunning){for(executionQueueRunning=!0;executionQueue.length>0;){const rt=executionQueue.shift();if(rt)try{await rt()}catch(it){log.error("Error executing queue",it)}}executionQueueRunning=!1}},"executeQueue"),parse2=__name(async(rt,it)=>new Promise((ct,dt)=>{const ut=__name(()=>new Promise((pt,yt)=>{mermaidAPI.parse(rt,it).then(ft=>{pt(ft),ct(ft)},ft=>{log.error("Error parsing",ft),mermaid.parseError?.(ft),yt(ft),dt(ft)})}),"performCall");executionQueue.push(ut),executeQueue().catch(dt)}),"parse"),render2=__name((rt,it,ct)=>new Promise((dt,ut)=>{const pt=__name(()=>new Promise((yt,ft)=>{mermaidAPI.render(rt,it,ct).then(mt=>{yt(mt),dt(mt)},mt=>{log.error("Error parsing",mt),mermaid.parseError?.(mt),ft(mt),ut(mt)})}),"performCall");executionQueue.push(pt),executeQueue().catch(ut)}),"render"),getRegisteredDiagramsMetadata=__name(()=>Object.keys(detectors).map(rt=>({id:rt})),"getRegisteredDiagramsMetadata"),mermaid={startOnLoad:!0,mermaidAPI,parse:parse2,render:render2,init,run,registerExternalDiagrams,registerLayoutLoaders,initialize:initialize2,parseError:void 0,contentLoaded,setParseErrorHandler,detectType:detectType$1,registerIconPacks,getRegisteredDiagramsMetadata},mermaid_default=mermaid;const Mermaid=({chart:rt,id:it})=>{const ct=reactExports.useRef(null),[dt,ut]=reactExports.useState(!1),[pt,yt]=reactExports.useState(null);return reactExports.useEffect(()=>{dt||(mermaid_default.initialize({startOnLoad:!1,theme:"base",securityLevel:"loose",themeVariables:{background:"#020617",primaryColor:"#3b82f6",primaryTextColor:"#ffffff",primaryBorderColor:"#60a5fa",secondaryColor:"#8b5cf6",secondaryBorderColor:"#a78bfa",tertiaryColor:"#1e293b",tertiaryTextColor:"#e2e8f0",tertiaryBorderColor:"#334155",textColor:"#e2e8f0",secondaryTextColor:"#cbd5e1",primaryColorLight:"#60a5fa",primaryColorDark:"#1d4ed8",lineColor:"#334155",edgeLabelBackground:"#0f172a",mainBkg:"#1e293b",nodeBkg:"#1e293b",nodeTextColor:"#e2e8f0",nodeBorder:"#60a5fa",clusterBkg:"#0f172a",clusterBorder:"#334155",activeTaskBkgColor:"#3b82f6",activeTaskBorderColor:"#60a5fa",gridColor:"#334155",section0:"#1e293b",section1:"#0f172a",section2:"#020617",section3:"#1e293b",fillType0:"#3b82f6",fillType1:"#8b5cf6",fillType2:"#06b6d4",fillType3:"#10b981",fillType4:"#f59e0b",fillType5:"#ef4444",fillType6:"#ec4899",fillType7:"#8b5cf6",actorBkg:"#1e293b",actorBorder:"#60a5fa",actorTextColor:"#e2e8f0",actorLineColor:"#334155",activationBkgColor:"#3b82f6",activationBorderColor:"#60a5fa",signalColor:"#e2e8f0",signalTextColor:"#e2e8f0",noteBkgColor:"#0f172a",noteBorderColor:"#8b5cf6",noteTextColor:"#e2e8f0",loopTextColor:"#e2e8f0",labelColor:"#e2e8f0",labelTextColor:"#020617",labelBoxBkgColor:"#3b82f6",labelBoxBorderColor:"#60a5fa",errorBkgColor:"#ef4444",errorTextColor:"#ffffff",cScale0:"#3b82f6",cScale1:"#8b5cf6",cScale2:"#06b6d4",cScale3:"#10b981",cScale4:"#f59e0b",cScale5:"#ef4444",pie1:"#3b82f6",pie2:"#8b5cf6",pie3:"#06b6d4",pie4:"#10b981",pie5:"#f59e0b",pie6:"#ef4444",pie7:"#ec4899",pie8:"#84cc16",pie9:"#6366f1",pie10:"#14b8a6",pie11:"#f97316",pie12:"#a855f7",pieTitleTextSize:"18px",pieTitleTextColor:"#e2e8f0",pieSectionTextSize:"14px",pieSectionTextColor:"#ffffff",pieLegendTextSize:"14px",pieLegendTextColor:"#e2e8f0",pieStrokeColor:"#020617",pieStrokeWidth:"1px",pieOuterStrokeWidth:"2px",pieOuterStrokeColor:"#334155",pieOpacity:"0.9",git0:"#3b82f6",git1:"#8b5cf6",git2:"#06b6d4",git3:"#10b981",git4:"#f59e0b",git5:"#ef4444",git6:"#ec4899",git7:"#84cc16",gitBranchLabel0:"#e2e8f0",gitBranchLabel1:"#e2e8f0",gitBranchLabel2:"#e2e8f0",gitBranchLabel3:"#e2e8f0",gitBranchLabel4:"#e2e8f0",gitBranchLabel5:"#e2e8f0",gitBranchLabel6:"#e2e8f0",gitBranchLabel7:"#e2e8f0"},flowchart:{curve:"cardinal",padding:20,nodeSpacing:50,rankSpacing:50,diagramPadding:8,htmlLabels:!0},sequence:{diagramMarginX:50,diagramMarginY:10,actorMargin:50,width:150,height:65,boxMargin:10,boxTextMargin:5,noteMargin:10,messageMargin:35,mirrorActors:!0,bottomMarginAdj:1,useMaxWidth:!0,rightAngles:!1,showSequenceNumbers:!1},gantt:{titleTopMargin:25,barHeight:20,fontSize:11,sectionFontSize:11},journey:{diagramMarginX:50,diagramMarginY:10,leftMargin:150,width:150,height:50,boxMargin:10,boxTextMargin:5,noteMargin:10,messageMargin:35,bottomMarginAdj:1},pie:{textPosition:.75},requirement:{rect_fill:"#1e293b",text_color:"#e2e8f0",rect_border_size:"1px",rect_border_color:"#334155",rect_min_width:200,rect_min_height:200,fontSize:14},gitGraph:{diagramPadding:8,nodeLabel:{width:75,height:100,x:-25,y:0}}}),ut(!0))},[dt]),reactExports.useEffect(()=>{if(!dt||!ct.current)return;(async()=>{try{yt(null);const mt=ct.current;if(!mt)return;mt.innerHTML="";const kt=it||`mermaid-${Math.random().toString(36).substr(2,9)}`,{svg:_t,bindFunctions:vt}=await mermaid_default.render(kt,rt);mt.innerHTML=_t,vt&&vt(mt)}catch(mt){console.error("Mermaid rendering error:",mt),yt(mt instanceof Error?mt.message:"Failed to render diagram")}})()},[rt,it,dt]),pt?jsxRuntimeExports.jsxs("div",{className:"border border-red-500/30 bg-red-500/10 p-4 rounded-lg backdrop-blur-sm",children:[jsxRuntimeExports.jsx("div",{className:"text-red-300 text-sm font-medium",children:"Error rendering diagram"}),jsxRuntimeExports.jsx("div",{className:"text-red-400 text-sm mt-1",children:pt}),jsxRuntimeExports.jsxs("details",{className:"mt-2",children:[jsxRuntimeExports.jsx("summary",{className:"text-red-300 text-xs cursor-pointer hover:text-red-200",children:"Show diagram code"}),jsxRuntimeExports.jsx("pre",{className:"text-red-400 text-xs mt-1 whitespace-pre-wrap font-mono bg-slate-900/50 p-2 rounded border border-red-500/20 overflow-x-auto",children:rt})]})]}):jsxRuntimeExports.jsx("div",{className:"mermaid-container my-8",children:jsxRuntimeExports.jsx("div",{ref:ct,className:"flex justify-center items-center min-h-[200px] bg-slate-950/50 rounded-xl border border-slate-800/50 p-6 backdrop-blur-sm",style:{filter:"drop-shadow(0 4px 20px rgba(59, 130, 246, 0.1))"}})})};function processMermaidAsHtml(rt){const it=/```mermaid\r?\n([\s\S]*?)\r?\n```/g;let ct=rt,dt=0;return ct=ct.replace(it,(ut,pt)=>{const yt=`mermaid-diagram-${dt++}`,ft=pt.trim();return`<div class="mermaid-diagram" data-id="${yt}" data-chart="${encodeURIComponent(ft)}"></div>`}),ct}function createMermaidHtmlOverrides(){return{div:rt=>{if(rt.className==="mermaid-diagram"&&rt["data-chart"]){const it=rt["data-chart"]?decodeURIComponent(rt["data-chart"]):"";return jsxRuntimeExports.jsx(Mermaid,{chart:it,id:rt["data-id"]})}return jsxRuntimeExports.jsx("div",{...rt})}}}function n(){return n=Object.assign?Object.assign.bind():function(rt){for(var it=1;it<arguments.length;it++){var ct=arguments[it];for(var dt in ct)Object.prototype.hasOwnProperty.call(ct,dt)&&(rt[dt]=ct[dt])}return rt},n.apply(this,arguments)}const r$1=["children","options"],o=["allowFullScreen","allowTransparency","autoComplete","autoFocus","autoPlay","cellPadding","cellSpacing","charSet","classId","colSpan","contentEditable","contextMenu","crossOrigin","encType","formAction","formEncType","formMethod","formNoValidate","formTarget","frameBorder","hrefLang","inputMode","keyParams","keyType","marginHeight","marginWidth","maxLength","mediaGroup","minLength","noValidate","radioGroup","readOnly","rowSpan","spellCheck","srcDoc","srcLang","srcSet","tabIndex","useMap"].reduce((rt,it)=>(rt[it.toLowerCase()]=it,rt),{class:"className",for:"htmlFor"}),a={amp:"&",apos:"'",gt:">",lt:"<",nbsp:" ",quot:"“"},c=["style","script","pre"],i=["src","href","data","formAction","srcDoc","action"],u=/([-A-Z0-9_:]+)(?:\s*=\s*(?:(?:"((?:\\.|[^"])*)")|(?:'((?:\\.|[^'])*)')|(?:\{((?:\\.|{[^}]*?}|[^}])*)\})))?/gi,l=/\n{2,}$/,s=/^(\s*>[\s\S]*?)(?=\n\n|$)/,f=/^ *> ?/gm,_=/^(?:\[!([^\]]*)\]\n)?([\s\S]*)/,d=/^ {2,}\n/,p=/^(?:([-*_])( *\1){2,}) *(?:\n *)+\n/,y=/^(?: {1,3})?(`{3,}|~{3,}) *(\S+)? *([^\n]*?)?\n([\s\S]*?)(?:\1\n?|$)/,h=/^(?: {4}[^\n]+\n*)+(?:\n *)+\n?/,g=/^(`+)((?:\\`|(?!\1)`|[^`])+)\1/,m=/^(?:\n *)*\n/,k=/\r\n?/g,x=/^\[\^([^\]]+)](:(.*)((\n+ {4,}.*)|(\n(?!\[\^).+))*)/,q=/^\[\^([^\]]+)]/,v=/\f/g,b=/^---[ \t]*\n(.|\n)*\n---[ \t]*\n/,$=/^\s*?\[(x|\s)\]/,S=/^ *(#{1,6}) *([^\n]+?)(?: +#*)?(?:\n *)*(?:\n|$)/,z=/^ *(#{1,6}) +([^\n]+?)(?: +#*)?(?:\n *)*(?:\n|$)/,E=/^([^\n]+)\n *(=|-)\2{2,} *\n/,A=/^ *(?!<[a-z][^ >/]* ?\/>)<([a-z][^ >/]*) ?((?:[^>]*[^/])?)>\n?(\s*(?:<\1[^>]*?>[\s\S]*?<\/\1>|(?!<\1\b)[\s\S])*?)<\/\1>(?!<\/\1>)\n*/i,R=/&([a-z0-9]+|#[0-9]{1,6}|#x[0-9a-fA-F]{1,6});/gi,B=/^<!--[\s\S]*?(?:-->)/,L=/^(data|aria|x)-[a-z_][a-z\d_.-]*$/,O=/^ *<([a-z][a-z0-9:]*)(?:\s+((?:<.*?>|[^>])*))?\/?>(?!<\/\1>)(\s*\n)?/i,j=/^\{.*\}$/,C=/^(https?:\/\/[^\s<]+[^<.,:;"')\]\s])/,I=/^<([^ >]+[:@\/][^ >]+)>/,T=/-([a-z])?/gi,M=/^(\|.*)\n(?: *(\|? *[-:]+ *\|[-| :]*)\n((?:.*\|.*\n)*))?\n?/,w=/^[^\n]+(?:  \n|\n{2,})/,D=/^\[([^\]]*)\]:\s+<?([^\s>]+)>?\s*("([^"]*)")?/,F=/^!\[([^\]]*)\] ?\[([^\]]*)\]/,P=/^\[([^\]]*)\] ?\[([^\]]*)\]/,Z=/(\n|^[-*]\s|^#|^ {2,}|^-{2,}|^>\s)/,N=/\t/g,G=/(^ *\||\| *$)/g,U=/^ *:-+: *$/,V=/^ *:-+ *$/,H=/^ *-+: *$/,Q=rt=>`(?=[\\s\\S]+?\\1${rt?"\\1":""})`,W="((?:\\[.*?\\][([].*?[)\\]]|<.*?>(?:.*?<.*?>)?|`.*?`|\\\\\\1|[\\s\\S])+?)",J=RegExp(`^([*_])\\1${Q(1)}${W}\\1\\1(?!\\1)`),K=RegExp(`^([*_])${Q(0)}${W}\\1(?!\\1)`),X=RegExp(`^(==)${Q(0)}${W}\\1`),Y=RegExp(`^(~~)${Q(0)}${W}\\1`),ee=/^(:[a-zA-Z0-9-_]+:)/,ne=/^\\([^0-9A-Za-z\s])/,re=/\\([^0-9A-Za-z\s])/g,te=/^[\s\S](?:(?!  \n|[0-9]\.|http)[^=*_~\-\n:<`\\\[!])*/,oe=/^\n+/,ae=/^([ \t]*)/,ce=/(?:^|\n)( *)$/,ie="(?:\\d+\\.)",ue="(?:[*+-])";function le(rt){return"( *)("+(rt===1?ie:ue)+") +"}const se=le(1),fe=le(2);function _e(rt){return RegExp("^"+(rt===1?se:fe))}const de=_e(1),pe=_e(2);function ye(rt){return RegExp("^"+(rt===1?se:fe)+"[^\\n]*(?:\\n(?!\\1"+(rt===1?ie:ue)+" )[^\\n]*)*(\\n|$)","gm")}const he=ye(1),ge=ye(2);function me(rt){const it=rt===1?ie:ue;return RegExp("^( *)("+it+") [\\s\\S]+?(?:\\n{2,}(?! )(?!\\1"+it+" (?!"+it+" ))\\n*|\\s*\\n*$)")}const ke=me(1),xe=me(2);function qe(rt,it){const ct=it===1,dt=ct?ke:xe,ut=ct?he:ge,pt=ct?de:pe;return{t:yt=>pt.test(yt),o:je(function(yt,ft){const mt=ce.exec(ft.prevCapture);return mt&&(ft.list||!ft.inline&&!ft.simple)?dt.exec(yt=mt[1]+yt):null}),i:1,u(yt,ft,mt){const kt=ct?+yt[2]:void 0,_t=yt[0].replace(l,`
-`).match(ut);let vt=!1;return{items:_t.map(function(bt,Mt){const wt=pt.exec(bt)[0].length,St=RegExp("^ {1,"+wt+"}","gm"),It=bt.replace(St,"").replace(pt,""),Nt=Mt===_t.length-1,$t=It.indexOf(`
-
-`)!==-1||Nt&&vt;vt=$t;const Et=mt.inline,Ft=mt.list;let qt;mt.list=!0,$t?(mt.inline=!1,qt=Se(It)+`
-
-`):(mt.inline=!0,qt=Se(It));const Ht=ft(qt,mt);return mt.inline=Et,mt.list=Ft,Ht}),ordered:ct,start:kt}},l:(yt,ft,mt)=>rt(yt.ordered?"ol":"ul",{key:mt.key,start:yt.type==="20"?yt.start:void 0},yt.items.map(function(kt,_t){return rt("li",{key:_t},ft(kt,mt))}))}}const ve=RegExp(`^\\[((?:\\[[^\\[\\]]*(?:\\[[^\\[\\]]*\\][^\\[\\]]*)*\\]|[^\\[\\]])*)\\]\\(\\s*<?((?:\\([^)]*\\)|[^\\s\\\\]|\\\\.)*?)>?(?:\\s+['"]([\\s\\S]*?)['"])?\\s*\\)`),be=/^!\[(.*?)\]\( *((?:\([^)]*\)|[^() ])*) *"?([^)"]*)?"?\)/;function $e(rt){return typeof rt=="string"}function Se(rt){let it=rt.length;for(;it>0&&rt[it-1]<=" ";)it--;return rt.slice(0,it)}function ze(rt,it){return rt.startsWith(it)}function Ee(rt,it,ct){if(Array.isArray(ct)){for(let dt=0;dt<ct.length;dt++)if(ze(rt,ct[dt]))return!0;return!1}return ct(rt,it)}function Ae(rt){return rt.replace(/[ÀÁÂÃÄÅàáâãäåæÆ]/g,"a").replace(/[çÇ]/g,"c").replace(/[ðÐ]/g,"d").replace(/[ÈÉÊËéèêë]/g,"e").replace(/[ÏïÎîÍíÌì]/g,"i").replace(/[Ññ]/g,"n").replace(/[øØœŒÕõÔôÓóÒò]/g,"o").replace(/[ÜüÛûÚúÙù]/g,"u").replace(/[ŸÿÝý]/g,"y").replace(/[^a-z0-9- ]/gi,"").replace(/ /gi,"-").toLowerCase()}function Re(rt){return H.test(rt)?"right":U.test(rt)?"center":V.test(rt)?"left":null}function Be(rt,it,ct,dt){const ut=ct.inTable;ct.inTable=!0;let pt=[[]],yt="";function ft(){if(!yt)return;const mt=pt[pt.length-1];mt.push.apply(mt,it(yt,ct)),yt=""}return rt.trim().split(/(`[^`]*`|\\\||\|)/).filter(Boolean).forEach((mt,kt,_t)=>{mt.trim()==="|"&&(ft(),dt)?kt!==0&&kt!==_t.length-1&&pt.push([]):yt+=mt}),ft(),ct.inTable=ut,pt}function Le(rt,it,ct){ct.inline=!0;const dt=rt[2]?rt[2].replace(G,"").split("|").map(Re):[],ut=rt[3]?(function(yt,ft,mt){return yt.trim().split(`
-`).map(function(kt){return Be(kt,ft,mt,!0)})})(rt[3],it,ct):[],pt=Be(rt[1],it,ct,!!ut.length);return ct.inline=!1,ut.length?{align:dt,cells:ut,header:pt,type:"25"}:{children:pt,type:"21"}}function Oe(rt,it){return rt.align[it]==null?{}:{textAlign:rt.align[it]}}function je(rt){return rt.inline=1,rt}function Ce(rt){return je(function(it,ct){return ct.inline?rt.exec(it):null})}function Ie(rt){return je(function(it,ct){return ct.inline||ct.simple?rt.exec(it):null})}function Te(rt){return function(it,ct){return ct.inline||ct.simple?null:rt.exec(it)}}function Me(rt){return je(function(it){return rt.exec(it)})}const we=/(javascript|vbscript|data(?!:image)):/i;function De(rt){try{const it=decodeURIComponent(rt).replace(/[^A-Za-z0-9/:]/g,"");if(we.test(it))return null}catch{return null}return rt}function Fe(rt){return rt&&rt.replace(re,"$1")}function Pe(rt,it,ct){const dt=ct.inline||!1,ut=ct.simple||!1;ct.inline=!0,ct.simple=!0;const pt=rt(it,ct);return ct.inline=dt,ct.simple=ut,pt}function Ze(rt,it,ct){const dt=ct.inline||!1,ut=ct.simple||!1;ct.inline=!1,ct.simple=!0;const pt=rt(it,ct);return ct.inline=dt,ct.simple=ut,pt}function Ne(rt,it,ct){const dt=ct.inline||!1;ct.inline=!1;const ut=rt(it,ct);return ct.inline=dt,ut}const Ge=(rt,it,ct)=>({children:Pe(it,rt[2],ct)});function Ue(){return{}}function Ve(){return null}function He(...rt){return rt.filter(Boolean).join(" ")}function Qe(rt,it,ct){let dt=rt;const ut=it.split(".");for(;ut.length&&(dt=dt[ut[0]],dt!==void 0);)ut.shift();return dt||ct}function We(rt="",it={}){it.overrides=it.overrides||{},it.namedCodesToUnicode=it.namedCodesToUnicode?n({},a,it.namedCodesToUnicode):a;const ct=it.slugify||Ae,dt=it.sanitizer||De,ut=it.createElement||reactExports.createElement,pt=[s,y,h,it.enforceAtxHeadings?z:S,E,M,ke,xe],yt=[...pt,w,A,B,O];function ft(Nt,$t){for(let Et=0;Et<Nt.length;Et++)if(Nt[Et].test($t))return!0;return!1}function mt(Nt,$t,...Et){const Ft=Qe(it.overrides,Nt+".props",{});return ut((function(qt,Ht){const Ot=Qe(Ht,qt);return Ot?typeof Ot=="function"||typeof Ot=="object"&&"render"in Ot?Ot:Qe(Ht,qt+".component",qt):qt})(Nt,it.overrides),n({},$t,Ft,{className:He($t?.className,Ft.className)||void 0}),...Et)}function kt(Nt){Nt=Nt.replace(b,"");let $t=!1;it.forceInline?$t=!0:it.forceBlock||($t=Z.test(Nt)===!1);const Et=St(wt($t?Nt:Se(Nt).replace(oe,"")+`
-
-`,{inline:$t}));for(;$e(Et[Et.length-1])&&!Et[Et.length-1].trim();)Et.pop();if(it.wrapper===null)return Et;const Ft=it.wrapper||($t?"span":"div");let qt;if(Et.length>1||it.forceWrapper)qt=Et;else{if(Et.length===1)return qt=Et[0],typeof qt=="string"?mt("span",{key:"outer"},qt):qt;qt=null}return ut(Ft,{key:"outer"},qt)}function _t(Nt,$t){if(!$t||!$t.trim())return null;const Et=$t.match(u);return Et?Et.reduce(function(Ft,qt){const Ht=qt.indexOf("=");if(Ht!==-1){const Ot=(function(Qt){return Qt.indexOf("-")!==-1&&Qt.match(L)===null&&(Qt=Qt.replace(T,function(oa,la){return la.toUpperCase()})),Qt})(qt.slice(0,Ht)).trim(),Zt=(function(Qt){const oa=Qt[0];return(oa==='"'||oa==="'")&&Qt.length>=2&&Qt[Qt.length-1]===oa?Qt.slice(1,-1):Qt})(qt.slice(Ht+1).trim()),Yt=o[Ot]||Ot;if(Yt==="ref")return Ft;const aa=Ft[Yt]=(function(Qt,oa,la,Kt){return oa==="style"?(function(ra){const Ut=[];let ea="",Gt=!1,_a=!1,Ca="";if(!ra)return Ut;for(let ta=0;ta<ra.length;ta++){const sa=ra[ta];if(sa!=='"'&&sa!=="'"||Gt||(_a?sa===Ca&&(_a=!1,Ca=""):(_a=!0,Ca=sa)),sa==="("&&ea.endsWith("url")?Gt=!0:sa===")"&&Gt&&(Gt=!1),sa!==";"||_a||Gt)ea+=sa;else{const xa=ea.trim();if(xa){const ka=xa.indexOf(":");if(ka>0){const $a=xa.slice(0,ka).trim(),Na=xa.slice(ka+1).trim();Ut.push([$a,Na])}}ea=""}}const Vt=ea.trim();if(Vt){const ta=Vt.indexOf(":");if(ta>0){const sa=Vt.slice(0,ta).trim(),xa=Vt.slice(ta+1).trim();Ut.push([sa,xa])}}return Ut})(la).reduce(function(ra,[Ut,ea]){return ra[Ut.replace(/(-[a-z])/g,Gt=>Gt[1].toUpperCase())]=Kt(ea,Qt,Ut),ra},{}):i.indexOf(oa)!==-1?Kt(Fe(la),Qt,oa):(la.match(j)&&(la=Fe(la.slice(1,la.length-1))),la==="true"||la!=="false"&&la)})(Nt,Ot,Zt,dt);typeof aa=="string"&&(A.test(aa)||O.test(aa))&&(Ft[Yt]=kt(aa.trim()))}else qt!=="style"&&(Ft[o[qt]||qt]=!0);return Ft},{}):null}const vt=[],bt={},Mt={0:{t:[">"],o:Te(s),i:1,u(Nt,$t,Et){const[,Ft,qt]=Nt[0].replace(f,"").match(_);return{alert:Ft,children:$t(qt,Et)}},l(Nt,$t,Et){const Ft={key:Et.key};return Nt.alert&&(Ft.className="markdown-alert-"+ct(Nt.alert.toLowerCase(),Ae),Nt.children.unshift({attrs:{},children:[{type:"27",text:Nt.alert}],noInnerParse:!0,type:"11",tag:"header"})),mt("blockquote",Ft,$t(Nt.children,Et))}},1:{t:["  "],o:Me(d),i:1,u:Ue,l:(Nt,$t,Et)=>mt("br",{key:Et.key})},2:{t:["--","__","**","- ","* ","_ "],o:Te(p),i:1,u:Ue,l:(Nt,$t,Et)=>mt("hr",{key:Et.key})},3:{t:["    "],o:Te(h),i:0,u:Nt=>({lang:void 0,text:Fe(Se(Nt[0].replace(/^ {4}/gm,"")))}),l:(Nt,$t,Et)=>mt("pre",{key:Et.key},mt("code",n({},Nt.attrs,{className:Nt.lang?"lang-"+Nt.lang:""}),Nt.text))},4:{t:["```","~~~"],o:Te(y),i:0,u:Nt=>({attrs:_t("code",Nt[3]||""),lang:Nt[2]||void 0,text:Nt[4],type:"3"})},5:{t:["`"],o:Ie(g),i:3,u:Nt=>({text:Fe(Nt[2])}),l:(Nt,$t,Et)=>mt("code",{key:Et.key},Nt.text)},6:{t:["[^"],o:Te(x),i:0,u:Nt=>(vt.push({footnote:Nt[2],identifier:Nt[1]}),{}),l:Ve},7:{t:["[^"],o:Ce(q),i:1,u:Nt=>({target:"#"+ct(Nt[1],Ae),text:Nt[1]}),l:(Nt,$t,Et)=>mt("a",{key:Et.key,href:dt(Nt.target,"a","href")},mt("sup",{key:Et.key},Nt.text))},8:{t:["[ ]","[x]"],o:Ce($),i:1,u:Nt=>({completed:Nt[1].toLowerCase()==="x"}),l:(Nt,$t,Et)=>mt("input",{checked:Nt.completed,key:Et.key,readOnly:!0,type:"checkbox"})},9:{t:["#"],o:Te(it.enforceAtxHeadings?z:S),i:1,u:(Nt,$t,Et)=>({children:Pe($t,Nt[2],Et),id:ct(Nt[2],Ae),level:Nt[1].length}),l:(Nt,$t,Et)=>mt("h"+Nt.level,{id:Nt.id,key:Et.key},$t(Nt.children,Et))},10:{t:Nt=>{const $t=Nt.indexOf(`
-`);return $t>0&&$t<Nt.length-1&&(Nt[$t+1]==="="||Nt[$t+1]==="-")},o:Te(E),i:1,u:(Nt,$t,Et)=>({children:Pe($t,Nt[1],Et),level:Nt[2]==="="?1:2,type:"9"})},11:{t:["<"],o:Me(A),i:1,u(Nt,$t,Et){const[,Ft]=Nt[3].match(ae),qt=RegExp("^"+Ft,"gm"),Ht=Nt[3].replace(qt,""),Ot=ft(yt,Ht)?Ne:Pe,Zt=Nt[1].toLowerCase(),Yt=c.indexOf(Zt)!==-1,aa=(Yt?Zt:Nt[1]).trim(),Qt={attrs:_t(aa,Nt[2]),noInnerParse:Yt,tag:aa};if(Et.inAnchor=Et.inAnchor||Zt==="a",Yt)Qt.text=Nt[3];else{const oa=Et.inHTML;Et.inHTML=!0,Qt.children=Ot($t,Ht,Et),Et.inHTML=oa}return Et.inAnchor=!1,Qt},l:(Nt,$t,Et)=>mt(Nt.tag,n({key:Et.key},Nt.attrs),Nt.text||(Nt.children?$t(Nt.children,Et):""))},13:{t:["<"],o:Me(O),i:1,u(Nt){const $t=Nt[1].trim();return{attrs:_t($t,Nt[2]||""),tag:$t}},l:(Nt,$t,Et)=>mt(Nt.tag,n({},Nt.attrs,{key:Et.key}))},12:{t:["<!--"],o:Me(B),i:1,u:()=>({}),l:Ve},14:{t:["!["],o:Ie(be),i:1,u:Nt=>({alt:Fe(Nt[1]),target:Fe(Nt[2]),title:Fe(Nt[3])}),l:(Nt,$t,Et)=>mt("img",{key:Et.key,alt:Nt.alt||void 0,title:Nt.title||void 0,src:dt(Nt.target,"img","src")})},15:{t:["["],o:Ce(ve),i:3,u:(Nt,$t,Et)=>({children:Ze($t,Nt[1],Et),target:Fe(Nt[2]),title:Fe(Nt[3])}),l:(Nt,$t,Et)=>mt("a",{key:Et.key,href:dt(Nt.target,"a","href"),title:Nt.title},$t(Nt.children,Et))},16:{t:["<"],o:Ce(I),i:0,u(Nt){let $t=Nt[1],Et=!1;return $t.indexOf("@")!==-1&&$t.indexOf("//")===-1&&(Et=!0,$t=$t.replace("mailto:","")),{children:[{text:$t,type:"27"}],target:Et?"mailto:"+$t:$t,type:"15"}}},17:{t:(Nt,$t)=>!$t.inAnchor&&!it.disableAutoLink&&(ze(Nt,"http://")||ze(Nt,"https://")),o:Ce(C),i:0,u:Nt=>({children:[{text:Nt[1],type:"27"}],target:Nt[1],title:void 0,type:"15"})},20:qe(mt,1),33:qe(mt,2),19:{t:[`
-`],o:Te(m),i:3,u:Ue,l:()=>`
-`},21:{o:je(function(Nt,$t){if($t.inline||$t.simple||$t.inHTML&&Nt.indexOf(`
-
-`)===-1&&$t.prevCapture.indexOf(`
-
-`)===-1)return null;let Et="",Ft=0;for(;;){const Ht=Nt.indexOf(`
-`,Ft),Ot=Nt.slice(Ft,Ht===-1?void 0:Ht+1);if(ft(pt,Ot)||(Et+=Ot,Ht===-1||!Ot.trim()))break;Ft=Ht+1}const qt=Se(Et);return qt===""?null:[Et,,qt]}),i:3,u:Ge,l:(Nt,$t,Et)=>mt("p",{key:Et.key},$t(Nt.children,Et))},22:{t:["["],o:Ce(D),i:0,u:Nt=>(bt[Nt[1]]={target:Nt[2],title:Nt[4]},{}),l:Ve},23:{t:["!["],o:Ie(F),i:0,u:Nt=>({alt:Nt[1]?Fe(Nt[1]):void 0,ref:Nt[2]}),l:(Nt,$t,Et)=>bt[Nt.ref]?mt("img",{key:Et.key,alt:Nt.alt,src:dt(bt[Nt.ref].target,"img","src"),title:bt[Nt.ref].title}):null},24:{t:Nt=>Nt[0]==="["&&Nt.indexOf("](")===-1,o:Ce(P),i:0,u:(Nt,$t,Et)=>({children:$t(Nt[1],Et),fallbackChildren:Nt[0],ref:Nt[2]}),l:(Nt,$t,Et)=>bt[Nt.ref]?mt("a",{key:Et.key,href:dt(bt[Nt.ref].target,"a","href"),title:bt[Nt.ref].title},$t(Nt.children,Et)):mt("span",{key:Et.key},Nt.fallbackChildren)},25:{t:["|"],o:Te(M),i:1,u:Le,l(Nt,$t,Et){const Ft=Nt;return mt("table",{key:Et.key},mt("thead",null,mt("tr",null,Ft.header.map(function(qt,Ht){return mt("th",{key:Ht,style:Oe(Ft,Ht)},$t(qt,Et))}))),mt("tbody",null,Ft.cells.map(function(qt,Ht){return mt("tr",{key:Ht},qt.map(function(Ot,Zt){return mt("td",{key:Zt,style:Oe(Ft,Zt)},$t(Ot,Et))}))})))}},27:{o:je(function(Nt,$t){let Et;return ze(Nt,":")&&(Et=ee.exec(Nt)),Et||te.exec(Nt)}),i:4,u(Nt){const $t=Nt[0];return{text:$t.indexOf("&")===-1?$t:$t.replace(R,(Et,Ft)=>it.namedCodesToUnicode[Ft]||Et)}},l:Nt=>Nt.text},28:{t:["**","__"],o:Ie(J),i:2,u:(Nt,$t,Et)=>({children:$t(Nt[2],Et)}),l:(Nt,$t,Et)=>mt("strong",{key:Et.key},$t(Nt.children,Et))},29:{t:Nt=>{const $t=Nt[0];return($t==="*"||$t==="_")&&Nt[1]!==$t},o:Ie(K),i:3,u:(Nt,$t,Et)=>({children:$t(Nt[2],Et)}),l:(Nt,$t,Et)=>mt("em",{key:Et.key},$t(Nt.children,Et))},30:{t:["\\"],o:Ie(ne),i:1,u:Nt=>({text:Nt[1],type:"27"})},31:{t:["=="],o:Ie(X),i:3,u:Ge,l:(Nt,$t,Et)=>mt("mark",{key:Et.key},$t(Nt.children,Et))},32:{t:["~~"],o:Ie(Y),i:3,u:Ge,l:(Nt,$t,Et)=>mt("del",{key:Et.key},$t(Nt.children,Et))}};it.disableParsingRawHTML===!0&&(delete Mt[11],delete Mt[13]);const wt=(function(Nt){var $t=Object.keys(Nt);function Et(Ft,qt){var Ht=[];if(qt.prevCapture=qt.prevCapture||"",Ft.trim())for(;Ft;)for(var Ot=0;Ot<$t.length;){var Zt=$t[Ot],Yt=Nt[Zt];if(!Yt.t||Ee(Ft,qt,Yt.t)){var aa=Yt.o(Ft,qt);if(aa&&aa[0]){Ft=Ft.substring(aa[0].length);var Qt=Yt.u(aa,Et,qt);qt.prevCapture+=aa[0],Qt.type||(Qt.type=Zt),Ht.push(Qt);break}Ot++}else Ot++}return qt.prevCapture="",Ht}return $t.sort(function(Ft,qt){return Nt[Ft].i-Nt[qt].i||(Ft<qt?-1:1)}),function(Ft,qt){return Et((function(Ht){return Ht.replace(k,`
-`).replace(v,"").replace(N,"    ")})(Ft),qt)}})(Mt),St=(function(Nt,$t){return function Et(Ft,qt={}){if(Array.isArray(Ft)){const Ht=qt.key,Ot=[];let Zt=!1;for(let Yt=0;Yt<Ft.length;Yt++){qt.key=Yt;const aa=Et(Ft[Yt],qt),Qt=$e(aa);Qt&&Zt?Ot[Ot.length-1]+=aa:aa!==null&&Ot.push(aa),Zt=Qt}return qt.key=Ht,Ot}return(function(Ht,Ot,Zt){const Yt=Nt[Ht.type].l;return $t?$t(()=>Yt(Ht,Ot,Zt),Ht,Ot,Zt):Yt(Ht,Ot,Zt)})(Ft,Et,qt)}})(Mt,it.renderRule),It=kt(rt);return vt.length?mt("div",null,It,mt("footer",{key:"footer"},vt.map(function(Nt){return mt("div",{id:ct(Nt.identifier,Ae),key:Nt.identifier},Nt.identifier,St(wt(Nt.footnote,{inline:!0})))}))):It}const Markdown=rt=>{let{children:it,options:ct}=rt,dt=(function(ut,pt){if(ut==null)return{};var yt,ft,mt={},kt=Object.keys(ut);for(ft=0;ft<kt.length;ft++)pt.indexOf(yt=kt[ft])>=0||(mt[yt]=ut[yt]);return mt})(rt,r$1);return reactExports.cloneElement(We(it??"",ct),dt)};function TableOfContents({toc:rt,title:it="Table of Contents",className:ct="",maxDepth:dt=4,activeId:ut}){if(!rt||rt.length===0)return null;const pt=(ft,mt)=>{ft.preventDefault();const kt=document.getElementById(mt);kt&&(kt.scrollIntoView({behavior:"smooth",block:"start"}),window.history.pushState&&window.history.pushState(null,"",`#${mt}`))},yt=(ft,mt=0)=>{if(mt>=dt)return null;const kt=ut===ft.id,_t=ft.children&&ft.children.length>0;return jsxRuntimeExports.jsxs("li",{className:`toc-item toc-item--level-${ft.level}`,children:[jsxRuntimeExports.jsx("a",{href:`#${ft.id}`,className:`toc-link ${kt?"toc-link--active":""}`,onClick:vt=>pt(vt,ft.id),title:ft.text,children:ft.text}),_t&&jsxRuntimeExports.jsx("ul",{className:`toc-list toc-list--level-${ft.level+1}`,children:ft.children.map(vt=>yt(vt,mt+1))})]},ft.id)};return jsxRuntimeExports.jsxs("nav",{className:`toc-container ${ct}`,"aria-label":"Table of contents",children:[jsxRuntimeExports.jsx("h3",{className:"toc-title",children:it}),jsxRuntimeExports.jsx("ul",{className:"toc-list toc-list--root",children:rt.map(ft=>yt(ft))})]})}function useActiveHeading(rt){const[it,ct]=React.useState("");return React.useEffect(()=>{if(!rt||rt.length===0)return;const dt=yt=>yt.reduce((ft,mt)=>(ft.push(mt),mt.children&&mt.children.length>0&&ft.push(...dt(mt.children)),ft),[]),ut=dt(rt),pt=()=>{const yt=ut.map(kt=>{const _t=document.getElementById(kt.id);if(_t){const vt=_t.getBoundingClientRect();return{id:kt.id,top:vt.top,element:_t}}return null}).filter(Boolean);if(yt.length===0)return;const ft=100;let mt="";for(const kt of yt)if(kt.top<=ft)mt=kt.id;else break;!mt&&yt.length>0&&(mt=yt[0].id),ct(mt)};return pt(),window.addEventListener("scroll",pt,{passive:!0}),window.addEventListener("resize",pt,{passive:!0}),()=>{window.removeEventListener("scroll",pt),window.removeEventListener("resize",pt)}},[rt]),it}const TocContext=reactExports.createContext(null);function useToc(){return reactExports.useContext(TocContext)}function TocProvider({children:rt}){const[it,ct]=reactExports.useState([]),[dt,ut]=reactExports.useState(""),pt={toc:it,setToc:ct,activeId:dt,setActiveId:ut};return jsxRuntimeExports.jsx(TocContext.Provider,{value:pt,children:rt})}function r(rt){var it,ct,dt="";if(typeof rt=="string"||typeof rt=="number")dt+=rt;else if(typeof rt=="object")if(Array.isArray(rt)){var ut=rt.length;for(it=0;it<ut;it++)rt[it]&&(ct=r(rt[it]))&&(dt&&(dt+=" "),dt+=ct)}else for(ct in rt)rt[ct]&&(dt&&(dt+=" "),dt+=ct);return dt}function clsx(){for(var rt,it,ct=0,dt="",ut=arguments.length;ct<ut;ct++)(rt=arguments[ct])&&(it=r(rt))&&(dt&&(dt+=" "),dt+=it);return dt}var __create=Object.create,__defProp=Object.defineProperty,__defProps=Object.defineProperties,__getOwnPropDesc=Object.getOwnPropertyDescriptor,__getOwnPropDescs=Object.getOwnPropertyDescriptors,__getOwnPropNames=Object.getOwnPropertyNames,__getOwnPropSymbols=Object.getOwnPropertySymbols,__getProtoOf=Object.getPrototypeOf,__hasOwnProp=Object.prototype.hasOwnProperty,__propIsEnum=Object.prototype.propertyIsEnumerable,__defNormalProp=(rt,it,ct)=>it in rt?__defProp(rt,it,{enumerable:!0,configurable:!0,writable:!0,value:ct}):rt[it]=ct,__spreadValues=(rt,it)=>{for(var ct in it||(it={}))__hasOwnProp.call(it,ct)&&__defNormalProp(rt,ct,it[ct]);if(__getOwnPropSymbols)for(var ct of __getOwnPropSymbols(it))__propIsEnum.call(it,ct)&&__defNormalProp(rt,ct,it[ct]);return rt},__spreadProps=(rt,it)=>__defProps(rt,__getOwnPropDescs(it)),__objRest=(rt,it)=>{var ct={};for(var dt in rt)__hasOwnProp.call(rt,dt)&&it.indexOf(dt)<0&&(ct[dt]=rt[dt]);if(rt!=null&&__getOwnPropSymbols)for(var dt of __getOwnPropSymbols(rt))it.indexOf(dt)<0&&__propIsEnum.call(rt,dt)&&(ct[dt]=rt[dt]);return ct},__commonJS=(rt,it)=>function(){return it||(0,rt[__getOwnPropNames(rt)[0]])((it={exports:{}}).exports,it),it.exports},__export=(rt,it)=>{for(var ct in it)__defProp(rt,ct,{get:it[ct],enumerable:!0})},__copyProps=(rt,it,ct,dt)=>{if(it&&typeof it=="object"||typeof it=="function")for(let ut of __getOwnPropNames(it))!__hasOwnProp.call(rt,ut)&&ut!==ct&&__defProp(rt,ut,{get:()=>it[ut],enumerable:!(dt=__getOwnPropDesc(it,ut))||dt.enumerable});return rt},__toESM=(rt,it,ct)=>(ct=rt!=null?__create(__getProtoOf(rt)):{},__copyProps(!rt||!rt.__esModule?__defProp(ct,"default",{value:rt,enumerable:!0}):ct,rt)),require_prism=__commonJS({"../../node_modules/.pnpm/prismjs@1.29.0_patch_hash=vrxx3pzkik6jpmgpayxfjunetu/node_modules/prismjs/prism.js"(rt,it){var ct=(function(){var dt=/(?:^|\s)lang(?:uage)?-([\w-]+)(?=\s|$)/i,ut=0,pt={},yt={util:{encode:function wt(St){return St instanceof ft?new ft(St.type,wt(St.content),St.alias):Array.isArray(St)?St.map(wt):St.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/\u00a0/g," ")},type:function(wt){return Object.prototype.toString.call(wt).slice(8,-1)},objId:function(wt){return wt.__id||Object.defineProperty(wt,"__id",{value:++ut}),wt.__id},clone:function wt(St,It){It=It||{};var Nt,$t;switch(yt.util.type(St)){case"Object":if($t=yt.util.objId(St),It[$t])return It[$t];Nt={},It[$t]=Nt;for(var Et in St)St.hasOwnProperty(Et)&&(Nt[Et]=wt(St[Et],It));return Nt;case"Array":return $t=yt.util.objId(St),It[$t]?It[$t]:(Nt=[],It[$t]=Nt,St.forEach(function(Ft,qt){Nt[qt]=wt(Ft,It)}),Nt);default:return St}},getLanguage:function(wt){for(;wt;){var St=dt.exec(wt.className);if(St)return St[1].toLowerCase();wt=wt.parentElement}return"none"},setLanguage:function(wt,St){wt.className=wt.className.replace(RegExp(dt,"gi"),""),wt.classList.add("language-"+St)},isActive:function(wt,St,It){for(var Nt="no-"+St;wt;){var $t=wt.classList;if($t.contains(St))return!0;if($t.contains(Nt))return!1;wt=wt.parentElement}return!!It}},languages:{plain:pt,plaintext:pt,text:pt,txt:pt,extend:function(wt,St){var It=yt.util.clone(yt.languages[wt]);for(var Nt in St)It[Nt]=St[Nt];return It},insertBefore:function(wt,St,It,Nt){Nt=Nt||yt.languages;var $t=Nt[wt],Et={};for(var Ft in $t)if($t.hasOwnProperty(Ft)){if(Ft==St)for(var qt in It)It.hasOwnProperty(qt)&&(Et[qt]=It[qt]);It.hasOwnProperty(Ft)||(Et[Ft]=$t[Ft])}var Ht=Nt[wt];return Nt[wt]=Et,yt.languages.DFS(yt.languages,function(Ot,Zt){Zt===Ht&&Ot!=wt&&(this[Ot]=Et)}),Et},DFS:function wt(St,It,Nt,$t){$t=$t||{};var Et=yt.util.objId;for(var Ft in St)if(St.hasOwnProperty(Ft)){It.call(St,Ft,St[Ft],Nt||Ft);var qt=St[Ft],Ht=yt.util.type(qt);Ht==="Object"&&!$t[Et(qt)]?($t[Et(qt)]=!0,wt(qt,It,null,$t)):Ht==="Array"&&!$t[Et(qt)]&&($t[Et(qt)]=!0,wt(qt,It,Ft,$t))}}},plugins:{},highlight:function(wt,St,It){var Nt={code:wt,grammar:St,language:It};if(yt.hooks.run("before-tokenize",Nt),!Nt.grammar)throw new Error('The language "'+Nt.language+'" has no grammar.');return Nt.tokens=yt.tokenize(Nt.code,Nt.grammar),yt.hooks.run("after-tokenize",Nt),ft.stringify(yt.util.encode(Nt.tokens),Nt.language)},tokenize:function(wt,St){var It=St.rest;if(It){for(var Nt in It)St[Nt]=It[Nt];delete St.rest}var $t=new _t;return vt($t,$t.head,wt),kt(wt,$t,St,$t.head,0),Mt($t)},hooks:{all:{},add:function(wt,St){var It=yt.hooks.all;It[wt]=It[wt]||[],It[wt].push(St)},run:function(wt,St){var It=yt.hooks.all[wt];if(!(!It||!It.length))for(var Nt=0,$t;$t=It[Nt++];)$t(St)}},Token:ft};function ft(wt,St,It,Nt){this.type=wt,this.content=St,this.alias=It,this.length=(Nt||"").length|0}ft.stringify=function wt(St,It){if(typeof St=="string")return St;if(Array.isArray(St)){var Nt="";return St.forEach(function(Ht){Nt+=wt(Ht,It)}),Nt}var $t={type:St.type,content:wt(St.content,It),tag:"span",classes:["token",St.type],attributes:{},language:It},Et=St.alias;Et&&(Array.isArray(Et)?Array.prototype.push.apply($t.classes,Et):$t.classes.push(Et)),yt.hooks.run("wrap",$t);var Ft="";for(var qt in $t.attributes)Ft+=" "+qt+'="'+($t.attributes[qt]||"").replace(/"/g,"&quot;")+'"';return"<"+$t.tag+' class="'+$t.classes.join(" ")+'"'+Ft+">"+$t.content+"</"+$t.tag+">"};function mt(wt,St,It,Nt){wt.lastIndex=St;var $t=wt.exec(It);if($t&&Nt&&$t[1]){var Et=$t[1].length;$t.index+=Et,$t[0]=$t[0].slice(Et)}return $t}function kt(wt,St,It,Nt,$t,Et){for(var Ft in It)if(!(!It.hasOwnProperty(Ft)||!It[Ft])){var qt=It[Ft];qt=Array.isArray(qt)?qt:[qt];for(var Ht=0;Ht<qt.length;++Ht){if(Et&&Et.cause==Ft+","+Ht)return;var Ot=qt[Ht],Zt=Ot.inside,Yt=!!Ot.lookbehind,aa=!!Ot.greedy,Qt=Ot.alias;if(aa&&!Ot.pattern.global){var oa=Ot.pattern.toString().match(/[imsuy]*$/)[0];Ot.pattern=RegExp(Ot.pattern.source,oa+"g")}for(var la=Ot.pattern||Ot,Kt=Nt.next,ra=$t;Kt!==St.tail&&!(Et&&ra>=Et.reach);ra+=Kt.value.length,Kt=Kt.next){var Ut=Kt.value;if(St.length>wt.length)return;if(!(Ut instanceof ft)){var ea=1,Gt;if(aa){if(Gt=mt(la,ra,wt,Yt),!Gt||Gt.index>=wt.length)break;var ta=Gt.index,_a=Gt.index+Gt[0].length,Ca=ra;for(Ca+=Kt.value.length;ta>=Ca;)Kt=Kt.next,Ca+=Kt.value.length;if(Ca-=Kt.value.length,ra=Ca,Kt.value instanceof ft)continue;for(var Vt=Kt;Vt!==St.tail&&(Ca<_a||typeof Vt.value=="string");Vt=Vt.next)ea++,Ca+=Vt.value.length;ea--,Ut=wt.slice(ra,Ca),Gt.index-=ra}else if(Gt=mt(la,0,Ut,Yt),!Gt)continue;var ta=Gt.index,sa=Gt[0],xa=Ut.slice(0,ta),ka=Ut.slice(ta+sa.length),$a=ra+Ut.length;Et&&$a>Et.reach&&(Et.reach=$a);var Na=Kt.prev;xa&&(Na=vt(St,Na,xa),ra+=xa.length),bt(St,Na,ea);var Fa=new ft(Ft,Zt?yt.tokenize(sa,Zt):sa,Qt,sa);if(Kt=vt(St,Na,Fa),ka&&vt(St,Kt,ka),ea>1){var qa={cause:Ft+","+Ht,reach:$a};kt(wt,St,It,Kt.prev,ra,qa),Et&&qa.reach>Et.reach&&(Et.reach=qa.reach)}}}}}}function _t(){var wt={value:null,prev:null,next:null},St={value:null,prev:wt,next:null};wt.next=St,this.head=wt,this.tail=St,this.length=0}function vt(wt,St,It){var Nt=St.next,$t={value:It,prev:St,next:Nt};return St.next=$t,Nt.prev=$t,wt.length++,$t}function bt(wt,St,It){for(var Nt=St.next,$t=0;$t<It&&Nt!==wt.tail;$t++)Nt=Nt.next;St.next=Nt,Nt.prev=St,wt.length-=$t}function Mt(wt){for(var St=[],It=wt.head.next;It!==wt.tail;)St.push(It.value),It=It.next;return St}return yt})();it.exports=ct,ct.default=ct}}),Prism$1=__toESM(require_prism());Prism$1.languages.markup={comment:{pattern:/<!--(?:(?!<!--)[\s\S])*?-->/,greedy:!0},prolog:{pattern:/<\?[\s\S]+?\?>/,greedy:!0},doctype:{pattern:/<!DOCTYPE(?:[^>"'[\]]|"[^"]*"|'[^']*')+(?:\[(?:[^<"'\]]|"[^"]*"|'[^']*'|<(?!!--)|<!--(?:[^-]|-(?!->))*-->)*\]\s*)?>/i,greedy:!0,inside:{"internal-subset":{pattern:/(^[^\[]*\[)[\s\S]+(?=\]>$)/,lookbehind:!0,greedy:!0,inside:null},string:{pattern:/"[^"]*"|'[^']*'/,greedy:!0},punctuation:/^<!|>$|[[\]]/,"doctype-tag":/^DOCTYPE/i,name:/[^\s<>'"]+/}},cdata:{pattern:/<!\[CDATA\[[\s\S]*?\]\]>/i,greedy:!0},tag:{pattern:/<\/?(?!\d)[^\s>\/=$<%]+(?:\s(?:\s*[^\s>\/=]+(?:\s*=\s*(?:"[^"]*"|'[^']*'|[^\s'">=]+(?=[\s>]))|(?=[\s/>])))+)?\s*\/?>/,greedy:!0,inside:{tag:{pattern:/^<\/?[^\s>\/]+/,inside:{punctuation:/^<\/?/,namespace:/^[^\s>\/:]+:/}},"special-attr":[],"attr-value":{pattern:/=\s*(?:"[^"]*"|'[^']*'|[^\s'">=]+)/,inside:{punctuation:[{pattern:/^=/,alias:"attr-equals"},{pattern:/^(\s*)["']|["']$/,lookbehind:!0}]}},punctuation:/\/?>/,"attr-name":{pattern:/[^\s>\/]+/,inside:{namespace:/^[^\s>\/:]+:/}}}},entity:[{pattern:/&[\da-z]{1,8};/i,alias:"named-entity"},/&#x?[\da-f]{1,8};/i]},Prism$1.languages.markup.tag.inside["attr-value"].inside.entity=Prism$1.languages.markup.entity,Prism$1.languages.markup.doctype.inside["internal-subset"].inside=Prism$1.languages.markup,Prism$1.hooks.add("wrap",function(rt){rt.type==="entity"&&(rt.attributes.title=rt.content.replace(/&amp;/,"&"))}),Object.defineProperty(Prism$1.languages.markup.tag,"addInlined",{value:function(rt,dt){var ct={},ct=(ct["language-"+dt]={pattern:/(^<!\[CDATA\[)[\s\S]+?(?=\]\]>$)/i,lookbehind:!0,inside:Prism$1.languages[dt]},ct.cdata=/^<!\[CDATA\[|\]\]>$/i,{"included-cdata":{pattern:/<!\[CDATA\[[\s\S]*?\]\]>/i,inside:ct}}),dt=(ct["language-"+dt]={pattern:/[\s\S]+/,inside:Prism$1.languages[dt]},{});dt[rt]={pattern:RegExp(/(<__[^>]*>)(?:<!\[CDATA\[(?:[^\]]|\](?!\]>))*\]\]>|(?!<!\[CDATA\[)[\s\S])*?(?=<\/__>)/.source.replace(/__/g,function(){return rt}),"i"),lookbehind:!0,greedy:!0,inside:ct},Prism$1.languages.insertBefore("markup","cdata",dt)}}),Object.defineProperty(Prism$1.languages.markup.tag,"addAttribute",{value:function(rt,it){Prism$1.languages.markup.tag.inside["special-attr"].push({pattern:RegExp(/(^|["'\s])/.source+"(?:"+rt+")"+/\s*=\s*(?:"[^"]*"|'[^']*'|[^\s'">=]+(?=[\s>]))/.source,"i"),lookbehind:!0,inside:{"attr-name":/^[^\s=]+/,"attr-value":{pattern:/=[\s\S]+/,inside:{value:{pattern:/(^=\s*(["']|(?!["'])))\S[\s\S]*(?=\2$)/,lookbehind:!0,alias:[it,"language-"+it],inside:Prism$1.languages[it]},punctuation:[{pattern:/^=/,alias:"attr-equals"},/"|'/]}}}})}}),Prism$1.languages.html=Prism$1.languages.markup,Prism$1.languages.mathml=Prism$1.languages.markup,Prism$1.languages.svg=Prism$1.languages.markup,Prism$1.languages.xml=Prism$1.languages.extend("markup",{}),Prism$1.languages.ssml=Prism$1.languages.xml,Prism$1.languages.atom=Prism$1.languages.xml,Prism$1.languages.rss=Prism$1.languages.xml,(function(rt){var it={pattern:/\\[\\(){}[\]^$+*?|.]/,alias:"escape"},ct=/\\(?:x[\da-fA-F]{2}|u[\da-fA-F]{4}|u\{[\da-fA-F]+\}|0[0-7]{0,2}|[123][0-7]{2}|c[a-zA-Z]|.)/,dt="(?:[^\\\\-]|"+ct.source+")",dt=RegExp(dt+"-"+dt),ut={pattern:/(<|')[^<>']+(?=[>']$)/,lookbehind:!0,alias:"variable"};rt.languages.regex={"char-class":{pattern:/((?:^|[^\\])(?:\\\\)*)\[(?:[^\\\]]|\\[\s\S])*\]/,lookbehind:!0,inside:{"char-class-negation":{pattern:/(^\[)\^/,lookbehind:!0,alias:"operator"},"char-class-punctuation":{pattern:/^\[|\]$/,alias:"punctuation"},range:{pattern:dt,inside:{escape:ct,"range-punctuation":{pattern:/-/,alias:"operator"}}},"special-escape":it,"char-set":{pattern:/\\[wsd]|\\p\{[^{}]+\}/i,alias:"class-name"},escape:ct}},"special-escape":it,"char-set":{pattern:/\.|\\[wsd]|\\p\{[^{}]+\}/i,alias:"class-name"},backreference:[{pattern:/\\(?![123][0-7]{2})[1-9]/,alias:"keyword"},{pattern:/\\k<[^<>']+>/,alias:"keyword",inside:{"group-name":ut}}],anchor:{pattern:/[$^]|\\[ABbGZz]/,alias:"function"},escape:ct,group:[{pattern:/\((?:\?(?:<[^<>']+>|'[^<>']+'|[>:]|<?[=!]|[idmnsuxU]+(?:-[idmnsuxU]+)?:?))?/,alias:"punctuation",inside:{"group-name":ut}},{pattern:/\)/,alias:"punctuation"}],quantifier:{pattern:/(?:[+*?]|\{\d+(?:,\d*)?\})[?+]?/,alias:"number"},alternation:{pattern:/\|/,alias:"keyword"}}})(Prism$1),Prism$1.languages.clike={comment:[{pattern:/(^|[^\\])\/\*[\s\S]*?(?:\*\/|$)/,lookbehind:!0,greedy:!0},{pattern:/(^|[^\\:])\/\/.*/,lookbehind:!0,greedy:!0}],string:{pattern:/(["'])(?:\\(?:\r\n|[\s\S])|(?!\1)[^\\\r\n])*\1/,greedy:!0},"class-name":{pattern:/(\b(?:class|extends|implements|instanceof|interface|new|trait)\s+|\bcatch\s+\()[\w.\\]+/i,lookbehind:!0,inside:{punctuation:/[.\\]/}},keyword:/\b(?:break|catch|continue|do|else|finally|for|function|if|in|instanceof|new|null|return|throw|try|while)\b/,boolean:/\b(?:false|true)\b/,function:/\b\w+(?=\()/,number:/\b0x[\da-f]+\b|(?:\b\d+(?:\.\d*)?|\B\.\d+)(?:e[+-]?\d+)?/i,operator:/[<>]=?|[!=]=?=?|--?|\+\+?|&&?|\|\|?|[?*/~^%]/,punctuation:/[{}[\];(),.:]/},Prism$1.languages.javascript=Prism$1.languages.extend("clike",{"class-name":[Prism$1.languages.clike["class-name"],{pattern:/(^|[^$\w\xA0-\uFFFF])(?!\s)[_$A-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?=\.(?:constructor|prototype))/,lookbehind:!0}],keyword:[{pattern:/((?:^|\})\s*)catch\b/,lookbehind:!0},{pattern:/(^|[^.]|\.\.\.\s*)\b(?:as|assert(?=\s*\{)|async(?=\s*(?:function\b|\(|[$\w\xA0-\uFFFF]|$))|await|break|case|class|const|continue|debugger|default|delete|do|else|enum|export|extends|finally(?=\s*(?:\{|$))|for|from(?=\s*(?:['"]|$))|function|(?:get|set)(?=\s*(?:[#\[$\w\xA0-\uFFFF]|$))|if|implements|import|in|instanceof|interface|let|new|null|of|package|private|protected|public|return|static|super|switch|this|throw|try|typeof|undefined|var|void|while|with|yield)\b/,lookbehind:!0}],function:/#?(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?=\s*(?:\.\s*(?:apply|bind|call)\s*)?\()/,number:{pattern:RegExp(/(^|[^\w$])/.source+"(?:"+/NaN|Infinity/.source+"|"+/0[bB][01]+(?:_[01]+)*n?/.source+"|"+/0[oO][0-7]+(?:_[0-7]+)*n?/.source+"|"+/0[xX][\dA-Fa-f]+(?:_[\dA-Fa-f]+)*n?/.source+"|"+/\d+(?:_\d+)*n/.source+"|"+/(?:\d+(?:_\d+)*(?:\.(?:\d+(?:_\d+)*)?)?|\.\d+(?:_\d+)*)(?:[Ee][+-]?\d+(?:_\d+)*)?/.source+")"+/(?![\w$])/.source),lookbehind:!0},operator:/--|\+\+|\*\*=?|=>|&&=?|\|\|=?|[!=]==|<<=?|>>>?=?|[-+*/%&|^!=<>]=?|\.{3}|\?\?=?|\?\.?|[~:]/}),Prism$1.languages.javascript["class-name"][0].pattern=/(\b(?:class|extends|implements|instanceof|interface|new)\s+)[\w.\\]+/,Prism$1.languages.insertBefore("javascript","keyword",{regex:{pattern:RegExp(/((?:^|[^$\w\xA0-\uFFFF."'\])\s]|\b(?:return|yield))\s*)/.source+/\//.source+"(?:"+/(?:\[(?:[^\]\\\r\n]|\\.)*\]|\\.|[^/\\\[\r\n])+\/[dgimyus]{0,7}/.source+"|"+/(?:\[(?:[^[\]\\\r\n]|\\.|\[(?:[^[\]\\\r\n]|\\.|\[(?:[^[\]\\\r\n]|\\.)*\])*\])*\]|\\.|[^/\\\[\r\n])+\/[dgimyus]{0,7}v[dgimyus]{0,7}/.source+")"+/(?=(?:\s|\/\*(?:[^*]|\*(?!\/))*\*\/)*(?:$|[\r\n,.;:})\]]|\/\/))/.source),lookbehind:!0,greedy:!0,inside:{"regex-source":{pattern:/^(\/)[\s\S]+(?=\/[a-z]*$)/,lookbehind:!0,alias:"language-regex",inside:Prism$1.languages.regex},"regex-delimiter":/^\/|\/$/,"regex-flags":/^[a-z]+$/}},"function-variable":{pattern:/#?(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?=\s*[=:]\s*(?:async\s*)?(?:\bfunction\b|(?:\((?:[^()]|\([^()]*\))*\)|(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*)\s*=>))/,alias:"function"},parameter:[{pattern:/(function(?:\s+(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*)?\s*\(\s*)(?!\s)(?:[^()\s]|\s+(?![\s)])|\([^()]*\))+(?=\s*\))/,lookbehind:!0,inside:Prism$1.languages.javascript},{pattern:/(^|[^$\w\xA0-\uFFFF])(?!\s)[_$a-z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?=\s*=>)/i,lookbehind:!0,inside:Prism$1.languages.javascript},{pattern:/(\(\s*)(?!\s)(?:[^()\s]|\s+(?![\s)])|\([^()]*\))+(?=\s*\)\s*=>)/,lookbehind:!0,inside:Prism$1.languages.javascript},{pattern:/((?:\b|\s|^)(?!(?:as|async|await|break|case|catch|class|const|continue|debugger|default|delete|do|else|enum|export|extends|finally|for|from|function|get|if|implements|import|in|instanceof|interface|let|new|null|of|package|private|protected|public|return|set|static|super|switch|this|throw|try|typeof|undefined|var|void|while|with|yield)(?![$\w\xA0-\uFFFF]))(?:(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*\s*)\(\s*|\]\s*\(\s*)(?!\s)(?:[^()\s]|\s+(?![\s)])|\([^()]*\))+(?=\s*\)\s*\{)/,lookbehind:!0,inside:Prism$1.languages.javascript}],constant:/\b[A-Z](?:[A-Z_]|\dx?)*\b/}),Prism$1.languages.insertBefore("javascript","string",{hashbang:{pattern:/^#!.*/,greedy:!0,alias:"comment"},"template-string":{pattern:/`(?:\\[\s\S]|\$\{(?:[^{}]|\{(?:[^{}]|\{[^}]*\})*\})+\}|(?!\$\{)[^\\`])*`/,greedy:!0,inside:{"template-punctuation":{pattern:/^`|`$/,alias:"string"},interpolation:{pattern:/((?:^|[^\\])(?:\\{2})*)\$\{(?:[^{}]|\{(?:[^{}]|\{[^}]*\})*\})+\}/,lookbehind:!0,inside:{"interpolation-punctuation":{pattern:/^\$\{|\}$/,alias:"punctuation"},rest:Prism$1.languages.javascript}},string:/[\s\S]+/}},"string-property":{pattern:/((?:^|[,{])[ \t]*)(["'])(?:\\(?:\r\n|[\s\S])|(?!\2)[^\\\r\n])*\2(?=\s*:)/m,lookbehind:!0,greedy:!0,alias:"property"}}),Prism$1.languages.insertBefore("javascript","operator",{"literal-property":{pattern:/((?:^|[,{])[ \t]*)(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?=\s*:)/m,lookbehind:!0,alias:"property"}}),Prism$1.languages.markup&&(Prism$1.languages.markup.tag.addInlined("script","javascript"),Prism$1.languages.markup.tag.addAttribute(/on(?:abort|blur|change|click|composition(?:end|start|update)|dblclick|error|focus(?:in|out)?|key(?:down|up)|load|mouse(?:down|enter|leave|move|out|over|up)|reset|resize|scroll|select|slotchange|submit|unload|wheel)/.source,"javascript")),Prism$1.languages.js=Prism$1.languages.javascript,Prism$1.languages.actionscript=Prism$1.languages.extend("javascript",{keyword:/\b(?:as|break|case|catch|class|const|default|delete|do|dynamic|each|else|extends|final|finally|for|function|get|if|implements|import|in|include|instanceof|interface|internal|is|namespace|native|new|null|override|package|private|protected|public|return|set|static|super|switch|this|throw|try|typeof|use|var|void|while|with)\b/,operator:/\+\+|--|(?:[+\-*\/%^]|&&?|\|\|?|<<?|>>?>?|[!=]=?)=?|[~?@]/}),Prism$1.languages.actionscript["class-name"].alias="function",delete Prism$1.languages.actionscript.parameter,delete Prism$1.languages.actionscript["literal-property"],Prism$1.languages.markup&&Prism$1.languages.insertBefore("actionscript","string",{xml:{pattern:/(^|[^.])<\/?\w+(?:\s+[^\s>\/=]+=("|')(?:\\[\s\S]|(?!\2)[^\\])*\2)*\s*\/?>/,lookbehind:!0,inside:Prism$1.languages.markup}}),(function(rt){var it=/#(?!\{).+/,ct={pattern:/#\{[^}]+\}/,alias:"variable"};rt.languages.coffeescript=rt.languages.extend("javascript",{comment:it,string:[{pattern:/'(?:\\[\s\S]|[^\\'])*'/,greedy:!0},{pattern:/"(?:\\[\s\S]|[^\\"])*"/,greedy:!0,inside:{interpolation:ct}}],keyword:/\b(?:and|break|by|catch|class|continue|debugger|delete|do|each|else|extend|extends|false|finally|for|if|in|instanceof|is|isnt|let|loop|namespace|new|no|not|null|of|off|on|or|own|return|super|switch|then|this|throw|true|try|typeof|undefined|unless|until|when|while|window|with|yes|yield)\b/,"class-member":{pattern:/@(?!\d)\w+/,alias:"variable"}}),rt.languages.insertBefore("coffeescript","comment",{"multiline-comment":{pattern:/###[\s\S]+?###/,alias:"comment"},"block-regex":{pattern:/\/{3}[\s\S]*?\/{3}/,alias:"regex",inside:{comment:it,interpolation:ct}}}),rt.languages.insertBefore("coffeescript","string",{"inline-javascript":{pattern:/`(?:\\[\s\S]|[^\\`])*`/,inside:{delimiter:{pattern:/^`|`$/,alias:"punctuation"},script:{pattern:/[\s\S]+/,alias:"language-javascript",inside:rt.languages.javascript}}},"multiline-string":[{pattern:/'''[\s\S]*?'''/,greedy:!0,alias:"string"},{pattern:/"""[\s\S]*?"""/,greedy:!0,alias:"string",inside:{interpolation:ct}}]}),rt.languages.insertBefore("coffeescript","keyword",{property:/(?!\d)\w+(?=\s*:(?!:))/}),delete rt.languages.coffeescript["template-string"],rt.languages.coffee=rt.languages.coffeescript})(Prism$1),(function(rt){var it=rt.languages.javadoclike={parameter:{pattern:/(^[\t ]*(?:\/{3}|\*|\/\*\*)\s*@(?:arg|arguments|param)\s+)\w+/m,lookbehind:!0},keyword:{pattern:/(^[\t ]*(?:\/{3}|\*|\/\*\*)\s*|\{)@[a-z][a-zA-Z-]+\b/m,lookbehind:!0},punctuation:/[{}]/};Object.defineProperty(it,"addSupport",{value:function(ct,dt){(ct=typeof ct=="string"?[ct]:ct).forEach(function(ut){var pt=function(vt){vt.inside||(vt.inside={}),vt.inside.rest=dt},yt="doc-comment";if(ft=rt.languages[ut]){var ft,mt=ft[yt];if((mt=mt||(ft=rt.languages.insertBefore(ut,"comment",{"doc-comment":{pattern:/(^|[^\\])\/\*\*[^/][\s\S]*?(?:\*\/|$)/,lookbehind:!0,alias:"comment"}}))[yt])instanceof RegExp&&(mt=ft[yt]={pattern:mt}),Array.isArray(mt))for(var kt=0,_t=mt.length;kt<_t;kt++)mt[kt]instanceof RegExp&&(mt[kt]={pattern:mt[kt]}),pt(mt[kt]);else pt(mt)}})}}),it.addSupport(["java","javascript","php"],it)})(Prism$1),(function(rt){var it=/(?:"(?:\\(?:\r\n|[\s\S])|[^"\\\r\n])*"|'(?:\\(?:\r\n|[\s\S])|[^'\\\r\n])*')/,it=(rt.languages.css={comment:/\/\*[\s\S]*?\*\//,atrule:{pattern:RegExp("@[\\w-](?:"+/[^;{\s"']|\s+(?!\s)/.source+"|"+it.source+")*?"+/(?:;|(?=\s*\{))/.source),inside:{rule:/^@[\w-]+/,"selector-function-argument":{pattern:/(\bselector\s*\(\s*(?![\s)]))(?:[^()\s]|\s+(?![\s)])|\((?:[^()]|\([^()]*\))*\))+(?=\s*\))/,lookbehind:!0,alias:"selector"},keyword:{pattern:/(^|[^\w-])(?:and|not|only|or)(?![\w-])/,lookbehind:!0}}},url:{pattern:RegExp("\\burl\\((?:"+it.source+"|"+/(?:[^\\\r\n()"']|\\[\s\S])*/.source+")\\)","i"),greedy:!0,inside:{function:/^url/i,punctuation:/^\(|\)$/,string:{pattern:RegExp("^"+it.source+"$"),alias:"url"}}},selector:{pattern:RegExp(`(^|[{}\\s])[^{}\\s](?:[^{};"'\\s]|\\s+(?![\\s{])|`+it.source+")*(?=\\s*\\{)"),lookbehind:!0},string:{pattern:it,greedy:!0},property:{pattern:/(^|[^-\w\xA0-\uFFFF])(?!\s)[-_a-z\xA0-\uFFFF](?:(?!\s)[-\w\xA0-\uFFFF])*(?=\s*:)/i,lookbehind:!0},important:/!important\b/i,function:{pattern:/(^|[^-a-z0-9])[-a-z0-9]+(?=\()/i,lookbehind:!0},punctuation:/[(){};:,]/},rt.languages.css.atrule.inside.rest=rt.languages.css,rt.languages.markup);it&&(it.tag.addInlined("style","css"),it.tag.addAttribute("style","css"))})(Prism$1),(function(rt){var it=/("|')(?:\\(?:\r\n|[\s\S])|(?!\1)[^\\\r\n])*\1/,it=(rt.languages.css.selector={pattern:rt.languages.css.selector.pattern,lookbehind:!0,inside:it={"pseudo-element":/:(?:after|before|first-letter|first-line|selection)|::[-\w]+/,"pseudo-class":/:[-\w]+/,class:/\.[-\w]+/,id:/#[-\w]+/,attribute:{pattern:RegExp(`\\[(?:[^[\\]"']|`+it.source+")*\\]"),greedy:!0,inside:{punctuation:/^\[|\]$/,"case-sensitivity":{pattern:/(\s)[si]$/i,lookbehind:!0,alias:"keyword"},namespace:{pattern:/^(\s*)(?:(?!\s)[-*\w\xA0-\uFFFF])*\|(?!=)/,lookbehind:!0,inside:{punctuation:/\|$/}},"attr-name":{pattern:/^(\s*)(?:(?!\s)[-\w\xA0-\uFFFF])+/,lookbehind:!0},"attr-value":[it,{pattern:/(=\s*)(?:(?!\s)[-\w\xA0-\uFFFF])+(?=\s*$)/,lookbehind:!0}],operator:/[|~*^$]?=/}},"n-th":[{pattern:/(\(\s*)[+-]?\d*[\dn](?:\s*[+-]\s*\d+)?(?=\s*\))/,lookbehind:!0,inside:{number:/[\dn]+/,operator:/[+-]/}},{pattern:/(\(\s*)(?:even|odd)(?=\s*\))/i,lookbehind:!0}],combinator:/>|\+|~|\|\|/,punctuation:/[(),]/}},rt.languages.css.atrule.inside["selector-function-argument"].inside=it,rt.languages.insertBefore("css","property",{variable:{pattern:/(^|[^-\w\xA0-\uFFFF])--(?!\s)[-_a-z\xA0-\uFFFF](?:(?!\s)[-\w\xA0-\uFFFF])*/i,lookbehind:!0}}),{pattern:/(\b\d+)(?:%|[a-z]+(?![\w-]))/,lookbehind:!0}),ct={pattern:/(^|[^\w.-])-?(?:\d+(?:\.\d+)?|\.\d+)/,lookbehind:!0};rt.languages.insertBefore("css","function",{operator:{pattern:/(\s)[+\-*\/](?=\s)/,lookbehind:!0},hexcode:{pattern:/\B#[\da-f]{3,8}\b/i,alias:"color"},color:[{pattern:/(^|[^\w-])(?:AliceBlue|AntiqueWhite|Aqua|Aquamarine|Azure|Beige|Bisque|Black|BlanchedAlmond|Blue|BlueViolet|Brown|BurlyWood|CadetBlue|Chartreuse|Chocolate|Coral|CornflowerBlue|Cornsilk|Crimson|Cyan|DarkBlue|DarkCyan|DarkGoldenRod|DarkGr[ae]y|DarkGreen|DarkKhaki|DarkMagenta|DarkOliveGreen|DarkOrange|DarkOrchid|DarkRed|DarkSalmon|DarkSeaGreen|DarkSlateBlue|DarkSlateGr[ae]y|DarkTurquoise|DarkViolet|DeepPink|DeepSkyBlue|DimGr[ae]y|DodgerBlue|FireBrick|FloralWhite|ForestGreen|Fuchsia|Gainsboro|GhostWhite|Gold|GoldenRod|Gr[ae]y|Green|GreenYellow|HoneyDew|HotPink|IndianRed|Indigo|Ivory|Khaki|Lavender|LavenderBlush|LawnGreen|LemonChiffon|LightBlue|LightCoral|LightCyan|LightGoldenRodYellow|LightGr[ae]y|LightGreen|LightPink|LightSalmon|LightSeaGreen|LightSkyBlue|LightSlateGr[ae]y|LightSteelBlue|LightYellow|Lime|LimeGreen|Linen|Magenta|Maroon|MediumAquaMarine|MediumBlue|MediumOrchid|MediumPurple|MediumSeaGreen|MediumSlateBlue|MediumSpringGreen|MediumTurquoise|MediumVioletRed|MidnightBlue|MintCream|MistyRose|Moccasin|NavajoWhite|Navy|OldLace|Olive|OliveDrab|Orange|OrangeRed|Orchid|PaleGoldenRod|PaleGreen|PaleTurquoise|PaleVioletRed|PapayaWhip|PeachPuff|Peru|Pink|Plum|PowderBlue|Purple|RebeccaPurple|Red|RosyBrown|RoyalBlue|SaddleBrown|Salmon|SandyBrown|SeaGreen|SeaShell|Sienna|Silver|SkyBlue|SlateBlue|SlateGr[ae]y|Snow|SpringGreen|SteelBlue|Tan|Teal|Thistle|Tomato|Transparent|Turquoise|Violet|Wheat|White|WhiteSmoke|Yellow|YellowGreen)(?![\w-])/i,lookbehind:!0},{pattern:/\b(?:hsl|rgb)\(\s*\d{1,3}\s*,\s*\d{1,3}%?\s*,\s*\d{1,3}%?\s*\)\B|\b(?:hsl|rgb)a\(\s*\d{1,3}\s*,\s*\d{1,3}%?\s*,\s*\d{1,3}%?\s*,\s*(?:0|0?\.\d+|1)\s*\)\B/i,inside:{unit:it,number:ct,function:/[\w-]+(?=\()/,punctuation:/[(),]/}}],entity:/\\[\da-f]{1,8}/i,unit:it,number:ct})})(Prism$1),(function(rt){var it=/[*&][^\s[\]{},]+/,ct=/!(?:<[\w\-%#;/?:@&=+$,.!~*'()[\]]+>|(?:[a-zA-Z\d-]*!)?[\w\-%#;/?:@&=+$.~*'()]+)?/,dt="(?:"+ct.source+"(?:[ 	]+"+it.source+")?|"+it.source+"(?:[ 	]+"+ct.source+")?)",ut=/(?:[^\s\x00-\x08\x0e-\x1f!"#%&'*,\-:>?@[\]`{|}\x7f-\x84\x86-\x9f\ud800-\udfff\ufffe\uffff]|[?:-]<PLAIN>)(?:[ \t]*(?:(?![#:])<PLAIN>|:<PLAIN>))*/.source.replace(/<PLAIN>/g,function(){return/[^\s\x00-\x08\x0e-\x1f,[\]{}\x7f-\x84\x86-\x9f\ud800-\udfff\ufffe\uffff]/.source}),pt=/"(?:[^"\\\r\n]|\\.)*"|'(?:[^'\\\r\n]|\\.)*'/.source;function yt(ft,mt){mt=(mt||"").replace(/m/g,"")+"m";var kt=/([:\-,[{]\s*(?:\s<<prop>>[ \t]+)?)(?:<<value>>)(?=[ \t]*(?:$|,|\]|\}|(?:[\r\n]\s*)?#))/.source.replace(/<<prop>>/g,function(){return dt}).replace(/<<value>>/g,function(){return ft});return RegExp(kt,mt)}rt.languages.yaml={scalar:{pattern:RegExp(/([\-:]\s*(?:\s<<prop>>[ \t]+)?[|>])[ \t]*(?:((?:\r?\n|\r)[ \t]+)\S[^\r\n]*(?:\2[^\r\n]+)*)/.source.replace(/<<prop>>/g,function(){return dt})),lookbehind:!0,alias:"string"},comment:/#.*/,key:{pattern:RegExp(/((?:^|[:\-,[{\r\n?])[ \t]*(?:<<prop>>[ \t]+)?)<<key>>(?=\s*:\s)/.source.replace(/<<prop>>/g,function(){return dt}).replace(/<<key>>/g,function(){return"(?:"+ut+"|"+pt+")"})),lookbehind:!0,greedy:!0,alias:"atrule"},directive:{pattern:/(^[ \t]*)%.+/m,lookbehind:!0,alias:"important"},datetime:{pattern:yt(/\d{4}-\d\d?-\d\d?(?:[tT]|[ \t]+)\d\d?:\d{2}:\d{2}(?:\.\d*)?(?:[ \t]*(?:Z|[-+]\d\d?(?::\d{2})?))?|\d{4}-\d{2}-\d{2}|\d\d?:\d{2}(?::\d{2}(?:\.\d*)?)?/.source),lookbehind:!0,alias:"number"},boolean:{pattern:yt(/false|true/.source,"i"),lookbehind:!0,alias:"important"},null:{pattern:yt(/null|~/.source,"i"),lookbehind:!0,alias:"important"},string:{pattern:yt(pt),lookbehind:!0,greedy:!0},number:{pattern:yt(/[+-]?(?:0x[\da-f]+|0o[0-7]+|(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?|\.inf|\.nan)/.source,"i"),lookbehind:!0},tag:ct,important:it,punctuation:/---|[:[\]{}\-,|>?]|\.\.\./},rt.languages.yml=rt.languages.yaml})(Prism$1),(function(rt){var it=/(?:\\.|[^\\\n\r]|(?:\n|\r\n?)(?![\r\n]))/.source;function ct(kt){return kt=kt.replace(/<inner>/g,function(){return it}),RegExp(/((?:^|[^\\])(?:\\{2})*)/.source+"(?:"+kt+")")}var dt=/(?:\\.|``(?:[^`\r\n]|`(?!`))+``|`[^`\r\n]+`|[^\\|\r\n`])+/.source,ut=/\|?__(?:\|__)+\|?(?:(?:\n|\r\n?)|(?![\s\S]))/.source.replace(/__/g,function(){return dt}),pt=/\|?[ \t]*:?-{3,}:?[ \t]*(?:\|[ \t]*:?-{3,}:?[ \t]*)+\|?(?:\n|\r\n?)/.source,yt=(rt.languages.markdown=rt.languages.extend("markup",{}),rt.languages.insertBefore("markdown","prolog",{"front-matter-block":{pattern:/(^(?:\s*[\r\n])?)---(?!.)[\s\S]*?[\r\n]---(?!.)/,lookbehind:!0,greedy:!0,inside:{punctuation:/^---|---$/,"front-matter":{pattern:/\S+(?:\s+\S+)*/,alias:["yaml","language-yaml"],inside:rt.languages.yaml}}},blockquote:{pattern:/^>(?:[\t ]*>)*/m,alias:"punctuation"},table:{pattern:RegExp("^"+ut+pt+"(?:"+ut+")*","m"),inside:{"table-data-rows":{pattern:RegExp("^("+ut+pt+")(?:"+ut+")*$"),lookbehind:!0,inside:{"table-data":{pattern:RegExp(dt),inside:rt.languages.markdown},punctuation:/\|/}},"table-line":{pattern:RegExp("^("+ut+")"+pt+"$"),lookbehind:!0,inside:{punctuation:/\||:?-{3,}:?/}},"table-header-row":{pattern:RegExp("^"+ut+"$"),inside:{"table-header":{pattern:RegExp(dt),alias:"important",inside:rt.languages.markdown},punctuation:/\|/}}}},code:[{pattern:/((?:^|\n)[ \t]*\n|(?:^|\r\n?)[ \t]*\r\n?)(?: {4}|\t).+(?:(?:\n|\r\n?)(?: {4}|\t).+)*/,lookbehind:!0,alias:"keyword"},{pattern:/^```[\s\S]*?^```$/m,greedy:!0,inside:{"code-block":{pattern:/^(```.*(?:\n|\r\n?))[\s\S]+?(?=(?:\n|\r\n?)^```$)/m,lookbehind:!0},"code-language":{pattern:/^(```).+/,lookbehind:!0},punctuation:/```/}}],title:[{pattern:/\S.*(?:\n|\r\n?)(?:==+|--+)(?=[ \t]*$)/m,alias:"important",inside:{punctuation:/==+$|--+$/}},{pattern:/(^\s*)#.+/m,lookbehind:!0,alias:"important",inside:{punctuation:/^#+|#+$/}}],hr:{pattern:/(^\s*)([*-])(?:[\t ]*\2){2,}(?=\s*$)/m,lookbehind:!0,alias:"punctuation"},list:{pattern:/(^\s*)(?:[*+-]|\d+\.)(?=[\t ].)/m,lookbehind:!0,alias:"punctuation"},"url-reference":{pattern:/!?\[[^\]]+\]:[\t ]+(?:\S+|<(?:\\.|[^>\\])+>)(?:[\t ]+(?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|\((?:\\.|[^)\\])*\)))?/,inside:{variable:{pattern:/^(!?\[)[^\]]+/,lookbehind:!0},string:/(?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|\((?:\\.|[^)\\])*\))$/,punctuation:/^[\[\]!:]|[<>]/},alias:"url"},bold:{pattern:ct(/\b__(?:(?!_)<inner>|_(?:(?!_)<inner>)+_)+__\b|\*\*(?:(?!\*)<inner>|\*(?:(?!\*)<inner>)+\*)+\*\*/.source),lookbehind:!0,greedy:!0,inside:{content:{pattern:/(^..)[\s\S]+(?=..$)/,lookbehind:!0,inside:{}},punctuation:/\*\*|__/}},italic:{pattern:ct(/\b_(?:(?!_)<inner>|__(?:(?!_)<inner>)+__)+_\b|\*(?:(?!\*)<inner>|\*\*(?:(?!\*)<inner>)+\*\*)+\*/.source),lookbehind:!0,greedy:!0,inside:{content:{pattern:/(^.)[\s\S]+(?=.$)/,lookbehind:!0,inside:{}},punctuation:/[*_]/}},strike:{pattern:ct(/(~~?)(?:(?!~)<inner>)+\2/.source),lookbehind:!0,greedy:!0,inside:{content:{pattern:/(^~~?)[\s\S]+(?=\1$)/,lookbehind:!0,inside:{}},punctuation:/~~?/}},"code-snippet":{pattern:/(^|[^\\`])(?:``[^`\r\n]+(?:`[^`\r\n]+)*``(?!`)|`[^`\r\n]+`(?!`))/,lookbehind:!0,greedy:!0,alias:["code","keyword"]},url:{pattern:ct(/!?\[(?:(?!\])<inner>)+\](?:\([^\s)]+(?:[\t ]+"(?:\\.|[^"\\])*")?\)|[ \t]?\[(?:(?!\])<inner>)+\])/.source),lookbehind:!0,greedy:!0,inside:{operator:/^!/,content:{pattern:/(^\[)[^\]]+(?=\])/,lookbehind:!0,inside:{}},variable:{pattern:/(^\][ \t]?\[)[^\]]+(?=\]$)/,lookbehind:!0},url:{pattern:/(^\]\()[^\s)]+/,lookbehind:!0},string:{pattern:/(^[ \t]+)"(?:\\.|[^"\\])*"(?=\)$)/,lookbehind:!0}}}}),["url","bold","italic","strike"].forEach(function(kt){["url","bold","italic","strike","code-snippet"].forEach(function(_t){kt!==_t&&(rt.languages.markdown[kt].inside.content.inside[_t]=rt.languages.markdown[_t])})}),rt.hooks.add("after-tokenize",function(kt){kt.language!=="markdown"&&kt.language!=="md"||(function _t(vt){if(vt&&typeof vt!="string")for(var bt=0,Mt=vt.length;bt<Mt;bt++){var wt,St=vt[bt];St.type!=="code"?_t(St.content):(wt=St.content[1],St=St.content[3],wt&&St&&wt.type==="code-language"&&St.type==="code-block"&&typeof wt.content=="string"&&(wt=wt.content.replace(/\b#/g,"sharp").replace(/\b\+\+/g,"pp"),wt="language-"+(wt=(/[a-z][\w-]*/i.exec(wt)||[""])[0].toLowerCase()),St.alias?typeof St.alias=="string"?St.alias=[St.alias,wt]:St.alias.push(wt):St.alias=[wt]))}})(kt.tokens)}),rt.hooks.add("wrap",function(kt){if(kt.type==="code-block"){for(var _t="",vt=0,bt=kt.classes.length;vt<bt;vt++){var Mt=kt.classes[vt],Mt=/language-(.+)/.exec(Mt);if(Mt){_t=Mt[1];break}}var wt,St=rt.languages[_t];St?kt.content=rt.highlight((function(It){return It=It.replace(yt,""),It=It.replace(/&(\w{1,8}|#x?[\da-f]{1,8});/gi,function(Nt,$t){var Et;return($t=$t.toLowerCase())[0]==="#"?(Et=$t[1]==="x"?parseInt($t.slice(2),16):Number($t.slice(1)),mt(Et)):ft[$t]||Nt})})(kt.content),St,_t):_t&&_t!=="none"&&rt.plugins.autoloader&&(wt="md-"+new Date().valueOf()+"-"+Math.floor(1e16*Math.random()),kt.attributes.id=wt,rt.plugins.autoloader.loadLanguages(_t,function(){var It=document.getElementById(wt);It&&(It.innerHTML=rt.highlight(It.textContent,rt.languages[_t],_t))}))}}),RegExp(rt.languages.markup.tag.pattern.source,"gi")),ft={amp:"&",lt:"<",gt:">",quot:'"'},mt=String.fromCodePoint||String.fromCharCode;rt.languages.md=rt.languages.markdown})(Prism$1),Prism$1.languages.graphql={comment:/#.*/,description:{pattern:/(?:"""(?:[^"]|(?!""")")*"""|"(?:\\.|[^\\"\r\n])*")(?=\s*[a-z_])/i,greedy:!0,alias:"string",inside:{"language-markdown":{pattern:/(^"(?:"")?)(?!\1)[\s\S]+(?=\1$)/,lookbehind:!0,inside:Prism$1.languages.markdown}}},string:{pattern:/"""(?:[^"]|(?!""")")*"""|"(?:\\.|[^\\"\r\n])*"/,greedy:!0},number:/(?:\B-|\b)\d+(?:\.\d+)?(?:e[+-]?\d+)?\b/i,boolean:/\b(?:false|true)\b/,variable:/\$[a-z_]\w*/i,directive:{pattern:/@[a-z_]\w*/i,alias:"function"},"attr-name":{pattern:/\b[a-z_]\w*(?=\s*(?:\((?:[^()"]|"(?:\\.|[^\\"\r\n])*")*\))?:)/i,greedy:!0},"atom-input":{pattern:/\b[A-Z]\w*Input\b/,alias:"class-name"},scalar:/\b(?:Boolean|Float|ID|Int|String)\b/,constant:/\b[A-Z][A-Z_\d]*\b/,"class-name":{pattern:/(\b(?:enum|implements|interface|on|scalar|type|union)\s+|&\s*|:\s*|\[)[A-Z_]\w*/,lookbehind:!0},fragment:{pattern:/(\bfragment\s+|\.{3}\s*(?!on\b))[a-zA-Z_]\w*/,lookbehind:!0,alias:"function"},"definition-mutation":{pattern:/(\bmutation\s+)[a-zA-Z_]\w*/,lookbehind:!0,alias:"function"},"definition-query":{pattern:/(\bquery\s+)[a-zA-Z_]\w*/,lookbehind:!0,alias:"function"},keyword:/\b(?:directive|enum|extend|fragment|implements|input|interface|mutation|on|query|repeatable|scalar|schema|subscription|type|union)\b/,operator:/[!=|&]|\.{3}/,"property-query":/\w+(?=\s*\()/,object:/\w+(?=\s*\{)/,punctuation:/[!(){}\[\]:=,]/,property:/\w+/},Prism$1.hooks.add("after-tokenize",function(rt){if(rt.language==="graphql")for(var it=rt.tokens.filter(function(wt){return typeof wt!="string"&&wt.type!=="comment"&&wt.type!=="scalar"}),ct=0;ct<it.length;){var dt=it[ct++];if(dt.type==="keyword"&&dt.content==="mutation"){var ut=[];if(vt(["definition-mutation","punctuation"])&&_t(1).content==="("){ct+=2;var pt=bt(/^\($/,/^\)$/);if(pt===-1)continue;for(;ct<pt;ct++){var yt=_t(0);yt.type==="variable"&&(Mt(yt,"variable-input"),ut.push(yt.content))}ct=pt+1}if(vt(["punctuation","property-query"])&&_t(0).content==="{"&&(ct++,Mt(_t(0),"property-mutation"),0<ut.length)){var ft=bt(/^\{$/,/^\}$/);if(ft!==-1)for(var mt=ct;mt<ft;mt++){var kt=it[mt];kt.type==="variable"&&0<=ut.indexOf(kt.content)&&Mt(kt,"variable-input")}}}}function _t(wt){return it[ct+wt]}function vt(wt,St){St=St||0;for(var It=0;It<wt.length;It++){var Nt=_t(It+St);if(!Nt||Nt.type!==wt[It])return}return 1}function bt(wt,St){for(var It=1,Nt=ct;Nt<it.length;Nt++){var $t=it[Nt],Et=$t.content;if($t.type==="punctuation"&&typeof Et=="string"){if(wt.test(Et))It++;else if(St.test(Et)&&--It===0)return Nt}}return-1}function Mt(wt,St){var It=wt.alias;It?Array.isArray(It)||(wt.alias=It=[It]):wt.alias=It=[],It.push(St)}}),Prism$1.languages.sql={comment:{pattern:/(^|[^\\])(?:\/\*[\s\S]*?\*\/|(?:--|\/\/|#).*)/,lookbehind:!0},variable:[{pattern:/@(["'`])(?:\\[\s\S]|(?!\1)[^\\])+\1/,greedy:!0},/@[\w.$]+/],string:{pattern:/(^|[^@\\])("|')(?:\\[\s\S]|(?!\2)[^\\]|\2\2)*\2/,greedy:!0,lookbehind:!0},identifier:{pattern:/(^|[^@\\])`(?:\\[\s\S]|[^`\\]|``)*`/,greedy:!0,lookbehind:!0,inside:{punctuation:/^`|`$/}},function:/\b(?:AVG|COUNT|FIRST|FORMAT|LAST|LCASE|LEN|MAX|MID|MIN|MOD|NOW|ROUND|SUM|UCASE)(?=\s*\()/i,keyword:/\b(?:ACTION|ADD|AFTER|ALGORITHM|ALL|ALTER|ANALYZE|ANY|APPLY|AS|ASC|AUTHORIZATION|AUTO_INCREMENT|BACKUP|BDB|BEGIN|BERKELEYDB|BIGINT|BINARY|BIT|BLOB|BOOL|BOOLEAN|BREAK|BROWSE|BTREE|BULK|BY|CALL|CASCADED?|CASE|CHAIN|CHAR(?:ACTER|SET)?|CHECK(?:POINT)?|CLOSE|CLUSTERED|COALESCE|COLLATE|COLUMNS?|COMMENT|COMMIT(?:TED)?|COMPUTE|CONNECT|CONSISTENT|CONSTRAINT|CONTAINS(?:TABLE)?|CONTINUE|CONVERT|CREATE|CROSS|CURRENT(?:_DATE|_TIME|_TIMESTAMP|_USER)?|CURSOR|CYCLE|DATA(?:BASES?)?|DATE(?:TIME)?|DAY|DBCC|DEALLOCATE|DEC|DECIMAL|DECLARE|DEFAULT|DEFINER|DELAYED|DELETE|DELIMITERS?|DENY|DESC|DESCRIBE|DETERMINISTIC|DISABLE|DISCARD|DISK|DISTINCT|DISTINCTROW|DISTRIBUTED|DO|DOUBLE|DROP|DUMMY|DUMP(?:FILE)?|DUPLICATE|ELSE(?:IF)?|ENABLE|ENCLOSED|END|ENGINE|ENUM|ERRLVL|ERRORS|ESCAPED?|EXCEPT|EXEC(?:UTE)?|EXISTS|EXIT|EXPLAIN|EXTENDED|FETCH|FIELDS|FILE|FILLFACTOR|FIRST|FIXED|FLOAT|FOLLOWING|FOR(?: EACH ROW)?|FORCE|FOREIGN|FREETEXT(?:TABLE)?|FROM|FULL|FUNCTION|GEOMETRY(?:COLLECTION)?|GLOBAL|GOTO|GRANT|GROUP|HANDLER|HASH|HAVING|HOLDLOCK|HOUR|IDENTITY(?:COL|_INSERT)?|IF|IGNORE|IMPORT|INDEX|INFILE|INNER|INNODB|INOUT|INSERT|INT|INTEGER|INTERSECT|INTERVAL|INTO|INVOKER|ISOLATION|ITERATE|JOIN|KEYS?|KILL|LANGUAGE|LAST|LEAVE|LEFT|LEVEL|LIMIT|LINENO|LINES|LINESTRING|LOAD|LOCAL|LOCK|LONG(?:BLOB|TEXT)|LOOP|MATCH(?:ED)?|MEDIUM(?:BLOB|INT|TEXT)|MERGE|MIDDLEINT|MINUTE|MODE|MODIFIES|MODIFY|MONTH|MULTI(?:LINESTRING|POINT|POLYGON)|NATIONAL|NATURAL|NCHAR|NEXT|NO|NONCLUSTERED|NULLIF|NUMERIC|OFF?|OFFSETS?|ON|OPEN(?:DATASOURCE|QUERY|ROWSET)?|OPTIMIZE|OPTION(?:ALLY)?|ORDER|OUT(?:ER|FILE)?|OVER|PARTIAL|PARTITION|PERCENT|PIVOT|PLAN|POINT|POLYGON|PRECEDING|PRECISION|PREPARE|PREV|PRIMARY|PRINT|PRIVILEGES|PROC(?:EDURE)?|PUBLIC|PURGE|QUICK|RAISERROR|READS?|REAL|RECONFIGURE|REFERENCES|RELEASE|RENAME|REPEAT(?:ABLE)?|REPLACE|REPLICATION|REQUIRE|RESIGNAL|RESTORE|RESTRICT|RETURN(?:ING|S)?|REVOKE|RIGHT|ROLLBACK|ROUTINE|ROW(?:COUNT|GUIDCOL|S)?|RTREE|RULE|SAVE(?:POINT)?|SCHEMA|SECOND|SELECT|SERIAL(?:IZABLE)?|SESSION(?:_USER)?|SET(?:USER)?|SHARE|SHOW|SHUTDOWN|SIMPLE|SMALLINT|SNAPSHOT|SOME|SONAME|SQL|START(?:ING)?|STATISTICS|STATUS|STRIPED|SYSTEM_USER|TABLES?|TABLESPACE|TEMP(?:ORARY|TABLE)?|TERMINATED|TEXT(?:SIZE)?|THEN|TIME(?:STAMP)?|TINY(?:BLOB|INT|TEXT)|TOP?|TRAN(?:SACTIONS?)?|TRIGGER|TRUNCATE|TSEQUAL|TYPES?|UNBOUNDED|UNCOMMITTED|UNDEFINED|UNION|UNIQUE|UNLOCK|UNPIVOT|UNSIGNED|UPDATE(?:TEXT)?|USAGE|USE|USER|USING|VALUES?|VAR(?:BINARY|CHAR|CHARACTER|YING)|VIEW|WAITFOR|WARNINGS|WHEN|WHERE|WHILE|WITH(?: ROLLUP|IN)?|WORK|WRITE(?:TEXT)?|YEAR)\b/i,boolean:/\b(?:FALSE|NULL|TRUE)\b/i,number:/\b0x[\da-f]+\b|\b\d+(?:\.\d*)?|\B\.\d+\b/i,operator:/[-+*\/=%^~]|&&?|\|\|?|!=?|<(?:=>?|<|>)?|>[>=]?|\b(?:AND|BETWEEN|DIV|ILIKE|IN|IS|LIKE|NOT|OR|REGEXP|RLIKE|SOUNDS LIKE|XOR)\b/i,punctuation:/[;[\]()`,.]/},(function(rt){var it=rt.languages.javascript["template-string"],ct=it.pattern.source,dt=it.inside.interpolation,ut=dt.inside["interpolation-punctuation"],pt=dt.pattern.source;function yt(vt,bt){if(rt.languages[vt])return{pattern:RegExp("((?:"+bt+")\\s*)"+ct),lookbehind:!0,greedy:!0,inside:{"template-punctuation":{pattern:/^`|`$/,alias:"string"},"embedded-code":{pattern:/[\s\S]+/,alias:vt}}}}function ft(vt,bt,Mt){return vt={code:vt,grammar:bt,language:Mt},rt.hooks.run("before-tokenize",vt),vt.tokens=rt.tokenize(vt.code,vt.grammar),rt.hooks.run("after-tokenize",vt),vt.tokens}function mt(vt,bt,Mt){var It=rt.tokenize(vt,{interpolation:{pattern:RegExp(pt),lookbehind:!0}}),wt=0,St={},It=ft(It.map(function($t){if(typeof $t=="string")return $t;for(var Et,Ft,$t=$t.content;vt.indexOf((Ft=wt++,Et="___"+Mt.toUpperCase()+"_"+Ft+"___"))!==-1;);return St[Et]=$t,Et}).join(""),bt,Mt),Nt=Object.keys(St);return wt=0,(function $t(Et){for(var Ft=0;Ft<Et.length;Ft++){if(wt>=Nt.length)return;var qt,Ht,Ot,Zt,Yt,aa,Qt,oa=Et[Ft];typeof oa=="string"||typeof oa.content=="string"?(qt=Nt[wt],(Qt=(aa=typeof oa=="string"?oa:oa.content).indexOf(qt))!==-1&&(++wt,Ht=aa.substring(0,Qt),Yt=St[qt],Ot=void 0,(Zt={})["interpolation-punctuation"]=ut,(Zt=rt.tokenize(Yt,Zt)).length===3&&((Ot=[1,1]).push.apply(Ot,ft(Zt[1],rt.languages.javascript,"javascript")),Zt.splice.apply(Zt,Ot)),Ot=new rt.Token("interpolation",Zt,dt.alias,Yt),Zt=aa.substring(Qt+qt.length),Yt=[],Ht&&Yt.push(Ht),Yt.push(Ot),Zt&&($t(aa=[Zt]),Yt.push.apply(Yt,aa)),typeof oa=="string"?(Et.splice.apply(Et,[Ft,1].concat(Yt)),Ft+=Yt.length-1):oa.content=Yt)):(Qt=oa.content,Array.isArray(Qt)?$t(Qt):$t([Qt]))}})(It),new rt.Token(Mt,It,"language-"+Mt,vt)}rt.languages.javascript["template-string"]=[yt("css",/\b(?:styled(?:\([^)]*\))?(?:\s*\.\s*\w+(?:\([^)]*\))*)*|css(?:\s*\.\s*(?:global|resolve))?|createGlobalStyle|keyframes)/.source),yt("html",/\bhtml|\.\s*(?:inner|outer)HTML\s*\+?=/.source),yt("svg",/\bsvg/.source),yt("markdown",/\b(?:markdown|md)/.source),yt("graphql",/\b(?:gql|graphql(?:\s*\.\s*experimental)?)/.source),yt("sql",/\bsql/.source),it].filter(Boolean);var kt={javascript:!0,js:!0,typescript:!0,ts:!0,jsx:!0,tsx:!0};function _t(vt){return typeof vt=="string"?vt:Array.isArray(vt)?vt.map(_t).join(""):_t(vt.content)}rt.hooks.add("after-tokenize",function(vt){vt.language in kt&&(function bt(Mt){for(var wt=0,St=Mt.length;wt<St;wt++){var It,Nt,$t,Et=Mt[wt];typeof Et!="string"&&(It=Et.content,Array.isArray(It)?Et.type==="template-string"?(Et=It[1],It.length===3&&typeof Et!="string"&&Et.type==="embedded-code"&&(Nt=_t(Et),Et=Et.alias,Et=Array.isArray(Et)?Et[0]:Et,$t=rt.languages[Et])&&(It[1]=mt(Nt,$t,Et))):bt(It):typeof It!="string"&&bt([It]))}})(vt.tokens)})})(Prism$1),(function(rt){rt.languages.typescript=rt.languages.extend("javascript",{"class-name":{pattern:/(\b(?:class|extends|implements|instanceof|interface|new|type)\s+)(?!keyof\b)(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?:\s*<(?:[^<>]|<(?:[^<>]|<[^<>]*>)*>)*>)?/,lookbehind:!0,greedy:!0,inside:null},builtin:/\b(?:Array|Function|Promise|any|boolean|console|never|number|string|symbol|unknown)\b/}),rt.languages.typescript.keyword.push(/\b(?:abstract|declare|is|keyof|readonly|require)\b/,/\b(?:asserts|infer|interface|module|namespace|type)\b(?=\s*(?:[{_$a-zA-Z\xA0-\uFFFF]|$))/,/\btype\b(?=\s*(?:[\{*]|$))/),delete rt.languages.typescript.parameter,delete rt.languages.typescript["literal-property"];var it=rt.languages.extend("typescript",{});delete it["class-name"],rt.languages.typescript["class-name"].inside=it,rt.languages.insertBefore("typescript","function",{decorator:{pattern:/@[$\w\xA0-\uFFFF]+/,inside:{at:{pattern:/^@/,alias:"operator"},function:/^[\s\S]+/}},"generic-function":{pattern:/#?(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*\s*<(?:[^<>]|<(?:[^<>]|<[^<>]*>)*>)*>(?=\s*\()/,greedy:!0,inside:{function:/^#?(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*/,generic:{pattern:/<[\s\S]+/,alias:"class-name",inside:it}}}}),rt.languages.ts=rt.languages.typescript})(Prism$1),(function(rt){var it=rt.languages.javascript,ct=/\{(?:[^{}]|\{(?:[^{}]|\{[^{}]*\})*\})+\}/.source,dt="(@(?:arg|argument|param|property)\\s+(?:"+ct+"\\s+)?)";rt.languages.jsdoc=rt.languages.extend("javadoclike",{parameter:{pattern:RegExp(dt+/(?:(?!\s)[$\w\xA0-\uFFFF.])+(?=\s|$)/.source),lookbehind:!0,inside:{punctuation:/\./}}}),rt.languages.insertBefore("jsdoc","keyword",{"optional-parameter":{pattern:RegExp(dt+/\[(?:(?!\s)[$\w\xA0-\uFFFF.])+(?:=[^[\]]+)?\](?=\s|$)/.source),lookbehind:!0,inside:{parameter:{pattern:/(^\[)[$\w\xA0-\uFFFF\.]+/,lookbehind:!0,inside:{punctuation:/\./}},code:{pattern:/(=)[\s\S]*(?=\]$)/,lookbehind:!0,inside:it,alias:"language-javascript"},punctuation:/[=[\]]/}},"class-name":[{pattern:RegExp(/(@(?:augments|class|extends|interface|memberof!?|template|this|typedef)\s+(?:<TYPE>\s+)?)[A-Z]\w*(?:\.[A-Z]\w*)*/.source.replace(/<TYPE>/g,function(){return ct})),lookbehind:!0,inside:{punctuation:/\./}},{pattern:RegExp("(@[a-z]+\\s+)"+ct),lookbehind:!0,inside:{string:it.string,number:it.number,boolean:it.boolean,keyword:rt.languages.typescript.keyword,operator:/=>|\.\.\.|[&|?:*]/,punctuation:/[.,;=<>{}()[\]]/}}],example:{pattern:/(@example\s+(?!\s))(?:[^@\s]|\s+(?!\s))+?(?=\s*(?:\*\s*)?(?:@\w|\*\/))/,lookbehind:!0,inside:{code:{pattern:/^([\t ]*(?:\*\s*)?)\S.*$/m,lookbehind:!0,inside:it,alias:"language-javascript"}}}}),rt.languages.javadoclike.addSupport("javascript",rt.languages.jsdoc)})(Prism$1),(function(rt){rt.languages.flow=rt.languages.extend("javascript",{}),rt.languages.insertBefore("flow","keyword",{type:[{pattern:/\b(?:[Bb]oolean|Function|[Nn]umber|[Ss]tring|[Ss]ymbol|any|mixed|null|void)\b/,alias:"class-name"}]}),rt.languages.flow["function-variable"].pattern=/(?!\s)[_$a-z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?=\s*=\s*(?:function\b|(?:\([^()]*\)(?:\s*:\s*\w+)?|(?!\s)[_$a-z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*)\s*=>))/i,delete rt.languages.flow.parameter,rt.languages.insertBefore("flow","operator",{"flow-punctuation":{pattern:/\{\||\|\}/,alias:"punctuation"}}),Array.isArray(rt.languages.flow.keyword)||(rt.languages.flow.keyword=[rt.languages.flow.keyword]),rt.languages.flow.keyword.unshift({pattern:/(^|[^$]\b)(?:Class|declare|opaque|type)\b(?!\$)/,lookbehind:!0},{pattern:/(^|[^$]\B)\$(?:Diff|Enum|Exact|Keys|ObjMap|PropertyType|Record|Shape|Subtype|Supertype|await)\b(?!\$)/,lookbehind:!0})})(Prism$1),Prism$1.languages.n4js=Prism$1.languages.extend("javascript",{keyword:/\b(?:Array|any|boolean|break|case|catch|class|const|constructor|continue|debugger|declare|default|delete|do|else|enum|export|extends|false|finally|for|from|function|get|if|implements|import|in|instanceof|interface|let|module|new|null|number|package|private|protected|public|return|set|static|string|super|switch|this|throw|true|try|typeof|var|void|while|with|yield)\b/}),Prism$1.languages.insertBefore("n4js","constant",{annotation:{pattern:/@+\w+/,alias:"operator"}}),Prism$1.languages.n4jsd=Prism$1.languages.n4js,(function(rt){function it(yt,ft){return RegExp(yt.replace(/<ID>/g,function(){return/(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*/.source}),ft)}rt.languages.insertBefore("javascript","function-variable",{"method-variable":{pattern:RegExp("(\\.\\s*)"+rt.languages.javascript["function-variable"].pattern.source),lookbehind:!0,alias:["function-variable","method","function","property-access"]}}),rt.languages.insertBefore("javascript","function",{method:{pattern:RegExp("(\\.\\s*)"+rt.languages.javascript.function.source),lookbehind:!0,alias:["function","property-access"]}}),rt.languages.insertBefore("javascript","constant",{"known-class-name":[{pattern:/\b(?:(?:Float(?:32|64)|(?:Int|Uint)(?:8|16|32)|Uint8Clamped)?Array|ArrayBuffer|BigInt|Boolean|DataView|Date|Error|Function|Intl|JSON|(?:Weak)?(?:Map|Set)|Math|Number|Object|Promise|Proxy|Reflect|RegExp|String|Symbol|WebAssembly)\b/,alias:"class-name"},{pattern:/\b(?:[A-Z]\w*)Error\b/,alias:"class-name"}]}),rt.languages.insertBefore("javascript","keyword",{imports:{pattern:it(/(\bimport\b\s*)(?:<ID>(?:\s*,\s*(?:\*\s*as\s+<ID>|\{[^{}]*\}))?|\*\s*as\s+<ID>|\{[^{}]*\})(?=\s*\bfrom\b)/.source),lookbehind:!0,inside:rt.languages.javascript},exports:{pattern:it(/(\bexport\b\s*)(?:\*(?:\s*as\s+<ID>)?(?=\s*\bfrom\b)|\{[^{}]*\})/.source),lookbehind:!0,inside:rt.languages.javascript}}),rt.languages.javascript.keyword.unshift({pattern:/\b(?:as|default|export|from|import)\b/,alias:"module"},{pattern:/\b(?:await|break|catch|continue|do|else|finally|for|if|return|switch|throw|try|while|yield)\b/,alias:"control-flow"},{pattern:/\bnull\b/,alias:["null","nil"]},{pattern:/\bundefined\b/,alias:"nil"}),rt.languages.insertBefore("javascript","operator",{spread:{pattern:/\.{3}/,alias:"operator"},arrow:{pattern:/=>/,alias:"operator"}}),rt.languages.insertBefore("javascript","punctuation",{"property-access":{pattern:it(/(\.\s*)#?<ID>/.source),lookbehind:!0},"maybe-class-name":{pattern:/(^|[^$\w\xA0-\uFFFF])[A-Z][$\w\xA0-\uFFFF]+/,lookbehind:!0},dom:{pattern:/\b(?:document|(?:local|session)Storage|location|navigator|performance|window)\b/,alias:"variable"},console:{pattern:/\bconsole(?=\s*\.)/,alias:"class-name"}});for(var ct=["function","function-variable","method","method-variable","property-access"],dt=0;dt<ct.length;dt++){var pt=ct[dt],ut=rt.languages.javascript[pt],pt=(ut=rt.util.type(ut)==="RegExp"?rt.languages.javascript[pt]={pattern:ut}:ut).inside||{};(ut.inside=pt)["maybe-class-name"]=/^[A-Z][\s\S]*/}})(Prism$1),(function(rt){var it=rt.util.clone(rt.languages.javascript),ct=/(?:\s|\/\/.*(?!.)|\/\*(?:[^*]|\*(?!\/))\*\/)/.source,dt=/(?:\{(?:\{(?:\{[^{}]*\}|[^{}])*\}|[^{}])*\})/.source,ut=/(?:\{<S>*\.{3}(?:[^{}]|<BRACES>)*\})/.source;function pt(mt,kt){return mt=mt.replace(/<S>/g,function(){return ct}).replace(/<BRACES>/g,function(){return dt}).replace(/<SPREAD>/g,function(){return ut}),RegExp(mt,kt)}ut=pt(ut).source,rt.languages.jsx=rt.languages.extend("markup",it),rt.languages.jsx.tag.pattern=pt(/<\/?(?:[\w.:-]+(?:<S>+(?:[\w.:$-]+(?:=(?:"(?:\\[\s\S]|[^\\"])*"|'(?:\\[\s\S]|[^\\'])*'|[^\s{'"/>=]+|<BRACES>))?|<SPREAD>))*<S>*\/?)?>/.source),rt.languages.jsx.tag.inside.tag.pattern=/^<\/?[^\s>\/]*/,rt.languages.jsx.tag.inside["attr-value"].pattern=/=(?!\{)(?:"(?:\\[\s\S]|[^\\"])*"|'(?:\\[\s\S]|[^\\'])*'|[^\s'">]+)/,rt.languages.jsx.tag.inside.tag.inside["class-name"]=/^[A-Z]\w*(?:\.[A-Z]\w*)*$/,rt.languages.jsx.tag.inside.comment=it.comment,rt.languages.insertBefore("inside","attr-name",{spread:{pattern:pt(/<SPREAD>/.source),inside:rt.languages.jsx}},rt.languages.jsx.tag),rt.languages.insertBefore("inside","special-attr",{script:{pattern:pt(/=<BRACES>/.source),alias:"language-javascript",inside:{"script-punctuation":{pattern:/^=(?=\{)/,alias:"punctuation"},rest:rt.languages.jsx}}},rt.languages.jsx.tag);function yt(mt){for(var kt=[],_t=0;_t<mt.length;_t++){var vt=mt[_t],bt=!1;typeof vt!="string"&&(vt.type==="tag"&&vt.content[0]&&vt.content[0].type==="tag"?vt.content[0].content[0].content==="</"?0<kt.length&&kt[kt.length-1].tagName===ft(vt.content[0].content[1])&&kt.pop():vt.content[vt.content.length-1].content!=="/>"&&kt.push({tagName:ft(vt.content[0].content[1]),openedBraces:0}):0<kt.length&&vt.type==="punctuation"&&vt.content==="{"?kt[kt.length-1].openedBraces++:0<kt.length&&0<kt[kt.length-1].openedBraces&&vt.type==="punctuation"&&vt.content==="}"?kt[kt.length-1].openedBraces--:bt=!0),(bt||typeof vt=="string")&&0<kt.length&&kt[kt.length-1].openedBraces===0&&(bt=ft(vt),_t<mt.length-1&&(typeof mt[_t+1]=="string"||mt[_t+1].type==="plain-text")&&(bt+=ft(mt[_t+1]),mt.splice(_t+1,1)),0<_t&&(typeof mt[_t-1]=="string"||mt[_t-1].type==="plain-text")&&(bt=ft(mt[_t-1])+bt,mt.splice(_t-1,1),_t--),mt[_t]=new rt.Token("plain-text",bt,null,bt)),vt.content&&typeof vt.content!="string"&&yt(vt.content)}}var ft=function(mt){return mt?typeof mt=="string"?mt:typeof mt.content=="string"?mt.content:mt.content.map(ft).join(""):""};rt.hooks.add("after-tokenize",function(mt){mt.language!=="jsx"&&mt.language!=="tsx"||yt(mt.tokens)})})(Prism$1),(function(rt){var it=rt.util.clone(rt.languages.typescript),it=(rt.languages.tsx=rt.languages.extend("jsx",it),delete rt.languages.tsx.parameter,delete rt.languages.tsx["literal-property"],rt.languages.tsx.tag);it.pattern=RegExp(/(^|[^\w$]|(?=<\/))/.source+"(?:"+it.pattern.source+")",it.pattern.flags),it.lookbehind=!0})(Prism$1),Prism$1.languages.swift={comment:{pattern:/(^|[^\\:])(?:\/\/.*|\/\*(?:[^/*]|\/(?!\*)|\*(?!\/)|\/\*(?:[^*]|\*(?!\/))*\*\/)*\*\/)/,lookbehind:!0,greedy:!0},"string-literal":[{pattern:RegExp(/(^|[^"#])/.source+"(?:"+/"(?:\\(?:\((?:[^()]|\([^()]*\))*\)|\r\n|[^(])|[^\\\r\n"])*"/.source+"|"+/"""(?:\\(?:\((?:[^()]|\([^()]*\))*\)|[^(])|[^\\"]|"(?!""))*"""/.source+")"+/(?!["#])/.source),lookbehind:!0,greedy:!0,inside:{interpolation:{pattern:/(\\\()(?:[^()]|\([^()]*\))*(?=\))/,lookbehind:!0,inside:null},"interpolation-punctuation":{pattern:/^\)|\\\($/,alias:"punctuation"},punctuation:/\\(?=[\r\n])/,string:/[\s\S]+/}},{pattern:RegExp(/(^|[^"#])(#+)/.source+"(?:"+/"(?:\\(?:#+\((?:[^()]|\([^()]*\))*\)|\r\n|[^#])|[^\\\r\n])*?"/.source+"|"+/"""(?:\\(?:#+\((?:[^()]|\([^()]*\))*\)|[^#])|[^\\])*?"""/.source+")\\2"),lookbehind:!0,greedy:!0,inside:{interpolation:{pattern:/(\\#+\()(?:[^()]|\([^()]*\))*(?=\))/,lookbehind:!0,inside:null},"interpolation-punctuation":{pattern:/^\)|\\#+\($/,alias:"punctuation"},string:/[\s\S]+/}}],directive:{pattern:RegExp(/#/.source+"(?:"+/(?:elseif|if)\b/.source+"(?:[ 	]*"+/(?:![ \t]*)?(?:\b\w+\b(?:[ \t]*\((?:[^()]|\([^()]*\))*\))?|\((?:[^()]|\([^()]*\))*\))(?:[ \t]*(?:&&|\|\|))?/.source+")+|"+/(?:else|endif)\b/.source+")"),alias:"property",inside:{"directive-name":/^#\w+/,boolean:/\b(?:false|true)\b/,number:/\b\d+(?:\.\d+)*\b/,operator:/!|&&|\|\||[<>]=?/,punctuation:/[(),]/}},literal:{pattern:/#(?:colorLiteral|column|dsohandle|file(?:ID|Literal|Path)?|function|imageLiteral|line)\b/,alias:"constant"},"other-directive":{pattern:/#\w+\b/,alias:"property"},attribute:{pattern:/@\w+/,alias:"atrule"},"function-definition":{pattern:/(\bfunc\s+)\w+/,lookbehind:!0,alias:"function"},label:{pattern:/\b(break|continue)\s+\w+|\b[a-zA-Z_]\w*(?=\s*:\s*(?:for|repeat|while)\b)/,lookbehind:!0,alias:"important"},keyword:/\b(?:Any|Protocol|Self|Type|actor|as|assignment|associatedtype|associativity|async|await|break|case|catch|class|continue|convenience|default|defer|deinit|didSet|do|dynamic|else|enum|extension|fallthrough|fileprivate|final|for|func|get|guard|higherThan|if|import|in|indirect|infix|init|inout|internal|is|isolated|lazy|left|let|lowerThan|mutating|none|nonisolated|nonmutating|open|operator|optional|override|postfix|precedencegroup|prefix|private|protocol|public|repeat|required|rethrows|return|right|safe|self|set|some|static|struct|subscript|super|switch|throw|throws|try|typealias|unowned|unsafe|var|weak|where|while|willSet)\b/,boolean:/\b(?:false|true)\b/,nil:{pattern:/\bnil\b/,alias:"constant"},"short-argument":/\$\d+\b/,omit:{pattern:/\b_\b/,alias:"keyword"},number:/\b(?:[\d_]+(?:\.[\de_]+)?|0x[a-f0-9_]+(?:\.[a-f0-9p_]+)?|0b[01_]+|0o[0-7_]+)\b/i,"class-name":/\b[A-Z](?:[A-Z_\d]*[a-z]\w*)?\b/,function:/\b[a-z_]\w*(?=\s*\()/i,constant:/\b(?:[A-Z_]{2,}|k[A-Z][A-Za-z_]+)\b/,operator:/[-+*/%=!<>&|^~?]+|\.[.\-+*/%=!<>&|^~?]+/,punctuation:/[{}[\]();,.:\\]/},Prism$1.languages.swift["string-literal"].forEach(function(rt){rt.inside.interpolation.inside=Prism$1.languages.swift}),(function(rt){rt.languages.kotlin=rt.languages.extend("clike",{keyword:{pattern:/(^|[^.])\b(?:abstract|actual|annotation|as|break|by|catch|class|companion|const|constructor|continue|crossinline|data|do|dynamic|else|enum|expect|external|final|finally|for|fun|get|if|import|in|infix|init|inline|inner|interface|internal|is|lateinit|noinline|null|object|open|operator|out|override|package|private|protected|public|reified|return|sealed|set|super|suspend|tailrec|this|throw|to|try|typealias|val|var|vararg|when|where|while)\b/,lookbehind:!0},function:[{pattern:/(?:`[^\r\n`]+`|\b\w+)(?=\s*\()/,greedy:!0},{pattern:/(\.)(?:`[^\r\n`]+`|\w+)(?=\s*\{)/,lookbehind:!0,greedy:!0}],number:/\b(?:0[xX][\da-fA-F]+(?:_[\da-fA-F]+)*|0[bB][01]+(?:_[01]+)*|\d+(?:_\d+)*(?:\.\d+(?:_\d+)*)?(?:[eE][+-]?\d+(?:_\d+)*)?[fFL]?)\b/,operator:/\+[+=]?|-[-=>]?|==?=?|!(?:!|==?)?|[\/*%<>]=?|[?:]:?|\.\.|&&|\|\||\b(?:and|inv|or|shl|shr|ushr|xor)\b/}),delete rt.languages.kotlin["class-name"];var it={"interpolation-punctuation":{pattern:/^\$\{?|\}$/,alias:"punctuation"},expression:{pattern:/[\s\S]+/,inside:rt.languages.kotlin}};rt.languages.insertBefore("kotlin","string",{"string-literal":[{pattern:/"""(?:[^$]|\$(?:(?!\{)|\{[^{}]*\}))*?"""/,alias:"multiline",inside:{interpolation:{pattern:/\$(?:[a-z_]\w*|\{[^{}]*\})/i,inside:it},string:/[\s\S]+/}},{pattern:/"(?:[^"\\\r\n$]|\\.|\$(?:(?!\{)|\{[^{}]*\}))*"/,alias:"singleline",inside:{interpolation:{pattern:/((?:^|[^\\])(?:\\{2})*)\$(?:[a-z_]\w*|\{[^{}]*\})/i,lookbehind:!0,inside:it},string:/[\s\S]+/}}],char:{pattern:/'(?:[^'\\\r\n]|\\(?:.|u[a-fA-F0-9]{0,4}))'/,greedy:!0}}),delete rt.languages.kotlin.string,rt.languages.insertBefore("kotlin","keyword",{annotation:{pattern:/\B@(?:\w+:)?(?:[A-Z]\w*|\[[^\]]+\])/,alias:"builtin"}}),rt.languages.insertBefore("kotlin","function",{label:{pattern:/\b\w+@|@\w+\b/,alias:"symbol"}}),rt.languages.kt=rt.languages.kotlin,rt.languages.kts=rt.languages.kotlin})(Prism$1),Prism$1.languages.c=Prism$1.languages.extend("clike",{comment:{pattern:/\/\/(?:[^\r\n\\]|\\(?:\r\n?|\n|(?![\r\n])))*|\/\*[\s\S]*?(?:\*\/|$)/,greedy:!0},string:{pattern:/"(?:\\(?:\r\n|[\s\S])|[^"\\\r\n])*"/,greedy:!0},"class-name":{pattern:/(\b(?:enum|struct)\s+(?:__attribute__\s*\(\([\s\S]*?\)\)\s*)?)\w+|\b[a-z]\w*_t\b/,lookbehind:!0},keyword:/\b(?:_Alignas|_Alignof|_Atomic|_Bool|_Complex|_Generic|_Imaginary|_Noreturn|_Static_assert|_Thread_local|__attribute__|asm|auto|break|case|char|const|continue|default|do|double|else|enum|extern|float|for|goto|if|inline|int|long|register|return|short|signed|sizeof|static|struct|switch|typedef|typeof|union|unsigned|void|volatile|while)\b/,function:/\b[a-z_]\w*(?=\s*\()/i,number:/(?:\b0x(?:[\da-f]+(?:\.[\da-f]*)?|\.[\da-f]+)(?:p[+-]?\d+)?|(?:\b\d+(?:\.\d*)?|\B\.\d+)(?:e[+-]?\d+)?)[ful]{0,4}/i,operator:/>>=?|<<=?|->|([-+&|:])\1|[?:~]|[-+*/%&|^!=<>]=?/}),Prism$1.languages.insertBefore("c","string",{char:{pattern:/'(?:\\(?:\r\n|[\s\S])|[^'\\\r\n]){0,32}'/,greedy:!0}}),Prism$1.languages.insertBefore("c","string",{macro:{pattern:/(^[\t ]*)#\s*[a-z](?:[^\r\n\\/]|\/(?!\*)|\/\*(?:[^*]|\*(?!\/))*\*\/|\\(?:\r\n|[\s\S]))*/im,lookbehind:!0,greedy:!0,alias:"property",inside:{string:[{pattern:/^(#\s*include\s*)<[^>]+>/,lookbehind:!0},Prism$1.languages.c.string],char:Prism$1.languages.c.char,comment:Prism$1.languages.c.comment,"macro-name":[{pattern:/(^#\s*define\s+)\w+\b(?!\()/i,lookbehind:!0},{pattern:/(^#\s*define\s+)\w+\b(?=\()/i,lookbehind:!0,alias:"function"}],directive:{pattern:/^(#\s*)[a-z]+/,lookbehind:!0,alias:"keyword"},"directive-hash":/^#/,punctuation:/##|\\(?=[\r\n])/,expression:{pattern:/\S[\s\S]*/,inside:Prism$1.languages.c}}}}),Prism$1.languages.insertBefore("c","function",{constant:/\b(?:EOF|NULL|SEEK_CUR|SEEK_END|SEEK_SET|__DATE__|__FILE__|__LINE__|__TIMESTAMP__|__TIME__|__func__|stderr|stdin|stdout)\b/}),delete Prism$1.languages.c.boolean,Prism$1.languages.objectivec=Prism$1.languages.extend("c",{string:{pattern:/@?"(?:\\(?:\r\n|[\s\S])|[^"\\\r\n])*"/,greedy:!0},keyword:/\b(?:asm|auto|break|case|char|const|continue|default|do|double|else|enum|extern|float|for|goto|if|in|inline|int|long|register|return|self|short|signed|sizeof|static|struct|super|switch|typedef|typeof|union|unsigned|void|volatile|while)\b|(?:@interface|@end|@implementation|@protocol|@class|@public|@protected|@private|@property|@try|@catch|@finally|@throw|@synthesize|@dynamic|@selector)\b/,operator:/-[->]?|\+\+?|!=?|<<?=?|>>?=?|==?|&&?|\|\|?|[~^%?*\/@]/}),delete Prism$1.languages.objectivec["class-name"],Prism$1.languages.objc=Prism$1.languages.objectivec,Prism$1.languages.reason=Prism$1.languages.extend("clike",{string:{pattern:/"(?:\\(?:\r\n|[\s\S])|[^\\\r\n"])*"/,greedy:!0},"class-name":/\b[A-Z]\w*/,keyword:/\b(?:and|as|assert|begin|class|constraint|do|done|downto|else|end|exception|external|for|fun|function|functor|if|in|include|inherit|initializer|lazy|let|method|module|mutable|new|nonrec|object|of|open|or|private|rec|sig|struct|switch|then|to|try|type|val|virtual|when|while|with)\b/,operator:/\.{3}|:[:=]|\|>|->|=(?:==?|>)?|<=?|>=?|[|^?'#!~`]|[+\-*\/]\.?|\b(?:asr|land|lor|lsl|lsr|lxor|mod)\b/}),Prism$1.languages.insertBefore("reason","class-name",{char:{pattern:/'(?:\\x[\da-f]{2}|\\o[0-3][0-7][0-7]|\\\d{3}|\\.|[^'\\\r\n])'/,greedy:!0},constructor:/\b[A-Z]\w*\b(?!\s*\.)/,label:{pattern:/\b[a-z]\w*(?=::)/,alias:"symbol"}}),delete Prism$1.languages.reason.function,(function(rt){for(var it=/\/\*(?:[^*/]|\*(?!\/)|\/(?!\*)|<self>)*\*\//.source,ct=0;ct<2;ct++)it=it.replace(/<self>/g,function(){return it});it=it.replace(/<self>/g,function(){return/[^\s\S]/.source}),rt.languages.rust={comment:[{pattern:RegExp(/(^|[^\\])/.source+it),lookbehind:!0,greedy:!0},{pattern:/(^|[^\\:])\/\/.*/,lookbehind:!0,greedy:!0}],string:{pattern:/b?"(?:\\[\s\S]|[^\\"])*"|b?r(#*)"(?:[^"]|"(?!\1))*"\1/,greedy:!0},char:{pattern:/b?'(?:\\(?:x[0-7][\da-fA-F]|u\{(?:[\da-fA-F]_*){1,6}\}|.)|[^\\\r\n\t'])'/,greedy:!0},attribute:{pattern:/#!?\[(?:[^\[\]"]|"(?:\\[\s\S]|[^\\"])*")*\]/,greedy:!0,alias:"attr-name",inside:{string:null}},"closure-params":{pattern:/([=(,:]\s*|\bmove\s*)\|[^|]*\||\|[^|]*\|(?=\s*(?:\{|->))/,lookbehind:!0,greedy:!0,inside:{"closure-punctuation":{pattern:/^\||\|$/,alias:"punctuation"},rest:null}},"lifetime-annotation":{pattern:/'\w+/,alias:"symbol"},"fragment-specifier":{pattern:/(\$\w+:)[a-z]+/,lookbehind:!0,alias:"punctuation"},variable:/\$\w+/,"function-definition":{pattern:/(\bfn\s+)\w+/,lookbehind:!0,alias:"function"},"type-definition":{pattern:/(\b(?:enum|struct|trait|type|union)\s+)\w+/,lookbehind:!0,alias:"class-name"},"module-declaration":[{pattern:/(\b(?:crate|mod)\s+)[a-z][a-z_\d]*/,lookbehind:!0,alias:"namespace"},{pattern:/(\b(?:crate|self|super)\s*)::\s*[a-z][a-z_\d]*\b(?:\s*::(?:\s*[a-z][a-z_\d]*\s*::)*)?/,lookbehind:!0,alias:"namespace",inside:{punctuation:/::/}}],keyword:[/\b(?:Self|abstract|as|async|await|become|box|break|const|continue|crate|do|dyn|else|enum|extern|final|fn|for|if|impl|in|let|loop|macro|match|mod|move|mut|override|priv|pub|ref|return|self|static|struct|super|trait|try|type|typeof|union|unsafe|unsized|use|virtual|where|while|yield)\b/,/\b(?:bool|char|f(?:32|64)|[ui](?:8|16|32|64|128|size)|str)\b/],function:/\b[a-z_]\w*(?=\s*(?:::\s*<|\())/,macro:{pattern:/\b\w+!/,alias:"property"},constant:/\b[A-Z_][A-Z_\d]+\b/,"class-name":/\b[A-Z]\w*\b/,namespace:{pattern:/(?:\b[a-z][a-z_\d]*\s*::\s*)*\b[a-z][a-z_\d]*\s*::(?!\s*<)/,inside:{punctuation:/::/}},number:/\b(?:0x[\dA-Fa-f](?:_?[\dA-Fa-f])*|0o[0-7](?:_?[0-7])*|0b[01](?:_?[01])*|(?:(?:\d(?:_?\d)*)?\.)?\d(?:_?\d)*(?:[Ee][+-]?\d+)?)(?:_?(?:f32|f64|[iu](?:8|16|32|64|size)?))?\b/,boolean:/\b(?:false|true)\b/,punctuation:/->|\.\.=|\.{1,3}|::|[{}[\];(),:]/,operator:/[-+*\/%!^]=?|=[=>]?|&[&=]?|\|[|=]?|<<?=?|>>?=?|[@?]/},rt.languages.rust["closure-params"].inside.rest=rt.languages.rust,rt.languages.rust.attribute.inside.string=rt.languages.rust.string})(Prism$1),Prism$1.languages.go=Prism$1.languages.extend("clike",{string:{pattern:/(^|[^\\])"(?:\\.|[^"\\\r\n])*"|`[^`]*`/,lookbehind:!0,greedy:!0},keyword:/\b(?:break|case|chan|const|continue|default|defer|else|fallthrough|for|func|go(?:to)?|if|import|interface|map|package|range|return|select|struct|switch|type|var)\b/,boolean:/\b(?:_|false|iota|nil|true)\b/,number:[/\b0(?:b[01_]+|o[0-7_]+)i?\b/i,/\b0x(?:[a-f\d_]+(?:\.[a-f\d_]*)?|\.[a-f\d_]+)(?:p[+-]?\d+(?:_\d+)*)?i?(?!\w)/i,/(?:\b\d[\d_]*(?:\.[\d_]*)?|\B\.\d[\d_]*)(?:e[+-]?[\d_]+)?i?(?!\w)/i],operator:/[*\/%^!=]=?|\+[=+]?|-[=-]?|\|[=|]?|&(?:=|&|\^=?)?|>(?:>=?|=)?|<(?:<=?|=|-)?|:=|\.\.\./,builtin:/\b(?:append|bool|byte|cap|close|complex|complex(?:64|128)|copy|delete|error|float(?:32|64)|u?int(?:8|16|32|64)?|imag|len|make|new|panic|print(?:ln)?|real|recover|rune|string|uintptr)\b/}),Prism$1.languages.insertBefore("go","string",{char:{pattern:/'(?:\\.|[^'\\\r\n]){0,10}'/,greedy:!0}}),delete Prism$1.languages.go["class-name"],(function(rt){var it=/\b(?:alignas|alignof|asm|auto|bool|break|case|catch|char|char16_t|char32_t|char8_t|class|co_await|co_return|co_yield|compl|concept|const|const_cast|consteval|constexpr|constinit|continue|decltype|default|delete|do|double|dynamic_cast|else|enum|explicit|export|extern|final|float|for|friend|goto|if|import|inline|int|int16_t|int32_t|int64_t|int8_t|long|module|mutable|namespace|new|noexcept|nullptr|operator|override|private|protected|public|register|reinterpret_cast|requires|return|short|signed|sizeof|static|static_assert|static_cast|struct|switch|template|this|thread_local|throw|try|typedef|typeid|typename|uint16_t|uint32_t|uint64_t|uint8_t|union|unsigned|using|virtual|void|volatile|wchar_t|while)\b/,ct=/\b(?!<keyword>)\w+(?:\s*\.\s*\w+)*\b/.source.replace(/<keyword>/g,function(){return it.source});rt.languages.cpp=rt.languages.extend("c",{"class-name":[{pattern:RegExp(/(\b(?:class|concept|enum|struct|typename)\s+)(?!<keyword>)\w+/.source.replace(/<keyword>/g,function(){return it.source})),lookbehind:!0},/\b[A-Z]\w*(?=\s*::\s*\w+\s*\()/,/\b[A-Z_]\w*(?=\s*::\s*~\w+\s*\()/i,/\b\w+(?=\s*<(?:[^<>]|<(?:[^<>]|<[^<>]*>)*>)*>\s*::\s*\w+\s*\()/],keyword:it,number:{pattern:/(?:\b0b[01']+|\b0x(?:[\da-f']+(?:\.[\da-f']*)?|\.[\da-f']+)(?:p[+-]?[\d']+)?|(?:\b[\d']+(?:\.[\d']*)?|\B\.[\d']+)(?:e[+-]?[\d']+)?)[ful]{0,4}/i,greedy:!0},operator:/>>=?|<<=?|->|--|\+\+|&&|\|\||[?:~]|<=>|[-+*/%&|^!=<>]=?|\b(?:and|and_eq|bitand|bitor|not|not_eq|or|or_eq|xor|xor_eq)\b/,boolean:/\b(?:false|true)\b/}),rt.languages.insertBefore("cpp","string",{module:{pattern:RegExp(/(\b(?:import|module)\s+)/.source+"(?:"+/"(?:\\(?:\r\n|[\s\S])|[^"\\\r\n])*"|<[^<>\r\n]*>/.source+"|"+/<mod-name>(?:\s*:\s*<mod-name>)?|:\s*<mod-name>/.source.replace(/<mod-name>/g,function(){return ct})+")"),lookbehind:!0,greedy:!0,inside:{string:/^[<"][\s\S]+/,operator:/:/,punctuation:/\./}},"raw-string":{pattern:/R"([^()\\ ]{0,16})\([\s\S]*?\)\1"/,alias:"string",greedy:!0}}),rt.languages.insertBefore("cpp","keyword",{"generic-function":{pattern:/\b(?!operator\b)[a-z_]\w*\s*<(?:[^<>]|<[^<>]*>)*>(?=\s*\()/i,inside:{function:/^\w+/,generic:{pattern:/<[\s\S]+/,alias:"class-name",inside:rt.languages.cpp}}}}),rt.languages.insertBefore("cpp","operator",{"double-colon":{pattern:/::/,alias:"punctuation"}}),rt.languages.insertBefore("cpp","class-name",{"base-clause":{pattern:/(\b(?:class|struct)\s+\w+\s*:\s*)[^;{}"'\s]+(?:\s+[^;{}"'\s]+)*(?=\s*[;{])/,lookbehind:!0,greedy:!0,inside:rt.languages.extend("cpp",{})}}),rt.languages.insertBefore("inside","double-colon",{"class-name":/\b[a-z_]\w*\b(?!\s*::)/i},rt.languages.cpp["base-clause"])})(Prism$1),Prism$1.languages.python={comment:{pattern:/(^|[^\\])#.*/,lookbehind:!0,greedy:!0},"string-interpolation":{pattern:/(?:f|fr|rf)(?:("""|''')[\s\S]*?\1|("|')(?:\\.|(?!\2)[^\\\r\n])*\2)/i,greedy:!0,inside:{interpolation:{pattern:/((?:^|[^{])(?:\{\{)*)\{(?!\{)(?:[^{}]|\{(?!\{)(?:[^{}]|\{(?!\{)(?:[^{}])+\})+\})+\}/,lookbehind:!0,inside:{"format-spec":{pattern:/(:)[^:(){}]+(?=\}$)/,lookbehind:!0},"conversion-option":{pattern:/![sra](?=[:}]$)/,alias:"punctuation"},rest:null}},string:/[\s\S]+/}},"triple-quoted-string":{pattern:/(?:[rub]|br|rb)?("""|''')[\s\S]*?\1/i,greedy:!0,alias:"string"},string:{pattern:/(?:[rub]|br|rb)?("|')(?:\\.|(?!\1)[^\\\r\n])*\1/i,greedy:!0},function:{pattern:/((?:^|\s)def[ \t]+)[a-zA-Z_]\w*(?=\s*\()/g,lookbehind:!0},"class-name":{pattern:/(\bclass\s+)\w+/i,lookbehind:!0},decorator:{pattern:/(^[\t ]*)@\w+(?:\.\w+)*/m,lookbehind:!0,alias:["annotation","punctuation"],inside:{punctuation:/\./}},keyword:/\b(?:_(?=\s*:)|and|as|assert|async|await|break|case|class|continue|def|del|elif|else|except|exec|finally|for|from|global|if|import|in|is|lambda|match|nonlocal|not|or|pass|print|raise|return|try|while|with|yield)\b/,builtin:/\b(?:__import__|abs|all|any|apply|ascii|basestring|bin|bool|buffer|bytearray|bytes|callable|chr|classmethod|cmp|coerce|compile|complex|delattr|dict|dir|divmod|enumerate|eval|execfile|file|filter|float|format|frozenset|getattr|globals|hasattr|hash|help|hex|id|input|int|intern|isinstance|issubclass|iter|len|list|locals|long|map|max|memoryview|min|next|object|oct|open|ord|pow|property|range|raw_input|reduce|reload|repr|reversed|round|set|setattr|slice|sorted|staticmethod|str|sum|super|tuple|type|unichr|unicode|vars|xrange|zip)\b/,boolean:/\b(?:False|None|True)\b/,number:/\b0(?:b(?:_?[01])+|o(?:_?[0-7])+|x(?:_?[a-f0-9])+)\b|(?:\b\d+(?:_\d+)*(?:\.(?:\d+(?:_\d+)*)?)?|\B\.\d+(?:_\d+)*)(?:e[+-]?\d+(?:_\d+)*)?j?(?!\w)/i,operator:/[-+%=]=?|!=|:=|\*\*?=?|\/\/?=?|<[<=>]?|>[=>]?|[&|^~]/,punctuation:/[{}[\];(),.:]/},Prism$1.languages.python["string-interpolation"].inside.interpolation.inside.rest=Prism$1.languages.python,Prism$1.languages.py=Prism$1.languages.python,Prism$1.languages.json={property:{pattern:/(^|[^\\])"(?:\\.|[^\\"\r\n])*"(?=\s*:)/,lookbehind:!0,greedy:!0},string:{pattern:/(^|[^\\])"(?:\\.|[^\\"\r\n])*"(?!\s*:)/,lookbehind:!0,greedy:!0},comment:{pattern:/\/\/.*|\/\*[\s\S]*?(?:\*\/|$)/,greedy:!0},number:/-?\b\d+(?:\.\d+)?(?:e[+-]?\d+)?\b/i,punctuation:/[{}[\],]/,operator:/:/,boolean:/\b(?:false|true)\b/,null:{pattern:/\bnull\b/,alias:"keyword"}},Prism$1.languages.webmanifest=Prism$1.languages.json;var themes_exports={};__export(themes_exports,{dracula:()=>dracula_default,duotoneDark:()=>duotoneDark_default,duotoneLight:()=>duotoneLight_default,github:()=>github_default,gruvboxMaterialDark:()=>gruvboxMaterialDark_default,gruvboxMaterialLight:()=>gruvboxMaterialLight_default,jettwaveDark:()=>jettwaveDark_default,jettwaveLight:()=>jettwaveLight_default,nightOwl:()=>nightOwl_default,nightOwlLight:()=>nightOwlLight_default,oceanicNext:()=>oceanicNext_default,okaidia:()=>okaidia_default,oneDark:()=>oneDark_default,oneLight:()=>oneLight_default,palenight:()=>palenight_default,shadesOfPurple:()=>shadesOfPurple_default,synthwave84:()=>synthwave84_default,ultramin:()=>ultramin_default,vsDark:()=>vsDark_default,vsLight:()=>vsLight_default});var theme={plain:{color:"#F8F8F2",backgroundColor:"#282A36"},styles:[{types:["prolog","constant","builtin"],style:{color:"rgb(189, 147, 249)"}},{types:["inserted","function"],style:{color:"rgb(80, 250, 123)"}},{types:["deleted"],style:{color:"rgb(255, 85, 85)"}},{types:["changed"],style:{color:"rgb(255, 184, 108)"}},{types:["punctuation","symbol"],style:{color:"rgb(248, 248, 242)"}},{types:["string","char","tag","selector"],style:{color:"rgb(255, 121, 198)"}},{types:["keyword","variable"],style:{color:"rgb(189, 147, 249)",fontStyle:"italic"}},{types:["comment"],style:{color:"rgb(98, 114, 164)"}},{types:["attr-name"],style:{color:"rgb(241, 250, 140)"}}]},dracula_default=theme,theme2={plain:{backgroundColor:"#2a2734",color:"#9a86fd"},styles:[{types:["comment","prolog","doctype","cdata","punctuation"],style:{color:"#6c6783"}},{types:["namespace"],style:{opacity:.7}},{types:["tag","operator","number"],style:{color:"#e09142"}},{types:["property","function"],style:{color:"#9a86fd"}},{types:["tag-id","selector","atrule-id"],style:{color:"#eeebff"}},{types:["attr-name"],style:{color:"#c4b9fe"}},{types:["boolean","string","entity","url","attr-value","keyword","control","directive","unit","statement","regex","atrule","placeholder","variable"],style:{color:"#ffcc99"}},{types:["deleted"],style:{textDecorationLine:"line-through"}},{types:["inserted"],style:{textDecorationLine:"underline"}},{types:["italic"],style:{fontStyle:"italic"}},{types:["important","bold"],style:{fontWeight:"bold"}},{types:["important"],style:{color:"#c4b9fe"}}]},duotoneDark_default=theme2,theme3={plain:{backgroundColor:"#faf8f5",color:"#728fcb"},styles:[{types:["comment","prolog","doctype","cdata","punctuation"],style:{color:"#b6ad9a"}},{types:["namespace"],style:{opacity:.7}},{types:["tag","operator","number"],style:{color:"#063289"}},{types:["property","function"],style:{color:"#b29762"}},{types:["tag-id","selector","atrule-id"],style:{color:"#2d2006"}},{types:["attr-name"],style:{color:"#896724"}},{types:["boolean","string","entity","url","attr-value","keyword","control","directive","unit","statement","regex","atrule"],style:{color:"#728fcb"}},{types:["placeholder","variable"],style:{color:"#93abdc"}},{types:["deleted"],style:{textDecorationLine:"line-through"}},{types:["inserted"],style:{textDecorationLine:"underline"}},{types:["italic"],style:{fontStyle:"italic"}},{types:["important","bold"],style:{fontWeight:"bold"}},{types:["important"],style:{color:"#896724"}}]},duotoneLight_default=theme3,theme4={plain:{color:"#393A34",backgroundColor:"#f6f8fa"},styles:[{types:["comment","prolog","doctype","cdata"],style:{color:"#999988",fontStyle:"italic"}},{types:["namespace"],style:{opacity:.7}},{types:["string","attr-value"],style:{color:"#e3116c"}},{types:["punctuation","operator"],style:{color:"#393A34"}},{types:["entity","url","symbol","number","boolean","variable","constant","property","regex","inserted"],style:{color:"#36acaa"}},{types:["atrule","keyword","attr-name","selector"],style:{color:"#00a4db"}},{types:["function","deleted","tag"],style:{color:"#d73a49"}},{types:["function-variable"],style:{color:"#6f42c1"}},{types:["tag","selector","keyword"],style:{color:"#00009f"}}]},github_default=theme4,theme5={plain:{color:"#d6deeb",backgroundColor:"#011627"},styles:[{types:["changed"],style:{color:"rgb(162, 191, 252)",fontStyle:"italic"}},{types:["deleted"],style:{color:"rgba(239, 83, 80, 0.56)",fontStyle:"italic"}},{types:["inserted","attr-name"],style:{color:"rgb(173, 219, 103)",fontStyle:"italic"}},{types:["comment"],style:{color:"rgb(99, 119, 119)",fontStyle:"italic"}},{types:["string","url"],style:{color:"rgb(173, 219, 103)"}},{types:["variable"],style:{color:"rgb(214, 222, 235)"}},{types:["number"],style:{color:"rgb(247, 140, 108)"}},{types:["builtin","char","constant","function"],style:{color:"rgb(130, 170, 255)"}},{types:["punctuation"],style:{color:"rgb(199, 146, 234)"}},{types:["selector","doctype"],style:{color:"rgb(199, 146, 234)",fontStyle:"italic"}},{types:["class-name"],style:{color:"rgb(255, 203, 139)"}},{types:["tag","operator","keyword"],style:{color:"rgb(127, 219, 202)"}},{types:["boolean"],style:{color:"rgb(255, 88, 116)"}},{types:["property"],style:{color:"rgb(128, 203, 196)"}},{types:["namespace"],style:{color:"rgb(178, 204, 214)"}}]},nightOwl_default=theme5,theme6={plain:{color:"#403f53",backgroundColor:"#FBFBFB"},styles:[{types:["changed"],style:{color:"rgb(162, 191, 252)",fontStyle:"italic"}},{types:["deleted"],style:{color:"rgba(239, 83, 80, 0.56)",fontStyle:"italic"}},{types:["inserted","attr-name"],style:{color:"rgb(72, 118, 214)",fontStyle:"italic"}},{types:["comment"],style:{color:"rgb(152, 159, 177)",fontStyle:"italic"}},{types:["string","builtin","char","constant","url"],style:{color:"rgb(72, 118, 214)"}},{types:["variable"],style:{color:"rgb(201, 103, 101)"}},{types:["number"],style:{color:"rgb(170, 9, 130)"}},{types:["punctuation"],style:{color:"rgb(153, 76, 195)"}},{types:["function","selector","doctype"],style:{color:"rgb(153, 76, 195)",fontStyle:"italic"}},{types:["class-name"],style:{color:"rgb(17, 17, 17)"}},{types:["tag"],style:{color:"rgb(153, 76, 195)"}},{types:["operator","property","keyword","namespace"],style:{color:"rgb(12, 150, 155)"}},{types:["boolean"],style:{color:"rgb(188, 84, 84)"}}]},nightOwlLight_default=theme6,colors={char:"#D8DEE9",comment:"#999999",keyword:"#c5a5c5",primitive:"#5a9bcf",string:"#8dc891",variable:"#d7deea",boolean:"#ff8b50",tag:"#fc929e",function:"#79b6f2",className:"#FAC863"},theme7={plain:{backgroundColor:"#282c34",color:"#ffffff"},styles:[{types:["attr-name"],style:{color:colors.keyword}},{types:["attr-value"],style:{color:colors.string}},{types:["comment","block-comment","prolog","doctype","cdata","shebang"],style:{color:colors.comment}},{types:["property","number","function-name","constant","symbol","deleted"],style:{color:colors.primitive}},{types:["boolean"],style:{color:colors.boolean}},{types:["tag"],style:{color:colors.tag}},{types:["string"],style:{color:colors.string}},{types:["punctuation"],style:{color:colors.string}},{types:["selector","char","builtin","inserted"],style:{color:colors.char}},{types:["function"],style:{color:colors.function}},{types:["operator","entity","url","variable"],style:{color:colors.variable}},{types:["keyword"],style:{color:colors.keyword}},{types:["atrule","class-name"],style:{color:colors.className}},{types:["important"],style:{fontWeight:"400"}},{types:["bold"],style:{fontWeight:"bold"}},{types:["italic"],style:{fontStyle:"italic"}},{types:["namespace"],style:{opacity:.7}}]},oceanicNext_default=theme7,theme8={plain:{color:"#f8f8f2",backgroundColor:"#272822"},styles:[{types:["changed"],style:{color:"rgb(162, 191, 252)",fontStyle:"italic"}},{types:["deleted"],style:{color:"#f92672",fontStyle:"italic"}},{types:["inserted"],style:{color:"rgb(173, 219, 103)",fontStyle:"italic"}},{types:["comment"],style:{color:"#8292a2",fontStyle:"italic"}},{types:["string","url"],style:{color:"#a6e22e"}},{types:["variable"],style:{color:"#f8f8f2"}},{types:["number"],style:{color:"#ae81ff"}},{types:["builtin","char","constant","function","class-name"],style:{color:"#e6db74"}},{types:["punctuation"],style:{color:"#f8f8f2"}},{types:["selector","doctype"],style:{color:"#a6e22e",fontStyle:"italic"}},{types:["tag","operator","keyword"],style:{color:"#66d9ef"}},{types:["boolean"],style:{color:"#ae81ff"}},{types:["namespace"],style:{color:"rgb(178, 204, 214)",opacity:.7}},{types:["tag","property"],style:{color:"#f92672"}},{types:["attr-name"],style:{color:"#a6e22e !important"}},{types:["doctype"],style:{color:"#8292a2"}},{types:["rule"],style:{color:"#e6db74"}}]},okaidia_default=theme8,theme9={plain:{color:"#bfc7d5",backgroundColor:"#292d3e"},styles:[{types:["comment"],style:{color:"rgb(105, 112, 152)",fontStyle:"italic"}},{types:["string","inserted"],style:{color:"rgb(195, 232, 141)"}},{types:["number"],style:{color:"rgb(247, 140, 108)"}},{types:["builtin","char","constant","function"],style:{color:"rgb(130, 170, 255)"}},{types:["punctuation","selector"],style:{color:"rgb(199, 146, 234)"}},{types:["variable"],style:{color:"rgb(191, 199, 213)"}},{types:["class-name","attr-name"],style:{color:"rgb(255, 203, 107)"}},{types:["tag","deleted"],style:{color:"rgb(255, 85, 114)"}},{types:["operator"],style:{color:"rgb(137, 221, 255)"}},{types:["boolean"],style:{color:"rgb(255, 88, 116)"}},{types:["keyword"],style:{fontStyle:"italic"}},{types:["doctype"],style:{color:"rgb(199, 146, 234)",fontStyle:"italic"}},{types:["namespace"],style:{color:"rgb(178, 204, 214)"}},{types:["url"],style:{color:"rgb(221, 221, 221)"}}]},palenight_default=theme9,theme10={plain:{color:"#9EFEFF",backgroundColor:"#2D2A55"},styles:[{types:["changed"],style:{color:"rgb(255, 238, 128)"}},{types:["deleted"],style:{color:"rgba(239, 83, 80, 0.56)"}},{types:["inserted"],style:{color:"rgb(173, 219, 103)"}},{types:["comment"],style:{color:"rgb(179, 98, 255)",fontStyle:"italic"}},{types:["punctuation"],style:{color:"rgb(255, 255, 255)"}},{types:["constant"],style:{color:"rgb(255, 98, 140)"}},{types:["string","url"],style:{color:"rgb(165, 255, 144)"}},{types:["variable"],style:{color:"rgb(255, 238, 128)"}},{types:["number","boolean"],style:{color:"rgb(255, 98, 140)"}},{types:["attr-name"],style:{color:"rgb(255, 180, 84)"}},{types:["keyword","operator","property","namespace","tag","selector","doctype"],style:{color:"rgb(255, 157, 0)"}},{types:["builtin","char","constant","function","class-name"],style:{color:"rgb(250, 208, 0)"}}]},shadesOfPurple_default=theme10,theme11={plain:{backgroundColor:"linear-gradient(to bottom, #2a2139 75%, #34294f)",backgroundImage:"#34294f",color:"#f92aad",textShadow:"0 0 2px #100c0f, 0 0 5px #dc078e33, 0 0 10px #fff3"},styles:[{types:["comment","block-comment","prolog","doctype","cdata"],style:{color:"#495495",fontStyle:"italic"}},{types:["punctuation"],style:{color:"#ccc"}},{types:["tag","attr-name","namespace","number","unit","hexcode","deleted"],style:{color:"#e2777a"}},{types:["property","selector"],style:{color:"#72f1b8",textShadow:"0 0 2px #100c0f, 0 0 10px #257c5575, 0 0 35px #21272475"}},{types:["function-name"],style:{color:"#6196cc"}},{types:["boolean","selector-id","function"],style:{color:"#fdfdfd",textShadow:"0 0 2px #001716, 0 0 3px #03edf975, 0 0 5px #03edf975, 0 0 8px #03edf975"}},{types:["class-name","maybe-class-name","builtin"],style:{color:"#fff5f6",textShadow:"0 0 2px #000, 0 0 10px #fc1f2c75, 0 0 5px #fc1f2c75, 0 0 25px #fc1f2c75"}},{types:["constant","symbol"],style:{color:"#f92aad",textShadow:"0 0 2px #100c0f, 0 0 5px #dc078e33, 0 0 10px #fff3"}},{types:["important","atrule","keyword","selector-class"],style:{color:"#f4eee4",textShadow:"0 0 2px #393a33, 0 0 8px #f39f0575, 0 0 2px #f39f0575"}},{types:["string","char","attr-value","regex","variable"],style:{color:"#f87c32"}},{types:["parameter"],style:{fontStyle:"italic"}},{types:["entity","url"],style:{color:"#67cdcc"}},{types:["operator"],style:{color:"ffffffee"}},{types:["important","bold"],style:{fontWeight:"bold"}},{types:["italic"],style:{fontStyle:"italic"}},{types:["entity"],style:{cursor:"help"}},{types:["inserted"],style:{color:"green"}}]},synthwave84_default=theme11,theme12={plain:{color:"#282a2e",backgroundColor:"#ffffff"},styles:[{types:["comment"],style:{color:"rgb(197, 200, 198)"}},{types:["string","number","builtin","variable"],style:{color:"rgb(150, 152, 150)"}},{types:["class-name","function","tag","attr-name"],style:{color:"rgb(40, 42, 46)"}}]},ultramin_default=theme12,theme13={plain:{color:"#9CDCFE",backgroundColor:"#1E1E1E"},styles:[{types:["prolog"],style:{color:"rgb(0, 0, 128)"}},{types:["comment"],style:{color:"rgb(106, 153, 85)"}},{types:["builtin","changed","keyword","interpolation-punctuation"],style:{color:"rgb(86, 156, 214)"}},{types:["number","inserted"],style:{color:"rgb(181, 206, 168)"}},{types:["constant"],style:{color:"rgb(100, 102, 149)"}},{types:["attr-name","variable"],style:{color:"rgb(156, 220, 254)"}},{types:["deleted","string","attr-value","template-punctuation"],style:{color:"rgb(206, 145, 120)"}},{types:["selector"],style:{color:"rgb(215, 186, 125)"}},{types:["tag"],style:{color:"rgb(78, 201, 176)"}},{types:["tag"],languages:["markup"],style:{color:"rgb(86, 156, 214)"}},{types:["punctuation","operator"],style:{color:"rgb(212, 212, 212)"}},{types:["punctuation"],languages:["markup"],style:{color:"#808080"}},{types:["function"],style:{color:"rgb(220, 220, 170)"}},{types:["class-name"],style:{color:"rgb(78, 201, 176)"}},{types:["char"],style:{color:"rgb(209, 105, 105)"}}]},vsDark_default=theme13,theme14={plain:{color:"#000000",backgroundColor:"#ffffff"},styles:[{types:["comment"],style:{color:"rgb(0, 128, 0)"}},{types:["builtin"],style:{color:"rgb(0, 112, 193)"}},{types:["number","variable","inserted"],style:{color:"rgb(9, 134, 88)"}},{types:["operator"],style:{color:"rgb(0, 0, 0)"}},{types:["constant","char"],style:{color:"rgb(129, 31, 63)"}},{types:["tag"],style:{color:"rgb(128, 0, 0)"}},{types:["attr-name"],style:{color:"rgb(255, 0, 0)"}},{types:["deleted","string"],style:{color:"rgb(163, 21, 21)"}},{types:["changed","punctuation"],style:{color:"rgb(4, 81, 165)"}},{types:["function","keyword"],style:{color:"rgb(0, 0, 255)"}},{types:["class-name"],style:{color:"rgb(38, 127, 153)"}}]},vsLight_default=theme14,theme15={plain:{color:"#f8fafc",backgroundColor:"#011627"},styles:[{types:["prolog"],style:{color:"#000080"}},{types:["comment"],style:{color:"#6A9955"}},{types:["builtin","changed","keyword","interpolation-punctuation"],style:{color:"#569CD6"}},{types:["number","inserted"],style:{color:"#B5CEA8"}},{types:["constant"],style:{color:"#f8fafc"}},{types:["attr-name","variable"],style:{color:"#9CDCFE"}},{types:["deleted","string","attr-value","template-punctuation"],style:{color:"#cbd5e1"}},{types:["selector"],style:{color:"#D7BA7D"}},{types:["tag"],style:{color:"#0ea5e9"}},{types:["tag"],languages:["markup"],style:{color:"#0ea5e9"}},{types:["punctuation","operator"],style:{color:"#D4D4D4"}},{types:["punctuation"],languages:["markup"],style:{color:"#808080"}},{types:["function"],style:{color:"#7dd3fc"}},{types:["class-name"],style:{color:"#0ea5e9"}},{types:["char"],style:{color:"#D16969"}}]},jettwaveDark_default=theme15,theme16={plain:{color:"#0f172a",backgroundColor:"#f1f5f9"},styles:[{types:["prolog"],style:{color:"#000080"}},{types:["comment"],style:{color:"#6A9955"}},{types:["builtin","changed","keyword","interpolation-punctuation"],style:{color:"#0c4a6e"}},{types:["number","inserted"],style:{color:"#B5CEA8"}},{types:["constant"],style:{color:"#0f172a"}},{types:["attr-name","variable"],style:{color:"#0c4a6e"}},{types:["deleted","string","attr-value","template-punctuation"],style:{color:"#64748b"}},{types:["selector"],style:{color:"#D7BA7D"}},{types:["tag"],style:{color:"#0ea5e9"}},{types:["tag"],languages:["markup"],style:{color:"#0ea5e9"}},{types:["punctuation","operator"],style:{color:"#475569"}},{types:["punctuation"],languages:["markup"],style:{color:"#808080"}},{types:["function"],style:{color:"#0e7490"}},{types:["class-name"],style:{color:"#0ea5e9"}},{types:["char"],style:{color:"#D16969"}}]},jettwaveLight_default=theme16,theme17={plain:{backgroundColor:"hsl(220, 13%, 18%)",color:"hsl(220, 14%, 71%)",textShadow:"0 1px rgba(0, 0, 0, 0.3)"},styles:[{types:["comment","prolog","cdata"],style:{color:"hsl(220, 10%, 40%)"}},{types:["doctype","punctuation","entity"],style:{color:"hsl(220, 14%, 71%)"}},{types:["attr-name","class-name","maybe-class-name","boolean","constant","number","atrule"],style:{color:"hsl(29, 54%, 61%)"}},{types:["keyword"],style:{color:"hsl(286, 60%, 67%)"}},{types:["property","tag","symbol","deleted","important"],style:{color:"hsl(355, 65%, 65%)"}},{types:["selector","string","char","builtin","inserted","regex","attr-value"],style:{color:"hsl(95, 38%, 62%)"}},{types:["variable","operator","function"],style:{color:"hsl(207, 82%, 66%)"}},{types:["url"],style:{color:"hsl(187, 47%, 55%)"}},{types:["deleted"],style:{textDecorationLine:"line-through"}},{types:["inserted"],style:{textDecorationLine:"underline"}},{types:["italic"],style:{fontStyle:"italic"}},{types:["important","bold"],style:{fontWeight:"bold"}},{types:["important"],style:{color:"hsl(220, 14%, 71%)"}}]},oneDark_default=theme17,theme18={plain:{backgroundColor:"hsl(230, 1%, 98%)",color:"hsl(230, 8%, 24%)"},styles:[{types:["comment","prolog","cdata"],style:{color:"hsl(230, 4%, 64%)"}},{types:["doctype","punctuation","entity"],style:{color:"hsl(230, 8%, 24%)"}},{types:["attr-name","class-name","boolean","constant","number","atrule"],style:{color:"hsl(35, 99%, 36%)"}},{types:["keyword"],style:{color:"hsl(301, 63%, 40%)"}},{types:["property","tag","symbol","deleted","important"],style:{color:"hsl(5, 74%, 59%)"}},{types:["selector","string","char","builtin","inserted","regex","attr-value","punctuation"],style:{color:"hsl(119, 34%, 47%)"}},{types:["variable","operator","function"],style:{color:"hsl(221, 87%, 60%)"}},{types:["url"],style:{color:"hsl(198, 99%, 37%)"}},{types:["deleted"],style:{textDecorationLine:"line-through"}},{types:["inserted"],style:{textDecorationLine:"underline"}},{types:["italic"],style:{fontStyle:"italic"}},{types:["important","bold"],style:{fontWeight:"bold"}},{types:["important"],style:{color:"hsl(230, 8%, 24%)"}}]},oneLight_default=theme18,theme19={plain:{color:"#ebdbb2",backgroundColor:"#292828"},styles:[{types:["imports","class-name","maybe-class-name","constant","doctype","builtin","function"],style:{color:"#d8a657"}},{types:["property-access"],style:{color:"#7daea3"}},{types:["tag"],style:{color:"#e78a4e"}},{types:["attr-name","char","url","regex"],style:{color:"#a9b665"}},{types:["attr-value","string"],style:{color:"#89b482"}},{types:["comment","prolog","cdata","operator","inserted"],style:{color:"#a89984"}},{types:["delimiter","boolean","keyword","selector","important","atrule","property","variable","deleted"],style:{color:"#ea6962"}},{types:["entity","number","symbol"],style:{color:"#d3869b"}}]},gruvboxMaterialDark_default=theme19,theme20={plain:{color:"#654735",backgroundColor:"#f9f5d7"},styles:[{types:["delimiter","boolean","keyword","selector","important","atrule","property","variable","deleted"],style:{color:"#af2528"}},{types:["imports","class-name","maybe-class-name","constant","doctype","builtin"],style:{color:"#b4730e"}},{types:["string","attr-value"],style:{color:"#477a5b"}},{types:["property-access"],style:{color:"#266b79"}},{types:["function","attr-name","char","url"],style:{color:"#72761e"}},{types:["tag"],style:{color:"#b94c07"}},{types:["comment","prolog","cdata","operator","inserted"],style:{color:"#a89984"}},{types:["entity","number","symbol"],style:{color:"#924f79"}}]},gruvboxMaterialLight_default=theme20,useGetLineProps=rt=>reactExports.useCallback(it=>{var ct=it,{className:dt,style:ut,line:pt}=ct,yt=__objRest(ct,["className","style","line"]);const ft=__spreadProps(__spreadValues({},yt),{className:clsx("token-line",dt)});return typeof rt=="object"&&"plain"in rt&&(ft.style=rt.plain),typeof ut=="object"&&(ft.style=__spreadValues(__spreadValues({},ft.style||{}),ut)),ft},[rt]),useGetTokenProps=rt=>{const it=reactExports.useCallback(({types:ct,empty:dt})=>{if(rt!=null){{if(ct.length===1&&ct[0]==="plain")return dt!=null?{display:"inline-block"}:void 0;if(ct.length===1&&dt!=null)return rt[ct[0]]}return Object.assign(dt!=null?{display:"inline-block"}:{},...ct.map(ut=>rt[ut]))}},[rt]);return reactExports.useCallback(ct=>{var dt=ct,{token:ut,className:pt,style:yt}=dt,ft=__objRest(dt,["token","className","style"]);const mt=__spreadProps(__spreadValues({},ft),{className:clsx("token",...ut.types,pt),children:ut.content,style:it(ut)});return yt!=null&&(mt.style=__spreadValues(__spreadValues({},mt.style||{}),yt)),mt},[it])},newlineRe=/\r\n|\r|\n/,normalizeEmptyLines=rt=>{rt.length===0?rt.push({types:["plain"],content:`
-`,empty:!0}):rt.length===1&&rt[0].content===""&&(rt[0].content=`
-`,rt[0].empty=!0)},appendTypes=(rt,it)=>{const ct=rt.length;return ct>0&&rt[ct-1]===it?rt:rt.concat(it)},normalizeTokens=rt=>{const it=[[]],ct=[rt],dt=[0],ut=[rt.length];let pt=0,yt=0,ft=[];const mt=[ft];for(;yt>-1;){for(;(pt=dt[yt]++)<ut[yt];){let kt,_t=it[yt];const bt=ct[yt][pt];if(typeof bt=="string"?(_t=yt>0?_t:["plain"],kt=bt):(_t=appendTypes(_t,bt.type),bt.alias&&(_t=appendTypes(_t,bt.alias)),kt=bt.content),typeof kt!="string"){yt++,it.push(_t),ct.push(kt),dt.push(0),ut.push(kt.length);continue}const Mt=kt.split(newlineRe),wt=Mt.length;ft.push({types:_t,content:Mt[0]});for(let St=1;St<wt;St++)normalizeEmptyLines(ft),mt.push(ft=[]),ft.push({types:_t,content:Mt[St]})}yt--,it.pop(),ct.pop(),dt.pop(),ut.pop()}return normalizeEmptyLines(ft),mt},normalizeTokens_default=normalizeTokens,useTokenize=({prism:rt,code:it,grammar:ct,language:dt})=>reactExports.useMemo(()=>{if(ct==null)return normalizeTokens_default([it]);const ut={code:it,grammar:ct,language:dt,tokens:[]};return rt.hooks.run("before-tokenize",ut),ut.tokens=rt.tokenize(it,ct),rt.hooks.run("after-tokenize",ut),normalizeTokens_default(ut.tokens)},[it,ct,dt,rt]),themeToDict=(rt,it)=>{const{plain:ct}=rt,dt=rt.styles.reduce((ut,pt)=>{const{languages:yt,style:ft}=pt;return yt&&!yt.includes(it)||pt.types.forEach(mt=>{const kt=__spreadValues(__spreadValues({},ut[mt]),ft);ut[mt]=kt}),ut},{});return dt.root=ct,dt.plain=__spreadProps(__spreadValues({},ct),{backgroundColor:void 0}),dt},themeToDict_default=themeToDict,Highlight=({children:rt,language:it,code:ct,theme:dt,prism:ut})=>{const pt=it.toLowerCase(),yt=themeToDict_default(dt,pt),ft=useGetLineProps(yt),mt=useGetTokenProps(yt),kt=ut.languages[pt],_t=useTokenize({prism:ut,language:pt,code:ct,grammar:kt});return rt({tokens:_t,className:`prism-code language-${pt}`,style:yt!=null?yt.root:{},getLineProps:ft,getTokenProps:mt})},Highlight2=rt=>reactExports.createElement(Highlight,__spreadProps(__spreadValues({},rt),{prism:rt.prism||Prism$1,theme:rt.theme||vsDark_default,code:rt.code,language:rt.language}));var prism={exports:{}},hasRequiredPrism;function requirePrism(){return hasRequiredPrism||(hasRequiredPrism=1,(function(rt){var it=typeof window<"u"?window:typeof WorkerGlobalScope<"u"&&self instanceof WorkerGlobalScope?self:{};var ct=(function(dt){var ut=/(?:^|\s)lang(?:uage)?-([\w-]+)(?=\s|$)/i,pt=0,yt={},ft={manual:dt.Prism&&dt.Prism.manual,disableWorkerMessageHandler:dt.Prism&&dt.Prism.disableWorkerMessageHandler,util:{encode:function $t(Et){return Et instanceof mt?new mt(Et.type,$t(Et.content),Et.alias):Array.isArray(Et)?Et.map($t):Et.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/\u00a0/g," ")},type:function($t){return Object.prototype.toString.call($t).slice(8,-1)},objId:function($t){return $t.__id||Object.defineProperty($t,"__id",{value:++pt}),$t.__id},clone:function $t(Et,Ft){Ft=Ft||{};var qt,Ht;switch(ft.util.type(Et)){case"Object":if(Ht=ft.util.objId(Et),Ft[Ht])return Ft[Ht];qt={},Ft[Ht]=qt;for(var Ot in Et)Et.hasOwnProperty(Ot)&&(qt[Ot]=$t(Et[Ot],Ft));return qt;case"Array":return Ht=ft.util.objId(Et),Ft[Ht]?Ft[Ht]:(qt=[],Ft[Ht]=qt,Et.forEach(function(Zt,Yt){qt[Yt]=$t(Zt,Ft)}),qt);default:return Et}},getLanguage:function($t){for(;$t;){var Et=ut.exec($t.className);if(Et)return Et[1].toLowerCase();$t=$t.parentElement}return"none"},setLanguage:function($t,Et){$t.className=$t.className.replace(RegExp(ut,"gi"),""),$t.classList.add("language-"+Et)},currentScript:function(){if(typeof document>"u")return null;if(document.currentScript&&document.currentScript.tagName==="SCRIPT")return document.currentScript;try{throw new Error}catch(qt){var $t=(/at [^(\r\n]*\((.*):[^:]+:[^:]+\)$/i.exec(qt.stack)||[])[1];if($t){var Et=document.getElementsByTagName("script");for(var Ft in Et)if(Et[Ft].src==$t)return Et[Ft]}return null}},isActive:function($t,Et,Ft){for(var qt="no-"+Et;$t;){var Ht=$t.classList;if(Ht.contains(Et))return!0;if(Ht.contains(qt))return!1;$t=$t.parentElement}return!!Ft}},languages:{plain:yt,plaintext:yt,text:yt,txt:yt,extend:function($t,Et){var Ft=ft.util.clone(ft.languages[$t]);for(var qt in Et)Ft[qt]=Et[qt];return Ft},insertBefore:function($t,Et,Ft,qt){qt=qt||ft.languages;var Ht=qt[$t],Ot={};for(var Zt in Ht)if(Ht.hasOwnProperty(Zt)){if(Zt==Et)for(var Yt in Ft)Ft.hasOwnProperty(Yt)&&(Ot[Yt]=Ft[Yt]);Ft.hasOwnProperty(Zt)||(Ot[Zt]=Ht[Zt])}var aa=qt[$t];return qt[$t]=Ot,ft.languages.DFS(ft.languages,function(Qt,oa){oa===aa&&Qt!=$t&&(this[Qt]=Ot)}),Ot},DFS:function $t(Et,Ft,qt,Ht){Ht=Ht||{};var Ot=ft.util.objId;for(var Zt in Et)if(Et.hasOwnProperty(Zt)){Ft.call(Et,Zt,Et[Zt],qt||Zt);var Yt=Et[Zt],aa=ft.util.type(Yt);aa==="Object"&&!Ht[Ot(Yt)]?(Ht[Ot(Yt)]=!0,$t(Yt,Ft,null,Ht)):aa==="Array"&&!Ht[Ot(Yt)]&&(Ht[Ot(Yt)]=!0,$t(Yt,Ft,Zt,Ht))}}},plugins:{},highlightAll:function($t,Et){ft.highlightAllUnder(document,$t,Et)},highlightAllUnder:function($t,Et,Ft){var qt={callback:Ft,container:$t,selector:'code[class*="language-"], [class*="language-"] code, code[class*="lang-"], [class*="lang-"] code'};ft.hooks.run("before-highlightall",qt),qt.elements=Array.prototype.slice.apply(qt.container.querySelectorAll(qt.selector)),ft.hooks.run("before-all-elements-highlight",qt);for(var Ht=0,Ot;Ot=qt.elements[Ht++];)ft.highlightElement(Ot,Et===!0,qt.callback)},highlightElement:function($t,Et,Ft){var qt=ft.util.getLanguage($t),Ht=ft.languages[qt];ft.util.setLanguage($t,qt);var Ot=$t.parentElement;Ot&&Ot.nodeName.toLowerCase()==="pre"&&ft.util.setLanguage(Ot,qt);var Zt=$t.textContent,Yt={element:$t,language:qt,grammar:Ht,code:Zt};function aa(oa){Yt.highlightedCode=oa,ft.hooks.run("before-insert",Yt),Yt.element.innerHTML=Yt.highlightedCode,ft.hooks.run("after-highlight",Yt),ft.hooks.run("complete",Yt),Ft&&Ft.call(Yt.element)}if(ft.hooks.run("before-sanity-check",Yt),Ot=Yt.element.parentElement,Ot&&Ot.nodeName.toLowerCase()==="pre"&&!Ot.hasAttribute("tabindex")&&Ot.setAttribute("tabindex","0"),!Yt.code){ft.hooks.run("complete",Yt),Ft&&Ft.call(Yt.element);return}if(ft.hooks.run("before-highlight",Yt),!Yt.grammar){aa(ft.util.encode(Yt.code));return}if(Et&&dt.Worker){var Qt=new Worker(ft.filename);Qt.onmessage=function(oa){aa(oa.data)},Qt.postMessage(JSON.stringify({language:Yt.language,code:Yt.code,immediateClose:!0}))}else aa(ft.highlight(Yt.code,Yt.grammar,Yt.language))},highlight:function($t,Et,Ft){var qt={code:$t,grammar:Et,language:Ft};if(ft.hooks.run("before-tokenize",qt),!qt.grammar)throw new Error('The language "'+qt.language+'" has no grammar.');return qt.tokens=ft.tokenize(qt.code,qt.grammar),ft.hooks.run("after-tokenize",qt),mt.stringify(ft.util.encode(qt.tokens),qt.language)},tokenize:function($t,Et){var Ft=Et.rest;if(Ft){for(var qt in Ft)Et[qt]=Ft[qt];delete Et.rest}var Ht=new vt;return bt(Ht,Ht.head,$t),_t($t,Ht,Et,Ht.head,0),wt(Ht)},hooks:{all:{},add:function($t,Et){var Ft=ft.hooks.all;Ft[$t]=Ft[$t]||[],Ft[$t].push(Et)},run:function($t,Et){var Ft=ft.hooks.all[$t];if(!(!Ft||!Ft.length))for(var qt=0,Ht;Ht=Ft[qt++];)Ht(Et)}},Token:mt};dt.Prism=ft;function mt($t,Et,Ft,qt){this.type=$t,this.content=Et,this.alias=Ft,this.length=(qt||"").length|0}mt.stringify=function $t(Et,Ft){if(typeof Et=="string")return Et;if(Array.isArray(Et)){var qt="";return Et.forEach(function(aa){qt+=$t(aa,Ft)}),qt}var Ht={type:Et.type,content:$t(Et.content,Ft),tag:"span",classes:["token",Et.type],attributes:{},language:Ft},Ot=Et.alias;Ot&&(Array.isArray(Ot)?Array.prototype.push.apply(Ht.classes,Ot):Ht.classes.push(Ot)),ft.hooks.run("wrap",Ht);var Zt="";for(var Yt in Ht.attributes)Zt+=" "+Yt+'="'+(Ht.attributes[Yt]||"").replace(/"/g,"&quot;")+'"';return"<"+Ht.tag+' class="'+Ht.classes.join(" ")+'"'+Zt+">"+Ht.content+"</"+Ht.tag+">"};function kt($t,Et,Ft,qt){$t.lastIndex=Et;var Ht=$t.exec(Ft);if(Ht&&qt&&Ht[1]){var Ot=Ht[1].length;Ht.index+=Ot,Ht[0]=Ht[0].slice(Ot)}return Ht}function _t($t,Et,Ft,qt,Ht,Ot){for(var Zt in Ft)if(!(!Ft.hasOwnProperty(Zt)||!Ft[Zt])){var Yt=Ft[Zt];Yt=Array.isArray(Yt)?Yt:[Yt];for(var aa=0;aa<Yt.length;++aa){if(Ot&&Ot.cause==Zt+","+aa)return;var Qt=Yt[aa],oa=Qt.inside,la=!!Qt.lookbehind,Kt=!!Qt.greedy,ra=Qt.alias;if(Kt&&!Qt.pattern.global){var Ut=Qt.pattern.toString().match(/[imsuy]*$/)[0];Qt.pattern=RegExp(Qt.pattern.source,Ut+"g")}for(var ea=Qt.pattern||Qt,Gt=qt.next,_a=Ht;Gt!==Et.tail&&!(Ot&&_a>=Ot.reach);_a+=Gt.value.length,Gt=Gt.next){var Ca=Gt.value;if(Et.length>$t.length)return;if(!(Ca instanceof mt)){var Vt=1,ta;if(Kt){if(ta=kt(ea,_a,$t,la),!ta||ta.index>=$t.length)break;var $a=ta.index,sa=ta.index+ta[0].length,xa=_a;for(xa+=Gt.value.length;$a>=xa;)Gt=Gt.next,xa+=Gt.value.length;if(xa-=Gt.value.length,_a=xa,Gt.value instanceof mt)continue;for(var ka=Gt;ka!==Et.tail&&(xa<sa||typeof ka.value=="string");ka=ka.next)Vt++,xa+=ka.value.length;Vt--,Ca=$t.slice(_a,xa),ta.index-=_a}else if(ta=kt(ea,0,Ca,la),!ta)continue;var $a=ta.index,Na=ta[0],Fa=Ca.slice(0,$a),qa=Ca.slice($a+Na.length),Ha=_a+Ca.length;Ot&&Ha>Ot.reach&&(Ot.reach=Ha);var rn=Gt.prev;Fa&&(rn=bt(Et,rn,Fa),_a+=Fa.length),Mt(Et,rn,Vt);var hn=new mt(Zt,oa?ft.tokenize(Na,oa):Na,ra,Na);if(Gt=bt(Et,rn,hn),qa&&bt(Et,Gt,qa),Vt>1){var Ja={cause:Zt+","+aa,reach:Ha};_t($t,Et,Ft,Gt.prev,_a,Ja),Ot&&Ja.reach>Ot.reach&&(Ot.reach=Ja.reach)}}}}}}function vt(){var $t={value:null,prev:null,next:null},Et={value:null,prev:$t,next:null};$t.next=Et,this.head=$t,this.tail=Et,this.length=0}function bt($t,Et,Ft){var qt=Et.next,Ht={value:Ft,prev:Et,next:qt};return Et.next=Ht,qt.prev=Ht,$t.length++,Ht}function Mt($t,Et,Ft){for(var qt=Et.next,Ht=0;Ht<Ft&&qt!==$t.tail;Ht++)qt=qt.next;Et.next=qt,qt.prev=Et,$t.length-=Ht}function wt($t){for(var Et=[],Ft=$t.head.next;Ft!==$t.tail;)Et.push(Ft.value),Ft=Ft.next;return Et}if(!dt.document)return dt.addEventListener&&(ft.disableWorkerMessageHandler||dt.addEventListener("message",function($t){var Et=JSON.parse($t.data),Ft=Et.language,qt=Et.code,Ht=Et.immediateClose;dt.postMessage(ft.highlight(qt,ft.languages[Ft],Ft)),Ht&&dt.close()},!1)),ft;var St=ft.util.currentScript();St&&(ft.filename=St.src,St.hasAttribute("data-manual")&&(ft.manual=!0));function It(){ft.manual||ft.highlightAll()}if(!ft.manual){var Nt=document.readyState;Nt==="loading"||Nt==="interactive"&&St&&St.defer?document.addEventListener("DOMContentLoaded",It):window.requestAnimationFrame?window.requestAnimationFrame(It):window.setTimeout(It,16)}return ft})(it);rt.exports&&(rt.exports=ct),typeof globalThis<"u"&&(globalThis.Prism=ct),ct.languages.markup={comment:{pattern:/<!--(?:(?!<!--)[\s\S])*?-->/,greedy:!0},prolog:{pattern:/<\?[\s\S]+?\?>/,greedy:!0},doctype:{pattern:/<!DOCTYPE(?:[^>"'[\]]|"[^"]*"|'[^']*')+(?:\[(?:[^<"'\]]|"[^"]*"|'[^']*'|<(?!!--)|<!--(?:[^-]|-(?!->))*-->)*\]\s*)?>/i,greedy:!0,inside:{"internal-subset":{pattern:/(^[^\[]*\[)[\s\S]+(?=\]>$)/,lookbehind:!0,greedy:!0,inside:null},string:{pattern:/"[^"]*"|'[^']*'/,greedy:!0},punctuation:/^<!|>$|[[\]]/,"doctype-tag":/^DOCTYPE/i,name:/[^\s<>'"]+/}},cdata:{pattern:/<!\[CDATA\[[\s\S]*?\]\]>/i,greedy:!0},tag:{pattern:/<\/?(?!\d)[^\s>\/=$<%]+(?:\s(?:\s*[^\s>\/=]+(?:\s*=\s*(?:"[^"]*"|'[^']*'|[^\s'">=]+(?=[\s>]))|(?=[\s/>])))+)?\s*\/?>/,greedy:!0,inside:{tag:{pattern:/^<\/?[^\s>\/]+/,inside:{punctuation:/^<\/?/,namespace:/^[^\s>\/:]+:/}},"special-attr":[],"attr-value":{pattern:/=\s*(?:"[^"]*"|'[^']*'|[^\s'">=]+)/,inside:{punctuation:[{pattern:/^=/,alias:"attr-equals"},{pattern:/^(\s*)["']|["']$/,lookbehind:!0}]}},punctuation:/\/?>/,"attr-name":{pattern:/[^\s>\/]+/,inside:{namespace:/^[^\s>\/:]+:/}}}},entity:[{pattern:/&[\da-z]{1,8};/i,alias:"named-entity"},/&#x?[\da-f]{1,8};/i]},ct.languages.markup.tag.inside["attr-value"].inside.entity=ct.languages.markup.entity,ct.languages.markup.doctype.inside["internal-subset"].inside=ct.languages.markup,ct.hooks.add("wrap",function(dt){dt.type==="entity"&&(dt.attributes.title=dt.content.replace(/&amp;/,"&"))}),Object.defineProperty(ct.languages.markup.tag,"addInlined",{value:function(ut,pt){var yt={};yt["language-"+pt]={pattern:/(^<!\[CDATA\[)[\s\S]+?(?=\]\]>$)/i,lookbehind:!0,inside:ct.languages[pt]},yt.cdata=/^<!\[CDATA\[|\]\]>$/i;var ft={"included-cdata":{pattern:/<!\[CDATA\[[\s\S]*?\]\]>/i,inside:yt}};ft["language-"+pt]={pattern:/[\s\S]+/,inside:ct.languages[pt]};var mt={};mt[ut]={pattern:RegExp(/(<__[^>]*>)(?:<!\[CDATA\[(?:[^\]]|\](?!\]>))*\]\]>|(?!<!\[CDATA\[)[\s\S])*?(?=<\/__>)/.source.replace(/__/g,function(){return ut}),"i"),lookbehind:!0,greedy:!0,inside:ft},ct.languages.insertBefore("markup","cdata",mt)}}),Object.defineProperty(ct.languages.markup.tag,"addAttribute",{value:function(dt,ut){ct.languages.markup.tag.inside["special-attr"].push({pattern:RegExp(/(^|["'\s])/.source+"(?:"+dt+")"+/\s*=\s*(?:"[^"]*"|'[^']*'|[^\s'">=]+(?=[\s>]))/.source,"i"),lookbehind:!0,inside:{"attr-name":/^[^\s=]+/,"attr-value":{pattern:/=[\s\S]+/,inside:{value:{pattern:/(^=\s*(["']|(?!["'])))\S[\s\S]*(?=\2$)/,lookbehind:!0,alias:[ut,"language-"+ut],inside:ct.languages[ut]},punctuation:[{pattern:/^=/,alias:"attr-equals"},/"|'/]}}}})}}),ct.languages.html=ct.languages.markup,ct.languages.mathml=ct.languages.markup,ct.languages.svg=ct.languages.markup,ct.languages.xml=ct.languages.extend("markup",{}),ct.languages.ssml=ct.languages.xml,ct.languages.atom=ct.languages.xml,ct.languages.rss=ct.languages.xml,(function(dt){var ut=/(?:"(?:\\(?:\r\n|[\s\S])|[^"\\\r\n])*"|'(?:\\(?:\r\n|[\s\S])|[^'\\\r\n])*')/;dt.languages.css={comment:/\/\*[\s\S]*?\*\//,atrule:{pattern:RegExp("@[\\w-](?:"+/[^;{\s"']|\s+(?!\s)/.source+"|"+ut.source+")*?"+/(?:;|(?=\s*\{))/.source),inside:{rule:/^@[\w-]+/,"selector-function-argument":{pattern:/(\bselector\s*\(\s*(?![\s)]))(?:[^()\s]|\s+(?![\s)])|\((?:[^()]|\([^()]*\))*\))+(?=\s*\))/,lookbehind:!0,alias:"selector"},keyword:{pattern:/(^|[^\w-])(?:and|not|only|or)(?![\w-])/,lookbehind:!0}}},url:{pattern:RegExp("\\burl\\((?:"+ut.source+"|"+/(?:[^\\\r\n()"']|\\[\s\S])*/.source+")\\)","i"),greedy:!0,inside:{function:/^url/i,punctuation:/^\(|\)$/,string:{pattern:RegExp("^"+ut.source+"$"),alias:"url"}}},selector:{pattern:RegExp(`(^|[{}\\s])[^{}\\s](?:[^{};"'\\s]|\\s+(?![\\s{])|`+ut.source+")*(?=\\s*\\{)"),lookbehind:!0},string:{pattern:ut,greedy:!0},property:{pattern:/(^|[^-\w\xA0-\uFFFF])(?!\s)[-_a-z\xA0-\uFFFF](?:(?!\s)[-\w\xA0-\uFFFF])*(?=\s*:)/i,lookbehind:!0},important:/!important\b/i,function:{pattern:/(^|[^-a-z0-9])[-a-z0-9]+(?=\()/i,lookbehind:!0},punctuation:/[(){};:,]/},dt.languages.css.atrule.inside.rest=dt.languages.css;var pt=dt.languages.markup;pt&&(pt.tag.addInlined("style","css"),pt.tag.addAttribute("style","css"))})(ct),ct.languages.clike={comment:[{pattern:/(^|[^\\])\/\*[\s\S]*?(?:\*\/|$)/,lookbehind:!0,greedy:!0},{pattern:/(^|[^\\:])\/\/.*/,lookbehind:!0,greedy:!0}],string:{pattern:/(["'])(?:\\(?:\r\n|[\s\S])|(?!\1)[^\\\r\n])*\1/,greedy:!0},"class-name":{pattern:/(\b(?:class|extends|implements|instanceof|interface|new|trait)\s+|\bcatch\s+\()[\w.\\]+/i,lookbehind:!0,inside:{punctuation:/[.\\]/}},keyword:/\b(?:break|catch|continue|do|else|finally|for|function|if|in|instanceof|new|null|return|throw|try|while)\b/,boolean:/\b(?:false|true)\b/,function:/\b\w+(?=\()/,number:/\b0x[\da-f]+\b|(?:\b\d+(?:\.\d*)?|\B\.\d+)(?:e[+-]?\d+)?/i,operator:/[<>]=?|[!=]=?=?|--?|\+\+?|&&?|\|\|?|[?*/~^%]/,punctuation:/[{}[\];(),.:]/},ct.languages.javascript=ct.languages.extend("clike",{"class-name":[ct.languages.clike["class-name"],{pattern:/(^|[^$\w\xA0-\uFFFF])(?!\s)[_$A-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?=\.(?:constructor|prototype))/,lookbehind:!0}],keyword:[{pattern:/((?:^|\})\s*)catch\b/,lookbehind:!0},{pattern:/(^|[^.]|\.\.\.\s*)\b(?:as|assert(?=\s*\{)|async(?=\s*(?:function\b|\(|[$\w\xA0-\uFFFF]|$))|await|break|case|class|const|continue|debugger|default|delete|do|else|enum|export|extends|finally(?=\s*(?:\{|$))|for|from(?=\s*(?:['"]|$))|function|(?:get|set)(?=\s*(?:[#\[$\w\xA0-\uFFFF]|$))|if|implements|import|in|instanceof|interface|let|new|null|of|package|private|protected|public|return|static|super|switch|this|throw|try|typeof|undefined|var|void|while|with|yield)\b/,lookbehind:!0}],function:/#?(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?=\s*(?:\.\s*(?:apply|bind|call)\s*)?\()/,number:{pattern:RegExp(/(^|[^\w$])/.source+"(?:"+(/NaN|Infinity/.source+"|"+/0[bB][01]+(?:_[01]+)*n?/.source+"|"+/0[oO][0-7]+(?:_[0-7]+)*n?/.source+"|"+/0[xX][\dA-Fa-f]+(?:_[\dA-Fa-f]+)*n?/.source+"|"+/\d+(?:_\d+)*n/.source+"|"+/(?:\d+(?:_\d+)*(?:\.(?:\d+(?:_\d+)*)?)?|\.\d+(?:_\d+)*)(?:[Ee][+-]?\d+(?:_\d+)*)?/.source)+")"+/(?![\w$])/.source),lookbehind:!0},operator:/--|\+\+|\*\*=?|=>|&&=?|\|\|=?|[!=]==|<<=?|>>>?=?|[-+*/%&|^!=<>]=?|\.{3}|\?\?=?|\?\.?|[~:]/}),ct.languages.javascript["class-name"][0].pattern=/(\b(?:class|extends|implements|instanceof|interface|new)\s+)[\w.\\]+/,ct.languages.insertBefore("javascript","keyword",{regex:{pattern:RegExp(/((?:^|[^$\w\xA0-\uFFFF."'\])\s]|\b(?:return|yield))\s*)/.source+/\//.source+"(?:"+/(?:\[(?:[^\]\\\r\n]|\\.)*\]|\\.|[^/\\\[\r\n])+\/[dgimyus]{0,7}/.source+"|"+/(?:\[(?:[^[\]\\\r\n]|\\.|\[(?:[^[\]\\\r\n]|\\.|\[(?:[^[\]\\\r\n]|\\.)*\])*\])*\]|\\.|[^/\\\[\r\n])+\/[dgimyus]{0,7}v[dgimyus]{0,7}/.source+")"+/(?=(?:\s|\/\*(?:[^*]|\*(?!\/))*\*\/)*(?:$|[\r\n,.;:})\]]|\/\/))/.source),lookbehind:!0,greedy:!0,inside:{"regex-source":{pattern:/^(\/)[\s\S]+(?=\/[a-z]*$)/,lookbehind:!0,alias:"language-regex",inside:ct.languages.regex},"regex-delimiter":/^\/|\/$/,"regex-flags":/^[a-z]+$/}},"function-variable":{pattern:/#?(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?=\s*[=:]\s*(?:async\s*)?(?:\bfunction\b|(?:\((?:[^()]|\([^()]*\))*\)|(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*)\s*=>))/,alias:"function"},parameter:[{pattern:/(function(?:\s+(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*)?\s*\(\s*)(?!\s)(?:[^()\s]|\s+(?![\s)])|\([^()]*\))+(?=\s*\))/,lookbehind:!0,inside:ct.languages.javascript},{pattern:/(^|[^$\w\xA0-\uFFFF])(?!\s)[_$a-z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?=\s*=>)/i,lookbehind:!0,inside:ct.languages.javascript},{pattern:/(\(\s*)(?!\s)(?:[^()\s]|\s+(?![\s)])|\([^()]*\))+(?=\s*\)\s*=>)/,lookbehind:!0,inside:ct.languages.javascript},{pattern:/((?:\b|\s|^)(?!(?:as|async|await|break|case|catch|class|const|continue|debugger|default|delete|do|else|enum|export|extends|finally|for|from|function|get|if|implements|import|in|instanceof|interface|let|new|null|of|package|private|protected|public|return|set|static|super|switch|this|throw|try|typeof|undefined|var|void|while|with|yield)(?![$\w\xA0-\uFFFF]))(?:(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*\s*)\(\s*|\]\s*\(\s*)(?!\s)(?:[^()\s]|\s+(?![\s)])|\([^()]*\))+(?=\s*\)\s*\{)/,lookbehind:!0,inside:ct.languages.javascript}],constant:/\b[A-Z](?:[A-Z_]|\dx?)*\b/}),ct.languages.insertBefore("javascript","string",{hashbang:{pattern:/^#!.*/,greedy:!0,alias:"comment"},"template-string":{pattern:/`(?:\\[\s\S]|\$\{(?:[^{}]|\{(?:[^{}]|\{[^}]*\})*\})+\}|(?!\$\{)[^\\`])*`/,greedy:!0,inside:{"template-punctuation":{pattern:/^`|`$/,alias:"string"},interpolation:{pattern:/((?:^|[^\\])(?:\\{2})*)\$\{(?:[^{}]|\{(?:[^{}]|\{[^}]*\})*\})+\}/,lookbehind:!0,inside:{"interpolation-punctuation":{pattern:/^\$\{|\}$/,alias:"punctuation"},rest:ct.languages.javascript}},string:/[\s\S]+/}},"string-property":{pattern:/((?:^|[,{])[ \t]*)(["'])(?:\\(?:\r\n|[\s\S])|(?!\2)[^\\\r\n])*\2(?=\s*:)/m,lookbehind:!0,greedy:!0,alias:"property"}}),ct.languages.insertBefore("javascript","operator",{"literal-property":{pattern:/((?:^|[,{])[ \t]*)(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?=\s*:)/m,lookbehind:!0,alias:"property"}}),ct.languages.markup&&(ct.languages.markup.tag.addInlined("script","javascript"),ct.languages.markup.tag.addAttribute(/on(?:abort|blur|change|click|composition(?:end|start|update)|dblclick|error|focus(?:in|out)?|key(?:down|up)|load|mouse(?:down|enter|leave|move|out|over|up)|reset|resize|scroll|select|slotchange|submit|unload|wheel)/.source,"javascript")),ct.languages.js=ct.languages.javascript,(function(){if(typeof ct>"u"||typeof document>"u")return;Element.prototype.matches||(Element.prototype.matches=Element.prototype.msMatchesSelector||Element.prototype.webkitMatchesSelector);var dt="Loading…",ut=function(St,It){return"✖ Error "+St+" while fetching file: "+It},pt="✖ Error: File does not exist or is empty",yt={js:"javascript",py:"python",rb:"ruby",ps1:"powershell",psm1:"powershell",sh:"bash",bat:"batch",h:"c",tex:"latex"},ft="data-src-status",mt="loading",kt="loaded",_t="failed",vt="pre[data-src]:not(["+ft+'="'+kt+'"]):not(['+ft+'="'+mt+'"])';function bt(St,It,Nt){var $t=new XMLHttpRequest;$t.open("GET",St,!0),$t.onreadystatechange=function(){$t.readyState==4&&($t.status<400&&$t.responseText?It($t.responseText):$t.status>=400?Nt(ut($t.status,$t.statusText)):Nt(pt))},$t.send(null)}function Mt(St){var It=/^\s*(\d+)\s*(?:(,)\s*(?:(\d+)\s*)?)?$/.exec(St||"");if(It){var Nt=Number(It[1]),$t=It[2],Et=It[3];return $t?Et?[Nt,Number(Et)]:[Nt,void 0]:[Nt,Nt]}}ct.hooks.add("before-highlightall",function(St){St.selector+=", "+vt}),ct.hooks.add("before-sanity-check",function(St){var It=St.element;if(It.matches(vt)){St.code="",It.setAttribute(ft,mt);var Nt=It.appendChild(document.createElement("CODE"));Nt.textContent=dt;var $t=It.getAttribute("data-src"),Et=St.language;if(Et==="none"){var Ft=(/\.(\w+)$/.exec($t)||[,"none"])[1];Et=yt[Ft]||Ft}ct.util.setLanguage(Nt,Et),ct.util.setLanguage(It,Et);var qt=ct.plugins.autoloader;qt&&qt.loadLanguages(Et),bt($t,function(Ht){It.setAttribute(ft,kt);var Ot=Mt(It.getAttribute("data-range"));if(Ot){var Zt=Ht.split(/\r\n?|\n/g),Yt=Ot[0],aa=Ot[1]==null?Zt.length:Ot[1];Yt<0&&(Yt+=Zt.length),Yt=Math.max(0,Math.min(Yt-1,Zt.length)),aa<0&&(aa+=Zt.length),aa=Math.max(0,Math.min(aa,Zt.length)),Ht=Zt.slice(Yt,aa).join(`
-`),It.hasAttribute("data-start")||It.setAttribute("data-start",String(Yt+1))}Nt.textContent=Ht,ct.highlightElement(Nt)},function(Ht){It.setAttribute(ft,_t),Nt.textContent=Ht})}}),ct.plugins.fileHighlight={highlight:function(It){for(var Nt=(It||document).querySelectorAll(vt),$t=0,Et;Et=Nt[$t++];)ct.highlightElement(Et)}};var wt=!1;ct.fileHighlight=function(){wt||(console.warn("Prism.fileHighlight is deprecated. Use `Prism.plugins.fileHighlight.highlight` instead."),wt=!0),ct.plugins.fileHighlight.highlight.apply(this,arguments)}})()})(prism)),prism.exports}var prismExports=requirePrism();const Prism=getDefaultExportFromCjs(prismExports),cyberTheme={plain:{color:"#e2e8f0",backgroundColor:"transparent"},styles:[{types:["comment","prolog","doctype","cdata"],style:{color:"#64748b",fontStyle:"italic"}},{types:["punctuation"],style:{color:"#94a3b8"}},{types:["namespace"],style:{opacity:.7}},{types:["property","tag","boolean","number","constant","symbol","deleted"],style:{color:"#f472b6"}},{types:["selector","attr-name","string","char","builtin","inserted"],style:{color:"#a78bfa"}},{types:["operator","entity","url"],style:{color:"#60a5fa"}},{types:["atrule","attr-value","keyword"],style:{color:"#818cf8"}},{types:["function","class-name"],style:{color:"#38bdf8"}},{types:["regex","important","variable"],style:{color:"#fb7185"}}]};typeof window<"u"&&(window.Prism=Prism);Prism.manual=!0;let prismInitPromise=null,prismReady=!1;const initPrismSync=()=>{if(typeof window>"u")return!1;try{return window.Prism=Prism,Prism.manual=!0,Prism.languages.yaml||(Prism.languages.yaml={scalar:{pattern:/([^\s\x00-\x08\x0E-\x1F",[\]{}]|'(?:[^']|'')*'|"(?:\\.|[^\\"])*")(?:\s*(?:$|#))/,lookbehind:!0,alias:"string"},comment:/#.*/,key:{pattern:/(\s*(?:^|[:\-?\s])\s*)[^\s\x00-\x08\x0E-\x1F,[\]{}][^\s\x00-\x08\x0E-\x1F",[\]{}]*(?:\s+[^\s\x00-\x08\x0E-\x1F",[\]{}][^\s\x00-\x08\x0E-\x1F",[\]{}]*)*\s*(?=\s*:)/,lookbehind:!0,alias:"property"},directive:{pattern:/^%\w.*$/m,alias:"important"},datetime:{pattern:/([:\-?\s]\s*)([0-9]{4}-[0-9]{1,2}-[0-9]{1,2}([Tt ][0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}(\.[0-9]+)?([ ]?[+-][0-9]{1,2}:[0-9]{1,2}|Z)?)?)/,lookbehind:!0,alias:"number"},boolean:{pattern:/([:\-?\s]\s*)(?:true|false|yes|no|on|off)(?=\s*$)/m,lookbehind:!0,alias:"important"},null:{pattern:/([:\-?\s]\s*)(?:null|~)(?=\s*$)/m,lookbehind:!0,alias:"important"},string:{pattern:/([:\-?\s]\s*)(?:"(?:\\.|[^\\"])*"|'(?:[^']|'')*')(?=\s*$)/m,lookbehind:!0},number:{pattern:/([:\-?\s]\s*)[-+]?[0-9]+(?:\.[0-9]+)?(?:[eE][-+]?[0-9]+)?(?=\s*$)/m,lookbehind:!0},tag:/![^\s]+/,important:/[&*][^\s]+/,punctuation:/---|[[\]{},]/}),Prism.languages.protobuf||(Prism.languages.protobuf={comment:[/\/\/.*$/m,/\/\*[\s\S]*?\*\//],string:{pattern:/"(?:\\.|[^\\"\r\n])*"/,greedy:!0},keyword:/\b(?:syntax|import|package|option|message|enum|service|rpc|returns|repeated|optional|required|oneof|map|reserved|extensions|extend|group)\b/,builtin:/\b(?:double|float|int32|int64|uint32|uint64|sint32|sint64|fixed32|fixed64|sfixed32|sfixed64|bool|string|bytes)\b/,number:/\b(?:0x[\da-f]+|\d*\.?\d+(?:e[+-]?\d+)?)\b/i,boolean:/\b(?:true|false)\b/,operator:/[=;]/,punctuation:/[{}[\](),]/}),Prism.languages.yaml&&(Prism.languages.yml=Prism.languages.yaml),Prism.languages.protobuf&&(Prism.languages.proto=Prism.languages.protobuf),prismReady=!0,!0}catch(rt){return console.warn("Prism sync init failed:",rt),!1}},usePrism=()=>{const[rt,it]=reactExports.useState(prismReady);return reactExports.useEffect(()=>{if(!(typeof window>"u")){if(!prismReady&&initPrismSync()){it(!0);return}prismInitPromise||(window.Prism=Prism,Prism.manual=!0,prismInitPromise=Promise.all([__vitePreload(()=>import("./prism-protobuf-DiQ_z8B5.js"),[]),__vitePreload(()=>import("./prism-yaml-Chm5ZdEN.js"),[]),__vitePreload(()=>import("./prism-bash-DTkDXsAh.js"),[]),__vitePreload(()=>import("./prism-go-CyY0RbE6.js"),[]),__vitePreload(()=>import("./prism-json-xwnKirkR.js"),[])]).then(()=>{Prism.languages.protobuf&&(Prism.languages.proto=Prism.languages.protobuf),Prism.languages.bash&&(Prism.languages.sh=Prism.languages.bash,Prism.languages.shell=Prism.languages.bash),Prism.languages.yaml&&(Prism.languages.yml=Prism.languages.yaml),prismReady=!0}).catch(ct=>{console.error("Prism async init failed:",ct),initPrismSync(),prismReady=!0})),prismInitPromise.then(()=>it(!0))}},[]),rt||prismReady};function CodeBlock({children:rt="",className:it="",language:ct,hasFocus:dt=!1,focusLines:ut=[]}){const[pt,yt]=reactExports.useState(!1);usePrism();let ft=ct||it.replace(/language-/,"")||"text";if(ft==="proto"&&(ft="protobuf"),(ft==="text"||ft==="")&&rt){const St=rt.toLowerCase().trim(),It=rt.trim();/syntax\s*=\s*["']proto[23]?["']/i.test(It)||/import\s+["'][^"']+\.proto["']/i.test(It)||/package\s+[\w.]+;/i.test(It)||/^\s*option\s+\w+/m.test(It)||/^\s*message\s+\w+\s*\{/m.test(It)&&/^\s*\w+\s+\w+\s*=\s*\d+;/m.test(It)||/^\s*enum\s+\w+\s*\{/m.test(It)&&/^\s*\w+\s*=\s*\d+;/m.test(It)||/^\s*service\s+\w+\s*\{/m.test(It)&&/^\s*rpc\s+\w+/m.test(It)||/^\s*syntax\s*=.*proto/mi.test(It)?ft="protobuf":/func\s+main\s*\(\s*\)/m.test(It)||/^\s*package\s+\w+\s*$/m.test(It)&&!St.includes(".proto")&&!St.includes("syntax")||/^\s*func\s+[\w\(\)]*\s*\w+\([^)]*\)\s*(\([^)]*\))?\s*\{?/m.test(It)||/^\s*import\s+\(/m.test(It)||/import\s+"(fmt|log|net|context|errors|strings|bytes|io|os|time|math|sync|reflect|encoding|crypto|database|testing)"/m.test(It)||/\w+\s*:=/m.test(It)||/^\s*defer\s+/m.test(It)||/^\s*go\s+func/m.test(It)||/make\(chan\s+/i.test(It)||/interface\s*\{\s*\}/i.test(It)||/^\s*type\s+\w+\s+struct\s*\{/m.test(It)||/if\s+err\s*!=\s*nil\s*\{/i.test(It)||/context\.(Background|TODO|WithCancel|WithTimeout)/i.test(It)||/^\s*func\s*\(\s*\w+\s+[\*\w]+\s*\)\s*\w+/m.test(It)?ft="go":St.includes("version:")||St.includes("lint:")||St.includes("use:")||St.includes("generate:")||St.includes("deps:")||St.includes("plugins:")||St.includes("breaking:")||St.includes("ignore:")||St.includes("except:")||St.includes("ignore_only:")||/^\s*[\w-]+:\s*/m.test(It)||/^\s*-\s+/.test(It)||St.includes("_suffix:")||St.includes("_prefix:")||/:\s*(true|false|yes|no)\s*$/m.test(It)?ft="yaml":St.includes("easyp ")||St.startsWith("npm ")||St.startsWith("go ")&&!St.includes("func")||St.startsWith("$ ")||St.startsWith("brew ")||St.includes("#!/bin/")||/^[\$#]\s+/.test(It)||St.includes("docker ")||St.includes("git ")?ft="bash":St.startsWith("{")&&St.endsWith("}")||St.startsWith("[")&&St.endsWith("]")||/^\s*["{[]/.test(It)?ft="json":(St.includes("=")&&St.includes(":")||/^\w+\s*[:=]\s*.+$/m.test(It))&&(ft="yaml")}const mt={protobuf:"proto",yaml:"yaml",yml:"yaml",bash:"bash",shell:"bash",json:"json",go:"go"};ft==="protobuf"&&(!Prism.languages.protobuf||!Prism.languages.proto)&&initPrismSync(),ft==="go"&&!Prism.languages.go&&console.warn("Go language support not loaded, syntax highlighting may not work");const kt=mt[ft]||ft,_t=rt.trim(),{cleanCode:vt,parsedFocusLines:bt}=React.useMemo(()=>ut.length>0?{cleanCode:_t,parsedFocusLines:ut}:parseCodeFocus(_t),[_t,ut]),Mt=dt||bt.length>0,wt=()=>{navigator.clipboard.writeText(vt),yt(!0),setTimeout(()=>yt(!1),2e3)};return jsxRuntimeExports.jsxs("div",{className:`code-block group ${Mt?"code-block--with-focus":""} ${it}`,children:[jsxRuntimeExports.jsxs("div",{className:"flex items-center justify-between px-4 py-3 border-b border-white/5 bg-slate-900/50",children:[jsxRuntimeExports.jsxs("div",{className:"flex items-center gap-2",children:[jsxRuntimeExports.jsx("div",{className:"w-3 h-3 rounded-full bg-slate-700/50 group-hover:bg-red-500/80 transition-colors duration-300"}),jsxRuntimeExports.jsx("div",{className:"w-3 h-3 rounded-full bg-slate-700/50 group-hover:bg-yellow-500/80 transition-colors duration-300"}),jsxRuntimeExports.jsx("div",{className:"w-3 h-3 rounded-full bg-slate-700/50 group-hover:bg-green-500/80 transition-colors duration-300"})]}),jsxRuntimeExports.jsxs("div",{className:"absolute left-1/2 -translate-x-1/2 flex items-center gap-2 text-xs font-medium text-slate-500 font-mono",children:[jsxRuntimeExports.jsx(Terminal,{size:12}),jsxRuntimeExports.jsx("span",{className:"uppercase tracking-wider",children:kt==="proto"||kt==="protobuf"?"PROTOBUF":kt==="yaml"?"YAML":kt==="bash"?"BASH":kt==="json"?"JSON":kt==="go"?"GO":kt.toUpperCase()})]}),jsxRuntimeExports.jsxs("button",{onClick:wt,className:"flex items-center gap-2 px-3 py-1.5 text-xs text-slate-400 hover:text-white bg-slate-800/50 hover:bg-slate-700/50 border border-slate-600/30 hover:border-slate-500/50 rounded-md transition-all duration-200",children:[pt?jsxRuntimeExports.jsx(Check,{size:12}):jsxRuntimeExports.jsx(Copy,{size:12}),pt?"Copied":"Copy"]})]}),jsxRuntimeExports.jsx(Highlight2,{theme:cyberTheme,code:vt,language:kt,prism:Prism,children:({className:St,style:It,tokens:Nt,getTokenProps:$t})=>jsxRuntimeExports.jsx("pre",{className:`${St} code-pre`,style:{...It,background:"transparent"},children:Nt.map((Et,Ft)=>{const qt=Ft+1,Ht=bt.includes(qt),Ot=Mt&&!Ht;return jsxRuntimeExports.jsxs("div",{className:`
-                    code-line
-                    ${Ht?"line-focus":""}
-                    ${Ot?"line-dimmed":""}
-                  `.trim(),"data-line":qt,children:[jsxRuntimeExports.jsx("span",{className:"line-number",children:qt}),jsxRuntimeExports.jsx("span",{className:"line-content",children:Et.map((Zt,Yt)=>jsxRuntimeExports.jsx("span",{...$t({token:Zt})},Yt))})]},Ft)})})})]})}function InlineCode({children:rt}){usePrism();let it="text";return rt.includes("easyp")||rt.startsWith("npm")||rt.startsWith("go ")?it="bash":(rt.includes("message ")||rt.includes("service ")||rt.includes("rpc ")||/^[A-Z][a-zA-Z0-9_]*$/.test(rt))&&(it="protobuf"),jsxRuntimeExports.jsx(Highlight2,{theme:cyberTheme,code:rt,language:it,prism:Prism,children:({className:ct,style:dt,tokens:ut,getTokenProps:pt})=>jsxRuntimeExports.jsx("code",{className:`inline-code ${ct}`,style:{...dt,backgroundColor:"rgba(30, 41, 59, 0.5)"},children:ut.map((yt,ft)=>jsxRuntimeExports.jsx("span",{children:yt.map((mt,kt)=>jsxRuntimeExports.jsx("span",{...pt({token:mt})},kt))},ft))})})}function parseCodeFocus(rt){const it=rt.split(`
-`),ct=[],dt=[];return it.forEach((ut,pt)=>{const yt=pt+1,ft=[/\/\/\s*\[!code\s+focus\]/i,/\/\*\s*\[!code\s+focus\]\s*\*\//i,/#\s*\[!code\s+focus\]/i,/<!--\s*\[!code\s+focus\]\s*-->/i,/\/\/.*\[!code\s+focus\]/i];let mt=!1,kt=ut;for(const _t of ft)if(_t.test(ut)){mt=!0,kt=ut.replace(_t,"").trim();break}mt&&ct.push(yt),dt.push(kt)}),{cleanCode:dt.join(`
-`),parsedFocusLines:ct}}function MarkdownCodeBlock(rt){const{children:it,className:ct,...dt}=rt;return ct?jsxRuntimeExports.jsx(CodeBlock,{className:ct,...dt,children:it}):jsxRuntimeExports.jsx(InlineCode,{children:it})}function MarkdownPre(rt){const{children:it,...ct}=rt;if(React.isValidElement(it)&&(it.type==="code"||it.type===MarkdownCodeBlock)){const dt=it.props;return jsxRuntimeExports.jsx(CodeBlock,{className:dt.className,...ct,children:dt.children})}return jsxRuntimeExports.jsx("pre",{...ct,children:it})}function Heading({level:rt,id:it,children:ct,className:dt="",...ut}){const pt=`h${rt}`,yt=()=>jsxRuntimeExports.jsxs("svg",{className:"heading-anchor-icon",viewBox:"0 0 24 24",fill:"none",stroke:"currentColor",strokeWidth:"2",strokeLinecap:"round",strokeLinejoin:"round","aria-hidden":"true",children:[jsxRuntimeExports.jsx("path",{d:"M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"}),jsxRuntimeExports.jsx("path",{d:"M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"})]}),ft=_t=>{if(_t.preventDefault(),it){const vt=document.getElementById(it);vt&&(vt.scrollIntoView({behavior:"smooth",block:"start"}),window.history.pushState&&window.history.pushState(null,"",`#${it}`))}},mt=`
-    markdown-heading
-    markdown-heading--level-${rt}
-    ${it?"markdown-heading--with-anchor":""}
-    ${dt}
-  `.trim(),kt=pt;return jsxRuntimeExports.jsxs(kt,{id:it,className:mt,...ut,children:[jsxRuntimeExports.jsx("span",{className:"heading-content",children:ct}),it&&jsxRuntimeExports.jsx("a",{href:`#${it}`,className:"heading-anchor",onClick:ft,"aria-label":`Link to heading: ${typeof ct=="string"?ct:"heading"}`,title:"Direct link to heading",children:jsxRuntimeExports.jsx(yt,{})})]})}function createMarkdownHeading(rt){return function(ct){let dt="";typeof ct.children=="string"?dt=ct.children:Array.isArray(ct.children)?dt=ct.children.map(pt=>typeof pt=="string"?pt:pt.props?.children||"").join(""):ct.children?.props?.children&&(dt=ct.children.props.children);const ut=generateHeadingId(dt);return jsxRuntimeExports.jsx(Heading,{level:rt,id:ut,...ct,children:dt})}}function MarkdownContent({content:rt,options:it={},className:ct=""}){const{enableToc:dt=!0,enableCodeFocus:ut=!0,enableHtmlBlocks:pt=!0,enableLinkProcessing:yt=!0,tocDepth:ft={min:2,max:4},baseUrl:mt}=it,{processedContent:kt,toc:_t,frontmatter:vt}=reactExports.useMemo(()=>{const{content:Nt,frontmatter:$t,hasToc:Et}=parseFrontmatter(rt);let Ft=Nt;Ft=processMermaidAsHtml(Ft),(Et||dt)&&(Ft=removeTocPlaceholder(Ft)),Ft=Ft.replace(/^(#{1,6})\s+(.+)$/gm,(Ht,Ot,Zt)=>{const Yt=Zt.replace(/_/g,"\\_");return`${Ot} ${Yt}`});let qt=[];return(Et||dt)&&Ft&&(qt=generateToc(Ft,ft.min,ft.max)),{processedContent:Ft,toc:qt.length>0?qt:void 0,frontmatter:$t}},[rt,dt,ft]),bt=useActiveHeading(_t||[]),Mt=useToc();reactExports.useEffect(()=>{Mt&&_t&&(Mt.setToc(_t),Mt.setActiveId(bt))},[_t,bt,Mt]);const St={overrides:reactExports.useMemo(()=>{const Nt={h1:createMarkdownHeading(1),h2:createMarkdownHeading(2),h3:createMarkdownHeading(3),h4:createMarkdownHeading(4),h5:createMarkdownHeading(5),h6:createMarkdownHeading(6),em:Et=>{const Ft=(typeof Et.children=="string",Et.children);return typeof Ft=="string"&&Ft.includes("_")?jsxRuntimeExports.jsx("span",{children:Ft}):jsxRuntimeExports.jsx("em",{...Et})},strong:Et=>{const Ft=(typeof Et.children=="string",Et.children);return typeof Ft=="string"&&Ft.includes("_")?jsxRuntimeExports.jsx("span",{children:Ft}):jsxRuntimeExports.jsx("strong",{...Et})}};ut&&(Nt.pre=MarkdownPre,Nt.code=MarkdownCodeBlock),pt&&(Nt.div=parseCustomBlockDiv),yt&&(Nt.a=Et=>jsxRuntimeExports.jsx(LinkComponent,{...Et,baseUrl:mt}));const $t=createMermaidHtmlOverrides();return Object.assign(Nt,$t),Nt},[ut,pt,yt,mt]),wrapper:"div",forceBlock:!0},It=`markdown-content ${ct}`.trim();return jsxRuntimeExports.jsx("div",{className:It,children:jsxRuntimeExports.jsxs("div",{className:"markdown-body",children:[vt.title&&jsxRuntimeExports.jsxs("header",{className:"markdown-header",children:[jsxRuntimeExports.jsx("h1",{className:"markdown-title",children:vt.title}),vt.description&&jsxRuntimeExports.jsx("p",{className:"markdown-description",children:vt.description})]}),jsxRuntimeExports.jsx(Markdown,{options:St,children:kt})]})})}function BlogPostPage(){const{slug:rt}=useParams(),{i18n:it}=useTranslation(),[ct,dt]=reactExports.useState(""),[ut,pt]=reactExports.useState(!0),[yt,ft]=reactExports.useState(null);return reactExports.useEffect(()=>{rt&&(async()=>{pt(!0),ft(null);try{const kt=async Mt=>{const wt=await fetch(Mt);if(!wt.ok)return null;const St=wt.headers.get("content-type");return St&&St.includes("text/html")?null:wt.text()},vt=[`/docs/${it.language==="ru"?"ru-blog":"blog"}/${rt}.md`,`/docs/blog/${rt}.md`];let bt=null;for(const Mt of vt)if(bt=await kt(Mt),bt)break;if(!bt)throw new Error("Blog post not found");dt(bt)}catch(kt){console.error("Error loading blog post:",kt),ft(kt instanceof Error?kt.message:"An unexpected error occurred")}finally{pt(!1)}})()},[rt,it.language]),ut?jsxRuntimeExports.jsxs("div",{className:"min-h-screen bg-gradient-to-b from-slate-950 via-slate-900 to-slate-950",children:[jsxRuntimeExports.jsx(Navbar,{}),jsxRuntimeExports.jsx("div",{className:"flex items-center justify-center min-h-[60vh] pt-20",children:jsxRuntimeExports.jsxs("div",{className:"text-center",children:[jsxRuntimeExports.jsx(LoaderCircle,{className:"w-12 h-12 text-blue-500 animate-spin mx-auto mb-4"}),jsxRuntimeExports.jsx("p",{className:"text-slate-400",children:"Loading blog post..."})]})})]}):yt?jsxRuntimeExports.jsxs("div",{className:"min-h-screen bg-gradient-to-b from-slate-950 via-slate-900 to-slate-950",children:[jsxRuntimeExports.jsx(Navbar,{}),jsxRuntimeExports.jsx("div",{className:"flex items-center justify-center min-h-[60vh] pt-20",children:jsxRuntimeExports.jsxs("div",{className:"text-center max-w-md",children:[jsxRuntimeExports.jsx(CircleAlert,{className:"w-12 h-12 text-red-500 mx-auto mb-4"}),jsxRuntimeExports.jsx("h2",{className:"text-2xl font-bold text-white mb-2",children:"Failed to Load Post"}),jsxRuntimeExports.jsx("p",{className:"text-slate-400 mb-4",children:yt}),jsxRuntimeExports.jsxs(Link$1,{to:"/blog",className:"inline-flex items-center text-blue-400 hover:text-blue-300 transition-colors",children:[jsxRuntimeExports.jsx(ArrowLeft,{className:"w-4 h-4 mr-2"}),"Back to Blog"]})]})})]}):jsxRuntimeExports.jsxs("div",{className:"min-h-screen bg-gradient-to-b from-slate-950 via-slate-900 to-slate-950",children:[jsxRuntimeExports.jsx(Navbar,{}),jsxRuntimeExports.jsxs("div",{className:"max-w-4xl mx-auto px-6 pt-32 pb-20",children:[jsxRuntimeExports.jsxs(Link$1,{to:"/blog",className:"inline-flex items-center text-slate-400 hover:text-white transition-colors mb-8",children:[jsxRuntimeExports.jsx(ArrowLeft,{className:"w-4 h-4 mr-2"}),it.language==="ru"?"Назад к блогу":"Back to Blog"]}),jsxRuntimeExports.jsx("article",{className:"prose prose-invert prose-lg max-w-none",children:jsxRuntimeExports.jsx(MarkdownContent,{content:ct,options:{enableToc:!1,enableCodeFocus:!0,enableHtmlBlocks:!0,enableLinkProcessing:!0}})})]})]})}function SidebarItem({item:rt,level:it,isExpanded:ct,isActive:dt,onToggle:ut}){const pt=rt.children&&rt.children.length>0,yt=rt.icon?Icons[rt.icon]:null,ft=`
-        sidebar-item
-        sidebar-item--level-${it}
-        ${dt?"sidebar-item--active":""}
-        ${pt?"sidebar-item--parent":""}
-    `.trim(),mt=jsxRuntimeExports.jsx("div",{className:ft,children:jsxRuntimeExports.jsxs("div",{className:"sidebar-item__content",children:[yt&&it===0&&jsxRuntimeExports.jsx(yt,{className:"sidebar-item__icon",size:18}),rt.path?jsxRuntimeExports.jsx(Link$1,{to:rt.path,className:"sidebar-item__link",children:rt.title}):jsxRuntimeExports.jsx("span",{className:"sidebar-item__text",onClick:()=>{pt&&ut?.()},style:{cursor:pt?"pointer":"default"},children:rt.title}),pt&&jsxRuntimeExports.jsx("button",{className:"sidebar-item__toggle",onClick:kt=>{kt.preventDefault(),ut?.()},"aria-label":ct?"Collapse":"Expand",children:ct?jsxRuntimeExports.jsx(ChevronDown,{size:16}):jsxRuntimeExports.jsx(ChevronRight,{size:16})})]})});return jsxRuntimeExports.jsx("div",{className:"sidebar-item-wrapper",children:mt})}const sidebarEn=JSON.parse('[{"title":"Introduction","icon":"BookOpen","children":[{"title":"What is EasyP?","path":"/docs/guide/introduction/what-is"},{"title":"Quickstart","path":"/docs/guide/introduction/quickstart"},{"title":"Installation","path":"/docs/guide/introduction/install"}]},{"title":"EasyP CLI","icon":"Terminal","children":[{"title":"Linter","path":"/docs/guide/cli/linter/linter","children":[{"title":"Rules","children":[{"title":"Comment Enum Value","path":"/docs/guide/cli/linter/rules/comment-enum-value"},{"title":"Comment Enum","path":"/docs/guide/cli/linter/rules/comment-enum"},{"title":"Comment Field","path":"/docs/guide/cli/linter/rules/comment-field"},{"title":"Comment Message","path":"/docs/guide/cli/linter/rules/comment-message"},{"title":"Comment Oneof","path":"/docs/guide/cli/linter/rules/comment-oneof"},{"title":"Comment RPC","path":"/docs/guide/cli/linter/rules/comment-rpc"},{"title":"Comment Service","path":"/docs/guide/cli/linter/rules/comment-service"},{"title":"Directory Same Package","path":"/docs/guide/cli/linter/rules/directory-same-package"},{"title":"Enum First Value Zero","path":"/docs/guide/cli/linter/rules/enum-first-value-zero"},{"title":"Enum No Allow Alias","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias"},{"title":"Enum Pascal Case","path":"/docs/guide/cli/linter/rules/enum-pascal-case"},{"title":"Enum Value Prefix","path":"/docs/guide/cli/linter/rules/enum-value-prefix"},{"title":"Enum Value Upper Snake Case","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case"},{"title":"Enum Zero Value Suffix","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix"},{"title":"Field Lower Snake Case","path":"/docs/guide/cli/linter/rules/field-lower-snake-case"},{"title":"File Lower Snake Case","path":"/docs/guide/cli/linter/rules/file-lower-snake-case"},{"title":"Import No Public","path":"/docs/guide/cli/linter/rules/import-no-public"},{"title":"Import No Weak","path":"/docs/guide/cli/linter/rules/import-no-weak"},{"title":"Import Used","path":"/docs/guide/cli/linter/rules/import-used"},{"title":"Message Pascal Case","path":"/docs/guide/cli/linter/rules/message-pascal-case"},{"title":"Oneof Lower Snake Case","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case"},{"title":"Package Defined","path":"/docs/guide/cli/linter/rules/package-defined"},{"title":"Package Directory Match","path":"/docs/guide/cli/linter/rules/package-directory-match"},{"title":"Package Lower Snake Case","path":"/docs/guide/cli/linter/rules/package-lower-snake-case"},{"title":"Package Same C# Namespace","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace"},{"title":"Package Same Directory","path":"/docs/guide/cli/linter/rules/package-same-directory"},{"title":"Package Same Go Package","path":"/docs/guide/cli/linter/rules/package-same-go-package"},{"title":"Package Same Java Multiple Files","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files"},{"title":"Package Same Java Package","path":"/docs/guide/cli/linter/rules/package-same-java-package"},{"title":"Package Same PHP Namespace","path":"/docs/guide/cli/linter/rules/package-same-php-namespace"},{"title":"Package Same Ruby Package","path":"/docs/guide/cli/linter/rules/package-same-ruby-package"},{"title":"Package Same Swift Prefix","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix"},{"title":"Package Version Suffix","path":"/docs/guide/cli/linter/rules/package-version-suffix"},{"title":"RPC No Client Streaming","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming"},{"title":"RPC No Server Streaming","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming"},{"title":"RPC Pascal Case","path":"/docs/guide/cli/linter/rules/rpc-pascal-case"},{"title":"RPC Request Response Unique","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique"},{"title":"RPC Request Standard Name","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name"},{"title":"RPC Response Standard Name","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name"},{"title":"Service Pascal Case","path":"/docs/guide/cli/linter/rules/service-pascal-case"},{"title":"Service Suffix","path":"/docs/guide/cli/linter/rules/service-suffix"}]}]},{"title":"Generator","path":"/docs/guide/cli/generator/generator","children":[{"title":"Examples","children":[{"title":"Go","path":"/docs/guide/cli/generator/examples/go"},{"title":"gRPC Gateway","path":"/docs/guide/cli/generator/examples/grpc-gateway"},{"title":"Validate","path":"/docs/guide/cli/generator/examples/validate"}]}]},{"title":"Package Manager","path":"/docs/guide/cli/package-manager/package-manager"},{"title":"Breaking Changes","path":"/docs/guide/cli/breaking-changes/breaking-changes","children":[{"title":"Rules","children":[{"title":"Enum No Delete","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete"},{"title":"Enum Value No Delete","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete"},{"title":"Enum Value Same Name","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name"},{"title":"Field No Delete","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete"},{"title":"Field Same Cardinality","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality"},{"title":"Field Same Type","path":"/docs/guide/cli/breaking-changes/rules/field-same-type"},{"title":"Import No Delete","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete"},{"title":"Message No Delete","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete"},{"title":"Oneof Field No Delete","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete"},{"title":"Oneof Field Same Type","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type"},{"title":"Oneof No Delete","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete"},{"title":"RPC No Delete","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete"},{"title":"RPC Same Request Type","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type"},{"title":"RPC Same Response Type","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type"},{"title":"Service No Delete","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete"}]}]},{"title":"Auto Completion","path":"/docs/guide/cli/auto-completion/auto-completion"},{"title":"Configuration","path":"/docs/guide/cli/configuration/configuration"}]},{"title":"EasyP API Service","icon":"Server","children":[{"title":"Overview","path":"/docs/guide/api-service/overview"}]},{"title":"Migration","icon":"ArrowRightLeft","children":[{"title":"From Buf CLI","path":"/docs/guide/migration/buf-cli"},{"title":"From Protoc","path":"/docs/guide/migration/protoc"},{"title":"From Protolock","path":"/docs/guide/migration/protolock"},{"title":"From Prototool","path":"/docs/guide/migration/prototool"}]},{"title":"CI/CD","icon":"Workflow","children":[{"title":"GitHub Actions","path":"/docs/guide/ci-cd/github-actions"},{"title":"GitLab CI","path":"/docs/guide/ci-cd/gitlab"}]}]'),sidebarRu=JSON.parse('[{"title":"Введение","icon":"BookOpen","children":[{"title":"Что такое EasyP?","path":"/docs/guide/introduction/what-is"},{"title":"Быстрый старт","path":"/docs/guide/introduction/quickstart"},{"title":"Установка","path":"/docs/guide/introduction/install"}]},{"title":"CLI EasyP","icon":"Terminal","children":[{"title":"Linter","path":"/docs/guide/cli/linter/linter","children":[{"title":"Rules","children":[{"title":"Comment Enum Value","path":"/docs/guide/cli/linter/rules/comment-enum-value"},{"title":"Comment Enum","path":"/docs/guide/cli/linter/rules/comment-enum"},{"title":"Comment Field","path":"/docs/guide/cli/linter/rules/comment-field"},{"title":"Comment Message","path":"/docs/guide/cli/linter/rules/comment-message"},{"title":"Comment Oneof","path":"/docs/guide/cli/linter/rules/comment-oneof"},{"title":"Comment RPC","path":"/docs/guide/cli/linter/rules/comment-rpc"},{"title":"Comment Service","path":"/docs/guide/cli/linter/rules/comment-service"},{"title":"Directory Same Package","path":"/docs/guide/cli/linter/rules/directory-same-package"},{"title":"Enum First Value Zero","path":"/docs/guide/cli/linter/rules/enum-first-value-zero"},{"title":"Enum No Allow Alias","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias"},{"title":"Enum Pascal Case","path":"/docs/guide/cli/linter/rules/enum-pascal-case"},{"title":"Enum Value Prefix","path":"/docs/guide/cli/linter/rules/enum-value-prefix"},{"title":"Enum Value Upper Snake Case","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case"},{"title":"Enum Zero Value Suffix","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix"},{"title":"Field Lower Snake Case","path":"/docs/guide/cli/linter/rules/field-lower-snake-case"},{"title":"File Lower Snake Case","path":"/docs/guide/cli/linter/rules/file-lower-snake-case"},{"title":"Import No Public","path":"/docs/guide/cli/linter/rules/import-no-public"},{"title":"Import No Weak","path":"/docs/guide/cli/linter/rules/import-no-weak"},{"title":"Import Used","path":"/docs/guide/cli/linter/rules/import-used"},{"title":"Message Pascal Case","path":"/docs/guide/cli/linter/rules/message-pascal-case"},{"title":"Oneof Lower Snake Case","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case"},{"title":"Package Defined","path":"/docs/guide/cli/linter/rules/package-defined"},{"title":"Package Directory Match","path":"/docs/guide/cli/linter/rules/package-directory-match"},{"title":"Package Lower Snake Case","path":"/docs/guide/cli/linter/rules/package-lower-snake-case"},{"title":"Package Same C# Namespace","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace"},{"title":"Package Same Directory","path":"/docs/guide/cli/linter/rules/package-same-directory"},{"title":"Package Same Go Package","path":"/docs/guide/cli/linter/rules/package-same-go-package"},{"title":"Package Same Java Multiple Files","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files"},{"title":"Package Same Java Package","path":"/docs/guide/cli/linter/rules/package-same-java-package"},{"title":"Package Same PHP Namespace","path":"/docs/guide/cli/linter/rules/package-same-php-namespace"},{"title":"Package Same Ruby Package","path":"/docs/guide/cli/linter/rules/package-same-ruby-package"},{"title":"Package Same Swift Prefix","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix"},{"title":"Package Version Suffix","path":"/docs/guide/cli/linter/rules/package-version-suffix"},{"title":"RPC No Client Streaming","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming"},{"title":"RPC No Server Streaming","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming"},{"title":"RPC Pascal Case","path":"/docs/guide/cli/linter/rules/rpc-pascal-case"},{"title":"RPC Request Response Unique","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique"},{"title":"RPC Request Standard Name","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name"},{"title":"RPC Response Standard Name","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name"},{"title":"Service Pascal Case","path":"/docs/guide/cli/linter/rules/service-pascal-case"},{"title":"Service Suffix","path":"/docs/guide/cli/linter/rules/service-suffix"}]}]},{"title":"Generator","path":"/docs/guide/cli/generator/generator","children":[{"title":"Примеры","children":[{"title":"Go","path":"/docs/guide/cli/generator/examples/go"},{"title":"gRPC Gateway","path":"/docs/guide/cli/generator/examples/grpc-gateway"},{"title":"Validate","path":"/docs/guide/cli/generator/examples/validate"}]}]},{"title":"Package Manager","path":"/docs/guide/cli/package-manager/package-manager"},{"title":"Breaking Changes","path":"/docs/guide/cli/breaking-changes/breaking-changes","children":[{"title":"Rules","children":[{"title":"Enum No Delete","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete"},{"title":"Enum Value No Delete","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete"},{"title":"Enum Value Same Name","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name"},{"title":"Field No Delete","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete"},{"title":"Field Same Cardinality","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality"},{"title":"Field Same Type","path":"/docs/guide/cli/breaking-changes/rules/field-same-type"},{"title":"Import No Delete","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete"},{"title":"Message No Delete","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete"},{"title":"Oneof Field No Delete","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete"},{"title":"Oneof Field Same Type","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type"},{"title":"Oneof No Delete","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete"},{"title":"RPC No Delete","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete"},{"title":"RPC Same Request Type","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type"},{"title":"RPC Same Response Type","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type"},{"title":"Service No Delete","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete"}]}]},{"title":"Автодополнение","path":"/docs/guide/cli/auto-completion/auto-completion"},{"title":"Конфигурация","path":"/docs/guide/cli/configuration/configuration"}]},{"title":"EasyP API Service","icon":"Server","children":[{"title":"Обзор","path":"/docs/guide/api-service/overview"}]},{"title":"Migration","icon":"ArrowRightLeft","children":[{"title":"Buf CLI","path":"/docs/guide/migration/buf-cli"},{"title":"Protoc","path":"/docs/guide/migration/protoc"},{"title":"Prototool","path":"/docs/guide/migration/prototool"}]},{"title":"CI/CD","icon":"Workflow","children":[{"title":"GitHub Actions","path":"/docs/guide/ci-cd/github-actions"},{"title":"GitLab CI","path":"/docs/guide/ci-cd/gitlab"}]}]'),STORAGE_KEY="docs-sidebar-expanded";function loadSidebarConfig(){let rt="en";try{const it=localStorage.getItem("language");it?rt=it:window.i18next?.language&&(rt=window.i18next.language)}catch{}return rt==="ru"?sidebarRu:sidebarEn}function getParentPaths(rt,it){const ct=[];function dt(ut,pt=[]){for(const yt of ut){const ft=yt.path?[...pt,yt.path]:pt;if(yt.path===it)return ct.push(...pt),!0;if(yt.children&&dt(yt.children,ft))return yt.path&&ct.push(yt.path),!0}return!1}return dt(rt),ct}function getItemId(rt,it){return rt.path||`section-${rt.title.toLowerCase().replace(/\s+/g,"-")}-${it}`}function saveExpandedState(rt){try{localStorage.setItem(STORAGE_KEY,JSON.stringify(Array.from(rt)))}catch(it){console.error("Failed to save sidebar state:",it)}}function loadExpandedState(){try{const rt=localStorage.getItem(STORAGE_KEY);if(rt)return new Set(JSON.parse(rt))}catch(rt){console.error("Failed to load sidebar state:",rt)}return new Set}function isPathActive(rt,it){return rt?it===rt||it.startsWith(rt+"/"):!1}function getPrevNext(rt,it){const ct=[];function dt(pt){for(const yt of pt)yt.path&&ct.push(yt),yt.children&&dt(yt.children)}dt(rt);const ut=ct.findIndex(pt=>pt.path===it);return ut===-1?{prev:null,next:null}:{prev:ut>0?ct[ut-1]:null,next:ut<ct.length-1?ct[ut+1]:null}}function DocsSidebar({isOpen:rt,onClose:it}){const ct=useLocation(),[dt,ut]=reactExports.useState([]),[pt,yt]=reactExports.useState(new Set);reactExports.useEffect(()=>{const _t=loadSidebarConfig();ut(_t)},[]),reactExports.useEffect(()=>{const _t=loadExpandedState();yt(_t)},[]),reactExports.useEffect(()=>{if(dt.length>0){const _t=getParentPaths(dt,ct.pathname);_t.length>0&&yt(vt=>{const bt=new Set(vt);return _t.forEach(Mt=>bt.add(Mt)),bt})}},[ct.pathname,dt]),reactExports.useEffect(()=>{saveExpandedState(pt)},[pt]);const ft=_t=>{yt(vt=>{const bt=new Set(vt);return bt.has(_t)?bt.delete(_t):bt.add(_t),bt})},mt=(_t,vt,bt=0)=>{const Mt=getItemId(_t,vt),wt=pt.has(Mt)||pt.has(_t.path||""),St=isPathActive(_t.path,ct.pathname),It=_t.children&&_t.children.length>0;return jsxRuntimeExports.jsxs("div",{children:[jsxRuntimeExports.jsx(SidebarItem,{item:_t,level:bt,isExpanded:wt,isActive:St,onToggle:()=>{const Nt=_t.path||Mt;ft(Nt)}}),It&&jsxRuntimeExports.jsx("div",{className:`sidebar-children ${wt?"sidebar-children--expanded":""}`,children:wt&&_t.children.map((Nt,$t)=>mt(Nt,$t,bt+1))})]},Mt)},kt=`
-        docs-sidebar
-        ${rt?"docs-sidebar--open":""}
-    `.trim();return jsxRuntimeExports.jsxs(jsxRuntimeExports.Fragment,{children:[rt&&jsxRuntimeExports.jsx("div",{className:"docs-sidebar-backdrop",onClick:it,"aria-hidden":"true"}),jsxRuntimeExports.jsxs("aside",{className:kt,children:[jsxRuntimeExports.jsx("div",{className:"docs-sidebar-header",children:jsxRuntimeExports.jsxs(Link$1,{to:"/",className:"flex items-center gap-2 hover:opacity-80 transition-opacity",children:[jsxRuntimeExports.jsx("div",{className:"w-8 h-8 bg-blue-500/20 rounded-lg flex items-center justify-center border border-blue-500/30",children:jsxRuntimeExports.jsx("span",{className:"font-bold text-blue-500 text-sm",children:"EP"})}),jsxRuntimeExports.jsx("h2",{className:"text-xl font-bold text-gray-900 dark:text-white",children:"EasyP"})]})}),jsxRuntimeExports.jsx("nav",{className:"docs-sidebar-nav",children:dt.map((_t,vt)=>mt(_t,vt,0))})]})]})}function DocsLayout(){const rt=useNavigate(),[it,ct]=reactExports.useState(!1),dt=useToc();return reactExports.useEffect(()=>(window.routerNavigate=ut=>{rt(ut),ct(!1)},()=>{delete window.routerNavigate}),[rt]),jsxRuntimeExports.jsx("div",{className:"min-h-screen bg-white dark:bg-gray-950",children:jsxRuntimeExports.jsxs("div",{className:"docs-layout",children:[jsxRuntimeExports.jsx(DocsSidebar,{isOpen:it,onClose:()=>ct(!1)}),jsxRuntimeExports.jsxs("main",{className:"docs-main",children:[jsxRuntimeExports.jsxs("div",{className:"docs-mobile-header md:hidden",children:[jsxRuntimeExports.jsx("button",{className:"docs-sidebar-toggle",onClick:()=>ct(!it),"aria-label":"Toggle sidebar",children:it?jsxRuntimeExports.jsx(X$3,{className:"w-6 h-6"}):jsxRuntimeExports.jsx(Menu,{className:"w-6 h-6"})}),jsxRuntimeExports.jsxs(Link$1,{to:"/",className:"flex items-center gap-2 hover:opacity-80 transition-opacity",children:[jsxRuntimeExports.jsx("div",{className:"w-6 h-6 bg-blue-500/20 rounded flex items-center justify-center border border-blue-500/30",children:jsxRuntimeExports.jsx("span",{className:"font-bold text-blue-500 text-xs",children:"EP"})}),jsxRuntimeExports.jsx("h1",{className:"text-lg font-bold text-gray-900 dark:text-white",children:"EasyP"})]})]}),jsxRuntimeExports.jsx("div",{className:"docs-content",children:jsxRuntimeExports.jsx(Outlet,{})})]}),jsxRuntimeExports.jsx("aside",{className:"docs-toc-container",children:dt?.toc&&dt.toc.length>0&&jsxRuntimeExports.jsx(TableOfContents,{toc:dt.toc,activeId:dt.activeId})})]})})}function isArray(rt){return Array.isArray?Array.isArray(rt):getTag(rt)==="[object Array]"}function baseToString(rt){if(typeof rt=="string")return rt;let it=rt+"";return it=="0"&&1/rt==-1/0?"-0":it}function toString(rt){return rt==null?"":baseToString(rt)}function isString(rt){return typeof rt=="string"}function isNumber(rt){return typeof rt=="number"}function isBoolean(rt){return rt===!0||rt===!1||isObjectLike(rt)&&getTag(rt)=="[object Boolean]"}function isObject(rt){return typeof rt=="object"}function isObjectLike(rt){return isObject(rt)&&rt!==null}function isDefined(rt){return rt!=null}function isBlank(rt){return!rt.trim().length}function getTag(rt){return rt==null?rt===void 0?"[object Undefined]":"[object Null]":Object.prototype.toString.call(rt)}const INCORRECT_INDEX_TYPE="Incorrect 'index' type",LOGICAL_SEARCH_INVALID_QUERY_FOR_KEY=rt=>`Invalid value for key ${rt}`,PATTERN_LENGTH_TOO_LARGE=rt=>`Pattern length exceeds max of ${rt}.`,MISSING_KEY_PROPERTY=rt=>`Missing ${rt} property in key`,INVALID_KEY_WEIGHT_VALUE=rt=>`Property 'weight' in key '${rt}' must be a positive integer`,hasOwn=Object.prototype.hasOwnProperty;class KeyStore{constructor(it){this._keys=[],this._keyMap={};let ct=0;it.forEach(dt=>{let ut=createKey(dt);this._keys.push(ut),this._keyMap[ut.id]=ut,ct+=ut.weight}),this._keys.forEach(dt=>{dt.weight/=ct})}get(it){return this._keyMap[it]}keys(){return this._keys}toJSON(){return JSON.stringify(this._keys)}}function createKey(rt){let it=null,ct=null,dt=null,ut=1,pt=null;if(isString(rt)||isArray(rt))dt=rt,it=createKeyPath(rt),ct=createKeyId(rt);else{if(!hasOwn.call(rt,"name"))throw new Error(MISSING_KEY_PROPERTY("name"));const yt=rt.name;if(dt=yt,hasOwn.call(rt,"weight")&&(ut=rt.weight,ut<=0))throw new Error(INVALID_KEY_WEIGHT_VALUE(yt));it=createKeyPath(yt),ct=createKeyId(yt),pt=rt.getFn}return{path:it,id:ct,weight:ut,src:dt,getFn:pt}}function createKeyPath(rt){return isArray(rt)?rt:rt.split(".")}function createKeyId(rt){return isArray(rt)?rt.join("."):rt}function get(rt,it){let ct=[],dt=!1;const ut=(pt,yt,ft)=>{if(isDefined(pt))if(!yt[ft])ct.push(pt);else{let mt=yt[ft];const kt=pt[mt];if(!isDefined(kt))return;if(ft===yt.length-1&&(isString(kt)||isNumber(kt)||isBoolean(kt)))ct.push(toString(kt));else if(isArray(kt)){dt=!0;for(let _t=0,vt=kt.length;_t<vt;_t+=1)ut(kt[_t],yt,ft+1)}else yt.length&&ut(kt,yt,ft+1)}};return ut(rt,isString(it)?it.split("."):it,0),dt?ct:ct[0]}const MatchOptions={includeMatches:!1,findAllMatches:!1,minMatchCharLength:1},BasicOptions={isCaseSensitive:!1,ignoreDiacritics:!1,includeScore:!1,keys:[],shouldSort:!0,sortFn:(rt,it)=>rt.score===it.score?rt.idx<it.idx?-1:1:rt.score<it.score?-1:1},FuzzyOptions={location:0,threshold:.6,distance:100},AdvancedOptions={useExtendedSearch:!1,getFn:get,ignoreLocation:!1,ignoreFieldNorm:!1,fieldNormWeight:1};var Config={...BasicOptions,...MatchOptions,...FuzzyOptions,...AdvancedOptions};const SPACE=/[^ ]+/g;function norm(rt=1,it=3){const ct=new Map,dt=Math.pow(10,it);return{get(ut){const pt=ut.match(SPACE).length;if(ct.has(pt))return ct.get(pt);const yt=1/Math.pow(pt,.5*rt),ft=parseFloat(Math.round(yt*dt)/dt);return ct.set(pt,ft),ft},clear(){ct.clear()}}}class FuseIndex{constructor({getFn:it=Config.getFn,fieldNormWeight:ct=Config.fieldNormWeight}={}){this.norm=norm(ct,3),this.getFn=it,this.isCreated=!1,this.setIndexRecords()}setSources(it=[]){this.docs=it}setIndexRecords(it=[]){this.records=it}setKeys(it=[]){this.keys=it,this._keysMap={},it.forEach((ct,dt)=>{this._keysMap[ct.id]=dt})}create(){this.isCreated||!this.docs.length||(this.isCreated=!0,isString(this.docs[0])?this.docs.forEach((it,ct)=>{this._addString(it,ct)}):this.docs.forEach((it,ct)=>{this._addObject(it,ct)}),this.norm.clear())}add(it){const ct=this.size();isString(it)?this._addString(it,ct):this._addObject(it,ct)}removeAt(it){this.records.splice(it,1);for(let ct=it,dt=this.size();ct<dt;ct+=1)this.records[ct].i-=1}getValueForItemAtKeyId(it,ct){return it[this._keysMap[ct]]}size(){return this.records.length}_addString(it,ct){if(!isDefined(it)||isBlank(it))return;let dt={v:it,i:ct,n:this.norm.get(it)};this.records.push(dt)}_addObject(it,ct){let dt={i:ct,$:{}};this.keys.forEach((ut,pt)=>{let yt=ut.getFn?ut.getFn(it):this.getFn(it,ut.path);if(isDefined(yt)){if(isArray(yt)){let ft=[];const mt=[{nestedArrIndex:-1,value:yt}];for(;mt.length;){const{nestedArrIndex:kt,value:_t}=mt.pop();if(isDefined(_t))if(isString(_t)&&!isBlank(_t)){let vt={v:_t,i:kt,n:this.norm.get(_t)};ft.push(vt)}else isArray(_t)&&_t.forEach((vt,bt)=>{mt.push({nestedArrIndex:bt,value:vt})})}dt.$[pt]=ft}else if(isString(yt)&&!isBlank(yt)){let ft={v:yt,n:this.norm.get(yt)};dt.$[pt]=ft}}}),this.records.push(dt)}toJSON(){return{keys:this.keys,records:this.records}}}function createIndex(rt,it,{getFn:ct=Config.getFn,fieldNormWeight:dt=Config.fieldNormWeight}={}){const ut=new FuseIndex({getFn:ct,fieldNormWeight:dt});return ut.setKeys(rt.map(createKey)),ut.setSources(it),ut.create(),ut}function parseIndex(rt,{getFn:it=Config.getFn,fieldNormWeight:ct=Config.fieldNormWeight}={}){const{keys:dt,records:ut}=rt,pt=new FuseIndex({getFn:it,fieldNormWeight:ct});return pt.setKeys(dt),pt.setIndexRecords(ut),pt}function computeScore$1(rt,{errors:it=0,currentLocation:ct=0,expectedLocation:dt=0,distance:ut=Config.distance,ignoreLocation:pt=Config.ignoreLocation}={}){const yt=it/rt.length;if(pt)return yt;const ft=Math.abs(dt-ct);return ut?yt+ft/ut:ft?1:yt}function convertMaskToIndices(rt=[],it=Config.minMatchCharLength){let ct=[],dt=-1,ut=-1,pt=0;for(let yt=rt.length;pt<yt;pt+=1){let ft=rt[pt];ft&&dt===-1?dt=pt:!ft&&dt!==-1&&(ut=pt-1,ut-dt+1>=it&&ct.push([dt,ut]),dt=-1)}return rt[pt-1]&&pt-dt>=it&&ct.push([dt,pt-1]),ct}const MAX_BITS=32;function search(rt,it,ct,{location:dt=Config.location,distance:ut=Config.distance,threshold:pt=Config.threshold,findAllMatches:yt=Config.findAllMatches,minMatchCharLength:ft=Config.minMatchCharLength,includeMatches:mt=Config.includeMatches,ignoreLocation:kt=Config.ignoreLocation}={}){if(it.length>MAX_BITS)throw new Error(PATTERN_LENGTH_TOO_LARGE(MAX_BITS));const _t=it.length,vt=rt.length,bt=Math.max(0,Math.min(dt,vt));let Mt=pt,wt=bt;const St=ft>1||mt,It=St?Array(vt):[];let Nt;for(;(Nt=rt.indexOf(it,wt))>-1;){let Ot=computeScore$1(it,{currentLocation:Nt,expectedLocation:bt,distance:ut,ignoreLocation:kt});if(Mt=Math.min(Ot,Mt),wt=Nt+_t,St){let Zt=0;for(;Zt<_t;)It[Nt+Zt]=1,Zt+=1}}wt=-1;let $t=[],Et=1,Ft=_t+vt;const qt=1<<_t-1;for(let Ot=0;Ot<_t;Ot+=1){let Zt=0,Yt=Ft;for(;Zt<Yt;)computeScore$1(it,{errors:Ot,currentLocation:bt+Yt,expectedLocation:bt,distance:ut,ignoreLocation:kt})<=Mt?Zt=Yt:Ft=Yt,Yt=Math.floor((Ft-Zt)/2+Zt);Ft=Yt;let aa=Math.max(1,bt-Yt+1),Qt=yt?vt:Math.min(bt+Yt,vt)+_t,oa=Array(Qt+2);oa[Qt+1]=(1<<Ot)-1;for(let Kt=Qt;Kt>=aa;Kt-=1){let ra=Kt-1,Ut=ct[rt.charAt(ra)];if(St&&(It[ra]=+!!Ut),oa[Kt]=(oa[Kt+1]<<1|1)&Ut,Ot&&(oa[Kt]|=($t[Kt+1]|$t[Kt])<<1|1|$t[Kt+1]),oa[Kt]&qt&&(Et=computeScore$1(it,{errors:Ot,currentLocation:ra,expectedLocation:bt,distance:ut,ignoreLocation:kt}),Et<=Mt)){if(Mt=Et,wt=ra,wt<=bt)break;aa=Math.max(1,2*bt-wt)}}if(computeScore$1(it,{errors:Ot+1,currentLocation:bt,expectedLocation:bt,distance:ut,ignoreLocation:kt})>Mt)break;$t=oa}const Ht={isMatch:wt>=0,score:Math.max(.001,Et)};if(St){const Ot=convertMaskToIndices(It,ft);Ot.length?mt&&(Ht.indices=Ot):Ht.isMatch=!1}return Ht}function createPatternAlphabet(rt){let it={};for(let ct=0,dt=rt.length;ct<dt;ct+=1){const ut=rt.charAt(ct);it[ut]=(it[ut]||0)|1<<dt-ct-1}return it}const stripDiacritics=String.prototype.normalize?(rt=>rt.normalize("NFD").replace(/[\u0300-\u036F\u0483-\u0489\u0591-\u05BD\u05BF\u05C1\u05C2\u05C4\u05C5\u05C7\u0610-\u061A\u064B-\u065F\u0670\u06D6-\u06DC\u06DF-\u06E4\u06E7\u06E8\u06EA-\u06ED\u0711\u0730-\u074A\u07A6-\u07B0\u07EB-\u07F3\u07FD\u0816-\u0819\u081B-\u0823\u0825-\u0827\u0829-\u082D\u0859-\u085B\u08D3-\u08E1\u08E3-\u0903\u093A-\u093C\u093E-\u094F\u0951-\u0957\u0962\u0963\u0981-\u0983\u09BC\u09BE-\u09C4\u09C7\u09C8\u09CB-\u09CD\u09D7\u09E2\u09E3\u09FE\u0A01-\u0A03\u0A3C\u0A3E-\u0A42\u0A47\u0A48\u0A4B-\u0A4D\u0A51\u0A70\u0A71\u0A75\u0A81-\u0A83\u0ABC\u0ABE-\u0AC5\u0AC7-\u0AC9\u0ACB-\u0ACD\u0AE2\u0AE3\u0AFA-\u0AFF\u0B01-\u0B03\u0B3C\u0B3E-\u0B44\u0B47\u0B48\u0B4B-\u0B4D\u0B56\u0B57\u0B62\u0B63\u0B82\u0BBE-\u0BC2\u0BC6-\u0BC8\u0BCA-\u0BCD\u0BD7\u0C00-\u0C04\u0C3E-\u0C44\u0C46-\u0C48\u0C4A-\u0C4D\u0C55\u0C56\u0C62\u0C63\u0C81-\u0C83\u0CBC\u0CBE-\u0CC4\u0CC6-\u0CC8\u0CCA-\u0CCD\u0CD5\u0CD6\u0CE2\u0CE3\u0D00-\u0D03\u0D3B\u0D3C\u0D3E-\u0D44\u0D46-\u0D48\u0D4A-\u0D4D\u0D57\u0D62\u0D63\u0D82\u0D83\u0DCA\u0DCF-\u0DD4\u0DD6\u0DD8-\u0DDF\u0DF2\u0DF3\u0E31\u0E34-\u0E3A\u0E47-\u0E4E\u0EB1\u0EB4-\u0EB9\u0EBB\u0EBC\u0EC8-\u0ECD\u0F18\u0F19\u0F35\u0F37\u0F39\u0F3E\u0F3F\u0F71-\u0F84\u0F86\u0F87\u0F8D-\u0F97\u0F99-\u0FBC\u0FC6\u102B-\u103E\u1056-\u1059\u105E-\u1060\u1062-\u1064\u1067-\u106D\u1071-\u1074\u1082-\u108D\u108F\u109A-\u109D\u135D-\u135F\u1712-\u1714\u1732-\u1734\u1752\u1753\u1772\u1773\u17B4-\u17D3\u17DD\u180B-\u180D\u1885\u1886\u18A9\u1920-\u192B\u1930-\u193B\u1A17-\u1A1B\u1A55-\u1A5E\u1A60-\u1A7C\u1A7F\u1AB0-\u1ABE\u1B00-\u1B04\u1B34-\u1B44\u1B6B-\u1B73\u1B80-\u1B82\u1BA1-\u1BAD\u1BE6-\u1BF3\u1C24-\u1C37\u1CD0-\u1CD2\u1CD4-\u1CE8\u1CED\u1CF2-\u1CF4\u1CF7-\u1CF9\u1DC0-\u1DF9\u1DFB-\u1DFF\u20D0-\u20F0\u2CEF-\u2CF1\u2D7F\u2DE0-\u2DFF\u302A-\u302F\u3099\u309A\uA66F-\uA672\uA674-\uA67D\uA69E\uA69F\uA6F0\uA6F1\uA802\uA806\uA80B\uA823-\uA827\uA880\uA881\uA8B4-\uA8C5\uA8E0-\uA8F1\uA8FF\uA926-\uA92D\uA947-\uA953\uA980-\uA983\uA9B3-\uA9C0\uA9E5\uAA29-\uAA36\uAA43\uAA4C\uAA4D\uAA7B-\uAA7D\uAAB0\uAAB2-\uAAB4\uAAB7\uAAB8\uAABE\uAABF\uAAC1\uAAEB-\uAAEF\uAAF5\uAAF6\uABE3-\uABEA\uABEC\uABED\uFB1E\uFE00-\uFE0F\uFE20-\uFE2F]/g,"")):(rt=>rt);class BitapSearch{constructor(it,{location:ct=Config.location,threshold:dt=Config.threshold,distance:ut=Config.distance,includeMatches:pt=Config.includeMatches,findAllMatches:yt=Config.findAllMatches,minMatchCharLength:ft=Config.minMatchCharLength,isCaseSensitive:mt=Config.isCaseSensitive,ignoreDiacritics:kt=Config.ignoreDiacritics,ignoreLocation:_t=Config.ignoreLocation}={}){if(this.options={location:ct,threshold:dt,distance:ut,includeMatches:pt,findAllMatches:yt,minMatchCharLength:ft,isCaseSensitive:mt,ignoreDiacritics:kt,ignoreLocation:_t},it=mt?it:it.toLowerCase(),it=kt?stripDiacritics(it):it,this.pattern=it,this.chunks=[],!this.pattern.length)return;const vt=(Mt,wt)=>{this.chunks.push({pattern:Mt,alphabet:createPatternAlphabet(Mt),startIndex:wt})},bt=this.pattern.length;if(bt>MAX_BITS){let Mt=0;const wt=bt%MAX_BITS,St=bt-wt;for(;Mt<St;)vt(this.pattern.substr(Mt,MAX_BITS),Mt),Mt+=MAX_BITS;if(wt){const It=bt-MAX_BITS;vt(this.pattern.substr(It),It)}}else vt(this.pattern,0)}searchIn(it){const{isCaseSensitive:ct,ignoreDiacritics:dt,includeMatches:ut}=this.options;if(it=ct?it:it.toLowerCase(),it=dt?stripDiacritics(it):it,this.pattern===it){let St={isMatch:!0,score:0};return ut&&(St.indices=[[0,it.length-1]]),St}const{location:pt,distance:yt,threshold:ft,findAllMatches:mt,minMatchCharLength:kt,ignoreLocation:_t}=this.options;let vt=[],bt=0,Mt=!1;this.chunks.forEach(({pattern:St,alphabet:It,startIndex:Nt})=>{const{isMatch:$t,score:Et,indices:Ft}=search(it,St,It,{location:pt+Nt,distance:yt,threshold:ft,findAllMatches:mt,minMatchCharLength:kt,includeMatches:ut,ignoreLocation:_t});$t&&(Mt=!0),bt+=Et,$t&&Ft&&(vt=[...vt,...Ft])});let wt={isMatch:Mt,score:Mt?bt/this.chunks.length:1};return Mt&&ut&&(wt.indices=vt),wt}}class BaseMatch{constructor(it){this.pattern=it}static isMultiMatch(it){return getMatch(it,this.multiRegex)}static isSingleMatch(it){return getMatch(it,this.singleRegex)}search(){}}function getMatch(rt,it){const ct=rt.match(it);return ct?ct[1]:null}class ExactMatch extends BaseMatch{constructor(it){super(it)}static get type(){return"exact"}static get multiRegex(){return/^="(.*)"$/}static get singleRegex(){return/^=(.*)$/}search(it){const ct=it===this.pattern;return{isMatch:ct,score:ct?0:1,indices:[0,this.pattern.length-1]}}}class InverseExactMatch extends BaseMatch{constructor(it){super(it)}static get type(){return"inverse-exact"}static get multiRegex(){return/^!"(.*)"$/}static get singleRegex(){return/^!(.*)$/}search(it){const dt=it.indexOf(this.pattern)===-1;return{isMatch:dt,score:dt?0:1,indices:[0,it.length-1]}}}class PrefixExactMatch extends BaseMatch{constructor(it){super(it)}static get type(){return"prefix-exact"}static get multiRegex(){return/^\^"(.*)"$/}static get singleRegex(){return/^\^(.*)$/}search(it){const ct=it.startsWith(this.pattern);return{isMatch:ct,score:ct?0:1,indices:[0,this.pattern.length-1]}}}class InversePrefixExactMatch extends BaseMatch{constructor(it){super(it)}static get type(){return"inverse-prefix-exact"}static get multiRegex(){return/^!\^"(.*)"$/}static get singleRegex(){return/^!\^(.*)$/}search(it){const ct=!it.startsWith(this.pattern);return{isMatch:ct,score:ct?0:1,indices:[0,it.length-1]}}}class SuffixExactMatch extends BaseMatch{constructor(it){super(it)}static get type(){return"suffix-exact"}static get multiRegex(){return/^"(.*)"\$$/}static get singleRegex(){return/^(.*)\$$/}search(it){const ct=it.endsWith(this.pattern);return{isMatch:ct,score:ct?0:1,indices:[it.length-this.pattern.length,it.length-1]}}}class InverseSuffixExactMatch extends BaseMatch{constructor(it){super(it)}static get type(){return"inverse-suffix-exact"}static get multiRegex(){return/^!"(.*)"\$$/}static get singleRegex(){return/^!(.*)\$$/}search(it){const ct=!it.endsWith(this.pattern);return{isMatch:ct,score:ct?0:1,indices:[0,it.length-1]}}}class FuzzyMatch extends BaseMatch{constructor(it,{location:ct=Config.location,threshold:dt=Config.threshold,distance:ut=Config.distance,includeMatches:pt=Config.includeMatches,findAllMatches:yt=Config.findAllMatches,minMatchCharLength:ft=Config.minMatchCharLength,isCaseSensitive:mt=Config.isCaseSensitive,ignoreDiacritics:kt=Config.ignoreDiacritics,ignoreLocation:_t=Config.ignoreLocation}={}){super(it),this._bitapSearch=new BitapSearch(it,{location:ct,threshold:dt,distance:ut,includeMatches:pt,findAllMatches:yt,minMatchCharLength:ft,isCaseSensitive:mt,ignoreDiacritics:kt,ignoreLocation:_t})}static get type(){return"fuzzy"}static get multiRegex(){return/^"(.*)"$/}static get singleRegex(){return/^(.*)$/}search(it){return this._bitapSearch.searchIn(it)}}class IncludeMatch extends BaseMatch{constructor(it){super(it)}static get type(){return"include"}static get multiRegex(){return/^'"(.*)"$/}static get singleRegex(){return/^'(.*)$/}search(it){let ct=0,dt;const ut=[],pt=this.pattern.length;for(;(dt=it.indexOf(this.pattern,ct))>-1;)ct=dt+pt,ut.push([dt,ct-1]);const yt=!!ut.length;return{isMatch:yt,score:yt?0:1,indices:ut}}}const searchers=[ExactMatch,IncludeMatch,PrefixExactMatch,InversePrefixExactMatch,InverseSuffixExactMatch,SuffixExactMatch,InverseExactMatch,FuzzyMatch],searchersLen=searchers.length,SPACE_RE=/ +(?=(?:[^\"]*\"[^\"]*\")*[^\"]*$)/,OR_TOKEN="|";function parseQuery(rt,it={}){return rt.split(OR_TOKEN).map(ct=>{let dt=ct.trim().split(SPACE_RE).filter(pt=>pt&&!!pt.trim()),ut=[];for(let pt=0,yt=dt.length;pt<yt;pt+=1){const ft=dt[pt];let mt=!1,kt=-1;for(;!mt&&++kt<searchersLen;){const _t=searchers[kt];let vt=_t.isMultiMatch(ft);vt&&(ut.push(new _t(vt,it)),mt=!0)}if(!mt)for(kt=-1;++kt<searchersLen;){const _t=searchers[kt];let vt=_t.isSingleMatch(ft);if(vt){ut.push(new _t(vt,it));break}}}return ut})}const MultiMatchSet=new Set([FuzzyMatch.type,IncludeMatch.type]);class ExtendedSearch{constructor(it,{isCaseSensitive:ct=Config.isCaseSensitive,ignoreDiacritics:dt=Config.ignoreDiacritics,includeMatches:ut=Config.includeMatches,minMatchCharLength:pt=Config.minMatchCharLength,ignoreLocation:yt=Config.ignoreLocation,findAllMatches:ft=Config.findAllMatches,location:mt=Config.location,threshold:kt=Config.threshold,distance:_t=Config.distance}={}){this.query=null,this.options={isCaseSensitive:ct,ignoreDiacritics:dt,includeMatches:ut,minMatchCharLength:pt,findAllMatches:ft,ignoreLocation:yt,location:mt,threshold:kt,distance:_t},it=ct?it:it.toLowerCase(),it=dt?stripDiacritics(it):it,this.pattern=it,this.query=parseQuery(this.pattern,this.options)}static condition(it,ct){return ct.useExtendedSearch}searchIn(it){const ct=this.query;if(!ct)return{isMatch:!1,score:1};const{includeMatches:dt,isCaseSensitive:ut,ignoreDiacritics:pt}=this.options;it=ut?it:it.toLowerCase(),it=pt?stripDiacritics(it):it;let yt=0,ft=[],mt=0;for(let kt=0,_t=ct.length;kt<_t;kt+=1){const vt=ct[kt];ft.length=0,yt=0;for(let bt=0,Mt=vt.length;bt<Mt;bt+=1){const wt=vt[bt],{isMatch:St,indices:It,score:Nt}=wt.search(it);if(St){if(yt+=1,mt+=Nt,dt){const $t=wt.constructor.type;MultiMatchSet.has($t)?ft=[...ft,...It]:ft.push(It)}}else{mt=0,yt=0,ft.length=0;break}}if(yt){let bt={isMatch:!0,score:mt/yt};return dt&&(bt.indices=ft),bt}}return{isMatch:!1,score:1}}}const registeredSearchers=[];function register(...rt){registeredSearchers.push(...rt)}function createSearcher(rt,it){for(let ct=0,dt=registeredSearchers.length;ct<dt;ct+=1){let ut=registeredSearchers[ct];if(ut.condition(rt,it))return new ut(rt,it)}return new BitapSearch(rt,it)}const LogicalOperator={AND:"$and",OR:"$or"},KeyType={PATH:"$path",PATTERN:"$val"},isExpression=rt=>!!(rt[LogicalOperator.AND]||rt[LogicalOperator.OR]),isPath=rt=>!!rt[KeyType.PATH],isLeaf=rt=>!isArray(rt)&&isObject(rt)&&!isExpression(rt),convertToExplicit=rt=>({[LogicalOperator.AND]:Object.keys(rt).map(it=>({[it]:rt[it]}))});function parse(rt,it,{auto:ct=!0}={}){const dt=ut=>{let pt=Object.keys(ut);const yt=isPath(ut);if(!yt&&pt.length>1&&!isExpression(ut))return dt(convertToExplicit(ut));if(isLeaf(ut)){const mt=yt?ut[KeyType.PATH]:pt[0],kt=yt?ut[KeyType.PATTERN]:ut[mt];if(!isString(kt))throw new Error(LOGICAL_SEARCH_INVALID_QUERY_FOR_KEY(mt));const _t={keyId:createKeyId(mt),pattern:kt};return ct&&(_t.searcher=createSearcher(kt,it)),_t}let ft={children:[],operator:pt[0]};return pt.forEach(mt=>{const kt=ut[mt];isArray(kt)&&kt.forEach(_t=>{ft.children.push(dt(_t))})}),ft};return isExpression(rt)||(rt=convertToExplicit(rt)),dt(rt)}function computeScore(rt,{ignoreFieldNorm:it=Config.ignoreFieldNorm}){rt.forEach(ct=>{let dt=1;ct.matches.forEach(({key:ut,norm:pt,score:yt})=>{const ft=ut?ut.weight:null;dt*=Math.pow(yt===0&&ft?Number.EPSILON:yt,(ft||1)*(it?1:pt))}),ct.score=dt})}function transformMatches(rt,it){const ct=rt.matches;it.matches=[],isDefined(ct)&&ct.forEach(dt=>{if(!isDefined(dt.indices)||!dt.indices.length)return;const{indices:ut,value:pt}=dt;let yt={indices:ut,value:pt};dt.key&&(yt.key=dt.key.src),dt.idx>-1&&(yt.refIndex=dt.idx),it.matches.push(yt)})}function transformScore(rt,it){it.score=rt.score}function format(rt,it,{includeMatches:ct=Config.includeMatches,includeScore:dt=Config.includeScore}={}){const ut=[];return ct&&ut.push(transformMatches),dt&&ut.push(transformScore),rt.map(pt=>{const{idx:yt}=pt,ft={item:it[yt],refIndex:yt};return ut.length&&ut.forEach(mt=>{mt(pt,ft)}),ft})}class Fuse{constructor(it,ct={},dt){this.options={...Config,...ct},this.options.useExtendedSearch,this._keyStore=new KeyStore(this.options.keys),this.setCollection(it,dt)}setCollection(it,ct){if(this._docs=it,ct&&!(ct instanceof FuseIndex))throw new Error(INCORRECT_INDEX_TYPE);this._myIndex=ct||createIndex(this.options.keys,this._docs,{getFn:this.options.getFn,fieldNormWeight:this.options.fieldNormWeight})}add(it){isDefined(it)&&(this._docs.push(it),this._myIndex.add(it))}remove(it=()=>!1){const ct=[];for(let dt=0,ut=this._docs.length;dt<ut;dt+=1){const pt=this._docs[dt];it(pt,dt)&&(this.removeAt(dt),dt-=1,ut-=1,ct.push(pt))}return ct}removeAt(it){this._docs.splice(it,1),this._myIndex.removeAt(it)}getIndex(){return this._myIndex}search(it,{limit:ct=-1}={}){const{includeMatches:dt,includeScore:ut,shouldSort:pt,sortFn:yt,ignoreFieldNorm:ft}=this.options;let mt=isString(it)?isString(this._docs[0])?this._searchStringList(it):this._searchObjectList(it):this._searchLogical(it);return computeScore(mt,{ignoreFieldNorm:ft}),pt&&mt.sort(yt),isNumber(ct)&&ct>-1&&(mt=mt.slice(0,ct)),format(mt,this._docs,{includeMatches:dt,includeScore:ut})}_searchStringList(it){const ct=createSearcher(it,this.options),{records:dt}=this._myIndex,ut=[];return dt.forEach(({v:pt,i:yt,n:ft})=>{if(!isDefined(pt))return;const{isMatch:mt,score:kt,indices:_t}=ct.searchIn(pt);mt&&ut.push({item:pt,idx:yt,matches:[{score:kt,value:pt,norm:ft,indices:_t}]})}),ut}_searchLogical(it){const ct=parse(it,this.options),dt=(ft,mt,kt)=>{if(!ft.children){const{keyId:vt,searcher:bt}=ft,Mt=this._findMatches({key:this._keyStore.get(vt),value:this._myIndex.getValueForItemAtKeyId(mt,vt),searcher:bt});return Mt&&Mt.length?[{idx:kt,item:mt,matches:Mt}]:[]}const _t=[];for(let vt=0,bt=ft.children.length;vt<bt;vt+=1){const Mt=ft.children[vt],wt=dt(Mt,mt,kt);if(wt.length)_t.push(...wt);else if(ft.operator===LogicalOperator.AND)return[]}return _t},ut=this._myIndex.records,pt={},yt=[];return ut.forEach(({$:ft,i:mt})=>{if(isDefined(ft)){let kt=dt(ct,ft,mt);kt.length&&(pt[mt]||(pt[mt]={idx:mt,item:ft,matches:[]},yt.push(pt[mt])),kt.forEach(({matches:_t})=>{pt[mt].matches.push(..._t)}))}}),yt}_searchObjectList(it){const ct=createSearcher(it,this.options),{keys:dt,records:ut}=this._myIndex,pt=[];return ut.forEach(({$:yt,i:ft})=>{if(!isDefined(yt))return;let mt=[];dt.forEach((kt,_t)=>{mt.push(...this._findMatches({key:kt,value:yt[_t],searcher:ct}))}),mt.length&&pt.push({idx:ft,item:yt,matches:mt})}),pt}_findMatches({key:it,value:ct,searcher:dt}){if(!isDefined(ct))return[];let ut=[];if(isArray(ct))ct.forEach(({v:pt,i:yt,n:ft})=>{if(!isDefined(pt))return;const{isMatch:mt,score:kt,indices:_t}=dt.searchIn(pt);mt&&ut.push({score:kt,key:it,value:pt,idx:yt,norm:ft,indices:_t})});else{const{v:pt,n:yt}=ct,{isMatch:ft,score:mt,indices:kt}=dt.searchIn(pt);ft&&ut.push({score:mt,key:it,value:pt,norm:yt,indices:kt})}return ut}}Fuse.version="7.1.0";Fuse.createIndex=createIndex;Fuse.parseIndex=parseIndex;Fuse.config=Config;Fuse.parseQuery=parse;register(ExtendedSearch);const INDEX_BY_LANGUAGE={en:"/search/index.en.json",ru:"/search/index.ru.json"},DEFAULT_LIMIT=10,MIN_QUERY_LENGTH$1=2,PREVIEW_CONTEXT_BEFORE=55,PREVIEW_CONTEXT_AFTER=145,MAX_RESULTS_PER_PAGE=3,RAW_RESULT_MULTIPLIER=12,RAW_RESULT_FLOOR=120,documentCache=new Map,fuseCache=new Map,fuseOptions={includeScore:!0,includeMatches:!0,ignoreLocation:!0,threshold:.35,minMatchCharLength:MIN_QUERY_LENGTH$1,keys:[{name:"title",weight:.45},{name:"headings",weight:.3},{name:"content",weight:.25}]};function resolveSearchLanguage(rt){const it=rt.toLowerCase();return it==="ru"||it.startsWith("ru-")?"ru":"en"}async function fetchSearchIndex(rt){const it=await fetch(INDEX_BY_LANGUAGE[rt],{cache:"no-cache"});if(!it.ok)throw new Error(`Failed to load search index for "${rt}"`);const ct=await it.json();if(Array.isArray(ct))return ct;if(ct&&typeof ct=="object"&&"documents"in ct&&Array.isArray(ct.documents))return ct.documents;throw new Error(`Invalid search index format for "${rt}"`)}async function getDocuments(rt){let it=documentCache.get(rt);return it||(it=fetchSearchIndex(rt),documentCache.set(rt,it)),it}async function getFuseInstance(rt){let it=fuseCache.get(rt);return it||(it=getDocuments(rt).then(ct=>new Fuse(ct,fuseOptions)),fuseCache.set(rt,it)),it}function getQueryTokens(rt){return rt.toLowerCase().split(/\s+/).map(it=>it.trim()).filter(it=>it.length>=MIN_QUERY_LENGTH$1)}function documentContainsAllTokens(rt,it){const ct=`${rt.title}
-${rt.section||""}
-${rt.headings.join(`
-`)}
-${rt.content}`.toLowerCase();return it.every(dt=>ct.includes(dt))}function buildSnippet(rt,it,ct){const dt=Math.max(0,it-PREVIEW_CONTEXT_BEFORE),ut=Math.min(rt.length,it+ct+PREVIEW_CONTEXT_AFTER),pt=dt>0?"...":"",yt=ut<rt.length?"...":"",ft=rt.slice(dt,ut).trim();return ft?`${pt}${ft}${yt}`:rt.slice(0,PREVIEW_CONTEXT_AFTER).trim()}function buildPreviewFromMatch(rt,it){const ct=rt.item.excerpt,dt=[rt.item.content,rt.item.section||"",rt.item.title,...rt.item.headings];for(const ft of dt){const mt=ft.toLowerCase();for(const kt of it){const _t=mt.indexOf(kt);if(_t>=0)return buildSnippet(ft,_t,kt.length)}}const ut=rt.matches?.find(ft=>typeof ft.value=="string"&&ft.indices&&ft.indices.length>0);if(!ut||typeof ut.value!="string"||!ut.indices||ut.indices.length===0)return ct;const[pt,yt]=ut.indices[0];return buildSnippet(ut.value,pt,yt-pt+1)||ct}async function searchDocumentation({query:rt,language:it,limit:ct=DEFAULT_LIMIT}){const dt=rt.trim();if(dt.length<MIN_QUERY_LENGTH$1)return[];const ut=getQueryTokens(dt),pt=await getFuseInstance(it),yt=Math.max(ct*RAW_RESULT_MULTIPLIER,RAW_RESULT_FLOOR),ft=pt.search(dt,{limit:yt}),mt=new Set,kt=ft.filter(St=>documentContainsAllTokens(St.item,ut)).map(St=>({...St.item,score:St.score??1,preview:buildPreviewFromMatch(St,ut),pagePath:St.item.path.split("#")[0]})).filter(St=>{const It=`${St.path}::${St.preview}`;return mt.has(It)?!1:(mt.add(It),!0)}),_t=new Map;for(const St of kt){const It=_t.get(St.pagePath)||{visible:[],hidden:[]};It.visible.length<MAX_RESULTS_PER_PAGE?It.visible.push(St):It.hidden.push(St),_t.set(St.pagePath,It)}const vt=new Set;for(const St of _t.values())for(const It of St.visible)vt.add(It.id);const bt=new Map;for(const[St,It]of _t.entries())bt.set(St,It.hidden);const Mt=new Set;return kt.filter(St=>vt.has(St.id)).map(St=>{if(!Mt.has(St.pagePath)){Mt.add(St.pagePath);const It=bt.get(St.pagePath)||[];if(It.length>0)return{...St,moreMatches:It}}return St}).slice(0,ct)}const MIN_QUERY_LENGTH=2,MAX_RESULTS=20,SEARCH_DEBOUNCE_MS=120;function SearchResults({query:rt,isLoading:it,hasError:ct,results:dt,expandedPages:ut,onSelectResult:pt,onTogglePageMatches:yt,t:ft}){return rt.trim().length<MIN_QUERY_LENGTH?jsxRuntimeExports.jsx("p",{className:"docs-search-state docs-search-state--hint",children:ft("docsSearch.typeToSearch")}):it?jsxRuntimeExports.jsxs("div",{className:"docs-search-state docs-search-state--loading",children:[jsxRuntimeExports.jsx(LoaderCircle,{className:"h-4 w-4 animate-spin"}),jsxRuntimeExports.jsx("span",{children:ft("docsSearch.loading")})]}):ct?jsxRuntimeExports.jsx("p",{className:"docs-search-state docs-search-state--error",children:ft("docsSearch.error")}):dt.length===0?jsxRuntimeExports.jsx("p",{className:"docs-search-state docs-search-state--empty",children:ft("docsSearch.noResults")}):jsxRuntimeExports.jsx("ul",{className:"docs-search-results-list",children:dt.map(mt=>jsxRuntimeExports.jsxs("li",{children:[jsxRuntimeExports.jsxs("button",{type:"button",className:"docs-search-result-item",onClick:()=>pt(mt),children:[jsxRuntimeExports.jsx("span",{className:"docs-search-result-title",children:mt.title}),mt.section&&jsxRuntimeExports.jsx("span",{className:"docs-search-result-section",children:mt.section}),jsxRuntimeExports.jsx("span",{className:"docs-search-result-excerpt",children:mt.preview})]}),mt.moreMatches&&mt.moreMatches.length>0&&jsxRuntimeExports.jsxs("div",{className:"docs-search-more-wrapper",children:[jsxRuntimeExports.jsx("button",{type:"button",className:"docs-search-more-toggle",onClick:()=>yt(mt.pagePath),children:ut.has(mt.pagePath)?ft("docsSearch.hideMoreMatches"):ft("docsSearch.showMoreMatches",{count:mt.moreMatches.length})}),ut.has(mt.pagePath)&&jsxRuntimeExports.jsx("ul",{className:"docs-search-more-list",children:mt.moreMatches.map(kt=>jsxRuntimeExports.jsx("li",{children:jsxRuntimeExports.jsxs("button",{type:"button",className:"docs-search-result-item docs-search-result-item--nested",onClick:()=>pt(kt),children:[kt.section&&jsxRuntimeExports.jsx("span",{className:"docs-search-result-section",children:kt.section}),jsxRuntimeExports.jsx("span",{className:"docs-search-result-excerpt",children:kt.preview})]})},kt.id))})]})]},mt.id))})}function DocsSearch(){const rt=useNavigate(),{t:it,i18n:ct}=useTranslation(),dt=reactExports.useRef(null),ut=reactExports.useRef(null),[pt,yt]=reactExports.useState(""),[ft,mt]=reactExports.useState(""),[kt,_t]=reactExports.useState(!1),[vt,bt]=reactExports.useState(!1),[Mt,wt]=reactExports.useState(!1),[St,It]=reactExports.useState(!1),[Nt,$t]=reactExports.useState([]),[Et,Ft]=reactExports.useState(new Set),qt=reactExports.useMemo(()=>resolveSearchLanguage(ct.language),[ct.language]),Ht=kt?ft:pt;reactExports.useEffect(()=>{const oa=Ht.trim();if(oa.length<MIN_QUERY_LENGTH){$t([]),wt(!1),It(!1),Ft(new Set);return}let la=!1;const Kt=window.setTimeout(async()=>{wt(!0),It(!1);try{const ra=await searchDocumentation({query:oa,language:qt,limit:MAX_RESULTS});la||($t(ra),Ft(new Set))}catch(ra){console.error("Search failed:",ra),la||(It(!0),$t([]))}finally{la||wt(!1)}},SEARCH_DEBOUNCE_MS);return()=>{la=!0,window.clearTimeout(Kt)}},[Ht,qt]),reactExports.useEffect(()=>{const oa=la=>{dt.current&&(dt.current.contains(la.target)||bt(!1))};return document.addEventListener("mousedown",oa),()=>{document.removeEventListener("mousedown",oa)}},[]),reactExports.useEffect(()=>{const oa=la=>{la.key==="Escape"&&(bt(!1),_t(!1))};return document.addEventListener("keydown",oa),()=>{document.removeEventListener("keydown",oa)}},[]),reactExports.useEffect(()=>{if(!kt)return;const oa=window.requestAnimationFrame(()=>{ut.current?.focus()});return()=>{window.cancelAnimationFrame(oa)}},[kt]);const Ot=oa=>{rt(oa.path,{state:{docSearchQuery:Ht.trim()}}),yt(""),mt(""),$t([]),bt(!1),_t(!1),Ft(new Set)},Zt=oa=>{Ft(la=>{const Kt=new Set(la);return Kt.has(oa)?Kt.delete(oa):Kt.add(oa),Kt})},Yt=()=>{mt(pt),_t(!0)},aa=()=>{_t(!1)},Qt=vt&&pt.trim().length>=MIN_QUERY_LENGTH;return jsxRuntimeExports.jsxs(jsxRuntimeExports.Fragment,{children:[jsxRuntimeExports.jsxs("div",{ref:dt,className:"docs-search-desktop hidden md:block",children:[jsxRuntimeExports.jsxs("div",{className:"docs-search-input-wrapper",children:[jsxRuntimeExports.jsx(Search,{className:"docs-search-input-icon"}),jsxRuntimeExports.jsx("input",{type:"text",value:pt,onChange:oa=>{const la=oa.target.value;yt(la),la.trim().length>=MIN_QUERY_LENGTH?bt(!0):bt(!1)},onFocus:()=>{pt.trim().length>=MIN_QUERY_LENGTH&&bt(!0)},placeholder:it("docsSearch.placeholder"),className:"docs-search-input"}),pt&&jsxRuntimeExports.jsx("button",{type:"button",className:"docs-search-clear",onClick:()=>{yt(""),bt(!1),Ft(new Set)},"aria-label":it("docsSearch.clear"),children:jsxRuntimeExports.jsx(X$3,{className:"h-4 w-4"})})]}),Qt&&jsxRuntimeExports.jsx("div",{className:"docs-search-dropdown",children:jsxRuntimeExports.jsx(SearchResults,{query:pt,isLoading:Mt,hasError:St,results:Nt,expandedPages:Et,onSelectResult:Ot,onTogglePageMatches:Zt,t:it})})]}),jsxRuntimeExports.jsx("div",{className:"md:hidden",children:jsxRuntimeExports.jsx("button",{type:"button",className:"docs-search-mobile-trigger",onClick:Yt,"aria-label":it("docsSearch.open"),children:jsxRuntimeExports.jsx(Search,{className:"h-5 w-5"})})}),kt&&jsxRuntimeExports.jsxs("div",{className:"docs-search-mobile-overlay md:hidden",children:[jsxRuntimeExports.jsx("button",{type:"button",className:"docs-search-mobile-backdrop",onClick:aa,"aria-label":it("docsSearch.close")}),jsxRuntimeExports.jsxs("div",{className:"docs-search-mobile-sheet",children:[jsxRuntimeExports.jsxs("div",{className:"docs-search-mobile-top",children:[jsxRuntimeExports.jsxs("div",{className:"docs-search-input-wrapper docs-search-input-wrapper--mobile",children:[jsxRuntimeExports.jsx(Search,{className:"docs-search-input-icon"}),jsxRuntimeExports.jsx("input",{ref:ut,type:"text",value:ft,onChange:oa=>{mt(oa.target.value)},placeholder:it("docsSearch.mobilePlaceholder"),className:"docs-search-input"}),ft&&jsxRuntimeExports.jsx("button",{type:"button",className:"docs-search-clear",onClick:()=>{mt(""),Ft(new Set)},"aria-label":it("docsSearch.clear"),children:jsxRuntimeExports.jsx(X$3,{className:"h-4 w-4"})})]}),jsxRuntimeExports.jsx("button",{type:"button",className:"docs-search-mobile-close",onClick:aa,children:it("docsSearch.cancel")})]}),jsxRuntimeExports.jsx("div",{className:"docs-search-mobile-results",children:jsxRuntimeExports.jsx(SearchResults,{query:ft,isLoading:Mt,hasError:St,results:Nt,expandedPages:Et,onSelectResult:Ot,onTogglePageMatches:Zt,t:it})})]})]})]})}function DocsHeader(){const it=useLocation().pathname.split("/").filter(ct=>ct&&ct!=="docs");return jsxRuntimeExports.jsx("header",{className:"sticky top-0 z-30 w-full border-b border-gray-200 dark:border-gray-800 bg-white/80 dark:bg-gray-950/80 backdrop-blur supports-[backdrop-filter]:bg-white/60",children:jsxRuntimeExports.jsxs("div",{className:"flex h-14 items-center gap-4 px-4 md:px-8",children:[jsxRuntimeExports.jsxs("nav",{className:"hidden md:flex items-center text-sm text-gray-500 dark:text-gray-400 overflow-hidden whitespace-nowrap",children:[jsxRuntimeExports.jsx(Link$1,{to:"/docs",className:"hover:text-gray-900 dark:hover:text-gray-100 transition-colors flex-shrink-0",children:jsxRuntimeExports.jsx(House,{className:"w-4 h-4"})}),it.map((ct,dt)=>{const ut=`/docs/${it.slice(0,dt+1).join("/")}`,pt=dt===it.length-1,yt=ct.charAt(0).toUpperCase()+ct.slice(1).replace(/-/g," ");return jsxRuntimeExports.jsxs("div",{className:"flex items-center flex-shrink-0",children:[jsxRuntimeExports.jsx(ChevronRight,{className:"w-4 h-4 mx-1 flex-shrink-0"}),pt?jsxRuntimeExports.jsx("span",{className:"font-medium text-gray-900 dark:text-gray-100 truncate",children:yt}):jsxRuntimeExports.jsx(Link$1,{to:ut,className:"hover:text-gray-900 dark:hover:text-gray-100 transition-colors truncate",children:yt})]},ut)})]}),jsxRuntimeExports.jsx("div",{className:"flex-1"}),jsxRuntimeExports.jsx(DocsSearch,{})]})})}function MarkdownPage({path:rt}){const it=useParams(),ct=useLocation(),{i18n:dt}=useTranslation(),[ut,pt]=reactExports.useState(""),[yt,ft]=reactExports.useState(!0),[mt,kt]=reactExports.useState(null),[_t,vt]=reactExports.useState(""),[bt,Mt]=reactExports.useState({prev:null,next:null});return reactExports.useEffect(()=>{(async()=>{ft(!0),kt(null);try{let St;if(rt)St=rt;else if(it.section)St=`${it.category}/${it.subcategory}/${it.subsubcategory}/${it.section}/${it.page}`;else if(it.subsubcategory)St=`${it.category}/${it.subcategory}/${it.subsubcategory}/${it.page}`;else if(it.subcategory)St=`${it.category}/${it.subcategory}/${it.page}`;else if(it.category&&it.page)St=`${it.category}/${it.page}`;else throw new Error("Invalid route parameters");const It=async Ot=>{const Zt=await fetch(Ot);if(!Zt.ok)return null;const Yt=Zt.headers.get("content-type");return Yt&&Yt.includes("text/html")?null:Zt.text()},$t=(Ot=>Ot.startsWith("guide/")?Ot.slice(6):Ot.startsWith("ru-guide/")?Ot.slice(9):Ot.startsWith("blog/")?Ot.slice(5):Ot)(St),Et=St.startsWith("blog/");let Ft=[];if(Et)Ft=[`/docs/blog/${$t}.md`];else{const Ot=dt.language==="ru"?"ru-guide":"guide";Ft=[`/docs/${Ot}/${$t}.md`,`/docs/guide/${$t}.md`],it.page&&Ft.push(`/docs/${Ot}/${$t}/${it.page}.md`,`/docs/guide/${$t}/${it.page}.md`)}let qt=null;for(const Ot of Ft)if(qt=await It(Ot),qt)break;if(!qt)throw new Error("Documentation page not found (checked language + fallback).");pt(qt);const Ht=Et?`blog/${$t}.md`:`${dt.language==="ru"?"ru-guide":"guide"}/${$t}.md`;vt(Ht)}catch(St){console.error("Error loading markdown:",St),kt(St instanceof Error?St.message:"An unexpected error occurred")}finally{ft(!1)}})()},[rt,it.category,it.subcategory,it.subsubcategory,it.section,it.page,dt.language]),reactExports.useEffect(()=>{const wt=loadSidebarConfig(),{prev:St,next:It}=getPrevNext(wt,ct.pathname);Mt({prev:St,next:It})},[ct.pathname]),reactExports.useEffect(()=>{if(yt||!ut)return;const wt=ct.hash.replace(/^#/,"");if(!wt)return;const St=decodeURIComponent(wt);let It=0;const Nt=20,$t=()=>{const Ft=document.getElementById(St);if(!Ft)return!1;const qt=Ft.getBoundingClientRect().top+window.scrollY-88;return window.scrollTo({top:Math.max(0,qt),behavior:"smooth"}),!0};if($t())return;const Et=window.setInterval(()=>{It+=1,($t()||It>=Nt)&&window.clearInterval(Et)},120);return()=>{window.clearInterval(Et)}},[yt,ut,ct.hash]),reactExports.useEffect(()=>{if(yt||!ut)return;const St=ct.state?.docSearchQuery?.trim();if(!St||St.length<2)return;const It=document.querySelector(".markdown-body");if(!It)return;const Nt=()=>{It.querySelectorAll("mark.docs-search-hit").forEach(Ht=>{const Ot=Ht.parentNode;Ot&&(Ot.replaceChild(document.createTextNode(Ht.textContent||""),Ht),Ot.normalize())})},$t=qt=>{const Ht=St.toLowerCase(),Ot=decodeURIComponent(ct.hash.replace(/^#/,"")),Zt=Ot?document.getElementById(Ot):null,Yt=document.createTreeWalker(It,NodeFilter.SHOW_TEXT);let aa=!qt||!Zt;for(;Yt.nextNode();){const Qt=Yt.currentNode,oa=Qt.parentElement,la=Qt.nodeValue||"";if(!oa||!la.trim())continue;if(!aa&&Zt){const Gt=(Zt.compareDocumentPosition(oa)&Node.DOCUMENT_POSITION_FOLLOWING)!==0,_a=Zt.contains(oa)||Zt===oa;if(Gt||_a)aa=!0;else continue}const Kt=la.toLowerCase().indexOf(Ht);if(Kt===-1)continue;const ra=document.createRange();ra.setStart(Qt,Kt),ra.setEnd(Qt,Kt+St.length);const Ut=document.createElement("mark");return Ut.className="docs-search-hit",ra.surroundContents(Ut),Ut}return null};Nt();const Et=$t(!0)||$t(!1);if(!Et)return;const Ft=Et.getBoundingClientRect().top+window.scrollY-100;window.scrollTo({top:Math.max(0,Ft),behavior:"smooth"})},[yt,ut,ct.hash,ct.key,ct.state]),yt?jsxRuntimeExports.jsx("div",{className:"flex items-center justify-center min-h-[60vh]",children:jsxRuntimeExports.jsxs("div",{className:"text-center",children:[jsxRuntimeExports.jsx(LoaderCircle,{className:"w-12 h-12 text-blue-600 animate-spin mx-auto mb-4"}),jsxRuntimeExports.jsx("p",{className:"text-gray-600 dark:text-gray-400",children:"Loading documentation..."})]})}):mt?jsxRuntimeExports.jsx("div",{className:"flex items-center justify-center min-h-[60vh]",children:jsxRuntimeExports.jsxs("div",{className:"text-center max-w-md",children:[jsxRuntimeExports.jsx(CircleAlert,{className:"w-12 h-12 text-red-500 mx-auto mb-4"}),jsxRuntimeExports.jsx("h2",{className:"text-2xl font-bold text-gray-900 dark:text-white mb-2",children:"Failed to Load Page"}),jsxRuntimeExports.jsx("p",{className:"text-gray-600 dark:text-gray-400 mb-4",children:mt}),jsxRuntimeExports.jsx("p",{className:"text-sm text-gray-500",children:"Please check the URL or try again later."})]})}):jsxRuntimeExports.jsxs("div",{className:"flex flex-col min-h-screen bg-white dark:bg-gray-950",children:[jsxRuntimeExports.jsx(DocsHeader,{}),jsxRuntimeExports.jsxs("div",{className:"flex-1 w-full max-w-4xl mx-auto px-4 md:px-8 py-8",children:[jsxRuntimeExports.jsx(MarkdownContent,{content:ut,options:{enableToc:!0,enableCodeFocus:!0,enableHtmlBlocks:!0,enableLinkProcessing:!0,tocDepth:{min:2,max:4}}}),jsxRuntimeExports.jsxs("div",{className:"mt-16 pt-8 border-t border-gray-200 dark:border-gray-800",children:[jsxRuntimeExports.jsx("div",{className:"flex justify-end mb-8",children:jsxRuntimeExports.jsxs("a",{href:`https://github.com/easyp-tech/easyp/edit/main/docs/public/docs/${_t}`,target:"_blank",rel:"noopener noreferrer",className:"flex items-center text-sm text-gray-500 hover:text-blue-600 dark:text-gray-400 dark:hover:text-blue-400 transition-colors",children:[jsxRuntimeExports.jsx(Github,{className:"w-4 h-4 mr-2"}),"Edit this page on GitHub"]})}),jsxRuntimeExports.jsxs("div",{className:"grid grid-cols-2 gap-4",children:[bt.prev?jsxRuntimeExports.jsxs(Link$1,{to:bt.prev.path,className:"flex flex-col p-4 rounded-lg border border-gray-200 dark:border-gray-800 hover:border-blue-500 dark:hover:border-blue-500 transition-colors group",children:[jsxRuntimeExports.jsxs("span",{className:"text-xs text-gray-500 dark:text-gray-400 mb-1 flex items-center",children:[jsxRuntimeExports.jsx(ChevronLeft,{className:"w-3 h-3 mr-1"}),"Previous"]}),jsxRuntimeExports.jsx("span",{className:"font-medium text-blue-600 dark:text-blue-400 group-hover:underline truncate",children:bt.prev.title})]}):jsxRuntimeExports.jsx("div",{}),bt.next&&jsxRuntimeExports.jsxs(Link$1,{to:bt.next.path,className:"flex flex-col items-end p-4 rounded-lg border border-gray-200 dark:border-gray-800 hover:border-blue-500 dark:hover:border-blue-500 transition-colors group",children:[jsxRuntimeExports.jsxs("span",{className:"text-xs text-gray-500 dark:text-gray-400 mb-1 flex items-center",children:["Next",jsxRuntimeExports.jsx(ChevronRight,{className:"w-3 h-3 ml-1"})]}),jsxRuntimeExports.jsx("span",{className:"font-medium text-blue-600 dark:text-blue-400 group-hover:underline truncate",children:bt.next.title})]})]})]})]})]})}function NotFound(){return jsxRuntimeExports.jsxs("div",{className:"flex flex-col items-center justify-center min-h-[60vh] px-4 text-center",children:[jsxRuntimeExports.jsx("div",{className:"mb-8",children:jsxRuntimeExports.jsx(FileQuestionMark,{className:"w-24 h-24 text-gray-400 mx-auto mb-4"})}),jsxRuntimeExports.jsx("h1",{className:"text-4xl font-bold text-gray-900 dark:text-white mb-4",children:"Page Not Found"}),jsxRuntimeExports.jsx("p",{className:"text-lg text-gray-600 dark:text-gray-400 mb-8 max-w-md",children:"The documentation page you're looking for doesn't exist. It may have been moved or deleted."}),jsxRuntimeExports.jsxs("div",{className:"flex flex-col sm:flex-row gap-4",children:[jsxRuntimeExports.jsxs(Link$1,{to:"/docs",className:"inline-flex items-center gap-2 px-6 py-3 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition-colors",children:[jsxRuntimeExports.jsx(House,{className:"w-5 h-5"}),"Go to Documentation Home"]}),jsxRuntimeExports.jsx(Link$1,{to:"/",className:"inline-flex items-center gap-2 px-6 py-3 border border-gray-300 dark:border-gray-700 text-gray-700 dark:text-gray-300 rounded-lg hover:bg-gray-50 dark:hover:bg-gray-800 transition-colors",children:"Back to Main Site"})]}),jsxRuntimeExports.jsxs("div",{className:"mt-12 text-sm text-gray-500 dark:text-gray-500",children:[jsxRuntimeExports.jsx("p",{className:"mb-2",children:"Looking for something specific?"}),jsxRuntimeExports.jsxs("ul",{className:"space-y-1",children:[jsxRuntimeExports.jsx("li",{children:jsxRuntimeExports.jsx(Link$1,{to:"/docs/introduction/what-is",className:"text-blue-600 hover:underline",children:"What is EasyP?"})}),jsxRuntimeExports.jsx("li",{children:jsxRuntimeExports.jsx(Link$1,{to:"/docs/introduction/quickstart",className:"text-blue-600 hover:underline",children:"Quickstart Guide"})}),jsxRuntimeExports.jsx("li",{children:jsxRuntimeExports.jsx(Link$1,{to:"/docs/introduction/install",className:"text-blue-600 hover:underline",children:"Installation"})})]})]})]})}function DocsRoutes(){return jsxRuntimeExports.jsx(TocProvider,{children:jsxRuntimeExports.jsx(Routes,{children:jsxRuntimeExports.jsxs(Route$1,{path:"/",element:jsxRuntimeExports.jsx(DocsLayout,{}),children:[jsxRuntimeExports.jsx(Route$1,{index:!0,element:jsxRuntimeExports.jsx(MarkdownPage,{path:"guide/introduction/what-is"})}),jsxRuntimeExports.jsx(Route$1,{path:":category/:page",element:jsxRuntimeExports.jsx(MarkdownPage,{})}),jsxRuntimeExports.jsx(Route$1,{path:":category/:subcategory/:page",element:jsxRuntimeExports.jsx(MarkdownPage,{})}),jsxRuntimeExports.jsx(Route$1,{path:":category/:subcategory/:subsubcategory/:page",element:jsxRuntimeExports.jsx(MarkdownPage,{})}),jsxRuntimeExports.jsx(Route$1,{path:":category/:subcategory/:subsubcategory/:section/:page",element:jsxRuntimeExports.jsx(MarkdownPage,{})}),jsxRuntimeExports.jsx(Route$1,{path:"*",element:jsxRuntimeExports.jsx(NotFound,{})})]})})})}class ErrorBoundary extends reactExports.Component{state={hasError:!1,error:null};static getDerivedStateFromError(it){return{hasError:!0,error:it}}componentDidCatch(it,ct){console.error("Uncaught error:",it,ct)}render(){return this.state.hasError?jsxRuntimeExports.jsxs("div",{className:"p-6 bg-red-500/10 border border-red-500/20 rounded-lg text-red-200",children:[jsxRuntimeExports.jsx("h2",{className:"text-xl font-bold mb-2",children:"Something went wrong"}),jsxRuntimeExports.jsx("p",{className:"mb-4",children:"We encountered an error while rendering this page."}),jsxRuntimeExports.jsx("pre",{className:"bg-slate-900 p-4 rounded overflow-auto text-sm font-mono",children:this.state.error?.toString()})]}):this.props.children}}function App(){return jsxRuntimeExports.jsx(BrowserRouter,{children:jsxRuntimeExports.jsxs(Routes,{children:[jsxRuntimeExports.jsx(Route$1,{path:"/",element:jsxRuntimeExports.jsx(HomePage,{})}),jsxRuntimeExports.jsx(Route$1,{path:"/blog",element:jsxRuntimeExports.jsx(BlogPage,{})}),jsxRuntimeExports.jsx(Route$1,{path:"/blog/:slug",element:jsxRuntimeExports.jsx(BlogPostPage,{})}),jsxRuntimeExports.jsx(Route$1,{path:"/docs/*",element:jsxRuntimeExports.jsx(ErrorBoundary,{children:jsxRuntimeExports.jsx(DocsRoutes,{})})}),jsxRuntimeExports.jsx(Route$1,{path:"*",element:jsxRuntimeExports.jsx("div",{children:"404 Not Found"})})]})})}const nav$1={features:"Features",registry:"Registry",enterprise:"Enterprise",documentation:"Docs",blog:"Blog",github:"GitHub",sponsor:"Sponsor",getStarted:"Get Started"},hero$1={badge:{beta:"Beta",license:"Apache 2.0 License"},title:"The Modern Standard for",titleHighlight:"Protobuf Workflows",subtitle:"A unified Git-native toolkit for linting, code generation, and dependency management. Fully Open Source.",exploreDocs:"Explore Documentation"},docsSearch$1={placeholder:"Search docs...",mobilePlaceholder:"Search documentation...",open:"Open search",close:"Close search",cancel:"Cancel",clear:"Clear search",loading:"Searching...",noResults:"No results found",showMoreMatches:"Show {{count}} more matches on this page",hideMoreMatches:"Hide additional matches",typeToSearch:"Type at least 2 characters to search",error:"Unable to load search index. Try again later."},trustedBy$1={title:"Trusted by engineering teams at"},features$1={title:"Two modes.",titleHighlight:"One platform.",subtitle:"EasyP combines a developer-friendly CLI with a powerful remote execution engine.",localDev:"Local Development",remoteInfra:"Remote Infrastructure",cli:{title:"Supercharge your workflow",description:"All tools in a single binary. Linting, formatting, and breaking change detection work instantly.",packageManager:{title:"Package Manager",desc:"Version management via easyp.lock. Like npm, but for Protobuf."},linting:{title:"Instant Linting",desc:"100% compatibility with Buf rules"},apiSafety:{title:"API Safety",desc:"Backward compatibility checks in CI"}},server:{title:"Your infrastructure, your rules",description:'Forget "works on my machine" problems. Centralized generation server guarantees identical results for the entire team.',dockerNative:{title:"Docker Native",desc:"Run any plugins (Java, Python, Node) in containers"},airGap:{title:"Air-Gap Ready",desc:"Works in completely isolated environments"},costEffective:{title:"Cost Effective",desc:"Pay for infrastructure, not per user"}}},architecture$1={title:"Why EasyP is the smarter choice",subtitle:"A fundamental shift in how you manage Protobuf infrastructure.",dataSovereignty:{title:"Data Sovereignty",description:"Unlike SaaS solutions where schemas live in the cloud, EasyP is <strong>Git-Native</strong>. Your data never leaves your secure repositories."},hybridRuntime:{title:"Hybrid Runtime",description:"Don't choose between speed and compatibility. EasyP uses <strong>Wasm</strong> for speed and <strong>Docker</strong> for heavy plugins."},noVendorLock:{title:"No Vendor Lock-in",description:"The entire platform is <strong>Open Source</strong> (Apache 2.0). Host the server yourself, anywhere. No per-user pricing tax."}},footer$1={description:"The open-source standard for Protobuf workflows. Built for modern engineering teams.",product:{title:"Product",cliTool:"CLI Tool",apiService:"API Service",registry:"Registry",documentation:"Documentation",enterprise:"Enterprise"},community:{title:"Community",github:"GitHub",telegram:"Telegram",youtube:"YouTube"},rights:"© 2025 EasyP Tech. All rights reserved.",privacy:"Privacy",terms:"Terms",license:"Licensed under Apache 2.0"},en={nav:nav$1,hero:hero$1,docsSearch:docsSearch$1,trustedBy:trustedBy$1,features:features$1,architecture:architecture$1,footer:footer$1},nav={features:"Возможности",registry:"Registry",enterprise:"Enterprise",documentation:"Docs",blog:"Blog",github:"GitHub",sponsor:"Поддержать",getStarted:"Начать"},hero={badge:{beta:"Beta",license:"Лицензия Apache 2.0"},title:"Современный стандарт для",titleHighlight:"Protobuf Workflows",subtitle:"Единый Git-native инструментарий для линтинга, генерации кода и управления зависимостями. Полностью Open Source.",exploreDocs:"Изучить документацию"},docsSearch={placeholder:"Поиск по документации...",mobilePlaceholder:"Введите запрос для поиска...",open:"Открыть поиск",close:"Закрыть поиск",cancel:"Отмена",clear:"Очистить поиск",loading:"Ищем...",noResults:"Ничего не найдено",showMoreMatches:"Показать ещё {{count}} совпадений на этой странице",hideMoreMatches:"Скрыть дополнительные совпадения",typeToSearch:"Введите минимум 2 символа",error:"Не удалось загрузить поисковый индекс. Попробуйте позже."},trustedBy={title:"Нам доверяют команды разработчиков из"},features={title:"Два режима.",titleHighlight:"Одна платформа.",subtitle:"EasyP сочетает удобный CLI для разработчиков с мощным движком удаленного выполнения.",localDev:"Локальная разработка",remoteInfra:"Удаленная инфраструктура",cli:{title:"Ускорьте свой рабочий процесс",description:"Все инструменты в одном бинарнике. Линтинг, форматирование и детекция breaking changes работают мгновенно.",packageManager:{title:"Package Manager",desc:"Управление версиями через easyp.lock. Как npm, но для Protobuf."},linting:{title:"Instant Linting",desc:"100% совместимость с правилами Buf"},apiSafety:{title:"API Safety",desc:"Проверка обратной совместимости в CI"}},server:{title:"Ваша инфраструктура, ваши правила",description:'Забудьте о проблеме "works on my machine". Централизованный сервер генерации гарантирует идентичный результат для всей команды.',dockerNative:{title:"Docker Native",desc:"Запуск любых плагинов (Java, Python, Node) в контейнерах"},airGap:{title:"Air-Gap Ready",desc:"Работает в полностью изолированных контурах"},costEffective:{title:"Cost Effective",desc:"Платите за инфраструктуру, а не за пользователей"}}},architecture={title:"Почему EasyP — это лучший выбор",subtitle:"Фундаментальный сдвиг в управлении Protobuf-инфраструктурой.",dataSovereignty:{title:"Суверенность данных",description:"В отличие от SaaS-решений, где схемы хранятся в облаке, EasyP является <strong>Git-Native</strong>. Ваши данные никогда не покидают безопасные репозитории."},hybridRuntime:{title:"Гибридная среда выполнения",description:"Не выбирайте между скоростью и совместимостью. EasyP использует <strong>Wasm</strong> для скорости и <strong>Docker</strong> для тяжелых плагинов."},noVendorLock:{title:"Без привязки к поставщику",description:"Вся платформа является <strong>Open Source</strong> (Apache 2.0). Размещайте сервер где угодно. Никакой платы за пользователя."}},footer={description:"Open-source стандарт для Protobuf workflows. Создан для современных инженерных команд.",product:{title:"Продукты",cliTool:"CLI Tool",apiService:"API Service",registry:"Registry",documentation:"Документация",enterprise:"Enterprise"},community:{title:"Сообщество",github:"GitHub",telegram:"Telegram",youtube:"YouTube"},rights:"© 2025 EasyP Tech. Все права защищены.",privacy:"Конфиденциальность",terms:"Условия",license:"Лицензия Apache 2.0"},ru={nav,hero,docsSearch,trustedBy,features,architecture,footer},getSavedLanguage=()=>{const rt=localStorage.getItem("language");return rt||((typeof navigator<"u"?(navigator.languages||[navigator.language]).map(ct=>ct.toLowerCase()):[]).some(ct=>ct==="ru"||ct.startsWith("ru-"))?"ru":"en")};instance.use(initReactI18next).init({resources:{en:{translation:en},ru:{translation:ru}},lng:getSavedLanguage(),fallbackLng:"en",interpolation:{escapeValue:!1}});instance.on("languageChanged",rt=>{localStorage.setItem("language",rt)});globalThis.Buffer=bufferExports.Buffer;clientExports.createRoot(document.getElementById("root")).render(jsxRuntimeExports.jsx(reactExports.StrictMode,{children:jsxRuntimeExports.jsx(App,{})}));export{commonDb_exports as $,rgba$1 as A,__export$1 as B,setupGraphViewbox2 as C,cleanAndMerge as D,getConfig as E,defaultConfig_default as F,random as G,selectSvgElement as H,package_default as I,JSON_SCHEMA as J,getThemeVariables3 as K,hasKatex as L,calculateMathMLDimensions as M,parseFontSize as N,getUrl as O,renderKatexSanitized as P,parseGenericTypes as Q,line$1 as R,curveBasis as S,generateId as T,lineBreakRegex as U,setupGraphViewbox as V,isDark as W,lighten as X,darken as Y,ZERO_WIDTH_SPACE as Z,__name as _,getAccTitle as a,isLabelStyle as a$,withPath as a0,halfPi as a1,epsilon as a2,tau as a3,cos as a4,sin as a5,min as a6,abs$1 as a7,constant$1 as a8,pi as a9,baseRest as aA,isArrayLikeObject as aB,constant as aC,isFunction as aD,isEmpty as aE,computeDimensionOfText as aF,array as aG,getUserDefinedConfig as aH,getDefaultExportFromCjs as aI,getIconSVG as aJ,registerIconPacks as aK,unknownIcon as aL,constant$2 as aM,interpolateNumber as aN,interpolateRgb as aO,interpolateString as aP,color as aQ,isObject$1 as aR,isIterateeCall as aS,keysIn as aT,eq as aU,isArrayLike as aV,isArray$1 as aW,identity as aX,isIndex as aY,assignValue as aZ,styles2String as a_,sqrt as aa,atan2 as ab,asin as ac,acos as ad,max as ae,insertCluster as af,insertNode as ag,positionNode as ah,getLineFunctionsWithOffset as ai,evaluate as aj,createText as ak,getSubGraphTitleMargins as al,replaceIconSubstring as am,decodeEntities as an,getStylesFromArray as ao,Utils as ap,Color$1 as aq,markers_default as ar,clear2 as as,clear as at,clear$1 as au,updateNodeBounds as av,setNodeElem as aw,insertEdge as ax,positionEdgeLabel as ay,insertEdgeLabel as az,setAccTitle as b,Rgb as b0,rgbConvert as b1,define as b2,extend$1 as b3,Color as b4,nogamma as b5,hue as b6,dayjs2 as b7,setToString as b8,overRest as b9,Set$1 as bA,createAssigner as bB,isPrototype as bC,__vitePreload as bD,baseFor as ba,baseAssignValue as bb,baseUnary as bc,merge as bd,isObjectLike$1 as be,baseGetTag as bf,Symbol$1 as bg,arrayLikeKeys as bh,baseKeys as bi,memoize as bj,isArguments as bk,copyObject as bl,getPrototype as bm,cloneArrayBuffer as bn,cloneTypedArray as bo,getTag$1 as bp,nodeUtil as bq,copyArray as br,isBuffer as bs,cloneBuffer as bt,initCloneObject as bu,Stack as bv,MapCache as bw,Uint8Array$1 as bx,isTypedArray as by,isLength as bz,getConfig2 as c,select as d,configureSvgSize as e,assignWithDepth_default as f,getAccDescription as g,calculateTextWidth as h,sanitizeText as i,distExports as j,common_default as k,log as l,calculateTextHeight as m,setConfig2 as n,getRegisteredLayoutAlgorithm as o,setDiagramTitle as p,getDiagramTitle as q,render$1 as r,setAccDescription as s,load as t,utils_default as u,isValidShape as v,wrapLabel as w,getEdgeId as x,clear$2 as y,defaultConfig2 as z};
diff --git a/docs/dist/assets/index-CT4W-tqO.css b/docs/dist/assets/index-CT4W-tqO.css
deleted file mode 100644
index b0f531d7..00000000
--- a/docs/dist/assets/index-CT4W-tqO.css
+++ /dev/null
@@ -1 +0,0 @@
-*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:Inter,sans-serif;font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:JetBrains Mono,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.pointer-events-none{pointer-events:none}.visible{visibility:visible}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.sticky{position:sticky}.-inset-1{inset:-.25rem}.bottom-0{bottom:0}.left-0{left:0}.left-1\/2{left:50%}.right-0{right:0}.top-0{top:0}.top-1\/2{top:50%}.top-full{top:100%}.z-10{z-index:10}.z-20{z-index:20}.z-30{z-index:30}.z-50{z-index:50}.col-span-2{grid-column:span 2 / span 2}.mx-1{margin-left:.25rem;margin-right:.25rem}.mx-auto{margin-left:auto;margin-right:auto}.my-8{margin-top:2rem;margin-bottom:2rem}.mb-1{margin-bottom:.25rem}.mb-10{margin-bottom:2.5rem}.mb-12{margin-bottom:3rem}.mb-16{margin-bottom:4rem}.mb-2{margin-bottom:.5rem}.mb-20{margin-bottom:5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-5{margin-bottom:1.25rem}.mb-6{margin-bottom:1.5rem}.mb-8{margin-bottom:2rem}.ml-1{margin-left:.25rem}.ml-2{margin-left:.5rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-2{margin-right:.5rem}.mt-1{margin-top:.25rem}.mt-12{margin-top:3rem}.mt-16{margin-top:4rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.block{display:block}.inline-block{display:inline-block}.inline{display:inline}.flex{display:flex}.inline-flex{display:inline-flex}.table{display:table}.grid{display:grid}.contents{display:contents}.hidden{display:none}.h-10{height:2.5rem}.h-12{height:3rem}.h-14{height:3.5rem}.h-16{height:4rem}.h-2{height:.5rem}.h-24{height:6rem}.h-3{height:.75rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-\[400px\]{height:400px}.h-\[600px\]{height:600px}.h-\[800px\]{height:800px}.h-full{height:100%}.min-h-\[200px\]{min-height:200px}.min-h-\[60vh\]{min-height:60vh}.min-h-screen{min-height:100vh}.w-10{width:2.5rem}.w-12{width:3rem}.w-14{width:3.5rem}.w-2{width:.5rem}.w-24{width:6rem}.w-3{width:.75rem}.w-4{width:1rem}.w-40{width:10rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[1000px\]{width:1000px}.w-\[100px\]{width:100px}.w-\[800px\]{width:800px}.w-auto{width:auto}.w-full{width:100%}.max-w-2xl{max-width:42rem}.max-w-4xl{max-width:56rem}.max-w-5xl{max-width:64rem}.max-w-7xl{max-width:80rem}.max-w-md{max-width:28rem}.max-w-none{max-width:none}.max-w-xs{max-width:20rem}.flex-1{flex:1 1 0%}.flex-shrink-0,.shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.-translate-x-1\/2{--tw-translate-x: -50%;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.-translate-y-1\/2{--tw-translate-y: -50%;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-180{--tw-rotate: 180deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes fadeInUp{0%{opacity:0;transform:translateY(20px)}to{opacity:1;transform:translateY(0)}}.animate-fade-in-up{animation:fadeInUp .8s ease-out forwards}@keyframes ping{75%,to{transform:scale(2);opacity:0}}.animate-ping{animation:ping 1s cubic-bezier(0,0,.2,1) infinite}@keyframes pulse{50%{opacity:.5}}.animate-pulse{animation:pulse 2s cubic-bezier(.4,0,.6,1) infinite}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-not-allowed{cursor:not-allowed}.cursor-pointer{cursor:pointer}.resize{resize:both}.grid-cols-1{grid-template-columns:repeat(1,minmax(0,1fr))}.grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}.flex-col{flex-direction:column}.items-start{align-items:flex-start}.items-end{align-items:flex-end}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-1{gap:.25rem}.gap-12{gap:3rem}.gap-2{gap:.5rem}.gap-3{gap:.75rem}.gap-4{gap:1rem}.gap-6{gap:1.5rem}.gap-8{gap:2rem}.space-y-1>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(.25rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.25rem * var(--tw-space-y-reverse))}.space-y-2>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(.5rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.5rem * var(--tw-space-y-reverse))}.space-y-3>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(.75rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.75rem * var(--tw-space-y-reverse))}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.space-y-8>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(2rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(2rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-x-auto{overflow-x:auto}.truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.whitespace-nowrap{white-space:nowrap}.whitespace-pre-wrap{white-space:pre-wrap}.rounded{border-radius:.25rem}.rounded-2xl{border-radius:1rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.rounded-xl{border-radius:.75rem}.border{border-width:1px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-b-0{border-bottom-width:0px}.border-l{border-left-width:1px}.border-l-2{border-left-width:2px}.border-r{border-right-width:1px}.border-t{border-top-width:1px}.border-blue-500\/30{border-color:#3b82f64d}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-primary\/20{border-color:#3b82f633}.border-primary\/30{border-color:#3b82f64d}.border-red-500\/20{border-color:#ef444433}.border-red-500\/30{border-color:#ef44444d}.border-slate-600\/30{border-color:#4755694d}.border-slate-700{--tw-border-opacity: 1;border-color:rgb(51 65 85 / var(--tw-border-opacity, 1))}.border-slate-700\/50{border-color:#33415580}.border-slate-800{--tw-border-opacity: 1;border-color:rgb(30 41 59 / var(--tw-border-opacity, 1))}.border-slate-800\/50{border-color:#1e293b80}.border-white\/5{border-color:#ffffff0d}.bg-background{--tw-bg-opacity: 1;background-color:rgb(2 6 23 / var(--tw-bg-opacity, 1))}.bg-blue-500\/10{background-color:#3b82f61a}.bg-blue-500\/20{background-color:#3b82f633}.bg-blue-600{--tw-bg-opacity: 1;background-color:rgb(37 99 235 / var(--tw-bg-opacity, 1))}.bg-emerald-500\/10{background-color:#10b9811a}.bg-green-500\/10{background-color:#22c55e1a}.bg-primary{--tw-bg-opacity: 1;background-color:rgb(59 130 246 / var(--tw-bg-opacity, 1))}.bg-primary\/10{background-color:#3b82f61a}.bg-primary\/20{background-color:#3b82f633}.bg-purple-500\/10{background-color:#a855f71a}.bg-red-500\/10{background-color:#ef44441a}.bg-secondary\/10{background-color:#8b5cf61a}.bg-slate-500{--tw-bg-opacity: 1;background-color:rgb(100 116 139 / var(--tw-bg-opacity, 1))}.bg-slate-600{--tw-bg-opacity: 1;background-color:rgb(71 85 105 / var(--tw-bg-opacity, 1))}.bg-slate-700{--tw-bg-opacity: 1;background-color:rgb(51 65 85 / var(--tw-bg-opacity, 1))}.bg-slate-700\/50{background-color:#33415580}.bg-slate-800{--tw-bg-opacity: 1;background-color:rgb(30 41 59 / var(--tw-bg-opacity, 1))}.bg-slate-800\/50{background-color:#1e293b80}.bg-slate-900{--tw-bg-opacity: 1;background-color:rgb(15 23 42 / var(--tw-bg-opacity, 1))}.bg-slate-900\/30{background-color:#0f172a4d}.bg-slate-900\/50{background-color:#0f172a80}.bg-slate-950{--tw-bg-opacity: 1;background-color:rgb(2 6 23 / var(--tw-bg-opacity, 1))}.bg-slate-950\/50{background-color:#02061780}.bg-slate-950\/80{background-color:#020617cc}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-white\/80{background-color:#fffc}.bg-gradient-to-b{background-image:linear-gradient(to bottom,var(--tw-gradient-stops))}.bg-gradient-to-l{background-image:linear-gradient(to left,var(--tw-gradient-stops))}.bg-gradient-to-r{background-image:linear-gradient(to right,var(--tw-gradient-stops))}.from-background{--tw-gradient-from: #020617 var(--tw-gradient-from-position);--tw-gradient-to: rgb(2 6 23 / 0) var(--tw-gradient-to-position);--tw-gradient-stops: var(--tw-gradient-from), var(--tw-gradient-to)}.from-primary{--tw-gradient-from: #3b82f6 var(--tw-gradient-from-position);--tw-gradient-to: rgb(59 130 246 / 0) var(--tw-gradient-to-position);--tw-gradient-stops: var(--tw-gradient-from), var(--tw-gradient-to)}.from-slate-950{--tw-gradient-from: #020617 var(--tw-gradient-from-position);--tw-gradient-to: rgb(2 6 23 / 0) var(--tw-gradient-to-position);--tw-gradient-stops: var(--tw-gradient-from), var(--tw-gradient-to)}.via-slate-900{--tw-gradient-to: rgb(15 23 42 / 0) var(--tw-gradient-to-position);--tw-gradient-stops: var(--tw-gradient-from), #0f172a var(--tw-gradient-via-position), var(--tw-gradient-to)}.to-secondary{--tw-gradient-to: #8b5cf6 var(--tw-gradient-to-position)}.to-slate-950{--tw-gradient-to: #020617 var(--tw-gradient-to-position)}.to-transparent{--tw-gradient-to: transparent var(--tw-gradient-to-position)}.p-1\.5{padding:.375rem}.p-2{padding:.5rem}.p-4{padding:1rem}.p-6{padding:1.5rem}.p-8{padding:2rem}.px-1{padding-left:.25rem;padding-right:.25rem}.px-1\.5{padding-left:.375rem;padding-right:.375rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0\.5{padding-top:.125rem;padding-bottom:.125rem}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-1\.5{padding-top:.375rem;padding-bottom:.375rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-2\.5{padding-top:.625rem;padding-bottom:.625rem}.py-20{padding-top:5rem;padding-bottom:5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-20{padding-bottom:5rem}.pl-4{padding-left:1rem}.pl-8{padding-left:2rem}.pr-2{padding-right:.5rem}.pt-20{padding-top:5rem}.pt-32{padding-top:8rem}.pt-8{padding-top:2rem}.text-left{text-align:left}.text-center{text-align:center}.align-middle{vertical-align:middle}.font-mono{font-family:JetBrains Mono,monospace}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.text-xl{font-size:1.25rem;line-height:1.75rem}.text-xs{font-size:.75rem;line-height:1rem}.font-bold{font-weight:700}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.italic{font-style:italic}.leading-\[1\.1\]{line-height:1.1}.leading-loose{line-height:2}.leading-relaxed{line-height:1.625}.tracking-tight{letter-spacing:-.025em}.tracking-wider{letter-spacing:.05em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-blue-400{--tw-text-opacity: 1;color:rgb(96 165 250 / var(--tw-text-opacity, 1))}.text-blue-500{--tw-text-opacity: 1;color:rgb(59 130 246 / var(--tw-text-opacity, 1))}.text-blue-600{--tw-text-opacity: 1;color:rgb(37 99 235 / var(--tw-text-opacity, 1))}.text-emerald-400{--tw-text-opacity: 1;color:rgb(52 211 153 / var(--tw-text-opacity, 1))}.text-gray-400{--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-gray-900{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.text-green-400{--tw-text-opacity: 1;color:rgb(74 222 128 / var(--tw-text-opacity, 1))}.text-green-500{--tw-text-opacity: 1;color:rgb(34 197 94 / var(--tw-text-opacity, 1))}.text-primary{--tw-text-opacity: 1;color:rgb(59 130 246 / var(--tw-text-opacity, 1))}.text-purple-400{--tw-text-opacity: 1;color:rgb(192 132 252 / var(--tw-text-opacity, 1))}.text-red-200{--tw-text-opacity: 1;color:rgb(254 202 202 / var(--tw-text-opacity, 1))}.text-red-300{--tw-text-opacity: 1;color:rgb(252 165 165 / var(--tw-text-opacity, 1))}.text-red-400{--tw-text-opacity: 1;color:rgb(248 113 113 / var(--tw-text-opacity, 1))}.text-red-500{--tw-text-opacity: 1;color:rgb(239 68 68 / var(--tw-text-opacity, 1))}.text-secondary{--tw-text-opacity: 1;color:rgb(139 92 246 / var(--tw-text-opacity, 1))}.text-slate-200{--tw-text-opacity: 1;color:rgb(226 232 240 / var(--tw-text-opacity, 1))}.text-slate-300{--tw-text-opacity: 1;color:rgb(203 213 225 / var(--tw-text-opacity, 1))}.text-slate-400{--tw-text-opacity: 1;color:rgb(148 163 184 / var(--tw-text-opacity, 1))}.text-slate-500{--tw-text-opacity: 1;color:rgb(100 116 139 / var(--tw-text-opacity, 1))}.text-slate-600{--tw-text-opacity: 1;color:rgb(71 85 105 / var(--tw-text-opacity, 1))}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.underline{text-decoration-line:underline}.line-through{text-decoration-line:line-through}.decoration-slate-700{text-decoration-color:#334155}.opacity-20{opacity:.2}.opacity-30{opacity:.3}.opacity-40{opacity:.4}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-2xl{--tw-shadow: 0 25px 50px -12px rgb(0 0 0 / .25);--tw-shadow-colored: 0 25px 50px -12px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-inner{--tw-shadow: inset 0 2px 4px 0 rgb(0 0 0 / .05);--tw-shadow-colored: inset 0 2px 4px 0 var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-primary\/10{--tw-shadow-color: rgb(59 130 246 / .1);--tw-shadow: var(--tw-shadow-colored)}.blur{--tw-blur: blur(8px);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.blur-\[120px\]{--tw-blur: blur(120px);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.blur-\[150px\]{--tw-blur: blur(150px);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.drop-shadow{--tw-drop-shadow: drop-shadow(0 1px 2px rgb(0 0 0 / .1)) drop-shadow(0 1px 1px rgb(0 0 0 / .06));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.grayscale{--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.filter{filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.backdrop-blur{--tw-backdrop-blur: blur(8px);-webkit-backdrop-filter:var(--tw-backdrop-blur) var(--tw-backdrop-brightness) var(--tw-backdrop-contrast) var(--tw-backdrop-grayscale) var(--tw-backdrop-hue-rotate) var(--tw-backdrop-invert) var(--tw-backdrop-opacity) var(--tw-backdrop-saturate) var(--tw-backdrop-sepia);backdrop-filter:var(--tw-backdrop-blur) var(--tw-backdrop-brightness) var(--tw-backdrop-contrast) var(--tw-backdrop-grayscale) var(--tw-backdrop-hue-rotate) var(--tw-backdrop-invert) var(--tw-backdrop-opacity) var(--tw-backdrop-saturate) var(--tw-backdrop-sepia)}.backdrop-blur-sm{--tw-backdrop-blur: blur(4px);-webkit-backdrop-filter:var(--tw-backdrop-blur) var(--tw-backdrop-brightness) var(--tw-backdrop-contrast) var(--tw-backdrop-grayscale) var(--tw-backdrop-hue-rotate) var(--tw-backdrop-invert) var(--tw-backdrop-opacity) var(--tw-backdrop-saturate) var(--tw-backdrop-sepia);backdrop-filter:var(--tw-backdrop-blur) var(--tw-backdrop-brightness) var(--tw-backdrop-contrast) var(--tw-backdrop-grayscale) var(--tw-backdrop-hue-rotate) var(--tw-backdrop-invert) var(--tw-backdrop-opacity) var(--tw-backdrop-saturate) var(--tw-backdrop-sepia)}.backdrop-filter{-webkit-backdrop-filter:var(--tw-backdrop-blur) var(--tw-backdrop-brightness) var(--tw-backdrop-contrast) var(--tw-backdrop-grayscale) var(--tw-backdrop-hue-rotate) var(--tw-backdrop-invert) var(--tw-backdrop-opacity) var(--tw-backdrop-saturate) var(--tw-backdrop-sepia);backdrop-filter:var(--tw-backdrop-blur) var(--tw-backdrop-brightness) var(--tw-backdrop-contrast) var(--tw-backdrop-grayscale) var(--tw-backdrop-hue-rotate) var(--tw-backdrop-invert) var(--tw-backdrop-opacity) var(--tw-backdrop-saturate) var(--tw-backdrop-sepia)}.transition{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke,opacity,box-shadow,transform,filter,backdrop-filter;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-transform{transition-property:transform;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-1000{transition-duration:1s}.duration-200{transition-duration:.2s}.duration-300{transition-duration:.3s}.\[animation-delay\:100ms\]{animation-delay:.1s}.\[animation-delay\:200ms\]{animation-delay:.2s}.\[animation-delay\:300ms\]{animation-delay:.3s}.\[animation-delay\:500ms\]{animation-delay:.5s}body{background-color:#020617;color:#e2e8f0;margin:0;padding:0}.bg-glow-gradient{background:radial-gradient(circle at center,rgba(59,130,246,.15) 0%,transparent 70%)}.text-gradient{background:linear-gradient(to right,#60a5fa,#a78bfa);-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}.glass-panel{background:#0f172a99;-webkit-backdrop-filter:blur(12px);backdrop-filter:blur(12px);border:1px solid rgba(255,255,255,.08)}::-webkit-scrollbar{width:8px}::-webkit-scrollbar-track{background:#020617}::-webkit-scrollbar-thumb{background:#334155;border-radius:4px}::-webkit-scrollbar-thumb:hover{background:#475569}.no-scrollbar::-webkit-scrollbar{display:none}.no-scrollbar{-ms-overflow-style:none;scrollbar-width:none}@keyframes marquee{0%{transform:translate(0)}to{transform:translate(-25%)}}.animate-marquee{animation:marquee 40s linear infinite}.docs-layout{display:grid;grid-template-columns:280px 1fr 280px;gap:2rem;min-height:100vh}.docs-main{max-width:900px;margin:0 auto;width:100%;overflow-y:auto}.docs-toc-container{display:block}@media(max-width:1200px){.docs-layout{grid-template-columns:280px 1fr}.docs-toc-container{display:none}}@media(max-width:768px){.docs-layout{grid-template-columns:1fr}}.docs-sidebar{background:#0f172a99;-webkit-backdrop-filter:blur(12px);backdrop-filter:blur(12px);border-right:1px solid rgba(255,255,255,.08);position:sticky;top:0;height:100vh;overflow-y:auto}@media(max-width:768px){.docs-sidebar{position:fixed;left:0;top:0;width:280px;z-index:50;display:block;transform:translate(-100%);transition:transform .3s ease}.docs-sidebar--open{display:block;transform:translate(0)}}.docs-sidebar-header{padding:1.5rem;border-bottom:1px solid rgba(255,255,255,.08);display:flex;justify-content:space-between;align-items:center}.docs-sidebar-toggle{background:none;border:none;color:#e2e8f0;cursor:pointer;padding:.5rem;border-radius:.375rem;transition:background-color .2s}.docs-sidebar-nav{padding:1rem}.docs-main{overflow-y:auto}.docs-content{max-width:1200px;margin:0 auto;padding:2rem}@media(max-width:768px){.docs-content{padding:1rem}}.markdown-page{animation:fadeIn .3s ease-in-out}@keyframes fadeIn{0%{opacity:0;transform:translateY(10px)}to{opacity:1;transform:translateY(0)}}.docs-mobile-header{display:flex;align-items:center;gap:1rem;padding:1rem;border-bottom:1px solid rgba(255,255,255,.08);background:#0f172a99;-webkit-backdrop-filter:blur(12px);backdrop-filter:blur(12px);position:sticky;top:0;z-index:10}.docs-sidebar-toggle{background:none;border:none;color:#e2e8f0;cursor:pointer;padding:.5rem;border-radius:.375rem;transition:background-color .2s;display:flex;align-items:center;justify-content:center}.docs-sidebar-toggle:hover{background-color:#ffffff0d}.docs-sidebar-backdrop{position:fixed;inset:0;background:#00000080;z-index:40;animation:fadeIn .2s ease}@media(min-width:769px){.docs-sidebar-backdrop{display:none}}.sidebar-item-wrapper{margin:0}.sidebar-item{transition:background-color .2s,border-color .2s}.sidebar-item__content{display:flex;align-items:center;gap:.75rem;padding:.625rem 1rem;position:relative}.sidebar-item__icon{flex-shrink:0;color:#94a3b8}.sidebar-item__link,.sidebar-item__text{flex:1;font-size:.875rem;color:#cbd5e1;text-decoration:none;transition:color .2s;display:block}.sidebar-item__link:hover{color:#e2e8f0}.sidebar-item__text{font-weight:500;color:#94a3b8}.sidebar-item__toggle{background:none;border:none;color:#64748b;cursor:pointer;padding:.25rem;display:flex;align-items:center;transition:color .2s;flex-shrink:0}.sidebar-item__toggle:hover{color:#94a3b8}.sidebar-item--active .sidebar-item__content{background:#3b82f61a;border-left:3px solid #3b82f6;padding-left:calc(1rem - 3px)}.sidebar-item--active .sidebar-item__link{color:#60a5fa;font-weight:500}.sidebar-item--active .sidebar-item__icon{color:#60a5fa}.sidebar-item:not(.sidebar-item--active):hover .sidebar-item__content{background:#ffffff08}.sidebar-item--level-0 .sidebar-item__content{padding-left:1rem}.sidebar-item--level-1 .sidebar-item__content{padding-left:2rem}.sidebar-item--level-2 .sidebar-item__content{padding-left:3rem}.sidebar-item--level-3 .sidebar-item__content{padding-left:4rem}.sidebar-item--active.sidebar-item--level-0 .sidebar-item__content{padding-left:calc(1rem - 3px)}.sidebar-item--active.sidebar-item--level-1 .sidebar-item__content{padding-left:calc(2rem - 3px)}.sidebar-item--active.sidebar-item--level-2 .sidebar-item__content{padding-left:calc(3rem - 3px)}.sidebar-item--active.sidebar-item--level-3 .sidebar-item__content{padding-left:calc(4rem - 3px)}.sidebar-item--parent .sidebar-item__text,.sidebar-item--parent .sidebar-item__link{font-weight:500}.sidebar-children{max-height:0;overflow:hidden;transition:max-height .3s ease}.sidebar-children--expanded{max-height:2000px}.mermaid-container svg{max-width:100%;height:auto;background:transparent!important}.mermaid-container .node rect,.mermaid-container .node circle,.mermaid-container .node ellipse,.mermaid-container .node polygon{fill:#1e293b!important;stroke:#60a5fa!important;stroke-width:2px!important}.mermaid-container .node .label,.mermaid-container .nodeLabel,.mermaid-container text{fill:#e2e8f0!important;color:#e2e8f0!important;font-family:Inter,sans-serif!important;font-size:14px!important}.mermaid-container .edgePath path{stroke:#334155!important;stroke-width:2px!important}.mermaid-container .edgeLabel{background-color:#0f172a!important;color:#e2e8f0!important;border:1px solid #334155!important;border-radius:4px!important;padding:4px 8px!important}.mermaid-container .flowchart-link{stroke:#334155!important;stroke-width:2px!important}.mermaid-container .actor{fill:#1e293b!important;stroke:#60a5fa!important;stroke-width:2px!important}.mermaid-container .actor-line{stroke:#334155!important;stroke-width:1px!important;stroke-dasharray:5,5!important}.mermaid-container .messageLine0,.mermaid-container .messageLine1{stroke:#e2e8f0!important;stroke-width:2px!important}.mermaid-container .messageText{fill:#e2e8f0!important;font-family:Inter,sans-serif!important}.mermaid-container .note{fill:#0f172a!important;stroke:#8b5cf6!important;stroke-width:2px!important}.mermaid-container .section0,.mermaid-container .section1,.mermaid-container .section2,.mermaid-container .section3{fill:#1e293b!important}.mermaid-container .task0,.mermaid-container .task1,.mermaid-container .task2,.mermaid-container .task3{fill:#3b82f6!important;stroke:#60a5fa!important}.mermaid-container .active0,.mermaid-container .active1,.mermaid-container .active2,.mermaid-container .active3{fill:#8b5cf6!important;stroke:#a78bfa!important}.mermaid-container .commit-id,.mermaid-container .commit-msg{fill:#e2e8f0!important;font-family:Inter,sans-serif!important}.mermaid-container .classBox{fill:#1e293b!important;stroke:#60a5fa!important;stroke-width:2px!important}.mermaid-container .classText{fill:#e2e8f0!important;font-family:JetBrains Mono,monospace!important}.mermaid-container .state-start circle,.mermaid-container .state-end circle{fill:#3b82f6!important;stroke:#60a5fa!important;stroke-width:2px!important}.mermaid-container .stateBox{fill:#1e293b!important;stroke:#60a5fa!important;stroke-width:2px!important}.mermaid-container .journey-section{fill:#1e293b!important}.mermaid-container .journey-task{fill:#3b82f6!important;stroke:#60a5fa!important}.mermaid-container .node:hover rect,.mermaid-container .node:hover circle,.mermaid-container .node:hover ellipse,.mermaid-container .node:hover polygon{fill:#334155!important;stroke:#3b82f6!important;stroke-width:3px!important;transition:all .2s ease-in-out}.mermaid-container .node:hover .label,.mermaid-container .node:hover .nodeLabel{fill:#fff!important}.docs-search-desktop{width:min(360px,100%)}.docs-search-input-wrapper{position:relative}.docs-search-input-wrapper--mobile{flex:1}.docs-search-input-icon{position:absolute;left:.75rem;top:50%;transform:translateY(-50%);width:1rem;height:1rem;color:#94a3b8;pointer-events:none}.docs-search-input{width:100%;height:2.3rem;border-radius:.65rem;border:1px solid rgba(148,163,184,.35);background:#0f172ab8;color:#f8fafc;font-size:.875rem;padding:0 2.2rem 0 2.25rem;transition:border-color .2s ease,box-shadow .2s ease}.docs-search-input::-moz-placeholder{color:#94a3b8}.docs-search-input::placeholder{color:#94a3b8}.docs-search-input:focus{outline:none;border-color:#60a5fa;box-shadow:0 0 0 3px #60a5fa33}.docs-search-clear{position:absolute;right:.45rem;top:50%;transform:translateY(-50%);border:none;background:transparent;color:#94a3b8;cursor:pointer;width:1.6rem;height:1.6rem;display:flex;align-items:center;justify-content:center;border-radius:.35rem}.docs-search-clear:hover{color:#e2e8f0;background:#94a3b826}.docs-search-dropdown{position:absolute;top:calc(100% + .5rem);left:0;right:0;border:1px solid rgba(148,163,184,.3);background:#020617fa;border-radius:.8rem;box-shadow:0 18px 42px #02061773;max-height:22rem;overflow:auto;z-index:45}.docs-search-state{padding:.9rem 1rem;font-size:.875rem;color:#94a3b8}.docs-search-state--loading{display:flex;align-items:center;gap:.5rem}.docs-search-state--error{color:#fda4af}.docs-search-results-list{list-style:none;margin:0;padding:.35rem}.docs-search-result-item{width:100%;text-align:left;border:none;border-radius:.6rem;background:transparent;color:inherit;cursor:pointer;padding:.62rem .7rem;display:flex;flex-direction:column;gap:.2rem}.docs-search-result-item:hover{background:#1e293bd9}.docs-search-result-item--nested{margin-top:.25rem;border:1px solid rgba(148,163,184,.16);background:#0f172a8c}.docs-search-result-title{font-size:.86rem;font-weight:600;color:#e2e8f0}.docs-search-result-section{font-size:.76rem;font-weight:500;color:#93c5fd;line-height:1.25}.docs-search-result-excerpt{font-size:.74rem;color:#94a3b8;line-height:1.3}.docs-search-more-wrapper{padding:0 .7rem .6rem}.docs-search-more-toggle{border:none;background:transparent;color:#60a5fa;font-size:.75rem;font-weight:600;cursor:pointer;padding:.15rem 0}.docs-search-more-toggle:hover{color:#93c5fd}.docs-search-more-list{list-style:none;margin:.25rem 0 0;padding:0}.docs-search-mobile-trigger{border:1px solid rgba(148,163,184,.35);background:#0f172ab8;color:#f8fafc;width:2.35rem;height:2.35rem;border-radius:.7rem;display:flex;align-items:center;justify-content:center}.docs-search-mobile-overlay{position:fixed;inset:0;z-index:70}.docs-search-mobile-backdrop{position:absolute;inset:0;border:0;background:#0206179e}.docs-search-mobile-sheet{position:absolute;top:0;left:0;right:0;border-bottom-left-radius:1rem;border-bottom-right-radius:1rem;border:1px solid rgba(148,163,184,.25);background:#020617;box-shadow:0 18px 42px #02061780}.docs-search-mobile-top{display:flex;align-items:center;gap:.7rem;padding:.75rem .85rem;border-bottom:1px solid rgba(148,163,184,.2)}.docs-search-mobile-close{border:none;background:transparent;color:#cbd5e1;font-size:.85rem;font-weight:500;padding:.3rem}.docs-search-mobile-results{max-height:calc(100vh - 6rem);overflow:auto;padding:.3rem}.docs-search-hit{background:#facc1573;color:#f8fafc;padding:0 .1rem;border-radius:.2rem}.selection\:bg-primary\/30 *::-moz-selection{background-color:#3b82f64d}.selection\:bg-primary\/30 *::selection{background-color:#3b82f64d}.selection\:text-white *::-moz-selection{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.selection\:text-white *::selection{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.selection\:bg-primary\/30::-moz-selection{background-color:#3b82f64d}.selection\:bg-primary\/30::selection{background-color:#3b82f64d}.selection\:text-white::-moz-selection{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.selection\:text-white::selection{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.hover\:scale-\[1\.02\]:hover{--tw-scale-x: 1.02;--tw-scale-y: 1.02;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.hover\:border-blue-500:hover{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.hover\:border-blue-500\/30:hover{border-color:#3b82f64d}.hover\:border-emerald-500\/30:hover{border-color:#10b9814d}.hover\:border-primary\/30:hover{border-color:#3b82f64d}.hover\:border-purple-500\/30:hover{border-color:#a855f74d}.hover\:border-slate-500\/50:hover{border-color:#64748b80}.hover\:border-slate-600:hover{--tw-border-opacity: 1;border-color:rgb(71 85 105 / var(--tw-border-opacity, 1))}.hover\:bg-blue-700:hover{--tw-bg-opacity: 1;background-color:rgb(29 78 216 / var(--tw-bg-opacity, 1))}.hover\:bg-gray-50:hover{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.hover\:bg-primary\/20:hover{background-color:#3b82f633}.hover\:bg-slate-700\/50:hover{background-color:#33415580}.hover\:bg-slate-800:hover{--tw-bg-opacity: 1;background-color:rgb(30 41 59 / var(--tw-bg-opacity, 1))}.hover\:text-blue-300:hover{--tw-text-opacity: 1;color:rgb(147 197 253 / var(--tw-text-opacity, 1))}.hover\:text-blue-600:hover{--tw-text-opacity: 1;color:rgb(37 99 235 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:text-primary:hover{--tw-text-opacity: 1;color:rgb(59 130 246 / var(--tw-text-opacity, 1))}.hover\:text-primaryGlow:hover{--tw-text-opacity: 1;color:rgb(96 165 250 / var(--tw-text-opacity, 1))}.hover\:text-red-200:hover{--tw-text-opacity: 1;color:rgb(254 202 202 / var(--tw-text-opacity, 1))}.hover\:text-slate-400:hover{--tw-text-opacity: 1;color:rgb(148 163 184 / var(--tw-text-opacity, 1))}.hover\:text-white:hover{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-70:hover{opacity:.7}.hover\:opacity-80:hover{opacity:.8}.hover\:\[animation-play-state\:paused\]:hover{animation-play-state:paused}.group:hover .group-hover\:translate-x-1{--tw-translate-x: .25rem;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.group:hover .group-hover\:scale-110{--tw-scale-x: 1.1;--tw-scale-y: 1.1;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.group:hover .group-hover\:border-slate-600{--tw-border-opacity: 1;border-color:rgb(71 85 105 / var(--tw-border-opacity, 1))}.group:hover .group-hover\:bg-green-500\/80{background-color:#22c55ecc}.group:hover .group-hover\:bg-red-500\/80{background-color:#ef4444cc}.group:hover .group-hover\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.group:hover .group-hover\:bg-yellow-500\/80{background-color:#eab308cc}.group:hover .group-hover\:text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.group:hover .group-hover\:text-primary{--tw-text-opacity: 1;color:rgb(59 130 246 / var(--tw-text-opacity, 1))}.group:hover .group-hover\:text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .group-hover\:underline{text-decoration-line:underline}.group:hover .group-hover\:opacity-40{opacity:.4}.group:hover .group-hover\:duration-200{transition-duration:.2s}@supports (backdrop-filter: var(--tw)){.supports-\[backdrop-filter\]\:bg-white\/60{background-color:#fff9}}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:border-gray-800:is(.dark *){--tw-border-opacity: 1;border-color:rgb(31 41 55 / var(--tw-border-opacity, 1))}.dark\:bg-gray-950:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(3 7 18 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-950\/80:is(.dark *){background-color:#030712cc}.dark\:text-blue-400:is(.dark *){--tw-text-opacity: 1;color:rgb(96 165 250 / var(--tw-text-opacity, 1))}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-gray-500:is(.dark *){--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:border-blue-500:hover:is(.dark *){--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.dark\:hover\:bg-gray-800:hover:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:hover\:text-blue-400:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(96 165 250 / var(--tw-text-opacity, 1))}.dark\:hover\:text-gray-100:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}@media(min-width:640px){.sm\:flex{display:flex}.sm\:w-auto{width:auto}.sm\:grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}.sm\:flex-row{flex-direction:row}.sm\:p-10{padding:2.5rem}.sm\:text-base{font-size:1rem;line-height:1.5rem}}@media(min-width:768px){.md\:mt-0{margin-top:0}.md\:block{display:block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:grid-cols-3{grid-template-columns:repeat(3,minmax(0,1fr))}.md\:grid-cols-4{grid-template-columns:repeat(4,minmax(0,1fr))}.md\:flex-row{flex-direction:row}.md\:px-8{padding-left:2rem;padding-right:2rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}}@media(min-width:1024px){.lg\:grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}.lg\:grid-cols-4{grid-template-columns:repeat(4,minmax(0,1fr))}.lg\:pb-32{padding-bottom:8rem}.lg\:pt-48{padding-top:12rem}.lg\:text-7xl{font-size:4.5rem;line-height:1}}.markdown-content{max-width:100%;line-height:1.7;color:#cbd5e1;font-size:1rem}.markdown-body{min-width:0}.markdown-header{margin-bottom:2.5rem;padding-bottom:1.5rem;border-bottom:1px solid rgba(255,255,255,.08)}.markdown-title{font-size:2.5rem;font-weight:700;margin:0 0 .75rem;color:#f8fafc;letter-spacing:-.025em;line-height:1.2}.markdown-description{font-size:1.125rem;color:#94a3b8;margin:0;line-height:1.6}.toc-container{position:sticky;top:2rem;max-height:calc(100vh - 4rem);overflow-y:auto;padding:0;background:transparent;border:none;border-radius:0;scrollbar-width:thin;scrollbar-color:rgba(148,163,184,.3) transparent}.toc-container::-webkit-scrollbar{width:4px}.toc-container::-webkit-scrollbar-track{background:transparent}.toc-container::-webkit-scrollbar-thumb{background:#94a3b84d;border-radius:2px}.toc-container::-webkit-scrollbar-thumb:hover{background:#94a3b880}.markdown-toc{min-width:200px}.toc-title{font-size:.75rem;font-weight:600;margin:0 0 1rem 1rem;color:#94a3b8;text-transform:uppercase;letter-spacing:.05em}.toc-list{list-style:none;margin:0;padding:0}.toc-list--root{margin:0;border-left:1px solid rgba(255,255,255,.05)}.toc-list--level-3,.toc-list--level-4{padding-left:0}.toc-item{margin:0}.toc-item--level-2{font-weight:500}.toc-item--level-3{font-weight:400;font-size:.8125rem}.toc-item--level-4{font-weight:400;font-size:.75rem}.toc-link{display:block;color:#64748b;text-decoration:none;padding:.375rem 1rem;border-left:2px solid transparent;margin-left:-1px;transition:all .2s ease;line-height:1.4;font-size:.875rem}.toc-item--level-3 .toc-link{padding-left:1.75rem}.toc-item--level-4 .toc-link{padding-left:2.5rem}.toc-link:hover{color:#cbd5e1;border-left-color:#475569}.toc-link--active{color:#60a5fa;border-left-color:#3b82f6;background-color:transparent;font-weight:500}.markdown-heading{position:relative;scroll-margin-top:6rem}.markdown-heading--with-anchor:hover .heading-anchor{opacity:1}.heading-content{display:inline-block}.heading-anchor{position:absolute;left:-1.5rem;top:50%;transform:translateY(-50%);opacity:0;color:#64748b;text-decoration:none;width:1rem;height:1rem;display:flex;align-items:center;justify-content:center;transition:all .2s ease}.heading-anchor:hover{color:#3b82f6}.heading-anchor-icon{width:1rem;height:1rem}.markdown-heading--level-1{font-size:2.25rem;font-weight:700;margin:3rem 0 1.5rem;color:#f8fafc;letter-spacing:-.025em}.markdown-heading--level-2{font-size:1.75rem;font-weight:600;margin:3rem 0 1.25rem;color:#f1f5f9;padding-bottom:.75rem;border-bottom:1px solid rgba(255,255,255,.08);letter-spacing:-.015em}.markdown-heading--level-3{font-size:1.375rem;font-weight:600;margin:2rem 0 1rem;color:#e2e8f0}.markdown-heading--level-4{font-size:1.125rem;font-weight:600;margin:1.5rem 0 .75rem;color:#e2e8f0}.markdown-heading--level-5{font-size:1rem;font-weight:600;margin:1.25rem 0 .5rem;color:#cbd5e1}.markdown-heading--level-6{font-size:.875rem;font-weight:600;margin:1.25rem 0 .5rem;color:#cbd5e1;text-transform:uppercase;letter-spacing:.05em}.code-block{margin:1.5rem 0;border-radius:12px;overflow:hidden;background:#0f172a99;-webkit-backdrop-filter:blur(12px);backdrop-filter:blur(12px);border:1px solid rgba(255,255,255,.08);box-shadow:0 4px 6px -1px #0000001a,0 2px 4px -1px #0000000f}.code-block--with-focus{position:relative}.code-pre{margin:0;padding:1.25rem;overflow-x:auto;font-family:JetBrains Mono,SF Mono,Monaco,Cascadia Code,Roboto Mono,Consolas,Courier New,monospace;font-size:.875rem;line-height:1.6;color:#e2e8f0}.code-line{display:grid;grid-template-columns:auto 1fr;gap:1.5rem;padding:0 .25rem;transition:all .2s ease}.line-number{color:#475569;font-size:.75rem;text-align:right;-webkit-user-select:none;-moz-user-select:none;user-select:none;min-width:1.5rem}.line-content{min-width:0}.line-focus{background-color:#3b82f61a;border-left:2px solid #3b82f6;padding-left:.5rem;margin-left:-.5rem}.line-dimmed{opacity:.4}.inline-code{background-color:#1e293b80;color:#93c5fd;padding:.125rem .375rem;border-radius:6px;font-family:JetBrains Mono,SF Mono,Monaco,Cascadia Code,Roboto Mono,Consolas,Courier New,monospace;font-size:.85em;border:1px solid rgba(148,163,184,.1);white-space:nowrap}.custom-block{margin:1.5rem 0;padding:1rem 1.25rem;border-radius:8px;border-left:4px solid;background:#0f172a66}.custom-block__header{display:flex;align-items:center;gap:.75rem;margin-bottom:.75rem;font-weight:600}.custom-block__icon{width:1.25rem;height:1.25rem;flex-shrink:0}.custom-block__title{font-size:.875rem;text-transform:uppercase;letter-spacing:.05em}.custom-block__content{margin:0}.custom-block__content>*:first-child{margin-top:0}.custom-block__content>*:last-child{margin-bottom:0}.custom-block--tip{background-color:#0ea5e91a;border-left-color:#0ea5e9;color:#e0f2fe}.custom-block--tip .custom-block__title,.custom-block--tip .custom-block__icon{color:#38bdf8}.custom-block--warning{background-color:#f59e0b1a;border-left-color:#f59e0b;color:#fef3c7}.custom-block--warning .custom-block__title,.custom-block--warning .custom-block__icon{color:#fbbf24}.custom-block--danger{background-color:#ef44441a;border-left-color:#ef4444;color:#fee2e2}.custom-block--danger .custom-block__title,.custom-block--danger .custom-block__icon{color:#f87171}.custom-block--details{background-color:#1e293b66;border-left-color:#64748b;color:#cbd5e1}.custom-block--details .custom-block__summary{cursor:pointer;display:flex;align-items:center;gap:.5rem;font-weight:600;margin-bottom:.75rem;-webkit-user-select:none;-moz-user-select:none;user-select:none}.custom-block--details .custom-block__title,.custom-block--details .custom-block__icon{color:#94a3b8}.custom-block--details[open] .custom-block__summary{margin-bottom:.75rem}.markdown-link{color:#60a5fa;text-decoration:none;border-bottom:1px solid transparent;transition:all .2s ease}.markdown-link:hover{color:#93c5fd;border-bottom-color:#93c5fd}.markdown-link--external{display:inline-flex;align-items:center;gap:.25rem}.external-link-icon{width:.875rem;height:.875rem;opacity:.7}.markdown-link--anchor{color:#94a3b8}.markdown-link--anchor:hover{color:#60a5fa}.markdown-content p{margin:1.25rem 0;line-height:1.75}.markdown-content ul,.markdown-content ol{margin:1.25rem 0;padding-left:1.5rem}.markdown-content li{margin:.5rem 0;padding-left:.5rem}.markdown-content li::marker{color:#64748b}.markdown-content blockquote{margin:1.5rem 0;padding:1rem 1.5rem;border-left:4px solid #475569;background-color:#1e293b66;border-radius:0 8px 8px 0;color:#94a3b8;font-style:italic}.markdown-content table{width:100%;margin:2rem 0;border-collapse:separate;border-spacing:0;border:1px solid rgba(255,255,255,.08);border-radius:8px;overflow:hidden}.markdown-content th,.markdown-content td{padding:.875rem 1.25rem;text-align:left;border-bottom:1px solid rgba(255,255,255,.08)}.markdown-content th{background-color:#1e293b99;font-weight:600;color:#e2e8f0}.markdown-content tr:last-child td{border-bottom:none}.markdown-content tr:hover td{background-color:#ffffff05}.markdown-content hr{margin:3rem 0;border:none;border-top:1px solid rgba(255,255,255,.08)}.markdown-content img{max-width:100%;height:auto;border-radius:8px;margin:2rem 0;border:1px solid rgba(255,255,255,.08);box-shadow:0 10px 15px -3px #0000001a}@media(max-width:768px){.markdown-title{font-size:2rem}.markdown-heading--level-1{font-size:1.875rem}.markdown-heading--level-2{font-size:1.5rem}.heading-anchor{display:none}.code-pre{padding:1rem;font-size:.8rem}}@media print{.toc-container{display:none}.markdown-content--with-toc{grid-template-columns:1fr}.heading-anchor{display:none}.code-block{border:1px solid #ccc;background:#f5f5f5!important;color:#000!important}.code-pre{color:#000!important}.custom-block{border:1px solid #ccc;background:#f9f9f9!important;color:#000!important}.markdown-content,.markdown-title,.markdown-heading--level-1,.markdown-heading--level-2{color:#000!important}}
diff --git a/docs/dist/assets/infoDiagram-ER5ION4S-CVILutlg.js b/docs/dist/assets/infoDiagram-ER5ION4S-CVILutlg.js
deleted file mode 100644
index 940d8253..00000000
--- a/docs/dist/assets/infoDiagram-ER5ION4S-CVILutlg.js
+++ /dev/null
@@ -1,2 +0,0 @@
-import{_ as e,l as s,H as n,e as i,I as p}from"./index-BxX29htg.js";import{p as g}from"./treemap-KMMF4GRG-DFERHDZP.js";import"./_baseUniq-CfjWcJYV.js";import"./_basePickBy-CqMtcO3s.js";import"./clone-BRV0rZiZ.js";var v={parse:e(async r=>{const a=await g("info",r);s.debug(a)},"parse")},d={version:p.version+""},m=e(()=>d.version,"getVersion"),c={getVersion:m},l=e((r,a,o)=>{s.debug(`rendering info diagram
-`+r);const t=n(a);i(t,100,400,!0),t.append("g").append("text").attr("x",100).attr("y",40).attr("class","version").attr("font-size",32).style("text-anchor","middle").text(`v${o}`)},"draw"),f={draw:l},S={parser:v,db:c,renderer:f};export{S as diagram};
diff --git a/docs/dist/assets/init-Gi6I4Gst.js b/docs/dist/assets/init-Gi6I4Gst.js
deleted file mode 100644
index d44de941..00000000
--- a/docs/dist/assets/init-Gi6I4Gst.js
+++ /dev/null
@@ -1 +0,0 @@
-function t(e,a){switch(arguments.length){case 0:break;case 1:this.range(e);break;default:this.range(a).domain(e);break}return this}export{t as i};
diff --git a/docs/dist/assets/journeyDiagram-XKPGCS4Q-BHSnA7Cj.js b/docs/dist/assets/journeyDiagram-XKPGCS4Q-BHSnA7Cj.js
deleted file mode 100644
index a72034df..00000000
--- a/docs/dist/assets/journeyDiagram-XKPGCS4Q-BHSnA7Cj.js
+++ /dev/null
@@ -1,139 +0,0 @@
-import{a as gt,g as lt,f as mt,d as xt}from"./chunk-TZMSLE5B-BkTUbDII.js";import{g as kt}from"./chunk-FMBD7UC4-Bm3lI1XN.js";import{_ as n,g as _t,s as vt,a as bt,b as wt,q as Tt,p as St,c as R,d as X,e as $t,y as Mt}from"./index-BxX29htg.js";import{d as et}from"./arc-sXMYVGHN.js";var U=(function(){var t=n(function(h,i,a,l){for(a=a||{},l=h.length;l--;a[h[l]]=i);return a},"o"),e=[6,8,10,11,12,14,16,17,18],s=[1,9],c=[1,10],r=[1,11],f=[1,12],u=[1,13],y=[1,14],g={trace:n(function(){},"trace"),yy:{},symbols_:{error:2,start:3,journey:4,document:5,EOF:6,line:7,SPACE:8,statement:9,NEWLINE:10,title:11,acc_title:12,acc_title_value:13,acc_descr:14,acc_descr_value:15,acc_descr_multiline_value:16,section:17,taskName:18,taskData:19,$accept:0,$end:1},terminals_:{2:"error",4:"journey",6:"EOF",8:"SPACE",10:"NEWLINE",11:"title",12:"acc_title",13:"acc_title_value",14:"acc_descr",15:"acc_descr_value",16:"acc_descr_multiline_value",17:"section",18:"taskName",19:"taskData"},productions_:[0,[3,3],[5,0],[5,2],[7,2],[7,1],[7,1],[7,1],[9,1],[9,2],[9,2],[9,1],[9,1],[9,2]],performAction:n(function(i,a,l,d,p,o,b){var k=o.length-1;switch(p){case 1:return o[k-1];case 2:this.$=[];break;case 3:o[k-1].push(o[k]),this.$=o[k-1];break;case 4:case 5:this.$=o[k];break;case 6:case 7:this.$=[];break;case 8:d.setDiagramTitle(o[k].substr(6)),this.$=o[k].substr(6);break;case 9:this.$=o[k].trim(),d.setAccTitle(this.$);break;case 10:case 11:this.$=o[k].trim(),d.setAccDescription(this.$);break;case 12:d.addSection(o[k].substr(8)),this.$=o[k].substr(8);break;case 13:d.addTask(o[k-1],o[k]),this.$="task";break}},"anonymous"),table:[{3:1,4:[1,2]},{1:[3]},t(e,[2,2],{5:3}),{6:[1,4],7:5,8:[1,6],9:7,10:[1,8],11:s,12:c,14:r,16:f,17:u,18:y},t(e,[2,7],{1:[2,1]}),t(e,[2,3]),{9:15,11:s,12:c,14:r,16:f,17:u,18:y},t(e,[2,5]),t(e,[2,6]),t(e,[2,8]),{13:[1,16]},{15:[1,17]},t(e,[2,11]),t(e,[2,12]),{19:[1,18]},t(e,[2,4]),t(e,[2,9]),t(e,[2,10]),t(e,[2,13])],defaultActions:{},parseError:n(function(i,a){if(a.recoverable)this.trace(i);else{var l=new Error(i);throw l.hash=a,l}},"parseError"),parse:n(function(i){var a=this,l=[0],d=[],p=[null],o=[],b=this.table,k="",C=0,K=0,dt=2,Q=1,yt=o.slice.call(arguments,1),_=Object.create(this.lexer),I={yy:{}};for(var O in this.yy)Object.prototype.hasOwnProperty.call(this.yy,O)&&(I.yy[O]=this.yy[O]);_.setInput(i,I.yy),I.yy.lexer=_,I.yy.parser=this,typeof _.yylloc>"u"&&(_.yylloc={});var Y=_.yylloc;o.push(Y);var ft=_.options&&_.options.ranges;typeof I.yy.parseError=="function"?this.parseError=I.yy.parseError:this.parseError=Object.getPrototypeOf(this).parseError;function pt(w){l.length=l.length-2*w,p.length=p.length-w,o.length=o.length-w}n(pt,"popStack");function D(){var w;return w=d.pop()||_.lex()||Q,typeof w!="number"&&(w instanceof Array&&(d=w,w=d.pop()),w=a.symbols_[w]||w),w}n(D,"lex");for(var v,A,T,q,F={},N,M,tt,z;;){if(A=l[l.length-1],this.defaultActions[A]?T=this.defaultActions[A]:((v===null||typeof v>"u")&&(v=D()),T=b[A]&&b[A][v]),typeof T>"u"||!T.length||!T[0]){var H="";z=[];for(N in b[A])this.terminals_[N]&&N>dt&&z.push("'"+this.terminals_[N]+"'");_.showPosition?H="Parse error on line "+(C+1)+`:
-`+_.showPosition()+`
-Expecting `+z.join(", ")+", got '"+(this.terminals_[v]||v)+"'":H="Parse error on line "+(C+1)+": Unexpected "+(v==Q?"end of input":"'"+(this.terminals_[v]||v)+"'"),this.parseError(H,{text:_.match,token:this.terminals_[v]||v,line:_.yylineno,loc:Y,expected:z})}if(T[0]instanceof Array&&T.length>1)throw new Error("Parse Error: multiple actions possible at state: "+A+", token: "+v);switch(T[0]){case 1:l.push(v),p.push(_.yytext),o.push(_.yylloc),l.push(T[1]),v=null,K=_.yyleng,k=_.yytext,C=_.yylineno,Y=_.yylloc;break;case 2:if(M=this.productions_[T[1]][1],F.$=p[p.length-M],F._$={first_line:o[o.length-(M||1)].first_line,last_line:o[o.length-1].last_line,first_column:o[o.length-(M||1)].first_column,last_column:o[o.length-1].last_column},ft&&(F._$.range=[o[o.length-(M||1)].range[0],o[o.length-1].range[1]]),q=this.performAction.apply(F,[k,K,C,I.yy,T[1],p,o].concat(yt)),typeof q<"u")return q;M&&(l=l.slice(0,-1*M*2),p=p.slice(0,-1*M),o=o.slice(0,-1*M)),l.push(this.productions_[T[1]][0]),p.push(F.$),o.push(F._$),tt=b[l[l.length-2]][l[l.length-1]],l.push(tt);break;case 3:return!0}}return!0},"parse")},m=(function(){var h={EOF:1,parseError:n(function(a,l){if(this.yy.parser)this.yy.parser.parseError(a,l);else throw new Error(a)},"parseError"),setInput:n(function(i,a){return this.yy=a||this.yy||{},this._input=i,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},"setInput"),input:n(function(){var i=this._input[0];this.yytext+=i,this.yyleng++,this.offset++,this.match+=i,this.matched+=i;var a=i.match(/(?:\r\n?|\n).*/g);return a?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),i},"input"),unput:n(function(i){var a=i.length,l=i.split(/(?:\r\n?|\n)/g);this._input=i+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-a),this.offset-=a;var d=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),l.length-1&&(this.yylineno-=l.length-1);var p=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:l?(l.length===d.length?this.yylloc.first_column:0)+d[d.length-l.length].length-l[0].length:this.yylloc.first_column-a},this.options.ranges&&(this.yylloc.range=[p[0],p[0]+this.yyleng-a]),this.yyleng=this.yytext.length,this},"unput"),more:n(function(){return this._more=!0,this},"more"),reject:n(function(){if(this.options.backtrack_lexer)this._backtrack=!0;else return this.parseError("Lexical error on line "+(this.yylineno+1)+`. You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).
-`+this.showPosition(),{text:"",token:null,line:this.yylineno});return this},"reject"),less:n(function(i){this.unput(this.match.slice(i))},"less"),pastInput:n(function(){var i=this.matched.substr(0,this.matched.length-this.match.length);return(i.length>20?"...":"")+i.substr(-20).replace(/\n/g,"")},"pastInput"),upcomingInput:n(function(){var i=this.match;return i.length<20&&(i+=this._input.substr(0,20-i.length)),(i.substr(0,20)+(i.length>20?"...":"")).replace(/\n/g,"")},"upcomingInput"),showPosition:n(function(){var i=this.pastInput(),a=new Array(i.length+1).join("-");return i+this.upcomingInput()+`
-`+a+"^"},"showPosition"),test_match:n(function(i,a){var l,d,p;if(this.options.backtrack_lexer&&(p={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(p.yylloc.range=this.yylloc.range.slice(0))),d=i[0].match(/(?:\r\n?|\n).*/g),d&&(this.yylineno+=d.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:d?d[d.length-1].length-d[d.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+i[0].length},this.yytext+=i[0],this.match+=i[0],this.matches=i,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(i[0].length),this.matched+=i[0],l=this.performAction.call(this,this.yy,this,a,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),l)return l;if(this._backtrack){for(var o in p)this[o]=p[o];return!1}return!1},"test_match"),next:n(function(){if(this.done)return this.EOF;this._input||(this.done=!0);var i,a,l,d;this._more||(this.yytext="",this.match="");for(var p=this._currentRules(),o=0;o<p.length;o++)if(l=this._input.match(this.rules[p[o]]),l&&(!a||l[0].length>a[0].length)){if(a=l,d=o,this.options.backtrack_lexer){if(i=this.test_match(l,p[o]),i!==!1)return i;if(this._backtrack){a=!1;continue}else return!1}else if(!this.options.flex)break}return a?(i=this.test_match(a,p[d]),i!==!1?i:!1):this._input===""?this.EOF:this.parseError("Lexical error on line "+(this.yylineno+1)+`. Unrecognized text.
-`+this.showPosition(),{text:"",token:null,line:this.yylineno})},"next"),lex:n(function(){var a=this.next();return a||this.lex()},"lex"),begin:n(function(a){this.conditionStack.push(a)},"begin"),popState:n(function(){var a=this.conditionStack.length-1;return a>0?this.conditionStack.pop():this.conditionStack[0]},"popState"),_currentRules:n(function(){return this.conditionStack.length&&this.conditionStack[this.conditionStack.length-1]?this.conditions[this.conditionStack[this.conditionStack.length-1]].rules:this.conditions.INITIAL.rules},"_currentRules"),topState:n(function(a){return a=this.conditionStack.length-1-Math.abs(a||0),a>=0?this.conditionStack[a]:"INITIAL"},"topState"),pushState:n(function(a){this.begin(a)},"pushState"),stateStackSize:n(function(){return this.conditionStack.length},"stateStackSize"),options:{"case-insensitive":!0},performAction:n(function(a,l,d,p){switch(d){case 0:break;case 1:break;case 2:return 10;case 3:break;case 4:break;case 5:return 4;case 6:return 11;case 7:return this.begin("acc_title"),12;case 8:return this.popState(),"acc_title_value";case 9:return this.begin("acc_descr"),14;case 10:return this.popState(),"acc_descr_value";case 11:this.begin("acc_descr_multiline");break;case 12:this.popState();break;case 13:return"acc_descr_multiline_value";case 14:return 17;case 15:return 18;case 16:return 19;case 17:return":";case 18:return 6;case 19:return"INVALID"}},"anonymous"),rules:[/^(?:%(?!\{)[^\n]*)/i,/^(?:[^\}]%%[^\n]*)/i,/^(?:[\n]+)/i,/^(?:\s+)/i,/^(?:#[^\n]*)/i,/^(?:journey\b)/i,/^(?:title\s[^#\n;]+)/i,/^(?:accTitle\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*\{\s*)/i,/^(?:[\}])/i,/^(?:[^\}]*)/i,/^(?:section\s[^#:\n;]+)/i,/^(?:[^#:\n;]+)/i,/^(?::[^#\n;]+)/i,/^(?::)/i,/^(?:$)/i,/^(?:.)/i],conditions:{acc_descr_multiline:{rules:[12,13],inclusive:!1},acc_descr:{rules:[10],inclusive:!1},acc_title:{rules:[8],inclusive:!1},INITIAL:{rules:[0,1,2,3,4,5,6,7,9,11,14,15,16,17,18,19],inclusive:!0}}};return h})();g.lexer=m;function x(){this.yy={}}return n(x,"Parser"),x.prototype=g,g.Parser=x,new x})();U.parser=U;var Et=U,V="",Z=[],L=[],B=[],Ct=n(function(){Z.length=0,L.length=0,V="",B.length=0,Mt()},"clear"),Pt=n(function(t){V=t,Z.push(t)},"addSection"),It=n(function(){return Z},"getSections"),At=n(function(){let t=it();const e=100;let s=0;for(;!t&&s<e;)t=it(),s++;return L.push(...B),L},"getTasks"),Ft=n(function(){const t=[];return L.forEach(s=>{s.people&&t.push(...s.people)}),[...new Set(t)].sort()},"updateActors"),Vt=n(function(t,e){const s=e.substr(1).split(":");let c=0,r=[];s.length===1?(c=Number(s[0]),r=[]):(c=Number(s[0]),r=s[1].split(","));const f=r.map(y=>y.trim()),u={section:V,type:V,people:f,task:t,score:c};B.push(u)},"addTask"),Rt=n(function(t){const e={section:V,type:V,description:t,task:t,classes:[]};L.push(e)},"addTaskOrg"),it=n(function(){const t=n(function(s){return B[s].processed},"compileTask");let e=!0;for(const[s,c]of B.entries())t(s),e=e&&c.processed;return e},"compileTasks"),Lt=n(function(){return Ft()},"getActors"),rt={getConfig:n(()=>R().journey,"getConfig"),clear:Ct,setDiagramTitle:St,getDiagramTitle:Tt,setAccTitle:wt,getAccTitle:bt,setAccDescription:vt,getAccDescription:_t,addSection:Pt,getSections:It,getTasks:At,addTask:Vt,addTaskOrg:Rt,getActors:Lt},Bt=n(t=>`.label {
-    font-family: ${t.fontFamily};
-    color: ${t.textColor};
-  }
-  .mouth {
-    stroke: #666;
-  }
-
-  line {
-    stroke: ${t.textColor}
-  }
-
-  .legend {
-    fill: ${t.textColor};
-    font-family: ${t.fontFamily};
-  }
-
-  .label text {
-    fill: #333;
-  }
-  .label {
-    color: ${t.textColor}
-  }
-
-  .face {
-    ${t.faceColor?`fill: ${t.faceColor}`:"fill: #FFF8DC"};
-    stroke: #999;
-  }
-
-  .node rect,
-  .node circle,
-  .node ellipse,
-  .node polygon,
-  .node path {
-    fill: ${t.mainBkg};
-    stroke: ${t.nodeBorder};
-    stroke-width: 1px;
-  }
-
-  .node .label {
-    text-align: center;
-  }
-  .node.clickable {
-    cursor: pointer;
-  }
-
-  .arrowheadPath {
-    fill: ${t.arrowheadColor};
-  }
-
-  .edgePath .path {
-    stroke: ${t.lineColor};
-    stroke-width: 1.5px;
-  }
-
-  .flowchart-link {
-    stroke: ${t.lineColor};
-    fill: none;
-  }
-
-  .edgeLabel {
-    background-color: ${t.edgeLabelBackground};
-    rect {
-      opacity: 0.5;
-    }
-    text-align: center;
-  }
-
-  .cluster rect {
-  }
-
-  .cluster text {
-    fill: ${t.titleColor};
-  }
-
-  div.mermaidTooltip {
-    position: absolute;
-    text-align: center;
-    max-width: 200px;
-    padding: 2px;
-    font-family: ${t.fontFamily};
-    font-size: 12px;
-    background: ${t.tertiaryColor};
-    border: 1px solid ${t.border2};
-    border-radius: 2px;
-    pointer-events: none;
-    z-index: 100;
-  }
-
-  .task-type-0, .section-type-0  {
-    ${t.fillType0?`fill: ${t.fillType0}`:""};
-  }
-  .task-type-1, .section-type-1  {
-    ${t.fillType0?`fill: ${t.fillType1}`:""};
-  }
-  .task-type-2, .section-type-2  {
-    ${t.fillType0?`fill: ${t.fillType2}`:""};
-  }
-  .task-type-3, .section-type-3  {
-    ${t.fillType0?`fill: ${t.fillType3}`:""};
-  }
-  .task-type-4, .section-type-4  {
-    ${t.fillType0?`fill: ${t.fillType4}`:""};
-  }
-  .task-type-5, .section-type-5  {
-    ${t.fillType0?`fill: ${t.fillType5}`:""};
-  }
-  .task-type-6, .section-type-6  {
-    ${t.fillType0?`fill: ${t.fillType6}`:""};
-  }
-  .task-type-7, .section-type-7  {
-    ${t.fillType0?`fill: ${t.fillType7}`:""};
-  }
-
-  .actor-0 {
-    ${t.actor0?`fill: ${t.actor0}`:""};
-  }
-  .actor-1 {
-    ${t.actor1?`fill: ${t.actor1}`:""};
-  }
-  .actor-2 {
-    ${t.actor2?`fill: ${t.actor2}`:""};
-  }
-  .actor-3 {
-    ${t.actor3?`fill: ${t.actor3}`:""};
-  }
-  .actor-4 {
-    ${t.actor4?`fill: ${t.actor4}`:""};
-  }
-  .actor-5 {
-    ${t.actor5?`fill: ${t.actor5}`:""};
-  }
-  ${kt()}
-`,"getStyles"),jt=Bt,J=n(function(t,e){return xt(t,e)},"drawRect"),Nt=n(function(t,e){const c=t.append("circle").attr("cx",e.cx).attr("cy",e.cy).attr("class","face").attr("r",15).attr("stroke-width",2).attr("overflow","visible"),r=t.append("g");r.append("circle").attr("cx",e.cx-15/3).attr("cy",e.cy-15/3).attr("r",1.5).attr("stroke-width",2).attr("fill","#666").attr("stroke","#666"),r.append("circle").attr("cx",e.cx+15/3).attr("cy",e.cy-15/3).attr("r",1.5).attr("stroke-width",2).attr("fill","#666").attr("stroke","#666");function f(g){const m=et().startAngle(Math.PI/2).endAngle(3*(Math.PI/2)).innerRadius(7.5).outerRadius(6.8181818181818175);g.append("path").attr("class","mouth").attr("d",m).attr("transform","translate("+e.cx+","+(e.cy+2)+")")}n(f,"smile");function u(g){const m=et().startAngle(3*Math.PI/2).endAngle(5*(Math.PI/2)).innerRadius(7.5).outerRadius(6.8181818181818175);g.append("path").attr("class","mouth").attr("d",m).attr("transform","translate("+e.cx+","+(e.cy+7)+")")}n(u,"sad");function y(g){g.append("line").attr("class","mouth").attr("stroke",2).attr("x1",e.cx-5).attr("y1",e.cy+7).attr("x2",e.cx+5).attr("y2",e.cy+7).attr("class","mouth").attr("stroke-width","1px").attr("stroke","#666")}return n(y,"ambivalent"),e.score>3?f(r):e.score<3?u(r):y(r),c},"drawFace"),ot=n(function(t,e){const s=t.append("circle");return s.attr("cx",e.cx),s.attr("cy",e.cy),s.attr("class","actor-"+e.pos),s.attr("fill",e.fill),s.attr("stroke",e.stroke),s.attr("r",e.r),s.class!==void 0&&s.attr("class",s.class),e.title!==void 0&&s.append("title").text(e.title),s},"drawCircle"),ct=n(function(t,e){return mt(t,e)},"drawText"),zt=n(function(t,e){function s(r,f,u,y,g){return r+","+f+" "+(r+u)+","+f+" "+(r+u)+","+(f+y-g)+" "+(r+u-g*1.2)+","+(f+y)+" "+r+","+(f+y)}n(s,"genPoints");const c=t.append("polygon");c.attr("points",s(e.x,e.y,50,20,7)),c.attr("class","labelBox"),e.y=e.y+e.labelMargin,e.x=e.x+.5*e.labelMargin,ct(t,e)},"drawLabel"),Wt=n(function(t,e,s){const c=t.append("g"),r=lt();r.x=e.x,r.y=e.y,r.fill=e.fill,r.width=s.width*e.taskCount+s.diagramMarginX*(e.taskCount-1),r.height=s.height,r.class="journey-section section-type-"+e.num,r.rx=3,r.ry=3,J(c,r),ht(s)(e.text,c,r.x,r.y,r.width,r.height,{class:"journey-section section-type-"+e.num},s,e.colour)},"drawSection"),nt=-1,Ot=n(function(t,e,s){const c=e.x+s.width/2,r=t.append("g");nt++,r.append("line").attr("id","task"+nt).attr("x1",c).attr("y1",e.y).attr("x2",c).attr("y2",450).attr("class","task-line").attr("stroke-width","1px").attr("stroke-dasharray","4 2").attr("stroke","#666"),Nt(r,{cx:c,cy:300+(5-e.score)*30,score:e.score});const u=lt();u.x=e.x,u.y=e.y,u.fill=e.fill,u.width=s.width,u.height=s.height,u.class="task task-type-"+e.num,u.rx=3,u.ry=3,J(r,u);let y=e.x+14;e.people.forEach(g=>{const m=e.actors[g].color,x={cx:y,cy:e.y,r:7,fill:m,stroke:"#000",title:g,pos:e.actors[g].position};ot(r,x),y+=10}),ht(s)(e.task,r,u.x,u.y,u.width,u.height,{class:"task"},s,e.colour)},"drawTask"),Yt=n(function(t,e){gt(t,e)},"drawBackgroundRect"),ht=(function(){function t(r,f,u,y,g,m,x,h){const i=f.append("text").attr("x",u+g/2).attr("y",y+m/2+5).style("font-color",h).style("text-anchor","middle").text(r);c(i,x)}n(t,"byText");function e(r,f,u,y,g,m,x,h,i){const{taskFontSize:a,taskFontFamily:l}=h,d=r.split(/<br\s*\/?>/gi);for(let p=0;p<d.length;p++){const o=p*a-a*(d.length-1)/2,b=f.append("text").attr("x",u+g/2).attr("y",y).attr("fill",i).style("text-anchor","middle").style("font-size",a).style("font-family",l);b.append("tspan").attr("x",u+g/2).attr("dy",o).text(d[p]),b.attr("y",y+m/2).attr("dominant-baseline","central").attr("alignment-baseline","central"),c(b,x)}}n(e,"byTspan");function s(r,f,u,y,g,m,x,h){const i=f.append("switch"),l=i.append("foreignObject").attr("x",u).attr("y",y).attr("width",g).attr("height",m).attr("position","fixed").append("xhtml:div").style("display","table").style("height","100%").style("width","100%");l.append("div").attr("class","label").style("display","table-cell").style("text-align","center").style("vertical-align","middle").text(r),e(r,i,u,y,g,m,x,h),c(l,x)}n(s,"byFo");function c(r,f){for(const u in f)u in f&&r.attr(u,f[u])}return n(c,"_setTextAttrs"),function(r){return r.textPlacement==="fo"?s:r.textPlacement==="old"?t:e}})(),qt=n(function(t){t.append("defs").append("marker").attr("id","arrowhead").attr("refX",5).attr("refY",2).attr("markerWidth",6).attr("markerHeight",4).attr("orient","auto").append("path").attr("d","M 0,0 V 4 L6,2 Z")},"initGraphics"),j={drawRect:J,drawCircle:ot,drawSection:Wt,drawText:ct,drawLabel:zt,drawTask:Ot,drawBackgroundRect:Yt,initGraphics:qt},Ht=n(function(t){Object.keys(t).forEach(function(s){$[s]=t[s]})},"setConf"),E={},W=0;function ut(t){const e=R().journey,s=e.maxLabelWidth;W=0;let c=60;Object.keys(E).forEach(r=>{const f=E[r].color,u={cx:20,cy:c,r:7,fill:f,stroke:"#000",pos:E[r].position};j.drawCircle(t,u);let y=t.append("text").attr("visibility","hidden").text(r);const g=y.node().getBoundingClientRect().width;y.remove();let m=[];if(g<=s)m=[r];else{const x=r.split(" ");let h="";y=t.append("text").attr("visibility","hidden"),x.forEach(i=>{const a=h?`${h} ${i}`:i;if(y.text(a),y.node().getBoundingClientRect().width>s){if(h&&m.push(h),h=i,y.text(i),y.node().getBoundingClientRect().width>s){let d="";for(const p of i)d+=p,y.text(d+"-"),y.node().getBoundingClientRect().width>s&&(m.push(d.slice(0,-1)+"-"),d=p);h=d}}else h=a}),h&&m.push(h),y.remove()}m.forEach((x,h)=>{const i={x:40,y:c+7+h*20,fill:"#666",text:x,textMargin:e.boxTextMargin??5},l=j.drawText(t,i).node().getBoundingClientRect().width;l>W&&l>e.leftMargin-l&&(W=l)}),c+=Math.max(20,m.length*20)})}n(ut,"drawActorLegend");var $=R().journey,P=0,Xt=n(function(t,e,s,c){const r=R(),f=r.journey.titleColor,u=r.journey.titleFontSize,y=r.journey.titleFontFamily,g=r.securityLevel;let m;g==="sandbox"&&(m=X("#i"+e));const x=g==="sandbox"?X(m.nodes()[0].contentDocument.body):X("body");S.init();const h=x.select("#"+e);j.initGraphics(h);const i=c.db.getTasks(),a=c.db.getDiagramTitle(),l=c.db.getActors();for(const C in E)delete E[C];let d=0;l.forEach(C=>{E[C]={color:$.actorColours[d%$.actorColours.length],position:d},d++}),ut(h),P=$.leftMargin+W,S.insert(0,0,P,Object.keys(E).length*50),Gt(h,i,0);const p=S.getBounds();a&&h.append("text").text(a).attr("x",P).attr("font-size",u).attr("font-weight","bold").attr("y",25).attr("fill",f).attr("font-family",y);const o=p.stopy-p.starty+2*$.diagramMarginY,b=P+p.stopx+2*$.diagramMarginX;$t(h,o,b,$.useMaxWidth),h.append("line").attr("x1",P).attr("y1",$.height*4).attr("x2",b-P-4).attr("y2",$.height*4).attr("stroke-width",4).attr("stroke","black").attr("marker-end","url(#arrowhead)");const k=a?70:0;h.attr("viewBox",`${p.startx} -25 ${b} ${o+k}`),h.attr("preserveAspectRatio","xMinYMin meet"),h.attr("height",o+k+25)},"draw"),S={data:{startx:void 0,stopx:void 0,starty:void 0,stopy:void 0},verticalPos:0,sequenceItems:[],init:n(function(){this.sequenceItems=[],this.data={startx:void 0,stopx:void 0,starty:void 0,stopy:void 0},this.verticalPos=0},"init"),updateVal:n(function(t,e,s,c){t[e]===void 0?t[e]=s:t[e]=c(s,t[e])},"updateVal"),updateBounds:n(function(t,e,s,c){const r=R().journey,f=this;let u=0;function y(g){return n(function(x){u++;const h=f.sequenceItems.length-u+1;f.updateVal(x,"starty",e-h*r.boxMargin,Math.min),f.updateVal(x,"stopy",c+h*r.boxMargin,Math.max),f.updateVal(S.data,"startx",t-h*r.boxMargin,Math.min),f.updateVal(S.data,"stopx",s+h*r.boxMargin,Math.max),g!=="activation"&&(f.updateVal(x,"startx",t-h*r.boxMargin,Math.min),f.updateVal(x,"stopx",s+h*r.boxMargin,Math.max),f.updateVal(S.data,"starty",e-h*r.boxMargin,Math.min),f.updateVal(S.data,"stopy",c+h*r.boxMargin,Math.max))},"updateItemBounds")}n(y,"updateFn"),this.sequenceItems.forEach(y())},"updateBounds"),insert:n(function(t,e,s,c){const r=Math.min(t,s),f=Math.max(t,s),u=Math.min(e,c),y=Math.max(e,c);this.updateVal(S.data,"startx",r,Math.min),this.updateVal(S.data,"starty",u,Math.min),this.updateVal(S.data,"stopx",f,Math.max),this.updateVal(S.data,"stopy",y,Math.max),this.updateBounds(r,u,f,y)},"insert"),bumpVerticalPos:n(function(t){this.verticalPos=this.verticalPos+t,this.data.stopy=this.verticalPos},"bumpVerticalPos"),getVerticalPos:n(function(){return this.verticalPos},"getVerticalPos"),getBounds:n(function(){return this.data},"getBounds")},G=$.sectionFills,st=$.sectionColours,Gt=n(function(t,e,s){const c=R().journey;let r="";const f=c.height*2+c.diagramMarginY,u=s+f;let y=0,g="#CCC",m="black",x=0;for(const[h,i]of e.entries()){if(r!==i.section){g=G[y%G.length],x=y%G.length,m=st[y%st.length];let l=0;const d=i.section;for(let o=h;o<e.length&&e[o].section==d;o++)l=l+1;const p={x:h*c.taskMargin+h*c.width+P,y:50,text:i.section,fill:g,num:x,colour:m,taskCount:l};j.drawSection(t,p,c),r=i.section,y++}const a=i.people.reduce((l,d)=>(E[d]&&(l[d]=E[d]),l),{});i.x=h*c.taskMargin+h*c.width+P,i.y=u,i.width=c.diagramMarginX,i.height=c.diagramMarginY,i.colour=m,i.fill=g,i.num=x,i.actors=a,j.drawTask(t,i,c),S.insert(i.x,i.y,i.x+i.width+c.taskMargin,450)}},"drawTasks"),at={setConf:Ht,draw:Xt},Qt={parser:Et,db:rt,renderer:at,styles:jt,init:n(t=>{at.setConf(t.journey),rt.clear()},"init")};export{Qt as diagram};
diff --git a/docs/dist/assets/kanban-definition-3W4ZIXB7-BCzaghRS.js b/docs/dist/assets/kanban-definition-3W4ZIXB7-BCzaghRS.js
deleted file mode 100644
index 221f49e2..00000000
--- a/docs/dist/assets/kanban-definition-3W4ZIXB7-BCzaghRS.js
+++ /dev/null
@@ -1,89 +0,0 @@
-import{_ as o,l as te,c as U,H as fe,af as ye,ag as be,ah as me,V as _e,F as Y,i as j,t as Ee,J as ke,W as Se,X as ce,Y as le}from"./index-BxX29htg.js";import{g as Ne}from"./chunk-FMBD7UC4-Bm3lI1XN.js";var $=(function(){var e=o(function(O,i,n,r){for(n=n||{},r=O.length;r--;n[O[r]]=i);return n},"o"),u=[1,4],p=[1,13],s=[1,12],d=[1,15],E=[1,16],b=[1,20],l=[1,19],D=[6,7,8],I=[1,26],g=[1,24],w=[1,25],_=[6,7,11],G=[1,31],N=[6,7,11,24],V=[1,6,13,16,17,20,23],m=[1,35],A=[1,36],L=[1,6,7,11,13,16,17,20,23],H=[1,38],T={trace:o(function(){},"trace"),yy:{},symbols_:{error:2,start:3,mindMap:4,spaceLines:5,SPACELINE:6,NL:7,KANBAN:8,document:9,stop:10,EOF:11,statement:12,SPACELIST:13,node:14,shapeData:15,ICON:16,CLASS:17,nodeWithId:18,nodeWithoutId:19,NODE_DSTART:20,NODE_DESCR:21,NODE_DEND:22,NODE_ID:23,SHAPE_DATA:24,$accept:0,$end:1},terminals_:{2:"error",6:"SPACELINE",7:"NL",8:"KANBAN",11:"EOF",13:"SPACELIST",16:"ICON",17:"CLASS",20:"NODE_DSTART",21:"NODE_DESCR",22:"NODE_DEND",23:"NODE_ID",24:"SHAPE_DATA"},productions_:[0,[3,1],[3,2],[5,1],[5,2],[5,2],[4,2],[4,3],[10,1],[10,1],[10,1],[10,2],[10,2],[9,3],[9,2],[12,3],[12,2],[12,2],[12,2],[12,1],[12,2],[12,1],[12,1],[12,1],[12,1],[14,1],[14,1],[19,3],[18,1],[18,4],[15,2],[15,1]],performAction:o(function(i,n,r,a,h,t,M){var c=t.length-1;switch(h){case 6:case 7:return a;case 8:a.getLogger().trace("Stop NL ");break;case 9:a.getLogger().trace("Stop EOF ");break;case 11:a.getLogger().trace("Stop NL2 ");break;case 12:a.getLogger().trace("Stop EOF2 ");break;case 15:a.getLogger().info("Node: ",t[c-1].id),a.addNode(t[c-2].length,t[c-1].id,t[c-1].descr,t[c-1].type,t[c]);break;case 16:a.getLogger().info("Node: ",t[c].id),a.addNode(t[c-1].length,t[c].id,t[c].descr,t[c].type);break;case 17:a.getLogger().trace("Icon: ",t[c]),a.decorateNode({icon:t[c]});break;case 18:case 23:a.decorateNode({class:t[c]});break;case 19:a.getLogger().trace("SPACELIST");break;case 20:a.getLogger().trace("Node: ",t[c-1].id),a.addNode(0,t[c-1].id,t[c-1].descr,t[c-1].type,t[c]);break;case 21:a.getLogger().trace("Node: ",t[c].id),a.addNode(0,t[c].id,t[c].descr,t[c].type);break;case 22:a.decorateNode({icon:t[c]});break;case 27:a.getLogger().trace("node found ..",t[c-2]),this.$={id:t[c-1],descr:t[c-1],type:a.getType(t[c-2],t[c])};break;case 28:this.$={id:t[c],descr:t[c],type:0};break;case 29:a.getLogger().trace("node found ..",t[c-3]),this.$={id:t[c-3],descr:t[c-1],type:a.getType(t[c-2],t[c])};break;case 30:this.$=t[c-1]+t[c];break;case 31:this.$=t[c];break}},"anonymous"),table:[{3:1,4:2,5:3,6:[1,5],8:u},{1:[3]},{1:[2,1]},{4:6,6:[1,7],7:[1,8],8:u},{6:p,7:[1,10],9:9,12:11,13:s,14:14,16:d,17:E,18:17,19:18,20:b,23:l},e(D,[2,3]),{1:[2,2]},e(D,[2,4]),e(D,[2,5]),{1:[2,6],6:p,12:21,13:s,14:14,16:d,17:E,18:17,19:18,20:b,23:l},{6:p,9:22,12:11,13:s,14:14,16:d,17:E,18:17,19:18,20:b,23:l},{6:I,7:g,10:23,11:w},e(_,[2,24],{18:17,19:18,14:27,16:[1,28],17:[1,29],20:b,23:l}),e(_,[2,19]),e(_,[2,21],{15:30,24:G}),e(_,[2,22]),e(_,[2,23]),e(N,[2,25]),e(N,[2,26]),e(N,[2,28],{20:[1,32]}),{21:[1,33]},{6:I,7:g,10:34,11:w},{1:[2,7],6:p,12:21,13:s,14:14,16:d,17:E,18:17,19:18,20:b,23:l},e(V,[2,14],{7:m,11:A}),e(L,[2,8]),e(L,[2,9]),e(L,[2,10]),e(_,[2,16],{15:37,24:G}),e(_,[2,17]),e(_,[2,18]),e(_,[2,20],{24:H}),e(N,[2,31]),{21:[1,39]},{22:[1,40]},e(V,[2,13],{7:m,11:A}),e(L,[2,11]),e(L,[2,12]),e(_,[2,15],{24:H}),e(N,[2,30]),{22:[1,41]},e(N,[2,27]),e(N,[2,29])],defaultActions:{2:[2,1],6:[2,2]},parseError:o(function(i,n){if(n.recoverable)this.trace(i);else{var r=new Error(i);throw r.hash=n,r}},"parseError"),parse:o(function(i){var n=this,r=[0],a=[],h=[null],t=[],M=this.table,c="",W=0,se=0,ue=2,re=1,ge=t.slice.call(arguments,1),y=Object.create(this.lexer),R={yy:{}};for(var J in this.yy)Object.prototype.hasOwnProperty.call(this.yy,J)&&(R.yy[J]=this.yy[J]);y.setInput(i,R.yy),R.yy.lexer=y,R.yy.parser=this,typeof y.yylloc>"u"&&(y.yylloc={});var q=y.yylloc;t.push(q);var de=y.options&&y.options.ranges;typeof R.yy.parseError=="function"?this.parseError=R.yy.parseError:this.parseError=Object.getPrototypeOf(this).parseError;function pe(S){r.length=r.length-2*S,h.length=h.length-S,t.length=t.length-S}o(pe,"popStack");function ae(){var S;return S=a.pop()||y.lex()||re,typeof S!="number"&&(S instanceof Array&&(a=S,S=a.pop()),S=n.symbols_[S]||S),S}o(ae,"lex");for(var k,P,x,Q,F={},z,C,oe,X;;){if(P=r[r.length-1],this.defaultActions[P]?x=this.defaultActions[P]:((k===null||typeof k>"u")&&(k=ae()),x=M[P]&&M[P][k]),typeof x>"u"||!x.length||!x[0]){var Z="";X=[];for(z in M[P])this.terminals_[z]&&z>ue&&X.push("'"+this.terminals_[z]+"'");y.showPosition?Z="Parse error on line "+(W+1)+`:
-`+y.showPosition()+`
-Expecting `+X.join(", ")+", got '"+(this.terminals_[k]||k)+"'":Z="Parse error on line "+(W+1)+": Unexpected "+(k==re?"end of input":"'"+(this.terminals_[k]||k)+"'"),this.parseError(Z,{text:y.match,token:this.terminals_[k]||k,line:y.yylineno,loc:q,expected:X})}if(x[0]instanceof Array&&x.length>1)throw new Error("Parse Error: multiple actions possible at state: "+P+", token: "+k);switch(x[0]){case 1:r.push(k),h.push(y.yytext),t.push(y.yylloc),r.push(x[1]),k=null,se=y.yyleng,c=y.yytext,W=y.yylineno,q=y.yylloc;break;case 2:if(C=this.productions_[x[1]][1],F.$=h[h.length-C],F._$={first_line:t[t.length-(C||1)].first_line,last_line:t[t.length-1].last_line,first_column:t[t.length-(C||1)].first_column,last_column:t[t.length-1].last_column},de&&(F._$.range=[t[t.length-(C||1)].range[0],t[t.length-1].range[1]]),Q=this.performAction.apply(F,[c,se,W,R.yy,x[1],h,t].concat(ge)),typeof Q<"u")return Q;C&&(r=r.slice(0,-1*C*2),h=h.slice(0,-1*C),t=t.slice(0,-1*C)),r.push(this.productions_[x[1]][0]),h.push(F.$),t.push(F._$),oe=M[r[r.length-2]][r[r.length-1]],r.push(oe);break;case 3:return!0}}return!0},"parse")},K=(function(){var O={EOF:1,parseError:o(function(n,r){if(this.yy.parser)this.yy.parser.parseError(n,r);else throw new Error(n)},"parseError"),setInput:o(function(i,n){return this.yy=n||this.yy||{},this._input=i,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},"setInput"),input:o(function(){var i=this._input[0];this.yytext+=i,this.yyleng++,this.offset++,this.match+=i,this.matched+=i;var n=i.match(/(?:\r\n?|\n).*/g);return n?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),i},"input"),unput:o(function(i){var n=i.length,r=i.split(/(?:\r\n?|\n)/g);this._input=i+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-n),this.offset-=n;var a=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),r.length-1&&(this.yylineno-=r.length-1);var h=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:r?(r.length===a.length?this.yylloc.first_column:0)+a[a.length-r.length].length-r[0].length:this.yylloc.first_column-n},this.options.ranges&&(this.yylloc.range=[h[0],h[0]+this.yyleng-n]),this.yyleng=this.yytext.length,this},"unput"),more:o(function(){return this._more=!0,this},"more"),reject:o(function(){if(this.options.backtrack_lexer)this._backtrack=!0;else return this.parseError("Lexical error on line "+(this.yylineno+1)+`. You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).
-`+this.showPosition(),{text:"",token:null,line:this.yylineno});return this},"reject"),less:o(function(i){this.unput(this.match.slice(i))},"less"),pastInput:o(function(){var i=this.matched.substr(0,this.matched.length-this.match.length);return(i.length>20?"...":"")+i.substr(-20).replace(/\n/g,"")},"pastInput"),upcomingInput:o(function(){var i=this.match;return i.length<20&&(i+=this._input.substr(0,20-i.length)),(i.substr(0,20)+(i.length>20?"...":"")).replace(/\n/g,"")},"upcomingInput"),showPosition:o(function(){var i=this.pastInput(),n=new Array(i.length+1).join("-");return i+this.upcomingInput()+`
-`+n+"^"},"showPosition"),test_match:o(function(i,n){var r,a,h;if(this.options.backtrack_lexer&&(h={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(h.yylloc.range=this.yylloc.range.slice(0))),a=i[0].match(/(?:\r\n?|\n).*/g),a&&(this.yylineno+=a.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:a?a[a.length-1].length-a[a.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+i[0].length},this.yytext+=i[0],this.match+=i[0],this.matches=i,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(i[0].length),this.matched+=i[0],r=this.performAction.call(this,this.yy,this,n,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),r)return r;if(this._backtrack){for(var t in h)this[t]=h[t];return!1}return!1},"test_match"),next:o(function(){if(this.done)return this.EOF;this._input||(this.done=!0);var i,n,r,a;this._more||(this.yytext="",this.match="");for(var h=this._currentRules(),t=0;t<h.length;t++)if(r=this._input.match(this.rules[h[t]]),r&&(!n||r[0].length>n[0].length)){if(n=r,a=t,this.options.backtrack_lexer){if(i=this.test_match(r,h[t]),i!==!1)return i;if(this._backtrack){n=!1;continue}else return!1}else if(!this.options.flex)break}return n?(i=this.test_match(n,h[a]),i!==!1?i:!1):this._input===""?this.EOF:this.parseError("Lexical error on line "+(this.yylineno+1)+`. Unrecognized text.
-`+this.showPosition(),{text:"",token:null,line:this.yylineno})},"next"),lex:o(function(){var n=this.next();return n||this.lex()},"lex"),begin:o(function(n){this.conditionStack.push(n)},"begin"),popState:o(function(){var n=this.conditionStack.length-1;return n>0?this.conditionStack.pop():this.conditionStack[0]},"popState"),_currentRules:o(function(){return this.conditionStack.length&&this.conditionStack[this.conditionStack.length-1]?this.conditions[this.conditionStack[this.conditionStack.length-1]].rules:this.conditions.INITIAL.rules},"_currentRules"),topState:o(function(n){return n=this.conditionStack.length-1-Math.abs(n||0),n>=0?this.conditionStack[n]:"INITIAL"},"topState"),pushState:o(function(n){this.begin(n)},"pushState"),stateStackSize:o(function(){return this.conditionStack.length},"stateStackSize"),options:{"case-insensitive":!0},performAction:o(function(n,r,a,h){switch(a){case 0:return this.pushState("shapeData"),r.yytext="",24;case 1:return this.pushState("shapeDataStr"),24;case 2:return this.popState(),24;case 3:const t=/\n\s*/g;return r.yytext=r.yytext.replace(t,"<br/>"),24;case 4:return 24;case 5:this.popState();break;case 6:return n.getLogger().trace("Found comment",r.yytext),6;case 7:return 8;case 8:this.begin("CLASS");break;case 9:return this.popState(),17;case 10:this.popState();break;case 11:n.getLogger().trace("Begin icon"),this.begin("ICON");break;case 12:return n.getLogger().trace("SPACELINE"),6;case 13:return 7;case 14:return 16;case 15:n.getLogger().trace("end icon"),this.popState();break;case 16:return n.getLogger().trace("Exploding node"),this.begin("NODE"),20;case 17:return n.getLogger().trace("Cloud"),this.begin("NODE"),20;case 18:return n.getLogger().trace("Explosion Bang"),this.begin("NODE"),20;case 19:return n.getLogger().trace("Cloud Bang"),this.begin("NODE"),20;case 20:return this.begin("NODE"),20;case 21:return this.begin("NODE"),20;case 22:return this.begin("NODE"),20;case 23:return this.begin("NODE"),20;case 24:return 13;case 25:return 23;case 26:return 11;case 27:this.begin("NSTR2");break;case 28:return"NODE_DESCR";case 29:this.popState();break;case 30:n.getLogger().trace("Starting NSTR"),this.begin("NSTR");break;case 31:return n.getLogger().trace("description:",r.yytext),"NODE_DESCR";case 32:this.popState();break;case 33:return this.popState(),n.getLogger().trace("node end ))"),"NODE_DEND";case 34:return this.popState(),n.getLogger().trace("node end )"),"NODE_DEND";case 35:return this.popState(),n.getLogger().trace("node end ...",r.yytext),"NODE_DEND";case 36:return this.popState(),n.getLogger().trace("node end (("),"NODE_DEND";case 37:return this.popState(),n.getLogger().trace("node end (-"),"NODE_DEND";case 38:return this.popState(),n.getLogger().trace("node end (-"),"NODE_DEND";case 39:return this.popState(),n.getLogger().trace("node end (("),"NODE_DEND";case 40:return this.popState(),n.getLogger().trace("node end (("),"NODE_DEND";case 41:return n.getLogger().trace("Long description:",r.yytext),21;case 42:return n.getLogger().trace("Long description:",r.yytext),21}},"anonymous"),rules:[/^(?:@\{)/i,/^(?:["])/i,/^(?:["])/i,/^(?:[^\"]+)/i,/^(?:[^}^"]+)/i,/^(?:\})/i,/^(?:\s*%%.*)/i,/^(?:kanban\b)/i,/^(?::::)/i,/^(?:.+)/i,/^(?:\n)/i,/^(?:::icon\()/i,/^(?:[\s]+[\n])/i,/^(?:[\n]+)/i,/^(?:[^\)]+)/i,/^(?:\))/i,/^(?:-\))/i,/^(?:\(-)/i,/^(?:\)\))/i,/^(?:\))/i,/^(?:\(\()/i,/^(?:\{\{)/i,/^(?:\()/i,/^(?:\[)/i,/^(?:[\s]+)/i,/^(?:[^\(\[\n\)\{\}@]+)/i,/^(?:$)/i,/^(?:["][`])/i,/^(?:[^`"]+)/i,/^(?:[`]["])/i,/^(?:["])/i,/^(?:[^"]+)/i,/^(?:["])/i,/^(?:[\)]\))/i,/^(?:[\)])/i,/^(?:[\]])/i,/^(?:\}\})/i,/^(?:\(-)/i,/^(?:-\))/i,/^(?:\(\()/i,/^(?:\()/i,/^(?:[^\)\]\(\}]+)/i,/^(?:.+(?!\(\())/i],conditions:{shapeDataEndBracket:{rules:[],inclusive:!1},shapeDataStr:{rules:[2,3],inclusive:!1},shapeData:{rules:[1,4,5],inclusive:!1},CLASS:{rules:[9,10],inclusive:!1},ICON:{rules:[14,15],inclusive:!1},NSTR2:{rules:[28,29],inclusive:!1},NSTR:{rules:[31,32],inclusive:!1},NODE:{rules:[27,30,33,34,35,36,37,38,39,40,41,42],inclusive:!1},INITIAL:{rules:[0,6,7,8,11,12,13,16,17,18,19,20,21,22,23,24,25,26],inclusive:!0}}};return O})();T.lexer=K;function B(){this.yy={}}return o(B,"Parser"),B.prototype=T,T.Parser=B,new B})();$.parser=$;var xe=$,v=[],ne=[],ee=0,ie={},ve=o(()=>{v=[],ne=[],ee=0,ie={}},"clear"),De=o(e=>{if(v.length===0)return null;const u=v[0].level;let p=null;for(let s=v.length-1;s>=0;s--)if(v[s].level===u&&!p&&(p=v[s]),v[s].level<u)throw new Error('Items without section detected, found section ("'+v[s].label+'")');return e===p?.level?null:p},"getSection"),he=o(function(){return ne},"getSections"),Le=o(function(){const e=[],u=[],p=he(),s=U();for(const d of p){const E={id:d.id,label:j(d.label??"",s),isGroup:!0,ticket:d.ticket,shape:"kanbanSection",level:d.level,look:s.look};u.push(E);const b=v.filter(l=>l.parentId===d.id);for(const l of b){const D={id:l.id,parentId:d.id,label:j(l.label??"",s),isGroup:!1,ticket:l?.ticket,priority:l?.priority,assigned:l?.assigned,icon:l?.icon,shape:"kanbanItem",level:l.level,rx:5,ry:5,cssStyles:["text-align: left"]};u.push(D)}}return{nodes:u,edges:e,other:{},config:U()}},"getData"),Oe=o((e,u,p,s,d)=>{const E=U();let b=E.mindmap?.padding??Y.mindmap.padding;switch(s){case f.ROUNDED_RECT:case f.RECT:case f.HEXAGON:b*=2}const l={id:j(u,E)||"kbn"+ee++,level:e,label:j(p,E),width:E.mindmap?.maxNodeWidth??Y.mindmap.maxNodeWidth,padding:b,isGroup:!1};if(d!==void 0){let I;d.includes(`
-`)?I=d+`
-`:I=`{
-`+d+`
-}`;const g=Ee(I,{schema:ke});if(g.shape&&(g.shape!==g.shape.toLowerCase()||g.shape.includes("_")))throw new Error(`No such shape: ${g.shape}. Shape names should be lowercase.`);g?.shape&&g.shape==="kanbanItem"&&(l.shape=g?.shape),g?.label&&(l.label=g?.label),g?.icon&&(l.icon=g?.icon.toString()),g?.assigned&&(l.assigned=g?.assigned.toString()),g?.ticket&&(l.ticket=g?.ticket.toString()),g?.priority&&(l.priority=g?.priority)}const D=De(e);D?l.parentId=D.id||"kbn"+ee++:ne.push(l),v.push(l)},"addNode"),f={DEFAULT:0,NO_BORDER:0,ROUNDED_RECT:1,RECT:2,CIRCLE:3,CLOUD:4,BANG:5,HEXAGON:6},Ie=o((e,u)=>{switch(te.debug("In get type",e,u),e){case"[":return f.RECT;case"(":return u===")"?f.ROUNDED_RECT:f.CLOUD;case"((":return f.CIRCLE;case")":return f.CLOUD;case"))":return f.BANG;case"{{":return f.HEXAGON;default:return f.DEFAULT}},"getType"),Ce=o((e,u)=>{ie[e]=u},"setElementForId"),we=o(e=>{if(!e)return;const u=U(),p=v[v.length-1];e.icon&&(p.icon=j(e.icon,u)),e.class&&(p.cssClasses=j(e.class,u))},"decorateNode"),Ae=o(e=>{switch(e){case f.DEFAULT:return"no-border";case f.RECT:return"rect";case f.ROUNDED_RECT:return"rounded-rect";case f.CIRCLE:return"circle";case f.CLOUD:return"cloud";case f.BANG:return"bang";case f.HEXAGON:return"hexgon";default:return"no-border"}},"type2Str"),Te=o(()=>te,"getLogger"),Re=o(e=>ie[e],"getElementById"),Pe={clear:ve,addNode:Oe,getSections:he,getData:Le,nodeType:f,getType:Ie,setElementForId:Ce,decorateNode:we,type2Str:Ae,getLogger:Te,getElementById:Re},Ve=Pe,Be=o(async(e,u,p,s)=>{te.debug(`Rendering kanban diagram
-`+e);const E=s.db.getData(),b=U();b.htmlLabels=!1;const l=fe(u),D=l.append("g");D.attr("class","sections");const I=l.append("g");I.attr("class","items");const g=E.nodes.filter(m=>m.isGroup);let w=0;const _=10,G=[];let N=25;for(const m of g){const A=b?.kanban?.sectionWidth||200;w=w+1,m.x=A*w+(w-1)*_/2,m.width=A,m.y=0,m.height=A*3,m.rx=5,m.ry=5,m.cssClasses=m.cssClasses+" section-"+w;const L=await ye(D,m);N=Math.max(N,L?.labelBBox?.height),G.push(L)}let V=0;for(const m of g){const A=G[V];V=V+1;const L=b?.kanban?.sectionWidth||200,H=-L*3/2+N;let T=H;const K=E.nodes.filter(i=>i.parentId===m.id);for(const i of K){if(i.isGroup)throw new Error("Groups within groups are not allowed in Kanban diagrams");i.x=m.x,i.width=L-1.5*_;const r=(await be(I,i,{config:b})).node().getBBox();i.y=T+r.height/2,await me(i),T=i.y+r.height/2+_/2}const B=A.cluster.select("rect"),O=Math.max(T-H+3*_,50)+(N-25);B.attr("height",O)}_e(void 0,l,b.mindmap?.padding??Y.kanban.padding,b.mindmap?.useMaxWidth??Y.kanban.useMaxWidth)},"draw"),Fe={draw:Be},je=o(e=>{let u="";for(let s=0;s<e.THEME_COLOR_LIMIT;s++)e["lineColor"+s]=e["lineColor"+s]||e["cScaleInv"+s],Se(e["lineColor"+s])?e["lineColor"+s]=ce(e["lineColor"+s],20):e["lineColor"+s]=le(e["lineColor"+s],20);const p=o((s,d)=>e.darkMode?le(s,d):ce(s,d),"adjuster");for(let s=0;s<e.THEME_COLOR_LIMIT;s++){const d=""+(17-3*s);u+=`
-    .section-${s-1} rect, .section-${s-1} path, .section-${s-1} circle, .section-${s-1} polygon, .section-${s-1} path  {
-      fill: ${p(e["cScale"+s],10)};
-      stroke: ${p(e["cScale"+s],10)};
-
-    }
-    .section-${s-1} text {
-     fill: ${e["cScaleLabel"+s]};
-    }
-    .node-icon-${s-1} {
-      font-size: 40px;
-      color: ${e["cScaleLabel"+s]};
-    }
-    .section-edge-${s-1}{
-      stroke: ${e["cScale"+s]};
-    }
-    .edge-depth-${s-1}{
-      stroke-width: ${d};
-    }
-    .section-${s-1} line {
-      stroke: ${e["cScaleInv"+s]} ;
-      stroke-width: 3;
-    }
-
-    .disabled, .disabled circle, .disabled text {
-      fill: lightgray;
-    }
-    .disabled text {
-      fill: #efefef;
-    }
-
-  .node rect,
-  .node circle,
-  .node ellipse,
-  .node polygon,
-  .node path {
-    fill: ${e.background};
-    stroke: ${e.nodeBorder};
-    stroke-width: 1px;
-  }
-
-  .kanban-ticket-link {
-    fill: ${e.background};
-    stroke: ${e.nodeBorder};
-    text-decoration: underline;
-  }
-    `}return u},"genSections"),Ge=o(e=>`
-  .edge {
-    stroke-width: 3;
-  }
-  ${je(e)}
-  .section-root rect, .section-root path, .section-root circle, .section-root polygon  {
-    fill: ${e.git0};
-  }
-  .section-root text {
-    fill: ${e.gitBranchLabel0};
-  }
-  .icon-container {
-    height:100%;
-    display: flex;
-    justify-content: center;
-    align-items: center;
-  }
-  .edge {
-    fill: none;
-  }
-  .cluster-label, .label {
-    color: ${e.textColor};
-    fill: ${e.textColor};
-    }
-  .kanban-label {
-    dy: 1em;
-    alignment-baseline: middle;
-    text-anchor: middle;
-    dominant-baseline: middle;
-    text-align: center;
-  }
-    ${Ne()}
-`,"getStyles"),He=Ge,We={db:Ve,renderer:Fe,parser:xe,styles:He};export{We as diagram};
diff --git a/docs/dist/assets/katex-CbqxIyal.js b/docs/dist/assets/katex-CbqxIyal.js
deleted file mode 100644
index ab6606ae..00000000
--- a/docs/dist/assets/katex-CbqxIyal.js
+++ /dev/null
@@ -1,261 +0,0 @@
-class o0{constructor(e,t,a){this.lexer=void 0,this.start=void 0,this.end=void 0,this.lexer=e,this.start=t,this.end=a}static range(e,t){return t?!e||!e.loc||!t.loc||e.loc.lexer!==t.loc.lexer?null:new o0(e.loc.lexer,e.loc.start,t.loc.end):e&&e.loc}}class u0{constructor(e,t){this.text=void 0,this.loc=void 0,this.noexpand=void 0,this.treatAsRelax=void 0,this.text=e,this.loc=t}range(e,t){return new u0(t,o0.range(this,e))}}class M{constructor(e,t){this.name=void 0,this.position=void 0,this.length=void 0,this.rawMessage=void 0;var a="KaTeX parse error: "+e,i,s,o=t&&t.loc;if(o&&o.start<=o.end){var m=o.lexer.input;i=o.start,s=o.end,i===m.length?a+=" at end of input: ":a+=" at position "+(i+1)+": ";var c=m.slice(i,s).replace(/[^]/g,"$&̲"),p;i>15?p="…"+m.slice(i-15,i):p=m.slice(0,i);var g;s+15<m.length?g=m.slice(s,s+15)+"…":g=m.slice(s),a+=p+c+g}var y=new Error(a);return y.name="ParseError",y.__proto__=M.prototype,y.position=i,i!=null&&s!=null&&(y.length=s-i),y.rawMessage=e,y}}M.prototype.__proto__=Error.prototype;var fa=function(e,t){return e===void 0?t:e},pa=/([A-Z])/g,va=function(e){return e.replace(pa,"-$1").toLowerCase()},ga={"&":"&amp;",">":"&gt;","<":"&lt;",'"':"&quot;","'":"&#x27;"},ba=/[&><"']/g;function ya(r){return String(r).replace(ba,e=>ga[e])}var vr=function r(e){return e.type==="ordgroup"||e.type==="color"?e.body.length===1?r(e.body[0]):e:e.type==="font"?r(e.body):e},wa=function(e){var t=vr(e);return t.type==="mathord"||t.type==="textord"||t.type==="atom"},xa=function(e){if(!e)throw new Error("Expected non-null, but got "+String(e));return e},ka=function(e){var t=/^[\x00-\x20]*([^\\/#?]*?)(:|&#0*58|&#x0*3a|&colon)/i.exec(e);return t?t[2]!==":"||!/^[a-zA-Z][a-zA-Z0-9+\-.]*$/.test(t[1])?null:t[1].toLowerCase():"_relative"},G={deflt:fa,escape:ya,hyphenate:va,getBaseElem:vr,isCharacterBox:wa,protocolFromUrl:ka},ze={displayMode:{type:"boolean",description:"Render math in display mode, which puts the math in display style (so \\int and \\sum are large, for example), and centers the math on the page on its own line.",cli:"-d, --display-mode"},output:{type:{enum:["htmlAndMathml","html","mathml"]},description:"Determines the markup language of the output.",cli:"-F, --format <type>"},leqno:{type:"boolean",description:"Render display math in leqno style (left-justified tags)."},fleqn:{type:"boolean",description:"Render display math flush left."},throwOnError:{type:"boolean",default:!0,cli:"-t, --no-throw-on-error",cliDescription:"Render errors (in the color given by --error-color) instead of throwing a ParseError exception when encountering an error."},errorColor:{type:"string",default:"#cc0000",cli:"-c, --error-color <color>",cliDescription:"A color string given in the format 'rgb' or 'rrggbb' (no #). This option determines the color of errors rendered by the -t option.",cliProcessor:r=>"#"+r},macros:{type:"object",cli:"-m, --macro <def>",cliDescription:"Define custom macro of the form '\\foo:expansion' (use multiple -m arguments for multiple macros).",cliDefault:[],cliProcessor:(r,e)=>(e.push(r),e)},minRuleThickness:{type:"number",description:"Specifies a minimum thickness, in ems, for fraction lines, `\\sqrt` top lines, `{array}` vertical lines, `\\hline`, `\\hdashline`, `\\underline`, `\\overline`, and the borders of `\\fbox`, `\\boxed`, and `\\fcolorbox`.",processor:r=>Math.max(0,r),cli:"--min-rule-thickness <size>",cliProcessor:parseFloat},colorIsTextColor:{type:"boolean",description:"Makes \\color behave like LaTeX's 2-argument \\textcolor, instead of LaTeX's one-argument \\color mode change.",cli:"-b, --color-is-text-color"},strict:{type:[{enum:["warn","ignore","error"]},"boolean","function"],description:"Turn on strict / LaTeX faithfulness mode, which throws an error if the input uses features that are not supported by LaTeX.",cli:"-S, --strict",cliDefault:!1},trust:{type:["boolean","function"],description:"Trust the input, enabling all HTML features such as \\url.",cli:"-T, --trust"},maxSize:{type:"number",default:1/0,description:"If non-zero, all user-specified sizes, e.g. in \\rule{500em}{500em}, will be capped to maxSize ems. Otherwise, elements and spaces can be arbitrarily large",processor:r=>Math.max(0,r),cli:"-s, --max-size <n>",cliProcessor:parseInt},maxExpand:{type:"number",default:1e3,description:"Limit the number of macro expansions to the specified number, to prevent e.g. infinite macro loops. If set to Infinity, the macro expander will try to fully expand as in LaTeX.",processor:r=>Math.max(0,r),cli:"-e, --max-expand <n>",cliProcessor:r=>r==="Infinity"?1/0:parseInt(r)},globalGroup:{type:"boolean",cli:!1}};function Sa(r){if(r.default)return r.default;var e=r.type,t=Array.isArray(e)?e[0]:e;if(typeof t!="string")return t.enum[0];switch(t){case"boolean":return!1;case"string":return"";case"number":return 0;case"object":return{}}}class dt{constructor(e){this.displayMode=void 0,this.output=void 0,this.leqno=void 0,this.fleqn=void 0,this.throwOnError=void 0,this.errorColor=void 0,this.macros=void 0,this.minRuleThickness=void 0,this.colorIsTextColor=void 0,this.strict=void 0,this.trust=void 0,this.maxSize=void 0,this.maxExpand=void 0,this.globalGroup=void 0,e=e||{};for(var t in ze)if(ze.hasOwnProperty(t)){var a=ze[t];this[t]=e[t]!==void 0?a.processor?a.processor(e[t]):e[t]:Sa(a)}}reportNonstrict(e,t,a){var i=this.strict;if(typeof i=="function"&&(i=i(e,t,a)),!(!i||i==="ignore")){if(i===!0||i==="error")throw new M("LaTeX-incompatible input and strict mode is set to 'error': "+(t+" ["+e+"]"),a);i==="warn"?typeof console<"u"&&console.warn("LaTeX-incompatible input and strict mode is set to 'warn': "+(t+" ["+e+"]")):typeof console<"u"&&console.warn("LaTeX-incompatible input and strict mode is set to "+("unrecognized '"+i+"': "+t+" ["+e+"]"))}}useStrictBehavior(e,t,a){var i=this.strict;if(typeof i=="function")try{i=i(e,t,a)}catch{i="error"}return!i||i==="ignore"?!1:i===!0||i==="error"?!0:i==="warn"?(typeof console<"u"&&console.warn("LaTeX-incompatible input and strict mode is set to 'warn': "+(t+" ["+e+"]")),!1):(typeof console<"u"&&console.warn("LaTeX-incompatible input and strict mode is set to "+("unrecognized '"+i+"': "+t+" ["+e+"]")),!1)}isTrusted(e){if(e.url&&!e.protocol){var t=G.protocolFromUrl(e.url);if(t==null)return!1;e.protocol=t}var a=typeof this.trust=="function"?this.trust(e):this.trust;return!!a}}class H0{constructor(e,t,a){this.id=void 0,this.size=void 0,this.cramped=void 0,this.id=e,this.size=t,this.cramped=a}sup(){return y0[Ma[this.id]]}sub(){return y0[za[this.id]]}fracNum(){return y0[Ta[this.id]]}fracDen(){return y0[Aa[this.id]]}cramp(){return y0[Ba[this.id]]}text(){return y0[Na[this.id]]}isTight(){return this.size>=2}}var ft=0,Ae=1,ee=2,B0=3,le=4,f0=5,te=6,i0=7,y0=[new H0(ft,0,!1),new H0(Ae,0,!0),new H0(ee,1,!1),new H0(B0,1,!0),new H0(le,2,!1),new H0(f0,2,!0),new H0(te,3,!1),new H0(i0,3,!0)],Ma=[le,f0,le,f0,te,i0,te,i0],za=[f0,f0,f0,f0,i0,i0,i0,i0],Ta=[ee,B0,le,f0,te,i0,te,i0],Aa=[B0,B0,f0,f0,i0,i0,i0,i0],Ba=[Ae,Ae,B0,B0,f0,f0,i0,i0],Na=[ft,Ae,ee,B0,ee,B0,ee,B0],I={DISPLAY:y0[ft],TEXT:y0[ee],SCRIPT:y0[le],SCRIPTSCRIPT:y0[te]},it=[{name:"latin",blocks:[[256,591],[768,879]]},{name:"cyrillic",blocks:[[1024,1279]]},{name:"armenian",blocks:[[1328,1423]]},{name:"brahmic",blocks:[[2304,4255]]},{name:"georgian",blocks:[[4256,4351]]},{name:"cjk",blocks:[[12288,12543],[19968,40879],[65280,65376]]},{name:"hangul",blocks:[[44032,55215]]}];function Ca(r){for(var e=0;e<it.length;e++)for(var t=it[e],a=0;a<t.blocks.length;a++){var i=t.blocks[a];if(r>=i[0]&&r<=i[1])return t.name}return null}var Te=[];it.forEach(r=>r.blocks.forEach(e=>Te.push(...e)));function gr(r){for(var e=0;e<Te.length;e+=2)if(r>=Te[e]&&r<=Te[e+1])return!0;return!1}var _0=80,qa=function(e,t){return"M95,"+(622+e+t)+`
-c-2.7,0,-7.17,-2.7,-13.5,-8c-5.8,-5.3,-9.5,-10,-9.5,-14
-c0,-2,0.3,-3.3,1,-4c1.3,-2.7,23.83,-20.7,67.5,-54
-c44.2,-33.3,65.8,-50.3,66.5,-51c1.3,-1.3,3,-2,5,-2c4.7,0,8.7,3.3,12,10
-s173,378,173,378c0.7,0,35.3,-71,104,-213c68.7,-142,137.5,-285,206.5,-429
-c69,-144,104.5,-217.7,106.5,-221
-l`+e/2.075+" -"+e+`
-c5.3,-9.3,12,-14,20,-14
-H400000v`+(40+e)+`H845.2724
-s-225.272,467,-225.272,467s-235,486,-235,486c-2.7,4.7,-9,7,-19,7
-c-6,0,-10,-1,-12,-3s-194,-422,-194,-422s-65,47,-65,47z
-M`+(834+e)+" "+t+"h400000v"+(40+e)+"h-400000z"},Ra=function(e,t){return"M263,"+(601+e+t)+`c0.7,0,18,39.7,52,119
-c34,79.3,68.167,158.7,102.5,238c34.3,79.3,51.8,119.3,52.5,120
-c340,-704.7,510.7,-1060.3,512,-1067
-l`+e/2.084+" -"+e+`
-c4.7,-7.3,11,-11,19,-11
-H40000v`+(40+e)+`H1012.3
-s-271.3,567,-271.3,567c-38.7,80.7,-84,175,-136,283c-52,108,-89.167,185.3,-111.5,232
-c-22.3,46.7,-33.8,70.3,-34.5,71c-4.7,4.7,-12.3,7,-23,7s-12,-1,-12,-1
-s-109,-253,-109,-253c-72.7,-168,-109.3,-252,-110,-252c-10.7,8,-22,16.7,-34,26
-c-22,17.3,-33.3,26,-34,26s-26,-26,-26,-26s76,-59,76,-59s76,-60,76,-60z
-M`+(1001+e)+" "+t+"h400000v"+(40+e)+"h-400000z"},Ia=function(e,t){return"M983 "+(10+e+t)+`
-l`+e/3.13+" -"+e+`
-c4,-6.7,10,-10,18,-10 H400000v`+(40+e)+`
-H1013.1s-83.4,268,-264.1,840c-180.7,572,-277,876.3,-289,913c-4.7,4.7,-12.7,7,-24,7
-s-12,0,-12,0c-1.3,-3.3,-3.7,-11.7,-7,-25c-35.3,-125.3,-106.7,-373.3,-214,-744
-c-10,12,-21,25,-33,39s-32,39,-32,39c-6,-5.3,-15,-14,-27,-26s25,-30,25,-30
-c26.7,-32.7,52,-63,76,-91s52,-60,52,-60s208,722,208,722
-c56,-175.3,126.3,-397.3,211,-666c84.7,-268.7,153.8,-488.2,207.5,-658.5
-c53.7,-170.3,84.5,-266.8,92.5,-289.5z
-M`+(1001+e)+" "+t+"h400000v"+(40+e)+"h-400000z"},Da=function(e,t){return"M424,"+(2398+e+t)+`
-c-1.3,-0.7,-38.5,-172,-111.5,-514c-73,-342,-109.8,-513.3,-110.5,-514
-c0,-2,-10.7,14.3,-32,49c-4.7,7.3,-9.8,15.7,-15.5,25c-5.7,9.3,-9.8,16,-12.5,20
-s-5,7,-5,7c-4,-3.3,-8.3,-7.7,-13,-13s-13,-13,-13,-13s76,-122,76,-122s77,-121,77,-121
-s209,968,209,968c0,-2,84.7,-361.7,254,-1079c169.3,-717.3,254.7,-1077.7,256,-1081
-l`+e/4.223+" -"+e+`c4,-6.7,10,-10,18,-10 H400000
-v`+(40+e)+`H1014.6
-s-87.3,378.7,-272.6,1166c-185.3,787.3,-279.3,1182.3,-282,1185
-c-2,6,-10,9,-24,9
-c-8,0,-12,-0.7,-12,-2z M`+(1001+e)+" "+t+`
-h400000v`+(40+e)+"h-400000z"},Ea=function(e,t){return"M473,"+(2713+e+t)+`
-c339.3,-1799.3,509.3,-2700,510,-2702 l`+e/5.298+" -"+e+`
-c3.3,-7.3,9.3,-11,18,-11 H400000v`+(40+e)+`H1017.7
-s-90.5,478,-276.2,1466c-185.7,988,-279.5,1483,-281.5,1485c-2,6,-10,9,-24,9
-c-8,0,-12,-0.7,-12,-2c0,-1.3,-5.3,-32,-16,-92c-50.7,-293.3,-119.7,-693.3,-207,-1200
-c0,-1.3,-5.3,8.7,-16,30c-10.7,21.3,-21.3,42.7,-32,64s-16,33,-16,33s-26,-26,-26,-26
-s76,-153,76,-153s77,-151,77,-151c0.7,0.7,35.7,202,105,604c67.3,400.7,102,602.7,104,
-606zM`+(1001+e)+" "+t+"h400000v"+(40+e)+"H1017.7z"},Oa=function(e){var t=e/2;return"M400000 "+e+" H0 L"+t+" 0 l65 45 L145 "+(e-80)+" H400000z"},Ha=function(e,t,a){var i=a-54-t-e;return"M702 "+(e+t)+"H400000"+(40+e)+`
-H742v`+i+`l-4 4-4 4c-.667.7 -2 1.5-4 2.5s-4.167 1.833-6.5 2.5-5.5 1-9.5 1
-h-12l-28-84c-16.667-52-96.667 -294.333-240-727l-212 -643 -85 170
-c-4-3.333-8.333-7.667-13 -13l-13-13l77-155 77-156c66 199.333 139 419.667
-219 661 l218 661zM702 `+t+"H400000v"+(40+e)+"H742z"},La=function(e,t,a){t=1e3*t;var i="";switch(e){case"sqrtMain":i=qa(t,_0);break;case"sqrtSize1":i=Ra(t,_0);break;case"sqrtSize2":i=Ia(t,_0);break;case"sqrtSize3":i=Da(t,_0);break;case"sqrtSize4":i=Ea(t,_0);break;case"sqrtTall":i=Ha(t,_0,a)}return i},Fa=function(e,t){switch(e){case"⎜":return"M291 0 H417 V"+t+" H291z M291 0 H417 V"+t+" H291z";case"∣":return"M145 0 H188 V"+t+" H145z M145 0 H188 V"+t+" H145z";case"∥":return"M145 0 H188 V"+t+" H145z M145 0 H188 V"+t+" H145z"+("M367 0 H410 V"+t+" H367z M367 0 H410 V"+t+" H367z");case"⎟":return"M457 0 H583 V"+t+" H457z M457 0 H583 V"+t+" H457z";case"⎢":return"M319 0 H403 V"+t+" H319z M319 0 H403 V"+t+" H319z";case"⎥":return"M263 0 H347 V"+t+" H263z M263 0 H347 V"+t+" H263z";case"⎪":return"M384 0 H504 V"+t+" H384z M384 0 H504 V"+t+" H384z";case"⏐":return"M312 0 H355 V"+t+" H312z M312 0 H355 V"+t+" H312z";case"‖":return"M257 0 H300 V"+t+" H257z M257 0 H300 V"+t+" H257z"+("M478 0 H521 V"+t+" H478z M478 0 H521 V"+t+" H478z");default:return""}},Ot={doubleleftarrow:`M262 157
-l10-10c34-36 62.7-77 86-123 3.3-8 5-13.3 5-16 0-5.3-6.7-8-20-8-7.3
- 0-12.2.5-14.5 1.5-2.3 1-4.8 4.5-7.5 10.5-49.3 97.3-121.7 169.3-217 216-28
- 14-57.3 25-88 33-6.7 2-11 3.8-13 5.5-2 1.7-3 4.2-3 7.5s1 5.8 3 7.5
-c2 1.7 6.3 3.5 13 5.5 68 17.3 128.2 47.8 180.5 91.5 52.3 43.7 93.8 96.2 124.5
- 157.5 9.3 8 15.3 12.3 18 13h6c12-.7 18-4 18-10 0-2-1.7-7-5-15-23.3-46-52-87
--86-123l-10-10h399738v-40H218c328 0 0 0 0 0l-10-8c-26.7-20-65.7-43-117-69 2.7
--2 6-3.7 10-5 36.7-16 72.3-37.3 107-64l10-8h399782v-40z
-m8 0v40h399730v-40zm0 194v40h399730v-40z`,doublerightarrow:`M399738 392l
--10 10c-34 36-62.7 77-86 123-3.3 8-5 13.3-5 16 0 5.3 6.7 8 20 8 7.3 0 12.2-.5
- 14.5-1.5 2.3-1 4.8-4.5 7.5-10.5 49.3-97.3 121.7-169.3 217-216 28-14 57.3-25 88
--33 6.7-2 11-3.8 13-5.5 2-1.7 3-4.2 3-7.5s-1-5.8-3-7.5c-2-1.7-6.3-3.5-13-5.5-68
--17.3-128.2-47.8-180.5-91.5-52.3-43.7-93.8-96.2-124.5-157.5-9.3-8-15.3-12.3-18
--13h-6c-12 .7-18 4-18 10 0 2 1.7 7 5 15 23.3 46 52 87 86 123l10 10H0v40h399782
-c-328 0 0 0 0 0l10 8c26.7 20 65.7 43 117 69-2.7 2-6 3.7-10 5-36.7 16-72.3 37.3
--107 64l-10 8H0v40zM0 157v40h399730v-40zm0 194v40h399730v-40z`,leftarrow:`M400000 241H110l3-3c68.7-52.7 113.7-120
- 135-202 4-14.7 6-23 6-25 0-7.3-7-11-21-11-8 0-13.2.8-15.5 2.5-2.3 1.7-4.2 5.8
--5.5 12.5-1.3 4.7-2.7 10.3-4 17-12 48.7-34.8 92-68.5 130S65.3 228.3 18 247
-c-10 4-16 7.7-18 11 0 8.7 6 14.3 18 17 47.3 18.7 87.8 47 121.5 85S196 441.3 208
- 490c.7 2 1.3 5 2 9s1.2 6.7 1.5 8c.3 1.3 1 3.3 2 6s2.2 4.5 3.5 5.5c1.3 1 3.3
- 1.8 6 2.5s6 1 10 1c14 0 21-3.7 21-11 0-2-2-10.3-6-25-20-79.3-65-146.7-135-202
- l-3-3h399890zM100 241v40h399900v-40z`,leftbrace:`M6 548l-6-6v-35l6-11c56-104 135.3-181.3 238-232 57.3-28.7 117
--45 179-50h399577v120H403c-43.3 7-81 15-113 26-100.7 33-179.7 91-237 174-2.7
- 5-6 9-10 13-.7 1-7.3 1-20 1H6z`,leftbraceunder:`M0 6l6-6h17c12.688 0 19.313.3 20 1 4 4 7.313 8.3 10 13
- 35.313 51.3 80.813 93.8 136.5 127.5 55.688 33.7 117.188 55.8 184.5 66.5.688
- 0 2 .3 4 1 18.688 2.7 76 4.3 172 5h399450v120H429l-6-1c-124.688-8-235-61.7
--331-161C60.687 138.7 32.312 99.3 7 54L0 41V6z`,leftgroup:`M400000 80
-H435C64 80 168.3 229.4 21 260c-5.9 1.2-18 0-18 0-2 0-3-1-3-3v-38C76 61 257 0
- 435 0h399565z`,leftgroupunder:`M400000 262
-H435C64 262 168.3 112.6 21 82c-5.9-1.2-18 0-18 0-2 0-3 1-3 3v38c76 158 257 219
- 435 219h399565z`,leftharpoon:`M0 267c.7 5.3 3 10 7 14h399993v-40H93c3.3
--3.3 10.2-9.5 20.5-18.5s17.8-15.8 22.5-20.5c50.7-52 88-110.3 112-175 4-11.3 5
--18.3 3-21-1.3-4-7.3-6-18-6-8 0-13 .7-15 2s-4.7 6.7-8 16c-42 98.7-107.3 174.7
--196 228-6.7 4.7-10.7 8-12 10-1.3 2-2 5.7-2 11zm100-26v40h399900v-40z`,leftharpoonplus:`M0 267c.7 5.3 3 10 7 14h399993v-40H93c3.3-3.3 10.2-9.5
- 20.5-18.5s17.8-15.8 22.5-20.5c50.7-52 88-110.3 112-175 4-11.3 5-18.3 3-21-1.3
--4-7.3-6-18-6-8 0-13 .7-15 2s-4.7 6.7-8 16c-42 98.7-107.3 174.7-196 228-6.7 4.7
--10.7 8-12 10-1.3 2-2 5.7-2 11zm100-26v40h399900v-40zM0 435v40h400000v-40z
-m0 0v40h400000v-40z`,leftharpoondown:`M7 241c-4 4-6.333 8.667-7 14 0 5.333.667 9 2 11s5.333
- 5.333 12 10c90.667 54 156 130 196 228 3.333 10.667 6.333 16.333 9 17 2 .667 5
- 1 9 1h5c10.667 0 16.667-2 18-6 2-2.667 1-9.667-3-21-32-87.333-82.667-157.667
--152-211l-3-3h399907v-40zM93 281 H400000 v-40L7 241z`,leftharpoondownplus:`M7 435c-4 4-6.3 8.7-7 14 0 5.3.7 9 2 11s5.3 5.3 12
- 10c90.7 54 156 130 196 228 3.3 10.7 6.3 16.3 9 17 2 .7 5 1 9 1h5c10.7 0 16.7
--2 18-6 2-2.7 1-9.7-3-21-32-87.3-82.7-157.7-152-211l-3-3h399907v-40H7zm93 0
-v40h399900v-40zM0 241v40h399900v-40zm0 0v40h399900v-40z`,lefthook:`M400000 281 H103s-33-11.2-61-33.5S0 197.3 0 164s14.2-61.2 42.5
--83.5C70.8 58.2 104 47 142 47 c16.7 0 25 6.7 25 20 0 12-8.7 18.7-26 20-40 3.3
--68.7 15.7-86 37-10 12-15 25.3-15 40 0 22.7 9.8 40.7 29.5 54 19.7 13.3 43.5 21
- 71.5 23h399859zM103 281v-40h399897v40z`,leftlinesegment:`M40 281 V428 H0 V94 H40 V241 H400000 v40z
-M40 281 V428 H0 V94 H40 V241 H400000 v40z`,leftmapsto:`M40 281 V448H0V74H40V241H400000v40z
-M40 281 V448H0V74H40V241H400000v40z`,leftToFrom:`M0 147h400000v40H0zm0 214c68 40 115.7 95.7 143 167h22c15.3 0 23
--.3 23-1 0-1.3-5.3-13.7-16-37-18-35.3-41.3-69-70-101l-7-8h399905v-40H95l7-8
-c28.7-32 52-65.7 70-101 10.7-23.3 16-35.7 16-37 0-.7-7.7-1-23-1h-22C115.7 265.3
- 68 321 0 361zm0-174v-40h399900v40zm100 154v40h399900v-40z`,longequal:`M0 50 h400000 v40H0z m0 194h40000v40H0z
-M0 50 h400000 v40H0z m0 194h40000v40H0z`,midbrace:`M200428 334
-c-100.7-8.3-195.3-44-280-108-55.3-42-101.7-93-139-153l-9-14c-2.7 4-5.7 8.7-9 14
--53.3 86.7-123.7 153-211 199-66.7 36-137.3 56.3-212 62H0V214h199568c178.3-11.7
- 311.7-78.3 403-201 6-8 9.7-12 11-12 .7-.7 6.7-1 18-1s17.3.3 18 1c1.3 0 5 4 11
- 12 44.7 59.3 101.3 106.3 170 141s145.3 54.3 229 60h199572v120z`,midbraceunder:`M199572 214
-c100.7 8.3 195.3 44 280 108 55.3 42 101.7 93 139 153l9 14c2.7-4 5.7-8.7 9-14
- 53.3-86.7 123.7-153 211-199 66.7-36 137.3-56.3 212-62h199568v120H200432c-178.3
- 11.7-311.7 78.3-403 201-6 8-9.7 12-11 12-.7.7-6.7 1-18 1s-17.3-.3-18-1c-1.3 0
--5-4-11-12-44.7-59.3-101.3-106.3-170-141s-145.3-54.3-229-60H0V214z`,oiintSize1:`M512.6 71.6c272.6 0 320.3 106.8 320.3 178.2 0 70.8-47.7 177.6
--320.3 177.6S193.1 320.6 193.1 249.8c0-71.4 46.9-178.2 319.5-178.2z
-m368.1 178.2c0-86.4-60.9-215.4-368.1-215.4-306.4 0-367.3 129-367.3 215.4 0 85.8
-60.9 214.8 367.3 214.8 307.2 0 368.1-129 368.1-214.8z`,oiintSize2:`M757.8 100.1c384.7 0 451.1 137.6 451.1 230 0 91.3-66.4 228.8
--451.1 228.8-386.3 0-452.7-137.5-452.7-228.8 0-92.4 66.4-230 452.7-230z
-m502.4 230c0-111.2-82.4-277.2-502.4-277.2s-504 166-504 277.2
-c0 110 84 276 504 276s502.4-166 502.4-276z`,oiiintSize1:`M681.4 71.6c408.9 0 480.5 106.8 480.5 178.2 0 70.8-71.6 177.6
--480.5 177.6S202.1 320.6 202.1 249.8c0-71.4 70.5-178.2 479.3-178.2z
-m525.8 178.2c0-86.4-86.8-215.4-525.7-215.4-437.9 0-524.7 129-524.7 215.4 0
-85.8 86.8 214.8 524.7 214.8 438.9 0 525.7-129 525.7-214.8z`,oiiintSize2:`M1021.2 53c603.6 0 707.8 165.8 707.8 277.2 0 110-104.2 275.8
--707.8 275.8-606 0-710.2-165.8-710.2-275.8C311 218.8 415.2 53 1021.2 53z
-m770.4 277.1c0-131.2-126.4-327.6-770.5-327.6S248.4 198.9 248.4 330.1
-c0 130 128.8 326.4 772.7 326.4s770.5-196.4 770.5-326.4z`,rightarrow:`M0 241v40h399891c-47.3 35.3-84 78-110 128
--16.7 32-27.7 63.7-33 95 0 1.3-.2 2.7-.5 4-.3 1.3-.5 2.3-.5 3 0 7.3 6.7 11 20
- 11 8 0 13.2-.8 15.5-2.5 2.3-1.7 4.2-5.5 5.5-11.5 2-13.3 5.7-27 11-41 14.7-44.7
- 39-84.5 73-119.5s73.7-60.2 119-75.5c6-2 9-5.7 9-11s-3-9-9-11c-45.3-15.3-85
--40.5-119-75.5s-58.3-74.8-73-119.5c-4.7-14-8.3-27.3-11-40-1.3-6.7-3.2-10.8-5.5
--12.5-2.3-1.7-7.5-2.5-15.5-2.5-14 0-21 3.7-21 11 0 2 2 10.3 6 25 20.7 83.3 67
- 151.7 139 205zm0 0v40h399900v-40z`,rightbrace:`M400000 542l
--6 6h-17c-12.7 0-19.3-.3-20-1-4-4-7.3-8.3-10-13-35.3-51.3-80.8-93.8-136.5-127.5
-s-117.2-55.8-184.5-66.5c-.7 0-2-.3-4-1-18.7-2.7-76-4.3-172-5H0V214h399571l6 1
-c124.7 8 235 61.7 331 161 31.3 33.3 59.7 72.7 85 118l7 13v35z`,rightbraceunder:`M399994 0l6 6v35l-6 11c-56 104-135.3 181.3-238 232-57.3
- 28.7-117 45-179 50H-300V214h399897c43.3-7 81-15 113-26 100.7-33 179.7-91 237
--174 2.7-5 6-9 10-13 .7-1 7.3-1 20-1h17z`,rightgroup:`M0 80h399565c371 0 266.7 149.4 414 180 5.9 1.2 18 0 18 0 2 0
- 3-1 3-3v-38c-76-158-257-219-435-219H0z`,rightgroupunder:`M0 262h399565c371 0 266.7-149.4 414-180 5.9-1.2 18 0 18
- 0 2 0 3 1 3 3v38c-76 158-257 219-435 219H0z`,rightharpoon:`M0 241v40h399993c4.7-4.7 7-9.3 7-14 0-9.3
--3.7-15.3-11-18-92.7-56.7-159-133.7-199-231-3.3-9.3-6-14.7-8-16-2-1.3-7-2-15-2
--10.7 0-16.7 2-18 6-2 2.7-1 9.7 3 21 15.3 42 36.7 81.8 64 119.5 27.3 37.7 58
- 69.2 92 94.5zm0 0v40h399900v-40z`,rightharpoonplus:`M0 241v40h399993c4.7-4.7 7-9.3 7-14 0-9.3-3.7-15.3-11
--18-92.7-56.7-159-133.7-199-231-3.3-9.3-6-14.7-8-16-2-1.3-7-2-15-2-10.7 0-16.7
- 2-18 6-2 2.7-1 9.7 3 21 15.3 42 36.7 81.8 64 119.5 27.3 37.7 58 69.2 92 94.5z
-m0 0v40h399900v-40z m100 194v40h399900v-40zm0 0v40h399900v-40z`,rightharpoondown:`M399747 511c0 7.3 6.7 11 20 11 8 0 13-.8 15-2.5s4.7-6.8
- 8-15.5c40-94 99.3-166.3 178-217 13.3-8 20.3-12.3 21-13 5.3-3.3 8.5-5.8 9.5
--7.5 1-1.7 1.5-5.2 1.5-10.5s-2.3-10.3-7-15H0v40h399908c-34 25.3-64.7 57-92 95
--27.3 38-48.7 77.7-64 119-3.3 8.7-5 14-5 16zM0 241v40h399900v-40z`,rightharpoondownplus:`M399747 705c0 7.3 6.7 11 20 11 8 0 13-.8
- 15-2.5s4.7-6.8 8-15.5c40-94 99.3-166.3 178-217 13.3-8 20.3-12.3 21-13 5.3-3.3
- 8.5-5.8 9.5-7.5 1-1.7 1.5-5.2 1.5-10.5s-2.3-10.3-7-15H0v40h399908c-34 25.3
--64.7 57-92 95-27.3 38-48.7 77.7-64 119-3.3 8.7-5 14-5 16zM0 435v40h399900v-40z
-m0-194v40h400000v-40zm0 0v40h400000v-40z`,righthook:`M399859 241c-764 0 0 0 0 0 40-3.3 68.7-15.7 86-37 10-12 15-25.3
- 15-40 0-22.7-9.8-40.7-29.5-54-19.7-13.3-43.5-21-71.5-23-17.3-1.3-26-8-26-20 0
--13.3 8.7-20 26-20 38 0 71 11.2 99 33.5 0 0 7 5.6 21 16.7 14 11.2 21 33.5 21
- 66.8s-14 61.2-42 83.5c-28 22.3-61 33.5-99 33.5L0 241z M0 281v-40h399859v40z`,rightlinesegment:`M399960 241 V94 h40 V428 h-40 V281 H0 v-40z
-M399960 241 V94 h40 V428 h-40 V281 H0 v-40z`,rightToFrom:`M400000 167c-70.7-42-118-97.7-142-167h-23c-15.3 0-23 .3-23
- 1 0 1.3 5.3 13.7 16 37 18 35.3 41.3 69 70 101l7 8H0v40h399905l-7 8c-28.7 32
--52 65.7-70 101-10.7 23.3-16 35.7-16 37 0 .7 7.7 1 23 1h23c24-69.3 71.3-125 142
--167z M100 147v40h399900v-40zM0 341v40h399900v-40z`,twoheadleftarrow:`M0 167c68 40
- 115.7 95.7 143 167h22c15.3 0 23-.3 23-1 0-1.3-5.3-13.7-16-37-18-35.3-41.3-69
--70-101l-7-8h125l9 7c50.7 39.3 85 86 103 140h46c0-4.7-6.3-18.7-19-42-18-35.3
--40-67.3-66-96l-9-9h399716v-40H284l9-9c26-28.7 48-60.7 66-96 12.7-23.333 19
--37.333 19-42h-46c-18 54-52.3 100.7-103 140l-9 7H95l7-8c28.7-32 52-65.7 70-101
- 10.7-23.333 16-35.7 16-37 0-.7-7.7-1-23-1h-22C115.7 71.3 68 127 0 167z`,twoheadrightarrow:`M400000 167
-c-68-40-115.7-95.7-143-167h-22c-15.3 0-23 .3-23 1 0 1.3 5.3 13.7 16 37 18 35.3
- 41.3 69 70 101l7 8h-125l-9-7c-50.7-39.3-85-86-103-140h-46c0 4.7 6.3 18.7 19 42
- 18 35.3 40 67.3 66 96l9 9H0v40h399716l-9 9c-26 28.7-48 60.7-66 96-12.7 23.333
--19 37.333-19 42h46c18-54 52.3-100.7 103-140l9-7h125l-7 8c-28.7 32-52 65.7-70
- 101-10.7 23.333-16 35.7-16 37 0 .7 7.7 1 23 1h22c27.3-71.3 75-127 143-167z`,tilde1:`M200 55.538c-77 0-168 73.953-177 73.953-3 0-7
--2.175-9-5.437L2 97c-1-2-2-4-2-6 0-4 2-7 5-9l20-12C116 12 171 0 207 0c86 0
- 114 68 191 68 78 0 168-68 177-68 4 0 7 2 9 5l12 19c1 2.175 2 4.35 2 6.525 0
- 4.35-2 7.613-5 9.788l-19 13.05c-92 63.077-116.937 75.308-183 76.128
--68.267.847-113-73.952-191-73.952z`,tilde2:`M344 55.266c-142 0-300.638 81.316-311.5 86.418
--8.01 3.762-22.5 10.91-23.5 5.562L1 120c-1-2-1-3-1-4 0-5 3-9 8-10l18.4-9C160.9
- 31.9 283 0 358 0c148 0 188 122 331 122s314-97 326-97c4 0 8 2 10 7l7 21.114
-c1 2.14 1 3.21 1 4.28 0 5.347-3 9.626-7 10.696l-22.3 12.622C852.6 158.372 751
- 181.476 676 181.476c-149 0-189-126.21-332-126.21z`,tilde3:`M786 59C457 59 32 175.242 13 175.242c-6 0-10-3.457
--11-10.37L.15 138c-1-7 3-12 10-13l19.2-6.4C378.4 40.7 634.3 0 804.3 0c337 0
- 411.8 157 746.8 157 328 0 754-112 773-112 5 0 10 3 11 9l1 14.075c1 8.066-.697
- 16.595-6.697 17.492l-21.052 7.31c-367.9 98.146-609.15 122.696-778.15 122.696
- -338 0-409-156.573-744-156.573z`,tilde4:`M786 58C457 58 32 177.487 13 177.487c-6 0-10-3.345
--11-10.035L.15 143c-1-7 3-12 10-13l22-6.7C381.2 35 637.15 0 807.15 0c337 0 409
- 177 744 177 328 0 754-127 773-127 5 0 10 3 11 9l1 14.794c1 7.805-3 13.38-9
- 14.495l-20.7 5.574c-366.85 99.79-607.3 139.372-776.3 139.372-338 0-409
- -175.236-744-175.236z`,vec:`M377 20c0-5.333 1.833-10 5.5-14S391 0 397 0c4.667 0 8.667 1.667 12 5
-3.333 2.667 6.667 9 10 19 6.667 24.667 20.333 43.667 41 57 7.333 4.667 11
-10.667 11 18 0 6-1 10-3 12s-6.667 5-14 9c-28.667 14.667-53.667 35.667-75 63
--1.333 1.333-3.167 3.5-5.5 6.5s-4 4.833-5 5.5c-1 .667-2.5 1.333-4.5 2s-4.333 1
--7 1c-4.667 0-9.167-1.833-13.5-5.5S337 184 337 178c0-12.667 15.667-32.333 47-59
-H213l-171-1c-8.667-6-13-12.333-13-19 0-4.667 4.333-11.333 13-20h359
-c-16-25.333-24-45-24-59z`,widehat1:`M529 0h5l519 115c5 1 9 5 9 10 0 1-1 2-1 3l-4 22
-c-1 5-5 9-11 9h-2L532 67 19 159h-2c-5 0-9-4-11-9l-5-22c-1-6 2-12 8-13z`,widehat2:`M1181 0h2l1171 176c6 0 10 5 10 11l-2 23c-1 6-5 10
--11 10h-1L1182 67 15 220h-1c-6 0-10-4-11-10l-2-23c-1-6 4-11 10-11z`,widehat3:`M1181 0h2l1171 236c6 0 10 5 10 11l-2 23c-1 6-5 10
--11 10h-1L1182 67 15 280h-1c-6 0-10-4-11-10l-2-23c-1-6 4-11 10-11z`,widehat4:`M1181 0h2l1171 296c6 0 10 5 10 11l-2 23c-1 6-5 10
--11 10h-1L1182 67 15 340h-1c-6 0-10-4-11-10l-2-23c-1-6 4-11 10-11z`,widecheck1:`M529,159h5l519,-115c5,-1,9,-5,9,-10c0,-1,-1,-2,-1,-3l-4,-22c-1,
--5,-5,-9,-11,-9h-2l-512,92l-513,-92h-2c-5,0,-9,4,-11,9l-5,22c-1,6,2,12,8,13z`,widecheck2:`M1181,220h2l1171,-176c6,0,10,-5,10,-11l-2,-23c-1,-6,-5,-10,
--11,-10h-1l-1168,153l-1167,-153h-1c-6,0,-10,4,-11,10l-2,23c-1,6,4,11,10,11z`,widecheck3:`M1181,280h2l1171,-236c6,0,10,-5,10,-11l-2,-23c-1,-6,-5,-10,
--11,-10h-1l-1168,213l-1167,-213h-1c-6,0,-10,4,-11,10l-2,23c-1,6,4,11,10,11z`,widecheck4:`M1181,340h2l1171,-296c6,0,10,-5,10,-11l-2,-23c-1,-6,-5,-10,
--11,-10h-1l-1168,273l-1167,-273h-1c-6,0,-10,4,-11,10l-2,23c-1,6,4,11,10,11z`,baraboveleftarrow:`M400000 620h-399890l3 -3c68.7 -52.7 113.7 -120 135 -202
-c4 -14.7 6 -23 6 -25c0 -7.3 -7 -11 -21 -11c-8 0 -13.2 0.8 -15.5 2.5
-c-2.3 1.7 -4.2 5.8 -5.5 12.5c-1.3 4.7 -2.7 10.3 -4 17c-12 48.7 -34.8 92 -68.5 130
-s-74.2 66.3 -121.5 85c-10 4 -16 7.7 -18 11c0 8.7 6 14.3 18 17c47.3 18.7 87.8 47
-121.5 85s56.5 81.3 68.5 130c0.7 2 1.3 5 2 9s1.2 6.7 1.5 8c0.3 1.3 1 3.3 2 6
-s2.2 4.5 3.5 5.5c1.3 1 3.3 1.8 6 2.5s6 1 10 1c14 0 21 -3.7 21 -11
-c0 -2 -2 -10.3 -6 -25c-20 -79.3 -65 -146.7 -135 -202l-3 -3h399890z
-M100 620v40h399900v-40z M0 241v40h399900v-40zM0 241v40h399900v-40z`,rightarrowabovebar:`M0 241v40h399891c-47.3 35.3-84 78-110 128-16.7 32
--27.7 63.7-33 95 0 1.3-.2 2.7-.5 4-.3 1.3-.5 2.3-.5 3 0 7.3 6.7 11 20 11 8 0
-13.2-.8 15.5-2.5 2.3-1.7 4.2-5.5 5.5-11.5 2-13.3 5.7-27 11-41 14.7-44.7 39
--84.5 73-119.5s73.7-60.2 119-75.5c6-2 9-5.7 9-11s-3-9-9-11c-45.3-15.3-85-40.5
--119-75.5s-58.3-74.8-73-119.5c-4.7-14-8.3-27.3-11-40-1.3-6.7-3.2-10.8-5.5
--12.5-2.3-1.7-7.5-2.5-15.5-2.5-14 0-21 3.7-21 11 0 2 2 10.3 6 25 20.7 83.3 67
-151.7 139 205zm96 379h399894v40H0zm0 0h399904v40H0z`,baraboveshortleftharpoon:`M507,435c-4,4,-6.3,8.7,-7,14c0,5.3,0.7,9,2,11
-c1.3,2,5.3,5.3,12,10c90.7,54,156,130,196,228c3.3,10.7,6.3,16.3,9,17
-c2,0.7,5,1,9,1c0,0,5,0,5,0c10.7,0,16.7,-2,18,-6c2,-2.7,1,-9.7,-3,-21
-c-32,-87.3,-82.7,-157.7,-152,-211c0,0,-3,-3,-3,-3l399351,0l0,-40
-c-398570,0,-399437,0,-399437,0z M593 435 v40 H399500 v-40z
-M0 281 v-40 H399908 v40z M0 281 v-40 H399908 v40z`,rightharpoonaboveshortbar:`M0,241 l0,40c399126,0,399993,0,399993,0
-c4.7,-4.7,7,-9.3,7,-14c0,-9.3,-3.7,-15.3,-11,-18c-92.7,-56.7,-159,-133.7,-199,
--231c-3.3,-9.3,-6,-14.7,-8,-16c-2,-1.3,-7,-2,-15,-2c-10.7,0,-16.7,2,-18,6
-c-2,2.7,-1,9.7,3,21c15.3,42,36.7,81.8,64,119.5c27.3,37.7,58,69.2,92,94.5z
-M0 241 v40 H399908 v-40z M0 475 v-40 H399500 v40z M0 475 v-40 H399500 v40z`,shortbaraboveleftharpoon:`M7,435c-4,4,-6.3,8.7,-7,14c0,5.3,0.7,9,2,11
-c1.3,2,5.3,5.3,12,10c90.7,54,156,130,196,228c3.3,10.7,6.3,16.3,9,17c2,0.7,5,1,9,
-1c0,0,5,0,5,0c10.7,0,16.7,-2,18,-6c2,-2.7,1,-9.7,-3,-21c-32,-87.3,-82.7,-157.7,
--152,-211c0,0,-3,-3,-3,-3l399907,0l0,-40c-399126,0,-399993,0,-399993,0z
-M93 435 v40 H400000 v-40z M500 241 v40 H400000 v-40z M500 241 v40 H400000 v-40z`,shortrightharpoonabovebar:`M53,241l0,40c398570,0,399437,0,399437,0
-c4.7,-4.7,7,-9.3,7,-14c0,-9.3,-3.7,-15.3,-11,-18c-92.7,-56.7,-159,-133.7,-199,
--231c-3.3,-9.3,-6,-14.7,-8,-16c-2,-1.3,-7,-2,-15,-2c-10.7,0,-16.7,2,-18,6
-c-2,2.7,-1,9.7,3,21c15.3,42,36.7,81.8,64,119.5c27.3,37.7,58,69.2,92,94.5z
-M500 241 v40 H399408 v-40z M500 435 v40 H400000 v-40z`},Pa=function(e,t){switch(e){case"lbrack":return"M403 1759 V84 H666 V0 H319 V1759 v"+t+` v1759 h347 v-84
-H403z M403 1759 V0 H319 V1759 v`+t+" v1759 h84z";case"rbrack":return"M347 1759 V0 H0 V84 H263 V1759 v"+t+` v1759 H0 v84 H347z
-M347 1759 V0 H263 V1759 v`+t+" v1759 h84z";case"vert":return"M145 15 v585 v"+t+` v585 c2.667,10,9.667,15,21,15
-c10,0,16.667,-5,20,-15 v-585 v`+-t+` v-585 c-2.667,-10,-9.667,-15,-21,-15
-c-10,0,-16.667,5,-20,15z M188 15 H145 v585 v`+t+" v585 h43z";case"doublevert":return"M145 15 v585 v"+t+` v585 c2.667,10,9.667,15,21,15
-c10,0,16.667,-5,20,-15 v-585 v`+-t+` v-585 c-2.667,-10,-9.667,-15,-21,-15
-c-10,0,-16.667,5,-20,15z M188 15 H145 v585 v`+t+` v585 h43z
-M367 15 v585 v`+t+` v585 c2.667,10,9.667,15,21,15
-c10,0,16.667,-5,20,-15 v-585 v`+-t+` v-585 c-2.667,-10,-9.667,-15,-21,-15
-c-10,0,-16.667,5,-20,15z M410 15 H367 v585 v`+t+" v585 h43z";case"lfloor":return"M319 602 V0 H403 V602 v"+t+` v1715 h263 v84 H319z
-MM319 602 V0 H403 V602 v`+t+" v1715 H319z";case"rfloor":return"M319 602 V0 H403 V602 v"+t+` v1799 H0 v-84 H319z
-MM319 602 V0 H403 V602 v`+t+" v1715 H319z";case"lceil":return"M403 1759 V84 H666 V0 H319 V1759 v"+t+` v602 h84z
-M403 1759 V0 H319 V1759 v`+t+" v602 h84z";case"rceil":return"M347 1759 V0 H0 V84 H263 V1759 v"+t+` v602 h84z
-M347 1759 V0 h-84 V1759 v`+t+" v602 h84z";case"lparen":return`M863,9c0,-2,-2,-5,-6,-9c0,0,-17,0,-17,0c-12.7,0,-19.3,0.3,-20,1
-c-5.3,5.3,-10.3,11,-15,17c-242.7,294.7,-395.3,682,-458,1162c-21.3,163.3,-33.3,349,
--36,557 l0,`+(t+84)+`c0.2,6,0,26,0,60c2,159.3,10,310.7,24,454c53.3,528,210,
-949.7,470,1265c4.7,6,9.7,11.7,15,17c0.7,0.7,7,1,19,1c0,0,18,0,18,0c4,-4,6,-7,6,-9
-c0,-2.7,-3.3,-8.7,-10,-18c-135.3,-192.7,-235.5,-414.3,-300.5,-665c-65,-250.7,-102.5,
--544.7,-112.5,-882c-2,-104,-3,-167,-3,-189
-l0,-`+(t+92)+`c0,-162.7,5.7,-314,17,-454c20.7,-272,63.7,-513,129,-723c65.3,
--210,155.3,-396.3,270,-559c6.7,-9.3,10,-15.3,10,-18z`;case"rparen":return`M76,0c-16.7,0,-25,3,-25,9c0,2,2,6.3,6,13c21.3,28.7,42.3,60.3,
-63,95c96.7,156.7,172.8,332.5,228.5,527.5c55.7,195,92.8,416.5,111.5,664.5
-c11.3,139.3,17,290.7,17,454c0,28,1.7,43,3.3,45l0,`+(t+9)+`
-c-3,4,-3.3,16.7,-3.3,38c0,162,-5.7,313.7,-17,455c-18.7,248,-55.8,469.3,-111.5,664
-c-55.7,194.7,-131.8,370.3,-228.5,527c-20.7,34.7,-41.7,66.3,-63,95c-2,3.3,-4,7,-6,11
-c0,7.3,5.7,11,17,11c0,0,11,0,11,0c9.3,0,14.3,-0.3,15,-1c5.3,-5.3,10.3,-11,15,-17
-c242.7,-294.7,395.3,-681.7,458,-1161c21.3,-164.7,33.3,-350.7,36,-558
-l0,-`+(t+144)+`c-2,-159.3,-10,-310.7,-24,-454c-53.3,-528,-210,-949.7,
--470,-1265c-4.7,-6,-9.7,-11.7,-15,-17c-0.7,-0.7,-6.7,-1,-18,-1z`;default:throw new Error("Unknown stretchy delimiter.")}};class he{constructor(e){this.children=void 0,this.classes=void 0,this.height=void 0,this.depth=void 0,this.maxFontSize=void 0,this.style=void 0,this.children=e,this.classes=[],this.height=0,this.depth=0,this.maxFontSize=0,this.style={}}hasClass(e){return this.classes.includes(e)}toNode(){for(var e=document.createDocumentFragment(),t=0;t<this.children.length;t++)e.appendChild(this.children[t].toNode());return e}toMarkup(){for(var e="",t=0;t<this.children.length;t++)e+=this.children[t].toMarkup();return e}toText(){var e=t=>t.toText();return this.children.map(e).join("")}}var w0={"AMS-Regular":{32:[0,0,0,0,.25],65:[0,.68889,0,0,.72222],66:[0,.68889,0,0,.66667],67:[0,.68889,0,0,.72222],68:[0,.68889,0,0,.72222],69:[0,.68889,0,0,.66667],70:[0,.68889,0,0,.61111],71:[0,.68889,0,0,.77778],72:[0,.68889,0,0,.77778],73:[0,.68889,0,0,.38889],74:[.16667,.68889,0,0,.5],75:[0,.68889,0,0,.77778],76:[0,.68889,0,0,.66667],77:[0,.68889,0,0,.94445],78:[0,.68889,0,0,.72222],79:[.16667,.68889,0,0,.77778],80:[0,.68889,0,0,.61111],81:[.16667,.68889,0,0,.77778],82:[0,.68889,0,0,.72222],83:[0,.68889,0,0,.55556],84:[0,.68889,0,0,.66667],85:[0,.68889,0,0,.72222],86:[0,.68889,0,0,.72222],87:[0,.68889,0,0,1],88:[0,.68889,0,0,.72222],89:[0,.68889,0,0,.72222],90:[0,.68889,0,0,.66667],107:[0,.68889,0,0,.55556],160:[0,0,0,0,.25],165:[0,.675,.025,0,.75],174:[.15559,.69224,0,0,.94666],240:[0,.68889,0,0,.55556],295:[0,.68889,0,0,.54028],710:[0,.825,0,0,2.33334],732:[0,.9,0,0,2.33334],770:[0,.825,0,0,2.33334],771:[0,.9,0,0,2.33334],989:[.08167,.58167,0,0,.77778],1008:[0,.43056,.04028,0,.66667],8245:[0,.54986,0,0,.275],8463:[0,.68889,0,0,.54028],8487:[0,.68889,0,0,.72222],8498:[0,.68889,0,0,.55556],8502:[0,.68889,0,0,.66667],8503:[0,.68889,0,0,.44445],8504:[0,.68889,0,0,.66667],8513:[0,.68889,0,0,.63889],8592:[-.03598,.46402,0,0,.5],8594:[-.03598,.46402,0,0,.5],8602:[-.13313,.36687,0,0,1],8603:[-.13313,.36687,0,0,1],8606:[.01354,.52239,0,0,1],8608:[.01354,.52239,0,0,1],8610:[.01354,.52239,0,0,1.11111],8611:[.01354,.52239,0,0,1.11111],8619:[0,.54986,0,0,1],8620:[0,.54986,0,0,1],8621:[-.13313,.37788,0,0,1.38889],8622:[-.13313,.36687,0,0,1],8624:[0,.69224,0,0,.5],8625:[0,.69224,0,0,.5],8630:[0,.43056,0,0,1],8631:[0,.43056,0,0,1],8634:[.08198,.58198,0,0,.77778],8635:[.08198,.58198,0,0,.77778],8638:[.19444,.69224,0,0,.41667],8639:[.19444,.69224,0,0,.41667],8642:[.19444,.69224,0,0,.41667],8643:[.19444,.69224,0,0,.41667],8644:[.1808,.675,0,0,1],8646:[.1808,.675,0,0,1],8647:[.1808,.675,0,0,1],8648:[.19444,.69224,0,0,.83334],8649:[.1808,.675,0,0,1],8650:[.19444,.69224,0,0,.83334],8651:[.01354,.52239,0,0,1],8652:[.01354,.52239,0,0,1],8653:[-.13313,.36687,0,0,1],8654:[-.13313,.36687,0,0,1],8655:[-.13313,.36687,0,0,1],8666:[.13667,.63667,0,0,1],8667:[.13667,.63667,0,0,1],8669:[-.13313,.37788,0,0,1],8672:[-.064,.437,0,0,1.334],8674:[-.064,.437,0,0,1.334],8705:[0,.825,0,0,.5],8708:[0,.68889,0,0,.55556],8709:[.08167,.58167,0,0,.77778],8717:[0,.43056,0,0,.42917],8722:[-.03598,.46402,0,0,.5],8724:[.08198,.69224,0,0,.77778],8726:[.08167,.58167,0,0,.77778],8733:[0,.69224,0,0,.77778],8736:[0,.69224,0,0,.72222],8737:[0,.69224,0,0,.72222],8738:[.03517,.52239,0,0,.72222],8739:[.08167,.58167,0,0,.22222],8740:[.25142,.74111,0,0,.27778],8741:[.08167,.58167,0,0,.38889],8742:[.25142,.74111,0,0,.5],8756:[0,.69224,0,0,.66667],8757:[0,.69224,0,0,.66667],8764:[-.13313,.36687,0,0,.77778],8765:[-.13313,.37788,0,0,.77778],8769:[-.13313,.36687,0,0,.77778],8770:[-.03625,.46375,0,0,.77778],8774:[.30274,.79383,0,0,.77778],8776:[-.01688,.48312,0,0,.77778],8778:[.08167,.58167,0,0,.77778],8782:[.06062,.54986,0,0,.77778],8783:[.06062,.54986,0,0,.77778],8785:[.08198,.58198,0,0,.77778],8786:[.08198,.58198,0,0,.77778],8787:[.08198,.58198,0,0,.77778],8790:[0,.69224,0,0,.77778],8791:[.22958,.72958,0,0,.77778],8796:[.08198,.91667,0,0,.77778],8806:[.25583,.75583,0,0,.77778],8807:[.25583,.75583,0,0,.77778],8808:[.25142,.75726,0,0,.77778],8809:[.25142,.75726,0,0,.77778],8812:[.25583,.75583,0,0,.5],8814:[.20576,.70576,0,0,.77778],8815:[.20576,.70576,0,0,.77778],8816:[.30274,.79383,0,0,.77778],8817:[.30274,.79383,0,0,.77778],8818:[.22958,.72958,0,0,.77778],8819:[.22958,.72958,0,0,.77778],8822:[.1808,.675,0,0,.77778],8823:[.1808,.675,0,0,.77778],8828:[.13667,.63667,0,0,.77778],8829:[.13667,.63667,0,0,.77778],8830:[.22958,.72958,0,0,.77778],8831:[.22958,.72958,0,0,.77778],8832:[.20576,.70576,0,0,.77778],8833:[.20576,.70576,0,0,.77778],8840:[.30274,.79383,0,0,.77778],8841:[.30274,.79383,0,0,.77778],8842:[.13597,.63597,0,0,.77778],8843:[.13597,.63597,0,0,.77778],8847:[.03517,.54986,0,0,.77778],8848:[.03517,.54986,0,0,.77778],8858:[.08198,.58198,0,0,.77778],8859:[.08198,.58198,0,0,.77778],8861:[.08198,.58198,0,0,.77778],8862:[0,.675,0,0,.77778],8863:[0,.675,0,0,.77778],8864:[0,.675,0,0,.77778],8865:[0,.675,0,0,.77778],8872:[0,.69224,0,0,.61111],8873:[0,.69224,0,0,.72222],8874:[0,.69224,0,0,.88889],8876:[0,.68889,0,0,.61111],8877:[0,.68889,0,0,.61111],8878:[0,.68889,0,0,.72222],8879:[0,.68889,0,0,.72222],8882:[.03517,.54986,0,0,.77778],8883:[.03517,.54986,0,0,.77778],8884:[.13667,.63667,0,0,.77778],8885:[.13667,.63667,0,0,.77778],8888:[0,.54986,0,0,1.11111],8890:[.19444,.43056,0,0,.55556],8891:[.19444,.69224,0,0,.61111],8892:[.19444,.69224,0,0,.61111],8901:[0,.54986,0,0,.27778],8903:[.08167,.58167,0,0,.77778],8905:[.08167,.58167,0,0,.77778],8906:[.08167,.58167,0,0,.77778],8907:[0,.69224,0,0,.77778],8908:[0,.69224,0,0,.77778],8909:[-.03598,.46402,0,0,.77778],8910:[0,.54986,0,0,.76042],8911:[0,.54986,0,0,.76042],8912:[.03517,.54986,0,0,.77778],8913:[.03517,.54986,0,0,.77778],8914:[0,.54986,0,0,.66667],8915:[0,.54986,0,0,.66667],8916:[0,.69224,0,0,.66667],8918:[.0391,.5391,0,0,.77778],8919:[.0391,.5391,0,0,.77778],8920:[.03517,.54986,0,0,1.33334],8921:[.03517,.54986,0,0,1.33334],8922:[.38569,.88569,0,0,.77778],8923:[.38569,.88569,0,0,.77778],8926:[.13667,.63667,0,0,.77778],8927:[.13667,.63667,0,0,.77778],8928:[.30274,.79383,0,0,.77778],8929:[.30274,.79383,0,0,.77778],8934:[.23222,.74111,0,0,.77778],8935:[.23222,.74111,0,0,.77778],8936:[.23222,.74111,0,0,.77778],8937:[.23222,.74111,0,0,.77778],8938:[.20576,.70576,0,0,.77778],8939:[.20576,.70576,0,0,.77778],8940:[.30274,.79383,0,0,.77778],8941:[.30274,.79383,0,0,.77778],8994:[.19444,.69224,0,0,.77778],8995:[.19444,.69224,0,0,.77778],9416:[.15559,.69224,0,0,.90222],9484:[0,.69224,0,0,.5],9488:[0,.69224,0,0,.5],9492:[0,.37788,0,0,.5],9496:[0,.37788,0,0,.5],9585:[.19444,.68889,0,0,.88889],9586:[.19444,.74111,0,0,.88889],9632:[0,.675,0,0,.77778],9633:[0,.675,0,0,.77778],9650:[0,.54986,0,0,.72222],9651:[0,.54986,0,0,.72222],9654:[.03517,.54986,0,0,.77778],9660:[0,.54986,0,0,.72222],9661:[0,.54986,0,0,.72222],9664:[.03517,.54986,0,0,.77778],9674:[.11111,.69224,0,0,.66667],9733:[.19444,.69224,0,0,.94445],10003:[0,.69224,0,0,.83334],10016:[0,.69224,0,0,.83334],10731:[.11111,.69224,0,0,.66667],10846:[.19444,.75583,0,0,.61111],10877:[.13667,.63667,0,0,.77778],10878:[.13667,.63667,0,0,.77778],10885:[.25583,.75583,0,0,.77778],10886:[.25583,.75583,0,0,.77778],10887:[.13597,.63597,0,0,.77778],10888:[.13597,.63597,0,0,.77778],10889:[.26167,.75726,0,0,.77778],10890:[.26167,.75726,0,0,.77778],10891:[.48256,.98256,0,0,.77778],10892:[.48256,.98256,0,0,.77778],10901:[.13667,.63667,0,0,.77778],10902:[.13667,.63667,0,0,.77778],10933:[.25142,.75726,0,0,.77778],10934:[.25142,.75726,0,0,.77778],10935:[.26167,.75726,0,0,.77778],10936:[.26167,.75726,0,0,.77778],10937:[.26167,.75726,0,0,.77778],10938:[.26167,.75726,0,0,.77778],10949:[.25583,.75583,0,0,.77778],10950:[.25583,.75583,0,0,.77778],10955:[.28481,.79383,0,0,.77778],10956:[.28481,.79383,0,0,.77778],57350:[.08167,.58167,0,0,.22222],57351:[.08167,.58167,0,0,.38889],57352:[.08167,.58167,0,0,.77778],57353:[0,.43056,.04028,0,.66667],57356:[.25142,.75726,0,0,.77778],57357:[.25142,.75726,0,0,.77778],57358:[.41951,.91951,0,0,.77778],57359:[.30274,.79383,0,0,.77778],57360:[.30274,.79383,0,0,.77778],57361:[.41951,.91951,0,0,.77778],57366:[.25142,.75726,0,0,.77778],57367:[.25142,.75726,0,0,.77778],57368:[.25142,.75726,0,0,.77778],57369:[.25142,.75726,0,0,.77778],57370:[.13597,.63597,0,0,.77778],57371:[.13597,.63597,0,0,.77778]},"Caligraphic-Regular":{32:[0,0,0,0,.25],65:[0,.68333,0,.19445,.79847],66:[0,.68333,.03041,.13889,.65681],67:[0,.68333,.05834,.13889,.52653],68:[0,.68333,.02778,.08334,.77139],69:[0,.68333,.08944,.11111,.52778],70:[0,.68333,.09931,.11111,.71875],71:[.09722,.68333,.0593,.11111,.59487],72:[0,.68333,.00965,.11111,.84452],73:[0,.68333,.07382,0,.54452],74:[.09722,.68333,.18472,.16667,.67778],75:[0,.68333,.01445,.05556,.76195],76:[0,.68333,0,.13889,.68972],77:[0,.68333,0,.13889,1.2009],78:[0,.68333,.14736,.08334,.82049],79:[0,.68333,.02778,.11111,.79611],80:[0,.68333,.08222,.08334,.69556],81:[.09722,.68333,0,.11111,.81667],82:[0,.68333,0,.08334,.8475],83:[0,.68333,.075,.13889,.60556],84:[0,.68333,.25417,0,.54464],85:[0,.68333,.09931,.08334,.62583],86:[0,.68333,.08222,0,.61278],87:[0,.68333,.08222,.08334,.98778],88:[0,.68333,.14643,.13889,.7133],89:[.09722,.68333,.08222,.08334,.66834],90:[0,.68333,.07944,.13889,.72473],160:[0,0,0,0,.25]},"Fraktur-Regular":{32:[0,0,0,0,.25],33:[0,.69141,0,0,.29574],34:[0,.69141,0,0,.21471],38:[0,.69141,0,0,.73786],39:[0,.69141,0,0,.21201],40:[.24982,.74947,0,0,.38865],41:[.24982,.74947,0,0,.38865],42:[0,.62119,0,0,.27764],43:[.08319,.58283,0,0,.75623],44:[0,.10803,0,0,.27764],45:[.08319,.58283,0,0,.75623],46:[0,.10803,0,0,.27764],47:[.24982,.74947,0,0,.50181],48:[0,.47534,0,0,.50181],49:[0,.47534,0,0,.50181],50:[0,.47534,0,0,.50181],51:[.18906,.47534,0,0,.50181],52:[.18906,.47534,0,0,.50181],53:[.18906,.47534,0,0,.50181],54:[0,.69141,0,0,.50181],55:[.18906,.47534,0,0,.50181],56:[0,.69141,0,0,.50181],57:[.18906,.47534,0,0,.50181],58:[0,.47534,0,0,.21606],59:[.12604,.47534,0,0,.21606],61:[-.13099,.36866,0,0,.75623],63:[0,.69141,0,0,.36245],65:[0,.69141,0,0,.7176],66:[0,.69141,0,0,.88397],67:[0,.69141,0,0,.61254],68:[0,.69141,0,0,.83158],69:[0,.69141,0,0,.66278],70:[.12604,.69141,0,0,.61119],71:[0,.69141,0,0,.78539],72:[.06302,.69141,0,0,.7203],73:[0,.69141,0,0,.55448],74:[.12604,.69141,0,0,.55231],75:[0,.69141,0,0,.66845],76:[0,.69141,0,0,.66602],77:[0,.69141,0,0,1.04953],78:[0,.69141,0,0,.83212],79:[0,.69141,0,0,.82699],80:[.18906,.69141,0,0,.82753],81:[.03781,.69141,0,0,.82699],82:[0,.69141,0,0,.82807],83:[0,.69141,0,0,.82861],84:[0,.69141,0,0,.66899],85:[0,.69141,0,0,.64576],86:[0,.69141,0,0,.83131],87:[0,.69141,0,0,1.04602],88:[0,.69141,0,0,.71922],89:[.18906,.69141,0,0,.83293],90:[.12604,.69141,0,0,.60201],91:[.24982,.74947,0,0,.27764],93:[.24982,.74947,0,0,.27764],94:[0,.69141,0,0,.49965],97:[0,.47534,0,0,.50046],98:[0,.69141,0,0,.51315],99:[0,.47534,0,0,.38946],100:[0,.62119,0,0,.49857],101:[0,.47534,0,0,.40053],102:[.18906,.69141,0,0,.32626],103:[.18906,.47534,0,0,.5037],104:[.18906,.69141,0,0,.52126],105:[0,.69141,0,0,.27899],106:[0,.69141,0,0,.28088],107:[0,.69141,0,0,.38946],108:[0,.69141,0,0,.27953],109:[0,.47534,0,0,.76676],110:[0,.47534,0,0,.52666],111:[0,.47534,0,0,.48885],112:[.18906,.52396,0,0,.50046],113:[.18906,.47534,0,0,.48912],114:[0,.47534,0,0,.38919],115:[0,.47534,0,0,.44266],116:[0,.62119,0,0,.33301],117:[0,.47534,0,0,.5172],118:[0,.52396,0,0,.5118],119:[0,.52396,0,0,.77351],120:[.18906,.47534,0,0,.38865],121:[.18906,.47534,0,0,.49884],122:[.18906,.47534,0,0,.39054],160:[0,0,0,0,.25],8216:[0,.69141,0,0,.21471],8217:[0,.69141,0,0,.21471],58112:[0,.62119,0,0,.49749],58113:[0,.62119,0,0,.4983],58114:[.18906,.69141,0,0,.33328],58115:[.18906,.69141,0,0,.32923],58116:[.18906,.47534,0,0,.50343],58117:[0,.69141,0,0,.33301],58118:[0,.62119,0,0,.33409],58119:[0,.47534,0,0,.50073]},"Main-Bold":{32:[0,0,0,0,.25],33:[0,.69444,0,0,.35],34:[0,.69444,0,0,.60278],35:[.19444,.69444,0,0,.95833],36:[.05556,.75,0,0,.575],37:[.05556,.75,0,0,.95833],38:[0,.69444,0,0,.89444],39:[0,.69444,0,0,.31944],40:[.25,.75,0,0,.44722],41:[.25,.75,0,0,.44722],42:[0,.75,0,0,.575],43:[.13333,.63333,0,0,.89444],44:[.19444,.15556,0,0,.31944],45:[0,.44444,0,0,.38333],46:[0,.15556,0,0,.31944],47:[.25,.75,0,0,.575],48:[0,.64444,0,0,.575],49:[0,.64444,0,0,.575],50:[0,.64444,0,0,.575],51:[0,.64444,0,0,.575],52:[0,.64444,0,0,.575],53:[0,.64444,0,0,.575],54:[0,.64444,0,0,.575],55:[0,.64444,0,0,.575],56:[0,.64444,0,0,.575],57:[0,.64444,0,0,.575],58:[0,.44444,0,0,.31944],59:[.19444,.44444,0,0,.31944],60:[.08556,.58556,0,0,.89444],61:[-.10889,.39111,0,0,.89444],62:[.08556,.58556,0,0,.89444],63:[0,.69444,0,0,.54305],64:[0,.69444,0,0,.89444],65:[0,.68611,0,0,.86944],66:[0,.68611,0,0,.81805],67:[0,.68611,0,0,.83055],68:[0,.68611,0,0,.88194],69:[0,.68611,0,0,.75555],70:[0,.68611,0,0,.72361],71:[0,.68611,0,0,.90416],72:[0,.68611,0,0,.9],73:[0,.68611,0,0,.43611],74:[0,.68611,0,0,.59444],75:[0,.68611,0,0,.90138],76:[0,.68611,0,0,.69166],77:[0,.68611,0,0,1.09166],78:[0,.68611,0,0,.9],79:[0,.68611,0,0,.86388],80:[0,.68611,0,0,.78611],81:[.19444,.68611,0,0,.86388],82:[0,.68611,0,0,.8625],83:[0,.68611,0,0,.63889],84:[0,.68611,0,0,.8],85:[0,.68611,0,0,.88472],86:[0,.68611,.01597,0,.86944],87:[0,.68611,.01597,0,1.18888],88:[0,.68611,0,0,.86944],89:[0,.68611,.02875,0,.86944],90:[0,.68611,0,0,.70277],91:[.25,.75,0,0,.31944],92:[.25,.75,0,0,.575],93:[.25,.75,0,0,.31944],94:[0,.69444,0,0,.575],95:[.31,.13444,.03194,0,.575],97:[0,.44444,0,0,.55902],98:[0,.69444,0,0,.63889],99:[0,.44444,0,0,.51111],100:[0,.69444,0,0,.63889],101:[0,.44444,0,0,.52708],102:[0,.69444,.10903,0,.35139],103:[.19444,.44444,.01597,0,.575],104:[0,.69444,0,0,.63889],105:[0,.69444,0,0,.31944],106:[.19444,.69444,0,0,.35139],107:[0,.69444,0,0,.60694],108:[0,.69444,0,0,.31944],109:[0,.44444,0,0,.95833],110:[0,.44444,0,0,.63889],111:[0,.44444,0,0,.575],112:[.19444,.44444,0,0,.63889],113:[.19444,.44444,0,0,.60694],114:[0,.44444,0,0,.47361],115:[0,.44444,0,0,.45361],116:[0,.63492,0,0,.44722],117:[0,.44444,0,0,.63889],118:[0,.44444,.01597,0,.60694],119:[0,.44444,.01597,0,.83055],120:[0,.44444,0,0,.60694],121:[.19444,.44444,.01597,0,.60694],122:[0,.44444,0,0,.51111],123:[.25,.75,0,0,.575],124:[.25,.75,0,0,.31944],125:[.25,.75,0,0,.575],126:[.35,.34444,0,0,.575],160:[0,0,0,0,.25],163:[0,.69444,0,0,.86853],168:[0,.69444,0,0,.575],172:[0,.44444,0,0,.76666],176:[0,.69444,0,0,.86944],177:[.13333,.63333,0,0,.89444],184:[.17014,0,0,0,.51111],198:[0,.68611,0,0,1.04166],215:[.13333,.63333,0,0,.89444],216:[.04861,.73472,0,0,.89444],223:[0,.69444,0,0,.59722],230:[0,.44444,0,0,.83055],247:[.13333,.63333,0,0,.89444],248:[.09722,.54167,0,0,.575],305:[0,.44444,0,0,.31944],338:[0,.68611,0,0,1.16944],339:[0,.44444,0,0,.89444],567:[.19444,.44444,0,0,.35139],710:[0,.69444,0,0,.575],711:[0,.63194,0,0,.575],713:[0,.59611,0,0,.575],714:[0,.69444,0,0,.575],715:[0,.69444,0,0,.575],728:[0,.69444,0,0,.575],729:[0,.69444,0,0,.31944],730:[0,.69444,0,0,.86944],732:[0,.69444,0,0,.575],733:[0,.69444,0,0,.575],915:[0,.68611,0,0,.69166],916:[0,.68611,0,0,.95833],920:[0,.68611,0,0,.89444],923:[0,.68611,0,0,.80555],926:[0,.68611,0,0,.76666],928:[0,.68611,0,0,.9],931:[0,.68611,0,0,.83055],933:[0,.68611,0,0,.89444],934:[0,.68611,0,0,.83055],936:[0,.68611,0,0,.89444],937:[0,.68611,0,0,.83055],8211:[0,.44444,.03194,0,.575],8212:[0,.44444,.03194,0,1.14999],8216:[0,.69444,0,0,.31944],8217:[0,.69444,0,0,.31944],8220:[0,.69444,0,0,.60278],8221:[0,.69444,0,0,.60278],8224:[.19444,.69444,0,0,.51111],8225:[.19444,.69444,0,0,.51111],8242:[0,.55556,0,0,.34444],8407:[0,.72444,.15486,0,.575],8463:[0,.69444,0,0,.66759],8465:[0,.69444,0,0,.83055],8467:[0,.69444,0,0,.47361],8472:[.19444,.44444,0,0,.74027],8476:[0,.69444,0,0,.83055],8501:[0,.69444,0,0,.70277],8592:[-.10889,.39111,0,0,1.14999],8593:[.19444,.69444,0,0,.575],8594:[-.10889,.39111,0,0,1.14999],8595:[.19444,.69444,0,0,.575],8596:[-.10889,.39111,0,0,1.14999],8597:[.25,.75,0,0,.575],8598:[.19444,.69444,0,0,1.14999],8599:[.19444,.69444,0,0,1.14999],8600:[.19444,.69444,0,0,1.14999],8601:[.19444,.69444,0,0,1.14999],8636:[-.10889,.39111,0,0,1.14999],8637:[-.10889,.39111,0,0,1.14999],8640:[-.10889,.39111,0,0,1.14999],8641:[-.10889,.39111,0,0,1.14999],8656:[-.10889,.39111,0,0,1.14999],8657:[.19444,.69444,0,0,.70277],8658:[-.10889,.39111,0,0,1.14999],8659:[.19444,.69444,0,0,.70277],8660:[-.10889,.39111,0,0,1.14999],8661:[.25,.75,0,0,.70277],8704:[0,.69444,0,0,.63889],8706:[0,.69444,.06389,0,.62847],8707:[0,.69444,0,0,.63889],8709:[.05556,.75,0,0,.575],8711:[0,.68611,0,0,.95833],8712:[.08556,.58556,0,0,.76666],8715:[.08556,.58556,0,0,.76666],8722:[.13333,.63333,0,0,.89444],8723:[.13333,.63333,0,0,.89444],8725:[.25,.75,0,0,.575],8726:[.25,.75,0,0,.575],8727:[-.02778,.47222,0,0,.575],8728:[-.02639,.47361,0,0,.575],8729:[-.02639,.47361,0,0,.575],8730:[.18,.82,0,0,.95833],8733:[0,.44444,0,0,.89444],8734:[0,.44444,0,0,1.14999],8736:[0,.69224,0,0,.72222],8739:[.25,.75,0,0,.31944],8741:[.25,.75,0,0,.575],8743:[0,.55556,0,0,.76666],8744:[0,.55556,0,0,.76666],8745:[0,.55556,0,0,.76666],8746:[0,.55556,0,0,.76666],8747:[.19444,.69444,.12778,0,.56875],8764:[-.10889,.39111,0,0,.89444],8768:[.19444,.69444,0,0,.31944],8771:[.00222,.50222,0,0,.89444],8773:[.027,.638,0,0,.894],8776:[.02444,.52444,0,0,.89444],8781:[.00222,.50222,0,0,.89444],8801:[.00222,.50222,0,0,.89444],8804:[.19667,.69667,0,0,.89444],8805:[.19667,.69667,0,0,.89444],8810:[.08556,.58556,0,0,1.14999],8811:[.08556,.58556,0,0,1.14999],8826:[.08556,.58556,0,0,.89444],8827:[.08556,.58556,0,0,.89444],8834:[.08556,.58556,0,0,.89444],8835:[.08556,.58556,0,0,.89444],8838:[.19667,.69667,0,0,.89444],8839:[.19667,.69667,0,0,.89444],8846:[0,.55556,0,0,.76666],8849:[.19667,.69667,0,0,.89444],8850:[.19667,.69667,0,0,.89444],8851:[0,.55556,0,0,.76666],8852:[0,.55556,0,0,.76666],8853:[.13333,.63333,0,0,.89444],8854:[.13333,.63333,0,0,.89444],8855:[.13333,.63333,0,0,.89444],8856:[.13333,.63333,0,0,.89444],8857:[.13333,.63333,0,0,.89444],8866:[0,.69444,0,0,.70277],8867:[0,.69444,0,0,.70277],8868:[0,.69444,0,0,.89444],8869:[0,.69444,0,0,.89444],8900:[-.02639,.47361,0,0,.575],8901:[-.02639,.47361,0,0,.31944],8902:[-.02778,.47222,0,0,.575],8968:[.25,.75,0,0,.51111],8969:[.25,.75,0,0,.51111],8970:[.25,.75,0,0,.51111],8971:[.25,.75,0,0,.51111],8994:[-.13889,.36111,0,0,1.14999],8995:[-.13889,.36111,0,0,1.14999],9651:[.19444,.69444,0,0,1.02222],9657:[-.02778,.47222,0,0,.575],9661:[.19444,.69444,0,0,1.02222],9667:[-.02778,.47222,0,0,.575],9711:[.19444,.69444,0,0,1.14999],9824:[.12963,.69444,0,0,.89444],9825:[.12963,.69444,0,0,.89444],9826:[.12963,.69444,0,0,.89444],9827:[.12963,.69444,0,0,.89444],9837:[0,.75,0,0,.44722],9838:[.19444,.69444,0,0,.44722],9839:[.19444,.69444,0,0,.44722],10216:[.25,.75,0,0,.44722],10217:[.25,.75,0,0,.44722],10815:[0,.68611,0,0,.9],10927:[.19667,.69667,0,0,.89444],10928:[.19667,.69667,0,0,.89444],57376:[.19444,.69444,0,0,0]},"Main-BoldItalic":{32:[0,0,0,0,.25],33:[0,.69444,.11417,0,.38611],34:[0,.69444,.07939,0,.62055],35:[.19444,.69444,.06833,0,.94444],37:[.05556,.75,.12861,0,.94444],38:[0,.69444,.08528,0,.88555],39:[0,.69444,.12945,0,.35555],40:[.25,.75,.15806,0,.47333],41:[.25,.75,.03306,0,.47333],42:[0,.75,.14333,0,.59111],43:[.10333,.60333,.03306,0,.88555],44:[.19444,.14722,0,0,.35555],45:[0,.44444,.02611,0,.41444],46:[0,.14722,0,0,.35555],47:[.25,.75,.15806,0,.59111],48:[0,.64444,.13167,0,.59111],49:[0,.64444,.13167,0,.59111],50:[0,.64444,.13167,0,.59111],51:[0,.64444,.13167,0,.59111],52:[.19444,.64444,.13167,0,.59111],53:[0,.64444,.13167,0,.59111],54:[0,.64444,.13167,0,.59111],55:[.19444,.64444,.13167,0,.59111],56:[0,.64444,.13167,0,.59111],57:[0,.64444,.13167,0,.59111],58:[0,.44444,.06695,0,.35555],59:[.19444,.44444,.06695,0,.35555],61:[-.10889,.39111,.06833,0,.88555],63:[0,.69444,.11472,0,.59111],64:[0,.69444,.09208,0,.88555],65:[0,.68611,0,0,.86555],66:[0,.68611,.0992,0,.81666],67:[0,.68611,.14208,0,.82666],68:[0,.68611,.09062,0,.87555],69:[0,.68611,.11431,0,.75666],70:[0,.68611,.12903,0,.72722],71:[0,.68611,.07347,0,.89527],72:[0,.68611,.17208,0,.8961],73:[0,.68611,.15681,0,.47166],74:[0,.68611,.145,0,.61055],75:[0,.68611,.14208,0,.89499],76:[0,.68611,0,0,.69777],77:[0,.68611,.17208,0,1.07277],78:[0,.68611,.17208,0,.8961],79:[0,.68611,.09062,0,.85499],80:[0,.68611,.0992,0,.78721],81:[.19444,.68611,.09062,0,.85499],82:[0,.68611,.02559,0,.85944],83:[0,.68611,.11264,0,.64999],84:[0,.68611,.12903,0,.7961],85:[0,.68611,.17208,0,.88083],86:[0,.68611,.18625,0,.86555],87:[0,.68611,.18625,0,1.15999],88:[0,.68611,.15681,0,.86555],89:[0,.68611,.19803,0,.86555],90:[0,.68611,.14208,0,.70888],91:[.25,.75,.1875,0,.35611],93:[.25,.75,.09972,0,.35611],94:[0,.69444,.06709,0,.59111],95:[.31,.13444,.09811,0,.59111],97:[0,.44444,.09426,0,.59111],98:[0,.69444,.07861,0,.53222],99:[0,.44444,.05222,0,.53222],100:[0,.69444,.10861,0,.59111],101:[0,.44444,.085,0,.53222],102:[.19444,.69444,.21778,0,.4],103:[.19444,.44444,.105,0,.53222],104:[0,.69444,.09426,0,.59111],105:[0,.69326,.11387,0,.35555],106:[.19444,.69326,.1672,0,.35555],107:[0,.69444,.11111,0,.53222],108:[0,.69444,.10861,0,.29666],109:[0,.44444,.09426,0,.94444],110:[0,.44444,.09426,0,.64999],111:[0,.44444,.07861,0,.59111],112:[.19444,.44444,.07861,0,.59111],113:[.19444,.44444,.105,0,.53222],114:[0,.44444,.11111,0,.50167],115:[0,.44444,.08167,0,.48694],116:[0,.63492,.09639,0,.385],117:[0,.44444,.09426,0,.62055],118:[0,.44444,.11111,0,.53222],119:[0,.44444,.11111,0,.76777],120:[0,.44444,.12583,0,.56055],121:[.19444,.44444,.105,0,.56166],122:[0,.44444,.13889,0,.49055],126:[.35,.34444,.11472,0,.59111],160:[0,0,0,0,.25],168:[0,.69444,.11473,0,.59111],176:[0,.69444,0,0,.94888],184:[.17014,0,0,0,.53222],198:[0,.68611,.11431,0,1.02277],216:[.04861,.73472,.09062,0,.88555],223:[.19444,.69444,.09736,0,.665],230:[0,.44444,.085,0,.82666],248:[.09722,.54167,.09458,0,.59111],305:[0,.44444,.09426,0,.35555],338:[0,.68611,.11431,0,1.14054],339:[0,.44444,.085,0,.82666],567:[.19444,.44444,.04611,0,.385],710:[0,.69444,.06709,0,.59111],711:[0,.63194,.08271,0,.59111],713:[0,.59444,.10444,0,.59111],714:[0,.69444,.08528,0,.59111],715:[0,.69444,0,0,.59111],728:[0,.69444,.10333,0,.59111],729:[0,.69444,.12945,0,.35555],730:[0,.69444,0,0,.94888],732:[0,.69444,.11472,0,.59111],733:[0,.69444,.11472,0,.59111],915:[0,.68611,.12903,0,.69777],916:[0,.68611,0,0,.94444],920:[0,.68611,.09062,0,.88555],923:[0,.68611,0,0,.80666],926:[0,.68611,.15092,0,.76777],928:[0,.68611,.17208,0,.8961],931:[0,.68611,.11431,0,.82666],933:[0,.68611,.10778,0,.88555],934:[0,.68611,.05632,0,.82666],936:[0,.68611,.10778,0,.88555],937:[0,.68611,.0992,0,.82666],8211:[0,.44444,.09811,0,.59111],8212:[0,.44444,.09811,0,1.18221],8216:[0,.69444,.12945,0,.35555],8217:[0,.69444,.12945,0,.35555],8220:[0,.69444,.16772,0,.62055],8221:[0,.69444,.07939,0,.62055]},"Main-Italic":{32:[0,0,0,0,.25],33:[0,.69444,.12417,0,.30667],34:[0,.69444,.06961,0,.51444],35:[.19444,.69444,.06616,0,.81777],37:[.05556,.75,.13639,0,.81777],38:[0,.69444,.09694,0,.76666],39:[0,.69444,.12417,0,.30667],40:[.25,.75,.16194,0,.40889],41:[.25,.75,.03694,0,.40889],42:[0,.75,.14917,0,.51111],43:[.05667,.56167,.03694,0,.76666],44:[.19444,.10556,0,0,.30667],45:[0,.43056,.02826,0,.35778],46:[0,.10556,0,0,.30667],47:[.25,.75,.16194,0,.51111],48:[0,.64444,.13556,0,.51111],49:[0,.64444,.13556,0,.51111],50:[0,.64444,.13556,0,.51111],51:[0,.64444,.13556,0,.51111],52:[.19444,.64444,.13556,0,.51111],53:[0,.64444,.13556,0,.51111],54:[0,.64444,.13556,0,.51111],55:[.19444,.64444,.13556,0,.51111],56:[0,.64444,.13556,0,.51111],57:[0,.64444,.13556,0,.51111],58:[0,.43056,.0582,0,.30667],59:[.19444,.43056,.0582,0,.30667],61:[-.13313,.36687,.06616,0,.76666],63:[0,.69444,.1225,0,.51111],64:[0,.69444,.09597,0,.76666],65:[0,.68333,0,0,.74333],66:[0,.68333,.10257,0,.70389],67:[0,.68333,.14528,0,.71555],68:[0,.68333,.09403,0,.755],69:[0,.68333,.12028,0,.67833],70:[0,.68333,.13305,0,.65277],71:[0,.68333,.08722,0,.77361],72:[0,.68333,.16389,0,.74333],73:[0,.68333,.15806,0,.38555],74:[0,.68333,.14028,0,.525],75:[0,.68333,.14528,0,.76888],76:[0,.68333,0,0,.62722],77:[0,.68333,.16389,0,.89666],78:[0,.68333,.16389,0,.74333],79:[0,.68333,.09403,0,.76666],80:[0,.68333,.10257,0,.67833],81:[.19444,.68333,.09403,0,.76666],82:[0,.68333,.03868,0,.72944],83:[0,.68333,.11972,0,.56222],84:[0,.68333,.13305,0,.71555],85:[0,.68333,.16389,0,.74333],86:[0,.68333,.18361,0,.74333],87:[0,.68333,.18361,0,.99888],88:[0,.68333,.15806,0,.74333],89:[0,.68333,.19383,0,.74333],90:[0,.68333,.14528,0,.61333],91:[.25,.75,.1875,0,.30667],93:[.25,.75,.10528,0,.30667],94:[0,.69444,.06646,0,.51111],95:[.31,.12056,.09208,0,.51111],97:[0,.43056,.07671,0,.51111],98:[0,.69444,.06312,0,.46],99:[0,.43056,.05653,0,.46],100:[0,.69444,.10333,0,.51111],101:[0,.43056,.07514,0,.46],102:[.19444,.69444,.21194,0,.30667],103:[.19444,.43056,.08847,0,.46],104:[0,.69444,.07671,0,.51111],105:[0,.65536,.1019,0,.30667],106:[.19444,.65536,.14467,0,.30667],107:[0,.69444,.10764,0,.46],108:[0,.69444,.10333,0,.25555],109:[0,.43056,.07671,0,.81777],110:[0,.43056,.07671,0,.56222],111:[0,.43056,.06312,0,.51111],112:[.19444,.43056,.06312,0,.51111],113:[.19444,.43056,.08847,0,.46],114:[0,.43056,.10764,0,.42166],115:[0,.43056,.08208,0,.40889],116:[0,.61508,.09486,0,.33222],117:[0,.43056,.07671,0,.53666],118:[0,.43056,.10764,0,.46],119:[0,.43056,.10764,0,.66444],120:[0,.43056,.12042,0,.46389],121:[.19444,.43056,.08847,0,.48555],122:[0,.43056,.12292,0,.40889],126:[.35,.31786,.11585,0,.51111],160:[0,0,0,0,.25],168:[0,.66786,.10474,0,.51111],176:[0,.69444,0,0,.83129],184:[.17014,0,0,0,.46],198:[0,.68333,.12028,0,.88277],216:[.04861,.73194,.09403,0,.76666],223:[.19444,.69444,.10514,0,.53666],230:[0,.43056,.07514,0,.71555],248:[.09722,.52778,.09194,0,.51111],338:[0,.68333,.12028,0,.98499],339:[0,.43056,.07514,0,.71555],710:[0,.69444,.06646,0,.51111],711:[0,.62847,.08295,0,.51111],713:[0,.56167,.10333,0,.51111],714:[0,.69444,.09694,0,.51111],715:[0,.69444,0,0,.51111],728:[0,.69444,.10806,0,.51111],729:[0,.66786,.11752,0,.30667],730:[0,.69444,0,0,.83129],732:[0,.66786,.11585,0,.51111],733:[0,.69444,.1225,0,.51111],915:[0,.68333,.13305,0,.62722],916:[0,.68333,0,0,.81777],920:[0,.68333,.09403,0,.76666],923:[0,.68333,0,0,.69222],926:[0,.68333,.15294,0,.66444],928:[0,.68333,.16389,0,.74333],931:[0,.68333,.12028,0,.71555],933:[0,.68333,.11111,0,.76666],934:[0,.68333,.05986,0,.71555],936:[0,.68333,.11111,0,.76666],937:[0,.68333,.10257,0,.71555],8211:[0,.43056,.09208,0,.51111],8212:[0,.43056,.09208,0,1.02222],8216:[0,.69444,.12417,0,.30667],8217:[0,.69444,.12417,0,.30667],8220:[0,.69444,.1685,0,.51444],8221:[0,.69444,.06961,0,.51444],8463:[0,.68889,0,0,.54028]},"Main-Regular":{32:[0,0,0,0,.25],33:[0,.69444,0,0,.27778],34:[0,.69444,0,0,.5],35:[.19444,.69444,0,0,.83334],36:[.05556,.75,0,0,.5],37:[.05556,.75,0,0,.83334],38:[0,.69444,0,0,.77778],39:[0,.69444,0,0,.27778],40:[.25,.75,0,0,.38889],41:[.25,.75,0,0,.38889],42:[0,.75,0,0,.5],43:[.08333,.58333,0,0,.77778],44:[.19444,.10556,0,0,.27778],45:[0,.43056,0,0,.33333],46:[0,.10556,0,0,.27778],47:[.25,.75,0,0,.5],48:[0,.64444,0,0,.5],49:[0,.64444,0,0,.5],50:[0,.64444,0,0,.5],51:[0,.64444,0,0,.5],52:[0,.64444,0,0,.5],53:[0,.64444,0,0,.5],54:[0,.64444,0,0,.5],55:[0,.64444,0,0,.5],56:[0,.64444,0,0,.5],57:[0,.64444,0,0,.5],58:[0,.43056,0,0,.27778],59:[.19444,.43056,0,0,.27778],60:[.0391,.5391,0,0,.77778],61:[-.13313,.36687,0,0,.77778],62:[.0391,.5391,0,0,.77778],63:[0,.69444,0,0,.47222],64:[0,.69444,0,0,.77778],65:[0,.68333,0,0,.75],66:[0,.68333,0,0,.70834],67:[0,.68333,0,0,.72222],68:[0,.68333,0,0,.76389],69:[0,.68333,0,0,.68056],70:[0,.68333,0,0,.65278],71:[0,.68333,0,0,.78472],72:[0,.68333,0,0,.75],73:[0,.68333,0,0,.36111],74:[0,.68333,0,0,.51389],75:[0,.68333,0,0,.77778],76:[0,.68333,0,0,.625],77:[0,.68333,0,0,.91667],78:[0,.68333,0,0,.75],79:[0,.68333,0,0,.77778],80:[0,.68333,0,0,.68056],81:[.19444,.68333,0,0,.77778],82:[0,.68333,0,0,.73611],83:[0,.68333,0,0,.55556],84:[0,.68333,0,0,.72222],85:[0,.68333,0,0,.75],86:[0,.68333,.01389,0,.75],87:[0,.68333,.01389,0,1.02778],88:[0,.68333,0,0,.75],89:[0,.68333,.025,0,.75],90:[0,.68333,0,0,.61111],91:[.25,.75,0,0,.27778],92:[.25,.75,0,0,.5],93:[.25,.75,0,0,.27778],94:[0,.69444,0,0,.5],95:[.31,.12056,.02778,0,.5],97:[0,.43056,0,0,.5],98:[0,.69444,0,0,.55556],99:[0,.43056,0,0,.44445],100:[0,.69444,0,0,.55556],101:[0,.43056,0,0,.44445],102:[0,.69444,.07778,0,.30556],103:[.19444,.43056,.01389,0,.5],104:[0,.69444,0,0,.55556],105:[0,.66786,0,0,.27778],106:[.19444,.66786,0,0,.30556],107:[0,.69444,0,0,.52778],108:[0,.69444,0,0,.27778],109:[0,.43056,0,0,.83334],110:[0,.43056,0,0,.55556],111:[0,.43056,0,0,.5],112:[.19444,.43056,0,0,.55556],113:[.19444,.43056,0,0,.52778],114:[0,.43056,0,0,.39167],115:[0,.43056,0,0,.39445],116:[0,.61508,0,0,.38889],117:[0,.43056,0,0,.55556],118:[0,.43056,.01389,0,.52778],119:[0,.43056,.01389,0,.72222],120:[0,.43056,0,0,.52778],121:[.19444,.43056,.01389,0,.52778],122:[0,.43056,0,0,.44445],123:[.25,.75,0,0,.5],124:[.25,.75,0,0,.27778],125:[.25,.75,0,0,.5],126:[.35,.31786,0,0,.5],160:[0,0,0,0,.25],163:[0,.69444,0,0,.76909],167:[.19444,.69444,0,0,.44445],168:[0,.66786,0,0,.5],172:[0,.43056,0,0,.66667],176:[0,.69444,0,0,.75],177:[.08333,.58333,0,0,.77778],182:[.19444,.69444,0,0,.61111],184:[.17014,0,0,0,.44445],198:[0,.68333,0,0,.90278],215:[.08333,.58333,0,0,.77778],216:[.04861,.73194,0,0,.77778],223:[0,.69444,0,0,.5],230:[0,.43056,0,0,.72222],247:[.08333,.58333,0,0,.77778],248:[.09722,.52778,0,0,.5],305:[0,.43056,0,0,.27778],338:[0,.68333,0,0,1.01389],339:[0,.43056,0,0,.77778],567:[.19444,.43056,0,0,.30556],710:[0,.69444,0,0,.5],711:[0,.62847,0,0,.5],713:[0,.56778,0,0,.5],714:[0,.69444,0,0,.5],715:[0,.69444,0,0,.5],728:[0,.69444,0,0,.5],729:[0,.66786,0,0,.27778],730:[0,.69444,0,0,.75],732:[0,.66786,0,0,.5],733:[0,.69444,0,0,.5],915:[0,.68333,0,0,.625],916:[0,.68333,0,0,.83334],920:[0,.68333,0,0,.77778],923:[0,.68333,0,0,.69445],926:[0,.68333,0,0,.66667],928:[0,.68333,0,0,.75],931:[0,.68333,0,0,.72222],933:[0,.68333,0,0,.77778],934:[0,.68333,0,0,.72222],936:[0,.68333,0,0,.77778],937:[0,.68333,0,0,.72222],8211:[0,.43056,.02778,0,.5],8212:[0,.43056,.02778,0,1],8216:[0,.69444,0,0,.27778],8217:[0,.69444,0,0,.27778],8220:[0,.69444,0,0,.5],8221:[0,.69444,0,0,.5],8224:[.19444,.69444,0,0,.44445],8225:[.19444,.69444,0,0,.44445],8230:[0,.123,0,0,1.172],8242:[0,.55556,0,0,.275],8407:[0,.71444,.15382,0,.5],8463:[0,.68889,0,0,.54028],8465:[0,.69444,0,0,.72222],8467:[0,.69444,0,.11111,.41667],8472:[.19444,.43056,0,.11111,.63646],8476:[0,.69444,0,0,.72222],8501:[0,.69444,0,0,.61111],8592:[-.13313,.36687,0,0,1],8593:[.19444,.69444,0,0,.5],8594:[-.13313,.36687,0,0,1],8595:[.19444,.69444,0,0,.5],8596:[-.13313,.36687,0,0,1],8597:[.25,.75,0,0,.5],8598:[.19444,.69444,0,0,1],8599:[.19444,.69444,0,0,1],8600:[.19444,.69444,0,0,1],8601:[.19444,.69444,0,0,1],8614:[.011,.511,0,0,1],8617:[.011,.511,0,0,1.126],8618:[.011,.511,0,0,1.126],8636:[-.13313,.36687,0,0,1],8637:[-.13313,.36687,0,0,1],8640:[-.13313,.36687,0,0,1],8641:[-.13313,.36687,0,0,1],8652:[.011,.671,0,0,1],8656:[-.13313,.36687,0,0,1],8657:[.19444,.69444,0,0,.61111],8658:[-.13313,.36687,0,0,1],8659:[.19444,.69444,0,0,.61111],8660:[-.13313,.36687,0,0,1],8661:[.25,.75,0,0,.61111],8704:[0,.69444,0,0,.55556],8706:[0,.69444,.05556,.08334,.5309],8707:[0,.69444,0,0,.55556],8709:[.05556,.75,0,0,.5],8711:[0,.68333,0,0,.83334],8712:[.0391,.5391,0,0,.66667],8715:[.0391,.5391,0,0,.66667],8722:[.08333,.58333,0,0,.77778],8723:[.08333,.58333,0,0,.77778],8725:[.25,.75,0,0,.5],8726:[.25,.75,0,0,.5],8727:[-.03472,.46528,0,0,.5],8728:[-.05555,.44445,0,0,.5],8729:[-.05555,.44445,0,0,.5],8730:[.2,.8,0,0,.83334],8733:[0,.43056,0,0,.77778],8734:[0,.43056,0,0,1],8736:[0,.69224,0,0,.72222],8739:[.25,.75,0,0,.27778],8741:[.25,.75,0,0,.5],8743:[0,.55556,0,0,.66667],8744:[0,.55556,0,0,.66667],8745:[0,.55556,0,0,.66667],8746:[0,.55556,0,0,.66667],8747:[.19444,.69444,.11111,0,.41667],8764:[-.13313,.36687,0,0,.77778],8768:[.19444,.69444,0,0,.27778],8771:[-.03625,.46375,0,0,.77778],8773:[-.022,.589,0,0,.778],8776:[-.01688,.48312,0,0,.77778],8781:[-.03625,.46375,0,0,.77778],8784:[-.133,.673,0,0,.778],8801:[-.03625,.46375,0,0,.77778],8804:[.13597,.63597,0,0,.77778],8805:[.13597,.63597,0,0,.77778],8810:[.0391,.5391,0,0,1],8811:[.0391,.5391,0,0,1],8826:[.0391,.5391,0,0,.77778],8827:[.0391,.5391,0,0,.77778],8834:[.0391,.5391,0,0,.77778],8835:[.0391,.5391,0,0,.77778],8838:[.13597,.63597,0,0,.77778],8839:[.13597,.63597,0,0,.77778],8846:[0,.55556,0,0,.66667],8849:[.13597,.63597,0,0,.77778],8850:[.13597,.63597,0,0,.77778],8851:[0,.55556,0,0,.66667],8852:[0,.55556,0,0,.66667],8853:[.08333,.58333,0,0,.77778],8854:[.08333,.58333,0,0,.77778],8855:[.08333,.58333,0,0,.77778],8856:[.08333,.58333,0,0,.77778],8857:[.08333,.58333,0,0,.77778],8866:[0,.69444,0,0,.61111],8867:[0,.69444,0,0,.61111],8868:[0,.69444,0,0,.77778],8869:[0,.69444,0,0,.77778],8872:[.249,.75,0,0,.867],8900:[-.05555,.44445,0,0,.5],8901:[-.05555,.44445,0,0,.27778],8902:[-.03472,.46528,0,0,.5],8904:[.005,.505,0,0,.9],8942:[.03,.903,0,0,.278],8943:[-.19,.313,0,0,1.172],8945:[-.1,.823,0,0,1.282],8968:[.25,.75,0,0,.44445],8969:[.25,.75,0,0,.44445],8970:[.25,.75,0,0,.44445],8971:[.25,.75,0,0,.44445],8994:[-.14236,.35764,0,0,1],8995:[-.14236,.35764,0,0,1],9136:[.244,.744,0,0,.412],9137:[.244,.745,0,0,.412],9651:[.19444,.69444,0,0,.88889],9657:[-.03472,.46528,0,0,.5],9661:[.19444,.69444,0,0,.88889],9667:[-.03472,.46528,0,0,.5],9711:[.19444,.69444,0,0,1],9824:[.12963,.69444,0,0,.77778],9825:[.12963,.69444,0,0,.77778],9826:[.12963,.69444,0,0,.77778],9827:[.12963,.69444,0,0,.77778],9837:[0,.75,0,0,.38889],9838:[.19444,.69444,0,0,.38889],9839:[.19444,.69444,0,0,.38889],10216:[.25,.75,0,0,.38889],10217:[.25,.75,0,0,.38889],10222:[.244,.744,0,0,.412],10223:[.244,.745,0,0,.412],10229:[.011,.511,0,0,1.609],10230:[.011,.511,0,0,1.638],10231:[.011,.511,0,0,1.859],10232:[.024,.525,0,0,1.609],10233:[.024,.525,0,0,1.638],10234:[.024,.525,0,0,1.858],10236:[.011,.511,0,0,1.638],10815:[0,.68333,0,0,.75],10927:[.13597,.63597,0,0,.77778],10928:[.13597,.63597,0,0,.77778],57376:[.19444,.69444,0,0,0]},"Math-BoldItalic":{32:[0,0,0,0,.25],48:[0,.44444,0,0,.575],49:[0,.44444,0,0,.575],50:[0,.44444,0,0,.575],51:[.19444,.44444,0,0,.575],52:[.19444,.44444,0,0,.575],53:[.19444,.44444,0,0,.575],54:[0,.64444,0,0,.575],55:[.19444,.44444,0,0,.575],56:[0,.64444,0,0,.575],57:[.19444,.44444,0,0,.575],65:[0,.68611,0,0,.86944],66:[0,.68611,.04835,0,.8664],67:[0,.68611,.06979,0,.81694],68:[0,.68611,.03194,0,.93812],69:[0,.68611,.05451,0,.81007],70:[0,.68611,.15972,0,.68889],71:[0,.68611,0,0,.88673],72:[0,.68611,.08229,0,.98229],73:[0,.68611,.07778,0,.51111],74:[0,.68611,.10069,0,.63125],75:[0,.68611,.06979,0,.97118],76:[0,.68611,0,0,.75555],77:[0,.68611,.11424,0,1.14201],78:[0,.68611,.11424,0,.95034],79:[0,.68611,.03194,0,.83666],80:[0,.68611,.15972,0,.72309],81:[.19444,.68611,0,0,.86861],82:[0,.68611,.00421,0,.87235],83:[0,.68611,.05382,0,.69271],84:[0,.68611,.15972,0,.63663],85:[0,.68611,.11424,0,.80027],86:[0,.68611,.25555,0,.67778],87:[0,.68611,.15972,0,1.09305],88:[0,.68611,.07778,0,.94722],89:[0,.68611,.25555,0,.67458],90:[0,.68611,.06979,0,.77257],97:[0,.44444,0,0,.63287],98:[0,.69444,0,0,.52083],99:[0,.44444,0,0,.51342],100:[0,.69444,0,0,.60972],101:[0,.44444,0,0,.55361],102:[.19444,.69444,.11042,0,.56806],103:[.19444,.44444,.03704,0,.5449],104:[0,.69444,0,0,.66759],105:[0,.69326,0,0,.4048],106:[.19444,.69326,.0622,0,.47083],107:[0,.69444,.01852,0,.6037],108:[0,.69444,.0088,0,.34815],109:[0,.44444,0,0,1.0324],110:[0,.44444,0,0,.71296],111:[0,.44444,0,0,.58472],112:[.19444,.44444,0,0,.60092],113:[.19444,.44444,.03704,0,.54213],114:[0,.44444,.03194,0,.5287],115:[0,.44444,0,0,.53125],116:[0,.63492,0,0,.41528],117:[0,.44444,0,0,.68102],118:[0,.44444,.03704,0,.56666],119:[0,.44444,.02778,0,.83148],120:[0,.44444,0,0,.65903],121:[.19444,.44444,.03704,0,.59028],122:[0,.44444,.04213,0,.55509],160:[0,0,0,0,.25],915:[0,.68611,.15972,0,.65694],916:[0,.68611,0,0,.95833],920:[0,.68611,.03194,0,.86722],923:[0,.68611,0,0,.80555],926:[0,.68611,.07458,0,.84125],928:[0,.68611,.08229,0,.98229],931:[0,.68611,.05451,0,.88507],933:[0,.68611,.15972,0,.67083],934:[0,.68611,0,0,.76666],936:[0,.68611,.11653,0,.71402],937:[0,.68611,.04835,0,.8789],945:[0,.44444,0,0,.76064],946:[.19444,.69444,.03403,0,.65972],947:[.19444,.44444,.06389,0,.59003],948:[0,.69444,.03819,0,.52222],949:[0,.44444,0,0,.52882],950:[.19444,.69444,.06215,0,.50833],951:[.19444,.44444,.03704,0,.6],952:[0,.69444,.03194,0,.5618],953:[0,.44444,0,0,.41204],954:[0,.44444,0,0,.66759],955:[0,.69444,0,0,.67083],956:[.19444,.44444,0,0,.70787],957:[0,.44444,.06898,0,.57685],958:[.19444,.69444,.03021,0,.50833],959:[0,.44444,0,0,.58472],960:[0,.44444,.03704,0,.68241],961:[.19444,.44444,0,0,.6118],962:[.09722,.44444,.07917,0,.42361],963:[0,.44444,.03704,0,.68588],964:[0,.44444,.13472,0,.52083],965:[0,.44444,.03704,0,.63055],966:[.19444,.44444,0,0,.74722],967:[.19444,.44444,0,0,.71805],968:[.19444,.69444,.03704,0,.75833],969:[0,.44444,.03704,0,.71782],977:[0,.69444,0,0,.69155],981:[.19444,.69444,0,0,.7125],982:[0,.44444,.03194,0,.975],1009:[.19444,.44444,0,0,.6118],1013:[0,.44444,0,0,.48333],57649:[0,.44444,0,0,.39352],57911:[.19444,.44444,0,0,.43889]},"Math-Italic":{32:[0,0,0,0,.25],48:[0,.43056,0,0,.5],49:[0,.43056,0,0,.5],50:[0,.43056,0,0,.5],51:[.19444,.43056,0,0,.5],52:[.19444,.43056,0,0,.5],53:[.19444,.43056,0,0,.5],54:[0,.64444,0,0,.5],55:[.19444,.43056,0,0,.5],56:[0,.64444,0,0,.5],57:[.19444,.43056,0,0,.5],65:[0,.68333,0,.13889,.75],66:[0,.68333,.05017,.08334,.75851],67:[0,.68333,.07153,.08334,.71472],68:[0,.68333,.02778,.05556,.82792],69:[0,.68333,.05764,.08334,.7382],70:[0,.68333,.13889,.08334,.64306],71:[0,.68333,0,.08334,.78625],72:[0,.68333,.08125,.05556,.83125],73:[0,.68333,.07847,.11111,.43958],74:[0,.68333,.09618,.16667,.55451],75:[0,.68333,.07153,.05556,.84931],76:[0,.68333,0,.02778,.68056],77:[0,.68333,.10903,.08334,.97014],78:[0,.68333,.10903,.08334,.80347],79:[0,.68333,.02778,.08334,.76278],80:[0,.68333,.13889,.08334,.64201],81:[.19444,.68333,0,.08334,.79056],82:[0,.68333,.00773,.08334,.75929],83:[0,.68333,.05764,.08334,.6132],84:[0,.68333,.13889,.08334,.58438],85:[0,.68333,.10903,.02778,.68278],86:[0,.68333,.22222,0,.58333],87:[0,.68333,.13889,0,.94445],88:[0,.68333,.07847,.08334,.82847],89:[0,.68333,.22222,0,.58056],90:[0,.68333,.07153,.08334,.68264],97:[0,.43056,0,0,.52859],98:[0,.69444,0,0,.42917],99:[0,.43056,0,.05556,.43276],100:[0,.69444,0,.16667,.52049],101:[0,.43056,0,.05556,.46563],102:[.19444,.69444,.10764,.16667,.48959],103:[.19444,.43056,.03588,.02778,.47697],104:[0,.69444,0,0,.57616],105:[0,.65952,0,0,.34451],106:[.19444,.65952,.05724,0,.41181],107:[0,.69444,.03148,0,.5206],108:[0,.69444,.01968,.08334,.29838],109:[0,.43056,0,0,.87801],110:[0,.43056,0,0,.60023],111:[0,.43056,0,.05556,.48472],112:[.19444,.43056,0,.08334,.50313],113:[.19444,.43056,.03588,.08334,.44641],114:[0,.43056,.02778,.05556,.45116],115:[0,.43056,0,.05556,.46875],116:[0,.61508,0,.08334,.36111],117:[0,.43056,0,.02778,.57246],118:[0,.43056,.03588,.02778,.48472],119:[0,.43056,.02691,.08334,.71592],120:[0,.43056,0,.02778,.57153],121:[.19444,.43056,.03588,.05556,.49028],122:[0,.43056,.04398,.05556,.46505],160:[0,0,0,0,.25],915:[0,.68333,.13889,.08334,.61528],916:[0,.68333,0,.16667,.83334],920:[0,.68333,.02778,.08334,.76278],923:[0,.68333,0,.16667,.69445],926:[0,.68333,.07569,.08334,.74236],928:[0,.68333,.08125,.05556,.83125],931:[0,.68333,.05764,.08334,.77986],933:[0,.68333,.13889,.05556,.58333],934:[0,.68333,0,.08334,.66667],936:[0,.68333,.11,.05556,.61222],937:[0,.68333,.05017,.08334,.7724],945:[0,.43056,.0037,.02778,.6397],946:[.19444,.69444,.05278,.08334,.56563],947:[.19444,.43056,.05556,0,.51773],948:[0,.69444,.03785,.05556,.44444],949:[0,.43056,0,.08334,.46632],950:[.19444,.69444,.07378,.08334,.4375],951:[.19444,.43056,.03588,.05556,.49653],952:[0,.69444,.02778,.08334,.46944],953:[0,.43056,0,.05556,.35394],954:[0,.43056,0,0,.57616],955:[0,.69444,0,0,.58334],956:[.19444,.43056,0,.02778,.60255],957:[0,.43056,.06366,.02778,.49398],958:[.19444,.69444,.04601,.11111,.4375],959:[0,.43056,0,.05556,.48472],960:[0,.43056,.03588,0,.57003],961:[.19444,.43056,0,.08334,.51702],962:[.09722,.43056,.07986,.08334,.36285],963:[0,.43056,.03588,0,.57141],964:[0,.43056,.1132,.02778,.43715],965:[0,.43056,.03588,.02778,.54028],966:[.19444,.43056,0,.08334,.65417],967:[.19444,.43056,0,.05556,.62569],968:[.19444,.69444,.03588,.11111,.65139],969:[0,.43056,.03588,0,.62245],977:[0,.69444,0,.08334,.59144],981:[.19444,.69444,0,.08334,.59583],982:[0,.43056,.02778,0,.82813],1009:[.19444,.43056,0,.08334,.51702],1013:[0,.43056,0,.05556,.4059],57649:[0,.43056,0,.02778,.32246],57911:[.19444,.43056,0,.08334,.38403]},"SansSerif-Bold":{32:[0,0,0,0,.25],33:[0,.69444,0,0,.36667],34:[0,.69444,0,0,.55834],35:[.19444,.69444,0,0,.91667],36:[.05556,.75,0,0,.55],37:[.05556,.75,0,0,1.02912],38:[0,.69444,0,0,.83056],39:[0,.69444,0,0,.30556],40:[.25,.75,0,0,.42778],41:[.25,.75,0,0,.42778],42:[0,.75,0,0,.55],43:[.11667,.61667,0,0,.85556],44:[.10556,.13056,0,0,.30556],45:[0,.45833,0,0,.36667],46:[0,.13056,0,0,.30556],47:[.25,.75,0,0,.55],48:[0,.69444,0,0,.55],49:[0,.69444,0,0,.55],50:[0,.69444,0,0,.55],51:[0,.69444,0,0,.55],52:[0,.69444,0,0,.55],53:[0,.69444,0,0,.55],54:[0,.69444,0,0,.55],55:[0,.69444,0,0,.55],56:[0,.69444,0,0,.55],57:[0,.69444,0,0,.55],58:[0,.45833,0,0,.30556],59:[.10556,.45833,0,0,.30556],61:[-.09375,.40625,0,0,.85556],63:[0,.69444,0,0,.51945],64:[0,.69444,0,0,.73334],65:[0,.69444,0,0,.73334],66:[0,.69444,0,0,.73334],67:[0,.69444,0,0,.70278],68:[0,.69444,0,0,.79445],69:[0,.69444,0,0,.64167],70:[0,.69444,0,0,.61111],71:[0,.69444,0,0,.73334],72:[0,.69444,0,0,.79445],73:[0,.69444,0,0,.33056],74:[0,.69444,0,0,.51945],75:[0,.69444,0,0,.76389],76:[0,.69444,0,0,.58056],77:[0,.69444,0,0,.97778],78:[0,.69444,0,0,.79445],79:[0,.69444,0,0,.79445],80:[0,.69444,0,0,.70278],81:[.10556,.69444,0,0,.79445],82:[0,.69444,0,0,.70278],83:[0,.69444,0,0,.61111],84:[0,.69444,0,0,.73334],85:[0,.69444,0,0,.76389],86:[0,.69444,.01528,0,.73334],87:[0,.69444,.01528,0,1.03889],88:[0,.69444,0,0,.73334],89:[0,.69444,.0275,0,.73334],90:[0,.69444,0,0,.67223],91:[.25,.75,0,0,.34306],93:[.25,.75,0,0,.34306],94:[0,.69444,0,0,.55],95:[.35,.10833,.03056,0,.55],97:[0,.45833,0,0,.525],98:[0,.69444,0,0,.56111],99:[0,.45833,0,0,.48889],100:[0,.69444,0,0,.56111],101:[0,.45833,0,0,.51111],102:[0,.69444,.07639,0,.33611],103:[.19444,.45833,.01528,0,.55],104:[0,.69444,0,0,.56111],105:[0,.69444,0,0,.25556],106:[.19444,.69444,0,0,.28611],107:[0,.69444,0,0,.53056],108:[0,.69444,0,0,.25556],109:[0,.45833,0,0,.86667],110:[0,.45833,0,0,.56111],111:[0,.45833,0,0,.55],112:[.19444,.45833,0,0,.56111],113:[.19444,.45833,0,0,.56111],114:[0,.45833,.01528,0,.37222],115:[0,.45833,0,0,.42167],116:[0,.58929,0,0,.40417],117:[0,.45833,0,0,.56111],118:[0,.45833,.01528,0,.5],119:[0,.45833,.01528,0,.74445],120:[0,.45833,0,0,.5],121:[.19444,.45833,.01528,0,.5],122:[0,.45833,0,0,.47639],126:[.35,.34444,0,0,.55],160:[0,0,0,0,.25],168:[0,.69444,0,0,.55],176:[0,.69444,0,0,.73334],180:[0,.69444,0,0,.55],184:[.17014,0,0,0,.48889],305:[0,.45833,0,0,.25556],567:[.19444,.45833,0,0,.28611],710:[0,.69444,0,0,.55],711:[0,.63542,0,0,.55],713:[0,.63778,0,0,.55],728:[0,.69444,0,0,.55],729:[0,.69444,0,0,.30556],730:[0,.69444,0,0,.73334],732:[0,.69444,0,0,.55],733:[0,.69444,0,0,.55],915:[0,.69444,0,0,.58056],916:[0,.69444,0,0,.91667],920:[0,.69444,0,0,.85556],923:[0,.69444,0,0,.67223],926:[0,.69444,0,0,.73334],928:[0,.69444,0,0,.79445],931:[0,.69444,0,0,.79445],933:[0,.69444,0,0,.85556],934:[0,.69444,0,0,.79445],936:[0,.69444,0,0,.85556],937:[0,.69444,0,0,.79445],8211:[0,.45833,.03056,0,.55],8212:[0,.45833,.03056,0,1.10001],8216:[0,.69444,0,0,.30556],8217:[0,.69444,0,0,.30556],8220:[0,.69444,0,0,.55834],8221:[0,.69444,0,0,.55834]},"SansSerif-Italic":{32:[0,0,0,0,.25],33:[0,.69444,.05733,0,.31945],34:[0,.69444,.00316,0,.5],35:[.19444,.69444,.05087,0,.83334],36:[.05556,.75,.11156,0,.5],37:[.05556,.75,.03126,0,.83334],38:[0,.69444,.03058,0,.75834],39:[0,.69444,.07816,0,.27778],40:[.25,.75,.13164,0,.38889],41:[.25,.75,.02536,0,.38889],42:[0,.75,.11775,0,.5],43:[.08333,.58333,.02536,0,.77778],44:[.125,.08333,0,0,.27778],45:[0,.44444,.01946,0,.33333],46:[0,.08333,0,0,.27778],47:[.25,.75,.13164,0,.5],48:[0,.65556,.11156,0,.5],49:[0,.65556,.11156,0,.5],50:[0,.65556,.11156,0,.5],51:[0,.65556,.11156,0,.5],52:[0,.65556,.11156,0,.5],53:[0,.65556,.11156,0,.5],54:[0,.65556,.11156,0,.5],55:[0,.65556,.11156,0,.5],56:[0,.65556,.11156,0,.5],57:[0,.65556,.11156,0,.5],58:[0,.44444,.02502,0,.27778],59:[.125,.44444,.02502,0,.27778],61:[-.13,.37,.05087,0,.77778],63:[0,.69444,.11809,0,.47222],64:[0,.69444,.07555,0,.66667],65:[0,.69444,0,0,.66667],66:[0,.69444,.08293,0,.66667],67:[0,.69444,.11983,0,.63889],68:[0,.69444,.07555,0,.72223],69:[0,.69444,.11983,0,.59722],70:[0,.69444,.13372,0,.56945],71:[0,.69444,.11983,0,.66667],72:[0,.69444,.08094,0,.70834],73:[0,.69444,.13372,0,.27778],74:[0,.69444,.08094,0,.47222],75:[0,.69444,.11983,0,.69445],76:[0,.69444,0,0,.54167],77:[0,.69444,.08094,0,.875],78:[0,.69444,.08094,0,.70834],79:[0,.69444,.07555,0,.73611],80:[0,.69444,.08293,0,.63889],81:[.125,.69444,.07555,0,.73611],82:[0,.69444,.08293,0,.64584],83:[0,.69444,.09205,0,.55556],84:[0,.69444,.13372,0,.68056],85:[0,.69444,.08094,0,.6875],86:[0,.69444,.1615,0,.66667],87:[0,.69444,.1615,0,.94445],88:[0,.69444,.13372,0,.66667],89:[0,.69444,.17261,0,.66667],90:[0,.69444,.11983,0,.61111],91:[.25,.75,.15942,0,.28889],93:[.25,.75,.08719,0,.28889],94:[0,.69444,.0799,0,.5],95:[.35,.09444,.08616,0,.5],97:[0,.44444,.00981,0,.48056],98:[0,.69444,.03057,0,.51667],99:[0,.44444,.08336,0,.44445],100:[0,.69444,.09483,0,.51667],101:[0,.44444,.06778,0,.44445],102:[0,.69444,.21705,0,.30556],103:[.19444,.44444,.10836,0,.5],104:[0,.69444,.01778,0,.51667],105:[0,.67937,.09718,0,.23889],106:[.19444,.67937,.09162,0,.26667],107:[0,.69444,.08336,0,.48889],108:[0,.69444,.09483,0,.23889],109:[0,.44444,.01778,0,.79445],110:[0,.44444,.01778,0,.51667],111:[0,.44444,.06613,0,.5],112:[.19444,.44444,.0389,0,.51667],113:[.19444,.44444,.04169,0,.51667],114:[0,.44444,.10836,0,.34167],115:[0,.44444,.0778,0,.38333],116:[0,.57143,.07225,0,.36111],117:[0,.44444,.04169,0,.51667],118:[0,.44444,.10836,0,.46111],119:[0,.44444,.10836,0,.68334],120:[0,.44444,.09169,0,.46111],121:[.19444,.44444,.10836,0,.46111],122:[0,.44444,.08752,0,.43472],126:[.35,.32659,.08826,0,.5],160:[0,0,0,0,.25],168:[0,.67937,.06385,0,.5],176:[0,.69444,0,0,.73752],184:[.17014,0,0,0,.44445],305:[0,.44444,.04169,0,.23889],567:[.19444,.44444,.04169,0,.26667],710:[0,.69444,.0799,0,.5],711:[0,.63194,.08432,0,.5],713:[0,.60889,.08776,0,.5],714:[0,.69444,.09205,0,.5],715:[0,.69444,0,0,.5],728:[0,.69444,.09483,0,.5],729:[0,.67937,.07774,0,.27778],730:[0,.69444,0,0,.73752],732:[0,.67659,.08826,0,.5],733:[0,.69444,.09205,0,.5],915:[0,.69444,.13372,0,.54167],916:[0,.69444,0,0,.83334],920:[0,.69444,.07555,0,.77778],923:[0,.69444,0,0,.61111],926:[0,.69444,.12816,0,.66667],928:[0,.69444,.08094,0,.70834],931:[0,.69444,.11983,0,.72222],933:[0,.69444,.09031,0,.77778],934:[0,.69444,.04603,0,.72222],936:[0,.69444,.09031,0,.77778],937:[0,.69444,.08293,0,.72222],8211:[0,.44444,.08616,0,.5],8212:[0,.44444,.08616,0,1],8216:[0,.69444,.07816,0,.27778],8217:[0,.69444,.07816,0,.27778],8220:[0,.69444,.14205,0,.5],8221:[0,.69444,.00316,0,.5]},"SansSerif-Regular":{32:[0,0,0,0,.25],33:[0,.69444,0,0,.31945],34:[0,.69444,0,0,.5],35:[.19444,.69444,0,0,.83334],36:[.05556,.75,0,0,.5],37:[.05556,.75,0,0,.83334],38:[0,.69444,0,0,.75834],39:[0,.69444,0,0,.27778],40:[.25,.75,0,0,.38889],41:[.25,.75,0,0,.38889],42:[0,.75,0,0,.5],43:[.08333,.58333,0,0,.77778],44:[.125,.08333,0,0,.27778],45:[0,.44444,0,0,.33333],46:[0,.08333,0,0,.27778],47:[.25,.75,0,0,.5],48:[0,.65556,0,0,.5],49:[0,.65556,0,0,.5],50:[0,.65556,0,0,.5],51:[0,.65556,0,0,.5],52:[0,.65556,0,0,.5],53:[0,.65556,0,0,.5],54:[0,.65556,0,0,.5],55:[0,.65556,0,0,.5],56:[0,.65556,0,0,.5],57:[0,.65556,0,0,.5],58:[0,.44444,0,0,.27778],59:[.125,.44444,0,0,.27778],61:[-.13,.37,0,0,.77778],63:[0,.69444,0,0,.47222],64:[0,.69444,0,0,.66667],65:[0,.69444,0,0,.66667],66:[0,.69444,0,0,.66667],67:[0,.69444,0,0,.63889],68:[0,.69444,0,0,.72223],69:[0,.69444,0,0,.59722],70:[0,.69444,0,0,.56945],71:[0,.69444,0,0,.66667],72:[0,.69444,0,0,.70834],73:[0,.69444,0,0,.27778],74:[0,.69444,0,0,.47222],75:[0,.69444,0,0,.69445],76:[0,.69444,0,0,.54167],77:[0,.69444,0,0,.875],78:[0,.69444,0,0,.70834],79:[0,.69444,0,0,.73611],80:[0,.69444,0,0,.63889],81:[.125,.69444,0,0,.73611],82:[0,.69444,0,0,.64584],83:[0,.69444,0,0,.55556],84:[0,.69444,0,0,.68056],85:[0,.69444,0,0,.6875],86:[0,.69444,.01389,0,.66667],87:[0,.69444,.01389,0,.94445],88:[0,.69444,0,0,.66667],89:[0,.69444,.025,0,.66667],90:[0,.69444,0,0,.61111],91:[.25,.75,0,0,.28889],93:[.25,.75,0,0,.28889],94:[0,.69444,0,0,.5],95:[.35,.09444,.02778,0,.5],97:[0,.44444,0,0,.48056],98:[0,.69444,0,0,.51667],99:[0,.44444,0,0,.44445],100:[0,.69444,0,0,.51667],101:[0,.44444,0,0,.44445],102:[0,.69444,.06944,0,.30556],103:[.19444,.44444,.01389,0,.5],104:[0,.69444,0,0,.51667],105:[0,.67937,0,0,.23889],106:[.19444,.67937,0,0,.26667],107:[0,.69444,0,0,.48889],108:[0,.69444,0,0,.23889],109:[0,.44444,0,0,.79445],110:[0,.44444,0,0,.51667],111:[0,.44444,0,0,.5],112:[.19444,.44444,0,0,.51667],113:[.19444,.44444,0,0,.51667],114:[0,.44444,.01389,0,.34167],115:[0,.44444,0,0,.38333],116:[0,.57143,0,0,.36111],117:[0,.44444,0,0,.51667],118:[0,.44444,.01389,0,.46111],119:[0,.44444,.01389,0,.68334],120:[0,.44444,0,0,.46111],121:[.19444,.44444,.01389,0,.46111],122:[0,.44444,0,0,.43472],126:[.35,.32659,0,0,.5],160:[0,0,0,0,.25],168:[0,.67937,0,0,.5],176:[0,.69444,0,0,.66667],184:[.17014,0,0,0,.44445],305:[0,.44444,0,0,.23889],567:[.19444,.44444,0,0,.26667],710:[0,.69444,0,0,.5],711:[0,.63194,0,0,.5],713:[0,.60889,0,0,.5],714:[0,.69444,0,0,.5],715:[0,.69444,0,0,.5],728:[0,.69444,0,0,.5],729:[0,.67937,0,0,.27778],730:[0,.69444,0,0,.66667],732:[0,.67659,0,0,.5],733:[0,.69444,0,0,.5],915:[0,.69444,0,0,.54167],916:[0,.69444,0,0,.83334],920:[0,.69444,0,0,.77778],923:[0,.69444,0,0,.61111],926:[0,.69444,0,0,.66667],928:[0,.69444,0,0,.70834],931:[0,.69444,0,0,.72222],933:[0,.69444,0,0,.77778],934:[0,.69444,0,0,.72222],936:[0,.69444,0,0,.77778],937:[0,.69444,0,0,.72222],8211:[0,.44444,.02778,0,.5],8212:[0,.44444,.02778,0,1],8216:[0,.69444,0,0,.27778],8217:[0,.69444,0,0,.27778],8220:[0,.69444,0,0,.5],8221:[0,.69444,0,0,.5]},"Script-Regular":{32:[0,0,0,0,.25],65:[0,.7,.22925,0,.80253],66:[0,.7,.04087,0,.90757],67:[0,.7,.1689,0,.66619],68:[0,.7,.09371,0,.77443],69:[0,.7,.18583,0,.56162],70:[0,.7,.13634,0,.89544],71:[0,.7,.17322,0,.60961],72:[0,.7,.29694,0,.96919],73:[0,.7,.19189,0,.80907],74:[.27778,.7,.19189,0,1.05159],75:[0,.7,.31259,0,.91364],76:[0,.7,.19189,0,.87373],77:[0,.7,.15981,0,1.08031],78:[0,.7,.3525,0,.9015],79:[0,.7,.08078,0,.73787],80:[0,.7,.08078,0,1.01262],81:[0,.7,.03305,0,.88282],82:[0,.7,.06259,0,.85],83:[0,.7,.19189,0,.86767],84:[0,.7,.29087,0,.74697],85:[0,.7,.25815,0,.79996],86:[0,.7,.27523,0,.62204],87:[0,.7,.27523,0,.80532],88:[0,.7,.26006,0,.94445],89:[0,.7,.2939,0,.70961],90:[0,.7,.24037,0,.8212],160:[0,0,0,0,.25]},"Size1-Regular":{32:[0,0,0,0,.25],40:[.35001,.85,0,0,.45834],41:[.35001,.85,0,0,.45834],47:[.35001,.85,0,0,.57778],91:[.35001,.85,0,0,.41667],92:[.35001,.85,0,0,.57778],93:[.35001,.85,0,0,.41667],123:[.35001,.85,0,0,.58334],125:[.35001,.85,0,0,.58334],160:[0,0,0,0,.25],710:[0,.72222,0,0,.55556],732:[0,.72222,0,0,.55556],770:[0,.72222,0,0,.55556],771:[0,.72222,0,0,.55556],8214:[-99e-5,.601,0,0,.77778],8593:[1e-5,.6,0,0,.66667],8595:[1e-5,.6,0,0,.66667],8657:[1e-5,.6,0,0,.77778],8659:[1e-5,.6,0,0,.77778],8719:[.25001,.75,0,0,.94445],8720:[.25001,.75,0,0,.94445],8721:[.25001,.75,0,0,1.05556],8730:[.35001,.85,0,0,1],8739:[-.00599,.606,0,0,.33333],8741:[-.00599,.606,0,0,.55556],8747:[.30612,.805,.19445,0,.47222],8748:[.306,.805,.19445,0,.47222],8749:[.306,.805,.19445,0,.47222],8750:[.30612,.805,.19445,0,.47222],8896:[.25001,.75,0,0,.83334],8897:[.25001,.75,0,0,.83334],8898:[.25001,.75,0,0,.83334],8899:[.25001,.75,0,0,.83334],8968:[.35001,.85,0,0,.47222],8969:[.35001,.85,0,0,.47222],8970:[.35001,.85,0,0,.47222],8971:[.35001,.85,0,0,.47222],9168:[-99e-5,.601,0,0,.66667],10216:[.35001,.85,0,0,.47222],10217:[.35001,.85,0,0,.47222],10752:[.25001,.75,0,0,1.11111],10753:[.25001,.75,0,0,1.11111],10754:[.25001,.75,0,0,1.11111],10756:[.25001,.75,0,0,.83334],10758:[.25001,.75,0,0,.83334]},"Size2-Regular":{32:[0,0,0,0,.25],40:[.65002,1.15,0,0,.59722],41:[.65002,1.15,0,0,.59722],47:[.65002,1.15,0,0,.81111],91:[.65002,1.15,0,0,.47222],92:[.65002,1.15,0,0,.81111],93:[.65002,1.15,0,0,.47222],123:[.65002,1.15,0,0,.66667],125:[.65002,1.15,0,0,.66667],160:[0,0,0,0,.25],710:[0,.75,0,0,1],732:[0,.75,0,0,1],770:[0,.75,0,0,1],771:[0,.75,0,0,1],8719:[.55001,1.05,0,0,1.27778],8720:[.55001,1.05,0,0,1.27778],8721:[.55001,1.05,0,0,1.44445],8730:[.65002,1.15,0,0,1],8747:[.86225,1.36,.44445,0,.55556],8748:[.862,1.36,.44445,0,.55556],8749:[.862,1.36,.44445,0,.55556],8750:[.86225,1.36,.44445,0,.55556],8896:[.55001,1.05,0,0,1.11111],8897:[.55001,1.05,0,0,1.11111],8898:[.55001,1.05,0,0,1.11111],8899:[.55001,1.05,0,0,1.11111],8968:[.65002,1.15,0,0,.52778],8969:[.65002,1.15,0,0,.52778],8970:[.65002,1.15,0,0,.52778],8971:[.65002,1.15,0,0,.52778],10216:[.65002,1.15,0,0,.61111],10217:[.65002,1.15,0,0,.61111],10752:[.55001,1.05,0,0,1.51112],10753:[.55001,1.05,0,0,1.51112],10754:[.55001,1.05,0,0,1.51112],10756:[.55001,1.05,0,0,1.11111],10758:[.55001,1.05,0,0,1.11111]},"Size3-Regular":{32:[0,0,0,0,.25],40:[.95003,1.45,0,0,.73611],41:[.95003,1.45,0,0,.73611],47:[.95003,1.45,0,0,1.04445],91:[.95003,1.45,0,0,.52778],92:[.95003,1.45,0,0,1.04445],93:[.95003,1.45,0,0,.52778],123:[.95003,1.45,0,0,.75],125:[.95003,1.45,0,0,.75],160:[0,0,0,0,.25],710:[0,.75,0,0,1.44445],732:[0,.75,0,0,1.44445],770:[0,.75,0,0,1.44445],771:[0,.75,0,0,1.44445],8730:[.95003,1.45,0,0,1],8968:[.95003,1.45,0,0,.58334],8969:[.95003,1.45,0,0,.58334],8970:[.95003,1.45,0,0,.58334],8971:[.95003,1.45,0,0,.58334],10216:[.95003,1.45,0,0,.75],10217:[.95003,1.45,0,0,.75]},"Size4-Regular":{32:[0,0,0,0,.25],40:[1.25003,1.75,0,0,.79167],41:[1.25003,1.75,0,0,.79167],47:[1.25003,1.75,0,0,1.27778],91:[1.25003,1.75,0,0,.58334],92:[1.25003,1.75,0,0,1.27778],93:[1.25003,1.75,0,0,.58334],123:[1.25003,1.75,0,0,.80556],125:[1.25003,1.75,0,0,.80556],160:[0,0,0,0,.25],710:[0,.825,0,0,1.8889],732:[0,.825,0,0,1.8889],770:[0,.825,0,0,1.8889],771:[0,.825,0,0,1.8889],8730:[1.25003,1.75,0,0,1],8968:[1.25003,1.75,0,0,.63889],8969:[1.25003,1.75,0,0,.63889],8970:[1.25003,1.75,0,0,.63889],8971:[1.25003,1.75,0,0,.63889],9115:[.64502,1.155,0,0,.875],9116:[1e-5,.6,0,0,.875],9117:[.64502,1.155,0,0,.875],9118:[.64502,1.155,0,0,.875],9119:[1e-5,.6,0,0,.875],9120:[.64502,1.155,0,0,.875],9121:[.64502,1.155,0,0,.66667],9122:[-99e-5,.601,0,0,.66667],9123:[.64502,1.155,0,0,.66667],9124:[.64502,1.155,0,0,.66667],9125:[-99e-5,.601,0,0,.66667],9126:[.64502,1.155,0,0,.66667],9127:[1e-5,.9,0,0,.88889],9128:[.65002,1.15,0,0,.88889],9129:[.90001,0,0,0,.88889],9130:[0,.3,0,0,.88889],9131:[1e-5,.9,0,0,.88889],9132:[.65002,1.15,0,0,.88889],9133:[.90001,0,0,0,.88889],9143:[.88502,.915,0,0,1.05556],10216:[1.25003,1.75,0,0,.80556],10217:[1.25003,1.75,0,0,.80556],57344:[-.00499,.605,0,0,1.05556],57345:[-.00499,.605,0,0,1.05556],57680:[0,.12,0,0,.45],57681:[0,.12,0,0,.45],57682:[0,.12,0,0,.45],57683:[0,.12,0,0,.45]},"Typewriter-Regular":{32:[0,0,0,0,.525],33:[0,.61111,0,0,.525],34:[0,.61111,0,0,.525],35:[0,.61111,0,0,.525],36:[.08333,.69444,0,0,.525],37:[.08333,.69444,0,0,.525],38:[0,.61111,0,0,.525],39:[0,.61111,0,0,.525],40:[.08333,.69444,0,0,.525],41:[.08333,.69444,0,0,.525],42:[0,.52083,0,0,.525],43:[-.08056,.53055,0,0,.525],44:[.13889,.125,0,0,.525],45:[-.08056,.53055,0,0,.525],46:[0,.125,0,0,.525],47:[.08333,.69444,0,0,.525],48:[0,.61111,0,0,.525],49:[0,.61111,0,0,.525],50:[0,.61111,0,0,.525],51:[0,.61111,0,0,.525],52:[0,.61111,0,0,.525],53:[0,.61111,0,0,.525],54:[0,.61111,0,0,.525],55:[0,.61111,0,0,.525],56:[0,.61111,0,0,.525],57:[0,.61111,0,0,.525],58:[0,.43056,0,0,.525],59:[.13889,.43056,0,0,.525],60:[-.05556,.55556,0,0,.525],61:[-.19549,.41562,0,0,.525],62:[-.05556,.55556,0,0,.525],63:[0,.61111,0,0,.525],64:[0,.61111,0,0,.525],65:[0,.61111,0,0,.525],66:[0,.61111,0,0,.525],67:[0,.61111,0,0,.525],68:[0,.61111,0,0,.525],69:[0,.61111,0,0,.525],70:[0,.61111,0,0,.525],71:[0,.61111,0,0,.525],72:[0,.61111,0,0,.525],73:[0,.61111,0,0,.525],74:[0,.61111,0,0,.525],75:[0,.61111,0,0,.525],76:[0,.61111,0,0,.525],77:[0,.61111,0,0,.525],78:[0,.61111,0,0,.525],79:[0,.61111,0,0,.525],80:[0,.61111,0,0,.525],81:[.13889,.61111,0,0,.525],82:[0,.61111,0,0,.525],83:[0,.61111,0,0,.525],84:[0,.61111,0,0,.525],85:[0,.61111,0,0,.525],86:[0,.61111,0,0,.525],87:[0,.61111,0,0,.525],88:[0,.61111,0,0,.525],89:[0,.61111,0,0,.525],90:[0,.61111,0,0,.525],91:[.08333,.69444,0,0,.525],92:[.08333,.69444,0,0,.525],93:[.08333,.69444,0,0,.525],94:[0,.61111,0,0,.525],95:[.09514,0,0,0,.525],96:[0,.61111,0,0,.525],97:[0,.43056,0,0,.525],98:[0,.61111,0,0,.525],99:[0,.43056,0,0,.525],100:[0,.61111,0,0,.525],101:[0,.43056,0,0,.525],102:[0,.61111,0,0,.525],103:[.22222,.43056,0,0,.525],104:[0,.61111,0,0,.525],105:[0,.61111,0,0,.525],106:[.22222,.61111,0,0,.525],107:[0,.61111,0,0,.525],108:[0,.61111,0,0,.525],109:[0,.43056,0,0,.525],110:[0,.43056,0,0,.525],111:[0,.43056,0,0,.525],112:[.22222,.43056,0,0,.525],113:[.22222,.43056,0,0,.525],114:[0,.43056,0,0,.525],115:[0,.43056,0,0,.525],116:[0,.55358,0,0,.525],117:[0,.43056,0,0,.525],118:[0,.43056,0,0,.525],119:[0,.43056,0,0,.525],120:[0,.43056,0,0,.525],121:[.22222,.43056,0,0,.525],122:[0,.43056,0,0,.525],123:[.08333,.69444,0,0,.525],124:[.08333,.69444,0,0,.525],125:[.08333,.69444,0,0,.525],126:[0,.61111,0,0,.525],127:[0,.61111,0,0,.525],160:[0,0,0,0,.525],176:[0,.61111,0,0,.525],184:[.19445,0,0,0,.525],305:[0,.43056,0,0,.525],567:[.22222,.43056,0,0,.525],711:[0,.56597,0,0,.525],713:[0,.56555,0,0,.525],714:[0,.61111,0,0,.525],715:[0,.61111,0,0,.525],728:[0,.61111,0,0,.525],730:[0,.61111,0,0,.525],770:[0,.61111,0,0,.525],771:[0,.61111,0,0,.525],776:[0,.61111,0,0,.525],915:[0,.61111,0,0,.525],916:[0,.61111,0,0,.525],920:[0,.61111,0,0,.525],923:[0,.61111,0,0,.525],926:[0,.61111,0,0,.525],928:[0,.61111,0,0,.525],931:[0,.61111,0,0,.525],933:[0,.61111,0,0,.525],934:[0,.61111,0,0,.525],936:[0,.61111,0,0,.525],937:[0,.61111,0,0,.525],8216:[0,.61111,0,0,.525],8217:[0,.61111,0,0,.525],8242:[0,.61111,0,0,.525],9251:[.11111,.21944,0,0,.525]}},ve={slant:[.25,.25,.25],space:[0,0,0],stretch:[0,0,0],shrink:[0,0,0],xHeight:[.431,.431,.431],quad:[1,1.171,1.472],extraSpace:[0,0,0],num1:[.677,.732,.925],num2:[.394,.384,.387],num3:[.444,.471,.504],denom1:[.686,.752,1.025],denom2:[.345,.344,.532],sup1:[.413,.503,.504],sup2:[.363,.431,.404],sup3:[.289,.286,.294],sub1:[.15,.143,.2],sub2:[.247,.286,.4],supDrop:[.386,.353,.494],subDrop:[.05,.071,.1],delim1:[2.39,1.7,1.98],delim2:[1.01,1.157,1.42],axisHeight:[.25,.25,.25],defaultRuleThickness:[.04,.049,.049],bigOpSpacing1:[.111,.111,.111],bigOpSpacing2:[.166,.166,.166],bigOpSpacing3:[.2,.2,.2],bigOpSpacing4:[.6,.611,.611],bigOpSpacing5:[.1,.143,.143],sqrtRuleThickness:[.04,.04,.04],ptPerEm:[10,10,10],doubleRuleSep:[.2,.2,.2],arrayRuleWidth:[.04,.04,.04],fboxsep:[.3,.3,.3],fboxrule:[.04,.04,.04]},Ht={Å:"A",Ð:"D",Þ:"o",å:"a",ð:"d",þ:"o",А:"A",Б:"B",В:"B",Г:"F",Д:"A",Е:"E",Ж:"K",З:"3",И:"N",Й:"N",К:"K",Л:"N",М:"M",Н:"H",О:"O",П:"N",Р:"P",С:"C",Т:"T",У:"y",Ф:"O",Х:"X",Ц:"U",Ч:"h",Ш:"W",Щ:"W",Ъ:"B",Ы:"X",Ь:"B",Э:"3",Ю:"X",Я:"R",а:"a",б:"b",в:"a",г:"r",д:"y",е:"e",ж:"m",з:"e",и:"n",й:"n",к:"n",л:"n",м:"m",н:"n",о:"o",п:"n",р:"p",с:"c",т:"o",у:"y",ф:"b",х:"x",ц:"n",ч:"n",ш:"w",щ:"w",ъ:"a",ы:"m",ь:"a",э:"e",ю:"m",я:"r"};function Ga(r,e){w0[r]=e}function pt(r,e,t){if(!w0[e])throw new Error("Font metrics not found for font: "+e+".");var a=r.charCodeAt(0),i=w0[e][a];if(!i&&r[0]in Ht&&(a=Ht[r[0]].charCodeAt(0),i=w0[e][a]),!i&&t==="text"&&gr(a)&&(i=w0[e][77]),i)return{depth:i[0],height:i[1],italic:i[2],skew:i[3],width:i[4]}}var Ue={};function Va(r){var e;if(r>=5?e=0:r>=3?e=1:e=2,!Ue[e]){var t=Ue[e]={cssEmPerMu:ve.quad[e]/18};for(var a in ve)ve.hasOwnProperty(a)&&(t[a]=ve[a][e])}return Ue[e]}var Ua=[[1,1,1],[2,1,1],[3,1,1],[4,2,1],[5,2,1],[6,3,1],[7,4,2],[8,6,3],[9,7,6],[10,8,7],[11,10,9]],Lt=[.5,.6,.7,.8,.9,1,1.2,1.44,1.728,2.074,2.488],Ft=function(e,t){return t.size<2?e:Ua[e-1][t.size-1]};class A0{constructor(e){this.style=void 0,this.color=void 0,this.size=void 0,this.textSize=void 0,this.phantom=void 0,this.font=void 0,this.fontFamily=void 0,this.fontWeight=void 0,this.fontShape=void 0,this.sizeMultiplier=void 0,this.maxSize=void 0,this.minRuleThickness=void 0,this._fontMetrics=void 0,this.style=e.style,this.color=e.color,this.size=e.size||A0.BASESIZE,this.textSize=e.textSize||this.size,this.phantom=!!e.phantom,this.font=e.font||"",this.fontFamily=e.fontFamily||"",this.fontWeight=e.fontWeight||"",this.fontShape=e.fontShape||"",this.sizeMultiplier=Lt[this.size-1],this.maxSize=e.maxSize,this.minRuleThickness=e.minRuleThickness,this._fontMetrics=void 0}extend(e){var t={style:this.style,size:this.size,textSize:this.textSize,color:this.color,phantom:this.phantom,font:this.font,fontFamily:this.fontFamily,fontWeight:this.fontWeight,fontShape:this.fontShape,maxSize:this.maxSize,minRuleThickness:this.minRuleThickness};for(var a in e)e.hasOwnProperty(a)&&(t[a]=e[a]);return new A0(t)}havingStyle(e){return this.style===e?this:this.extend({style:e,size:Ft(this.textSize,e)})}havingCrampedStyle(){return this.havingStyle(this.style.cramp())}havingSize(e){return this.size===e&&this.textSize===e?this:this.extend({style:this.style.text(),size:e,textSize:e,sizeMultiplier:Lt[e-1]})}havingBaseStyle(e){e=e||this.style.text();var t=Ft(A0.BASESIZE,e);return this.size===t&&this.textSize===A0.BASESIZE&&this.style===e?this:this.extend({style:e,size:t})}havingBaseSizing(){var e;switch(this.style.id){case 4:case 5:e=3;break;case 6:case 7:e=1;break;default:e=6}return this.extend({style:this.style.text(),size:e})}withColor(e){return this.extend({color:e})}withPhantom(){return this.extend({phantom:!0})}withFont(e){return this.extend({font:e})}withTextFontFamily(e){return this.extend({fontFamily:e,font:""})}withTextFontWeight(e){return this.extend({fontWeight:e,font:""})}withTextFontShape(e){return this.extend({fontShape:e,font:""})}sizingClasses(e){return e.size!==this.size?["sizing","reset-size"+e.size,"size"+this.size]:[]}baseSizingClasses(){return this.size!==A0.BASESIZE?["sizing","reset-size"+this.size,"size"+A0.BASESIZE]:[]}fontMetrics(){return this._fontMetrics||(this._fontMetrics=Va(this.size)),this._fontMetrics}getColor(){return this.phantom?"transparent":this.color}}A0.BASESIZE=6;var nt={pt:1,mm:7227/2540,cm:7227/254,in:72.27,bp:803/800,pc:12,dd:1238/1157,cc:14856/1157,nd:685/642,nc:1370/107,sp:1/65536,px:803/800},Ya={ex:!0,em:!0,mu:!0},br=function(e){return typeof e!="string"&&(e=e.unit),e in nt||e in Ya||e==="ex"},K=function(e,t){var a;if(e.unit in nt)a=nt[e.unit]/t.fontMetrics().ptPerEm/t.sizeMultiplier;else if(e.unit==="mu")a=t.fontMetrics().cssEmPerMu;else{var i;if(t.style.isTight()?i=t.havingStyle(t.style.text()):i=t,e.unit==="ex")a=i.fontMetrics().xHeight;else if(e.unit==="em")a=i.fontMetrics().quad;else throw new M("Invalid unit: '"+e.unit+"'");i!==t&&(a*=i.sizeMultiplier/t.sizeMultiplier)}return Math.min(e.number*a,t.maxSize)},T=function(e){return+e.toFixed(4)+"em"},P0=function(e){return e.filter(t=>t).join(" ")},yr=function(e,t,a){if(this.classes=e||[],this.attributes={},this.height=0,this.depth=0,this.maxFontSize=0,this.style=a||{},t){t.style.isTight()&&this.classes.push("mtight");var i=t.getColor();i&&(this.style.color=i)}},wr=function(e){var t=document.createElement(e);t.className=P0(this.classes);for(var a in this.style)this.style.hasOwnProperty(a)&&(t.style[a]=this.style[a]);for(var i in this.attributes)this.attributes.hasOwnProperty(i)&&t.setAttribute(i,this.attributes[i]);for(var s=0;s<this.children.length;s++)t.appendChild(this.children[s].toNode());return t},Xa=/[\s"'>/=\x00-\x1f]/,xr=function(e){var t="<"+e;this.classes.length&&(t+=' class="'+G.escape(P0(this.classes))+'"');var a="";for(var i in this.style)this.style.hasOwnProperty(i)&&(a+=G.hyphenate(i)+":"+this.style[i]+";");a&&(t+=' style="'+G.escape(a)+'"');for(var s in this.attributes)if(this.attributes.hasOwnProperty(s)){if(Xa.test(s))throw new M("Invalid attribute name '"+s+"'");t+=" "+s+'="'+G.escape(this.attributes[s])+'"'}t+=">";for(var o=0;o<this.children.length;o++)t+=this.children[o].toMarkup();return t+="</"+e+">",t};class me{constructor(e,t,a,i){this.children=void 0,this.attributes=void 0,this.classes=void 0,this.height=void 0,this.depth=void 0,this.width=void 0,this.maxFontSize=void 0,this.style=void 0,yr.call(this,e,a,i),this.children=t||[]}setAttribute(e,t){this.attributes[e]=t}hasClass(e){return this.classes.includes(e)}toNode(){return wr.call(this,"span")}toMarkup(){return xr.call(this,"span")}}class vt{constructor(e,t,a,i){this.children=void 0,this.attributes=void 0,this.classes=void 0,this.height=void 0,this.depth=void 0,this.maxFontSize=void 0,this.style=void 0,yr.call(this,t,i),this.children=a||[],this.setAttribute("href",e)}setAttribute(e,t){this.attributes[e]=t}hasClass(e){return this.classes.includes(e)}toNode(){return wr.call(this,"a")}toMarkup(){return xr.call(this,"a")}}class $a{constructor(e,t,a){this.src=void 0,this.alt=void 0,this.classes=void 0,this.height=void 0,this.depth=void 0,this.maxFontSize=void 0,this.style=void 0,this.alt=t,this.src=e,this.classes=["mord"],this.style=a}hasClass(e){return this.classes.includes(e)}toNode(){var e=document.createElement("img");e.src=this.src,e.alt=this.alt,e.className="mord";for(var t in this.style)this.style.hasOwnProperty(t)&&(e.style[t]=this.style[t]);return e}toMarkup(){var e='<img src="'+G.escape(this.src)+'"'+(' alt="'+G.escape(this.alt)+'"'),t="";for(var a in this.style)this.style.hasOwnProperty(a)&&(t+=G.hyphenate(a)+":"+this.style[a]+";");return t&&(e+=' style="'+G.escape(t)+'"'),e+="'/>",e}}var Wa={î:"ı̂",ï:"ı̈",í:"ı́",ì:"ı̀"};class p0{constructor(e,t,a,i,s,o,m,c){this.text=void 0,this.height=void 0,this.depth=void 0,this.italic=void 0,this.skew=void 0,this.width=void 0,this.maxFontSize=void 0,this.classes=void 0,this.style=void 0,this.text=e,this.height=t||0,this.depth=a||0,this.italic=i||0,this.skew=s||0,this.width=o||0,this.classes=m||[],this.style=c||{},this.maxFontSize=0;var p=Ca(this.text.charCodeAt(0));p&&this.classes.push(p+"_fallback"),/[îïíì]/.test(this.text)&&(this.text=Wa[this.text])}hasClass(e){return this.classes.includes(e)}toNode(){var e=document.createTextNode(this.text),t=null;this.italic>0&&(t=document.createElement("span"),t.style.marginRight=T(this.italic)),this.classes.length>0&&(t=t||document.createElement("span"),t.className=P0(this.classes));for(var a in this.style)this.style.hasOwnProperty(a)&&(t=t||document.createElement("span"),t.style[a]=this.style[a]);return t?(t.appendChild(e),t):e}toMarkup(){var e=!1,t="<span";this.classes.length&&(e=!0,t+=' class="',t+=G.escape(P0(this.classes)),t+='"');var a="";this.italic>0&&(a+="margin-right:"+this.italic+"em;");for(var i in this.style)this.style.hasOwnProperty(i)&&(a+=G.hyphenate(i)+":"+this.style[i]+";");a&&(e=!0,t+=' style="'+G.escape(a)+'"');var s=G.escape(this.text);return e?(t+=">",t+=s,t+="</span>",t):s}}class C0{constructor(e,t){this.children=void 0,this.attributes=void 0,this.children=e||[],this.attributes=t||{}}toNode(){var e="http://www.w3.org/2000/svg",t=document.createElementNS(e,"svg");for(var a in this.attributes)Object.prototype.hasOwnProperty.call(this.attributes,a)&&t.setAttribute(a,this.attributes[a]);for(var i=0;i<this.children.length;i++)t.appendChild(this.children[i].toNode());return t}toMarkup(){var e='<svg xmlns="http://www.w3.org/2000/svg"';for(var t in this.attributes)Object.prototype.hasOwnProperty.call(this.attributes,t)&&(e+=" "+t+'="'+G.escape(this.attributes[t])+'"');e+=">";for(var a=0;a<this.children.length;a++)e+=this.children[a].toMarkup();return e+="</svg>",e}}class G0{constructor(e,t){this.pathName=void 0,this.alternate=void 0,this.pathName=e,this.alternate=t}toNode(){var e="http://www.w3.org/2000/svg",t=document.createElementNS(e,"path");return this.alternate?t.setAttribute("d",this.alternate):t.setAttribute("d",Ot[this.pathName]),t}toMarkup(){return this.alternate?'<path d="'+G.escape(this.alternate)+'"/>':'<path d="'+G.escape(Ot[this.pathName])+'"/>'}}class st{constructor(e){this.attributes=void 0,this.attributes=e||{}}toNode(){var e="http://www.w3.org/2000/svg",t=document.createElementNS(e,"line");for(var a in this.attributes)Object.prototype.hasOwnProperty.call(this.attributes,a)&&t.setAttribute(a,this.attributes[a]);return t}toMarkup(){var e="<line";for(var t in this.attributes)Object.prototype.hasOwnProperty.call(this.attributes,t)&&(e+=" "+t+'="'+G.escape(this.attributes[t])+'"');return e+="/>",e}}function Pt(r){if(r instanceof p0)return r;throw new Error("Expected symbolNode but got "+String(r)+".")}function ja(r){if(r instanceof me)return r;throw new Error("Expected span<HtmlDomNode> but got "+String(r)+".")}var Za={bin:1,close:1,inner:1,open:1,punct:1,rel:1},Ka={"accent-token":1,mathord:1,"op-token":1,spacing:1,textord:1},$={math:{},text:{}};function n(r,e,t,a,i,s){$[r][i]={font:e,group:t,replace:a},s&&a&&($[r][a]=$[r][i])}var l="math",k="text",h="main",d="ams",W="accent-token",N="bin",n0="close",re="inner",R="mathord",_="op-token",c0="open",Re="punct",f="rel",I0="spacing",v="textord";n(l,h,f,"≡","\\equiv",!0);n(l,h,f,"≺","\\prec",!0);n(l,h,f,"≻","\\succ",!0);n(l,h,f,"∼","\\sim",!0);n(l,h,f,"⊥","\\perp");n(l,h,f,"⪯","\\preceq",!0);n(l,h,f,"⪰","\\succeq",!0);n(l,h,f,"≃","\\simeq",!0);n(l,h,f,"∣","\\mid",!0);n(l,h,f,"≪","\\ll",!0);n(l,h,f,"≫","\\gg",!0);n(l,h,f,"≍","\\asymp",!0);n(l,h,f,"∥","\\parallel");n(l,h,f,"⋈","\\bowtie",!0);n(l,h,f,"⌣","\\smile",!0);n(l,h,f,"⊑","\\sqsubseteq",!0);n(l,h,f,"⊒","\\sqsupseteq",!0);n(l,h,f,"≐","\\doteq",!0);n(l,h,f,"⌢","\\frown",!0);n(l,h,f,"∋","\\ni",!0);n(l,h,f,"∝","\\propto",!0);n(l,h,f,"⊢","\\vdash",!0);n(l,h,f,"⊣","\\dashv",!0);n(l,h,f,"∋","\\owns");n(l,h,Re,".","\\ldotp");n(l,h,Re,"⋅","\\cdotp");n(l,h,v,"#","\\#");n(k,h,v,"#","\\#");n(l,h,v,"&","\\&");n(k,h,v,"&","\\&");n(l,h,v,"ℵ","\\aleph",!0);n(l,h,v,"∀","\\forall",!0);n(l,h,v,"ℏ","\\hbar",!0);n(l,h,v,"∃","\\exists",!0);n(l,h,v,"∇","\\nabla",!0);n(l,h,v,"♭","\\flat",!0);n(l,h,v,"ℓ","\\ell",!0);n(l,h,v,"♮","\\natural",!0);n(l,h,v,"♣","\\clubsuit",!0);n(l,h,v,"℘","\\wp",!0);n(l,h,v,"♯","\\sharp",!0);n(l,h,v,"♢","\\diamondsuit",!0);n(l,h,v,"ℜ","\\Re",!0);n(l,h,v,"♡","\\heartsuit",!0);n(l,h,v,"ℑ","\\Im",!0);n(l,h,v,"♠","\\spadesuit",!0);n(l,h,v,"§","\\S",!0);n(k,h,v,"§","\\S");n(l,h,v,"¶","\\P",!0);n(k,h,v,"¶","\\P");n(l,h,v,"†","\\dag");n(k,h,v,"†","\\dag");n(k,h,v,"†","\\textdagger");n(l,h,v,"‡","\\ddag");n(k,h,v,"‡","\\ddag");n(k,h,v,"‡","\\textdaggerdbl");n(l,h,n0,"⎱","\\rmoustache",!0);n(l,h,c0,"⎰","\\lmoustache",!0);n(l,h,n0,"⟯","\\rgroup",!0);n(l,h,c0,"⟮","\\lgroup",!0);n(l,h,N,"∓","\\mp",!0);n(l,h,N,"⊖","\\ominus",!0);n(l,h,N,"⊎","\\uplus",!0);n(l,h,N,"⊓","\\sqcap",!0);n(l,h,N,"∗","\\ast");n(l,h,N,"⊔","\\sqcup",!0);n(l,h,N,"◯","\\bigcirc",!0);n(l,h,N,"∙","\\bullet",!0);n(l,h,N,"‡","\\ddagger");n(l,h,N,"≀","\\wr",!0);n(l,h,N,"⨿","\\amalg");n(l,h,N,"&","\\And");n(l,h,f,"⟵","\\longleftarrow",!0);n(l,h,f,"⇐","\\Leftarrow",!0);n(l,h,f,"⟸","\\Longleftarrow",!0);n(l,h,f,"⟶","\\longrightarrow",!0);n(l,h,f,"⇒","\\Rightarrow",!0);n(l,h,f,"⟹","\\Longrightarrow",!0);n(l,h,f,"↔","\\leftrightarrow",!0);n(l,h,f,"⟷","\\longleftrightarrow",!0);n(l,h,f,"⇔","\\Leftrightarrow",!0);n(l,h,f,"⟺","\\Longleftrightarrow",!0);n(l,h,f,"↦","\\mapsto",!0);n(l,h,f,"⟼","\\longmapsto",!0);n(l,h,f,"↗","\\nearrow",!0);n(l,h,f,"↩","\\hookleftarrow",!0);n(l,h,f,"↪","\\hookrightarrow",!0);n(l,h,f,"↘","\\searrow",!0);n(l,h,f,"↼","\\leftharpoonup",!0);n(l,h,f,"⇀","\\rightharpoonup",!0);n(l,h,f,"↙","\\swarrow",!0);n(l,h,f,"↽","\\leftharpoondown",!0);n(l,h,f,"⇁","\\rightharpoondown",!0);n(l,h,f,"↖","\\nwarrow",!0);n(l,h,f,"⇌","\\rightleftharpoons",!0);n(l,d,f,"≮","\\nless",!0);n(l,d,f,"","\\@nleqslant");n(l,d,f,"","\\@nleqq");n(l,d,f,"⪇","\\lneq",!0);n(l,d,f,"≨","\\lneqq",!0);n(l,d,f,"","\\@lvertneqq");n(l,d,f,"⋦","\\lnsim",!0);n(l,d,f,"⪉","\\lnapprox",!0);n(l,d,f,"⊀","\\nprec",!0);n(l,d,f,"⋠","\\npreceq",!0);n(l,d,f,"⋨","\\precnsim",!0);n(l,d,f,"⪹","\\precnapprox",!0);n(l,d,f,"≁","\\nsim",!0);n(l,d,f,"","\\@nshortmid");n(l,d,f,"∤","\\nmid",!0);n(l,d,f,"⊬","\\nvdash",!0);n(l,d,f,"⊭","\\nvDash",!0);n(l,d,f,"⋪","\\ntriangleleft");n(l,d,f,"⋬","\\ntrianglelefteq",!0);n(l,d,f,"⊊","\\subsetneq",!0);n(l,d,f,"","\\@varsubsetneq");n(l,d,f,"⫋","\\subsetneqq",!0);n(l,d,f,"","\\@varsubsetneqq");n(l,d,f,"≯","\\ngtr",!0);n(l,d,f,"","\\@ngeqslant");n(l,d,f,"","\\@ngeqq");n(l,d,f,"⪈","\\gneq",!0);n(l,d,f,"≩","\\gneqq",!0);n(l,d,f,"","\\@gvertneqq");n(l,d,f,"⋧","\\gnsim",!0);n(l,d,f,"⪊","\\gnapprox",!0);n(l,d,f,"⊁","\\nsucc",!0);n(l,d,f,"⋡","\\nsucceq",!0);n(l,d,f,"⋩","\\succnsim",!0);n(l,d,f,"⪺","\\succnapprox",!0);n(l,d,f,"≆","\\ncong",!0);n(l,d,f,"","\\@nshortparallel");n(l,d,f,"∦","\\nparallel",!0);n(l,d,f,"⊯","\\nVDash",!0);n(l,d,f,"⋫","\\ntriangleright");n(l,d,f,"⋭","\\ntrianglerighteq",!0);n(l,d,f,"","\\@nsupseteqq");n(l,d,f,"⊋","\\supsetneq",!0);n(l,d,f,"","\\@varsupsetneq");n(l,d,f,"⫌","\\supsetneqq",!0);n(l,d,f,"","\\@varsupsetneqq");n(l,d,f,"⊮","\\nVdash",!0);n(l,d,f,"⪵","\\precneqq",!0);n(l,d,f,"⪶","\\succneqq",!0);n(l,d,f,"","\\@nsubseteqq");n(l,d,N,"⊴","\\unlhd");n(l,d,N,"⊵","\\unrhd");n(l,d,f,"↚","\\nleftarrow",!0);n(l,d,f,"↛","\\nrightarrow",!0);n(l,d,f,"⇍","\\nLeftarrow",!0);n(l,d,f,"⇏","\\nRightarrow",!0);n(l,d,f,"↮","\\nleftrightarrow",!0);n(l,d,f,"⇎","\\nLeftrightarrow",!0);n(l,d,f,"△","\\vartriangle");n(l,d,v,"ℏ","\\hslash");n(l,d,v,"▽","\\triangledown");n(l,d,v,"◊","\\lozenge");n(l,d,v,"Ⓢ","\\circledS");n(l,d,v,"®","\\circledR");n(k,d,v,"®","\\circledR");n(l,d,v,"∡","\\measuredangle",!0);n(l,d,v,"∄","\\nexists");n(l,d,v,"℧","\\mho");n(l,d,v,"Ⅎ","\\Finv",!0);n(l,d,v,"⅁","\\Game",!0);n(l,d,v,"‵","\\backprime");n(l,d,v,"▲","\\blacktriangle");n(l,d,v,"▼","\\blacktriangledown");n(l,d,v,"■","\\blacksquare");n(l,d,v,"⧫","\\blacklozenge");n(l,d,v,"★","\\bigstar");n(l,d,v,"∢","\\sphericalangle",!0);n(l,d,v,"∁","\\complement",!0);n(l,d,v,"ð","\\eth",!0);n(k,h,v,"ð","ð");n(l,d,v,"╱","\\diagup");n(l,d,v,"╲","\\diagdown");n(l,d,v,"□","\\square");n(l,d,v,"□","\\Box");n(l,d,v,"◊","\\Diamond");n(l,d,v,"¥","\\yen",!0);n(k,d,v,"¥","\\yen",!0);n(l,d,v,"✓","\\checkmark",!0);n(k,d,v,"✓","\\checkmark");n(l,d,v,"ℶ","\\beth",!0);n(l,d,v,"ℸ","\\daleth",!0);n(l,d,v,"ℷ","\\gimel",!0);n(l,d,v,"ϝ","\\digamma",!0);n(l,d,v,"ϰ","\\varkappa");n(l,d,c0,"┌","\\@ulcorner",!0);n(l,d,n0,"┐","\\@urcorner",!0);n(l,d,c0,"└","\\@llcorner",!0);n(l,d,n0,"┘","\\@lrcorner",!0);n(l,d,f,"≦","\\leqq",!0);n(l,d,f,"⩽","\\leqslant",!0);n(l,d,f,"⪕","\\eqslantless",!0);n(l,d,f,"≲","\\lesssim",!0);n(l,d,f,"⪅","\\lessapprox",!0);n(l,d,f,"≊","\\approxeq",!0);n(l,d,N,"⋖","\\lessdot");n(l,d,f,"⋘","\\lll",!0);n(l,d,f,"≶","\\lessgtr",!0);n(l,d,f,"⋚","\\lesseqgtr",!0);n(l,d,f,"⪋","\\lesseqqgtr",!0);n(l,d,f,"≑","\\doteqdot");n(l,d,f,"≓","\\risingdotseq",!0);n(l,d,f,"≒","\\fallingdotseq",!0);n(l,d,f,"∽","\\backsim",!0);n(l,d,f,"⋍","\\backsimeq",!0);n(l,d,f,"⫅","\\subseteqq",!0);n(l,d,f,"⋐","\\Subset",!0);n(l,d,f,"⊏","\\sqsubset",!0);n(l,d,f,"≼","\\preccurlyeq",!0);n(l,d,f,"⋞","\\curlyeqprec",!0);n(l,d,f,"≾","\\precsim",!0);n(l,d,f,"⪷","\\precapprox",!0);n(l,d,f,"⊲","\\vartriangleleft");n(l,d,f,"⊴","\\trianglelefteq");n(l,d,f,"⊨","\\vDash",!0);n(l,d,f,"⊪","\\Vvdash",!0);n(l,d,f,"⌣","\\smallsmile");n(l,d,f,"⌢","\\smallfrown");n(l,d,f,"≏","\\bumpeq",!0);n(l,d,f,"≎","\\Bumpeq",!0);n(l,d,f,"≧","\\geqq",!0);n(l,d,f,"⩾","\\geqslant",!0);n(l,d,f,"⪖","\\eqslantgtr",!0);n(l,d,f,"≳","\\gtrsim",!0);n(l,d,f,"⪆","\\gtrapprox",!0);n(l,d,N,"⋗","\\gtrdot");n(l,d,f,"⋙","\\ggg",!0);n(l,d,f,"≷","\\gtrless",!0);n(l,d,f,"⋛","\\gtreqless",!0);n(l,d,f,"⪌","\\gtreqqless",!0);n(l,d,f,"≖","\\eqcirc",!0);n(l,d,f,"≗","\\circeq",!0);n(l,d,f,"≜","\\triangleq",!0);n(l,d,f,"∼","\\thicksim");n(l,d,f,"≈","\\thickapprox");n(l,d,f,"⫆","\\supseteqq",!0);n(l,d,f,"⋑","\\Supset",!0);n(l,d,f,"⊐","\\sqsupset",!0);n(l,d,f,"≽","\\succcurlyeq",!0);n(l,d,f,"⋟","\\curlyeqsucc",!0);n(l,d,f,"≿","\\succsim",!0);n(l,d,f,"⪸","\\succapprox",!0);n(l,d,f,"⊳","\\vartriangleright");n(l,d,f,"⊵","\\trianglerighteq");n(l,d,f,"⊩","\\Vdash",!0);n(l,d,f,"∣","\\shortmid");n(l,d,f,"∥","\\shortparallel");n(l,d,f,"≬","\\between",!0);n(l,d,f,"⋔","\\pitchfork",!0);n(l,d,f,"∝","\\varpropto");n(l,d,f,"◀","\\blacktriangleleft");n(l,d,f,"∴","\\therefore",!0);n(l,d,f,"∍","\\backepsilon");n(l,d,f,"▶","\\blacktriangleright");n(l,d,f,"∵","\\because",!0);n(l,d,f,"⋘","\\llless");n(l,d,f,"⋙","\\gggtr");n(l,d,N,"⊲","\\lhd");n(l,d,N,"⊳","\\rhd");n(l,d,f,"≂","\\eqsim",!0);n(l,h,f,"⋈","\\Join");n(l,d,f,"≑","\\Doteq",!0);n(l,d,N,"∔","\\dotplus",!0);n(l,d,N,"∖","\\smallsetminus");n(l,d,N,"⋒","\\Cap",!0);n(l,d,N,"⋓","\\Cup",!0);n(l,d,N,"⩞","\\doublebarwedge",!0);n(l,d,N,"⊟","\\boxminus",!0);n(l,d,N,"⊞","\\boxplus",!0);n(l,d,N,"⋇","\\divideontimes",!0);n(l,d,N,"⋉","\\ltimes",!0);n(l,d,N,"⋊","\\rtimes",!0);n(l,d,N,"⋋","\\leftthreetimes",!0);n(l,d,N,"⋌","\\rightthreetimes",!0);n(l,d,N,"⋏","\\curlywedge",!0);n(l,d,N,"⋎","\\curlyvee",!0);n(l,d,N,"⊝","\\circleddash",!0);n(l,d,N,"⊛","\\circledast",!0);n(l,d,N,"⋅","\\centerdot");n(l,d,N,"⊺","\\intercal",!0);n(l,d,N,"⋒","\\doublecap");n(l,d,N,"⋓","\\doublecup");n(l,d,N,"⊠","\\boxtimes",!0);n(l,d,f,"⇢","\\dashrightarrow",!0);n(l,d,f,"⇠","\\dashleftarrow",!0);n(l,d,f,"⇇","\\leftleftarrows",!0);n(l,d,f,"⇆","\\leftrightarrows",!0);n(l,d,f,"⇚","\\Lleftarrow",!0);n(l,d,f,"↞","\\twoheadleftarrow",!0);n(l,d,f,"↢","\\leftarrowtail",!0);n(l,d,f,"↫","\\looparrowleft",!0);n(l,d,f,"⇋","\\leftrightharpoons",!0);n(l,d,f,"↶","\\curvearrowleft",!0);n(l,d,f,"↺","\\circlearrowleft",!0);n(l,d,f,"↰","\\Lsh",!0);n(l,d,f,"⇈","\\upuparrows",!0);n(l,d,f,"↿","\\upharpoonleft",!0);n(l,d,f,"⇃","\\downharpoonleft",!0);n(l,h,f,"⊶","\\origof",!0);n(l,h,f,"⊷","\\imageof",!0);n(l,d,f,"⊸","\\multimap",!0);n(l,d,f,"↭","\\leftrightsquigarrow",!0);n(l,d,f,"⇉","\\rightrightarrows",!0);n(l,d,f,"⇄","\\rightleftarrows",!0);n(l,d,f,"↠","\\twoheadrightarrow",!0);n(l,d,f,"↣","\\rightarrowtail",!0);n(l,d,f,"↬","\\looparrowright",!0);n(l,d,f,"↷","\\curvearrowright",!0);n(l,d,f,"↻","\\circlearrowright",!0);n(l,d,f,"↱","\\Rsh",!0);n(l,d,f,"⇊","\\downdownarrows",!0);n(l,d,f,"↾","\\upharpoonright",!0);n(l,d,f,"⇂","\\downharpoonright",!0);n(l,d,f,"⇝","\\rightsquigarrow",!0);n(l,d,f,"⇝","\\leadsto");n(l,d,f,"⇛","\\Rrightarrow",!0);n(l,d,f,"↾","\\restriction");n(l,h,v,"‘","`");n(l,h,v,"$","\\$");n(k,h,v,"$","\\$");n(k,h,v,"$","\\textdollar");n(l,h,v,"%","\\%");n(k,h,v,"%","\\%");n(l,h,v,"_","\\_");n(k,h,v,"_","\\_");n(k,h,v,"_","\\textunderscore");n(l,h,v,"∠","\\angle",!0);n(l,h,v,"∞","\\infty",!0);n(l,h,v,"′","\\prime");n(l,h,v,"△","\\triangle");n(l,h,v,"Γ","\\Gamma",!0);n(l,h,v,"Δ","\\Delta",!0);n(l,h,v,"Θ","\\Theta",!0);n(l,h,v,"Λ","\\Lambda",!0);n(l,h,v,"Ξ","\\Xi",!0);n(l,h,v,"Π","\\Pi",!0);n(l,h,v,"Σ","\\Sigma",!0);n(l,h,v,"Υ","\\Upsilon",!0);n(l,h,v,"Φ","\\Phi",!0);n(l,h,v,"Ψ","\\Psi",!0);n(l,h,v,"Ω","\\Omega",!0);n(l,h,v,"A","Α");n(l,h,v,"B","Β");n(l,h,v,"E","Ε");n(l,h,v,"Z","Ζ");n(l,h,v,"H","Η");n(l,h,v,"I","Ι");n(l,h,v,"K","Κ");n(l,h,v,"M","Μ");n(l,h,v,"N","Ν");n(l,h,v,"O","Ο");n(l,h,v,"P","Ρ");n(l,h,v,"T","Τ");n(l,h,v,"X","Χ");n(l,h,v,"¬","\\neg",!0);n(l,h,v,"¬","\\lnot");n(l,h,v,"⊤","\\top");n(l,h,v,"⊥","\\bot");n(l,h,v,"∅","\\emptyset");n(l,d,v,"∅","\\varnothing");n(l,h,R,"α","\\alpha",!0);n(l,h,R,"β","\\beta",!0);n(l,h,R,"γ","\\gamma",!0);n(l,h,R,"δ","\\delta",!0);n(l,h,R,"ϵ","\\epsilon",!0);n(l,h,R,"ζ","\\zeta",!0);n(l,h,R,"η","\\eta",!0);n(l,h,R,"θ","\\theta",!0);n(l,h,R,"ι","\\iota",!0);n(l,h,R,"κ","\\kappa",!0);n(l,h,R,"λ","\\lambda",!0);n(l,h,R,"μ","\\mu",!0);n(l,h,R,"ν","\\nu",!0);n(l,h,R,"ξ","\\xi",!0);n(l,h,R,"ο","\\omicron",!0);n(l,h,R,"π","\\pi",!0);n(l,h,R,"ρ","\\rho",!0);n(l,h,R,"σ","\\sigma",!0);n(l,h,R,"τ","\\tau",!0);n(l,h,R,"υ","\\upsilon",!0);n(l,h,R,"ϕ","\\phi",!0);n(l,h,R,"χ","\\chi",!0);n(l,h,R,"ψ","\\psi",!0);n(l,h,R,"ω","\\omega",!0);n(l,h,R,"ε","\\varepsilon",!0);n(l,h,R,"ϑ","\\vartheta",!0);n(l,h,R,"ϖ","\\varpi",!0);n(l,h,R,"ϱ","\\varrho",!0);n(l,h,R,"ς","\\varsigma",!0);n(l,h,R,"φ","\\varphi",!0);n(l,h,N,"∗","*",!0);n(l,h,N,"+","+");n(l,h,N,"−","-",!0);n(l,h,N,"⋅","\\cdot",!0);n(l,h,N,"∘","\\circ",!0);n(l,h,N,"÷","\\div",!0);n(l,h,N,"±","\\pm",!0);n(l,h,N,"×","\\times",!0);n(l,h,N,"∩","\\cap",!0);n(l,h,N,"∪","\\cup",!0);n(l,h,N,"∖","\\setminus",!0);n(l,h,N,"∧","\\land");n(l,h,N,"∨","\\lor");n(l,h,N,"∧","\\wedge",!0);n(l,h,N,"∨","\\vee",!0);n(l,h,v,"√","\\surd");n(l,h,c0,"⟨","\\langle",!0);n(l,h,c0,"∣","\\lvert");n(l,h,c0,"∥","\\lVert");n(l,h,n0,"?","?");n(l,h,n0,"!","!");n(l,h,n0,"⟩","\\rangle",!0);n(l,h,n0,"∣","\\rvert");n(l,h,n0,"∥","\\rVert");n(l,h,f,"=","=");n(l,h,f,":",":");n(l,h,f,"≈","\\approx",!0);n(l,h,f,"≅","\\cong",!0);n(l,h,f,"≥","\\ge");n(l,h,f,"≥","\\geq",!0);n(l,h,f,"←","\\gets");n(l,h,f,">","\\gt",!0);n(l,h,f,"∈","\\in",!0);n(l,h,f,"","\\@not");n(l,h,f,"⊂","\\subset",!0);n(l,h,f,"⊃","\\supset",!0);n(l,h,f,"⊆","\\subseteq",!0);n(l,h,f,"⊇","\\supseteq",!0);n(l,d,f,"⊈","\\nsubseteq",!0);n(l,d,f,"⊉","\\nsupseteq",!0);n(l,h,f,"⊨","\\models");n(l,h,f,"←","\\leftarrow",!0);n(l,h,f,"≤","\\le");n(l,h,f,"≤","\\leq",!0);n(l,h,f,"<","\\lt",!0);n(l,h,f,"→","\\rightarrow",!0);n(l,h,f,"→","\\to");n(l,d,f,"≱","\\ngeq",!0);n(l,d,f,"≰","\\nleq",!0);n(l,h,I0," ","\\ ");n(l,h,I0," ","\\space");n(l,h,I0," ","\\nobreakspace");n(k,h,I0," ","\\ ");n(k,h,I0," "," ");n(k,h,I0," ","\\space");n(k,h,I0," ","\\nobreakspace");n(l,h,I0,null,"\\nobreak");n(l,h,I0,null,"\\allowbreak");n(l,h,Re,",",",");n(l,h,Re,";",";");n(l,d,N,"⊼","\\barwedge",!0);n(l,d,N,"⊻","\\veebar",!0);n(l,h,N,"⊙","\\odot",!0);n(l,h,N,"⊕","\\oplus",!0);n(l,h,N,"⊗","\\otimes",!0);n(l,h,v,"∂","\\partial",!0);n(l,h,N,"⊘","\\oslash",!0);n(l,d,N,"⊚","\\circledcirc",!0);n(l,d,N,"⊡","\\boxdot",!0);n(l,h,N,"△","\\bigtriangleup");n(l,h,N,"▽","\\bigtriangledown");n(l,h,N,"†","\\dagger");n(l,h,N,"⋄","\\diamond");n(l,h,N,"⋆","\\star");n(l,h,N,"◃","\\triangleleft");n(l,h,N,"▹","\\triangleright");n(l,h,c0,"{","\\{");n(k,h,v,"{","\\{");n(k,h,v,"{","\\textbraceleft");n(l,h,n0,"}","\\}");n(k,h,v,"}","\\}");n(k,h,v,"}","\\textbraceright");n(l,h,c0,"{","\\lbrace");n(l,h,n0,"}","\\rbrace");n(l,h,c0,"[","\\lbrack",!0);n(k,h,v,"[","\\lbrack",!0);n(l,h,n0,"]","\\rbrack",!0);n(k,h,v,"]","\\rbrack",!0);n(l,h,c0,"(","\\lparen",!0);n(l,h,n0,")","\\rparen",!0);n(k,h,v,"<","\\textless",!0);n(k,h,v,">","\\textgreater",!0);n(l,h,c0,"⌊","\\lfloor",!0);n(l,h,n0,"⌋","\\rfloor",!0);n(l,h,c0,"⌈","\\lceil",!0);n(l,h,n0,"⌉","\\rceil",!0);n(l,h,v,"\\","\\backslash");n(l,h,v,"∣","|");n(l,h,v,"∣","\\vert");n(k,h,v,"|","\\textbar",!0);n(l,h,v,"∥","\\|");n(l,h,v,"∥","\\Vert");n(k,h,v,"∥","\\textbardbl");n(k,h,v,"~","\\textasciitilde");n(k,h,v,"\\","\\textbackslash");n(k,h,v,"^","\\textasciicircum");n(l,h,f,"↑","\\uparrow",!0);n(l,h,f,"⇑","\\Uparrow",!0);n(l,h,f,"↓","\\downarrow",!0);n(l,h,f,"⇓","\\Downarrow",!0);n(l,h,f,"↕","\\updownarrow",!0);n(l,h,f,"⇕","\\Updownarrow",!0);n(l,h,_,"∐","\\coprod");n(l,h,_,"⋁","\\bigvee");n(l,h,_,"⋀","\\bigwedge");n(l,h,_,"⨄","\\biguplus");n(l,h,_,"⋂","\\bigcap");n(l,h,_,"⋃","\\bigcup");n(l,h,_,"∫","\\int");n(l,h,_,"∫","\\intop");n(l,h,_,"∬","\\iint");n(l,h,_,"∭","\\iiint");n(l,h,_,"∏","\\prod");n(l,h,_,"∑","\\sum");n(l,h,_,"⨂","\\bigotimes");n(l,h,_,"⨁","\\bigoplus");n(l,h,_,"⨀","\\bigodot");n(l,h,_,"∮","\\oint");n(l,h,_,"∯","\\oiint");n(l,h,_,"∰","\\oiiint");n(l,h,_,"⨆","\\bigsqcup");n(l,h,_,"∫","\\smallint");n(k,h,re,"…","\\textellipsis");n(l,h,re,"…","\\mathellipsis");n(k,h,re,"…","\\ldots",!0);n(l,h,re,"…","\\ldots",!0);n(l,h,re,"⋯","\\@cdots",!0);n(l,h,re,"⋱","\\ddots",!0);n(l,h,v,"⋮","\\varvdots");n(k,h,v,"⋮","\\varvdots");n(l,h,W,"ˊ","\\acute");n(l,h,W,"ˋ","\\grave");n(l,h,W,"¨","\\ddot");n(l,h,W,"~","\\tilde");n(l,h,W,"ˉ","\\bar");n(l,h,W,"˘","\\breve");n(l,h,W,"ˇ","\\check");n(l,h,W,"^","\\hat");n(l,h,W,"⃗","\\vec");n(l,h,W,"˙","\\dot");n(l,h,W,"˚","\\mathring");n(l,h,R,"","\\@imath");n(l,h,R,"","\\@jmath");n(l,h,v,"ı","ı");n(l,h,v,"ȷ","ȷ");n(k,h,v,"ı","\\i",!0);n(k,h,v,"ȷ","\\j",!0);n(k,h,v,"ß","\\ss",!0);n(k,h,v,"æ","\\ae",!0);n(k,h,v,"œ","\\oe",!0);n(k,h,v,"ø","\\o",!0);n(k,h,v,"Æ","\\AE",!0);n(k,h,v,"Œ","\\OE",!0);n(k,h,v,"Ø","\\O",!0);n(k,h,W,"ˊ","\\'");n(k,h,W,"ˋ","\\`");n(k,h,W,"ˆ","\\^");n(k,h,W,"˜","\\~");n(k,h,W,"ˉ","\\=");n(k,h,W,"˘","\\u");n(k,h,W,"˙","\\.");n(k,h,W,"¸","\\c");n(k,h,W,"˚","\\r");n(k,h,W,"ˇ","\\v");n(k,h,W,"¨",'\\"');n(k,h,W,"˝","\\H");n(k,h,W,"◯","\\textcircled");var kr={"--":!0,"---":!0,"``":!0,"''":!0};n(k,h,v,"–","--",!0);n(k,h,v,"–","\\textendash");n(k,h,v,"—","---",!0);n(k,h,v,"—","\\textemdash");n(k,h,v,"‘","`",!0);n(k,h,v,"‘","\\textquoteleft");n(k,h,v,"’","'",!0);n(k,h,v,"’","\\textquoteright");n(k,h,v,"“","``",!0);n(k,h,v,"“","\\textquotedblleft");n(k,h,v,"”","''",!0);n(k,h,v,"”","\\textquotedblright");n(l,h,v,"°","\\degree",!0);n(k,h,v,"°","\\degree");n(k,h,v,"°","\\textdegree",!0);n(l,h,v,"£","\\pounds");n(l,h,v,"£","\\mathsterling",!0);n(k,h,v,"£","\\pounds");n(k,h,v,"£","\\textsterling",!0);n(l,d,v,"✠","\\maltese");n(k,d,v,"✠","\\maltese");var Gt='0123456789/@."';for(var Ye=0;Ye<Gt.length;Ye++){var Vt=Gt.charAt(Ye);n(l,h,v,Vt,Vt)}var Ut='0123456789!@*()-=+";:?/.,';for(var Xe=0;Xe<Ut.length;Xe++){var Yt=Ut.charAt(Xe);n(k,h,v,Yt,Yt)}var Be="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";for(var $e=0;$e<Be.length;$e++){var ge=Be.charAt($e);n(l,h,R,ge,ge),n(k,h,v,ge,ge)}n(l,d,v,"C","ℂ");n(k,d,v,"C","ℂ");n(l,d,v,"H","ℍ");n(k,d,v,"H","ℍ");n(l,d,v,"N","ℕ");n(k,d,v,"N","ℕ");n(l,d,v,"P","ℙ");n(k,d,v,"P","ℙ");n(l,d,v,"Q","ℚ");n(k,d,v,"Q","ℚ");n(l,d,v,"R","ℝ");n(k,d,v,"R","ℝ");n(l,d,v,"Z","ℤ");n(k,d,v,"Z","ℤ");n(l,h,R,"h","ℎ");n(k,h,R,"h","ℎ");var D="";for(var a0=0;a0<Be.length;a0++){var J=Be.charAt(a0);D=String.fromCharCode(55349,56320+a0),n(l,h,R,J,D),n(k,h,v,J,D),D=String.fromCharCode(55349,56372+a0),n(l,h,R,J,D),n(k,h,v,J,D),D=String.fromCharCode(55349,56424+a0),n(l,h,R,J,D),n(k,h,v,J,D),D=String.fromCharCode(55349,56580+a0),n(l,h,R,J,D),n(k,h,v,J,D),D=String.fromCharCode(55349,56684+a0),n(l,h,R,J,D),n(k,h,v,J,D),D=String.fromCharCode(55349,56736+a0),n(l,h,R,J,D),n(k,h,v,J,D),D=String.fromCharCode(55349,56788+a0),n(l,h,R,J,D),n(k,h,v,J,D),D=String.fromCharCode(55349,56840+a0),n(l,h,R,J,D),n(k,h,v,J,D),D=String.fromCharCode(55349,56944+a0),n(l,h,R,J,D),n(k,h,v,J,D),a0<26&&(D=String.fromCharCode(55349,56632+a0),n(l,h,R,J,D),n(k,h,v,J,D),D=String.fromCharCode(55349,56476+a0),n(l,h,R,J,D),n(k,h,v,J,D))}D="𝕜";n(l,h,R,"k",D);n(k,h,v,"k",D);for(var X0=0;X0<10;X0++){var L0=X0.toString();D=String.fromCharCode(55349,57294+X0),n(l,h,R,L0,D),n(k,h,v,L0,D),D=String.fromCharCode(55349,57314+X0),n(l,h,R,L0,D),n(k,h,v,L0,D),D=String.fromCharCode(55349,57324+X0),n(l,h,R,L0,D),n(k,h,v,L0,D),D=String.fromCharCode(55349,57334+X0),n(l,h,R,L0,D),n(k,h,v,L0,D)}var lt="ÐÞþ";for(var We=0;We<lt.length;We++){var be=lt.charAt(We);n(l,h,R,be,be),n(k,h,v,be,be)}var ye=[["mathbf","textbf","Main-Bold"],["mathbf","textbf","Main-Bold"],["mathnormal","textit","Math-Italic"],["mathnormal","textit","Math-Italic"],["boldsymbol","boldsymbol","Main-BoldItalic"],["boldsymbol","boldsymbol","Main-BoldItalic"],["mathscr","textscr","Script-Regular"],["","",""],["","",""],["","",""],["mathfrak","textfrak","Fraktur-Regular"],["mathfrak","textfrak","Fraktur-Regular"],["mathbb","textbb","AMS-Regular"],["mathbb","textbb","AMS-Regular"],["mathboldfrak","textboldfrak","Fraktur-Regular"],["mathboldfrak","textboldfrak","Fraktur-Regular"],["mathsf","textsf","SansSerif-Regular"],["mathsf","textsf","SansSerif-Regular"],["mathboldsf","textboldsf","SansSerif-Bold"],["mathboldsf","textboldsf","SansSerif-Bold"],["mathitsf","textitsf","SansSerif-Italic"],["mathitsf","textitsf","SansSerif-Italic"],["","",""],["","",""],["mathtt","texttt","Typewriter-Regular"],["mathtt","texttt","Typewriter-Regular"]],Xt=[["mathbf","textbf","Main-Bold"],["","",""],["mathsf","textsf","SansSerif-Regular"],["mathboldsf","textboldsf","SansSerif-Bold"],["mathtt","texttt","Typewriter-Regular"]],Ja=function(e,t){var a=e.charCodeAt(0),i=e.charCodeAt(1),s=(a-55296)*1024+(i-56320)+65536,o=t==="math"?0:1;if(119808<=s&&s<120484){var m=Math.floor((s-119808)/26);return[ye[m][2],ye[m][o]]}else if(120782<=s&&s<=120831){var c=Math.floor((s-120782)/10);return[Xt[c][2],Xt[c][o]]}else{if(s===120485||s===120486)return[ye[0][2],ye[0][o]];if(120486<s&&s<120782)return["",""];throw new M("Unsupported character: "+e)}},Ie=function(e,t,a){return $[a][e]&&$[a][e].replace&&(e=$[a][e].replace),{value:e,metrics:pt(e,t,a)}},b0=function(e,t,a,i,s){var o=Ie(e,t,a),m=o.metrics;e=o.value;var c;if(m){var p=m.italic;(a==="text"||i&&i.font==="mathit")&&(p=0),c=new p0(e,m.height,m.depth,p,m.skew,m.width,s)}else typeof console<"u"&&console.warn("No character metrics "+("for '"+e+"' in style '"+t+"' and mode '"+a+"'")),c=new p0(e,0,0,0,0,0,s);if(i){c.maxFontSize=i.sizeMultiplier,i.style.isTight()&&c.classes.push("mtight");var g=i.getColor();g&&(c.style.color=g)}return c},Qa=function(e,t,a,i){return i===void 0&&(i=[]),a.font==="boldsymbol"&&Ie(e,"Main-Bold",t).metrics?b0(e,"Main-Bold",t,a,i.concat(["mathbf"])):e==="\\"||$[t][e].font==="main"?b0(e,"Main-Regular",t,a,i):b0(e,"AMS-Regular",t,a,i.concat(["amsrm"]))},_a=function(e,t,a,i,s){return s!=="textord"&&Ie(e,"Math-BoldItalic",t).metrics?{fontName:"Math-BoldItalic",fontClass:"boldsymbol"}:{fontName:"Main-Bold",fontClass:"mathbf"}},e1=function(e,t,a){var i=e.mode,s=e.text,o=["mord"],m=i==="math"||i==="text"&&t.font,c=m?t.font:t.fontFamily,p="",g="";if(s.charCodeAt(0)===55349&&([p,g]=Ja(s,i)),p.length>0)return b0(s,p,i,t,o.concat(g));if(c){var y,x;if(c==="boldsymbol"){var w=_a(s,i,t,o,a);y=w.fontName,x=[w.fontClass]}else m?(y=zr[c].fontName,x=[c]):(y=we(c,t.fontWeight,t.fontShape),x=[c,t.fontWeight,t.fontShape]);if(Ie(s,y,i).metrics)return b0(s,y,i,t,o.concat(x));if(kr.hasOwnProperty(s)&&y.slice(0,10)==="Typewriter"){for(var z=[],A=0;A<s.length;A++)z.push(b0(s[A],y,i,t,o.concat(x)));return Mr(z)}}if(a==="mathord")return b0(s,"Math-Italic",i,t,o.concat(["mathnormal"]));if(a==="textord"){var C=$[i][s]&&$[i][s].font;if(C==="ams"){var q=we("amsrm",t.fontWeight,t.fontShape);return b0(s,q,i,t,o.concat("amsrm",t.fontWeight,t.fontShape))}else if(C==="main"||!C){var E=we("textrm",t.fontWeight,t.fontShape);return b0(s,E,i,t,o.concat(t.fontWeight,t.fontShape))}else{var O=we(C,t.fontWeight,t.fontShape);return b0(s,O,i,t,o.concat(O,t.fontWeight,t.fontShape))}}else throw new Error("unexpected type: "+a+" in makeOrd")},t1=(r,e)=>{if(P0(r.classes)!==P0(e.classes)||r.skew!==e.skew||r.maxFontSize!==e.maxFontSize)return!1;if(r.classes.length===1){var t=r.classes[0];if(t==="mbin"||t==="mord")return!1}for(var a in r.style)if(r.style.hasOwnProperty(a)&&r.style[a]!==e.style[a])return!1;for(var i in e.style)if(e.style.hasOwnProperty(i)&&r.style[i]!==e.style[i])return!1;return!0},r1=r=>{for(var e=0;e<r.length-1;e++){var t=r[e],a=r[e+1];t instanceof p0&&a instanceof p0&&t1(t,a)&&(t.text+=a.text,t.height=Math.max(t.height,a.height),t.depth=Math.max(t.depth,a.depth),t.italic=a.italic,r.splice(e+1,1),e--)}return r},gt=function(e){for(var t=0,a=0,i=0,s=0;s<e.children.length;s++){var o=e.children[s];o.height>t&&(t=o.height),o.depth>a&&(a=o.depth),o.maxFontSize>i&&(i=o.maxFontSize)}e.height=t,e.depth=a,e.maxFontSize=i},l0=function(e,t,a,i){var s=new me(e,t,a,i);return gt(s),s},Sr=(r,e,t,a)=>new me(r,e,t,a),a1=function(e,t,a){var i=l0([e],[],t);return i.height=Math.max(a||t.fontMetrics().defaultRuleThickness,t.minRuleThickness),i.style.borderBottomWidth=T(i.height),i.maxFontSize=1,i},i1=function(e,t,a,i){var s=new vt(e,t,a,i);return gt(s),s},Mr=function(e){var t=new he(e);return gt(t),t},n1=function(e,t){return e instanceof he?l0([],[e],t):e},s1=function(e){if(e.positionType==="individualShift"){for(var t=e.children,a=[t[0]],i=-t[0].shift-t[0].elem.depth,s=i,o=1;o<t.length;o++){var m=-t[o].shift-s-t[o].elem.depth,c=m-(t[o-1].elem.height+t[o-1].elem.depth);s=s+m,a.push({type:"kern",size:c}),a.push(t[o])}return{children:a,depth:i}}var p;if(e.positionType==="top"){for(var g=e.positionData,y=0;y<e.children.length;y++){var x=e.children[y];g-=x.type==="kern"?x.size:x.elem.height+x.elem.depth}p=g}else if(e.positionType==="bottom")p=-e.positionData;else{var w=e.children[0];if(w.type!=="elem")throw new Error('First child must have type "elem".');if(e.positionType==="shift")p=-w.elem.depth-e.positionData;else if(e.positionType==="firstBaseline")p=-w.elem.depth;else throw new Error("Invalid positionType "+e.positionType+".")}return{children:e.children,depth:p}},l1=function(e,t){for(var{children:a,depth:i}=s1(e),s=0,o=0;o<a.length;o++){var m=a[o];if(m.type==="elem"){var c=m.elem;s=Math.max(s,c.maxFontSize,c.height)}}s+=2;var p=l0(["pstrut"],[]);p.style.height=T(s);for(var g=[],y=i,x=i,w=i,z=0;z<a.length;z++){var A=a[z];if(A.type==="kern")w+=A.size;else{var C=A.elem,q=A.wrapperClasses||[],E=A.wrapperStyle||{},O=l0(q,[p,C],void 0,E);O.style.top=T(-s-w-C.depth),A.marginLeft&&(O.style.marginLeft=A.marginLeft),A.marginRight&&(O.style.marginRight=A.marginRight),g.push(O),w+=C.height+C.depth}y=Math.min(y,w),x=Math.max(x,w)}var V=l0(["vlist"],g);V.style.height=T(x);var L;if(y<0){var U=l0([],[]),P=l0(["vlist"],[U]);P.style.height=T(-y);var j=l0(["vlist-s"],[new p0("​")]);L=[l0(["vlist-r"],[V,j]),l0(["vlist-r"],[P])]}else L=[l0(["vlist-r"],[V])];var Y=l0(["vlist-t"],L);return L.length===2&&Y.classes.push("vlist-t2"),Y.height=x,Y.depth=-y,Y},o1=(r,e)=>{var t=l0(["mspace"],[],e),a=K(r,e);return t.style.marginRight=T(a),t},we=function(e,t,a){var i="";switch(e){case"amsrm":i="AMS";break;case"textrm":i="Main";break;case"textsf":i="SansSerif";break;case"texttt":i="Typewriter";break;default:i=e}var s;return t==="textbf"&&a==="textit"?s="BoldItalic":t==="textbf"?s="Bold":t==="textit"?s="Italic":s="Regular",i+"-"+s},zr={mathbf:{variant:"bold",fontName:"Main-Bold"},mathrm:{variant:"normal",fontName:"Main-Regular"},textit:{variant:"italic",fontName:"Main-Italic"},mathit:{variant:"italic",fontName:"Main-Italic"},mathnormal:{variant:"italic",fontName:"Math-Italic"},mathsfit:{variant:"sans-serif-italic",fontName:"SansSerif-Italic"},mathbb:{variant:"double-struck",fontName:"AMS-Regular"},mathcal:{variant:"script",fontName:"Caligraphic-Regular"},mathfrak:{variant:"fraktur",fontName:"Fraktur-Regular"},mathscr:{variant:"script",fontName:"Script-Regular"},mathsf:{variant:"sans-serif",fontName:"SansSerif-Regular"},mathtt:{variant:"monospace",fontName:"Typewriter-Regular"}},Tr={vec:["vec",.471,.714],oiintSize1:["oiintSize1",.957,.499],oiintSize2:["oiintSize2",1.472,.659],oiiintSize1:["oiiintSize1",1.304,.499],oiiintSize2:["oiiintSize2",1.98,.659]},h1=function(e,t){var[a,i,s]=Tr[e],o=new G0(a),m=new C0([o],{width:T(i),height:T(s),style:"width:"+T(i),viewBox:"0 0 "+1e3*i+" "+1e3*s,preserveAspectRatio:"xMinYMin"}),c=Sr(["overlay"],[m],t);return c.height=s,c.style.height=T(s),c.style.width=T(i),c},b={fontMap:zr,makeSymbol:b0,mathsym:Qa,makeSpan:l0,makeSvgSpan:Sr,makeLineSpan:a1,makeAnchor:i1,makeFragment:Mr,wrapFragment:n1,makeVList:l1,makeOrd:e1,makeGlue:o1,staticSvg:h1,svgData:Tr,tryCombineChars:r1},Z={number:3,unit:"mu"},$0={number:4,unit:"mu"},T0={number:5,unit:"mu"},m1={mord:{mop:Z,mbin:$0,mrel:T0,minner:Z},mop:{mord:Z,mop:Z,mrel:T0,minner:Z},mbin:{mord:$0,mop:$0,mopen:$0,minner:$0},mrel:{mord:T0,mop:T0,mopen:T0,minner:T0},mopen:{},mclose:{mop:Z,mbin:$0,mrel:T0,minner:Z},mpunct:{mord:Z,mop:Z,mrel:T0,mopen:Z,mclose:Z,mpunct:Z,minner:Z},minner:{mord:Z,mop:Z,mbin:$0,mrel:T0,mopen:Z,mpunct:Z,minner:Z}},u1={mord:{mop:Z},mop:{mord:Z,mop:Z},mbin:{},mrel:{},mopen:{},mclose:{mop:Z},mpunct:{},minner:{mop:Z}},Ar={},Ne={},Ce={};function B(r){for(var{type:e,names:t,props:a,handler:i,htmlBuilder:s,mathmlBuilder:o}=r,m={type:e,numArgs:a.numArgs,argTypes:a.argTypes,allowedInArgument:!!a.allowedInArgument,allowedInText:!!a.allowedInText,allowedInMath:a.allowedInMath===void 0?!0:a.allowedInMath,numOptionalArgs:a.numOptionalArgs||0,infix:!!a.infix,primitive:!!a.primitive,handler:i},c=0;c<t.length;++c)Ar[t[c]]=m;e&&(s&&(Ne[e]=s),o&&(Ce[e]=o))}function W0(r){var{type:e,htmlBuilder:t,mathmlBuilder:a}=r;B({type:e,names:[],props:{numArgs:0},handler(){throw new Error("Should never be called.")},htmlBuilder:t,mathmlBuilder:a})}var qe=function(e){return e.type==="ordgroup"&&e.body.length===1?e.body[0]:e},Q=function(e){return e.type==="ordgroup"?e.body:[e]},q0=b.makeSpan,c1=["leftmost","mbin","mopen","mrel","mop","mpunct"],d1=["rightmost","mrel","mclose","mpunct"],f1={display:I.DISPLAY,text:I.TEXT,script:I.SCRIPT,scriptscript:I.SCRIPTSCRIPT},p1={mord:"mord",mop:"mop",mbin:"mbin",mrel:"mrel",mopen:"mopen",mclose:"mclose",mpunct:"mpunct",minner:"minner"},t0=function(e,t,a,i){i===void 0&&(i=[null,null]);for(var s=[],o=0;o<e.length;o++){var m=F(e[o],t);if(m instanceof he){var c=m.children;s.push(...c)}else s.push(m)}if(b.tryCombineChars(s),!a)return s;var p=t;if(e.length===1){var g=e[0];g.type==="sizing"?p=t.havingSize(g.size):g.type==="styling"&&(p=t.havingStyle(f1[g.style]))}var y=q0([i[0]||"leftmost"],[],t),x=q0([i[1]||"rightmost"],[],t),w=a==="root";return $t(s,(z,A)=>{var C=A.classes[0],q=z.classes[0];C==="mbin"&&d1.includes(q)?A.classes[0]="mord":q==="mbin"&&c1.includes(C)&&(z.classes[0]="mord")},{node:y},x,w),$t(s,(z,A)=>{var C=ot(A),q=ot(z),E=C&&q?z.hasClass("mtight")?u1[C][q]:m1[C][q]:null;if(E)return b.makeGlue(E,p)},{node:y},x,w),s},$t=function r(e,t,a,i,s){i&&e.push(i);for(var o=0;o<e.length;o++){var m=e[o],c=Br(m);if(c){r(c.children,t,a,null,s);continue}var p=!m.hasClass("mspace");if(p){var g=t(m,a.node);g&&(a.insertAfter?a.insertAfter(g):(e.unshift(g),o++))}p?a.node=m:s&&m.hasClass("newline")&&(a.node=q0(["leftmost"])),a.insertAfter=(y=>x=>{e.splice(y+1,0,x),o++})(o)}i&&e.pop()},Br=function(e){return e instanceof he||e instanceof vt||e instanceof me&&e.hasClass("enclosing")?e:null},v1=function r(e,t){var a=Br(e);if(a){var i=a.children;if(i.length){if(t==="right")return r(i[i.length-1],"right");if(t==="left")return r(i[0],"left")}}return e},ot=function(e,t){return e?(t&&(e=v1(e,t)),p1[e.classes[0]]||null):null},oe=function(e,t){var a=["nulldelimiter"].concat(e.baseSizingClasses());return q0(t.concat(a))},F=function(e,t,a){if(!e)return q0();if(Ne[e.type]){var i=Ne[e.type](e,t);if(a&&t.size!==a.size){i=q0(t.sizingClasses(a),[i],t);var s=t.sizeMultiplier/a.sizeMultiplier;i.height*=s,i.depth*=s}return i}else throw new M("Got group of unknown type: '"+e.type+"'")};function xe(r,e){var t=q0(["base"],r,e),a=q0(["strut"]);return a.style.height=T(t.height+t.depth),t.depth&&(a.style.verticalAlign=T(-t.depth)),t.children.unshift(a),t}function ht(r,e){var t=null;r.length===1&&r[0].type==="tag"&&(t=r[0].tag,r=r[0].body);var a=t0(r,e,"root"),i;a.length===2&&a[1].hasClass("tag")&&(i=a.pop());for(var s=[],o=[],m=0;m<a.length;m++)if(o.push(a[m]),a[m].hasClass("mbin")||a[m].hasClass("mrel")||a[m].hasClass("allowbreak")){for(var c=!1;m<a.length-1&&a[m+1].hasClass("mspace")&&!a[m+1].hasClass("newline");)m++,o.push(a[m]),a[m].hasClass("nobreak")&&(c=!0);c||(s.push(xe(o,e)),o=[])}else a[m].hasClass("newline")&&(o.pop(),o.length>0&&(s.push(xe(o,e)),o=[]),s.push(a[m]));o.length>0&&s.push(xe(o,e));var p;t?(p=xe(t0(t,e,!0)),p.classes=["tag"],s.push(p)):i&&s.push(i);var g=q0(["katex-html"],s);if(g.setAttribute("aria-hidden","true"),p){var y=p.children[0];y.style.height=T(g.height+g.depth),g.depth&&(y.style.verticalAlign=T(-g.depth))}return g}function Nr(r){return new he(r)}class m0{constructor(e,t,a){this.type=void 0,this.attributes=void 0,this.children=void 0,this.classes=void 0,this.type=e,this.attributes={},this.children=t||[],this.classes=a||[]}setAttribute(e,t){this.attributes[e]=t}getAttribute(e){return this.attributes[e]}toNode(){var e=document.createElementNS("http://www.w3.org/1998/Math/MathML",this.type);for(var t in this.attributes)Object.prototype.hasOwnProperty.call(this.attributes,t)&&e.setAttribute(t,this.attributes[t]);this.classes.length>0&&(e.className=P0(this.classes));for(var a=0;a<this.children.length;a++)if(this.children[a]instanceof x0&&this.children[a+1]instanceof x0){for(var i=this.children[a].toText()+this.children[++a].toText();this.children[a+1]instanceof x0;)i+=this.children[++a].toText();e.appendChild(new x0(i).toNode())}else e.appendChild(this.children[a].toNode());return e}toMarkup(){var e="<"+this.type;for(var t in this.attributes)Object.prototype.hasOwnProperty.call(this.attributes,t)&&(e+=" "+t+'="',e+=G.escape(this.attributes[t]),e+='"');this.classes.length>0&&(e+=' class ="'+G.escape(P0(this.classes))+'"'),e+=">";for(var a=0;a<this.children.length;a++)e+=this.children[a].toMarkup();return e+="</"+this.type+">",e}toText(){return this.children.map(e=>e.toText()).join("")}}class x0{constructor(e){this.text=void 0,this.text=e}toNode(){return document.createTextNode(this.text)}toMarkup(){return G.escape(this.toText())}toText(){return this.text}}class g1{constructor(e){this.width=void 0,this.character=void 0,this.width=e,e>=.05555&&e<=.05556?this.character=" ":e>=.1666&&e<=.1667?this.character=" ":e>=.2222&&e<=.2223?this.character=" ":e>=.2777&&e<=.2778?this.character="  ":e>=-.05556&&e<=-.05555?this.character=" ⁣":e>=-.1667&&e<=-.1666?this.character=" ⁣":e>=-.2223&&e<=-.2222?this.character=" ⁣":e>=-.2778&&e<=-.2777?this.character=" ⁣":this.character=null}toNode(){if(this.character)return document.createTextNode(this.character);var e=document.createElementNS("http://www.w3.org/1998/Math/MathML","mspace");return e.setAttribute("width",T(this.width)),e}toMarkup(){return this.character?"<mtext>"+this.character+"</mtext>":'<mspace width="'+T(this.width)+'"/>'}toText(){return this.character?this.character:" "}}var S={MathNode:m0,TextNode:x0,SpaceNode:g1,newDocumentFragment:Nr},v0=function(e,t,a){return $[t][e]&&$[t][e].replace&&e.charCodeAt(0)!==55349&&!(kr.hasOwnProperty(e)&&a&&(a.fontFamily&&a.fontFamily.slice(4,6)==="tt"||a.font&&a.font.slice(4,6)==="tt"))&&(e=$[t][e].replace),new S.TextNode(e)},bt=function(e){return e.length===1?e[0]:new S.MathNode("mrow",e)},yt=function(e,t){if(t.fontFamily==="texttt")return"monospace";if(t.fontFamily==="textsf")return t.fontShape==="textit"&&t.fontWeight==="textbf"?"sans-serif-bold-italic":t.fontShape==="textit"?"sans-serif-italic":t.fontWeight==="textbf"?"bold-sans-serif":"sans-serif";if(t.fontShape==="textit"&&t.fontWeight==="textbf")return"bold-italic";if(t.fontShape==="textit")return"italic";if(t.fontWeight==="textbf")return"bold";var a=t.font;if(!a||a==="mathnormal")return null;var i=e.mode;if(a==="mathit")return"italic";if(a==="boldsymbol")return e.type==="textord"?"bold":"bold-italic";if(a==="mathbf")return"bold";if(a==="mathbb")return"double-struck";if(a==="mathsfit")return"sans-serif-italic";if(a==="mathfrak")return"fraktur";if(a==="mathscr"||a==="mathcal")return"script";if(a==="mathsf")return"sans-serif";if(a==="mathtt")return"monospace";var s=e.text;if(["\\imath","\\jmath"].includes(s))return null;$[i][s]&&$[i][s].replace&&(s=$[i][s].replace);var o=b.fontMap[a].fontName;return pt(s,o,i)?b.fontMap[a].variant:null};function je(r){if(!r)return!1;if(r.type==="mi"&&r.children.length===1){var e=r.children[0];return e instanceof x0&&e.text==="."}else if(r.type==="mo"&&r.children.length===1&&r.getAttribute("separator")==="true"&&r.getAttribute("lspace")==="0em"&&r.getAttribute("rspace")==="0em"){var t=r.children[0];return t instanceof x0&&t.text===","}else return!1}var h0=function(e,t,a){if(e.length===1){var i=X(e[0],t);return a&&i instanceof m0&&i.type==="mo"&&(i.setAttribute("lspace","0em"),i.setAttribute("rspace","0em")),[i]}for(var s=[],o,m=0;m<e.length;m++){var c=X(e[m],t);if(c instanceof m0&&o instanceof m0){if(c.type==="mtext"&&o.type==="mtext"&&c.getAttribute("mathvariant")===o.getAttribute("mathvariant")){o.children.push(...c.children);continue}else if(c.type==="mn"&&o.type==="mn"){o.children.push(...c.children);continue}else if(je(c)&&o.type==="mn"){o.children.push(...c.children);continue}else if(c.type==="mn"&&je(o))c.children=[...o.children,...c.children],s.pop();else if((c.type==="msup"||c.type==="msub")&&c.children.length>=1&&(o.type==="mn"||je(o))){var p=c.children[0];p instanceof m0&&p.type==="mn"&&(p.children=[...o.children,...p.children],s.pop())}else if(o.type==="mi"&&o.children.length===1){var g=o.children[0];if(g instanceof x0&&g.text==="̸"&&(c.type==="mo"||c.type==="mi"||c.type==="mn")){var y=c.children[0];y instanceof x0&&y.text.length>0&&(y.text=y.text.slice(0,1)+"̸"+y.text.slice(1),s.pop())}}}s.push(c),o=c}return s},V0=function(e,t,a){return bt(h0(e,t,a))},X=function(e,t){if(!e)return new S.MathNode("mrow");if(Ce[e.type]){var a=Ce[e.type](e,t);return a}else throw new M("Got group of unknown type: '"+e.type+"'")};function Wt(r,e,t,a,i){var s=h0(r,t),o;s.length===1&&s[0]instanceof m0&&["mrow","mtable"].includes(s[0].type)?o=s[0]:o=new S.MathNode("mrow",s);var m=new S.MathNode("annotation",[new S.TextNode(e)]);m.setAttribute("encoding","application/x-tex");var c=new S.MathNode("semantics",[o,m]),p=new S.MathNode("math",[c]);p.setAttribute("xmlns","http://www.w3.org/1998/Math/MathML"),a&&p.setAttribute("display","block");var g=i?"katex":"katex-mathml";return b.makeSpan([g],[p])}var Cr=function(e){return new A0({style:e.displayMode?I.DISPLAY:I.TEXT,maxSize:e.maxSize,minRuleThickness:e.minRuleThickness})},qr=function(e,t){if(t.displayMode){var a=["katex-display"];t.leqno&&a.push("leqno"),t.fleqn&&a.push("fleqn"),e=b.makeSpan(a,[e])}return e},b1=function(e,t,a){var i=Cr(a),s;if(a.output==="mathml")return Wt(e,t,i,a.displayMode,!0);if(a.output==="html"){var o=ht(e,i);s=b.makeSpan(["katex"],[o])}else{var m=Wt(e,t,i,a.displayMode,!1),c=ht(e,i);s=b.makeSpan(["katex"],[m,c])}return qr(s,a)},y1=function(e,t,a){var i=Cr(a),s=ht(e,i),o=b.makeSpan(["katex"],[s]);return qr(o,a)},w1={widehat:"^",widecheck:"ˇ",widetilde:"~",utilde:"~",overleftarrow:"←",underleftarrow:"←",xleftarrow:"←",overrightarrow:"→",underrightarrow:"→",xrightarrow:"→",underbrace:"⏟",overbrace:"⏞",overgroup:"⏠",undergroup:"⏡",overleftrightarrow:"↔",underleftrightarrow:"↔",xleftrightarrow:"↔",Overrightarrow:"⇒",xRightarrow:"⇒",overleftharpoon:"↼",xleftharpoonup:"↼",overrightharpoon:"⇀",xrightharpoonup:"⇀",xLeftarrow:"⇐",xLeftrightarrow:"⇔",xhookleftarrow:"↩",xhookrightarrow:"↪",xmapsto:"↦",xrightharpoondown:"⇁",xleftharpoondown:"↽",xrightleftharpoons:"⇌",xleftrightharpoons:"⇋",xtwoheadleftarrow:"↞",xtwoheadrightarrow:"↠",xlongequal:"=",xtofrom:"⇄",xrightleftarrows:"⇄",xrightequilibrium:"⇌",xleftequilibrium:"⇋","\\cdrightarrow":"→","\\cdleftarrow":"←","\\cdlongequal":"="},x1=function(e){var t=new S.MathNode("mo",[new S.TextNode(w1[e.replace(/^\\/,"")])]);return t.setAttribute("stretchy","true"),t},k1={overrightarrow:[["rightarrow"],.888,522,"xMaxYMin"],overleftarrow:[["leftarrow"],.888,522,"xMinYMin"],underrightarrow:[["rightarrow"],.888,522,"xMaxYMin"],underleftarrow:[["leftarrow"],.888,522,"xMinYMin"],xrightarrow:[["rightarrow"],1.469,522,"xMaxYMin"],"\\cdrightarrow":[["rightarrow"],3,522,"xMaxYMin"],xleftarrow:[["leftarrow"],1.469,522,"xMinYMin"],"\\cdleftarrow":[["leftarrow"],3,522,"xMinYMin"],Overrightarrow:[["doublerightarrow"],.888,560,"xMaxYMin"],xRightarrow:[["doublerightarrow"],1.526,560,"xMaxYMin"],xLeftarrow:[["doubleleftarrow"],1.526,560,"xMinYMin"],overleftharpoon:[["leftharpoon"],.888,522,"xMinYMin"],xleftharpoonup:[["leftharpoon"],.888,522,"xMinYMin"],xleftharpoondown:[["leftharpoondown"],.888,522,"xMinYMin"],overrightharpoon:[["rightharpoon"],.888,522,"xMaxYMin"],xrightharpoonup:[["rightharpoon"],.888,522,"xMaxYMin"],xrightharpoondown:[["rightharpoondown"],.888,522,"xMaxYMin"],xlongequal:[["longequal"],.888,334,"xMinYMin"],"\\cdlongequal":[["longequal"],3,334,"xMinYMin"],xtwoheadleftarrow:[["twoheadleftarrow"],.888,334,"xMinYMin"],xtwoheadrightarrow:[["twoheadrightarrow"],.888,334,"xMaxYMin"],overleftrightarrow:[["leftarrow","rightarrow"],.888,522],overbrace:[["leftbrace","midbrace","rightbrace"],1.6,548],underbrace:[["leftbraceunder","midbraceunder","rightbraceunder"],1.6,548],underleftrightarrow:[["leftarrow","rightarrow"],.888,522],xleftrightarrow:[["leftarrow","rightarrow"],1.75,522],xLeftrightarrow:[["doubleleftarrow","doublerightarrow"],1.75,560],xrightleftharpoons:[["leftharpoondownplus","rightharpoonplus"],1.75,716],xleftrightharpoons:[["leftharpoonplus","rightharpoondownplus"],1.75,716],xhookleftarrow:[["leftarrow","righthook"],1.08,522],xhookrightarrow:[["lefthook","rightarrow"],1.08,522],overlinesegment:[["leftlinesegment","rightlinesegment"],.888,522],underlinesegment:[["leftlinesegment","rightlinesegment"],.888,522],overgroup:[["leftgroup","rightgroup"],.888,342],undergroup:[["leftgroupunder","rightgroupunder"],.888,342],xmapsto:[["leftmapsto","rightarrow"],1.5,522],xtofrom:[["leftToFrom","rightToFrom"],1.75,528],xrightleftarrows:[["baraboveleftarrow","rightarrowabovebar"],1.75,901],xrightequilibrium:[["baraboveshortleftharpoon","rightharpoonaboveshortbar"],1.75,716],xleftequilibrium:[["shortbaraboveleftharpoon","shortrightharpoonabovebar"],1.75,716]},S1=function(e){return e.type==="ordgroup"?e.body.length:1},M1=function(e,t){function a(){var m=4e5,c=e.label.slice(1);if(["widehat","widecheck","widetilde","utilde"].includes(c)){var p=e,g=S1(p.base),y,x,w;if(g>5)c==="widehat"||c==="widecheck"?(y=420,m=2364,w=.42,x=c+"4"):(y=312,m=2340,w=.34,x="tilde4");else{var z=[1,1,2,2,3,3][g];c==="widehat"||c==="widecheck"?(m=[0,1062,2364,2364,2364][z],y=[0,239,300,360,420][z],w=[0,.24,.3,.3,.36,.42][z],x=c+z):(m=[0,600,1033,2339,2340][z],y=[0,260,286,306,312][z],w=[0,.26,.286,.3,.306,.34][z],x="tilde"+z)}var A=new G0(x),C=new C0([A],{width:"100%",height:T(w),viewBox:"0 0 "+m+" "+y,preserveAspectRatio:"none"});return{span:b.makeSvgSpan([],[C],t),minWidth:0,height:w}}else{var q=[],E=k1[c],[O,V,L]=E,U=L/1e3,P=O.length,j,Y;if(P===1){var z0=E[3];j=["hide-tail"],Y=[z0]}else if(P===2)j=["halfarrow-left","halfarrow-right"],Y=["xMinYMin","xMaxYMin"];else if(P===3)j=["brace-left","brace-center","brace-right"],Y=["xMinYMin","xMidYMin","xMaxYMin"];else throw new Error(`Correct katexImagesData or update code here to support
-                    `+P+" children.");for(var r0=0;r0<P;r0++){var e0=new G0(O[r0]),Y0=new C0([e0],{width:"400em",height:T(U),viewBox:"0 0 "+m+" "+L,preserveAspectRatio:Y[r0]+" slice"}),s0=b.makeSvgSpan([j[r0]],[Y0],t);if(P===1)return{span:s0,minWidth:V,height:U};s0.style.height=T(U),q.push(s0)}return{span:b.makeSpan(["stretchy"],q,t),minWidth:V,height:U}}}var{span:i,minWidth:s,height:o}=a();return i.height=o,i.style.height=T(o),s>0&&(i.style.minWidth=T(s)),i},z1=function(e,t,a,i,s){var o,m=e.height+e.depth+a+i;if(/fbox|color|angl/.test(t)){if(o=b.makeSpan(["stretchy",t],[],s),t==="fbox"){var c=s.color&&s.getColor();c&&(o.style.borderColor=c)}}else{var p=[];/^[bx]cancel$/.test(t)&&p.push(new st({x1:"0",y1:"0",x2:"100%",y2:"100%","stroke-width":"0.046em"})),/^x?cancel$/.test(t)&&p.push(new st({x1:"0",y1:"100%",x2:"100%",y2:"0","stroke-width":"0.046em"}));var g=new C0(p,{width:"100%",height:T(m)});o=b.makeSvgSpan([],[g],s)}return o.height=m,o.style.height=T(m),o},R0={encloseSpan:z1,mathMLnode:x1,svgSpan:M1};function H(r,e){if(!r||r.type!==e)throw new Error("Expected node of type "+e+", but got "+(r?"node of type "+r.type:String(r)));return r}function wt(r){var e=De(r);if(!e)throw new Error("Expected node of symbol group type, but got "+(r?"node of type "+r.type:String(r)));return e}function De(r){return r&&(r.type==="atom"||Ka.hasOwnProperty(r.type))?r:null}var xt=(r,e)=>{var t,a,i;r&&r.type==="supsub"?(a=H(r.base,"accent"),t=a.base,r.base=t,i=ja(F(r,e)),r.base=a):(a=H(r,"accent"),t=a.base);var s=F(t,e.havingCrampedStyle()),o=a.isShifty&&G.isCharacterBox(t),m=0;if(o){var c=G.getBaseElem(t),p=F(c,e.havingCrampedStyle());m=Pt(p).skew}var g=a.label==="\\c",y=g?s.height+s.depth:Math.min(s.height,e.fontMetrics().xHeight),x;if(a.isStretchy)x=R0.svgSpan(a,e),x=b.makeVList({positionType:"firstBaseline",children:[{type:"elem",elem:s},{type:"elem",elem:x,wrapperClasses:["svg-align"],wrapperStyle:m>0?{width:"calc(100% - "+T(2*m)+")",marginLeft:T(2*m)}:void 0}]},e);else{var w,z;a.label==="\\vec"?(w=b.staticSvg("vec",e),z=b.svgData.vec[1]):(w=b.makeOrd({mode:a.mode,text:a.label},e,"textord"),w=Pt(w),w.italic=0,z=w.width,g&&(y+=w.depth)),x=b.makeSpan(["accent-body"],[w]);var A=a.label==="\\textcircled";A&&(x.classes.push("accent-full"),y=s.height);var C=m;A||(C-=z/2),x.style.left=T(C),a.label==="\\textcircled"&&(x.style.top=".2em"),x=b.makeVList({positionType:"firstBaseline",children:[{type:"elem",elem:s},{type:"kern",size:-y},{type:"elem",elem:x}]},e)}var q=b.makeSpan(["mord","accent"],[x],e);return i?(i.children[0]=q,i.height=Math.max(q.height,i.height),i.classes[0]="mord",i):q},Rr=(r,e)=>{var t=r.isStretchy?R0.mathMLnode(r.label):new S.MathNode("mo",[v0(r.label,r.mode)]),a=new S.MathNode("mover",[X(r.base,e),t]);return a.setAttribute("accent","true"),a},T1=new RegExp(["\\acute","\\grave","\\ddot","\\tilde","\\bar","\\breve","\\check","\\hat","\\vec","\\dot","\\mathring"].map(r=>"\\"+r).join("|"));B({type:"accent",names:["\\acute","\\grave","\\ddot","\\tilde","\\bar","\\breve","\\check","\\hat","\\vec","\\dot","\\mathring","\\widecheck","\\widehat","\\widetilde","\\overrightarrow","\\overleftarrow","\\Overrightarrow","\\overleftrightarrow","\\overgroup","\\overlinesegment","\\overleftharpoon","\\overrightharpoon"],props:{numArgs:1},handler:(r,e)=>{var t=qe(e[0]),a=!T1.test(r.funcName),i=!a||r.funcName==="\\widehat"||r.funcName==="\\widetilde"||r.funcName==="\\widecheck";return{type:"accent",mode:r.parser.mode,label:r.funcName,isStretchy:a,isShifty:i,base:t}},htmlBuilder:xt,mathmlBuilder:Rr});B({type:"accent",names:["\\'","\\`","\\^","\\~","\\=","\\u","\\.",'\\"',"\\c","\\r","\\H","\\v","\\textcircled"],props:{numArgs:1,allowedInText:!0,allowedInMath:!0,argTypes:["primitive"]},handler:(r,e)=>{var t=e[0],a=r.parser.mode;return a==="math"&&(r.parser.settings.reportNonstrict("mathVsTextAccents","LaTeX's accent "+r.funcName+" works only in text mode"),a="text"),{type:"accent",mode:a,label:r.funcName,isStretchy:!1,isShifty:!0,base:t}},htmlBuilder:xt,mathmlBuilder:Rr});B({type:"accentUnder",names:["\\underleftarrow","\\underrightarrow","\\underleftrightarrow","\\undergroup","\\underlinesegment","\\utilde"],props:{numArgs:1},handler:(r,e)=>{var{parser:t,funcName:a}=r,i=e[0];return{type:"accentUnder",mode:t.mode,label:a,base:i}},htmlBuilder:(r,e)=>{var t=F(r.base,e),a=R0.svgSpan(r,e),i=r.label==="\\utilde"?.12:0,s=b.makeVList({positionType:"top",positionData:t.height,children:[{type:"elem",elem:a,wrapperClasses:["svg-align"]},{type:"kern",size:i},{type:"elem",elem:t}]},e);return b.makeSpan(["mord","accentunder"],[s],e)},mathmlBuilder:(r,e)=>{var t=R0.mathMLnode(r.label),a=new S.MathNode("munder",[X(r.base,e),t]);return a.setAttribute("accentunder","true"),a}});var ke=r=>{var e=new S.MathNode("mpadded",r?[r]:[]);return e.setAttribute("width","+0.6em"),e.setAttribute("lspace","0.3em"),e};B({type:"xArrow",names:["\\xleftarrow","\\xrightarrow","\\xLeftarrow","\\xRightarrow","\\xleftrightarrow","\\xLeftrightarrow","\\xhookleftarrow","\\xhookrightarrow","\\xmapsto","\\xrightharpoondown","\\xrightharpoonup","\\xleftharpoondown","\\xleftharpoonup","\\xrightleftharpoons","\\xleftrightharpoons","\\xlongequal","\\xtwoheadrightarrow","\\xtwoheadleftarrow","\\xtofrom","\\xrightleftarrows","\\xrightequilibrium","\\xleftequilibrium","\\\\cdrightarrow","\\\\cdleftarrow","\\\\cdlongequal"],props:{numArgs:1,numOptionalArgs:1},handler(r,e,t){var{parser:a,funcName:i}=r;return{type:"xArrow",mode:a.mode,label:i,body:e[0],below:t[0]}},htmlBuilder(r,e){var t=e.style,a=e.havingStyle(t.sup()),i=b.wrapFragment(F(r.body,a,e),e),s=r.label.slice(0,2)==="\\x"?"x":"cd";i.classes.push(s+"-arrow-pad");var o;r.below&&(a=e.havingStyle(t.sub()),o=b.wrapFragment(F(r.below,a,e),e),o.classes.push(s+"-arrow-pad"));var m=R0.svgSpan(r,e),c=-e.fontMetrics().axisHeight+.5*m.height,p=-e.fontMetrics().axisHeight-.5*m.height-.111;(i.depth>.25||r.label==="\\xleftequilibrium")&&(p-=i.depth);var g;if(o){var y=-e.fontMetrics().axisHeight+o.height+.5*m.height+.111;g=b.makeVList({positionType:"individualShift",children:[{type:"elem",elem:i,shift:p},{type:"elem",elem:m,shift:c},{type:"elem",elem:o,shift:y}]},e)}else g=b.makeVList({positionType:"individualShift",children:[{type:"elem",elem:i,shift:p},{type:"elem",elem:m,shift:c}]},e);return g.children[0].children[0].children[1].classes.push("svg-align"),b.makeSpan(["mrel","x-arrow"],[g],e)},mathmlBuilder(r,e){var t=R0.mathMLnode(r.label);t.setAttribute("minsize",r.label.charAt(0)==="x"?"1.75em":"3.0em");var a;if(r.body){var i=ke(X(r.body,e));if(r.below){var s=ke(X(r.below,e));a=new S.MathNode("munderover",[t,s,i])}else a=new S.MathNode("mover",[t,i])}else if(r.below){var o=ke(X(r.below,e));a=new S.MathNode("munder",[t,o])}else a=ke(),a=new S.MathNode("mover",[t,a]);return a}});var A1=b.makeSpan;function Ir(r,e){var t=t0(r.body,e,!0);return A1([r.mclass],t,e)}function Dr(r,e){var t,a=h0(r.body,e);return r.mclass==="minner"?t=new S.MathNode("mpadded",a):r.mclass==="mord"?r.isCharacterBox?(t=a[0],t.type="mi"):t=new S.MathNode("mi",a):(r.isCharacterBox?(t=a[0],t.type="mo"):t=new S.MathNode("mo",a),r.mclass==="mbin"?(t.attributes.lspace="0.22em",t.attributes.rspace="0.22em"):r.mclass==="mpunct"?(t.attributes.lspace="0em",t.attributes.rspace="0.17em"):r.mclass==="mopen"||r.mclass==="mclose"?(t.attributes.lspace="0em",t.attributes.rspace="0em"):r.mclass==="minner"&&(t.attributes.lspace="0.0556em",t.attributes.width="+0.1111em")),t}B({type:"mclass",names:["\\mathord","\\mathbin","\\mathrel","\\mathopen","\\mathclose","\\mathpunct","\\mathinner"],props:{numArgs:1,primitive:!0},handler(r,e){var{parser:t,funcName:a}=r,i=e[0];return{type:"mclass",mode:t.mode,mclass:"m"+a.slice(5),body:Q(i),isCharacterBox:G.isCharacterBox(i)}},htmlBuilder:Ir,mathmlBuilder:Dr});var Ee=r=>{var e=r.type==="ordgroup"&&r.body.length?r.body[0]:r;return e.type==="atom"&&(e.family==="bin"||e.family==="rel")?"m"+e.family:"mord"};B({type:"mclass",names:["\\@binrel"],props:{numArgs:2},handler(r,e){var{parser:t}=r;return{type:"mclass",mode:t.mode,mclass:Ee(e[0]),body:Q(e[1]),isCharacterBox:G.isCharacterBox(e[1])}}});B({type:"mclass",names:["\\stackrel","\\overset","\\underset"],props:{numArgs:2},handler(r,e){var{parser:t,funcName:a}=r,i=e[1],s=e[0],o;a!=="\\stackrel"?o=Ee(i):o="mrel";var m={type:"op",mode:i.mode,limits:!0,alwaysHandleSupSub:!0,parentIsSupSub:!1,symbol:!1,suppressBaseShift:a!=="\\stackrel",body:Q(i)},c={type:"supsub",mode:s.mode,base:m,sup:a==="\\underset"?null:s,sub:a==="\\underset"?s:null};return{type:"mclass",mode:t.mode,mclass:o,body:[c],isCharacterBox:G.isCharacterBox(c)}},htmlBuilder:Ir,mathmlBuilder:Dr});B({type:"pmb",names:["\\pmb"],props:{numArgs:1,allowedInText:!0},handler(r,e){var{parser:t}=r;return{type:"pmb",mode:t.mode,mclass:Ee(e[0]),body:Q(e[0])}},htmlBuilder(r,e){var t=t0(r.body,e,!0),a=b.makeSpan([r.mclass],t,e);return a.style.textShadow="0.02em 0.01em 0.04px",a},mathmlBuilder(r,e){var t=h0(r.body,e),a=new S.MathNode("mstyle",t);return a.setAttribute("style","text-shadow: 0.02em 0.01em 0.04px"),a}});var B1={">":"\\\\cdrightarrow","<":"\\\\cdleftarrow","=":"\\\\cdlongequal",A:"\\uparrow",V:"\\downarrow","|":"\\Vert",".":"no arrow"},jt=()=>({type:"styling",body:[],mode:"math",style:"display"}),Zt=r=>r.type==="textord"&&r.text==="@",N1=(r,e)=>(r.type==="mathord"||r.type==="atom")&&r.text===e;function C1(r,e,t){var a=B1[r];switch(a){case"\\\\cdrightarrow":case"\\\\cdleftarrow":return t.callFunction(a,[e[0]],[e[1]]);case"\\uparrow":case"\\downarrow":{var i=t.callFunction("\\\\cdleft",[e[0]],[]),s={type:"atom",text:a,mode:"math",family:"rel"},o=t.callFunction("\\Big",[s],[]),m=t.callFunction("\\\\cdright",[e[1]],[]),c={type:"ordgroup",mode:"math",body:[i,o,m]};return t.callFunction("\\\\cdparent",[c],[])}case"\\\\cdlongequal":return t.callFunction("\\\\cdlongequal",[],[]);case"\\Vert":{var p={type:"textord",text:"\\Vert",mode:"math"};return t.callFunction("\\Big",[p],[])}default:return{type:"textord",text:" ",mode:"math"}}}function q1(r){var e=[];for(r.gullet.beginGroup(),r.gullet.macros.set("\\cr","\\\\\\relax"),r.gullet.beginGroup();;){e.push(r.parseExpression(!1,"\\\\")),r.gullet.endGroup(),r.gullet.beginGroup();var t=r.fetch().text;if(t==="&"||t==="\\\\")r.consume();else if(t==="\\end"){e[e.length-1].length===0&&e.pop();break}else throw new M("Expected \\\\ or \\cr or \\end",r.nextToken)}for(var a=[],i=[a],s=0;s<e.length;s++){for(var o=e[s],m=jt(),c=0;c<o.length;c++)if(!Zt(o[c]))m.body.push(o[c]);else{a.push(m),c+=1;var p=wt(o[c]).text,g=new Array(2);if(g[0]={type:"ordgroup",mode:"math",body:[]},g[1]={type:"ordgroup",mode:"math",body:[]},!("=|.".indexOf(p)>-1))if("<>AV".indexOf(p)>-1)for(var y=0;y<2;y++){for(var x=!0,w=c+1;w<o.length;w++){if(N1(o[w],p)){x=!1,c=w;break}if(Zt(o[w]))throw new M("Missing a "+p+" character to complete a CD arrow.",o[w]);g[y].body.push(o[w])}if(x)throw new M("Missing a "+p+" character to complete a CD arrow.",o[c])}else throw new M('Expected one of "<>AV=|." after @',o[c]);var z=C1(p,g,r),A={type:"styling",body:[z],mode:"math",style:"display"};a.push(A),m=jt()}s%2===0?a.push(m):a.shift(),a=[],i.push(a)}r.gullet.endGroup(),r.gullet.endGroup();var C=new Array(i[0].length).fill({type:"align",align:"c",pregap:.25,postgap:.25});return{type:"array",mode:"math",body:i,arraystretch:1,addJot:!0,rowGaps:[null],cols:C,colSeparationType:"CD",hLinesBeforeRow:new Array(i.length+1).fill([])}}B({type:"cdlabel",names:["\\\\cdleft","\\\\cdright"],props:{numArgs:1},handler(r,e){var{parser:t,funcName:a}=r;return{type:"cdlabel",mode:t.mode,side:a.slice(4),label:e[0]}},htmlBuilder(r,e){var t=e.havingStyle(e.style.sup()),a=b.wrapFragment(F(r.label,t,e),e);return a.classes.push("cd-label-"+r.side),a.style.bottom=T(.8-a.depth),a.height=0,a.depth=0,a},mathmlBuilder(r,e){var t=new S.MathNode("mrow",[X(r.label,e)]);return t=new S.MathNode("mpadded",[t]),t.setAttribute("width","0"),r.side==="left"&&t.setAttribute("lspace","-1width"),t.setAttribute("voffset","0.7em"),t=new S.MathNode("mstyle",[t]),t.setAttribute("displaystyle","false"),t.setAttribute("scriptlevel","1"),t}});B({type:"cdlabelparent",names:["\\\\cdparent"],props:{numArgs:1},handler(r,e){var{parser:t}=r;return{type:"cdlabelparent",mode:t.mode,fragment:e[0]}},htmlBuilder(r,e){var t=b.wrapFragment(F(r.fragment,e),e);return t.classes.push("cd-vert-arrow"),t},mathmlBuilder(r,e){return new S.MathNode("mrow",[X(r.fragment,e)])}});B({type:"textord",names:["\\@char"],props:{numArgs:1,allowedInText:!0},handler(r,e){for(var{parser:t}=r,a=H(e[0],"ordgroup"),i=a.body,s="",o=0;o<i.length;o++){var m=H(i[o],"textord");s+=m.text}var c=parseInt(s),p;if(isNaN(c))throw new M("\\@char has non-numeric argument "+s);if(c<0||c>=1114111)throw new M("\\@char with invalid code point "+s);return c<=65535?p=String.fromCharCode(c):(c-=65536,p=String.fromCharCode((c>>10)+55296,(c&1023)+56320)),{type:"textord",mode:t.mode,text:p}}});var Er=(r,e)=>{var t=t0(r.body,e.withColor(r.color),!1);return b.makeFragment(t)},Or=(r,e)=>{var t=h0(r.body,e.withColor(r.color)),a=new S.MathNode("mstyle",t);return a.setAttribute("mathcolor",r.color),a};B({type:"color",names:["\\textcolor"],props:{numArgs:2,allowedInText:!0,argTypes:["color","original"]},handler(r,e){var{parser:t}=r,a=H(e[0],"color-token").color,i=e[1];return{type:"color",mode:t.mode,color:a,body:Q(i)}},htmlBuilder:Er,mathmlBuilder:Or});B({type:"color",names:["\\color"],props:{numArgs:1,allowedInText:!0,argTypes:["color"]},handler(r,e){var{parser:t,breakOnTokenText:a}=r,i=H(e[0],"color-token").color;t.gullet.macros.set("\\current@color",i);var s=t.parseExpression(!0,a);return{type:"color",mode:t.mode,color:i,body:s}},htmlBuilder:Er,mathmlBuilder:Or});B({type:"cr",names:["\\\\"],props:{numArgs:0,numOptionalArgs:0,allowedInText:!0},handler(r,e,t){var{parser:a}=r,i=a.gullet.future().text==="["?a.parseSizeGroup(!0):null,s=!a.settings.displayMode||!a.settings.useStrictBehavior("newLineInDisplayMode","In LaTeX, \\\\ or \\newline does nothing in display mode");return{type:"cr",mode:a.mode,newLine:s,size:i&&H(i,"size").value}},htmlBuilder(r,e){var t=b.makeSpan(["mspace"],[],e);return r.newLine&&(t.classes.push("newline"),r.size&&(t.style.marginTop=T(K(r.size,e)))),t},mathmlBuilder(r,e){var t=new S.MathNode("mspace");return r.newLine&&(t.setAttribute("linebreak","newline"),r.size&&t.setAttribute("height",T(K(r.size,e)))),t}});var mt={"\\global":"\\global","\\long":"\\\\globallong","\\\\globallong":"\\\\globallong","\\def":"\\gdef","\\gdef":"\\gdef","\\edef":"\\xdef","\\xdef":"\\xdef","\\let":"\\\\globallet","\\futurelet":"\\\\globalfuture"},Hr=r=>{var e=r.text;if(/^(?:[\\{}$&#^_]|EOF)$/.test(e))throw new M("Expected a control sequence",r);return e},R1=r=>{var e=r.gullet.popToken();return e.text==="="&&(e=r.gullet.popToken(),e.text===" "&&(e=r.gullet.popToken())),e},Lr=(r,e,t,a)=>{var i=r.gullet.macros.get(t.text);i==null&&(t.noexpand=!0,i={tokens:[t],numArgs:0,unexpandable:!r.gullet.isExpandable(t.text)}),r.gullet.macros.set(e,i,a)};B({type:"internal",names:["\\global","\\long","\\\\globallong"],props:{numArgs:0,allowedInText:!0},handler(r){var{parser:e,funcName:t}=r;e.consumeSpaces();var a=e.fetch();if(mt[a.text])return(t==="\\global"||t==="\\\\globallong")&&(a.text=mt[a.text]),H(e.parseFunction(),"internal");throw new M("Invalid token after macro prefix",a)}});B({type:"internal",names:["\\def","\\gdef","\\edef","\\xdef"],props:{numArgs:0,allowedInText:!0,primitive:!0},handler(r){var{parser:e,funcName:t}=r,a=e.gullet.popToken(),i=a.text;if(/^(?:[\\{}$&#^_]|EOF)$/.test(i))throw new M("Expected a control sequence",a);for(var s=0,o,m=[[]];e.gullet.future().text!=="{";)if(a=e.gullet.popToken(),a.text==="#"){if(e.gullet.future().text==="{"){o=e.gullet.future(),m[s].push("{");break}if(a=e.gullet.popToken(),!/^[1-9]$/.test(a.text))throw new M('Invalid argument number "'+a.text+'"');if(parseInt(a.text)!==s+1)throw new M('Argument number "'+a.text+'" out of order');s++,m.push([])}else{if(a.text==="EOF")throw new M("Expected a macro definition");m[s].push(a.text)}var{tokens:c}=e.gullet.consumeArg();return o&&c.unshift(o),(t==="\\edef"||t==="\\xdef")&&(c=e.gullet.expandTokens(c),c.reverse()),e.gullet.macros.set(i,{tokens:c,numArgs:s,delimiters:m},t===mt[t]),{type:"internal",mode:e.mode}}});B({type:"internal",names:["\\let","\\\\globallet"],props:{numArgs:0,allowedInText:!0,primitive:!0},handler(r){var{parser:e,funcName:t}=r,a=Hr(e.gullet.popToken());e.gullet.consumeSpaces();var i=R1(e);return Lr(e,a,i,t==="\\\\globallet"),{type:"internal",mode:e.mode}}});B({type:"internal",names:["\\futurelet","\\\\globalfuture"],props:{numArgs:0,allowedInText:!0,primitive:!0},handler(r){var{parser:e,funcName:t}=r,a=Hr(e.gullet.popToken()),i=e.gullet.popToken(),s=e.gullet.popToken();return Lr(e,a,s,t==="\\\\globalfuture"),e.gullet.pushToken(s),e.gullet.pushToken(i),{type:"internal",mode:e.mode}}});var ne=function(e,t,a){var i=$.math[e]&&$.math[e].replace,s=pt(i||e,t,a);if(!s)throw new Error("Unsupported symbol "+e+" and font size "+t+".");return s},kt=function(e,t,a,i){var s=a.havingBaseStyle(t),o=b.makeSpan(i.concat(s.sizingClasses(a)),[e],a),m=s.sizeMultiplier/a.sizeMultiplier;return o.height*=m,o.depth*=m,o.maxFontSize=s.sizeMultiplier,o},Fr=function(e,t,a){var i=t.havingBaseStyle(a),s=(1-t.sizeMultiplier/i.sizeMultiplier)*t.fontMetrics().axisHeight;e.classes.push("delimcenter"),e.style.top=T(s),e.height-=s,e.depth+=s},I1=function(e,t,a,i,s,o){var m=b.makeSymbol(e,"Main-Regular",s,i),c=kt(m,t,i,o);return a&&Fr(c,i,t),c},D1=function(e,t,a,i){return b.makeSymbol(e,"Size"+t+"-Regular",a,i)},Pr=function(e,t,a,i,s,o){var m=D1(e,t,s,i),c=kt(b.makeSpan(["delimsizing","size"+t],[m],i),I.TEXT,i,o);return a&&Fr(c,i,I.TEXT),c},Ze=function(e,t,a){var i;t==="Size1-Regular"?i="delim-size1":i="delim-size4";var s=b.makeSpan(["delimsizinginner",i],[b.makeSpan([],[b.makeSymbol(e,t,a)])]);return{type:"elem",elem:s}},Ke=function(e,t,a){var i=w0["Size4-Regular"][e.charCodeAt(0)]?w0["Size4-Regular"][e.charCodeAt(0)][4]:w0["Size1-Regular"][e.charCodeAt(0)][4],s=new G0("inner",Fa(e,Math.round(1e3*t))),o=new C0([s],{width:T(i),height:T(t),style:"width:"+T(i),viewBox:"0 0 "+1e3*i+" "+Math.round(1e3*t),preserveAspectRatio:"xMinYMin"}),m=b.makeSvgSpan([],[o],a);return m.height=t,m.style.height=T(t),m.style.width=T(i),{type:"elem",elem:m}},ut=.008,Se={type:"kern",size:-1*ut},E1=["|","\\lvert","\\rvert","\\vert"],O1=["\\|","\\lVert","\\rVert","\\Vert"],Gr=function(e,t,a,i,s,o){var m,c,p,g,y="",x=0;m=p=g=e,c=null;var w="Size1-Regular";e==="\\uparrow"?p=g="⏐":e==="\\Uparrow"?p=g="‖":e==="\\downarrow"?m=p="⏐":e==="\\Downarrow"?m=p="‖":e==="\\updownarrow"?(m="\\uparrow",p="⏐",g="\\downarrow"):e==="\\Updownarrow"?(m="\\Uparrow",p="‖",g="\\Downarrow"):E1.includes(e)?(p="∣",y="vert",x=333):O1.includes(e)?(p="∥",y="doublevert",x=556):e==="["||e==="\\lbrack"?(m="⎡",p="⎢",g="⎣",w="Size4-Regular",y="lbrack",x=667):e==="]"||e==="\\rbrack"?(m="⎤",p="⎥",g="⎦",w="Size4-Regular",y="rbrack",x=667):e==="\\lfloor"||e==="⌊"?(p=m="⎢",g="⎣",w="Size4-Regular",y="lfloor",x=667):e==="\\lceil"||e==="⌈"?(m="⎡",p=g="⎢",w="Size4-Regular",y="lceil",x=667):e==="\\rfloor"||e==="⌋"?(p=m="⎥",g="⎦",w="Size4-Regular",y="rfloor",x=667):e==="\\rceil"||e==="⌉"?(m="⎤",p=g="⎥",w="Size4-Regular",y="rceil",x=667):e==="("||e==="\\lparen"?(m="⎛",p="⎜",g="⎝",w="Size4-Regular",y="lparen",x=875):e===")"||e==="\\rparen"?(m="⎞",p="⎟",g="⎠",w="Size4-Regular",y="rparen",x=875):e==="\\{"||e==="\\lbrace"?(m="⎧",c="⎨",g="⎩",p="⎪",w="Size4-Regular"):e==="\\}"||e==="\\rbrace"?(m="⎫",c="⎬",g="⎭",p="⎪",w="Size4-Regular"):e==="\\lgroup"||e==="⟮"?(m="⎧",g="⎩",p="⎪",w="Size4-Regular"):e==="\\rgroup"||e==="⟯"?(m="⎫",g="⎭",p="⎪",w="Size4-Regular"):e==="\\lmoustache"||e==="⎰"?(m="⎧",g="⎭",p="⎪",w="Size4-Regular"):(e==="\\rmoustache"||e==="⎱")&&(m="⎫",g="⎩",p="⎪",w="Size4-Regular");var z=ne(m,w,s),A=z.height+z.depth,C=ne(p,w,s),q=C.height+C.depth,E=ne(g,w,s),O=E.height+E.depth,V=0,L=1;if(c!==null){var U=ne(c,w,s);V=U.height+U.depth,L=2}var P=A+O+V,j=Math.max(0,Math.ceil((t-P)/(L*q))),Y=P+j*L*q,z0=i.fontMetrics().axisHeight;a&&(z0*=i.sizeMultiplier);var r0=Y/2-z0,e0=[];if(y.length>0){var Y0=Y-A-O,s0=Math.round(Y*1e3),g0=Pa(y,Math.round(Y0*1e3)),D0=new G0(y,g0),j0=(x/1e3).toFixed(3)+"em",Z0=(s0/1e3).toFixed(3)+"em",Fe=new C0([D0],{width:j0,height:Z0,viewBox:"0 0 "+x+" "+s0}),E0=b.makeSvgSpan([],[Fe],i);E0.height=s0/1e3,E0.style.width=j0,E0.style.height=Z0,e0.push({type:"elem",elem:E0})}else{if(e0.push(Ze(g,w,s)),e0.push(Se),c===null){var O0=Y-A-O+2*ut;e0.push(Ke(p,O0,i))}else{var d0=(Y-A-O-V)/2+2*ut;e0.push(Ke(p,d0,i)),e0.push(Se),e0.push(Ze(c,w,s)),e0.push(Se),e0.push(Ke(p,d0,i))}e0.push(Se),e0.push(Ze(m,w,s))}var ie=i.havingBaseStyle(I.TEXT),Pe=b.makeVList({positionType:"bottom",positionData:r0,children:e0},ie);return kt(b.makeSpan(["delimsizing","mult"],[Pe],ie),I.TEXT,i,o)},Je=80,Qe=.08,_e=function(e,t,a,i,s){var o=La(e,i,a),m=new G0(e,o),c=new C0([m],{width:"400em",height:T(t),viewBox:"0 0 400000 "+a,preserveAspectRatio:"xMinYMin slice"});return b.makeSvgSpan(["hide-tail"],[c],s)},H1=function(e,t){var a=t.havingBaseSizing(),i=Xr("\\surd",e*a.sizeMultiplier,Yr,a),s=a.sizeMultiplier,o=Math.max(0,t.minRuleThickness-t.fontMetrics().sqrtRuleThickness),m,c=0,p=0,g=0,y;return i.type==="small"?(g=1e3+1e3*o+Je,e<1?s=1:e<1.4&&(s=.7),c=(1+o+Qe)/s,p=(1+o)/s,m=_e("sqrtMain",c,g,o,t),m.style.minWidth="0.853em",y=.833/s):i.type==="large"?(g=(1e3+Je)*se[i.size],p=(se[i.size]+o)/s,c=(se[i.size]+o+Qe)/s,m=_e("sqrtSize"+i.size,c,g,o,t),m.style.minWidth="1.02em",y=1/s):(c=e+o+Qe,p=e+o,g=Math.floor(1e3*e+o)+Je,m=_e("sqrtTall",c,g,o,t),m.style.minWidth="0.742em",y=1.056),m.height=p,m.style.height=T(c),{span:m,advanceWidth:y,ruleWidth:(t.fontMetrics().sqrtRuleThickness+o)*s}},Vr=["(","\\lparen",")","\\rparen","[","\\lbrack","]","\\rbrack","\\{","\\lbrace","\\}","\\rbrace","\\lfloor","\\rfloor","⌊","⌋","\\lceil","\\rceil","⌈","⌉","\\surd"],L1=["\\uparrow","\\downarrow","\\updownarrow","\\Uparrow","\\Downarrow","\\Updownarrow","|","\\|","\\vert","\\Vert","\\lvert","\\rvert","\\lVert","\\rVert","\\lgroup","\\rgroup","⟮","⟯","\\lmoustache","\\rmoustache","⎰","⎱"],Ur=["<",">","\\langle","\\rangle","/","\\backslash","\\lt","\\gt"],se=[0,1.2,1.8,2.4,3],F1=function(e,t,a,i,s){if(e==="<"||e==="\\lt"||e==="⟨"?e="\\langle":(e===">"||e==="\\gt"||e==="⟩")&&(e="\\rangle"),Vr.includes(e)||Ur.includes(e))return Pr(e,t,!1,a,i,s);if(L1.includes(e))return Gr(e,se[t],!1,a,i,s);throw new M("Illegal delimiter: '"+e+"'")},P1=[{type:"small",style:I.SCRIPTSCRIPT},{type:"small",style:I.SCRIPT},{type:"small",style:I.TEXT},{type:"large",size:1},{type:"large",size:2},{type:"large",size:3},{type:"large",size:4}],G1=[{type:"small",style:I.SCRIPTSCRIPT},{type:"small",style:I.SCRIPT},{type:"small",style:I.TEXT},{type:"stack"}],Yr=[{type:"small",style:I.SCRIPTSCRIPT},{type:"small",style:I.SCRIPT},{type:"small",style:I.TEXT},{type:"large",size:1},{type:"large",size:2},{type:"large",size:3},{type:"large",size:4},{type:"stack"}],V1=function(e){if(e.type==="small")return"Main-Regular";if(e.type==="large")return"Size"+e.size+"-Regular";if(e.type==="stack")return"Size4-Regular";throw new Error("Add support for delim type '"+e.type+"' here.")},Xr=function(e,t,a,i){for(var s=Math.min(2,3-i.style.size),o=s;o<a.length&&a[o].type!=="stack";o++){var m=ne(e,V1(a[o]),"math"),c=m.height+m.depth;if(a[o].type==="small"){var p=i.havingBaseStyle(a[o].style);c*=p.sizeMultiplier}if(c>t)return a[o]}return a[a.length-1]},$r=function(e,t,a,i,s,o){e==="<"||e==="\\lt"||e==="⟨"?e="\\langle":(e===">"||e==="\\gt"||e==="⟩")&&(e="\\rangle");var m;Ur.includes(e)?m=P1:Vr.includes(e)?m=Yr:m=G1;var c=Xr(e,t,m,i);return c.type==="small"?I1(e,c.style,a,i,s,o):c.type==="large"?Pr(e,c.size,a,i,s,o):Gr(e,t,a,i,s,o)},U1=function(e,t,a,i,s,o){var m=i.fontMetrics().axisHeight*i.sizeMultiplier,c=901,p=5/i.fontMetrics().ptPerEm,g=Math.max(t-m,a+m),y=Math.max(g/500*c,2*g-p);return $r(e,y,!0,i,s,o)},N0={sqrtImage:H1,sizedDelim:F1,sizeToMaxHeight:se,customSizedDelim:$r,leftRightDelim:U1},Kt={"\\bigl":{mclass:"mopen",size:1},"\\Bigl":{mclass:"mopen",size:2},"\\biggl":{mclass:"mopen",size:3},"\\Biggl":{mclass:"mopen",size:4},"\\bigr":{mclass:"mclose",size:1},"\\Bigr":{mclass:"mclose",size:2},"\\biggr":{mclass:"mclose",size:3},"\\Biggr":{mclass:"mclose",size:4},"\\bigm":{mclass:"mrel",size:1},"\\Bigm":{mclass:"mrel",size:2},"\\biggm":{mclass:"mrel",size:3},"\\Biggm":{mclass:"mrel",size:4},"\\big":{mclass:"mord",size:1},"\\Big":{mclass:"mord",size:2},"\\bigg":{mclass:"mord",size:3},"\\Bigg":{mclass:"mord",size:4}},Y1=["(","\\lparen",")","\\rparen","[","\\lbrack","]","\\rbrack","\\{","\\lbrace","\\}","\\rbrace","\\lfloor","\\rfloor","⌊","⌋","\\lceil","\\rceil","⌈","⌉","<",">","\\langle","⟨","\\rangle","⟩","\\lt","\\gt","\\lvert","\\rvert","\\lVert","\\rVert","\\lgroup","\\rgroup","⟮","⟯","\\lmoustache","\\rmoustache","⎰","⎱","/","\\backslash","|","\\vert","\\|","\\Vert","\\uparrow","\\Uparrow","\\downarrow","\\Downarrow","\\updownarrow","\\Updownarrow","."];function Oe(r,e){var t=De(r);if(t&&Y1.includes(t.text))return t;throw t?new M("Invalid delimiter '"+t.text+"' after '"+e.funcName+"'",r):new M("Invalid delimiter type '"+r.type+"'",r)}B({type:"delimsizing",names:["\\bigl","\\Bigl","\\biggl","\\Biggl","\\bigr","\\Bigr","\\biggr","\\Biggr","\\bigm","\\Bigm","\\biggm","\\Biggm","\\big","\\Big","\\bigg","\\Bigg"],props:{numArgs:1,argTypes:["primitive"]},handler:(r,e)=>{var t=Oe(e[0],r);return{type:"delimsizing",mode:r.parser.mode,size:Kt[r.funcName].size,mclass:Kt[r.funcName].mclass,delim:t.text}},htmlBuilder:(r,e)=>r.delim==="."?b.makeSpan([r.mclass]):N0.sizedDelim(r.delim,r.size,e,r.mode,[r.mclass]),mathmlBuilder:r=>{var e=[];r.delim!=="."&&e.push(v0(r.delim,r.mode));var t=new S.MathNode("mo",e);r.mclass==="mopen"||r.mclass==="mclose"?t.setAttribute("fence","true"):t.setAttribute("fence","false"),t.setAttribute("stretchy","true");var a=T(N0.sizeToMaxHeight[r.size]);return t.setAttribute("minsize",a),t.setAttribute("maxsize",a),t}});function Jt(r){if(!r.body)throw new Error("Bug: The leftright ParseNode wasn't fully parsed.")}B({type:"leftright-right",names:["\\right"],props:{numArgs:1,primitive:!0},handler:(r,e)=>{var t=r.parser.gullet.macros.get("\\current@color");if(t&&typeof t!="string")throw new M("\\current@color set to non-string in \\right");return{type:"leftright-right",mode:r.parser.mode,delim:Oe(e[0],r).text,color:t}}});B({type:"leftright",names:["\\left"],props:{numArgs:1,primitive:!0},handler:(r,e)=>{var t=Oe(e[0],r),a=r.parser;++a.leftrightDepth;var i=a.parseExpression(!1);--a.leftrightDepth,a.expect("\\right",!1);var s=H(a.parseFunction(),"leftright-right");return{type:"leftright",mode:a.mode,body:i,left:t.text,right:s.delim,rightColor:s.color}},htmlBuilder:(r,e)=>{Jt(r);for(var t=t0(r.body,e,!0,["mopen","mclose"]),a=0,i=0,s=!1,o=0;o<t.length;o++)t[o].isMiddle?s=!0:(a=Math.max(t[o].height,a),i=Math.max(t[o].depth,i));a*=e.sizeMultiplier,i*=e.sizeMultiplier;var m;if(r.left==="."?m=oe(e,["mopen"]):m=N0.leftRightDelim(r.left,a,i,e,r.mode,["mopen"]),t.unshift(m),s)for(var c=1;c<t.length;c++){var p=t[c],g=p.isMiddle;g&&(t[c]=N0.leftRightDelim(g.delim,a,i,g.options,r.mode,[]))}var y;if(r.right===".")y=oe(e,["mclose"]);else{var x=r.rightColor?e.withColor(r.rightColor):e;y=N0.leftRightDelim(r.right,a,i,x,r.mode,["mclose"])}return t.push(y),b.makeSpan(["minner"],t,e)},mathmlBuilder:(r,e)=>{Jt(r);var t=h0(r.body,e);if(r.left!=="."){var a=new S.MathNode("mo",[v0(r.left,r.mode)]);a.setAttribute("fence","true"),t.unshift(a)}if(r.right!=="."){var i=new S.MathNode("mo",[v0(r.right,r.mode)]);i.setAttribute("fence","true"),r.rightColor&&i.setAttribute("mathcolor",r.rightColor),t.push(i)}return bt(t)}});B({type:"middle",names:["\\middle"],props:{numArgs:1,primitive:!0},handler:(r,e)=>{var t=Oe(e[0],r);if(!r.parser.leftrightDepth)throw new M("\\middle without preceding \\left",t);return{type:"middle",mode:r.parser.mode,delim:t.text}},htmlBuilder:(r,e)=>{var t;if(r.delim===".")t=oe(e,[]);else{t=N0.sizedDelim(r.delim,1,e,r.mode,[]);var a={delim:r.delim,options:e};t.isMiddle=a}return t},mathmlBuilder:(r,e)=>{var t=r.delim==="\\vert"||r.delim==="|"?v0("|","text"):v0(r.delim,r.mode),a=new S.MathNode("mo",[t]);return a.setAttribute("fence","true"),a.setAttribute("lspace","0.05em"),a.setAttribute("rspace","0.05em"),a}});var St=(r,e)=>{var t=b.wrapFragment(F(r.body,e),e),a=r.label.slice(1),i=e.sizeMultiplier,s,o=0,m=G.isCharacterBox(r.body);if(a==="sout")s=b.makeSpan(["stretchy","sout"]),s.height=e.fontMetrics().defaultRuleThickness/i,o=-.5*e.fontMetrics().xHeight;else if(a==="phase"){var c=K({number:.6,unit:"pt"},e),p=K({number:.35,unit:"ex"},e),g=e.havingBaseSizing();i=i/g.sizeMultiplier;var y=t.height+t.depth+c+p;t.style.paddingLeft=T(y/2+c);var x=Math.floor(1e3*y*i),w=Oa(x),z=new C0([new G0("phase",w)],{width:"400em",height:T(x/1e3),viewBox:"0 0 400000 "+x,preserveAspectRatio:"xMinYMin slice"});s=b.makeSvgSpan(["hide-tail"],[z],e),s.style.height=T(y),o=t.depth+c+p}else{/cancel/.test(a)?m||t.classes.push("cancel-pad"):a==="angl"?t.classes.push("anglpad"):t.classes.push("boxpad");var A=0,C=0,q=0;/box/.test(a)?(q=Math.max(e.fontMetrics().fboxrule,e.minRuleThickness),A=e.fontMetrics().fboxsep+(a==="colorbox"?0:q),C=A):a==="angl"?(q=Math.max(e.fontMetrics().defaultRuleThickness,e.minRuleThickness),A=4*q,C=Math.max(0,.25-t.depth)):(A=m?.2:0,C=A),s=R0.encloseSpan(t,a,A,C,e),/fbox|boxed|fcolorbox/.test(a)?(s.style.borderStyle="solid",s.style.borderWidth=T(q)):a==="angl"&&q!==.049&&(s.style.borderTopWidth=T(q),s.style.borderRightWidth=T(q)),o=t.depth+C,r.backgroundColor&&(s.style.backgroundColor=r.backgroundColor,r.borderColor&&(s.style.borderColor=r.borderColor))}var E;if(r.backgroundColor)E=b.makeVList({positionType:"individualShift",children:[{type:"elem",elem:s,shift:o},{type:"elem",elem:t,shift:0}]},e);else{var O=/cancel|phase/.test(a)?["svg-align"]:[];E=b.makeVList({positionType:"individualShift",children:[{type:"elem",elem:t,shift:0},{type:"elem",elem:s,shift:o,wrapperClasses:O}]},e)}return/cancel/.test(a)&&(E.height=t.height,E.depth=t.depth),/cancel/.test(a)&&!m?b.makeSpan(["mord","cancel-lap"],[E],e):b.makeSpan(["mord"],[E],e)},Mt=(r,e)=>{var t=0,a=new S.MathNode(r.label.indexOf("colorbox")>-1?"mpadded":"menclose",[X(r.body,e)]);switch(r.label){case"\\cancel":a.setAttribute("notation","updiagonalstrike");break;case"\\bcancel":a.setAttribute("notation","downdiagonalstrike");break;case"\\phase":a.setAttribute("notation","phasorangle");break;case"\\sout":a.setAttribute("notation","horizontalstrike");break;case"\\fbox":a.setAttribute("notation","box");break;case"\\angl":a.setAttribute("notation","actuarial");break;case"\\fcolorbox":case"\\colorbox":if(t=e.fontMetrics().fboxsep*e.fontMetrics().ptPerEm,a.setAttribute("width","+"+2*t+"pt"),a.setAttribute("height","+"+2*t+"pt"),a.setAttribute("lspace",t+"pt"),a.setAttribute("voffset",t+"pt"),r.label==="\\fcolorbox"){var i=Math.max(e.fontMetrics().fboxrule,e.minRuleThickness);a.setAttribute("style","border: "+i+"em solid "+String(r.borderColor))}break;case"\\xcancel":a.setAttribute("notation","updiagonalstrike downdiagonalstrike");break}return r.backgroundColor&&a.setAttribute("mathbackground",r.backgroundColor),a};B({type:"enclose",names:["\\colorbox"],props:{numArgs:2,allowedInText:!0,argTypes:["color","text"]},handler(r,e,t){var{parser:a,funcName:i}=r,s=H(e[0],"color-token").color,o=e[1];return{type:"enclose",mode:a.mode,label:i,backgroundColor:s,body:o}},htmlBuilder:St,mathmlBuilder:Mt});B({type:"enclose",names:["\\fcolorbox"],props:{numArgs:3,allowedInText:!0,argTypes:["color","color","text"]},handler(r,e,t){var{parser:a,funcName:i}=r,s=H(e[0],"color-token").color,o=H(e[1],"color-token").color,m=e[2];return{type:"enclose",mode:a.mode,label:i,backgroundColor:o,borderColor:s,body:m}},htmlBuilder:St,mathmlBuilder:Mt});B({type:"enclose",names:["\\fbox"],props:{numArgs:1,argTypes:["hbox"],allowedInText:!0},handler(r,e){var{parser:t}=r;return{type:"enclose",mode:t.mode,label:"\\fbox",body:e[0]}}});B({type:"enclose",names:["\\cancel","\\bcancel","\\xcancel","\\sout","\\phase"],props:{numArgs:1},handler(r,e){var{parser:t,funcName:a}=r,i=e[0];return{type:"enclose",mode:t.mode,label:a,body:i}},htmlBuilder:St,mathmlBuilder:Mt});B({type:"enclose",names:["\\angl"],props:{numArgs:1,argTypes:["hbox"],allowedInText:!1},handler(r,e){var{parser:t}=r;return{type:"enclose",mode:t.mode,label:"\\angl",body:e[0]}}});var Wr={};function k0(r){for(var{type:e,names:t,props:a,handler:i,htmlBuilder:s,mathmlBuilder:o}=r,m={type:e,numArgs:a.numArgs||0,allowedInText:!1,numOptionalArgs:0,handler:i},c=0;c<t.length;++c)Wr[t[c]]=m;s&&(Ne[e]=s),o&&(Ce[e]=o)}var jr={};function u(r,e){jr[r]=e}function Qt(r){var e=[];r.consumeSpaces();var t=r.fetch().text;for(t==="\\relax"&&(r.consume(),r.consumeSpaces(),t=r.fetch().text);t==="\\hline"||t==="\\hdashline";)r.consume(),e.push(t==="\\hdashline"),r.consumeSpaces(),t=r.fetch().text;return e}var He=r=>{var e=r.parser.settings;if(!e.displayMode)throw new M("{"+r.envName+"} can be used only in display mode.")};function zt(r){if(r.indexOf("ed")===-1)return r.indexOf("*")===-1}function U0(r,e,t){var{hskipBeforeAndAfter:a,addJot:i,cols:s,arraystretch:o,colSeparationType:m,autoTag:c,singleRow:p,emptySingleRow:g,maxNumCols:y,leqno:x}=e;if(r.gullet.beginGroup(),p||r.gullet.macros.set("\\cr","\\\\\\relax"),!o){var w=r.gullet.expandMacroAsText("\\arraystretch");if(w==null)o=1;else if(o=parseFloat(w),!o||o<0)throw new M("Invalid \\arraystretch: "+w)}r.gullet.beginGroup();var z=[],A=[z],C=[],q=[],E=c!=null?[]:void 0;function O(){c&&r.gullet.macros.set("\\@eqnsw","1",!0)}function V(){E&&(r.gullet.macros.get("\\df@tag")?(E.push(r.subparse([new u0("\\df@tag")])),r.gullet.macros.set("\\df@tag",void 0,!0)):E.push(!!c&&r.gullet.macros.get("\\@eqnsw")==="1"))}for(O(),q.push(Qt(r));;){var L=r.parseExpression(!1,p?"\\end":"\\\\");r.gullet.endGroup(),r.gullet.beginGroup(),L={type:"ordgroup",mode:r.mode,body:L},t&&(L={type:"styling",mode:r.mode,style:t,body:[L]}),z.push(L);var U=r.fetch().text;if(U==="&"){if(y&&z.length===y){if(p||m)throw new M("Too many tab characters: &",r.nextToken);r.settings.reportNonstrict("textEnv","Too few columns specified in the {array} column argument.")}r.consume()}else if(U==="\\end"){V(),z.length===1&&L.type==="styling"&&L.body[0].body.length===0&&(A.length>1||!g)&&A.pop(),q.length<A.length+1&&q.push([]);break}else if(U==="\\\\"){r.consume();var P=void 0;r.gullet.future().text!==" "&&(P=r.parseSizeGroup(!0)),C.push(P?P.value:null),V(),q.push(Qt(r)),z=[],A.push(z),O()}else throw new M("Expected & or \\\\ or \\cr or \\end",r.nextToken)}return r.gullet.endGroup(),r.gullet.endGroup(),{type:"array",mode:r.mode,addJot:i,arraystretch:o,body:A,cols:s,rowGaps:C,hskipBeforeAndAfter:a,hLinesBeforeRow:q,colSeparationType:m,tags:E,leqno:x}}function Tt(r){return r.slice(0,1)==="d"?"display":"text"}var S0=function(e,t){var a,i,s=e.body.length,o=e.hLinesBeforeRow,m=0,c=new Array(s),p=[],g=Math.max(t.fontMetrics().arrayRuleWidth,t.minRuleThickness),y=1/t.fontMetrics().ptPerEm,x=5*y;if(e.colSeparationType&&e.colSeparationType==="small"){var w=t.havingStyle(I.SCRIPT).sizeMultiplier;x=.2778*(w/t.sizeMultiplier)}var z=e.colSeparationType==="CD"?K({number:3,unit:"ex"},t):12*y,A=3*y,C=e.arraystretch*z,q=.7*C,E=.3*C,O=0;function V(fe){for(var pe=0;pe<fe.length;++pe)pe>0&&(O+=.25),p.push({pos:O,isDashed:fe[pe]})}for(V(o[0]),a=0;a<e.body.length;++a){var L=e.body[a],U=q,P=E;m<L.length&&(m=L.length);var j=new Array(L.length);for(i=0;i<L.length;++i){var Y=F(L[i],t);P<Y.depth&&(P=Y.depth),U<Y.height&&(U=Y.height),j[i]=Y}var z0=e.rowGaps[a],r0=0;z0&&(r0=K(z0,t),r0>0&&(r0+=E,P<r0&&(P=r0),r0=0)),e.addJot&&(P+=A),j.height=U,j.depth=P,O+=U,j.pos=O,O+=P+r0,c[a]=j,V(o[a+1])}var e0=O/2+t.fontMetrics().axisHeight,Y0=e.cols||[],s0=[],g0,D0,j0=[];if(e.tags&&e.tags.some(fe=>fe))for(a=0;a<s;++a){var Z0=c[a],Fe=Z0.pos-e0,E0=e.tags[a],O0=void 0;E0===!0?O0=b.makeSpan(["eqn-num"],[],t):E0===!1?O0=b.makeSpan([],[],t):O0=b.makeSpan([],t0(E0,t,!0),t),O0.depth=Z0.depth,O0.height=Z0.height,j0.push({type:"elem",elem:O0,shift:Fe})}for(i=0,D0=0;i<m||D0<Y0.length;++i,++D0){for(var d0=Y0[D0]||{},ie=!0;d0.type==="separator";){if(ie||(g0=b.makeSpan(["arraycolsep"],[]),g0.style.width=T(t.fontMetrics().doubleRuleSep),s0.push(g0)),d0.separator==="|"||d0.separator===":"){var Pe=d0.separator==="|"?"solid":"dashed",K0=b.makeSpan(["vertical-separator"],[],t);K0.style.height=T(O),K0.style.borderRightWidth=T(g),K0.style.borderRightStyle=Pe,K0.style.margin="0 "+T(-g/2);var It=O-e0;It&&(K0.style.verticalAlign=T(-It)),s0.push(K0)}else throw new M("Invalid separator type: "+d0.separator);D0++,d0=Y0[D0]||{},ie=!1}if(!(i>=m)){var J0=void 0;(i>0||e.hskipBeforeAndAfter)&&(J0=G.deflt(d0.pregap,x),J0!==0&&(g0=b.makeSpan(["arraycolsep"],[]),g0.style.width=T(J0),s0.push(g0)));var Q0=[];for(a=0;a<s;++a){var ce=c[a],de=ce[i];if(de){var ua=ce.pos-e0;de.depth=ce.depth,de.height=ce.height,Q0.push({type:"elem",elem:de,shift:ua})}}Q0=b.makeVList({positionType:"individualShift",children:Q0},t),Q0=b.makeSpan(["col-align-"+(d0.align||"c")],[Q0]),s0.push(Q0),(i<m-1||e.hskipBeforeAndAfter)&&(J0=G.deflt(d0.postgap,x),J0!==0&&(g0=b.makeSpan(["arraycolsep"],[]),g0.style.width=T(J0),s0.push(g0)))}}if(c=b.makeSpan(["mtable"],s0),p.length>0){for(var ca=b.makeLineSpan("hline",t,g),da=b.makeLineSpan("hdashline",t,g),Ge=[{type:"elem",elem:c,shift:0}];p.length>0;){var Dt=p.pop(),Et=Dt.pos-e0;Dt.isDashed?Ge.push({type:"elem",elem:da,shift:Et}):Ge.push({type:"elem",elem:ca,shift:Et})}c=b.makeVList({positionType:"individualShift",children:Ge},t)}if(j0.length===0)return b.makeSpan(["mord"],[c],t);var Ve=b.makeVList({positionType:"individualShift",children:j0},t);return Ve=b.makeSpan(["tag"],[Ve],t),b.makeFragment([c,Ve])},X1={c:"center ",l:"left ",r:"right "},M0=function(e,t){for(var a=[],i=new S.MathNode("mtd",[],["mtr-glue"]),s=new S.MathNode("mtd",[],["mml-eqn-num"]),o=0;o<e.body.length;o++){for(var m=e.body[o],c=[],p=0;p<m.length;p++)c.push(new S.MathNode("mtd",[X(m[p],t)]));e.tags&&e.tags[o]&&(c.unshift(i),c.push(i),e.leqno?c.unshift(s):c.push(s)),a.push(new S.MathNode("mtr",c))}var g=new S.MathNode("mtable",a),y=e.arraystretch===.5?.1:.16+e.arraystretch-1+(e.addJot?.09:0);g.setAttribute("rowspacing",T(y));var x="",w="";if(e.cols&&e.cols.length>0){var z=e.cols,A="",C=!1,q=0,E=z.length;z[0].type==="separator"&&(x+="top ",q=1),z[z.length-1].type==="separator"&&(x+="bottom ",E-=1);for(var O=q;O<E;O++)z[O].type==="align"?(w+=X1[z[O].align],C&&(A+="none "),C=!0):z[O].type==="separator"&&C&&(A+=z[O].separator==="|"?"solid ":"dashed ",C=!1);g.setAttribute("columnalign",w.trim()),/[sd]/.test(A)&&g.setAttribute("columnlines",A.trim())}if(e.colSeparationType==="align"){for(var V=e.cols||[],L="",U=1;U<V.length;U++)L+=U%2?"0em ":"1em ";g.setAttribute("columnspacing",L.trim())}else e.colSeparationType==="alignat"||e.colSeparationType==="gather"?g.setAttribute("columnspacing","0em"):e.colSeparationType==="small"?g.setAttribute("columnspacing","0.2778em"):e.colSeparationType==="CD"?g.setAttribute("columnspacing","0.5em"):g.setAttribute("columnspacing","1em");var P="",j=e.hLinesBeforeRow;x+=j[0].length>0?"left ":"",x+=j[j.length-1].length>0?"right ":"";for(var Y=1;Y<j.length-1;Y++)P+=j[Y].length===0?"none ":j[Y][0]?"dashed ":"solid ";return/[sd]/.test(P)&&g.setAttribute("rowlines",P.trim()),x!==""&&(g=new S.MathNode("menclose",[g]),g.setAttribute("notation",x.trim())),e.arraystretch&&e.arraystretch<1&&(g=new S.MathNode("mstyle",[g]),g.setAttribute("scriptlevel","1")),g},Zr=function(e,t){e.envName.indexOf("ed")===-1&&He(e);var a=[],i=e.envName.indexOf("at")>-1?"alignat":"align",s=e.envName==="split",o=U0(e.parser,{cols:a,addJot:!0,autoTag:s?void 0:zt(e.envName),emptySingleRow:!0,colSeparationType:i,maxNumCols:s?2:void 0,leqno:e.parser.settings.leqno},"display"),m,c=0,p={type:"ordgroup",mode:e.mode,body:[]};if(t[0]&&t[0].type==="ordgroup"){for(var g="",y=0;y<t[0].body.length;y++){var x=H(t[0].body[y],"textord");g+=x.text}m=Number(g),c=m*2}var w=!c;o.body.forEach(function(q){for(var E=1;E<q.length;E+=2){var O=H(q[E],"styling"),V=H(O.body[0],"ordgroup");V.body.unshift(p)}if(w)c<q.length&&(c=q.length);else{var L=q.length/2;if(m<L)throw new M("Too many math in a row: "+("expected "+m+", but got "+L),q[0])}});for(var z=0;z<c;++z){var A="r",C=0;z%2===1?A="l":z>0&&w&&(C=1),a[z]={type:"align",align:A,pregap:C,postgap:0}}return o.colSeparationType=w?"align":"alignat",o};k0({type:"array",names:["array","darray"],props:{numArgs:1},handler(r,e){var t=De(e[0]),a=t?[e[0]]:H(e[0],"ordgroup").body,i=a.map(function(o){var m=wt(o),c=m.text;if("lcr".indexOf(c)!==-1)return{type:"align",align:c};if(c==="|")return{type:"separator",separator:"|"};if(c===":")return{type:"separator",separator:":"};throw new M("Unknown column alignment: "+c,o)}),s={cols:i,hskipBeforeAndAfter:!0,maxNumCols:i.length};return U0(r.parser,s,Tt(r.envName))},htmlBuilder:S0,mathmlBuilder:M0});k0({type:"array",names:["matrix","pmatrix","bmatrix","Bmatrix","vmatrix","Vmatrix","matrix*","pmatrix*","bmatrix*","Bmatrix*","vmatrix*","Vmatrix*"],props:{numArgs:0},handler(r){var e={matrix:null,pmatrix:["(",")"],bmatrix:["[","]"],Bmatrix:["\\{","\\}"],vmatrix:["|","|"],Vmatrix:["\\Vert","\\Vert"]}[r.envName.replace("*","")],t="c",a={hskipBeforeAndAfter:!1,cols:[{type:"align",align:t}]};if(r.envName.charAt(r.envName.length-1)==="*"){var i=r.parser;if(i.consumeSpaces(),i.fetch().text==="["){if(i.consume(),i.consumeSpaces(),t=i.fetch().text,"lcr".indexOf(t)===-1)throw new M("Expected l or c or r",i.nextToken);i.consume(),i.consumeSpaces(),i.expect("]"),i.consume(),a.cols=[{type:"align",align:t}]}}var s=U0(r.parser,a,Tt(r.envName)),o=Math.max(0,...s.body.map(m=>m.length));return s.cols=new Array(o).fill({type:"align",align:t}),e?{type:"leftright",mode:r.mode,body:[s],left:e[0],right:e[1],rightColor:void 0}:s},htmlBuilder:S0,mathmlBuilder:M0});k0({type:"array",names:["smallmatrix"],props:{numArgs:0},handler(r){var e={arraystretch:.5},t=U0(r.parser,e,"script");return t.colSeparationType="small",t},htmlBuilder:S0,mathmlBuilder:M0});k0({type:"array",names:["subarray"],props:{numArgs:1},handler(r,e){var t=De(e[0]),a=t?[e[0]]:H(e[0],"ordgroup").body,i=a.map(function(o){var m=wt(o),c=m.text;if("lc".indexOf(c)!==-1)return{type:"align",align:c};throw new M("Unknown column alignment: "+c,o)});if(i.length>1)throw new M("{subarray} can contain only one column");var s={cols:i,hskipBeforeAndAfter:!1,arraystretch:.5};if(s=U0(r.parser,s,"script"),s.body.length>0&&s.body[0].length>1)throw new M("{subarray} can contain only one column");return s},htmlBuilder:S0,mathmlBuilder:M0});k0({type:"array",names:["cases","dcases","rcases","drcases"],props:{numArgs:0},handler(r){var e={arraystretch:1.2,cols:[{type:"align",align:"l",pregap:0,postgap:1},{type:"align",align:"l",pregap:0,postgap:0}]},t=U0(r.parser,e,Tt(r.envName));return{type:"leftright",mode:r.mode,body:[t],left:r.envName.indexOf("r")>-1?".":"\\{",right:r.envName.indexOf("r")>-1?"\\}":".",rightColor:void 0}},htmlBuilder:S0,mathmlBuilder:M0});k0({type:"array",names:["align","align*","aligned","split"],props:{numArgs:0},handler:Zr,htmlBuilder:S0,mathmlBuilder:M0});k0({type:"array",names:["gathered","gather","gather*"],props:{numArgs:0},handler(r){["gather","gather*"].includes(r.envName)&&He(r);var e={cols:[{type:"align",align:"c"}],addJot:!0,colSeparationType:"gather",autoTag:zt(r.envName),emptySingleRow:!0,leqno:r.parser.settings.leqno};return U0(r.parser,e,"display")},htmlBuilder:S0,mathmlBuilder:M0});k0({type:"array",names:["alignat","alignat*","alignedat"],props:{numArgs:1},handler:Zr,htmlBuilder:S0,mathmlBuilder:M0});k0({type:"array",names:["equation","equation*"],props:{numArgs:0},handler(r){He(r);var e={autoTag:zt(r.envName),emptySingleRow:!0,singleRow:!0,maxNumCols:1,leqno:r.parser.settings.leqno};return U0(r.parser,e,"display")},htmlBuilder:S0,mathmlBuilder:M0});k0({type:"array",names:["CD"],props:{numArgs:0},handler(r){return He(r),q1(r.parser)},htmlBuilder:S0,mathmlBuilder:M0});u("\\nonumber","\\gdef\\@eqnsw{0}");u("\\notag","\\nonumber");B({type:"text",names:["\\hline","\\hdashline"],props:{numArgs:0,allowedInText:!0,allowedInMath:!0},handler(r,e){throw new M(r.funcName+" valid only within array environment")}});var _t=Wr;B({type:"environment",names:["\\begin","\\end"],props:{numArgs:1,argTypes:["text"]},handler(r,e){var{parser:t,funcName:a}=r,i=e[0];if(i.type!=="ordgroup")throw new M("Invalid environment name",i);for(var s="",o=0;o<i.body.length;++o)s+=H(i.body[o],"textord").text;if(a==="\\begin"){if(!_t.hasOwnProperty(s))throw new M("No such environment: "+s,i);var m=_t[s],{args:c,optArgs:p}=t.parseArguments("\\begin{"+s+"}",m),g={mode:t.mode,envName:s,parser:t},y=m.handler(g,c,p);t.expect("\\end",!1);var x=t.nextToken,w=H(t.parseFunction(),"environment");if(w.name!==s)throw new M("Mismatch: \\begin{"+s+"} matched by \\end{"+w.name+"}",x);return y}return{type:"environment",mode:t.mode,name:s,nameGroup:i}}});var Kr=(r,e)=>{var t=r.font,a=e.withFont(t);return F(r.body,a)},Jr=(r,e)=>{var t=r.font,a=e.withFont(t);return X(r.body,a)},er={"\\Bbb":"\\mathbb","\\bold":"\\mathbf","\\frak":"\\mathfrak","\\bm":"\\boldsymbol"};B({type:"font",names:["\\mathrm","\\mathit","\\mathbf","\\mathnormal","\\mathsfit","\\mathbb","\\mathcal","\\mathfrak","\\mathscr","\\mathsf","\\mathtt","\\Bbb","\\bold","\\frak"],props:{numArgs:1,allowedInArgument:!0},handler:(r,e)=>{var{parser:t,funcName:a}=r,i=qe(e[0]),s=a;return s in er&&(s=er[s]),{type:"font",mode:t.mode,font:s.slice(1),body:i}},htmlBuilder:Kr,mathmlBuilder:Jr});B({type:"mclass",names:["\\boldsymbol","\\bm"],props:{numArgs:1},handler:(r,e)=>{var{parser:t}=r,a=e[0],i=G.isCharacterBox(a);return{type:"mclass",mode:t.mode,mclass:Ee(a),body:[{type:"font",mode:t.mode,font:"boldsymbol",body:a}],isCharacterBox:i}}});B({type:"font",names:["\\rm","\\sf","\\tt","\\bf","\\it","\\cal"],props:{numArgs:0,allowedInText:!0},handler:(r,e)=>{var{parser:t,funcName:a,breakOnTokenText:i}=r,{mode:s}=t,o=t.parseExpression(!0,i),m="math"+a.slice(1);return{type:"font",mode:s,font:m,body:{type:"ordgroup",mode:t.mode,body:o}}},htmlBuilder:Kr,mathmlBuilder:Jr});var Qr=(r,e)=>{var t=e;return r==="display"?t=t.id>=I.SCRIPT.id?t.text():I.DISPLAY:r==="text"&&t.size===I.DISPLAY.size?t=I.TEXT:r==="script"?t=I.SCRIPT:r==="scriptscript"&&(t=I.SCRIPTSCRIPT),t},At=(r,e)=>{var t=Qr(r.size,e.style),a=t.fracNum(),i=t.fracDen(),s;s=e.havingStyle(a);var o=F(r.numer,s,e);if(r.continued){var m=8.5/e.fontMetrics().ptPerEm,c=3.5/e.fontMetrics().ptPerEm;o.height=o.height<m?m:o.height,o.depth=o.depth<c?c:o.depth}s=e.havingStyle(i);var p=F(r.denom,s,e),g,y,x;r.hasBarLine?(r.barSize?(y=K(r.barSize,e),g=b.makeLineSpan("frac-line",e,y)):g=b.makeLineSpan("frac-line",e),y=g.height,x=g.height):(g=null,y=0,x=e.fontMetrics().defaultRuleThickness);var w,z,A;t.size===I.DISPLAY.size||r.size==="display"?(w=e.fontMetrics().num1,y>0?z=3*x:z=7*x,A=e.fontMetrics().denom1):(y>0?(w=e.fontMetrics().num2,z=x):(w=e.fontMetrics().num3,z=3*x),A=e.fontMetrics().denom2);var C;if(g){var E=e.fontMetrics().axisHeight;w-o.depth-(E+.5*y)<z&&(w+=z-(w-o.depth-(E+.5*y))),E-.5*y-(p.height-A)<z&&(A+=z-(E-.5*y-(p.height-A)));var O=-(E-.5*y);C=b.makeVList({positionType:"individualShift",children:[{type:"elem",elem:p,shift:A},{type:"elem",elem:g,shift:O},{type:"elem",elem:o,shift:-w}]},e)}else{var q=w-o.depth-(p.height-A);q<z&&(w+=.5*(z-q),A+=.5*(z-q)),C=b.makeVList({positionType:"individualShift",children:[{type:"elem",elem:p,shift:A},{type:"elem",elem:o,shift:-w}]},e)}s=e.havingStyle(t),C.height*=s.sizeMultiplier/e.sizeMultiplier,C.depth*=s.sizeMultiplier/e.sizeMultiplier;var V;t.size===I.DISPLAY.size?V=e.fontMetrics().delim1:t.size===I.SCRIPTSCRIPT.size?V=e.havingStyle(I.SCRIPT).fontMetrics().delim2:V=e.fontMetrics().delim2;var L,U;return r.leftDelim==null?L=oe(e,["mopen"]):L=N0.customSizedDelim(r.leftDelim,V,!0,e.havingStyle(t),r.mode,["mopen"]),r.continued?U=b.makeSpan([]):r.rightDelim==null?U=oe(e,["mclose"]):U=N0.customSizedDelim(r.rightDelim,V,!0,e.havingStyle(t),r.mode,["mclose"]),b.makeSpan(["mord"].concat(s.sizingClasses(e)),[L,b.makeSpan(["mfrac"],[C]),U],e)},Bt=(r,e)=>{var t=new S.MathNode("mfrac",[X(r.numer,e),X(r.denom,e)]);if(!r.hasBarLine)t.setAttribute("linethickness","0px");else if(r.barSize){var a=K(r.barSize,e);t.setAttribute("linethickness",T(a))}var i=Qr(r.size,e.style);if(i.size!==e.style.size){t=new S.MathNode("mstyle",[t]);var s=i.size===I.DISPLAY.size?"true":"false";t.setAttribute("displaystyle",s),t.setAttribute("scriptlevel","0")}if(r.leftDelim!=null||r.rightDelim!=null){var o=[];if(r.leftDelim!=null){var m=new S.MathNode("mo",[new S.TextNode(r.leftDelim.replace("\\",""))]);m.setAttribute("fence","true"),o.push(m)}if(o.push(t),r.rightDelim!=null){var c=new S.MathNode("mo",[new S.TextNode(r.rightDelim.replace("\\",""))]);c.setAttribute("fence","true"),o.push(c)}return bt(o)}return t};B({type:"genfrac",names:["\\dfrac","\\frac","\\tfrac","\\dbinom","\\binom","\\tbinom","\\\\atopfrac","\\\\bracefrac","\\\\brackfrac"],props:{numArgs:2,allowedInArgument:!0},handler:(r,e)=>{var{parser:t,funcName:a}=r,i=e[0],s=e[1],o,m=null,c=null,p="auto";switch(a){case"\\dfrac":case"\\frac":case"\\tfrac":o=!0;break;case"\\\\atopfrac":o=!1;break;case"\\dbinom":case"\\binom":case"\\tbinom":o=!1,m="(",c=")";break;case"\\\\bracefrac":o=!1,m="\\{",c="\\}";break;case"\\\\brackfrac":o=!1,m="[",c="]";break;default:throw new Error("Unrecognized genfrac command")}switch(a){case"\\dfrac":case"\\dbinom":p="display";break;case"\\tfrac":case"\\tbinom":p="text";break}return{type:"genfrac",mode:t.mode,continued:!1,numer:i,denom:s,hasBarLine:o,leftDelim:m,rightDelim:c,size:p,barSize:null}},htmlBuilder:At,mathmlBuilder:Bt});B({type:"genfrac",names:["\\cfrac"],props:{numArgs:2},handler:(r,e)=>{var{parser:t,funcName:a}=r,i=e[0],s=e[1];return{type:"genfrac",mode:t.mode,continued:!0,numer:i,denom:s,hasBarLine:!0,leftDelim:null,rightDelim:null,size:"display",barSize:null}}});B({type:"infix",names:["\\over","\\choose","\\atop","\\brace","\\brack"],props:{numArgs:0,infix:!0},handler(r){var{parser:e,funcName:t,token:a}=r,i;switch(t){case"\\over":i="\\frac";break;case"\\choose":i="\\binom";break;case"\\atop":i="\\\\atopfrac";break;case"\\brace":i="\\\\bracefrac";break;case"\\brack":i="\\\\brackfrac";break;default:throw new Error("Unrecognized infix genfrac command")}return{type:"infix",mode:e.mode,replaceWith:i,token:a}}});var tr=["display","text","script","scriptscript"],rr=function(e){var t=null;return e.length>0&&(t=e,t=t==="."?null:t),t};B({type:"genfrac",names:["\\genfrac"],props:{numArgs:6,allowedInArgument:!0,argTypes:["math","math","size","text","math","math"]},handler(r,e){var{parser:t}=r,a=e[4],i=e[5],s=qe(e[0]),o=s.type==="atom"&&s.family==="open"?rr(s.text):null,m=qe(e[1]),c=m.type==="atom"&&m.family==="close"?rr(m.text):null,p=H(e[2],"size"),g,y=null;p.isBlank?g=!0:(y=p.value,g=y.number>0);var x="auto",w=e[3];if(w.type==="ordgroup"){if(w.body.length>0){var z=H(w.body[0],"textord");x=tr[Number(z.text)]}}else w=H(w,"textord"),x=tr[Number(w.text)];return{type:"genfrac",mode:t.mode,numer:a,denom:i,continued:!1,hasBarLine:g,barSize:y,leftDelim:o,rightDelim:c,size:x}},htmlBuilder:At,mathmlBuilder:Bt});B({type:"infix",names:["\\above"],props:{numArgs:1,argTypes:["size"],infix:!0},handler(r,e){var{parser:t,funcName:a,token:i}=r;return{type:"infix",mode:t.mode,replaceWith:"\\\\abovefrac",size:H(e[0],"size").value,token:i}}});B({type:"genfrac",names:["\\\\abovefrac"],props:{numArgs:3,argTypes:["math","size","math"]},handler:(r,e)=>{var{parser:t,funcName:a}=r,i=e[0],s=xa(H(e[1],"infix").size),o=e[2],m=s.number>0;return{type:"genfrac",mode:t.mode,numer:i,denom:o,continued:!1,hasBarLine:m,barSize:s,leftDelim:null,rightDelim:null,size:"auto"}},htmlBuilder:At,mathmlBuilder:Bt});var _r=(r,e)=>{var t=e.style,a,i;r.type==="supsub"?(a=r.sup?F(r.sup,e.havingStyle(t.sup()),e):F(r.sub,e.havingStyle(t.sub()),e),i=H(r.base,"horizBrace")):i=H(r,"horizBrace");var s=F(i.base,e.havingBaseStyle(I.DISPLAY)),o=R0.svgSpan(i,e),m;if(i.isOver?(m=b.makeVList({positionType:"firstBaseline",children:[{type:"elem",elem:s},{type:"kern",size:.1},{type:"elem",elem:o}]},e),m.children[0].children[0].children[1].classes.push("svg-align")):(m=b.makeVList({positionType:"bottom",positionData:s.depth+.1+o.height,children:[{type:"elem",elem:o},{type:"kern",size:.1},{type:"elem",elem:s}]},e),m.children[0].children[0].children[0].classes.push("svg-align")),a){var c=b.makeSpan(["mord",i.isOver?"mover":"munder"],[m],e);i.isOver?m=b.makeVList({positionType:"firstBaseline",children:[{type:"elem",elem:c},{type:"kern",size:.2},{type:"elem",elem:a}]},e):m=b.makeVList({positionType:"bottom",positionData:c.depth+.2+a.height+a.depth,children:[{type:"elem",elem:a},{type:"kern",size:.2},{type:"elem",elem:c}]},e)}return b.makeSpan(["mord",i.isOver?"mover":"munder"],[m],e)},$1=(r,e)=>{var t=R0.mathMLnode(r.label);return new S.MathNode(r.isOver?"mover":"munder",[X(r.base,e),t])};B({type:"horizBrace",names:["\\overbrace","\\underbrace"],props:{numArgs:1},handler(r,e){var{parser:t,funcName:a}=r;return{type:"horizBrace",mode:t.mode,label:a,isOver:/^\\over/.test(a),base:e[0]}},htmlBuilder:_r,mathmlBuilder:$1});B({type:"href",names:["\\href"],props:{numArgs:2,argTypes:["url","original"],allowedInText:!0},handler:(r,e)=>{var{parser:t}=r,a=e[1],i=H(e[0],"url").url;return t.settings.isTrusted({command:"\\href",url:i})?{type:"href",mode:t.mode,href:i,body:Q(a)}:t.formatUnsupportedCmd("\\href")},htmlBuilder:(r,e)=>{var t=t0(r.body,e,!1);return b.makeAnchor(r.href,[],t,e)},mathmlBuilder:(r,e)=>{var t=V0(r.body,e);return t instanceof m0||(t=new m0("mrow",[t])),t.setAttribute("href",r.href),t}});B({type:"href",names:["\\url"],props:{numArgs:1,argTypes:["url"],allowedInText:!0},handler:(r,e)=>{var{parser:t}=r,a=H(e[0],"url").url;if(!t.settings.isTrusted({command:"\\url",url:a}))return t.formatUnsupportedCmd("\\url");for(var i=[],s=0;s<a.length;s++){var o=a[s];o==="~"&&(o="\\textasciitilde"),i.push({type:"textord",mode:"text",text:o})}var m={type:"text",mode:t.mode,font:"\\texttt",body:i};return{type:"href",mode:t.mode,href:a,body:Q(m)}}});B({type:"hbox",names:["\\hbox"],props:{numArgs:1,argTypes:["text"],allowedInText:!0,primitive:!0},handler(r,e){var{parser:t}=r;return{type:"hbox",mode:t.mode,body:Q(e[0])}},htmlBuilder(r,e){var t=t0(r.body,e,!1);return b.makeFragment(t)},mathmlBuilder(r,e){return new S.MathNode("mrow",h0(r.body,e))}});B({type:"html",names:["\\htmlClass","\\htmlId","\\htmlStyle","\\htmlData"],props:{numArgs:2,argTypes:["raw","original"],allowedInText:!0},handler:(r,e)=>{var{parser:t,funcName:a,token:i}=r,s=H(e[0],"raw").string,o=e[1];t.settings.strict&&t.settings.reportNonstrict("htmlExtension","HTML extension is disabled on strict mode");var m,c={};switch(a){case"\\htmlClass":c.class=s,m={command:"\\htmlClass",class:s};break;case"\\htmlId":c.id=s,m={command:"\\htmlId",id:s};break;case"\\htmlStyle":c.style=s,m={command:"\\htmlStyle",style:s};break;case"\\htmlData":{for(var p=s.split(","),g=0;g<p.length;g++){var y=p[g].split("=");if(y.length!==2)throw new M("Error parsing key-value for \\htmlData");c["data-"+y[0].trim()]=y[1].trim()}m={command:"\\htmlData",attributes:c};break}default:throw new Error("Unrecognized html command")}return t.settings.isTrusted(m)?{type:"html",mode:t.mode,attributes:c,body:Q(o)}:t.formatUnsupportedCmd(a)},htmlBuilder:(r,e)=>{var t=t0(r.body,e,!1),a=["enclosing"];r.attributes.class&&a.push(...r.attributes.class.trim().split(/\s+/));var i=b.makeSpan(a,t,e);for(var s in r.attributes)s!=="class"&&r.attributes.hasOwnProperty(s)&&i.setAttribute(s,r.attributes[s]);return i},mathmlBuilder:(r,e)=>V0(r.body,e)});B({type:"htmlmathml",names:["\\html@mathml"],props:{numArgs:2,allowedInText:!0},handler:(r,e)=>{var{parser:t}=r;return{type:"htmlmathml",mode:t.mode,html:Q(e[0]),mathml:Q(e[1])}},htmlBuilder:(r,e)=>{var t=t0(r.html,e,!1);return b.makeFragment(t)},mathmlBuilder:(r,e)=>V0(r.mathml,e)});var et=function(e){if(/^[-+]? *(\d+(\.\d*)?|\.\d+)$/.test(e))return{number:+e,unit:"bp"};var t=/([-+]?) *(\d+(?:\.\d*)?|\.\d+) *([a-z]{2})/.exec(e);if(!t)throw new M("Invalid size: '"+e+"' in \\includegraphics");var a={number:+(t[1]+t[2]),unit:t[3]};if(!br(a))throw new M("Invalid unit: '"+a.unit+"' in \\includegraphics.");return a};B({type:"includegraphics",names:["\\includegraphics"],props:{numArgs:1,numOptionalArgs:1,argTypes:["raw","url"],allowedInText:!1},handler:(r,e,t)=>{var{parser:a}=r,i={number:0,unit:"em"},s={number:.9,unit:"em"},o={number:0,unit:"em"},m="";if(t[0])for(var c=H(t[0],"raw").string,p=c.split(","),g=0;g<p.length;g++){var y=p[g].split("=");if(y.length===2){var x=y[1].trim();switch(y[0].trim()){case"alt":m=x;break;case"width":i=et(x);break;case"height":s=et(x);break;case"totalheight":o=et(x);break;default:throw new M("Invalid key: '"+y[0]+"' in \\includegraphics.")}}}var w=H(e[0],"url").url;return m===""&&(m=w,m=m.replace(/^.*[\\/]/,""),m=m.substring(0,m.lastIndexOf("."))),a.settings.isTrusted({command:"\\includegraphics",url:w})?{type:"includegraphics",mode:a.mode,alt:m,width:i,height:s,totalheight:o,src:w}:a.formatUnsupportedCmd("\\includegraphics")},htmlBuilder:(r,e)=>{var t=K(r.height,e),a=0;r.totalheight.number>0&&(a=K(r.totalheight,e)-t);var i=0;r.width.number>0&&(i=K(r.width,e));var s={height:T(t+a)};i>0&&(s.width=T(i)),a>0&&(s.verticalAlign=T(-a));var o=new $a(r.src,r.alt,s);return o.height=t,o.depth=a,o},mathmlBuilder:(r,e)=>{var t=new S.MathNode("mglyph",[]);t.setAttribute("alt",r.alt);var a=K(r.height,e),i=0;if(r.totalheight.number>0&&(i=K(r.totalheight,e)-a,t.setAttribute("valign",T(-i))),t.setAttribute("height",T(a+i)),r.width.number>0){var s=K(r.width,e);t.setAttribute("width",T(s))}return t.setAttribute("src",r.src),t}});B({type:"kern",names:["\\kern","\\mkern","\\hskip","\\mskip"],props:{numArgs:1,argTypes:["size"],primitive:!0,allowedInText:!0},handler(r,e){var{parser:t,funcName:a}=r,i=H(e[0],"size");if(t.settings.strict){var s=a[1]==="m",o=i.value.unit==="mu";s?(o||t.settings.reportNonstrict("mathVsTextUnits","LaTeX's "+a+" supports only mu units, "+("not "+i.value.unit+" units")),t.mode!=="math"&&t.settings.reportNonstrict("mathVsTextUnits","LaTeX's "+a+" works only in math mode")):o&&t.settings.reportNonstrict("mathVsTextUnits","LaTeX's "+a+" doesn't support mu units")}return{type:"kern",mode:t.mode,dimension:i.value}},htmlBuilder(r,e){return b.makeGlue(r.dimension,e)},mathmlBuilder(r,e){var t=K(r.dimension,e);return new S.SpaceNode(t)}});B({type:"lap",names:["\\mathllap","\\mathrlap","\\mathclap"],props:{numArgs:1,allowedInText:!0},handler:(r,e)=>{var{parser:t,funcName:a}=r,i=e[0];return{type:"lap",mode:t.mode,alignment:a.slice(5),body:i}},htmlBuilder:(r,e)=>{var t;r.alignment==="clap"?(t=b.makeSpan([],[F(r.body,e)]),t=b.makeSpan(["inner"],[t],e)):t=b.makeSpan(["inner"],[F(r.body,e)]);var a=b.makeSpan(["fix"],[]),i=b.makeSpan([r.alignment],[t,a],e),s=b.makeSpan(["strut"]);return s.style.height=T(i.height+i.depth),i.depth&&(s.style.verticalAlign=T(-i.depth)),i.children.unshift(s),i=b.makeSpan(["thinbox"],[i],e),b.makeSpan(["mord","vbox"],[i],e)},mathmlBuilder:(r,e)=>{var t=new S.MathNode("mpadded",[X(r.body,e)]);if(r.alignment!=="rlap"){var a=r.alignment==="llap"?"-1":"-0.5";t.setAttribute("lspace",a+"width")}return t.setAttribute("width","0px"),t}});B({type:"styling",names:["\\(","$"],props:{numArgs:0,allowedInText:!0,allowedInMath:!1},handler(r,e){var{funcName:t,parser:a}=r,i=a.mode;a.switchMode("math");var s=t==="\\("?"\\)":"$",o=a.parseExpression(!1,s);return a.expect(s),a.switchMode(i),{type:"styling",mode:a.mode,style:"text",body:o}}});B({type:"text",names:["\\)","\\]"],props:{numArgs:0,allowedInText:!0,allowedInMath:!1},handler(r,e){throw new M("Mismatched "+r.funcName)}});var ar=(r,e)=>{switch(e.style.size){case I.DISPLAY.size:return r.display;case I.TEXT.size:return r.text;case I.SCRIPT.size:return r.script;case I.SCRIPTSCRIPT.size:return r.scriptscript;default:return r.text}};B({type:"mathchoice",names:["\\mathchoice"],props:{numArgs:4,primitive:!0},handler:(r,e)=>{var{parser:t}=r;return{type:"mathchoice",mode:t.mode,display:Q(e[0]),text:Q(e[1]),script:Q(e[2]),scriptscript:Q(e[3])}},htmlBuilder:(r,e)=>{var t=ar(r,e),a=t0(t,e,!1);return b.makeFragment(a)},mathmlBuilder:(r,e)=>{var t=ar(r,e);return V0(t,e)}});var ea=(r,e,t,a,i,s,o)=>{r=b.makeSpan([],[r]);var m=t&&G.isCharacterBox(t),c,p;if(e){var g=F(e,a.havingStyle(i.sup()),a);p={elem:g,kern:Math.max(a.fontMetrics().bigOpSpacing1,a.fontMetrics().bigOpSpacing3-g.depth)}}if(t){var y=F(t,a.havingStyle(i.sub()),a);c={elem:y,kern:Math.max(a.fontMetrics().bigOpSpacing2,a.fontMetrics().bigOpSpacing4-y.height)}}var x;if(p&&c){var w=a.fontMetrics().bigOpSpacing5+c.elem.height+c.elem.depth+c.kern+r.depth+o;x=b.makeVList({positionType:"bottom",positionData:w,children:[{type:"kern",size:a.fontMetrics().bigOpSpacing5},{type:"elem",elem:c.elem,marginLeft:T(-s)},{type:"kern",size:c.kern},{type:"elem",elem:r},{type:"kern",size:p.kern},{type:"elem",elem:p.elem,marginLeft:T(s)},{type:"kern",size:a.fontMetrics().bigOpSpacing5}]},a)}else if(c){var z=r.height-o;x=b.makeVList({positionType:"top",positionData:z,children:[{type:"kern",size:a.fontMetrics().bigOpSpacing5},{type:"elem",elem:c.elem,marginLeft:T(-s)},{type:"kern",size:c.kern},{type:"elem",elem:r}]},a)}else if(p){var A=r.depth+o;x=b.makeVList({positionType:"bottom",positionData:A,children:[{type:"elem",elem:r},{type:"kern",size:p.kern},{type:"elem",elem:p.elem,marginLeft:T(s)},{type:"kern",size:a.fontMetrics().bigOpSpacing5}]},a)}else return r;var C=[x];if(c&&s!==0&&!m){var q=b.makeSpan(["mspace"],[],a);q.style.marginRight=T(s),C.unshift(q)}return b.makeSpan(["mop","op-limits"],C,a)},ta=["\\smallint"],ae=(r,e)=>{var t,a,i=!1,s;r.type==="supsub"?(t=r.sup,a=r.sub,s=H(r.base,"op"),i=!0):s=H(r,"op");var o=e.style,m=!1;o.size===I.DISPLAY.size&&s.symbol&&!ta.includes(s.name)&&(m=!0);var c;if(s.symbol){var p=m?"Size2-Regular":"Size1-Regular",g="";if((s.name==="\\oiint"||s.name==="\\oiiint")&&(g=s.name.slice(1),s.name=g==="oiint"?"\\iint":"\\iiint"),c=b.makeSymbol(s.name,p,"math",e,["mop","op-symbol",m?"large-op":"small-op"]),g.length>0){var y=c.italic,x=b.staticSvg(g+"Size"+(m?"2":"1"),e);c=b.makeVList({positionType:"individualShift",children:[{type:"elem",elem:c,shift:0},{type:"elem",elem:x,shift:m?.08:0}]},e),s.name="\\"+g,c.classes.unshift("mop"),c.italic=y}}else if(s.body){var w=t0(s.body,e,!0);w.length===1&&w[0]instanceof p0?(c=w[0],c.classes[0]="mop"):c=b.makeSpan(["mop"],w,e)}else{for(var z=[],A=1;A<s.name.length;A++)z.push(b.mathsym(s.name[A],s.mode,e));c=b.makeSpan(["mop"],z,e)}var C=0,q=0;return(c instanceof p0||s.name==="\\oiint"||s.name==="\\oiiint")&&!s.suppressBaseShift&&(C=(c.height-c.depth)/2-e.fontMetrics().axisHeight,q=c.italic),i?ea(c,t,a,e,o,q,C):(C&&(c.style.position="relative",c.style.top=T(C)),c)},ue=(r,e)=>{var t;if(r.symbol)t=new m0("mo",[v0(r.name,r.mode)]),ta.includes(r.name)&&t.setAttribute("largeop","false");else if(r.body)t=new m0("mo",h0(r.body,e));else{t=new m0("mi",[new x0(r.name.slice(1))]);var a=new m0("mo",[v0("⁡","text")]);r.parentIsSupSub?t=new m0("mrow",[t,a]):t=Nr([t,a])}return t},W1={"∏":"\\prod","∐":"\\coprod","∑":"\\sum","⋀":"\\bigwedge","⋁":"\\bigvee","⋂":"\\bigcap","⋃":"\\bigcup","⨀":"\\bigodot","⨁":"\\bigoplus","⨂":"\\bigotimes","⨄":"\\biguplus","⨆":"\\bigsqcup"};B({type:"op",names:["\\coprod","\\bigvee","\\bigwedge","\\biguplus","\\bigcap","\\bigcup","\\intop","\\prod","\\sum","\\bigotimes","\\bigoplus","\\bigodot","\\bigsqcup","\\smallint","∏","∐","∑","⋀","⋁","⋂","⋃","⨀","⨁","⨂","⨄","⨆"],props:{numArgs:0},handler:(r,e)=>{var{parser:t,funcName:a}=r,i=a;return i.length===1&&(i=W1[i]),{type:"op",mode:t.mode,limits:!0,parentIsSupSub:!1,symbol:!0,name:i}},htmlBuilder:ae,mathmlBuilder:ue});B({type:"op",names:["\\mathop"],props:{numArgs:1,primitive:!0},handler:(r,e)=>{var{parser:t}=r,a=e[0];return{type:"op",mode:t.mode,limits:!1,parentIsSupSub:!1,symbol:!1,body:Q(a)}},htmlBuilder:ae,mathmlBuilder:ue});var j1={"∫":"\\int","∬":"\\iint","∭":"\\iiint","∮":"\\oint","∯":"\\oiint","∰":"\\oiiint"};B({type:"op",names:["\\arcsin","\\arccos","\\arctan","\\arctg","\\arcctg","\\arg","\\ch","\\cos","\\cosec","\\cosh","\\cot","\\cotg","\\coth","\\csc","\\ctg","\\cth","\\deg","\\dim","\\exp","\\hom","\\ker","\\lg","\\ln","\\log","\\sec","\\sin","\\sinh","\\sh","\\tan","\\tanh","\\tg","\\th"],props:{numArgs:0},handler(r){var{parser:e,funcName:t}=r;return{type:"op",mode:e.mode,limits:!1,parentIsSupSub:!1,symbol:!1,name:t}},htmlBuilder:ae,mathmlBuilder:ue});B({type:"op",names:["\\det","\\gcd","\\inf","\\lim","\\max","\\min","\\Pr","\\sup"],props:{numArgs:0},handler(r){var{parser:e,funcName:t}=r;return{type:"op",mode:e.mode,limits:!0,parentIsSupSub:!1,symbol:!1,name:t}},htmlBuilder:ae,mathmlBuilder:ue});B({type:"op",names:["\\int","\\iint","\\iiint","\\oint","\\oiint","\\oiiint","∫","∬","∭","∮","∯","∰"],props:{numArgs:0},handler(r){var{parser:e,funcName:t}=r,a=t;return a.length===1&&(a=j1[a]),{type:"op",mode:e.mode,limits:!1,parentIsSupSub:!1,symbol:!0,name:a}},htmlBuilder:ae,mathmlBuilder:ue});var ra=(r,e)=>{var t,a,i=!1,s;r.type==="supsub"?(t=r.sup,a=r.sub,s=H(r.base,"operatorname"),i=!0):s=H(r,"operatorname");var o;if(s.body.length>0){for(var m=s.body.map(y=>{var x=y.text;return typeof x=="string"?{type:"textord",mode:y.mode,text:x}:y}),c=t0(m,e.withFont("mathrm"),!0),p=0;p<c.length;p++){var g=c[p];g instanceof p0&&(g.text=g.text.replace(/\u2212/,"-").replace(/\u2217/,"*"))}o=b.makeSpan(["mop"],c,e)}else o=b.makeSpan(["mop"],[],e);return i?ea(o,t,a,e,e.style,0,0):o},Z1=(r,e)=>{for(var t=h0(r.body,e.withFont("mathrm")),a=!0,i=0;i<t.length;i++){var s=t[i];if(!(s instanceof S.SpaceNode))if(s instanceof S.MathNode)switch(s.type){case"mi":case"mn":case"ms":case"mspace":case"mtext":break;case"mo":{var o=s.children[0];s.children.length===1&&o instanceof S.TextNode?o.text=o.text.replace(/\u2212/,"-").replace(/\u2217/,"*"):a=!1;break}default:a=!1}else a=!1}if(a){var m=t.map(g=>g.toText()).join("");t=[new S.TextNode(m)]}var c=new S.MathNode("mi",t);c.setAttribute("mathvariant","normal");var p=new S.MathNode("mo",[v0("⁡","text")]);return r.parentIsSupSub?new S.MathNode("mrow",[c,p]):S.newDocumentFragment([c,p])};B({type:"operatorname",names:["\\operatorname@","\\operatornamewithlimits"],props:{numArgs:1},handler:(r,e)=>{var{parser:t,funcName:a}=r,i=e[0];return{type:"operatorname",mode:t.mode,body:Q(i),alwaysHandleSupSub:a==="\\operatornamewithlimits",limits:!1,parentIsSupSub:!1}},htmlBuilder:ra,mathmlBuilder:Z1});u("\\operatorname","\\@ifstar\\operatornamewithlimits\\operatorname@");W0({type:"ordgroup",htmlBuilder(r,e){return r.semisimple?b.makeFragment(t0(r.body,e,!1)):b.makeSpan(["mord"],t0(r.body,e,!0),e)},mathmlBuilder(r,e){return V0(r.body,e,!0)}});B({type:"overline",names:["\\overline"],props:{numArgs:1},handler(r,e){var{parser:t}=r,a=e[0];return{type:"overline",mode:t.mode,body:a}},htmlBuilder(r,e){var t=F(r.body,e.havingCrampedStyle()),a=b.makeLineSpan("overline-line",e),i=e.fontMetrics().defaultRuleThickness,s=b.makeVList({positionType:"firstBaseline",children:[{type:"elem",elem:t},{type:"kern",size:3*i},{type:"elem",elem:a},{type:"kern",size:i}]},e);return b.makeSpan(["mord","overline"],[s],e)},mathmlBuilder(r,e){var t=new S.MathNode("mo",[new S.TextNode("‾")]);t.setAttribute("stretchy","true");var a=new S.MathNode("mover",[X(r.body,e),t]);return a.setAttribute("accent","true"),a}});B({type:"phantom",names:["\\phantom"],props:{numArgs:1,allowedInText:!0},handler:(r,e)=>{var{parser:t}=r,a=e[0];return{type:"phantom",mode:t.mode,body:Q(a)}},htmlBuilder:(r,e)=>{var t=t0(r.body,e.withPhantom(),!1);return b.makeFragment(t)},mathmlBuilder:(r,e)=>{var t=h0(r.body,e);return new S.MathNode("mphantom",t)}});B({type:"hphantom",names:["\\hphantom"],props:{numArgs:1,allowedInText:!0},handler:(r,e)=>{var{parser:t}=r,a=e[0];return{type:"hphantom",mode:t.mode,body:a}},htmlBuilder:(r,e)=>{var t=b.makeSpan([],[F(r.body,e.withPhantom())]);if(t.height=0,t.depth=0,t.children)for(var a=0;a<t.children.length;a++)t.children[a].height=0,t.children[a].depth=0;return t=b.makeVList({positionType:"firstBaseline",children:[{type:"elem",elem:t}]},e),b.makeSpan(["mord"],[t],e)},mathmlBuilder:(r,e)=>{var t=h0(Q(r.body),e),a=new S.MathNode("mphantom",t),i=new S.MathNode("mpadded",[a]);return i.setAttribute("height","0px"),i.setAttribute("depth","0px"),i}});B({type:"vphantom",names:["\\vphantom"],props:{numArgs:1,allowedInText:!0},handler:(r,e)=>{var{parser:t}=r,a=e[0];return{type:"vphantom",mode:t.mode,body:a}},htmlBuilder:(r,e)=>{var t=b.makeSpan(["inner"],[F(r.body,e.withPhantom())]),a=b.makeSpan(["fix"],[]);return b.makeSpan(["mord","rlap"],[t,a],e)},mathmlBuilder:(r,e)=>{var t=h0(Q(r.body),e),a=new S.MathNode("mphantom",t),i=new S.MathNode("mpadded",[a]);return i.setAttribute("width","0px"),i}});B({type:"raisebox",names:["\\raisebox"],props:{numArgs:2,argTypes:["size","hbox"],allowedInText:!0},handler(r,e){var{parser:t}=r,a=H(e[0],"size").value,i=e[1];return{type:"raisebox",mode:t.mode,dy:a,body:i}},htmlBuilder(r,e){var t=F(r.body,e),a=K(r.dy,e);return b.makeVList({positionType:"shift",positionData:-a,children:[{type:"elem",elem:t}]},e)},mathmlBuilder(r,e){var t=new S.MathNode("mpadded",[X(r.body,e)]),a=r.dy.number+r.dy.unit;return t.setAttribute("voffset",a),t}});B({type:"internal",names:["\\relax"],props:{numArgs:0,allowedInText:!0,allowedInArgument:!0},handler(r){var{parser:e}=r;return{type:"internal",mode:e.mode}}});B({type:"rule",names:["\\rule"],props:{numArgs:2,numOptionalArgs:1,allowedInText:!0,allowedInMath:!0,argTypes:["size","size","size"]},handler(r,e,t){var{parser:a}=r,i=t[0],s=H(e[0],"size"),o=H(e[1],"size");return{type:"rule",mode:a.mode,shift:i&&H(i,"size").value,width:s.value,height:o.value}},htmlBuilder(r,e){var t=b.makeSpan(["mord","rule"],[],e),a=K(r.width,e),i=K(r.height,e),s=r.shift?K(r.shift,e):0;return t.style.borderRightWidth=T(a),t.style.borderTopWidth=T(i),t.style.bottom=T(s),t.width=a,t.height=i+s,t.depth=-s,t.maxFontSize=i*1.125*e.sizeMultiplier,t},mathmlBuilder(r,e){var t=K(r.width,e),a=K(r.height,e),i=r.shift?K(r.shift,e):0,s=e.color&&e.getColor()||"black",o=new S.MathNode("mspace");o.setAttribute("mathbackground",s),o.setAttribute("width",T(t)),o.setAttribute("height",T(a));var m=new S.MathNode("mpadded",[o]);return i>=0?m.setAttribute("height",T(i)):(m.setAttribute("height",T(i)),m.setAttribute("depth",T(-i))),m.setAttribute("voffset",T(i)),m}});function aa(r,e,t){for(var a=t0(r,e,!1),i=e.sizeMultiplier/t.sizeMultiplier,s=0;s<a.length;s++){var o=a[s].classes.indexOf("sizing");o<0?Array.prototype.push.apply(a[s].classes,e.sizingClasses(t)):a[s].classes[o+1]==="reset-size"+e.size&&(a[s].classes[o+1]="reset-size"+t.size),a[s].height*=i,a[s].depth*=i}return b.makeFragment(a)}var ir=["\\tiny","\\sixptsize","\\scriptsize","\\footnotesize","\\small","\\normalsize","\\large","\\Large","\\LARGE","\\huge","\\Huge"],K1=(r,e)=>{var t=e.havingSize(r.size);return aa(r.body,t,e)};B({type:"sizing",names:ir,props:{numArgs:0,allowedInText:!0},handler:(r,e)=>{var{breakOnTokenText:t,funcName:a,parser:i}=r,s=i.parseExpression(!1,t);return{type:"sizing",mode:i.mode,size:ir.indexOf(a)+1,body:s}},htmlBuilder:K1,mathmlBuilder:(r,e)=>{var t=e.havingSize(r.size),a=h0(r.body,t),i=new S.MathNode("mstyle",a);return i.setAttribute("mathsize",T(t.sizeMultiplier)),i}});B({type:"smash",names:["\\smash"],props:{numArgs:1,numOptionalArgs:1,allowedInText:!0},handler:(r,e,t)=>{var{parser:a}=r,i=!1,s=!1,o=t[0]&&H(t[0],"ordgroup");if(o)for(var m="",c=0;c<o.body.length;++c){var p=o.body[c];if(m=p.text,m==="t")i=!0;else if(m==="b")s=!0;else{i=!1,s=!1;break}}else i=!0,s=!0;var g=e[0];return{type:"smash",mode:a.mode,body:g,smashHeight:i,smashDepth:s}},htmlBuilder:(r,e)=>{var t=b.makeSpan([],[F(r.body,e)]);if(!r.smashHeight&&!r.smashDepth)return t;if(r.smashHeight&&(t.height=0,t.children))for(var a=0;a<t.children.length;a++)t.children[a].height=0;if(r.smashDepth&&(t.depth=0,t.children))for(var i=0;i<t.children.length;i++)t.children[i].depth=0;var s=b.makeVList({positionType:"firstBaseline",children:[{type:"elem",elem:t}]},e);return b.makeSpan(["mord"],[s],e)},mathmlBuilder:(r,e)=>{var t=new S.MathNode("mpadded",[X(r.body,e)]);return r.smashHeight&&t.setAttribute("height","0px"),r.smashDepth&&t.setAttribute("depth","0px"),t}});B({type:"sqrt",names:["\\sqrt"],props:{numArgs:1,numOptionalArgs:1},handler(r,e,t){var{parser:a}=r,i=t[0],s=e[0];return{type:"sqrt",mode:a.mode,body:s,index:i}},htmlBuilder(r,e){var t=F(r.body,e.havingCrampedStyle());t.height===0&&(t.height=e.fontMetrics().xHeight),t=b.wrapFragment(t,e);var a=e.fontMetrics(),i=a.defaultRuleThickness,s=i;e.style.id<I.TEXT.id&&(s=e.fontMetrics().xHeight);var o=i+s/4,m=t.height+t.depth+o+i,{span:c,ruleWidth:p,advanceWidth:g}=N0.sqrtImage(m,e),y=c.height-p;y>t.height+t.depth+o&&(o=(o+y-t.height-t.depth)/2);var x=c.height-t.height-o-p;t.style.paddingLeft=T(g);var w=b.makeVList({positionType:"firstBaseline",children:[{type:"elem",elem:t,wrapperClasses:["svg-align"]},{type:"kern",size:-(t.height+x)},{type:"elem",elem:c},{type:"kern",size:p}]},e);if(r.index){var z=e.havingStyle(I.SCRIPTSCRIPT),A=F(r.index,z,e),C=.6*(w.height-w.depth),q=b.makeVList({positionType:"shift",positionData:-C,children:[{type:"elem",elem:A}]},e),E=b.makeSpan(["root"],[q]);return b.makeSpan(["mord","sqrt"],[E,w],e)}else return b.makeSpan(["mord","sqrt"],[w],e)},mathmlBuilder(r,e){var{body:t,index:a}=r;return a?new S.MathNode("mroot",[X(t,e),X(a,e)]):new S.MathNode("msqrt",[X(t,e)])}});var nr={display:I.DISPLAY,text:I.TEXT,script:I.SCRIPT,scriptscript:I.SCRIPTSCRIPT};B({type:"styling",names:["\\displaystyle","\\textstyle","\\scriptstyle","\\scriptscriptstyle"],props:{numArgs:0,allowedInText:!0,primitive:!0},handler(r,e){var{breakOnTokenText:t,funcName:a,parser:i}=r,s=i.parseExpression(!0,t),o=a.slice(1,a.length-5);return{type:"styling",mode:i.mode,style:o,body:s}},htmlBuilder(r,e){var t=nr[r.style],a=e.havingStyle(t).withFont("");return aa(r.body,a,e)},mathmlBuilder(r,e){var t=nr[r.style],a=e.havingStyle(t),i=h0(r.body,a),s=new S.MathNode("mstyle",i),o={display:["0","true"],text:["0","false"],script:["1","false"],scriptscript:["2","false"]},m=o[r.style];return s.setAttribute("scriptlevel",m[0]),s.setAttribute("displaystyle",m[1]),s}});var J1=function(e,t){var a=e.base;if(a)if(a.type==="op"){var i=a.limits&&(t.style.size===I.DISPLAY.size||a.alwaysHandleSupSub);return i?ae:null}else if(a.type==="operatorname"){var s=a.alwaysHandleSupSub&&(t.style.size===I.DISPLAY.size||a.limits);return s?ra:null}else{if(a.type==="accent")return G.isCharacterBox(a.base)?xt:null;if(a.type==="horizBrace"){var o=!e.sub;return o===a.isOver?_r:null}else return null}else return null};W0({type:"supsub",htmlBuilder(r,e){var t=J1(r,e);if(t)return t(r,e);var{base:a,sup:i,sub:s}=r,o=F(a,e),m,c,p=e.fontMetrics(),g=0,y=0,x=a&&G.isCharacterBox(a);if(i){var w=e.havingStyle(e.style.sup());m=F(i,w,e),x||(g=o.height-w.fontMetrics().supDrop*w.sizeMultiplier/e.sizeMultiplier)}if(s){var z=e.havingStyle(e.style.sub());c=F(s,z,e),x||(y=o.depth+z.fontMetrics().subDrop*z.sizeMultiplier/e.sizeMultiplier)}var A;e.style===I.DISPLAY?A=p.sup1:e.style.cramped?A=p.sup3:A=p.sup2;var C=e.sizeMultiplier,q=T(.5/p.ptPerEm/C),E=null;if(c){var O=r.base&&r.base.type==="op"&&r.base.name&&(r.base.name==="\\oiint"||r.base.name==="\\oiiint");(o instanceof p0||O)&&(E=T(-o.italic))}var V;if(m&&c){g=Math.max(g,A,m.depth+.25*p.xHeight),y=Math.max(y,p.sub2);var L=p.defaultRuleThickness,U=4*L;if(g-m.depth-(c.height-y)<U){y=U-(g-m.depth)+c.height;var P=.8*p.xHeight-(g-m.depth);P>0&&(g+=P,y-=P)}var j=[{type:"elem",elem:c,shift:y,marginRight:q,marginLeft:E},{type:"elem",elem:m,shift:-g,marginRight:q}];V=b.makeVList({positionType:"individualShift",children:j},e)}else if(c){y=Math.max(y,p.sub1,c.height-.8*p.xHeight);var Y=[{type:"elem",elem:c,marginLeft:E,marginRight:q}];V=b.makeVList({positionType:"shift",positionData:y,children:Y},e)}else if(m)g=Math.max(g,A,m.depth+.25*p.xHeight),V=b.makeVList({positionType:"shift",positionData:-g,children:[{type:"elem",elem:m,marginRight:q}]},e);else throw new Error("supsub must have either sup or sub.");var z0=ot(o,"right")||"mord";return b.makeSpan([z0],[o,b.makeSpan(["msupsub"],[V])],e)},mathmlBuilder(r,e){var t=!1,a,i;r.base&&r.base.type==="horizBrace"&&(i=!!r.sup,i===r.base.isOver&&(t=!0,a=r.base.isOver)),r.base&&(r.base.type==="op"||r.base.type==="operatorname")&&(r.base.parentIsSupSub=!0);var s=[X(r.base,e)];r.sub&&s.push(X(r.sub,e)),r.sup&&s.push(X(r.sup,e));var o;if(t)o=a?"mover":"munder";else if(r.sub)if(r.sup){var p=r.base;p&&p.type==="op"&&p.limits&&e.style===I.DISPLAY||p&&p.type==="operatorname"&&p.alwaysHandleSupSub&&(e.style===I.DISPLAY||p.limits)?o="munderover":o="msubsup"}else{var c=r.base;c&&c.type==="op"&&c.limits&&(e.style===I.DISPLAY||c.alwaysHandleSupSub)||c&&c.type==="operatorname"&&c.alwaysHandleSupSub&&(c.limits||e.style===I.DISPLAY)?o="munder":o="msub"}else{var m=r.base;m&&m.type==="op"&&m.limits&&(e.style===I.DISPLAY||m.alwaysHandleSupSub)||m&&m.type==="operatorname"&&m.alwaysHandleSupSub&&(m.limits||e.style===I.DISPLAY)?o="mover":o="msup"}return new S.MathNode(o,s)}});W0({type:"atom",htmlBuilder(r,e){return b.mathsym(r.text,r.mode,e,["m"+r.family])},mathmlBuilder(r,e){var t=new S.MathNode("mo",[v0(r.text,r.mode)]);if(r.family==="bin"){var a=yt(r,e);a==="bold-italic"&&t.setAttribute("mathvariant",a)}else r.family==="punct"?t.setAttribute("separator","true"):(r.family==="open"||r.family==="close")&&t.setAttribute("stretchy","false");return t}});var ia={mi:"italic",mn:"normal",mtext:"normal"};W0({type:"mathord",htmlBuilder(r,e){return b.makeOrd(r,e,"mathord")},mathmlBuilder(r,e){var t=new S.MathNode("mi",[v0(r.text,r.mode,e)]),a=yt(r,e)||"italic";return a!==ia[t.type]&&t.setAttribute("mathvariant",a),t}});W0({type:"textord",htmlBuilder(r,e){return b.makeOrd(r,e,"textord")},mathmlBuilder(r,e){var t=v0(r.text,r.mode,e),a=yt(r,e)||"normal",i;return r.mode==="text"?i=new S.MathNode("mtext",[t]):/[0-9]/.test(r.text)?i=new S.MathNode("mn",[t]):r.text==="\\prime"?i=new S.MathNode("mo",[t]):i=new S.MathNode("mi",[t]),a!==ia[i.type]&&i.setAttribute("mathvariant",a),i}});var tt={"\\nobreak":"nobreak","\\allowbreak":"allowbreak"},rt={" ":{},"\\ ":{},"~":{className:"nobreak"},"\\space":{},"\\nobreakspace":{className:"nobreak"}};W0({type:"spacing",htmlBuilder(r,e){if(rt.hasOwnProperty(r.text)){var t=rt[r.text].className||"";if(r.mode==="text"){var a=b.makeOrd(r,e,"textord");return a.classes.push(t),a}else return b.makeSpan(["mspace",t],[b.mathsym(r.text,r.mode,e)],e)}else{if(tt.hasOwnProperty(r.text))return b.makeSpan(["mspace",tt[r.text]],[],e);throw new M('Unknown type of space "'+r.text+'"')}},mathmlBuilder(r,e){var t;if(rt.hasOwnProperty(r.text))t=new S.MathNode("mtext",[new S.TextNode(" ")]);else{if(tt.hasOwnProperty(r.text))return new S.MathNode("mspace");throw new M('Unknown type of space "'+r.text+'"')}return t}});var sr=()=>{var r=new S.MathNode("mtd",[]);return r.setAttribute("width","50%"),r};W0({type:"tag",mathmlBuilder(r,e){var t=new S.MathNode("mtable",[new S.MathNode("mtr",[sr(),new S.MathNode("mtd",[V0(r.body,e)]),sr(),new S.MathNode("mtd",[V0(r.tag,e)])])]);return t.setAttribute("width","100%"),t}});var lr={"\\text":void 0,"\\textrm":"textrm","\\textsf":"textsf","\\texttt":"texttt","\\textnormal":"textrm"},or={"\\textbf":"textbf","\\textmd":"textmd"},Q1={"\\textit":"textit","\\textup":"textup"},hr=(r,e)=>{var t=r.font;if(t){if(lr[t])return e.withTextFontFamily(lr[t]);if(or[t])return e.withTextFontWeight(or[t]);if(t==="\\emph")return e.fontShape==="textit"?e.withTextFontShape("textup"):e.withTextFontShape("textit")}else return e;return e.withTextFontShape(Q1[t])};B({type:"text",names:["\\text","\\textrm","\\textsf","\\texttt","\\textnormal","\\textbf","\\textmd","\\textit","\\textup","\\emph"],props:{numArgs:1,argTypes:["text"],allowedInArgument:!0,allowedInText:!0},handler(r,e){var{parser:t,funcName:a}=r,i=e[0];return{type:"text",mode:t.mode,body:Q(i),font:a}},htmlBuilder(r,e){var t=hr(r,e),a=t0(r.body,t,!0);return b.makeSpan(["mord","text"],a,t)},mathmlBuilder(r,e){var t=hr(r,e);return V0(r.body,t)}});B({type:"underline",names:["\\underline"],props:{numArgs:1,allowedInText:!0},handler(r,e){var{parser:t}=r;return{type:"underline",mode:t.mode,body:e[0]}},htmlBuilder(r,e){var t=F(r.body,e),a=b.makeLineSpan("underline-line",e),i=e.fontMetrics().defaultRuleThickness,s=b.makeVList({positionType:"top",positionData:t.height,children:[{type:"kern",size:i},{type:"elem",elem:a},{type:"kern",size:3*i},{type:"elem",elem:t}]},e);return b.makeSpan(["mord","underline"],[s],e)},mathmlBuilder(r,e){var t=new S.MathNode("mo",[new S.TextNode("‾")]);t.setAttribute("stretchy","true");var a=new S.MathNode("munder",[X(r.body,e),t]);return a.setAttribute("accentunder","true"),a}});B({type:"vcenter",names:["\\vcenter"],props:{numArgs:1,argTypes:["original"],allowedInText:!1},handler(r,e){var{parser:t}=r;return{type:"vcenter",mode:t.mode,body:e[0]}},htmlBuilder(r,e){var t=F(r.body,e),a=e.fontMetrics().axisHeight,i=.5*(t.height-a-(t.depth+a));return b.makeVList({positionType:"shift",positionData:i,children:[{type:"elem",elem:t}]},e)},mathmlBuilder(r,e){return new S.MathNode("mpadded",[X(r.body,e)],["vcenter"])}});B({type:"verb",names:["\\verb"],props:{numArgs:0,allowedInText:!0},handler(r,e,t){throw new M("\\verb ended by end of line instead of matching delimiter")},htmlBuilder(r,e){for(var t=mr(r),a=[],i=e.havingStyle(e.style.text()),s=0;s<t.length;s++){var o=t[s];o==="~"&&(o="\\textasciitilde"),a.push(b.makeSymbol(o,"Typewriter-Regular",r.mode,i,["mord","texttt"]))}return b.makeSpan(["mord","text"].concat(i.sizingClasses(e)),b.tryCombineChars(a),i)},mathmlBuilder(r,e){var t=new S.TextNode(mr(r)),a=new S.MathNode("mtext",[t]);return a.setAttribute("mathvariant","monospace"),a}});var mr=r=>r.body.replace(/ /g,r.star?"␣":" "),F0=Ar,na=`[ \r
-	]`,_1="\\\\[a-zA-Z@]+",e4="\\\\[^\uD800-\uDFFF]",t4="("+_1+")"+na+"*",r4=`\\\\(
-|[ \r	]+
-?)[ \r	]*`,ct="[̀-ͯ]",a4=new RegExp(ct+"+$"),i4="("+na+"+)|"+(r4+"|")+"([!-\\[\\]-‧‪-퟿豈-￿]"+(ct+"*")+"|[\uD800-\uDBFF][\uDC00-\uDFFF]"+(ct+"*")+"|\\\\verb\\*([^]).*?\\4|\\\\verb([^*a-zA-Z]).*?\\5"+("|"+t4)+("|"+e4+")");class ur{constructor(e,t){this.input=void 0,this.settings=void 0,this.tokenRegex=void 0,this.catcodes=void 0,this.input=e,this.settings=t,this.tokenRegex=new RegExp(i4,"g"),this.catcodes={"%":14,"~":13}}setCatcode(e,t){this.catcodes[e]=t}lex(){var e=this.input,t=this.tokenRegex.lastIndex;if(t===e.length)return new u0("EOF",new o0(this,t,t));var a=this.tokenRegex.exec(e);if(a===null||a.index!==t)throw new M("Unexpected character: '"+e[t]+"'",new u0(e[t],new o0(this,t,t+1)));var i=a[6]||a[3]||(a[2]?"\\ ":" ");if(this.catcodes[i]===14){var s=e.indexOf(`
-`,this.tokenRegex.lastIndex);return s===-1?(this.tokenRegex.lastIndex=e.length,this.settings.reportNonstrict("commentAtEnd","% comment has no terminating newline; LaTeX would fail because of commenting the end of math mode (e.g. $)")):this.tokenRegex.lastIndex=s+1,this.lex()}return new u0(i,new o0(this,t,this.tokenRegex.lastIndex))}}class n4{constructor(e,t){e===void 0&&(e={}),t===void 0&&(t={}),this.current=void 0,this.builtins=void 0,this.undefStack=void 0,this.current=t,this.builtins=e,this.undefStack=[]}beginGroup(){this.undefStack.push({})}endGroup(){if(this.undefStack.length===0)throw new M("Unbalanced namespace destruction: attempt to pop global namespace; please report this as a bug");var e=this.undefStack.pop();for(var t in e)e.hasOwnProperty(t)&&(e[t]==null?delete this.current[t]:this.current[t]=e[t])}endGroups(){for(;this.undefStack.length>0;)this.endGroup()}has(e){return this.current.hasOwnProperty(e)||this.builtins.hasOwnProperty(e)}get(e){return this.current.hasOwnProperty(e)?this.current[e]:this.builtins[e]}set(e,t,a){if(a===void 0&&(a=!1),a){for(var i=0;i<this.undefStack.length;i++)delete this.undefStack[i][e];this.undefStack.length>0&&(this.undefStack[this.undefStack.length-1][e]=t)}else{var s=this.undefStack[this.undefStack.length-1];s&&!s.hasOwnProperty(e)&&(s[e]=this.current[e])}t==null?delete this.current[e]:this.current[e]=t}}var s4=jr;u("\\noexpand",function(r){var e=r.popToken();return r.isExpandable(e.text)&&(e.noexpand=!0,e.treatAsRelax=!0),{tokens:[e],numArgs:0}});u("\\expandafter",function(r){var e=r.popToken();return r.expandOnce(!0),{tokens:[e],numArgs:0}});u("\\@firstoftwo",function(r){var e=r.consumeArgs(2);return{tokens:e[0],numArgs:0}});u("\\@secondoftwo",function(r){var e=r.consumeArgs(2);return{tokens:e[1],numArgs:0}});u("\\@ifnextchar",function(r){var e=r.consumeArgs(3);r.consumeSpaces();var t=r.future();return e[0].length===1&&e[0][0].text===t.text?{tokens:e[1],numArgs:0}:{tokens:e[2],numArgs:0}});u("\\@ifstar","\\@ifnextchar *{\\@firstoftwo{#1}}");u("\\TextOrMath",function(r){var e=r.consumeArgs(2);return r.mode==="text"?{tokens:e[0],numArgs:0}:{tokens:e[1],numArgs:0}});var cr={0:0,1:1,2:2,3:3,4:4,5:5,6:6,7:7,8:8,9:9,a:10,A:10,b:11,B:11,c:12,C:12,d:13,D:13,e:14,E:14,f:15,F:15};u("\\char",function(r){var e=r.popToken(),t,a="";if(e.text==="'")t=8,e=r.popToken();else if(e.text==='"')t=16,e=r.popToken();else if(e.text==="`")if(e=r.popToken(),e.text[0]==="\\")a=e.text.charCodeAt(1);else{if(e.text==="EOF")throw new M("\\char` missing argument");a=e.text.charCodeAt(0)}else t=10;if(t){if(a=cr[e.text],a==null||a>=t)throw new M("Invalid base-"+t+" digit "+e.text);for(var i;(i=cr[r.future().text])!=null&&i<t;)a*=t,a+=i,r.popToken()}return"\\@char{"+a+"}"});var Nt=(r,e,t,a)=>{var i=r.consumeArg().tokens;if(i.length!==1)throw new M("\\newcommand's first argument must be a macro name");var s=i[0].text,o=r.isDefined(s);if(o&&!e)throw new M("\\newcommand{"+s+"} attempting to redefine "+(s+"; use \\renewcommand"));if(!o&&!t)throw new M("\\renewcommand{"+s+"} when command "+s+" does not yet exist; use \\newcommand");var m=0;if(i=r.consumeArg().tokens,i.length===1&&i[0].text==="["){for(var c="",p=r.expandNextToken();p.text!=="]"&&p.text!=="EOF";)c+=p.text,p=r.expandNextToken();if(!c.match(/^\s*[0-9]+\s*$/))throw new M("Invalid number of arguments: "+c);m=parseInt(c),i=r.consumeArg().tokens}return o&&a||r.macros.set(s,{tokens:i,numArgs:m}),""};u("\\newcommand",r=>Nt(r,!1,!0,!1));u("\\renewcommand",r=>Nt(r,!0,!1,!1));u("\\providecommand",r=>Nt(r,!0,!0,!0));u("\\message",r=>{var e=r.consumeArgs(1)[0];return console.log(e.reverse().map(t=>t.text).join("")),""});u("\\errmessage",r=>{var e=r.consumeArgs(1)[0];return console.error(e.reverse().map(t=>t.text).join("")),""});u("\\show",r=>{var e=r.popToken(),t=e.text;return console.log(e,r.macros.get(t),F0[t],$.math[t],$.text[t]),""});u("\\bgroup","{");u("\\egroup","}");u("~","\\nobreakspace");u("\\lq","`");u("\\rq","'");u("\\aa","\\r a");u("\\AA","\\r A");u("\\textcopyright","\\html@mathml{\\textcircled{c}}{\\char`©}");u("\\copyright","\\TextOrMath{\\textcopyright}{\\text{\\textcopyright}}");u("\\textregistered","\\html@mathml{\\textcircled{\\scriptsize R}}{\\char`®}");u("ℬ","\\mathscr{B}");u("ℰ","\\mathscr{E}");u("ℱ","\\mathscr{F}");u("ℋ","\\mathscr{H}");u("ℐ","\\mathscr{I}");u("ℒ","\\mathscr{L}");u("ℳ","\\mathscr{M}");u("ℛ","\\mathscr{R}");u("ℭ","\\mathfrak{C}");u("ℌ","\\mathfrak{H}");u("ℨ","\\mathfrak{Z}");u("\\Bbbk","\\Bbb{k}");u("·","\\cdotp");u("\\llap","\\mathllap{\\textrm{#1}}");u("\\rlap","\\mathrlap{\\textrm{#1}}");u("\\clap","\\mathclap{\\textrm{#1}}");u("\\mathstrut","\\vphantom{(}");u("\\underbar","\\underline{\\text{#1}}");u("\\not",'\\html@mathml{\\mathrel{\\mathrlap\\@not}}{\\char"338}');u("\\neq","\\html@mathml{\\mathrel{\\not=}}{\\mathrel{\\char`≠}}");u("\\ne","\\neq");u("≠","\\neq");u("\\notin","\\html@mathml{\\mathrel{{\\in}\\mathllap{/\\mskip1mu}}}{\\mathrel{\\char`∉}}");u("∉","\\notin");u("≘","\\html@mathml{\\mathrel{=\\kern{-1em}\\raisebox{0.4em}{$\\scriptsize\\frown$}}}{\\mathrel{\\char`≘}}");u("≙","\\html@mathml{\\stackrel{\\tiny\\wedge}{=}}{\\mathrel{\\char`≘}}");u("≚","\\html@mathml{\\stackrel{\\tiny\\vee}{=}}{\\mathrel{\\char`≚}}");u("≛","\\html@mathml{\\stackrel{\\scriptsize\\star}{=}}{\\mathrel{\\char`≛}}");u("≝","\\html@mathml{\\stackrel{\\tiny\\mathrm{def}}{=}}{\\mathrel{\\char`≝}}");u("≞","\\html@mathml{\\stackrel{\\tiny\\mathrm{m}}{=}}{\\mathrel{\\char`≞}}");u("≟","\\html@mathml{\\stackrel{\\tiny?}{=}}{\\mathrel{\\char`≟}}");u("⟂","\\perp");u("‼","\\mathclose{!\\mkern-0.8mu!}");u("∌","\\notni");u("⌜","\\ulcorner");u("⌝","\\urcorner");u("⌞","\\llcorner");u("⌟","\\lrcorner");u("©","\\copyright");u("®","\\textregistered");u("️","\\textregistered");u("\\ulcorner",'\\html@mathml{\\@ulcorner}{\\mathop{\\char"231c}}');u("\\urcorner",'\\html@mathml{\\@urcorner}{\\mathop{\\char"231d}}');u("\\llcorner",'\\html@mathml{\\@llcorner}{\\mathop{\\char"231e}}');u("\\lrcorner",'\\html@mathml{\\@lrcorner}{\\mathop{\\char"231f}}');u("\\vdots","{\\varvdots\\rule{0pt}{15pt}}");u("⋮","\\vdots");u("\\varGamma","\\mathit{\\Gamma}");u("\\varDelta","\\mathit{\\Delta}");u("\\varTheta","\\mathit{\\Theta}");u("\\varLambda","\\mathit{\\Lambda}");u("\\varXi","\\mathit{\\Xi}");u("\\varPi","\\mathit{\\Pi}");u("\\varSigma","\\mathit{\\Sigma}");u("\\varUpsilon","\\mathit{\\Upsilon}");u("\\varPhi","\\mathit{\\Phi}");u("\\varPsi","\\mathit{\\Psi}");u("\\varOmega","\\mathit{\\Omega}");u("\\substack","\\begin{subarray}{c}#1\\end{subarray}");u("\\colon","\\nobreak\\mskip2mu\\mathpunct{}\\mathchoice{\\mkern-3mu}{\\mkern-3mu}{}{}{:}\\mskip6mu\\relax");u("\\boxed","\\fbox{$\\displaystyle{#1}$}");u("\\iff","\\DOTSB\\;\\Longleftrightarrow\\;");u("\\implies","\\DOTSB\\;\\Longrightarrow\\;");u("\\impliedby","\\DOTSB\\;\\Longleftarrow\\;");u("\\dddot","{\\overset{\\raisebox{-0.1ex}{\\normalsize ...}}{#1}}");u("\\ddddot","{\\overset{\\raisebox{-0.1ex}{\\normalsize ....}}{#1}}");var dr={",":"\\dotsc","\\not":"\\dotsb","+":"\\dotsb","=":"\\dotsb","<":"\\dotsb",">":"\\dotsb","-":"\\dotsb","*":"\\dotsb",":":"\\dotsb","\\DOTSB":"\\dotsb","\\coprod":"\\dotsb","\\bigvee":"\\dotsb","\\bigwedge":"\\dotsb","\\biguplus":"\\dotsb","\\bigcap":"\\dotsb","\\bigcup":"\\dotsb","\\prod":"\\dotsb","\\sum":"\\dotsb","\\bigotimes":"\\dotsb","\\bigoplus":"\\dotsb","\\bigodot":"\\dotsb","\\bigsqcup":"\\dotsb","\\And":"\\dotsb","\\longrightarrow":"\\dotsb","\\Longrightarrow":"\\dotsb","\\longleftarrow":"\\dotsb","\\Longleftarrow":"\\dotsb","\\longleftrightarrow":"\\dotsb","\\Longleftrightarrow":"\\dotsb","\\mapsto":"\\dotsb","\\longmapsto":"\\dotsb","\\hookrightarrow":"\\dotsb","\\doteq":"\\dotsb","\\mathbin":"\\dotsb","\\mathrel":"\\dotsb","\\relbar":"\\dotsb","\\Relbar":"\\dotsb","\\xrightarrow":"\\dotsb","\\xleftarrow":"\\dotsb","\\DOTSI":"\\dotsi","\\int":"\\dotsi","\\oint":"\\dotsi","\\iint":"\\dotsi","\\iiint":"\\dotsi","\\iiiint":"\\dotsi","\\idotsint":"\\dotsi","\\DOTSX":"\\dotsx"};u("\\dots",function(r){var e="\\dotso",t=r.expandAfterFuture().text;return t in dr?e=dr[t]:(t.slice(0,4)==="\\not"||t in $.math&&["bin","rel"].includes($.math[t].group))&&(e="\\dotsb"),e});var Ct={")":!0,"]":!0,"\\rbrack":!0,"\\}":!0,"\\rbrace":!0,"\\rangle":!0,"\\rceil":!0,"\\rfloor":!0,"\\rgroup":!0,"\\rmoustache":!0,"\\right":!0,"\\bigr":!0,"\\biggr":!0,"\\Bigr":!0,"\\Biggr":!0,$:!0,";":!0,".":!0,",":!0};u("\\dotso",function(r){var e=r.future().text;return e in Ct?"\\ldots\\,":"\\ldots"});u("\\dotsc",function(r){var e=r.future().text;return e in Ct&&e!==","?"\\ldots\\,":"\\ldots"});u("\\cdots",function(r){var e=r.future().text;return e in Ct?"\\@cdots\\,":"\\@cdots"});u("\\dotsb","\\cdots");u("\\dotsm","\\cdots");u("\\dotsi","\\!\\cdots");u("\\dotsx","\\ldots\\,");u("\\DOTSI","\\relax");u("\\DOTSB","\\relax");u("\\DOTSX","\\relax");u("\\tmspace","\\TextOrMath{\\kern#1#3}{\\mskip#1#2}\\relax");u("\\,","\\tmspace+{3mu}{.1667em}");u("\\thinspace","\\,");u("\\>","\\mskip{4mu}");u("\\:","\\tmspace+{4mu}{.2222em}");u("\\medspace","\\:");u("\\;","\\tmspace+{5mu}{.2777em}");u("\\thickspace","\\;");u("\\!","\\tmspace-{3mu}{.1667em}");u("\\negthinspace","\\!");u("\\negmedspace","\\tmspace-{4mu}{.2222em}");u("\\negthickspace","\\tmspace-{5mu}{.277em}");u("\\enspace","\\kern.5em ");u("\\enskip","\\hskip.5em\\relax");u("\\quad","\\hskip1em\\relax");u("\\qquad","\\hskip2em\\relax");u("\\tag","\\@ifstar\\tag@literal\\tag@paren");u("\\tag@paren","\\tag@literal{({#1})}");u("\\tag@literal",r=>{if(r.macros.get("\\df@tag"))throw new M("Multiple \\tag");return"\\gdef\\df@tag{\\text{#1}}"});u("\\bmod","\\mathchoice{\\mskip1mu}{\\mskip1mu}{\\mskip5mu}{\\mskip5mu}\\mathbin{\\rm mod}\\mathchoice{\\mskip1mu}{\\mskip1mu}{\\mskip5mu}{\\mskip5mu}");u("\\pod","\\allowbreak\\mathchoice{\\mkern18mu}{\\mkern8mu}{\\mkern8mu}{\\mkern8mu}(#1)");u("\\pmod","\\pod{{\\rm mod}\\mkern6mu#1}");u("\\mod","\\allowbreak\\mathchoice{\\mkern18mu}{\\mkern12mu}{\\mkern12mu}{\\mkern12mu}{\\rm mod}\\,\\,#1");u("\\newline","\\\\\\relax");u("\\TeX","\\textrm{\\html@mathml{T\\kern-.1667em\\raisebox{-.5ex}{E}\\kern-.125emX}{TeX}}");var sa=T(w0["Main-Regular"][84][1]-.7*w0["Main-Regular"][65][1]);u("\\LaTeX","\\textrm{\\html@mathml{"+("L\\kern-.36em\\raisebox{"+sa+"}{\\scriptstyle A}")+"\\kern-.15em\\TeX}{LaTeX}}");u("\\KaTeX","\\textrm{\\html@mathml{"+("K\\kern-.17em\\raisebox{"+sa+"}{\\scriptstyle A}")+"\\kern-.15em\\TeX}{KaTeX}}");u("\\hspace","\\@ifstar\\@hspacer\\@hspace");u("\\@hspace","\\hskip #1\\relax");u("\\@hspacer","\\rule{0pt}{0pt}\\hskip #1\\relax");u("\\ordinarycolon",":");u("\\vcentcolon","\\mathrel{\\mathop\\ordinarycolon}");u("\\dblcolon",'\\html@mathml{\\mathrel{\\vcentcolon\\mathrel{\\mkern-.9mu}\\vcentcolon}}{\\mathop{\\char"2237}}');u("\\coloneqq",'\\html@mathml{\\mathrel{\\vcentcolon\\mathrel{\\mkern-1.2mu}=}}{\\mathop{\\char"2254}}');u("\\Coloneqq",'\\html@mathml{\\mathrel{\\dblcolon\\mathrel{\\mkern-1.2mu}=}}{\\mathop{\\char"2237\\char"3d}}');u("\\coloneq",'\\html@mathml{\\mathrel{\\vcentcolon\\mathrel{\\mkern-1.2mu}\\mathrel{-}}}{\\mathop{\\char"3a\\char"2212}}');u("\\Coloneq",'\\html@mathml{\\mathrel{\\dblcolon\\mathrel{\\mkern-1.2mu}\\mathrel{-}}}{\\mathop{\\char"2237\\char"2212}}');u("\\eqqcolon",'\\html@mathml{\\mathrel{=\\mathrel{\\mkern-1.2mu}\\vcentcolon}}{\\mathop{\\char"2255}}');u("\\Eqqcolon",'\\html@mathml{\\mathrel{=\\mathrel{\\mkern-1.2mu}\\dblcolon}}{\\mathop{\\char"3d\\char"2237}}');u("\\eqcolon",'\\html@mathml{\\mathrel{\\mathrel{-}\\mathrel{\\mkern-1.2mu}\\vcentcolon}}{\\mathop{\\char"2239}}');u("\\Eqcolon",'\\html@mathml{\\mathrel{\\mathrel{-}\\mathrel{\\mkern-1.2mu}\\dblcolon}}{\\mathop{\\char"2212\\char"2237}}');u("\\colonapprox",'\\html@mathml{\\mathrel{\\vcentcolon\\mathrel{\\mkern-1.2mu}\\approx}}{\\mathop{\\char"3a\\char"2248}}');u("\\Colonapprox",'\\html@mathml{\\mathrel{\\dblcolon\\mathrel{\\mkern-1.2mu}\\approx}}{\\mathop{\\char"2237\\char"2248}}');u("\\colonsim",'\\html@mathml{\\mathrel{\\vcentcolon\\mathrel{\\mkern-1.2mu}\\sim}}{\\mathop{\\char"3a\\char"223c}}');u("\\Colonsim",'\\html@mathml{\\mathrel{\\dblcolon\\mathrel{\\mkern-1.2mu}\\sim}}{\\mathop{\\char"2237\\char"223c}}');u("∷","\\dblcolon");u("∹","\\eqcolon");u("≔","\\coloneqq");u("≕","\\eqqcolon");u("⩴","\\Coloneqq");u("\\ratio","\\vcentcolon");u("\\coloncolon","\\dblcolon");u("\\colonequals","\\coloneqq");u("\\coloncolonequals","\\Coloneqq");u("\\equalscolon","\\eqqcolon");u("\\equalscoloncolon","\\Eqqcolon");u("\\colonminus","\\coloneq");u("\\coloncolonminus","\\Coloneq");u("\\minuscolon","\\eqcolon");u("\\minuscoloncolon","\\Eqcolon");u("\\coloncolonapprox","\\Colonapprox");u("\\coloncolonsim","\\Colonsim");u("\\simcolon","\\mathrel{\\sim\\mathrel{\\mkern-1.2mu}\\vcentcolon}");u("\\simcoloncolon","\\mathrel{\\sim\\mathrel{\\mkern-1.2mu}\\dblcolon}");u("\\approxcolon","\\mathrel{\\approx\\mathrel{\\mkern-1.2mu}\\vcentcolon}");u("\\approxcoloncolon","\\mathrel{\\approx\\mathrel{\\mkern-1.2mu}\\dblcolon}");u("\\notni","\\html@mathml{\\not\\ni}{\\mathrel{\\char`∌}}");u("\\limsup","\\DOTSB\\operatorname*{lim\\,sup}");u("\\liminf","\\DOTSB\\operatorname*{lim\\,inf}");u("\\injlim","\\DOTSB\\operatorname*{inj\\,lim}");u("\\projlim","\\DOTSB\\operatorname*{proj\\,lim}");u("\\varlimsup","\\DOTSB\\operatorname*{\\overline{lim}}");u("\\varliminf","\\DOTSB\\operatorname*{\\underline{lim}}");u("\\varinjlim","\\DOTSB\\operatorname*{\\underrightarrow{lim}}");u("\\varprojlim","\\DOTSB\\operatorname*{\\underleftarrow{lim}}");u("\\gvertneqq","\\html@mathml{\\@gvertneqq}{≩}");u("\\lvertneqq","\\html@mathml{\\@lvertneqq}{≨}");u("\\ngeqq","\\html@mathml{\\@ngeqq}{≱}");u("\\ngeqslant","\\html@mathml{\\@ngeqslant}{≱}");u("\\nleqq","\\html@mathml{\\@nleqq}{≰}");u("\\nleqslant","\\html@mathml{\\@nleqslant}{≰}");u("\\nshortmid","\\html@mathml{\\@nshortmid}{∤}");u("\\nshortparallel","\\html@mathml{\\@nshortparallel}{∦}");u("\\nsubseteqq","\\html@mathml{\\@nsubseteqq}{⊈}");u("\\nsupseteqq","\\html@mathml{\\@nsupseteqq}{⊉}");u("\\varsubsetneq","\\html@mathml{\\@varsubsetneq}{⊊}");u("\\varsubsetneqq","\\html@mathml{\\@varsubsetneqq}{⫋}");u("\\varsupsetneq","\\html@mathml{\\@varsupsetneq}{⊋}");u("\\varsupsetneqq","\\html@mathml{\\@varsupsetneqq}{⫌}");u("\\imath","\\html@mathml{\\@imath}{ı}");u("\\jmath","\\html@mathml{\\@jmath}{ȷ}");u("\\llbracket","\\html@mathml{\\mathopen{[\\mkern-3.2mu[}}{\\mathopen{\\char`⟦}}");u("\\rrbracket","\\html@mathml{\\mathclose{]\\mkern-3.2mu]}}{\\mathclose{\\char`⟧}}");u("⟦","\\llbracket");u("⟧","\\rrbracket");u("\\lBrace","\\html@mathml{\\mathopen{\\{\\mkern-3.2mu[}}{\\mathopen{\\char`⦃}}");u("\\rBrace","\\html@mathml{\\mathclose{]\\mkern-3.2mu\\}}}{\\mathclose{\\char`⦄}}");u("⦃","\\lBrace");u("⦄","\\rBrace");u("\\minuso","\\mathbin{\\html@mathml{{\\mathrlap{\\mathchoice{\\kern{0.145em}}{\\kern{0.145em}}{\\kern{0.1015em}}{\\kern{0.0725em}}\\circ}{-}}}{\\char`⦵}}");u("⦵","\\minuso");u("\\darr","\\downarrow");u("\\dArr","\\Downarrow");u("\\Darr","\\Downarrow");u("\\lang","\\langle");u("\\rang","\\rangle");u("\\uarr","\\uparrow");u("\\uArr","\\Uparrow");u("\\Uarr","\\Uparrow");u("\\N","\\mathbb{N}");u("\\R","\\mathbb{R}");u("\\Z","\\mathbb{Z}");u("\\alef","\\aleph");u("\\alefsym","\\aleph");u("\\Alpha","\\mathrm{A}");u("\\Beta","\\mathrm{B}");u("\\bull","\\bullet");u("\\Chi","\\mathrm{X}");u("\\clubs","\\clubsuit");u("\\cnums","\\mathbb{C}");u("\\Complex","\\mathbb{C}");u("\\Dagger","\\ddagger");u("\\diamonds","\\diamondsuit");u("\\empty","\\emptyset");u("\\Epsilon","\\mathrm{E}");u("\\Eta","\\mathrm{H}");u("\\exist","\\exists");u("\\harr","\\leftrightarrow");u("\\hArr","\\Leftrightarrow");u("\\Harr","\\Leftrightarrow");u("\\hearts","\\heartsuit");u("\\image","\\Im");u("\\infin","\\infty");u("\\Iota","\\mathrm{I}");u("\\isin","\\in");u("\\Kappa","\\mathrm{K}");u("\\larr","\\leftarrow");u("\\lArr","\\Leftarrow");u("\\Larr","\\Leftarrow");u("\\lrarr","\\leftrightarrow");u("\\lrArr","\\Leftrightarrow");u("\\Lrarr","\\Leftrightarrow");u("\\Mu","\\mathrm{M}");u("\\natnums","\\mathbb{N}");u("\\Nu","\\mathrm{N}");u("\\Omicron","\\mathrm{O}");u("\\plusmn","\\pm");u("\\rarr","\\rightarrow");u("\\rArr","\\Rightarrow");u("\\Rarr","\\Rightarrow");u("\\real","\\Re");u("\\reals","\\mathbb{R}");u("\\Reals","\\mathbb{R}");u("\\Rho","\\mathrm{P}");u("\\sdot","\\cdot");u("\\sect","\\S");u("\\spades","\\spadesuit");u("\\sub","\\subset");u("\\sube","\\subseteq");u("\\supe","\\supseteq");u("\\Tau","\\mathrm{T}");u("\\thetasym","\\vartheta");u("\\weierp","\\wp");u("\\Zeta","\\mathrm{Z}");u("\\argmin","\\DOTSB\\operatorname*{arg\\,min}");u("\\argmax","\\DOTSB\\operatorname*{arg\\,max}");u("\\plim","\\DOTSB\\mathop{\\operatorname{plim}}\\limits");u("\\bra","\\mathinner{\\langle{#1}|}");u("\\ket","\\mathinner{|{#1}\\rangle}");u("\\braket","\\mathinner{\\langle{#1}\\rangle}");u("\\Bra","\\left\\langle#1\\right|");u("\\Ket","\\left|#1\\right\\rangle");var la=r=>e=>{var t=e.consumeArg().tokens,a=e.consumeArg().tokens,i=e.consumeArg().tokens,s=e.consumeArg().tokens,o=e.macros.get("|"),m=e.macros.get("\\|");e.macros.beginGroup();var c=y=>x=>{r&&(x.macros.set("|",o),i.length&&x.macros.set("\\|",m));var w=y;if(!y&&i.length){var z=x.future();z.text==="|"&&(x.popToken(),w=!0)}return{tokens:w?i:a,numArgs:0}};e.macros.set("|",c(!1)),i.length&&e.macros.set("\\|",c(!0));var p=e.consumeArg().tokens,g=e.expandTokens([...s,...p,...t]);return e.macros.endGroup(),{tokens:g.reverse(),numArgs:0}};u("\\bra@ket",la(!1));u("\\bra@set",la(!0));u("\\Braket","\\bra@ket{\\left\\langle}{\\,\\middle\\vert\\,}{\\,\\middle\\vert\\,}{\\right\\rangle}");u("\\Set","\\bra@set{\\left\\{\\:}{\\;\\middle\\vert\\;}{\\;\\middle\\Vert\\;}{\\:\\right\\}}");u("\\set","\\bra@set{\\{\\,}{\\mid}{}{\\,\\}}");u("\\angln","{\\angl n}");u("\\blue","\\textcolor{##6495ed}{#1}");u("\\orange","\\textcolor{##ffa500}{#1}");u("\\pink","\\textcolor{##ff00af}{#1}");u("\\red","\\textcolor{##df0030}{#1}");u("\\green","\\textcolor{##28ae7b}{#1}");u("\\gray","\\textcolor{gray}{#1}");u("\\purple","\\textcolor{##9d38bd}{#1}");u("\\blueA","\\textcolor{##ccfaff}{#1}");u("\\blueB","\\textcolor{##80f6ff}{#1}");u("\\blueC","\\textcolor{##63d9ea}{#1}");u("\\blueD","\\textcolor{##11accd}{#1}");u("\\blueE","\\textcolor{##0c7f99}{#1}");u("\\tealA","\\textcolor{##94fff5}{#1}");u("\\tealB","\\textcolor{##26edd5}{#1}");u("\\tealC","\\textcolor{##01d1c1}{#1}");u("\\tealD","\\textcolor{##01a995}{#1}");u("\\tealE","\\textcolor{##208170}{#1}");u("\\greenA","\\textcolor{##b6ffb0}{#1}");u("\\greenB","\\textcolor{##8af281}{#1}");u("\\greenC","\\textcolor{##74cf70}{#1}");u("\\greenD","\\textcolor{##1fab54}{#1}");u("\\greenE","\\textcolor{##0d923f}{#1}");u("\\goldA","\\textcolor{##ffd0a9}{#1}");u("\\goldB","\\textcolor{##ffbb71}{#1}");u("\\goldC","\\textcolor{##ff9c39}{#1}");u("\\goldD","\\textcolor{##e07d10}{#1}");u("\\goldE","\\textcolor{##a75a05}{#1}");u("\\redA","\\textcolor{##fca9a9}{#1}");u("\\redB","\\textcolor{##ff8482}{#1}");u("\\redC","\\textcolor{##f9685d}{#1}");u("\\redD","\\textcolor{##e84d39}{#1}");u("\\redE","\\textcolor{##bc2612}{#1}");u("\\maroonA","\\textcolor{##ffbde0}{#1}");u("\\maroonB","\\textcolor{##ff92c6}{#1}");u("\\maroonC","\\textcolor{##ed5fa6}{#1}");u("\\maroonD","\\textcolor{##ca337c}{#1}");u("\\maroonE","\\textcolor{##9e034e}{#1}");u("\\purpleA","\\textcolor{##ddd7ff}{#1}");u("\\purpleB","\\textcolor{##c6b9fc}{#1}");u("\\purpleC","\\textcolor{##aa87ff}{#1}");u("\\purpleD","\\textcolor{##7854ab}{#1}");u("\\purpleE","\\textcolor{##543b78}{#1}");u("\\mintA","\\textcolor{##f5f9e8}{#1}");u("\\mintB","\\textcolor{##edf2df}{#1}");u("\\mintC","\\textcolor{##e0e5cc}{#1}");u("\\grayA","\\textcolor{##f6f7f7}{#1}");u("\\grayB","\\textcolor{##f0f1f2}{#1}");u("\\grayC","\\textcolor{##e3e5e6}{#1}");u("\\grayD","\\textcolor{##d6d8da}{#1}");u("\\grayE","\\textcolor{##babec2}{#1}");u("\\grayF","\\textcolor{##888d93}{#1}");u("\\grayG","\\textcolor{##626569}{#1}");u("\\grayH","\\textcolor{##3b3e40}{#1}");u("\\grayI","\\textcolor{##21242c}{#1}");u("\\kaBlue","\\textcolor{##314453}{#1}");u("\\kaGreen","\\textcolor{##71B307}{#1}");var oa={"^":!0,_:!0,"\\limits":!0,"\\nolimits":!0};class l4{constructor(e,t,a){this.settings=void 0,this.expansionCount=void 0,this.lexer=void 0,this.macros=void 0,this.stack=void 0,this.mode=void 0,this.settings=t,this.expansionCount=0,this.feed(e),this.macros=new n4(s4,t.macros),this.mode=a,this.stack=[]}feed(e){this.lexer=new ur(e,this.settings)}switchMode(e){this.mode=e}beginGroup(){this.macros.beginGroup()}endGroup(){this.macros.endGroup()}endGroups(){this.macros.endGroups()}future(){return this.stack.length===0&&this.pushToken(this.lexer.lex()),this.stack[this.stack.length-1]}popToken(){return this.future(),this.stack.pop()}pushToken(e){this.stack.push(e)}pushTokens(e){this.stack.push(...e)}scanArgument(e){var t,a,i;if(e){if(this.consumeSpaces(),this.future().text!=="[")return null;t=this.popToken(),{tokens:i,end:a}=this.consumeArg(["]"])}else({tokens:i,start:t,end:a}=this.consumeArg());return this.pushToken(new u0("EOF",a.loc)),this.pushTokens(i),new u0("",o0.range(t,a))}consumeSpaces(){for(;;){var e=this.future();if(e.text===" ")this.stack.pop();else break}}consumeArg(e){var t=[],a=e&&e.length>0;a||this.consumeSpaces();var i=this.future(),s,o=0,m=0;do{if(s=this.popToken(),t.push(s),s.text==="{")++o;else if(s.text==="}"){if(--o,o===-1)throw new M("Extra }",s)}else if(s.text==="EOF")throw new M("Unexpected end of input in a macro argument, expected '"+(e&&a?e[m]:"}")+"'",s);if(e&&a)if((o===0||o===1&&e[m]==="{")&&s.text===e[m]){if(++m,m===e.length){t.splice(-m,m);break}}else m=0}while(o!==0||a);return i.text==="{"&&t[t.length-1].text==="}"&&(t.pop(),t.shift()),t.reverse(),{tokens:t,start:i,end:s}}consumeArgs(e,t){if(t){if(t.length!==e+1)throw new M("The length of delimiters doesn't match the number of args!");for(var a=t[0],i=0;i<a.length;i++){var s=this.popToken();if(a[i]!==s.text)throw new M("Use of the macro doesn't match its definition",s)}}for(var o=[],m=0;m<e;m++)o.push(this.consumeArg(t&&t[m+1]).tokens);return o}countExpansion(e){if(this.expansionCount+=e,this.expansionCount>this.settings.maxExpand)throw new M("Too many expansions: infinite loop or need to increase maxExpand setting")}expandOnce(e){var t=this.popToken(),a=t.text,i=t.noexpand?null:this._getExpansion(a);if(i==null||e&&i.unexpandable){if(e&&i==null&&a[0]==="\\"&&!this.isDefined(a))throw new M("Undefined control sequence: "+a);return this.pushToken(t),!1}this.countExpansion(1);var s=i.tokens,o=this.consumeArgs(i.numArgs,i.delimiters);if(i.numArgs){s=s.slice();for(var m=s.length-1;m>=0;--m){var c=s[m];if(c.text==="#"){if(m===0)throw new M("Incomplete placeholder at end of macro body",c);if(c=s[--m],c.text==="#")s.splice(m+1,1);else if(/^[1-9]$/.test(c.text))s.splice(m,2,...o[+c.text-1]);else throw new M("Not a valid argument number",c)}}}return this.pushTokens(s),s.length}expandAfterFuture(){return this.expandOnce(),this.future()}expandNextToken(){for(;;)if(this.expandOnce()===!1){var e=this.stack.pop();return e.treatAsRelax&&(e.text="\\relax"),e}throw new Error}expandMacro(e){return this.macros.has(e)?this.expandTokens([new u0(e)]):void 0}expandTokens(e){var t=[],a=this.stack.length;for(this.pushTokens(e);this.stack.length>a;)if(this.expandOnce(!0)===!1){var i=this.stack.pop();i.treatAsRelax&&(i.noexpand=!1,i.treatAsRelax=!1),t.push(i)}return this.countExpansion(t.length),t}expandMacroAsText(e){var t=this.expandMacro(e);return t&&t.map(a=>a.text).join("")}_getExpansion(e){var t=this.macros.get(e);if(t==null)return t;if(e.length===1){var a=this.lexer.catcodes[e];if(a!=null&&a!==13)return}var i=typeof t=="function"?t(this):t;if(typeof i=="string"){var s=0;if(i.indexOf("#")!==-1)for(var o=i.replace(/##/g,"");o.indexOf("#"+(s+1))!==-1;)++s;for(var m=new ur(i,this.settings),c=[],p=m.lex();p.text!=="EOF";)c.push(p),p=m.lex();c.reverse();var g={tokens:c,numArgs:s};return g}return i}isDefined(e){return this.macros.has(e)||F0.hasOwnProperty(e)||$.math.hasOwnProperty(e)||$.text.hasOwnProperty(e)||oa.hasOwnProperty(e)}isExpandable(e){var t=this.macros.get(e);return t!=null?typeof t=="string"||typeof t=="function"||!t.unexpandable:F0.hasOwnProperty(e)&&!F0[e].primitive}}var fr=/^[₊₋₌₍₎₀₁₂₃₄₅₆₇₈₉ₐₑₕᵢⱼₖₗₘₙₒₚᵣₛₜᵤᵥₓᵦᵧᵨᵩᵪ]/,Me=Object.freeze({"₊":"+","₋":"-","₌":"=","₍":"(","₎":")","₀":"0","₁":"1","₂":"2","₃":"3","₄":"4","₅":"5","₆":"6","₇":"7","₈":"8","₉":"9","ₐ":"a","ₑ":"e","ₕ":"h","ᵢ":"i","ⱼ":"j","ₖ":"k","ₗ":"l","ₘ":"m","ₙ":"n","ₒ":"o","ₚ":"p","ᵣ":"r","ₛ":"s","ₜ":"t","ᵤ":"u","ᵥ":"v","ₓ":"x","ᵦ":"β","ᵧ":"γ","ᵨ":"ρ","ᵩ":"ϕ","ᵪ":"χ","⁺":"+","⁻":"-","⁼":"=","⁽":"(","⁾":")","⁰":"0","¹":"1","²":"2","³":"3","⁴":"4","⁵":"5","⁶":"6","⁷":"7","⁸":"8","⁹":"9","ᴬ":"A","ᴮ":"B","ᴰ":"D","ᴱ":"E","ᴳ":"G","ᴴ":"H","ᴵ":"I","ᴶ":"J","ᴷ":"K","ᴸ":"L","ᴹ":"M","ᴺ":"N","ᴼ":"O","ᴾ":"P","ᴿ":"R","ᵀ":"T","ᵁ":"U","ⱽ":"V","ᵂ":"W","ᵃ":"a","ᵇ":"b","ᶜ":"c","ᵈ":"d","ᵉ":"e","ᶠ":"f","ᵍ":"g",ʰ:"h","ⁱ":"i",ʲ:"j","ᵏ":"k",ˡ:"l","ᵐ":"m",ⁿ:"n","ᵒ":"o","ᵖ":"p",ʳ:"r",ˢ:"s","ᵗ":"t","ᵘ":"u","ᵛ":"v",ʷ:"w",ˣ:"x",ʸ:"y","ᶻ":"z","ᵝ":"β","ᵞ":"γ","ᵟ":"δ","ᵠ":"ϕ","ᵡ":"χ","ᶿ":"θ"}),at={"́":{text:"\\'",math:"\\acute"},"̀":{text:"\\`",math:"\\grave"},"̈":{text:'\\"',math:"\\ddot"},"̃":{text:"\\~",math:"\\tilde"},"̄":{text:"\\=",math:"\\bar"},"̆":{text:"\\u",math:"\\breve"},"̌":{text:"\\v",math:"\\check"},"̂":{text:"\\^",math:"\\hat"},"̇":{text:"\\.",math:"\\dot"},"̊":{text:"\\r",math:"\\mathring"},"̋":{text:"\\H"},"̧":{text:"\\c"}},pr={á:"á",à:"à",ä:"ä",ǟ:"ǟ",ã:"ã",ā:"ā",ă:"ă",ắ:"ắ",ằ:"ằ",ẵ:"ẵ",ǎ:"ǎ",â:"â",ấ:"ấ",ầ:"ầ",ẫ:"ẫ",ȧ:"ȧ",ǡ:"ǡ",å:"å",ǻ:"ǻ",ḃ:"ḃ",ć:"ć",ḉ:"ḉ",č:"č",ĉ:"ĉ",ċ:"ċ",ç:"ç",ď:"ď",ḋ:"ḋ",ḑ:"ḑ",é:"é",è:"è",ë:"ë",ẽ:"ẽ",ē:"ē",ḗ:"ḗ",ḕ:"ḕ",ĕ:"ĕ",ḝ:"ḝ",ě:"ě",ê:"ê",ế:"ế",ề:"ề",ễ:"ễ",ė:"ė",ȩ:"ȩ",ḟ:"ḟ",ǵ:"ǵ",ḡ:"ḡ",ğ:"ğ",ǧ:"ǧ",ĝ:"ĝ",ġ:"ġ",ģ:"ģ",ḧ:"ḧ",ȟ:"ȟ",ĥ:"ĥ",ḣ:"ḣ",ḩ:"ḩ",í:"í",ì:"ì",ï:"ï",ḯ:"ḯ",ĩ:"ĩ",ī:"ī",ĭ:"ĭ",ǐ:"ǐ",î:"î",ǰ:"ǰ",ĵ:"ĵ",ḱ:"ḱ",ǩ:"ǩ",ķ:"ķ",ĺ:"ĺ",ľ:"ľ",ļ:"ļ",ḿ:"ḿ",ṁ:"ṁ",ń:"ń",ǹ:"ǹ",ñ:"ñ",ň:"ň",ṅ:"ṅ",ņ:"ņ",ó:"ó",ò:"ò",ö:"ö",ȫ:"ȫ",õ:"õ",ṍ:"ṍ",ṏ:"ṏ",ȭ:"ȭ",ō:"ō",ṓ:"ṓ",ṑ:"ṑ",ŏ:"ŏ",ǒ:"ǒ",ô:"ô",ố:"ố",ồ:"ồ",ỗ:"ỗ",ȯ:"ȯ",ȱ:"ȱ",ő:"ő",ṕ:"ṕ",ṗ:"ṗ",ŕ:"ŕ",ř:"ř",ṙ:"ṙ",ŗ:"ŗ",ś:"ś",ṥ:"ṥ",š:"š",ṧ:"ṧ",ŝ:"ŝ",ṡ:"ṡ",ş:"ş",ẗ:"ẗ",ť:"ť",ṫ:"ṫ",ţ:"ţ",ú:"ú",ù:"ù",ü:"ü",ǘ:"ǘ",ǜ:"ǜ",ǖ:"ǖ",ǚ:"ǚ",ũ:"ũ",ṹ:"ṹ",ū:"ū",ṻ:"ṻ",ŭ:"ŭ",ǔ:"ǔ",û:"û",ů:"ů",ű:"ű",ṽ:"ṽ",ẃ:"ẃ",ẁ:"ẁ",ẅ:"ẅ",ŵ:"ŵ",ẇ:"ẇ",ẘ:"ẘ",ẍ:"ẍ",ẋ:"ẋ",ý:"ý",ỳ:"ỳ",ÿ:"ÿ",ỹ:"ỹ",ȳ:"ȳ",ŷ:"ŷ",ẏ:"ẏ",ẙ:"ẙ",ź:"ź",ž:"ž",ẑ:"ẑ",ż:"ż",Á:"Á",À:"À",Ä:"Ä",Ǟ:"Ǟ",Ã:"Ã",Ā:"Ā",Ă:"Ă",Ắ:"Ắ",Ằ:"Ằ",Ẵ:"Ẵ",Ǎ:"Ǎ",Â:"Â",Ấ:"Ấ",Ầ:"Ầ",Ẫ:"Ẫ",Ȧ:"Ȧ",Ǡ:"Ǡ",Å:"Å",Ǻ:"Ǻ",Ḃ:"Ḃ",Ć:"Ć",Ḉ:"Ḉ",Č:"Č",Ĉ:"Ĉ",Ċ:"Ċ",Ç:"Ç",Ď:"Ď",Ḋ:"Ḋ",Ḑ:"Ḑ",É:"É",È:"È",Ë:"Ë",Ẽ:"Ẽ",Ē:"Ē",Ḗ:"Ḗ",Ḕ:"Ḕ",Ĕ:"Ĕ",Ḝ:"Ḝ",Ě:"Ě",Ê:"Ê",Ế:"Ế",Ề:"Ề",Ễ:"Ễ",Ė:"Ė",Ȩ:"Ȩ",Ḟ:"Ḟ",Ǵ:"Ǵ",Ḡ:"Ḡ",Ğ:"Ğ",Ǧ:"Ǧ",Ĝ:"Ĝ",Ġ:"Ġ",Ģ:"Ģ",Ḧ:"Ḧ",Ȟ:"Ȟ",Ĥ:"Ĥ",Ḣ:"Ḣ",Ḩ:"Ḩ",Í:"Í",Ì:"Ì",Ï:"Ï",Ḯ:"Ḯ",Ĩ:"Ĩ",Ī:"Ī",Ĭ:"Ĭ",Ǐ:"Ǐ",Î:"Î",İ:"İ",Ĵ:"Ĵ",Ḱ:"Ḱ",Ǩ:"Ǩ",Ķ:"Ķ",Ĺ:"Ĺ",Ľ:"Ľ",Ļ:"Ļ",Ḿ:"Ḿ",Ṁ:"Ṁ",Ń:"Ń",Ǹ:"Ǹ",Ñ:"Ñ",Ň:"Ň",Ṅ:"Ṅ",Ņ:"Ņ",Ó:"Ó",Ò:"Ò",Ö:"Ö",Ȫ:"Ȫ",Õ:"Õ",Ṍ:"Ṍ",Ṏ:"Ṏ",Ȭ:"Ȭ",Ō:"Ō",Ṓ:"Ṓ",Ṑ:"Ṑ",Ŏ:"Ŏ",Ǒ:"Ǒ",Ô:"Ô",Ố:"Ố",Ồ:"Ồ",Ỗ:"Ỗ",Ȯ:"Ȯ",Ȱ:"Ȱ",Ő:"Ő",Ṕ:"Ṕ",Ṗ:"Ṗ",Ŕ:"Ŕ",Ř:"Ř",Ṙ:"Ṙ",Ŗ:"Ŗ",Ś:"Ś",Ṥ:"Ṥ",Š:"Š",Ṧ:"Ṧ",Ŝ:"Ŝ",Ṡ:"Ṡ",Ş:"Ş",Ť:"Ť",Ṫ:"Ṫ",Ţ:"Ţ",Ú:"Ú",Ù:"Ù",Ü:"Ü",Ǘ:"Ǘ",Ǜ:"Ǜ",Ǖ:"Ǖ",Ǚ:"Ǚ",Ũ:"Ũ",Ṹ:"Ṹ",Ū:"Ū",Ṻ:"Ṻ",Ŭ:"Ŭ",Ǔ:"Ǔ",Û:"Û",Ů:"Ů",Ű:"Ű",Ṽ:"Ṽ",Ẃ:"Ẃ",Ẁ:"Ẁ",Ẅ:"Ẅ",Ŵ:"Ŵ",Ẇ:"Ẇ",Ẍ:"Ẍ",Ẋ:"Ẋ",Ý:"Ý",Ỳ:"Ỳ",Ÿ:"Ÿ",Ỹ:"Ỹ",Ȳ:"Ȳ",Ŷ:"Ŷ",Ẏ:"Ẏ",Ź:"Ź",Ž:"Ž",Ẑ:"Ẑ",Ż:"Ż",ά:"ά",ὰ:"ὰ",ᾱ:"ᾱ",ᾰ:"ᾰ",έ:"έ",ὲ:"ὲ",ή:"ή",ὴ:"ὴ",ί:"ί",ὶ:"ὶ",ϊ:"ϊ",ΐ:"ΐ",ῒ:"ῒ",ῑ:"ῑ",ῐ:"ῐ",ό:"ό",ὸ:"ὸ",ύ:"ύ",ὺ:"ὺ",ϋ:"ϋ",ΰ:"ΰ",ῢ:"ῢ",ῡ:"ῡ",ῠ:"ῠ",ώ:"ώ",ὼ:"ὼ",Ύ:"Ύ",Ὺ:"Ὺ",Ϋ:"Ϋ",Ῡ:"Ῡ",Ῠ:"Ῠ",Ώ:"Ώ",Ὼ:"Ὼ"};class Le{constructor(e,t){this.mode=void 0,this.gullet=void 0,this.settings=void 0,this.leftrightDepth=void 0,this.nextToken=void 0,this.mode="math",this.gullet=new l4(e,t,this.mode),this.settings=t,this.leftrightDepth=0}expect(e,t){if(t===void 0&&(t=!0),this.fetch().text!==e)throw new M("Expected '"+e+"', got '"+this.fetch().text+"'",this.fetch());t&&this.consume()}consume(){this.nextToken=null}fetch(){return this.nextToken==null&&(this.nextToken=this.gullet.expandNextToken()),this.nextToken}switchMode(e){this.mode=e,this.gullet.switchMode(e)}parse(){this.settings.globalGroup||this.gullet.beginGroup(),this.settings.colorIsTextColor&&this.gullet.macros.set("\\color","\\textcolor");try{var e=this.parseExpression(!1);return this.expect("EOF"),this.settings.globalGroup||this.gullet.endGroup(),e}finally{this.gullet.endGroups()}}subparse(e){var t=this.nextToken;this.consume(),this.gullet.pushToken(new u0("}")),this.gullet.pushTokens(e);var a=this.parseExpression(!1);return this.expect("}"),this.nextToken=t,a}parseExpression(e,t){for(var a=[];;){this.mode==="math"&&this.consumeSpaces();var i=this.fetch();if(Le.endOfExpression.indexOf(i.text)!==-1||t&&i.text===t||e&&F0[i.text]&&F0[i.text].infix)break;var s=this.parseAtom(t);if(s){if(s.type==="internal")continue}else break;a.push(s)}return this.mode==="text"&&this.formLigatures(a),this.handleInfixNodes(a)}handleInfixNodes(e){for(var t=-1,a,i=0;i<e.length;i++)if(e[i].type==="infix"){if(t!==-1)throw new M("only one infix operator per group",e[i].token);t=i,a=e[i].replaceWith}if(t!==-1&&a){var s,o,m=e.slice(0,t),c=e.slice(t+1);m.length===1&&m[0].type==="ordgroup"?s=m[0]:s={type:"ordgroup",mode:this.mode,body:m},c.length===1&&c[0].type==="ordgroup"?o=c[0]:o={type:"ordgroup",mode:this.mode,body:c};var p;return a==="\\\\abovefrac"?p=this.callFunction(a,[s,e[t],o],[]):p=this.callFunction(a,[s,o],[]),[p]}else return e}handleSupSubscript(e){var t=this.fetch(),a=t.text;this.consume(),this.consumeSpaces();var i;do{var s;i=this.parseGroup(e)}while(((s=i)==null?void 0:s.type)==="internal");if(!i)throw new M("Expected group after '"+a+"'",t);return i}formatUnsupportedCmd(e){for(var t=[],a=0;a<e.length;a++)t.push({type:"textord",mode:"text",text:e[a]});var i={type:"text",mode:this.mode,body:t},s={type:"color",mode:this.mode,color:this.settings.errorColor,body:[i]};return s}parseAtom(e){var t=this.parseGroup("atom",e);if(t?.type==="internal"||this.mode==="text")return t;for(var a,i;;){this.consumeSpaces();var s=this.fetch();if(s.text==="\\limits"||s.text==="\\nolimits"){if(t&&t.type==="op"){var o=s.text==="\\limits";t.limits=o,t.alwaysHandleSupSub=!0}else if(t&&t.type==="operatorname")t.alwaysHandleSupSub&&(t.limits=s.text==="\\limits");else throw new M("Limit controls must follow a math operator",s);this.consume()}else if(s.text==="^"){if(a)throw new M("Double superscript",s);a=this.handleSupSubscript("superscript")}else if(s.text==="_"){if(i)throw new M("Double subscript",s);i=this.handleSupSubscript("subscript")}else if(s.text==="'"){if(a)throw new M("Double superscript",s);var m={type:"textord",mode:this.mode,text:"\\prime"},c=[m];for(this.consume();this.fetch().text==="'";)c.push(m),this.consume();this.fetch().text==="^"&&c.push(this.handleSupSubscript("superscript")),a={type:"ordgroup",mode:this.mode,body:c}}else if(Me[s.text]){var p=fr.test(s.text),g=[];for(g.push(new u0(Me[s.text])),this.consume();;){var y=this.fetch().text;if(!Me[y]||fr.test(y)!==p)break;g.unshift(new u0(Me[y])),this.consume()}var x=this.subparse(g);p?i={type:"ordgroup",mode:"math",body:x}:a={type:"ordgroup",mode:"math",body:x}}else break}return a||i?{type:"supsub",mode:this.mode,base:t,sup:a,sub:i}:t}parseFunction(e,t){var a=this.fetch(),i=a.text,s=F0[i];if(!s)return null;if(this.consume(),t&&t!=="atom"&&!s.allowedInArgument)throw new M("Got function '"+i+"' with no arguments"+(t?" as "+t:""),a);if(this.mode==="text"&&!s.allowedInText)throw new M("Can't use function '"+i+"' in text mode",a);if(this.mode==="math"&&s.allowedInMath===!1)throw new M("Can't use function '"+i+"' in math mode",a);var{args:o,optArgs:m}=this.parseArguments(i,s);return this.callFunction(i,o,m,a,e)}callFunction(e,t,a,i,s){var o={funcName:e,parser:this,token:i,breakOnTokenText:s},m=F0[e];if(m&&m.handler)return m.handler(o,t,a);throw new M("No function handler for "+e)}parseArguments(e,t){var a=t.numArgs+t.numOptionalArgs;if(a===0)return{args:[],optArgs:[]};for(var i=[],s=[],o=0;o<a;o++){var m=t.argTypes&&t.argTypes[o],c=o<t.numOptionalArgs;(t.primitive&&m==null||t.type==="sqrt"&&o===1&&s[0]==null)&&(m="primitive");var p=this.parseGroupOfType("argument to '"+e+"'",m,c);if(c)s.push(p);else if(p!=null)i.push(p);else throw new M("Null argument, please report this as a bug")}return{args:i,optArgs:s}}parseGroupOfType(e,t,a){switch(t){case"color":return this.parseColorGroup(a);case"size":return this.parseSizeGroup(a);case"url":return this.parseUrlGroup(a);case"math":case"text":return this.parseArgumentGroup(a,t);case"hbox":{var i=this.parseArgumentGroup(a,"text");return i!=null?{type:"styling",mode:i.mode,body:[i],style:"text"}:null}case"raw":{var s=this.parseStringGroup("raw",a);return s!=null?{type:"raw",mode:"text",string:s.text}:null}case"primitive":{if(a)throw new M("A primitive argument cannot be optional");var o=this.parseGroup(e);if(o==null)throw new M("Expected group as "+e,this.fetch());return o}case"original":case null:case void 0:return this.parseArgumentGroup(a);default:throw new M("Unknown group type as "+e,this.fetch())}}consumeSpaces(){for(;this.fetch().text===" ";)this.consume()}parseStringGroup(e,t){var a=this.gullet.scanArgument(t);if(a==null)return null;for(var i="",s;(s=this.fetch()).text!=="EOF";)i+=s.text,this.consume();return this.consume(),a.text=i,a}parseRegexGroup(e,t){for(var a=this.fetch(),i=a,s="",o;(o=this.fetch()).text!=="EOF"&&e.test(s+o.text);)i=o,s+=i.text,this.consume();if(s==="")throw new M("Invalid "+t+": '"+a.text+"'",a);return a.range(i,s)}parseColorGroup(e){var t=this.parseStringGroup("color",e);if(t==null)return null;var a=/^(#[a-f0-9]{3,4}|#[a-f0-9]{6}|#[a-f0-9]{8}|[a-f0-9]{6}|[a-z]+)$/i.exec(t.text);if(!a)throw new M("Invalid color: '"+t.text+"'",t);var i=a[0];return/^[0-9a-f]{6}$/i.test(i)&&(i="#"+i),{type:"color-token",mode:this.mode,color:i}}parseSizeGroup(e){var t,a=!1;if(this.gullet.consumeSpaces(),!e&&this.gullet.future().text!=="{"?t=this.parseRegexGroup(/^[-+]? *(?:$|\d+|\d+\.\d*|\.\d*) *[a-z]{0,2} *$/,"size"):t=this.parseStringGroup("size",e),!t)return null;!e&&t.text.length===0&&(t.text="0pt",a=!0);var i=/([-+]?) *(\d+(?:\.\d*)?|\.\d+) *([a-z]{2})/.exec(t.text);if(!i)throw new M("Invalid size: '"+t.text+"'",t);var s={number:+(i[1]+i[2]),unit:i[3]};if(!br(s))throw new M("Invalid unit: '"+s.unit+"'",t);return{type:"size",mode:this.mode,value:s,isBlank:a}}parseUrlGroup(e){this.gullet.lexer.setCatcode("%",13),this.gullet.lexer.setCatcode("~",12);var t=this.parseStringGroup("url",e);if(this.gullet.lexer.setCatcode("%",14),this.gullet.lexer.setCatcode("~",13),t==null)return null;var a=t.text.replace(/\\([#$%&~_^{}])/g,"$1");return{type:"url",mode:this.mode,url:a}}parseArgumentGroup(e,t){var a=this.gullet.scanArgument(e);if(a==null)return null;var i=this.mode;t&&this.switchMode(t),this.gullet.beginGroup();var s=this.parseExpression(!1,"EOF");this.expect("EOF"),this.gullet.endGroup();var o={type:"ordgroup",mode:this.mode,loc:a.loc,body:s};return t&&this.switchMode(i),o}parseGroup(e,t){var a=this.fetch(),i=a.text,s;if(i==="{"||i==="\\begingroup"){this.consume();var o=i==="{"?"}":"\\endgroup";this.gullet.beginGroup();var m=this.parseExpression(!1,o),c=this.fetch();this.expect(o),this.gullet.endGroup(),s={type:"ordgroup",mode:this.mode,loc:o0.range(a,c),body:m,semisimple:i==="\\begingroup"||void 0}}else if(s=this.parseFunction(t,e)||this.parseSymbol(),s==null&&i[0]==="\\"&&!oa.hasOwnProperty(i)){if(this.settings.throwOnError)throw new M("Undefined control sequence: "+i,a);s=this.formatUnsupportedCmd(i),this.consume()}return s}formLigatures(e){for(var t=e.length-1,a=0;a<t;++a){var i=e[a],s=i.text;s==="-"&&e[a+1].text==="-"&&(a+1<t&&e[a+2].text==="-"?(e.splice(a,3,{type:"textord",mode:"text",loc:o0.range(i,e[a+2]),text:"---"}),t-=2):(e.splice(a,2,{type:"textord",mode:"text",loc:o0.range(i,e[a+1]),text:"--"}),t-=1)),(s==="'"||s==="`")&&e[a+1].text===s&&(e.splice(a,2,{type:"textord",mode:"text",loc:o0.range(i,e[a+1]),text:s+s}),t-=1)}}parseSymbol(){var e=this.fetch(),t=e.text;if(/^\\verb[^a-zA-Z]/.test(t)){this.consume();var a=t.slice(5),i=a.charAt(0)==="*";if(i&&(a=a.slice(1)),a.length<2||a.charAt(0)!==a.slice(-1))throw new M(`\\verb assertion failed --
-                    please report what input caused this bug`);return a=a.slice(1,-1),{type:"verb",mode:"text",body:a,star:i}}pr.hasOwnProperty(t[0])&&!$[this.mode][t[0]]&&(this.settings.strict&&this.mode==="math"&&this.settings.reportNonstrict("unicodeTextInMathMode",'Accented Unicode text character "'+t[0]+'" used in math mode',e),t=pr[t[0]]+t.slice(1));var s=a4.exec(t);s&&(t=t.substring(0,s.index),t==="i"?t="ı":t==="j"&&(t="ȷ"));var o;if($[this.mode][t]){this.settings.strict&&this.mode==="math"&&lt.indexOf(t)>=0&&this.settings.reportNonstrict("unicodeTextInMathMode",'Latin-1/Unicode text character "'+t[0]+'" used in math mode',e);var m=$[this.mode][t].group,c=o0.range(e),p;if(Za.hasOwnProperty(m)){var g=m;p={type:"atom",mode:this.mode,family:g,loc:c,text:t}}else p={type:m,mode:this.mode,loc:c,text:t};o=p}else if(t.charCodeAt(0)>=128)this.settings.strict&&(gr(t.charCodeAt(0))?this.mode==="math"&&this.settings.reportNonstrict("unicodeTextInMathMode",'Unicode text character "'+t[0]+'" used in math mode',e):this.settings.reportNonstrict("unknownSymbol",'Unrecognized Unicode character "'+t[0]+'"'+(" ("+t.charCodeAt(0)+")"),e)),o={type:"textord",mode:"text",loc:o0.range(e),text:t};else return null;if(this.consume(),s)for(var y=0;y<s[0].length;y++){var x=s[0][y];if(!at[x])throw new M("Unknown accent ' "+x+"'",e);var w=at[x][this.mode]||at[x].text;if(!w)throw new M("Accent "+x+" unsupported in "+this.mode+" mode",e);o={type:"accent",mode:this.mode,loc:o0.range(e),label:w,isStretchy:!1,isShifty:!0,base:o}}return o}}Le.endOfExpression=["}","\\endgroup","\\end","\\right","&"];var qt=function(e,t){if(!(typeof e=="string"||e instanceof String))throw new TypeError("KaTeX can only parse string typed expression");var a=new Le(e,t);delete a.gullet.macros.current["\\df@tag"];var i=a.parse();if(delete a.gullet.macros.current["\\current@color"],delete a.gullet.macros.current["\\color"],a.gullet.macros.get("\\df@tag")){if(!t.displayMode)throw new M("\\tag works only in display equations");i=[{type:"tag",mode:"text",body:i,tag:a.subparse([new u0("\\df@tag")])}]}return i},ha=function(e,t,a){t.textContent="";var i=Rt(e,a).toNode();t.appendChild(i)};typeof document<"u"&&document.compatMode!=="CSS1Compat"&&(typeof console<"u"&&console.warn("Warning: KaTeX doesn't work in quirks mode. Make sure your website has a suitable doctype."),ha=function(){throw new M("KaTeX doesn't work in quirks mode.")});var o4=function(e,t){var a=Rt(e,t).toMarkup();return a},h4=function(e,t){var a=new dt(t);return qt(e,a)},ma=function(e,t,a){if(a.throwOnError||!(e instanceof M))throw e;var i=b.makeSpan(["katex-error"],[new p0(t)]);return i.setAttribute("title",e.toString()),i.setAttribute("style","color:"+a.errorColor),i},Rt=function(e,t){var a=new dt(t);try{var i=qt(e,a);return b1(i,e,a)}catch(s){return ma(s,e,a)}},m4=function(e,t){var a=new dt(t);try{var i=qt(e,a);return y1(i,e,a)}catch(s){return ma(s,e,a)}},u4="0.16.25",c4={Span:me,Anchor:vt,SymbolNode:p0,SvgNode:C0,PathNode:G0,LineNode:st},d4={version:u4,render:ha,renderToString:o4,ParseError:M,SETTINGS_SCHEMA:ze,__parse:h4,__renderToDomTree:Rt,__renderToHTMLTree:m4,__setFontMetrics:Ga,__defineSymbol:n,__defineFunction:B,__defineMacro:u,__domTree:c4};export{M as ParseError,ze as SETTINGS_SCHEMA,B as __defineFunction,u as __defineMacro,n as __defineSymbol,c4 as __domTree,h4 as __parse,Rt as __renderToDomTree,m4 as __renderToHTMLTree,Ga as __setFontMetrics,d4 as default,ha as render,o4 as renderToString,u4 as version};
diff --git a/docs/dist/assets/layout-Cg3H1pzX.js b/docs/dist/assets/layout-Cg3H1pzX.js
deleted file mode 100644
index 716fce05..00000000
--- a/docs/dist/assets/layout-Cg3H1pzX.js
+++ /dev/null
@@ -1 +0,0 @@
-import{G as g}from"./graph-DQwMrrst.js";import{b as Te,p as ce,q as le,g as X,e as ee,l as F,o as Ie,s as Me,c as Se,u as je,d as f,i as m,f as _,v as x,r as M}from"./_baseUniq-CfjWcJYV.js";import{f as O,b as he,a as Fe,c as Ve,d as Ae,t as V,m as w,e as P,h as ve,g as z,l as T,i as Be}from"./_basePickBy-CqMtcO3s.js";import{b8 as Ge,b9 as Ye,ba as De,aT as qe,bb as We,aX as pe,aW as we,bc as $e,aS as q,aA as Xe,aZ as ze,aC as Ue,bd as W}from"./index-BxX29htg.js";function He(e){return Ge(Ye(e,void 0,O),e+"")}var Ze=1,Je=4;function Ke(e){return Te(e,Ze|Je)}function Qe(e,n){return e==null?e:De(e,ce(n),qe)}function en(e,n){return e&&le(e,ce(n))}function nn(e,n){return e>n}function S(e,n){var r={};return n=X(n),le(e,function(t,a,i){We(r,a,n(t,a,i))}),r}function y(e){return e&&e.length?he(e,pe,nn):void 0}function U(e,n){return e&&e.length?he(e,X(n),Fe):void 0}function rn(e,n){var r=e.length;for(e.sort(n);r--;)e[r]=e[r].value;return e}function tn(e,n){if(e!==n){var r=e!==void 0,t=e===null,a=e===e,i=ee(e),o=n!==void 0,u=n===null,d=n===n,s=ee(n);if(!u&&!s&&!i&&e>n||i&&o&&d&&!u&&!s||t&&o&&d||!r&&d||!a)return 1;if(!t&&!i&&!s&&e<n||s&&r&&a&&!t&&!i||u&&r&&a||!o&&a||!d)return-1}return 0}function an(e,n,r){for(var t=-1,a=e.criteria,i=n.criteria,o=a.length,u=r.length;++t<o;){var d=tn(a[t],i[t]);if(d){if(t>=u)return d;var s=r[t];return d*(s=="desc"?-1:1)}}return e.index-n.index}function on(e,n,r){n.length?n=F(n,function(i){return we(i)?function(o){return Ie(o,i.length===1?i[0]:i)}:i}):n=[pe];var t=-1;n=F(n,$e(X));var a=Ve(e,function(i,o,u){var d=F(n,function(s){return s(i)});return{criteria:d,index:++t,value:i}});return rn(a,function(i,o){return an(i,o,r)})}function un(e,n){return Ae(e,n,function(r,t){return Me(e,t)})}var I=He(function(e,n){return e==null?{}:un(e,n)}),dn=Math.ceil,sn=Math.max;function fn(e,n,r,t){for(var a=-1,i=sn(dn((n-e)/(r||1)),0),o=Array(i);i--;)o[++a]=e,e+=r;return o}function cn(e){return function(n,r,t){return t&&typeof t!="number"&&q(n,r,t)&&(r=t=void 0),n=V(n),r===void 0?(r=n,n=0):r=V(r),t=t===void 0?n<r?1:-1:V(t),fn(n,r,t)}}var E=cn(),R=Xe(function(e,n){if(e==null)return[];var r=n.length;return r>1&&q(e,n[0],n[1])?n=[]:r>2&&q(n[0],n[1],n[2])&&(n=[n[0]]),on(e,Se(n),[])}),ln=0;function H(e){var n=++ln;return je(e)+n}function hn(e,n,r){for(var t=-1,a=e.length,i=n.length,o={};++t<a;){var u=t<i?n[t]:void 0;r(o,e[t],u)}return o}function vn(e,n){return hn(e||[],n||[],ze)}class pn{constructor(){var n={};n._next=n._prev=n,this._sentinel=n}dequeue(){var n=this._sentinel,r=n._prev;if(r!==n)return ne(r),r}enqueue(n){var r=this._sentinel;n._prev&&n._next&&ne(n),n._next=r._next,r._next._prev=n,r._next=n,n._prev=r}toString(){for(var n=[],r=this._sentinel,t=r._prev;t!==r;)n.push(JSON.stringify(t,wn)),t=t._prev;return"["+n.join(", ")+"]"}}function ne(e){e._prev._next=e._next,e._next._prev=e._prev,delete e._next,delete e._prev}function wn(e,n){if(e!=="_next"&&e!=="_prev")return n}var bn=Ue(1);function mn(e,n){if(e.nodeCount()<=1)return[];var r=yn(e,n||bn),t=gn(r.graph,r.buckets,r.zeroIdx);return O(w(t,function(a){return e.outEdges(a.v,a.w)}))}function gn(e,n,r){for(var t=[],a=n[n.length-1],i=n[0],o;e.nodeCount();){for(;o=i.dequeue();)A(e,n,r,o);for(;o=a.dequeue();)A(e,n,r,o);if(e.nodeCount()){for(var u=n.length-2;u>0;--u)if(o=n[u].dequeue(),o){t=t.concat(A(e,n,r,o,!0));break}}}return t}function A(e,n,r,t,a){var i=a?[]:void 0;return f(e.inEdges(t.v),function(o){var u=e.edge(o),d=e.node(o.v);a&&i.push({v:o.v,w:o.w}),d.out-=u,$(n,r,d)}),f(e.outEdges(t.v),function(o){var u=e.edge(o),d=o.w,s=e.node(d);s.in-=u,$(n,r,s)}),e.removeNode(t.v),i}function yn(e,n){var r=new g,t=0,a=0;f(e.nodes(),function(u){r.setNode(u,{v:u,in:0,out:0})}),f(e.edges(),function(u){var d=r.edge(u.v,u.w)||0,s=n(u),c=d+s;r.setEdge(u.v,u.w,c),a=Math.max(a,r.node(u.v).out+=s),t=Math.max(t,r.node(u.w).in+=s)});var i=E(a+t+3).map(function(){return new pn}),o=t+1;return f(r.nodes(),function(u){$(i,o,r.node(u))}),{graph:r,buckets:i,zeroIdx:o}}function $(e,n,r){r.out?r.in?e[r.out-r.in+n].enqueue(r):e[e.length-1].enqueue(r):e[0].enqueue(r)}function kn(e){var n=e.graph().acyclicer==="greedy"?mn(e,r(e)):xn(e);f(n,function(t){var a=e.edge(t);e.removeEdge(t),a.forwardName=t.name,a.reversed=!0,e.setEdge(t.w,t.v,a,H("rev"))});function r(t){return function(a){return t.edge(a).weight}}}function xn(e){var n=[],r={},t={};function a(i){Object.prototype.hasOwnProperty.call(t,i)||(t[i]=!0,r[i]=!0,f(e.outEdges(i),function(o){Object.prototype.hasOwnProperty.call(r,o.w)?n.push(o):a(o.w)}),delete r[i])}return f(e.nodes(),a),n}function En(e){f(e.edges(),function(n){var r=e.edge(n);if(r.reversed){e.removeEdge(n);var t=r.forwardName;delete r.reversed,delete r.forwardName,e.setEdge(n.w,n.v,r,t)}})}function L(e,n,r,t){var a;do a=H(t);while(e.hasNode(a));return r.dummy=n,e.setNode(a,r),a}function On(e){var n=new g().setGraph(e.graph());return f(e.nodes(),function(r){n.setNode(r,e.node(r))}),f(e.edges(),function(r){var t=n.edge(r.v,r.w)||{weight:0,minlen:1},a=e.edge(r);n.setEdge(r.v,r.w,{weight:t.weight+a.weight,minlen:Math.max(t.minlen,a.minlen)})}),n}function be(e){var n=new g({multigraph:e.isMultigraph()}).setGraph(e.graph());return f(e.nodes(),function(r){e.children(r).length||n.setNode(r,e.node(r))}),f(e.edges(),function(r){n.setEdge(r,e.edge(r))}),n}function re(e,n){var r=e.x,t=e.y,a=n.x-r,i=n.y-t,o=e.width/2,u=e.height/2;if(!a&&!i)throw new Error("Not possible to find intersection inside of the rectangle");var d,s;return Math.abs(i)*o>Math.abs(a)*u?(i<0&&(u=-u),d=u*a/i,s=u):(a<0&&(o=-o),d=o,s=o*i/a),{x:r+d,y:t+s}}function j(e){var n=w(E(me(e)+1),function(){return[]});return f(e.nodes(),function(r){var t=e.node(r),a=t.rank;m(a)||(n[a][t.order]=r)}),n}function Ln(e){var n=P(w(e.nodes(),function(r){return e.node(r).rank}));f(e.nodes(),function(r){var t=e.node(r);ve(t,"rank")&&(t.rank-=n)})}function Nn(e){var n=P(w(e.nodes(),function(i){return e.node(i).rank})),r=[];f(e.nodes(),function(i){var o=e.node(i).rank-n;r[o]||(r[o]=[]),r[o].push(i)});var t=0,a=e.graph().nodeRankFactor;f(r,function(i,o){m(i)&&o%a!==0?--t:t&&f(i,function(u){e.node(u).rank+=t})})}function te(e,n,r,t){var a={width:0,height:0};return arguments.length>=4&&(a.rank=r,a.order=t),L(e,"border",a,n)}function me(e){return y(w(e.nodes(),function(n){var r=e.node(n).rank;if(!m(r))return r}))}function Pn(e,n){var r={lhs:[],rhs:[]};return f(e,function(t){n(t)?r.lhs.push(t):r.rhs.push(t)}),r}function Cn(e,n){return n()}function _n(e){function n(r){var t=e.children(r),a=e.node(r);if(t.length&&f(t,n),Object.prototype.hasOwnProperty.call(a,"minRank")){a.borderLeft=[],a.borderRight=[];for(var i=a.minRank,o=a.maxRank+1;i<o;++i)ae(e,"borderLeft","_bl",r,a,i),ae(e,"borderRight","_br",r,a,i)}}f(e.children(),n)}function ae(e,n,r,t,a,i){var o={width:0,height:0,rank:i,borderType:n},u=a[n][i-1],d=L(e,"border",o,r);a[n][i]=d,e.setParent(d,t),u&&e.setEdge(u,d,{weight:1})}function Rn(e){var n=e.graph().rankdir.toLowerCase();(n==="lr"||n==="rl")&&ge(e)}function Tn(e){var n=e.graph().rankdir.toLowerCase();(n==="bt"||n==="rl")&&In(e),(n==="lr"||n==="rl")&&(Mn(e),ge(e))}function ge(e){f(e.nodes(),function(n){ie(e.node(n))}),f(e.edges(),function(n){ie(e.edge(n))})}function ie(e){var n=e.width;e.width=e.height,e.height=n}function In(e){f(e.nodes(),function(n){B(e.node(n))}),f(e.edges(),function(n){var r=e.edge(n);f(r.points,B),Object.prototype.hasOwnProperty.call(r,"y")&&B(r)})}function B(e){e.y=-e.y}function Mn(e){f(e.nodes(),function(n){G(e.node(n))}),f(e.edges(),function(n){var r=e.edge(n);f(r.points,G),Object.prototype.hasOwnProperty.call(r,"x")&&G(r)})}function G(e){var n=e.x;e.x=e.y,e.y=n}function Sn(e){e.graph().dummyChains=[],f(e.edges(),function(n){jn(e,n)})}function jn(e,n){var r=n.v,t=e.node(r).rank,a=n.w,i=e.node(a).rank,o=n.name,u=e.edge(n),d=u.labelRank;if(i!==t+1){e.removeEdge(n);var s=void 0,c,l;for(l=0,++t;t<i;++l,++t)u.points=[],s={width:0,height:0,edgeLabel:u,edgeObj:n,rank:t},c=L(e,"edge",s,"_d"),t===d&&(s.width=u.width,s.height=u.height,s.dummy="edge-label",s.labelpos=u.labelpos),e.setEdge(r,c,{weight:u.weight},o),l===0&&e.graph().dummyChains.push(c),r=c;e.setEdge(r,a,{weight:u.weight},o)}}function Fn(e){f(e.graph().dummyChains,function(n){var r=e.node(n),t=r.edgeLabel,a;for(e.setEdge(r.edgeObj,t);r.dummy;)a=e.successors(n)[0],e.removeNode(n),t.points.push({x:r.x,y:r.y}),r.dummy==="edge-label"&&(t.x=r.x,t.y=r.y,t.width=r.width,t.height=r.height),n=a,r=e.node(n)})}function Z(e){var n={};function r(t){var a=e.node(t);if(Object.prototype.hasOwnProperty.call(n,t))return a.rank;n[t]=!0;var i=P(w(e.outEdges(t),function(o){return r(o.w)-e.edge(o).minlen}));return(i===Number.POSITIVE_INFINITY||i===void 0||i===null)&&(i=0),a.rank=i}f(e.sources(),r)}function C(e,n){return e.node(n.w).rank-e.node(n.v).rank-e.edge(n).minlen}function ye(e){var n=new g({directed:!1}),r=e.nodes()[0],t=e.nodeCount();n.setNode(r,{});for(var a,i;Vn(n,e)<t;)a=An(n,e),i=n.hasNode(a.v)?C(e,a):-C(e,a),Bn(n,e,i);return n}function Vn(e,n){function r(t){f(n.nodeEdges(t),function(a){var i=a.v,o=t===i?a.w:i;!e.hasNode(o)&&!C(n,a)&&(e.setNode(o,{}),e.setEdge(t,o,{}),r(o))})}return f(e.nodes(),r),e.nodeCount()}function An(e,n){return U(n.edges(),function(r){if(e.hasNode(r.v)!==e.hasNode(r.w))return C(n,r)})}function Bn(e,n,r){f(e.nodes(),function(t){n.node(t).rank+=r})}function Gn(){}Gn.prototype=new Error;function ke(e,n,r){we(n)||(n=[n]);var t=(e.isDirected()?e.successors:e.neighbors).bind(e),a=[],i={};return f(n,function(o){if(!e.hasNode(o))throw new Error("Graph does not have node: "+o);xe(e,o,r==="post",i,t,a)}),a}function xe(e,n,r,t,a,i){Object.prototype.hasOwnProperty.call(t,n)||(t[n]=!0,r||i.push(n),f(a(n),function(o){xe(e,o,r,t,a,i)}),r&&i.push(n))}function Yn(e,n){return ke(e,n,"post")}function Dn(e,n){return ke(e,n,"pre")}k.initLowLimValues=K;k.initCutValues=J;k.calcCutValue=Ee;k.leaveEdge=Le;k.enterEdge=Ne;k.exchangeEdges=Pe;function k(e){e=On(e),Z(e);var n=ye(e);K(n),J(n,e);for(var r,t;r=Le(n);)t=Ne(n,e,r),Pe(n,e,r,t)}function J(e,n){var r=Yn(e,e.nodes());r=r.slice(0,r.length-1),f(r,function(t){qn(e,n,t)})}function qn(e,n,r){var t=e.node(r),a=t.parent;e.edge(r,a).cutvalue=Ee(e,n,r)}function Ee(e,n,r){var t=e.node(r),a=t.parent,i=!0,o=n.edge(r,a),u=0;return o||(i=!1,o=n.edge(a,r)),u=o.weight,f(n.nodeEdges(r),function(d){var s=d.v===r,c=s?d.w:d.v;if(c!==a){var l=s===i,h=n.edge(d).weight;if(u+=l?h:-h,$n(e,r,c)){var v=e.edge(r,c).cutvalue;u+=l?-v:v}}}),u}function K(e,n){arguments.length<2&&(n=e.nodes()[0]),Oe(e,{},1,n)}function Oe(e,n,r,t,a){var i=r,o=e.node(t);return n[t]=!0,f(e.neighbors(t),function(u){Object.prototype.hasOwnProperty.call(n,u)||(r=Oe(e,n,r,u,t))}),o.low=i,o.lim=r++,a?o.parent=a:delete o.parent,r}function Le(e){return z(e.edges(),function(n){return e.edge(n).cutvalue<0})}function Ne(e,n,r){var t=r.v,a=r.w;n.hasEdge(t,a)||(t=r.w,a=r.v);var i=e.node(t),o=e.node(a),u=i,d=!1;i.lim>o.lim&&(u=o,d=!0);var s=_(n.edges(),function(c){return d===oe(e,e.node(c.v),u)&&d!==oe(e,e.node(c.w),u)});return U(s,function(c){return C(n,c)})}function Pe(e,n,r,t){var a=r.v,i=r.w;e.removeEdge(a,i),e.setEdge(t.v,t.w,{}),K(e),J(e,n),Wn(e,n)}function Wn(e,n){var r=z(e.nodes(),function(a){return!n.node(a).parent}),t=Dn(e,r);t=t.slice(1),f(t,function(a){var i=e.node(a).parent,o=n.edge(a,i),u=!1;o||(o=n.edge(i,a),u=!0),n.node(a).rank=n.node(i).rank+(u?o.minlen:-o.minlen)})}function $n(e,n,r){return e.hasEdge(n,r)}function oe(e,n,r){return r.low<=n.lim&&n.lim<=r.lim}function Xn(e){switch(e.graph().ranker){case"network-simplex":ue(e);break;case"tight-tree":Un(e);break;case"longest-path":zn(e);break;default:ue(e)}}var zn=Z;function Un(e){Z(e),ye(e)}function ue(e){k(e)}function Hn(e){var n=L(e,"root",{},"_root"),r=Zn(e),t=y(x(r))-1,a=2*t+1;e.graph().nestingRoot=n,f(e.edges(),function(o){e.edge(o).minlen*=a});var i=Jn(e)+1;f(e.children(),function(o){Ce(e,n,a,i,t,r,o)}),e.graph().nodeRankFactor=a}function Ce(e,n,r,t,a,i,o){var u=e.children(o);if(!u.length){o!==n&&e.setEdge(n,o,{weight:0,minlen:r});return}var d=te(e,"_bt"),s=te(e,"_bb"),c=e.node(o);e.setParent(d,o),c.borderTop=d,e.setParent(s,o),c.borderBottom=s,f(u,function(l){Ce(e,n,r,t,a,i,l);var h=e.node(l),v=h.borderTop?h.borderTop:l,p=h.borderBottom?h.borderBottom:l,b=h.borderTop?t:2*t,N=v!==p?1:a-i[o]+1;e.setEdge(d,v,{weight:b,minlen:N,nestingEdge:!0}),e.setEdge(p,s,{weight:b,minlen:N,nestingEdge:!0})}),e.parent(o)||e.setEdge(n,d,{weight:0,minlen:a+i[o]})}function Zn(e){var n={};function r(t,a){var i=e.children(t);i&&i.length&&f(i,function(o){r(o,a+1)}),n[t]=a}return f(e.children(),function(t){r(t,1)}),n}function Jn(e){return M(e.edges(),function(n,r){return n+e.edge(r).weight},0)}function Kn(e){var n=e.graph();e.removeNode(n.nestingRoot),delete n.nestingRoot,f(e.edges(),function(r){var t=e.edge(r);t.nestingEdge&&e.removeEdge(r)})}function Qn(e,n,r){var t={},a;f(r,function(i){for(var o=e.parent(i),u,d;o;){if(u=e.parent(o),u?(d=t[u],t[u]=o):(d=a,a=o),d&&d!==o){n.setEdge(d,o);return}o=u}})}function er(e,n,r){var t=nr(e),a=new g({compound:!0}).setGraph({root:t}).setDefaultNodeLabel(function(i){return e.node(i)});return f(e.nodes(),function(i){var o=e.node(i),u=e.parent(i);(o.rank===n||o.minRank<=n&&n<=o.maxRank)&&(a.setNode(i),a.setParent(i,u||t),f(e[r](i),function(d){var s=d.v===i?d.w:d.v,c=a.edge(s,i),l=m(c)?0:c.weight;a.setEdge(s,i,{weight:e.edge(d).weight+l})}),Object.prototype.hasOwnProperty.call(o,"minRank")&&a.setNode(i,{borderLeft:o.borderLeft[n],borderRight:o.borderRight[n]}))}),a}function nr(e){for(var n;e.hasNode(n=H("_root")););return n}function rr(e,n){for(var r=0,t=1;t<n.length;++t)r+=tr(e,n[t-1],n[t]);return r}function tr(e,n,r){for(var t=vn(r,w(r,function(s,c){return c})),a=O(w(n,function(s){return R(w(e.outEdges(s),function(c){return{pos:t[c.w],weight:e.edge(c).weight}}),"pos")})),i=1;i<r.length;)i<<=1;var o=2*i-1;i-=1;var u=w(new Array(o),function(){return 0}),d=0;return f(a.forEach(function(s){var c=s.pos+i;u[c]+=s.weight;for(var l=0;c>0;)c%2&&(l+=u[c+1]),c=c-1>>1,u[c]+=s.weight;d+=s.weight*l})),d}function ar(e){var n={},r=_(e.nodes(),function(u){return!e.children(u).length}),t=y(w(r,function(u){return e.node(u).rank})),a=w(E(t+1),function(){return[]});function i(u){if(!ve(n,u)){n[u]=!0;var d=e.node(u);a[d.rank].push(u),f(e.successors(u),i)}}var o=R(r,function(u){return e.node(u).rank});return f(o,i),a}function ir(e,n){return w(n,function(r){var t=e.inEdges(r);if(t.length){var a=M(t,function(i,o){var u=e.edge(o),d=e.node(o.v);return{sum:i.sum+u.weight*d.order,weight:i.weight+u.weight}},{sum:0,weight:0});return{v:r,barycenter:a.sum/a.weight,weight:a.weight}}else return{v:r}})}function or(e,n){var r={};f(e,function(a,i){var o=r[a.v]={indegree:0,in:[],out:[],vs:[a.v],i};m(a.barycenter)||(o.barycenter=a.barycenter,o.weight=a.weight)}),f(n.edges(),function(a){var i=r[a.v],o=r[a.w];!m(i)&&!m(o)&&(o.indegree++,i.out.push(r[a.w]))});var t=_(r,function(a){return!a.indegree});return ur(t)}function ur(e){var n=[];function r(i){return function(o){o.merged||(m(o.barycenter)||m(i.barycenter)||o.barycenter>=i.barycenter)&&dr(i,o)}}function t(i){return function(o){o.in.push(i),--o.indegree===0&&e.push(o)}}for(;e.length;){var a=e.pop();n.push(a),f(a.in.reverse(),r(a)),f(a.out,t(a))}return w(_(n,function(i){return!i.merged}),function(i){return I(i,["vs","i","barycenter","weight"])})}function dr(e,n){var r=0,t=0;e.weight&&(r+=e.barycenter*e.weight,t+=e.weight),n.weight&&(r+=n.barycenter*n.weight,t+=n.weight),e.vs=n.vs.concat(e.vs),e.barycenter=r/t,e.weight=t,e.i=Math.min(n.i,e.i),n.merged=!0}function sr(e,n){var r=Pn(e,function(c){return Object.prototype.hasOwnProperty.call(c,"barycenter")}),t=r.lhs,a=R(r.rhs,function(c){return-c.i}),i=[],o=0,u=0,d=0;t.sort(fr(!!n)),d=de(i,a,d),f(t,function(c){d+=c.vs.length,i.push(c.vs),o+=c.barycenter*c.weight,u+=c.weight,d=de(i,a,d)});var s={vs:O(i)};return u&&(s.barycenter=o/u,s.weight=u),s}function de(e,n,r){for(var t;n.length&&(t=T(n)).i<=r;)n.pop(),e.push(t.vs),r++;return r}function fr(e){return function(n,r){return n.barycenter<r.barycenter?-1:n.barycenter>r.barycenter?1:e?r.i-n.i:n.i-r.i}}function _e(e,n,r,t){var a=e.children(n),i=e.node(n),o=i?i.borderLeft:void 0,u=i?i.borderRight:void 0,d={};o&&(a=_(a,function(p){return p!==o&&p!==u}));var s=ir(e,a);f(s,function(p){if(e.children(p.v).length){var b=_e(e,p.v,r,t);d[p.v]=b,Object.prototype.hasOwnProperty.call(b,"barycenter")&&lr(p,b)}});var c=or(s,r);cr(c,d);var l=sr(c,t);if(o&&(l.vs=O([o,l.vs,u]),e.predecessors(o).length)){var h=e.node(e.predecessors(o)[0]),v=e.node(e.predecessors(u)[0]);Object.prototype.hasOwnProperty.call(l,"barycenter")||(l.barycenter=0,l.weight=0),l.barycenter=(l.barycenter*l.weight+h.order+v.order)/(l.weight+2),l.weight+=2}return l}function cr(e,n){f(e,function(r){r.vs=O(r.vs.map(function(t){return n[t]?n[t].vs:t}))})}function lr(e,n){m(e.barycenter)?(e.barycenter=n.barycenter,e.weight=n.weight):(e.barycenter=(e.barycenter*e.weight+n.barycenter*n.weight)/(e.weight+n.weight),e.weight+=n.weight)}function hr(e){var n=me(e),r=se(e,E(1,n+1),"inEdges"),t=se(e,E(n-1,-1,-1),"outEdges"),a=ar(e);fe(e,a);for(var i=Number.POSITIVE_INFINITY,o,u=0,d=0;d<4;++u,++d){vr(u%2?r:t,u%4>=2),a=j(e);var s=rr(e,a);s<i&&(d=0,o=Ke(a),i=s)}fe(e,o)}function se(e,n,r){return w(n,function(t){return er(e,t,r)})}function vr(e,n){var r=new g;f(e,function(t){var a=t.graph().root,i=_e(t,a,r,n);f(i.vs,function(o,u){t.node(o).order=u}),Qn(t,r,i.vs)})}function fe(e,n){f(n,function(r){f(r,function(t,a){e.node(t).order=a})})}function pr(e){var n=br(e);f(e.graph().dummyChains,function(r){for(var t=e.node(r),a=t.edgeObj,i=wr(e,n,a.v,a.w),o=i.path,u=i.lca,d=0,s=o[d],c=!0;r!==a.w;){if(t=e.node(r),c){for(;(s=o[d])!==u&&e.node(s).maxRank<t.rank;)d++;s===u&&(c=!1)}if(!c){for(;d<o.length-1&&e.node(s=o[d+1]).minRank<=t.rank;)d++;s=o[d]}e.setParent(r,s),r=e.successors(r)[0]}})}function wr(e,n,r,t){var a=[],i=[],o=Math.min(n[r].low,n[t].low),u=Math.max(n[r].lim,n[t].lim),d,s;d=r;do d=e.parent(d),a.push(d);while(d&&(n[d].low>o||u>n[d].lim));for(s=d,d=t;(d=e.parent(d))!==s;)i.push(d);return{path:a.concat(i.reverse()),lca:s}}function br(e){var n={},r=0;function t(a){var i=r;f(e.children(a),t),n[a]={low:i,lim:r++}}return f(e.children(),t),n}function mr(e,n){var r={};function t(a,i){var o=0,u=0,d=a.length,s=T(i);return f(i,function(c,l){var h=yr(e,c),v=h?e.node(h).order:d;(h||c===s)&&(f(i.slice(u,l+1),function(p){f(e.predecessors(p),function(b){var N=e.node(b),Q=N.order;(Q<o||v<Q)&&!(N.dummy&&e.node(p).dummy)&&Re(r,b,p)})}),u=l+1,o=v)}),i}return M(n,t),r}function gr(e,n){var r={};function t(i,o,u,d,s){var c;f(E(o,u),function(l){c=i[l],e.node(c).dummy&&f(e.predecessors(c),function(h){var v=e.node(h);v.dummy&&(v.order<d||v.order>s)&&Re(r,h,c)})})}function a(i,o){var u=-1,d,s=0;return f(o,function(c,l){if(e.node(c).dummy==="border"){var h=e.predecessors(c);h.length&&(d=e.node(h[0]).order,t(o,s,l,u,d),s=l,u=d)}t(o,s,o.length,d,i.length)}),o}return M(n,a),r}function yr(e,n){if(e.node(n).dummy)return z(e.predecessors(n),function(r){return e.node(r).dummy})}function Re(e,n,r){if(n>r){var t=n;n=r,r=t}Object.prototype.hasOwnProperty.call(e,n)||Object.defineProperty(e,n,{enumerable:!0,configurable:!0,value:{},writable:!0});var a=e[n];Object.defineProperty(a,r,{enumerable:!0,configurable:!0,value:!0,writable:!0})}function kr(e,n,r){if(n>r){var t=n;n=r,r=t}return!!e[n]&&Object.prototype.hasOwnProperty.call(e[n],r)}function xr(e,n,r,t){var a={},i={},o={};return f(n,function(u){f(u,function(d,s){a[d]=d,i[d]=d,o[d]=s})}),f(n,function(u){var d=-1;f(u,function(s){var c=t(s);if(c.length){c=R(c,function(b){return o[b]});for(var l=(c.length-1)/2,h=Math.floor(l),v=Math.ceil(l);h<=v;++h){var p=c[h];i[s]===s&&d<o[p]&&!kr(r,s,p)&&(i[p]=s,i[s]=a[s]=a[p],d=o[p])}}})}),{root:a,align:i}}function Er(e,n,r,t,a){var i={},o=Or(e,n,r,a),u=a?"borderLeft":"borderRight";function d(l,h){for(var v=o.nodes(),p=v.pop(),b={};p;)b[p]?l(p):(b[p]=!0,v.push(p),v=v.concat(h(p))),p=v.pop()}function s(l){i[l]=o.inEdges(l).reduce(function(h,v){return Math.max(h,i[v.v]+o.edge(v))},0)}function c(l){var h=o.outEdges(l).reduce(function(p,b){return Math.min(p,i[b.w]-o.edge(b))},Number.POSITIVE_INFINITY),v=e.node(l);h!==Number.POSITIVE_INFINITY&&v.borderType!==u&&(i[l]=Math.max(i[l],h))}return d(s,o.predecessors.bind(o)),d(c,o.successors.bind(o)),f(t,function(l){i[l]=i[r[l]]}),i}function Or(e,n,r,t){var a=new g,i=e.graph(),o=_r(i.nodesep,i.edgesep,t);return f(n,function(u){var d;f(u,function(s){var c=r[s];if(a.setNode(c),d){var l=r[d],h=a.edge(l,c);a.setEdge(l,c,Math.max(o(e,s,d),h||0))}d=s})}),a}function Lr(e,n){return U(x(n),function(r){var t=Number.NEGATIVE_INFINITY,a=Number.POSITIVE_INFINITY;return Qe(r,function(i,o){var u=Rr(e,o)/2;t=Math.max(i+u,t),a=Math.min(i-u,a)}),t-a})}function Nr(e,n){var r=x(n),t=P(r),a=y(r);f(["u","d"],function(i){f(["l","r"],function(o){var u=i+o,d=e[u],s;if(d!==n){var c=x(d);s=o==="l"?t-P(c):a-y(c),s&&(e[u]=S(d,function(l){return l+s}))}})})}function Pr(e,n){return S(e.ul,function(r,t){if(n)return e[n.toLowerCase()][t];var a=R(w(e,t));return(a[1]+a[2])/2})}function Cr(e){var n=j(e),r=W(mr(e,n),gr(e,n)),t={},a;f(["u","d"],function(o){a=o==="u"?n:x(n).reverse(),f(["l","r"],function(u){u==="r"&&(a=w(a,function(l){return x(l).reverse()}));var d=(o==="u"?e.predecessors:e.successors).bind(e),s=xr(e,a,r,d),c=Er(e,a,s.root,s.align,u==="r");u==="r"&&(c=S(c,function(l){return-l})),t[o+u]=c})});var i=Lr(e,t);return Nr(t,i),Pr(t,e.graph().align)}function _r(e,n,r){return function(t,a,i){var o=t.node(a),u=t.node(i),d=0,s;if(d+=o.width/2,Object.prototype.hasOwnProperty.call(o,"labelpos"))switch(o.labelpos.toLowerCase()){case"l":s=-o.width/2;break;case"r":s=o.width/2;break}if(s&&(d+=r?s:-s),s=0,d+=(o.dummy?n:e)/2,d+=(u.dummy?n:e)/2,d+=u.width/2,Object.prototype.hasOwnProperty.call(u,"labelpos"))switch(u.labelpos.toLowerCase()){case"l":s=u.width/2;break;case"r":s=-u.width/2;break}return s&&(d+=r?s:-s),s=0,d}}function Rr(e,n){return e.node(n).width}function Tr(e){e=be(e),Ir(e),en(Cr(e),function(n,r){e.node(r).x=n})}function Ir(e){var n=j(e),r=e.graph().ranksep,t=0;f(n,function(a){var i=y(w(a,function(o){return e.node(o).height}));f(a,function(o){e.node(o).y=t+i/2}),t+=i+r})}function ot(e,n){var r=Cn;r("layout",()=>{var t=r("  buildLayoutGraph",()=>qr(e));r("  runLayout",()=>Mr(t,r)),r("  updateInputGraph",()=>Sr(e,t))})}function Mr(e,n){n("    makeSpaceForEdgeLabels",()=>Wr(e)),n("    removeSelfEdges",()=>Qr(e)),n("    acyclic",()=>kn(e)),n("    nestingGraph.run",()=>Hn(e)),n("    rank",()=>Xn(be(e))),n("    injectEdgeLabelProxies",()=>$r(e)),n("    removeEmptyRanks",()=>Nn(e)),n("    nestingGraph.cleanup",()=>Kn(e)),n("    normalizeRanks",()=>Ln(e)),n("    assignRankMinMax",()=>Xr(e)),n("    removeEdgeLabelProxies",()=>zr(e)),n("    normalize.run",()=>Sn(e)),n("    parentDummyChains",()=>pr(e)),n("    addBorderSegments",()=>_n(e)),n("    order",()=>hr(e)),n("    insertSelfEdges",()=>et(e)),n("    adjustCoordinateSystem",()=>Rn(e)),n("    position",()=>Tr(e)),n("    positionSelfEdges",()=>nt(e)),n("    removeBorderNodes",()=>Kr(e)),n("    normalize.undo",()=>Fn(e)),n("    fixupEdgeLabelCoords",()=>Zr(e)),n("    undoCoordinateSystem",()=>Tn(e)),n("    translateGraph",()=>Ur(e)),n("    assignNodeIntersects",()=>Hr(e)),n("    reversePoints",()=>Jr(e)),n("    acyclic.undo",()=>En(e))}function Sr(e,n){f(e.nodes(),function(r){var t=e.node(r),a=n.node(r);t&&(t.x=a.x,t.y=a.y,n.children(r).length&&(t.width=a.width,t.height=a.height))}),f(e.edges(),function(r){var t=e.edge(r),a=n.edge(r);t.points=a.points,Object.prototype.hasOwnProperty.call(a,"x")&&(t.x=a.x,t.y=a.y)}),e.graph().width=n.graph().width,e.graph().height=n.graph().height}var jr=["nodesep","edgesep","ranksep","marginx","marginy"],Fr={ranksep:50,edgesep:20,nodesep:50,rankdir:"tb"},Vr=["acyclicer","ranker","rankdir","align"],Ar=["width","height"],Br={width:0,height:0},Gr=["minlen","weight","width","height","labeloffset"],Yr={minlen:1,weight:1,width:0,height:0,labeloffset:10,labelpos:"r"},Dr=["labelpos"];function qr(e){var n=new g({multigraph:!0,compound:!0}),r=D(e.graph());return n.setGraph(W({},Fr,Y(r,jr),I(r,Vr))),f(e.nodes(),function(t){var a=D(e.node(t));n.setNode(t,Be(Y(a,Ar),Br)),n.setParent(t,e.parent(t))}),f(e.edges(),function(t){var a=D(e.edge(t));n.setEdge(t,W({},Yr,Y(a,Gr),I(a,Dr)))}),n}function Wr(e){var n=e.graph();n.ranksep/=2,f(e.edges(),function(r){var t=e.edge(r);t.minlen*=2,t.labelpos.toLowerCase()!=="c"&&(n.rankdir==="TB"||n.rankdir==="BT"?t.width+=t.labeloffset:t.height+=t.labeloffset)})}function $r(e){f(e.edges(),function(n){var r=e.edge(n);if(r.width&&r.height){var t=e.node(n.v),a=e.node(n.w),i={rank:(a.rank-t.rank)/2+t.rank,e:n};L(e,"edge-proxy",i,"_ep")}})}function Xr(e){var n=0;f(e.nodes(),function(r){var t=e.node(r);t.borderTop&&(t.minRank=e.node(t.borderTop).rank,t.maxRank=e.node(t.borderBottom).rank,n=y(n,t.maxRank))}),e.graph().maxRank=n}function zr(e){f(e.nodes(),function(n){var r=e.node(n);r.dummy==="edge-proxy"&&(e.edge(r.e).labelRank=r.rank,e.removeNode(n))})}function Ur(e){var n=Number.POSITIVE_INFINITY,r=0,t=Number.POSITIVE_INFINITY,a=0,i=e.graph(),o=i.marginx||0,u=i.marginy||0;function d(s){var c=s.x,l=s.y,h=s.width,v=s.height;n=Math.min(n,c-h/2),r=Math.max(r,c+h/2),t=Math.min(t,l-v/2),a=Math.max(a,l+v/2)}f(e.nodes(),function(s){d(e.node(s))}),f(e.edges(),function(s){var c=e.edge(s);Object.prototype.hasOwnProperty.call(c,"x")&&d(c)}),n-=o,t-=u,f(e.nodes(),function(s){var c=e.node(s);c.x-=n,c.y-=t}),f(e.edges(),function(s){var c=e.edge(s);f(c.points,function(l){l.x-=n,l.y-=t}),Object.prototype.hasOwnProperty.call(c,"x")&&(c.x-=n),Object.prototype.hasOwnProperty.call(c,"y")&&(c.y-=t)}),i.width=r-n+o,i.height=a-t+u}function Hr(e){f(e.edges(),function(n){var r=e.edge(n),t=e.node(n.v),a=e.node(n.w),i,o;r.points?(i=r.points[0],o=r.points[r.points.length-1]):(r.points=[],i=a,o=t),r.points.unshift(re(t,i)),r.points.push(re(a,o))})}function Zr(e){f(e.edges(),function(n){var r=e.edge(n);if(Object.prototype.hasOwnProperty.call(r,"x"))switch((r.labelpos==="l"||r.labelpos==="r")&&(r.width-=r.labeloffset),r.labelpos){case"l":r.x-=r.width/2+r.labeloffset;break;case"r":r.x+=r.width/2+r.labeloffset;break}})}function Jr(e){f(e.edges(),function(n){var r=e.edge(n);r.reversed&&r.points.reverse()})}function Kr(e){f(e.nodes(),function(n){if(e.children(n).length){var r=e.node(n),t=e.node(r.borderTop),a=e.node(r.borderBottom),i=e.node(T(r.borderLeft)),o=e.node(T(r.borderRight));r.width=Math.abs(o.x-i.x),r.height=Math.abs(a.y-t.y),r.x=i.x+r.width/2,r.y=t.y+r.height/2}}),f(e.nodes(),function(n){e.node(n).dummy==="border"&&e.removeNode(n)})}function Qr(e){f(e.edges(),function(n){if(n.v===n.w){var r=e.node(n.v);r.selfEdges||(r.selfEdges=[]),r.selfEdges.push({e:n,label:e.edge(n)}),e.removeEdge(n)}})}function et(e){var n=j(e);f(n,function(r){var t=0;f(r,function(a,i){var o=e.node(a);o.order=i+t,f(o.selfEdges,function(u){L(e,"selfedge",{width:u.label.width,height:u.label.height,rank:o.rank,order:i+ ++t,e:u.e,label:u.label},"_se")}),delete o.selfEdges})})}function nt(e){f(e.nodes(),function(n){var r=e.node(n);if(r.dummy==="selfedge"){var t=e.node(r.e.v),a=t.x+t.width/2,i=t.y,o=r.x-a,u=t.height/2;e.setEdge(r.e,r.label),e.removeNode(n),r.label.points=[{x:a+2*o/3,y:i-u},{x:a+5*o/6,y:i-u},{x:a+o,y:i},{x:a+5*o/6,y:i+u},{x:a+2*o/3,y:i+u}],r.label.x=r.x,r.label.y=r.y}})}function Y(e,n){return S(I(e,n),Number)}function D(e){var n={};return f(e,function(r,t){n[t.toLowerCase()]=r}),n}export{ot as l};
diff --git a/docs/dist/assets/linear-hh6lJPrN.js b/docs/dist/assets/linear-hh6lJPrN.js
deleted file mode 100644
index 3614a6b6..00000000
--- a/docs/dist/assets/linear-hh6lJPrN.js
+++ /dev/null
@@ -1 +0,0 @@
-import{aM as j,aN as p,aO as w,aP as q,aQ as k}from"./index-BxX29htg.js";import{i as D}from"./init-Gi6I4Gst.js";import{e as M,f as F,a as P,b as z}from"./defaultLocale-C4B-KCzX.js";function g(n,r){return n==null||r==null?NaN:n<r?-1:n>r?1:n>=r?0:NaN}function B(n,r){return n==null||r==null?NaN:r<n?-1:r>n?1:r>=n?0:NaN}function R(n){let r,t,e;n.length!==2?(r=g,t=(o,c)=>g(n(o),c),e=(o,c)=>n(o)-c):(r=n===g||n===B?n:I,t=n,e=n);function u(o,c,i=0,h=o.length){if(i<h){if(r(c,c)!==0)return h;do{const l=i+h>>>1;t(o[l],c)<0?i=l+1:h=l}while(i<h)}return i}function f(o,c,i=0,h=o.length){if(i<h){if(r(c,c)!==0)return h;do{const l=i+h>>>1;t(o[l],c)<=0?i=l+1:h=l}while(i<h)}return i}function a(o,c,i=0,h=o.length){const l=u(o,c,i,h-1);return l>i&&e(o[l-1],c)>-e(o[l],c)?l-1:l}return{left:u,center:a,right:f}}function I(){return 0}function O(n){return n===null?NaN:+n}const V=R(g),$=V.right;R(O).center;const x=Math.sqrt(50),Q=Math.sqrt(10),T=Math.sqrt(2);function v(n,r,t){const e=(r-n)/Math.max(0,t),u=Math.floor(Math.log10(e)),f=e/Math.pow(10,u),a=f>=x?10:f>=Q?5:f>=T?2:1;let o,c,i;return u<0?(i=Math.pow(10,-u)/a,o=Math.round(n*i),c=Math.round(r*i),o/i<n&&++o,c/i>r&&--c,i=-i):(i=Math.pow(10,u)*a,o=Math.round(n/i),c=Math.round(r/i),o*i<n&&++o,c*i>r&&--c),c<o&&.5<=t&&t<2?v(n,r,t*2):[o,c,i]}function C(n,r,t){if(r=+r,n=+n,t=+t,!(t>0))return[];if(n===r)return[n];const e=r<n,[u,f,a]=e?v(r,n,t):v(n,r,t);if(!(f>=u))return[];const o=f-u+1,c=new Array(o);if(e)if(a<0)for(let i=0;i<o;++i)c[i]=(f-i)/-a;else for(let i=0;i<o;++i)c[i]=(f-i)*a;else if(a<0)for(let i=0;i<o;++i)c[i]=(u+i)/-a;else for(let i=0;i<o;++i)c[i]=(u+i)*a;return c}function y(n,r,t){return r=+r,n=+n,t=+t,v(n,r,t)[2]}function E(n,r,t){r=+r,n=+n,t=+t;const e=r<n,u=e?y(r,n,t):y(n,r,t);return(e?-1:1)*(u<0?1/-u:u)}function G(n,r){r||(r=[]);var t=n?Math.min(r.length,n.length):0,e=r.slice(),u;return function(f){for(u=0;u<t;++u)e[u]=n[u]*(1-f)+r[u]*f;return e}}function H(n){return ArrayBuffer.isView(n)&&!(n instanceof DataView)}function J(n,r){var t=r?r.length:0,e=n?Math.min(t,n.length):0,u=new Array(e),f=new Array(t),a;for(a=0;a<e;++a)u[a]=d(n[a],r[a]);for(;a<t;++a)f[a]=r[a];return function(o){for(a=0;a<e;++a)f[a]=u[a](o);return f}}function K(n,r){var t=new Date;return n=+n,r=+r,function(e){return t.setTime(n*(1-e)+r*e),t}}function L(n,r){var t={},e={},u;(n===null||typeof n!="object")&&(n={}),(r===null||typeof r!="object")&&(r={});for(u in r)u in n?t[u]=d(n[u],r[u]):e[u]=r[u];return function(f){for(u in t)e[u]=t[u](f);return e}}function d(n,r){var t=typeof r,e;return r==null||t==="boolean"?j(r):(t==="number"?p:t==="string"?(e=k(r))?(r=e,w):q:r instanceof k?w:r instanceof Date?K:H(r)?G:Array.isArray(r)?J:typeof r.valueOf!="function"&&typeof r.toString!="function"||isNaN(r)?L:p)(n,r)}function U(n,r){return n=+n,r=+r,function(t){return Math.round(n*(1-t)+r*t)}}function W(n){return Math.max(0,-M(Math.abs(n)))}function X(n,r){return Math.max(0,Math.max(-8,Math.min(8,Math.floor(M(r)/3)))*3-M(Math.abs(n)))}function Y(n,r){return n=Math.abs(n),r=Math.abs(r)-n,Math.max(0,M(r)-M(n))+1}function Z(n){return function(){return n}}function _(n){return+n}var A=[0,1];function m(n){return n}function N(n,r){return(r-=n=+n)?function(t){return(t-n)/r}:Z(isNaN(r)?NaN:.5)}function b(n,r){var t;return n>r&&(t=n,n=r,r=t),function(e){return Math.max(n,Math.min(r,e))}}function nn(n,r,t){var e=n[0],u=n[1],f=r[0],a=r[1];return u<e?(e=N(u,e),f=t(a,f)):(e=N(e,u),f=t(f,a)),function(o){return f(e(o))}}function rn(n,r,t){var e=Math.min(n.length,r.length)-1,u=new Array(e),f=new Array(e),a=-1;for(n[e]<n[0]&&(n=n.slice().reverse(),r=r.slice().reverse());++a<e;)u[a]=N(n[a],n[a+1]),f[a]=t(r[a],r[a+1]);return function(o){var c=$(n,o,1,e)-1;return f[c](u[c](o))}}function en(n,r){return r.domain(n.domain()).range(n.range()).interpolate(n.interpolate()).clamp(n.clamp()).unknown(n.unknown())}function tn(){var n=A,r=A,t=d,e,u,f,a=m,o,c,i;function h(){var s=Math.min(n.length,r.length);return a!==m&&(a=b(n[0],n[s-1])),o=s>2?rn:nn,c=i=null,l}function l(s){return s==null||isNaN(s=+s)?f:(c||(c=o(n.map(e),r,t)))(e(a(s)))}return l.invert=function(s){return a(u((i||(i=o(r,n.map(e),p)))(s)))},l.domain=function(s){return arguments.length?(n=Array.from(s,_),h()):n.slice()},l.range=function(s){return arguments.length?(r=Array.from(s),h()):r.slice()},l.rangeRound=function(s){return r=Array.from(s),t=U,h()},l.clamp=function(s){return arguments.length?(a=s?!0:m,h()):a!==m},l.interpolate=function(s){return arguments.length?(t=s,h()):t},l.unknown=function(s){return arguments.length?(f=s,l):f},function(s,S){return e=s,u=S,h()}}function un(){return tn()(m,m)}function an(n,r,t,e){var u=E(n,r,t),f;switch(e=F(e??",f"),e.type){case"s":{var a=Math.max(Math.abs(n),Math.abs(r));return e.precision==null&&!isNaN(f=X(u,a))&&(e.precision=f),P(e,a)}case"":case"e":case"g":case"p":case"r":{e.precision==null&&!isNaN(f=Y(u,Math.max(Math.abs(n),Math.abs(r))))&&(e.precision=f-(e.type==="e"));break}case"f":case"%":{e.precision==null&&!isNaN(f=W(u))&&(e.precision=f-(e.type==="%")*2);break}}return z(e)}function on(n){var r=n.domain;return n.ticks=function(t){var e=r();return C(e[0],e[e.length-1],t??10)},n.tickFormat=function(t,e){var u=r();return an(u[0],u[u.length-1],t??10,e)},n.nice=function(t){t==null&&(t=10);var e=r(),u=0,f=e.length-1,a=e[u],o=e[f],c,i,h=10;for(o<a&&(i=a,a=o,o=i,i=u,u=f,f=i);h-- >0;){if(i=y(a,o,t),i===c)return e[u]=a,e[f]=o,r(e);if(i>0)a=Math.floor(a/i)*i,o=Math.ceil(o/i)*i;else if(i<0)a=Math.ceil(a*i)/i,o=Math.floor(o*i)/i;else break;c=i}return n},n}function fn(){var n=un();return n.copy=function(){return en(n,fn())},D.apply(n,arguments),on(n)}export{en as a,R as b,un as c,fn as l,E as t};
diff --git a/docs/dist/assets/mindmap-definition-VGOIOE7T-WoULMqac.js b/docs/dist/assets/mindmap-definition-VGOIOE7T-WoULMqac.js
deleted file mode 100644
index a98ddf9d..00000000
--- a/docs/dist/assets/mindmap-definition-VGOIOE7T-WoULMqac.js
+++ /dev/null
@@ -1,68 +0,0 @@
-import{g as le}from"./chunk-55IACEB6-BE1gdz1f.js";import{s as he}from"./chunk-QN33PNHL-1s4FuBGd.js";import{_ as l,l as I,o as de,r as ge,F,c as W,i as V,aH as ue,W as pe,X as fe,Y as ye}from"./index-BxX29htg.js";const E=[];for(let t=0;t<256;++t)E.push((t+256).toString(16).slice(1));function me(t,e=0){return(E[t[e+0]]+E[t[e+1]]+E[t[e+2]]+E[t[e+3]]+"-"+E[t[e+4]]+E[t[e+5]]+"-"+E[t[e+6]]+E[t[e+7]]+"-"+E[t[e+8]]+E[t[e+9]]+"-"+E[t[e+10]]+E[t[e+11]]+E[t[e+12]]+E[t[e+13]]+E[t[e+14]]+E[t[e+15]]).toLowerCase()}let z;const Ee=new Uint8Array(16);function _e(){if(!z){if(typeof crypto>"u"||!crypto.getRandomValues)throw new Error("crypto.getRandomValues() not supported. See https://github.com/uuidjs/uuid#getrandomvalues-not-supported");z=crypto.getRandomValues.bind(crypto)}return z(Ee)}const be=typeof crypto<"u"&&crypto.randomUUID&&crypto.randomUUID.bind(crypto),ne={randomUUID:be};function Se(t,e,n){if(ne.randomUUID&&!t)return ne.randomUUID();t=t||{};const c=t.random??t.rng?.()??_e();if(c.length<16)throw new Error("Random bytes length must be >= 16");return c[6]=c[6]&15|64,c[8]=c[8]&63|128,me(c)}var X=(function(){var t=l(function(x,s,i,o){for(i=i||{},o=x.length;o--;i[x[o]]=s);return i},"o"),e=[1,4],n=[1,13],c=[1,12],f=[1,15],h=[1,16],p=[1,20],m=[1,19],u=[6,7,8],N=[1,26],Y=[1,24],q=[1,25],b=[6,7,11],J=[1,6,13,15,16,19,22],K=[1,33],Q=[1,34],R=[1,6,7,11,13,15,16,19,22],B={trace:l(function(){},"trace"),yy:{},symbols_:{error:2,start:3,mindMap:4,spaceLines:5,SPACELINE:6,NL:7,MINDMAP:8,document:9,stop:10,EOF:11,statement:12,SPACELIST:13,node:14,ICON:15,CLASS:16,nodeWithId:17,nodeWithoutId:18,NODE_DSTART:19,NODE_DESCR:20,NODE_DEND:21,NODE_ID:22,$accept:0,$end:1},terminals_:{2:"error",6:"SPACELINE",7:"NL",8:"MINDMAP",11:"EOF",13:"SPACELIST",15:"ICON",16:"CLASS",19:"NODE_DSTART",20:"NODE_DESCR",21:"NODE_DEND",22:"NODE_ID"},productions_:[0,[3,1],[3,2],[5,1],[5,2],[5,2],[4,2],[4,3],[10,1],[10,1],[10,1],[10,2],[10,2],[9,3],[9,2],[12,2],[12,2],[12,2],[12,1],[12,1],[12,1],[12,1],[12,1],[14,1],[14,1],[18,3],[17,1],[17,4]],performAction:l(function(s,i,o,a,g,r,w){var d=r.length-1;switch(g){case 6:case 7:return a;case 8:a.getLogger().trace("Stop NL ");break;case 9:a.getLogger().trace("Stop EOF ");break;case 11:a.getLogger().trace("Stop NL2 ");break;case 12:a.getLogger().trace("Stop EOF2 ");break;case 15:a.getLogger().info("Node: ",r[d].id),a.addNode(r[d-1].length,r[d].id,r[d].descr,r[d].type);break;case 16:a.getLogger().trace("Icon: ",r[d]),a.decorateNode({icon:r[d]});break;case 17:case 21:a.decorateNode({class:r[d]});break;case 18:a.getLogger().trace("SPACELIST");break;case 19:a.getLogger().trace("Node: ",r[d].id),a.addNode(0,r[d].id,r[d].descr,r[d].type);break;case 20:a.decorateNode({icon:r[d]});break;case 25:a.getLogger().trace("node found ..",r[d-2]),this.$={id:r[d-1],descr:r[d-1],type:a.getType(r[d-2],r[d])};break;case 26:this.$={id:r[d],descr:r[d],type:a.nodeType.DEFAULT};break;case 27:a.getLogger().trace("node found ..",r[d-3]),this.$={id:r[d-3],descr:r[d-1],type:a.getType(r[d-2],r[d])};break}},"anonymous"),table:[{3:1,4:2,5:3,6:[1,5],8:e},{1:[3]},{1:[2,1]},{4:6,6:[1,7],7:[1,8],8:e},{6:n,7:[1,10],9:9,12:11,13:c,14:14,15:f,16:h,17:17,18:18,19:p,22:m},t(u,[2,3]),{1:[2,2]},t(u,[2,4]),t(u,[2,5]),{1:[2,6],6:n,12:21,13:c,14:14,15:f,16:h,17:17,18:18,19:p,22:m},{6:n,9:22,12:11,13:c,14:14,15:f,16:h,17:17,18:18,19:p,22:m},{6:N,7:Y,10:23,11:q},t(b,[2,22],{17:17,18:18,14:27,15:[1,28],16:[1,29],19:p,22:m}),t(b,[2,18]),t(b,[2,19]),t(b,[2,20]),t(b,[2,21]),t(b,[2,23]),t(b,[2,24]),t(b,[2,26],{19:[1,30]}),{20:[1,31]},{6:N,7:Y,10:32,11:q},{1:[2,7],6:n,12:21,13:c,14:14,15:f,16:h,17:17,18:18,19:p,22:m},t(J,[2,14],{7:K,11:Q}),t(R,[2,8]),t(R,[2,9]),t(R,[2,10]),t(b,[2,15]),t(b,[2,16]),t(b,[2,17]),{20:[1,35]},{21:[1,36]},t(J,[2,13],{7:K,11:Q}),t(R,[2,11]),t(R,[2,12]),{21:[1,37]},t(b,[2,25]),t(b,[2,27])],defaultActions:{2:[2,1],6:[2,2]},parseError:l(function(s,i){if(i.recoverable)this.trace(s);else{var o=new Error(s);throw o.hash=i,o}},"parseError"),parse:l(function(s){var i=this,o=[0],a=[],g=[null],r=[],w=this.table,d="",U=0,Z=0,re=2,ee=1,oe=r.slice.call(arguments,1),y=Object.create(this.lexer),v={yy:{}};for(var j in this.yy)Object.prototype.hasOwnProperty.call(this.yy,j)&&(v.yy[j]=this.yy[j]);y.setInput(s,v.yy),v.yy.lexer=y,v.yy.parser=this,typeof y.yylloc>"u"&&(y.yylloc={});var G=y.yylloc;r.push(G);var ae=y.options&&y.options.ranges;typeof v.yy.parseError=="function"?this.parseError=v.yy.parseError:this.parseError=Object.getPrototypeOf(this).parseError;function ce(S){o.length=o.length-2*S,g.length=g.length-S,r.length=r.length-S}l(ce,"popStack");function te(){var S;return S=a.pop()||y.lex()||ee,typeof S!="number"&&(S instanceof Array&&(a=S,S=a.pop()),S=i.symbols_[S]||S),S}l(te,"lex");for(var _,T,D,H,O={},P,k,ie,M;;){if(T=o[o.length-1],this.defaultActions[T]?D=this.defaultActions[T]:((_===null||typeof _>"u")&&(_=te()),D=w[T]&&w[T][_]),typeof D>"u"||!D.length||!D[0]){var $="";M=[];for(P in w[T])this.terminals_[P]&&P>re&&M.push("'"+this.terminals_[P]+"'");y.showPosition?$="Parse error on line "+(U+1)+`:
-`+y.showPosition()+`
-Expecting `+M.join(", ")+", got '"+(this.terminals_[_]||_)+"'":$="Parse error on line "+(U+1)+": Unexpected "+(_==ee?"end of input":"'"+(this.terminals_[_]||_)+"'"),this.parseError($,{text:y.match,token:this.terminals_[_]||_,line:y.yylineno,loc:G,expected:M})}if(D[0]instanceof Array&&D.length>1)throw new Error("Parse Error: multiple actions possible at state: "+T+", token: "+_);switch(D[0]){case 1:o.push(_),g.push(y.yytext),r.push(y.yylloc),o.push(D[1]),_=null,Z=y.yyleng,d=y.yytext,U=y.yylineno,G=y.yylloc;break;case 2:if(k=this.productions_[D[1]][1],O.$=g[g.length-k],O._$={first_line:r[r.length-(k||1)].first_line,last_line:r[r.length-1].last_line,first_column:r[r.length-(k||1)].first_column,last_column:r[r.length-1].last_column},ae&&(O._$.range=[r[r.length-(k||1)].range[0],r[r.length-1].range[1]]),H=this.performAction.apply(O,[d,Z,U,v.yy,D[1],g,r].concat(oe)),typeof H<"u")return H;k&&(o=o.slice(0,-1*k*2),g=g.slice(0,-1*k),r=r.slice(0,-1*k)),o.push(this.productions_[D[1]][0]),g.push(O.$),r.push(O._$),ie=w[o[o.length-2]][o[o.length-1]],o.push(ie);break;case 3:return!0}}return!0},"parse")},se=(function(){var x={EOF:1,parseError:l(function(i,o){if(this.yy.parser)this.yy.parser.parseError(i,o);else throw new Error(i)},"parseError"),setInput:l(function(s,i){return this.yy=i||this.yy||{},this._input=s,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},"setInput"),input:l(function(){var s=this._input[0];this.yytext+=s,this.yyleng++,this.offset++,this.match+=s,this.matched+=s;var i=s.match(/(?:\r\n?|\n).*/g);return i?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),s},"input"),unput:l(function(s){var i=s.length,o=s.split(/(?:\r\n?|\n)/g);this._input=s+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-i),this.offset-=i;var a=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),o.length-1&&(this.yylineno-=o.length-1);var g=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:o?(o.length===a.length?this.yylloc.first_column:0)+a[a.length-o.length].length-o[0].length:this.yylloc.first_column-i},this.options.ranges&&(this.yylloc.range=[g[0],g[0]+this.yyleng-i]),this.yyleng=this.yytext.length,this},"unput"),more:l(function(){return this._more=!0,this},"more"),reject:l(function(){if(this.options.backtrack_lexer)this._backtrack=!0;else return this.parseError("Lexical error on line "+(this.yylineno+1)+`. You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).
-`+this.showPosition(),{text:"",token:null,line:this.yylineno});return this},"reject"),less:l(function(s){this.unput(this.match.slice(s))},"less"),pastInput:l(function(){var s=this.matched.substr(0,this.matched.length-this.match.length);return(s.length>20?"...":"")+s.substr(-20).replace(/\n/g,"")},"pastInput"),upcomingInput:l(function(){var s=this.match;return s.length<20&&(s+=this._input.substr(0,20-s.length)),(s.substr(0,20)+(s.length>20?"...":"")).replace(/\n/g,"")},"upcomingInput"),showPosition:l(function(){var s=this.pastInput(),i=new Array(s.length+1).join("-");return s+this.upcomingInput()+`
-`+i+"^"},"showPosition"),test_match:l(function(s,i){var o,a,g;if(this.options.backtrack_lexer&&(g={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(g.yylloc.range=this.yylloc.range.slice(0))),a=s[0].match(/(?:\r\n?|\n).*/g),a&&(this.yylineno+=a.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:a?a[a.length-1].length-a[a.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+s[0].length},this.yytext+=s[0],this.match+=s[0],this.matches=s,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(s[0].length),this.matched+=s[0],o=this.performAction.call(this,this.yy,this,i,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),o)return o;if(this._backtrack){for(var r in g)this[r]=g[r];return!1}return!1},"test_match"),next:l(function(){if(this.done)return this.EOF;this._input||(this.done=!0);var s,i,o,a;this._more||(this.yytext="",this.match="");for(var g=this._currentRules(),r=0;r<g.length;r++)if(o=this._input.match(this.rules[g[r]]),o&&(!i||o[0].length>i[0].length)){if(i=o,a=r,this.options.backtrack_lexer){if(s=this.test_match(o,g[r]),s!==!1)return s;if(this._backtrack){i=!1;continue}else return!1}else if(!this.options.flex)break}return i?(s=this.test_match(i,g[a]),s!==!1?s:!1):this._input===""?this.EOF:this.parseError("Lexical error on line "+(this.yylineno+1)+`. Unrecognized text.
-`+this.showPosition(),{text:"",token:null,line:this.yylineno})},"next"),lex:l(function(){var i=this.next();return i||this.lex()},"lex"),begin:l(function(i){this.conditionStack.push(i)},"begin"),popState:l(function(){var i=this.conditionStack.length-1;return i>0?this.conditionStack.pop():this.conditionStack[0]},"popState"),_currentRules:l(function(){return this.conditionStack.length&&this.conditionStack[this.conditionStack.length-1]?this.conditions[this.conditionStack[this.conditionStack.length-1]].rules:this.conditions.INITIAL.rules},"_currentRules"),topState:l(function(i){return i=this.conditionStack.length-1-Math.abs(i||0),i>=0?this.conditionStack[i]:"INITIAL"},"topState"),pushState:l(function(i){this.begin(i)},"pushState"),stateStackSize:l(function(){return this.conditionStack.length},"stateStackSize"),options:{"case-insensitive":!0},performAction:l(function(i,o,a,g){switch(a){case 0:return i.getLogger().trace("Found comment",o.yytext),6;case 1:return 8;case 2:this.begin("CLASS");break;case 3:return this.popState(),16;case 4:this.popState();break;case 5:i.getLogger().trace("Begin icon"),this.begin("ICON");break;case 6:return i.getLogger().trace("SPACELINE"),6;case 7:return 7;case 8:return 15;case 9:i.getLogger().trace("end icon"),this.popState();break;case 10:return i.getLogger().trace("Exploding node"),this.begin("NODE"),19;case 11:return i.getLogger().trace("Cloud"),this.begin("NODE"),19;case 12:return i.getLogger().trace("Explosion Bang"),this.begin("NODE"),19;case 13:return i.getLogger().trace("Cloud Bang"),this.begin("NODE"),19;case 14:return this.begin("NODE"),19;case 15:return this.begin("NODE"),19;case 16:return this.begin("NODE"),19;case 17:return this.begin("NODE"),19;case 18:return 13;case 19:return 22;case 20:return 11;case 21:this.begin("NSTR2");break;case 22:return"NODE_DESCR";case 23:this.popState();break;case 24:i.getLogger().trace("Starting NSTR"),this.begin("NSTR");break;case 25:return i.getLogger().trace("description:",o.yytext),"NODE_DESCR";case 26:this.popState();break;case 27:return this.popState(),i.getLogger().trace("node end ))"),"NODE_DEND";case 28:return this.popState(),i.getLogger().trace("node end )"),"NODE_DEND";case 29:return this.popState(),i.getLogger().trace("node end ...",o.yytext),"NODE_DEND";case 30:return this.popState(),i.getLogger().trace("node end (("),"NODE_DEND";case 31:return this.popState(),i.getLogger().trace("node end (-"),"NODE_DEND";case 32:return this.popState(),i.getLogger().trace("node end (-"),"NODE_DEND";case 33:return this.popState(),i.getLogger().trace("node end (("),"NODE_DEND";case 34:return this.popState(),i.getLogger().trace("node end (("),"NODE_DEND";case 35:return i.getLogger().trace("Long description:",o.yytext),20;case 36:return i.getLogger().trace("Long description:",o.yytext),20}},"anonymous"),rules:[/^(?:\s*%%.*)/i,/^(?:mindmap\b)/i,/^(?::::)/i,/^(?:.+)/i,/^(?:\n)/i,/^(?:::icon\()/i,/^(?:[\s]+[\n])/i,/^(?:[\n]+)/i,/^(?:[^\)]+)/i,/^(?:\))/i,/^(?:-\))/i,/^(?:\(-)/i,/^(?:\)\))/i,/^(?:\))/i,/^(?:\(\()/i,/^(?:\{\{)/i,/^(?:\()/i,/^(?:\[)/i,/^(?:[\s]+)/i,/^(?:[^\(\[\n\)\{\}]+)/i,/^(?:$)/i,/^(?:["][`])/i,/^(?:[^`"]+)/i,/^(?:[`]["])/i,/^(?:["])/i,/^(?:[^"]+)/i,/^(?:["])/i,/^(?:[\)]\))/i,/^(?:[\)])/i,/^(?:[\]])/i,/^(?:\}\})/i,/^(?:\(-)/i,/^(?:-\))/i,/^(?:\(\()/i,/^(?:\()/i,/^(?:[^\)\]\(\}]+)/i,/^(?:.+(?!\(\())/i],conditions:{CLASS:{rules:[3,4],inclusive:!1},ICON:{rules:[8,9],inclusive:!1},NSTR2:{rules:[22,23],inclusive:!1},NSTR:{rules:[25,26],inclusive:!1},NODE:{rules:[21,24,27,28,29,30,31,32,33,34,35,36],inclusive:!1},INITIAL:{rules:[0,1,2,5,6,7,10,11,12,13,14,15,16,17,18,19,20],inclusive:!0}}};return x})();B.lexer=se;function A(){this.yy={}}return l(A,"Parser"),A.prototype=B,B.Parser=A,new A})();X.parser=X;var De=X,L={DEFAULT:0,NO_BORDER:0,ROUNDED_RECT:1,RECT:2,CIRCLE:3,CLOUD:4,BANG:5,HEXAGON:6},C,Ne=(C=class{constructor(){this.nodes=[],this.count=0,this.elements={},this.getLogger=this.getLogger.bind(this),this.nodeType=L,this.clear(),this.getType=this.getType.bind(this),this.getElementById=this.getElementById.bind(this),this.getParent=this.getParent.bind(this),this.getMindmap=this.getMindmap.bind(this),this.addNode=this.addNode.bind(this),this.decorateNode=this.decorateNode.bind(this)}clear(){this.nodes=[],this.count=0,this.elements={},this.baseLevel=void 0}getParent(e){for(let n=this.nodes.length-1;n>=0;n--)if(this.nodes[n].level<e)return this.nodes[n];return null}getMindmap(){return this.nodes.length>0?this.nodes[0]:null}addNode(e,n,c,f){I.info("addNode",e,n,c,f);let h=!1;this.nodes.length===0?(this.baseLevel=e,e=0,h=!0):this.baseLevel!==void 0&&(e=e-this.baseLevel,h=!1);const p=W();let m=p.mindmap?.padding??F.mindmap.padding;switch(f){case this.nodeType.ROUNDED_RECT:case this.nodeType.RECT:case this.nodeType.HEXAGON:m*=2;break}const u={id:this.count++,nodeId:V(n,p),level:e,descr:V(c,p),type:f,children:[],width:p.mindmap?.maxNodeWidth??F.mindmap.maxNodeWidth,padding:m,isRoot:h},N=this.getParent(e);if(N)N.children.push(u),this.nodes.push(u);else if(h)this.nodes.push(u);else throw new Error(`There can be only one root. No parent could be found for ("${u.descr}")`)}getType(e,n){switch(I.debug("In get type",e,n),e){case"[":return this.nodeType.RECT;case"(":return n===")"?this.nodeType.ROUNDED_RECT:this.nodeType.CLOUD;case"((":return this.nodeType.CIRCLE;case")":return this.nodeType.CLOUD;case"))":return this.nodeType.BANG;case"{{":return this.nodeType.HEXAGON;default:return this.nodeType.DEFAULT}}setElementForId(e,n){this.elements[e]=n}getElementById(e){return this.elements[e]}decorateNode(e){if(!e)return;const n=W(),c=this.nodes[this.nodes.length-1];e.icon&&(c.icon=V(e.icon,n)),e.class&&(c.class=V(e.class,n))}type2Str(e){switch(e){case this.nodeType.DEFAULT:return"no-border";case this.nodeType.RECT:return"rect";case this.nodeType.ROUNDED_RECT:return"rounded-rect";case this.nodeType.CIRCLE:return"circle";case this.nodeType.CLOUD:return"cloud";case this.nodeType.BANG:return"bang";case this.nodeType.HEXAGON:return"hexgon";default:return"no-border"}}assignSections(e,n){if(e.level===0?e.section=void 0:e.section=n,e.children)for(const[c,f]of e.children.entries()){const h=e.level===0?c:n;this.assignSections(f,h)}}flattenNodes(e,n){const c=["mindmap-node"];e.isRoot===!0?c.push("section-root","section--1"):e.section!==void 0&&c.push(`section-${e.section}`),e.class&&c.push(e.class);const f=c.join(" "),h=l(m=>{switch(m){case L.CIRCLE:return"mindmapCircle";case L.RECT:return"rect";case L.ROUNDED_RECT:return"rounded";case L.CLOUD:return"cloud";case L.BANG:return"bang";case L.HEXAGON:return"hexagon";case L.DEFAULT:return"defaultMindmapNode";case L.NO_BORDER:default:return"rect"}},"getShapeFromType"),p={id:e.id.toString(),domId:"node_"+e.id.toString(),label:e.descr,isGroup:!1,shape:h(e.type),width:e.width,height:e.height??0,padding:e.padding,cssClasses:f,cssStyles:[],look:"default",icon:e.icon,x:e.x,y:e.y,level:e.level,nodeId:e.nodeId,type:e.type,section:e.section};if(n.push(p),e.children)for(const m of e.children)this.flattenNodes(m,n)}generateEdges(e,n){if(e.children)for(const c of e.children){let f="edge";c.section!==void 0&&(f+=` section-edge-${c.section}`);const h=e.level+1;f+=` edge-depth-${h}`;const p={id:`edge_${e.id}_${c.id}`,start:e.id.toString(),end:c.id.toString(),type:"normal",curve:"basis",thickness:"normal",look:"default",classes:f,depth:e.level,section:c.section};n.push(p),this.generateEdges(c,n)}}getData(){const e=this.getMindmap(),n=W(),f=ue().layout!==void 0,h=n;if(f||(h.layout="cose-bilkent"),!e)return{nodes:[],edges:[],config:h};I.debug("getData: mindmapRoot",e,n),this.assignSections(e);const p=[],m=[];this.flattenNodes(e,p),this.generateEdges(e,m),I.debug(`getData: processed ${p.length} nodes and ${m.length} edges`);const u=new Map;for(const N of p)u.set(N.id,{shape:N.shape,width:N.width,height:N.height,padding:N.padding});return{nodes:p,edges:m,config:h,rootNode:e,markers:["point"],direction:"TB",nodeSpacing:50,rankSpacing:50,shapes:Object.fromEntries(u),type:"mindmap",diagramId:"mindmap-"+Se()}}getLogger(){return I}},l(C,"MindmapDB"),C),ke=l(async(t,e,n,c)=>{I.debug(`Rendering mindmap diagram
-`+t);const f=c.db,h=f.getData(),p=le(e,h.config.securityLevel);h.type=c.type,h.layoutAlgorithm=de(h.config.layout,{fallback:"cose-bilkent"}),h.diagramId=e,f.getMindmap()&&(h.nodes.forEach(u=>{u.shape==="rounded"?(u.radius=15,u.taper=15,u.stroke="none",u.width=0,u.padding=15):u.shape==="circle"?u.padding=10:u.shape==="rect"&&(u.width=0,u.padding=10)}),await ge(h,p),he(p,h.config.mindmap?.padding??F.mindmap.padding,"mindmapDiagram",h.config.mindmap?.useMaxWidth??F.mindmap.useMaxWidth))},"draw"),Le={draw:ke},xe=l(t=>{let e="";for(let n=0;n<t.THEME_COLOR_LIMIT;n++)t["lineColor"+n]=t["lineColor"+n]||t["cScaleInv"+n],pe(t["lineColor"+n])?t["lineColor"+n]=fe(t["lineColor"+n],20):t["lineColor"+n]=ye(t["lineColor"+n],20);for(let n=0;n<t.THEME_COLOR_LIMIT;n++){const c=""+(17-3*n);e+=`
-    .section-${n-1} rect, .section-${n-1} path, .section-${n-1} circle, .section-${n-1} polygon, .section-${n-1} path  {
-      fill: ${t["cScale"+n]};
-    }
-    .section-${n-1} text {
-     fill: ${t["cScaleLabel"+n]};
-    }
-    .node-icon-${n-1} {
-      font-size: 40px;
-      color: ${t["cScaleLabel"+n]};
-    }
-    .section-edge-${n-1}{
-      stroke: ${t["cScale"+n]};
-    }
-    .edge-depth-${n-1}{
-      stroke-width: ${c};
-    }
-    .section-${n-1} line {
-      stroke: ${t["cScaleInv"+n]} ;
-      stroke-width: 3;
-    }
-
-    .disabled, .disabled circle, .disabled text {
-      fill: lightgray;
-    }
-    .disabled text {
-      fill: #efefef;
-    }
-    `}return e},"genSections"),ve=l(t=>`
-  .edge {
-    stroke-width: 3;
-  }
-  ${xe(t)}
-  .section-root rect, .section-root path, .section-root circle, .section-root polygon  {
-    fill: ${t.git0};
-  }
-  .section-root text {
-    fill: ${t.gitBranchLabel0};
-  }
-  .section-root span {
-    color: ${t.gitBranchLabel0};
-  }
-  .section-2 span {
-    color: ${t.gitBranchLabel0};
-  }
-  .icon-container {
-    height:100%;
-    display: flex;
-    justify-content: center;
-    align-items: center;
-  }
-  .edge {
-    fill: none;
-  }
-  .mindmap-node-label {
-    dy: 1em;
-    alignment-baseline: middle;
-    text-anchor: middle;
-    dominant-baseline: middle;
-    text-align: center;
-  }
-`,"getStyles"),Te=ve,Re={get db(){return new Ne},renderer:Le,parser:De,styles:Te};export{Re as diagram};
diff --git a/docs/dist/assets/ordinal-Cboi1Yqb.js b/docs/dist/assets/ordinal-Cboi1Yqb.js
deleted file mode 100644
index de7dd9ea..00000000
--- a/docs/dist/assets/ordinal-Cboi1Yqb.js
+++ /dev/null
@@ -1 +0,0 @@
-import{i as a}from"./init-Gi6I4Gst.js";class o extends Map{constructor(n,t=g){if(super(),Object.defineProperties(this,{_intern:{value:new Map},_key:{value:t}}),n!=null)for(const[r,s]of n)this.set(r,s)}get(n){return super.get(c(this,n))}has(n){return super.has(c(this,n))}set(n,t){return super.set(l(this,n),t)}delete(n){return super.delete(p(this,n))}}function c({_intern:e,_key:n},t){const r=n(t);return e.has(r)?e.get(r):t}function l({_intern:e,_key:n},t){const r=n(t);return e.has(r)?e.get(r):(e.set(r,t),t)}function p({_intern:e,_key:n},t){const r=n(t);return e.has(r)&&(t=e.get(r),e.delete(r)),t}function g(e){return e!==null&&typeof e=="object"?e.valueOf():e}const f=Symbol("implicit");function h(){var e=new o,n=[],t=[],r=f;function s(u){let i=e.get(u);if(i===void 0){if(r!==f)return r;e.set(u,i=n.push(u)-1)}return t[i%t.length]}return s.domain=function(u){if(!arguments.length)return n.slice();n=[],e=new o;for(const i of u)e.has(i)||e.set(i,n.push(i)-1);return s},s.range=function(u){return arguments.length?(t=Array.from(u),s):t.slice()},s.unknown=function(u){return arguments.length?(r=u,s):r},s.copy=function(){return h(n,t).unknown(r)},a.apply(s,arguments),s}export{h as o};
diff --git a/docs/dist/assets/partners/comazo.svg b/docs/dist/assets/partners/comazo.svg
deleted file mode 100644
index a0ff51bd..00000000
--- a/docs/dist/assets/partners/comazo.svg
+++ /dev/null
@@ -1,52 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<!-- Creator: CorelDRAW 2017 -->
-<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" width="145mm" height="71mm" version="1.1" style="shape-rendering:geometricPrecision; text-rendering:geometricPrecision; image-rendering:optimizeQuality; fill-rule:evenodd; clip-rule:evenodd"
-viewBox="0 0 14500 7100"
- xmlns:xlink="http://www.w3.org/1999/xlink">
- <defs>
-  <font id="FontID0" horiz-adv-x="600" font-variant="normal" style="fill-rule:nonzero" font-weight="400">
-	<font-face 
-		font-family="CourierPS">
-		<font-face-src>
-			<font-face-name name="CourierPS"/>
-		</font-face-src>
-	</font-face>
-   <missing-glyph><path d="M0 0z"/></missing-glyph>
-   <glyph unicode="8" horiz-adv-x="600" d="M378.999 308.669l0 0c23.1717,-7.83943 44.1705,-19.6688 62.9964,-35.6661 37.3333,-31.8354 55.9999,-72.1658 55.9999,-120.504 0,-48.1699 -18.8259,-88.1631 -56.3277,-119.83 -37.6705,-31.8354 -84.9974,-47.6735 -141.831,-47.6735 -57.0021,0 -104.17,15.8381 -141.672,47.6735 -37.5019,31.6668 -56.1685,71.66 -56.1685,119.83 0,48.3385 18.8352,88.6689 56.5057,120.504 18.4981,15.6601 39.1597,27.4989 61.9942,35.6661l0 0c-19.828,7.83006 -37.8297,18.6666 -53.827,32.6596 -35.1697,30.8332 -52.6656,69.8337 -52.6656,116.674 0,47.1677 17.4959,86.3274 52.6656,117.329 35.1603,31.1704 79.6681,46.6713 133.326,46.6713 53.6678,0 98.1661,-15.5009 133.336,-46.6713 35.1697,-31.0018 52.6656,-70.1615 52.6656,-117.329 0,-46.8399 -17.4959,-85.8403 -52.6656,-116.674 -16.3345,-13.993 -34.3361,-24.8295 -54.3328,-32.6596zm-79.0031 21.3266c35.8347,0 66.8365,12.0073 92.8368,36.0033 26.1689,24.0053 39.169,52.497 39.169,85.5031 0,35.6661 -12.3352,65.0007 -37.1647,87.9945 -24.8389,23.0031 -56.3371,34.5047 -94.8412,34.5047 -38.4947,0 -69.9929,-11.5016 -94.8318,-34.5047 -24.8295,-22.9938 -37.1647,-52.3284 -37.1647,-87.9945 0,-33.0061 13.0001,-61.4978 39.169,-85.5031 26.0003,-23.996 57.0021,-36.0033 92.8274,-36.0033zm-0.159224 -47.9919c-42.1662,0 -76.6709,-12.0073 -103.505,-35.8347 -26.8339,-23.8367 -40.3304,-54.5013 -40.3304,-91.8346 0,-37.1647 13.4966,-67.6701 40.3304,-91.4975 26.8339,-23.8367 61.3386,-35.8347 103.505,-35.8347 41.9976,0 76.493,11.998 103.495,35.8347 27.1711,23.8274 40.6676,54.3328 40.6676,91.4975 0,37.3333 -13.4966,67.9979 -40.499,92.0032 -27.1711,23.8274 -61.6664,35.6661 -103.664,35.6661z"/>
-   <glyph unicode="I" horiz-adv-x="600" d="M276 48.0013l0 466.001 -179.998 0 0 48.0013 205.502 0 205.492 0 0 -48.0013 -179.998 0 0 -466.001 179.998 0 0 -48.0013 -205.492 0 -205.502 0 0 48.0013 179.998 0z"/>
-   <glyph unicode="C" horiz-adv-x="600" d="M535.001 62.0036c-35.1697,-29.0068 -69.6651,-49.4999 -103.505,-61.6664 -33.8304,-12.1666 -73.4958,-18.3388 -119.165,-18.3388 -78.0009,0 -142.833,28.3325 -194.169,84.9974 -51.4948,56.5057 -77.1673,127.838 -77.1673,213.837 0,89.9989 24.8389,162.502 74.5073,217.162 49.6684,54.6699 115.334,82.0002 197.166,82.0002 51.4948,0.33718 96.9954,-14.3301 136.829,-43.8334 13.3373,-9.99363 23.6681,-13.4966 30.8332,-10.1622 7.16507,3.16574 10.668,12.663 10.668,28.3325l0 10.668 45.9969 -7.33366c-5.4979,-31.8354 -8.16724,-61.835 -7.83006,-89.9989 0.33718,-28.3325 3.99933,-58.5007 10.8366,-90.6639l-46.9991 -6.34085c-2.33216,50.3334 -19.341,89.8397 -51.167,118.5 -31.8354,28.501 -74.8352,42.8406 -128.84,42.8406 -65.6657,0 -117.826,-22.666 -156.667,-68.0073 -38.8319,-45.1633 -58.3321,-105.996 -58.3321,-182.161 0,-72.9994 20.1652,-132.999 60.505,-179.67 40.1618,-46.8305 91.666,-70.1615 154.494,-70.1615 38.6726,0 72.503,5.16072 101.838,15.4915 29.166,10.3402 59.9993,28.1732 92.1624,53.5085l28.0046 -39.0004z"/>
-   <glyph unicode="N" horiz-adv-x="600" d="M143.002 48.0013l106.998 0 0 -48.0013 -121.169 0 -121.834 0 0 48.0013 85.0067 0 0 466.001 -85.0067 0 0 48.0013 84.3324 0 84.8382 0 0 0 291.829 -521.008 0 0 0 0 0 473.007 -109.996 0 0 48.0013 117.498 0 117.498 0 0 -48.0013 -73.9922 0 0 -527.002 -39.169 0 -39.169 0 -297.664 530.337 0 0 0 0 0 -469.335z"/>
-   <glyph unicode="4" horiz-adv-x="600" d="M355.996 141.999l-277.995 0 0 27.8361 0 27.8267 251.995 424.341 38.504 0 38.504 0 0 -432.002 0 0 92.996 0 0 -48.0013 -92.996 0 0 0 0 -93.9982 92.996 0 0 -48.0013 -140.501 0 -140.501 0 0 48.0013 136.998 0 0 93.9982zm0 48.0013l0 0 0 380.17 0 0 0 0 -220.993 -371.834 -4.83291 -8.33583 0 0 225.826 0z"/>
-   <glyph unicode="E" horiz-adv-x="600" d="M53.9956 0l0 48.0013 88.0039 0 0 466.001 -88.0039 0 0 48.0013 139.171 0 0 0 349.833 0 0 0 2.50075 -90.0082 2.50075 -89.9989 -46.9991 0 -9.83441 132.006 -298.17 0 0 0 0 -197.999 0 0 166.998 0 0 74.0016 48.0013 0 0 -97.6697 0 -98.3347 -48.0013 0 0 74.0016 -166.998 0 0 0 0 -220 0 0 304.164 0 6.83725 134.001 46.9991 0 0 -90.6732 0 -91.3289 0 0 -357.832 0 0 0 -139.171 0z"/>
-   <glyph unicode="1" horiz-adv-x="600" d="M276 48.0013l0 518.161 0 0 -161.996 -77.1579 -18.0016 39.9933 195.826 93.0054 35.1697 0 0 0 0 -574.002 178.003 0 0 -48.0013 -203.497 0 -203.507 0 0 48.0013 178.003 0z"/>
-   <glyph unicode=" " horiz-adv-x="600" d=""/>
-   <glyph unicode="S" horiz-adv-x="600" d="M468.998 394.004c-3.33433,52.0006 -15.6695,87.4981 -36.9961,106.493 -21.336,19.0038 -59.6714,28.501 -114.838,28.501 -45.9969,0 -84.1638,-11.5016 -114.66,-34.3268 -30.3368,-23.0031 -45.5005,-51.6728 -45.5005,-86.1681 0,-33.1654 13.1594,-58.5007 39.4969,-76.0059 26.4967,-17.3273 70.0022,-29.166 130.666,-35.6661 76.3337,-8.16724 129.337,-22.9938 158.999,-44.8262 29.166,-21.5046 43.8334,-56.1685 43.8334,-104.001 0,-47.8327 -19.8374,-87.5075 -59.6621,-118.837 -39.834,-31.4982 -90.0082,-47.1677 -150.504,-47.1677 -58.8379,0 -109.331,13.0001 -151.169,39.0004 -9.16941,5.83508 -16.8309,7.33366 -22.9938,4.66432 -6.17226,-2.82856 -10.3402,-9.66582 -12.6723,-20.8302l-4.83291 -24.8295 -47.1677 4.83291c5.4979,33.4932 7.83943,62.3314 6.83725,86.3274 -1.33935,24.0053 -6.17226,52.6656 -14.8359,85.8403l46.9991 6.33149c6.17226,-43.337 24.6703,-76.0059 55.3349,-98.1661 30.6646,-22.1696 72.9994,-33.1654 126.499,-33.1654 53.6678,0 96.3304,10.3308 127.838,30.9924 31.4982,20.671 47.3269,48.6663 47.3269,83.836 0,33.6711 -10.4994,56.8335 -31.4982,70.0022 -21.1674,12.663 -65.8343,22.666 -133.664,30.1682 -71.173,7.83006 -123.67,24.8295 -157.5,50.8298 -33.5025,26.0003 -50.3334,62.8372 -50.3334,110.333 0,49.4999 20.1652,90.5046 60.4957,123.005 40.3398,32.5004 91.1696,48.8255 152.34,48.8255 52.497,0 97.1639,-11.998 134.329,-36.1625 9.16941,-6.1629 16.8309,-7.99865 23.0031,-5.32931 6.1629,2.49138 10.1622,9.16005 12.1666,19.9966l3.50292 18.4981 40.499 -6.33149c-10.1716,-30.3368 -16.0067,-59.1657 -17.6738,-86.6645 -1.66717,-27.3397 0.833583,-56.6649 7.33366,-88.0039l-50.9984 -1.99498z"/>
-  </font>
-  <style type="text/css">
-   <![CDATA[
-    @font-face { font-family:"CourierPS";font-variant:normal;font-weight:normal;src:url("#FontID0") format(svg)}
-    .fil1 {fill:#2F435F}
-    .fil0 {fill:#2F435F;fill-rule:nonzero}
-    .fnt0 {font-weight:normal;font-size:1067.68px;font-family:'CourierPS'}
-   ]]>
-  </style>
- </defs>
- <g id="Слой_x0020_1">
-  <metadata id="CorelCorpID_0Corel-Layer"/>
-  <g id="_2473141620144">
-   <g id="Comazo_x0020_логотип.eps">
-    <path class="fil0" d="M1104.42 4031.09c-156.47,0 -285.52,-44.21 -386.71,-132.86 -101.35,-88.67 -152.13,-202.58 -152.13,-341.73 0,-118.24 34.46,-213.7 103.96,-286.24 69.22,-72.56 155.44,-108.51 258.82,-108.51 78.48,0 164.6,31.35 259.01,94.24 94.49,62.99 165.72,100.72 213.9,113.12 48.16,12.5 96.35,18.57 144.61,18.57 17.08,0 32.54,-0.73 47.11,-2.49 14.56,-1.64 28.95,-3.77 42.95,-6.16 28.29,-7.73 51.16,-16.64 69.41,-26.65 41.22,-24.29 61.69,-55.27 61.69,-93.24 0,-62.17 -61.69,-114.22 -184.86,-156.24 -62.09,-21.89 -131.49,-37.79 -208.04,-47.91 -76.73,-10.03 -162.65,-15.07 -257.73,-15.07 -313.25,0 -577.84,59.02 -793.32,177.64 -215.35,118.55 -323.09,262.45 -323.09,431.82 0,152.27 85.53,277.04 256.19,374.62 170.69,97.39 386.81,146.02 648.42,146.02 383.43,0 676.6,-94.33 878.83,-283.39l-123.46 -41.02c-176.76,123.69 -361.8,185.48 -555.56,185.48l0 0z"/>
-    <path class="fil0" d="M3335.71 3970.02c-71.36,56.03 -166.05,84.21 -284.32,84.21 -176.77,0 -316.06,-60.92 -418.26,-183.23 -102.43,-121.92 -153.39,-256.56 -153.39,-403.87 0,-98.57 35.23,-175.17 105.98,-229.52 70.85,-54.52 169.62,-81.83 296.95,-81.83 161.58,0 295.3,53.9 401.07,161.46 105.81,107.69 158.73,245.71 158.73,414.16 0,103 -35.72,182.44 -106.76,238.62zm385.92 -775.54c-191.12,-103.07 -433.52,-154.56 -727.56,-154.56 -305.05,0 -561.25,55.89 -768.9,167.99 -207.13,112.1 -310.93,249.46 -310.93,411.87 0,161.75 95.68,293.79 287.11,396.49 191.32,102.63 433.72,153.75 726.76,153.75 308.06,0 564.73,-55.69 770.64,-167.72 206.11,-112.27 309.09,-250.77 309.09,-415.81 0,-158.16 -95.57,-288.74 -286.21,-392.01z"/>
-    <path class="fil0" d="M7021.21 3237.06c178.31,0 267.6,97.18 267.6,291.68l0 228.59c0,107.16 -19.2,182.8 -57.14,227.68 -20.37,23.16 -45.09,40.46 -75.3,51.88 -30.01,11.58 -68.54,17.34 -114.59,17.34l0 87.05 1010.98 0 0 -87.05c-100.65,0 -165.65,-11.64 -195.78,-34.66 -29.91,-25.74 -44.48,-65.81 -44.48,-119.98l0 -412.06c0,-156.31 -36.57,-270.98 -108.98,-344.09 -72.79,-72.82 -186.88,-109.4 -343.16,-109.4 -230.04,0 -550.24,91.76 -960.54,274.74 -45.07,-182.98 -194.49,-274.74 -448.08,-274.74 -200.68,0 -511.17,91.76 -931.34,274.74l0 -304.75 -77.54 0 -722.64 153.59 0 63.08c139.98,30.88 220.29,54.06 240.96,69.52 23.92,15.53 36.01,37.32 36.01,65.73l0 513.94c0,68.03 -18.06,115.89 -53.37,143.27 -36.02,27.42 -100.24,41.07 -193.2,41.07l-24.22 0 0 87.05 1082.88 0 0 -87.05 -33.3 0c-170.05,0 -255.58,-55.79 -255.58,-168.32l0 -483.24c262.48,-110.42 466.34,-165.61 611.43,-165.61 174.07,0 261.1,85.52 261.1,256.92l0 376.47c0,71.08 -17.64,119.5 -52.67,145.45 -35.26,25.57 -98.21,38.33 -187.97,38.33l0 87.05 1004.72 0 0 -87.05c-160.57,0 -240.77,-58.57 -240.77,-176.05l0 -475.51c270.71,-110.42 472.17,-165.61 604.97,-165.61l0 0z"/>
-    <path class="fil0" d="M5522.94 1600.82l-447.24 666.44 -726.31 -538.3 286.69 1004.04 129.09 -73.04c119.11,-55.63 274.43,-100.25 465.66,-133.56 253.48,-47.98 559.01,-71.92 917.84,-71.92 348.09,0 654.76,24.37 919.08,73.1 93.05,17.19 180.52,37.71 262.08,61.7 81.46,24.05 149.35,48.01 203.4,72.05l127.81 71.67 287.68 -1004.04 -724.48 538.3 -447.34 -666.44 -626.8 650.76 -627.16 -650.76z"/>
-    <path class="fil0" d="M9301.61 3914.73c-126.25,73.8 -222.6,110.57 -290.49,110.57 -65.5,0 -117.63,-16.19 -155.75,-48.85 -21.15,-19.67 -36.49,-39.79 -45.47,-60.95 -9.27,-21.14 -13.46,-44.71 -13.46,-71.45 0,-65.77 21.74,-113.17 65.56,-141.7 44.11,-29.05 118.16,-57.75 222.52,-86.98 104.16,-28.88 176.66,-54.8 217.09,-77.07l0 376.43zm731.73 29.46c-46.43,23.18 -84.87,34.77 -114.38,34.77 -62.68,0 -93.95,-40.47 -93.95,-120.75l0 -497.2c0,-100.22 -74.9,-178.77 -224.34,-235.58 -150.02,-57.02 -308.99,-85.51 -477.55,-85.51 -142.96,0 -315.43,27.3 -517.32,81.83 -202.04,54.62 -302.81,133.15 -302.81,236.32 0,28.51 5.67,59.39 17.85,92.88l481.3 -101.97 -5.7 -20.79 0 -28.41c0,-103.73 77.25,-155.59 232.17,-155.59 76.66,0 141.24,17.56 194.24,51.86 52.69,34.95 78.76,76.14 78.76,124.05l0 97.74c-115.25,58.85 -281.49,110.07 -498.56,153.29 -216.77,43.31 -358.64,89.3 -424.57,138.03 -66.62,48.89 -99.54,109.98 -99.54,183.71 0,84.78 45.66,152.2 137,202.13 91.25,50.03 212.37,75.02 362.87,75.02 95.57,0 181.37,-11.59 257.82,-35.11 76.29,-23.56 167.66,-67.49 273.89,-132.79 33,108.14 132.99,162.32 300.27,162.32 63.62,0 143.77,-15.18 240.19,-45.54 96.24,-30.15 179.05,-67.13 247.73,-110.73l-65.37 -63.98z"/>
-    <path class="fil0" d="M12098.67 4141.28l200.57 -365.18 -131.85 0c-111.72,100.49 -195.86,162.39 -251.74,185.67 -56.32,22.98 -153.99,34.49 -294.53,34.49l-553.25 0 1147.47 -858.24 0 -74.95 -1438.72 0c-97.86,0 -146.9,-15.8 -146.9,-47.45l7.43 -22.25 -144.14 0 -139.47 439.28 139.47 0c76.19,-96.48 134.02,-157.15 174.05,-182.16 49.92,-28.15 115.47,-42.58 196.64,-42.58l598.51 0 -1136.88 847.91 0 85.46 1773.34 0z"/>
-    <path class="fil0" d="M13827.47 3970.02c-71.26,56.03 -165.79,84.21 -284.19,84.21 -176.55,0 -316.05,-60.92 -418.39,-183.23 -101.83,-121.92 -153.3,-256.56 -153.3,-403.87 0,-98.57 35.54,-175.17 106.2,-229.52 70.35,-54.52 169.71,-81.83 297.15,-81.83 160.99,0 294.71,53.9 400.72,161.46 105.59,107.69 158.68,245.71 158.68,414.16 0,103 -35.62,182.44 -106.87,238.62zm385.81 -775.54c-190.72,-103.07 -433.04,-154.56 -727.43,-154.56 -304.76,0 -560.87,55.89 -768.51,167.99 -207.47,112.1 -311.22,249.46 -311.22,411.87 0,161.75 95.68,293.79 287.47,396.49 191.33,102.63 433.22,153.75 726.71,153.75 307.55,0 564.33,-55.69 770.53,-167.72 205.88,-112.27 309.17,-250.77 309.17,-415.81 0,-158.16 -95.57,-288.74 -286.72,-392.01z"/>
-   </g>
-   <g transform="matrix(0.999999 0 0 1 -3225.78 1927.83)">
-    <text x="7250" y="3550"  class="fil1 fnt0">SINCE 1884</text>
-   </g>
-  </g>
- </g>
-</svg>
diff --git a/docs/dist/assets/partners/h3.png b/docs/dist/assets/partners/h3.png
deleted file mode 100644
index 257723c2..00000000
Binary files a/docs/dist/assets/partners/h3.png and /dev/null differ
diff --git a/docs/dist/assets/partners/openide.png b/docs/dist/assets/partners/openide.png
deleted file mode 100644
index 82855b78..00000000
Binary files a/docs/dist/assets/partners/openide.png and /dev/null differ
diff --git a/docs/dist/assets/partners/pt.png b/docs/dist/assets/partners/pt.png
deleted file mode 100644
index c9a3409f..00000000
Binary files a/docs/dist/assets/partners/pt.png and /dev/null differ
diff --git a/docs/dist/assets/partners/yadro.png b/docs/dist/assets/partners/yadro.png
deleted file mode 100644
index bae4cb3d..00000000
Binary files a/docs/dist/assets/partners/yadro.png and /dev/null differ
diff --git a/docs/dist/assets/pieDiagram-ADFJNKIX-Bkw5yNqo.js b/docs/dist/assets/pieDiagram-ADFJNKIX-Bkw5yNqo.js
deleted file mode 100644
index a8adb334..00000000
--- a/docs/dist/assets/pieDiagram-ADFJNKIX-Bkw5yNqo.js
+++ /dev/null
@@ -1,30 +0,0 @@
-import{a8 as S,a3 as F,aG as j,_ as p,g as q,s as H,a as Z,b as J,q as K,p as Q,l as z,c as X,D as Y,H as ee,N as te,e as ae,y as re,F as ne}from"./index-BxX29htg.js";import{p as ie}from"./chunk-4BX2VUAB-BU7cqk0M.js";import{p as se}from"./treemap-KMMF4GRG-DFERHDZP.js";import{d as I}from"./arc-sXMYVGHN.js";import{o as le}from"./ordinal-Cboi1Yqb.js";import"./_baseUniq-CfjWcJYV.js";import"./_basePickBy-CqMtcO3s.js";import"./clone-BRV0rZiZ.js";import"./init-Gi6I4Gst.js";function oe(e,a){return a<e?-1:a>e?1:a>=e?0:NaN}function ce(e){return e}function ue(){var e=ce,a=oe,f=null,y=S(0),s=S(F),o=S(0);function l(t){var n,c=(t=j(t)).length,d,x,h=0,u=new Array(c),i=new Array(c),v=+y.apply(this,arguments),w=Math.min(F,Math.max(-F,s.apply(this,arguments)-v)),m,C=Math.min(Math.abs(w)/c,o.apply(this,arguments)),$=C*(w<0?-1:1),g;for(n=0;n<c;++n)(g=i[u[n]=n]=+e(t[n],n,t))>0&&(h+=g);for(a!=null?u.sort(function(A,D){return a(i[A],i[D])}):f!=null&&u.sort(function(A,D){return f(t[A],t[D])}),n=0,x=h?(w-c*$)/h:0;n<c;++n,v=m)d=u[n],g=i[d],m=v+(g>0?g*x:0)+$,i[d]={data:t[d],index:n,value:g,startAngle:v,endAngle:m,padAngle:C};return i}return l.value=function(t){return arguments.length?(e=typeof t=="function"?t:S(+t),l):e},l.sortValues=function(t){return arguments.length?(a=t,f=null,l):a},l.sort=function(t){return arguments.length?(f=t,a=null,l):f},l.startAngle=function(t){return arguments.length?(y=typeof t=="function"?t:S(+t),l):y},l.endAngle=function(t){return arguments.length?(s=typeof t=="function"?t:S(+t),l):s},l.padAngle=function(t){return arguments.length?(o=typeof t=="function"?t:S(+t),l):o},l}var pe=ne.pie,G={sections:new Map,showData:!1},T=G.sections,N=G.showData,de=structuredClone(pe),ge=p(()=>structuredClone(de),"getConfig"),fe=p(()=>{T=new Map,N=G.showData,re()},"clear"),me=p(({label:e,value:a})=>{if(a<0)throw new Error(`"${e}" has invalid value: ${a}. Negative values are not allowed in pie charts. All slice values must be >= 0.`);T.has(e)||(T.set(e,a),z.debug(`added new section: ${e}, with value: ${a}`))},"addSection"),he=p(()=>T,"getSections"),ve=p(e=>{N=e},"setShowData"),Se=p(()=>N,"getShowData"),L={getConfig:ge,clear:fe,setDiagramTitle:Q,getDiagramTitle:K,setAccTitle:J,getAccTitle:Z,setAccDescription:H,getAccDescription:q,addSection:me,getSections:he,setShowData:ve,getShowData:Se},ye=p((e,a)=>{ie(e,a),a.setShowData(e.showData),e.sections.map(a.addSection)},"populateDb"),xe={parse:p(async e=>{const a=await se("pie",e);z.debug(a),ye(a,L)},"parse")},we=p(e=>`
-  .pieCircle{
-    stroke: ${e.pieStrokeColor};
-    stroke-width : ${e.pieStrokeWidth};
-    opacity : ${e.pieOpacity};
-  }
-  .pieOuterCircle{
-    stroke: ${e.pieOuterStrokeColor};
-    stroke-width: ${e.pieOuterStrokeWidth};
-    fill: none;
-  }
-  .pieTitleText {
-    text-anchor: middle;
-    font-size: ${e.pieTitleTextSize};
-    fill: ${e.pieTitleTextColor};
-    font-family: ${e.fontFamily};
-  }
-  .slice {
-    font-family: ${e.fontFamily};
-    fill: ${e.pieSectionTextColor};
-    font-size:${e.pieSectionTextSize};
-    // fill: white;
-  }
-  .legend text {
-    fill: ${e.pieLegendTextColor};
-    font-family: ${e.fontFamily};
-    font-size: ${e.pieLegendTextSize};
-  }
-`,"getStyles"),Ae=we,De=p(e=>{const a=[...e.values()].reduce((s,o)=>s+o,0),f=[...e.entries()].map(([s,o])=>({label:s,value:o})).filter(s=>s.value/a*100>=1).sort((s,o)=>o.value-s.value);return ue().value(s=>s.value)(f)},"createPieArcs"),Ce=p((e,a,f,y)=>{z.debug(`rendering pie chart
-`+e);const s=y.db,o=X(),l=Y(s.getConfig(),o.pie),t=40,n=18,c=4,d=450,x=d,h=ee(a),u=h.append("g");u.attr("transform","translate("+x/2+","+d/2+")");const{themeVariables:i}=o;let[v]=te(i.pieOuterStrokeWidth);v??=2;const w=l.textPosition,m=Math.min(x,d)/2-t,C=I().innerRadius(0).outerRadius(m),$=I().innerRadius(m*w).outerRadius(m*w);u.append("circle").attr("cx",0).attr("cy",0).attr("r",m+v/2).attr("class","pieOuterCircle");const g=s.getSections(),A=De(g),D=[i.pie1,i.pie2,i.pie3,i.pie4,i.pie5,i.pie6,i.pie7,i.pie8,i.pie9,i.pie10,i.pie11,i.pie12];let b=0;g.forEach(r=>{b+=r});const W=A.filter(r=>(r.data.value/b*100).toFixed(0)!=="0"),E=le(D);u.selectAll("mySlices").data(W).enter().append("path").attr("d",C).attr("fill",r=>E(r.data.label)).attr("class","pieCircle"),u.selectAll("mySlices").data(W).enter().append("text").text(r=>(r.data.value/b*100).toFixed(0)+"%").attr("transform",r=>"translate("+$.centroid(r)+")").style("text-anchor","middle").attr("class","slice"),u.append("text").text(s.getDiagramTitle()).attr("x",0).attr("y",-400/2).attr("class","pieTitleText");const O=[...g.entries()].map(([r,M])=>({label:r,value:M})),k=u.selectAll(".legend").data(O).enter().append("g").attr("class","legend").attr("transform",(r,M)=>{const R=n+c,B=R*O.length/2,V=12*n,U=M*R-B;return"translate("+V+","+U+")"});k.append("rect").attr("width",n).attr("height",n).style("fill",r=>E(r.label)).style("stroke",r=>E(r.label)),k.append("text").attr("x",n+c).attr("y",n-c).text(r=>s.getShowData()?`${r.label} [${r.value}]`:r.label);const _=Math.max(...k.selectAll("text").nodes().map(r=>r?.getBoundingClientRect().width??0)),P=x+t+n+c+_;h.attr("viewBox",`0 0 ${P} ${d}`),ae(h,d,P,l.useMaxWidth)},"draw"),$e={draw:Ce},We={parser:xe,db:L,renderer:$e,styles:Ae};export{We as diagram};
diff --git a/docs/dist/assets/prism-bash-DTkDXsAh.js b/docs/dist/assets/prism-bash-DTkDXsAh.js
deleted file mode 100644
index 7f5331be..00000000
--- a/docs/dist/assets/prism-bash-DTkDXsAh.js
+++ /dev/null
@@ -1 +0,0 @@
-(function(e){var a="\\b(?:BASH|BASHOPTS|BASH_ALIASES|BASH_ARGC|BASH_ARGV|BASH_CMDS|BASH_COMPLETION_COMPAT_DIR|BASH_LINENO|BASH_REMATCH|BASH_SOURCE|BASH_VERSINFO|BASH_VERSION|COLORTERM|COLUMNS|COMP_WORDBREAKS|DBUS_SESSION_BUS_ADDRESS|DEFAULTS_PATH|DESKTOP_SESSION|DIRSTACK|DISPLAY|EUID|GDMSESSION|GDM_LANG|GNOME_KEYRING_CONTROL|GNOME_KEYRING_PID|GPG_AGENT_INFO|GROUPS|HISTCONTROL|HISTFILE|HISTFILESIZE|HISTSIZE|HOME|HOSTNAME|HOSTTYPE|IFS|INSTANCE|JOB|LANG|LANGUAGE|LC_ADDRESS|LC_ALL|LC_IDENTIFICATION|LC_MEASUREMENT|LC_MONETARY|LC_NAME|LC_NUMERIC|LC_PAPER|LC_TELEPHONE|LC_TIME|LESSCLOSE|LESSOPEN|LINES|LOGNAME|LS_COLORS|MACHTYPE|MAILCHECK|MANDATORY_PATH|NO_AT_BRIDGE|OLDPWD|OPTERR|OPTIND|ORBIT_SOCKETDIR|OSTYPE|PAPERSIZE|PATH|PIPESTATUS|PPID|PS1|PS2|PS3|PS4|PWD|RANDOM|REPLY|SECONDS|SELINUX_INIT|SESSION|SESSIONTYPE|SESSION_MANAGER|SHELL|SHELLOPTS|SHLVL|SSH_AUTH_SOCK|TERM|UID|UPSTART_EVENTS|UPSTART_INSTANCE|UPSTART_JOB|UPSTART_SESSION|USER|WINDOWID|XAUTHORITY|XDG_CONFIG_DIRS|XDG_CURRENT_DESKTOP|XDG_DATA_DIRS|XDG_GREETER_DATA_DIR|XDG_MENU_PREFIX|XDG_RUNTIME_DIR|XDG_SEAT|XDG_SEAT_PATH|XDG_SESSION_DESKTOP|XDG_SESSION_ID|XDG_SESSION_PATH|XDG_SESSION_TYPE|XDG_VTNR|XMODIFIERS)\\b",r={pattern:/(^(["']?)\w+\2)[ \t]+\S.*/,lookbehind:!0,alias:"punctuation",inside:null},t={bash:r,environment:{pattern:RegExp("\\$"+a),alias:"constant"},variable:[{pattern:/\$?\(\([\s\S]+?\)\)/,greedy:!0,inside:{variable:[{pattern:/(^\$\(\([\s\S]+)\)\)/,lookbehind:!0},/^\$\(\(/],number:/\b0x[\dA-Fa-f]+\b|(?:\b\d+(?:\.\d*)?|\B\.\d+)(?:[Ee]-?\d+)?/,operator:/--|\+\+|\*\*=?|<<=?|>>=?|&&|\|\||[=!+\-*/%<>^&|]=?|[?~:]/,punctuation:/\(\(?|\)\)?|,|;/}},{pattern:/\$\((?:\([^)]+\)|[^()])+\)|`[^`]+`/,greedy:!0,inside:{variable:/^\$\(|^`|\)$|`$/}},{pattern:/\$\{[^}]+\}/,greedy:!0,inside:{operator:/:[-=?+]?|[!\/]|##?|%%?|\^\^?|,,?/,punctuation:/[\[\]]/,environment:{pattern:RegExp("(\\{)"+a),lookbehind:!0,alias:"constant"}}},/\$(?:\w+|[#?*!@$])/],entity:/\\(?:[abceEfnrtv\\"]|O?[0-7]{1,3}|U[0-9a-fA-F]{8}|u[0-9a-fA-F]{4}|x[0-9a-fA-F]{1,2})/};e.languages.bash={shebang:{pattern:/^#!\s*\/.*/,alias:"important"},comment:{pattern:/(^|[^"{\\$])#.*/,lookbehind:!0},"function-name":[{pattern:/(\bfunction\s+)[\w-]+(?=(?:\s*\(?:\s*\))?\s*\{)/,lookbehind:!0,alias:"function"},{pattern:/\b[\w-]+(?=\s*\(\s*\)\s*\{)/,alias:"function"}],"for-or-select":{pattern:/(\b(?:for|select)\s+)\w+(?=\s+in\s)/,alias:"variable",lookbehind:!0},"assign-left":{pattern:/(^|[\s;|&]|[<>]\()\w+(?:\.\w+)*(?=\+?=)/,inside:{environment:{pattern:RegExp("(^|[\\s;|&]|[<>]\\()"+a),lookbehind:!0,alias:"constant"}},alias:"variable",lookbehind:!0},parameter:{pattern:/(^|\s)-{1,2}(?:\w+:[+-]?)?\w+(?:\.\w+)*(?=[=\s]|$)/,alias:"variable",lookbehind:!0},string:[{pattern:/((?:^|[^<])<<-?\s*)(\w+)\s[\s\S]*?(?:\r?\n|\r)\2/,lookbehind:!0,greedy:!0,inside:t},{pattern:/((?:^|[^<])<<-?\s*)(["'])(\w+)\2\s[\s\S]*?(?:\r?\n|\r)\3/,lookbehind:!0,greedy:!0,inside:{bash:r}},{pattern:/(^|[^\\](?:\\\\)*)"(?:\\[\s\S]|\$\([^)]+\)|\$(?!\()|`[^`]+`|[^"\\`$])*"/,lookbehind:!0,greedy:!0,inside:t},{pattern:/(^|[^$\\])'[^']*'/,lookbehind:!0,greedy:!0},{pattern:/\$'(?:[^'\\]|\\[\s\S])*'/,greedy:!0,inside:{entity:t.entity}}],environment:{pattern:RegExp("\\$?"+a),alias:"constant"},variable:t.variable,function:{pattern:/(^|[\s;|&]|[<>]\()(?:add|apropos|apt|apt-cache|apt-get|aptitude|aspell|automysqlbackup|awk|basename|bash|bc|bconsole|bg|bzip2|cal|cargo|cat|cfdisk|chgrp|chkconfig|chmod|chown|chroot|cksum|clear|cmp|column|comm|composer|cp|cron|crontab|csplit|curl|cut|date|dc|dd|ddrescue|debootstrap|df|diff|diff3|dig|dir|dircolors|dirname|dirs|dmesg|docker|docker-compose|du|egrep|eject|env|ethtool|expand|expect|expr|fdformat|fdisk|fg|fgrep|file|find|fmt|fold|format|free|fsck|ftp|fuser|gawk|git|gparted|grep|groupadd|groupdel|groupmod|groups|grub-mkconfig|gzip|halt|head|hg|history|host|hostname|htop|iconv|id|ifconfig|ifdown|ifup|import|install|ip|java|jobs|join|kill|killall|less|link|ln|locate|logname|logrotate|look|lpc|lpr|lprint|lprintd|lprintq|lprm|ls|lsof|lynx|make|man|mc|mdadm|mkconfig|mkdir|mke2fs|mkfifo|mkfs|mkisofs|mknod|mkswap|mmv|more|most|mount|mtools|mtr|mutt|mv|nano|nc|netstat|nice|nl|node|nohup|notify-send|npm|nslookup|op|open|parted|passwd|paste|pathchk|ping|pkill|pnpm|podman|podman-compose|popd|pr|printcap|printenv|ps|pushd|pv|quota|quotacheck|quotactl|ram|rar|rcp|reboot|remsync|rename|renice|rev|rm|rmdir|rpm|rsync|scp|screen|sdiff|sed|sendmail|seq|service|sftp|sh|shellcheck|shuf|shutdown|sleep|slocate|sort|split|ssh|stat|strace|su|sudo|sum|suspend|swapon|sync|sysctl|tac|tail|tar|tee|time|timeout|top|touch|tr|traceroute|tsort|tty|umount|uname|unexpand|uniq|units|unrar|unshar|unzip|update-grub|uptime|useradd|userdel|usermod|users|uudecode|uuencode|v|vcpkg|vdir|vi|vim|virsh|vmstat|wait|watch|wc|wget|whereis|which|who|whoami|write|xargs|xdg-open|yarn|yes|zenity|zip|zsh|zypper)(?=$|[)\s;|&])/,lookbehind:!0},keyword:{pattern:/(^|[\s;|&]|[<>]\()(?:case|do|done|elif|else|esac|fi|for|function|if|in|select|then|until|while)(?=$|[)\s;|&])/,lookbehind:!0},builtin:{pattern:/(^|[\s;|&]|[<>]\()(?:\.|:|alias|bind|break|builtin|caller|cd|command|continue|declare|echo|enable|eval|exec|exit|export|getopts|hash|help|let|local|logout|mapfile|printf|pwd|read|readarray|readonly|return|set|shift|shopt|source|test|times|trap|type|typeset|ulimit|umask|unalias|unset)(?=$|[)\s;|&])/,lookbehind:!0,alias:"class-name"},boolean:{pattern:/(^|[\s;|&]|[<>]\()(?:false|true)(?=$|[)\s;|&])/,lookbehind:!0},"file-descriptor":{pattern:/\B&\d\b/,alias:"important"},operator:{pattern:/\d?<>|>\||\+=|=[=~]?|!=?|<<[<-]?|[&\d]?>>|\d[<>]&?|[<>][&=]?|&[>&]?|\|[&|]?/,inside:{"file-descriptor":{pattern:/^\d/,alias:"important"}}},punctuation:/\$?\(\(?|\)\)?|\.\.|[{}[\];\\]/,number:{pattern:/(^|\s)(?:[1-9]\d*|0)(?:[.,]\d+)?\b/,lookbehind:!0}},r.inside=e.languages.bash;for(var o=["comment","function-name","for-or-select","assign-left","parameter","string","environment","function","keyword","builtin","boolean","file-descriptor","operator","punctuation","number"],s=t.variable[1].inside,n=0;n<o.length;n++)s[o[n]]=e.languages.bash[o[n]];e.languages.sh=e.languages.bash,e.languages.shell=e.languages.bash})(Prism);
diff --git a/docs/dist/assets/prism-go-CyY0RbE6.js b/docs/dist/assets/prism-go-CyY0RbE6.js
deleted file mode 100644
index f41bf6c1..00000000
--- a/docs/dist/assets/prism-go-CyY0RbE6.js
+++ /dev/null
@@ -1 +0,0 @@
-Prism.languages.go=Prism.languages.extend("clike",{string:{pattern:/(^|[^\\])"(?:\\.|[^"\\\r\n])*"|`[^`]*`/,lookbehind:!0,greedy:!0},keyword:/\b(?:break|case|chan|const|continue|default|defer|else|fallthrough|for|func|go(?:to)?|if|import|interface|map|package|range|return|select|struct|switch|type|var)\b/,boolean:/\b(?:_|false|iota|nil|true)\b/,number:[/\b0(?:b[01_]+|o[0-7_]+)i?\b/i,/\b0x(?:[a-f\d_]+(?:\.[a-f\d_]*)?|\.[a-f\d_]+)(?:p[+-]?\d+(?:_\d+)*)?i?(?!\w)/i,/(?:\b\d[\d_]*(?:\.[\d_]*)?|\B\.\d[\d_]*)(?:e[+-]?[\d_]+)?i?(?!\w)/i],operator:/[*\/%^!=]=?|\+[=+]?|-[=-]?|\|[=|]?|&(?:=|&|\^=?)?|>(?:>=?|=)?|<(?:<=?|=|-)?|:=|\.\.\./,builtin:/\b(?:append|bool|byte|cap|close|complex|complex(?:64|128)|copy|delete|error|float(?:32|64)|u?int(?:8|16|32|64)?|imag|len|make|new|panic|print(?:ln)?|real|recover|rune|string|uintptr)\b/});Prism.languages.insertBefore("go","string",{char:{pattern:/'(?:\\.|[^'\\\r\n]){0,10}'/,greedy:!0}});delete Prism.languages.go["class-name"];
diff --git a/docs/dist/assets/prism-json-xwnKirkR.js b/docs/dist/assets/prism-json-xwnKirkR.js
deleted file mode 100644
index 81219ceb..00000000
--- a/docs/dist/assets/prism-json-xwnKirkR.js
+++ /dev/null
@@ -1 +0,0 @@
-Prism.languages.json={property:{pattern:/(^|[^\\])"(?:\\.|[^\\"\r\n])*"(?=\s*:)/,lookbehind:!0,greedy:!0},string:{pattern:/(^|[^\\])"(?:\\.|[^\\"\r\n])*"(?!\s*:)/,lookbehind:!0,greedy:!0},comment:{pattern:/\/\/.*|\/\*[\s\S]*?(?:\*\/|$)/,greedy:!0},number:/-?\b\d+(?:\.\d+)?(?:e[+-]?\d+)?\b/i,punctuation:/[{}[\],]/,operator:/:/,boolean:/\b(?:false|true)\b/,null:{pattern:/\bnull\b/,alias:"keyword"}};Prism.languages.webmanifest=Prism.languages.json;
diff --git a/docs/dist/assets/prism-protobuf-DiQ_z8B5.js b/docs/dist/assets/prism-protobuf-DiQ_z8B5.js
deleted file mode 100644
index c7c195b7..00000000
--- a/docs/dist/assets/prism-protobuf-DiQ_z8B5.js
+++ /dev/null
@@ -1 +0,0 @@
-(function(e){var s=/\b(?:bool|bytes|double|s?fixed(?:32|64)|float|[su]?int(?:32|64)|string)\b/;e.languages.protobuf=e.languages.extend("clike",{"class-name":[{pattern:/(\b(?:enum|extend|message|service)\s+)[A-Za-z_]\w*(?=\s*\{)/,lookbehind:!0},{pattern:/(\b(?:rpc\s+\w+|returns)\s*\(\s*(?:stream\s+)?)\.?[A-Za-z_]\w*(?:\.[A-Za-z_]\w*)*(?=\s*\))/,lookbehind:!0}],keyword:/\b(?:enum|extend|extensions|import|message|oneof|option|optional|package|public|repeated|required|reserved|returns|rpc(?=\s+\w)|service|stream|syntax|to)\b(?!\s*=\s*\d)/,function:/\b[a-z_]\w*(?=\s*\()/i}),e.languages.insertBefore("protobuf","operator",{map:{pattern:/\bmap<\s*[\w.]+\s*,\s*[\w.]+\s*>(?=\s+[a-z_]\w*\s*[=;])/i,alias:"class-name",inside:{punctuation:/[<>.,]/,builtin:s}},builtin:s,"positional-class-name":{pattern:/(?:\b|\B\.)[a-z_]\w*(?:\.[a-z_]\w*)*(?=\s+[a-z_]\w*\s*[=;])/i,alias:"class-name",inside:{punctuation:/\./}},annotation:{pattern:/(\[\s*)[a-z_]\w*(?=\s*=)/i,lookbehind:!0}})})(Prism);
diff --git a/docs/dist/assets/prism-yaml-Chm5ZdEN.js b/docs/dist/assets/prism-yaml-Chm5ZdEN.js
deleted file mode 100644
index 2b9d7cfa..00000000
--- a/docs/dist/assets/prism-yaml-Chm5ZdEN.js
+++ /dev/null
@@ -1 +0,0 @@
-(function(r){var t=/[*&][^\s[\]{},]+/,n=/!(?:<[\w\-%#;/?:@&=+$,.!~*'()[\]]+>|(?:[a-zA-Z\d-]*!)?[\w\-%#;/?:@&=+$.~*'()]+)?/,a="(?:"+n.source+"(?:[ 	]+"+t.source+")?|"+t.source+"(?:[ 	]+"+n.source+")?)",d=/(?:[^\s\x00-\x08\x0e-\x1f!"#%&'*,\-:>?@[\]`{|}\x7f-\x84\x86-\x9f\ud800-\udfff\ufffe\uffff]|[?:-]<PLAIN>)(?:[ \t]*(?:(?![#:])<PLAIN>|:<PLAIN>))*/.source.replace(/<PLAIN>/g,function(){return/[^\s\x00-\x08\x0e-\x1f,[\]{}\x7f-\x84\x86-\x9f\ud800-\udfff\ufffe\uffff]/.source}),o=/"(?:[^"\\\r\n]|\\.)*"|'(?:[^'\\\r\n]|\\.)*'/.source;function e(i,u){u=(u||"").replace(/m/g,"")+"m";var p=/([:\-,[{]\s*(?:\s<<prop>>[ \t]+)?)(?:<<value>>)(?=[ \t]*(?:$|,|\]|\}|(?:[\r\n]\s*)?#))/.source.replace(/<<prop>>/g,function(){return a}).replace(/<<value>>/g,function(){return i});return RegExp(p,u)}r.languages.yaml={scalar:{pattern:RegExp(/([\-:]\s*(?:\s<<prop>>[ \t]+)?[|>])[ \t]*(?:((?:\r?\n|\r)[ \t]+)\S[^\r\n]*(?:\2[^\r\n]+)*)/.source.replace(/<<prop>>/g,function(){return a})),lookbehind:!0,alias:"string"},comment:/#.*/,key:{pattern:RegExp(/((?:^|[:\-,[{\r\n?])[ \t]*(?:<<prop>>[ \t]+)?)<<key>>(?=\s*:\s)/.source.replace(/<<prop>>/g,function(){return a}).replace(/<<key>>/g,function(){return"(?:"+d+"|"+o+")"})),lookbehind:!0,greedy:!0,alias:"atrule"},directive:{pattern:/(^[ \t]*)%.+/m,lookbehind:!0,alias:"important"},datetime:{pattern:e(/\d{4}-\d\d?-\d\d?(?:[tT]|[ \t]+)\d\d?:\d{2}:\d{2}(?:\.\d*)?(?:[ \t]*(?:Z|[-+]\d\d?(?::\d{2})?))?|\d{4}-\d{2}-\d{2}|\d\d?:\d{2}(?::\d{2}(?:\.\d*)?)?/.source),lookbehind:!0,alias:"number"},boolean:{pattern:e(/false|true/.source,"i"),lookbehind:!0,alias:"important"},null:{pattern:e(/null|~/.source,"i"),lookbehind:!0,alias:"important"},string:{pattern:e(o),lookbehind:!0,greedy:!0},number:{pattern:e(/[+-]?(?:0x[\da-f]+|0o[0-7]+|(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?|\.inf|\.nan)/.source,"i"),lookbehind:!0},tag:n,important:t,punctuation:/---|[:[\]{}\-,|>?]|\.\.\./},r.languages.yml=r.languages.yaml})(Prism);
diff --git a/docs/dist/assets/quadrantDiagram-AYHSOK5B-IIW4tBOO.js b/docs/dist/assets/quadrantDiagram-AYHSOK5B-IIW4tBOO.js
deleted file mode 100644
index 2d4db45b..00000000
--- a/docs/dist/assets/quadrantDiagram-AYHSOK5B-IIW4tBOO.js
+++ /dev/null
@@ -1,7 +0,0 @@
-import{_ as o,s as _e,g as Ae,q as ie,p as ke,a as Fe,b as Pe,c as zt,l as bt,d as Lt,e as ve,y as Ce,F as D,K as Le,i as Ee}from"./index-BxX29htg.js";import{l as ee}from"./linear-hh6lJPrN.js";import"./init-Gi6I4Gst.js";import"./defaultLocale-C4B-KCzX.js";var Et=(function(){var t=o(function(M,r,l,x){for(l=l||{},x=M.length;x--;l[M[x]]=r);return l},"o"),n=[1,3],f=[1,4],d=[1,5],h=[1,6],p=[1,7],y=[1,4,5,10,12,13,14,18,25,35,37,39,41,42,48,50,51,52,53,54,55,56,57,60,61,63,64,65,66,67],_=[1,4,5,10,12,13,14,18,25,28,35,37,39,41,42,48,50,51,52,53,54,55,56,57,60,61,63,64,65,66,67],a=[55,56,57],A=[2,36],u=[1,37],T=[1,36],q=[1,38],m=[1,35],b=[1,43],g=[1,41],G=[1,14],ht=[1,23],xt=[1,18],ft=[1,19],gt=[1,20],ct=[1,21],_t=[1,22],dt=[1,24],i=[1,25],Vt=[1,26],It=[1,27],wt=[1,28],Bt=[1,29],W=[1,32],U=[1,33],k=[1,34],F=[1,39],P=[1,40],v=[1,42],C=[1,44],O=[1,62],H=[1,61],L=[4,5,8,10,12,13,14,18,44,47,49,55,56,57,63,64,65,66,67],Rt=[1,65],Nt=[1,66],Wt=[1,67],Ut=[1,68],Qt=[1,69],Ot=[1,70],Ht=[1,71],Xt=[1,72],Mt=[1,73],Yt=[1,74],jt=[1,75],Gt=[1,76],I=[4,5,6,7,8,9,10,11,12,13,14,15,18],K=[1,90],Z=[1,91],J=[1,92],$=[1,99],tt=[1,93],et=[1,96],it=[1,94],at=[1,95],nt=[1,97],st=[1,98],At=[1,102],Kt=[10,55,56,57],R=[4,5,6,8,10,11,13,17,18,19,20,55,56,57],kt={trace:o(function(){},"trace"),yy:{},symbols_:{error:2,idStringToken:3,ALPHA:4,NUM:5,NODE_STRING:6,DOWN:7,MINUS:8,DEFAULT:9,COMMA:10,COLON:11,AMP:12,BRKT:13,MULT:14,UNICODE_TEXT:15,styleComponent:16,UNIT:17,SPACE:18,STYLE:19,PCT:20,idString:21,style:22,stylesOpt:23,classDefStatement:24,CLASSDEF:25,start:26,eol:27,QUADRANT:28,document:29,line:30,statement:31,axisDetails:32,quadrantDetails:33,points:34,title:35,title_value:36,acc_title:37,acc_title_value:38,acc_descr:39,acc_descr_value:40,acc_descr_multiline_value:41,section:42,text:43,point_start:44,point_x:45,point_y:46,class_name:47,"X-AXIS":48,"AXIS-TEXT-DELIMITER":49,"Y-AXIS":50,QUADRANT_1:51,QUADRANT_2:52,QUADRANT_3:53,QUADRANT_4:54,NEWLINE:55,SEMI:56,EOF:57,alphaNumToken:58,textNoTagsToken:59,STR:60,MD_STR:61,alphaNum:62,PUNCTUATION:63,PLUS:64,EQUALS:65,DOT:66,UNDERSCORE:67,$accept:0,$end:1},terminals_:{2:"error",4:"ALPHA",5:"NUM",6:"NODE_STRING",7:"DOWN",8:"MINUS",9:"DEFAULT",10:"COMMA",11:"COLON",12:"AMP",13:"BRKT",14:"MULT",15:"UNICODE_TEXT",17:"UNIT",18:"SPACE",19:"STYLE",20:"PCT",25:"CLASSDEF",28:"QUADRANT",35:"title",36:"title_value",37:"acc_title",38:"acc_title_value",39:"acc_descr",40:"acc_descr_value",41:"acc_descr_multiline_value",42:"section",44:"point_start",45:"point_x",46:"point_y",47:"class_name",48:"X-AXIS",49:"AXIS-TEXT-DELIMITER",50:"Y-AXIS",51:"QUADRANT_1",52:"QUADRANT_2",53:"QUADRANT_3",54:"QUADRANT_4",55:"NEWLINE",56:"SEMI",57:"EOF",60:"STR",61:"MD_STR",63:"PUNCTUATION",64:"PLUS",65:"EQUALS",66:"DOT",67:"UNDERSCORE"},productions_:[0,[3,1],[3,1],[3,1],[3,1],[3,1],[3,1],[3,1],[3,1],[3,1],[3,1],[3,1],[3,1],[16,1],[16,1],[16,1],[16,1],[16,1],[16,1],[16,1],[16,1],[16,1],[16,1],[21,1],[21,2],[22,1],[22,2],[23,1],[23,3],[24,5],[26,2],[26,2],[26,2],[29,0],[29,2],[30,2],[31,0],[31,1],[31,2],[31,1],[31,1],[31,1],[31,2],[31,2],[31,2],[31,1],[31,1],[34,4],[34,5],[34,5],[34,6],[32,4],[32,3],[32,2],[32,4],[32,3],[32,2],[33,2],[33,2],[33,2],[33,2],[27,1],[27,1],[27,1],[43,1],[43,2],[43,1],[43,1],[62,1],[62,2],[58,1],[58,1],[58,1],[58,1],[58,1],[58,1],[58,1],[58,1],[58,1],[58,1],[58,1],[59,1],[59,1],[59,1]],performAction:o(function(r,l,x,c,S,e,ut){var s=e.length-1;switch(S){case 23:this.$=e[s];break;case 24:this.$=e[s-1]+""+e[s];break;case 26:this.$=e[s-1]+e[s];break;case 27:this.$=[e[s].trim()];break;case 28:e[s-2].push(e[s].trim()),this.$=e[s-2];break;case 29:this.$=e[s-4],c.addClass(e[s-2],e[s]);break;case 37:this.$=[];break;case 42:this.$=e[s].trim(),c.setDiagramTitle(this.$);break;case 43:this.$=e[s].trim(),c.setAccTitle(this.$);break;case 44:case 45:this.$=e[s].trim(),c.setAccDescription(this.$);break;case 46:c.addSection(e[s].substr(8)),this.$=e[s].substr(8);break;case 47:c.addPoint(e[s-3],"",e[s-1],e[s],[]);break;case 48:c.addPoint(e[s-4],e[s-3],e[s-1],e[s],[]);break;case 49:c.addPoint(e[s-4],"",e[s-2],e[s-1],e[s]);break;case 50:c.addPoint(e[s-5],e[s-4],e[s-2],e[s-1],e[s]);break;case 51:c.setXAxisLeftText(e[s-2]),c.setXAxisRightText(e[s]);break;case 52:e[s-1].text+=" ⟶ ",c.setXAxisLeftText(e[s-1]);break;case 53:c.setXAxisLeftText(e[s]);break;case 54:c.setYAxisBottomText(e[s-2]),c.setYAxisTopText(e[s]);break;case 55:e[s-1].text+=" ⟶ ",c.setYAxisBottomText(e[s-1]);break;case 56:c.setYAxisBottomText(e[s]);break;case 57:c.setQuadrant1Text(e[s]);break;case 58:c.setQuadrant2Text(e[s]);break;case 59:c.setQuadrant3Text(e[s]);break;case 60:c.setQuadrant4Text(e[s]);break;case 64:this.$={text:e[s],type:"text"};break;case 65:this.$={text:e[s-1].text+""+e[s],type:e[s-1].type};break;case 66:this.$={text:e[s],type:"text"};break;case 67:this.$={text:e[s],type:"markdown"};break;case 68:this.$=e[s];break;case 69:this.$=e[s-1]+""+e[s];break}},"anonymous"),table:[{18:n,26:1,27:2,28:f,55:d,56:h,57:p},{1:[3]},{18:n,26:8,27:2,28:f,55:d,56:h,57:p},{18:n,26:9,27:2,28:f,55:d,56:h,57:p},t(y,[2,33],{29:10}),t(_,[2,61]),t(_,[2,62]),t(_,[2,63]),{1:[2,30]},{1:[2,31]},t(a,A,{30:11,31:12,24:13,32:15,33:16,34:17,43:30,58:31,1:[2,32],4:u,5:T,10:q,12:m,13:b,14:g,18:G,25:ht,35:xt,37:ft,39:gt,41:ct,42:_t,48:dt,50:i,51:Vt,52:It,53:wt,54:Bt,60:W,61:U,63:k,64:F,65:P,66:v,67:C}),t(y,[2,34]),{27:45,55:d,56:h,57:p},t(a,[2,37]),t(a,A,{24:13,32:15,33:16,34:17,43:30,58:31,31:46,4:u,5:T,10:q,12:m,13:b,14:g,18:G,25:ht,35:xt,37:ft,39:gt,41:ct,42:_t,48:dt,50:i,51:Vt,52:It,53:wt,54:Bt,60:W,61:U,63:k,64:F,65:P,66:v,67:C}),t(a,[2,39]),t(a,[2,40]),t(a,[2,41]),{36:[1,47]},{38:[1,48]},{40:[1,49]},t(a,[2,45]),t(a,[2,46]),{18:[1,50]},{4:u,5:T,10:q,12:m,13:b,14:g,43:51,58:31,60:W,61:U,63:k,64:F,65:P,66:v,67:C},{4:u,5:T,10:q,12:m,13:b,14:g,43:52,58:31,60:W,61:U,63:k,64:F,65:P,66:v,67:C},{4:u,5:T,10:q,12:m,13:b,14:g,43:53,58:31,60:W,61:U,63:k,64:F,65:P,66:v,67:C},{4:u,5:T,10:q,12:m,13:b,14:g,43:54,58:31,60:W,61:U,63:k,64:F,65:P,66:v,67:C},{4:u,5:T,10:q,12:m,13:b,14:g,43:55,58:31,60:W,61:U,63:k,64:F,65:P,66:v,67:C},{4:u,5:T,10:q,12:m,13:b,14:g,43:56,58:31,60:W,61:U,63:k,64:F,65:P,66:v,67:C},{4:u,5:T,8:O,10:q,12:m,13:b,14:g,18:H,44:[1,57],47:[1,58],58:60,59:59,63:k,64:F,65:P,66:v,67:C},t(L,[2,64]),t(L,[2,66]),t(L,[2,67]),t(L,[2,70]),t(L,[2,71]),t(L,[2,72]),t(L,[2,73]),t(L,[2,74]),t(L,[2,75]),t(L,[2,76]),t(L,[2,77]),t(L,[2,78]),t(L,[2,79]),t(L,[2,80]),t(y,[2,35]),t(a,[2,38]),t(a,[2,42]),t(a,[2,43]),t(a,[2,44]),{3:64,4:Rt,5:Nt,6:Wt,7:Ut,8:Qt,9:Ot,10:Ht,11:Xt,12:Mt,13:Yt,14:jt,15:Gt,21:63},t(a,[2,53],{59:59,58:60,4:u,5:T,8:O,10:q,12:m,13:b,14:g,18:H,49:[1,77],63:k,64:F,65:P,66:v,67:C}),t(a,[2,56],{59:59,58:60,4:u,5:T,8:O,10:q,12:m,13:b,14:g,18:H,49:[1,78],63:k,64:F,65:P,66:v,67:C}),t(a,[2,57],{59:59,58:60,4:u,5:T,8:O,10:q,12:m,13:b,14:g,18:H,63:k,64:F,65:P,66:v,67:C}),t(a,[2,58],{59:59,58:60,4:u,5:T,8:O,10:q,12:m,13:b,14:g,18:H,63:k,64:F,65:P,66:v,67:C}),t(a,[2,59],{59:59,58:60,4:u,5:T,8:O,10:q,12:m,13:b,14:g,18:H,63:k,64:F,65:P,66:v,67:C}),t(a,[2,60],{59:59,58:60,4:u,5:T,8:O,10:q,12:m,13:b,14:g,18:H,63:k,64:F,65:P,66:v,67:C}),{45:[1,79]},{44:[1,80]},t(L,[2,65]),t(L,[2,81]),t(L,[2,82]),t(L,[2,83]),{3:82,4:Rt,5:Nt,6:Wt,7:Ut,8:Qt,9:Ot,10:Ht,11:Xt,12:Mt,13:Yt,14:jt,15:Gt,18:[1,81]},t(I,[2,23]),t(I,[2,1]),t(I,[2,2]),t(I,[2,3]),t(I,[2,4]),t(I,[2,5]),t(I,[2,6]),t(I,[2,7]),t(I,[2,8]),t(I,[2,9]),t(I,[2,10]),t(I,[2,11]),t(I,[2,12]),t(a,[2,52],{58:31,43:83,4:u,5:T,10:q,12:m,13:b,14:g,60:W,61:U,63:k,64:F,65:P,66:v,67:C}),t(a,[2,55],{58:31,43:84,4:u,5:T,10:q,12:m,13:b,14:g,60:W,61:U,63:k,64:F,65:P,66:v,67:C}),{46:[1,85]},{45:[1,86]},{4:K,5:Z,6:J,8:$,11:tt,13:et,16:89,17:it,18:at,19:nt,20:st,22:88,23:87},t(I,[2,24]),t(a,[2,51],{59:59,58:60,4:u,5:T,8:O,10:q,12:m,13:b,14:g,18:H,63:k,64:F,65:P,66:v,67:C}),t(a,[2,54],{59:59,58:60,4:u,5:T,8:O,10:q,12:m,13:b,14:g,18:H,63:k,64:F,65:P,66:v,67:C}),t(a,[2,47],{22:88,16:89,23:100,4:K,5:Z,6:J,8:$,11:tt,13:et,17:it,18:at,19:nt,20:st}),{46:[1,101]},t(a,[2,29],{10:At}),t(Kt,[2,27],{16:103,4:K,5:Z,6:J,8:$,11:tt,13:et,17:it,18:at,19:nt,20:st}),t(R,[2,25]),t(R,[2,13]),t(R,[2,14]),t(R,[2,15]),t(R,[2,16]),t(R,[2,17]),t(R,[2,18]),t(R,[2,19]),t(R,[2,20]),t(R,[2,21]),t(R,[2,22]),t(a,[2,49],{10:At}),t(a,[2,48],{22:88,16:89,23:104,4:K,5:Z,6:J,8:$,11:tt,13:et,17:it,18:at,19:nt,20:st}),{4:K,5:Z,6:J,8:$,11:tt,13:et,16:89,17:it,18:at,19:nt,20:st,22:105},t(R,[2,26]),t(a,[2,50],{10:At}),t(Kt,[2,28],{16:103,4:K,5:Z,6:J,8:$,11:tt,13:et,17:it,18:at,19:nt,20:st})],defaultActions:{8:[2,30],9:[2,31]},parseError:o(function(r,l){if(l.recoverable)this.trace(r);else{var x=new Error(r);throw x.hash=l,x}},"parseError"),parse:o(function(r){var l=this,x=[0],c=[],S=[null],e=[],ut=this.table,s="",yt=0,Zt=0,qe=2,Jt=1,me=e.slice.call(arguments,1),E=Object.create(this.lexer),Y={yy:{}};for(var Ft in this.yy)Object.prototype.hasOwnProperty.call(this.yy,Ft)&&(Y.yy[Ft]=this.yy[Ft]);E.setInput(r,Y.yy),Y.yy.lexer=E,Y.yy.parser=this,typeof E.yylloc>"u"&&(E.yylloc={});var Pt=E.yylloc;e.push(Pt);var be=E.options&&E.options.ranges;typeof Y.yy.parseError=="function"?this.parseError=Y.yy.parseError:this.parseError=Object.getPrototypeOf(this).parseError;function Se(B){x.length=x.length-2*B,S.length=S.length-B,e.length=e.length-B}o(Se,"popStack");function $t(){var B;return B=c.pop()||E.lex()||Jt,typeof B!="number"&&(B instanceof Array&&(c=B,B=c.pop()),B=l.symbols_[B]||B),B}o($t,"lex");for(var w,j,N,vt,rt={},Tt,X,te,qt;;){if(j=x[x.length-1],this.defaultActions[j]?N=this.defaultActions[j]:((w===null||typeof w>"u")&&(w=$t()),N=ut[j]&&ut[j][w]),typeof N>"u"||!N.length||!N[0]){var Ct="";qt=[];for(Tt in ut[j])this.terminals_[Tt]&&Tt>qe&&qt.push("'"+this.terminals_[Tt]+"'");E.showPosition?Ct="Parse error on line "+(yt+1)+`:
-`+E.showPosition()+`
-Expecting `+qt.join(", ")+", got '"+(this.terminals_[w]||w)+"'":Ct="Parse error on line "+(yt+1)+": Unexpected "+(w==Jt?"end of input":"'"+(this.terminals_[w]||w)+"'"),this.parseError(Ct,{text:E.match,token:this.terminals_[w]||w,line:E.yylineno,loc:Pt,expected:qt})}if(N[0]instanceof Array&&N.length>1)throw new Error("Parse Error: multiple actions possible at state: "+j+", token: "+w);switch(N[0]){case 1:x.push(w),S.push(E.yytext),e.push(E.yylloc),x.push(N[1]),w=null,Zt=E.yyleng,s=E.yytext,yt=E.yylineno,Pt=E.yylloc;break;case 2:if(X=this.productions_[N[1]][1],rt.$=S[S.length-X],rt._$={first_line:e[e.length-(X||1)].first_line,last_line:e[e.length-1].last_line,first_column:e[e.length-(X||1)].first_column,last_column:e[e.length-1].last_column},be&&(rt._$.range=[e[e.length-(X||1)].range[0],e[e.length-1].range[1]]),vt=this.performAction.apply(rt,[s,Zt,yt,Y.yy,N[1],S,e].concat(me)),typeof vt<"u")return vt;X&&(x=x.slice(0,-1*X*2),S=S.slice(0,-1*X),e=e.slice(0,-1*X)),x.push(this.productions_[N[1]][0]),S.push(rt.$),e.push(rt._$),te=ut[x[x.length-2]][x[x.length-1]],x.push(te);break;case 3:return!0}}return!0},"parse")},Te=(function(){var M={EOF:1,parseError:o(function(l,x){if(this.yy.parser)this.yy.parser.parseError(l,x);else throw new Error(l)},"parseError"),setInput:o(function(r,l){return this.yy=l||this.yy||{},this._input=r,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},"setInput"),input:o(function(){var r=this._input[0];this.yytext+=r,this.yyleng++,this.offset++,this.match+=r,this.matched+=r;var l=r.match(/(?:\r\n?|\n).*/g);return l?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),r},"input"),unput:o(function(r){var l=r.length,x=r.split(/(?:\r\n?|\n)/g);this._input=r+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-l),this.offset-=l;var c=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),x.length-1&&(this.yylineno-=x.length-1);var S=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:x?(x.length===c.length?this.yylloc.first_column:0)+c[c.length-x.length].length-x[0].length:this.yylloc.first_column-l},this.options.ranges&&(this.yylloc.range=[S[0],S[0]+this.yyleng-l]),this.yyleng=this.yytext.length,this},"unput"),more:o(function(){return this._more=!0,this},"more"),reject:o(function(){if(this.options.backtrack_lexer)this._backtrack=!0;else return this.parseError("Lexical error on line "+(this.yylineno+1)+`. You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).
-`+this.showPosition(),{text:"",token:null,line:this.yylineno});return this},"reject"),less:o(function(r){this.unput(this.match.slice(r))},"less"),pastInput:o(function(){var r=this.matched.substr(0,this.matched.length-this.match.length);return(r.length>20?"...":"")+r.substr(-20).replace(/\n/g,"")},"pastInput"),upcomingInput:o(function(){var r=this.match;return r.length<20&&(r+=this._input.substr(0,20-r.length)),(r.substr(0,20)+(r.length>20?"...":"")).replace(/\n/g,"")},"upcomingInput"),showPosition:o(function(){var r=this.pastInput(),l=new Array(r.length+1).join("-");return r+this.upcomingInput()+`
-`+l+"^"},"showPosition"),test_match:o(function(r,l){var x,c,S;if(this.options.backtrack_lexer&&(S={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(S.yylloc.range=this.yylloc.range.slice(0))),c=r[0].match(/(?:\r\n?|\n).*/g),c&&(this.yylineno+=c.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:c?c[c.length-1].length-c[c.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+r[0].length},this.yytext+=r[0],this.match+=r[0],this.matches=r,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(r[0].length),this.matched+=r[0],x=this.performAction.call(this,this.yy,this,l,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),x)return x;if(this._backtrack){for(var e in S)this[e]=S[e];return!1}return!1},"test_match"),next:o(function(){if(this.done)return this.EOF;this._input||(this.done=!0);var r,l,x,c;this._more||(this.yytext="",this.match="");for(var S=this._currentRules(),e=0;e<S.length;e++)if(x=this._input.match(this.rules[S[e]]),x&&(!l||x[0].length>l[0].length)){if(l=x,c=e,this.options.backtrack_lexer){if(r=this.test_match(x,S[e]),r!==!1)return r;if(this._backtrack){l=!1;continue}else return!1}else if(!this.options.flex)break}return l?(r=this.test_match(l,S[c]),r!==!1?r:!1):this._input===""?this.EOF:this.parseError("Lexical error on line "+(this.yylineno+1)+`. Unrecognized text.
-`+this.showPosition(),{text:"",token:null,line:this.yylineno})},"next"),lex:o(function(){var l=this.next();return l||this.lex()},"lex"),begin:o(function(l){this.conditionStack.push(l)},"begin"),popState:o(function(){var l=this.conditionStack.length-1;return l>0?this.conditionStack.pop():this.conditionStack[0]},"popState"),_currentRules:o(function(){return this.conditionStack.length&&this.conditionStack[this.conditionStack.length-1]?this.conditions[this.conditionStack[this.conditionStack.length-1]].rules:this.conditions.INITIAL.rules},"_currentRules"),topState:o(function(l){return l=this.conditionStack.length-1-Math.abs(l||0),l>=0?this.conditionStack[l]:"INITIAL"},"topState"),pushState:o(function(l){this.begin(l)},"pushState"),stateStackSize:o(function(){return this.conditionStack.length},"stateStackSize"),options:{"case-insensitive":!0},performAction:o(function(l,x,c,S){switch(c){case 0:break;case 1:break;case 2:return 55;case 3:break;case 4:return this.begin("title"),35;case 5:return this.popState(),"title_value";case 6:return this.begin("acc_title"),37;case 7:return this.popState(),"acc_title_value";case 8:return this.begin("acc_descr"),39;case 9:return this.popState(),"acc_descr_value";case 10:this.begin("acc_descr_multiline");break;case 11:this.popState();break;case 12:return"acc_descr_multiline_value";case 13:return 48;case 14:return 50;case 15:return 49;case 16:return 51;case 17:return 52;case 18:return 53;case 19:return 54;case 20:return 25;case 21:this.begin("md_string");break;case 22:return"MD_STR";case 23:this.popState();break;case 24:this.begin("string");break;case 25:this.popState();break;case 26:return"STR";case 27:this.begin("class_name");break;case 28:return this.popState(),47;case 29:return this.begin("point_start"),44;case 30:return this.begin("point_x"),45;case 31:this.popState();break;case 32:this.popState(),this.begin("point_y");break;case 33:return this.popState(),46;case 34:return 28;case 35:return 4;case 36:return 11;case 37:return 64;case 38:return 10;case 39:return 65;case 40:return 65;case 41:return 14;case 42:return 13;case 43:return 67;case 44:return 66;case 45:return 12;case 46:return 8;case 47:return 5;case 48:return 18;case 49:return 56;case 50:return 63;case 51:return 57}},"anonymous"),rules:[/^(?:%%(?!\{)[^\n]*)/i,/^(?:[^\}]%%[^\n]*)/i,/^(?:[\n\r]+)/i,/^(?:%%[^\n]*)/i,/^(?:title\b)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accTitle\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*\{\s*)/i,/^(?:[\}])/i,/^(?:[^\}]*)/i,/^(?: *x-axis *)/i,/^(?: *y-axis *)/i,/^(?: *--+> *)/i,/^(?: *quadrant-1 *)/i,/^(?: *quadrant-2 *)/i,/^(?: *quadrant-3 *)/i,/^(?: *quadrant-4 *)/i,/^(?:classDef\b)/i,/^(?:["][`])/i,/^(?:[^`"]+)/i,/^(?:[`]["])/i,/^(?:["])/i,/^(?:["])/i,/^(?:[^"]*)/i,/^(?::::)/i,/^(?:^\w+)/i,/^(?:\s*:\s*\[\s*)/i,/^(?:(1)|(0(.\d+)?))/i,/^(?:\s*\] *)/i,/^(?:\s*,\s*)/i,/^(?:(1)|(0(.\d+)?))/i,/^(?: *quadrantChart *)/i,/^(?:[A-Za-z]+)/i,/^(?::)/i,/^(?:\+)/i,/^(?:,)/i,/^(?:=)/i,/^(?:=)/i,/^(?:\*)/i,/^(?:#)/i,/^(?:[\_])/i,/^(?:\.)/i,/^(?:&)/i,/^(?:-)/i,/^(?:[0-9]+)/i,/^(?:\s)/i,/^(?:;)/i,/^(?:[!"#$%&'*+,-.`?\\_/])/i,/^(?:$)/i],conditions:{class_name:{rules:[28],inclusive:!1},point_y:{rules:[33],inclusive:!1},point_x:{rules:[32],inclusive:!1},point_start:{rules:[30,31],inclusive:!1},acc_descr_multiline:{rules:[11,12],inclusive:!1},acc_descr:{rules:[9],inclusive:!1},acc_title:{rules:[7],inclusive:!1},title:{rules:[5],inclusive:!1},md_string:{rules:[22,23],inclusive:!1},string:{rules:[25,26],inclusive:!1},INITIAL:{rules:[0,1,2,3,4,6,8,10,13,14,15,16,17,18,19,20,21,24,27,29,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51],inclusive:!0}}};return M})();kt.lexer=Te;function pt(){this.yy={}}return o(pt,"Parser"),pt.prototype=kt,kt.Parser=pt,new pt})();Et.parser=Et;var De=Et,V=Le(),ot,ze=(ot=class{constructor(){this.classes=new Map,this.config=this.getDefaultConfig(),this.themeConfig=this.getDefaultThemeConfig(),this.data=this.getDefaultData()}getDefaultData(){return{titleText:"",quadrant1Text:"",quadrant2Text:"",quadrant3Text:"",quadrant4Text:"",xAxisLeftText:"",xAxisRightText:"",yAxisBottomText:"",yAxisTopText:"",points:[]}}getDefaultConfig(){return{showXAxis:!0,showYAxis:!0,showTitle:!0,chartHeight:D.quadrantChart?.chartWidth||500,chartWidth:D.quadrantChart?.chartHeight||500,titlePadding:D.quadrantChart?.titlePadding||10,titleFontSize:D.quadrantChart?.titleFontSize||20,quadrantPadding:D.quadrantChart?.quadrantPadding||5,xAxisLabelPadding:D.quadrantChart?.xAxisLabelPadding||5,yAxisLabelPadding:D.quadrantChart?.yAxisLabelPadding||5,xAxisLabelFontSize:D.quadrantChart?.xAxisLabelFontSize||16,yAxisLabelFontSize:D.quadrantChart?.yAxisLabelFontSize||16,quadrantLabelFontSize:D.quadrantChart?.quadrantLabelFontSize||16,quadrantTextTopPadding:D.quadrantChart?.quadrantTextTopPadding||5,pointTextPadding:D.quadrantChart?.pointTextPadding||5,pointLabelFontSize:D.quadrantChart?.pointLabelFontSize||12,pointRadius:D.quadrantChart?.pointRadius||5,xAxisPosition:D.quadrantChart?.xAxisPosition||"top",yAxisPosition:D.quadrantChart?.yAxisPosition||"left",quadrantInternalBorderStrokeWidth:D.quadrantChart?.quadrantInternalBorderStrokeWidth||1,quadrantExternalBorderStrokeWidth:D.quadrantChart?.quadrantExternalBorderStrokeWidth||2}}getDefaultThemeConfig(){return{quadrant1Fill:V.quadrant1Fill,quadrant2Fill:V.quadrant2Fill,quadrant3Fill:V.quadrant3Fill,quadrant4Fill:V.quadrant4Fill,quadrant1TextFill:V.quadrant1TextFill,quadrant2TextFill:V.quadrant2TextFill,quadrant3TextFill:V.quadrant3TextFill,quadrant4TextFill:V.quadrant4TextFill,quadrantPointFill:V.quadrantPointFill,quadrantPointTextFill:V.quadrantPointTextFill,quadrantXAxisTextFill:V.quadrantXAxisTextFill,quadrantYAxisTextFill:V.quadrantYAxisTextFill,quadrantTitleFill:V.quadrantTitleFill,quadrantInternalBorderStrokeFill:V.quadrantInternalBorderStrokeFill,quadrantExternalBorderStrokeFill:V.quadrantExternalBorderStrokeFill}}clear(){this.config=this.getDefaultConfig(),this.themeConfig=this.getDefaultThemeConfig(),this.data=this.getDefaultData(),this.classes=new Map,bt.info("clear called")}setData(n){this.data={...this.data,...n}}addPoints(n){this.data.points=[...n,...this.data.points]}addClass(n,f){this.classes.set(n,f)}setConfig(n){bt.trace("setConfig called with: ",n),this.config={...this.config,...n}}setThemeConfig(n){bt.trace("setThemeConfig called with: ",n),this.themeConfig={...this.themeConfig,...n}}calculateSpace(n,f,d,h){const p=this.config.xAxisLabelPadding*2+this.config.xAxisLabelFontSize,y={top:n==="top"&&f?p:0,bottom:n==="bottom"&&f?p:0},_=this.config.yAxisLabelPadding*2+this.config.yAxisLabelFontSize,a={left:this.config.yAxisPosition==="left"&&d?_:0,right:this.config.yAxisPosition==="right"&&d?_:0},A=this.config.titleFontSize+this.config.titlePadding*2,u={top:h?A:0},T=this.config.quadrantPadding+a.left,q=this.config.quadrantPadding+y.top+u.top,m=this.config.chartWidth-this.config.quadrantPadding*2-a.left-a.right,b=this.config.chartHeight-this.config.quadrantPadding*2-y.top-y.bottom-u.top,g=m/2,G=b/2;return{xAxisSpace:y,yAxisSpace:a,titleSpace:u,quadrantSpace:{quadrantLeft:T,quadrantTop:q,quadrantWidth:m,quadrantHalfWidth:g,quadrantHeight:b,quadrantHalfHeight:G}}}getAxisLabels(n,f,d,h){const{quadrantSpace:p,titleSpace:y}=h,{quadrantHalfHeight:_,quadrantHeight:a,quadrantLeft:A,quadrantHalfWidth:u,quadrantTop:T,quadrantWidth:q}=p,m=!!this.data.xAxisRightText,b=!!this.data.yAxisTopText,g=[];return this.data.xAxisLeftText&&f&&g.push({text:this.data.xAxisLeftText,fill:this.themeConfig.quadrantXAxisTextFill,x:A+(m?u/2:0),y:n==="top"?this.config.xAxisLabelPadding+y.top:this.config.xAxisLabelPadding+T+a+this.config.quadrantPadding,fontSize:this.config.xAxisLabelFontSize,verticalPos:m?"center":"left",horizontalPos:"top",rotation:0}),this.data.xAxisRightText&&f&&g.push({text:this.data.xAxisRightText,fill:this.themeConfig.quadrantXAxisTextFill,x:A+u+(m?u/2:0),y:n==="top"?this.config.xAxisLabelPadding+y.top:this.config.xAxisLabelPadding+T+a+this.config.quadrantPadding,fontSize:this.config.xAxisLabelFontSize,verticalPos:m?"center":"left",horizontalPos:"top",rotation:0}),this.data.yAxisBottomText&&d&&g.push({text:this.data.yAxisBottomText,fill:this.themeConfig.quadrantYAxisTextFill,x:this.config.yAxisPosition==="left"?this.config.yAxisLabelPadding:this.config.yAxisLabelPadding+A+q+this.config.quadrantPadding,y:T+a-(b?_/2:0),fontSize:this.config.yAxisLabelFontSize,verticalPos:b?"center":"left",horizontalPos:"top",rotation:-90}),this.data.yAxisTopText&&d&&g.push({text:this.data.yAxisTopText,fill:this.themeConfig.quadrantYAxisTextFill,x:this.config.yAxisPosition==="left"?this.config.yAxisLabelPadding:this.config.yAxisLabelPadding+A+q+this.config.quadrantPadding,y:T+_-(b?_/2:0),fontSize:this.config.yAxisLabelFontSize,verticalPos:b?"center":"left",horizontalPos:"top",rotation:-90}),g}getQuadrants(n){const{quadrantSpace:f}=n,{quadrantHalfHeight:d,quadrantLeft:h,quadrantHalfWidth:p,quadrantTop:y}=f,_=[{text:{text:this.data.quadrant1Text,fill:this.themeConfig.quadrant1TextFill,x:0,y:0,fontSize:this.config.quadrantLabelFontSize,verticalPos:"center",horizontalPos:"middle",rotation:0},x:h+p,y,width:p,height:d,fill:this.themeConfig.quadrant1Fill},{text:{text:this.data.quadrant2Text,fill:this.themeConfig.quadrant2TextFill,x:0,y:0,fontSize:this.config.quadrantLabelFontSize,verticalPos:"center",horizontalPos:"middle",rotation:0},x:h,y,width:p,height:d,fill:this.themeConfig.quadrant2Fill},{text:{text:this.data.quadrant3Text,fill:this.themeConfig.quadrant3TextFill,x:0,y:0,fontSize:this.config.quadrantLabelFontSize,verticalPos:"center",horizontalPos:"middle",rotation:0},x:h,y:y+d,width:p,height:d,fill:this.themeConfig.quadrant3Fill},{text:{text:this.data.quadrant4Text,fill:this.themeConfig.quadrant4TextFill,x:0,y:0,fontSize:this.config.quadrantLabelFontSize,verticalPos:"center",horizontalPos:"middle",rotation:0},x:h+p,y:y+d,width:p,height:d,fill:this.themeConfig.quadrant4Fill}];for(const a of _)a.text.x=a.x+a.width/2,this.data.points.length===0?(a.text.y=a.y+a.height/2,a.text.horizontalPos="middle"):(a.text.y=a.y+this.config.quadrantTextTopPadding,a.text.horizontalPos="top");return _}getQuadrantPoints(n){const{quadrantSpace:f}=n,{quadrantHeight:d,quadrantLeft:h,quadrantTop:p,quadrantWidth:y}=f,_=ee().domain([0,1]).range([h,y+h]),a=ee().domain([0,1]).range([d+p,p]);return this.data.points.map(u=>{const T=this.classes.get(u.className);return T&&(u={...T,...u}),{x:_(u.x),y:a(u.y),fill:u.color??this.themeConfig.quadrantPointFill,radius:u.radius??this.config.pointRadius,text:{text:u.text,fill:this.themeConfig.quadrantPointTextFill,x:_(u.x),y:a(u.y)+this.config.pointTextPadding,verticalPos:"center",horizontalPos:"top",fontSize:this.config.pointLabelFontSize,rotation:0},strokeColor:u.strokeColor??this.themeConfig.quadrantPointFill,strokeWidth:u.strokeWidth??"0px"}})}getBorders(n){const f=this.config.quadrantExternalBorderStrokeWidth/2,{quadrantSpace:d}=n,{quadrantHalfHeight:h,quadrantHeight:p,quadrantLeft:y,quadrantHalfWidth:_,quadrantTop:a,quadrantWidth:A}=d;return[{strokeFill:this.themeConfig.quadrantExternalBorderStrokeFill,strokeWidth:this.config.quadrantExternalBorderStrokeWidth,x1:y-f,y1:a,x2:y+A+f,y2:a},{strokeFill:this.themeConfig.quadrantExternalBorderStrokeFill,strokeWidth:this.config.quadrantExternalBorderStrokeWidth,x1:y+A,y1:a+f,x2:y+A,y2:a+p-f},{strokeFill:this.themeConfig.quadrantExternalBorderStrokeFill,strokeWidth:this.config.quadrantExternalBorderStrokeWidth,x1:y-f,y1:a+p,x2:y+A+f,y2:a+p},{strokeFill:this.themeConfig.quadrantExternalBorderStrokeFill,strokeWidth:this.config.quadrantExternalBorderStrokeWidth,x1:y,y1:a+f,x2:y,y2:a+p-f},{strokeFill:this.themeConfig.quadrantInternalBorderStrokeFill,strokeWidth:this.config.quadrantInternalBorderStrokeWidth,x1:y+_,y1:a+f,x2:y+_,y2:a+p-f},{strokeFill:this.themeConfig.quadrantInternalBorderStrokeFill,strokeWidth:this.config.quadrantInternalBorderStrokeWidth,x1:y+f,y1:a+h,x2:y+A-f,y2:a+h}]}getTitle(n){if(n)return{text:this.data.titleText,fill:this.themeConfig.quadrantTitleFill,fontSize:this.config.titleFontSize,horizontalPos:"top",verticalPos:"center",rotation:0,y:this.config.titlePadding,x:this.config.chartWidth/2}}build(){const n=this.config.showXAxis&&!!(this.data.xAxisLeftText||this.data.xAxisRightText),f=this.config.showYAxis&&!!(this.data.yAxisTopText||this.data.yAxisBottomText),d=this.config.showTitle&&!!this.data.titleText,h=this.data.points.length>0?"bottom":this.config.xAxisPosition,p=this.calculateSpace(h,n,f,d);return{points:this.getQuadrantPoints(p),quadrants:this.getQuadrants(p),axisLabels:this.getAxisLabels(h,n,f,p),borderLines:this.getBorders(p),title:this.getTitle(d)}}},o(ot,"QuadrantBuilder"),ot),lt,mt=(lt=class extends Error{constructor(n,f,d){super(`value for ${n} ${f} is invalid, please use a valid ${d}`),this.name="InvalidStyleError"}},o(lt,"InvalidStyleError"),lt);function Dt(t){return!/^#?([\dA-Fa-f]{6}|[\dA-Fa-f]{3})$/.test(t)}o(Dt,"validateHexCode");function ae(t){return!/^\d+$/.test(t)}o(ae,"validateNumber");function ne(t){return!/^\d+px$/.test(t)}o(ne,"validateSizeInPixels");var Ve=zt();function Q(t){return Ee(t.trim(),Ve)}o(Q,"textSanitizer");var z=new ze;function se(t){z.setData({quadrant1Text:Q(t.text)})}o(se,"setQuadrant1Text");function re(t){z.setData({quadrant2Text:Q(t.text)})}o(re,"setQuadrant2Text");function oe(t){z.setData({quadrant3Text:Q(t.text)})}o(oe,"setQuadrant3Text");function le(t){z.setData({quadrant4Text:Q(t.text)})}o(le,"setQuadrant4Text");function he(t){z.setData({xAxisLeftText:Q(t.text)})}o(he,"setXAxisLeftText");function ce(t){z.setData({xAxisRightText:Q(t.text)})}o(ce,"setXAxisRightText");function de(t){z.setData({yAxisTopText:Q(t.text)})}o(de,"setYAxisTopText");function ue(t){z.setData({yAxisBottomText:Q(t.text)})}o(ue,"setYAxisBottomText");function St(t){const n={};for(const f of t){const[d,h]=f.trim().split(/\s*:\s*/);if(d==="radius"){if(ae(h))throw new mt(d,h,"number");n.radius=parseInt(h)}else if(d==="color"){if(Dt(h))throw new mt(d,h,"hex code");n.color=h}else if(d==="stroke-color"){if(Dt(h))throw new mt(d,h,"hex code");n.strokeColor=h}else if(d==="stroke-width"){if(ne(h))throw new mt(d,h,"number of pixels (eg. 10px)");n.strokeWidth=h}else throw new Error(`style named ${d} is not supported.`)}return n}o(St,"parseStyles");function xe(t,n,f,d,h){const p=St(h);z.addPoints([{x:f,y:d,text:Q(t.text),className:n,...p}])}o(xe,"addPoint");function fe(t,n){z.addClass(t,St(n))}o(fe,"addClass");function ge(t){z.setConfig({chartWidth:t})}o(ge,"setWidth");function pe(t){z.setConfig({chartHeight:t})}o(pe,"setHeight");function ye(){const t=zt(),{themeVariables:n,quadrantChart:f}=t;return f&&z.setConfig(f),z.setThemeConfig({quadrant1Fill:n.quadrant1Fill,quadrant2Fill:n.quadrant2Fill,quadrant3Fill:n.quadrant3Fill,quadrant4Fill:n.quadrant4Fill,quadrant1TextFill:n.quadrant1TextFill,quadrant2TextFill:n.quadrant2TextFill,quadrant3TextFill:n.quadrant3TextFill,quadrant4TextFill:n.quadrant4TextFill,quadrantPointFill:n.quadrantPointFill,quadrantPointTextFill:n.quadrantPointTextFill,quadrantXAxisTextFill:n.quadrantXAxisTextFill,quadrantYAxisTextFill:n.quadrantYAxisTextFill,quadrantExternalBorderStrokeFill:n.quadrantExternalBorderStrokeFill,quadrantInternalBorderStrokeFill:n.quadrantInternalBorderStrokeFill,quadrantTitleFill:n.quadrantTitleFill}),z.setData({titleText:ie()}),z.build()}o(ye,"getQuadrantData");var Ie=o(function(){z.clear(),Ce()},"clear"),we={setWidth:ge,setHeight:pe,setQuadrant1Text:se,setQuadrant2Text:re,setQuadrant3Text:oe,setQuadrant4Text:le,setXAxisLeftText:he,setXAxisRightText:ce,setYAxisTopText:de,setYAxisBottomText:ue,parseStyles:St,addPoint:xe,addClass:fe,getQuadrantData:ye,clear:Ie,setAccTitle:Pe,getAccTitle:Fe,setDiagramTitle:ke,getDiagramTitle:ie,getAccDescription:Ae,setAccDescription:_e},Be=o((t,n,f,d)=>{function h(i){return i==="top"?"hanging":"middle"}o(h,"getDominantBaseLine");function p(i){return i==="left"?"start":"middle"}o(p,"getTextAnchor");function y(i){return`translate(${i.x}, ${i.y}) rotate(${i.rotation||0})`}o(y,"getTransformation");const _=zt();bt.debug(`Rendering quadrant chart
-`+t);const a=_.securityLevel;let A;a==="sandbox"&&(A=Lt("#i"+n));const T=(a==="sandbox"?Lt(A.nodes()[0].contentDocument.body):Lt("body")).select(`[id="${n}"]`),q=T.append("g").attr("class","main"),m=_.quadrantChart?.chartWidth??500,b=_.quadrantChart?.chartHeight??500;ve(T,b,m,_.quadrantChart?.useMaxWidth??!0),T.attr("viewBox","0 0 "+m+" "+b),d.db.setHeight(b),d.db.setWidth(m);const g=d.db.getQuadrantData(),G=q.append("g").attr("class","quadrants"),ht=q.append("g").attr("class","border"),xt=q.append("g").attr("class","data-points"),ft=q.append("g").attr("class","labels"),gt=q.append("g").attr("class","title");g.title&&gt.append("text").attr("x",0).attr("y",0).attr("fill",g.title.fill).attr("font-size",g.title.fontSize).attr("dominant-baseline",h(g.title.horizontalPos)).attr("text-anchor",p(g.title.verticalPos)).attr("transform",y(g.title)).text(g.title.text),g.borderLines&&ht.selectAll("line").data(g.borderLines).enter().append("line").attr("x1",i=>i.x1).attr("y1",i=>i.y1).attr("x2",i=>i.x2).attr("y2",i=>i.y2).style("stroke",i=>i.strokeFill).style("stroke-width",i=>i.strokeWidth);const ct=G.selectAll("g.quadrant").data(g.quadrants).enter().append("g").attr("class","quadrant");ct.append("rect").attr("x",i=>i.x).attr("y",i=>i.y).attr("width",i=>i.width).attr("height",i=>i.height).attr("fill",i=>i.fill),ct.append("text").attr("x",0).attr("y",0).attr("fill",i=>i.text.fill).attr("font-size",i=>i.text.fontSize).attr("dominant-baseline",i=>h(i.text.horizontalPos)).attr("text-anchor",i=>p(i.text.verticalPos)).attr("transform",i=>y(i.text)).text(i=>i.text.text),ft.selectAll("g.label").data(g.axisLabels).enter().append("g").attr("class","label").append("text").attr("x",0).attr("y",0).text(i=>i.text).attr("fill",i=>i.fill).attr("font-size",i=>i.fontSize).attr("dominant-baseline",i=>h(i.horizontalPos)).attr("text-anchor",i=>p(i.verticalPos)).attr("transform",i=>y(i));const dt=xt.selectAll("g.data-point").data(g.points).enter().append("g").attr("class","data-point");dt.append("circle").attr("cx",i=>i.x).attr("cy",i=>i.y).attr("r",i=>i.radius).attr("fill",i=>i.fill).attr("stroke",i=>i.strokeColor).attr("stroke-width",i=>i.strokeWidth),dt.append("text").attr("x",0).attr("y",0).text(i=>i.text.text).attr("fill",i=>i.text.fill).attr("font-size",i=>i.text.fontSize).attr("dominant-baseline",i=>h(i.text.horizontalPos)).attr("text-anchor",i=>p(i.text.verticalPos)).attr("transform",i=>y(i.text))},"draw"),Re={draw:Be},Oe={parser:De,db:we,renderer:Re,styles:o(()=>"","styles")};export{Oe as diagram};
diff --git a/docs/dist/assets/requirementDiagram-UZGBJVZJ-CBieYl8c.js b/docs/dist/assets/requirementDiagram-UZGBJVZJ-CBieYl8c.js
deleted file mode 100644
index e6638946..00000000
--- a/docs/dist/assets/requirementDiagram-UZGBJVZJ-CBieYl8c.js
+++ /dev/null
@@ -1,64 +0,0 @@
-import{g as Ge}from"./chunk-55IACEB6-BE1gdz1f.js";import{s as ze}from"./chunk-QN33PNHL-1s4FuBGd.js";import{_ as f,b as Xe,a as Je,s as Ze,g as et,p as tt,q as st,c as Ne,l as qe,y as it,B as rt,o as nt,r as at,u as lt}from"./index-BxX29htg.js";var Ae=(function(){var e=f(function(P,i,n,c){for(n=n||{},c=P.length;c--;n[P[c]]=i);return n},"o"),l=[1,3],u=[1,4],h=[1,5],r=[1,6],o=[5,6,8,9,11,13,21,22,23,24,41,42,43,44,45,46,54,72,74,77,89,90],m=[1,22],y=[2,7],_=[1,26],b=[1,27],N=[1,28],q=[1,29],A=[1,33],C=[1,34],V=[1,35],v=[1,36],x=[1,37],L=[1,38],D=[1,24],O=[1,31],w=[1,32],M=[1,30],p=[1,39],R=[1,40],d=[5,8,9,11,13,21,22,23,24,41,42,43,44,45,46,54,72,74,77,89,90],$=[1,61],X=[89,90],Ce=[5,8,9,11,13,21,22,23,24,27,29,41,42,43,44,45,46,54,61,63,72,74,75,76,77,80,81,82,83,84,85,86,87,88,89,90],de=[27,29],Ve=[1,70],ve=[1,71],xe=[1,72],Le=[1,73],De=[1,74],Oe=[1,75],we=[1,76],ee=[1,83],U=[1,80],te=[1,84],se=[1,85],ie=[1,86],re=[1,87],ne=[1,88],ae=[1,89],le=[1,90],ce=[1,91],oe=[1,92],pe=[5,8,9,11,13,21,22,23,24,27,41,42,43,44,45,46,54,72,74,75,76,77,80,81,82,83,84,85,86,87,88,89,90],Y=[63,64],Me=[1,101],Fe=[5,8,9,11,13,21,22,23,24,41,42,43,44,45,46,54,72,74,76,77,89,90],T=[5,8,9,11,13,21,22,23,24,41,42,43,44,45,46,54,72,74,75,76,77,80,81,82,83,84,85,86,87,88,89,90],B=[1,110],Q=[1,106],H=[1,107],K=[1,108],W=[1,109],j=[1,111],he=[1,116],ue=[1,117],fe=[1,114],me=[1,115],Se={trace:f(function(){},"trace"),yy:{},symbols_:{error:2,start:3,directive:4,NEWLINE:5,RD:6,diagram:7,EOF:8,acc_title:9,acc_title_value:10,acc_descr:11,acc_descr_value:12,acc_descr_multiline_value:13,requirementDef:14,elementDef:15,relationshipDef:16,direction:17,styleStatement:18,classDefStatement:19,classStatement:20,direction_tb:21,direction_bt:22,direction_rl:23,direction_lr:24,requirementType:25,requirementName:26,STRUCT_START:27,requirementBody:28,STYLE_SEPARATOR:29,idList:30,ID:31,COLONSEP:32,id:33,TEXT:34,text:35,RISK:36,riskLevel:37,VERIFYMTHD:38,verifyType:39,STRUCT_STOP:40,REQUIREMENT:41,FUNCTIONAL_REQUIREMENT:42,INTERFACE_REQUIREMENT:43,PERFORMANCE_REQUIREMENT:44,PHYSICAL_REQUIREMENT:45,DESIGN_CONSTRAINT:46,LOW_RISK:47,MED_RISK:48,HIGH_RISK:49,VERIFY_ANALYSIS:50,VERIFY_DEMONSTRATION:51,VERIFY_INSPECTION:52,VERIFY_TEST:53,ELEMENT:54,elementName:55,elementBody:56,TYPE:57,type:58,DOCREF:59,ref:60,END_ARROW_L:61,relationship:62,LINE:63,END_ARROW_R:64,CONTAINS:65,COPIES:66,DERIVES:67,SATISFIES:68,VERIFIES:69,REFINES:70,TRACES:71,CLASSDEF:72,stylesOpt:73,CLASS:74,ALPHA:75,COMMA:76,STYLE:77,style:78,styleComponent:79,NUM:80,COLON:81,UNIT:82,SPACE:83,BRKT:84,PCT:85,MINUS:86,LABEL:87,SEMICOLON:88,unqString:89,qString:90,$accept:0,$end:1},terminals_:{2:"error",5:"NEWLINE",6:"RD",8:"EOF",9:"acc_title",10:"acc_title_value",11:"acc_descr",12:"acc_descr_value",13:"acc_descr_multiline_value",21:"direction_tb",22:"direction_bt",23:"direction_rl",24:"direction_lr",27:"STRUCT_START",29:"STYLE_SEPARATOR",31:"ID",32:"COLONSEP",34:"TEXT",36:"RISK",38:"VERIFYMTHD",40:"STRUCT_STOP",41:"REQUIREMENT",42:"FUNCTIONAL_REQUIREMENT",43:"INTERFACE_REQUIREMENT",44:"PERFORMANCE_REQUIREMENT",45:"PHYSICAL_REQUIREMENT",46:"DESIGN_CONSTRAINT",47:"LOW_RISK",48:"MED_RISK",49:"HIGH_RISK",50:"VERIFY_ANALYSIS",51:"VERIFY_DEMONSTRATION",52:"VERIFY_INSPECTION",53:"VERIFY_TEST",54:"ELEMENT",57:"TYPE",59:"DOCREF",61:"END_ARROW_L",63:"LINE",64:"END_ARROW_R",65:"CONTAINS",66:"COPIES",67:"DERIVES",68:"SATISFIES",69:"VERIFIES",70:"REFINES",71:"TRACES",72:"CLASSDEF",74:"CLASS",75:"ALPHA",76:"COMMA",77:"STYLE",80:"NUM",81:"COLON",82:"UNIT",83:"SPACE",84:"BRKT",85:"PCT",86:"MINUS",87:"LABEL",88:"SEMICOLON",89:"unqString",90:"qString"},productions_:[0,[3,3],[3,2],[3,4],[4,2],[4,2],[4,1],[7,0],[7,2],[7,2],[7,2],[7,2],[7,2],[7,2],[7,2],[7,2],[7,2],[17,1],[17,1],[17,1],[17,1],[14,5],[14,7],[28,5],[28,5],[28,5],[28,5],[28,2],[28,1],[25,1],[25,1],[25,1],[25,1],[25,1],[25,1],[37,1],[37,1],[37,1],[39,1],[39,1],[39,1],[39,1],[15,5],[15,7],[56,5],[56,5],[56,2],[56,1],[16,5],[16,5],[62,1],[62,1],[62,1],[62,1],[62,1],[62,1],[62,1],[19,3],[20,3],[20,3],[30,1],[30,3],[30,1],[30,3],[18,3],[73,1],[73,3],[78,1],[78,2],[79,1],[79,1],[79,1],[79,1],[79,1],[79,1],[79,1],[79,1],[79,1],[79,1],[26,1],[26,1],[33,1],[33,1],[35,1],[35,1],[55,1],[55,1],[58,1],[58,1],[60,1],[60,1]],performAction:f(function(i,n,c,s,E,t,Ee){var a=t.length-1;switch(E){case 4:this.$=t[a].trim(),s.setAccTitle(this.$);break;case 5:case 6:this.$=t[a].trim(),s.setAccDescription(this.$);break;case 7:this.$=[];break;case 17:s.setDirection("TB");break;case 18:s.setDirection("BT");break;case 19:s.setDirection("RL");break;case 20:s.setDirection("LR");break;case 21:s.addRequirement(t[a-3],t[a-4]);break;case 22:s.addRequirement(t[a-5],t[a-6]),s.setClass([t[a-5]],t[a-3]);break;case 23:s.setNewReqId(t[a-2]);break;case 24:s.setNewReqText(t[a-2]);break;case 25:s.setNewReqRisk(t[a-2]);break;case 26:s.setNewReqVerifyMethod(t[a-2]);break;case 29:this.$=s.RequirementType.REQUIREMENT;break;case 30:this.$=s.RequirementType.FUNCTIONAL_REQUIREMENT;break;case 31:this.$=s.RequirementType.INTERFACE_REQUIREMENT;break;case 32:this.$=s.RequirementType.PERFORMANCE_REQUIREMENT;break;case 33:this.$=s.RequirementType.PHYSICAL_REQUIREMENT;break;case 34:this.$=s.RequirementType.DESIGN_CONSTRAINT;break;case 35:this.$=s.RiskLevel.LOW_RISK;break;case 36:this.$=s.RiskLevel.MED_RISK;break;case 37:this.$=s.RiskLevel.HIGH_RISK;break;case 38:this.$=s.VerifyType.VERIFY_ANALYSIS;break;case 39:this.$=s.VerifyType.VERIFY_DEMONSTRATION;break;case 40:this.$=s.VerifyType.VERIFY_INSPECTION;break;case 41:this.$=s.VerifyType.VERIFY_TEST;break;case 42:s.addElement(t[a-3]);break;case 43:s.addElement(t[a-5]),s.setClass([t[a-5]],t[a-3]);break;case 44:s.setNewElementType(t[a-2]);break;case 45:s.setNewElementDocRef(t[a-2]);break;case 48:s.addRelationship(t[a-2],t[a],t[a-4]);break;case 49:s.addRelationship(t[a-2],t[a-4],t[a]);break;case 50:this.$=s.Relationships.CONTAINS;break;case 51:this.$=s.Relationships.COPIES;break;case 52:this.$=s.Relationships.DERIVES;break;case 53:this.$=s.Relationships.SATISFIES;break;case 54:this.$=s.Relationships.VERIFIES;break;case 55:this.$=s.Relationships.REFINES;break;case 56:this.$=s.Relationships.TRACES;break;case 57:this.$=t[a-2],s.defineClass(t[a-1],t[a]);break;case 58:s.setClass(t[a-1],t[a]);break;case 59:s.setClass([t[a-2]],t[a]);break;case 60:case 62:this.$=[t[a]];break;case 61:case 63:this.$=t[a-2].concat([t[a]]);break;case 64:this.$=t[a-2],s.setCssStyle(t[a-1],t[a]);break;case 65:this.$=[t[a]];break;case 66:t[a-2].push(t[a]),this.$=t[a-2];break;case 68:this.$=t[a-1]+t[a];break}},"anonymous"),table:[{3:1,4:2,6:l,9:u,11:h,13:r},{1:[3]},{3:8,4:2,5:[1,7],6:l,9:u,11:h,13:r},{5:[1,9]},{10:[1,10]},{12:[1,11]},e(o,[2,6]),{3:12,4:2,6:l,9:u,11:h,13:r},{1:[2,2]},{4:17,5:m,7:13,8:y,9:u,11:h,13:r,14:14,15:15,16:16,17:18,18:19,19:20,20:21,21:_,22:b,23:N,24:q,25:23,33:25,41:A,42:C,43:V,44:v,45:x,46:L,54:D,72:O,74:w,77:M,89:p,90:R},e(o,[2,4]),e(o,[2,5]),{1:[2,1]},{8:[1,41]},{4:17,5:m,7:42,8:y,9:u,11:h,13:r,14:14,15:15,16:16,17:18,18:19,19:20,20:21,21:_,22:b,23:N,24:q,25:23,33:25,41:A,42:C,43:V,44:v,45:x,46:L,54:D,72:O,74:w,77:M,89:p,90:R},{4:17,5:m,7:43,8:y,9:u,11:h,13:r,14:14,15:15,16:16,17:18,18:19,19:20,20:21,21:_,22:b,23:N,24:q,25:23,33:25,41:A,42:C,43:V,44:v,45:x,46:L,54:D,72:O,74:w,77:M,89:p,90:R},{4:17,5:m,7:44,8:y,9:u,11:h,13:r,14:14,15:15,16:16,17:18,18:19,19:20,20:21,21:_,22:b,23:N,24:q,25:23,33:25,41:A,42:C,43:V,44:v,45:x,46:L,54:D,72:O,74:w,77:M,89:p,90:R},{4:17,5:m,7:45,8:y,9:u,11:h,13:r,14:14,15:15,16:16,17:18,18:19,19:20,20:21,21:_,22:b,23:N,24:q,25:23,33:25,41:A,42:C,43:V,44:v,45:x,46:L,54:D,72:O,74:w,77:M,89:p,90:R},{4:17,5:m,7:46,8:y,9:u,11:h,13:r,14:14,15:15,16:16,17:18,18:19,19:20,20:21,21:_,22:b,23:N,24:q,25:23,33:25,41:A,42:C,43:V,44:v,45:x,46:L,54:D,72:O,74:w,77:M,89:p,90:R},{4:17,5:m,7:47,8:y,9:u,11:h,13:r,14:14,15:15,16:16,17:18,18:19,19:20,20:21,21:_,22:b,23:N,24:q,25:23,33:25,41:A,42:C,43:V,44:v,45:x,46:L,54:D,72:O,74:w,77:M,89:p,90:R},{4:17,5:m,7:48,8:y,9:u,11:h,13:r,14:14,15:15,16:16,17:18,18:19,19:20,20:21,21:_,22:b,23:N,24:q,25:23,33:25,41:A,42:C,43:V,44:v,45:x,46:L,54:D,72:O,74:w,77:M,89:p,90:R},{4:17,5:m,7:49,8:y,9:u,11:h,13:r,14:14,15:15,16:16,17:18,18:19,19:20,20:21,21:_,22:b,23:N,24:q,25:23,33:25,41:A,42:C,43:V,44:v,45:x,46:L,54:D,72:O,74:w,77:M,89:p,90:R},{4:17,5:m,7:50,8:y,9:u,11:h,13:r,14:14,15:15,16:16,17:18,18:19,19:20,20:21,21:_,22:b,23:N,24:q,25:23,33:25,41:A,42:C,43:V,44:v,45:x,46:L,54:D,72:O,74:w,77:M,89:p,90:R},{26:51,89:[1,52],90:[1,53]},{55:54,89:[1,55],90:[1,56]},{29:[1,59],61:[1,57],63:[1,58]},e(d,[2,17]),e(d,[2,18]),e(d,[2,19]),e(d,[2,20]),{30:60,33:62,75:$,89:p,90:R},{30:63,33:62,75:$,89:p,90:R},{30:64,33:62,75:$,89:p,90:R},e(X,[2,29]),e(X,[2,30]),e(X,[2,31]),e(X,[2,32]),e(X,[2,33]),e(X,[2,34]),e(Ce,[2,81]),e(Ce,[2,82]),{1:[2,3]},{8:[2,8]},{8:[2,9]},{8:[2,10]},{8:[2,11]},{8:[2,12]},{8:[2,13]},{8:[2,14]},{8:[2,15]},{8:[2,16]},{27:[1,65],29:[1,66]},e(de,[2,79]),e(de,[2,80]),{27:[1,67],29:[1,68]},e(de,[2,85]),e(de,[2,86]),{62:69,65:Ve,66:ve,67:xe,68:Le,69:De,70:Oe,71:we},{62:77,65:Ve,66:ve,67:xe,68:Le,69:De,70:Oe,71:we},{30:78,33:62,75:$,89:p,90:R},{73:79,75:ee,76:U,78:81,79:82,80:te,81:se,82:ie,83:re,84:ne,85:ae,86:le,87:ce,88:oe},e(pe,[2,60]),e(pe,[2,62]),{73:93,75:ee,76:U,78:81,79:82,80:te,81:se,82:ie,83:re,84:ne,85:ae,86:le,87:ce,88:oe},{30:94,33:62,75:$,76:U,89:p,90:R},{5:[1,95]},{30:96,33:62,75:$,89:p,90:R},{5:[1,97]},{30:98,33:62,75:$,89:p,90:R},{63:[1,99]},e(Y,[2,50]),e(Y,[2,51]),e(Y,[2,52]),e(Y,[2,53]),e(Y,[2,54]),e(Y,[2,55]),e(Y,[2,56]),{64:[1,100]},e(d,[2,59],{76:U}),e(d,[2,64],{76:Me}),{33:103,75:[1,102],89:p,90:R},e(Fe,[2,65],{79:104,75:ee,80:te,81:se,82:ie,83:re,84:ne,85:ae,86:le,87:ce,88:oe}),e(T,[2,67]),e(T,[2,69]),e(T,[2,70]),e(T,[2,71]),e(T,[2,72]),e(T,[2,73]),e(T,[2,74]),e(T,[2,75]),e(T,[2,76]),e(T,[2,77]),e(T,[2,78]),e(d,[2,57],{76:Me}),e(d,[2,58],{76:U}),{5:B,28:105,31:Q,34:H,36:K,38:W,40:j},{27:[1,112],76:U},{5:he,40:ue,56:113,57:fe,59:me},{27:[1,118],76:U},{33:119,89:p,90:R},{33:120,89:p,90:R},{75:ee,78:121,79:82,80:te,81:se,82:ie,83:re,84:ne,85:ae,86:le,87:ce,88:oe},e(pe,[2,61]),e(pe,[2,63]),e(T,[2,68]),e(d,[2,21]),{32:[1,122]},{32:[1,123]},{32:[1,124]},{32:[1,125]},{5:B,28:126,31:Q,34:H,36:K,38:W,40:j},e(d,[2,28]),{5:[1,127]},e(d,[2,42]),{32:[1,128]},{32:[1,129]},{5:he,40:ue,56:130,57:fe,59:me},e(d,[2,47]),{5:[1,131]},e(d,[2,48]),e(d,[2,49]),e(Fe,[2,66],{79:104,75:ee,80:te,81:se,82:ie,83:re,84:ne,85:ae,86:le,87:ce,88:oe}),{33:132,89:p,90:R},{35:133,89:[1,134],90:[1,135]},{37:136,47:[1,137],48:[1,138],49:[1,139]},{39:140,50:[1,141],51:[1,142],52:[1,143],53:[1,144]},e(d,[2,27]),{5:B,28:145,31:Q,34:H,36:K,38:W,40:j},{58:146,89:[1,147],90:[1,148]},{60:149,89:[1,150],90:[1,151]},e(d,[2,46]),{5:he,40:ue,56:152,57:fe,59:me},{5:[1,153]},{5:[1,154]},{5:[2,83]},{5:[2,84]},{5:[1,155]},{5:[2,35]},{5:[2,36]},{5:[2,37]},{5:[1,156]},{5:[2,38]},{5:[2,39]},{5:[2,40]},{5:[2,41]},e(d,[2,22]),{5:[1,157]},{5:[2,87]},{5:[2,88]},{5:[1,158]},{5:[2,89]},{5:[2,90]},e(d,[2,43]),{5:B,28:159,31:Q,34:H,36:K,38:W,40:j},{5:B,28:160,31:Q,34:H,36:K,38:W,40:j},{5:B,28:161,31:Q,34:H,36:K,38:W,40:j},{5:B,28:162,31:Q,34:H,36:K,38:W,40:j},{5:he,40:ue,56:163,57:fe,59:me},{5:he,40:ue,56:164,57:fe,59:me},e(d,[2,23]),e(d,[2,24]),e(d,[2,25]),e(d,[2,26]),e(d,[2,44]),e(d,[2,45])],defaultActions:{8:[2,2],12:[2,1],41:[2,3],42:[2,8],43:[2,9],44:[2,10],45:[2,11],46:[2,12],47:[2,13],48:[2,14],49:[2,15],50:[2,16],134:[2,83],135:[2,84],137:[2,35],138:[2,36],139:[2,37],141:[2,38],142:[2,39],143:[2,40],144:[2,41],147:[2,87],148:[2,88],150:[2,89],151:[2,90]},parseError:f(function(i,n){if(n.recoverable)this.trace(i);else{var c=new Error(i);throw c.hash=n,c}},"parseError"),parse:f(function(i){var n=this,c=[0],s=[],E=[null],t=[],Ee=this.table,a="",ye=0,Pe=0,He=2,$e=1,Ke=t.slice.call(arguments,1),g=Object.create(this.lexer),G={yy:{}};for(var Ie in this.yy)Object.prototype.hasOwnProperty.call(this.yy,Ie)&&(G.yy[Ie]=this.yy[Ie]);g.setInput(i,G.yy),G.yy.lexer=g,G.yy.parser=this,typeof g.yylloc>"u"&&(g.yylloc={});var be=g.yylloc;t.push(be);var We=g.options&&g.options.ranges;typeof G.yy.parseError=="function"?this.parseError=G.yy.parseError:this.parseError=Object.getPrototypeOf(this).parseError;function je(I){c.length=c.length-2*I,E.length=E.length-I,t.length=t.length-I}f(je,"popStack");function Ue(){var I;return I=s.pop()||g.lex()||$e,typeof I!="number"&&(I instanceof Array&&(s=I,I=s.pop()),I=n.symbols_[I]||I),I}f(Ue,"lex");for(var S,z,k,Te,J={},ge,F,Ye,_e;;){if(z=c[c.length-1],this.defaultActions[z]?k=this.defaultActions[z]:((S===null||typeof S>"u")&&(S=Ue()),k=Ee[z]&&Ee[z][S]),typeof k>"u"||!k.length||!k[0]){var ke="";_e=[];for(ge in Ee[z])this.terminals_[ge]&&ge>He&&_e.push("'"+this.terminals_[ge]+"'");g.showPosition?ke="Parse error on line "+(ye+1)+`:
-`+g.showPosition()+`
-Expecting `+_e.join(", ")+", got '"+(this.terminals_[S]||S)+"'":ke="Parse error on line "+(ye+1)+": Unexpected "+(S==$e?"end of input":"'"+(this.terminals_[S]||S)+"'"),this.parseError(ke,{text:g.match,token:this.terminals_[S]||S,line:g.yylineno,loc:be,expected:_e})}if(k[0]instanceof Array&&k.length>1)throw new Error("Parse Error: multiple actions possible at state: "+z+", token: "+S);switch(k[0]){case 1:c.push(S),E.push(g.yytext),t.push(g.yylloc),c.push(k[1]),S=null,Pe=g.yyleng,a=g.yytext,ye=g.yylineno,be=g.yylloc;break;case 2:if(F=this.productions_[k[1]][1],J.$=E[E.length-F],J._$={first_line:t[t.length-(F||1)].first_line,last_line:t[t.length-1].last_line,first_column:t[t.length-(F||1)].first_column,last_column:t[t.length-1].last_column},We&&(J._$.range=[t[t.length-(F||1)].range[0],t[t.length-1].range[1]]),Te=this.performAction.apply(J,[a,Pe,ye,G.yy,k[1],E,t].concat(Ke)),typeof Te<"u")return Te;F&&(c=c.slice(0,-1*F*2),E=E.slice(0,-1*F),t=t.slice(0,-1*F)),c.push(this.productions_[k[1]][0]),E.push(J.$),t.push(J._$),Ye=Ee[c[c.length-2]][c[c.length-1]],c.push(Ye);break;case 3:return!0}}return!0},"parse")},Qe=(function(){var P={EOF:1,parseError:f(function(n,c){if(this.yy.parser)this.yy.parser.parseError(n,c);else throw new Error(n)},"parseError"),setInput:f(function(i,n){return this.yy=n||this.yy||{},this._input=i,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},"setInput"),input:f(function(){var i=this._input[0];this.yytext+=i,this.yyleng++,this.offset++,this.match+=i,this.matched+=i;var n=i.match(/(?:\r\n?|\n).*/g);return n?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),i},"input"),unput:f(function(i){var n=i.length,c=i.split(/(?:\r\n?|\n)/g);this._input=i+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-n),this.offset-=n;var s=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),c.length-1&&(this.yylineno-=c.length-1);var E=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:c?(c.length===s.length?this.yylloc.first_column:0)+s[s.length-c.length].length-c[0].length:this.yylloc.first_column-n},this.options.ranges&&(this.yylloc.range=[E[0],E[0]+this.yyleng-n]),this.yyleng=this.yytext.length,this},"unput"),more:f(function(){return this._more=!0,this},"more"),reject:f(function(){if(this.options.backtrack_lexer)this._backtrack=!0;else return this.parseError("Lexical error on line "+(this.yylineno+1)+`. You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).
-`+this.showPosition(),{text:"",token:null,line:this.yylineno});return this},"reject"),less:f(function(i){this.unput(this.match.slice(i))},"less"),pastInput:f(function(){var i=this.matched.substr(0,this.matched.length-this.match.length);return(i.length>20?"...":"")+i.substr(-20).replace(/\n/g,"")},"pastInput"),upcomingInput:f(function(){var i=this.match;return i.length<20&&(i+=this._input.substr(0,20-i.length)),(i.substr(0,20)+(i.length>20?"...":"")).replace(/\n/g,"")},"upcomingInput"),showPosition:f(function(){var i=this.pastInput(),n=new Array(i.length+1).join("-");return i+this.upcomingInput()+`
-`+n+"^"},"showPosition"),test_match:f(function(i,n){var c,s,E;if(this.options.backtrack_lexer&&(E={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(E.yylloc.range=this.yylloc.range.slice(0))),s=i[0].match(/(?:\r\n?|\n).*/g),s&&(this.yylineno+=s.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:s?s[s.length-1].length-s[s.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+i[0].length},this.yytext+=i[0],this.match+=i[0],this.matches=i,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(i[0].length),this.matched+=i[0],c=this.performAction.call(this,this.yy,this,n,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),c)return c;if(this._backtrack){for(var t in E)this[t]=E[t];return!1}return!1},"test_match"),next:f(function(){if(this.done)return this.EOF;this._input||(this.done=!0);var i,n,c,s;this._more||(this.yytext="",this.match="");for(var E=this._currentRules(),t=0;t<E.length;t++)if(c=this._input.match(this.rules[E[t]]),c&&(!n||c[0].length>n[0].length)){if(n=c,s=t,this.options.backtrack_lexer){if(i=this.test_match(c,E[t]),i!==!1)return i;if(this._backtrack){n=!1;continue}else return!1}else if(!this.options.flex)break}return n?(i=this.test_match(n,E[s]),i!==!1?i:!1):this._input===""?this.EOF:this.parseError("Lexical error on line "+(this.yylineno+1)+`. Unrecognized text.
-`+this.showPosition(),{text:"",token:null,line:this.yylineno})},"next"),lex:f(function(){var n=this.next();return n||this.lex()},"lex"),begin:f(function(n){this.conditionStack.push(n)},"begin"),popState:f(function(){var n=this.conditionStack.length-1;return n>0?this.conditionStack.pop():this.conditionStack[0]},"popState"),_currentRules:f(function(){return this.conditionStack.length&&this.conditionStack[this.conditionStack.length-1]?this.conditions[this.conditionStack[this.conditionStack.length-1]].rules:this.conditions.INITIAL.rules},"_currentRules"),topState:f(function(n){return n=this.conditionStack.length-1-Math.abs(n||0),n>=0?this.conditionStack[n]:"INITIAL"},"topState"),pushState:f(function(n){this.begin(n)},"pushState"),stateStackSize:f(function(){return this.conditionStack.length},"stateStackSize"),options:{"case-insensitive":!0},performAction:f(function(n,c,s,E){switch(s){case 0:return"title";case 1:return this.begin("acc_title"),9;case 2:return this.popState(),"acc_title_value";case 3:return this.begin("acc_descr"),11;case 4:return this.popState(),"acc_descr_value";case 5:this.begin("acc_descr_multiline");break;case 6:this.popState();break;case 7:return"acc_descr_multiline_value";case 8:return 21;case 9:return 22;case 10:return 23;case 11:return 24;case 12:return 5;case 13:break;case 14:break;case 15:break;case 16:return 8;case 17:return 6;case 18:return 27;case 19:return 40;case 20:return 29;case 21:return 32;case 22:return 31;case 23:return 34;case 24:return 36;case 25:return 38;case 26:return 41;case 27:return 42;case 28:return 43;case 29:return 44;case 30:return 45;case 31:return 46;case 32:return 47;case 33:return 48;case 34:return 49;case 35:return 50;case 36:return 51;case 37:return 52;case 38:return 53;case 39:return 54;case 40:return 65;case 41:return 66;case 42:return 67;case 43:return 68;case 44:return 69;case 45:return 70;case 46:return 71;case 47:return 57;case 48:return 59;case 49:return this.begin("style"),77;case 50:return 75;case 51:return 81;case 52:return 88;case 53:return"PERCENT";case 54:return 86;case 55:return 84;case 56:break;case 57:this.begin("string");break;case 58:this.popState();break;case 59:return this.begin("style"),72;case 60:return this.begin("style"),74;case 61:return 61;case 62:return 64;case 63:return 63;case 64:this.begin("string");break;case 65:this.popState();break;case 66:return"qString";case 67:return c.yytext=c.yytext.trim(),89;case 68:return 75;case 69:return 80;case 70:return 76}},"anonymous"),rules:[/^(?:title\s[^#\n;]+)/i,/^(?:accTitle\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*\{\s*)/i,/^(?:[\}])/i,/^(?:[^\}]*)/i,/^(?:.*direction\s+TB[^\n]*)/i,/^(?:.*direction\s+BT[^\n]*)/i,/^(?:.*direction\s+RL[^\n]*)/i,/^(?:.*direction\s+LR[^\n]*)/i,/^(?:(\r?\n)+)/i,/^(?:\s+)/i,/^(?:#[^\n]*)/i,/^(?:%[^\n]*)/i,/^(?:$)/i,/^(?:requirementDiagram\b)/i,/^(?:\{)/i,/^(?:\})/i,/^(?::{3})/i,/^(?::)/i,/^(?:id\b)/i,/^(?:text\b)/i,/^(?:risk\b)/i,/^(?:verifyMethod\b)/i,/^(?:requirement\b)/i,/^(?:functionalRequirement\b)/i,/^(?:interfaceRequirement\b)/i,/^(?:performanceRequirement\b)/i,/^(?:physicalRequirement\b)/i,/^(?:designConstraint\b)/i,/^(?:low\b)/i,/^(?:medium\b)/i,/^(?:high\b)/i,/^(?:analysis\b)/i,/^(?:demonstration\b)/i,/^(?:inspection\b)/i,/^(?:test\b)/i,/^(?:element\b)/i,/^(?:contains\b)/i,/^(?:copies\b)/i,/^(?:derives\b)/i,/^(?:satisfies\b)/i,/^(?:verifies\b)/i,/^(?:refines\b)/i,/^(?:traces\b)/i,/^(?:type\b)/i,/^(?:docref\b)/i,/^(?:style\b)/i,/^(?:\w+)/i,/^(?::)/i,/^(?:;)/i,/^(?:%)/i,/^(?:-)/i,/^(?:#)/i,/^(?: )/i,/^(?:["])/i,/^(?:\n)/i,/^(?:classDef\b)/i,/^(?:class\b)/i,/^(?:<-)/i,/^(?:->)/i,/^(?:-)/i,/^(?:["])/i,/^(?:["])/i,/^(?:[^"]*)/i,/^(?:[\w][^:,\r\n\{\<\>\-\=]*)/i,/^(?:\w+)/i,/^(?:[0-9]+)/i,/^(?:,)/i],conditions:{acc_descr_multiline:{rules:[6,7,68,69,70],inclusive:!1},acc_descr:{rules:[4,68,69,70],inclusive:!1},acc_title:{rules:[2,68,69,70],inclusive:!1},style:{rules:[50,51,52,53,54,55,56,57,58,68,69,70],inclusive:!1},unqString:{rules:[68,69,70],inclusive:!1},token:{rules:[68,69,70],inclusive:!1},string:{rules:[65,66,68,69,70],inclusive:!1},INITIAL:{rules:[0,1,3,5,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,59,60,61,62,63,64,67,68,69,70],inclusive:!0}}};return P})();Se.lexer=Qe;function Re(){this.yy={}}return f(Re,"Parser"),Re.prototype=Se,Se.Parser=Re,new Re})();Ae.parser=Ae;var ct=Ae,Z,ot=(Z=class{constructor(){this.relations=[],this.latestRequirement=this.getInitialRequirement(),this.requirements=new Map,this.latestElement=this.getInitialElement(),this.elements=new Map,this.classes=new Map,this.direction="TB",this.RequirementType={REQUIREMENT:"Requirement",FUNCTIONAL_REQUIREMENT:"Functional Requirement",INTERFACE_REQUIREMENT:"Interface Requirement",PERFORMANCE_REQUIREMENT:"Performance Requirement",PHYSICAL_REQUIREMENT:"Physical Requirement",DESIGN_CONSTRAINT:"Design Constraint"},this.RiskLevel={LOW_RISK:"Low",MED_RISK:"Medium",HIGH_RISK:"High"},this.VerifyType={VERIFY_ANALYSIS:"Analysis",VERIFY_DEMONSTRATION:"Demonstration",VERIFY_INSPECTION:"Inspection",VERIFY_TEST:"Test"},this.Relationships={CONTAINS:"contains",COPIES:"copies",DERIVES:"derives",SATISFIES:"satisfies",VERIFIES:"verifies",REFINES:"refines",TRACES:"traces"},this.setAccTitle=Xe,this.getAccTitle=Je,this.setAccDescription=Ze,this.getAccDescription=et,this.setDiagramTitle=tt,this.getDiagramTitle=st,this.getConfig=f(()=>Ne().requirement,"getConfig"),this.clear(),this.setDirection=this.setDirection.bind(this),this.addRequirement=this.addRequirement.bind(this),this.setNewReqId=this.setNewReqId.bind(this),this.setNewReqRisk=this.setNewReqRisk.bind(this),this.setNewReqText=this.setNewReqText.bind(this),this.setNewReqVerifyMethod=this.setNewReqVerifyMethod.bind(this),this.addElement=this.addElement.bind(this),this.setNewElementType=this.setNewElementType.bind(this),this.setNewElementDocRef=this.setNewElementDocRef.bind(this),this.addRelationship=this.addRelationship.bind(this),this.setCssStyle=this.setCssStyle.bind(this),this.setClass=this.setClass.bind(this),this.defineClass=this.defineClass.bind(this),this.setAccTitle=this.setAccTitle.bind(this),this.setAccDescription=this.setAccDescription.bind(this)}getDirection(){return this.direction}setDirection(l){this.direction=l}resetLatestRequirement(){this.latestRequirement=this.getInitialRequirement()}resetLatestElement(){this.latestElement=this.getInitialElement()}getInitialRequirement(){return{requirementId:"",text:"",risk:"",verifyMethod:"",name:"",type:"",cssStyles:[],classes:["default"]}}getInitialElement(){return{name:"",type:"",docRef:"",cssStyles:[],classes:["default"]}}addRequirement(l,u){return this.requirements.has(l)||this.requirements.set(l,{name:l,type:u,requirementId:this.latestRequirement.requirementId,text:this.latestRequirement.text,risk:this.latestRequirement.risk,verifyMethod:this.latestRequirement.verifyMethod,cssStyles:[],classes:["default"]}),this.resetLatestRequirement(),this.requirements.get(l)}getRequirements(){return this.requirements}setNewReqId(l){this.latestRequirement!==void 0&&(this.latestRequirement.requirementId=l)}setNewReqText(l){this.latestRequirement!==void 0&&(this.latestRequirement.text=l)}setNewReqRisk(l){this.latestRequirement!==void 0&&(this.latestRequirement.risk=l)}setNewReqVerifyMethod(l){this.latestRequirement!==void 0&&(this.latestRequirement.verifyMethod=l)}addElement(l){return this.elements.has(l)||(this.elements.set(l,{name:l,type:this.latestElement.type,docRef:this.latestElement.docRef,cssStyles:[],classes:["default"]}),qe.info("Added new element: ",l)),this.resetLatestElement(),this.elements.get(l)}getElements(){return this.elements}setNewElementType(l){this.latestElement!==void 0&&(this.latestElement.type=l)}setNewElementDocRef(l){this.latestElement!==void 0&&(this.latestElement.docRef=l)}addRelationship(l,u,h){this.relations.push({type:l,src:u,dst:h})}getRelationships(){return this.relations}clear(){this.relations=[],this.resetLatestRequirement(),this.requirements=new Map,this.resetLatestElement(),this.elements=new Map,this.classes=new Map,it()}setCssStyle(l,u){for(const h of l){const r=this.requirements.get(h)??this.elements.get(h);if(!u||!r)return;for(const o of u)o.includes(",")?r.cssStyles.push(...o.split(",")):r.cssStyles.push(o)}}setClass(l,u){for(const h of l){const r=this.requirements.get(h)??this.elements.get(h);if(r)for(const o of u){r.classes.push(o);const m=this.classes.get(o)?.styles;m&&r.cssStyles.push(...m)}}}defineClass(l,u){for(const h of l){let r=this.classes.get(h);r===void 0&&(r={id:h,styles:[],textStyles:[]},this.classes.set(h,r)),u&&u.forEach(function(o){if(/color/.exec(o)){const m=o.replace("fill","bgFill");r.textStyles.push(m)}r.styles.push(o)}),this.requirements.forEach(o=>{o.classes.includes(h)&&o.cssStyles.push(...u.flatMap(m=>m.split(",")))}),this.elements.forEach(o=>{o.classes.includes(h)&&o.cssStyles.push(...u.flatMap(m=>m.split(",")))})}}getClasses(){return this.classes}getData(){const l=Ne(),u=[],h=[];for(const r of this.requirements.values()){const o=r;o.id=r.name,o.cssStyles=r.cssStyles,o.cssClasses=r.classes.join(" "),o.shape="requirementBox",o.look=l.look,u.push(o)}for(const r of this.elements.values()){const o=r;o.shape="requirementBox",o.look=l.look,o.id=r.name,o.cssStyles=r.cssStyles,o.cssClasses=r.classes.join(" "),u.push(o)}for(const r of this.relations){let o=0;const m=r.type===this.Relationships.CONTAINS,y={id:`${r.src}-${r.dst}-${o}`,start:this.requirements.get(r.src)?.name??this.elements.get(r.src)?.name,end:this.requirements.get(r.dst)?.name??this.elements.get(r.dst)?.name,label:`&lt;&lt;${r.type}&gt;&gt;`,classes:"relationshipLine",style:["fill:none",m?"":"stroke-dasharray: 10,7"],labelpos:"c",thickness:"normal",type:"normal",pattern:m?"normal":"dashed",arrowTypeStart:m?"requirement_contains":"",arrowTypeEnd:m?"":"requirement_arrow",look:l.look};h.push(y),o++}return{nodes:u,edges:h,other:{},config:l,direction:this.getDirection()}}},f(Z,"RequirementDB"),Z),ht=f(e=>`
-
-  marker {
-    fill: ${e.relationColor};
-    stroke: ${e.relationColor};
-  }
-
-  marker.cross {
-    stroke: ${e.lineColor};
-  }
-
-  svg {
-    font-family: ${e.fontFamily};
-    font-size: ${e.fontSize};
-  }
-
-  .reqBox {
-    fill: ${e.requirementBackground};
-    fill-opacity: 1.0;
-    stroke: ${e.requirementBorderColor};
-    stroke-width: ${e.requirementBorderSize};
-  }
-  
-  .reqTitle, .reqLabel{
-    fill:  ${e.requirementTextColor};
-  }
-  .reqLabelBox {
-    fill: ${e.relationLabelBackground};
-    fill-opacity: 1.0;
-  }
-
-  .req-title-line {
-    stroke: ${e.requirementBorderColor};
-    stroke-width: ${e.requirementBorderSize};
-  }
-  .relationshipLine {
-    stroke: ${e.relationColor};
-    stroke-width: 1;
-  }
-  .relationshipLabel {
-    fill: ${e.relationLabelColor};
-  }
-  .divider {
-    stroke: ${e.nodeBorder};
-    stroke-width: 1;
-  }
-  .label {
-    font-family: ${e.fontFamily};
-    color: ${e.nodeTextColor||e.textColor};
-  }
-  .label text,span {
-    fill: ${e.nodeTextColor||e.textColor};
-    color: ${e.nodeTextColor||e.textColor};
-  }
-  .labelBkg {
-    background-color: ${e.edgeLabelBackground};
-  }
-
-`,"getStyles"),ut=ht,Be={};rt(Be,{draw:()=>ft});var ft=f(async function(e,l,u,h){qe.info("REF0:"),qe.info("Drawing requirement diagram (unified)",l);const{securityLevel:r,state:o,layout:m}=Ne(),y=h.db.getData(),_=Ge(l,r);y.type=h.type,y.layoutAlgorithm=nt(m),y.nodeSpacing=o?.nodeSpacing??50,y.rankSpacing=o?.rankSpacing??50,y.markers=["requirement_contains","requirement_arrow"],y.diagramId=l,await at(y,_);const b=8;lt.insertTitle(_,"requirementDiagramTitleText",o?.titleTopMargin??25,h.db.getDiagramTitle()),ze(_,b,"requirementDiagram",o?.useMaxWidth??!0)},"draw"),pt={parser:ct,get db(){return new ot},renderer:Be,styles:ut};export{pt as diagram};
diff --git a/docs/dist/assets/sankeyDiagram-TZEHDZUN-CcPJsCNS.js b/docs/dist/assets/sankeyDiagram-TZEHDZUN-CcPJsCNS.js
deleted file mode 100644
index 3e3d45c6..00000000
--- a/docs/dist/assets/sankeyDiagram-TZEHDZUN-CcPJsCNS.js
+++ /dev/null
@@ -1,10 +0,0 @@
-import{_ as g,p as _t,q as xt,s as vt,g as bt,b as wt,a as St,c as lt,z as Lt,d as H,V as Et,y as At,k as Tt}from"./index-BxX29htg.js";import{o as Mt}from"./ordinal-Cboi1Yqb.js";import"./init-Gi6I4Gst.js";function Nt(t){for(var e=t.length/6|0,i=new Array(e),a=0;a<e;)i[a]="#"+t.slice(a*6,++a*6);return i}const It=Nt("4e79a7f28e2ce1575976b7b259a14fedc949af7aa1ff9da79c755fbab0ab");function ct(t,e){let i;if(e===void 0)for(const a of t)a!=null&&(i<a||i===void 0&&a>=a)&&(i=a);else{let a=-1;for(let h of t)(h=e(h,++a,t))!=null&&(i<h||i===void 0&&h>=h)&&(i=h)}return i}function pt(t,e){let i;if(e===void 0)for(const a of t)a!=null&&(i>a||i===void 0&&a>=a)&&(i=a);else{let a=-1;for(let h of t)(h=e(h,++a,t))!=null&&(i>h||i===void 0&&h>=h)&&(i=h)}return i}function nt(t,e){let i=0;if(e===void 0)for(let a of t)(a=+a)&&(i+=a);else{let a=-1;for(let h of t)(h=+e(h,++a,t))&&(i+=h)}return i}function Pt(t){return t.target.depth}function Ct(t){return t.depth}function Ot(t,e){return e-1-t.height}function mt(t,e){return t.sourceLinks.length?t.depth:e-1}function zt(t){return t.targetLinks.length?t.depth:t.sourceLinks.length?pt(t.sourceLinks,Pt)-1:0}function X(t){return function(){return t}}function ut(t,e){return Q(t.source,e.source)||t.index-e.index}function ht(t,e){return Q(t.target,e.target)||t.index-e.index}function Q(t,e){return t.y0-e.y0}function it(t){return t.value}function Dt(t){return t.index}function $t(t){return t.nodes}function jt(t){return t.links}function ft(t,e){const i=t.get(e);if(!i)throw new Error("missing: "+e);return i}function yt({nodes:t}){for(const e of t){let i=e.y0,a=i;for(const h of e.sourceLinks)h.y0=i+h.width/2,i+=h.width;for(const h of e.targetLinks)h.y1=a+h.width/2,a+=h.width}}function Bt(){let t=0,e=0,i=1,a=1,h=24,b=8,p,k=Dt,s=mt,o,l,_=$t,x=jt,y=6;function v(){const n={nodes:_.apply(null,arguments),links:x.apply(null,arguments)};return M(n),T(n),N(n),C(n),S(n),yt(n),n}v.update=function(n){return yt(n),n},v.nodeId=function(n){return arguments.length?(k=typeof n=="function"?n:X(n),v):k},v.nodeAlign=function(n){return arguments.length?(s=typeof n=="function"?n:X(n),v):s},v.nodeSort=function(n){return arguments.length?(o=n,v):o},v.nodeWidth=function(n){return arguments.length?(h=+n,v):h},v.nodePadding=function(n){return arguments.length?(b=p=+n,v):b},v.nodes=function(n){return arguments.length?(_=typeof n=="function"?n:X(n),v):_},v.links=function(n){return arguments.length?(x=typeof n=="function"?n:X(n),v):x},v.linkSort=function(n){return arguments.length?(l=n,v):l},v.size=function(n){return arguments.length?(t=e=0,i=+n[0],a=+n[1],v):[i-t,a-e]},v.extent=function(n){return arguments.length?(t=+n[0][0],i=+n[1][0],e=+n[0][1],a=+n[1][1],v):[[t,e],[i,a]]},v.iterations=function(n){return arguments.length?(y=+n,v):y};function M({nodes:n,links:f}){for(const[c,r]of n.entries())r.index=c,r.sourceLinks=[],r.targetLinks=[];const u=new Map(n.map((c,r)=>[k(c,r,n),c]));for(const[c,r]of f.entries()){r.index=c;let{source:m,target:w}=r;typeof m!="object"&&(m=r.source=ft(u,m)),typeof w!="object"&&(w=r.target=ft(u,w)),m.sourceLinks.push(r),w.targetLinks.push(r)}if(l!=null)for(const{sourceLinks:c,targetLinks:r}of n)c.sort(l),r.sort(l)}function T({nodes:n}){for(const f of n)f.value=f.fixedValue===void 0?Math.max(nt(f.sourceLinks,it),nt(f.targetLinks,it)):f.fixedValue}function N({nodes:n}){const f=n.length;let u=new Set(n),c=new Set,r=0;for(;u.size;){for(const m of u){m.depth=r;for(const{target:w}of m.sourceLinks)c.add(w)}if(++r>f)throw new Error("circular link");u=c,c=new Set}}function C({nodes:n}){const f=n.length;let u=new Set(n),c=new Set,r=0;for(;u.size;){for(const m of u){m.height=r;for(const{source:w}of m.targetLinks)c.add(w)}if(++r>f)throw new Error("circular link");u=c,c=new Set}}function D({nodes:n}){const f=ct(n,r=>r.depth)+1,u=(i-t-h)/(f-1),c=new Array(f);for(const r of n){const m=Math.max(0,Math.min(f-1,Math.floor(s.call(null,r,f))));r.layer=m,r.x0=t+m*u,r.x1=r.x0+h,c[m]?c[m].push(r):c[m]=[r]}if(o)for(const r of c)r.sort(o);return c}function R(n){const f=pt(n,u=>(a-e-(u.length-1)*p)/nt(u,it));for(const u of n){let c=e;for(const r of u){r.y0=c,r.y1=c+r.value*f,c=r.y1+p;for(const m of r.sourceLinks)m.width=m.value*f}c=(a-c+p)/(u.length+1);for(let r=0;r<u.length;++r){const m=u[r];m.y0+=c*(r+1),m.y1+=c*(r+1)}A(u)}}function S(n){const f=D(n);p=Math.min(b,(a-e)/(ct(f,u=>u.length)-1)),R(f);for(let u=0;u<y;++u){const c=Math.pow(.99,u),r=Math.max(1-c,(u+1)/y);B(f,c,r),P(f,c,r)}}function P(n,f,u){for(let c=1,r=n.length;c<r;++c){const m=n[c];for(const w of m){let L=0,V=0;for(const{source:Y,value:et}of w.targetLinks){let q=et*(w.layer-Y.layer);L+=$(Y,w)*q,V+=q}if(!(V>0))continue;let G=(L/V-w.y0)*f;w.y0+=G,w.y1+=G,E(w)}o===void 0&&m.sort(Q),O(m,u)}}function B(n,f,u){for(let c=n.length,r=c-2;r>=0;--r){const m=n[r];for(const w of m){let L=0,V=0;for(const{target:Y,value:et}of w.sourceLinks){let q=et*(Y.layer-w.layer);L+=I(w,Y)*q,V+=q}if(!(V>0))continue;let G=(L/V-w.y0)*f;w.y0+=G,w.y1+=G,E(w)}o===void 0&&m.sort(Q),O(m,u)}}function O(n,f){const u=n.length>>1,c=n[u];d(n,c.y0-p,u-1,f),z(n,c.y1+p,u+1,f),d(n,a,n.length-1,f),z(n,e,0,f)}function z(n,f,u,c){for(;u<n.length;++u){const r=n[u],m=(f-r.y0)*c;m>1e-6&&(r.y0+=m,r.y1+=m),f=r.y1+p}}function d(n,f,u,c){for(;u>=0;--u){const r=n[u],m=(r.y1-f)*c;m>1e-6&&(r.y0-=m,r.y1-=m),f=r.y0-p}}function E({sourceLinks:n,targetLinks:f}){if(l===void 0){for(const{source:{sourceLinks:u}}of f)u.sort(ht);for(const{target:{targetLinks:u}}of n)u.sort(ut)}}function A(n){if(l===void 0)for(const{sourceLinks:f,targetLinks:u}of n)f.sort(ht),u.sort(ut)}function $(n,f){let u=n.y0-(n.sourceLinks.length-1)*p/2;for(const{target:c,width:r}of n.sourceLinks){if(c===f)break;u+=r+p}for(const{source:c,width:r}of f.targetLinks){if(c===n)break;u-=r}return u}function I(n,f){let u=f.y0-(f.targetLinks.length-1)*p/2;for(const{source:c,width:r}of f.targetLinks){if(c===n)break;u+=r+p}for(const{target:c,width:r}of n.sourceLinks){if(c===f)break;u-=r}return u}return v}var st=Math.PI,rt=2*st,F=1e-6,Rt=rt-F;function ot(){this._x0=this._y0=this._x1=this._y1=null,this._=""}function kt(){return new ot}ot.prototype=kt.prototype={constructor:ot,moveTo:function(t,e){this._+="M"+(this._x0=this._x1=+t)+","+(this._y0=this._y1=+e)},closePath:function(){this._x1!==null&&(this._x1=this._x0,this._y1=this._y0,this._+="Z")},lineTo:function(t,e){this._+="L"+(this._x1=+t)+","+(this._y1=+e)},quadraticCurveTo:function(t,e,i,a){this._+="Q"+ +t+","+ +e+","+(this._x1=+i)+","+(this._y1=+a)},bezierCurveTo:function(t,e,i,a,h,b){this._+="C"+ +t+","+ +e+","+ +i+","+ +a+","+(this._x1=+h)+","+(this._y1=+b)},arcTo:function(t,e,i,a,h){t=+t,e=+e,i=+i,a=+a,h=+h;var b=this._x1,p=this._y1,k=i-t,s=a-e,o=b-t,l=p-e,_=o*o+l*l;if(h<0)throw new Error("negative radius: "+h);if(this._x1===null)this._+="M"+(this._x1=t)+","+(this._y1=e);else if(_>F)if(!(Math.abs(l*k-s*o)>F)||!h)this._+="L"+(this._x1=t)+","+(this._y1=e);else{var x=i-b,y=a-p,v=k*k+s*s,M=x*x+y*y,T=Math.sqrt(v),N=Math.sqrt(_),C=h*Math.tan((st-Math.acos((v+_-M)/(2*T*N)))/2),D=C/N,R=C/T;Math.abs(D-1)>F&&(this._+="L"+(t+D*o)+","+(e+D*l)),this._+="A"+h+","+h+",0,0,"+ +(l*x>o*y)+","+(this._x1=t+R*k)+","+(this._y1=e+R*s)}},arc:function(t,e,i,a,h,b){t=+t,e=+e,i=+i,b=!!b;var p=i*Math.cos(a),k=i*Math.sin(a),s=t+p,o=e+k,l=1^b,_=b?a-h:h-a;if(i<0)throw new Error("negative radius: "+i);this._x1===null?this._+="M"+s+","+o:(Math.abs(this._x1-s)>F||Math.abs(this._y1-o)>F)&&(this._+="L"+s+","+o),i&&(_<0&&(_=_%rt+rt),_>Rt?this._+="A"+i+","+i+",0,1,"+l+","+(t-p)+","+(e-k)+"A"+i+","+i+",0,1,"+l+","+(this._x1=s)+","+(this._y1=o):_>F&&(this._+="A"+i+","+i+",0,"+ +(_>=st)+","+l+","+(this._x1=t+i*Math.cos(h))+","+(this._y1=e+i*Math.sin(h))))},rect:function(t,e,i,a){this._+="M"+(this._x0=this._x1=+t)+","+(this._y0=this._y1=+e)+"h"+ +i+"v"+ +a+"h"+-i+"Z"},toString:function(){return this._}};function dt(t){return function(){return t}}function Vt(t){return t[0]}function Ft(t){return t[1]}var Wt=Array.prototype.slice;function Ut(t){return t.source}function Gt(t){return t.target}function Yt(t){var e=Ut,i=Gt,a=Vt,h=Ft,b=null;function p(){var k,s=Wt.call(arguments),o=e.apply(this,s),l=i.apply(this,s);if(b||(b=k=kt()),t(b,+a.apply(this,(s[0]=o,s)),+h.apply(this,s),+a.apply(this,(s[0]=l,s)),+h.apply(this,s)),k)return b=null,k+""||null}return p.source=function(k){return arguments.length?(e=k,p):e},p.target=function(k){return arguments.length?(i=k,p):i},p.x=function(k){return arguments.length?(a=typeof k=="function"?k:dt(+k),p):a},p.y=function(k){return arguments.length?(h=typeof k=="function"?k:dt(+k),p):h},p.context=function(k){return arguments.length?(b=k??null,p):b},p}function qt(t,e,i,a,h){t.moveTo(e,i),t.bezierCurveTo(e=(e+a)/2,i,e,h,a,h)}function Ht(){return Yt(qt)}function Xt(t){return[t.source.x1,t.y0]}function Qt(t){return[t.target.x0,t.y1]}function Kt(){return Ht().source(Xt).target(Qt)}var at=(function(){var t=g(function(k,s,o,l){for(o=o||{},l=k.length;l--;o[k[l]]=s);return o},"o"),e=[1,9],i=[1,10],a=[1,5,10,12],h={trace:g(function(){},"trace"),yy:{},symbols_:{error:2,start:3,SANKEY:4,NEWLINE:5,csv:6,opt_eof:7,record:8,csv_tail:9,EOF:10,"field[source]":11,COMMA:12,"field[target]":13,"field[value]":14,field:15,escaped:16,non_escaped:17,DQUOTE:18,ESCAPED_TEXT:19,NON_ESCAPED_TEXT:20,$accept:0,$end:1},terminals_:{2:"error",4:"SANKEY",5:"NEWLINE",10:"EOF",11:"field[source]",12:"COMMA",13:"field[target]",14:"field[value]",18:"DQUOTE",19:"ESCAPED_TEXT",20:"NON_ESCAPED_TEXT"},productions_:[0,[3,4],[6,2],[9,2],[9,0],[7,1],[7,0],[8,5],[15,1],[15,1],[16,3],[17,1]],performAction:g(function(s,o,l,_,x,y,v){var M=y.length-1;switch(x){case 7:const T=_.findOrCreateNode(y[M-4].trim().replaceAll('""','"')),N=_.findOrCreateNode(y[M-2].trim().replaceAll('""','"')),C=parseFloat(y[M].trim());_.addLink(T,N,C);break;case 8:case 9:case 11:this.$=y[M];break;case 10:this.$=y[M-1];break}},"anonymous"),table:[{3:1,4:[1,2]},{1:[3]},{5:[1,3]},{6:4,8:5,15:6,16:7,17:8,18:e,20:i},{1:[2,6],7:11,10:[1,12]},t(i,[2,4],{9:13,5:[1,14]}),{12:[1,15]},t(a,[2,8]),t(a,[2,9]),{19:[1,16]},t(a,[2,11]),{1:[2,1]},{1:[2,5]},t(i,[2,2]),{6:17,8:5,15:6,16:7,17:8,18:e,20:i},{15:18,16:7,17:8,18:e,20:i},{18:[1,19]},t(i,[2,3]),{12:[1,20]},t(a,[2,10]),{15:21,16:7,17:8,18:e,20:i},t([1,5,10],[2,7])],defaultActions:{11:[2,1],12:[2,5]},parseError:g(function(s,o){if(o.recoverable)this.trace(s);else{var l=new Error(s);throw l.hash=o,l}},"parseError"),parse:g(function(s){var o=this,l=[0],_=[],x=[null],y=[],v=this.table,M="",T=0,N=0,C=2,D=1,R=y.slice.call(arguments,1),S=Object.create(this.lexer),P={yy:{}};for(var B in this.yy)Object.prototype.hasOwnProperty.call(this.yy,B)&&(P.yy[B]=this.yy[B]);S.setInput(s,P.yy),P.yy.lexer=S,P.yy.parser=this,typeof S.yylloc>"u"&&(S.yylloc={});var O=S.yylloc;y.push(O);var z=S.options&&S.options.ranges;typeof P.yy.parseError=="function"?this.parseError=P.yy.parseError:this.parseError=Object.getPrototypeOf(this).parseError;function d(L){l.length=l.length-2*L,x.length=x.length-L,y.length=y.length-L}g(d,"popStack");function E(){var L;return L=_.pop()||S.lex()||D,typeof L!="number"&&(L instanceof Array&&(_=L,L=_.pop()),L=o.symbols_[L]||L),L}g(E,"lex");for(var A,$,I,n,f={},u,c,r,m;;){if($=l[l.length-1],this.defaultActions[$]?I=this.defaultActions[$]:((A===null||typeof A>"u")&&(A=E()),I=v[$]&&v[$][A]),typeof I>"u"||!I.length||!I[0]){var w="";m=[];for(u in v[$])this.terminals_[u]&&u>C&&m.push("'"+this.terminals_[u]+"'");S.showPosition?w="Parse error on line "+(T+1)+`:
-`+S.showPosition()+`
-Expecting `+m.join(", ")+", got '"+(this.terminals_[A]||A)+"'":w="Parse error on line "+(T+1)+": Unexpected "+(A==D?"end of input":"'"+(this.terminals_[A]||A)+"'"),this.parseError(w,{text:S.match,token:this.terminals_[A]||A,line:S.yylineno,loc:O,expected:m})}if(I[0]instanceof Array&&I.length>1)throw new Error("Parse Error: multiple actions possible at state: "+$+", token: "+A);switch(I[0]){case 1:l.push(A),x.push(S.yytext),y.push(S.yylloc),l.push(I[1]),A=null,N=S.yyleng,M=S.yytext,T=S.yylineno,O=S.yylloc;break;case 2:if(c=this.productions_[I[1]][1],f.$=x[x.length-c],f._$={first_line:y[y.length-(c||1)].first_line,last_line:y[y.length-1].last_line,first_column:y[y.length-(c||1)].first_column,last_column:y[y.length-1].last_column},z&&(f._$.range=[y[y.length-(c||1)].range[0],y[y.length-1].range[1]]),n=this.performAction.apply(f,[M,N,T,P.yy,I[1],x,y].concat(R)),typeof n<"u")return n;c&&(l=l.slice(0,-1*c*2),x=x.slice(0,-1*c),y=y.slice(0,-1*c)),l.push(this.productions_[I[1]][0]),x.push(f.$),y.push(f._$),r=v[l[l.length-2]][l[l.length-1]],l.push(r);break;case 3:return!0}}return!0},"parse")},b=(function(){var k={EOF:1,parseError:g(function(o,l){if(this.yy.parser)this.yy.parser.parseError(o,l);else throw new Error(o)},"parseError"),setInput:g(function(s,o){return this.yy=o||this.yy||{},this._input=s,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},"setInput"),input:g(function(){var s=this._input[0];this.yytext+=s,this.yyleng++,this.offset++,this.match+=s,this.matched+=s;var o=s.match(/(?:\r\n?|\n).*/g);return o?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),s},"input"),unput:g(function(s){var o=s.length,l=s.split(/(?:\r\n?|\n)/g);this._input=s+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-o),this.offset-=o;var _=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),l.length-1&&(this.yylineno-=l.length-1);var x=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:l?(l.length===_.length?this.yylloc.first_column:0)+_[_.length-l.length].length-l[0].length:this.yylloc.first_column-o},this.options.ranges&&(this.yylloc.range=[x[0],x[0]+this.yyleng-o]),this.yyleng=this.yytext.length,this},"unput"),more:g(function(){return this._more=!0,this},"more"),reject:g(function(){if(this.options.backtrack_lexer)this._backtrack=!0;else return this.parseError("Lexical error on line "+(this.yylineno+1)+`. You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).
-`+this.showPosition(),{text:"",token:null,line:this.yylineno});return this},"reject"),less:g(function(s){this.unput(this.match.slice(s))},"less"),pastInput:g(function(){var s=this.matched.substr(0,this.matched.length-this.match.length);return(s.length>20?"...":"")+s.substr(-20).replace(/\n/g,"")},"pastInput"),upcomingInput:g(function(){var s=this.match;return s.length<20&&(s+=this._input.substr(0,20-s.length)),(s.substr(0,20)+(s.length>20?"...":"")).replace(/\n/g,"")},"upcomingInput"),showPosition:g(function(){var s=this.pastInput(),o=new Array(s.length+1).join("-");return s+this.upcomingInput()+`
-`+o+"^"},"showPosition"),test_match:g(function(s,o){var l,_,x;if(this.options.backtrack_lexer&&(x={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(x.yylloc.range=this.yylloc.range.slice(0))),_=s[0].match(/(?:\r\n?|\n).*/g),_&&(this.yylineno+=_.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:_?_[_.length-1].length-_[_.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+s[0].length},this.yytext+=s[0],this.match+=s[0],this.matches=s,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(s[0].length),this.matched+=s[0],l=this.performAction.call(this,this.yy,this,o,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),l)return l;if(this._backtrack){for(var y in x)this[y]=x[y];return!1}return!1},"test_match"),next:g(function(){if(this.done)return this.EOF;this._input||(this.done=!0);var s,o,l,_;this._more||(this.yytext="",this.match="");for(var x=this._currentRules(),y=0;y<x.length;y++)if(l=this._input.match(this.rules[x[y]]),l&&(!o||l[0].length>o[0].length)){if(o=l,_=y,this.options.backtrack_lexer){if(s=this.test_match(l,x[y]),s!==!1)return s;if(this._backtrack){o=!1;continue}else return!1}else if(!this.options.flex)break}return o?(s=this.test_match(o,x[_]),s!==!1?s:!1):this._input===""?this.EOF:this.parseError("Lexical error on line "+(this.yylineno+1)+`. Unrecognized text.
-`+this.showPosition(),{text:"",token:null,line:this.yylineno})},"next"),lex:g(function(){var o=this.next();return o||this.lex()},"lex"),begin:g(function(o){this.conditionStack.push(o)},"begin"),popState:g(function(){var o=this.conditionStack.length-1;return o>0?this.conditionStack.pop():this.conditionStack[0]},"popState"),_currentRules:g(function(){return this.conditionStack.length&&this.conditionStack[this.conditionStack.length-1]?this.conditions[this.conditionStack[this.conditionStack.length-1]].rules:this.conditions.INITIAL.rules},"_currentRules"),topState:g(function(o){return o=this.conditionStack.length-1-Math.abs(o||0),o>=0?this.conditionStack[o]:"INITIAL"},"topState"),pushState:g(function(o){this.begin(o)},"pushState"),stateStackSize:g(function(){return this.conditionStack.length},"stateStackSize"),options:{"case-insensitive":!0},performAction:g(function(o,l,_,x){switch(_){case 0:return this.pushState("csv"),4;case 1:return this.pushState("csv"),4;case 2:return 10;case 3:return 5;case 4:return 12;case 5:return this.pushState("escaped_text"),18;case 6:return 20;case 7:return this.popState("escaped_text"),18;case 8:return 19}},"anonymous"),rules:[/^(?:sankey-beta\b)/i,/^(?:sankey\b)/i,/^(?:$)/i,/^(?:((\u000D\u000A)|(\u000A)))/i,/^(?:(\u002C))/i,/^(?:(\u0022))/i,/^(?:([\u0020-\u0021\u0023-\u002B\u002D-\u007E])*)/i,/^(?:(\u0022)(?!(\u0022)))/i,/^(?:(([\u0020-\u0021\u0023-\u002B\u002D-\u007E])|(\u002C)|(\u000D)|(\u000A)|(\u0022)(\u0022))*)/i],conditions:{csv:{rules:[2,3,4,5,6,7,8],inclusive:!1},escaped_text:{rules:[7,8],inclusive:!1},INITIAL:{rules:[0,1,2,3,4,5,6,7,8],inclusive:!0}}};return k})();h.lexer=b;function p(){this.yy={}}return g(p,"Parser"),p.prototype=h,h.Parser=p,new p})();at.parser=at;var K=at,J=[],tt=[],Z=new Map,Zt=g(()=>{J=[],tt=[],Z=new Map,At()},"clear"),W,Jt=(W=class{constructor(e,i,a=0){this.source=e,this.target=i,this.value=a}},g(W,"SankeyLink"),W),te=g((t,e,i)=>{J.push(new Jt(t,e,i))},"addLink"),U,ee=(U=class{constructor(e){this.ID=e}},g(U,"SankeyNode"),U),ne=g(t=>{t=Tt.sanitizeText(t,lt());let e=Z.get(t);return e===void 0&&(e=new ee(t),Z.set(t,e),tt.push(e)),e},"findOrCreateNode"),ie=g(()=>tt,"getNodes"),se=g(()=>J,"getLinks"),re=g(()=>({nodes:tt.map(t=>({id:t.ID})),links:J.map(t=>({source:t.source.ID,target:t.target.ID,value:t.value}))}),"getGraph"),oe={nodesMap:Z,getConfig:g(()=>lt().sankey,"getConfig"),getNodes:ie,getLinks:se,getGraph:re,addLink:te,findOrCreateNode:ne,getAccTitle:St,setAccTitle:wt,getAccDescription:bt,setAccDescription:vt,getDiagramTitle:xt,setDiagramTitle:_t,clear:Zt},j,gt=(j=class{static next(e){return new j(e+ ++j.count)}constructor(e){this.id=e,this.href=`#${e}`}toString(){return"url("+this.href+")"}},g(j,"Uid"),j.count=0,j),ae={left:Ct,right:Ot,center:zt,justify:mt},le=g(function(t,e,i,a){const{securityLevel:h,sankey:b}=lt(),p=Lt.sankey;let k;h==="sandbox"&&(k=H("#i"+e));const s=h==="sandbox"?H(k.nodes()[0].contentDocument.body):H("body"),o=h==="sandbox"?s.select(`[id="${e}"]`):H(`[id="${e}"]`),l=b?.width??p.width,_=b?.height??p.width,x=b?.useMaxWidth??p.useMaxWidth,y=b?.nodeAlignment??p.nodeAlignment,v=b?.prefix??p.prefix,M=b?.suffix??p.suffix,T=b?.showValues??p.showValues,N=a.db.getGraph(),C=ae[y];Bt().nodeId(d=>d.id).nodeWidth(10).nodePadding(10+(T?15:0)).nodeAlign(C).extent([[0,0],[l,_]])(N);const S=Mt(It);o.append("g").attr("class","nodes").selectAll(".node").data(N.nodes).join("g").attr("class","node").attr("id",d=>(d.uid=gt.next("node-")).id).attr("transform",function(d){return"translate("+d.x0+","+d.y0+")"}).attr("x",d=>d.x0).attr("y",d=>d.y0).append("rect").attr("height",d=>d.y1-d.y0).attr("width",d=>d.x1-d.x0).attr("fill",d=>S(d.id));const P=g(({id:d,value:E})=>T?`${d}
-${v}${Math.round(E*100)/100}${M}`:d,"getText");o.append("g").attr("class","node-labels").attr("font-size",14).selectAll("text").data(N.nodes).join("text").attr("x",d=>d.x0<l/2?d.x1+6:d.x0-6).attr("y",d=>(d.y1+d.y0)/2).attr("dy",`${T?"0":"0.35"}em`).attr("text-anchor",d=>d.x0<l/2?"start":"end").text(P);const B=o.append("g").attr("class","links").attr("fill","none").attr("stroke-opacity",.5).selectAll(".link").data(N.links).join("g").attr("class","link").style("mix-blend-mode","multiply"),O=b?.linkColor??"gradient";if(O==="gradient"){const d=B.append("linearGradient").attr("id",E=>(E.uid=gt.next("linearGradient-")).id).attr("gradientUnits","userSpaceOnUse").attr("x1",E=>E.source.x1).attr("x2",E=>E.target.x0);d.append("stop").attr("offset","0%").attr("stop-color",E=>S(E.source.id)),d.append("stop").attr("offset","100%").attr("stop-color",E=>S(E.target.id))}let z;switch(O){case"gradient":z=g(d=>d.uid,"coloring");break;case"source":z=g(d=>S(d.source.id),"coloring");break;case"target":z=g(d=>S(d.target.id),"coloring");break;default:z=O}B.append("path").attr("d",Kt()).attr("stroke",z).attr("stroke-width",d=>Math.max(1,d.width)),Et(void 0,o,0,x)},"draw"),ce={draw:le},ue=g(t=>t.replaceAll(/^[^\S\n\r]+|[^\S\n\r]+$/g,"").replaceAll(/([\n\r])+/g,`
-`).trim(),"prepareTextForParsing"),he=g(t=>`.label {
-      font-family: ${t.fontFamily};
-    }`,"getStyles"),fe=he,ye=K.parse.bind(K);K.parse=t=>ye(ue(t));var me={styles:fe,parser:K,db:oe,renderer:ce};export{me as diagram};
diff --git a/docs/dist/assets/sequenceDiagram-WL72ISMW-C4G5dCz-.js b/docs/dist/assets/sequenceDiagram-WL72ISMW-C4G5dCz-.js
deleted file mode 100644
index 04bde08b..00000000
--- a/docs/dist/assets/sequenceDiagram-WL72ISMW-C4G5dCz-.js
+++ /dev/null
@@ -1,145 +0,0 @@
-import{a as we,b as Xt,g as ct,d as ve,c as Jt,e as Qt}from"./chunk-TZMSLE5B-BkTUbDII.js";import{_ as f,n as Ie,c as st,d as St,l as Q,j as re,e as Le,f as _e,k as I,b as se,s as Ae,p as ke,a as Pe,g as Ne,q as Se,t as Me,J as Re,y as De,i as Mt,u as W,L as z,M as _t,N as ie,Z as Ce,O as Oe,P as ne,E as Ht}from"./index-BxX29htg.js";import{I as Be}from"./chunk-QZHKN3VN-CEAug577.js";var Ut=(function(){var e=f(function(pt,v,A,L){for(A=A||{},L=pt.length;L--;A[pt[L]]=v);return A},"o"),t=[1,2],n=[1,3],s=[1,4],r=[2,4],i=[1,9],c=[1,11],h=[1,13],o=[1,14],a=[1,16],p=[1,17],g=[1,18],x=[1,24],y=[1,25],m=[1,26],w=[1,27],k=[1,28],N=[1,29],S=[1,30],O=[1,31],B=[1,32],q=[1,33],H=[1,34],Z=[1,35],at=[1,36],U=[1,37],G=[1,38],F=[1,39],D=[1,41],$=[1,42],K=[1,43],j=[1,44],rt=[1,45],R=[1,46],E=[1,4,5,13,14,16,18,21,23,29,30,31,33,35,36,37,38,39,41,43,44,46,47,48,49,50,52,53,55,60,61,62,63,71],_=[2,71],X=[4,5,16,50,52,53],tt=[4,5,13,14,16,18,21,23,29,30,31,33,35,36,37,38,39,41,43,44,46,50,52,53,55,60,61,62,63,71],M=[4,5,13,14,16,18,21,23,29,30,31,33,35,36,37,38,39,41,43,44,46,49,50,52,53,55,60,61,62,63,71],Vt=[4,5,13,14,16,18,21,23,29,30,31,33,35,36,37,38,39,41,43,44,46,48,50,52,53,55,60,61,62,63,71],Zt=[4,5,13,14,16,18,21,23,29,30,31,33,35,36,37,38,39,41,43,44,46,47,50,52,53,55,60,61,62,63,71],ot=[69,70,71],lt=[1,127],Yt={trace:f(function(){},"trace"),yy:{},symbols_:{error:2,start:3,SPACE:4,NEWLINE:5,SD:6,document:7,line:8,statement:9,box_section:10,box_line:11,participant_statement:12,create:13,box:14,restOfLine:15,end:16,signal:17,autonumber:18,NUM:19,off:20,activate:21,actor:22,deactivate:23,note_statement:24,links_statement:25,link_statement:26,properties_statement:27,details_statement:28,title:29,legacy_title:30,acc_title:31,acc_title_value:32,acc_descr:33,acc_descr_value:34,acc_descr_multiline_value:35,loop:36,rect:37,opt:38,alt:39,else_sections:40,par:41,par_sections:42,par_over:43,critical:44,option_sections:45,break:46,option:47,and:48,else:49,participant:50,AS:51,participant_actor:52,destroy:53,actor_with_config:54,note:55,placement:56,text2:57,over:58,actor_pair:59,links:60,link:61,properties:62,details:63,spaceList:64,",":65,left_of:66,right_of:67,signaltype:68,"+":69,"-":70,ACTOR:71,config_object:72,CONFIG_START:73,CONFIG_CONTENT:74,CONFIG_END:75,SOLID_OPEN_ARROW:76,DOTTED_OPEN_ARROW:77,SOLID_ARROW:78,BIDIRECTIONAL_SOLID_ARROW:79,DOTTED_ARROW:80,BIDIRECTIONAL_DOTTED_ARROW:81,SOLID_CROSS:82,DOTTED_CROSS:83,SOLID_POINT:84,DOTTED_POINT:85,TXT:86,$accept:0,$end:1},terminals_:{2:"error",4:"SPACE",5:"NEWLINE",6:"SD",13:"create",14:"box",15:"restOfLine",16:"end",18:"autonumber",19:"NUM",20:"off",21:"activate",23:"deactivate",29:"title",30:"legacy_title",31:"acc_title",32:"acc_title_value",33:"acc_descr",34:"acc_descr_value",35:"acc_descr_multiline_value",36:"loop",37:"rect",38:"opt",39:"alt",41:"par",43:"par_over",44:"critical",46:"break",47:"option",48:"and",49:"else",50:"participant",51:"AS",52:"participant_actor",53:"destroy",55:"note",58:"over",60:"links",61:"link",62:"properties",63:"details",65:",",66:"left_of",67:"right_of",69:"+",70:"-",71:"ACTOR",73:"CONFIG_START",74:"CONFIG_CONTENT",75:"CONFIG_END",76:"SOLID_OPEN_ARROW",77:"DOTTED_OPEN_ARROW",78:"SOLID_ARROW",79:"BIDIRECTIONAL_SOLID_ARROW",80:"DOTTED_ARROW",81:"BIDIRECTIONAL_DOTTED_ARROW",82:"SOLID_CROSS",83:"DOTTED_CROSS",84:"SOLID_POINT",85:"DOTTED_POINT",86:"TXT"},productions_:[0,[3,2],[3,2],[3,2],[7,0],[7,2],[8,2],[8,1],[8,1],[10,0],[10,2],[11,2],[11,1],[11,1],[9,1],[9,2],[9,4],[9,2],[9,4],[9,3],[9,3],[9,2],[9,3],[9,3],[9,2],[9,2],[9,2],[9,2],[9,2],[9,1],[9,1],[9,2],[9,2],[9,1],[9,4],[9,4],[9,4],[9,4],[9,4],[9,4],[9,4],[9,4],[45,1],[45,4],[42,1],[42,4],[40,1],[40,4],[12,5],[12,3],[12,5],[12,3],[12,3],[12,3],[24,4],[24,4],[25,3],[26,3],[27,3],[28,3],[64,2],[64,1],[59,3],[59,1],[56,1],[56,1],[17,5],[17,5],[17,4],[54,2],[72,3],[22,1],[68,1],[68,1],[68,1],[68,1],[68,1],[68,1],[68,1],[68,1],[68,1],[68,1],[57,1]],performAction:f(function(v,A,L,b,C,d,It){var u=d.length-1;switch(C){case 3:return b.apply(d[u]),d[u];case 4:case 9:this.$=[];break;case 5:case 10:d[u-1].push(d[u]),this.$=d[u-1];break;case 6:case 7:case 11:case 12:this.$=d[u];break;case 8:case 13:this.$=[];break;case 15:d[u].type="createParticipant",this.$=d[u];break;case 16:d[u-1].unshift({type:"boxStart",boxData:b.parseBoxData(d[u-2])}),d[u-1].push({type:"boxEnd",boxText:d[u-2]}),this.$=d[u-1];break;case 18:this.$={type:"sequenceIndex",sequenceIndex:Number(d[u-2]),sequenceIndexStep:Number(d[u-1]),sequenceVisible:!0,signalType:b.LINETYPE.AUTONUMBER};break;case 19:this.$={type:"sequenceIndex",sequenceIndex:Number(d[u-1]),sequenceIndexStep:1,sequenceVisible:!0,signalType:b.LINETYPE.AUTONUMBER};break;case 20:this.$={type:"sequenceIndex",sequenceVisible:!1,signalType:b.LINETYPE.AUTONUMBER};break;case 21:this.$={type:"sequenceIndex",sequenceVisible:!0,signalType:b.LINETYPE.AUTONUMBER};break;case 22:this.$={type:"activeStart",signalType:b.LINETYPE.ACTIVE_START,actor:d[u-1].actor};break;case 23:this.$={type:"activeEnd",signalType:b.LINETYPE.ACTIVE_END,actor:d[u-1].actor};break;case 29:b.setDiagramTitle(d[u].substring(6)),this.$=d[u].substring(6);break;case 30:b.setDiagramTitle(d[u].substring(7)),this.$=d[u].substring(7);break;case 31:this.$=d[u].trim(),b.setAccTitle(this.$);break;case 32:case 33:this.$=d[u].trim(),b.setAccDescription(this.$);break;case 34:d[u-1].unshift({type:"loopStart",loopText:b.parseMessage(d[u-2]),signalType:b.LINETYPE.LOOP_START}),d[u-1].push({type:"loopEnd",loopText:d[u-2],signalType:b.LINETYPE.LOOP_END}),this.$=d[u-1];break;case 35:d[u-1].unshift({type:"rectStart",color:b.parseMessage(d[u-2]),signalType:b.LINETYPE.RECT_START}),d[u-1].push({type:"rectEnd",color:b.parseMessage(d[u-2]),signalType:b.LINETYPE.RECT_END}),this.$=d[u-1];break;case 36:d[u-1].unshift({type:"optStart",optText:b.parseMessage(d[u-2]),signalType:b.LINETYPE.OPT_START}),d[u-1].push({type:"optEnd",optText:b.parseMessage(d[u-2]),signalType:b.LINETYPE.OPT_END}),this.$=d[u-1];break;case 37:d[u-1].unshift({type:"altStart",altText:b.parseMessage(d[u-2]),signalType:b.LINETYPE.ALT_START}),d[u-1].push({type:"altEnd",signalType:b.LINETYPE.ALT_END}),this.$=d[u-1];break;case 38:d[u-1].unshift({type:"parStart",parText:b.parseMessage(d[u-2]),signalType:b.LINETYPE.PAR_START}),d[u-1].push({type:"parEnd",signalType:b.LINETYPE.PAR_END}),this.$=d[u-1];break;case 39:d[u-1].unshift({type:"parStart",parText:b.parseMessage(d[u-2]),signalType:b.LINETYPE.PAR_OVER_START}),d[u-1].push({type:"parEnd",signalType:b.LINETYPE.PAR_END}),this.$=d[u-1];break;case 40:d[u-1].unshift({type:"criticalStart",criticalText:b.parseMessage(d[u-2]),signalType:b.LINETYPE.CRITICAL_START}),d[u-1].push({type:"criticalEnd",signalType:b.LINETYPE.CRITICAL_END}),this.$=d[u-1];break;case 41:d[u-1].unshift({type:"breakStart",breakText:b.parseMessage(d[u-2]),signalType:b.LINETYPE.BREAK_START}),d[u-1].push({type:"breakEnd",optText:b.parseMessage(d[u-2]),signalType:b.LINETYPE.BREAK_END}),this.$=d[u-1];break;case 43:this.$=d[u-3].concat([{type:"option",optionText:b.parseMessage(d[u-1]),signalType:b.LINETYPE.CRITICAL_OPTION},d[u]]);break;case 45:this.$=d[u-3].concat([{type:"and",parText:b.parseMessage(d[u-1]),signalType:b.LINETYPE.PAR_AND},d[u]]);break;case 47:this.$=d[u-3].concat([{type:"else",altText:b.parseMessage(d[u-1]),signalType:b.LINETYPE.ALT_ELSE},d[u]]);break;case 48:d[u-3].draw="participant",d[u-3].type="addParticipant",d[u-3].description=b.parseMessage(d[u-1]),this.$=d[u-3];break;case 49:d[u-1].draw="participant",d[u-1].type="addParticipant",this.$=d[u-1];break;case 50:d[u-3].draw="actor",d[u-3].type="addParticipant",d[u-3].description=b.parseMessage(d[u-1]),this.$=d[u-3];break;case 51:d[u-1].draw="actor",d[u-1].type="addParticipant",this.$=d[u-1];break;case 52:d[u-1].type="destroyParticipant",this.$=d[u-1];break;case 53:d[u-1].draw="participant",d[u-1].type="addParticipant",this.$=d[u-1];break;case 54:this.$=[d[u-1],{type:"addNote",placement:d[u-2],actor:d[u-1].actor,text:d[u]}];break;case 55:d[u-2]=[].concat(d[u-1],d[u-1]).slice(0,2),d[u-2][0]=d[u-2][0].actor,d[u-2][1]=d[u-2][1].actor,this.$=[d[u-1],{type:"addNote",placement:b.PLACEMENT.OVER,actor:d[u-2].slice(0,2),text:d[u]}];break;case 56:this.$=[d[u-1],{type:"addLinks",actor:d[u-1].actor,text:d[u]}];break;case 57:this.$=[d[u-1],{type:"addALink",actor:d[u-1].actor,text:d[u]}];break;case 58:this.$=[d[u-1],{type:"addProperties",actor:d[u-1].actor,text:d[u]}];break;case 59:this.$=[d[u-1],{type:"addDetails",actor:d[u-1].actor,text:d[u]}];break;case 62:this.$=[d[u-2],d[u]];break;case 63:this.$=d[u];break;case 64:this.$=b.PLACEMENT.LEFTOF;break;case 65:this.$=b.PLACEMENT.RIGHTOF;break;case 66:this.$=[d[u-4],d[u-1],{type:"addMessage",from:d[u-4].actor,to:d[u-1].actor,signalType:d[u-3],msg:d[u],activate:!0},{type:"activeStart",signalType:b.LINETYPE.ACTIVE_START,actor:d[u-1].actor}];break;case 67:this.$=[d[u-4],d[u-1],{type:"addMessage",from:d[u-4].actor,to:d[u-1].actor,signalType:d[u-3],msg:d[u]},{type:"activeEnd",signalType:b.LINETYPE.ACTIVE_END,actor:d[u-4].actor}];break;case 68:this.$=[d[u-3],d[u-1],{type:"addMessage",from:d[u-3].actor,to:d[u-1].actor,signalType:d[u-2],msg:d[u]}];break;case 69:this.$={type:"addParticipant",actor:d[u-1],config:d[u]};break;case 70:this.$=d[u-1].trim();break;case 71:this.$={type:"addParticipant",actor:d[u]};break;case 72:this.$=b.LINETYPE.SOLID_OPEN;break;case 73:this.$=b.LINETYPE.DOTTED_OPEN;break;case 74:this.$=b.LINETYPE.SOLID;break;case 75:this.$=b.LINETYPE.BIDIRECTIONAL_SOLID;break;case 76:this.$=b.LINETYPE.DOTTED;break;case 77:this.$=b.LINETYPE.BIDIRECTIONAL_DOTTED;break;case 78:this.$=b.LINETYPE.SOLID_CROSS;break;case 79:this.$=b.LINETYPE.DOTTED_CROSS;break;case 80:this.$=b.LINETYPE.SOLID_POINT;break;case 81:this.$=b.LINETYPE.DOTTED_POINT;break;case 82:this.$=b.parseMessage(d[u].trim().substring(1));break}},"anonymous"),table:[{3:1,4:t,5:n,6:s},{1:[3]},{3:5,4:t,5:n,6:s},{3:6,4:t,5:n,6:s},e([1,4,5,13,14,18,21,23,29,30,31,33,35,36,37,38,39,41,43,44,46,50,52,53,55,60,61,62,63,71],r,{7:7}),{1:[2,1]},{1:[2,2]},{1:[2,3],4:i,5:c,8:8,9:10,12:12,13:h,14:o,17:15,18:a,21:p,22:40,23:g,24:19,25:20,26:21,27:22,28:23,29:x,30:y,31:m,33:w,35:k,36:N,37:S,38:O,39:B,41:q,43:H,44:Z,46:at,50:U,52:G,53:F,55:D,60:$,61:K,62:j,63:rt,71:R},e(E,[2,5]),{9:47,12:12,13:h,14:o,17:15,18:a,21:p,22:40,23:g,24:19,25:20,26:21,27:22,28:23,29:x,30:y,31:m,33:w,35:k,36:N,37:S,38:O,39:B,41:q,43:H,44:Z,46:at,50:U,52:G,53:F,55:D,60:$,61:K,62:j,63:rt,71:R},e(E,[2,7]),e(E,[2,8]),e(E,[2,14]),{12:48,50:U,52:G,53:F},{15:[1,49]},{5:[1,50]},{5:[1,53],19:[1,51],20:[1,52]},{22:54,71:R},{22:55,71:R},{5:[1,56]},{5:[1,57]},{5:[1,58]},{5:[1,59]},{5:[1,60]},e(E,[2,29]),e(E,[2,30]),{32:[1,61]},{34:[1,62]},e(E,[2,33]),{15:[1,63]},{15:[1,64]},{15:[1,65]},{15:[1,66]},{15:[1,67]},{15:[1,68]},{15:[1,69]},{15:[1,70]},{22:71,54:72,71:[1,73]},{22:74,71:R},{22:75,71:R},{68:76,76:[1,77],77:[1,78],78:[1,79],79:[1,80],80:[1,81],81:[1,82],82:[1,83],83:[1,84],84:[1,85],85:[1,86]},{56:87,58:[1,88],66:[1,89],67:[1,90]},{22:91,71:R},{22:92,71:R},{22:93,71:R},{22:94,71:R},e([5,51,65,76,77,78,79,80,81,82,83,84,85,86],_),e(E,[2,6]),e(E,[2,15]),e(X,[2,9],{10:95}),e(E,[2,17]),{5:[1,97],19:[1,96]},{5:[1,98]},e(E,[2,21]),{5:[1,99]},{5:[1,100]},e(E,[2,24]),e(E,[2,25]),e(E,[2,26]),e(E,[2,27]),e(E,[2,28]),e(E,[2,31]),e(E,[2,32]),e(tt,r,{7:101}),e(tt,r,{7:102}),e(tt,r,{7:103}),e(M,r,{40:104,7:105}),e(Vt,r,{42:106,7:107}),e(Vt,r,{7:107,42:108}),e(Zt,r,{45:109,7:110}),e(tt,r,{7:111}),{5:[1,113],51:[1,112]},{5:[1,114]},e([5,51],_,{72:115,73:[1,116]}),{5:[1,118],51:[1,117]},{5:[1,119]},{22:122,69:[1,120],70:[1,121],71:R},e(ot,[2,72]),e(ot,[2,73]),e(ot,[2,74]),e(ot,[2,75]),e(ot,[2,76]),e(ot,[2,77]),e(ot,[2,78]),e(ot,[2,79]),e(ot,[2,80]),e(ot,[2,81]),{22:123,71:R},{22:125,59:124,71:R},{71:[2,64]},{71:[2,65]},{57:126,86:lt},{57:128,86:lt},{57:129,86:lt},{57:130,86:lt},{4:[1,133],5:[1,135],11:132,12:134,16:[1,131],50:U,52:G,53:F},{5:[1,136]},e(E,[2,19]),e(E,[2,20]),e(E,[2,22]),e(E,[2,23]),{4:i,5:c,8:8,9:10,12:12,13:h,14:o,16:[1,137],17:15,18:a,21:p,22:40,23:g,24:19,25:20,26:21,27:22,28:23,29:x,30:y,31:m,33:w,35:k,36:N,37:S,38:O,39:B,41:q,43:H,44:Z,46:at,50:U,52:G,53:F,55:D,60:$,61:K,62:j,63:rt,71:R},{4:i,5:c,8:8,9:10,12:12,13:h,14:o,16:[1,138],17:15,18:a,21:p,22:40,23:g,24:19,25:20,26:21,27:22,28:23,29:x,30:y,31:m,33:w,35:k,36:N,37:S,38:O,39:B,41:q,43:H,44:Z,46:at,50:U,52:G,53:F,55:D,60:$,61:K,62:j,63:rt,71:R},{4:i,5:c,8:8,9:10,12:12,13:h,14:o,16:[1,139],17:15,18:a,21:p,22:40,23:g,24:19,25:20,26:21,27:22,28:23,29:x,30:y,31:m,33:w,35:k,36:N,37:S,38:O,39:B,41:q,43:H,44:Z,46:at,50:U,52:G,53:F,55:D,60:$,61:K,62:j,63:rt,71:R},{16:[1,140]},{4:i,5:c,8:8,9:10,12:12,13:h,14:o,16:[2,46],17:15,18:a,21:p,22:40,23:g,24:19,25:20,26:21,27:22,28:23,29:x,30:y,31:m,33:w,35:k,36:N,37:S,38:O,39:B,41:q,43:H,44:Z,46:at,49:[1,141],50:U,52:G,53:F,55:D,60:$,61:K,62:j,63:rt,71:R},{16:[1,142]},{4:i,5:c,8:8,9:10,12:12,13:h,14:o,16:[2,44],17:15,18:a,21:p,22:40,23:g,24:19,25:20,26:21,27:22,28:23,29:x,30:y,31:m,33:w,35:k,36:N,37:S,38:O,39:B,41:q,43:H,44:Z,46:at,48:[1,143],50:U,52:G,53:F,55:D,60:$,61:K,62:j,63:rt,71:R},{16:[1,144]},{16:[1,145]},{4:i,5:c,8:8,9:10,12:12,13:h,14:o,16:[2,42],17:15,18:a,21:p,22:40,23:g,24:19,25:20,26:21,27:22,28:23,29:x,30:y,31:m,33:w,35:k,36:N,37:S,38:O,39:B,41:q,43:H,44:Z,46:at,47:[1,146],50:U,52:G,53:F,55:D,60:$,61:K,62:j,63:rt,71:R},{4:i,5:c,8:8,9:10,12:12,13:h,14:o,16:[1,147],17:15,18:a,21:p,22:40,23:g,24:19,25:20,26:21,27:22,28:23,29:x,30:y,31:m,33:w,35:k,36:N,37:S,38:O,39:B,41:q,43:H,44:Z,46:at,50:U,52:G,53:F,55:D,60:$,61:K,62:j,63:rt,71:R},{15:[1,148]},e(E,[2,49]),e(E,[2,53]),{5:[2,69]},{74:[1,149]},{15:[1,150]},e(E,[2,51]),e(E,[2,52]),{22:151,71:R},{22:152,71:R},{57:153,86:lt},{57:154,86:lt},{57:155,86:lt},{65:[1,156],86:[2,63]},{5:[2,56]},{5:[2,82]},{5:[2,57]},{5:[2,58]},{5:[2,59]},e(E,[2,16]),e(X,[2,10]),{12:157,50:U,52:G,53:F},e(X,[2,12]),e(X,[2,13]),e(E,[2,18]),e(E,[2,34]),e(E,[2,35]),e(E,[2,36]),e(E,[2,37]),{15:[1,158]},e(E,[2,38]),{15:[1,159]},e(E,[2,39]),e(E,[2,40]),{15:[1,160]},e(E,[2,41]),{5:[1,161]},{75:[1,162]},{5:[1,163]},{57:164,86:lt},{57:165,86:lt},{5:[2,68]},{5:[2,54]},{5:[2,55]},{22:166,71:R},e(X,[2,11]),e(M,r,{7:105,40:167}),e(Vt,r,{7:107,42:168}),e(Zt,r,{7:110,45:169}),e(E,[2,48]),{5:[2,70]},e(E,[2,50]),{5:[2,66]},{5:[2,67]},{86:[2,62]},{16:[2,47]},{16:[2,45]},{16:[2,43]}],defaultActions:{5:[2,1],6:[2,2],89:[2,64],90:[2,65],115:[2,69],126:[2,56],127:[2,82],128:[2,57],129:[2,58],130:[2,59],153:[2,68],154:[2,54],155:[2,55],162:[2,70],164:[2,66],165:[2,67],166:[2,62],167:[2,47],168:[2,45],169:[2,43]},parseError:f(function(v,A){if(A.recoverable)this.trace(v);else{var L=new Error(v);throw L.hash=A,L}},"parseError"),parse:f(function(v){var A=this,L=[0],b=[],C=[null],d=[],It=this.table,u="",kt=0,$t=0,Te=2,jt=1,Ee=d.slice.call(arguments,1),Y=Object.create(this.lexer),ft={yy:{}};for(var Wt in this.yy)Object.prototype.hasOwnProperty.call(this.yy,Wt)&&(ft.yy[Wt]=this.yy[Wt]);Y.setInput(v,ft.yy),ft.yy.lexer=Y,ft.yy.parser=this,typeof Y.yylloc>"u"&&(Y.yylloc={});var Ft=Y.yylloc;d.push(Ft);var be=Y.options&&Y.options.ranges;typeof ft.yy.parseError=="function"?this.parseError=ft.yy.parseError:this.parseError=Object.getPrototypeOf(this).parseError;function me(et){L.length=L.length-2*et,C.length=C.length-et,d.length=d.length-et}f(me,"popStack");function te(){var et;return et=b.pop()||Y.lex()||jt,typeof et!="number"&&(et instanceof Array&&(b=et,et=b.pop()),et=A.symbols_[et]||et),et}f(te,"lex");for(var J,yt,it,qt,bt={},Pt,ht,ee,Nt;;){if(yt=L[L.length-1],this.defaultActions[yt]?it=this.defaultActions[yt]:((J===null||typeof J>"u")&&(J=te()),it=It[yt]&&It[yt][J]),typeof it>"u"||!it.length||!it[0]){var zt="";Nt=[];for(Pt in It[yt])this.terminals_[Pt]&&Pt>Te&&Nt.push("'"+this.terminals_[Pt]+"'");Y.showPosition?zt="Parse error on line "+(kt+1)+`:
-`+Y.showPosition()+`
-Expecting `+Nt.join(", ")+", got '"+(this.terminals_[J]||J)+"'":zt="Parse error on line "+(kt+1)+": Unexpected "+(J==jt?"end of input":"'"+(this.terminals_[J]||J)+"'"),this.parseError(zt,{text:Y.match,token:this.terminals_[J]||J,line:Y.yylineno,loc:Ft,expected:Nt})}if(it[0]instanceof Array&&it.length>1)throw new Error("Parse Error: multiple actions possible at state: "+yt+", token: "+J);switch(it[0]){case 1:L.push(J),C.push(Y.yytext),d.push(Y.yylloc),L.push(it[1]),J=null,$t=Y.yyleng,u=Y.yytext,kt=Y.yylineno,Ft=Y.yylloc;break;case 2:if(ht=this.productions_[it[1]][1],bt.$=C[C.length-ht],bt._$={first_line:d[d.length-(ht||1)].first_line,last_line:d[d.length-1].last_line,first_column:d[d.length-(ht||1)].first_column,last_column:d[d.length-1].last_column},be&&(bt._$.range=[d[d.length-(ht||1)].range[0],d[d.length-1].range[1]]),qt=this.performAction.apply(bt,[u,$t,kt,ft.yy,it[1],C,d].concat(Ee)),typeof qt<"u")return qt;ht&&(L=L.slice(0,-1*ht*2),C=C.slice(0,-1*ht),d=d.slice(0,-1*ht)),L.push(this.productions_[it[1]][0]),C.push(bt.$),d.push(bt._$),ee=It[L[L.length-2]][L[L.length-1]],L.push(ee);break;case 3:return!0}}return!0},"parse")},ye=(function(){var pt={EOF:1,parseError:f(function(A,L){if(this.yy.parser)this.yy.parser.parseError(A,L);else throw new Error(A)},"parseError"),setInput:f(function(v,A){return this.yy=A||this.yy||{},this._input=v,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},"setInput"),input:f(function(){var v=this._input[0];this.yytext+=v,this.yyleng++,this.offset++,this.match+=v,this.matched+=v;var A=v.match(/(?:\r\n?|\n).*/g);return A?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),v},"input"),unput:f(function(v){var A=v.length,L=v.split(/(?:\r\n?|\n)/g);this._input=v+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-A),this.offset-=A;var b=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),L.length-1&&(this.yylineno-=L.length-1);var C=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:L?(L.length===b.length?this.yylloc.first_column:0)+b[b.length-L.length].length-L[0].length:this.yylloc.first_column-A},this.options.ranges&&(this.yylloc.range=[C[0],C[0]+this.yyleng-A]),this.yyleng=this.yytext.length,this},"unput"),more:f(function(){return this._more=!0,this},"more"),reject:f(function(){if(this.options.backtrack_lexer)this._backtrack=!0;else return this.parseError("Lexical error on line "+(this.yylineno+1)+`. You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).
-`+this.showPosition(),{text:"",token:null,line:this.yylineno});return this},"reject"),less:f(function(v){this.unput(this.match.slice(v))},"less"),pastInput:f(function(){var v=this.matched.substr(0,this.matched.length-this.match.length);return(v.length>20?"...":"")+v.substr(-20).replace(/\n/g,"")},"pastInput"),upcomingInput:f(function(){var v=this.match;return v.length<20&&(v+=this._input.substr(0,20-v.length)),(v.substr(0,20)+(v.length>20?"...":"")).replace(/\n/g,"")},"upcomingInput"),showPosition:f(function(){var v=this.pastInput(),A=new Array(v.length+1).join("-");return v+this.upcomingInput()+`
-`+A+"^"},"showPosition"),test_match:f(function(v,A){var L,b,C;if(this.options.backtrack_lexer&&(C={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(C.yylloc.range=this.yylloc.range.slice(0))),b=v[0].match(/(?:\r\n?|\n).*/g),b&&(this.yylineno+=b.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:b?b[b.length-1].length-b[b.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+v[0].length},this.yytext+=v[0],this.match+=v[0],this.matches=v,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(v[0].length),this.matched+=v[0],L=this.performAction.call(this,this.yy,this,A,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),L)return L;if(this._backtrack){for(var d in C)this[d]=C[d];return!1}return!1},"test_match"),next:f(function(){if(this.done)return this.EOF;this._input||(this.done=!0);var v,A,L,b;this._more||(this.yytext="",this.match="");for(var C=this._currentRules(),d=0;d<C.length;d++)if(L=this._input.match(this.rules[C[d]]),L&&(!A||L[0].length>A[0].length)){if(A=L,b=d,this.options.backtrack_lexer){if(v=this.test_match(L,C[d]),v!==!1)return v;if(this._backtrack){A=!1;continue}else return!1}else if(!this.options.flex)break}return A?(v=this.test_match(A,C[b]),v!==!1?v:!1):this._input===""?this.EOF:this.parseError("Lexical error on line "+(this.yylineno+1)+`. Unrecognized text.
-`+this.showPosition(),{text:"",token:null,line:this.yylineno})},"next"),lex:f(function(){var A=this.next();return A||this.lex()},"lex"),begin:f(function(A){this.conditionStack.push(A)},"begin"),popState:f(function(){var A=this.conditionStack.length-1;return A>0?this.conditionStack.pop():this.conditionStack[0]},"popState"),_currentRules:f(function(){return this.conditionStack.length&&this.conditionStack[this.conditionStack.length-1]?this.conditions[this.conditionStack[this.conditionStack.length-1]].rules:this.conditions.INITIAL.rules},"_currentRules"),topState:f(function(A){return A=this.conditionStack.length-1-Math.abs(A||0),A>=0?this.conditionStack[A]:"INITIAL"},"topState"),pushState:f(function(A){this.begin(A)},"pushState"),stateStackSize:f(function(){return this.conditionStack.length},"stateStackSize"),options:{"case-insensitive":!0},performAction:f(function(A,L,b,C){switch(b){case 0:return 5;case 1:break;case 2:break;case 3:break;case 4:break;case 5:break;case 6:return 19;case 7:return this.begin("CONFIG"),73;case 8:return 74;case 9:return this.popState(),this.popState(),75;case 10:return L.yytext=L.yytext.trim(),71;case 11:return L.yytext=L.yytext.trim(),this.begin("ALIAS"),71;case 12:return this.begin("LINE"),14;case 13:return this.begin("ID"),50;case 14:return this.begin("ID"),52;case 15:return 13;case 16:return this.begin("ID"),53;case 17:return L.yytext=L.yytext.trim(),this.begin("ALIAS"),71;case 18:return this.popState(),this.popState(),this.begin("LINE"),51;case 19:return this.popState(),this.popState(),5;case 20:return this.begin("LINE"),36;case 21:return this.begin("LINE"),37;case 22:return this.begin("LINE"),38;case 23:return this.begin("LINE"),39;case 24:return this.begin("LINE"),49;case 25:return this.begin("LINE"),41;case 26:return this.begin("LINE"),43;case 27:return this.begin("LINE"),48;case 28:return this.begin("LINE"),44;case 29:return this.begin("LINE"),47;case 30:return this.begin("LINE"),46;case 31:return this.popState(),15;case 32:return 16;case 33:return 66;case 34:return 67;case 35:return 60;case 36:return 61;case 37:return 62;case 38:return 63;case 39:return 58;case 40:return 55;case 41:return this.begin("ID"),21;case 42:return this.begin("ID"),23;case 43:return 29;case 44:return 30;case 45:return this.begin("acc_title"),31;case 46:return this.popState(),"acc_title_value";case 47:return this.begin("acc_descr"),33;case 48:return this.popState(),"acc_descr_value";case 49:this.begin("acc_descr_multiline");break;case 50:this.popState();break;case 51:return"acc_descr_multiline_value";case 52:return 6;case 53:return 18;case 54:return 20;case 55:return 65;case 56:return 5;case 57:return L.yytext=L.yytext.trim(),71;case 58:return 78;case 59:return 79;case 60:return 80;case 61:return 81;case 62:return 76;case 63:return 77;case 64:return 82;case 65:return 83;case 66:return 84;case 67:return 85;case 68:return 86;case 69:return 86;case 70:return 69;case 71:return 70;case 72:return 5;case 73:return"INVALID"}},"anonymous"),rules:[/^(?:[\n]+)/i,/^(?:\s+)/i,/^(?:((?!\n)\s)+)/i,/^(?:#[^\n]*)/i,/^(?:%(?!\{)[^\n]*)/i,/^(?:[^\}]%%[^\n]*)/i,/^(?:[0-9]+(?=[ \n]+))/i,/^(?:@\{)/i,/^(?:[^\}]+)/i,/^(?:\})/i,/^(?:[^\<->\->:\n,;@\s]+(?=@\{))/i,/^(?:[^\<->\->:\n,;@]+?([\-]*[^\<->\->:\n,;@]+?)*?(?=((?!\n)\s)+as(?!\n)\s|[#\n;]|$))/i,/^(?:box\b)/i,/^(?:participant\b)/i,/^(?:actor\b)/i,/^(?:create\b)/i,/^(?:destroy\b)/i,/^(?:[^<\->\->:\n,;]+?([\-]*[^<\->\->:\n,;]+?)*?(?=((?!\n)\s)+as(?!\n)\s|[#\n;]|$))/i,/^(?:as\b)/i,/^(?:(?:))/i,/^(?:loop\b)/i,/^(?:rect\b)/i,/^(?:opt\b)/i,/^(?:alt\b)/i,/^(?:else\b)/i,/^(?:par\b)/i,/^(?:par_over\b)/i,/^(?:and\b)/i,/^(?:critical\b)/i,/^(?:option\b)/i,/^(?:break\b)/i,/^(?:(?:[:]?(?:no)?wrap)?[^#\n;]*)/i,/^(?:end\b)/i,/^(?:left of\b)/i,/^(?:right of\b)/i,/^(?:links\b)/i,/^(?:link\b)/i,/^(?:properties\b)/i,/^(?:details\b)/i,/^(?:over\b)/i,/^(?:note\b)/i,/^(?:activate\b)/i,/^(?:deactivate\b)/i,/^(?:title\s[^#\n;]+)/i,/^(?:title:\s[^#\n;]+)/i,/^(?:accTitle\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*\{\s*)/i,/^(?:[\}])/i,/^(?:[^\}]*)/i,/^(?:sequenceDiagram\b)/i,/^(?:autonumber\b)/i,/^(?:off\b)/i,/^(?:,)/i,/^(?:;)/i,/^(?:[^+<\->\->:\n,;]+((?!(-x|--x|-\)|--\)))[\-]*[^\+<\->\->:\n,;]+)*)/i,/^(?:->>)/i,/^(?:<<->>)/i,/^(?:-->>)/i,/^(?:<<-->>)/i,/^(?:->)/i,/^(?:-->)/i,/^(?:-[x])/i,/^(?:--[x])/i,/^(?:-[\)])/i,/^(?:--[\)])/i,/^(?::(?:(?:no)?wrap)?[^#\n;]*)/i,/^(?::)/i,/^(?:\+)/i,/^(?:-)/i,/^(?:$)/i,/^(?:.)/i],conditions:{acc_descr_multiline:{rules:[50,51],inclusive:!1},acc_descr:{rules:[48],inclusive:!1},acc_title:{rules:[46],inclusive:!1},ID:{rules:[2,3,7,10,11,17],inclusive:!1},ALIAS:{rules:[2,3,18,19],inclusive:!1},LINE:{rules:[2,3,31],inclusive:!1},CONFIG:{rules:[8,9],inclusive:!1},CONFIG_DATA:{rules:[],inclusive:!1},INITIAL:{rules:[0,1,3,4,5,6,12,13,14,15,16,20,21,22,23,24,25,26,27,28,29,30,32,33,34,35,36,37,38,39,40,41,42,43,44,45,47,49,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73],inclusive:!0}}};return pt})();Yt.lexer=ye;function At(){this.yy={}}return f(At,"Parser"),At.prototype=Yt,Yt.Parser=At,new At})();Ut.parser=Ut;var Ve=Ut,Ye={SOLID:0,DOTTED:1,NOTE:2,SOLID_CROSS:3,DOTTED_CROSS:4,SOLID_OPEN:5,DOTTED_OPEN:6,LOOP_START:10,LOOP_END:11,ALT_START:12,ALT_ELSE:13,ALT_END:14,OPT_START:15,OPT_END:16,ACTIVE_START:17,ACTIVE_END:18,PAR_START:19,PAR_AND:20,PAR_END:21,RECT_START:22,RECT_END:23,SOLID_POINT:24,DOTTED_POINT:25,AUTONUMBER:26,CRITICAL_START:27,CRITICAL_OPTION:28,CRITICAL_END:29,BREAK_START:30,BREAK_END:31,PAR_OVER_START:32,BIDIRECTIONAL_SOLID:33,BIDIRECTIONAL_DOTTED:34},We={FILLED:0,OPEN:1},Fe={LEFTOF:0,RIGHTOF:1,OVER:2},Rt={ACTOR:"actor",CONTROL:"control",DATABASE:"database",ENTITY:"entity"},wt,qe=(wt=class{constructor(){this.state=new Be(()=>({prevActor:void 0,actors:new Map,createdActors:new Map,destroyedActors:new Map,boxes:[],messages:[],notes:[],sequenceNumbersEnabled:!1,wrapEnabled:void 0,currentBox:void 0,lastCreated:void 0,lastDestroyed:void 0})),this.setAccTitle=se,this.setAccDescription=Ae,this.setDiagramTitle=ke,this.getAccTitle=Pe,this.getAccDescription=Ne,this.getDiagramTitle=Se,this.apply=this.apply.bind(this),this.parseBoxData=this.parseBoxData.bind(this),this.parseMessage=this.parseMessage.bind(this),this.clear(),this.setWrap(st().wrap),this.LINETYPE=Ye,this.ARROWTYPE=We,this.PLACEMENT=Fe}addBox(t){this.state.records.boxes.push({name:t.text,wrap:t.wrap??this.autoWrap(),fill:t.color,actorKeys:[]}),this.state.records.currentBox=this.state.records.boxes.slice(-1)[0]}addActor(t,n,s,r,i){let c=this.state.records.currentBox,h;if(i!==void 0){let a;i.includes(`
-`)?a=i+`
-`:a=`{
-`+i+`
-}`,h=Me(a,{schema:Re})}r=h?.type??r;const o=this.state.records.actors.get(t);if(o){if(this.state.records.currentBox&&o.box&&this.state.records.currentBox!==o.box)throw new Error(`A same participant should only be defined in one Box: ${o.name} can't be in '${o.box.name}' and in '${this.state.records.currentBox.name}' at the same time.`);if(c=o.box?o.box:this.state.records.currentBox,o.box=c,o&&n===o.name&&s==null)return}if(s?.text==null&&(s={text:n,type:r}),(r==null||s.text==null)&&(s={text:n,type:r}),this.state.records.actors.set(t,{box:c,name:n,description:s.text,wrap:s.wrap??this.autoWrap(),prevActor:this.state.records.prevActor,links:{},properties:{},actorCnt:null,rectData:null,type:r??"participant"}),this.state.records.prevActor){const a=this.state.records.actors.get(this.state.records.prevActor);a&&(a.nextActor=t)}this.state.records.currentBox&&this.state.records.currentBox.actorKeys.push(t),this.state.records.prevActor=t}activationCount(t){let n,s=0;if(!t)return 0;for(n=0;n<this.state.records.messages.length;n++)this.state.records.messages[n].type===this.LINETYPE.ACTIVE_START&&this.state.records.messages[n].from===t&&s++,this.state.records.messages[n].type===this.LINETYPE.ACTIVE_END&&this.state.records.messages[n].from===t&&s--;return s}addMessage(t,n,s,r){this.state.records.messages.push({id:this.state.records.messages.length.toString(),from:t,to:n,message:s.text,wrap:s.wrap??this.autoWrap(),answer:r})}addSignal(t,n,s,r,i=!1){if(r===this.LINETYPE.ACTIVE_END&&this.activationCount(t??"")<1){const h=new Error("Trying to inactivate an inactive participant ("+t+")");throw h.hash={text:"->>-",token:"->>-",line:"1",loc:{first_line:1,last_line:1,first_column:1,last_column:1},expected:["'ACTIVE_PARTICIPANT'"]},h}return this.state.records.messages.push({id:this.state.records.messages.length.toString(),from:t,to:n,message:s?.text??"",wrap:s?.wrap??this.autoWrap(),type:r,activate:i}),!0}hasAtLeastOneBox(){return this.state.records.boxes.length>0}hasAtLeastOneBoxWithTitle(){return this.state.records.boxes.some(t=>t.name)}getMessages(){return this.state.records.messages}getBoxes(){return this.state.records.boxes}getActors(){return this.state.records.actors}getCreatedActors(){return this.state.records.createdActors}getDestroyedActors(){return this.state.records.destroyedActors}getActor(t){return this.state.records.actors.get(t)}getActorKeys(){return[...this.state.records.actors.keys()]}enableSequenceNumbers(){this.state.records.sequenceNumbersEnabled=!0}disableSequenceNumbers(){this.state.records.sequenceNumbersEnabled=!1}showSequenceNumbers(){return this.state.records.sequenceNumbersEnabled}setWrap(t){this.state.records.wrapEnabled=t}extractWrap(t){if(t===void 0)return{};t=t.trim();const n=/^:?wrap:/.exec(t)!==null?!0:/^:?nowrap:/.exec(t)!==null?!1:void 0;return{cleanedText:(n===void 0?t:t.replace(/^:?(?:no)?wrap:/,"")).trim(),wrap:n}}autoWrap(){return this.state.records.wrapEnabled!==void 0?this.state.records.wrapEnabled:st().sequence?.wrap??!1}clear(){this.state.reset(),De()}parseMessage(t){const n=t.trim(),{wrap:s,cleanedText:r}=this.extractWrap(n),i={text:r,wrap:s};return Q.debug(`parseMessage: ${JSON.stringify(i)}`),i}parseBoxData(t){const n=/^((?:rgba?|hsla?)\s*\(.*\)|\w*)(.*)$/.exec(t);let s=n?.[1]?n[1].trim():"transparent",r=n?.[2]?n[2].trim():void 0;if(window?.CSS)window.CSS.supports("color",s)||(s="transparent",r=t.trim());else{const h=new Option().style;h.color=s,h.color!==s&&(s="transparent",r=t.trim())}const{wrap:i,cleanedText:c}=this.extractWrap(r);return{text:c?Mt(c,st()):void 0,color:s,wrap:i}}addNote(t,n,s){const r={actor:t,placement:n,message:s.text,wrap:s.wrap??this.autoWrap()},i=[].concat(t,t);this.state.records.notes.push(r),this.state.records.messages.push({id:this.state.records.messages.length.toString(),from:i[0],to:i[1],message:s.text,wrap:s.wrap??this.autoWrap(),type:this.LINETYPE.NOTE,placement:n})}addLinks(t,n){const s=this.getActor(t);try{let r=Mt(n.text,st());r=r.replace(/&equals;/g,"="),r=r.replace(/&amp;/g,"&");const i=JSON.parse(r);this.insertLinks(s,i)}catch(r){Q.error("error while parsing actor link text",r)}}addALink(t,n){const s=this.getActor(t);try{const r={};let i=Mt(n.text,st());const c=i.indexOf("@");i=i.replace(/&equals;/g,"="),i=i.replace(/&amp;/g,"&");const h=i.slice(0,c-1).trim(),o=i.slice(c+1).trim();r[h]=o,this.insertLinks(s,r)}catch(r){Q.error("error while parsing actor link text",r)}}insertLinks(t,n){if(t.links==null)t.links=n;else for(const s in n)t.links[s]=n[s]}addProperties(t,n){const s=this.getActor(t);try{const r=Mt(n.text,st()),i=JSON.parse(r);this.insertProperties(s,i)}catch(r){Q.error("error while parsing actor properties text",r)}}insertProperties(t,n){if(t.properties==null)t.properties=n;else for(const s in n)t.properties[s]=n[s]}boxEnd(){this.state.records.currentBox=void 0}addDetails(t,n){const s=this.getActor(t),r=document.getElementById(n.text);try{const i=r.innerHTML,c=JSON.parse(i);c.properties&&this.insertProperties(s,c.properties),c.links&&this.insertLinks(s,c.links)}catch(i){Q.error("error while parsing actor details text",i)}}getActorProperty(t,n){if(t?.properties!==void 0)return t.properties[n]}apply(t){if(Array.isArray(t))t.forEach(n=>{this.apply(n)});else switch(t.type){case"sequenceIndex":this.state.records.messages.push({id:this.state.records.messages.length.toString(),from:void 0,to:void 0,message:{start:t.sequenceIndex,step:t.sequenceIndexStep,visible:t.sequenceVisible},wrap:!1,type:t.signalType});break;case"addParticipant":this.addActor(t.actor,t.actor,t.description,t.draw,t.config);break;case"createParticipant":if(this.state.records.actors.has(t.actor))throw new Error("It is not possible to have actors with the same id, even if one is destroyed before the next is created. Use 'AS' aliases to simulate the behavior");this.state.records.lastCreated=t.actor,this.addActor(t.actor,t.actor,t.description,t.draw,t.config),this.state.records.createdActors.set(t.actor,this.state.records.messages.length);break;case"destroyParticipant":this.state.records.lastDestroyed=t.actor,this.state.records.destroyedActors.set(t.actor,this.state.records.messages.length);break;case"activeStart":this.addSignal(t.actor,void 0,void 0,t.signalType);break;case"activeEnd":this.addSignal(t.actor,void 0,void 0,t.signalType);break;case"addNote":this.addNote(t.actor,t.placement,t.text);break;case"addLinks":this.addLinks(t.actor,t.text);break;case"addALink":this.addALink(t.actor,t.text);break;case"addProperties":this.addProperties(t.actor,t.text);break;case"addDetails":this.addDetails(t.actor,t.text);break;case"addMessage":if(this.state.records.lastCreated){if(t.to!==this.state.records.lastCreated)throw new Error("The created participant "+this.state.records.lastCreated.name+" does not have an associated creating message after its declaration. Please check the sequence diagram.");this.state.records.lastCreated=void 0}else if(this.state.records.lastDestroyed){if(t.to!==this.state.records.lastDestroyed&&t.from!==this.state.records.lastDestroyed)throw new Error("The destroyed participant "+this.state.records.lastDestroyed.name+" does not have an associated destroying message after its declaration. Please check the sequence diagram.");this.state.records.lastDestroyed=void 0}this.addSignal(t.from,t.to,t.msg,t.signalType,t.activate);break;case"boxStart":this.addBox(t.boxData);break;case"boxEnd":this.boxEnd();break;case"loopStart":this.addSignal(void 0,void 0,t.loopText,t.signalType);break;case"loopEnd":this.addSignal(void 0,void 0,void 0,t.signalType);break;case"rectStart":this.addSignal(void 0,void 0,t.color,t.signalType);break;case"rectEnd":this.addSignal(void 0,void 0,void 0,t.signalType);break;case"optStart":this.addSignal(void 0,void 0,t.optText,t.signalType);break;case"optEnd":this.addSignal(void 0,void 0,void 0,t.signalType);break;case"altStart":this.addSignal(void 0,void 0,t.altText,t.signalType);break;case"else":this.addSignal(void 0,void 0,t.altText,t.signalType);break;case"altEnd":this.addSignal(void 0,void 0,void 0,t.signalType);break;case"setAccTitle":se(t.text);break;case"parStart":this.addSignal(void 0,void 0,t.parText,t.signalType);break;case"and":this.addSignal(void 0,void 0,t.parText,t.signalType);break;case"parEnd":this.addSignal(void 0,void 0,void 0,t.signalType);break;case"criticalStart":this.addSignal(void 0,void 0,t.criticalText,t.signalType);break;case"option":this.addSignal(void 0,void 0,t.optionText,t.signalType);break;case"criticalEnd":this.addSignal(void 0,void 0,void 0,t.signalType);break;case"breakStart":this.addSignal(void 0,void 0,t.breakText,t.signalType);break;case"breakEnd":this.addSignal(void 0,void 0,void 0,t.signalType);break}}getConfig(){return st().sequence}},f(wt,"SequenceDB"),wt),ze=f(e=>`.actor {
-    stroke: ${e.actorBorder};
-    fill: ${e.actorBkg};
-  }
-
-  text.actor > tspan {
-    fill: ${e.actorTextColor};
-    stroke: none;
-  }
-
-  .actor-line {
-    stroke: ${e.actorLineColor};
-  }
-  
-  .innerArc {
-    stroke-width: 1.5;
-    stroke-dasharray: none;
-  }
-
-  .messageLine0 {
-    stroke-width: 1.5;
-    stroke-dasharray: none;
-    stroke: ${e.signalColor};
-  }
-
-  .messageLine1 {
-    stroke-width: 1.5;
-    stroke-dasharray: 2, 2;
-    stroke: ${e.signalColor};
-  }
-
-  #arrowhead path {
-    fill: ${e.signalColor};
-    stroke: ${e.signalColor};
-  }
-
-  .sequenceNumber {
-    fill: ${e.sequenceNumberColor};
-  }
-
-  #sequencenumber {
-    fill: ${e.signalColor};
-  }
-
-  #crosshead path {
-    fill: ${e.signalColor};
-    stroke: ${e.signalColor};
-  }
-
-  .messageText {
-    fill: ${e.signalTextColor};
-    stroke: none;
-  }
-
-  .labelBox {
-    stroke: ${e.labelBoxBorderColor};
-    fill: ${e.labelBoxBkgColor};
-  }
-
-  .labelText, .labelText > tspan {
-    fill: ${e.labelTextColor};
-    stroke: none;
-  }
-
-  .loopText, .loopText > tspan {
-    fill: ${e.loopTextColor};
-    stroke: none;
-  }
-
-  .loopLine {
-    stroke-width: 2px;
-    stroke-dasharray: 2, 2;
-    stroke: ${e.labelBoxBorderColor};
-    fill: ${e.labelBoxBorderColor};
-  }
-
-  .note {
-    //stroke: #decc93;
-    stroke: ${e.noteBorderColor};
-    fill: ${e.noteBkgColor};
-  }
-
-  .noteText, .noteText > tspan {
-    fill: ${e.noteTextColor};
-    stroke: none;
-  }
-
-  .activation0 {
-    fill: ${e.activationBkgColor};
-    stroke: ${e.activationBorderColor};
-  }
-
-  .activation1 {
-    fill: ${e.activationBkgColor};
-    stroke: ${e.activationBorderColor};
-  }
-
-  .activation2 {
-    fill: ${e.activationBkgColor};
-    stroke: ${e.activationBorderColor};
-  }
-
-  .actorPopupMenu {
-    position: absolute;
-  }
-
-  .actorPopupMenuPanel {
-    position: absolute;
-    fill: ${e.actorBkg};
-    box-shadow: 0px 8px 16px 0px rgba(0,0,0,0.2);
-    filter: drop-shadow(3px 5px 2px rgb(0 0 0 / 0.4));
-}
-  .actor-man line {
-    stroke: ${e.actorBorder};
-    fill: ${e.actorBkg};
-  }
-  .actor-man circle, line {
-    stroke: ${e.actorBorder};
-    fill: ${e.actorBkg};
-    stroke-width: 2px;
-  }
-
-`,"getStyles"),He=ze,Tt=36,gt="actor-top",xt="actor-bottom",Ct="actor-box",ut="actor-man",Lt=f(function(e,t){return ve(e,t)},"drawRect"),Ue=f(function(e,t,n,s,r){if(t.links===void 0||t.links===null||Object.keys(t.links).length===0)return{height:0,width:0};const i=t.links,c=t.actorCnt,h=t.rectData;var o="none";r&&(o="block !important");const a=e.append("g");a.attr("id","actor"+c+"_popup"),a.attr("class","actorPopupMenu"),a.attr("display",o);var p="";h.class!==void 0&&(p=" "+h.class);let g=h.width>n?h.width:n;const x=a.append("rect");if(x.attr("class","actorPopupMenuPanel"+p),x.attr("x",h.x),x.attr("y",h.height),x.attr("fill",h.fill),x.attr("stroke",h.stroke),x.attr("width",g),x.attr("height",h.height),x.attr("rx",h.rx),x.attr("ry",h.ry),i!=null){var y=20;for(let k in i){var m=a.append("a"),w=re.sanitizeUrl(i[k]);m.attr("xlink:href",w),m.attr("target","_blank"),us(s)(k,m,h.x+10,h.height+y,g,20,{class:"actor"},s),y+=30}}return x.attr("height",y),{height:h.height+y,width:g}},"drawPopup"),Ot=f(function(e){return"var pu = document.getElementById('"+e+"'); if (pu != null) { pu.style.display = pu.style.display == 'block' ? 'none' : 'block'; }"},"popupMenuToggle"),Dt=f(async function(e,t,n=null){let s=e.append("foreignObject");const r=await ne(t.text,Ht()),c=s.append("xhtml:div").attr("style","width: fit-content;").attr("xmlns","http://www.w3.org/1999/xhtml").html(r).node().getBoundingClientRect();if(s.attr("height",Math.round(c.height)).attr("width",Math.round(c.width)),t.class==="noteText"){const h=e.node().firstChild;h.setAttribute("height",c.height+2*t.textMargin);const o=h.getBBox();s.attr("x",Math.round(o.x+o.width/2-c.width/2)).attr("y",Math.round(o.y+o.height/2-c.height/2))}else if(n){let{startx:h,stopx:o,starty:a}=n;if(h>o){const p=h;h=o,o=p}s.attr("x",Math.round(h+Math.abs(h-o)/2-c.width/2)),t.class==="loopText"?s.attr("y",Math.round(a)):s.attr("y",Math.round(a-c.height))}return[s]},"drawKatex"),vt=f(function(e,t){let n=0,s=0;const r=t.text.split(I.lineBreakRegex),[i,c]=ie(t.fontSize);let h=[],o=0,a=f(()=>t.y,"yfunc");if(t.valign!==void 0&&t.textMargin!==void 0&&t.textMargin>0)switch(t.valign){case"top":case"start":a=f(()=>Math.round(t.y+t.textMargin),"yfunc");break;case"middle":case"center":a=f(()=>Math.round(t.y+(n+s+t.textMargin)/2),"yfunc");break;case"bottom":case"end":a=f(()=>Math.round(t.y+(n+s+2*t.textMargin)-t.textMargin),"yfunc");break}if(t.anchor!==void 0&&t.textMargin!==void 0&&t.width!==void 0)switch(t.anchor){case"left":case"start":t.x=Math.round(t.x+t.textMargin),t.anchor="start",t.dominantBaseline="middle",t.alignmentBaseline="middle";break;case"middle":case"center":t.x=Math.round(t.x+t.width/2),t.anchor="middle",t.dominantBaseline="middle",t.alignmentBaseline="middle";break;case"right":case"end":t.x=Math.round(t.x+t.width-t.textMargin),t.anchor="end",t.dominantBaseline="middle",t.alignmentBaseline="middle";break}for(let[p,g]of r.entries()){t.textMargin!==void 0&&t.textMargin===0&&i!==void 0&&(o=p*i);const x=e.append("text");x.attr("x",t.x),x.attr("y",a()),t.anchor!==void 0&&x.attr("text-anchor",t.anchor).attr("dominant-baseline",t.dominantBaseline).attr("alignment-baseline",t.alignmentBaseline),t.fontFamily!==void 0&&x.style("font-family",t.fontFamily),c!==void 0&&x.style("font-size",c),t.fontWeight!==void 0&&x.style("font-weight",t.fontWeight),t.fill!==void 0&&x.attr("fill",t.fill),t.class!==void 0&&x.attr("class",t.class),t.dy!==void 0?x.attr("dy",t.dy):o!==0&&x.attr("dy",o);const y=g||Ce;if(t.tspan){const m=x.append("tspan");m.attr("x",t.x),t.fill!==void 0&&m.attr("fill",t.fill),m.text(y)}else x.text(y);t.valign!==void 0&&t.textMargin!==void 0&&t.textMargin>0&&(s+=(x._groups||x)[0][0].getBBox().height,n=s),h.push(x)}return h},"drawText"),oe=f(function(e,t){function n(r,i,c,h,o){return r+","+i+" "+(r+c)+","+i+" "+(r+c)+","+(i+h-o)+" "+(r+c-o*1.2)+","+(i+h)+" "+r+","+(i+h)}f(n,"genPoints");const s=e.append("polygon");return s.attr("points",n(t.x,t.y,t.width,t.height,7)),s.attr("class","labelBox"),t.y=t.y+t.height/2,vt(e,t),s},"drawLabel"),P=-1,ce=f((e,t,n,s)=>{e.select&&n.forEach(r=>{const i=t.get(r),c=e.select("#actor"+i.actorCnt);!s.mirrorActors&&i.stopy?c.attr("y2",i.stopy+i.height/2):s.mirrorActors&&c.attr("y2",i.stopy)})},"fixLifeLineHeights"),Ge=f(function(e,t,n,s){const r=s?t.stopy:t.starty,i=t.x+t.width/2,c=r+t.height,h=e.append("g").lower();var o=h;s||(P++,Object.keys(t.links||{}).length&&!n.forceMenus&&o.attr("onclick",Ot(`actor${P}_popup`)).attr("cursor","pointer"),o.append("line").attr("id","actor"+P).attr("x1",i).attr("y1",c).attr("x2",i).attr("y2",2e3).attr("class","actor-line 200").attr("stroke-width","0.5px").attr("stroke","#999").attr("name",t.name),o=h.append("g"),t.actorCnt=P,t.links!=null&&o.attr("id","root-"+P));const a=ct();var p="actor";t.properties?.class?p=t.properties.class:a.fill="#eaeaea",s?p+=` ${xt}`:p+=` ${gt}`,a.x=t.x,a.y=r,a.width=t.width,a.height=t.height,a.class=p,a.rx=3,a.ry=3,a.name=t.name;const g=Lt(o,a);if(t.rectData=a,t.properties?.icon){const y=t.properties.icon.trim();y.charAt(0)==="@"?Jt(o,a.x+a.width-20,a.y+10,y.substr(1)):Qt(o,a.x+a.width-20,a.y+10,y)}dt(n,z(t.description))(t.description,o,a.x,a.y,a.width,a.height,{class:`actor ${Ct}`},n);let x=t.height;if(g.node){const y=g.node().getBBox();t.height=y.height,x=y.height}return x},"drawActorTypeParticipant"),Ke=f(function(e,t,n,s){const r=s?t.stopy:t.starty,i=t.x+t.width/2,c=r+t.height,h=e.append("g").lower();var o=h;s||(P++,Object.keys(t.links||{}).length&&!n.forceMenus&&o.attr("onclick",Ot(`actor${P}_popup`)).attr("cursor","pointer"),o.append("line").attr("id","actor"+P).attr("x1",i).attr("y1",c).attr("x2",i).attr("y2",2e3).attr("class","actor-line 200").attr("stroke-width","0.5px").attr("stroke","#999").attr("name",t.name),o=h.append("g"),t.actorCnt=P,t.links!=null&&o.attr("id","root-"+P));const a=ct();var p="actor";t.properties?.class?p=t.properties.class:a.fill="#eaeaea",s?p+=` ${xt}`:p+=` ${gt}`,a.x=t.x,a.y=r,a.width=t.width,a.height=t.height,a.class=p,a.name=t.name;const g=6,x={...a,x:a.x+-g,y:a.y+ +g,class:"actor"},y=Lt(o,a);if(Lt(o,x),t.rectData=a,t.properties?.icon){const w=t.properties.icon.trim();w.charAt(0)==="@"?Jt(o,a.x+a.width-20,a.y+10,w.substr(1)):Qt(o,a.x+a.width-20,a.y+10,w)}dt(n,z(t.description))(t.description,o,a.x-g,a.y+g,a.width,a.height,{class:`actor ${Ct}`},n);let m=t.height;if(y.node){const w=y.node().getBBox();t.height=w.height,m=w.height}return m},"drawActorTypeCollections"),Xe=f(function(e,t,n,s){const r=s?t.stopy:t.starty,i=t.x+t.width/2,c=r+t.height,h=e.append("g").lower();let o=h;s||(P++,Object.keys(t.links||{}).length&&!n.forceMenus&&o.attr("onclick",Ot(`actor${P}_popup`)).attr("cursor","pointer"),o.append("line").attr("id","actor"+P).attr("x1",i).attr("y1",c).attr("x2",i).attr("y2",2e3).attr("class","actor-line 200").attr("stroke-width","0.5px").attr("stroke","#999").attr("name",t.name),o=h.append("g"),t.actorCnt=P,t.links!=null&&o.attr("id","root-"+P));const a=ct();let p="actor";t.properties?.class?p=t.properties.class:a.fill="#eaeaea",s?p+=` ${xt}`:p+=` ${gt}`,a.x=t.x,a.y=r,a.width=t.width,a.height=t.height,a.class=p,a.name=t.name;const g=a.height/2,x=g/(2.5+a.height/50),y=o.append("g"),m=o.append("g");if(y.append("path").attr("d",`M ${a.x},${a.y+g}
-    a ${x},${g} 0 0 0 0,${a.height}
-    h ${a.width-2*x}
-    a ${x},${g} 0 0 0 0,-${a.height}
-    Z
-  `).attr("class",p),m.append("path").attr("d",`M ${a.x},${a.y+g}
-      a ${x},${g} 0 0 0 0,${a.height}`).attr("stroke","#666").attr("stroke-width","1px").attr("class",p),y.attr("transform",`translate(${x}, ${-(a.height/2)})`),m.attr("transform",`translate(${a.width-x}, ${-a.height/2})`),t.rectData=a,t.properties?.icon){const N=t.properties.icon.trim(),S=a.x+a.width-20,O=a.y+10;N.charAt(0)==="@"?Jt(o,S,O,N.substr(1)):Qt(o,S,O,N)}dt(n,z(t.description))(t.description,o,a.x,a.y,a.width,a.height,{class:`actor ${Ct}`},n);let w=t.height;const k=y.select("path:last-child");if(k.node()){const N=k.node().getBBox();t.height=N.height,w=N.height}return w},"drawActorTypeQueue"),Je=f(function(e,t,n,s){const r=s?t.stopy:t.starty,i=t.x+t.width/2,c=r+75,h=e.append("g").lower();s||(P++,h.append("line").attr("id","actor"+P).attr("x1",i).attr("y1",c).attr("x2",i).attr("y2",2e3).attr("class","actor-line 200").attr("stroke-width","0.5px").attr("stroke","#999").attr("name",t.name),t.actorCnt=P);const o=e.append("g");let a=ut;s?a+=` ${xt}`:a+=` ${gt}`,o.attr("class",a),o.attr("name",t.name);const p=ct();p.x=t.x,p.y=r,p.fill="#eaeaea",p.width=t.width,p.height=t.height,p.class="actor";const g=t.x+t.width/2,x=r+30,y=18;o.append("defs").append("marker").attr("id","filled-head-control").attr("refX",11).attr("refY",5.8).attr("markerWidth",20).attr("markerHeight",28).attr("orient","172.5").append("path").attr("d","M 14.4 5.6 L 7.2 10.4 L 8.8 5.6 L 7.2 0.8 Z"),o.append("circle").attr("cx",g).attr("cy",x).attr("r",y).attr("fill","#eaeaf7").attr("stroke","#666").attr("stroke-width",1.2),o.append("line").attr("marker-end","url(#filled-head-control)").attr("transform",`translate(${g}, ${x-y})`);const m=o.node().getBBox();return t.height=m.height+2*(n?.sequence?.labelBoxHeight??0),dt(n,z(t.description))(t.description,o,p.x,p.y+y+(s?5:10),p.width,p.height,{class:`actor ${ut}`},n),t.height},"drawActorTypeControl"),Qe=f(function(e,t,n,s){const r=s?t.stopy:t.starty,i=t.x+t.width/2,c=r+75,h=e.append("g").lower(),o=e.append("g");let a=ut;s?a+=` ${xt}`:a+=` ${gt}`,o.attr("class",a),o.attr("name",t.name);const p=ct();p.x=t.x,p.y=r,p.fill="#eaeaea",p.width=t.width,p.height=t.height,p.class="actor";const g=t.x+t.width/2,x=r+(s?10:25),y=18;o.append("circle").attr("cx",g).attr("cy",x).attr("r",y).attr("width",t.width).attr("height",t.height),o.append("line").attr("x1",g-y).attr("x2",g+y).attr("y1",x+y).attr("y2",x+y).attr("stroke","#333").attr("stroke-width",2);const m=o.node().getBBox();return t.height=m.height+(n?.sequence?.labelBoxHeight??0),s||(P++,h.append("line").attr("id","actor"+P).attr("x1",i).attr("y1",c).attr("x2",i).attr("y2",2e3).attr("class","actor-line 200").attr("stroke-width","0.5px").attr("stroke","#999").attr("name",t.name),t.actorCnt=P),dt(n,z(t.description))(t.description,o,p.x,p.y+(s?(x-r+y-5)/2:(x+y-r)/2),p.width,p.height,{class:`actor ${ut}`},n),s?o.attr("transform",`translate(0, ${y/2})`):o.attr("transform",`translate(0, ${y/2})`),t.height},"drawActorTypeEntity"),Ze=f(function(e,t,n,s){const r=s?t.stopy:t.starty,i=t.x+t.width/2,c=r+t.height+2*n.boxTextMargin,h=e.append("g").lower();let o=h;s||(P++,Object.keys(t.links||{}).length&&!n.forceMenus&&o.attr("onclick",Ot(`actor${P}_popup`)).attr("cursor","pointer"),o.append("line").attr("id","actor"+P).attr("x1",i).attr("y1",c).attr("x2",i).attr("y2",2e3).attr("class","actor-line 200").attr("stroke-width","0.5px").attr("stroke","#999").attr("name",t.name),o=h.append("g"),t.actorCnt=P,t.links!=null&&o.attr("id","root-"+P));const a=ct();let p="actor";t.properties?.class?p=t.properties.class:a.fill="#eaeaea",s?p+=` ${xt}`:p+=` ${gt}`,a.x=t.x,a.y=r,a.width=t.width,a.height=t.height,a.class=p,a.name=t.name,a.x=t.x,a.y=r;const g=a.width/4,x=a.width/4,y=g/2,m=y/(2.5+g/50),w=o.append("g"),k=`
-  M ${a.x},${a.y+m}
-  a ${y},${m} 0 0 0 ${g},0
-  a ${y},${m} 0 0 0 -${g},0
-  l 0,${x-2*m}
-  a ${y},${m} 0 0 0 ${g},0
-  l 0,-${x-2*m}
-`;w.append("path").attr("d",k).attr("fill","#eaeaea").attr("stroke","#000").attr("stroke-width",1).attr("class",p),s?w.attr("transform",`translate(${g*1.5}, ${a.height/4-2*m})`):w.attr("transform",`translate(${g*1.5}, ${(a.height+m)/4})`),t.rectData=a,dt(n,z(t.description))(t.description,o,a.x,a.y+(s?(a.height+x)/4:(a.height+m)/2),a.width,a.height,{class:`actor ${Ct}`},n);const N=w.select("path:last-child");if(N.node()){const S=N.node().getBBox();t.height=S.height+(n.sequence.labelBoxHeight??0)}return t.height},"drawActorTypeDatabase"),$e=f(function(e,t,n,s){const r=s?t.stopy:t.starty,i=t.x+t.width/2,c=r+80,h=30,o=e.append("g").lower();s||(P++,o.append("line").attr("id","actor"+P).attr("x1",i).attr("y1",c).attr("x2",i).attr("y2",2e3).attr("class","actor-line 200").attr("stroke-width","0.5px").attr("stroke","#999").attr("name",t.name),t.actorCnt=P);const a=e.append("g");let p=ut;s?p+=` ${xt}`:p+=` ${gt}`,a.attr("class",p),a.attr("name",t.name);const g=ct();g.x=t.x,g.y=r,g.fill="#eaeaea",g.width=t.width,g.height=t.height,g.class="actor",a.append("line").attr("id","actor-man-torso"+P).attr("x1",t.x+t.width/2-h*2.5).attr("y1",r+10).attr("x2",t.x+t.width/2-15).attr("y2",r+10),a.append("line").attr("id","actor-man-arms"+P).attr("x1",t.x+t.width/2-h*2.5).attr("y1",r+0).attr("x2",t.x+t.width/2-h*2.5).attr("y2",r+20),a.append("circle").attr("cx",t.x+t.width/2).attr("cy",r+10).attr("r",h);const x=a.node().getBBox();return t.height=x.height+(n.sequence.labelBoxHeight??0),dt(n,z(t.description))(t.description,a,g.x,g.y+(s?h/2-4:h/2+3),g.width,g.height,{class:`actor ${ut}`},n),s?a.attr("transform",`translate(0,${h/2+7})`):a.attr("transform",`translate(0,${h/2+7})`),t.height},"drawActorTypeBoundary"),je=f(function(e,t,n,s){const r=s?t.stopy:t.starty,i=t.x+t.width/2,c=r+80,h=e.append("g").lower();s||(P++,h.append("line").attr("id","actor"+P).attr("x1",i).attr("y1",c).attr("x2",i).attr("y2",2e3).attr("class","actor-line 200").attr("stroke-width","0.5px").attr("stroke","#999").attr("name",t.name),t.actorCnt=P);const o=e.append("g");let a=ut;s?a+=` ${xt}`:a+=` ${gt}`,o.attr("class",a),o.attr("name",t.name);const p=ct();p.x=t.x,p.y=r,p.fill="#eaeaea",p.width=t.width,p.height=t.height,p.class="actor",p.rx=3,p.ry=3,o.append("line").attr("id","actor-man-torso"+P).attr("x1",i).attr("y1",r+25).attr("x2",i).attr("y2",r+45),o.append("line").attr("id","actor-man-arms"+P).attr("x1",i-Tt/2).attr("y1",r+33).attr("x2",i+Tt/2).attr("y2",r+33),o.append("line").attr("x1",i-Tt/2).attr("y1",r+60).attr("x2",i).attr("y2",r+45),o.append("line").attr("x1",i).attr("y1",r+45).attr("x2",i+Tt/2-2).attr("y2",r+60);const g=o.append("circle");g.attr("cx",t.x+t.width/2),g.attr("cy",r+10),g.attr("r",15),g.attr("width",t.width),g.attr("height",t.height);const x=o.node().getBBox();return t.height=x.height,dt(n,z(t.description))(t.description,o,p.x,p.y+35,p.width,p.height,{class:`actor ${ut}`},n),t.height},"drawActorTypeActor"),ts=f(async function(e,t,n,s){switch(t.type){case"actor":return await je(e,t,n,s);case"participant":return await Ge(e,t,n,s);case"boundary":return await $e(e,t,n,s);case"control":return await Je(e,t,n,s);case"entity":return await Qe(e,t,n,s);case"database":return await Ze(e,t,n,s);case"collections":return await Ke(e,t,n,s);case"queue":return await Xe(e,t,n,s)}},"drawActor"),es=f(function(e,t,n){const r=e.append("g");le(r,t),t.name&&dt(n)(t.name,r,t.x,t.y+n.boxTextMargin+(t.textMaxHeight||0)/2,t.width,0,{class:"text"},n),r.lower()},"drawBox"),ss=f(function(e){return e.append("g")},"anchorElement"),as=f(function(e,t,n,s,r){const i=ct(),c=t.anchored;i.x=t.startx,i.y=t.starty,i.class="activation"+r%3,i.width=t.stopx-t.startx,i.height=n-t.starty,Lt(c,i)},"drawActivation"),rs=f(async function(e,t,n,s){const{boxMargin:r,boxTextMargin:i,labelBoxHeight:c,labelBoxWidth:h,messageFontFamily:o,messageFontSize:a,messageFontWeight:p}=s,g=e.append("g"),x=f(function(w,k,N,S){return g.append("line").attr("x1",w).attr("y1",k).attr("x2",N).attr("y2",S).attr("class","loopLine")},"drawLoopLine");x(t.startx,t.starty,t.stopx,t.starty),x(t.stopx,t.starty,t.stopx,t.stopy),x(t.startx,t.stopy,t.stopx,t.stopy),x(t.startx,t.starty,t.startx,t.stopy),t.sections!==void 0&&t.sections.forEach(function(w){x(t.startx,w.y,t.stopx,w.y).style("stroke-dasharray","3, 3")});let y=Xt();y.text=n,y.x=t.startx,y.y=t.starty,y.fontFamily=o,y.fontSize=a,y.fontWeight=p,y.anchor="middle",y.valign="middle",y.tspan=!1,y.width=h||50,y.height=c||20,y.textMargin=i,y.class="labelText",oe(g,y),y=he(),y.text=t.title,y.x=t.startx+h/2+(t.stopx-t.startx)/2,y.y=t.starty+r+i,y.anchor="middle",y.valign="middle",y.textMargin=i,y.class="loopText",y.fontFamily=o,y.fontSize=a,y.fontWeight=p,y.wrap=!0;let m=z(y.text)?await Dt(g,y,t):vt(g,y);if(t.sectionTitles!==void 0){for(const[w,k]of Object.entries(t.sectionTitles))if(k.message){y.text=k.message,y.x=t.startx+(t.stopx-t.startx)/2,y.y=t.sections[w].y+r+i,y.class="loopText",y.anchor="middle",y.valign="middle",y.tspan=!1,y.fontFamily=o,y.fontSize=a,y.fontWeight=p,y.wrap=t.wrap,z(y.text)?(t.starty=t.sections[w].y,await Dt(g,y,t)):vt(g,y);let N=Math.round(m.map(S=>(S._groups||S)[0][0].getBBox().height).reduce((S,O)=>S+O));t.sections[w].height+=N-(r+i)}}return t.height=Math.round(t.stopy-t.starty),g},"drawLoop"),le=f(function(e,t){we(e,t)},"drawBackgroundRect"),is=f(function(e){e.append("defs").append("symbol").attr("id","database").attr("fill-rule","evenodd").attr("clip-rule","evenodd").append("path").attr("transform","scale(.5)").attr("d","M12.258.001l.256.004.255.005.253.008.251.01.249.012.247.015.246.016.242.019.241.02.239.023.236.024.233.027.231.028.229.031.225.032.223.034.22.036.217.038.214.04.211.041.208.043.205.045.201.046.198.048.194.05.191.051.187.053.183.054.18.056.175.057.172.059.168.06.163.061.16.063.155.064.15.066.074.033.073.033.071.034.07.034.069.035.068.035.067.035.066.035.064.036.064.036.062.036.06.036.06.037.058.037.058.037.055.038.055.038.053.038.052.038.051.039.05.039.048.039.047.039.045.04.044.04.043.04.041.04.04.041.039.041.037.041.036.041.034.041.033.042.032.042.03.042.029.042.027.042.026.043.024.043.023.043.021.043.02.043.018.044.017.043.015.044.013.044.012.044.011.045.009.044.007.045.006.045.004.045.002.045.001.045v17l-.001.045-.002.045-.004.045-.006.045-.007.045-.009.044-.011.045-.012.044-.013.044-.015.044-.017.043-.018.044-.02.043-.021.043-.023.043-.024.043-.026.043-.027.042-.029.042-.03.042-.032.042-.033.042-.034.041-.036.041-.037.041-.039.041-.04.041-.041.04-.043.04-.044.04-.045.04-.047.039-.048.039-.05.039-.051.039-.052.038-.053.038-.055.038-.055.038-.058.037-.058.037-.06.037-.06.036-.062.036-.064.036-.064.036-.066.035-.067.035-.068.035-.069.035-.07.034-.071.034-.073.033-.074.033-.15.066-.155.064-.16.063-.163.061-.168.06-.172.059-.175.057-.18.056-.183.054-.187.053-.191.051-.194.05-.198.048-.201.046-.205.045-.208.043-.211.041-.214.04-.217.038-.22.036-.223.034-.225.032-.229.031-.231.028-.233.027-.236.024-.239.023-.241.02-.242.019-.246.016-.247.015-.249.012-.251.01-.253.008-.255.005-.256.004-.258.001-.258-.001-.256-.004-.255-.005-.253-.008-.251-.01-.249-.012-.247-.015-.245-.016-.243-.019-.241-.02-.238-.023-.236-.024-.234-.027-.231-.028-.228-.031-.226-.032-.223-.034-.22-.036-.217-.038-.214-.04-.211-.041-.208-.043-.204-.045-.201-.046-.198-.048-.195-.05-.19-.051-.187-.053-.184-.054-.179-.056-.176-.057-.172-.059-.167-.06-.164-.061-.159-.063-.155-.064-.151-.066-.074-.033-.072-.033-.072-.034-.07-.034-.069-.035-.068-.035-.067-.035-.066-.035-.064-.036-.063-.036-.062-.036-.061-.036-.06-.037-.058-.037-.057-.037-.056-.038-.055-.038-.053-.038-.052-.038-.051-.039-.049-.039-.049-.039-.046-.039-.046-.04-.044-.04-.043-.04-.041-.04-.04-.041-.039-.041-.037-.041-.036-.041-.034-.041-.033-.042-.032-.042-.03-.042-.029-.042-.027-.042-.026-.043-.024-.043-.023-.043-.021-.043-.02-.043-.018-.044-.017-.043-.015-.044-.013-.044-.012-.044-.011-.045-.009-.044-.007-.045-.006-.045-.004-.045-.002-.045-.001-.045v-17l.001-.045.002-.045.004-.045.006-.045.007-.045.009-.044.011-.045.012-.044.013-.044.015-.044.017-.043.018-.044.02-.043.021-.043.023-.043.024-.043.026-.043.027-.042.029-.042.03-.042.032-.042.033-.042.034-.041.036-.041.037-.041.039-.041.04-.041.041-.04.043-.04.044-.04.046-.04.046-.039.049-.039.049-.039.051-.039.052-.038.053-.038.055-.038.056-.038.057-.037.058-.037.06-.037.061-.036.062-.036.063-.036.064-.036.066-.035.067-.035.068-.035.069-.035.07-.034.072-.034.072-.033.074-.033.151-.066.155-.064.159-.063.164-.061.167-.06.172-.059.176-.057.179-.056.184-.054.187-.053.19-.051.195-.05.198-.048.201-.046.204-.045.208-.043.211-.041.214-.04.217-.038.22-.036.223-.034.226-.032.228-.031.231-.028.234-.027.236-.024.238-.023.241-.02.243-.019.245-.016.247-.015.249-.012.251-.01.253-.008.255-.005.256-.004.258-.001.258.001zm-9.258 20.499v.01l.001.021.003.021.004.022.005.021.006.022.007.022.009.023.01.022.011.023.012.023.013.023.015.023.016.024.017.023.018.024.019.024.021.024.022.025.023.024.024.025.052.049.056.05.061.051.066.051.07.051.075.051.079.052.084.052.088.052.092.052.097.052.102.051.105.052.11.052.114.051.119.051.123.051.127.05.131.05.135.05.139.048.144.049.147.047.152.047.155.047.16.045.163.045.167.043.171.043.176.041.178.041.183.039.187.039.19.037.194.035.197.035.202.033.204.031.209.03.212.029.216.027.219.025.222.024.226.021.23.02.233.018.236.016.24.015.243.012.246.01.249.008.253.005.256.004.259.001.26-.001.257-.004.254-.005.25-.008.247-.011.244-.012.241-.014.237-.016.233-.018.231-.021.226-.021.224-.024.22-.026.216-.027.212-.028.21-.031.205-.031.202-.034.198-.034.194-.036.191-.037.187-.039.183-.04.179-.04.175-.042.172-.043.168-.044.163-.045.16-.046.155-.046.152-.047.148-.048.143-.049.139-.049.136-.05.131-.05.126-.05.123-.051.118-.052.114-.051.11-.052.106-.052.101-.052.096-.052.092-.052.088-.053.083-.051.079-.052.074-.052.07-.051.065-.051.06-.051.056-.05.051-.05.023-.024.023-.025.021-.024.02-.024.019-.024.018-.024.017-.024.015-.023.014-.024.013-.023.012-.023.01-.023.01-.022.008-.022.006-.022.006-.022.004-.022.004-.021.001-.021.001-.021v-4.127l-.077.055-.08.053-.083.054-.085.053-.087.052-.09.052-.093.051-.095.05-.097.05-.1.049-.102.049-.105.048-.106.047-.109.047-.111.046-.114.045-.115.045-.118.044-.12.043-.122.042-.124.042-.126.041-.128.04-.13.04-.132.038-.134.038-.135.037-.138.037-.139.035-.142.035-.143.034-.144.033-.147.032-.148.031-.15.03-.151.03-.153.029-.154.027-.156.027-.158.026-.159.025-.161.024-.162.023-.163.022-.165.021-.166.02-.167.019-.169.018-.169.017-.171.016-.173.015-.173.014-.175.013-.175.012-.177.011-.178.01-.179.008-.179.008-.181.006-.182.005-.182.004-.184.003-.184.002h-.37l-.184-.002-.184-.003-.182-.004-.182-.005-.181-.006-.179-.008-.179-.008-.178-.01-.176-.011-.176-.012-.175-.013-.173-.014-.172-.015-.171-.016-.17-.017-.169-.018-.167-.019-.166-.02-.165-.021-.163-.022-.162-.023-.161-.024-.159-.025-.157-.026-.156-.027-.155-.027-.153-.029-.151-.03-.15-.03-.148-.031-.146-.032-.145-.033-.143-.034-.141-.035-.14-.035-.137-.037-.136-.037-.134-.038-.132-.038-.13-.04-.128-.04-.126-.041-.124-.042-.122-.042-.12-.044-.117-.043-.116-.045-.113-.045-.112-.046-.109-.047-.106-.047-.105-.048-.102-.049-.1-.049-.097-.05-.095-.05-.093-.052-.09-.051-.087-.052-.085-.053-.083-.054-.08-.054-.077-.054v4.127zm0-5.654v.011l.001.021.003.021.004.021.005.022.006.022.007.022.009.022.01.022.011.023.012.023.013.023.015.024.016.023.017.024.018.024.019.024.021.024.022.024.023.025.024.024.052.05.056.05.061.05.066.051.07.051.075.052.079.051.084.052.088.052.092.052.097.052.102.052.105.052.11.051.114.051.119.052.123.05.127.051.131.05.135.049.139.049.144.048.147.048.152.047.155.046.16.045.163.045.167.044.171.042.176.042.178.04.183.04.187.038.19.037.194.036.197.034.202.033.204.032.209.03.212.028.216.027.219.025.222.024.226.022.23.02.233.018.236.016.24.014.243.012.246.01.249.008.253.006.256.003.259.001.26-.001.257-.003.254-.006.25-.008.247-.01.244-.012.241-.015.237-.016.233-.018.231-.02.226-.022.224-.024.22-.025.216-.027.212-.029.21-.03.205-.032.202-.033.198-.035.194-.036.191-.037.187-.039.183-.039.179-.041.175-.042.172-.043.168-.044.163-.045.16-.045.155-.047.152-.047.148-.048.143-.048.139-.05.136-.049.131-.05.126-.051.123-.051.118-.051.114-.052.11-.052.106-.052.101-.052.096-.052.092-.052.088-.052.083-.052.079-.052.074-.051.07-.052.065-.051.06-.05.056-.051.051-.049.023-.025.023-.024.021-.025.02-.024.019-.024.018-.024.017-.024.015-.023.014-.023.013-.024.012-.022.01-.023.01-.023.008-.022.006-.022.006-.022.004-.021.004-.022.001-.021.001-.021v-4.139l-.077.054-.08.054-.083.054-.085.052-.087.053-.09.051-.093.051-.095.051-.097.05-.1.049-.102.049-.105.048-.106.047-.109.047-.111.046-.114.045-.115.044-.118.044-.12.044-.122.042-.124.042-.126.041-.128.04-.13.039-.132.039-.134.038-.135.037-.138.036-.139.036-.142.035-.143.033-.144.033-.147.033-.148.031-.15.03-.151.03-.153.028-.154.028-.156.027-.158.026-.159.025-.161.024-.162.023-.163.022-.165.021-.166.02-.167.019-.169.018-.169.017-.171.016-.173.015-.173.014-.175.013-.175.012-.177.011-.178.009-.179.009-.179.007-.181.007-.182.005-.182.004-.184.003-.184.002h-.37l-.184-.002-.184-.003-.182-.004-.182-.005-.181-.007-.179-.007-.179-.009-.178-.009-.176-.011-.176-.012-.175-.013-.173-.014-.172-.015-.171-.016-.17-.017-.169-.018-.167-.019-.166-.02-.165-.021-.163-.022-.162-.023-.161-.024-.159-.025-.157-.026-.156-.027-.155-.028-.153-.028-.151-.03-.15-.03-.148-.031-.146-.033-.145-.033-.143-.033-.141-.035-.14-.036-.137-.036-.136-.037-.134-.038-.132-.039-.13-.039-.128-.04-.126-.041-.124-.042-.122-.043-.12-.043-.117-.044-.116-.044-.113-.046-.112-.046-.109-.046-.106-.047-.105-.048-.102-.049-.1-.049-.097-.05-.095-.051-.093-.051-.09-.051-.087-.053-.085-.052-.083-.054-.08-.054-.077-.054v4.139zm0-5.666v.011l.001.02.003.022.004.021.005.022.006.021.007.022.009.023.01.022.011.023.012.023.013.023.015.023.016.024.017.024.018.023.019.024.021.025.022.024.023.024.024.025.052.05.056.05.061.05.066.051.07.051.075.052.079.051.084.052.088.052.092.052.097.052.102.052.105.051.11.052.114.051.119.051.123.051.127.05.131.05.135.05.139.049.144.048.147.048.152.047.155.046.16.045.163.045.167.043.171.043.176.042.178.04.183.04.187.038.19.037.194.036.197.034.202.033.204.032.209.03.212.028.216.027.219.025.222.024.226.021.23.02.233.018.236.017.24.014.243.012.246.01.249.008.253.006.256.003.259.001.26-.001.257-.003.254-.006.25-.008.247-.01.244-.013.241-.014.237-.016.233-.018.231-.02.226-.022.224-.024.22-.025.216-.027.212-.029.21-.03.205-.032.202-.033.198-.035.194-.036.191-.037.187-.039.183-.039.179-.041.175-.042.172-.043.168-.044.163-.045.16-.045.155-.047.152-.047.148-.048.143-.049.139-.049.136-.049.131-.051.126-.05.123-.051.118-.052.114-.051.11-.052.106-.052.101-.052.096-.052.092-.052.088-.052.083-.052.079-.052.074-.052.07-.051.065-.051.06-.051.056-.05.051-.049.023-.025.023-.025.021-.024.02-.024.019-.024.018-.024.017-.024.015-.023.014-.024.013-.023.012-.023.01-.022.01-.023.008-.022.006-.022.006-.022.004-.022.004-.021.001-.021.001-.021v-4.153l-.077.054-.08.054-.083.053-.085.053-.087.053-.09.051-.093.051-.095.051-.097.05-.1.049-.102.048-.105.048-.106.048-.109.046-.111.046-.114.046-.115.044-.118.044-.12.043-.122.043-.124.042-.126.041-.128.04-.13.039-.132.039-.134.038-.135.037-.138.036-.139.036-.142.034-.143.034-.144.033-.147.032-.148.032-.15.03-.151.03-.153.028-.154.028-.156.027-.158.026-.159.024-.161.024-.162.023-.163.023-.165.021-.166.02-.167.019-.169.018-.169.017-.171.016-.173.015-.173.014-.175.013-.175.012-.177.01-.178.01-.179.009-.179.007-.181.006-.182.006-.182.004-.184.003-.184.001-.185.001-.185-.001-.184-.001-.184-.003-.182-.004-.182-.006-.181-.006-.179-.007-.179-.009-.178-.01-.176-.01-.176-.012-.175-.013-.173-.014-.172-.015-.171-.016-.17-.017-.169-.018-.167-.019-.166-.02-.165-.021-.163-.023-.162-.023-.161-.024-.159-.024-.157-.026-.156-.027-.155-.028-.153-.028-.151-.03-.15-.03-.148-.032-.146-.032-.145-.033-.143-.034-.141-.034-.14-.036-.137-.036-.136-.037-.134-.038-.132-.039-.13-.039-.128-.041-.126-.041-.124-.041-.122-.043-.12-.043-.117-.044-.116-.044-.113-.046-.112-.046-.109-.046-.106-.048-.105-.048-.102-.048-.1-.05-.097-.049-.095-.051-.093-.051-.09-.052-.087-.052-.085-.053-.083-.053-.08-.054-.077-.054v4.153zm8.74-8.179l-.257.004-.254.005-.25.008-.247.011-.244.012-.241.014-.237.016-.233.018-.231.021-.226.022-.224.023-.22.026-.216.027-.212.028-.21.031-.205.032-.202.033-.198.034-.194.036-.191.038-.187.038-.183.04-.179.041-.175.042-.172.043-.168.043-.163.045-.16.046-.155.046-.152.048-.148.048-.143.048-.139.049-.136.05-.131.05-.126.051-.123.051-.118.051-.114.052-.11.052-.106.052-.101.052-.096.052-.092.052-.088.052-.083.052-.079.052-.074.051-.07.052-.065.051-.06.05-.056.05-.051.05-.023.025-.023.024-.021.024-.02.025-.019.024-.018.024-.017.023-.015.024-.014.023-.013.023-.012.023-.01.023-.01.022-.008.022-.006.023-.006.021-.004.022-.004.021-.001.021-.001.021.001.021.001.021.004.021.004.022.006.021.006.023.008.022.01.022.01.023.012.023.013.023.014.023.015.024.017.023.018.024.019.024.02.025.021.024.023.024.023.025.051.05.056.05.06.05.065.051.07.052.074.051.079.052.083.052.088.052.092.052.096.052.101.052.106.052.11.052.114.052.118.051.123.051.126.051.131.05.136.05.139.049.143.048.148.048.152.048.155.046.16.046.163.045.168.043.172.043.175.042.179.041.183.04.187.038.191.038.194.036.198.034.202.033.205.032.21.031.212.028.216.027.22.026.224.023.226.022.231.021.233.018.237.016.241.014.244.012.247.011.25.008.254.005.257.004.26.001.26-.001.257-.004.254-.005.25-.008.247-.011.244-.012.241-.014.237-.016.233-.018.231-.021.226-.022.224-.023.22-.026.216-.027.212-.028.21-.031.205-.032.202-.033.198-.034.194-.036.191-.038.187-.038.183-.04.179-.041.175-.042.172-.043.168-.043.163-.045.16-.046.155-.046.152-.048.148-.048.143-.048.139-.049.136-.05.131-.05.126-.051.123-.051.118-.051.114-.052.11-.052.106-.052.101-.052.096-.052.092-.052.088-.052.083-.052.079-.052.074-.051.07-.052.065-.051.06-.05.056-.05.051-.05.023-.025.023-.024.021-.024.02-.025.019-.024.018-.024.017-.023.015-.024.014-.023.013-.023.012-.023.01-.023.01-.022.008-.022.006-.023.006-.021.004-.022.004-.021.001-.021.001-.021-.001-.021-.001-.021-.004-.021-.004-.022-.006-.021-.006-.023-.008-.022-.01-.022-.01-.023-.012-.023-.013-.023-.014-.023-.015-.024-.017-.023-.018-.024-.019-.024-.02-.025-.021-.024-.023-.024-.023-.025-.051-.05-.056-.05-.06-.05-.065-.051-.07-.052-.074-.051-.079-.052-.083-.052-.088-.052-.092-.052-.096-.052-.101-.052-.106-.052-.11-.052-.114-.052-.118-.051-.123-.051-.126-.051-.131-.05-.136-.05-.139-.049-.143-.048-.148-.048-.152-.048-.155-.046-.16-.046-.163-.045-.168-.043-.172-.043-.175-.042-.179-.041-.183-.04-.187-.038-.191-.038-.194-.036-.198-.034-.202-.033-.205-.032-.21-.031-.212-.028-.216-.027-.22-.026-.224-.023-.226-.022-.231-.021-.233-.018-.237-.016-.241-.014-.244-.012-.247-.011-.25-.008-.254-.005-.257-.004-.26-.001-.26.001z")},"insertDatabaseIcon"),ns=f(function(e){e.append("defs").append("symbol").attr("id","computer").attr("width","24").attr("height","24").append("path").attr("transform","scale(.5)").attr("d","M2 2v13h20v-13h-20zm18 11h-16v-9h16v9zm-10.228 6l.466-1h3.524l.467 1h-4.457zm14.228 3h-24l2-6h2.104l-1.33 4h18.45l-1.297-4h2.073l2 6zm-5-10h-14v-7h14v7z")},"insertComputerIcon"),os=f(function(e){e.append("defs").append("symbol").attr("id","clock").attr("width","24").attr("height","24").append("path").attr("transform","scale(.5)").attr("d","M12 2c5.514 0 10 4.486 10 10s-4.486 10-10 10-10-4.486-10-10 4.486-10 10-10zm0-2c-6.627 0-12 5.373-12 12s5.373 12 12 12 12-5.373 12-12-5.373-12-12-12zm5.848 12.459c.202.038.202.333.001.372-1.907.361-6.045 1.111-6.547 1.111-.719 0-1.301-.582-1.301-1.301 0-.512.77-5.447 1.125-7.445.034-.192.312-.181.343.014l.985 6.238 5.394 1.011z")},"insertClockIcon"),cs=f(function(e){e.append("defs").append("marker").attr("id","arrowhead").attr("refX",7.9).attr("refY",5).attr("markerUnits","userSpaceOnUse").attr("markerWidth",12).attr("markerHeight",12).attr("orient","auto-start-reverse").append("path").attr("d","M -1 0 L 10 5 L 0 10 z")},"insertArrowHead"),ls=f(function(e){e.append("defs").append("marker").attr("id","filled-head").attr("refX",15.5).attr("refY",7).attr("markerWidth",20).attr("markerHeight",28).attr("orient","auto").append("path").attr("d","M 18,7 L9,13 L14,7 L9,1 Z")},"insertArrowFilledHead"),hs=f(function(e){e.append("defs").append("marker").attr("id","sequencenumber").attr("refX",15).attr("refY",15).attr("markerWidth",60).attr("markerHeight",40).attr("orient","auto").append("circle").attr("cx",15).attr("cy",15).attr("r",6)},"insertSequenceNumber"),ds=f(function(e){e.append("defs").append("marker").attr("id","crosshead").attr("markerWidth",15).attr("markerHeight",8).attr("orient","auto").attr("refX",4).attr("refY",4.5).append("path").attr("fill","none").attr("stroke","#000000").style("stroke-dasharray","0, 0").attr("stroke-width","1pt").attr("d","M 1,2 L 6,7 M 6,2 L 1,7")},"insertArrowCrossHead"),he=f(function(){return{x:0,y:0,fill:void 0,anchor:void 0,style:"#666",width:void 0,height:void 0,textMargin:0,rx:0,ry:0,tspan:!0,valign:void 0}},"getTextObj"),ps=f(function(){return{x:0,y:0,fill:"#EDF2AE",stroke:"#666",width:100,anchor:"start",height:100,rx:0,ry:0}},"getNoteRect"),dt=(function(){function e(i,c,h,o,a,p,g){const x=c.append("text").attr("x",h+a/2).attr("y",o+p/2+5).style("text-anchor","middle").text(i);r(x,g)}f(e,"byText");function t(i,c,h,o,a,p,g,x){const{actorFontSize:y,actorFontFamily:m,actorFontWeight:w}=x,[k,N]=ie(y),S=i.split(I.lineBreakRegex);for(let O=0;O<S.length;O++){const B=O*k-k*(S.length-1)/2,q=c.append("text").attr("x",h+a/2).attr("y",o).style("text-anchor","middle").style("font-size",N).style("font-weight",w).style("font-family",m);q.append("tspan").attr("x",h+a/2).attr("dy",B).text(S[O]),q.attr("y",o+p/2).attr("dominant-baseline","central").attr("alignment-baseline","central"),r(q,g)}}f(t,"byTspan");function n(i,c,h,o,a,p,g,x){const y=c.append("switch"),w=y.append("foreignObject").attr("x",h).attr("y",o).attr("width",a).attr("height",p).append("xhtml:div").style("display","table").style("height","100%").style("width","100%");w.append("div").style("display","table-cell").style("text-align","center").style("vertical-align","middle").text(i),t(i,y,h,o,a,p,g,x),r(w,g)}f(n,"byFo");async function s(i,c,h,o,a,p,g,x){const y=await _t(i,Ht()),m=c.append("switch"),k=m.append("foreignObject").attr("x",h+a/2-y.width/2).attr("y",o+p/2-y.height/2).attr("width",y.width).attr("height",y.height).append("xhtml:div").style("height","100%").style("width","100%");k.append("div").style("text-align","center").style("vertical-align","middle").html(await ne(i,Ht())),t(i,m,h,o,a,p,g,x),r(k,g)}f(s,"byKatex");function r(i,c){for(const h in c)c.hasOwnProperty(h)&&i.attr(h,c[h])}return f(r,"_setTextAttrs"),function(i,c=!1){return c?s:i.textPlacement==="fo"?n:i.textPlacement==="old"?e:t}})(),us=(function(){function e(r,i,c,h,o,a,p){const g=i.append("text").attr("x",c).attr("y",h).style("text-anchor","start").text(r);s(g,p)}f(e,"byText");function t(r,i,c,h,o,a,p,g){const{actorFontSize:x,actorFontFamily:y,actorFontWeight:m}=g,w=r.split(I.lineBreakRegex);for(let k=0;k<w.length;k++){const N=k*x-x*(w.length-1)/2,S=i.append("text").attr("x",c).attr("y",h).style("text-anchor","start").style("font-size",x).style("font-weight",m).style("font-family",y);S.append("tspan").attr("x",c).attr("dy",N).text(w[k]),S.attr("y",h+a/2).attr("dominant-baseline","central").attr("alignment-baseline","central"),s(S,p)}}f(t,"byTspan");function n(r,i,c,h,o,a,p,g){const x=i.append("switch"),m=x.append("foreignObject").attr("x",c).attr("y",h).attr("width",o).attr("height",a).append("xhtml:div").style("display","table").style("height","100%").style("width","100%");m.append("div").style("display","table-cell").style("text-align","center").style("vertical-align","middle").text(r),t(r,x,c,h,o,a,p,g),s(m,p)}f(n,"byFo");function s(r,i){for(const c in i)i.hasOwnProperty(c)&&r.attr(c,i[c])}return f(s,"_setTextAttrs"),function(r){return r.textPlacement==="fo"?n:r.textPlacement==="old"?e:t}})(),V={drawRect:Lt,drawText:vt,drawLabel:oe,drawActor:ts,drawBox:es,drawPopup:Ue,anchorElement:ss,drawActivation:as,drawLoop:rs,drawBackgroundRect:le,insertArrowHead:cs,insertArrowFilledHead:ls,insertSequenceNumber:hs,insertArrowCrossHead:ds,insertDatabaseIcon:is,insertComputerIcon:ns,insertClockIcon:os,getTextObj:he,getNoteRect:ps,fixLifeLineHeights:ce,sanitizeUrl:re.sanitizeUrl},l={},T={data:{startx:void 0,stopx:void 0,starty:void 0,stopy:void 0},verticalPos:0,sequenceItems:[],activations:[],models:{getHeight:f(function(){return Math.max.apply(null,this.actors.length===0?[0]:this.actors.map(e=>e.height||0))+(this.loops.length===0?0:this.loops.map(e=>e.height||0).reduce((e,t)=>e+t))+(this.messages.length===0?0:this.messages.map(e=>e.height||0).reduce((e,t)=>e+t))+(this.notes.length===0?0:this.notes.map(e=>e.height||0).reduce((e,t)=>e+t))},"getHeight"),clear:f(function(){this.actors=[],this.boxes=[],this.loops=[],this.messages=[],this.notes=[]},"clear"),addBox:f(function(e){this.boxes.push(e)},"addBox"),addActor:f(function(e){this.actors.push(e)},"addActor"),addLoop:f(function(e){this.loops.push(e)},"addLoop"),addMessage:f(function(e){this.messages.push(e)},"addMessage"),addNote:f(function(e){this.notes.push(e)},"addNote"),lastActor:f(function(){return this.actors[this.actors.length-1]},"lastActor"),lastLoop:f(function(){return this.loops[this.loops.length-1]},"lastLoop"),lastMessage:f(function(){return this.messages[this.messages.length-1]},"lastMessage"),lastNote:f(function(){return this.notes[this.notes.length-1]},"lastNote"),actors:[],boxes:[],loops:[],messages:[],notes:[]},init:f(function(){this.sequenceItems=[],this.activations=[],this.models.clear(),this.data={startx:void 0,stopx:void 0,starty:void 0,stopy:void 0},this.verticalPos=0,ue(st())},"init"),updateVal:f(function(e,t,n,s){e[t]===void 0?e[t]=n:e[t]=s(n,e[t])},"updateVal"),updateBounds:f(function(e,t,n,s){const r=this;let i=0;function c(h){return f(function(a){i++;const p=r.sequenceItems.length-i+1;r.updateVal(a,"starty",t-p*l.boxMargin,Math.min),r.updateVal(a,"stopy",s+p*l.boxMargin,Math.max),r.updateVal(T.data,"startx",e-p*l.boxMargin,Math.min),r.updateVal(T.data,"stopx",n+p*l.boxMargin,Math.max),h!=="activation"&&(r.updateVal(a,"startx",e-p*l.boxMargin,Math.min),r.updateVal(a,"stopx",n+p*l.boxMargin,Math.max),r.updateVal(T.data,"starty",t-p*l.boxMargin,Math.min),r.updateVal(T.data,"stopy",s+p*l.boxMargin,Math.max))},"updateItemBounds")}f(c,"updateFn"),this.sequenceItems.forEach(c()),this.activations.forEach(c("activation"))},"updateBounds"),insert:f(function(e,t,n,s){const r=I.getMin(e,n),i=I.getMax(e,n),c=I.getMin(t,s),h=I.getMax(t,s);this.updateVal(T.data,"startx",r,Math.min),this.updateVal(T.data,"starty",c,Math.min),this.updateVal(T.data,"stopx",i,Math.max),this.updateVal(T.data,"stopy",h,Math.max),this.updateBounds(r,c,i,h)},"insert"),newActivation:f(function(e,t,n){const s=n.get(e.from),r=Bt(e.from).length||0,i=s.x+s.width/2+(r-1)*l.activationWidth/2;this.activations.push({startx:i,starty:this.verticalPos+2,stopx:i+l.activationWidth,stopy:void 0,actor:e.from,anchored:V.anchorElement(t)})},"newActivation"),endActivation:f(function(e){const t=this.activations.map(function(n){return n.actor}).lastIndexOf(e.from);return this.activations.splice(t,1)[0]},"endActivation"),createLoop:f(function(e={message:void 0,wrap:!1,width:void 0},t){return{startx:void 0,starty:this.verticalPos,stopx:void 0,stopy:void 0,title:e.message,wrap:e.wrap,width:e.width,height:0,fill:t}},"createLoop"),newLoop:f(function(e={message:void 0,wrap:!1,width:void 0},t){this.sequenceItems.push(this.createLoop(e,t))},"newLoop"),endLoop:f(function(){return this.sequenceItems.pop()},"endLoop"),isLoopOverlap:f(function(){return this.sequenceItems.length?this.sequenceItems[this.sequenceItems.length-1].overlap:!1},"isLoopOverlap"),addSectionToLoop:f(function(e){const t=this.sequenceItems.pop();t.sections=t.sections||[],t.sectionTitles=t.sectionTitles||[],t.sections.push({y:T.getVerticalPos(),height:0}),t.sectionTitles.push(e),this.sequenceItems.push(t)},"addSectionToLoop"),saveVerticalPos:f(function(){this.isLoopOverlap()&&(this.savedVerticalPos=this.verticalPos)},"saveVerticalPos"),resetVerticalPos:f(function(){this.isLoopOverlap()&&(this.verticalPos=this.savedVerticalPos)},"resetVerticalPos"),bumpVerticalPos:f(function(e){this.verticalPos=this.verticalPos+e,this.data.stopy=I.getMax(this.data.stopy,this.verticalPos)},"bumpVerticalPos"),getVerticalPos:f(function(){return this.verticalPos},"getVerticalPos"),getBounds:f(function(){return{bounds:this.data,models:this.models}},"getBounds")},gs=f(async function(e,t){T.bumpVerticalPos(l.boxMargin),t.height=l.boxMargin,t.starty=T.getVerticalPos();const n=ct();n.x=t.startx,n.y=t.starty,n.width=t.width||l.width,n.class="note";const s=e.append("g"),r=V.drawRect(s,n),i=Xt();i.x=t.startx,i.y=t.starty,i.width=n.width,i.dy="1em",i.text=t.message,i.class="noteText",i.fontFamily=l.noteFontFamily,i.fontSize=l.noteFontSize,i.fontWeight=l.noteFontWeight,i.anchor=l.noteAlign,i.textMargin=l.noteMargin,i.valign="center";const c=z(i.text)?await Dt(s,i):vt(s,i),h=Math.round(c.map(o=>(o._groups||o)[0][0].getBBox().height).reduce((o,a)=>o+a));r.attr("height",h+2*l.noteMargin),t.height+=h+2*l.noteMargin,T.bumpVerticalPos(h+2*l.noteMargin),t.stopy=t.starty+h+2*l.noteMargin,t.stopx=t.startx+n.width,T.insert(t.startx,t.starty,t.stopx,t.stopy),T.models.addNote(t)},"drawNote"),Et=f(e=>({fontFamily:e.messageFontFamily,fontSize:e.messageFontSize,fontWeight:e.messageFontWeight}),"messageFont"),mt=f(e=>({fontFamily:e.noteFontFamily,fontSize:e.noteFontSize,fontWeight:e.noteFontWeight}),"noteFont"),Gt=f(e=>({fontFamily:e.actorFontFamily,fontSize:e.actorFontSize,fontWeight:e.actorFontWeight}),"actorFont");async function de(e,t){T.bumpVerticalPos(10);const{startx:n,stopx:s,message:r}=t,i=I.splitBreaks(r).length,c=z(r),h=c?await _t(r,st()):W.calculateTextDimensions(r,Et(l));if(!c){const g=h.height/i;t.height+=g,T.bumpVerticalPos(g)}let o,a=h.height-10;const p=h.width;if(n===s){o=T.getVerticalPos()+a,l.rightAngles||(a+=l.boxMargin,o=T.getVerticalPos()+a),a+=30;const g=I.getMax(p/2,l.width/2);T.insert(n-g,T.getVerticalPos()-10+a,s+g,T.getVerticalPos()+30+a)}else a+=l.boxMargin,o=T.getVerticalPos()+a,T.insert(n,o-10,s,o);return T.bumpVerticalPos(a),t.height+=a,t.stopy=t.starty+t.height,T.insert(t.fromBounds,t.starty,t.toBounds,t.stopy),o}f(de,"boundMessage");var xs=f(async function(e,t,n,s){const{startx:r,stopx:i,starty:c,message:h,type:o,sequenceIndex:a,sequenceVisible:p}=t,g=W.calculateTextDimensions(h,Et(l)),x=Xt();x.x=r,x.y=c+10,x.width=i-r,x.class="messageText",x.dy="1em",x.text=h,x.fontFamily=l.messageFontFamily,x.fontSize=l.messageFontSize,x.fontWeight=l.messageFontWeight,x.anchor=l.messageAlign,x.valign="center",x.textMargin=l.wrapPadding,x.tspan=!1,z(x.text)?await Dt(e,x,{startx:r,stopx:i,starty:n}):vt(e,x);const y=g.width;let m;r===i?l.rightAngles?m=e.append("path").attr("d",`M  ${r},${n} H ${r+I.getMax(l.width/2,y/2)} V ${n+25} H ${r}`):m=e.append("path").attr("d","M "+r+","+n+" C "+(r+60)+","+(n-10)+" "+(r+60)+","+(n+30)+" "+r+","+(n+20)):(m=e.append("line"),m.attr("x1",r),m.attr("y1",n),m.attr("x2",i),m.attr("y2",n)),o===s.db.LINETYPE.DOTTED||o===s.db.LINETYPE.DOTTED_CROSS||o===s.db.LINETYPE.DOTTED_POINT||o===s.db.LINETYPE.DOTTED_OPEN||o===s.db.LINETYPE.BIDIRECTIONAL_DOTTED?(m.style("stroke-dasharray","3, 3"),m.attr("class","messageLine1")):m.attr("class","messageLine0");let w="";l.arrowMarkerAbsolute&&(w=Oe(!0)),m.attr("stroke-width",2),m.attr("stroke","none"),m.style("fill","none"),(o===s.db.LINETYPE.SOLID||o===s.db.LINETYPE.DOTTED)&&m.attr("marker-end","url("+w+"#arrowhead)"),(o===s.db.LINETYPE.BIDIRECTIONAL_SOLID||o===s.db.LINETYPE.BIDIRECTIONAL_DOTTED)&&(m.attr("marker-start","url("+w+"#arrowhead)"),m.attr("marker-end","url("+w+"#arrowhead)")),(o===s.db.LINETYPE.SOLID_POINT||o===s.db.LINETYPE.DOTTED_POINT)&&m.attr("marker-end","url("+w+"#filled-head)"),(o===s.db.LINETYPE.SOLID_CROSS||o===s.db.LINETYPE.DOTTED_CROSS)&&m.attr("marker-end","url("+w+"#crosshead)"),(p||l.showSequenceNumbers)&&((o===s.db.LINETYPE.BIDIRECTIONAL_SOLID||o===s.db.LINETYPE.BIDIRECTIONAL_DOTTED)&&(r<i?m.attr("x1",r+12):m.attr("x1",r+6)),e.append("line").attr("x1",r).attr("y1",n).attr("x2",r).attr("y2",n).attr("stroke-width",0).attr("marker-start","url("+w+"#sequencenumber)"),e.append("text").attr("x",r).attr("y",n+4).attr("font-family","sans-serif").attr("font-size","12px").attr("text-anchor","middle").attr("class","sequenceNumber").text(a))},"drawMessage"),fs=f(function(e,t,n,s,r,i,c){let h=0,o=0,a,p=0;for(const g of s){const x=t.get(g),y=x.box;a&&a!=y&&(c||T.models.addBox(a),o+=l.boxMargin+a.margin),y&&y!=a&&(c||(y.x=h+o,y.y=r),o+=y.margin),x.width=x.width||l.width,x.height=I.getMax(x.height||l.height,l.height),x.margin=x.margin||l.actorMargin,p=I.getMax(p,x.height),n.get(x.name)&&(o+=x.width/2),x.x=h+o,x.starty=T.getVerticalPos(),T.insert(x.x,r,x.x+x.width,x.height),h+=x.width+o,x.box&&(x.box.width=h+y.margin-x.box.x),o=x.margin,a=x.box,T.models.addActor(x)}a&&!c&&T.models.addBox(a),T.bumpVerticalPos(p)},"addActorRenderingData"),Kt=f(async function(e,t,n,s){if(s){let r=0;T.bumpVerticalPos(l.boxMargin*2);for(const i of n){const c=t.get(i);c.stopy||(c.stopy=T.getVerticalPos());const h=await V.drawActor(e,c,l,!0);r=I.getMax(r,h)}T.bumpVerticalPos(r+l.boxMargin)}else for(const r of n){const i=t.get(r);await V.drawActor(e,i,l,!1)}},"drawActors"),pe=f(function(e,t,n,s){let r=0,i=0;for(const c of n){const h=t.get(c),o=Ts(h),a=V.drawPopup(e,h,o,l,l.forceMenus,s);a.height>r&&(r=a.height),a.width+h.x>i&&(i=a.width+h.x)}return{maxHeight:r,maxWidth:i}},"drawActorsPopup"),ue=f(function(e){_e(l,e),e.fontFamily&&(l.actorFontFamily=l.noteFontFamily=l.messageFontFamily=e.fontFamily),e.fontSize&&(l.actorFontSize=l.noteFontSize=l.messageFontSize=e.fontSize),e.fontWeight&&(l.actorFontWeight=l.noteFontWeight=l.messageFontWeight=e.fontWeight)},"setConf"),Bt=f(function(e){return T.activations.filter(function(t){return t.actor===e})},"actorActivations"),ae=f(function(e,t){const n=t.get(e),s=Bt(e),r=s.reduce(function(c,h){return I.getMin(c,h.startx)},n.x+n.width/2-1),i=s.reduce(function(c,h){return I.getMax(c,h.stopx)},n.x+n.width/2+1);return[r,i]},"activationBounds");function nt(e,t,n,s,r){T.bumpVerticalPos(n);let i=s;if(t.id&&t.message&&e[t.id]){const c=e[t.id].width,h=Et(l);t.message=W.wrapLabel(`[${t.message}]`,c-2*l.wrapPadding,h),t.width=c,t.wrap=!0;const o=W.calculateTextDimensions(t.message,h),a=I.getMax(o.height,l.labelBoxHeight);i=s+a,Q.debug(`${a} - ${t.message}`)}r(t),T.bumpVerticalPos(i)}f(nt,"adjustLoopHeightForWrap");function ge(e,t,n,s,r,i,c){function h(p,g){p.x<r.get(e.from).x?(T.insert(t.stopx-g,t.starty,t.startx,t.stopy+p.height/2+l.noteMargin),t.stopx=t.stopx+g):(T.insert(t.startx,t.starty,t.stopx+g,t.stopy+p.height/2+l.noteMargin),t.stopx=t.stopx-g)}f(h,"receiverAdjustment");function o(p,g){p.x<r.get(e.to).x?(T.insert(t.startx-g,t.starty,t.stopx,t.stopy+p.height/2+l.noteMargin),t.startx=t.startx+g):(T.insert(t.stopx,t.starty,t.startx+g,t.stopy+p.height/2+l.noteMargin),t.startx=t.startx-g)}f(o,"senderAdjustment");const a=[Rt.ACTOR,Rt.CONTROL,Rt.ENTITY,Rt.DATABASE];if(i.get(e.to)==s){const p=r.get(e.to),g=a.includes(p.type)?Tt/2+3:p.width/2+3;h(p,g),p.starty=n-p.height/2,T.bumpVerticalPos(p.height/2)}else if(c.get(e.from)==s){const p=r.get(e.from);if(l.mirrorActors){const g=a.includes(p.type)?Tt/2:p.width/2;o(p,g)}p.stopy=n-p.height/2,T.bumpVerticalPos(p.height/2)}else if(c.get(e.to)==s){const p=r.get(e.to);if(l.mirrorActors){const g=a.includes(p.type)?Tt/2+3:p.width/2+3;h(p,g)}p.stopy=n-p.height/2,T.bumpVerticalPos(p.height/2)}}f(ge,"adjustCreatedDestroyedData");var ys=f(async function(e,t,n,s){const{securityLevel:r,sequence:i}=st();l=i;let c;r==="sandbox"&&(c=St("#i"+t));const h=r==="sandbox"?St(c.nodes()[0].contentDocument.body):St("body"),o=r==="sandbox"?c.nodes()[0].contentDocument:document;T.init(),Q.debug(s.db);const a=r==="sandbox"?h.select(`[id="${t}"]`):St(`[id="${t}"]`),p=s.db.getActors(),g=s.db.getCreatedActors(),x=s.db.getDestroyedActors(),y=s.db.getBoxes();let m=s.db.getActorKeys();const w=s.db.getMessages(),k=s.db.getDiagramTitle(),N=s.db.hasAtLeastOneBox(),S=s.db.hasAtLeastOneBoxWithTitle(),O=await xe(p,w,s);if(l.height=await fe(p,O,y),V.insertComputerIcon(a),V.insertDatabaseIcon(a),V.insertClockIcon(a),N&&(T.bumpVerticalPos(l.boxMargin),S&&T.bumpVerticalPos(y[0].textMaxHeight)),l.hideUnusedParticipants===!0){const E=new Set;w.forEach(_=>{E.add(_.from),E.add(_.to)}),m=m.filter(_=>E.has(_))}fs(a,p,g,m,0,w,!1);const B=await ms(w,p,O,s);V.insertArrowHead(a),V.insertArrowCrossHead(a),V.insertArrowFilledHead(a),V.insertSequenceNumber(a);function q(E,_){const X=T.endActivation(E);X.starty+18>_&&(X.starty=_-6,_+=12),V.drawActivation(a,X,_,l,Bt(E.from).length),T.insert(X.startx,_-10,X.stopx,_)}f(q,"activeEnd");let H=1,Z=1;const at=[],U=[];let G=0;for(const E of w){let _,X,tt;switch(E.type){case s.db.LINETYPE.NOTE:T.resetVerticalPos(),X=E.noteModel,await gs(a,X);break;case s.db.LINETYPE.ACTIVE_START:T.newActivation(E,a,p);break;case s.db.LINETYPE.ACTIVE_END:q(E,T.getVerticalPos());break;case s.db.LINETYPE.LOOP_START:nt(B,E,l.boxMargin,l.boxMargin+l.boxTextMargin,M=>T.newLoop(M));break;case s.db.LINETYPE.LOOP_END:_=T.endLoop(),await V.drawLoop(a,_,"loop",l),T.bumpVerticalPos(_.stopy-T.getVerticalPos()),T.models.addLoop(_);break;case s.db.LINETYPE.RECT_START:nt(B,E,l.boxMargin,l.boxMargin,M=>T.newLoop(void 0,M.message));break;case s.db.LINETYPE.RECT_END:_=T.endLoop(),U.push(_),T.models.addLoop(_),T.bumpVerticalPos(_.stopy-T.getVerticalPos());break;case s.db.LINETYPE.OPT_START:nt(B,E,l.boxMargin,l.boxMargin+l.boxTextMargin,M=>T.newLoop(M));break;case s.db.LINETYPE.OPT_END:_=T.endLoop(),await V.drawLoop(a,_,"opt",l),T.bumpVerticalPos(_.stopy-T.getVerticalPos()),T.models.addLoop(_);break;case s.db.LINETYPE.ALT_START:nt(B,E,l.boxMargin,l.boxMargin+l.boxTextMargin,M=>T.newLoop(M));break;case s.db.LINETYPE.ALT_ELSE:nt(B,E,l.boxMargin+l.boxTextMargin,l.boxMargin,M=>T.addSectionToLoop(M));break;case s.db.LINETYPE.ALT_END:_=T.endLoop(),await V.drawLoop(a,_,"alt",l),T.bumpVerticalPos(_.stopy-T.getVerticalPos()),T.models.addLoop(_);break;case s.db.LINETYPE.PAR_START:case s.db.LINETYPE.PAR_OVER_START:nt(B,E,l.boxMargin,l.boxMargin+l.boxTextMargin,M=>T.newLoop(M)),T.saveVerticalPos();break;case s.db.LINETYPE.PAR_AND:nt(B,E,l.boxMargin+l.boxTextMargin,l.boxMargin,M=>T.addSectionToLoop(M));break;case s.db.LINETYPE.PAR_END:_=T.endLoop(),await V.drawLoop(a,_,"par",l),T.bumpVerticalPos(_.stopy-T.getVerticalPos()),T.models.addLoop(_);break;case s.db.LINETYPE.AUTONUMBER:H=E.message.start||H,Z=E.message.step||Z,E.message.visible?s.db.enableSequenceNumbers():s.db.disableSequenceNumbers();break;case s.db.LINETYPE.CRITICAL_START:nt(B,E,l.boxMargin,l.boxMargin+l.boxTextMargin,M=>T.newLoop(M));break;case s.db.LINETYPE.CRITICAL_OPTION:nt(B,E,l.boxMargin+l.boxTextMargin,l.boxMargin,M=>T.addSectionToLoop(M));break;case s.db.LINETYPE.CRITICAL_END:_=T.endLoop(),await V.drawLoop(a,_,"critical",l),T.bumpVerticalPos(_.stopy-T.getVerticalPos()),T.models.addLoop(_);break;case s.db.LINETYPE.BREAK_START:nt(B,E,l.boxMargin,l.boxMargin+l.boxTextMargin,M=>T.newLoop(M));break;case s.db.LINETYPE.BREAK_END:_=T.endLoop(),await V.drawLoop(a,_,"break",l),T.bumpVerticalPos(_.stopy-T.getVerticalPos()),T.models.addLoop(_);break;default:try{tt=E.msgModel,tt.starty=T.getVerticalPos(),tt.sequenceIndex=H,tt.sequenceVisible=s.db.showSequenceNumbers();const M=await de(a,tt);ge(E,tt,M,G,p,g,x),at.push({messageModel:tt,lineStartY:M}),T.models.addMessage(tt)}catch(M){Q.error("error while drawing message",M)}}[s.db.LINETYPE.SOLID_OPEN,s.db.LINETYPE.DOTTED_OPEN,s.db.LINETYPE.SOLID,s.db.LINETYPE.DOTTED,s.db.LINETYPE.SOLID_CROSS,s.db.LINETYPE.DOTTED_CROSS,s.db.LINETYPE.SOLID_POINT,s.db.LINETYPE.DOTTED_POINT,s.db.LINETYPE.BIDIRECTIONAL_SOLID,s.db.LINETYPE.BIDIRECTIONAL_DOTTED].includes(E.type)&&(H=H+Z),G++}Q.debug("createdActors",g),Q.debug("destroyedActors",x),await Kt(a,p,m,!1);for(const E of at)await xs(a,E.messageModel,E.lineStartY,s);l.mirrorActors&&await Kt(a,p,m,!0),U.forEach(E=>V.drawBackgroundRect(a,E)),ce(a,p,m,l);for(const E of T.models.boxes){E.height=T.getVerticalPos()-E.y,T.insert(E.x,E.y,E.x+E.width,E.height);const _=l.boxMargin*2;E.startx=E.x-_,E.starty=E.y-_*.25,E.stopx=E.startx+E.width+2*_,E.stopy=E.starty+E.height+_*.75,E.stroke="rgb(0,0,0, 0.5)",V.drawBox(a,E,l)}N&&T.bumpVerticalPos(l.boxMargin);const F=pe(a,p,m,o),{bounds:D}=T.getBounds();D.startx===void 0&&(D.startx=0),D.starty===void 0&&(D.starty=0),D.stopx===void 0&&(D.stopx=0),D.stopy===void 0&&(D.stopy=0);let $=D.stopy-D.starty;$<F.maxHeight&&($=F.maxHeight);let K=$+2*l.diagramMarginY;l.mirrorActors&&(K=K-l.boxMargin+l.bottomMarginAdj);let j=D.stopx-D.startx;j<F.maxWidth&&(j=F.maxWidth);const rt=j+2*l.diagramMarginX;k&&a.append("text").text(k).attr("x",(D.stopx-D.startx)/2-2*l.diagramMarginX).attr("y",-25),Le(a,K,rt,l.useMaxWidth);const R=k?40:0;a.attr("viewBox",D.startx-l.diagramMarginX+" -"+(l.diagramMarginY+R)+" "+rt+" "+(K+R)),Q.debug("models:",T.models)},"draw");async function xe(e,t,n){const s={};for(const r of t)if(e.get(r.to)&&e.get(r.from)){const i=e.get(r.to);if(r.placement===n.db.PLACEMENT.LEFTOF&&!i.prevActor||r.placement===n.db.PLACEMENT.RIGHTOF&&!i.nextActor)continue;const c=r.placement!==void 0,h=!c,o=c?mt(l):Et(l),a=r.wrap?W.wrapLabel(r.message,l.width-2*l.wrapPadding,o):r.message,g=(z(a)?await _t(r.message,st()):W.calculateTextDimensions(a,o)).width+2*l.wrapPadding;h&&r.from===i.nextActor?s[r.to]=I.getMax(s[r.to]||0,g):h&&r.from===i.prevActor?s[r.from]=I.getMax(s[r.from]||0,g):h&&r.from===r.to?(s[r.from]=I.getMax(s[r.from]||0,g/2),s[r.to]=I.getMax(s[r.to]||0,g/2)):r.placement===n.db.PLACEMENT.RIGHTOF?s[r.from]=I.getMax(s[r.from]||0,g):r.placement===n.db.PLACEMENT.LEFTOF?s[i.prevActor]=I.getMax(s[i.prevActor]||0,g):r.placement===n.db.PLACEMENT.OVER&&(i.prevActor&&(s[i.prevActor]=I.getMax(s[i.prevActor]||0,g/2)),i.nextActor&&(s[r.from]=I.getMax(s[r.from]||0,g/2)))}return Q.debug("maxMessageWidthPerActor:",s),s}f(xe,"getMaxMessageWidthPerActor");var Ts=f(function(e){let t=0;const n=Gt(l);for(const s in e.links){const i=W.calculateTextDimensions(s,n).width+2*l.wrapPadding+2*l.boxMargin;t<i&&(t=i)}return t},"getRequiredPopupWidth");async function fe(e,t,n){let s=0;for(const i of e.keys()){const c=e.get(i);c.wrap&&(c.description=W.wrapLabel(c.description,l.width-2*l.wrapPadding,Gt(l)));const h=z(c.description)?await _t(c.description,st()):W.calculateTextDimensions(c.description,Gt(l));c.width=c.wrap?l.width:I.getMax(l.width,h.width+2*l.wrapPadding),c.height=c.wrap?I.getMax(h.height,l.height):l.height,s=I.getMax(s,c.height)}for(const i in t){const c=e.get(i);if(!c)continue;const h=e.get(c.nextActor);if(!h){const g=t[i]+l.actorMargin-c.width/2;c.margin=I.getMax(g,l.actorMargin);continue}const a=t[i]+l.actorMargin-c.width/2-h.width/2;c.margin=I.getMax(a,l.actorMargin)}let r=0;return n.forEach(i=>{const c=Et(l);let h=i.actorKeys.reduce((g,x)=>g+=e.get(x).width+(e.get(x).margin||0),0);const o=l.boxMargin*8;h+=o,h-=2*l.boxTextMargin,i.wrap&&(i.name=W.wrapLabel(i.name,h-2*l.wrapPadding,c));const a=W.calculateTextDimensions(i.name,c);r=I.getMax(a.height,r);const p=I.getMax(h,a.width+2*l.wrapPadding);if(i.margin=l.boxTextMargin,h<p){const g=(p-h)/2;i.margin+=g}}),n.forEach(i=>i.textMaxHeight=r),I.getMax(s,l.height)}f(fe,"calculateActorMargins");var Es=f(async function(e,t,n){const s=t.get(e.from),r=t.get(e.to),i=s.x,c=r.x,h=e.wrap&&e.message;let o=z(e.message)?await _t(e.message,st()):W.calculateTextDimensions(h?W.wrapLabel(e.message,l.width,mt(l)):e.message,mt(l));const a={width:h?l.width:I.getMax(l.width,o.width+2*l.noteMargin),height:0,startx:s.x,stopx:0,starty:0,stopy:0,message:e.message};return e.placement===n.db.PLACEMENT.RIGHTOF?(a.width=h?I.getMax(l.width,o.width):I.getMax(s.width/2+r.width/2,o.width+2*l.noteMargin),a.startx=i+(s.width+l.actorMargin)/2):e.placement===n.db.PLACEMENT.LEFTOF?(a.width=h?I.getMax(l.width,o.width+2*l.noteMargin):I.getMax(s.width/2+r.width/2,o.width+2*l.noteMargin),a.startx=i-a.width+(s.width-l.actorMargin)/2):e.to===e.from?(o=W.calculateTextDimensions(h?W.wrapLabel(e.message,I.getMax(l.width,s.width),mt(l)):e.message,mt(l)),a.width=h?I.getMax(l.width,s.width):I.getMax(s.width,l.width,o.width+2*l.noteMargin),a.startx=i+(s.width-a.width)/2):(a.width=Math.abs(i+s.width/2-(c+r.width/2))+l.actorMargin,a.startx=i<c?i+s.width/2-l.actorMargin/2:c+r.width/2-l.actorMargin/2),h&&(a.message=W.wrapLabel(e.message,a.width-2*l.wrapPadding,mt(l))),Q.debug(`NM:[${a.startx},${a.stopx},${a.starty},${a.stopy}:${a.width},${a.height}=${e.message}]`),a},"buildNoteModel"),bs=f(function(e,t,n){if(![n.db.LINETYPE.SOLID_OPEN,n.db.LINETYPE.DOTTED_OPEN,n.db.LINETYPE.SOLID,n.db.LINETYPE.DOTTED,n.db.LINETYPE.SOLID_CROSS,n.db.LINETYPE.DOTTED_CROSS,n.db.LINETYPE.SOLID_POINT,n.db.LINETYPE.DOTTED_POINT,n.db.LINETYPE.BIDIRECTIONAL_SOLID,n.db.LINETYPE.BIDIRECTIONAL_DOTTED].includes(e.type))return{};const[s,r]=ae(e.from,t),[i,c]=ae(e.to,t),h=s<=i;let o=h?r:s,a=h?i:c;const p=Math.abs(i-c)>2,g=f(w=>h?-w:w,"adjustValue");e.from===e.to?a=o:(e.activate&&!p&&(a+=g(l.activationWidth/2-1)),[n.db.LINETYPE.SOLID_OPEN,n.db.LINETYPE.DOTTED_OPEN].includes(e.type)||(a+=g(3)),[n.db.LINETYPE.BIDIRECTIONAL_SOLID,n.db.LINETYPE.BIDIRECTIONAL_DOTTED].includes(e.type)&&(o-=g(3)));const x=[s,r,i,c],y=Math.abs(o-a);e.wrap&&e.message&&(e.message=W.wrapLabel(e.message,I.getMax(y+2*l.wrapPadding,l.width),Et(l)));const m=W.calculateTextDimensions(e.message,Et(l));return{width:I.getMax(e.wrap?0:m.width+2*l.wrapPadding,y+2*l.wrapPadding,l.width),height:0,startx:o,stopx:a,starty:0,stopy:0,message:e.message,type:e.type,wrap:e.wrap,fromBounds:Math.min.apply(null,x),toBounds:Math.max.apply(null,x)}},"buildMessageModel"),ms=f(async function(e,t,n,s){const r={},i=[];let c,h,o;for(const a of e){switch(a.type){case s.db.LINETYPE.LOOP_START:case s.db.LINETYPE.ALT_START:case s.db.LINETYPE.OPT_START:case s.db.LINETYPE.PAR_START:case s.db.LINETYPE.PAR_OVER_START:case s.db.LINETYPE.CRITICAL_START:case s.db.LINETYPE.BREAK_START:i.push({id:a.id,msg:a.message,from:Number.MAX_SAFE_INTEGER,to:Number.MIN_SAFE_INTEGER,width:0});break;case s.db.LINETYPE.ALT_ELSE:case s.db.LINETYPE.PAR_AND:case s.db.LINETYPE.CRITICAL_OPTION:a.message&&(c=i.pop(),r[c.id]=c,r[a.id]=c,i.push(c));break;case s.db.LINETYPE.LOOP_END:case s.db.LINETYPE.ALT_END:case s.db.LINETYPE.OPT_END:case s.db.LINETYPE.PAR_END:case s.db.LINETYPE.CRITICAL_END:case s.db.LINETYPE.BREAK_END:c=i.pop(),r[c.id]=c;break;case s.db.LINETYPE.ACTIVE_START:{const g=t.get(a.from?a.from:a.to.actor),x=Bt(a.from?a.from:a.to.actor).length,y=g.x+g.width/2+(x-1)*l.activationWidth/2,m={startx:y,stopx:y+l.activationWidth,actor:a.from,enabled:!0};T.activations.push(m)}break;case s.db.LINETYPE.ACTIVE_END:{const g=T.activations.map(x=>x.actor).lastIndexOf(a.from);T.activations.splice(g,1).splice(0,1)}break}a.placement!==void 0?(h=await Es(a,t,s),a.noteModel=h,i.forEach(g=>{c=g,c.from=I.getMin(c.from,h.startx),c.to=I.getMax(c.to,h.startx+h.width),c.width=I.getMax(c.width,Math.abs(c.from-c.to))-l.labelBoxWidth})):(o=bs(a,t,s),a.msgModel=o,o.startx&&o.stopx&&i.length>0&&i.forEach(g=>{if(c=g,o.startx===o.stopx){const x=t.get(a.from),y=t.get(a.to);c.from=I.getMin(x.x-o.width/2,x.x-x.width/2,c.from),c.to=I.getMax(y.x+o.width/2,y.x+x.width/2,c.to),c.width=I.getMax(c.width,Math.abs(c.to-c.from))-l.labelBoxWidth}else c.from=I.getMin(o.startx,c.from),c.to=I.getMax(o.stopx,c.to),c.width=I.getMax(c.width,o.width)-l.labelBoxWidth}))}return T.activations=[],Q.debug("Loop type widths:",r),r},"calculateLoopBounds"),ws={bounds:T,drawActors:Kt,drawActorsPopup:pe,setConf:ue,draw:ys},_s={parser:Ve,get db(){return new qe},renderer:ws,styles:He,init:f(e=>{e.sequence||(e.sequence={}),e.wrap&&(e.sequence.wrap=e.wrap,Ie({sequence:{wrap:e.wrap}}))},"init")};export{_s as diagram};
diff --git a/docs/dist/assets/stateDiagram-FKZM4ZOC-BtO6UYX1.js b/docs/dist/assets/stateDiagram-FKZM4ZOC-BtO6UYX1.js
deleted file mode 100644
index 2399f1db..00000000
--- a/docs/dist/assets/stateDiagram-FKZM4ZOC-BtO6UYX1.js
+++ /dev/null
@@ -1 +0,0 @@
-import{s as G,a as W,S as N}from"./chunk-DI55MBZ5-BODS175X.js";import{_ as f,c as t,d as H,l as S,e as P,k as z,R as _,S as U,O as C,u as F}from"./index-BxX29htg.js";import{G as O}from"./graph-DQwMrrst.js";import{l as J}from"./layout-Cg3H1pzX.js";import"./chunk-55IACEB6-BE1gdz1f.js";import"./chunk-QN33PNHL-1s4FuBGd.js";import"./_baseUniq-CfjWcJYV.js";import"./_basePickBy-CqMtcO3s.js";var X=f(e=>e.append("circle").attr("class","start-state").attr("r",t().state.sizeUnit).attr("cx",t().state.padding+t().state.sizeUnit).attr("cy",t().state.padding+t().state.sizeUnit),"drawStartState"),D=f(e=>e.append("line").style("stroke","grey").style("stroke-dasharray","3").attr("x1",t().state.textHeight).attr("class","divider").attr("x2",t().state.textHeight*2).attr("y1",0).attr("y2",0),"drawDivider"),Y=f((e,i)=>{const d=e.append("text").attr("x",2*t().state.padding).attr("y",t().state.textHeight+2*t().state.padding).attr("font-size",t().state.fontSize).attr("class","state-title").text(i.id),c=d.node().getBBox();return e.insert("rect",":first-child").attr("x",t().state.padding).attr("y",t().state.padding).attr("width",c.width+2*t().state.padding).attr("height",c.height+2*t().state.padding).attr("rx",t().state.radius),d},"drawSimpleState"),I=f((e,i)=>{const d=f(function(g,B,m){const E=g.append("tspan").attr("x",2*t().state.padding).text(B);m||E.attr("dy",t().state.textHeight)},"addTspan"),n=e.append("text").attr("x",2*t().state.padding).attr("y",t().state.textHeight+1.3*t().state.padding).attr("font-size",t().state.fontSize).attr("class","state-title").text(i.descriptions[0]).node().getBBox(),l=n.height,x=e.append("text").attr("x",t().state.padding).attr("y",l+t().state.padding*.4+t().state.dividerMargin+t().state.textHeight).attr("class","state-description");let a=!0,s=!0;i.descriptions.forEach(function(g){a||(d(x,g,s),s=!1),a=!1});const w=e.append("line").attr("x1",t().state.padding).attr("y1",t().state.padding+l+t().state.dividerMargin/2).attr("y2",t().state.padding+l+t().state.dividerMargin/2).attr("class","descr-divider"),p=x.node().getBBox(),o=Math.max(p.width,n.width);return w.attr("x2",o+3*t().state.padding),e.insert("rect",":first-child").attr("x",t().state.padding).attr("y",t().state.padding).attr("width",o+2*t().state.padding).attr("height",p.height+l+2*t().state.padding).attr("rx",t().state.radius),e},"drawDescrState"),$=f((e,i,d)=>{const c=t().state.padding,n=2*t().state.padding,l=e.node().getBBox(),x=l.width,a=l.x,s=e.append("text").attr("x",0).attr("y",t().state.titleShift).attr("font-size",t().state.fontSize).attr("class","state-title").text(i.id),p=s.node().getBBox().width+n;let o=Math.max(p,x);o===x&&(o=o+n);let g;const B=e.node().getBBox();i.doc,g=a-c,p>x&&(g=(x-o)/2+c),Math.abs(a-B.x)<c&&p>x&&(g=a-(p-x)/2);const m=1-t().state.textHeight;return e.insert("rect",":first-child").attr("x",g).attr("y",m).attr("class",d?"alt-composit":"composit").attr("width",o).attr("height",B.height+t().state.textHeight+t().state.titleShift+1).attr("rx","0"),s.attr("x",g+c),p<=x&&s.attr("x",a+(o-n)/2-p/2+c),e.insert("rect",":first-child").attr("x",g).attr("y",t().state.titleShift-t().state.textHeight-t().state.padding).attr("width",o).attr("height",t().state.textHeight*3).attr("rx",t().state.radius),e.insert("rect",":first-child").attr("x",g).attr("y",t().state.titleShift-t().state.textHeight-t().state.padding).attr("width",o).attr("height",B.height+3+2*t().state.textHeight).attr("rx",t().state.radius),e},"addTitleAndBox"),q=f(e=>(e.append("circle").attr("class","end-state-outer").attr("r",t().state.sizeUnit+t().state.miniPadding).attr("cx",t().state.padding+t().state.sizeUnit+t().state.miniPadding).attr("cy",t().state.padding+t().state.sizeUnit+t().state.miniPadding),e.append("circle").attr("class","end-state-inner").attr("r",t().state.sizeUnit).attr("cx",t().state.padding+t().state.sizeUnit+2).attr("cy",t().state.padding+t().state.sizeUnit+2)),"drawEndState"),Z=f((e,i)=>{let d=t().state.forkWidth,c=t().state.forkHeight;if(i.parentId){let n=d;d=c,c=n}return e.append("rect").style("stroke","black").style("fill","black").attr("width",d).attr("height",c).attr("x",t().state.padding).attr("y",t().state.padding)},"drawForkJoinState"),j=f((e,i,d,c)=>{let n=0;const l=c.append("text");l.style("text-anchor","start"),l.attr("class","noteText");let x=e.replace(/\r\n/g,"<br/>");x=x.replace(/\n/g,"<br/>");const a=x.split(z.lineBreakRegex);let s=1.25*t().state.noteMargin;for(const w of a){const p=w.trim();if(p.length>0){const o=l.append("tspan");if(o.text(p),s===0){const g=o.node().getBBox();s+=g.height}n+=s,o.attr("x",i+t().state.noteMargin),o.attr("y",d+n+1.25*t().state.noteMargin)}}return{textWidth:l.node().getBBox().width,textHeight:n}},"_drawLongText"),K=f((e,i)=>{i.attr("class","state-note");const d=i.append("rect").attr("x",0).attr("y",t().state.padding),c=i.append("g"),{textWidth:n,textHeight:l}=j(e,0,0,c);return d.attr("height",l+2*t().state.noteMargin),d.attr("width",n+t().state.noteMargin*2),d},"drawNote"),L=f(function(e,i){const d=i.id,c={id:d,label:i.id,width:0,height:0},n=e.append("g").attr("id",d).attr("class","stateGroup");i.type==="start"&&X(n),i.type==="end"&&q(n),(i.type==="fork"||i.type==="join")&&Z(n,i),i.type==="note"&&K(i.note.text,n),i.type==="divider"&&D(n),i.type==="default"&&i.descriptions.length===0&&Y(n,i),i.type==="default"&&i.descriptions.length>0&&I(n,i);const l=n.node().getBBox();return c.width=l.width+2*t().state.padding,c.height=l.height+2*t().state.padding,c},"drawState"),R=0,Q=f(function(e,i,d){const c=f(function(s){switch(s){case N.relationType.AGGREGATION:return"aggregation";case N.relationType.EXTENSION:return"extension";case N.relationType.COMPOSITION:return"composition";case N.relationType.DEPENDENCY:return"dependency"}},"getRelationType");i.points=i.points.filter(s=>!Number.isNaN(s.y));const n=i.points,l=_().x(function(s){return s.x}).y(function(s){return s.y}).curve(U),x=e.append("path").attr("d",l(n)).attr("id","edge"+R).attr("class","transition");let a="";if(t().state.arrowMarkerAbsolute&&(a=C(!0)),x.attr("marker-end","url("+a+"#"+c(N.relationType.DEPENDENCY)+"End)"),d.title!==void 0){const s=e.append("g").attr("class","stateLabel"),{x:w,y:p}=F.calcLabelPosition(i.points),o=z.getRows(d.title);let g=0;const B=[];let m=0,E=0;for(let u=0;u<=o.length;u++){const h=s.append("text").attr("text-anchor","middle").text(o[u]).attr("x",w).attr("y",p+g),y=h.node().getBBox();m=Math.max(m,y.width),E=Math.min(E,y.x),S.info(y.x,w,p+g),g===0&&(g=h.node().getBBox().height,S.info("Title height",g,p)),B.push(h)}let k=g*o.length;if(o.length>1){const u=(o.length-1)*g*.5;B.forEach((h,y)=>h.attr("y",p+y*g-u)),k=g*o.length}const r=s.node().getBBox();s.insert("rect",":first-child").attr("class","box").attr("x",w-m/2-t().state.padding/2).attr("y",p-k/2-t().state.padding/2-3.5).attr("width",m+t().state.padding).attr("height",k+t().state.padding),S.info(r)}R++},"drawEdge"),b,T={},V=f(function(){},"setConf"),tt=f(function(e){e.append("defs").append("marker").attr("id","dependencyEnd").attr("refX",19).attr("refY",7).attr("markerWidth",20).attr("markerHeight",28).attr("orient","auto").append("path").attr("d","M 19,7 L9,13 L14,7 L9,1 Z")},"insertMarkers"),et=f(function(e,i,d,c){b=t().state;const n=t().securityLevel;let l;n==="sandbox"&&(l=H("#i"+i));const x=n==="sandbox"?H(l.nodes()[0].contentDocument.body):H("body"),a=n==="sandbox"?l.nodes()[0].contentDocument:document;S.debug("Rendering diagram "+e);const s=x.select(`[id='${i}']`);tt(s);const w=c.db.getRootDoc();A(w,s,void 0,!1,x,a,c);const p=b.padding,o=s.node().getBBox(),g=o.width+p*2,B=o.height+p*2,m=g*1.75;P(s,B,m,b.useMaxWidth),s.attr("viewBox",`${o.x-b.padding}  ${o.y-b.padding} `+g+" "+B)},"draw"),at=f(e=>e?e.length*b.fontSizeFactor:1,"getLabelWidth"),A=f((e,i,d,c,n,l,x)=>{const a=new O({compound:!0,multigraph:!0});let s,w=!0;for(s=0;s<e.length;s++)if(e[s].stmt==="relation"){w=!1;break}d?a.setGraph({rankdir:"LR",multigraph:!0,compound:!0,ranker:"tight-tree",ranksep:w?1:b.edgeLengthFactor,nodeSep:w?1:50,isMultiGraph:!0}):a.setGraph({rankdir:"TB",multigraph:!0,compound:!0,ranksep:w?1:b.edgeLengthFactor,nodeSep:w?1:50,ranker:"tight-tree",isMultiGraph:!0}),a.setDefaultEdgeLabel(function(){return{}});const p=x.db.getStates(),o=x.db.getRelations(),g=Object.keys(p);for(const r of g){const u=p[r];d&&(u.parentId=d);let h;if(u.doc){let y=i.append("g").attr("id",u.id).attr("class","stateGroup");h=A(u.doc,y,u.id,!c,n,l,x);{y=$(y,u,c);let v=y.node().getBBox();h.width=v.width,h.height=v.height+b.padding/2,T[u.id]={y:b.compositTitleSize}}}else h=L(i,u,a);if(u.note){const y={descriptions:[],id:u.id+"-note",note:u.note,type:"note"},v=L(i,y,a);u.note.position==="left of"?(a.setNode(h.id+"-note",v),a.setNode(h.id,h)):(a.setNode(h.id,h),a.setNode(h.id+"-note",v)),a.setParent(h.id,h.id+"-group"),a.setParent(h.id+"-note",h.id+"-group")}else a.setNode(h.id,h)}S.debug("Count=",a.nodeCount(),a);let B=0;o.forEach(function(r){B++,S.debug("Setting edge",r),a.setEdge(r.id1,r.id2,{relation:r,width:at(r.title),height:b.labelHeight*z.getRows(r.title).length,labelpos:"c"},"id"+B)}),J(a),S.debug("Graph after layout",a.nodes());const m=i.node();a.nodes().forEach(function(r){r!==void 0&&a.node(r)!==void 0?(S.warn("Node "+r+": "+JSON.stringify(a.node(r))),n.select("#"+m.id+" #"+r).attr("transform","translate("+(a.node(r).x-a.node(r).width/2)+","+(a.node(r).y+(T[r]?T[r].y:0)-a.node(r).height/2)+" )"),n.select("#"+m.id+" #"+r).attr("data-x-shift",a.node(r).x-a.node(r).width/2),l.querySelectorAll("#"+m.id+" #"+r+" .divider").forEach(h=>{const y=h.parentElement;let v=0,M=0;y&&(y.parentElement&&(v=y.parentElement.getBBox().width),M=parseInt(y.getAttribute("data-x-shift"),10),Number.isNaN(M)&&(M=0)),h.setAttribute("x1",0-M+8),h.setAttribute("x2",v-M-8)})):S.debug("No Node "+r+": "+JSON.stringify(a.node(r)))});let E=m.getBBox();a.edges().forEach(function(r){r!==void 0&&a.edge(r)!==void 0&&(S.debug("Edge "+r.v+" -> "+r.w+": "+JSON.stringify(a.edge(r))),Q(i,a.edge(r),a.edge(r).relation))}),E=m.getBBox();const k={id:d||"root",label:d||"root",width:0,height:0};return k.width=E.width+2*b.padding,k.height=E.height+2*b.padding,S.debug("Doc rendered",k,a),k},"renderDoc"),it={setConf:V,draw:et},ht={parser:W,get db(){return new N(1)},renderer:it,styles:G,init:f(e=>{e.state||(e.state={}),e.state.arrowMarkerAbsolute=e.arrowMarkerAbsolute},"init")};export{ht as diagram};
diff --git a/docs/dist/assets/stateDiagram-v2-4FDKWEC3-BYlkVy7J.js b/docs/dist/assets/stateDiagram-v2-4FDKWEC3-BYlkVy7J.js
deleted file mode 100644
index 887a2531..00000000
--- a/docs/dist/assets/stateDiagram-v2-4FDKWEC3-BYlkVy7J.js
+++ /dev/null
@@ -1 +0,0 @@
-import{s as t,b as r,a,S as s}from"./chunk-DI55MBZ5-BODS175X.js";import{_ as i}from"./index-BxX29htg.js";import"./chunk-55IACEB6-BE1gdz1f.js";import"./chunk-QN33PNHL-1s4FuBGd.js";var l={parser:a,get db(){return new s(2)},renderer:r,styles:t,init:i(e=>{e.state||(e.state={}),e.state.arrowMarkerAbsolute=e.arrowMarkerAbsolute},"init")};export{l as diagram};
diff --git a/docs/dist/assets/timeline-definition-IT6M3QCI-DCes-M6t.js b/docs/dist/assets/timeline-definition-IT6M3QCI-DCes-M6t.js
deleted file mode 100644
index fe14544c..00000000
--- a/docs/dist/assets/timeline-definition-IT6M3QCI-DCes-M6t.js
+++ /dev/null
@@ -1,61 +0,0 @@
-import{_ as s,c as xt,l as E,d as j,V as kt,W as vt,X as _t,Y as bt,B as wt,$ as St,y as Et}from"./index-BxX29htg.js";import{d as nt}from"./arc-sXMYVGHN.js";var Q=(function(){var n=s(function(x,r,a,c){for(a=a||{},c=x.length;c--;a[x[c]]=r);return a},"o"),t=[6,8,10,11,12,14,16,17,20,21],e=[1,9],l=[1,10],i=[1,11],d=[1,12],h=[1,13],f=[1,16],m=[1,17],p={trace:s(function(){},"trace"),yy:{},symbols_:{error:2,start:3,timeline:4,document:5,EOF:6,line:7,SPACE:8,statement:9,NEWLINE:10,title:11,acc_title:12,acc_title_value:13,acc_descr:14,acc_descr_value:15,acc_descr_multiline_value:16,section:17,period_statement:18,event_statement:19,period:20,event:21,$accept:0,$end:1},terminals_:{2:"error",4:"timeline",6:"EOF",8:"SPACE",10:"NEWLINE",11:"title",12:"acc_title",13:"acc_title_value",14:"acc_descr",15:"acc_descr_value",16:"acc_descr_multiline_value",17:"section",20:"period",21:"event"},productions_:[0,[3,3],[5,0],[5,2],[7,2],[7,1],[7,1],[7,1],[9,1],[9,2],[9,2],[9,1],[9,1],[9,1],[9,1],[18,1],[19,1]],performAction:s(function(r,a,c,u,y,o,w){var v=o.length-1;switch(y){case 1:return o[v-1];case 2:this.$=[];break;case 3:o[v-1].push(o[v]),this.$=o[v-1];break;case 4:case 5:this.$=o[v];break;case 6:case 7:this.$=[];break;case 8:u.getCommonDb().setDiagramTitle(o[v].substr(6)),this.$=o[v].substr(6);break;case 9:this.$=o[v].trim(),u.getCommonDb().setAccTitle(this.$);break;case 10:case 11:this.$=o[v].trim(),u.getCommonDb().setAccDescription(this.$);break;case 12:u.addSection(o[v].substr(8)),this.$=o[v].substr(8);break;case 15:u.addTask(o[v],0,""),this.$=o[v];break;case 16:u.addEvent(o[v].substr(2)),this.$=o[v];break}},"anonymous"),table:[{3:1,4:[1,2]},{1:[3]},n(t,[2,2],{5:3}),{6:[1,4],7:5,8:[1,6],9:7,10:[1,8],11:e,12:l,14:i,16:d,17:h,18:14,19:15,20:f,21:m},n(t,[2,7],{1:[2,1]}),n(t,[2,3]),{9:18,11:e,12:l,14:i,16:d,17:h,18:14,19:15,20:f,21:m},n(t,[2,5]),n(t,[2,6]),n(t,[2,8]),{13:[1,19]},{15:[1,20]},n(t,[2,11]),n(t,[2,12]),n(t,[2,13]),n(t,[2,14]),n(t,[2,15]),n(t,[2,16]),n(t,[2,4]),n(t,[2,9]),n(t,[2,10])],defaultActions:{},parseError:s(function(r,a){if(a.recoverable)this.trace(r);else{var c=new Error(r);throw c.hash=a,c}},"parseError"),parse:s(function(r){var a=this,c=[0],u=[],y=[null],o=[],w=this.table,v="",N=0,P=0,W=2,U=1,H=o.slice.call(arguments,1),g=Object.create(this.lexer),b={yy:{}};for(var L in this.yy)Object.prototype.hasOwnProperty.call(this.yy,L)&&(b.yy[L]=this.yy[L]);g.setInput(r,b.yy),b.yy.lexer=g,b.yy.parser=this,typeof g.yylloc>"u"&&(g.yylloc={});var $=g.yylloc;o.push($);var z=g.options&&g.options.ranges;typeof b.yy.parseError=="function"?this.parseError=b.yy.parseError:this.parseError=Object.getPrototypeOf(this).parseError;function Z(T){c.length=c.length-2*T,y.length=y.length-T,o.length=o.length-T}s(Z,"popStack");function tt(){var T;return T=u.pop()||g.lex()||U,typeof T!="number"&&(T instanceof Array&&(u=T,T=u.pop()),T=a.symbols_[T]||T),T}s(tt,"lex");for(var S,A,I,J,R={},B,M,et,O;;){if(A=c[c.length-1],this.defaultActions[A]?I=this.defaultActions[A]:((S===null||typeof S>"u")&&(S=tt()),I=w[A]&&w[A][S]),typeof I>"u"||!I.length||!I[0]){var K="";O=[];for(B in w[A])this.terminals_[B]&&B>W&&O.push("'"+this.terminals_[B]+"'");g.showPosition?K="Parse error on line "+(N+1)+`:
-`+g.showPosition()+`
-Expecting `+O.join(", ")+", got '"+(this.terminals_[S]||S)+"'":K="Parse error on line "+(N+1)+": Unexpected "+(S==U?"end of input":"'"+(this.terminals_[S]||S)+"'"),this.parseError(K,{text:g.match,token:this.terminals_[S]||S,line:g.yylineno,loc:$,expected:O})}if(I[0]instanceof Array&&I.length>1)throw new Error("Parse Error: multiple actions possible at state: "+A+", token: "+S);switch(I[0]){case 1:c.push(S),y.push(g.yytext),o.push(g.yylloc),c.push(I[1]),S=null,P=g.yyleng,v=g.yytext,N=g.yylineno,$=g.yylloc;break;case 2:if(M=this.productions_[I[1]][1],R.$=y[y.length-M],R._$={first_line:o[o.length-(M||1)].first_line,last_line:o[o.length-1].last_line,first_column:o[o.length-(M||1)].first_column,last_column:o[o.length-1].last_column},z&&(R._$.range=[o[o.length-(M||1)].range[0],o[o.length-1].range[1]]),J=this.performAction.apply(R,[v,P,N,b.yy,I[1],y,o].concat(H)),typeof J<"u")return J;M&&(c=c.slice(0,-1*M*2),y=y.slice(0,-1*M),o=o.slice(0,-1*M)),c.push(this.productions_[I[1]][0]),y.push(R.$),o.push(R._$),et=w[c[c.length-2]][c[c.length-1]],c.push(et);break;case 3:return!0}}return!0},"parse")},k=(function(){var x={EOF:1,parseError:s(function(a,c){if(this.yy.parser)this.yy.parser.parseError(a,c);else throw new Error(a)},"parseError"),setInput:s(function(r,a){return this.yy=a||this.yy||{},this._input=r,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},"setInput"),input:s(function(){var r=this._input[0];this.yytext+=r,this.yyleng++,this.offset++,this.match+=r,this.matched+=r;var a=r.match(/(?:\r\n?|\n).*/g);return a?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),r},"input"),unput:s(function(r){var a=r.length,c=r.split(/(?:\r\n?|\n)/g);this._input=r+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-a),this.offset-=a;var u=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),c.length-1&&(this.yylineno-=c.length-1);var y=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:c?(c.length===u.length?this.yylloc.first_column:0)+u[u.length-c.length].length-c[0].length:this.yylloc.first_column-a},this.options.ranges&&(this.yylloc.range=[y[0],y[0]+this.yyleng-a]),this.yyleng=this.yytext.length,this},"unput"),more:s(function(){return this._more=!0,this},"more"),reject:s(function(){if(this.options.backtrack_lexer)this._backtrack=!0;else return this.parseError("Lexical error on line "+(this.yylineno+1)+`. You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).
-`+this.showPosition(),{text:"",token:null,line:this.yylineno});return this},"reject"),less:s(function(r){this.unput(this.match.slice(r))},"less"),pastInput:s(function(){var r=this.matched.substr(0,this.matched.length-this.match.length);return(r.length>20?"...":"")+r.substr(-20).replace(/\n/g,"")},"pastInput"),upcomingInput:s(function(){var r=this.match;return r.length<20&&(r+=this._input.substr(0,20-r.length)),(r.substr(0,20)+(r.length>20?"...":"")).replace(/\n/g,"")},"upcomingInput"),showPosition:s(function(){var r=this.pastInput(),a=new Array(r.length+1).join("-");return r+this.upcomingInput()+`
-`+a+"^"},"showPosition"),test_match:s(function(r,a){var c,u,y;if(this.options.backtrack_lexer&&(y={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(y.yylloc.range=this.yylloc.range.slice(0))),u=r[0].match(/(?:\r\n?|\n).*/g),u&&(this.yylineno+=u.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:u?u[u.length-1].length-u[u.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+r[0].length},this.yytext+=r[0],this.match+=r[0],this.matches=r,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(r[0].length),this.matched+=r[0],c=this.performAction.call(this,this.yy,this,a,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),c)return c;if(this._backtrack){for(var o in y)this[o]=y[o];return!1}return!1},"test_match"),next:s(function(){if(this.done)return this.EOF;this._input||(this.done=!0);var r,a,c,u;this._more||(this.yytext="",this.match="");for(var y=this._currentRules(),o=0;o<y.length;o++)if(c=this._input.match(this.rules[y[o]]),c&&(!a||c[0].length>a[0].length)){if(a=c,u=o,this.options.backtrack_lexer){if(r=this.test_match(c,y[o]),r!==!1)return r;if(this._backtrack){a=!1;continue}else return!1}else if(!this.options.flex)break}return a?(r=this.test_match(a,y[u]),r!==!1?r:!1):this._input===""?this.EOF:this.parseError("Lexical error on line "+(this.yylineno+1)+`. Unrecognized text.
-`+this.showPosition(),{text:"",token:null,line:this.yylineno})},"next"),lex:s(function(){var a=this.next();return a||this.lex()},"lex"),begin:s(function(a){this.conditionStack.push(a)},"begin"),popState:s(function(){var a=this.conditionStack.length-1;return a>0?this.conditionStack.pop():this.conditionStack[0]},"popState"),_currentRules:s(function(){return this.conditionStack.length&&this.conditionStack[this.conditionStack.length-1]?this.conditions[this.conditionStack[this.conditionStack.length-1]].rules:this.conditions.INITIAL.rules},"_currentRules"),topState:s(function(a){return a=this.conditionStack.length-1-Math.abs(a||0),a>=0?this.conditionStack[a]:"INITIAL"},"topState"),pushState:s(function(a){this.begin(a)},"pushState"),stateStackSize:s(function(){return this.conditionStack.length},"stateStackSize"),options:{"case-insensitive":!0},performAction:s(function(a,c,u,y){switch(u){case 0:break;case 1:break;case 2:return 10;case 3:break;case 4:break;case 5:return 4;case 6:return 11;case 7:return this.begin("acc_title"),12;case 8:return this.popState(),"acc_title_value";case 9:return this.begin("acc_descr"),14;case 10:return this.popState(),"acc_descr_value";case 11:this.begin("acc_descr_multiline");break;case 12:this.popState();break;case 13:return"acc_descr_multiline_value";case 14:return 17;case 15:return 21;case 16:return 20;case 17:return 6;case 18:return"INVALID"}},"anonymous"),rules:[/^(?:%(?!\{)[^\n]*)/i,/^(?:[^\}]%%[^\n]*)/i,/^(?:[\n]+)/i,/^(?:\s+)/i,/^(?:#[^\n]*)/i,/^(?:timeline\b)/i,/^(?:title\s[^\n]+)/i,/^(?:accTitle\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*\{\s*)/i,/^(?:[\}])/i,/^(?:[^\}]*)/i,/^(?:section\s[^:\n]+)/i,/^(?::\s(?:[^:\n]|:(?!\s))+)/i,/^(?:[^#:\n]+)/i,/^(?:$)/i,/^(?:.)/i],conditions:{acc_descr_multiline:{rules:[12,13],inclusive:!1},acc_descr:{rules:[10],inclusive:!1},acc_title:{rules:[8],inclusive:!1},INITIAL:{rules:[0,1,2,3,4,5,6,7,9,11,14,15,16,17,18],inclusive:!0}}};return x})();p.lexer=k;function _(){this.yy={}}return s(_,"Parser"),_.prototype=p,p.Parser=_,new _})();Q.parser=Q;var Tt=Q,at={};wt(at,{addEvent:()=>yt,addSection:()=>ht,addTask:()=>pt,addTaskOrg:()=>gt,clear:()=>ct,default:()=>It,getCommonDb:()=>ot,getSections:()=>dt,getTasks:()=>ut});var F="",lt=0,X=[],G=[],V=[],ot=s(()=>St,"getCommonDb"),ct=s(function(){X.length=0,G.length=0,F="",V.length=0,Et()},"clear"),ht=s(function(n){F=n,X.push(n)},"addSection"),dt=s(function(){return X},"getSections"),ut=s(function(){let n=it();const t=100;let e=0;for(;!n&&e<t;)n=it(),e++;return G.push(...V),G},"getTasks"),pt=s(function(n,t,e){const l={id:lt++,section:F,type:F,task:n,score:t||0,events:e?[e]:[]};V.push(l)},"addTask"),yt=s(function(n){V.find(e=>e.id===lt-1).events.push(n)},"addEvent"),gt=s(function(n){const t={section:F,type:F,description:n,task:n,classes:[]};G.push(t)},"addTaskOrg"),it=s(function(){const n=s(function(e){return V[e].processed},"compileTask");let t=!0;for(const[e,l]of V.entries())n(e),t=t&&l.processed;return t},"compileTasks"),It={clear:ct,getCommonDb:ot,addSection:ht,getSections:dt,getTasks:ut,addTask:pt,addTaskOrg:gt,addEvent:yt},Nt=12,q=s(function(n,t){const e=n.append("rect");return e.attr("x",t.x),e.attr("y",t.y),e.attr("fill",t.fill),e.attr("stroke",t.stroke),e.attr("width",t.width),e.attr("height",t.height),e.attr("rx",t.rx),e.attr("ry",t.ry),t.class!==void 0&&e.attr("class",t.class),e},"drawRect"),Lt=s(function(n,t){const l=n.append("circle").attr("cx",t.cx).attr("cy",t.cy).attr("class","face").attr("r",15).attr("stroke-width",2).attr("overflow","visible"),i=n.append("g");i.append("circle").attr("cx",t.cx-15/3).attr("cy",t.cy-15/3).attr("r",1.5).attr("stroke-width",2).attr("fill","#666").attr("stroke","#666"),i.append("circle").attr("cx",t.cx+15/3).attr("cy",t.cy-15/3).attr("r",1.5).attr("stroke-width",2).attr("fill","#666").attr("stroke","#666");function d(m){const p=nt().startAngle(Math.PI/2).endAngle(3*(Math.PI/2)).innerRadius(7.5).outerRadius(6.8181818181818175);m.append("path").attr("class","mouth").attr("d",p).attr("transform","translate("+t.cx+","+(t.cy+2)+")")}s(d,"smile");function h(m){const p=nt().startAngle(3*Math.PI/2).endAngle(5*(Math.PI/2)).innerRadius(7.5).outerRadius(6.8181818181818175);m.append("path").attr("class","mouth").attr("d",p).attr("transform","translate("+t.cx+","+(t.cy+7)+")")}s(h,"sad");function f(m){m.append("line").attr("class","mouth").attr("stroke",2).attr("x1",t.cx-5).attr("y1",t.cy+7).attr("x2",t.cx+5).attr("y2",t.cy+7).attr("class","mouth").attr("stroke-width","1px").attr("stroke","#666")}return s(f,"ambivalent"),t.score>3?d(i):t.score<3?h(i):f(i),l},"drawFace"),$t=s(function(n,t){const e=n.append("circle");return e.attr("cx",t.cx),e.attr("cy",t.cy),e.attr("class","actor-"+t.pos),e.attr("fill",t.fill),e.attr("stroke",t.stroke),e.attr("r",t.r),e.class!==void 0&&e.attr("class",e.class),t.title!==void 0&&e.append("title").text(t.title),e},"drawCircle"),ft=s(function(n,t){const e=t.text.replace(/<br\s*\/?>/gi," "),l=n.append("text");l.attr("x",t.x),l.attr("y",t.y),l.attr("class","legend"),l.style("text-anchor",t.anchor),t.class!==void 0&&l.attr("class",t.class);const i=l.append("tspan");return i.attr("x",t.x+t.textMargin*2),i.text(e),l},"drawText"),Mt=s(function(n,t){function e(i,d,h,f,m){return i+","+d+" "+(i+h)+","+d+" "+(i+h)+","+(d+f-m)+" "+(i+h-m*1.2)+","+(d+f)+" "+i+","+(d+f)}s(e,"genPoints");const l=n.append("polygon");l.attr("points",e(t.x,t.y,50,20,7)),l.attr("class","labelBox"),t.y=t.y+t.labelMargin,t.x=t.x+.5*t.labelMargin,ft(n,t)},"drawLabel"),Ht=s(function(n,t,e){const l=n.append("g"),i=Y();i.x=t.x,i.y=t.y,i.fill=t.fill,i.width=e.width,i.height=e.height,i.class="journey-section section-type-"+t.num,i.rx=3,i.ry=3,q(l,i),mt(e)(t.text,l,i.x,i.y,i.width,i.height,{class:"journey-section section-type-"+t.num},e,t.colour)},"drawSection"),rt=-1,Pt=s(function(n,t,e){const l=t.x+e.width/2,i=n.append("g");rt++,i.append("line").attr("id","task"+rt).attr("x1",l).attr("y1",t.y).attr("x2",l).attr("y2",450).attr("class","task-line").attr("stroke-width","1px").attr("stroke-dasharray","4 2").attr("stroke","#666"),Lt(i,{cx:l,cy:300+(5-t.score)*30,score:t.score});const h=Y();h.x=t.x,h.y=t.y,h.fill=t.fill,h.width=e.width,h.height=e.height,h.class="task task-type-"+t.num,h.rx=3,h.ry=3,q(i,h),mt(e)(t.task,i,h.x,h.y,h.width,h.height,{class:"task"},e,t.colour)},"drawTask"),At=s(function(n,t){q(n,{x:t.startx,y:t.starty,width:t.stopx-t.startx,height:t.stopy-t.starty,fill:t.fill,class:"rect"}).lower()},"drawBackgroundRect"),Ct=s(function(){return{x:0,y:0,fill:void 0,"text-anchor":"start",width:100,height:100,textMargin:0,rx:0,ry:0}},"getTextObj"),Y=s(function(){return{x:0,y:0,width:100,anchor:"start",height:100,rx:0,ry:0}},"getNoteRect"),mt=(function(){function n(i,d,h,f,m,p,k,_){const x=d.append("text").attr("x",h+m/2).attr("y",f+p/2+5).style("font-color",_).style("text-anchor","middle").text(i);l(x,k)}s(n,"byText");function t(i,d,h,f,m,p,k,_,x){const{taskFontSize:r,taskFontFamily:a}=_,c=i.split(/<br\s*\/?>/gi);for(let u=0;u<c.length;u++){const y=u*r-r*(c.length-1)/2,o=d.append("text").attr("x",h+m/2).attr("y",f).attr("fill",x).style("text-anchor","middle").style("font-size",r).style("font-family",a);o.append("tspan").attr("x",h+m/2).attr("dy",y).text(c[u]),o.attr("y",f+p/2).attr("dominant-baseline","central").attr("alignment-baseline","central"),l(o,k)}}s(t,"byTspan");function e(i,d,h,f,m,p,k,_){const x=d.append("switch"),a=x.append("foreignObject").attr("x",h).attr("y",f).attr("width",m).attr("height",p).attr("position","fixed").append("xhtml:div").style("display","table").style("height","100%").style("width","100%");a.append("div").attr("class","label").style("display","table-cell").style("text-align","center").style("vertical-align","middle").text(i),t(i,x,h,f,m,p,k,_),l(a,k)}s(e,"byFo");function l(i,d){for(const h in d)h in d&&i.attr(h,d[h])}return s(l,"_setTextAttrs"),function(i){return i.textPlacement==="fo"?e:i.textPlacement==="old"?n:t}})(),Rt=s(function(n){n.append("defs").append("marker").attr("id","arrowhead").attr("refX",5).attr("refY",2).attr("markerWidth",6).attr("markerHeight",4).attr("orient","auto").append("path").attr("d","M 0,0 V 4 L6,2 Z")},"initGraphics");function D(n,t){n.each(function(){var e=j(this),l=e.text().split(/(\s+|<br>)/).reverse(),i,d=[],h=1.1,f=e.attr("y"),m=parseFloat(e.attr("dy")),p=e.text(null).append("tspan").attr("x",0).attr("y",f).attr("dy",m+"em");for(let k=0;k<l.length;k++)i=l[l.length-1-k],d.push(i),p.text(d.join(" ").trim()),(p.node().getComputedTextLength()>t||i==="<br>")&&(d.pop(),p.text(d.join(" ").trim()),i==="<br>"?d=[""]:d=[i],p=e.append("tspan").attr("x",0).attr("y",f).attr("dy",h+"em").text(i))})}s(D,"wrap");var Ft=s(function(n,t,e,l){const i=e%Nt-1,d=n.append("g");t.section=i,d.attr("class",(t.class?t.class+" ":"")+"timeline-node "+("section-"+i));const h=d.append("g"),f=d.append("g"),p=f.append("text").text(t.descr).attr("dy","1em").attr("alignment-baseline","middle").attr("dominant-baseline","middle").attr("text-anchor","middle").call(D,t.width).node().getBBox(),k=l.fontSize?.replace?l.fontSize.replace("px",""):l.fontSize;return t.height=p.height+k*1.1*.5+t.padding,t.height=Math.max(t.height,t.maxHeight),t.width=t.width+2*t.padding,f.attr("transform","translate("+t.width/2+", "+t.padding/2+")"),Wt(h,t,i,l),t},"drawNode"),Vt=s(function(n,t,e){const l=n.append("g"),d=l.append("text").text(t.descr).attr("dy","1em").attr("alignment-baseline","middle").attr("dominant-baseline","middle").attr("text-anchor","middle").call(D,t.width).node().getBBox(),h=e.fontSize?.replace?e.fontSize.replace("px",""):e.fontSize;return l.remove(),d.height+h*1.1*.5+t.padding},"getVirtualNodeHeight"),Wt=s(function(n,t,e){n.append("path").attr("id","node-"+t.id).attr("class","node-bkg node-"+t.type).attr("d",`M0 ${t.height-5} v${-t.height+10} q0,-5 5,-5 h${t.width-10} q5,0 5,5 v${t.height-5} H0 Z`),n.append("line").attr("class","node-line-"+e).attr("x1",0).attr("y1",t.height).attr("x2",t.width).attr("y2",t.height)},"defaultBkg"),C={drawRect:q,drawCircle:$t,drawSection:Ht,drawText:ft,drawLabel:Mt,drawTask:Pt,drawBackgroundRect:At,getTextObj:Ct,getNoteRect:Y,initGraphics:Rt,drawNode:Ft,getVirtualNodeHeight:Vt},zt=s(function(n,t,e,l){const i=xt(),d=i.timeline?.leftMargin??50;E.debug("timeline",l.db);const h=i.securityLevel;let f;h==="sandbox"&&(f=j("#i"+t));const p=(h==="sandbox"?j(f.nodes()[0].contentDocument.body):j("body")).select("#"+t);p.append("g");const k=l.db.getTasks(),_=l.db.getCommonDb().getDiagramTitle();E.debug("task",k),C.initGraphics(p);const x=l.db.getSections();E.debug("sections",x);let r=0,a=0,c=0,u=0,y=50+d,o=50;u=50;let w=0,v=!0;x.forEach(function(H){const g={number:w,descr:H,section:w,width:150,padding:20,maxHeight:r},b=C.getVirtualNodeHeight(p,g,i);E.debug("sectionHeight before draw",b),r=Math.max(r,b+20)});let N=0,P=0;E.debug("tasks.length",k.length);for(const[H,g]of k.entries()){const b={number:H,descr:g,section:g.section,width:150,padding:20,maxHeight:a},L=C.getVirtualNodeHeight(p,b,i);E.debug("taskHeight before draw",L),a=Math.max(a,L+20),N=Math.max(N,g.events.length);let $=0;for(const z of g.events){const Z={descr:z,section:g.section,number:g.section,width:150,padding:20,maxHeight:50};$+=C.getVirtualNodeHeight(p,Z,i)}g.events.length>0&&($+=(g.events.length-1)*10),P=Math.max(P,$)}E.debug("maxSectionHeight before draw",r),E.debug("maxTaskHeight before draw",a),x&&x.length>0?x.forEach(H=>{const g=k.filter(z=>z.section===H),b={number:w,descr:H,section:w,width:200*Math.max(g.length,1)-50,padding:20,maxHeight:r};E.debug("sectionNode",b);const L=p.append("g"),$=C.drawNode(L,b,w,i);E.debug("sectionNode output",$),L.attr("transform",`translate(${y}, ${u})`),o+=r+50,g.length>0&&st(p,g,w,y,o,a,i,N,P,r,!1),y+=200*Math.max(g.length,1),o=u,w++}):(v=!1,st(p,k,w,y,o,a,i,N,P,r,!0));const W=p.node().getBBox();E.debug("bounds",W),_&&p.append("text").text(_).attr("x",W.width/2-d).attr("font-size","4ex").attr("font-weight","bold").attr("y",20),c=v?r+a+150:a+100,p.append("g").attr("class","lineWrapper").append("line").attr("x1",d).attr("y1",c).attr("x2",W.width+3*d).attr("y2",c).attr("stroke-width",4).attr("stroke","black").attr("marker-end","url(#arrowhead)"),kt(void 0,p,i.timeline?.padding??50,i.timeline?.useMaxWidth??!1)},"draw"),st=s(function(n,t,e,l,i,d,h,f,m,p,k){for(const _ of t){const x={descr:_.task,section:e,number:e,width:150,padding:20,maxHeight:d};E.debug("taskNode",x);const r=n.append("g").attr("class","taskWrapper"),c=C.drawNode(r,x,e,h).height;if(E.debug("taskHeight after draw",c),r.attr("transform",`translate(${l}, ${i})`),d=Math.max(d,c),_.events){const u=n.append("g").attr("class","lineWrapper");let y=d;i+=100,y=y+Bt(n,_.events,e,l,i,h),i-=100,u.append("line").attr("x1",l+190/2).attr("y1",i+d).attr("x2",l+190/2).attr("y2",i+d+100+m+100).attr("stroke-width",2).attr("stroke","black").attr("marker-end","url(#arrowhead)").attr("stroke-dasharray","5,5")}l=l+200,k&&!h.timeline?.disableMulticolor&&e++}i=i-10},"drawTasks"),Bt=s(function(n,t,e,l,i,d){let h=0;const f=i;i=i+100;for(const m of t){const p={descr:m,section:e,number:e,width:150,padding:20,maxHeight:50};E.debug("eventNode",p);const k=n.append("g").attr("class","eventWrapper"),x=C.drawNode(k,p,e,d).height;h=h+x,k.attr("transform",`translate(${l}, ${i})`),i=i+10+x}return i=f,h},"drawEvents"),Ot={setConf:s(()=>{},"setConf"),draw:zt},jt=s(n=>{let t="";for(let e=0;e<n.THEME_COLOR_LIMIT;e++)n["lineColor"+e]=n["lineColor"+e]||n["cScaleInv"+e],vt(n["lineColor"+e])?n["lineColor"+e]=_t(n["lineColor"+e],20):n["lineColor"+e]=bt(n["lineColor"+e],20);for(let e=0;e<n.THEME_COLOR_LIMIT;e++){const l=""+(17-3*e);t+=`
-    .section-${e-1} rect, .section-${e-1} path, .section-${e-1} circle, .section-${e-1} path  {
-      fill: ${n["cScale"+e]};
-    }
-    .section-${e-1} text {
-     fill: ${n["cScaleLabel"+e]};
-    }
-    .node-icon-${e-1} {
-      font-size: 40px;
-      color: ${n["cScaleLabel"+e]};
-    }
-    .section-edge-${e-1}{
-      stroke: ${n["cScale"+e]};
-    }
-    .edge-depth-${e-1}{
-      stroke-width: ${l};
-    }
-    .section-${e-1} line {
-      stroke: ${n["cScaleInv"+e]} ;
-      stroke-width: 3;
-    }
-
-    .lineWrapper line{
-      stroke: ${n["cScaleLabel"+e]} ;
-    }
-
-    .disabled, .disabled circle, .disabled text {
-      fill: lightgray;
-    }
-    .disabled text {
-      fill: #efefef;
-    }
-    `}return t},"genSections"),Gt=s(n=>`
-  .edge {
-    stroke-width: 3;
-  }
-  ${jt(n)}
-  .section-root rect, .section-root path, .section-root circle  {
-    fill: ${n.git0};
-  }
-  .section-root text {
-    fill: ${n.gitBranchLabel0};
-  }
-  .icon-container {
-    height:100%;
-    display: flex;
-    justify-content: center;
-    align-items: center;
-  }
-  .edge {
-    fill: none;
-  }
-  .eventWrapper  {
-   filter: brightness(120%);
-  }
-`,"getStyles"),qt=Gt,Jt={db:at,renderer:Ot,parser:Tt,styles:qt};export{Jt as diagram};
diff --git a/docs/dist/assets/treemap-KMMF4GRG-DFERHDZP.js b/docs/dist/assets/treemap-KMMF4GRG-DFERHDZP.js
deleted file mode 100644
index 601e6324..00000000
--- a/docs/dist/assets/treemap-KMMF4GRG-DFERHDZP.js
+++ /dev/null
@@ -1,128 +0,0 @@
-import{bB as wu,bC as _u,aV as xl,bl as Lu,aZ as bu,aW as te,aA as Ou,aB as ga,bb as Pu,be as Sl,bf as Il,bc as Mu,bq as ya,aD as Et,aE as D,aX as Ta,aR as Du,bD as ft}from"./index-BxX29htg.js";import{k as Xt,j as Us,g as rn,S as Fu,w as Gu,x as Uu,c as Cl,v as z,y as Nl,l as Bu,z as Vu,A as Ku,B as Wu,C as ju,a as wl,d as C,i as Ye,r as le,f as $e,D as Y}from"./_baseUniq-CfjWcJYV.js";import{j as Bs,m as $,d as Hu,f as Ne,g as Jt,h as N,i as Vs,l as Qt,e as zu}from"./_basePickBy-CqMtcO3s.js";import{c as re}from"./clone-BRV0rZiZ.js";var qu=Object.prototype,Yu=qu.hasOwnProperty,ke=wu(function(n,e){if(_u(e)||xl(e)){Lu(e,Xt(e),n);return}for(var t in e)Yu.call(e,t)&&bu(n,t,e[t])});function _l(n,e,t){var r=-1,i=n.length;e<0&&(e=-e>i?0:i+e),t=t>i?i:t,t<0&&(t+=i),i=e>t?0:t-e>>>0,e>>>=0;for(var s=Array(i);++r<i;)s[r]=n[r+e];return s}function Zn(n){for(var e=-1,t=n==null?0:n.length,r=0,i=[];++e<t;){var s=n[e];s&&(i[r++]=s)}return i}function Xu(n,e,t,r){for(var i=-1,s=n==null?0:n.length;++i<s;){var a=n[i];e(r,a,t(a),n)}return r}function Ju(n,e,t,r){return Us(n,function(i,s,a){e(r,i,t(i),a)}),r}function Qu(n,e){return function(t,r){var i=te(t)?Xu:Ju,s=e?e():{};return i(t,n,rn(r),s)}}var Zu=200;function ed(n,e,t,r){var i=-1,s=Gu,a=!0,o=n.length,l=[],c=e.length;if(!o)return l;e.length>=Zu&&(s=Uu,a=!1,e=new Fu(e));e:for(;++i<o;){var u=n[i],d=u;if(u=u!==0?u:0,a&&d===d){for(var h=c;h--;)if(e[h]===d)continue e;l.push(u)}else s(e,d,r)||l.push(u)}return l}var hi=Ou(function(n,e){return ga(n)?ed(n,Cl(e,1,ga,!0)):[]});function Q(n,e,t){var r=n==null?0:n.length;return r?(e=e===void 0?1:Bs(e),_l(n,e<0?0:e,r)):[]}function Yn(n,e,t){var r=n==null?0:n.length;return r?(e=e===void 0?1:Bs(e),e=r-e,_l(n,0,e<0?0:e)):[]}function td(n,e){for(var t=-1,r=n==null?0:n.length;++t<r;)if(!e(n[t],t,n))return!1;return!0}function nd(n,e){var t=!0;return Us(n,function(r,i,s){return t=!!e(r,i,s),t}),t}function Oe(n,e,t){var r=te(n)?td:nd;return r(n,rn(e))}function Pe(n){return n&&n.length?n[0]:void 0}function Ee(n,e){return Cl($(n,e))}var rd=Object.prototype,id=rd.hasOwnProperty,sd=Qu(function(n,e,t){id.call(n,t)?n[t].push(e):Pu(n,t,[e])}),ad="[object String]";function he(n){return typeof n=="string"||!te(n)&&Sl(n)&&Il(n)==ad}var od=Math.max;function de(n,e,t,r){n=xl(n)?n:z(n),t=t?Bs(t):0;var i=n.length;return t<0&&(t=od(i+t,0)),he(n)?t<=i&&n.indexOf(e,t)>-1:!!i&&Nl(n,e,t)>-1}function Ra(n,e,t){var r=n==null?0:n.length;if(!r)return-1;var i=0;return Nl(n,e,i)}var ld="[object RegExp]";function cd(n){return Sl(n)&&Il(n)==ld}var va=ya&&ya.isRegExp,Xe=va?Mu(va):cd,ud="Expected a function";function dd(n){if(typeof n!="function")throw new TypeError(ud);return function(){var e=arguments;switch(e.length){case 0:return!n.call(this);case 1:return!n.call(this,e[0]);case 2:return!n.call(this,e[0],e[1]);case 3:return!n.call(this,e[0],e[1],e[2])}return!n.apply(this,e)}}function Me(n,e){if(n==null)return{};var t=Bu(Vu(n),function(r){return[r]});return e=rn(e),Hu(n,t,function(r,i){return e(r,i[0])})}function pi(n,e){var t=te(n)?Ku:Wu;return t(n,dd(rn(e)))}function fd(n,e){var t;return Us(n,function(r,i,s){return t=e(r,i,s),!t}),!!t}function Ll(n,e,t){var r=te(n)?ju:fd;return r(n,rn(e))}function Ks(n){return n&&n.length?wl(n):[]}function hd(n,e){return n&&n.length?wl(n,rn(e)):[]}function ae(n){return typeof n=="object"&&n!==null&&typeof n.$type=="string"}function Ue(n){return typeof n=="object"&&n!==null&&typeof n.$refText=="string"}function pd(n){return typeof n=="object"&&n!==null&&typeof n.name=="string"&&typeof n.type=="string"&&typeof n.path=="string"}function Nr(n){return typeof n=="object"&&n!==null&&ae(n.container)&&Ue(n.reference)&&typeof n.message=="string"}class bl{constructor(){this.subtypes={},this.allSubtypes={}}isInstance(e,t){return ae(e)&&this.isSubtype(e.$type,t)}isSubtype(e,t){if(e===t)return!0;let r=this.subtypes[e];r||(r=this.subtypes[e]={});const i=r[t];if(i!==void 0)return i;{const s=this.computeIsSubtype(e,t);return r[t]=s,s}}getAllSubTypes(e){const t=this.allSubtypes[e];if(t)return t;{const r=this.getAllTypes(),i=[];for(const s of r)this.isSubtype(s,e)&&i.push(s);return this.allSubtypes[e]=i,i}}}function Xn(n){return typeof n=="object"&&n!==null&&Array.isArray(n.content)}function Ol(n){return typeof n=="object"&&n!==null&&typeof n.tokenType=="object"}function Pl(n){return Xn(n)&&typeof n.fullText=="string"}class Z{constructor(e,t){this.startFn=e,this.nextFn=t}iterator(){const e={state:this.startFn(),next:()=>this.nextFn(e.state),[Symbol.iterator]:()=>e};return e}[Symbol.iterator](){return this.iterator()}isEmpty(){return!!this.iterator().next().done}count(){const e=this.iterator();let t=0,r=e.next();for(;!r.done;)t++,r=e.next();return t}toArray(){const e=[],t=this.iterator();let r;do r=t.next(),r.value!==void 0&&e.push(r.value);while(!r.done);return e}toSet(){return new Set(this)}toMap(e,t){const r=this.map(i=>[e?e(i):i,t?t(i):i]);return new Map(r)}toString(){return this.join()}concat(e){return new Z(()=>({first:this.startFn(),firstDone:!1,iterator:e[Symbol.iterator]()}),t=>{let r;if(!t.firstDone){do if(r=this.nextFn(t.first),!r.done)return r;while(!r.done);t.firstDone=!0}do if(r=t.iterator.next(),!r.done)return r;while(!r.done);return ve})}join(e=","){const t=this.iterator();let r="",i,s=!1;do i=t.next(),i.done||(s&&(r+=e),r+=md(i.value)),s=!0;while(!i.done);return r}indexOf(e,t=0){const r=this.iterator();let i=0,s=r.next();for(;!s.done;){if(i>=t&&s.value===e)return i;s=r.next(),i++}return-1}every(e){const t=this.iterator();let r=t.next();for(;!r.done;){if(!e(r.value))return!1;r=t.next()}return!0}some(e){const t=this.iterator();let r=t.next();for(;!r.done;){if(e(r.value))return!0;r=t.next()}return!1}forEach(e){const t=this.iterator();let r=0,i=t.next();for(;!i.done;)e(i.value,r),i=t.next(),r++}map(e){return new Z(this.startFn,t=>{const{done:r,value:i}=this.nextFn(t);return r?ve:{done:!1,value:e(i)}})}filter(e){return new Z(this.startFn,t=>{let r;do if(r=this.nextFn(t),!r.done&&e(r.value))return r;while(!r.done);return ve})}nonNullable(){return this.filter(e=>e!=null)}reduce(e,t){const r=this.iterator();let i=t,s=r.next();for(;!s.done;)i===void 0?i=s.value:i=e(i,s.value),s=r.next();return i}reduceRight(e,t){return this.recursiveReduce(this.iterator(),e,t)}recursiveReduce(e,t,r){const i=e.next();if(i.done)return r;const s=this.recursiveReduce(e,t,r);return s===void 0?i.value:t(s,i.value)}find(e){const t=this.iterator();let r=t.next();for(;!r.done;){if(e(r.value))return r.value;r=t.next()}}findIndex(e){const t=this.iterator();let r=0,i=t.next();for(;!i.done;){if(e(i.value))return r;i=t.next(),r++}return-1}includes(e){const t=this.iterator();let r=t.next();for(;!r.done;){if(r.value===e)return!0;r=t.next()}return!1}flatMap(e){return new Z(()=>({this:this.startFn()}),t=>{do{if(t.iterator){const s=t.iterator.next();if(s.done)t.iterator=void 0;else return s}const{done:r,value:i}=this.nextFn(t.this);if(!r){const s=e(i);if(Wr(s))t.iterator=s[Symbol.iterator]();else return{done:!1,value:s}}}while(t.iterator);return ve})}flat(e){if(e===void 0&&(e=1),e<=0)return this;const t=e>1?this.flat(e-1):this;return new Z(()=>({this:t.startFn()}),r=>{do{if(r.iterator){const a=r.iterator.next();if(a.done)r.iterator=void 0;else return a}const{done:i,value:s}=t.nextFn(r.this);if(!i)if(Wr(s))r.iterator=s[Symbol.iterator]();else return{done:!1,value:s}}while(r.iterator);return ve})}head(){const t=this.iterator().next();if(!t.done)return t.value}tail(e=1){return new Z(()=>{const t=this.startFn();for(let r=0;r<e;r++)if(this.nextFn(t).done)return t;return t},this.nextFn)}limit(e){return new Z(()=>({size:0,state:this.startFn()}),t=>(t.size++,t.size>e?ve:this.nextFn(t.state)))}distinct(e){return new Z(()=>({set:new Set,internalState:this.startFn()}),t=>{let r;do if(r=this.nextFn(t.internalState),!r.done){const i=e?e(r.value):r.value;if(!t.set.has(i))return t.set.add(i),r}while(!r.done);return ve})}exclude(e,t){const r=new Set;for(const i of e){const s=t?t(i):i;r.add(s)}return this.filter(i=>{const s=t?t(i):i;return!r.has(s)})}}function md(n){return typeof n=="string"?n:typeof n>"u"?"undefined":typeof n.toString=="function"?n.toString():Object.prototype.toString.call(n)}function Wr(n){return!!n&&typeof n[Symbol.iterator]=="function"}const gd=new Z(()=>{},()=>ve),ve=Object.freeze({done:!0,value:void 0});function ee(...n){if(n.length===1){const e=n[0];if(e instanceof Z)return e;if(Wr(e))return new Z(()=>e[Symbol.iterator](),t=>t.next());if(typeof e.length=="number")return new Z(()=>({index:0}),t=>t.index<e.length?{done:!1,value:e[t.index++]}:ve)}return n.length>1?new Z(()=>({collIndex:0,arrIndex:0}),e=>{do{if(e.iterator){const t=e.iterator.next();if(!t.done)return t;e.iterator=void 0}if(e.array){if(e.arrIndex<e.array.length)return{done:!1,value:e.array[e.arrIndex++]};e.array=void 0,e.arrIndex=0}if(e.collIndex<n.length){const t=n[e.collIndex++];Wr(t)?e.iterator=t[Symbol.iterator]():t&&typeof t.length=="number"&&(e.array=t)}}while(e.iterator||e.array||e.collIndex<n.length);return ve}):gd}class Ws extends Z{constructor(e,t,r){super(()=>({iterators:r?.includeRoot?[[e][Symbol.iterator]()]:[t(e)[Symbol.iterator]()],pruned:!1}),i=>{for(i.pruned&&(i.iterators.pop(),i.pruned=!1);i.iterators.length>0;){const a=i.iterators[i.iterators.length-1].next();if(a.done)i.iterators.pop();else return i.iterators.push(t(a.value)[Symbol.iterator]()),a}return ve})}iterator(){const e={state:this.startFn(),next:()=>this.nextFn(e.state),prune:()=>{e.state.pruned=!0},[Symbol.iterator]:()=>e};return e}}var is;(function(n){function e(s){return s.reduce((a,o)=>a+o,0)}n.sum=e;function t(s){return s.reduce((a,o)=>a*o,0)}n.product=t;function r(s){return s.reduce((a,o)=>Math.min(a,o))}n.min=r;function i(s){return s.reduce((a,o)=>Math.max(a,o))}n.max=i})(is||(is={}));function ss(n){return new Ws(n,e=>Xn(e)?e.content:[],{includeRoot:!0})}function yd(n,e){for(;n.container;)if(n=n.container,n===e)return!0;return!1}function as(n){return{start:{character:n.startColumn-1,line:n.startLine-1},end:{character:n.endColumn,line:n.endLine-1}}}function jr(n){if(!n)return;const{offset:e,end:t,range:r}=n;return{range:r,offset:e,end:t,length:t-e}}var He;(function(n){n[n.Before=0]="Before",n[n.After=1]="After",n[n.OverlapFront=2]="OverlapFront",n[n.OverlapBack=3]="OverlapBack",n[n.Inside=4]="Inside",n[n.Outside=5]="Outside"})(He||(He={}));function Td(n,e){if(n.end.line<e.start.line||n.end.line===e.start.line&&n.end.character<=e.start.character)return He.Before;if(n.start.line>e.end.line||n.start.line===e.end.line&&n.start.character>=e.end.character)return He.After;const t=n.start.line>e.start.line||n.start.line===e.start.line&&n.start.character>=e.start.character,r=n.end.line<e.end.line||n.end.line===e.end.line&&n.end.character<=e.end.character;return t&&r?He.Inside:t?He.OverlapBack:r?He.OverlapFront:He.Outside}function Rd(n,e){return Td(n,e)>He.After}const vd=/^[\w\p{L}]$/u;function Ad(n,e){if(n){const t=Ed(n,!0);if(t&&Aa(t,e))return t;if(Pl(n)){const r=n.content.findIndex(i=>!i.hidden);for(let i=r-1;i>=0;i--){const s=n.content[i];if(Aa(s,e))return s}}}}function Aa(n,e){return Ol(n)&&e.includes(n.tokenType.name)}function Ed(n,e=!0){for(;n.container;){const t=n.container;let r=t.content.indexOf(n);for(;r>0;){r--;const i=t.content[r];if(e||!i.hidden)return i}n=t}}class Ml extends Error{constructor(e,t){super(e?`${t} at ${e.range.start.line}:${e.range.start.character}`:t)}}function er(n){throw new Error("Error! The input value was not handled.")}const or="AbstractRule",lr="AbstractType",wi="Condition",Ea="TypeDefinition",_i="ValueLiteral",fn="AbstractElement";function kd(n){return M.isInstance(n,fn)}const cr="ArrayLiteral",ur="ArrayType",hn="BooleanLiteral";function $d(n){return M.isInstance(n,hn)}const pn="Conjunction";function xd(n){return M.isInstance(n,pn)}const mn="Disjunction";function Sd(n){return M.isInstance(n,mn)}const dr="Grammar",Li="GrammarImport",gn="InferredType";function Dl(n){return M.isInstance(n,gn)}const yn="Interface";function Fl(n){return M.isInstance(n,yn)}const bi="NamedArgument",Tn="Negation";function Id(n){return M.isInstance(n,Tn)}const fr="NumberLiteral",hr="Parameter",Rn="ParameterReference";function Cd(n){return M.isInstance(n,Rn)}const vn="ParserRule";function we(n){return M.isInstance(n,vn)}const pr="ReferenceType",wr="ReturnType";function Nd(n){return M.isInstance(n,wr)}const An="SimpleType";function wd(n){return M.isInstance(n,An)}const mr="StringLiteral",Nt="TerminalRule";function kt(n){return M.isInstance(n,Nt)}const En="Type";function Gl(n){return M.isInstance(n,En)}const Oi="TypeAttribute",gr="UnionType",kn="Action";function mi(n){return M.isInstance(n,kn)}const $n="Alternatives";function Ul(n){return M.isInstance(n,$n)}const xn="Assignment";function gt(n){return M.isInstance(n,xn)}const Sn="CharacterRange";function _d(n){return M.isInstance(n,Sn)}const In="CrossReference";function js(n){return M.isInstance(n,In)}const Cn="EndOfFile";function Ld(n){return M.isInstance(n,Cn)}const Nn="Group";function Hs(n){return M.isInstance(n,Nn)}const wn="Keyword";function yt(n){return M.isInstance(n,wn)}const _n="NegatedToken";function bd(n){return M.isInstance(n,_n)}const Ln="RegexToken";function Od(n){return M.isInstance(n,Ln)}const bn="RuleCall";function Tt(n){return M.isInstance(n,bn)}const On="TerminalAlternatives";function Pd(n){return M.isInstance(n,On)}const Pn="TerminalGroup";function Md(n){return M.isInstance(n,Pn)}const Mn="TerminalRuleCall";function Dd(n){return M.isInstance(n,Mn)}const Dn="UnorderedGroup";function Bl(n){return M.isInstance(n,Dn)}const Fn="UntilToken";function Fd(n){return M.isInstance(n,Fn)}const Gn="Wildcard";function Gd(n){return M.isInstance(n,Gn)}class Vl extends bl{getAllTypes(){return[fn,or,lr,kn,$n,cr,ur,xn,hn,Sn,wi,pn,In,mn,Cn,dr,Li,Nn,gn,yn,wn,bi,_n,Tn,fr,hr,Rn,vn,pr,Ln,wr,bn,An,mr,On,Pn,Nt,Mn,En,Oi,Ea,gr,Dn,Fn,_i,Gn]}computeIsSubtype(e,t){switch(e){case kn:case $n:case xn:case Sn:case In:case Cn:case Nn:case wn:case _n:case Ln:case bn:case On:case Pn:case Mn:case Dn:case Fn:case Gn:return this.isSubtype(fn,t);case cr:case fr:case mr:return this.isSubtype(_i,t);case ur:case pr:case An:case gr:return this.isSubtype(Ea,t);case hn:return this.isSubtype(wi,t)||this.isSubtype(_i,t);case pn:case mn:case Tn:case Rn:return this.isSubtype(wi,t);case gn:case yn:case En:return this.isSubtype(lr,t);case vn:return this.isSubtype(or,t)||this.isSubtype(lr,t);case Nt:return this.isSubtype(or,t);default:return!1}}getReferenceType(e){const t=`${e.container.$type}:${e.property}`;switch(t){case"Action:type":case"CrossReference:type":case"Interface:superTypes":case"ParserRule:returnType":case"SimpleType:typeRef":return lr;case"Grammar:hiddenTokens":case"ParserRule:hiddenTokens":case"RuleCall:rule":return or;case"Grammar:usedGrammars":return dr;case"NamedArgument:parameter":case"ParameterReference:parameter":return hr;case"TerminalRuleCall:rule":return Nt;default:throw new Error(`${t} is not a valid reference id.`)}}getTypeMetaData(e){switch(e){case fn:return{name:fn,properties:[{name:"cardinality"},{name:"lookahead"}]};case cr:return{name:cr,properties:[{name:"elements",defaultValue:[]}]};case ur:return{name:ur,properties:[{name:"elementType"}]};case hn:return{name:hn,properties:[{name:"true",defaultValue:!1}]};case pn:return{name:pn,properties:[{name:"left"},{name:"right"}]};case mn:return{name:mn,properties:[{name:"left"},{name:"right"}]};case dr:return{name:dr,properties:[{name:"definesHiddenTokens",defaultValue:!1},{name:"hiddenTokens",defaultValue:[]},{name:"imports",defaultValue:[]},{name:"interfaces",defaultValue:[]},{name:"isDeclared",defaultValue:!1},{name:"name"},{name:"rules",defaultValue:[]},{name:"types",defaultValue:[]},{name:"usedGrammars",defaultValue:[]}]};case Li:return{name:Li,properties:[{name:"path"}]};case gn:return{name:gn,properties:[{name:"name"}]};case yn:return{name:yn,properties:[{name:"attributes",defaultValue:[]},{name:"name"},{name:"superTypes",defaultValue:[]}]};case bi:return{name:bi,properties:[{name:"calledByName",defaultValue:!1},{name:"parameter"},{name:"value"}]};case Tn:return{name:Tn,properties:[{name:"value"}]};case fr:return{name:fr,properties:[{name:"value"}]};case hr:return{name:hr,properties:[{name:"name"}]};case Rn:return{name:Rn,properties:[{name:"parameter"}]};case vn:return{name:vn,properties:[{name:"dataType"},{name:"definesHiddenTokens",defaultValue:!1},{name:"definition"},{name:"entry",defaultValue:!1},{name:"fragment",defaultValue:!1},{name:"hiddenTokens",defaultValue:[]},{name:"inferredType"},{name:"name"},{name:"parameters",defaultValue:[]},{name:"returnType"},{name:"wildcard",defaultValue:!1}]};case pr:return{name:pr,properties:[{name:"referenceType"}]};case wr:return{name:wr,properties:[{name:"name"}]};case An:return{name:An,properties:[{name:"primitiveType"},{name:"stringType"},{name:"typeRef"}]};case mr:return{name:mr,properties:[{name:"value"}]};case Nt:return{name:Nt,properties:[{name:"definition"},{name:"fragment",defaultValue:!1},{name:"hidden",defaultValue:!1},{name:"name"},{name:"type"}]};case En:return{name:En,properties:[{name:"name"},{name:"type"}]};case Oi:return{name:Oi,properties:[{name:"defaultValue"},{name:"isOptional",defaultValue:!1},{name:"name"},{name:"type"}]};case gr:return{name:gr,properties:[{name:"types",defaultValue:[]}]};case kn:return{name:kn,properties:[{name:"cardinality"},{name:"feature"},{name:"inferredType"},{name:"lookahead"},{name:"operator"},{name:"type"}]};case $n:return{name:$n,properties:[{name:"cardinality"},{name:"elements",defaultValue:[]},{name:"lookahead"}]};case xn:return{name:xn,properties:[{name:"cardinality"},{name:"feature"},{name:"lookahead"},{name:"operator"},{name:"terminal"}]};case Sn:return{name:Sn,properties:[{name:"cardinality"},{name:"left"},{name:"lookahead"},{name:"right"}]};case In:return{name:In,properties:[{name:"cardinality"},{name:"deprecatedSyntax",defaultValue:!1},{name:"lookahead"},{name:"terminal"},{name:"type"}]};case Cn:return{name:Cn,properties:[{name:"cardinality"},{name:"lookahead"}]};case Nn:return{name:Nn,properties:[{name:"cardinality"},{name:"elements",defaultValue:[]},{name:"guardCondition"},{name:"lookahead"}]};case wn:return{name:wn,properties:[{name:"cardinality"},{name:"lookahead"},{name:"value"}]};case _n:return{name:_n,properties:[{name:"cardinality"},{name:"lookahead"},{name:"terminal"}]};case Ln:return{name:Ln,properties:[{name:"cardinality"},{name:"lookahead"},{name:"regex"}]};case bn:return{name:bn,properties:[{name:"arguments",defaultValue:[]},{name:"cardinality"},{name:"lookahead"},{name:"rule"}]};case On:return{name:On,properties:[{name:"cardinality"},{name:"elements",defaultValue:[]},{name:"lookahead"}]};case Pn:return{name:Pn,properties:[{name:"cardinality"},{name:"elements",defaultValue:[]},{name:"lookahead"}]};case Mn:return{name:Mn,properties:[{name:"cardinality"},{name:"lookahead"},{name:"rule"}]};case Dn:return{name:Dn,properties:[{name:"cardinality"},{name:"elements",defaultValue:[]},{name:"lookahead"}]};case Fn:return{name:Fn,properties:[{name:"cardinality"},{name:"lookahead"},{name:"terminal"}]};case Gn:return{name:Gn,properties:[{name:"cardinality"},{name:"lookahead"}]};default:return{name:e,properties:[]}}}}const M=new Vl;function Ud(n){for(const[e,t]of Object.entries(n))e.startsWith("$")||(Array.isArray(t)?t.forEach((r,i)=>{ae(r)&&(r.$container=n,r.$containerProperty=e,r.$containerIndex=i)}):ae(t)&&(t.$container=n,t.$containerProperty=e))}function gi(n,e){let t=n;for(;t;){if(e(t))return t;t=t.$container}}function Ze(n){const t=os(n).$document;if(!t)throw new Error("AST node has no document.");return t}function os(n){for(;n.$container;)n=n.$container;return n}function zs(n,e){if(!n)throw new Error("Node must be an AstNode.");const t=e?.range;return new Z(()=>({keys:Object.keys(n),keyIndex:0,arrayIndex:0}),r=>{for(;r.keyIndex<r.keys.length;){const i=r.keys[r.keyIndex];if(!i.startsWith("$")){const s=n[i];if(ae(s)){if(r.keyIndex++,ka(s,t))return{done:!1,value:s}}else if(Array.isArray(s)){for(;r.arrayIndex<s.length;){const a=r.arrayIndex++,o=s[a];if(ae(o)&&ka(o,t))return{done:!1,value:o}}r.arrayIndex=0}}r.keyIndex++}return ve})}function tr(n,e){if(!n)throw new Error("Root node must be an AstNode.");return new Ws(n,t=>zs(t,e))}function _t(n,e){if(!n)throw new Error("Root node must be an AstNode.");return new Ws(n,t=>zs(t,e),{includeRoot:!0})}function ka(n,e){var t;if(!e)return!0;const r=(t=n.$cstNode)===null||t===void 0?void 0:t.range;return r?Rd(r,e):!1}function Kl(n){return new Z(()=>({keys:Object.keys(n),keyIndex:0,arrayIndex:0}),e=>{for(;e.keyIndex<e.keys.length;){const t=e.keys[e.keyIndex];if(!t.startsWith("$")){const r=n[t];if(Ue(r))return e.keyIndex++,{done:!1,value:{reference:r,container:n,property:t}};if(Array.isArray(r)){for(;e.arrayIndex<r.length;){const i=e.arrayIndex++,s=r[i];if(Ue(s))return{done:!1,value:{reference:s,container:n,property:t,index:i}}}e.arrayIndex=0}}e.keyIndex++}return ve})}function Bd(n,e){const t=n.getTypeMetaData(e.$type),r=e;for(const i of t.properties)i.defaultValue!==void 0&&r[i.name]===void 0&&(r[i.name]=Wl(i.defaultValue))}function Wl(n){return Array.isArray(n)?[...n.map(Wl)]:n}function w(n){return n.charCodeAt(0)}function Pi(n,e){Array.isArray(n)?n.forEach(function(t){e.push(t)}):e.push(n)}function cn(n,e){if(n[e]===!0)throw"duplicate flag "+e;n[e],n[e]=!0}function Ct(n){if(n===void 0)throw Error("Internal Error - Should never get here!");return!0}function Vd(){throw Error("Internal Error - Should never get here!")}function $a(n){return n.type==="Character"}const Hr=[];for(let n=w("0");n<=w("9");n++)Hr.push(n);const zr=[w("_")].concat(Hr);for(let n=w("a");n<=w("z");n++)zr.push(n);for(let n=w("A");n<=w("Z");n++)zr.push(n);const xa=[w(" "),w("\f"),w(`
-`),w("\r"),w("	"),w("\v"),w("	"),w(" "),w(" "),w(" "),w(" "),w(" "),w(" "),w(" "),w(" "),w(" "),w(" "),w(" "),w(" "),w(" "),w("\u2028"),w("\u2029"),w(" "),w(" "),w("　"),w("\uFEFF")],Kd=/[0-9a-fA-F]/,yr=/[0-9]/,Wd=/[1-9]/;class jl{constructor(){this.idx=0,this.input="",this.groupIdx=0}saveState(){return{idx:this.idx,input:this.input,groupIdx:this.groupIdx}}restoreState(e){this.idx=e.idx,this.input=e.input,this.groupIdx=e.groupIdx}pattern(e){this.idx=0,this.input=e,this.groupIdx=0,this.consumeChar("/");const t=this.disjunction();this.consumeChar("/");const r={type:"Flags",loc:{begin:this.idx,end:e.length},global:!1,ignoreCase:!1,multiLine:!1,unicode:!1,sticky:!1};for(;this.isRegExpFlag();)switch(this.popChar()){case"g":cn(r,"global");break;case"i":cn(r,"ignoreCase");break;case"m":cn(r,"multiLine");break;case"u":cn(r,"unicode");break;case"y":cn(r,"sticky");break}if(this.idx!==this.input.length)throw Error("Redundant input: "+this.input.substring(this.idx));return{type:"Pattern",flags:r,value:t,loc:this.loc(0)}}disjunction(){const e=[],t=this.idx;for(e.push(this.alternative());this.peekChar()==="|";)this.consumeChar("|"),e.push(this.alternative());return{type:"Disjunction",value:e,loc:this.loc(t)}}alternative(){const e=[],t=this.idx;for(;this.isTerm();)e.push(this.term());return{type:"Alternative",value:e,loc:this.loc(t)}}term(){return this.isAssertion()?this.assertion():this.atom()}assertion(){const e=this.idx;switch(this.popChar()){case"^":return{type:"StartAnchor",loc:this.loc(e)};case"$":return{type:"EndAnchor",loc:this.loc(e)};case"\\":switch(this.popChar()){case"b":return{type:"WordBoundary",loc:this.loc(e)};case"B":return{type:"NonWordBoundary",loc:this.loc(e)}}throw Error("Invalid Assertion Escape");case"(":this.consumeChar("?");let t;switch(this.popChar()){case"=":t="Lookahead";break;case"!":t="NegativeLookahead";break}Ct(t);const r=this.disjunction();return this.consumeChar(")"),{type:t,value:r,loc:this.loc(e)}}return Vd()}quantifier(e=!1){let t;const r=this.idx;switch(this.popChar()){case"*":t={atLeast:0,atMost:1/0};break;case"+":t={atLeast:1,atMost:1/0};break;case"?":t={atLeast:0,atMost:1};break;case"{":const i=this.integerIncludingZero();switch(this.popChar()){case"}":t={atLeast:i,atMost:i};break;case",":let s;this.isDigit()?(s=this.integerIncludingZero(),t={atLeast:i,atMost:s}):t={atLeast:i,atMost:1/0},this.consumeChar("}");break}if(e===!0&&t===void 0)return;Ct(t);break}if(!(e===!0&&t===void 0)&&Ct(t))return this.peekChar(0)==="?"?(this.consumeChar("?"),t.greedy=!1):t.greedy=!0,t.type="Quantifier",t.loc=this.loc(r),t}atom(){let e;const t=this.idx;switch(this.peekChar()){case".":e=this.dotAll();break;case"\\":e=this.atomEscape();break;case"[":e=this.characterClass();break;case"(":e=this.group();break}if(e===void 0&&this.isPatternCharacter()&&(e=this.patternCharacter()),Ct(e))return e.loc=this.loc(t),this.isQuantifier()&&(e.quantifier=this.quantifier()),e}dotAll(){return this.consumeChar("."),{type:"Set",complement:!0,value:[w(`
-`),w("\r"),w("\u2028"),w("\u2029")]}}atomEscape(){switch(this.consumeChar("\\"),this.peekChar()){case"1":case"2":case"3":case"4":case"5":case"6":case"7":case"8":case"9":return this.decimalEscapeAtom();case"d":case"D":case"s":case"S":case"w":case"W":return this.characterClassEscape();case"f":case"n":case"r":case"t":case"v":return this.controlEscapeAtom();case"c":return this.controlLetterEscapeAtom();case"0":return this.nulCharacterAtom();case"x":return this.hexEscapeSequenceAtom();case"u":return this.regExpUnicodeEscapeSequenceAtom();default:return this.identityEscapeAtom()}}decimalEscapeAtom(){return{type:"GroupBackReference",value:this.positiveInteger()}}characterClassEscape(){let e,t=!1;switch(this.popChar()){case"d":e=Hr;break;case"D":e=Hr,t=!0;break;case"s":e=xa;break;case"S":e=xa,t=!0;break;case"w":e=zr;break;case"W":e=zr,t=!0;break}if(Ct(e))return{type:"Set",value:e,complement:t}}controlEscapeAtom(){let e;switch(this.popChar()){case"f":e=w("\f");break;case"n":e=w(`
-`);break;case"r":e=w("\r");break;case"t":e=w("	");break;case"v":e=w("\v");break}if(Ct(e))return{type:"Character",value:e}}controlLetterEscapeAtom(){this.consumeChar("c");const e=this.popChar();if(/[a-zA-Z]/.test(e)===!1)throw Error("Invalid ");return{type:"Character",value:e.toUpperCase().charCodeAt(0)-64}}nulCharacterAtom(){return this.consumeChar("0"),{type:"Character",value:w("\0")}}hexEscapeSequenceAtom(){return this.consumeChar("x"),this.parseHexDigits(2)}regExpUnicodeEscapeSequenceAtom(){return this.consumeChar("u"),this.parseHexDigits(4)}identityEscapeAtom(){const e=this.popChar();return{type:"Character",value:w(e)}}classPatternCharacterAtom(){switch(this.peekChar()){case`
-`:case"\r":case"\u2028":case"\u2029":case"\\":case"]":throw Error("TBD");default:const e=this.popChar();return{type:"Character",value:w(e)}}}characterClass(){const e=[];let t=!1;for(this.consumeChar("["),this.peekChar(0)==="^"&&(this.consumeChar("^"),t=!0);this.isClassAtom();){const r=this.classAtom();if(r.type,$a(r)&&this.isRangeDash()){this.consumeChar("-");const i=this.classAtom();if(i.type,$a(i)){if(i.value<r.value)throw Error("Range out of order in character class");e.push({from:r.value,to:i.value})}else Pi(r.value,e),e.push(w("-")),Pi(i.value,e)}else Pi(r.value,e)}return this.consumeChar("]"),{type:"Set",complement:t,value:e}}classAtom(){switch(this.peekChar()){case"]":case`
-`:case"\r":case"\u2028":case"\u2029":throw Error("TBD");case"\\":return this.classEscape();default:return this.classPatternCharacterAtom()}}classEscape(){switch(this.consumeChar("\\"),this.peekChar()){case"b":return this.consumeChar("b"),{type:"Character",value:w("\b")};case"d":case"D":case"s":case"S":case"w":case"W":return this.characterClassEscape();case"f":case"n":case"r":case"t":case"v":return this.controlEscapeAtom();case"c":return this.controlLetterEscapeAtom();case"0":return this.nulCharacterAtom();case"x":return this.hexEscapeSequenceAtom();case"u":return this.regExpUnicodeEscapeSequenceAtom();default:return this.identityEscapeAtom()}}group(){let e=!0;switch(this.consumeChar("("),this.peekChar(0)){case"?":this.consumeChar("?"),this.consumeChar(":"),e=!1;break;default:this.groupIdx++;break}const t=this.disjunction();this.consumeChar(")");const r={type:"Group",capturing:e,value:t};return e&&(r.idx=this.groupIdx),r}positiveInteger(){let e=this.popChar();if(Wd.test(e)===!1)throw Error("Expecting a positive integer");for(;yr.test(this.peekChar(0));)e+=this.popChar();return parseInt(e,10)}integerIncludingZero(){let e=this.popChar();if(yr.test(e)===!1)throw Error("Expecting an integer");for(;yr.test(this.peekChar(0));)e+=this.popChar();return parseInt(e,10)}patternCharacter(){const e=this.popChar();switch(e){case`
-`:case"\r":case"\u2028":case"\u2029":case"^":case"$":case"\\":case".":case"*":case"+":case"?":case"(":case")":case"[":case"|":throw Error("TBD");default:return{type:"Character",value:w(e)}}}isRegExpFlag(){switch(this.peekChar(0)){case"g":case"i":case"m":case"u":case"y":return!0;default:return!1}}isRangeDash(){return this.peekChar()==="-"&&this.isClassAtom(1)}isDigit(){return yr.test(this.peekChar(0))}isClassAtom(e=0){switch(this.peekChar(e)){case"]":case`
-`:case"\r":case"\u2028":case"\u2029":return!1;default:return!0}}isTerm(){return this.isAtom()||this.isAssertion()}isAtom(){if(this.isPatternCharacter())return!0;switch(this.peekChar(0)){case".":case"\\":case"[":case"(":return!0;default:return!1}}isAssertion(){switch(this.peekChar(0)){case"^":case"$":return!0;case"\\":switch(this.peekChar(1)){case"b":case"B":return!0;default:return!1}case"(":return this.peekChar(1)==="?"&&(this.peekChar(2)==="="||this.peekChar(2)==="!");default:return!1}}isQuantifier(){const e=this.saveState();try{return this.quantifier(!0)!==void 0}catch{return!1}finally{this.restoreState(e)}}isPatternCharacter(){switch(this.peekChar()){case"^":case"$":case"\\":case".":case"*":case"+":case"?":case"(":case")":case"[":case"|":case"/":case`
-`:case"\r":case"\u2028":case"\u2029":return!1;default:return!0}}parseHexDigits(e){let t="";for(let i=0;i<e;i++){const s=this.popChar();if(Kd.test(s)===!1)throw Error("Expecting a HexDecimal digits");t+=s}return{type:"Character",value:parseInt(t,16)}}peekChar(e=0){return this.input[this.idx+e]}popChar(){const e=this.peekChar(0);return this.consumeChar(void 0),e}consumeChar(e){if(e!==void 0&&this.input[this.idx]!==e)throw Error("Expected: '"+e+"' but found: '"+this.input[this.idx]+"' at offset: "+this.idx);if(this.idx>=this.input.length)throw Error("Unexpected end of input");this.idx++}loc(e){return{begin:e,end:this.idx}}}class yi{visitChildren(e){for(const t in e){const r=e[t];e.hasOwnProperty(t)&&(r.type!==void 0?this.visit(r):Array.isArray(r)&&r.forEach(i=>{this.visit(i)},this))}}visit(e){switch(e.type){case"Pattern":this.visitPattern(e);break;case"Flags":this.visitFlags(e);break;case"Disjunction":this.visitDisjunction(e);break;case"Alternative":this.visitAlternative(e);break;case"StartAnchor":this.visitStartAnchor(e);break;case"EndAnchor":this.visitEndAnchor(e);break;case"WordBoundary":this.visitWordBoundary(e);break;case"NonWordBoundary":this.visitNonWordBoundary(e);break;case"Lookahead":this.visitLookahead(e);break;case"NegativeLookahead":this.visitNegativeLookahead(e);break;case"Character":this.visitCharacter(e);break;case"Set":this.visitSet(e);break;case"Group":this.visitGroup(e);break;case"GroupBackReference":this.visitGroupBackReference(e);break;case"Quantifier":this.visitQuantifier(e);break}this.visitChildren(e)}visitPattern(e){}visitFlags(e){}visitDisjunction(e){}visitAlternative(e){}visitStartAnchor(e){}visitEndAnchor(e){}visitWordBoundary(e){}visitNonWordBoundary(e){}visitLookahead(e){}visitNegativeLookahead(e){}visitCharacter(e){}visitSet(e){}visitGroup(e){}visitGroupBackReference(e){}visitQuantifier(e){}}const jd=/\r?\n/gm,Hd=new jl;class zd extends yi{constructor(){super(...arguments),this.isStarting=!0,this.endRegexpStack=[],this.multiline=!1}get endRegex(){return this.endRegexpStack.join("")}reset(e){this.multiline=!1,this.regex=e,this.startRegexp="",this.isStarting=!0,this.endRegexpStack=[]}visitGroup(e){e.quantifier&&(this.isStarting=!1,this.endRegexpStack=[])}visitCharacter(e){const t=String.fromCharCode(e.value);if(!this.multiline&&t===`
-`&&(this.multiline=!0),e.quantifier)this.isStarting=!1,this.endRegexpStack=[];else{const r=Ti(t);this.endRegexpStack.push(r),this.isStarting&&(this.startRegexp+=r)}}visitSet(e){if(!this.multiline){const t=this.regex.substring(e.loc.begin,e.loc.end),r=new RegExp(t);this.multiline=!!`
-`.match(r)}if(e.quantifier)this.isStarting=!1,this.endRegexpStack=[];else{const t=this.regex.substring(e.loc.begin,e.loc.end);this.endRegexpStack.push(t),this.isStarting&&(this.startRegexp+=t)}}visitChildren(e){e.type==="Group"&&e.quantifier||super.visitChildren(e)}}const Mi=new zd;function qd(n){try{return typeof n=="string"&&(n=new RegExp(n)),n=n.toString(),Mi.reset(n),Mi.visit(Hd.pattern(n)),Mi.multiline}catch{return!1}}const Yd=`\f
-\r	\v              \u2028\u2029  　\uFEFF`.split("");function ls(n){const e=typeof n=="string"?new RegExp(n):n;return Yd.some(t=>e.test(t))}function Ti(n){return n.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function Xd(n){return Array.prototype.map.call(n,e=>/\w/.test(e)?`[${e.toLowerCase()}${e.toUpperCase()}]`:Ti(e)).join("")}function Jd(n,e){const t=Qd(n),r=e.match(t);return!!r&&r[0].length>0}function Qd(n){typeof n=="string"&&(n=new RegExp(n));const e=n,t=n.source;let r=0;function i(){let s="",a;function o(c){s+=t.substr(r,c),r+=c}function l(c){s+="(?:"+t.substr(r,c)+"|$)",r+=c}for(;r<t.length;)switch(t[r]){case"\\":switch(t[r+1]){case"c":l(3);break;case"x":l(4);break;case"u":e.unicode?t[r+2]==="{"?l(t.indexOf("}",r)-r+1):l(6):l(2);break;case"p":case"P":e.unicode?l(t.indexOf("}",r)-r+1):l(2);break;case"k":l(t.indexOf(">",r)-r+1);break;default:l(2);break}break;case"[":a=/\[(?:\\.|.)*?\]/g,a.lastIndex=r,a=a.exec(t)||[],l(a[0].length);break;case"|":case"^":case"$":case"*":case"+":case"?":o(1);break;case"{":a=/\{\d+,?\d*\}/g,a.lastIndex=r,a=a.exec(t),a?o(a[0].length):l(1);break;case"(":if(t[r+1]==="?")switch(t[r+2]){case":":s+="(?:",r+=3,s+=i()+"|$)";break;case"=":s+="(?=",r+=3,s+=i()+")";break;case"!":a=r,r+=3,i(),s+=t.substr(a,r-a);break;case"<":switch(t[r+3]){case"=":case"!":a=r,r+=4,i(),s+=t.substr(a,r-a);break;default:o(t.indexOf(">",r)-r+1),s+=i()+"|$)";break}break}else o(1),s+=i()+"|$)";break;case")":return++r,s;default:l(1);break}return s}return new RegExp(i(),n.flags)}function Zd(n){return n.rules.find(e=>we(e)&&e.entry)}function ef(n){return n.rules.filter(e=>kt(e)&&e.hidden)}function Hl(n,e){const t=new Set,r=Zd(n);if(!r)return new Set(n.rules);const i=[r].concat(ef(n));for(const a of i)zl(a,t,e);const s=new Set;for(const a of n.rules)(t.has(a.name)||kt(a)&&a.hidden)&&s.add(a);return s}function zl(n,e,t){e.add(n.name),tr(n).forEach(r=>{if(Tt(r)||t){const i=r.rule.ref;i&&!e.has(i.name)&&zl(i,e,t)}})}function tf(n){if(n.terminal)return n.terminal;if(n.type.ref){const e=Yl(n.type.ref);return e?.terminal}}function nf(n){return n.hidden&&!ls(Js(n))}function rf(n,e){return!n||!e?[]:qs(n,e,n.astNode,!0)}function ql(n,e,t){if(!n||!e)return;const r=qs(n,e,n.astNode,!0);if(r.length!==0)return t!==void 0?t=Math.max(0,Math.min(t,r.length-1)):t=0,r[t]}function qs(n,e,t,r){if(!r){const i=gi(n.grammarSource,gt);if(i&&i.feature===e)return[n]}return Xn(n)&&n.astNode===t?n.content.flatMap(i=>qs(i,e,t,!1)):[]}function sf(n,e,t){if(!n)return;const r=af(n,e,n?.astNode);if(r.length!==0)return t!==void 0?t=Math.max(0,Math.min(t,r.length-1)):t=0,r[t]}function af(n,e,t){if(n.astNode!==t)return[];if(yt(n.grammarSource)&&n.grammarSource.value===e)return[n];const r=ss(n).iterator();let i;const s=[];do if(i=r.next(),!i.done){const a=i.value;a.astNode===t?yt(a.grammarSource)&&a.grammarSource.value===e&&s.push(a):r.prune()}while(!i.done);return s}function of(n){var e;const t=n.astNode;for(;t===((e=n.container)===null||e===void 0?void 0:e.astNode);){const r=gi(n.grammarSource,gt);if(r)return r;n=n.container}}function Yl(n){let e=n;return Dl(e)&&(mi(e.$container)?e=e.$container.$container:we(e.$container)?e=e.$container:er(e.$container)),Xl(n,e,new Map)}function Xl(n,e,t){var r;function i(s,a){let o;return gi(s,gt)||(o=Xl(a,a,t)),t.set(n,o),o}if(t.has(n))return t.get(n);t.set(n,void 0);for(const s of tr(e)){if(gt(s)&&s.feature.toLowerCase()==="name")return t.set(n,s),s;if(Tt(s)&&we(s.rule.ref))return i(s,s.rule.ref);if(wd(s)&&(!((r=s.typeRef)===null||r===void 0)&&r.ref))return i(s,s.typeRef.ref)}}function Jl(n){return Ql(n,new Set)}function Ql(n,e){if(e.has(n))return!0;e.add(n);for(const t of tr(n))if(Tt(t)){if(!t.rule.ref||we(t.rule.ref)&&!Ql(t.rule.ref,e))return!1}else{if(gt(t))return!1;if(mi(t))return!1}return!!n.definition}function Ys(n){if(n.inferredType)return n.inferredType.name;if(n.dataType)return n.dataType;if(n.returnType){const e=n.returnType.ref;if(e){if(we(e))return e.name;if(Fl(e)||Gl(e))return e.name}}}function Xs(n){var e;if(we(n))return Jl(n)?n.name:(e=Ys(n))!==null&&e!==void 0?e:n.name;if(Fl(n)||Gl(n)||Nd(n))return n.name;if(mi(n)){const t=lf(n);if(t)return t}else if(Dl(n))return n.name;throw new Error("Cannot get name of Unknown Type")}function lf(n){var e;if(n.inferredType)return n.inferredType.name;if(!((e=n.type)===null||e===void 0)&&e.ref)return Xs(n.type.ref)}function cf(n){var e,t,r;return kt(n)?(t=(e=n.type)===null||e===void 0?void 0:e.name)!==null&&t!==void 0?t:"string":(r=Ys(n))!==null&&r!==void 0?r:n.name}function Js(n){const e={s:!1,i:!1,u:!1},t=sn(n.definition,e),r=Object.entries(e).filter(([,i])=>i).map(([i])=>i).join("");return new RegExp(t,r)}const Qs=/[\s\S]/.source;function sn(n,e){if(Pd(n))return uf(n);if(Md(n))return df(n);if(_d(n))return pf(n);if(Dd(n)){const t=n.rule.ref;if(!t)throw new Error("Missing rule reference.");return qe(sn(t.definition),{cardinality:n.cardinality,lookahead:n.lookahead})}else{if(bd(n))return hf(n);if(Fd(n))return ff(n);if(Od(n)){const t=n.regex.lastIndexOf("/"),r=n.regex.substring(1,t),i=n.regex.substring(t+1);return e&&(e.i=i.includes("i"),e.s=i.includes("s"),e.u=i.includes("u")),qe(r,{cardinality:n.cardinality,lookahead:n.lookahead,wrap:!1})}else{if(Gd(n))return qe(Qs,{cardinality:n.cardinality,lookahead:n.lookahead});throw new Error(`Invalid terminal element: ${n?.$type}`)}}}function uf(n){return qe(n.elements.map(e=>sn(e)).join("|"),{cardinality:n.cardinality,lookahead:n.lookahead})}function df(n){return qe(n.elements.map(e=>sn(e)).join(""),{cardinality:n.cardinality,lookahead:n.lookahead})}function ff(n){return qe(`${Qs}*?${sn(n.terminal)}`,{cardinality:n.cardinality,lookahead:n.lookahead})}function hf(n){return qe(`(?!${sn(n.terminal)})${Qs}*?`,{cardinality:n.cardinality,lookahead:n.lookahead})}function pf(n){return n.right?qe(`[${Di(n.left)}-${Di(n.right)}]`,{cardinality:n.cardinality,lookahead:n.lookahead,wrap:!1}):qe(Di(n.left),{cardinality:n.cardinality,lookahead:n.lookahead,wrap:!1})}function Di(n){return Ti(n.value)}function qe(n,e){var t;return(e.wrap!==!1||e.lookahead)&&(n=`(${(t=e.lookahead)!==null&&t!==void 0?t:""}${n})`),e.cardinality?`${n}${e.cardinality}`:n}function mf(n){const e=[],t=n.Grammar;for(const r of t.rules)kt(r)&&nf(r)&&qd(Js(r))&&e.push(r.name);return{multilineCommentRules:e,nameRegexp:vd}}function cs(n){console&&console.error&&console.error(`Error: ${n}`)}function Zl(n){console&&console.warn&&console.warn(`Warning: ${n}`)}function ec(n){const e=new Date().getTime(),t=n();return{time:new Date().getTime()-e,value:t}}function tc(n){function e(){}e.prototype=n;const t=new e;function r(){return typeof t.bar}return r(),r(),n}function gf(n){return yf(n)?n.LABEL:n.name}function yf(n){return he(n.LABEL)&&n.LABEL!==""}class Be{get definition(){return this._definition}set definition(e){this._definition=e}constructor(e){this._definition=e}accept(e){e.visit(this),C(this.definition,t=>{t.accept(e)})}}class ce extends Be{constructor(e){super([]),this.idx=1,ke(this,Me(e,t=>t!==void 0))}set definition(e){}get definition(){return this.referencedRule!==void 0?this.referencedRule.definition:[]}accept(e){e.visit(this)}}class an extends Be{constructor(e){super(e.definition),this.orgText="",ke(this,Me(e,t=>t!==void 0))}}class pe extends Be{constructor(e){super(e.definition),this.ignoreAmbiguities=!1,ke(this,Me(e,t=>t!==void 0))}}let ne=class extends Be{constructor(e){super(e.definition),this.idx=1,ke(this,Me(e,t=>t!==void 0))}};class xe extends Be{constructor(e){super(e.definition),this.idx=1,ke(this,Me(e,t=>t!==void 0))}}class Se extends Be{constructor(e){super(e.definition),this.idx=1,ke(this,Me(e,t=>t!==void 0))}}class W extends Be{constructor(e){super(e.definition),this.idx=1,ke(this,Me(e,t=>t!==void 0))}}class me extends Be{constructor(e){super(e.definition),this.idx=1,ke(this,Me(e,t=>t!==void 0))}}class ge extends Be{get definition(){return this._definition}set definition(e){this._definition=e}constructor(e){super(e.definition),this.idx=1,this.ignoreAmbiguities=!1,this.hasPredicates=!1,ke(this,Me(e,t=>t!==void 0))}}class G{constructor(e){this.idx=1,ke(this,Me(e,t=>t!==void 0))}accept(e){e.visit(this)}}function Tf(n){return $(n,_r)}function _r(n){function e(t){return $(t,_r)}if(n instanceof ce){const t={type:"NonTerminal",name:n.nonTerminalName,idx:n.idx};return he(n.label)&&(t.label=n.label),t}else{if(n instanceof pe)return{type:"Alternative",definition:e(n.definition)};if(n instanceof ne)return{type:"Option",idx:n.idx,definition:e(n.definition)};if(n instanceof xe)return{type:"RepetitionMandatory",idx:n.idx,definition:e(n.definition)};if(n instanceof Se)return{type:"RepetitionMandatoryWithSeparator",idx:n.idx,separator:_r(new G({terminalType:n.separator})),definition:e(n.definition)};if(n instanceof me)return{type:"RepetitionWithSeparator",idx:n.idx,separator:_r(new G({terminalType:n.separator})),definition:e(n.definition)};if(n instanceof W)return{type:"Repetition",idx:n.idx,definition:e(n.definition)};if(n instanceof ge)return{type:"Alternation",idx:n.idx,definition:e(n.definition)};if(n instanceof G){const t={type:"Terminal",name:n.terminalType.name,label:gf(n.terminalType),idx:n.idx};he(n.label)&&(t.terminalLabel=n.label);const r=n.terminalType.PATTERN;return n.terminalType.PATTERN&&(t.pattern=Xe(r)?r.source:r),t}else{if(n instanceof an)return{type:"Rule",name:n.name,orgText:n.orgText,definition:e(n.definition)};throw Error("non exhaustive match")}}}class on{visit(e){const t=e;switch(t.constructor){case ce:return this.visitNonTerminal(t);case pe:return this.visitAlternative(t);case ne:return this.visitOption(t);case xe:return this.visitRepetitionMandatory(t);case Se:return this.visitRepetitionMandatoryWithSeparator(t);case me:return this.visitRepetitionWithSeparator(t);case W:return this.visitRepetition(t);case ge:return this.visitAlternation(t);case G:return this.visitTerminal(t);case an:return this.visitRule(t);default:throw Error("non exhaustive match")}}visitNonTerminal(e){}visitAlternative(e){}visitOption(e){}visitRepetition(e){}visitRepetitionMandatory(e){}visitRepetitionMandatoryWithSeparator(e){}visitRepetitionWithSeparator(e){}visitAlternation(e){}visitTerminal(e){}visitRule(e){}}function Rf(n){return n instanceof pe||n instanceof ne||n instanceof W||n instanceof xe||n instanceof Se||n instanceof me||n instanceof G||n instanceof an}function qr(n,e=[]){return n instanceof ne||n instanceof W||n instanceof me?!0:n instanceof ge?Ll(n.definition,r=>qr(r,e)):n instanceof ce&&de(e,n)?!1:n instanceof Be?(n instanceof ce&&e.push(n),Oe(n.definition,r=>qr(r,e))):!1}function vf(n){return n instanceof ge}function Ge(n){if(n instanceof ce)return"SUBRULE";if(n instanceof ne)return"OPTION";if(n instanceof ge)return"OR";if(n instanceof xe)return"AT_LEAST_ONE";if(n instanceof Se)return"AT_LEAST_ONE_SEP";if(n instanceof me)return"MANY_SEP";if(n instanceof W)return"MANY";if(n instanceof G)return"CONSUME";throw Error("non exhaustive match")}class Ri{walk(e,t=[]){C(e.definition,(r,i)=>{const s=Q(e.definition,i+1);if(r instanceof ce)this.walkProdRef(r,s,t);else if(r instanceof G)this.walkTerminal(r,s,t);else if(r instanceof pe)this.walkFlat(r,s,t);else if(r instanceof ne)this.walkOption(r,s,t);else if(r instanceof xe)this.walkAtLeastOne(r,s,t);else if(r instanceof Se)this.walkAtLeastOneSep(r,s,t);else if(r instanceof me)this.walkManySep(r,s,t);else if(r instanceof W)this.walkMany(r,s,t);else if(r instanceof ge)this.walkOr(r,s,t);else throw Error("non exhaustive match")})}walkTerminal(e,t,r){}walkProdRef(e,t,r){}walkFlat(e,t,r){const i=t.concat(r);this.walk(e,i)}walkOption(e,t,r){const i=t.concat(r);this.walk(e,i)}walkAtLeastOne(e,t,r){const i=[new ne({definition:e.definition})].concat(t,r);this.walk(e,i)}walkAtLeastOneSep(e,t,r){const i=Sa(e,t,r);this.walk(e,i)}walkMany(e,t,r){const i=[new ne({definition:e.definition})].concat(t,r);this.walk(e,i)}walkManySep(e,t,r){const i=Sa(e,t,r);this.walk(e,i)}walkOr(e,t,r){const i=t.concat(r);C(e.definition,s=>{const a=new pe({definition:[s]});this.walk(a,i)})}}function Sa(n,e,t){return[new ne({definition:[new G({terminalType:n.separator})].concat(n.definition)})].concat(e,t)}function nr(n){if(n instanceof ce)return nr(n.referencedRule);if(n instanceof G)return kf(n);if(Rf(n))return Af(n);if(vf(n))return Ef(n);throw Error("non exhaustive match")}function Af(n){let e=[];const t=n.definition;let r=0,i=t.length>r,s,a=!0;for(;i&&a;)s=t[r],a=qr(s),e=e.concat(nr(s)),r=r+1,i=t.length>r;return Ks(e)}function Ef(n){const e=$(n.definition,t=>nr(t));return Ks(Ne(e))}function kf(n){return[n.terminalType]}const nc="_~IN~_";class $f extends Ri{constructor(e){super(),this.topProd=e,this.follows={}}startWalking(){return this.walk(this.topProd),this.follows}walkTerminal(e,t,r){}walkProdRef(e,t,r){const i=Sf(e.referencedRule,e.idx)+this.topProd.name,s=t.concat(r),a=new pe({definition:s}),o=nr(a);this.follows[i]=o}}function xf(n){const e={};return C(n,t=>{const r=new $f(t).startWalking();ke(e,r)}),e}function Sf(n,e){return n.name+e+nc}let Lr={};const If=new jl;function vi(n){const e=n.toString();if(Lr.hasOwnProperty(e))return Lr[e];{const t=If.pattern(e);return Lr[e]=t,t}}function Cf(){Lr={}}const rc="Complement Sets are not supported for first char optimization",Yr=`Unable to use "first char" lexer optimizations:
-`;function Nf(n,e=!1){try{const t=vi(n);return us(t.value,{},t.flags.ignoreCase)}catch(t){if(t.message===rc)e&&Zl(`${Yr}	Unable to optimize: < ${n.toString()} >
-	Complement Sets cannot be automatically optimized.
-	This will disable the lexer's first char optimizations.
-	See: https://chevrotain.io/docs/guide/resolving_lexer_errors.html#COMPLEMENT for details.`);else{let r="";e&&(r=`
-	This will disable the lexer's first char optimizations.
-	See: https://chevrotain.io/docs/guide/resolving_lexer_errors.html#REGEXP_PARSING for details.`),cs(`${Yr}
-	Failed parsing: < ${n.toString()} >
-	Using the @chevrotain/regexp-to-ast library
-	Please open an issue at: https://github.com/chevrotain/chevrotain/issues`+r)}}return[]}function us(n,e,t){switch(n.type){case"Disjunction":for(let i=0;i<n.value.length;i++)us(n.value[i],e,t);break;case"Alternative":const r=n.value;for(let i=0;i<r.length;i++){const s=r[i];switch(s.type){case"EndAnchor":case"GroupBackReference":case"Lookahead":case"NegativeLookahead":case"StartAnchor":case"WordBoundary":case"NonWordBoundary":continue}const a=s;switch(a.type){case"Character":Tr(a.value,e,t);break;case"Set":if(a.complement===!0)throw Error(rc);C(a.value,l=>{if(typeof l=="number")Tr(l,e,t);else{const c=l;if(t===!0)for(let u=c.from;u<=c.to;u++)Tr(u,e,t);else{for(let u=c.from;u<=c.to&&u<Bn;u++)Tr(u,e,t);if(c.to>=Bn){const u=c.from>=Bn?c.from:Bn,d=c.to,h=et(u),f=et(d);for(let m=h;m<=f;m++)e[m]=m}}}});break;case"Group":us(a.value,e,t);break;default:throw Error("Non Exhaustive Match")}const o=a.quantifier!==void 0&&a.quantifier.atLeast===0;if(a.type==="Group"&&ds(a)===!1||a.type!=="Group"&&o===!1)break}break;default:throw Error("non exhaustive match!")}return z(e)}function Tr(n,e,t){const r=et(n);e[r]=r,t===!0&&wf(n,e)}function wf(n,e){const t=String.fromCharCode(n),r=t.toUpperCase();if(r!==t){const i=et(r.charCodeAt(0));e[i]=i}else{const i=t.toLowerCase();if(i!==t){const s=et(i.charCodeAt(0));e[s]=s}}}function Ia(n,e){return Jt(n.value,t=>{if(typeof t=="number")return de(e,t);{const r=t;return Jt(e,i=>r.from<=i&&i<=r.to)!==void 0}})}function ds(n){const e=n.quantifier;return e&&e.atLeast===0?!0:n.value?te(n.value)?Oe(n.value,ds):ds(n.value):!1}class _f extends yi{constructor(e){super(),this.targetCharCodes=e,this.found=!1}visitChildren(e){if(this.found!==!0){switch(e.type){case"Lookahead":this.visitLookahead(e);return;case"NegativeLookahead":this.visitNegativeLookahead(e);return}super.visitChildren(e)}}visitCharacter(e){de(this.targetCharCodes,e.value)&&(this.found=!0)}visitSet(e){e.complement?Ia(e,this.targetCharCodes)===void 0&&(this.found=!0):Ia(e,this.targetCharCodes)!==void 0&&(this.found=!0)}}function Zs(n,e){if(e instanceof RegExp){const t=vi(e),r=new _f(n);return r.visit(t),r.found}else return Jt(e,t=>de(n,t.charCodeAt(0)))!==void 0}const Rt="PATTERN",Un="defaultMode",Rr="modes";let ic=typeof new RegExp("(?:)").sticky=="boolean";function Lf(n,e){e=Vs(e,{useSticky:ic,debug:!1,safeMode:!1,positionTracking:"full",lineTerminatorCharacters:["\r",`
-`],tracer:(E,R)=>R()});const t=e.tracer;t("initCharCodeToOptimizedIndexMap",()=>{th()});let r;t("Reject Lexer.NA",()=>{r=pi(n,E=>E[Rt]===fe.NA)});let i=!1,s;t("Transform Patterns",()=>{i=!1,s=$(r,E=>{const R=E[Rt];if(Xe(R)){const I=R.source;return I.length===1&&I!=="^"&&I!=="$"&&I!=="."&&!R.ignoreCase?I:I.length===2&&I[0]==="\\"&&!de(["d","D","s","S","t","r","n","t","0","c","b","B","f","v","w","W"],I[1])?I[1]:e.useSticky?Na(R):Ca(R)}else{if(Et(R))return i=!0,{exec:R};if(typeof R=="object")return i=!0,R;if(typeof R=="string"){if(R.length===1)return R;{const I=R.replace(/[\\^$.*+?()[\]{}|]/g,"\\$&"),F=new RegExp(I);return e.useSticky?Na(F):Ca(F)}}else throw Error("non exhaustive match")}})});let a,o,l,c,u;t("misc mapping",()=>{a=$(r,E=>E.tokenTypeIdx),o=$(r,E=>{const R=E.GROUP;if(R!==fe.SKIPPED){if(he(R))return R;if(Ye(R))return!1;throw Error("non exhaustive match")}}),l=$(r,E=>{const R=E.LONGER_ALT;if(R)return te(R)?$(R,F=>Ra(r,F)):[Ra(r,R)]}),c=$(r,E=>E.PUSH_MODE),u=$(r,E=>N(E,"POP_MODE"))});let d;t("Line Terminator Handling",()=>{const E=oc(e.lineTerminatorCharacters);d=$(r,R=>!1),e.positionTracking!=="onlyOffset"&&(d=$(r,R=>N(R,"LINE_BREAKS")?!!R.LINE_BREAKS:ac(R,E)===!1&&Zs(E,R.PATTERN)))});let h,f,m,g;t("Misc Mapping #2",()=>{h=$(r,sc),f=$(s,Qf),m=le(r,(E,R)=>{const I=R.GROUP;return he(I)&&I!==fe.SKIPPED&&(E[I]=[]),E},{}),g=$(s,(E,R)=>({pattern:s[R],longerAlt:l[R],canLineTerminator:d[R],isCustom:h[R],short:f[R],group:o[R],push:c[R],pop:u[R],tokenTypeIdx:a[R],tokenType:r[R]}))});let A=!0,T=[];return e.safeMode||t("First Char Optimization",()=>{T=le(r,(E,R,I)=>{if(typeof R.PATTERN=="string"){const F=R.PATTERN.charCodeAt(0),ie=et(F);Fi(E,ie,g[I])}else if(te(R.START_CHARS_HINT)){let F;C(R.START_CHARS_HINT,ie=>{const _e=typeof ie=="string"?ie.charCodeAt(0):ie,ye=et(_e);F!==ye&&(F=ye,Fi(E,ye,g[I]))})}else if(Xe(R.PATTERN))if(R.PATTERN.unicode)A=!1,e.ensureOptimizations&&cs(`${Yr}	Unable to analyze < ${R.PATTERN.toString()} > pattern.
-	The regexp unicode flag is not currently supported by the regexp-to-ast library.
-	This will disable the lexer's first char optimizations.
-	For details See: https://chevrotain.io/docs/guide/resolving_lexer_errors.html#UNICODE_OPTIMIZE`);else{const F=Nf(R.PATTERN,e.ensureOptimizations);D(F)&&(A=!1),C(F,ie=>{Fi(E,ie,g[I])})}else e.ensureOptimizations&&cs(`${Yr}	TokenType: <${R.name}> is using a custom token pattern without providing <start_chars_hint> parameter.
-	This will disable the lexer's first char optimizations.
-	For details See: https://chevrotain.io/docs/guide/resolving_lexer_errors.html#CUSTOM_OPTIMIZE`),A=!1;return E},[])}),{emptyGroups:m,patternIdxToConfig:g,charCodeToPatternIdxToConfig:T,hasCustom:i,canBeOptimized:A}}function bf(n,e){let t=[];const r=Pf(n);t=t.concat(r.errors);const i=Mf(r.valid),s=i.valid;return t=t.concat(i.errors),t=t.concat(Of(s)),t=t.concat(Wf(s)),t=t.concat(jf(s,e)),t=t.concat(Hf(s)),t}function Of(n){let e=[];const t=$e(n,r=>Xe(r[Rt]));return e=e.concat(Ff(t)),e=e.concat(Bf(t)),e=e.concat(Vf(t)),e=e.concat(Kf(t)),e=e.concat(Gf(t)),e}function Pf(n){const e=$e(n,i=>!N(i,Rt)),t=$(e,i=>({message:"Token Type: ->"+i.name+"<- missing static 'PATTERN' property",type:j.MISSING_PATTERN,tokenTypes:[i]})),r=hi(n,e);return{errors:t,valid:r}}function Mf(n){const e=$e(n,i=>{const s=i[Rt];return!Xe(s)&&!Et(s)&&!N(s,"exec")&&!he(s)}),t=$(e,i=>({message:"Token Type: ->"+i.name+"<- static 'PATTERN' can only be a RegExp, a Function matching the {CustomPatternMatcherFunc} type or an Object matching the {ICustomPattern} interface.",type:j.INVALID_PATTERN,tokenTypes:[i]})),r=hi(n,e);return{errors:t,valid:r}}const Df=/[^\\][$]/;function Ff(n){class e extends yi{constructor(){super(...arguments),this.found=!1}visitEndAnchor(s){this.found=!0}}const t=$e(n,i=>{const s=i.PATTERN;try{const a=vi(s),o=new e;return o.visit(a),o.found}catch{return Df.test(s.source)}});return $(t,i=>({message:`Unexpected RegExp Anchor Error:
-	Token Type: ->`+i.name+`<- static 'PATTERN' cannot contain end of input anchor '$'
-	See chevrotain.io/docs/guide/resolving_lexer_errors.html#ANCHORS	for details.`,type:j.EOI_ANCHOR_FOUND,tokenTypes:[i]}))}function Gf(n){const e=$e(n,r=>r.PATTERN.test(""));return $(e,r=>({message:"Token Type: ->"+r.name+"<- static 'PATTERN' must not match an empty string",type:j.EMPTY_MATCH_PATTERN,tokenTypes:[r]}))}const Uf=/[^\\[][\^]|^\^/;function Bf(n){class e extends yi{constructor(){super(...arguments),this.found=!1}visitStartAnchor(s){this.found=!0}}const t=$e(n,i=>{const s=i.PATTERN;try{const a=vi(s),o=new e;return o.visit(a),o.found}catch{return Uf.test(s.source)}});return $(t,i=>({message:`Unexpected RegExp Anchor Error:
-	Token Type: ->`+i.name+`<- static 'PATTERN' cannot contain start of input anchor '^'
-	See https://chevrotain.io/docs/guide/resolving_lexer_errors.html#ANCHORS	for details.`,type:j.SOI_ANCHOR_FOUND,tokenTypes:[i]}))}function Vf(n){const e=$e(n,r=>{const i=r[Rt];return i instanceof RegExp&&(i.multiline||i.global)});return $(e,r=>({message:"Token Type: ->"+r.name+"<- static 'PATTERN' may NOT contain global('g') or multiline('m')",type:j.UNSUPPORTED_FLAGS_FOUND,tokenTypes:[r]}))}function Kf(n){const e=[];let t=$(n,s=>le(n,(a,o)=>(s.PATTERN.source===o.PATTERN.source&&!de(e,o)&&o.PATTERN!==fe.NA&&(e.push(o),a.push(o)),a),[]));t=Zn(t);const r=$e(t,s=>s.length>1);return $(r,s=>{const a=$(s,l=>l.name);return{message:`The same RegExp pattern ->${Pe(s).PATTERN}<-has been used in all of the following Token Types: ${a.join(", ")} <-`,type:j.DUPLICATE_PATTERNS_FOUND,tokenTypes:s}})}function Wf(n){const e=$e(n,r=>{if(!N(r,"GROUP"))return!1;const i=r.GROUP;return i!==fe.SKIPPED&&i!==fe.NA&&!he(i)});return $(e,r=>({message:"Token Type: ->"+r.name+"<- static 'GROUP' can only be Lexer.SKIPPED/Lexer.NA/A String",type:j.INVALID_GROUP_TYPE_FOUND,tokenTypes:[r]}))}function jf(n,e){const t=$e(n,i=>i.PUSH_MODE!==void 0&&!de(e,i.PUSH_MODE));return $(t,i=>({message:`Token Type: ->${i.name}<- static 'PUSH_MODE' value cannot refer to a Lexer Mode ->${i.PUSH_MODE}<-which does not exist`,type:j.PUSH_MODE_DOES_NOT_EXIST,tokenTypes:[i]}))}function Hf(n){const e=[],t=le(n,(r,i,s)=>{const a=i.PATTERN;return a===fe.NA||(he(a)?r.push({str:a,idx:s,tokenType:i}):Xe(a)&&qf(a)&&r.push({str:a.source,idx:s,tokenType:i})),r},[]);return C(n,(r,i)=>{C(t,({str:s,idx:a,tokenType:o})=>{if(i<a&&zf(s,r.PATTERN)){const l=`Token: ->${o.name}<- can never be matched.
-Because it appears AFTER the Token Type ->${r.name}<-in the lexer's definition.
-See https://chevrotain.io/docs/guide/resolving_lexer_errors.html#UNREACHABLE`;e.push({message:l,type:j.UNREACHABLE_PATTERN,tokenTypes:[r,o]})}})}),e}function zf(n,e){if(Xe(e)){const t=e.exec(n);return t!==null&&t.index===0}else{if(Et(e))return e(n,0,[],{});if(N(e,"exec"))return e.exec(n,0,[],{});if(typeof e=="string")return e===n;throw Error("non exhaustive match")}}function qf(n){return Jt([".","\\","[","]","|","^","$","(",")","?","*","+","{"],t=>n.source.indexOf(t)!==-1)===void 0}function Ca(n){const e=n.ignoreCase?"i":"";return new RegExp(`^(?:${n.source})`,e)}function Na(n){const e=n.ignoreCase?"iy":"y";return new RegExp(`${n.source}`,e)}function Yf(n,e,t){const r=[];return N(n,Un)||r.push({message:"A MultiMode Lexer cannot be initialized without a <"+Un+`> property in its definition
-`,type:j.MULTI_MODE_LEXER_WITHOUT_DEFAULT_MODE}),N(n,Rr)||r.push({message:"A MultiMode Lexer cannot be initialized without a <"+Rr+`> property in its definition
-`,type:j.MULTI_MODE_LEXER_WITHOUT_MODES_PROPERTY}),N(n,Rr)&&N(n,Un)&&!N(n.modes,n.defaultMode)&&r.push({message:`A MultiMode Lexer cannot be initialized with a ${Un}: <${n.defaultMode}>which does not exist
-`,type:j.MULTI_MODE_LEXER_DEFAULT_MODE_VALUE_DOES_NOT_EXIST}),N(n,Rr)&&C(n.modes,(i,s)=>{C(i,(a,o)=>{if(Ye(a))r.push({message:`A Lexer cannot be initialized using an undefined Token Type. Mode:<${s}> at index: <${o}>
-`,type:j.LEXER_DEFINITION_CANNOT_CONTAIN_UNDEFINED});else if(N(a,"LONGER_ALT")){const l=te(a.LONGER_ALT)?a.LONGER_ALT:[a.LONGER_ALT];C(l,c=>{!Ye(c)&&!de(i,c)&&r.push({message:`A MultiMode Lexer cannot be initialized with a longer_alt <${c.name}> on token <${a.name}> outside of mode <${s}>
-`,type:j.MULTI_MODE_LEXER_LONGER_ALT_NOT_IN_CURRENT_MODE})})}})}),r}function Xf(n,e,t){const r=[];let i=!1;const s=Zn(Ne(z(n.modes))),a=pi(s,l=>l[Rt]===fe.NA),o=oc(t);return e&&C(a,l=>{const c=ac(l,o);if(c!==!1){const d={message:eh(l,c),type:c.issue,tokenType:l};r.push(d)}else N(l,"LINE_BREAKS")?l.LINE_BREAKS===!0&&(i=!0):Zs(o,l.PATTERN)&&(i=!0)}),e&&!i&&r.push({message:`Warning: No LINE_BREAKS Found.
-	This Lexer has been defined to track line and column information,
-	But none of the Token Types can be identified as matching a line terminator.
-	See https://chevrotain.io/docs/guide/resolving_lexer_errors.html#LINE_BREAKS 
-	for details.`,type:j.NO_LINE_BREAKS_FLAGS}),r}function Jf(n){const e={},t=Xt(n);return C(t,r=>{const i=n[r];if(te(i))e[r]=[];else throw Error("non exhaustive match")}),e}function sc(n){const e=n.PATTERN;if(Xe(e))return!1;if(Et(e))return!0;if(N(e,"exec"))return!0;if(he(e))return!1;throw Error("non exhaustive match")}function Qf(n){return he(n)&&n.length===1?n.charCodeAt(0):!1}const Zf={test:function(n){const e=n.length;for(let t=this.lastIndex;t<e;t++){const r=n.charCodeAt(t);if(r===10)return this.lastIndex=t+1,!0;if(r===13)return n.charCodeAt(t+1)===10?this.lastIndex=t+2:this.lastIndex=t+1,!0}return!1},lastIndex:0};function ac(n,e){if(N(n,"LINE_BREAKS"))return!1;if(Xe(n.PATTERN)){try{Zs(e,n.PATTERN)}catch(t){return{issue:j.IDENTIFY_TERMINATOR,errMsg:t.message}}return!1}else{if(he(n.PATTERN))return!1;if(sc(n))return{issue:j.CUSTOM_LINE_BREAK};throw Error("non exhaustive match")}}function eh(n,e){if(e.issue===j.IDENTIFY_TERMINATOR)return`Warning: unable to identify line terminator usage in pattern.
-	The problem is in the <${n.name}> Token Type
-	 Root cause: ${e.errMsg}.
-	For details See: https://chevrotain.io/docs/guide/resolving_lexer_errors.html#IDENTIFY_TERMINATOR`;if(e.issue===j.CUSTOM_LINE_BREAK)return`Warning: A Custom Token Pattern should specify the <line_breaks> option.
-	The problem is in the <${n.name}> Token Type
-	For details See: https://chevrotain.io/docs/guide/resolving_lexer_errors.html#CUSTOM_LINE_BREAK`;throw Error("non exhaustive match")}function oc(n){return $(n,t=>he(t)?t.charCodeAt(0):t)}function Fi(n,e,t){n[e]===void 0?n[e]=[t]:n[e].push(t)}const Bn=256;let br=[];function et(n){return n<Bn?n:br[n]}function th(){if(D(br)){br=new Array(65536);for(let n=0;n<65536;n++)br[n]=n>255?255+~~(n/255):n}}function rr(n,e){const t=n.tokenTypeIdx;return t===e.tokenTypeIdx?!0:e.isParent===!0&&e.categoryMatchesMap[t]===!0}function Xr(n,e){return n.tokenTypeIdx===e.tokenTypeIdx}let wa=1;const lc={};function ir(n){const e=nh(n);rh(e),sh(e),ih(e),C(e,t=>{t.isParent=t.categoryMatches.length>0})}function nh(n){let e=re(n),t=n,r=!0;for(;r;){t=Zn(Ne($(t,s=>s.CATEGORIES)));const i=hi(t,e);e=e.concat(i),D(i)?r=!1:t=i}return e}function rh(n){C(n,e=>{uc(e)||(lc[wa]=e,e.tokenTypeIdx=wa++),_a(e)&&!te(e.CATEGORIES)&&(e.CATEGORIES=[e.CATEGORIES]),_a(e)||(e.CATEGORIES=[]),ah(e)||(e.categoryMatches=[]),oh(e)||(e.categoryMatchesMap={})})}function ih(n){C(n,e=>{e.categoryMatches=[],C(e.categoryMatchesMap,(t,r)=>{e.categoryMatches.push(lc[r].tokenTypeIdx)})})}function sh(n){C(n,e=>{cc([],e)})}function cc(n,e){C(n,t=>{e.categoryMatchesMap[t.tokenTypeIdx]=!0}),C(e.CATEGORIES,t=>{const r=n.concat(e);de(r,t)||cc(r,t)})}function uc(n){return N(n,"tokenTypeIdx")}function _a(n){return N(n,"CATEGORIES")}function ah(n){return N(n,"categoryMatches")}function oh(n){return N(n,"categoryMatchesMap")}function lh(n){return N(n,"tokenTypeIdx")}const fs={buildUnableToPopLexerModeMessage(n){return`Unable to pop Lexer Mode after encountering Token ->${n.image}<- The Mode Stack is empty`},buildUnexpectedCharactersMessage(n,e,t,r,i){return`unexpected character: ->${n.charAt(e)}<- at offset: ${e}, skipped ${t} characters.`}};var j;(function(n){n[n.MISSING_PATTERN=0]="MISSING_PATTERN",n[n.INVALID_PATTERN=1]="INVALID_PATTERN",n[n.EOI_ANCHOR_FOUND=2]="EOI_ANCHOR_FOUND",n[n.UNSUPPORTED_FLAGS_FOUND=3]="UNSUPPORTED_FLAGS_FOUND",n[n.DUPLICATE_PATTERNS_FOUND=4]="DUPLICATE_PATTERNS_FOUND",n[n.INVALID_GROUP_TYPE_FOUND=5]="INVALID_GROUP_TYPE_FOUND",n[n.PUSH_MODE_DOES_NOT_EXIST=6]="PUSH_MODE_DOES_NOT_EXIST",n[n.MULTI_MODE_LEXER_WITHOUT_DEFAULT_MODE=7]="MULTI_MODE_LEXER_WITHOUT_DEFAULT_MODE",n[n.MULTI_MODE_LEXER_WITHOUT_MODES_PROPERTY=8]="MULTI_MODE_LEXER_WITHOUT_MODES_PROPERTY",n[n.MULTI_MODE_LEXER_DEFAULT_MODE_VALUE_DOES_NOT_EXIST=9]="MULTI_MODE_LEXER_DEFAULT_MODE_VALUE_DOES_NOT_EXIST",n[n.LEXER_DEFINITION_CANNOT_CONTAIN_UNDEFINED=10]="LEXER_DEFINITION_CANNOT_CONTAIN_UNDEFINED",n[n.SOI_ANCHOR_FOUND=11]="SOI_ANCHOR_FOUND",n[n.EMPTY_MATCH_PATTERN=12]="EMPTY_MATCH_PATTERN",n[n.NO_LINE_BREAKS_FLAGS=13]="NO_LINE_BREAKS_FLAGS",n[n.UNREACHABLE_PATTERN=14]="UNREACHABLE_PATTERN",n[n.IDENTIFY_TERMINATOR=15]="IDENTIFY_TERMINATOR",n[n.CUSTOM_LINE_BREAK=16]="CUSTOM_LINE_BREAK",n[n.MULTI_MODE_LEXER_LONGER_ALT_NOT_IN_CURRENT_MODE=17]="MULTI_MODE_LEXER_LONGER_ALT_NOT_IN_CURRENT_MODE"})(j||(j={}));const Vn={deferDefinitionErrorsHandling:!1,positionTracking:"full",lineTerminatorsPattern:/\n|\r\n?/g,lineTerminatorCharacters:[`
-`,"\r"],ensureOptimizations:!1,safeMode:!1,errorMessageProvider:fs,traceInitPerf:!1,skipValidations:!1,recoveryEnabled:!0};Object.freeze(Vn);class fe{constructor(e,t=Vn){if(this.lexerDefinition=e,this.lexerDefinitionErrors=[],this.lexerDefinitionWarning=[],this.patternIdxToConfig={},this.charCodeToPatternIdxToConfig={},this.modes=[],this.emptyGroups={},this.trackStartLines=!0,this.trackEndLines=!0,this.hasCustom=!1,this.canModeBeOptimized={},this.TRACE_INIT=(i,s)=>{if(this.traceInitPerf===!0){this.traceInitIndent++;const a=new Array(this.traceInitIndent+1).join("	");this.traceInitIndent<this.traceInitMaxIdent&&console.log(`${a}--> <${i}>`);const{time:o,value:l}=ec(s),c=o>10?console.warn:console.log;return this.traceInitIndent<this.traceInitMaxIdent&&c(`${a}<-- <${i}> time: ${o}ms`),this.traceInitIndent--,l}else return s()},typeof t=="boolean")throw Error(`The second argument to the Lexer constructor is now an ILexerConfig Object.
-a boolean 2nd argument is no longer supported`);this.config=ke({},Vn,t);const r=this.config.traceInitPerf;r===!0?(this.traceInitMaxIdent=1/0,this.traceInitPerf=!0):typeof r=="number"&&(this.traceInitMaxIdent=r,this.traceInitPerf=!0),this.traceInitIndent=-1,this.TRACE_INIT("Lexer Constructor",()=>{let i,s=!0;this.TRACE_INIT("Lexer Config handling",()=>{if(this.config.lineTerminatorsPattern===Vn.lineTerminatorsPattern)this.config.lineTerminatorsPattern=Zf;else if(this.config.lineTerminatorCharacters===Vn.lineTerminatorCharacters)throw Error(`Error: Missing <lineTerminatorCharacters> property on the Lexer config.
-	For details See: https://chevrotain.io/docs/guide/resolving_lexer_errors.html#MISSING_LINE_TERM_CHARS`);if(t.safeMode&&t.ensureOptimizations)throw Error('"safeMode" and "ensureOptimizations" flags are mutually exclusive.');this.trackStartLines=/full|onlyStart/i.test(this.config.positionTracking),this.trackEndLines=/full/i.test(this.config.positionTracking),te(e)?i={modes:{defaultMode:re(e)},defaultMode:Un}:(s=!1,i=re(e))}),this.config.skipValidations===!1&&(this.TRACE_INIT("performRuntimeChecks",()=>{this.lexerDefinitionErrors=this.lexerDefinitionErrors.concat(Yf(i,this.trackStartLines,this.config.lineTerminatorCharacters))}),this.TRACE_INIT("performWarningRuntimeChecks",()=>{this.lexerDefinitionWarning=this.lexerDefinitionWarning.concat(Xf(i,this.trackStartLines,this.config.lineTerminatorCharacters))})),i.modes=i.modes?i.modes:{},C(i.modes,(o,l)=>{i.modes[l]=pi(o,c=>Ye(c))});const a=Xt(i.modes);if(C(i.modes,(o,l)=>{this.TRACE_INIT(`Mode: <${l}> processing`,()=>{if(this.modes.push(l),this.config.skipValidations===!1&&this.TRACE_INIT("validatePatterns",()=>{this.lexerDefinitionErrors=this.lexerDefinitionErrors.concat(bf(o,a))}),D(this.lexerDefinitionErrors)){ir(o);let c;this.TRACE_INIT("analyzeTokenTypes",()=>{c=Lf(o,{lineTerminatorCharacters:this.config.lineTerminatorCharacters,positionTracking:t.positionTracking,ensureOptimizations:t.ensureOptimizations,safeMode:t.safeMode,tracer:this.TRACE_INIT})}),this.patternIdxToConfig[l]=c.patternIdxToConfig,this.charCodeToPatternIdxToConfig[l]=c.charCodeToPatternIdxToConfig,this.emptyGroups=ke({},this.emptyGroups,c.emptyGroups),this.hasCustom=c.hasCustom||this.hasCustom,this.canModeBeOptimized[l]=c.canBeOptimized}})}),this.defaultMode=i.defaultMode,!D(this.lexerDefinitionErrors)&&!this.config.deferDefinitionErrorsHandling){const l=$(this.lexerDefinitionErrors,c=>c.message).join(`-----------------------
-`);throw new Error(`Errors detected in definition of Lexer:
-`+l)}C(this.lexerDefinitionWarning,o=>{Zl(o.message)}),this.TRACE_INIT("Choosing sub-methods implementations",()=>{if(ic?(this.chopInput=Ta,this.match=this.matchWithTest):(this.updateLastIndex=Y,this.match=this.matchWithExec),s&&(this.handleModes=Y),this.trackStartLines===!1&&(this.computeNewColumn=Ta),this.trackEndLines===!1&&(this.updateTokenEndLineColumnLocation=Y),/full/i.test(this.config.positionTracking))this.createTokenInstance=this.createFullToken;else if(/onlyStart/i.test(this.config.positionTracking))this.createTokenInstance=this.createStartOnlyToken;else if(/onlyOffset/i.test(this.config.positionTracking))this.createTokenInstance=this.createOffsetOnlyToken;else throw Error(`Invalid <positionTracking> config option: "${this.config.positionTracking}"`);this.hasCustom?(this.addToken=this.addTokenUsingPush,this.handlePayload=this.handlePayloadWithCustom):(this.addToken=this.addTokenUsingMemberAccess,this.handlePayload=this.handlePayloadNoCustom)}),this.TRACE_INIT("Failed Optimization Warnings",()=>{const o=le(this.canModeBeOptimized,(l,c,u)=>(c===!1&&l.push(u),l),[]);if(t.ensureOptimizations&&!D(o))throw Error(`Lexer Modes: < ${o.join(", ")} > cannot be optimized.
-	 Disable the "ensureOptimizations" lexer config flag to silently ignore this and run the lexer in an un-optimized mode.
-	 Or inspect the console log for details on how to resolve these issues.`)}),this.TRACE_INIT("clearRegExpParserCache",()=>{Cf()}),this.TRACE_INIT("toFastProperties",()=>{tc(this)})})}tokenize(e,t=this.defaultMode){if(!D(this.lexerDefinitionErrors)){const i=$(this.lexerDefinitionErrors,s=>s.message).join(`-----------------------
-`);throw new Error(`Unable to Tokenize because Errors detected in definition of Lexer:
-`+i)}return this.tokenizeInternal(e,t)}tokenizeInternal(e,t){let r,i,s,a,o,l,c,u,d,h,f,m,g,A,T;const E=e,R=E.length;let I=0,F=0;const ie=this.hasCustom?0:Math.floor(e.length/10),_e=new Array(ie),ye=[];let Fe=this.trackStartLines?1:void 0,Ie=this.trackStartLines?1:void 0;const k=Jf(this.emptyGroups),y=this.trackStartLines,S=this.config.lineTerminatorsPattern;let x=0,b=[],L=[];const _=[],Te=[];Object.freeze(Te);let q;function K(){return b}function ut(se){const Ce=et(se),It=L[Ce];return It===void 0?Te:It}const Nu=se=>{if(_.length===1&&se.tokenType.PUSH_MODE===void 0){const Ce=this.config.errorMessageProvider.buildUnableToPopLexerModeMessage(se);ye.push({offset:se.startOffset,line:se.startLine,column:se.startColumn,length:se.image.length,message:Ce})}else{_.pop();const Ce=Qt(_);b=this.patternIdxToConfig[Ce],L=this.charCodeToPatternIdxToConfig[Ce],x=b.length;const It=this.canModeBeOptimized[Ce]&&this.config.safeMode===!1;L&&It?q=ut:q=K}};function ha(se){_.push(se),L=this.charCodeToPatternIdxToConfig[se],b=this.patternIdxToConfig[se],x=b.length,x=b.length;const Ce=this.canModeBeOptimized[se]&&this.config.safeMode===!1;L&&Ce?q=ut:q=K}ha.call(this,t);let Le;const pa=this.config.recoveryEnabled;for(;I<R;){l=null;const se=E.charCodeAt(I),Ce=q(se),It=Ce.length;for(r=0;r<It;r++){Le=Ce[r];const Re=Le.pattern;c=null;const Ve=Le.short;if(Ve!==!1?se===Ve&&(l=Re):Le.isCustom===!0?(T=Re.exec(E,I,_e,k),T!==null?(l=T[0],T.payload!==void 0&&(c=T.payload)):l=null):(this.updateLastIndex(Re,I),l=this.match(Re,e,I)),l!==null){if(o=Le.longerAlt,o!==void 0){const Qe=o.length;for(s=0;s<Qe;s++){const Ke=b[o[s]],dt=Ke.pattern;if(u=null,Ke.isCustom===!0?(T=dt.exec(E,I,_e,k),T!==null?(a=T[0],T.payload!==void 0&&(u=T.payload)):a=null):(this.updateLastIndex(dt,I),a=this.match(dt,e,I)),a&&a.length>l.length){l=a,c=u,Le=Ke;break}}}break}}if(l!==null){if(d=l.length,h=Le.group,h!==void 0&&(f=Le.tokenTypeIdx,m=this.createTokenInstance(l,I,f,Le.tokenType,Fe,Ie,d),this.handlePayload(m,c),h===!1?F=this.addToken(_e,F,m):k[h].push(m)),e=this.chopInput(e,d),I=I+d,Ie=this.computeNewColumn(Ie,d),y===!0&&Le.canLineTerminator===!0){let Re=0,Ve,Qe;S.lastIndex=0;do Ve=S.test(l),Ve===!0&&(Qe=S.lastIndex-1,Re++);while(Ve===!0);Re!==0&&(Fe=Fe+Re,Ie=d-Qe,this.updateTokenEndLineColumnLocation(m,h,Qe,Re,Fe,Ie,d))}this.handleModes(Le,Nu,ha,m)}else{const Re=I,Ve=Fe,Qe=Ie;let Ke=pa===!1;for(;Ke===!1&&I<R;)for(e=this.chopInput(e,1),I++,i=0;i<x;i++){const dt=b[i],Ni=dt.pattern,ma=dt.short;if(ma!==!1?E.charCodeAt(I)===ma&&(Ke=!0):dt.isCustom===!0?Ke=Ni.exec(E,I,_e,k)!==null:(this.updateLastIndex(Ni,I),Ke=Ni.exec(e)!==null),Ke===!0)break}if(g=I-Re,Ie=this.computeNewColumn(Ie,g),A=this.config.errorMessageProvider.buildUnexpectedCharactersMessage(E,Re,g,Ve,Qe),ye.push({offset:Re,line:Ve,column:Qe,length:g,message:A}),pa===!1)break}}return this.hasCustom||(_e.length=F),{tokens:_e,groups:k,errors:ye}}handleModes(e,t,r,i){if(e.pop===!0){const s=e.push;t(i),s!==void 0&&r.call(this,s)}else e.push!==void 0&&r.call(this,e.push)}chopInput(e,t){return e.substring(t)}updateLastIndex(e,t){e.lastIndex=t}updateTokenEndLineColumnLocation(e,t,r,i,s,a,o){let l,c;t!==void 0&&(l=r===o-1,c=l?-1:0,i===1&&l===!0||(e.endLine=s+c,e.endColumn=a-1+-c))}computeNewColumn(e,t){return e+t}createOffsetOnlyToken(e,t,r,i){return{image:e,startOffset:t,tokenTypeIdx:r,tokenType:i}}createStartOnlyToken(e,t,r,i,s,a){return{image:e,startOffset:t,startLine:s,startColumn:a,tokenTypeIdx:r,tokenType:i}}createFullToken(e,t,r,i,s,a,o){return{image:e,startOffset:t,endOffset:t+o-1,startLine:s,endLine:s,startColumn:a,endColumn:a+o-1,tokenTypeIdx:r,tokenType:i}}addTokenUsingPush(e,t,r){return e.push(r),t}addTokenUsingMemberAccess(e,t,r){return e[t]=r,t++,t}handlePayloadNoCustom(e,t){}handlePayloadWithCustom(e,t){t!==null&&(e.payload=t)}matchWithTest(e,t,r){return e.test(t)===!0?t.substring(r,e.lastIndex):null}matchWithExec(e,t){const r=e.exec(t);return r!==null?r[0]:null}}fe.SKIPPED="This marks a skipped Token pattern, this means each token identified by it willbe consumed and then thrown into oblivion, this can be used to for example to completely ignore whitespace.";fe.NA=/NOT_APPLICABLE/;function Lt(n){return dc(n)?n.LABEL:n.name}function dc(n){return he(n.LABEL)&&n.LABEL!==""}const ch="parent",La="categories",ba="label",Oa="group",Pa="push_mode",Ma="pop_mode",Da="longer_alt",Fa="line_breaks",Ga="start_chars_hint";function fc(n){return uh(n)}function uh(n){const e=n.pattern,t={};if(t.name=n.name,Ye(e)||(t.PATTERN=e),N(n,ch))throw`The parent property is no longer supported.
-See: https://github.com/chevrotain/chevrotain/issues/564#issuecomment-349062346 for details.`;return N(n,La)&&(t.CATEGORIES=n[La]),ir([t]),N(n,ba)&&(t.LABEL=n[ba]),N(n,Oa)&&(t.GROUP=n[Oa]),N(n,Ma)&&(t.POP_MODE=n[Ma]),N(n,Pa)&&(t.PUSH_MODE=n[Pa]),N(n,Da)&&(t.LONGER_ALT=n[Da]),N(n,Fa)&&(t.LINE_BREAKS=n[Fa]),N(n,Ga)&&(t.START_CHARS_HINT=n[Ga]),t}const tt=fc({name:"EOF",pattern:fe.NA});ir([tt]);function ea(n,e,t,r,i,s,a,o){return{image:e,startOffset:t,endOffset:r,startLine:i,endLine:s,startColumn:a,endColumn:o,tokenTypeIdx:n.tokenTypeIdx,tokenType:n}}function hc(n,e){return rr(n,e)}const wt={buildMismatchTokenMessage({expected:n,actual:e,previous:t,ruleName:r}){return`Expecting ${dc(n)?`--> ${Lt(n)} <--`:`token of type --> ${n.name} <--`} but found --> '${e.image}' <--`},buildNotAllInputParsedMessage({firstRedundant:n,ruleName:e}){return"Redundant input, expecting EOF but found: "+n.image},buildNoViableAltMessage({expectedPathsPerAlt:n,actual:e,previous:t,customUserDescription:r,ruleName:i}){const s="Expecting: ",o=`
-but found: '`+Pe(e).image+"'";if(r)return s+r+o;{const l=le(n,(h,f)=>h.concat(f),[]),c=$(l,h=>`[${$(h,f=>Lt(f)).join(", ")}]`),d=`one of these possible Token sequences:
-${$(c,(h,f)=>`  ${f+1}. ${h}`).join(`
-`)}`;return s+d+o}},buildEarlyExitMessage({expectedIterationPaths:n,actual:e,customUserDescription:t,ruleName:r}){const i="Expecting: ",a=`
-but found: '`+Pe(e).image+"'";if(t)return i+t+a;{const l=`expecting at least one iteration which starts with one of these possible Token sequences::
-  <${$(n,c=>`[${$(c,u=>Lt(u)).join(",")}]`).join(" ,")}>`;return i+l+a}}};Object.freeze(wt);const dh={buildRuleNotFoundError(n,e){return"Invalid grammar, reference to a rule which is not defined: ->"+e.nonTerminalName+`<-
-inside top level rule: ->`+n.name+"<-"}},mt={buildDuplicateFoundError(n,e){function t(u){return u instanceof G?u.terminalType.name:u instanceof ce?u.nonTerminalName:""}const r=n.name,i=Pe(e),s=i.idx,a=Ge(i),o=t(i),l=s>0;let c=`->${a}${l?s:""}<- ${o?`with argument: ->${o}<-`:""}
-                  appears more than once (${e.length} times) in the top level rule: ->${r}<-.                  
-                  For further details see: https://chevrotain.io/docs/FAQ.html#NUMERICAL_SUFFIXES 
-                  `;return c=c.replace(/[ \t]+/g," "),c=c.replace(/\s\s+/g,`
-`),c},buildNamespaceConflictError(n){return`Namespace conflict found in grammar.
-The grammar has both a Terminal(Token) and a Non-Terminal(Rule) named: <${n.name}>.
-To resolve this make sure each Terminal and Non-Terminal names are unique
-This is easy to accomplish by using the convention that Terminal names start with an uppercase letter
-and Non-Terminal names start with a lower case letter.`},buildAlternationPrefixAmbiguityError(n){const e=$(n.prefixPath,i=>Lt(i)).join(", "),t=n.alternation.idx===0?"":n.alternation.idx;return`Ambiguous alternatives: <${n.ambiguityIndices.join(" ,")}> due to common lookahead prefix
-in <OR${t}> inside <${n.topLevelRule.name}> Rule,
-<${e}> may appears as a prefix path in all these alternatives.
-See: https://chevrotain.io/docs/guide/resolving_grammar_errors.html#COMMON_PREFIX
-For Further details.`},buildAlternationAmbiguityError(n){const e=$(n.prefixPath,i=>Lt(i)).join(", "),t=n.alternation.idx===0?"":n.alternation.idx;let r=`Ambiguous Alternatives Detected: <${n.ambiguityIndices.join(" ,")}> in <OR${t}> inside <${n.topLevelRule.name}> Rule,
-<${e}> may appears as a prefix path in all these alternatives.
-`;return r=r+`See: https://chevrotain.io/docs/guide/resolving_grammar_errors.html#AMBIGUOUS_ALTERNATIVES
-For Further details.`,r},buildEmptyRepetitionError(n){let e=Ge(n.repetition);return n.repetition.idx!==0&&(e+=n.repetition.idx),`The repetition <${e}> within Rule <${n.topLevelRule.name}> can never consume any tokens.
-This could lead to an infinite loop.`},buildTokenNameError(n){return"deprecated"},buildEmptyAlternationError(n){return`Ambiguous empty alternative: <${n.emptyChoiceIdx+1}> in <OR${n.alternation.idx}> inside <${n.topLevelRule.name}> Rule.
-Only the last alternative may be an empty alternative.`},buildTooManyAlternativesError(n){return`An Alternation cannot have more than 256 alternatives:
-<OR${n.alternation.idx}> inside <${n.topLevelRule.name}> Rule.
- has ${n.alternation.definition.length+1} alternatives.`},buildLeftRecursionError(n){const e=n.topLevelRule.name,t=$(n.leftRecursionPath,s=>s.name),r=`${e} --> ${t.concat([e]).join(" --> ")}`;return`Left Recursion found in grammar.
-rule: <${e}> can be invoked from itself (directly or indirectly)
-without consuming any Tokens. The grammar path that causes this is: 
- ${r}
- To fix this refactor your grammar to remove the left recursion.
-see: https://en.wikipedia.org/wiki/LL_parser#Left_factoring.`},buildInvalidRuleNameError(n){return"deprecated"},buildDuplicateRuleNameError(n){let e;return n.topLevelRule instanceof an?e=n.topLevelRule.name:e=n.topLevelRule,`Duplicate definition, rule: ->${e}<- is already defined in the grammar: ->${n.grammarName}<-`}};function fh(n,e){const t=new hh(n,e);return t.resolveRefs(),t.errors}class hh extends on{constructor(e,t){super(),this.nameToTopRule=e,this.errMsgProvider=t,this.errors=[]}resolveRefs(){C(z(this.nameToTopRule),e=>{this.currTopLevel=e,e.accept(this)})}visitNonTerminal(e){const t=this.nameToTopRule[e.nonTerminalName];if(t)e.referencedRule=t;else{const r=this.errMsgProvider.buildRuleNotFoundError(this.currTopLevel,e);this.errors.push({message:r,type:ue.UNRESOLVED_SUBRULE_REF,ruleName:this.currTopLevel.name,unresolvedRefName:e.nonTerminalName})}}}class ph extends Ri{constructor(e,t){super(),this.topProd=e,this.path=t,this.possibleTokTypes=[],this.nextProductionName="",this.nextProductionOccurrence=0,this.found=!1,this.isAtEndOfPath=!1}startWalking(){if(this.found=!1,this.path.ruleStack[0]!==this.topProd.name)throw Error("The path does not start with the walker's top Rule!");return this.ruleStack=re(this.path.ruleStack).reverse(),this.occurrenceStack=re(this.path.occurrenceStack).reverse(),this.ruleStack.pop(),this.occurrenceStack.pop(),this.updateExpectedNext(),this.walk(this.topProd),this.possibleTokTypes}walk(e,t=[]){this.found||super.walk(e,t)}walkProdRef(e,t,r){if(e.referencedRule.name===this.nextProductionName&&e.idx===this.nextProductionOccurrence){const i=t.concat(r);this.updateExpectedNext(),this.walk(e.referencedRule,i)}}updateExpectedNext(){D(this.ruleStack)?(this.nextProductionName="",this.nextProductionOccurrence=0,this.isAtEndOfPath=!0):(this.nextProductionName=this.ruleStack.pop(),this.nextProductionOccurrence=this.occurrenceStack.pop())}}class mh extends ph{constructor(e,t){super(e,t),this.path=t,this.nextTerminalName="",this.nextTerminalOccurrence=0,this.nextTerminalName=this.path.lastTok.name,this.nextTerminalOccurrence=this.path.lastTokOccurrence}walkTerminal(e,t,r){if(this.isAtEndOfPath&&e.terminalType.name===this.nextTerminalName&&e.idx===this.nextTerminalOccurrence&&!this.found){const i=t.concat(r),s=new pe({definition:i});this.possibleTokTypes=nr(s),this.found=!0}}}class Ai extends Ri{constructor(e,t){super(),this.topRule=e,this.occurrence=t,this.result={token:void 0,occurrence:void 0,isEndOfRule:void 0}}startWalking(){return this.walk(this.topRule),this.result}}class gh extends Ai{walkMany(e,t,r){if(e.idx===this.occurrence){const i=Pe(t.concat(r));this.result.isEndOfRule=i===void 0,i instanceof G&&(this.result.token=i.terminalType,this.result.occurrence=i.idx)}else super.walkMany(e,t,r)}}class Ua extends Ai{walkManySep(e,t,r){if(e.idx===this.occurrence){const i=Pe(t.concat(r));this.result.isEndOfRule=i===void 0,i instanceof G&&(this.result.token=i.terminalType,this.result.occurrence=i.idx)}else super.walkManySep(e,t,r)}}class yh extends Ai{walkAtLeastOne(e,t,r){if(e.idx===this.occurrence){const i=Pe(t.concat(r));this.result.isEndOfRule=i===void 0,i instanceof G&&(this.result.token=i.terminalType,this.result.occurrence=i.idx)}else super.walkAtLeastOne(e,t,r)}}class Ba extends Ai{walkAtLeastOneSep(e,t,r){if(e.idx===this.occurrence){const i=Pe(t.concat(r));this.result.isEndOfRule=i===void 0,i instanceof G&&(this.result.token=i.terminalType,this.result.occurrence=i.idx)}else super.walkAtLeastOneSep(e,t,r)}}function hs(n,e,t=[]){t=re(t);let r=[],i=0;function s(o){return o.concat(Q(n,i+1))}function a(o){const l=hs(s(o),e,t);return r.concat(l)}for(;t.length<e&&i<n.length;){const o=n[i];if(o instanceof pe)return a(o.definition);if(o instanceof ce)return a(o.definition);if(o instanceof ne)r=a(o.definition);else if(o instanceof xe){const l=o.definition.concat([new W({definition:o.definition})]);return a(l)}else if(o instanceof Se){const l=[new pe({definition:o.definition}),new W({definition:[new G({terminalType:o.separator})].concat(o.definition)})];return a(l)}else if(o instanceof me){const l=o.definition.concat([new W({definition:[new G({terminalType:o.separator})].concat(o.definition)})]);r=a(l)}else if(o instanceof W){const l=o.definition.concat([new W({definition:o.definition})]);r=a(l)}else{if(o instanceof ge)return C(o.definition,l=>{D(l.definition)===!1&&(r=a(l.definition))}),r;if(o instanceof G)t.push(o.terminalType);else throw Error("non exhaustive match")}i++}return r.push({partialPath:t,suffixDef:Q(n,i)}),r}function pc(n,e,t,r){const i="EXIT_NONE_TERMINAL",s=[i],a="EXIT_ALTERNATIVE";let o=!1;const l=e.length,c=l-r-1,u=[],d=[];for(d.push({idx:-1,def:n,ruleStack:[],occurrenceStack:[]});!D(d);){const h=d.pop();if(h===a){o&&Qt(d).idx<=c&&d.pop();continue}const f=h.def,m=h.idx,g=h.ruleStack,A=h.occurrenceStack;if(D(f))continue;const T=f[0];if(T===i){const E={idx:m,def:Q(f),ruleStack:Yn(g),occurrenceStack:Yn(A)};d.push(E)}else if(T instanceof G)if(m<l-1){const E=m+1,R=e[E];if(t(R,T.terminalType)){const I={idx:E,def:Q(f),ruleStack:g,occurrenceStack:A};d.push(I)}}else if(m===l-1)u.push({nextTokenType:T.terminalType,nextTokenOccurrence:T.idx,ruleStack:g,occurrenceStack:A}),o=!0;else throw Error("non exhaustive match");else if(T instanceof ce){const E=re(g);E.push(T.nonTerminalName);const R=re(A);R.push(T.idx);const I={idx:m,def:T.definition.concat(s,Q(f)),ruleStack:E,occurrenceStack:R};d.push(I)}else if(T instanceof ne){const E={idx:m,def:Q(f),ruleStack:g,occurrenceStack:A};d.push(E),d.push(a);const R={idx:m,def:T.definition.concat(Q(f)),ruleStack:g,occurrenceStack:A};d.push(R)}else if(T instanceof xe){const E=new W({definition:T.definition,idx:T.idx}),R=T.definition.concat([E],Q(f)),I={idx:m,def:R,ruleStack:g,occurrenceStack:A};d.push(I)}else if(T instanceof Se){const E=new G({terminalType:T.separator}),R=new W({definition:[E].concat(T.definition),idx:T.idx}),I=T.definition.concat([R],Q(f)),F={idx:m,def:I,ruleStack:g,occurrenceStack:A};d.push(F)}else if(T instanceof me){const E={idx:m,def:Q(f),ruleStack:g,occurrenceStack:A};d.push(E),d.push(a);const R=new G({terminalType:T.separator}),I=new W({definition:[R].concat(T.definition),idx:T.idx}),F=T.definition.concat([I],Q(f)),ie={idx:m,def:F,ruleStack:g,occurrenceStack:A};d.push(ie)}else if(T instanceof W){const E={idx:m,def:Q(f),ruleStack:g,occurrenceStack:A};d.push(E),d.push(a);const R=new W({definition:T.definition,idx:T.idx}),I=T.definition.concat([R],Q(f)),F={idx:m,def:I,ruleStack:g,occurrenceStack:A};d.push(F)}else if(T instanceof ge)for(let E=T.definition.length-1;E>=0;E--){const R=T.definition[E],I={idx:m,def:R.definition.concat(Q(f)),ruleStack:g,occurrenceStack:A};d.push(I),d.push(a)}else if(T instanceof pe)d.push({idx:m,def:T.definition.concat(Q(f)),ruleStack:g,occurrenceStack:A});else if(T instanceof an)d.push(Th(T,m,g,A));else throw Error("non exhaustive match")}return u}function Th(n,e,t,r){const i=re(t);i.push(n.name);const s=re(r);return s.push(1),{idx:e,def:n.definition,ruleStack:i,occurrenceStack:s}}var B;(function(n){n[n.OPTION=0]="OPTION",n[n.REPETITION=1]="REPETITION",n[n.REPETITION_MANDATORY=2]="REPETITION_MANDATORY",n[n.REPETITION_MANDATORY_WITH_SEPARATOR=3]="REPETITION_MANDATORY_WITH_SEPARATOR",n[n.REPETITION_WITH_SEPARATOR=4]="REPETITION_WITH_SEPARATOR",n[n.ALTERNATION=5]="ALTERNATION"})(B||(B={}));function ta(n){if(n instanceof ne||n==="Option")return B.OPTION;if(n instanceof W||n==="Repetition")return B.REPETITION;if(n instanceof xe||n==="RepetitionMandatory")return B.REPETITION_MANDATORY;if(n instanceof Se||n==="RepetitionMandatoryWithSeparator")return B.REPETITION_MANDATORY_WITH_SEPARATOR;if(n instanceof me||n==="RepetitionWithSeparator")return B.REPETITION_WITH_SEPARATOR;if(n instanceof ge||n==="Alternation")return B.ALTERNATION;throw Error("non exhaustive match")}function Va(n){const{occurrence:e,rule:t,prodType:r,maxLookahead:i}=n,s=ta(r);return s===B.ALTERNATION?Ei(e,t,i):ki(e,t,s,i)}function Rh(n,e,t,r,i,s){const a=Ei(n,e,t),o=yc(a)?Xr:rr;return s(a,r,o,i)}function vh(n,e,t,r,i,s){const a=ki(n,e,i,t),o=yc(a)?Xr:rr;return s(a[0],o,r)}function Ah(n,e,t,r){const i=n.length,s=Oe(n,a=>Oe(a,o=>o.length===1));if(e)return function(a){const o=$(a,l=>l.GATE);for(let l=0;l<i;l++){const c=n[l],u=c.length,d=o[l];if(!(d!==void 0&&d.call(this)===!1))e:for(let h=0;h<u;h++){const f=c[h],m=f.length;for(let g=0;g<m;g++){const A=this.LA(g+1);if(t(A,f[g])===!1)continue e}return l}}};if(s&&!r){const a=$(n,l=>Ne(l)),o=le(a,(l,c,u)=>(C(c,d=>{N(l,d.tokenTypeIdx)||(l[d.tokenTypeIdx]=u),C(d.categoryMatches,h=>{N(l,h)||(l[h]=u)})}),l),{});return function(){const l=this.LA(1);return o[l.tokenTypeIdx]}}else return function(){for(let a=0;a<i;a++){const o=n[a],l=o.length;e:for(let c=0;c<l;c++){const u=o[c],d=u.length;for(let h=0;h<d;h++){const f=this.LA(h+1);if(t(f,u[h])===!1)continue e}return a}}}}function Eh(n,e,t){const r=Oe(n,s=>s.length===1),i=n.length;if(r&&!t){const s=Ne(n);if(s.length===1&&D(s[0].categoryMatches)){const o=s[0].tokenTypeIdx;return function(){return this.LA(1).tokenTypeIdx===o}}else{const a=le(s,(o,l,c)=>(o[l.tokenTypeIdx]=!0,C(l.categoryMatches,u=>{o[u]=!0}),o),[]);return function(){const o=this.LA(1);return a[o.tokenTypeIdx]===!0}}}else return function(){e:for(let s=0;s<i;s++){const a=n[s],o=a.length;for(let l=0;l<o;l++){const c=this.LA(l+1);if(e(c,a[l])===!1)continue e}return!0}return!1}}class kh extends Ri{constructor(e,t,r){super(),this.topProd=e,this.targetOccurrence=t,this.targetProdType=r}startWalking(){return this.walk(this.topProd),this.restDef}checkIsTarget(e,t,r,i){return e.idx===this.targetOccurrence&&this.targetProdType===t?(this.restDef=r.concat(i),!0):!1}walkOption(e,t,r){this.checkIsTarget(e,B.OPTION,t,r)||super.walkOption(e,t,r)}walkAtLeastOne(e,t,r){this.checkIsTarget(e,B.REPETITION_MANDATORY,t,r)||super.walkOption(e,t,r)}walkAtLeastOneSep(e,t,r){this.checkIsTarget(e,B.REPETITION_MANDATORY_WITH_SEPARATOR,t,r)||super.walkOption(e,t,r)}walkMany(e,t,r){this.checkIsTarget(e,B.REPETITION,t,r)||super.walkOption(e,t,r)}walkManySep(e,t,r){this.checkIsTarget(e,B.REPETITION_WITH_SEPARATOR,t,r)||super.walkOption(e,t,r)}}class mc extends on{constructor(e,t,r){super(),this.targetOccurrence=e,this.targetProdType=t,this.targetRef=r,this.result=[]}checkIsTarget(e,t){e.idx===this.targetOccurrence&&this.targetProdType===t&&(this.targetRef===void 0||e===this.targetRef)&&(this.result=e.definition)}visitOption(e){this.checkIsTarget(e,B.OPTION)}visitRepetition(e){this.checkIsTarget(e,B.REPETITION)}visitRepetitionMandatory(e){this.checkIsTarget(e,B.REPETITION_MANDATORY)}visitRepetitionMandatoryWithSeparator(e){this.checkIsTarget(e,B.REPETITION_MANDATORY_WITH_SEPARATOR)}visitRepetitionWithSeparator(e){this.checkIsTarget(e,B.REPETITION_WITH_SEPARATOR)}visitAlternation(e){this.checkIsTarget(e,B.ALTERNATION)}}function Ka(n){const e=new Array(n);for(let t=0;t<n;t++)e[t]=[];return e}function Gi(n){let e=[""];for(let t=0;t<n.length;t++){const r=n[t],i=[];for(let s=0;s<e.length;s++){const a=e[s];i.push(a+"_"+r.tokenTypeIdx);for(let o=0;o<r.categoryMatches.length;o++){const l="_"+r.categoryMatches[o];i.push(a+l)}}e=i}return e}function $h(n,e,t){for(let r=0;r<n.length;r++){if(r===t)continue;const i=n[r];for(let s=0;s<e.length;s++){const a=e[s];if(i[a]===!0)return!1}}return!0}function gc(n,e){const t=$(n,a=>hs([a],1)),r=Ka(t.length),i=$(t,a=>{const o={};return C(a,l=>{const c=Gi(l.partialPath);C(c,u=>{o[u]=!0})}),o});let s=t;for(let a=1;a<=e;a++){const o=s;s=Ka(o.length);for(let l=0;l<o.length;l++){const c=o[l];for(let u=0;u<c.length;u++){const d=c[u].partialPath,h=c[u].suffixDef,f=Gi(d);if($h(i,f,l)||D(h)||d.length===e){const g=r[l];if(ps(g,d)===!1){g.push(d);for(let A=0;A<f.length;A++){const T=f[A];i[l][T]=!0}}}else{const g=hs(h,a+1,d);s[l]=s[l].concat(g),C(g,A=>{const T=Gi(A.partialPath);C(T,E=>{i[l][E]=!0})})}}}}return r}function Ei(n,e,t,r){const i=new mc(n,B.ALTERNATION,r);return e.accept(i),gc(i.result,t)}function ki(n,e,t,r){const i=new mc(n,t);e.accept(i);const s=i.result,o=new kh(e,n,t).startWalking(),l=new pe({definition:s}),c=new pe({definition:o});return gc([l,c],r)}function ps(n,e){e:for(let t=0;t<n.length;t++){const r=n[t];if(r.length===e.length){for(let i=0;i<r.length;i++){const s=e[i],a=r[i];if((s===a||a.categoryMatchesMap[s.tokenTypeIdx]!==void 0)===!1)continue e}return!0}}return!1}function xh(n,e){return n.length<e.length&&Oe(n,(t,r)=>{const i=e[r];return t===i||i.categoryMatchesMap[t.tokenTypeIdx]})}function yc(n){return Oe(n,e=>Oe(e,t=>Oe(t,r=>D(r.categoryMatches))))}function Sh(n){const e=n.lookaheadStrategy.validate({rules:n.rules,tokenTypes:n.tokenTypes,grammarName:n.grammarName});return $(e,t=>Object.assign({type:ue.CUSTOM_LOOKAHEAD_VALIDATION},t))}function Ih(n,e,t,r){const i=Ee(n,l=>Ch(l,t)),s=Uh(n,e,t),a=Ee(n,l=>Mh(l,t)),o=Ee(n,l=>_h(l,n,r,t));return i.concat(s,a,o)}function Ch(n,e){const t=new wh;n.accept(t);const r=t.allProductions,i=sd(r,Nh),s=Me(i,o=>o.length>1);return $(z(s),o=>{const l=Pe(o),c=e.buildDuplicateFoundError(n,o),u=Ge(l),d={message:c,type:ue.DUPLICATE_PRODUCTIONS,ruleName:n.name,dslName:u,occurrence:l.idx},h=Tc(l);return h&&(d.parameter=h),d})}function Nh(n){return`${Ge(n)}_#_${n.idx}_#_${Tc(n)}`}function Tc(n){return n instanceof G?n.terminalType.name:n instanceof ce?n.nonTerminalName:""}class wh extends on{constructor(){super(...arguments),this.allProductions=[]}visitNonTerminal(e){this.allProductions.push(e)}visitOption(e){this.allProductions.push(e)}visitRepetitionWithSeparator(e){this.allProductions.push(e)}visitRepetitionMandatory(e){this.allProductions.push(e)}visitRepetitionMandatoryWithSeparator(e){this.allProductions.push(e)}visitRepetition(e){this.allProductions.push(e)}visitAlternation(e){this.allProductions.push(e)}visitTerminal(e){this.allProductions.push(e)}}function _h(n,e,t,r){const i=[];if(le(e,(a,o)=>o.name===n.name?a+1:a,0)>1){const a=r.buildDuplicateRuleNameError({topLevelRule:n,grammarName:t});i.push({message:a,type:ue.DUPLICATE_RULE_NAME,ruleName:n.name})}return i}function Lh(n,e,t){const r=[];let i;return de(e,n)||(i=`Invalid rule override, rule: ->${n}<- cannot be overridden in the grammar: ->${t}<-as it is not defined in any of the super grammars `,r.push({message:i,type:ue.INVALID_RULE_OVERRIDE,ruleName:n})),r}function Rc(n,e,t,r=[]){const i=[],s=Or(e.definition);if(D(s))return[];{const a=n.name;de(s,n)&&i.push({message:t.buildLeftRecursionError({topLevelRule:n,leftRecursionPath:r}),type:ue.LEFT_RECURSION,ruleName:a});const l=hi(s,r.concat([n])),c=Ee(l,u=>{const d=re(r);return d.push(u),Rc(n,u,t,d)});return i.concat(c)}}function Or(n){let e=[];if(D(n))return e;const t=Pe(n);if(t instanceof ce)e.push(t.referencedRule);else if(t instanceof pe||t instanceof ne||t instanceof xe||t instanceof Se||t instanceof me||t instanceof W)e=e.concat(Or(t.definition));else if(t instanceof ge)e=Ne($(t.definition,s=>Or(s.definition)));else if(!(t instanceof G))throw Error("non exhaustive match");const r=qr(t),i=n.length>1;if(r&&i){const s=Q(n);return e.concat(Or(s))}else return e}class na extends on{constructor(){super(...arguments),this.alternations=[]}visitAlternation(e){this.alternations.push(e)}}function bh(n,e){const t=new na;n.accept(t);const r=t.alternations;return Ee(r,s=>{const a=Yn(s.definition);return Ee(a,(o,l)=>{const c=pc([o],[],rr,1);return D(c)?[{message:e.buildEmptyAlternationError({topLevelRule:n,alternation:s,emptyChoiceIdx:l}),type:ue.NONE_LAST_EMPTY_ALT,ruleName:n.name,occurrence:s.idx,alternative:l+1}]:[]})})}function Oh(n,e,t){const r=new na;n.accept(r);let i=r.alternations;return i=pi(i,a=>a.ignoreAmbiguities===!0),Ee(i,a=>{const o=a.idx,l=a.maxLookahead||e,c=Ei(o,n,l,a),u=Fh(c,a,n,t),d=Gh(c,a,n,t);return u.concat(d)})}class Ph extends on{constructor(){super(...arguments),this.allProductions=[]}visitRepetitionWithSeparator(e){this.allProductions.push(e)}visitRepetitionMandatory(e){this.allProductions.push(e)}visitRepetitionMandatoryWithSeparator(e){this.allProductions.push(e)}visitRepetition(e){this.allProductions.push(e)}}function Mh(n,e){const t=new na;n.accept(t);const r=t.alternations;return Ee(r,s=>s.definition.length>255?[{message:e.buildTooManyAlternativesError({topLevelRule:n,alternation:s}),type:ue.TOO_MANY_ALTS,ruleName:n.name,occurrence:s.idx}]:[])}function Dh(n,e,t){const r=[];return C(n,i=>{const s=new Ph;i.accept(s);const a=s.allProductions;C(a,o=>{const l=ta(o),c=o.maxLookahead||e,u=o.idx,h=ki(u,i,l,c)[0];if(D(Ne(h))){const f=t.buildEmptyRepetitionError({topLevelRule:i,repetition:o});r.push({message:f,type:ue.NO_NON_EMPTY_LOOKAHEAD,ruleName:i.name})}})}),r}function Fh(n,e,t,r){const i=[],s=le(n,(o,l,c)=>(e.definition[c].ignoreAmbiguities===!0||C(l,u=>{const d=[c];C(n,(h,f)=>{c!==f&&ps(h,u)&&e.definition[f].ignoreAmbiguities!==!0&&d.push(f)}),d.length>1&&!ps(i,u)&&(i.push(u),o.push({alts:d,path:u}))}),o),[]);return $(s,o=>{const l=$(o.alts,u=>u+1);return{message:r.buildAlternationAmbiguityError({topLevelRule:t,alternation:e,ambiguityIndices:l,prefixPath:o.path}),type:ue.AMBIGUOUS_ALTS,ruleName:t.name,occurrence:e.idx,alternatives:o.alts}})}function Gh(n,e,t,r){const i=le(n,(a,o,l)=>{const c=$(o,u=>({idx:l,path:u}));return a.concat(c)},[]);return Zn(Ee(i,a=>{if(e.definition[a.idx].ignoreAmbiguities===!0)return[];const l=a.idx,c=a.path,u=$e(i,h=>e.definition[h.idx].ignoreAmbiguities!==!0&&h.idx<l&&xh(h.path,c));return $(u,h=>{const f=[h.idx+1,l+1],m=e.idx===0?"":e.idx;return{message:r.buildAlternationPrefixAmbiguityError({topLevelRule:t,alternation:e,ambiguityIndices:f,prefixPath:h.path}),type:ue.AMBIGUOUS_PREFIX_ALTS,ruleName:t.name,occurrence:m,alternatives:f}})}))}function Uh(n,e,t){const r=[],i=$(e,s=>s.name);return C(n,s=>{const a=s.name;if(de(i,a)){const o=t.buildNamespaceConflictError(s);r.push({message:o,type:ue.CONFLICT_TOKENS_RULES_NAMESPACE,ruleName:a})}}),r}function Bh(n){const e=Vs(n,{errMsgProvider:dh}),t={};return C(n.rules,r=>{t[r.name]=r}),fh(t,e.errMsgProvider)}function Vh(n){return n=Vs(n,{errMsgProvider:mt}),Ih(n.rules,n.tokenTypes,n.errMsgProvider,n.grammarName)}const vc="MismatchedTokenException",Ac="NoViableAltException",Ec="EarlyExitException",kc="NotAllInputParsedException",$c=[vc,Ac,Ec,kc];Object.freeze($c);function Jr(n){return de($c,n.name)}class $i extends Error{constructor(e,t){super(e),this.token=t,this.resyncedTokens=[],Object.setPrototypeOf(this,new.target.prototype),Error.captureStackTrace&&Error.captureStackTrace(this,this.constructor)}}class xc extends $i{constructor(e,t,r){super(e,t),this.previousToken=r,this.name=vc}}class Kh extends $i{constructor(e,t,r){super(e,t),this.previousToken=r,this.name=Ac}}class Wh extends $i{constructor(e,t){super(e,t),this.name=kc}}class jh extends $i{constructor(e,t,r){super(e,t),this.previousToken=r,this.name=Ec}}const Ui={},Sc="InRuleRecoveryException";class Hh extends Error{constructor(e){super(e),this.name=Sc}}class zh{initRecoverable(e){this.firstAfterRepMap={},this.resyncFollows={},this.recoveryEnabled=N(e,"recoveryEnabled")?e.recoveryEnabled:Je.recoveryEnabled,this.recoveryEnabled&&(this.attemptInRepetitionRecovery=qh)}getTokenToInsert(e){const t=ea(e,"",NaN,NaN,NaN,NaN,NaN,NaN);return t.isInsertedInRecovery=!0,t}canTokenTypeBeInsertedInRecovery(e){return!0}canTokenTypeBeDeletedInRecovery(e){return!0}tryInRepetitionRecovery(e,t,r,i){const s=this.findReSyncTokenType(),a=this.exportLexerState(),o=[];let l=!1;const c=this.LA(1);let u=this.LA(1);const d=()=>{const h=this.LA(0),f=this.errorMessageProvider.buildMismatchTokenMessage({expected:i,actual:c,previous:h,ruleName:this.getCurrRuleFullName()}),m=new xc(f,c,this.LA(0));m.resyncedTokens=Yn(o),this.SAVE_ERROR(m)};for(;!l;)if(this.tokenMatcher(u,i)){d();return}else if(r.call(this)){d(),e.apply(this,t);return}else this.tokenMatcher(u,s)?l=!0:(u=this.SKIP_TOKEN(),this.addToResyncTokens(u,o));this.importLexerState(a)}shouldInRepetitionRecoveryBeTried(e,t,r){return!(r===!1||this.tokenMatcher(this.LA(1),e)||this.isBackTracking()||this.canPerformInRuleRecovery(e,this.getFollowsForInRuleRecovery(e,t)))}getFollowsForInRuleRecovery(e,t){const r=this.getCurrentGrammarPath(e,t);return this.getNextPossibleTokenTypes(r)}tryInRuleRecovery(e,t){if(this.canRecoverWithSingleTokenInsertion(e,t))return this.getTokenToInsert(e);if(this.canRecoverWithSingleTokenDeletion(e)){const r=this.SKIP_TOKEN();return this.consumeToken(),r}throw new Hh("sad sad panda")}canPerformInRuleRecovery(e,t){return this.canRecoverWithSingleTokenInsertion(e,t)||this.canRecoverWithSingleTokenDeletion(e)}canRecoverWithSingleTokenInsertion(e,t){if(!this.canTokenTypeBeInsertedInRecovery(e)||D(t))return!1;const r=this.LA(1);return Jt(t,s=>this.tokenMatcher(r,s))!==void 0}canRecoverWithSingleTokenDeletion(e){return this.canTokenTypeBeDeletedInRecovery(e)?this.tokenMatcher(this.LA(2),e):!1}isInCurrentRuleReSyncSet(e){const t=this.getCurrFollowKey(),r=this.getFollowSetFromFollowKey(t);return de(r,e)}findReSyncTokenType(){const e=this.flattenFollowSet();let t=this.LA(1),r=2;for(;;){const i=Jt(e,s=>hc(t,s));if(i!==void 0)return i;t=this.LA(r),r++}}getCurrFollowKey(){if(this.RULE_STACK.length===1)return Ui;const e=this.getLastExplicitRuleShortName(),t=this.getLastExplicitRuleOccurrenceIndex(),r=this.getPreviousExplicitRuleShortName();return{ruleName:this.shortRuleNameToFullName(e),idxInCallingRule:t,inRule:this.shortRuleNameToFullName(r)}}buildFullFollowKeyStack(){const e=this.RULE_STACK,t=this.RULE_OCCURRENCE_STACK;return $(e,(r,i)=>i===0?Ui:{ruleName:this.shortRuleNameToFullName(r),idxInCallingRule:t[i],inRule:this.shortRuleNameToFullName(e[i-1])})}flattenFollowSet(){const e=$(this.buildFullFollowKeyStack(),t=>this.getFollowSetFromFollowKey(t));return Ne(e)}getFollowSetFromFollowKey(e){if(e===Ui)return[tt];const t=e.ruleName+e.idxInCallingRule+nc+e.inRule;return this.resyncFollows[t]}addToResyncTokens(e,t){return this.tokenMatcher(e,tt)||t.push(e),t}reSyncTo(e){const t=[];let r=this.LA(1);for(;this.tokenMatcher(r,e)===!1;)r=this.SKIP_TOKEN(),this.addToResyncTokens(r,t);return Yn(t)}attemptInRepetitionRecovery(e,t,r,i,s,a,o){}getCurrentGrammarPath(e,t){const r=this.getHumanReadableRuleStack(),i=re(this.RULE_OCCURRENCE_STACK);return{ruleStack:r,occurrenceStack:i,lastTok:e,lastTokOccurrence:t}}getHumanReadableRuleStack(){return $(this.RULE_STACK,e=>this.shortRuleNameToFullName(e))}}function qh(n,e,t,r,i,s,a){const o=this.getKeyForAutomaticLookahead(r,i);let l=this.firstAfterRepMap[o];if(l===void 0){const h=this.getCurrRuleFullName(),f=this.getGAstProductions()[h];l=new s(f,i).startWalking(),this.firstAfterRepMap[o]=l}let c=l.token,u=l.occurrence;const d=l.isEndOfRule;this.RULE_STACK.length===1&&d&&c===void 0&&(c=tt,u=1),!(c===void 0||u===void 0)&&this.shouldInRepetitionRecoveryBeTried(c,u,a)&&this.tryInRepetitionRecovery(n,e,t,c)}const Yh=4,it=8,Ic=1<<it,Cc=2<<it,ms=3<<it,gs=4<<it,ys=5<<it,Pr=6<<it;function Bi(n,e,t){return t|e|n}class ra{constructor(e){var t;this.maxLookahead=(t=e?.maxLookahead)!==null&&t!==void 0?t:Je.maxLookahead}validate(e){const t=this.validateNoLeftRecursion(e.rules);if(D(t)){const r=this.validateEmptyOrAlternatives(e.rules),i=this.validateAmbiguousAlternationAlternatives(e.rules,this.maxLookahead),s=this.validateSomeNonEmptyLookaheadPath(e.rules,this.maxLookahead);return[...t,...r,...i,...s]}return t}validateNoLeftRecursion(e){return Ee(e,t=>Rc(t,t,mt))}validateEmptyOrAlternatives(e){return Ee(e,t=>bh(t,mt))}validateAmbiguousAlternationAlternatives(e,t){return Ee(e,r=>Oh(r,t,mt))}validateSomeNonEmptyLookaheadPath(e,t){return Dh(e,t,mt)}buildLookaheadForAlternation(e){return Rh(e.prodOccurrence,e.rule,e.maxLookahead,e.hasPredicates,e.dynamicTokensEnabled,Ah)}buildLookaheadForOptional(e){return vh(e.prodOccurrence,e.rule,e.maxLookahead,e.dynamicTokensEnabled,ta(e.prodType),Eh)}}class Xh{initLooksAhead(e){this.dynamicTokensEnabled=N(e,"dynamicTokensEnabled")?e.dynamicTokensEnabled:Je.dynamicTokensEnabled,this.maxLookahead=N(e,"maxLookahead")?e.maxLookahead:Je.maxLookahead,this.lookaheadStrategy=N(e,"lookaheadStrategy")?e.lookaheadStrategy:new ra({maxLookahead:this.maxLookahead}),this.lookAheadFuncsCache=new Map}preComputeLookaheadFunctions(e){C(e,t=>{this.TRACE_INIT(`${t.name} Rule Lookahead`,()=>{const{alternation:r,repetition:i,option:s,repetitionMandatory:a,repetitionMandatoryWithSeparator:o,repetitionWithSeparator:l}=Qh(t);C(r,c=>{const u=c.idx===0?"":c.idx;this.TRACE_INIT(`${Ge(c)}${u}`,()=>{const d=this.lookaheadStrategy.buildLookaheadForAlternation({prodOccurrence:c.idx,rule:t,maxLookahead:c.maxLookahead||this.maxLookahead,hasPredicates:c.hasPredicates,dynamicTokensEnabled:this.dynamicTokensEnabled}),h=Bi(this.fullRuleNameToShort[t.name],Ic,c.idx);this.setLaFuncCache(h,d)})}),C(i,c=>{this.computeLookaheadFunc(t,c.idx,ms,"Repetition",c.maxLookahead,Ge(c))}),C(s,c=>{this.computeLookaheadFunc(t,c.idx,Cc,"Option",c.maxLookahead,Ge(c))}),C(a,c=>{this.computeLookaheadFunc(t,c.idx,gs,"RepetitionMandatory",c.maxLookahead,Ge(c))}),C(o,c=>{this.computeLookaheadFunc(t,c.idx,Pr,"RepetitionMandatoryWithSeparator",c.maxLookahead,Ge(c))}),C(l,c=>{this.computeLookaheadFunc(t,c.idx,ys,"RepetitionWithSeparator",c.maxLookahead,Ge(c))})})})}computeLookaheadFunc(e,t,r,i,s,a){this.TRACE_INIT(`${a}${t===0?"":t}`,()=>{const o=this.lookaheadStrategy.buildLookaheadForOptional({prodOccurrence:t,rule:e,maxLookahead:s||this.maxLookahead,dynamicTokensEnabled:this.dynamicTokensEnabled,prodType:i}),l=Bi(this.fullRuleNameToShort[e.name],r,t);this.setLaFuncCache(l,o)})}getKeyForAutomaticLookahead(e,t){const r=this.getLastExplicitRuleShortName();return Bi(r,e,t)}getLaFuncFromCache(e){return this.lookAheadFuncsCache.get(e)}setLaFuncCache(e,t){this.lookAheadFuncsCache.set(e,t)}}class Jh extends on{constructor(){super(...arguments),this.dslMethods={option:[],alternation:[],repetition:[],repetitionWithSeparator:[],repetitionMandatory:[],repetitionMandatoryWithSeparator:[]}}reset(){this.dslMethods={option:[],alternation:[],repetition:[],repetitionWithSeparator:[],repetitionMandatory:[],repetitionMandatoryWithSeparator:[]}}visitOption(e){this.dslMethods.option.push(e)}visitRepetitionWithSeparator(e){this.dslMethods.repetitionWithSeparator.push(e)}visitRepetitionMandatory(e){this.dslMethods.repetitionMandatory.push(e)}visitRepetitionMandatoryWithSeparator(e){this.dslMethods.repetitionMandatoryWithSeparator.push(e)}visitRepetition(e){this.dslMethods.repetition.push(e)}visitAlternation(e){this.dslMethods.alternation.push(e)}}const vr=new Jh;function Qh(n){vr.reset(),n.accept(vr);const e=vr.dslMethods;return vr.reset(),e}function Wa(n,e){isNaN(n.startOffset)===!0?(n.startOffset=e.startOffset,n.endOffset=e.endOffset):n.endOffset<e.endOffset&&(n.endOffset=e.endOffset)}function ja(n,e){isNaN(n.startOffset)===!0?(n.startOffset=e.startOffset,n.startColumn=e.startColumn,n.startLine=e.startLine,n.endOffset=e.endOffset,n.endColumn=e.endColumn,n.endLine=e.endLine):n.endOffset<e.endOffset&&(n.endOffset=e.endOffset,n.endColumn=e.endColumn,n.endLine=e.endLine)}function Zh(n,e,t){n.children[t]===void 0?n.children[t]=[e]:n.children[t].push(e)}function ep(n,e,t){n.children[e]===void 0?n.children[e]=[t]:n.children[e].push(t)}const tp="name";function Nc(n,e){Object.defineProperty(n,tp,{enumerable:!1,configurable:!0,writable:!1,value:e})}function np(n,e){const t=Xt(n),r=t.length;for(let i=0;i<r;i++){const s=t[i],a=n[s],o=a.length;for(let l=0;l<o;l++){const c=a[l];c.tokenTypeIdx===void 0&&this[c.name](c.children,e)}}}function rp(n,e){const t=function(){};Nc(t,n+"BaseSemantics");const r={visit:function(i,s){if(te(i)&&(i=i[0]),!Ye(i))return this[i.name](i.children,s)},validateVisitor:function(){const i=sp(this,e);if(!D(i)){const s=$(i,a=>a.msg);throw Error(`Errors Detected in CST Visitor <${this.constructor.name}>:
-	${s.join(`
-
-`).replace(/\n/g,`
-	`)}`)}}};return t.prototype=r,t.prototype.constructor=t,t._RULE_NAMES=e,t}function ip(n,e,t){const r=function(){};Nc(r,n+"BaseSemanticsWithDefaults");const i=Object.create(t.prototype);return C(e,s=>{i[s]=np}),r.prototype=i,r.prototype.constructor=r,r}var Ts;(function(n){n[n.REDUNDANT_METHOD=0]="REDUNDANT_METHOD",n[n.MISSING_METHOD=1]="MISSING_METHOD"})(Ts||(Ts={}));function sp(n,e){return ap(n,e)}function ap(n,e){const t=$e(e,i=>Et(n[i])===!1),r=$(t,i=>({msg:`Missing visitor method: <${i}> on ${n.constructor.name} CST Visitor.`,type:Ts.MISSING_METHOD,methodName:i}));return Zn(r)}class op{initTreeBuilder(e){if(this.CST_STACK=[],this.outputCst=e.outputCst,this.nodeLocationTracking=N(e,"nodeLocationTracking")?e.nodeLocationTracking:Je.nodeLocationTracking,!this.outputCst)this.cstInvocationStateUpdate=Y,this.cstFinallyStateUpdate=Y,this.cstPostTerminal=Y,this.cstPostNonTerminal=Y,this.cstPostRule=Y;else if(/full/i.test(this.nodeLocationTracking))this.recoveryEnabled?(this.setNodeLocationFromToken=ja,this.setNodeLocationFromNode=ja,this.cstPostRule=Y,this.setInitialNodeLocation=this.setInitialNodeLocationFullRecovery):(this.setNodeLocationFromToken=Y,this.setNodeLocationFromNode=Y,this.cstPostRule=this.cstPostRuleFull,this.setInitialNodeLocation=this.setInitialNodeLocationFullRegular);else if(/onlyOffset/i.test(this.nodeLocationTracking))this.recoveryEnabled?(this.setNodeLocationFromToken=Wa,this.setNodeLocationFromNode=Wa,this.cstPostRule=Y,this.setInitialNodeLocation=this.setInitialNodeLocationOnlyOffsetRecovery):(this.setNodeLocationFromToken=Y,this.setNodeLocationFromNode=Y,this.cstPostRule=this.cstPostRuleOnlyOffset,this.setInitialNodeLocation=this.setInitialNodeLocationOnlyOffsetRegular);else if(/none/i.test(this.nodeLocationTracking))this.setNodeLocationFromToken=Y,this.setNodeLocationFromNode=Y,this.cstPostRule=Y,this.setInitialNodeLocation=Y;else throw Error(`Invalid <nodeLocationTracking> config option: "${e.nodeLocationTracking}"`)}setInitialNodeLocationOnlyOffsetRecovery(e){e.location={startOffset:NaN,endOffset:NaN}}setInitialNodeLocationOnlyOffsetRegular(e){e.location={startOffset:this.LA(1).startOffset,endOffset:NaN}}setInitialNodeLocationFullRecovery(e){e.location={startOffset:NaN,startLine:NaN,startColumn:NaN,endOffset:NaN,endLine:NaN,endColumn:NaN}}setInitialNodeLocationFullRegular(e){const t=this.LA(1);e.location={startOffset:t.startOffset,startLine:t.startLine,startColumn:t.startColumn,endOffset:NaN,endLine:NaN,endColumn:NaN}}cstInvocationStateUpdate(e){const t={name:e,children:Object.create(null)};this.setInitialNodeLocation(t),this.CST_STACK.push(t)}cstFinallyStateUpdate(){this.CST_STACK.pop()}cstPostRuleFull(e){const t=this.LA(0),r=e.location;r.startOffset<=t.startOffset?(r.endOffset=t.endOffset,r.endLine=t.endLine,r.endColumn=t.endColumn):(r.startOffset=NaN,r.startLine=NaN,r.startColumn=NaN)}cstPostRuleOnlyOffset(e){const t=this.LA(0),r=e.location;r.startOffset<=t.startOffset?r.endOffset=t.endOffset:r.startOffset=NaN}cstPostTerminal(e,t){const r=this.CST_STACK[this.CST_STACK.length-1];Zh(r,t,e),this.setNodeLocationFromToken(r.location,t)}cstPostNonTerminal(e,t){const r=this.CST_STACK[this.CST_STACK.length-1];ep(r,t,e),this.setNodeLocationFromNode(r.location,e.location)}getBaseCstVisitorConstructor(){if(Ye(this.baseCstVisitorConstructor)){const e=rp(this.className,Xt(this.gastProductionsCache));return this.baseCstVisitorConstructor=e,e}return this.baseCstVisitorConstructor}getBaseCstVisitorConstructorWithDefaults(){if(Ye(this.baseCstVisitorWithDefaultsConstructor)){const e=ip(this.className,Xt(this.gastProductionsCache),this.getBaseCstVisitorConstructor());return this.baseCstVisitorWithDefaultsConstructor=e,e}return this.baseCstVisitorWithDefaultsConstructor}getLastExplicitRuleShortName(){const e=this.RULE_STACK;return e[e.length-1]}getPreviousExplicitRuleShortName(){const e=this.RULE_STACK;return e[e.length-2]}getLastExplicitRuleOccurrenceIndex(){const e=this.RULE_OCCURRENCE_STACK;return e[e.length-1]}}class lp{initLexerAdapter(){this.tokVector=[],this.tokVectorLength=0,this.currIdx=-1}set input(e){if(this.selfAnalysisDone!==!0)throw Error("Missing <performSelfAnalysis> invocation at the end of the Parser's constructor.");this.reset(),this.tokVector=e,this.tokVectorLength=e.length}get input(){return this.tokVector}SKIP_TOKEN(){return this.currIdx<=this.tokVector.length-2?(this.consumeToken(),this.LA(1)):Zr}LA(e){const t=this.currIdx+e;return t<0||this.tokVectorLength<=t?Zr:this.tokVector[t]}consumeToken(){this.currIdx++}exportLexerState(){return this.currIdx}importLexerState(e){this.currIdx=e}resetLexerState(){this.currIdx=-1}moveToTerminatedState(){this.currIdx=this.tokVector.length-1}getLexerPosition(){return this.exportLexerState()}}class cp{ACTION(e){return e.call(this)}consume(e,t,r){return this.consumeInternal(t,e,r)}subrule(e,t,r){return this.subruleInternal(t,e,r)}option(e,t){return this.optionInternal(t,e)}or(e,t){return this.orInternal(t,e)}many(e,t){return this.manyInternal(e,t)}atLeastOne(e,t){return this.atLeastOneInternal(e,t)}CONSUME(e,t){return this.consumeInternal(e,0,t)}CONSUME1(e,t){return this.consumeInternal(e,1,t)}CONSUME2(e,t){return this.consumeInternal(e,2,t)}CONSUME3(e,t){return this.consumeInternal(e,3,t)}CONSUME4(e,t){return this.consumeInternal(e,4,t)}CONSUME5(e,t){return this.consumeInternal(e,5,t)}CONSUME6(e,t){return this.consumeInternal(e,6,t)}CONSUME7(e,t){return this.consumeInternal(e,7,t)}CONSUME8(e,t){return this.consumeInternal(e,8,t)}CONSUME9(e,t){return this.consumeInternal(e,9,t)}SUBRULE(e,t){return this.subruleInternal(e,0,t)}SUBRULE1(e,t){return this.subruleInternal(e,1,t)}SUBRULE2(e,t){return this.subruleInternal(e,2,t)}SUBRULE3(e,t){return this.subruleInternal(e,3,t)}SUBRULE4(e,t){return this.subruleInternal(e,4,t)}SUBRULE5(e,t){return this.subruleInternal(e,5,t)}SUBRULE6(e,t){return this.subruleInternal(e,6,t)}SUBRULE7(e,t){return this.subruleInternal(e,7,t)}SUBRULE8(e,t){return this.subruleInternal(e,8,t)}SUBRULE9(e,t){return this.subruleInternal(e,9,t)}OPTION(e){return this.optionInternal(e,0)}OPTION1(e){return this.optionInternal(e,1)}OPTION2(e){return this.optionInternal(e,2)}OPTION3(e){return this.optionInternal(e,3)}OPTION4(e){return this.optionInternal(e,4)}OPTION5(e){return this.optionInternal(e,5)}OPTION6(e){return this.optionInternal(e,6)}OPTION7(e){return this.optionInternal(e,7)}OPTION8(e){return this.optionInternal(e,8)}OPTION9(e){return this.optionInternal(e,9)}OR(e){return this.orInternal(e,0)}OR1(e){return this.orInternal(e,1)}OR2(e){return this.orInternal(e,2)}OR3(e){return this.orInternal(e,3)}OR4(e){return this.orInternal(e,4)}OR5(e){return this.orInternal(e,5)}OR6(e){return this.orInternal(e,6)}OR7(e){return this.orInternal(e,7)}OR8(e){return this.orInternal(e,8)}OR9(e){return this.orInternal(e,9)}MANY(e){this.manyInternal(0,e)}MANY1(e){this.manyInternal(1,e)}MANY2(e){this.manyInternal(2,e)}MANY3(e){this.manyInternal(3,e)}MANY4(e){this.manyInternal(4,e)}MANY5(e){this.manyInternal(5,e)}MANY6(e){this.manyInternal(6,e)}MANY7(e){this.manyInternal(7,e)}MANY8(e){this.manyInternal(8,e)}MANY9(e){this.manyInternal(9,e)}MANY_SEP(e){this.manySepFirstInternal(0,e)}MANY_SEP1(e){this.manySepFirstInternal(1,e)}MANY_SEP2(e){this.manySepFirstInternal(2,e)}MANY_SEP3(e){this.manySepFirstInternal(3,e)}MANY_SEP4(e){this.manySepFirstInternal(4,e)}MANY_SEP5(e){this.manySepFirstInternal(5,e)}MANY_SEP6(e){this.manySepFirstInternal(6,e)}MANY_SEP7(e){this.manySepFirstInternal(7,e)}MANY_SEP8(e){this.manySepFirstInternal(8,e)}MANY_SEP9(e){this.manySepFirstInternal(9,e)}AT_LEAST_ONE(e){this.atLeastOneInternal(0,e)}AT_LEAST_ONE1(e){return this.atLeastOneInternal(1,e)}AT_LEAST_ONE2(e){this.atLeastOneInternal(2,e)}AT_LEAST_ONE3(e){this.atLeastOneInternal(3,e)}AT_LEAST_ONE4(e){this.atLeastOneInternal(4,e)}AT_LEAST_ONE5(e){this.atLeastOneInternal(5,e)}AT_LEAST_ONE6(e){this.atLeastOneInternal(6,e)}AT_LEAST_ONE7(e){this.atLeastOneInternal(7,e)}AT_LEAST_ONE8(e){this.atLeastOneInternal(8,e)}AT_LEAST_ONE9(e){this.atLeastOneInternal(9,e)}AT_LEAST_ONE_SEP(e){this.atLeastOneSepFirstInternal(0,e)}AT_LEAST_ONE_SEP1(e){this.atLeastOneSepFirstInternal(1,e)}AT_LEAST_ONE_SEP2(e){this.atLeastOneSepFirstInternal(2,e)}AT_LEAST_ONE_SEP3(e){this.atLeastOneSepFirstInternal(3,e)}AT_LEAST_ONE_SEP4(e){this.atLeastOneSepFirstInternal(4,e)}AT_LEAST_ONE_SEP5(e){this.atLeastOneSepFirstInternal(5,e)}AT_LEAST_ONE_SEP6(e){this.atLeastOneSepFirstInternal(6,e)}AT_LEAST_ONE_SEP7(e){this.atLeastOneSepFirstInternal(7,e)}AT_LEAST_ONE_SEP8(e){this.atLeastOneSepFirstInternal(8,e)}AT_LEAST_ONE_SEP9(e){this.atLeastOneSepFirstInternal(9,e)}RULE(e,t,r=ei){if(de(this.definedRulesNames,e)){const a={message:mt.buildDuplicateRuleNameError({topLevelRule:e,grammarName:this.className}),type:ue.DUPLICATE_RULE_NAME,ruleName:e};this.definitionErrors.push(a)}this.definedRulesNames.push(e);const i=this.defineRule(e,t,r);return this[e]=i,i}OVERRIDE_RULE(e,t,r=ei){const i=Lh(e,this.definedRulesNames,this.className);this.definitionErrors=this.definitionErrors.concat(i);const s=this.defineRule(e,t,r);return this[e]=s,s}BACKTRACK(e,t){return function(){this.isBackTrackingStack.push(1);const r=this.saveRecogState();try{return e.apply(this,t),!0}catch(i){if(Jr(i))return!1;throw i}finally{this.reloadRecogState(r),this.isBackTrackingStack.pop()}}}getGAstProductions(){return this.gastProductionsCache}getSerializedGastProductions(){return Tf(z(this.gastProductionsCache))}}class up{initRecognizerEngine(e,t){if(this.className=this.constructor.name,this.shortRuleNameToFull={},this.fullRuleNameToShort={},this.ruleShortNameIdx=256,this.tokenMatcher=Xr,this.subruleIdx=0,this.definedRulesNames=[],this.tokensMap={},this.isBackTrackingStack=[],this.RULE_STACK=[],this.RULE_OCCURRENCE_STACK=[],this.gastProductionsCache={},N(t,"serializedGrammar"))throw Error(`The Parser's configuration can no longer contain a <serializedGrammar> property.
-	See: https://chevrotain.io/docs/changes/BREAKING_CHANGES.html#_6-0-0
-	For Further details.`);if(te(e)){if(D(e))throw Error(`A Token Vocabulary cannot be empty.
-	Note that the first argument for the parser constructor
-	is no longer a Token vector (since v4.0).`);if(typeof e[0].startOffset=="number")throw Error(`The Parser constructor no longer accepts a token vector as the first argument.
-	See: https://chevrotain.io/docs/changes/BREAKING_CHANGES.html#_4-0-0
-	For Further details.`)}if(te(e))this.tokensMap=le(e,(s,a)=>(s[a.name]=a,s),{});else if(N(e,"modes")&&Oe(Ne(z(e.modes)),lh)){const s=Ne(z(e.modes)),a=Ks(s);this.tokensMap=le(a,(o,l)=>(o[l.name]=l,o),{})}else if(Du(e))this.tokensMap=re(e);else throw new Error("<tokensDictionary> argument must be An Array of Token constructors, A dictionary of Token constructors or an IMultiModeLexerDefinition");this.tokensMap.EOF=tt;const r=N(e,"modes")?Ne(z(e.modes)):z(e),i=Oe(r,s=>D(s.categoryMatches));this.tokenMatcher=i?Xr:rr,ir(z(this.tokensMap))}defineRule(e,t,r){if(this.selfAnalysisDone)throw Error(`Grammar rule <${e}> may not be defined after the 'performSelfAnalysis' method has been called'
-Make sure that all grammar rule definitions are done before 'performSelfAnalysis' is called.`);const i=N(r,"resyncEnabled")?r.resyncEnabled:ei.resyncEnabled,s=N(r,"recoveryValueFunc")?r.recoveryValueFunc:ei.recoveryValueFunc,a=this.ruleShortNameIdx<<Yh+it;this.ruleShortNameIdx++,this.shortRuleNameToFull[a]=e,this.fullRuleNameToShort[e]=a;let o;return this.outputCst===!0?o=function(...u){try{this.ruleInvocationStateUpdate(a,e,this.subruleIdx),t.apply(this,u);const d=this.CST_STACK[this.CST_STACK.length-1];return this.cstPostRule(d),d}catch(d){return this.invokeRuleCatch(d,i,s)}finally{this.ruleFinallyStateUpdate()}}:o=function(...u){try{return this.ruleInvocationStateUpdate(a,e,this.subruleIdx),t.apply(this,u)}catch(d){return this.invokeRuleCatch(d,i,s)}finally{this.ruleFinallyStateUpdate()}},Object.assign(o,{ruleName:e,originalGrammarAction:t})}invokeRuleCatch(e,t,r){const i=this.RULE_STACK.length===1,s=t&&!this.isBackTracking()&&this.recoveryEnabled;if(Jr(e)){const a=e;if(s){const o=this.findReSyncTokenType();if(this.isInCurrentRuleReSyncSet(o))if(a.resyncedTokens=this.reSyncTo(o),this.outputCst){const l=this.CST_STACK[this.CST_STACK.length-1];return l.recoveredNode=!0,l}else return r(e);else{if(this.outputCst){const l=this.CST_STACK[this.CST_STACK.length-1];l.recoveredNode=!0,a.partialCstResult=l}throw a}}else{if(i)return this.moveToTerminatedState(),r(e);throw a}}else throw e}optionInternal(e,t){const r=this.getKeyForAutomaticLookahead(Cc,t);return this.optionInternalLogic(e,t,r)}optionInternalLogic(e,t,r){let i=this.getLaFuncFromCache(r),s;if(typeof e!="function"){s=e.DEF;const a=e.GATE;if(a!==void 0){const o=i;i=()=>a.call(this)&&o.call(this)}}else s=e;if(i.call(this)===!0)return s.call(this)}atLeastOneInternal(e,t){const r=this.getKeyForAutomaticLookahead(gs,e);return this.atLeastOneInternalLogic(e,t,r)}atLeastOneInternalLogic(e,t,r){let i=this.getLaFuncFromCache(r),s;if(typeof t!="function"){s=t.DEF;const a=t.GATE;if(a!==void 0){const o=i;i=()=>a.call(this)&&o.call(this)}}else s=t;if(i.call(this)===!0){let a=this.doSingleRepetition(s);for(;i.call(this)===!0&&a===!0;)a=this.doSingleRepetition(s)}else throw this.raiseEarlyExitException(e,B.REPETITION_MANDATORY,t.ERR_MSG);this.attemptInRepetitionRecovery(this.atLeastOneInternal,[e,t],i,gs,e,yh)}atLeastOneSepFirstInternal(e,t){const r=this.getKeyForAutomaticLookahead(Pr,e);this.atLeastOneSepFirstInternalLogic(e,t,r)}atLeastOneSepFirstInternalLogic(e,t,r){const i=t.DEF,s=t.SEP;if(this.getLaFuncFromCache(r).call(this)===!0){i.call(this);const o=()=>this.tokenMatcher(this.LA(1),s);for(;this.tokenMatcher(this.LA(1),s)===!0;)this.CONSUME(s),i.call(this);this.attemptInRepetitionRecovery(this.repetitionSepSecondInternal,[e,s,o,i,Ba],o,Pr,e,Ba)}else throw this.raiseEarlyExitException(e,B.REPETITION_MANDATORY_WITH_SEPARATOR,t.ERR_MSG)}manyInternal(e,t){const r=this.getKeyForAutomaticLookahead(ms,e);return this.manyInternalLogic(e,t,r)}manyInternalLogic(e,t,r){let i=this.getLaFuncFromCache(r),s;if(typeof t!="function"){s=t.DEF;const o=t.GATE;if(o!==void 0){const l=i;i=()=>o.call(this)&&l.call(this)}}else s=t;let a=!0;for(;i.call(this)===!0&&a===!0;)a=this.doSingleRepetition(s);this.attemptInRepetitionRecovery(this.manyInternal,[e,t],i,ms,e,gh,a)}manySepFirstInternal(e,t){const r=this.getKeyForAutomaticLookahead(ys,e);this.manySepFirstInternalLogic(e,t,r)}manySepFirstInternalLogic(e,t,r){const i=t.DEF,s=t.SEP;if(this.getLaFuncFromCache(r).call(this)===!0){i.call(this);const o=()=>this.tokenMatcher(this.LA(1),s);for(;this.tokenMatcher(this.LA(1),s)===!0;)this.CONSUME(s),i.call(this);this.attemptInRepetitionRecovery(this.repetitionSepSecondInternal,[e,s,o,i,Ua],o,ys,e,Ua)}}repetitionSepSecondInternal(e,t,r,i,s){for(;r();)this.CONSUME(t),i.call(this);this.attemptInRepetitionRecovery(this.repetitionSepSecondInternal,[e,t,r,i,s],r,Pr,e,s)}doSingleRepetition(e){const t=this.getLexerPosition();return e.call(this),this.getLexerPosition()>t}orInternal(e,t){const r=this.getKeyForAutomaticLookahead(Ic,t),i=te(e)?e:e.DEF,a=this.getLaFuncFromCache(r).call(this,i);if(a!==void 0)return i[a].ALT.call(this);this.raiseNoAltException(t,e.ERR_MSG)}ruleFinallyStateUpdate(){if(this.RULE_STACK.pop(),this.RULE_OCCURRENCE_STACK.pop(),this.cstFinallyStateUpdate(),this.RULE_STACK.length===0&&this.isAtEndOfInput()===!1){const e=this.LA(1),t=this.errorMessageProvider.buildNotAllInputParsedMessage({firstRedundant:e,ruleName:this.getCurrRuleFullName()});this.SAVE_ERROR(new Wh(t,e))}}subruleInternal(e,t,r){let i;try{const s=r!==void 0?r.ARGS:void 0;return this.subruleIdx=t,i=e.apply(this,s),this.cstPostNonTerminal(i,r!==void 0&&r.LABEL!==void 0?r.LABEL:e.ruleName),i}catch(s){throw this.subruleInternalError(s,r,e.ruleName)}}subruleInternalError(e,t,r){throw Jr(e)&&e.partialCstResult!==void 0&&(this.cstPostNonTerminal(e.partialCstResult,t!==void 0&&t.LABEL!==void 0?t.LABEL:r),delete e.partialCstResult),e}consumeInternal(e,t,r){let i;try{const s=this.LA(1);this.tokenMatcher(s,e)===!0?(this.consumeToken(),i=s):this.consumeInternalError(e,s,r)}catch(s){i=this.consumeInternalRecovery(e,t,s)}return this.cstPostTerminal(r!==void 0&&r.LABEL!==void 0?r.LABEL:e.name,i),i}consumeInternalError(e,t,r){let i;const s=this.LA(0);throw r!==void 0&&r.ERR_MSG?i=r.ERR_MSG:i=this.errorMessageProvider.buildMismatchTokenMessage({expected:e,actual:t,previous:s,ruleName:this.getCurrRuleFullName()}),this.SAVE_ERROR(new xc(i,t,s))}consumeInternalRecovery(e,t,r){if(this.recoveryEnabled&&r.name==="MismatchedTokenException"&&!this.isBackTracking()){const i=this.getFollowsForInRuleRecovery(e,t);try{return this.tryInRuleRecovery(e,i)}catch(s){throw s.name===Sc?r:s}}else throw r}saveRecogState(){const e=this.errors,t=re(this.RULE_STACK);return{errors:e,lexerState:this.exportLexerState(),RULE_STACK:t,CST_STACK:this.CST_STACK}}reloadRecogState(e){this.errors=e.errors,this.importLexerState(e.lexerState),this.RULE_STACK=e.RULE_STACK}ruleInvocationStateUpdate(e,t,r){this.RULE_OCCURRENCE_STACK.push(r),this.RULE_STACK.push(e),this.cstInvocationStateUpdate(t)}isBackTracking(){return this.isBackTrackingStack.length!==0}getCurrRuleFullName(){const e=this.getLastExplicitRuleShortName();return this.shortRuleNameToFull[e]}shortRuleNameToFullName(e){return this.shortRuleNameToFull[e]}isAtEndOfInput(){return this.tokenMatcher(this.LA(1),tt)}reset(){this.resetLexerState(),this.subruleIdx=0,this.isBackTrackingStack=[],this.errors=[],this.RULE_STACK=[],this.CST_STACK=[],this.RULE_OCCURRENCE_STACK=[]}}class dp{initErrorHandler(e){this._errors=[],this.errorMessageProvider=N(e,"errorMessageProvider")?e.errorMessageProvider:Je.errorMessageProvider}SAVE_ERROR(e){if(Jr(e))return e.context={ruleStack:this.getHumanReadableRuleStack(),ruleOccurrenceStack:re(this.RULE_OCCURRENCE_STACK)},this._errors.push(e),e;throw Error("Trying to save an Error which is not a RecognitionException")}get errors(){return re(this._errors)}set errors(e){this._errors=e}raiseEarlyExitException(e,t,r){const i=this.getCurrRuleFullName(),s=this.getGAstProductions()[i],o=ki(e,s,t,this.maxLookahead)[0],l=[];for(let u=1;u<=this.maxLookahead;u++)l.push(this.LA(u));const c=this.errorMessageProvider.buildEarlyExitMessage({expectedIterationPaths:o,actual:l,previous:this.LA(0),customUserDescription:r,ruleName:i});throw this.SAVE_ERROR(new jh(c,this.LA(1),this.LA(0)))}raiseNoAltException(e,t){const r=this.getCurrRuleFullName(),i=this.getGAstProductions()[r],s=Ei(e,i,this.maxLookahead),a=[];for(let c=1;c<=this.maxLookahead;c++)a.push(this.LA(c));const o=this.LA(0),l=this.errorMessageProvider.buildNoViableAltMessage({expectedPathsPerAlt:s,actual:a,previous:o,customUserDescription:t,ruleName:this.getCurrRuleFullName()});throw this.SAVE_ERROR(new Kh(l,this.LA(1),o))}}class fp{initContentAssist(){}computeContentAssist(e,t){const r=this.gastProductionsCache[e];if(Ye(r))throw Error(`Rule ->${e}<- does not exist in this grammar.`);return pc([r],t,this.tokenMatcher,this.maxLookahead)}getNextPossibleTokenTypes(e){const t=Pe(e.ruleStack),i=this.getGAstProductions()[t];return new mh(i,e).startWalking()}}const xi={description:"This Object indicates the Parser is during Recording Phase"};Object.freeze(xi);const Ha=!0,za=Math.pow(2,it)-1,wc=fc({name:"RECORDING_PHASE_TOKEN",pattern:fe.NA});ir([wc]);const _c=ea(wc,`This IToken indicates the Parser is in Recording Phase
-	See: https://chevrotain.io/docs/guide/internals.html#grammar-recording for details`,-1,-1,-1,-1,-1,-1);Object.freeze(_c);const hp={name:`This CSTNode indicates the Parser is in Recording Phase
-	See: https://chevrotain.io/docs/guide/internals.html#grammar-recording for details`,children:{}};class pp{initGastRecorder(e){this.recordingProdStack=[],this.RECORDING_PHASE=!1}enableRecording(){this.RECORDING_PHASE=!0,this.TRACE_INIT("Enable Recording",()=>{for(let e=0;e<10;e++){const t=e>0?e:"";this[`CONSUME${t}`]=function(r,i){return this.consumeInternalRecord(r,e,i)},this[`SUBRULE${t}`]=function(r,i){return this.subruleInternalRecord(r,e,i)},this[`OPTION${t}`]=function(r){return this.optionInternalRecord(r,e)},this[`OR${t}`]=function(r){return this.orInternalRecord(r,e)},this[`MANY${t}`]=function(r){this.manyInternalRecord(e,r)},this[`MANY_SEP${t}`]=function(r){this.manySepFirstInternalRecord(e,r)},this[`AT_LEAST_ONE${t}`]=function(r){this.atLeastOneInternalRecord(e,r)},this[`AT_LEAST_ONE_SEP${t}`]=function(r){this.atLeastOneSepFirstInternalRecord(e,r)}}this.consume=function(e,t,r){return this.consumeInternalRecord(t,e,r)},this.subrule=function(e,t,r){return this.subruleInternalRecord(t,e,r)},this.option=function(e,t){return this.optionInternalRecord(t,e)},this.or=function(e,t){return this.orInternalRecord(t,e)},this.many=function(e,t){this.manyInternalRecord(e,t)},this.atLeastOne=function(e,t){this.atLeastOneInternalRecord(e,t)},this.ACTION=this.ACTION_RECORD,this.BACKTRACK=this.BACKTRACK_RECORD,this.LA=this.LA_RECORD})}disableRecording(){this.RECORDING_PHASE=!1,this.TRACE_INIT("Deleting Recording methods",()=>{const e=this;for(let t=0;t<10;t++){const r=t>0?t:"";delete e[`CONSUME${r}`],delete e[`SUBRULE${r}`],delete e[`OPTION${r}`],delete e[`OR${r}`],delete e[`MANY${r}`],delete e[`MANY_SEP${r}`],delete e[`AT_LEAST_ONE${r}`],delete e[`AT_LEAST_ONE_SEP${r}`]}delete e.consume,delete e.subrule,delete e.option,delete e.or,delete e.many,delete e.atLeastOne,delete e.ACTION,delete e.BACKTRACK,delete e.LA})}ACTION_RECORD(e){}BACKTRACK_RECORD(e,t){return()=>!0}LA_RECORD(e){return Zr}topLevelRuleRecord(e,t){try{const r=new an({definition:[],name:e});return r.name=e,this.recordingProdStack.push(r),t.call(this),this.recordingProdStack.pop(),r}catch(r){if(r.KNOWN_RECORDER_ERROR!==!0)try{r.message=r.message+`
-	 This error was thrown during the "grammar recording phase" For more info see:
-	https://chevrotain.io/docs/guide/internals.html#grammar-recording`}catch{throw r}throw r}}optionInternalRecord(e,t){return un.call(this,ne,e,t)}atLeastOneInternalRecord(e,t){un.call(this,xe,t,e)}atLeastOneSepFirstInternalRecord(e,t){un.call(this,Se,t,e,Ha)}manyInternalRecord(e,t){un.call(this,W,t,e)}manySepFirstInternalRecord(e,t){un.call(this,me,t,e,Ha)}orInternalRecord(e,t){return mp.call(this,e,t)}subruleInternalRecord(e,t,r){if(Qr(t),!e||N(e,"ruleName")===!1){const o=new Error(`<SUBRULE${qa(t)}> argument is invalid expecting a Parser method reference but got: <${JSON.stringify(e)}>
- inside top level rule: <${this.recordingProdStack[0].name}>`);throw o.KNOWN_RECORDER_ERROR=!0,o}const i=Qt(this.recordingProdStack),s=e.ruleName,a=new ce({idx:t,nonTerminalName:s,label:r?.LABEL,referencedRule:void 0});return i.definition.push(a),this.outputCst?hp:xi}consumeInternalRecord(e,t,r){if(Qr(t),!uc(e)){const a=new Error(`<CONSUME${qa(t)}> argument is invalid expecting a TokenType reference but got: <${JSON.stringify(e)}>
- inside top level rule: <${this.recordingProdStack[0].name}>`);throw a.KNOWN_RECORDER_ERROR=!0,a}const i=Qt(this.recordingProdStack),s=new G({idx:t,terminalType:e,label:r?.LABEL});return i.definition.push(s),_c}}function un(n,e,t,r=!1){Qr(t);const i=Qt(this.recordingProdStack),s=Et(e)?e:e.DEF,a=new n({definition:[],idx:t});return r&&(a.separator=e.SEP),N(e,"MAX_LOOKAHEAD")&&(a.maxLookahead=e.MAX_LOOKAHEAD),this.recordingProdStack.push(a),s.call(this),i.definition.push(a),this.recordingProdStack.pop(),xi}function mp(n,e){Qr(e);const t=Qt(this.recordingProdStack),r=te(n)===!1,i=r===!1?n:n.DEF,s=new ge({definition:[],idx:e,ignoreAmbiguities:r&&n.IGNORE_AMBIGUITIES===!0});N(n,"MAX_LOOKAHEAD")&&(s.maxLookahead=n.MAX_LOOKAHEAD);const a=Ll(i,o=>Et(o.GATE));return s.hasPredicates=a,t.definition.push(s),C(i,o=>{const l=new pe({definition:[]});s.definition.push(l),N(o,"IGNORE_AMBIGUITIES")?l.ignoreAmbiguities=o.IGNORE_AMBIGUITIES:N(o,"GATE")&&(l.ignoreAmbiguities=!0),this.recordingProdStack.push(l),o.ALT.call(this),this.recordingProdStack.pop()}),xi}function qa(n){return n===0?"":`${n}`}function Qr(n){if(n<0||n>za){const e=new Error(`Invalid DSL Method idx value: <${n}>
-	Idx value must be a none negative value smaller than ${za+1}`);throw e.KNOWN_RECORDER_ERROR=!0,e}}class gp{initPerformanceTracer(e){if(N(e,"traceInitPerf")){const t=e.traceInitPerf,r=typeof t=="number";this.traceInitMaxIdent=r?t:1/0,this.traceInitPerf=r?t>0:t}else this.traceInitMaxIdent=0,this.traceInitPerf=Je.traceInitPerf;this.traceInitIndent=-1}TRACE_INIT(e,t){if(this.traceInitPerf===!0){this.traceInitIndent++;const r=new Array(this.traceInitIndent+1).join("	");this.traceInitIndent<this.traceInitMaxIdent&&console.log(`${r}--> <${e}>`);const{time:i,value:s}=ec(t),a=i>10?console.warn:console.log;return this.traceInitIndent<this.traceInitMaxIdent&&a(`${r}<-- <${e}> time: ${i}ms`),this.traceInitIndent--,s}else return t()}}function yp(n,e){e.forEach(t=>{const r=t.prototype;Object.getOwnPropertyNames(r).forEach(i=>{if(i==="constructor")return;const s=Object.getOwnPropertyDescriptor(r,i);s&&(s.get||s.set)?Object.defineProperty(n.prototype,i,s):n.prototype[i]=t.prototype[i]})})}const Zr=ea(tt,"",NaN,NaN,NaN,NaN,NaN,NaN);Object.freeze(Zr);const Je=Object.freeze({recoveryEnabled:!1,maxLookahead:3,dynamicTokensEnabled:!1,outputCst:!0,errorMessageProvider:wt,nodeLocationTracking:"none",traceInitPerf:!1,skipValidations:!1}),ei=Object.freeze({recoveryValueFunc:()=>{},resyncEnabled:!0});var ue;(function(n){n[n.INVALID_RULE_NAME=0]="INVALID_RULE_NAME",n[n.DUPLICATE_RULE_NAME=1]="DUPLICATE_RULE_NAME",n[n.INVALID_RULE_OVERRIDE=2]="INVALID_RULE_OVERRIDE",n[n.DUPLICATE_PRODUCTIONS=3]="DUPLICATE_PRODUCTIONS",n[n.UNRESOLVED_SUBRULE_REF=4]="UNRESOLVED_SUBRULE_REF",n[n.LEFT_RECURSION=5]="LEFT_RECURSION",n[n.NONE_LAST_EMPTY_ALT=6]="NONE_LAST_EMPTY_ALT",n[n.AMBIGUOUS_ALTS=7]="AMBIGUOUS_ALTS",n[n.CONFLICT_TOKENS_RULES_NAMESPACE=8]="CONFLICT_TOKENS_RULES_NAMESPACE",n[n.INVALID_TOKEN_NAME=9]="INVALID_TOKEN_NAME",n[n.NO_NON_EMPTY_LOOKAHEAD=10]="NO_NON_EMPTY_LOOKAHEAD",n[n.AMBIGUOUS_PREFIX_ALTS=11]="AMBIGUOUS_PREFIX_ALTS",n[n.TOO_MANY_ALTS=12]="TOO_MANY_ALTS",n[n.CUSTOM_LOOKAHEAD_VALIDATION=13]="CUSTOM_LOOKAHEAD_VALIDATION"})(ue||(ue={}));function Ya(n=void 0){return function(){return n}}class sr{static performSelfAnalysis(e){throw Error("The **static** `performSelfAnalysis` method has been deprecated.	\nUse the **instance** method with the same name instead.")}performSelfAnalysis(){this.TRACE_INIT("performSelfAnalysis",()=>{let e;this.selfAnalysisDone=!0;const t=this.className;this.TRACE_INIT("toFastProps",()=>{tc(this)}),this.TRACE_INIT("Grammar Recording",()=>{try{this.enableRecording(),C(this.definedRulesNames,i=>{const a=this[i].originalGrammarAction;let o;this.TRACE_INIT(`${i} Rule`,()=>{o=this.topLevelRuleRecord(i,a)}),this.gastProductionsCache[i]=o})}finally{this.disableRecording()}});let r=[];if(this.TRACE_INIT("Grammar Resolving",()=>{r=Bh({rules:z(this.gastProductionsCache)}),this.definitionErrors=this.definitionErrors.concat(r)}),this.TRACE_INIT("Grammar Validations",()=>{if(D(r)&&this.skipValidations===!1){const i=Vh({rules:z(this.gastProductionsCache),tokenTypes:z(this.tokensMap),errMsgProvider:mt,grammarName:t}),s=Sh({lookaheadStrategy:this.lookaheadStrategy,rules:z(this.gastProductionsCache),tokenTypes:z(this.tokensMap),grammarName:t});this.definitionErrors=this.definitionErrors.concat(i,s)}}),D(this.definitionErrors)&&(this.recoveryEnabled&&this.TRACE_INIT("computeAllProdsFollows",()=>{const i=xf(z(this.gastProductionsCache));this.resyncFollows=i}),this.TRACE_INIT("ComputeLookaheadFunctions",()=>{var i,s;(s=(i=this.lookaheadStrategy).initialize)===null||s===void 0||s.call(i,{rules:z(this.gastProductionsCache)}),this.preComputeLookaheadFunctions(z(this.gastProductionsCache))})),!sr.DEFER_DEFINITION_ERRORS_HANDLING&&!D(this.definitionErrors))throw e=$(this.definitionErrors,i=>i.message),new Error(`Parser Definition Errors detected:
- ${e.join(`
--------------------------------
-`)}`)})}constructor(e,t){this.definitionErrors=[],this.selfAnalysisDone=!1;const r=this;if(r.initErrorHandler(t),r.initLexerAdapter(),r.initLooksAhead(t),r.initRecognizerEngine(e,t),r.initRecoverable(t),r.initTreeBuilder(t),r.initContentAssist(),r.initGastRecorder(t),r.initPerformanceTracer(t),N(t,"ignoredIssues"))throw new Error(`The <ignoredIssues> IParserConfig property has been deprecated.
-	Please use the <IGNORE_AMBIGUITIES> flag on the relevant DSL method instead.
-	See: https://chevrotain.io/docs/guide/resolving_grammar_errors.html#IGNORING_AMBIGUITIES
-	For further details.`);this.skipValidations=N(t,"skipValidations")?t.skipValidations:Je.skipValidations}}sr.DEFER_DEFINITION_ERRORS_HANDLING=!1;yp(sr,[zh,Xh,op,lp,up,cp,dp,fp,pp,gp]);class Tp extends sr{constructor(e,t=Je){const r=re(t);r.outputCst=!1,super(e,r)}}function Zt(n,e,t){return`${n.name}_${e}_${t}`}const nt=1,Rp=2,Lc=4,bc=5,ar=7,vp=8,Ap=9,Ep=10,kp=11,Oc=12;class ia{constructor(e){this.target=e}isEpsilon(){return!1}}class sa extends ia{constructor(e,t){super(e),this.tokenType=t}}class Pc extends ia{constructor(e){super(e)}isEpsilon(){return!0}}class aa extends ia{constructor(e,t,r){super(e),this.rule=t,this.followState=r}isEpsilon(){return!0}}function $p(n){const e={decisionMap:{},decisionStates:[],ruleToStartState:new Map,ruleToStopState:new Map,states:[]};xp(e,n);const t=n.length;for(let r=0;r<t;r++){const i=n[r],s=$t(e,i,i);s!==void 0&&Mp(e,i,s)}return e}function xp(n,e){const t=e.length;for(let r=0;r<t;r++){const i=e[r],s=X(n,i,void 0,{type:Rp}),a=X(n,i,void 0,{type:ar});s.stop=a,n.ruleToStartState.set(i,s),n.ruleToStopState.set(i,a)}}function Mc(n,e,t){return t instanceof G?oa(n,e,t.terminalType,t):t instanceof ce?Pp(n,e,t):t instanceof ge?wp(n,e,t):t instanceof ne?_p(n,e,t):t instanceof W?Sp(n,e,t):t instanceof me?Ip(n,e,t):t instanceof xe?Cp(n,e,t):t instanceof Se?Np(n,e,t):$t(n,e,t)}function Sp(n,e,t){const r=X(n,e,t,{type:bc});st(n,r);const i=ln(n,e,r,t,$t(n,e,t));return Fc(n,e,t,i)}function Ip(n,e,t){const r=X(n,e,t,{type:bc});st(n,r);const i=ln(n,e,r,t,$t(n,e,t)),s=oa(n,e,t.separator,t);return Fc(n,e,t,i,s)}function Cp(n,e,t){const r=X(n,e,t,{type:Lc});st(n,r);const i=ln(n,e,r,t,$t(n,e,t));return Dc(n,e,t,i)}function Np(n,e,t){const r=X(n,e,t,{type:Lc});st(n,r);const i=ln(n,e,r,t,$t(n,e,t)),s=oa(n,e,t.separator,t);return Dc(n,e,t,i,s)}function wp(n,e,t){const r=X(n,e,t,{type:nt});st(n,r);const i=$(t.definition,a=>Mc(n,e,a));return ln(n,e,r,t,...i)}function _p(n,e,t){const r=X(n,e,t,{type:nt});st(n,r);const i=ln(n,e,r,t,$t(n,e,t));return Lp(n,e,t,i)}function $t(n,e,t){const r=$e($(t.definition,i=>Mc(n,e,i)),i=>i!==void 0);return r.length===1?r[0]:r.length===0?void 0:Op(n,r)}function Dc(n,e,t,r,i){const s=r.left,a=r.right,o=X(n,e,t,{type:kp});st(n,o);const l=X(n,e,t,{type:Oc});return s.loopback=o,l.loopback=o,n.decisionMap[Zt(e,i?"RepetitionMandatoryWithSeparator":"RepetitionMandatory",t.idx)]=o,H(a,o),i===void 0?(H(o,s),H(o,l)):(H(o,l),H(o,i.left),H(i.right,s)),{left:s,right:l}}function Fc(n,e,t,r,i){const s=r.left,a=r.right,o=X(n,e,t,{type:Ep});st(n,o);const l=X(n,e,t,{type:Oc}),c=X(n,e,t,{type:Ap});return o.loopback=c,l.loopback=c,H(o,s),H(o,l),H(a,c),i!==void 0?(H(c,l),H(c,i.left),H(i.right,s)):H(c,o),n.decisionMap[Zt(e,i?"RepetitionWithSeparator":"Repetition",t.idx)]=o,{left:o,right:l}}function Lp(n,e,t,r){const i=r.left,s=r.right;return H(i,s),n.decisionMap[Zt(e,"Option",t.idx)]=i,r}function st(n,e){return n.decisionStates.push(e),e.decision=n.decisionStates.length-1,e.decision}function ln(n,e,t,r,...i){const s=X(n,e,r,{type:vp,start:t});t.end=s;for(const o of i)o!==void 0?(H(t,o.left),H(o.right,s)):H(t,s);const a={left:t,right:s};return n.decisionMap[Zt(e,bp(r),r.idx)]=t,a}function bp(n){if(n instanceof ge)return"Alternation";if(n instanceof ne)return"Option";if(n instanceof W)return"Repetition";if(n instanceof me)return"RepetitionWithSeparator";if(n instanceof xe)return"RepetitionMandatory";if(n instanceof Se)return"RepetitionMandatoryWithSeparator";throw new Error("Invalid production type encountered")}function Op(n,e){const t=e.length;for(let s=0;s<t-1;s++){const a=e[s];let o;a.left.transitions.length===1&&(o=a.left.transitions[0]);const l=o instanceof aa,c=o,u=e[s+1].left;a.left.type===nt&&a.right.type===nt&&o!==void 0&&(l&&c.followState===a.right||o.target===a.right)?(l?c.followState=u:o.target=u,Dp(n,a.right)):H(a.right,u)}const r=e[0],i=e[t-1];return{left:r.left,right:i.right}}function oa(n,e,t,r){const i=X(n,e,r,{type:nt}),s=X(n,e,r,{type:nt});return la(i,new sa(s,t)),{left:i,right:s}}function Pp(n,e,t){const r=t.referencedRule,i=n.ruleToStartState.get(r),s=X(n,e,t,{type:nt}),a=X(n,e,t,{type:nt}),o=new aa(i,r,a);return la(s,o),{left:s,right:a}}function Mp(n,e,t){const r=n.ruleToStartState.get(e);H(r,t.left);const i=n.ruleToStopState.get(e);return H(t.right,i),{left:r,right:i}}function H(n,e){const t=new Pc(e);la(n,t)}function X(n,e,t,r){const i=Object.assign({atn:n,production:t,epsilonOnlyTransitions:!1,rule:e,transitions:[],nextTokenWithinRule:[],stateNumber:n.states.length},r);return n.states.push(i),i}function la(n,e){n.transitions.length===0&&(n.epsilonOnlyTransitions=e.isEpsilon()),n.transitions.push(e)}function Dp(n,e){n.states.splice(n.states.indexOf(e),1)}const ti={};class Rs{constructor(){this.map={},this.configs=[]}get size(){return this.configs.length}finalize(){this.map={}}add(e){const t=Gc(e);t in this.map||(this.map[t]=this.configs.length,this.configs.push(e))}get elements(){return this.configs}get alts(){return $(this.configs,e=>e.alt)}get key(){let e="";for(const t in this.map)e+=t+":";return e}}function Gc(n,e=!0){return`${e?`a${n.alt}`:""}s${n.state.stateNumber}:${n.stack.map(t=>t.stateNumber.toString()).join("_")}`}function Fp(n,e){const t={};return r=>{const i=r.toString();let s=t[i];return s!==void 0||(s={atnStartState:n,decision:e,states:{}},t[i]=s),s}}class Uc{constructor(){this.predicates=[]}is(e){return e>=this.predicates.length||this.predicates[e]}set(e,t){this.predicates[e]=t}toString(){let e="";const t=this.predicates.length;for(let r=0;r<t;r++)e+=this.predicates[r]===!0?"1":"0";return e}}const Xa=new Uc;class Gp extends ra{constructor(e){var t;super(),this.logging=(t=e?.logging)!==null&&t!==void 0?t:(r=>console.log(r))}initialize(e){this.atn=$p(e.rules),this.dfas=Up(this.atn)}validateAmbiguousAlternationAlternatives(){return[]}validateEmptyOrAlternatives(){return[]}buildLookaheadForAlternation(e){const{prodOccurrence:t,rule:r,hasPredicates:i,dynamicTokensEnabled:s}=e,a=this.dfas,o=this.logging,l=Zt(r,"Alternation",t),u=this.atn.decisionMap[l].decision,d=$(Va({maxLookahead:1,occurrence:t,prodType:"Alternation",rule:r}),h=>$(h,f=>f[0]));if(Ja(d,!1)&&!s){const h=le(d,(f,m,g)=>(C(m,A=>{A&&(f[A.tokenTypeIdx]=g,C(A.categoryMatches,T=>{f[T]=g}))}),f),{});return i?function(f){var m;const g=this.LA(1),A=h[g.tokenTypeIdx];if(f!==void 0&&A!==void 0){const T=(m=f[A])===null||m===void 0?void 0:m.GATE;if(T!==void 0&&T.call(this)===!1)return}return A}:function(){const f=this.LA(1);return h[f.tokenTypeIdx]}}else return i?function(h){const f=new Uc,m=h===void 0?0:h.length;for(let A=0;A<m;A++){const T=h?.[A].GATE;f.set(A,T===void 0||T.call(this))}const g=Vi.call(this,a,u,f,o);return typeof g=="number"?g:void 0}:function(){const h=Vi.call(this,a,u,Xa,o);return typeof h=="number"?h:void 0}}buildLookaheadForOptional(e){const{prodOccurrence:t,rule:r,prodType:i,dynamicTokensEnabled:s}=e,a=this.dfas,o=this.logging,l=Zt(r,i,t),u=this.atn.decisionMap[l].decision,d=$(Va({maxLookahead:1,occurrence:t,prodType:i,rule:r}),h=>$(h,f=>f[0]));if(Ja(d)&&d[0][0]&&!s){const h=d[0],f=Ne(h);if(f.length===1&&D(f[0].categoryMatches)){const g=f[0].tokenTypeIdx;return function(){return this.LA(1).tokenTypeIdx===g}}else{const m=le(f,(g,A)=>(A!==void 0&&(g[A.tokenTypeIdx]=!0,C(A.categoryMatches,T=>{g[T]=!0})),g),{});return function(){const g=this.LA(1);return m[g.tokenTypeIdx]===!0}}}return function(){const h=Vi.call(this,a,u,Xa,o);return typeof h=="object"?!1:h===0}}}function Ja(n,e=!0){const t=new Set;for(const r of n){const i=new Set;for(const s of r){if(s===void 0){if(e)break;return!1}const a=[s.tokenTypeIdx].concat(s.categoryMatches);for(const o of a)if(t.has(o)){if(!i.has(o))return!1}else t.add(o),i.add(o)}}return!0}function Up(n){const e=n.decisionStates.length,t=Array(e);for(let r=0;r<e;r++)t[r]=Fp(n.decisionStates[r],r);return t}function Vi(n,e,t,r){const i=n[e](t);let s=i.start;if(s===void 0){const o=Jp(i.atnStartState);s=Vc(i,Bc(o)),i.start=s}return Bp.apply(this,[i,s,t,r])}function Bp(n,e,t,r){let i=e,s=1;const a=[];let o=this.LA(s++);for(;;){let l=zp(i,o);if(l===void 0&&(l=Vp.apply(this,[n,i,o,s,t,r])),l===ti)return Hp(a,i,o);if(l.isAcceptState===!0)return l.prediction;i=l,a.push(o),o=this.LA(s++)}}function Vp(n,e,t,r,i,s){const a=qp(e.configs,t,i);if(a.size===0)return Qa(n,e,t,ti),ti;let o=Bc(a);const l=Xp(a,i);if(l!==void 0)o.isAcceptState=!0,o.prediction=l,o.configs.uniqueAlt=l;else if(tm(a)){const c=zu(a.alts);o.isAcceptState=!0,o.prediction=c,o.configs.uniqueAlt=c,Kp.apply(this,[n,r,a.alts,s])}return o=Qa(n,e,t,o),o}function Kp(n,e,t,r){const i=[];for(let c=1;c<=e;c++)i.push(this.LA(c).tokenType);const s=n.atnStartState,a=s.rule,o=s.production,l=Wp({topLevelRule:a,ambiguityIndices:t,production:o,prefixPath:i});r(l)}function Wp(n){const e=$(n.prefixPath,i=>Lt(i)).join(", "),t=n.production.idx===0?"":n.production.idx;let r=`Ambiguous Alternatives Detected: <${n.ambiguityIndices.join(", ")}> in <${jp(n.production)}${t}> inside <${n.topLevelRule.name}> Rule,
-<${e}> may appears as a prefix path in all these alternatives.
-`;return r=r+`See: https://chevrotain.io/docs/guide/resolving_grammar_errors.html#AMBIGUOUS_ALTERNATIVES
-For Further details.`,r}function jp(n){if(n instanceof ce)return"SUBRULE";if(n instanceof ne)return"OPTION";if(n instanceof ge)return"OR";if(n instanceof xe)return"AT_LEAST_ONE";if(n instanceof Se)return"AT_LEAST_ONE_SEP";if(n instanceof me)return"MANY_SEP";if(n instanceof W)return"MANY";if(n instanceof G)return"CONSUME";throw Error("non exhaustive match")}function Hp(n,e,t){const r=Ee(e.configs.elements,s=>s.state.transitions),i=hd(r.filter(s=>s instanceof sa).map(s=>s.tokenType),s=>s.tokenTypeIdx);return{actualToken:t,possibleTokenTypes:i,tokenPath:n}}function zp(n,e){return n.edges[e.tokenTypeIdx]}function qp(n,e,t){const r=new Rs,i=[];for(const a of n.elements){if(t.is(a.alt)===!1)continue;if(a.state.type===ar){i.push(a);continue}const o=a.state.transitions.length;for(let l=0;l<o;l++){const c=a.state.transitions[l],u=Yp(c,e);u!==void 0&&r.add({state:u,alt:a.alt,stack:a.stack})}}let s;if(i.length===0&&r.size===1&&(s=r),s===void 0){s=new Rs;for(const a of r.elements)ni(a,s)}if(i.length>0&&!Zp(s))for(const a of i)s.add(a);return s}function Yp(n,e){if(n instanceof sa&&hc(e,n.tokenType))return n.target}function Xp(n,e){let t;for(const r of n.elements)if(e.is(r.alt)===!0){if(t===void 0)t=r.alt;else if(t!==r.alt)return}return t}function Bc(n){return{configs:n,edges:{},isAcceptState:!1,prediction:-1}}function Qa(n,e,t,r){return r=Vc(n,r),e.edges[t.tokenTypeIdx]=r,r}function Vc(n,e){if(e===ti)return e;const t=e.configs.key,r=n.states[t];return r!==void 0?r:(e.configs.finalize(),n.states[t]=e,e)}function Jp(n){const e=new Rs,t=n.transitions.length;for(let r=0;r<t;r++){const s={state:n.transitions[r].target,alt:r,stack:[]};ni(s,e)}return e}function ni(n,e){const t=n.state;if(t.type===ar){if(n.stack.length>0){const i=[...n.stack],a={state:i.pop(),alt:n.alt,stack:i};ni(a,e)}else e.add(n);return}t.epsilonOnlyTransitions||e.add(n);const r=t.transitions.length;for(let i=0;i<r;i++){const s=t.transitions[i],a=Qp(n,s);a!==void 0&&ni(a,e)}}function Qp(n,e){if(e instanceof Pc)return{state:e.target,alt:n.alt,stack:n.stack};if(e instanceof aa){const t=[...n.stack,e.followState];return{state:e.target,alt:n.alt,stack:t}}}function Zp(n){for(const e of n.elements)if(e.state.type===ar)return!0;return!1}function em(n){for(const e of n.elements)if(e.state.type!==ar)return!1;return!0}function tm(n){if(em(n))return!0;const e=nm(n.elements);return rm(e)&&!im(e)}function nm(n){const e=new Map;for(const t of n){const r=Gc(t,!1);let i=e.get(r);i===void 0&&(i={},e.set(r,i)),i[t.alt]=!0}return e}function rm(n){for(const e of Array.from(n.values()))if(Object.keys(e).length>1)return!0;return!1}function im(n){for(const e of Array.from(n.values()))if(Object.keys(e).length===1)return!0;return!1}var Za;(function(n){function e(t){return typeof t=="string"}n.is=e})(Za||(Za={}));var vs;(function(n){function e(t){return typeof t=="string"}n.is=e})(vs||(vs={}));var eo;(function(n){n.MIN_VALUE=-2147483648,n.MAX_VALUE=2147483647;function e(t){return typeof t=="number"&&n.MIN_VALUE<=t&&t<=n.MAX_VALUE}n.is=e})(eo||(eo={}));var ri;(function(n){n.MIN_VALUE=0,n.MAX_VALUE=2147483647;function e(t){return typeof t=="number"&&n.MIN_VALUE<=t&&t<=n.MAX_VALUE}n.is=e})(ri||(ri={}));var P;(function(n){function e(r,i){return r===Number.MAX_VALUE&&(r=ri.MAX_VALUE),i===Number.MAX_VALUE&&(i=ri.MAX_VALUE),{line:r,character:i}}n.create=e;function t(r){let i=r;return p.objectLiteral(i)&&p.uinteger(i.line)&&p.uinteger(i.character)}n.is=t})(P||(P={}));var O;(function(n){function e(r,i,s,a){if(p.uinteger(r)&&p.uinteger(i)&&p.uinteger(s)&&p.uinteger(a))return{start:P.create(r,i),end:P.create(s,a)};if(P.is(r)&&P.is(i))return{start:r,end:i};throw new Error(`Range#create called with invalid arguments[${r}, ${i}, ${s}, ${a}]`)}n.create=e;function t(r){let i=r;return p.objectLiteral(i)&&P.is(i.start)&&P.is(i.end)}n.is=t})(O||(O={}));var ii;(function(n){function e(r,i){return{uri:r,range:i}}n.create=e;function t(r){let i=r;return p.objectLiteral(i)&&O.is(i.range)&&(p.string(i.uri)||p.undefined(i.uri))}n.is=t})(ii||(ii={}));var to;(function(n){function e(r,i,s,a){return{targetUri:r,targetRange:i,targetSelectionRange:s,originSelectionRange:a}}n.create=e;function t(r){let i=r;return p.objectLiteral(i)&&O.is(i.targetRange)&&p.string(i.targetUri)&&O.is(i.targetSelectionRange)&&(O.is(i.originSelectionRange)||p.undefined(i.originSelectionRange))}n.is=t})(to||(to={}));var As;(function(n){function e(r,i,s,a){return{red:r,green:i,blue:s,alpha:a}}n.create=e;function t(r){const i=r;return p.objectLiteral(i)&&p.numberRange(i.red,0,1)&&p.numberRange(i.green,0,1)&&p.numberRange(i.blue,0,1)&&p.numberRange(i.alpha,0,1)}n.is=t})(As||(As={}));var no;(function(n){function e(r,i){return{range:r,color:i}}n.create=e;function t(r){const i=r;return p.objectLiteral(i)&&O.is(i.range)&&As.is(i.color)}n.is=t})(no||(no={}));var ro;(function(n){function e(r,i,s){return{label:r,textEdit:i,additionalTextEdits:s}}n.create=e;function t(r){const i=r;return p.objectLiteral(i)&&p.string(i.label)&&(p.undefined(i.textEdit)||tn.is(i))&&(p.undefined(i.additionalTextEdits)||p.typedArray(i.additionalTextEdits,tn.is))}n.is=t})(ro||(ro={}));var io;(function(n){n.Comment="comment",n.Imports="imports",n.Region="region"})(io||(io={}));var so;(function(n){function e(r,i,s,a,o,l){const c={startLine:r,endLine:i};return p.defined(s)&&(c.startCharacter=s),p.defined(a)&&(c.endCharacter=a),p.defined(o)&&(c.kind=o),p.defined(l)&&(c.collapsedText=l),c}n.create=e;function t(r){const i=r;return p.objectLiteral(i)&&p.uinteger(i.startLine)&&p.uinteger(i.startLine)&&(p.undefined(i.startCharacter)||p.uinteger(i.startCharacter))&&(p.undefined(i.endCharacter)||p.uinteger(i.endCharacter))&&(p.undefined(i.kind)||p.string(i.kind))}n.is=t})(so||(so={}));var Es;(function(n){function e(r,i){return{location:r,message:i}}n.create=e;function t(r){let i=r;return p.defined(i)&&ii.is(i.location)&&p.string(i.message)}n.is=t})(Es||(Es={}));var ao;(function(n){n.Error=1,n.Warning=2,n.Information=3,n.Hint=4})(ao||(ao={}));var oo;(function(n){n.Unnecessary=1,n.Deprecated=2})(oo||(oo={}));var lo;(function(n){function e(t){const r=t;return p.objectLiteral(r)&&p.string(r.href)}n.is=e})(lo||(lo={}));var si;(function(n){function e(r,i,s,a,o,l){let c={range:r,message:i};return p.defined(s)&&(c.severity=s),p.defined(a)&&(c.code=a),p.defined(o)&&(c.source=o),p.defined(l)&&(c.relatedInformation=l),c}n.create=e;function t(r){var i;let s=r;return p.defined(s)&&O.is(s.range)&&p.string(s.message)&&(p.number(s.severity)||p.undefined(s.severity))&&(p.integer(s.code)||p.string(s.code)||p.undefined(s.code))&&(p.undefined(s.codeDescription)||p.string((i=s.codeDescription)===null||i===void 0?void 0:i.href))&&(p.string(s.source)||p.undefined(s.source))&&(p.undefined(s.relatedInformation)||p.typedArray(s.relatedInformation,Es.is))}n.is=t})(si||(si={}));var en;(function(n){function e(r,i,...s){let a={title:r,command:i};return p.defined(s)&&s.length>0&&(a.arguments=s),a}n.create=e;function t(r){let i=r;return p.defined(i)&&p.string(i.title)&&p.string(i.command)}n.is=t})(en||(en={}));var tn;(function(n){function e(s,a){return{range:s,newText:a}}n.replace=e;function t(s,a){return{range:{start:s,end:s},newText:a}}n.insert=t;function r(s){return{range:s,newText:""}}n.del=r;function i(s){const a=s;return p.objectLiteral(a)&&p.string(a.newText)&&O.is(a.range)}n.is=i})(tn||(tn={}));var ks;(function(n){function e(r,i,s){const a={label:r};return i!==void 0&&(a.needsConfirmation=i),s!==void 0&&(a.description=s),a}n.create=e;function t(r){const i=r;return p.objectLiteral(i)&&p.string(i.label)&&(p.boolean(i.needsConfirmation)||i.needsConfirmation===void 0)&&(p.string(i.description)||i.description===void 0)}n.is=t})(ks||(ks={}));var nn;(function(n){function e(t){const r=t;return p.string(r)}n.is=e})(nn||(nn={}));var co;(function(n){function e(s,a,o){return{range:s,newText:a,annotationId:o}}n.replace=e;function t(s,a,o){return{range:{start:s,end:s},newText:a,annotationId:o}}n.insert=t;function r(s,a){return{range:s,newText:"",annotationId:a}}n.del=r;function i(s){const a=s;return tn.is(a)&&(ks.is(a.annotationId)||nn.is(a.annotationId))}n.is=i})(co||(co={}));var $s;(function(n){function e(r,i){return{textDocument:r,edits:i}}n.create=e;function t(r){let i=r;return p.defined(i)&&Ns.is(i.textDocument)&&Array.isArray(i.edits)}n.is=t})($s||($s={}));var xs;(function(n){function e(r,i,s){let a={kind:"create",uri:r};return i!==void 0&&(i.overwrite!==void 0||i.ignoreIfExists!==void 0)&&(a.options=i),s!==void 0&&(a.annotationId=s),a}n.create=e;function t(r){let i=r;return i&&i.kind==="create"&&p.string(i.uri)&&(i.options===void 0||(i.options.overwrite===void 0||p.boolean(i.options.overwrite))&&(i.options.ignoreIfExists===void 0||p.boolean(i.options.ignoreIfExists)))&&(i.annotationId===void 0||nn.is(i.annotationId))}n.is=t})(xs||(xs={}));var Ss;(function(n){function e(r,i,s,a){let o={kind:"rename",oldUri:r,newUri:i};return s!==void 0&&(s.overwrite!==void 0||s.ignoreIfExists!==void 0)&&(o.options=s),a!==void 0&&(o.annotationId=a),o}n.create=e;function t(r){let i=r;return i&&i.kind==="rename"&&p.string(i.oldUri)&&p.string(i.newUri)&&(i.options===void 0||(i.options.overwrite===void 0||p.boolean(i.options.overwrite))&&(i.options.ignoreIfExists===void 0||p.boolean(i.options.ignoreIfExists)))&&(i.annotationId===void 0||nn.is(i.annotationId))}n.is=t})(Ss||(Ss={}));var Is;(function(n){function e(r,i,s){let a={kind:"delete",uri:r};return i!==void 0&&(i.recursive!==void 0||i.ignoreIfNotExists!==void 0)&&(a.options=i),s!==void 0&&(a.annotationId=s),a}n.create=e;function t(r){let i=r;return i&&i.kind==="delete"&&p.string(i.uri)&&(i.options===void 0||(i.options.recursive===void 0||p.boolean(i.options.recursive))&&(i.options.ignoreIfNotExists===void 0||p.boolean(i.options.ignoreIfNotExists)))&&(i.annotationId===void 0||nn.is(i.annotationId))}n.is=t})(Is||(Is={}));var Cs;(function(n){function e(t){let r=t;return r&&(r.changes!==void 0||r.documentChanges!==void 0)&&(r.documentChanges===void 0||r.documentChanges.every(i=>p.string(i.kind)?xs.is(i)||Ss.is(i)||Is.is(i):$s.is(i)))}n.is=e})(Cs||(Cs={}));var uo;(function(n){function e(r){return{uri:r}}n.create=e;function t(r){let i=r;return p.defined(i)&&p.string(i.uri)}n.is=t})(uo||(uo={}));var fo;(function(n){function e(r,i){return{uri:r,version:i}}n.create=e;function t(r){let i=r;return p.defined(i)&&p.string(i.uri)&&p.integer(i.version)}n.is=t})(fo||(fo={}));var Ns;(function(n){function e(r,i){return{uri:r,version:i}}n.create=e;function t(r){let i=r;return p.defined(i)&&p.string(i.uri)&&(i.version===null||p.integer(i.version))}n.is=t})(Ns||(Ns={}));var ho;(function(n){function e(r,i,s,a){return{uri:r,languageId:i,version:s,text:a}}n.create=e;function t(r){let i=r;return p.defined(i)&&p.string(i.uri)&&p.string(i.languageId)&&p.integer(i.version)&&p.string(i.text)}n.is=t})(ho||(ho={}));var ws;(function(n){n.PlainText="plaintext",n.Markdown="markdown";function e(t){const r=t;return r===n.PlainText||r===n.Markdown}n.is=e})(ws||(ws={}));var Jn;(function(n){function e(t){const r=t;return p.objectLiteral(t)&&ws.is(r.kind)&&p.string(r.value)}n.is=e})(Jn||(Jn={}));var po;(function(n){n.Text=1,n.Method=2,n.Function=3,n.Constructor=4,n.Field=5,n.Variable=6,n.Class=7,n.Interface=8,n.Module=9,n.Property=10,n.Unit=11,n.Value=12,n.Enum=13,n.Keyword=14,n.Snippet=15,n.Color=16,n.File=17,n.Reference=18,n.Folder=19,n.EnumMember=20,n.Constant=21,n.Struct=22,n.Event=23,n.Operator=24,n.TypeParameter=25})(po||(po={}));var mo;(function(n){n.PlainText=1,n.Snippet=2})(mo||(mo={}));var go;(function(n){n.Deprecated=1})(go||(go={}));var yo;(function(n){function e(r,i,s){return{newText:r,insert:i,replace:s}}n.create=e;function t(r){const i=r;return i&&p.string(i.newText)&&O.is(i.insert)&&O.is(i.replace)}n.is=t})(yo||(yo={}));var To;(function(n){n.asIs=1,n.adjustIndentation=2})(To||(To={}));var Ro;(function(n){function e(t){const r=t;return r&&(p.string(r.detail)||r.detail===void 0)&&(p.string(r.description)||r.description===void 0)}n.is=e})(Ro||(Ro={}));var vo;(function(n){function e(t){return{label:t}}n.create=e})(vo||(vo={}));var Ao;(function(n){function e(t,r){return{items:t||[],isIncomplete:!!r}}n.create=e})(Ao||(Ao={}));var ai;(function(n){function e(r){return r.replace(/[\\`*_{}[\]()#+\-.!]/g,"\\$&")}n.fromPlainText=e;function t(r){const i=r;return p.string(i)||p.objectLiteral(i)&&p.string(i.language)&&p.string(i.value)}n.is=t})(ai||(ai={}));var Eo;(function(n){function e(t){let r=t;return!!r&&p.objectLiteral(r)&&(Jn.is(r.contents)||ai.is(r.contents)||p.typedArray(r.contents,ai.is))&&(t.range===void 0||O.is(t.range))}n.is=e})(Eo||(Eo={}));var ko;(function(n){function e(t,r){return r?{label:t,documentation:r}:{label:t}}n.create=e})(ko||(ko={}));var $o;(function(n){function e(t,r,...i){let s={label:t};return p.defined(r)&&(s.documentation=r),p.defined(i)?s.parameters=i:s.parameters=[],s}n.create=e})($o||($o={}));var xo;(function(n){n.Text=1,n.Read=2,n.Write=3})(xo||(xo={}));var So;(function(n){function e(t,r){let i={range:t};return p.number(r)&&(i.kind=r),i}n.create=e})(So||(So={}));var Io;(function(n){n.File=1,n.Module=2,n.Namespace=3,n.Package=4,n.Class=5,n.Method=6,n.Property=7,n.Field=8,n.Constructor=9,n.Enum=10,n.Interface=11,n.Function=12,n.Variable=13,n.Constant=14,n.String=15,n.Number=16,n.Boolean=17,n.Array=18,n.Object=19,n.Key=20,n.Null=21,n.EnumMember=22,n.Struct=23,n.Event=24,n.Operator=25,n.TypeParameter=26})(Io||(Io={}));var Co;(function(n){n.Deprecated=1})(Co||(Co={}));var No;(function(n){function e(t,r,i,s,a){let o={name:t,kind:r,location:{uri:s,range:i}};return a&&(o.containerName=a),o}n.create=e})(No||(No={}));var wo;(function(n){function e(t,r,i,s){return s!==void 0?{name:t,kind:r,location:{uri:i,range:s}}:{name:t,kind:r,location:{uri:i}}}n.create=e})(wo||(wo={}));var _o;(function(n){function e(r,i,s,a,o,l){let c={name:r,detail:i,kind:s,range:a,selectionRange:o};return l!==void 0&&(c.children=l),c}n.create=e;function t(r){let i=r;return i&&p.string(i.name)&&p.number(i.kind)&&O.is(i.range)&&O.is(i.selectionRange)&&(i.detail===void 0||p.string(i.detail))&&(i.deprecated===void 0||p.boolean(i.deprecated))&&(i.children===void 0||Array.isArray(i.children))&&(i.tags===void 0||Array.isArray(i.tags))}n.is=t})(_o||(_o={}));var Lo;(function(n){n.Empty="",n.QuickFix="quickfix",n.Refactor="refactor",n.RefactorExtract="refactor.extract",n.RefactorInline="refactor.inline",n.RefactorRewrite="refactor.rewrite",n.Source="source",n.SourceOrganizeImports="source.organizeImports",n.SourceFixAll="source.fixAll"})(Lo||(Lo={}));var oi;(function(n){n.Invoked=1,n.Automatic=2})(oi||(oi={}));var bo;(function(n){function e(r,i,s){let a={diagnostics:r};return i!=null&&(a.only=i),s!=null&&(a.triggerKind=s),a}n.create=e;function t(r){let i=r;return p.defined(i)&&p.typedArray(i.diagnostics,si.is)&&(i.only===void 0||p.typedArray(i.only,p.string))&&(i.triggerKind===void 0||i.triggerKind===oi.Invoked||i.triggerKind===oi.Automatic)}n.is=t})(bo||(bo={}));var Oo;(function(n){function e(r,i,s){let a={title:r},o=!0;return typeof i=="string"?(o=!1,a.kind=i):en.is(i)?a.command=i:a.edit=i,o&&s!==void 0&&(a.kind=s),a}n.create=e;function t(r){let i=r;return i&&p.string(i.title)&&(i.diagnostics===void 0||p.typedArray(i.diagnostics,si.is))&&(i.kind===void 0||p.string(i.kind))&&(i.edit!==void 0||i.command!==void 0)&&(i.command===void 0||en.is(i.command))&&(i.isPreferred===void 0||p.boolean(i.isPreferred))&&(i.edit===void 0||Cs.is(i.edit))}n.is=t})(Oo||(Oo={}));var Po;(function(n){function e(r,i){let s={range:r};return p.defined(i)&&(s.data=i),s}n.create=e;function t(r){let i=r;return p.defined(i)&&O.is(i.range)&&(p.undefined(i.command)||en.is(i.command))}n.is=t})(Po||(Po={}));var Mo;(function(n){function e(r,i){return{tabSize:r,insertSpaces:i}}n.create=e;function t(r){let i=r;return p.defined(i)&&p.uinteger(i.tabSize)&&p.boolean(i.insertSpaces)}n.is=t})(Mo||(Mo={}));var Do;(function(n){function e(r,i,s){return{range:r,target:i,data:s}}n.create=e;function t(r){let i=r;return p.defined(i)&&O.is(i.range)&&(p.undefined(i.target)||p.string(i.target))}n.is=t})(Do||(Do={}));var Fo;(function(n){function e(r,i){return{range:r,parent:i}}n.create=e;function t(r){let i=r;return p.objectLiteral(i)&&O.is(i.range)&&(i.parent===void 0||n.is(i.parent))}n.is=t})(Fo||(Fo={}));var Go;(function(n){n.namespace="namespace",n.type="type",n.class="class",n.enum="enum",n.interface="interface",n.struct="struct",n.typeParameter="typeParameter",n.parameter="parameter",n.variable="variable",n.property="property",n.enumMember="enumMember",n.event="event",n.function="function",n.method="method",n.macro="macro",n.keyword="keyword",n.modifier="modifier",n.comment="comment",n.string="string",n.number="number",n.regexp="regexp",n.operator="operator",n.decorator="decorator"})(Go||(Go={}));var Uo;(function(n){n.declaration="declaration",n.definition="definition",n.readonly="readonly",n.static="static",n.deprecated="deprecated",n.abstract="abstract",n.async="async",n.modification="modification",n.documentation="documentation",n.defaultLibrary="defaultLibrary"})(Uo||(Uo={}));var Bo;(function(n){function e(t){const r=t;return p.objectLiteral(r)&&(r.resultId===void 0||typeof r.resultId=="string")&&Array.isArray(r.data)&&(r.data.length===0||typeof r.data[0]=="number")}n.is=e})(Bo||(Bo={}));var Vo;(function(n){function e(r,i){return{range:r,text:i}}n.create=e;function t(r){const i=r;return i!=null&&O.is(i.range)&&p.string(i.text)}n.is=t})(Vo||(Vo={}));var Ko;(function(n){function e(r,i,s){return{range:r,variableName:i,caseSensitiveLookup:s}}n.create=e;function t(r){const i=r;return i!=null&&O.is(i.range)&&p.boolean(i.caseSensitiveLookup)&&(p.string(i.variableName)||i.variableName===void 0)}n.is=t})(Ko||(Ko={}));var Wo;(function(n){function e(r,i){return{range:r,expression:i}}n.create=e;function t(r){const i=r;return i!=null&&O.is(i.range)&&(p.string(i.expression)||i.expression===void 0)}n.is=t})(Wo||(Wo={}));var jo;(function(n){function e(r,i){return{frameId:r,stoppedLocation:i}}n.create=e;function t(r){const i=r;return p.defined(i)&&O.is(r.stoppedLocation)}n.is=t})(jo||(jo={}));var _s;(function(n){n.Type=1,n.Parameter=2;function e(t){return t===1||t===2}n.is=e})(_s||(_s={}));var Ls;(function(n){function e(r){return{value:r}}n.create=e;function t(r){const i=r;return p.objectLiteral(i)&&(i.tooltip===void 0||p.string(i.tooltip)||Jn.is(i.tooltip))&&(i.location===void 0||ii.is(i.location))&&(i.command===void 0||en.is(i.command))}n.is=t})(Ls||(Ls={}));var Ho;(function(n){function e(r,i,s){const a={position:r,label:i};return s!==void 0&&(a.kind=s),a}n.create=e;function t(r){const i=r;return p.objectLiteral(i)&&P.is(i.position)&&(p.string(i.label)||p.typedArray(i.label,Ls.is))&&(i.kind===void 0||_s.is(i.kind))&&i.textEdits===void 0||p.typedArray(i.textEdits,tn.is)&&(i.tooltip===void 0||p.string(i.tooltip)||Jn.is(i.tooltip))&&(i.paddingLeft===void 0||p.boolean(i.paddingLeft))&&(i.paddingRight===void 0||p.boolean(i.paddingRight))}n.is=t})(Ho||(Ho={}));var zo;(function(n){function e(t){return{kind:"snippet",value:t}}n.createSnippet=e})(zo||(zo={}));var qo;(function(n){function e(t,r,i,s){return{insertText:t,filterText:r,range:i,command:s}}n.create=e})(qo||(qo={}));var Yo;(function(n){function e(t){return{items:t}}n.create=e})(Yo||(Yo={}));var Xo;(function(n){n.Invoked=0,n.Automatic=1})(Xo||(Xo={}));var Jo;(function(n){function e(t,r){return{range:t,text:r}}n.create=e})(Jo||(Jo={}));var Qo;(function(n){function e(t,r){return{triggerKind:t,selectedCompletionInfo:r}}n.create=e})(Qo||(Qo={}));var Zo;(function(n){function e(t){const r=t;return p.objectLiteral(r)&&vs.is(r.uri)&&p.string(r.name)}n.is=e})(Zo||(Zo={}));var el;(function(n){function e(s,a,o,l){return new sm(s,a,o,l)}n.create=e;function t(s){let a=s;return!!(p.defined(a)&&p.string(a.uri)&&(p.undefined(a.languageId)||p.string(a.languageId))&&p.uinteger(a.lineCount)&&p.func(a.getText)&&p.func(a.positionAt)&&p.func(a.offsetAt))}n.is=t;function r(s,a){let o=s.getText(),l=i(a,(u,d)=>{let h=u.range.start.line-d.range.start.line;return h===0?u.range.start.character-d.range.start.character:h}),c=o.length;for(let u=l.length-1;u>=0;u--){let d=l[u],h=s.offsetAt(d.range.start),f=s.offsetAt(d.range.end);if(f<=c)o=o.substring(0,h)+d.newText+o.substring(f,o.length);else throw new Error("Overlapping edit");c=h}return o}n.applyEdits=r;function i(s,a){if(s.length<=1)return s;const o=s.length/2|0,l=s.slice(0,o),c=s.slice(o);i(l,a),i(c,a);let u=0,d=0,h=0;for(;u<l.length&&d<c.length;)a(l[u],c[d])<=0?s[h++]=l[u++]:s[h++]=c[d++];for(;u<l.length;)s[h++]=l[u++];for(;d<c.length;)s[h++]=c[d++];return s}})(el||(el={}));let sm=class{constructor(e,t,r,i){this._uri=e,this._languageId=t,this._version=r,this._content=i,this._lineOffsets=void 0}get uri(){return this._uri}get languageId(){return this._languageId}get version(){return this._version}getText(e){if(e){let t=this.offsetAt(e.start),r=this.offsetAt(e.end);return this._content.substring(t,r)}return this._content}update(e,t){this._content=e.text,this._version=t,this._lineOffsets=void 0}getLineOffsets(){if(this._lineOffsets===void 0){let e=[],t=this._content,r=!0;for(let i=0;i<t.length;i++){r&&(e.push(i),r=!1);let s=t.charAt(i);r=s==="\r"||s===`
-`,s==="\r"&&i+1<t.length&&t.charAt(i+1)===`
-`&&i++}r&&t.length>0&&e.push(t.length),this._lineOffsets=e}return this._lineOffsets}positionAt(e){e=Math.max(Math.min(e,this._content.length),0);let t=this.getLineOffsets(),r=0,i=t.length;if(i===0)return P.create(0,e);for(;r<i;){let a=Math.floor((r+i)/2);t[a]>e?i=a:r=a+1}let s=r-1;return P.create(s,e-t[s])}offsetAt(e){let t=this.getLineOffsets();if(e.line>=t.length)return this._content.length;if(e.line<0)return 0;let r=t[e.line],i=e.line+1<t.length?t[e.line+1]:this._content.length;return Math.max(Math.min(r+e.character,i),r)}get lineCount(){return this.getLineOffsets().length}};var p;(function(n){const e=Object.prototype.toString;function t(f){return typeof f<"u"}n.defined=t;function r(f){return typeof f>"u"}n.undefined=r;function i(f){return f===!0||f===!1}n.boolean=i;function s(f){return e.call(f)==="[object String]"}n.string=s;function a(f){return e.call(f)==="[object Number]"}n.number=a;function o(f,m,g){return e.call(f)==="[object Number]"&&m<=f&&f<=g}n.numberRange=o;function l(f){return e.call(f)==="[object Number]"&&-2147483648<=f&&f<=2147483647}n.integer=l;function c(f){return e.call(f)==="[object Number]"&&0<=f&&f<=2147483647}n.uinteger=c;function u(f){return e.call(f)==="[object Function]"}n.func=u;function d(f){return f!==null&&typeof f=="object"}n.objectLiteral=d;function h(f,m){return Array.isArray(f)&&f.every(m)}n.typedArray=h})(p||(p={}));class am{constructor(){this.nodeStack=[]}get current(){var e;return(e=this.nodeStack[this.nodeStack.length-1])!==null&&e!==void 0?e:this.rootNode}buildRootNode(e){return this.rootNode=new Wc(e),this.rootNode.root=this.rootNode,this.nodeStack=[this.rootNode],this.rootNode}buildCompositeNode(e){const t=new ca;return t.grammarSource=e,t.root=this.rootNode,this.current.content.push(t),this.nodeStack.push(t),t}buildLeafNode(e,t){const r=new bs(e.startOffset,e.image.length,as(e),e.tokenType,!t);return r.grammarSource=t,r.root=this.rootNode,this.current.content.push(r),r}removeNode(e){const t=e.container;if(t){const r=t.content.indexOf(e);r>=0&&t.content.splice(r,1)}}addHiddenNodes(e){const t=[];for(const s of e){const a=new bs(s.startOffset,s.image.length,as(s),s.tokenType,!0);a.root=this.rootNode,t.push(a)}let r=this.current,i=!1;if(r.content.length>0){r.content.push(...t);return}for(;r.container;){const s=r.container.content.indexOf(r);if(s>0){r.container.content.splice(s,0,...t),i=!0;break}r=r.container}i||this.rootNode.content.unshift(...t)}construct(e){const t=this.current;typeof e.$type=="string"&&(this.current.astNode=e),e.$cstNode=t;const r=this.nodeStack.pop();r?.content.length===0&&this.removeNode(r)}}class Kc{get parent(){return this.container}get feature(){return this.grammarSource}get hidden(){return!1}get astNode(){var e,t;const r=typeof((e=this._astNode)===null||e===void 0?void 0:e.$type)=="string"?this._astNode:(t=this.container)===null||t===void 0?void 0:t.astNode;if(!r)throw new Error("This node has no associated AST element");return r}set astNode(e){this._astNode=e}get element(){return this.astNode}get text(){return this.root.fullText.substring(this.offset,this.end)}}class bs extends Kc{get offset(){return this._offset}get length(){return this._length}get end(){return this._offset+this._length}get hidden(){return this._hidden}get tokenType(){return this._tokenType}get range(){return this._range}constructor(e,t,r,i,s=!1){super(),this._hidden=s,this._offset=e,this._tokenType=i,this._length=t,this._range=r}}class ca extends Kc{constructor(){super(...arguments),this.content=new ua(this)}get children(){return this.content}get offset(){var e,t;return(t=(e=this.firstNonHiddenNode)===null||e===void 0?void 0:e.offset)!==null&&t!==void 0?t:0}get length(){return this.end-this.offset}get end(){var e,t;return(t=(e=this.lastNonHiddenNode)===null||e===void 0?void 0:e.end)!==null&&t!==void 0?t:0}get range(){const e=this.firstNonHiddenNode,t=this.lastNonHiddenNode;if(e&&t){if(this._rangeCache===void 0){const{range:r}=e,{range:i}=t;this._rangeCache={start:r.start,end:i.end.line<r.start.line?r.start:i.end}}return this._rangeCache}else return{start:P.create(0,0),end:P.create(0,0)}}get firstNonHiddenNode(){for(const e of this.content)if(!e.hidden)return e;return this.content[0]}get lastNonHiddenNode(){for(let e=this.content.length-1;e>=0;e--){const t=this.content[e];if(!t.hidden)return t}return this.content[this.content.length-1]}}class ua extends Array{constructor(e){super(),this.parent=e,Object.setPrototypeOf(this,ua.prototype)}push(...e){return this.addParents(e),super.push(...e)}unshift(...e){return this.addParents(e),super.unshift(...e)}splice(e,t,...r){return this.addParents(r),super.splice(e,t,...r)}addParents(e){for(const t of e)t.container=this.parent}}class Wc extends ca{get text(){return this._text.substring(this.offset,this.end)}get fullText(){return this._text}constructor(e){super(),this._text="",this._text=e??""}}const Os=Symbol("Datatype");function Ki(n){return n.$type===Os}const tl="​",jc=n=>n.endsWith(tl)?n:n+tl;class Hc{constructor(e){this._unorderedGroups=new Map,this.allRules=new Map,this.lexer=e.parser.Lexer;const t=this.lexer.definition,r=e.LanguageMetaData.mode==="production";this.wrapper=new dm(t,Object.assign(Object.assign({},e.parser.ParserConfig),{skipValidations:r,errorMessageProvider:e.parser.ParserErrorMessageProvider}))}alternatives(e,t){this.wrapper.wrapOr(e,t)}optional(e,t){this.wrapper.wrapOption(e,t)}many(e,t){this.wrapper.wrapMany(e,t)}atLeastOne(e,t){this.wrapper.wrapAtLeastOne(e,t)}getRule(e){return this.allRules.get(e)}isRecording(){return this.wrapper.IS_RECORDING}get unorderedGroups(){return this._unorderedGroups}getRuleStack(){return this.wrapper.RULE_STACK}finalize(){this.wrapper.wrapSelfAnalysis()}}class om extends Hc{get current(){return this.stack[this.stack.length-1]}constructor(e){super(e),this.nodeBuilder=new am,this.stack=[],this.assignmentMap=new Map,this.linker=e.references.Linker,this.converter=e.parser.ValueConverter,this.astReflection=e.shared.AstReflection}rule(e,t){const r=this.computeRuleType(e),i=this.wrapper.DEFINE_RULE(jc(e.name),this.startImplementation(r,t).bind(this));return this.allRules.set(e.name,i),e.entry&&(this.mainRule=i),i}computeRuleType(e){if(!e.fragment){if(Jl(e))return Os;{const t=Ys(e);return t??e.name}}}parse(e,t={}){this.nodeBuilder.buildRootNode(e);const r=this.lexerResult=this.lexer.tokenize(e);this.wrapper.input=r.tokens;const i=t.rule?this.allRules.get(t.rule):this.mainRule;if(!i)throw new Error(t.rule?`No rule found with name '${t.rule}'`:"No main rule available.");const s=i.call(this.wrapper,{});return this.nodeBuilder.addHiddenNodes(r.hidden),this.unorderedGroups.clear(),this.lexerResult=void 0,{value:s,lexerErrors:r.errors,lexerReport:r.report,parserErrors:this.wrapper.errors}}startImplementation(e,t){return r=>{const i=!this.isRecording()&&e!==void 0;if(i){const a={$type:e};this.stack.push(a),e===Os&&(a.value="")}let s;try{s=t(r)}catch{s=void 0}return s===void 0&&i&&(s=this.construct()),s}}extractHiddenTokens(e){const t=this.lexerResult.hidden;if(!t.length)return[];const r=e.startOffset;for(let i=0;i<t.length;i++)if(t[i].startOffset>r)return t.splice(0,i);return t.splice(0,t.length)}consume(e,t,r){const i=this.wrapper.wrapConsume(e,t);if(!this.isRecording()&&this.isValidToken(i)){const s=this.extractHiddenTokens(i);this.nodeBuilder.addHiddenNodes(s);const a=this.nodeBuilder.buildLeafNode(i,r),{assignment:o,isCrossRef:l}=this.getAssignment(r),c=this.current;if(o){const u=yt(r)?i.image:this.converter.convert(i.image,a);this.assign(o.operator,o.feature,u,a,l)}else if(Ki(c)){let u=i.image;yt(r)||(u=this.converter.convert(u,a).toString()),c.value+=u}}}isValidToken(e){return!e.isInsertedInRecovery&&!isNaN(e.startOffset)&&typeof e.endOffset=="number"&&!isNaN(e.endOffset)}subrule(e,t,r,i,s){let a;!this.isRecording()&&!r&&(a=this.nodeBuilder.buildCompositeNode(i));const o=this.wrapper.wrapSubrule(e,t,s);!this.isRecording()&&a&&a.length>0&&this.performSubruleAssignment(o,i,a)}performSubruleAssignment(e,t,r){const{assignment:i,isCrossRef:s}=this.getAssignment(t);if(i)this.assign(i.operator,i.feature,e,r,s);else if(!i){const a=this.current;if(Ki(a))a.value+=e.toString();else if(typeof e=="object"&&e){const l=this.assignWithoutOverride(e,a);this.stack.pop(),this.stack.push(l)}}}action(e,t){if(!this.isRecording()){let r=this.current;if(t.feature&&t.operator){r=this.construct(),this.nodeBuilder.removeNode(r.$cstNode),this.nodeBuilder.buildCompositeNode(t).content.push(r.$cstNode);const s={$type:e};this.stack.push(s),this.assign(t.operator,t.feature,r,r.$cstNode,!1)}else r.$type=e}}construct(){if(this.isRecording())return;const e=this.current;return Ud(e),this.nodeBuilder.construct(e),this.stack.pop(),Ki(e)?this.converter.convert(e.value,e.$cstNode):(Bd(this.astReflection,e),e)}getAssignment(e){if(!this.assignmentMap.has(e)){const t=gi(e,gt);this.assignmentMap.set(e,{assignment:t,isCrossRef:t?js(t.terminal):!1})}return this.assignmentMap.get(e)}assign(e,t,r,i,s){const a=this.current;let o;switch(s&&typeof r=="string"?o=this.linker.buildReference(a,t,i,r):o=r,e){case"=":{a[t]=o;break}case"?=":{a[t]=!0;break}case"+=":Array.isArray(a[t])||(a[t]=[]),a[t].push(o)}}assignWithoutOverride(e,t){for(const[i,s]of Object.entries(t)){const a=e[i];a===void 0?e[i]=s:Array.isArray(a)&&Array.isArray(s)&&(s.push(...a),e[i]=s)}const r=e.$cstNode;return r&&(r.astNode=void 0,e.$cstNode=void 0),e}get definitionErrors(){return this.wrapper.definitionErrors}}class lm{buildMismatchTokenMessage(e){return wt.buildMismatchTokenMessage(e)}buildNotAllInputParsedMessage(e){return wt.buildNotAllInputParsedMessage(e)}buildNoViableAltMessage(e){return wt.buildNoViableAltMessage(e)}buildEarlyExitMessage(e){return wt.buildEarlyExitMessage(e)}}class zc extends lm{buildMismatchTokenMessage({expected:e,actual:t}){return`Expecting ${e.LABEL?"`"+e.LABEL+"`":e.name.endsWith(":KW")?`keyword '${e.name.substring(0,e.name.length-3)}'`:`token of type '${e.name}'`} but found \`${t.image}\`.`}buildNotAllInputParsedMessage({firstRedundant:e}){return`Expecting end of file but found \`${e.image}\`.`}}class cm extends Hc{constructor(){super(...arguments),this.tokens=[],this.elementStack=[],this.lastElementStack=[],this.nextTokenIndex=0,this.stackSize=0}action(){}construct(){}parse(e){this.resetState();const t=this.lexer.tokenize(e,{mode:"partial"});return this.tokens=t.tokens,this.wrapper.input=[...this.tokens],this.mainRule.call(this.wrapper,{}),this.unorderedGroups.clear(),{tokens:this.tokens,elementStack:[...this.lastElementStack],tokenIndex:this.nextTokenIndex}}rule(e,t){const r=this.wrapper.DEFINE_RULE(jc(e.name),this.startImplementation(t).bind(this));return this.allRules.set(e.name,r),e.entry&&(this.mainRule=r),r}resetState(){this.elementStack=[],this.lastElementStack=[],this.nextTokenIndex=0,this.stackSize=0}startImplementation(e){return t=>{const r=this.keepStackSize();try{e(t)}finally{this.resetStackSize(r)}}}removeUnexpectedElements(){this.elementStack.splice(this.stackSize)}keepStackSize(){const e=this.elementStack.length;return this.stackSize=e,e}resetStackSize(e){this.removeUnexpectedElements(),this.stackSize=e}consume(e,t,r){this.wrapper.wrapConsume(e,t),this.isRecording()||(this.lastElementStack=[...this.elementStack,r],this.nextTokenIndex=this.currIdx+1)}subrule(e,t,r,i,s){this.before(i),this.wrapper.wrapSubrule(e,t,s),this.after(i)}before(e){this.isRecording()||this.elementStack.push(e)}after(e){if(!this.isRecording()){const t=this.elementStack.lastIndexOf(e);t>=0&&this.elementStack.splice(t)}}get currIdx(){return this.wrapper.currIdx}}const um={recoveryEnabled:!0,nodeLocationTracking:"full",skipValidations:!0,errorMessageProvider:new zc};class dm extends Tp{constructor(e,t){const r=t&&"maxLookahead"in t;super(e,Object.assign(Object.assign(Object.assign({},um),{lookaheadStrategy:r?new ra({maxLookahead:t.maxLookahead}):new Gp({logging:t.skipValidations?()=>{}:void 0})}),t))}get IS_RECORDING(){return this.RECORDING_PHASE}DEFINE_RULE(e,t){return this.RULE(e,t)}wrapSelfAnalysis(){this.performSelfAnalysis()}wrapConsume(e,t){return this.consume(e,t)}wrapSubrule(e,t,r){return this.subrule(e,t,{ARGS:[r]})}wrapOr(e,t){this.or(e,t)}wrapOption(e,t){this.option(e,t)}wrapMany(e,t){this.many(e,t)}wrapAtLeastOne(e,t){this.atLeastOne(e,t)}}function qc(n,e,t){return fm({parser:e,tokens:t,ruleNames:new Map},n),e}function fm(n,e){const t=Hl(e,!1),r=ee(e.rules).filter(we).filter(i=>t.has(i));for(const i of r){const s=Object.assign(Object.assign({},n),{consume:1,optional:1,subrule:1,many:1,or:1});n.parser.rule(i,vt(s,i.definition))}}function vt(n,e,t=!1){let r;if(yt(e))r=Rm(n,e);else if(mi(e))r=hm(n,e);else if(gt(e))r=vt(n,e.terminal);else if(js(e))r=Yc(n,e);else if(Tt(e))r=pm(n,e);else if(Ul(e))r=gm(n,e);else if(Bl(e))r=ym(n,e);else if(Hs(e))r=Tm(n,e);else if(Ld(e)){const i=n.consume++;r=()=>n.parser.consume(i,tt,e)}else throw new Ml(e.$cstNode,`Unexpected element type: ${e.$type}`);return Xc(n,t?void 0:li(e),r,e.cardinality)}function hm(n,e){const t=Xs(e);return()=>n.parser.action(t,e)}function pm(n,e){const t=e.rule.ref;if(we(t)){const r=n.subrule++,i=t.fragment,s=e.arguments.length>0?mm(t,e.arguments):()=>({});return a=>n.parser.subrule(r,Jc(n,t),i,e,s(a))}else if(kt(t)){const r=n.consume++,i=Ps(n,t.name);return()=>n.parser.consume(r,i,e)}else if(t)er();else throw new Ml(e.$cstNode,`Undefined rule: ${e.rule.$refText}`)}function mm(n,e){const t=e.map(r=>ze(r.value));return r=>{const i={};for(let s=0;s<t.length;s++){const a=n.parameters[s],o=t[s];i[a.name]=o(r)}return i}}function ze(n){if(Sd(n)){const e=ze(n.left),t=ze(n.right);return r=>e(r)||t(r)}else if(xd(n)){const e=ze(n.left),t=ze(n.right);return r=>e(r)&&t(r)}else if(Id(n)){const e=ze(n.value);return t=>!e(t)}else if(Cd(n)){const e=n.parameter.ref.name;return t=>t!==void 0&&t[e]===!0}else if($d(n)){const e=!!n.true;return()=>e}er()}function gm(n,e){if(e.elements.length===1)return vt(n,e.elements[0]);{const t=[];for(const i of e.elements){const s={ALT:vt(n,i,!0)},a=li(i);a&&(s.GATE=ze(a)),t.push(s)}const r=n.or++;return i=>n.parser.alternatives(r,t.map(s=>{const a={ALT:()=>s.ALT(i)},o=s.GATE;return o&&(a.GATE=()=>o(i)),a}))}}function ym(n,e){if(e.elements.length===1)return vt(n,e.elements[0]);const t=[];for(const o of e.elements){const l={ALT:vt(n,o,!0)},c=li(o);c&&(l.GATE=ze(c)),t.push(l)}const r=n.or++,i=(o,l)=>{const c=l.getRuleStack().join("-");return`uGroup_${o}_${c}`},s=o=>n.parser.alternatives(r,t.map((l,c)=>{const u={ALT:()=>!0},d=n.parser;u.ALT=()=>{if(l.ALT(o),!d.isRecording()){const f=i(r,d);d.unorderedGroups.get(f)||d.unorderedGroups.set(f,[]);const m=d.unorderedGroups.get(f);typeof m?.[c]>"u"&&(m[c]=!0)}};const h=l.GATE;return h?u.GATE=()=>h(o):u.GATE=()=>{const f=d.unorderedGroups.get(i(r,d));return!f?.[c]},u})),a=Xc(n,li(e),s,"*");return o=>{a(o),n.parser.isRecording()||n.parser.unorderedGroups.delete(i(r,n.parser))}}function Tm(n,e){const t=e.elements.map(r=>vt(n,r));return r=>t.forEach(i=>i(r))}function li(n){if(Hs(n))return n.guardCondition}function Yc(n,e,t=e.terminal){if(t)if(Tt(t)&&we(t.rule.ref)){const r=t.rule.ref,i=n.subrule++;return s=>n.parser.subrule(i,Jc(n,r),!1,e,s)}else if(Tt(t)&&kt(t.rule.ref)){const r=n.consume++,i=Ps(n,t.rule.ref.name);return()=>n.parser.consume(r,i,e)}else if(yt(t)){const r=n.consume++,i=Ps(n,t.value);return()=>n.parser.consume(r,i,e)}else throw new Error("Could not build cross reference parser");else{if(!e.type.ref)throw new Error("Could not resolve reference to type: "+e.type.$refText);const r=Yl(e.type.ref),i=r?.terminal;if(!i)throw new Error("Could not find name assignment for type: "+Xs(e.type.ref));return Yc(n,e,i)}}function Rm(n,e){const t=n.consume++,r=n.tokens[e.value];if(!r)throw new Error("Could not find token for keyword: "+e.value);return()=>n.parser.consume(t,r,e)}function Xc(n,e,t,r){const i=e&&ze(e);if(!r)if(i){const s=n.or++;return a=>n.parser.alternatives(s,[{ALT:()=>t(a),GATE:()=>i(a)},{ALT:Ya(),GATE:()=>!i(a)}])}else return t;if(r==="*"){const s=n.many++;return a=>n.parser.many(s,{DEF:()=>t(a),GATE:i?()=>i(a):void 0})}else if(r==="+"){const s=n.many++;if(i){const a=n.or++;return o=>n.parser.alternatives(a,[{ALT:()=>n.parser.atLeastOne(s,{DEF:()=>t(o)}),GATE:()=>i(o)},{ALT:Ya(),GATE:()=>!i(o)}])}else return a=>n.parser.atLeastOne(s,{DEF:()=>t(a)})}else if(r==="?"){const s=n.optional++;return a=>n.parser.optional(s,{DEF:()=>t(a),GATE:i?()=>i(a):void 0})}else er()}function Jc(n,e){const t=vm(n,e),r=n.parser.getRule(t);if(!r)throw new Error(`Rule "${t}" not found."`);return r}function vm(n,e){if(we(e))return e.name;if(n.ruleNames.has(e))return n.ruleNames.get(e);{let t=e,r=t.$container,i=e.$type;for(;!we(r);)(Hs(r)||Ul(r)||Bl(r))&&(i=r.elements.indexOf(t).toString()+":"+i),t=r,r=r.$container;return i=r.name+":"+i,n.ruleNames.set(e,i),i}}function Ps(n,e){const t=n.tokens[e];if(!t)throw new Error(`Token "${e}" not found."`);return t}function Am(n){const e=n.Grammar,t=n.parser.Lexer,r=new cm(n);return qc(e,r,t.definition),r.finalize(),r}function Em(n){const e=km(n);return e.finalize(),e}function km(n){const e=n.Grammar,t=n.parser.Lexer,r=new om(n);return qc(e,r,t.definition)}class Qc{constructor(){this.diagnostics=[]}buildTokens(e,t){const r=ee(Hl(e,!1)),i=this.buildTerminalTokens(r),s=this.buildKeywordTokens(r,i,t);return i.forEach(a=>{const o=a.PATTERN;typeof o=="object"&&o&&"test"in o&&ls(o)?s.unshift(a):s.push(a)}),s}flushLexingReport(e){return{diagnostics:this.popDiagnostics()}}popDiagnostics(){const e=[...this.diagnostics];return this.diagnostics=[],e}buildTerminalTokens(e){return e.filter(kt).filter(t=>!t.fragment).map(t=>this.buildTerminalToken(t)).toArray()}buildTerminalToken(e){const t=Js(e),r=this.requiresCustomPattern(t)?this.regexPatternFunction(t):t,i={name:e.name,PATTERN:r};return typeof r=="function"&&(i.LINE_BREAKS=!0),e.hidden&&(i.GROUP=ls(t)?fe.SKIPPED:"hidden"),i}requiresCustomPattern(e){return e.flags.includes("u")||e.flags.includes("s")?!0:!!(e.source.includes("?<=")||e.source.includes("?<!"))}regexPatternFunction(e){const t=new RegExp(e,e.flags+"y");return(r,i)=>(t.lastIndex=i,t.exec(r))}buildKeywordTokens(e,t,r){return e.filter(we).flatMap(i=>tr(i).filter(yt)).distinct(i=>i.value).toArray().sort((i,s)=>s.value.length-i.value.length).map(i=>this.buildKeywordToken(i,t,!!r?.caseInsensitive))}buildKeywordToken(e,t,r){const i=this.buildKeywordPattern(e,r),s={name:e.value,PATTERN:i,LONGER_ALT:this.findLongerAlt(e,t)};return typeof i=="function"&&(s.LINE_BREAKS=!0),s}buildKeywordPattern(e,t){return t?new RegExp(Xd(e.value)):e.value}findLongerAlt(e,t){return t.reduce((r,i)=>{const s=i?.PATTERN;return s?.source&&Jd("^"+s.source+"$",e.value)&&r.push(i),r},[])}}class Zc{convert(e,t){let r=t.grammarSource;if(js(r)&&(r=tf(r)),Tt(r)){const i=r.rule.ref;if(!i)throw new Error("This cst node was not parsed by a rule.");return this.runConverter(i,e,t)}return e}runConverter(e,t,r){var i;switch(e.name.toUpperCase()){case"INT":return We.convertInt(t);case"STRING":return We.convertString(t);case"ID":return We.convertID(t)}switch((i=cf(e))===null||i===void 0?void 0:i.toLowerCase()){case"number":return We.convertNumber(t);case"boolean":return We.convertBoolean(t);case"bigint":return We.convertBigint(t);case"date":return We.convertDate(t);default:return t}}}var We;(function(n){function e(c){let u="";for(let d=1;d<c.length-1;d++){const h=c.charAt(d);if(h==="\\"){const f=c.charAt(++d);u+=t(f)}else u+=h}return u}n.convertString=e;function t(c){switch(c){case"b":return"\b";case"f":return"\f";case"n":return`
-`;case"r":return"\r";case"t":return"	";case"v":return"\v";case"0":return"\0";default:return c}}function r(c){return c.charAt(0)==="^"?c.substring(1):c}n.convertID=r;function i(c){return parseInt(c)}n.convertInt=i;function s(c){return BigInt(c)}n.convertBigint=s;function a(c){return new Date(c)}n.convertDate=a;function o(c){return Number(c)}n.convertNumber=o;function l(c){return c.toLowerCase()==="true"}n.convertBoolean=l})(We||(We={}));var ht={},Ar={},nl;function eu(){if(nl)return Ar;nl=1,Object.defineProperty(Ar,"__esModule",{value:!0});let n;function e(){if(n===void 0)throw new Error("No runtime abstraction layer installed");return n}return(function(t){function r(i){if(i===void 0)throw new Error("No runtime abstraction layer provided");n=i}t.install=r})(e||(e={})),Ar.default=e,Ar}var J={},rl;function $m(){if(rl)return J;rl=1,Object.defineProperty(J,"__esModule",{value:!0}),J.stringArray=J.array=J.func=J.error=J.number=J.string=J.boolean=void 0;function n(o){return o===!0||o===!1}J.boolean=n;function e(o){return typeof o=="string"||o instanceof String}J.string=e;function t(o){return typeof o=="number"||o instanceof Number}J.number=t;function r(o){return o instanceof Error}J.error=r;function i(o){return typeof o=="function"}J.func=i;function s(o){return Array.isArray(o)}J.array=s;function a(o){return s(o)&&o.every(l=>e(l))}return J.stringArray=a,J}var pt={},il;function tu(){if(il)return pt;il=1,Object.defineProperty(pt,"__esModule",{value:!0}),pt.Emitter=pt.Event=void 0;const n=eu();var e;(function(i){const s={dispose(){}};i.None=function(){return s}})(e||(pt.Event=e={}));class t{add(s,a=null,o){this._callbacks||(this._callbacks=[],this._contexts=[]),this._callbacks.push(s),this._contexts.push(a),Array.isArray(o)&&o.push({dispose:()=>this.remove(s,a)})}remove(s,a=null){if(!this._callbacks)return;let o=!1;for(let l=0,c=this._callbacks.length;l<c;l++)if(this._callbacks[l]===s)if(this._contexts[l]===a){this._callbacks.splice(l,1),this._contexts.splice(l,1);return}else o=!0;if(o)throw new Error("When adding a listener with a context, you should remove it with the same context")}invoke(...s){if(!this._callbacks)return[];const a=[],o=this._callbacks.slice(0),l=this._contexts.slice(0);for(let c=0,u=o.length;c<u;c++)try{a.push(o[c].apply(l[c],s))}catch(d){(0,n.default)().console.error(d)}return a}isEmpty(){return!this._callbacks||this._callbacks.length===0}dispose(){this._callbacks=void 0,this._contexts=void 0}}class r{constructor(s){this._options=s}get event(){return this._event||(this._event=(s,a,o)=>{this._callbacks||(this._callbacks=new t),this._options&&this._options.onFirstListenerAdd&&this._callbacks.isEmpty()&&this._options.onFirstListenerAdd(this),this._callbacks.add(s,a);const l={dispose:()=>{this._callbacks&&(this._callbacks.remove(s,a),l.dispose=r._noop,this._options&&this._options.onLastListenerRemove&&this._callbacks.isEmpty()&&this._options.onLastListenerRemove(this))}};return Array.isArray(o)&&o.push(l),l}),this._event}fire(s){this._callbacks&&this._callbacks.invoke.call(this._callbacks,s)}dispose(){this._callbacks&&(this._callbacks.dispose(),this._callbacks=void 0)}}return pt.Emitter=r,r._noop=function(){},pt}var sl;function xm(){if(sl)return ht;sl=1,Object.defineProperty(ht,"__esModule",{value:!0}),ht.CancellationTokenSource=ht.CancellationToken=void 0;const n=eu(),e=$m(),t=tu();var r;(function(o){o.None=Object.freeze({isCancellationRequested:!1,onCancellationRequested:t.Event.None}),o.Cancelled=Object.freeze({isCancellationRequested:!0,onCancellationRequested:t.Event.None});function l(c){const u=c;return u&&(u===o.None||u===o.Cancelled||e.boolean(u.isCancellationRequested)&&!!u.onCancellationRequested)}o.is=l})(r||(ht.CancellationToken=r={}));const i=Object.freeze(function(o,l){const c=(0,n.default)().timer.setTimeout(o.bind(l),0);return{dispose(){c.dispose()}}});class s{constructor(){this._isCancelled=!1}cancel(){this._isCancelled||(this._isCancelled=!0,this._emitter&&(this._emitter.fire(void 0),this.dispose()))}get isCancellationRequested(){return this._isCancelled}get onCancellationRequested(){return this._isCancelled?i:(this._emitter||(this._emitter=new t.Emitter),this._emitter.event)}dispose(){this._emitter&&(this._emitter.dispose(),this._emitter=void 0)}}class a{get token(){return this._token||(this._token=new s),this._token}cancel(){this._token?this._token.cancel():this._token=r.Cancelled}dispose(){this._token?this._token instanceof s&&this._token.dispose():this._token=r.None}}return ht.CancellationTokenSource=a,ht}var V=xm();function Sm(){return new Promise(n=>{typeof setImmediate>"u"?setTimeout(n,0):setImmediate(n)})}let Mr=0,Im=10;function Cm(){return Mr=performance.now(),new V.CancellationTokenSource}const ci=Symbol("OperationCancelled");function Si(n){return n===ci}async function Ae(n){if(n===V.CancellationToken.None)return;const e=performance.now();if(e-Mr>=Im&&(Mr=e,await Sm(),Mr=performance.now()),n.isCancellationRequested)throw ci}class da{constructor(){this.promise=new Promise((e,t)=>{this.resolve=r=>(e(r),this),this.reject=r=>(t(r),this)})}}class Qn{constructor(e,t,r,i){this._uri=e,this._languageId=t,this._version=r,this._content=i,this._lineOffsets=void 0}get uri(){return this._uri}get languageId(){return this._languageId}get version(){return this._version}getText(e){if(e){const t=this.offsetAt(e.start),r=this.offsetAt(e.end);return this._content.substring(t,r)}return this._content}update(e,t){for(const r of e)if(Qn.isIncremental(r)){const i=ru(r.range),s=this.offsetAt(i.start),a=this.offsetAt(i.end);this._content=this._content.substring(0,s)+r.text+this._content.substring(a,this._content.length);const o=Math.max(i.start.line,0),l=Math.max(i.end.line,0);let c=this._lineOffsets;const u=al(r.text,!1,s);if(l-o===u.length)for(let h=0,f=u.length;h<f;h++)c[h+o+1]=u[h];else u.length<1e4?c.splice(o+1,l-o,...u):this._lineOffsets=c=c.slice(0,o+1).concat(u,c.slice(l+1));const d=r.text.length-(a-s);if(d!==0)for(let h=o+1+u.length,f=c.length;h<f;h++)c[h]=c[h]+d}else if(Qn.isFull(r))this._content=r.text,this._lineOffsets=void 0;else throw new Error("Unknown change event received");this._version=t}getLineOffsets(){return this._lineOffsets===void 0&&(this._lineOffsets=al(this._content,!0)),this._lineOffsets}positionAt(e){e=Math.max(Math.min(e,this._content.length),0);const t=this.getLineOffsets();let r=0,i=t.length;if(i===0)return{line:0,character:e};for(;r<i;){const a=Math.floor((r+i)/2);t[a]>e?i=a:r=a+1}const s=r-1;return e=this.ensureBeforeEOL(e,t[s]),{line:s,character:e-t[s]}}offsetAt(e){const t=this.getLineOffsets();if(e.line>=t.length)return this._content.length;if(e.line<0)return 0;const r=t[e.line];if(e.character<=0)return r;const i=e.line+1<t.length?t[e.line+1]:this._content.length,s=Math.min(r+e.character,i);return this.ensureBeforeEOL(s,r)}ensureBeforeEOL(e,t){for(;e>t&&nu(this._content.charCodeAt(e-1));)e--;return e}get lineCount(){return this.getLineOffsets().length}static isIncremental(e){const t=e;return t!=null&&typeof t.text=="string"&&t.range!==void 0&&(t.rangeLength===void 0||typeof t.rangeLength=="number")}static isFull(e){const t=e;return t!=null&&typeof t.text=="string"&&t.range===void 0&&t.rangeLength===void 0}}var Ms;(function(n){function e(i,s,a,o){return new Qn(i,s,a,o)}n.create=e;function t(i,s,a){if(i instanceof Qn)return i.update(s,a),i;throw new Error("TextDocument.update: document must be created by TextDocument.create")}n.update=t;function r(i,s){const a=i.getText(),o=Ds(s.map(Nm),(u,d)=>{const h=u.range.start.line-d.range.start.line;return h===0?u.range.start.character-d.range.start.character:h});let l=0;const c=[];for(const u of o){const d=i.offsetAt(u.range.start);if(d<l)throw new Error("Overlapping edit");d>l&&c.push(a.substring(l,d)),u.newText.length&&c.push(u.newText),l=i.offsetAt(u.range.end)}return c.push(a.substr(l)),c.join("")}n.applyEdits=r})(Ms||(Ms={}));function Ds(n,e){if(n.length<=1)return n;const t=n.length/2|0,r=n.slice(0,t),i=n.slice(t);Ds(r,e),Ds(i,e);let s=0,a=0,o=0;for(;s<r.length&&a<i.length;)e(r[s],i[a])<=0?n[o++]=r[s++]:n[o++]=i[a++];for(;s<r.length;)n[o++]=r[s++];for(;a<i.length;)n[o++]=i[a++];return n}function al(n,e,t=0){const r=e?[t]:[];for(let i=0;i<n.length;i++){const s=n.charCodeAt(i);nu(s)&&(s===13&&i+1<n.length&&n.charCodeAt(i+1)===10&&i++,r.push(t+i+1))}return r}function nu(n){return n===13||n===10}function ru(n){const e=n.start,t=n.end;return e.line>t.line||e.line===t.line&&e.character>t.character?{start:t,end:e}:n}function Nm(n){const e=ru(n.range);return e!==n.range?{newText:n.newText,range:e}:n}var iu;(()=>{var n={470:i=>{function s(l){if(typeof l!="string")throw new TypeError("Path must be a string. Received "+JSON.stringify(l))}function a(l,c){for(var u,d="",h=0,f=-1,m=0,g=0;g<=l.length;++g){if(g<l.length)u=l.charCodeAt(g);else{if(u===47)break;u=47}if(u===47){if(!(f===g-1||m===1))if(f!==g-1&&m===2){if(d.length<2||h!==2||d.charCodeAt(d.length-1)!==46||d.charCodeAt(d.length-2)!==46){if(d.length>2){var A=d.lastIndexOf("/");if(A!==d.length-1){A===-1?(d="",h=0):h=(d=d.slice(0,A)).length-1-d.lastIndexOf("/"),f=g,m=0;continue}}else if(d.length===2||d.length===1){d="",h=0,f=g,m=0;continue}}c&&(d.length>0?d+="/..":d="..",h=2)}else d.length>0?d+="/"+l.slice(f+1,g):d=l.slice(f+1,g),h=g-f-1;f=g,m=0}else u===46&&m!==-1?++m:m=-1}return d}var o={resolve:function(){for(var l,c="",u=!1,d=arguments.length-1;d>=-1&&!u;d--){var h;d>=0?h=arguments[d]:(l===void 0&&(l=process.cwd()),h=l),s(h),h.length!==0&&(c=h+"/"+c,u=h.charCodeAt(0)===47)}return c=a(c,!u),u?c.length>0?"/"+c:"/":c.length>0?c:"."},normalize:function(l){if(s(l),l.length===0)return".";var c=l.charCodeAt(0)===47,u=l.charCodeAt(l.length-1)===47;return(l=a(l,!c)).length!==0||c||(l="."),l.length>0&&u&&(l+="/"),c?"/"+l:l},isAbsolute:function(l){return s(l),l.length>0&&l.charCodeAt(0)===47},join:function(){if(arguments.length===0)return".";for(var l,c=0;c<arguments.length;++c){var u=arguments[c];s(u),u.length>0&&(l===void 0?l=u:l+="/"+u)}return l===void 0?".":o.normalize(l)},relative:function(l,c){if(s(l),s(c),l===c||(l=o.resolve(l))===(c=o.resolve(c)))return"";for(var u=1;u<l.length&&l.charCodeAt(u)===47;++u);for(var d=l.length,h=d-u,f=1;f<c.length&&c.charCodeAt(f)===47;++f);for(var m=c.length-f,g=h<m?h:m,A=-1,T=0;T<=g;++T){if(T===g){if(m>g){if(c.charCodeAt(f+T)===47)return c.slice(f+T+1);if(T===0)return c.slice(f+T)}else h>g&&(l.charCodeAt(u+T)===47?A=T:T===0&&(A=0));break}var E=l.charCodeAt(u+T);if(E!==c.charCodeAt(f+T))break;E===47&&(A=T)}var R="";for(T=u+A+1;T<=d;++T)T!==d&&l.charCodeAt(T)!==47||(R.length===0?R+="..":R+="/..");return R.length>0?R+c.slice(f+A):(f+=A,c.charCodeAt(f)===47&&++f,c.slice(f))},_makeLong:function(l){return l},dirname:function(l){if(s(l),l.length===0)return".";for(var c=l.charCodeAt(0),u=c===47,d=-1,h=!0,f=l.length-1;f>=1;--f)if((c=l.charCodeAt(f))===47){if(!h){d=f;break}}else h=!1;return d===-1?u?"/":".":u&&d===1?"//":l.slice(0,d)},basename:function(l,c){if(c!==void 0&&typeof c!="string")throw new TypeError('"ext" argument must be a string');s(l);var u,d=0,h=-1,f=!0;if(c!==void 0&&c.length>0&&c.length<=l.length){if(c.length===l.length&&c===l)return"";var m=c.length-1,g=-1;for(u=l.length-1;u>=0;--u){var A=l.charCodeAt(u);if(A===47){if(!f){d=u+1;break}}else g===-1&&(f=!1,g=u+1),m>=0&&(A===c.charCodeAt(m)?--m==-1&&(h=u):(m=-1,h=g))}return d===h?h=g:h===-1&&(h=l.length),l.slice(d,h)}for(u=l.length-1;u>=0;--u)if(l.charCodeAt(u)===47){if(!f){d=u+1;break}}else h===-1&&(f=!1,h=u+1);return h===-1?"":l.slice(d,h)},extname:function(l){s(l);for(var c=-1,u=0,d=-1,h=!0,f=0,m=l.length-1;m>=0;--m){var g=l.charCodeAt(m);if(g!==47)d===-1&&(h=!1,d=m+1),g===46?c===-1?c=m:f!==1&&(f=1):c!==-1&&(f=-1);else if(!h){u=m+1;break}}return c===-1||d===-1||f===0||f===1&&c===d-1&&c===u+1?"":l.slice(c,d)},format:function(l){if(l===null||typeof l!="object")throw new TypeError('The "pathObject" argument must be of type Object. Received type '+typeof l);return(function(c,u){var d=u.dir||u.root,h=u.base||(u.name||"")+(u.ext||"");return d?d===u.root?d+h:d+"/"+h:h})(0,l)},parse:function(l){s(l);var c={root:"",dir:"",base:"",ext:"",name:""};if(l.length===0)return c;var u,d=l.charCodeAt(0),h=d===47;h?(c.root="/",u=1):u=0;for(var f=-1,m=0,g=-1,A=!0,T=l.length-1,E=0;T>=u;--T)if((d=l.charCodeAt(T))!==47)g===-1&&(A=!1,g=T+1),d===46?f===-1?f=T:E!==1&&(E=1):f!==-1&&(E=-1);else if(!A){m=T+1;break}return f===-1||g===-1||E===0||E===1&&f===g-1&&f===m+1?g!==-1&&(c.base=c.name=m===0&&h?l.slice(1,g):l.slice(m,g)):(m===0&&h?(c.name=l.slice(1,f),c.base=l.slice(1,g)):(c.name=l.slice(m,f),c.base=l.slice(m,g)),c.ext=l.slice(f,g)),m>0?c.dir=l.slice(0,m-1):h&&(c.dir="/"),c},sep:"/",delimiter:":",win32:null,posix:null};o.posix=o,i.exports=o}},e={};function t(i){var s=e[i];if(s!==void 0)return s.exports;var a=e[i]={exports:{}};return n[i](a,a.exports,t),a.exports}t.d=(i,s)=>{for(var a in s)t.o(s,a)&&!t.o(i,a)&&Object.defineProperty(i,a,{enumerable:!0,get:s[a]})},t.o=(i,s)=>Object.prototype.hasOwnProperty.call(i,s),t.r=i=>{typeof Symbol<"u"&&Symbol.toStringTag&&Object.defineProperty(i,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(i,"__esModule",{value:!0})};var r={};(()=>{let i;t.r(r),t.d(r,{URI:()=>h,Utils:()=>Ie}),typeof process=="object"?i=process.platform==="win32":typeof navigator=="object"&&(i=navigator.userAgent.indexOf("Windows")>=0);const s=/^\w[\w\d+.-]*$/,a=/^\//,o=/^\/\//;function l(k,y){if(!k.scheme&&y)throw new Error(`[UriError]: Scheme is missing: {scheme: "", authority: "${k.authority}", path: "${k.path}", query: "${k.query}", fragment: "${k.fragment}"}`);if(k.scheme&&!s.test(k.scheme))throw new Error("[UriError]: Scheme contains illegal characters.");if(k.path){if(k.authority){if(!a.test(k.path))throw new Error('[UriError]: If a URI contains an authority component, then the path component must either be empty or begin with a slash ("/") character')}else if(o.test(k.path))throw new Error('[UriError]: If a URI does not contain an authority component, then the path cannot begin with two slash characters ("//")')}}const c="",u="/",d=/^(([^:/?#]+?):)?(\/\/([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?/;class h{static isUri(y){return y instanceof h||!!y&&typeof y.authority=="string"&&typeof y.fragment=="string"&&typeof y.path=="string"&&typeof y.query=="string"&&typeof y.scheme=="string"&&typeof y.fsPath=="string"&&typeof y.with=="function"&&typeof y.toString=="function"}scheme;authority;path;query;fragment;constructor(y,S,x,b,L,_=!1){typeof y=="object"?(this.scheme=y.scheme||c,this.authority=y.authority||c,this.path=y.path||c,this.query=y.query||c,this.fragment=y.fragment||c):(this.scheme=(function(Te,q){return Te||q?Te:"file"})(y,_),this.authority=S||c,this.path=(function(Te,q){switch(Te){case"https":case"http":case"file":q?q[0]!==u&&(q=u+q):q=u}return q})(this.scheme,x||c),this.query=b||c,this.fragment=L||c,l(this,_))}get fsPath(){return E(this)}with(y){if(!y)return this;let{scheme:S,authority:x,path:b,query:L,fragment:_}=y;return S===void 0?S=this.scheme:S===null&&(S=c),x===void 0?x=this.authority:x===null&&(x=c),b===void 0?b=this.path:b===null&&(b=c),L===void 0?L=this.query:L===null&&(L=c),_===void 0?_=this.fragment:_===null&&(_=c),S===this.scheme&&x===this.authority&&b===this.path&&L===this.query&&_===this.fragment?this:new m(S,x,b,L,_)}static parse(y,S=!1){const x=d.exec(y);return x?new m(x[2]||c,ie(x[4]||c),ie(x[5]||c),ie(x[7]||c),ie(x[9]||c),S):new m(c,c,c,c,c)}static file(y){let S=c;if(i&&(y=y.replace(/\\/g,u)),y[0]===u&&y[1]===u){const x=y.indexOf(u,2);x===-1?(S=y.substring(2),y=u):(S=y.substring(2,x),y=y.substring(x)||u)}return new m("file",S,y,c,c)}static from(y){const S=new m(y.scheme,y.authority,y.path,y.query,y.fragment);return l(S,!0),S}toString(y=!1){return R(this,y)}toJSON(){return this}static revive(y){if(y){if(y instanceof h)return y;{const S=new m(y);return S._formatted=y.external,S._fsPath=y._sep===f?y.fsPath:null,S}}return y}}const f=i?1:void 0;class m extends h{_formatted=null;_fsPath=null;get fsPath(){return this._fsPath||(this._fsPath=E(this)),this._fsPath}toString(y=!1){return y?R(this,!0):(this._formatted||(this._formatted=R(this,!1)),this._formatted)}toJSON(){const y={$mid:1};return this._fsPath&&(y.fsPath=this._fsPath,y._sep=f),this._formatted&&(y.external=this._formatted),this.path&&(y.path=this.path),this.scheme&&(y.scheme=this.scheme),this.authority&&(y.authority=this.authority),this.query&&(y.query=this.query),this.fragment&&(y.fragment=this.fragment),y}}const g={58:"%3A",47:"%2F",63:"%3F",35:"%23",91:"%5B",93:"%5D",64:"%40",33:"%21",36:"%24",38:"%26",39:"%27",40:"%28",41:"%29",42:"%2A",43:"%2B",44:"%2C",59:"%3B",61:"%3D",32:"%20"};function A(k,y,S){let x,b=-1;for(let L=0;L<k.length;L++){const _=k.charCodeAt(L);if(_>=97&&_<=122||_>=65&&_<=90||_>=48&&_<=57||_===45||_===46||_===95||_===126||y&&_===47||S&&_===91||S&&_===93||S&&_===58)b!==-1&&(x+=encodeURIComponent(k.substring(b,L)),b=-1),x!==void 0&&(x+=k.charAt(L));else{x===void 0&&(x=k.substr(0,L));const Te=g[_];Te!==void 0?(b!==-1&&(x+=encodeURIComponent(k.substring(b,L)),b=-1),x+=Te):b===-1&&(b=L)}}return b!==-1&&(x+=encodeURIComponent(k.substring(b))),x!==void 0?x:k}function T(k){let y;for(let S=0;S<k.length;S++){const x=k.charCodeAt(S);x===35||x===63?(y===void 0&&(y=k.substr(0,S)),y+=g[x]):y!==void 0&&(y+=k[S])}return y!==void 0?y:k}function E(k,y){let S;return S=k.authority&&k.path.length>1&&k.scheme==="file"?`//${k.authority}${k.path}`:k.path.charCodeAt(0)===47&&(k.path.charCodeAt(1)>=65&&k.path.charCodeAt(1)<=90||k.path.charCodeAt(1)>=97&&k.path.charCodeAt(1)<=122)&&k.path.charCodeAt(2)===58?k.path[1].toLowerCase()+k.path.substr(2):k.path,i&&(S=S.replace(/\//g,"\\")),S}function R(k,y){const S=y?T:A;let x="",{scheme:b,authority:L,path:_,query:Te,fragment:q}=k;if(b&&(x+=b,x+=":"),(L||b==="file")&&(x+=u,x+=u),L){let K=L.indexOf("@");if(K!==-1){const ut=L.substr(0,K);L=L.substr(K+1),K=ut.lastIndexOf(":"),K===-1?x+=S(ut,!1,!1):(x+=S(ut.substr(0,K),!1,!1),x+=":",x+=S(ut.substr(K+1),!1,!0)),x+="@"}L=L.toLowerCase(),K=L.lastIndexOf(":"),K===-1?x+=S(L,!1,!0):(x+=S(L.substr(0,K),!1,!0),x+=L.substr(K))}if(_){if(_.length>=3&&_.charCodeAt(0)===47&&_.charCodeAt(2)===58){const K=_.charCodeAt(1);K>=65&&K<=90&&(_=`/${String.fromCharCode(K+32)}:${_.substr(3)}`)}else if(_.length>=2&&_.charCodeAt(1)===58){const K=_.charCodeAt(0);K>=65&&K<=90&&(_=`${String.fromCharCode(K+32)}:${_.substr(2)}`)}x+=S(_,!0,!1)}return Te&&(x+="?",x+=S(Te,!1,!1)),q&&(x+="#",x+=y?q:A(q,!1,!1)),x}function I(k){try{return decodeURIComponent(k)}catch{return k.length>3?k.substr(0,3)+I(k.substr(3)):k}}const F=/(%[0-9A-Za-z][0-9A-Za-z])+/g;function ie(k){return k.match(F)?k.replace(F,(y=>I(y))):k}var _e=t(470);const ye=_e.posix||_e,Fe="/";var Ie;(function(k){k.joinPath=function(y,...S){return y.with({path:ye.join(y.path,...S)})},k.resolvePath=function(y,...S){let x=y.path,b=!1;x[0]!==Fe&&(x=Fe+x,b=!0);let L=ye.resolve(x,...S);return b&&L[0]===Fe&&!y.authority&&(L=L.substring(1)),y.with({path:L})},k.dirname=function(y){if(y.path.length===0||y.path===Fe)return y;let S=ye.dirname(y.path);return S.length===1&&S.charCodeAt(0)===46&&(S=""),y.with({path:S})},k.basename=function(y){return ye.basename(y.path)},k.extname=function(y){return ye.extname(y.path)}})(Ie||(Ie={}))})(),iu=r})();const{URI:At,Utils:dn}=iu;var rt;(function(n){n.basename=dn.basename,n.dirname=dn.dirname,n.extname=dn.extname,n.joinPath=dn.joinPath,n.resolvePath=dn.resolvePath;function e(i,s){return i?.toString()===s?.toString()}n.equals=e;function t(i,s){const a=typeof i=="string"?i:i.path,o=typeof s=="string"?s:s.path,l=a.split("/").filter(f=>f.length>0),c=o.split("/").filter(f=>f.length>0);let u=0;for(;u<l.length&&l[u]===c[u];u++);const d="../".repeat(l.length-u),h=c.slice(u).join("/");return d+h}n.relative=t;function r(i){return At.parse(i.toString()).toString()}n.normalize=r})(rt||(rt={}));var U;(function(n){n[n.Changed=0]="Changed",n[n.Parsed=1]="Parsed",n[n.IndexedContent=2]="IndexedContent",n[n.ComputedScopes=3]="ComputedScopes",n[n.Linked=4]="Linked",n[n.IndexedReferences=5]="IndexedReferences",n[n.Validated=6]="Validated"})(U||(U={}));class wm{constructor(e){this.serviceRegistry=e.ServiceRegistry,this.textDocuments=e.workspace.TextDocuments,this.fileSystemProvider=e.workspace.FileSystemProvider}async fromUri(e,t=V.CancellationToken.None){const r=await this.fileSystemProvider.readFile(e);return this.createAsync(e,r,t)}fromTextDocument(e,t,r){return t=t??At.parse(e.uri),V.CancellationToken.is(r)?this.createAsync(t,e,r):this.create(t,e,r)}fromString(e,t,r){return V.CancellationToken.is(r)?this.createAsync(t,e,r):this.create(t,e,r)}fromModel(e,t){return this.create(t,{$model:e})}create(e,t,r){if(typeof t=="string"){const i=this.parse(e,t,r);return this.createLangiumDocument(i,e,void 0,t)}else if("$model"in t){const i={value:t.$model,parserErrors:[],lexerErrors:[]};return this.createLangiumDocument(i,e)}else{const i=this.parse(e,t.getText(),r);return this.createLangiumDocument(i,e,t)}}async createAsync(e,t,r){if(typeof t=="string"){const i=await this.parseAsync(e,t,r);return this.createLangiumDocument(i,e,void 0,t)}else{const i=await this.parseAsync(e,t.getText(),r);return this.createLangiumDocument(i,e,t)}}createLangiumDocument(e,t,r,i){let s;if(r)s={parseResult:e,uri:t,state:U.Parsed,references:[],textDocument:r};else{const a=this.createTextDocumentGetter(t,i);s={parseResult:e,uri:t,state:U.Parsed,references:[],get textDocument(){return a()}}}return e.value.$document=s,s}async update(e,t){var r,i;const s=(r=e.parseResult.value.$cstNode)===null||r===void 0?void 0:r.root.fullText,a=(i=this.textDocuments)===null||i===void 0?void 0:i.get(e.uri.toString()),o=a?a.getText():await this.fileSystemProvider.readFile(e.uri);if(a)Object.defineProperty(e,"textDocument",{value:a});else{const l=this.createTextDocumentGetter(e.uri,o);Object.defineProperty(e,"textDocument",{get:l})}return s!==o&&(e.parseResult=await this.parseAsync(e.uri,o,t),e.parseResult.value.$document=e),e.state=U.Parsed,e}parse(e,t,r){return this.serviceRegistry.getServices(e).parser.LangiumParser.parse(t,r)}parseAsync(e,t,r){return this.serviceRegistry.getServices(e).parser.AsyncParser.parse(t,r)}createTextDocumentGetter(e,t){const r=this.serviceRegistry;let i;return()=>i??(i=Ms.create(e.toString(),r.getServices(e).LanguageMetaData.languageId,0,t??""))}}class _m{constructor(e){this.documentMap=new Map,this.langiumDocumentFactory=e.workspace.LangiumDocumentFactory,this.serviceRegistry=e.ServiceRegistry}get all(){return ee(this.documentMap.values())}addDocument(e){const t=e.uri.toString();if(this.documentMap.has(t))throw new Error(`A document with the URI '${t}' is already present.`);this.documentMap.set(t,e)}getDocument(e){const t=e.toString();return this.documentMap.get(t)}async getOrCreateDocument(e,t){let r=this.getDocument(e);return r||(r=await this.langiumDocumentFactory.fromUri(e,t),this.addDocument(r),r)}createDocument(e,t,r){if(r)return this.langiumDocumentFactory.fromString(t,e,r).then(i=>(this.addDocument(i),i));{const i=this.langiumDocumentFactory.fromString(t,e);return this.addDocument(i),i}}hasDocument(e){return this.documentMap.has(e.toString())}invalidateDocument(e){const t=e.toString(),r=this.documentMap.get(t);return r&&(this.serviceRegistry.getServices(e).references.Linker.unlink(r),r.state=U.Changed,r.precomputedScopes=void 0,r.diagnostics=void 0),r}deleteDocument(e){const t=e.toString(),r=this.documentMap.get(t);return r&&(r.state=U.Changed,this.documentMap.delete(t)),r}}const Wi=Symbol("ref_resolving");class Lm{constructor(e){this.reflection=e.shared.AstReflection,this.langiumDocuments=()=>e.shared.workspace.LangiumDocuments,this.scopeProvider=e.references.ScopeProvider,this.astNodeLocator=e.workspace.AstNodeLocator}async link(e,t=V.CancellationToken.None){for(const r of _t(e.parseResult.value))await Ae(t),Kl(r).forEach(i=>this.doLink(i,e))}doLink(e,t){var r;const i=e.reference;if(i._ref===void 0){i._ref=Wi;try{const s=this.getCandidate(e);if(Nr(s))i._ref=s;else if(i._nodeDescription=s,this.langiumDocuments().hasDocument(s.documentUri)){const a=this.loadAstNode(s);i._ref=a??this.createLinkingError(e,s)}else i._ref=void 0}catch(s){console.error(`An error occurred while resolving reference to '${i.$refText}':`,s);const a=(r=s.message)!==null&&r!==void 0?r:String(s);i._ref=Object.assign(Object.assign({},e),{message:`An error occurred while resolving reference to '${i.$refText}': ${a}`})}t.references.push(i)}}unlink(e){for(const t of e.references)delete t._ref,delete t._nodeDescription;e.references=[]}getCandidate(e){const r=this.scopeProvider.getScope(e).getElement(e.reference.$refText);return r??this.createLinkingError(e)}buildReference(e,t,r,i){const s=this,a={$refNode:r,$refText:i,get ref(){var o;if(ae(this._ref))return this._ref;if(pd(this._nodeDescription)){const l=s.loadAstNode(this._nodeDescription);this._ref=l??s.createLinkingError({reference:a,container:e,property:t},this._nodeDescription)}else if(this._ref===void 0){this._ref=Wi;const l=os(e).$document,c=s.getLinkedNode({reference:a,container:e,property:t});if(c.error&&l&&l.state<U.ComputedScopes)return this._ref=void 0;this._ref=(o=c.node)!==null&&o!==void 0?o:c.error,this._nodeDescription=c.descr,l?.references.push(this)}else if(this._ref===Wi)throw new Error(`Cyclic reference resolution detected: ${s.astNodeLocator.getAstNodePath(e)}/${t} (symbol '${i}')`);return ae(this._ref)?this._ref:void 0},get $nodeDescription(){return this._nodeDescription},get error(){return Nr(this._ref)?this._ref:void 0}};return a}getLinkedNode(e){var t;try{const r=this.getCandidate(e);if(Nr(r))return{error:r};const i=this.loadAstNode(r);return i?{node:i,descr:r}:{descr:r,error:this.createLinkingError(e,r)}}catch(r){console.error(`An error occurred while resolving reference to '${e.reference.$refText}':`,r);const i=(t=r.message)!==null&&t!==void 0?t:String(r);return{error:Object.assign(Object.assign({},e),{message:`An error occurred while resolving reference to '${e.reference.$refText}': ${i}`})}}}loadAstNode(e){if(e.node)return e.node;const t=this.langiumDocuments().getDocument(e.documentUri);if(t)return this.astNodeLocator.getAstNode(t.parseResult.value,e.path)}createLinkingError(e,t){const r=os(e.container).$document;r&&r.state<U.ComputedScopes&&console.warn(`Attempted reference resolution before document reached ComputedScopes state (${r.uri}).`);const i=this.reflection.getReferenceType(e);return Object.assign(Object.assign({},e),{message:`Could not resolve reference to ${i} named '${e.reference.$refText}'.`,targetDescription:t})}}function bm(n){return typeof n.name=="string"}class Om{getName(e){if(bm(e))return e.name}getNameNode(e){return ql(e.$cstNode,"name")}}class Pm{constructor(e){this.nameProvider=e.references.NameProvider,this.index=e.shared.workspace.IndexManager,this.nodeLocator=e.workspace.AstNodeLocator}findDeclaration(e){if(e){const t=of(e),r=e.astNode;if(t&&r){const i=r[t.feature];if(Ue(i))return i.ref;if(Array.isArray(i)){for(const s of i)if(Ue(s)&&s.$refNode&&s.$refNode.offset<=e.offset&&s.$refNode.end>=e.end)return s.ref}}if(r){const i=this.nameProvider.getNameNode(r);if(i&&(i===e||yd(e,i)))return r}}}findDeclarationNode(e){const t=this.findDeclaration(e);if(t?.$cstNode){const r=this.nameProvider.getNameNode(t);return r??t.$cstNode}}findReferences(e,t){const r=[];if(t.includeDeclaration){const s=this.getReferenceToSelf(e);s&&r.push(s)}let i=this.index.findAllReferences(e,this.nodeLocator.getAstNodePath(e));return t.documentUri&&(i=i.filter(s=>rt.equals(s.sourceUri,t.documentUri))),r.push(...i),ee(r)}getReferenceToSelf(e){const t=this.nameProvider.getNameNode(e);if(t){const r=Ze(e),i=this.nodeLocator.getAstNodePath(e);return{sourceUri:r.uri,sourcePath:i,targetUri:r.uri,targetPath:i,segment:jr(t),local:!0}}}}class ui{constructor(e){if(this.map=new Map,e)for(const[t,r]of e)this.add(t,r)}get size(){return is.sum(ee(this.map.values()).map(e=>e.length))}clear(){this.map.clear()}delete(e,t){if(t===void 0)return this.map.delete(e);{const r=this.map.get(e);if(r){const i=r.indexOf(t);if(i>=0)return r.length===1?this.map.delete(e):r.splice(i,1),!0}return!1}}get(e){var t;return(t=this.map.get(e))!==null&&t!==void 0?t:[]}has(e,t){if(t===void 0)return this.map.has(e);{const r=this.map.get(e);return r?r.indexOf(t)>=0:!1}}add(e,t){return this.map.has(e)?this.map.get(e).push(t):this.map.set(e,[t]),this}addAll(e,t){return this.map.has(e)?this.map.get(e).push(...t):this.map.set(e,Array.from(t)),this}forEach(e){this.map.forEach((t,r)=>t.forEach(i=>e(i,r,this)))}[Symbol.iterator](){return this.entries().iterator()}entries(){return ee(this.map.entries()).flatMap(([e,t])=>t.map(r=>[e,r]))}keys(){return ee(this.map.keys())}values(){return ee(this.map.values()).flat()}entriesGroupedByKey(){return ee(this.map.entries())}}class ol{get size(){return this.map.size}constructor(e){if(this.map=new Map,this.inverse=new Map,e)for(const[t,r]of e)this.set(t,r)}clear(){this.map.clear(),this.inverse.clear()}set(e,t){return this.map.set(e,t),this.inverse.set(t,e),this}get(e){return this.map.get(e)}getKey(e){return this.inverse.get(e)}delete(e){const t=this.map.get(e);return t!==void 0?(this.map.delete(e),this.inverse.delete(t),!0):!1}}class Mm{constructor(e){this.nameProvider=e.references.NameProvider,this.descriptions=e.workspace.AstNodeDescriptionProvider}async computeExports(e,t=V.CancellationToken.None){return this.computeExportsForNode(e.parseResult.value,e,void 0,t)}async computeExportsForNode(e,t,r=zs,i=V.CancellationToken.None){const s=[];this.exportNode(e,s,t);for(const a of r(e))await Ae(i),this.exportNode(a,s,t);return s}exportNode(e,t,r){const i=this.nameProvider.getName(e);i&&t.push(this.descriptions.createDescription(e,i,r))}async computeLocalScopes(e,t=V.CancellationToken.None){const r=e.parseResult.value,i=new ui;for(const s of tr(r))await Ae(t),this.processNode(s,e,i);return i}processNode(e,t,r){const i=e.$container;if(i){const s=this.nameProvider.getName(e);s&&r.add(i,this.descriptions.createDescription(e,s,t))}}}class ll{constructor(e,t,r){var i;this.elements=e,this.outerScope=t,this.caseInsensitive=(i=r?.caseInsensitive)!==null&&i!==void 0?i:!1}getAllElements(){return this.outerScope?this.elements.concat(this.outerScope.getAllElements()):this.elements}getElement(e){const t=this.caseInsensitive?this.elements.find(r=>r.name.toLowerCase()===e.toLowerCase()):this.elements.find(r=>r.name===e);if(t)return t;if(this.outerScope)return this.outerScope.getElement(e)}}class Dm{constructor(e,t,r){var i;this.elements=new Map,this.caseInsensitive=(i=r?.caseInsensitive)!==null&&i!==void 0?i:!1;for(const s of e){const a=this.caseInsensitive?s.name.toLowerCase():s.name;this.elements.set(a,s)}this.outerScope=t}getElement(e){const t=this.caseInsensitive?e.toLowerCase():e,r=this.elements.get(t);if(r)return r;if(this.outerScope)return this.outerScope.getElement(e)}getAllElements(){let e=ee(this.elements.values());return this.outerScope&&(e=e.concat(this.outerScope.getAllElements())),e}}class su{constructor(){this.toDispose=[],this.isDisposed=!1}onDispose(e){this.toDispose.push(e)}dispose(){this.throwIfDisposed(),this.clear(),this.isDisposed=!0,this.toDispose.forEach(e=>e.dispose())}throwIfDisposed(){if(this.isDisposed)throw new Error("This cache has already been disposed")}}class Fm extends su{constructor(){super(...arguments),this.cache=new Map}has(e){return this.throwIfDisposed(),this.cache.has(e)}set(e,t){this.throwIfDisposed(),this.cache.set(e,t)}get(e,t){if(this.throwIfDisposed(),this.cache.has(e))return this.cache.get(e);if(t){const r=t();return this.cache.set(e,r),r}else return}delete(e){return this.throwIfDisposed(),this.cache.delete(e)}clear(){this.throwIfDisposed(),this.cache.clear()}}class Gm extends su{constructor(e){super(),this.cache=new Map,this.converter=e??(t=>t)}has(e,t){return this.throwIfDisposed(),this.cacheForContext(e).has(t)}set(e,t,r){this.throwIfDisposed(),this.cacheForContext(e).set(t,r)}get(e,t,r){this.throwIfDisposed();const i=this.cacheForContext(e);if(i.has(t))return i.get(t);if(r){const s=r();return i.set(t,s),s}else return}delete(e,t){return this.throwIfDisposed(),this.cacheForContext(e).delete(t)}clear(e){if(this.throwIfDisposed(),e){const t=this.converter(e);this.cache.delete(t)}else this.cache.clear()}cacheForContext(e){const t=this.converter(e);let r=this.cache.get(t);return r||(r=new Map,this.cache.set(t,r)),r}}class Um extends Fm{constructor(e,t){super(),t?(this.toDispose.push(e.workspace.DocumentBuilder.onBuildPhase(t,()=>{this.clear()})),this.toDispose.push(e.workspace.DocumentBuilder.onUpdate((r,i)=>{i.length>0&&this.clear()}))):this.toDispose.push(e.workspace.DocumentBuilder.onUpdate(()=>{this.clear()}))}}class Bm{constructor(e){this.reflection=e.shared.AstReflection,this.nameProvider=e.references.NameProvider,this.descriptions=e.workspace.AstNodeDescriptionProvider,this.indexManager=e.shared.workspace.IndexManager,this.globalScopeCache=new Um(e.shared)}getScope(e){const t=[],r=this.reflection.getReferenceType(e),i=Ze(e.container).precomputedScopes;if(i){let a=e.container;do{const o=i.get(a);o.length>0&&t.push(ee(o).filter(l=>this.reflection.isSubtype(l.type,r))),a=a.$container}while(a)}let s=this.getGlobalScope(r,e);for(let a=t.length-1;a>=0;a--)s=this.createScope(t[a],s);return s}createScope(e,t,r){return new ll(ee(e),t,r)}createScopeForNodes(e,t,r){const i=ee(e).map(s=>{const a=this.nameProvider.getName(s);if(a)return this.descriptions.createDescription(s,a)}).nonNullable();return new ll(i,t,r)}getGlobalScope(e,t){return this.globalScopeCache.get(e,()=>new Dm(this.indexManager.allElements(e)))}}function Vm(n){return typeof n.$comment=="string"}function cl(n){return typeof n=="object"&&!!n&&("$ref"in n||"$error"in n)}class Km{constructor(e){this.ignoreProperties=new Set(["$container","$containerProperty","$containerIndex","$document","$cstNode"]),this.langiumDocuments=e.shared.workspace.LangiumDocuments,this.astNodeLocator=e.workspace.AstNodeLocator,this.nameProvider=e.references.NameProvider,this.commentProvider=e.documentation.CommentProvider}serialize(e,t){const r=t??{},i=t?.replacer,s=(o,l)=>this.replacer(o,l,r),a=i?(o,l)=>i(o,l,s):s;try{return this.currentDocument=Ze(e),JSON.stringify(e,a,t?.space)}finally{this.currentDocument=void 0}}deserialize(e,t){const r=t??{},i=JSON.parse(e);return this.linkNode(i,i,r),i}replacer(e,t,{refText:r,sourceText:i,textRegions:s,comments:a,uriConverter:o}){var l,c,u,d;if(!this.ignoreProperties.has(e))if(Ue(t)){const h=t.ref,f=r?t.$refText:void 0;if(h){const m=Ze(h);let g="";this.currentDocument&&this.currentDocument!==m&&(o?g=o(m.uri,t):g=m.uri.toString());const A=this.astNodeLocator.getAstNodePath(h);return{$ref:`${g}#${A}`,$refText:f}}else return{$error:(c=(l=t.error)===null||l===void 0?void 0:l.message)!==null&&c!==void 0?c:"Could not resolve reference",$refText:f}}else if(ae(t)){let h;if(s&&(h=this.addAstNodeRegionWithAssignmentsTo(Object.assign({},t)),(!e||t.$document)&&h?.$textRegion&&(h.$textRegion.documentURI=(u=this.currentDocument)===null||u===void 0?void 0:u.uri.toString())),i&&!e&&(h??(h=Object.assign({},t)),h.$sourceText=(d=t.$cstNode)===null||d===void 0?void 0:d.text),a){h??(h=Object.assign({},t));const f=this.commentProvider.getComment(t);f&&(h.$comment=f.replace(/\r/g,""))}return h??t}else return t}addAstNodeRegionWithAssignmentsTo(e){const t=r=>({offset:r.offset,end:r.end,length:r.length,range:r.range});if(e.$cstNode){const r=e.$textRegion=t(e.$cstNode),i=r.assignments={};return Object.keys(e).filter(s=>!s.startsWith("$")).forEach(s=>{const a=rf(e.$cstNode,s).map(t);a.length!==0&&(i[s]=a)}),e}}linkNode(e,t,r,i,s,a){for(const[l,c]of Object.entries(e))if(Array.isArray(c))for(let u=0;u<c.length;u++){const d=c[u];cl(d)?c[u]=this.reviveReference(e,l,t,d,r):ae(d)&&this.linkNode(d,t,r,e,l,u)}else cl(c)?e[l]=this.reviveReference(e,l,t,c,r):ae(c)&&this.linkNode(c,t,r,e,l);const o=e;o.$container=i,o.$containerProperty=s,o.$containerIndex=a}reviveReference(e,t,r,i,s){let a=i.$refText,o=i.$error;if(i.$ref){const l=this.getRefNode(r,i.$ref,s.uriConverter);if(ae(l))return a||(a=this.nameProvider.getName(l)),{$refText:a??"",ref:l};o=l}if(o){const l={$refText:a??""};return l.error={container:e,property:t,message:o,reference:l},l}else return}getRefNode(e,t,r){try{const i=t.indexOf("#");if(i===0){const l=this.astNodeLocator.getAstNode(e,t.substring(1));return l||"Could not resolve path: "+t}if(i<0){const l=r?r(t):At.parse(t),c=this.langiumDocuments.getDocument(l);return c?c.parseResult.value:"Could not find document for URI: "+t}const s=r?r(t.substring(0,i)):At.parse(t.substring(0,i)),a=this.langiumDocuments.getDocument(s);if(!a)return"Could not find document for URI: "+t;if(i===t.length-1)return a.parseResult.value;const o=this.astNodeLocator.getAstNode(a.parseResult.value,t.substring(i+1));return o||"Could not resolve URI: "+t}catch(i){return String(i)}}}class Wm{get map(){return this.fileExtensionMap}constructor(e){this.languageIdMap=new Map,this.fileExtensionMap=new Map,this.textDocuments=e?.workspace.TextDocuments}register(e){const t=e.LanguageMetaData;for(const r of t.fileExtensions)this.fileExtensionMap.has(r)&&console.warn(`The file extension ${r} is used by multiple languages. It is now assigned to '${t.languageId}'.`),this.fileExtensionMap.set(r,e);this.languageIdMap.set(t.languageId,e),this.languageIdMap.size===1?this.singleton=e:this.singleton=void 0}getServices(e){var t,r;if(this.singleton!==void 0)return this.singleton;if(this.languageIdMap.size===0)throw new Error("The service registry is empty. Use `register` to register the services of a language.");const i=(r=(t=this.textDocuments)===null||t===void 0?void 0:t.get(e))===null||r===void 0?void 0:r.languageId;if(i!==void 0){const o=this.languageIdMap.get(i);if(o)return o}const s=rt.extname(e),a=this.fileExtensionMap.get(s);if(!a)throw i?new Error(`The service registry contains no services for the extension '${s}' for language '${i}'.`):new Error(`The service registry contains no services for the extension '${s}'.`);return a}hasServices(e){try{return this.getServices(e),!0}catch{return!1}}get all(){return Array.from(this.languageIdMap.values())}}function Kn(n){return{code:n}}var di;(function(n){n.all=["fast","slow","built-in"]})(di||(di={}));class jm{constructor(e){this.entries=new ui,this.entriesBefore=[],this.entriesAfter=[],this.reflection=e.shared.AstReflection}register(e,t=this,r="fast"){if(r==="built-in")throw new Error("The 'built-in' category is reserved for lexer, parser, and linker errors.");for(const[i,s]of Object.entries(e)){const a=s;if(Array.isArray(a))for(const o of a){const l={check:this.wrapValidationException(o,t),category:r};this.addEntry(i,l)}else if(typeof a=="function"){const o={check:this.wrapValidationException(a,t),category:r};this.addEntry(i,o)}else er()}}wrapValidationException(e,t){return async(r,i,s)=>{await this.handleException(()=>e.call(t,r,i,s),"An error occurred during validation",i,r)}}async handleException(e,t,r,i){try{await e()}catch(s){if(Si(s))throw s;console.error(`${t}:`,s),s instanceof Error&&s.stack&&console.error(s.stack);const a=s instanceof Error?s.message:String(s);r("error",`${t}: ${a}`,{node:i})}}addEntry(e,t){if(e==="AstNode"){this.entries.add("AstNode",t);return}for(const r of this.reflection.getAllSubTypes(e))this.entries.add(r,t)}getChecks(e,t){let r=ee(this.entries.get(e)).concat(this.entries.get("AstNode"));return t&&(r=r.filter(i=>t.includes(i.category))),r.map(i=>i.check)}registerBeforeDocument(e,t=this){this.entriesBefore.push(this.wrapPreparationException(e,"An error occurred during set-up of the validation",t))}registerAfterDocument(e,t=this){this.entriesAfter.push(this.wrapPreparationException(e,"An error occurred during tear-down of the validation",t))}wrapPreparationException(e,t,r){return async(i,s,a,o)=>{await this.handleException(()=>e.call(r,i,s,a,o),t,s,i)}}get checksBefore(){return this.entriesBefore}get checksAfter(){return this.entriesAfter}}class Hm{constructor(e){this.validationRegistry=e.validation.ValidationRegistry,this.metadata=e.LanguageMetaData}async validateDocument(e,t={},r=V.CancellationToken.None){const i=e.parseResult,s=[];if(await Ae(r),(!t.categories||t.categories.includes("built-in"))&&(this.processLexingErrors(i,s,t),t.stopAfterLexingErrors&&s.some(a=>{var o;return((o=a.data)===null||o===void 0?void 0:o.code)===be.LexingError})||(this.processParsingErrors(i,s,t),t.stopAfterParsingErrors&&s.some(a=>{var o;return((o=a.data)===null||o===void 0?void 0:o.code)===be.ParsingError}))||(this.processLinkingErrors(e,s,t),t.stopAfterLinkingErrors&&s.some(a=>{var o;return((o=a.data)===null||o===void 0?void 0:o.code)===be.LinkingError}))))return s;try{s.push(...await this.validateAst(i.value,t,r))}catch(a){if(Si(a))throw a;console.error("An error occurred during validation:",a)}return await Ae(r),s}processLexingErrors(e,t,r){var i,s,a;const o=[...e.lexerErrors,...(s=(i=e.lexerReport)===null||i===void 0?void 0:i.diagnostics)!==null&&s!==void 0?s:[]];for(const l of o){const c=(a=l.severity)!==null&&a!==void 0?a:"error",u={severity:ji(c),range:{start:{line:l.line-1,character:l.column-1},end:{line:l.line-1,character:l.column+l.length-1}},message:l.message,data:qm(c),source:this.getSource()};t.push(u)}}processParsingErrors(e,t,r){for(const i of e.parserErrors){let s;if(isNaN(i.token.startOffset)){if("previousToken"in i){const a=i.previousToken;if(isNaN(a.startOffset)){const o={line:0,character:0};s={start:o,end:o}}else{const o={line:a.endLine-1,character:a.endColumn};s={start:o,end:o}}}}else s=as(i.token);if(s){const a={severity:ji("error"),range:s,message:i.message,data:Kn(be.ParsingError),source:this.getSource()};t.push(a)}}}processLinkingErrors(e,t,r){for(const i of e.references){const s=i.error;if(s){const a={node:s.container,property:s.property,index:s.index,data:{code:be.LinkingError,containerType:s.container.$type,property:s.property,refText:s.reference.$refText}};t.push(this.toDiagnostic("error",s.message,a))}}}async validateAst(e,t,r=V.CancellationToken.None){const i=[],s=(a,o,l)=>{i.push(this.toDiagnostic(a,o,l))};return await this.validateAstBefore(e,t,s,r),await this.validateAstNodes(e,t,s,r),await this.validateAstAfter(e,t,s,r),i}async validateAstBefore(e,t,r,i=V.CancellationToken.None){var s;const a=this.validationRegistry.checksBefore;for(const o of a)await Ae(i),await o(e,r,(s=t.categories)!==null&&s!==void 0?s:[],i)}async validateAstNodes(e,t,r,i=V.CancellationToken.None){await Promise.all(_t(e).map(async s=>{await Ae(i);const a=this.validationRegistry.getChecks(s.$type,t.categories);for(const o of a)await o(s,r,i)}))}async validateAstAfter(e,t,r,i=V.CancellationToken.None){var s;const a=this.validationRegistry.checksAfter;for(const o of a)await Ae(i),await o(e,r,(s=t.categories)!==null&&s!==void 0?s:[],i)}toDiagnostic(e,t,r){return{message:t,range:zm(r),severity:ji(e),code:r.code,codeDescription:r.codeDescription,tags:r.tags,relatedInformation:r.relatedInformation,data:r.data,source:this.getSource()}}getSource(){return this.metadata.languageId}}function zm(n){if(n.range)return n.range;let e;return typeof n.property=="string"?e=ql(n.node.$cstNode,n.property,n.index):typeof n.keyword=="string"&&(e=sf(n.node.$cstNode,n.keyword,n.index)),e??(e=n.node.$cstNode),e?e.range:{start:{line:0,character:0},end:{line:0,character:0}}}function ji(n){switch(n){case"error":return 1;case"warning":return 2;case"info":return 3;case"hint":return 4;default:throw new Error("Invalid diagnostic severity: "+n)}}function qm(n){switch(n){case"error":return Kn(be.LexingError);case"warning":return Kn(be.LexingWarning);case"info":return Kn(be.LexingInfo);case"hint":return Kn(be.LexingHint);default:throw new Error("Invalid diagnostic severity: "+n)}}var be;(function(n){n.LexingError="lexing-error",n.LexingWarning="lexing-warning",n.LexingInfo="lexing-info",n.LexingHint="lexing-hint",n.ParsingError="parsing-error",n.LinkingError="linking-error"})(be||(be={}));class Ym{constructor(e){this.astNodeLocator=e.workspace.AstNodeLocator,this.nameProvider=e.references.NameProvider}createDescription(e,t,r){const i=r??Ze(e);t??(t=this.nameProvider.getName(e));const s=this.astNodeLocator.getAstNodePath(e);if(!t)throw new Error(`Node at path ${s} has no name.`);let a;const o=()=>{var l;return a??(a=jr((l=this.nameProvider.getNameNode(e))!==null&&l!==void 0?l:e.$cstNode))};return{node:e,name:t,get nameSegment(){return o()},selectionSegment:jr(e.$cstNode),type:e.$type,documentUri:i.uri,path:s}}}class Xm{constructor(e){this.nodeLocator=e.workspace.AstNodeLocator}async createDescriptions(e,t=V.CancellationToken.None){const r=[],i=e.parseResult.value;for(const s of _t(i))await Ae(t),Kl(s).filter(a=>!Nr(a)).forEach(a=>{const o=this.createDescription(a);o&&r.push(o)});return r}createDescription(e){const t=e.reference.$nodeDescription,r=e.reference.$refNode;if(!t||!r)return;const i=Ze(e.container).uri;return{sourceUri:i,sourcePath:this.nodeLocator.getAstNodePath(e.container),targetUri:t.documentUri,targetPath:t.path,segment:jr(r),local:rt.equals(t.documentUri,i)}}}class Jm{constructor(){this.segmentSeparator="/",this.indexSeparator="@"}getAstNodePath(e){if(e.$container){const t=this.getAstNodePath(e.$container),r=this.getPathSegment(e);return t+this.segmentSeparator+r}return""}getPathSegment({$containerProperty:e,$containerIndex:t}){if(!e)throw new Error("Missing '$containerProperty' in AST node.");return t!==void 0?e+this.indexSeparator+t:e}getAstNode(e,t){return t.split(this.segmentSeparator).reduce((i,s)=>{if(!i||s.length===0)return i;const a=s.indexOf(this.indexSeparator);if(a>0){const o=s.substring(0,a),l=parseInt(s.substring(a+1)),c=i[o];return c?.[l]}return i[s]},e)}}var Qm=tu();class Zm{constructor(e){this._ready=new da,this.settings={},this.workspaceConfig=!1,this.onConfigurationSectionUpdateEmitter=new Qm.Emitter,this.serviceRegistry=e.ServiceRegistry}get ready(){return this._ready.promise}initialize(e){var t,r;this.workspaceConfig=(r=(t=e.capabilities.workspace)===null||t===void 0?void 0:t.configuration)!==null&&r!==void 0?r:!1}async initialized(e){if(this.workspaceConfig){if(e.register){const t=this.serviceRegistry.all;e.register({section:t.map(r=>this.toSectionName(r.LanguageMetaData.languageId))})}if(e.fetchConfiguration){const t=this.serviceRegistry.all.map(i=>({section:this.toSectionName(i.LanguageMetaData.languageId)})),r=await e.fetchConfiguration(t);t.forEach((i,s)=>{this.updateSectionConfiguration(i.section,r[s])})}}this._ready.resolve()}updateConfiguration(e){e.settings&&Object.keys(e.settings).forEach(t=>{const r=e.settings[t];this.updateSectionConfiguration(t,r),this.onConfigurationSectionUpdateEmitter.fire({section:t,configuration:r})})}updateSectionConfiguration(e,t){this.settings[e]=t}async getConfiguration(e,t){await this.ready;const r=this.toSectionName(e);if(this.settings[r])return this.settings[r][t]}toSectionName(e){return`${e}`}get onConfigurationSectionUpdate(){return this.onConfigurationSectionUpdateEmitter.event}}var qn;(function(n){function e(t){return{dispose:async()=>await t()}}n.create=e})(qn||(qn={}));class eg{constructor(e){this.updateBuildOptions={validation:{categories:["built-in","fast"]}},this.updateListeners=[],this.buildPhaseListeners=new ui,this.documentPhaseListeners=new ui,this.buildState=new Map,this.documentBuildWaiters=new Map,this.currentState=U.Changed,this.langiumDocuments=e.workspace.LangiumDocuments,this.langiumDocumentFactory=e.workspace.LangiumDocumentFactory,this.textDocuments=e.workspace.TextDocuments,this.indexManager=e.workspace.IndexManager,this.serviceRegistry=e.ServiceRegistry}async build(e,t={},r=V.CancellationToken.None){var i,s;for(const a of e){const o=a.uri.toString();if(a.state===U.Validated){if(typeof t.validation=="boolean"&&t.validation)a.state=U.IndexedReferences,a.diagnostics=void 0,this.buildState.delete(o);else if(typeof t.validation=="object"){const l=this.buildState.get(o),c=(i=l?.result)===null||i===void 0?void 0:i.validationChecks;if(c){const d=((s=t.validation.categories)!==null&&s!==void 0?s:di.all).filter(h=>!c.includes(h));d.length>0&&(this.buildState.set(o,{completed:!1,options:{validation:Object.assign(Object.assign({},t.validation),{categories:d})},result:l.result}),a.state=U.IndexedReferences)}}}else this.buildState.delete(o)}this.currentState=U.Changed,await this.emitUpdate(e.map(a=>a.uri),[]),await this.buildDocuments(e,t,r)}async update(e,t,r=V.CancellationToken.None){this.currentState=U.Changed;for(const a of t)this.langiumDocuments.deleteDocument(a),this.buildState.delete(a.toString()),this.indexManager.remove(a);for(const a of e){if(!this.langiumDocuments.invalidateDocument(a)){const l=this.langiumDocumentFactory.fromModel({$type:"INVALID"},a);l.state=U.Changed,this.langiumDocuments.addDocument(l)}this.buildState.delete(a.toString())}const i=ee(e).concat(t).map(a=>a.toString()).toSet();this.langiumDocuments.all.filter(a=>!i.has(a.uri.toString())&&this.shouldRelink(a,i)).forEach(a=>{this.serviceRegistry.getServices(a.uri).references.Linker.unlink(a),a.state=Math.min(a.state,U.ComputedScopes),a.diagnostics=void 0}),await this.emitUpdate(e,t),await Ae(r);const s=this.sortDocuments(this.langiumDocuments.all.filter(a=>{var o;return a.state<U.Linked||!(!((o=this.buildState.get(a.uri.toString()))===null||o===void 0)&&o.completed)}).toArray());await this.buildDocuments(s,this.updateBuildOptions,r)}async emitUpdate(e,t){await Promise.all(this.updateListeners.map(r=>r(e,t)))}sortDocuments(e){let t=0,r=e.length-1;for(;t<r;){for(;t<e.length&&this.hasTextDocument(e[t]);)t++;for(;r>=0&&!this.hasTextDocument(e[r]);)r--;t<r&&([e[t],e[r]]=[e[r],e[t]])}return e}hasTextDocument(e){var t;return!!(!((t=this.textDocuments)===null||t===void 0)&&t.get(e.uri))}shouldRelink(e,t){return e.references.some(r=>r.error!==void 0)?!0:this.indexManager.isAffected(e,t)}onUpdate(e){return this.updateListeners.push(e),qn.create(()=>{const t=this.updateListeners.indexOf(e);t>=0&&this.updateListeners.splice(t,1)})}async buildDocuments(e,t,r){this.prepareBuild(e,t),await this.runCancelable(e,U.Parsed,r,s=>this.langiumDocumentFactory.update(s,r)),await this.runCancelable(e,U.IndexedContent,r,s=>this.indexManager.updateContent(s,r)),await this.runCancelable(e,U.ComputedScopes,r,async s=>{const a=this.serviceRegistry.getServices(s.uri).references.ScopeComputation;s.precomputedScopes=await a.computeLocalScopes(s,r)}),await this.runCancelable(e,U.Linked,r,s=>this.serviceRegistry.getServices(s.uri).references.Linker.link(s,r)),await this.runCancelable(e,U.IndexedReferences,r,s=>this.indexManager.updateReferences(s,r));const i=e.filter(s=>this.shouldValidate(s));await this.runCancelable(i,U.Validated,r,s=>this.validate(s,r));for(const s of e){const a=this.buildState.get(s.uri.toString());a&&(a.completed=!0)}}prepareBuild(e,t){for(const r of e){const i=r.uri.toString(),s=this.buildState.get(i);(!s||s.completed)&&this.buildState.set(i,{completed:!1,options:t,result:s?.result})}}async runCancelable(e,t,r,i){const s=e.filter(o=>o.state<t);for(const o of s)await Ae(r),await i(o),o.state=t,await this.notifyDocumentPhase(o,t,r);const a=e.filter(o=>o.state===t);await this.notifyBuildPhase(a,t,r),this.currentState=t}onBuildPhase(e,t){return this.buildPhaseListeners.add(e,t),qn.create(()=>{this.buildPhaseListeners.delete(e,t)})}onDocumentPhase(e,t){return this.documentPhaseListeners.add(e,t),qn.create(()=>{this.documentPhaseListeners.delete(e,t)})}waitUntil(e,t,r){let i;if(t&&"path"in t?i=t:r=t,r??(r=V.CancellationToken.None),i){const s=this.langiumDocuments.getDocument(i);if(s&&s.state>e)return Promise.resolve(i)}return this.currentState>=e?Promise.resolve(void 0):r.isCancellationRequested?Promise.reject(ci):new Promise((s,a)=>{const o=this.onBuildPhase(e,()=>{if(o.dispose(),l.dispose(),i){const c=this.langiumDocuments.getDocument(i);s(c?.uri)}else s(void 0)}),l=r.onCancellationRequested(()=>{o.dispose(),l.dispose(),a(ci)})})}async notifyDocumentPhase(e,t,r){const s=this.documentPhaseListeners.get(t).slice();for(const a of s)try{await a(e,r)}catch(o){if(!Si(o))throw o}}async notifyBuildPhase(e,t,r){if(e.length===0)return;const s=this.buildPhaseListeners.get(t).slice();for(const a of s)await Ae(r),await a(e,r)}shouldValidate(e){return!!this.getBuildOptions(e).validation}async validate(e,t){var r,i;const s=this.serviceRegistry.getServices(e.uri).validation.DocumentValidator,a=this.getBuildOptions(e).validation,o=typeof a=="object"?a:void 0,l=await s.validateDocument(e,o,t);e.diagnostics?e.diagnostics.push(...l):e.diagnostics=l;const c=this.buildState.get(e.uri.toString());if(c){(r=c.result)!==null&&r!==void 0||(c.result={});const u=(i=o?.categories)!==null&&i!==void 0?i:di.all;c.result.validationChecks?c.result.validationChecks.push(...u):c.result.validationChecks=[...u]}}getBuildOptions(e){var t,r;return(r=(t=this.buildState.get(e.uri.toString()))===null||t===void 0?void 0:t.options)!==null&&r!==void 0?r:{}}}class tg{constructor(e){this.symbolIndex=new Map,this.symbolByTypeIndex=new Gm,this.referenceIndex=new Map,this.documents=e.workspace.LangiumDocuments,this.serviceRegistry=e.ServiceRegistry,this.astReflection=e.AstReflection}findAllReferences(e,t){const r=Ze(e).uri,i=[];return this.referenceIndex.forEach(s=>{s.forEach(a=>{rt.equals(a.targetUri,r)&&a.targetPath===t&&i.push(a)})}),ee(i)}allElements(e,t){let r=ee(this.symbolIndex.keys());return t&&(r=r.filter(i=>!t||t.has(i))),r.map(i=>this.getFileDescriptions(i,e)).flat()}getFileDescriptions(e,t){var r;return t?this.symbolByTypeIndex.get(e,t,()=>{var s;return((s=this.symbolIndex.get(e))!==null&&s!==void 0?s:[]).filter(o=>this.astReflection.isSubtype(o.type,t))}):(r=this.symbolIndex.get(e))!==null&&r!==void 0?r:[]}remove(e){const t=e.toString();this.symbolIndex.delete(t),this.symbolByTypeIndex.clear(t),this.referenceIndex.delete(t)}async updateContent(e,t=V.CancellationToken.None){const i=await this.serviceRegistry.getServices(e.uri).references.ScopeComputation.computeExports(e,t),s=e.uri.toString();this.symbolIndex.set(s,i),this.symbolByTypeIndex.clear(s)}async updateReferences(e,t=V.CancellationToken.None){const i=await this.serviceRegistry.getServices(e.uri).workspace.ReferenceDescriptionProvider.createDescriptions(e,t);this.referenceIndex.set(e.uri.toString(),i)}isAffected(e,t){const r=this.referenceIndex.get(e.uri.toString());return r?r.some(i=>!i.local&&t.has(i.targetUri.toString())):!1}}class ng{constructor(e){this.initialBuildOptions={},this._ready=new da,this.serviceRegistry=e.ServiceRegistry,this.langiumDocuments=e.workspace.LangiumDocuments,this.documentBuilder=e.workspace.DocumentBuilder,this.fileSystemProvider=e.workspace.FileSystemProvider,this.mutex=e.workspace.WorkspaceLock}get ready(){return this._ready.promise}get workspaceFolders(){return this.folders}initialize(e){var t;this.folders=(t=e.workspaceFolders)!==null&&t!==void 0?t:void 0}initialized(e){return this.mutex.write(t=>{var r;return this.initializeWorkspace((r=this.folders)!==null&&r!==void 0?r:[],t)})}async initializeWorkspace(e,t=V.CancellationToken.None){const r=await this.performStartup(e);await Ae(t),await this.documentBuilder.build(r,this.initialBuildOptions,t)}async performStartup(e){const t=this.serviceRegistry.all.flatMap(s=>s.LanguageMetaData.fileExtensions),r=[],i=s=>{r.push(s),this.langiumDocuments.hasDocument(s.uri)||this.langiumDocuments.addDocument(s)};return await this.loadAdditionalDocuments(e,i),await Promise.all(e.map(s=>[s,this.getRootFolder(s)]).map(async s=>this.traverseFolder(...s,t,i))),this._ready.resolve(),r}loadAdditionalDocuments(e,t){return Promise.resolve()}getRootFolder(e){return At.parse(e.uri)}async traverseFolder(e,t,r,i){const s=await this.fileSystemProvider.readDirectory(t);await Promise.all(s.map(async a=>{if(this.includeEntry(e,a,r)){if(a.isDirectory)await this.traverseFolder(e,a.uri,r,i);else if(a.isFile){const o=await this.langiumDocuments.getOrCreateDocument(a.uri);i(o)}}}))}includeEntry(e,t,r){const i=rt.basename(t.uri);if(i.startsWith("."))return!1;if(t.isDirectory)return i!=="node_modules"&&i!=="out";if(t.isFile){const s=rt.extname(t.uri);return r.includes(s)}return!1}}class rg{buildUnexpectedCharactersMessage(e,t,r,i,s){return fs.buildUnexpectedCharactersMessage(e,t,r,i,s)}buildUnableToPopLexerModeMessage(e){return fs.buildUnableToPopLexerModeMessage(e)}}const ig={mode:"full"};class sg{constructor(e){this.errorMessageProvider=e.parser.LexerErrorMessageProvider,this.tokenBuilder=e.parser.TokenBuilder;const t=this.tokenBuilder.buildTokens(e.Grammar,{caseInsensitive:e.LanguageMetaData.caseInsensitive});this.tokenTypes=this.toTokenTypeDictionary(t);const r=ul(t)?Object.values(t):t,i=e.LanguageMetaData.mode==="production";this.chevrotainLexer=new fe(r,{positionTracking:"full",skipValidations:i,errorMessageProvider:this.errorMessageProvider})}get definition(){return this.tokenTypes}tokenize(e,t=ig){var r,i,s;const a=this.chevrotainLexer.tokenize(e);return{tokens:a.tokens,errors:a.errors,hidden:(r=a.groups.hidden)!==null&&r!==void 0?r:[],report:(s=(i=this.tokenBuilder).flushLexingReport)===null||s===void 0?void 0:s.call(i,e)}}toTokenTypeDictionary(e){if(ul(e))return e;const t=au(e)?Object.values(e.modes).flat():e,r={};return t.forEach(i=>r[i.name]=i),r}}function ag(n){return Array.isArray(n)&&(n.length===0||"name"in n[0])}function au(n){return n&&"modes"in n&&"defaultMode"in n}function ul(n){return!ag(n)&&!au(n)}function og(n,e,t){let r,i;typeof n=="string"?(i=e,r=t):(i=n.range.start,r=e),i||(i=P.create(0,0));const s=ou(n),a=fa(r),o=ug({lines:s,position:i,options:a});return mg({index:0,tokens:o,position:i})}function lg(n,e){const t=fa(e),r=ou(n);if(r.length===0)return!1;const i=r[0],s=r[r.length-1],a=t.start,o=t.end;return!!a?.exec(i)&&!!o?.exec(s)}function ou(n){let e="";return typeof n=="string"?e=n:e=n.text,e.split(jd)}const dl=/\s*(@([\p{L}][\p{L}\p{N}]*)?)/uy,cg=/\{(@[\p{L}][\p{L}\p{N}]*)(\s*)([^\r\n}]+)?\}/gu;function ug(n){var e,t,r;const i=[];let s=n.position.line,a=n.position.character;for(let o=0;o<n.lines.length;o++){const l=o===0,c=o===n.lines.length-1;let u=n.lines[o],d=0;if(l&&n.options.start){const f=(e=n.options.start)===null||e===void 0?void 0:e.exec(u);f&&(d=f.index+f[0].length)}else{const f=(t=n.options.line)===null||t===void 0?void 0:t.exec(u);f&&(d=f.index+f[0].length)}if(c){const f=(r=n.options.end)===null||r===void 0?void 0:r.exec(u);f&&(u=u.substring(0,f.index))}if(u=u.substring(0,pg(u)),Fs(u,d)>=u.length){if(i.length>0){const f=P.create(s,a);i.push({type:"break",content:"",range:O.create(f,f)})}}else{dl.lastIndex=d;const f=dl.exec(u);if(f){const m=f[0],g=f[1],A=P.create(s,a+d),T=P.create(s,a+d+m.length);i.push({type:"tag",content:g,range:O.create(A,T)}),d+=m.length,d=Fs(u,d)}if(d<u.length){const m=u.substring(d),g=Array.from(m.matchAll(cg));i.push(...dg(g,m,s,a+d))}}s++,a=0}return i.length>0&&i[i.length-1].type==="break"?i.slice(0,-1):i}function dg(n,e,t,r){const i=[];if(n.length===0){const s=P.create(t,r),a=P.create(t,r+e.length);i.push({type:"text",content:e,range:O.create(s,a)})}else{let s=0;for(const o of n){const l=o.index,c=e.substring(s,l);c.length>0&&i.push({type:"text",content:e.substring(s,l),range:O.create(P.create(t,s+r),P.create(t,l+r))});let u=c.length+1;const d=o[1];if(i.push({type:"inline-tag",content:d,range:O.create(P.create(t,s+u+r),P.create(t,s+u+d.length+r))}),u+=d.length,o.length===4){u+=o[2].length;const h=o[3];i.push({type:"text",content:h,range:O.create(P.create(t,s+u+r),P.create(t,s+u+h.length+r))})}else i.push({type:"text",content:"",range:O.create(P.create(t,s+u+r),P.create(t,s+u+r))});s=l+o[0].length}const a=e.substring(s);a.length>0&&i.push({type:"text",content:a,range:O.create(P.create(t,s+r),P.create(t,s+r+a.length))})}return i}const fg=/\S/,hg=/\s*$/;function Fs(n,e){const t=n.substring(e).match(fg);return t?e+t.index:n.length}function pg(n){const e=n.match(hg);if(e&&typeof e.index=="number")return e.index}function mg(n){var e,t,r,i;const s=P.create(n.position.line,n.position.character);if(n.tokens.length===0)return new fl([],O.create(s,s));const a=[];for(;n.index<n.tokens.length;){const c=gg(n,a[a.length-1]);c&&a.push(c)}const o=(t=(e=a[0])===null||e===void 0?void 0:e.range.start)!==null&&t!==void 0?t:s,l=(i=(r=a[a.length-1])===null||r===void 0?void 0:r.range.end)!==null&&i!==void 0?i:s;return new fl(a,O.create(o,l))}function gg(n,e){const t=n.tokens[n.index];if(t.type==="tag")return cu(n,!1);if(t.type==="text"||t.type==="inline-tag")return lu(n);yg(t,e),n.index++}function yg(n,e){if(e){const t=new du("",n.range);"inlines"in e?e.inlines.push(t):e.content.inlines.push(t)}}function lu(n){let e=n.tokens[n.index];const t=e;let r=e;const i=[];for(;e&&e.type!=="break"&&e.type!=="tag";)i.push(Tg(n)),r=e,e=n.tokens[n.index];return new Gs(i,O.create(t.range.start,r.range.end))}function Tg(n){return n.tokens[n.index].type==="inline-tag"?cu(n,!0):uu(n)}function cu(n,e){const t=n.tokens[n.index++],r=t.content.substring(1),i=n.tokens[n.index];if(i?.type==="text")if(e){const s=uu(n);return new zi(r,new Gs([s],s.range),e,O.create(t.range.start,s.range.end))}else{const s=lu(n);return new zi(r,s,e,O.create(t.range.start,s.range.end))}else{const s=t.range;return new zi(r,new Gs([],s),e,s)}}function uu(n){const e=n.tokens[n.index++];return new du(e.content,e.range)}function fa(n){if(!n)return fa({start:"/**",end:"*/",line:"*"});const{start:e,end:t,line:r}=n;return{start:Hi(e,!0),end:Hi(t,!1),line:Hi(r,!0)}}function Hi(n,e){if(typeof n=="string"||typeof n=="object"){const t=typeof n=="string"?Ti(n):n.source;return e?new RegExp(`^\\s*${t}`):new RegExp(`\\s*${t}\\s*$`)}else return n}class fl{constructor(e,t){this.elements=e,this.range=t}getTag(e){return this.getAllTags().find(t=>t.name===e)}getTags(e){return this.getAllTags().filter(t=>t.name===e)}getAllTags(){return this.elements.filter(e=>"name"in e)}toString(){let e="";for(const t of this.elements)if(e.length===0)e=t.toString();else{const r=t.toString();e+=hl(e)+r}return e.trim()}toMarkdown(e){let t="";for(const r of this.elements)if(t.length===0)t=r.toMarkdown(e);else{const i=r.toMarkdown(e);t+=hl(t)+i}return t.trim()}}class zi{constructor(e,t,r,i){this.name=e,this.content=t,this.inline=r,this.range=i}toString(){let e=`@${this.name}`;const t=this.content.toString();return this.content.inlines.length===1?e=`${e} ${t}`:this.content.inlines.length>1&&(e=`${e}
-${t}`),this.inline?`{${e}}`:e}toMarkdown(e){var t,r;return(r=(t=e?.renderTag)===null||t===void 0?void 0:t.call(e,this))!==null&&r!==void 0?r:this.toMarkdownDefault(e)}toMarkdownDefault(e){const t=this.content.toMarkdown(e);if(this.inline){const s=Rg(this.name,t,e??{});if(typeof s=="string")return s}let r="";e?.tag==="italic"||e?.tag===void 0?r="*":e?.tag==="bold"?r="**":e?.tag==="bold-italic"&&(r="***");let i=`${r}@${this.name}${r}`;return this.content.inlines.length===1?i=`${i} — ${t}`:this.content.inlines.length>1&&(i=`${i}
-${t}`),this.inline?`{${i}}`:i}}function Rg(n,e,t){var r,i;if(n==="linkplain"||n==="linkcode"||n==="link"){const s=e.indexOf(" ");let a=e;if(s>0){const l=Fs(e,s);a=e.substring(l),e=e.substring(0,s)}return(n==="linkcode"||n==="link"&&t.link==="code")&&(a=`\`${a}\``),(i=(r=t.renderLink)===null||r===void 0?void 0:r.call(t,e,a))!==null&&i!==void 0?i:vg(e,a)}}function vg(n,e){try{return At.parse(n,!0),`[${e}](${n})`}catch{return n}}class Gs{constructor(e,t){this.inlines=e,this.range=t}toString(){let e="";for(let t=0;t<this.inlines.length;t++){const r=this.inlines[t],i=this.inlines[t+1];e+=r.toString(),i&&i.range.start.line>r.range.start.line&&(e+=`
-`)}return e}toMarkdown(e){let t="";for(let r=0;r<this.inlines.length;r++){const i=this.inlines[r],s=this.inlines[r+1];t+=i.toMarkdown(e),s&&s.range.start.line>i.range.start.line&&(t+=`
-`)}return t}}class du{constructor(e,t){this.text=e,this.range=t}toString(){return this.text}toMarkdown(){return this.text}}function hl(n){return n.endsWith(`
-`)?`
-`:`
-
-`}class Ag{constructor(e){this.indexManager=e.shared.workspace.IndexManager,this.commentProvider=e.documentation.CommentProvider}getDocumentation(e){const t=this.commentProvider.getComment(e);if(t&&lg(t))return og(t).toMarkdown({renderLink:(i,s)=>this.documentationLinkRenderer(e,i,s),renderTag:i=>this.documentationTagRenderer(e,i)})}documentationLinkRenderer(e,t,r){var i;const s=(i=this.findNameInPrecomputedScopes(e,t))!==null&&i!==void 0?i:this.findNameInGlobalScope(e,t);if(s&&s.nameSegment){const a=s.nameSegment.range.start.line+1,o=s.nameSegment.range.start.character+1,l=s.documentUri.with({fragment:`L${a},${o}`});return`[${r}](${l.toString()})`}else return}documentationTagRenderer(e,t){}findNameInPrecomputedScopes(e,t){const i=Ze(e).precomputedScopes;if(!i)return;let s=e;do{const o=i.get(s).find(l=>l.name===t);if(o)return o;s=s.$container}while(s)}findNameInGlobalScope(e,t){return this.indexManager.allElements().find(i=>i.name===t)}}class Eg{constructor(e){this.grammarConfig=()=>e.parser.GrammarConfig}getComment(e){var t;return Vm(e)?e.$comment:(t=Ad(e.$cstNode,this.grammarConfig().multilineCommentRules))===null||t===void 0?void 0:t.text}}class kg{constructor(e){this.syncParser=e.parser.LangiumParser}parse(e,t){return Promise.resolve(this.syncParser.parse(e))}}class $g{constructor(){this.previousTokenSource=new V.CancellationTokenSource,this.writeQueue=[],this.readQueue=[],this.done=!0}write(e){this.cancelWrite();const t=Cm();return this.previousTokenSource=t,this.enqueue(this.writeQueue,e,t.token)}read(e){return this.enqueue(this.readQueue,e)}enqueue(e,t,r=V.CancellationToken.None){const i=new da,s={action:t,deferred:i,cancellationToken:r};return e.push(s),this.performNextOperation(),i.promise}async performNextOperation(){if(!this.done)return;const e=[];if(this.writeQueue.length>0)e.push(this.writeQueue.shift());else if(this.readQueue.length>0)e.push(...this.readQueue.splice(0,this.readQueue.length));else return;this.done=!1,await Promise.all(e.map(async({action:t,deferred:r,cancellationToken:i})=>{try{const s=await Promise.resolve().then(()=>t(i));r.resolve(s)}catch(s){Si(s)?r.resolve(void 0):r.reject(s)}})),this.done=!0,this.performNextOperation()}cancelWrite(){this.previousTokenSource.cancel()}}class xg{constructor(e){this.grammarElementIdMap=new ol,this.tokenTypeIdMap=new ol,this.grammar=e.Grammar,this.lexer=e.parser.Lexer,this.linker=e.references.Linker}dehydrate(e){return{lexerErrors:e.lexerErrors,lexerReport:e.lexerReport?this.dehydrateLexerReport(e.lexerReport):void 0,parserErrors:e.parserErrors.map(t=>Object.assign(Object.assign({},t),{message:t.message})),value:this.dehydrateAstNode(e.value,this.createDehyrationContext(e.value))}}dehydrateLexerReport(e){return e}createDehyrationContext(e){const t=new Map,r=new Map;for(const i of _t(e))t.set(i,{});if(e.$cstNode)for(const i of ss(e.$cstNode))r.set(i,{});return{astNodes:t,cstNodes:r}}dehydrateAstNode(e,t){const r=t.astNodes.get(e);r.$type=e.$type,r.$containerIndex=e.$containerIndex,r.$containerProperty=e.$containerProperty,e.$cstNode!==void 0&&(r.$cstNode=this.dehydrateCstNode(e.$cstNode,t));for(const[i,s]of Object.entries(e))if(!i.startsWith("$"))if(Array.isArray(s)){const a=[];r[i]=a;for(const o of s)ae(o)?a.push(this.dehydrateAstNode(o,t)):Ue(o)?a.push(this.dehydrateReference(o,t)):a.push(o)}else ae(s)?r[i]=this.dehydrateAstNode(s,t):Ue(s)?r[i]=this.dehydrateReference(s,t):s!==void 0&&(r[i]=s);return r}dehydrateReference(e,t){const r={};return r.$refText=e.$refText,e.$refNode&&(r.$refNode=t.cstNodes.get(e.$refNode)),r}dehydrateCstNode(e,t){const r=t.cstNodes.get(e);return Pl(e)?r.fullText=e.fullText:r.grammarSource=this.getGrammarElementId(e.grammarSource),r.hidden=e.hidden,r.astNode=t.astNodes.get(e.astNode),Xn(e)?r.content=e.content.map(i=>this.dehydrateCstNode(i,t)):Ol(e)&&(r.tokenType=e.tokenType.name,r.offset=e.offset,r.length=e.length,r.startLine=e.range.start.line,r.startColumn=e.range.start.character,r.endLine=e.range.end.line,r.endColumn=e.range.end.character),r}hydrate(e){const t=e.value,r=this.createHydrationContext(t);return"$cstNode"in t&&this.hydrateCstNode(t.$cstNode,r),{lexerErrors:e.lexerErrors,lexerReport:e.lexerReport,parserErrors:e.parserErrors,value:this.hydrateAstNode(t,r)}}createHydrationContext(e){const t=new Map,r=new Map;for(const s of _t(e))t.set(s,{});let i;if(e.$cstNode)for(const s of ss(e.$cstNode)){let a;"fullText"in s?(a=new Wc(s.fullText),i=a):"content"in s?a=new ca:"tokenType"in s&&(a=this.hydrateCstLeafNode(s)),a&&(r.set(s,a),a.root=i)}return{astNodes:t,cstNodes:r}}hydrateAstNode(e,t){const r=t.astNodes.get(e);r.$type=e.$type,r.$containerIndex=e.$containerIndex,r.$containerProperty=e.$containerProperty,e.$cstNode&&(r.$cstNode=t.cstNodes.get(e.$cstNode));for(const[i,s]of Object.entries(e))if(!i.startsWith("$"))if(Array.isArray(s)){const a=[];r[i]=a;for(const o of s)ae(o)?a.push(this.setParent(this.hydrateAstNode(o,t),r)):Ue(o)?a.push(this.hydrateReference(o,r,i,t)):a.push(o)}else ae(s)?r[i]=this.setParent(this.hydrateAstNode(s,t),r):Ue(s)?r[i]=this.hydrateReference(s,r,i,t):s!==void 0&&(r[i]=s);return r}setParent(e,t){return e.$container=t,e}hydrateReference(e,t,r,i){return this.linker.buildReference(t,r,i.cstNodes.get(e.$refNode),e.$refText)}hydrateCstNode(e,t,r=0){const i=t.cstNodes.get(e);if(typeof e.grammarSource=="number"&&(i.grammarSource=this.getGrammarElement(e.grammarSource)),i.astNode=t.astNodes.get(e.astNode),Xn(i))for(const s of e.content){const a=this.hydrateCstNode(s,t,r++);i.content.push(a)}return i}hydrateCstLeafNode(e){const t=this.getTokenType(e.tokenType),r=e.offset,i=e.length,s=e.startLine,a=e.startColumn,o=e.endLine,l=e.endColumn,c=e.hidden;return new bs(r,i,{start:{line:s,character:a},end:{line:o,character:l}},t,c)}getTokenType(e){return this.lexer.definition[e]}getGrammarElementId(e){if(e)return this.grammarElementIdMap.size===0&&this.createGrammarElementIdMap(),this.grammarElementIdMap.get(e)}getGrammarElement(e){return this.grammarElementIdMap.size===0&&this.createGrammarElementIdMap(),this.grammarElementIdMap.getKey(e)}createGrammarElementIdMap(){let e=0;for(const t of _t(this.grammar))kd(t)&&this.grammarElementIdMap.set(t,e++)}}function at(n){return{documentation:{CommentProvider:e=>new Eg(e),DocumentationProvider:e=>new Ag(e)},parser:{AsyncParser:e=>new kg(e),GrammarConfig:e=>mf(e),LangiumParser:e=>Em(e),CompletionParser:e=>Am(e),ValueConverter:()=>new Zc,TokenBuilder:()=>new Qc,Lexer:e=>new sg(e),ParserErrorMessageProvider:()=>new zc,LexerErrorMessageProvider:()=>new rg},workspace:{AstNodeLocator:()=>new Jm,AstNodeDescriptionProvider:e=>new Ym(e),ReferenceDescriptionProvider:e=>new Xm(e)},references:{Linker:e=>new Lm(e),NameProvider:()=>new Om,ScopeProvider:e=>new Bm(e),ScopeComputation:e=>new Mm(e),References:e=>new Pm(e)},serializer:{Hydrator:e=>new xg(e),JsonSerializer:e=>new Km(e)},validation:{DocumentValidator:e=>new Hm(e),ValidationRegistry:e=>new jm(e)},shared:()=>n.shared}}function ot(n){return{ServiceRegistry:e=>new Wm(e),workspace:{LangiumDocuments:e=>new _m(e),LangiumDocumentFactory:e=>new wm(e),DocumentBuilder:e=>new eg(e),IndexManager:e=>new tg(e),WorkspaceManager:e=>new ng(e),FileSystemProvider:e=>n.fileSystemProvider(e),WorkspaceLock:()=>new $g,ConfigurationProvider:e=>new Zm(e)}}}var pl;(function(n){n.merge=(e,t)=>fi(fi({},e),t)})(pl||(pl={}));function oe(n,e,t,r,i,s,a,o,l){const c=[n,e,t,r,i,s,a,o,l].reduce(fi,{});return fu(c)}const Sg=Symbol("isProxy");function fu(n,e){const t=new Proxy({},{deleteProperty:()=>!1,set:()=>{throw new Error("Cannot set property on injected service container")},get:(r,i)=>i===Sg?!0:gl(r,i,n,e||t),getOwnPropertyDescriptor:(r,i)=>(gl(r,i,n,e||t),Object.getOwnPropertyDescriptor(r,i)),has:(r,i)=>i in n,ownKeys:()=>[...Object.getOwnPropertyNames(n)]});return t}const ml=Symbol();function gl(n,e,t,r){if(e in n){if(n[e]instanceof Error)throw new Error("Construction failure. Please make sure that your dependencies are constructable.",{cause:n[e]});if(n[e]===ml)throw new Error('Cycle detected. Please make "'+String(e)+'" lazy. Visit https://langium.org/docs/reference/configuration-services/#resolving-cyclic-dependencies');return n[e]}else if(e in t){const i=t[e];n[e]=ml;try{n[e]=typeof i=="function"?i(r):fu(i,r)}catch(s){throw n[e]=s instanceof Error?s:void 0,s}return n[e]}else return}function fi(n,e){if(e){for(const[t,r]of Object.entries(e))if(r!==void 0){const i=n[t];i!==null&&r!==null&&typeof i=="object"&&typeof r=="object"?n[t]=fi(i,r):n[t]=r}}return n}class Ig{readFile(){throw new Error("No file system is available.")}async readDirectory(){return[]}}const lt={fileSystemProvider:()=>new Ig},Cg={Grammar:()=>{},LanguageMetaData:()=>({caseInsensitive:!1,fileExtensions:[".langium"],languageId:"langium"})},Ng={AstReflection:()=>new Vl};function wg(){const n=oe(ot(lt),Ng),e=oe(at({shared:n}),Cg);return n.ServiceRegistry.register(e),e}function xt(n){var e;const t=wg(),r=t.serializer.JsonSerializer.deserialize(n);return t.shared.workspace.LangiumDocumentFactory.fromModel(r,At.parse(`memory://${(e=r.name)!==null&&e!==void 0?e:"grammar"}.langium`)),r}var _g=Object.defineProperty,v=(n,e)=>_g(n,"name",{value:e,configurable:!0}),yl="Statement",Dr="Architecture";function Lg(n){return De.isInstance(n,Dr)}v(Lg,"isArchitecture");var Er="Axis",Wn="Branch";function bg(n){return De.isInstance(n,Wn)}v(bg,"isBranch");var kr="Checkout",$r="CherryPicking",qi="ClassDefStatement",jn="Commit";function Og(n){return De.isInstance(n,jn)}v(Og,"isCommit");var Yi="Curve",Xi="Edge",Ji="Entry",Hn="GitGraph";function Pg(n){return De.isInstance(n,Hn)}v(Pg,"isGitGraph");var Qi="Group",Fr="Info";function Mg(n){return De.isInstance(n,Fr)}v(Mg,"isInfo");var xr="Item",Zi="Junction",zn="Merge";function Dg(n){return De.isInstance(n,zn)}v(Dg,"isMerge");var es="Option",Gr="Packet";function Fg(n){return De.isInstance(n,Gr)}v(Fg,"isPacket");var Ur="PacketBlock";function Gg(n){return De.isInstance(n,Ur)}v(Gg,"isPacketBlock");var Br="Pie";function Ug(n){return De.isInstance(n,Br)}v(Ug,"isPie");var Vr="PieSection";function Bg(n){return De.isInstance(n,Vr)}v(Bg,"isPieSection");var ts="Radar",ns="Service",Kr="Treemap";function Vg(n){return De.isInstance(n,Kr)}v(Vg,"isTreemap");var rs="TreemapRow",Sr="Direction",Ir="Leaf",Cr="Section",bt,hu=(bt=class extends bl{getAllTypes(){return[Dr,Er,Wn,kr,$r,qi,jn,Yi,Sr,Xi,Ji,Hn,Qi,Fr,xr,Zi,Ir,zn,es,Gr,Ur,Br,Vr,ts,Cr,ns,yl,Kr,rs]}computeIsSubtype(e,t){switch(e){case Wn:case kr:case $r:case jn:case zn:return this.isSubtype(yl,t);case Sr:return this.isSubtype(Hn,t);case Ir:case Cr:return this.isSubtype(xr,t);default:return!1}}getReferenceType(e){const t=`${e.container.$type}:${e.property}`;switch(t){case"Entry:axis":return Er;default:throw new Error(`${t} is not a valid reference id.`)}}getTypeMetaData(e){switch(e){case Dr:return{name:Dr,properties:[{name:"accDescr"},{name:"accTitle"},{name:"edges",defaultValue:[]},{name:"groups",defaultValue:[]},{name:"junctions",defaultValue:[]},{name:"services",defaultValue:[]},{name:"title"}]};case Er:return{name:Er,properties:[{name:"label"},{name:"name"}]};case Wn:return{name:Wn,properties:[{name:"name"},{name:"order"}]};case kr:return{name:kr,properties:[{name:"branch"}]};case $r:return{name:$r,properties:[{name:"id"},{name:"parent"},{name:"tags",defaultValue:[]}]};case qi:return{name:qi,properties:[{name:"className"},{name:"styleText"}]};case jn:return{name:jn,properties:[{name:"id"},{name:"message"},{name:"tags",defaultValue:[]},{name:"type"}]};case Yi:return{name:Yi,properties:[{name:"entries",defaultValue:[]},{name:"label"},{name:"name"}]};case Xi:return{name:Xi,properties:[{name:"lhsDir"},{name:"lhsGroup",defaultValue:!1},{name:"lhsId"},{name:"lhsInto",defaultValue:!1},{name:"rhsDir"},{name:"rhsGroup",defaultValue:!1},{name:"rhsId"},{name:"rhsInto",defaultValue:!1},{name:"title"}]};case Ji:return{name:Ji,properties:[{name:"axis"},{name:"value"}]};case Hn:return{name:Hn,properties:[{name:"accDescr"},{name:"accTitle"},{name:"statements",defaultValue:[]},{name:"title"}]};case Qi:return{name:Qi,properties:[{name:"icon"},{name:"id"},{name:"in"},{name:"title"}]};case Fr:return{name:Fr,properties:[{name:"accDescr"},{name:"accTitle"},{name:"title"}]};case xr:return{name:xr,properties:[{name:"classSelector"},{name:"name"}]};case Zi:return{name:Zi,properties:[{name:"id"},{name:"in"}]};case zn:return{name:zn,properties:[{name:"branch"},{name:"id"},{name:"tags",defaultValue:[]},{name:"type"}]};case es:return{name:es,properties:[{name:"name"},{name:"value",defaultValue:!1}]};case Gr:return{name:Gr,properties:[{name:"accDescr"},{name:"accTitle"},{name:"blocks",defaultValue:[]},{name:"title"}]};case Ur:return{name:Ur,properties:[{name:"bits"},{name:"end"},{name:"label"},{name:"start"}]};case Br:return{name:Br,properties:[{name:"accDescr"},{name:"accTitle"},{name:"sections",defaultValue:[]},{name:"showData",defaultValue:!1},{name:"title"}]};case Vr:return{name:Vr,properties:[{name:"label"},{name:"value"}]};case ts:return{name:ts,properties:[{name:"accDescr"},{name:"accTitle"},{name:"axes",defaultValue:[]},{name:"curves",defaultValue:[]},{name:"options",defaultValue:[]},{name:"title"}]};case ns:return{name:ns,properties:[{name:"icon"},{name:"iconText"},{name:"id"},{name:"in"},{name:"title"}]};case Kr:return{name:Kr,properties:[{name:"accDescr"},{name:"accTitle"},{name:"title"},{name:"TreemapRows",defaultValue:[]}]};case rs:return{name:rs,properties:[{name:"indent"},{name:"item"}]};case Sr:return{name:Sr,properties:[{name:"accDescr"},{name:"accTitle"},{name:"dir"},{name:"statements",defaultValue:[]},{name:"title"}]};case Ir:return{name:Ir,properties:[{name:"classSelector"},{name:"name"},{name:"value"}]};case Cr:return{name:Cr,properties:[{name:"classSelector"},{name:"name"}]};default:return{name:e,properties:[]}}}},v(bt,"MermaidAstReflection"),bt),De=new hu,Tl,Kg=v(()=>Tl??(Tl=xt(`{"$type":"Grammar","isDeclared":true,"name":"Info","imports":[],"rules":[{"$type":"ParserRule","entry":true,"name":"Info","definition":{"$type":"Group","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@12"},"arguments":[],"cardinality":"*"},{"$type":"Keyword","value":"info"},{"$type":"RuleCall","rule":{"$ref":"#/rules@12"},"arguments":[],"cardinality":"*"},{"$type":"Group","elements":[{"$type":"Keyword","value":"showInfo"},{"$type":"RuleCall","rule":{"$ref":"#/rules@12"},"arguments":[],"cardinality":"*"}],"cardinality":"?"},{"$type":"RuleCall","rule":{"$ref":"#/rules@2"},"arguments":[],"cardinality":"?"}]},"definesHiddenTokens":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","fragment":true,"name":"EOL","dataType":"string","definition":{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@12"},"arguments":[],"cardinality":"+"},{"$type":"EndOfFile"}]},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","fragment":true,"name":"TitleAndAccessibilities","definition":{"$type":"Group","elements":[{"$type":"Alternatives","elements":[{"$type":"Assignment","feature":"accDescr","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@4"},"arguments":[]}},{"$type":"Assignment","feature":"accTitle","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@5"},"arguments":[]}},{"$type":"Assignment","feature":"title","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@6"},"arguments":[]}}]},{"$type":"RuleCall","rule":{"$ref":"#/rules@1"},"arguments":[]}],"cardinality":"+"},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"TerminalRule","name":"BOOLEAN","type":{"$type":"ReturnType","name":"boolean"},"definition":{"$type":"TerminalAlternatives","elements":[{"$type":"CharacterRange","left":{"$type":"Keyword","value":"true"}},{"$type":"CharacterRange","left":{"$type":"Keyword","value":"false"}}]},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ACC_DESCR","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*accDescr(?:[\\\\t ]*:([^\\\\n\\\\r]*?(?=%%)|[^\\\\n\\\\r]*)|\\\\s*{([^}]*)})/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ACC_TITLE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*accTitle[\\\\t ]*:(?:[^\\\\n\\\\r]*?(?=%%)|[^\\\\n\\\\r]*)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"TITLE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*title(?:[\\\\t ][^\\\\n\\\\r]*?(?=%%)|[\\\\t ][^\\\\n\\\\r]*|)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"FLOAT","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"RegexToken","regex":"/[0-9]+\\\\.[0-9]+(?!\\\\.)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"INT","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"RegexToken","regex":"/0|[1-9][0-9]*(?!\\\\.)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"NUMBER","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"TerminalAlternatives","elements":[{"$type":"TerminalRuleCall","rule":{"$ref":"#/rules@7"}},{"$type":"TerminalRuleCall","rule":{"$ref":"#/rules@8"}}]},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"STRING","type":{"$type":"ReturnType","name":"string"},"definition":{"$type":"RegexToken","regex":"/\\"([^\\"\\\\\\\\]|\\\\\\\\.)*\\"|'([^'\\\\\\\\]|\\\\\\\\.)*'/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ID","type":{"$type":"ReturnType","name":"string"},"definition":{"$type":"RegexToken","regex":"/[\\\\w]([-\\\\w]*\\\\w)?/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"NEWLINE","definition":{"$type":"RegexToken","regex":"/\\\\r?\\\\n/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","hidden":true,"name":"WHITESPACE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]+/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"YAML","definition":{"$type":"RegexToken","regex":"/---[\\\\t ]*\\\\r?\\\\n(?:[\\\\S\\\\s]*?\\\\r?\\\\n)?---(?:\\\\r?\\\\n|(?!\\\\S))/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"DIRECTIVE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*%%{[\\\\S\\\\s]*?}%%(?:\\\\r?\\\\n|(?!\\\\S))/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"SINGLE_LINE_COMMENT","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*%%[^\\\\n\\\\r]*/"},"fragment":false}],"definesHiddenTokens":false,"hiddenTokens":[],"interfaces":[],"types":[],"usedGrammars":[]}`)),"InfoGrammar"),Rl,Wg=v(()=>Rl??(Rl=xt(`{"$type":"Grammar","isDeclared":true,"name":"Packet","imports":[],"rules":[{"$type":"ParserRule","entry":true,"name":"Packet","definition":{"$type":"Group","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@13"},"arguments":[],"cardinality":"*"},{"$type":"Alternatives","elements":[{"$type":"Keyword","value":"packet"},{"$type":"Keyword","value":"packet-beta"}]},{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@3"},"arguments":[]},{"$type":"Assignment","feature":"blocks","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@1"},"arguments":[]}},{"$type":"RuleCall","rule":{"$ref":"#/rules@13"},"arguments":[]}],"cardinality":"*"}]},"definesHiddenTokens":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"PacketBlock","definition":{"$type":"Group","elements":[{"$type":"Alternatives","elements":[{"$type":"Group","elements":[{"$type":"Assignment","feature":"start","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@9"},"arguments":[]}},{"$type":"Group","elements":[{"$type":"Keyword","value":"-"},{"$type":"Assignment","feature":"end","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@9"},"arguments":[]}}],"cardinality":"?"}]},{"$type":"Group","elements":[{"$type":"Keyword","value":"+"},{"$type":"Assignment","feature":"bits","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@9"},"arguments":[]}}]}]},{"$type":"Keyword","value":":"},{"$type":"Assignment","feature":"label","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@11"},"arguments":[]}},{"$type":"RuleCall","rule":{"$ref":"#/rules@2"},"arguments":[]}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","fragment":true,"name":"EOL","dataType":"string","definition":{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@13"},"arguments":[],"cardinality":"+"},{"$type":"EndOfFile"}]},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","fragment":true,"name":"TitleAndAccessibilities","definition":{"$type":"Group","elements":[{"$type":"Alternatives","elements":[{"$type":"Assignment","feature":"accDescr","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@5"},"arguments":[]}},{"$type":"Assignment","feature":"accTitle","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@6"},"arguments":[]}},{"$type":"Assignment","feature":"title","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@7"},"arguments":[]}}]},{"$type":"RuleCall","rule":{"$ref":"#/rules@2"},"arguments":[]}],"cardinality":"+"},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"TerminalRule","name":"BOOLEAN","type":{"$type":"ReturnType","name":"boolean"},"definition":{"$type":"TerminalAlternatives","elements":[{"$type":"CharacterRange","left":{"$type":"Keyword","value":"true"}},{"$type":"CharacterRange","left":{"$type":"Keyword","value":"false"}}]},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ACC_DESCR","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*accDescr(?:[\\\\t ]*:([^\\\\n\\\\r]*?(?=%%)|[^\\\\n\\\\r]*)|\\\\s*{([^}]*)})/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ACC_TITLE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*accTitle[\\\\t ]*:(?:[^\\\\n\\\\r]*?(?=%%)|[^\\\\n\\\\r]*)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"TITLE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*title(?:[\\\\t ][^\\\\n\\\\r]*?(?=%%)|[\\\\t ][^\\\\n\\\\r]*|)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"FLOAT","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"RegexToken","regex":"/[0-9]+\\\\.[0-9]+(?!\\\\.)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"INT","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"RegexToken","regex":"/0|[1-9][0-9]*(?!\\\\.)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"NUMBER","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"TerminalAlternatives","elements":[{"$type":"TerminalRuleCall","rule":{"$ref":"#/rules@8"}},{"$type":"TerminalRuleCall","rule":{"$ref":"#/rules@9"}}]},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"STRING","type":{"$type":"ReturnType","name":"string"},"definition":{"$type":"RegexToken","regex":"/\\"([^\\"\\\\\\\\]|\\\\\\\\.)*\\"|'([^'\\\\\\\\]|\\\\\\\\.)*'/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ID","type":{"$type":"ReturnType","name":"string"},"definition":{"$type":"RegexToken","regex":"/[\\\\w]([-\\\\w]*\\\\w)?/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"NEWLINE","definition":{"$type":"RegexToken","regex":"/\\\\r?\\\\n/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","hidden":true,"name":"WHITESPACE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]+/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"YAML","definition":{"$type":"RegexToken","regex":"/---[\\\\t ]*\\\\r?\\\\n(?:[\\\\S\\\\s]*?\\\\r?\\\\n)?---(?:\\\\r?\\\\n|(?!\\\\S))/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"DIRECTIVE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*%%{[\\\\S\\\\s]*?}%%(?:\\\\r?\\\\n|(?!\\\\S))/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"SINGLE_LINE_COMMENT","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*%%[^\\\\n\\\\r]*/"},"fragment":false}],"definesHiddenTokens":false,"hiddenTokens":[],"interfaces":[],"types":[],"usedGrammars":[]}`)),"PacketGrammar"),vl,jg=v(()=>vl??(vl=xt(`{"$type":"Grammar","isDeclared":true,"name":"Pie","imports":[],"rules":[{"$type":"ParserRule","entry":true,"name":"Pie","definition":{"$type":"Group","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@16"},"arguments":[],"cardinality":"*"},{"$type":"Keyword","value":"pie"},{"$type":"Assignment","feature":"showData","operator":"?=","terminal":{"$type":"Keyword","value":"showData"},"cardinality":"?"},{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@6"},"arguments":[]},{"$type":"Assignment","feature":"sections","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@1"},"arguments":[]}},{"$type":"RuleCall","rule":{"$ref":"#/rules@16"},"arguments":[]}],"cardinality":"*"}]},"definesHiddenTokens":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"PieSection","definition":{"$type":"Group","elements":[{"$type":"Assignment","feature":"label","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@14"},"arguments":[]}},{"$type":"Keyword","value":":"},{"$type":"Assignment","feature":"value","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@4"},"arguments":[]}},{"$type":"RuleCall","rule":{"$ref":"#/rules@5"},"arguments":[]}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"TerminalRule","name":"FLOAT_PIE","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"RegexToken","regex":"/-?[0-9]+\\\\.[0-9]+(?!\\\\.)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"INT_PIE","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"RegexToken","regex":"/-?(0|[1-9][0-9]*)(?!\\\\.)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"NUMBER_PIE","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"TerminalAlternatives","elements":[{"$type":"TerminalRuleCall","rule":{"$ref":"#/rules@2"}},{"$type":"TerminalRuleCall","rule":{"$ref":"#/rules@3"}}]},"fragment":false,"hidden":false},{"$type":"ParserRule","fragment":true,"name":"EOL","dataType":"string","definition":{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@16"},"arguments":[],"cardinality":"+"},{"$type":"EndOfFile"}]},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","fragment":true,"name":"TitleAndAccessibilities","definition":{"$type":"Group","elements":[{"$type":"Alternatives","elements":[{"$type":"Assignment","feature":"accDescr","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@8"},"arguments":[]}},{"$type":"Assignment","feature":"accTitle","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@9"},"arguments":[]}},{"$type":"Assignment","feature":"title","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@10"},"arguments":[]}}]},{"$type":"RuleCall","rule":{"$ref":"#/rules@5"},"arguments":[]}],"cardinality":"+"},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"TerminalRule","name":"BOOLEAN","type":{"$type":"ReturnType","name":"boolean"},"definition":{"$type":"TerminalAlternatives","elements":[{"$type":"CharacterRange","left":{"$type":"Keyword","value":"true"}},{"$type":"CharacterRange","left":{"$type":"Keyword","value":"false"}}]},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ACC_DESCR","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*accDescr(?:[\\\\t ]*:([^\\\\n\\\\r]*?(?=%%)|[^\\\\n\\\\r]*)|\\\\s*{([^}]*)})/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ACC_TITLE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*accTitle[\\\\t ]*:(?:[^\\\\n\\\\r]*?(?=%%)|[^\\\\n\\\\r]*)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"TITLE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*title(?:[\\\\t ][^\\\\n\\\\r]*?(?=%%)|[\\\\t ][^\\\\n\\\\r]*|)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"FLOAT","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"RegexToken","regex":"/[0-9]+\\\\.[0-9]+(?!\\\\.)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"INT","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"RegexToken","regex":"/0|[1-9][0-9]*(?!\\\\.)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"NUMBER","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"TerminalAlternatives","elements":[{"$type":"TerminalRuleCall","rule":{"$ref":"#/rules@11"}},{"$type":"TerminalRuleCall","rule":{"$ref":"#/rules@12"}}]},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"STRING","type":{"$type":"ReturnType","name":"string"},"definition":{"$type":"RegexToken","regex":"/\\"([^\\"\\\\\\\\]|\\\\\\\\.)*\\"|'([^'\\\\\\\\]|\\\\\\\\.)*'/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ID","type":{"$type":"ReturnType","name":"string"},"definition":{"$type":"RegexToken","regex":"/[\\\\w]([-\\\\w]*\\\\w)?/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"NEWLINE","definition":{"$type":"RegexToken","regex":"/\\\\r?\\\\n/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","hidden":true,"name":"WHITESPACE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]+/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"YAML","definition":{"$type":"RegexToken","regex":"/---[\\\\t ]*\\\\r?\\\\n(?:[\\\\S\\\\s]*?\\\\r?\\\\n)?---(?:\\\\r?\\\\n|(?!\\\\S))/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"DIRECTIVE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*%%{[\\\\S\\\\s]*?}%%(?:\\\\r?\\\\n|(?!\\\\S))/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"SINGLE_LINE_COMMENT","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*%%[^\\\\n\\\\r]*/"},"fragment":false}],"definesHiddenTokens":false,"hiddenTokens":[],"interfaces":[],"types":[],"usedGrammars":[]}`)),"PieGrammar"),Al,Hg=v(()=>Al??(Al=xt(`{"$type":"Grammar","isDeclared":true,"name":"Architecture","imports":[],"rules":[{"$type":"ParserRule","entry":true,"name":"Architecture","definition":{"$type":"Group","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@23"},"arguments":[],"cardinality":"*"},{"$type":"Keyword","value":"architecture-beta"},{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@23"},"arguments":[]},{"$type":"RuleCall","rule":{"$ref":"#/rules@13"},"arguments":[]},{"$type":"RuleCall","rule":{"$ref":"#/rules@1"},"arguments":[]}],"cardinality":"*"}]},"definesHiddenTokens":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","fragment":true,"name":"Statement","definition":{"$type":"Alternatives","elements":[{"$type":"Assignment","feature":"groups","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@5"},"arguments":[]}},{"$type":"Assignment","feature":"services","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@6"},"arguments":[]}},{"$type":"Assignment","feature":"junctions","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@7"},"arguments":[]}},{"$type":"Assignment","feature":"edges","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@8"},"arguments":[]}}]},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","fragment":true,"name":"LeftPort","definition":{"$type":"Group","elements":[{"$type":"Keyword","value":":"},{"$type":"Assignment","feature":"lhsDir","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@9"},"arguments":[]}}]},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","fragment":true,"name":"RightPort","definition":{"$type":"Group","elements":[{"$type":"Assignment","feature":"rhsDir","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@9"},"arguments":[]}},{"$type":"Keyword","value":":"}]},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","fragment":true,"name":"Arrow","definition":{"$type":"Group","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@2"},"arguments":[]},{"$type":"Assignment","feature":"lhsInto","operator":"?=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@11"},"arguments":[]},"cardinality":"?"},{"$type":"Alternatives","elements":[{"$type":"Keyword","value":"--"},{"$type":"Group","elements":[{"$type":"Keyword","value":"-"},{"$type":"Assignment","feature":"title","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@29"},"arguments":[]}},{"$type":"Keyword","value":"-"}]}]},{"$type":"Assignment","feature":"rhsInto","operator":"?=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@11"},"arguments":[]},"cardinality":"?"},{"$type":"RuleCall","rule":{"$ref":"#/rules@3"},"arguments":[]}]},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"Group","definition":{"$type":"Group","elements":[{"$type":"Keyword","value":"group"},{"$type":"Assignment","feature":"id","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@22"},"arguments":[]}},{"$type":"Assignment","feature":"icon","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@28"},"arguments":[]},"cardinality":"?"},{"$type":"Assignment","feature":"title","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@29"},"arguments":[]},"cardinality":"?"},{"$type":"Group","elements":[{"$type":"Keyword","value":"in"},{"$type":"Assignment","feature":"in","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@22"},"arguments":[]}}],"cardinality":"?"},{"$type":"RuleCall","rule":{"$ref":"#/rules@12"},"arguments":[]}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"Service","definition":{"$type":"Group","elements":[{"$type":"Keyword","value":"service"},{"$type":"Assignment","feature":"id","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@22"},"arguments":[]}},{"$type":"Alternatives","elements":[{"$type":"Assignment","feature":"iconText","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@21"},"arguments":[]}},{"$type":"Assignment","feature":"icon","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@28"},"arguments":[]}}],"cardinality":"?"},{"$type":"Assignment","feature":"title","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@29"},"arguments":[]},"cardinality":"?"},{"$type":"Group","elements":[{"$type":"Keyword","value":"in"},{"$type":"Assignment","feature":"in","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@22"},"arguments":[]}}],"cardinality":"?"},{"$type":"RuleCall","rule":{"$ref":"#/rules@12"},"arguments":[]}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"Junction","definition":{"$type":"Group","elements":[{"$type":"Keyword","value":"junction"},{"$type":"Assignment","feature":"id","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@22"},"arguments":[]}},{"$type":"Group","elements":[{"$type":"Keyword","value":"in"},{"$type":"Assignment","feature":"in","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@22"},"arguments":[]}}],"cardinality":"?"},{"$type":"RuleCall","rule":{"$ref":"#/rules@12"},"arguments":[]}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"Edge","definition":{"$type":"Group","elements":[{"$type":"Assignment","feature":"lhsId","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@22"},"arguments":[]}},{"$type":"Assignment","feature":"lhsGroup","operator":"?=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@10"},"arguments":[]},"cardinality":"?"},{"$type":"RuleCall","rule":{"$ref":"#/rules@4"},"arguments":[]},{"$type":"Assignment","feature":"rhsId","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@22"},"arguments":[]}},{"$type":"Assignment","feature":"rhsGroup","operator":"?=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@10"},"arguments":[]},"cardinality":"?"},{"$type":"RuleCall","rule":{"$ref":"#/rules@12"},"arguments":[]}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"TerminalRule","name":"ARROW_DIRECTION","definition":{"$type":"TerminalAlternatives","elements":[{"$type":"TerminalAlternatives","elements":[{"$type":"TerminalAlternatives","elements":[{"$type":"CharacterRange","left":{"$type":"Keyword","value":"L"}},{"$type":"CharacterRange","left":{"$type":"Keyword","value":"R"}}]},{"$type":"CharacterRange","left":{"$type":"Keyword","value":"T"}}]},{"$type":"CharacterRange","left":{"$type":"Keyword","value":"B"}}]},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ARROW_GROUP","definition":{"$type":"RegexToken","regex":"/\\\\{group\\\\}/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ARROW_INTO","definition":{"$type":"RegexToken","regex":"/<|>/"},"fragment":false,"hidden":false},{"$type":"ParserRule","fragment":true,"name":"EOL","dataType":"string","definition":{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@23"},"arguments":[],"cardinality":"+"},{"$type":"EndOfFile"}]},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","fragment":true,"name":"TitleAndAccessibilities","definition":{"$type":"Group","elements":[{"$type":"Alternatives","elements":[{"$type":"Assignment","feature":"accDescr","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@15"},"arguments":[]}},{"$type":"Assignment","feature":"accTitle","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@16"},"arguments":[]}},{"$type":"Assignment","feature":"title","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}}]},{"$type":"RuleCall","rule":{"$ref":"#/rules@12"},"arguments":[]}],"cardinality":"+"},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"TerminalRule","name":"BOOLEAN","type":{"$type":"ReturnType","name":"boolean"},"definition":{"$type":"TerminalAlternatives","elements":[{"$type":"CharacterRange","left":{"$type":"Keyword","value":"true"}},{"$type":"CharacterRange","left":{"$type":"Keyword","value":"false"}}]},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ACC_DESCR","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*accDescr(?:[\\\\t ]*:([^\\\\n\\\\r]*?(?=%%)|[^\\\\n\\\\r]*)|\\\\s*{([^}]*)})/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ACC_TITLE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*accTitle[\\\\t ]*:(?:[^\\\\n\\\\r]*?(?=%%)|[^\\\\n\\\\r]*)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"TITLE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*title(?:[\\\\t ][^\\\\n\\\\r]*?(?=%%)|[\\\\t ][^\\\\n\\\\r]*|)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"FLOAT","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"RegexToken","regex":"/[0-9]+\\\\.[0-9]+(?!\\\\.)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"INT","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"RegexToken","regex":"/0|[1-9][0-9]*(?!\\\\.)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"NUMBER","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"TerminalAlternatives","elements":[{"$type":"TerminalRuleCall","rule":{"$ref":"#/rules@18"}},{"$type":"TerminalRuleCall","rule":{"$ref":"#/rules@19"}}]},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"STRING","type":{"$type":"ReturnType","name":"string"},"definition":{"$type":"RegexToken","regex":"/\\"([^\\"\\\\\\\\]|\\\\\\\\.)*\\"|'([^'\\\\\\\\]|\\\\\\\\.)*'/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ID","type":{"$type":"ReturnType","name":"string"},"definition":{"$type":"RegexToken","regex":"/[\\\\w]([-\\\\w]*\\\\w)?/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"NEWLINE","definition":{"$type":"RegexToken","regex":"/\\\\r?\\\\n/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","hidden":true,"name":"WHITESPACE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]+/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"YAML","definition":{"$type":"RegexToken","regex":"/---[\\\\t ]*\\\\r?\\\\n(?:[\\\\S\\\\s]*?\\\\r?\\\\n)?---(?:\\\\r?\\\\n|(?!\\\\S))/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"DIRECTIVE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*%%{[\\\\S\\\\s]*?}%%(?:\\\\r?\\\\n|(?!\\\\S))/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"SINGLE_LINE_COMMENT","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*%%[^\\\\n\\\\r]*/"},"fragment":false},{"$type":"TerminalRule","name":"ARCH_ICON","definition":{"$type":"RegexToken","regex":"/\\\\([\\\\w-:]+\\\\)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ARCH_TITLE","definition":{"$type":"RegexToken","regex":"/\\\\[[\\\\w ]+\\\\]/"},"fragment":false,"hidden":false}],"definesHiddenTokens":false,"hiddenTokens":[],"interfaces":[],"types":[],"usedGrammars":[]}`)),"ArchitectureGrammar"),El,zg=v(()=>El??(El=xt(`{"$type":"Grammar","isDeclared":true,"name":"GitGraph","imports":[],"rules":[{"$type":"ParserRule","entry":true,"name":"GitGraph","definition":{"$type":"Group","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@19"},"arguments":[],"cardinality":"*"},{"$type":"Alternatives","elements":[{"$type":"Keyword","value":"gitGraph"},{"$type":"Group","elements":[{"$type":"Keyword","value":"gitGraph"},{"$type":"Keyword","value":":"}]},{"$type":"Keyword","value":"gitGraph:"},{"$type":"Group","elements":[{"$type":"Keyword","value":"gitGraph"},{"$type":"RuleCall","rule":{"$ref":"#/rules@2"},"arguments":[]},{"$type":"Keyword","value":":"}]}]},{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@19"},"arguments":[]},{"$type":"RuleCall","rule":{"$ref":"#/rules@9"},"arguments":[]},{"$type":"Assignment","feature":"statements","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@1"},"arguments":[]}}],"cardinality":"*"}]},"definesHiddenTokens":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"Statement","definition":{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@3"},"arguments":[]},{"$type":"RuleCall","rule":{"$ref":"#/rules@4"},"arguments":[]},{"$type":"RuleCall","rule":{"$ref":"#/rules@5"},"arguments":[]},{"$type":"RuleCall","rule":{"$ref":"#/rules@6"},"arguments":[]},{"$type":"RuleCall","rule":{"$ref":"#/rules@7"},"arguments":[]}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"Direction","definition":{"$type":"Assignment","feature":"dir","operator":"=","terminal":{"$type":"Alternatives","elements":[{"$type":"Keyword","value":"LR"},{"$type":"Keyword","value":"TB"},{"$type":"Keyword","value":"BT"}]}},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"Commit","definition":{"$type":"Group","elements":[{"$type":"Keyword","value":"commit"},{"$type":"Alternatives","elements":[{"$type":"Group","elements":[{"$type":"Keyword","value":"id:"},{"$type":"Assignment","feature":"id","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}}]},{"$type":"Group","elements":[{"$type":"Keyword","value":"msg:","cardinality":"?"},{"$type":"Assignment","feature":"message","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}}]},{"$type":"Group","elements":[{"$type":"Keyword","value":"tag:"},{"$type":"Assignment","feature":"tags","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}}]},{"$type":"Group","elements":[{"$type":"Keyword","value":"type:"},{"$type":"Assignment","feature":"type","operator":"=","terminal":{"$type":"Alternatives","elements":[{"$type":"Keyword","value":"NORMAL"},{"$type":"Keyword","value":"REVERSE"},{"$type":"Keyword","value":"HIGHLIGHT"}]}}]}],"cardinality":"*"},{"$type":"RuleCall","rule":{"$ref":"#/rules@8"},"arguments":[]}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"Branch","definition":{"$type":"Group","elements":[{"$type":"Keyword","value":"branch"},{"$type":"Assignment","feature":"name","operator":"=","terminal":{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@24"},"arguments":[]},{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}]}},{"$type":"Group","elements":[{"$type":"Keyword","value":"order:"},{"$type":"Assignment","feature":"order","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@15"},"arguments":[]}}],"cardinality":"?"},{"$type":"RuleCall","rule":{"$ref":"#/rules@8"},"arguments":[]}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"Merge","definition":{"$type":"Group","elements":[{"$type":"Keyword","value":"merge"},{"$type":"Assignment","feature":"branch","operator":"=","terminal":{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@24"},"arguments":[]},{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}]}},{"$type":"Alternatives","elements":[{"$type":"Group","elements":[{"$type":"Keyword","value":"id:"},{"$type":"Assignment","feature":"id","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}}]},{"$type":"Group","elements":[{"$type":"Keyword","value":"tag:"},{"$type":"Assignment","feature":"tags","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}}]},{"$type":"Group","elements":[{"$type":"Keyword","value":"type:"},{"$type":"Assignment","feature":"type","operator":"=","terminal":{"$type":"Alternatives","elements":[{"$type":"Keyword","value":"NORMAL"},{"$type":"Keyword","value":"REVERSE"},{"$type":"Keyword","value":"HIGHLIGHT"}]}}]}],"cardinality":"*"},{"$type":"RuleCall","rule":{"$ref":"#/rules@8"},"arguments":[]}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"Checkout","definition":{"$type":"Group","elements":[{"$type":"Alternatives","elements":[{"$type":"Keyword","value":"checkout"},{"$type":"Keyword","value":"switch"}]},{"$type":"Assignment","feature":"branch","operator":"=","terminal":{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@24"},"arguments":[]},{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}]}},{"$type":"RuleCall","rule":{"$ref":"#/rules@8"},"arguments":[]}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"CherryPicking","definition":{"$type":"Group","elements":[{"$type":"Keyword","value":"cherry-pick"},{"$type":"Alternatives","elements":[{"$type":"Group","elements":[{"$type":"Keyword","value":"id:"},{"$type":"Assignment","feature":"id","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}}]},{"$type":"Group","elements":[{"$type":"Keyword","value":"tag:"},{"$type":"Assignment","feature":"tags","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}}]},{"$type":"Group","elements":[{"$type":"Keyword","value":"parent:"},{"$type":"Assignment","feature":"parent","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}}]}],"cardinality":"*"},{"$type":"RuleCall","rule":{"$ref":"#/rules@8"},"arguments":[]}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","fragment":true,"name":"EOL","dataType":"string","definition":{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@19"},"arguments":[],"cardinality":"+"},{"$type":"EndOfFile"}]},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","fragment":true,"name":"TitleAndAccessibilities","definition":{"$type":"Group","elements":[{"$type":"Alternatives","elements":[{"$type":"Assignment","feature":"accDescr","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@11"},"arguments":[]}},{"$type":"Assignment","feature":"accTitle","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@12"},"arguments":[]}},{"$type":"Assignment","feature":"title","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@13"},"arguments":[]}}]},{"$type":"RuleCall","rule":{"$ref":"#/rules@8"},"arguments":[]}],"cardinality":"+"},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"TerminalRule","name":"BOOLEAN","type":{"$type":"ReturnType","name":"boolean"},"definition":{"$type":"TerminalAlternatives","elements":[{"$type":"CharacterRange","left":{"$type":"Keyword","value":"true"}},{"$type":"CharacterRange","left":{"$type":"Keyword","value":"false"}}]},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ACC_DESCR","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*accDescr(?:[\\\\t ]*:([^\\\\n\\\\r]*?(?=%%)|[^\\\\n\\\\r]*)|\\\\s*{([^}]*)})/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ACC_TITLE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*accTitle[\\\\t ]*:(?:[^\\\\n\\\\r]*?(?=%%)|[^\\\\n\\\\r]*)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"TITLE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*title(?:[\\\\t ][^\\\\n\\\\r]*?(?=%%)|[\\\\t ][^\\\\n\\\\r]*|)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"FLOAT","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"RegexToken","regex":"/[0-9]+\\\\.[0-9]+(?!\\\\.)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"INT","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"RegexToken","regex":"/0|[1-9][0-9]*(?!\\\\.)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"NUMBER","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"TerminalAlternatives","elements":[{"$type":"TerminalRuleCall","rule":{"$ref":"#/rules@14"}},{"$type":"TerminalRuleCall","rule":{"$ref":"#/rules@15"}}]},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"STRING","type":{"$type":"ReturnType","name":"string"},"definition":{"$type":"RegexToken","regex":"/\\"([^\\"\\\\\\\\]|\\\\\\\\.)*\\"|'([^'\\\\\\\\]|\\\\\\\\.)*'/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ID","type":{"$type":"ReturnType","name":"string"},"definition":{"$type":"RegexToken","regex":"/[\\\\w]([-\\\\w]*\\\\w)?/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"NEWLINE","definition":{"$type":"RegexToken","regex":"/\\\\r?\\\\n/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","hidden":true,"name":"WHITESPACE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]+/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"YAML","definition":{"$type":"RegexToken","regex":"/---[\\\\t ]*\\\\r?\\\\n(?:[\\\\S\\\\s]*?\\\\r?\\\\n)?---(?:\\\\r?\\\\n|(?!\\\\S))/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"DIRECTIVE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*%%{[\\\\S\\\\s]*?}%%(?:\\\\r?\\\\n|(?!\\\\S))/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"SINGLE_LINE_COMMENT","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*%%[^\\\\n\\\\r]*/"},"fragment":false},{"$type":"TerminalRule","name":"REFERENCE","type":{"$type":"ReturnType","name":"string"},"definition":{"$type":"RegexToken","regex":"/\\\\w([-\\\\./\\\\w]*[-\\\\w])?/"},"fragment":false,"hidden":false}],"definesHiddenTokens":false,"hiddenTokens":[],"interfaces":[],"types":[],"usedGrammars":[]}`)),"GitGraphGrammar"),kl,qg=v(()=>kl??(kl=xt(`{"$type":"Grammar","isDeclared":true,"name":"Radar","imports":[],"rules":[{"$type":"ParserRule","entry":true,"name":"Radar","definition":{"$type":"Group","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@20"},"arguments":[],"cardinality":"*"},{"$type":"Alternatives","elements":[{"$type":"Keyword","value":"radar-beta"},{"$type":"Keyword","value":"radar-beta:"},{"$type":"Group","elements":[{"$type":"Keyword","value":"radar-beta"},{"$type":"Keyword","value":":"}]}]},{"$type":"RuleCall","rule":{"$ref":"#/rules@20"},"arguments":[],"cardinality":"*"},{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@10"},"arguments":[]},{"$type":"Group","elements":[{"$type":"Keyword","value":"axis"},{"$type":"Assignment","feature":"axes","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@2"},"arguments":[]}},{"$type":"Group","elements":[{"$type":"Keyword","value":","},{"$type":"Assignment","feature":"axes","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@2"},"arguments":[]}}],"cardinality":"*"}]},{"$type":"Group","elements":[{"$type":"Keyword","value":"curve"},{"$type":"Assignment","feature":"curves","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@3"},"arguments":[]}},{"$type":"Group","elements":[{"$type":"Keyword","value":","},{"$type":"Assignment","feature":"curves","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@3"},"arguments":[]}}],"cardinality":"*"}]},{"$type":"Group","elements":[{"$type":"Assignment","feature":"options","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@7"},"arguments":[]}},{"$type":"Group","elements":[{"$type":"Keyword","value":","},{"$type":"Assignment","feature":"options","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@7"},"arguments":[]}}],"cardinality":"*"}]},{"$type":"RuleCall","rule":{"$ref":"#/rules@20"},"arguments":[]}],"cardinality":"*"}]},"definesHiddenTokens":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","fragment":true,"name":"Label","definition":{"$type":"Group","elements":[{"$type":"Keyword","value":"["},{"$type":"Assignment","feature":"label","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@18"},"arguments":[]}},{"$type":"Keyword","value":"]"}]},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"Axis","definition":{"$type":"Group","elements":[{"$type":"Assignment","feature":"name","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@19"},"arguments":[]}},{"$type":"RuleCall","rule":{"$ref":"#/rules@1"},"arguments":[],"cardinality":"?"}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"Curve","definition":{"$type":"Group","elements":[{"$type":"Assignment","feature":"name","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@19"},"arguments":[]}},{"$type":"RuleCall","rule":{"$ref":"#/rules@1"},"arguments":[],"cardinality":"?"},{"$type":"Keyword","value":"{"},{"$type":"RuleCall","rule":{"$ref":"#/rules@4"},"arguments":[]},{"$type":"Keyword","value":"}"}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","fragment":true,"name":"Entries","definition":{"$type":"Alternatives","elements":[{"$type":"Group","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@20"},"arguments":[],"cardinality":"*"},{"$type":"Assignment","feature":"entries","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@6"},"arguments":[]}},{"$type":"Group","elements":[{"$type":"Keyword","value":","},{"$type":"RuleCall","rule":{"$ref":"#/rules@20"},"arguments":[],"cardinality":"*"},{"$type":"Assignment","feature":"entries","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@6"},"arguments":[]}}],"cardinality":"*"},{"$type":"RuleCall","rule":{"$ref":"#/rules@20"},"arguments":[],"cardinality":"*"}]},{"$type":"Group","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@20"},"arguments":[],"cardinality":"*"},{"$type":"Assignment","feature":"entries","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@5"},"arguments":[]}},{"$type":"Group","elements":[{"$type":"Keyword","value":","},{"$type":"RuleCall","rule":{"$ref":"#/rules@20"},"arguments":[],"cardinality":"*"},{"$type":"Assignment","feature":"entries","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@5"},"arguments":[]}}],"cardinality":"*"},{"$type":"RuleCall","rule":{"$ref":"#/rules@20"},"arguments":[],"cardinality":"*"}]}]},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"DetailedEntry","returnType":{"$ref":"#/interfaces@0"},"definition":{"$type":"Group","elements":[{"$type":"Assignment","feature":"axis","operator":"=","terminal":{"$type":"CrossReference","type":{"$ref":"#/rules@2"},"terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@19"},"arguments":[]},"deprecatedSyntax":false}},{"$type":"Keyword","value":":","cardinality":"?"},{"$type":"Assignment","feature":"value","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"NumberEntry","returnType":{"$ref":"#/interfaces@0"},"definition":{"$type":"Assignment","feature":"value","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"Option","definition":{"$type":"Alternatives","elements":[{"$type":"Group","elements":[{"$type":"Assignment","feature":"name","operator":"=","terminal":{"$type":"Keyword","value":"showLegend"}},{"$type":"Assignment","feature":"value","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@11"},"arguments":[]}}]},{"$type":"Group","elements":[{"$type":"Assignment","feature":"name","operator":"=","terminal":{"$type":"Keyword","value":"ticks"}},{"$type":"Assignment","feature":"value","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}}]},{"$type":"Group","elements":[{"$type":"Assignment","feature":"name","operator":"=","terminal":{"$type":"Keyword","value":"max"}},{"$type":"Assignment","feature":"value","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}}]},{"$type":"Group","elements":[{"$type":"Assignment","feature":"name","operator":"=","terminal":{"$type":"Keyword","value":"min"}},{"$type":"Assignment","feature":"value","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}}]},{"$type":"Group","elements":[{"$type":"Assignment","feature":"name","operator":"=","terminal":{"$type":"Keyword","value":"graticule"}},{"$type":"Assignment","feature":"value","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@8"},"arguments":[]}}]}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"TerminalRule","name":"GRATICULE","type":{"$type":"ReturnType","name":"string"},"definition":{"$type":"TerminalAlternatives","elements":[{"$type":"CharacterRange","left":{"$type":"Keyword","value":"circle"}},{"$type":"CharacterRange","left":{"$type":"Keyword","value":"polygon"}}]},"fragment":false,"hidden":false},{"$type":"ParserRule","fragment":true,"name":"EOL","dataType":"string","definition":{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@20"},"arguments":[],"cardinality":"+"},{"$type":"EndOfFile"}]},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","fragment":true,"name":"TitleAndAccessibilities","definition":{"$type":"Group","elements":[{"$type":"Alternatives","elements":[{"$type":"Assignment","feature":"accDescr","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@12"},"arguments":[]}},{"$type":"Assignment","feature":"accTitle","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@13"},"arguments":[]}},{"$type":"Assignment","feature":"title","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@14"},"arguments":[]}}]},{"$type":"RuleCall","rule":{"$ref":"#/rules@9"},"arguments":[]}],"cardinality":"+"},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"TerminalRule","name":"BOOLEAN","type":{"$type":"ReturnType","name":"boolean"},"definition":{"$type":"TerminalAlternatives","elements":[{"$type":"CharacterRange","left":{"$type":"Keyword","value":"true"}},{"$type":"CharacterRange","left":{"$type":"Keyword","value":"false"}}]},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ACC_DESCR","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*accDescr(?:[\\\\t ]*:([^\\\\n\\\\r]*?(?=%%)|[^\\\\n\\\\r]*)|\\\\s*{([^}]*)})/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ACC_TITLE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*accTitle[\\\\t ]*:(?:[^\\\\n\\\\r]*?(?=%%)|[^\\\\n\\\\r]*)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"TITLE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*title(?:[\\\\t ][^\\\\n\\\\r]*?(?=%%)|[\\\\t ][^\\\\n\\\\r]*|)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"FLOAT","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"RegexToken","regex":"/[0-9]+\\\\.[0-9]+(?!\\\\.)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"INT","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"RegexToken","regex":"/0|[1-9][0-9]*(?!\\\\.)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"NUMBER","type":{"$type":"ReturnType","name":"number"},"definition":{"$type":"TerminalAlternatives","elements":[{"$type":"TerminalRuleCall","rule":{"$ref":"#/rules@15"}},{"$type":"TerminalRuleCall","rule":{"$ref":"#/rules@16"}}]},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"STRING","type":{"$type":"ReturnType","name":"string"},"definition":{"$type":"RegexToken","regex":"/\\"([^\\"\\\\\\\\]|\\\\\\\\.)*\\"|'([^'\\\\\\\\]|\\\\\\\\.)*'/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ID","type":{"$type":"ReturnType","name":"string"},"definition":{"$type":"RegexToken","regex":"/[\\\\w]([-\\\\w]*\\\\w)?/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"NEWLINE","definition":{"$type":"RegexToken","regex":"/\\\\r?\\\\n/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","hidden":true,"name":"WHITESPACE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]+/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"YAML","definition":{"$type":"RegexToken","regex":"/---[\\\\t ]*\\\\r?\\\\n(?:[\\\\S\\\\s]*?\\\\r?\\\\n)?---(?:\\\\r?\\\\n|(?!\\\\S))/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"DIRECTIVE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*%%{[\\\\S\\\\s]*?}%%(?:\\\\r?\\\\n|(?!\\\\S))/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"SINGLE_LINE_COMMENT","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*%%[^\\\\n\\\\r]*/"},"fragment":false}],"interfaces":[{"$type":"Interface","name":"Entry","attributes":[{"$type":"TypeAttribute","name":"axis","isOptional":true,"type":{"$type":"ReferenceType","referenceType":{"$type":"SimpleType","typeRef":{"$ref":"#/rules@2"}}}},{"$type":"TypeAttribute","name":"value","type":{"$type":"SimpleType","primitiveType":"number"},"isOptional":false}],"superTypes":[]}],"definesHiddenTokens":false,"hiddenTokens":[],"types":[],"usedGrammars":[]}`)),"RadarGrammar"),$l,Yg=v(()=>$l??($l=xt(`{"$type":"Grammar","isDeclared":true,"name":"Treemap","rules":[{"$type":"ParserRule","fragment":true,"name":"TitleAndAccessibilities","definition":{"$type":"Alternatives","elements":[{"$type":"Assignment","feature":"accDescr","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@2"},"arguments":[]}},{"$type":"Assignment","feature":"accTitle","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@3"},"arguments":[]}},{"$type":"Assignment","feature":"title","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@4"},"arguments":[]}}],"cardinality":"+"},"definesHiddenTokens":false,"entry":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"TerminalRule","name":"BOOLEAN","type":{"$type":"ReturnType","name":"boolean"},"definition":{"$type":"TerminalAlternatives","elements":[{"$type":"CharacterRange","left":{"$type":"Keyword","value":"true"}},{"$type":"CharacterRange","left":{"$type":"Keyword","value":"false"}}]},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ACC_DESCR","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*accDescr(?:[\\\\t ]*:([^\\\\n\\\\r]*?(?=%%)|[^\\\\n\\\\r]*)|\\\\s*{([^}]*)})/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ACC_TITLE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*accTitle[\\\\t ]*:(?:[^\\\\n\\\\r]*?(?=%%)|[^\\\\n\\\\r]*)/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"TITLE","definition":{"$type":"RegexToken","regex":"/[\\\\t ]*title(?:[\\\\t ][^\\\\n\\\\r]*?(?=%%)|[\\\\t ][^\\\\n\\\\r]*|)/"},"fragment":false,"hidden":false},{"$type":"ParserRule","entry":true,"name":"Treemap","returnType":{"$ref":"#/interfaces@4"},"definition":{"$type":"Group","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@6"},"arguments":[]},{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@0"},"arguments":[]},{"$type":"Assignment","feature":"TreemapRows","operator":"+=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@14"},"arguments":[]}}],"cardinality":"*"}]},"definesHiddenTokens":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"TerminalRule","name":"TREEMAP_KEYWORD","definition":{"$type":"TerminalAlternatives","elements":[{"$type":"CharacterRange","left":{"$type":"Keyword","value":"treemap-beta"}},{"$type":"CharacterRange","left":{"$type":"Keyword","value":"treemap"}}]},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"CLASS_DEF","definition":{"$type":"RegexToken","regex":"/classDef\\\\s+([a-zA-Z_][a-zA-Z0-9_]+)(?:\\\\s+([^;\\\\r\\\\n]*))?(?:;)?/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"STYLE_SEPARATOR","definition":{"$type":"CharacterRange","left":{"$type":"Keyword","value":":::"}},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"SEPARATOR","definition":{"$type":"CharacterRange","left":{"$type":"Keyword","value":":"}},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"COMMA","definition":{"$type":"CharacterRange","left":{"$type":"Keyword","value":","}},"fragment":false,"hidden":false},{"$type":"TerminalRule","hidden":true,"name":"WS","definition":{"$type":"RegexToken","regex":"/[ \\\\t]+/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"ML_COMMENT","definition":{"$type":"RegexToken","regex":"/\\\\%\\\\%[^\\\\n]*/"},"fragment":false},{"$type":"TerminalRule","hidden":true,"name":"NL","definition":{"$type":"RegexToken","regex":"/\\\\r?\\\\n/"},"fragment":false},{"$type":"ParserRule","name":"TreemapRow","definition":{"$type":"Group","elements":[{"$type":"Assignment","feature":"indent","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@19"},"arguments":[]},"cardinality":"?"},{"$type":"Alternatives","elements":[{"$type":"Assignment","feature":"item","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@16"},"arguments":[]}},{"$type":"RuleCall","rule":{"$ref":"#/rules@15"},"arguments":[]}]}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"ClassDef","dataType":"string","definition":{"$type":"RuleCall","rule":{"$ref":"#/rules@7"},"arguments":[]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"Item","returnType":{"$ref":"#/interfaces@0"},"definition":{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@18"},"arguments":[]},{"$type":"RuleCall","rule":{"$ref":"#/rules@17"},"arguments":[]}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"Section","returnType":{"$ref":"#/interfaces@1"},"definition":{"$type":"Group","elements":[{"$type":"Assignment","feature":"name","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@23"},"arguments":[]}},{"$type":"Group","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@8"},"arguments":[]},{"$type":"Assignment","feature":"classSelector","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@20"},"arguments":[]}}],"cardinality":"?"}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"ParserRule","name":"Leaf","returnType":{"$ref":"#/interfaces@2"},"definition":{"$type":"Group","elements":[{"$type":"Assignment","feature":"name","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@23"},"arguments":[]}},{"$type":"RuleCall","rule":{"$ref":"#/rules@19"},"arguments":[],"cardinality":"?"},{"$type":"Alternatives","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@9"},"arguments":[]},{"$type":"RuleCall","rule":{"$ref":"#/rules@10"},"arguments":[]}]},{"$type":"RuleCall","rule":{"$ref":"#/rules@19"},"arguments":[],"cardinality":"?"},{"$type":"Assignment","feature":"value","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@22"},"arguments":[]}},{"$type":"Group","elements":[{"$type":"RuleCall","rule":{"$ref":"#/rules@8"},"arguments":[]},{"$type":"Assignment","feature":"classSelector","operator":"=","terminal":{"$type":"RuleCall","rule":{"$ref":"#/rules@20"},"arguments":[]}}],"cardinality":"?"}]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"TerminalRule","name":"INDENTATION","definition":{"$type":"RegexToken","regex":"/[ \\\\t]{1,}/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"ID2","definition":{"$type":"RegexToken","regex":"/[a-zA-Z_][a-zA-Z0-9_]*/"},"fragment":false,"hidden":false},{"$type":"TerminalRule","name":"NUMBER2","definition":{"$type":"RegexToken","regex":"/[0-9_\\\\.\\\\,]+/"},"fragment":false,"hidden":false},{"$type":"ParserRule","name":"MyNumber","dataType":"number","definition":{"$type":"RuleCall","rule":{"$ref":"#/rules@21"},"arguments":[]},"definesHiddenTokens":false,"entry":false,"fragment":false,"hiddenTokens":[],"parameters":[],"wildcard":false},{"$type":"TerminalRule","name":"STRING2","definition":{"$type":"RegexToken","regex":"/\\"[^\\"]*\\"|'[^']*'/"},"fragment":false,"hidden":false}],"interfaces":[{"$type":"Interface","name":"Item","attributes":[{"$type":"TypeAttribute","name":"name","type":{"$type":"SimpleType","primitiveType":"string"},"isOptional":false},{"$type":"TypeAttribute","name":"classSelector","isOptional":true,"type":{"$type":"SimpleType","primitiveType":"string"}}],"superTypes":[]},{"$type":"Interface","name":"Section","superTypes":[{"$ref":"#/interfaces@0"}],"attributes":[]},{"$type":"Interface","name":"Leaf","superTypes":[{"$ref":"#/interfaces@0"}],"attributes":[{"$type":"TypeAttribute","name":"value","type":{"$type":"SimpleType","primitiveType":"number"},"isOptional":false}]},{"$type":"Interface","name":"ClassDefStatement","attributes":[{"$type":"TypeAttribute","name":"className","type":{"$type":"SimpleType","primitiveType":"string"},"isOptional":false},{"$type":"TypeAttribute","name":"styleText","type":{"$type":"SimpleType","primitiveType":"string"},"isOptional":false}],"superTypes":[]},{"$type":"Interface","name":"Treemap","attributes":[{"$type":"TypeAttribute","name":"TreemapRows","type":{"$type":"ArrayType","elementType":{"$type":"SimpleType","typeRef":{"$ref":"#/rules@14"}}},"isOptional":false},{"$type":"TypeAttribute","name":"title","isOptional":true,"type":{"$type":"SimpleType","primitiveType":"string"}},{"$type":"TypeAttribute","name":"accTitle","isOptional":true,"type":{"$type":"SimpleType","primitiveType":"string"}},{"$type":"TypeAttribute","name":"accDescr","isOptional":true,"type":{"$type":"SimpleType","primitiveType":"string"}}],"superTypes":[]}],"definesHiddenTokens":false,"hiddenTokens":[],"imports":[],"types":[],"usedGrammars":[],"$comment":"/**\\n * Treemap grammar for Langium\\n * Converted from mindmap grammar\\n *\\n * The ML_COMMENT and NL hidden terminals handle whitespace, comments, and newlines\\n * before the treemap keyword, allowing for empty lines and comments before the\\n * treemap declaration.\\n */"}`)),"TreemapGrammar"),Xg={languageId:"info",fileExtensions:[".mmd",".mermaid"],caseInsensitive:!1,mode:"production"},Jg={languageId:"packet",fileExtensions:[".mmd",".mermaid"],caseInsensitive:!1,mode:"production"},Qg={languageId:"pie",fileExtensions:[".mmd",".mermaid"],caseInsensitive:!1,mode:"production"},Zg={languageId:"architecture",fileExtensions:[".mmd",".mermaid"],caseInsensitive:!1,mode:"production"},ey={languageId:"gitGraph",fileExtensions:[".mmd",".mermaid"],caseInsensitive:!1,mode:"production"},ty={languageId:"radar",fileExtensions:[".mmd",".mermaid"],caseInsensitive:!1,mode:"production"},ny={languageId:"treemap",fileExtensions:[".mmd",".mermaid"],caseInsensitive:!1,mode:"production"},St={AstReflection:v(()=>new hu,"AstReflection")},ry={Grammar:v(()=>Kg(),"Grammar"),LanguageMetaData:v(()=>Xg,"LanguageMetaData"),parser:{}},iy={Grammar:v(()=>Wg(),"Grammar"),LanguageMetaData:v(()=>Jg,"LanguageMetaData"),parser:{}},sy={Grammar:v(()=>jg(),"Grammar"),LanguageMetaData:v(()=>Qg,"LanguageMetaData"),parser:{}},ay={Grammar:v(()=>Hg(),"Grammar"),LanguageMetaData:v(()=>Zg,"LanguageMetaData"),parser:{}},oy={Grammar:v(()=>zg(),"Grammar"),LanguageMetaData:v(()=>ey,"LanguageMetaData"),parser:{}},ly={Grammar:v(()=>qg(),"Grammar"),LanguageMetaData:v(()=>ty,"LanguageMetaData"),parser:{}},cy={Grammar:v(()=>Yg(),"Grammar"),LanguageMetaData:v(()=>ny,"LanguageMetaData"),parser:{}},uy=/accDescr(?:[\t ]*:([^\n\r]*)|\s*{([^}]*)})/,dy=/accTitle[\t ]*:([^\n\r]*)/,fy=/title([\t ][^\n\r]*|)/,hy={ACC_DESCR:uy,ACC_TITLE:dy,TITLE:fy},Ot,Ii=(Ot=class extends Zc{runConverter(e,t,r){let i=this.runCommonConverter(e,t,r);return i===void 0&&(i=this.runCustomConverter(e,t,r)),i===void 0?super.runConverter(e,t,r):i}runCommonConverter(e,t,r){const i=hy[e.name];if(i===void 0)return;const s=i.exec(t);if(s!==null){if(s[1]!==void 0)return s[1].trim().replace(/[\t ]{2,}/gm," ");if(s[2]!==void 0)return s[2].replace(/^\s*/gm,"").replace(/\s+$/gm,"").replace(/[\t ]{2,}/gm," ").replace(/[\n\r]{2,}/gm,`
-`)}}},v(Ot,"AbstractMermaidValueConverter"),Ot),Pt,Ci=(Pt=class extends Ii{runCustomConverter(e,t,r){}},v(Pt,"CommonValueConverter"),Pt),Mt,ct=(Mt=class extends Qc{constructor(e){super(),this.keywords=new Set(e)}buildKeywordTokens(e,t,r){const i=super.buildKeywordTokens(e,t,r);return i.forEach(s=>{this.keywords.has(s.name)&&s.PATTERN!==void 0&&(s.PATTERN=new RegExp(s.PATTERN.toString()+"(?:(?=%%)|(?!\\S))"))}),i}},v(Mt,"AbstractMermaidTokenBuilder"),Mt),Dt;Dt=class extends ct{},v(Dt,"CommonTokenBuilder");var Ft,py=(Ft=class extends ct{constructor(){super(["gitGraph"])}},v(Ft,"GitGraphTokenBuilder"),Ft),pu={parser:{TokenBuilder:v(()=>new py,"TokenBuilder"),ValueConverter:v(()=>new Ci,"ValueConverter")}};function mu(n=lt){const e=oe(ot(n),St),t=oe(at({shared:e}),oy,pu);return e.ServiceRegistry.register(t),{shared:e,GitGraph:t}}v(mu,"createGitGraphServices");var Gt,my=(Gt=class extends ct{constructor(){super(["info","showInfo"])}},v(Gt,"InfoTokenBuilder"),Gt),gu={parser:{TokenBuilder:v(()=>new my,"TokenBuilder"),ValueConverter:v(()=>new Ci,"ValueConverter")}};function yu(n=lt){const e=oe(ot(n),St),t=oe(at({shared:e}),ry,gu);return e.ServiceRegistry.register(t),{shared:e,Info:t}}v(yu,"createInfoServices");var Ut,gy=(Ut=class extends ct{constructor(){super(["packet"])}},v(Ut,"PacketTokenBuilder"),Ut),Tu={parser:{TokenBuilder:v(()=>new gy,"TokenBuilder"),ValueConverter:v(()=>new Ci,"ValueConverter")}};function Ru(n=lt){const e=oe(ot(n),St),t=oe(at({shared:e}),iy,Tu);return e.ServiceRegistry.register(t),{shared:e,Packet:t}}v(Ru,"createPacketServices");var Bt,yy=(Bt=class extends ct{constructor(){super(["pie","showData"])}},v(Bt,"PieTokenBuilder"),Bt),Vt,Ty=(Vt=class extends Ii{runCustomConverter(e,t,r){if(e.name==="PIE_SECTION_LABEL")return t.replace(/"/g,"").trim()}},v(Vt,"PieValueConverter"),Vt),vu={parser:{TokenBuilder:v(()=>new yy,"TokenBuilder"),ValueConverter:v(()=>new Ty,"ValueConverter")}};function Au(n=lt){const e=oe(ot(n),St),t=oe(at({shared:e}),sy,vu);return e.ServiceRegistry.register(t),{shared:e,Pie:t}}v(Au,"createPieServices");var Kt,Ry=(Kt=class extends ct{constructor(){super(["architecture"])}},v(Kt,"ArchitectureTokenBuilder"),Kt),Wt,vy=(Wt=class extends Ii{runCustomConverter(e,t,r){if(e.name==="ARCH_ICON")return t.replace(/[()]/g,"").trim();if(e.name==="ARCH_TEXT_ICON")return t.replace(/["()]/g,"");if(e.name==="ARCH_TITLE")return t.replace(/[[\]]/g,"").trim()}},v(Wt,"ArchitectureValueConverter"),Wt),Eu={parser:{TokenBuilder:v(()=>new Ry,"TokenBuilder"),ValueConverter:v(()=>new vy,"ValueConverter")}};function ku(n=lt){const e=oe(ot(n),St),t=oe(at({shared:e}),ay,Eu);return e.ServiceRegistry.register(t),{shared:e,Architecture:t}}v(ku,"createArchitectureServices");var jt,Ay=(jt=class extends ct{constructor(){super(["radar-beta"])}},v(jt,"RadarTokenBuilder"),jt),$u={parser:{TokenBuilder:v(()=>new Ay,"TokenBuilder"),ValueConverter:v(()=>new Ci,"ValueConverter")}};function xu(n=lt){const e=oe(ot(n),St),t=oe(at({shared:e}),ly,$u);return e.ServiceRegistry.register(t),{shared:e,Radar:t}}v(xu,"createRadarServices");var Ht,Ey=(Ht=class extends ct{constructor(){super(["treemap"])}},v(Ht,"TreemapTokenBuilder"),Ht),ky=/classDef\s+([A-Z_a-z]\w+)(?:\s+([^\n\r;]*))?;?/,zt,$y=(zt=class extends Ii{runCustomConverter(e,t,r){if(e.name==="NUMBER2")return parseFloat(t.replace(/,/g,""));if(e.name==="SEPARATOR")return t.substring(1,t.length-1);if(e.name==="STRING2")return t.substring(1,t.length-1);if(e.name==="INDENTATION")return t.length;if(e.name==="ClassDef"){if(typeof t!="string")return t;const i=ky.exec(t);if(i)return{$type:"ClassDefStatement",className:i[1],styleText:i[2]||void 0}}}},v(zt,"TreemapValueConverter"),zt);function Su(n){const e=n.validation.TreemapValidator,t=n.validation.ValidationRegistry;if(t){const r={Treemap:e.checkSingleRoot.bind(e)};t.register(r,e)}}v(Su,"registerValidationChecks");var qt,xy=(qt=class{checkSingleRoot(e,t){let r;for(const i of e.TreemapRows)i.item&&(r===void 0&&i.indent===void 0?r=0:i.indent===void 0?t("error","Multiple root nodes are not allowed in a treemap.",{node:i,property:"item"}):r!==void 0&&r>=parseInt(i.indent,10)&&t("error","Multiple root nodes are not allowed in a treemap.",{node:i,property:"item"}))}},v(qt,"TreemapValidator"),qt),Iu={parser:{TokenBuilder:v(()=>new Ey,"TokenBuilder"),ValueConverter:v(()=>new $y,"ValueConverter")},validation:{TreemapValidator:v(()=>new xy,"TreemapValidator")}};function Cu(n=lt){const e=oe(ot(n),St),t=oe(at({shared:e}),cy,Iu);return e.ServiceRegistry.register(t),Su(t),{shared:e,Treemap:t}}v(Cu,"createTreemapServices");var je={},Sy={info:v(async()=>{const{createInfoServices:n}=await ft(async()=>{const{createInfoServices:t}=await Promise.resolve().then(()=>Ny);return{createInfoServices:t}},void 0),e=n().Info.parser.LangiumParser;je.info=e},"info"),packet:v(async()=>{const{createPacketServices:n}=await ft(async()=>{const{createPacketServices:t}=await Promise.resolve().then(()=>wy);return{createPacketServices:t}},void 0),e=n().Packet.parser.LangiumParser;je.packet=e},"packet"),pie:v(async()=>{const{createPieServices:n}=await ft(async()=>{const{createPieServices:t}=await Promise.resolve().then(()=>_y);return{createPieServices:t}},void 0),e=n().Pie.parser.LangiumParser;je.pie=e},"pie"),architecture:v(async()=>{const{createArchitectureServices:n}=await ft(async()=>{const{createArchitectureServices:t}=await Promise.resolve().then(()=>Ly);return{createArchitectureServices:t}},void 0),e=n().Architecture.parser.LangiumParser;je.architecture=e},"architecture"),gitGraph:v(async()=>{const{createGitGraphServices:n}=await ft(async()=>{const{createGitGraphServices:t}=await Promise.resolve().then(()=>by);return{createGitGraphServices:t}},void 0),e=n().GitGraph.parser.LangiumParser;je.gitGraph=e},"gitGraph"),radar:v(async()=>{const{createRadarServices:n}=await ft(async()=>{const{createRadarServices:t}=await Promise.resolve().then(()=>Oy);return{createRadarServices:t}},void 0),e=n().Radar.parser.LangiumParser;je.radar=e},"radar"),treemap:v(async()=>{const{createTreemapServices:n}=await ft(async()=>{const{createTreemapServices:t}=await Promise.resolve().then(()=>Py);return{createTreemapServices:t}},void 0),e=n().Treemap.parser.LangiumParser;je.treemap=e},"treemap")};async function Iy(n,e){const t=Sy[n];if(!t)throw new Error(`Unknown diagram type: ${n}`);je[n]||await t();const i=je[n].parse(e);if(i.lexerErrors.length>0||i.parserErrors.length>0)throw new Cy(i);return i.value}v(Iy,"parse");var Yt,Cy=(Yt=class extends Error{constructor(e){const t=e.lexerErrors.map(i=>i.message).join(`
-`),r=e.parserErrors.map(i=>i.message).join(`
-`);super(`Parsing failed: ${t} ${r}`),this.result=e}},v(Yt,"MermaidParseError"),Yt);const Ny=Object.freeze(Object.defineProperty({__proto__:null,InfoModule:gu,createInfoServices:yu},Symbol.toStringTag,{value:"Module"})),wy=Object.freeze(Object.defineProperty({__proto__:null,PacketModule:Tu,createPacketServices:Ru},Symbol.toStringTag,{value:"Module"})),_y=Object.freeze(Object.defineProperty({__proto__:null,PieModule:vu,createPieServices:Au},Symbol.toStringTag,{value:"Module"})),Ly=Object.freeze(Object.defineProperty({__proto__:null,ArchitectureModule:Eu,createArchitectureServices:ku},Symbol.toStringTag,{value:"Module"})),by=Object.freeze(Object.defineProperty({__proto__:null,GitGraphModule:pu,createGitGraphServices:mu},Symbol.toStringTag,{value:"Module"})),Oy=Object.freeze(Object.defineProperty({__proto__:null,RadarModule:$u,createRadarServices:xu},Symbol.toStringTag,{value:"Module"})),Py=Object.freeze(Object.defineProperty({__proto__:null,TreemapModule:Iu,createTreemapServices:Cu},Symbol.toStringTag,{value:"Module"}));export{Iy as p};
diff --git a/docs/dist/assets/xychartDiagram-PRI3JC2R-DBIK1dAC.js b/docs/dist/assets/xychartDiagram-PRI3JC2R-DBIK1dAC.js
deleted file mode 100644
index 714dd512..00000000
--- a/docs/dist/assets/xychartDiagram-PRI3JC2R-DBIK1dAC.js
+++ /dev/null
@@ -1,7 +0,0 @@
-import{_ as a,s as gi,g as xi,q as Xt,p as di,a as fi,b as pi,l as Nt,H as mi,e as yi,y as bi,E as St,D as Yt,F as Ai,K as wi,i as Ci,aF as Si,R as Wt}from"./index-BxX29htg.js";import{i as _i}from"./init-Gi6I4Gst.js";import{o as ki}from"./ordinal-Cboi1Yqb.js";import{l as zt}from"./linear-hh6lJPrN.js";import"./defaultLocale-C4B-KCzX.js";function Ri(e,t,i){e=+e,t=+t,i=(n=arguments.length)<2?(t=e,e=0,1):n<3?1:+i;for(var s=-1,n=Math.max(0,Math.ceil((t-e)/i))|0,o=new Array(n);++s<n;)o[s]=e+s*i;return o}function yt(){var e=ki().unknown(void 0),t=e.domain,i=e.range,s=0,n=1,o,g,m=!1,p=0,k=0,v=.5;delete e.unknown;function C(){var b=t().length,E=n<s,D=E?n:s,P=E?s:n;o=(P-D)/Math.max(1,b-p+k*2),m&&(o=Math.floor(o)),D+=(P-D-o*(b-p))*v,g=o*(1-p),m&&(D=Math.round(D),g=Math.round(g));var I=Ri(b).map(function(y){return D+o*y});return i(E?I.reverse():I)}return e.domain=function(b){return arguments.length?(t(b),C()):t()},e.range=function(b){return arguments.length?([s,n]=b,s=+s,n=+n,C()):[s,n]},e.rangeRound=function(b){return[s,n]=b,s=+s,n=+n,m=!0,C()},e.bandwidth=function(){return g},e.step=function(){return o},e.round=function(b){return arguments.length?(m=!!b,C()):m},e.padding=function(b){return arguments.length?(p=Math.min(1,k=+b),C()):p},e.paddingInner=function(b){return arguments.length?(p=Math.min(1,b),C()):p},e.paddingOuter=function(b){return arguments.length?(k=+b,C()):k},e.align=function(b){return arguments.length?(v=Math.max(0,Math.min(1,b)),C()):v},e.copy=function(){return yt(t(),[s,n]).round(m).paddingInner(p).paddingOuter(k).align(v)},_i.apply(C(),arguments)}var bt=(function(){var e=a(function(F,h,u,x){for(u=u||{},x=F.length;x--;u[F[x]]=h);return u},"o"),t=[1,10,12,14,16,18,19,21,23],i=[2,6],s=[1,3],n=[1,5],o=[1,6],g=[1,7],m=[1,5,10,12,14,16,18,19,21,23,34,35,36],p=[1,25],k=[1,26],v=[1,28],C=[1,29],b=[1,30],E=[1,31],D=[1,32],P=[1,33],I=[1,34],y=[1,35],_=[1,36],c=[1,37],W=[1,43],z=[1,42],U=[1,47],X=[1,50],l=[1,10,12,14,16,18,19,21,23,34,35,36],L=[1,10,12,14,16,18,19,21,23,24,26,27,28,34,35,36],S=[1,10,12,14,16,18,19,21,23,24,26,27,28,34,35,36,41,42,43,44,45,46,47,48,49,50],R=[1,64],$={trace:a(function(){},"trace"),yy:{},symbols_:{error:2,start:3,eol:4,XYCHART:5,chartConfig:6,document:7,CHART_ORIENTATION:8,statement:9,title:10,text:11,X_AXIS:12,parseXAxis:13,Y_AXIS:14,parseYAxis:15,LINE:16,plotData:17,BAR:18,acc_title:19,acc_title_value:20,acc_descr:21,acc_descr_value:22,acc_descr_multiline_value:23,SQUARE_BRACES_START:24,commaSeparatedNumbers:25,SQUARE_BRACES_END:26,NUMBER_WITH_DECIMAL:27,COMMA:28,xAxisData:29,bandData:30,ARROW_DELIMITER:31,commaSeparatedTexts:32,yAxisData:33,NEWLINE:34,SEMI:35,EOF:36,alphaNum:37,STR:38,MD_STR:39,alphaNumToken:40,AMP:41,NUM:42,ALPHA:43,PLUS:44,EQUALS:45,MULT:46,DOT:47,BRKT:48,MINUS:49,UNDERSCORE:50,$accept:0,$end:1},terminals_:{2:"error",5:"XYCHART",8:"CHART_ORIENTATION",10:"title",12:"X_AXIS",14:"Y_AXIS",16:"LINE",18:"BAR",19:"acc_title",20:"acc_title_value",21:"acc_descr",22:"acc_descr_value",23:"acc_descr_multiline_value",24:"SQUARE_BRACES_START",26:"SQUARE_BRACES_END",27:"NUMBER_WITH_DECIMAL",28:"COMMA",31:"ARROW_DELIMITER",34:"NEWLINE",35:"SEMI",36:"EOF",38:"STR",39:"MD_STR",41:"AMP",42:"NUM",43:"ALPHA",44:"PLUS",45:"EQUALS",46:"MULT",47:"DOT",48:"BRKT",49:"MINUS",50:"UNDERSCORE"},productions_:[0,[3,2],[3,3],[3,2],[3,1],[6,1],[7,0],[7,2],[9,2],[9,2],[9,2],[9,2],[9,2],[9,3],[9,2],[9,3],[9,2],[9,2],[9,1],[17,3],[25,3],[25,1],[13,1],[13,2],[13,1],[29,1],[29,3],[30,3],[32,3],[32,1],[15,1],[15,2],[15,1],[33,3],[4,1],[4,1],[4,1],[11,1],[11,1],[11,1],[37,1],[37,2],[40,1],[40,1],[40,1],[40,1],[40,1],[40,1],[40,1],[40,1],[40,1],[40,1]],performAction:a(function(h,u,x,d,w,r,at){var f=r.length-1;switch(w){case 5:d.setOrientation(r[f]);break;case 9:d.setDiagramTitle(r[f].text.trim());break;case 12:d.setLineData({text:"",type:"text"},r[f]);break;case 13:d.setLineData(r[f-1],r[f]);break;case 14:d.setBarData({text:"",type:"text"},r[f]);break;case 15:d.setBarData(r[f-1],r[f]);break;case 16:this.$=r[f].trim(),d.setAccTitle(this.$);break;case 17:case 18:this.$=r[f].trim(),d.setAccDescription(this.$);break;case 19:this.$=r[f-1];break;case 20:this.$=[Number(r[f-2]),...r[f]];break;case 21:this.$=[Number(r[f])];break;case 22:d.setXAxisTitle(r[f]);break;case 23:d.setXAxisTitle(r[f-1]);break;case 24:d.setXAxisTitle({type:"text",text:""});break;case 25:d.setXAxisBand(r[f]);break;case 26:d.setXAxisRangeData(Number(r[f-2]),Number(r[f]));break;case 27:this.$=r[f-1];break;case 28:this.$=[r[f-2],...r[f]];break;case 29:this.$=[r[f]];break;case 30:d.setYAxisTitle(r[f]);break;case 31:d.setYAxisTitle(r[f-1]);break;case 32:d.setYAxisTitle({type:"text",text:""});break;case 33:d.setYAxisRangeData(Number(r[f-2]),Number(r[f]));break;case 37:this.$={text:r[f],type:"text"};break;case 38:this.$={text:r[f],type:"text"};break;case 39:this.$={text:r[f],type:"markdown"};break;case 40:this.$=r[f];break;case 41:this.$=r[f-1]+""+r[f];break}},"anonymous"),table:[e(t,i,{3:1,4:2,7:4,5:s,34:n,35:o,36:g}),{1:[3]},e(t,i,{4:2,7:4,3:8,5:s,34:n,35:o,36:g}),e(t,i,{4:2,7:4,6:9,3:10,5:s,8:[1,11],34:n,35:o,36:g}),{1:[2,4],9:12,10:[1,13],12:[1,14],14:[1,15],16:[1,16],18:[1,17],19:[1,18],21:[1,19],23:[1,20]},e(m,[2,34]),e(m,[2,35]),e(m,[2,36]),{1:[2,1]},e(t,i,{4:2,7:4,3:21,5:s,34:n,35:o,36:g}),{1:[2,3]},e(m,[2,5]),e(t,[2,7],{4:22,34:n,35:o,36:g}),{11:23,37:24,38:p,39:k,40:27,41:v,42:C,43:b,44:E,45:D,46:P,47:I,48:y,49:_,50:c},{11:39,13:38,24:W,27:z,29:40,30:41,37:24,38:p,39:k,40:27,41:v,42:C,43:b,44:E,45:D,46:P,47:I,48:y,49:_,50:c},{11:45,15:44,27:U,33:46,37:24,38:p,39:k,40:27,41:v,42:C,43:b,44:E,45:D,46:P,47:I,48:y,49:_,50:c},{11:49,17:48,24:X,37:24,38:p,39:k,40:27,41:v,42:C,43:b,44:E,45:D,46:P,47:I,48:y,49:_,50:c},{11:52,17:51,24:X,37:24,38:p,39:k,40:27,41:v,42:C,43:b,44:E,45:D,46:P,47:I,48:y,49:_,50:c},{20:[1,53]},{22:[1,54]},e(l,[2,18]),{1:[2,2]},e(l,[2,8]),e(l,[2,9]),e(L,[2,37],{40:55,41:v,42:C,43:b,44:E,45:D,46:P,47:I,48:y,49:_,50:c}),e(L,[2,38]),e(L,[2,39]),e(S,[2,40]),e(S,[2,42]),e(S,[2,43]),e(S,[2,44]),e(S,[2,45]),e(S,[2,46]),e(S,[2,47]),e(S,[2,48]),e(S,[2,49]),e(S,[2,50]),e(S,[2,51]),e(l,[2,10]),e(l,[2,22],{30:41,29:56,24:W,27:z}),e(l,[2,24]),e(l,[2,25]),{31:[1,57]},{11:59,32:58,37:24,38:p,39:k,40:27,41:v,42:C,43:b,44:E,45:D,46:P,47:I,48:y,49:_,50:c},e(l,[2,11]),e(l,[2,30],{33:60,27:U}),e(l,[2,32]),{31:[1,61]},e(l,[2,12]),{17:62,24:X},{25:63,27:R},e(l,[2,14]),{17:65,24:X},e(l,[2,16]),e(l,[2,17]),e(S,[2,41]),e(l,[2,23]),{27:[1,66]},{26:[1,67]},{26:[2,29],28:[1,68]},e(l,[2,31]),{27:[1,69]},e(l,[2,13]),{26:[1,70]},{26:[2,21],28:[1,71]},e(l,[2,15]),e(l,[2,26]),e(l,[2,27]),{11:59,32:72,37:24,38:p,39:k,40:27,41:v,42:C,43:b,44:E,45:D,46:P,47:I,48:y,49:_,50:c},e(l,[2,33]),e(l,[2,19]),{25:73,27:R},{26:[2,28]},{26:[2,20]}],defaultActions:{8:[2,1],10:[2,3],21:[2,2],72:[2,28],73:[2,20]},parseError:a(function(h,u){if(u.recoverable)this.trace(h);else{var x=new Error(h);throw x.hash=u,x}},"parseError"),parse:a(function(h){var u=this,x=[0],d=[],w=[null],r=[],at=this.table,f="",lt=0,It=0,hi=2,Mt=1,li=r.slice.call(arguments,1),T=Object.create(this.lexer),Y={yy:{}};for(var dt in this.yy)Object.prototype.hasOwnProperty.call(this.yy,dt)&&(Y.yy[dt]=this.yy[dt]);T.setInput(h,Y.yy),Y.yy.lexer=T,Y.yy.parser=this,typeof T.yylloc>"u"&&(T.yylloc={});var ft=T.yylloc;r.push(ft);var ci=T.options&&T.options.ranges;typeof Y.yy.parseError=="function"?this.parseError=Y.yy.parseError:this.parseError=Object.getPrototypeOf(this).parseError;function ui(V){x.length=x.length-2*V,w.length=w.length-V,r.length=r.length-V}a(ui,"popStack");function Vt(){var V;return V=d.pop()||T.lex()||Mt,typeof V!="number"&&(V instanceof Array&&(d=V,V=d.pop()),V=u.symbols_[V]||V),V}a(Vt,"lex");for(var M,H,B,pt,q={},ct,O,Bt,ut;;){if(H=x[x.length-1],this.defaultActions[H]?B=this.defaultActions[H]:((M===null||typeof M>"u")&&(M=Vt()),B=at[H]&&at[H][M]),typeof B>"u"||!B.length||!B[0]){var mt="";ut=[];for(ct in at[H])this.terminals_[ct]&&ct>hi&&ut.push("'"+this.terminals_[ct]+"'");T.showPosition?mt="Parse error on line "+(lt+1)+`:
-`+T.showPosition()+`
-Expecting `+ut.join(", ")+", got '"+(this.terminals_[M]||M)+"'":mt="Parse error on line "+(lt+1)+": Unexpected "+(M==Mt?"end of input":"'"+(this.terminals_[M]||M)+"'"),this.parseError(mt,{text:T.match,token:this.terminals_[M]||M,line:T.yylineno,loc:ft,expected:ut})}if(B[0]instanceof Array&&B.length>1)throw new Error("Parse Error: multiple actions possible at state: "+H+", token: "+M);switch(B[0]){case 1:x.push(M),w.push(T.yytext),r.push(T.yylloc),x.push(B[1]),M=null,It=T.yyleng,f=T.yytext,lt=T.yylineno,ft=T.yylloc;break;case 2:if(O=this.productions_[B[1]][1],q.$=w[w.length-O],q._$={first_line:r[r.length-(O||1)].first_line,last_line:r[r.length-1].last_line,first_column:r[r.length-(O||1)].first_column,last_column:r[r.length-1].last_column},ci&&(q._$.range=[r[r.length-(O||1)].range[0],r[r.length-1].range[1]]),pt=this.performAction.apply(q,[f,It,lt,Y.yy,B[1],w,r].concat(li)),typeof pt<"u")return pt;O&&(x=x.slice(0,-1*O*2),w=w.slice(0,-1*O),r=r.slice(0,-1*O)),x.push(this.productions_[B[1]][0]),w.push(q.$),r.push(q._$),Bt=at[x[x.length-2]][x[x.length-1]],x.push(Bt);break;case 3:return!0}}return!0},"parse")},Et=(function(){var F={EOF:1,parseError:a(function(u,x){if(this.yy.parser)this.yy.parser.parseError(u,x);else throw new Error(u)},"parseError"),setInput:a(function(h,u){return this.yy=u||this.yy||{},this._input=h,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},"setInput"),input:a(function(){var h=this._input[0];this.yytext+=h,this.yyleng++,this.offset++,this.match+=h,this.matched+=h;var u=h.match(/(?:\r\n?|\n).*/g);return u?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),h},"input"),unput:a(function(h){var u=h.length,x=h.split(/(?:\r\n?|\n)/g);this._input=h+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-u),this.offset-=u;var d=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),x.length-1&&(this.yylineno-=x.length-1);var w=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:x?(x.length===d.length?this.yylloc.first_column:0)+d[d.length-x.length].length-x[0].length:this.yylloc.first_column-u},this.options.ranges&&(this.yylloc.range=[w[0],w[0]+this.yyleng-u]),this.yyleng=this.yytext.length,this},"unput"),more:a(function(){return this._more=!0,this},"more"),reject:a(function(){if(this.options.backtrack_lexer)this._backtrack=!0;else return this.parseError("Lexical error on line "+(this.yylineno+1)+`. You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).
-`+this.showPosition(),{text:"",token:null,line:this.yylineno});return this},"reject"),less:a(function(h){this.unput(this.match.slice(h))},"less"),pastInput:a(function(){var h=this.matched.substr(0,this.matched.length-this.match.length);return(h.length>20?"...":"")+h.substr(-20).replace(/\n/g,"")},"pastInput"),upcomingInput:a(function(){var h=this.match;return h.length<20&&(h+=this._input.substr(0,20-h.length)),(h.substr(0,20)+(h.length>20?"...":"")).replace(/\n/g,"")},"upcomingInput"),showPosition:a(function(){var h=this.pastInput(),u=new Array(h.length+1).join("-");return h+this.upcomingInput()+`
-`+u+"^"},"showPosition"),test_match:a(function(h,u){var x,d,w;if(this.options.backtrack_lexer&&(w={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(w.yylloc.range=this.yylloc.range.slice(0))),d=h[0].match(/(?:\r\n?|\n).*/g),d&&(this.yylineno+=d.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:d?d[d.length-1].length-d[d.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+h[0].length},this.yytext+=h[0],this.match+=h[0],this.matches=h,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(h[0].length),this.matched+=h[0],x=this.performAction.call(this,this.yy,this,u,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),x)return x;if(this._backtrack){for(var r in w)this[r]=w[r];return!1}return!1},"test_match"),next:a(function(){if(this.done)return this.EOF;this._input||(this.done=!0);var h,u,x,d;this._more||(this.yytext="",this.match="");for(var w=this._currentRules(),r=0;r<w.length;r++)if(x=this._input.match(this.rules[w[r]]),x&&(!u||x[0].length>u[0].length)){if(u=x,d=r,this.options.backtrack_lexer){if(h=this.test_match(x,w[r]),h!==!1)return h;if(this._backtrack){u=!1;continue}else return!1}else if(!this.options.flex)break}return u?(h=this.test_match(u,w[d]),h!==!1?h:!1):this._input===""?this.EOF:this.parseError("Lexical error on line "+(this.yylineno+1)+`. Unrecognized text.
-`+this.showPosition(),{text:"",token:null,line:this.yylineno})},"next"),lex:a(function(){var u=this.next();return u||this.lex()},"lex"),begin:a(function(u){this.conditionStack.push(u)},"begin"),popState:a(function(){var u=this.conditionStack.length-1;return u>0?this.conditionStack.pop():this.conditionStack[0]},"popState"),_currentRules:a(function(){return this.conditionStack.length&&this.conditionStack[this.conditionStack.length-1]?this.conditions[this.conditionStack[this.conditionStack.length-1]].rules:this.conditions.INITIAL.rules},"_currentRules"),topState:a(function(u){return u=this.conditionStack.length-1-Math.abs(u||0),u>=0?this.conditionStack[u]:"INITIAL"},"topState"),pushState:a(function(u){this.begin(u)},"pushState"),stateStackSize:a(function(){return this.conditionStack.length},"stateStackSize"),options:{"case-insensitive":!0},performAction:a(function(u,x,d,w){switch(d){case 0:break;case 1:break;case 2:return this.popState(),34;case 3:return this.popState(),34;case 4:return 34;case 5:break;case 6:return 10;case 7:return this.pushState("acc_title"),19;case 8:return this.popState(),"acc_title_value";case 9:return this.pushState("acc_descr"),21;case 10:return this.popState(),"acc_descr_value";case 11:this.pushState("acc_descr_multiline");break;case 12:this.popState();break;case 13:return"acc_descr_multiline_value";case 14:return 5;case 15:return 5;case 16:return 8;case 17:return this.pushState("axis_data"),"X_AXIS";case 18:return this.pushState("axis_data"),"Y_AXIS";case 19:return this.pushState("axis_band_data"),24;case 20:return 31;case 21:return this.pushState("data"),16;case 22:return this.pushState("data"),18;case 23:return this.pushState("data_inner"),24;case 24:return 27;case 25:return this.popState(),26;case 26:this.popState();break;case 27:this.pushState("string");break;case 28:this.popState();break;case 29:return"STR";case 30:return 24;case 31:return 26;case 32:return 43;case 33:return"COLON";case 34:return 44;case 35:return 28;case 36:return 45;case 37:return 46;case 38:return 48;case 39:return 50;case 40:return 47;case 41:return 41;case 42:return 49;case 43:return 42;case 44:break;case 45:return 35;case 46:return 36}},"anonymous"),rules:[/^(?:%%(?!\{)[^\n]*)/i,/^(?:[^\}]%%[^\n]*)/i,/^(?:(\r?\n))/i,/^(?:(\r?\n))/i,/^(?:[\n\r]+)/i,/^(?:%%[^\n]*)/i,/^(?:title\b)/i,/^(?:accTitle\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*:\s*)/i,/^(?:(?!\n||)*[^\n]*)/i,/^(?:accDescr\s*\{\s*)/i,/^(?:\{)/i,/^(?:[^\}]*)/i,/^(?:xychart-beta\b)/i,/^(?:xychart\b)/i,/^(?:(?:vertical|horizontal))/i,/^(?:x-axis\b)/i,/^(?:y-axis\b)/i,/^(?:\[)/i,/^(?:-->)/i,/^(?:line\b)/i,/^(?:bar\b)/i,/^(?:\[)/i,/^(?:[+-]?(?:\d+(?:\.\d+)?|\.\d+))/i,/^(?:\])/i,/^(?:(?:`\)                                    \{ this\.pushState\(md_string\); \}\n<md_string>\(\?:\(\?!`"\)\.\)\+                  \{ return MD_STR; \}\n<md_string>\(\?:`))/i,/^(?:["])/i,/^(?:["])/i,/^(?:[^"]*)/i,/^(?:\[)/i,/^(?:\])/i,/^(?:[A-Za-z]+)/i,/^(?::)/i,/^(?:\+)/i,/^(?:,)/i,/^(?:=)/i,/^(?:\*)/i,/^(?:#)/i,/^(?:[\_])/i,/^(?:\.)/i,/^(?:&)/i,/^(?:-)/i,/^(?:[0-9]+)/i,/^(?:\s+)/i,/^(?:;)/i,/^(?:$)/i],conditions:{data_inner:{rules:[0,1,4,5,6,7,9,11,14,15,16,17,18,21,22,24,25,26,27,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46],inclusive:!0},data:{rules:[0,1,3,4,5,6,7,9,11,14,15,16,17,18,21,22,23,26,27,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46],inclusive:!0},axis_band_data:{rules:[0,1,4,5,6,7,9,11,14,15,16,17,18,21,22,25,26,27,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46],inclusive:!0},axis_data:{rules:[0,1,2,4,5,6,7,9,11,14,15,16,17,18,19,20,21,22,24,26,27,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46],inclusive:!0},acc_descr_multiline:{rules:[12,13],inclusive:!1},acc_descr:{rules:[10],inclusive:!1},acc_title:{rules:[8],inclusive:!1},title:{rules:[],inclusive:!1},md_string:{rules:[],inclusive:!1},string:{rules:[28,29],inclusive:!1},INITIAL:{rules:[0,1,4,5,6,7,9,11,14,15,16,17,18,21,22,26,27,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46],inclusive:!0}}};return F})();$.lexer=Et;function N(){this.yy={}}return a(N,"Parser"),N.prototype=$,$.Parser=N,new N})();bt.parser=bt;var Ti=bt;function At(e){return e.type==="bar"}a(At,"isBarPlot");function _t(e){return e.type==="band"}a(_t,"isBandAxisData");function G(e){return e.type==="linear"}a(G,"isLinearAxisData");var j,Ht=(j=class{constructor(t){this.parentGroup=t}getMaxDimension(t,i){if(!this.parentGroup)return{width:t.reduce((o,g)=>Math.max(g.length,o),0)*i,height:i};const s={width:0,height:0},n=this.parentGroup.append("g").attr("visibility","hidden").attr("font-size",i);for(const o of t){const g=Si(n,1,o),m=g?g.width:o.length*i,p=g?g.height:i;s.width=Math.max(s.width,m),s.height=Math.max(s.height,p)}return n.remove(),s}},a(j,"TextDimensionCalculatorWithFont"),j),Ft=.7,Ot=.2,Q,Ut=(Q=class{constructor(t,i,s,n){this.axisConfig=t,this.title=i,this.textDimensionCalculator=s,this.axisThemeConfig=n,this.boundingRect={x:0,y:0,width:0,height:0},this.axisPosition="left",this.showTitle=!1,this.showLabel=!1,this.showTick=!1,this.showAxisLine=!1,this.outerPadding=0,this.titleTextHeight=0,this.labelTextHeight=0,this.range=[0,10],this.boundingRect={x:0,y:0,width:0,height:0},this.axisPosition="left"}setRange(t){this.range=t,this.axisPosition==="left"||this.axisPosition==="right"?this.boundingRect.height=t[1]-t[0]:this.boundingRect.width=t[1]-t[0],this.recalculateScale()}getRange(){return[this.range[0]+this.outerPadding,this.range[1]-this.outerPadding]}setAxisPosition(t){this.axisPosition=t,this.setRange(this.range)}getTickDistance(){const t=this.getRange();return Math.abs(t[0]-t[1])/this.getTickValues().length}getAxisOuterPadding(){return this.outerPadding}getLabelDimension(){return this.textDimensionCalculator.getMaxDimension(this.getTickValues().map(t=>t.toString()),this.axisConfig.labelFontSize)}recalculateOuterPaddingToDrawBar(){Ft*this.getTickDistance()>this.outerPadding*2&&(this.outerPadding=Math.floor(Ft*this.getTickDistance()/2)),this.recalculateScale()}calculateSpaceIfDrawnHorizontally(t){let i=t.height;if(this.axisConfig.showAxisLine&&i>this.axisConfig.axisLineWidth&&(i-=this.axisConfig.axisLineWidth,this.showAxisLine=!0),this.axisConfig.showLabel){const s=this.getLabelDimension(),n=Ot*t.width;this.outerPadding=Math.min(s.width/2,n);const o=s.height+this.axisConfig.labelPadding*2;this.labelTextHeight=s.height,o<=i&&(i-=o,this.showLabel=!0)}if(this.axisConfig.showTick&&i>=this.axisConfig.tickLength&&(this.showTick=!0,i-=this.axisConfig.tickLength),this.axisConfig.showTitle&&this.title){const s=this.textDimensionCalculator.getMaxDimension([this.title],this.axisConfig.titleFontSize),n=s.height+this.axisConfig.titlePadding*2;this.titleTextHeight=s.height,n<=i&&(i-=n,this.showTitle=!0)}this.boundingRect.width=t.width,this.boundingRect.height=t.height-i}calculateSpaceIfDrawnVertical(t){let i=t.width;if(this.axisConfig.showAxisLine&&i>this.axisConfig.axisLineWidth&&(i-=this.axisConfig.axisLineWidth,this.showAxisLine=!0),this.axisConfig.showLabel){const s=this.getLabelDimension(),n=Ot*t.height;this.outerPadding=Math.min(s.height/2,n);const o=s.width+this.axisConfig.labelPadding*2;o<=i&&(i-=o,this.showLabel=!0)}if(this.axisConfig.showTick&&i>=this.axisConfig.tickLength&&(this.showTick=!0,i-=this.axisConfig.tickLength),this.axisConfig.showTitle&&this.title){const s=this.textDimensionCalculator.getMaxDimension([this.title],this.axisConfig.titleFontSize),n=s.height+this.axisConfig.titlePadding*2;this.titleTextHeight=s.height,n<=i&&(i-=n,this.showTitle=!0)}this.boundingRect.width=t.width-i,this.boundingRect.height=t.height}calculateSpace(t){return this.axisPosition==="left"||this.axisPosition==="right"?this.calculateSpaceIfDrawnVertical(t):this.calculateSpaceIfDrawnHorizontally(t),this.recalculateScale(),{width:this.boundingRect.width,height:this.boundingRect.height}}setBoundingBoxXY(t){this.boundingRect.x=t.x,this.boundingRect.y=t.y}getDrawableElementsForLeftAxis(){const t=[];if(this.showAxisLine){const i=this.boundingRect.x+this.boundingRect.width-this.axisConfig.axisLineWidth/2;t.push({type:"path",groupTexts:["left-axis","axisl-line"],data:[{path:`M ${i},${this.boundingRect.y} L ${i},${this.boundingRect.y+this.boundingRect.height} `,strokeFill:this.axisThemeConfig.axisLineColor,strokeWidth:this.axisConfig.axisLineWidth}]})}if(this.showLabel&&t.push({type:"text",groupTexts:["left-axis","label"],data:this.getTickValues().map(i=>({text:i.toString(),x:this.boundingRect.x+this.boundingRect.width-(this.showLabel?this.axisConfig.labelPadding:0)-(this.showTick?this.axisConfig.tickLength:0)-(this.showAxisLine?this.axisConfig.axisLineWidth:0),y:this.getScaleValue(i),fill:this.axisThemeConfig.labelColor,fontSize:this.axisConfig.labelFontSize,rotation:0,verticalPos:"middle",horizontalPos:"right"}))}),this.showTick){const i=this.boundingRect.x+this.boundingRect.width-(this.showAxisLine?this.axisConfig.axisLineWidth:0);t.push({type:"path",groupTexts:["left-axis","ticks"],data:this.getTickValues().map(s=>({path:`M ${i},${this.getScaleValue(s)} L ${i-this.axisConfig.tickLength},${this.getScaleValue(s)}`,strokeFill:this.axisThemeConfig.tickColor,strokeWidth:this.axisConfig.tickWidth}))})}return this.showTitle&&t.push({type:"text",groupTexts:["left-axis","title"],data:[{text:this.title,x:this.boundingRect.x+this.axisConfig.titlePadding,y:this.boundingRect.y+this.boundingRect.height/2,fill:this.axisThemeConfig.titleColor,fontSize:this.axisConfig.titleFontSize,rotation:270,verticalPos:"top",horizontalPos:"center"}]}),t}getDrawableElementsForBottomAxis(){const t=[];if(this.showAxisLine){const i=this.boundingRect.y+this.axisConfig.axisLineWidth/2;t.push({type:"path",groupTexts:["bottom-axis","axis-line"],data:[{path:`M ${this.boundingRect.x},${i} L ${this.boundingRect.x+this.boundingRect.width},${i}`,strokeFill:this.axisThemeConfig.axisLineColor,strokeWidth:this.axisConfig.axisLineWidth}]})}if(this.showLabel&&t.push({type:"text",groupTexts:["bottom-axis","label"],data:this.getTickValues().map(i=>({text:i.toString(),x:this.getScaleValue(i),y:this.boundingRect.y+this.axisConfig.labelPadding+(this.showTick?this.axisConfig.tickLength:0)+(this.showAxisLine?this.axisConfig.axisLineWidth:0),fill:this.axisThemeConfig.labelColor,fontSize:this.axisConfig.labelFontSize,rotation:0,verticalPos:"top",horizontalPos:"center"}))}),this.showTick){const i=this.boundingRect.y+(this.showAxisLine?this.axisConfig.axisLineWidth:0);t.push({type:"path",groupTexts:["bottom-axis","ticks"],data:this.getTickValues().map(s=>({path:`M ${this.getScaleValue(s)},${i} L ${this.getScaleValue(s)},${i+this.axisConfig.tickLength}`,strokeFill:this.axisThemeConfig.tickColor,strokeWidth:this.axisConfig.tickWidth}))})}return this.showTitle&&t.push({type:"text",groupTexts:["bottom-axis","title"],data:[{text:this.title,x:this.range[0]+(this.range[1]-this.range[0])/2,y:this.boundingRect.y+this.boundingRect.height-this.axisConfig.titlePadding-this.titleTextHeight,fill:this.axisThemeConfig.titleColor,fontSize:this.axisConfig.titleFontSize,rotation:0,verticalPos:"top",horizontalPos:"center"}]}),t}getDrawableElementsForTopAxis(){const t=[];if(this.showAxisLine){const i=this.boundingRect.y+this.boundingRect.height-this.axisConfig.axisLineWidth/2;t.push({type:"path",groupTexts:["top-axis","axis-line"],data:[{path:`M ${this.boundingRect.x},${i} L ${this.boundingRect.x+this.boundingRect.width},${i}`,strokeFill:this.axisThemeConfig.axisLineColor,strokeWidth:this.axisConfig.axisLineWidth}]})}if(this.showLabel&&t.push({type:"text",groupTexts:["top-axis","label"],data:this.getTickValues().map(i=>({text:i.toString(),x:this.getScaleValue(i),y:this.boundingRect.y+(this.showTitle?this.titleTextHeight+this.axisConfig.titlePadding*2:0)+this.axisConfig.labelPadding,fill:this.axisThemeConfig.labelColor,fontSize:this.axisConfig.labelFontSize,rotation:0,verticalPos:"top",horizontalPos:"center"}))}),this.showTick){const i=this.boundingRect.y;t.push({type:"path",groupTexts:["top-axis","ticks"],data:this.getTickValues().map(s=>({path:`M ${this.getScaleValue(s)},${i+this.boundingRect.height-(this.showAxisLine?this.axisConfig.axisLineWidth:0)} L ${this.getScaleValue(s)},${i+this.boundingRect.height-this.axisConfig.tickLength-(this.showAxisLine?this.axisConfig.axisLineWidth:0)}`,strokeFill:this.axisThemeConfig.tickColor,strokeWidth:this.axisConfig.tickWidth}))})}return this.showTitle&&t.push({type:"text",groupTexts:["top-axis","title"],data:[{text:this.title,x:this.boundingRect.x+this.boundingRect.width/2,y:this.boundingRect.y+this.axisConfig.titlePadding,fill:this.axisThemeConfig.titleColor,fontSize:this.axisConfig.titleFontSize,rotation:0,verticalPos:"top",horizontalPos:"center"}]}),t}getDrawableElements(){if(this.axisPosition==="left")return this.getDrawableElementsForLeftAxis();if(this.axisPosition==="right")throw Error("Drawing of right axis is not implemented");return this.axisPosition==="bottom"?this.getDrawableElementsForBottomAxis():this.axisPosition==="top"?this.getDrawableElementsForTopAxis():[]}},a(Q,"BaseAxis"),Q),K,Di=(K=class extends Ut{constructor(t,i,s,n,o){super(t,n,o,i),this.categories=s,this.scale=yt().domain(this.categories).range(this.getRange())}setRange(t){super.setRange(t)}recalculateScale(){this.scale=yt().domain(this.categories).range(this.getRange()).paddingInner(1).paddingOuter(0).align(.5),Nt.trace("BandAxis axis final categories, range: ",this.categories,this.getRange())}getTickValues(){return this.categories}getScaleValue(t){return this.scale(t)??this.getRange()[0]}},a(K,"BandAxis"),K),Z,vi=(Z=class extends Ut{constructor(t,i,s,n,o){super(t,n,o,i),this.domain=s,this.scale=zt().domain(this.domain).range(this.getRange())}getTickValues(){return this.scale.ticks()}recalculateScale(){const t=[...this.domain];this.axisPosition==="left"&&t.reverse(),this.scale=zt().domain(t).range(this.getRange())}getScaleValue(t){return this.scale(t)}},a(Z,"LinearAxis"),Z);function wt(e,t,i,s){const n=new Ht(s);return _t(e)?new Di(t,i,e.categories,e.title,n):new vi(t,i,[e.min,e.max],e.title,n)}a(wt,"getAxis");var J,Pi=(J=class{constructor(t,i,s,n){this.textDimensionCalculator=t,this.chartConfig=i,this.chartData=s,this.chartThemeConfig=n,this.boundingRect={x:0,y:0,width:0,height:0},this.showChartTitle=!1}setBoundingBoxXY(t){this.boundingRect.x=t.x,this.boundingRect.y=t.y}calculateSpace(t){const i=this.textDimensionCalculator.getMaxDimension([this.chartData.title],this.chartConfig.titleFontSize),s=Math.max(i.width,t.width),n=i.height+2*this.chartConfig.titlePadding;return i.width<=s&&i.height<=n&&this.chartConfig.showTitle&&this.chartData.title&&(this.boundingRect.width=s,this.boundingRect.height=n,this.showChartTitle=!0),{width:this.boundingRect.width,height:this.boundingRect.height}}getDrawableElements(){const t=[];return this.showChartTitle&&t.push({groupTexts:["chart-title"],type:"text",data:[{fontSize:this.chartConfig.titleFontSize,text:this.chartData.title,verticalPos:"middle",horizontalPos:"center",x:this.boundingRect.x+this.boundingRect.width/2,y:this.boundingRect.y+this.boundingRect.height/2,fill:this.chartThemeConfig.titleColor,rotation:0}]}),t}},a(J,"ChartTitle"),J);function $t(e,t,i,s){const n=new Ht(s);return new Pi(n,e,t,i)}a($t,"getChartTitleComponent");var tt,Li=(tt=class{constructor(t,i,s,n,o){this.plotData=t,this.xAxis=i,this.yAxis=s,this.orientation=n,this.plotIndex=o}getDrawableElement(){const t=this.plotData.data.map(s=>[this.xAxis.getScaleValue(s[0]),this.yAxis.getScaleValue(s[1])]);let i;return this.orientation==="horizontal"?i=Wt().y(s=>s[0]).x(s=>s[1])(t):i=Wt().x(s=>s[0]).y(s=>s[1])(t),i?[{groupTexts:["plot",`line-plot-${this.plotIndex}`],type:"path",data:[{path:i,strokeFill:this.plotData.strokeFill,strokeWidth:this.plotData.strokeWidth}]}]:[]}},a(tt,"LinePlot"),tt),it,Ei=(it=class{constructor(t,i,s,n,o,g){this.barData=t,this.boundingRect=i,this.xAxis=s,this.yAxis=n,this.orientation=o,this.plotIndex=g}getDrawableElement(){const t=this.barData.data.map(o=>[this.xAxis.getScaleValue(o[0]),this.yAxis.getScaleValue(o[1])]),s=Math.min(this.xAxis.getAxisOuterPadding()*2,this.xAxis.getTickDistance())*(1-.05),n=s/2;return this.orientation==="horizontal"?[{groupTexts:["plot",`bar-plot-${this.plotIndex}`],type:"rect",data:t.map(o=>({x:this.boundingRect.x,y:o[0]-n,height:s,width:o[1]-this.boundingRect.x,fill:this.barData.fill,strokeWidth:0,strokeFill:this.barData.fill}))}]:[{groupTexts:["plot",`bar-plot-${this.plotIndex}`],type:"rect",data:t.map(o=>({x:o[0]-n,y:o[1],width:s,height:this.boundingRect.y+this.boundingRect.height-o[1],fill:this.barData.fill,strokeWidth:0,strokeFill:this.barData.fill}))}]}},a(it,"BarPlot"),it),et,Ii=(et=class{constructor(t,i,s){this.chartConfig=t,this.chartData=i,this.chartThemeConfig=s,this.boundingRect={x:0,y:0,width:0,height:0}}setAxes(t,i){this.xAxis=t,this.yAxis=i}setBoundingBoxXY(t){this.boundingRect.x=t.x,this.boundingRect.y=t.y}calculateSpace(t){return this.boundingRect.width=t.width,this.boundingRect.height=t.height,{width:this.boundingRect.width,height:this.boundingRect.height}}getDrawableElements(){if(!(this.xAxis&&this.yAxis))throw Error("Axes must be passed to render Plots");const t=[];for(const[i,s]of this.chartData.plots.entries())switch(s.type){case"line":{const n=new Li(s,this.xAxis,this.yAxis,this.chartConfig.chartOrientation,i);t.push(...n.getDrawableElement())}break;case"bar":{const n=new Ei(s,this.boundingRect,this.xAxis,this.yAxis,this.chartConfig.chartOrientation,i);t.push(...n.getDrawableElement())}break}return t}},a(et,"BasePlot"),et);function qt(e,t,i){return new Ii(e,t,i)}a(qt,"getPlotComponent");var st,Mi=(st=class{constructor(t,i,s,n){this.chartConfig=t,this.chartData=i,this.componentStore={title:$t(t,i,s,n),plot:qt(t,i,s),xAxis:wt(i.xAxis,t.xAxis,{titleColor:s.xAxisTitleColor,labelColor:s.xAxisLabelColor,tickColor:s.xAxisTickColor,axisLineColor:s.xAxisLineColor},n),yAxis:wt(i.yAxis,t.yAxis,{titleColor:s.yAxisTitleColor,labelColor:s.yAxisLabelColor,tickColor:s.yAxisTickColor,axisLineColor:s.yAxisLineColor},n)}}calculateVerticalSpace(){let t=this.chartConfig.width,i=this.chartConfig.height,s=0,n=0,o=Math.floor(t*this.chartConfig.plotReservedSpacePercent/100),g=Math.floor(i*this.chartConfig.plotReservedSpacePercent/100),m=this.componentStore.plot.calculateSpace({width:o,height:g});t-=m.width,i-=m.height,m=this.componentStore.title.calculateSpace({width:this.chartConfig.width,height:i}),n=m.height,i-=m.height,this.componentStore.xAxis.setAxisPosition("bottom"),m=this.componentStore.xAxis.calculateSpace({width:t,height:i}),i-=m.height,this.componentStore.yAxis.setAxisPosition("left"),m=this.componentStore.yAxis.calculateSpace({width:t,height:i}),s=m.width,t-=m.width,t>0&&(o+=t,t=0),i>0&&(g+=i,i=0),this.componentStore.plot.calculateSpace({width:o,height:g}),this.componentStore.plot.setBoundingBoxXY({x:s,y:n}),this.componentStore.xAxis.setRange([s,s+o]),this.componentStore.xAxis.setBoundingBoxXY({x:s,y:n+g}),this.componentStore.yAxis.setRange([n,n+g]),this.componentStore.yAxis.setBoundingBoxXY({x:0,y:n}),this.chartData.plots.some(p=>At(p))&&this.componentStore.xAxis.recalculateOuterPaddingToDrawBar()}calculateHorizontalSpace(){let t=this.chartConfig.width,i=this.chartConfig.height,s=0,n=0,o=0,g=Math.floor(t*this.chartConfig.plotReservedSpacePercent/100),m=Math.floor(i*this.chartConfig.plotReservedSpacePercent/100),p=this.componentStore.plot.calculateSpace({width:g,height:m});t-=p.width,i-=p.height,p=this.componentStore.title.calculateSpace({width:this.chartConfig.width,height:i}),s=p.height,i-=p.height,this.componentStore.xAxis.setAxisPosition("left"),p=this.componentStore.xAxis.calculateSpace({width:t,height:i}),t-=p.width,n=p.width,this.componentStore.yAxis.setAxisPosition("top"),p=this.componentStore.yAxis.calculateSpace({width:t,height:i}),i-=p.height,o=s+p.height,t>0&&(g+=t,t=0),i>0&&(m+=i,i=0),this.componentStore.plot.calculateSpace({width:g,height:m}),this.componentStore.plot.setBoundingBoxXY({x:n,y:o}),this.componentStore.yAxis.setRange([n,n+g]),this.componentStore.yAxis.setBoundingBoxXY({x:n,y:s}),this.componentStore.xAxis.setRange([o,o+m]),this.componentStore.xAxis.setBoundingBoxXY({x:0,y:o}),this.chartData.plots.some(k=>At(k))&&this.componentStore.xAxis.recalculateOuterPaddingToDrawBar()}calculateSpace(){this.chartConfig.chartOrientation==="horizontal"?this.calculateHorizontalSpace():this.calculateVerticalSpace()}getDrawableElement(){this.calculateSpace();const t=[];this.componentStore.plot.setAxes(this.componentStore.xAxis,this.componentStore.yAxis);for(const i of Object.values(this.componentStore))t.push(...i.getDrawableElements());return t}},a(st,"Orchestrator"),st),nt,Vi=(nt=class{static build(t,i,s,n){return new Mi(t,i,s,n).getDrawableElement()}},a(nt,"XYChartBuilder"),nt),rt=0,Gt,ot=Tt(),ht=Rt(),A=Dt(),Ct=ht.plotColorPalette.split(",").map(e=>e.trim()),gt=!1,kt=!1;function Rt(){const e=wi(),t=St();return Yt(e.xyChart,t.themeVariables.xyChart)}a(Rt,"getChartDefaultThemeConfig");function Tt(){const e=St();return Yt(Ai.xyChart,e.xyChart)}a(Tt,"getChartDefaultConfig");function Dt(){return{yAxis:{type:"linear",title:"",min:1/0,max:-1/0},xAxis:{type:"band",title:"",categories:[]},title:"",plots:[]}}a(Dt,"getChartDefaultData");function xt(e){const t=St();return Ci(e.trim(),t)}a(xt,"textSanitizer");function jt(e){Gt=e}a(jt,"setTmpSVGG");function Qt(e){e==="horizontal"?ot.chartOrientation="horizontal":ot.chartOrientation="vertical"}a(Qt,"setOrientation");function Kt(e){A.xAxis.title=xt(e.text)}a(Kt,"setXAxisTitle");function vt(e,t){A.xAxis={type:"linear",title:A.xAxis.title,min:e,max:t},gt=!0}a(vt,"setXAxisRangeData");function Zt(e){A.xAxis={type:"band",title:A.xAxis.title,categories:e.map(t=>xt(t.text))},gt=!0}a(Zt,"setXAxisBand");function Jt(e){A.yAxis.title=xt(e.text)}a(Jt,"setYAxisTitle");function ti(e,t){A.yAxis={type:"linear",title:A.yAxis.title,min:e,max:t},kt=!0}a(ti,"setYAxisRangeData");function ii(e){const t=Math.min(...e),i=Math.max(...e),s=G(A.yAxis)?A.yAxis.min:1/0,n=G(A.yAxis)?A.yAxis.max:-1/0;A.yAxis={type:"linear",title:A.yAxis.title,min:Math.min(s,t),max:Math.max(n,i)}}a(ii,"setYAxisRangeFromPlotData");function Pt(e){let t=[];if(e.length===0)return t;if(!gt){const i=G(A.xAxis)?A.xAxis.min:1/0,s=G(A.xAxis)?A.xAxis.max:-1/0;vt(Math.min(i,1),Math.max(s,e.length))}if(kt||ii(e),_t(A.xAxis)&&(t=A.xAxis.categories.map((i,s)=>[i,e[s]])),G(A.xAxis)){const i=A.xAxis.min,s=A.xAxis.max,n=(s-i)/(e.length-1),o=[];for(let g=i;g<=s;g+=n)o.push(`${g}`);t=o.map((g,m)=>[g,e[m]])}return t}a(Pt,"transformDataWithoutCategory");function Lt(e){return Ct[e===0?0:e%Ct.length]}a(Lt,"getPlotColorFromPalette");function ei(e,t){const i=Pt(t);A.plots.push({type:"line",strokeFill:Lt(rt),strokeWidth:2,data:i}),rt++}a(ei,"setLineData");function si(e,t){const i=Pt(t);A.plots.push({type:"bar",fill:Lt(rt),data:i}),rt++}a(si,"setBarData");function ni(){if(A.plots.length===0)throw Error("No Plot to render, please provide a plot with some data");return A.title=Xt(),Vi.build(ot,A,ht,Gt)}a(ni,"getDrawableElem");function ai(){return ht}a(ai,"getChartThemeConfig");function ri(){return ot}a(ri,"getChartConfig");function oi(){return A}a(oi,"getXYChartData");var Bi=a(function(){bi(),rt=0,ot=Tt(),A=Dt(),ht=Rt(),Ct=ht.plotColorPalette.split(",").map(e=>e.trim()),gt=!1,kt=!1},"clear"),Wi={getDrawableElem:ni,clear:Bi,setAccTitle:pi,getAccTitle:fi,setDiagramTitle:di,getDiagramTitle:Xt,getAccDescription:xi,setAccDescription:gi,setOrientation:Qt,setXAxisTitle:Kt,setXAxisRangeData:vt,setXAxisBand:Zt,setYAxisTitle:Jt,setYAxisRangeData:ti,setLineData:ei,setBarData:si,setTmpSVGG:jt,getChartThemeConfig:ai,getChartConfig:ri,getXYChartData:oi},zi=a((e,t,i,s)=>{const n=s.db,o=n.getChartThemeConfig(),g=n.getChartConfig(),m=n.getXYChartData().plots[0].data.map(y=>y[1]);function p(y){return y==="top"?"text-before-edge":"middle"}a(p,"getDominantBaseLine");function k(y){return y==="left"?"start":y==="right"?"end":"middle"}a(k,"getTextAnchor");function v(y){return`translate(${y.x}, ${y.y}) rotate(${y.rotation||0})`}a(v,"getTextTransformation"),Nt.debug(`Rendering xychart chart
-`+e);const C=mi(t),b=C.append("g").attr("class","main"),E=b.append("rect").attr("width",g.width).attr("height",g.height).attr("class","background");yi(C,g.height,g.width,!0),C.attr("viewBox",`0 0 ${g.width} ${g.height}`),E.attr("fill",o.backgroundColor),n.setTmpSVGG(C.append("g").attr("class","mermaid-tmp-group"));const D=n.getDrawableElem(),P={};function I(y){let _=b,c="";for(const[W]of y.entries()){let z=b;W>0&&P[c]&&(z=P[c]),c+=y[W],_=P[c],_||(_=P[c]=z.append("g").attr("class",y[W]))}return _}a(I,"getGroup");for(const y of D){if(y.data.length===0)continue;const _=I(y.groupTexts);switch(y.type){case"rect":if(_.selectAll("rect").data(y.data).enter().append("rect").attr("x",c=>c.x).attr("y",c=>c.y).attr("width",c=>c.width).attr("height",c=>c.height).attr("fill",c=>c.fill).attr("stroke",c=>c.strokeFill).attr("stroke-width",c=>c.strokeWidth),g.showDataLabel)if(g.chartOrientation==="horizontal"){let c=function(l,L){const{data:S,label:R}=l;return L*R.length*W<=S.width-10};a(c,"fitsHorizontally");const W=.7,z=y.data.map((l,L)=>({data:l,label:m[L].toString()})).filter(l=>l.data.width>0&&l.data.height>0),U=z.map(l=>{const{data:L}=l;let S=L.height*.7;for(;!c(l,S)&&S>0;)S-=1;return S}),X=Math.floor(Math.min(...U));_.selectAll("text").data(z).enter().append("text").attr("x",l=>l.data.x+l.data.width-10).attr("y",l=>l.data.y+l.data.height/2).attr("text-anchor","end").attr("dominant-baseline","middle").attr("fill","black").attr("font-size",`${X}px`).text(l=>l.label)}else{let c=function(l,L,S){const{data:R,label:$}=l,N=L*$.length*.7,F=R.x+R.width/2,h=F-N/2,u=F+N/2,x=h>=R.x&&u<=R.x+R.width,d=R.y+S+L<=R.y+R.height;return x&&d};a(c,"fitsInBar");const W=10,z=y.data.map((l,L)=>({data:l,label:m[L].toString()})).filter(l=>l.data.width>0&&l.data.height>0),U=z.map(l=>{const{data:L,label:S}=l;let R=L.width/(S.length*.7);for(;!c(l,R,W)&&R>0;)R-=1;return R}),X=Math.floor(Math.min(...U));_.selectAll("text").data(z).enter().append("text").attr("x",l=>l.data.x+l.data.width/2).attr("y",l=>l.data.y+W).attr("text-anchor","middle").attr("dominant-baseline","hanging").attr("fill","black").attr("font-size",`${X}px`).text(l=>l.label)}break;case"text":_.selectAll("text").data(y.data).enter().append("text").attr("x",0).attr("y",0).attr("fill",c=>c.fill).attr("font-size",c=>c.fontSize).attr("dominant-baseline",c=>p(c.verticalPos)).attr("text-anchor",c=>k(c.horizontalPos)).attr("transform",c=>v(c)).text(c=>c.text);break;case"path":_.selectAll("path").data(y.data).enter().append("path").attr("d",c=>c.path).attr("fill",c=>c.fill?c.fill:"none").attr("stroke",c=>c.strokeFill).attr("stroke-width",c=>c.strokeWidth);break}}},"draw"),Fi={draw:zi},Ui={parser:Ti,db:Wi,renderer:Fi};export{Ui as diagram};
diff --git a/docs/dist/docs/blog/finally-give-up-gin-echo.md b/docs/dist/docs/blog/finally-give-up-gin-echo.md
deleted file mode 100644
index 8b13b6a4..00000000
--- a/docs/dist/docs/blog/finally-give-up-gin-echo.md
+++ /dev/null
@@ -1,279 +0,0 @@
-# Finally Give Up Gin, Echo, and <Your Framework Here>
-
-## Introduction: Rethinking Traditions in the Go World
-
-In the world of Go development, choosing a framework often becomes a loyalty issue comparable to choosing between Apple and Android. Frameworks like Gin, Echo, and Beego have been faithful companions to developers for years, helping to quickly deploy projects and achieve early successes. They offered convenient tools and familiar work patterns, but over time it becomes evident that each has its own "language." This creates difficulties when transitioning between them or integrating with other systems.
-
-The situation worsens as projects grow and scalability and maintenance become critically important. Here, every incompatible component or diversity of approaches becomes an obstacle requiring additional resources and time. It's as if every time you switch from one framework to another, you move to a new house where even the familiar light switch isn't where your hand automatically reaches.
-
-### For those who want to delve deeper into the history and features of each framework, I suggest reviewing these detailed overviews and comparisons:
-
-- [Beego: An Overview and Comparison with Other Frameworks](https://medium.com/@eric.a.nugroho/beego-an-overview-and-comparison-with-other-framework-5211b08124ea)
-- [Building Microservice Using Golang Echo Framework](https://medium.com/cuddle-ai/building-microservice-using-golang-echo-framework-ff10ba06d508)
-- [Go with Gin](https://maneeshaindrachapa.medium.com/go-with-gin-83865cd5cd81)
-
-In this article, we'll explore why it's time to abandon the familiar diversity in favor of standardization and how gRPC-Gateway can become the "universal translator" capable of uniting the disparate dialects of Go frameworks into a single, universally understood language for microservice interaction.
-
-## Standardization, Standardization, and More Standardization
-
-When it comes to creating servers in Go, each framework offers its own set of rules and tools. Initially, this seems like a big plus: you can choose exactly what suits your specific needs and work style. However, imagine the complexity when you need to combine modules written using different frameworks in one project. It's comparable to trying to assemble a puzzle where each piece is produced by different manufacturers and doesn't fit with the others.
-
-Examples of Gin, Echo, and, heaven forbid, Beego often come up in developer conversations. They have undoubtedly had a huge impact on the Go community and have supported many projects at different stages of their lifecycle. Especially Gin, which has been a reliable tool for many for over 10 years. But modern development realities require flexibility and scalability, and being tied to one framework can seriously limit both of these characteristics.
-
-For example, if your project started using Echo and you want to integrate a third-party library written for Gin, you'll face the need to rewrite code or create "bridges" between API differences. This not only increases the workload but also adds additional complexity to code maintenance and updates.
-
-Standardization is the key to solving these problems. Transitioning to use gRPC and HTTP/2, as well as adopting tools like gRPC-Gateway, opens new horizons in terms of compatibility and universal communication. Think of gRPC-Gateway as a universal translator that allows you to speak the same language with different systems without getting into the specifics of each one.
-
-## Getting to Know gRPC-Gateway
-
-gRPC-Gateway is a magical bridge connecting the old world of RESTful JSON APIs and the modern world of gRPC. It allows your services to speak two languages, serving both traditional HTTP requests and powerful gRPC calls. This is especially convenient when you have diverse clients: some prefer to communicate via simple HTTP requests, while others use gRPC.
-
-Let's consider a real-life example: you manage a web service that provides weather information. Your data isn't just text; it's voluminous datasets from weather stations. Here, gRPC is perfect for transmitting this data with high speed and reliability. But your clients aren't just other servers; they're also mobile applications and web browsers that expect convenient and understandable JSON responses.
-
-This is where gRPC-Gateway comes into play: it transforms HTTP requests into gRPC calls and back, making your service accessible to everyone without the need to support two different APIs. All of this happens behind the scenes, and for the end user, it looks like normal interaction with a website or application.
-
-Sample code you might see without gRPC-Gateway looks something like this:
-
-```proto
-syntax = "proto3";
-
-package your.service.v1;
-
-option go_package = "github.com/yourorg/yourprotos/gen/go/your/service/v1";
-
-message StringMessage {
-  string value = 1;
-}
-
-service YourService {
-  rpc Echo(StringMessage) returns (StringMessage) {}
-}
-```
-
-Now let's add a bit of gRPC-Gateway "magic":
-
-```proto
-syntax = "proto3";
-package your.service.v1;
-option go_package = "github.com/yourorg/yourprotos/gen/go/your/service/v1";
-import "google/api/annotations.proto";
-
-message StringMessage {
-  string value = 1;
-}
-
-service YourService {
-  rpc Echo(StringMessage) returns (StringMessage) {
-      option (google.api.http) = {
-      post: "/v1/example/echo"
-      body: "*"
-    };
-  }
-}
-```
-
-These few lines allow you to automatically accept HTTP POST requests at `/v1/example/echo` and process them as gRPC calls. This is an example of how gRPC-Gateway simplifies developers' lives by providing a single, universally understood API.
-
-## Combining gRPC and HTTP Servers
-
-The ability to simultaneously use gRPC and HTTP in one application is like having both a sports car and an SUV at your disposal; you can enjoy speed and power when needed, and reliability and versatility at other times. gRPC-Gateway allows your service to easily switch between these two "transports," providing such flexibility.
-
-Let's look at a typical workflow:
-
-- *HTTP request*: The client sends an HTTP request that reaches gRPC-Gateway.
-- *Conversion to gRPC*: The Gateway parses the request, converts it to the corresponding gRPC call, and forwards it to the gRPC server.
-- *gRPC server processing*: The gRPC server processes the request and sends a response back to the Gateway.
-- *Conversion to HTTP*: The Gateway translates the gRPC response back to a format understandable by the HTTP client and sends it back.
-
-This process can be represented as a diagram:
-
-```mermaid
-sequenceDiagram
-    participant WebClient as Web Client
-    participant GRPCGateway as HTTP Server (gRPC-Gateway)
-    participant GRPCServer as gRPC Server
-
-    WebClient->>GRPCGateway: HTTP Request
-    GRPCGateway->>GRPCServer: gRPC Request
-    GRPCServer->>GRPCGateway: gRPC Response
-    GRPCGateway->>WebClient: HTTP Response
-```
-
-In real life, this looks like the following: when a user requests information through a web interface, their request goes through gRPC-Gateway, which translates it into a gRPC call. Then, after receiving a response from the gRPC service, the Gateway "translates" it back into an HTTP response and sends it to the user, ensuring a smooth and seamless interaction process.
-
-At the code level, this might look like:
-```go
-package main
-
-import (
-	"context"
-	"log"
-	"net"
-	"net/http"
-
-	"github.com/grpc-ecosystem/grpc-gateway/v2/runtime"
-	"golang.org/x/sync/errgroup"
-	"google.golang.org/grpc"
-	"google.golang.org/grpc/credentials/insecure"
-
-	echo "path/to/your/protobuf_package" 
-)
-
-const (
-	grpcServerEndpoint = "localhost:50051"
-	httpServerEndpoint = "localhost:8080"
-)
-
-type EchoService struct {
-	echo.UnimplementedEchoServiceServer
-}
-
-func (s *EchoService) Echo(ctx context.Context, in *echo.EchoRequest) (*echo.EchoResponse, error) {
-	return &echo.EchoResponse{Message: "Echo: " + in.Message}, nil
-}
-
-func main() {
-	g, ctx := errgroup.WithContext(context.Background())
-
-	g.Go(func() error {
-		return startGRPCServer(ctx)
-	})
-
-	g.Go(func() error {
-		return startHTTPServer(ctx)
-	})
-
-	if err := g.Wait(); err != nil {
-		log.Fatalf("Failed to start servers: %s", err)
-	}
-}
-
-func startGRPCServer(ctx context.Context) (err error) {
-	lis, err := net.Listen("tcp", grpcServerEndpoint)
-	if err != nil {
-		return err
-	}
-
-	s := grpc.NewServer()
-	echo.RegisterEchoServiceServer(s, &EchoService{})
-
-	go func() {
-		<-ctx.Done()
-		s.GracefulStop()
-	}()
-
-	log.Printf("Starting gRPC server on %s", grpcServerEndpoint)
-	return s.Serve(lis)
-}
-
-func startHTTPServer(ctx context.Context) (err error) {
-	mux := runtime.NewServeMux()
-	opts := []grpc.DialOption{grpc.WithTransportCredentials(insecure.NewCredentials())}
-	err = echo.RegisterEchoServiceHandlerFromEndpoint(ctx, mux, grpcServerEndpoint, opts)
-	if err != nil {
-		return err
-	}
-
-	srv := &http.Server{
-		Addr:    httpServerEndpoint,
-		Handler: mux,
-	}
-
-	go func() {
-		<-ctx.Done()
-		srv.Shutdown(ctx)
-	}()
-
-	log.Printf("Starting HTTP server on %s", httpServerEndpoint)
-	return srv.ListenAndServe()
-}
-```
-
-This simple example shows how you can ensure the operation of both gRPC and HTTP servers within a single application, giving users freedom of choice and providing developers with convenient tools for API management.
-
-## Benefits of Using gRPC-Gateway
-
-gRPC-Gateway doesn't just simplify development—it unlocks new possibilities for systems where compatibility and flexibility are required. This is especially important in modern microservice architectures where systems must interact with each other seamlessly and efficiently.
-
-## Single Source of Truth: One Schema for gRPC and RESTful API
-
-Using a single .proto file to describe both gRPC and RESTful APIs, we achieve unity and consistency of interfaces. This eliminates the need to maintain different API versions for different protocols, simplifying updates and reducing the chance of errors. If you make changes to the .proto file, they are automatically reflected in both the RESTful API and gRPC.
-
-## Reducing Code Duplication and Simplifying Maintenance
-
-Since gRPC-Gateway translates REST requests into gRPC calls, developers don't need to write separate implementations for each protocol. This frees up effort and time for creating additional features rather than duplicating existing functionality.
-
-## Automatic Generation of Client Code and OpenAPI (Swagger) Documentation
-
-gRPC-Gateway allows automatic generation of client libraries for various programming languages and API documentation in OpenAPI (Swagger) format. This not only speeds up the development process of client parts of the system but also ensures documentation is up-to-date, making API interaction transparent and understandable for all parties.
-
-```mermaid
-sequenceDiagram
-    participant Developer as Developer
-    participant ProtoFile as .proto file
-    participant CodeGen as Code Generator
-    participant ClientLib as Client Library
-    participant APIDocs as API Documentation
-
-    Developer->>ProtoFile: Defines API
-    ProtoFile->>CodeGen: Transfers API structure
-    CodeGen->>ClientLib: Generates code
-    CodeGen->>APIDocs: Generates documentation
-    APIDocs-->>Developer: Uses for integration
-    ClientLib-->>Developer: Uses for client development
-```
-
-An example benefit might look like this: imagine your team is implementing a new feature in the system. Previously, this would have required updating several API documents and implementations in different languages. Now, changes are made to a single .proto file, and all necessary updates are generated automatically.
-
-These benefits make gRPC-Gateway a powerful tool that can significantly simplify the development and maintenance process of microservice architectures, making them more modular, flexible, and easy to scale.
-
-## Disadvantages and Limitations of gRPC-Gateway
-
-Despite significant advantages, gRPC-Gateway is not without drawbacks, especially when it comes to complex use cases and integration with existing systems. Let's consider some of these limitations:
-
-## Limited Configuration and Customization
-
-gRPC-Gateway works great "out of the box" for many standard scenarios, but its customization capabilities may be insufficient for unique requirements. For example, complex routing requirements, fine-tuning security, or specific request handling may require additional effort and sometimes writing an additional proxy layer.
-
-```mermaid
-graph TD
-    A[Client Request] --> B[gRPC-Gateway]
-    B --> C{Route Check}
-    C -->|Route OK| D[gRPC Service]
-    C -->|Customization Required| E[Additional Proxy Layer]
-    E --> D
-    D --> F{gRPC Service Response}
-    F -->|Convert to HTTP| B
-```
-
-## Higher Entry Barrier for Beginners
-
-To effectively use gRPC-Gateway, developers need to learn not only the basics of REST and HTTP but also the specifics of working with gRPC and protobuf. This can create additional difficulties for beginners or teams accustomed to more traditional REST APIs.
-
-## Interaction with Other Tools and Libraries
-
-Integration with some monitoring, logging, or tracing tools can be difficult since gRPC-Gateway represents another layer of abstraction. Therefore, additional configuration or searching for specialized solutions compatible with gRPC may be required.
-
-## Insufficient Control Over HTTP-Specific Features
-
-Some HTTP-specific features, such as cache management, cookies, and redirects, may not be as easily implementable through gRPC-Gateway. This may require additional workarounds or development of additional code to control these aspects at the HTTP level.
-
-## File Transfer Issues
-
-File transfer can be problematic when using gRPC-Gateway. Due to gRPC specifics, large files must be split into many small parts for transmission, which can be inefficient and complex to implement. In some cases, a more traditional approach to file handling and transfer may be required.
-
-## Performance Impact
-
-Although gRPC-Gateway is relatively efficient, introducing an additional proxy layer can slightly increase request processing latency. In systems where every millisecond matters, this can become a critical factor.
-
-## Conclusion
-
-So, we've figured out that gRPC-Gateway isn't just another technical gadget. It's like a bridge between two worlds: the cozy island of REST and the swift continent of gRPC. And this bridge can lead us to something amazing—APIs that are easier to maintain, faster to work with, and friendlier to developers.
-
-## Some Reflections
-
-The world of technology doesn't stand still, and neither do we. Today, choosing gRPC-Gateway might seem like an innovation, but tomorrow it will already be part of the "good old classics." So if you feel it's time to expand horizons and explore new technologies, perhaps gRPC-Gateway is exactly what you need.
-
-## That's All... For Now!
-
-Don't be afraid to experiment and try new solutions. Perhaps gRPC-Gateway won't become a panacea for all your pains, but it can definitely become one of those tools you'll remember with gratitude. And what will happen tomorrow? Who knows, maybe we'll meet again at a new turn of technological evolution!
\ No newline at end of file
diff --git a/docs/dist/docs/blog/working-with-proto-errors-correctly.md b/docs/dist/docs/blog/working-with-proto-errors-correctly.md
deleted file mode 100644
index 369e32a0..00000000
--- a/docs/dist/docs/blog/working-with-proto-errors-correctly.md
+++ /dev/null
@@ -1,223 +0,0 @@
-# Let's Work with Proto Errors Correctly :)
-
-## Protobuf Error Handling
-
-In programming, there are always several ways to solve the same problem. But not all of them are equally effective. Today, let's talk about ways to handle errors in gRPC — successful ones and not so much.
-
-```proto
-message Result {
-  oneof response {
-    error.v1.Error error = 1;
-    info.v1.Info info = 2;
-  }
-}
-```
-
-At first glance, it might seem that using oneof to represent either an error or a result is convenient. However, this approach introduces unnecessary complexity into the message exchange protocol and degrades code readability. gRPC provides built-in tools for working with errors that allow you to elegantly and efficiently convey error information.
-
-Why is using `oneof` for errors a bad idea? First, it makes it difficult to use gRPC's standard error mechanism and status codes, which are designed for this purpose. Second, it can lead to confusion on the client side when needing to distinguish successful responses from errors.
-
-```mermaid
-sequenceDiagram
-    participant Client as Client
-    participant Service as Service
-    Client->>Service: Query
-    alt Success
-      Service-->>Client: Info
-    else Error
-      Service-->>Client: Error
-    end
-```
-The diagram shows how handling two types of requests complicates the client logic
-
-## Error Codes in gRPC
-
-Error codes in gRPC architecture are especially important for effective interaction between client and server. They help the client understand the cause of the problem and respond appropriately.
-
-Proper and effective error management in gRPC plays a key role in creating reliable and maintainable systems. Using standard error codes and gRPC mechanisms not only simplifies error handling on the client side but also ensures clarity and predictability of system behavior. Instead of using constructs like oneof for error handling, it's better to use gRPC's built-in capabilities for transmitting detailed error information.
-
-Here's how you can use the gRPC code codes.NotFound to report that something is missing:
-
-```go
-import "google.golang.org/grpc/status"
-import "google.golang.org/grpc/codes"
-
-// ...
-
-err := status.Error(codes.NotFound, "couldn't find the cat")
-
-// ...
-```
-
-This approach simplifies error handling on the client side, which makes it easier to understand the response data structure. Additionally, errors returned via status.Error are converted to HTTP statuses when transported through gRPC-Gateway, making errors understandable even outside of gRPC.
-
-But what if we need more flexibility in the error response? For example, adding additional meta-information or custom error codes?
-
-The gRPC system itself has the ability to attach additional data to an error — and thus extend the problem context:
-
-```go
-import (
-  "google.golang.org/grpc/status"
-  "google.golang.org/grpc/codes"
-  "google.golang.org/genproto/googleapis/rpc/errdetails"
-)
-
-// ...
-
-st := status.New(codes.InvalidArgument, "invalid parameter")
-// General error form
-errInfo := &errdetails.ErrorInfo{
-	Reason: "Insufficient funds in account",
-	Domain: "finance",
-	Metadata: map[string]string{
-		"my_meta_info": "my_meta_details",
-	},
-}
-
-st, err := st.WithDetails(errInfo)
-if err != nil {
-	return fmt.Sprintf("st.WithDetails: %w", err)
-}
-
-return st.Err()
-```
-
-But in cases when you want to get more detailed errors — for example, specifying the problematic field. In such cases, you can use the BadRequest type and provide more details about the error.
-
-## Defining and Using Custom Errors
-
-But! What if the standard details options don't fit? We can create our own error types! :)
-
-First, let's define a custom error in a proto file. We need to create a CustomErrorDetail error message. It will contain information about errors related to user data:
-
-```proto
-syntax = "proto3";
-
-package myerrors;
-
-message CustomErrorDetail {
-  string reason = 1;
-  string field = 2;
-  string help = 3;
-}
-```
-
-Now that we have the custom error definition, we can use it to pass more specific and detailed error information. This is especially useful when you need to point to specific fields or parameters that caused the error. Creating and using such CustomErrorDetail in server code allows not only reporting problems but also providing the client with recommendations for fixing them, making the interaction more transparent and efficient.
-
-```go
-import (
-  "google.golang.org/grpc/status"
-  "google.golang.org/grpc/codes"
-  "google.golang.org/protobuf/types/known/anypb"
-  "myerrors"
-)
-
-// ...
-
-customErrorDetail := &myerrors.CustomErrorDetail{
-    Reason: "Value out of range",
-    Field: "age",
-    Help: "The age must be between 0 and 120",
-}
-
-st := status.New(codes.InvalidArgument, "invalid parameter")
-st, err = st.WithDetails(customErrorDetail)
-if err != nil {
-    return fmt.Sprintf("Unexpected error attaching custom error detail: %w", err)
-}
-
-return st.Err()
-```
-
-## Working from the Client Side
-
-Now let's look at how the client side will interact with the gRPC error handling system we described earlier.
-
-### Handling Standard Errors
-
-When a client receives a response from a gRPC server, it can check for errors using standard gRPC mechanisms, for example:
-
-```go
-import (
-  "context"
-  "google.golang.org/grpc"
-  "google.golang.org/grpc/codes"
-  "google.golang.org/grpc/status"
-  "log"
-)
-
-func main() {
-  conn, err := grpc.Dial("localhost:50051", grpc.WithInsecure())
-  if err != nil {
-    log.Fatalf("did not connect: %v", err)
-  }
-  defer conn.Close()
-
-  client := NewYourServiceClient(conn)
-  response, err := client.YourMethod(context.Background(), &YourRequest{})
-  if err != nil {
-    st, ok := status.FromError(err)
-    if ok {
-      switch st.Code() {
-      case codes.InvalidArgument:
-        log.Println("Invalid argument error:", st.Message())
-      case codes.NotFound:
-        log.Println("Not found error:", st.Message())
-      // Handle other error codes as necessary
-      default:
-        log.Println("Unexpected error:", st.Message())
-      }
-    } else {
-      log.Fatalf("failed to call YourMethod: %v", err)
-    }
-  } else {
-    log.Println("Response:", response)
-  }
-}
-```
-
-### Extracting Additional Error Details
-
-And now for the most interesting part: for the client side to extract details for analysis, we need to process these details.
-
-Here's how it can be done:
-
-```go
-import (
-  "google.golang.org/grpc/status"
-  "google.golang.org/genproto/googleapis/rpc/errdetails"
-  "myerrors"
-  "log"
-)
-
-// ...
-
-func handleError(err error) {
-  st, ok := status.FromError(err)
-  if !ok {
-    log.Fatalf("An unexpected error occurred: %v", err)
-  }
-
-  for _, detail := range st.Details() {
-    switch t := detail.(type) {
-    case *errdetails.BadRequest:
-      // Handle bad request details
-      for _, violation := range t.GetFieldViolations() {
-        log.Printf("The field %s was wrong: %s\\n", violation.GetField(), violation.GetDescription())
-      }
-    case *myerrors.CustomErrorDetail:
-      // Handle custom error details
-      log.Printf("Custom error detail: Reason: %s, Field: %s, Help: %s\\n", t.Reason, t.Field, t.Help)
-    // Add handling for other error types as necessary
-    default:
-      log.Printf("Received an unknown error detail type: %v\\n", t)
-    }
-  }
-}
-```
-
-### Conclusion
-
-We've covered how to use standard gRPC error codes, how to add additional data to errors, and how to create and handle custom errors. These approaches allow for more flexible and detailed error handling, which is especially important for complex systems where a simple error message may be insufficient.
-
-When designing an API, it's important to remember that the client side should be able to easily and unambiguously interpret server responses. Using standard gRPC mechanisms for errors helps achieve this goal, improving the interaction between client and server and making the system as a whole more robust and understandable.
diff --git a/docs/dist/docs/guide/api-service/overview.md b/docs/dist/docs/guide/api-service/overview.md
deleted file mode 100644
index c4a5d466..00000000
--- a/docs/dist/docs/guide/api-service/overview.md
+++ /dev/null
@@ -1,312 +0,0 @@
-# API Service Overview
-
-**Centralized protobuf plugin execution service for consistent, isolated code generation**
-
-The EasyP API Service eliminates plugin management chaos by providing centralized execution of protobuf/gRPC plugins as isolated Docker containers. It offers a unified platform for teams to standardize their code generation workflows without the operational overhead of managing plugins across individual developer machines.
-
-## Why EasyP API Service?
-
-### The Challenge
-
-Managing protobuf/gRPC code generation across development teams creates significant operational complexity:
-
-#### Version Inconsistencies
-- Developers use different plugin versions locally, causing build failures and inconsistent generated code
-- "Works on my machine" syndrome when generated code differs between environments
-- Manual coordination required to keep entire teams synchronized on plugin versions
-
-#### Operational Overhead
-- DevOps teams spend significant time managing plugin installations across developer machines
-- Each new team member requires manual setup of correct plugin versions
-- Plugin updates require coordinating with every developer individually
-- No centralized control over which plugin versions are approved for use
-
-#### Security & Compliance Risks
-- Developers install plugins from various sources without security validation
-- No audit trail of which plugins were used for which builds
-- Difficult to enforce security policies on code generation tools
-
-### The Solution: Centralized Plugin Execution
-
-EasyP API Service eliminates these operational headaches by centralizing plugin management:
-
-| Challenge | Solution |
-|-----------|----------|
-| **Version Control** | Deploy new plugin versions to entire team instantly via Docker images |
-| **Operations** | Operations team controls plugin configurations without touching developer machines |
-| **Security** | All plugins run in isolated Docker containers with resource constraints |
-| **Consistency** | Consistent execution environment regardless of developer's local setup |
-| **Developer Experience** | No local plugin installation or maintenance required |
-
-## Architecture Overview
-
-The EasyP API Service uses a streamlined architecture focused on reliable plugin execution:
-
-```mermaid
-graph TB
-    subgraph "Client Layer"
-        CLI[EasyP CLI]
-    end
-    
-    subgraph "EasyP API Service"
-        GRPC[gRPC Server]
-        CORE[Core Engine]
-        METRICS[Metrics Collector]
-    end
-    
-    subgraph "Plugin Execution"
-        DOCKER[Docker Runtime]
-        REGISTRY[Docker Hub Registry]
-    end
-    
-    subgraph "Storage"
-        DB[(PostgreSQL)]
-    end
-    
-    subgraph "Monitoring"
-        PROM[Prometheus]
-    end
-    
-    CLI -->|CodeGeneratorRequest| GRPC
-    GRPC --> CORE
-    
-    CORE -->|Fetch plugin params| DB
-    CORE -->|Execute plugin| DOCKER
-    CORE -->|Record metrics| METRICS
-    
-    DOCKER -->|Pull images| REGISTRY
-    
-    METRICS --> PROM
-```
-
-## Key Components
-
-### API Layer
-- **gRPC Server**: Primary API for code generation requests
-- Each plugin execution is a separate gRPC request
-- Receives `CodeGeneratorRequest` from CLI
-
-### Execution Engine
-- **Docker Runtime**: Isolated container execution for plugins
-- Pulls plugin images from public Docker registries (Docker Hub, etc.)
-- Enforces resource limits (CPU, memory) per plugin
-
-### Storage Layer
-- **PostgreSQL**: Stores plugin execution parameters
-  - Resource limits (CPU, memory allocation)
-  - Plugin configuration and metadata
-  - Execution logs for auditing
-  - _Note: Storage capabilities will be expanded in future releases_
-
-### Monitoring
-- **Prometheus**: Metrics collection and monitoring
-- Tracks execution times, success rates, and resource usage
-
-## How It Works
-
-### Local Execution (EasyP CLI)
-When running locally, the EasyP CLI supports:
-- **Installed plugins**: System-installed protoc plugins
-- **WASM plugins**: Fast, lightweight WebAssembly plugins
-
-### Remote Execution (API Service)
-When using the API Service:
-- **Docker only**: All plugins run as Docker containers
-- **Centralized control**: Operations team manages available plugins
-- **Consistent environment**: Same execution environment for all developers
-
-## Plugin Execution Flow
-
-```mermaid
-sequenceDiagram
-    participant CLI as EasyP CLI
-    participant API as gRPC Server
-    participant DB as PostgreSQL
-    participant Docker as Docker Engine
-    participant Registry as Docker Registry
-    
-    Note over CLI: Parse protobuf files
-    CLI->>API: CodeGeneratorRequest (per plugin)
-    
-    API->>DB: Fetch plugin parameters
-    Note over DB: CPU/memory limits<br/>Docker image name<br/>Execution config
-    DB-->>API: Plugin execution params
-    
-    API->>Docker: Pull plugin image (if needed)
-    Docker->>Registry: Download image
-    Registry-->>Docker: Plugin image
-    
-    API->>Docker: Run plugin container
-    Note over Docker: Isolated execution<br/>Resource limits applied
-    Docker-->>API: CodeGeneratorResponse
-    
-    API->>PROM: Record metrics
-    Note over PROM: Execution time<br/>Success/failure<br/>Resource usage
-    
-    API-->>CLI: CodeGeneratorResponse
-```
-
-### Execution Steps
-
-1. **CLI Parsing**: CLI parses protobuf files locally
-2. **Request Sending**: CLI sends `CodeGeneratorRequest` to API Service (one request per plugin)
-3. **Parameter Lookup**: API Service fetches plugin execution parameters from PostgreSQL
-4. **Docker Execution**: API Service runs plugin in isolated Docker container
-5. **Metrics Recording**: Execution metrics are recorded (at end of request)
-6. **Response**: Generated code is returned to CLI
-
-## Key Features
-
-| Feature | Description |
-|---------|-------------|
-| **🐳 Plugin Isolation** | Each plugin runs in a secure, isolated Docker container |
-| **⚙️ Resource Control** | CPU and memory limits enforced per plugin |
-| **📊 Metrics & Monitoring** | Prometheus metrics for all operations |
-| **🔄 Version Management** | Centralized plugin version control via Docker images |
-| **⚡ Simple Protocol** | Standard `CodeGeneratorRequest/Response` protocol |
-| **🔒 Security First** | Container isolation with resource constraints |
-
-## Configuration
-
-The service is configured via environment variables:
-
-### Server Configuration
-```bash
-EASYP_SERVICE_HOST=0.0.0.0
-EASYP_SERVICE_GRPC_PORT=8080
-```
-
-### Database Configuration
-```bash
-EASYP_SERVICE_DB_HOST=localhost
-EASYP_SERVICE_DB_PORT=5432
-EASYP_SERVICE_DB_NAME=easyp_service
-EASYP_SERVICE_DB_USER=easyp
-EASYP_SERVICE_DB_PASSWORD=password
-```
-
-### Docker Configuration
-```bash
-# Docker socket for container execution
-DOCKER_HOST=unix:///var/run/docker.sock
-```
-
-## Plugin Parameters Storage
-
-PostgreSQL stores execution parameters for each plugin:
-
-```sql
--- Example plugin configuration
-{
-  "plugin_name": "protobuf/go:v1.36.10",
-  "docker_image": "easyp/protoc-gen-go:v1.36.10",
-  "resources": {
-    "cpu_limit": "1.0",
-    "memory_limit": "512MB"
-  },
-  "execution_config": {
-    "timeout": "30s",
-    "network": "none"
-  }
-}
-```
-
-::: tip
-The storage schema and capabilities will be expanded in future releases to support additional features like audit logging, usage analytics, and plugin caching.
-:::
-
-## Integration with EasyP CLI
-
-Configure your `easyp.yaml` to use remote plugin execution:
-
-```yaml
-generate:
-  plugins:
-    # Remote plugin execution via API Service
-    - remote: api.easyp.tech/protobuf/go:v1.36.10
-      out: .
-      opts:
-        paths: source_relative
-    
-    - remote: api.easyp.tech/grpc/go:v1.5.1
-      out: .
-      opts:
-        paths: source_relative
-```
-
-Then generate code:
-
-```bash
-easyp generate
-```
-
-The CLI will:
-1. Parse your protobuf files
-2. Send separate requests to API Service for each plugin
-3. Receive generated code responses
-4. Write generated files to specified output directories
-
-## Available Metrics
-
-Prometheus metrics exposed by the service:
-
-| Metric | Description |
-|--------|-------------|
-| `easyp_api_service_api_grpc_server_handled_total` | Total gRPC requests by status code |
-| `easyp_api_service_api_grpc_server_handling_seconds` | gRPC request latency histogram |
-| `easyp_api_service_generated_plugin_code_total` | Plugin executions by plugin name |
-| `easyp_api_service_repo_call_duration_seconds` | Database query latency |
-| `easyp_api_service_repo_errors_total` | Database errors count |
-| `easyp_api_service_standard_panics_total` | Recovered panics count |
-
-## Performance Characteristics
-
-| Metric | Typical Value | Notes |
-|--------|---------------|-------|
-| **Cold Start** | 2-5 seconds | First time pulling plugin image |
-| **Warm Start** | 100-500ms | Plugin image cached by Docker |
-| **Throughput** | 20-50 concurrent | Depends on available resources |
-| **Memory Usage** | 50-200MB | Per plugin execution |
-
-## Security
-
-### Container Isolation
-- Each plugin runs in a separate, ephemeral container
-- No network access during plugin execution
-- Resource limits (CPU, memory) enforced via Docker
-- Containers destroyed after execution
-
-### API Security
-- gRPC-based communication
-- Support for authentication tokens (production deployments)
-- Input validation for all requests
-- Execution audit logs stored in PostgreSQL
-
-## Production Considerations
-
-### Scalability
-- **Horizontal scaling**: Deploy multiple service instances behind load balancer
-- **Resource management**: Configure appropriate CPU/memory limits per plugin
-- **Database**: PostgreSQL can be replicated for high availability
-
-### Monitoring
-- **Prometheus metrics**: Monitor all aspects of service health
-- **Alerting**: Set up alerts for high error rates or slow execution
-- **Logs**: Structured logging for debugging and audit trails
-
-### Future Enhancements
-The API Service is actively developed with planned features including:
-- Plugin result caching for faster repeated executions
-- Enhanced audit logging and usage analytics
-- Support for custom plugin registries
-- Advanced resource scheduling and optimization
-
-## Community and Support
-
-- **💬 [Telegram Chat](https://t.me/easyptech)** - Community discussion
-- **🐛 [GitHub Issues](https://github.com/easyp-tech/service/issues)** - Bug reports and features
-- **📖 [Documentation](https://easyp.tech)** - Complete documentation
-
----
-
-*Simplify your protobuf workflows with centralized plugin execution*
\ No newline at end of file
diff --git a/docs/dist/docs/guide/ci-cd/github-actions.md b/docs/dist/docs/guide/ci-cd/github-actions.md
deleted file mode 100644
index 183d6073..00000000
--- a/docs/dist/docs/guide/ci-cd/github-actions.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Github Actions
-
-## Work in progress
\ No newline at end of file
diff --git a/docs/dist/docs/guide/ci-cd/gitlab.md b/docs/dist/docs/guide/ci-cd/gitlab.md
deleted file mode 100644
index 2de4597c..00000000
--- a/docs/dist/docs/guide/ci-cd/gitlab.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Gitlab
-
-## Work in progress
\ No newline at end of file
diff --git a/docs/dist/docs/guide/cli/auto-completion/auto-completion.md b/docs/dist/docs/guide/cli/auto-completion/auto-completion.md
deleted file mode 100644
index ad650b77..00000000
--- a/docs/dist/docs/guide/cli/auto-completion/auto-completion.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# Auto completion
-
-## zsh auto-completion
-
-1. Add the following line to your ~/.zshrc startup script:
-
-```bash
-source <(easyp completion zsh)
-```
-
-2. Re-launch your shell or run:
-
-```bash
-source ~/.zshrc
-```
-
-## Bash auto-completion
-
-1. Install [bash-completion](https://github.com/scop/bash-completion#installation) and add the software to your `~/.bashrc`.
-2. Add the following line to your ~/.bashrc startup script:
-
-```bash
-source <(easyp completion bash)
-```
-
-3. Re-launch your shell or run:
-
-```bash
-source ~/.bashrc
-```
-
diff --git a/docs/dist/docs/guide/cli/breaking-changes/breaking-changes.md b/docs/dist/docs/guide/cli/breaking-changes/breaking-changes.md
deleted file mode 100644
index c1221a43..00000000
--- a/docs/dist/docs/guide/cli/breaking-changes/breaking-changes.md
+++ /dev/null
@@ -1,451 +0,0 @@
-# Breaking Changes Detection
-
-[[toc]]
-
-EasyP's breaking changes detection helps you maintain backward compatibility in your protobuf APIs by automatically identifying changes that could break existing clients. This is crucial for maintaining stable APIs in production environments.
-
-## Overview
-
-The breaking changes checker compares your current protobuf files against a previous version (typically from another Git branch) and identifies modifications that could cause compatibility issues for existing clients.
-
-### Key Features
-
-- **Git-based Comparison**: Compare against any Git reference (branch, tag, or commit)
-- **Comprehensive Analysis**: Checks services, messages, enums, fields, and imports
-- **Selective Ignore**: Skip specific directories from breaking change analysis
-- **Detailed Reports**: Clear error messages with file locations and line numbers
-
-## How It Works
-
-The breaking changes detector follows this process:
-
-1. **Checkout Comparison Branch**: Retrieves proto files from the specified Git reference
-2. **Parse Both Versions**: Analyzes current and previous proto file structures
-3. **Compare Entities**: Systematically checks all protobuf elements for breaking changes
-4. **Generate Report**: Produces detailed issue reports with locations and descriptions
-
-## Detection Level
-
-EasyP implements **WIRE+ level** breaking change detection:
-- ✅ **Full wire format compatibility** - ensures old and new versions can exchange data
-- ✅ **Element deletion detection** - catches deleted services, messages, fields, etc.
-- ✅ **Type safety** - detects incompatible type changes
-- ❌ **Field/method renames** - currently not detected (planned for future releases)
-- ❌ **File-level changes** - package moves, file options not checked yet
-
-This provides strong compatibility guarantees while being less strict than some tools that check generated code compatibility.
-
-## Configuration
-
-Configure breaking changes detection in your `easyp.yaml`:
-
-```yaml
-breaking:
-  # Git reference to compare against (branch, tag, or commit hash)
-  against_git_ref: "main"
-  
-  # Directories to ignore during breaking changes analysis
-  ignore:
-    - "experimental"
-    - "internal/proto"
-    - "vendor"
-```
-
-### Configuration Options
-
-| Option | Description | Default | Required |
-|--------|-------------|---------|----------|
-| `against_git_ref` | Git reference to compare against | `"master"` | No |
-| `ignore` | List of directories to exclude from analysis | `[]` | No |
-
-## Usage
-
-### Basic Usage
-
-Compare current changes against the main branch:
-
-```bash
-easyp breaking --against main
-```
-
-### Using Configuration File
-
-With a custom configuration file:
-
-```bash
-easyp --cfg my-config.yaml breaking
-```
-
-### Override Git Reference
-
-Override the configured branch:
-
-```bash
-easyp breaking --against feature/new-api
-```
-
-## Detection Level
-
-EasyP currently implements **WIRE+ level** breaking change detection, which provides comprehensive wire format compatibility plus some generated code protections:
-
-### Comparison with Buf Categories
-
-| Check Type | Buf WIRE | Buf WIRE_JSON | Buf FILE | EasyP Current |
-|------------|----------|---------------|----------|---------------|
-| **Element Deletions** |
-| Service deletion | ❌ | ❌ | ✅ | ✅ |
-| RPC method deletion | ❌ | ❌ | ✅ | ✅ |
-| Message deletion | ❌ | ❌ | ✅ | ✅ |
-| Field deletion (by number) | ✅ | ✅ | ✅ | ✅ |
-| Enum deletion | ❌ | ❌ | ✅ | ✅ |
-| Enum value deletion | ✅ | ✅ | ✅ | ✅ |
-| OneOf deletion | ❌ | ❌ | ✅ | ✅ |
-| Import deletion | ❌ | ❌ | ✅ | ✅ |
-| **Type Changes** |
-| Field type change | ✅ | ✅ | ✅ | ✅ |
-| RPC request/response type | ✅ | ✅ | ✅ | ✅ |
-| Optional/required changes | ✅ | ✅ | ✅ | ✅ |
-| **Naming (Generated Code)** |
-| Field rename (same number) | ❌ | ✅ | ✅ | ❌ |
-| Enum value rename | ❌ | ✅ | ✅ | ✅ |
-| **File Structure** |
-| Package change | ✅ | ✅ | ✅ | ❌ |
-| File options (go_package, etc) | ❌ | ❌ | ✅ | ❌ |
-| Moving types between files | ❌ | ❌ | ✅ | ❌ |
-
-### What This Means
-
-**✅ EasyP WILL detect:**
-- All wire format breaking changes
-- Deletion of services, methods, messages, fields
-- Type changes that break serialization
-- Enum value renames (same number, different name)
-
-**❌ EasyP will NOT detect:**
-- Field renames (same number, different name)
-- Package name changes
-- File option changes (go_package, java_package, etc.)
-- Moving types between files in the same package
-
-## Breaking Change Rules
-
-EasyP detects the following types of breaking changes:
-
-### Comparison with Other Tools
-
-| Detection Level | Description | EasyP Support |
-|----------------|-------------|---------------|
-| **WIRE** | Wire format compatibility only | ✅ **Full support** |
-| **WIRE+** | Wire + element deletion detection | ✅ **Current level** |
-| **FILE** | Generated code compatibility | ❌ Partial (planned) |
-## Breaking Change Rules
-
-EasyP detects the following categories of breaking changes. Each rule has detailed documentation with examples:
-
-### 🚨 Service and RPC Changes
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [SERVICE_NO_DELETE](./rules/service-no-delete.md) | Services cannot be deleted | ✅ Implemented |
-| [RPC_NO_DELETE](./rules/rpc-no-delete.md) | RPC methods cannot be deleted | ✅ Implemented |
-| [RPC_SAME_REQUEST_TYPE](./rules/rpc-same-request-type.md) | RPC request types cannot be changed | ✅ Implemented |
-| [RPC_SAME_RESPONSE_TYPE](./rules/rpc-same-response-type.md) | RPC response types cannot be changed | ✅ Implemented |
-
-### 📦 Message and Field Changes
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [MESSAGE_NO_DELETE](./rules/message-no-delete.md) | Messages cannot be deleted | ✅ Implemented |
-| [FIELD_NO_DELETE](./rules/field-no-delete.md) | Fields cannot be deleted | ✅ Implemented |
-| [FIELD_SAME_TYPE](./rules/field-same-type.md) | Field types cannot be changed | ✅ Implemented |
-| [FIELD_SAME_CARDINALITY](./rules/field-same-cardinality.md) | Field optionality (optional/required) cannot be changed | ✅ Implemented |
-
-### 🔢 Enum Changes
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [ENUM_NO_DELETE](./rules/enum-no-delete.md) | Enums cannot be deleted | ✅ Implemented |
-| [ENUM_VALUE_NO_DELETE](./rules/enum-value-no-delete.md) | Enum values cannot be deleted | ✅ Implemented |
-| [ENUM_VALUE_SAME_NAME](./rules/enum-value-same-name.md) | Enum value names cannot be changed | ✅ Implemented |
-
-### 🔗 OneOf Changes
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [ONEOF_NO_DELETE](./rules/oneof-no-delete.md) | OneOf fields cannot be deleted | ✅ Implemented |
-| [ONEOF_FIELD_NO_DELETE](./rules/oneof-field-no-delete.md) | Fields within oneofs cannot be deleted | ✅ Implemented |
-| [ONEOF_FIELD_SAME_TYPE](./rules/oneof-field-same-type.md) | OneOf field types cannot be changed | ✅ Implemented |
-
-### 📥 Import Changes
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [IMPORT_NO_DELETE](./rules/import-no-delete.md) | Import statements cannot be removed | ✅ Implemented |
-
-## Not Currently Detected
-
-The following changes are **NOT detected** by EasyP (but may break generated code):
-
-| Change Type | Example | Impact |
-|-------------|---------|---------|
-| Field renaming | `string name = 1` → `string full_name = 1` | Generated code breaks |
-| Package changes | `package v1` → `package v2` | Import paths change |
-| File options | `option go_package = "old"` → `option go_package = "new"` | Generated code location |
-| Moving between files | Message moved to different .proto file | Import dependencies |
-
-## Detailed Rules Documentation
-
-For comprehensive examples and migration strategies, see the individual rule documentation:
-
-- **Service Changes**: [SERVICE_NO_DELETE](./rules/service-no-delete.md), [RPC_NO_DELETE](./rules/rpc-no-delete.md), [RPC_SAME_REQUEST_TYPE](./rules/rpc-same-request-type.md), [RPC_SAME_RESPONSE_TYPE](./rules/rpc-same-response-type.md)
-- **Message Changes**: [MESSAGE_NO_DELETE](./rules/message-no-delete.md), [FIELD_NO_DELETE](./rules/field-no-delete.md), [FIELD_SAME_TYPE](./rules/field-same-type.md), [FIELD_SAME_CARDINALITY](./rules/field-same-cardinality.md)
-- **Enum Changes**: [ENUM_NO_DELETE](./rules/enum-no-delete.md), [ENUM_VALUE_NO_DELETE](./rules/enum-value-no-delete.md), [ENUM_VALUE_SAME_NAME](./rules/enum-value-same-name.md)
-- **OneOf Changes**: [ONEOF_NO_DELETE](./rules/oneof-no-delete.md), [ONEOF_FIELD_NO_DELETE](./rules/oneof-field-no-delete.md), [ONEOF_FIELD_SAME_TYPE](./rules/oneof-field-same-type.md)
-- **Import Changes**: [IMPORT_NO_DELETE](./rules/import-no-delete.md)
-
-Each rule includes:
-- ❌ **Bad examples** with actual breaking changes
-- ✅ **Good alternatives** showing safe approaches  
-- 🔧 **Migration strategies** for handling necessary changes
-- 📋 **Real error messages** from EasyP
-
-## Quick Examples
-
-### ✅ Safe Changes (Always Allowed)
-```proto
-// Adding new elements is always safe
-message User {
-  string name = 1;
-  string email = 2;
-  string phone = 3;  // ✅ New field - safe
-}
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc GetUserProfile(GetUserRequest) returns (UserProfile);  // ✅ New RPC - safe
-}
-
-enum Status {
-  STATUS_UNSPECIFIED = 0;
-  STATUS_ACTIVE = 1;
-  STATUS_PENDING = 2;  // ✅ New enum value - safe
-}
-```
-
-### ❌ Breaking Changes (Always Detected)
-```proto
-// Deletions and type changes break compatibility
-message User {
-  string name = 1;
-  // ❌ Deleted field - BREAKING
-}
-
-service UserService {
-  // ❌ Deleted RPC method - BREAKING  
-  rpc GetUser(GetUserRequestV2) returns (GetUserResponse);  // ❌ Changed request type - BREAKING
-}
-```
-
-### Scenario 3: Breaking Changes (Currently Not Detected)
-
-```proto
-// 🟡 Breaks generated code but passes EasyP checks
-message User {
-  string user_name = 1;    // Renamed from "name"
-  string user_email = 2;   // Renamed from "email"
-}
-
-service UserService {
-  rpc GetUserProfile(GetUserRequest) returns (GetUserResponse);  // Renamed from GetUser
-}
-```
-
-## Output Format
-
-### Text Format (Default)
-
-```
-services.proto:45:1: Previously present RPC "DeleteUser" on service "UserService" was deleted. (BREAKING_CHECK)
-messages.proto:15:3: Previously present field "2" with name "email" on message "User" was deleted. (BREAKING_CHECK)
-```
-
-### JSON Format
-
-```bash
-easyp --format json breaking --against main
-```
-
-```json
-{
-  "path": "services.proto",
-  "position": {
-    "line": 45,
-    "column": 1
-  },
-  "source_name": "",
-  "message": "Previously present RPC \"DeleteUser\" on service \"UserService\" was deleted.",
-  "rule_name": "BREAKING_CHECK"
-}
-```
-
-## Best Practices
-
-### 1. Regular Checks
-Run breaking change detection in your CI/CD pipeline:
-
-```yaml
-# GitHub Actions example
-- name: Check for breaking changes
-  run: easyp breaking --against origin/main
-```
-
-### 2. Branch Protection
-Use breaking change checks to protect important branches:
-
-```yaml
-# Only allow PRs that don't introduce breaking changes
-if: github.event_name == 'pull_request'
-run: |
-  easyp breaking --against origin/main
-  if [ $? -eq 1 ]; then
-    echo "Breaking changes detected!"
-    exit 1
-  fi
-```
-
-### 3. Versioning Strategy
-When breaking changes are necessary:
-
-- Create a new package version (e.g., `myservice.v2`)
-- Maintain the old version during migration period
-- Use deprecation notices in the old version
-
-### 4. Ignore Patterns
-Use ignore patterns wisely:
-
-```yaml
-breaking:
-  ignore:
-    - "experimental/**"      # Experimental APIs
-    - "internal/**"          # Internal-only APIs
-    - "**/testing/**"        # Test utilities
-```
-
-## Common Issues and Solutions
-
-### Issue: "Repository does not exist"
-**Solution**: Ensure you're running the command in a Git repository with the specified branch available.
-
-### Issue: "Cannot find git ref"
-**Solution**: Verify the branch/tag name exists and is accessible:
-```bash
-git branch -a  # List all branches
-git tag        # List all tags
-```
-
-### Issue: False Positives in Generated Code
-**Solution**: Add generated directories to ignore list:
-```yaml
-breaking:
-  ignore:
-    - "generated/**"
-    - "**/pb/**"
-```
-
-### Issue: Large Number of Changes
-**Solution**: For major refactoring, consider:
-1. Creating a new API version
-2. Implementing changes incrementally
-3. Using feature flags for gradual rollout
-
-## Integration Examples
-
-### CI/CD Pipeline Integration
-
-#### GitHub Actions
-
-```yaml
-name: API Compatibility Check
-
-on:
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  breaking-changes:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          fetch-depth: 0  # Fetch full history
-      
-      - name: Install EasyP
-        run: |
-          curl -sSfL https://raw.githubusercontent.com/easyp-tech/easyp/main/install.sh | sh
-          
-      - name: Check for breaking changes
-        run: |
-          ./bin/easyp breaking --against origin/main
-```
-
-#### GitLab CI
-
-```yaml
-breaking-changes:
-  stage: test
-  image: easyp/lint:latest
-  script:
-    - git fetch origin main
-    - easyp breaking --against origin/main
-  rules:
-    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
-```
-
-### Pre-commit Hook
-
-```bash
-#!/bin/sh
-# .git/hooks/pre-push
-
-protected_branch='main'
-current_branch=$(git symbolic-ref HEAD | sed -e 's,.*/\(.*\),\1,')
-
-if [ $current_branch = $protected_branch ]; then
-    echo "Running breaking changes check..."
-    easyp breaking --against HEAD~1
-    if [ $? -eq 1 ]; then
-        echo "❌ Breaking changes detected. Push rejected."
-        exit 1
-    fi
-    echo "✅ No breaking changes detected."
-fi
-```
-
-## Troubleshooting
-
-### Debug Mode
-Enable debug logging for detailed information:
-
-```bash
-easyp --debug breaking --against main
-```
-
-### Manual Comparison
-For complex cases, you can manually inspect the comparison:
-
-```bash
-# Compare specific files
-git show main:path/to/file.proto > old_version.proto
-easyp lint old_version.proto  # Validate old version
-easyp lint current_file.proto  # Validate current version
-```
-
-### Performance Optimization
-For large repositories:
-
-```bash
-# Limit scope to specific paths
-easyp breaking --against main --path api/
-```
-
-The breaking changes detection in EasyP provides a robust foundation for maintaining API compatibility while allowing your protobuf schemas to evolve safely over time.
\ No newline at end of file
diff --git a/docs/dist/docs/guide/cli/breaking-changes/rules/enum-no-delete.md b/docs/dist/docs/guide/cli/breaking-changes/rules/enum-no-delete.md
deleted file mode 100644
index 2bd79b8f..00000000
--- a/docs/dist/docs/guide/cli/breaking-changes/rules/enum-no-delete.md
+++ /dev/null
@@ -1,338 +0,0 @@
-# ENUM_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no enums are deleted from proto files. Deleting an enum breaks both wire format compatibility and generated code, as existing data may contain values from the deleted enum and client code depends on the generated enum types.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-enum UserRole { // [!code --]
-  USER_ROLE_UNSPECIFIED = 0; // [!code --]
-  USER_ROLE_ADMIN = 1; // [!code --]
-  USER_ROLE_USER = 2; // [!code --]
-} // [!code --]
-
-message Order {
-  string id = 1;
-  OrderStatus status = 2;
-  UserRole created_by_role = 3;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-// UserRole enum was deleted - BREAKING CHANGE!
-
-message Order {
-  string id = 1;
-  OrderStatus status = 2;
-  UserRole created_by_role = 3; // ERROR: UserRole no longer exists!
-}
-```
-
-**Error:**
-```
-user.proto:8:1: Previously present enum "UserRole" was deleted from file. (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Nested enum deletion:**
-
-```proto
-// Before
-message User {
-  string name = 1;
-  Status status = 2;
-  
-  enum Status { // [!code --]
-    STATUS_UNSPECIFIED = 0; // [!code --]
-    STATUS_ACTIVE = 1; // [!code --]
-    STATUS_INACTIVE = 2; // [!code --]
-  } // [!code --]
-}
-
-// After - BREAKING CHANGE!
-message User {
-  string name = 1;
-  Status status = 2;  // ERROR: Status enum deleted
-  
-  // Status nested enum was deleted
-}
-```
-
-### Good
-
-**Instead of deleting, deprecate the enum:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-enum UserRole {
-  option deprecated = true; // [!code focus]
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMIN = 1;
-  USER_ROLE_USER = 2;
-}
-
-message Order {
-  string id = 1;
-  OrderStatus status = 2;
-  UserRole created_by_role = 3 [deprecated = true]; // [!code focus]
-}
-```
-
-**Or replace with new enum:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-enum UserRole {
-  option deprecated = true; // [!code focus] // Old enum
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMIN = 1;
-  USER_ROLE_USER = 2;
-}
-
-enum UserPermission { // [!code focus] // New enum with better design
-  USER_PERMISSION_UNSPECIFIED = 0; // [!code focus]
-  USER_PERMISSION_READ = 1; // [!code focus]
-  USER_PERMISSION_WRITE = 2; // [!code focus]
-  USER_PERMISSION_ADMIN = 3; // [!code focus]
-} // [!code focus]
-
-message Order {
-  string id = 1;
-  OrderStatus status = 2;
-  UserRole created_by_role = 3 [deprecated = true]; // [!code focus] // Old field
-  UserPermission created_by_permission = 4; // [!code focus] // New field
-}
-```
-
-## Impact
-
-- **Wire Format:** Existing data with the deleted enum cannot be deserialized
-- **Generated Code:** Enum types/constants are removed, breaking client compilation
-- **Field References:** Fields using the deleted enum type become invalid
-- **Switch Statements:** Client code with enum switch cases breaks
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-order := &myapi.Order{
-    Id:            "order123",
-    Status:        myapi.OrderStatus_ORDER_STATUS_PENDING,
-    CreatedByRole: myapi.UserRole_USER_ROLE_ADMIN,  // ERROR after deletion
-}
-
-// Check role
-switch order.CreatedByRole {
-case myapi.UserRole_USER_ROLE_ADMIN:  // ERROR: undefined type
-    // Admin logic
-case myapi.UserRole_USER_ROLE_USER:   // ERROR: undefined type
-    // User logic
-}
-
-// Generated code compilation fails:
-// undefined: myapi.UserRole
-// undefined: myapi.UserRole_USER_ROLE_ADMIN
-```
-
-**Existing data becomes unreadable:**
-```json
-// Serialized data before deletion
-{
-  "id": "order123",
-  "status": "ORDER_STATUS_PENDING",
-  "created_by_role": "USER_ROLE_ADMIN"
-}
-
-// After UserRole deletion - deserialization fails
-// Parser doesn't know how to handle "created_by_role" field
-```
-
-**Server implementation breaks:**
-```go
-// Before - server handles enum
-func validateOrder(order *Order) error {
-    switch order.CreatedByRole {
-    case UserRole_USER_ROLE_ADMIN:  // ERROR: type not found
-        return nil  // Admins can create any order
-    case UserRole_USER_ROLE_USER:   // ERROR: type not found
-        // Additional validation for regular users
-        return validateUserOrder(order)
-    default:
-        return errors.New("invalid user role")
-    }
-}
-```
-
-## Migration Strategy
-
-1. **Deprecate the enum first:**
-   ```proto
-   enum OldEnum {
-     option deprecated = true;
-     // ... values
-   }
-   ```
-
-2. **Stop using in new fields** and deprecate existing fields:
-   ```proto
-   OldEnum old_field = 5 [deprecated = true];
-   ```
-
-3. **Create replacement** if needed:
-   ```proto
-   enum NewEnum {
-     // Better designed enum values
-   }
-   NewEnum new_field = 6;
-   ```
-
-4. **Update server code** to handle both during transition:
-   ```go
-   func handleRole(oldRole OldEnum, newRole NewEnum) {
-       // Handle both enum types during migration
-       if newRole != NEW_ENUM_UNSPECIFIED {
-           // Use new enum
-           return handleNewRole(newRole)
-       }
-       // Fall back to old enum
-       return handleOldRole(oldRole)
-   }
-   ```
-
-5. **Remove after migration period** in a new major version
-
-## Common Scenarios
-
-### Enum Redesign
-```proto
-// Instead of deleting old enum
-enum Priority {
-  option deprecated = true;  // Deprecate old design
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_HIGH = 2;
-}
-
-enum TaskPriority {  // Create new enum with better naming
-  TASK_PRIORITY_UNSPECIFIED = 0;
-  TASK_PRIORITY_LOW = 1;
-  TASK_PRIORITY_MEDIUM = 2;
-  TASK_PRIORITY_HIGH = 3;
-  TASK_PRIORITY_URGENT = 4;
-}
-```
-
-### Consolidating Enums
-```proto
-// Instead of deleting multiple enums
-enum Status {
-  option deprecated = true;  // Keep old enum
-  STATUS_UNSPECIFIED = 0;
-  STATUS_ACTIVE = 1;
-}
-
-enum State {
-  option deprecated = true;  // Keep old enum
-  STATE_UNSPECIFIED = 0;
-  STATE_ENABLED = 1;
-}
-
-enum EntityStatus {  // New consolidated enum
-  ENTITY_STATUS_UNSPECIFIED = 0;
-  ENTITY_STATUS_ACTIVE = 1;
-  ENTITY_STATUS_INACTIVE = 2;
-  ENTITY_STATUS_ENABLED = 3;
-  ENTITY_STATUS_DISABLED = 4;
-}
-```
-
-### Moving Enum to Different Package
-```proto
-// Instead of deleting from current package
-enum UserRole {
-  option deprecated = true;  // Mark as deprecated
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMIN = 1;
-}
-
-// Import from new location
-import "common/roles.proto";
-
-message Order {
-  UserRole old_role = 3 [deprecated = true];
-  common.UserRole new_role = 4;  // Reference from new package
-}
-```
-
-### Version Migration
-```proto
-// Clean approach - new package version
-package myapi.v2;
-
-// Redesigned enums without deprecated ones
-enum UserPermission {
-  USER_PERMISSION_UNSPECIFIED = 0;
-  USER_PERMISSION_READ = 1;
-  USER_PERMISSION_WRITE = 2;
-  USER_PERMISSION_ADMIN = 3;
-}
-
-message Order {
-  string id = 1;
-  UserPermission created_by_permission = 2;  // Clean design in v2
-}
-```
diff --git a/docs/dist/docs/guide/cli/breaking-changes/rules/enum-value-no-delete.md b/docs/dist/docs/guide/cli/breaking-changes/rules/enum-value-no-delete.md
deleted file mode 100644
index de6a62b1..00000000
--- a/docs/dist/docs/guide/cli/breaking-changes/rules/enum-value-no-delete.md
+++ /dev/null
@@ -1,332 +0,0 @@
-# ENUM_VALUE_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no enum values are deleted from enums. Deleting an enum value breaks both wire format compatibility and generated code, as existing data may contain the deleted enum value and client code may reference the generated constants.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-  ORDER_STATUS_CANCELLED = 5;
-}
-
-enum Priority {
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_MEDIUM = 2;
-  PRIORITY_HIGH = 3;
-  PRIORITY_URGENT = 4;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-  // ORDER_STATUS_CANCELLED = 5; // [!code --] Deleted enum value - BREAKING!
-}
-
-enum Priority {
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_MEDIUM = 2;
-  PRIORITY_HIGH = 3;
-  // PRIORITY_URGENT = 4; // [!code --] Deleted enum value - BREAKING!
-}
-```
-
-**Error:**
-```
-order.proto:9:3: Previously present enum value "5" on enum "OrderStatus" was deleted. (BREAKING_CHECK)
-priority.proto:8:3: Previously present enum value "4" on enum "Priority" was deleted. (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Multiple value deletions:**
-
-```proto
-// Before
-enum UserRole {
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_GUEST = 1;
-  USER_ROLE_USER = 2;
-  USER_ROLE_MODERATOR = 3;
-  USER_ROLE_ADMIN = 4;
-  USER_ROLE_SUPERADMIN = 5;
-}
-
-// After - BREAKING CHANGES!
-enum UserRole {
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_USER = 2;
-  USER_ROLE_ADMIN = 4;
-  // USER_ROLE_GUEST = 1;      // BREAKING: deleted
-  // USER_ROLE_MODERATOR = 3;  // BREAKING: deleted  
-  // USER_ROLE_SUPERADMIN = 5; // BREAKING: deleted
-}
-```
-
-### Good
-
-**Instead of deleting, deprecate the enum values:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-  ORDER_STATUS_CANCELLED = 5 [deprecated = true]; // [!code focus]
-}
-
-enum Priority {
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_MEDIUM = 2;
-  PRIORITY_HIGH = 3;
-  PRIORITY_URGENT = 4 [deprecated = true]; // [!code focus]
-}
-```
-
-**Or reserve the enum values after removal:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  reserved 5; // [!code focus]
-  reserved "ORDER_STATUS_CANCELLED"; // [!code focus]
-  
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-enum Priority {
-  reserved 4; // [!code focus]
-  reserved "PRIORITY_URGENT"; // [!code focus]
-  
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_MEDIUM = 2;
-  PRIORITY_HIGH = 3;
-}
-```
-
-## Impact
-
-- **Wire Format:** Existing data with deleted enum values cannot be properly deserialized
-- **Generated Code:** Enum constants are removed, breaking client compilation
-- **Client Applications:** Code referencing deleted enum values fails to compile
-- **Switch Statements:** Case statements for deleted values cause compilation errors
-- **Default Handling:** Unknown enum values may be handled differently
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-order := &myapi.Order{
-    Status: myapi.OrderStatus_ORDER_STATUS_CANCELLED,  // ERROR after deletion
-}
-
-// Switch statement breaks
-switch order.Status {
-case myapi.OrderStatus_ORDER_STATUS_PENDING:
-    // Handle pending
-case myapi.OrderStatus_ORDER_STATUS_CANCELLED:  // ERROR: undefined constant
-    // Handle cancellation
-default:
-    // Handle unknown
-}
-
-// Generated code compilation fails:
-// undefined: myapi.OrderStatus_ORDER_STATUS_CANCELLED
-```
-
-**Existing data becomes problematic:**
-```json
-// Serialized data before deletion
-{
-  "id": "order123",
-  "status": "ORDER_STATUS_CANCELLED"
-}
-
-// After enum value deletion
-// Data deserializes but status becomes UNSPECIFIED (0)
-// or causes parsing errors depending on implementation
-```
-
-**Server validation breaks:**
-```go
-// Before - server handles all enum values
-func validateOrderStatus(status OrderStatus) error {
-    switch status {
-    case OrderStatus_ORDER_STATUS_PENDING,
-         OrderStatus_ORDER_STATUS_CONFIRMED,
-         OrderStatus_ORDER_STATUS_SHIPPED,
-         OrderStatus_ORDER_STATUS_DELIVERED,
-         OrderStatus_ORDER_STATUS_CANCELLED:  // ERROR: undefined
-        return nil
-    default:
-        return errors.New("invalid order status")
-    }
-}
-
-// Server logic that depends on cancelled status
-func canModifyOrder(order *Order) bool {
-    return order.Status != OrderStatus_ORDER_STATUS_CANCELLED  // ERROR: undefined
-}
-```
-
-## Migration Strategy
-
-1. **Deprecate enum values first:**
-   ```proto
-   ORDER_STATUS_CANCELLED = 5 [deprecated = true];
-   ```
-
-2. **Stop using deprecated values** in new code:
-   ```go
-   // Don't set deprecated values in new code
-   order.Status = OrderStatus_ORDER_STATUS_DELIVERED  // Use alternative
-   ```
-
-3. **Update client code** to handle deprecated values gracefully:
-   ```go
-   switch order.Status {
-   case OrderStatus_ORDER_STATUS_CANCELLED:
-       // Handle legacy cancelled orders
-       log.Warn("Processing deprecated cancelled status")
-       // Convert to new status or handle specially
-   }
-   ```
-
-4. **Reserve the values** after sufficient migration period:
-   ```proto
-   reserved 5, "ORDER_STATUS_CANCELLED";
-   ```
-
-5. **Never reuse enum numbers** - they must remain reserved permanently
-
-## Common Scenarios
-
-### Business Logic Changes
-```proto
-// Instead of deleting discontinued status
-enum ProductStatus {
-  PRODUCT_STATUS_UNSPECIFIED = 0;
-  PRODUCT_STATUS_ACTIVE = 1;
-  PRODUCT_STATUS_INACTIVE = 2;
-  // PRODUCT_STATUS_DISCONTINUED = 3;  // Don't delete!
-  
-  // Better approach:
-  PRODUCT_STATUS_DISCONTINUED = 3 [deprecated = true];
-}
-```
-
-### Workflow Simplification
-```proto
-// Instead of removing intermediate states
-enum TaskStatus {
-  TASK_STATUS_UNSPECIFIED = 0;
-  TASK_STATUS_TODO = 1;
-  TASK_STATUS_IN_PROGRESS = 2;
-  // TASK_STATUS_IN_REVIEW = 3;    // Don't delete intermediate states!
-  // TASK_STATUS_APPROVED = 4;     // Don't delete!
-  TASK_STATUS_DONE = 5;
-  
-  // Better approach:
-  TASK_STATUS_IN_REVIEW = 3 [deprecated = true];
-  TASK_STATUS_APPROVED = 4 [deprecated = true];
-}
-```
-
-### Enum Consolidation
-```proto
-// When merging similar enum values
-enum NotificationLevel {
-  NOTIFICATION_LEVEL_UNSPECIFIED = 0;
-  NOTIFICATION_LEVEL_INFO = 1;
-  NOTIFICATION_LEVEL_WARNING = 2;
-  NOTIFICATION_LEVEL_ERROR = 3;
-  // Don't delete these even if consolidating:
-  NOTIFICATION_LEVEL_DEBUG = 4 [deprecated = true];  // Keep deprecated
-  NOTIFICATION_LEVEL_TRACE = 5 [deprecated = true];  // Keep deprecated
-}
-```
-
-## Wire Format Considerations
-
-### Enum Value Reuse Prevention
-```proto
-enum Status {
-  // Never reuse numbers, even after deletion
-  reserved 2;  // Was STATUS_DELETED, now reserved forever
-  reserved "STATUS_DELETED";
-  
-  STATUS_UNSPECIFIED = 0;
-  STATUS_ACTIVE = 1;
-  // STATUS_DELETED = 2;  // This number can never be reused
-  STATUS_INACTIVE = 3;
-}
-```
-
-### JSON Compatibility
-```proto
-// JSON uses enum names, so both number and name should be reserved
-enum Color {
-  reserved 2;      // Reserve the number
-  reserved "RED";  // Reserve the name for JSON compatibility
-  
-  COLOR_UNSPECIFIED = 0;
-  COLOR_BLUE = 1;
-  // COLOR_RED = 2;  // Was deleted, now reserved
-  COLOR_GREEN = 3;
-}
-```
-
-### Proto2 vs Proto3 Behavior
-```proto
-// Proto2: Unknown enum values are preserved in unknown fields
-// Proto3: Unknown enum values are preserved as-is
-// Both cases: Don't delete values that might exist in stored data
-
-// Safe approach for both syntax versions:
-enum MyEnum {
-  MY_ENUM_UNSPECIFIED = 0;
-  MY_ENUM_VALUE_OLD = 1 [deprecated = true];  // Don't delete
-  MY_ENUM_VALUE_NEW = 2;
-}
-```
diff --git a/docs/dist/docs/guide/cli/breaking-changes/rules/enum-value-same-name.md b/docs/dist/docs/guide/cli/breaking-changes/rules/enum-value-same-name.md
deleted file mode 100644
index f05a8f56..00000000
--- a/docs/dist/docs/guide/cli/breaking-changes/rules/enum-value-same-name.md
+++ /dev/null
@@ -1,173 +0,0 @@
-# ENUM_VALUE_SAME_NAME
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that enum values maintain the same name for each number. Changing an enum value's name (while keeping the same number) breaks both JSON compatibility and generated code, as clients expect specific constant names.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_APPROVED = 2; // [!code --] Changed from ORDER_STATUS_CONFIRMED
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_COMPLETED = 4; // [!code --] Changed from ORDER_STATUS_DELIVERED
-}
-```
-
-**Error:**
-```
-order.proto:7:3: Enum value "2" on enum "OrderStatus" changed name from "ORDER_STATUS_CONFIRMED" to "ORDER_STATUS_APPROVED". (BREAKING_CHECK)
-order.proto:9:3: Enum value "4" on enum "OrderStatus" changed name from "ORDER_STATUS_DELIVERED" to "ORDER_STATUS_COMPLETED". (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Multiple renames breaking clients:**
-
-```proto
-// Before
-enum UserRole {
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMIN = 1;
-  USER_ROLE_MODERATOR = 2;
-  USER_ROLE_USER = 3;
-}
-
-// After - ALL BREAKING CHANGES!
-enum UserRole {
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMINISTRATOR = 1;  // BREAKING: ADMIN -> ADMINISTRATOR
-  USER_ROLE_MOD = 2;           // BREAKING: MODERATOR -> MOD  
-  USER_ROLE_MEMBER = 3;        // BREAKING: USER -> MEMBER
-}
-```
-
-### Good
-
-**Instead of renaming, add new values and deprecate old ones:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2 [deprecated = true]; // [!code focus]
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4 [deprecated = true]; // [!code focus]
-  ORDER_STATUS_APPROVED = 5; // [!code focus] // New value instead of renaming
-  ORDER_STATUS_COMPLETED = 6; // [!code focus] // New value instead of renaming
-}
-```
-
-**Or create a new enum version:**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus] // New package version
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_APPROVED = 2; // [!code focus] // Clean names in v2
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_COMPLETED = 4; // [!code focus]
-}
-```
-
-## Impact
-
-- **Generated Code:** Constant names change, breaking client compilation
-- **JSON Compatibility:** JSON serialization uses enum names, breaking parsers
-- **Client Applications:** Code referencing old constant names fails to compile
-- **Documentation:** API docs become outdated with wrong enum names
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED
-if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED {
-    // handle delivery
-}
-
-// After rename - compilation fails
-status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED  // ERROR: undefined constant
-if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED {  // ERROR: undefined constant
-    // handle delivery
-}
-```
-
-**JSON compatibility breaks:**
-```json
-// Before - JSON uses old names
-{
-  "status": "ORDER_STATUS_CONFIRMED"
-}
-
-// After - parser expects new names
-{
-  "status": "ORDER_STATUS_APPROVED"  // Old JSON fails to parse
-}
-```
-
-## Migration Strategy
-
-1. **Add new enum values** instead of renaming:
-   ```proto
-   ORDER_STATUS_CONFIRMED = 2 [deprecated = true];
-   ORDER_STATUS_APPROVED = 5;  // New value
-   ```
-
-2. **Update server code** to handle both old and new values during transition
-
-3. **Migrate clients** to use new enum values
-
-4. **Remove deprecated values** in next major version:
-   ```proto
-   reserved 2, "ORDER_STATUS_CONFIRMED";
-   ORDER_STATUS_APPROVED = 5;
-   ```
-
-## Allow Alias Exception
-
-With `allow_alias = true`, you can temporarily have multiple names for the same value:
-
-```proto
-enum Status {
-  option allow_alias = true;
-  STATUS_UNSPECIFIED = 0;
-  STATUS_OLD_NAME = 1 [deprecated = true];
-  STATUS_NEW_NAME = 1;  // Same number, different name - allowed with alias
-}
-```
-
-Note: EasyP currently detects this as breaking even with `allow_alias`. This may be refined in future versions.
\ No newline at end of file
diff --git a/docs/dist/docs/guide/cli/breaking-changes/rules/field-no-delete.md b/docs/dist/docs/guide/cli/breaking-changes/rules/field-no-delete.md
deleted file mode 100644
index c1813cbf..00000000
--- a/docs/dist/docs/guide/cli/breaking-changes/rules/field-no-delete.md
+++ /dev/null
@@ -1,100 +0,0 @@
-# FIELD_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no message fields are deleted. Deleting a field breaks both wire format compatibility and generated code, as existing data may contain the deleted field and client code may reference it.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-  string phone = 4; // [!code --]
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-  // phone field was deleted - BREAKING CHANGE!
-}
-```
-
-**Error:**
-```
-user.proto:6:3: Previously present field "4" with name "phone" on message "User" was deleted. (BREAKING_CHECK)
-```
-
-### Good
-
-**Instead of deleting, deprecate the field:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-  string phone = 4 [deprecated = true]; // [!code focus]
-}
-```
-
-**Or reserve the field number after removal:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  reserved 4; // [!code focus]
-  reserved "phone"; // [!code focus]
-  
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-}
-```
-
-## Impact
-
-- **Wire Format:** Old messages with the deleted field cannot be properly deserialized
-- **Generated Code:** Field accessors are removed, breaking client compilation
-- **Data Loss:** Existing serialized data loses information
-- **JSON Compatibility:** JSON parsers expect the field to exist
-
-## Migration Strategy
-
-1. **Deprecate first:**
-   ```proto
-   string old_field = 5 [deprecated = true];
-   ```
-
-2. **Stop writing to the field** in your application code
-
-3. **Reserve the field** in next version to prevent accidental reuse:
-   ```proto
-   reserved 5;
-   reserved "old_field";
-   ```
-
-4. **Never reuse field numbers** - they must remain reserved permanently
\ No newline at end of file
diff --git a/docs/dist/docs/guide/cli/breaking-changes/rules/field-same-cardinality.md b/docs/dist/docs/guide/cli/breaking-changes/rules/field-same-cardinality.md
deleted file mode 100644
index 82114adb..00000000
--- a/docs/dist/docs/guide/cli/breaking-changes/rules/field-same-cardinality.md
+++ /dev/null
@@ -1,290 +0,0 @@
-# FIELD_SAME_CARDINALITY
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that message fields maintain the same cardinality (optionality). Changing a field's cardinality breaks both wire format compatibility and generated code, as the presence semantics and client code expectations differ between optional and required fields.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-}
-
-message CreateUserRequest {
-  string name = 1;
-  optional string email = 2;
-  string phone = 3;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  optional string email = 2; // [!code --] Changed from required to optional
-  int32 age = 3;
-}
-
-message CreateUserRequest {
-  string name = 1;
-  string email = 2; // [!code --] Changed from optional to required
-  string phone = 3;
-}
-```
-
-**Error:**
-```
-user.proto:6:3: Field "2" with name "email" on message "User" became optional. (BREAKING_CHECK)
-request.proto:7:3: Field "2" with name "email" on message "CreateUserRequest" became not optional. (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Proto2 to Proto3 migration issues:**
-
-```proto
-// Before (proto2)
-syntax = "proto2";
-
-message Order {
-  required string id = 1;
-  optional string notes = 2;
-  repeated string tags = 3;
-}
-
-// After (proto3) - BREAKING CHANGES!
-syntax = "proto3";
-
-message Order {
-  string id = 1;           // BREAKING: required -> implicit optional
-  string notes = 2;        // BREAKING: explicit optional -> implicit optional  
-  repeated string tags = 3; // OK: repeated unchanged
-}
-```
-
-### Good
-
-**Instead of changing cardinality, add new field:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2 [deprecated = true]; // [!code focus] // Keep original cardinality
-  int32 age = 3;
-  optional string email_optional = 4; // [!code focus] // New field with desired cardinality
-}
-
-message CreateUserRequest {
-  string name = 1;
-  optional string email = 2 [deprecated = true]; // [!code focus] // Keep original cardinality
-  string phone = 3;
-  string email_required = 4; // [!code focus] // New field with desired cardinality
-}
-```
-
-**Or create a new message version:**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus] // New package version
-
-message User {
-  string name = 1;
-  optional string email = 2; // [!code focus] // Clean cardinality in v2
-  int32 age = 3;
-}
-
-message CreateUserRequest {
-  string name = 1;
-  string email = 2; // [!code focus] // Required in v2
-  string phone = 3;
-}
-```
-
-## Impact
-
-- **Wire Format:** Field presence semantics change, breaking deserialization expectations
-- **Generated Code:** Field accessor methods change (hasField(), clearField())
-- **Validation:** Required field validation changes at runtime
-- **Default Values:** Optional vs required fields handle defaults differently
-
-## Real-World Example
-
-**Client code breaks with cardinality changes:**
-```go
-// Before - required field (proto3 implicit)
-user := &myapi.User{
-    Name:  "John",
-    Email: "john@example.com", // Must be set
-    Age:   30,
-}
-
-// Check if email is set (implicit presence)
-if user.Email != "" {
-    // Email is provided
-}
-
-// After - optional field (explicit presence) 
-user := &myapi.User{
-    Name: "John",
-    Age:  30,
-    // Email can be nil/unset
-}
-
-// Check if email is set (explicit presence)
-if user.Email != nil && *user.Email != "" {  // Different API!
-    // Email is provided
-}
-
-// Setting email also changes
-user.Email = &emailValue  // Pointer assignment vs direct
-```
-
-**Server validation breaks:**
-```go
-// Before - implicit required field
-func validateUser(user *User) error {
-    if user.Email == "" {  // Empty string check
-        return errors.New("email is required")
-    }
-    return nil
-}
-
-// After - explicit optional field
-func validateUser(user *User) error {
-    if user.Email == nil {  // Nil pointer check  
-        return errors.New("email is required")
-    }
-    if *user.Email == "" {  // Dereference to check empty
-        return errors.New("email cannot be empty")
-    }
-    return nil
-}
-```
-
-## Migration Strategy
-
-1. **Add new field** with correct cardinality:
-   ```proto
-   string old_email = 2 [deprecated = true];
-   optional string new_email = 5;  // New field with desired cardinality
-   ```
-
-2. **Dual-write period** - populate both fields during transition:
-   ```go
-   user := &User{
-       Name:     "John",
-       OldEmail: email,      // Legacy field
-       NewEmail: &email,     // New optional field
-   }
-   ```
-
-3. **Update clients** to use new field gradually:
-   ```go
-   // Check both fields during migration
-   email := user.NewEmail
-   if email == nil && user.OldEmail != "" {
-       emailValue := user.OldEmail
-       email = &emailValue  // Fallback to old field
-   }
-   ```
-
-4. **Remove old field** in next major version:
-   ```proto
-   reserved 2, "old_email";
-   optional string new_email = 5;
-   ```
-
-## Common Scenarios
-
-### Proto2 to Proto3 Migration
-```proto
-// Instead of direct syntax migration
-syntax = "proto3";
-message Order {
-  string id = 1;  // BREAKING: was required in proto2
-}
-
-// Maintain semantics during migration  
-syntax = "proto3";
-message Order {
-  string id = 1;  // Keep as implicit required
-  // Add explicit optional fields only when needed
-  optional string notes = 2;
-}
-```
-
-### Making Optional Fields Required
-```proto
-// Instead of changing existing field
-message CreateUserRequest {
-  string name = 1;
-  string email = 2;  // BREAKING: was optional
-}
-
-// Add new required field
-message CreateUserRequest {
-  string name = 1;
-  optional string email = 2 [deprecated = true];
-  string required_email = 3;  // New required field
-}
-```
-
-### Making Required Fields Optional
-```proto
-// Instead of changing existing field  
-message User {
-  optional string phone = 3;  // BREAKING: was required
-}
-
-// Add new optional field
-message User {
-  string phone = 3 [deprecated = true];  // Keep required
-  optional string phone_optional = 4;   // New optional field
-}
-```
-
-## Cardinality Types in Protobuf
-
-### Proto3 Cardinality
-- **Implicit optional**: `string name = 1;` (default in proto3)
-- **Explicit optional**: `optional string email = 2;` 
-- **Repeated**: `repeated string tags = 3;`
-- **Map**: `map<string, string> metadata = 4;`
-
-### Proto2 Cardinality  
-- **Required**: `required string id = 1;`
-- **Optional**: `optional string email = 2;`
-- **Repeated**: `repeated string tags = 3;`
-
-### Breaking Changes Matrix
-
-| From | To | Result |
-|------|----|---------| 
-| Required | Optional | ❌ BREAKING |
-| Optional | Required | ❌ BREAKING |
-| Implicit | Explicit | ❌ BREAKING |  
-| Explicit | Implicit | ❌ BREAKING |
-| Single | Repeated | ❌ BREAKING |
-| Repeated | Single | ❌ BREAKING |
-| Field | Map | ❌ BREAKING |
-| Map | Field | ❌ BREAKING |
\ No newline at end of file
diff --git a/docs/dist/docs/guide/cli/breaking-changes/rules/field-same-type.md b/docs/dist/docs/guide/cli/breaking-changes/rules/field-same-type.md
deleted file mode 100644
index 123255a6..00000000
--- a/docs/dist/docs/guide/cli/breaking-changes/rules/field-same-type.md
+++ /dev/null
@@ -1,152 +0,0 @@
-# FIELD_SAME_TYPE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that message fields maintain the same type. Changing a field's type breaks wire format compatibility and generated code, as the binary representation and client code expectations differ between types.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message Product {
-  string name = 1;
-  int32 price = 2;
-  bool available = 3;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message Product {
-  string name = 1;
-  string price = 2; // [!code --] Changed from int32 to string
-  bool available = 3;
-}
-```
-
-**Error:**
-```
-product.proto:5:3: Field "2" with name "price" on message "Product" changed type from "int32" to "string". (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Incompatible type changes:**
-
-```proto
-// Before
-message Order {
-  string id = 1;
-  int64 timestamp = 2;
-  repeated string tags = 3;
-  OrderStatus status = 4;
-}
-
-// After - ALL BREAKING CHANGES!
-message Order {
-  int32 id = 1;           // string -> int32: BREAKING
-  string timestamp = 2;   // int64 -> string: BREAKING  
-  string tags = 3;        // repeated -> singular: BREAKING
-  int32 status = 4;       // enum -> int32: BREAKING
-}
-```
-
-### Good
-
-**Instead of changing type, add a new field:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message Product {
-  string name = 1;
-  int32 price = 2 [deprecated = true]; // [!code focus]
-  bool available = 3;
-  string price_formatted = 4; // [!code focus] // New field for string price
-}
-```
-
-**Or create a new message version:**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus] // New package version
-
-message Product {
-  string name = 1;
-  string price = 2; // [!code focus] // Now string in v2
-  bool available = 3;
-}
-```
-
-## Impact
-
-- **Wire Format:** Binary data cannot be deserialized correctly between versions
-- **Generated Code:** Field types change, breaking client compilation
-- **Runtime Errors:** Type mismatches cause parsing failures
-- **Data Corruption:** Incorrect interpretation of binary data
-
-## Common Type Change Issues
-
-### Numeric Types
-```proto
-// BREAKING: Different wire representations
-int32 -> int64   // Different encoding
-int32 -> uint32  // Different sign interpretation
-int32 -> string  // Completely different format
-```
-
-### Collection Types
-```proto
-// BREAKING: Structure changes
-string -> repeated string     // Singular to collection
-repeated int32 -> map<string, int32>  // Array to map
-```
-
-### Message Types
-```proto
-// BREAKING: Different message structure
-UserInfo -> UserProfile  // Different message types
-string -> UserInfo       // Scalar to message
-```
-
-## Migration Strategy
-
-1. **Add new field** with correct type:
-   ```proto
-   int32 old_price = 2 [deprecated = true];
-   string new_price = 5;  // New field
-   ```
-
-2. **Dual-write period** - populate both fields during transition
-
-3. **Update clients** to use new field
-
-4. **Remove old field** in next major version:
-   ```proto
-   reserved 2, "old_price";
-   string new_price = 5;
-   ```
-
-## Safe Type Changes (Wire Compatible)
-
-Note: EasyP currently treats ALL type changes as breaking. However, some changes are technically wire-compatible:
-
-- `int32` ↔ `uint32` (same encoding)
-- `int64` ↔ `uint64` (same encoding)  
-- `string` → `bytes` (if UTF-8 valid)
-
-These may be supported in future EasyP versions with different strictness levels.
\ No newline at end of file
diff --git a/docs/dist/docs/guide/cli/breaking-changes/rules/import-no-delete.md b/docs/dist/docs/guide/cli/breaking-changes/rules/import-no-delete.md
deleted file mode 100644
index b2f65259..00000000
--- a/docs/dist/docs/guide/cli/breaking-changes/rules/import-no-delete.md
+++ /dev/null
@@ -1,411 +0,0 @@
-# IMPORT_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no import statements are deleted from proto files. Deleting an import breaks both wire format compatibility and generated code, as the imported types may be referenced in the current file and removing the import makes those types unavailable.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-import "google/protobuf/timestamp.proto";
-import "google/protobuf/duration.proto";
-import "common/user.proto";
-import "common/address.proto";
-
-message Order {
-  string id = 1;
-  google.protobuf.Timestamp created_at = 2;
-  google.protobuf.Duration processing_time = 3;
-  common.User customer = 4;
-  common.Address shipping_address = 5;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-import "google/protobuf/timestamp.proto";
-// import "google/protobuf/duration.proto";  // [!code --] Deleted import - BREAKING!
-// import "common/user.proto";               // [!code --] Deleted import - BREAKING!
-// import "common/address.proto";            // [!code --] Deleted import - BREAKING!
-
-message Order {
-  string id = 1;
-  google.protobuf.Timestamp created_at = 2;
-  google.protobuf.Duration processing_time = 3;  // ERROR: Duration not available
-  common.User customer = 4;                      // ERROR: User not available
-  common.Address shipping_address = 5;           // ERROR: Address not available
-}
-```
-
-**Error:**
-```
-order.proto:5:1: Previously import "google/protobuf/duration.proto" was deleted. (BREAKING_CHECK)
-order.proto:6:1: Previously import "common/user.proto" was deleted. (BREAKING_CHECK)
-order.proto:7:1: Previously import "common/address.proto" was deleted. (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Service definition breaks with deleted imports:**
-
-```proto
-// Before
-import "google/api/annotations.proto";
-import "google/protobuf/empty.proto";
-import "common/auth.proto";
-
-service OrderService {
-  rpc GetOrder(GetOrderRequest) returns (Order) {
-    option (google.api.http) = {
-      get: "/v1/orders/{id}"
-    };
-  }
-  
-  rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty);
-}
-
-// After - BREAKING CHANGES!
-// import "google/api/annotations.proto";    // BREAKING: deleted
-// import "google/protobuf/empty.proto";     // BREAKING: deleted  
-// import "common/auth.proto";               // BREAKING: deleted
-
-service OrderService {
-  rpc GetOrder(GetOrderRequest) returns (Order) {
-    option (google.api.http) = {  // ERROR: annotations not available
-      get: "/v1/orders/{id}"
-    };
-  }
-  
-  rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty);  // ERROR: types not available
-}
-```
-
-### Good
-
-**Instead of deleting, keep unused imports:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-import "google/protobuf/timestamp.proto";
-import "google/protobuf/duration.proto";  // [!code focus] // Keep even if unused
-import "common/user.proto";               // [!code focus] // Keep even if unused
-import "common/address.proto";            // [!code focus] // Keep even if unused
-
-message Order {
-  string id = 1;
-  google.protobuf.Timestamp created_at = 2;
-  // Removed fields that used Duration, User, Address but kept imports
-}
-```
-
-**Or replace with equivalent types while keeping imports:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-import "google/protobuf/timestamp.proto";
-import "google/protobuf/duration.proto";  // [!code focus] // Keep original import
-import "common/user.proto";               // [!code focus] // Keep original import
-import "common/address.proto";            // [!code focus] // Keep original import
-import "common/v2/user.proto";            // [!code focus] // Add new import
-
-message Order {
-  string id = 1;
-  google.protobuf.Timestamp created_at = 2;
-  google.protobuf.Duration processing_time = 3 [deprecated = true]; // [!code focus] // Keep old field
-  common.User customer = 4 [deprecated = true];                    // [!code focus] // Keep old field
-  common.Address shipping_address = 5 [deprecated = true];         // [!code focus] // Keep old field
-  
-  int32 processing_seconds = 6;             // [!code focus] // New field instead of Duration
-  common.v2.UserProfile customer_v2 = 7;    // [!code focus] // New field with updated type
-  string shipping_address_text = 8;         // [!code focus] // New field with simpler type
-}
-```
-
-## Impact
-
-- **Generated Code:** Imported types become unavailable, breaking compilation
-- **Wire Format:** Messages using imported types cannot be deserialized
-- **Field References:** Any field using imported types becomes invalid
-- **Service Definitions:** RPC methods using imported types break
-- **Options Usage:** Custom options from imports become unavailable
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-order := &myapi.Order{
-    Id:        "order123",
-    CreatedAt: timestamppb.New(time.Now()),              // Uses google.protobuf.Timestamp
-    Customer: &common.User{                              // ERROR after import deletion
-        Id:   "user456",
-        Name: "John Doe",
-    },
-    ShippingAddress: &common.Address{                    // ERROR after import deletion
-        Street: "123 Main St",
-        City:   "New York",
-    },
-}
-
-// Generated code compilation fails:
-// undefined: common.User
-// undefined: common.Address
-```
-
-**Server implementation breaks:**
-```go
-// Before - server uses imported types
-func (s *server) CreateOrder(ctx context.Context, req *CreateOrderRequest) (*Order, error) {
-    return &Order{
-        Id:        generateOrderId(),
-        CreatedAt: timestamppb.New(time.Now()),
-        Customer: &common.User{                          // ERROR after import deletion
-            Id:   req.CustomerId,
-            Name: req.CustomerName,
-        },
-        ShippingAddress: &common.Address{                // ERROR after import deletion
-            Street: req.ShippingStreet,
-            City:   req.ShippingCity,
-        },
-    }, nil
-}
-```
-
-**Proto compilation breaks:**
-```bash
-# After deleting imports
-$ protoc --go_out=. order.proto
-order.proto:8:3: "common.User" is not defined.
-order.proto:9:3: "common.Address" is not defined.
-order.proto:10:3: "google.protobuf.Duration" is not defined.
-```
-
-## Migration Strategy
-
-1. **Keep imports even when unused:**
-   ```proto
-   // Always keep existing imports
-   import "common/user.proto";  // Keep even if no fields use it
-   ```
-
-2. **Add new imports alongside old ones:**
-   ```proto
-   import "common/user.proto";     // Keep old import
-   import "common/v2/user.proto";  // Add new import
-   ```
-
-3. **Deprecate fields using old imports gradually:**
-   ```proto
-   message Order {
-     common.User customer = 4 [deprecated = true];
-     common.v2.UserProfile customer_v2 = 5;  // New field
-   }
-   ```
-
-4. **Update server code** to handle both old and new fields:
-   ```go
-   func convertToOrder(req *CreateOrderRequest) *Order {
-       order := &Order{Id: generateId()}
-       
-       // Handle new field first
-       if req.CustomerProfileV2 != nil {
-           order.CustomerV2 = req.CustomerProfileV2
-           return order
-       }
-       
-       // Fall back to old field (still works due to kept import)
-       if req.CustomerProfile != nil {
-           order.Customer = req.CustomerProfile
-       }
-       
-       return order
-   }
-   ```
-
-5. **Only remove imports in major version updates** after all fields are migrated
-
-## Common Scenarios
-
-### Replacing Dependencies
-```proto
-// Instead of deleting old import immediately
-// import "old/user.proto";  // Don't delete!
-
-// Keep both during transition
-import "old/user.proto";    // Keep for backward compatibility
-import "new/user.proto";    // Add new dependency
-
-message Order {
-  old.User customer = 4 [deprecated = true];
-  new.UserProfile customer_v2 = 5;
-}
-```
-
-### Removing Unused Features
-```proto
-// Even if removing features, keep imports
-import "feature/analytics.proto";  // Keep even if analytics removed
-
-message Order {
-  string id = 1;
-  // feature.AnalyticsData analytics = 2;  // Field removed but import kept
-}
-```
-
-### Protobuf Version Migration
-```proto
-// When migrating protobuf versions, keep old imports
-import "google/protobuf/timestamp.proto";  // Keep standard imports
-import "google/protobuf/duration.proto";   // Even if switching to alternatives
-
-// Prefer keeping both old and new approaches
-message Event {
-  google.protobuf.Timestamp timestamp = 1;    // Keep old
-  int64 timestamp_millis = 2;                 // Add alternative
-}
-```
-
-### Simplifying Dependencies
-```proto
-// Instead of removing complex type imports
-// import "complex/config.proto";  // Don't delete!
-
-// Keep complex import, add simple alternative
-import "complex/config.proto";
-
-message Settings {
-  complex.ConfigData config = 1 [deprecated = true];  // Keep complex option
-  string config_json = 2;                            // Add simple option
-}
-```
-
-## Import Categories and Impact
-
-### Standard Google Imports
-```proto
-// Critical - used throughout protobuf ecosystem
-import "google/protobuf/timestamp.proto";    // Never delete
-import "google/protobuf/duration.proto";     // Never delete
-import "google/protobuf/empty.proto";        // Never delete
-import "google/api/annotations.proto";       // Never delete if using gRPC-Gateway
-```
-
-### Common Library Imports
-```proto
-// Shared types across services
-import "common/user.proto";        // High impact - affects all user references
-import "common/address.proto";     // High impact - affects all address fields
-import "common/money.proto";       // High impact - affects all monetary fields
-```
-
-### Feature-Specific Imports
-```proto
-// Feature modules that might be deprecated
-import "features/analytics.proto";  // Medium impact - specific feature
-import "features/logging.proto";    // Medium impact - specific feature
-import "internal/debug.proto";      // Low impact - internal use
-```
-
-## Wire Format Considerations
-
-### Import Deletion vs Field Usage
-```proto
-// Import deletion breaks even if types aren't directly used as fields
-import "common/enums.proto";
-
-message Order {
-  // Even if no fields directly use common.enums types,
-  // nested messages or oneof fields might use them
-  oneof payment {
-    CreditCardPayment card = 1;  // This might internally use common.enums
-  }
-}
-```
-
-### Transitive Dependencies
-```proto
-// Deleting an import can break transitive dependencies
-import "user.proto";  // Don't delete even if not directly used
-
-message Order {
-  PaymentInfo payment = 1;  // PaymentInfo might internally reference user.proto types
-}
-```
-
-### JSON Serialization Impact
-```proto
-// Imports affect JSON field names and validation
-import "google/protobuf/field_mask.proto";
-
-message UpdateRequest {
-  google.protobuf.FieldMask update_mask = 1;  // JSON serialization depends on import
-}
-```
-
-## Prevention Strategies
-
-### Import Auditing
-```bash
-# Check which imports are actually used
-$ grep -r "google.protobuf.Duration" *.proto
-$ grep -r "common.User" *.proto
-
-# But still keep imports even if grep shows no usage!
-```
-
-### Linting Configuration
-```yaml
-# Configure linters to allow unused imports
-lint:
-  ignore:
-    - IMPORT_UNUSED  # Allow unused imports for backward compatibility
-```
-
-### Documentation
-```proto
-// Document why imports are kept
-import "legacy/types.proto";  // Keep for backward compatibility with v1 clients
-import "common/user.proto";   // Required for existing serialized data
-```
-
-## Import vs Field Deletion
-
-### Different Breaking Change Types
-```proto
-// Import deletion (this rule)
-// import "user.proto";  // BREAKING: import deleted
-
-// vs Field deletion (different rule)
-message Order {
-  string id = 1;
-  // User customer = 2;  // BREAKING: field deleted (different from import)
-}
-```
-
-### Compound Breaking Changes
-```proto
-// Worst case: both import AND field deleted
-// import "user.proto";  // BREAKING: import deleted
-message Order {
-  string id = 1;
-  // User customer = 2;  // BREAKING: field also deleted
-}
-// This creates multiple breaking change violations
-```
diff --git a/docs/dist/docs/guide/cli/breaking-changes/rules/message-no-delete.md b/docs/dist/docs/guide/cli/breaking-changes/rules/message-no-delete.md
deleted file mode 100644
index 5fe69c70..00000000
--- a/docs/dist/docs/guide/cli/breaking-changes/rules/message-no-delete.md
+++ /dev/null
@@ -1,250 +0,0 @@
-# MESSAGE_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no messages are deleted from proto files. Deleting a message breaks both wire format compatibility and generated code, as existing data may reference the deleted message and client code depends on the generated types.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  Address address = 3;
-}
-
-message Address { // [!code --]
-  string street = 1; // [!code --]
-  string city = 2; // [!code --]
-  string country = 3; // [!code --]
-} // [!code --]
-
-message Order {
-  string id = 1;
-  User user = 2;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  Address address = 3;  // ERROR: Address message no longer exists!
-}
-
-// Address message was deleted - BREAKING CHANGE!
-
-message Order {
-  string id = 1;
-  User user = 2;
-}
-```
-
-**Error:**
-```
-user.proto:8:1: Previously present message "Address" was deleted from file. (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Nested message deletion:**
-
-```proto
-// Before
-message User {
-  string name = 1;
-  Profile profile = 2;
-  
-  message Profile { // [!code --]
-    string bio = 1; // [!code --]
-    string avatar_url = 2; // [!code --]
-  } // [!code --]
-}
-
-// After - BREAKING CHANGE!
-message User {
-  string name = 1;
-  Profile profile = 2;  // ERROR: Profile message deleted
-  
-  // Profile nested message was deleted
-}
-```
-
-### Good
-
-**Instead of deleting, deprecate the message:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  Address address = 3 [deprecated = true]; // [!code focus]
-}
-
-message Address {
-  option deprecated = true; // [!code focus]
-  string street = 1;
-  string city = 2;
-  string country = 3;
-}
-
-message Order {
-  string id = 1;
-  User user = 2;
-}
-```
-
-**Or replace with new message version:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  Address address = 3 [deprecated = true]; // [!code focus] // Old field
-  AddressV2 address_v2 = 4; // [!code focus] // New field with better structure
-}
-
-message Address {
-  option deprecated = true; // [!code focus]
-  string street = 1;
-  string city = 2;
-  string country = 3;
-}
-
-message AddressV2 { // [!code focus]
-  string street_address = 1; // [!code focus]
-  string city = 2; // [!code focus]
-  string state = 3; // [!code focus]
-  string postal_code = 4; // [!code focus]
-  string country = 5; // [!code focus]
-} // [!code focus]
-
-message Order {
-  string id = 1;
-  User user = 2;
-}
-```
-
-## Impact
-
-- **Wire Format:** Existing data with the deleted message cannot be deserialized
-- **Generated Code:** Message classes/structs are removed, breaking client compilation
-- **Field References:** Fields using the deleted message type become invalid
-- **Nested Dependencies:** All messages referencing the deleted message break
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-user := &myapi.User{
-    Name:  "John Doe",
-    Email: "john@example.com",
-    Address: &myapi.Address{  // ERROR after deletion
-        Street:  "123 Main St",
-        City:    "New York",
-        Country: "USA",
-    },
-}
-
-// Generated code compilation fails:
-// undefined: myapi.Address
-```
-
-**Existing data becomes unreadable:**
-```json
-// Serialized data before deletion
-{
-  "name": "John Doe",
-  "email": "john@example.com", 
-  "address": {
-    "street": "123 Main St",
-    "city": "New York",
-    "country": "USA"
-  }
-}
-
-// After Address deletion - deserialization fails
-// Parser doesn't know how to handle "address" field
-```
-
-## Migration Strategy
-
-1. **Deprecate the message first:**
-   ```proto
-   message OldMessage {
-     option deprecated = true;
-     // ... fields
-   }
-   ```
-
-2. **Stop using in new fields** and deprecate existing fields that use it:
-   ```proto
-   OldMessage old_data = 5 [deprecated = true];
-   ```
-
-3. **Create replacement** with new structure if needed:
-   ```proto
-   NewMessage new_data = 6;  // Better design
-   ```
-
-4. **Remove after migration period** in a new major version
-
-## Common Scenarios
-
-### Refactoring Message Structure
-```proto
-// Instead of deleting UserInfo and creating UserProfile
-message UserInfo {
-  option deprecated = true;  // Deprecate old
-  string name = 1;
-  string email = 2;
-}
-
-message UserProfile {  // Create new alongside
-  string full_name = 1;
-  string email_address = 2;
-  string phone = 3;
-  // Better field organization
-}
-```
-
-### Removing Unused Messages
-```proto
-// Even if message seems unused, it might be in serialized data
-message OldConfig {
-  option deprecated = true;  // Always deprecate first
-  // Don't delete immediately - data might exist
-}
-```
-
-### Version Migration
-```proto
-// Clean approach - new package version
-package myapi.v2;
-
-message User {
-  // Redesigned message structure
-  // No deprecated Address references
-}
-```
diff --git a/docs/dist/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete.md b/docs/dist/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete.md
deleted file mode 100644
index 66718800..00000000
--- a/docs/dist/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete.md
+++ /dev/null
@@ -1,413 +0,0 @@
-# ONEOF_FIELD_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no fields are deleted from oneOf groups. Deleting a field from a oneOf breaks both wire format compatibility and generated code, as existing data may use the deleted oneOf option and client code depends on the generated field types and accessor methods.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    string oauth_token = 4;
-    string certificate = 5;
-  }
-}
-
-message SearchQuery {
-  oneof filter {
-    string text = 1;
-    int32 user_id = 2;
-    string category = 3;
-    DateRange date_range = 4;
-  }
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    // string oauth_token = 4;  // [!code --] Deleted oneOf field - BREAKING!
-    // string certificate = 5;  // [!code --] Deleted oneOf field - BREAKING!
-  }
-}
-
-message SearchQuery {
-  oneof filter {
-    string text = 1;
-    int32 user_id = 2;
-    // string category = 3;     // [!code --] Deleted oneOf field - BREAKING!
-    // DateRange date_range = 4; // [!code --] Deleted oneOf field - BREAKING!
-  }
-}
-```
-
-**Error:**
-```
-login.proto:7:5: Previously present field "4" with name "oauth_token" on OneOf "credentials" was deleted. (BREAKING_CHECK)
-login.proto:8:5: Previously present field "5" with name "certificate" on OneOf "credentials" was deleted. (BREAKING_CHECK)
-search.proto:6:5: Previously present field "3" with name "category" on OneOf "filter" was deleted. (BREAKING_CHECK)
-search.proto:7:5: Previously present field "4" with name "date_range" on OneOf "filter" was deleted. (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Nested message oneOf field deletion:**
-
-```proto
-// Before
-message PaymentRequest {
-  string order_id = 1;
-  
-  oneof payment_method {
-    CreditCardPayment credit_card = 2;
-    BankTransferPayment bank_transfer = 3;
-    CryptoPayment crypto = 4;         // [!code --] 
-    GiftCardPayment gift_card = 5;    // [!code --]
-  }
-}
-
-// After - BREAKING CHANGES!
-message PaymentRequest {
-  string order_id = 1;
-  
-  oneof payment_method {
-    CreditCardPayment credit_card = 2;
-    BankTransferPayment bank_transfer = 3;
-    // CryptoPayment crypto = 4;      // BREAKING: deleted
-    // GiftCardPayment gift_card = 5; // BREAKING: deleted
-  }
-}
-```
-
-### Good
-
-**Instead of deleting, deprecate the oneOf fields:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    string oauth_token = 4 [deprecated = true]; // [!code focus]
-    string certificate = 5 [deprecated = true]; // [!code focus]
-  }
-}
-
-message SearchQuery {
-  oneof filter {
-    string text = 1;
-    int32 user_id = 2;
-    string category = 3 [deprecated = true]; // [!code focus]
-    DateRange date_range = 4 [deprecated = true]; // [!code focus]
-  }
-}
-```
-
-**Or add new oneOf fields while keeping old ones:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    string oauth_token = 4 [deprecated = true]; // [!code focus] // Keep old field
-    string certificate = 5 [deprecated = true]; // [!code focus] // Keep old field
-    
-    OAuthCredentials oauth_v2 = 6; // [!code focus] // New structured approach
-    CertificateCredentials cert_v2 = 7; // [!code focus] // New structured approach
-  }
-}
-```
-
-## Impact
-
-- **Wire Format:** Existing data with deleted oneOf fields cannot be deserialized properly
-- **Generated Code:** OneOf field accessor methods are removed, breaking client compilation
-- **Type Safety:** Generated oneOf wrapper types lose options, breaking switch statements
-- **Business Logic:** Client code handling specific oneOf cases breaks
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-loginReq := &myapi.LoginRequest{
-    Username: "user123",
-}
-
-// Set OAuth token (oneOf field)
-loginReq.Credentials = &myapi.LoginRequest_OauthToken{
-    OauthToken: "token123",  // ERROR after field deletion
-}
-
-// Switch on oneOf field types
-switch cred := loginReq.Credentials.(type) {
-case *myapi.LoginRequest_Password:
-    return authenticatePassword(cred.Password)
-case *myapi.LoginRequest_OauthToken:  // ERROR: undefined type after deletion
-    return authenticateOAuth(cred.OauthToken)
-case *myapi.LoginRequest_Certificate: // ERROR: undefined type after deletion
-    return authenticateCert(cred.Certificate)
-default:
-    return errors.New("unsupported credential type")
-}
-
-// Generated code compilation fails:
-// undefined: myapi.LoginRequest_OauthToken
-// undefined: myapi.LoginRequest_Certificate
-```
-
-**Server handling breaks:**
-```go
-// Before - server handles all oneOf field types
-func authenticateUser(req *LoginRequest) error {
-    switch cred := req.Credentials.(type) {
-    case *LoginRequest_Password:
-        return validatePassword(cred.Password)
-    case *LoginRequest_ApiKey:
-        return validateApiKey(cred.ApiKey)
-    case *LoginRequest_OauthToken:    // ERROR after deletion
-        return validateOAuth(cred.OauthToken)
-    case *LoginRequest_Certificate:   // ERROR after deletion
-        return validateCertificate(cred.Certificate)
-    default:
-        return errors.New("no valid credentials provided")
-    }
-}
-```
-
-**Existing data becomes unreadable:**
-```json
-// Serialized data before deletion
-{
-  "username": "user123",
-  "oauth_token": "abc123xyz"
-}
-
-// After oneOf field deletion
-// Data deserializes but oauth_token is lost or causes parsing errors
-// User authentication fails due to missing credential data
-```
-
-## Migration Strategy
-
-1. **Deprecate oneOf fields first:**
-   ```proto
-   oneof credentials {
-     string password = 2;
-     string oauth_token = 4 [deprecated = true];
-   }
-   ```
-
-2. **Add new fields** if replacement is needed:
-   ```proto
-   oneof credentials {
-     string password = 2;
-     string oauth_token = 4 [deprecated = true];
-     OAuthCredentials oauth_v2 = 6;  // New structured field
-   }
-   ```
-
-3. **Update server code** to handle both old and new fields:
-   ```go
-   func authenticateUser(req *LoginRequest) error {
-       switch cred := req.Credentials.(type) {
-       case *LoginRequest_OauthV2:
-           // Handle new structured OAuth
-           return validateOAuthV2(cred.OauthV2)
-       case *LoginRequest_OauthToken:
-           // Handle legacy OAuth (deprecated)
-           log.Warn("Using deprecated oauth_token field")
-           return validateOAuthLegacy(cred.OauthToken)
-       // ... other cases
-       }
-   }
-   ```
-
-4. **Migrate clients** to use new fields:
-   ```go
-   // Update client to use new structured field
-   loginReq.Credentials = &LoginRequest_OauthV2{
-       OauthV2: &OAuthCredentials{
-           Token:        "token123",
-           RefreshToken: "refresh456",
-           ExpiresAt:    timestamp,
-       },
-   }
-   ```
-
-5. **Reserve field numbers** after removal in next major version:
-   ```proto
-   oneof credentials {
-     reserved 4, 5;
-     reserved "oauth_token", "certificate";
-     
-     string password = 2;
-     string api_key = 3;
-     OAuthCredentials oauth_v2 = 6;
-   }
-   ```
-
-## Common Scenarios
-
-### Removing Unsupported Authentication Methods
-```proto
-// Instead of deleting discontinued auth methods
-message AuthRequest {
-  oneof method {
-    PasswordAuth password = 1;
-    ApiKeyAuth api_key = 2;
-    // LdapAuth ldap = 3;  // Don't delete even if LDAP discontinued!
-    
-    // Better approach:
-    LdapAuth ldap = 3 [deprecated = true];  // Mark as deprecated
-    OidcAuth oidc = 4;  // Add new method
-  }
-}
-```
-
-### Simplifying OneOf Options
-```proto
-// Instead of removing complex options
-message SearchRequest {
-  oneof query_type {
-    string simple_text = 1;
-    // ComplexQuery complex = 2;  // Don't delete complex queries!
-    
-    // Better approach:
-    ComplexQuery complex = 2 [deprecated = true];
-    AdvancedQuery advanced = 3;  // Replacement with better design
-  }
-}
-```
-
-### Business Logic Changes
-```proto
-// Instead of removing payment methods
-message PaymentRequest {
-  oneof payment_method {
-    CreditCard credit_card = 1;
-    // Check check = 2;  // Don't delete even if checks discontinued!
-    BankTransfer bank_transfer = 3;
-    
-    // Better approach:
-    Check check = 2 [deprecated = true];  // Keep for existing data
-    DigitalWallet digital_wallet = 4;     // Add new methods
-  }
-}
-```
-
-## OneOf Field Deletion vs Other Deletions
-
-### Different from Regular Field Deletion
-```proto
-// Regular field deletion (also breaking)
-message User {
-  string name = 1;
-  // string email = 2;  // BREAKING: regular field deletion
-}
-
-// OneOf field deletion (breaks oneOf semantics)
-message User {
-  oneof contact {
-    string email = 1;
-    // string phone = 2;  // BREAKING: oneOf field deletion
-  }
-}
-```
-
-### Impact on Generated Code
-```go
-// Regular field - simple accessor removed
-// user.GetEmail() // Method removed
-
-// OneOf field - wrapper type removed  
-// *LoginRequest_OauthToken  // Entire type removed
-// switch statement cases break completely
-```
-
-### Wire Format Considerations
-```proto
-// OneOf fields share the same "choice" semantics
-// Removing a choice breaks clients that made that choice
-
-message Request {
-  oneof data {
-    string text = 1;      // Choice A
-    bytes binary = 2;     // Choice B - if removed, clients using B break
-    JsonData json = 3;    // Choice C
-  }
-}
-```
-
-## Validation and Error Handling
-
-### Before Deletion (Type Safe)
-```go
-func validateRequest(req *Request) error {
-    switch data := req.Data.(type) {
-    case *Request_Text:
-        return validateText(data.Text)
-    case *Request_Binary:      // Type exists
-        return validateBinary(data.Binary)
-    case *Request_Json:
-        return validateJson(data.Json)
-    case nil:
-        return errors.New("no data provided")
-    default:
-        return errors.New("unknown data type")
-    }
-}
-```
-
-### After Deletion (Broken)
-```go
-func validateRequest(req *Request) error {
-    switch data := req.Data.(type) {
-    case *Request_Text:
-        return validateText(data.Text)
-    // case *Request_Binary:   // ERROR: type no longer exists
-    //     return validateBinary(data.Binary)
-    case *Request_Json:
-        return validateJson(data.Json)
-    case nil:
-        return errors.New("no data provided")
-    default:
-        // Existing binary data falls here now!
-        return errors.New("unknown data type")
-    }
-}
-```
diff --git a/docs/dist/docs/guide/cli/breaking-changes/rules/oneof-field-same-type.md b/docs/dist/docs/guide/cli/breaking-changes/rules/oneof-field-same-type.md
deleted file mode 100644
index de940ba4..00000000
--- a/docs/dist/docs/guide/cli/breaking-changes/rules/oneof-field-same-type.md
+++ /dev/null
@@ -1,415 +0,0 @@
-# ONEOF_FIELD_SAME_TYPE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that oneOf field types cannot be changed. Changing the type of a field within a oneOf breaks both wire format compatibility and generated code, as existing data contains the old type and client code expects specific field types in oneOf wrapper structures.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message SearchRequest {
-  string query = 1;
-  
-  oneof filter {
-    string category = 2;
-    int32 user_id = 3;
-    bool is_premium = 4;
-    DateRange date_range = 5;
-  }
-}
-
-message NotificationSettings {
-  oneof delivery {
-    string email = 1;
-    int64 phone_number = 2;
-    WebhookConfig webhook = 3;
-  }
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message SearchRequest {
-  string query = 1;
-  
-  oneof filter {
-    int32 category = 2;        // [!code --] Changed from string to int32 - BREAKING!
-    string user_id = 3;        // [!code --] Changed from int32 to string - BREAKING!
-    string is_premium = 4;     // [!code --] Changed from bool to string - BREAKING!
-    string date_range = 5;     // [!code --] Changed from DateRange to string - BREAKING!
-  }
-}
-
-message NotificationSettings {
-  oneof delivery {
-    EmailConfig email = 1;     // [!code --] Changed from string to EmailConfig - BREAKING!
-    string phone_number = 2;   // [!code --] Changed from int64 to string - BREAKING!
-    string webhook = 3;        // [!code --] Changed from WebhookConfig to string - BREAKING!
-  }
-}
-```
-
-**Error:**
-```
-search.proto:6:5: Field "2" with name "category" on OneOf "filter" changed type from "string" to "int32". (BREAKING_CHECK)
-search.proto:7:5: Field "3" with name "user_id" on OneOf "filter" changed type from "int32" to "string". (BREAKING_CHECK)
-search.proto:8:5: Field "4" with name "is_premium" on OneOf "filter" changed type from "bool" to "string". (BREAKING_CHECK)
-search.proto:9:5: Field "5" with name "date_range" on OneOf "filter" changed type from "DateRange" to "string". (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Complex type changes:**
-
-```proto
-// Before
-message PaymentRequest {
-  oneof payment_info {
-    CreditCardInfo credit_card = 1;
-    BankAccountInfo bank_account = 2;
-    string paypal_email = 3;
-    CryptoWalletInfo crypto = 4;
-  }
-}
-
-// After - ALL BREAKING CHANGES!
-message PaymentRequest {
-  oneof payment_info {
-    string credit_card = 1;           // BREAKING: CreditCardInfo -> string
-    PayPalInfo bank_account = 2;      // BREAKING: BankAccountInfo -> PayPalInfo  
-    PayPalInfo paypal_email = 3;      // BREAKING: string -> PayPalInfo
-    string crypto = 4;                // BREAKING: CryptoWalletInfo -> string
-  }
-}
-```
-
-### Good
-
-**Instead of changing type, add new oneOf field:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message SearchRequest {
-  string query = 1;
-  
-  oneof filter {
-    string category = 2 [deprecated = true];     // [!code focus] // Keep original type
-    int32 user_id = 3 [deprecated = true];       // [!code focus] // Keep original type
-    bool is_premium = 4 [deprecated = true];     // [!code focus] // Keep original type
-    DateRange date_range = 5 [deprecated = true]; // [!code focus] // Keep original type
-    
-    int32 category_id = 6;                       // [!code focus] // New field with desired type
-    string user_identifier = 7;                 // [!code focus] // New field with desired type
-    string premium_status = 8;                  // [!code focus] // New field with desired type
-    string date_filter = 9;                    // [!code focus] // New field with desired type
-  }
-}
-```
-
-**Or create a new oneOf group:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message SearchRequest {
-  string query = 1;
-  
-  oneof filter {
-    option deprecated = true;                   // [!code focus] // Deprecate old oneOf
-    string category = 2 [deprecated = true];    // [!code focus]
-    int32 user_id = 3 [deprecated = true];      // [!code focus]
-    bool is_premium = 4 [deprecated = true];    // [!code focus]
-    DateRange date_range = 5 [deprecated = true]; // [!code focus]
-  }
-  
-  oneof filter_v2 {                            // [!code focus] // New oneOf with correct types
-    int32 category_id = 6;                     // [!code focus]
-    string user_identifier = 7;               // [!code focus]
-    PremiumFilter premium_filter = 8;          // [!code focus]
-    TimeFilter time_filter = 9;               // [!code focus]
-  }                                           // [!code focus]
-}
-```
-
-## Impact
-
-- **Wire Format:** Binary data cannot be deserialized correctly between versions
-- **Generated Code:** OneOf wrapper types change, breaking client compilation  
-- **Type Safety:** Switch statements on oneOf types break with compilation errors
-- **Runtime Errors:** Type mismatches cause parsing failures for existing data
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-searchReq := &myapi.SearchRequest{
-    Query: "golang jobs",
-}
-
-// Set filter using oneOf (original types)
-searchReq.Filter = &myapi.SearchRequest_Category{
-    Category: "engineering",  // string type
-}
-
-// Handle filter types
-switch filter := searchReq.Filter.(type) {
-case *myapi.SearchRequest_Category:
-    return searchByCategory(filter.Category)  // string parameter
-case *myapi.SearchRequest_UserId:
-    return searchByUserId(filter.UserId)      // int32 parameter
-default:
-    return errors.New("unsupported filter")
-}
-
-// After type change - compilation fails
-searchReq.Filter = &myapi.SearchRequest_Category{
-    Category: "engineering",  // ERROR: expects int32, not string
-}
-
-// Switch statement breaks
-switch filter := searchReq.Filter.(type) {
-case *myapi.SearchRequest_Category:
-    return searchByCategory(filter.Category)  // ERROR: Category is now int32
-case *myapi.SearchRequest_UserId:   
-    return searchByUserId(filter.UserId)      // ERROR: UserId is now string
-}
-```
-
-**Server implementation breaks:**
-```go
-// Before - server expects original types
-func handleSearchFilter(req *SearchRequest) (*SearchResult, error) {
-    switch filter := req.Filter.(type) {
-    case *SearchRequest_Category:
-        categoryName := filter.Category  // string
-        return searchDatabase("category", categoryName), nil
-    case *SearchRequest_UserId:
-        userId := filter.UserId  // int32
-        return searchDatabase("user_id", strconv.Itoa(int(userId))), nil
-    default:
-        return nil, errors.New("no filter specified")
-    }
-}
-
-// After type change - runtime errors
-func handleSearchFilter(req *SearchRequest) (*SearchResult, error) {
-    switch filter := req.Filter.(type) {
-    case *SearchRequest_Category:
-        categoryId := filter.Category  // now int32, but code expects string
-        return searchDatabase("category", categoryId), nil  // ERROR: type mismatch
-    case *SearchRequest_UserId:
-        userIdStr := filter.UserId  // now string, but conversion logic expects int32
-        userId, _ := strconv.Atoi(userIdStr)  // Works but semantics changed
-        return searchDatabase("user_id", strconv.Itoa(userId)), nil
-    }
-}
-```
-
-**Existing data corruption:**
-```json
-// Serialized data before type change
-{
-  "query": "golang jobs",
-  "category": "engineering"
-}
-
-// After changing category from string to int32
-// Data cannot be deserialized - "engineering" is not a valid int32
-// Results in parsing errors or data loss
-```
-
-## Migration Strategy
-
-1. **Add new oneOf fields** with correct types:
-   ```proto
-   oneof filter {
-     string category = 2 [deprecated = true];
-     int32 category_id = 6;  // New field with desired type
-   }
-   ```
-
-2. **Update server code** to handle both old and new fields:
-   ```go
-   func handleSearchFilter(req *SearchRequest) error {
-       switch filter := req.Filter.(type) {
-       case *SearchRequest_CategoryId:
-           // Handle new int32 field
-           return searchByCategoryId(filter.CategoryId)
-       case *SearchRequest_Category:
-           // Handle legacy string field (deprecated)
-           log.Warn("Using deprecated string category field")
-           categoryId := convertCategoryNameToId(filter.Category)
-           return searchByCategoryId(categoryId)
-       }
-   }
-   ```
-
-3. **Migrate clients** to use new fields:
-   ```go
-   // Update client to use new typed field
-   searchReq.Filter = &SearchRequest_CategoryId{
-       CategoryId: 123,  // int32 instead of string
-   }
-   ```
-
-4. **Provide migration utilities** for data conversion:
-   ```go
-   func MigrateSearchRequest(old *SearchRequestV1) *SearchRequestV2 {
-       new := &SearchRequestV2{Query: old.Query}
-       
-       switch filter := old.Filter.(type) {
-       case *SearchRequestV1_Category:
-           // Convert string category to int32 ID
-           categoryId := lookupCategoryId(filter.Category)
-           new.Filter = &SearchRequestV2_CategoryId{CategoryId: categoryId}
-       }
-       
-       return new
-   }
-   ```
-
-5. **Remove old fields** in next major version:
-   ```proto
-   oneof filter {
-     reserved 2, "category";
-     int32 category_id = 6;
-   }
-   ```
-
-## Common Scenarios
-
-### Improving Type Safety
-```proto
-// Instead of changing loose string types to structured types
-message ConfigRequest {
-  oneof setting {
-    // string database_url = 1;  // Don't change type directly!
-    
-    // Add new structured field instead
-    string database_url = 1 [deprecated = true];
-    DatabaseConfig database_config = 5;  // New structured field
-  }
-}
-```
-
-### Standardizing Field Types  
-```proto
-// Instead of converting between numeric types
-message FilterRequest {
-  oneof criteria {
-    // int32 timestamp = 1;  // Don't change to int64 directly!
-    
-    // Add new field with correct type
-    int32 timestamp = 1 [deprecated = true];
-    int64 timestamp_millis = 5;  // New field with proper precision
-  }
-}
-```
-
-### Message Structure Changes
-```proto
-// Instead of flattening/expanding message types
-message PaymentRequest {
-  oneof payment {
-    // string card_number = 1;  // Don't change to structured type!
-    
-    // Provide both options during transition
-    string card_number = 1 [deprecated = true];
-    CreditCardDetails card_details = 5;  // New structured approach
-  }
-}
-```
-
-## Type Change Compatibility Matrix
-
-### Never Compatible (Always Breaking)
-| From Type | To Type | Result |
-|-----------|---------|---------|
-| `string` | `int32/int64` | ❌ BREAKING |
-| `int32` | `string` | ❌ BREAKING |  
-| `bool` | `string` | ❌ BREAKING |
-| `message` | `string` | ❌ BREAKING |
-| `string` | `message` | ❌ BREAKING |
-| `enum` | `int32` | ❌ BREAKING |
-
-### Generated Code Impact
-```go
-// String to int32 change breaks wrapper types
-// Before:
-type SearchRequest_Category struct {
-    Category string
-}
-
-// After:  
-type SearchRequest_Category struct {
-    Category int32  // Different type - compilation fails
-}
-
-// All client code using SearchRequest_Category breaks
-```
-
-### Wire Format Considerations
-```proto
-// OneOf fields in wire format are identified by field number
-// Type changes break deserialization even if field number stays same
-
-message Request {
-  oneof data {
-    string text = 1;    // Wire tag: 1, type: string
-    // int32 text = 1;   // Same wire tag, different type - BREAKING!
-  }
-}
-```
-
-## Validation and Error Handling
-
-### Type-Safe Validation (Before Change)
-```go
-func validateSearchFilter(req *SearchRequest) error {
-    switch filter := req.Filter.(type) {
-    case *SearchRequest_Category:
-        if filter.Category == "" {  // String validation
-            return errors.New("category cannot be empty")
-        }
-    case *SearchRequest_UserId:
-        if filter.UserId <= 0 {  // Integer validation
-            return errors.New("user_id must be positive")
-        }
-    }
-    return nil
-}
-```
-
-### Broken Validation (After Type Change)
-```go
-func validateSearchFilter(req *SearchRequest) error {
-    switch filter := req.Filter.(type) {
-    case *SearchRequest_Category:
-        if filter.Category <= 0 {  // ERROR: Category is now int32, validation logic wrong
-            return errors.New("category must be positive")
-        }
-    case *SearchRequest_UserId:
-        if filter.UserId == "" {  // ERROR: UserId is now string, validation logic wrong  
-            return errors.New("user_id cannot be empty")
-        }
-    }
-    return nil
-}
-```
diff --git a/docs/dist/docs/guide/cli/breaking-changes/rules/oneof-no-delete.md b/docs/dist/docs/guide/cli/breaking-changes/rules/oneof-no-delete.md
deleted file mode 100644
index eda1eb01..00000000
--- a/docs/dist/docs/guide/cli/breaking-changes/rules/oneof-no-delete.md
+++ /dev/null
@@ -1,414 +0,0 @@
-# ONEOF_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no oneOf fields are deleted from messages. Deleting a oneOf breaks both wire format compatibility and generated code, as existing data may use the oneOf structure and client code depends on the generated oneOf types and accessor methods.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    string oauth_token = 4;
-  }
-}
-
-message PaymentMethod { // [!code --]
-  oneof method { // [!code --]
-    CreditCard credit_card = 1; // [!code --]
-    BankAccount bank_account = 2; // [!code --]
-    PayPal paypal = 3; // [!code --]
-  } // [!code --]
-} // [!code --]
-
-message Order {
-  string id = 1;
-  PaymentMethod payment = 2;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  // credentials oneof was deleted - BREAKING CHANGE!
-  string password = 2;     // Now regular fields
-  string api_key = 3;      // Lost exclusive semantics
-  string oauth_token = 4;
-}
-
-message PaymentMethod {
-  // method oneof was deleted - BREAKING CHANGE!
-  CreditCard credit_card = 1;  // Now all can be set simultaneously
-  BankAccount bank_account = 2;
-  PayPal paypal = 3;
-}
-
-message Order {
-  string id = 1;
-  PaymentMethod payment = 2;
-}
-```
-
-**Error:**
-```
-login.proto:5:3: Previously present oneof "credentials" was deleted. (BREAKING_CHECK)
-payment.proto:2:3: Previously present oneof "method" was deleted. (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Nested oneOf deletion:**
-
-```proto
-// Before
-message UserProfile {
-  string name = 1;
-  
-  message ContactInfo {
-    oneof contact_method { // [!code --]
-      string email = 1; // [!code --]
-      string phone = 2; // [!code --]
-      string slack_id = 3; // [!code --]
-    } // [!code --]
-  }
-  
-  ContactInfo contact = 2;
-}
-
-// After - BREAKING CHANGE!
-message UserProfile {
-  string name = 1;
-  
-  message ContactInfo {
-    // contact_method oneof was deleted
-    string email = 1;    // No longer mutually exclusive
-    string phone = 2;    // Can set all fields now
-    string slack_id = 3;
-  }
-  
-  ContactInfo contact = 2;
-}
-```
-
-### Good
-
-**Instead of deleting, deprecate the oneOf:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    option deprecated = true; // [!code focus]
-    string password = 2 [deprecated = true]; // [!code focus]
-    string api_key = 3 [deprecated = true]; // [!code focus]
-    string oauth_token = 4 [deprecated = true]; // [!code focus]
-  }
-}
-
-message PaymentMethod {
-  oneof method {
-    option deprecated = true; // [!code focus]
-    CreditCard credit_card = 1 [deprecated = true]; // [!code focus]
-    BankAccount bank_account = 2 [deprecated = true]; // [!code focus]
-    PayPal paypal = 3 [deprecated = true]; // [!code focus]
-  }
-}
-```
-
-**Or replace with new structure:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    option deprecated = true; // [!code focus] // Old oneOf
-    string password = 2 [deprecated = true]; // [!code focus]
-    string api_key = 3 [deprecated = true]; // [!code focus]
-    string oauth_token = 4 [deprecated = true]; // [!code focus]
-  }
-  
-  oneof auth_method { // [!code focus] // New oneOf with better design
-    PasswordAuth password_auth = 5; // [!code focus]
-    ApiKeyAuth api_auth = 6; // [!code focus]
-    OAuthAuth oauth_auth = 7; // [!code focus]
-  } // [!code focus]
-}
-```
-
-## Impact
-
-- **Wire Format:** OneOf semantics are lost - fields are no longer mutually exclusive
-- **Generated Code:** OneOf accessor methods are removed, breaking client compilation
-- **Business Logic:** Mutual exclusivity constraints are violated
-- **Validation:** Client code expecting only one field to be set may break
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - oneOf provides mutual exclusivity
-loginReq := &myapi.LoginRequest{
-    Username: "user123",
-}
-
-// Set one of the credential options (oneOf semantics)
-loginReq.Credentials = &myapi.LoginRequest_Password{
-    Password: "secret123",
-}
-
-// Check which credential type is set
-switch cred := loginReq.Credentials.(type) {
-case *myapi.LoginRequest_Password:  // ERROR after oneOf deletion
-    return authenticatePassword(cred.Password)
-case *myapi.LoginRequest_ApiKey:    // ERROR after oneOf deletion  
-    return authenticateApiKey(cred.ApiKey)
-default:
-    return errors.New("no credentials provided")
-}
-
-// Generated code compilation fails:
-// undefined: myapi.LoginRequest_Password
-// undefined field: loginReq.Credentials
-```
-
-**Server validation breaks:**
-```go
-// Before - server validates oneOf semantics
-func validateLoginRequest(req *LoginRequest) error {
-    if req.Credentials == nil {
-        return errors.New("credentials required")
-    }
-    
-    // OneOf ensures only one credential type is set
-    switch req.Credentials.(type) {
-    case *LoginRequest_Password:
-        return validatePassword(req.GetPassword())
-    case *LoginRequest_ApiKey:
-        return validateApiKey(req.GetApiKey())
-    case *LoginRequest_OauthToken:
-        return validateOAuthToken(req.GetOauthToken())
-    default:
-        return errors.New("unknown credential type")
-    }
-}
-
-// After oneOf deletion - validation logic breaks
-func validateLoginRequest(req *LoginRequest) error {
-    // No more oneOf - multiple fields can be set!
-    credCount := 0
-    if req.Password != "" { credCount++ }
-    if req.ApiKey != "" { credCount++ }      
-    if req.OauthToken != "" { credCount++ }
-    
-    if credCount == 0 {
-        return errors.New("no credentials provided")
-    }
-    if credCount > 1 {
-        return errors.New("multiple credentials provided") // Manual check needed!
-    }
-    
-    // Lost type safety - need manual checks
-    if req.Password != "" {
-        return validatePassword(req.Password)
-    }
-    // ... more manual validation
-}
-```
-
-**Business logic problems:**
-```go
-// Before - oneOf guarantees mutual exclusivity
-payment := &PaymentMethod{
-    Method: &PaymentMethod_CreditCard{
-        CreditCard: &CreditCard{Number: "1234"},
-    },
-}
-// Impossible to set multiple payment methods simultaneously
-
-// After oneOf deletion - business logic can break
-payment := &PaymentMethod{
-    CreditCard:  &CreditCard{Number: "1234"},
-    BankAccount: &BankAccount{Number: "5678"}, // Both set! Logic breaks!
-}
-```
-
-## Migration Strategy
-
-1. **Deprecate the oneOf and all its fields:**
-   ```proto
-   oneof old_credentials {
-     option deprecated = true;
-     string password = 2 [deprecated = true];
-     string api_key = 3 [deprecated = true];
-   }
-   ```
-
-2. **Create new structure** if needed:
-   ```proto
-   oneof new_auth_method {
-     PasswordAuth password_auth = 5;
-     ApiKeyAuth api_auth = 6;
-   }
-   ```
-
-3. **Update server code** to handle both during transition:
-   ```go
-   func handleAuth(req *LoginRequest) error {
-       // Handle new structure first
-       if req.NewAuthMethod != nil {
-           return handleNewAuth(req.NewAuthMethod)
-       }
-       
-       // Fall back to old oneOf (deprecated)
-       if req.Credentials != nil {
-           return handleOldAuth(req.Credentials)
-       }
-       
-       return errors.New("no auth method provided")
-   }
-   ```
-
-4. **Migrate clients** to use new structure:
-   ```go
-   // Update client to use new oneOf
-   loginReq.NewAuthMethod = &LoginRequest_PasswordAuth{
-       PasswordAuth: &PasswordAuth{
-           Username: "user123",
-           Password: "secret123",
-       },
-   }
-   ```
-
-5. **Remove old oneOf** in next major version
-
-## Common Scenarios
-
-### Replacing OneOf with Regular Fields
-```proto
-// Instead of removing oneOf structure entirely
-message SearchRequest {
-  // Don't delete oneOf - breaks mutual exclusivity
-  string text_query = 1;    // BREAKING: was in oneOf
-  int32 user_id = 2;        // BREAKING: was in oneOf  
-  string category = 3;      // BREAKING: was in oneOf
-}
-
-// Keep oneOf, add new fields if needed
-message SearchRequest {
-  oneof query {
-    option deprecated = true;
-    string text_query = 1 [deprecated = true];
-    int32 user_id = 2 [deprecated = true];
-    string category = 3 [deprecated = true];
-  }
-  
-  // Add new non-exclusive fields if that's the intent
-  string search_text = 4;
-  repeated string filters = 5;
-}
-```
-
-### Simplifying Message Structure
-```proto
-// Instead of flattening oneOf structure
-message NotificationSettings {
-  // Don't delete oneOf - loses type safety
-  string email = 1;         // BREAKING: was in oneOf
-  string phone = 2;         // BREAKING: was in oneOf
-  string webhook_url = 3;   // BREAKING: was in oneOf
-}
-
-// Keep oneOf for type safety
-message NotificationSettings {
-  oneof delivery_method {
-    EmailNotification email = 1;
-    SmsNotification phone = 2; 
-    WebhookNotification webhook = 3;
-  }
-}
-```
-
-### Proto Syntax Migration
-```proto
-// When migrating from proto2 to proto3
-// Don't lose oneOf semantics during migration
-
-// proto2
-message Request {
-  optional string name = 1;
-  oneof data {
-    string text = 2;
-    int32 number = 3;
-  }
-}
-
-// proto3 - keep oneOf structure
-message Request {
-  string name = 1;
-  oneof data {  // Don't delete this!
-    string text = 2;
-    int32 number = 3;
-  }
-}
-```
-
-## OneOf Semantics
-
-### What OneOf Provides
-- **Mutual Exclusivity**: Only one field can be set at a time
-- **Type Safety**: Generated code enforces single choice
-- **Clear Intent**: API design expresses "choose one" semantics
-- **Efficient Wire Format**: Only selected field is serialized
-
-### What's Lost When Deleted
-- **Business Logic**: No enforcement of mutual exclusivity
-- **Generated Code**: No oneOf wrapper types or methods
-- **Validation**: Manual checks needed for exclusivity
-- **API Clarity**: Intent of "choose one" is lost
-
-### Generated Code Impact
-```go
-// With oneOf - type safe
-type LoginRequest struct {
-    Username string
-    // Types that are assignable to Credentials:
-    //   *LoginRequest_Password
-    //   *LoginRequest_ApiKey
-    Credentials isLoginRequest_Credentials
-}
-
-// Without oneOf - no type safety
-type LoginRequest struct {
-    Username    string
-    Password    string  // All can be set simultaneously
-    ApiKey      string  // No mutual exclusivity
-    OauthToken  string
-}
-```
diff --git a/docs/dist/docs/guide/cli/breaking-changes/rules/rpc-no-delete.md b/docs/dist/docs/guide/cli/breaking-changes/rules/rpc-no-delete.md
deleted file mode 100644
index 613393c6..00000000
--- a/docs/dist/docs/guide/cli/breaking-changes/rules/rpc-no-delete.md
+++ /dev/null
@@ -1,78 +0,0 @@
-# RPC_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no RPC methods are deleted from services. Deleting an RPC method breaks both generated code and client applications that call the method.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-  rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse); // [!code --]
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-  // DeleteUser RPC was deleted - BREAKING CHANGE!
-}
-```
-
-**Error:**
-```
-services.proto:7:1: Previously present RPC "DeleteUser" on service "UserService" was deleted. (BREAKING_CHECK)
-```
-
-### Good
-
-**Instead of deleting, deprecate the RPC:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-  rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-}
-```
-
-## Impact
-
-- **Generated Code:** RPC method stubs are removed, breaking client compilation
-- **Client Applications:** Existing calls to the RPC fail to compile
-- **Runtime:** gRPC clients lose method definition
-
-## Migration Strategy
-
-1. **Deprecate first:**
-   ```proto
-   rpc OldMethod(OldRequest) returns (OldResponse) {
-     option deprecated = true;
-   }
-   ```
-
-2. **Return error from implementation** indicating method is no longer supported
-
-3. **Remove in next major version** after clients have migrated
\ No newline at end of file
diff --git a/docs/dist/docs/guide/cli/breaking-changes/rules/rpc-same-request-type.md b/docs/dist/docs/guide/cli/breaking-changes/rules/rpc-same-request-type.md
deleted file mode 100644
index bcdfb37a..00000000
--- a/docs/dist/docs/guide/cli/breaking-changes/rules/rpc-same-request-type.md
+++ /dev/null
@@ -1,256 +0,0 @@
-# RPC_SAME_REQUEST_TYPE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that RPC methods maintain the same request message type. Changing an RPC's request type breaks both wire format compatibility and generated code, as clients expect specific message structures when calling the method.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse);
-}
-
-message GetUserRequest {
-  string user_id = 1;
-}
-
-message UpdateUserRequest {
-  string user_id = 1;
-  string name = 2;
-  string email = 3;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // [!code --] Changed request type
-  rpc UpdateUser(UserUpdateRequest) returns (UpdateUserResponse); // [!code --] Changed request type
-}
-
-message GetUserRequestV2 { // [!code --] Different message type
-  string id = 1;
-  bool include_profile = 2;
-}
-
-message UserUpdateRequest { // [!code --] Different message type  
-  string id = 1;
-  UserProfile profile = 2;
-}
-```
-
-**Error:**
-```
-user_service.proto:6:3: RPC "GetUser" on service "UserService" changed request type from "GetUserRequest" to "GetUserRequestV2". (BREAKING_CHECK)
-user_service.proto:7:3: RPC "UpdateUser" on service "UserService" changed request type from "UpdateUserRequest" to "UserUpdateRequest". (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Cross-package type changes:**
-
-```proto
-// Before
-import "common/user.proto";
-
-service UserService {
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-// After - BREAKING CHANGE!
-import "v2/user.proto";
-
-service UserService {
-  rpc CreateUser(v2.CreateUserRequest) returns (CreateUserResponse); // Different package
-}
-```
-
-### Good
-
-**Instead of changing request type, version the RPC:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-  rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse); // [!code focus] // New RPC method
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-  rpc UpdateUserV2(UserUpdateRequest) returns (UpdateUserResponse); // [!code focus] // New RPC method
-}
-
-// Keep old messages for backward compatibility
-message GetUserRequest {
-  string user_id = 1;
-}
-
-// Add new messages for enhanced functionality  
-message GetUserRequestV2 { // [!code focus]
-  string id = 1; // [!code focus]
-  bool include_profile = 2; // [!code focus]
-} // [!code focus]
-```
-
-**Or create a new service version:**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus] // New package version
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] // Clean interface in v2
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus]
-}
-
-message GetUserRequest { // [!code focus]
-  string id = 1; // [!code focus] // Improved field names
-  bool include_profile = 2; // [!code focus]
-} // [!code focus]
-```
-
-## Impact
-
-- **Wire Format:** Existing client requests cannot be deserialized by new server
-- **Generated Code:** Client stubs expect different request message types, breaking compilation
-- **gRPC Calls:** Method signatures change in generated client code
-- **Runtime Errors:** Type mismatches cause RPC call failures
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-client := myapi.NewUserServiceClient(conn)
-resp, err := client.GetUser(ctx, &myapi.GetUserRequest{
-    UserId: "user123",
-})
-
-// After request type change - compilation fails  
-client := myapi.NewUserServiceClient(conn)
-resp, err := client.GetUser(ctx, &myapi.GetUserRequest{  // ERROR: type not found
-    UserId: "user123",  // ERROR: field not found
-})
-
-// Must use new type:
-resp, err := client.GetUser(ctx, &myapi.GetUserRequestV2{
-    Id: "user123",               // Different field name
-    IncludeProfile: true,        // New required field
-})
-```
-
-**Server implementation breaks:**
-```go
-// Before - server expects GetUserRequest
-func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
-    userID := req.UserId  // This field exists
-    // ... implementation
-}
-
-// After - server must handle GetUserRequestV2
-func (s *server) GetUser(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) {
-    userID := req.Id              // Different field name
-    includeProfile := req.IncludeProfile  // New field to handle
-    // ... implementation must change
-}
-```
-
-## Migration Strategy
-
-1. **Add new RPC method** with improved request type:
-   ```proto
-   rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-     option deprecated = true;
-   }
-   rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse);
-   ```
-
-2. **Implement both methods** on server during transition:
-   ```go
-   func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
-       // Legacy implementation
-       return s.getUserInternal(req.UserId, false)
-   }
-   
-   func (s *server) GetUserV2(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) {
-       // New implementation  
-       return s.getUserInternal(req.Id, req.IncludeProfile)
-   }
-   ```
-
-3. **Migrate clients** to use new RPC method:
-   ```go
-   // Update client calls to use V2
-   resp, err := client.GetUserV2(ctx, &myapi.GetUserRequestV2{
-       Id: userID,
-       IncludeProfile: true,
-   })
-   ```
-
-4. **Remove old RPC** in next major version:
-   ```proto
-   // Only keep new version
-   rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse);
-   ```
-
-## Common Scenarios
-
-### Adding Required Fields
-```proto
-// Instead of modifying existing request
-message GetUserRequest {
-  string user_id = 1;
-  bool include_deleted = 2; // BREAKING: new required field
-}
-
-// Add new RPC method  
-message GetUserRequestV2 {
-  string user_id = 1;
-  bool include_deleted = 2;  // Safe in new method
-}
-```
-
-### Restructuring Request Data
-```proto
-// Instead of changing field structure
-message UpdateUserRequest {
-  UserProfile profile = 1; // BREAKING: was individual fields
-}
-
-// Version the RPC
-rpc UpdateUser(UpdateUserRequest) returns (...) {
-  option deprecated = true;
-}
-rpc UpdateUserV2(UpdateUserRequestV2) returns (...);
-```
-
-### Package Migrations
-```proto
-// Instead of changing import packages
-import "v2/messages.proto";  // BREAKING: different package
-
-// Keep old RPC, add new one
-rpc OldMethod(v1.Request) returns (...) {
-  option deprecated = true;  
-}
-rpc NewMethod(v2.Request) returns (...);
-```
diff --git a/docs/dist/docs/guide/cli/breaking-changes/rules/rpc-same-response-type.md b/docs/dist/docs/guide/cli/breaking-changes/rules/rpc-same-response-type.md
deleted file mode 100644
index 46994412..00000000
--- a/docs/dist/docs/guide/cli/breaking-changes/rules/rpc-same-response-type.md
+++ /dev/null
@@ -1,321 +0,0 @@
-# RPC_SAME_RESPONSE_TYPE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that RPC methods maintain the same response message type. Changing an RPC's response type breaks both wire format compatibility and generated code, as clients expect specific message structures when receiving responses from the method.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse);
-}
-
-message GetUserResponse {
-  string user_id = 1;
-  string name = 2;
-  string email = 3;
-}
-
-message UpdateUserResponse {
-  bool success = 1;
-  string message = 2;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponseV2); // [!code --] Changed response type
-  rpc UpdateUser(UpdateUserRequest) returns (UserUpdateResponse); // [!code --] Changed response type
-}
-
-message GetUserResponseV2 { // [!code --] Different message type
-  string id = 1;
-  UserProfile profile = 2;
-  repeated string permissions = 3;
-}
-
-message UserUpdateResponse { // [!code --] Different message type  
-  UpdateResult result = 1;
-  UserProfile updated_profile = 2;
-}
-```
-
-**Error:**
-```
-user_service.proto:6:3: RPC "GetUser" on service "UserService" changed response type from "GetUserResponse" to "GetUserResponseV2". (BREAKING_CHECK)
-user_service.proto:7:3: RPC "UpdateUser" on service "UserService" changed response type from "UpdateUserResponse" to "UserUpdateResponse". (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Cross-package type changes:**
-
-```proto
-// Before
-import "common/responses.proto";
-
-service UserService {
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-// After - BREAKING CHANGE!
-import "v2/responses.proto";
-
-service UserService {
-  rpc CreateUser(CreateUserRequest) returns (v2.CreateUserResponse); // Different package
-}
-```
-
-### Good
-
-**Instead of changing response type, version the RPC:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-  rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2); // [!code focus] // New RPC method
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-  rpc UpdateUserV2(UpdateUserRequest) returns (UserUpdateResponse); // [!code focus] // New RPC method
-}
-
-// Keep old messages for backward compatibility
-message GetUserResponse {
-  string user_id = 1;
-  string name = 2;
-  string email = 3;
-}
-
-// Add new messages for enhanced functionality  
-message GetUserResponseV2 { // [!code focus]
-  string id = 1; // [!code focus]
-  UserProfile profile = 2; // [!code focus]
-  repeated string permissions = 3; // [!code focus]
-} // [!code focus]
-```
-
-**Or create a new service version:**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus] // New package version
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] // Clean interface in v2
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus]
-}
-
-message GetUserResponse { // [!code focus]
-  string id = 1; // [!code focus] // Improved field names
-  UserProfile profile = 2; // [!code focus]
-  repeated string permissions = 3; // [!code focus]
-} // [!code focus]
-```
-
-## Impact
-
-- **Wire Format:** Server responses cannot be deserialized by existing clients
-- **Generated Code:** Client stubs expect different response message types, breaking compilation
-- **gRPC Calls:** Method signatures change in generated client code
-- **Runtime Errors:** Type mismatches cause RPC response handling failures
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-client := myapi.NewUserServiceClient(conn)
-resp, err := client.GetUser(ctx, &myapi.GetUserRequest{
-    UserId: "user123",
-})
-if err != nil {
-    return err
-}
-
-// Access response fields
-userID := resp.UserId  // This field exists
-name := resp.Name      // This field exists
-
-// After response type change - compilation fails  
-client := myapi.NewUserServiceClient(conn)
-resp, err := client.GetUser(ctx, &myapi.GetUserRequest{
-    UserId: "user123",
-})
-if err != nil {
-    return err
-}
-
-// Access response fields - COMPILATION ERRORS
-userID := resp.UserId  // ERROR: field not found
-name := resp.Name      // ERROR: field not found
-
-// Must use new fields:
-userID := resp.Id                    // Different field name
-profile := resp.Profile             // New structure
-permissions := resp.Permissions     // New field
-```
-
-**Server implementation breaks:**
-```go
-// Before - server returns GetUserResponse
-func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
-    return &GetUserResponse{
-        UserId: "user123",
-        Name:   "John Doe", 
-        Email:  "john@example.com",
-    }, nil
-}
-
-// After - server must return GetUserResponseV2
-func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) {
-    return &GetUserResponseV2{
-        Id: "user123",                    // Different field name
-        Profile: &UserProfile{           // New structure required
-            Name:  "John Doe",
-            Email: "john@example.com",
-        },
-        Permissions: []string{"read"},   // New field to populate
-    }, nil
-}
-```
-
-## Migration Strategy
-
-1. **Add new RPC method** with improved response type:
-   ```proto
-   rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-     option deprecated = true;
-   }
-   rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2);
-   ```
-
-2. **Implement both methods** on server during transition:
-   ```go
-   func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
-       // Legacy implementation
-       user := s.getUserInternal(req.UserId)
-       return &GetUserResponse{
-           UserId: user.ID,
-           Name:   user.Name,
-           Email:  user.Email,
-       }, nil
-   }
-   
-   func (s *server) GetUserV2(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) {
-       // New implementation with enhanced response
-       user := s.getUserInternal(req.UserId)
-       return &GetUserResponseV2{
-           Id: user.ID,
-           Profile: &UserProfile{
-               Name:  user.Name,
-               Email: user.Email,
-           },
-           Permissions: user.Permissions,
-       }, nil
-   }
-   ```
-
-3. **Migrate clients** to use new RPC method:
-   ```go
-   // Update client calls to use V2
-   resp, err := client.GetUserV2(ctx, &myapi.GetUserRequest{
-       UserId: userID,
-   })
-   if err != nil {
-       return err
-   }
-   
-   // Handle new response structure
-   profile := resp.Profile
-   permissions := resp.Permissions
-   ```
-
-4. **Remove old RPC** in next major version:
-   ```proto
-   // Only keep new version
-   rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2);
-   ```
-
-## Common Scenarios
-
-### Adding Fields to Response
-```proto
-// Instead of modifying existing response
-message GetUserResponse {
-  string user_id = 1;
-  string name = 2;
-  UserProfile profile = 3; // BREAKING: new required field
-}
-
-// Add new RPC method  
-message GetUserResponseV2 {
-  string user_id = 1;
-  string name = 2;
-  UserProfile profile = 3;  // Safe in new method
-}
-```
-
-### Restructuring Response Data
-```proto
-// Instead of changing field structure
-message UpdateUserResponse {
-  UserDetails details = 1; // BREAKING: was individual fields
-}
-
-// Version the RPC
-rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) {
-  option deprecated = true;
-}
-rpc UpdateUserV2(UpdateUserRequest) returns (UpdateUserResponseV2);
-```
-
-### Error Handling Changes
-```proto
-// Instead of changing error structure
-message CreateUserResponse {
-  ErrorDetails error = 1; // BREAKING: different error format
-}
-
-// Keep old RPC, add new one
-rpc CreateUser(CreateUserRequest) returns (CreateUserResponse) {
-  option deprecated = true;  
-}
-rpc CreateUserV2(CreateUserRequest) returns (CreateUserResponseV2);
-```
-
-### Response Format Migration
-```proto
-// Instead of changing from simple to complex response
-message GetUserResponse {
-  // BREAKING: changed from simple fields to nested structure
-  UserData data = 1;
-}
-
-// Provide both formats during transition
-rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-  option deprecated = true;
-}
-rpc GetUserDetailed(GetUserRequest) returns (GetUserDetailedResponse);
-```
diff --git a/docs/dist/docs/guide/cli/breaking-changes/rules/service-no-delete.md b/docs/dist/docs/guide/cli/breaking-changes/rules/service-no-delete.md
deleted file mode 100644
index f2b77af9..00000000
--- a/docs/dist/docs/guide/cli/breaking-changes/rules/service-no-delete.md
+++ /dev/null
@@ -1,87 +0,0 @@
-# SERVICE_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no services are deleted from proto files. Deleting a service breaks both generated code and client applications that depend on the service.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-service OrderService { // [!code --]
-  rpc GetOrder(GetOrderRequest) returns (GetOrderResponse); // [!code --]
-} // [!code --]
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-// OrderService was deleted - BREAKING CHANGE!
-```
-
-**Error:**
-```
-services.proto:8:1: Previously present service "OrderService" was deleted from file. (BREAKING_CHECK)
-```
-
-### Good
-
-**Instead of deleting, deprecate the service:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-service OrderService {
-  option deprecated = true; // [!code focus]
-  rpc GetOrder(GetOrderRequest) returns (GetOrderResponse) {
-    option deprecated = true; // [!code focus]
-  }
-}
-```
-
-## Impact
-
-- **Generated Code:** Service classes/interfaces are removed, breaking client compilation
-- **Client Applications:** Existing client code fails to compile
-- **Runtime:** gRPC clients lose service definition
-
-## Migration Strategy
-
-1. **Deprecate first:**
-   ```proto
-   service OldService {
-     option deprecated = true;
-     // ... methods
-   }
-   ```
-
-2. **Notify clients** about deprecation timeline
-
-3. **Remove after migration period** in a new major version
\ No newline at end of file
diff --git a/docs/dist/docs/guide/cli/configuration/configuration.md b/docs/dist/docs/guide/cli/configuration/configuration.md
deleted file mode 100644
index 5ee5a61f..00000000
--- a/docs/dist/docs/guide/cli/configuration/configuration.md
+++ /dev/null
@@ -1,930 +0,0 @@
-# EasyP Configuration Reference
-
-EasyP can be configured through CLI flags, environment variables, and configuration files. This guide covers all configuration options available in EasyP.
-
-## CLI Flags
-
-### Global Flags
-
-Available for all commands:
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--cfg` | `-c` | `EASYP_CFG` | Configuration file path | `easyp.yaml` |
-| `--config` | | `EASYP_CFG` | Alias for `--cfg` | `easyp.yaml` |
-| `--debug` | `-d` | `EASYP_DEBUG` | Enable debug mode | `false` |
-| `--format` | `-f` | `EASYP_FORMAT` | Output format for commands that support multiple formats (`text`/`json`) | command-specific default |
-
-**Examples:**
-```bash
-# Use custom config file
-easyp --cfg production.easyp.yaml lint
-
-# Enable debug logging
-easyp --debug lint
-
-# Short form
-easyp -c custom.yaml -d lint
-```
-
-### Command-Specific Flags
-
-**Lint command:**
-```bash
-easyp lint [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--path` | `-p` | | Directory path to lint | `.` |
-| `--root` | `-r` | | Base directory for file search | Current working directory |
-| `--format` | `-f` | `EASYP_FORMAT` | Uses global format flag (`text`/`json`) | Inherits global default |
-
-**Examples:**
-```bash
-# Lint specific directory
-easyp lint --path proto/
-
-# Lint from subdirectory with proper import resolution
-easyp lint --root src/IPC/Contracts --path .
-
-# JSON output format
-easyp --format json lint   # global flag
-
-# Combined flags
-easyp -f json lint -p proto/
-```
-
-**Generate command:**
-```bash
-easyp generate [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--path` | `-p` | `EASYP_ROOT_GENERATE_PATH` | Directory path with proto files to generate | `.` |
-| `--root` | `-r` | | Base directory for file search | Current working directory |
-
-**Examples:**
-```bash
-# Generate from specific path
-easyp generate --path api/
-
-# Generate from subdirectory with proper import resolution
-easyp generate --root src/IPC/Contracts --path .
-
-# Using environment variable
-EASYP_ROOT_GENERATE_PATH=proto/ easyp generate
-```
-
-**Breaking command:**
-```bash
-easyp breaking [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--against` | | | Git ref to compare against | `master` |
-| `--path` | `-p` | | Directory path to check | `.` |
-| `--format` | `-f` | `EASYP_FORMAT` | Uses global format flag (`text`/`json`) | Inherits global default |
-
-**Examples:**
-```bash
-# Check against main branch
-easyp breaking --against main
-
-# Check specific directory against develop branch
-easyp breaking --against develop --path proto/
-
-# JSON output
-easyp --format json breaking --against main   # global flag
-```
-
-**Init command:**
-```bash
-easyp init [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--dir` | `-d` | `EASYP_INIT_DIR` | Directory to initialize | `.` |
-
-**Examples:**
-```bash
-# Initialize current directory
-easyp init
-
-# Initialize specific directory
-easyp init --dir proto-project/
-```
-
-`easyp init` is interactive:
-- If `buf.yml`/`buf.yaml` exists in the target directory root, it asks whether to migrate from Buf.
-- If `easyp.yaml` already exists, it asks for overwrite confirmation.
-
-**Validate-config command:**
-```bash
-easyp validate-config [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--config` | `-c` | `EASYP_CFG` | Configuration file path | `easyp.yaml` |
-| `--format` (global) | `-f` | `EASYP_FORMAT` | Output format for commands that support multiple formats (`json` or `text`) | command-specific (`json` for `validate-config`) |
-
-**Examples:**
-```bash
-# Validate default config with JSON output (exit 0 when no errors)
-easyp validate-config
-
-# Validate a different file with text output (global --format)
-easyp --format text validate-config --config example.easyp.yaml
-```
-
-**Package management commands:**
-
-#### `easyp mod download`
-Downloads dependencies based on lock file priority:
-
-1. **If `easyp.lock` exists** - downloads exact versions from lock file
-2. **If `easyp.lock` is missing** - downloads versions from `easyp.yaml` and creates `easyp.lock`
-
-```bash
-# Download exact versions (recommended for production)
-easyp mod download
-```
-
-#### `easyp mod update`  
-Always downloads dependencies from `easyp.yaml`, ignoring existing lock file:
-
-1. **Ignores `easyp.lock`** completely
-2. **Downloads versions from `easyp.yaml`**
-3. **Creates/updates `easyp.lock`** with new versions
-
-```bash
-# Update dependencies and lock file
-easyp mod update
-```
-
-#### `easyp mod vendor`
-Copies proto files from dependencies to local `vendor/` directory (similar to `go mod vendor`).
-
-```bash
-# Create local vendor directory with dependencies
-easyp mod vendor
-```
-
-No additional flags. Uses global `--cfg` flag for configuration.
-
-## Environment Variables
-
-EasyP supports environment variables for configuration:
-
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `EASYP_CFG` | Path to configuration file | `easyp.yaml` |
-| `EASYP_DEBUG` | Enable debug logging | `false` |
-| `EASYPPATH` | Cache and modules storage directory | `$HOME/.easyp` |
-| `EASYP_FORMAT` | Output format for supported commands (`text`/`json`). If not set, each command uses its own default. | command-specific default |
-| `EASYP_ROOT_GENERATE_PATH` | Root path for generate command | `.` |
-| `EASYP_INIT_DIR` | Directory for init command | `.` |
-
-**Examples:**
-```bash
-# Custom cache directory
-export EASYPPATH=/tmp/easyp-cache
-easyp mod download
-
-# Debug mode via environment
-export EASYP_DEBUG=true
-easyp lint
-
-# Custom config file
-export EASYP_CFG=config/easyp.yaml
-easyp generate
-```
-
-## Configuration File
-
-The `easyp.yaml` file is the main configuration file for EasyP, defining how your proto files are linted, generated, and managed. This file is typically placed at the root of your project alongside your proto files.
-
-### File Structure Overview
-
-```
-.
-├── easyp.yaml
-├── easyp.lock
-├── proto/
-│   ├── user/
-│   │   └── user.proto
-│   └── order/
-│       └── order.proto
-└── vendor/
-```
-
-### Configuration Format
-
-EasyP supports both YAML and JSON configuration formats:
-
-#### YAML Format (Recommended)
-```yaml
-lint:
-  use:
-    - BASIC
-    - COMMENT_SERVICE
-deps:
-  - github.com/googleapis/googleapis@v1.0.0
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-breaking:
-  ignore:
-    - proto/experimental/
-  against_git_ref: main
-```
-
-#### JSON Format
-```json
-{
-  "lint": {
-    "use": ["BASIC", "COMMENT_SERVICE"]
-  },
-  "deps": [
-    "github.com/googleapis/googleapis@v1.0.0"
-  ],
-  "generate": {
-    "inputs": [
-      {"directory": "proto"}
-    ],
-    "plugins": [
-      {
-        "name": "go",
-        "out": ".",
-        "opts": {
-          "paths": "source_relative"
-        }
-      }
-    ]
-  },
-  "breaking": {
-    "ignore": ["proto/experimental/"],
-    "against_git_ref": "main"
-  }
-}
-```
-
-### Environment Variables in Configuration
-
-EasyP supports environment variable expansion directly in the `easyp.yaml` configuration file. This allows you to use environment variables for dynamic configuration values.
-
-**Example with all supported features:**
-```yaml
-deps:
-  # Basic expansion: ${VAR} - expands to the value of VAR
-  - ${GOOGLEAPIS_REPO}@${GOOGLEAPIS_VERSION}
-  
-  # Default value: ${VAR:-default} - uses default if VAR is unset or empty
-  - ${GNOSTIC_REPO:-github.com/google/gnostic}@${GNOSTIC_VERSION:-v0.7.0}
-
-generate:
-  inputs:
-    # Default value if INPUT_DIR is not set
-    - directory: ${INPUT_DIR:-proto}
-  plugins:
-    - name: go
-      # Basic expansion
-      out: ${OUTPUT_DIR}
-      opts:
-        # Default value
-        module: ${MODULE_NAME:-github.com/example/project}
-        timeout: ${TIMEOUT:-30}
-        
-        # Escaping: $$ becomes literal $, $${VAR} becomes literal ${VAR}
-        path: "${BASE_DIR}/$${TEMP}/file"     # Result: "/tmp/${TEMP}/file" (if BASE_DIR=/tmp)
-        literal: "$$"                         # Result: "$"
-```
-
-**Supported syntax:**
-- `${VAR}` - expands to the value of `VAR`
-- `${VAR:-default}` - uses `default` if `VAR` is unset or empty
-- `${VAR:=default}` - uses `default` if `VAR` is unset or empty
-- `${VAR-default}` - uses `default` if `VAR` is unset (empty string is kept)
-- `$${VAR}` or `$$VAR` - escapes to literal `${VAR}` or `$VAR`
-- `$$` - escapes to literal `$`
-
-**Note:** Environment variables are expanded before YAML parsing, so any `${STRING}` pattern will be processed. Use `$$` to escape dollar signs when you need literal values.
-
-## Configuration Fields
-
-### `version`
-
-**Optional (legacy compatibility).** This field is accepted for backward compatibility and can be omitted in new configs.
-
-**Type:** `string`
-**Default:** omitted
-**Recommendation:** if you keep it, use `v1alpha`
-
-```yaml
-# Optional compatibility field (can be omitted)
-version: v1alpha
-```
-
-The runtime behavior does not depend on this field.
-
-### `lint`
-
-**Optional.** Configures proto file linting rules and behavior.
-
-**Type:** `object`
-**Default:** Empty (no linting rules applied)
-
-```yaml
-lint:
-  use:
-    - BASIC
-    - COMMENT_SERVICE
-  enum_zero_value_suffix: "UNSPECIFIED"
-  service_suffix: "Service"
-  ignore:
-    - vendor/
-    - proto/legacy/
-  except:
-    - COMMENT_FIELD
-  allow_comment_ignores: true
-  ignore_only:
-    COMMENT_SERVICE:
-      - proto/experimental/
-```
-
-#### `lint.use`
-
-**Optional.** Specifies which linter rules or rule categories to apply.
-
-**Type:** `[]string`
-**Default:** `[]` (no rules)
-
-**Available categories:**
-- `MINIMAL` - Essential package consistency checks
-- `BASIC` - Naming conventions and common patterns
-- `DEFAULT` - Additional recommended rules
-- `COMMENTS` - Comment requirements
-- `UNARY_RPC` - Streaming RPC restrictions
-
-**Individual rules:** Any specific rule name (e.g., `ENUM_PASCAL_CASE`, `FIELD_LOWER_SNAKE_CASE`)
-
-```yaml
-lint:
-  use:
-    - MINIMAL           # Use all minimal rules
-    - BASIC             # Use all basic rules
-    - COMMENT_SERVICE   # Require service comments
-    - ENUM_PASCAL_CASE  # Specific rule
-```
-
-**Rule Categories:**
-
-**MINIMAL:**
-- `DIRECTORY_SAME_PACKAGE`
-- `PACKAGE_DEFINED`
-- `PACKAGE_DIRECTORY_MATCH`
-- `PACKAGE_SAME_DIRECTORY`
-
-**BASIC:**
-- `ENUM_FIRST_VALUE_ZERO`
-- `ENUM_NO_ALLOW_ALIAS`
-- `ENUM_PASCAL_CASE`
-- `ENUM_VALUE_UPPER_SNAKE_CASE`
-- `FIELD_LOWER_SNAKE_CASE`
-- `IMPORT_NO_PUBLIC`
-- `IMPORT_NO_WEAK`
-- `IMPORT_USED`
-- `MESSAGE_PASCAL_CASE`
-- `ONEOF_LOWER_SNAKE_CASE`
-- `PACKAGE_LOWER_SNAKE_CASE`
-- `PACKAGE_SAME_CSHARP_NAMESPACE`
-- `PACKAGE_SAME_GO_PACKAGE`
-- `PACKAGE_SAME_JAVA_MULTIPLE_FILES`
-- `PACKAGE_SAME_JAVA_PACKAGE`
-- `PACKAGE_SAME_PHP_NAMESPACE`
-- `PACKAGE_SAME_RUBY_PACKAGE`
-- `PACKAGE_SAME_SWIFT_PREFIX`
-- `RPC_PASCAL_CASE`
-- `SERVICE_PASCAL_CASE`
-
-**DEFAULT:**
-- `ENUM_VALUE_PREFIX`
-- `ENUM_ZERO_VALUE_SUFFIX`
-- `FILE_LOWER_SNAKE_CASE`
-- `RPC_REQUEST_RESPONSE_UNIQUE`
-- `RPC_REQUEST_STANDARD_NAME`
-- `RPC_RESPONSE_STANDARD_NAME`
-- `PACKAGE_VERSION_SUFFIX`
-- `SERVICE_SUFFIX`
-
-**COMMENTS:**
-- `COMMENT_ENUM`
-- `COMMENT_ENUM_VALUE`
-- `COMMENT_FIELD`
-- `COMMENT_MESSAGE`
-- `COMMENT_ONEOF`
-- `COMMENT_RPC`
-- `COMMENT_SERVICE`
-
-**UNARY_RPC:**
-- `RPC_NO_CLIENT_STREAMING`
-- `RPC_NO_SERVER_STREAMING`
-
-#### `lint.enum_zero_value_suffix`
-
-**Optional.** Specifies the required suffix for enum zero values.
-
-**Type:** `string`
-**Default:** `""` (no suffix required)
-**Common values:** `"UNSPECIFIED"`, `"UNKNOWN"`, `"DEFAULT"`
-
-```yaml
-lint:
-  enum_zero_value_suffix: "UNSPECIFIED"
-```
-
-This enforces enum zero values like:
-```proto
-enum Status {
-  STATUS_UNSPECIFIED = 0;  // Required suffix
-  STATUS_ACTIVE = 1;
-  STATUS_INACTIVE = 2;
-}
-```
-
-#### `lint.service_suffix`
-
-**Optional.** Specifies the required suffix for service names.
-
-**Type:** `string`
-**Default:** `""` (no suffix required)
-**Common values:** `"Service"`, `"API"`, `"Svc"`
-
-```yaml
-lint:
-  service_suffix: "Service"
-```
-
-This enforces service names like:
-```proto
-service UserService {    // Required "Service" suffix
-  rpc GetUser(...) returns (...);
-}
-```
-
-#### `lint.ignore`
-
-**Optional.** Directories or files to exclude from all linting rules.
-
-**Type:** `[]string`
-**Default:** `[]`
-
-```yaml
-lint:
-  ignore:
-    - vendor/
-    - proto/legacy/
-    - testdata/
-    - "**/*_test.proto"
-```
-
-Paths are relative to the `easyp.yaml` file location. Supports glob patterns.
-
-#### `lint.except`
-
-**Optional.** Disables specific rules globally across the entire project.
-
-**Type:** `[]string`
-**Default:** `[]`
-
-```yaml
-lint:
-  except:
-    - COMMENT_FIELD
-    - COMMENT_MESSAGE
-    - SERVICE_SUFFIX
-```
-
-#### `lint.allow_comment_ignores`
-
-**Optional.** Enables inline comment-based rule ignoring within proto files.
-
-**Type:** `boolean`
-**Default:** `false`
-
-```yaml
-lint:
-  allow_comment_ignores: true
-```
-
-When enabled, allows comments like:
-```proto
-// buf:lint:ignore COMMENT_SERVICE
-service LegacyAPI {
-  // nolint:COMMENT_RPC
-  rpc GetData(...) returns (...);
-}
-```
-
-#### `lint.ignore_only`
-
-**Optional.** Disables specific rules only for certain files or directories.
-
-**Type:** `map[string][]string`
-**Default:** `{}`
-
-```yaml
-lint:
-  ignore_only:
-    COMMENT_SERVICE:
-      - proto/legacy/
-      - vendor/
-    SERVICE_SUFFIX:
-      - proto/external/
-```
-
-**Key:** Rule name or category
-**Value:** Array of file paths or directories
-
-### `deps`
-
-**Optional.** Lists external proto dependencies to download and manage.
-
-**Type:** `[]string`  
-**Default:** `[]`
-
-#### Dependency Format
-
-Dependencies follow the format: `$GIT_LINK@$VERSION`
-
-**Components:**
-- `$GIT_LINK` - Git repository URL (GitHub, GitLab, etc.)
-- `$VERSION` - Git tag or full commit hash (optional)
-
-**Format variations:**
-- `owner/repo` - Latest commit from default branch
-- `owner/repo@v1.0.0` - Specific git tag
-- `owner/repo@47b927cbb41c4fdea1292baf` - Full commit hash
-- `github.com/owner/repo@version` - Full URL with version
-- `gitlab.com/group/repo@tag` - GitLab repository
-
-```yaml
-deps:
-  # Latest commit from default branch
-  - googleapis/googleapis
-  
-  # Specific tag (recommended for production)
-  - googleapis/googleapis@v1.0.0
-  
-  # Full commit hash (most precise)
-  - googleapis/googleapis@47b927cbb41c4fdea1292bafadb8976f
-  
-  # Different Git hosting
-  - gitlab.com/acme/proto@v2.1.0
-```
-
-**Note:** If `@$VERSION` is omitted, EasyP downloads the latest commit from the repository's default branch.
-
-### `generate`
-
-**Optional.** Configures code generation from proto files.
-
-**Type:** `object`
-**Default:** `{}`
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-    - git_repo:
-        url: "github.com/acme/common@v1.0.0"
-        sub_directory: "proto"
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-```
-
-#### `generate.inputs`
-
-**Required when `generate` is set.** Specifies sources of proto files for generation.
-
-**Type:** `[]object` (minimum 1 item)
-**Default:** not set
-
-```yaml
-generate:
-  inputs:
-    # Local directory
-    - directory: "proto"
-
-    # Local directory with advanced options
-    - directory:
-        path: "api/proto"
-        root: "."
-
-    # Remote git repository
-    - git_repo:
-        url: "github.com/acme/common@v1.0.0"
-        sub_directory: "proto"
-        root: "."
-```
-
-**Directory input fields:**
-- `directory` (string or object) - Local directory path
-- `directory.path` (string) - Directory path
-- `directory.root` (string) - Root path for import resolution (default: ".")
-
-**Git repository input fields:**
-- `git_repo.url` (string) - Repository URL with optional version
-- `git_repo.sub_directory` (string) - Subdirectory within the repository
-- `git_repo.root` (string) - Root path used for import resolution
-
-#### `generate.plugins`
-
-**Required when `generate` is set.** Configures protoc plugins for code generation.
-
-**Type:** `[]object` (minimum 1 item)
-**Default:** not set
-
-```yaml
-generate:
-  plugins:
-    # Local plugin
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-
-    # Remote plugin
-    - remote: "buf.build/bufbuild/protovalidate-go:v0.4.0"
-      out: gen/go
-      opts:
-        paths: source_relative
-
-    # Plugin with import dependencies
-    - name: grpc-gateway
-      out: .
-      with_imports: true
-      opts:
-        paths: source_relative
-```
-
-**Plugin fields:**
-- `name` (string, optional) - Plugin name (omit `protoc-gen-` prefix)
-- `remote` (string, optional) - Remote plugin URL for execution
-- `path` (string, optional) - Path to plugin executable file
-- `command` ([]string, optional) - Command to execute plugin
-- `out` (string, optional) - Output directory for generated files; defaults to the resolved generate root
-- `opts` (map[string](string | number | boolean | array<string | number | boolean>), optional) - Plugin-specific options; each key can be a single scalar value or an array of scalar values
-- `with_imports` (boolean, optional) - Include imported dependencies
-
-Plugin source is `one-of`: exactly one of `name`, `remote`, `path`, or `command` must be set.
-
-**Common plugin options:**
-```yaml
-# Go plugin options
-opts:
-  paths: source_relative              # Generate files relative to input
-  module: github.com/acme/api        # Go module path
-
-# gRPC Gateway options
-opts:
-  paths: source_relative
-  grpc_api_configuration: api.yaml   # gRPC API configuration
-
-# OpenAPI v2 options
-opts:
-  simple_operation_ids: true         # Use simple operation IDs
-  generate_unbound_methods: false    # Skip unbound methods
-
-# ts-proto options with repeated key values
-opts:
-  env: node
-  outputServices:
-    - grpc-js
-    - generic-definitions
-```
-
-When an `opts` value is a list, EasyP serializes it as repeated plugin params, e.g. `outputServices=grpc-js,outputServices=generic-definitions`.
-
-### `breaking`
-
-**Optional.** Configures backward compatibility checking.
-
-**Type:** `object`
-**Default:** `{}`
-
-```yaml
-breaking:
-  ignore:
-    - proto/experimental/
-    - proto/internal/
-  against_git_ref: main
-```
-
-#### `breaking.ignore`
-
-**Optional.** Directories or files to exclude from breaking change detection.
-
-**Type:** `[]string`
-**Default:** `[]`
-
-```yaml
-breaking:
-  ignore:
-    - proto/experimental/
-    - proto/alpha/
-    - testdata/
-```
-
-#### `breaking.against_git_ref`
-
-**Optional.** Git reference (branch, tag, or commit) to compare against for breaking changes.
-
-**Type:** `string`
-**Default:** `""` (falls back to CLI `--against` default: `master`)
-
-```yaml
-breaking:
-  against_git_ref: main
-```
-
-Can be overridden by the `--against` CLI flag.
-
-
-
-## Configuration Examples
-
-### Minimal Configuration
-
-```yaml
-lint:
-  use:
-    - MINIMAL
-```
-
-### Development Configuration
-
-```yaml
-lint:
-  use:
-    - BASIC
-    - COMMENT_SERVICE
-    - COMMENT_RPC
-  allow_comment_ignores: true
-  ignore:
-    - vendor/
-    - testdata/
-deps:
-  - github.com/googleapis/googleapis@v1.0.0
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-```
-
-### Production Configuration
-
-```yaml
-lint:
-  use:
-    - MINIMAL
-    - BASIC
-    - DEFAULT
-    - COMMENTS
-  enum_zero_value_suffix: "UNSPECIFIED"
-  service_suffix: "Service"
-  ignore:
-    - vendor/
-  except: []
-  allow_comment_ignores: false
-deps:
-  - github.com/googleapis/googleapis@v1.56.0
-  - github.com/grpc-ecosystem/grpc-gateway@v2.18.0
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-        module: github.com/acme/api/gen/go
-    - name: go-grpc
-      out: gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-    - name: grpc-gateway
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: openapiv2
-      out: gen/openapi
-      opts:
-        simple_operation_ids: true
-breaking:
-  ignore:
-    - proto/experimental/
-  against_git_ref: main
-```
-
-### Multi-Service Configuration
-
-```yaml
-lint:
-  use:
-    - BASIC
-    - COMMENT_SERVICE
-    - COMMENT_RPC
-  service_suffix: "Service"
-  ignore_only:
-    COMMENT_FIELD:
-      - proto/internal/
-    SERVICE_SUFFIX:
-      - proto/legacy/
-deps:
-  - github.com/googleapis/googleapis@v1.0.0
-  - github.com/acme/common-proto@v2.1.0
-generate:
-  inputs:
-    - directory: "proto/public"
-    - directory: "proto/internal"
-    - git_repo:
-        url: "github.com/acme/shared-proto@v1.0.0"
-        sub_directory: "proto"
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: grpc-gateway
-      out: gen/go
-      opts:
-        paths: source_relative
-    - remote: "buf.build/bufbuild/protovalidate-go:v0.4.0"
-      out: gen/go
-      opts:
-        paths: source_relative
-breaking:
-  ignore:
-    - proto/internal/
-    - proto/experimental/
-  against_git_ref: develop
-```
-
-## Configuration Validation
-
-EasyP validates configuration files on startup and provides helpful error messages:
-
-```bash
-# Invalid rule name
-Error: invalid rule: INVALID_RULE_NAME
-
-# Missing required field in generate section
-Error: required field "plugins" is missing (path: generate.plugins)
-
-# Invalid dependency format
-Error: invalid dependency format: invalid-repo-url
-```
-
-Use `easyp --debug` for detailed validation information.
-
-## Migration from Buf
-
-EasyP is fully compatible with Buf configurations. To migrate:
-
-1. Place `buf.yaml` or `buf.yml` in the project root
-2. Run `easyp init` and confirm migration when prompted
-3. Update `deps` format if using BSR modules
-4. Review migrated lint/breaking settings and adjust as needed
-
-Most Buf configurations work without changes in EasyP.
diff --git a/docs/dist/docs/guide/cli/generator/examples/go.md b/docs/dist/docs/guide/cli/generator/examples/go.md
deleted file mode 100644
index 9a599eae..00000000
--- a/docs/dist/docs/guide/cli/generator/examples/go.md
+++ /dev/null
@@ -1,82 +0,0 @@
-# Go
-
-## Installing Plugins
-
-First, install the necessary plugins for working with gRPC:
-
-```shell
-go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
-go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
-```
-
-These commands will install the `protoc-gen-go` and `protoc-gen-go-grpc` plugins for use with EasyP.
-
-## Example Proto Service
-
-Here is an example proto file for an Echo service:
-
-```proto
-syntax = "proto3";
-
-package api.echo.v1;
-
-option go_package = "github.com/easyp-tech/example/api/echo/v1;pb";
-
-service EchoAPI {
-  rpc Echo(EchoRequest) returns (EchoResponse);
-  rpc EchoStream(EchoStreamRequest) returns (EchoResponse);
-}
-
-message EchoRequest {
-  string payload = 1;
-}
-
-message EchoResponse {
-  string payload = 2;
-}
-
-message EchoStreamRequest {
-  string payload = 1;
-}
-
-message EchoStreamResponse {
-  string payload = 2;
-}
-```
-
-## Configuration Setup
-
-Create and configure the easyp.yaml configuration file:
-
-```yaml
-generate:
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-```
-
-This file specifies that two plugins will be used: `go` for generating Go code and `go-grpc` for generating gRPC code, along with their respective options.
-
-## Generating Code
-
-To generate code, use the following command:
-
-```shell
-easyp --cfg easyp.yaml generate
-```
-
-If the --cfg flag is not specified, the easyp.yaml file in the current directory will be used by default:
-
-```shell
-easyp generate
-```
-
-Now you have the generated Go code, which you can interact with directly.
-
diff --git a/docs/dist/docs/guide/cli/generator/examples/grpc-gateway.md b/docs/dist/docs/guide/cli/generator/examples/grpc-gateway.md
deleted file mode 100644
index 12b23425..00000000
--- a/docs/dist/docs/guide/cli/generator/examples/grpc-gateway.md
+++ /dev/null
@@ -1,127 +0,0 @@
-# gRPC-Gateway
-
-## Installing Plugins
-
-In addition to the plugins for working with gRPC, you also need to install the following plugins for gRPC-Gateway:
-
-```bash
-go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
-go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
-go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2@latest
-go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest
-```
-
-These commands will install the `protoc-gen-go`, `protoc-gen-go-grpc`, `protoc-gen-openapiv2`, and
-`protoc-gen-grpc-gateway` plugins for use with EasyP`.
-
-## Example Proto Service
-
-Here is the initial proto file for an Echo service:
-
-```proto
-syntax = "proto3";
-
-package api.echo.v1;
-
-option go_package = "github.com/easyp-tech/example/api/echo/v1;pb";
-
-service EchoAPI {
-  rpc Echo(EchoRequest) returns (EchoResponse);
-}
-
-message EchoRequest {
-  string payload = 1;
-}
-
-message EchoResponse {
-  string payload = 2;
-}
-```
-
-To use gRPC-Gateway, update the proto file to include HTTP options:
-
-```proto
-syntax = "proto3";
-import "google/api/annotations.proto";
-
-package api.echo.v1;
-
-option go_package = "github.com/easyp-tech/example/api/echo/v1;pb";
-
-service EchoAPI {
-  rpc Echo(EchoRequest) returns (EchoResponse) {
-    option (google.api.http) = { // [!code ++]
-      post: "/api/v1/echo"       // [!code ++]
-      body: "*"                  // [!code ++]
-    };                           // [!code ++]
-  }
-}
-
-message EchoRequest {
-  string payload = 1;
-}
-
-message EchoResponse {
-  string payload = 2;
-}
-```
-
-## Configuration Setup
-
-Update your `easyp.yaml` configuration file to include the necessary dependencies and plugins:
-
-```yaml
-deps:  # [!code ++]
-  - github.com/googleapis/googleapis  # [!code ++]
-
-generate:
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-    - name: grpc-gateway  # [!code ++]
-      out: .  # [!code ++]
-      opts:  # [!code ++]
-        paths: source_relative  # [!code ++]
-    - name: openapiv2        # [!code ++]
-      out: .  # [!code ++]
-      opts: # [!code ++]
-        simple_operation_ids: false  # [!code ++]
-        generate_unbound_methods: false  # [!code ++]
-```
-
-The `deps` section lists dependencies required for proto file imports.
-In this case, we add `github.com/googleapis/googleapis`
-because it contains the `annotations.proto` file used in the proto service definition.
-
-### Updating Dependencies
-
-After updating your configuration file, run the following command to download the specified dependencies:
-
-```bash
-easyp mod update
-```
-
-For more details on managing dependencies, refer to the [Package Manager](../../package-manager/package-manager.md) section.
-
-## Generating Code
-
-To generate the code, use the following command:
-
-```bash
-easyp --cfg easyp.yaml generate
-```
-
-If the `--cfg` flag is not specified, the `easyp.yaml` file in the current directory will be used by default:
-
-```bash
-easyp generate
-```
-
-Now you have the generated Go and gRPC-Gateway code, which you can interact with directly. 
diff --git a/docs/dist/docs/guide/cli/generator/examples/validate.md b/docs/dist/docs/guide/cli/generator/examples/validate.md
deleted file mode 100644
index 08d8b831..00000000
--- a/docs/dist/docs/guide/cli/generator/examples/validate.md
+++ /dev/null
@@ -1,90 +0,0 @@
-# Validate
-
-## Installing Plugins
-
-First, install the necessary plugins for working with gRPC:
-
-```shell
-go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
-go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
-go install github.com/envoyproxy/protoc-gen-validate@latest
-```
-
-These commands will install the `protoc-gen-go` and `protoc-gen-go-grpc` and `protoc-gen-validate` plugins for use with EasyP.
-
-## Example Proto Service
-
-Here is an example proto file for an Echo service:
-
-```proto
-syntax = "proto3";
-
-package api.echo.v1;
-
-import "validate/validate.proto";
-
-option go_package = "github.com/easyp-tech/example/api/echo/v1;pb";
-
-service EchoAPI {
-  rpc Echo(EchoRequest) returns (EchoResponse);
-  rpc EchoStream(EchoStreamRequest) returns (EchoResponse);
-}
-
-message EchoRequest {
-  string payload = 1 [(validate.rules).string = {max_len: 200}];
-}
-
-message EchoResponse {
-  string payload = 2;
-}
-
-message EchoStreamRequest {
-  string payload = 1 [(validate.rules).string = {max_len: 200}];
-}
-
-message EchoStreamResponse {
-  string payload = 2;
-}
-```
-
-## Configuration Setup
-
-Create and configure the easyp.yaml configuration file:
-
-```yaml
-deps: # [!code ++]
-  - github.com/bufbuild/protoc-gen-validate  # [!code ++]
-
-generate:
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-    - name: validate
-      out: .
-      opts:
-        paths: source_relative
-        lang: "go"
-```
-
-## Generating Code
-
-To generate code, use the following command:
-
-```shell
-easyp --cfg easyp.yaml generate
-```
-
-If the --cfg flag is not specified, the easyp.yaml file in the current directory will be used by default:
-
-```shell
-easyp generate
-```
-
-Now you have the generated Go code, which you can interact with directly.
diff --git a/docs/dist/docs/guide/cli/generator/generator.md b/docs/dist/docs/guide/cli/generator/generator.md
deleted file mode 100644
index fcb3510b..00000000
--- a/docs/dist/docs/guide/cli/generator/generator.md
+++ /dev/null
@@ -1,1326 +0,0 @@
-# Generator
-
-[[toc]]
-
-EasyP includes a powerful generator that simplifies the process of generating code from proto files. By using YAML configurations, EasyP makes this process more user-friendly and intuitive compared to using the protoc command directly.
-
-## Key Features of the Generator
-
-1. **Simplified Code Generation**:
-    - Generate code from proto files using a `YAML` configuration.
-    - Avoid the need to write long and complex protoc commands.
-
-2. **Wrapper around protoc**:
-    - EasyP functions as a wrapper around protoc, providing a more convenient API through configuration files.
-    - Supports all options and plugins available in protoc.
-
-3. **Flexibility and Customization**:
-    - Use the same parameters as protoc plugins, directly in the configuration file.
-    - Support for multiple plugins and their parameters in a single configuration.
-
-4. **Generate Code from Multiple Sources**:
-    - Generate code from local directories or remote repositories.
-    - Easily integrate with existing projects and repositories.
-
-5. **Remote Generation**:
-    - Generate code from remote Git repositories without local checkout.
-
-6. **Package Manager Integration**:
-    - Seamless integration with EasyP's package manager for dependency management.
-    - Automatic resolution and inclusion of proto dependencies.
-
-## Configuration Reference
-
-### Complete Configuration Example
-
-```yaml
-# Package manager dependencies
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-  - github.com/bufbuild/protoc-gen-validate@v0.10.1
-
-# Code generation configuration
-generate:
-  inputs:
-    # Local directory input
-    - directory: 
-        path: "proto"
-        root: "."
-    
-    # Remote Git repository input
-    - git_repo:
-        url: "github.com/acme/weather@v1.2.3"
-        sub_directory: "proto/api"
-    # Another remote repository
-    - git_repo:
-        url: "https://github.com/company/internal-protos.git"
-        sub_directory: "definitions"
-  plugins:
-    # Local plugin execution
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        module: github.com/mycompany/myproject
-      with_imports: true
-    
-    # Local plugin with custom options
-    - name: go-grpc
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-
-  # Managed mode - automatically set file and field options
-  managed:
-    enabled: true
-    disable:
-      - module: github.com/googleapis/googleapis  # Disable for specific module
-    override:
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-      - file_option: java_package_prefix
-        value: com.mycompany
-      - file_option: csharp_namespace_prefix
-        value: MyCompany
-      - field_option: jstype
-        value: JS_STRING
-        path: api/v1/  # Apply to specific path
-
-```
-
-### Input Sources
-
-#### Local Directory Input
-
-Local directory input is the most common and straightforward way to specify proto files for generation. Use this when your proto files are already present in your project directory structure.
-
-**When to use:**
-- Proto files are part of your project repository
-- You need full control over proto file organization
-- Working with a single service or application
-- Proto files don't change frequently
-
-```yaml
-inputs:
-  - directory: "proto"                    # Simple string format
-  
-  # OR detailed format
-  - directory:
-      path: "proto"                       # Path to proto files
-      root: "."                          # Root directory for import resolution
-```
-
-The `root` parameter is particularly useful in monorepo setups where you need to control import path resolution. When `root` is set to a parent directory, import paths in your proto files will be resolved relative to that root, not the current working directory.
-
-**Parameters:**
-
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `path` | string | ✅ | - | Path to the directory containing proto files |
-| `root` | string | ❌ | `"."` | Root directory used for import path resolution |
-
-**Examples:**
-
-These examples show the difference between basic directory specification and advanced configuration with custom import resolution:
-
-```yaml
-# Basic usage - Simple path specification
-inputs:
-  - directory: "api/proto"
-
-# Advanced usage with custom root - Controls import path resolution
-inputs:
-  - directory:
-      path: "services/auth/proto" 
-      root: "services/auth"        # Imports will be relative to this path
-```
-
-#### Remote Git Repository Input
-
-Remote Git repository input allows you to generate code from proto files hosted in external repositories without requiring a local checkout. This is particularly powerful for consuming APIs from other teams or external vendors.
-
-**When to use:**
-- Consuming proto definitions from other teams or services
-- Integrating with vendor APIs that provide proto definitions
-- Working with shared proto libraries across multiple projects
-- You want to ensure you're always using the correct version of external APIs
-
-**Recommended approach:**
-- Always pin to specific versions in production (`@v1.0.0`, not latest)
-- Use semantic versions when available for easier dependency management
-- Prefer public tags over commit hashes for better traceability
-
-```yaml
-inputs:
-  - git_repo:
-      url: "github.com/company/protos@v1.0.0"    # Required: Repository URL with optional version
-      sub_directory: "api"                        # Optional: Subdirectory within repo
-```
-
-The `root` parameter controls import resolution root for files from this repository.
-
-**Parameters:**
-
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `url` | string | ✅ | - | Git repository URL with optional version/tag/commit |
-| `sub_directory` | string | ❌ | `""` | Subdirectory within the repository containing proto files |
-| `root` | string | ❌ | `""` | Root path used for import resolution |
-
-**URL Format Options:**
-
-EasyP supports multiple URL formats to give you flexibility in how you reference remote repositories. Each format serves different use cases depending on your stability and versioning requirements:
-
-- **Tagged versions** are recommended for production as they provide stable, immutable references
-- **Semantic versions** offer better readability and dependency management
-- **Commit hashes** give you access to specific commits when tags aren't available
-- **Latest** should only be used in development environments due to unpredictability
-- **Full HTTPS URLs** are useful for private repositories or non-GitHub hosting
-
-```yaml
-# Tag version - Best for production stability
-url: "github.com/googleapis/googleapis@common-protos-1_3_1"
-
-# Semantic version - Easier dependency management
-url: "github.com/grpc-ecosystem/grpc-gateway@v2.19.1"  
-
-# Commit hash - When you need a specific commit
-url: "github.com/company/protos@abc123def456"
-
-# Latest - Development only, not recommended for production
-url: "github.com/company/protos"
-
-# Full HTTPS URL - For private repos or custom Git hosts
-url: "https://github.com/company/private-protos.git"
-```
-
-**Examples:**
-
-These examples demonstrate common patterns for consuming remote proto definitions from different types of repositories:
-
-```yaml
-# Public repository with specific version - Most common for external APIs
-inputs:
-  - git_repo:
-      url: "github.com/googleapis/googleapis@common-protos-1_3_1"
-      sub_directory: "google"
-# Private repository with authentication - For internal company APIs
-inputs:
-  - git_repo:
-      url: "github.com/mycompany/internal-protos@v2.1.0"
-      sub_directory: "api/definitions"
-# Multiple remote sources - Common in microservices architectures
-inputs:
-  - git_repo:
-      url: "github.com/grpc-ecosystem/grpc-gateway@v2.19.1"
-      sub_directory: "protoc-gen-openapiv2/options"
-  - git_repo:
-      url: "github.com/bufbuild/protoc-gen-validate@v0.10.1"  
-      sub_directory: "validate"
-```
-
-### Plugin Configuration
-
-Plugin configuration is where you specify which code generators to run and how they should behave. EasyP supports any protoc plugin, making it extremely flexible for different language ecosystems and use cases.
-
-At a high level, there are **four ways to specify how a plugin should be executed**:
-
-- **`name`** – run plugin by name from `PATH` or use a builtin plugin.
-- **`path`** – run plugin by absolute/relative path to an executable file.
-- **`remote`** – run plugin via remote URL (EasyP remote executor).
-- **`command`** – run plugin via arbitrary command (for example, `go run ...`).
-
-Only **one** of `name`, `path`, `remote`, or `command` must be specified for each plugin.
-
-#### Plugin by Name (`name`)
-
-Local plugin execution by name is the standard approach where plugins are installed on your system and executed directly by EasyP.
-
-**When to use `name`:**
-- Standard language support (Go, Python, TypeScript, etc.)
-- You have control over the build environment
-- Performance is critical (no network overhead)
-- You want to rely on PATH or builtin plugins
-
-**Installation requirements:**
-- Plugins must be installed and available in your PATH (if not using builtin plugins).
-- Plugin names follow the `protoc-gen-{name}` convention.
-- Use package managers (go install, npm install, pip install) for installation.
-
-```yaml
-plugins:
-  - name: go                              # Plugin name (must be installed locally or builtin)
-    out: ./generated                      # Output directory
-    opts:                                 # Plugin-specific options
-      paths: source_relative
-      module: github.com/mycompany/project
-    with_imports: true                    # Include dependency imports
-```
-
-The `with_imports` parameter is crucial when you're using dependencies from the package manager. Set it to `true` to include proto files from your `deps` section in the generation process.
-
-#### Plugin by Path (`path`)
-
-Sometimes you need to run a plugin from a specific binary without putting it into `PATH` (for example, a binary in your repo or in a build directory). In this case you can specify an explicit path:
-
-```yaml
-plugins:
-  - path: ./bin/protoc-gen-my-custom
-    out: ./gen/custom
-    opts:
-      foo: bar
-```
-
-**When to use `path`:**
-- You keep plugin binaries in the repository (for reproducible builds).
-- You use different plugin versions side-by-side.
-- You don't want to pollute the global `PATH`.
-
-#### Remote Plugin (`remote`)
-
-Remote plugins are executed via a remote URL. EasyP will send a `CodeGeneratorRequest` to the remote endpoint and receive a `CodeGeneratorResponse` back.
-
-Below is a real example of using the EasyP API Service as a remote plugin executor (same format as in the API Service docs):
-
-```yaml
-generate:
-  plugins:
-    # Remote plugin execution via EasyP API Service
-    - remote: api.easyp.tech/protobuf/go:v1.36.10
-      out: .
-      opts:
-        paths: source_relative
-
-    - remote: api.easyp.tech/grpc/go:v1.5.1
-      out: .
-      opts:
-        paths: source_relative
-```
-
-**Typical use cases for `remote`:**
-- Centralized plugin service inside your organization (e.g. EasyP API Service).
-- Running heavy plugins on a dedicated server instead of CI agents.
-- Sharing the same plugin implementation across multiple teams.
-
-#### Executing Plugin via Command (`command`)
-
-You can specify a plugin as an array of commands to execute. This is useful for running plugins via `go run` or any other tool without prior installation of the plugin binary:
-
-```yaml
-plugins:
-  - command: ["go", "run", "github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.25.1"]
-    out: ./gen/go
-    opts:
-      paths: source_relative
-```
-
-In this mode EasyP:
-- **builds and runs the command** you provide as a child process;
-- **writes `CodeGeneratorRequest` to stdin** of the process;
-- **reads `CodeGeneratorResponse` from stdout**, just like with regular protoc plugins.
-
-**Plugin Source Priority:**
-1. `command` — execute via specified command (highest priority)
-2. `remote` — remote plugin via URL
-3. `name` — local plugin from PATH or builtin plugin
-4. `path` — path to plugin executable file
-
-**Parameters (plugin sources and common options):**
-
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `name` | string | ❌ | - | Plugin name or identifier (e.g. `go`, `go-grpc`, `grpc-gateway`) |
-| `command` | []string | ❌ | - | Command to execute plugin (e.g., `["go", "run", "package"]`) |
-| `remote` | string | ❌ | - | Remote plugin URL |
-| `path` | string | ❌ | - | Path to plugin executable file |
-| `out` | string | ❌ | resolved generate root | Output directory for generated files |
-| `opts` | map[string](string \| number \| boolean \| array<string \| number \| boolean>) | ❌ | `{}` | Plugin-specific options; list values are emitted as repeated `key=value` params |
-| `with_imports` | bool | ❌ | `false` | Include proto files from dependencies |
-
-**Note:** Only one plugin source (`name`, `command`, `remote`, or `path`) must be specified for each plugin.
-If `opts.outputServices` is set to `["grpc-js", "generic-definitions"]`, EasyP sends `outputServices=grpc-js,outputServices=generic-definitions`.
-
-**Command source examples:**
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-
-  plugins:
-    # 1) gRPC-Gateway via go run (no pre-installed binary required)
-    - command: ["go", "run", "github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.25.1"]
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        generate_unbound_methods: true
-
-    # 2) protoc-gen-validate via go run
-    - command: ["go", "run", "github.com/bufbuild/protoc-gen-validate@v0.10.1"]
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        lang: go
-
-    # 3) Any custom wrapper script
-    - command: ["bash", "./scripts/custom-protoc-plugin.sh"]
-      out: ./gen/custom
-      opts:
-        foo: bar
-```
-
-#### Builtin Plugins
-
-EasyP includes builtin plugins for basic protobuf and gRPC languages. These plugins are embedded in the binary as WASM modules and do not require installation of external dependencies.
-
-**Benefits of builtin plugins:**
-- **Portability**: Single binary with all necessary plugins
-- **Convenience**: No need to install external dependencies
-- **Stability**: Plugin versions are fixed in the binary
-- **Isolation**: Independent of system plugin installations
-
-**Supported builtin plugins:**
-
-#### Protobuf Base Plugins
-
-The following plugins are builtin for generating base protobuf code:
-
-| Plugin Name | Description | Corresponding protoc Plugin |
-|-------------|-------------|----------------------------|
-| `cpp` | Generate C++ code from proto files | `protoc-gen-cpp` |
-| `csharp` | Generate C# code from proto files | `protoc-gen-csharp` |
-| `java` | Generate Java code from proto files | `protoc-gen-java` |
-| `kotlin` | Generate Kotlin code from proto files | `protoc-gen-kotlin` |
-| `objc` | Generate Objective-C code from proto files | `protoc-gen-objc` |
-| `php` | Generate PHP code from proto files | `protoc-gen-php` |
-| `python` | Generate Python code from proto files | `protoc-gen-python` |
-| `ruby` | Generate Ruby code from proto files | `protoc-gen-ruby` |
-
-#### gRPC Plugins
-
-The following plugins are builtin for generating gRPC code:
-
-| Plugin Name | Description | Corresponding protoc Plugin |
-|-------------|-------------|----------------------------|
-| `grpc_cpp` | Generate gRPC code for C++ | `grpc_cpp_plugin` |
-| `grpc_csharp` | Generate gRPC code for C# | `grpc_csharp_plugin` |
-| `grpc_java` | Generate gRPC code for Java | `grpc_java_plugin` |
-| `grpc_node` | Generate gRPC code for Node.js | `grpc_node_plugin` |
-| `grpc_objc` | Generate gRPC code for Objective-C | `grpc_objective_c_plugin` |
-| `grpc_php` | Generate gRPC code for PHP | `grpc_php_plugin` |
-| `grpc_python` | Generate gRPC code for Python | `grpc_python_plugin` |
-| `grpc_ruby` | Generate gRPC code for Ruby | `grpc_ruby_plugin` |
-
-**Plugin Selection Logic:**
-
-EasyP uses the following priority when selecting an executor for a plugin:
-
-1. **Remote plugin** (if `url` is specified) — always has the highest priority
-2. **Builtin plugin** (if plugin is builtin and not found in PATH) — used automatically
-3. **Local plugin** (from PATH) — used by default for backward compatibility
-
-**Usage Example:**
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    # Builtin Python plugin (automatically used if protoc-gen-python is not found in PATH)
-    - name: python
-      out: ./gen/python
-      opts:
-        pyi_out: ./gen/python
-    
-    # Builtin gRPC plugin for Python
-    - name: grpc_python
-      out: ./gen/python
-    
-    # Builtin C++ plugin (automatically used if protoc-gen-cpp is not found in PATH)
-    - name: cpp
-      out: ./gen/cpp
-      opts:
-        dllexport_decl: EXPORT
-    
-    # Builtin gRPC plugin for C++
-    - name: grpc_cpp
-      out: ./gen/cpp
-```
-
-**Requirements:**
-
-Builtin plugins are included in the EasyP binary:
-
-```bash
-# Build
-go build ./cmd/easyp
-
-# Install
-go install github.com/easyp-tech/easyp/cmd/easyp@latest
-```
-
-**Backward Compatibility:**
-
-Builtin plugins are fully compatible with existing configurations. If a plugin is found in PATH, it will be used instead of the builtin one. This ensures that:
-
-- Existing configurations continue to work without changes
-- You can override a builtin plugin by installing it in your system
-- Priority is given to local installations for flexibility
-
-### Plugin Options Reference
-
-This section covers the most commonly used plugins and their configuration options. Each plugin has specific parameters that control how code is generated, and understanding these options is crucial for getting the output you need.
-
-#### Go Plugins
-
-Go plugins are the most mature and widely used protoc plugins. The `paths` option controls how import paths are resolved, while other options provide fine-grained control over the generated code:
-
-```yaml
-plugins:
-  # protoc-gen-go - Generates Go structs and basic protobuf functionality
-  - name: go
-    out: ./gen/go
-    opts:
-      paths: source_relative              # source_relative | import
-      module: github.com/company/project  # Go module path for import generation
-      
-  # protoc-gen-go-grpc - Generates gRPC service stubs and clients
-  - name: go-grpc
-    out: ./gen/go
-    opts:
-      paths: source_relative
-      require_unimplemented_servers: false  # Generate UnimplementedServer embedding
-```
-
-#### gRPC-Gateway Plugins
-
-gRPC-Gateway plugins enable you to serve gRPC services as REST APIs and generate OpenAPI documentation. These are essential for building HTTP/JSON APIs from gRPC services:
-
-```yaml
-plugins:
-  # protoc-gen-grpc-gateway - Generates REST-to-gRPC reverse proxy
-  - name: grpc-gateway
-    out: ./gen/go
-    opts:
-      paths: source_relative
-      generate_unbound_methods: true      # Include methods without HTTP bindings
-      
-  # protoc-gen-openapiv2 - Generates OpenAPI/Swagger documentation
-  - name: openapiv2  
-    out: ./gen/openapi
-    opts:
-      simple_operation_ids: true          # Use simple names for operation IDs
-      generate_unbound_methods: false     # Exclude methods without HTTP bindings
-      json_names_for_fields: true         # Use JSON names instead of proto names
-```
-
-#### Validation Plugins
-
-Validation plugins generate code that automatically validates proto message fields based on constraints defined in your proto files. This eliminates the need for manual validation code:
-
-```yaml
-plugins:
-  # protoc-gen-validate - Generates field validation code
-  - name: validate-go
-    out: ./gen/go
-    opts:
-      paths: source_relative
-      lang: go                           # Target language for validation code
-```
-
-#### TypeScript/JavaScript Plugins
-
-TypeScript plugins are essential for frontend development, providing type-safe interfaces for your proto definitions and gRPC services in web applications:
-
-```yaml
-plugins:
-  # protoc-gen-ts - Generates TypeScript definitions and serialization
-  - name: ts
-    out: ./gen/typescript  
-    opts:
-      declaration: true                   # Generate .d.ts type definition files
-      target: es2017                     # ECMAScript target for compatibility
-      
-  # protoc-gen-grpc-web - Generates gRPC-Web clients for browsers
-  - name: grpc-web
-    out: ./gen/web
-    opts:
-      import_style: typescript           # Module system for generated code
-      mode: grpcweb                      # Transport mode for gRPC-Web
-```
-
-## Managed Mode
-
-Managed mode automatically sets file and field options in your protobuf descriptors during code generation without modifying the original `.proto` files. This feature is compatible with `buf`'s managed mode and provides a consistent way to manage language-specific options across your codebase.
-
-**Key benefits:**
-- **No proto file modifications**: Options are applied at generation time, keeping your proto files clean
-- **Consistent defaults**: Automatic application of language-specific naming conventions
-- **Centralized configuration**: Manage all options in one place (`easyp.yaml`)
-- **Module-specific rules**: Apply different options to different modules or paths
-- **buf compatibility**: Works the same way as `buf` managed mode
-
-### How It Works
-
-When managed mode is enabled, EasyP automatically applies file and field options to your protobuf descriptors before code generation. This happens in memory, so your original `.proto` files remain unchanged.
-
-**Default values** are applied for certain options based on language conventions:
-- Java: `java_package_prefix` defaults to `"com"`, `java_multiple_files` defaults to `true`
-- C#: `csharp_namespace` defaults to PascalCase of package name
-- Ruby: `ruby_package` defaults to PascalCase with `::` separator
-- PHP: `php_namespace` defaults to PascalCase with `\` separator
-- Objective-C: `objc_class_prefix` defaults to first letters of package parts
-- C++: `cc_enable_arenas` defaults to `true`
-
-**Overrides** allow you to set specific values for options, with support for filtering by module, protobuf package, path, or field. Without `module`, `package`, or `path`, an override applies to all files in the generation request, including dependencies and `git_repo` inputs.
-
-**Disables** allow you to prevent managed mode from modifying specific options or files. This is the recommended way to exclude external dependencies that already define their own options.
-
-### Configuration
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    disable:
-      # Disable managed mode for specific module
-      - module: github.com/googleapis/googleapis
-      
-      # Disable specific option globally
-      - file_option: java_package_prefix
-
-      # Disable for specific protobuf package
-      - package: acme.weather.v1
-        file_option: java_package
-      
-      # Disable for specific path
-      - path: legacy/
-        file_option: go_package
-      
-      # Disable field option for specific field
-      - field_option: jstype
-        field: com.example.User.id
-    
-    override:
-      # Override go_package_prefix for all files
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-      
-      # Override for specific module
-      - file_option: java_package_prefix
-        value: com.mycompany
-        module: github.com/mycompany/internal-protos
-
-      # Override for specific protobuf package
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-        package: acme.weather.v1
-      
-      # Override for specific path
-      - file_option: csharp_namespace_prefix
-        value: MyCompany
-        path: api/v1/
-      
-      # Override for multiple files with same value using prefix path
-      # This matches both internal/cms/bmi.proto and internal/cms/bmi_service.proto
-      - file_option: go_package
-        value: spec/cms/bmi
-        path: "internal/cms/bmi"
-      
-      # Override field option for specific path
-      - field_option: jstype
-        value: JS_STRING
-        path: api/v1/
-      
-      # Override for specific field
-      - field_option: jstype
-        value: JS_NUMBER
-        field: com.example.User.big_id
-```
-
-### Supported File Options
-
-| Option | Description | Has Default? |
-|--------|-------------|--------------|
-| `go_package` | Go import path | ❌ |
-| `go_package_prefix` | Prefix for Go import paths | ❌ |
-| `java_package` | Java package name | ❌ |
-| `java_package_prefix` | Prefix for Java packages | ✅ (`"com"`) |
-| `java_package_suffix` | Suffix for Java packages | ❌ |
-| `java_multiple_files` | Generate multiple Java files | ✅ (`true`) |
-| `java_outer_classname` | Outer class name | ✅ (PascalCase + "Proto") |
-| `java_string_check_utf8` | UTF-8 validation | ❌ |
-| `csharp_namespace` | C# namespace | ✅ (PascalCase) |
-| `csharp_namespace_prefix` | Prefix for C# namespaces | ❌ |
-| `ruby_package` | Ruby module name | ✅ (PascalCase with `::`) |
-| `ruby_package_suffix` | Suffix for Ruby packages | ❌ |
-| `php_namespace` | PHP namespace | ✅ (PascalCase with `\`) |
-| `php_metadata_namespace` | PHP metadata namespace | ❌ |
-| `php_metadata_namespace_suffix` | Suffix for PHP metadata | ❌ |
-| `objc_class_prefix` | Objective-C class prefix | ✅ (First letters) |
-| `swift_prefix` | Swift prefix | ❌ |
-| `optimize_for` | Code generation optimization | ❌ |
-| `cc_enable_arenas` | C++ arena allocation | ✅ (`true`) |
-
-### Supported Field Options
-
-| Option | Description | Applies To |
-|--------|-------------|------------|
-| `jstype` | JavaScript type for 64-bit integers | `int64`, `uint64`, `sint64`, `fixed64`, `sfixed64` |
-
-### Examples
-
-#### Basic Setup with Defaults
-
-Enable managed mode to get automatic defaults for all supported languages:
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-    - name: java
-      out: ./gen/java
-    - name: csharp
-      out: ./gen/csharp
-  managed:
-    enabled: true
-```
-
-This will automatically:
-- Set `java_package` to `com.<package>` for all files
-- Set `java_multiple_files` to `true`
-- Set `csharp_namespace` to PascalCase of package name
-- Set `ruby_package` to PascalCase with `::` separator
-- And more...
-
-#### Custom Go Package Prefix
-
-Override the Go package prefix for your project:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-```
-
-This will set `go_package` to `github.com/mycompany/myproject/gen/go/<package>` for all files.
-
-#### Dynamic Go Package Paths with Markers
-
-For more complex path generation, you can use markers in `go_package_prefix` or `go_package` values:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      # Use file path directly (without .proto extension)
-      - file_option: go_package_prefix
-        value: github.com/mycompany/{{file_path}}
-      
-      # Use only directory path
-      - file_option: go_package_prefix
-        value: github.com/mycompany/{{file_dir}}
-      
-      # Remove prefix from directory path
-      - file_option: go_package_prefix
-        value: github.com/mycompany/{{file_dir_without:internal/}}
-      
-      # Remove prefix from full file path
-      - file_option: go_package_prefix
-        value: github.com/mycompany/{{file_path_without:internal/}}
-```
-
-**Available markers:**
-- `{{file_path}}` - Full file path without `.proto` extension
-  - Example: `internal/cms/as.proto` → `internal/cms/as`
-- `{{file_dir}}` - Directory path only, without filename
-  - Example: `internal/cms/as.proto` → `internal/cms`
-- `{{file_dir_without:prefix/}}` - Directory path with prefix removed, and base filename without `_service`/`_grpc` suffixes
-  - Example: `{{file_dir_without:internal/}}` for `internal/cms/as_service.proto` → `cms/as`
-- `{{file_path_without:prefix/}}` - Full file path with prefix removed
-  - Example: `{{file_path_without:internal/}}` for `internal/cms/as.proto` → `cms/as`
-
-#### Module-Specific Overrides
-
-Apply different options to different modules:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      # Default for all files
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-      
-      # Specific override for internal module
-      - file_option: go_package_prefix
-        value: github.com/mycompany/internal/gen/go
-        module: github.com/mycompany/internal-protos
-```
-
-`module` matches the EasyP module source exactly: the dependency or `git_repo.url` value before `@version` (for example `github.com/mycompany/internal-protos` or `https://github.com/mycompany/internal-protos`). It is not the Go module path from `go.mod`.
-
-`package` matches the protobuf `package` declaration exactly, for example `acme.weather.v1`.
-
-#### Package-Specific Overrides
-
-Apply different options to files from a specific protobuf package:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-      - file_option: go_package
-        package: acme.weather.v1
-        value: github.com/mycompany/myproject/gen/go/acme/weather/v1
-```
-
-#### Disabling for External Dependencies
-
-Disable managed mode for external dependencies that already have their options set:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    disable:
-      - module: github.com/googleapis/googleapis
-      - module: github.com/grpc-ecosystem/grpc-gateway
-```
-
-#### JavaScript Type Safety
-
-Set `jstype` to `JS_STRING` for all 64-bit integer fields to prevent precision loss in JavaScript:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      - field_option: jstype
-        value: JS_STRING
-        path: api/v1/  # Apply to specific path
-```
-
-### Path Matching
-
-Path matching in managed mode uses prefix-based matching (same as `buf`):
-
-- **Directory path** (ending with `/`): Matches all files in that directory and subdirectories
-  - Example: `path: "internal/cms/"` matches `internal/cms/as.proto`, `internal/cms/node.proto`, `internal/cms/v1/service.proto`
-- **Exact file path** (ending with `.proto`): Matches only that specific file
-  - Example: `path: "internal/cms/as.proto"` matches only `internal/cms/as.proto`
-- **Prefix path** (no trailing `/` or `.proto`): Uses prefix matching (not directory-aware)
-  - Example: `path: "internal/cms"` matches `internal/cms/as.proto` but also `internal/cmsv2/file.proto`
-
-### Rule Precedence
-
-When multiple rules match the same file or field, the following precedence applies:
-
-1. **Disable rules** take precedence - if an option is disabled, it won't be applied
-2. **Override rules** are applied in order - the last matching rule wins
-3. **Default values** are applied only if no override matches and the option isn't disabled
-
-### Compatibility with buf
-
-EasyP's managed mode is compatible with `buf`'s managed mode. The same configuration format and behavior apply, making it easy to migrate between tools or use both in the same workflow.
-
-## Descriptor Set Generation
-
-**https://protobuf.dev/programming-guides/techniques/#self-description**
-
-EasyP supports generating binary FileDescriptorSet files using the `--descriptor_set_out` flag. This allows you to create self-describing protobuf messages that include schema information alongside the data.
-
-**CLI flags:**
-
-- `--descriptor_set_out <path>` - Output path for the binary FileDescriptorSet
-- `--include_imports` - Include all transitive dependencies in the FileDescriptorSet
-
-**Example:**
-
-```bash
-# Generate descriptor set with only target files
-easyp generate --descriptor_set_out=./schema.pb
-
-# Generate descriptor set with all dependencies
-easyp generate --descriptor_set_out=./schema.pb --include_imports
-```
-
-Self-describing messages are useful for dynamic message parsing, runtime schema validation, schema registries, and building generic gRPC clients. For more information, see the [Protocol Buffers documentation on self-description](https://protobuf.dev/programming-guides/techniques/#self-description).
-
-## Package Manager Integration
-
-One of EasyP's most powerful features is the seamless integration between the package manager and code generator. This integration eliminates the common problem of managing proto dependencies manually and ensures that your generated code always has access to the correct versions of imported proto files.
-
-**Key benefits:**
-- **Automatic dependency resolution**: No need to manually manage proto import paths
-- **Version consistency**: Dependencies are locked to specific versions via `easyp.lock`
-- **Transitive dependencies**: EasyP handles dependencies of dependencies automatically
-- **Performance**: Local caching means dependencies are downloaded once and reused
-
-### Automatic Dependency Resolution
-
-When you define dependencies in the `deps` section, the generator automatically includes them in the proto path. This means your proto files can import from these dependencies without any additional configuration.
-
-**How it works:**
-1. EasyP downloads and caches dependencies based on your `deps` configuration
-2. During generation, these cached proto files are automatically added to the protoc import path
-3. Your proto files can import from dependencies using standard import statements
-4. Generated code includes both your local protos and dependency protos when `with_imports: true`
-
-Here's a simple example showing how dependency resolution works automatically. Notice that you only need to specify the dependencies once in the `deps` section:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-      with_imports: true    # This automatically includes googleapis and grpc-gateway protos
-```
-
-### Dependency Usage Examples
-
-The following examples demonstrate common patterns for integrating external proto dependencies into your code generation workflow.
-
-#### Using Google APIs
-
-Google APIs are among the most commonly used proto dependencies, providing standard types and annotations for REST APIs, field validation, and common data structures.
-
-**When to use Google APIs:**
-- Building REST APIs with gRPC-Gateway
-- Need standard types like `Timestamp`, `Duration`, `Any`
-- Want to use Google's field behavior annotations
-- Building services that integrate with Google Cloud
-
-This configuration shows the minimal setup needed to use Google APIs in your proto files:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-
-generate:
-  inputs:
-    - directory: "api/proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-      with_imports: true
-```
-
-**Important:** Always use a pinned version (like `common-protos-1_3_1`) rather than latest to ensure build reproducibility.
-
-Once configured, your proto files can import and use Google API definitions. Here's an example of a service using HTTP annotations:
-
-```proto
-// api/proto/service.proto
-syntax = "proto3";
-
-import "google/api/annotations.proto";
-import "google/protobuf/timestamp.proto";
-
-service MyService {
-  rpc GetData(GetDataRequest) returns (GetDataResponse) {
-    option (google.api.http) = {
-      get: "/v1/data"
-    };
-  }
-}
-```
-
-#### Using Validation Rules
-
-Protoc-gen-validate provides powerful field validation capabilities that can be embedded directly in your proto definitions, eliminating the need for separate validation logic in your application code.
-
-**When to use validation:**
-- Input validation for API endpoints
-- Database model constraints
-- Configuration file validation
-- Any scenario where data integrity is critical
-
-**Benefits:**
-- Validation rules are part of the proto definition (single source of truth)
-- Code generation creates validation functions automatically
-- Consistent validation across different languages
-- Better performance than runtime reflection-based validation
-
-```yaml
-deps:
-  - github.com/bufbuild/protoc-gen-validate@v0.10.1
-
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-      with_imports: true
-    - name: validate-go
-      out: ./gen/go  
-      opts:
-        paths: source_relative
-```
-
-**Note:** You need both the dependency (for proto imports) and the plugin (for code generation) to get full validation support.
-
-Here's how validation rules look in your proto files. The generated code will automatically validate these constraints:
-
-```proto
-// proto/user.proto
-syntax = "proto3";
-
-import "validate/validate.proto";
-
-message User {
-  string email = 1 [(validate.rules).string.email = true];
-  int32 age = 2 [(validate.rules).int32.gte = 0];
-}
-```
-
-#### Complex Multi-Dependency Setup
-
-This example demonstrates a production-ready configuration that combines multiple dependencies and plugins for a complete API development workflow:
-
-```yaml
-deps:
-  # Core Google APIs - Standard types and HTTP annotations
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  
-  # gRPC Gateway for REST APIs - Enables HTTP/JSON interfaces
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-  
-  # Validation rules - Field-level validation constraints
-  - github.com/bufbuild/protoc-gen-validate@v0.10.1
-  
-  # Company internal shared types - Common business objects
-  - github.com/mycompany/shared-protos@v1.5.0
-
-generate:
-  inputs:
-    - directory: "api/proto"
-  plugins:
-    # Go code generation - Core protobuf structures
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        module: github.com/mycompany/myservice
-      with_imports: true
-      
-    # gRPC service stubs - Server and client interfaces
-    - name: go-grpc
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-        
-    # REST Gateway - HTTP-to-gRPC proxy code
-    - name: grpc-gateway
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        
-    # OpenAPI documentation - API specification
-    - name: openapiv2
-      out: ./gen/openapi
-      opts:
-        simple_operation_ids: true
-        
-    # Validation code - Input validation functions
-    - name: validate-go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-```
-
-### Dependency Cache Integration
-
-The generator leverages EasyP's module cache for fast builds:
-
-```bash
-# Download dependencies once
-easyp mod download
-
-# Generate code (uses cached dependencies)
-easyp generate
-
-# Dependencies are cached in ~/.easyp/mod/
-ls ~/.easyp/mod/github.com/googleapis/googleapis/
-```
-
-## Remote Generation
-
-Remote generation is a powerful feature that allows you to generate code from proto files hosted in remote Git repositories without requiring a local checkout. This enables true microservices architecture where teams can consume each other's APIs without tight coupling.
-
-**Key advantages:**
-- **Decoupled development**: Teams can work independently while consuming each other's APIs
-- **Version control**: Pin to specific versions of external APIs for stability
-- **Reduced repository size**: No need to vendor or submodule external proto files
-- **Automatic updates**: Easy to update to newer versions when ready
-
-**Best practices:**
-- Always use tagged versions in production environments
-- Test with latest versions in development, but pin in production
-- Use semantic versioning when available for easier dependency management
-- Consider the network implications for CI/CD systems
-
-### Remote Proto Sources
-
-Generate from remote repositories directly. This is particularly useful in microservices architectures where different teams own different proto definitions.
-
-**Typical workflow:**
-1. Team A publishes proto definitions in a Git repository with proper versioning
-2. Team B references these protos in their `easyp.yaml` configuration
-3. During generation, EasyP automatically fetches and uses the remote protos
-4. Generated code includes client libraries for Team A's services
-
-Here's a practical example showing how to combine local and remote proto sources in a single generation configuration:
-
-```yaml
-generate:
-  inputs:
-    # Local protos - Your service's own API definitions
-    - directory: "proto"
-    
-    # Remote public repository - External vendor API
-    - git_repo:
-        url: "github.com/acme/weather-api@v2.1.0"
-        sub_directory: "proto/weather/v1"
-    # Remote private repository - Internal company API
-    - git_repo:
-        url: "github.com/mycompany/internal-apis@main"
-        sub_directory: "user-service/proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-      with_imports: true
-```
-
-
-
-### Remote Generation Use Cases
-
-These examples demonstrate real-world scenarios where remote generation provides significant value in distributed development environments.
-
-#### Multi-Team Development
-
-Multi-team development is where remote generation truly shines. Instead of coordinating shared repositories or complex dependency management, teams can independently evolve their APIs while consumers automatically get updates through versioned dependencies.
-
-This pattern is especially valuable in large organizations where:
-- Teams have different release cycles and development velocities
-- API ownership is clearly defined but consumption is widespread  
-- You want to avoid the overhead of coordinating shared proto repositories
-- Different teams use different technology stacks but need to communicate
-
-```yaml
-# Team A (Order Service) generates from Team B's proto definitions
-generate:
-  inputs:
-    # Local service definitions - APIs owned by this team
-    - directory: "proto/orders"
-    
-    # User service protos from another team - Stable, versioned API
-    - git_repo:
-        url: "github.com/company/user-service@v1.8.0"  
-        sub_directory: "api/proto"
-    # Payment service protos - Different team, different version
-    - git_repo:
-        url: "github.com/company/payment-service@v2.3.1"
-        sub_directory: "proto/payment/v2"  
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        module: github.com/company/order-service
-      with_imports: true
-```
-
-#### Vendor API Integration
-
-Many vendors now provide proto definitions for their APIs, enabling strongly-typed client generation instead of relying on hand-written HTTP clients. This approach provides better type safety, automatic serialization, and often better performance.
-
-Benefits of using vendor proto definitions:
-- **Type safety**: Compile-time checking of API calls and data structures
-- **Automatic updates**: New API features become available through version updates
-- **Consistency**: Same interface patterns across different vendor integrations
-- **Performance**: Binary serialization is often faster than JSON
-- **Documentation**: Proto files serve as authoritative API documentation
-
-```yaml
-# Generate clients for external vendor APIs
-generate:
-  inputs:
-    # Vendor's public proto definitions - Financial services
-    - git_repo:
-        url: "github.com/stripe/stripe-proto@v1.0.0"
-        sub_directory: "proto"
-    # Communication service APIs - SMS/Voice integration
-    - git_repo:  
-        url: "github.com/twilio/twilio-protos@v2.1.0"
-        sub_directory: "definitions"
-  plugins:
-    - name: go
-      out: ./clients/go
-      opts:
-        paths: source_relative
-        module: github.com/mycompany/integrations
-```
-
-
-
-## Commands
-
-The EasyP command-line interface provides flexible options for running code generation with different configurations and environments.
-
-### Basic Generation
-
-These are the most commonly used command patterns for everyday development and production use:
-
-```bash
-# Use default easyp.yaml configuration - Most common for development
-easyp generate
-
-# Use custom configuration file - Essential for multi-environment setups  
-easyp --cfg production.easyp.yaml generate
-
-# Generate with debug logs - Helpful for debugging and CI/CD
-easyp --debug generate
-
-# Generate with custom cache location - Useful for CI systems or shared environments
-EASYPPATH=/tmp/easyp-cache easyp generate
-```
-
-### Integration with Package Manager
-
-EasyP's package manager integration means you can either explicitly manage dependencies or let the generator handle them automatically. The explicit approach gives you more control, while the automatic approach is more convenient:
-
-```bash
-# Explicit workflow - Better for CI/CD and when you want to cache dependencies
-easyp mod download    # Download and cache dependencies first
-easyp generate        # Generate code using cached dependencies
-
-# Automatic workflow - Convenient for development (generate downloads dependencies automatically)
-easyp generate
-```
-
-### Advanced Usage
-
-These advanced usage patterns are useful for specific deployment scenarios, debugging, or when you need fine-grained control over the generation process:
-
-```bash
-# Generate from specific input directory - Override config file settings
-easyp generate --path=./api/proto
-
-# Generate using vendored dependencies - For offline builds or Docker containers
-easyp mod vendor
-easyp generate
-
-# Generate from a custom project root - Useful in monorepos or nested workdirs
-easyp generate --root=/usr/local/src/my-project --path=./api/proto
-```
-
-## Common Patterns
-
-These patterns represent real-world scenarios and best practices for organizing code generation in different project structures.
-
-
-
-### Multi-Language Generation
-
-Multi-language generation is essential for organizations using different technologies across their stack. EasyP makes it easy to generate consistent client libraries and types for multiple programming languages from the same proto definitions.
-
-**Common scenarios:**
-- **Full-stack applications**: Go/Java backend with TypeScript frontend for web apps
-- **Data platforms**: Go services with Python data science tools and analysis scripts  
-- **Microservices**: Different services implemented in optimal languages for their domain
-- **Client libraries**: Providing SDKs in multiple languages for external developers
-- **Legacy integration**: Modern gRPC services with legacy systems using different languages
-
-**Performance considerations:**
-- Each plugin runs independently, so generation time scales linearly with plugin count
-- Consider using parallel execution (`make -j4`) for large numbers of plugins
-- Output directories should be organized hierarchically to avoid file conflicts
-- Some plugins are faster than others - profile your build to identify bottlenecks
-
-**Maintenance benefits:**
-- Single source of truth for API definitions prevents schema drift
-- Consistent types across all languages reduce integration bugs
-- Automatic synchronization when proto definitions change eliminates manual updates
-- Reduced chance of API drift between different language implementations
-- Easier refactoring since changes propagate to all generated code
-
-This example shows a typical multi-language setup for a full-stack application with backend services, web frontend, data analysis, and documentation:
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-    
-  plugins:
-    # Go backend services - Primary implementation language
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        module: github.com/company/backend
-      with_imports: true
-      
-    - name: go-grpc  # gRPC server and client stubs
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        
-    # TypeScript frontend - Web application client code
-    - name: ts  
-      out: ./gen/typescript
-      opts:
-        declaration: true       # Generate type definitions
-        target: es2020         # Modern JavaScript for browsers
-        
-    # Python data science - Analytics and ML workflows
-    - name: python
-      out: ./gen/python
-      opts:
-        mypy_out: ./gen/python-stubs  # Type checking support
-        
-    # Documentation - API reference for developers
-    - name: doc
-      out: ./docs/api
-      opts:
-        markdown: true         # Generate markdown documentation
-```
-
-**Organization tip:** Use separate output directories for each language to avoid file conflicts and make it easier to integrate with language-specific build systems.
-
-
-
-
-
-The EasyP generator provides a comprehensive solution for protocol buffer code generation, supporting everything from simple local development to complex enterprise multi-language workflows with remote dependencies.
diff --git a/docs/dist/docs/guide/cli/linter/linter.md b/docs/dist/docs/guide/cli/linter/linter.md
deleted file mode 100644
index 40c5db58..00000000
--- a/docs/dist/docs/guide/cli/linter/linter.md
+++ /dev/null
@@ -1,418 +0,0 @@
-# Linter
-
-[[toc]]
-
-## Why Use a Linter for Proto Files?
-
-Linters play a crucial role in modern software development, particularly for proto files. By enforcing style and formatting rules, linters help maintain code quality, reduce potential bugs, and ensure that the codebase is clean and readable. This leads to several benefits:
-
-- **Reduced Development Costs:** Linters catch errors early in the development cycle, saving time and resources that would be spent on debugging and fixing issues later.
-- **Improved Team Collaboration:** A standardized codebase makes it easier for team members to understand and work with each other's code, facilitating a smoother collaborative environment.
-- **Business Efficiency:** Teams using linters often produce higher quality code, which translates to fewer production issues and maintenance costs. This makes businesses that adopt linting practices more competitive and cost-effective.
-
-## Configuration Reference
-
-EasyP linter provides flexible configuration options to adapt to different project requirements. All configuration is done through the `lint` section in your `easyp.yaml` file.
-
-### Complete Configuration Example
-
-```yaml
-lint:
-  # Rules and categories to use
-  use:
-    - MINIMAL
-    - BASIC
-    - COMMENT_SERVICE
-    - COMMENT_RPC
-  
-  # Custom suffixes for naming conventions
-  enum_zero_value_suffix: "UNSPECIFIED"
-  service_suffix: "Service"
-  
-  # Directory and rule exclusions
-  ignore:
-    - "vendor/"
-    - "third_party/"
-    - "legacy/old_protos/"
-  
-  except:
-    - COMMENT_FIELD
-    - COMMENT_MESSAGE
-  
-  # Comment-based rule ignoring
-  allow_comment_ignores: true
-  
-  # File-specific rule ignoring
-  ignore_only:
-    COMMENT_SERVICE: ["legacy/", "vendor/"]
-    SERVICE_SUFFIX: ["proto/external/"]
-```
-
-### Configuration Parameters
-
-#### `use` ([]string)
-Specifies which linter rules or rule categories to apply. You can mix individual rules with predefined categories.
-
-**Available categories:**
-- **MINIMAL**: Basic package consistency checks
-- **BASIC**: Naming conventions and usage patterns  
-- **DEFAULT**: Recommended rules for most projects
-- **COMMENTS**: Comment presence and formatting
-- **UNARY_RPC**: Restrictions on streaming RPCs
-
-**Individual rules**: Any specific rule name (e.g., `ENUM_PASCAL_CASE`, `FIELD_LOWER_SNAKE_CASE`)
-
-**Examples:**
-```yaml
-# Use predefined categories
-use: [MINIMAL, BASIC, DEFAULT]
-
-# Mix categories with individual rules
-use:
-  - MINIMAL
-  - COMMENT_SERVICE
-  - COMMENT_RPC
-  - ENUM_PASCAL_CASE
-
-# Use only specific rules
-use:
-  - PACKAGE_DEFINED
-  - SERVICE_PASCAL_CASE
-  - FIELD_LOWER_SNAKE_CASE
-```
-
-#### `enum_zero_value_suffix` (string)
-Defines the required suffix for zero-value enum entries. This enforces a consistent naming pattern for the default enum value.
-
-**Default**: Empty (no suffix required)
-**Common values**: `"UNSPECIFIED"`, `"UNKNOWN"`, `"DEFAULT"`
-
-**Example:**
-```yaml
-enum_zero_value_suffix: "UNSPECIFIED"
-```
-
-With this setting, enum definitions must follow this pattern:
-```proto
-enum Status {
-  STATUS_UNSPECIFIED = 0;  // Required suffix
-  STATUS_ACTIVE = 1;
-  STATUS_INACTIVE = 2;
-}
-```
-
-#### `service_suffix` (string)
-Specifies the required suffix for service names. This ensures consistent service naming across your project.
-
-**Default**: Empty (no suffix required)
-**Common values**: `"Service"`, `"API"`, `"Svc"`
-
-**Example:**
-```yaml
-service_suffix: "Service"
-```
-
-With this setting, service definitions must follow this pattern:
-```proto
-service UserService {     // Required "Service" suffix
-  rpc GetUser(...) returns (...);
-}
-```
-
-#### `ignore` ([]string)
-Lists directories or file paths to completely exclude from linting. Supports glob patterns and relative paths from the project root.
-
-**Use cases:**
-- Third-party or vendor proto files
-- Generated proto files
-- Legacy code being phased out
-- Test fixtures that intentionally violate rules
-
-**Examples:**
-```yaml
-ignore:
-  - "vendor/"                    # Exclude vendor directory
-  - "third_party/"              # Exclude third-party protos
-  - "testdata/"                 # Exclude test fixtures
-  - "proto/legacy/"             # Exclude legacy protos
-  - "**/*_test.proto"           # Exclude test proto files
-```
-
-#### `except` ([]string)
-Disables specific rules globally across the entire project. Use this when certain rules don't fit your project's conventions.
-
-**When to use:**
-- Legacy projects with established naming conventions
-- Projects with specific style requirements
-- Gradual adoption of linting rules
-
-**Examples:**
-```yaml
-except:
-  - COMMENT_FIELD              # Don't require field comments
-  - COMMENT_MESSAGE            # Don't require message comments
-  - SERVICE_SUFFIX             # Don't enforce service suffix
-  - ENUM_ZERO_VALUE_SUFFIX     # Don't enforce enum zero suffix
-```
-
-#### `allow_comment_ignores` (bool)
-Enables or disables the ability to ignore specific rules using inline comments in proto files.
-
-**Default**: `false`
-**Recommended**: `true` for flexibility during development
-
-**Example:**
-```yaml
-allow_comment_ignores: true
-```
-
-When enabled, you can use comments to ignore rules on specific elements:
-```proto
-// buf:lint:ignore COMMENT_SERVICE
-service LegacyUserAPI {
-  // nolint:COMMENT_RPC
-  rpc GetUser(...) returns (...);
-}
-```
-
-#### `ignore_only` (map[string][]string)
-Allows you to disable specific rules only for certain files or directories, while keeping them active elsewhere.
-
-**Use cases:**
-- Legacy code that can't be easily updated
-- Third-party protos with different conventions
-- Generated code that doesn't follow your style
-- Gradual migration strategies
-
-**Format**: `rule_name: [list_of_paths]`
-
-**Examples:**
-```yaml
-ignore_only:
-  # Don't require service comments in legacy directory
-  COMMENT_SERVICE: 
-    - "proto/legacy/"
-    - "vendor/"
-  
-  # Don't enforce service suffix for external APIs
-  SERVICE_SUFFIX:
-    - "proto/external/"
-    - "third_party/"
-  
-  # Allow old naming in specific files
-  FIELD_LOWER_SNAKE_CASE:
-    - "proto/legacy/old_messages.proto"
-    - "vendor/external_api.proto"
-```
-
-## Comment-Based Rule Ignoring
-
-When `allow_comment_ignores` is enabled, you can use inline comments to ignore specific linter rules for individual proto elements. This provides fine-grained control over rule enforcement.
-
-### Supported Comment Formats
-
-EasyP supports two comment formats for maximum compatibility:
-
-#### Buf-compatible format
-```proto
-// buf:lint:ignore RULE_NAME
-```
-
-#### EasyP native format  
-```proto
-// nolint:RULE_NAME
-```
-
-### Usage Examples
-
-#### Ignoring Service Rules
-```proto
-// buf:lint:ignore COMMENT_SERVICE
-// buf:lint:ignore SERVICE_SUFFIX  
-service UserAPI {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-}
-```
-
-#### Ignoring RPC Rules
-```proto
-service UserService {
-  // nolint:COMMENT_RPC
-  // nolint:RPC_REQUEST_STANDARD_NAME
-  rpc GetUserInfo(UserInfoReq) returns (UserInfoResp);
-}
-```
-
-#### Ignoring Message and Field Rules
-```proto
-// buf:lint:ignore COMMENT_MESSAGE
-message UserData {
-  // nolint:COMMENT_FIELD
-  // nolint:FIELD_LOWER_SNAKE_CASE
-  string userName = 1;
-}
-```
-
-#### Ignoring Enum Rules
-```proto
-// nolint:COMMENT_ENUM
-// nolint:ENUM_ZERO_VALUE_SUFFIX
-enum UserType {
-  UNKNOWN = 0;  // Would normally require suffix
-  ADMIN = 1;
-  USER = 2;
-}
-```
-
-#### Multiple Rules on One Line
-```proto
-// buf:lint:ignore COMMENT_SERVICE,SERVICE_SUFFIX
-service LegacyAPI {
-  // nolint:COMMENT_RPC,RPC_REQUEST_STANDARD_NAME
-  rpc getData(DataReq) returns (DataResp);
-}
-```
-
-### Best Practices for Comment Ignores
-
-#### Use Sparingly
-Comment ignores should be the exception, not the rule. Overuse indicates that your linting configuration may need adjustment.
-
-**Good:**
-```proto
-// Legacy service - buf:lint:ignore SERVICE_SUFFIX
-service UserAPI {
-  rpc GetUser(...) returns (...);
-}
-```
-
-**Bad:**
-```proto
-// nolint:COMMENT_SERVICE,SERVICE_SUFFIX,COMMENT_RPC
-service UserAPI {
-  // nolint:COMMENT_RPC,RPC_REQUEST_STANDARD_NAME
-  rpc getUser(...) returns (...);
-  // nolint:COMMENT_RPC,RPC_RESPONSE_STANDARD_NAME  
-  rpc updateUser(...) returns (...);
-}
-```
-
-#### Add Explanatory Comments
-Always explain why you're ignoring a rule to help future maintainers understand the decision.
-
-```proto
-// Third-party API compatibility requires non-standard naming
-// buf:lint:ignore SERVICE_SUFFIX
-service ExternalUserAPI {
-  // Legacy method name for backwards compatibility
-  // nolint:RPC_REQUEST_STANDARD_NAME
-  rpc getUserData(UserReq) returns (UserResp);
-}
-```
-
-#### Prefer Configuration Over Comments
-When multiple files need the same rule ignored, use `ignore_only` configuration instead of individual comments.
-
-**Instead of:**
-```proto
-// In file1.proto
-// buf:lint:ignore COMMENT_SERVICE
-service API1 { ... }
-
-// In file2.proto  
-// buf:lint:ignore COMMENT_SERVICE
-service API2 { ... }
-```
-
-**Use:**
-```yaml
-# In easyp.yaml
-lint:
-  ignore_only:
-    COMMENT_SERVICE: ["legacy/"]
-```
-
-## Linter Categories
-
-To accommodate different project needs and preferences, EasyP linter provides predefined rule categories. These categories group together various rules, allowing teams to quickly select the level of strictness or areas they want to focus on during linting.
-
-**When to use each category:**
-
-- **MINIMAL:** Essential for any proto project - ensures basic consistency and prevents fundamental issues
-- **BASIC:** Recommended for most projects - enforces common naming conventions and best practices  
-- **DEFAULT:** Additional quality checks - useful for mature projects with established workflows
-- **COMMENTS:** Documentation requirements - important for public APIs and team collaboration
-- **UNARY_RPC:** Streaming restrictions - use when your architecture requires only unary RPCs
-
-The available categories are:
-- **MINIMAL:** Basic checks to ensure package consistency.
-- **BASIC:** Additional checks for naming conventions and usage patterns.
-- **DEFAULT:** A set of default rules that most projects should use.
-- **COMMENTS:** Ensures that comments are present and properly formatted.
-- **UNARY_RPC:** Specific rules for unary RPC services.
-
-### Rule Groupings
-
-Below are the rule groupings under each category:
-
-#### MINIMAL
-
-- `DIRECTORY_SAME_PACKAGE`
-- `PACKAGE_DEFINED`
-- `PACKAGE_DIRECTORY_MATCH`
-- `PACKAGE_SAME_DIRECTORY`
-
-#### BASIC
-
-- `ENUM_FIRST_VALUE_ZERO`
-- `ENUM_NO_ALLOW_ALIAS`
-- `ENUM_PASCAL_CASE`
-- `ENUM_VALUE_UPPER_SNAKE_CASE`
-- `FIELD_LOWER_SNAKE_CASE`
-- `IMPORT_NO_PUBLIC`
-- `IMPORT_NO_WEAK`
-- `IMPORT_USED`
-- `MESSAGE_PASCAL_CASE`
-- `ONEOF_LOWER_SNAKE_CASE`
-- `PACKAGE_LOWER_SNAKE_CASE`
-- `PACKAGE_SAME_CSHARP_NAMESPACE`
-- `PACKAGE_SAME_GO_PACKAGE`
-- `PACKAGE_SAME_JAVA_MULTIPLE_FILES`
-- `PACKAGE_SAME_JAVA_PACKAGE`
-- `PACKAGE_SAME_PHP_NAMESPACE`
-- `PACKAGE_SAME_RUBY_PACKAGE`
-- `PACKAGE_SAME_SWIFT_PREFIX`
-- `RPC_PASCAL_CASE`
-- `SERVICE_PASCAL_CASE`
-
-#### DEFAULT
-
-- `ENUM_VALUE_PREFIX`
-- `ENUM_ZERO_VALUE_SUFFIX`
-- `FILE_LOWER_SNAKE_CASE`
-- `RPC_REQUEST_RESPONSE_UNIQUE`
-- `RPC_REQUEST_STANDARD_NAME`
-- `RPC_RESPONSE_STANDARD_NAME`
-- `PACKAGE_VERSION_SUFFIX`
-- `SERVICE_SUFFIX`
-
-#### COMMENTS
-
-- `COMMENT_ENUM`
-- `COMMENT_ENUM_VALUE`
-- `COMMENT_FIELD`
-- `COMMENT_MESSAGE`
-- `COMMENT_ONEOF`
-- `COMMENT_RPC`
-- `COMMENT_SERVICE`
-
-#### UNARY_RPC
-
-- `RPC_NO_CLIENT_STREAMING`
-- `RPC_NO_SERVER_STREAMING`
-
-## Conclusion
-
-Adopting the EasyP linter for your proto files can significantly enhance your development workflow, code quality, 
-and overall project maintainability. With full compatibility with the Buf linter, teams can easily migrate and start benefiting
-from our tool's robust features and flexible configuration options.
\ No newline at end of file
diff --git a/docs/dist/docs/guide/cli/linter/rules/comment-enum-value.md b/docs/dist/docs/guide/cli/linter/rules/comment-enum-value.md
deleted file mode 100644
index c82b0f95..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/comment-enum-value.md
+++ /dev/null
@@ -1,34 +0,0 @@
-# COMMENT_ENUM_VALUE
-
-Categories:
-
-- **COMMENT**
-
-This rule checks that enum values have a comment.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    BAR = 0;
-    BAZ = 1;
-}
-```
-
-### Good
-
-```proto
-
-syntax = "proto3";
-
-enum Foo {
-    // BAR value for bar logic // [!code focus]
-    BAR = 0; 
-    // BAZ value for baz logic // [!code focus]
-    BAZ = 1; 
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/comment-enum.md b/docs/dist/docs/guide/cli/linter/rules/comment-enum.md
deleted file mode 100644
index ec908792..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/comment-enum.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# COMMENT_ENUM
-
-Categories:
-
-- **COMMENT**
-
-This rule checks that enum has a comment.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    BAR = 0;
-    BAZ = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-// Foo enum for bar and baz logic // [!code focus]
-enum Foo {
-    BAR = 0; 
-    BAZ = 1; 
-}
-```
\ No newline at end of file
diff --git a/docs/dist/docs/guide/cli/linter/rules/comment-field.md b/docs/dist/docs/guide/cli/linter/rules/comment-field.md
deleted file mode 100644
index 6c0abbbb..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/comment-field.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# COMMENT_FIELD
-
-Categories:
-
-- **COMMENT**
-
-This rule checks that all message fields have a comment.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    string bar = 1;
-    string baz = 2;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    // bar field for bar logic // [!code focus]
-    string bar = 1; 
-    // baz field for baz logic // [!code focus]
-    string baz = 2; 
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/comment-message.md b/docs/dist/docs/guide/cli/linter/rules/comment-message.md
deleted file mode 100644
index 10f2bdb6..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/comment-message.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# COMMENT_MESSAGE
-
-Categories:
-
-- **COMMENT**
-
-This rule checks that message has a comment.
-
-## Examples
-
-### Bad
-
-```proto
-
-syntax = "proto3";
-
-message Foo {
-    string bar = 1;
-    string baz = 2;
-}
-```
-
-### Good
-
-```proto
-
-syntax = "proto3";
-
-// Foo message for bar and baz logic // [!code focus]
-message Foo {
-    // bar field for bar logic 
-    string bar = 1; 
-    // baz field for baz logic
-    string baz = 2; 
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/comment-oneof.md b/docs/dist/docs/guide/cli/linter/rules/comment-oneof.md
deleted file mode 100644
index 7e37fb86..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/comment-oneof.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# COMMENT_ONEOF
-
-Categories:
-
-- **COMMENT**
-
-This rule checks that oneof has a comment.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    oneof bar {
-        string baz = 1;
-        string qux = 2;
-    }
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    // bar oneof for baz and qux logic // [!code focus]
-    oneof bar {
-        string baz = 1; 
-        string qux = 2; 
-    }
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/comment-rpc.md b/docs/dist/docs/guide/cli/linter/rules/comment-rpc.md
deleted file mode 100644
index 24a64bb2..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/comment-rpc.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# COMMENT_RPC
-
-Categories:
-
-- **COMMENT**
-
-This rule checks that rpc has a comment.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (BarResponse) {}
-    rpc Baz (BazRequest) returns (BazResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    // Bar rpc for bar logic // [!code focus]
-    rpc Bar (BarRequest) returns (BarResponse) {}
-    // Baz rpc for baz logic // [!code focus]
-    rpc Baz (BazRequest) returns (BazResponse) {}
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/comment-service.md b/docs/dist/docs/guide/cli/linter/rules/comment-service.md
deleted file mode 100644
index 15beb817..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/comment-service.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# COMMENT_SERVICE
-
-Categories:
-
-- **COMMENT**
-
-This rule checks that service has a comment.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (BarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-// Foo service for bar logic // [!code focus]
-service Foo {
-    // Bar rpc for bar logic 
-    rpc Bar (BarRequest) returns (BarResponse) {}
-}
-```
-
-
diff --git a/docs/dist/docs/guide/cli/linter/rules/directory-same-package.md b/docs/dist/docs/guide/cli/linter/rules/directory-same-package.md
deleted file mode 100644
index 207f7b4f..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/directory-same-package.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# DIRECTORY_SAME_PACKAGE
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files in a given directory are in the same package.
-
-## Examples
-
-### Bad
-
-```proto
-// File: dir/foo.proto
-
-syntax = "proto3";
-   
-package foo;
-
-message Foo {
-    string bar = 1;
-}
-```
-
-### Good
-
-```proto
-// File: dir/foo/foo.proto // [!code focus]
-
-syntax = "proto3";
-
-package dir.foo; // [!code focus]
-
-message Foo {
-    string bar = 1;
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/enum-first-value-zero.md b/docs/dist/docs/guide/cli/linter/rules/enum-first-value-zero.md
deleted file mode 100644
index fb1e90d3..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/enum-first-value-zero.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# ENUM_FIRST_VALUE_ZERO
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that the first value of an enum is zero.
-
-## Examples
-
-### Bad
-
-```proto
-
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    BAR = 1;
-    BAZ = 2;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    BAR = 0; // [!code focus]
-    BAZ = 1;
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/enum-no-allow-alias.md b/docs/dist/docs/guide/cli/linter/rules/enum-no-allow-alias.md
deleted file mode 100644
index b352c45e..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/enum-no-allow-alias.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# ENUM_NO_ALLOW_ALIAS
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that the `allow_alias` option is not set to `true` in an enum.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    option allow_alias = true; // [!code focus]
-    BAR = 0;
-    BAZ = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    BAR = 0;
-    BAZ = 1;
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/enum-pascal-case.md b/docs/dist/docs/guide/cli/linter/rules/enum-pascal-case.md
deleted file mode 100644
index 7e42519e..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/enum-pascal-case.md
+++ /dev/null
@@ -1,37 +0,0 @@
-# ENUM_PASCAL_CASE
-
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that enum names are in PascalCase.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum foo_bar {
-    BAR = 0;
-    BAZ = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum FooBar { // [!code focus]
-    BAR = 0;
-    BAZ = 1;
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/enum-value-prefix.md b/docs/dist/docs/guide/cli/linter/rules/enum-value-prefix.md
deleted file mode 100644
index 0ee42f23..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/enum-value-prefix.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# ENUM_VALUE_PREFIX
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all enum values are prefixed with the enum name.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    BAR = 0;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    FOO_BAR = 0; // [!code focus]
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/enum-value-upper-snake-case.md b/docs/dist/docs/guide/cli/linter/rules/enum-value-upper-snake-case.md
deleted file mode 100644
index bbb13a04..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/enum-value-upper-snake-case.md
+++ /dev/null
@@ -1,37 +0,0 @@
-# ENUM_VALUE_UPPER_SNAKE_CASE
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that enum values are in UPPER_SNAKE_CASE.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    barName = 0;
-    bazName = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    BAR_NAME = 0; // [!code focus]
-    BAZ_NAME = 1; // [!code focus]
-}
-```
-
diff --git a/docs/dist/docs/guide/cli/linter/rules/enum-zero-value-suffix.md b/docs/dist/docs/guide/cli/linter/rules/enum-zero-value-suffix.md
deleted file mode 100644
index b23a7aae..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/enum-zero-value-suffix.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# ENUM_ZERO_VALUE_SUFFIX
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all enum zero values are suffixed with `_NONE` or your custom suffix.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    BAR = 0;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    FOO_BAR_NONE = 0; // [!code focus]
-}
-```
-
-
diff --git a/docs/dist/docs/guide/cli/linter/rules/field-lower-snake-case.md b/docs/dist/docs/guide/cli/linter/rules/field-lower-snake-case.md
deleted file mode 100644
index 464b69b5..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/field-lower-snake-case.md
+++ /dev/null
@@ -1,34 +0,0 @@
-# FIELD_LOWER_SNAKE_CASE
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that field names of messages are in lower_snake_case.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    string BarName = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    string bar_name = 1; // [!code focus]
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/file-lower-snake-case.md b/docs/dist/docs/guide/cli/linter/rules/file-lower-snake-case.md
deleted file mode 100644
index edf5735a..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/file-lower-snake-case.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# FILE_LOWER_SNAKE_CASE
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files are in lower_snake_case.
-
-## Examples
-
-### Bad
-
-```proto
-// File: bar/FooBaz.proto
-
-syntax = "proto3";
-```
-
-### Good
-
-```proto
-// File: bar/foo_baz.proto // [!code focus]
-
-syntax = "proto3";
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/import-no-public.md b/docs/dist/docs/guide/cli/linter/rules/import-no-public.md
deleted file mode 100644
index 4df55a20..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/import-no-public.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# IMPORT_NO_PUBLIC
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that no public imports are used in a proto file.
-
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-import public "bar.proto";
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-import "bar.proto"; // [!code focus]
-```
-
diff --git a/docs/dist/docs/guide/cli/linter/rules/import-no-weak.md b/docs/dist/docs/guide/cli/linter/rules/import-no-weak.md
deleted file mode 100644
index c2a0a0fd..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/import-no-weak.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# IMPORT_NO_WEAK
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that no weak imports are used in a proto file.
-
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto2";
-
-package foo;
-
-import weak "bar.proto";
-```
-
-### Good
-
-```proto
-syntax = "proto2";
-
-package foo;
-
-import "bar.proto"; // [!code focus]
-```
-
diff --git a/docs/dist/docs/guide/cli/linter/rules/import-used.md b/docs/dist/docs/guide/cli/linter/rules/import-used.md
deleted file mode 100644
index 1e4daa84..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/import-used.md
+++ /dev/null
@@ -1,34 +0,0 @@
-# IMPORT_USED
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all imports are used in a proto file.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-import "bar.proto";
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-import "bar.proto"; // [!code focus]
-
-message Foo {
-    bar.Bar bar = 1; // [!code focus]
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/message-pascal-case.md b/docs/dist/docs/guide/cli/linter/rules/message-pascal-case.md
deleted file mode 100644
index 36edaac2..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/message-pascal-case.md
+++ /dev/null
@@ -1,34 +0,0 @@
-# MESSAGE_PASCAL_CASE
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that message names are in PascalCase.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message foo_bar {
-    string bar_name = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message FooBar { // [!code focus]
-    string bar_name = 1;
-}
-```
\ No newline at end of file
diff --git a/docs/dist/docs/guide/cli/linter/rules/oneof-lower-snake-case.md b/docs/dist/docs/guide/cli/linter/rules/oneof-lower-snake-case.md
deleted file mode 100644
index a24faea5..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/oneof-lower-snake-case.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# ONEOF_LOWER_SNAKE_CASE
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that oneof names are in lower_snake_case.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    oneof BarName {
-        string bar_name = 1;
-    }
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    oneof bar_name { // [!code focus]
-        string bar_name = 1;
-    }
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/package-defined.md b/docs/dist/docs/guide/cli/linter/rules/package-defined.md
deleted file mode 100644
index 72eb19c0..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/package-defined.md
+++ /dev/null
@@ -1,35 +0,0 @@
-
-# PACKAGE_DEFINED
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files have a package declaration.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    string bar = 1;
-}
-
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo; // [!code focus]
-
-message Foo {
-    string bar = 1;
-}
-```
-
diff --git a/docs/dist/docs/guide/cli/linter/rules/package-directory-match.md b/docs/dist/docs/guide/cli/linter/rules/package-directory-match.md
deleted file mode 100644
index 74be408f..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/package-directory-match.md
+++ /dev/null
@@ -1,39 +0,0 @@
-# PACKAGE_DIRECTORY_MATCH
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files are in a directory that matches their package name.
-
-## Examples
-
-### Bad
-
-```proto
-// File: bar/foo.proto
-
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    string bar = 1;
-}
-
-```
-
-### Good
-
-```proto
-// File: bar/foo.proto // [!code focus]
-
-syntax = "proto3";
-
-package bar; // [!code focus]
-
-message Foo {
-    string bar = 1;
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/package-lower-snake-case.md b/docs/dist/docs/guide/cli/linter/rules/package-lower-snake-case.md
deleted file mode 100644
index 2c34f2ed..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/package-lower-snake-case.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# PACKAGE_LOWER_SNAKE_CASE
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that package names are in lower_snake_case.
-
-## Examples
-
-### Bad
-
-```proto
-// File: bar/foo.proto
-syntax = "proto3";
-
-package FooBar;
-```
-
-### Good
-
-```proto
-// File: bar/foo.proto
-syntax = "proto3";
-
-package foo_bar; // [!code focus]
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/package-same-csharp-namespace.md b/docs/dist/docs/guide/cli/linter/rules/package-same-csharp-namespace.md
deleted file mode 100644
index 91a2b113..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/package-same-csharp-namespace.md
+++ /dev/null
@@ -1,56 +0,0 @@
-# PACKAGE_SAME_CSHARP_NAMESPACE
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same C# namespace.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option csharp_namespace = "Foo.Bar";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option csharp_namespace = "Foo.Baz";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto 
-
-syntax = "proto3";
-
-package pkg;
-
-option csharp_namespace = "Foo.Bar";
-```
-
-```proto
-
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option csharp_namespace = "Foo.Bar"; // [!code focus]
-```
-
diff --git a/docs/dist/docs/guide/cli/linter/rules/package-same-directory.md b/docs/dist/docs/guide/cli/linter/rules/package-same-directory.md
deleted file mode 100644
index 50274a4e..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/package-same-directory.md
+++ /dev/null
@@ -1,40 +0,0 @@
-# PACKAGE_SAME_DIRECTORY
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same directory.
-
-## Examples
-
-### Bad
-
-```proto
-// File: bar/foo.proto
-
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    string bar = 1;
-}
-
-```
-
-### Good
-
-```proto
-// File: bar/foo.proto // [!code focus]
-
-syntax = "proto3";
-
-package bar; // [!code focus]
-
-message Foo {
-    string bar = 1;
-}
-
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/package-same-go-package.md b/docs/dist/docs/guide/cli/linter/rules/package-same-go-package.md
deleted file mode 100644
index 54f60292..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/package-same-go-package.md
+++ /dev/null
@@ -1,56 +0,0 @@
-# PACKAGE_SAME_GO_PACKAGE
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same Go package.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option go_package = "example.com/foo/bar";
-
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option go_package = "example.com/foo/baz";
-
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option go_package = "example.com/foo/bar"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option go_package = "example.com/foo/bar"; // [!code focus]
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/package-same-java-multiple-files.md b/docs/dist/docs/guide/cli/linter/rules/package-same-java-multiple-files.md
deleted file mode 100644
index 9cebc6bc..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/package-same-java-multiple-files.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# PACKAGE_SAME_JAVA_MULTIPLE_FILES
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same Java package.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo";
-```
-
-```proto
-
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.bar";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo"; // [!code focus]
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/package-same-java-package.md b/docs/dist/docs/guide/cli/linter/rules/package-same-java-package.md
deleted file mode 100644
index a2439eed..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/package-same-java-package.md
+++ /dev/null
@@ -1,57 +0,0 @@
-# PACKAGE_SAME_JAVA_PACKAGE
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same Java package.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.bar";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo"; // [!code focus]
-```
-
-
diff --git a/docs/dist/docs/guide/cli/linter/rules/package-same-php-namespace.md b/docs/dist/docs/guide/cli/linter/rules/package-same-php-namespace.md
deleted file mode 100644
index a8fe8670..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/package-same-php-namespace.md
+++ /dev/null
@@ -1,56 +0,0 @@
-# PACKAGE_SAME_PHP_NAMESPACE
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same PHP namespace.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option php_namespace = "Foo\\Bar";
-
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option php_namespace = "Foo\\Baz";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option php_namespace = "Foo\\Bar"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option php_namespace = "Foo\\Bar"; // [!code focus]
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/package-same-ruby-package.md b/docs/dist/docs/guide/cli/linter/rules/package-same-ruby-package.md
deleted file mode 100644
index eb2cfce4..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/package-same-ruby-package.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# PACKAGE_SAME_RUBY_PACKAGE
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same Ruby package.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option ruby_package = "Foo";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option ruby_package = "Bar";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option ruby_package = "Foo"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option ruby_package = "Foo"; // [!code focus]
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/package-same-swift-prefix.md b/docs/dist/docs/guide/cli/linter/rules/package-same-swift-prefix.md
deleted file mode 100644
index 907a6924..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/package-same-swift-prefix.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# PACKAGE_SAME_SWIFT_PREFIX
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same Swift prefix.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option swift_prefix = "Foo";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option swift_prefix = "Bar";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option swift_prefix = "Foo"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option swift_prefix = "Foo"; // [!code focus]
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/package-version-suffix.md b/docs/dist/docs/guide/cli/linter/rules/package-version-suffix.md
deleted file mode 100644
index 43c500c0..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/package-version-suffix.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# PACKAGE_VERSION_SUFFIX
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that the package version suffix is `_vX` where `X` is a number of version.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;   
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo.v1; // [!code focus]
-```
-
-
diff --git a/docs/dist/docs/guide/cli/linter/rules/rpc-no-client-streaming.md b/docs/dist/docs/guide/cli/linter/rules/rpc-no-client-streaming.md
deleted file mode 100644
index 84f4f8c4..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/rpc-no-client-streaming.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# RPC_NO_CLIENT_STREAMING
-
-Categories:
-
-- **UNARY_RPC**
-
-This rule checks that rpc has no client streaming.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (stream BarRequest) returns (BarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus]
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/rpc-no-server-streaming.md b/docs/dist/docs/guide/cli/linter/rules/rpc-no-server-streaming.md
deleted file mode 100644
index 8ea8558a..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/rpc-no-server-streaming.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# RPC_NO_SERVER_STREAMING
-
-Categories:
-
-- **UNARY_RPC**
-
-This rule checks that rpc has no server streaming.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (stream BarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus]
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/rpc-pascal-case.md b/docs/dist/docs/guide/cli/linter/rules/rpc-pascal-case.md
deleted file mode 100644
index 31007997..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/rpc-pascal-case.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# RPC_PASCAL_CASE
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all RPC names are in PascalCase.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service foo_bar {
-    rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service FooBar {
-    rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} // [!code focus]
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/rpc-request-response-unique.md b/docs/dist/docs/guide/cli/linter/rules/rpc-request-response-unique.md
deleted file mode 100644
index d35a5e3c..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/rpc-request-response-unique.md
+++ /dev/null
@@ -1,35 +0,0 @@
-# RPC_REQUEST_RESPONSE_UNIQUE
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all RPC request and response messages are unique.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (FooRequest) returns (FooResponse) {}
-    rpc GetBar (FooRequest) returns (FooResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (FooRequest) returns (FooResponse) {} // [!code focus]
-    rpc GetBar (BarRequest) returns (BarResponse) {} // [!code focus]
-}
-```
-
-
diff --git a/docs/dist/docs/guide/cli/linter/rules/rpc-request-standard-name.md b/docs/dist/docs/guide/cli/linter/rules/rpc-request-standard-name.md
deleted file mode 100644
index c33768a7..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/rpc-request-standard-name.md
+++ /dev/null
@@ -1,30 +0,0 @@
-# RPC_REQUEST_STANDARD_NAME
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all RPC request messages are named `MethodRequest`.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (FooRequest) returns (FooResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (GetFooRequest) returns (FooResponse) {} // [!code focus]
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/rpc-response-standard-name.md b/docs/dist/docs/guide/cli/linter/rules/rpc-response-standard-name.md
deleted file mode 100644
index 0f7b9980..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/rpc-response-standard-name.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# RPC_RESPONSE_STANDARD_NAME
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all RPC response messages are named `MethodResponse`.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (GetFooRequest) returns (Foo) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (GetFooRequest) returns (GetFooResponse) {} // [!code focus]
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/service-pascal-case.md b/docs/dist/docs/guide/cli/linter/rules/service-pascal-case.md
deleted file mode 100644
index f30504f4..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/service-pascal-case.md
+++ /dev/null
@@ -1,30 +0,0 @@
-# SERVICE_PASCAL_CASE
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all service names are in PascalCase.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service foo_bar {
-    rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service FooBar { // [!code focus]
-    rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} 
-}
-```
diff --git a/docs/dist/docs/guide/cli/linter/rules/service-suffix.md b/docs/dist/docs/guide/cli/linter/rules/service-suffix.md
deleted file mode 100644
index af781ecc..00000000
--- a/docs/dist/docs/guide/cli/linter/rules/service-suffix.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# SERVICE_SUFFIX
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all services are suffixed with `Service` or your custom suffix.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar(BarRequest) returns (BarResponse);
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service FooService { // [!code focus]
-    rpc Bar(BarRequest) returns (BarResponse); 
-}
-```
-
diff --git a/docs/dist/docs/guide/cli/package-manager/easyp-vs-buf.md b/docs/dist/docs/guide/cli/package-manager/easyp-vs-buf.md
deleted file mode 100644
index 021e1ddd..00000000
--- a/docs/dist/docs/guide/cli/package-manager/easyp-vs-buf.md
+++ /dev/null
@@ -1,453 +0,0 @@
-# EasyP vs Buf Package Management
-
-[[toc]]
-
-This document provides a comprehensive comparison between EasyP's decentralized package management approach and Buf's centralized Buf Schema Registry (BSR) model, helping you understand the key differences and choose the right solution for your needs.
-
-## Architecture Comparison
-
-### EasyP: Decentralized Git-Based Approach
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                     EasyP Architecture                          │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│  Developer Machine           Git Repositories                   │
-│  ┌──────────────┐           ┌─────────────────┐                │
-│  │              │  clone/   │ github.com/     │                │
-│  │ ~/.easyp/    │◄─────────►│ googleapis/     │                │
-│  │ cache/       │  fetch    │ googleapis      │                │
-│  │              │           │                 │                │
-│  │ mod/         │           ├─────────────────┤                │
-│  │              │           │ company.com/    │                │
-│  └──────────────┘           │ internal-protos │                │
-│                              │                 │                │
-│                              ├─────────────────┤                │
-│                              │ gitlab.com/     │                │
-│                              │ team/shared     │                │
-│                              └─────────────────┘                │
-│                                                                 │
-│  ✅ Direct repository access                                    │
-│  ✅ No single point of failure                                  │
-│  ✅ Works with any Git hosting                                  │
-│  ✅ Complete control over dependencies                          │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-### Buf: Centralized Registry Approach
-
-```
-┌────────────────────────────────────────────────────────────────┐
-│                      Buf Architecture                          │
-├────────────────────────────────────────────────────────────────┤
-│                                                                │
-│  Developer Machine               Buf Schema Registry (BSR)     │
-│  ┌──────────────┐              ┌─────────────────────────────┐ │
-│  │              │   push/pull  │                             │ │
-│  │ ~/.cache/    │◄────────────►│  buf.build                  │ │
-│  │ bufcli/      │   modules    │                             │ │
-│  │              │              │ ┌─────────────────────────┐ │ │
-│  │              │              │ │ googleapis/googleapis   │ │ │
-│  │              │              │ ├─────────────────────────┤ │ │
-│  │              │              │ │ grpc/grpc               │ │ │
-│  │              │              │ ├─────────────────────────┤ │ │
-│  │              │              │ │ envoyproxy/protoc-gen-  │ │ │
-│  │              │              │ │ validate                │ │ │
-│  └──────────────┘              │ └─────────────────────────┘ │ │
-│                                │                             │ │
-│                                └─────────────────────────────┘ │
-│                                                                │
-│  ⚠️  Centralized dependency                                    │
-│  ⚠️  Single point of control                                   │
-│  ⚠️  Requires buf.build access                                 │
-│  ⚠️  Limited to BSR ecosystem                                  │
-│                                                                │
-└────────────────────────────────────────────────────────────────┘
-```
-
-## Key Differences Summary
-
-| Aspect | EasyP | Buf |
-|--------|-------|-----|
-| **Architecture** | Decentralized (Git-based) | Centralized (BSR registry) |
-| **Dependency Source** | Any Git repository | Buf Schema Registry only |
-| **Single Point of Failure** | No | Yes (buf.build) |
-| **Enterprise Deployment** | Fully air-gapped support | Requires BSR access or private BSR |
-| **Authentication** | Git credentials (SSH/HTTPS) | Buf tokens + Git credentials |
-| **Vendor Lock-in** | None | Buf ecosystem |
-| **Private Repositories** | Native Git support | Must publish to BSR first |
-| **Offline Support** | Full (via vendoring) | Limited (cached modules only) |
-| **Cost** | Free (uses existing Git) | Free tier + paid plans |
-| **Setup Complexity** | Minimal | Moderate (BSR setup) |
-
-## Detailed Feature Comparison
-
-### 1. Dependency Management Philosophy
-
-#### EasyP: "Any Git Repository is a Package"
-```yaml
-# Direct Git repository references
-deps:
-  - github.com/googleapis/googleapis@v1.2.3
-  - gitlab.company.com/protos/internal@v2.0.1
-  - git.example.com/team/shared-types@main
-```
-
-**Advantages:**
-- ✅ Use any existing Git repository immediately
-- ✅ No need to "publish" to a separate registry
-- ✅ Version control is the source of truth
-- ✅ Works with private Git servers out-of-the-box
-
-#### Buf: "Registry-First Approach"
-```yaml
-# buf.yaml - Must reference BSR modules
-version: v1
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/grpc/grpc
-  - buf.build/envoyproxy/protoc-gen-validate
-```
-
-**Advantages:**
-- ✅ Curated, high-quality modules
-- ✅ Rich metadata and documentation
-- ✅ Dependency graph visualization
-- ✅ Semantic versioning enforcement
-
-**Limitations:**
-- ❌ Must publish to BSR before use
-- ❌ Requires BSR account and authentication
-- ❌ Cannot reference arbitrary Git repositories directly
-
-### 2. Enterprise and Air-Gapped Environments
-
-#### EasyP: Full Air-Gap Support
-
-**Scenario**: Large enterprise with strict network policies
-
-```bash
-# 1. Initial setup (with internet)
-easyp mod download          # Downloads to ~/.easyp/
-easyp mod vendor           # Creates easyp_vendor/
-
-# 2. Transfer to air-gapped environment
-tar -czf easyp-deps.tar.gz ~/.easyp easyp_vendor/
-# ... transfer archive ...
-
-# 3. Air-gapped environment (no internet)
-tar -xzf easyp-deps.tar.gz
-export EASYPPATH=$PWD/.easyp
-easyp generate             # Works offline
-```
-
-**Benefits:**
-- ✅ Complete independence from external services
-- ✅ No need for internal registry infrastructure
-- ✅ Uses existing Git infrastructure
-- ✅ Simple file-based distribution
-
-#### Buf: Requires BSR Infrastructure
-
-**Scenario**: Same enterprise setup
-
-```bash
-# Option 1: Use buf.build (requires internet)
-buf mod download           # Must reach buf.build
-
-# Option 2: Set up private BSR (complex)
-# - Deploy BSR server infrastructure
-# - Migrate all modules to private BSR
-# - Configure authentication and access
-# - Maintain registry server
-```
-
-**Challenges:**
-- ❌ Requires constant internet access OR expensive private BSR
-- ❌ Complex infrastructure for private deployments
-- ❌ All modules must be re-published to private registry
-- ❌ Additional operational overhead
-
-### 3. Security and Control
-
-#### EasyP: Direct Control
-```yaml
-# Full control over dependency sources
-deps:
-  # Public repository - your choice of version
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-
-  # Internal repository - complete control
-  - gitlab.company.com/security/validated-protos@v1.0.0
-
-  # Specific commit for security fix
-  - github.com/bufbuild/protoc-gen-validate@abc123def456
-```
-
-**Security advantages:**
-- ✅ **No intermediary** - direct from source repository
-- ✅ **Audit trail** - Git commit history is the source of truth
-- ✅ **Cannot be "banned"** - no external party can revoke access
-- ✅ **Custom validation** - implement your own security scanning
-- ✅ **Fork protection** - easily fork and maintain dependencies
-
-#### Buf: Registry Dependency
-
-```yaml
-# Dependencies controlled by BSR
-deps:
-  - buf.build/googleapis/googleapis  # Controlled by Buf
-  - buf.build/grpc/grpc             # Could be removed/updated
-```
-
-**Security considerations:**
-- ⚠️ **Intermediary risk** - BSR controls what's available
-- ⚠️ **Account suspension** - Could lose access to dependencies
-- ⚠️ **Module removal** - Modules can be deleted from registry
-- ⚠️ **Update policies** - BSR may force updates or deprecations
-- ⚠️ **Third-party trust** - Must trust Buf's security practices
-
-### 4. Real-World Scenarios
-
-#### Scenario 1: Startup with Public Dependencies
-
-**EasyP Approach:**
-```yaml
-# Simple, direct references
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-```
-
-**Buf Approach:**
-```yaml
-# Requires understanding BSR module names
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/grpcecosystem/grpc-gateway
-```
-
-**Winner**: Tie - both work well for public dependencies
-
-#### Scenario 2: Enterprise with Mixed Public/Private Dependencies
-
-**EasyP Approach:**
-```yaml
-deps:
-  # Public
-  - github.com/googleapis/googleapis@v1.2.3
-
-  # Private (existing Git repos)
-  - github.com/mycompany/auth-protos@v2.0.0
-  - gitlab.enterprise.com/platform/shared-types@v1.5.1
-```
-
-**Buf Approach:**
-```yaml
-# All must be published to BSR first
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/mycompany/auth-protos      # Requires BSR publication
-  - buf.build/mycompany/shared-types     # Requires BSR publication
-```
-
-**Winner**: **EasyP** - no additional setup for private repos
-
-#### Scenario 3: Government/Defense Contractor (Air-Gapped)
-
-**EasyP Approach:**
-```bash
-# Internet-connected environment
-easyp mod vendor
-
-# Transfer to classified environment
-# Works immediately without any external dependencies
-```
-
-**Buf Approach:**
-```bash
-# Must deploy and maintain private BSR infrastructure
-# All modules must be re-published internally
-# Complex operational overhead
-```
-
-**Winner**: **EasyP** - significantly simpler air-gap deployment
-
-#### Scenario 4: Compliance and Auditing
-
-**EasyP Approach:**
-- ✅ **Direct audit trail**: Git commits show exact changes
-- ✅ **Compliance-friendly**: No external dependencies in production
-- ✅ **Reproducible**: Lock files pin exact Git commits
-- ✅ **Vulnerability management**: Direct control over security updates
-
-**Buf Approach:**
-- ⚠️ **Registry dependency**: Must audit BSR's security practices
-- ⚠️ **Third-party risk**: BSR is part of your compliance scope
-- ⚠️ **Limited control**: Cannot control when modules are updated/removed
-- ⚠️ **Audit complexity**: Must trace registry → Git → actual code
-
-**Winner**: **EasyP** - cleaner compliance story
-
-### 5. Cost and Infrastructure
-
-#### EasyP: Zero Additional Infrastructure
-
-**Costs:**
-- ✅ **$0** - Uses existing Git infrastructure
-- ✅ **No additional servers** to maintain
-- ✅ **No licensing fees** for registry software
-- ✅ **Scales with Git** - proven enterprise scalability
-
-**Infrastructure:**
-- Uses existing Git repositories (GitHub, GitLab, etc.)
-- Leverages existing authentication systems
-- No additional backup/disaster recovery needed
-
-#### Buf: Registry Infrastructure Costs
-
-**BSR Hosted (buf.build):**
-- ✅ Free tier available
-- ❌ Paid plans for private modules and teams
-- ❌ Subject to external pricing changes
-- ❌ Data locality concerns for some enterprises
-
-**Private BSR Deployment:**
-- ❌ Significant infrastructure costs (servers, databases, load balancers)
-- ❌ Operational overhead (monitoring, updates, backups)
-- ❌ Licensing costs for enterprise features
-- ❌ Additional disaster recovery planning
-
-### 6. Migration and Lock-in
-
-#### EasyP: No Lock-in
-
-**Migration FROM EasyP:**
-```yaml
-# EasyP dependencies are just Git repositories
-# Can easily migrate to any other system that supports Git
-deps:
-  - github.com/googleapis/googleapis@v1.2.3  # Standard Git reference
-```
-
-**Migration TO EasyP:**
-```bash
-# From any Git-based system
-# Just reference the same repositories directly
-```
-
-#### Buf: Potential Lock-in
-
-**Migration FROM Buf:**
-- ❌ Must identify original Git repositories for each BSR module
-- ❌ BSR-specific module names don't translate directly
-- ❌ May lose version history and metadata
-- ❌ Complex if heavily integrated with BSR ecosystem
-
-**Migration TO Buf:**
-- ❌ Must publish all dependencies to BSR first
-- ❌ Cannot reference Git repositories directly
-- ❌ Must adopt BSR workflow and tooling
-
-## When to Choose Each Solution
-
-### Choose EasyP When:
-
-✅ **Enterprise/Air-gapped environments**
-- Need to work without external dependencies
-- Strict compliance requirements
-- Air-gapped or classified networks
-
-✅ **Security-first organizations**
-- Want direct control over dependency sources
-- Need to audit entire supply chain
-- Concerned about third-party service risks
-
-✅ **Existing Git-heavy workflows**
-- Team already comfortable with Git
-- Extensive private repository usage
-- Want to minimize new tools/infrastructure
-
-✅ **Cost-sensitive projects**
-- Want to avoid additional licensing costs
-- Don't want infrastructure overhead
-- Need predictable, zero-cost scaling
-
-✅ **Mixed public/private dependencies**
-- Heavy use of internal Git repositories
-- Don't want to republish existing repos
-- Need flexibility in dependency sources
-
-### Choose Buf When:
-
-✅ **Heavy BSR ecosystem usage**
-- Already invested in Buf tooling (lint, breaking changes, generation)
-- Want curated, high-quality modules
-- Benefit from BSR's rich metadata and docs
-
-✅ **Collaborative development**
-- Need dependency graph visualization
-- Want centralized module discovery
-- Benefit from BSR's collaboration features
-
-✅ **Simple public-only dependencies**
-- Primarily use well-known public modules
-- Don't mind BSR dependency
-- Value the curated module experience
-
-✅ **Team new to protobuf**
-- Benefit from BSR's documentation and examples
-- Want guided module discovery
-- Prefer opinionated, structured approach
-
-## Migration Paths
-
-### Migrating from Buf to EasyP
-
-1. **Identify source repositories** for each BSR module
-2. **Map BSR modules** to Git repository references
-3. **Update configuration** to use Git URLs
-4. **Test compatibility** and resolve any issues
-
-Example migration:
-```yaml
-# Before (buf.yaml)
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/grpc/grpc
-
-# After (easyp.yaml)
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/grpc/grpc@v1.50.0
-```
-
-### Migrating from EasyP to Buf
-
-1. **Publish modules** to BSR (if not already available)
-2. **Create BSR account** and configure authentication
-3. **Update configuration** to reference BSR modules
-4. **Adopt BSR workflow** (push, pull, etc.)
-
-## Conclusion
-
-Both EasyP and Buf offer valid approaches to protobuf dependency management, but they serve different needs:
-
-**EasyP excels in:**
-- Enterprise and air-gapped environments
-- Security-conscious organizations
-- Cost-sensitive projects
-- Direct Git repository usage
-- Zero-infrastructure deployments
-
-**Buf excels in:**
-- Collaborative, open-source focused teams
-- Organizations wanting curated, high-quality modules
-- Teams new to protobuf ecosystem
-- Projects heavily using BSR features
-
-The choice between EasyP and Buf often comes down to your organization's priorities around **control vs. convenience**, **security vs. collaboration features**, and **infrastructure costs vs. managed services**.
-
-For many enterprise environments, EasyP's decentralized, Git-native approach provides the security, control, and cost-effectiveness needed for production protobuf workflows, while Buf's centralized registry excels in collaborative, open-source focused development environments.
diff --git a/docs/dist/docs/guide/cli/package-manager/package-manager.md b/docs/dist/docs/guide/cli/package-manager/package-manager.md
deleted file mode 100644
index 72562b83..00000000
--- a/docs/dist/docs/guide/cli/package-manager/package-manager.md
+++ /dev/null
@@ -1,552 +0,0 @@
-# Package Manager
-
-[[toc]]
-
-EasyP provides a powerful package manager for protobuf dependencies that simplifies dependency management through a decentralized, Git-based approach. Unlike centralized solutions, EasyP works directly with Git repositories, giving you complete control over your dependencies.
-
-## Overview
-
-The EasyP package manager follows the **Go modules philosophy** - any Git repository can serve as a package source. This approach provides several key advantages:
-
-- **Decentralized**: No single point of failure or control
-- **Security**: Direct access to source repositories
-- **Flexibility**: Support for public, private, and enterprise repositories
-- **Reproducibility**: Lock files ensure consistent builds across environments
-- **Performance**: Local caching minimizes network requests
-
-### Key Features
-
-| Feature | Description |
-|---------|-------------|
-| **Git-Native** | Works with any Git repository - no special server required |
-| **Multiple Version Formats** | Tags, commits, pseudo-versions, latest |
-| **Lock Files** | Reproducible builds with `easyp.lock` |
-| **Local Caching** | Go modules-style cache architecture |
-| **Vendoring Support** | Copy dependencies locally for offline builds |
-| **YAML Configuration** | Simple, readable dependency declarations |
-
-## Architecture
-
-EasyP uses a two-tier caching system inspired by Go modules:
-
-```
-~/.easyp/
-├── cache/
-│   ├── download/              # Downloaded archives + checksums
-│   │   └── github.com/
-│   │       └── googleapis/
-│   │           └── googleapis/
-│   │               ├── v1.2.3.zip       # Archive
-│   │               ├── v1.2.3.ziphash   # Checksum
-│   │               └── v1.2.3.info      # Metadata
-│   └── {git-hash}/            # Git bare repositories (internal)
-└── mod/                       # Extracted, ready-to-use modules
-    └── github.com/
-        └── googleapis/
-            └── googleapis/
-                ├── v1.2.3/           # Tagged version
-                │   ├── google/
-                │   │   ├── api/
-                │   │   └── rpc/
-                │   └── ...
-                └── v0.0.0-20250101123456-abc123def/  # Pseudo-version
-                    ├── google/
-                    └── ...
-```
-
-### Cache Location
-
-| Environment | Location | How to Set |
-|-------------|----------|------------|
-| **Default** | `$HOME/.easyp` | Automatic |
-| **Custom** | Any directory | Set `EASYPPATH` environment variable |
-| **CI/CD** | Project-relative | `export EASYPPATH=$CI_PROJECT_DIR/.easyp` |
-
-## Configuration
-
-### Basic Configuration
-
-Configure dependencies in your `easyp.yaml` file:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-  - github.com/bufbuild/protoc-gen-validate
-```
-
-### Advanced Configuration Examples
-
-#### Multi-Environment Setup
-```yaml
-# development.easyp.yaml
-deps:
-  - github.com/googleapis/googleapis              # Latest for development
-  - github.com/mycompany/internal-protos          # Latest internal changes
-  - github.com/bufbuild/protoc-gen-validate       # Latest features
-
-# production.easyp.yaml
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1       # Pinned
-  - github.com/mycompany/internal-protos@v2.1.0                # Stable release
-  - github.com/bufbuild/protoc-gen-validate@v0.10.1           # Tested version
-```
-
-#### Private Repository Setup
-```yaml
-deps:
-  # Public dependencies
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-
-  # Private company repositories
-  - github.com/mycompany/auth-protos@v1.5.0
-  - github.com/mycompany/common-types@v2.0.1
-
-  # Internal GitLab
-  - gitlab.company.com/platform/messaging-protos@v0.3.0
-```
-
-## Versioning Strategies
-
-EasyP supports multiple versioning approaches to fit different development workflows:
-
-### 1. Semantic Version Tags (Recommended for Production)
-
-```yaml
-deps:
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-```
-
-**Use when:**
-- Production deployments
-- Stable API consumption
-- Reproducible builds required
-
-### 2. Latest Tag (Development)
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis    # Uses latest available tag
-  - github.com/bufbuild/protoc-gen-validate
-```
-
-**Use when:**
-- Active development
-- Want latest features
-- Compatibility testing
-
-### 3. Commit Hashes (Bleeding Edge)
-
-```yaml
-deps:
-  - github.com/bufbuild/protoc-gen-validate@abc123def456789abcdef123456789abcdef1234
-```
-
-**Use when:**
-- Need unreleased features
-- Testing specific fixes
-- Contributing to upstream
-
-### 4. Pseudo-Versions (Automatic)
-
-When EasyP can't find a suitable tag, it generates pseudo-versions automatically:
-
-```
-Format: v0.0.0-{timestamp}-{short-commit-hash}
-Example: v0.0.0-20250908104020-660ec2d64e07f2fa8947527443af058b3d7169df
-```
-
-This ensures every commit can be referenced with a version-like identifier.
-
-## Commands
-
-### `easyp mod download`
-
-Downloads and installs all dependencies declared in your configuration.
-
-**What happens:**
-1. **Resolves versions**: Converts tags/latest to specific commits
-2. **Downloads archives**: Stores `.zip` files in cache/download
-3. **Verifies checksums**: Ensures archive integrity
-4. **Extracts modules**: Unpacks to cache/mod with proper structure
-5. **Updates lock file**: Records exact versions and content hashes
-
-**Usage:**
-```bash
-# Use default easyp.yaml
-easyp mod download
-
-# Use custom config file
-easyp --cfg production.easyp.yaml mod download
-
-# With custom cache location
-EASYPPATH=/tmp/easyp-cache easyp mod download
-```
-
-**Example output:**
-```
-INFO Download package package=github.com/googleapis/googleapis version=v0.0.0-20250909114430 commit=8727b5ba
-INFO Install package package=github.com/googleapis/googleapis version=v0.0.0-20250909114430 commit=8727b5ba
-INFO Download package package=github.com/grpc-ecosystem/grpc-gateway version=v2.19.1 commit=a070de73
-INFO Install package package=github.com/grpc-ecosystem/grpc-gateway version=v2.19.1 commit=a070de73
-```
-
-### `easyp mod vendor`
-
-Copies all installed proto files to a local `easyp_vendor/` directory for offline usage.
-
-**Use cases:**
-- **Docker builds**: Avoid network dependencies in containers
-- **Air-gapped environments**: No internet access during builds
-- **Reproducible builds**: Bundle exact dependency versions
-- **Performance**: Eliminate network latency in repeated builds
-
-**Usage:**
-```bash
-easyp mod vendor
-```
-
-**Result structure:**
-```
-easyp_vendor/
-├── github.com/
-│   ├── googleapis/
-│   │   └── googleapis/
-│   │       ├── google/
-│   │       │   ├── api/
-│   │       │   │   ├── annotations.proto
-│   │       │   │   └── http.proto
-│   │       │   └── rpc/
-│   │       │       └── status.proto
-│   │       └── ...
-│   └── grpc-ecosystem/
-│       └── grpc-gateway/
-│           └── protoc-gen-openapiv2/
-│               └── options/
-│                   └── annotations.proto
-```
-
-### `easyp mod update`
-
-Updates module versions based on current configuration and writes resolved versions to the lock file.
-
-**Behavior:**
-- Respects version constraints in `easyp.yaml`
-- Updates to latest compatible versions
-- Regenerates `easyp.lock` with new versions and hashes
-
-**Usage:**
-```bash
-easyp mod update
-```
-
-## Lock Files
-
-The `easyp.lock` file ensures reproducible builds by recording exact versions and content hashes:
-
-```
-github.com/bufbuild/protoc-gen-validate v0.0.0-20250908104020-660ec2d64e07f2fa8947527443af058b3d7169df h1:ZZ5JyUkmrj9OBHM+gOCzeL5L/pAKVbsUl051yhhJTjU=
-github.com/googleapis/googleapis v0.0.0-20250909114430-8727b5ba7f23fbbfddda58239e8bc6b547e05878 h1:eI+XYpPio3fxl9H5/VjW2PxlxM/7yqPjEq3oQ6jUkj4=
-github.com/grpc-ecosystem/grpc-gateway v2.19.1 h1:01NNlCezvwUQ07ZvblXH0kelWq8hNl2qb44bOMcaSTQ=
-```
-
-### Lock File Format
-
-Each line contains three components:
-- **Module path**: Full repository path
-- **Exact version**: Resolved version (tag or pseudo-version)
-- **Content hash**: SHA256 of extracted content (`h1:` prefix)
-
-### Best Practices
-
-✅ **Always commit `easyp.lock`** - Ensures team consistency
-✅ **Run `mod update` deliberately** - Don't auto-update in CI
-✅ **Review lock changes** - Understand what's being updated
-❌ **Don't edit manually** - Let EasyP manage the format
-
-## Authentication
-
-### Public Repositories
-
-No setup required - works out of the box:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/bufbuild/protoc-gen-validate
-```
-
-### Private Repositories
-
-#### SSH Keys (Recommended)
-
-Configure Git to use SSH for GitHub/GitLab:
-
-```bash
-# For GitHub
-git config --global url."git@github.com:".insteadOf "https://github.com/"
-
-# For GitLab
-git config --global url."git@gitlab.com:".insteadOf "https://gitlab.com/"
-
-# For custom domains
-git config --global url."git@gitlab.company.com:".insteadOf "https://gitlab.company.com/"
-```
-
-Then use normal HTTPS URLs in your config:
-
-```yaml
-deps:
-  - github.com/mycompany/private-protos@v1.0.0
-  - gitlab.company.com/platform/shared-types@v2.1.0
-```
-
-#### Personal Access Tokens
-
-For HTTPS authentication:
-
-```bash
-# Method 1: Credential helper
-git config --global credential.helper store
-echo "https://username:token@github.com" >> ~/.git-credentials
-
-# Method 2: URL rewriting
-git config --global url."https://username:token@github.com/mycompany".insteadOf "https://github.com/mycompany"
-```
-
-#### Corporate Environments
-
-```bash
-# Configure proxy
-git config --global http.proxy http://proxy.company.com:8080
-git config --global https.proxy https://proxy.company.com:8080
-
-# Configure certificates for internal Git servers
-git config --global http.sslCAInfo /path/to/certificate.pem
-```
-
-## Common Workflows
-
-### Initial Project Setup
-
-```bash
-# 1. Create configuration
-cat > easyp.yaml << EOF
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-EOF
-
-# 2. Download dependencies
-easyp mod download
-
-# 3. Verify installation
-ls ~/.easyp/mod/github.com/googleapis/googleapis/
-```
-
-### Adding New Dependencies
-
-```bash
-# 1. Edit easyp.yaml
-echo "  - github.com/bufbuild/protoc-gen-validate@v0.10.1" >> easyp.yaml
-
-# 2. Download new dependency
-easyp mod download
-
-# 3. Commit lock file changes
-git add easyp.lock
-git commit -m "Add protoc-gen-validate dependency"
-```
-
-### Updating Dependencies
-
-```bash
-# Update to latest compatible versions
-easyp mod update
-
-# Review changes
-git diff easyp.lock
-
-# Test with new versions
-easyp generate
-easyp lint
-
-# Commit if everything works
-git add easyp.lock
-git commit -m "Update dependencies"
-```
-
-### Offline Development
-
-```bash
-# Vendor all dependencies
-easyp mod vendor
-
-# Now your project works offline
-easyp generate
-```
-
-## Troubleshooting
-
-### Common Issues
-
-#### "Repository not found" or "Authentication failed"
-
-**Problem**: Can't access private repository
-**Solution**: Check authentication setup
-
-```bash
-# Test Git access
-git ls-remote https://github.com/mycompany/private-repo
-
-# Check Git configuration
-git config --list | grep url
-```
-
-#### "Version not found"
-
-**Problem**: Specified tag/version doesn't exist
-**Solution**: Check available tags
-
-```bash
-# List available tags
-git ls-remote --tags https://github.com/googleapis/googleapis
-
-# Use existing tag or commit hash
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1  # Valid tag
-```
-
-#### "Cache corruption" or "Checksum mismatch"
-
-**Problem**: Corrupted cache files
-**Solution**: Clear cache and re-download
-
-```bash
-# Clear everything
-rm -rf ~/.easyp
-
-# Or clear just downloads
-rm -rf ~/.easyp/cache/download
-
-# Re-download
-easyp mod download
-```
-
-#### Network timeouts
-
-**Problem**: Slow or unreliable network
-**Solution**: Configure Git timeouts
-
-```bash
-# Increase timeout
-git config --global http.lowSpeedLimit 1000
-git config --global http.lowSpeedTime 300
-
-# Use proxy if available
-git config --global http.proxy http://proxy.company.com:8080
-```
-
-### Performance Optimization
-
-#### For Large Teams
-
-```bash
-# Use shared cache server (if available)
-export EASYPPATH=/shared/easyp-cache
-
-# Or use team-specific cache
-export EASYPPATH=/team-cache/easyp
-```
-
-#### For CI/CD Systems
-
-```bash
-# Use project-relative cache
-export EASYPPATH=$CI_PROJECT_DIR/.easyp
-
-# Cache between builds (GitLab CI example)
-cache:
-  key: easyp-$CI_COMMIT_REF_SLUG
-  paths:
-    - .easyp/
-```
-
-#### Cache Size Management
-
-```bash
-# Check cache usage
-du -sh ~/.easyp
-du -sh ~/.easyp/cache/download    # Archives only
-du -sh ~/.easyp/mod               # Extracted modules
-
-# Clean old versions (manual)
-find ~/.easyp/mod -type d -name "v0.0.0-*" -mtime +30 -exec rm -rf {} \;
-```
-
-## Integration Examples
-
-### Docker Multi-stage Build
-
-```dockerfile
-# Stage 1: Download dependencies
-FROM ghcr.io/easyp-tech/easyp:latest AS deps
-WORKDIR /workspace
-COPY easyp.yaml easyp.lock ./
-RUN easyp mod vendor
-
-# Stage 2: Build application
-FROM alpine:latest AS build
-WORKDIR /app
-COPY --from=deps /workspace/easyp_vendor ./easyp_vendor
-COPY . .
-# Use vendored dependencies for generation
-RUN easyp generate
-```
-
-### Monorepo Structure
-
-```
-my-monorepo/
-├── services/
-│   ├── auth-service/
-│   │   └── easyp.yaml          # Service-specific deps
-│   └── user-service/
-│       └── easyp.yaml          # Different deps
-├── shared/
-│   └── common-protos/          # Internal protos
-└── easyp.yaml                  # Global/shared deps
-```
-
-Each `easyp.yaml` can have different dependencies based on service needs.
-
-## Best Practices
-
-### Development Workflow
-- ✅ Use **latest tags** during active development
-- ✅ **Pin versions** for production deployments
-- ✅ **Commit lock files** to ensure reproducibility
-- ✅ **Review dependency updates** before merging
-- ✅ **Test after updates** to catch compatibility issues
-
-### Security
-- ✅ **Pin to specific versions** in production
-- ✅ **Use SSH keys** for private repositories
-- ✅ **Review new dependencies** for security implications
-- ✅ **Monitor for vulnerabilities** in dependencies
-- ❌ **Don't embed credentials** in configuration files
-
-### Performance
-- ✅ **Cache aggressively** in CI/CD systems
-- ✅ **Use vendoring** for frequently rebuilt projects
-- ✅ **Clean old cache** periodically to save space
-- ✅ **Use shared cache** for team environments
-
-### Team Collaboration
-- ✅ **Document authentication setup** for new team members
-- ✅ **Use consistent tooling** across environments
-- ✅ **Automate dependency updates** with proper testing
-- ✅ **Share cache locations** when possible
-
-The EasyP package manager provides a robust, decentralized solution for protobuf dependency management that scales from individual projects to enterprise environments while maintaining the simplicity and reliability developers expect.
diff --git a/docs/dist/docs/guide/introduction/install.md b/docs/dist/docs/guide/introduction/install.md
deleted file mode 100644
index 8a4919ec..00000000
--- a/docs/dist/docs/guide/introduction/install.md
+++ /dev/null
@@ -1,51 +0,0 @@
-# Install the EasyP cli
-
-### Install from system's package manager
-
-##### Recommended installation method
-
-#### Homebrew
-
-You can install a binary release on macOS using brew:
-
-```bash
-brew install easyp-tech/tap/easyp
-```
-
-`Work in progress`
-apt, yum, pacman, etc.
-
-## Local Installation
-
-#### _**Not recommended**_
-
-Local installation is not recommended because package managers provide:
-- Automatic updates and security patches
-- Better integration with system package management
-- Easier installation and removal process
-- Verified and signed binaries
-
-#### Requires Go 1.24 or later
-
-### Go install
-
-It will install the latest stable version of easyp.
-
-```bash
-go install github.com/easyp-tech/easyp/cmd/easyp@latest
-```
-
-### Build from source
-
-
-1. Clone repository
-
-```bash
-git clone https://github.com/easyp-tech/easyp.git
-```
-
-2. Build by golang
-
-```bash
-go build ./cmd/easyp
-```
diff --git a/docs/dist/docs/guide/introduction/quickstart.md b/docs/dist/docs/guide/introduction/quickstart.md
deleted file mode 100644
index 03cdfe49..00000000
--- a/docs/dist/docs/guide/introduction/quickstart.md
+++ /dev/null
@@ -1,163 +0,0 @@
-# Quickstart
-
-EasyP is a modern toolkit for working with Protobuf files. In this quickstart, you'll learn to:
-
-1. **Initialize** your project with EasyP configuration
-2. **Set up linting** to catch errors and ensure best practices
-3. **Manage dependencies** from Git repositories
-4. **Generate code** from your Protobuf files
-
-## Prerequisites
-
-Before you begin, make sure you have:
-
-- **EasyP CLI installed** - See [Installation guide](/docs/guide/introduction/install) if you haven't already
-- **Git** installed and in your `$PATH`
-- **Protobuf files** ready to work with (or create some as you go)
-
-You can verify your installation:
-
-```bash
-easyp --version
-```
-
-## Initialize your project
-
-Start by creating an `easyp.yaml` configuration file in your project root:
-
-```bash
-easyp init
-```
-
-This command generates a commented template with default lint and breaking settings.
-`easyp init` is interactive: if `buf.yml`/`buf.yaml` exists in the target root, EasyP asks whether to migrate it; if `easyp.yaml` already exists, it asks before overwriting.
-
-## Configure linting
-
-Linting helps catch errors and ensures your Protobuf files follow best practices. EasyP provides default rules compatible with Buf standards.
-
-`easyp init` already generates a lint section. Adjust it if needed, for example:
-
-```yaml
-lint:
-  use:
-    - DEFAULT
-```
-
-Now you can run the linter:
-
-```bash
-easyp lint
-```
-
-The linter will check all your `.proto` files and report any issues found.
-
-::: tip
-EasyP's linting rules are 100% compatible with Buf, making migration easy if you're switching tools.
-:::
-
-## Manage dependencies
-
-If your project uses third-party Protobuf packages (like Google APIs or gRPC Gateway), EasyP makes it easy to manage them.
-
-### Dependency format
-
-Dependencies use a simple format: `$GIT_LINK@$VERSION`
-
-- **`$GIT_LINK`** - URL to any Git repository (GitHub, GitLab, etc.)
-- **`$VERSION`** - Git tag or commit hash (optional)
-
-If you omit the version, EasyP downloads the latest commit from the default branch.
-
-### Add dependencies
-
-Update your `easyp.yaml` to include dependencies:
-
-```yaml
-lint:
-  use:
-    - DEFAULT
-deps:
-  - github.com/googleapis/googleapis                          # Latest commit
-  - github.com/grpc-ecosystem/grpc-gateway@v2.20.0           # Specific version
-```
-
-### Download dependencies
-
-Download the packages you specified:
-
-```bash
-easyp mod download
-```
-
-This command:
-- Downloads dependencies from `easyp.lock` if it exists
-- Otherwise, downloads from `easyp.yaml` and creates `easyp.lock`
-
-::: info
-**Tip:** Use `easyp mod update` to ignore the lock file and fetch the latest versions from `easyp.yaml`.
-:::
-
-## Generate code
-
-Now let's configure code generation. EasyP supports all standard Protobuf plugins.
-
-### Configure generation
-
-Add plugin configuration to your `easyp.yaml`:
-
-```yaml
-lint:
-  use:
-    - DEFAULT
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/grpc-ecosystem/grpc-gateway@v2.20.0
-generate:
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-```
-
-### Run code generation
-
-Generate your code stubs:
-
-```bash
-easyp generate
-```
-
-EasyP will:
-1. Resolve all dependencies
-2. Connect to the EasyP service (or run locally)
-3. Execute the configured plugins
-4. Output generated code to the specified directories
-
-::: tip
-EasyP uses a hybrid runtime with WASM for speed and Docker for heavy plugins, giving you the best of both worlds.
-:::
-
-## Next steps
-
-Congratulations! 🎉 You've successfully:
-- ✅ Initialized an EasyP project
-- ✅ Configured linting rules
-- ✅ Managed third-party dependencies
-- ✅ Generated code from your Protobuf files
-
-### Learn more
-
-- **[CLI Reference](/docs/guide/cli/linter/linter)** - Deep dive into all CLI commands
-- **[API Service](/docs/guide/api-service/overview)** - Set up remote code generation
-- **[Configuration](/docs)** - Explore all configuration options
-
----
-
-*Enjoy working with Protobuf without any pain! 🚀*
diff --git a/docs/dist/docs/guide/introduction/what-is.md b/docs/dist/docs/guide/introduction/what-is.md
deleted file mode 100644
index 1bbd29dd..00000000
--- a/docs/dist/docs/guide/introduction/what-is.md
+++ /dev/null
@@ -1,159 +0,0 @@
-# What is EasyP?
-
-EasyP is a modern Protocol Buffers toolkit that consolidates your entire protobuf workflow into a single, powerful CLI tool. It combines linting, package management, code generation, and compatibility checking in a unified interface designed to eliminate the complexity of traditional protobuf development.
-
-<div class="tip custom-block" style="padding-top: 8px">
-
-Just want to try it out? Skip to the [Quickstart](./guide/introduction/quickstart).
-
-</div>
-
-## The Problem: Fragmented Proto Workflows
-
-Working with Protocol Buffers across projects creates unnecessary complexity and friction:
-
-### Tool Chaos
-- **Multiple tools for different tasks**: Separate tools for linting, generation, and dependency management
-- **Inconsistent configurations**: Different config formats across projects and teams
-- **Complex setup**: Time-consuming onboarding for new developers joining projects
-
-### Dependency Management Issues  
-- **No standardized approach**: Each project handles proto dependencies differently
-- **Version conflicts**: Difficult to resolve conflicts between different proto libraries
-- **Build reproducibility**: Hard to ensure consistent builds across environments
-
-### Development Friction
-- **Manual processes**: Repetitive workflows for common proto tasks
-- **Configuration sprawl**: Multiple config files with different formats
-- **Time-consuming compatibility checks**: Manual verification of API changes
-
-## The Solution: Unified Proto Toolkit
-
-EasyP addresses these challenges by providing a comprehensive, opinionated toolkit that standardizes protobuf workflows:
-
-### One Tool, All Tasks
-Instead of juggling multiple tools, EasyP provides everything you need:
-- **Linting** with comprehensive rule sets
-- **Package management** with Git-native dependencies
-- **Code generation** with local and remote plugin support
-- **Breaking change detection** for API compatibility
-
-### Standardized Configuration
-A single `easyp.yaml` file configures your entire protobuf workflow, eliminating configuration sprawl and ensuring consistency across projects.
-
-### Git-Native Dependencies
-Direct integration with Git repositories for proto dependencies eliminates the need for centralized registries while providing version control and reproducibility.
-
-## Key Features
-
-| Feature | Description |
-|---------|-------------|
-| 🔍 **Comprehensive Linting** | Built-in support for buf's linting rules with customizable configurations to enforce API design best practices. |
-| 📦 **Smart Package Manager** | Git-based dependency management with lock file support for reproducible builds across environments. |
-| ⚡ **Code Generation** | Multi-language code generation with support for both local protoc plugins and remote plugin execution. |
-| 🔄 **Breaking Change Detection** | Automated API compatibility verification against Git branches to prevent accidental breaking changes. |
-| 🌐 **Remote Plugin Support** | Execute plugins via centralized EasyP API service for consistent, isolated execution without local dependencies. |
-| 🎯 **Developer Experience** | Auto-completion, intuitive commands, clear error messages, and comprehensive documentation. |
-
-## Supported Plugin Types
-
-EasyP provides flexibility in how you execute code generation plugins:
-
-### Local Plugins
-Standard protoc plugins installed on your system:
-```yaml
-plugins:
-  - name: go
-    out: .
-    opts:
-      paths: source_relative
-```
-
-### Remote Plugins
-Plugins executed via EasyP API service for consistent results:
-```yaml
-plugins:
-  - remote: api.easyp.tech/protoc-gen-typescript:latest
-    out: ./web/generated
-```
-
-### Custom Plugins
-Support for custom plugin development and distribution through the ecosystem.
-
-## Decentralized Package Management
-
-Unlike other tools, EasyP doesn't rely on a centralized server for package distribution. Instead, any Git repository can serve as a package source, giving you:
-
-- **Flexibility and Control**: Use any Git hosting service (GitHub, GitLab, self-hosted)
-- **No Vendor Lock-in**: Your dependencies aren't tied to a specific registry
-- **Version Control**: Full Git history and branching for your proto dependencies
-- **Enterprise-Friendly**: Works with private repositories and corporate Git infrastructure
-
-## Seamless Migration from Buf
-
-EasyP is designed with buf compatibility in mind:
-
-- **Compatible rule sets**: Uses the same linting rules as buf
-- **Familiar configuration**: Similar YAML structure with enhanced features
-- **Drop-in replacement**: Can often replace buf with minimal configuration changes
-- **Gradual migration**: Adopt EasyP features incrementally without disrupting existing workflows
-
-### EasyP vs buf.build Comparison
-
-| Feature | EasyP | buf.build |
-|---------|--------|-----------|
-| **Dependency Management** | Git-based repositories | Buf Schema Registry (BSR) |
-| **Vendor Lock-in** | None - works with any Git hosting | Tied to BSR for full features |
-| **Plugin Execution** | Local + Remote plugins | Local + BSR plugins |
-| **Private Dependencies** | Any Git provider (GitHub, GitLab, etc.) | BSR or manual management |
-| **Offline Development** | Full support with `mod vendor` | Limited without BSR access |
-| **Enterprise Integration** | Works with existing Git infrastructure | Requires BSR setup |
-| **Breaking Change Detection** | Against any Git reference | Against any Git reference |
-| **Package Distribution** | Any Git repository | BSR required for publishing |
-| **License** | Apache 2.0 | Apache 2.0 |
-| **Community** | Growing | Established |
-
-**Migration Benefits:**
-- **No infrastructure changes**: Continue using your existing Git repositories
-- **Gradual adoption**: Start with EasyP while keeping existing buf configurations
-- **Enhanced flexibility**: Access to both local and remote plugin execution
-- **Simplified workflows**: Single configuration file for all protobuf operations
-
-## Our Goals for Protobuf
-
-EasyP's mission is to accelerate the adoption of **schema-driven API development** by making Protocol Buffers more accessible and reliable:
-
-### Modern Protobuf Ecosystem
-We're building on Protobuf's proven foundation to create a modern development experience that rivals the simplicity of REST/JSON while providing superior type safety and performance.
-
-### Developer Experience First
-Every feature is designed with developer productivity in mind, from intuitive CLI commands to comprehensive error messages and documentation.
-
-### Enterprise Ready
-Built for teams and organizations with features like reproducible builds, private repository support, and comprehensive CI/CD integration.
-
-## Why Choose EasyP?
-
-### For Individual Developers
-- **Quick Setup**: Get started with protobuf projects in minutes, not hours
-- **Unified Workflow**: One tool for all your protobuf needs
-- **Clear Documentation**: Comprehensive guides and examples
-
-### For Teams
-- **Consistent Standards**: Enforced linting rules and formatting across all projects
-- **Reproducible Builds**: Lock files ensure everyone builds the same way
-- **Easy Onboarding**: New team members can be productive immediately
-
-### For Organizations
-- **No Vendor Lock-in**: Git-based dependencies work with your existing infrastructure
-- **Enterprise Security**: Support for private repositories and custom authentication
-- **CI/CD Ready**: Designed for automated workflows and continuous integration
-
-## What's Next?
-
-EasyP simplifies protobuf development so you can focus on building great APIs instead of managing toolchain complexity. Whether you're starting a new project or migrating from existing tools, EasyP provides a smooth path to modern protobuf development.
-
-Ready to get started? Check out our [Installation Guide](/docs/guide/introduction/install) and [Quickstart Tutorial](/docs/guide/introduction/quickstart).
-
-## Stargazers over time
-[![Stargazers over time](https://starchart.cc/easyp-tech/easyp.svg?variant=adaptive)](https://starchart.cc/easyp-tech/easyp)
diff --git a/docs/dist/docs/guide/migration/buf-cli.md b/docs/dist/docs/guide/migration/buf-cli.md
deleted file mode 100644
index 1061787f..00000000
--- a/docs/dist/docs/guide/migration/buf-cli.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Buf CLI
-
-## Work in progress
\ No newline at end of file
diff --git a/docs/dist/docs/guide/migration/protoc.md b/docs/dist/docs/guide/migration/protoc.md
deleted file mode 100644
index b2adda0d..00000000
--- a/docs/dist/docs/guide/migration/protoc.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Protoc
-
-## Work in progress
\ No newline at end of file
diff --git a/docs/dist/docs/guide/migration/protolock.md b/docs/dist/docs/guide/migration/protolock.md
deleted file mode 100644
index f82aa550..00000000
--- a/docs/dist/docs/guide/migration/protolock.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Protolock
-
-## Work in progress
\ No newline at end of file
diff --git a/docs/dist/docs/guide/migration/prototool.md b/docs/dist/docs/guide/migration/prototool.md
deleted file mode 100644
index 40967d2a..00000000
--- a/docs/dist/docs/guide/migration/prototool.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Prototool
-
-## Work in progress
\ No newline at end of file
diff --git a/docs/dist/docs/ru-blog/finally-give-up-gin-echo.md b/docs/dist/docs/ru-blog/finally-give-up-gin-echo.md
deleted file mode 100644
index c0ce3246..00000000
--- a/docs/dist/docs/ru-blog/finally-give-up-gin-echo.md
+++ /dev/null
@@ -1,278 +0,0 @@
-# Откажитесь уже наконец от gin, echo и <иной ваш фреймворк>
-
-## Введение: Пересмотр Традиций в Мире Go
-В мире разработки на Go выбор фреймворка часто превращается в лояльность, сопоставимую с выбором между Apple и Android. Фреймворки вроде Gin, Echo и Beego долгие годы были верными спутниками программистов, помогая быстро развертывать проекты и достигать первых успехов. Они предлагали удобные инструменты и привычные шаблоны работы, но со временем становится очевидным, что у каждого свой «язык». Это создаёт трудности при переходе между ними или интеграции с другими системами.
-
-Ситуация усугубляется, если проекты разрастаются, а масштабируемость и поддержка становятся критически важными. Здесь каждый несовместимый компонент или разнообразие подходов превращается в препятствие, требующее дополнительных ресурсов и времени. Как если бы вы каждый раз, переходя с одного фреймворка на другой, переезжали в новый дом, где даже привычный световой выключатель находится не там, куда рука тянется автоматически.
-
-### Для тех, кто хочет углубиться в историю и особенности каждого фреймворка, предлагаю ознакомиться с подробными обзорами и сравнениями:
-
-- [Beego: An Overview and Comparison with Other Frameworks](https://medium.com/@eric.a.nugroho/beego-an-overview-and-comparison-with-other-framework-5211b08124ea)
-- [Building Microservice Using Golang Echo Framework](https://medium.com/cuddle-ai/building-microservice-using-golang-echo-framework-ff10ba06d508)
-- [Go with Gin](https://maneeshaindrachapa.medium.com/go-with-gin-83865cd5cd81)
-
-В этой статье мы рассмотрим, почему пришло время отказаться от привычной многообразности в пользу стандартизации и как gRPC-Gateway может стать «универсальным переводчиком», способным объединить разрозненные диалекты Go-фреймворков в единый, понятный всем язык взаимодействия микросервисов.
-
-## Стандартизация, стандартизация и еще раз стандартизация
-
-Когда речь заходит о создании серверов на Go, каждый фреймворк предлагает свой набор правил и инструментов. Изначально это кажется большим плюсом: вы можете выбрать именно то, что подходит под ваши конкретные нужды и стиль работы. Однако, представьте себе сложность, когда в одном проекте необходимо совместить модули, написанные с использованием разных фреймворков. Это сравнимо с попыткой собрать пазл, где каждая часть произведена разными производителями и не сочетается с остальными.
-
-Примеры Gin, Echo и, не дай Бог, Beego часто всплывают в беседах разработчиков. Они, без сомнения, оказали огромное влияние на сообщество Go и поддерживали многие проекты на разных этапах их жизненного цикла. Особенно Gin, который уже более 10 лет является надёжным инструментом для многих. Но современные реалии разработки требуют гибкости и возможности масштабирования, а привязка к одному фреймворку может серьёзно ограничить обе эти характеристики.
-
-Так, к примеру, если ваш проект начался с использования Echo, и вы хотите интегрировать стороннюю библиотеку, написанную для Gin, вы столкнетесь с необходимостью переписывания кода или создания «мостов» между различиями в API. Это не только увеличивает рабочий объём, но и вносит дополнительную сложность в поддержку и обновление кода.
-
-Стандартизация — это ключ к решению этих проблем. Переход к использованию gRPC и HTTP/2, а также адаптация таких инструментов, как gRPC-Gateway, открывает новые горизонты в вопросах совместимости и универсальной коммуникации. Подумайте о gRPC-Gateway как об универсальном переводчике, который позволяет вам говорить на одном языке с разными системами, не вдаваясь в особенности каждой из них.
-
-## Знакомство с gRPC-Gateway
-
-gRPC-Gateway — это магический мост, соединяющий старый мир RESTful JSON API и современный мир gRPC. Он позволяет вашим сервисам говорить на двух языках, обслуживая и традиционные HTTP запросы, и мощные gRPC вызовы. Это особенно удобно, когда у вас есть разнообразные клиенты: некоторые из них предпочитают общаться через простые HTTP запросы, в то время как другие — через gRPC.
-
-Давайте рассмотрим жизненный пример: вы управляете веб-сервисом, который предоставляет информацию о погоде. Ваши данные — это не просто текст, это объёмные наборы данных с метеостанций. Здесь gRPC идеально подходит для пересылки этих данных с высокой скоростью и надежностью. Но ваши клиенты — это не только другие сервера, но и мобильные приложения и веб-браузеры, которые ожидают удобные и понятные JSON ответы.
-
-Вот как gRPC-Gateway вступает в игру: он трансформирует HTTP запросы в gRPC вызовы и обратно, делая ваш сервис доступным для всех, без необходимости поддержки двух разных API. Всё это происходит за кулисами, и для конечного пользователя это выглядит как обычная работа с веб-сайтом или приложением.
-
-Пример кода, который вы могли бы видеть без gRPC-Gateway, выглядит примерно так:
-
-```proto
-syntax = "proto3";
-
-package your.service.v1;
-
-option go_package = "github.com/yourorg/yourprotos/gen/go/your/service/v1";
-
-message StringMessage {
-  string value = 1;
-}
-
-service YourService {
-  rpc Echo(StringMessage) returns (StringMessage) {}
-}
-```
-
-А теперь добавим немного "магии" gRPC-Gateway:
-
-```proto
-syntax = "proto3";
-package your.service.v1;
-option go_package = "github.com/yourorg/yourprotos/gen/go/your/service/v1";
-import "google/api/annotations.proto";
-
-message StringMessage {
-  string value = 1;
-}
-
-service YourService {
-  rpc Echo(StringMessage) returns (StringMessage) {
-      option (google.api.http) = {
-      post: "/v1/example/echo"
-      body: "*"
-    };
-  }
-}
-```
-
-Эти несколько строк позволяют вам автоматически принимать HTTP POST запросы на адрес `/v1/example/echo` и обрабатывать их как вызовы gRPC. Это пример того, как gRPC-Gateway упрощает жизнь разработчикам, предоставляя единый, универсально понятный API.
-
-## Сочетание GRPC и HTTP серверов
-
-Возможность одновременного использования gRPC и HTTP в одном приложении – это как иметь в своем распоряжении и спортивный автомобиль, и внедорожник; вы можете наслаждаться скоростью и мощью, когда это необходимо, и надежностью и универсальностью в другой раз. gRPC-Gateway позволяет вашему сервису легко переключаться между этими двумя "транспортами", предоставляя такую гибкость.
-
-Давайте рассмотрим обычный рабочий процесс:
-
-- *HTTP запрос*: Клиент отправляет HTTP запрос, который достигает gRPC-Gateway.
-- *Преобразование в gRPC*: Gateway анализирует запрос, преобразует его в соответствующий gRPC вызов и перенаправляет его на gRPC сервер.
-- *Обработка gRPC сервером*: gRPC сервер обрабатывает запрос и отправляет ответ обратно в Gateway.
-- *Преобразование в HTTP*: Gateway переводит gRPC ответ обратно в формат, понятный HTTP клиенту, и отправляет его обратно.
-
-Этот процесс можно представить в виде диаграммы:
-
-```mermaid
-sequenceDiagram
-    participant WebClient as Web Client
-    participant GRPCGateway as HTTP Server (gRPC-Gateway)
-    participant GRPCServer as gRPC Server
-
-    WebClient->>GRPCGateway: HTTP Request
-    GRPCGateway->>GRPCServer: gRPC Request
-    GRPCServer->>GRPCGateway: gRPC Response
-    GRPCGateway->>WebClient: HTTP Response
-```
-
-В реальной жизни это выглядит следующим образом: когда пользователь запрашивает информацию через веб-интерфейс, его запрос идет через gRPC-Gateway, который транслирует его в gRPC вызов. Затем, получив ответ от gRPC сервиса, Gateway «переводит» его обратно в HTTP ответ и отправляет пользователю, обеспечивая плавный и незаметный процесс взаимодействия.
-
-А на уровне кода, это может выглядеть так:
-```go
-package main
-
-import (
-	"context"
-	"log"
-	"net"
-	"net/http"
-
-	"github.com/grpc-ecosystem/grpc-gateway/v2/runtime"
-	"golang.org/x/sync/errgroup"
-	"google.golang.org/grpc"
-	"google.golang.org/grpc/credentials/insecure"
-
-	echo "path/to/your/protobuf_package" 
-)
-
-const (
-	grpcServerEndpoint = "localhost:50051"
-	httpServerEndpoint = "localhost:8080"
-)
-
-type EchoService struct {
-	echo.UnimplementedEchoServiceServer
-}
-
-func (s *EchoService) Echo(ctx context.Context, in *echo.EchoRequest) (*echo.EchoResponse, error) {
-	return &echo.EchoResponse{Message: "Echo: " + in.Message}, nil
-}
-
-func main() {
-	g, ctx := errgroup.WithContext(context.Background())
-
-	g.Go(func() error {
-		return startGRPCServer(ctx)
-	})
-
-	g.Go(func() error {
-		return startHTTPServer(ctx)
-	})
-
-	if err := g.Wait(); err != nil {
-		log.Fatalf("Не удалось запустить серверы: %s", err)
-	}
-}
-
-func startGRPCServer(ctx context.Context) (err error) {
-	lis, err := net.Listen("tcp", grpcServerEndpoint)
-	if err != nil {
-		return err
-	}
-
-	s := grpc.NewServer()
-	echo.RegisterEchoServiceServer(s, &EchoService{})
-
-	go func() {
-		<-ctx.Done()
-		s.GracefulStop()
-	}()
-
-	log.Printf("Запуск gRPC сервера на %s", grpcServerEndpoint)
-	return s.Serve(lis)
-}
-
-func startHTTPServer(ctx context.Context) (err error) {
-	mux := runtime.NewServeMux()
-	opts := []grpc.DialOption{grpc.WithTransportCredentials(insecure.NewCredentials())}
-	err = echo.RegisterEchoServiceHandlerFromEndpoint(ctx, mux, grpcServerEndpoint, opts)
-	if err != nil {
-		return err
-	}
-
-	srv := &http.Server{
-		Addr:    httpServerEndpoint,
-		Handler: mux,
-	}
-
-	go func() {
-		<-ctx.Done()
-		srv.Shutdown(ctx)
-	}()
-
-	log.Printf("Запуск HTTP сервера на %s", httpServerEndpoint)
-	return srv.ListenAndServe()
-}
-```
-
-Этот простой пример показывает, как в рамках одного приложения можно обеспечить работу и gRPC, и HTTP серверов, давая пользователям свободу выбора и обеспечивая разработчикам удобные инструменты для управления API.
-
-## Преимущества использования gRPC-Gateway
-
-gRPC-Gateway не просто облегчает разработку — он раскрывает новые возможности для систем, где требуется совместимость и гибкость. Это особенно важно в современных микросервисных архитектурах, где системы должны взаимодействовать друг с другом беспрепятственно и эффективно.
-
-## Единая точка истины: одна схема для GRPC и RESTful API
-
-Используя один .proto файл для описания как gRPC, так и RESTful API, мы получаем единство и согласованность интерфейсов. Это избавляет от необходимости поддерживать разные версии API для разных протоколов, что упрощает обновления и снижает шансы на ошибки. Если вы вносите изменения в .proto файл, они автоматически отражаются и в RESTful API, и в gRPC.
-
-## Сокращение дублирования кода и упрощение поддержки
-
-Поскольку gRPC-Gateway транслирует запросы REST в вызовы gRPC, разработчикам не нужно писать отдельные реализации для каждого протокола. Это освобождает усилия и время на создание дополнительных фич, а не на дублирование существующей функциональности.
-
-## Автоматическая генерация клиентского кода и документации OpenAPI (Swagger)
-
-gRPC-Gateway позволяет автоматически генерировать клиентские библиотеки для различных языков программирования и документацию API в формате OpenAPI (Swagger). Это не только ускоряет процесс разработки клиентских частей системы, но и обеспечивает актуальность документации, делая взаимодействие с API прозрачным и понятным для всех сторон.
-
-```mermaid
-sequenceDiagram
-    participant Developer as Developer
-    participant ProtoFile as .proto file
-    participant CodeGen as Code Generator
-    participant ClientLib as Client Library
-    participant APIDocs as API Documentation
-
-    Developer->>ProtoFile: Defines API
-    ProtoFile->>CodeGen: Transfers API structure
-    CodeGen->>ClientLib: Generates code
-    CodeGen->>APIDocs: Generates documentation
-    APIDocs-->>Developer: Uses for integration
-    ClientLib-->>Developer: Uses for client development
-```
-
-Пример преимущества может выглядеть так: представьте, что ваша команда внедряет новую функцию в систему. Ранее это требовало бы обновления нескольких документов API и реализаций на разных языках. Теперь же, изменения вносятся в один .proto файл, и все необходимые обновления генерируются автоматически.
-
-Эти преимущества делают gRPC-Gateway мощным инструментом, который может значительно упростить процесс разработки и поддержки микросервисных архитектур, делая их более модульными, гибкими и лёгкими в масштабировании.
-
-## Недостатки и ограничения gRPC-Gateway
-
-Несмотря на значительные преимущества, gRPC-Gateway не лишен недостатков, особенно когда речь заходит о сложных случаях использования и интеграции с существующими системами. Рассмотрим некоторые из этих ограничений:
-
-## Ограниченная настройка и кастомизация
-
-gRPC-Gateway прекрасно работает «из коробки» для многих стандартных сценариев, но его возможности кастомизации могут быть недостаточными для уникальных требований. Например, сложные требования к маршрутизации, тонкая настройка безопасности или специфичная обработка запросов могут потребовать дополнительных усилий и иногда написания дополнительного слоя проксирования.
-
-```mermaid
-graph TD
-    A[Client Request] --> B[gRPC-Gateway]
-    B --> C{Route Check}
-    C -->|Route OK| D[gRPC Service]
-    C -->|Customization Required| E[Additional Proxy Layer]
-    E --> D
-    D --> F{gRPC Service Response}
-    F -->|Convert to HTTP| B
-```
-
-## Более высокий порог входа для новичков
-
-Для эффективного использования gRPC-Gateway, разработчикам необходимо изучить не только основы REST и HTTP, но и особенности работы с gRPC и protobuf. Это может создать дополнительные трудности для новичков или команд, привыкших к более традиционным REST API.
-
-## Взаимодействие с другими инструментами и библиотеками
-
-Интеграция с некоторыми инструментами мониторинга, логирования или трассировки может быть затруднена, так как gRPC-Gateway представляет собой ещё один уровень абстракции. Поэтому может потребоваться дополнительная настройка или поиск специализированных решений, которые совместимы с gRPC.
-
-## Недостаточный контроль над HTTP-специфичными функциями
-
-Некоторые HTTP-специфичные возможности, такие как управление кэшированием, куками, редиректами, могут быть не так легко реализуемы через gRPC-Gateway. Это может потребовать дополнительных обходных решений или разработки дополнительного кода для контроля над этими аспектами на уровне HTTP.
-
-## Проблемы с передачей файлов
-
-Передача файлов может быть проблематичной при использовании gRPC-Gateway. Из-за особенностей gRPC, большие файлы придется разбивать на множество маленьких частей для передачи, что может быть неэффективным и сложным в реализации. В некоторых случаях, может потребоваться более традиционный подход к обработке и передаче файлов.
-
-## Влияние на производительность
-
-Хотя gRPC-Gateway относительно эффективен, введение дополнительного прокси-слоя может немного увеличить задержку обработки запросов. В системах, где каждая миллисекунда имеет значение, это может стать критичным фактором.
-
-## Заключение
-
-Итак, мы разобрались, что gRPC-Gateway — это не просто ещё одна техническая штучка. Это как мостик между двумя мирами: уютным островом REST и стремительным континентом gRPC. И этот мостик может привести нас к чему-то удивительному — к API, которые проще в поддержке, быстрее в работе и дружелюбнее к разработчикам.
-
-## Немного Размышлений
-
-Мир технологий не стоит на месте, и мы тоже. Сегодня выбор в пользу gRPC-Gateway может показаться нововведением, но завтра он уже станет частью «старой доброй классики». Так что, если вы чувствуете, что пора расширять горизонты и исследовать новые технологии, возможно, gRPC-Gateway — это именно то, что нужно.
-
-## Вот и Всё... Пока!
-
-Не бойтесь экспериментировать и пробовать новые решения. Возможно, gRPC-Gateway не станет панацеей для всех ваших болей, но он определённо может стать одним из тех инструментов, который вы будете вспоминать с благодарностью. А что будет завтра? Кто знает, может, мы уже встретимся на новом повороте технологической эволюции!
diff --git a/docs/dist/docs/ru-blog/working-with-proto-errors-correctly.md b/docs/dist/docs/ru-blog/working-with-proto-errors-correctly.md
deleted file mode 100644
index 58ff3596..00000000
--- a/docs/dist/docs/ru-blog/working-with-proto-errors-correctly.md
+++ /dev/null
@@ -1,220 +0,0 @@
-# Давайте работать с proto ошибками правильно :)
-
-## Protobuf Error Handling
-
-В программировании всегда есть несколько способов решения одной и той же проблемы. Но не все они одинаково эффективны. Сегодня поговорим о способах обработки ошибок в gRPC — удачных и не очень.
-
-```proto
-message Result {
-  oneof response {
-    error.v1.Error error = 1;
-    info.v1.Info info = 2;
-  }
-}
-```
-
-На первый взгляд может показаться, что использование oneof для представления либо ошибки, либо результата — это удобно. Однако такой подход вносит ненужную сложность в протокол обмена сообщениями и ухудшает читаемость кода. gRPC предоставляет встроенные средства для работы с ошибками, которые позволяют элегантно и эффективно передавать информацию об ошибках.
-
-Почему же использование `oneof` для ошибок — плохая идея? Во-первых, это затрудняет использование стандартного механизма ошибок gRPC и кодов состояний, которые предназначены для этой цели. Во-вторых, это может привести к путанице на стороне клиента при необходимости различать успешные ответы от ошибок.
-
-```mermaid
-sequenceDiagram
-    participant Client as Client
-    participant Service as Service
-    Client->>Service: Query
-    alt Success
-      Service-->>Client: Info
-    else Error
-      Service-->>Client: Error
-    end
-```
-На схеме видно, как обработка двух типов запроса утяжеляет логику клиента
-
-## Коды ошибок в gRPC
-
-Коды ошибок в архитектуре gRPC особенно важны для эффективного взаимодействия между клиентом и сервером. Они помогают клиенту понять причину проблемы и правильно отреагировать на нее.
-
-Правильное и эффективное управление ошибками в gRPC играет ключевую роль в создании надежных и поддерживаемых систем. Использование стандартных кодов ошибок и механизмов gRPC позволяет не только упростить обработку ошибок на стороне клиента, но и обеспечить ясность и предсказуемость поведения системы. Вместо того чтобы использовать конструкции вроде oneof для обработки ошибок, лучше воспользоваться встроенными возможностями gRPC для передачи детализированной информации об ошибках.
-
-Вот, как можно использовать gRPC-код codes.NotFound, чтобы сообщить об отсутствии чего-либо
-
-
-```go
-import "google.golang.org/grpc/status"
-import "google.golang.org/grpc/codes"
-
-// ...
-
-err := status.Error(codes.NotFound, "не нашел котика")
-
-// ...
-```
-
-Такой подход упрощает обработку ошибок на стороне клиента, а это облегчает понимание структуры данных ответа. Кроме того, ошибки, возвращаемые через status.Error преобразуются в HTTP-статусы при транспортировке через gRPC-Gateway, в таком случае ошибки становятся понятными и вне gRPC
-
-Но, что делать, если нам нужно больше гибкости в ответе ошибки? К примеру добавить дополнительную мета-инфу или же кастомные коды ошибок?
-
-В самой системе gRPC есть возможность прикрепить доп. данные к ошибке — и таким способом расширить контекст проблемы
-
-```go
-import (
-  "google.golang.org/grpc/status"
-  "google.golang.org/grpc/codes"
-  "google.golang.org/genproto/googleapis/rpc/errdetails"
-)
-
-// ...
-
-st := status.New(codes.InvalidArgument, "invalid parameter")
-// Общая форма ошибки
-errInfo := &errdetails.ErrorInfo{
-	Reason: "Не хватает средств на счету",
-	Domain: "finance",
-	Metadata: map[string]string{
-		"my_meta_info": "my_meta_details",
-	},
-}
-
-st, err := st.WithDetails(errInfo)
-if err != nil {
-	return fmt.Sprintf("st.WithDetails: %w", err)
-}
-
-return st.Err()
-```
-
-Но, в случаях, когда хочется получать более детализированные ошибки — например, с уточнением проблемного поля. В таком случае можно воспользоваться типом BadRequest и прописать больше деталей об ошибке.
-
-## Определение и использование кастомной ошибки
-
-Но! Что делать, если стандартные варианты details не подходят? Мы можем сделать свои собственные типы ошибок! :)
-
-Сначала определим кастомную ошибку в proto файле. Нам нужно создать message ошибки CustomErrorDetail. В ней будет содержаться информация об ошибках, связанных с пользовательскими данными:
-
-```proto
-syntax = "proto3";
-
-package myerrors;
-
-message CustomErrorDetail {
-  string reason = 1;
-  string field = 2;
-  string help = 3;
-}
-```
-
-Теперь, когда у нас есть определение кастомной ошибки, мы можем использовать её, чтобы передавать более специфичную и детализированную информацию об ошибках. Это особенно полезно, когда требуется указать на конкретные поля или параметры, вызвавшие ошибку. Создание и использование такогоCustomErrorDetailв коде сервера позволяет не только сообщать о проблемах, но и предоставлять клиенту рекомендации по их исправлению, что делает взаимодействие более прозрачным и эффективным.
-
-```go
-import (
-  "google.golang.org/grpc/status"
-  "google.golang.org/grpc/codes"
-  "google.golang.org/protobuf/types/known/anypb"
-  "myerrors"
-)
-
-// ...
-
-customErrorDetail := &myerrors.CustomErrorDetail{
-    Reason: "Value out of range",
-    Field: "age",
-    Help: "The age must be between 0 and 120",
-}
-
-st := status.New(codes.InvalidArgument, "invalid parameter")
-st, err = st.WithDetails(customErrorDetail)
-if err != nil {
-    return fmt.Sprintf("Unexpected error attaching custom error detail: %w", err)
-}
-
-return st.Err()
-```
-
-## Работа с клиентской стороны
-Теперь давайте рассмотрим, как клиентская сторона будет взаимодействовать с системой обработки ошибок в gRPC, которую мы описали ранее.
-
-### Обработка стандартных ошибок
-Когда клиент получает ответ от gRPC сервера, он может проверять наличие ошибок с помощью стандартных механизмов gRPC, например:
-
-```go
-import (
-  "context"
-  "google.golang.org/grpc"
-  "google.golang.org/grpc/codes"
-  "google.golang.org/grpc/status"
-  "log"
-)н
-
-func main() {
-  conn, err := grpc.Dial("localhost:50051", grpc.WithInsecure())
-  if err != nil {
-    log.Fatalf("did not connect: %v", err)
-  }
-  defer conn.Close()
-
-  client := NewYourServiceClient(conn)
-  response, err := client.YourMethod(context.Background(), &YourRequest{})
-  if err != nil {
-    st, ok := status.FromError(err)
-    if ok {
-      switch st.Code() {
-      case codes.InvalidArgument:
-        log.Println("Invalid argument error:", st.Message())
-      case codes.NotFound:
-        log.Println("Not found error:", st.Message())
-      // Обработайте другие коды ошибок по необходимости
-      default:
-        log.Println("Unexpected error:", st.Message())
-      }
-    } else {
-      log.Fatalf("failed to call YourMethod: %v", err)
-    }
-  } else {
-    log.Println("Response:", response)
-  }
-}
-```
-
-### Извлечение дополнительных деталей ошибок
-
-А теперь самое интересное: чтобы клиентская сторона могла извлечь details для анализа, нам нужно эти самые details обработать.
-
-Вот, как это можно сделать:
-```go
-import (
-  "google.golang.org/grpc/status"
-  "google.golang.org/genproto/googleapis/rpc/errdetails"
-  "myerrors"
-  "log"
-)
-
-// ...
-
-func handleError(err error) {
-  st, ok := status.FromError(err)
-  if !ok {
-    log.Fatalf("An unexpected error occurred: %v", err)
-  }
-
-  for _, detail := range st.Details() {
-    switch t := detail.(type) {
-    case *errdetails.BadRequest:
-      // Обработка деталей неверного запроса
-      for _, violation := range t.GetFieldViolations() {
-        log.Printf("The field %s was wrong: %s\\\\n", violation.GetField(), violation.GetDescription())
-      }
-    case *myerrors.CustomErrorDetail:
-      // Обработка кастомных деталей ошибок
-      log.Printf("Custom error detail: Reason: %s, Field: %s, Help: %s\\\\n", t.Reason, t.Field, t.Help)
-    // Добавьте обработку других типов ошибок по необходимости
-    default:
-      log.Printf("Received an unknown error detail type: %v\\\\n", t)
-    }
-  }
-}
-```
-
-### Заключение
-Мы рассмотрели, как использовать стандартные коды ошибок gRPC, как добавлять дополнительные данные к ошибкам и как создавать и обрабатывать кастомные ошибки. Эти подходы позволяют более гибко и детализированно подходить к обработке ошибок, что особенно важно для сложных систем, где простое сообщение об ошибке может быть недостаточным.
-
-При проектировании API важно помнить, что клиентская сторона должна иметь возможность легко и однозначно интерпретировать ответы сервера. Использование стандартных механизмов gRPC для ошибок помогает достичь этой цели, улучшая взаимодействие между клиентом и сервером и делая систему в целом более устойчивой и понятной.
diff --git a/docs/dist/docs/ru-guide/TRANSLATION_STATUS.md b/docs/dist/docs/ru-guide/TRANSLATION_STATUS.md
deleted file mode 100644
index 5269f99a..00000000
--- a/docs/dist/docs/ru-guide/TRANSLATION_STATUS.md
+++ /dev/null
@@ -1,150 +0,0 @@
-# Translation Status (ru-guide)
-
-Этот файл отслеживает прогресс перевода русской документации.  
-Используемые статусы:
-- TODO — требуется перевод
-- IN_PROGRESS — перевод начат, требуется вычитка
-- DONE — перевод завершён и вычитан
-- SKIPPED — не требует перевода (намеренно оставлено на английском)
-
-Правила:
-1. После полного перевода файла убрать исходный английский текст и маркер <!-- TODO -->
-2. Термины протокола и ключевые идентификаторы (названия правил, CLI команды, YAML ключи) НЕ переводим.
-3. Если структура исходного файла изменилась — добавить в начало: `<!-- SOURCE_UPDATED: <commit or date> -->`
-4. Для больших изменений: сначала IN_PROGRESS, после вычитки менять на DONE.
-
-## Summary
-
-Итого файлов: 76  
-DONE: 76  
-IN_PROGRESS: 0  
-TODO: 0
-
-## Priority Order (рекомендованный)
-
-1. introduction/what-is.md
-2. introduction/quickstart.md
-3. introduction/install.md
-4. cli/linter/linter.md
-5. cli/generator/generator.md
-6. cli/package-manager/package-manager.md
-7. cli/breaking-changes/breaking-changes.md
-8. api-service/overview.md
-9. migration/* (пакетом)
-
----
-
-## File Status Table
-
-| File | Status | Notes |
-|------|--------|-------|
-| introduction/what-is.md | DONE | Полный перевод выполнен |
-| introduction/quickstart.md | DONE | Структура сохранена, перевод вычитан |
-| introduction/install.md | DONE | Переведено, команды проверены |
-| api-service/overview.md | DONE | Переведено |
-| ci-cd/github-actions.md | DONE | Переведено |
-| ci-cd/gitlab.md | DONE | Переведено |
-| cli/auto-completion/auto-completion.md | DONE | Переведено |
-| cli/breaking-changes/breaking-changes.md | DONE | Переведено и вычитано |
-| cli/breaking-changes/rules/enum-no-delete.md | DONE | Переведено |
-| cli/breaking-changes/rules/enum-value-no-delete.md | DONE | Переведено |
-| cli/breaking-changes/rules/enum-value-same-name.md | DONE | Переведено |
-| cli/breaking-changes/rules/field-no-delete.md | DONE | Переведено |
-| cli/breaking-changes/rules/field-same-cardinality.md | DONE | Переведено |
-| cli/breaking-changes/rules/field-same-type.md | DONE | Переведено |
-| cli/breaking-changes/rules/import-no-delete.md | DONE | Переведено |
-| cli/breaking-changes/rules/message-no-delete.md | DONE | Переведено |
-| cli/breaking-changes/rules/oneof-field-no-delete.md | DONE | Переведено |
-| cli/breaking-changes/rules/oneof-field-same-type.md | DONE | Переведено |
-| cli/breaking-changes/rules/oneof-no-delete.md | DONE | Переведено |
-| cli/breaking-changes/rules/rpc-no-delete.md | DONE | Переведено |
-| cli/breaking-changes/rules/rpc-same-request-type.md | DONE | Переведено |
-| cli/breaking-changes/rules/rpc-same-response-type.md | DONE | Переведено |
-| cli/breaking-changes/rules/service-no-delete.md | DONE | Переведено |
-| cli/configuration/configuration.md | DONE | Переведено |
-| cli/generator/examples/go.md | DONE | Переведено |
-| cli/generator/examples/grpc-gateway.md | DONE | Переведено |
-| cli/generator/examples/validate.md | DONE | Переведено |
-| cli/generator/generator.md | DONE | Переведено и вычитано |
-| cli/linter/linter.md | DONE | Переведено и вычитано |
-| cli/linter/rules/comment-enum-value.md | DONE | Переведено |
-| cli/linter/rules/comment-enum.md | DONE | Переведено |
-| cli/linter/rules/comment-field.md | DONE | Переведено |
-| cli/linter/rules/comment-message.md | DONE | Переведено |
-| cli/linter/rules/comment-oneof.md | DONE | Переведено |
-| cli/linter/rules/comment-rpc.md | DONE | Переведено |
-| cli/linter/rules/comment-service.md | DONE | Переведено |
-| cli/linter/rules/directory-same-package.md | DONE | Переведено |
-| cli/linter/rules/enum-first-value-zero.md | DONE | Переведено |
-| cli/linter/rules/enum-no-allow-alias.md | DONE | Переведено |
-| cli/linter/rules/enum-pascal-case.md | DONE | Переведено |
-| cli/linter/rules/enum-value-prefix.md | DONE | Переведено |
-| cli/linter/rules/enum-value-upper-snake-case.md | DONE | Переведено |
-| cli/linter/rules/enum-zero-value-suffix.md | DONE | Переведено |
-| cli/linter/rules/field-lower-snake-case.md | DONE | Переведено |
-| cli/linter/rules/file-lower-snake-case.md | DONE | Переведено |
-| cli/linter/rules/import-no-public.md | DONE | Переведено |
-| cli/linter/rules/import-no-weak.md | DONE | Переведено |
-| cli/linter/rules/import-used.md | DONE | Переведено |
-| cli/linter/rules/message-pascal-case.md | DONE | Переведено |
-| cli/linter/rules/oneof-lower-snake-case.md | DONE | Переведено |
-| cli/linter/rules/package-defined.md | DONE | Переведено |
-| cli/linter/rules/package-directory-match.md | DONE | Переведено |
-| cli/linter/rules/package-lower-snake-case.md | DONE | Переведено |
-| cli/linter/rules/package-same-csharp-namespace.md | DONE | Переведено |
-| cli/linter/rules/package-same-directory.md | DONE | Переведено |
-| cli/linter/rules/package-same-go-package.md | DONE | Переведено |
-| cli/linter/rules/package-same-java-multiple-files.md | DONE | Переведено |
-| cli/linter/rules/package-same-java-package.md | DONE | Переведено |
-| cli/linter/rules/package-same-php-namespace.md | DONE | Переведено |
-| cli/linter/rules/package-same-ruby-package.md | DONE | Переведено |
-| cli/linter/rules/package-same-swift-prefix.md | DONE | Переведено |
-| cli/linter/rules/package-version-suffix.md | DONE | Переведено |
-| cli/linter/rules/rpc-no-client-streaming.md | DONE | Переведено |
-| cli/linter/rules/rpc-no-server-streaming.md | DONE | Переведено |
-| cli/linter/rules/rpc-pascal-case.md | DONE | Переведено |
-| cli/linter/rules/rpc-request-response-unique.md | DONE | Переведено |
-| cli/linter/rules/rpc-request-standard-name.md | DONE | Переведено |
-| cli/linter/rules/rpc-response-standard-name.md | DONE | Переведено |
-| cli/linter/rules/service-pascal-case.md | DONE | Переведено |
-| cli/linter/rules/service-suffix.md | DONE | Переведено |
-| cli/package-manager/easyp-vs-buf.md | DONE | Переведено |
-| cli/package-manager/package-manager.md | DONE | Переведено и вычитано |
-| migration/buf-cli.md | DONE | Переведено |
-| migration/protoc.md | DONE | Переведено |
-| migration/protolock.md | DONE | Переведено |
-| migration/prototool.md | DONE | Переведено |
-
----
-
-## Workflow
-
-1. Выбираем файл со статусом TODO.
-2. Меняем статус на IN_PROGRESS здесь.
-3. Переводим, проверяем терминологию (сверка с глоссарием — добавить позже).
-4. Меняем статус на DONE.
-5. Удаляем маркер `<!-- TODO -->` внутри файла.
-
-## Planned Terminology (черновик)
-
-| EN | RU | Notes |
-|----|----|-------|
-| Linting | Линтинг | Транслитерация |
-| Breaking Changes | Несовместимые изменения | Название секции |
-| Dependency | Зависимость |  |
-| Code Generation | Генерация кода |  |
-| Lock file | Lock-файл |  |
-| Remote Plugin | Удалённый плагин |  |
-| Package Manager | Менеджер пакетов |  |
-
-(Будет дополнено.)
-
----
-
-## История обновлений
-
-- Initial file created: all statuses set (3 IN_PROGRESS, rest TODO).
-- Marked breaking-changes page as DONE.
-- Linter rules (41 файлов) переведены: статусы DONE.
-- Breaking-changes rules (15 файлов) вычитаны и помечены DONE.
-- Все оставшиеся страницы переведены: итог DONE = 76.
diff --git a/docs/dist/docs/ru-guide/api-service/overview.md b/docs/dist/docs/ru-guide/api-service/overview.md
deleted file mode 100644
index 07885700..00000000
--- a/docs/dist/docs/ru-guide/api-service/overview.md
+++ /dev/null
@@ -1,312 +0,0 @@
-# Обзор API Service
-
-**Централизованный сервис выполнения protobuf‑плагинов для консистентной изолированной генерации кода**
-
-EasyP API Service устраняет хаос управления плагинами, предоставляя централизованный запуск protobuf/gRPC плагинов в изолированных Docker‑контейнерах. Он даёт единую платформу, позволяющую командам стандартизировать процесс генерации кода без операционных затрат на установку и поддержку плагинов на машинах разработчиков.
-
-## Зачем нужен EasyP API Service?
-
-### Проблема
-
-Управление генерацией protobuf/gRPC кода в командах порождает существенную операционную сложность:
-
-#### Несогласованность версий
-- Разработчики локально используют разные версии плагинов → расхождения в генерированном коде и падения сборки
-- Синдром «у меня работает» при различиях окружений
-- Требуется ручная координация, чтобы вся команда была синхронизирована по версиям
-
-#### Операционные накладные расходы
-- DevOps тратят время на установку и обновление плагинов на рабочих станциях
-- Новый разработчик — ручная настройка правильных версий
-- Обновление плагинов требует коммуникации с каждым отдельно
-- Нет централизованного контроля утверждённых версий
-
-#### Риски безопасности и комплаенса
-- Плагины ставятся из разных источников без валидации
-- Нет аудита: какой плагин для какого билда использовался
-- Сложно применять политики безопасности к инструментам генерации
-
-### Решение: централизованный запуск плагинов
-
-EasyP API Service решает эти проблемы за счёт централизованного управления:
-
-| Проблема | Решение |
-|----------|---------|
-| **Контроль версий** | Мгновенное распространение новых версий через Docker‑образы |
-| **Операции** | Команда эксплуатации управляет конфигурациями без доступа на машины разработчиков |
-| **Безопасность** | Все плагины запускаются в изолированных контейнерах с ограничениями ресурсов |
-| **Консистентность** | Единая среда выполнения вне зависимости от локальной установки |
-| **Опыт разработчика** | Не нужно устанавливать и сопровождать плагины локально |
-
-## Архитектура
-
-Архитектура сервиса упрощена и сфокусирована на надёжном выполнении плагинов:
-
-```mermaid
-graph TB
-    subgraph "Client Layer"
-        CLI[EasyP CLI]
-    end
-    
-    subgraph "EasyP API Service"
-        GRPC[gRPC Server]
-        CORE[Core Engine]
-        METRICS[Metrics Collector]
-    end
-    
-    subgraph "Plugin Execution"
-        DOCKER[Docker Runtime]
-        REGISTRY[Docker Hub Registry]
-    end
-    
-    subgraph "Storage"
-        DB[(PostgreSQL)]
-    end
-    
-    subgraph "Monitoring"
-        PROM[Prometheus]
-    end
-    
-    CLI -->|CodeGeneratorRequest| GRPC
-    GRPC --> CORE
-    
-    CORE -->|Fetch plugin params| DB
-    CORE -->|Execute plugin| DOCKER
-    CORE -->|Record metrics| METRICS
-    
-    DOCKER -->|Pull images| REGISTRY
-    
-    METRICS --> PROM
-```
-
-## Ключевые компоненты
-
-### API Layer
-- **gRPC Server** — основной API для запросов генерации
-- Каждый запуск плагина — отдельный gRPC‑запрос
-- Получает `CodeGeneratorRequest` от CLI
-
-### Execution Engine
-- **Docker Runtime** — изолированный запуск плагинов
-- Подтягивает образы из публичных реестров (Docker Hub и т.п.)
-- Применяет лимиты CPU/памяти на плагин
-
-### Storage Layer
-- **PostgreSQL** хранит параметры выполнения:
-  - Ограничения ресурсов (CPU, память)
-  - Конфигурацию и метаданные плагинов
-  - Логи выполнения (аудит)
-  - _Примечание: функциональность хранения будет расширяться_
-
-### Monitoring
-- **Prometheus** — сбор метрик
-- Отслеживает время выполнения, успешность, использование ресурсов
-
-## Как это работает
-
-### Локальное выполнение (EasyP CLI)
-При локальном запуске CLI поддерживает:
-- **Installed plugins**: системно установленные protoc плагины
-- **WASM plugins**: лёгкие WebAssembly плагины
-
-### Удалённое выполнение (API Service)
-При работе через сервис:
-- **Только Docker**: плагины запускаются как контейнеры
-- **Центральный контроль**: операционная команда управляет доступными версиями
-- **Консистентная среда**: одинаковое окружение для всех разработчиков
-
-## Поток выполнения плагина
-
-```mermaid
-sequenceDiagram
-    participant CLI as EasyP CLI
-    participant API as gRPC Server
-    participant DB as PostgreSQL
-    participant Docker as Docker Engine
-    participant Registry as Docker Registry
-    
-    Note over CLI: Парсинг protobuf-файлов
-    CLI->>API: CodeGeneratorRequest (на каждый плагин)
-    
-    API->>DB: Получение параметров плагина
-    Note over DB: Лимиты CPU/памяти<br/>Имя Docker-образа<br/>Конфиг запуска
-    DB-->>API: Параметры выполнения
-    
-    API->>Docker: Pull образ (если нужно)
-    Docker->>Registry: Загрузка образа
-    Registry-->>Docker: Образ плагина
-    
-    API->>Docker: Запуск контейнера
-    Note over Docker: Изолированное выполнение<br/>Лимиты ресурсов применены
-    Docker-->>API: CodeGeneratorResponse
-    
-    API->>PROM: Запись метрик
-    Note over PROM: Время, статус,<br/>использование ресурсов
-    
-    API-->>CLI: CodeGeneratorResponse
-```
-
-### Шаги выполнения
-
-1. **CLI Parsing**: CLI парсит локальные `.proto` файлы  
-2. **Request Sending**: Отправляет `CodeGeneratorRequest` в API Service (по одному на плагин)  
-3. **Parameter Lookup**: Сервис получает параметры запуска из PostgreSQL  
-4. **Docker Execution**: Запускает плагин в изолированном контейнере  
-5. **Metrics Recording**: Записывает метрики после завершения  
-6. **Response**: Возвращает сгенерированный код обратно в CLI  
-
-## Ключевые возможности
-
-| Возможность | Описание |
-|-------------|----------|
-| **🐳 Изоляция плагинов** | Каждый плагин в отдельном безопасном контейнере |
-| **⚙️ Контроль ресурсов** | Лимиты CPU и памяти на уровне контейнера |
-| **📊 Метрики & мониторинг** | Полный набор Prometheus метрик |
-| **🔄 Управление версиями** | Централизованно через Docker‑образы |
-| **⚡ Простой протокол** | Стандарт `CodeGeneratorRequest/Response` |
-| **🔒 Безопасность прежде всего** | Изоляция + ограниченные ресурсы |
-
-## Конфигурация
-
-Сервис настраивается через переменные окружения.
-
-### Конфигурация сервера
-```bash
-EASYP_SERVICE_HOST=0.0.0.0
-EASYP_SERVICE_GRPC_PORT=8080
-```
-
-### Конфигурация БД
-```bash
-EASYP_SERVICE_DB_HOST=localhost
-EASYP_SERVICE_DB_PORT=5432
-EASYP_SERVICE_DB_NAME=easyp_service
-EASYP_SERVICE_DB_USER=easyp
-EASYP_SERVICE_DB_PASSWORD=password
-```
-
-### Конфигурация Docker
-```bash
-# Docker socket для запуска контейнеров
-DOCKER_HOST=unix:///var/run/docker.sock
-```
-
-## Хранение параметров плагинов
-
-PostgreSQL хранит параметры выполнения для каждого плагина:
-
-```sql
--- Пример конфигурации плагина
-{
-  "plugin_name": "protobuf/go:v1.36.10",
-  "docker_image": "easyp/protoc-gen-go:v1.36.10",
-  "resources": {
-    "cpu_limit": "1.0",
-    "memory_limit": "512MB"
-  },
-  "execution_config": {
-    "timeout": "30s",
-    "network": "none"
-  }
-}
-```
-
-::: tip
-Схема хранения будет расширена — аудит логов, аналитика использования, кеширование плагинов.
-:::
-
-## Интеграция с EasyP CLI
-
-Пример `easyp.yaml` для удалённого запуска:
-
-```yaml
-generate:
-  plugins:
-    # Удалённый запуск через API Service
-    - remote: api.easyp.tech/protobuf/go:v1.36.10
-      out: .
-      opts:
-        paths: source_relative
-    
-    - remote: api.easyp.tech/grpc/go:v1.5.1
-      out: .
-      opts:
-        paths: source_relative
-```
-
-Запуск генерации:
-
-```bash
-easyp generate
-```
-
-CLI:
-1. Парсит protobuf‑файлы
-2. Отправляет отдельные запросы в сервис для каждого плагина
-3. Получает ответы с кодом
-4. Записывает файлы в указанные директории
-
-## Доступные метрики
-
-Метрики Prometheus:
-
-| Метрика | Описание |
-|---------|----------|
-| `easyp_api_service_api_grpc_server_handled_total` | Общее число gRPC запросов по статусам |
-| `easyp_api_service_api_grpc_server_handling_seconds` | Гистограмма задержек gRPC |
-| `easyp_api_service_generated_plugin_code_total` | Выполнения плагинов по имени |
-| `easyp_api_service_repo_call_duration_seconds` | Латентность запросов к БД |
-| `easyp_api_service_repo_errors_total` | Количество ошибок доступа к БД |
-| `easyp_api_service_standard_panics_total` | Число восстановленных паник |
-
-## Характеристики производительности
-
-| Показатель | Типичное значение | Примечания |
-|-----------|-------------------|-----------|
-| **Cold Start** | 2–5 сек | Первая загрузка образа |
-| **Warm Start** | 100–500 мс | Образ закеширован |
-| **Throughput** | 20–50 одновременных | Зависит от ресурсов |
-| **Memory Usage** | 50–200 MB | На выполнение одного плагина |
-
-## Безопасность
-
-### Изоляция контейнеров
-- Каждый плагин в отдельном эфемерном контейнере
-- Нет сетевого доступа в процессе выполнения
-- Лимиты CPU/памяти через Docker
-- Контейнер удаляется после завершения
-
-### Безопасность API
-- gRPC транспорт
-- Поддержка токенов аутентификации (в продакшн окружениях)
-- Валидация входных данных
-- Аудитные логи в PostgreSQL
-
-## Продакшн‑аспекты
-
-### Масштабирование
-- **Горизонтальное**: несколько инстансов за балансировщиком
-- **Ресурсы**: настройка лимитов для тяжёлых плагинов
-- **База данных**: репликация PostgreSQL для отказоустойчивости
-
-### Мониторинг
-- **Метрики**: Prometheus
-- **Алертинг**: оповещения на высокие ошибки/латентность
-- **Логи**: структурированные для аудита и отладки
-
-### План развития
-Запланировано:
-- Кеширование результатов генерации
-- Расширенный аудит и аналитика использования
-- Поддержка приватных реестров плагинов
-- Более умное распределение ресурсов
-
-## Сообщество и поддержка
-
-- **💬 [Telegram чат](https://t.me/easyptech)** — обсуждения
-- **🐛 [GitHub Issues](https://github.com/easyp-tech/service/issues)** — баги и запросы фич
-- **📖 [Документация](https://easyp.tech)** — полный набор материалов
-
----
-
-*Упростите свои protobuf‑воркфлоу с централизованным управлением выполнением плагинов.*
\ No newline at end of file
diff --git a/docs/dist/docs/ru-guide/ci-cd/github-actions.md b/docs/dist/docs/ru-guide/ci-cd/github-actions.md
deleted file mode 100644
index efb6832c..00000000
--- a/docs/dist/docs/ru-guide/ci-cd/github-actions.md
+++ /dev/null
@@ -1,403 +0,0 @@
-# GitHub Actions
-
-Полное руководство по интеграции EasyP в конвейеры GitHub Actions для линтинга, проверки несовместимых изменений, генерации кода и автоматизации релизов.
-
-## Зачем использовать EasyP в CI
-
-Встраивание EasyP в GitHub Actions даёт:
-- Единообразие правил линтинга и генерации между разработчиками.
-- Автоматическое выявление несовместимых изменений (breaking changes) до мержа.
-- Гарантию, что сгенерированный код не «устарел» относительно .proto.
-- Возможность централизованной проверки зависимостей и версии конфигурации.
-
-## Предварительные требования
-
-1. Репозиторий содержит файл конфигурации `easyp.yaml` (или находится в корне, если запускается без `--cfg`).
-2. Установлены / определены зависимости в секции `deps` (если нужны внешние импорты).
-3. Для приватных Git-репозиториев настроен доступ (SSH key / deploy key / токен).
-4. В workflow есть шаги по установке Go (если EasyP поставляется через `go install`) или заранее подготовленный бинарь.
-
-## Базовый пример (быстрый старт)
-
-Минимальный workflow для проверки линта и несовместимых изменений при открытия Pull Request:
-
-```yaml
-name: easyp-ci
-
-on:
-  pull_request:
-    paths:
-      - '**/*.proto'
-      - 'easyp.yaml'
-
-jobs:
-  lint-and-breaking:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Go
-        uses: actions/setup-go@v5
-        with:
-          go-version: '1.22'
-
-      - name: Install EasyP
-        run: go install github.com/easyp-tech/easyp/cmd/easyp@latest
-
-      - name: Verify EasyP version
-        run: |
-          which easyp
-          easyp --version
-
-      - name: Lint
-        run: easyp lint
-
-      - name: Breaking changes check (against main)
-        run: easyp breaking --against git-ref=origin/main
-```
-
-## Установка EasyP
-
-Варианты:
-1. Через `go install` (как в примере выше).
-2. Использование заранее собранного бинаря (артефакт релиза).
-
-```yaml
-- name: Download EasyP binary
-  run: |
-    curl -sL https://github.com/easyp-tech/easyp/releases/download/v1.0.0/easyp_linux_amd64 -o /usr/local/bin/easyp
-    chmod +x /usr/local/bin/easyp
-```
-
-## Кэширование
-
-Для ускорения повторных сборок можно кэшировать:
-- Go модульный кеш (если используете генерацию с плагинами Go).
-- Внешние зависимые Git-клонирования (папки `vendor` или содержимое `deps` при использовании `easyp mod download` / `easyp mod update`).
-- Сгенерированный код (если он тяжёлый, но чаще генерируется заново).
-
-Пример кэширования Go:
-
-```yaml
-- name: Cache Go build
-  uses: actions/cache@v4
-  with:
-    path: |
-      ~/go/pkg/mod
-      ~/.cache/go-build
-    key: go-${{ runner.os }}-${{ hashFiles('**/go.sum') }}
-    restore-keys: |
-      go-${{ runner.os }}-
-```
-
-Пример кэширования каталога зависимостей EasyP (если вы используете локальный vendor-подход):
-
-```yaml
-- name: Cache proto deps
-  uses: actions/cache@v4
-  with:
-    path: .easyp/deps
-    key: deps-${{ runner.os }}-${{ hashFiles('easyp.yaml') }}
-    restore-keys: |
-      deps-${{ runner.os }}-
-```
-
-(Создайте `.easyp/deps` как целевой каталог, если ваша стратегия скачивания такова.)
-
-## Линтинг
-
-Команда:
-
-```bash
-easyp lint
-```
-
-Рекомендуется:
-- В PR: всегда запускать.
-- На main: можно запускать для верификации перед релизом.
-
-Расширенный пример с выводом подробностей и игнорированием комментариев (если включено в конфиг):
-
-```yaml
-- name: Lint proto files
-  run: |
-    set -e
-    easyp lint -v
-```
-
-## Проверка несовместимых изменений (Breaking Changes)
-
-EasyP может сравнивать текущее состояние против ветки / коммита / тега.
-
-Примеры:
-```bash
-# Сравнить против origin/main
-easyp breaking --against git-ref=origin/main
-
-# Сравнить против тега релиза
-easyp breaking --against git-ref=v1.5.2
-
-# Игнорировать определённые правила (если у вас настроено в easyp.yaml)
-easyp breaking
-```
-
-Workflow шаг:
-
-```yaml
-- name: Breaking changes check
-  run: easyp breaking --against git-ref=origin/main
-```
-
-Если нужно «мягко» пропустить (например, выводить предупреждения, но не падать билд):
-
-```yaml
-- name: Breaking changes (soft)
-  run: |
-    if ! easyp breaking --against git-ref=origin/main; then
-      echo "::warning title=Breaking Changes Detected::Обнаружены потенциально несовместимые изменения"
-    fi
-```
-
-## Генерация кода
-
-Обычно для генерации:
-```bash
-easyp generate
-```
-
-Если нужно явно указать конфиг:
-```bash
-easyp --cfg easyp.yaml generate
-```
-
-Пример шага:
-
-```yaml
-- name: Generate code
-  run: |
-    easyp generate
-    git status --short
-```
-
-Можно добавить проверку «не осталось ли не закоммиченных изменений» (гарантия, что сгенерированный код актуален):
-
-```yaml
-- name: Ensure generated code is up-to-date
-  run: |
-    easyp generate
-    if [ -n "$(git status --porcelain)" ]; then
-      echo "Generated code is outdated. Please commit changes."
-      git diff --name-only
-      exit 1
-    fi
-```
-
-## Матрица (Matrix strategy)
-
-Если у вас несколько вариантов конфигураций или разных языков генерации (через плагины), можно использовать matrix:
-
-```yaml
-jobs:
-  generate:
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        lang: [go, python]
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup Go (only for go)
-        if: matrix.lang == 'go'
-        uses: actions/setup-go@v5
-        with:
-          go-version: '1.22'
-
-      - name: Install EasyP
-        run: go install github.com/easyp-tech/easyp/cmd/easyp@latest
-
-      - name: Generate
-        run: |
-          if [ "${{ matrix.lang }}" = "go" ]; then
-            easyp generate
-          elif [ "${{ matrix.lang }}" = "python" ]; then
-            easyp generate --plugin python
-          fi
-```
-
-## Работа с приватными репозиториями (deps)
-
-Если вы указываете приватные Git-пакеты в секции `deps`:
-
-1. Настройте deploy key или используйте `GIT_SSH_COMMAND` с токеном.
-2. Добавьте known_hosts (либо установите `StrictHostKeyChecking=no` для внутренних систем, но осознанно).
-
-Пример:
-
-```yaml
-- name: Prepare SSH
-  run: |
-    mkdir -p ~/.ssh
-    echo "${{ secrets.DEPLOY_KEY }}" > ~/.ssh/id_rsa
-    chmod 600 ~/.ssh/id_rsa
-    ssh-keyscan github.com >> ~/.ssh/known_hosts
-
-- name: Update deps
-  run: easyp mod update
-```
-
-## Оптимизация времени сборки
-
-- Используйте кэш для Go / deps.
-- Запускайте линт/брейкинг только если изменились `.proto` или `easyp.yaml` (paths фильтр).
-- Разделяйте workflow: быстрый линт в PR, тяжелая генерация в push на main.
-- Выносите генерацию OpenAPI / gRPC-Gateway в отдельный job (параллелизм).
-
-## Продвинутый workflow (многостадийный)
-
-```yaml
-name: easyp-pipeline
-
-on:
-  pull_request:
-    paths:
-      - '**/*.proto'
-      - 'easyp.yaml'
-  push:
-    branches:
-      - main
-
-jobs:
-  validate:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-go@v5
-        with:
-          go-version: '1.22'
-
-      - name: Install EasyP
-        run: go install github.com/easyp-tech/easyp/cmd/easyp@latest
-
-      - name: Lint
-        run: easyp lint
-
-      - name: Breaking check (against main)
-        if: github.event_name == 'pull_request'
-        run: easyp breaking --against git-ref=origin/main
-
-  generate:
-    needs: validate
-    if: github.event_name == 'push'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-go@v5
-        with:
-          go-version: '1.22'
-      - name: Install EasyP
-        run: go install github.com/easyp-tech/easyp/cmd/easyp@latest
-      - name: Generate Code
-        run: easyp generate
-      - name: Check diffs
-        run: |
-          if [ -n "$(git status --porcelain)" ]; then
-            echo "Generated files changed after generate step."
-            git diff --name-only
-            exit 1
-          fi
-```
-
-## Автоматизация релиза (пример)
-
-Можно добавить workflow, который по тегу создаёт релиз и валидирует proto:
-
-```yaml
-name: release-verify
-
-on:
-  push:
-    tags:
-      - 'v*.*.*'
-
-jobs:
-  release-check:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-go@v5
-        with:
-          go-version: '1.22'
-
-      - name: Install EasyP
-        run: go install github.com/easyp-tech/easyp/cmd/easyp@latest
-
-      - name: Lint
-        run: easyp lint
-
-      - name: Breaking vs previous tag
-        run: |
-          PREV_TAG=$(git tag --sort=-creatordate | grep -v "${GITHUB_REF_NAME}" | head -n1 || true)
-          if [ -n "$PREV_TAG" ]; then
-            echo "Comparing against $PREV_TAG"
-            easyp breaking --against git-ref=$PREV_TAG
-          else
-            echo "No previous tag, skipping breaking check"
-          fi
-
-      - name: Generate to ensure consistency
-        run: easyp generate
-```
-
-## Отладка
-
-Если нужно больше логов:
-```bash
-easyp lint -v
-easyp breaking -v --against git-ref=origin/main
-easyp generate -v
-```
-
-Добавьте вывод окружения для диагностики:
-```yaml
-- name: Debug environment
-  run: |
-    env | sort
-    easyp --version
-```
-
-## Переменные окружения (примерно)
-
-| Переменная | Назначение |
-|------------|-----------|
-| `EASYP_SERVICE_HOST` | Хост удалённого API Service (если используете удалённые плагины) |
-| `EASYP_SERVICE_GRPC_PORT` | Порт удалённого сервиса |
-| `GIT_SSH_COMMAND` | Кастомная команда SSH (частные репозитории) |
-| `GOFLAGS` | Можно выставить `-mod=readonly` для Go генерации |
-
-(Используйте только те, что действительно нужны вашему проекту.)
-
-## Частые ошибки
-
-| Симптом | Причина | Решение |
-|---------|---------|---------|
-| Линт падает на неизвестных правилах | Правила указаны в `easyp.yaml`, но версия EasyP их не поддерживает | Обновить EasyP (`go install ...@latest`) |
-| `breaking` сравнение ничего не находит | Неверный `--against` (нет fetch удалённой ветки) | Добавить шаг `git fetch --all --tags` |
-| Сгенерированный код в PR отличается от main | Отсутствует проверка генерации в CI | Добавить шаг «Ensure generated code is up-to-date» |
-| Приватные deps не скачиваются | Нет SSH ключа или токена | Настроить secrets + шаг подготовки SSH |
-| Долгое выполнение | Отсутствует кеш | Добавить кэширование модулей и deps |
-
-## Рекомендации по поддержке
-
-- Заготовить шаблон workflow и копировать между сервисами (DRY).
-- Включить `paths` фильтры, чтобы не тратить минуты на нерелевантные изменения.
-- Проверять `easyp.yaml` при изменениях отдельно — можно запускать «конфигурационный тест» (например, `easyp lint` без файлов, чтобы убедиться, что конфиг валиден).
-- При появлении новых правил линтера обновляйте конфиг и фиксируйте ошибки сразу в одной ветке.
-
----
-
-Готово: вы можете расширять разделы генерации, добавлять OpenAPI / grpc-gateway / validate плагины, матрицы по языкам и интегрировать тесты поверх сгенерированного кода, если требуется.
diff --git a/docs/dist/docs/ru-guide/ci-cd/gitlab.md b/docs/dist/docs/ru-guide/ci-cd/gitlab.md
deleted file mode 100644
index 3c72f747..00000000
--- a/docs/dist/docs/ru-guide/ci-cd/gitlab.md
+++ /dev/null
@@ -1,58 +0,0 @@
-# GitLab CI
-
-## В процессе разработки
-
-Документация по интеграции EasyP с GitLab CI находится в процессе подготовки.  
-Планируемые разделы:
-- Быстрый старт (пример `.gitlab-ci.yml` для линтинга и проверки несовместимых изменений)
-- Кэширование зависимостей и ускорение сборок
-- Генерация кода и проверка актуальности артефактов
-- Работа с приватными Git-репозиториями в `deps`
-- Матрицы (parallel jobs) для разных языков и плагинов
-- Автоматизация релизов по тегам
-
-Если вам нужен пример прямо сейчас, базовый минимальный вариант может выглядеть так:
-
-```yaml
-stages:
-  - validate
-  - generate
-
-variables:
-  GO_VERSION: "1.22"
-
-validate:
-  stage: validate
-  image: golang:${GO_VERSION}
-  before_script:
-    - go install github.com/easyp-tech/easyp/cmd/easyp@latest
-    - echo "EasyP version:"
-    - easyp --version
-    # При необходимости: git fetch --all --tags
-  script:
-    - easyp lint
-    - easyp breaking --against git-ref=origin/main
-  only:
-    changes:
-      - "**/*.proto"
-      - "easyp.yaml"
-
-generate:
-  stage: generate
-  image: golang:${GO_VERSION}
-  before_script:
-    - go install github.com/easyp-tech/easyp/cmd/easyp@latest
-  script:
-    - easyp generate
-    - |
-      if [ -n "$(git status --porcelain)" ]; then
-        echo "Сгенерированный код не актуален. Закоммитьте изменения локально."
-        git diff --name-only
-        exit 1
-      fi
-  only:
-    - main
-
-```
-
-Дополнительные рекомендации будут добавлены позже.
\ No newline at end of file
diff --git a/docs/dist/docs/ru-guide/cli/auto-completion/auto-completion.md b/docs/dist/docs/ru-guide/cli/auto-completion/auto-completion.md
deleted file mode 100644
index 7a6a1979..00000000
--- a/docs/dist/docs/ru-guide/cli/auto-completion/auto-completion.md
+++ /dev/null
@@ -1,39 +0,0 @@
-# Автодополнение
-
-## Автодополнение для zsh
-
-1. Добавьте следующую строку в ваш файл запуска `~/.zshrc`:
-
-```bash
-source <(easyp completion zsh)
-```
-
-2. Перезапустите оболочку или выполните:
-
-```bash
-source ~/.zshrc
-```
-
-## Автодополнение для Bash
-
-1. Установите [bash-completion](https://github.com/scop/bash-completion#installation) и подключите его в `~/.bashrc`.
-2. Добавьте следующую строку в файл запуска `~/.bashrc`:
-
-```bash
-source <(easyp completion bash)
-```
-
-3. Перезапустите оболочку или выполните:
-
-```bash
-source ~/.bashrc
-```
-
-## Примечания
-
-- Команда `easyp completion <shell>` выводит скрипт автодополнения для соответствующей оболочки.
-- Если используете другую оболочку (например, `fish`), можно сгенерировать вывод и сохранить вручную:
-  ```bash
-  easyp completion fish > ~/.config/fish/completions/easyp.fish
-  ```
-- При обновлении версии EasyP рекомендуется заново перезагрузить оболочку, чтобы подтянуть возможные изменения в автодополнении.
\ No newline at end of file
diff --git a/docs/dist/docs/ru-guide/cli/breaking-changes/breaking-changes.md b/docs/dist/docs/ru-guide/cli/breaking-changes/breaking-changes.md
deleted file mode 100644
index ce7970d6..00000000
--- a/docs/dist/docs/ru-guide/cli/breaking-changes/breaking-changes.md
+++ /dev/null
@@ -1,439 +0,0 @@
-# Обнаружение несовместимых изменений (Breaking Changes Detection)
-
-[[toc]]
-
-Механизм EasyP для обнаружения несовместимых (breaking) изменений помогает поддерживать обратную совместимость ваших protobuf API, автоматически выявляя изменения, способные сломать существующих клиентов. Это критично для стабильных API в продакшене.
-
-## Обзор
-
-Проверка несовместимых изменений сравнивает текущий набор protobuf‑файлов с предыдущей версией (обычно из другой Git ветки) и фиксирует модификации, которые могут вызвать проблемы совместимости для уже работающих клиентов.
-
-### Ключевые возможности
-
-- **Сравнение через Git**: Сопоставление с любой Git‑ссылкой (ветка, тег, commit)
-- **Комплексный анализ**: Проверка сервисов, сообщений, enum'ов, полей и import'ов
-- **Выборочное игнорирование**: Пропуск указанных директорий из анализа
-- **Детализированные отчёты**: Понятные ошибки с именами файлов, строками и позициями
-
-## Как работает
-
-Детектор breaking changes выполняет следующие шаги:
-
-1. **Получение ветки сравнения**: Забирает proto-файлы из указанной Git‑ссылки
-2. **Парсинг обеих версий**: Анализирует структуру текущих и предыдущих файлов
-3. **Сравнение сущностей**: Последовательно проверяет все элементы protobuf на breaking изменения
-4. **Формирование отчёта**: Генерирует подробные записи об ошибках с локациями и описаниями
-
-## Уровень проверки
-
-EasyP реализует уровень проверки **WIRE+**:
-- ✅ **Полная совместимость по wire‑формату** — старые и новые версии могут обмениваться данными
-- ✅ **Обнаружение удалений элементов** — сервисы, сообщения, поля и т.п.
-- ✅ **Безопасность типов** — выявляет несовместимые изменения типов
-- ❌ **Переименования полей/методов** — пока не детектируются (в планах)
-- ❌ **Изменения на уровне файлов** — переносы пакетов, file options ещё не проверяются
-
-Это даёт сильные гарантии совместимости и меньше ограничений, чем инструменты, требующие совместимости сгенерированного кода.
-
-## Конфигурация
-
-Настройка в `easyp.yaml`:
-
-```yaml
-breaking:
-  # Git reference для сравнения (branch, tag или commit hash)
-  against_git_ref: "main"
-  
-  # Директории, игнорируемые в анализе breaking changes
-  ignore:
-    - "experimental"
-    - "internal/proto"
-    - "vendor"
-```
-
-### Параметры конфигурации
-
-| Option | Description | Default | Required |
-|--------|-------------|---------|----------|
-| `against_git_ref` | Git‑ссылка для сравнения | `"master"` | No |
-| `ignore` | Список директорий для исключения из анализа | `[]` | No |
-
-## Использование
-
-### Базовый пример
-
-Сравнение текущих изменений с веткой main:
-
-```bash
-easyp breaking --against main
-```
-
-### Использование файла конфигурации
-
-```bash
-easyp --cfg my-config.yaml breaking
-```
-
-### Переопределение Git‑ссылки
-
-```bash
-easyp breaking --against feature/new-api
-```
-
-## Уровень проверки
-
-EasyP сейчас работает на уровне **WIRE+**, обеспечивая совместимость wire‑формата плюс защиту от удалений и изменения критичных типов.
-
-### Сравнение с категориями Buf
-
-| Check Type | Buf WIRE | Buf WIRE_JSON | Buf FILE | EasyP Current |
-|------------|----------|---------------|----------|---------------|
-| **Element Deletions** |
-| Service deletion | ❌ | ❌ | ✅ | ✅ |
-| RPC method deletion | ❌ | ❌ | ✅ | ✅ |
-| Message deletion | ❌ | ❌ | ✅ | ✅ |
-| Field deletion (by number) | ✅ | ✅ | ✅ | ✅ |
-| Enum deletion | ❌ | ❌ | ✅ | ✅ |
-| Enum value deletion | ✅ | ✅ | ✅ | ✅ |
-| OneOf deletion | ❌ | ❌ | ✅ | ✅ |
-| Import deletion | ❌ | ❌ | ✅ | ✅ |
-| **Type Changes** |
-| Field type change | ✅ | ✅ | ✅ | ✅ |
-| RPC request/response type | ✅ | ✅ | ✅ | ✅ |
-| Optional/required changes | ✅ | ✅ | ✅ | ✅ |
-| **Naming (Generated Code)** |
-| Field rename (same number) | ❌ | ✅ | ✅ | ❌ |
-| Enum value rename | ❌ | ✅ | ✅ | ✅ |
-| **File Structure** |
-| Package change | ✅ | ✅ | ✅ | ❌ |
-| File options (go_package, etc) | ❌ | ❌ | ✅ | ❌ |
-| Moving types between files | ❌ | ❌ | ✅ | ❌ |
-
-### Что это означает
-
-**✅ EasyP обнаружит:**
-- Все breaking изменения wire‑формата
-- Удаления сервисов, методов, сообщений, полей
-- Изменения типов, ломающие сериализацию
-- Переименования enum‑значений (при сохранении номера)
-
-**❌ EasyP НЕ обнаружит:**
-- Переименование полей (с тем же номером)
-- Изменение package
-- File options (go_package, java_package, и т.п.)
-- Перемещение типов между файлами в одном package
-
-## Правила Breaking Changes
-
-EasyP обнаруживает следующие типы breaking изменений:
-
-### Сравнение уровней
-
-| Detection Level | Description | EasyP Support |
-|----------------|-------------|---------------|
-| **WIRE** | Совместимость только по wire‑формату | ✅ **Full support** |
-| **WIRE+** | Wire + обнаружение удалений | ✅ **Current level** |
-| **FILE** | Совместимость сгенерированного кода | ❌ Partial (planned) |
-
-## Категории правил
-
-Каждая категория имеет свою документацию с примерами:
-
-### 🚨 Изменения Service и RPC
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [SERVICE_NO_DELETE](./rules/service-no-delete.md) | Services cannot be deleted | ✅ Implemented |
-| [RPC_NO_DELETE](./rules/rpc-no-delete.md) | RPC methods cannot be deleted | ✅ Implemented |
-| [RPC_SAME_REQUEST_TYPE](./rules/rpc-same-request-type.md) | RPC request types cannot be changed | ✅ Implemented |
-| [RPC_SAME_RESPONSE_TYPE](./rules/rpc-same-response-type.md) | RPC response types cannot be changed | ✅ Implemented |
-
-### 📦 Изменения Message и Field
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [MESSAGE_NO_DELETE](./rules/message-no-delete.md) | Messages cannot be deleted | ✅ Implemented |
-| [FIELD_NO_DELETE](./rules/field-no-delete.md) | Fields cannot be deleted | ✅ Implemented |
-| [FIELD_SAME_TYPE](./rules/field-same-type.md) | Field types cannot be changed | ✅ Implemented |
-| [FIELD_SAME_CARDINALITY](./rules/field-same-cardinality.md) | Field optionality (optional/required) cannot be changed | ✅ Implemented |
-
-### 🔢 Изменения Enum
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [ENUM_NO_DELETE](./rules/enum-no-delete.md) | Enums cannot be deleted | ✅ Implemented |
-| [ENUM_VALUE_NO_DELETE](./rules/enum-value-no-delete.md) | Enum values cannot be deleted | ✅ Implemented |
-| [ENUM_VALUE_SAME_NAME](./rules/enum-value-same-name.md) | Enum value names cannot be changed | ✅ Implemented |
-
-### 🔗 Изменения OneOf
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [ONEOF_NO_DELETE](./rules/oneof-no-delete.md) | OneOf fields cannot be deleted | ✅ Implemented |
-| [ONEOF_FIELD_NO_DELETE](./rules/oneof-field-no-delete.md) | Fields within oneofs cannot be deleted | ✅ Implemented |
-| [ONEOF_FIELD_SAME_TYPE](./rules/oneof-field-same-type.md) | OneOf field types cannot be changed | ✅ Implemented |
-
-### 📥 Изменения Import
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [IMPORT_NO_DELETE](./rules/import-no-delete.md) | Import statements cannot be removed | ✅ Implemented |
-
-## Не обнаруживается сейчас
-
-Изменения ниже **НЕ детектируются** EasyP (могут ломать сгенерированный код):
-
-| Change Type | Example | Impact |
-|-------------|---------|--------|
-| Field renaming | `string name = 1` → `string full_name = 1` | Ломает код |
-| Package changes | `package v1` → `package v2` | Меняются пути импорта |
-| File options | `option go_package = "old"` → `option go_package = "new"` | Меняется расположение кода |
-| Moving between files | Message перемещено в другой .proto | Зависимости import'ов |
-
-## Документация правил
-
-См. подробные файлы правил для примеров и стратегий миграции:
-
-- Service: [SERVICE_NO_DELETE](./rules/service-no-delete.md), [RPC_NO_DELETE](./rules/rpc-no-delete.md), [RPC_SAME_REQUEST_TYPE](./rules/rpc-same-request-type.md), [RPC_SAME_RESPONSE_TYPE](./rules/rpc-same-response-type.md)
-- Message: [MESSAGE_NO_DELETE](./rules/message-no-delete.md), [FIELD_NO_DELETE](./rules/field-no-delete.md), [FIELD_SAME_TYPE](./rules/field-same-type.md), [FIELD_SAME_CARDINALITY](./rules/field-same-cardinality.md)
-- Enum: [ENUM_NO_DELETE](./rules/enum-no-delete.md), [ENUM_VALUE_NO_DELETE](./rules/enum-value-no-delete.md), [ENUM_VALUE_SAME_NAME](./rules/enum-value-same-name.md)
-- OneOf: [ONEOF_NO_DELETE](./rules/oneof-no-delete.md), [ONEOF_FIELD_NO_DELETE](./rules/oneof-field-no-delete.md), [ONEOF_FIELD_SAME_TYPE](./rules/oneof-field-same-type.md)
-- Import: [IMPORT_NO_DELETE](./rules/import-no-delete.md)
-
-Каждое правило содержит:
-- ❌ Плохие примеры (breaking)
-- ✅ Безопасные альтернативы
-- 🔧 Стратегии миграции
-- 📋 Реальные сообщения ошибок из EasyP
-
-## Быстрые примеры
-
-### ✅ Безопасные изменения (разрешены всегда)
-```proto
-// Добавление новых элементов — безопасно
-message User {
-  string name = 1;
-  string email = 2;
-  string phone = 3;  // ✅ Новое поле
-}
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc GetUserProfile(GetUserRequest) returns (UserProfile);  // ✅ Новый RPC
-}
-
-enum Status {
-  STATUS_UNSPECIFIED = 0;
-  STATUS_ACTIVE = 1;
-  STATUS_PENDING = 2;  // ✅ Новое enum значение
-}
-```
-
-### ❌ Несовместимые изменения (обнаруживаются всегда)
-```proto
-// Удаления и смена типов ломают совместимость
-message User {
-  string name = 1;
-  // ❌ Удалённое поле
-}
-
-service UserService {
-  // ❌ Удалённый RPC метод
-  rpc GetUser(GetUserRequestV2) returns (GetUserResponse);  // ❌ Изменён тип запроса
-}
-```
-
-### Сценарий: Изменения пока не детектируются
-
-```proto
-// 🟡 Ломает сгенерированный код, но проходит проверки EasyP
-message User {
-  string user_name = 1;    // Переименовано с "name"
-  string user_email = 2;   // Переименовано с "email"
-}
-
-service UserService {
-  rpc GetUserProfile(GetUserRequest) returns (GetUserResponse);  // Переименовано с GetUser
-}
-```
-
-## Формат вывода
-
-### Текстовый формат (по умолчанию)
-
-```
-services.proto:45:1: Previously present RPC "DeleteUser" on service "UserService" was deleted. (BREAKING_CHECK)
-messages.proto:15:3: Previously present field "2" with name "email" on message "User" was deleted. (BREAKING_CHECK)
-```
-
-### JSON формат
-
-```bash
-easyp --format json breaking --against main
-```
-
-```json
-{
-  "path": "services.proto",
-  "position": {
-    "line": 45,
-    "column": 1
-  },
-  "source_name": "",
-  "message": "Previously present RPC \"DeleteUser\" on service \"UserService\" was deleted.",
-  "rule_name": "BREAKING_CHECK"
-}
-```
-
-## Best Practices
-
-### 1. Регулярный запуск
-Добавьте проверку несовместимых изменений в CI/CD:
-
-```yaml
-- name: Check for breaking changes
-  run: easyp breaking --against origin/main
-```
-
-### 2. Защита веток
-Блокируйте слияния с breaking изменениями:
-
-```yaml
-if: github.event_name == 'pull_request'
-run: |
-  easyp breaking --against origin/main
-  if [ $? -eq 1 ]; then
-    echo "Breaking changes detected!"
-    exit 1
-  fi
-```
-
-### 3. Стратегия версионирования
-При необходимости breaking изменений:
-- Создайте новую версию пакета (`myservice.v2`)
-- Поддерживайте старую версию в период миграции
-- Добавляйте уведомления о деприкации
-
-### 4. Игнорирование путей
-Используйте ignore осознанно:
-
-```yaml
-breaking:
-  ignore:
-    - "experimental/**"
-    - "internal/**"
-    - "**/testing/**"
-```
-
-## Частые проблемы
-
-### Проблема: "Repository does not exist"
-Решение: Выполняйте команду внутри Git репозитория с нужной веткой.
-
-### Проблема: "Cannot find git ref"
-Решение: Проверьте наличие ссылки:
-```bash
-git branch -a
-git tag
-```
-
-### Проблема: Ложные срабатывания на сгенерированный код
-Решение: Исключите директории генерации:
-```yaml
-breaking:
-  ignore:
-    - "generated/**"
-    - "**/pb/**"
-```
-
-### Проблема: Очень много изменений
-Решение:
-1. Создайте новую версию API
-2. Вносите изменения постепенно
-3. Используйте feature flags
-
-## Примеры интеграции
-
-### GitHub Actions
-
-```yaml
-name: API Compatibility Check
-
-on:
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  breaking-changes:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          fetch-depth: 0
-      - name: Install EasyP
-        run: |
-          curl -sSfL https://raw.githubusercontent.com/easyp-tech/easyp/main/install.sh | sh
-      - name: Check for breaking changes
-        run: |
-          ./bin/easyp breaking --against origin/main
-```
-
-### GitLab CI
-
-```yaml
-breaking-changes:
-  stage: test
-  image: easyp/lint:latest
-  script:
-    - git fetch origin main
-    - easyp breaking --against origin/main
-  rules:
-    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
-```
-
-### Pre-commit / pre-push hook
-
-```bash
-#!/bin/sh
-# .git/hooks/pre-push
-
-protected_branch='main'
-current_branch=$(git symbolic-ref HEAD | sed -e 's,.*/\(.*\),\1,')
-
-if [ $current_branch = $protected_branch ]; then
-    echo "Running breaking changes check..."
-    easyp breaking --against HEAD~1
-    if [ $? -eq 1 ]; then
-        echo "❌ Breaking changes detected. Push rejected."
-        exit 1
-    fi
-    echo "✅ No breaking changes detected."
-fi
-```
-
-## Troubleshooting
-
-### Режим отладки
-Включите debug‑логирование:
-
-```bash
-easyp --debug breaking --against main
-```
-
-### Ручное сравнение
-Для сложных случаев:
-
-```bash
-git show main:path/to/file.proto > old_version.proto
-easyp lint old_version.proto
-easyp lint current_file.proto
-```
-
-### Оптимизация производительности
-Ограничьте область:
-
-```bash
-easyp breaking --against main --path api/
-```
-
-Механизм обнаружения несовместимых изменений в EasyP обеспечивает надёжную основу для безопасной эволюции protobuf‑схем при сохранении совместимости API.
diff --git a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/enum-no-delete.md b/docs/dist/docs/ru-guide/cli/breaking-changes/rules/enum-no-delete.md
deleted file mode 100644
index 9e5a6131..00000000
--- a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/enum-no-delete.md
+++ /dev/null
@@ -1,319 +0,0 @@
-<!-- TODO: Review translation -->
-
-# ENUM_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что ни один enum не был удалён из proto‑файлов. Удаление enum ломает совместимость по wire‑формату и сгенерированный код: сохранённые данные могут содержать удалённые значения, а клиентский код опирается на сгенерированные типы и константы enum.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-enum UserRole { // [!code --]
-  USER_ROLE_UNSPECIFIED = 0; // [!code --]
-  USER_ROLE_ADMIN = 1; // [!code --]
-  USER_ROLE_USER = 2; // [!code --]
-} // [!code --]
-
-message Order {
-  string id = 1;
-  OrderStatus status = 2;
-  UserRole created_by_role = 3;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-// UserRole enum удалён — BREAKING CHANGE!
-
-message Order {
-  string id = 1;
-  OrderStatus status = 2;
-  UserRole created_by_role = 3; // ERROR: UserRole больше не существует
-}
-```
-
-**Ошибка:**
-```
-user.proto:8:1: Previously present enum "UserRole" was deleted from file. (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Удаление вложенного enum:**
-```proto
-// Before
-message User {
-  string name = 1;
-  Status status = 2;
-  
-  enum Status { // [!code --]
-    STATUS_UNSPECIFIED = 0; // [!code --]
-    STATUS_ACTIVE = 1; // [!code --]
-    STATUS_INACTIVE = 2; // [!code --]
-  } // [!code --]
-}
-
-// After - BREAKING CHANGE!
-message User {
-  string name = 1;
-  Status status = 2;  // ERROR: Status удалён
-  
-  // Вложенный enum Status удалён
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления — пометить enum deprecated:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-enum UserRole {
-  option deprecated = true; // [!code focus]
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMIN = 1;
-  USER_ROLE_USER = 2;
-}
-
-message Order {
-  string id = 1;
-  OrderStatus status = 2;
-  UserRole created_by_role = 3 [deprecated = true]; // [!code focus]
-}
-```
-
-**Или заменить новым enum:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-enum UserRole {
-  option deprecated = true; // [!code focus] // Старый enum
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMIN = 1;
-  USER_ROLE_USER = 2;
-}
-
-enum UserPermission { // [!code focus] // Новый enum
-  USER_PERMISSION_UNSPECIFIED = 0; // [!code focus]
-  USER_PERMISSION_READ = 1; // [!code focus]
-  USER_PERMISSION_WRITE = 2; // [!code focus]
-  USER_PERMISSION_ADMIN = 3; // [!code focus]
-} // [!code focus]
-
-message Order {
-  string id = 1;
-  OrderStatus status = 2;
-  UserRole created_by_role = 3 [deprecated = true]; // [!code focus]
-  UserPermission created_by_permission = 4; // [!code focus]
-}
-```
-
-## Влияние
-
-- **Wire Format:** Данные с удалённым enum не десериализуются корректно
-- **Generated Code:** Тип и константы удаляются — компиляция клиентов ломается
-- **Field References:** Поля с типом удалённого enum становятся невалидны
-- **Switch Statements:** `switch` по enum ломается (неизвестные кейсы)
-
-## Реальный пример
-
-**Код клиента ломается:**
-```go
-// Before
-order := &myapi.Order{
-    Id:            "order123",
-    Status:        myapi.OrderStatus_ORDER_STATUS_PENDING,
-    CreatedByRole: myapi.UserRole_USER_ROLE_ADMIN,  // ERROR после удаления
-}
-
-switch order.CreatedByRole {
-case myapi.UserRole_USER_ROLE_ADMIN:  // ERROR
-    // Admin logic
-case myapi.UserRole_USER_ROLE_USER:   // ERROR
-    // User logic
-}
-
-// undefined: myapi.UserRole
-// undefined: myapi.UserRole_USER_ROLE_ADMIN
-```
-
-**Старые данные становятся нечитаемыми:**
-```json
-{
-  "id": "order123",
-  "status": "ORDER_STATUS_PENDING",
-  "created_by_role": "USER_ROLE_ADMIN"
-}
-// После удаления UserRole — парсер не знает поле created_by_role
-```
-
-**Серверная логика ломается:**
-```go
-func validateOrder(order *Order) error {
-    switch order.CreatedByRole {
-    case UserRole_USER_ROLE_ADMIN:  // ERROR
-        return nil
-    case UserRole_USER_ROLE_USER:   // ERROR
-        return validateUserOrder(order)
-    default:
-        return errors.New("invalid user role")
-    }
-}
-```
-
-## Стратегия миграции
-
-1. **Депрецируйте enum:**
-   ```proto
-   enum OldEnum {
-     option deprecated = true;
-     // ...
-   }
-   ```
-2. **Пометьте поля со старым enum deprecated:**
-   ```proto
-   OldEnum old_field = 5 [deprecated = true];
-   ```
-3. **Создайте новый enum:**
-   ```proto
-   enum NewEnum {
-     // Улучшенный набор значений
-   }
-   NewEnum new_field = 6;
-   ```
-4. **Сервер обрабатывает оба:**
-   ```go
-   func handleRole(oldRole OldEnum, newRole NewEnum) {
-       if newRole != NEW_ENUM_UNSPECIFIED {
-           return handleNewRole(newRole)
-       }
-       return handleOldRole(oldRole)
-   }
-   ```
-5. **Удалите старый enum в следующей major‑версии.**
-
-## Типовые сценарии
-
-### Редизайн enum
-```proto
-enum Priority {
-  option deprecated = true;
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_HIGH = 2;
-}
-
-enum TaskPriority {
-  TASK_PRIORITY_UNSPECIFIED = 0;
-  TASK_PRIORITY_LOW = 1;
-  TASK_PRIORITY_MEDIUM = 2;
-  TASK_PRIORITY_HIGH = 3;
-  TASK_PRIORITY_URGENT = 4;
-}
-```
-
-### Консолидация enum
-```proto
-enum Status {
-  option deprecated = true;
-  STATUS_UNSPECIFIED = 0;
-  STATUS_ACTIVE = 1;
-}
-
-enum State {
-  option deprecated = true;
-  STATE_UNSPECIFIED = 0;
-  STATE_ENABLED = 1;
-}
-
-enum EntityStatus {
-  ENTITY_STATUS_UNSPECIFIED = 0;
-  ENTITY_STATUS_ACTIVE = 1;
-  ENTITY_STATUS_INACTIVE = 2;
-  ENTITY_STATUS_ENABLED = 3;
-  ENTITY_STATUS_DISABLED = 4;
-}
-```
-
-### Перемещение enum в новый пакет
-```proto
-enum UserRole {
-  option deprecated = true;
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMIN = 1;
-}
-
-import "common/roles.proto";
-
-message Order {
-  UserRole old_role = 3 [deprecated = true];
-  common.UserRole new_role = 4;
-}
-```
-
-### Версионирование / новая версия пакета
-```proto
-package myapi.v2;
-
-enum UserPermission {
-  USER_PERMISSION_UNSPECIFIED = 0;
-  USER_PERMISSION_READ = 1;
-  USER_PERMISSION_WRITE = 2;
-  USER_PERMISSION_ADMIN = 3;
-}
-
-message Order {
-  string id = 1;
-  UserPermission created_by_permission = 2;
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/enum-value-no-delete.md b/docs/dist/docs/ru-guide/cli/breaking-changes/rules/enum-value-no-delete.md
deleted file mode 100644
index 6466badd..00000000
--- a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/enum-value-no-delete.md
+++ /dev/null
@@ -1,299 +0,0 @@
-<!-- TODO: Review translation -->
-
-# ENUM_VALUE_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Правило проверяет, что ни одно значение enum (enum value) не было удалено. Удаление значения ломает совместимость по wire‑формату и сгенерированный код: в уже сохранённых данных могут присутствовать удалённые значения, а клиентский код может ссылаться на соответствующие константы.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-  ORDER_STATUS_CANCELLED = 5;
-}
-
-enum Priority {
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_MEDIUM = 2;
-  PRIORITY_HIGH = 3;
-  PRIORITY_URGENT = 4;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-  // ORDER_STATUS_CANCELLED = 5; // [!code --] Удалено значение enum — BREAKING!
-}
-
-enum Priority {
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_MEDIUM = 2;
-  PRIORITY_HIGH = 3;
-  // PRIORITY_URGENT = 4; // [!code --] Удалено значение enum — BREAKING!
-}
-```
-
-**Ошибка:**
-```
-order.proto:9:3: Previously present enum value "5" on enum "OrderStatus" was deleted. (BREAKING_CHECK)
-priority.proto:8:3: Previously present enum value "4" on enum "Priority" was deleted. (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Множественное удаление значений:**
-```proto
-// Before
-enum UserRole {
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_GUEST = 1;
-  USER_ROLE_USER = 2;
-  USER_ROLE_MODERATOR = 3;
-  USER_ROLE_ADMIN = 4;
-  USER_ROLE_SUPERADMIN = 5;
-}
-
-// After - BREAKING CHANGES!
-enum UserRole {
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_USER = 2;
-  USER_ROLE_ADMIN = 4;
-  // USER_ROLE_GUEST = 1;      // BREAKING: deleted
-  // USER_ROLE_MODERATOR = 3;  // BREAKING: deleted
-  // USER_ROLE_SUPERADMIN = 5; // BREAKING: deleted
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления — пометить значения deprecated:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-  ORDER_STATUS_CANCELLED = 5 [deprecated = true]; // [!code focus]
-}
-
-enum Priority {
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_MEDIUM = 2;
-  PRIORITY_HIGH = 3;
-  PRIORITY_URGENT = 4 [deprecated = true]; // [!code focus]
-}
-```
-
-**Или зарезервировать номер и имя после удаления:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  reserved 5; // [!code focus]
-  reserved "ORDER_STATUS_CANCELLED"; // [!code focus]
-
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-enum Priority {
-  reserved 4; // [!code focus]
-  reserved "PRIORITY_URGENT"; // [!code focus]
-
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_MEDIUM = 2;
-  PRIORITY_HIGH = 3;
-}
-```
-
-## Влияние
-
-- **Wire Format:** Данные с удалёнными значениями не десериализуются корректно
-- **Generated Code:** Константы исчезают — клиентский код не компилируется
-- **Client Applications:** Ссылки на удалённые значения вызывают ошибки компиляции
-- **Switch Statements:** `switch` по enum ломается (неизвестные case)
-- **Default Handling:** Поведение при неизвестных значениях меняется
-
-## Реальный пример
-
-**Код клиента ломается:**
-```go
-order := &myapi.Order{
-    Status: myapi.OrderStatus_ORDER_STATUS_CANCELLED, // ERROR после удаления
-}
-
-switch order.Status {
-case myapi.OrderStatus_ORDER_STATUS_PENDING:
-    // Pending
-case myapi.OrderStatus_ORDER_STATUS_CANCELLED: // ERROR: undefined
-    // Cancellation
-default:
-    // Unknown
-}
-// undefined: myapi.OrderStatus_ORDER_STATUS_CANCELLED
-```
-
-**Проблемы с уже сохранёнными данными:**
-```json
-{
-  "id": "order123",
-  "status": "ORDER_STATUS_CANCELLED"
-}
-// После удаления: парсер даёт UNSPECIFIED (0) или ошибку
-```
-
-**Валидация на сервере:**
-```go
-func validateOrderStatus(status OrderStatus) error {
-    switch status {
-    case OrderStatus_ORDER_STATUS_PENDING,
-         OrderStatus_ORDER_STATUS_CONFIRMED,
-         OrderStatus_ORDER_STATUS_SHIPPED,
-         OrderStatus_ORDER_STATUS_DELIVERED,
-         OrderStatus_ORDER_STATUS_CANCELLED: // ERROR после удаления
-        return nil
-    default:
-        return errors.New("invalid order status")
-    }
-}
-
-func canModifyOrder(order *Order) bool {
-    return order.Status != OrderStatus_ORDER_STATUS_CANCELLED // ERROR
-}
-```
-
-## Стратегия миграции
-
-1. **Сначала пометить deprecated:**
-   ```proto
-   ORDER_STATUS_CANCELLED = 5 [deprecated = true];
-   ```
-2. **Перестать использовать deprecated значение в новом коде:**
-   ```go
-   order.Status = OrderStatus_ORDER_STATUS_DELIVERED
-   ```
-3. **Обработка legacy в клиенте:**
-   ```go
-   switch order.Status {
-   case OrderStatus_ORDER_STATUS_CANCELLED:
-       log.Warn("Legacy cancelled status")
-       // Дополнительная логика
-   }
-   ```
-4. **Резервирование после миграции:**
-   ```proto
-   reserved 5, "ORDER_STATUS_CANCELLED";
-   ```
-5. **Никогда не переиспользовать номера** — зарезервированы навсегда.
-
-## Типовые сценарии
-
-### Изменения бизнес‑логики
-```proto
-enum ProductStatus {
-  PRODUCT_STATUS_UNSPECIFIED = 0;
-  PRODUCT_STATUS_ACTIVE = 1;
-  PRODUCT_STATUS_INACTIVE = 2;
-  PRODUCT_STATUS_DISCONTINUED = 3 [deprecated = true];
-}
-```
-
-### Упрощение workflow
-```proto
-enum TaskStatus {
-  TASK_STATUS_UNSPECIFIED = 0;
-  TASK_STATUS_TODO = 1;
-  TASK_STATUS_IN_PROGRESS = 2;
-  TASK_STATUS_IN_REVIEW = 3 [deprecated = true];
-  TASK_STATUS_APPROVED = 4 [deprecated = true];
-  TASK_STATUS_DONE = 5;
-}
-```
-
-### Объединение enum
-```proto
-enum NotificationLevel {
-  NOTIFICATION_LEVEL_UNSPECIFIED = 0;
-  NOTIFICATION_LEVEL_INFO = 1;
-  NOTIFICATION_LEVEL_WARNING = 2;
-  NOTIFICATION_LEVEL_ERROR = 3;
-  NOTIFICATION_LEVEL_DEBUG = 4 [deprecated = true];
-  NOTIFICATION_LEVEL_TRACE = 5 [deprecated = true];
-}
-```
-
-## Особенности wire‑формата
-
-### Предотвращение переиспользования номера
-```proto
-enum Status {
-  reserved 2;
-  reserved "STATUS_DELETED";
-
-  STATUS_UNSPECIFIED = 0;
-  STATUS_ACTIVE = 1;
-  STATUS_INACTIVE = 3;
-  // STATUS_DELETED = 2; // Не переиспользуем
-}
-```
-
-### JSON совместимость
-```proto
-enum Color {
-  reserved 2;
-  reserved "RED";
-
-  COLOR_UNSPECIFIED = 0;
-  COLOR_BLUE = 1;
-  COLOR_GREEN = 3;
-  // COLOR_RED = 2; // Был удалён
-}
-```
-
-### Proto2 vs Proto3
-```proto
-enum MyEnum {
-  MY_ENUM_UNSPECIFIED = 0;
-  MY_ENUM_VALUE_OLD = 1 [deprecated = true];
-  MY_ENUM_VALUE_NEW = 2;
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/enum-value-same-name.md b/docs/dist/docs/ru-guide/cli/breaking-changes/rules/enum-value-same-name.md
deleted file mode 100644
index f45ee254..00000000
--- a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/enum-value-same-name.md
+++ /dev/null
@@ -1,172 +0,0 @@
-<!-- TODO: Review translation -->
-
-# ENUM_VALUE_SAME_NAME
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что имя enum значения для каждого номера (number) не изменилось. Переименование enum значения при сохранении его номера ломает совместимость JSON и сгенерированный код: клиенты ожидают конкретные имена констант.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_APPROVED = 2; // [!code --] Было ORDER_STATUS_CONFIRMED
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_COMPLETED = 4; // [!code --] Было ORDER_STATUS_DELIVERED
-}
-```
-
-**Ошибка:**
-```
-order.proto:7:3: Enum value "2" on enum "OrderStatus" changed name from "ORDER_STATUS_CONFIRMED" to "ORDER_STATUS_APPROVED". (BREAKING_CHECK)
-order.proto:9:3: Enum value "4" on enum "OrderStatus" changed name from "ORDER_STATUS_DELIVERED" to "ORDER_STATUS_COMPLETED". (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Множественные переименования:**
-```proto
-// Before
-enum UserRole {
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMIN = 1;
-  USER_ROLE_MODERATOR = 2;
-  USER_ROLE_USER = 3;
-}
-
-// After - ВСЁ BREAKING
-enum UserRole {
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMINISTRATOR = 1;  // BREAKING: ADMIN -> ADMINISTRATOR
-  USER_ROLE_MOD = 2;            // BREAKING: MODERATOR -> MOD
-  USER_ROLE_MEMBER = 3;         // BREAKING: USER -> MEMBER
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо переименования — добавить новые значения и пометить старые deprecated:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2 [deprecated = true]; // [!code focus]
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4 [deprecated = true]; // [!code focus]
-  ORDER_STATUS_APPROVED = 5; // [!code focus] // Новое значение вместо переименования
-  ORDER_STATUS_COMPLETED = 6; // [!code focus]
-}
-```
-
-**Или создать новую версию enum:**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus]
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_APPROVED = 2; // [!code focus] // «Чистые» имена в v2
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_COMPLETED = 4; // [!code focus]
-}
-```
-
-## Влияние
-
-- **Generated Code:** Меняются имена констант — компиляция клиентов ломается
-- **JSON Compatibility:** JSON использует имена enum — старые документы не парсятся
-- **Client Applications:** Код со старым именем константы не компилируется
-- **Documentation:** Документация устаревает с неправильными именами
-
-## Реальный пример
-
-**Ломается код клиента:**
-```go
-// Before
-status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED
-if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED {
-    // handle delivery
-}
-
-// After (переименовано) — ошибки компиляции
-status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED  // ERROR: undefined
-if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // ERROR: undefined
-    // handle delivery
-}
-```
-
-**JSON совместимость ломается:**
-```json
-// Раньше
-{
-  "status": "ORDER_STATUS_CONFIRMED"
-}
-
-// После
-{
-  "status": "ORDER_STATUS_APPROVED" // Старые JSON больше не парсятся
-}
-```
-
-## Стратегия миграции
-
-1. **Добавьте новое значение вместо переименования:**
-   ```proto
-   ORDER_STATUS_CONFIRMED = 2 [deprecated = true];
-   ORDER_STATUS_APPROVED = 5;
-   ```
-
-2. **Сервер обрабатывает оба значения на переходном этапе**
-3. **Мигрируйте клиентов** на новые значения
-4. **Удалите (reserve) старое имя и номер** в следующей major‑версии:
-   ```proto
-   reserved 2, "ORDER_STATUS_CONFIRMED";
-   ORDER_STATUS_APPROVED = 5;
-   ```
-
-## Allow Alias (исключение)
-
-С `allow_alias = true` можно временно иметь два имени для одного номера:
-
-```proto
-enum Status {
-  option allow_alias = true;
-  STATUS_UNSPECIFIED = 0;
-  STATUS_OLD_NAME = 1 [deprecated = true];
-  STATUS_NEW_NAME = 1; // Один номер, два имени
-}
-```
-
-Примечание: Сейчас EasyP всё равно считает это breaking (может измениться в будущем).
diff --git a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/field-no-delete.md b/docs/dist/docs/ru-guide/cli/breaking-changes/rules/field-no-delete.md
deleted file mode 100644
index 63419210..00000000
--- a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/field-no-delete.md
+++ /dev/null
@@ -1,102 +0,0 @@
-<!-- TODO: Review translation -->
-
-# FIELD_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что ни одно поле сообщения (message field) не было удалено. Удаление поля ломает совместимость по wire‑формату и сгенерированный код: в существующих данных может присутствовать удалённое поле, а клиентский код может ссылаться на него.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-  string phone = 4; // [!code --]
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-  // phone поле удалено — BREAKING CHANGE!
-}
-```
-
-**Ошибка:**
-```
-user.proto:6:3: Previously present field "4" with name "phone" on message "User" was deleted. (BREAKING_CHECK)
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления — пометить поле deprecated:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-  string phone = 4 [deprecated = true]; // [!code focus]
-}
-```
-
-**Или зарезервировать номер и имя поля после удаления:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  reserved 4; // [!code focus]
-  reserved "phone"; // [!code focus]
-  
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-}
-```
-
-## Влияние
-
-- **Wire Format:** Старые сообщения с удалённым полем некорректно десериализуются
-- **Generated Code:** Удаляются аксессоры (get/set), компиляция клиента ломается
-- **Data Loss:** Потеря сохранённых данных, связанных с полем
-- **JSON Compatibility:** JSON парсеры ожидают наличие поля и могут выдавать ошибки
-
-## Стратегия миграции
-
-1. **Сначала пометить deprecated:**
-   ```proto
-   string old_field = 5 [deprecated = true];
-   ```
-
-2. **Прекратить запись в поле** в прикладном коде
-
-3. **Зарезервировать поле** в следующей версии, чтобы избежать повторного использования:
-   ```proto
-   reserved 5;
-   reserved "old_field";
-   ```
-
-4. **Никогда не переиспользовать номер поля** — должен оставаться в reserved навсегда
\ No newline at end of file
diff --git a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/field-same-cardinality.md b/docs/dist/docs/ru-guide/cli/breaking-changes/rules/field-same-cardinality.md
deleted file mode 100644
index 753c778c..00000000
--- a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/field-same-cardinality.md
+++ /dev/null
@@ -1,282 +0,0 @@
-<!-- TODO: Review translation -->
-
-# FIELD_SAME_CARDINALITY
-
-Категории:
-
-- **WIRE+**
-
-Правило проверяет, что поля сообщений сохраняют ту же кардинальность (обязательность / optional). Изменение кардинальности поля ломает совместимость по wire‑формату и сгенерированный код: семантика присутствия и ожидания клиентского кода отличаются для optional и required (implicit) полей.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-}
-
-message CreateUserRequest {
-  string name = 1;
-  optional string email = 2;
-  string phone = 3;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  optional string email = 2; // [!code --] Было required (implicit), стало optional
-  int32 age = 3;
-}
-
-message CreateUserRequest {
-  string name = 1;
-  string email = 2; // [!code --] Было optional, стало требуемым (implicit required)
-  string phone = 3;
-}
-```
-
-**Ошибка:**
-```
-user.proto:6:3: Field "2" with name "email" on message "User" became optional. (BREAKING_CHECK)
-request.proto:7:3: Field "2" with name "email" on message "CreateUserRequest" became not optional. (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Проблемы миграции Proto2 → Proto3:**
-
-```proto
-// Before (proto2)
-syntax = "proto2";
-
-message Order {
-  required string id = 1;
-  optional string notes = 2;
-  repeated string tags = 3;
-}
-
-// After (proto3) - BREAKING CHANGES!
-syntax = "proto3";
-
-message Order {
-  string id = 1;           // BREAKING: required -> implicit optional
-  string notes = 2;        // BREAKING: explicit optional -> implicit optional
-  repeated string tags = 3; // OK
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо изменения кардинальности — добавьте новое поле:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2 [deprecated = true]; // [!code focus] Сохраняем старую кардинальность
-  int32 age = 3;
-  optional string email_optional = 4; // [!code focus] Новое optional поле
-}
-
-message CreateUserRequest {
-  string name = 1;
-  optional string email = 2 [deprecated = true]; // [!code focus]
-  string phone = 3;
-  string email_required = 4; // [!code focus] Новое требуемое поле
-}
-```
-
-**Или создайте новую версию сообщения:**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus]
-
-message User {
-  string name = 1;
-  optional string email = 2; // [!code focus] Чистая модель в v2
-  int32 age = 3;
-}
-
-message CreateUserRequest {
-  string name = 1;
-  string email = 2; // [!code focus] Требуемое в v2
-  string phone = 3;
-}
-```
-
-## Влияние
-
-- **Wire Format:** Меняется семантика присутствия — клиенты неправильно ожидают поля
-- **Generated Code:** Меняются методы доступа / проверки (has, clear)
-- **Validation:** Правила проверки обязательности переписываются
-- **Default Values:** Optional и required по‑разному обрабатывают отсутствие значения
-
-## Реальный пример
-
-**Код клиента ломается при смене кардинальности:**
-```go
-// Before - поле фактически требуется (implicit)
-user := &myapi.User{
-    Name:  "John",
-    Email: "john@example.com",
-    Age:   30,
-}
-
-if user.Email != "" {
-    // Есть значение
-}
-
-// After - поле стало optional (pointer)
-user := &myapi.User{
-    Name: "John",
-    Age:  30,
-    // Email может отсутствовать
-}
-
-if user.Email != nil && *user.Email != "" {
-    // Есть значение (новый способ)
-}
-
-user.Email = &emailValue // Присваивание указателя вместо строки
-```
-
-**Валидация на сервере:**
-```go
-// Before
-func validateUser(user *User) error {
-    if user.Email == "" {
-        return errors.New("email is required")
-    }
-    return nil
-}
-
-// After
-func validateUser(user *User) error {
-    if user.Email == nil {
-        return errors.New("email is required")
-    }
-    if *user.Email == "" {
-        return errors.New("email cannot be empty")
-    }
-    return nil
-}
-```
-
-## Стратегия миграции
-
-1. **Добавьте новое поле** с нужной кардинальностью:
-   ```proto
-   string old_email = 2 [deprecated = true];
-   optional string new_email = 5;
-   ```
-
-2. **Период двойной записи** — заполняйте оба поля:
-   ```go
-   user := &User{
-       Name:     "John",
-       OldEmail: email,
-       NewEmail: &email,
-   }
-   ```
-
-3. **Клиенты постепенно переходят**:
-   ```go
-   email := user.NewEmail
-   if email == nil && user.OldEmail != "" {
-       v := user.OldEmail
-       email = &v
-   }
-   ```
-
-4. **Удаление старого поля** в следующей major‑версии:
-   ```proto
-   reserved 2, "old_email";
-   optional string new_email = 5;
-   ```
-
-## Типовые сценарии
-
-### Миграция Proto2 → Proto3
-```proto
-syntax = "proto3";
-message Order {
-  string id = 1; // BREAKING если был required
-}
-
-// Сохранить семантику:
-syntax = "proto3";
-message Order {
-  string id = 1;
-  optional string notes = 2;
-}
-```
-
-### Делать optional поле required
-```proto
-message CreateUserRequest {
-  string name = 1;
-  string email = 2; // BREAKING (раньше optional)
-}
-
-message CreateUserRequest {
-  string name = 1;
-  optional string email = 2 [deprecated = true];
-  string required_email = 3;
-}
-```
-
-### Делать required поле optional
-```proto
-message User {
-  optional string phone = 3; // BREAKING (было implicit required)
-}
-
-message User {
-  string phone = 3 [deprecated = true];
-  optional string phone_optional = 4;
-}
-```
-
-## Типы кардинальности в Protobuf
-
-### Proto3
-- **Implicit optional**: `string name = 1;`
-- **Explicit optional**: `optional string email = 2;`
-- **Repeated**: `repeated string tags = 3;`
-- **Map**: `map<string, string> metadata = 4;`
-
-### Proto2
-- **Required**: `required string id = 1;`
-- **Optional**: `optional string email = 2;`
-- **Repeated**: `repeated string tags = 3;`
-
-### Матрица Breaking изменений
-
-| From | To | Result |
-|------|----|--------|
-| Required | Optional | ❌ BREAKING |
-| Optional | Required | ❌ BREAKING |
-| Implicit | Explicit | ❌ BREAKING |
-| Explicit | Implicit | ❌ BREAKING |
-| Single | Repeated | ❌ BREAKING |
-| Repeated | Single | ❌ BREAKING |
-| Field | Map | ❌ BREAKING |
-| Map | Field | ❌ BREAKING |
\ No newline at end of file
diff --git a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/field-same-type.md b/docs/dist/docs/ru-guide/cli/breaking-changes/rules/field-same-type.md
deleted file mode 100644
index 05b7ee85..00000000
--- a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/field-same-type.md
+++ /dev/null
@@ -1,153 +0,0 @@
-<!-- TODO: Review translation -->
-
-# FIELD_SAME_TYPE
-
-Категории:
-
-- **WIRE+**
-
-Правило проверяет, что типы полей сообщений (message fields) не изменяются. Смена типа поля ломает совместимость по wire‑формату и сгенерированный код: бинарное представление и ожидания клиентского кода различаются для разных типов.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message Product {
-  string name = 1;
-  int32 price = 2;
-  bool available = 3;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message Product {
-  string name = 1;
-  string price = 2; // [!code --] Changed from int32 to string (изменён тип)
-  bool available = 3;
-}
-```
-
-**Ошибка:**
-```
-product.proto:5:3: Field "2" with name "price" on message "Product" changed type from "int32" to "string". (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Несовместимые изменения типов:**
-```proto
-// Before
-message Order {
-  string id = 1;
-  int64 timestamp = 2;
-  repeated string tags = 3;
-  OrderStatus status = 4;
-}
-
-// After - ВСЁ BREAKING
-message Order {
-  int32 id = 1;           // string -> int32: BREAKING
-  string timestamp = 2;   // int64 -> string: BREAKING
-  string tags = 3;        // repeated -> singular: BREAKING
-  int32 status = 4;       // enum -> int32: BREAKING
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо смены типа — добавьте новое поле:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message Product {
-  string name = 1;
-  int32 price = 2 [deprecated = true]; // [!code focus] // Старое поле помечено deprecated
-  bool available = 3;
-  string price_formatted = 4; // [!code focus] // Новое поле со строковым представлением
-}
-```
-
-**Или создайте новую версию сообщения:**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus] // Новая версия package
-
-message Product {
-  string name = 1;
-  string price = 2; // [!code focus] // В v2 уже string
-  bool available = 3;
-}
-```
-
-## Влияние
-
-- **Wire Format:** Старые бинарные данные не десериализуются корректно
-- **Generated Code:** Меняются типы в сгенерированном коде — клиенты не компилируются
-- **Runtime Errors:** Ошибки парсинга при несовпадении ожидаемого типа
-- **Data Corruption:** Неверная интерпретация байтов данных
-
-## Типовые проблемы изменений типов
-
-### Числовые типы
-```proto
-// BREAKING: различное кодирование/семантика
-int32 -> int64    // Иное кодирование
-int32 -> uint32   // Меняется знак
-int32 -> string   // Совсем другой формат
-```
-
-### Коллекции
-```proto
-// BREAKING: изменяется структура
-string -> repeated string              // Одиночное -> коллекция
-repeated int32 -> map<string, int32>   // Массив -> map
-```
-
-### Message типы
-```proto
-// BREAKING: другая структура сообщения
-UserInfo -> UserProfile  // Совершенно разные сообщения
-string -> UserInfo       // Скаляр -> сообщение
-```
-
-## Стратегия миграции
-
-1. **Добавьте новое поле** с нужным типом:
-   ```proto
-   int32 old_price = 2 [deprecated = true];
-   string new_price = 5; // Новое поле
-   ```
-
-2. **Период двойной записи** — заполняйте оба поля для совместимости
-
-3. **Мигрируйте клиентов** на новое поле постепенно
-
-4. **Удалите старое поле** в следующей major‑версии:
-   ```proto
-   reserved 2, "old_price";
-   string new_price = 5;
-   ```
-
-## Безопасные изменения (Теоретически wire‑совместимые)
-
-Примечание: EasyP сейчас считает ЛЮБУЮ смену типа breaking. Однако технически некоторые случаи совместимы:
-
-- `int32` ↔ `uint32` (одно кодирование)
-- `int64` ↔ `uint64` (одно кодирование)
-- `string` → `bytes` (если все строки валидный UTF‑8)
-
-Эти исключения могут получить отдельную обработку в будущих версиях EasyP с более гибкими уровнями строгости.
\ No newline at end of file
diff --git a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/import-no-delete.md b/docs/dist/docs/ru-guide/cli/breaking-changes/rules/import-no-delete.md
deleted file mode 100644
index 297309eb..00000000
--- a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/import-no-delete.md
+++ /dev/null
@@ -1,357 +0,0 @@
-<!-- TODO: Review translation -->
-
-# IMPORT_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что ни одна инструкция `import` не была удалена из proto‑файла. Удаление import ломает совместимость по wire‑формату и сгенерированный код: типы из импортируемых файлов могли использоваться в текущем файле, и их удаление делает эти типы недоступными.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-import "google/protobuf/timestamp.proto";
-import "google/protobuf/duration.proto";
-import "common/user.proto";
-import "common/address.proto";
-
-message Order {
-  string id = 1;
-  google.protobuf.Timestamp created_at = 2;
-  google.protobuf.Duration processing_time = 3;
-  common.User customer = 4;
-  common.Address shipping_address = 5;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-import "google/protobuf/timestamp.proto";
-// import "google/protobuf/duration.proto";  // [!code --] Удалён import — BREAKING
-// import "common/user.proto";               // [!code --] Удалён import — BREAKING
-// import "common/address.proto";            // [!code --] Удалён import — BREAKING
-
-message Order {
-  string id = 1;
-  google.protobuf.Timestamp created_at = 2;
-  google.protobuf.Duration processing_time = 3;  // ERROR: Duration недоступен
-  common.User customer = 4;                      // ERROR: User недоступен
-  common.Address shipping_address = 5;           // ERROR: Address недоступен
-}
-```
-
-**Ошибка:**
-```
-order.proto:5:1: Previously import "google/protobuf/duration.proto" was deleted. (BREAKING_CHECK)
-order.proto:6:1: Previously import "common/user.proto" was deleted. (BREAKING_CHECK)
-order.proto:7:1: Previously import "common/address.proto" was deleted. (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Сервис ломается при удалённых import:**
-```proto
-// Before
-import "google/api/annotations.proto";
-import "google/protobuf/empty.proto";
-import "common/auth.proto";
-
-service OrderService {
-  rpc GetOrder(GetOrderRequest) returns (Order) {
-    option (google.api.http) = {
-      get: "/v1/orders/{id}"
-    };
-  }
-  
-  rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty);
-}
-
-// After - BREAKING CHANGES!
-// import "google/api/annotations.proto";    // BREAKING: deleted
-// import "google/protobuf/empty.proto";     // BREAKING: deleted
-// import "common/auth.proto";               // BREAKING: deleted
-
-service OrderService {
-  rpc GetOrder(GetOrderRequest) returns (Order) {
-    option (google.api.http) = {  // ERROR: annotations недоступен
-      get: "/v1/orders/{id}"
-    };
-  }
-  
-  rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty);  // ERROR: типы недоступны
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления оставьте неиспользуемые import:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-import "google/protobuf/timestamp.proto";
-import "google/protobuf/duration.proto";  // [!code focus] // Оставляем даже если не используется
-import "common/user.proto";               // [!code focus]
-import "common/address.proto";            // [!code focus]
-
-message Order {
-  string id = 1;
-  google.protobuf.Timestamp created_at = 2;
-  // Поля, использовавшие Duration/User/Address, удалены — import оставлены
-}
-```
-
-**Или добавьте новые типы, сохранив старые import:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-import "google/protobuf/timestamp.proto";
-import "google/protobuf/duration.proto";  // [!code focus]
-import "common/user.proto";               // [!code focus]
-import "common/address.proto";            // [!code focus]
-import "common/v2/user.proto";            // [!code focus] // Новый import
-
-message Order {
-  string id = 1;
-  google.protobuf.Timestamp created_at = 2;
-  google.protobuf.Duration processing_time = 3 [deprecated = true]; // [!code focus]
-  common.User customer = 4 [deprecated = true];                     // [!code focus]
-  common.Address shipping_address = 5 [deprecated = true];          // [!code focus]
-  
-  int32 processing_seconds = 6;
-  common.v2.UserProfile customer_v2 = 7;
-  string shipping_address_text = 8;
-}
-```
-
-## Влияние
-
-- **Generated Code:** Типы пропадают → ошибка компиляции
-- **Wire Format:** Сообщения с удалёнными типами не десериализуются
-- **Field References:** Поля с этими типами становятся невалидны
-- **Service Definitions:** RPC с типами из удалённых файлов ломаются
-- **Options Usage:** Пользовательские опции из импортов недоступны
-
-## Реальный пример
-
-**Код клиента ломается:**
-```go
-order := &myapi.Order{
-    Id:        "order123",
-    CreatedAt: timestamppb.New(time.Now()),
-    Customer: &common.User{          // ERROR после удаления import
-        Id:   "user456",
-        Name: "John Doe",
-    },
-    ShippingAddress: &common.Address{ // ERROR после удаления import
-        Street: "123 Main St",
-        City:   "New York",
-    },
-}
-// undefined: common.User
-// undefined: common.Address
-```
-
-**Серверная логика ломается:**
-```go
-func (s *server) CreateOrder(ctx context.Context, req *CreateOrderRequest) (*Order, error) {
-    return &Order{
-        Id:        generateOrderId(),
-        CreatedAt: timestamppb.New(time.Now()),
-        Customer: &common.User{          // ERROR
-            Id:   req.CustomerId,
-            Name: req.CustomerName,
-        },
-        ShippingAddress: &common.Address{ // ERROR
-            Street: req.ShippingStreet,
-            City:   req.ShippingCity,
-        },
-    }, nil
-}
-```
-
-**Компиляция proto ломается:**
-```bash
-$ protoc --go_out=. order.proto
-order.proto:8:3: "common.User" is not defined.
-order.proto:9:3: "common.Address" is not defined.
-order.proto:10:3: "google.protobuf.Duration" is not defined.
-```
-
-## Стратегия миграции
-
-1. Сохраняйте import даже если типы более не используются:
-   ```proto
-   import "common/user.proto"; // Оставить
-   ```
-2. Добавляйте новые import рядом со старыми:
-   ```proto
-   import "common/user.proto";
-   import "common/v2/user.proto";
-   ```
-3. Депрецируйте поля со старыми типами постепенно:
-   ```proto
-   message Order {
-     common.User customer = 4 [deprecated = true];
-     common.v2.UserProfile customer_v2 = 5;
-   }
-   ```
-4. Сервер: поддерживайте оба варианта:
-   ```go
-   if req.CustomerProfileV2 != nil { order.CustomerV2 = req.CustomerProfileV2; return order }
-   if req.CustomerProfile != nil { order.Customer = req.CustomerProfile }
-   ```
-5. Удаляйте import только в следующей major‑версии после полной миграции.
-
-## Типовые сценарии
-
-### Замена зависимости
-```proto
-import "old/user.proto";    // Старый
-import "new/user.proto";    // Новый
-
-message Order {
-  old.User customer = 4 [deprecated = true];
-  new.UserProfile customer_v2 = 5;
-}
-```
-
-### Удаление функционала
-```proto
-import "feature/analytics.proto"; // Оставить даже если поле удалено
-
-message Order {
-  string id = 1;
-  // feature.AnalyticsData analytics = 2; // Поле удалено, import остаётся
-}
-```
-
-### Миграция версии protobuf
-```proto
-import "google/protobuf/timestamp.proto";
-import "google/protobuf/duration.proto";
-
-message Event {
-  google.protobuf.Timestamp timestamp = 1;
-  int64 timestamp_millis = 2;
-}
-```
-
-### Упрощение сложных зависимостей
-```proto
-import "complex/config.proto";
-
-message Settings {
-  complex.ConfigData config = 1 [deprecated = true];
-  string config_json = 2;
-}
-```
-
-## Категории import и влияние
-
-### Стандартные Google imports
-```proto
-import "google/protobuf/timestamp.proto";
-import "google/protobuf/duration.proto";
-import "google/protobuf/empty.proto";
-import "google/api/annotations.proto";
-```
-
-### Общие библиотечные imports
-```proto
-import "common/user.proto";
-import "common/address.proto";
-import "common/money.proto";
-```
-
-### Фичевые imports
-```proto
-import "features/analytics.proto";
-import "features/logging.proto";
-import "internal/debug.proto";
-```
-
-## Особенности wire‑формата
-
-### Удаление import vs использование поля
-```proto
-import "common/enums.proto";
-message Order {
-  oneof payment {
-    CreditCardPayment card = 1;
-  }
-}
-```
-
-### Транзитивные зависимости
-```proto
-import "user.proto";
-message Order {
-  PaymentInfo payment = 1;
-}
-```
-
-### JSON сериализация
-```proto
-import "google/protobuf/field_mask.proto";
-message UpdateRequest {
-  google.protobuf.FieldMask update_mask = 1;
-}
-```
-
-## Профилактика
-
-### Аудит import
-```bash
-grep -r "google.protobuf.Duration" *.proto
-grep -r "common.User" *.proto
-```
-(Даже если не найдено — не удаляем.)
-
-### Настройка линтера
-```yaml
-lint:
-  ignore:
-    - IMPORT_UNUSED
-```
-
-### Документация
-```proto
-import "legacy/types.proto";  // Для обратной совместимости
-import "common/user.proto";   // Требуется для уже сохранённых данных
-```
-
-## Import vs удаление поля
-
-### Разные типы breaking
-```proto
-// import "user.proto"; // BREAKING: удалён import
-message Order {
-  string id = 1;
-  // User customer = 2; // BREAKING: удалено поле
-}
-```
-
-### Составные нарушения
-```proto
-// import "user.proto"; // BREAKING
-message Order {
-  string id = 1;
-  // User customer = 2; // BREAKING
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/message-no-delete.md b/docs/dist/docs/ru-guide/cli/breaking-changes/rules/message-no-delete.md
deleted file mode 100644
index 05b17321..00000000
--- a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/message-no-delete.md
+++ /dev/null
@@ -1,240 +0,0 @@
-<!-- TODO: Review translation -->
-
-# MESSAGE_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что ни одно сообщение (message) не было удалено из proto‑файлов. Удаление message ломает совместимость по wire‑формату и сгенерированный код: в существующих данных могут присутствовать экземпляры удалённого типа, а клиентский код зависит от сгенерированных структур и классов.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  Address address = 3;
-}
-
-message Address { // [!code --]
-  string street = 1; // [!code --]
-  string city = 2; // [!code --]
-  string country = 3; // [!code --]
-} // [!code --]
-
-message Order {
-  string id = 1;
-  User user = 2;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  Address address = 3;  // ERROR: Address больше не существует
-}
-
-// Address удалён — BREAKING CHANGE!
-
-message Order {
-  string id = 1;
-  User user = 2;
-}
-```
-
-**Ошибка:**
-```
-user.proto:8:1: Previously present message "Address" was deleted from file. (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Удаление вложенного сообщения:**
-
-```proto
-// Before
-message User {
-  string name = 1;
-  Profile profile = 2;
-  
-  message Profile { // [!code --]
-    string bio = 1; // [!code --]
-    string avatar_url = 2; // [!code --]
-  } // [!code --]
-}
-
-// After - BREAKING CHANGE!
-message User {
-  string name = 1;
-  Profile profile = 2;  // ERROR: Profile удалён
-  
-  // Вложенное сообщение Profile удалено
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления — пометить как deprecated:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  Address address = 3 [deprecated = true]; // [!code focus]
-}
-
-message Address {
-  option deprecated = true; // [!code focus]
-  string street = 1;
-  string city = 2;
-  string country = 3;
-}
-
-message Order {
-  string id = 1;
-  User user = 2;
-}
-```
-
-**Или заменить новой версией сообщения:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  Address address = 3 [deprecated = true]; // [!code focus] // Старое поле
-  AddressV2 address_v2 = 4; // [!code focus] // Новая улучшенная структура
-}
-
-message Address {
-  option deprecated = true; // [!code focus]
-  string street = 1;
-  string city = 2;
-  string country = 3;
-}
-
-message AddressV2 { // [!code focus]
-  string street_address = 1; // [!code focus]
-  string city = 2; // [!code focus]
-  string state = 3; // [!code focus]
-  string postal_code = 4; // [!code focus]
-  string country = 5; // [!code focus]
-} // [!code focus]
-
-message Order {
-  string id = 1;
-  User user = 2;
-}
-```
-
-## Влияние
-
-- **Wire Format:** Старые данные с удалённым сообщением не десериализуются
-- **Generated Code:** Классы/структуры удаляются — компиляция клиента ломается
-- **Field References:** Поля, использующие удалённый тип, становятся невалидны
-- **Nested Dependencies:** Все сообщения, ссылающиеся на удалённый тип, ломаются
-
-## Реальный пример
-
-**Код клиента ломается:**
-```go
-// Before
-user := &myapi.User{
-    Name:  "John Doe",
-    Email: "john@example.com",
-    Address: &myapi.Address{  // ERROR после удаления
-        Street:  "123 Main St",
-        City:    "New York",
-        Country: "USA",
-    },
-}
-
-// undefined: myapi.Address
-```
-
-**Старые данные становятся нечитаемыми:**
-```json
-{
-  "name": "John Doe",
-  "email": "john@example.com",
-  "address": {
-    "street": "123 Main St",
-    "city": "New York",
-    "country": "USA"
-  }
-}
-// После удаления Address: парсер не знает поле address
-```
-
-## Стратегия миграции
-
-1. **Пометить как deprecated:**
-   ```proto
-   message OldMessage {
-     option deprecated = true;
-     // ... fields
-   }
-   ```
-2. **Пометить поля, использующие его:**
-   ```proto
-   OldMessage old_data = 5 [deprecated = true];
-   ```
-3. **Добавить замену при необходимости:**
-   ```proto
-   NewMessage new_data = 6;
-   ```
-4. **Удалить в следующей major‑версии после периода миграции**
-
-## Типовые сценарии
-
-### Рефакторинг структуры
-```proto
-message UserInfo {
-  option deprecated = true;
-  string name = 1;
-  string email = 2;
-}
-
-message UserProfile {
-  string full_name = 1;
-  string email_address = 2;
-  string phone = 3;
-}
-```
-
-### Удаление «неиспользуемых» сообщений
-```proto
-message OldConfig {
-  option deprecated = true;
-  // Не удалять сразу — могут быть сохранённые данные
-}
-```
-
-### Миграция версии
-```proto
-package myapi.v2;
-
-message User {
-  // Новая структура без устаревших ссылок
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/oneof-field-no-delete.md b/docs/dist/docs/ru-guide/cli/breaking-changes/rules/oneof-field-no-delete.md
deleted file mode 100644
index c3966516..00000000
--- a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/oneof-field-no-delete.md
+++ /dev/null
@@ -1,373 +0,0 @@
-<!-- TODO: Review translation -->
-
-# ONEOF_FIELD_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Правило проверяет, что ни одно поле внутри `oneof` группы не было удалено. Удаление поля из `oneof` ломает совместимость по wire‑формату и сгенерированный код: в сохранённых данных может присутствовать выбранный вариант, а клиентский код опирается на сгенерированные типы‑обёртки и методы доступа.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    string oauth_token = 4;
-    string certificate = 5;
-  }
-}
-
-message SearchQuery {
-  oneof filter {
-    string text = 1;
-    int32 user_id = 2;
-    string category = 3;
-    DateRange date_range = 4;
-  }
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    // string oauth_token = 4;  // [!code --] Удалено поле oneof — BREAKING!
-    // string certificate = 5;  // [!code --] Удалено поле oneof — BREAKING!
-  }
-}
-
-message SearchQuery {
-  oneof filter {
-    string text = 1;
-    int32 user_id = 2;
-    // string category = 3;     // [!code --] Удалено поле oneof — BREAKING!
-    // DateRange date_range = 4; // [!code --] Удалено поле oneof — BREAKING!
-  }
-}
-```
-
-**Ошибка:**
-```
-login.proto:7:5: Previously present field "4" with name "oauth_token" on OneOf "credentials" was deleted. (BREAKING_CHECK)
-login.proto:8:5: Previously present field "5" with name "certificate" on OneOf "credentials" was deleted. (BREAKING_CHECK)
-search.proto:6:5: Previously present field "3" with name "category" on OneOf "filter" was deleted. (BREAKING_CHECK)
-search.proto:7:5: Previously present field "4" with name "date_range" on OneOf "filter" was deleted. (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Удаление вложенных oneof полей:**
-```proto
-// Before
-message PaymentRequest {
-  string order_id = 1;
-  
-  oneof payment_method {
-    CreditCardPayment credit_card = 2;
-    BankTransferPayment bank_transfer = 3;
-    CryptoPayment crypto = 4;         // [!code --] 
-    GiftCardPayment gift_card = 5;    // [!code --]
-  }
-}
-
-// After - BREAKING CHANGES!
-message PaymentRequest {
-  string order_id = 1;
-  
-  oneof payment_method {
-    CreditCardPayment credit_card = 2;
-    BankTransferPayment bank_transfer = 3;
-    // CryptoPayment crypto = 4;      // BREAKING: deleted
-    // GiftCardPayment gift_card = 5; // BREAKING: deleted
-  }
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления — пометить поля deprecated:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    string oauth_token = 4 [deprecated = true]; // [!code focus]
-    string certificate = 5 [deprecated = true]; // [!code focus]
-  }
-}
-
-message SearchQuery {
-  oneof filter {
-    string text = 1;
-    int32 user_id = 2;
-    string category = 3 [deprecated = true]; // [!code focus]
-    DateRange date_range = 4 [deprecated = true]; // [!code focus]
-  }
-}
-```
-
-**Или добавить новые поля, оставив старые:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    string oauth_token = 4 [deprecated = true]; // [!code focus] // Старое поле
-    string certificate = 5 [deprecated = true]; // [!code focus]
-    
-    OAuthCredentials oauth_v2 = 6; // [!code focus] // Новый структурированный вариант
-    CertificateCredentials cert_v2 = 7; // [!code focus]
-  }
-}
-```
-
-## Влияние
-
-- **Wire Format:** Данные, содержащие удалённый вариант, не десериализуются корректно
-- **Generated Code:** Удаляются типы‑обёртки и accessor методы — компиляция клиентов ломается
-- **Type Safety:** Логика `switch` по типам oneof разваливается
-- **Business Logic:** Код, ожидающий конкретный вариант, перестаёт работать
-
-## Реальный пример
-
-**Код клиента ломается:**
-```go
-// Before
-loginReq := &myapi.LoginRequest{
-    Username: "user123",
-}
-
-loginReq.Credentials = &myapi.LoginRequest_OauthToken{
-    OauthToken: "token123", // ERROR после удаления поля
-}
-
-switch cred := loginReq.Credentials.(type) {
-case *myapi.LoginRequest_Password:
-    return authenticatePassword(cred.Password)
-case *myapi.LoginRequest_OauthToken:  // ERROR: тип удалён
-    return authenticateOAuth(cred.OauthToken)
-case *myapi.LoginRequest_Certificate: // ERROR: тип удалён
-    return authenticateCert(cred.Certificate)
-default:
-    return errors.New("unsupported credential type")
-}
-// undefined: myapi.LoginRequest_OauthToken
-// undefined: myapi.LoginRequest_Certificate
-```
-
-**Серверная логика ломается:**
-```go
-func authenticateUser(req *LoginRequest) error {
-    switch cred := req.Credentials.(type) {
-    case *LoginRequest_Password:
-        return validatePassword(cred.Password)
-    case *LoginRequest_ApiKey:
-        return validateApiKey(cred.ApiKey)
-    case *LoginRequest_OauthToken:    // ERROR после удаления
-        return validateOAuth(cred.OauthToken)
-    case *LoginRequest_Certificate:   // ERROR после удаления
-        return validateCertificate(cred.Certificate)
-    default:
-        return errors.New("no valid credentials provided")
-    }
-}
-```
-
-**Старые данные становятся нечитаемыми:**
-```json
-{
-  "username": "user123",
-  "oauth_token": "abc123xyz"
-}
-// После удаления: токен теряется или вызывает ошибку парсинга
-```
-
-## Стратегия миграции
-
-1. **Депрецируйте сначала:**
-   ```proto
-   oneof credentials {
-     string password = 2;
-     string oauth_token = 4 [deprecated = true];
-   }
-   ```
-2. **Добавьте новые структурированные поля:**
-   ```proto
-   oneof credentials {
-     string password = 2;
-     string oauth_token = 4 [deprecated = true];
-     OAuthCredentials oauth_v2 = 6;
-   }
-   ```
-3. **Сервер: поддерживайте оба варианта:**
-   ```go
-   switch cred := req.Credentials.(type) {
-   case *LoginRequest_OauthV2:
-       return validateOAuthV2(cred.OauthV2)
-   case *LoginRequest_OauthToken:
-       log.Warn("Deprecated oauth_token used")
-       return validateOAuthLegacy(cred.OauthToken)
-   }
-   ```
-4. **Мигрируйте клиентов на новое поле:**
-   ```go
-   loginReq.Credentials = &LoginRequest_OauthV2{
-       OauthV2: &OAuthCredentials{
-           Token: "token123",
-           RefreshToken: "refresh456",
-           ExpiresAt: timestamp,
-       },
-   }
-   ```
-5. **Зарезервируйте номера удалённых полей в следующей major‑версии:**
-   ```proto
-   oneof credentials {
-     reserved 4, 5;
-     reserved "oauth_token", "certificate";
-     string password = 2;
-     string api_key = 3;
-     OAuthCredentials oauth_v2 = 6;
-   }
-   ```
-
-## Типовые сценарии
-
-### Удаление неподдерживаемых методов аутентификации
-```proto
-message AuthRequest {
-  oneof method {
-    PasswordAuth password = 1;
-    ApiKeyAuth api_key = 2;
-    // LdapAuth ldap = 3;  // НЕЛЬЗЯ просто удалить
-    LdapAuth ldap = 3 [deprecated = true];
-    OidcAuth oidc = 4;
-  }
-}
-```
-
-### Упрощение вариантов oneof
-```proto
-message SearchRequest {
-  oneof query_type {
-    string simple_text = 1;
-    // ComplexQuery complex = 2; // Не удалять напрямую
-    ComplexQuery complex = 2 [deprecated = true];
-    AdvancedQuery advanced = 3;
-  }
-}
-```
-
-### Изменения бизнес‑логики платежей
-```proto
-message PaymentRequest {
-  oneof payment_method {
-    CreditCard credit_card = 1;
-    BankTransfer bank_transfer = 3;
-    // Check check = 2; // Не удалять
-    Check check = 2 [deprecated = true];
-    DigitalWallet digital_wallet = 4;
-  }
-}
-```
-
-## OneOf Field Deletion vs обычное удаление
-
-### Отличия от удаления обычного поля
-```proto
-message User {
-  string name = 1;
-  // string email = 2; // BREAKING: обычное поле
-}
-
-message User {
-  oneof contact {
-    string email = 1;
-    // string phone = 2; // BREAKING: поле в oneof
-  }
-}
-```
-
-### Влияние на сгенерированный код
-```go
-// Обычное поле: удаляется простой геттер
-// user.GetEmail()
-
-// Поле в oneof: пропадает тип-обёртка, кейсы switch ломаются
-// *LoginRequest_OauthToken
-```
-
-### Wire‑особенности
-```proto
-message Request {
-  oneof data {
-    string text = 1;
-    bytes binary = 2;  // Если удалить — клиенты, использующие binary, ломаются
-    JsonData json = 3;
-  }
-}
-```
-
-## Валидация и обработка ошибок
-
-### До удаления (типобезопасно)
-```go
-switch data := req.Data.(type) {
-case *Request_Text:
-    return validateText(data.Text)
-case *Request_Binary:
-    return validateBinary(data.Binary)
-case *Request_Json:
-    return validateJson(data.Json)
-case nil:
-    return errors.New("no data provided")
-default:
-    return errors.New("unknown data type")
-}
-```
-
-### После удаления (сломано)
-```go
-switch data := req.Data.(type) {
-case *Request_Text:
-    return validateText(data.Text)
-// case *Request_Binary: // Тип исчез — кейс не компилируется
-case *Request_Json:
-    return validateJson(data.Json)
-case nil:
-    return errors.New("no data provided")
-default:
-    return errors.New("unknown data type") // Старые бинарные данные попадают сюда
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/oneof-field-same-type.md b/docs/dist/docs/ru-guide/cli/breaking-changes/rules/oneof-field-same-type.md
deleted file mode 100644
index e0bf4577..00000000
--- a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/oneof-field-same-type.md
+++ /dev/null
@@ -1,347 +0,0 @@
-<!-- TODO: Review translation -->
-
-# ONEOF_FIELD_SAME_TYPE
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что тип поля внутри `oneof` НЕ меняется. Смена типа любого варианта `oneof` — несовместимое (breaking) изменение: существующие данные сериализованы с прежним типом, а клиентский код ожидает конкретные типы-обёртки и методы доступа, сгенерированные для каждого варианта.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message SearchRequest {
-  string query = 1;
-  
-  oneof filter {
-    string category = 2;
-    int32 user_id = 3;
-    bool is_premium = 4;
-    DateRange date_range = 5;
-  }
-}
-
-message NotificationSettings {
-  oneof delivery {
-    string email = 1;
-    int64 phone_number = 2;
-    WebhookConfig webhook = 3;
-  }
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message SearchRequest {
-  string query = 1;
-  
-  oneof filter {
-    int32 category = 2;        // [!code --] Было string -> стало int32 (BREAKING)
-    string user_id = 3;        // [!code --] Было int32 -> стало string (BREAKING)
-    string is_premium = 4;     // [!code --] Было bool -> стало string (BREAKING)
-    string date_range = 5;     // [!code --] Было DateRange -> стало string (BREAKING)
-  }
-}
-
-message NotificationSettings {
-  oneof delivery {
-    EmailConfig email = 1;     // [!code --] Было string -> стало EmailConfig (BREAKING)
-    string phone_number = 2;   // [!code --] Было int64 -> стало string (BREAKING)
-    string webhook = 3;        // [!code --] Было WebhookConfig -> стало string (BREAKING)
-  }
-}
-```
-
-**Ошибка:**
-```
-search.proto:6:5: Field "2" with name "category" on OneOf "filter" changed type from "string" to "int32". (BREAKING_CHECK)
-search.proto:7:5: Field "3" with name "user_id" on OneOf "filter" changed type from "int32" to "string". (BREAKING_CHECK)
-search.proto:8:5: Field "4" with name "is_premium" on OneOf "filter" changed type from "bool" to "string". (BREAKING_CHECK)
-search.proto:9:5: Field "5" with name "date_range" on OneOf "filter" changed type from "DateRange" to "string". (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Комплексные изменения типов:**
-```proto
-// Before
-message PaymentRequest {
-  oneof payment_info {
-    CreditCardInfo credit_card = 1;
-    BankAccountInfo bank_account = 2;
-    string paypal_email = 3;
-    CryptoWalletInfo crypto = 4;
-  }
-}
-
-// After - ВСЁ BREAKING
-message PaymentRequest {
-  oneof payment_info {
-    string credit_card = 1;           // CreditCardInfo -> string
-    PayPalInfo bank_account = 2;      // BankAccountInfo -> PayPalInfo
-    PayPalInfo paypal_email = 3;      // string -> PayPalInfo
-    string crypto = 4;                // CryptoWalletInfo -> string
-  }
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо смены типа — добавьте новое поле в тот же oneof:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message SearchRequest {
-  string query = 1;
-  
-  oneof filter {
-    string category = 2 [deprecated = true];         // Старый тип
-    int32 user_id = 3 [deprecated = true];
-    bool is_premium = 4 [deprecated = true];
-    DateRange date_range = 5 [deprecated = true];
-    
-    int32 category_id = 6;        // Новая версия
-    string user_identifier = 7;
-    string premium_status = 8;
-    string date_filter = 9;
-  }
-}
-```
-
-**Или создайте новый oneof:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message SearchRequest {
-  string query = 1;
-  
-  oneof filter {
-    option deprecated = true;
-    string category = 2 [deprecated = true];
-    int32 user_id = 3 [deprecated = true];
-    bool is_premium = 4 [deprecated = true];
-    DateRange date_range = 5 [deprecated = true];
-  }
-  
-  oneof filter_v2 {
-    int32 category_id = 6;
-    string user_identifier = 7;
-    PremiumFilter premium_filter = 8;
-    TimeFilter time_filter = 9;
-  }
-}
-```
-
-## Влияние
-
-- **Wire Format:** Старые бинарные данные не читаются корректно
-- **Generated Code:** Меняются типы-обёртки, код клиента не компилируется
-- **Type Safety:** `switch` по варианту oneof ломается
-- **Runtime Errors:** Ошибки десериализации и логики при несовпадении типов
-
-## Реальный пример
-
-**Ломается клиентский код:**
-```go
-// Before
-searchReq := &myapi.SearchRequest{
-    Query: "golang jobs",
-}
-
-// Устанавливаем вариант oneof
-searchReq.Filter = &myapi.SearchRequest_Category{
-    Category: "engineering",
-}
-
-// Обработка вариантов
-switch filter := searchReq.Filter.(type) {
-case *myapi.SearchRequest_Category:
-    return searchByCategory(filter.Category)
-case *myapi.SearchRequest_UserId:
-    return searchByUserId(filter.UserId)
-default:
-    return errors.New("unsupported filter")
-}
-
-// After — тип Category стал int32
-searchReq.Filter = &myapi.SearchRequest_Category{
-    Category: "engineering", // ERROR
-}
-
-switch filter := searchReq.Filter.(type) {
-case *myapi.SearchRequest_Category:
-    return searchByCategory(filter.Category) // ERROR
-case *myapi.SearchRequest_UserId:
-    return searchByUserId(filter.UserId)     // ERROR: UserId теперь string
-}
-```
-
-**Ломается серверная логика:**
-```go
-// Before
-func handleSearchFilter(req *SearchRequest) (*SearchResult, error) {
-    switch filter := req.Filter.(type) {
-    case *SearchRequest_Category:
-        return searchDatabase("category", filter.Category), nil
-    case *SearchRequest_UserId:
-        return searchDatabase("user_id", strconv.Itoa(int(filter.UserId))), nil
-    default:
-        return nil, errors.New("no filter specified")
-    }
-}
-
-// After — несовпадения типов
-func handleSearchFilter(req *SearchRequest) (*SearchResult, error) {
-    switch filter := req.Filter.(type) {
-    case *SearchRequest_Category:
-        // filter.Category теперь int32, а код ожидал string
-        return searchDatabase("category", filter.Category), nil // ERROR
-    case *SearchRequest_UserId:
-        userIdStr := filter.UserId // string вместо int32
-        userId, _ := strconv.Atoi(userIdStr)
-        return searchDatabase("user_id", strconv.Itoa(userId)), nil
-    }
-}
-```
-
-**Порча данных:**
-```json
-{
-  "query": "golang jobs",
-  "category": "engineering"
-}
-// После смены типа: "engineering" не может быть интерпретировано как int32
-```
-
-## Стратегия миграции
-
-1. Добавьте новое поле:
-   ```proto
-   oneof filter {
-     string category = 2 [deprecated = true];
-     int32 category_id = 6;
-   }
-   ```
-2. Сервер поддерживает оба:
-   ```go
-   switch filter := req.Filter.(type) {
-   case *SearchRequest_CategoryId:
-       return searchByCategoryId(filter.CategoryId)
-   case *SearchRequest_Category:
-       log.Warn("Deprecated string category used")
-       id := convertCategoryNameToId(filter.Category)
-       return searchByCategoryId(id)
-   }
-   ```
-3. Клиенты переходят на `category_id`.
-4. Скрипты миграции преобразуют старые данные.
-5. В следующей major‑версии:
-   ```proto
-   oneof filter {
-     reserved 2, "category";
-     int32 category_id = 6;
-   }
-   ```
-
-## Типовые сценарии
-
-### Повышение типобезопасности
-```proto
-message ConfigRequest {
-  oneof setting {
-    string database_url = 1 [deprecated = true];
-    DatabaseConfig database_config = 5;
-  }
-}
-```
-
-### Стандартизация числовых типов
-```proto
-message FilterRequest {
-  oneof criteria {
-    int32 timestamp = 1 [deprecated = true];
-    int64 timestamp_millis = 5;
-  }
-}
-```
-
-### Переход к структурированным типам
-```proto
-message PaymentRequest {
-  oneof payment {
-    string card_number = 1 [deprecated = true];
-    CreditCardDetails card_details = 5;
-  }
-}
-```
-
-## Матрица совместимости
-
-| From Type | To Type | Результат |
-|-----------|---------|-----------|
-| `string` | `int32/int64` | ❌ BREAKING |
-| `int32` | `string` | ❌ BREAKING |
-| `bool` | `string` | ❌ BREAKING |
-| `message` | `string` | ❌ BREAKING |
-| `string` | `message` | ❌ BREAKING |
-| `enum` | `int32` | ❌ BREAKING |
-
-### Влияние на сгенерированный код
-```go
-// Before:
-type SearchRequest_Category struct {
-    Category string
-}
-// After:
-type SearchRequest_Category struct {
-    Category int32
-}
-```
-
-### Wire‑формат
-```proto
-message Request {
-  oneof data {
-    string text = 1;
-    // int32 text = 1; // Тот же номер, другой тип — BREAKING
-  }
-}
-```
-
-## Валидация
-
-**До:**
-```go
-switch f := req.Filter.(type) {
-case *SearchRequest_Category:
-    if f.Category == "" { return errors.New("category cannot be empty") }
-case *SearchRequest_UserId:
-    if f.UserId <= 0 { return errors.New("user_id must be positive") }
-}
-```
-
-**После (сломано):**
-```go
-switch f := req.Filter.(type) {
-case *SearchRequest_Category:
-    if f.Category <= 0 { return errors.New("category must be positive") } // Логика ожидала string
-case *SearchRequest_UserId:
-    if f.UserId == "" { return errors.New("user_id cannot be empty") }    // Был int32
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/oneof-no-delete.md b/docs/dist/docs/ru-guide/cli/breaking-changes/rules/oneof-no-delete.md
deleted file mode 100644
index 728c3e83..00000000
--- a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/oneof-no-delete.md
+++ /dev/null
@@ -1,393 +0,0 @@
-<!-- TODO: Review translation -->
-
-# ONEOF_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что ни один `oneof` блок не был удалён из сообщений. Удаление `oneof` ломает совместимость по wire‑формату и сгенерированный код: существующие данные могут содержать ранее выбранный вариант, а клиентский код зависит от типов-обёрток и методов доступа, генерируемых для `oneof`.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    string oauth_token = 4;
-  }
-}
-
-message PaymentMethod { // [!code --]
-  oneof method { // [!code --]
-    CreditCard credit_card = 1; // [!code --]
-    BankAccount bank_account = 2; // [!code --]
-    PayPal paypal = 3; // [!code --]
-  } // [!code --]
-} // [!code --]
-
-message Order {
-  string id = 1;
-  PaymentMethod payment = 2;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  // credentials oneof удалён — BREAKING CHANGE!
-  string password = 2;     // Теперь обычные поля
-  string api_key = 3;      // Потеряна взаимная исключаемость
-  string oauth_token = 4;
-}
-
-message PaymentMethod {
-  // method oneof удалён — BREAKING CHANGE!
-  CreditCard credit_card = 1;  // Теперь можно установить все поля одновременно
-  BankAccount bank_account = 2;
-  PayPal paypal = 3;
-}
-
-message Order {
-  string id = 1;
-  PaymentMethod payment = 2;
-}
-```
-
-**Ошибка:**
-```
-login.proto:5:3: Previously present oneof "credentials" was deleted. (BREAKING_CHECK)
-payment.proto:2:3: Previously present oneof "method" was deleted. (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Удаление вложенного oneof:**
-```proto
-// Before
-message UserProfile {
-  string name = 1;
-  
-  message ContactInfo {
-    oneof contact_method { // [!code --]
-      string email = 1; // [!code --]
-      string phone = 2; // [!code --]
-      string slack_id = 3; // [!code --]
-    } // [!code --]
-  }
-  
-  ContactInfo contact = 2;
-}
-
-// After - BREAKING CHANGE!
-message UserProfile {
-  string name = 1;
-  
-  message ContactInfo {
-    // contact_method oneof удалён
-    string email = 1;    // Больше не эксклюзивно
-    string phone = 2;    // Можно задать всё сразу
-    string slack_id = 3;
-  }
-  
-  ContactInfo contact = 2;
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления — депрецируйте oneof:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    option deprecated = true; // [!code focus]
-    string password = 2 [deprecated = true]; // [!code focus]
-    string api_key = 3 [deprecated = true]; // [!code focus]
-    string oauth_token = 4 [deprecated = true]; // [!code focus]
-  }
-}
-
-message PaymentMethod {
-  oneof method {
-    option deprecated = true; // [!code focus]
-    CreditCard credit_card = 1 [deprecated = true]; // [!code focus]
-    BankAccount bank_account = 2 [deprecated = true]; // [!code focus]
-    PayPal paypal = 3 [deprecated = true]; // [!code focus]
-  }
-}
-```
-
-**Или заменить новой структурой:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    option deprecated = true; // [!code focus] // Старый oneof
-    string password = 2 [deprecated = true]; // [!code focus]
-    string api_key = 3 [deprecated = true]; // [!code focus]
-    string oauth_token = 4 [deprecated = true]; // [!code focus]
-  }
-  
-  oneof auth_method { // [!code focus] // Новый дизайн
-    PasswordAuth password_auth = 5; // [!code focus]
-    ApiKeyAuth api_auth = 6; // [!code focus]
-    OAuthAuth oauth_auth = 7; // [!code focus]
-  } // [!code focus]
-}
-```
-
-## Влияние
-
-- **Wire Format:** Теряются семантика взаимной исключаемости — больше одного поля может быть установлено
-- **Generated Code:** Удаляются типы-обёртки и accessor методы — код клиента не компилируется
-- **Business Logic:** Нарушаются инварианты «только один из»
-- **Validation:** Логика проверок должна быть переписана вручную
-
-## Реальный пример
-
-**Код клиента ломается:**
-```go
-// Before - oneOf даёт взаимную исключаемость
-loginReq := &myapi.LoginRequest{
-    Username: "user123",
-}
-
-loginReq.Credentials = &myapi.LoginRequest_Password{
-    Password: "secret123",
-}
-
-switch cred := loginReq.Credentials.(type) {
-case *myapi.LoginRequest_Password:  // ERROR после удаления
-    return authenticatePassword(cred.Password)
-case *myapi.LoginRequest_ApiKey:    // ERROR после удаления
-    return authenticateApiKey(cred.ApiKey)
-default:
-    return errors.New("no credentials provided")
-}
-
-// Compilation errors:
-// undefined: myapi.LoginRequest_Password
-// undefined field: loginReq.Credentials
-```
-
-**Валидация на сервере ломается:**
-```go
-// Before
-func validateLoginRequest(req *LoginRequest) error {
-    if req.Credentials == nil {
-        return errors.New("credentials required")
-    }
-    switch req.Credentials.(type) {
-    case *LoginRequest_Password:
-        return validatePassword(req.GetPassword())
-    case *LoginRequest_ApiKey:
-        return validateApiKey(req.GetApiKey())
-    case *LoginRequest_OauthToken:
-        return validateOAuthToken(req.GetOauthToken())
-    default:
-        return errors.New("unknown credential type")
-    }
-}
-
-// After
-func validateLoginRequest(req *LoginRequest) error {
-    credCount := 0
-    if req.Password != "" { credCount++ }
-    if req.ApiKey != "" { credCount++ }
-    if req.OauthToken != "" { credCount++ }
-
-    if credCount == 0 {
-        return errors.New("no credentials provided")
-    }
-    if credCount > 1 {
-        return errors.New("multiple credentials provided")
-    }
-
-    if req.Password != "" {
-        return validatePassword(req.Password)
-    }
-    // Дополнительные проверки вручную...
-    return nil
-}
-```
-
-**Проблемы бизнес‑логики:**
-```go
-// Before
-payment := &PaymentMethod{
-    Method: &PaymentMethod_CreditCard{
-        CreditCard: &CreditCard{Number: "1234"},
-    },
-}
-
-// After — можно задать несколько способов сразу
-payment := &PaymentMethod{
-    CreditCard:  &CreditCard{Number: "1234"},
-    BankAccount: &BankAccount{Number: "5678"}, // Ломает бизнес-логику
-}
-```
-
-## Стратегия миграции
-
-1. **Депрецируйте старый oneof и его поля:**
-   ```proto
-   oneof old_credentials {
-     option deprecated = true;
-     string password = 2 [deprecated = true];
-     string api_key = 3 [deprecated = true];
-   }
-   ```
-
-2. **Создайте новый блок при необходимости:**
-   ```proto
-   oneof new_auth_method {
-     PasswordAuth password_auth = 5;
-     ApiKeyAuth api_auth = 6;
-   }
-   ```
-
-3. **Сервер: поддерживайте оба до миграции:**
-   ```go
-   func handleAuth(req *LoginRequest) error {
-       if req.NewAuthMethod != nil {
-           return handleNewAuth(req.NewAuthMethod)
-       }
-       if req.Credentials != nil {
-           return handleOldAuth(req.Credentials)
-       }
-       return errors.New("no auth method provided")
-   }
-   ```
-
-4. **Клиенты: переходите на новый oneof:**
-   ```go
-   loginReq.NewAuthMethod = &LoginRequest_PasswordAuth{
-       PasswordAuth: &PasswordAuth{
-           Username: "user123",
-           Password: "secret123",
-       },
-   }
-   ```
-
-5. **Удалите старый oneof** в следующей major‑версии.
-
-## Типовые сценарии
-
-### Замена oneof обычными полями
-```proto
-message SearchRequest {
-  // НЕЛЬЗЯ просто убрать oneof — ломает семантику
-  string text_query = 1;    // BREAKING
-  int32 user_id = 2;        // BREAKING
-  string category = 3;      // BREAKING
-}
-
-message SearchRequest {
-  oneof query {
-    option deprecated = true;
-    string text_query = 1 [deprecated = true];
-    int32 user_id = 2 [deprecated = true];
-    string category = 3 [deprecated = true];
-  }
-  string search_text = 4;
-  repeated string filters = 5;
-}
-```
-
-### Упрощение структуры сообщения
-```proto
-message NotificationSettings {
-  string email = 1;       // BREAKING: был в oneof
-  string phone = 2;       // BREAKING
-  string webhook_url = 3; // BREAKING
-}
-
-message NotificationSettings {
-  oneof delivery_method {
-    EmailNotification email = 1;
-    SmsNotification phone = 2;
-    WebhookNotification webhook = 3;
-  }
-}
-```
-
-### Миграция с proto2 на proto3
-```proto
-// proto2
-message Request {
-  optional string name = 1;
-  oneof data {
-    string text = 2;
-    int32 number = 3;
-  }
-}
-
-// proto3 — сохраняем oneof
-message Request {
-  string name = 1;
-  oneof data {
-    string text = 2;
-    int32 number = 3;
-  }
-}
-```
-
-## Семантика OneOf
-
-### Что даёт oneof
-- Взаимная исключаемость
-- Типобезопасность в коде
-- Ясность намерения API («выбери один»)
-- Эффективная сериализация — кодируется только выбранный вариант
-
-### Что теряется при удалении
-- Инвариант «только один»
-- Генерируемые wrapper-типы и методы
-- Автоматическая валидация выбора
-- Понятность контракта API
-
-### Влияние на код генерации
-```go
-// С oneof
-type LoginRequest struct {
-    Username string
-    Credentials isLoginRequest_Credentials
-}
-
-// Без oneof
-type LoginRequest struct {
-    Username   string
-    Password   string
-    ApiKey     string
-    OauthToken string
-    // Возможны многозначные конфликтующие состояния
-}
-```
-
diff --git a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/rpc-no-delete.md b/docs/dist/docs/ru-guide/cli/breaking-changes/rules/rpc-no-delete.md
deleted file mode 100644
index cdaae484..00000000
--- a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/rpc-no-delete.md
+++ /dev/null
@@ -1,80 +0,0 @@
-<!-- TODO: Review translation -->
-
-# RPC_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Правило проверяет, что ни один RPC‑метод не был удалён из service. Удаление RPC ломает сгенерированный код и клиентские приложения, которые этот метод вызывают.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-  rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse); // [!code --]
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-  // DeleteUser RPC удалён — BREAKING CHANGE!
-}
-```
-
-**Ошибка:**
-```
-services.proto:7:1: Previously present RPC "DeleteUser" on service "UserService" was deleted. (BREAKING_CHECK)
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления — пометить RPC deprecated:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-  rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-}
-```
-
-## Влияние
-
-- **Generated Code:** Stub/метод исчезает — клиенты не компилируются
-- **Client Applications:** Существующие вызовы метода падают при сборке
-- **Runtime:** gRPC клиенты теряют определение метода
-
-## Стратегия миграции
-
-1. **Сначала деприкация:**
-   ```proto
-   rpc OldMethod(OldRequest) returns (OldResponse) {
-     option deprecated = true;
-   }
-   ```
-
-2. **Имплементация может возвращать ошибку**, указывая что метод устарел (например, INTERNAL / UNIMPLEMENTED)
-
-3. **Удалить в следующей major‑версии** после миграции всех клиентов
\ No newline at end of file
diff --git a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/rpc-same-request-type.md b/docs/dist/docs/ru-guide/cli/breaking-changes/rules/rpc-same-request-type.md
deleted file mode 100644
index 7fd98fbd..00000000
--- a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/rpc-same-request-type.md
+++ /dev/null
@@ -1,253 +0,0 @@
-<!-- TODO: Review translation -->
-
-# RPC_SAME_REQUEST_TYPE
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что RPC‑методы сохраняют прежний тип сообщения запроса (request message type). Изменение типа запроса RPC ломает совместимость по wire‑формату и сгенерированный код: клиенты ожидают конкретную структуру при вызове метода.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse);
-}
-
-message GetUserRequest {
-  string user_id = 1;
-}
-
-message UpdateUserRequest {
-  string user_id = 1;
-  string name = 2;
-  string email = 3;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // [!code --] Изменён тип запроса
-  rpc UpdateUser(UserUpdateRequest) returns (UpdateUserResponse); // [!code --] Изменён тип запроса
-}
-
-message GetUserRequestV2 { // [!code --] Новый тип запроса
-  string id = 1;
-  bool include_profile = 2;
-}
-
-message UserUpdateRequest { // [!code --] Новый тип запроса
-  string id = 1;
-  UserProfile profile = 2;
-}
-```
-
-**Ошибка:**
-```
-user_service.proto:6:3: RPC "GetUser" on service "UserService" changed request type from "GetUserRequest" to "GetUserRequestV2". (BREAKING_CHECK)
-user_service.proto:7:3: RPC "UpdateUser" on service "UserService" changed request type from "UpdateUserRequest" to "UserUpdateRequest". (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Смена типа из другого пакета:**
-```proto
-// Before
-import "common/user.proto";
-
-service UserService {
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-// After - BREAKING CHANGE!
-import "v2/user.proto";
-
-service UserService {
-  rpc CreateUser(v2.CreateUserRequest) returns (CreateUserResponse); // Другой package
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо изменения типа — версионируйте RPC:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-  rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse); // [!code focus] // Новый метод
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-  rpc UpdateUserV2(UserUpdateRequest) returns (UpdateUserResponse); // [!code focus] // Новый метод
-}
-
-// Старые сообщения — для обратной совместимости
-message GetUserRequest {
-  string user_id = 1;
-}
-
-// Новая версия сообщения
-message GetUserRequestV2 { // [!code focus]
-  string id = 1; // [!code focus]
-  bool include_profile = 2; // [!code focus]
-} // [!code focus]
-```
-
-**Или создайте новую версию сервиса (package v2):**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus]
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus]
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus]
-}
-
-message GetUserRequest { // [!code focus]
-  string id = 1; // [!code focus]
-  bool include_profile = 2; // [!code focus]
-} // [!code focus]
-```
-
-## Влияние
-
-- **Wire Format:** Старые запросы клиентов не десериализуются новым сервером
-- **Generated Code:** Сигнатуры методов в stubs меняются — компиляция клиентов падает
-- **gRPC Calls:** Требуется использовать другую структуру запроса
-- **Runtime Errors:** Несоответствие типов вызывает ошибки выполнения
-
-## Реальный пример
-
-**Код клиента ломается:**
-```go
-// Before
-client := myapi.NewUserServiceClient(conn)
-resp, err := client.GetUser(ctx, &myapi.GetUserRequest{
-    UserId: "user123",
-})
-
-// After (тип запроса изменён)
-client := myapi.NewUserServiceClient(conn)
-resp, err := client.GetUser(ctx, &myapi.GetUserRequest{  // ERROR: тип не найден
-    UserId: "user123",  // ERROR: поле не найдено
-})
-
-// Новый корректный вызов:
-resp, err := client.GetUser(ctx, &myapi.GetUserRequestV2{
-    Id: "user123",
-    IncludeProfile: true,
-})
-```
-
-**Серверная реализация ломается:**
-```go
-// Before
-func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
-    userID := req.UserId
-    // ...
-}
-
-// After
-func (s *server) GetUser(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) {
-    userID := req.Id
-    include := req.IncludeProfile
-    // ... новая логика
-}
-```
-
-## Стратегия миграции
-
-1. **Добавьте новый RPC с новым типом запроса:**
-   ```proto
-   rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-     option deprecated = true;
-   }
-   rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse);
-   ```
-
-2. **Поддерживайте оба метода на сервере:**
-   ```go
-   func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
-       return s.getUserInternal(req.UserId, false)
-   }
-
-   func (s *server) GetUserV2(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) {
-       return s.getUserInternal(req.Id, req.IncludeProfile)
-   }
-   ```
-
-3. **Мигрируйте клиентов на V2:**
-   ```go
-   resp, err := client.GetUserV2(ctx, &myapi.GetUserRequestV2{
-       Id: userID,
-       IncludeProfile: true,
-   })
-   ```
-
-4. **Удалите старый метод в следующей major‑версии:**
-   ```proto
-   rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse);
-   ```
-
-## Типовые сценарии
-
-### Добавление обязательных полей
-```proto
-// ПЛОХО: меняем существующий запрос
-message GetUserRequest {
-  string user_id = 1;
-  bool include_deleted = 2; // BREAKING
-}
-
-// Хорошо: новая версия
-message GetUserRequestV2 {
-  string user_id = 1;
-  bool include_deleted = 2;
-}
-```
-
-### Реструктуризация данных запроса
-```proto
-// ПЛОХО: меняем структуру прямо
-message UpdateUserRequest {
-  UserProfile profile = 1; // BREAKING
-}
-
-// Хорошо: версионирование
-rpc UpdateUser(UpdateUserRequest) returns (...) {
-  option deprecated = true;
-}
-rpc UpdateUserV2(UpdateUserRequestV2) returns (...);
-```
-
-### Миграция пакета
-```proto
-// ПЛОХО: заменяем тип на пакет v2 прямо
-import "v2/messages.proto"; // BREAKING
-
-// Хорошо: добавляем новый RPC
-rpc OldMethod(v1.Request) returns (...) {
-  option deprecated = true;
-}
-rpc NewMethod(v2.Request) returns (...);
-```
diff --git a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/rpc-same-response-type.md b/docs/dist/docs/ru-guide/cli/breaking-changes/rules/rpc-same-response-type.md
deleted file mode 100644
index 7f8eaeb4..00000000
--- a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/rpc-same-response-type.md
+++ /dev/null
@@ -1,314 +0,0 @@
-<!-- TODO: Review translation -->
-
-# RPC_SAME_RESPONSE_TYPE
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что RPC‑методы сохраняют тот же тип ответного сообщения (response message type). Изменение типа ответа RPC ломает совместимость по wire‑формату и сгенерированный код: клиенты ожидают конкретную структуру при получении ответа.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse);
-}
-
-message GetUserResponse {
-  string user_id = 1;
-  string name = 2;
-  string email = 3;
-}
-
-message UpdateUserResponse {
-  bool success = 1;
-  string message = 2;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponseV2); // [!code --] Изменён тип ответа
-  rpc UpdateUser(UpdateUserRequest) returns (UserUpdateResponse); // [!code --] Изменён тип ответа
-}
-
-message GetUserResponseV2 { // [!code --] Другой тип сообщения
-  string id = 1;
-  UserProfile profile = 2;
-  repeated string permissions = 3;
-}
-
-message UserUpdateResponse { // [!code --] Другой тип сообщения
-  UpdateResult result = 1;
-  UserProfile updated_profile = 2;
-}
-```
-
-**Ошибка:**
-```
-user_service.proto:6:3: RPC "GetUser" on service "UserService" changed response type from "GetUserResponse" to "GetUserResponseV2". (BREAKING_CHECK)
-user_service.proto:7:3: RPC "UpdateUser" on service "UserService" changed response type from "UpdateUserResponse" to "UserUpdateResponse". (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Смена типа из другого пакета:**
-```proto
-// Before
-import "common/responses.proto";
-
-service UserService {
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-// After - BREAKING CHANGE!
-import "v2/responses.proto";
-
-service UserService {
-  rpc CreateUser(CreateUserRequest) returns (v2.CreateUserResponse); // Другой package
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо изменения типа — версионируйте RPC:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-  rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2); // [!code focus] // Новый метод
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-  rpc UpdateUserV2(UpdateUserRequest) returns (UserUpdateResponse); // [!code focus] // Новый метод
-}
-
-// Старые сообщения сохраняем для обратной совместимости
-message GetUserResponse {
-  string user_id = 1;
-  string name = 2;
-  string email = 3;
-}
-
-// Новая расширенная версия
-message GetUserResponseV2 { // [!code focus]
-  string id = 1; // [!code focus]
-  UserProfile profile = 2; // [!code focus]
-  repeated string permissions = 3; // [!code focus]
-} // [!code focus]
-```
-
-**Или создайте новую версию сервиса (package v2):**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus]
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus]
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus]
-}
-
-message GetUserResponse { // [!code focus]
-  string id = 1; // [!code focus]
-  UserProfile profile = 2; // [!code focus]
-  repeated string permissions = 3; // [!code focus]
-} // [!code focus]
-```
-
-## Влияние
-
-- **Wire Format:** Ответы сервера не десериализуются у старых клиентов
-- **Generated Code:** Сигнатуры ожидают старый тип — компиляция падает
-- **gRPC Calls:** Меняются типы в сгенерированных stub'ах
-- **Runtime Errors:** Несоответствие типов ломает обработку ответа
-
-## Реальный пример
-
-**Код клиента ломается:**
-```go
-// Before
-client := myapi.NewUserServiceClient(conn)
-resp, err := client.GetUser(ctx, &myapi.GetUserRequest{
-    UserId: "user123",
-})
-if err != nil {
-    return err
-}
-
-userID := resp.UserId
-name := resp.Name
-
-// After (тип ответа изменён)
-client := myapi.NewUserServiceClient(conn)
-resp, err := client.GetUser(ctx, &myapi.GetUserRequest{
-    UserId: "user123",
-})
-if err != nil {
-    return err
-}
-
-// Ошибки компиляции:
-userID := resp.UserId  // ERROR
-name := resp.Name      // ERROR
-
-// Новый способ:
-userID := resp.Id
-profile := resp.Profile
-permissions := resp.Permissions
-```
-
-**Имплементация сервера также должна быть переписана:**
-```go
-// Before
-func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
-    return &GetUserResponse{
-        UserId: "user123",
-        Name:   "John Doe",
-        Email:  "john@example.com",
-    }, nil
-}
-
-// After
-func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) {
-    return &GetUserResponseV2{
-        Id: "user123",
-        Profile: &UserProfile{
-            Name:  "John Doe",
-            Email: "john@example.com",
-        },
-        Permissions: []string{"read"},
-    }, nil
-}
-```
-
-## Стратегия миграции
-
-1. **Добавьте новый RPC c новым типом ответа:**
-   ```proto
-   rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-     option deprecated = true;
-   }
-   rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2);
-   ```
-
-2. **Поддерживайте оба на сервере:**
-   ```go
-   func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
-       user := s.getUserInternal(req.UserId)
-       return &GetUserResponse{
-           UserId: user.ID,
-           Name:   user.Name,
-           Email:  user.Email,
-       }, nil
-   }
-
-   func (s *server) GetUserV2(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) {
-       user := s.getUserInternal(req.UserId)
-       return &GetUserResponseV2{
-           Id: user.ID,
-           Profile: &UserProfile{
-               Name:  user.Name,
-               Email: user.Email,
-           },
-           Permissions: user.Permissions,
-       }, nil
-   }
-   ```
-
-3. **Мигрируйте клиентов на новый RPC:**
-   ```go
-   resp, err := client.GetUserV2(ctx, &myapi.GetUserRequest{
-       UserId: userID,
-   })
-   if err != nil {
-       return err
-   }
-   profile := resp.Profile
-   permissions := resp.Permissions
-   ```
-
-4. **Удалите старый RPC** в следующей major‑версии:
-   ```proto
-   rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2);
-   ```
-
-## Типовые сценарии
-
-### Добавление новых обязательных полей
-```proto
-// ПЛОХО: меняем существующий тип
-message GetUserResponse {
-  string user_id = 1;
-  string name = 2;
-  UserProfile profile = 3; // BREAKING
-}
-
-// Хорошо: новая версия
-message GetUserResponseV2 {
-  string user_id = 1;
-  string name = 2;
-  UserProfile profile = 3;
-}
-```
-
-### Реструктуризация ответа
-```proto
-// ПЛОХО: меняем структуру прямо
-message UpdateUserResponse {
-  UserDetails details = 1; // BREAKING
-}
-
-// Хорошо: версионирование
-rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) {
-  option deprecated = true;
-}
-rpc UpdateUserV2(UpdateUserRequest) returns (UpdateUserResponseV2);
-```
-
-### Изменение формата ошибок
-```proto
-// ПЛОХО: меняем формат напрямую
-message CreateUserResponse {
-  ErrorDetails error = 1; // BREAKING
-}
-
-// Хорошо: новая версия
-rpc CreateUser(CreateUserRequest) returns (CreateUserResponse) {
-  option deprecated = true;
-}
-rpc CreateUserV2(CreateUserRequest) returns (CreateUserResponseV2);
-```
-
-### Миграция формата
-```proto
-// ПЛОХО: перевод простой структуры в сложную
-message GetUserResponse {
-  UserData data = 1; // BREAKING
-}
-
-// Хорошо: предоставляем обе версии
-rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-  option deprecated = true;
-}
-rpc GetUserDetailed(GetUserRequest) returns (GetUserDetailedResponse);
-```
diff --git a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/service-no-delete.md b/docs/dist/docs/ru-guide/cli/breaking-changes/rules/service-no-delete.md
deleted file mode 100644
index 58b47ff3..00000000
--- a/docs/dist/docs/ru-guide/cli/breaking-changes/rules/service-no-delete.md
+++ /dev/null
@@ -1,89 +0,0 @@
-<!-- TODO: Review translation -->
-
-# SERVICE_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Данное правило проверяет, что ни один service не был удалён из proto‑файлов. Удаление service ломает сгенерированный код и клиентские приложения, которые на него опираются.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-service OrderService { // [!code --]
-  rpc GetOrder(GetOrderRequest) returns (GetOrderResponse); // [!code --]
-} // [!code --]
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-// OrderService удалён — BREAKING CHANGE!
-```
-
-**Ошибка:**
-```
-services.proto:8:1: Previously present service "OrderService" was deleted from file. (BREAKING_CHECK)
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления — отметьте service как deprecated:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-service OrderService {
-  option deprecated = true; // [!code focus]
-  rpc GetOrder(GetOrderRequest) returns (GetOrderResponse) {
-    option deprecated = true; // [!code focus]
-  }
-}
-```
-
-## Влияние
-
-- **Generated Code:** Классы / интерфейсы сервиса исчезают — клиенты не компилируются
-- **Client Applications:** Существующие вызовы к удалённому сервису падают на этапе сборки
-- **Runtime:** gRPC клиенты теряют определение метода/сервиса
-
-## Стратегия миграции
-
-1. **Сначала деприкация:**
-   ```proto
-   service OldService {
-     option deprecated = true;
-     // ... methods
-   }
-   ```
-
-2. **Уведомите клиентов** о сроках вывода из эксплуатации
-
-3. **Удалите после периода миграции** в следующей major‑версии
\ No newline at end of file
diff --git a/docs/dist/docs/ru-guide/cli/configuration/configuration.md b/docs/dist/docs/ru-guide/cli/configuration/configuration.md
deleted file mode 100644
index 4a2c722e..00000000
--- a/docs/dist/docs/ru-guide/cli/configuration/configuration.md
+++ /dev/null
@@ -1,930 +0,0 @@
-# EasyP Configuration Reference
-
-EasyP can be configured through CLI flags, environment variables, and configuration files. This guide covers all configuration options available in EasyP.
-
-## CLI Flags
-
-### Global Flags
-
-Available for all commands:
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--cfg` | `-c` | `EASYP_CFG` | Configuration file path | `easyp.yaml` |
-| `--config` | | `EASYP_CFG` | Alias for `--cfg` | `easyp.yaml` |
-| `--debug` | `-d` | `EASYP_DEBUG` | Enable debug mode | `false` |
-| `--format` | `-f` | `EASYP_FORMAT` | Формат вывода для команд с поддержкой нескольких форматов (`text`/`json`) | значение по умолчанию зависит от команды |
-
-**Examples:**
-```bash
-# Use custom config file
-easyp --cfg production.easyp.yaml lint
-
-# Enable debug logging
-easyp --debug lint
-
-# Short form
-easyp -c custom.yaml -d lint
-```
-
-### Command-Specific Flags
-
-**Lint command:**
-```bash
-easyp lint [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--path` | `-p` | | Directory path to lint | `.` |
-| `--root` | `-r` | | Базовая директория для поиска файлов | Текущая рабочая директория |
-| `--format` | `-f` | `EASYP_FORMAT` | Использует глобальный флаг формата (`text`/`json`) | Использует глобальное значение по умолчанию |
-
-**Examples:**
-```bash
-# Lint specific directory
-easyp lint --path proto/
-
-# Lint из поддиректории с правильным разрешением импортов
-easyp lint --root src/IPC/Contracts --path .
-
-# JSON output format
-easyp --format json lint   # глобальный флаг
-
-# Combined flags
-easyp -f json lint -p proto/
-```
-
-**Generate command:**
-```bash
-easyp generate [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--path` | `-p` | `EASYP_ROOT_GENERATE_PATH` | Путь к директории с proto файлами для генерации | `.` |
-| `--root` | `-r` | | Базовая директория для поиска файлов | Текущая рабочая директория |
-
-**Examples:**
-```bash
-# Generate from specific path
-easyp generate --path api/
-
-# Generate из поддиректории с правильным разрешением импортов
-easyp generate --root src/IPC/Contracts --path .
-
-# Using environment variable
-EASYP_ROOT_GENERATE_PATH=proto/ easyp generate
-```
-
-**Breaking command:**
-```bash
-easyp breaking [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--against` | | | Git ref to compare against | `master` |
-| `--path` | `-p` | | Directory path to check | `.` |
-| `--format` | `-f` | `EASYP_FORMAT` | Использует глобальный флаг формата (`text`/`json`) | Использует глобальное значение по умолчанию |
-
-**Examples:**
-```bash
-# Check against main branch
-easyp breaking --against main
-
-# Check specific directory against develop branch
-easyp breaking --against develop --path proto/
-
-# JSON output
-easyp --format json breaking --against main   # глобальный флаг
-```
-
-**Init command:**
-```bash
-easyp init [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--dir` | `-d` | `EASYP_INIT_DIR` | Directory to initialize | `.` |
-
-**Examples:**
-```bash
-# Initialize current directory
-easyp init
-
-# Initialize specific directory
-easyp init --dir proto-project/
-```
-
-`easyp init` работает интерактивно:
-- Если в корне целевой директории есть `buf.yml`/`buf.yaml`, команда предложит миграцию из Buf.
-- Если `easyp.yaml` уже существует, команда запросит подтверждение на перезапись.
-
-**Validate-config command:**
-```bash
-easyp validate-config [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--config` | `-c` | `EASYP_CFG` | Путь до файла конфигурации | `easyp.yaml` |
-| `--format` (global) | `-f` | `EASYP_FORMAT` | Глобальный формат вывода для команд с несколькими форматами (`json` или `text`) | зависит от команды (`json` для `validate-config`) |
-
-**Examples:**
-```bash
-# Проверить конфиг по умолчанию с JSON выводом (статус 0 если ошибок нет)
-easyp validate-config
-
-# Проверить другой файл и вывести в текстовом формате (глобальный --format)
-easyp --format text validate-config --config example.easyp.yaml
-```
-
-**Package management commands:**
-
-#### `easyp mod download`
-Downloads dependencies based on lock file priority:
-
-1. **If `easyp.lock` exists** - downloads exact versions from lock file
-2. **If `easyp.lock` is missing** - downloads versions from `easyp.yaml` and creates `easyp.lock`
-
-```bash
-# Download exact versions (recommended for production)
-easyp mod download
-```
-
-#### `easyp mod update`  
-Always downloads dependencies from `easyp.yaml`, ignoring existing lock file:
-
-1. **Ignores `easyp.lock`** completely
-2. **Downloads versions from `easyp.yaml`**
-3. **Creates/updates `easyp.lock`** with new versions
-
-```bash
-# Update dependencies and lock file
-easyp mod update
-```
-
-#### `easyp mod vendor`
-Copies proto files from dependencies to local `vendor/` directory (similar to `go mod vendor`).
-
-```bash
-# Create local vendor directory with dependencies
-easyp mod vendor
-```
-
-No additional flags. Uses global `--cfg` flag for configuration.
-
-## Environment Variables
-
-EasyP supports environment variables for configuration:
-
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `EASYP_CFG` | Path to configuration file | `easyp.yaml` |
-| `EASYP_DEBUG` | Enable debug logging | `false` |
-| `EASYPPATH` | Cache and modules storage directory | `$HOME/.easyp` |
-| `EASYP_FORMAT` | Формат вывода для поддерживаемых команд (`text`/`json`). Если не указан, каждая команда использует своё значение по умолчанию. | значение по умолчанию зависит от команды |
-| `EASYP_ROOT_GENERATE_PATH` | Root path for generate command | `.` |
-| `EASYP_INIT_DIR` | Directory for init command | `.` |
-
-**Examples:**
-```bash
-# Custom cache directory
-export EASYPPATH=/tmp/easyp-cache
-easyp mod download
-
-# Debug mode via environment
-export EASYP_DEBUG=true
-easyp lint
-
-# Custom config file
-export EASYP_CFG=config/easyp.yaml
-easyp generate
-```
-
-## Configuration File
-
-The `easyp.yaml` file is the main configuration file for EasyP, defining how your proto files are linted, generated, and managed. This file is typically placed at the root of your project alongside your proto files.
-
-### File Structure Overview
-
-```
-.
-├── easyp.yaml
-├── easyp.lock
-├── proto/
-│   ├── user/
-│   │   └── user.proto
-│   └── order/
-│       └── order.proto
-└── vendor/
-```
-
-### Configuration Format
-
-EasyP supports both YAML and JSON configuration formats:
-
-#### YAML Format (Recommended)
-```yaml
-lint:
-  use:
-    - BASIC
-    - COMMENT_SERVICE
-deps:
-  - github.com/googleapis/googleapis@v1.0.0
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-breaking:
-  ignore:
-    - proto/experimental/
-  against_git_ref: main
-```
-
-#### JSON Format
-```json
-{
-  "lint": {
-    "use": ["BASIC", "COMMENT_SERVICE"]
-  },
-  "deps": [
-    "github.com/googleapis/googleapis@v1.0.0"
-  ],
-  "generate": {
-    "inputs": [
-      {"directory": "proto"}
-    ],
-    "plugins": [
-      {
-        "name": "go",
-        "out": ".",
-        "opts": {
-          "paths": "source_relative"
-        }
-      }
-    ]
-  },
-  "breaking": {
-    "ignore": ["proto/experimental/"],
-    "against_git_ref": "main"
-  }
-}
-```
-
-### Переменные окружения в конфигурации
-
-EasyP поддерживает расширение переменных окружения непосредственно в файле конфигурации `easyp.yaml`. Это позволяет использовать переменные окружения для динамических значений конфигурации.
-
-**Пример со всеми поддерживаемыми возможностями:**
-```yaml
-deps:
-  # Базовое расширение: ${VAR} - расширяется в значение переменной VAR
-  - ${GOOGLEAPIS_REPO}@${GOOGLEAPIS_VERSION}
-  
-  # Значение по умолчанию: ${VAR:-default} - использует default, если VAR не установлена или пустая
-  - ${GNOSTIC_REPO:-github.com/google/gnostic}@${GNOSTIC_VERSION:-v0.7.0}
-
-generate:
-  inputs:
-    # Значение по умолчанию, если INPUT_DIR не установлена
-    - directory: ${INPUT_DIR:-proto}
-  plugins:
-    - name: go
-      # Базовое расширение
-      out: ${OUTPUT_DIR}
-      opts:
-        # Значение по умолчанию
-        module: ${MODULE_NAME:-github.com/example/project}
-        timeout: ${TIMEOUT:-30}
-        
-        # Экранирование: $$ становится буквальным $, $${VAR} становится буквальным ${VAR}
-        path: "${BASE_DIR}/$${TEMP}/file"         # Результат: "/tmp/${TEMP}/file" (если BASE_DIR=/tmp)
-        literal: "$$"                             # Результат: "$"
-```
-
-**Поддерживаемый синтаксис:**
-- `${VAR}` - расширяется в значение переменной `VAR`
-- `${VAR:-default}` - использует `default`, если `VAR` не установлена или пустая
-- `${VAR:=default}` - использует `default`, если `VAR` не установлена или пустая
-- `${VAR-default}` - использует `default`, если `VAR` не установлена (пустая строка сохраняется)
-- `$${VAR}` или `$$VAR` - экранирует в буквальную строку `${VAR}` или `$VAR`
-- `$$` - экранирует в буквальный символ `$`
-
-**Примечание:** Переменные окружения расширяются до парсинга YAML, поэтому любой паттерн `${STRING}` будет обработан. Используйте `$$` для экранирования символов доллара, когда нужны буквальные значения.
-
-## Configuration Fields
-
-### `version`
-
-**Опционально (legacy-совместимость).** Поле поддерживается для обратной совместимости и может быть опущено в новых конфигурациях.
-
-**Type:** `string`
-**Default:** не задано
-**Рекомендация:** если сохраняете поле, используйте `v1alpha`
-
-```yaml
-# Опциональное поле для совместимости (можно опустить)
-version: v1alpha
-```
-
-На поведение рантайма это поле не влияет.
-
-### `lint`
-
-**Optional.** Configures proto file linting rules and behavior.
-
-**Type:** `object`
-**Default:** Empty (no linting rules applied)
-
-```yaml
-lint:
-  use:
-    - BASIC
-    - COMMENT_SERVICE
-  enum_zero_value_suffix: "UNSPECIFIED"
-  service_suffix: "Service"
-  ignore:
-    - vendor/
-    - proto/legacy/
-  except:
-    - COMMENT_FIELD
-  allow_comment_ignores: true
-  ignore_only:
-    COMMENT_SERVICE:
-      - proto/experimental/
-```
-
-#### `lint.use`
-
-**Optional.** Specifies which linter rules or rule categories to apply.
-
-**Type:** `[]string`
-**Default:** `[]` (no rules)
-
-**Available categories:**
-- `MINIMAL` - Essential package consistency checks
-- `BASIC` - Naming conventions and common patterns
-- `DEFAULT` - Additional recommended rules
-- `COMMENTS` - Comment requirements
-- `UNARY_RPC` - Streaming RPC restrictions
-
-**Individual rules:** Any specific rule name (e.g., `ENUM_PASCAL_CASE`, `FIELD_LOWER_SNAKE_CASE`)
-
-```yaml
-lint:
-  use:
-    - MINIMAL           # Use all minimal rules
-    - BASIC             # Use all basic rules
-    - COMMENT_SERVICE   # Require service comments
-    - ENUM_PASCAL_CASE  # Specific rule
-```
-
-**Rule Categories:**
-
-**MINIMAL:**
-- `DIRECTORY_SAME_PACKAGE`
-- `PACKAGE_DEFINED`
-- `PACKAGE_DIRECTORY_MATCH`
-- `PACKAGE_SAME_DIRECTORY`
-
-**BASIC:**
-- `ENUM_FIRST_VALUE_ZERO`
-- `ENUM_NO_ALLOW_ALIAS`
-- `ENUM_PASCAL_CASE`
-- `ENUM_VALUE_UPPER_SNAKE_CASE`
-- `FIELD_LOWER_SNAKE_CASE`
-- `IMPORT_NO_PUBLIC`
-- `IMPORT_NO_WEAK`
-- `IMPORT_USED`
-- `MESSAGE_PASCAL_CASE`
-- `ONEOF_LOWER_SNAKE_CASE`
-- `PACKAGE_LOWER_SNAKE_CASE`
-- `PACKAGE_SAME_CSHARP_NAMESPACE`
-- `PACKAGE_SAME_GO_PACKAGE`
-- `PACKAGE_SAME_JAVA_MULTIPLE_FILES`
-- `PACKAGE_SAME_JAVA_PACKAGE`
-- `PACKAGE_SAME_PHP_NAMESPACE`
-- `PACKAGE_SAME_RUBY_PACKAGE`
-- `PACKAGE_SAME_SWIFT_PREFIX`
-- `RPC_PASCAL_CASE`
-- `SERVICE_PASCAL_CASE`
-
-**DEFAULT:**
-- `ENUM_VALUE_PREFIX`
-- `ENUM_ZERO_VALUE_SUFFIX`
-- `FILE_LOWER_SNAKE_CASE`
-- `RPC_REQUEST_RESPONSE_UNIQUE`
-- `RPC_REQUEST_STANDARD_NAME`
-- `RPC_RESPONSE_STANDARD_NAME`
-- `PACKAGE_VERSION_SUFFIX`
-- `SERVICE_SUFFIX`
-
-**COMMENTS:**
-- `COMMENT_ENUM`
-- `COMMENT_ENUM_VALUE`
-- `COMMENT_FIELD`
-- `COMMENT_MESSAGE`
-- `COMMENT_ONEOF`
-- `COMMENT_RPC`
-- `COMMENT_SERVICE`
-
-**UNARY_RPC:**
-- `RPC_NO_CLIENT_STREAMING`
-- `RPC_NO_SERVER_STREAMING`
-
-#### `lint.enum_zero_value_suffix`
-
-**Optional.** Specifies the required suffix for enum zero values.
-
-**Type:** `string`
-**Default:** `""` (no suffix required)
-**Common values:** `"UNSPECIFIED"`, `"UNKNOWN"`, `"DEFAULT"`
-
-```yaml
-lint:
-  enum_zero_value_suffix: "UNSPECIFIED"
-```
-
-This enforces enum zero values like:
-```proto
-enum Status {
-  STATUS_UNSPECIFIED = 0;  // Required suffix
-  STATUS_ACTIVE = 1;
-  STATUS_INACTIVE = 2;
-}
-```
-
-#### `lint.service_suffix`
-
-**Optional.** Specifies the required suffix for service names.
-
-**Type:** `string`
-**Default:** `""` (no suffix required)
-**Common values:** `"Service"`, `"API"`, `"Svc"`
-
-```yaml
-lint:
-  service_suffix: "Service"
-```
-
-This enforces service names like:
-```proto
-service UserService {    // Required "Service" suffix
-  rpc GetUser(...) returns (...);
-}
-```
-
-#### `lint.ignore`
-
-**Optional.** Directories or files to exclude from all linting rules.
-
-**Type:** `[]string`
-**Default:** `[]`
-
-```yaml
-lint:
-  ignore:
-    - vendor/
-    - proto/legacy/
-    - testdata/
-    - "**/*_test.proto"
-```
-
-Paths are relative to the `easyp.yaml` file location. Supports glob patterns.
-
-#### `lint.except`
-
-**Optional.** Disables specific rules globally across the entire project.
-
-**Type:** `[]string`
-**Default:** `[]`
-
-```yaml
-lint:
-  except:
-    - COMMENT_FIELD
-    - COMMENT_MESSAGE
-    - SERVICE_SUFFIX
-```
-
-#### `lint.allow_comment_ignores`
-
-**Optional.** Enables inline comment-based rule ignoring within proto files.
-
-**Type:** `boolean`
-**Default:** `false`
-
-```yaml
-lint:
-  allow_comment_ignores: true
-```
-
-When enabled, allows comments like:
-```proto
-// buf:lint:ignore COMMENT_SERVICE
-service LegacyAPI {
-  // nolint:COMMENT_RPC
-  rpc GetData(...) returns (...);
-}
-```
-
-#### `lint.ignore_only`
-
-**Optional.** Disables specific rules only for certain files or directories.
-
-**Type:** `map[string][]string`
-**Default:** `{}`
-
-```yaml
-lint:
-  ignore_only:
-    COMMENT_SERVICE:
-      - proto/legacy/
-      - vendor/
-    SERVICE_SUFFIX:
-      - proto/external/
-```
-
-**Key:** Rule name or category
-**Value:** Array of file paths or directories
-
-### `deps`
-
-**Optional.** Lists external proto dependencies to download and manage.
-
-**Type:** `[]string`  
-**Default:** `[]`
-
-#### Dependency Format
-
-Dependencies follow the format: `$GIT_LINK@$VERSION`
-
-**Components:**
-- `$GIT_LINK` - Git repository URL (GitHub, GitLab, etc.)
-- `$VERSION` - Git tag or full commit hash (optional)
-
-**Format variations:**
-- `owner/repo` - Latest commit from default branch
-- `owner/repo@v1.0.0` - Specific git tag
-- `owner/repo@47b927cbb41c4fdea1292baf` - Full commit hash
-- `github.com/owner/repo@version` - Full URL with version
-- `gitlab.com/group/repo@tag` - GitLab repository
-
-```yaml
-deps:
-  # Latest commit from default branch
-  - googleapis/googleapis
-  
-  # Specific tag (recommended for production)
-  - googleapis/googleapis@v1.0.0
-  
-  # Full commit hash (most precise)
-  - googleapis/googleapis@47b927cbb41c4fdea1292bafadb8976f
-  
-  # Different Git hosting
-  - gitlab.com/acme/proto@v2.1.0
-```
-
-**Note:** If `@$VERSION` is omitted, EasyP downloads the latest commit from the repository's default branch.
-
-### `generate`
-
-**Optional.** Configures code generation from proto files.
-
-**Type:** `object`
-**Default:** `{}`
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-    - git_repo:
-        url: "github.com/acme/common@v1.0.0"
-        sub_directory: "proto"
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-```
-
-#### `generate.inputs`
-
-**Required when `generate` is set.** Specifies sources of proto files for generation.
-
-**Type:** `[]object` (minimum 1 item)
-**Default:** not set
-
-```yaml
-generate:
-  inputs:
-    # Local directory
-    - directory: "proto"
-
-    # Local directory with advanced options
-    - directory:
-        path: "api/proto"
-        root: "."
-
-    # Remote git repository
-    - git_repo:
-        url: "github.com/acme/common@v1.0.0"
-        sub_directory: "proto"
-        root: "."
-```
-
-**Directory input fields:**
-- `directory` (string or object) - Local directory path
-- `directory.path` (string) - Directory path
-- `directory.root` (string) - Root path for import resolution (default: ".")
-
-**Git repository input fields:**
-- `git_repo.url` (string) - Repository URL with optional version
-- `git_repo.sub_directory` (string) - Subdirectory within the repository
-- `git_repo.root` (string) - Root path used for import resolution
-
-#### `generate.plugins`
-
-**Required when `generate` is set.** Configures protoc plugins for code generation.
-
-**Type:** `[]object` (minimum 1 item)
-**Default:** not set
-
-```yaml
-generate:
-  plugins:
-    # Local plugin
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-
-    # Remote plugin
-    - remote: "buf.build/bufbuild/protovalidate-go:v0.4.0"
-      out: gen/go
-      opts:
-        paths: source_relative
-
-    # Plugin with import dependencies
-    - name: grpc-gateway
-      out: .
-      with_imports: true
-      opts:
-        paths: source_relative
-```
-
-**Plugin fields:**
-- `name` (string, optional) - Plugin name (omit `protoc-gen-` prefix)
-- `remote` (string, optional) - Remote plugin URL for execution
-- `path` (string, optional) - Path to plugin executable file
-- `command` ([]string, optional) - Command to execute plugin
-- `out` (string, optional) - Output directory for generated files; defaults to the resolved generate root
-- `opts` (map[string](string | number | boolean | array<string | number | boolean>), optional) - Plugin-specific options; each key can be a single scalar value or an array of scalar values
-- `with_imports` (boolean, optional) - Include imported dependencies
-
-Plugin source is `one-of`: exactly one of `name`, `remote`, `path`, or `command` must be set.
-
-**Common plugin options:**
-```yaml
-# Go plugin options
-opts:
-  paths: source_relative              # Generate files relative to input
-  module: github.com/acme/api        # Go module path
-
-# gRPC Gateway options
-opts:
-  paths: source_relative
-  grpc_api_configuration: api.yaml   # gRPC API configuration
-
-# OpenAPI v2 options
-opts:
-  simple_operation_ids: true         # Use simple operation IDs
-  generate_unbound_methods: false    # Skip unbound methods
-
-# ts-proto options with repeated key values
-opts:
-  env: node
-  outputServices:
-    - grpc-js
-    - generic-definitions
-```
-
-When an `opts` value is a list, EasyP serializes it as repeated plugin params, e.g. `outputServices=grpc-js,outputServices=generic-definitions`.
-
-### `breaking`
-
-**Optional.** Configures backward compatibility checking.
-
-**Type:** `object`
-**Default:** `{}`
-
-```yaml
-breaking:
-  ignore:
-    - proto/experimental/
-    - proto/internal/
-  against_git_ref: main
-```
-
-#### `breaking.ignore`
-
-**Optional.** Directories or files to exclude from breaking change detection.
-
-**Type:** `[]string`
-**Default:** `[]`
-
-```yaml
-breaking:
-  ignore:
-    - proto/experimental/
-    - proto/alpha/
-    - testdata/
-```
-
-#### `breaking.against_git_ref`
-
-**Optional.** Git reference (branch, tag, or commit) to compare against for breaking changes.
-
-**Type:** `string`
-**Default:** `""` (falls back to CLI `--against` default: `master`)
-
-```yaml
-breaking:
-  against_git_ref: main
-```
-
-Can be overridden by the `--against` CLI flag.
-
-
-
-## Configuration Examples
-
-### Minimal Configuration
-
-```yaml
-lint:
-  use:
-    - MINIMAL
-```
-
-### Development Configuration
-
-```yaml
-lint:
-  use:
-    - BASIC
-    - COMMENT_SERVICE
-    - COMMENT_RPC
-  allow_comment_ignores: true
-  ignore:
-    - vendor/
-    - testdata/
-deps:
-  - github.com/googleapis/googleapis@v1.0.0
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-```
-
-### Production Configuration
-
-```yaml
-lint:
-  use:
-    - MINIMAL
-    - BASIC
-    - DEFAULT
-    - COMMENTS
-  enum_zero_value_suffix: "UNSPECIFIED"
-  service_suffix: "Service"
-  ignore:
-    - vendor/
-  except: []
-  allow_comment_ignores: false
-deps:
-  - github.com/googleapis/googleapis@v1.56.0
-  - github.com/grpc-ecosystem/grpc-gateway@v2.18.0
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-        module: github.com/acme/api/gen/go
-    - name: go-grpc
-      out: gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-    - name: grpc-gateway
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: openapiv2
-      out: gen/openapi
-      opts:
-        simple_operation_ids: true
-breaking:
-  ignore:
-    - proto/experimental/
-  against_git_ref: main
-```
-
-### Multi-Service Configuration
-
-```yaml
-lint:
-  use:
-    - BASIC
-    - COMMENT_SERVICE
-    - COMMENT_RPC
-  service_suffix: "Service"
-  ignore_only:
-    COMMENT_FIELD:
-      - proto/internal/
-    SERVICE_SUFFIX:
-      - proto/legacy/
-deps:
-  - github.com/googleapis/googleapis@v1.0.0
-  - github.com/acme/common-proto@v2.1.0
-generate:
-  inputs:
-    - directory: "proto/public"
-    - directory: "proto/internal"
-    - git_repo:
-        url: "github.com/acme/shared-proto@v1.0.0"
-        sub_directory: "proto"
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: grpc-gateway
-      out: gen/go
-      opts:
-        paths: source_relative
-    - remote: "buf.build/bufbuild/protovalidate-go:v0.4.0"
-      out: gen/go
-      opts:
-        paths: source_relative
-breaking:
-  ignore:
-    - proto/internal/
-    - proto/experimental/
-  against_git_ref: develop
-```
-
-## Configuration Validation
-
-EasyP validates configuration files on startup and provides helpful error messages:
-
-```bash
-# Invalid rule name
-Error: invalid rule: INVALID_RULE_NAME
-
-# Missing required field in generate section
-Error: required field "plugins" is missing (path: generate.plugins)
-
-# Invalid dependency format
-Error: invalid dependency format: invalid-repo-url
-```
-
-Use `easyp --debug` for detailed validation information.
-
-## Migration from Buf
-
-EasyP is fully compatible with Buf configurations. To migrate:
-
-1. Place `buf.yaml` or `buf.yml` in the project root
-2. Run `easyp init` and confirm migration when prompted
-3. Update `deps` format if using BSR modules
-4. Review migrated lint/breaking settings and adjust as needed
-
-Most Buf configurations work without changes in EasyP.
diff --git a/docs/dist/docs/ru-guide/cli/generator/examples/go.md b/docs/dist/docs/ru-guide/cli/generator/examples/go.md
deleted file mode 100644
index bd9680e9..00000000
--- a/docs/dist/docs/ru-guide/cli/generator/examples/go.md
+++ /dev/null
@@ -1,81 +0,0 @@
-# Go
-
-## Установка плагинов
-
-Сначала установите необходимые плагины для работы с gRPC:
-
-```shell
-go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
-go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
-```
-
-Эти команды установят плагины `protoc-gen-go` и `protoc-gen-go-grpc` для использования с EasyP.
-
-## Пример proto‑сервиса
-
-Ниже пример proto-файла для сервиса Echo:
-
-```proto
-syntax = "proto3";
-
-package api.echo.v1;
-
-option go_package = "github.com/easyp-tech/example/api/echo/v1;pb";
-
-service EchoAPI {
-  rpc Echo(EchoRequest) returns (EchoResponse);
-  rpc EchoStream(EchoStreamRequest) returns (EchoResponse);
-}
-
-message EchoRequest {
-  string payload = 1;
-}
-
-message EchoResponse {
-  string payload = 2;
-}
-
-message EchoStreamRequest {
-  string payload = 1;
-}
-
-message EchoStreamResponse {
-  string payload = 2;
-}
-```
-
-## Настройка конфигурации
-
-Создайте и настройте файл конфигурации `easyp.yaml`:
-
-```yaml
-generate:
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-```
-
-Этот файл указывает использование двух плагинов: `go` для генерации Go-кода и `go-grpc` для генерации gRPC-кода, вместе с их опциями.
-
-## Генерация кода
-
-Чтобы сгенерировать код, выполните команду:
-
-```shell
-easyp --cfg easyp.yaml generate
-```
-
-Если флаг `--cfg` не указан, по умолчанию используется файл `easyp.yaml` в текущей директории:
-
-```shell
-easyp generate
-```
-
-Теперь у вас есть сгенерированный Go‑код, с которым можно напрямую работать.
\ No newline at end of file
diff --git a/docs/dist/docs/ru-guide/cli/generator/examples/grpc-gateway.md b/docs/dist/docs/ru-guide/cli/generator/examples/grpc-gateway.md
deleted file mode 100644
index da53345b..00000000
--- a/docs/dist/docs/ru-guide/cli/generator/examples/grpc-gateway.md
+++ /dev/null
@@ -1,112 +0,0 @@
-# gRPC-Gateway
-
-## Установка плагинов
-
-В дополнение к плагинам для работы с gRPC, необходимо установить следующие плагины для gRPC-Gateway:
-
-    go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
-    go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
-    go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2@latest
-    go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest
-
-Эти команды установят плагины `protoc-gen-go`, `protoc-gen-go-grpc`, `protoc-gen-openapiv2` и
-`protoc-gen-grpc-gateway` для использования с EasyP.
-
-## Пример Proto сервиса
-
-Ниже — исходный proto‑файл для сервиса Echo:
-
-    syntax = "proto3";
-
-    package api.echo.v1;
-
-    option go_package = "github.com/easyp-tech/example/api/echo/v1;pb";
-
-    service EchoAPI {
-      rpc Echo(EchoRequest) returns (EchoResponse);
-    }
-
-    message EchoRequest {
-      string payload = 1;
-    }
-
-    message EchoResponse {
-      string payload = 2;
-    }
-
-Чтобы использовать gRPC-Gateway, обновите proto‑файл, добавив HTTP‑опции:
-
-    syntax = "proto3";
-    import "google/api/annotations.proto";
-
-    package api.echo.v1;
-
-    option go_package = "github.com/easyp-tech/example/api/echo/v1;pb";
-
-    service EchoAPI {
-      rpc Echo(EchoRequest) returns (EchoResponse) {
-        option (google.api.http) = { // [!code ++]
-          post: "/api/v1/echo"       // [!code ++]
-          body: "*"                  // [!code ++]
-        };                           // [!code ++]
-      }
-    }
-
-    message EchoRequest {
-      string payload = 1;
-    }
-
-    message EchoResponse {
-      string payload = 2;
-    }
-
-## Настройка конфигурации
-
-Обновите файл `easyp.yaml`, добавив необходимые зависимости и плагины:
-    deps:  # [!code ++]
-      - github.com/googleapis/googleapis  # [!code ++]
-
-    generate:
-      plugins:
-        - name: go
-          out: .
-          opts:
-            paths: source_relative
-        - name: go-grpc
-          out: .
-          opts:
-            paths: source_relative
-            require_unimplemented_servers: false
-        - name: grpc-gateway  # [!code ++]
-          out: .  # [!code ++]
-          opts:  # [!code ++]
-            paths: source_relative  # [!code ++]
-        - name: openapiv2        # [!code ++]
-          out: .  # [!code ++]
-          opts: # [!code ++]
-            simple_operation_ids: false  # [!code ++]
-            generate_unbound_methods: false  # [!code ++]
-
-Секция `deps` перечисляет зависимости, необходимые для импортов proto‑файлов.
-В данном случае добавляем `github.com/googleapis/googleapis`,
-поскольку там находится файл `annotations.proto`, используемый в определении сервиса.
-
-### Обновление зависимостей
-
-После обновления конфигурации выполните команду для загрузки указанных зависимостей:
-
-    easyp mod update
-
-Больше деталей по управлению зависимостями см. в разделе [Package Manager](../../package-manager/package-manager.md).
-
-## Генерация кода
-
-Для генерации кода используйте:
-
-    easyp --cfg easyp.yaml generate
-
-Если флаг `--cfg` не указан, по умолчанию используется файл `easyp.yaml` из текущей директории:
-
-    easyp generate
-
-Теперь у вас сгенерированы Go‑код и код gRPC-Gateway, с которыми можно работать напрямую.
\ No newline at end of file
diff --git a/docs/dist/docs/ru-guide/cli/generator/examples/validate.md b/docs/dist/docs/ru-guide/cli/generator/examples/validate.md
deleted file mode 100644
index 38c638d9..00000000
--- a/docs/dist/docs/ru-guide/cli/generator/examples/validate.md
+++ /dev/null
@@ -1,90 +0,0 @@
-# Validate
-
-## Установка плагинов
-
-Сначала установите необходимые плагины для работы с gRPC и проверок (validate):
-
-```shell
-go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
-go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
-go install github.com/envoyproxy/protoc-gen-validate@latest
-```
-
-Эти команды установят плагины `protoc-gen-go`, `protoc-gen-go-grpc` и `protoc-gen-validate` для использования вместе с EasyP.
-
-## Пример Proto сервиса
-
-Ниже пример proto‑файла для сервиса Echo:
-
-```proto
-syntax = "proto3";
-
-package api.echo.v1;
-
-import "validate/validate.proto";
-
-option go_package = "github.com/easyp-tech/example/api/echo/v1;pb";
-
-service EchoAPI {
-  rpc Echo(EchoRequest) returns (EchoResponse);
-  rpc EchoStream(EchoStreamRequest) returns (EchoResponse);
-}
-
-message EchoRequest {
-  string payload = 1 [(validate.rules).string = {max_len: 200}];
-}
-
-message EchoResponse {
-  string payload = 2;
-}
-
-message EchoStreamRequest {
-  string payload = 1 [(validate.rules).string = {max_len: 200}];
-}
-
-message EchoStreamResponse {
-  string payload = 2;
-}
-```
-
-## Настройка конфигурации
-
-Создайте и настройте файл конфигурации `easyp.yaml`:
-
-```yaml
-deps: # [!code ++]
-  - github.com/bufbuild/protoc-gen-validate  # [!code ++]
-
-generate:
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-    - name: validate
-      out: .
-      opts:
-        paths: source_relative
-        lang: "go"
-```
-
-## Генерация кода
-
-Чтобы сгенерировать код, выполните команду:
-
-```shell
-easyp --cfg easyp.yaml generate
-```
-
-Если флаг `--cfg` не указан, по умолчанию используется файл `easyp.yaml` из текущего каталога:
-
-```shell
-easyp generate
-```
-
-Теперь у вас есть сгенерированный Go‑код с поддержкой валидации, и вы можете напрямую использовать его в проекте.
\ No newline at end of file
diff --git a/docs/dist/docs/ru-guide/cli/generator/generator.md b/docs/dist/docs/ru-guide/cli/generator/generator.md
deleted file mode 100644
index 88582b07..00000000
--- a/docs/dist/docs/ru-guide/cli/generator/generator.md
+++ /dev/null
@@ -1,1325 +0,0 @@
-# Генератор
-
-[[toc]]
-
-EasyP включает мощный генератор, который упрощает процесс получения кода из proto‑файлов. Благодаря YAML‑конфигурациям работа становится гораздо более удобной и интуитивной по сравнению с прямым использованием команды protoc.
-
-## Ключевые особенности генератора
-
-1. **Упрощённая генерация кода**:
-    - Генерация кода из proto через декларативную `YAML`‑конфигурацию.
-    - Избавляет от необходимости писать длинные и сложные команды protoc.
-
-2. **Обёртка над protoc**:
-    - EasyP выступает как удобный слой над protoc, предоставляя декларативный API.
-    - Поддерживает все опции и плагины, доступные protoc.
-
-3. **Гибкость и кастомизация**:
-    - Используются те же параметры, что и у плагинов protoc, прямо в конфиге.
-    - Поддерживается множество плагинов и их параметры в одной конфигурации.
-
-4. **Генерация из нескольких источников**:
-    - Локальные директории и удалённые Git‑репозитории одновременно.
-    - Лёгкая интеграция с существующими проектами и репозиториями.
-
-5. **Удалённая генерация**:
-    - Генерация из удалённых Git репозиториев без локального checkout.
-
-6. **Интеграция с менеджером пакетов**:
-    - Прозрачная работа с зависимостями через пакетный менеджер EasyP.
-    - Автоматическое разрешение и подключение proto‑зависимостей.
-
-## Configuration Reference
-
-### Complete Configuration Example
-
-```yaml
-# Package manager dependencies
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-  - github.com/bufbuild/protoc-gen-validate@v0.10.1
-
-# Code generation configuration
-generate:
-  inputs:
-    # Local directory input
-    - directory: 
-        path: "proto"
-        root: "."
-    
-    # Remote Git repository input
-    - git_repo:
-        url: "github.com/acme/weather@v1.2.3"
-        sub_directory: "proto/api"
-    # Another remote repository
-    - git_repo:
-        url: "https://github.com/company/internal-protos.git"
-        sub_directory: "definitions"
-  plugins:
-    # Local plugin execution
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        module: github.com/mycompany/myproject
-      with_imports: true
-    
-    # Local plugin with custom options
-    - name: go-grpc
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-
-  # Managed mode - автоматическая установка file и field опций
-  managed:
-    enabled: true
-    disable:
-      - module: github.com/googleapis/googleapis  # Отключить для конкретного модуля
-    override:
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-      - file_option: java_package_prefix
-        value: com.mycompany
-      - file_option: csharp_namespace_prefix
-        value: MyCompany
-      - field_option: jstype
-        value: JS_STRING
-        path: api/v1/  # Применить к конкретному пути
-
-```
-
-### Input Sources
-
-#### Локальный ввод (Local Directory Input)
-
-Локальная директория — самый распространённый и простой способ указать откуда брать proto для генерации. Используйте этот вариант, если файлы уже находятся в репозитории проекта.
-
-**Когда применять:**
-- Proto файлы находятся в кодовой базе проекта
-- Нужен полный контроль над структурой каталогов
-- Проект — один сервис или приложение
-- Файлы меняются не слишком часто
-
-```yaml
-inputs:
-  - directory: "proto"                    # Простой строковый формат
-  
-  # Или подробный формат
-  - directory:
-      path: "proto"                       # Путь к proto файлам
-      root: "."                           # Корень для разрешения import
-```
-
-Параметр `root` особенно полезен в монорепозиториях: он позволяет управлять тем, откуда будут резолвиться пути импортов. Если указать родительскую директорию, импорты будут оцениваться относительно неё, а не текущего рабочего каталога.
-
-**Параметры:**
-
-| Параметр | Тип | Обязателен | Значение по умолчанию | Описание |
-|----------|-----|------------|-----------------------|----------|
-| `path` | string | ✅ | - | Каталог, содержащий proto файлы |
-| `root` | string | ❌ | `"."` | Корневая директория для разрешения import путей |
-
-**Примеры:**
-
-Ниже показана разница между базовым указанием директории и расширенной конфигурацией с пользовательским корнем импортов:
-
-```yaml
-# Basic usage - Simple path specification
-inputs:
-  - directory: "api/proto"
-
-# Advanced usage with custom root - Controls import path resolution
-inputs:
-  - directory:
-      path: "services/auth/proto" 
-      root: "services/auth"        # Imports will be relative to this path
-```
-
-#### Удалённый Git репозиторий (Remote Git Repository Input)
-
-Этот тип входных данных позволяет генерировать код из proto‑файлов, находящихся в удалённых репозиториях, без локального checkout. Особенно полезно при использовании API других команд или внешних поставщиков.
-
-**Когда использовать:**
-- Потребление proto определений из других сервисов/команд
-- Интеграция с внешними вендорскими API
-- Работа с общими библиотеками proto в нескольких проектах
-- Необходимо гарантировать корректную (зафиксированную) версию внешних API
-
-**Рекомендации:**
-- В продакшене всегда фиксируйте версии (`@v1.0.0`, а не latest)
-- Используйте семантические версии при наличии — проще сопровождать
-- Предпочитайте публичные теги вместо хеша коммита (лучше отслеживаемость)
-
-```yaml
-inputs:
-  - git_repo:
-      url: "github.com/company/protos@v1.0.0"    # Обязательное: репозиторий + версия
-      sub_directory: "api"                       # Опционально: поддиректория внутри репо
-```
-
-Параметр `root` задаёт корень для разрешения импортов файлов из этого репозитория.
-
-**Параметры:**
-
-| Параметр | Тип | Обязателен | По умолчанию | Описание |
-|----------|-----|------------|--------------|----------|
-| `url` | string | ✅ | - | URL Git репозитория с необязательной версией / тегом / коммитом |
-| `sub_directory` | string | ❌ | `""` | Поддиректория внутри репозитория, где лежат proto |
-| `root` | string | ❌ | `""` | Корневой путь для разрешения импортов |
-
-**Варианты формата URL:**
-
-EasyP поддерживает несколько форматов для ссылки на удалённые репозитории. Каждый подходит под разные требования по стабильности:
-
-- **Tagged versions** — для продакшена, стабильные неизменяемые ссылки
-- **Semantic versions** — читаемость и управление зависимостями
-- **Commit hashes** — доступ к конкретному коммиту, если нет тега
-- **Latest** — только для разработки, непредсказуемо
-- **Full HTTPS URLs** — приватные репозитории или нестандартный хостинг
-
-```yaml
-# Тег — стабильно для продакшена
-url: "github.com/googleapis/googleapis@common-protos-1_3_1"
-
-# Семантическая версия
-url: "github.com/grpc-ecosystem/grpc-gateway@v2.19.1"  
-
-# Хеш коммита — точечный фикс
-url: "github.com/company/protos@abc123def456"
-
-# Latest — только dev, НЕ для продакшена
-url: "github.com/company/protos"
-
-# Полный HTTPS URL — приватный или кастомный Git
-url: "https://github.com/company/private-protos.git"
-```
-
-**Примеры:**
-
-Ниже паттерны использования удалённых источников в разных сценариях:
-
-```yaml
-# Публичный репозиторий с фиксированной версией — типично для внешних API
-inputs:
-  - git_repo:
-      url: "github.com/googleapis/googleapis@common-protos-1_3_1"
-      sub_directory: "google"
-# Приватный репозиторий с аутентификацией — внутренние API
-inputs:
-  - git_repo:
-      url: "github.com/mycompany/internal-protos@v2.1.0"
-      sub_directory: "api/definitions"
-# Несколько удалённых источников — часто в микросервисной архитектуре
-inputs:
-  - git_repo:
-      url: "github.com/grpc-ecosystem/grpc-gateway@v2.19.1"
-      sub_directory: "protoc-gen-openapiv2/options"
-  - git_repo:
-      url: "github.com/bufbuild/protoc-gen-validate@v0.10.1"  
-      sub_directory: "validate"
-```
-
-### Конфигурация плагинов
-
-Конфигурация плагинов определяет какие генераторы кода будут запущены и как они себя ведут. EasyP поддерживает любой плагин protoc, что делает его крайне гибким для разных языковых экосистем и сценариев.
-
-На верхнем уровне есть **четыре способа указать, как именно запускать плагин**:
-
-- **`name`** – запуск плагина по имени из `PATH` или использование встроенного плагина.
-- **`path`** – запуск плагина по абсолютному/относительному пути к исполняемому файлу.
-- **`remote`** – удалённый плагин по URL (через remote‑executor EasyP).
-- **`command`** – запуск плагина через произвольную команду (например, `go run ...`).
-
-Для каждого плагина должен быть указан **ровно один** из параметров `name`, `path`, `remote` или `command`.
-
-#### Плагин по имени (`name`)
-
-Локальный режим по имени — стандартный: плагины установлены в системе и запускаются напрямую через EasyP.
-
-**Когда использовать `name`:**
-- Стандартные языки (Go, Python, TypeScript и т.д.)
-- Есть контроль над окружением сборки
-- Критична производительность (нет сетевых задержек)
-- Хочется опираться на `PATH` или встроенные плагины
-
-**Требования к установке:**
-- Плагины установлены и доступны в `PATH` (если не используются встроенные).
-- Имена следуют шаблону `protoc-gen-{name}`.
-- Установка через менеджеры пакетов (go install, npm install, pip install и т.п.).
-
-```yaml
-plugins:
-  - name: go                              # Имя плагина (локальный или встроенный)
-    out: ./generated                      # Директория для вывода
-    opts:                                 # Опции конкретного плагина
-      paths: source_relative
-      module: github.com/mycompany/project
-    with_imports: true                    # Включить импорт зависимостей
-```
-
-Параметр `with_imports` критичен при использовании зависимостей из пакетного менеджера: установите `true`, чтобы прототипы из секции `deps` попали в генерацию.
-
-#### Плагин по пути (`path`)
-
-Иногда нужно запускать плагин из конкретного бинарника, не добавляя его в `PATH` (например, бинарь в репозитории или в build‑директории). В этом случае можно указать явный путь:
-
-```yaml
-plugins:
-  - path: ./bin/protoc-gen-my-custom
-    out: ./gen/custom
-    opts:
-      foo: bar
-```
-
-**Когда использовать `path`:**
-- Бинарники плагинов хранятся в репозитории (для воспроизводимых сборок).
-- Используются несколько версий одного и того же плагина параллельно.
-- Не хочется «загрязнять» глобальный `PATH`.
-
-#### Удалённый плагин (`remote`)
-
-Удалённые плагины выполняются по URL. EasyP отправляет на удалённую сторону `CodeGeneratorRequest` и получает обратно `CodeGeneratorResponse`.
-
-Ниже приведён реальный пример использования EasyP API Service как удалённого исполнителя плагинов (тот же формат используется в разделе про API Service):
-
-```yaml
-generate:
-  plugins:
-    # Удалённое выполнение плагинов через EasyP API Service
-    - remote: api.easyp.tech/protobuf/go:v1.36.10
-      out: .
-      opts:
-        paths: source_relative
-
-    - remote: api.easyp.tech/grpc/go:v1.5.1
-      out: .
-      opts:
-        paths: source_relative
-```
-
-**Типичные сценарии для `remote`:**
-- Централизованный сервис плагинов внутри компании (например, EasyP API Service).
-- Запуск тяжёлых плагинов на выделенных машинах вместо CI‑агентов.
-- Совместное использование одной реализации плагина разными командами.
-
-#### Выполнение плагина через команду (`command`)
-
-Вы можете указать плагин как массив команд для выполнения. Это полезно для запуска плагинов через `go run` или любые другие инструменты без предварительной установки бинарника плагина:
-
-```yaml
-plugins:
-  - command: ["go", "run", "github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.25.1"]
-    out: ./gen/go
-    opts:
-      paths: source_relative
-```
-
-В этом режиме EasyP:
-- **запускает указанную команду** как дочерний процесс;
-- **пишет `CodeGeneratorRequest` в stdin** процесса;
-- **читает `CodeGeneratorResponse` из stdout**, как и для обычных плагинов protoc.
-
-**Приоритет источников плагина:**
-1. `command` — выполнение через указанную команду (наивысший приоритет)
-2. `remote` — удалённый плагин через URL
-3. `name` — локальный плагин из PATH или встроенный плагин
-4. `path` — путь к исполняемому файлу плагина
-
-**Параметры (источники и общие опции плагина):**
-
-| Параметр | Тип | Обязателен | По умолчанию | Описание |
-|----------|-----|------------|--------------|----------|
-| `name` | string | ❌ | - | Имя / идентификатор плагина (например, `go`, `go-grpc`, `grpc-gateway`) |
-| `command` | []string | ❌ | - | Команда для выполнения плагина (например, `["go", "run", "package"]`) |
-| `remote` | string | ❌ | - | URL удалённого плагина |
-| `path` | string | ❌ | - | Путь к исполняемому файлу плагина |
-| `out` | string | ❌ | resolved generate root | Директория для сгенерированных файлов |
-| `opts` | map[string](string \| number \| boolean \| array<string \| number \| boolean>) | ❌ | `{}` | Специфичные опции плагина; значения-списки передаются как повторяющиеся `key=value` |
-| `with_imports` | bool | ❌ | `false` | Включать proto из зависимостей |
-
-**Примечание:** Для каждого плагина должен быть указан ровно один источник (`name`, `command`, `remote` или `path`).
-Если `opts.outputServices` задан как `["grpc-js", "generic-definitions"]`, EasyP передаст `outputServices=grpc-js,outputServices=generic-definitions`.
-
-**Примеры использования источника `command`:**
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-
-  plugins:
-    # 1) gRPC-Gateway через go run (без предварительной установки бинарника)
-    - command: ["go", "run", "github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.25.1"]
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        generate_unbound_methods: true
-
-    # 2) protoc-gen-validate через go run
-    - command: ["go", "run", "github.com/bufbuild/protoc-gen-validate@v0.10.1"]
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        lang: go
-
-    # 3) Произвольный кастомный скрипт-обёртка
-    - command: ["bash", "./scripts/custom-protoc-plugin.sh"]
-      out: ./gen/custom
-      opts:
-        foo: bar
-```
-
-#### Встроенные плагины (Builtin Plugins)
-
-EasyP поддерживает встроенные плагины для базовых языков protobuf и gRPC. Эти плагины встроены в бинарник как WASM-модули и не требуют установки внешних зависимостей.
-
-**Преимущества встроенных плагинов:**
-- **Портативность**: Один бинарник со всеми необходимыми плагинами
-- **Удобство**: Не требуется установка внешних зависимостей
-- **Стабильность**: Версии плагинов зафиксированы в бинарнике
-- **Изоляция**: Не зависит от системных установок плагинов
-
-**Поддерживаемые встроенные плагины:**
-
-#### Protobuf базовые плагины
-
-Следующие плагины встроены для генерации базового protobuf кода:
-
-| Имя плагина | Описание | Соответствующий protoc плагин |
-|-------------|----------|-------------------------------|
-| `cpp` | Генерация C++ кода из proto файлов | `protoc-gen-cpp` |
-| `csharp` | Генерация C# кода из proto файлов | `protoc-gen-csharp` |
-| `java` | Генерация Java кода из proto файлов | `protoc-gen-java` |
-| `kotlin` | Генерация Kotlin кода из proto файлов | `protoc-gen-kotlin` |
-| `objc` | Генерация Objective-C кода из proto файлов | `protoc-gen-objc` |
-| `php` | Генерация PHP кода из proto файлов | `protoc-gen-php` |
-| `python` | Генерация Python кода из proto файлов | `protoc-gen-python` |
-| `ruby` | Генерация Ruby кода из proto файлов | `protoc-gen-ruby` |
-
-#### gRPC плагины
-
-Следующие плагины встроены для генерации gRPC кода:
-
-| Имя плагина | Описание | Соответствующий protoc плагин |
-|-------------|----------|-------------------------------|
-| `grpc_cpp` | Генерация gRPC кода для C++ | `grpc_cpp_plugin` |
-| `grpc_csharp` | Генерация gRPC кода для C# | `grpc_csharp_plugin` |
-| `grpc_java` | Генерация gRPC кода для Java | `grpc_java_plugin` |
-| `grpc_node` | Генерация gRPC кода для Node.js | `grpc_node_plugin` |
-| `grpc_objc` | Генерация gRPC кода для Objective-C | `grpc_objective_c_plugin` |
-| `grpc_php` | Генерация gRPC кода для PHP | `grpc_php_plugin` |
-| `grpc_python` | Генерация gRPC кода для Python | `grpc_python_plugin` |
-| `grpc_ruby` | Генерация gRPC кода для Ruby | `grpc_ruby_plugin` |
-
-**Логика выбора плагина:**
-
-EasyP использует следующий приоритет при выборе executor'а для плагина:
-
-1. **Удалённый плагин** (если указан `url`) — всегда имеет наивысший приоритет
-2. **Встроенный плагин** (если плагин встроен и не найден в PATH) — используется автоматически
-3. **Локальный плагин** (из PATH) — используется по умолчанию для обратной совместимости
-
-**Пример использования:**
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    # Встроенный плагин Python (автоматически используется, если protoc-gen-python не найден в PATH)
-    - name: python
-      out: ./gen/python
-      opts:
-        pyi_out: ./gen/python
-    
-    # Встроенный gRPC плагин для Python
-    - name: grpc_python
-      out: ./gen/python
-    
-    # Встроенный плагин C++ (автоматически используется, если protoc-gen-cpp не найден в PATH)
-    - name: cpp
-      out: ./gen/cpp
-      opts:
-        dllexport_decl: EXPORT
-    
-    # Встроенный gRPC плагин для C++
-    - name: grpc_cpp
-      out: ./gen/cpp
-```
-
-**Требования:**
-
-Встроенные плагины включены в бинарник EasyP:
-
-```bash
-# Сборка
-go build ./cmd/easyp
-
-# Установка
-go install github.com/easyp-tech/easyp/cmd/easyp@latest
-```
-
-**Обратная совместимость:**
-
-Встроенные плагины полностью совместимы с существующими конфигурациями. Если плагин найден в PATH, он будет использован вместо встроенного. Это гарантирует, что:
-
-- Существующие конфигурации продолжают работать без изменений
-- Можно переопределить встроенный плагин, установив его в системе
-- Приоритет отдаётся локальным установкам для гибкости
-
-### Справочник опций плагинов
-
-Ниже перечислены наиболее часто используемые плагины и их настройки. Каждый плагин имеет параметры, влияющие на результат генерации — понимание этих опций важно для получения нужного вывода.
-
-#### Go Plugins
-
-Плагины для Go — самые зрелые и распространённые. Опция `paths` управляет тем, как формируются пути импортов; остальные опции дают тонкую настройку вывода.
-
-```yaml
-plugins:
-  # protoc-gen-go — генерирует структуры и базовые protobuf функции
-  - name: go
-    out: ./gen/go
-    opts:
-      paths: source_relative              # source_relative | import
-      module: github.com/company/project  # Go module path для импорта
-      
-  # protoc-gen-go-grpc — генерирует gRPC серверные/клиентские заглушки
-  - name: go-grpc
-    out: ./gen/go
-    opts:
-      paths: source_relative
-      require_unimplemented_servers: false  # Включение UnimplementedServer
-```
-
-#### gRPC-Gateway Plugins
-
-Позволяют экспонировать gRPC сервисы как REST API и генерировать OpenAPI. Критично для HTTP/JSON поверх gRPC.
-
-```yaml
-plugins:
-  # protoc-gen-grpc-gateway — reverse proxy REST→gRPC
-  - name: grpc-gateway
-    out: ./gen/go
-    opts:
-      paths: source_relative
-      generate_unbound_methods: true      # Включать методы без HTTP привязок
-      
-  # protoc-gen-openapiv2 — генерирует OpenAPI/Swagger
-  - name: openapiv2  
-    out: ./gen/openapi
-    opts:
-      simple_operation_ids: true          # Простые operationId
-      generate_unbound_methods: false     # Исключить методы без HTTP аннотаций
-      json_names_for_fields: true         # Использовать JSON имена
-```
-
-#### Validation Plugins
-
-Генерируют код валидации на основе правил в proto, устраняя ручную проверку.
-
-```yaml
-plugins:
-  # protoc-gen-validate — генерация проверок полей
-  - name: validate-go
-    out: ./gen/go
-    opts:
-      paths: source_relative
-      lang: go                           # Целевой язык
-```
-
-#### TypeScript/JavaScript Plugins
-
-TypeScript плагины нужны фронтенду: типобезопасные интерфейсы и клиенты.
-
-```yaml
-plugins:
-  # protoc-gen-ts — типы и сериализация
-  - name: ts
-    out: ./gen/typescript  
-    opts:
-      declaration: true                   # Генерация .d.ts
-      target: es2017                      # Целевой ECMAScript
-      
-  # protoc-gen-grpc-web — gRPC-Web клиенты для браузера
-  - name: grpc-web
-    out: ./gen/web
-    opts:
-      import_style: typescript           # Стиль импорта
-      mode: grpcweb                      # Режим транспорта
-```
-
-## Managed Mode
-
-Managed mode автоматически устанавливает file и field опции в protobuf дескрипторах во время генерации кода без изменения исходных `.proto` файлов. Эта функция совместима с managed mode в `buf` и обеспечивает единообразный способ управления языково-специфичными опциями в вашей кодовой базе.
-
-**Ключевые преимущества:**
-- **Без изменений proto файлов**: Опции применяются во время генерации, proto файлы остаются чистыми
-- **Согласованные значения по умолчанию**: Автоматическое применение языковых соглашений об именовании
-- **Централизованная конфигурация**: Управление всеми опциями в одном месте (`easyp.yaml`)
-- **Правила для модулей**: Применение разных опций к разным модулям или путям
-- **Совместимость с buf**: Работает так же, как managed mode в `buf`
-
-### Как это работает
-
-Когда managed mode включён, EasyP автоматически применяет file и field опции к protobuf дескрипторам перед генерацией кода. Это происходит в памяти, поэтому исходные `.proto` файлы остаются неизменными.
-
-**Значения по умолчанию** применяются для определённых опций на основе языковых соглашений:
-- Java: `java_package_prefix` по умолчанию `"com"`, `java_multiple_files` по умолчанию `true`
-- C#: `csharp_namespace` по умолчанию PascalCase имени пакета
-- Ruby: `ruby_package` по умолчанию PascalCase с разделителем `::`
-- PHP: `php_namespace` по умолчанию PascalCase с разделителем `\`
-- Objective-C: `objc_class_prefix` по умолчанию первые буквы частей пакета
-- C++: `cc_enable_arenas` по умолчанию `true`
-
-**Overrides** позволяют установить конкретные значения для опций с поддержкой фильтрации по модулю, protobuf package, пути или полю. Если не указаны `module`, `package` и `path`, override применяется ко всем файлам в запросе генерации, включая зависимости и `git_repo` inputs.
-
-**Disables** позволяют предотвратить изменение managed mode определённых опций или файлов. Это рекомендуемый способ исключить внешние зависимости, у которых свои опции уже заданы.
-
-### Конфигурация
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    disable:
-      # Отключить managed mode для конкретного модуля
-      - module: github.com/googleapis/googleapis
-      
-      # Отключить конкретную опцию глобально
-      - file_option: java_package_prefix
-
-      # Отключить для конкретного protobuf package
-      - package: acme.weather.v1
-        file_option: java_package
-      
-      # Отключить для конкретного пути
-      - path: legacy/
-        file_option: go_package
-      
-      # Отключить field опцию для конкретного поля
-      - field_option: jstype
-        field: com.example.User.id
-    
-    override:
-      # Переопределить go_package_prefix для всех файлов
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-      
-      # Переопределить для конкретного модуля
-      - file_option: java_package_prefix
-        value: com.mycompany
-        module: github.com/mycompany/internal-protos
-
-      # Переопределить для конкретного protobuf package
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-        package: acme.weather.v1
-      
-      # Переопределить для конкретного пути
-      - file_option: csharp_namespace_prefix
-        value: MyCompany
-        path: api/v1/
-      
-      # Переопределить для нескольких файлов с одинаковым значением используя префиксный путь
-      # Это совпадет и с internal/cms/bmi.proto, и с internal/cms/bmi_service.proto
-      - file_option: go_package
-        value: spec/cms/bmi
-        path: "internal/cms/bmi"
-      
-      # Переопределить field опцию для конкретного пути
-      - field_option: jstype
-        value: JS_STRING
-        path: api/v1/
-      
-      # Переопределить для конкретного поля
-      - field_option: jstype
-        value: JS_NUMBER
-        field: com.example.User.big_id
-```
-
-### Поддерживаемые File Options
-
-| Опция | Описание | Есть значение по умолчанию? |
-|-------|----------|----------------------------|
-| `go_package` | Go import path | ❌ |
-| `go_package_prefix` | Префикс для Go import paths | ❌ |
-| `java_package` | Имя Java пакета | ❌ |
-| `java_package_prefix` | Префикс для Java пакетов | ✅ (`"com"`) |
-| `java_package_suffix` | Суффикс для Java пакетов | ❌ |
-| `java_multiple_files` | Генерировать несколько Java файлов | ✅ (`true`) |
-| `java_outer_classname` | Имя внешнего класса | ✅ (PascalCase + "Proto") |
-| `java_string_check_utf8` | UTF-8 валидация | ❌ |
-| `csharp_namespace` | C# namespace | ✅ (PascalCase) |
-| `csharp_namespace_prefix` | Префикс для C# namespaces | ❌ |
-| `ruby_package` | Имя Ruby модуля | ✅ (PascalCase с `::`) |
-| `ruby_package_suffix` | Суффикс для Ruby пакетов | ❌ |
-| `php_namespace` | PHP namespace | ✅ (PascalCase с `\`) |
-| `php_metadata_namespace` | PHP metadata namespace | ❌ |
-| `php_metadata_namespace_suffix` | Суффикс для PHP metadata | ❌ |
-| `objc_class_prefix` | Objective-C префикс класса | ✅ (Первые буквы) |
-| `swift_prefix` | Swift префикс | ❌ |
-| `optimize_for` | Оптимизация генерации кода | ❌ |
-| `cc_enable_arenas` | C++ arena аллокация | ✅ (`true`) |
-
-### Поддерживаемые Field Options
-
-| Опция | Описание | Применяется к |
-|-------|----------|---------------|
-| `jstype` | JavaScript тип для 64-битных целых чисел | `int64`, `uint64`, `sint64`, `fixed64`, `sfixed64` |
-
-### Примеры
-
-#### Базовая настройка со значениями по умолчанию
-
-Включите managed mode для получения автоматических значений по умолчанию для всех поддерживаемых языков:
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-    - name: java
-      out: ./gen/java
-    - name: csharp
-      out: ./gen/csharp
-  managed:
-    enabled: true
-```
-
-Это автоматически установит:
-- `java_package` в `com.<package>` для всех файлов
-- `java_multiple_files` в `true`
-- `csharp_namespace` в PascalCase имени пакета
-- `ruby_package` в PascalCase с разделителем `::`
-- И многое другое...
-
-#### Кастомный префикс Go пакета
-
-Переопределите префикс Go пакета для вашего проекта:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-```
-
-Это установит `go_package` в `github.com/mycompany/myproject/gen/go/<package>` для всех файлов.
-
-#### Динамические пути Go пакетов с маркерами
-
-Для более сложной генерации путей можно использовать маркеры в значениях `go_package_prefix` или `go_package`:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      # Использовать путь файла напрямую (без расширения .proto)
-      - file_option: go_package_prefix
-        value: github.com/mycompany/{{file_path}}
-      
-      # Использовать только путь директории
-      - file_option: go_package_prefix
-        value: github.com/mycompany/{{file_dir}}
-      
-      # Удалить префикс из пути директории
-      - file_option: go_package_prefix
-        value: github.com/mycompany/{{file_dir_without:internal/}}
-      
-      # Удалить префикс из полного пути файла
-      - file_option: go_package_prefix
-        value: github.com/mycompany/{{file_path_without:internal/}}
-```
-
-**Доступные маркеры:**
-- `{{file_path}}` - Полный путь файла без расширения `.proto`
-  - Пример: `internal/cms/as.proto` → `internal/cms/as`
-- `{{file_dir}}` - Только путь директории, без имени файла
-  - Пример: `internal/cms/as.proto` → `internal/cms`
-- `{{file_dir_without:prefix/}}` - Путь директории с удалением префикса и базового имени файла без суффиксов `_service`/`_grpc`
-  - Пример: `{{file_dir_without:internal/}}` для `internal/cms/as_service.proto` → `cms/as`
-- `{{file_path_without:prefix/}}` - Полный путь файла с удалением префикса
-  - Пример: `{{file_path_without:internal/}}` для `internal/cms/as.proto` → `cms/as`
-
-#### Переопределения для конкретных модулей
-
-Примените разные опции к разным модулям:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      # Значение по умолчанию для всех файлов
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-      
-      # Конкретное переопределение для внутреннего модуля
-      - file_option: go_package_prefix
-        value: github.com/mycompany/internal/gen/go
-        module: github.com/mycompany/internal-protos
-```
-
-`module` должен точно совпадать с источником модуля в EasyP: это значение из `deps` или `git_repo.url` до `@version` (например, `github.com/mycompany/internal-protos` или `https://github.com/mycompany/internal-protos`). Это не Go module path из `go.mod`.
-
-`package` должен точно совпадать со значением `package` в `.proto` файле, например `acme.weather.v1`.
-
-#### Переопределения для конкретного protobuf package
-
-Примените отдельные опции к файлам из конкретного protobuf package:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-      - file_option: go_package
-        package: acme.weather.v1
-        value: github.com/mycompany/myproject/gen/go/acme/weather/v1
-```
-
-#### Отключение для внешних зависимостей
-
-Отключите managed mode для внешних зависимостей, у которых уже установлены опции:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    disable:
-      - module: github.com/googleapis/googleapis
-      - module: github.com/grpc-ecosystem/grpc-gateway
-```
-
-#### Типобезопасность JavaScript
-
-Установите `jstype` в `JS_STRING` для всех 64-битных целочисленных полей, чтобы предотвратить потерю точности в JavaScript:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      - field_option: jstype
-        value: JS_STRING
-        path: api/v1/  # Применить к конкретному пути
-```
-
-### Совпадение путей
-
-Совпадение путей в managed mode использует префиксное совпадение (как в `buf`):
-
-- **Путь директории** (заканчивается на `/`): Совпадает со всеми файлами в этой директории и поддиректориях
-  - Пример: `path: "internal/cms/"` совпадает с `internal/cms/as.proto`, `internal/cms/node.proto`, `internal/cms/v1/service.proto`
-- **Точный путь файла** (заканчивается на `.proto`): Совпадает только с этим конкретным файлом
-  - Пример: `path: "internal/cms/as.proto"` совпадает только с `internal/cms/as.proto`
-- **Префиксный путь** (без завершающего `/` или `.proto`): Использует префиксное совпадение (не директориально-осознанное)
-  - Пример: `path: "internal/cms"` совпадает с `internal/cms/as.proto`, но также с `internal/cmsv2/file.proto`
-  - **Совет**: Используйте префиксные пути для группировки нескольких файлов с одинаковым значением. Например, `path: "internal/cms/bmi"` совпадает и с `internal/cms/bmi.proto`, и с `internal/cms/bmi_service.proto`, что позволяет установить одно и то же значение `go_package` для обоих файлов одним правилом.
-
-### Приоритет правил
-
-Когда несколько правил соответствуют одному файлу или полю, применяется следующий приоритет:
-
-1. **Disable правила** имеют приоритет — если опция отключена, она не будет применена
-2. **Override правила** применяются по порядку — последнее совпадающее правило побеждает
-3. **Значения по умолчанию** применяются только если нет совпадающего override и опция не отключена
-
-### Совместимость с buf
-
-Managed mode в EasyP совместим с managed mode в `buf`. Тот же формат конфигурации и поведение применяются, что упрощает миграцию между инструментами или использование обоих в одном workflow.
-
-## Генерация Descriptor Set
-
-**https://protobuf.dev/programming-guides/techniques/#self-description**
-
-EasyP поддерживает генерацию бинарных FileDescriptorSet файлов с помощью флага `--descriptor_set_out`. Это позволяет создавать самоописывающиеся protobuf сообщения, которые включают информацию о схеме вместе с данными.
-
-**Флаги CLI:**
-
-- `--descriptor_set_out <путь>` - Путь для вывода бинарного FileDescriptorSet
-- `--include_imports` - Включить все транзитивные зависимости в FileDescriptorSet
-
-**Пример:**
-
-```bash
-# Генерация descriptor set только с целевыми файлами
-easyp generate --descriptor_set_out=./schema.pb
-
-# Генерация descriptor set со всеми зависимостями
-easyp generate --descriptor_set_out=./schema.pb --include_imports
-```
-
-Самоописывающиеся сообщения полезны для динамического парсинга сообщений, валидации схемы во время выполнения, реестров схем и создания универсальных gRPC клиентов. Для получения дополнительной информации см. [документацию Protocol Buffers о самоописании](https://protobuf.dev/programming-guides/techniques/#self-description).
-
-## Интеграция с менеджером пакетов
-
-Одной из самых мощных возможностей EasyP является бесшовная интеграция генератора кода с менеджером пакетов. Это устраняет проблему ручного управления proto‑зависимостями и гарантирует, что при генерации используются корректные (зафиксированные) версии импортируемых файлов.
-
-**Ключевые преимущества:**
-- **Автоматическое разрешение зависимостей**: не нужно вручную прописывать пути импортов
-- **Согласованность версий**: фиксация в `easyp.lock` гарантирует воспроизводимость
-- **Транзитивные зависимости**: вложенные цепочки подтягиваются автоматически
-- **Производительность**: локальный кеш — скачивание один раз и повторное использование
-
-### Автоматическое разрешение зависимостей
-
-Когда вы указываете зависимости в секции `deps`, генератор автоматически добавляет их в путь импортов. Ваши proto‑файлы могут делать стандартные `import` из этих зависимостей без дополнительной настройки.
-
-**Как это работает:**
-1. EasyP скачивает и кеширует зависимости из `deps`
-2. Во время генерации кешированные файлы автоматически добавляются в import‑path protoc
-3. Ваши proto‑файлы используют обычные import строки для обращения к зависимостям
-4. При `with_imports: true` в вывод попадают и локальные файлы, и файлы зависимостей
-
-Ниже простой пример — зависимости указываются один раз в `deps`, далее они доступны при генерации автоматически:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-      with_imports: true    # This automatically includes googleapis and grpc-gateway protos
-```
-
-### Примеры использования зависимостей
-
-Ниже показаны распространённые способы интеграции внешних proto‑зависимостей в процесс генерации.
-
-#### Использование Google APIs
-
-Google APIs — одна из самых популярных коллекций зависимостей: стандартные типы, аннотации для REST, проверки и общие структуры данных.
-
-**Когда использовать Google APIs:**
-- Построение REST поверх gRPC (gRPC-Gateway)
-- Нужны стандартные типы (`Timestamp`, `Duration`, `Any`)
-- Требуются аннотации поведения полей (field behavior)
-- Интеграция с сервисами Google Cloud
-
-Минимальная конфигурация для подключения Google APIs:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-
-generate:
-  inputs:
-    - directory: "api/proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-      with_imports: true
-```
-
-**Важно:** Всегда фиксируйте версию (например `common-protos-1_3_1`) — не используйте latest в продакшене.
-
-После настройки ваши proto могут импортировать определения Google API. Ниже пример сервиса с HTTP аннотацией:
-
-```proto
-// api/proto/service.proto
-syntax = "proto3";
-
-import "google/api/annotations.proto";
-import "google/protobuf/timestamp.proto";
-
-service MyService {
-  rpc GetData(GetDataRequest) returns (GetDataResponse) {
-    option (google.api.http) = {
-      get: "/v1/data"
-    };
-  }
-}
-```
-
-#### Использование правил валидации
-
-`protoc-gen-validate` даёт мощную проверку полей прямо в определениях proto, устраняя необходимость писать отдельную логику валидации в приложении.
-
-**Когда применять валидацию:**
-- Проверка входных данных API
-- Ограничения моделей БД
-- Проверка конфигурационных файлов
-- Любая ситуация, где критична целостность данных
-
-**Преимущества:**
-- Правила валидации — часть proto (единый источник истины)
-- Генерация создаёт функции проверки автоматически
-- Единообразие проверок между языками
-- Производительнее чем проверка через runtime reflection
-
-```yaml
-deps:
-  - github.com/bufbuild/protoc-gen-validate@v0.10.1
-
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-      with_imports: true
-    - name: validate-go
-      out: ./gen/go  
-      opts:
-        paths: source_relative
-```
-
-**Примечание:** Нужны одновременно зависимость (для импортов proto) и плагин (для генерации кода), чтобы получить полноценную поддержку валидации.
-
-Так выглядят правила валидации в proto — сгенерированный код будет автоматически их применять:
-
-```proto
-// proto/user.proto
-syntax = "proto3";
-
-import "validate/validate.proto";
-
-message User {
-  string email = 1 [(validate.rules).string.email = true];
-  int32 age = 2 [(validate.rules).int32.gte = 0];
-}
-```
-
-#### Комплексная конфигурация с несколькими зависимостями
-
-Пример ниже показывает продакшен‑конфигурацию, объединяющую несколько зависимостей и плагины для полного цикла разработки API:
-
-```yaml
-deps:
-  # Core Google APIs - Standard types and HTTP annotations
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  
-  # gRPC Gateway for REST APIs - Enables HTTP/JSON interfaces
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-  
-  # Validation rules - Field-level validation constraints
-  - github.com/bufbuild/protoc-gen-validate@v0.10.1
-  
-  # Company internal shared types - Common business objects
-  - github.com/mycompany/shared-protos@v1.5.0
-
-generate:
-  inputs:
-    - directory: "api/proto"
-  plugins:
-    # Go code generation - Core protobuf structures
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        module: github.com/mycompany/myservice
-      with_imports: true
-      
-    # gRPC service stubs - Server and client interfaces
-    - name: go-grpc
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-        
-    # REST Gateway - HTTP-to-gRPC proxy code
-    - name: grpc-gateway
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        
-    # OpenAPI documentation - API specification
-    - name: openapiv2
-      out: ./gen/openapi
-      opts:
-        simple_operation_ids: true
-        
-    # Validation code - Input validation functions
-    - name: validate-go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-```
-
-### Интеграция с кешем зависимостей
-
-Генератор использует модульный кеш EasyP для ускорения сборок:
-
-```bash
-# Download dependencies once
-easyp mod download
-
-# Generate code (uses cached dependencies)
-easyp generate
-
-# Dependencies are cached in ~/.easyp/mod/
-ls ~/.easyp/mod/github.com/googleapis/googleapis/
-```
-
-## Удалённая генерация
-
-Удалённая генерация — мощная возможность, позволяющая генерировать код из proto‑файлов в удалённых Git‑репозиториях без локального checkout. Это поддерживает микросервисную архитектуру, где команды используют API друг друга без жёсткой связки.
-
-**Преимущества:**
-- **Развязка разработки**: Команды развиваются независимо, используя версии API друг друга
-- **Контроль версий**: Фиксация внешних API гарантирует стабильность
-- **Меньше размер репозитория**: Нет необходимости в vendoring/submodule внешних proto
-- **Автоматические обновления**: Легко перейти на новую версию по готовности
-
-**Рекомендации:**
-- В продакшене используйте только тегированные версии
-- В разработке можно тестировать latest, но в проде фиксируйте
-- При наличии используйте семантическое версионирование
-- Учитывайте сетевые ограничения в CI/CD
-
-### Источники удалённых proto
-
-Генерация напрямую из удалённых репозиториев — полезно в микросервисной архитектуре, где разные команды владеют разными proto.
-
-**Типовой workflow:**
-1. Команда A публикует proto с версиями в Git
-2. Команда B добавляет их в свой `easyp.yaml`
-3. При генерации EasyP скачивает и подключает удалённые proto
-4. Сгенерированный код содержит клиентские библиотеки сервисов команды A
-
-Практический пример объединения локальных и удалённых источников в одной конфигурации генерации:
-
-```yaml
-generate:
-  inputs:
-    # Local protos - Your service's own API definitions
-    - directory: "proto"
-    
-    # Remote public repository - External vendor API
-    - git_repo:
-        url: "github.com/acme/weather-api@v2.1.0"
-        sub_directory: "proto/weather/v1"
-    # Remote private repository - Internal company API
-    - git_repo:
-        url: "github.com/mycompany/internal-apis@main"
-        sub_directory: "user-service/proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-      with_imports: true
-```
-
-
-
-### Сценарии использования удалённой генерации
-
-Примеры ниже показывают реальные ситуации, где удалённая генерация даёт ощутимую выгоду.
-
-#### Много команд (Multi-Team Development)
-
-Мультикомандная разработка особенно выигрывает: вместо координации общих репозиториев и сложного управления зависимостями — независимая эволюция API с контролируемыми обновлениями через версии.
-
-Паттерн ценен в крупных организациях, где:
-- Команды имеют разные циклы релизов и скорости разработки
-- Владение API определено, потребление — массовое  
-- Нужно избежать overhead от координации общих proto репозиториев
-- Команды используют разные стеки, но должны взаимодействовать
-
-```yaml
-# Team A (Order Service) generates from Team B's proto definitions
-generate:
-  inputs:
-    # Local service definitions - APIs owned by this team
-    - directory: "proto/orders"
-    
-    # User service protos from another team - Stable, versioned API
-    - git_repo:
-        url: "github.com/company/user-service@v1.8.0"  
-        sub_directory: "api/proto"
-    # Payment service protos - Different team, different version
-    - git_repo:
-        url: "github.com/company/payment-service@v2.3.1"
-        sub_directory: "proto/payment/v2"  
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        module: github.com/company/order-service
-      with_imports: true
-```
-
-#### Интеграция с API вендоров
-
-Многие вендоры публикуют proto для своих API, позволяя генерировать типобезопасных клиентов вместо ручных HTTP реализаций. Это повышает типовую строгость, автоматизирует сериализацию и часто ускоряет работу.
-
-Преимущества использования proto от вендоров:
-- **Type safety**: Проверка типов на этапе компиляции
-- **Automatic updates**: Новые возможности приходят с обновлением версии
-- **Consistency**: Единые паттерны интерфейсов между интеграциями
-- **Performance**: Бинарная сериализация быстрее JSON
-- **Documentation**: Proto выступают источником истины для API
-
-```yaml
-# Generate clients for external vendor APIs
-generate:
-  inputs:
-    # Vendor's public proto definitions - Financial services
-    - git_repo:
-        url: "github.com/stripe/stripe-proto@v1.0.0"
-        sub_directory: "proto"
-    # Communication service APIs - SMS/Voice integration
-    - git_repo:  
-        url: "github.com/twilio/twilio-protos@v2.1.0"
-        sub_directory: "definitions"
-  plugins:
-    - name: go
-      out: ./clients/go
-      opts:
-        paths: source_relative
-        module: github.com/mycompany/integrations
-```
-
-
-
-## Команды
-
-CLI EasyP предоставляет гибкие варианты запуска генерации с разными конфигурациями и окружениями.
-
-### Базовая генерация
-
-Ниже наиболее часто применяемые варианты команд для разработки и продакшена:
-
-```bash
-# Use default easyp.yaml configuration - Most common for development
-easyp generate
-
-# Use custom configuration file - Essential for multi-environment setups  
-easyp --cfg production.easyp.yaml generate
-
-# Generate with debug logs - Helpful for debugging and CI/CD
-easyp --debug generate
-
-# Generate with custom cache location - Useful for CI systems or shared environments
-EASYPPATH=/tmp/easyp-cache easyp generate
-```
-
-### Интеграция с менеджером пакетов
-
-Интеграция с менеджером пакетов позволяет либо явно управлять зависимостями, либо поручить это генератору. Явный путь даёт больше контроля, автоматический — больше удобства:
-
-```bash
-# Explicit workflow - Better for CI/CD and when you want to cache dependencies
-easyp mod download    # Download and cache dependencies first
-easyp generate        # Generate code using cached dependencies
-
-# Automatic workflow - Convenient for development (generate downloads dependencies automatically)
-easyp generate
-```
-
-### Расширенное использование (Advanced Usage)
-
-Эти варианты полезны для специфических сценариев деплоя, отладки или когда нужен более тонкий контроль процесса генерации:
-
-```bash
-# Генерация из конкретной директории (перекрывает настройку в файле конфигурации)
-easyp generate --path=./api/proto
-
-# Генерация с vendored зависимостями (оффлайн / Docker контейнеры)
-easyp mod vendor
-easyp generate
-
-# Генерация из кастомного project root (удобно для монореп и вложенных рабочих директорий)
-easyp generate --root=/usr/local/src/my-project --path=./api/proto
-```
-
-## Типовые паттерны (Common Patterns)
-
-Эти схемы отражают реальные сценарии и лучшие практики организации генерации кода в разных структурах проектов.
-
-### Мульти-языковая генерация (Multi-Language Generation)
-
-Мульти-языковая генерация критична для компаний, использующих разные технологии в стеке. EasyP облегчает получение согласованных клиентских библиотек и типов для нескольких языков из одного источника proto.
-
-**Типовые сценарии:**
-- **Full‑stack приложения**: backend на Go/Java + фронтенд на TypeScript
-- **Платформы данных**: сервисы на Go + аналитика / ML на Python  
-- **Микросервисы**: каждый сервис — оптимальный язык под задачу
-- **Внешние SDK**: предоставление клиентских библиотек партнёрам
-- **Интеграция с легаси**: современные gRPC сервисы + старые системы
-
-**Производительность:**
-- Каждый плагин запускается отдельно — время растёт линейно от количества плагинов
-- Для больших наборов используйте параллельный запуск (`make -j4`)
-- Структурируйте выходные директории иерархически — меньше конфликтов
-- Плагины имеют разную скорость — профилируйте сборку для поиска узких мест
-
-**Преимущества сопровождения:**
-- Единый источник истины для API снижает риск расхождения схем
-- Согласованные типы уменьшают интеграционные баги
-- Автоматическая синхронизация при изменении proto исключает ручные правки
-- Меньше риска дрейфа API между реализациями на разных языках
-- Рефакторинг упрощается — изменения транзитивно отражаются во всех артефактах
-
-Ниже пример типичной мульти-языковой конфигурации для full‑stack приложения: backend, веб‑клиент, аналитика и документация:
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-    
-  plugins:
-    # Go backend services - Primary implementation language
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        module: github.com/company/backend
-      with_imports: true
-      
-    - name: go-grpc  # gRPC server and client stubs
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        
-    # TypeScript frontend - Web application client code
-    - name: ts  
-      out: ./gen/typescript
-      opts:
-        declaration: true       # Generate type definitions
-        target: es2020         # Modern JavaScript for browsers
-        
-    # Python data science - Analytics and ML workflows
-    - name: python
-      out: ./gen/python
-      opts:
-        mypy_out: ./gen/python-stubs  # Type checking support
-        
-    # Documentation - API reference for developers
-    - name: doc
-      out: ./docs/api
-      opts:
-        markdown: true         # Generate markdown documentation
-```
-
-**Совет по организации:** Используйте отдельные выходные директории для каждого языка, чтобы избежать конфликтов файлов и упростить интеграцию с языковыми сборочными системами.
-
-
-
-
-
-Генератор EasyP — комплексное решение для генерации кода из Protocol Buffers: от простой локальной разработки до сложных enterprise‑сценариев с удалёнными зависимостями и мульти-языковым выводом.
diff --git a/docs/dist/docs/ru-guide/cli/linter/linter.md b/docs/dist/docs/ru-guide/cli/linter/linter.md
deleted file mode 100644
index e31b5063..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/linter.md
+++ /dev/null
@@ -1,334 +0,0 @@
-# Линтер
-
-[[toc]]
-
-## Зачем нужен линтер для proto файлов?
-
-Линтеры играют ключевую роль в современной разработке, особенно когда речь о `.proto` файлах. Они обеспечивают единый стиль и структуру, помогают находить потенциальные ошибки на ранних этапах и поддерживают читаемость кода. Это даёт выгоды:
-
-- **Снижение затрат на разработку:** Ошибки ловятся раньше, меньше времени на отладку.
-- **Улучшение командного взаимодействия:** Единообразный код легче понимать и сопровождать.
-- **Бизнес-эффективность:** Более качественный код → меньше инцидентов в проде → ниже стоимость поддержки.
-
-## Справочник по конфигурации
-
-Конфигурация линтера настраивается в секции `lint` файла `easyp.yaml`.
-
-### Полный пример конфигурации
-
-```yaml
-lint:
-  # Используемые категории и правила
-  use:
-    - MINIMAL
-    - BASIC
-    - COMMENT_SERVICE
-    - COMMENT_RPC
-  
-  # Кастомные суффиксы
-  enum_zero_value_suffix: "UNSPECIFIED"
-  service_suffix: "Service"
-  
-  # Исключения директорий и файлов
-  ignore:
-    - "vendor/"
-    - "third_party/"
-    - "legacy/old_protos/"
-  
-  except:
-    - COMMENT_FIELD
-    - COMMENT_MESSAGE
-  
-  # Разрешить игнорирование правил комментариями
-  allow_comment_ignores: true
-  
-  # Игнор отдельных правил только для указанных путей
-  ignore_only:
-    COMMENT_SERVICE: ["legacy/", "vendor/"]
-    SERVICE_SUFFIX: ["proto/external/"]
-```
-
-### Параметры конфигурации
-
-#### `use` ([]string)
-Определяет набор правил или категорий для включения. Можно смешивать категории и конкретные правила.
-
-**Категории:**
-- **MINIMAL**: Базовая согласованность пакетов
-- **BASIC**: Соглашения по именованию и структуре  
-- **DEFAULT**: Рекомендованные правила для большинства проектов
-- **COMMENTS**: Требования к комментариям
-- **UNARY_RPC**: Ограничение на streaming RPC
-
-**Индивидуальные правила:** Любое имя правила (например `ENUM_PASCAL_CASE`, `FIELD_LOWER_SNAKE_CASE`)
-
-**Примеры:**
-```yaml
-# Только категории
-use: [MINIMAL, BASIC, DEFAULT]
-
-# Смешивание
-use:
-  - MINIMAL
-  - COMMENT_SERVICE
-  - COMMENT_RPC
-  - ENUM_PASCAL_CASE
-
-# Точный набор
-use:
-  - PACKAGE_DEFINED
-  - SERVICE_PASCAL_CASE
-  - FIELD_LOWER_SNAKE_CASE
-```
-
-#### `enum_zero_value_suffix` (string)
-Обязывает нулевое значение enum иметь заданный суффикс.
-
-**Обычно:** `"UNSPECIFIED"`, `"UNKNOWN"`, `"DEFAULT"`
-```yaml
-enum_zero_value_suffix: "UNSPECIFIED"
-```
-
-```proto
-enum Status {
-  STATUS_UNSPECIFIED = 0;  // Требуемый суффикс
-  STATUS_ACTIVE = 1;
-  STATUS_INACTIVE = 2;
-}
-```
-
-#### `service_suffix` (string)
-Требуемый суффикс для имён сервисов (унификация стиля).
-
-```yaml
-service_suffix: "Service"
-```
-
-```proto
-service UserService { // Обязательный суффикс
-  rpc GetUser(...) returns (...);
-}
-```
-
-#### `ignore` ([]string)
-Полное исключение путей из линтинга.
-
-**Use cases:**
-- vendor / third_party
-- сгенерированные файлы
-- легаси подпакеты
-- тестовые фикстуры
-
-```yaml
-ignore:
-  - "vendor/"
-  - "third_party/"
-  - "testdata/"
-  - "proto/legacy/"
-  - "**/*_test.proto"
-```
-
-#### `except` ([]string)
-Глобально отключает правила.
-
-```yaml
-except:
-  - COMMENT_FIELD
-  - COMMENT_MESSAGE
-  - SERVICE_SUFFIX
-  - ENUM_ZERO_VALUE_SUFFIX
-```
-
-#### `allow_comment_ignores` (bool)
-Разрешает инлайн‑игнор правил комментариями.
-
-```yaml
-allow_comment_ignores: true
-```
-
-```proto
-// buf:lint:ignore COMMENT_SERVICE
-service LegacyUserAPI {
-  // nolint:COMMENT_RPC
-  rpc GetUser(...) returns (...);
-}
-```
-
-#### `ignore_only` (map[string][]string)
-Таргетированное игнорирование конкретных правил для указанных путей.
-
-```yaml
-ignore_only:
-  COMMENT_SERVICE:
-    - "proto/legacy/"
-    - "vendor/"
-  SERVICE_SUFFIX:
-    - "proto/external/"
-    - "third_party/"
-  FIELD_LOWER_SNAKE_CASE:
-    - "proto/legacy/old_messages.proto"
-    - "vendor/external_api.proto"
-```
-
-## Игнор правил комментариями
-
-Если включён `allow_comment_ignores`, можно точечно отключать правила.
-
-### Форматы комментариев
-
-#### Совместимый с Buf
-```proto
-// buf:lint:ignore RULE_NAME
-```
-
-#### Нативный EasyP
-```proto
-// nolint:RULE_NAME
-```
-
-### Примеры
-
-#### Игнор правил сервиса
-```proto
-// buf:lint:ignore COMMENT_SERVICE
-// buf:lint:ignore SERVICE_SUFFIX
-service UserAPI {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-}
-```
-
-#### Игнор RPC
-```proto
-service UserService {
-  // nolint:COMMENT_RPC
-  // nolint:RPC_REQUEST_STANDARD_NAME
-  rpc GetUserInfo(UserInfoReq) returns (UserInfoResp);
-}
-```
-
-#### Игнор Message и Field
-```proto
-// buf:lint:ignore COMMENT_MESSAGE
-message UserData {
-  // nolint:COMMENT_FIELD
-  // nolint:FIELD_LOWER_SNAKE_CASE
-  string userName = 1;
-}
-```
-
-#### Игнор Enum
-```proto
-// nolint:COMMENT_ENUM
-// nolint:ENUM_ZERO_VALUE_SUFFIX
-enum UserType {
-  UNKNOWN = 0; // Обычно требовался бы суффикс
-  ADMIN = 1;
-  USER = 2;
-}
-```
-
-#### Несколько правил в одной строке
-```proto
-// buf:lint:ignore COMMENT_SERVICE,SERVICE_SUFFIX
-service LegacyAPI {
-  // nolint:COMMENT_RPC,RPC_REQUEST_STANDARD_NAME
-  rpc getData(DataReq) returns (DataResp);
-}
-```
-
-### Рекомендации
-
-#### Используйте редко
-Частое игнорирование = сигнал пересмотреть конфигурацию.
-```proto
-// Легаси сервис - buf:lint:ignore SERVICE_SUFFIX
-service UserAPI { ... }
-```
-
-#### Плохой пример
-```proto
-// nolint:COMMENT_SERVICE,SERVICE_SUFFIX,COMMENT_RPC
-service UserAPI { ... }
-```
-
-#### Добавляйте пояснения
-```proto
-// Совместимость с внешним API
-// buf:lint:ignore SERVICE_SUFFIX
-service ExternalUserAPI {
-  // Легаси имя метода
-  // nolint:RPC_REQUEST_STANDARD_NAME
-  rpc getUserData(UserReq) returns (UserResp);
-}
-```
-
-#### Предпочитайте конфигурацию
-Если нужно игнорировать правило в группе файлов — используйте `ignore_only`.
-
-## Категории линтера
-
-Категории помогают быстро выбрать уровень строгости.
-
-**Когда использовать:**
-- **MINIMAL**: Минимальная базовая целостность
-- **BASIC**: Частые соглашения имен
-- **DEFAULT**: Дополнительные проверки качества
-- **COMMENTS**: Обязательные комментарии (API, команды)
-- **UNARY_RPC**: Ограничить streaming RPC
-
-### Группировки правил
-
-#### MINIMAL
-- `DIRECTORY_SAME_PACKAGE`
-- `PACKAGE_DEFINED`
-- `PACKAGE_DIRECTORY_MATCH`
-- `PACKAGE_SAME_DIRECTORY`
-
-#### BASIC
-- `ENUM_FIRST_VALUE_ZERO`
-- `ENUM_NO_ALLOW_ALIAS`
-- `ENUM_PASCAL_CASE`
-- `ENUM_VALUE_UPPER_SNAKE_CASE`
-- `FIELD_LOWER_SNAKE_CASE`
-- `IMPORT_NO_PUBLIC`
-- `IMPORT_NO_WEAK`
-- `IMPORT_USED`
-- `MESSAGE_PASCAL_CASE`
-- `ONEOF_LOWER_SNAKE_CASE`
-- `PACKAGE_LOWER_SNAKE_CASE`
-- `PACKAGE_SAME_CSHARP_NAMESPACE`
-- `PACKAGE_SAME_GO_PACKAGE`
-- `PACKAGE_SAME_JAVA_MULTIPLE_FILES`
-- `PACKAGE_SAME_JAVA_PACKAGE`
-- `PACKAGE_SAME_PHP_NAMESPACE`
-- `PACKAGE_SAME_RUBY_PACKAGE`
-- `PACKAGE_SAME_SWIFT_PREFIX`
-- `RPC_PASCAL_CASE`
-- `SERVICE_PASCAL_CASE`
-
-#### DEFAULT
-- `ENUM_VALUE_PREFIX`
-- `ENUM_ZERO_VALUE_SUFFIX`
-- `FILE_LOWER_SNAKE_CASE`
-- `RPC_REQUEST_RESPONSE_UNIQUE`
-- `RPC_REQUEST_STANDARD_NAME`
-- `RPC_RESPONSE_STANDARD_NAME`
-- `PACKAGE_VERSION_SUFFIX`
-- `SERVICE_SUFFIX`
-
-#### COMMENTS
-- `COMMENT_ENUM`
-- `COMMENT_ENUM_VALUE`
-- `COMMENT_FIELD`
-- `COMMENT_MESSAGE`
-- `COMMENT_ONEOF`
-- `COMMENT_RPC`
-- `COMMENT_SERVICE`
-
-#### UNARY_RPC
-- `RPC_NO_CLIENT_STREAMING`
-- `RPC_NO_SERVER_STREAMING`
-
-## Заключение
-
-Внедрение EasyP линдера для ваших proto файлов заметно улучшит workflow, качество и поддерживаемость кода. Полная совместимость с Buf позволяет командам мигрировать без боли, используя гибкую конфигурацию и мощные возможности из коробки.
\ No newline at end of file
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/comment-enum-value.md b/docs/dist/docs/ru-guide/cli/linter/rules/comment-enum-value.md
deleted file mode 100644
index 2fefd116..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/comment-enum-value.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# COMMENT_ENUM_VALUE
-
-Категории:
-
-- **COMMENT**
-
-Это правило проверяет, что все значения enum имеют комментарий.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    BAR = 0;
-    BAZ = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    // BAR value for bar logic // [!code focus]
-    BAR = 0;
-    // BAZ value for baz logic // [!code focus]
-    BAZ = 1;
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/comment-enum.md b/docs/dist/docs/ru-guide/cli/linter/rules/comment-enum.md
deleted file mode 100644
index 5d97f653..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/comment-enum.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# COMMENT_ENUM
-
-Категории:
-
-- **COMMENT**
-
-Это правило проверяет, что enum имеет комментарий.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    BAR = 0;
-    BAZ = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-// Foo enum for bar and baz logic // [!code focus]
-enum Foo {
-    BAR = 0;
-    BAZ = 1;
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/comment-field.md b/docs/dist/docs/ru-guide/cli/linter/rules/comment-field.md
deleted file mode 100644
index 47716e4e..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/comment-field.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# COMMENT_FIELD
-
-Категории:
-
-- **COMMENT**
-
-Это правило проверяет, что все поля сообщений имеют комментарий.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    string bar = 1;
-    string baz = 2;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    // bar field for bar logic // [!code focus]
-    string bar = 1;
-    // baz field for baz logic // [!code focus]
-    string baz = 2;
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/comment-message.md b/docs/dist/docs/ru-guide/cli/linter/rules/comment-message.md
deleted file mode 100644
index 42be0bcc..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/comment-message.md
+++ /dev/null
@@ -1,34 +0,0 @@
-# COMMENT_MESSAGE
-
-Категории:
-
-- **COMMENT**
-
-Это правило проверяет, что message имеет комментарий.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    string bar = 1;
-    string baz = 2;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-// Foo message for bar and baz logic // [!code focus]
-message Foo {
-    // bar field for bar logic 
-    string bar = 1; 
-    // baz field for baz logic
-    string baz = 2; 
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/comment-oneof.md b/docs/dist/docs/ru-guide/cli/linter/rules/comment-oneof.md
deleted file mode 100644
index b214cd00..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/comment-oneof.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# COMMENT_ONEOF
-
-Категории:
-
-- **COMMENT**
-
-Это правило проверяет, что oneof имеет комментарий.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    oneof bar {
-        string baz = 1;
-        string qux = 2;
-    }
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    // bar oneof for baz and qux logic // [!code focus]
-    oneof bar {
-        string baz = 1;
-        string qux = 2;
-    }
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/comment-rpc.md b/docs/dist/docs/ru-guide/cli/linter/rules/comment-rpc.md
deleted file mode 100644
index 24a64bb2..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/comment-rpc.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# COMMENT_RPC
-
-Categories:
-
-- **COMMENT**
-
-This rule checks that rpc has a comment.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (BarResponse) {}
-    rpc Baz (BazRequest) returns (BazResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    // Bar rpc for bar logic // [!code focus]
-    rpc Bar (BarRequest) returns (BarResponse) {}
-    // Baz rpc for baz logic // [!code focus]
-    rpc Baz (BazRequest) returns (BazResponse) {}
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/comment-service.md b/docs/dist/docs/ru-guide/cli/linter/rules/comment-service.md
deleted file mode 100644
index ee9edfd0..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/comment-service.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# COMMENT_SERVICE
-
-Категории:
-
-- **COMMENT**
-
-Это правило проверяет, что сервис имеет комментарий.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (BarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-// Foo service for bar logic // [!code focus]
-service Foo {
-    // Bar rpc for bar logic 
-    rpc Bar (BarRequest) returns (BarResponse) {}
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/directory-same-package.md b/docs/dist/docs/ru-guide/cli/linter/rules/directory-same-package.md
deleted file mode 100644
index 06a40e12..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/directory-same-package.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# DIRECTORY_SAME_PACKAGE
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы в заданной директории находятся в одном и том же package.
-
-## Примеры
-
-### Bad
-
-```proto
-// File: dir/foo.proto
-
-syntax = "proto3";
-   
-package foo;
-
-message Foo {
-    string bar = 1;
-}
-```
-
-### Good
-
-```proto
-// File: dir/foo/foo.proto // [!code focus]
-
-syntax = "proto3";
-
-package dir.foo; // [!code focus]
-
-message Foo {
-    string bar = 1;
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/enum-first-value-zero.md b/docs/dist/docs/ru-guide/cli/linter/rules/enum-first-value-zero.md
deleted file mode 100644
index 21199e3e..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/enum-first-value-zero.md
+++ /dev/null
@@ -1,37 +0,0 @@
-# ENUM_FIRST_VALUE_ZERO
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что первое значение enum равно нулю.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    BAR = 1;
-    BAZ = 2;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    BAR = 0; // [!code focus]
-    BAZ = 1;
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/enum-no-allow-alias.md b/docs/dist/docs/ru-guide/cli/linter/rules/enum-no-allow-alias.md
deleted file mode 100644
index 9b9c75a6..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/enum-no-allow-alias.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# ENUM_NO_ALLOW_ALIAS
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что опция `allow_alias` не установлена в значение `true` внутри enum.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    option allow_alias = true; // [!code focus]
-    BAR = 0;
-    BAZ = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    BAR = 0;
-    BAZ = 1;
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/enum-pascal-case.md b/docs/dist/docs/ru-guide/cli/linter/rules/enum-pascal-case.md
deleted file mode 100644
index 8da8d881..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/enum-pascal-case.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# ENUM_PASCAL_CASE
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что имена enum написаны в стиле PascalCase.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum foo_bar {
-    BAR = 0;
-    BAZ = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum FooBar { // [!code focus]
-    BAR = 0;
-    BAZ = 1;
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/enum-value-prefix.md b/docs/dist/docs/ru-guide/cli/linter/rules/enum-value-prefix.md
deleted file mode 100644
index 6f9e6866..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/enum-value-prefix.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# ENUM_VALUE_PREFIX
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все значения enum имеют префикс, совпадающий с именем enum.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    BAR = 0;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    FOO_BAR = 0; // [!code focus]
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/enum-value-upper-snake-case.md b/docs/dist/docs/ru-guide/cli/linter/rules/enum-value-upper-snake-case.md
deleted file mode 100644
index ec8fe3e5..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/enum-value-upper-snake-case.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# ENUM_VALUE_UPPER_SNAKE_CASE
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что значения enum записаны в стиле UPPER_SNAKE_CASE.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    barName = 0;
-    bazName = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    BAR_NAME = 0; // [!code focus]
-    BAZ_NAME = 1; // [!code focus]
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/enum-zero-value-suffix.md b/docs/dist/docs/ru-guide/cli/linter/rules/enum-zero-value-suffix.md
deleted file mode 100644
index 31d417c6..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/enum-zero-value-suffix.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# ENUM_ZERO_VALUE_SUFFIX
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все нулевые значения enum имеют суффикс `_NONE` или ваш кастомный (пользовательский) суффикс.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    BAR = 0;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    FOO_BAR_NONE = 0; // [!code focus]
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/field-lower-snake-case.md b/docs/dist/docs/ru-guide/cli/linter/rules/field-lower-snake-case.md
deleted file mode 100644
index 6abc42a5..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/field-lower-snake-case.md
+++ /dev/null
@@ -1,35 +0,0 @@
-# FIELD_LOWER_SNAKE_CASE
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что имена полей сообщений записаны в стиле lower_snake_case.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    string BarName = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    string bar_name = 1; // [!code focus]
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/file-lower-snake-case.md b/docs/dist/docs/ru-guide/cli/linter/rules/file-lower-snake-case.md
deleted file mode 100644
index 94d7f60e..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/file-lower-snake-case.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# FILE_LOWER_SNAKE_CASE
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы имеют имя в формате lower_snake_case (только строчные буквы, цифры и символ подчеркивания, без пробелов и заглавных букв).
-
-## Examples
-
-### Bad
-
-```proto
-// File: bar/FooBaz.proto
-
-syntax = "proto3";
-```
-
-### Good
-
-```proto
-// File: bar/foo_baz.proto // [!code focus]
-
-syntax = "proto3";
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/import-no-public.md b/docs/dist/docs/ru-guide/cli/linter/rules/import-no-public.md
deleted file mode 100644
index a5a7c499..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/import-no-public.md
+++ /dev/null
@@ -1,30 +0,0 @@
-# IMPORT_NO_PUBLIC
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что в proto-файле не используются `public` импорты (оператор `import public "..."`).
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-import public "bar.proto";
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-import "bar.proto"; // [!code focus]
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/import-no-weak.md b/docs/dist/docs/ru-guide/cli/linter/rules/import-no-weak.md
deleted file mode 100644
index 036d3d2d..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/import-no-weak.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# IMPORT_NO_WEAK
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что в proto‑файле не используются weak‑импорты (`import weak "..."`).
-
-Weak import (синтаксис `import weak`) допустим в proto2, но его использование усложняет анализ зависимостей и может приводить к неочевидным ошибкам при генерации кода. Рекомендуется всегда использовать обычный `import`.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto2";
-
-package foo;
-
-import weak "bar.proto";
-```
-
-### Good
-
-```proto
-syntax = "proto2";
-
-package foo;
-
-import "bar.proto"; // [!code focus]
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/import-used.md b/docs/dist/docs/ru-guide/cli/linter/rules/import-used.md
deleted file mode 100644
index f289a36c..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/import-used.md
+++ /dev/null
@@ -1,34 +0,0 @@
-# IMPORT_USED
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все импорты используются в proto-файле.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-import "bar.proto";
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-import "bar.proto"; // [!code focus]
-
-message Foo {
-    bar.Bar bar = 1; // [!code focus]
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/message-pascal-case.md b/docs/dist/docs/ru-guide/cli/linter/rules/message-pascal-case.md
deleted file mode 100644
index cc764e9f..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/message-pascal-case.md
+++ /dev/null
@@ -1,34 +0,0 @@
-# MESSAGE_PASCAL_CASE
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что имена сообщений (message) записаны в стиле PascalCase.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message foo_bar {
-    string bar_name = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message FooBar { // [!code focus]
-    string bar_name = 1;
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/oneof-lower-snake-case.md b/docs/dist/docs/ru-guide/cli/linter/rules/oneof-lower-snake-case.md
deleted file mode 100644
index 9256efe4..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/oneof-lower-snake-case.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# ONEOF_LOWER_SNAKE_CASE
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что имена oneof записаны в стиле lower_snake_case.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    oneof BarName {
-        string bar_name = 1;
-    }
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    oneof bar_name { // [!code focus]
-        string bar_name = 1;
-    }
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/package-defined.md b/docs/dist/docs/ru-guide/cli/linter/rules/package-defined.md
deleted file mode 100644
index 3a8109ed..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/package-defined.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# PACKAGE_DEFINED
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что во всех файлах присутствует директива package.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    string bar = 1;
-}
-
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo; // [!code focus]
-
-message Foo {
-    string bar = 1;
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/package-directory-match.md b/docs/dist/docs/ru-guide/cli/linter/rules/package-directory-match.md
deleted file mode 100644
index efd04dd6..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/package-directory-match.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# PACKAGE_DIRECTORY_MATCH
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы находятся в директории, имя которой соответствует имени их пакета.
-
-## Examples
-
-### Bad
-
-```proto
-// File: bar/foo.proto
-
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    string bar = 1;
-}
-```
-
-### Good
-
-```proto
-// File: bar/foo.proto // [!code focus]
-
-syntax = "proto3";
-
-package bar; // [!code focus]
-
-message Foo {
-    string bar = 1;
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/package-lower-snake-case.md b/docs/dist/docs/ru-guide/cli/linter/rules/package-lower-snake-case.md
deleted file mode 100644
index 237f995b..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/package-lower-snake-case.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# PACKAGE_LOWER_SNAKE_CASE
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что имена package записаны в формате lower_snake_case (строчные буквы, при необходимости цифры и символ подчеркивания, без пробелов и заглавных букв).
-
-## Примеры
-
-### Bad
-
-```proto
-// File: bar/foo.proto
-syntax = "proto3";
-
-package FooBar;
-```
-
-### Good
-
-```proto
-// File: bar/foo.proto
-syntax = "proto3";
-
-package foo_bar; // [!code focus]
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/package-same-csharp-namespace.md b/docs/dist/docs/ru-guide/cli/linter/rules/package-same-csharp-namespace.md
deleted file mode 100644
index 072ee316..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/package-same-csharp-namespace.md
+++ /dev/null
@@ -1,54 +0,0 @@
-# PACKAGE_SAME_CSHARP_NAMESPACE
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы с заданным пакетом используют одно и то же пространство имён C# (`csharp_namespace`).
-
-## Примеры
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option csharp_namespace = "Foo.Bar";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option csharp_namespace = "Foo.Baz";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option csharp_namespace = "Foo.Bar"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option csharp_namespace = "Foo.Bar"; // [!code focus]
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/package-same-directory.md b/docs/dist/docs/ru-guide/cli/linter/rules/package-same-directory.md
deleted file mode 100644
index a5354e2e..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/package-same-directory.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# PACKAGE_SAME_DIRECTORY
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы с данным package находятся в одной директории.
-
-## Examples
-
-### Bad
-
-```proto
-// File: bar/foo.proto
-
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    string bar = 1;
-}
-```
-
-### Good
-
-```proto
-// File: bar/foo.proto // [!code focus]
-
-syntax = "proto3";
-
-package bar; // [!code focus]
-
-message Foo {
-    string bar = 1;
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/package-same-go-package.md b/docs/dist/docs/ru-guide/cli/linter/rules/package-same-go-package.md
deleted file mode 100644
index 3a4012ca..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/package-same-go-package.md
+++ /dev/null
@@ -1,54 +0,0 @@
-# PACKAGE_SAME_GO_PACKAGE
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы с одним и тем же package используют одно и то же значение опции `go_package`.
-
-## Примеры
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option go_package = "example.com/foo/bar";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option go_package = "example.com/foo/baz";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option go_package = "example.com/foo/bar"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option go_package = "example.com/foo/bar"; // [!code focus]
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/package-same-java-multiple-files.md b/docs/dist/docs/ru-guide/cli/linter/rules/package-same-java-multiple-files.md
deleted file mode 100644
index cf070c8f..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/package-same-java-multiple-files.md
+++ /dev/null
@@ -1,54 +0,0 @@
-# PACKAGE_SAME_JAVA_MULTIPLE_FILES
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы с одним и тем же `package` используют одинаковое значение опции `java_package`.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.bar";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo"; // [!code focus]
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/package-same-java-package.md b/docs/dist/docs/ru-guide/cli/linter/rules/package-same-java-package.md
deleted file mode 100644
index cc6fca4b..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/package-same-java-package.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# PACKAGE_SAME_JAVA_PACKAGE
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы с одним и тем же `package` используют одно и то же значение опции `java_package`.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.bar";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo"; // [!code focus]
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/package-same-php-namespace.md b/docs/dist/docs/ru-guide/cli/linter/rules/package-same-php-namespace.md
deleted file mode 100644
index 20a225e3..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/package-same-php-namespace.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# PACKAGE_SAME_PHP_NAMESPACE
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы с одним и тем же `package` используют одно и то же значение опции `php_namespace`.
-
-## Примеры
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option php_namespace = "Foo\\Bar";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option php_namespace = "Foo\\Baz";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option php_namespace = "Foo\\Bar"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option php_namespace = "Foo\\Bar"; // [!code focus]
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/package-same-ruby-package.md b/docs/dist/docs/ru-guide/cli/linter/rules/package-same-ruby-package.md
deleted file mode 100644
index eb2cfce4..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/package-same-ruby-package.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# PACKAGE_SAME_RUBY_PACKAGE
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same Ruby package.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option ruby_package = "Foo";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option ruby_package = "Bar";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option ruby_package = "Foo"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option ruby_package = "Foo"; // [!code focus]
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/package-same-swift-prefix.md b/docs/dist/docs/ru-guide/cli/linter/rules/package-same-swift-prefix.md
deleted file mode 100644
index f99f5989..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/package-same-swift-prefix.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# PACKAGE_SAME_SWIFT_PREFIX
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы с одним и тем же package используют один и тот же `swift_prefix`.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option swift_prefix = "Foo";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option swift_prefix = "Bar";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option swift_prefix = "Foo"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option swift_prefix = "Foo"; // [!code focus]
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/package-version-suffix.md b/docs/dist/docs/ru-guide/cli/linter/rules/package-version-suffix.md
deleted file mode 100644
index 5f1df064..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/package-version-suffix.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# PACKAGE_VERSION_SUFFIX
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что суффикс версии пакета имеет формат `_vX`, где `X` — числовая версия.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo.v1; // [!code focus]
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/rpc-no-client-streaming.md b/docs/dist/docs/ru-guide/cli/linter/rules/rpc-no-client-streaming.md
deleted file mode 100644
index b3b7edfd..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/rpc-no-client-streaming.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# RPC_NO_CLIENT_STREAMING
-
-Категории:
-
-- **UNARY_RPC**
-
-Это правило проверяет, что RPC не использует клиентский стриминг (запрос не является `stream ...`).
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (stream BarRequest) returns (BarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus]
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/rpc-no-server-streaming.md b/docs/dist/docs/ru-guide/cli/linter/rules/rpc-no-server-streaming.md
deleted file mode 100644
index 17c3bea6..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/rpc-no-server-streaming.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# RPC_NO_SERVER_STREAMING
-
-Категории:
-
-- **UNARY_RPC**
-
-Это правило проверяет, что RPC не использует серверный стриминг (ответ не является `stream ...`).
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (stream BarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus]
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/rpc-pascal-case.md b/docs/dist/docs/ru-guide/cli/linter/rules/rpc-pascal-case.md
deleted file mode 100644
index a0ec51a8..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/rpc-pascal-case.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# RPC_PASCAL_CASE
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все имена RPC написаны в стиле PascalCase.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service foo_bar {
-    rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service FooBar {
-    rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} // [!code focus]
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/rpc-request-response-unique.md b/docs/dist/docs/ru-guide/cli/linter/rules/rpc-request-response-unique.md
deleted file mode 100644
index 37114dfa..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/rpc-request-response-unique.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# RPC_REQUEST_RESPONSE_UNIQUE
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все сообщения запроса и ответа RPC уникальны: для каждого метода используются собственные (не переиспользуются одинаковые пары `Request` / `Response` у разных RPC).
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (FooRequest) returns (FooResponse) {}
-    rpc GetBar (FooRequest) returns (FooResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (FooRequest) returns (FooResponse) {} // [!code focus]
-    rpc GetBar (BarRequest) returns (BarResponse) {} // [!code focus]
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/rpc-request-standard-name.md b/docs/dist/docs/ru-guide/cli/linter/rules/rpc-request-standard-name.md
deleted file mode 100644
index 4eddeb72..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/rpc-request-standard-name.md
+++ /dev/null
@@ -1,30 +0,0 @@
-# RPC_REQUEST_STANDARD_NAME
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все сообщения запроса RPC названы в формате `MethodRequest`.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (FooRequest) returns (FooResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (GetFooRequest) returns (FooResponse) {} // [!code focus]
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/rpc-response-standard-name.md b/docs/dist/docs/ru-guide/cli/linter/rules/rpc-response-standard-name.md
deleted file mode 100644
index d339f3aa..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/rpc-response-standard-name.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# RPC_RESPONSE_STANDARD_NAME
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все сообщения ответа RPC названы в формате `MethodResponse`.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (GetFooRequest) returns (Foo) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (GetFooRequest) returns (GetFooResponse) {} // [!code focus]
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/service-pascal-case.md b/docs/dist/docs/ru-guide/cli/linter/rules/service-pascal-case.md
deleted file mode 100644
index 73344ecc..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/service-pascal-case.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# SERVICE_PASCAL_CASE
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все имена сервисов написаны в стиле PascalCase.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service foo_bar {
-    rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service FooBar { // [!code focus]
-    rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} 
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/linter/rules/service-suffix.md b/docs/dist/docs/ru-guide/cli/linter/rules/service-suffix.md
deleted file mode 100644
index 4a248642..00000000
--- a/docs/dist/docs/ru-guide/cli/linter/rules/service-suffix.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# SERVICE_SUFFIX
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все сервисы имеют суффикс `Service` или ваш пользовательский суффикс.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar(BarRequest) returns (BarResponse);
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service FooService { // [!code focus]
-    rpc Bar(BarRequest) returns (BarResponse); 
-}
-```
diff --git a/docs/dist/docs/ru-guide/cli/package-manager/easyp-vs-buf.md b/docs/dist/docs/ru-guide/cli/package-manager/easyp-vs-buf.md
deleted file mode 100644
index 93f5d8ed..00000000
--- a/docs/dist/docs/ru-guide/cli/package-manager/easyp-vs-buf.md
+++ /dev/null
@@ -1,428 +0,0 @@
-# EasyP против Buf: управление пакетами
-
-[[toc]]
-
-Этот документ даёт подробное сравнение децентрализованного подхода EasyP к управлению пакетами и централизованной модели Buf через Buf Schema Registry (BSR), чтобы помочь понять ключевые различия и выбрать подходящее решение для ваших задач.
-
-## Сравнение архитектуры
-
-### EasyP: децентрализованный подход на базе Git
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                     Архитектура EasyP                           │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│  Машина разработчика           Git репозитории                  │
-│  ┌──────────────┐           ┌─────────────────┐                │
-│  │              │  clone/   │ github.com/     │                │
-│  │ ~/.easyp/    │◄─────────►│ googleapis/     │                │
-│  │ cache/       │  fetch    │ googleapis      │                │
-│  │              │           │                 │                │
-│  │ mod/         │           ├─────────────────┤                │
-│  │              │           │ company.com/    │                │
-│  └──────────────┘           │ internal-protos │                │
-│                              │                 │                │
-│                              ├─────────────────┤                │
-│                              │ gitlab.com/     │                │
-│                              │ team/shared     │                │
-│                              └─────────────────┘                │
-│                                                                 │
-│  ✅ Прямой доступ к репозиториям                                │
-│  ✅ Нет единой точки отказа                                     │
-│  ✅ Работает с любым Git хостингом                              │
-│  ✅ Полный контроль над зависимостями                          │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-### Buf: централизованный реестр (BSR)
-
-```
-┌────────────────────────────────────────────────────────────────┐
-│                      Архитектура Buf                           │
-├────────────────────────────────────────────────────────────────┤
-│                                                                │
-│  Машина разработчика               Buf Schema Registry (BSR)   │
-│  ┌──────────────┐              ┌─────────────────────────────┐ │
-│  │              │   push/pull  │                             │ │
-│  │ ~/.cache/    │◄────────────►│  buf.build                  │ │
-│  │ bufcli/      │   modules    │                             │ │
-│  │              │              │ ┌─────────────────────────┐ │ │
-│  │              │              │ │ googleapis/googleapis   │ │ │
-│  │              │              │ ├─────────────────────────┤ │ │
-│  │              │              │ │ grpc/grpc               │ │ │
-│  │              │              │ ├─────────────────────────┤ │ │
-│  │              │              │ │ envoyproxy/protoc-gen-  │ │ │
-│  │              │              │ │ validate                │ │ │
-│  └──────────────┘              │ └─────────────────────────┘ │ │
-│                                │                             │ │
-│                                └─────────────────────────────┘ │
-│                                                                │
-│  ⚠️ Централизованная зависимость                               │
-│  ⚠️ Единая точка контроля                                      │
-│  ⚠️ Требуется доступ к buf.build                               │
-│  ⚠️ Ограничение экосистемой BSR                                │
-│                                                                │
-└────────────────────────────────────────────────────────────────┘
-```
-
-## Краткое резюме различий
-
-| Аспект | EasyP | Buf |
-|--------|-------|-----|
-| **Архитектура** | Децентрализованная (Git) | Централизованная (реестр BSR) |
-| **Источник зависимостей** | Любой Git репозиторий | Только модули BSR |
-| **Единая точка отказа** | Нет | Да (buf.build) |
-| **Enterprise / air‑gapped** | Полная поддержка | Требует доступа к BSR или приватного BSR |
-| **Аутентификация** | Git (SSH / HTTPS) | Токены Buf + Git |
-| **Vendor lock‑in** | Отсутствует | Привязка к экосистеме Buf |
-| **Частные репозитории** | Нативно через Git | Нужно опубликовать в BSR |
-| **Оффлайн поддержка** | Полная (через vendoring) | Ограничена (кэшированные модули) |
-| **Стоимость** | Бесплатно (использует существующий Git) | Бесплатный тариф + платные планы |
-| **Сложность настройки** | Минимальная | Средняя (настройка BSR) |
-
-## Подробное сравнение возможностей
-
-### 1. Философия управления зависимостями
-
-#### EasyP: «Любой Git репозиторий — это пакет»
-```yaml
-# Прямые ссылки на Git репозитории
-deps:
-  - github.com/googleapis/googleapis@v1.2.3
-  - gitlab.company.com/protos/internal@v2.0.1
-  - git.example.com/team/shared-types@main
-```
-
-**Преимущества:**
-- ✅ Использование любого существующего репозитория сразу
-- ✅ Не нужно «публиковать» в отдельный реестр
-- ✅ Истинный источник версий — Git
-- ✅ Работает с приватными серверами без доп. настроек
-
-#### Buf: «Сначала реестр»
-```yaml
-# buf.yaml — ссылки только на модули BSR
-version: v1
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/grpc/grpc
-  - buf.build/envoyproxy/protoc-gen-validate
-```
-
-**Преимущества:**
-- ✅ Курируемые, проверенные модули
-- ✅ Богатые метаданные и документация
-- ✅ Визуализация графа зависимостей
-- ✅ Принуждение семантического версионирования
-
-**Ограничения:**
-- ❌ Нужно опубликовать в BSR перед использованием
-- ❌ Требует аккаунт и аутентификацию
-- ❌ Нельзя напрямую сослаться на произвольный Git репозиторий
-
-### 2. Корпоративные и изолированные (air‑gapped) среды
-
-#### EasyP: Полноценная оффлайн‑поддержка
-
-**Сценарий**: крупная компания со строгими сетевыми политиками
-
-```bash
-# 1. Среда с доступом в интернет
-easyp mod download          # Скачивает в ~/.easyp/
-easyp mod vendor            # Создает easyp_vendor/
-
-# 2. Перенос в изолированный сегмент
-tar -czf easyp-deps.tar.gz ~/.easyp easyp_vendor/
-# ... перенос архива ...
-
-# 3. В изолированной среде
-tar -xzf easyp-deps.tar.gz
-export EASYPPATH=$PWD/.easyp
-easyp generate              # Работает оффлайн
-```
-
-**Плюсы:**
-- ✅ Не зависит от внешних сервисов
-- ✅ Не нужен внутренний реестр
-- ✅ Использует существующую Git инфраструктуру
-- ✅ Простая файловая дистрибуция
-
-#### Buf: Требует инфраструктуру реестра
-
-```bash
-# Вариант 1: использовать buf.build (нужен интернет)
-buf mod download
-
-# Вариант 2: поднимать приватный BSR (сложно)
-# - Развернуть сервер реестра
-# - Перепубликовать все модули внутрь
-# - Настроить доступы, аутентификацию
-# - Поддерживать работоспособность
-```
-
-**Минусы:**
-- ❌ Постоянный интернет или дорогой приватный BSR
-- ❌ Сложная инфраструктура для частных установок
-- ❌ Все модули нужно републиковать
-- ❌ Дополнительные операционные затраты
-
-### 3. Безопасность и контроль
-
-#### EasyP: Прямой контроль
-```yaml
-# Полный контроль источников
-deps:
-  # Публичный репозиторий — ваша конкретная версия
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-
-  # Внутренний репозиторий
-  - gitlab.company.com/security/validated-protos@v1.0.0
-
-  # Точный коммит (горячий фикс)
-  - github.com/bufbuild/protoc-gen-validate@abc123def456
-```
-
-**Преимущества по безопасности:**
-- ✅ Нет посредника — берём из исходного репозитория
-- ✅ Аудит через историю Git
-- ✅ Нельзя «забанить» доступ извне
-- ✅ Свои процессы сканирования / валидации
-- ✅ Можно форкнуть и удерживать критические версии
-
-#### Buf: Зависимость от реестра
-```yaml
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/grpc/grpc
-```
-
-**Риски:**
-- ⚠️ Посредник контролирует доступность
-- ⚠️ Возможны ограничения / санкции на аккаунт
-- ⚠️ Модуль могут удалить или депрекейтнуть
-- ⚠️ Политики обновлений диктуются стороной
-- ⚠️ Нужно доверять внешней безопасности
-
-### 4. Реальные сценарии
-
-#### Сценарий 1: Стартап с публичными зависимостями
-
-**EasyP:**
-```yaml
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-```
-
-**Buf:**
-```yaml
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/grpcecosystem/grpc-gateway
-```
-
-**Итог:** Паритет — оба хорошо подходят для публичных пакетов.
-
-#### Сценарий 2: Компания со смешанными публичными/приватными зависимостями
-
-**EasyP:**
-```yaml
-deps:
-  - github.com/googleapis/googleapis@v1.2.3
-  - github.com/mycompany/auth-protos@v2.0.0
-  - gitlab.enterprise.com/platform/shared-types@v1.5.1
-```
-
-**Buf:**
-```yaml
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/mycompany/auth-protos
-  - buf.build/mycompany/shared-types
-```
-
-**Итог:** **EasyP** — не требует публикации внутрь BSR.
-
-#### Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap)
-
-**EasyP:**
-```bash
-easyp mod vendor
-# Архив → перенос → распаковка → generate (без сети)
-```
-
-**Buf:**
-```bash
-# Нужен приватный BSR с поддержкой полного оффлайна
-# Сложный цикл публикации и обслуживания
-```
-
-**Итог:** **EasyP** — значительно проще.
-
-#### Сценарий 4: Комплаенс и аудит
-
-**EasyP:**
-- ✅ Прямой аудит изменений (коммиты)
-- ✅ Нет внешних точек зависимости в проде
-- ✅ Повторяемость через фиксированные коммиты / vendor
-- ✅ Управление уязвимостями — в ваших руках
-
-**Buf:**
-- ⚠️ Нужно учитывать BSR в области аудита
-- ⚠️ Дополнительный риск третьей стороны
-- ⚠️ Модули — внешние контролируемые артефакты
-- ⚠️ Сложнее трассировать от реестра к исходникам
-
-**Итог:** **EasyP** — проще для комплаенса.
-
-### 5. Стоимость и инфраструктура
-
-#### EasyP: Нулевая дополнительная инфраструктура
-
-**Затраты:**
-- ✅ $0 — используете существующий Git
-- ✅ Нет дополнительных сервисов/серверов
-- ✅ Нет лицензирования
-- ✅ Масштабирование в рамках Git
-
-**Инфраструктура:**
-- Использует текущие репозитории (GitHub/GitLab/и т.д.)
-- Аутентификация — штатная
-- Резервирование/DR — как уже настроено для Git
-
-#### Buf: Затраты на реестр
-
-**Hosted BSR (buf.build):**
-- ✅ Бесплатный уровень
-- ❌ Платные тарифы для приватного и расширенного использования
-- ❌ Потенциальные изменения ценовой политики
-- ❌ Вопросы локализации данных
-
-**Приватный BSR:**
-- ❌ Серверы, БД, балансировка
-- ❌ Мониторинг, обновления, бэкапы
-- ❌ Лицензирование enterprise функционала
-- ❌ Доп. планирование отказоустойчивости
-
-### 6. Миграция и lock‑in
-
-#### EasyP: Нет привязки
-
-**Миграция ИЗ EasyP:**
-```yaml
-deps:
-  - github.com/googleapis/googleapis@v1.2.3
-```
-(Обычные Git ссылки — легко перенести в другой инструмент.)
-
-**Миграция В EasyP:**
-```bash
-# Просто указываете те же Git репозитории
-```
-
-#### Buf: Потенциальный lock‑in
-
-**Миграция ИЗ Buf:**
-- ❌ Нужно сопоставить BSR модули с исходными Git репо
-- ❌ Имена модулей BSR не совпадают с URL
-- ❌ Возможна потеря удобных метаданных
-- ❌ Сложно при глубокой интеграции с BSR
-
-**Миграция В Buf:**
-- ❌ Нужно опубликовать всё в BSR
-- ❌ Нельзя ссылаться напрямую на Git
-- ❌ Принять workflow BSR (push/pull модулей)
-
-## Когда выбирать каждое решение
-
-### Выберите EasyP, если:
-
-✅ **Air‑gapped / закрытые среды**
-- Нужна работа без внешних сервисов
-- Строгий комплаенс / контроль цепочки поставок
-
-✅ **Фокус на безопасности**
-- Контроль источников зависимостей
-- Минимизация рисков третьих сторон
-
-✅ **Git‑центричная культура**
-- Частные репозитории — норма
-- Не хотите добавлять новый ключевой сервис
-
-✅ **Ограниченный бюджет**
-- Минимизация операционных расходов
-- Предсказуемая стоимость = 0
-
-✅ **Смешанные публичные/частные зависимости**
-- Не хотите перекладывать всё в реестр
-- Нужна гибкость форматов и размещения
-
-### Выберите Buf, если:
-
-✅ **Глубокая интеграция в экосистему BSR**
-- Уже используете линтеры / генерацию Buf
-- Нужны курируемые официальные модули
-- Важны метаданные и граф зависимостей
-
-✅ **Сотрудничество и открытая разработка**
-- Централизованное обнаружение модулей
-- Совместная работа над общими пакетами
-
-✅ **Команда новичков в protobuf**
-- Требуется «направляющая» структура
-- Ценность документации внутри реестра
-
-✅ **Небольшой набор публичных зависимостей**
-- В основном используете популярные общие пакеты
-- Вас устраивает зависимость от BSR
-
-## Пути миграции
-
-### Переход с Buf на EasyP
-
-1. Найдите исходные Git репозитории для каждого модуля BSR  
-2. Сопоставьте имена BSR → Git ссылки (с версиями/тегами)  
-3. Обновите конфигурацию (`easyp.yaml`)  
-4. Протестируйте генерацию и совместимость  
-
-```yaml
-# Было (buf.yaml)
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/grpc/grpc
-
-# Стало (easyp.yaml)
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/grpc/grpc@v1.50.0
-```
-
-### Переход с EasyP на Buf
-
-1. Опубликуйте используемые репозитории как модули BSR  
-2. Настройте аутентификацию / организацию Buf  
-3. Замените Git ссылки на BSR модули  
-4. Перейдите к push/pull workflow Buf  
-
-## Заключение
-
-Оба инструмента решают задачу управления зависимостями protobuf, но подходят под разные приоритеты:
-
-**Сильные стороны EasyP:**
-- Корпоративные / изолированные среды
-- Жёсткие требования безопасности и аудита
-- Минимальные затраты и отсутствие доп. инфраструктуры
-- Прямое использование Git (без промежуточного слоя)
-- Простота масштабирования
-
-**Сильные стороны Buf:**
-- Богатая экосистема вокруг реестра
-- Курируемые и документированные модули
-- Удобство для новых команд в protobuf
-- Средства визуализации и централизованного обмена
-
-Выбор часто сводится к балансу между **контролем vs. удобством**, **безопасностью vs. централизованными функциями**, и **стоимостью vs. managed‑сервисом**.
-
-Для большинства enterprise‑окружений децентрализованный Git‑подход EasyP обеспечивает нужные гибкость, безопасность и предсказуемость расходов, тогда как Buf отлично подходит командам, которым важна централизованная коллаборация и богатая экосистема вокруг реестра.
diff --git a/docs/dist/docs/ru-guide/cli/package-manager/package-manager.md b/docs/dist/docs/ru-guide/cli/package-manager/package-manager.md
deleted file mode 100644
index 98567fad..00000000
--- a/docs/dist/docs/ru-guide/cli/package-manager/package-manager.md
+++ /dev/null
@@ -1,458 +0,0 @@
-# Менеджер пакетов
-
-[[toc]]
-
-EasyP предоставляет мощный менеджер пакетов для protobuf‑зависимостей, упрощающий их управление за счёт децентрализованного подхода на базе Git. В отличие от централизованных решений, EasyP работает напрямую с Git‑репозиториями, давая вам полный контроль.
-
-## Обзор
-
-Менеджер пакетов EasyP следует философии **Go modules** — любой Git‑репозиторий может быть источником. Это даёт преимущества:
-
-- **Децентрализация** — нет единой точки отказа или контроля
-- **Безопасность** — прямой доступ к исходникам
-- **Гибкость** — публичные, приватные и корпоративные репозитории
-- **Воспроизводимость** — lock‑файлы обеспечивают одинаковые сборки
-- **Производительность** — локальный кеш сокращает сетевые запросы
-
-### Основные возможности
-
-| Возможность | Описание |
-|-------------|----------|
-| **Git-Native** | Любой Git репозиторий, не нужен спец‑сервер |
-| **Множество форматов версий** | Теги, коммиты, псевдо‑версии, latest |
-| **Lock Files** | Воспроизводимые сборки через `easyp.lock` |
-| **Локальный кеш** | Архитектура как у Go modules |
-| **Vendoring** | Локальное копирование для оффлайн сборок |
-| **YAML конфигурация** | Простые и читаемые декларации |
-
-## Архитектура
-
-EasyP использует двухуровневый кеш, вдохновлённый Go modules:
-
-```
-~/.easyp/
-├── cache/
-│   ├── download/              # Архивы + контрольные суммы
-│   │   └── github.com/
-│   │       └── googleapis/
-│   │           └── googleapis/
-│   │               ├── v1.2.3.zip       # Архив
-│   │               ├── v1.2.3.ziphash   # Checksum
-│   │               └── v1.2.3.info      # Метаданные
-│   └── {git-hash}/            # Bare репозитории Git (внутренне)
-└── mod/                       # Распакованные готовые модули
-    └── github.com/
-        └── googleapis/
-            └── googleapis/
-                ├── v1.2.3/           # Тегированная версия
-                │   ├── google/
-                │   │   ├── api/
-                │   │   └── rpc/
-                │   └── ...
-                └── v0.0.0-20250101123456-abc123def/  # Псевдо‑версия
-                    ├── google/
-                    └── ...
-```
-
-### Расположение кеша
-
-| Окружение | Путь | Как задать |
-|-----------|------|-----------|
-| **По умолчанию** | `$HOME/.easyp` | Автоматически |
-| **Свое** | Любая директория | Переменная `EASYPPATH` |
-| **CI/CD** | В каталоге проекта | `export EASYPPATH=$CI_PROJECT_DIR/.easyp` |
-
-## Конфигурация
-
-### Базовая конфигурация
-
-Зависимости описываются в `easyp.yaml`:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-  - github.com/bufbuild/protoc-gen-validate
-```
-
-### Расширенные примеры
-
-#### Multi-Environment Setup
-```yaml
-# development.easyp.yaml
-deps:
-  - github.com/googleapis/googleapis              # Последнее для разработки
-  - github.com/mycompany/internal-protos          # Внутренние изменения
-  - github.com/bufbuild/protoc-gen-validate       # Новые фичи
-
-# production.easyp.yaml
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1       # Зафиксировано
-  - github.com/mycompany/internal-protos@v2.1.0                # Стабильно
-  - github.com/bufbuild/protoc-gen-validate@v0.10.1            # Проверено
-```
-
-#### Приватные репозитории
-```yaml
-deps:
-  # Публичное
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-
-  # Частные
-  - github.com/mycompany/auth-protos@v1.5.0
-  - github.com/mycompany/common-types@v2.0.1
-
-  # Внутренний GitLab
-  - gitlab.company.com/platform/messaging-protos@v0.3.0
-```
-
-## Стратегии версионирования
-
-Поддерживаются разные способы фиксации версий:
-
-### 1. Семантические теги (для продакшена)
-
-```yaml
-deps:
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-```
-
-**Используйте когда:**
-- Продакшен
-- Стабильное потребление API
-- Нужна воспроизводимость
-
-### 2. Последний тег (development)
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/bufbuild/protoc-gen-validate
-```
-
-**Подходит для:**
-- Активной разработки
-- Получения свежих возможностей
-- Тестирования совместимости
-
-### 3. Хеш коммита (Bleeding Edge)
-
-```yaml
-deps:
-  - github.com/bufbuild/protoc-gen-validate@abc123def456789abcdef123456789abcdef1234
-```
-
-**Когда нужно:**
-- Нерелизные фичи
-- Тест конкретного фикса
-- Вклад в upstream
-
-### 4. Псевдо‑версии (автоматически)
-
-Если нет подходящего тега — создаётся псевдо‑версия:
-
-```
-Формат: v0.0.0-{timestamp}-{short-commit-hash}
-Пример: v0.0.0-20250908104020-660ec2d64e07f2fa8947527443af058b3d7169df
-```
-
-## Команды
-
-### `easyp mod download`
-
-Скачивает и устанавливает все объявленные зависимости.
-
-**Что делает:**
-1. Разрешает версии (теги → коммиты)
-2. Скачивает архивы в `cache/download`
-3. Проверяет контрольные суммы
-4. Распаковывает в `cache/mod`
-5. Обновляет `easyp.lock`
-
-**Пример:**
-```bash
-easyp mod download
-easyp --cfg production.easyp.yaml mod download
-EASYPPATH=/tmp/easyp-cache easyp mod download
-```
-
-### `easyp mod vendor`
-
-Копирует все proto зависимости в локальный `easyp_vendor/` для оффлайна.
-
-**Сценарии:**
-- Docker сборки
-- Air-gapped окружения
-- Воспроизводимость
-- Ускорение
-
-```bash
-easyp mod vendor
-```
-
-Структура:
-```
-easyp_vendor/
-├── github.com/
-│   ├── googleapis/
-│   │   └── googleapis/
-│   │       ├── google/
-│   │       │   ├── api/
-│   │       │   │   ├── annotations.proto
-│   │       │   │   └── http.proto
-│   │       │   └── rpc/
-│   │       │       └── status.proto
-│   │       └── ...
-│   └── grpc-ecosystem/
-│       └── grpc-gateway/
-│           └── protoc-gen-openapiv2/
-│               └── options/
-│                   └── annotations.proto
-```
-
-### `easyp mod update`
-
-Обновляет версии согласно `easyp.yaml`, пересоздаёт lock.
-
-```bash
-easyp mod update
-```
-
-## Lock файл
-
-`easyp.lock` фиксирует точные версии и хеш содержимого:
-
-```
-github.com/bufbuild/protoc-gen-validate v0.0.0-20250908104020-660ec2d64e07f2fa8947527443af058b3d7169df h1:ZZ5JyUkmrj9OBHM+gOCzeL5L/pAKVbsUl051yhhJTjU=
-github.com/googleapis/googleapis v0.0.0-20250909114430-8727b5ba7f23fbbfddda58239e8bc6b547e05878 h1:eI+XYpPio3fxl9H5/VjW2PxlxM/7yqPjEq3oQ6jUkj4=
-github.com/grpc-ecosystem/grpc-gateway v2.19.1 h1:01NNlCezvwUQ07ZvblXH0kelWq8hNl2qb44bOMcaSTQ=
-```
-
-**Формат строки:**
-- Путь модуля
-- Версия (тег или псевдо)
-- Хеш содержимого (`h1:`)
-
-**Практики:**
-✅ Коммитить `easyp.lock`  
-✅ Осознанно обновлять `mod update`  
-✅ Ревью изменений версий  
-❌ Не редактировать вручную  
-
-## Аутентификация
-
-### Публичные репозитории
-
-Работают без настроек:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/bufbuild/protoc-gen-validate
-```
-
-### Приватные репозитории
-
-#### SSH ключи (рекомендуется)
-
-```bash
-git config --global url."git@github.com:".insteadOf "https://github.com/"
-git config --global url."git@gitlab.com:".insteadOf "https://gitlab.com/"
-git config --global url."git@gitlab.company.com:".insteadOf "https://gitlab.company.com/"
-```
-
-Конфиг остаётся с HTTPS URL:
-
-```yaml
-deps:
-  - github.com/mycompany/private-protos@v1.0.0
-  - gitlab.company.com/platform/shared-types@v2.1.0
-```
-
-#### Personal Access Tokens
-
-```bash
-git config --global credential.helper store
-echo "https://username:token@github.com" >> ~/.git-credentials
-
-git config --global url."https://username:token@github.com/mycompany".insteadOf "https://github.com/mycompany"
-```
-
-#### Корпоративная среда
-
-```bash
-git config --global http.proxy http://proxy.company.com:8080
-git config --global https.proxy https://proxy.company.com:8080
-git config --global http.sslCAInfo /path/to/certificate.pem
-```
-
-## Типовые workflows
-
-### Инициализация проекта
-
-```bash
-cat > easyp.yaml << EOF
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-EOF
-
-easyp mod download
-ls ~/.easyp/mod/github.com/googleapis/googleapis/
-```
-
-### Добавление зависимости
-
-```bash
-echo "  - github.com/bufbuild/protoc-gen-validate@v0.10.1" >> easyp.yaml
-easyp mod download
-git add easyp.lock
-git commit -m "Add protoc-gen-validate dependency"
-```
-
-### Обновление
-
-```bash
-easyp mod update
-git diff easyp.lock
-easyp generate
-easyp lint
-git add easyp.lock
-git commit -m "Update dependencies"
-```
-
-### Оффлайн режим
-
-```bash
-easyp mod vendor
-easyp generate
-```
-
-## Troubleshooting
-
-### Частые проблемы
-
-#### "Repository not found" / "Authentication failed"
-
-```bash
-git ls-remote https://github.com/mycompany/private-repo
-git config --list | grep url
-```
-
-#### "Version not found"
-
-```bash
-git ls-remote --tags https://github.com/googleapis/googleapis
-# Проверить корректный тег
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-```
-
-#### "Cache corruption" / "Checksum mismatch"
-
-```bash
-rm -rf ~/.easyp
-rm -rf ~/.easyp/cache/download
-easyp mod download
-```
-
-#### Тайм-ауты сети
-
-```bash
-git config --global http.lowSpeedLimit 1000
-git config --global http.lowSpeedTime 300
-git config --global http.proxy http://proxy.company.com:8080
-```
-
-### Оптимизация
-
-#### Для больших команд
-
-```bash
-export EASYPPATH=/shared/easyp-cache
-export EASYPPATH=/team-cache/easyp
-```
-
-#### Для CI/CD
-
-```bash
-export EASYPPATH=$CI_PROJECT_DIR/.easyp
-# Пример кеширования (GitLab CI)
-cache:
-  key: easyp-$CI_COMMIT_REF_SLUG
-  paths:
-    - .easyp/
-```
-
-#### Управление размером кеша
-
-```bash
-du -sh ~/.easyp
-du -sh ~/.easyp/cache/download
-du -sh ~/.easyp/mod
-find ~/.easyp/mod -type d -name "v0.0.0-*" -mtime +30 -exec rm -rf {} \;
-```
-
-## Примеры интеграции
-
-### Docker multi-stage
-
-```dockerfile
-FROM ghcr.io/easyp-tech/easyp:latest AS deps
-WORKDIR /workspace
-COPY easyp.yaml easyp.lock ./
-RUN easyp mod vendor
-
-FROM alpine:latest AS build
-WORKDIR /app
-COPY --from=deps /workspace/easyp_vendor ./easyp_vendor
-COPY . .
-RUN easyp generate
-```
-
-### Monorepo
-
-```
-my-monorepo/
-├── services/
-│   ├── auth-service/
-│   │   └── easyp.yaml
-│   └── user-service/
-│       └── easyp.yaml
-├── shared/
-│   └── common-protos/
-└── easyp.yaml
-```
-
-Каждый `easyp.yaml` может иметь свой набор зависимостей.
-
-## Лучшие практики
-
-### Workflow разработки
-- ✅ Latest теги в активной разработке
-- ✅ Фиксация версий в продакшене
-- ✅ Коммит lock файла
-- ✅ Ревью обновлений
-- ✅ Тест после обновления
-
-### Безопасность
-- ✅ Фиксируйте версии
-- ✅ Используйте SSH ключи
-- ✅ Оценивайте новые зависимости
-- ✅ Следите за уязвимостями
-- ❌ Не храните секреты в конфиге
-
-### Производительность
-- ✅ Агрессивное кеширование в CI
-- ✅ Vendoring для частых сборок
-- ✅ Чистка старого кеша
-- ✅ Общий кеш для команды
-
-### Командная работа
-- ✅ Документация по аутентификации
-- ✅ Единые инструменты
-- ✅ Автоматизация обновлений с тестами
-- ✅ Общий кеш при возможности
-
-Менеджер пакетов EasyP — масштабируемое децентрализованное решение от одиночных проектов до enterprise, сохраняя простоту и надёжность.
diff --git a/docs/dist/docs/ru-guide/introduction/install.md b/docs/dist/docs/ru-guide/introduction/install.md
deleted file mode 100644
index 56a40499..00000000
--- a/docs/dist/docs/ru-guide/introduction/install.md
+++ /dev/null
@@ -1,50 +0,0 @@
-# Установка EasyP CLI
-
-### Установка через менеджер пакетов системы
-
-##### Рекомендуемый способ установки
-
-#### Homebrew
-
-Можно установить бинарный релиз в macOS через Homebrew:
-
-```bash
-brew install easyp-tech/tap/easyp
-```
-
-`Work in progress` — поддержка других менеджеров (apt, yum, pacman и т.д.) в процессе.
-
-## Локальная установка
-
-#### _**Не рекомендуется**_
-
-Локальная установка менее предпочтительна, потому что пакетные менеджеры обеспечивают:
-- Автоматические обновления и патчи безопасности
-- Лучшую интеграцию с системой
-- Упрощённую установку и удаление
-- Подписанные и проверенные бинарники
-
-#### Требуется Go 1.24 или новее
-
-### Установка через go install
-
-Команда установит последнюю стабильную версию easyp:
-
-```bash
-go install github.com/easyp-tech/easyp/cmd/easyp@latest
-```
-
-### Сборка из исходников
-
-1. Клонирование репозитория
-
-```bash
-git clone https://github.com/easyp-tech/easyp.git
-```
-
-2. Сборка с помощью Go
-
-```bash
-go build ./cmd/easyp
-```
-
diff --git a/docs/dist/docs/ru-guide/introduction/quickstart.md b/docs/dist/docs/ru-guide/introduction/quickstart.md
deleted file mode 100644
index a223a450..00000000
--- a/docs/dist/docs/ru-guide/introduction/quickstart.md
+++ /dev/null
@@ -1,159 +0,0 @@
-# Быстрый старт (Quickstart)
-
-EasyP — современный toolkit для работы с файлами Protobuf. В этом кратком руководстве вы научитесь:
-
-1. **Инициализировать** проект с конфигурацией EasyP
-2. **Настраивать линтинг**, чтобы ловить ошибки и соблюдать лучшие практики
-3. **Управлять зависимостями** из Git‑репозиториев
-4. **Генерировать код** из ваших Protobuf файлов
-
-## Предварительные требования
-
-Перед началом убедитесь, что у вас установлены:
-
-- **EasyP CLI** — см. [руководство по установке](/docs/guide/introduction/install)
-- **Git** доступен в вашем `$PATH`
-- **Файлы `.proto`** (или создайте их по ходу)
-
-Проверить версию EasyP:
-
-```bash
-easyp --version
-```
-
-## Инициализация проекта
-
-Создайте базовый файл конфигурации `easyp.yaml` в корне проекта:
-
-```bash
-easyp init
-```
-
-Команда генерирует шаблон `easyp.yaml` с комментариями, дефолтными lint-правилами и настройками breaking-check.
-`easyp init` работает интерактивно: если в корне есть `buf.yml`/`buf.yaml`, EasyP предложит миграцию; если `easyp.yaml` уже существует, попросит подтверждение перед перезаписью.
-
-## Настройка линтинга
-
-Линтинг помогает находить проблемы и поддерживать единый стиль. EasyP использует правила, совместимые с Buf.
-
-Секция `lint` уже создаётся командой `easyp init`. При необходимости отредактируйте её, например так:
-
-```yaml
-lint:
-  use:
-    - DEFAULT
-```
-
-Запустите линтер:
-
-```bash
-easyp lint
-```
-
-Линтер проверит все `.proto` файлы и сообщит о найденных проблемах.
-
-::: tip
-Правила линтинга EasyP на 100% совместимы с Buf — мигрировать просто.
-:::
-
-## Управление зависимостями
-
-Если вы используете сторонние protobuf пакеты (например Google APIs или gRPC Gateway), EasyP упрощает их подключение.
-
-### Формат зависимости
-
-Запись: `$GIT_LINK@$VERSION`
-
-- **`$GIT_LINK`** — URL любого Git‑репозитория (GitHub, GitLab и т.д.)
-- **`$VERSION`** — тег или хеш коммита (опционально)
-
-Если версия не указана — берётся последний коммит из основной ветки.
-
-### Добавление зависимостей
-
-Дополните `easyp.yaml`:
-
-```yaml
-lint:
-  use:
-    - DEFAULT
-deps:
-  - github.com/googleapis/googleapis                          # Последний коммит
-  - github.com/grpc-ecosystem/grpc-gateway@v2.20.0           # Конкретная версия
-```
-
-### Загрузка зависимостей
-
-```bash
-easyp mod download
-```
-
-Команда:
-- Скачивает версии из `easyp.lock`, если он существует
-- Иначе — берёт из `easyp.yaml` и создаёт `easyp.lock`
-
-::: info
-Совет: `easyp mod update` — игнорирует lock‑файл и подтягивает актуальные версии из `easyp.yaml`.
-:::
-
-## Генерация кода
-
-EasyP поддерживает все стандартные protoc‑плагины.
-
-### Конфигурация генерации
-
-Добавьте плагины:
-
-```yaml
-lint:
-  use:
-    - DEFAULT
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/grpc-ecosystem/grpc-gateway@v2.20.0
-generate:
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-```
-
-### Запуск генерации
-
-```bash
-easyp generate
-```
-
-EasyP выполнит:
-1. Разрешение всех зависимостей
-2. Подключение к сервису EasyP (или локальный режим)
-3. Запуск указанных плагинов
-4. Вывод сгенерированного кода в нужные директории
-
-::: tip
-Гибридный рантайм: WASM для скорости, Docker — для тяжёлых плагинов.
-:::
-
-## Следующие шаги
-
-Поздравляем! 🎉 Вы успешно:
-- ✅ Инициализировали проект EasyP
-- ✅ Настроили линтинг
-- ✅ Управляете внешними зависимостями
-- ✅ Сгенерировали код из `.proto`
-
-### Узнать больше
-
-- **[CLI Reference](/docs/guide/cli/linter/linter)** — подробности по командам
-- **[API Service](/docs/guide/api-service/overview)** — удалённая генерация
-- **[Configuration](/docs)** — все опции конфигурации
-
----
-
-*Приятной работы с Protobuf — без боли! 🚀*
diff --git a/docs/dist/docs/ru-guide/introduction/what-is.md b/docs/dist/docs/ru-guide/introduction/what-is.md
deleted file mode 100644
index 3985b093..00000000
--- a/docs/dist/docs/ru-guide/introduction/what-is.md
+++ /dev/null
@@ -1,157 +0,0 @@
-# Что такое EasyP?
-
-EasyP — это современный инструментарий для работы с Protocol Buffers, который объединяет весь ваш protobuf‑workflow в один мощный CLI‑инструмент. Он совмещает линтинг, управление пакетами, генерацию кода и проверку совместимости в единой среде и устраняет сложность традиционной работы с protobuf.
-
-<div class="tip custom-block" style="padding-top: 8px">
-Хотите просто попробовать? Перейдите сразу к разделу [Quickstart](./guide/introduction/quickstart).
-</div>
-
-## Проблема: фрагментированные protobuf‑процессы
-
-Работа с Protocol Buffers в разных проектах часто создает лишнюю сложность и трение:
-
-### Хаос инструментов
-- **Много отдельных утилит**: Отдельно для линтинга, генерации и управления зависимостями
-- **Несогласованные конфигурации**: Разные форматы и правила в разных командах
-- **Сложный онбординг**: Новым разработчикам нужно долго вникать
-
-### Проблемы управления зависимостями
-- **Нет стандартизированного подхода**: Каждый проект решает это по‑своему
-- **Конфликты версий**: Трудно сводить разные версии одних и тех же proto‑библиотек
-- **Неповторяемость сборок**: Сложно гарантировать одинаковый результат в разных окружениях
-
-### Трение в разработке
-- **Ручные операции**: Много повторяющихся шагов
-- **Разрастание конфигураций**: Множество файлов и форматов
-- **Затратная проверка совместимости**: Часто вручную и постфактум
-
-## Решение: единый protobuf‑инструментарий
-
-EasyP устраняет эти проблемы, предоставляя целостный opinionated‑подход и стандартизируя процессы:
-
-### Один инструмент — все задачи
-Вместо жонглирования утилитами EasyP даёт:
-- **Linting** с расширенными наборами правил
-- **Package management** с Git‑нативными зависимостями
-- **Code generation** локально и удалённо
-- **Breaking change detection** для контроля совместимости API
-
-### Единая конфигурация
-Один файл `easyp.yaml` описывает весь workflow — меньше расхождений, проще сопровождать.
-
-### Git‑native зависимости
-Прямое использование Git‑репозиториев вместо централизованных реестров: прозрачная история, контроль версий, воспроизводимые сборки.
-
-## Ключевые возможности
-
-| Feature | Description |
-|---------|-------------|
-| 🔍 **Comprehensive Linting** | Полная поддержка правил buf с настраиваемыми профилями для лучших практик API‑дизайна. |
-| 📦 **Smart Package Manager** | Git‑ориентированное управление зависимостями с lock‑файлом для воспроизводимости. |
-| ⚡ **Code Generation** | Многозадачная генерация кода с поддержкой локальных и удалённых protoc‑плагинов. |
-| 🔄 **Breaking Change Detection** | Автоматическая проверка совместимости API против веток Git. |
-| 🌐 **Remote Plugin Support** | Выполнение плагинов через централизованный EasyP API сервис без локальных установок. |
-| 🎯 **Developer Experience** | Автодополнение, понятные ошибки, единая структура и документация. |
-
-## Типы поддерживаемых плагинов
-
-EasyP гибко подходит к выполнению генерации:
-
-### Local Plugins
-Стандартные установленные protoc‑плагины:
-```yaml
-plugins:
-  - name: go
-    out: .
-    opts:
-      paths: source_relative
-```
-
-### Remote Plugins
-Плагины через EasyP API сервис для воспроизводимости:
-```yaml
-plugins:
-  - remote: api.easyp.tech/protoc-gen-typescript:latest
-    out: ./web/generated
-```
-
-### Custom Plugins
-Поддержка экосистемы пользовательских расширений.
-
-## Децентрализованный менеджмент пакетов
-
-В отличие от других решений EasyP не требует централизованного реестра. Любой Git‑репозиторий может быть источником:
-
-- **Гибкость**: Любой Git‑хостинг (GitHub, GitLab, self‑hosted)
-- **Нет vendor lock‑in**: Зависимости не привязаны к одному провайдеру
-- **Полная история**: Ветки, теги, ревью
-- **Enterprise‑совместимость**: Поддержка приватных репозиториев
-
-## Бесшовная миграция с Buf
-
-EasyP изначально совместим с экосистемой buf:
-
-- **Совпадающие rule sets**
-- **Похожая структура YAML**
-- **Минимальные изменения для замены**
-- **Постепенное внедрение** без ломки текущего пайплайна
-
-### EasyP vs buf.build
-
-| Feature | EasyP | buf.build |
-|---------|--------|-----------|
-| **Dependency Management** | Git‑репозитории | Buf Schema Registry (BSR) |
-| **Vendor Lock-in** | Нет | Привязка к BSR для полного функционала |
-| **Plugin Execution** | Local + Remote | Local + BSR plugins |
-| **Private Dependencies** | Любой Git провайдер | BSR или ручное управление |
-| **Offline Development** | Полная поддержка (`mod vendor`) | Ограниченно без доступа к BSR |
-| **Enterprise Integration** | Использует существующий Git | Требует настройку BSR |
-| **Breaking Change Detection** | Против любой Git ссылки | Аналогично |
-| **Package Distribution** | Любой Git | Публикация через BSR |
-| **License** | Apache 2.0 | Apache 2.0 |
-| **Community** | Growing | Established |
-
-**Преимущества миграции:**
-- Без изменения инфраструктуры
-- Плавное принятие новых возможностей
-- Гибрид локальных и удалённых плагинов
-- Единая конфигурация вместо набора файлов
-
-## Наши цели для Protobuf
-
-Миссия EasyP — ускорить принятие **schema‑driven API** через удобный, надёжный и прозрачный инструментарий.
-
-### Современная экосистема
-Повышаем DX вокруг protobuf, чтобы конкурентно выглядеть по простоте против REST/JSON, сохраняя типовую строгость и производительность.
-
-### Developer Experience прежде всего
-Интуитивный CLI, понятные ошибки, ясные сообщения, минимальная фрагментация.
-
-### Готов к Enterprise
-Воспроизводимые сборки, приватные репозитории, интеграция в CI/CD.
-
-## Почему EasyP?
-
-### Для индивидуальных разработчиков
-- Быстрый старт за минуты
-- Один инструмент — меньше когнитивной нагрузки
-- Понятная документация
-
-### Для команд
-- Единые стандарты
-- Повторяемые сборки (lock‑файл)
-- Ускоренный онбординг
-
-### Для организаций
-- Нет vendor lock‑in
-- Безопасность приватных репозиториев
-- Лёгкая интеграция в существующие пайплайны
-
-## Что дальше?
-
-EasyP упрощает работу с protobuf — фокусируйтесь на API, а не на рутине. Хотите начать?
-
-Смотрите [Installation Guide](/docs/guide/introduction/install) и [Quickstart](/docs/guide/introduction/quickstart).
-
-## Stargazers over time
-[![Stargazers over time](https://starchart.cc/easyp-tech/easyp.svg?variant=adaptive)](https://starchart.cc/easyp-tech/easyp)
diff --git a/docs/dist/docs/ru-guide/migration/buf-cli.md b/docs/dist/docs/ru-guide/migration/buf-cli.md
deleted file mode 100644
index 6cd855fd..00000000
--- a/docs/dist/docs/ru-guide/migration/buf-cli.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Buf CLI
-
-## В работе
\ No newline at end of file
diff --git a/docs/dist/docs/ru-guide/migration/protoc.md b/docs/dist/docs/ru-guide/migration/protoc.md
deleted file mode 100644
index 3d65c269..00000000
--- a/docs/dist/docs/ru-guide/migration/protoc.md
+++ /dev/null
@@ -1,248 +0,0 @@
-# Миграция с protoc на EasyP
-
-> Исходная англоязычная версия файла содержала только заголовок и пометку “Work in progress”. Ниже — полноценный русскоязычный черновик раздела миграции. Уточни, если требуется сократить или изменить уровень детализации.
-
-## 1. Краткое сравнение
-
-| Аспект | `protoc` | EasyP |
-|--------|----------|-------|
-| Базовая роль | Базовый компилятор `.proto` файлов | Инструмент “всё в одном”: линтинг, проверка несовместимых изменений, менеджер пакетов, генерация |
-| Конфигурация | Чаще shell‑скрипты / Makefile / вручную передаваемые флаги | Единый файл `easyp.yaml` (YAML или JSON) |
-| Управление зависимостями | Ручной `git clone`, `submodule`, vendoring | Секция `deps` с Git‑репозиториями |
-| Набор правил линтера | Нет встроенного | Встроенный линтер с правилами (можно включать/исключать) |
-| Проверка breaking changes | Отсутствует из коробки | Команда `easyp breaking` |
-| Расширенные плагины | Установка и вызов через флаги `--plugin` | Плагины через конфиг; поддержка удалённого выполнения (API Service) и стандартного локального |
-| Единообразие в CI | Нужно собирать вручную | Консистентные команды: `lint`, `breaking`, `generate` |
-
-## 2. Когда имеет смысл мигрировать
-
-Миграция на EasyP особенно полезна если:
-- Есть потребность в автоматической проверке качества (стиль, именование) `.proto` файлов.
-- Нужна защита от нелегитимных несовместимых изменений при эволюции схем.
-- В проекте используется несколько языков генерации и растёт число скриптов вокруг `protoc`.
-- Вы хотите единый конфиг вместо множества shell/Makefile комбинаций.
-- Планируется централизованное исполнение плагинов (через API Service) или унификация окружения в CI.
-
-## 3. Типичный сценарий “до” (только protoc)
-
-Пример: локальные скрипты / Makefile:
-
-```makefile
-protoc \
-  -I . \
-  -I third_party \
-  --go_out=./gen/go --go_opt=paths=source_relative \
-  --go-grpc_out=./gen/go --go-grpc_opt=paths=source_relative \
-  api/echo/v1/echo.proto
-```
-
-Дополнительные зависимости (googleapis, validate, grpc-gateway) скачиваются вручную или через submodules.
-
-## 4. Типичный сценарий “после” (EasyP)
-
-Единый файл `easyp.yaml`:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/envoyproxy/protoc-gen-validate
-
-generate:
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-    - name: validate
-      out: gen/go
-      opts:
-        paths: source_relative
-        lang: "go"
-```
-
-Команды:
-```bash
-easyp mod update      # Скачивание/обновление deps
-easyp lint            # Линтинг .proto
-easyp breaking --against git-ref=origin/main
-easyp generate        # Генерация кода
-```
-
-## 5. Пошаговая миграция
-
-1. Инвентаризация:
-   - Соберите список всех вызовов `protoc` (скрипты, Makefile, CI).
-   - Зафиксируйте используемые плагины и их версии.
-2. Создание `easyp.yaml`:
-   - Поле `version` не обязательно (можете оставить его только для обратной совместимости).
-   - Перенесите плагины в секцию `generate.plugins`.
-   - Укажите опции, которые ранее передавались в командной строке.
-3. Зависимости:
-   - Все внешние каталоги (googleapis, validate, grpc-gateway и т.п.) занесите в `deps`.
-   - Удалите лишние submodules при необходимости.
-4. Линтер:
-   - Запустите `easyp lint` и посмотрите на предупреждения.
-   - При необходимости добавьте `lint.use`, `lint.ignore`, `lint.except`.
-5. Проверка breaking changes:
-   - Выберите референс (обычно `origin/main` или предыдущий тег).
-   - Запустите `easyp breaking --against git-ref=origin/main`.
-   - Настройте игнорируемые изменения (`breaking.ignore`), если нужно.
-6. Обновление CI:
-   - Замените прямые вызовы `protoc` на `easyp generate`.
-   - Добавьте отдельные шаги `lint` и `breaking`.
-7. Очистка:
-   - Удалите устаревшие генерационные скрипты, если они дублируют функционал EasyP.
-8. Документация:
-   - Обновите README / CONTRIBUTING (новый способ генерации).
-9. Верификация:
-   - Сравните результат генерации до и после (git diff).
-   - Убедитесь, что имена файлов и пути совпадают или скорректируйте структуру.
-
-## 6. Замена в CI (пример GitHub Actions)
-
-```yaml
-- name: Install EasyP
-  run: go install github.com/easyp-tech/easyp/cmd/easyp@latest
-
-- name: Lint
-  run: easyp lint
-
-- name: Breaking
-  run: easyp breaking --against git-ref=origin/main
-
-- name: Generate
-  run: easyp generate
-```
-
-## 7. Работа с плагинами
-
-| Тип | В protoc | В EasyP |
-|-----|----------|---------|
-| Стандартные (`protoc-gen-go`) | Указание через `--go_out` | `plugins: - name: go ...` |
-| gRPC | `--go-grpc_out` | Второй плагин `go-grpc` |
-| Validate | Доп. установка + `--validate_out` | `- name: validate` с opts |
-| gRPC-Gateway / OpenAPI | `--grpc-gateway_out` / `--openapiv2_out` | Плагины `grpc-gateway`, `openapiv2` |
-| Кастомные | Путь к бинарю / `--plugin=protoc-gen-xxx` | `- name: xxx` или удалённый `remote:` (если используется API Service) |
-
-Если вы переходите на удалённое выполнение (API Service), записи в конфиге могут выглядеть так:
-
-```yaml
-generate:
-  plugins:
-    - remote: api.easyp.tech/protobuf/go:v1.36.10
-      out: gen/go
-      opts:
-        paths: source_relative
-```
-
-## 8. Проверка корректности после миграции
-
-1. `git diff` после `easyp generate` — не должно быть неожиданных изменений.
-2. Сравнить размер и содержимое каталога сгенерированных файлов.
-3. Запустить ваш потребляющий код (сборка, тесты).
-4. Проверить, что плагины (validate, grpc-gateway) продолжают вставлять необходимые аннотации / опции.
-5. Линт не должен выдавать критичных ошибок — скорректируйте стиль .proto, если требуется.
-
-## 9. Частые проблемы
-
-| Проблема | Причина | Решение |
-|----------|---------|---------|
-| Плагин не найден | Не установлен или не указан в PATH | Выполнить `go install ...` или добавить в конфиг как remote |
-| Ошибка импорта `.proto` | Отсутствует репозиторий в `deps` | Добавить адрес в секцию `deps` и `easyp mod update` |
-| Несовместимые изменения на каждом PR | Отсутствует игнор/настройка сравнения | Уточнить ветку/тег в `--against` или настроить `breaking.ignore` |
-| Локально работает, в CI падает | В CI нет зависимостей (не вызван update) | Добавить шаг `easyp mod update` перед `generate` |
-| Дубликаты сгенерированных файлов | Изменена структура путей или `out` | Синхронизировать `out` и `paths: source_relative` опции |
-
-## 10. Минимальный пример конфигурации (только Go)
-
-```yaml
-generate:
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-```
-
-Команды:
-```bash
-easyp generate
-```
-
-## 11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)
-
-```yaml
-lint:
-  use:
-    - ENUM_FIRST_VALUE_ZERO
-    - SERVICE_SUFFIX
-  allow_comment_ignores: false
-  enum_zero_value_suffix: _NONE
-  service_suffix: Service
-
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/envoyproxy/protoc-gen-validate
-
-generate:
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-    - name: validate
-      out: gen/go
-      opts:
-        paths: source_relative
-        lang: "go"
-    - name: grpc-gateway
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: openapiv2
-      out: gen/openapi
-      opts:
-        simple_operation_ids: true
-
-breaking:
-  against_git_ref: main
-  ignore:
-    - ENUM_VALUE_SAME_NAME
-```
-
-## 12. Checklist миграции
-
-- [ ] Собраны все текущие вызовы `protoc`.
-- [ ] Создан `easyp.yaml` с секциями `generate` и (опционально) `lint`, `breaking`.
-- [ ] Добавлены все внешние зависимости в `deps`.
-- [ ] Успешно выполнен `easyp mod update`.
-- [ ] `easyp generate` даёт идентичный или ожидаемо обновлённый результат.
-- [ ] `easyp lint` проходит без критичных ошибок (или ошибки обработаны).
-- [ ] `easyp breaking --against git-ref=origin/main` не выдаёт неожиданных блокирующих нарушений.
-- [ ] CI обновлён (заменены прямые вызовы `protoc`).
-- [ ] Документация проекта обновлена (README: как генерировать).
-
-## 13. Дополнительные рекомендации
-
-- Сначала мигрируйте один сервис / пакет — снизит риск массовых конфликтов.
-- Закоммитьте `easyp.yaml` отдельно, затем выполните генерацию и линт — проще ревью.
-- Если нужны разные наборы плагинов для разных микросервисов — используйте несколько конфигов (например: `easyp.microservice-a.yaml` + `easyp.microservice-b.yaml`).
-- Внедрите проверку актуальности генерации: шаг CI, который валидирует отсутствие diff после `easyp generate`.
-
-## 14. Статус
-
-Этот файл — русская расширенная версия, заменяющая placeholder “Work in progress”. При появлении новых возможностей EasyP (дополнительные поля в конфиге, новые плагины, расширения breaking‑проверок) обновите соответствующие разделы.
-
----
-
-Если нужен упрощённый вариант (только перевод без расширения), сообщи — могу сократить до минимальных двух блоков.
diff --git a/docs/dist/docs/ru-guide/migration/protolock.md b/docs/dist/docs/ru-guide/migration/protolock.md
deleted file mode 100644
index 9907d004..00000000
--- a/docs/dist/docs/ru-guide/migration/protolock.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Protolock
-
-## В процессе разработки
\ No newline at end of file
diff --git a/docs/dist/docs/ru-guide/migration/prototool.md b/docs/dist/docs/ru-guide/migration/prototool.md
deleted file mode 100644
index 28082a85..00000000
--- a/docs/dist/docs/ru-guide/migration/prototool.md
+++ /dev/null
@@ -1,238 +0,0 @@
-# Prototool
-
-## Состояние
-Этот раздел был помечен как “Work in progress” в оригинальной английской версии. Ниже — переведённое и дополненное практическое руководство по миграции с Prototool на EasyP. Имя инструмента Prototool не переводится.
-
----
-
-## Цель миграции
-Перейти от конфигурации и рабочих процессов Prototool к эквиваленту на EasyP с минимальными изменениями, сохранив:
-- Линтинг .proto файлов.
-- Генерацию кода через protoc-плагины.
-- Управление зависимостями.
-- Проверку несовместимых изменений (в Prototool это приходилось реализовывать внешними инструментами; в EasyP встроено).
-
----
-
-## Кратко о различиях
-
-| Область | Prototool | EasyP | Комментарий |
-|---------|-----------|-------|-------------|
-| Конфигурация | `prototool.yaml` | `easyp.yaml` | Форматы YAML/JSON поддерживаются; структура отличается. |
-| Линтинг | Встроенные наборы + кастомные правила | Наборы через `lint.use`, тонкая настройка ignore/except | EasyP даёт больше гибкости группировки. |
-| Генерация | Раздел `generate` + плагины через Docker/локально | `generate.plugins` (локальные/WASM/удалённые) | EasyP может выполнять плагины удалённо (API Service). |
-| Зависимости | Обычно через include-пути / внешние git clone вручную | Секция `deps` (Git репозитории) + `mod update` | Более декларативно. |
-| Breaking Changes | Нет встроенного механизма | Секция `breaking` + команда `easyp breaking` | Из коробки. |
-| Lock-in | Зависимость от модели Prototool | Минималистичный формат, «любой Git — пакет» | Облегчает выход / интеграцию с другими экосистемами. |
-
----
-
-## Типовая структура Prototool (упрощённо)
-
-```yaml
-# prototool.yaml (пример)
-protoc:
-  include_paths:
-    - api
-    - third_party
-lint:
-  group: basic
-  rules:
-    add:
-      - ENUM_VALUE_PREFIX
-generate:
-  plugins:
-    - name: go
-      out: gen/go
-    - name: go-grpc
-      out: gen/go
-```
-
-Особенности:
-- `include_paths` задаёт пути поиска импортов.
-- `lint.group` + `rules.add/remove` регулируют активные проверки.
-- `generate.plugins` описывает плагины для protoc.
-
----
-
-## Эквивалент на EasyP
-
-```yaml
-# easyp.yaml (пример)
-deps:
-  - github.com/org/common-protos         # вместо manual include
-  - github.com/org/third-party-protos
-
-lint:
-  use:
-    - MINIMAL
-    - BASIC
-  enum_zero_value_suffix: "_NONE"
-  service_suffix: "Service"
-  ignore:
-    - COMMENT_FIELD
-  except:
-    - ENUM_VALUE_PREFIX
-  allow_comment_ignores: true
-
-generate:
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-
-breaking:
-  against_git_ref: main
-  ignore:
-    - FIELD_SAME_TYPE
-```
-
-Комментарии:
-- `deps` заменяет необходимость вручную прописывать include paths: EasyP подтянет их через git.
-- `lint.use` активирует наборы правил (MINIMAL/BASIC/DEFAULT и т.д.).
-- Дополнительные настройки (`enum_zero_value_suffix`, `service_suffix`) задают политики нейминга.
-- `breaking` позволяет сразу контролировать несовместимые изменения.
-
----
-
-## Шаги миграции
-
-1. Инвентаризация:
-   - Соберите текущий `prototool.yaml`, списки include paths и плагины.
-   - Зафиксируйте используемые кастомные правила, если есть.
-
-2. Зависимости:
-   - Любые каталоги, которые вы вручную добавляли в `include_paths`, преобразуйте в git-репозитории (если ещё нет).
-   - Добавьте их в `deps` (формат: `github.com/owner/repo` или путь к вашей приватной системе Git).
-
-3. Линтинг:
-   - Определите какой group использовался (`basic`, `default`, …) → сопоставьте с наборами EasyP (`MINIMAL`, `BASIC`, `DEFAULT`).
-   - Индивидуальные добавления (`rules.add`) перенесите в `lint.use` или `except`/`ignore`:
-     - Если правило нужно активировать — включите через набор или явно.
-     - Если нужно отключить — добавьте в `ignore`.
-
-4. Генерация:
-   - Сохраните список плагинов. В большинстве случаев имена совпадут (`go`, `go-grpc`, др.).
-   - Если раньше использовали Docker-окружение Prototool — проверьте поддержку удалённых плагинов через API Service EasyP (опционально).
-   - Перепишите в секцию `generate.plugins`.
-
-5. Дополнительные опции:
-   - Настройки нейминга enum/service перенести в `enum_zero_value_suffix`, `service_suffix`.
-   - Если были внешние скрипты для проверки breaking changes — удалите их и включите `breaking` с `against_git_ref`.
-
-6. Верификация:
-   - Запустите: `easyp mod update` (скачивание deps).
-   - Затем: `easyp lint`.
-   - Далее: `easyp generate`.
-   - И, если нужно: `easyp breaking --against git-ref=origin/main`.
-
-7. CI/CD:
-   - Обновите workflow (GitHub Actions / GitLab) — замените вызовы Prototool на EasyP команды.
-   - Добавьте шаг проверки несовместимых изменений.
-
----
-
-## Сопоставление правил (общая идея)
-
-| Prototool концепт | EasyP |
-|-------------------|------|
-| lint.group        | lint.use (наборы) |
-| rules.add/remove  | except / ignore |
-| include_paths     | deps (git источники) |
-| plugins           | generate.plugins |
-| (внешние скрипты для breaking) | breaking секция + команда |
-
----
-
-## Приватные репозитории
-
-Если ранее Prototool просто видел локальные каталоги, теперь:
-- Добавьте SSH ключи/токены в CI для доступа к приватным Git.
-- Укажите их в `deps` как обычные git-URL (формат зависит от реализации EasyP; для публичных — стандартный).
-
----
-
-## Типовые проблемы при миграции
-
-| Проблема | Причина | Решение |
-|----------|---------|---------|
-| Правила линтера не совпадают | Неверное сопоставление групп | Проверить документацию EasyP по наборам правил |
-| Импорты не находятся | Забыли добавить репозиторий в deps | Добавить в `deps` и выполнить `easyp mod update` |
-| Генерация падает на опциях | Плагин требует другие flags | Проверить `opts` и документацию плагина |
-| breaking сообщает слишком много | Слишком строгий базовый набор | Добавить конкретные правила в `breaking.ignore` |
-| Долгая генерация | Нет кеша/много deps | Включить кэширование в CI (vendor/.easyp/deps) |
-
----
-
-## Минимальная конфигурация после миграции
-
-```yaml
-lint:
-  use:
-    - MINIMAL
-generate:
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-breaking:
-  against_git_ref: main
-```
-
----
-
-## Рекомендации по упрощению
-
-- Начните с минимального `lint.use` (MINIMAL), затем постепенно включайте дополнительные наборы.
-- Не переносите слепо все ignore — часть правил может уже быть улучшена в EasyP.
-- Сначала настроить deps и генерацию, затем усложнять линт/нейминг.
-- Фиксируйте миграцию по шагам (коммиты: deps → lint → generate → breaking → CI).
-
----
-
-## Проверка результата
-
-Скрипт локальной быстрой проверки (пример):
-
-```bash
-#!/usr/bin/env bash
-set -euo pipefail
-
-echo "[1] deps update"
-easyp mod update
-
-echo "[2] lint"
-easyp lint
-
-echo "[3] breaking vs main"
-easyp breaking --against git-ref=origin/main || echo "Breaking changes detected (review needed)"
-
-echo "[4] generate"
-easyp generate
-
-echo "Done."
-```
-
----
-
-## Заключение
-
-Миграция с Prototool на EasyP сводится к:
-1. Переносу путей и внешних каталогов в декларативные `deps`.
-2. Переформатированию линта под `lint.use` + `ignore/except`.
-3. Переносу генерации в `generate.plugins`.
-4. Добавлению встроенного механизма `breaking`.
-5. Адаптации CI.
-
-После этого конфигурация становится более прозрачной, а проверка несовместимых изменений — из коробки.
-
----
-
-*Готово: базовый перевод и расширенное руководство по миграции с Prototool на EasyP.*
\ No newline at end of file
diff --git a/docs/dist/favicon-16.png b/docs/dist/favicon-16.png
deleted file mode 100644
index ea5395c6..00000000
Binary files a/docs/dist/favicon-16.png and /dev/null differ
diff --git a/docs/dist/favicon-16.svg b/docs/dist/favicon-16.svg
deleted file mode 100644
index 714459df..00000000
--- a/docs/dist/favicon-16.svg
+++ /dev/null
@@ -1,20 +0,0 @@
-<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <defs>
-    <linearGradient id="favicon16Gradient" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#60a5fa"/>
-      <stop offset="100%" style="stop-color:#3b82f6"/>
-    </linearGradient>
-  </defs>
-
-  <!-- Background -->
-  <rect width="16" height="16" rx="3" fill="#1e293b"/>
-
-  <!-- Letter E -->
-  <path d="M2 3h5v1.5h-2.5v1.5h2v1.5h-2v1.5H7V13H2V3z" fill="url(#favicon16Gradient)"/>
-
-  <!-- Letter P -->
-  <path d="M8.5 3h3c.8 0 1.5.7 1.5 1.5v1c0 .8-.7 1.5-1.5 1.5h-1.5V13h-1V3zm1 1.5v1.5h1.5c.3 0 .5-.2.5-.5v-.5c0-.3-.2-.5-.5-.5h-1.5z" fill="url(#favicon16Gradient)"/>
-
-  <!-- Accent dot -->
-  <circle cx="13" cy="3" r="1" fill="#60a5fa" opacity="0.9"/>
-</svg>
diff --git a/docs/dist/favicon-32.png b/docs/dist/favicon-32.png
deleted file mode 100644
index 54b6368c..00000000
Binary files a/docs/dist/favicon-32.png and /dev/null differ
diff --git a/docs/dist/favicon-512.png b/docs/dist/favicon-512.png
deleted file mode 100644
index 24ff37cc..00000000
Binary files a/docs/dist/favicon-512.png and /dev/null differ
diff --git a/docs/dist/favicon.icns b/docs/dist/favicon.icns
deleted file mode 100644
index 125fb672..00000000
Binary files a/docs/dist/favicon.icns and /dev/null differ
diff --git a/docs/dist/favicon.ico b/docs/dist/favicon.ico
deleted file mode 100644
index 54b6368c..00000000
Binary files a/docs/dist/favicon.ico and /dev/null differ
diff --git a/docs/dist/favicon.svg b/docs/dist/favicon.svg
deleted file mode 100644
index fe3a1ed4..00000000
--- a/docs/dist/favicon.svg
+++ /dev/null
@@ -1,21 +0,0 @@
-<svg width="32" height="32" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <defs>
-    <linearGradient id="faviconGradient" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#60a5fa"/>
-      <stop offset="100%" style="stop-color:#3b82f6"/>
-    </linearGradient>
-  </defs>
-
-  <!-- Background -->
-  <rect width="32" height="32" rx="6" fill="#1e293b"/>
-  <rect width="32" height="32" rx="6" fill="url(#faviconGradient)" opacity="0.15"/>
-
-  <!-- Letter E -->
-  <path d="M8 9h8v3h-5v3h4v3h-4v3h5v3H8V9z" fill="url(#faviconGradient)"/>
-
-  <!-- Letter P -->
-  <path d="M17 9h6c1.5 0 3 1 3 3v1c0 2-1.5 3-3 3h-3v5h-3V9zm3 4h2c.5 0 1-.5 1-1s-.5-1-1-1h-2v2z" fill="url(#faviconGradient)"/>
-
-  <!-- Accent dot -->
-  <circle cx="27" cy="5" r="2" fill="#60a5fa" opacity="0.8"/>
-</svg>
diff --git a/docs/dist/icon-192.png b/docs/dist/icon-192.png
deleted file mode 100644
index f6750e43..00000000
Binary files a/docs/dist/icon-192.png and /dev/null differ
diff --git a/docs/dist/icon-512.png b/docs/dist/icon-512.png
deleted file mode 100644
index 24ff37cc..00000000
Binary files a/docs/dist/icon-512.png and /dev/null differ
diff --git a/docs/dist/index.html b/docs/dist/index.html
deleted file mode 100644
index a96cb489..00000000
--- a/docs/dist/index.html
+++ /dev/null
@@ -1,45 +0,0 @@
-<!DOCTYPE html>
-<html lang="ru" class="dark">
-
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>EasyP | Modern Protobuf Toolkit</title>
-
-    <!-- Favicon -->
-    <link rel="icon" type="image/png" sizes="32x32" href="/favicon-32.png">
-    <link rel="icon" type="image/png" sizes="16x16" href="/favicon-16.png">
-    <link rel="icon" type="image/x-icon" href="/favicon.ico">
-    <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
-    <link rel="manifest" href="/site.webmanifest">
-    <meta name="theme-color" content="#3b82f6">
-
-    <!-- Meta tags -->
-    <meta name="description" content="EasyP - Modern Protobuf Toolkit для разработки и управления API">
-    <meta name="keywords" content="protobuf, grpc, api, toolkit, easyp, protocol buffers">
-    <meta name="author" content="EasyP Team">
-
-    <!-- Open Graph -->
-    <meta property="og:type" content="website">
-    <meta property="og:title" content="EasyP | Modern Protobuf Toolkit">
-    <meta property="og:description" content="Современный инструментарий для работы с Protocol Buffers и gRPC API">
-    <meta property="og:image" content="/apple-touch-icon.png">
-
-    <!-- Twitter -->
-    <meta name="twitter:card" content="summary">
-    <meta name="twitter:title" content="EasyP | Modern Protobuf Toolkit">
-    <meta name="twitter:description" content="Современный инструментарий для работы с Protocol Buffers и gRPC API">
-
-    <!-- Fonts -->
-    <link
-        href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap"
-        rel="stylesheet">
-  <script type="module" crossorigin src="/assets/index-BxX29htg.js"></script>
-  <link rel="stylesheet" crossorigin href="/assets/index-CT4W-tqO.css">
-</head>
-
-<body>
-    <div id="root"></div>
-</body>
-
-</html>
\ No newline at end of file
diff --git a/docs/dist/search/index.en.json b/docs/dist/search/index.en.json
deleted file mode 100644
index 932f583a..00000000
--- a/docs/dist/search/index.en.json
+++ /dev/null
@@ -1 +0,0 @@
-[{"id":"api-service/overview::top::0","title":"API Service Overview","path":"/docs/guide/api-service/overview","headings":[],"excerpt":"**Centralized protobuf plugin execution service for consistent, isolated code generation**","content":"**Centralized protobuf plugin execution service for consistent, isolated code generation**"},{"id":"api-service/overview::top::1","title":"API Service Overview","path":"/docs/guide/api-service/overview","headings":[],"excerpt":"The EasyP API Service eliminates plugin management chaos by providing centralized execution of protobuf/gRPC plugins as isolated Docker containers. It offers a unified platform for teams to standardize their code generat","content":"The EasyP API Service eliminates plugin management chaos by providing centralized execution of protobuf/gRPC plugins as isolated Docker containers. It offers a unified platform for teams to standardize their code generation workflows without the operational overhead of managing plugins across individual developer machines."},{"id":"api-service/overview::the-challenge::2","title":"API Service Overview","section":"The Challenge","path":"/docs/guide/api-service/overview#the-challenge","headings":["The Challenge"],"excerpt":"The Challenge Managing protobuf/gRPC code generation across development teams creates significant operational complexity:","content":"The Challenge Managing protobuf/gRPC code generation across development teams creates significant operational complexity:"},{"id":"api-service/overview::version-inconsistencies::3","title":"API Service Overview","section":"Version Inconsistencies","path":"/docs/guide/api-service/overview#version-inconsistencies","headings":["Version Inconsistencies"],"excerpt":"Version Inconsistencies Developers use different plugin versions locally, causing build failures and inconsistent generated code \"Works on my machine\" syndrome when generated code differs between environments Manual coor","content":"Version Inconsistencies Developers use different plugin versions locally, causing build failures and inconsistent generated code \"Works on my machine\" syndrome when generated code differs between environments Manual coordination required to keep entire teams synchronized on plugin versions"},{"id":"api-service/overview::operational-overhead::4","title":"API Service Overview","section":"Operational Overhead","path":"/docs/guide/api-service/overview#operational-overhead","headings":["Operational Overhead"],"excerpt":"Operational Overhead DevOps teams spend significant time managing plugin installations across developer machines Each new team member requires manual setup of correct plugin versions Plugin updates require coordinating w","content":"Operational Overhead DevOps teams spend significant time managing plugin installations across developer machines Each new team member requires manual setup of correct plugin versions Plugin updates require coordinating with every developer individually No centralized control over which plugin versions are approved for use"},{"id":"api-service/overview::security-compliance-risks::5","title":"API Service Overview","section":"Security & Compliance Risks","path":"/docs/guide/api-service/overview#security-compliance-risks","headings":["Security & Compliance Risks"],"excerpt":"Security & Compliance Risks Developers install plugins from various sources without security validation No audit trail of which plugins were used for which builds Difficult to enforce security policies on code generation","content":"Security & Compliance Risks Developers install plugins from various sources without security validation No audit trail of which plugins were used for which builds Difficult to enforce security policies on code generation tools"},{"id":"api-service/overview::the-solution-centralized-plugin-execution::6","title":"API Service Overview","section":"The Solution: Centralized Plugin Execution","path":"/docs/guide/api-service/overview#the-solution-centralized-plugin-execution","headings":["The Solution: Centralized Plugin Execution"],"excerpt":"The Solution: Centralized Plugin Execution EasyP API Service eliminates these operational headaches by centralizing plugin management:","content":"The Solution: Centralized Plugin Execution EasyP API Service eliminates these operational headaches by centralizing plugin management:"},{"id":"api-service/overview::the-solution-centralized-plugin-execution::7","title":"API Service Overview","section":"The Solution: Centralized Plugin Execution","path":"/docs/guide/api-service/overview#the-solution-centralized-plugin-execution","headings":["The Solution: Centralized Plugin Execution"],"excerpt":"The Solution: Centralized Plugin Execution Challenge Solution ----------- ---------- **Version Control** Deploy new plugin versions to entire team instantly via Docker images **Operations** Operations team controls plugi","content":"The Solution: Centralized Plugin Execution Challenge Solution ----------- ---------- **Version Control** Deploy new plugin versions to entire team instantly via Docker images **Operations** Operations team controls plugin configurations without touching developer machines **Security** All plugins run in isolated Docker containers with resource constraints **Consistency** Consistent execution environment regardless of developer's local setup **Developer Experience** No local plugin installation or maintenance required"},{"id":"api-service/overview::architecture-overview::8","title":"API Service Overview","section":"Architecture Overview","path":"/docs/guide/api-service/overview#architecture-overview","headings":["Architecture Overview"],"excerpt":"Architecture Overview The EasyP API Service uses a streamlined architecture focused on reliable plugin execution:","content":"Architecture Overview The EasyP API Service uses a streamlined architecture focused on reliable plugin execution:"},{"id":"api-service/overview::api-layer::9","title":"API Service Overview","section":"API Layer","path":"/docs/guide/api-service/overview#api-layer","headings":["API Layer"],"excerpt":"API Layer **gRPC Server**: Primary API for code generation requests Each plugin execution is a separate gRPC request Receives CodeGeneratorRequest from CLI","content":"API Layer **gRPC Server**: Primary API for code generation requests Each plugin execution is a separate gRPC request Receives CodeGeneratorRequest from CLI"},{"id":"api-service/overview::execution-engine::10","title":"API Service Overview","section":"Execution Engine","path":"/docs/guide/api-service/overview#execution-engine","headings":["Execution Engine"],"excerpt":"Execution Engine **Docker Runtime**: Isolated container execution for plugins Pulls plugin images from public Docker registries (Docker Hub, etc.) Enforces resource limits (CPU, memory) per plugin","content":"Execution Engine **Docker Runtime**: Isolated container execution for plugins Pulls plugin images from public Docker registries (Docker Hub, etc.) Enforces resource limits (CPU, memory) per plugin"},{"id":"api-service/overview::storage-layer::11","title":"API Service Overview","section":"Storage Layer","path":"/docs/guide/api-service/overview#storage-layer","headings":["Storage Layer"],"excerpt":"Storage Layer **PostgreSQL**: Stores plugin execution parameters - Resource limits (CPU, memory allocation) - Plugin configuration and metadata - Execution logs for auditing - _Note: Storage capabilities will be expanded","content":"Storage Layer **PostgreSQL**: Stores plugin execution parameters - Resource limits (CPU, memory allocation) - Plugin configuration and metadata - Execution logs for auditing - _Note: Storage capabilities will be expanded in future releases_"},{"id":"api-service/overview::monitoring::12","title":"API Service Overview","section":"Monitoring","path":"/docs/guide/api-service/overview#monitoring","headings":["Monitoring"],"excerpt":"Monitoring **Prometheus**: Metrics collection and monitoring Tracks execution times, success rates, and resource usage","content":"Monitoring **Prometheus**: Metrics collection and monitoring Tracks execution times, success rates, and resource usage"},{"id":"api-service/overview::local-execution-easyp-cli::13","title":"API Service Overview","section":"Local Execution (EasyP CLI)","path":"/docs/guide/api-service/overview#local-execution-easyp-cli","headings":["Local Execution (EasyP CLI)"],"excerpt":"Local Execution (EasyP CLI) When running locally, the EasyP CLI supports: **Installed plugins**: System-installed protoc plugins **WASM plugins**: Fast, lightweight WebAssembly plugins","content":"Local Execution (EasyP CLI) When running locally, the EasyP CLI supports: **Installed plugins**: System-installed protoc plugins **WASM plugins**: Fast, lightweight WebAssembly plugins"},{"id":"api-service/overview::remote-execution-api-service::14","title":"API Service Overview","section":"Remote Execution (API Service)","path":"/docs/guide/api-service/overview#remote-execution-api-service","headings":["Remote Execution (API Service)"],"excerpt":"Remote Execution (API Service) When using the API Service: **Docker only**: All plugins run as Docker containers **Centralized control**: Operations team manages available plugins **Consistent environment**: Same executi","content":"Remote Execution (API Service) When using the API Service: **Docker only**: All plugins run as Docker containers **Centralized control**: Operations team manages available plugins **Consistent environment**: Same execution environment for all developers"},{"id":"api-service/overview::execution-steps::15","title":"API Service Overview","section":"Execution Steps","path":"/docs/guide/api-service/overview#execution-steps","headings":["Execution Steps"],"excerpt":"Execution Steps **CLI Parsing**: CLI parses protobuf files locally **Request Sending**: CLI sends CodeGeneratorRequest to API Service (one request per plugin) **Parameter Lookup**: API Service fetches plugin execution pa","content":"Execution Steps **CLI Parsing**: CLI parses protobuf files locally **Request Sending**: CLI sends CodeGeneratorRequest to API Service (one request per plugin) **Parameter Lookup**: API Service fetches plugin execution parameters from PostgreSQL **Docker Execution**: API Service runs plugin in isolated Docker container **Metrics Recording**: Execution metrics are recorded (at end of request) **Response**: Generated code is returned to CLI"},{"id":"api-service/overview::key-features::16","title":"API Service Overview","section":"Key Features","path":"/docs/guide/api-service/overview#key-features","headings":["Key Features"],"excerpt":"Key Features Feature Description --------- ------------- **🐳 Plugin Isolation** Each plugin runs in a secure, isolated Docker container **⚙️ Resource Control** CPU and memory limits enforced per plugin **📊 Metrics & Mo","content":"Key Features Feature Description --------- ------------- **🐳 Plugin Isolation** Each plugin runs in a secure, isolated Docker container **⚙️ Resource Control** CPU and memory limits enforced per plugin **📊 Metrics & Monitoring** Prometheus metrics for all operations **🔄 Version Management** Centralized plugin version control via Docker images **⚡ Simple Protocol** Standard CodeGeneratorRequest/Response protocol **🔒 Security First** Container isolation with resource constraints"},{"id":"api-service/overview::configuration::17","title":"API Service Overview","section":"Configuration","path":"/docs/guide/api-service/overview#configuration","headings":["Configuration"],"excerpt":"Configuration The service is configured via environment variables:","content":"Configuration The service is configured via environment variables:"},{"id":"api-service/overview::plugin-parameters-storage::18","title":"API Service Overview","section":"Plugin Parameters Storage","path":"/docs/guide/api-service/overview#plugin-parameters-storage","headings":["Plugin Parameters Storage"],"excerpt":"Plugin Parameters Storage PostgreSQL stores execution parameters for each plugin:","content":"Plugin Parameters Storage PostgreSQL stores execution parameters for each plugin:"},{"id":"api-service/overview::plugin-parameters-storage::19","title":"API Service Overview","section":"Plugin Parameters Storage","path":"/docs/guide/api-service/overview#plugin-parameters-storage","headings":["Plugin Parameters Storage"],"excerpt":"Plugin Parameters Storage ::: tip The storage schema and capabilities will be expanded in future releases to support additional features like audit logging, usage analytics, and plugin caching. :::","content":"Plugin Parameters Storage ::: tip The storage schema and capabilities will be expanded in future releases to support additional features like audit logging, usage analytics, and plugin caching. :::"},{"id":"api-service/overview::integration-with-easyp-cli::20","title":"API Service Overview","section":"Integration with EasyP CLI","path":"/docs/guide/api-service/overview#integration-with-easyp-cli","headings":["Integration with EasyP CLI"],"excerpt":"Integration with EasyP CLI Configure your easyp.yaml to use remote plugin execution:","content":"Integration with EasyP CLI Configure your easyp.yaml to use remote plugin execution:"},{"id":"api-service/overview::integration-with-easyp-cli::21","title":"API Service Overview","section":"Integration with EasyP CLI","path":"/docs/guide/api-service/overview#integration-with-easyp-cli","headings":["Integration with EasyP CLI"],"excerpt":"Integration with EasyP CLI Then generate code:","content":"Integration with EasyP CLI Then generate code:"},{"id":"api-service/overview::integration-with-easyp-cli::22","title":"API Service Overview","section":"Integration with EasyP CLI","path":"/docs/guide/api-service/overview#integration-with-easyp-cli","headings":["Integration with EasyP CLI"],"excerpt":"Integration with EasyP CLI The CLI will: Parse your protobuf files Send separate requests to API Service for each plugin Receive generated code responses Write generated files to specified output directories","content":"Integration with EasyP CLI The CLI will: Parse your protobuf files Send separate requests to API Service for each plugin Receive generated code responses Write generated files to specified output directories"},{"id":"api-service/overview::available-metrics::23","title":"API Service Overview","section":"Available Metrics","path":"/docs/guide/api-service/overview#available-metrics","headings":["Available Metrics"],"excerpt":"Available Metrics Prometheus metrics exposed by the service:","content":"Available Metrics Prometheus metrics exposed by the service:"},{"id":"api-service/overview::available-metrics::24","title":"API Service Overview","section":"Available Metrics","path":"/docs/guide/api-service/overview#available-metrics","headings":["Available Metrics"],"excerpt":"Available Metrics Metric Description -------- ------------- easyp_api_service_api_grpc_server_handled_total Total gRPC requests by status code easyp_api_service_api_grpc_server_handling_seconds gRPC request latency histo","content":"Available Metrics Metric Description -------- ------------- easyp_api_service_api_grpc_server_handled_total Total gRPC requests by status code easyp_api_service_api_grpc_server_handling_seconds gRPC request latency histogram easyp_api_service_generated_plugin_code_total Plugin executions by plugin name easyp_api_service_repo_call_duration_seconds Database query latency easyp_api_service_repo_errors_total Database errors count easyp_api_service_standard_panics_total Recovered panics count"},{"id":"api-service/overview::performance-characteristics::25","title":"API Service Overview","section":"Performance Characteristics","path":"/docs/guide/api-service/overview#performance-characteristics","headings":["Performance Characteristics"],"excerpt":"Performance Characteristics Metric Typical Value Notes -------- --------------- ------- **Cold Start** 2-5 seconds First time pulling plugin image **Warm Start** 100-500ms Plugin image cached by Docker **Throughput** 20-","content":"Performance Characteristics Metric Typical Value Notes -------- --------------- ------- **Cold Start** 2-5 seconds First time pulling plugin image **Warm Start** 100-500ms Plugin image cached by Docker **Throughput** 20-50 concurrent Depends on available resources **Memory Usage** 50-200MB Per plugin execution"},{"id":"api-service/overview::container-isolation::26","title":"API Service Overview","section":"Container Isolation","path":"/docs/guide/api-service/overview#container-isolation","headings":["Container Isolation"],"excerpt":"Container Isolation Each plugin runs in a separate, ephemeral container No network access during plugin execution Resource limits (CPU, memory) enforced via Docker Containers destroyed after execution","content":"Container Isolation Each plugin runs in a separate, ephemeral container No network access during plugin execution Resource limits (CPU, memory) enforced via Docker Containers destroyed after execution"},{"id":"api-service/overview::api-security::27","title":"API Service Overview","section":"API Security","path":"/docs/guide/api-service/overview#api-security","headings":["API Security"],"excerpt":"API Security gRPC-based communication Support for authentication tokens (production deployments) Input validation for all requests Execution audit logs stored in PostgreSQL","content":"API Security gRPC-based communication Support for authentication tokens (production deployments) Input validation for all requests Execution audit logs stored in PostgreSQL"},{"id":"api-service/overview::scalability::28","title":"API Service Overview","section":"Scalability","path":"/docs/guide/api-service/overview#scalability","headings":["Scalability"],"excerpt":"Scalability **Horizontal scaling**: Deploy multiple service instances behind load balancer **Resource management**: Configure appropriate CPU/memory limits per plugin **Database**: PostgreSQL can be replicated for high a","content":"Scalability **Horizontal scaling**: Deploy multiple service instances behind load balancer **Resource management**: Configure appropriate CPU/memory limits per plugin **Database**: PostgreSQL can be replicated for high availability"},{"id":"api-service/overview::monitoring::29","title":"API Service Overview","section":"Monitoring","path":"/docs/guide/api-service/overview#monitoring","headings":["Monitoring"],"excerpt":"Monitoring **Prometheus metrics**: Monitor all aspects of service health **Alerting**: Set up alerts for high error rates or slow execution **Logs**: Structured logging for debugging and audit trails","content":"Monitoring **Prometheus metrics**: Monitor all aspects of service health **Alerting**: Set up alerts for high error rates or slow execution **Logs**: Structured logging for debugging and audit trails"},{"id":"api-service/overview::future-enhancements::30","title":"API Service Overview","section":"Future Enhancements","path":"/docs/guide/api-service/overview#future-enhancements","headings":["Future Enhancements"],"excerpt":"Future Enhancements The API Service is actively developed with planned features including: Plugin result caching for faster repeated executions Enhanced audit logging and usage analytics Support for custom plugin registr","content":"Future Enhancements The API Service is actively developed with planned features including: Plugin result caching for faster repeated executions Enhanced audit logging and usage analytics Support for custom plugin registries Advanced resource scheduling and optimization"},{"id":"api-service/overview::community-and-support::31","title":"API Service Overview","section":"Community and Support","path":"/docs/guide/api-service/overview#community-and-support","headings":["Community and Support"],"excerpt":"Community and Support **💬 Telegram Chat** - Community discussion **🐛 GitHub Issues** - Bug reports and features **📖 Documentation** - Complete documentation","content":"Community and Support **💬 Telegram Chat** - Community discussion **🐛 GitHub Issues** - Bug reports and features **📖 Documentation** - Complete documentation"},{"id":"api-service/overview::community-and-support::32","title":"API Service Overview","section":"Community and Support","path":"/docs/guide/api-service/overview#community-and-support","headings":["Community and Support"],"excerpt":"Community and Support *Simplify your protobuf workflows with centralized plugin execution*","content":"Community and Support *Simplify your protobuf workflows with centralized plugin execution*"},{"id":"ci-cd/github-actions::top::0","title":"Github Actions","path":"/docs/guide/ci-cd/github-actions","headings":[],"excerpt":"Github Actions Work in progress","content":"Github Actions Work in progress"},{"id":"ci-cd/gitlab::top::0","title":"Gitlab","path":"/docs/guide/ci-cd/gitlab","headings":[],"excerpt":"Gitlab Work in progress","content":"Gitlab Work in progress"},{"id":"cli/auto-completion/auto-completion::zsh-auto-completion::0","title":"Auto completion","section":"zsh auto-completion","path":"/docs/guide/cli/auto-completion/auto-completion#zsh-auto-completion","headings":["zsh auto-completion"],"excerpt":"zsh auto-completion Add the following line to your ~/.zshrc startup script:","content":"zsh auto-completion Add the following line to your ~/.zshrc startup script:"},{"id":"cli/auto-completion/auto-completion::zsh-auto-completion::1","title":"Auto completion","section":"zsh auto-completion","path":"/docs/guide/cli/auto-completion/auto-completion#zsh-auto-completion","headings":["zsh auto-completion"],"excerpt":"zsh auto-completion Re-launch your shell or run:","content":"zsh auto-completion Re-launch your shell or run:"},{"id":"cli/auto-completion/auto-completion::bash-auto-completion::2","title":"Auto completion","section":"Bash auto-completion","path":"/docs/guide/cli/auto-completion/auto-completion#bash-auto-completion","headings":["Bash auto-completion"],"excerpt":"Bash auto-completion Install bash-completion and add the software to your ~/.bashrc. Add the following line to your ~/.bashrc startup script:","content":"Bash auto-completion Install bash-completion and add the software to your ~/.bashrc. Add the following line to your ~/.bashrc startup script:"},{"id":"cli/auto-completion/auto-completion::bash-auto-completion::3","title":"Auto completion","section":"Bash auto-completion","path":"/docs/guide/cli/auto-completion/auto-completion#bash-auto-completion","headings":["Bash auto-completion"],"excerpt":"Bash auto-completion Re-launch your shell or run:","content":"Bash auto-completion Re-launch your shell or run:"},{"id":"cli/breaking-changes/breaking-changes::top::0","title":"Breaking Changes Detection","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":[],"excerpt":"EasyP's breaking changes detection helps you maintain backward compatibility in your protobuf APIs by automatically identifying changes that could break existing clients. This is crucial for maintaining stable APIs in pr","content":"EasyP's breaking changes detection helps you maintain backward compatibility in your protobuf APIs by automatically identifying changes that could break existing clients. This is crucial for maintaining stable APIs in production environments."},{"id":"cli/breaking-changes/breaking-changes::overview::1","title":"Breaking Changes Detection","section":"Overview","path":"/docs/guide/cli/breaking-changes/breaking-changes#overview","headings":["Overview"],"excerpt":"Overview The breaking changes checker compares your current protobuf files against a previous version (typically from another Git branch) and identifies modifications that could cause compatibility issues for existing cl","content":"Overview The breaking changes checker compares your current protobuf files against a previous version (typically from another Git branch) and identifies modifications that could cause compatibility issues for existing clients."},{"id":"cli/breaking-changes/breaking-changes::key-features::2","title":"Breaking Changes Detection","section":"Key Features","path":"/docs/guide/cli/breaking-changes/breaking-changes#key-features","headings":["Key Features"],"excerpt":"Key Features **Git-based Comparison**: Compare against any Git reference (branch, tag, or commit) **Comprehensive Analysis**: Checks services, messages, enums, fields, and imports **Selective Ignore**: Skip specific dire","content":"Key Features **Git-based Comparison**: Compare against any Git reference (branch, tag, or commit) **Comprehensive Analysis**: Checks services, messages, enums, fields, and imports **Selective Ignore**: Skip specific directories from breaking change analysis **Detailed Reports**: Clear error messages with file locations and line numbers"},{"id":"cli/breaking-changes/breaking-changes::how-it-works::3","title":"Breaking Changes Detection","section":"How It Works","path":"/docs/guide/cli/breaking-changes/breaking-changes#how-it-works","headings":["How It Works"],"excerpt":"How It Works The breaking changes detector follows this process:","content":"How It Works The breaking changes detector follows this process:"},{"id":"cli/breaking-changes/breaking-changes::how-it-works::4","title":"Breaking Changes Detection","section":"How It Works","path":"/docs/guide/cli/breaking-changes/breaking-changes#how-it-works","headings":["How It Works"],"excerpt":"How It Works **Checkout Comparison Branch**: Retrieves proto files from the specified Git reference **Parse Both Versions**: Analyzes current and previous proto file structures **Compare Entities**: Systematically checks","content":"How It Works **Checkout Comparison Branch**: Retrieves proto files from the specified Git reference **Parse Both Versions**: Analyzes current and previous proto file structures **Compare Entities**: Systematically checks all protobuf elements for breaking changes **Generate Report**: Produces detailed issue reports with locations and descriptions"},{"id":"cli/breaking-changes/breaking-changes::detection-level::5","title":"Breaking Changes Detection","section":"Detection Level","path":"/docs/guide/cli/breaking-changes/breaking-changes#detection-level","headings":["Detection Level"],"excerpt":"Detection Level EasyP implements **WIRE+ level** breaking change detection: ✅ **Full wire format compatibility** - ensures old and new versions can exchange data ✅ **Element deletion detection** - catches deleted service","content":"Detection Level EasyP implements **WIRE+ level** breaking change detection: ✅ **Full wire format compatibility** - ensures old and new versions can exchange data ✅ **Element deletion detection** - catches deleted services, messages, fields, etc. ✅ **Type safety** - detects incompatible type changes ❌ **Field/method renames** - currently not detected (planned for future releases) ❌ **File-level changes** - package moves, file options not checked yet"},{"id":"cli/breaking-changes/breaking-changes::detection-level::6","title":"Breaking Changes Detection","section":"Detection Level","path":"/docs/guide/cli/breaking-changes/breaking-changes#detection-level","headings":["Detection Level"],"excerpt":"Detection Level This provides strong compatibility guarantees while being less strict than some tools that check generated code compatibility.","content":"Detection Level This provides strong compatibility guarantees while being less strict than some tools that check generated code compatibility."},{"id":"cli/breaking-changes/breaking-changes::configuration::7","title":"Breaking Changes Detection","section":"Configuration","path":"/docs/guide/cli/breaking-changes/breaking-changes#configuration","headings":["Configuration"],"excerpt":"Configuration Configure breaking changes detection in your easyp.yaml:","content":"Configuration Configure breaking changes detection in your easyp.yaml:"},{"id":"cli/breaking-changes/breaking-changes::configuration-options::8","title":"Breaking Changes Detection","section":"Configuration Options","path":"/docs/guide/cli/breaking-changes/breaking-changes#configuration-options","headings":["Configuration Options"],"excerpt":"Configuration Options Option Description Default Required -------- ------------- --------- ---------- against_git_ref Git reference to compare against \"master\" No ignore List of directories to exclude from analysis [] No","content":"Configuration Options Option Description Default Required -------- ------------- --------- ---------- against_git_ref Git reference to compare against \"master\" No ignore List of directories to exclude from analysis [] No"},{"id":"cli/breaking-changes/breaking-changes::basic-usage::9","title":"Breaking Changes Detection","section":"Basic Usage","path":"/docs/guide/cli/breaking-changes/breaking-changes#basic-usage","headings":["Basic Usage"],"excerpt":"Basic Usage Compare current changes against the main branch:","content":"Basic Usage Compare current changes against the main branch:"},{"id":"cli/breaking-changes/breaking-changes::using-configuration-file::10","title":"Breaking Changes Detection","section":"Using Configuration File","path":"/docs/guide/cli/breaking-changes/breaking-changes#using-configuration-file","headings":["Using Configuration File"],"excerpt":"Using Configuration File With a custom configuration file:","content":"Using Configuration File With a custom configuration file:"},{"id":"cli/breaking-changes/breaking-changes::override-git-reference::11","title":"Breaking Changes Detection","section":"Override Git Reference","path":"/docs/guide/cli/breaking-changes/breaking-changes#override-git-reference","headings":["Override Git Reference"],"excerpt":"Override Git Reference Override the configured branch:","content":"Override Git Reference Override the configured branch:"},{"id":"cli/breaking-changes/breaking-changes::detection-level::12","title":"Breaking Changes Detection","section":"Detection Level","path":"/docs/guide/cli/breaking-changes/breaking-changes#detection-level","headings":["Detection Level"],"excerpt":"Detection Level EasyP currently implements **WIRE+ level** breaking change detection, which provides comprehensive wire format compatibility plus some generated code protections:","content":"Detection Level EasyP currently implements **WIRE+ level** breaking change detection, which provides comprehensive wire format compatibility plus some generated code protections:"},{"id":"cli/breaking-changes/breaking-changes::comparison-with-buf-categories::13","title":"Breaking Changes Detection","section":"Comparison with Buf Categories","path":"/docs/guide/cli/breaking-changes/breaking-changes#comparison-with-buf-categories","headings":["Comparison with Buf Categories"],"excerpt":"Comparison with Buf Categories Check Type Buf WIRE Buf WIRE_JSON Buf FILE EasyP Current ------------ ---------- --------------- ---------- --------------- **Element Deletions** Service deletion ❌ ❌ ✅ ✅ RPC method deletio","content":"Comparison with Buf Categories Check Type Buf WIRE Buf WIRE_JSON Buf FILE EasyP Current ------------ ---------- --------------- ---------- --------------- **Element Deletions** Service deletion ❌ ❌ ✅ ✅ RPC method deletion ❌ ❌ ✅ ✅ Message deletion ❌ ❌ ✅ ✅ Field deletion (by number) ✅ ✅ ✅ ✅ Enum deletion ❌ ❌ ✅ ✅ Enum value deletion ✅ ✅ ✅ ✅ OneOf deletion ❌ ❌ ✅ ✅ Import deletion ❌ ❌ ✅ ✅ **Type Changes** Field type change ✅ ✅ ✅ ✅ RPC request/response type ✅ ✅ ✅ ✅ Optional/required changes ✅ ✅ ✅ ✅ **Naming (Generated Code)** Field rename (same number) ❌ ✅ ✅ ❌ Enum value rename ❌ ✅ ✅ ✅ **File Structure** Package change ✅ ✅ ✅ ❌ File options (go_package, etc) ❌ ❌ ✅ ❌ Moving types between files ❌ ❌ ✅ ❌"},{"id":"cli/breaking-changes/breaking-changes::what-this-means::14","title":"Breaking Changes Detection","section":"What This Means","path":"/docs/guide/cli/breaking-changes/breaking-changes#what-this-means","headings":["What This Means"],"excerpt":"What This Means **✅ EasyP WILL detect:** All wire format breaking changes Deletion of services, methods, messages, fields Type changes that break serialization Enum value renames (same number, different name)","content":"What This Means **✅ EasyP WILL detect:** All wire format breaking changes Deletion of services, methods, messages, fields Type changes that break serialization Enum value renames (same number, different name)"},{"id":"cli/breaking-changes/breaking-changes::what-this-means::15","title":"Breaking Changes Detection","section":"What This Means","path":"/docs/guide/cli/breaking-changes/breaking-changes#what-this-means","headings":["What This Means"],"excerpt":"What This Means **❌ EasyP will NOT detect:** Field renames (same number, different name) Package name changes File option changes (go_package, java_package, etc.) Moving types between files in the same package","content":"What This Means **❌ EasyP will NOT detect:** Field renames (same number, different name) Package name changes File option changes (go_package, java_package, etc.) Moving types between files in the same package"},{"id":"cli/breaking-changes/breaking-changes::breaking-change-rules::16","title":"Breaking Changes Detection","section":"Breaking Change Rules","path":"/docs/guide/cli/breaking-changes/breaking-changes#breaking-change-rules","headings":["Breaking Change Rules"],"excerpt":"Breaking Change Rules EasyP detects the following types of breaking changes:","content":"Breaking Change Rules EasyP detects the following types of breaking changes:"},{"id":"cli/breaking-changes/breaking-changes::comparison-with-other-tools::17","title":"Breaking Changes Detection","section":"Comparison with Other Tools","path":"/docs/guide/cli/breaking-changes/breaking-changes#comparison-with-other-tools","headings":["Comparison with Other Tools"],"excerpt":"Comparison with Other Tools Detection Level Description EasyP Support ---------------- ------------- --------------- **WIRE** Wire format compatibility only ✅ **Full support** **WIRE+** Wire + element deletion detection ","content":"Comparison with Other Tools Detection Level Description EasyP Support ---------------- ------------- --------------- **WIRE** Wire format compatibility only ✅ **Full support** **WIRE+** Wire + element deletion detection ✅ **Current level** **FILE** Generated code compatibility ❌ Partial (planned)"},{"id":"cli/breaking-changes/breaking-changes::breaking-change-rules::18","title":"Breaking Changes Detection","section":"Breaking Change Rules","path":"/docs/guide/cli/breaking-changes/breaking-changes#breaking-change-rules","headings":["Breaking Change Rules"],"excerpt":"Breaking Change Rules EasyP detects the following categories of breaking changes. Each rule has detailed documentation with examples:","content":"Breaking Change Rules EasyP detects the following categories of breaking changes. Each rule has detailed documentation with examples:"},{"id":"cli/breaking-changes/breaking-changes::service-and-rpc-changes::19","title":"Breaking Changes Detection","section":"🚨 Service and RPC Changes","path":"/docs/guide/cli/breaking-changes/breaking-changes#service-and-rpc-changes","headings":["🚨 Service and RPC Changes"],"excerpt":"🚨 Service and RPC Changes Rule Description Status ------ ------------- --------- SERVICE_NO_DELETE Services cannot be deleted ✅ Implemented RPC_NO_DELETE RPC methods cannot be deleted ✅ Implemented RPC_SAME_REQUEST_TYPE","content":"🚨 Service and RPC Changes Rule Description Status ------ ------------- --------- SERVICE_NO_DELETE Services cannot be deleted ✅ Implemented RPC_NO_DELETE RPC methods cannot be deleted ✅ Implemented RPC_SAME_REQUEST_TYPE RPC request types cannot be changed ✅ Implemented RPC_SAME_RESPONSE_TYPE RPC response types cannot be changed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::message-and-field-changes::20","title":"Breaking Changes Detection","section":"📦 Message and Field Changes","path":"/docs/guide/cli/breaking-changes/breaking-changes#message-and-field-changes","headings":["📦 Message and Field Changes"],"excerpt":"📦 Message and Field Changes Rule Description Status ------ ------------- --------- MESSAGE_NO_DELETE Messages cannot be deleted ✅ Implemented FIELD_NO_DELETE Fields cannot be deleted ✅ Implemented FIELD_SAME_TYPE Field ","content":"📦 Message and Field Changes Rule Description Status ------ ------------- --------- MESSAGE_NO_DELETE Messages cannot be deleted ✅ Implemented FIELD_NO_DELETE Fields cannot be deleted ✅ Implemented FIELD_SAME_TYPE Field types cannot be changed ✅ Implemented FIELD_SAME_CARDINALITY Field optionality (optional/required) cannot be changed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::enum-changes::21","title":"Breaking Changes Detection","section":"🔢 Enum Changes","path":"/docs/guide/cli/breaking-changes/breaking-changes#enum-changes","headings":["🔢 Enum Changes"],"excerpt":"🔢 Enum Changes Rule Description Status ------ ------------- --------- ENUM_NO_DELETE Enums cannot be deleted ✅ Implemented ENUM_VALUE_NO_DELETE Enum values cannot be deleted ✅ Implemented ENUM_VALUE_SAME_NAME Enum value","content":"🔢 Enum Changes Rule Description Status ------ ------------- --------- ENUM_NO_DELETE Enums cannot be deleted ✅ Implemented ENUM_VALUE_NO_DELETE Enum values cannot be deleted ✅ Implemented ENUM_VALUE_SAME_NAME Enum value names cannot be changed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::oneof-changes::22","title":"Breaking Changes Detection","section":"🔗 OneOf Changes","path":"/docs/guide/cli/breaking-changes/breaking-changes#oneof-changes","headings":["🔗 OneOf Changes"],"excerpt":"🔗 OneOf Changes Rule Description Status ------ ------------- --------- ONEOF_NO_DELETE OneOf fields cannot be deleted ✅ Implemented ONEOF_FIELD_NO_DELETE Fields within oneofs cannot be deleted ✅ Implemented ONEOF_FIELD_","content":"🔗 OneOf Changes Rule Description Status ------ ------------- --------- ONEOF_NO_DELETE OneOf fields cannot be deleted ✅ Implemented ONEOF_FIELD_NO_DELETE Fields within oneofs cannot be deleted ✅ Implemented ONEOF_FIELD_SAME_TYPE OneOf field types cannot be changed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::import-changes::23","title":"Breaking Changes Detection","section":"📥 Import Changes","path":"/docs/guide/cli/breaking-changes/breaking-changes#import-changes","headings":["📥 Import Changes"],"excerpt":"📥 Import Changes Rule Description Status ------ ------------- --------- IMPORT_NO_DELETE Import statements cannot be removed ✅ Implemented","content":"📥 Import Changes Rule Description Status ------ ------------- --------- IMPORT_NO_DELETE Import statements cannot be removed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::not-currently-detected::24","title":"Breaking Changes Detection","section":"Not Currently Detected","path":"/docs/guide/cli/breaking-changes/breaking-changes#not-currently-detected","headings":["Not Currently Detected"],"excerpt":"Not Currently Detected The following changes are **NOT detected** by EasyP (but may break generated code):","content":"Not Currently Detected The following changes are **NOT detected** by EasyP (but may break generated code):"},{"id":"cli/breaking-changes/breaking-changes::not-currently-detected::25","title":"Breaking Changes Detection","section":"Not Currently Detected","path":"/docs/guide/cli/breaking-changes/breaking-changes#not-currently-detected","headings":["Not Currently Detected"],"excerpt":"Not Currently Detected Change Type Example Impact ------------- --------- --------- Field renaming string name = 1 → string full_name = 1 Generated code breaks Package changes package v1 → package v2 Import paths change ","content":"Not Currently Detected Change Type Example Impact ------------- --------- --------- Field renaming string name = 1 → string full_name = 1 Generated code breaks Package changes package v1 → package v2 Import paths change File options option go_package = \"old\" → option go_package = \"new\" Generated code location Moving between files Message moved to different .proto file Import dependencies"},{"id":"cli/breaking-changes/breaking-changes::detailed-rules-documentation::26","title":"Breaking Changes Detection","section":"Detailed Rules Documentation","path":"/docs/guide/cli/breaking-changes/breaking-changes#detailed-rules-documentation","headings":["Detailed Rules Documentation"],"excerpt":"Detailed Rules Documentation For comprehensive examples and migration strategies, see the individual rule documentation:","content":"Detailed Rules Documentation For comprehensive examples and migration strategies, see the individual rule documentation:"},{"id":"cli/breaking-changes/breaking-changes::detailed-rules-documentation::27","title":"Breaking Changes Detection","section":"Detailed Rules Documentation","path":"/docs/guide/cli/breaking-changes/breaking-changes#detailed-rules-documentation","headings":["Detailed Rules Documentation"],"excerpt":"Detailed Rules Documentation **Service Changes**: SERVICE_NO_DELETE, RPC_NO_DELETE, RPC_SAME_REQUEST_TYPE, RPC_SAME_RESPONSE_TYPE **Message Changes**: MESSAGE_NO_DELETE, FIELD_NO_DELETE, FIELD_SAME_TYPE, FIELD_SAME_CARDI","content":"Detailed Rules Documentation **Service Changes**: SERVICE_NO_DELETE, RPC_NO_DELETE, RPC_SAME_REQUEST_TYPE, RPC_SAME_RESPONSE_TYPE **Message Changes**: MESSAGE_NO_DELETE, FIELD_NO_DELETE, FIELD_SAME_TYPE, FIELD_SAME_CARDINALITY **Enum Changes**: ENUM_NO_DELETE, ENUM_VALUE_NO_DELETE, ENUM_VALUE_SAME_NAME **OneOf Changes**: ONEOF_NO_DELETE, ONEOF_FIELD_NO_DELETE, ONEOF_FIELD_SAME_TYPE **Import Changes**: IMPORT_NO_DELETE"},{"id":"cli/breaking-changes/breaking-changes::detailed-rules-documentation::28","title":"Breaking Changes Detection","section":"Detailed Rules Documentation","path":"/docs/guide/cli/breaking-changes/breaking-changes#detailed-rules-documentation","headings":["Detailed Rules Documentation"],"excerpt":"Detailed Rules Documentation Each rule includes: ❌ **Bad examples** with actual breaking changes ✅ **Good alternatives** showing safe approaches 🔧 **Migration strategies** for handling necessary changes 📋 **Real error ","content":"Detailed Rules Documentation Each rule includes: ❌ **Bad examples** with actual breaking changes ✅ **Good alternatives** showing safe approaches 🔧 **Migration strategies** for handling necessary changes 📋 **Real error messages** from EasyP"},{"id":"cli/breaking-changes/breaking-changes::safe-changes-always-allowed::29","title":"Breaking Changes Detection","section":"✅ Safe Changes (Always Allowed)","path":"/docs/guide/cli/breaking-changes/breaking-changes#safe-changes-always-allowed","headings":["✅ Safe Changes (Always Allowed)"],"excerpt":"✅ Safe Changes (Always Allowed) ```proto // Adding new elements is always safe message User { string name = 1; string email = 2; string phone = 3; // ✅ New field - safe }","content":"✅ Safe Changes (Always Allowed) ```proto // Adding new elements is always safe message User { string name = 1; string email = 2; string phone = 3; // ✅ New field - safe }"},{"id":"cli/breaking-changes/breaking-changes::safe-changes-always-allowed::30","title":"Breaking Changes Detection","section":"✅ Safe Changes (Always Allowed)","path":"/docs/guide/cli/breaking-changes/breaking-changes#safe-changes-always-allowed","headings":["✅ Safe Changes (Always Allowed)"],"excerpt":"✅ Safe Changes (Always Allowed) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc GetUserProfile(GetUserRequest) returns (UserProfile); // ✅ New RPC - safe }","content":"✅ Safe Changes (Always Allowed) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc GetUserProfile(GetUserRequest) returns (UserProfile); // ✅ New RPC - safe }"},{"id":"cli/breaking-changes/breaking-changes::safe-changes-always-allowed::31","title":"Breaking Changes Detection","section":"✅ Safe Changes (Always Allowed)","path":"/docs/guide/cli/breaking-changes/breaking-changes#safe-changes-always-allowed","headings":["✅ Safe Changes (Always Allowed)"],"excerpt":"✅ Safe Changes (Always Allowed) enum Status { STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; STATUS_PENDING = 2; // ✅ New enum value - safe } ```","content":"✅ Safe Changes (Always Allowed) enum Status { STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; STATUS_PENDING = 2; // ✅ New enum value - safe } ```"},{"id":"cli/breaking-changes/breaking-changes::breaking-changes-always-detected::32","title":"Breaking Changes Detection","section":"❌ Breaking Changes (Always Detected)","path":"/docs/guide/cli/breaking-changes/breaking-changes#breaking-changes-always-detected","headings":["❌ Breaking Changes (Always Detected)"],"excerpt":"❌ Breaking Changes (Always Detected) ```proto // Deletions and type changes break compatibility message User { string name = 1; // ❌ Deleted field - BREAKING }","content":"❌ Breaking Changes (Always Detected) ```proto // Deletions and type changes break compatibility message User { string name = 1; // ❌ Deleted field - BREAKING }"},{"id":"cli/breaking-changes/breaking-changes::breaking-changes-always-detected::33","title":"Breaking Changes Detection","section":"❌ Breaking Changes (Always Detected)","path":"/docs/guide/cli/breaking-changes/breaking-changes#breaking-changes-always-detected","headings":["❌ Breaking Changes (Always Detected)"],"excerpt":"❌ Breaking Changes (Always Detected) service UserService { // ❌ Deleted RPC method - BREAKING rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // ❌ Changed request type - BREAKING } ```","content":"❌ Breaking Changes (Always Detected) service UserService { // ❌ Deleted RPC method - BREAKING rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // ❌ Changed request type - BREAKING } ```"},{"id":"cli/breaking-changes/breaking-changes::scenario-3-breaking-changes-currently-not-detected::34","title":"Breaking Changes Detection","section":"Scenario 3: Breaking Changes (Currently Not Detected)","path":"/docs/guide/cli/breaking-changes/breaking-changes#scenario-3-breaking-changes-currently-not-detected","headings":["Scenario 3: Breaking Changes (Currently Not Detected)"],"excerpt":"Scenario 3: Breaking Changes (Currently Not Detected) ```proto // 🟡 Breaks generated code but passes EasyP checks message User { string user_name = 1; // Renamed from \"name\" string user_email = 2; // Renamed from \"email","content":"Scenario 3: Breaking Changes (Currently Not Detected) ```proto // 🟡 Breaks generated code but passes EasyP checks message User { string user_name = 1; // Renamed from \"name\" string user_email = 2; // Renamed from \"email\" }"},{"id":"cli/breaking-changes/breaking-changes::scenario-3-breaking-changes-currently-not-detected::35","title":"Breaking Changes Detection","section":"Scenario 3: Breaking Changes (Currently Not Detected)","path":"/docs/guide/cli/breaking-changes/breaking-changes#scenario-3-breaking-changes-currently-not-detected","headings":["Scenario 3: Breaking Changes (Currently Not Detected)"],"excerpt":"Scenario 3: Breaking Changes (Currently Not Detected) service UserService { rpc GetUserProfile(GetUserRequest) returns (GetUserResponse); // Renamed from GetUser } ```","content":"Scenario 3: Breaking Changes (Currently Not Detected) service UserService { rpc GetUserProfile(GetUserRequest) returns (GetUserResponse); // Renamed from GetUser } ```"},{"id":"cli/breaking-changes/breaking-changes::1-regular-checks::36","title":"Breaking Changes Detection","section":"1. Regular Checks","path":"/docs/guide/cli/breaking-changes/breaking-changes#1-regular-checks","headings":["1. Regular Checks"],"excerpt":"Regular Checks Run breaking change detection in your CI/CD pipeline:","content":"Regular Checks Run breaking change detection in your CI/CD pipeline:"},{"id":"cli/breaking-changes/breaking-changes::2-branch-protection::37","title":"Breaking Changes Detection","section":"2. Branch Protection","path":"/docs/guide/cli/breaking-changes/breaking-changes#2-branch-protection","headings":["2. Branch Protection"],"excerpt":"Branch Protection Use breaking change checks to protect important branches:","content":"Branch Protection Use breaking change checks to protect important branches:"},{"id":"cli/breaking-changes/breaking-changes::3-versioning-strategy::38","title":"Breaking Changes Detection","section":"3. Versioning Strategy","path":"/docs/guide/cli/breaking-changes/breaking-changes#3-versioning-strategy","headings":["3. Versioning Strategy"],"excerpt":"Versioning Strategy When breaking changes are necessary:","content":"Versioning Strategy When breaking changes are necessary:"},{"id":"cli/breaking-changes/breaking-changes::3-versioning-strategy::39","title":"Breaking Changes Detection","section":"3. Versioning Strategy","path":"/docs/guide/cli/breaking-changes/breaking-changes#3-versioning-strategy","headings":["3. Versioning Strategy"],"excerpt":"Versioning Strategy Create a new package version (e.g., myservice.v2) Maintain the old version during migration period Use deprecation notices in the old version","content":"Versioning Strategy Create a new package version (e.g., myservice.v2) Maintain the old version during migration period Use deprecation notices in the old version"},{"id":"cli/breaking-changes/breaking-changes::4-ignore-patterns::40","title":"Breaking Changes Detection","section":"4. Ignore Patterns","path":"/docs/guide/cli/breaking-changes/breaking-changes#4-ignore-patterns","headings":["4. Ignore Patterns"],"excerpt":"Ignore Patterns Use ignore patterns wisely:","content":"Ignore Patterns Use ignore patterns wisely:"},{"id":"cli/breaking-changes/breaking-changes::issue-repository-does-not-exist::41","title":"Breaking Changes Detection","section":"Issue: \"Repository does not exist\"","path":"/docs/guide/cli/breaking-changes/breaking-changes#issue-repository-does-not-exist","headings":["Issue: \"Repository does not exist\""],"excerpt":"Issue: \"Repository does not exist\" **Solution**: Ensure you're running the command in a Git repository with the specified branch available.","content":"Issue: \"Repository does not exist\" **Solution**: Ensure you're running the command in a Git repository with the specified branch available."},{"id":"cli/breaking-changes/breaking-changes::issue-cannot-find-git-ref::42","title":"Breaking Changes Detection","section":"Issue: \"Cannot find git ref\"","path":"/docs/guide/cli/breaking-changes/breaking-changes#issue-cannot-find-git-ref","headings":["Issue: \"Cannot find git ref\""],"excerpt":"Issue: \"Cannot find git ref\" **Solution**: Verify the branch/tag name exists and is accessible:","content":"Issue: \"Cannot find git ref\" **Solution**: Verify the branch/tag name exists and is accessible:"},{"id":"cli/breaking-changes/breaking-changes::issue-false-positives-in-generated-code::43","title":"Breaking Changes Detection","section":"Issue: False Positives in Generated Code","path":"/docs/guide/cli/breaking-changes/breaking-changes#issue-false-positives-in-generated-code","headings":["Issue: False Positives in Generated Code"],"excerpt":"Issue: False Positives in Generated Code **Solution**: Add generated directories to ignore list:","content":"Issue: False Positives in Generated Code **Solution**: Add generated directories to ignore list:"},{"id":"cli/breaking-changes/breaking-changes::issue-large-number-of-changes::44","title":"Breaking Changes Detection","section":"Issue: Large Number of Changes","path":"/docs/guide/cli/breaking-changes/breaking-changes#issue-large-number-of-changes","headings":["Issue: Large Number of Changes"],"excerpt":"Issue: Large Number of Changes **Solution**: For major refactoring, consider: Creating a new API version Implementing changes incrementally Using feature flags for gradual rollout","content":"Issue: Large Number of Changes **Solution**: For major refactoring, consider: Creating a new API version Implementing changes incrementally Using feature flags for gradual rollout"},{"id":"cli/breaking-changes/breaking-changes::github-actions::45","title":"Breaking Changes Detection","section":"GitHub Actions","path":"/docs/guide/cli/breaking-changes/breaking-changes#github-actions","headings":["GitHub Actions"],"excerpt":"GitHub Actions ```yaml name: API Compatibility Check","content":"GitHub Actions ```yaml name: API Compatibility Check"},{"id":"cli/breaking-changes/breaking-changes::github-actions::46","title":"Breaking Changes Detection","section":"GitHub Actions","path":"/docs/guide/cli/breaking-changes/breaking-changes#github-actions","headings":["GitHub Actions"],"excerpt":"GitHub Actions on: pull_request: branches: [ main ]","content":"GitHub Actions on: pull_request: branches: [ main ]"},{"id":"cli/breaking-changes/breaking-changes::github-actions::47","title":"Breaking Changes Detection","section":"GitHub Actions","path":"/docs/guide/cli/breaking-changes/breaking-changes#github-actions","headings":["GitHub Actions"],"excerpt":"GitHub Actions jobs: breaking-changes: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 with: fetch-depth: 0 # Fetch full history - name: Install EasyP run: curl -sSfL https://raw.githubusercontent.com/easyp-tec","content":"GitHub Actions jobs: breaking-changes: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 with: fetch-depth: 0 # Fetch full history - name: Install EasyP run: curl -sSfL https://raw.githubusercontent.com/easyp-tech/easyp/main/install.sh sh - name: Check for breaking changes run: ./bin/easyp breaking --against origin/main ```"},{"id":"cli/breaking-changes/breaking-changes::pre-commit-hook::48","title":"Breaking Changes Detection","section":"Pre-commit Hook","path":"/docs/guide/cli/breaking-changes/breaking-changes#pre-commit-hook","headings":["Pre-commit Hook"],"excerpt":"Pre-commit Hook ```bash #!/bin/sh .git/hooks/pre-push","content":"Pre-commit Hook ```bash #!/bin/sh .git/hooks/pre-push"},{"id":"cli/breaking-changes/breaking-changes::pre-commit-hook::49","title":"Breaking Changes Detection","section":"Pre-commit Hook","path":"/docs/guide/cli/breaking-changes/breaking-changes#pre-commit-hook","headings":["Pre-commit Hook"],"excerpt":"Pre-commit Hook protected_branch='main' current_branch=$(git symbolic-ref HEAD sed -e 's,.*/\\(.*\\),\\1,')","content":"Pre-commit Hook protected_branch='main' current_branch=$(git symbolic-ref HEAD sed -e 's,.*/\\(.*\\),\\1,')"},{"id":"cli/breaking-changes/breaking-changes::pre-commit-hook::50","title":"Breaking Changes Detection","section":"Pre-commit Hook","path":"/docs/guide/cli/breaking-changes/breaking-changes#pre-commit-hook","headings":["Pre-commit Hook"],"excerpt":"Pre-commit Hook if [ $current_branch = $protected_branch ]; then echo \"Running breaking changes check...\" easyp breaking --against HEAD~1 if [ $? -eq 1 ]; then echo \"❌ Breaking changes detected. Push rejected.\" exit 1 fi","content":"Pre-commit Hook if [ $current_branch = $protected_branch ]; then echo \"Running breaking changes check...\" easyp breaking --against HEAD~1 if [ $? -eq 1 ]; then echo \"❌ Breaking changes detected. Push rejected.\" exit 1 fi echo \"✅ No breaking changes detected.\" fi ```"},{"id":"cli/breaking-changes/breaking-changes::debug-mode::51","title":"Breaking Changes Detection","section":"Debug Mode","path":"/docs/guide/cli/breaking-changes/breaking-changes#debug-mode","headings":["Debug Mode"],"excerpt":"Debug Mode Enable debug logging for detailed information:","content":"Debug Mode Enable debug logging for detailed information:"},{"id":"cli/breaking-changes/breaking-changes::manual-comparison::52","title":"Breaking Changes Detection","section":"Manual Comparison","path":"/docs/guide/cli/breaking-changes/breaking-changes#manual-comparison","headings":["Manual Comparison"],"excerpt":"Manual Comparison For complex cases, you can manually inspect the comparison:","content":"Manual Comparison For complex cases, you can manually inspect the comparison:"},{"id":"cli/breaking-changes/breaking-changes::performance-optimization::53","title":"Breaking Changes Detection","section":"Performance Optimization","path":"/docs/guide/cli/breaking-changes/breaking-changes#performance-optimization","headings":["Performance Optimization"],"excerpt":"Performance Optimization For large repositories:","content":"Performance Optimization For large repositories:"},{"id":"cli/breaking-changes/breaking-changes::performance-optimization::54","title":"Breaking Changes Detection","section":"Performance Optimization","path":"/docs/guide/cli/breaking-changes/breaking-changes#performance-optimization","headings":["Performance Optimization"],"excerpt":"Performance Optimization The breaking changes detection in EasyP provides a robust foundation for maintaining API compatibility while allowing your protobuf schemas to evolve safely over time.","content":"Performance Optimization The breaking changes detection in EasyP provides a robust foundation for maintaining API compatibility while allowing your protobuf schemas to evolve safely over time."},{"id":"cli/breaking-changes/rules/enum-no-delete::top::0","title":"ENUM_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":[],"excerpt":"This rule checks that no enums are deleted from proto files. Deleting an enum breaks both wire format compatibility and generated code, as existing data may contain values from the deleted enum and client code depends on","content":"This rule checks that no enums are deleted from proto files. Deleting an enum breaks both wire format compatibility and generated code, as existing data may contain values from the deleted enum and client code depends on the generated enum types."},{"id":"cli/breaking-changes/rules/enum-no-delete::bad::1","title":"ENUM_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::bad::2","title":"ENUM_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#bad","headings":["Bad"],"excerpt":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::bad::3","title":"ENUM_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#bad","headings":["Bad"],"excerpt":"Bad enum UserRole { // [!code --] USER_ROLE_UNSPECIFIED = 0; // [!code --] USER_ROLE_ADMIN = 1; // [!code --] USER_ROLE_USER = 2; // [!code --] } // [!code --]","content":"Bad enum UserRole { // [!code --] USER_ROLE_UNSPECIFIED = 0; // [!code --] USER_ROLE_ADMIN = 1; // [!code --] USER_ROLE_USER = 2; // [!code --] } // [!code --]"},{"id":"cli/breaking-changes/rules/enum-no-delete::bad::4","title":"ENUM_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3; } ```","content":"Bad message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3; } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::bad::5","title":"ENUM_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::bad::6","title":"ENUM_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#bad","headings":["Bad"],"excerpt":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::bad::7","title":"ENUM_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#bad","headings":["Bad"],"excerpt":"Bad // UserRole enum was deleted - BREAKING CHANGE!","content":"Bad // UserRole enum was deleted - BREAKING CHANGE!"},{"id":"cli/breaking-changes/rules/enum-no-delete::bad::8","title":"ENUM_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3; // ERROR: UserRole no longer exists! } ```","content":"Bad message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3; // ERROR: UserRole no longer exists! } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::more-examples::9","title":"ENUM_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples **Nested enum deletion:**","content":"More Examples **Nested enum deletion:**"},{"id":"cli/breaking-changes/rules/enum-no-delete::more-examples::10","title":"ENUM_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before message User { string name = 1; Status status = 2; enum Status { // [!code --] STATUS_UNSPECIFIED = 0; // [!code --] STATUS_ACTIVE = 1; // [!code --] STATUS_INACTIVE = 2; // [!code --] } ","content":"More Examples ```proto // Before message User { string name = 1; Status status = 2; enum Status { // [!code --] STATUS_UNSPECIFIED = 0; // [!code --] STATUS_ACTIVE = 1; // [!code --] STATUS_INACTIVE = 2; // [!code --] } // [!code --] }"},{"id":"cli/breaking-changes/rules/enum-no-delete::more-examples::11","title":"ENUM_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - BREAKING CHANGE! message User { string name = 1; Status status = 2; // ERROR: Status enum deleted // Status nested enum was deleted } ```","content":"More Examples // After - BREAKING CHANGE! message User { string name = 1; Status status = 2; // ERROR: Status enum deleted // Status nested enum was deleted } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::12","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, deprecate the enum:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, deprecate the enum:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::13","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::14","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good enum UserRole { option deprecated = true; // [!code focus] USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_USER = 2; }","content":"Good enum UserRole { option deprecated = true; // [!code focus] USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_USER = 2; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::15","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3 [deprecated = true]; // [!code focus] } ```","content":"Good message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3 [deprecated = true]; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::16","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good **Or replace with new enum:** ```proto syntax = \"proto3\";","content":"Good **Or replace with new enum:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::17","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::18","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good enum UserRole { option deprecated = true; // [!code focus] // Old enum USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_USER = 2; }","content":"Good enum UserRole { option deprecated = true; // [!code focus] // Old enum USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_USER = 2; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::19","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good enum UserPermission { // [!code focus] // New enum with better design USER_PERMISSION_UNSPECIFIED = 0; // [!code focus] USER_PERMISSION_READ = 1; // [!code focus] USER_PERMISSION_WRITE = 2; // [!code focus] USER_PER","content":"Good enum UserPermission { // [!code focus] // New enum with better design USER_PERMISSION_UNSPECIFIED = 0; // [!code focus] USER_PERMISSION_READ = 1; // [!code focus] USER_PERMISSION_WRITE = 2; // [!code focus] USER_PERMISSION_ADMIN = 3; // [!code focus] } // [!code focus]"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::20","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3 [deprecated = true]; // [!code focus] // Old field UserPermission created_by_permission = 4; // [!code focus] // New field } ```","content":"Good message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3 [deprecated = true]; // [!code focus] // Old field UserPermission created_by_permission = 4; // [!code focus] // New field } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::impact::21","title":"ENUM_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Existing data with the deleted enum cannot be deserialized **Generated Code:** Enum types/constants are removed, breaking client compilation **Field References:** Fields using the deleted enum typ","content":"Impact **Wire Format:** Existing data with the deleted enum cannot be deserialized **Generated Code:** Enum types/constants are removed, breaking client compilation **Field References:** Fields using the deleted enum type become invalid **Switch Statements:** Client code with enum switch cases breaks"},{"id":"cli/breaking-changes/rules/enum-no-delete::real-world-example::22","title":"ENUM_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works order := &myapi.Order{ Id: \"order123\", Status: myapi.OrderStatus_ORDER_STATUS_PENDING, CreatedByRole: myapi.UserRole_USER_ROLE_ADMIN, // ERROR ","content":"Real-World Example **Client code breaks:** ```go // Before - this code works order := &myapi.Order{ Id: \"order123\", Status: myapi.OrderStatus_ORDER_STATUS_PENDING, CreatedByRole: myapi.UserRole_USER_ROLE_ADMIN, // ERROR after deletion }"},{"id":"cli/breaking-changes/rules/enum-no-delete::real-world-example::23","title":"ENUM_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Check role switch order.CreatedByRole { case myapi.UserRole_USER_ROLE_ADMIN: // ERROR: undefined type // Admin logic case myapi.UserRole_USER_ROLE_USER: // ERROR: undefined type // User logic }","content":"Real-World Example // Check role switch order.CreatedByRole { case myapi.UserRole_USER_ROLE_ADMIN: // ERROR: undefined type // Admin logic case myapi.UserRole_USER_ROLE_USER: // ERROR: undefined type // User logic }"},{"id":"cli/breaking-changes/rules/enum-no-delete::real-world-example::24","title":"ENUM_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Generated code compilation fails: // undefined: myapi.UserRole // undefined: myapi.UserRole_USER_ROLE_ADMIN ```","content":"Real-World Example // Generated code compilation fails: // undefined: myapi.UserRole // undefined: myapi.UserRole_USER_ROLE_ADMIN ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::real-world-example::25","title":"ENUM_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Existing data becomes unreadable:** ```json // Serialized data before deletion { \"id\": \"order123\", \"status\": \"ORDER_STATUS_PENDING\", \"created_by_role\": \"USER_ROLE_ADMIN\" }","content":"Real-World Example **Existing data becomes unreadable:** ```json // Serialized data before deletion { \"id\": \"order123\", \"status\": \"ORDER_STATUS_PENDING\", \"created_by_role\": \"USER_ROLE_ADMIN\" }"},{"id":"cli/breaking-changes/rules/enum-no-delete::real-world-example::26","title":"ENUM_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After UserRole deletion - deserialization fails // Parser doesn't know how to handle \"created_by_role\" field ```","content":"Real-World Example // After UserRole deletion - deserialization fails // Parser doesn't know how to handle \"created_by_role\" field ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::real-world-example::27","title":"ENUM_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server implementation breaks:**","content":"Real-World Example **Server implementation breaks:**"},{"id":"cli/breaking-changes/rules/enum-no-delete::migration-strategy::28","title":"ENUM_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate the enum first:**","content":"Migration Strategy **Deprecate the enum first:**"},{"id":"cli/breaking-changes/rules/enum-no-delete::migration-strategy::29","title":"ENUM_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Stop using in new fields** and deprecate existing fields:","content":"Migration Strategy **Stop using in new fields** and deprecate existing fields:"},{"id":"cli/breaking-changes/rules/enum-no-delete::migration-strategy::30","title":"ENUM_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Create replacement** if needed:","content":"Migration Strategy **Create replacement** if needed:"},{"id":"cli/breaking-changes/rules/enum-no-delete::migration-strategy::31","title":"ENUM_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update server code** to handle both during transition:","content":"Migration Strategy **Update server code** to handle both during transition:"},{"id":"cli/breaking-changes/rules/enum-no-delete::migration-strategy::32","title":"ENUM_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove after migration period** in a new major version","content":"Migration Strategy **Remove after migration period** in a new major version"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum-redesign::33","title":"ENUM_NO_DELETE","section":"Enum Redesign","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum-redesign","headings":["Enum Redesign"],"excerpt":"Enum Redesign ```proto // Instead of deleting old enum enum Priority { option deprecated = true; // Deprecate old design PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_HIGH = 2; }","content":"Enum Redesign ```proto // Instead of deleting old enum enum Priority { option deprecated = true; // Deprecate old design PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_HIGH = 2; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum-redesign::34","title":"ENUM_NO_DELETE","section":"Enum Redesign","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum-redesign","headings":["Enum Redesign"],"excerpt":"Enum Redesign enum TaskPriority { // Create new enum with better naming TASK_PRIORITY_UNSPECIFIED = 0; TASK_PRIORITY_LOW = 1; TASK_PRIORITY_MEDIUM = 2; TASK_PRIORITY_HIGH = 3; TASK_PRIORITY_URGENT = 4; } ```","content":"Enum Redesign enum TaskPriority { // Create new enum with better naming TASK_PRIORITY_UNSPECIFIED = 0; TASK_PRIORITY_LOW = 1; TASK_PRIORITY_MEDIUM = 2; TASK_PRIORITY_HIGH = 3; TASK_PRIORITY_URGENT = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::consolidating-enums::35","title":"ENUM_NO_DELETE","section":"Consolidating Enums","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#consolidating-enums","headings":["Consolidating Enums"],"excerpt":"Consolidating Enums ```proto // Instead of deleting multiple enums enum Status { option deprecated = true; // Keep old enum STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; }","content":"Consolidating Enums ```proto // Instead of deleting multiple enums enum Status { option deprecated = true; // Keep old enum STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::consolidating-enums::36","title":"ENUM_NO_DELETE","section":"Consolidating Enums","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#consolidating-enums","headings":["Consolidating Enums"],"excerpt":"Consolidating Enums enum State { option deprecated = true; // Keep old enum STATE_UNSPECIFIED = 0; STATE_ENABLED = 1; }","content":"Consolidating Enums enum State { option deprecated = true; // Keep old enum STATE_UNSPECIFIED = 0; STATE_ENABLED = 1; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::consolidating-enums::37","title":"ENUM_NO_DELETE","section":"Consolidating Enums","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#consolidating-enums","headings":["Consolidating Enums"],"excerpt":"Consolidating Enums enum EntityStatus { // New consolidated enum ENTITY_STATUS_UNSPECIFIED = 0; ENTITY_STATUS_ACTIVE = 1; ENTITY_STATUS_INACTIVE = 2; ENTITY_STATUS_ENABLED = 3; ENTITY_STATUS_DISABLED = 4; } ```","content":"Consolidating Enums enum EntityStatus { // New consolidated enum ENTITY_STATUS_UNSPECIFIED = 0; ENTITY_STATUS_ACTIVE = 1; ENTITY_STATUS_INACTIVE = 2; ENTITY_STATUS_ENABLED = 3; ENTITY_STATUS_DISABLED = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::moving-enum-to-different-package::38","title":"ENUM_NO_DELETE","section":"Moving Enum to Different Package","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#moving-enum-to-different-package","headings":["Moving Enum to Different Package"],"excerpt":"Moving Enum to Different Package ```proto // Instead of deleting from current package enum UserRole { option deprecated = true; // Mark as deprecated USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; }","content":"Moving Enum to Different Package ```proto // Instead of deleting from current package enum UserRole { option deprecated = true; // Mark as deprecated USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::moving-enum-to-different-package::39","title":"ENUM_NO_DELETE","section":"Moving Enum to Different Package","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#moving-enum-to-different-package","headings":["Moving Enum to Different Package"],"excerpt":"Moving Enum to Different Package // Import from new location import \"common/roles.proto\";","content":"Moving Enum to Different Package // Import from new location import \"common/roles.proto\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::moving-enum-to-different-package::40","title":"ENUM_NO_DELETE","section":"Moving Enum to Different Package","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#moving-enum-to-different-package","headings":["Moving Enum to Different Package"],"excerpt":"Moving Enum to Different Package message Order { UserRole old_role = 3 [deprecated = true]; common.UserRole new_role = 4; // Reference from new package } ```","content":"Moving Enum to Different Package message Order { UserRole old_role = 3 [deprecated = true]; common.UserRole new_role = 4; // Reference from new package } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::version-migration::41","title":"ENUM_NO_DELETE","section":"Version Migration","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#version-migration","headings":["Version Migration"],"excerpt":"Version Migration ```proto // Clean approach - new package version package myapi.v2;","content":"Version Migration ```proto // Clean approach - new package version package myapi.v2;"},{"id":"cli/breaking-changes/rules/enum-no-delete::version-migration::42","title":"ENUM_NO_DELETE","section":"Version Migration","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#version-migration","headings":["Version Migration"],"excerpt":"Version Migration // Redesigned enums without deprecated ones enum UserPermission { USER_PERMISSION_UNSPECIFIED = 0; USER_PERMISSION_READ = 1; USER_PERMISSION_WRITE = 2; USER_PERMISSION_ADMIN = 3; }","content":"Version Migration // Redesigned enums without deprecated ones enum UserPermission { USER_PERMISSION_UNSPECIFIED = 0; USER_PERMISSION_READ = 1; USER_PERMISSION_WRITE = 2; USER_PERMISSION_ADMIN = 3; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::version-migration::43","title":"ENUM_NO_DELETE","section":"Version Migration","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#version-migration","headings":["Version Migration"],"excerpt":"Version Migration message Order { string id = 1; UserPermission created_by_permission = 2; // Clean design in v2 } ```","content":"Version Migration message Order { string id = 1; UserPermission created_by_permission = 2; // Clean design in v2 } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::0","title":"ENUM_VALUE_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":[],"excerpt":"This rule checks that no enum values are deleted from enums. Deleting an enum value breaks both wire format compatibility and generated code, as existing data may contain the deleted enum value and client code may refere","content":"This rule checks that no enum values are deleted from enums. Deleting an enum value breaks both wire format compatibility and generated code, as existing data may contain the deleted enum value and client code may reference the generated constants."},{"id":"cli/breaking-changes/rules/enum-value-no-delete::bad::1","title":"ENUM_VALUE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::bad::2","title":"ENUM_VALUE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#bad","headings":["Bad"],"excerpt":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; ORDER_STATUS_CANCELLED = 5; }","content":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; ORDER_STATUS_CANCELLED = 5; }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::bad::3","title":"ENUM_VALUE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#bad","headings":["Bad"],"excerpt":"Bad enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; PRIORITY_URGENT = 4; } ```","content":"Bad enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; PRIORITY_URGENT = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::bad::4","title":"ENUM_VALUE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::bad::5","title":"ENUM_VALUE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#bad","headings":["Bad"],"excerpt":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; // ORDER_STATUS_CANCELLED = 5; // [!code --] Deleted enum v","content":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; // ORDER_STATUS_CANCELLED = 5; // [!code --] Deleted enum value - BREAKING! }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::bad::6","title":"ENUM_VALUE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#bad","headings":["Bad"],"excerpt":"Bad enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; // PRIORITY_URGENT = 4; // [!code --] Deleted enum value - BREAKING! } ```","content":"Bad enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; // PRIORITY_URGENT = 4; // [!code --] Deleted enum value - BREAKING! } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::more-examples::7","title":"ENUM_VALUE_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples **Multiple value deletions:**","content":"More Examples **Multiple value deletions:**"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::more-examples::8","title":"ENUM_VALUE_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_GUEST = 1; USER_ROLE_USER = 2; USER_ROLE_MODERATOR = 3; USER_ROLE_ADMIN = 4; USER_ROLE_SUPERADMIN = 5; }","content":"More Examples ```proto // Before enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_GUEST = 1; USER_ROLE_USER = 2; USER_ROLE_MODERATOR = 3; USER_ROLE_ADMIN = 4; USER_ROLE_SUPERADMIN = 5; }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::more-examples::9","title":"ENUM_VALUE_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - BREAKING CHANGES! enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_USER = 2; USER_ROLE_ADMIN = 4; // USER_ROLE_GUEST = 1; // BREAKING: deleted // USER_ROLE_MODERATOR = 3; // BREAKING: deleted","content":"More Examples // After - BREAKING CHANGES! enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_USER = 2; USER_ROLE_ADMIN = 4; // USER_ROLE_GUEST = 1; // BREAKING: deleted // USER_ROLE_MODERATOR = 3; // BREAKING: deleted // USER_ROLE_SUPERADMIN = 5; // BREAKING: deleted } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::good::10","title":"ENUM_VALUE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, deprecate the enum values:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, deprecate the enum values:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::good::11","title":"ENUM_VALUE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#good","headings":["Good"],"excerpt":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; ORDER_STATUS_CANCELLED = 5 [deprecated = true]; // [!code ","content":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; ORDER_STATUS_CANCELLED = 5 [deprecated = true]; // [!code focus] }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::good::12","title":"ENUM_VALUE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#good","headings":["Good"],"excerpt":"Good enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; PRIORITY_URGENT = 4 [deprecated = true]; // [!code focus] } ```","content":"Good enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; PRIORITY_URGENT = 4 [deprecated = true]; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::good::13","title":"ENUM_VALUE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#good","headings":["Good"],"excerpt":"Good **Or reserve the enum values after removal:** ```proto syntax = \"proto3\";","content":"Good **Or reserve the enum values after removal:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::good::14","title":"ENUM_VALUE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#good","headings":["Good"],"excerpt":"Good enum OrderStatus { reserved 5; // [!code focus] reserved \"ORDER_STATUS_CANCELLED\"; // [!code focus] ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER","content":"Good enum OrderStatus { reserved 5; // [!code focus] reserved \"ORDER_STATUS_CANCELLED\"; // [!code focus] ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::good::15","title":"ENUM_VALUE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#good","headings":["Good"],"excerpt":"Good enum Priority { reserved 4; // [!code focus] reserved \"PRIORITY_URGENT\"; // [!code focus] PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; } ```","content":"Good enum Priority { reserved 4; // [!code focus] reserved \"PRIORITY_URGENT\"; // [!code focus] PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::impact::16","title":"ENUM_VALUE_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Existing data with deleted enum values cannot be properly deserialized **Generated Code:** Enum constants are removed, breaking client compilation **Client Applications:** Code referencing deleted","content":"Impact **Wire Format:** Existing data with deleted enum values cannot be properly deserialized **Generated Code:** Enum constants are removed, breaking client compilation **Client Applications:** Code referencing deleted enum values fails to compile **Switch Statements:** Case statements for deleted values cause compilation errors **Default Handling:** Unknown enum values may be handled differently"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::real-world-example::17","title":"ENUM_VALUE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works order := &myapi.Order{ Status: myapi.OrderStatus_ORDER_STATUS_CANCELLED, // ERROR after deletion }","content":"Real-World Example **Client code breaks:** ```go // Before - this code works order := &myapi.Order{ Status: myapi.OrderStatus_ORDER_STATUS_CANCELLED, // ERROR after deletion }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::real-world-example::18","title":"ENUM_VALUE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Switch statement breaks switch order.Status { case myapi.OrderStatus_ORDER_STATUS_PENDING: // Handle pending case myapi.OrderStatus_ORDER_STATUS_CANCELLED: // ERROR: undefined constant // Handle can","content":"Real-World Example // Switch statement breaks switch order.Status { case myapi.OrderStatus_ORDER_STATUS_PENDING: // Handle pending case myapi.OrderStatus_ORDER_STATUS_CANCELLED: // ERROR: undefined constant // Handle cancellation default: // Handle unknown }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::real-world-example::19","title":"ENUM_VALUE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Generated code compilation fails: // undefined: myapi.OrderStatus_ORDER_STATUS_CANCELLED ```","content":"Real-World Example // Generated code compilation fails: // undefined: myapi.OrderStatus_ORDER_STATUS_CANCELLED ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::real-world-example::20","title":"ENUM_VALUE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Existing data becomes problematic:** ```json // Serialized data before deletion { \"id\": \"order123\", \"status\": \"ORDER_STATUS_CANCELLED\" }","content":"Real-World Example **Existing data becomes problematic:** ```json // Serialized data before deletion { \"id\": \"order123\", \"status\": \"ORDER_STATUS_CANCELLED\" }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::real-world-example::21","title":"ENUM_VALUE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After enum value deletion // Data deserializes but status becomes UNSPECIFIED (0) // or causes parsing errors depending on implementation ```","content":"Real-World Example // After enum value deletion // Data deserializes but status becomes UNSPECIFIED (0) // or causes parsing errors depending on implementation ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::real-world-example::22","title":"ENUM_VALUE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server validation breaks:** ```go // Before - server handles all enum values func validateOrderStatus(status OrderStatus) error { switch status { case OrderStatus_ORDER_STATUS_PENDING, OrderStatus_OR","content":"Real-World Example **Server validation breaks:** ```go // Before - server handles all enum values func validateOrderStatus(status OrderStatus) error { switch status { case OrderStatus_ORDER_STATUS_PENDING, OrderStatus_ORDER_STATUS_CONFIRMED, OrderStatus_ORDER_STATUS_SHIPPED, OrderStatus_ORDER_STATUS_DELIVERED, OrderStatus_ORDER_STATUS_CANCELLED: // ERROR: undefined return nil default: return errors.New(\"invalid order status\") } }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::real-world-example::23","title":"ENUM_VALUE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Server logic that depends on cancelled status func canModifyOrder(order *Order) bool { return order.Status != OrderStatus_ORDER_STATUS_CANCELLED // ERROR: undefined } ```","content":"Real-World Example // Server logic that depends on cancelled status func canModifyOrder(order *Order) bool { return order.Status != OrderStatus_ORDER_STATUS_CANCELLED // ERROR: undefined } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::migration-strategy::24","title":"ENUM_VALUE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate enum values first:**","content":"Migration Strategy **Deprecate enum values first:**"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::migration-strategy::25","title":"ENUM_VALUE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Stop using deprecated values** in new code:","content":"Migration Strategy **Stop using deprecated values** in new code:"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::migration-strategy::26","title":"ENUM_VALUE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update client code** to handle deprecated values gracefully:","content":"Migration Strategy **Update client code** to handle deprecated values gracefully:"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::migration-strategy::27","title":"ENUM_VALUE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Reserve the values** after sufficient migration period:","content":"Migration Strategy **Reserve the values** after sufficient migration period:"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::migration-strategy::28","title":"ENUM_VALUE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Never reuse enum numbers** - they must remain reserved permanently","content":"Migration Strategy **Never reuse enum numbers** - they must remain reserved permanently"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::proto2-vs-proto3-behavior::29","title":"ENUM_VALUE_NO_DELETE","section":"Proto2 vs Proto3 Behavior","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#proto2-vs-proto3-behavior","headings":["Proto2 vs Proto3 Behavior"],"excerpt":"Proto2 vs Proto3 Behavior ```proto // Proto2: Unknown enum values are preserved in unknown fields // Proto3: Unknown enum values are preserved as-is // Both cases: Don't delete values that might exist in stored data","content":"Proto2 vs Proto3 Behavior ```proto // Proto2: Unknown enum values are preserved in unknown fields // Proto3: Unknown enum values are preserved as-is // Both cases: Don't delete values that might exist in stored data"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::proto2-vs-proto3-behavior::30","title":"ENUM_VALUE_NO_DELETE","section":"Proto2 vs Proto3 Behavior","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#proto2-vs-proto3-behavior","headings":["Proto2 vs Proto3 Behavior"],"excerpt":"Proto2 vs Proto3 Behavior // Safe approach for both syntax versions: enum MyEnum { MY_ENUM_UNSPECIFIED = 0; MY_ENUM_VALUE_OLD = 1 [deprecated = true]; // Don't delete MY_ENUM_VALUE_NEW = 2; } ```","content":"Proto2 vs Proto3 Behavior // Safe approach for both syntax versions: enum MyEnum { MY_ENUM_UNSPECIFIED = 0; MY_ENUM_VALUE_OLD = 1 [deprecated = true]; // Don't delete MY_ENUM_VALUE_NEW = 2; } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::0","title":"ENUM_VALUE_SAME_NAME","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":[],"excerpt":"This rule checks that enum values maintain the same name for each number. Changing an enum value's name (while keeping the same number) breaks both JSON compatibility and generated code, as clients expect specific consta","content":"This rule checks that enum values maintain the same name for each number. Changing an enum value's name (while keeping the same number) breaks both JSON compatibility and generated code, as clients expect specific constant names."},{"id":"cli/breaking-changes/rules/enum-value-same-name::bad::1","title":"ENUM_VALUE_SAME_NAME","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-same-name::bad::2","title":"ENUM_VALUE_SAME_NAME","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#bad","headings":["Bad"],"excerpt":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; } ```","content":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::bad::3","title":"ENUM_VALUE_SAME_NAME","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-same-name::bad::4","title":"ENUM_VALUE_SAME_NAME","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#bad","headings":["Bad"],"excerpt":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_APPROVED = 2; // [!code --] Changed from ORDER_STATUS_CONFIRMED ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_COMPLETED = 4; // [!code ","content":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_APPROVED = 2; // [!code --] Changed from ORDER_STATUS_CONFIRMED ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_COMPLETED = 4; // [!code --] Changed from ORDER_STATUS_DELIVERED } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::more-examples::5","title":"ENUM_VALUE_SAME_NAME","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#more-examples","headings":["More Examples"],"excerpt":"More Examples **Multiple renames breaking clients:**","content":"More Examples **Multiple renames breaking clients:**"},{"id":"cli/breaking-changes/rules/enum-value-same-name::more-examples::6","title":"ENUM_VALUE_SAME_NAME","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_MODERATOR = 2; USER_ROLE_USER = 3; }","content":"More Examples ```proto // Before enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_MODERATOR = 2; USER_ROLE_USER = 3; }"},{"id":"cli/breaking-changes/rules/enum-value-same-name::more-examples::7","title":"ENUM_VALUE_SAME_NAME","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - ALL BREAKING CHANGES! enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMINISTRATOR = 1; // BREAKING: ADMIN -> ADMINISTRATOR USER_ROLE_MOD = 2; // BREAKING: MODERATOR -> MOD USER_ROLE_MEMBER","content":"More Examples // After - ALL BREAKING CHANGES! enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMINISTRATOR = 1; // BREAKING: ADMIN -> ADMINISTRATOR USER_ROLE_MOD = 2; // BREAKING: MODERATOR -> MOD USER_ROLE_MEMBER = 3; // BREAKING: USER -> MEMBER } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::good::8","title":"ENUM_VALUE_SAME_NAME","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#good","headings":["Good"],"excerpt":"Good **Instead of renaming, add new values and deprecate old ones:** ```proto syntax = \"proto3\";","content":"Good **Instead of renaming, add new values and deprecate old ones:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-same-name::good::9","title":"ENUM_VALUE_SAME_NAME","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#good","headings":["Good"],"excerpt":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2 [deprecated = true]; // [!code focus] ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4 [deprecated = true]; /","content":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2 [deprecated = true]; // [!code focus] ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4 [deprecated = true]; // [!code focus] ORDER_STATUS_APPROVED = 5; // [!code focus] // New value instead of renaming ORDER_STATUS_COMPLETED = 6; // [!code focus] // New value instead of renaming } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::good::10","title":"ENUM_VALUE_SAME_NAME","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#good","headings":["Good"],"excerpt":"Good **Or create a new enum version:** ```proto syntax = \"proto3\";","content":"Good **Or create a new enum version:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-same-name::good::11","title":"ENUM_VALUE_SAME_NAME","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#good","headings":["Good"],"excerpt":"Good package myapi.v2; // [!code focus] // New package version","content":"Good package myapi.v2; // [!code focus] // New package version"},{"id":"cli/breaking-changes/rules/enum-value-same-name::good::12","title":"ENUM_VALUE_SAME_NAME","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#good","headings":["Good"],"excerpt":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_APPROVED = 2; // [!code focus] // Clean names in v2 ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_COMPLETED = 4; // [!code focus] } ``","content":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_APPROVED = 2; // [!code focus] // Clean names in v2 ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_COMPLETED = 4; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::impact::13","title":"ENUM_VALUE_SAME_NAME","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#impact","headings":["Impact"],"excerpt":"Impact **Generated Code:** Constant names change, breaking client compilation **JSON Compatibility:** JSON serialization uses enum names, breaking parsers **Client Applications:** Code referencing old constant names fail","content":"Impact **Generated Code:** Constant names change, breaking client compilation **JSON Compatibility:** JSON serialization uses enum names, breaking parsers **Client Applications:** Code referencing old constant names fails to compile **Documentation:** API docs become outdated with wrong enum names"},{"id":"cli/breaking-changes/rules/enum-value-same-name::real-world-example::14","title":"ENUM_VALUE_SAME_NAME","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // handle delivery }","content":"Real-World Example **Client code breaks:** ```go // Before - this code works status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // handle delivery }"},{"id":"cli/breaking-changes/rules/enum-value-same-name::real-world-example::15","title":"ENUM_VALUE_SAME_NAME","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After rename - compilation fails status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED // ERROR: undefined constant if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // ERROR: undefined con","content":"Real-World Example // After rename - compilation fails status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED // ERROR: undefined constant if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // ERROR: undefined constant // handle delivery } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::real-world-example::16","title":"ENUM_VALUE_SAME_NAME","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **JSON compatibility breaks:** ```json // Before - JSON uses old names { \"status\": \"ORDER_STATUS_CONFIRMED\" }","content":"Real-World Example **JSON compatibility breaks:** ```json // Before - JSON uses old names { \"status\": \"ORDER_STATUS_CONFIRMED\" }"},{"id":"cli/breaking-changes/rules/enum-value-same-name::real-world-example::17","title":"ENUM_VALUE_SAME_NAME","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After - parser expects new names { \"status\": \"ORDER_STATUS_APPROVED\" // Old JSON fails to parse } ```","content":"Real-World Example // After - parser expects new names { \"status\": \"ORDER_STATUS_APPROVED\" // Old JSON fails to parse } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::migration-strategy::18","title":"ENUM_VALUE_SAME_NAME","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Add new enum values** instead of renaming:","content":"Migration Strategy **Add new enum values** instead of renaming:"},{"id":"cli/breaking-changes/rules/enum-value-same-name::migration-strategy::19","title":"ENUM_VALUE_SAME_NAME","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update server code** to handle both old and new values during transition","content":"Migration Strategy **Update server code** to handle both old and new values during transition"},{"id":"cli/breaking-changes/rules/enum-value-same-name::migration-strategy::20","title":"ENUM_VALUE_SAME_NAME","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Migrate clients** to use new enum values","content":"Migration Strategy **Migrate clients** to use new enum values"},{"id":"cli/breaking-changes/rules/enum-value-same-name::migration-strategy::21","title":"ENUM_VALUE_SAME_NAME","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove deprecated values** in next major version:","content":"Migration Strategy **Remove deprecated values** in next major version:"},{"id":"cli/breaking-changes/rules/enum-value-same-name::allow-alias-exception::22","title":"ENUM_VALUE_SAME_NAME","section":"Allow Alias Exception","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#allow-alias-exception","headings":["Allow Alias Exception"],"excerpt":"Allow Alias Exception With allow_alias = true, you can temporarily have multiple names for the same value:","content":"Allow Alias Exception With allow_alias = true, you can temporarily have multiple names for the same value:"},{"id":"cli/breaking-changes/rules/enum-value-same-name::allow-alias-exception::23","title":"ENUM_VALUE_SAME_NAME","section":"Allow Alias Exception","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#allow-alias-exception","headings":["Allow Alias Exception"],"excerpt":"Allow Alias Exception Note: EasyP currently detects this as breaking even with allow_alias. This may be refined in future versions.","content":"Allow Alias Exception Note: EasyP currently detects this as breaking even with allow_alias. This may be refined in future versions."},{"id":"cli/breaking-changes/rules/field-no-delete::top::0","title":"FIELD_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":[],"excerpt":"This rule checks that no message fields are deleted. Deleting a field breaks both wire format compatibility and generated code, as existing data may contain the deleted field and client code may reference it.","content":"This rule checks that no message fields are deleted. Deleting a field breaks both wire format compatibility and generated code, as existing data may contain the deleted field and client code may reference it."},{"id":"cli/breaking-changes/rules/field-no-delete::bad::1","title":"FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-no-delete::bad::2","title":"FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#bad","headings":["Bad"],"excerpt":"Bad message User { string name = 1; string email = 2; int32 age = 3; string phone = 4; // [!code --] } ```","content":"Bad message User { string name = 1; string email = 2; int32 age = 3; string phone = 4; // [!code --] } ```"},{"id":"cli/breaking-changes/rules/field-no-delete::bad::3","title":"FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-no-delete::bad::4","title":"FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#bad","headings":["Bad"],"excerpt":"Bad message User { string name = 1; string email = 2; int32 age = 3; // phone field was deleted - BREAKING CHANGE! } ```","content":"Bad message User { string name = 1; string email = 2; int32 age = 3; // phone field was deleted - BREAKING CHANGE! } ```"},{"id":"cli/breaking-changes/rules/field-no-delete::good::5","title":"FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, deprecate the field:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, deprecate the field:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-no-delete::good::6","title":"FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#good","headings":["Good"],"excerpt":"Good message User { string name = 1; string email = 2; int32 age = 3; string phone = 4 [deprecated = true]; // [!code focus] } ```","content":"Good message User { string name = 1; string email = 2; int32 age = 3; string phone = 4 [deprecated = true]; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/field-no-delete::good::7","title":"FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#good","headings":["Good"],"excerpt":"Good **Or reserve the field number after removal:** ```proto syntax = \"proto3\";","content":"Good **Or reserve the field number after removal:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-no-delete::good::8","title":"FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#good","headings":["Good"],"excerpt":"Good message User { reserved 4; // [!code focus] reserved \"phone\"; // [!code focus] string name = 1; string email = 2; int32 age = 3; } ```","content":"Good message User { reserved 4; // [!code focus] reserved \"phone\"; // [!code focus] string name = 1; string email = 2; int32 age = 3; } ```"},{"id":"cli/breaking-changes/rules/field-no-delete::impact::9","title":"FIELD_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Old messages with the deleted field cannot be properly deserialized **Generated Code:** Field accessors are removed, breaking client compilation **Data Loss:** Existing serialized data loses infor","content":"Impact **Wire Format:** Old messages with the deleted field cannot be properly deserialized **Generated Code:** Field accessors are removed, breaking client compilation **Data Loss:** Existing serialized data loses information **JSON Compatibility:** JSON parsers expect the field to exist"},{"id":"cli/breaking-changes/rules/field-no-delete::migration-strategy::10","title":"FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate first:**","content":"Migration Strategy **Deprecate first:**"},{"id":"cli/breaking-changes/rules/field-no-delete::migration-strategy::11","title":"FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Stop writing to the field** in your application code","content":"Migration Strategy **Stop writing to the field** in your application code"},{"id":"cli/breaking-changes/rules/field-no-delete::migration-strategy::12","title":"FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Reserve the field** in next version to prevent accidental reuse:","content":"Migration Strategy **Reserve the field** in next version to prevent accidental reuse:"},{"id":"cli/breaking-changes/rules/field-no-delete::migration-strategy::13","title":"FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Never reuse field numbers** - they must remain reserved permanently","content":"Migration Strategy **Never reuse field numbers** - they must remain reserved permanently"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::0","title":"FIELD_SAME_CARDINALITY","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":[],"excerpt":"This rule checks that message fields maintain the same cardinality (optionality). Changing a field's cardinality breaks both wire format compatibility and generated code, as the presence semantics and client code expecta","content":"This rule checks that message fields maintain the same cardinality (optionality). Changing a field's cardinality breaks both wire format compatibility and generated code, as the presence semantics and client code expectations differ between optional and required fields."},{"id":"cli/breaking-changes/rules/field-same-cardinality::bad::1","title":"FIELD_SAME_CARDINALITY","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::bad::2","title":"FIELD_SAME_CARDINALITY","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#bad","headings":["Bad"],"excerpt":"Bad message User { string name = 1; string email = 2; int32 age = 3; }","content":"Bad message User { string name = 1; string email = 2; int32 age = 3; }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::bad::3","title":"FIELD_SAME_CARDINALITY","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#bad","headings":["Bad"],"excerpt":"Bad message CreateUserRequest { string name = 1; optional string email = 2; string phone = 3; } ```","content":"Bad message CreateUserRequest { string name = 1; optional string email = 2; string phone = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::bad::4","title":"FIELD_SAME_CARDINALITY","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::bad::5","title":"FIELD_SAME_CARDINALITY","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#bad","headings":["Bad"],"excerpt":"Bad message User { string name = 1; optional string email = 2; // [!code --] Changed from required to optional int32 age = 3; }","content":"Bad message User { string name = 1; optional string email = 2; // [!code --] Changed from required to optional int32 age = 3; }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::bad::6","title":"FIELD_SAME_CARDINALITY","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#bad","headings":["Bad"],"excerpt":"Bad message CreateUserRequest { string name = 1; string email = 2; // [!code --] Changed from optional to required string phone = 3; } ```","content":"Bad message CreateUserRequest { string name = 1; string email = 2; // [!code --] Changed from optional to required string phone = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::more-examples::7","title":"FIELD_SAME_CARDINALITY","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#more-examples","headings":["More Examples"],"excerpt":"More Examples **Proto2 to Proto3 migration issues:**","content":"More Examples **Proto2 to Proto3 migration issues:**"},{"id":"cli/breaking-changes/rules/field-same-cardinality::more-examples::8","title":"FIELD_SAME_CARDINALITY","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before (proto2) syntax = \"proto2\";","content":"More Examples ```proto // Before (proto2) syntax = \"proto2\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::more-examples::9","title":"FIELD_SAME_CARDINALITY","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#more-examples","headings":["More Examples"],"excerpt":"More Examples message Order { required string id = 1; optional string notes = 2; repeated string tags = 3; }","content":"More Examples message Order { required string id = 1; optional string notes = 2; repeated string tags = 3; }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::more-examples::10","title":"FIELD_SAME_CARDINALITY","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#more-examples","headings":["More Examples"],"excerpt":"More Examples // After (proto3) - BREAKING CHANGES! syntax = \"proto3\";","content":"More Examples // After (proto3) - BREAKING CHANGES! syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::more-examples::11","title":"FIELD_SAME_CARDINALITY","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#more-examples","headings":["More Examples"],"excerpt":"More Examples message Order { string id = 1; // BREAKING: required -> implicit optional string notes = 2; // BREAKING: explicit optional -> implicit optional repeated string tags = 3; // OK: repeated unchanged } ```","content":"More Examples message Order { string id = 1; // BREAKING: required -> implicit optional string notes = 2; // BREAKING: explicit optional -> implicit optional repeated string tags = 3; // OK: repeated unchanged } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::good::12","title":"FIELD_SAME_CARDINALITY","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#good","headings":["Good"],"excerpt":"Good **Instead of changing cardinality, add new field:** ```proto syntax = \"proto3\";","content":"Good **Instead of changing cardinality, add new field:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::good::13","title":"FIELD_SAME_CARDINALITY","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#good","headings":["Good"],"excerpt":"Good message User { string name = 1; string email = 2 [deprecated = true]; // [!code focus] // Keep original cardinality int32 age = 3; optional string email_optional = 4; // [!code focus] // New field with desired cardi","content":"Good message User { string name = 1; string email = 2 [deprecated = true]; // [!code focus] // Keep original cardinality int32 age = 3; optional string email_optional = 4; // [!code focus] // New field with desired cardinality }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::good::14","title":"FIELD_SAME_CARDINALITY","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#good","headings":["Good"],"excerpt":"Good message CreateUserRequest { string name = 1; optional string email = 2 [deprecated = true]; // [!code focus] // Keep original cardinality string phone = 3; string email_required = 4; // [!code focus] // New field wi","content":"Good message CreateUserRequest { string name = 1; optional string email = 2 [deprecated = true]; // [!code focus] // Keep original cardinality string phone = 3; string email_required = 4; // [!code focus] // New field with desired cardinality } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::good::15","title":"FIELD_SAME_CARDINALITY","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#good","headings":["Good"],"excerpt":"Good **Or create a new message version:** ```proto syntax = \"proto3\";","content":"Good **Or create a new message version:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::good::16","title":"FIELD_SAME_CARDINALITY","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#good","headings":["Good"],"excerpt":"Good package myapi.v2; // [!code focus] // New package version","content":"Good package myapi.v2; // [!code focus] // New package version"},{"id":"cli/breaking-changes/rules/field-same-cardinality::good::17","title":"FIELD_SAME_CARDINALITY","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#good","headings":["Good"],"excerpt":"Good message User { string name = 1; optional string email = 2; // [!code focus] // Clean cardinality in v2 int32 age = 3; }","content":"Good message User { string name = 1; optional string email = 2; // [!code focus] // Clean cardinality in v2 int32 age = 3; }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::good::18","title":"FIELD_SAME_CARDINALITY","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#good","headings":["Good"],"excerpt":"Good message CreateUserRequest { string name = 1; string email = 2; // [!code focus] // Required in v2 string phone = 3; } ```","content":"Good message CreateUserRequest { string name = 1; string email = 2; // [!code focus] // Required in v2 string phone = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::impact::19","title":"FIELD_SAME_CARDINALITY","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Field presence semantics change, breaking deserialization expectations **Generated Code:** Field accessor methods change (hasField(), clearField()) **Validation:** Required field validation change","content":"Impact **Wire Format:** Field presence semantics change, breaking deserialization expectations **Generated Code:** Field accessor methods change (hasField(), clearField()) **Validation:** Required field validation changes at runtime **Default Values:** Optional vs required fields handle defaults differently"},{"id":"cli/breaking-changes/rules/field-same-cardinality::real-world-example::20","title":"FIELD_SAME_CARDINALITY","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks with cardinality changes:** ```go // Before - required field (proto3 implicit) user := &myapi.User{ Name: \"John\", Email: \"john@example.com\", // Must be set Age: 30, }","content":"Real-World Example **Client code breaks with cardinality changes:** ```go // Before - required field (proto3 implicit) user := &myapi.User{ Name: \"John\", Email: \"john@example.com\", // Must be set Age: 30, }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::real-world-example::21","title":"FIELD_SAME_CARDINALITY","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Check if email is set (implicit presence) if user.Email != \"\" { // Email is provided }","content":"Real-World Example // Check if email is set (implicit presence) if user.Email != \"\" { // Email is provided }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::real-world-example::22","title":"FIELD_SAME_CARDINALITY","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After - optional field (explicit presence) user := &myapi.User{ Name: \"John\", Age: 30, // Email can be nil/unset }","content":"Real-World Example // After - optional field (explicit presence) user := &myapi.User{ Name: \"John\", Age: 30, // Email can be nil/unset }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::real-world-example::23","title":"FIELD_SAME_CARDINALITY","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Check if email is set (explicit presence) if user.Email != nil && *user.Email != \"\" { // Different API! // Email is provided }","content":"Real-World Example // Check if email is set (explicit presence) if user.Email != nil && *user.Email != \"\" { // Different API! // Email is provided }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::real-world-example::24","title":"FIELD_SAME_CARDINALITY","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Setting email also changes user.Email = &emailValue // Pointer assignment vs direct ```","content":"Real-World Example // Setting email also changes user.Email = &emailValue // Pointer assignment vs direct ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::real-world-example::25","title":"FIELD_SAME_CARDINALITY","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server validation breaks:** ```go // Before - implicit required field func validateUser(user *User) error { if user.Email == \"\" { // Empty string check return errors.New(\"email is required\") } return","content":"Real-World Example **Server validation breaks:** ```go // Before - implicit required field func validateUser(user *User) error { if user.Email == \"\" { // Empty string check return errors.New(\"email is required\") } return nil }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::real-world-example::26","title":"FIELD_SAME_CARDINALITY","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After - explicit optional field func validateUser(user *User) error { if user.Email == nil { // Nil pointer check return errors.New(\"email is required\") } if *user.Email == \"\" { // Dereference to ch","content":"Real-World Example // After - explicit optional field func validateUser(user *User) error { if user.Email == nil { // Nil pointer check return errors.New(\"email is required\") } if *user.Email == \"\" { // Dereference to check empty return errors.New(\"email cannot be empty\") } return nil } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::migration-strategy::27","title":"FIELD_SAME_CARDINALITY","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Add new field** with correct cardinality:","content":"Migration Strategy **Add new field** with correct cardinality:"},{"id":"cli/breaking-changes/rules/field-same-cardinality::migration-strategy::28","title":"FIELD_SAME_CARDINALITY","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Dual-write period** - populate both fields during transition:","content":"Migration Strategy **Dual-write period** - populate both fields during transition:"},{"id":"cli/breaking-changes/rules/field-same-cardinality::migration-strategy::29","title":"FIELD_SAME_CARDINALITY","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update clients** to use new field gradually:","content":"Migration Strategy **Update clients** to use new field gradually:"},{"id":"cli/breaking-changes/rules/field-same-cardinality::migration-strategy::30","title":"FIELD_SAME_CARDINALITY","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove old field** in next major version:","content":"Migration Strategy **Remove old field** in next major version:"},{"id":"cli/breaking-changes/rules/field-same-cardinality::proto2-to-proto3-migration::31","title":"FIELD_SAME_CARDINALITY","section":"Proto2 to Proto3 Migration","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#proto2-to-proto3-migration","headings":["Proto2 to Proto3 Migration"],"excerpt":"Proto2 to Proto3 Migration ```proto // Instead of direct syntax migration syntax = \"proto3\"; message Order { string id = 1; // BREAKING: was required in proto2 }","content":"Proto2 to Proto3 Migration ```proto // Instead of direct syntax migration syntax = \"proto3\"; message Order { string id = 1; // BREAKING: was required in proto2 }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::proto2-to-proto3-migration::32","title":"FIELD_SAME_CARDINALITY","section":"Proto2 to Proto3 Migration","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#proto2-to-proto3-migration","headings":["Proto2 to Proto3 Migration"],"excerpt":"Proto2 to Proto3 Migration // Maintain semantics during migration syntax = \"proto3\"; message Order { string id = 1; // Keep as implicit required // Add explicit optional fields only when needed optional string notes = 2;","content":"Proto2 to Proto3 Migration // Maintain semantics during migration syntax = \"proto3\"; message Order { string id = 1; // Keep as implicit required // Add explicit optional fields only when needed optional string notes = 2; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::making-optional-fields-required::33","title":"FIELD_SAME_CARDINALITY","section":"Making Optional Fields Required","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#making-optional-fields-required","headings":["Making Optional Fields Required"],"excerpt":"Making Optional Fields Required ```proto // Instead of changing existing field message CreateUserRequest { string name = 1; string email = 2; // BREAKING: was optional }","content":"Making Optional Fields Required ```proto // Instead of changing existing field message CreateUserRequest { string name = 1; string email = 2; // BREAKING: was optional }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::making-optional-fields-required::34","title":"FIELD_SAME_CARDINALITY","section":"Making Optional Fields Required","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#making-optional-fields-required","headings":["Making Optional Fields Required"],"excerpt":"Making Optional Fields Required // Add new required field message CreateUserRequest { string name = 1; optional string email = 2 [deprecated = true]; string required_email = 3; // New required field } ```","content":"Making Optional Fields Required // Add new required field message CreateUserRequest { string name = 1; optional string email = 2 [deprecated = true]; string required_email = 3; // New required field } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::making-required-fields-optional::35","title":"FIELD_SAME_CARDINALITY","section":"Making Required Fields Optional","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#making-required-fields-optional","headings":["Making Required Fields Optional"],"excerpt":"Making Required Fields Optional ```proto // Instead of changing existing field message User { optional string phone = 3; // BREAKING: was required }","content":"Making Required Fields Optional ```proto // Instead of changing existing field message User { optional string phone = 3; // BREAKING: was required }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::making-required-fields-optional::36","title":"FIELD_SAME_CARDINALITY","section":"Making Required Fields Optional","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#making-required-fields-optional","headings":["Making Required Fields Optional"],"excerpt":"Making Required Fields Optional // Add new optional field message User { string phone = 3 [deprecated = true]; // Keep required optional string phone_optional = 4; // New optional field } ```","content":"Making Required Fields Optional // Add new optional field message User { string phone = 3 [deprecated = true]; // Keep required optional string phone_optional = 4; // New optional field } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::proto3-cardinality::37","title":"FIELD_SAME_CARDINALITY","section":"Proto3 Cardinality","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#proto3-cardinality","headings":["Proto3 Cardinality"],"excerpt":"Proto3 Cardinality **Implicit optional**: string name = 1; (default in proto3) **Explicit optional**: optional string email = 2; **Repeated**: repeated string tags = 3; **Map**: map metadata = 4;","content":"Proto3 Cardinality **Implicit optional**: string name = 1; (default in proto3) **Explicit optional**: optional string email = 2; **Repeated**: repeated string tags = 3; **Map**: map metadata = 4;"},{"id":"cli/breaking-changes/rules/field-same-cardinality::proto2-cardinality::38","title":"FIELD_SAME_CARDINALITY","section":"Proto2 Cardinality","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#proto2-cardinality","headings":["Proto2 Cardinality"],"excerpt":"Proto2 Cardinality **Required**: required string id = 1; **Optional**: optional string email = 2; **Repeated**: repeated string tags = 3;","content":"Proto2 Cardinality **Required**: required string id = 1; **Optional**: optional string email = 2; **Repeated**: repeated string tags = 3;"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking-changes-matrix::39","title":"FIELD_SAME_CARDINALITY","section":"Breaking Changes Matrix","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking-changes-matrix","headings":["Breaking Changes Matrix"],"excerpt":"Breaking Changes Matrix From To Result ------ ---- --------- Required Optional ❌ BREAKING Optional Required ❌ BREAKING Implicit Explicit ❌ BREAKING Explicit Implicit ❌ BREAKING Single Repeated ❌ BREAKING Repeated Single ","content":"Breaking Changes Matrix From To Result ------ ---- --------- Required Optional ❌ BREAKING Optional Required ❌ BREAKING Implicit Explicit ❌ BREAKING Explicit Implicit ❌ BREAKING Single Repeated ❌ BREAKING Repeated Single ❌ BREAKING Field Map ❌ BREAKING Map Field ❌ BREAKING"},{"id":"cli/breaking-changes/rules/field-same-type::top::0","title":"FIELD_SAME_TYPE","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":[],"excerpt":"This rule checks that message fields maintain the same type. Changing a field's type breaks wire format compatibility and generated code, as the binary representation and client code expectations differ between types.","content":"This rule checks that message fields maintain the same type. Changing a field's type breaks wire format compatibility and generated code, as the binary representation and client code expectations differ between types."},{"id":"cli/breaking-changes/rules/field-same-type::bad::1","title":"FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-type::bad::2","title":"FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#bad","headings":["Bad"],"excerpt":"Bad message Product { string name = 1; int32 price = 2; bool available = 3; } ```","content":"Bad message Product { string name = 1; int32 price = 2; bool available = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-type::bad::3","title":"FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-type::bad::4","title":"FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#bad","headings":["Bad"],"excerpt":"Bad message Product { string name = 1; string price = 2; // [!code --] Changed from int32 to string bool available = 3; } ```","content":"Bad message Product { string name = 1; string price = 2; // [!code --] Changed from int32 to string bool available = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-type::more-examples::5","title":"FIELD_SAME_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#more-examples","headings":["More Examples"],"excerpt":"More Examples **Incompatible type changes:**","content":"More Examples **Incompatible type changes:**"},{"id":"cli/breaking-changes/rules/field-same-type::more-examples::6","title":"FIELD_SAME_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before message Order { string id = 1; int64 timestamp = 2; repeated string tags = 3; OrderStatus status = 4; }","content":"More Examples ```proto // Before message Order { string id = 1; int64 timestamp = 2; repeated string tags = 3; OrderStatus status = 4; }"},{"id":"cli/breaking-changes/rules/field-same-type::more-examples::7","title":"FIELD_SAME_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - ALL BREAKING CHANGES! message Order { int32 id = 1; // string -> int32: BREAKING string timestamp = 2; // int64 -> string: BREAKING string tags = 3; // repeated -> singular: BREAKING int32 status","content":"More Examples // After - ALL BREAKING CHANGES! message Order { int32 id = 1; // string -> int32: BREAKING string timestamp = 2; // int64 -> string: BREAKING string tags = 3; // repeated -> singular: BREAKING int32 status = 4; // enum -> int32: BREAKING } ```"},{"id":"cli/breaking-changes/rules/field-same-type::good::8","title":"FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#good","headings":["Good"],"excerpt":"Good **Instead of changing type, add a new field:** ```proto syntax = \"proto3\";","content":"Good **Instead of changing type, add a new field:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-type::good::9","title":"FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#good","headings":["Good"],"excerpt":"Good message Product { string name = 1; int32 price = 2 [deprecated = true]; // [!code focus] bool available = 3; string price_formatted = 4; // [!code focus] // New field for string price } ```","content":"Good message Product { string name = 1; int32 price = 2 [deprecated = true]; // [!code focus] bool available = 3; string price_formatted = 4; // [!code focus] // New field for string price } ```"},{"id":"cli/breaking-changes/rules/field-same-type::good::10","title":"FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#good","headings":["Good"],"excerpt":"Good **Or create a new message version:** ```proto syntax = \"proto3\";","content":"Good **Or create a new message version:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-type::good::11","title":"FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#good","headings":["Good"],"excerpt":"Good package myapi.v2; // [!code focus] // New package version","content":"Good package myapi.v2; // [!code focus] // New package version"},{"id":"cli/breaking-changes/rules/field-same-type::good::12","title":"FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#good","headings":["Good"],"excerpt":"Good message Product { string name = 1; string price = 2; // [!code focus] // Now string in v2 bool available = 3; } ```","content":"Good message Product { string name = 1; string price = 2; // [!code focus] // Now string in v2 bool available = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-type::impact::13","title":"FIELD_SAME_TYPE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Binary data cannot be deserialized correctly between versions **Generated Code:** Field types change, breaking client compilation **Runtime Errors:** Type mismatches cause parsing failures **Data ","content":"Impact **Wire Format:** Binary data cannot be deserialized correctly between versions **Generated Code:** Field types change, breaking client compilation **Runtime Errors:** Type mismatches cause parsing failures **Data Corruption:** Incorrect interpretation of binary data"},{"id":"cli/breaking-changes/rules/field-same-type::migration-strategy::14","title":"FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Add new field** with correct type:","content":"Migration Strategy **Add new field** with correct type:"},{"id":"cli/breaking-changes/rules/field-same-type::migration-strategy::15","title":"FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Dual-write period** - populate both fields during transition","content":"Migration Strategy **Dual-write period** - populate both fields during transition"},{"id":"cli/breaking-changes/rules/field-same-type::migration-strategy::16","title":"FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update clients** to use new field","content":"Migration Strategy **Update clients** to use new field"},{"id":"cli/breaking-changes/rules/field-same-type::migration-strategy::17","title":"FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove old field** in next major version:","content":"Migration Strategy **Remove old field** in next major version:"},{"id":"cli/breaking-changes/rules/field-same-type::safe-type-changes-wire-compatible::18","title":"FIELD_SAME_TYPE","section":"Safe Type Changes (Wire Compatible)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#safe-type-changes-wire-compatible","headings":["Safe Type Changes (Wire Compatible)"],"excerpt":"Safe Type Changes (Wire Compatible) Note: EasyP currently treats ALL type changes as breaking. However, some changes are technically wire-compatible:","content":"Safe Type Changes (Wire Compatible) Note: EasyP currently treats ALL type changes as breaking. However, some changes are technically wire-compatible:"},{"id":"cli/breaking-changes/rules/field-same-type::safe-type-changes-wire-compatible::19","title":"FIELD_SAME_TYPE","section":"Safe Type Changes (Wire Compatible)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#safe-type-changes-wire-compatible","headings":["Safe Type Changes (Wire Compatible)"],"excerpt":"Safe Type Changes (Wire Compatible) int32 ↔ uint32 (same encoding) int64 ↔ uint64 (same encoding) string → bytes (if UTF-8 valid)","content":"Safe Type Changes (Wire Compatible) int32 ↔ uint32 (same encoding) int64 ↔ uint64 (same encoding) string → bytes (if UTF-8 valid)"},{"id":"cli/breaking-changes/rules/field-same-type::safe-type-changes-wire-compatible::20","title":"FIELD_SAME_TYPE","section":"Safe Type Changes (Wire Compatible)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#safe-type-changes-wire-compatible","headings":["Safe Type Changes (Wire Compatible)"],"excerpt":"Safe Type Changes (Wire Compatible) These may be supported in future EasyP versions with different strictness levels.","content":"Safe Type Changes (Wire Compatible) These may be supported in future EasyP versions with different strictness levels."},{"id":"cli/breaking-changes/rules/import-no-delete::top::0","title":"IMPORT_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":[],"excerpt":"This rule checks that no import statements are deleted from proto files. Deleting an import breaks both wire format compatibility and generated code, as the imported types may be referenced in the current file and removi","content":"This rule checks that no import statements are deleted from proto files. Deleting an import breaks both wire format compatibility and generated code, as the imported types may be referenced in the current file and removing the import makes those types unavailable."},{"id":"cli/breaking-changes/rules/import-no-delete::bad::1","title":"IMPORT_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/import-no-delete::bad::2","title":"IMPORT_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#bad","headings":["Bad"],"excerpt":"Bad import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; import \"common/user.proto\"; import \"common/address.proto\";","content":"Bad import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; import \"common/user.proto\"; import \"common/address.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::bad::3","title":"IMPORT_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3; common.User customer = 4; common.Address shipping_address = 5; } ```","content":"Bad message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3; common.User customer = 4; common.Address shipping_address = 5; } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::bad::4","title":"IMPORT_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/import-no-delete::bad::5","title":"IMPORT_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#bad","headings":["Bad"],"excerpt":"Bad import \"google/protobuf/timestamp.proto\"; // import \"google/protobuf/duration.proto\"; // [!code --] Deleted import - BREAKING! // import \"common/user.proto\"; // [!code --] Deleted import - BREAKING! // import \"common","content":"Bad import \"google/protobuf/timestamp.proto\"; // import \"google/protobuf/duration.proto\"; // [!code --] Deleted import - BREAKING! // import \"common/user.proto\"; // [!code --] Deleted import - BREAKING! // import \"common/address.proto\"; // [!code --] Deleted import - BREAKING!"},{"id":"cli/breaking-changes/rules/import-no-delete::bad::6","title":"IMPORT_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3; // ERROR: Duration not available common.User customer = 4; // ERROR: User not available common.Ad","content":"Bad message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3; // ERROR: Duration not available common.User customer = 4; // ERROR: User not available common.Address shipping_address = 5; // ERROR: Address not available } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::more-examples::7","title":"IMPORT_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples **Service definition breaks with deleted imports:**","content":"More Examples **Service definition breaks with deleted imports:**"},{"id":"cli/breaking-changes/rules/import-no-delete::more-examples::8","title":"IMPORT_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before import \"google/api/annotations.proto\"; import \"google/protobuf/empty.proto\"; import \"common/auth.proto\";","content":"More Examples ```proto // Before import \"google/api/annotations.proto\"; import \"google/protobuf/empty.proto\"; import \"common/auth.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::more-examples::9","title":"IMPORT_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples service OrderService { rpc GetOrder(GetOrderRequest) returns (Order) { option (google.api.http) = { get: \"/v1/orders/{id}\" }; } rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty); }","content":"More Examples service OrderService { rpc GetOrder(GetOrderRequest) returns (Order) { option (google.api.http) = { get: \"/v1/orders/{id}\" }; } rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty); }"},{"id":"cli/breaking-changes/rules/import-no-delete::more-examples::10","title":"IMPORT_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - BREAKING CHANGES! // import \"google/api/annotations.proto\"; // BREAKING: deleted // import \"google/protobuf/empty.proto\"; // BREAKING: deleted // import \"common/auth.proto\"; // BREAKING: deleted","content":"More Examples // After - BREAKING CHANGES! // import \"google/api/annotations.proto\"; // BREAKING: deleted // import \"google/protobuf/empty.proto\"; // BREAKING: deleted // import \"common/auth.proto\"; // BREAKING: deleted"},{"id":"cli/breaking-changes/rules/import-no-delete::more-examples::11","title":"IMPORT_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples service OrderService { rpc GetOrder(GetOrderRequest) returns (Order) { option (google.api.http) = { // ERROR: annotations not available get: \"/v1/orders/{id}\" }; } rpc DeleteOrder(common.AuthRequest) return","content":"More Examples service OrderService { rpc GetOrder(GetOrderRequest) returns (Order) { option (google.api.http) = { // ERROR: annotations not available get: \"/v1/orders/{id}\" }; } rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty); // ERROR: types not available } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::good::12","title":"IMPORT_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, keep unused imports:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, keep unused imports:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/import-no-delete::good::13","title":"IMPORT_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#good","headings":["Good"],"excerpt":"Good import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; // [!code focus] // Keep even if unused import \"common/user.proto\"; // [!code focus] // Keep even if unused import \"common/address.p","content":"Good import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; // [!code focus] // Keep even if unused import \"common/user.proto\"; // [!code focus] // Keep even if unused import \"common/address.proto\"; // [!code focus] // Keep even if unused"},{"id":"cli/breaking-changes/rules/import-no-delete::good::14","title":"IMPORT_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#good","headings":["Good"],"excerpt":"Good message Order { string id = 1; google.protobuf.Timestamp created_at = 2; // Removed fields that used Duration, User, Address but kept imports } ```","content":"Good message Order { string id = 1; google.protobuf.Timestamp created_at = 2; // Removed fields that used Duration, User, Address but kept imports } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::good::15","title":"IMPORT_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#good","headings":["Good"],"excerpt":"Good **Or replace with equivalent types while keeping imports:** ```proto syntax = \"proto3\";","content":"Good **Or replace with equivalent types while keeping imports:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/import-no-delete::good::16","title":"IMPORT_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#good","headings":["Good"],"excerpt":"Good import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; // [!code focus] // Keep original import import \"common/user.proto\"; // [!code focus] // Keep original import import \"common/address","content":"Good import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; // [!code focus] // Keep original import import \"common/user.proto\"; // [!code focus] // Keep original import import \"common/address.proto\"; // [!code focus] // Keep original import import \"common/v2/user.proto\"; // [!code focus] // Add new import"},{"id":"cli/breaking-changes/rules/import-no-delete::good::17","title":"IMPORT_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#good","headings":["Good"],"excerpt":"Good message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3 [deprecated = true]; // [!code focus] // Keep old field common.User customer = 4 [deprecated = tr","content":"Good message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3 [deprecated = true]; // [!code focus] // Keep old field common.User customer = 4 [deprecated = true]; // [!code focus] // Keep old field common.Address shipping_address = 5 [deprecated = true]; // [!code focus] // Keep old field int32 processing_seconds = 6; // [!code focus] // New field instead of Duration common.v2.UserProfile customer_v2 = 7; // [!code focus] // New field with updated type string shipping_address_text = 8; // [!code focus] // New field with simpler type } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::impact::18","title":"IMPORT_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Generated Code:** Imported types become unavailable, breaking compilation **Wire Format:** Messages using imported types cannot be deserialized **Field References:** Any field using imported types becomes invali","content":"Impact **Generated Code:** Imported types become unavailable, breaking compilation **Wire Format:** Messages using imported types cannot be deserialized **Field References:** Any field using imported types becomes invalid **Service Definitions:** RPC methods using imported types break **Options Usage:** Custom options from imports become unavailable"},{"id":"cli/breaking-changes/rules/import-no-delete::real-world-example::19","title":"IMPORT_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works order := &myapi.Order{ Id: \"order123\", CreatedAt: timestamppb.New(time.Now()), // Uses google.protobuf.Timestamp Customer: &common.User{ // ERR","content":"Real-World Example **Client code breaks:** ```go // Before - this code works order := &myapi.Order{ Id: \"order123\", CreatedAt: timestamppb.New(time.Now()), // Uses google.protobuf.Timestamp Customer: &common.User{ // ERROR after import deletion Id: \"user456\", Name: \"John Doe\", }, ShippingAddress: &common.Address{ // ERROR after import deletion Street: \"123 Main St\", City: \"New York\", }, }"},{"id":"cli/breaking-changes/rules/import-no-delete::real-world-example::20","title":"IMPORT_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Generated code compilation fails: // undefined: common.User // undefined: common.Address ```","content":"Real-World Example // Generated code compilation fails: // undefined: common.User // undefined: common.Address ```"},{"id":"cli/breaking-changes/rules/import-no-delete::real-world-example::21","title":"IMPORT_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server implementation breaks:**","content":"Real-World Example **Server implementation breaks:**"},{"id":"cli/breaking-changes/rules/import-no-delete::real-world-example::22","title":"IMPORT_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Proto compilation breaks:**","content":"Real-World Example **Proto compilation breaks:**"},{"id":"cli/breaking-changes/rules/import-no-delete::migration-strategy::23","title":"IMPORT_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Keep imports even when unused:**","content":"Migration Strategy **Keep imports even when unused:**"},{"id":"cli/breaking-changes/rules/import-no-delete::migration-strategy::24","title":"IMPORT_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Add new imports alongside old ones:**","content":"Migration Strategy **Add new imports alongside old ones:**"},{"id":"cli/breaking-changes/rules/import-no-delete::migration-strategy::25","title":"IMPORT_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate fields using old imports gradually:**","content":"Migration Strategy **Deprecate fields using old imports gradually:**"},{"id":"cli/breaking-changes/rules/import-no-delete::migration-strategy::26","title":"IMPORT_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update server code** to handle both old and new fields:","content":"Migration Strategy **Update server code** to handle both old and new fields:"},{"id":"cli/breaking-changes/rules/import-no-delete::migration-strategy::27","title":"IMPORT_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Only remove imports in major version updates** after all fields are migrated","content":"Migration Strategy **Only remove imports in major version updates** after all fields are migrated"},{"id":"cli/breaking-changes/rules/import-no-delete::replacing-dependencies::28","title":"IMPORT_NO_DELETE","section":"Replacing Dependencies","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#replacing-dependencies","headings":["Replacing Dependencies"],"excerpt":"Replacing Dependencies ```proto // Instead of deleting old import immediately // import \"old/user.proto\"; // Don't delete!","content":"Replacing Dependencies ```proto // Instead of deleting old import immediately // import \"old/user.proto\"; // Don't delete!"},{"id":"cli/breaking-changes/rules/import-no-delete::replacing-dependencies::29","title":"IMPORT_NO_DELETE","section":"Replacing Dependencies","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#replacing-dependencies","headings":["Replacing Dependencies"],"excerpt":"Replacing Dependencies // Keep both during transition import \"old/user.proto\"; // Keep for backward compatibility import \"new/user.proto\"; // Add new dependency","content":"Replacing Dependencies // Keep both during transition import \"old/user.proto\"; // Keep for backward compatibility import \"new/user.proto\"; // Add new dependency"},{"id":"cli/breaking-changes/rules/import-no-delete::replacing-dependencies::30","title":"IMPORT_NO_DELETE","section":"Replacing Dependencies","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#replacing-dependencies","headings":["Replacing Dependencies"],"excerpt":"Replacing Dependencies message Order { old.User customer = 4 [deprecated = true]; new.UserProfile customer_v2 = 5; } ```","content":"Replacing Dependencies message Order { old.User customer = 4 [deprecated = true]; new.UserProfile customer_v2 = 5; } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::removing-unused-features::31","title":"IMPORT_NO_DELETE","section":"Removing Unused Features","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#removing-unused-features","headings":["Removing Unused Features"],"excerpt":"Removing Unused Features ```proto // Even if removing features, keep imports import \"feature/analytics.proto\"; // Keep even if analytics removed","content":"Removing Unused Features ```proto // Even if removing features, keep imports import \"feature/analytics.proto\"; // Keep even if analytics removed"},{"id":"cli/breaking-changes/rules/import-no-delete::removing-unused-features::32","title":"IMPORT_NO_DELETE","section":"Removing Unused Features","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#removing-unused-features","headings":["Removing Unused Features"],"excerpt":"Removing Unused Features message Order { string id = 1; // feature.AnalyticsData analytics = 2; // Field removed but import kept } ```","content":"Removing Unused Features message Order { string id = 1; // feature.AnalyticsData analytics = 2; // Field removed but import kept } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::protobuf-version-migration::33","title":"IMPORT_NO_DELETE","section":"Protobuf Version Migration","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#protobuf-version-migration","headings":["Protobuf Version Migration"],"excerpt":"Protobuf Version Migration ```proto // When migrating protobuf versions, keep old imports import \"google/protobuf/timestamp.proto\"; // Keep standard imports import \"google/protobuf/duration.proto\"; // Even if switching t","content":"Protobuf Version Migration ```proto // When migrating protobuf versions, keep old imports import \"google/protobuf/timestamp.proto\"; // Keep standard imports import \"google/protobuf/duration.proto\"; // Even if switching to alternatives"},{"id":"cli/breaking-changes/rules/import-no-delete::protobuf-version-migration::34","title":"IMPORT_NO_DELETE","section":"Protobuf Version Migration","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#protobuf-version-migration","headings":["Protobuf Version Migration"],"excerpt":"Protobuf Version Migration // Prefer keeping both old and new approaches message Event { google.protobuf.Timestamp timestamp = 1; // Keep old int64 timestamp_millis = 2; // Add alternative } ```","content":"Protobuf Version Migration // Prefer keeping both old and new approaches message Event { google.protobuf.Timestamp timestamp = 1; // Keep old int64 timestamp_millis = 2; // Add alternative } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::simplifying-dependencies::35","title":"IMPORT_NO_DELETE","section":"Simplifying Dependencies","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#simplifying-dependencies","headings":["Simplifying Dependencies"],"excerpt":"Simplifying Dependencies ```proto // Instead of removing complex type imports // import \"complex/config.proto\"; // Don't delete!","content":"Simplifying Dependencies ```proto // Instead of removing complex type imports // import \"complex/config.proto\"; // Don't delete!"},{"id":"cli/breaking-changes/rules/import-no-delete::simplifying-dependencies::36","title":"IMPORT_NO_DELETE","section":"Simplifying Dependencies","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#simplifying-dependencies","headings":["Simplifying Dependencies"],"excerpt":"Simplifying Dependencies // Keep complex import, add simple alternative import \"complex/config.proto\";","content":"Simplifying Dependencies // Keep complex import, add simple alternative import \"complex/config.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::simplifying-dependencies::37","title":"IMPORT_NO_DELETE","section":"Simplifying Dependencies","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#simplifying-dependencies","headings":["Simplifying Dependencies"],"excerpt":"Simplifying Dependencies message Settings { complex.ConfigData config = 1 [deprecated = true]; // Keep complex option string config_json = 2; // Add simple option } ```","content":"Simplifying Dependencies message Settings { complex.ConfigData config = 1 [deprecated = true]; // Keep complex option string config_json = 2; // Add simple option } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::import-deletion-vs-field-usage::38","title":"IMPORT_NO_DELETE","section":"Import Deletion vs Field Usage","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#import-deletion-vs-field-usage","headings":["Import Deletion vs Field Usage"],"excerpt":"Import Deletion vs Field Usage ```proto // Import deletion breaks even if types aren't directly used as fields import \"common/enums.proto\";","content":"Import Deletion vs Field Usage ```proto // Import deletion breaks even if types aren't directly used as fields import \"common/enums.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::import-deletion-vs-field-usage::39","title":"IMPORT_NO_DELETE","section":"Import Deletion vs Field Usage","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#import-deletion-vs-field-usage","headings":["Import Deletion vs Field Usage"],"excerpt":"Import Deletion vs Field Usage message Order { // Even if no fields directly use common.enums types, // nested messages or oneof fields might use them oneof payment { CreditCardPayment card = 1; // This might internally ","content":"Import Deletion vs Field Usage message Order { // Even if no fields directly use common.enums types, // nested messages or oneof fields might use them oneof payment { CreditCardPayment card = 1; // This might internally use common.enums } } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::transitive-dependencies::40","title":"IMPORT_NO_DELETE","section":"Transitive Dependencies","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#transitive-dependencies","headings":["Transitive Dependencies"],"excerpt":"Transitive Dependencies ```proto // Deleting an import can break transitive dependencies import \"user.proto\"; // Don't delete even if not directly used","content":"Transitive Dependencies ```proto // Deleting an import can break transitive dependencies import \"user.proto\"; // Don't delete even if not directly used"},{"id":"cli/breaking-changes/rules/import-no-delete::transitive-dependencies::41","title":"IMPORT_NO_DELETE","section":"Transitive Dependencies","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#transitive-dependencies","headings":["Transitive Dependencies"],"excerpt":"Transitive Dependencies message Order { PaymentInfo payment = 1; // PaymentInfo might internally reference user.proto types } ```","content":"Transitive Dependencies message Order { PaymentInfo payment = 1; // PaymentInfo might internally reference user.proto types } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::json-serialization-impact::42","title":"IMPORT_NO_DELETE","section":"JSON Serialization Impact","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#json-serialization-impact","headings":["JSON Serialization Impact"],"excerpt":"JSON Serialization Impact ```proto // Imports affect JSON field names and validation import \"google/protobuf/field_mask.proto\";","content":"JSON Serialization Impact ```proto // Imports affect JSON field names and validation import \"google/protobuf/field_mask.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::json-serialization-impact::43","title":"IMPORT_NO_DELETE","section":"JSON Serialization Impact","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#json-serialization-impact","headings":["JSON Serialization Impact"],"excerpt":"JSON Serialization Impact message UpdateRequest { google.protobuf.FieldMask update_mask = 1; // JSON serialization depends on import } ```","content":"JSON Serialization Impact message UpdateRequest { google.protobuf.FieldMask update_mask = 1; // JSON serialization depends on import } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::import-auditing::44","title":"IMPORT_NO_DELETE","section":"Import Auditing","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#import-auditing","headings":["Import Auditing"],"excerpt":"Import Auditing ```bash Check which imports are actually used $ grep -r \"google.protobuf.Duration\" *.proto $ grep -r \"common.User\" *.proto","content":"Import Auditing ```bash Check which imports are actually used $ grep -r \"google.protobuf.Duration\" *.proto $ grep -r \"common.User\" *.proto"},{"id":"cli/breaking-changes/rules/import-no-delete::import-auditing::45","title":"IMPORT_NO_DELETE","section":"Import Auditing","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#import-auditing","headings":["Import Auditing"],"excerpt":"Import Auditing But still keep imports even if grep shows no usage! ```","content":"Import Auditing But still keep imports even if grep shows no usage! ```"},{"id":"cli/breaking-changes/rules/import-no-delete::different-breaking-change-types::46","title":"IMPORT_NO_DELETE","section":"Different Breaking Change Types","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#different-breaking-change-types","headings":["Different Breaking Change Types"],"excerpt":"Different Breaking Change Types ```proto // Import deletion (this rule) // import \"user.proto\"; // BREAKING: import deleted","content":"Different Breaking Change Types ```proto // Import deletion (this rule) // import \"user.proto\"; // BREAKING: import deleted"},{"id":"cli/breaking-changes/rules/import-no-delete::different-breaking-change-types::47","title":"IMPORT_NO_DELETE","section":"Different Breaking Change Types","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#different-breaking-change-types","headings":["Different Breaking Change Types"],"excerpt":"Different Breaking Change Types // vs Field deletion (different rule) message Order { string id = 1; // User customer = 2; // BREAKING: field deleted (different from import) } ```","content":"Different Breaking Change Types // vs Field deletion (different rule) message Order { string id = 1; // User customer = 2; // BREAKING: field deleted (different from import) } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::top::0","title":"MESSAGE_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":[],"excerpt":"This rule checks that no messages are deleted from proto files. Deleting a message breaks both wire format compatibility and generated code, as existing data may reference the deleted message and client code depends on t","content":"This rule checks that no messages are deleted from proto files. Deleting a message breaks both wire format compatibility and generated code, as existing data may reference the deleted message and client code depends on the generated types."},{"id":"cli/breaking-changes/rules/message-no-delete::bad::1","title":"MESSAGE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/message-no-delete::bad::2","title":"MESSAGE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#bad","headings":["Bad"],"excerpt":"Bad message User { string name = 1; string email = 2; Address address = 3; }","content":"Bad message User { string name = 1; string email = 2; Address address = 3; }"},{"id":"cli/breaking-changes/rules/message-no-delete::bad::3","title":"MESSAGE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Address { // [!code --] string street = 1; // [!code --] string city = 2; // [!code --] string country = 3; // [!code --] } // [!code --]","content":"Bad message Address { // [!code --] string street = 1; // [!code --] string city = 2; // [!code --] string country = 3; // [!code --] } // [!code --]"},{"id":"cli/breaking-changes/rules/message-no-delete::bad::4","title":"MESSAGE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Order { string id = 1; User user = 2; } ```","content":"Bad message Order { string id = 1; User user = 2; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::bad::5","title":"MESSAGE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/message-no-delete::bad::6","title":"MESSAGE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#bad","headings":["Bad"],"excerpt":"Bad message User { string name = 1; string email = 2; Address address = 3; // ERROR: Address message no longer exists! }","content":"Bad message User { string name = 1; string email = 2; Address address = 3; // ERROR: Address message no longer exists! }"},{"id":"cli/breaking-changes/rules/message-no-delete::bad::7","title":"MESSAGE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#bad","headings":["Bad"],"excerpt":"Bad // Address message was deleted - BREAKING CHANGE!","content":"Bad // Address message was deleted - BREAKING CHANGE!"},{"id":"cli/breaking-changes/rules/message-no-delete::bad::8","title":"MESSAGE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Order { string id = 1; User user = 2; } ```","content":"Bad message Order { string id = 1; User user = 2; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::more-examples::9","title":"MESSAGE_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples **Nested message deletion:**","content":"More Examples **Nested message deletion:**"},{"id":"cli/breaking-changes/rules/message-no-delete::more-examples::10","title":"MESSAGE_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before message User { string name = 1; Profile profile = 2; message Profile { // [!code --] string bio = 1; // [!code --] string avatar_url = 2; // [!code --] } // [!code --] }","content":"More Examples ```proto // Before message User { string name = 1; Profile profile = 2; message Profile { // [!code --] string bio = 1; // [!code --] string avatar_url = 2; // [!code --] } // [!code --] }"},{"id":"cli/breaking-changes/rules/message-no-delete::more-examples::11","title":"MESSAGE_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - BREAKING CHANGE! message User { string name = 1; Profile profile = 2; // ERROR: Profile message deleted // Profile nested message was deleted } ```","content":"More Examples // After - BREAKING CHANGE! message User { string name = 1; Profile profile = 2; // ERROR: Profile message deleted // Profile nested message was deleted } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::good::12","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, deprecate the message:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, deprecate the message:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/message-no-delete::good::13","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good message User { string name = 1; string email = 2; Address address = 3 [deprecated = true]; // [!code focus] }","content":"Good message User { string name = 1; string email = 2; Address address = 3 [deprecated = true]; // [!code focus] }"},{"id":"cli/breaking-changes/rules/message-no-delete::good::14","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good message Address { option deprecated = true; // [!code focus] string street = 1; string city = 2; string country = 3; }","content":"Good message Address { option deprecated = true; // [!code focus] string street = 1; string city = 2; string country = 3; }"},{"id":"cli/breaking-changes/rules/message-no-delete::good::15","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good message Order { string id = 1; User user = 2; } ```","content":"Good message Order { string id = 1; User user = 2; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::good::16","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good **Or replace with new message version:** ```proto syntax = \"proto3\";","content":"Good **Or replace with new message version:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/message-no-delete::good::17","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good message User { string name = 1; string email = 2; Address address = 3 [deprecated = true]; // [!code focus] // Old field AddressV2 address_v2 = 4; // [!code focus] // New field with better structure }","content":"Good message User { string name = 1; string email = 2; Address address = 3 [deprecated = true]; // [!code focus] // Old field AddressV2 address_v2 = 4; // [!code focus] // New field with better structure }"},{"id":"cli/breaking-changes/rules/message-no-delete::good::18","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good message Address { option deprecated = true; // [!code focus] string street = 1; string city = 2; string country = 3; }","content":"Good message Address { option deprecated = true; // [!code focus] string street = 1; string city = 2; string country = 3; }"},{"id":"cli/breaking-changes/rules/message-no-delete::good::19","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good message AddressV2 { // [!code focus] string street_address = 1; // [!code focus] string city = 2; // [!code focus] string state = 3; // [!code focus] string postal_code = 4; // [!code focus] string country = 5; // [","content":"Good message AddressV2 { // [!code focus] string street_address = 1; // [!code focus] string city = 2; // [!code focus] string state = 3; // [!code focus] string postal_code = 4; // [!code focus] string country = 5; // [!code focus] } // [!code focus]"},{"id":"cli/breaking-changes/rules/message-no-delete::good::20","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good message Order { string id = 1; User user = 2; } ```","content":"Good message Order { string id = 1; User user = 2; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::impact::21","title":"MESSAGE_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Existing data with the deleted message cannot be deserialized **Generated Code:** Message classes/structs are removed, breaking client compilation **Field References:** Fields using the deleted me","content":"Impact **Wire Format:** Existing data with the deleted message cannot be deserialized **Generated Code:** Message classes/structs are removed, breaking client compilation **Field References:** Fields using the deleted message type become invalid **Nested Dependencies:** All messages referencing the deleted message break"},{"id":"cli/breaking-changes/rules/message-no-delete::real-world-example::22","title":"MESSAGE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works user := &myapi.User{ Name: \"John Doe\", Email: \"john@example.com\", Address: &myapi.Address{ // ERROR after deletion Street: \"123 Main St\", City:","content":"Real-World Example **Client code breaks:** ```go // Before - this code works user := &myapi.User{ Name: \"John Doe\", Email: \"john@example.com\", Address: &myapi.Address{ // ERROR after deletion Street: \"123 Main St\", City: \"New York\", Country: \"USA\", }, }"},{"id":"cli/breaking-changes/rules/message-no-delete::real-world-example::23","title":"MESSAGE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Generated code compilation fails: // undefined: myapi.Address ```","content":"Real-World Example // Generated code compilation fails: // undefined: myapi.Address ```"},{"id":"cli/breaking-changes/rules/message-no-delete::real-world-example::24","title":"MESSAGE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Existing data becomes unreadable:** ```json // Serialized data before deletion { \"name\": \"John Doe\", \"email\": \"john@example.com\", \"address\": { \"street\": \"123 Main St\", \"city\": \"New York\", \"country\": ","content":"Real-World Example **Existing data becomes unreadable:** ```json // Serialized data before deletion { \"name\": \"John Doe\", \"email\": \"john@example.com\", \"address\": { \"street\": \"123 Main St\", \"city\": \"New York\", \"country\": \"USA\" } }"},{"id":"cli/breaking-changes/rules/message-no-delete::real-world-example::25","title":"MESSAGE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After Address deletion - deserialization fails // Parser doesn't know how to handle \"address\" field ```","content":"Real-World Example // After Address deletion - deserialization fails // Parser doesn't know how to handle \"address\" field ```"},{"id":"cli/breaking-changes/rules/message-no-delete::migration-strategy::26","title":"MESSAGE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate the message first:**","content":"Migration Strategy **Deprecate the message first:**"},{"id":"cli/breaking-changes/rules/message-no-delete::migration-strategy::27","title":"MESSAGE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Stop using in new fields** and deprecate existing fields that use it:","content":"Migration Strategy **Stop using in new fields** and deprecate existing fields that use it:"},{"id":"cli/breaking-changes/rules/message-no-delete::migration-strategy::28","title":"MESSAGE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Create replacement** with new structure if needed:","content":"Migration Strategy **Create replacement** with new structure if needed:"},{"id":"cli/breaking-changes/rules/message-no-delete::migration-strategy::29","title":"MESSAGE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove after migration period** in a new major version","content":"Migration Strategy **Remove after migration period** in a new major version"},{"id":"cli/breaking-changes/rules/message-no-delete::refactoring-message-structure::30","title":"MESSAGE_NO_DELETE","section":"Refactoring Message Structure","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#refactoring-message-structure","headings":["Refactoring Message Structure"],"excerpt":"Refactoring Message Structure ```proto // Instead of deleting UserInfo and creating UserProfile message UserInfo { option deprecated = true; // Deprecate old string name = 1; string email = 2; }","content":"Refactoring Message Structure ```proto // Instead of deleting UserInfo and creating UserProfile message UserInfo { option deprecated = true; // Deprecate old string name = 1; string email = 2; }"},{"id":"cli/breaking-changes/rules/message-no-delete::refactoring-message-structure::31","title":"MESSAGE_NO_DELETE","section":"Refactoring Message Structure","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#refactoring-message-structure","headings":["Refactoring Message Structure"],"excerpt":"Refactoring Message Structure message UserProfile { // Create new alongside string full_name = 1; string email_address = 2; string phone = 3; // Better field organization } ```","content":"Refactoring Message Structure message UserProfile { // Create new alongside string full_name = 1; string email_address = 2; string phone = 3; // Better field organization } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::version-migration::32","title":"MESSAGE_NO_DELETE","section":"Version Migration","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#version-migration","headings":["Version Migration"],"excerpt":"Version Migration ```proto // Clean approach - new package version package myapi.v2;","content":"Version Migration ```proto // Clean approach - new package version package myapi.v2;"},{"id":"cli/breaking-changes/rules/message-no-delete::version-migration::33","title":"MESSAGE_NO_DELETE","section":"Version Migration","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#version-migration","headings":["Version Migration"],"excerpt":"Version Migration message User { // Redesigned message structure // No deprecated Address references } ```","content":"Version Migration message User { // Redesigned message structure // No deprecated Address references } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::0","title":"ONEOF_FIELD_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":[],"excerpt":"This rule checks that no fields are deleted from oneOf groups. Deleting a field from a oneOf breaks both wire format compatibility and generated code, as existing data may use the deleted oneOf option and client code dep","content":"This rule checks that no fields are deleted from oneOf groups. Deleting a field from a oneOf breaks both wire format compatibility and generated code, as existing data may use the deleted oneOf option and client code depends on the generated field types and accessor methods."},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::bad::1","title":"ONEOF_FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::bad::2","title":"ONEOF_FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#bad","headings":["Bad"],"excerpt":"Bad message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4; string certificate = 5; } }","content":"Bad message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4; string certificate = 5; } }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::bad::3","title":"ONEOF_FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#bad","headings":["Bad"],"excerpt":"Bad message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; string category = 3; DateRange date_range = 4; } } ```","content":"Bad message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; string category = 3; DateRange date_range = 4; } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::bad::4","title":"ONEOF_FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::bad::5","title":"ONEOF_FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#bad","headings":["Bad"],"excerpt":"Bad message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; // string oauth_token = 4; // [!code --] Deleted oneOf field - BREAKING! // string certificate = 5; // [!code -","content":"Bad message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; // string oauth_token = 4; // [!code --] Deleted oneOf field - BREAKING! // string certificate = 5; // [!code --] Deleted oneOf field - BREAKING! } }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::bad::6","title":"ONEOF_FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#bad","headings":["Bad"],"excerpt":"Bad message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; // string category = 3; // [!code --] Deleted oneOf field - BREAKING! // DateRange date_range = 4; // [!code --] Deleted oneOf field - BREAKING","content":"Bad message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; // string category = 3; // [!code --] Deleted oneOf field - BREAKING! // DateRange date_range = 4; // [!code --] Deleted oneOf field - BREAKING! } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::more-examples::7","title":"ONEOF_FIELD_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples **Nested message oneOf field deletion:**","content":"More Examples **Nested message oneOf field deletion:**"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::more-examples::8","title":"ONEOF_FIELD_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before message PaymentRequest { string order_id = 1; oneof payment_method { CreditCardPayment credit_card = 2; BankTransferPayment bank_transfer = 3; CryptoPayment crypto = 4; // [!code --] Gift","content":"More Examples ```proto // Before message PaymentRequest { string order_id = 1; oneof payment_method { CreditCardPayment credit_card = 2; BankTransferPayment bank_transfer = 3; CryptoPayment crypto = 4; // [!code --] GiftCardPayment gift_card = 5; // [!code --] } }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::more-examples::9","title":"ONEOF_FIELD_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - BREAKING CHANGES! message PaymentRequest { string order_id = 1; oneof payment_method { CreditCardPayment credit_card = 2; BankTransferPayment bank_transfer = 3; // CryptoPayment crypto = 4; // BR","content":"More Examples // After - BREAKING CHANGES! message PaymentRequest { string order_id = 1; oneof payment_method { CreditCardPayment credit_card = 2; BankTransferPayment bank_transfer = 3; // CryptoPayment crypto = 4; // BREAKING: deleted // GiftCardPayment gift_card = 5; // BREAKING: deleted } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::good::10","title":"ONEOF_FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, deprecate the oneOf fields:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, deprecate the oneOf fields:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::good::11","title":"ONEOF_FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#good","headings":["Good"],"excerpt":"Good message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4 [deprecated = true]; // [!code focus] string certificate = 5 [deprecated = true]; // [!","content":"Good message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4 [deprecated = true]; // [!code focus] string certificate = 5 [deprecated = true]; // [!code focus] } }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::good::12","title":"ONEOF_FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#good","headings":["Good"],"excerpt":"Good message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; string category = 3 [deprecated = true]; // [!code focus] DateRange date_range = 4 [deprecated = true]; // [!code focus] } } ```","content":"Good message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; string category = 3 [deprecated = true]; // [!code focus] DateRange date_range = 4 [deprecated = true]; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::good::13","title":"ONEOF_FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#good","headings":["Good"],"excerpt":"Good **Or add new oneOf fields while keeping old ones:** ```proto syntax = \"proto3\";","content":"Good **Or add new oneOf fields while keeping old ones:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::good::14","title":"ONEOF_FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#good","headings":["Good"],"excerpt":"Good message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4 [deprecated = true]; // [!code focus] // Keep old field string certificate = 5 [depreca","content":"Good message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4 [deprecated = true]; // [!code focus] // Keep old field string certificate = 5 [deprecated = true]; // [!code focus] // Keep old field OAuthCredentials oauth_v2 = 6; // [!code focus] // New structured approach CertificateCredentials cert_v2 = 7; // [!code focus] // New structured approach } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::impact::15","title":"ONEOF_FIELD_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Existing data with deleted oneOf fields cannot be deserialized properly **Generated Code:** OneOf field accessor methods are removed, breaking client compilation **Type Safety:** Generated oneOf w","content":"Impact **Wire Format:** Existing data with deleted oneOf fields cannot be deserialized properly **Generated Code:** OneOf field accessor methods are removed, breaking client compilation **Type Safety:** Generated oneOf wrapper types lose options, breaking switch statements **Business Logic:** Client code handling specific oneOf cases breaks"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::real-world-example::16","title":"ONEOF_FIELD_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works loginReq := &myapi.LoginRequest{ Username: \"user123\", }","content":"Real-World Example **Client code breaks:** ```go // Before - this code works loginReq := &myapi.LoginRequest{ Username: \"user123\", }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::real-world-example::17","title":"ONEOF_FIELD_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Set OAuth token (oneOf field) loginReq.Credentials = &myapi.LoginRequest_OauthToken{ OauthToken: \"token123\", // ERROR after field deletion }","content":"Real-World Example // Set OAuth token (oneOf field) loginReq.Credentials = &myapi.LoginRequest_OauthToken{ OauthToken: \"token123\", // ERROR after field deletion }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::real-world-example::18","title":"ONEOF_FIELD_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Switch on oneOf field types switch cred := loginReq.Credentials.(type) { case *myapi.LoginRequest_Password: return authenticatePassword(cred.Password) case *myapi.LoginRequest_OauthToken: // ERROR: ","content":"Real-World Example // Switch on oneOf field types switch cred := loginReq.Credentials.(type) { case *myapi.LoginRequest_Password: return authenticatePassword(cred.Password) case *myapi.LoginRequest_OauthToken: // ERROR: undefined type after deletion return authenticateOAuth(cred.OauthToken) case *myapi.LoginRequest_Certificate: // ERROR: undefined type after deletion return authenticateCert(cred.Certificate) default: return errors.New(\"unsupported credential type\") }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::real-world-example::19","title":"ONEOF_FIELD_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Generated code compilation fails: // undefined: myapi.LoginRequest_OauthToken // undefined: myapi.LoginRequest_Certificate ```","content":"Real-World Example // Generated code compilation fails: // undefined: myapi.LoginRequest_OauthToken // undefined: myapi.LoginRequest_Certificate ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::real-world-example::20","title":"ONEOF_FIELD_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server handling breaks:**","content":"Real-World Example **Server handling breaks:**"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::real-world-example::21","title":"ONEOF_FIELD_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Existing data becomes unreadable:** ```json // Serialized data before deletion { \"username\": \"user123\", \"oauth_token\": \"abc123xyz\" }","content":"Real-World Example **Existing data becomes unreadable:** ```json // Serialized data before deletion { \"username\": \"user123\", \"oauth_token\": \"abc123xyz\" }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::real-world-example::22","title":"ONEOF_FIELD_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After oneOf field deletion // Data deserializes but oauth_token is lost or causes parsing errors // User authentication fails due to missing credential data ```","content":"Real-World Example // After oneOf field deletion // Data deserializes but oauth_token is lost or causes parsing errors // User authentication fails due to missing credential data ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::migration-strategy::23","title":"ONEOF_FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate oneOf fields first:**","content":"Migration Strategy **Deprecate oneOf fields first:**"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::migration-strategy::24","title":"ONEOF_FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Add new fields** if replacement is needed:","content":"Migration Strategy **Add new fields** if replacement is needed:"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::migration-strategy::25","title":"ONEOF_FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update server code** to handle both old and new fields:","content":"Migration Strategy **Update server code** to handle both old and new fields:"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::migration-strategy::26","title":"ONEOF_FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Migrate clients** to use new fields:","content":"Migration Strategy **Migrate clients** to use new fields:"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::migration-strategy::27","title":"ONEOF_FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Reserve field numbers** after removal in next major version:","content":"Migration Strategy **Reserve field numbers** after removal in next major version:"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::removing-unsupported-authentication-methods::28","title":"ONEOF_FIELD_NO_DELETE","section":"Removing Unsupported Authentication Methods","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#removing-unsupported-authentication-methods","headings":["Removing Unsupported Authentication Methods"],"excerpt":"Removing Unsupported Authentication Methods","content":"Removing Unsupported Authentication Methods"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::oneof-field-deletion-vs-other-deletions::29","title":"ONEOF_FIELD_NO_DELETE","section":"OneOf Field Deletion vs Other Deletions","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#oneof-field-deletion-vs-other-deletions","headings":["OneOf Field Deletion vs Other Deletions"],"excerpt":"OneOf Field Deletion vs Other Deletions","content":"OneOf Field Deletion vs Other Deletions"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::different-from-regular-field-deletion::30","title":"ONEOF_FIELD_NO_DELETE","section":"Different from Regular Field Deletion","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#different-from-regular-field-deletion","headings":["Different from Regular Field Deletion"],"excerpt":"Different from Regular Field Deletion ```proto // Regular field deletion (also breaking) message User { string name = 1; // string email = 2; // BREAKING: regular field deletion }","content":"Different from Regular Field Deletion ```proto // Regular field deletion (also breaking) message User { string name = 1; // string email = 2; // BREAKING: regular field deletion }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::different-from-regular-field-deletion::31","title":"ONEOF_FIELD_NO_DELETE","section":"Different from Regular Field Deletion","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#different-from-regular-field-deletion","headings":["Different from Regular Field Deletion"],"excerpt":"Different from Regular Field Deletion // OneOf field deletion (breaks oneOf semantics) message User { oneof contact { string email = 1; // string phone = 2; // BREAKING: oneOf field deletion } } ```","content":"Different from Regular Field Deletion // OneOf field deletion (breaks oneOf semantics) message User { oneof contact { string email = 1; // string phone = 2; // BREAKING: oneOf field deletion } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::impact-on-generated-code::32","title":"ONEOF_FIELD_NO_DELETE","section":"Impact on Generated Code","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#impact-on-generated-code","headings":["Impact on Generated Code"],"excerpt":"Impact on Generated Code ```go // Regular field - simple accessor removed // user.GetEmail() // Method removed","content":"Impact on Generated Code ```go // Regular field - simple accessor removed // user.GetEmail() // Method removed"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::impact-on-generated-code::33","title":"ONEOF_FIELD_NO_DELETE","section":"Impact on Generated Code","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#impact-on-generated-code","headings":["Impact on Generated Code"],"excerpt":"Impact on Generated Code // OneOf field - wrapper type removed // *LoginRequest_OauthToken // Entire type removed // switch statement cases break completely ```","content":"Impact on Generated Code // OneOf field - wrapper type removed // *LoginRequest_OauthToken // Entire type removed // switch statement cases break completely ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::wire-format-considerations::34","title":"ONEOF_FIELD_NO_DELETE","section":"Wire Format Considerations","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#wire-format-considerations","headings":["Wire Format Considerations"],"excerpt":"Wire Format Considerations ```proto // OneOf fields share the same \"choice\" semantics // Removing a choice breaks clients that made that choice","content":"Wire Format Considerations ```proto // OneOf fields share the same \"choice\" semantics // Removing a choice breaks clients that made that choice"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::wire-format-considerations::35","title":"ONEOF_FIELD_NO_DELETE","section":"Wire Format Considerations","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#wire-format-considerations","headings":["Wire Format Considerations"],"excerpt":"Wire Format Considerations message Request { oneof data { string text = 1; // Choice A bytes binary = 2; // Choice B - if removed, clients using B break JsonData json = 3; // Choice C } } ```","content":"Wire Format Considerations message Request { oneof data { string text = 1; // Choice A bytes binary = 2; // Choice B - if removed, clients using B break JsonData json = 3; // Choice C } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::0","title":"ONEOF_FIELD_SAME_TYPE","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":[],"excerpt":"This rule checks that oneOf field types cannot be changed. Changing the type of a field within a oneOf breaks both wire format compatibility and generated code, as existing data contains the old type and client code expe","content":"This rule checks that oneOf field types cannot be changed. Changing the type of a field within a oneOf breaks both wire format compatibility and generated code, as existing data contains the old type and client code expects specific field types in oneOf wrapper structures."},{"id":"cli/breaking-changes/rules/oneof-field-same-type::bad::1","title":"ONEOF_FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::bad::2","title":"ONEOF_FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#bad","headings":["Bad"],"excerpt":"Bad message SearchRequest { string query = 1; oneof filter { string category = 2; int32 user_id = 3; bool is_premium = 4; DateRange date_range = 5; } }","content":"Bad message SearchRequest { string query = 1; oneof filter { string category = 2; int32 user_id = 3; bool is_premium = 4; DateRange date_range = 5; } }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::bad::3","title":"ONEOF_FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#bad","headings":["Bad"],"excerpt":"Bad message NotificationSettings { oneof delivery { string email = 1; int64 phone_number = 2; WebhookConfig webhook = 3; } } ```","content":"Bad message NotificationSettings { oneof delivery { string email = 1; int64 phone_number = 2; WebhookConfig webhook = 3; } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::bad::4","title":"ONEOF_FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::bad::5","title":"ONEOF_FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#bad","headings":["Bad"],"excerpt":"Bad message SearchRequest { string query = 1; oneof filter { int32 category = 2; // [!code --] Changed from string to int32 - BREAKING! string user_id = 3; // [!code --] Changed from int32 to string - BREAKING! string is","content":"Bad message SearchRequest { string query = 1; oneof filter { int32 category = 2; // [!code --] Changed from string to int32 - BREAKING! string user_id = 3; // [!code --] Changed from int32 to string - BREAKING! string is_premium = 4; // [!code --] Changed from bool to string - BREAKING! string date_range = 5; // [!code --] Changed from DateRange to string - BREAKING! } }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::bad::6","title":"ONEOF_FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#bad","headings":["Bad"],"excerpt":"Bad message NotificationSettings { oneof delivery { EmailConfig email = 1; // [!code --] Changed from string to EmailConfig - BREAKING! string phone_number = 2; // [!code --] Changed from int64 to string - BREAKING! stri","content":"Bad message NotificationSettings { oneof delivery { EmailConfig email = 1; // [!code --] Changed from string to EmailConfig - BREAKING! string phone_number = 2; // [!code --] Changed from int64 to string - BREAKING! string webhook = 3; // [!code --] Changed from WebhookConfig to string - BREAKING! } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::more-examples::7","title":"ONEOF_FIELD_SAME_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#more-examples","headings":["More Examples"],"excerpt":"More Examples **Complex type changes:**","content":"More Examples **Complex type changes:**"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::more-examples::8","title":"ONEOF_FIELD_SAME_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before message PaymentRequest { oneof payment_info { CreditCardInfo credit_card = 1; BankAccountInfo bank_account = 2; string paypal_email = 3; CryptoWalletInfo crypto = 4; } }","content":"More Examples ```proto // Before message PaymentRequest { oneof payment_info { CreditCardInfo credit_card = 1; BankAccountInfo bank_account = 2; string paypal_email = 3; CryptoWalletInfo crypto = 4; } }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::more-examples::9","title":"ONEOF_FIELD_SAME_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - ALL BREAKING CHANGES! message PaymentRequest { oneof payment_info { string credit_card = 1; // BREAKING: CreditCardInfo -> string PayPalInfo bank_account = 2; // BREAKING: BankAccountInfo -> PayP","content":"More Examples // After - ALL BREAKING CHANGES! message PaymentRequest { oneof payment_info { string credit_card = 1; // BREAKING: CreditCardInfo -> string PayPalInfo bank_account = 2; // BREAKING: BankAccountInfo -> PayPalInfo PayPalInfo paypal_email = 3; // BREAKING: string -> PayPalInfo string crypto = 4; // BREAKING: CryptoWalletInfo -> string } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::good::10","title":"ONEOF_FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#good","headings":["Good"],"excerpt":"Good **Instead of changing type, add new oneOf field:** ```proto syntax = \"proto3\";","content":"Good **Instead of changing type, add new oneOf field:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::good::11","title":"ONEOF_FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#good","headings":["Good"],"excerpt":"Good message SearchRequest { string query = 1; oneof filter { string category = 2 [deprecated = true]; // [!code focus] // Keep original type int32 user_id = 3 [deprecated = true]; // [!code focus] // Keep original type ","content":"Good message SearchRequest { string query = 1; oneof filter { string category = 2 [deprecated = true]; // [!code focus] // Keep original type int32 user_id = 3 [deprecated = true]; // [!code focus] // Keep original type bool is_premium = 4 [deprecated = true]; // [!code focus] // Keep original type DateRange date_range = 5 [deprecated = true]; // [!code focus] // Keep original type int32 category_id = 6; // [!code focus] // New field with desired type string user_identifier = 7; // [!code focus] // New field with desired type string premium_status = 8; // [!code focus] // New field with desired type string date_filter = 9; // [!code focus] // New field with desired type } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::good::12","title":"ONEOF_FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#good","headings":["Good"],"excerpt":"Good **Or create a new oneOf group:** ```proto syntax = \"proto3\";","content":"Good **Or create a new oneOf group:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::good::13","title":"ONEOF_FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#good","headings":["Good"],"excerpt":"Good message SearchRequest { string query = 1; oneof filter { option deprecated = true; // [!code focus] // Deprecate old oneOf string category = 2 [deprecated = true]; // [!code focus] int32 user_id = 3 [deprecated = tr","content":"Good message SearchRequest { string query = 1; oneof filter { option deprecated = true; // [!code focus] // Deprecate old oneOf string category = 2 [deprecated = true]; // [!code focus] int32 user_id = 3 [deprecated = true]; // [!code focus] bool is_premium = 4 [deprecated = true]; // [!code focus] DateRange date_range = 5 [deprecated = true]; // [!code focus] } oneof filter_v2 { // [!code focus] // New oneOf with correct types int32 category_id = 6; // [!code focus] string user_identifier = 7; // [!code focus] PremiumFilter premium_filter = 8; // [!code focus] TimeFilter time_filter = 9; // [!code focus] } // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::impact::14","title":"ONEOF_FIELD_SAME_TYPE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Binary data cannot be deserialized correctly between versions **Generated Code:** OneOf wrapper types change, breaking client compilation **Type Safety:** Switch statements on oneOf types break wi","content":"Impact **Wire Format:** Binary data cannot be deserialized correctly between versions **Generated Code:** OneOf wrapper types change, breaking client compilation **Type Safety:** Switch statements on oneOf types break with compilation errors **Runtime Errors:** Type mismatches cause parsing failures for existing data"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::15","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works searchReq := &myapi.SearchRequest{ Query: \"golang jobs\", }","content":"Real-World Example **Client code breaks:** ```go // Before - this code works searchReq := &myapi.SearchRequest{ Query: \"golang jobs\", }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::16","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Set filter using oneOf (original types) searchReq.Filter = &myapi.SearchRequest_Category{ Category: \"engineering\", // string type }","content":"Real-World Example // Set filter using oneOf (original types) searchReq.Filter = &myapi.SearchRequest_Category{ Category: \"engineering\", // string type }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::17","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Handle filter types switch filter := searchReq.Filter.(type) { case *myapi.SearchRequest_Category: return searchByCategory(filter.Category) // string parameter case *myapi.SearchRequest_UserId: retu","content":"Real-World Example // Handle filter types switch filter := searchReq.Filter.(type) { case *myapi.SearchRequest_Category: return searchByCategory(filter.Category) // string parameter case *myapi.SearchRequest_UserId: return searchByUserId(filter.UserId) // int32 parameter default: return errors.New(\"unsupported filter\") }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::18","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After type change - compilation fails searchReq.Filter = &myapi.SearchRequest_Category{ Category: \"engineering\", // ERROR: expects int32, not string }","content":"Real-World Example // After type change - compilation fails searchReq.Filter = &myapi.SearchRequest_Category{ Category: \"engineering\", // ERROR: expects int32, not string }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::19","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Switch statement breaks switch filter := searchReq.Filter.(type) { case *myapi.SearchRequest_Category: return searchByCategory(filter.Category) // ERROR: Category is now int32 case *myapi.SearchRequ","content":"Real-World Example // Switch statement breaks switch filter := searchReq.Filter.(type) { case *myapi.SearchRequest_Category: return searchByCategory(filter.Category) // ERROR: Category is now int32 case *myapi.SearchRequest_UserId: return searchByUserId(filter.UserId) // ERROR: UserId is now string } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::20","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server implementation breaks:** ```go // Before - server expects original types func handleSearchFilter(req *SearchRequest) (*SearchResult, error) { switch filter := req.Filter.(type) { case *SearchR","content":"Real-World Example **Server implementation breaks:** ```go // Before - server expects original types func handleSearchFilter(req *SearchRequest) (*SearchResult, error) { switch filter := req.Filter.(type) { case *SearchRequest_Category: categoryName := filter.Category // string return searchDatabase(\"category\", categoryName), nil case *SearchRequest_UserId: userId := filter.UserId // int32 return searchDatabase(\"user_id\", strconv.Itoa(int(userId))), nil default: return nil, errors.New(\"no filter specified\") } }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::21","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After type change - runtime errors func handleSearchFilter(req *SearchRequest) (*SearchResult, error) { switch filter := req.Filter.(type) { case *SearchRequest_Category: categoryId := filter.Catego","content":"Real-World Example // After type change - runtime errors func handleSearchFilter(req *SearchRequest) (*SearchResult, error) { switch filter := req.Filter.(type) { case *SearchRequest_Category: categoryId := filter.Category // now int32, but code expects string return searchDatabase(\"category\", categoryId), nil // ERROR: type mismatch case *SearchRequest_UserId: userIdStr := filter.UserId // now string, but conversion logic expects int32 userId, _ := strconv.Atoi(userIdStr) // Works but semantics changed return searchDatabase(\"user_id\", strconv.Itoa(userId)), nil } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::22","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Existing data corruption:** ```json // Serialized data before type change { \"query\": \"golang jobs\", \"category\": \"engineering\" }","content":"Real-World Example **Existing data corruption:** ```json // Serialized data before type change { \"query\": \"golang jobs\", \"category\": \"engineering\" }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::23","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After changing category from string to int32 // Data cannot be deserialized - \"engineering\" is not a valid int32 // Results in parsing errors or data loss ```","content":"Real-World Example // After changing category from string to int32 // Data cannot be deserialized - \"engineering\" is not a valid int32 // Results in parsing errors or data loss ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::migration-strategy::24","title":"ONEOF_FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Add new oneOf fields** with correct types:","content":"Migration Strategy **Add new oneOf fields** with correct types:"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::migration-strategy::25","title":"ONEOF_FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update server code** to handle both old and new fields:","content":"Migration Strategy **Update server code** to handle both old and new fields:"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::migration-strategy::26","title":"ONEOF_FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Migrate clients** to use new fields:","content":"Migration Strategy **Migrate clients** to use new fields:"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::migration-strategy::27","title":"ONEOF_FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Provide migration utilities** for data conversion:","content":"Migration Strategy **Provide migration utilities** for data conversion:"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::migration-strategy::28","title":"ONEOF_FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove old fields** in next major version:","content":"Migration Strategy **Remove old fields** in next major version:"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::type-change-compatibility-matrix::29","title":"ONEOF_FIELD_SAME_TYPE","section":"Type Change Compatibility Matrix","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#type-change-compatibility-matrix","headings":["Type Change Compatibility Matrix"],"excerpt":"Type Change Compatibility Matrix","content":"Type Change Compatibility Matrix"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::never-compatible-always-breaking::30","title":"ONEOF_FIELD_SAME_TYPE","section":"Never Compatible (Always Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#never-compatible-always-breaking","headings":["Never Compatible (Always Breaking)"],"excerpt":"Never Compatible (Always Breaking) From Type To Type Result ----------- --------- --------- string int32/int64 ❌ BREAKING int32 string ❌ BREAKING bool string ❌ BREAKING message string ❌ BREAKING string message ❌ BREAKING","content":"Never Compatible (Always Breaking) From Type To Type Result ----------- --------- --------- string int32/int64 ❌ BREAKING int32 string ❌ BREAKING bool string ❌ BREAKING message string ❌ BREAKING string message ❌ BREAKING enum int32 ❌ BREAKING"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::generated-code-impact::31","title":"ONEOF_FIELD_SAME_TYPE","section":"Generated Code Impact","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#generated-code-impact","headings":["Generated Code Impact"],"excerpt":"Generated Code Impact ```go // String to int32 change breaks wrapper types // Before: type SearchRequest_Category struct { Category string }","content":"Generated Code Impact ```go // String to int32 change breaks wrapper types // Before: type SearchRequest_Category struct { Category string }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::generated-code-impact::32","title":"ONEOF_FIELD_SAME_TYPE","section":"Generated Code Impact","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#generated-code-impact","headings":["Generated Code Impact"],"excerpt":"Generated Code Impact // After: type SearchRequest_Category struct { Category int32 // Different type - compilation fails }","content":"Generated Code Impact // After: type SearchRequest_Category struct { Category int32 // Different type - compilation fails }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::generated-code-impact::33","title":"ONEOF_FIELD_SAME_TYPE","section":"Generated Code Impact","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#generated-code-impact","headings":["Generated Code Impact"],"excerpt":"Generated Code Impact // All client code using SearchRequest_Category breaks ```","content":"Generated Code Impact // All client code using SearchRequest_Category breaks ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::wire-format-considerations::34","title":"ONEOF_FIELD_SAME_TYPE","section":"Wire Format Considerations","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#wire-format-considerations","headings":["Wire Format Considerations"],"excerpt":"Wire Format Considerations ```proto // OneOf fields in wire format are identified by field number // Type changes break deserialization even if field number stays same","content":"Wire Format Considerations ```proto // OneOf fields in wire format are identified by field number // Type changes break deserialization even if field number stays same"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::wire-format-considerations::35","title":"ONEOF_FIELD_SAME_TYPE","section":"Wire Format Considerations","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#wire-format-considerations","headings":["Wire Format Considerations"],"excerpt":"Wire Format Considerations message Request { oneof data { string text = 1; // Wire tag: 1, type: string // int32 text = 1; // Same wire tag, different type - BREAKING! } } ```","content":"Wire Format Considerations message Request { oneof data { string text = 1; // Wire tag: 1, type: string // int32 text = 1; // Same wire tag, different type - BREAKING! } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::type-safe-validation-before-change::36","title":"ONEOF_FIELD_SAME_TYPE","section":"Type-Safe Validation (Before Change)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#type-safe-validation-before-change","headings":["Type-Safe Validation (Before Change)"],"excerpt":"Type-Safe Validation (Before Change)","content":"Type-Safe Validation (Before Change)"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::broken-validation-after-type-change::37","title":"ONEOF_FIELD_SAME_TYPE","section":"Broken Validation (After Type Change)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#broken-validation-after-type-change","headings":["Broken Validation (After Type Change)"],"excerpt":"Broken Validation (After Type Change)","content":"Broken Validation (After Type Change)"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::0","title":"ONEOF_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":[],"excerpt":"This rule checks that no oneOf fields are deleted from messages. Deleting a oneOf breaks both wire format compatibility and generated code, as existing data may use the oneOf structure and client code depends on the gene","content":"This rule checks that no oneOf fields are deleted from messages. Deleting a oneOf breaks both wire format compatibility and generated code, as existing data may use the oneOf structure and client code depends on the generated oneOf types and accessor methods."},{"id":"cli/breaking-changes/rules/oneof-no-delete::bad::1","title":"ONEOF_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-no-delete::bad::2","title":"ONEOF_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#bad","headings":["Bad"],"excerpt":"Bad message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4; } }","content":"Bad message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4; } }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::bad::3","title":"ONEOF_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#bad","headings":["Bad"],"excerpt":"Bad message PaymentMethod { // [!code --] oneof method { // [!code --] CreditCard credit_card = 1; // [!code --] BankAccount bank_account = 2; // [!code --] PayPal paypal = 3; // [!code --] } // [!code --] } // [!code --","content":"Bad message PaymentMethod { // [!code --] oneof method { // [!code --] CreditCard credit_card = 1; // [!code --] BankAccount bank_account = 2; // [!code --] PayPal paypal = 3; // [!code --] } // [!code --] } // [!code --]"},{"id":"cli/breaking-changes/rules/oneof-no-delete::bad::4","title":"ONEOF_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Order { string id = 1; PaymentMethod payment = 2; } ```","content":"Bad message Order { string id = 1; PaymentMethod payment = 2; } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::bad::5","title":"ONEOF_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-no-delete::bad::6","title":"ONEOF_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#bad","headings":["Bad"],"excerpt":"Bad message LoginRequest { string username = 1; // credentials oneof was deleted - BREAKING CHANGE! string password = 2; // Now regular fields string api_key = 3; // Lost exclusive semantics string oauth_token = 4; }","content":"Bad message LoginRequest { string username = 1; // credentials oneof was deleted - BREAKING CHANGE! string password = 2; // Now regular fields string api_key = 3; // Lost exclusive semantics string oauth_token = 4; }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::bad::7","title":"ONEOF_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#bad","headings":["Bad"],"excerpt":"Bad message PaymentMethod { // method oneof was deleted - BREAKING CHANGE! CreditCard credit_card = 1; // Now all can be set simultaneously BankAccount bank_account = 2; PayPal paypal = 3; }","content":"Bad message PaymentMethod { // method oneof was deleted - BREAKING CHANGE! CreditCard credit_card = 1; // Now all can be set simultaneously BankAccount bank_account = 2; PayPal paypal = 3; }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::bad::8","title":"ONEOF_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Order { string id = 1; PaymentMethod payment = 2; } ```","content":"Bad message Order { string id = 1; PaymentMethod payment = 2; } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::more-examples::9","title":"ONEOF_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples **Nested oneOf deletion:**","content":"More Examples **Nested oneOf deletion:**"},{"id":"cli/breaking-changes/rules/oneof-no-delete::more-examples::10","title":"ONEOF_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before message UserProfile { string name = 1; message ContactInfo { oneof contact_method { // [!code --] string email = 1; // [!code --] string phone = 2; // [!code --] string slack_id = 3; // [","content":"More Examples ```proto // Before message UserProfile { string name = 1; message ContactInfo { oneof contact_method { // [!code --] string email = 1; // [!code --] string phone = 2; // [!code --] string slack_id = 3; // [!code --] } // [!code --] } ContactInfo contact = 2; }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::more-examples::11","title":"ONEOF_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - BREAKING CHANGE! message UserProfile { string name = 1; message ContactInfo { // contact_method oneof was deleted string email = 1; // No longer mutually exclusive string phone = 2; // Can set al","content":"More Examples // After - BREAKING CHANGE! message UserProfile { string name = 1; message ContactInfo { // contact_method oneof was deleted string email = 1; // No longer mutually exclusive string phone = 2; // Can set all fields now string slack_id = 3; } ContactInfo contact = 2; } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::good::12","title":"ONEOF_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, deprecate the oneOf:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, deprecate the oneOf:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-no-delete::good::13","title":"ONEOF_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#good","headings":["Good"],"excerpt":"Good message LoginRequest { string username = 1; oneof credentials { option deprecated = true; // [!code focus] string password = 2 [deprecated = true]; // [!code focus] string api_key = 3 [deprecated = true]; // [!code ","content":"Good message LoginRequest { string username = 1; oneof credentials { option deprecated = true; // [!code focus] string password = 2 [deprecated = true]; // [!code focus] string api_key = 3 [deprecated = true]; // [!code focus] string oauth_token = 4 [deprecated = true]; // [!code focus] } }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::good::14","title":"ONEOF_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#good","headings":["Good"],"excerpt":"Good message PaymentMethod { oneof method { option deprecated = true; // [!code focus] CreditCard credit_card = 1 [deprecated = true]; // [!code focus] BankAccount bank_account = 2 [deprecated = true]; // [!code focus] P","content":"Good message PaymentMethod { oneof method { option deprecated = true; // [!code focus] CreditCard credit_card = 1 [deprecated = true]; // [!code focus] BankAccount bank_account = 2 [deprecated = true]; // [!code focus] PayPal paypal = 3 [deprecated = true]; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::good::15","title":"ONEOF_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#good","headings":["Good"],"excerpt":"Good **Or replace with new structure:** ```proto syntax = \"proto3\";","content":"Good **Or replace with new structure:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-no-delete::good::16","title":"ONEOF_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#good","headings":["Good"],"excerpt":"Good message LoginRequest { string username = 1; oneof credentials { option deprecated = true; // [!code focus] // Old oneOf string password = 2 [deprecated = true]; // [!code focus] string api_key = 3 [deprecated = true","content":"Good message LoginRequest { string username = 1; oneof credentials { option deprecated = true; // [!code focus] // Old oneOf string password = 2 [deprecated = true]; // [!code focus] string api_key = 3 [deprecated = true]; // [!code focus] string oauth_token = 4 [deprecated = true]; // [!code focus] } oneof auth_method { // [!code focus] // New oneOf with better design PasswordAuth password_auth = 5; // [!code focus] ApiKeyAuth api_auth = 6; // [!code focus] OAuthAuth oauth_auth = 7; // [!code focus] } // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::impact::17","title":"ONEOF_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** OneOf semantics are lost - fields are no longer mutually exclusive **Generated Code:** OneOf accessor methods are removed, breaking client compilation **Business Logic:** Mutual exclusivity constr","content":"Impact **Wire Format:** OneOf semantics are lost - fields are no longer mutually exclusive **Generated Code:** OneOf accessor methods are removed, breaking client compilation **Business Logic:** Mutual exclusivity constraints are violated **Validation:** Client code expecting only one field to be set may break"},{"id":"cli/breaking-changes/rules/oneof-no-delete::real-world-example::18","title":"ONEOF_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - oneOf provides mutual exclusivity loginReq := &myapi.LoginRequest{ Username: \"user123\", }","content":"Real-World Example **Client code breaks:** ```go // Before - oneOf provides mutual exclusivity loginReq := &myapi.LoginRequest{ Username: \"user123\", }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::real-world-example::19","title":"ONEOF_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Set one of the credential options (oneOf semantics) loginReq.Credentials = &myapi.LoginRequest_Password{ Password: \"secret123\", }","content":"Real-World Example // Set one of the credential options (oneOf semantics) loginReq.Credentials = &myapi.LoginRequest_Password{ Password: \"secret123\", }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::real-world-example::20","title":"ONEOF_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Check which credential type is set switch cred := loginReq.Credentials.(type) { case *myapi.LoginRequest_Password: // ERROR after oneOf deletion return authenticatePassword(cred.Password) case *myap","content":"Real-World Example // Check which credential type is set switch cred := loginReq.Credentials.(type) { case *myapi.LoginRequest_Password: // ERROR after oneOf deletion return authenticatePassword(cred.Password) case *myapi.LoginRequest_ApiKey: // ERROR after oneOf deletion return authenticateApiKey(cred.ApiKey) default: return errors.New(\"no credentials provided\") }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::real-world-example::21","title":"ONEOF_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Generated code compilation fails: // undefined: myapi.LoginRequest_Password // undefined field: loginReq.Credentials ```","content":"Real-World Example // Generated code compilation fails: // undefined: myapi.LoginRequest_Password // undefined field: loginReq.Credentials ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::real-world-example::22","title":"ONEOF_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server validation breaks:** ```go // Before - server validates oneOf semantics func validateLoginRequest(req *LoginRequest) error { if req.Credentials == nil { return errors.New(\"credentials required","content":"Real-World Example **Server validation breaks:** ```go // Before - server validates oneOf semantics func validateLoginRequest(req *LoginRequest) error { if req.Credentials == nil { return errors.New(\"credentials required\") } // OneOf ensures only one credential type is set switch req.Credentials.(type) { case *LoginRequest_Password: return validatePassword(req.GetPassword()) case *LoginRequest_ApiKey: return validateApiKey(req.GetApiKey()) case *LoginRequest_OauthToken: return validateOAuthToken(req.GetOauthToken()) default: return errors.New(\"unknown credential type\") } }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::real-world-example::23","title":"ONEOF_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After oneOf deletion - validation logic breaks func validateLoginRequest(req *LoginRequest) error { // No more oneOf - multiple fields can be set! credCount := 0 if req.Password != \"\" { credCount++ ","content":"Real-World Example // After oneOf deletion - validation logic breaks func validateLoginRequest(req *LoginRequest) error { // No more oneOf - multiple fields can be set! credCount := 0 if req.Password != \"\" { credCount++ } if req.ApiKey != \"\" { credCount++ } if req.OauthToken != \"\" { credCount++ } if credCount == 0 { return errors.New(\"no credentials provided\") } if credCount > 1 { return errors.New(\"multiple credentials provided\") // Manual check needed! } // Lost type safety - need manual checks if req.Password != \"\" { return validatePassword(req.Password) } // ... more manual validation } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::real-world-example::24","title":"ONEOF_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Business logic problems:** ```go // Before - oneOf guarantees mutual exclusivity payment := &PaymentMethod{ Method: &PaymentMethod_CreditCard{ CreditCard: &CreditCard{Number: \"1234\"}, }, } // Impossi","content":"Real-World Example **Business logic problems:** ```go // Before - oneOf guarantees mutual exclusivity payment := &PaymentMethod{ Method: &PaymentMethod_CreditCard{ CreditCard: &CreditCard{Number: \"1234\"}, }, } // Impossible to set multiple payment methods simultaneously"},{"id":"cli/breaking-changes/rules/oneof-no-delete::real-world-example::25","title":"ONEOF_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After oneOf deletion - business logic can break payment := &PaymentMethod{ CreditCard: &CreditCard{Number: \"1234\"}, BankAccount: &BankAccount{Number: \"5678\"}, // Both set! Logic breaks! } ```","content":"Real-World Example // After oneOf deletion - business logic can break payment := &PaymentMethod{ CreditCard: &CreditCard{Number: \"1234\"}, BankAccount: &BankAccount{Number: \"5678\"}, // Both set! Logic breaks! } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::migration-strategy::26","title":"ONEOF_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate the oneOf and all its fields:**","content":"Migration Strategy **Deprecate the oneOf and all its fields:**"},{"id":"cli/breaking-changes/rules/oneof-no-delete::migration-strategy::27","title":"ONEOF_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Create new structure** if needed:","content":"Migration Strategy **Create new structure** if needed:"},{"id":"cli/breaking-changes/rules/oneof-no-delete::migration-strategy::28","title":"ONEOF_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update server code** to handle both during transition:","content":"Migration Strategy **Update server code** to handle both during transition:"},{"id":"cli/breaking-changes/rules/oneof-no-delete::migration-strategy::29","title":"ONEOF_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Migrate clients** to use new structure:","content":"Migration Strategy **Migrate clients** to use new structure:"},{"id":"cli/breaking-changes/rules/oneof-no-delete::migration-strategy::30","title":"ONEOF_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove old oneOf** in next major version","content":"Migration Strategy **Remove old oneOf** in next major version"},{"id":"cli/breaking-changes/rules/oneof-no-delete::replacing-oneof-with-regular-fields::31","title":"ONEOF_NO_DELETE","section":"Replacing OneOf with Regular Fields","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#replacing-oneof-with-regular-fields","headings":["Replacing OneOf with Regular Fields"],"excerpt":"Replacing OneOf with Regular Fields ```proto // Instead of removing oneOf structure entirely message SearchRequest { // Don't delete oneOf - breaks mutual exclusivity string text_query = 1; // BREAKING: was in oneOf int3","content":"Replacing OneOf with Regular Fields ```proto // Instead of removing oneOf structure entirely message SearchRequest { // Don't delete oneOf - breaks mutual exclusivity string text_query = 1; // BREAKING: was in oneOf int32 user_id = 2; // BREAKING: was in oneOf string category = 3; // BREAKING: was in oneOf }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::replacing-oneof-with-regular-fields::32","title":"ONEOF_NO_DELETE","section":"Replacing OneOf with Regular Fields","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#replacing-oneof-with-regular-fields","headings":["Replacing OneOf with Regular Fields"],"excerpt":"Replacing OneOf with Regular Fields // Keep oneOf, add new fields if needed message SearchRequest { oneof query { option deprecated = true; string text_query = 1 [deprecated = true]; int32 user_id = 2 [deprecated = true]","content":"Replacing OneOf with Regular Fields // Keep oneOf, add new fields if needed message SearchRequest { oneof query { option deprecated = true; string text_query = 1 [deprecated = true]; int32 user_id = 2 [deprecated = true]; string category = 3 [deprecated = true]; } // Add new non-exclusive fields if that's the intent string search_text = 4; repeated string filters = 5; } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::simplifying-message-structure::33","title":"ONEOF_NO_DELETE","section":"Simplifying Message Structure","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#simplifying-message-structure","headings":["Simplifying Message Structure"],"excerpt":"Simplifying Message Structure ```proto // Instead of flattening oneOf structure message NotificationSettings { // Don't delete oneOf - loses type safety string email = 1; // BREAKING: was in oneOf string phone = 2; // BR","content":"Simplifying Message Structure ```proto // Instead of flattening oneOf structure message NotificationSettings { // Don't delete oneOf - loses type safety string email = 1; // BREAKING: was in oneOf string phone = 2; // BREAKING: was in oneOf string webhook_url = 3; // BREAKING: was in oneOf }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::simplifying-message-structure::34","title":"ONEOF_NO_DELETE","section":"Simplifying Message Structure","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#simplifying-message-structure","headings":["Simplifying Message Structure"],"excerpt":"Simplifying Message Structure // Keep oneOf for type safety message NotificationSettings { oneof delivery_method { EmailNotification email = 1; SmsNotification phone = 2; WebhookNotification webhook = 3; } } ```","content":"Simplifying Message Structure // Keep oneOf for type safety message NotificationSettings { oneof delivery_method { EmailNotification email = 1; SmsNotification phone = 2; WebhookNotification webhook = 3; } } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::proto-syntax-migration::35","title":"ONEOF_NO_DELETE","section":"Proto Syntax Migration","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#proto-syntax-migration","headings":["Proto Syntax Migration"],"excerpt":"Proto Syntax Migration ```proto // When migrating from proto2 to proto3 // Don't lose oneOf semantics during migration","content":"Proto Syntax Migration ```proto // When migrating from proto2 to proto3 // Don't lose oneOf semantics during migration"},{"id":"cli/breaking-changes/rules/oneof-no-delete::proto-syntax-migration::36","title":"ONEOF_NO_DELETE","section":"Proto Syntax Migration","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#proto-syntax-migration","headings":["Proto Syntax Migration"],"excerpt":"Proto Syntax Migration // proto2 message Request { optional string name = 1; oneof data { string text = 2; int32 number = 3; } }","content":"Proto Syntax Migration // proto2 message Request { optional string name = 1; oneof data { string text = 2; int32 number = 3; } }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::proto-syntax-migration::37","title":"ONEOF_NO_DELETE","section":"Proto Syntax Migration","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#proto-syntax-migration","headings":["Proto Syntax Migration"],"excerpt":"Proto Syntax Migration // proto3 - keep oneOf structure message Request { string name = 1; oneof data { // Don't delete this! string text = 2; int32 number = 3; } } ```","content":"Proto Syntax Migration // proto3 - keep oneOf structure message Request { string name = 1; oneof data { // Don't delete this! string text = 2; int32 number = 3; } } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::what-oneof-provides::38","title":"ONEOF_NO_DELETE","section":"What OneOf Provides","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#what-oneof-provides","headings":["What OneOf Provides"],"excerpt":"What OneOf Provides **Mutual Exclusivity**: Only one field can be set at a time **Type Safety**: Generated code enforces single choice **Clear Intent**: API design expresses \"choose one\" semantics **Efficient Wire Format","content":"What OneOf Provides **Mutual Exclusivity**: Only one field can be set at a time **Type Safety**: Generated code enforces single choice **Clear Intent**: API design expresses \"choose one\" semantics **Efficient Wire Format**: Only selected field is serialized"},{"id":"cli/breaking-changes/rules/oneof-no-delete::whats-lost-when-deleted::39","title":"ONEOF_NO_DELETE","section":"What's Lost When Deleted","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#whats-lost-when-deleted","headings":["What's Lost When Deleted"],"excerpt":"What's Lost When Deleted **Business Logic**: No enforcement of mutual exclusivity **Generated Code**: No oneOf wrapper types or methods **Validation**: Manual checks needed for exclusivity **API Clarity**: Intent of \"cho","content":"What's Lost When Deleted **Business Logic**: No enforcement of mutual exclusivity **Generated Code**: No oneOf wrapper types or methods **Validation**: Manual checks needed for exclusivity **API Clarity**: Intent of \"choose one\" is lost"},{"id":"cli/breaking-changes/rules/oneof-no-delete::generated-code-impact::40","title":"ONEOF_NO_DELETE","section":"Generated Code Impact","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#generated-code-impact","headings":["Generated Code Impact"],"excerpt":"Generated Code Impact ```go // With oneOf - type safe type LoginRequest struct { Username string // Types that are assignable to Credentials: // *LoginRequest_Password // *LoginRequest_ApiKey Credentials isLoginRequest_C","content":"Generated Code Impact ```go // With oneOf - type safe type LoginRequest struct { Username string // Types that are assignable to Credentials: // *LoginRequest_Password // *LoginRequest_ApiKey Credentials isLoginRequest_Credentials }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::generated-code-impact::41","title":"ONEOF_NO_DELETE","section":"Generated Code Impact","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#generated-code-impact","headings":["Generated Code Impact"],"excerpt":"Generated Code Impact // Without oneOf - no type safety type LoginRequest struct { Username string Password string // All can be set simultaneously ApiKey string // No mutual exclusivity OauthToken string } ```","content":"Generated Code Impact // Without oneOf - no type safety type LoginRequest struct { Username string Password string // All can be set simultaneously ApiKey string // No mutual exclusivity OauthToken string } ```"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::0","title":"RPC_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":[],"excerpt":"This rule checks that no RPC methods are deleted from services. Deleting an RPC method breaks both generated code and client applications that call the method.","content":"This rule checks that no RPC methods are deleted from services. Deleting an RPC method breaks both generated code and client applications that call the method."},{"id":"cli/breaking-changes/rules/rpc-no-delete::bad::1","title":"RPC_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-no-delete::bad::2","title":"RPC_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#bad","headings":["Bad"],"excerpt":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse); // [!code -","content":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse); // [!code --] } ```"},{"id":"cli/breaking-changes/rules/rpc-no-delete::bad::3","title":"RPC_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-no-delete::bad::4","title":"RPC_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#bad","headings":["Bad"],"excerpt":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); // DeleteUser RPC was deleted - BREAKING CHANGE! } ```","content":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); // DeleteUser RPC was deleted - BREAKING CHANGE! } ```"},{"id":"cli/breaking-changes/rules/rpc-no-delete::good::5","title":"RPC_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, deprecate the RPC:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, deprecate the RPC:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-no-delete::good::6","title":"RPC_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#good","headings":["Good"],"excerpt":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse) { option de","content":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse) { option deprecated = true; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/rpc-no-delete::impact::7","title":"RPC_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Generated Code:** RPC method stubs are removed, breaking client compilation **Client Applications:** Existing calls to the RPC fail to compile **Runtime:** gRPC clients lose method definition","content":"Impact **Generated Code:** RPC method stubs are removed, breaking client compilation **Client Applications:** Existing calls to the RPC fail to compile **Runtime:** gRPC clients lose method definition"},{"id":"cli/breaking-changes/rules/rpc-no-delete::migration-strategy::8","title":"RPC_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate first:**","content":"Migration Strategy **Deprecate first:**"},{"id":"cli/breaking-changes/rules/rpc-no-delete::migration-strategy::9","title":"RPC_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Return error from implementation** indicating method is no longer supported","content":"Migration Strategy **Return error from implementation** indicating method is no longer supported"},{"id":"cli/breaking-changes/rules/rpc-no-delete::migration-strategy::10","title":"RPC_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove in next major version** after clients have migrated","content":"Migration Strategy **Remove in next major version** after clients have migrated"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::0","title":"RPC_SAME_REQUEST_TYPE","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":[],"excerpt":"This rule checks that RPC methods maintain the same request message type. Changing an RPC's request type breaks both wire format compatibility and generated code, as clients expect specific message structures when callin","content":"This rule checks that RPC methods maintain the same request message type. Changing an RPC's request type breaks both wire format compatibility and generated code, as clients expect specific message structures when calling the method."},{"id":"cli/breaking-changes/rules/rpc-same-request-type::bad::1","title":"RPC_SAME_REQUEST_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::bad::2","title":"RPC_SAME_REQUEST_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#bad","headings":["Bad"],"excerpt":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); }","content":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::bad::3","title":"RPC_SAME_REQUEST_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#bad","headings":["Bad"],"excerpt":"Bad message GetUserRequest { string user_id = 1; }","content":"Bad message GetUserRequest { string user_id = 1; }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::bad::4","title":"RPC_SAME_REQUEST_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#bad","headings":["Bad"],"excerpt":"Bad message UpdateUserRequest { string user_id = 1; string name = 2; string email = 3; } ```","content":"Bad message UpdateUserRequest { string user_id = 1; string name = 2; string email = 3; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::bad::5","title":"RPC_SAME_REQUEST_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::bad::6","title":"RPC_SAME_REQUEST_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#bad","headings":["Bad"],"excerpt":"Bad service UserService { rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // [!code --] Changed request type rpc UpdateUser(UserUpdateRequest) returns (UpdateUserResponse); // [!code --] Changed request type }","content":"Bad service UserService { rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // [!code --] Changed request type rpc UpdateUser(UserUpdateRequest) returns (UpdateUserResponse); // [!code --] Changed request type }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::bad::7","title":"RPC_SAME_REQUEST_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#bad","headings":["Bad"],"excerpt":"Bad message GetUserRequestV2 { // [!code --] Different message type string id = 1; bool include_profile = 2; }","content":"Bad message GetUserRequestV2 { // [!code --] Different message type string id = 1; bool include_profile = 2; }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::bad::8","title":"RPC_SAME_REQUEST_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#bad","headings":["Bad"],"excerpt":"Bad message UserUpdateRequest { // [!code --] Different message type string id = 1; UserProfile profile = 2; } ```","content":"Bad message UserUpdateRequest { // [!code --] Different message type string id = 1; UserProfile profile = 2; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::more-examples::9","title":"RPC_SAME_REQUEST_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#more-examples","headings":["More Examples"],"excerpt":"More Examples **Cross-package type changes:**","content":"More Examples **Cross-package type changes:**"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::more-examples::10","title":"RPC_SAME_REQUEST_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before import \"common/user.proto\";","content":"More Examples ```proto // Before import \"common/user.proto\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::more-examples::11","title":"RPC_SAME_REQUEST_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#more-examples","headings":["More Examples"],"excerpt":"More Examples service UserService { rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"More Examples service UserService { rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::more-examples::12","title":"RPC_SAME_REQUEST_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - BREAKING CHANGE! import \"v2/user.proto\";","content":"More Examples // After - BREAKING CHANGE! import \"v2/user.proto\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::more-examples::13","title":"RPC_SAME_REQUEST_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#more-examples","headings":["More Examples"],"excerpt":"More Examples service UserService { rpc CreateUser(v2.CreateUserRequest) returns (CreateUserResponse); // Different package } ```","content":"More Examples service UserService { rpc CreateUser(v2.CreateUserRequest) returns (CreateUserResponse); // Different package } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::good::14","title":"RPC_SAME_REQUEST_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#good","headings":["Good"],"excerpt":"Good **Instead of changing request type, version the RPC:** ```proto syntax = \"proto3\";","content":"Good **Instead of changing request type, version the RPC:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::good::15","title":"RPC_SAME_REQUEST_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#good","headings":["Good"],"excerpt":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; // [!code focus] } rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse); // [!code focus] // New RPC metho","content":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; // [!code focus] } rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse); // [!code focus] // New RPC method rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) { option deprecated = true; // [!code focus] } rpc UpdateUserV2(UserUpdateRequest) returns (UpdateUserResponse); // [!code focus] // New RPC method }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::good::16","title":"RPC_SAME_REQUEST_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#good","headings":["Good"],"excerpt":"Good // Keep old messages for backward compatibility message GetUserRequest { string user_id = 1; }","content":"Good // Keep old messages for backward compatibility message GetUserRequest { string user_id = 1; }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::good::17","title":"RPC_SAME_REQUEST_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#good","headings":["Good"],"excerpt":"Good // Add new messages for enhanced functionality message GetUserRequestV2 { // [!code focus] string id = 1; // [!code focus] bool include_profile = 2; // [!code focus] } // [!code focus] ```","content":"Good // Add new messages for enhanced functionality message GetUserRequestV2 { // [!code focus] string id = 1; // [!code focus] bool include_profile = 2; // [!code focus] } // [!code focus] ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::good::18","title":"RPC_SAME_REQUEST_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#good","headings":["Good"],"excerpt":"Good **Or create a new service version:** ```proto syntax = \"proto3\";","content":"Good **Or create a new service version:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::good::19","title":"RPC_SAME_REQUEST_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#good","headings":["Good"],"excerpt":"Good package myapi.v2; // [!code focus] // New package version","content":"Good package myapi.v2; // [!code focus] // New package version"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::good::20","title":"RPC_SAME_REQUEST_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#good","headings":["Good"],"excerpt":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] // Clean interface in v2 rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus] }","content":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] // Clean interface in v2 rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus] }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::good::21","title":"RPC_SAME_REQUEST_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#good","headings":["Good"],"excerpt":"Good message GetUserRequest { // [!code focus] string id = 1; // [!code focus] // Improved field names bool include_profile = 2; // [!code focus] } // [!code focus] ```","content":"Good message GetUserRequest { // [!code focus] string id = 1; // [!code focus] // Improved field names bool include_profile = 2; // [!code focus] } // [!code focus] ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::impact::22","title":"RPC_SAME_REQUEST_TYPE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Existing client requests cannot be deserialized by new server **Generated Code:** Client stubs expect different request message types, breaking compilation **gRPC Calls:** Method signatures change","content":"Impact **Wire Format:** Existing client requests cannot be deserialized by new server **Generated Code:** Client stubs expect different request message types, breaking compilation **gRPC Calls:** Method signatures change in generated client code **Runtime Errors:** Type mismatches cause RPC call failures"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::real-world-example::23","title":"RPC_SAME_REQUEST_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", })","content":"Real-World Example **Client code breaks:** ```go // Before - this code works client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", })"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::real-world-example::24","title":"RPC_SAME_REQUEST_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After request type change - compilation fails client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ // ERROR: type not found UserId: \"user123\", // ERROR:","content":"Real-World Example // After request type change - compilation fails client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ // ERROR: type not found UserId: \"user123\", // ERROR: field not found })"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::real-world-example::25","title":"RPC_SAME_REQUEST_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Must use new type: resp, err := client.GetUser(ctx, &myapi.GetUserRequestV2{ Id: \"user123\", // Different field name IncludeProfile: true, // New required field }) ```","content":"Real-World Example // Must use new type: resp, err := client.GetUser(ctx, &myapi.GetUserRequestV2{ Id: \"user123\", // Different field name IncludeProfile: true, // New required field }) ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::real-world-example::26","title":"RPC_SAME_REQUEST_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server implementation breaks:** ```go // Before - server expects GetUserRequest func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { userID := req.UserId // ","content":"Real-World Example **Server implementation breaks:** ```go // Before - server expects GetUserRequest func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { userID := req.UserId // This field exists // ... implementation }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::real-world-example::27","title":"RPC_SAME_REQUEST_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After - server must handle GetUserRequestV2 func (s *server) GetUser(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) { userID := req.Id // Different field name includeProfile :","content":"Real-World Example // After - server must handle GetUserRequestV2 func (s *server) GetUser(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) { userID := req.Id // Different field name includeProfile := req.IncludeProfile // New field to handle // ... implementation must change } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::migration-strategy::28","title":"RPC_SAME_REQUEST_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Add new RPC method** with improved request type:","content":"Migration Strategy **Add new RPC method** with improved request type:"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::migration-strategy::29","title":"RPC_SAME_REQUEST_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Implement both methods** on server during transition:","content":"Migration Strategy **Implement both methods** on server during transition:"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::migration-strategy::30","title":"RPC_SAME_REQUEST_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Migrate clients** to use new RPC method:","content":"Migration Strategy **Migrate clients** to use new RPC method:"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::migration-strategy::31","title":"RPC_SAME_REQUEST_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove old RPC** in next major version:","content":"Migration Strategy **Remove old RPC** in next major version:"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::adding-required-fields::32","title":"RPC_SAME_REQUEST_TYPE","section":"Adding Required Fields","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#adding-required-fields","headings":["Adding Required Fields"],"excerpt":"Adding Required Fields ```proto // Instead of modifying existing request message GetUserRequest { string user_id = 1; bool include_deleted = 2; // BREAKING: new required field }","content":"Adding Required Fields ```proto // Instead of modifying existing request message GetUserRequest { string user_id = 1; bool include_deleted = 2; // BREAKING: new required field }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::adding-required-fields::33","title":"RPC_SAME_REQUEST_TYPE","section":"Adding Required Fields","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#adding-required-fields","headings":["Adding Required Fields"],"excerpt":"Adding Required Fields // Add new RPC method message GetUserRequestV2 { string user_id = 1; bool include_deleted = 2; // Safe in new method } ```","content":"Adding Required Fields // Add new RPC method message GetUserRequestV2 { string user_id = 1; bool include_deleted = 2; // Safe in new method } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::restructuring-request-data::34","title":"RPC_SAME_REQUEST_TYPE","section":"Restructuring Request Data","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#restructuring-request-data","headings":["Restructuring Request Data"],"excerpt":"Restructuring Request Data ```proto // Instead of changing field structure message UpdateUserRequest { UserProfile profile = 1; // BREAKING: was individual fields }","content":"Restructuring Request Data ```proto // Instead of changing field structure message UpdateUserRequest { UserProfile profile = 1; // BREAKING: was individual fields }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::restructuring-request-data::35","title":"RPC_SAME_REQUEST_TYPE","section":"Restructuring Request Data","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#restructuring-request-data","headings":["Restructuring Request Data"],"excerpt":"Restructuring Request Data // Version the RPC rpc UpdateUser(UpdateUserRequest) returns (...) { option deprecated = true; } rpc UpdateUserV2(UpdateUserRequestV2) returns (...); ```","content":"Restructuring Request Data // Version the RPC rpc UpdateUser(UpdateUserRequest) returns (...) { option deprecated = true; } rpc UpdateUserV2(UpdateUserRequestV2) returns (...); ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::package-migrations::36","title":"RPC_SAME_REQUEST_TYPE","section":"Package Migrations","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#package-migrations","headings":["Package Migrations"],"excerpt":"Package Migrations ```proto // Instead of changing import packages import \"v2/messages.proto\"; // BREAKING: different package","content":"Package Migrations ```proto // Instead of changing import packages import \"v2/messages.proto\"; // BREAKING: different package"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::package-migrations::37","title":"RPC_SAME_REQUEST_TYPE","section":"Package Migrations","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#package-migrations","headings":["Package Migrations"],"excerpt":"Package Migrations // Keep old RPC, add new one rpc OldMethod(v1.Request) returns (...) { option deprecated = true; } rpc NewMethod(v2.Request) returns (...); ```","content":"Package Migrations // Keep old RPC, add new one rpc OldMethod(v1.Request) returns (...) { option deprecated = true; } rpc NewMethod(v2.Request) returns (...); ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::0","title":"RPC_SAME_RESPONSE_TYPE","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":[],"excerpt":"This rule checks that RPC methods maintain the same response message type. Changing an RPC's response type breaks both wire format compatibility and generated code, as clients expect specific message structures when rece","content":"This rule checks that RPC methods maintain the same response message type. Changing an RPC's response type breaks both wire format compatibility and generated code, as clients expect specific message structures when receiving responses from the method."},{"id":"cli/breaking-changes/rules/rpc-same-response-type::bad::1","title":"RPC_SAME_RESPONSE_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::bad::2","title":"RPC_SAME_RESPONSE_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#bad","headings":["Bad"],"excerpt":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); }","content":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::bad::3","title":"RPC_SAME_RESPONSE_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#bad","headings":["Bad"],"excerpt":"Bad message GetUserResponse { string user_id = 1; string name = 2; string email = 3; }","content":"Bad message GetUserResponse { string user_id = 1; string name = 2; string email = 3; }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::bad::4","title":"RPC_SAME_RESPONSE_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#bad","headings":["Bad"],"excerpt":"Bad message UpdateUserResponse { bool success = 1; string message = 2; } ```","content":"Bad message UpdateUserResponse { bool success = 1; string message = 2; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::bad::5","title":"RPC_SAME_RESPONSE_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::bad::6","title":"RPC_SAME_RESPONSE_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#bad","headings":["Bad"],"excerpt":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponseV2); // [!code --] Changed response type rpc UpdateUser(UpdateUserRequest) returns (UserUpdateResponse); // [!code --] Changed response type }","content":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponseV2); // [!code --] Changed response type rpc UpdateUser(UpdateUserRequest) returns (UserUpdateResponse); // [!code --] Changed response type }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::bad::7","title":"RPC_SAME_RESPONSE_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#bad","headings":["Bad"],"excerpt":"Bad message GetUserResponseV2 { // [!code --] Different message type string id = 1; UserProfile profile = 2; repeated string permissions = 3; }","content":"Bad message GetUserResponseV2 { // [!code --] Different message type string id = 1; UserProfile profile = 2; repeated string permissions = 3; }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::bad::8","title":"RPC_SAME_RESPONSE_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#bad","headings":["Bad"],"excerpt":"Bad message UserUpdateResponse { // [!code --] Different message type UpdateResult result = 1; UserProfile updated_profile = 2; } ```","content":"Bad message UserUpdateResponse { // [!code --] Different message type UpdateResult result = 1; UserProfile updated_profile = 2; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::more-examples::9","title":"RPC_SAME_RESPONSE_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#more-examples","headings":["More Examples"],"excerpt":"More Examples **Cross-package type changes:**","content":"More Examples **Cross-package type changes:**"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::more-examples::10","title":"RPC_SAME_RESPONSE_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before import \"common/responses.proto\";","content":"More Examples ```proto // Before import \"common/responses.proto\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::more-examples::11","title":"RPC_SAME_RESPONSE_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#more-examples","headings":["More Examples"],"excerpt":"More Examples service UserService { rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"More Examples service UserService { rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::more-examples::12","title":"RPC_SAME_RESPONSE_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - BREAKING CHANGE! import \"v2/responses.proto\";","content":"More Examples // After - BREAKING CHANGE! import \"v2/responses.proto\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::more-examples::13","title":"RPC_SAME_RESPONSE_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#more-examples","headings":["More Examples"],"excerpt":"More Examples service UserService { rpc CreateUser(CreateUserRequest) returns (v2.CreateUserResponse); // Different package } ```","content":"More Examples service UserService { rpc CreateUser(CreateUserRequest) returns (v2.CreateUserResponse); // Different package } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::good::14","title":"RPC_SAME_RESPONSE_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#good","headings":["Good"],"excerpt":"Good **Instead of changing response type, version the RPC:** ```proto syntax = \"proto3\";","content":"Good **Instead of changing response type, version the RPC:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::good::15","title":"RPC_SAME_RESPONSE_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#good","headings":["Good"],"excerpt":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; // [!code focus] } rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2); // [!code focus] // New RPC metho","content":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; // [!code focus] } rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2); // [!code focus] // New RPC method rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) { option deprecated = true; // [!code focus] } rpc UpdateUserV2(UpdateUserRequest) returns (UserUpdateResponse); // [!code focus] // New RPC method }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::good::16","title":"RPC_SAME_RESPONSE_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#good","headings":["Good"],"excerpt":"Good // Keep old messages for backward compatibility message GetUserResponse { string user_id = 1; string name = 2; string email = 3; }","content":"Good // Keep old messages for backward compatibility message GetUserResponse { string user_id = 1; string name = 2; string email = 3; }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::good::17","title":"RPC_SAME_RESPONSE_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#good","headings":["Good"],"excerpt":"Good // Add new messages for enhanced functionality message GetUserResponseV2 { // [!code focus] string id = 1; // [!code focus] UserProfile profile = 2; // [!code focus] repeated string permissions = 3; // [!code focus]","content":"Good // Add new messages for enhanced functionality message GetUserResponseV2 { // [!code focus] string id = 1; // [!code focus] UserProfile profile = 2; // [!code focus] repeated string permissions = 3; // [!code focus] } // [!code focus] ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::good::18","title":"RPC_SAME_RESPONSE_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#good","headings":["Good"],"excerpt":"Good **Or create a new service version:** ```proto syntax = \"proto3\";","content":"Good **Or create a new service version:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::good::19","title":"RPC_SAME_RESPONSE_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#good","headings":["Good"],"excerpt":"Good package myapi.v2; // [!code focus] // New package version","content":"Good package myapi.v2; // [!code focus] // New package version"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::good::20","title":"RPC_SAME_RESPONSE_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#good","headings":["Good"],"excerpt":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] // Clean interface in v2 rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus] }","content":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] // Clean interface in v2 rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus] }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::good::21","title":"RPC_SAME_RESPONSE_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#good","headings":["Good"],"excerpt":"Good message GetUserResponse { // [!code focus] string id = 1; // [!code focus] // Improved field names UserProfile profile = 2; // [!code focus] repeated string permissions = 3; // [!code focus] } // [!code focus] ```","content":"Good message GetUserResponse { // [!code focus] string id = 1; // [!code focus] // Improved field names UserProfile profile = 2; // [!code focus] repeated string permissions = 3; // [!code focus] } // [!code focus] ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::impact::22","title":"RPC_SAME_RESPONSE_TYPE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Server responses cannot be deserialized by existing clients **Generated Code:** Client stubs expect different response message types, breaking compilation **gRPC Calls:** Method signatures change ","content":"Impact **Wire Format:** Server responses cannot be deserialized by existing clients **Generated Code:** Client stubs expect different response message types, breaking compilation **gRPC Calls:** Method signatures change in generated client code **Runtime Errors:** Type mismatches cause RPC response handling failures"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::real-world-example::23","title":"RPC_SAME_RESPONSE_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", }) if err != nil { return","content":"Real-World Example **Client code breaks:** ```go // Before - this code works client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", }) if err != nil { return err }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::real-world-example::24","title":"RPC_SAME_RESPONSE_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Access response fields userID := resp.UserId // This field exists name := resp.Name // This field exists","content":"Real-World Example // Access response fields userID := resp.UserId // This field exists name := resp.Name // This field exists"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::real-world-example::25","title":"RPC_SAME_RESPONSE_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After response type change - compilation fails client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", }) if err != nil { return err }","content":"Real-World Example // After response type change - compilation fails client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", }) if err != nil { return err }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::real-world-example::26","title":"RPC_SAME_RESPONSE_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Access response fields - COMPILATION ERRORS userID := resp.UserId // ERROR: field not found name := resp.Name // ERROR: field not found","content":"Real-World Example // Access response fields - COMPILATION ERRORS userID := resp.UserId // ERROR: field not found name := resp.Name // ERROR: field not found"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::real-world-example::27","title":"RPC_SAME_RESPONSE_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Must use new fields: userID := resp.Id // Different field name profile := resp.Profile // New structure permissions := resp.Permissions // New field ```","content":"Real-World Example // Must use new fields: userID := resp.Id // Different field name profile := resp.Profile // New structure permissions := resp.Permissions // New field ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::real-world-example::28","title":"RPC_SAME_RESPONSE_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server implementation breaks:** ```go // Before - server returns GetUserResponse func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { return &GetUserResponse","content":"Real-World Example **Server implementation breaks:** ```go // Before - server returns GetUserResponse func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { return &GetUserResponse{ UserId: \"user123\", Name: \"John Doe\", Email: \"john@example.com\", }, nil }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::real-world-example::29","title":"RPC_SAME_RESPONSE_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After - server must return GetUserResponseV2 func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) { return &GetUserResponseV2{ Id: \"user123\", // Different f","content":"Real-World Example // After - server must return GetUserResponseV2 func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) { return &GetUserResponseV2{ Id: \"user123\", // Different field name Profile: &UserProfile{ // New structure required Name: \"John Doe\", Email: \"john@example.com\", }, Permissions: []string{\"read\"}, // New field to populate }, nil } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::migration-strategy::30","title":"RPC_SAME_RESPONSE_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Add new RPC method** with improved response type:","content":"Migration Strategy **Add new RPC method** with improved response type:"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::migration-strategy::31","title":"RPC_SAME_RESPONSE_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Implement both methods** on server during transition:","content":"Migration Strategy **Implement both methods** on server during transition:"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::migration-strategy::32","title":"RPC_SAME_RESPONSE_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Migrate clients** to use new RPC method:","content":"Migration Strategy **Migrate clients** to use new RPC method:"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::migration-strategy::33","title":"RPC_SAME_RESPONSE_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove old RPC** in next major version:","content":"Migration Strategy **Remove old RPC** in next major version:"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::adding-fields-to-response::34","title":"RPC_SAME_RESPONSE_TYPE","section":"Adding Fields to Response","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#adding-fields-to-response","headings":["Adding Fields to Response"],"excerpt":"Adding Fields to Response ```proto // Instead of modifying existing response message GetUserResponse { string user_id = 1; string name = 2; UserProfile profile = 3; // BREAKING: new required field }","content":"Adding Fields to Response ```proto // Instead of modifying existing response message GetUserResponse { string user_id = 1; string name = 2; UserProfile profile = 3; // BREAKING: new required field }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::adding-fields-to-response::35","title":"RPC_SAME_RESPONSE_TYPE","section":"Adding Fields to Response","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#adding-fields-to-response","headings":["Adding Fields to Response"],"excerpt":"Adding Fields to Response // Add new RPC method message GetUserResponseV2 { string user_id = 1; string name = 2; UserProfile profile = 3; // Safe in new method } ```","content":"Adding Fields to Response // Add new RPC method message GetUserResponseV2 { string user_id = 1; string name = 2; UserProfile profile = 3; // Safe in new method } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::restructuring-response-data::36","title":"RPC_SAME_RESPONSE_TYPE","section":"Restructuring Response Data","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#restructuring-response-data","headings":["Restructuring Response Data"],"excerpt":"Restructuring Response Data ```proto // Instead of changing field structure message UpdateUserResponse { UserDetails details = 1; // BREAKING: was individual fields }","content":"Restructuring Response Data ```proto // Instead of changing field structure message UpdateUserResponse { UserDetails details = 1; // BREAKING: was individual fields }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::restructuring-response-data::37","title":"RPC_SAME_RESPONSE_TYPE","section":"Restructuring Response Data","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#restructuring-response-data","headings":["Restructuring Response Data"],"excerpt":"Restructuring Response Data // Version the RPC rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) { option deprecated = true; } rpc UpdateUserV2(UpdateUserRequest) returns (UpdateUserResponseV2); ```","content":"Restructuring Response Data // Version the RPC rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) { option deprecated = true; } rpc UpdateUserV2(UpdateUserRequest) returns (UpdateUserResponseV2); ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::error-handling-changes::38","title":"RPC_SAME_RESPONSE_TYPE","section":"Error Handling Changes","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#error-handling-changes","headings":["Error Handling Changes"],"excerpt":"Error Handling Changes ```proto // Instead of changing error structure message CreateUserResponse { ErrorDetails error = 1; // BREAKING: different error format }","content":"Error Handling Changes ```proto // Instead of changing error structure message CreateUserResponse { ErrorDetails error = 1; // BREAKING: different error format }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::error-handling-changes::39","title":"RPC_SAME_RESPONSE_TYPE","section":"Error Handling Changes","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#error-handling-changes","headings":["Error Handling Changes"],"excerpt":"Error Handling Changes // Keep old RPC, add new one rpc CreateUser(CreateUserRequest) returns (CreateUserResponse) { option deprecated = true; } rpc CreateUserV2(CreateUserRequest) returns (CreateUserResponseV2); ```","content":"Error Handling Changes // Keep old RPC, add new one rpc CreateUser(CreateUserRequest) returns (CreateUserResponse) { option deprecated = true; } rpc CreateUserV2(CreateUserRequest) returns (CreateUserResponseV2); ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::response-format-migration::40","title":"RPC_SAME_RESPONSE_TYPE","section":"Response Format Migration","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#response-format-migration","headings":["Response Format Migration"],"excerpt":"Response Format Migration ```proto // Instead of changing from simple to complex response message GetUserResponse { // BREAKING: changed from simple fields to nested structure UserData data = 1; }","content":"Response Format Migration ```proto // Instead of changing from simple to complex response message GetUserResponse { // BREAKING: changed from simple fields to nested structure UserData data = 1; }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::response-format-migration::41","title":"RPC_SAME_RESPONSE_TYPE","section":"Response Format Migration","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#response-format-migration","headings":["Response Format Migration"],"excerpt":"Response Format Migration // Provide both formats during transition rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; } rpc GetUserDetailed(GetUserRequest) returns (GetUserDetailedResponse","content":"Response Format Migration // Provide both formats during transition rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; } rpc GetUserDetailed(GetUserRequest) returns (GetUserDetailedResponse); ```"},{"id":"cli/breaking-changes/rules/service-no-delete::top::0","title":"SERVICE_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":[],"excerpt":"This rule checks that no services are deleted from proto files. Deleting a service breaks both generated code and client applications that depend on the service.","content":"This rule checks that no services are deleted from proto files. Deleting a service breaks both generated code and client applications that depend on the service."},{"id":"cli/breaking-changes/rules/service-no-delete::bad::1","title":"SERVICE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/service-no-delete::bad::2","title":"SERVICE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#bad","headings":["Bad"],"excerpt":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/service-no-delete::bad::3","title":"SERVICE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#bad","headings":["Bad"],"excerpt":"Bad service OrderService { // [!code --] rpc GetOrder(GetOrderRequest) returns (GetOrderResponse); // [!code --] } // [!code --] ```","content":"Bad service OrderService { // [!code --] rpc GetOrder(GetOrderRequest) returns (GetOrderResponse); // [!code --] } // [!code --] ```"},{"id":"cli/breaking-changes/rules/service-no-delete::bad::4","title":"SERVICE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/service-no-delete::bad::5","title":"SERVICE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#bad","headings":["Bad"],"excerpt":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/service-no-delete::bad::6","title":"SERVICE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#bad","headings":["Bad"],"excerpt":"Bad // OrderService was deleted - BREAKING CHANGE! ```","content":"Bad // OrderService was deleted - BREAKING CHANGE! ```"},{"id":"cli/breaking-changes/rules/service-no-delete::good::7","title":"SERVICE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, deprecate the service:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, deprecate the service:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/service-no-delete::good::8","title":"SERVICE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#good","headings":["Good"],"excerpt":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/service-no-delete::good::9","title":"SERVICE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#good","headings":["Good"],"excerpt":"Good service OrderService { option deprecated = true; // [!code focus] rpc GetOrder(GetOrderRequest) returns (GetOrderResponse) { option deprecated = true; // [!code focus] } } ```","content":"Good service OrderService { option deprecated = true; // [!code focus] rpc GetOrder(GetOrderRequest) returns (GetOrderResponse) { option deprecated = true; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/service-no-delete::impact::10","title":"SERVICE_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Generated Code:** Service classes/interfaces are removed, breaking client compilation **Client Applications:** Existing client code fails to compile **Runtime:** gRPC clients lose service definition","content":"Impact **Generated Code:** Service classes/interfaces are removed, breaking client compilation **Client Applications:** Existing client code fails to compile **Runtime:** gRPC clients lose service definition"},{"id":"cli/breaking-changes/rules/service-no-delete::migration-strategy::11","title":"SERVICE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate first:**","content":"Migration Strategy **Deprecate first:**"},{"id":"cli/breaking-changes/rules/service-no-delete::migration-strategy::12","title":"SERVICE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Notify clients** about deprecation timeline","content":"Migration Strategy **Notify clients** about deprecation timeline"},{"id":"cli/breaking-changes/rules/service-no-delete::migration-strategy::13","title":"SERVICE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove after migration period** in a new major version","content":"Migration Strategy **Remove after migration period** in a new major version"},{"id":"cli/configuration/configuration::top::0","title":"EasyP Configuration Reference","path":"/docs/guide/cli/configuration/configuration","headings":[],"excerpt":"EasyP can be configured through CLI flags, environment variables, and configuration files. This guide covers all configuration options available in EasyP.","content":"EasyP can be configured through CLI flags, environment variables, and configuration files. This guide covers all configuration options available in EasyP."},{"id":"cli/configuration/configuration::global-flags::1","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags Available for all commands:","content":"Global Flags Available for all commands:"},{"id":"cli/configuration/configuration::global-flags::2","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --cfg -c EASYP_CFG Configuration file path easyp.yaml --config EASYP_CFG Alias for --cfg easyp.yaml --debug -d ","content":"Global Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --cfg -c EASYP_CFG Configuration file path easyp.yaml --config EASYP_CFG Alias for --cfg easyp.yaml --debug -d EASYP_DEBUG Enable debug mode false --format -f EASYP_FORMAT Output format for commands that support multiple formats (text/json) command-specific default"},{"id":"cli/configuration/configuration::global-flags::3","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags **Examples:** ```bash Use custom config file easyp --cfg production.easyp.yaml lint","content":"Global Flags **Examples:** ```bash Use custom config file easyp --cfg production.easyp.yaml lint"},{"id":"cli/configuration/configuration::global-flags::4","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags Enable debug logging easyp --debug lint","content":"Global Flags Enable debug logging easyp --debug lint"},{"id":"cli/configuration/configuration::global-flags::5","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags Short form easyp -c custom.yaml -d lint ```","content":"Global Flags Short form easyp -c custom.yaml -d lint ```"},{"id":"cli/configuration/configuration::command-specific-flags::6","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Lint command:**","content":"Command-Specific Flags **Lint command:**"},{"id":"cli/configuration/configuration::command-specific-flags::7","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --path -p Directory path to lint . --root -r Base directory for file search Current working directory","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --path -p Directory path to lint . --root -r Base directory for file search Current working directory --format -f EASYP_FORMAT Uses global format flag (text/json) Inherits global default"},{"id":"cli/configuration/configuration::command-specific-flags::8","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Lint specific directory easyp lint --path proto/","content":"Command-Specific Flags **Examples:** ```bash Lint specific directory easyp lint --path proto/"},{"id":"cli/configuration/configuration::command-specific-flags::9","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Lint from subdirectory with proper import resolution easyp lint --root src/IPC/Contracts --path .","content":"Command-Specific Flags Lint from subdirectory with proper import resolution easyp lint --root src/IPC/Contracts --path ."},{"id":"cli/configuration/configuration::command-specific-flags::10","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags JSON output format easyp --format json lint # global flag","content":"Command-Specific Flags JSON output format easyp --format json lint # global flag"},{"id":"cli/configuration/configuration::command-specific-flags::11","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Combined flags easyp -f json lint -p proto/ ```","content":"Command-Specific Flags Combined flags easyp -f json lint -p proto/ ```"},{"id":"cli/configuration/configuration::command-specific-flags::12","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Generate command:**","content":"Command-Specific Flags **Generate command:**"},{"id":"cli/configuration/configuration::command-specific-flags::13","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --path -p EASYP_ROOT_GENERATE_PATH Directory path with proto files to generate . --root -r Base direc","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --path -p EASYP_ROOT_GENERATE_PATH Directory path with proto files to generate . --root -r Base directory for file search Current working directory"},{"id":"cli/configuration/configuration::command-specific-flags::14","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Generate from specific path easyp generate --path api/","content":"Command-Specific Flags **Examples:** ```bash Generate from specific path easyp generate --path api/"},{"id":"cli/configuration/configuration::command-specific-flags::15","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Generate from subdirectory with proper import resolution easyp generate --root src/IPC/Contracts --path .","content":"Command-Specific Flags Generate from subdirectory with proper import resolution easyp generate --root src/IPC/Contracts --path ."},{"id":"cli/configuration/configuration::command-specific-flags::16","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Using environment variable EASYP_ROOT_GENERATE_PATH=proto/ easyp generate ```","content":"Command-Specific Flags Using environment variable EASYP_ROOT_GENERATE_PATH=proto/ easyp generate ```"},{"id":"cli/configuration/configuration::command-specific-flags::17","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Breaking command:**","content":"Command-Specific Flags **Breaking command:**"},{"id":"cli/configuration/configuration::command-specific-flags::18","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --against Git ref to compare against master --path -p Directory path to check . --format -f EASYP_FOR","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --against Git ref to compare against master --path -p Directory path to check . --format -f EASYP_FORMAT Uses global format flag (text/json) Inherits global default"},{"id":"cli/configuration/configuration::command-specific-flags::19","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Check against main branch easyp breaking --against main","content":"Command-Specific Flags **Examples:** ```bash Check against main branch easyp breaking --against main"},{"id":"cli/configuration/configuration::command-specific-flags::20","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Check specific directory against develop branch easyp breaking --against develop --path proto/","content":"Command-Specific Flags Check specific directory against develop branch easyp breaking --against develop --path proto/"},{"id":"cli/configuration/configuration::command-specific-flags::21","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags JSON output easyp --format json breaking --against main # global flag ```","content":"Command-Specific Flags JSON output easyp --format json breaking --against main # global flag ```"},{"id":"cli/configuration/configuration::command-specific-flags::22","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Init command:**","content":"Command-Specific Flags **Init command:**"},{"id":"cli/configuration/configuration::command-specific-flags::23","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --dir -d EASYP_INIT_DIR Directory to initialize .","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --dir -d EASYP_INIT_DIR Directory to initialize ."},{"id":"cli/configuration/configuration::command-specific-flags::24","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Initialize current directory easyp init","content":"Command-Specific Flags **Examples:** ```bash Initialize current directory easyp init"},{"id":"cli/configuration/configuration::command-specific-flags::25","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Initialize specific directory easyp init --dir proto-project/ ```","content":"Command-Specific Flags Initialize specific directory easyp init --dir proto-project/ ```"},{"id":"cli/configuration/configuration::command-specific-flags::26","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags easyp init is interactive: If buf.yml/buf.yaml exists in the target directory root, it asks whether to migrate from Buf. If easyp.yaml already exists, it asks for overwrite confirmation.","content":"Command-Specific Flags easyp init is interactive: If buf.yml/buf.yaml exists in the target directory root, it asks whether to migrate from Buf. If easyp.yaml already exists, it asks for overwrite confirmation."},{"id":"cli/configuration/configuration::command-specific-flags::27","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Validate-config command:**","content":"Command-Specific Flags **Validate-config command:**"},{"id":"cli/configuration/configuration::command-specific-flags::28","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --config -c EASYP_CFG Configuration file path easyp.yaml --format (global) -f EASYP_FORMAT Output for","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --config -c EASYP_CFG Configuration file path easyp.yaml --format (global) -f EASYP_FORMAT Output format for commands that support multiple formats (json or text) command-specific (json for validate-config)"},{"id":"cli/configuration/configuration::command-specific-flags::29","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Validate default config with JSON output (exit 0 when no errors) easyp validate-config","content":"Command-Specific Flags **Examples:** ```bash Validate default config with JSON output (exit 0 when no errors) easyp validate-config"},{"id":"cli/configuration/configuration::command-specific-flags::30","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Validate a different file with text output (global --format) easyp --format text validate-config --config example.easyp.yaml ```","content":"Command-Specific Flags Validate a different file with text output (global --format) easyp --format text validate-config --config example.easyp.yaml ```"},{"id":"cli/configuration/configuration::command-specific-flags::31","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Package management commands:**","content":"Command-Specific Flags **Package management commands:**"},{"id":"cli/configuration/configuration::easyp-mod-download::32","title":"EasyP Configuration Reference","section":"easyp mod download","path":"/docs/guide/cli/configuration/configuration#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download Downloads dependencies based on lock file priority:","content":"easyp mod download Downloads dependencies based on lock file priority:"},{"id":"cli/configuration/configuration::easyp-mod-download::33","title":"EasyP Configuration Reference","section":"easyp mod download","path":"/docs/guide/cli/configuration/configuration#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download **If easyp.lock exists** - downloads exact versions from lock file **If easyp.lock is missing** - downloads versions from easyp.yaml and creates easyp.lock","content":"easyp mod download **If easyp.lock exists** - downloads exact versions from lock file **If easyp.lock is missing** - downloads versions from easyp.yaml and creates easyp.lock"},{"id":"cli/configuration/configuration::easyp-mod-update::34","title":"EasyP Configuration Reference","section":"easyp mod update","path":"/docs/guide/cli/configuration/configuration#easyp-mod-update","headings":["easyp mod update"],"excerpt":"easyp mod update Always downloads dependencies from easyp.yaml, ignoring existing lock file:","content":"easyp mod update Always downloads dependencies from easyp.yaml, ignoring existing lock file:"},{"id":"cli/configuration/configuration::easyp-mod-update::35","title":"EasyP Configuration Reference","section":"easyp mod update","path":"/docs/guide/cli/configuration/configuration#easyp-mod-update","headings":["easyp mod update"],"excerpt":"easyp mod update **Ignores easyp.lock** completely **Downloads versions from easyp.yaml** **Creates/updates easyp.lock** with new versions","content":"easyp mod update **Ignores easyp.lock** completely **Downloads versions from easyp.yaml** **Creates/updates easyp.lock** with new versions"},{"id":"cli/configuration/configuration::easyp-mod-vendor::36","title":"EasyP Configuration Reference","section":"easyp mod vendor","path":"/docs/guide/cli/configuration/configuration#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor Copies proto files from dependencies to local vendor/ directory (similar to go mod vendor).","content":"easyp mod vendor Copies proto files from dependencies to local vendor/ directory (similar to go mod vendor)."},{"id":"cli/configuration/configuration::easyp-mod-vendor::37","title":"EasyP Configuration Reference","section":"easyp mod vendor","path":"/docs/guide/cli/configuration/configuration#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor No additional flags. Uses global --cfg flag for configuration.","content":"easyp mod vendor No additional flags. Uses global --cfg flag for configuration."},{"id":"cli/configuration/configuration::environment-variables::38","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables EasyP supports environment variables for configuration:","content":"Environment Variables EasyP supports environment variables for configuration:"},{"id":"cli/configuration/configuration::environment-variables::39","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables Variable Description Default ---------- ------------- --------- EASYP_CFG Path to configuration file easyp.yaml EASYP_DEBUG Enable debug logging false EASYPPATH Cache and modules storage directory $","content":"Environment Variables Variable Description Default ---------- ------------- --------- EASYP_CFG Path to configuration file easyp.yaml EASYP_DEBUG Enable debug logging false EASYPPATH Cache and modules storage directory $HOME/.easyp EASYP_FORMAT Output format for supported commands (text/json). If not set, each command uses its own default. command-specific default EASYP_ROOT_GENERATE_PATH Root path for generate command . EASYP_INIT_DIR Directory for init command ."},{"id":"cli/configuration/configuration::environment-variables::40","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables **Examples:** ```bash Custom cache directory export EASYPPATH=/tmp/easyp-cache easyp mod download","content":"Environment Variables **Examples:** ```bash Custom cache directory export EASYPPATH=/tmp/easyp-cache easyp mod download"},{"id":"cli/configuration/configuration::environment-variables::41","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables Debug mode via environment export EASYP_DEBUG=true easyp lint","content":"Environment Variables Debug mode via environment export EASYP_DEBUG=true easyp lint"},{"id":"cli/configuration/configuration::environment-variables::42","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables Custom config file export EASYP_CFG=config/easyp.yaml easyp generate ```","content":"Environment Variables Custom config file export EASYP_CFG=config/easyp.yaml easyp generate ```"},{"id":"cli/configuration/configuration::configuration-file::43","title":"EasyP Configuration Reference","section":"Configuration File","path":"/docs/guide/cli/configuration/configuration#configuration-file","headings":["Configuration File"],"excerpt":"Configuration File The easyp.yaml file is the main configuration file for EasyP, defining how your proto files are linted, generated, and managed. This file is typically placed at the root of your project alongside your ","content":"Configuration File The easyp.yaml file is the main configuration file for EasyP, defining how your proto files are linted, generated, and managed. This file is typically placed at the root of your project alongside your proto files."},{"id":"cli/configuration/configuration::configuration-format::44","title":"EasyP Configuration Reference","section":"Configuration Format","path":"/docs/guide/cli/configuration/configuration#configuration-format","headings":["Configuration Format"],"excerpt":"Configuration Format EasyP supports both YAML and JSON configuration formats:","content":"Configuration Format EasyP supports both YAML and JSON configuration formats:"},{"id":"cli/configuration/configuration::environment-variables-in-configuration::45","title":"EasyP Configuration Reference","section":"Environment Variables in Configuration","path":"/docs/guide/cli/configuration/configuration#environment-variables-in-configuration","headings":["Environment Variables in Configuration"],"excerpt":"Environment Variables in Configuration EasyP supports environment variable expansion directly in the easyp.yaml configuration file. This allows you to use environment variables for dynamic configuration values.","content":"Environment Variables in Configuration EasyP supports environment variable expansion directly in the easyp.yaml configuration file. This allows you to use environment variables for dynamic configuration values."},{"id":"cli/configuration/configuration::environment-variables-in-configuration::46","title":"EasyP Configuration Reference","section":"Environment Variables in Configuration","path":"/docs/guide/cli/configuration/configuration#environment-variables-in-configuration","headings":["Environment Variables in Configuration"],"excerpt":"Environment Variables in Configuration **Example with all supported features:** ```yaml deps: # Basic expansion: ${VAR} - expands to the value of VAR - ${GOOGLEAPIS_REPO}@${GOOGLEAPIS_VERSION} # Default value: ${VAR:-def","content":"Environment Variables in Configuration **Example with all supported features:** ```yaml deps: # Basic expansion: ${VAR} - expands to the value of VAR - ${GOOGLEAPIS_REPO}@${GOOGLEAPIS_VERSION} # Default value: ${VAR:-default} - uses default if VAR is unset or empty - ${GNOSTIC_REPO:-github.com/google/gnostic}@${GNOSTIC_VERSION:-v0.7.0}"},{"id":"cli/configuration/configuration::environment-variables-in-configuration::47","title":"EasyP Configuration Reference","section":"Environment Variables in Configuration","path":"/docs/guide/cli/configuration/configuration#environment-variables-in-configuration","headings":["Environment Variables in Configuration"],"excerpt":"Environment Variables in Configuration generate: inputs: # Default value if INPUT_DIR is not set - directory: ${INPUT_DIR:-proto} plugins: - name: go # Basic expansion out: ${OUTPUT_DIR} opts: # Default value module: ${M","content":"Environment Variables in Configuration generate: inputs: # Default value if INPUT_DIR is not set - directory: ${INPUT_DIR:-proto} plugins: - name: go # Basic expansion out: ${OUTPUT_DIR} opts: # Default value module: ${MODULE_NAME:-github.com/example/project} timeout: ${TIMEOUT:-30} # Escaping: $$ becomes literal $, $${VAR} becomes literal ${VAR} path: \"${BASE_DIR}/$${TEMP}/file\" # Result: \"/tmp/${TEMP}/file\" (if BASE_DIR=/tmp) literal: \"$$\" # Result: \"$\" ```"},{"id":"cli/configuration/configuration::environment-variables-in-configuration::48","title":"EasyP Configuration Reference","section":"Environment Variables in Configuration","path":"/docs/guide/cli/configuration/configuration#environment-variables-in-configuration","headings":["Environment Variables in Configuration"],"excerpt":"Environment Variables in Configuration **Supported syntax:** ${VAR} - expands to the value of VAR ${VAR:-default} - uses default if VAR is unset or empty ${VAR:=default} - uses default if VAR is unset or empty ${VAR-defa","content":"Environment Variables in Configuration **Supported syntax:** ${VAR} - expands to the value of VAR ${VAR:-default} - uses default if VAR is unset or empty ${VAR:=default} - uses default if VAR is unset or empty ${VAR-default} - uses default if VAR is unset (empty string is kept) $${VAR} or $$VAR - escapes to literal ${VAR} or $VAR $$ - escapes to literal $"},{"id":"cli/configuration/configuration::environment-variables-in-configuration::49","title":"EasyP Configuration Reference","section":"Environment Variables in Configuration","path":"/docs/guide/cli/configuration/configuration#environment-variables-in-configuration","headings":["Environment Variables in Configuration"],"excerpt":"Environment Variables in Configuration **Note:** Environment variables are expanded before YAML parsing, so any ${STRING} pattern will be processed. Use $$ to escape dollar signs when you need literal values.","content":"Environment Variables in Configuration **Note:** Environment variables are expanded before YAML parsing, so any ${STRING} pattern will be processed. Use $$ to escape dollar signs when you need literal values."},{"id":"cli/configuration/configuration::version::50","title":"EasyP Configuration Reference","section":"version","path":"/docs/guide/cli/configuration/configuration#version","headings":["version"],"excerpt":"version **Optional (legacy compatibility).** This field is accepted for backward compatibility and can be omitted in new configs.","content":"version **Optional (legacy compatibility).** This field is accepted for backward compatibility and can be omitted in new configs."},{"id":"cli/configuration/configuration::version::51","title":"EasyP Configuration Reference","section":"version","path":"/docs/guide/cli/configuration/configuration#version","headings":["version"],"excerpt":"version **Type:** string **Default:** omitted **Recommendation:** if you keep it, use v1alpha","content":"version **Type:** string **Default:** omitted **Recommendation:** if you keep it, use v1alpha"},{"id":"cli/configuration/configuration::version::52","title":"EasyP Configuration Reference","section":"version","path":"/docs/guide/cli/configuration/configuration#version","headings":["version"],"excerpt":"version The runtime behavior does not depend on this field.","content":"version The runtime behavior does not depend on this field."},{"id":"cli/configuration/configuration::lint::53","title":"EasyP Configuration Reference","section":"lint","path":"/docs/guide/cli/configuration/configuration#lint","headings":["lint"],"excerpt":"lint **Optional.** Configures proto file linting rules and behavior.","content":"lint **Optional.** Configures proto file linting rules and behavior."},{"id":"cli/configuration/configuration::lint::54","title":"EasyP Configuration Reference","section":"lint","path":"/docs/guide/cli/configuration/configuration#lint","headings":["lint"],"excerpt":"lint **Type:** object **Default:** Empty (no linting rules applied)","content":"lint **Type:** object **Default:** Empty (no linting rules applied)"},{"id":"cli/configuration/configuration::lintuse::55","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **Optional.** Specifies which linter rules or rule categories to apply.","content":"lint.use **Optional.** Specifies which linter rules or rule categories to apply."},{"id":"cli/configuration/configuration::lintuse::56","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **Type:** []string **Default:** [] (no rules)","content":"lint.use **Type:** []string **Default:** [] (no rules)"},{"id":"cli/configuration/configuration::lintuse::57","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **Available categories:** MINIMAL - Essential package consistency checks BASIC - Naming conventions and common patterns DEFAULT - Additional recommended rules COMMENTS - Comment requirements UNARY_RPC - Streamin","content":"lint.use **Available categories:** MINIMAL - Essential package consistency checks BASIC - Naming conventions and common patterns DEFAULT - Additional recommended rules COMMENTS - Comment requirements UNARY_RPC - Streaming RPC restrictions"},{"id":"cli/configuration/configuration::lintuse::58","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **Individual rules:** Any specific rule name (e.g., ENUM_PASCAL_CASE, FIELD_LOWER_SNAKE_CASE)","content":"lint.use **Individual rules:** Any specific rule name (e.g., ENUM_PASCAL_CASE, FIELD_LOWER_SNAKE_CASE)"},{"id":"cli/configuration/configuration::lintuse::59","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **MINIMAL:** DIRECTORY_SAME_PACKAGE PACKAGE_DEFINED PACKAGE_DIRECTORY_MATCH PACKAGE_SAME_DIRECTORY","content":"lint.use **MINIMAL:** DIRECTORY_SAME_PACKAGE PACKAGE_DEFINED PACKAGE_DIRECTORY_MATCH PACKAGE_SAME_DIRECTORY"},{"id":"cli/configuration/configuration::lintuse::60","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **BASIC:** ENUM_FIRST_VALUE_ZERO ENUM_NO_ALLOW_ALIAS ENUM_PASCAL_CASE ENUM_VALUE_UPPER_SNAKE_CASE FIELD_LOWER_SNAKE_CASE IMPORT_NO_PUBLIC IMPORT_NO_WEAK IMPORT_USED MESSAGE_PASCAL_CASE ONEOF_LOWER_SNAKE_CASE PAC","content":"lint.use **BASIC:** ENUM_FIRST_VALUE_ZERO ENUM_NO_ALLOW_ALIAS ENUM_PASCAL_CASE ENUM_VALUE_UPPER_SNAKE_CASE FIELD_LOWER_SNAKE_CASE IMPORT_NO_PUBLIC IMPORT_NO_WEAK IMPORT_USED MESSAGE_PASCAL_CASE ONEOF_LOWER_SNAKE_CASE PACKAGE_LOWER_SNAKE_CASE PACKAGE_SAME_CSHARP_NAMESPACE PACKAGE_SAME_GO_PACKAGE PACKAGE_SAME_JAVA_MULTIPLE_FILES PACKAGE_SAME_JAVA_PACKAGE PACKAGE_SAME_PHP_NAMESPACE PACKAGE_SAME_RUBY_PACKAGE PACKAGE_SAME_SWIFT_PREFIX RPC_PASCAL_CASE SERVICE_PASCAL_CASE"},{"id":"cli/configuration/configuration::lintuse::61","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **DEFAULT:** ENUM_VALUE_PREFIX ENUM_ZERO_VALUE_SUFFIX FILE_LOWER_SNAKE_CASE RPC_REQUEST_RESPONSE_UNIQUE RPC_REQUEST_STANDARD_NAME RPC_RESPONSE_STANDARD_NAME PACKAGE_VERSION_SUFFIX SERVICE_SUFFIX","content":"lint.use **DEFAULT:** ENUM_VALUE_PREFIX ENUM_ZERO_VALUE_SUFFIX FILE_LOWER_SNAKE_CASE RPC_REQUEST_RESPONSE_UNIQUE RPC_REQUEST_STANDARD_NAME RPC_RESPONSE_STANDARD_NAME PACKAGE_VERSION_SUFFIX SERVICE_SUFFIX"},{"id":"cli/configuration/configuration::lintuse::62","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **COMMENTS:** COMMENT_ENUM COMMENT_ENUM_VALUE COMMENT_FIELD COMMENT_MESSAGE COMMENT_ONEOF COMMENT_RPC COMMENT_SERVICE","content":"lint.use **COMMENTS:** COMMENT_ENUM COMMENT_ENUM_VALUE COMMENT_FIELD COMMENT_MESSAGE COMMENT_ONEOF COMMENT_RPC COMMENT_SERVICE"},{"id":"cli/configuration/configuration::lintuse::63","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **UNARY_RPC:** RPC_NO_CLIENT_STREAMING RPC_NO_SERVER_STREAMING","content":"lint.use **UNARY_RPC:** RPC_NO_CLIENT_STREAMING RPC_NO_SERVER_STREAMING"},{"id":"cli/configuration/configuration::lintenum_zero_value_suffix::64","title":"EasyP Configuration Reference","section":"lint.enum_zero_value_suffix","path":"/docs/guide/cli/configuration/configuration#lintenum_zero_value_suffix","headings":["lint.enum_zero_value_suffix"],"excerpt":"lint.enum_zero_value_suffix **Optional.** Specifies the required suffix for enum zero values.","content":"lint.enum_zero_value_suffix **Optional.** Specifies the required suffix for enum zero values."},{"id":"cli/configuration/configuration::lintenum_zero_value_suffix::65","title":"EasyP Configuration Reference","section":"lint.enum_zero_value_suffix","path":"/docs/guide/cli/configuration/configuration#lintenum_zero_value_suffix","headings":["lint.enum_zero_value_suffix"],"excerpt":"lint.enum_zero_value_suffix **Type:** string **Default:** \"\" (no suffix required) **Common values:** \"UNSPECIFIED\", \"UNKNOWN\", \"DEFAULT\"","content":"lint.enum_zero_value_suffix **Type:** string **Default:** \"\" (no suffix required) **Common values:** \"UNSPECIFIED\", \"UNKNOWN\", \"DEFAULT\""},{"id":"cli/configuration/configuration::lintenum_zero_value_suffix::66","title":"EasyP Configuration Reference","section":"lint.enum_zero_value_suffix","path":"/docs/guide/cli/configuration/configuration#lintenum_zero_value_suffix","headings":["lint.enum_zero_value_suffix"],"excerpt":"lint.enum_zero_value_suffix This enforces enum zero values like:","content":"lint.enum_zero_value_suffix This enforces enum zero values like:"},{"id":"cli/configuration/configuration::lintservice_suffix::67","title":"EasyP Configuration Reference","section":"lint.service_suffix","path":"/docs/guide/cli/configuration/configuration#lintservice_suffix","headings":["lint.service_suffix"],"excerpt":"lint.service_suffix **Optional.** Specifies the required suffix for service names.","content":"lint.service_suffix **Optional.** Specifies the required suffix for service names."},{"id":"cli/configuration/configuration::lintservice_suffix::68","title":"EasyP Configuration Reference","section":"lint.service_suffix","path":"/docs/guide/cli/configuration/configuration#lintservice_suffix","headings":["lint.service_suffix"],"excerpt":"lint.service_suffix **Type:** string **Default:** \"\" (no suffix required) **Common values:** \"Service\", \"API\", \"Svc\"","content":"lint.service_suffix **Type:** string **Default:** \"\" (no suffix required) **Common values:** \"Service\", \"API\", \"Svc\""},{"id":"cli/configuration/configuration::lintservice_suffix::69","title":"EasyP Configuration Reference","section":"lint.service_suffix","path":"/docs/guide/cli/configuration/configuration#lintservice_suffix","headings":["lint.service_suffix"],"excerpt":"lint.service_suffix This enforces service names like:","content":"lint.service_suffix This enforces service names like:"},{"id":"cli/configuration/configuration::lintignore::70","title":"EasyP Configuration Reference","section":"lint.ignore","path":"/docs/guide/cli/configuration/configuration#lintignore","headings":["lint.ignore"],"excerpt":"lint.ignore **Optional.** Directories or files to exclude from all linting rules.","content":"lint.ignore **Optional.** Directories or files to exclude from all linting rules."},{"id":"cli/configuration/configuration::lintignore::71","title":"EasyP Configuration Reference","section":"lint.ignore","path":"/docs/guide/cli/configuration/configuration#lintignore","headings":["lint.ignore"],"excerpt":"lint.ignore **Type:** []string **Default:** []","content":"lint.ignore **Type:** []string **Default:** []"},{"id":"cli/configuration/configuration::lintignore::72","title":"EasyP Configuration Reference","section":"lint.ignore","path":"/docs/guide/cli/configuration/configuration#lintignore","headings":["lint.ignore"],"excerpt":"lint.ignore Paths are relative to the easyp.yaml file location. Supports glob patterns.","content":"lint.ignore Paths are relative to the easyp.yaml file location. Supports glob patterns."},{"id":"cli/configuration/configuration::lintexcept::73","title":"EasyP Configuration Reference","section":"lint.except","path":"/docs/guide/cli/configuration/configuration#lintexcept","headings":["lint.except"],"excerpt":"lint.except **Optional.** Disables specific rules globally across the entire project.","content":"lint.except **Optional.** Disables specific rules globally across the entire project."},{"id":"cli/configuration/configuration::lintexcept::74","title":"EasyP Configuration Reference","section":"lint.except","path":"/docs/guide/cli/configuration/configuration#lintexcept","headings":["lint.except"],"excerpt":"lint.except **Type:** []string **Default:** []","content":"lint.except **Type:** []string **Default:** []"},{"id":"cli/configuration/configuration::lintallow_comment_ignores::75","title":"EasyP Configuration Reference","section":"lint.allow_comment_ignores","path":"/docs/guide/cli/configuration/configuration#lintallow_comment_ignores","headings":["lint.allow_comment_ignores"],"excerpt":"lint.allow_comment_ignores **Optional.** Enables inline comment-based rule ignoring within proto files.","content":"lint.allow_comment_ignores **Optional.** Enables inline comment-based rule ignoring within proto files."},{"id":"cli/configuration/configuration::lintallow_comment_ignores::76","title":"EasyP Configuration Reference","section":"lint.allow_comment_ignores","path":"/docs/guide/cli/configuration/configuration#lintallow_comment_ignores","headings":["lint.allow_comment_ignores"],"excerpt":"lint.allow_comment_ignores **Type:** boolean **Default:** false","content":"lint.allow_comment_ignores **Type:** boolean **Default:** false"},{"id":"cli/configuration/configuration::lintallow_comment_ignores::77","title":"EasyP Configuration Reference","section":"lint.allow_comment_ignores","path":"/docs/guide/cli/configuration/configuration#lintallow_comment_ignores","headings":["lint.allow_comment_ignores"],"excerpt":"lint.allow_comment_ignores When enabled, allows comments like:","content":"lint.allow_comment_ignores When enabled, allows comments like:"},{"id":"cli/configuration/configuration::lintignore_only::78","title":"EasyP Configuration Reference","section":"lint.ignore_only","path":"/docs/guide/cli/configuration/configuration#lintignore_only","headings":["lint.ignore_only"],"excerpt":"lint.ignore_only **Optional.** Disables specific rules only for certain files or directories.","content":"lint.ignore_only **Optional.** Disables specific rules only for certain files or directories."},{"id":"cli/configuration/configuration::lintignore_only::79","title":"EasyP Configuration Reference","section":"lint.ignore_only","path":"/docs/guide/cli/configuration/configuration#lintignore_only","headings":["lint.ignore_only"],"excerpt":"lint.ignore_only **Type:** mapstringstring **Default:** {}","content":"lint.ignore_only **Type:** mapstringstring **Default:** {}"},{"id":"cli/configuration/configuration::lintignore_only::80","title":"EasyP Configuration Reference","section":"lint.ignore_only","path":"/docs/guide/cli/configuration/configuration#lintignore_only","headings":["lint.ignore_only"],"excerpt":"lint.ignore_only **Key:** Rule name or category **Value:** Array of file paths or directories","content":"lint.ignore_only **Key:** Rule name or category **Value:** Array of file paths or directories"},{"id":"cli/configuration/configuration::deps::81","title":"EasyP Configuration Reference","section":"deps","path":"/docs/guide/cli/configuration/configuration#deps","headings":["deps"],"excerpt":"deps **Optional.** Lists external proto dependencies to download and manage.","content":"deps **Optional.** Lists external proto dependencies to download and manage."},{"id":"cli/configuration/configuration::deps::82","title":"EasyP Configuration Reference","section":"deps","path":"/docs/guide/cli/configuration/configuration#deps","headings":["deps"],"excerpt":"deps **Type:** []string **Default:** []","content":"deps **Type:** []string **Default:** []"},{"id":"cli/configuration/configuration::dependency-format::83","title":"EasyP Configuration Reference","section":"Dependency Format","path":"/docs/guide/cli/configuration/configuration#dependency-format","headings":["Dependency Format"],"excerpt":"Dependency Format Dependencies follow the format: $GIT_LINK@$VERSION","content":"Dependency Format Dependencies follow the format: $GIT_LINK@$VERSION"},{"id":"cli/configuration/configuration::dependency-format::84","title":"EasyP Configuration Reference","section":"Dependency Format","path":"/docs/guide/cli/configuration/configuration#dependency-format","headings":["Dependency Format"],"excerpt":"Dependency Format **Components:** $GIT_LINK - Git repository URL (GitHub, GitLab, etc.) $VERSION - Git tag or full commit hash (optional)","content":"Dependency Format **Components:** $GIT_LINK - Git repository URL (GitHub, GitLab, etc.) $VERSION - Git tag or full commit hash (optional)"},{"id":"cli/configuration/configuration::dependency-format::85","title":"EasyP Configuration Reference","section":"Dependency Format","path":"/docs/guide/cli/configuration/configuration#dependency-format","headings":["Dependency Format"],"excerpt":"Dependency Format **Format variations:** owner/repo - Latest commit from default branch owner/repo@v1.0.0 - Specific git tag owner/repo@47b927cbb41c4fdea1292baf - Full commit hash github.com/owner/repo@version - Full URL","content":"Dependency Format **Format variations:** owner/repo - Latest commit from default branch owner/repo@v1.0.0 - Specific git tag owner/repo@47b927cbb41c4fdea1292baf - Full commit hash github.com/owner/repo@version - Full URL with version gitlab.com/group/repo@tag - GitLab repository"},{"id":"cli/configuration/configuration::dependency-format::86","title":"EasyP Configuration Reference","section":"Dependency Format","path":"/docs/guide/cli/configuration/configuration#dependency-format","headings":["Dependency Format"],"excerpt":"Dependency Format **Note:** If @$VERSION is omitted, EasyP downloads the latest commit from the repository's default branch.","content":"Dependency Format **Note:** If @$VERSION is omitted, EasyP downloads the latest commit from the repository's default branch."},{"id":"cli/configuration/configuration::generate::87","title":"EasyP Configuration Reference","section":"generate","path":"/docs/guide/cli/configuration/configuration#generate","headings":["generate"],"excerpt":"generate **Optional.** Configures code generation from proto files.","content":"generate **Optional.** Configures code generation from proto files."},{"id":"cli/configuration/configuration::generate::88","title":"EasyP Configuration Reference","section":"generate","path":"/docs/guide/cli/configuration/configuration#generate","headings":["generate"],"excerpt":"generate **Type:** object **Default:** {}","content":"generate **Type:** object **Default:** {}"},{"id":"cli/configuration/configuration::generateinputs::89","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs **Required when generate is set.** Specifies sources of proto files for generation.","content":"generate.inputs **Required when generate is set.** Specifies sources of proto files for generation."},{"id":"cli/configuration/configuration::generateinputs::90","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs **Type:** []object (minimum 1 item) **Default:** not set","content":"generate.inputs **Type:** []object (minimum 1 item) **Default:** not set"},{"id":"cli/configuration/configuration::generateinputs::91","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs ```yaml generate: inputs: # Local directory - directory: \"proto\"","content":"generate.inputs ```yaml generate: inputs: # Local directory - directory: \"proto\""},{"id":"cli/configuration/configuration::generateinputs::92","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs Local directory with advanced options - directory: path: \"api/proto\" root: \".\"","content":"generate.inputs Local directory with advanced options - directory: path: \"api/proto\" root: \".\""},{"id":"cli/configuration/configuration::generateinputs::93","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs Remote git repository - git_repo: url: \"github.com/acme/common@v1.0.0\" sub_directory: \"proto\" root: \".\" ```","content":"generate.inputs Remote git repository - git_repo: url: \"github.com/acme/common@v1.0.0\" sub_directory: \"proto\" root: \".\" ```"},{"id":"cli/configuration/configuration::generateinputs::94","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs **Directory input fields:** directory (string or object) - Local directory path directory.path (string) - Directory path directory.root (string) - Root path for import resolution (default: \".\")","content":"generate.inputs **Directory input fields:** directory (string or object) - Local directory path directory.path (string) - Directory path directory.root (string) - Root path for import resolution (default: \".\")"},{"id":"cli/configuration/configuration::generateinputs::95","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs **Git repository input fields:** git_repo.url (string) - Repository URL with optional version git_repo.sub_directory (string) - Subdirectory within the repository git_repo.root (string) - Root path used f","content":"generate.inputs **Git repository input fields:** git_repo.url (string) - Repository URL with optional version git_repo.sub_directory (string) - Subdirectory within the repository git_repo.root (string) - Root path used for import resolution"},{"id":"cli/configuration/configuration::generateplugins::96","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins **Required when generate is set.** Configures protoc plugins for code generation.","content":"generate.plugins **Required when generate is set.** Configures protoc plugins for code generation."},{"id":"cli/configuration/configuration::generateplugins::97","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins **Type:** []object (minimum 1 item) **Default:** not set","content":"generate.plugins **Type:** []object (minimum 1 item) **Default:** not set"},{"id":"cli/configuration/configuration::generateplugins::98","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins ```yaml generate: plugins: # Local plugin - name: go out: . opts: paths: source_relative","content":"generate.plugins ```yaml generate: plugins: # Local plugin - name: go out: . opts: paths: source_relative"},{"id":"cli/configuration/configuration::generateplugins::99","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins Remote plugin - remote: \"buf.build/bufbuild/protovalidate-go:v0.4.0\" out: gen/go opts: paths: source_relative","content":"generate.plugins Remote plugin - remote: \"buf.build/bufbuild/protovalidate-go:v0.4.0\" out: gen/go opts: paths: source_relative"},{"id":"cli/configuration/configuration::generateplugins::100","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins Plugin with import dependencies - name: grpc-gateway out: . with_imports: true opts: paths: source_relative ```","content":"generate.plugins Plugin with import dependencies - name: grpc-gateway out: . with_imports: true opts: paths: source_relative ```"},{"id":"cli/configuration/configuration::generateplugins::101","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins **Plugin fields:** name (string, optional) - Plugin name (omit protoc-gen- prefix) remote (string, optional) - Remote plugin URL for execution path (string, optional) - Path to plugin executable file com","content":"generate.plugins **Plugin fields:** name (string, optional) - Plugin name (omit protoc-gen- prefix) remote (string, optional) - Remote plugin URL for execution path (string, optional) - Path to plugin executable file command ([]string, optional) - Command to execute plugin out (string, optional) - Output directory for generated files; defaults to the resolved generate root opts (mapstring, optional) - Plugin-specific options; each key can be a single scalar value or an array of scalar values with_imports (boolean, optional) - Include imported dependencies"},{"id":"cli/configuration/configuration::generateplugins::102","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins Plugin source is one-of: exactly one of name, remote, path, or command must be set.","content":"generate.plugins Plugin source is one-of: exactly one of name, remote, path, or command must be set."},{"id":"cli/configuration/configuration::generateplugins::103","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins **Common plugin options:** ```yaml Go plugin options opts: paths: source_relative # Generate files relative to input module: github.com/acme/api # Go module path","content":"generate.plugins **Common plugin options:** ```yaml Go plugin options opts: paths: source_relative # Generate files relative to input module: github.com/acme/api # Go module path"},{"id":"cli/configuration/configuration::generateplugins::104","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins gRPC Gateway options opts: paths: source_relative grpc_api_configuration: api.yaml # gRPC API configuration","content":"generate.plugins gRPC Gateway options opts: paths: source_relative grpc_api_configuration: api.yaml # gRPC API configuration"},{"id":"cli/configuration/configuration::generateplugins::105","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins OpenAPI v2 options opts: simple_operation_ids: true # Use simple operation IDs generate_unbound_methods: false # Skip unbound methods","content":"generate.plugins OpenAPI v2 options opts: simple_operation_ids: true # Use simple operation IDs generate_unbound_methods: false # Skip unbound methods"},{"id":"cli/configuration/configuration::generateplugins::106","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins ts-proto options with repeated key values opts: env: node outputServices: - grpc-js - generic-definitions ```","content":"generate.plugins ts-proto options with repeated key values opts: env: node outputServices: - grpc-js - generic-definitions ```"},{"id":"cli/configuration/configuration::generateplugins::107","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins When an opts value is a list, EasyP serializes it as repeated plugin params, e.g. outputServices=grpc-js,outputServices=generic-definitions.","content":"generate.plugins When an opts value is a list, EasyP serializes it as repeated plugin params, e.g. outputServices=grpc-js,outputServices=generic-definitions."},{"id":"cli/configuration/configuration::breaking::108","title":"EasyP Configuration Reference","section":"breaking","path":"/docs/guide/cli/configuration/configuration#breaking","headings":["breaking"],"excerpt":"breaking **Optional.** Configures backward compatibility checking.","content":"breaking **Optional.** Configures backward compatibility checking."},{"id":"cli/configuration/configuration::breaking::109","title":"EasyP Configuration Reference","section":"breaking","path":"/docs/guide/cli/configuration/configuration#breaking","headings":["breaking"],"excerpt":"breaking **Type:** object **Default:** {}","content":"breaking **Type:** object **Default:** {}"},{"id":"cli/configuration/configuration::breakingignore::110","title":"EasyP Configuration Reference","section":"breaking.ignore","path":"/docs/guide/cli/configuration/configuration#breakingignore","headings":["breaking.ignore"],"excerpt":"breaking.ignore **Optional.** Directories or files to exclude from breaking change detection.","content":"breaking.ignore **Optional.** Directories or files to exclude from breaking change detection."},{"id":"cli/configuration/configuration::breakingignore::111","title":"EasyP Configuration Reference","section":"breaking.ignore","path":"/docs/guide/cli/configuration/configuration#breakingignore","headings":["breaking.ignore"],"excerpt":"breaking.ignore **Type:** []string **Default:** []","content":"breaking.ignore **Type:** []string **Default:** []"},{"id":"cli/configuration/configuration::breakingagainst_git_ref::112","title":"EasyP Configuration Reference","section":"breaking.against_git_ref","path":"/docs/guide/cli/configuration/configuration#breakingagainst_git_ref","headings":["breaking.against_git_ref"],"excerpt":"breaking.against_git_ref **Optional.** Git reference (branch, tag, or commit) to compare against for breaking changes.","content":"breaking.against_git_ref **Optional.** Git reference (branch, tag, or commit) to compare against for breaking changes."},{"id":"cli/configuration/configuration::breakingagainst_git_ref::113","title":"EasyP Configuration Reference","section":"breaking.against_git_ref","path":"/docs/guide/cli/configuration/configuration#breakingagainst_git_ref","headings":["breaking.against_git_ref"],"excerpt":"breaking.against_git_ref **Type:** string **Default:** \"\" (falls back to CLI --against default: master)","content":"breaking.against_git_ref **Type:** string **Default:** \"\" (falls back to CLI --against default: master)"},{"id":"cli/configuration/configuration::breakingagainst_git_ref::114","title":"EasyP Configuration Reference","section":"breaking.against_git_ref","path":"/docs/guide/cli/configuration/configuration#breakingagainst_git_ref","headings":["breaking.against_git_ref"],"excerpt":"breaking.against_git_ref Can be overridden by the --against CLI flag.","content":"breaking.against_git_ref Can be overridden by the --against CLI flag."},{"id":"cli/configuration/configuration::configuration-validation::115","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation EasyP validates configuration files on startup and provides helpful error messages:","content":"Configuration Validation EasyP validates configuration files on startup and provides helpful error messages:"},{"id":"cli/configuration/configuration::configuration-validation::116","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation ```bash Invalid rule name Error: invalid rule: INVALID_RULE_NAME","content":"Configuration Validation ```bash Invalid rule name Error: invalid rule: INVALID_RULE_NAME"},{"id":"cli/configuration/configuration::configuration-validation::117","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation Missing required field in generate section Error: required field \"plugins\" is missing (path: generate.plugins)","content":"Configuration Validation Missing required field in generate section Error: required field \"plugins\" is missing (path: generate.plugins)"},{"id":"cli/configuration/configuration::configuration-validation::118","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation Invalid dependency format Error: invalid dependency format: invalid-repo-url ```","content":"Configuration Validation Invalid dependency format Error: invalid dependency format: invalid-repo-url ```"},{"id":"cli/configuration/configuration::configuration-validation::119","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation Use easyp --debug for detailed validation information.","content":"Configuration Validation Use easyp --debug for detailed validation information."},{"id":"cli/configuration/configuration::migration-from-buf::120","title":"EasyP Configuration Reference","section":"Migration from Buf","path":"/docs/guide/cli/configuration/configuration#migration-from-buf","headings":["Migration from Buf"],"excerpt":"Migration from Buf EasyP is fully compatible with Buf configurations. To migrate:","content":"Migration from Buf EasyP is fully compatible with Buf configurations. To migrate:"},{"id":"cli/configuration/configuration::migration-from-buf::121","title":"EasyP Configuration Reference","section":"Migration from Buf","path":"/docs/guide/cli/configuration/configuration#migration-from-buf","headings":["Migration from Buf"],"excerpt":"Migration from Buf Place buf.yaml or buf.yml in the project root Run easyp init and confirm migration when prompted Update deps format if using BSR modules Review migrated lint/breaking settings and adjust as needed","content":"Migration from Buf Place buf.yaml or buf.yml in the project root Run easyp init and confirm migration when prompted Update deps format if using BSR modules Review migrated lint/breaking settings and adjust as needed"},{"id":"cli/configuration/configuration::migration-from-buf::122","title":"EasyP Configuration Reference","section":"Migration from Buf","path":"/docs/guide/cli/configuration/configuration#migration-from-buf","headings":["Migration from Buf"],"excerpt":"Migration from Buf Most Buf configurations work without changes in EasyP.","content":"Migration from Buf Most Buf configurations work without changes in EasyP."},{"id":"cli/generator/examples/go::installing-plugins::0","title":"Go","section":"Installing Plugins","path":"/docs/guide/cli/generator/examples/go#installing-plugins","headings":["Installing Plugins"],"excerpt":"Installing Plugins First, install the necessary plugins for working with gRPC:","content":"Installing Plugins First, install the necessary plugins for working with gRPC:"},{"id":"cli/generator/examples/go::installing-plugins::1","title":"Go","section":"Installing Plugins","path":"/docs/guide/cli/generator/examples/go#installing-plugins","headings":["Installing Plugins"],"excerpt":"Installing Plugins These commands will install the protoc-gen-go and protoc-gen-go-grpc plugins for use with EasyP.","content":"Installing Plugins These commands will install the protoc-gen-go and protoc-gen-go-grpc plugins for use with EasyP."},{"id":"cli/generator/examples/go::example-proto-service::2","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service Here is an example proto file for an Echo service:","content":"Example Proto Service Here is an example proto file for an Echo service:"},{"id":"cli/generator/examples/go::example-proto-service::3","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service ```proto syntax = \"proto3\";","content":"Example Proto Service ```proto syntax = \"proto3\";"},{"id":"cli/generator/examples/go::example-proto-service::4","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service package api.echo.v1;","content":"Example Proto Service package api.echo.v1;"},{"id":"cli/generator/examples/go::example-proto-service::5","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";","content":"Example Proto Service option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";"},{"id":"cli/generator/examples/go::example-proto-service::6","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); rpc EchoStream(EchoStreamRequest) returns (EchoResponse); }","content":"Example Proto Service service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); rpc EchoStream(EchoStreamRequest) returns (EchoResponse); }"},{"id":"cli/generator/examples/go::example-proto-service::7","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoRequest { string payload = 1; }","content":"Example Proto Service message EchoRequest { string payload = 1; }"},{"id":"cli/generator/examples/go::example-proto-service::8","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoResponse { string payload = 2; }","content":"Example Proto Service message EchoResponse { string payload = 2; }"},{"id":"cli/generator/examples/go::example-proto-service::9","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoStreamRequest { string payload = 1; }","content":"Example Proto Service message EchoStreamRequest { string payload = 1; }"},{"id":"cli/generator/examples/go::example-proto-service::10","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoStreamResponse { string payload = 2; } ```","content":"Example Proto Service message EchoStreamResponse { string payload = 2; } ```"},{"id":"cli/generator/examples/go::configuration-setup::11","title":"Go","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/go#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup Create and configure the easyp.yaml configuration file:","content":"Configuration Setup Create and configure the easyp.yaml configuration file:"},{"id":"cli/generator/examples/go::configuration-setup::12","title":"Go","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/go#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup This file specifies that two plugins will be used: go for generating Go code and go-grpc for generating gRPC code, along with their respective options.","content":"Configuration Setup This file specifies that two plugins will be used: go for generating Go code and go-grpc for generating gRPC code, along with their respective options."},{"id":"cli/generator/examples/go::generating-code::13","title":"Go","section":"Generating Code","path":"/docs/guide/cli/generator/examples/go#generating-code","headings":["Generating Code"],"excerpt":"Generating Code To generate code, use the following command:","content":"Generating Code To generate code, use the following command:"},{"id":"cli/generator/examples/go::generating-code::14","title":"Go","section":"Generating Code","path":"/docs/guide/cli/generator/examples/go#generating-code","headings":["Generating Code"],"excerpt":"Generating Code If the --cfg flag is not specified, the easyp.yaml file in the current directory will be used by default:","content":"Generating Code If the --cfg flag is not specified, the easyp.yaml file in the current directory will be used by default:"},{"id":"cli/generator/examples/go::generating-code::15","title":"Go","section":"Generating Code","path":"/docs/guide/cli/generator/examples/go#generating-code","headings":["Generating Code"],"excerpt":"Generating Code Now you have the generated Go code, which you can interact with directly.","content":"Generating Code Now you have the generated Go code, which you can interact with directly."},{"id":"cli/generator/examples/grpc-gateway::installing-plugins::0","title":"gRPC-Gateway","section":"Installing Plugins","path":"/docs/guide/cli/generator/examples/grpc-gateway#installing-plugins","headings":["Installing Plugins"],"excerpt":"Installing Plugins In addition to the plugins for working with gRPC, you also need to install the following plugins for gRPC-Gateway:","content":"Installing Plugins In addition to the plugins for working with gRPC, you also need to install the following plugins for gRPC-Gateway:"},{"id":"cli/generator/examples/grpc-gateway::installing-plugins::1","title":"gRPC-Gateway","section":"Installing Plugins","path":"/docs/guide/cli/generator/examples/grpc-gateway#installing-plugins","headings":["Installing Plugins"],"excerpt":"Installing Plugins These commands will install the protoc-gen-go, protoc-gen-go-grpc, protoc-gen-openapiv2, and protoc-gen-grpc-gateway plugins for use with EasyP`.","content":"Installing Plugins These commands will install the protoc-gen-go, protoc-gen-go-grpc, protoc-gen-openapiv2, and protoc-gen-grpc-gateway plugins for use with EasyP`."},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::2","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service Here is the initial proto file for an Echo service:","content":"Example Proto Service Here is the initial proto file for an Echo service:"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::3","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service ```proto syntax = \"proto3\";","content":"Example Proto Service ```proto syntax = \"proto3\";"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::4","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service package api.echo.v1;","content":"Example Proto Service package api.echo.v1;"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::5","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";","content":"Example Proto Service option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::6","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); }","content":"Example Proto Service service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); }"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::7","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoRequest { string payload = 1; }","content":"Example Proto Service message EchoRequest { string payload = 1; }"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::8","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoResponse { string payload = 2; } ```","content":"Example Proto Service message EchoResponse { string payload = 2; } ```"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::9","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service To use gRPC-Gateway, update the proto file to include HTTP options:","content":"Example Proto Service To use gRPC-Gateway, update the proto file to include HTTP options:"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::10","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service ```proto syntax = \"proto3\"; import \"google/api/annotations.proto\";","content":"Example Proto Service ```proto syntax = \"proto3\"; import \"google/api/annotations.proto\";"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::11","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service package api.echo.v1;","content":"Example Proto Service package api.echo.v1;"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::12","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";","content":"Example Proto Service option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::13","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse) { option (google.api.http) = { // [!code ++] post: \"/api/v1/echo\" // [!code ++] body: \"*\" // [!code ++] }; // [!code ++] } }","content":"Example Proto Service service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse) { option (google.api.http) = { // [!code ++] post: \"/api/v1/echo\" // [!code ++] body: \"*\" // [!code ++] }; // [!code ++] } }"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::14","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoRequest { string payload = 1; }","content":"Example Proto Service message EchoRequest { string payload = 1; }"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::15","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoResponse { string payload = 2; } ```","content":"Example Proto Service message EchoResponse { string payload = 2; } ```"},{"id":"cli/generator/examples/grpc-gateway::configuration-setup::16","title":"gRPC-Gateway","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/grpc-gateway#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup Update your easyp.yaml configuration file to include the necessary dependencies and plugins:","content":"Configuration Setup Update your easyp.yaml configuration file to include the necessary dependencies and plugins:"},{"id":"cli/generator/examples/grpc-gateway::configuration-setup::17","title":"gRPC-Gateway","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/grpc-gateway#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup ```yaml deps: # [!code ++] - github.com/googleapis/googleapis # [!code ++]","content":"Configuration Setup ```yaml deps: # [!code ++] - github.com/googleapis/googleapis # [!code ++]"},{"id":"cli/generator/examples/grpc-gateway::configuration-setup::18","title":"gRPC-Gateway","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/grpc-gateway#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup generate: plugins: - name: go out: . opts: paths: source_relative - name: go-grpc out: . opts: paths: source_relative require_unimplemented_servers: false - name: grpc-gateway # [!code ++] out: . # [!","content":"Configuration Setup generate: plugins: - name: go out: . opts: paths: source_relative - name: go-grpc out: . opts: paths: source_relative require_unimplemented_servers: false - name: grpc-gateway # [!code ++] out: . # [!code ++] opts: # [!code ++] paths: source_relative # [!code ++] - name: openapiv2 # [!code ++] out: . # [!code ++] opts: # [!code ++] simple_operation_ids: false # [!code ++] generate_unbound_methods: false # [!code ++] ```"},{"id":"cli/generator/examples/grpc-gateway::configuration-setup::19","title":"gRPC-Gateway","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/grpc-gateway#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup The deps section lists dependencies required for proto file imports. In this case, we add github.com/googleapis/googleapis because it contains the annotations.proto file used in the proto service defi","content":"Configuration Setup The deps section lists dependencies required for proto file imports. In this case, we add github.com/googleapis/googleapis because it contains the annotations.proto file used in the proto service definition."},{"id":"cli/generator/examples/grpc-gateway::updating-dependencies::20","title":"gRPC-Gateway","section":"Updating Dependencies","path":"/docs/guide/cli/generator/examples/grpc-gateway#updating-dependencies","headings":["Updating Dependencies"],"excerpt":"Updating Dependencies After updating your configuration file, run the following command to download the specified dependencies:","content":"Updating Dependencies After updating your configuration file, run the following command to download the specified dependencies:"},{"id":"cli/generator/examples/grpc-gateway::updating-dependencies::21","title":"gRPC-Gateway","section":"Updating Dependencies","path":"/docs/guide/cli/generator/examples/grpc-gateway#updating-dependencies","headings":["Updating Dependencies"],"excerpt":"Updating Dependencies For more details on managing dependencies, refer to the Package Manager section.","content":"Updating Dependencies For more details on managing dependencies, refer to the Package Manager section."},{"id":"cli/generator/examples/grpc-gateway::generating-code::22","title":"gRPC-Gateway","section":"Generating Code","path":"/docs/guide/cli/generator/examples/grpc-gateway#generating-code","headings":["Generating Code"],"excerpt":"Generating Code To generate the code, use the following command:","content":"Generating Code To generate the code, use the following command:"},{"id":"cli/generator/examples/grpc-gateway::generating-code::23","title":"gRPC-Gateway","section":"Generating Code","path":"/docs/guide/cli/generator/examples/grpc-gateway#generating-code","headings":["Generating Code"],"excerpt":"Generating Code If the --cfg flag is not specified, the easyp.yaml file in the current directory will be used by default:","content":"Generating Code If the --cfg flag is not specified, the easyp.yaml file in the current directory will be used by default:"},{"id":"cli/generator/examples/grpc-gateway::generating-code::24","title":"gRPC-Gateway","section":"Generating Code","path":"/docs/guide/cli/generator/examples/grpc-gateway#generating-code","headings":["Generating Code"],"excerpt":"Generating Code Now you have the generated Go and gRPC-Gateway code, which you can interact with directly.","content":"Generating Code Now you have the generated Go and gRPC-Gateway code, which you can interact with directly."},{"id":"cli/generator/examples/validate::installing-plugins::0","title":"Validate","section":"Installing Plugins","path":"/docs/guide/cli/generator/examples/validate#installing-plugins","headings":["Installing Plugins"],"excerpt":"Installing Plugins First, install the necessary plugins for working with gRPC:","content":"Installing Plugins First, install the necessary plugins for working with gRPC:"},{"id":"cli/generator/examples/validate::installing-plugins::1","title":"Validate","section":"Installing Plugins","path":"/docs/guide/cli/generator/examples/validate#installing-plugins","headings":["Installing Plugins"],"excerpt":"Installing Plugins These commands will install the protoc-gen-go and protoc-gen-go-grpc and protoc-gen-validate plugins for use with EasyP.","content":"Installing Plugins These commands will install the protoc-gen-go and protoc-gen-go-grpc and protoc-gen-validate plugins for use with EasyP."},{"id":"cli/generator/examples/validate::example-proto-service::2","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service Here is an example proto file for an Echo service:","content":"Example Proto Service Here is an example proto file for an Echo service:"},{"id":"cli/generator/examples/validate::example-proto-service::3","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service ```proto syntax = \"proto3\";","content":"Example Proto Service ```proto syntax = \"proto3\";"},{"id":"cli/generator/examples/validate::example-proto-service::4","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service package api.echo.v1;","content":"Example Proto Service package api.echo.v1;"},{"id":"cli/generator/examples/validate::example-proto-service::5","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service import \"validate/validate.proto\";","content":"Example Proto Service import \"validate/validate.proto\";"},{"id":"cli/generator/examples/validate::example-proto-service::6","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";","content":"Example Proto Service option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";"},{"id":"cli/generator/examples/validate::example-proto-service::7","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); rpc EchoStream(EchoStreamRequest) returns (EchoResponse); }","content":"Example Proto Service service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); rpc EchoStream(EchoStreamRequest) returns (EchoResponse); }"},{"id":"cli/generator/examples/validate::example-proto-service::8","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoRequest { string payload = 1 [(validate.rules).string = {max_len: 200}]; }","content":"Example Proto Service message EchoRequest { string payload = 1 [(validate.rules).string = {max_len: 200}]; }"},{"id":"cli/generator/examples/validate::example-proto-service::9","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoResponse { string payload = 2; }","content":"Example Proto Service message EchoResponse { string payload = 2; }"},{"id":"cli/generator/examples/validate::example-proto-service::10","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoStreamRequest { string payload = 1 [(validate.rules).string = {max_len: 200}]; }","content":"Example Proto Service message EchoStreamRequest { string payload = 1 [(validate.rules).string = {max_len: 200}]; }"},{"id":"cli/generator/examples/validate::example-proto-service::11","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoStreamResponse { string payload = 2; } ```","content":"Example Proto Service message EchoStreamResponse { string payload = 2; } ```"},{"id":"cli/generator/examples/validate::configuration-setup::12","title":"Validate","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/validate#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup Create and configure the easyp.yaml configuration file:","content":"Configuration Setup Create and configure the easyp.yaml configuration file:"},{"id":"cli/generator/examples/validate::configuration-setup::13","title":"Validate","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/validate#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup ```yaml deps: # [!code ++] - github.com/bufbuild/protoc-gen-validate # [!code ++]","content":"Configuration Setup ```yaml deps: # [!code ++] - github.com/bufbuild/protoc-gen-validate # [!code ++]"},{"id":"cli/generator/examples/validate::configuration-setup::14","title":"Validate","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/validate#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup generate: plugins: - name: go out: . opts: paths: source_relative - name: go-grpc out: . opts: paths: source_relative require_unimplemented_servers: false - name: validate out: . opts: paths: source_r","content":"Configuration Setup generate: plugins: - name: go out: . opts: paths: source_relative - name: go-grpc out: . opts: paths: source_relative require_unimplemented_servers: false - name: validate out: . opts: paths: source_relative lang: \"go\" ```"},{"id":"cli/generator/examples/validate::generating-code::15","title":"Validate","section":"Generating Code","path":"/docs/guide/cli/generator/examples/validate#generating-code","headings":["Generating Code"],"excerpt":"Generating Code To generate code, use the following command:","content":"Generating Code To generate code, use the following command:"},{"id":"cli/generator/examples/validate::generating-code::16","title":"Validate","section":"Generating Code","path":"/docs/guide/cli/generator/examples/validate#generating-code","headings":["Generating Code"],"excerpt":"Generating Code If the --cfg flag is not specified, the easyp.yaml file in the current directory will be used by default:","content":"Generating Code If the --cfg flag is not specified, the easyp.yaml file in the current directory will be used by default:"},{"id":"cli/generator/examples/validate::generating-code::17","title":"Validate","section":"Generating Code","path":"/docs/guide/cli/generator/examples/validate#generating-code","headings":["Generating Code"],"excerpt":"Generating Code Now you have the generated Go code, which you can interact with directly.","content":"Generating Code Now you have the generated Go code, which you can interact with directly."},{"id":"cli/generator/generator::top::0","title":"Generator","path":"/docs/guide/cli/generator/generator","headings":[],"excerpt":"EasyP includes a powerful generator that simplifies the process of generating code from proto files. By using YAML configurations, EasyP makes this process more user-friendly and intuitive compared to using the protoc co","content":"EasyP includes a powerful generator that simplifies the process of generating code from proto files. By using YAML configurations, EasyP makes this process more user-friendly and intuitive compared to using the protoc command directly."},{"id":"cli/generator/generator::key-features-of-the-generator::1","title":"Generator","section":"Key Features of the Generator","path":"/docs/guide/cli/generator/generator#key-features-of-the-generator","headings":["Key Features of the Generator"],"excerpt":"Key Features of the Generator **Simplified Code Generation**: - Generate code from proto files using a YAML configuration. - Avoid the need to write long and complex protoc commands.","content":"Key Features of the Generator **Simplified Code Generation**: - Generate code from proto files using a YAML configuration. - Avoid the need to write long and complex protoc commands."},{"id":"cli/generator/generator::key-features-of-the-generator::2","title":"Generator","section":"Key Features of the Generator","path":"/docs/guide/cli/generator/generator#key-features-of-the-generator","headings":["Key Features of the Generator"],"excerpt":"Key Features of the Generator **Wrapper around protoc**: - EasyP functions as a wrapper around protoc, providing a more convenient API through configuration files. - Supports all options and plugins available in protoc.","content":"Key Features of the Generator **Wrapper around protoc**: - EasyP functions as a wrapper around protoc, providing a more convenient API through configuration files. - Supports all options and plugins available in protoc."},{"id":"cli/generator/generator::key-features-of-the-generator::3","title":"Generator","section":"Key Features of the Generator","path":"/docs/guide/cli/generator/generator#key-features-of-the-generator","headings":["Key Features of the Generator"],"excerpt":"Key Features of the Generator **Flexibility and Customization**: - Use the same parameters as protoc plugins, directly in the configuration file. - Support for multiple plugins and their parameters in a single configurat","content":"Key Features of the Generator **Flexibility and Customization**: - Use the same parameters as protoc plugins, directly in the configuration file. - Support for multiple plugins and their parameters in a single configuration."},{"id":"cli/generator/generator::key-features-of-the-generator::4","title":"Generator","section":"Key Features of the Generator","path":"/docs/guide/cli/generator/generator#key-features-of-the-generator","headings":["Key Features of the Generator"],"excerpt":"Key Features of the Generator **Generate Code from Multiple Sources**: - Generate code from local directories or remote repositories. - Easily integrate with existing projects and repositories.","content":"Key Features of the Generator **Generate Code from Multiple Sources**: - Generate code from local directories or remote repositories. - Easily integrate with existing projects and repositories."},{"id":"cli/generator/generator::key-features-of-the-generator::5","title":"Generator","section":"Key Features of the Generator","path":"/docs/guide/cli/generator/generator#key-features-of-the-generator","headings":["Key Features of the Generator"],"excerpt":"Key Features of the Generator **Remote Generation**: - Generate code from remote Git repositories without local checkout.","content":"Key Features of the Generator **Remote Generation**: - Generate code from remote Git repositories without local checkout."},{"id":"cli/generator/generator::key-features-of-the-generator::6","title":"Generator","section":"Key Features of the Generator","path":"/docs/guide/cli/generator/generator#key-features-of-the-generator","headings":["Key Features of the Generator"],"excerpt":"Key Features of the Generator **Package Manager Integration**: - Seamless integration with EasyP's package manager for dependency management. - Automatic resolution and inclusion of proto dependencies.","content":"Key Features of the Generator **Package Manager Integration**: - Seamless integration with EasyP's package manager for dependency management. - Automatic resolution and inclusion of proto dependencies."},{"id":"cli/generator/generator::complete-configuration-example::7","title":"Generator","section":"Complete Configuration Example","path":"/docs/guide/cli/generator/generator#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example ```yaml Package manager dependencies deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 - github.com/bufbuild/protoc-gen-validate@","content":"Complete Configuration Example ```yaml Package manager dependencies deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 - github.com/bufbuild/protoc-gen-validate@v0.10.1"},{"id":"cli/generator/generator::complete-configuration-example::8","title":"Generator","section":"Complete Configuration Example","path":"/docs/guide/cli/generator/generator#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example Code generation configuration generate: inputs: # Local directory input - directory: path: \"proto\" root: \".\" # Remote Git repository input - git_repo: url: \"github.com/acme/weather@v1.2.3\" ","content":"Complete Configuration Example Code generation configuration generate: inputs: # Local directory input - directory: path: \"proto\" root: \".\" # Remote Git repository input - git_repo: url: \"github.com/acme/weather@v1.2.3\" sub_directory: \"proto/api\" # Another remote repository - git_repo: url: \"https://github.com/company/internal-protos.git\" sub_directory: \"definitions\" plugins: # Local plugin execution - name: go out: ./gen/go opts: paths: source_relative module: github.com/mycompany/myproject with_imports: true # Local plugin with custom options - name: go-grpc out: ./gen/go opts: paths: source_relative require_unimplemented_servers: false"},{"id":"cli/generator/generator::complete-configuration-example::9","title":"Generator","section":"Complete Configuration Example","path":"/docs/guide/cli/generator/generator#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example Managed mode - automatically set file and field options managed: enabled: true disable: - module: github.com/googleapis/googleapis # Disable for specific module override: - file_option: go_","content":"Complete Configuration Example Managed mode - automatically set file and field options managed: enabled: true disable: - module: github.com/googleapis/googleapis # Disable for specific module override: - file_option: go_package_prefix value: github.com/mycompany/myproject/gen/go - file_option: java_package_prefix value: com.mycompany - file_option: csharp_namespace_prefix value: MyCompany - field_option: jstype value: JS_STRING path: api/v1/ # Apply to specific path"},{"id":"cli/generator/generator::complete-configuration-example::10","title":"Generator","section":"Complete Configuration Example","path":"/docs/guide/cli/generator/generator#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example ```","content":"Complete Configuration Example ```"},{"id":"cli/generator/generator::local-directory-input::11","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input Local directory input is the most common and straightforward way to specify proto files for generation. Use this when your proto files are already present in your project directory structure.","content":"Local Directory Input Local directory input is the most common and straightforward way to specify proto files for generation. Use this when your proto files are already present in your project directory structure."},{"id":"cli/generator/generator::local-directory-input::12","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input **When to use:** Proto files are part of your project repository You need full control over proto file organization Working with a single service or application Proto files don't change frequently","content":"Local Directory Input **When to use:** Proto files are part of your project repository You need full control over proto file organization Working with a single service or application Proto files don't change frequently"},{"id":"cli/generator/generator::local-directory-input::13","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input The root parameter is particularly useful in monorepo setups where you need to control import path resolution. When root is set to a parent directory, import paths in your proto files will be resolv","content":"Local Directory Input The root parameter is particularly useful in monorepo setups where you need to control import path resolution. When root is set to a parent directory, import paths in your proto files will be resolved relative to that root, not the current working directory."},{"id":"cli/generator/generator::local-directory-input::14","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input **Parameters:**","content":"Local Directory Input **Parameters:**"},{"id":"cli/generator/generator::local-directory-input::15","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input Parameter Type Required Default Description ----------- ------ ---------- --------- ------------- path string ✅ - Path to the directory containing proto files root string ❌ \".\" Root directory used f","content":"Local Directory Input Parameter Type Required Default Description ----------- ------ ---------- --------- ------------- path string ✅ - Path to the directory containing proto files root string ❌ \".\" Root directory used for import path resolution"},{"id":"cli/generator/generator::local-directory-input::16","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input **Examples:**","content":"Local Directory Input **Examples:**"},{"id":"cli/generator/generator::local-directory-input::17","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input These examples show the difference between basic directory specification and advanced configuration with custom import resolution:","content":"Local Directory Input These examples show the difference between basic directory specification and advanced configuration with custom import resolution:"},{"id":"cli/generator/generator::local-directory-input::18","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input ```yaml Basic usage - Simple path specification inputs: - directory: \"api/proto\"","content":"Local Directory Input ```yaml Basic usage - Simple path specification inputs: - directory: \"api/proto\""},{"id":"cli/generator/generator::local-directory-input::19","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input Advanced usage with custom root - Controls import path resolution inputs: - directory: path: \"services/auth/proto\" root: \"services/auth\" # Imports will be relative to this path ```","content":"Local Directory Input Advanced usage with custom root - Controls import path resolution inputs: - directory: path: \"services/auth/proto\" root: \"services/auth\" # Imports will be relative to this path ```"},{"id":"cli/generator/generator::remote-git-repository-input::20","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input Remote Git repository input allows you to generate code from proto files hosted in external repositories without requiring a local checkout. This is particularly powerful for consuming APIs fr","content":"Remote Git Repository Input Remote Git repository input allows you to generate code from proto files hosted in external repositories without requiring a local checkout. This is particularly powerful for consuming APIs from other teams or external vendors."},{"id":"cli/generator/generator::remote-git-repository-input::21","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input **When to use:** Consuming proto definitions from other teams or services Integrating with vendor APIs that provide proto definitions Working with shared proto libraries across multiple projec","content":"Remote Git Repository Input **When to use:** Consuming proto definitions from other teams or services Integrating with vendor APIs that provide proto definitions Working with shared proto libraries across multiple projects You want to ensure you're always using the correct version of external APIs"},{"id":"cli/generator/generator::remote-git-repository-input::22","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input **Recommended approach:** Always pin to specific versions in production (@v1.0.0, not latest) Use semantic versions when available for easier dependency management Prefer public tags over comm","content":"Remote Git Repository Input **Recommended approach:** Always pin to specific versions in production (@v1.0.0, not latest) Use semantic versions when available for easier dependency management Prefer public tags over commit hashes for better traceability"},{"id":"cli/generator/generator::remote-git-repository-input::23","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input The root parameter controls import resolution root for files from this repository.","content":"Remote Git Repository Input The root parameter controls import resolution root for files from this repository."},{"id":"cli/generator/generator::remote-git-repository-input::24","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input **Parameters:**","content":"Remote Git Repository Input **Parameters:**"},{"id":"cli/generator/generator::remote-git-repository-input::25","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input Parameter Type Required Default Description ----------- ------ ---------- --------- ------------- url string ✅ - Git repository URL with optional version/tag/commit sub_directory string ❌ \"\" S","content":"Remote Git Repository Input Parameter Type Required Default Description ----------- ------ ---------- --------- ------------- url string ✅ - Git repository URL with optional version/tag/commit sub_directory string ❌ \"\" Subdirectory within the repository containing proto files root string ❌ \"\" Root path used for import resolution"},{"id":"cli/generator/generator::remote-git-repository-input::26","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input **URL Format Options:**","content":"Remote Git Repository Input **URL Format Options:**"},{"id":"cli/generator/generator::remote-git-repository-input::27","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input EasyP supports multiple URL formats to give you flexibility in how you reference remote repositories. Each format serves different use cases depending on your stability and versioning requirem","content":"Remote Git Repository Input EasyP supports multiple URL formats to give you flexibility in how you reference remote repositories. Each format serves different use cases depending on your stability and versioning requirements:"},{"id":"cli/generator/generator::remote-git-repository-input::28","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input **Tagged versions** are recommended for production as they provide stable, immutable references **Semantic versions** offer better readability and dependency management **Commit hashes** give ","content":"Remote Git Repository Input **Tagged versions** are recommended for production as they provide stable, immutable references **Semantic versions** offer better readability and dependency management **Commit hashes** give you access to specific commits when tags aren't available **Latest** should only be used in development environments due to unpredictability **Full HTTPS URLs** are useful for private repositories or non-GitHub hosting"},{"id":"cli/generator/generator::remote-git-repository-input::29","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input ```yaml Tag version - Best for production stability url: \"github.com/googleapis/googleapis@common-protos-1_3_1\"","content":"Remote Git Repository Input ```yaml Tag version - Best for production stability url: \"github.com/googleapis/googleapis@common-protos-1_3_1\""},{"id":"cli/generator/generator::remote-git-repository-input::30","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input Semantic version - Easier dependency management url: \"github.com/grpc-ecosystem/grpc-gateway@v2.19.1\"","content":"Remote Git Repository Input Semantic version - Easier dependency management url: \"github.com/grpc-ecosystem/grpc-gateway@v2.19.1\""},{"id":"cli/generator/generator::remote-git-repository-input::31","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input Commit hash - When you need a specific commit url: \"github.com/company/protos@abc123def456\"","content":"Remote Git Repository Input Commit hash - When you need a specific commit url: \"github.com/company/protos@abc123def456\""},{"id":"cli/generator/generator::remote-git-repository-input::32","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input Latest - Development only, not recommended for production url: \"github.com/company/protos\"","content":"Remote Git Repository Input Latest - Development only, not recommended for production url: \"github.com/company/protos\""},{"id":"cli/generator/generator::remote-git-repository-input::33","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input Full HTTPS URL - For private repos or custom Git hosts url: \"https://github.com/company/private-protos.git\" ```","content":"Remote Git Repository Input Full HTTPS URL - For private repos or custom Git hosts url: \"https://github.com/company/private-protos.git\" ```"},{"id":"cli/generator/generator::remote-git-repository-input::34","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input **Examples:**","content":"Remote Git Repository Input **Examples:**"},{"id":"cli/generator/generator::remote-git-repository-input::35","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input These examples demonstrate common patterns for consuming remote proto definitions from different types of repositories:","content":"Remote Git Repository Input These examples demonstrate common patterns for consuming remote proto definitions from different types of repositories:"},{"id":"cli/generator/generator::plugin-configuration::36","title":"Generator","section":"Plugin Configuration","path":"/docs/guide/cli/generator/generator#plugin-configuration","headings":["Plugin Configuration"],"excerpt":"Plugin Configuration Plugin configuration is where you specify which code generators to run and how they should behave. EasyP supports any protoc plugin, making it extremely flexible for different language ecosystems and","content":"Plugin Configuration Plugin configuration is where you specify which code generators to run and how they should behave. EasyP supports any protoc plugin, making it extremely flexible for different language ecosystems and use cases."},{"id":"cli/generator/generator::plugin-configuration::37","title":"Generator","section":"Plugin Configuration","path":"/docs/guide/cli/generator/generator#plugin-configuration","headings":["Plugin Configuration"],"excerpt":"Plugin Configuration At a high level, there are **four ways to specify how a plugin should be executed**:","content":"Plugin Configuration At a high level, there are **four ways to specify how a plugin should be executed**:"},{"id":"cli/generator/generator::plugin-configuration::38","title":"Generator","section":"Plugin Configuration","path":"/docs/guide/cli/generator/generator#plugin-configuration","headings":["Plugin Configuration"],"excerpt":"Plugin Configuration **name** – run plugin by name from PATH or use a builtin plugin. **path** – run plugin by absolute/relative path to an executable file. **remote** – run plugin via remote URL (EasyP remote executor).","content":"Plugin Configuration **name** – run plugin by name from PATH or use a builtin plugin. **path** – run plugin by absolute/relative path to an executable file. **remote** – run plugin via remote URL (EasyP remote executor). **command** – run plugin via arbitrary command (for example, go run ...)."},{"id":"cli/generator/generator::plugin-configuration::39","title":"Generator","section":"Plugin Configuration","path":"/docs/guide/cli/generator/generator#plugin-configuration","headings":["Plugin Configuration"],"excerpt":"Plugin Configuration Only **one** of name, path, remote, or command must be specified for each plugin.","content":"Plugin Configuration Only **one** of name, path, remote, or command must be specified for each plugin."},{"id":"cli/generator/generator::plugin-by-name-name::40","title":"Generator","section":"Plugin by Name (name)","path":"/docs/guide/cli/generator/generator#plugin-by-name-name","headings":["Plugin by Name (name)"],"excerpt":"Plugin by Name (name) Local plugin execution by name is the standard approach where plugins are installed on your system and executed directly by EasyP.","content":"Plugin by Name (name) Local plugin execution by name is the standard approach where plugins are installed on your system and executed directly by EasyP."},{"id":"cli/generator/generator::plugin-by-name-name::41","title":"Generator","section":"Plugin by Name (name)","path":"/docs/guide/cli/generator/generator#plugin-by-name-name","headings":["Plugin by Name (name)"],"excerpt":"Plugin by Name (name) **When to use name:** Standard language support (Go, Python, TypeScript, etc.) You have control over the build environment Performance is critical (no network overhead) You want to rely on PATH or b","content":"Plugin by Name (name) **When to use name:** Standard language support (Go, Python, TypeScript, etc.) You have control over the build environment Performance is critical (no network overhead) You want to rely on PATH or builtin plugins"},{"id":"cli/generator/generator::plugin-by-name-name::42","title":"Generator","section":"Plugin by Name (name)","path":"/docs/guide/cli/generator/generator#plugin-by-name-name","headings":["Plugin by Name (name)"],"excerpt":"Plugin by Name (name) **Installation requirements:** Plugins must be installed and available in your PATH (if not using builtin plugins). Plugin names follow the protoc-gen-{name} convention. Use package managers (go ins","content":"Plugin by Name (name) **Installation requirements:** Plugins must be installed and available in your PATH (if not using builtin plugins). Plugin names follow the protoc-gen-{name} convention. Use package managers (go install, npm install, pip install) for installation."},{"id":"cli/generator/generator::plugin-by-name-name::43","title":"Generator","section":"Plugin by Name (name)","path":"/docs/guide/cli/generator/generator#plugin-by-name-name","headings":["Plugin by Name (name)"],"excerpt":"Plugin by Name (name) The with_imports parameter is crucial when you're using dependencies from the package manager. Set it to true to include proto files from your deps section in the generation process.","content":"Plugin by Name (name) The with_imports parameter is crucial when you're using dependencies from the package manager. Set it to true to include proto files from your deps section in the generation process."},{"id":"cli/generator/generator::plugin-by-path-path::44","title":"Generator","section":"Plugin by Path (path)","path":"/docs/guide/cli/generator/generator#plugin-by-path-path","headings":["Plugin by Path (path)"],"excerpt":"Plugin by Path (path) Sometimes you need to run a plugin from a specific binary without putting it into PATH (for example, a binary in your repo or in a build directory). In this case you can specify an explicit path:","content":"Plugin by Path (path) Sometimes you need to run a plugin from a specific binary without putting it into PATH (for example, a binary in your repo or in a build directory). In this case you can specify an explicit path:"},{"id":"cli/generator/generator::plugin-by-path-path::45","title":"Generator","section":"Plugin by Path (path)","path":"/docs/guide/cli/generator/generator#plugin-by-path-path","headings":["Plugin by Path (path)"],"excerpt":"Plugin by Path (path) **When to use path:** You keep plugin binaries in the repository (for reproducible builds). You use different plugin versions side-by-side. You don't want to pollute the global PATH.","content":"Plugin by Path (path) **When to use path:** You keep plugin binaries in the repository (for reproducible builds). You use different plugin versions side-by-side. You don't want to pollute the global PATH."},{"id":"cli/generator/generator::remote-plugin-remote::46","title":"Generator","section":"Remote Plugin (remote)","path":"/docs/guide/cli/generator/generator#remote-plugin-remote","headings":["Remote Plugin (remote)"],"excerpt":"Remote Plugin (remote) Remote plugins are executed via a remote URL. EasyP will send a CodeGeneratorRequest to the remote endpoint and receive a CodeGeneratorResponse back.","content":"Remote Plugin (remote) Remote plugins are executed via a remote URL. EasyP will send a CodeGeneratorRequest to the remote endpoint and receive a CodeGeneratorResponse back."},{"id":"cli/generator/generator::remote-plugin-remote::47","title":"Generator","section":"Remote Plugin (remote)","path":"/docs/guide/cli/generator/generator#remote-plugin-remote","headings":["Remote Plugin (remote)"],"excerpt":"Remote Plugin (remote) Below is a real example of using the EasyP API Service as a remote plugin executor (same format as in the API Service docs):","content":"Remote Plugin (remote) Below is a real example of using the EasyP API Service as a remote plugin executor (same format as in the API Service docs):"},{"id":"cli/generator/generator::remote-plugin-remote::48","title":"Generator","section":"Remote Plugin (remote)","path":"/docs/guide/cli/generator/generator#remote-plugin-remote","headings":["Remote Plugin (remote)"],"excerpt":"Remote Plugin (remote) ```yaml generate: plugins: # Remote plugin execution via EasyP API Service - remote: api.easyp.tech/protobuf/go:v1.36.10 out: . opts: paths: source_relative","content":"Remote Plugin (remote) ```yaml generate: plugins: # Remote plugin execution via EasyP API Service - remote: api.easyp.tech/protobuf/go:v1.36.10 out: . opts: paths: source_relative"},{"id":"cli/generator/generator::remote-plugin-remote::49","title":"Generator","section":"Remote Plugin (remote)","path":"/docs/guide/cli/generator/generator#remote-plugin-remote","headings":["Remote Plugin (remote)"],"excerpt":"Remote Plugin (remote) remote: api.easyp.tech/grpc/go:v1.5.1 out: . opts: paths: source_relative ```","content":"Remote Plugin (remote) remote: api.easyp.tech/grpc/go:v1.5.1 out: . opts: paths: source_relative ```"},{"id":"cli/generator/generator::remote-plugin-remote::50","title":"Generator","section":"Remote Plugin (remote)","path":"/docs/guide/cli/generator/generator#remote-plugin-remote","headings":["Remote Plugin (remote)"],"excerpt":"Remote Plugin (remote) **Typical use cases for remote:** Centralized plugin service inside your organization (e.g. EasyP API Service). Running heavy plugins on a dedicated server instead of CI agents. Sharing the same pl","content":"Remote Plugin (remote) **Typical use cases for remote:** Centralized plugin service inside your organization (e.g. EasyP API Service). Running heavy plugins on a dedicated server instead of CI agents. Sharing the same plugin implementation across multiple teams."},{"id":"cli/generator/generator::executing-plugin-via-command-command::51","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) You can specify a plugin as an array of commands to execute. This is useful for running plugins via go run or any other tool without prior installation of the plugin binary:","content":"Executing Plugin via Command (command) You can specify a plugin as an array of commands to execute. This is useful for running plugins via go run or any other tool without prior installation of the plugin binary:"},{"id":"cli/generator/generator::executing-plugin-via-command-command::52","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command)","content":"Executing Plugin via Command (command)"},{"id":"cli/generator/generator::executing-plugin-via-command-command::53","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) In this mode EasyP: **builds and runs the command** you provide as a child process; **writes CodeGeneratorRequest to stdin** of the process; **reads CodeGeneratorResponse from stdou","content":"Executing Plugin via Command (command) In this mode EasyP: **builds and runs the command** you provide as a child process; **writes CodeGeneratorRequest to stdin** of the process; **reads CodeGeneratorResponse from stdout**, just like with regular protoc plugins."},{"id":"cli/generator/generator::executing-plugin-via-command-command::54","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) **Plugin Source Priority:** command — execute via specified command (highest priority) remote — remote plugin via URL name — local plugin from PATH or builtin plugin path — path to ","content":"Executing Plugin via Command (command) **Plugin Source Priority:** command — execute via specified command (highest priority) remote — remote plugin via URL name — local plugin from PATH or builtin plugin path — path to plugin executable file"},{"id":"cli/generator/generator::executing-plugin-via-command-command::55","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) **Parameters (plugin sources and common options):**","content":"Executing Plugin via Command (command) **Parameters (plugin sources and common options):**"},{"id":"cli/generator/generator::executing-plugin-via-command-command::56","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) Parameter Type Required Default Description ----------- ------ ---------- --------- ------------- name string ❌ - Plugin name or identifier (e.g. go, go-grpc, grpc-gateway) command ","content":"Executing Plugin via Command (command) Parameter Type Required Default Description ----------- ------ ---------- --------- ------------- name string ❌ - Plugin name or identifier (e.g. go, go-grpc, grpc-gateway) command []string ❌ - Command to execute plugin (e.g., [\"go\", \"run\", \"package\"]) remote string ❌ - Remote plugin URL path string ❌ - Path to plugin executable file out string ❌ resolved generate root Output directory for generated files opts mapstring ❌ {} Plugin-specific options; list values are emitted as repeated key=value params with_imports bool ❌ false Include proto files from dependencies"},{"id":"cli/generator/generator::executing-plugin-via-command-command::57","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) **Note:** Only one plugin source (name, command, remote, or path) must be specified for each plugin. If opts.outputServices is set to [\"grpc-js\", \"generic-definitions\"], EasyP sends","content":"Executing Plugin via Command (command) **Note:** Only one plugin source (name, command, remote, or path) must be specified for each plugin. If opts.outputServices is set to [\"grpc-js\", \"generic-definitions\"], EasyP sends outputServices=grpc-js,outputServices=generic-definitions."},{"id":"cli/generator/generator::executing-plugin-via-command-command::58","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) **Command source examples:**","content":"Executing Plugin via Command (command) **Command source examples:**"},{"id":"cli/generator/generator::executing-plugin-via-command-command::59","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) ```yaml generate: inputs: - directory: \"proto\"","content":"Executing Plugin via Command (command) ```yaml generate: inputs: - directory: \"proto\""},{"id":"cli/generator/generator::executing-plugin-via-command-command::60","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) plugins: # 1) gRPC-Gateway via go run (no pre-installed binary required) - command: [\"go\", \"run\", \"github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.25.1\"] out: .","content":"Executing Plugin via Command (command) plugins: # 1) gRPC-Gateway via go run (no pre-installed binary required) - command: [\"go\", \"run\", \"github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.25.1\"] out: ./gen/go opts: paths: source_relative generate_unbound_methods: true"},{"id":"cli/generator/generator::executing-plugin-via-command-command::61","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) 2) protoc-gen-validate via go run - command: [\"go\", \"run\", \"github.com/bufbuild/protoc-gen-validate@v0.10.1\"] out: ./gen/go opts: paths: source_relative lang: go","content":"Executing Plugin via Command (command) 2) protoc-gen-validate via go run - command: [\"go\", \"run\", \"github.com/bufbuild/protoc-gen-validate@v0.10.1\"] out: ./gen/go opts: paths: source_relative lang: go"},{"id":"cli/generator/generator::executing-plugin-via-command-command::62","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) 3) Any custom wrapper script - command: [\"bash\", \"./scripts/custom-protoc-plugin.sh\"] out: ./gen/custom opts: foo: bar ```","content":"Executing Plugin via Command (command) 3) Any custom wrapper script - command: [\"bash\", \"./scripts/custom-protoc-plugin.sh\"] out: ./gen/custom opts: foo: bar ```"},{"id":"cli/generator/generator::builtin-plugins::63","title":"Generator","section":"Builtin Plugins","path":"/docs/guide/cli/generator/generator#builtin-plugins","headings":["Builtin Plugins"],"excerpt":"Builtin Plugins EasyP includes builtin plugins for basic protobuf and gRPC languages. These plugins are embedded in the binary as WASM modules and do not require installation of external dependencies.","content":"Builtin Plugins EasyP includes builtin plugins for basic protobuf and gRPC languages. These plugins are embedded in the binary as WASM modules and do not require installation of external dependencies."},{"id":"cli/generator/generator::builtin-plugins::64","title":"Generator","section":"Builtin Plugins","path":"/docs/guide/cli/generator/generator#builtin-plugins","headings":["Builtin Plugins"],"excerpt":"Builtin Plugins **Benefits of builtin plugins:** **Portability**: Single binary with all necessary plugins **Convenience**: No need to install external dependencies **Stability**: Plugin versions are fixed in the binary ","content":"Builtin Plugins **Benefits of builtin plugins:** **Portability**: Single binary with all necessary plugins **Convenience**: No need to install external dependencies **Stability**: Plugin versions are fixed in the binary **Isolation**: Independent of system plugin installations"},{"id":"cli/generator/generator::builtin-plugins::65","title":"Generator","section":"Builtin Plugins","path":"/docs/guide/cli/generator/generator#builtin-plugins","headings":["Builtin Plugins"],"excerpt":"Builtin Plugins **Supported builtin plugins:**","content":"Builtin Plugins **Supported builtin plugins:**"},{"id":"cli/generator/generator::protobuf-base-plugins::66","title":"Generator","section":"Protobuf Base Plugins","path":"/docs/guide/cli/generator/generator#protobuf-base-plugins","headings":["Protobuf Base Plugins"],"excerpt":"Protobuf Base Plugins The following plugins are builtin for generating base protobuf code:","content":"Protobuf Base Plugins The following plugins are builtin for generating base protobuf code:"},{"id":"cli/generator/generator::protobuf-base-plugins::67","title":"Generator","section":"Protobuf Base Plugins","path":"/docs/guide/cli/generator/generator#protobuf-base-plugins","headings":["Protobuf Base Plugins"],"excerpt":"Protobuf Base Plugins Plugin Name Description Corresponding protoc Plugin ------------- ------------- ---------------------------- cpp Generate C++ code from proto files protoc-gen-cpp csharp Generate C# code from proto ","content":"Protobuf Base Plugins Plugin Name Description Corresponding protoc Plugin ------------- ------------- ---------------------------- cpp Generate C++ code from proto files protoc-gen-cpp csharp Generate C# code from proto files protoc-gen-csharp java Generate Java code from proto files protoc-gen-java kotlin Generate Kotlin code from proto files protoc-gen-kotlin objc Generate Objective-C code from proto files protoc-gen-objc php Generate PHP code from proto files protoc-gen-php python Generate Python code from proto files protoc-gen-python ruby Generate Ruby code from proto files protoc-gen-ruby"},{"id":"cli/generator/generator::grpc-plugins::68","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins The following plugins are builtin for generating gRPC code:","content":"gRPC Plugins The following plugins are builtin for generating gRPC code:"},{"id":"cli/generator/generator::grpc-plugins::69","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins Plugin Name Description Corresponding protoc Plugin ------------- ------------- ---------------------------- grpc_cpp Generate gRPC code for C++ grpc_cpp_plugin grpc_csharp Generate gRPC code for C# grpc_csh","content":"gRPC Plugins Plugin Name Description Corresponding protoc Plugin ------------- ------------- ---------------------------- grpc_cpp Generate gRPC code for C++ grpc_cpp_plugin grpc_csharp Generate gRPC code for C# grpc_csharp_plugin grpc_java Generate gRPC code for Java grpc_java_plugin grpc_node Generate gRPC code for Node.js grpc_node_plugin grpc_objc Generate gRPC code for Objective-C grpc_objective_c_plugin grpc_php Generate gRPC code for PHP grpc_php_plugin grpc_python Generate gRPC code for Python grpc_python_plugin grpc_ruby Generate gRPC code for Ruby grpc_ruby_plugin"},{"id":"cli/generator/generator::grpc-plugins::70","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins **Plugin Selection Logic:**","content":"gRPC Plugins **Plugin Selection Logic:**"},{"id":"cli/generator/generator::grpc-plugins::71","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins EasyP uses the following priority when selecting an executor for a plugin:","content":"gRPC Plugins EasyP uses the following priority when selecting an executor for a plugin:"},{"id":"cli/generator/generator::grpc-plugins::72","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins **Remote plugin** (if url is specified) — always has the highest priority **Builtin plugin** (if plugin is builtin and not found in PATH) — used automatically **Local plugin** (from PATH) — used by default f","content":"gRPC Plugins **Remote plugin** (if url is specified) — always has the highest priority **Builtin plugin** (if plugin is builtin and not found in PATH) — used automatically **Local plugin** (from PATH) — used by default for backward compatibility"},{"id":"cli/generator/generator::grpc-plugins::73","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins **Usage Example:**","content":"gRPC Plugins **Usage Example:**"},{"id":"cli/generator/generator::grpc-plugins::74","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins **Requirements:**","content":"gRPC Plugins **Requirements:**"},{"id":"cli/generator/generator::grpc-plugins::75","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins Builtin plugins are included in the EasyP binary:","content":"gRPC Plugins Builtin plugins are included in the EasyP binary:"},{"id":"cli/generator/generator::grpc-plugins::76","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins ```bash Build go build ./cmd/easyp","content":"gRPC Plugins ```bash Build go build ./cmd/easyp"},{"id":"cli/generator/generator::grpc-plugins::77","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins Install go install github.com/easyp-tech/easyp/cmd/easyp@latest ```","content":"gRPC Plugins Install go install github.com/easyp-tech/easyp/cmd/easyp@latest ```"},{"id":"cli/generator/generator::grpc-plugins::78","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins **Backward Compatibility:**","content":"gRPC Plugins **Backward Compatibility:**"},{"id":"cli/generator/generator::grpc-plugins::79","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins Builtin plugins are fully compatible with existing configurations. If a plugin is found in PATH, it will be used instead of the builtin one. This ensures that:","content":"gRPC Plugins Builtin plugins are fully compatible with existing configurations. If a plugin is found in PATH, it will be used instead of the builtin one. This ensures that:"},{"id":"cli/generator/generator::grpc-plugins::80","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins Existing configurations continue to work without changes You can override a builtin plugin by installing it in your system Priority is given to local installations for flexibility","content":"gRPC Plugins Existing configurations continue to work without changes You can override a builtin plugin by installing it in your system Priority is given to local installations for flexibility"},{"id":"cli/generator/generator::plugin-options-reference::81","title":"Generator","section":"Plugin Options Reference","path":"/docs/guide/cli/generator/generator#plugin-options-reference","headings":["Plugin Options Reference"],"excerpt":"Plugin Options Reference This section covers the most commonly used plugins and their configuration options. Each plugin has specific parameters that control how code is generated, and understanding these options is cruc","content":"Plugin Options Reference This section covers the most commonly used plugins and their configuration options. Each plugin has specific parameters that control how code is generated, and understanding these options is crucial for getting the output you need."},{"id":"cli/generator/generator::go-plugins::82","title":"Generator","section":"Go Plugins","path":"/docs/guide/cli/generator/generator#go-plugins","headings":["Go Plugins"],"excerpt":"Go Plugins Go plugins are the most mature and widely used protoc plugins. The paths option controls how import paths are resolved, while other options provide fine-grained control over the generated code:","content":"Go Plugins Go plugins are the most mature and widely used protoc plugins. The paths option controls how import paths are resolved, while other options provide fine-grained control over the generated code:"},{"id":"cli/generator/generator::grpc-gateway-plugins::83","title":"Generator","section":"gRPC-Gateway Plugins","path":"/docs/guide/cli/generator/generator#grpc-gateway-plugins","headings":["gRPC-Gateway Plugins"],"excerpt":"gRPC-Gateway Plugins gRPC-Gateway plugins enable you to serve gRPC services as REST APIs and generate OpenAPI documentation. These are essential for building HTTP/JSON APIs from gRPC services:","content":"gRPC-Gateway Plugins gRPC-Gateway plugins enable you to serve gRPC services as REST APIs and generate OpenAPI documentation. These are essential for building HTTP/JSON APIs from gRPC services:"},{"id":"cli/generator/generator::validation-plugins::84","title":"Generator","section":"Validation Plugins","path":"/docs/guide/cli/generator/generator#validation-plugins","headings":["Validation Plugins"],"excerpt":"Validation Plugins Validation plugins generate code that automatically validates proto message fields based on constraints defined in your proto files. This eliminates the need for manual validation code:","content":"Validation Plugins Validation plugins generate code that automatically validates proto message fields based on constraints defined in your proto files. This eliminates the need for manual validation code:"},{"id":"cli/generator/generator::typescriptjavascript-plugins::85","title":"Generator","section":"TypeScript/JavaScript Plugins","path":"/docs/guide/cli/generator/generator#typescriptjavascript-plugins","headings":["TypeScript/JavaScript Plugins"],"excerpt":"TypeScript/JavaScript Plugins TypeScript plugins are essential for frontend development, providing type-safe interfaces for your proto definitions and gRPC services in web applications:","content":"TypeScript/JavaScript Plugins TypeScript plugins are essential for frontend development, providing type-safe interfaces for your proto definitions and gRPC services in web applications:"},{"id":"cli/generator/generator::managed-mode::86","title":"Generator","section":"Managed Mode","path":"/docs/guide/cli/generator/generator#managed-mode","headings":["Managed Mode"],"excerpt":"Managed Mode Managed mode automatically sets file and field options in your protobuf descriptors during code generation without modifying the original .proto files. This feature is compatible with buf's managed mode and ","content":"Managed Mode Managed mode automatically sets file and field options in your protobuf descriptors during code generation without modifying the original .proto files. This feature is compatible with buf's managed mode and provides a consistent way to manage language-specific options across your codebase."},{"id":"cli/generator/generator::managed-mode::87","title":"Generator","section":"Managed Mode","path":"/docs/guide/cli/generator/generator#managed-mode","headings":["Managed Mode"],"excerpt":"Managed Mode **Key benefits:** **No proto file modifications**: Options are applied at generation time, keeping your proto files clean **Consistent defaults**: Automatic application of language-specific naming convention","content":"Managed Mode **Key benefits:** **No proto file modifications**: Options are applied at generation time, keeping your proto files clean **Consistent defaults**: Automatic application of language-specific naming conventions **Centralized configuration**: Manage all options in one place (easyp.yaml) **Module-specific rules**: Apply different options to different modules or paths **buf compatibility**: Works the same way as buf managed mode"},{"id":"cli/generator/generator::how-it-works::88","title":"Generator","section":"How It Works","path":"/docs/guide/cli/generator/generator#how-it-works","headings":["How It Works"],"excerpt":"How It Works When managed mode is enabled, EasyP automatically applies file and field options to your protobuf descriptors before code generation. This happens in memory, so your original .proto files remain unchanged.","content":"How It Works When managed mode is enabled, EasyP automatically applies file and field options to your protobuf descriptors before code generation. This happens in memory, so your original .proto files remain unchanged."},{"id":"cli/generator/generator::how-it-works::89","title":"Generator","section":"How It Works","path":"/docs/guide/cli/generator/generator#how-it-works","headings":["How It Works"],"excerpt":"How It Works **Default values** are applied for certain options based on language conventions: Java: java_package_prefix defaults to \"com\", java_multiple_files defaults to true C#: csharp_namespace defaults to PascalCase","content":"How It Works **Default values** are applied for certain options based on language conventions: Java: java_package_prefix defaults to \"com\", java_multiple_files defaults to true C#: csharp_namespace defaults to PascalCase of package name Ruby: ruby_package defaults to PascalCase with :: separator PHP: php_namespace defaults to PascalCase with \\ separator Objective-C: objc_class_prefix defaults to first letters of package parts C++: cc_enable_arenas defaults to true"},{"id":"cli/generator/generator::how-it-works::90","title":"Generator","section":"How It Works","path":"/docs/guide/cli/generator/generator#how-it-works","headings":["How It Works"],"excerpt":"How It Works **Overrides** allow you to set specific values for options, with support for filtering by module, protobuf package, path, or field. Without module, package, or path, an override applies to all files in the g","content":"How It Works **Overrides** allow you to set specific values for options, with support for filtering by module, protobuf package, path, or field. Without module, package, or path, an override applies to all files in the generation request, including dependencies and git_repo inputs."},{"id":"cli/generator/generator::how-it-works::91","title":"Generator","section":"How It Works","path":"/docs/guide/cli/generator/generator#how-it-works","headings":["How It Works"],"excerpt":"How It Works **Disables** allow you to prevent managed mode from modifying specific options or files. This is the recommended way to exclude external dependencies that already define their own options.","content":"How It Works **Disables** allow you to prevent managed mode from modifying specific options or files. This is the recommended way to exclude external dependencies that already define their own options."},{"id":"cli/generator/generator::configuration::92","title":"Generator","section":"Configuration","path":"/docs/guide/cli/generator/generator#configuration","headings":["Configuration"],"excerpt":"Configuration ```yaml generate: managed: enabled: true disable: # Disable managed mode for specific module - module: github.com/googleapis/googleapis # Disable specific option globally - file_option: java_package_prefix","content":"Configuration ```yaml generate: managed: enabled: true disable: # Disable managed mode for specific module - module: github.com/googleapis/googleapis # Disable specific option globally - file_option: java_package_prefix"},{"id":"cli/generator/generator::configuration::93","title":"Generator","section":"Configuration","path":"/docs/guide/cli/generator/generator#configuration","headings":["Configuration"],"excerpt":"Configuration Disable for specific protobuf package - package: acme.weather.v1 file_option: java_package # Disable for specific path - path: legacy/ file_option: go_package # Disable field option for specific field - fie","content":"Configuration Disable for specific protobuf package - package: acme.weather.v1 file_option: java_package # Disable for specific path - path: legacy/ file_option: go_package # Disable field option for specific field - field_option: jstype field: com.example.User.id override: # Override go_package_prefix for all files - file_option: go_package_prefix value: github.com/mycompany/myproject/gen/go # Override for specific module - file_option: java_package_prefix value: com.mycompany module: github.com/mycompany/internal-protos"},{"id":"cli/generator/generator::configuration::94","title":"Generator","section":"Configuration","path":"/docs/guide/cli/generator/generator#configuration","headings":["Configuration"],"excerpt":"Configuration Override for specific protobuf package - file_option: go_package_prefix value: github.com/mycompany/myproject/gen/go package: acme.weather.v1 # Override for specific path - file_option: csharp_namespace_pre","content":"Configuration Override for specific protobuf package - file_option: go_package_prefix value: github.com/mycompany/myproject/gen/go package: acme.weather.v1 # Override for specific path - file_option: csharp_namespace_prefix value: MyCompany path: api/v1/ # Override for multiple files with same value using prefix path # This matches both internal/cms/bmi.proto and internal/cms/bmi_service.proto - file_option: go_package value: spec/cms/bmi path: \"internal/cms/bmi\" # Override field option for specific path - field_option: jstype value: JS_STRING path: api/v1/ # Override for specific field - field_option: jstype value: JS_NUMBER field: com.example.User.big_id ```"},{"id":"cli/generator/generator::supported-file-options::95","title":"Generator","section":"Supported File Options","path":"/docs/guide/cli/generator/generator#supported-file-options","headings":["Supported File Options"],"excerpt":"Supported File Options Option Description Has Default? -------- ------------- -------------- go_package Go import path ❌ go_package_prefix Prefix for Go import paths ❌ java_package Java package name ❌ java_package_prefix","content":"Supported File Options Option Description Has Default? -------- ------------- -------------- go_package Go import path ❌ go_package_prefix Prefix for Go import paths ❌ java_package Java package name ❌ java_package_prefix Prefix for Java packages ✅ (\"com\") java_package_suffix Suffix for Java packages ❌ java_multiple_files Generate multiple Java files ✅ (true) java_outer_classname Outer class name ✅ (PascalCase + \"Proto\") java_string_check_utf8 UTF-8 validation ❌ csharp_namespace C# namespace ✅ (PascalCase) csharp_namespace_prefix Prefix for C# namespaces ❌ ruby_package Ruby module name ✅ (PascalCase with ::) ruby_package_suffix Suffix for Ruby packages ❌ php_namespace PHP namespace ✅ (PascalCase with \\) php_metadata_namespace PHP metadata namespace ❌ php_metadata_namespace_suffix Suffix for PHP metadata ❌ objc_class_prefix Objective-C class prefix ✅ (First letters) swift_prefix Swift prefix ❌ optimize_for Code generation optimization ❌ cc_enable_arenas C++ arena allocation ✅ (true)"},{"id":"cli/generator/generator::supported-field-options::96","title":"Generator","section":"Supported Field Options","path":"/docs/guide/cli/generator/generator#supported-field-options","headings":["Supported Field Options"],"excerpt":"Supported Field Options Option Description Applies To -------- ------------- ------------ jstype JavaScript type for 64-bit integers int64, uint64, sint64, fixed64, sfixed64","content":"Supported Field Options Option Description Applies To -------- ------------- ------------ jstype JavaScript type for 64-bit integers int64, uint64, sint64, fixed64, sfixed64"},{"id":"cli/generator/generator::basic-setup-with-defaults::97","title":"Generator","section":"Basic Setup with Defaults","path":"/docs/guide/cli/generator/generator#basic-setup-with-defaults","headings":["Basic Setup with Defaults"],"excerpt":"Basic Setup with Defaults Enable managed mode to get automatic defaults for all supported languages:","content":"Basic Setup with Defaults Enable managed mode to get automatic defaults for all supported languages:"},{"id":"cli/generator/generator::basic-setup-with-defaults::98","title":"Generator","section":"Basic Setup with Defaults","path":"/docs/guide/cli/generator/generator#basic-setup-with-defaults","headings":["Basic Setup with Defaults"],"excerpt":"Basic Setup with Defaults This will automatically: Set java_package to com. for all files Set java_multiple_files to true Set csharp_namespace to PascalCase of package name Set ruby_package to PascalCase with :: separato","content":"Basic Setup with Defaults This will automatically: Set java_package to com. for all files Set java_multiple_files to true Set csharp_namespace to PascalCase of package name Set ruby_package to PascalCase with :: separator And more..."},{"id":"cli/generator/generator::custom-go-package-prefix::99","title":"Generator","section":"Custom Go Package Prefix","path":"/docs/guide/cli/generator/generator#custom-go-package-prefix","headings":["Custom Go Package Prefix"],"excerpt":"Custom Go Package Prefix Override the Go package prefix for your project:","content":"Custom Go Package Prefix Override the Go package prefix for your project:"},{"id":"cli/generator/generator::custom-go-package-prefix::100","title":"Generator","section":"Custom Go Package Prefix","path":"/docs/guide/cli/generator/generator#custom-go-package-prefix","headings":["Custom Go Package Prefix"],"excerpt":"Custom Go Package Prefix This will set go_package to github.com/mycompany/myproject/gen/go/ for all files.","content":"Custom Go Package Prefix This will set go_package to github.com/mycompany/myproject/gen/go/ for all files."},{"id":"cli/generator/generator::dynamic-go-package-paths-with-markers::101","title":"Generator","section":"Dynamic Go Package Paths with Markers","path":"/docs/guide/cli/generator/generator#dynamic-go-package-paths-with-markers","headings":["Dynamic Go Package Paths with Markers"],"excerpt":"Dynamic Go Package Paths with Markers For more complex path generation, you can use markers in go_package_prefix or go_package values:","content":"Dynamic Go Package Paths with Markers For more complex path generation, you can use markers in go_package_prefix or go_package values:"},{"id":"cli/generator/generator::dynamic-go-package-paths-with-markers::102","title":"Generator","section":"Dynamic Go Package Paths with Markers","path":"/docs/guide/cli/generator/generator#dynamic-go-package-paths-with-markers","headings":["Dynamic Go Package Paths with Markers"],"excerpt":"Dynamic Go Package Paths with Markers","content":"Dynamic Go Package Paths with Markers"},{"id":"cli/generator/generator::dynamic-go-package-paths-with-markers::103","title":"Generator","section":"Dynamic Go Package Paths with Markers","path":"/docs/guide/cli/generator/generator#dynamic-go-package-paths-with-markers","headings":["Dynamic Go Package Paths with Markers"],"excerpt":"Dynamic Go Package Paths with Markers **Available markers:** {{file_path}} - Full file path without .proto extension - Example: internal/cms/as.proto → internal/cms/as {{file_dir}} - Directory path only, without filename","content":"Dynamic Go Package Paths with Markers **Available markers:** {{file_path}} - Full file path without .proto extension - Example: internal/cms/as.proto → internal/cms/as {{file_dir}} - Directory path only, without filename - Example: internal/cms/as.proto → internal/cms {{file_dir_without:prefix/}} - Directory path with prefix removed, and base filename without _service/_grpc suffixes - Example: {{file_dir_without:internal/}} for internal/cms/as_service.proto → cms/as {{file_path_without:prefix/}} - Full file path with prefix removed - Example: {{file_path_without:internal/}} for internal/cms/as.proto → cms/as"},{"id":"cli/generator/generator::module-specific-overrides::104","title":"Generator","section":"Module-Specific Overrides","path":"/docs/guide/cli/generator/generator#module-specific-overrides","headings":["Module-Specific Overrides"],"excerpt":"Module-Specific Overrides Apply different options to different modules:","content":"Module-Specific Overrides Apply different options to different modules:"},{"id":"cli/generator/generator::module-specific-overrides::105","title":"Generator","section":"Module-Specific Overrides","path":"/docs/guide/cli/generator/generator#module-specific-overrides","headings":["Module-Specific Overrides"],"excerpt":"Module-Specific Overrides module matches the EasyP module source exactly: the dependency or git_repo.url value before @version (for example github.com/mycompany/internal-protos or https://github.com/mycompany/internal-pr","content":"Module-Specific Overrides module matches the EasyP module source exactly: the dependency or git_repo.url value before @version (for example github.com/mycompany/internal-protos or https://github.com/mycompany/internal-protos). It is not the Go module path from go.mod."},{"id":"cli/generator/generator::module-specific-overrides::106","title":"Generator","section":"Module-Specific Overrides","path":"/docs/guide/cli/generator/generator#module-specific-overrides","headings":["Module-Specific Overrides"],"excerpt":"Module-Specific Overrides package matches the protobuf package declaration exactly, for example acme.weather.v1.","content":"Module-Specific Overrides package matches the protobuf package declaration exactly, for example acme.weather.v1."},{"id":"cli/generator/generator::package-specific-overrides::107","title":"Generator","section":"Package-Specific Overrides","path":"/docs/guide/cli/generator/generator#package-specific-overrides","headings":["Package-Specific Overrides"],"excerpt":"Package-Specific Overrides Apply different options to files from a specific protobuf package:","content":"Package-Specific Overrides Apply different options to files from a specific protobuf package:"},{"id":"cli/generator/generator::disabling-for-external-dependencies::108","title":"Generator","section":"Disabling for External Dependencies","path":"/docs/guide/cli/generator/generator#disabling-for-external-dependencies","headings":["Disabling for External Dependencies"],"excerpt":"Disabling for External Dependencies Disable managed mode for external dependencies that already have their options set:","content":"Disabling for External Dependencies Disable managed mode for external dependencies that already have their options set:"},{"id":"cli/generator/generator::disabling-for-external-dependencies::109","title":"Generator","section":"Disabling for External Dependencies","path":"/docs/guide/cli/generator/generator#disabling-for-external-dependencies","headings":["Disabling for External Dependencies"],"excerpt":"Disabling for External Dependencies","content":"Disabling for External Dependencies"},{"id":"cli/generator/generator::javascript-type-safety::110","title":"Generator","section":"JavaScript Type Safety","path":"/docs/guide/cli/generator/generator#javascript-type-safety","headings":["JavaScript Type Safety"],"excerpt":"JavaScript Type Safety Set jstype to JS_STRING for all 64-bit integer fields to prevent precision loss in JavaScript:","content":"JavaScript Type Safety Set jstype to JS_STRING for all 64-bit integer fields to prevent precision loss in JavaScript:"},{"id":"cli/generator/generator::path-matching::111","title":"Generator","section":"Path Matching","path":"/docs/guide/cli/generator/generator#path-matching","headings":["Path Matching"],"excerpt":"Path Matching Path matching in managed mode uses prefix-based matching (same as buf):","content":"Path Matching Path matching in managed mode uses prefix-based matching (same as buf):"},{"id":"cli/generator/generator::path-matching::112","title":"Generator","section":"Path Matching","path":"/docs/guide/cli/generator/generator#path-matching","headings":["Path Matching"],"excerpt":"Path Matching **Directory path** (ending with /): Matches all files in that directory and subdirectories - Example: path: \"internal/cms/\" matches internal/cms/as.proto, internal/cms/node.proto, internal/cms/v1/service.pr","content":"Path Matching **Directory path** (ending with /): Matches all files in that directory and subdirectories - Example: path: \"internal/cms/\" matches internal/cms/as.proto, internal/cms/node.proto, internal/cms/v1/service.proto **Exact file path** (ending with .proto): Matches only that specific file - Example: path: \"internal/cms/as.proto\" matches only internal/cms/as.proto **Prefix path** (no trailing / or .proto): Uses prefix matching (not directory-aware) - Example: path: \"internal/cms\" matches internal/cms/as.proto but also internal/cmsv2/file.proto"},{"id":"cli/generator/generator::rule-precedence::113","title":"Generator","section":"Rule Precedence","path":"/docs/guide/cli/generator/generator#rule-precedence","headings":["Rule Precedence"],"excerpt":"Rule Precedence When multiple rules match the same file or field, the following precedence applies:","content":"Rule Precedence When multiple rules match the same file or field, the following precedence applies:"},{"id":"cli/generator/generator::rule-precedence::114","title":"Generator","section":"Rule Precedence","path":"/docs/guide/cli/generator/generator#rule-precedence","headings":["Rule Precedence"],"excerpt":"Rule Precedence **Disable rules** take precedence - if an option is disabled, it won't be applied **Override rules** are applied in order - the last matching rule wins **Default values** are applied only if no override m","content":"Rule Precedence **Disable rules** take precedence - if an option is disabled, it won't be applied **Override rules** are applied in order - the last matching rule wins **Default values** are applied only if no override matches and the option isn't disabled"},{"id":"cli/generator/generator::compatibility-with-buf::115","title":"Generator","section":"Compatibility with buf","path":"/docs/guide/cli/generator/generator#compatibility-with-buf","headings":["Compatibility with buf"],"excerpt":"Compatibility with buf EasyP's managed mode is compatible with buf's managed mode. The same configuration format and behavior apply, making it easy to migrate between tools or use both in the same workflow.","content":"Compatibility with buf EasyP's managed mode is compatible with buf's managed mode. The same configuration format and behavior apply, making it easy to migrate between tools or use both in the same workflow."},{"id":"cli/generator/generator::descriptor-set-generation::116","title":"Generator","section":"Descriptor Set Generation","path":"/docs/guide/cli/generator/generator#descriptor-set-generation","headings":["Descriptor Set Generation"],"excerpt":"Descriptor Set Generation **https://protobuf.dev/programming-guides/techniques/#self-description**","content":"Descriptor Set Generation **https://protobuf.dev/programming-guides/techniques/#self-description**"},{"id":"cli/generator/generator::descriptor-set-generation::117","title":"Generator","section":"Descriptor Set Generation","path":"/docs/guide/cli/generator/generator#descriptor-set-generation","headings":["Descriptor Set Generation"],"excerpt":"Descriptor Set Generation EasyP supports generating binary FileDescriptorSet files using the --descriptor_set_out flag. This allows you to create self-describing protobuf messages that include schema information alongsid","content":"Descriptor Set Generation EasyP supports generating binary FileDescriptorSet files using the --descriptor_set_out flag. This allows you to create self-describing protobuf messages that include schema information alongside the data."},{"id":"cli/generator/generator::descriptor-set-generation::118","title":"Generator","section":"Descriptor Set Generation","path":"/docs/guide/cli/generator/generator#descriptor-set-generation","headings":["Descriptor Set Generation"],"excerpt":"Descriptor Set Generation **CLI flags:**","content":"Descriptor Set Generation **CLI flags:**"},{"id":"cli/generator/generator::descriptor-set-generation::119","title":"Generator","section":"Descriptor Set Generation","path":"/docs/guide/cli/generator/generator#descriptor-set-generation","headings":["Descriptor Set Generation"],"excerpt":"Descriptor Set Generation --descriptor_set_out - Output path for the binary FileDescriptorSet --include_imports - Include all transitive dependencies in the FileDescriptorSet","content":"Descriptor Set Generation --descriptor_set_out - Output path for the binary FileDescriptorSet --include_imports - Include all transitive dependencies in the FileDescriptorSet"},{"id":"cli/generator/generator::descriptor-set-generation::120","title":"Generator","section":"Descriptor Set Generation","path":"/docs/guide/cli/generator/generator#descriptor-set-generation","headings":["Descriptor Set Generation"],"excerpt":"Descriptor Set Generation **Example:**","content":"Descriptor Set Generation **Example:**"},{"id":"cli/generator/generator::descriptor-set-generation::121","title":"Generator","section":"Descriptor Set Generation","path":"/docs/guide/cli/generator/generator#descriptor-set-generation","headings":["Descriptor Set Generation"],"excerpt":"Descriptor Set Generation ```bash Generate descriptor set with only target files easyp generate --descriptor_set_out=./schema.pb","content":"Descriptor Set Generation ```bash Generate descriptor set with only target files easyp generate --descriptor_set_out=./schema.pb"},{"id":"cli/generator/generator::descriptor-set-generation::122","title":"Generator","section":"Descriptor Set Generation","path":"/docs/guide/cli/generator/generator#descriptor-set-generation","headings":["Descriptor Set Generation"],"excerpt":"Descriptor Set Generation Generate descriptor set with all dependencies easyp generate --descriptor_set_out=./schema.pb --include_imports ```","content":"Descriptor Set Generation Generate descriptor set with all dependencies easyp generate --descriptor_set_out=./schema.pb --include_imports ```"},{"id":"cli/generator/generator::descriptor-set-generation::123","title":"Generator","section":"Descriptor Set Generation","path":"/docs/guide/cli/generator/generator#descriptor-set-generation","headings":["Descriptor Set Generation"],"excerpt":"Descriptor Set Generation Self-describing messages are useful for dynamic message parsing, runtime schema validation, schema registries, and building generic gRPC clients. For more information, see the Protocol Buffers d","content":"Descriptor Set Generation Self-describing messages are useful for dynamic message parsing, runtime schema validation, schema registries, and building generic gRPC clients. For more information, see the Protocol Buffers documentation on self-description."},{"id":"cli/generator/generator::package-manager-integration::124","title":"Generator","section":"Package Manager Integration","path":"/docs/guide/cli/generator/generator#package-manager-integration","headings":["Package Manager Integration"],"excerpt":"Package Manager Integration One of EasyP's most powerful features is the seamless integration between the package manager and code generator. This integration eliminates the common problem of managing proto dependencies ","content":"Package Manager Integration One of EasyP's most powerful features is the seamless integration between the package manager and code generator. This integration eliminates the common problem of managing proto dependencies manually and ensures that your generated code always has access to the correct versions of imported proto files."},{"id":"cli/generator/generator::package-manager-integration::125","title":"Generator","section":"Package Manager Integration","path":"/docs/guide/cli/generator/generator#package-manager-integration","headings":["Package Manager Integration"],"excerpt":"Package Manager Integration **Key benefits:** **Automatic dependency resolution**: No need to manually manage proto import paths **Version consistency**: Dependencies are locked to specific versions via easyp.lock **Tran","content":"Package Manager Integration **Key benefits:** **Automatic dependency resolution**: No need to manually manage proto import paths **Version consistency**: Dependencies are locked to specific versions via easyp.lock **Transitive dependencies**: EasyP handles dependencies of dependencies automatically **Performance**: Local caching means dependencies are downloaded once and reused"},{"id":"cli/generator/generator::automatic-dependency-resolution::126","title":"Generator","section":"Automatic Dependency Resolution","path":"/docs/guide/cli/generator/generator#automatic-dependency-resolution","headings":["Automatic Dependency Resolution"],"excerpt":"Automatic Dependency Resolution When you define dependencies in the deps section, the generator automatically includes them in the proto path. This means your proto files can import from these dependencies without any ad","content":"Automatic Dependency Resolution When you define dependencies in the deps section, the generator automatically includes them in the proto path. This means your proto files can import from these dependencies without any additional configuration."},{"id":"cli/generator/generator::automatic-dependency-resolution::127","title":"Generator","section":"Automatic Dependency Resolution","path":"/docs/guide/cli/generator/generator#automatic-dependency-resolution","headings":["Automatic Dependency Resolution"],"excerpt":"Automatic Dependency Resolution **How it works:** EasyP downloads and caches dependencies based on your deps configuration During generation, these cached proto files are automatically added to the protoc import path You","content":"Automatic Dependency Resolution **How it works:** EasyP downloads and caches dependencies based on your deps configuration During generation, these cached proto files are automatically added to the protoc import path Your proto files can import from dependencies using standard import statements Generated code includes both your local protos and dependency protos when with_imports: true"},{"id":"cli/generator/generator::automatic-dependency-resolution::128","title":"Generator","section":"Automatic Dependency Resolution","path":"/docs/guide/cli/generator/generator#automatic-dependency-resolution","headings":["Automatic Dependency Resolution"],"excerpt":"Automatic Dependency Resolution Here's a simple example showing how dependency resolution works automatically. Notice that you only need to specify the dependencies once in the deps section:","content":"Automatic Dependency Resolution Here's a simple example showing how dependency resolution works automatically. Notice that you only need to specify the dependencies once in the deps section:"},{"id":"cli/generator/generator::automatic-dependency-resolution::129","title":"Generator","section":"Automatic Dependency Resolution","path":"/docs/guide/cli/generator/generator#automatic-dependency-resolution","headings":["Automatic Dependency Resolution"],"excerpt":"Automatic Dependency Resolution ```yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc-ecosystem/grpc-gateway@v2.19.1","content":"Automatic Dependency Resolution ```yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc-ecosystem/grpc-gateway@v2.19.1"},{"id":"cli/generator/generator::automatic-dependency-resolution::130","title":"Generator","section":"Automatic Dependency Resolution","path":"/docs/guide/cli/generator/generator#automatic-dependency-resolution","headings":["Automatic Dependency Resolution"],"excerpt":"Automatic Dependency Resolution generate: inputs: - directory: \"proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true # This automatically includes googleapis and grpc-gateway protos ``","content":"Automatic Dependency Resolution generate: inputs: - directory: \"proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true # This automatically includes googleapis and grpc-gateway protos ```"},{"id":"cli/generator/generator::dependency-usage-examples::131","title":"Generator","section":"Dependency Usage Examples","path":"/docs/guide/cli/generator/generator#dependency-usage-examples","headings":["Dependency Usage Examples"],"excerpt":"Dependency Usage Examples The following examples demonstrate common patterns for integrating external proto dependencies into your code generation workflow.","content":"Dependency Usage Examples The following examples demonstrate common patterns for integrating external proto dependencies into your code generation workflow."},{"id":"cli/generator/generator::using-google-apis::132","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs Google APIs are among the most commonly used proto dependencies, providing standard types and annotations for REST APIs, field validation, and common data structures.","content":"Using Google APIs Google APIs are among the most commonly used proto dependencies, providing standard types and annotations for REST APIs, field validation, and common data structures."},{"id":"cli/generator/generator::using-google-apis::133","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs **When to use Google APIs:** Building REST APIs with gRPC-Gateway Need standard types like Timestamp, Duration, Any Want to use Google's field behavior annotations Building services that integrate with ","content":"Using Google APIs **When to use Google APIs:** Building REST APIs with gRPC-Gateway Need standard types like Timestamp, Duration, Any Want to use Google's field behavior annotations Building services that integrate with Google Cloud"},{"id":"cli/generator/generator::using-google-apis::134","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs This configuration shows the minimal setup needed to use Google APIs in your proto files:","content":"Using Google APIs This configuration shows the minimal setup needed to use Google APIs in your proto files:"},{"id":"cli/generator/generator::using-google-apis::135","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs ```yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1","content":"Using Google APIs ```yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1"},{"id":"cli/generator/generator::using-google-apis::136","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs generate: inputs: - directory: \"api/proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true ```","content":"Using Google APIs generate: inputs: - directory: \"api/proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true ```"},{"id":"cli/generator/generator::using-google-apis::137","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs **Important:** Always use a pinned version (like common-protos-1_3_1) rather than latest to ensure build reproducibility.","content":"Using Google APIs **Important:** Always use a pinned version (like common-protos-1_3_1) rather than latest to ensure build reproducibility."},{"id":"cli/generator/generator::using-google-apis::138","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs Once configured, your proto files can import and use Google API definitions. Here's an example of a service using HTTP annotations:","content":"Using Google APIs Once configured, your proto files can import and use Google API definitions. Here's an example of a service using HTTP annotations:"},{"id":"cli/generator/generator::using-google-apis::139","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs ```proto // api/proto/service.proto syntax = \"proto3\";","content":"Using Google APIs ```proto // api/proto/service.proto syntax = \"proto3\";"},{"id":"cli/generator/generator::using-google-apis::140","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs import \"google/api/annotations.proto\"; import \"google/protobuf/timestamp.proto\";","content":"Using Google APIs import \"google/api/annotations.proto\"; import \"google/protobuf/timestamp.proto\";"},{"id":"cli/generator/generator::using-google-apis::141","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs service MyService { rpc GetData(GetDataRequest) returns (GetDataResponse) { option (google.api.http) = { get: \"/v1/data\" }; } } ```","content":"Using Google APIs service MyService { rpc GetData(GetDataRequest) returns (GetDataResponse) { option (google.api.http) = { get: \"/v1/data\" }; } } ```"},{"id":"cli/generator/generator::using-validation-rules::142","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules Protoc-gen-validate provides powerful field validation capabilities that can be embedded directly in your proto definitions, eliminating the need for separate validation logic in your application c","content":"Using Validation Rules Protoc-gen-validate provides powerful field validation capabilities that can be embedded directly in your proto definitions, eliminating the need for separate validation logic in your application code."},{"id":"cli/generator/generator::using-validation-rules::143","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules **When to use validation:** Input validation for API endpoints Database model constraints Configuration file validation Any scenario where data integrity is critical","content":"Using Validation Rules **When to use validation:** Input validation for API endpoints Database model constraints Configuration file validation Any scenario where data integrity is critical"},{"id":"cli/generator/generator::using-validation-rules::144","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules **Benefits:** Validation rules are part of the proto definition (single source of truth) Code generation creates validation functions automatically Consistent validation across different languages ","content":"Using Validation Rules **Benefits:** Validation rules are part of the proto definition (single source of truth) Code generation creates validation functions automatically Consistent validation across different languages Better performance than runtime reflection-based validation"},{"id":"cli/generator/generator::using-validation-rules::145","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules ```yaml deps: - github.com/bufbuild/protoc-gen-validate@v0.10.1","content":"Using Validation Rules ```yaml deps: - github.com/bufbuild/protoc-gen-validate@v0.10.1"},{"id":"cli/generator/generator::using-validation-rules::146","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules generate: inputs: - directory: \"proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true - name: validate-go out: ./gen/go opts: paths: source_relative ```","content":"Using Validation Rules generate: inputs: - directory: \"proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true - name: validate-go out: ./gen/go opts: paths: source_relative ```"},{"id":"cli/generator/generator::using-validation-rules::147","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules **Note:** You need both the dependency (for proto imports) and the plugin (for code generation) to get full validation support.","content":"Using Validation Rules **Note:** You need both the dependency (for proto imports) and the plugin (for code generation) to get full validation support."},{"id":"cli/generator/generator::using-validation-rules::148","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules Here's how validation rules look in your proto files. The generated code will automatically validate these constraints:","content":"Using Validation Rules Here's how validation rules look in your proto files. The generated code will automatically validate these constraints:"},{"id":"cli/generator/generator::using-validation-rules::149","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules ```proto // proto/user.proto syntax = \"proto3\";","content":"Using Validation Rules ```proto // proto/user.proto syntax = \"proto3\";"},{"id":"cli/generator/generator::using-validation-rules::150","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules import \"validate/validate.proto\";","content":"Using Validation Rules import \"validate/validate.proto\";"},{"id":"cli/generator/generator::using-validation-rules::151","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules message User { string email = 1 [(validate.rules).string.email = true]; int32 age = 2 [(validate.rules).int32.gte = 0]; } ```","content":"Using Validation Rules message User { string email = 1 [(validate.rules).string.email = true]; int32 age = 2 [(validate.rules).int32.gte = 0]; } ```"},{"id":"cli/generator/generator::complex-multi-dependency-setup::152","title":"Generator","section":"Complex Multi-Dependency Setup","path":"/docs/guide/cli/generator/generator#complex-multi-dependency-setup","headings":["Complex Multi-Dependency Setup"],"excerpt":"Complex Multi-Dependency Setup This example demonstrates a production-ready configuration that combines multiple dependencies and plugins for a complete API development workflow:","content":"Complex Multi-Dependency Setup This example demonstrates a production-ready configuration that combines multiple dependencies and plugins for a complete API development workflow:"},{"id":"cli/generator/generator::complex-multi-dependency-setup::153","title":"Generator","section":"Complex Multi-Dependency Setup","path":"/docs/guide/cli/generator/generator#complex-multi-dependency-setup","headings":["Complex Multi-Dependency Setup"],"excerpt":"Complex Multi-Dependency Setup ```yaml deps: # Core Google APIs - Standard types and HTTP annotations - github.com/googleapis/googleapis@common-protos-1_3_1 # gRPC Gateway for REST APIs - Enables HTTP/JSON interfaces - g","content":"Complex Multi-Dependency Setup ```yaml deps: # Core Google APIs - Standard types and HTTP annotations - github.com/googleapis/googleapis@common-protos-1_3_1 # gRPC Gateway for REST APIs - Enables HTTP/JSON interfaces - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 # Validation rules - Field-level validation constraints - github.com/bufbuild/protoc-gen-validate@v0.10.1 # Company internal shared types - Common business objects - github.com/mycompany/shared-protos@v1.5.0"},{"id":"cli/generator/generator::complex-multi-dependency-setup::154","title":"Generator","section":"Complex Multi-Dependency Setup","path":"/docs/guide/cli/generator/generator#complex-multi-dependency-setup","headings":["Complex Multi-Dependency Setup"],"excerpt":"Complex Multi-Dependency Setup generate: inputs: - directory: \"api/proto\" plugins: # Go code generation - Core protobuf structures - name: go out: ./gen/go opts: paths: source_relative module: github.com/mycompany/myserv","content":"Complex Multi-Dependency Setup generate: inputs: - directory: \"api/proto\" plugins: # Go code generation - Core protobuf structures - name: go out: ./gen/go opts: paths: source_relative module: github.com/mycompany/myservice with_imports: true # gRPC service stubs - Server and client interfaces - name: go-grpc out: ./gen/go opts: paths: source_relative require_unimplemented_servers: false # REST Gateway - HTTP-to-gRPC proxy code - name: grpc-gateway out: ./gen/go opts: paths: source_relative # OpenAPI documentation - API specification - name: openapiv2 out: ./gen/openapi opts: simple_operation_ids: true # Validation code - Input validation functions - name: validate-go out: ./gen/go opts: paths: source_relative ```"},{"id":"cli/generator/generator::dependency-cache-integration::155","title":"Generator","section":"Dependency Cache Integration","path":"/docs/guide/cli/generator/generator#dependency-cache-integration","headings":["Dependency Cache Integration"],"excerpt":"Dependency Cache Integration The generator leverages EasyP's module cache for fast builds:","content":"Dependency Cache Integration The generator leverages EasyP's module cache for fast builds:"},{"id":"cli/generator/generator::dependency-cache-integration::156","title":"Generator","section":"Dependency Cache Integration","path":"/docs/guide/cli/generator/generator#dependency-cache-integration","headings":["Dependency Cache Integration"],"excerpt":"Dependency Cache Integration ```bash Download dependencies once easyp mod download","content":"Dependency Cache Integration ```bash Download dependencies once easyp mod download"},{"id":"cli/generator/generator::dependency-cache-integration::157","title":"Generator","section":"Dependency Cache Integration","path":"/docs/guide/cli/generator/generator#dependency-cache-integration","headings":["Dependency Cache Integration"],"excerpt":"Dependency Cache Integration Generate code (uses cached dependencies) easyp generate","content":"Dependency Cache Integration Generate code (uses cached dependencies) easyp generate"},{"id":"cli/generator/generator::dependency-cache-integration::158","title":"Generator","section":"Dependency Cache Integration","path":"/docs/guide/cli/generator/generator#dependency-cache-integration","headings":["Dependency Cache Integration"],"excerpt":"Dependency Cache Integration Dependencies are cached in ~/.easyp/mod/ ls ~/.easyp/mod/github.com/googleapis/googleapis/ ```","content":"Dependency Cache Integration Dependencies are cached in ~/.easyp/mod/ ls ~/.easyp/mod/github.com/googleapis/googleapis/ ```"},{"id":"cli/generator/generator::remote-generation::159","title":"Generator","section":"Remote Generation","path":"/docs/guide/cli/generator/generator#remote-generation","headings":["Remote Generation"],"excerpt":"Remote Generation Remote generation is a powerful feature that allows you to generate code from proto files hosted in remote Git repositories without requiring a local checkout. This enables true microservices architectu","content":"Remote Generation Remote generation is a powerful feature that allows you to generate code from proto files hosted in remote Git repositories without requiring a local checkout. This enables true microservices architecture where teams can consume each other's APIs without tight coupling."},{"id":"cli/generator/generator::remote-generation::160","title":"Generator","section":"Remote Generation","path":"/docs/guide/cli/generator/generator#remote-generation","headings":["Remote Generation"],"excerpt":"Remote Generation **Key advantages:** **Decoupled development**: Teams can work independently while consuming each other's APIs **Version control**: Pin to specific versions of external APIs for stability **Reduced repos","content":"Remote Generation **Key advantages:** **Decoupled development**: Teams can work independently while consuming each other's APIs **Version control**: Pin to specific versions of external APIs for stability **Reduced repository size**: No need to vendor or submodule external proto files **Automatic updates**: Easy to update to newer versions when ready"},{"id":"cli/generator/generator::remote-generation::161","title":"Generator","section":"Remote Generation","path":"/docs/guide/cli/generator/generator#remote-generation","headings":["Remote Generation"],"excerpt":"Remote Generation **Best practices:** Always use tagged versions in production environments Test with latest versions in development, but pin in production Use semantic versioning when available for easier dependency man","content":"Remote Generation **Best practices:** Always use tagged versions in production environments Test with latest versions in development, but pin in production Use semantic versioning when available for easier dependency management Consider the network implications for CI/CD systems"},{"id":"cli/generator/generator::remote-proto-sources::162","title":"Generator","section":"Remote Proto Sources","path":"/docs/guide/cli/generator/generator#remote-proto-sources","headings":["Remote Proto Sources"],"excerpt":"Remote Proto Sources Generate from remote repositories directly. This is particularly useful in microservices architectures where different teams own different proto definitions.","content":"Remote Proto Sources Generate from remote repositories directly. This is particularly useful in microservices architectures where different teams own different proto definitions."},{"id":"cli/generator/generator::remote-proto-sources::163","title":"Generator","section":"Remote Proto Sources","path":"/docs/guide/cli/generator/generator#remote-proto-sources","headings":["Remote Proto Sources"],"excerpt":"Remote Proto Sources **Typical workflow:** Team A publishes proto definitions in a Git repository with proper versioning Team B references these protos in their easyp.yaml configuration During generation, EasyP automatic","content":"Remote Proto Sources **Typical workflow:** Team A publishes proto definitions in a Git repository with proper versioning Team B references these protos in their easyp.yaml configuration During generation, EasyP automatically fetches and uses the remote protos Generated code includes client libraries for Team A's services"},{"id":"cli/generator/generator::remote-proto-sources::164","title":"Generator","section":"Remote Proto Sources","path":"/docs/guide/cli/generator/generator#remote-proto-sources","headings":["Remote Proto Sources"],"excerpt":"Remote Proto Sources Here's a practical example showing how to combine local and remote proto sources in a single generation configuration:","content":"Remote Proto Sources Here's a practical example showing how to combine local and remote proto sources in a single generation configuration:"},{"id":"cli/generator/generator::remote-generation-use-cases::165","title":"Generator","section":"Remote Generation Use Cases","path":"/docs/guide/cli/generator/generator#remote-generation-use-cases","headings":["Remote Generation Use Cases"],"excerpt":"Remote Generation Use Cases These examples demonstrate real-world scenarios where remote generation provides significant value in distributed development environments.","content":"Remote Generation Use Cases These examples demonstrate real-world scenarios where remote generation provides significant value in distributed development environments."},{"id":"cli/generator/generator::multi-team-development::166","title":"Generator","section":"Multi-Team Development","path":"/docs/guide/cli/generator/generator#multi-team-development","headings":["Multi-Team Development"],"excerpt":"Multi-Team Development Multi-team development is where remote generation truly shines. Instead of coordinating shared repositories or complex dependency management, teams can independently evolve their APIs while consume","content":"Multi-Team Development Multi-team development is where remote generation truly shines. Instead of coordinating shared repositories or complex dependency management, teams can independently evolve their APIs while consumers automatically get updates through versioned dependencies."},{"id":"cli/generator/generator::multi-team-development::167","title":"Generator","section":"Multi-Team Development","path":"/docs/guide/cli/generator/generator#multi-team-development","headings":["Multi-Team Development"],"excerpt":"Multi-Team Development This pattern is especially valuable in large organizations where: Teams have different release cycles and development velocities API ownership is clearly defined but consumption is widespread You w","content":"Multi-Team Development This pattern is especially valuable in large organizations where: Teams have different release cycles and development velocities API ownership is clearly defined but consumption is widespread You want to avoid the overhead of coordinating shared proto repositories Different teams use different technology stacks but need to communicate"},{"id":"cli/generator/generator::vendor-api-integration::168","title":"Generator","section":"Vendor API Integration","path":"/docs/guide/cli/generator/generator#vendor-api-integration","headings":["Vendor API Integration"],"excerpt":"Vendor API Integration Many vendors now provide proto definitions for their APIs, enabling strongly-typed client generation instead of relying on hand-written HTTP clients. This approach provides better type safety, auto","content":"Vendor API Integration Many vendors now provide proto definitions for their APIs, enabling strongly-typed client generation instead of relying on hand-written HTTP clients. This approach provides better type safety, automatic serialization, and often better performance."},{"id":"cli/generator/generator::vendor-api-integration::169","title":"Generator","section":"Vendor API Integration","path":"/docs/guide/cli/generator/generator#vendor-api-integration","headings":["Vendor API Integration"],"excerpt":"Vendor API Integration Benefits of using vendor proto definitions: **Type safety**: Compile-time checking of API calls and data structures **Automatic updates**: New API features become available through version updates ","content":"Vendor API Integration Benefits of using vendor proto definitions: **Type safety**: Compile-time checking of API calls and data structures **Automatic updates**: New API features become available through version updates **Consistency**: Same interface patterns across different vendor integrations **Performance**: Binary serialization is often faster than JSON **Documentation**: Proto files serve as authoritative API documentation"},{"id":"cli/generator/generator::commands::170","title":"Generator","section":"Commands","path":"/docs/guide/cli/generator/generator#commands","headings":["Commands"],"excerpt":"Commands The EasyP command-line interface provides flexible options for running code generation with different configurations and environments.","content":"Commands The EasyP command-line interface provides flexible options for running code generation with different configurations and environments."},{"id":"cli/generator/generator::basic-generation::171","title":"Generator","section":"Basic Generation","path":"/docs/guide/cli/generator/generator#basic-generation","headings":["Basic Generation"],"excerpt":"Basic Generation These are the most commonly used command patterns for everyday development and production use:","content":"Basic Generation These are the most commonly used command patterns for everyday development and production use:"},{"id":"cli/generator/generator::basic-generation::172","title":"Generator","section":"Basic Generation","path":"/docs/guide/cli/generator/generator#basic-generation","headings":["Basic Generation"],"excerpt":"Basic Generation ```bash Use default easyp.yaml configuration - Most common for development easyp generate","content":"Basic Generation ```bash Use default easyp.yaml configuration - Most common for development easyp generate"},{"id":"cli/generator/generator::basic-generation::173","title":"Generator","section":"Basic Generation","path":"/docs/guide/cli/generator/generator#basic-generation","headings":["Basic Generation"],"excerpt":"Basic Generation Use custom configuration file - Essential for multi-environment setups easyp --cfg production.easyp.yaml generate","content":"Basic Generation Use custom configuration file - Essential for multi-environment setups easyp --cfg production.easyp.yaml generate"},{"id":"cli/generator/generator::basic-generation::174","title":"Generator","section":"Basic Generation","path":"/docs/guide/cli/generator/generator#basic-generation","headings":["Basic Generation"],"excerpt":"Basic Generation Generate with debug logs - Helpful for debugging and CI/CD easyp --debug generate","content":"Basic Generation Generate with debug logs - Helpful for debugging and CI/CD easyp --debug generate"},{"id":"cli/generator/generator::basic-generation::175","title":"Generator","section":"Basic Generation","path":"/docs/guide/cli/generator/generator#basic-generation","headings":["Basic Generation"],"excerpt":"Basic Generation Generate with custom cache location - Useful for CI systems or shared environments EASYPPATH=/tmp/easyp-cache easyp generate ```","content":"Basic Generation Generate with custom cache location - Useful for CI systems or shared environments EASYPPATH=/tmp/easyp-cache easyp generate ```"},{"id":"cli/generator/generator::integration-with-package-manager::176","title":"Generator","section":"Integration with Package Manager","path":"/docs/guide/cli/generator/generator#integration-with-package-manager","headings":["Integration with Package Manager"],"excerpt":"Integration with Package Manager EasyP's package manager integration means you can either explicitly manage dependencies or let the generator handle them automatically. The explicit approach gives you more control, while","content":"Integration with Package Manager EasyP's package manager integration means you can either explicitly manage dependencies or let the generator handle them automatically. The explicit approach gives you more control, while the automatic approach is more convenient:"},{"id":"cli/generator/generator::integration-with-package-manager::177","title":"Generator","section":"Integration with Package Manager","path":"/docs/guide/cli/generator/generator#integration-with-package-manager","headings":["Integration with Package Manager"],"excerpt":"Integration with Package Manager ```bash Explicit workflow - Better for CI/CD and when you want to cache dependencies easyp mod download # Download and cache dependencies first easyp generate # Generate code using cached","content":"Integration with Package Manager ```bash Explicit workflow - Better for CI/CD and when you want to cache dependencies easyp mod download # Download and cache dependencies first easyp generate # Generate code using cached dependencies"},{"id":"cli/generator/generator::integration-with-package-manager::178","title":"Generator","section":"Integration with Package Manager","path":"/docs/guide/cli/generator/generator#integration-with-package-manager","headings":["Integration with Package Manager"],"excerpt":"Integration with Package Manager Automatic workflow - Convenient for development (generate downloads dependencies automatically) easyp generate ```","content":"Integration with Package Manager Automatic workflow - Convenient for development (generate downloads dependencies automatically) easyp generate ```"},{"id":"cli/generator/generator::advanced-usage::179","title":"Generator","section":"Advanced Usage","path":"/docs/guide/cli/generator/generator#advanced-usage","headings":["Advanced Usage"],"excerpt":"Advanced Usage These advanced usage patterns are useful for specific deployment scenarios, debugging, or when you need fine-grained control over the generation process:","content":"Advanced Usage These advanced usage patterns are useful for specific deployment scenarios, debugging, or when you need fine-grained control over the generation process:"},{"id":"cli/generator/generator::advanced-usage::180","title":"Generator","section":"Advanced Usage","path":"/docs/guide/cli/generator/generator#advanced-usage","headings":["Advanced Usage"],"excerpt":"Advanced Usage ```bash Generate from specific input directory - Override config file settings easyp generate --path=./api/proto","content":"Advanced Usage ```bash Generate from specific input directory - Override config file settings easyp generate --path=./api/proto"},{"id":"cli/generator/generator::advanced-usage::181","title":"Generator","section":"Advanced Usage","path":"/docs/guide/cli/generator/generator#advanced-usage","headings":["Advanced Usage"],"excerpt":"Advanced Usage Generate using vendored dependencies - For offline builds or Docker containers easyp mod vendor easyp generate","content":"Advanced Usage Generate using vendored dependencies - For offline builds or Docker containers easyp mod vendor easyp generate"},{"id":"cli/generator/generator::advanced-usage::182","title":"Generator","section":"Advanced Usage","path":"/docs/guide/cli/generator/generator#advanced-usage","headings":["Advanced Usage"],"excerpt":"Advanced Usage Generate from a custom project root - Useful in monorepos or nested workdirs easyp generate --root=/usr/local/src/my-project --path=./api/proto ```","content":"Advanced Usage Generate from a custom project root - Useful in monorepos or nested workdirs easyp generate --root=/usr/local/src/my-project --path=./api/proto ```"},{"id":"cli/generator/generator::common-patterns::183","title":"Generator","section":"Common Patterns","path":"/docs/guide/cli/generator/generator#common-patterns","headings":["Common Patterns"],"excerpt":"Common Patterns These patterns represent real-world scenarios and best practices for organizing code generation in different project structures.","content":"Common Patterns These patterns represent real-world scenarios and best practices for organizing code generation in different project structures."},{"id":"cli/generator/generator::multi-language-generation::184","title":"Generator","section":"Multi-Language Generation","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Multi-Language Generation"],"excerpt":"Multi-Language Generation Multi-language generation is essential for organizations using different technologies across their stack. EasyP makes it easy to generate consistent client libraries and types for multiple progr","content":"Multi-Language Generation Multi-language generation is essential for organizations using different technologies across their stack. EasyP makes it easy to generate consistent client libraries and types for multiple programming languages from the same proto definitions."},{"id":"cli/generator/generator::multi-language-generation::185","title":"Generator","section":"Multi-Language Generation","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Multi-Language Generation"],"excerpt":"Multi-Language Generation **Common scenarios:** **Full-stack applications**: Go/Java backend with TypeScript frontend for web apps **Data platforms**: Go services with Python data science tools and analysis scripts **Mic","content":"Multi-Language Generation **Common scenarios:** **Full-stack applications**: Go/Java backend with TypeScript frontend for web apps **Data platforms**: Go services with Python data science tools and analysis scripts **Microservices**: Different services implemented in optimal languages for their domain **Client libraries**: Providing SDKs in multiple languages for external developers **Legacy integration**: Modern gRPC services with legacy systems using different languages"},{"id":"cli/generator/generator::multi-language-generation::186","title":"Generator","section":"Multi-Language Generation","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Multi-Language Generation"],"excerpt":"Multi-Language Generation **Performance considerations:** Each plugin runs independently, so generation time scales linearly with plugin count Consider using parallel execution (make -j4) for large numbers of plugins Out","content":"Multi-Language Generation **Performance considerations:** Each plugin runs independently, so generation time scales linearly with plugin count Consider using parallel execution (make -j4) for large numbers of plugins Output directories should be organized hierarchically to avoid file conflicts Some plugins are faster than others - profile your build to identify bottlenecks"},{"id":"cli/generator/generator::multi-language-generation::187","title":"Generator","section":"Multi-Language Generation","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Multi-Language Generation"],"excerpt":"Multi-Language Generation **Maintenance benefits:** Single source of truth for API definitions prevents schema drift Consistent types across all languages reduce integration bugs Automatic synchronization when proto defi","content":"Multi-Language Generation **Maintenance benefits:** Single source of truth for API definitions prevents schema drift Consistent types across all languages reduce integration bugs Automatic synchronization when proto definitions change eliminates manual updates Reduced chance of API drift between different language implementations Easier refactoring since changes propagate to all generated code"},{"id":"cli/generator/generator::multi-language-generation::188","title":"Generator","section":"Multi-Language Generation","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Multi-Language Generation"],"excerpt":"Multi-Language Generation This example shows a typical multi-language setup for a full-stack application with backend services, web frontend, data analysis, and documentation:","content":"Multi-Language Generation This example shows a typical multi-language setup for a full-stack application with backend services, web frontend, data analysis, and documentation:"},{"id":"cli/generator/generator::multi-language-generation::189","title":"Generator","section":"Multi-Language Generation","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Multi-Language Generation"],"excerpt":"Multi-Language Generation **Organization tip:** Use separate output directories for each language to avoid file conflicts and make it easier to integrate with language-specific build systems.","content":"Multi-Language Generation **Organization tip:** Use separate output directories for each language to avoid file conflicts and make it easier to integrate with language-specific build systems."},{"id":"cli/generator/generator::multi-language-generation::190","title":"Generator","section":"Multi-Language Generation","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Multi-Language Generation"],"excerpt":"Multi-Language Generation The EasyP generator provides a comprehensive solution for protocol buffer code generation, supporting everything from simple local development to complex enterprise multi-language workflows with","content":"Multi-Language Generation The EasyP generator provides a comprehensive solution for protocol buffer code generation, supporting everything from simple local development to complex enterprise multi-language workflows with remote dependencies."},{"id":"cli/linter/linter::why-use-a-linter-for-proto-files::0","title":"Linter","section":"Why Use a Linter for Proto Files?","path":"/docs/guide/cli/linter/linter#why-use-a-linter-for-proto-files","headings":["Why Use a Linter for Proto Files?"],"excerpt":"Why Use a Linter for Proto Files? Linters play a crucial role in modern software development, particularly for proto files. By enforcing style and formatting rules, linters help maintain code quality, reduce potential bu","content":"Why Use a Linter for Proto Files? Linters play a crucial role in modern software development, particularly for proto files. By enforcing style and formatting rules, linters help maintain code quality, reduce potential bugs, and ensure that the codebase is clean and readable. This leads to several benefits:"},{"id":"cli/linter/linter::why-use-a-linter-for-proto-files::1","title":"Linter","section":"Why Use a Linter for Proto Files?","path":"/docs/guide/cli/linter/linter#why-use-a-linter-for-proto-files","headings":["Why Use a Linter for Proto Files?"],"excerpt":"Why Use a Linter for Proto Files? **Reduced Development Costs:** Linters catch errors early in the development cycle, saving time and resources that would be spent on debugging and fixing issues later. **Improved Team Co","content":"Why Use a Linter for Proto Files? **Reduced Development Costs:** Linters catch errors early in the development cycle, saving time and resources that would be spent on debugging and fixing issues later. **Improved Team Collaboration:** A standardized codebase makes it easier for team members to understand and work with each other's code, facilitating a smoother collaborative environment. **Business Efficiency:** Teams using linters often produce higher quality code, which translates to fewer production issues and maintenance costs. This makes businesses that adopt linting practices more competitive and cost-effective."},{"id":"cli/linter/linter::configuration-reference::2","title":"Linter","section":"Configuration Reference","path":"/docs/guide/cli/linter/linter#configuration-reference","headings":["Configuration Reference"],"excerpt":"Configuration Reference EasyP linter provides flexible configuration options to adapt to different project requirements. All configuration is done through the lint section in your easyp.yaml file.","content":"Configuration Reference EasyP linter provides flexible configuration options to adapt to different project requirements. All configuration is done through the lint section in your easyp.yaml file."},{"id":"cli/linter/linter::complete-configuration-example::3","title":"Linter","section":"Complete Configuration Example","path":"/docs/guide/cli/linter/linter#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example","content":"Complete Configuration Example"},{"id":"cli/linter/linter::use-string::4","title":"Linter","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) Specifies which linter rules or rule categories to apply. You can mix individual rules with predefined categories.","content":"use ([]string) Specifies which linter rules or rule categories to apply. You can mix individual rules with predefined categories."},{"id":"cli/linter/linter::use-string::5","title":"Linter","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) **Available categories:** **MINIMAL**: Basic package consistency checks **BASIC**: Naming conventions and usage patterns **DEFAULT**: Recommended rules for most projects **COMMENTS**: Comment presence and ","content":"use ([]string) **Available categories:** **MINIMAL**: Basic package consistency checks **BASIC**: Naming conventions and usage patterns **DEFAULT**: Recommended rules for most projects **COMMENTS**: Comment presence and formatting **UNARY_RPC**: Restrictions on streaming RPCs"},{"id":"cli/linter/linter::use-string::6","title":"Linter","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) **Individual rules**: Any specific rule name (e.g., ENUM_PASCAL_CASE, FIELD_LOWER_SNAKE_CASE)","content":"use ([]string) **Individual rules**: Any specific rule name (e.g., ENUM_PASCAL_CASE, FIELD_LOWER_SNAKE_CASE)"},{"id":"cli/linter/linter::use-string::7","title":"Linter","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) **Examples:** ```yaml Use predefined categories use: [MINIMAL, BASIC, DEFAULT]","content":"use ([]string) **Examples:** ```yaml Use predefined categories use: [MINIMAL, BASIC, DEFAULT]"},{"id":"cli/linter/linter::use-string::8","title":"Linter","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) Mix categories with individual rules use: - MINIMAL - COMMENT_SERVICE - COMMENT_RPC - ENUM_PASCAL_CASE","content":"use ([]string) Mix categories with individual rules use: - MINIMAL - COMMENT_SERVICE - COMMENT_RPC - ENUM_PASCAL_CASE"},{"id":"cli/linter/linter::use-string::9","title":"Linter","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) Use only specific rules use: - PACKAGE_DEFINED - SERVICE_PASCAL_CASE - FIELD_LOWER_SNAKE_CASE ```","content":"use ([]string) Use only specific rules use: - PACKAGE_DEFINED - SERVICE_PASCAL_CASE - FIELD_LOWER_SNAKE_CASE ```"},{"id":"cli/linter/linter::enum_zero_value_suffix-string::10","title":"Linter","section":"enum_zero_value_suffix (string)","path":"/docs/guide/cli/linter/linter#enum_zero_value_suffix-string","headings":["enum_zero_value_suffix (string)"],"excerpt":"enum_zero_value_suffix (string) Defines the required suffix for zero-value enum entries. This enforces a consistent naming pattern for the default enum value.","content":"enum_zero_value_suffix (string) Defines the required suffix for zero-value enum entries. This enforces a consistent naming pattern for the default enum value."},{"id":"cli/linter/linter::enum_zero_value_suffix-string::11","title":"Linter","section":"enum_zero_value_suffix (string)","path":"/docs/guide/cli/linter/linter#enum_zero_value_suffix-string","headings":["enum_zero_value_suffix (string)"],"excerpt":"enum_zero_value_suffix (string) **Default**: Empty (no suffix required) **Common values**: \"UNSPECIFIED\", \"UNKNOWN\", \"DEFAULT\"","content":"enum_zero_value_suffix (string) **Default**: Empty (no suffix required) **Common values**: \"UNSPECIFIED\", \"UNKNOWN\", \"DEFAULT\""},{"id":"cli/linter/linter::enum_zero_value_suffix-string::12","title":"Linter","section":"enum_zero_value_suffix (string)","path":"/docs/guide/cli/linter/linter#enum_zero_value_suffix-string","headings":["enum_zero_value_suffix (string)"],"excerpt":"enum_zero_value_suffix (string) **Example:**","content":"enum_zero_value_suffix (string) **Example:**"},{"id":"cli/linter/linter::enum_zero_value_suffix-string::13","title":"Linter","section":"enum_zero_value_suffix (string)","path":"/docs/guide/cli/linter/linter#enum_zero_value_suffix-string","headings":["enum_zero_value_suffix (string)"],"excerpt":"enum_zero_value_suffix (string) With this setting, enum definitions must follow this pattern:","content":"enum_zero_value_suffix (string) With this setting, enum definitions must follow this pattern:"},{"id":"cli/linter/linter::service_suffix-string::14","title":"Linter","section":"service_suffix (string)","path":"/docs/guide/cli/linter/linter#service_suffix-string","headings":["service_suffix (string)"],"excerpt":"service_suffix (string) Specifies the required suffix for service names. This ensures consistent service naming across your project.","content":"service_suffix (string) Specifies the required suffix for service names. This ensures consistent service naming across your project."},{"id":"cli/linter/linter::service_suffix-string::15","title":"Linter","section":"service_suffix (string)","path":"/docs/guide/cli/linter/linter#service_suffix-string","headings":["service_suffix (string)"],"excerpt":"service_suffix (string) **Default**: Empty (no suffix required) **Common values**: \"Service\", \"API\", \"Svc\"","content":"service_suffix (string) **Default**: Empty (no suffix required) **Common values**: \"Service\", \"API\", \"Svc\""},{"id":"cli/linter/linter::service_suffix-string::16","title":"Linter","section":"service_suffix (string)","path":"/docs/guide/cli/linter/linter#service_suffix-string","headings":["service_suffix (string)"],"excerpt":"service_suffix (string) **Example:**","content":"service_suffix (string) **Example:**"},{"id":"cli/linter/linter::service_suffix-string::17","title":"Linter","section":"service_suffix (string)","path":"/docs/guide/cli/linter/linter#service_suffix-string","headings":["service_suffix (string)"],"excerpt":"service_suffix (string) With this setting, service definitions must follow this pattern:","content":"service_suffix (string) With this setting, service definitions must follow this pattern:"},{"id":"cli/linter/linter::ignore-string::18","title":"Linter","section":"ignore ([]string)","path":"/docs/guide/cli/linter/linter#ignore-string","headings":["ignore ([]string)"],"excerpt":"ignore ([]string) Lists directories or file paths to completely exclude from linting. Supports glob patterns and relative paths from the project root.","content":"ignore ([]string) Lists directories or file paths to completely exclude from linting. Supports glob patterns and relative paths from the project root."},{"id":"cli/linter/linter::ignore-string::19","title":"Linter","section":"ignore ([]string)","path":"/docs/guide/cli/linter/linter#ignore-string","headings":["ignore ([]string)"],"excerpt":"ignore ([]string) **Use cases:** Third-party or vendor proto files Generated proto files Legacy code being phased out Test fixtures that intentionally violate rules","content":"ignore ([]string) **Use cases:** Third-party or vendor proto files Generated proto files Legacy code being phased out Test fixtures that intentionally violate rules"},{"id":"cli/linter/linter::ignore-string::20","title":"Linter","section":"ignore ([]string)","path":"/docs/guide/cli/linter/linter#ignore-string","headings":["ignore ([]string)"],"excerpt":"ignore ([]string) **Examples:**","content":"ignore ([]string) **Examples:**"},{"id":"cli/linter/linter::except-string::21","title":"Linter","section":"except ([]string)","path":"/docs/guide/cli/linter/linter#except-string","headings":["except ([]string)"],"excerpt":"except ([]string) Disables specific rules globally across the entire project. Use this when certain rules don't fit your project's conventions.","content":"except ([]string) Disables specific rules globally across the entire project. Use this when certain rules don't fit your project's conventions."},{"id":"cli/linter/linter::except-string::22","title":"Linter","section":"except ([]string)","path":"/docs/guide/cli/linter/linter#except-string","headings":["except ([]string)"],"excerpt":"except ([]string) **When to use:** Legacy projects with established naming conventions Projects with specific style requirements Gradual adoption of linting rules","content":"except ([]string) **When to use:** Legacy projects with established naming conventions Projects with specific style requirements Gradual adoption of linting rules"},{"id":"cli/linter/linter::except-string::23","title":"Linter","section":"except ([]string)","path":"/docs/guide/cli/linter/linter#except-string","headings":["except ([]string)"],"excerpt":"except ([]string) **Examples:**","content":"except ([]string) **Examples:**"},{"id":"cli/linter/linter::allow_comment_ignores-bool::24","title":"Linter","section":"allow_comment_ignores (bool)","path":"/docs/guide/cli/linter/linter#allow_comment_ignores-bool","headings":["allow_comment_ignores (bool)"],"excerpt":"allow_comment_ignores (bool) Enables or disables the ability to ignore specific rules using inline comments in proto files.","content":"allow_comment_ignores (bool) Enables or disables the ability to ignore specific rules using inline comments in proto files."},{"id":"cli/linter/linter::allow_comment_ignores-bool::25","title":"Linter","section":"allow_comment_ignores (bool)","path":"/docs/guide/cli/linter/linter#allow_comment_ignores-bool","headings":["allow_comment_ignores (bool)"],"excerpt":"allow_comment_ignores (bool) **Default**: false **Recommended**: true for flexibility during development","content":"allow_comment_ignores (bool) **Default**: false **Recommended**: true for flexibility during development"},{"id":"cli/linter/linter::allow_comment_ignores-bool::26","title":"Linter","section":"allow_comment_ignores (bool)","path":"/docs/guide/cli/linter/linter#allow_comment_ignores-bool","headings":["allow_comment_ignores (bool)"],"excerpt":"allow_comment_ignores (bool) **Example:**","content":"allow_comment_ignores (bool) **Example:**"},{"id":"cli/linter/linter::allow_comment_ignores-bool::27","title":"Linter","section":"allow_comment_ignores (bool)","path":"/docs/guide/cli/linter/linter#allow_comment_ignores-bool","headings":["allow_comment_ignores (bool)"],"excerpt":"allow_comment_ignores (bool) When enabled, you can use comments to ignore rules on specific elements:","content":"allow_comment_ignores (bool) When enabled, you can use comments to ignore rules on specific elements:"},{"id":"cli/linter/linter::ignore_only-mapstringstring::28","title":"Linter","section":"ignore_only (map[string][]string)","path":"/docs/guide/cli/linter/linter#ignore_only-mapstringstring","headings":["ignore_only (map[string][]string)"],"excerpt":"ignore_only (mapstringstring) Allows you to disable specific rules only for certain files or directories, while keeping them active elsewhere.","content":"ignore_only (mapstringstring) Allows you to disable specific rules only for certain files or directories, while keeping them active elsewhere."},{"id":"cli/linter/linter::ignore_only-mapstringstring::29","title":"Linter","section":"ignore_only (map[string][]string)","path":"/docs/guide/cli/linter/linter#ignore_only-mapstringstring","headings":["ignore_only (map[string][]string)"],"excerpt":"ignore_only (mapstringstring) **Use cases:** Legacy code that can't be easily updated Third-party protos with different conventions Generated code that doesn't follow your style Gradual migration strategies","content":"ignore_only (mapstringstring) **Use cases:** Legacy code that can't be easily updated Third-party protos with different conventions Generated code that doesn't follow your style Gradual migration strategies"},{"id":"cli/linter/linter::ignore_only-mapstringstring::30","title":"Linter","section":"ignore_only (map[string][]string)","path":"/docs/guide/cli/linter/linter#ignore_only-mapstringstring","headings":["ignore_only (map[string][]string)"],"excerpt":"ignore_only (mapstringstring) **Format**: rule_name: [list_of_paths]","content":"ignore_only (mapstringstring) **Format**: rule_name: [list_of_paths]"},{"id":"cli/linter/linter::ignore_only-mapstringstring::31","title":"Linter","section":"ignore_only (map[string][]string)","path":"/docs/guide/cli/linter/linter#ignore_only-mapstringstring","headings":["ignore_only (map[string][]string)"],"excerpt":"ignore_only (mapstringstring) **Examples:**","content":"ignore_only (mapstringstring) **Examples:**"},{"id":"cli/linter/linter::comment-based-rule-ignoring::32","title":"Linter","section":"Comment-Based Rule Ignoring","path":"/docs/guide/cli/linter/linter#comment-based-rule-ignoring","headings":["Comment-Based Rule Ignoring"],"excerpt":"Comment-Based Rule Ignoring When allow_comment_ignores is enabled, you can use inline comments to ignore specific linter rules for individual proto elements. This provides fine-grained control over rule enforcement.","content":"Comment-Based Rule Ignoring When allow_comment_ignores is enabled, you can use inline comments to ignore specific linter rules for individual proto elements. This provides fine-grained control over rule enforcement."},{"id":"cli/linter/linter::supported-comment-formats::33","title":"Linter","section":"Supported Comment Formats","path":"/docs/guide/cli/linter/linter#supported-comment-formats","headings":["Supported Comment Formats"],"excerpt":"Supported Comment Formats EasyP supports two comment formats for maximum compatibility:","content":"Supported Comment Formats EasyP supports two comment formats for maximum compatibility:"},{"id":"cli/linter/linter::ignoring-message-and-field-rules::34","title":"Linter","section":"Ignoring Message and Field Rules","path":"/docs/guide/cli/linter/linter#ignoring-message-and-field-rules","headings":["Ignoring Message and Field Rules"],"excerpt":"Ignoring Message and Field Rules","content":"Ignoring Message and Field Rules"},{"id":"cli/linter/linter::best-practices-for-comment-ignores::35","title":"Linter","section":"Best Practices for Comment Ignores","path":"/docs/guide/cli/linter/linter#best-practices-for-comment-ignores","headings":["Best Practices for Comment Ignores"],"excerpt":"Best Practices for Comment Ignores","content":"Best Practices for Comment Ignores"},{"id":"cli/linter/linter::use-sparingly::36","title":"Linter","section":"Use Sparingly","path":"/docs/guide/cli/linter/linter#use-sparingly","headings":["Use Sparingly"],"excerpt":"Use Sparingly Comment ignores should be the exception, not the rule. Overuse indicates that your linting configuration may need adjustment.","content":"Use Sparingly Comment ignores should be the exception, not the rule. Overuse indicates that your linting configuration may need adjustment."},{"id":"cli/linter/linter::add-explanatory-comments::37","title":"Linter","section":"Add Explanatory Comments","path":"/docs/guide/cli/linter/linter#add-explanatory-comments","headings":["Add Explanatory Comments"],"excerpt":"Add Explanatory Comments Always explain why you're ignoring a rule to help future maintainers understand the decision.","content":"Add Explanatory Comments Always explain why you're ignoring a rule to help future maintainers understand the decision."},{"id":"cli/linter/linter::prefer-configuration-over-comments::38","title":"Linter","section":"Prefer Configuration Over Comments","path":"/docs/guide/cli/linter/linter#prefer-configuration-over-comments","headings":["Prefer Configuration Over Comments"],"excerpt":"Prefer Configuration Over Comments When multiple files need the same rule ignored, use ignore_only configuration instead of individual comments.","content":"Prefer Configuration Over Comments When multiple files need the same rule ignored, use ignore_only configuration instead of individual comments."},{"id":"cli/linter/linter::prefer-configuration-over-comments::39","title":"Linter","section":"Prefer Configuration Over Comments","path":"/docs/guide/cli/linter/linter#prefer-configuration-over-comments","headings":["Prefer Configuration Over Comments"],"excerpt":"Prefer Configuration Over Comments **Instead of:** ```proto // In file1.proto // buf:lint:ignore COMMENT_SERVICE service API1 { ... }","content":"Prefer Configuration Over Comments **Instead of:** ```proto // In file1.proto // buf:lint:ignore COMMENT_SERVICE service API1 { ... }"},{"id":"cli/linter/linter::prefer-configuration-over-comments::40","title":"Linter","section":"Prefer Configuration Over Comments","path":"/docs/guide/cli/linter/linter#prefer-configuration-over-comments","headings":["Prefer Configuration Over Comments"],"excerpt":"Prefer Configuration Over Comments // In file2.proto // buf:lint:ignore COMMENT_SERVICE service API2 { ... } ```","content":"Prefer Configuration Over Comments // In file2.proto // buf:lint:ignore COMMENT_SERVICE service API2 { ... } ```"},{"id":"cli/linter/linter::prefer-configuration-over-comments::41","title":"Linter","section":"Prefer Configuration Over Comments","path":"/docs/guide/cli/linter/linter#prefer-configuration-over-comments","headings":["Prefer Configuration Over Comments"],"excerpt":"Prefer Configuration Over Comments **Use:**","content":"Prefer Configuration Over Comments **Use:**"},{"id":"cli/linter/linter::linter-categories::42","title":"Linter","section":"Linter Categories","path":"/docs/guide/cli/linter/linter#linter-categories","headings":["Linter Categories"],"excerpt":"Linter Categories To accommodate different project needs and preferences, EasyP linter provides predefined rule categories. These categories group together various rules, allowing teams to quickly select the level of str","content":"Linter Categories To accommodate different project needs and preferences, EasyP linter provides predefined rule categories. These categories group together various rules, allowing teams to quickly select the level of strictness or areas they want to focus on during linting."},{"id":"cli/linter/linter::linter-categories::43","title":"Linter","section":"Linter Categories","path":"/docs/guide/cli/linter/linter#linter-categories","headings":["Linter Categories"],"excerpt":"Linter Categories **When to use each category:**","content":"Linter Categories **When to use each category:**"},{"id":"cli/linter/linter::linter-categories::44","title":"Linter","section":"Linter Categories","path":"/docs/guide/cli/linter/linter#linter-categories","headings":["Linter Categories"],"excerpt":"Linter Categories **MINIMAL:** Essential for any proto project - ensures basic consistency and prevents fundamental issues **BASIC:** Recommended for most projects - enforces common naming conventions and best practices ","content":"Linter Categories **MINIMAL:** Essential for any proto project - ensures basic consistency and prevents fundamental issues **BASIC:** Recommended for most projects - enforces common naming conventions and best practices **DEFAULT:** Additional quality checks - useful for mature projects with established workflows **COMMENTS:** Documentation requirements - important for public APIs and team collaboration **UNARY_RPC:** Streaming restrictions - use when your architecture requires only unary RPCs"},{"id":"cli/linter/linter::linter-categories::45","title":"Linter","section":"Linter Categories","path":"/docs/guide/cli/linter/linter#linter-categories","headings":["Linter Categories"],"excerpt":"Linter Categories The available categories are: **MINIMAL:** Basic checks to ensure package consistency. **BASIC:** Additional checks for naming conventions and usage patterns. **DEFAULT:** A set of default rules that mo","content":"Linter Categories The available categories are: **MINIMAL:** Basic checks to ensure package consistency. **BASIC:** Additional checks for naming conventions and usage patterns. **DEFAULT:** A set of default rules that most projects should use. **COMMENTS:** Ensures that comments are present and properly formatted. **UNARY_RPC:** Specific rules for unary RPC services."},{"id":"cli/linter/linter::rule-groupings::46","title":"Linter","section":"Rule Groupings","path":"/docs/guide/cli/linter/linter#rule-groupings","headings":["Rule Groupings"],"excerpt":"Rule Groupings Below are the rule groupings under each category:","content":"Rule Groupings Below are the rule groupings under each category:"},{"id":"cli/linter/linter::minimal::47","title":"Linter","section":"MINIMAL","path":"/docs/guide/cli/linter/linter#minimal","headings":["MINIMAL"],"excerpt":"MINIMAL DIRECTORY_SAME_PACKAGE PACKAGE_DEFINED PACKAGE_DIRECTORY_MATCH PACKAGE_SAME_DIRECTORY","content":"MINIMAL DIRECTORY_SAME_PACKAGE PACKAGE_DEFINED PACKAGE_DIRECTORY_MATCH PACKAGE_SAME_DIRECTORY"},{"id":"cli/linter/linter::basic::48","title":"Linter","section":"BASIC","path":"/docs/guide/cli/linter/linter#basic","headings":["BASIC"],"excerpt":"BASIC ENUM_FIRST_VALUE_ZERO ENUM_NO_ALLOW_ALIAS ENUM_PASCAL_CASE ENUM_VALUE_UPPER_SNAKE_CASE FIELD_LOWER_SNAKE_CASE IMPORT_NO_PUBLIC IMPORT_NO_WEAK IMPORT_USED MESSAGE_PASCAL_CASE ONEOF_LOWER_SNAKE_CASE PACKAGE_LOWER_SNA","content":"BASIC ENUM_FIRST_VALUE_ZERO ENUM_NO_ALLOW_ALIAS ENUM_PASCAL_CASE ENUM_VALUE_UPPER_SNAKE_CASE FIELD_LOWER_SNAKE_CASE IMPORT_NO_PUBLIC IMPORT_NO_WEAK IMPORT_USED MESSAGE_PASCAL_CASE ONEOF_LOWER_SNAKE_CASE PACKAGE_LOWER_SNAKE_CASE PACKAGE_SAME_CSHARP_NAMESPACE PACKAGE_SAME_GO_PACKAGE PACKAGE_SAME_JAVA_MULTIPLE_FILES PACKAGE_SAME_JAVA_PACKAGE PACKAGE_SAME_PHP_NAMESPACE PACKAGE_SAME_RUBY_PACKAGE PACKAGE_SAME_SWIFT_PREFIX RPC_PASCAL_CASE SERVICE_PASCAL_CASE"},{"id":"cli/linter/linter::default::49","title":"Linter","section":"DEFAULT","path":"/docs/guide/cli/linter/linter#default","headings":["DEFAULT"],"excerpt":"DEFAULT ENUM_VALUE_PREFIX ENUM_ZERO_VALUE_SUFFIX FILE_LOWER_SNAKE_CASE RPC_REQUEST_RESPONSE_UNIQUE RPC_REQUEST_STANDARD_NAME RPC_RESPONSE_STANDARD_NAME PACKAGE_VERSION_SUFFIX SERVICE_SUFFIX","content":"DEFAULT ENUM_VALUE_PREFIX ENUM_ZERO_VALUE_SUFFIX FILE_LOWER_SNAKE_CASE RPC_REQUEST_RESPONSE_UNIQUE RPC_REQUEST_STANDARD_NAME RPC_RESPONSE_STANDARD_NAME PACKAGE_VERSION_SUFFIX SERVICE_SUFFIX"},{"id":"cli/linter/linter::comments::50","title":"Linter","section":"COMMENTS","path":"/docs/guide/cli/linter/linter#comments","headings":["COMMENTS"],"excerpt":"COMMENTS COMMENT_ENUM COMMENT_ENUM_VALUE COMMENT_FIELD COMMENT_MESSAGE COMMENT_ONEOF COMMENT_RPC COMMENT_SERVICE","content":"COMMENTS COMMENT_ENUM COMMENT_ENUM_VALUE COMMENT_FIELD COMMENT_MESSAGE COMMENT_ONEOF COMMENT_RPC COMMENT_SERVICE"},{"id":"cli/linter/linter::unary_rpc::51","title":"Linter","section":"UNARY_RPC","path":"/docs/guide/cli/linter/linter#unary_rpc","headings":["UNARY_RPC"],"excerpt":"UNARY_RPC RPC_NO_CLIENT_STREAMING RPC_NO_SERVER_STREAMING","content":"UNARY_RPC RPC_NO_CLIENT_STREAMING RPC_NO_SERVER_STREAMING"},{"id":"cli/linter/linter::conclusion::52","title":"Linter","section":"Conclusion","path":"/docs/guide/cli/linter/linter#conclusion","headings":["Conclusion"],"excerpt":"Conclusion Adopting the EasyP linter for your proto files can significantly enhance your development workflow, code quality, and overall project maintainability. With full compatibility with the Buf linter, teams can eas","content":"Conclusion Adopting the EasyP linter for your proto files can significantly enhance your development workflow, code quality, and overall project maintainability. With full compatibility with the Buf linter, teams can easily migrate and start benefiting from our tool's robust features and flexible configuration options."},{"id":"cli/linter/rules/comment-enum-value::top::0","title":"COMMENT_ENUM_VALUE","path":"/docs/guide/cli/linter/rules/comment-enum-value","headings":[],"excerpt":"This rule checks that enum values have a comment.","content":"This rule checks that enum values have a comment."},{"id":"cli/linter/rules/comment-enum-value::bad::1","title":"COMMENT_ENUM_VALUE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-enum-value#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-enum-value::bad::2","title":"COMMENT_ENUM_VALUE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-enum-value#bad","headings":["Bad"],"excerpt":"Bad enum Foo { BAR = 0; BAZ = 1; } ```","content":"Bad enum Foo { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/comment-enum-value::good::3","title":"COMMENT_ENUM_VALUE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-enum-value#good","headings":["Good"],"excerpt":"Good enum Foo { // BAR value for bar logic // [!code focus] BAR = 0; // BAZ value for baz logic // [!code focus] BAZ = 1; } ```","content":"Good enum Foo { // BAR value for bar logic // [!code focus] BAR = 0; // BAZ value for baz logic // [!code focus] BAZ = 1; } ```"},{"id":"cli/linter/rules/comment-enum::top::0","title":"COMMENT_ENUM","path":"/docs/guide/cli/linter/rules/comment-enum","headings":[],"excerpt":"This rule checks that enum has a comment.","content":"This rule checks that enum has a comment."},{"id":"cli/linter/rules/comment-enum::bad::1","title":"COMMENT_ENUM","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-enum#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-enum::bad::2","title":"COMMENT_ENUM","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-enum#bad","headings":["Bad"],"excerpt":"Bad enum Foo { BAR = 0; BAZ = 1; } ```","content":"Bad enum Foo { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/comment-enum::good::3","title":"COMMENT_ENUM","section":"Good","path":"/docs/guide/cli/linter/rules/comment-enum#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-enum::good::4","title":"COMMENT_ENUM","section":"Good","path":"/docs/guide/cli/linter/rules/comment-enum#good","headings":["Good"],"excerpt":"Good // Foo enum for bar and baz logic // [!code focus] enum Foo { BAR = 0; BAZ = 1; } ```","content":"Good // Foo enum for bar and baz logic // [!code focus] enum Foo { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/comment-field::top::0","title":"COMMENT_FIELD","path":"/docs/guide/cli/linter/rules/comment-field","headings":[],"excerpt":"This rule checks that all message fields have a comment.","content":"This rule checks that all message fields have a comment."},{"id":"cli/linter/rules/comment-field::bad::1","title":"COMMENT_FIELD","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-field#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-field::bad::2","title":"COMMENT_FIELD","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-field#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; string baz = 2; } ```","content":"Bad message Foo { string bar = 1; string baz = 2; } ```"},{"id":"cli/linter/rules/comment-field::good::3","title":"COMMENT_FIELD","section":"Good","path":"/docs/guide/cli/linter/rules/comment-field#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-field::good::4","title":"COMMENT_FIELD","section":"Good","path":"/docs/guide/cli/linter/rules/comment-field#good","headings":["Good"],"excerpt":"Good message Foo { // bar field for bar logic // [!code focus] string bar = 1; // baz field for baz logic // [!code focus] string baz = 2; } ```","content":"Good message Foo { // bar field for bar logic // [!code focus] string bar = 1; // baz field for baz logic // [!code focus] string baz = 2; } ```"},{"id":"cli/linter/rules/comment-message::top::0","title":"COMMENT_MESSAGE","path":"/docs/guide/cli/linter/rules/comment-message","headings":[],"excerpt":"This rule checks that message has a comment.","content":"This rule checks that message has a comment."},{"id":"cli/linter/rules/comment-message::bad::1","title":"COMMENT_MESSAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-message#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; string baz = 2; } ```","content":"Bad message Foo { string bar = 1; string baz = 2; } ```"},{"id":"cli/linter/rules/comment-message::good::2","title":"COMMENT_MESSAGE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-message#good","headings":["Good"],"excerpt":"Good // Foo message for bar and baz logic // [!code focus] message Foo { // bar field for bar logic string bar = 1; // baz field for baz logic string baz = 2; } ```","content":"Good // Foo message for bar and baz logic // [!code focus] message Foo { // bar field for bar logic string bar = 1; // baz field for baz logic string baz = 2; } ```"},{"id":"cli/linter/rules/comment-oneof::top::0","title":"COMMENT_ONEOF","path":"/docs/guide/cli/linter/rules/comment-oneof","headings":[],"excerpt":"This rule checks that oneof has a comment.","content":"This rule checks that oneof has a comment."},{"id":"cli/linter/rules/comment-oneof::bad::1","title":"COMMENT_ONEOF","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-oneof#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-oneof::bad::2","title":"COMMENT_ONEOF","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-oneof#bad","headings":["Bad"],"excerpt":"Bad message Foo { oneof bar { string baz = 1; string qux = 2; } } ```","content":"Bad message Foo { oneof bar { string baz = 1; string qux = 2; } } ```"},{"id":"cli/linter/rules/comment-oneof::good::3","title":"COMMENT_ONEOF","section":"Good","path":"/docs/guide/cli/linter/rules/comment-oneof#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-oneof::good::4","title":"COMMENT_ONEOF","section":"Good","path":"/docs/guide/cli/linter/rules/comment-oneof#good","headings":["Good"],"excerpt":"Good message Foo { // bar oneof for baz and qux logic // [!code focus] oneof bar { string baz = 1; string qux = 2; } } ```","content":"Good message Foo { // bar oneof for baz and qux logic // [!code focus] oneof bar { string baz = 1; string qux = 2; } } ```"},{"id":"cli/linter/rules/comment-rpc::top::0","title":"COMMENT_RPC","path":"/docs/guide/cli/linter/rules/comment-rpc","headings":[],"excerpt":"This rule checks that rpc has a comment.","content":"This rule checks that rpc has a comment."},{"id":"cli/linter/rules/comment-rpc::bad::1","title":"COMMENT_RPC","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-rpc#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-rpc::bad::2","title":"COMMENT_RPC","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-rpc#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar (BarRequest) returns (BarResponse) {} rpc Baz (BazRequest) returns (BazResponse) {} } ```","content":"Bad service Foo { rpc Bar (BarRequest) returns (BarResponse) {} rpc Baz (BazRequest) returns (BazResponse) {} } ```"},{"id":"cli/linter/rules/comment-rpc::good::3","title":"COMMENT_RPC","section":"Good","path":"/docs/guide/cli/linter/rules/comment-rpc#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-rpc::good::4","title":"COMMENT_RPC","section":"Good","path":"/docs/guide/cli/linter/rules/comment-rpc#good","headings":["Good"],"excerpt":"Good service Foo { // Bar rpc for bar logic // [!code focus] rpc Bar (BarRequest) returns (BarResponse) {} // Baz rpc for baz logic // [!code focus] rpc Baz (BazRequest) returns (BazResponse) {} } ```","content":"Good service Foo { // Bar rpc for bar logic // [!code focus] rpc Bar (BarRequest) returns (BarResponse) {} // Baz rpc for baz logic // [!code focus] rpc Baz (BazRequest) returns (BazResponse) {} } ```"},{"id":"cli/linter/rules/comment-service::top::0","title":"COMMENT_SERVICE","path":"/docs/guide/cli/linter/rules/comment-service","headings":[],"excerpt":"This rule checks that service has a comment.","content":"This rule checks that service has a comment."},{"id":"cli/linter/rules/comment-service::bad::1","title":"COMMENT_SERVICE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-service#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-service::bad::2","title":"COMMENT_SERVICE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-service#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar (BarRequest) returns (BarResponse) {} } ```","content":"Bad service Foo { rpc Bar (BarRequest) returns (BarResponse) {} } ```"},{"id":"cli/linter/rules/comment-service::good::3","title":"COMMENT_SERVICE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-service#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-service::good::4","title":"COMMENT_SERVICE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-service#good","headings":["Good"],"excerpt":"Good // Foo service for bar logic // [!code focus] service Foo { // Bar rpc for bar logic rpc Bar (BarRequest) returns (BarResponse) {} } ```","content":"Good // Foo service for bar logic // [!code focus] service Foo { // Bar rpc for bar logic rpc Bar (BarRequest) returns (BarResponse) {} } ```"},{"id":"cli/linter/rules/directory-same-package::top::0","title":"DIRECTORY_SAME_PACKAGE","path":"/docs/guide/cli/linter/rules/directory-same-package","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/directory-same-package::top::1","title":"DIRECTORY_SAME_PACKAGE","path":"/docs/guide/cli/linter/rules/directory-same-package","headings":[],"excerpt":"This rule checks that all files in a given directory are in the same package.","content":"This rule checks that all files in a given directory are in the same package."},{"id":"cli/linter/rules/directory-same-package::bad::2","title":"DIRECTORY_SAME_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/directory-same-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: dir/foo.proto","content":"Bad ```proto // File: dir/foo.proto"},{"id":"cli/linter/rules/directory-same-package::bad::3","title":"DIRECTORY_SAME_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/directory-same-package#bad","headings":["Bad"],"excerpt":"Bad syntax = \"proto3\"; package foo;","content":"Bad syntax = \"proto3\"; package foo;"},{"id":"cli/linter/rules/directory-same-package::bad::4","title":"DIRECTORY_SAME_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/directory-same-package#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; } ```","content":"Bad message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/directory-same-package::good::5","title":"DIRECTORY_SAME_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/directory-same-package#good","headings":["Good"],"excerpt":"Good ```proto // File: dir/foo/foo.proto // [!code focus]","content":"Good ```proto // File: dir/foo/foo.proto // [!code focus]"},{"id":"cli/linter/rules/directory-same-package::good::6","title":"DIRECTORY_SAME_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/directory-same-package#good","headings":["Good"],"excerpt":"Good package dir.foo; // [!code focus]","content":"Good package dir.foo; // [!code focus]"},{"id":"cli/linter/rules/directory-same-package::good::7","title":"DIRECTORY_SAME_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/directory-same-package#good","headings":["Good"],"excerpt":"Good message Foo { string bar = 1; } ```","content":"Good message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/enum-first-value-zero::top::0","title":"ENUM_FIRST_VALUE_ZERO","path":"/docs/guide/cli/linter/rules/enum-first-value-zero","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-first-value-zero::top::1","title":"ENUM_FIRST_VALUE_ZERO","path":"/docs/guide/cli/linter/rules/enum-first-value-zero","headings":[],"excerpt":"This rule checks that the first value of an enum is zero.","content":"This rule checks that the first value of an enum is zero."},{"id":"cli/linter/rules/enum-first-value-zero::bad::2","title":"ENUM_FIRST_VALUE_ZERO","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-first-value-zero#bad","headings":["Bad"],"excerpt":"Bad enum Foo { BAR = 1; BAZ = 2; } ```","content":"Bad enum Foo { BAR = 1; BAZ = 2; } ```"},{"id":"cli/linter/rules/enum-first-value-zero::good::3","title":"ENUM_FIRST_VALUE_ZERO","section":"Good","path":"/docs/guide/cli/linter/rules/enum-first-value-zero#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-first-value-zero::good::4","title":"ENUM_FIRST_VALUE_ZERO","section":"Good","path":"/docs/guide/cli/linter/rules/enum-first-value-zero#good","headings":["Good"],"excerpt":"Good enum Foo { BAR = 0; // [!code focus] BAZ = 1; } ```","content":"Good enum Foo { BAR = 0; // [!code focus] BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-no-allow-alias::top::0","title":"ENUM_NO_ALLOW_ALIAS","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-no-allow-alias::top::1","title":"ENUM_NO_ALLOW_ALIAS","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias","headings":[],"excerpt":"This rule checks that the allow_alias option is not set to true in an enum.","content":"This rule checks that the allow_alias option is not set to true in an enum."},{"id":"cli/linter/rules/enum-no-allow-alias::bad::2","title":"ENUM_NO_ALLOW_ALIAS","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-no-allow-alias::bad::3","title":"ENUM_NO_ALLOW_ALIAS","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias#bad","headings":["Bad"],"excerpt":"Bad enum Foo { option allow_alias = true; // [!code focus] BAR = 0; BAZ = 1; } ```","content":"Bad enum Foo { option allow_alias = true; // [!code focus] BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-no-allow-alias::good::4","title":"ENUM_NO_ALLOW_ALIAS","section":"Good","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-no-allow-alias::good::5","title":"ENUM_NO_ALLOW_ALIAS","section":"Good","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias#good","headings":["Good"],"excerpt":"Good enum Foo { BAR = 0; BAZ = 1; } ```","content":"Good enum Foo { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-pascal-case::top::0","title":"ENUM_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/enum-pascal-case","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-pascal-case::top::1","title":"ENUM_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/enum-pascal-case","headings":[],"excerpt":"This rule checks that enum names are in PascalCase.","content":"This rule checks that enum names are in PascalCase."},{"id":"cli/linter/rules/enum-pascal-case::bad::2","title":"ENUM_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-pascal-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-pascal-case::bad::3","title":"ENUM_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-pascal-case#bad","headings":["Bad"],"excerpt":"Bad enum foo_bar { BAR = 0; BAZ = 1; } ```","content":"Bad enum foo_bar { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-pascal-case::good::4","title":"ENUM_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/enum-pascal-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-pascal-case::good::5","title":"ENUM_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/enum-pascal-case#good","headings":["Good"],"excerpt":"Good enum FooBar { // [!code focus] BAR = 0; BAZ = 1; } ```","content":"Good enum FooBar { // [!code focus] BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-value-prefix::top::0","title":"ENUM_VALUE_PREFIX","path":"/docs/guide/cli/linter/rules/enum-value-prefix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-value-prefix::top::1","title":"ENUM_VALUE_PREFIX","path":"/docs/guide/cli/linter/rules/enum-value-prefix","headings":[],"excerpt":"This rule checks that all enum values are prefixed with the enum name.","content":"This rule checks that all enum values are prefixed with the enum name."},{"id":"cli/linter/rules/enum-value-prefix::bad::2","title":"ENUM_VALUE_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-value-prefix#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-value-prefix::good::3","title":"ENUM_VALUE_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/enum-value-prefix#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-value-prefix::good::4","title":"ENUM_VALUE_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/enum-value-prefix#good","headings":["Good"],"excerpt":"Good enum Foo { FOO_BAR = 0; // [!code focus] } ```","content":"Good enum Foo { FOO_BAR = 0; // [!code focus] } ```"},{"id":"cli/linter/rules/enum-value-upper-snake-case::top::0","title":"ENUM_VALUE_UPPER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-value-upper-snake-case::top::1","title":"ENUM_VALUE_UPPER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case","headings":[],"excerpt":"This rule checks that enum values are in UPPER_SNAKE_CASE.","content":"This rule checks that enum values are in UPPER_SNAKE_CASE."},{"id":"cli/linter/rules/enum-value-upper-snake-case::bad::2","title":"ENUM_VALUE_UPPER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-value-upper-snake-case::bad::3","title":"ENUM_VALUE_UPPER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case#bad","headings":["Bad"],"excerpt":"Bad enum Foo { barName = 0; bazName = 1; } ```","content":"Bad enum Foo { barName = 0; bazName = 1; } ```"},{"id":"cli/linter/rules/enum-value-upper-snake-case::good::4","title":"ENUM_VALUE_UPPER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-value-upper-snake-case::good::5","title":"ENUM_VALUE_UPPER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case#good","headings":["Good"],"excerpt":"Good enum Foo { BAR_NAME = 0; // [!code focus] BAZ_NAME = 1; // [!code focus] } ```","content":"Good enum Foo { BAR_NAME = 0; // [!code focus] BAZ_NAME = 1; // [!code focus] } ```"},{"id":"cli/linter/rules/enum-zero-value-suffix::top::0","title":"ENUM_ZERO_VALUE_SUFFIX","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-zero-value-suffix::top::1","title":"ENUM_ZERO_VALUE_SUFFIX","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix","headings":[],"excerpt":"This rule checks that all enum zero values are suffixed with _NONE or your custom suffix.","content":"This rule checks that all enum zero values are suffixed with _NONE or your custom suffix."},{"id":"cli/linter/rules/enum-zero-value-suffix::bad::2","title":"ENUM_ZERO_VALUE_SUFFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-zero-value-suffix::good::3","title":"ENUM_ZERO_VALUE_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-zero-value-suffix::good::4","title":"ENUM_ZERO_VALUE_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix#good","headings":["Good"],"excerpt":"Good enum Foo { FOO_BAR_NONE = 0; // [!code focus] } ```","content":"Good enum Foo { FOO_BAR_NONE = 0; // [!code focus] } ```"},{"id":"cli/linter/rules/field-lower-snake-case::top::0","title":"FIELD_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/field-lower-snake-case","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/field-lower-snake-case::top::1","title":"FIELD_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/field-lower-snake-case","headings":[],"excerpt":"This rule checks that field names of messages are in lower_snake_case.","content":"This rule checks that field names of messages are in lower_snake_case."},{"id":"cli/linter/rules/field-lower-snake-case::bad::2","title":"FIELD_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/field-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/field-lower-snake-case::bad::3","title":"FIELD_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/field-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad message Foo { string BarName = 1; } ```","content":"Bad message Foo { string BarName = 1; } ```"},{"id":"cli/linter/rules/field-lower-snake-case::good::4","title":"FIELD_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/field-lower-snake-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/field-lower-snake-case::good::5","title":"FIELD_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/field-lower-snake-case#good","headings":["Good"],"excerpt":"Good message Foo { string bar_name = 1; // [!code focus] } ```","content":"Good message Foo { string bar_name = 1; // [!code focus] } ```"},{"id":"cli/linter/rules/file-lower-snake-case::top::0","title":"FILE_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/file-lower-snake-case","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/file-lower-snake-case::top::1","title":"FILE_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/file-lower-snake-case","headings":[],"excerpt":"This rule checks that all files are in lower_snake_case.","content":"This rule checks that all files are in lower_snake_case."},{"id":"cli/linter/rules/file-lower-snake-case::bad::2","title":"FILE_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/file-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: bar/FooBaz.proto","content":"Bad ```proto // File: bar/FooBaz.proto"},{"id":"cli/linter/rules/file-lower-snake-case::good::3","title":"FILE_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/file-lower-snake-case#good","headings":["Good"],"excerpt":"Good ```proto // File: bar/foo_baz.proto // [!code focus]","content":"Good ```proto // File: bar/foo_baz.proto // [!code focus]"},{"id":"cli/linter/rules/import-no-public::top::0","title":"IMPORT_NO_PUBLIC","path":"/docs/guide/cli/linter/rules/import-no-public","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/import-no-public::top::1","title":"IMPORT_NO_PUBLIC","path":"/docs/guide/cli/linter/rules/import-no-public","headings":[],"excerpt":"This rule checks that no public imports are used in a proto file.","content":"This rule checks that no public imports are used in a proto file."},{"id":"cli/linter/rules/import-no-public::bad::2","title":"IMPORT_NO_PUBLIC","section":"Bad","path":"/docs/guide/cli/linter/rules/import-no-public#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/import-no-public::bad::3","title":"IMPORT_NO_PUBLIC","section":"Bad","path":"/docs/guide/cli/linter/rules/import-no-public#bad","headings":["Bad"],"excerpt":"Bad import public \"bar.proto\"; ```","content":"Bad import public \"bar.proto\"; ```"},{"id":"cli/linter/rules/import-no-public::good::4","title":"IMPORT_NO_PUBLIC","section":"Good","path":"/docs/guide/cli/linter/rules/import-no-public#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/import-no-public::good::5","title":"IMPORT_NO_PUBLIC","section":"Good","path":"/docs/guide/cli/linter/rules/import-no-public#good","headings":["Good"],"excerpt":"Good import \"bar.proto\"; // [!code focus] ```","content":"Good import \"bar.proto\"; // [!code focus] ```"},{"id":"cli/linter/rules/import-no-weak::top::0","title":"IMPORT_NO_WEAK","path":"/docs/guide/cli/linter/rules/import-no-weak","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/import-no-weak::top::1","title":"IMPORT_NO_WEAK","path":"/docs/guide/cli/linter/rules/import-no-weak","headings":[],"excerpt":"This rule checks that no weak imports are used in a proto file.","content":"This rule checks that no weak imports are used in a proto file."},{"id":"cli/linter/rules/import-no-weak::bad::2","title":"IMPORT_NO_WEAK","section":"Bad","path":"/docs/guide/cli/linter/rules/import-no-weak#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto2\";","content":"Bad ```proto syntax = \"proto2\";"},{"id":"cli/linter/rules/import-no-weak::bad::3","title":"IMPORT_NO_WEAK","section":"Bad","path":"/docs/guide/cli/linter/rules/import-no-weak#bad","headings":["Bad"],"excerpt":"Bad import weak \"bar.proto\"; ```","content":"Bad import weak \"bar.proto\"; ```"},{"id":"cli/linter/rules/import-no-weak::good::4","title":"IMPORT_NO_WEAK","section":"Good","path":"/docs/guide/cli/linter/rules/import-no-weak#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto2\";","content":"Good ```proto syntax = \"proto2\";"},{"id":"cli/linter/rules/import-no-weak::good::5","title":"IMPORT_NO_WEAK","section":"Good","path":"/docs/guide/cli/linter/rules/import-no-weak#good","headings":["Good"],"excerpt":"Good import \"bar.proto\"; // [!code focus] ```","content":"Good import \"bar.proto\"; // [!code focus] ```"},{"id":"cli/linter/rules/import-used::top::0","title":"IMPORT_USED","path":"/docs/guide/cli/linter/rules/import-used","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/import-used::top::1","title":"IMPORT_USED","path":"/docs/guide/cli/linter/rules/import-used","headings":[],"excerpt":"This rule checks that all imports are used in a proto file.","content":"This rule checks that all imports are used in a proto file."},{"id":"cli/linter/rules/import-used::bad::2","title":"IMPORT_USED","section":"Bad","path":"/docs/guide/cli/linter/rules/import-used#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/import-used::good::3","title":"IMPORT_USED","section":"Good","path":"/docs/guide/cli/linter/rules/import-used#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/import-used::good::4","title":"IMPORT_USED","section":"Good","path":"/docs/guide/cli/linter/rules/import-used#good","headings":["Good"],"excerpt":"Good import \"bar.proto\"; // [!code focus]","content":"Good import \"bar.proto\"; // [!code focus]"},{"id":"cli/linter/rules/import-used::good::5","title":"IMPORT_USED","section":"Good","path":"/docs/guide/cli/linter/rules/import-used#good","headings":["Good"],"excerpt":"Good message Foo { bar.Bar bar = 1; // [!code focus] } ```","content":"Good message Foo { bar.Bar bar = 1; // [!code focus] } ```"},{"id":"cli/linter/rules/message-pascal-case::top::0","title":"MESSAGE_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/message-pascal-case","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/message-pascal-case::top::1","title":"MESSAGE_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/message-pascal-case","headings":[],"excerpt":"This rule checks that message names are in PascalCase.","content":"This rule checks that message names are in PascalCase."},{"id":"cli/linter/rules/message-pascal-case::bad::2","title":"MESSAGE_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/message-pascal-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/message-pascal-case::bad::3","title":"MESSAGE_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/message-pascal-case#bad","headings":["Bad"],"excerpt":"Bad message foo_bar { string bar_name = 1; } ```","content":"Bad message foo_bar { string bar_name = 1; } ```"},{"id":"cli/linter/rules/message-pascal-case::good::4","title":"MESSAGE_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/message-pascal-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/message-pascal-case::good::5","title":"MESSAGE_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/message-pascal-case#good","headings":["Good"],"excerpt":"Good message FooBar { // [!code focus] string bar_name = 1; } ```","content":"Good message FooBar { // [!code focus] string bar_name = 1; } ```"},{"id":"cli/linter/rules/oneof-lower-snake-case::top::0","title":"ONEOF_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/oneof-lower-snake-case::top::1","title":"ONEOF_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case","headings":[],"excerpt":"This rule checks that oneof names are in lower_snake_case.","content":"This rule checks that oneof names are in lower_snake_case."},{"id":"cli/linter/rules/oneof-lower-snake-case::bad::2","title":"ONEOF_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/oneof-lower-snake-case::bad::3","title":"ONEOF_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad message Foo { oneof BarName { string bar_name = 1; } } ```","content":"Bad message Foo { oneof BarName { string bar_name = 1; } } ```"},{"id":"cli/linter/rules/oneof-lower-snake-case::good::4","title":"ONEOF_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/oneof-lower-snake-case::good::5","title":"ONEOF_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case#good","headings":["Good"],"excerpt":"Good message Foo { oneof bar_name { // [!code focus] string bar_name = 1; } } ```","content":"Good message Foo { oneof bar_name { // [!code focus] string bar_name = 1; } } ```"},{"id":"cli/linter/rules/package-defined::top::0","title":"PACKAGE_DEFINED","path":"/docs/guide/cli/linter/rules/package-defined","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-defined::top::1","title":"PACKAGE_DEFINED","path":"/docs/guide/cli/linter/rules/package-defined","headings":[],"excerpt":"This rule checks that all files have a package declaration.","content":"This rule checks that all files have a package declaration."},{"id":"cli/linter/rules/package-defined::bad::2","title":"PACKAGE_DEFINED","section":"Bad","path":"/docs/guide/cli/linter/rules/package-defined#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-defined::bad::3","title":"PACKAGE_DEFINED","section":"Bad","path":"/docs/guide/cli/linter/rules/package-defined#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; }","content":"Bad message Foo { string bar = 1; }"},{"id":"cli/linter/rules/package-defined::good::4","title":"PACKAGE_DEFINED","section":"Good","path":"/docs/guide/cli/linter/rules/package-defined#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-defined::good::5","title":"PACKAGE_DEFINED","section":"Good","path":"/docs/guide/cli/linter/rules/package-defined#good","headings":["Good"],"excerpt":"Good package foo; // [!code focus]","content":"Good package foo; // [!code focus]"},{"id":"cli/linter/rules/package-defined::good::6","title":"PACKAGE_DEFINED","section":"Good","path":"/docs/guide/cli/linter/rules/package-defined#good","headings":["Good"],"excerpt":"Good message Foo { string bar = 1; } ```","content":"Good message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/package-directory-match::top::0","title":"PACKAGE_DIRECTORY_MATCH","path":"/docs/guide/cli/linter/rules/package-directory-match","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-directory-match::top::1","title":"PACKAGE_DIRECTORY_MATCH","path":"/docs/guide/cli/linter/rules/package-directory-match","headings":[],"excerpt":"This rule checks that all files are in a directory that matches their package name.","content":"This rule checks that all files are in a directory that matches their package name."},{"id":"cli/linter/rules/package-directory-match::bad::2","title":"PACKAGE_DIRECTORY_MATCH","section":"Bad","path":"/docs/guide/cli/linter/rules/package-directory-match#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: bar/foo.proto","content":"Bad ```proto // File: bar/foo.proto"},{"id":"cli/linter/rules/package-directory-match::bad::3","title":"PACKAGE_DIRECTORY_MATCH","section":"Bad","path":"/docs/guide/cli/linter/rules/package-directory-match#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; }","content":"Bad message Foo { string bar = 1; }"},{"id":"cli/linter/rules/package-directory-match::good::4","title":"PACKAGE_DIRECTORY_MATCH","section":"Good","path":"/docs/guide/cli/linter/rules/package-directory-match#good","headings":["Good"],"excerpt":"Good ```proto // File: bar/foo.proto // [!code focus]","content":"Good ```proto // File: bar/foo.proto // [!code focus]"},{"id":"cli/linter/rules/package-directory-match::good::5","title":"PACKAGE_DIRECTORY_MATCH","section":"Good","path":"/docs/guide/cli/linter/rules/package-directory-match#good","headings":["Good"],"excerpt":"Good package bar; // [!code focus]","content":"Good package bar; // [!code focus]"},{"id":"cli/linter/rules/package-directory-match::good::6","title":"PACKAGE_DIRECTORY_MATCH","section":"Good","path":"/docs/guide/cli/linter/rules/package-directory-match#good","headings":["Good"],"excerpt":"Good message Foo { string bar = 1; } ```","content":"Good message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/package-lower-snake-case::top::0","title":"PACKAGE_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/package-lower-snake-case","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-lower-snake-case::top::1","title":"PACKAGE_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/package-lower-snake-case","headings":[],"excerpt":"This rule checks that package names are in lower_snake_case.","content":"This rule checks that package names are in lower_snake_case."},{"id":"cli/linter/rules/package-lower-snake-case::bad::2","title":"PACKAGE_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: bar/foo.proto syntax = \"proto3\";","content":"Bad ```proto // File: bar/foo.proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-lower-snake-case::good::3","title":"PACKAGE_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/package-lower-snake-case#good","headings":["Good"],"excerpt":"Good ```proto // File: bar/foo.proto syntax = \"proto3\";","content":"Good ```proto // File: bar/foo.proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-lower-snake-case::good::4","title":"PACKAGE_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/package-lower-snake-case#good","headings":["Good"],"excerpt":"Good package foo_bar; // [!code focus] ```","content":"Good package foo_bar; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-csharp-namespace::top::0","title":"PACKAGE_SAME_CSHARP_NAMESPACE","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-csharp-namespace::top::1","title":"PACKAGE_SAME_CSHARP_NAMESPACE","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace","headings":[],"excerpt":"This rule checks that all files with a given package are in the same C# namespace.","content":"This rule checks that all files with a given package are in the same C# namespace."},{"id":"cli/linter/rules/package-same-csharp-namespace::bad::2","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-csharp-namespace::bad::3","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#bad","headings":["Bad"],"excerpt":"Bad option csharp_namespace = \"Foo.Bar\"; ```","content":"Bad option csharp_namespace = \"Foo.Bar\"; ```"},{"id":"cli/linter/rules/package-same-csharp-namespace::bad::4","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-csharp-namespace::bad::5","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#bad","headings":["Bad"],"excerpt":"Bad option csharp_namespace = \"Foo.Baz\"; ```","content":"Bad option csharp_namespace = \"Foo.Baz\"; ```"},{"id":"cli/linter/rules/package-same-csharp-namespace::good::6","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-csharp-namespace::good::7","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#good","headings":["Good"],"excerpt":"Good option csharp_namespace = \"Foo.Bar\"; ```","content":"Good option csharp_namespace = \"Foo.Bar\"; ```"},{"id":"cli/linter/rules/package-same-csharp-namespace::good::8","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#good","headings":["Good"],"excerpt":"Good option csharp_namespace = \"Foo.Bar\"; // [!code focus] ```","content":"Good option csharp_namespace = \"Foo.Bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-directory::top::0","title":"PACKAGE_SAME_DIRECTORY","path":"/docs/guide/cli/linter/rules/package-same-directory","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-directory::top::1","title":"PACKAGE_SAME_DIRECTORY","path":"/docs/guide/cli/linter/rules/package-same-directory","headings":[],"excerpt":"This rule checks that all files with a given package are in the same directory.","content":"This rule checks that all files with a given package are in the same directory."},{"id":"cli/linter/rules/package-same-directory::bad::2","title":"PACKAGE_SAME_DIRECTORY","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-directory#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: bar/foo.proto","content":"Bad ```proto // File: bar/foo.proto"},{"id":"cli/linter/rules/package-same-directory::bad::3","title":"PACKAGE_SAME_DIRECTORY","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-directory#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; }","content":"Bad message Foo { string bar = 1; }"},{"id":"cli/linter/rules/package-same-directory::good::4","title":"PACKAGE_SAME_DIRECTORY","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-directory#good","headings":["Good"],"excerpt":"Good ```proto // File: bar/foo.proto // [!code focus]","content":"Good ```proto // File: bar/foo.proto // [!code focus]"},{"id":"cli/linter/rules/package-same-directory::good::5","title":"PACKAGE_SAME_DIRECTORY","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-directory#good","headings":["Good"],"excerpt":"Good package bar; // [!code focus]","content":"Good package bar; // [!code focus]"},{"id":"cli/linter/rules/package-same-directory::good::6","title":"PACKAGE_SAME_DIRECTORY","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-directory#good","headings":["Good"],"excerpt":"Good message Foo { string bar = 1; }","content":"Good message Foo { string bar = 1; }"},{"id":"cli/linter/rules/package-same-go-package::top::0","title":"PACKAGE_SAME_GO_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-go-package","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-go-package::top::1","title":"PACKAGE_SAME_GO_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-go-package","headings":[],"excerpt":"This rule checks that all files with a given package are in the same Go package.","content":"This rule checks that all files with a given package are in the same Go package."},{"id":"cli/linter/rules/package-same-go-package::bad::2","title":"PACKAGE_SAME_GO_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-go-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-go-package::bad::3","title":"PACKAGE_SAME_GO_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-go-package#bad","headings":["Bad"],"excerpt":"Bad option go_package = \"example.com/foo/bar\";","content":"Bad option go_package = \"example.com/foo/bar\";"},{"id":"cli/linter/rules/package-same-go-package::bad::4","title":"PACKAGE_SAME_GO_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-go-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-go-package::bad::5","title":"PACKAGE_SAME_GO_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-go-package#bad","headings":["Bad"],"excerpt":"Bad option go_package = \"example.com/foo/baz\";","content":"Bad option go_package = \"example.com/foo/baz\";"},{"id":"cli/linter/rules/package-same-go-package::good::6","title":"PACKAGE_SAME_GO_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-go-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-go-package::good::7","title":"PACKAGE_SAME_GO_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-go-package#good","headings":["Good"],"excerpt":"Good option go_package = \"example.com/foo/bar\"; // [!code focus] ```","content":"Good option go_package = \"example.com/foo/bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-go-package::good::8","title":"PACKAGE_SAME_GO_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-go-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-go-package::good::9","title":"PACKAGE_SAME_GO_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-go-package#good","headings":["Good"],"excerpt":"Good option go_package = \"example.com/foo/bar\"; // [!code focus] ```","content":"Good option go_package = \"example.com/foo/bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-java-multiple-files::top::0","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files","headings":[],"excerpt":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","content":"PACKAGE_SAME_JAVA_MULTIPLE_FILES"},{"id":"cli/linter/rules/package-same-java-multiple-files::top::1","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-java-multiple-files::top::2","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files","headings":[],"excerpt":"This rule checks that all files with a given package are in the same Java package.","content":"This rule checks that all files with a given package are in the same Java package."},{"id":"cli/linter/rules/package-same-java-multiple-files::bad::3","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-java-multiple-files::bad::4","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#bad","headings":["Bad"],"excerpt":"Bad option java_package = \"com.example.foo\"; ```","content":"Bad option java_package = \"com.example.foo\"; ```"},{"id":"cli/linter/rules/package-same-java-multiple-files::bad::5","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#bad","headings":["Bad"],"excerpt":"Bad option java_package = \"com.example.bar\"; ```","content":"Bad option java_package = \"com.example.bar\"; ```"},{"id":"cli/linter/rules/package-same-java-multiple-files::good::6","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-java-multiple-files::good::7","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#good","headings":["Good"],"excerpt":"Good option java_package = \"com.example.foo\"; // [!code focus] ```","content":"Good option java_package = \"com.example.foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-java-multiple-files::good::8","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-java-multiple-files::good::9","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#good","headings":["Good"],"excerpt":"Good option java_package = \"com.example.foo\"; // [!code focus] ```","content":"Good option java_package = \"com.example.foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-java-package::top::0","title":"PACKAGE_SAME_JAVA_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-java-package","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-java-package::top::1","title":"PACKAGE_SAME_JAVA_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-java-package","headings":[],"excerpt":"This rule checks that all files with a given package are in the same Java package.","content":"This rule checks that all files with a given package are in the same Java package."},{"id":"cli/linter/rules/package-same-java-package::bad::2","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-java-package::bad::3","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-package#bad","headings":["Bad"],"excerpt":"Bad option java_package = \"com.example.foo\"; ```","content":"Bad option java_package = \"com.example.foo\"; ```"},{"id":"cli/linter/rules/package-same-java-package::bad::4","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-java-package::bad::5","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-package#bad","headings":["Bad"],"excerpt":"Bad option java_package = \"com.example.bar\"; ```","content":"Bad option java_package = \"com.example.bar\"; ```"},{"id":"cli/linter/rules/package-same-java-package::good::6","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-java-package::good::7","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-package#good","headings":["Good"],"excerpt":"Good option java_package = \"com.example.foo\"; // [!code focus] ```","content":"Good option java_package = \"com.example.foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-java-package::good::8","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-java-package::good::9","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-package#good","headings":["Good"],"excerpt":"Good option java_package = \"com.example.foo\"; // [!code focus] ```","content":"Good option java_package = \"com.example.foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-php-namespace::top::0","title":"PACKAGE_SAME_PHP_NAMESPACE","path":"/docs/guide/cli/linter/rules/package-same-php-namespace","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-php-namespace::top::1","title":"PACKAGE_SAME_PHP_NAMESPACE","path":"/docs/guide/cli/linter/rules/package-same-php-namespace","headings":[],"excerpt":"This rule checks that all files with a given package are in the same PHP namespace.","content":"This rule checks that all files with a given package are in the same PHP namespace."},{"id":"cli/linter/rules/package-same-php-namespace::bad::2","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-php-namespace::bad::3","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#bad","headings":["Bad"],"excerpt":"Bad option php_namespace = \"Foo\\\\Bar\";","content":"Bad option php_namespace = \"Foo\\\\Bar\";"},{"id":"cli/linter/rules/package-same-php-namespace::bad::4","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-php-namespace::bad::5","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#bad","headings":["Bad"],"excerpt":"Bad option php_namespace = \"Foo\\\\Baz\"; ```","content":"Bad option php_namespace = \"Foo\\\\Baz\"; ```"},{"id":"cli/linter/rules/package-same-php-namespace::good::6","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-php-namespace::good::7","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#good","headings":["Good"],"excerpt":"Good option php_namespace = \"Foo\\\\Bar\"; // [!code focus] ```","content":"Good option php_namespace = \"Foo\\\\Bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-php-namespace::good::8","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-php-namespace::good::9","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#good","headings":["Good"],"excerpt":"Good option php_namespace = \"Foo\\\\Bar\"; // [!code focus] ```","content":"Good option php_namespace = \"Foo\\\\Bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-ruby-package::top::0","title":"PACKAGE_SAME_RUBY_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-ruby-package","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-ruby-package::top::1","title":"PACKAGE_SAME_RUBY_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-ruby-package","headings":[],"excerpt":"This rule checks that all files with a given package are in the same Ruby package.","content":"This rule checks that all files with a given package are in the same Ruby package."},{"id":"cli/linter/rules/package-same-ruby-package::bad::2","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-ruby-package::bad::3","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#bad","headings":["Bad"],"excerpt":"Bad option ruby_package = \"Foo\"; ```","content":"Bad option ruby_package = \"Foo\"; ```"},{"id":"cli/linter/rules/package-same-ruby-package::bad::4","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-ruby-package::bad::5","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#bad","headings":["Bad"],"excerpt":"Bad option ruby_package = \"Bar\"; ```","content":"Bad option ruby_package = \"Bar\"; ```"},{"id":"cli/linter/rules/package-same-ruby-package::good::6","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-ruby-package::good::7","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#good","headings":["Good"],"excerpt":"Good option ruby_package = \"Foo\"; // [!code focus] ```","content":"Good option ruby_package = \"Foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-ruby-package::good::8","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-ruby-package::good::9","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#good","headings":["Good"],"excerpt":"Good option ruby_package = \"Foo\"; // [!code focus] ```","content":"Good option ruby_package = \"Foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-swift-prefix::top::0","title":"PACKAGE_SAME_SWIFT_PREFIX","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-swift-prefix::top::1","title":"PACKAGE_SAME_SWIFT_PREFIX","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix","headings":[],"excerpt":"This rule checks that all files with a given package are in the same Swift prefix.","content":"This rule checks that all files with a given package are in the same Swift prefix."},{"id":"cli/linter/rules/package-same-swift-prefix::bad::2","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-swift-prefix::bad::3","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#bad","headings":["Bad"],"excerpt":"Bad option swift_prefix = \"Foo\"; ```","content":"Bad option swift_prefix = \"Foo\"; ```"},{"id":"cli/linter/rules/package-same-swift-prefix::bad::4","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-swift-prefix::bad::5","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#bad","headings":["Bad"],"excerpt":"Bad option swift_prefix = \"Bar\"; ```","content":"Bad option swift_prefix = \"Bar\"; ```"},{"id":"cli/linter/rules/package-same-swift-prefix::good::6","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-swift-prefix::good::7","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#good","headings":["Good"],"excerpt":"Good option swift_prefix = \"Foo\"; // [!code focus] ```","content":"Good option swift_prefix = \"Foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-swift-prefix::good::8","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-swift-prefix::good::9","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#good","headings":["Good"],"excerpt":"Good option swift_prefix = \"Foo\"; // [!code focus] ```","content":"Good option swift_prefix = \"Foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-version-suffix::top::0","title":"PACKAGE_VERSION_SUFFIX","path":"/docs/guide/cli/linter/rules/package-version-suffix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-version-suffix::top::1","title":"PACKAGE_VERSION_SUFFIX","path":"/docs/guide/cli/linter/rules/package-version-suffix","headings":[],"excerpt":"This rule checks that the package version suffix is _vX where X is a number of version.","content":"This rule checks that the package version suffix is _vX where X is a number of version."},{"id":"cli/linter/rules/package-version-suffix::bad::2","title":"PACKAGE_VERSION_SUFFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-version-suffix#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-version-suffix::good::3","title":"PACKAGE_VERSION_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-version-suffix#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-version-suffix::good::4","title":"PACKAGE_VERSION_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-version-suffix#good","headings":["Good"],"excerpt":"Good package foo.v1; // [!code focus] ```","content":"Good package foo.v1; // [!code focus] ```"},{"id":"cli/linter/rules/rpc-no-client-streaming::top::0","title":"RPC_NO_CLIENT_STREAMING","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming","headings":[],"excerpt":"This rule checks that rpc has no client streaming.","content":"This rule checks that rpc has no client streaming."},{"id":"cli/linter/rules/rpc-no-client-streaming::bad::1","title":"RPC_NO_CLIENT_STREAMING","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-no-client-streaming::bad::2","title":"RPC_NO_CLIENT_STREAMING","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar (stream BarRequest) returns (BarResponse) {} } ```","content":"Bad service Foo { rpc Bar (stream BarRequest) returns (BarResponse) {} } ```"},{"id":"cli/linter/rules/rpc-no-client-streaming::good::3","title":"RPC_NO_CLIENT_STREAMING","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-no-client-streaming::good::4","title":"RPC_NO_CLIENT_STREAMING","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming#good","headings":["Good"],"excerpt":"Good service Foo { rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-no-server-streaming::top::0","title":"RPC_NO_SERVER_STREAMING","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming","headings":[],"excerpt":"This rule checks that rpc has no server streaming.","content":"This rule checks that rpc has no server streaming."},{"id":"cli/linter/rules/rpc-no-server-streaming::bad::1","title":"RPC_NO_SERVER_STREAMING","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-no-server-streaming::bad::2","title":"RPC_NO_SERVER_STREAMING","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar (BarRequest) returns (stream BarResponse) {} } ```","content":"Bad service Foo { rpc Bar (BarRequest) returns (stream BarResponse) {} } ```"},{"id":"cli/linter/rules/rpc-no-server-streaming::good::3","title":"RPC_NO_SERVER_STREAMING","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-no-server-streaming::good::4","title":"RPC_NO_SERVER_STREAMING","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming#good","headings":["Good"],"excerpt":"Good service Foo { rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-pascal-case::top::0","title":"RPC_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/rpc-pascal-case","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/rpc-pascal-case::top::1","title":"RPC_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/rpc-pascal-case","headings":[],"excerpt":"This rule checks that all RPC names are in PascalCase.","content":"This rule checks that all RPC names are in PascalCase."},{"id":"cli/linter/rules/rpc-pascal-case::bad::2","title":"RPC_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-pascal-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-pascal-case::bad::3","title":"RPC_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-pascal-case#bad","headings":["Bad"],"excerpt":"Bad service foo_bar { rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {} } ```","content":"Bad service foo_bar { rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {} } ```"},{"id":"cli/linter/rules/rpc-pascal-case::good::4","title":"RPC_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-pascal-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-pascal-case::good::5","title":"RPC_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-pascal-case#good","headings":["Good"],"excerpt":"Good service FooBar { rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} // [!code focus] } ```","content":"Good service FooBar { rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-request-response-unique::top::0","title":"RPC_REQUEST_RESPONSE_UNIQUE","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/rpc-request-response-unique::top::1","title":"RPC_REQUEST_RESPONSE_UNIQUE","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique","headings":[],"excerpt":"This rule checks that all RPC request and response messages are unique.","content":"This rule checks that all RPC request and response messages are unique."},{"id":"cli/linter/rules/rpc-request-response-unique::bad::2","title":"RPC_REQUEST_RESPONSE_UNIQUE","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-request-response-unique::bad::3","title":"RPC_REQUEST_RESPONSE_UNIQUE","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} rpc GetBar (FooRequest) returns (FooResponse) {} } ```","content":"Bad service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} rpc GetBar (FooRequest) returns (FooResponse) {} } ```"},{"id":"cli/linter/rules/rpc-request-response-unique::good::4","title":"RPC_REQUEST_RESPONSE_UNIQUE","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-request-response-unique::good::5","title":"RPC_REQUEST_RESPONSE_UNIQUE","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique#good","headings":["Good"],"excerpt":"Good service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} // [!code focus] rpc GetBar (BarRequest) returns (BarResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} // [!code focus] rpc GetBar (BarRequest) returns (BarResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-request-standard-name::top::0","title":"RPC_REQUEST_STANDARD_NAME","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/rpc-request-standard-name::top::1","title":"RPC_REQUEST_STANDARD_NAME","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name","headings":[],"excerpt":"This rule checks that all RPC request messages are named MethodRequest.","content":"This rule checks that all RPC request messages are named MethodRequest."},{"id":"cli/linter/rules/rpc-request-standard-name::bad::2","title":"RPC_REQUEST_STANDARD_NAME","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-request-standard-name::bad::3","title":"RPC_REQUEST_STANDARD_NAME","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} } ```","content":"Bad service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} } ```"},{"id":"cli/linter/rules/rpc-request-standard-name::good::4","title":"RPC_REQUEST_STANDARD_NAME","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-request-standard-name::good::5","title":"RPC_REQUEST_STANDARD_NAME","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name#good","headings":["Good"],"excerpt":"Good service Foo { rpc GetFoo (GetFooRequest) returns (FooResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc GetFoo (GetFooRequest) returns (FooResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-response-standard-name::top::0","title":"RPC_RESPONSE_STANDARD_NAME","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/rpc-response-standard-name::top::1","title":"RPC_RESPONSE_STANDARD_NAME","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name","headings":[],"excerpt":"This rule checks that all RPC response messages are named MethodResponse.","content":"This rule checks that all RPC response messages are named MethodResponse."},{"id":"cli/linter/rules/rpc-response-standard-name::bad::2","title":"RPC_RESPONSE_STANDARD_NAME","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-response-standard-name::bad::3","title":"RPC_RESPONSE_STANDARD_NAME","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc GetFoo (GetFooRequest) returns (Foo) {} } ```","content":"Bad service Foo { rpc GetFoo (GetFooRequest) returns (Foo) {} } ```"},{"id":"cli/linter/rules/rpc-response-standard-name::good::4","title":"RPC_RESPONSE_STANDARD_NAME","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-response-standard-name::good::5","title":"RPC_RESPONSE_STANDARD_NAME","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name#good","headings":["Good"],"excerpt":"Good service Foo { rpc GetFoo (GetFooRequest) returns (GetFooResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc GetFoo (GetFooRequest) returns (GetFooResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/service-pascal-case::top::0","title":"SERVICE_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/service-pascal-case","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/service-pascal-case::top::1","title":"SERVICE_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/service-pascal-case","headings":[],"excerpt":"This rule checks that all service names are in PascalCase.","content":"This rule checks that all service names are in PascalCase."},{"id":"cli/linter/rules/service-pascal-case::bad::2","title":"SERVICE_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/service-pascal-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/service-pascal-case::bad::3","title":"SERVICE_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/service-pascal-case#bad","headings":["Bad"],"excerpt":"Bad service foo_bar { rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {} } ```","content":"Bad service foo_bar { rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {} } ```"},{"id":"cli/linter/rules/service-pascal-case::good::4","title":"SERVICE_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/service-pascal-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/service-pascal-case::good::5","title":"SERVICE_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/service-pascal-case#good","headings":["Good"],"excerpt":"Good service FooBar { // [!code focus] rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} } ```","content":"Good service FooBar { // [!code focus] rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} } ```"},{"id":"cli/linter/rules/service-suffix::top::0","title":"SERVICE_SUFFIX","path":"/docs/guide/cli/linter/rules/service-suffix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/service-suffix::top::1","title":"SERVICE_SUFFIX","path":"/docs/guide/cli/linter/rules/service-suffix","headings":[],"excerpt":"This rule checks that all services are suffixed with Service or your custom suffix.","content":"This rule checks that all services are suffixed with Service or your custom suffix."},{"id":"cli/linter/rules/service-suffix::bad::2","title":"SERVICE_SUFFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/service-suffix#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/service-suffix::bad::3","title":"SERVICE_SUFFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/service-suffix#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar(BarRequest) returns (BarResponse); } ```","content":"Bad service Foo { rpc Bar(BarRequest) returns (BarResponse); } ```"},{"id":"cli/linter/rules/service-suffix::good::4","title":"SERVICE_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/service-suffix#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/service-suffix::good::5","title":"SERVICE_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/service-suffix#good","headings":["Good"],"excerpt":"Good service FooService { // [!code focus] rpc Bar(BarRequest) returns (BarResponse); } ```","content":"Good service FooService { // [!code focus] rpc Bar(BarRequest) returns (BarResponse); } ```"},{"id":"cli/package-manager/easyp-vs-buf::top::0","title":"EasyP vs Buf Package Management","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":[],"excerpt":"EasyP vs Buf Package Management","content":"EasyP vs Buf Package Management"},{"id":"cli/package-manager/easyp-vs-buf::top::1","title":"EasyP vs Buf Package Management","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":[],"excerpt":"This document provides a comprehensive comparison between EasyP's decentralized package management approach and Buf's centralized Buf Schema Registry (BSR) model, helping you understand the key differences and choose the","content":"This document provides a comprehensive comparison between EasyP's decentralized package management approach and Buf's centralized Buf Schema Registry (BSR) model, helping you understand the key differences and choose the right solution for your needs."},{"id":"cli/package-manager/easyp-vs-buf::easyp-decentralized-git-based-approach::2","title":"EasyP vs Buf Package Management","section":"EasyP: Decentralized Git-Based Approach","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-decentralized-git-based-approach","headings":["EasyP: Decentralized Git-Based Approach"],"excerpt":"EasyP: Decentralized Git-Based Approach","content":"EasyP: Decentralized Git-Based Approach"},{"id":"cli/package-manager/easyp-vs-buf::buf-centralized-registry-approach::3","title":"EasyP vs Buf Package Management","section":"Buf: Centralized Registry Approach","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-centralized-registry-approach","headings":["Buf: Centralized Registry Approach"],"excerpt":"Buf: Centralized Registry Approach","content":"Buf: Centralized Registry Approach"},{"id":"cli/package-manager/easyp-vs-buf::key-differences-summary::4","title":"EasyP vs Buf Package Management","section":"Key Differences Summary","path":"/docs/guide/cli/package-manager/easyp-vs-buf#key-differences-summary","headings":["Key Differences Summary"],"excerpt":"Key Differences Summary Aspect EasyP Buf -------- ------- ----- **Architecture** Decentralized (Git-based) Centralized (BSR registry) **Dependency Source** Any Git repository Buf Schema Registry only **Single Point of Fa","content":"Key Differences Summary Aspect EasyP Buf -------- ------- ----- **Architecture** Decentralized (Git-based) Centralized (BSR registry) **Dependency Source** Any Git repository Buf Schema Registry only **Single Point of Failure** No Yes (buf.build) **Enterprise Deployment** Fully air-gapped support Requires BSR access or private BSR **Authentication** Git credentials (SSH/HTTPS) Buf tokens + Git credentials **Vendor Lock-in** None Buf ecosystem **Private Repositories** Native Git support Must publish to BSR first **Offline Support** Full (via vendoring) Limited (cached modules only) **Cost** Free (uses existing Git) Free tier + paid plans **Setup Complexity** Minimal Moderate (BSR setup)"},{"id":"cli/package-manager/easyp-vs-buf::1-dependency-management-philosophy::5","title":"EasyP vs Buf Package Management","section":"1. Dependency Management Philosophy","path":"/docs/guide/cli/package-manager/easyp-vs-buf#1-dependency-management-philosophy","headings":["1. Dependency Management Philosophy"],"excerpt":"Dependency Management Philosophy","content":"Dependency Management Philosophy"},{"id":"cli/package-manager/easyp-vs-buf::easyp-any-git-repository-is-a-package::6","title":"EasyP vs Buf Package Management","section":"EasyP: \"Any Git Repository is a Package\"","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-any-git-repository-is-a-package","headings":["EasyP: \"Any Git Repository is a Package\""],"excerpt":"EasyP: \"Any Git Repository is a Package\"","content":"EasyP: \"Any Git Repository is a Package\""},{"id":"cli/package-manager/easyp-vs-buf::easyp-any-git-repository-is-a-package::7","title":"EasyP vs Buf Package Management","section":"EasyP: \"Any Git Repository is a Package\"","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-any-git-repository-is-a-package","headings":["EasyP: \"Any Git Repository is a Package\""],"excerpt":"EasyP: \"Any Git Repository is a Package\" **Advantages:** ✅ Use any existing Git repository immediately ✅ No need to \"publish\" to a separate registry ✅ Version control is the source of truth ✅ Works with private Git serve","content":"EasyP: \"Any Git Repository is a Package\" **Advantages:** ✅ Use any existing Git repository immediately ✅ No need to \"publish\" to a separate registry ✅ Version control is the source of truth ✅ Works with private Git servers out-of-the-box"},{"id":"cli/package-manager/easyp-vs-buf::buf-registry-first-approach::8","title":"EasyP vs Buf Package Management","section":"Buf: \"Registry-First Approach\"","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-registry-first-approach","headings":["Buf: \"Registry-First Approach\""],"excerpt":"Buf: \"Registry-First Approach\"","content":"Buf: \"Registry-First Approach\""},{"id":"cli/package-manager/easyp-vs-buf::buf-registry-first-approach::9","title":"EasyP vs Buf Package Management","section":"Buf: \"Registry-First Approach\"","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-registry-first-approach","headings":["Buf: \"Registry-First Approach\""],"excerpt":"Buf: \"Registry-First Approach\" **Advantages:** ✅ Curated, high-quality modules ✅ Rich metadata and documentation ✅ Dependency graph visualization ✅ Semantic versioning enforcement","content":"Buf: \"Registry-First Approach\" **Advantages:** ✅ Curated, high-quality modules ✅ Rich metadata and documentation ✅ Dependency graph visualization ✅ Semantic versioning enforcement"},{"id":"cli/package-manager/easyp-vs-buf::buf-registry-first-approach::10","title":"EasyP vs Buf Package Management","section":"Buf: \"Registry-First Approach\"","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-registry-first-approach","headings":["Buf: \"Registry-First Approach\""],"excerpt":"Buf: \"Registry-First Approach\" **Limitations:** ❌ Must publish to BSR before use ❌ Requires BSR account and authentication ❌ Cannot reference arbitrary Git repositories directly","content":"Buf: \"Registry-First Approach\" **Limitations:** ❌ Must publish to BSR before use ❌ Requires BSR account and authentication ❌ Cannot reference arbitrary Git repositories directly"},{"id":"cli/package-manager/easyp-vs-buf::2-enterprise-and-air-gapped-environments::11","title":"EasyP vs Buf Package Management","section":"2. Enterprise and Air-Gapped Environments","path":"/docs/guide/cli/package-manager/easyp-vs-buf#2-enterprise-and-air-gapped-environments","headings":["2. Enterprise and Air-Gapped Environments"],"excerpt":"Enterprise and Air-Gapped Environments","content":"Enterprise and Air-Gapped Environments"},{"id":"cli/package-manager/easyp-vs-buf::easyp-full-air-gap-support::12","title":"EasyP vs Buf Package Management","section":"EasyP: Full Air-Gap Support","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-full-air-gap-support","headings":["EasyP: Full Air-Gap Support"],"excerpt":"EasyP: Full Air-Gap Support **Scenario**: Large enterprise with strict network policies","content":"EasyP: Full Air-Gap Support **Scenario**: Large enterprise with strict network policies"},{"id":"cli/package-manager/easyp-vs-buf::easyp-full-air-gap-support::13","title":"EasyP vs Buf Package Management","section":"EasyP: Full Air-Gap Support","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-full-air-gap-support","headings":["EasyP: Full Air-Gap Support"],"excerpt":"EasyP: Full Air-Gap Support ```bash Initial setup (with internet) easyp mod download # Downloads to ~/.easyp/ easyp mod vendor # Creates easyp_vendor/","content":"EasyP: Full Air-Gap Support ```bash Initial setup (with internet) easyp mod download # Downloads to ~/.easyp/ easyp mod vendor # Creates easyp_vendor/"},{"id":"cli/package-manager/easyp-vs-buf::easyp-full-air-gap-support::14","title":"EasyP vs Buf Package Management","section":"EasyP: Full Air-Gap Support","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-full-air-gap-support","headings":["EasyP: Full Air-Gap Support"],"excerpt":"EasyP: Full Air-Gap Support Transfer to air-gapped environment tar -czf easyp-deps.tar.gz ~/.easyp easyp_vendor/ ... transfer archive ...","content":"EasyP: Full Air-Gap Support Transfer to air-gapped environment tar -czf easyp-deps.tar.gz ~/.easyp easyp_vendor/ ... transfer archive ..."},{"id":"cli/package-manager/easyp-vs-buf::easyp-full-air-gap-support::15","title":"EasyP vs Buf Package Management","section":"EasyP: Full Air-Gap Support","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-full-air-gap-support","headings":["EasyP: Full Air-Gap Support"],"excerpt":"EasyP: Full Air-Gap Support Air-gapped environment (no internet) tar -xzf easyp-deps.tar.gz export EASYPPATH=$PWD/.easyp easyp generate # Works offline ```","content":"EasyP: Full Air-Gap Support Air-gapped environment (no internet) tar -xzf easyp-deps.tar.gz export EASYPPATH=$PWD/.easyp easyp generate # Works offline ```"},{"id":"cli/package-manager/easyp-vs-buf::easyp-full-air-gap-support::16","title":"EasyP vs Buf Package Management","section":"EasyP: Full Air-Gap Support","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-full-air-gap-support","headings":["EasyP: Full Air-Gap Support"],"excerpt":"EasyP: Full Air-Gap Support **Benefits:** ✅ Complete independence from external services ✅ No need for internal registry infrastructure ✅ Uses existing Git infrastructure ✅ Simple file-based distribution","content":"EasyP: Full Air-Gap Support **Benefits:** ✅ Complete independence from external services ✅ No need for internal registry infrastructure ✅ Uses existing Git infrastructure ✅ Simple file-based distribution"},{"id":"cli/package-manager/easyp-vs-buf::buf-requires-bsr-infrastructure::17","title":"EasyP vs Buf Package Management","section":"Buf: Requires BSR Infrastructure","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-requires-bsr-infrastructure","headings":["Buf: Requires BSR Infrastructure"],"excerpt":"Buf: Requires BSR Infrastructure **Scenario**: Same enterprise setup","content":"Buf: Requires BSR Infrastructure **Scenario**: Same enterprise setup"},{"id":"cli/package-manager/easyp-vs-buf::buf-requires-bsr-infrastructure::18","title":"EasyP vs Buf Package Management","section":"Buf: Requires BSR Infrastructure","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-requires-bsr-infrastructure","headings":["Buf: Requires BSR Infrastructure"],"excerpt":"Buf: Requires BSR Infrastructure ```bash Option 1: Use buf.build (requires internet) buf mod download # Must reach buf.build","content":"Buf: Requires BSR Infrastructure ```bash Option 1: Use buf.build (requires internet) buf mod download # Must reach buf.build"},{"id":"cli/package-manager/easyp-vs-buf::buf-requires-bsr-infrastructure::19","title":"EasyP vs Buf Package Management","section":"Buf: Requires BSR Infrastructure","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-requires-bsr-infrastructure","headings":["Buf: Requires BSR Infrastructure"],"excerpt":"Buf: Requires BSR Infrastructure Option 2: Set up private BSR (complex) Deploy BSR server infrastructure Migrate all modules to private BSR Configure authentication and access Maintain registry server ```","content":"Buf: Requires BSR Infrastructure Option 2: Set up private BSR (complex) Deploy BSR server infrastructure Migrate all modules to private BSR Configure authentication and access Maintain registry server ```"},{"id":"cli/package-manager/easyp-vs-buf::buf-requires-bsr-infrastructure::20","title":"EasyP vs Buf Package Management","section":"Buf: Requires BSR Infrastructure","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-requires-bsr-infrastructure","headings":["Buf: Requires BSR Infrastructure"],"excerpt":"Buf: Requires BSR Infrastructure **Challenges:** ❌ Requires constant internet access OR expensive private BSR ❌ Complex infrastructure for private deployments ❌ All modules must be re-published to private registry ❌ Addi","content":"Buf: Requires BSR Infrastructure **Challenges:** ❌ Requires constant internet access OR expensive private BSR ❌ Complex infrastructure for private deployments ❌ All modules must be re-published to private registry ❌ Additional operational overhead"},{"id":"cli/package-manager/easyp-vs-buf::easyp-direct-control::21","title":"EasyP vs Buf Package Management","section":"EasyP: Direct Control","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-direct-control","headings":["EasyP: Direct Control"],"excerpt":"EasyP: Direct Control ```yaml Full control over dependency sources deps: # Public repository - your choice of version - github.com/googleapis/googleapis@common-protos-1_3_1","content":"EasyP: Direct Control ```yaml Full control over dependency sources deps: # Public repository - your choice of version - github.com/googleapis/googleapis@common-protos-1_3_1"},{"id":"cli/package-manager/easyp-vs-buf::easyp-direct-control::22","title":"EasyP vs Buf Package Management","section":"EasyP: Direct Control","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-direct-control","headings":["EasyP: Direct Control"],"excerpt":"EasyP: Direct Control Internal repository - complete control - gitlab.company.com/security/validated-protos@v1.0.0","content":"EasyP: Direct Control Internal repository - complete control - gitlab.company.com/security/validated-protos@v1.0.0"},{"id":"cli/package-manager/easyp-vs-buf::easyp-direct-control::23","title":"EasyP vs Buf Package Management","section":"EasyP: Direct Control","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-direct-control","headings":["EasyP: Direct Control"],"excerpt":"EasyP: Direct Control Specific commit for security fix - github.com/bufbuild/protoc-gen-validate@abc123def456 ```","content":"EasyP: Direct Control Specific commit for security fix - github.com/bufbuild/protoc-gen-validate@abc123def456 ```"},{"id":"cli/package-manager/easyp-vs-buf::easyp-direct-control::24","title":"EasyP vs Buf Package Management","section":"EasyP: Direct Control","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-direct-control","headings":["EasyP: Direct Control"],"excerpt":"EasyP: Direct Control **Security advantages:** ✅ **No intermediary** - direct from source repository ✅ **Audit trail** - Git commit history is the source of truth ✅ **Cannot be \"banned\"** - no external party can revoke a","content":"EasyP: Direct Control **Security advantages:** ✅ **No intermediary** - direct from source repository ✅ **Audit trail** - Git commit history is the source of truth ✅ **Cannot be \"banned\"** - no external party can revoke access ✅ **Custom validation** - implement your own security scanning ✅ **Fork protection** - easily fork and maintain dependencies"},{"id":"cli/package-manager/easyp-vs-buf::buf-registry-dependency::25","title":"EasyP vs Buf Package Management","section":"Buf: Registry Dependency","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-registry-dependency","headings":["Buf: Registry Dependency"],"excerpt":"Buf: Registry Dependency **Security considerations:** ⚠️ **Intermediary risk** - BSR controls what's available ⚠️ **Account suspension** - Could lose access to dependencies ⚠️ **Module removal** - Modules can be deleted ","content":"Buf: Registry Dependency **Security considerations:** ⚠️ **Intermediary risk** - BSR controls what's available ⚠️ **Account suspension** - Could lose access to dependencies ⚠️ **Module removal** - Modules can be deleted from registry ⚠️ **Update policies** - BSR may force updates or deprecations ⚠️ **Third-party trust** - Must trust Buf's security practices"},{"id":"cli/package-manager/easyp-vs-buf::scenario-1-startup-with-public-dependencies::26","title":"EasyP vs Buf Package Management","section":"Scenario 1: Startup with Public Dependencies","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-1-startup-with-public-dependencies","headings":["Scenario 1: Startup with Public Dependencies"],"excerpt":"Scenario 1: Startup with Public Dependencies **EasyP Approach:**","content":"Scenario 1: Startup with Public Dependencies **EasyP Approach:**"},{"id":"cli/package-manager/easyp-vs-buf::scenario-1-startup-with-public-dependencies::27","title":"EasyP vs Buf Package Management","section":"Scenario 1: Startup with Public Dependencies","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-1-startup-with-public-dependencies","headings":["Scenario 1: Startup with Public Dependencies"],"excerpt":"Scenario 1: Startup with Public Dependencies **Buf Approach:**","content":"Scenario 1: Startup with Public Dependencies **Buf Approach:**"},{"id":"cli/package-manager/easyp-vs-buf::scenario-1-startup-with-public-dependencies::28","title":"EasyP vs Buf Package Management","section":"Scenario 1: Startup with Public Dependencies","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-1-startup-with-public-dependencies","headings":["Scenario 1: Startup with Public Dependencies"],"excerpt":"Scenario 1: Startup with Public Dependencies **Winner**: Tie - both work well for public dependencies","content":"Scenario 1: Startup with Public Dependencies **Winner**: Tie - both work well for public dependencies"},{"id":"cli/package-manager/easyp-vs-buf::scenario-2-enterprise-with-mixed-publicprivate-dependencies::29","title":"EasyP vs Buf Package Management","section":"Scenario 2: Enterprise with Mixed Public/Private Dependencies","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-2-enterprise-with-mixed-publicprivate-dependencies","headings":["Scenario 2: Enterprise with Mixed Public/Private Dependencies"],"excerpt":"Scenario 2: Enterprise with Mixed Public/Private Dependencies **EasyP Approach:** ```yaml deps: # Public - github.com/googleapis/googleapis@v1.2.3","content":"Scenario 2: Enterprise with Mixed Public/Private Dependencies **EasyP Approach:** ```yaml deps: # Public - github.com/googleapis/googleapis@v1.2.3"},{"id":"cli/package-manager/easyp-vs-buf::scenario-2-enterprise-with-mixed-publicprivate-dependencies::30","title":"EasyP vs Buf Package Management","section":"Scenario 2: Enterprise with Mixed Public/Private Dependencies","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-2-enterprise-with-mixed-publicprivate-dependencies","headings":["Scenario 2: Enterprise with Mixed Public/Private Dependencies"],"excerpt":"Scenario 2: Enterprise with Mixed Public/Private Dependencies Private (existing Git repos) - github.com/mycompany/auth-protos@v2.0.0 - gitlab.enterprise.com/platform/shared-types@v1.5.1 ```","content":"Scenario 2: Enterprise with Mixed Public/Private Dependencies Private (existing Git repos) - github.com/mycompany/auth-protos@v2.0.0 - gitlab.enterprise.com/platform/shared-types@v1.5.1 ```"},{"id":"cli/package-manager/easyp-vs-buf::scenario-2-enterprise-with-mixed-publicprivate-dependencies::31","title":"EasyP vs Buf Package Management","section":"Scenario 2: Enterprise with Mixed Public/Private Dependencies","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-2-enterprise-with-mixed-publicprivate-dependencies","headings":["Scenario 2: Enterprise with Mixed Public/Private Dependencies"],"excerpt":"Scenario 2: Enterprise with Mixed Public/Private Dependencies **Buf Approach:**","content":"Scenario 2: Enterprise with Mixed Public/Private Dependencies **Buf Approach:**"},{"id":"cli/package-manager/easyp-vs-buf::scenario-2-enterprise-with-mixed-publicprivate-dependencies::32","title":"EasyP vs Buf Package Management","section":"Scenario 2: Enterprise with Mixed Public/Private Dependencies","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-2-enterprise-with-mixed-publicprivate-dependencies","headings":["Scenario 2: Enterprise with Mixed Public/Private Dependencies"],"excerpt":"Scenario 2: Enterprise with Mixed Public/Private Dependencies **Winner**: **EasyP** - no additional setup for private repos","content":"Scenario 2: Enterprise with Mixed Public/Private Dependencies **Winner**: **EasyP** - no additional setup for private repos"},{"id":"cli/package-manager/easyp-vs-buf::scenario-3-governmentdefense-contractor-air-gapped::33","title":"EasyP vs Buf Package Management","section":"Scenario 3: Government/Defense Contractor (Air-Gapped)","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-3-governmentdefense-contractor-air-gapped","headings":["Scenario 3: Government/Defense Contractor (Air-Gapped)"],"excerpt":"Scenario 3: Government/Defense Contractor (Air-Gapped) **EasyP Approach:** ```bash Internet-connected environment easyp mod vendor","content":"Scenario 3: Government/Defense Contractor (Air-Gapped) **EasyP Approach:** ```bash Internet-connected environment easyp mod vendor"},{"id":"cli/package-manager/easyp-vs-buf::scenario-3-governmentdefense-contractor-air-gapped::34","title":"EasyP vs Buf Package Management","section":"Scenario 3: Government/Defense Contractor (Air-Gapped)","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-3-governmentdefense-contractor-air-gapped","headings":["Scenario 3: Government/Defense Contractor (Air-Gapped)"],"excerpt":"Scenario 3: Government/Defense Contractor (Air-Gapped) Transfer to classified environment Works immediately without any external dependencies ```","content":"Scenario 3: Government/Defense Contractor (Air-Gapped) Transfer to classified environment Works immediately without any external dependencies ```"},{"id":"cli/package-manager/easyp-vs-buf::scenario-3-governmentdefense-contractor-air-gapped::35","title":"EasyP vs Buf Package Management","section":"Scenario 3: Government/Defense Contractor (Air-Gapped)","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-3-governmentdefense-contractor-air-gapped","headings":["Scenario 3: Government/Defense Contractor (Air-Gapped)"],"excerpt":"Scenario 3: Government/Defense Contractor (Air-Gapped) **Buf Approach:**","content":"Scenario 3: Government/Defense Contractor (Air-Gapped) **Buf Approach:**"},{"id":"cli/package-manager/easyp-vs-buf::scenario-3-governmentdefense-contractor-air-gapped::36","title":"EasyP vs Buf Package Management","section":"Scenario 3: Government/Defense Contractor (Air-Gapped)","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-3-governmentdefense-contractor-air-gapped","headings":["Scenario 3: Government/Defense Contractor (Air-Gapped)"],"excerpt":"Scenario 3: Government/Defense Contractor (Air-Gapped) **Winner**: **EasyP** - significantly simpler air-gap deployment","content":"Scenario 3: Government/Defense Contractor (Air-Gapped) **Winner**: **EasyP** - significantly simpler air-gap deployment"},{"id":"cli/package-manager/easyp-vs-buf::scenario-4-compliance-and-auditing::37","title":"EasyP vs Buf Package Management","section":"Scenario 4: Compliance and Auditing","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-4-compliance-and-auditing","headings":["Scenario 4: Compliance and Auditing"],"excerpt":"Scenario 4: Compliance and Auditing **EasyP Approach:** ✅ **Direct audit trail**: Git commits show exact changes ✅ **Compliance-friendly**: No external dependencies in production ✅ **Reproducible**: Lock files pin exact ","content":"Scenario 4: Compliance and Auditing **EasyP Approach:** ✅ **Direct audit trail**: Git commits show exact changes ✅ **Compliance-friendly**: No external dependencies in production ✅ **Reproducible**: Lock files pin exact Git commits ✅ **Vulnerability management**: Direct control over security updates"},{"id":"cli/package-manager/easyp-vs-buf::scenario-4-compliance-and-auditing::38","title":"EasyP vs Buf Package Management","section":"Scenario 4: Compliance and Auditing","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-4-compliance-and-auditing","headings":["Scenario 4: Compliance and Auditing"],"excerpt":"Scenario 4: Compliance and Auditing **Buf Approach:** ⚠️ **Registry dependency**: Must audit BSR's security practices ⚠️ **Third-party risk**: BSR is part of your compliance scope ⚠️ **Limited control**: Cannot control w","content":"Scenario 4: Compliance and Auditing **Buf Approach:** ⚠️ **Registry dependency**: Must audit BSR's security practices ⚠️ **Third-party risk**: BSR is part of your compliance scope ⚠️ **Limited control**: Cannot control when modules are updated/removed ⚠️ **Audit complexity**: Must trace registry → Git → actual code"},{"id":"cli/package-manager/easyp-vs-buf::scenario-4-compliance-and-auditing::39","title":"EasyP vs Buf Package Management","section":"Scenario 4: Compliance and Auditing","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-4-compliance-and-auditing","headings":["Scenario 4: Compliance and Auditing"],"excerpt":"Scenario 4: Compliance and Auditing **Winner**: **EasyP** - cleaner compliance story","content":"Scenario 4: Compliance and Auditing **Winner**: **EasyP** - cleaner compliance story"},{"id":"cli/package-manager/easyp-vs-buf::easyp-zero-additional-infrastructure::40","title":"EasyP vs Buf Package Management","section":"EasyP: Zero Additional Infrastructure","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-zero-additional-infrastructure","headings":["EasyP: Zero Additional Infrastructure"],"excerpt":"EasyP: Zero Additional Infrastructure **Costs:** ✅ **$0** - Uses existing Git infrastructure ✅ **No additional servers** to maintain ✅ **No licensing fees** for registry software ✅ **Scales with Git** - proven enterprise","content":"EasyP: Zero Additional Infrastructure **Costs:** ✅ **$0** - Uses existing Git infrastructure ✅ **No additional servers** to maintain ✅ **No licensing fees** for registry software ✅ **Scales with Git** - proven enterprise scalability"},{"id":"cli/package-manager/easyp-vs-buf::easyp-zero-additional-infrastructure::41","title":"EasyP vs Buf Package Management","section":"EasyP: Zero Additional Infrastructure","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-zero-additional-infrastructure","headings":["EasyP: Zero Additional Infrastructure"],"excerpt":"EasyP: Zero Additional Infrastructure **Infrastructure:** Uses existing Git repositories (GitHub, GitLab, etc.) Leverages existing authentication systems No additional backup/disaster recovery needed","content":"EasyP: Zero Additional Infrastructure **Infrastructure:** Uses existing Git repositories (GitHub, GitLab, etc.) Leverages existing authentication systems No additional backup/disaster recovery needed"},{"id":"cli/package-manager/easyp-vs-buf::buf-registry-infrastructure-costs::42","title":"EasyP vs Buf Package Management","section":"Buf: Registry Infrastructure Costs","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-registry-infrastructure-costs","headings":["Buf: Registry Infrastructure Costs"],"excerpt":"Buf: Registry Infrastructure Costs **BSR Hosted (buf.build):** ✅ Free tier available ❌ Paid plans for private modules and teams ❌ Subject to external pricing changes ❌ Data locality concerns for some enterprises","content":"Buf: Registry Infrastructure Costs **BSR Hosted (buf.build):** ✅ Free tier available ❌ Paid plans for private modules and teams ❌ Subject to external pricing changes ❌ Data locality concerns for some enterprises"},{"id":"cli/package-manager/easyp-vs-buf::buf-registry-infrastructure-costs::43","title":"EasyP vs Buf Package Management","section":"Buf: Registry Infrastructure Costs","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-registry-infrastructure-costs","headings":["Buf: Registry Infrastructure Costs"],"excerpt":"Buf: Registry Infrastructure Costs **Private BSR Deployment:** ❌ Significant infrastructure costs (servers, databases, load balancers) ❌ Operational overhead (monitoring, updates, backups) ❌ Licensing costs for enterpris","content":"Buf: Registry Infrastructure Costs **Private BSR Deployment:** ❌ Significant infrastructure costs (servers, databases, load balancers) ❌ Operational overhead (monitoring, updates, backups) ❌ Licensing costs for enterprise features ❌ Additional disaster recovery planning"},{"id":"cli/package-manager/easyp-vs-buf::easyp-no-lock-in::44","title":"EasyP vs Buf Package Management","section":"EasyP: No Lock-in","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-no-lock-in","headings":["EasyP: No Lock-in"],"excerpt":"EasyP: No Lock-in **Migration FROM EasyP:**","content":"EasyP: No Lock-in **Migration FROM EasyP:**"},{"id":"cli/package-manager/easyp-vs-buf::easyp-no-lock-in::45","title":"EasyP vs Buf Package Management","section":"EasyP: No Lock-in","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-no-lock-in","headings":["EasyP: No Lock-in"],"excerpt":"EasyP: No Lock-in **Migration TO EasyP:**","content":"EasyP: No Lock-in **Migration TO EasyP:**"},{"id":"cli/package-manager/easyp-vs-buf::buf-potential-lock-in::46","title":"EasyP vs Buf Package Management","section":"Buf: Potential Lock-in","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-potential-lock-in","headings":["Buf: Potential Lock-in"],"excerpt":"Buf: Potential Lock-in **Migration FROM Buf:** ❌ Must identify original Git repositories for each BSR module ❌ BSR-specific module names don't translate directly ❌ May lose version history and metadata ❌ Complex if heavi","content":"Buf: Potential Lock-in **Migration FROM Buf:** ❌ Must identify original Git repositories for each BSR module ❌ BSR-specific module names don't translate directly ❌ May lose version history and metadata ❌ Complex if heavily integrated with BSR ecosystem"},{"id":"cli/package-manager/easyp-vs-buf::buf-potential-lock-in::47","title":"EasyP vs Buf Package Management","section":"Buf: Potential Lock-in","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-potential-lock-in","headings":["Buf: Potential Lock-in"],"excerpt":"Buf: Potential Lock-in **Migration TO Buf:** ❌ Must publish all dependencies to BSR first ❌ Cannot reference Git repositories directly ❌ Must adopt BSR workflow and tooling","content":"Buf: Potential Lock-in **Migration TO Buf:** ❌ Must publish all dependencies to BSR first ❌ Cannot reference Git repositories directly ❌ Must adopt BSR workflow and tooling"},{"id":"cli/package-manager/easyp-vs-buf::choose-easyp-when::48","title":"EasyP vs Buf Package Management","section":"Choose EasyP When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-easyp-when","headings":["Choose EasyP When:"],"excerpt":"Choose EasyP When: ✅ **Enterprise/Air-gapped environments** Need to work without external dependencies Strict compliance requirements Air-gapped or classified networks","content":"Choose EasyP When: ✅ **Enterprise/Air-gapped environments** Need to work without external dependencies Strict compliance requirements Air-gapped or classified networks"},{"id":"cli/package-manager/easyp-vs-buf::choose-easyp-when::49","title":"EasyP vs Buf Package Management","section":"Choose EasyP When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-easyp-when","headings":["Choose EasyP When:"],"excerpt":"Choose EasyP When: ✅ **Security-first organizations** Want direct control over dependency sources Need to audit entire supply chain Concerned about third-party service risks","content":"Choose EasyP When: ✅ **Security-first organizations** Want direct control over dependency sources Need to audit entire supply chain Concerned about third-party service risks"},{"id":"cli/package-manager/easyp-vs-buf::choose-easyp-when::50","title":"EasyP vs Buf Package Management","section":"Choose EasyP When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-easyp-when","headings":["Choose EasyP When:"],"excerpt":"Choose EasyP When: ✅ **Existing Git-heavy workflows** Team already comfortable with Git Extensive private repository usage Want to minimize new tools/infrastructure","content":"Choose EasyP When: ✅ **Existing Git-heavy workflows** Team already comfortable with Git Extensive private repository usage Want to minimize new tools/infrastructure"},{"id":"cli/package-manager/easyp-vs-buf::choose-easyp-when::51","title":"EasyP vs Buf Package Management","section":"Choose EasyP When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-easyp-when","headings":["Choose EasyP When:"],"excerpt":"Choose EasyP When: ✅ **Cost-sensitive projects** Want to avoid additional licensing costs Don't want infrastructure overhead Need predictable, zero-cost scaling","content":"Choose EasyP When: ✅ **Cost-sensitive projects** Want to avoid additional licensing costs Don't want infrastructure overhead Need predictable, zero-cost scaling"},{"id":"cli/package-manager/easyp-vs-buf::choose-easyp-when::52","title":"EasyP vs Buf Package Management","section":"Choose EasyP When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-easyp-when","headings":["Choose EasyP When:"],"excerpt":"Choose EasyP When: ✅ **Mixed public/private dependencies** Heavy use of internal Git repositories Don't want to republish existing repos Need flexibility in dependency sources","content":"Choose EasyP When: ✅ **Mixed public/private dependencies** Heavy use of internal Git repositories Don't want to republish existing repos Need flexibility in dependency sources"},{"id":"cli/package-manager/easyp-vs-buf::choose-buf-when::53","title":"EasyP vs Buf Package Management","section":"Choose Buf When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-buf-when","headings":["Choose Buf When:"],"excerpt":"Choose Buf When: ✅ **Heavy BSR ecosystem usage** Already invested in Buf tooling (lint, breaking changes, generation) Want curated, high-quality modules Benefit from BSR's rich metadata and docs","content":"Choose Buf When: ✅ **Heavy BSR ecosystem usage** Already invested in Buf tooling (lint, breaking changes, generation) Want curated, high-quality modules Benefit from BSR's rich metadata and docs"},{"id":"cli/package-manager/easyp-vs-buf::choose-buf-when::54","title":"EasyP vs Buf Package Management","section":"Choose Buf When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-buf-when","headings":["Choose Buf When:"],"excerpt":"Choose Buf When: ✅ **Collaborative development** Need dependency graph visualization Want centralized module discovery Benefit from BSR's collaboration features","content":"Choose Buf When: ✅ **Collaborative development** Need dependency graph visualization Want centralized module discovery Benefit from BSR's collaboration features"},{"id":"cli/package-manager/easyp-vs-buf::choose-buf-when::55","title":"EasyP vs Buf Package Management","section":"Choose Buf When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-buf-when","headings":["Choose Buf When:"],"excerpt":"Choose Buf When: ✅ **Simple public-only dependencies** Primarily use well-known public modules Don't mind BSR dependency Value the curated module experience","content":"Choose Buf When: ✅ **Simple public-only dependencies** Primarily use well-known public modules Don't mind BSR dependency Value the curated module experience"},{"id":"cli/package-manager/easyp-vs-buf::choose-buf-when::56","title":"EasyP vs Buf Package Management","section":"Choose Buf When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-buf-when","headings":["Choose Buf When:"],"excerpt":"Choose Buf When: ✅ **Team new to protobuf** Benefit from BSR's documentation and examples Want guided module discovery Prefer opinionated, structured approach","content":"Choose Buf When: ✅ **Team new to protobuf** Benefit from BSR's documentation and examples Want guided module discovery Prefer opinionated, structured approach"},{"id":"cli/package-manager/easyp-vs-buf::migrating-from-buf-to-easyp::57","title":"EasyP vs Buf Package Management","section":"Migrating from Buf to EasyP","path":"/docs/guide/cli/package-manager/easyp-vs-buf#migrating-from-buf-to-easyp","headings":["Migrating from Buf to EasyP"],"excerpt":"Migrating from Buf to EasyP **Identify source repositories** for each BSR module **Map BSR modules** to Git repository references **Update configuration** to use Git URLs **Test compatibility** and resolve any issues","content":"Migrating from Buf to EasyP **Identify source repositories** for each BSR module **Map BSR modules** to Git repository references **Update configuration** to use Git URLs **Test compatibility** and resolve any issues"},{"id":"cli/package-manager/easyp-vs-buf::migrating-from-buf-to-easyp::58","title":"EasyP vs Buf Package Management","section":"Migrating from Buf to EasyP","path":"/docs/guide/cli/package-manager/easyp-vs-buf#migrating-from-buf-to-easyp","headings":["Migrating from Buf to EasyP"],"excerpt":"Migrating from Buf to EasyP Example migration: ```yaml Before (buf.yaml) deps: - buf.build/googleapis/googleapis - buf.build/grpc/grpc","content":"Migrating from Buf to EasyP Example migration: ```yaml Before (buf.yaml) deps: - buf.build/googleapis/googleapis - buf.build/grpc/grpc"},{"id":"cli/package-manager/easyp-vs-buf::migrating-from-buf-to-easyp::59","title":"EasyP vs Buf Package Management","section":"Migrating from Buf to EasyP","path":"/docs/guide/cli/package-manager/easyp-vs-buf#migrating-from-buf-to-easyp","headings":["Migrating from Buf to EasyP"],"excerpt":"Migrating from Buf to EasyP After (easyp.yaml) deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc/grpc@v1.50.0 ```","content":"Migrating from Buf to EasyP After (easyp.yaml) deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc/grpc@v1.50.0 ```"},{"id":"cli/package-manager/easyp-vs-buf::migrating-from-easyp-to-buf::60","title":"EasyP vs Buf Package Management","section":"Migrating from EasyP to Buf","path":"/docs/guide/cli/package-manager/easyp-vs-buf#migrating-from-easyp-to-buf","headings":["Migrating from EasyP to Buf"],"excerpt":"Migrating from EasyP to Buf **Publish modules** to BSR (if not already available) **Create BSR account** and configure authentication **Update configuration** to reference BSR modules **Adopt BSR workflow** (push, pull, ","content":"Migrating from EasyP to Buf **Publish modules** to BSR (if not already available) **Create BSR account** and configure authentication **Update configuration** to reference BSR modules **Adopt BSR workflow** (push, pull, etc.)"},{"id":"cli/package-manager/easyp-vs-buf::conclusion::61","title":"EasyP vs Buf Package Management","section":"Conclusion","path":"/docs/guide/cli/package-manager/easyp-vs-buf#conclusion","headings":["Conclusion"],"excerpt":"Conclusion Both EasyP and Buf offer valid approaches to protobuf dependency management, but they serve different needs:","content":"Conclusion Both EasyP and Buf offer valid approaches to protobuf dependency management, but they serve different needs:"},{"id":"cli/package-manager/easyp-vs-buf::conclusion::62","title":"EasyP vs Buf Package Management","section":"Conclusion","path":"/docs/guide/cli/package-manager/easyp-vs-buf#conclusion","headings":["Conclusion"],"excerpt":"Conclusion **EasyP excels in:** Enterprise and air-gapped environments Security-conscious organizations Cost-sensitive projects Direct Git repository usage Zero-infrastructure deployments","content":"Conclusion **EasyP excels in:** Enterprise and air-gapped environments Security-conscious organizations Cost-sensitive projects Direct Git repository usage Zero-infrastructure deployments"},{"id":"cli/package-manager/easyp-vs-buf::conclusion::63","title":"EasyP vs Buf Package Management","section":"Conclusion","path":"/docs/guide/cli/package-manager/easyp-vs-buf#conclusion","headings":["Conclusion"],"excerpt":"Conclusion **Buf excels in:** Collaborative, open-source focused teams Organizations wanting curated, high-quality modules Teams new to protobuf ecosystem Projects heavily using BSR features","content":"Conclusion **Buf excels in:** Collaborative, open-source focused teams Organizations wanting curated, high-quality modules Teams new to protobuf ecosystem Projects heavily using BSR features"},{"id":"cli/package-manager/easyp-vs-buf::conclusion::64","title":"EasyP vs Buf Package Management","section":"Conclusion","path":"/docs/guide/cli/package-manager/easyp-vs-buf#conclusion","headings":["Conclusion"],"excerpt":"Conclusion The choice between EasyP and Buf often comes down to your organization's priorities around **control vs. convenience**, **security vs. collaboration features**, and **infrastructure costs vs. managed services*","content":"Conclusion The choice between EasyP and Buf often comes down to your organization's priorities around **control vs. convenience**, **security vs. collaboration features**, and **infrastructure costs vs. managed services**."},{"id":"cli/package-manager/easyp-vs-buf::conclusion::65","title":"EasyP vs Buf Package Management","section":"Conclusion","path":"/docs/guide/cli/package-manager/easyp-vs-buf#conclusion","headings":["Conclusion"],"excerpt":"Conclusion For many enterprise environments, EasyP's decentralized, Git-native approach provides the security, control, and cost-effectiveness needed for production protobuf workflows, while Buf's centralized registry ex","content":"Conclusion For many enterprise environments, EasyP's decentralized, Git-native approach provides the security, control, and cost-effectiveness needed for production protobuf workflows, while Buf's centralized registry excels in collaborative, open-source focused development environments."},{"id":"cli/package-manager/package-manager::top::0","title":"Package Manager","path":"/docs/guide/cli/package-manager/package-manager","headings":[],"excerpt":"EasyP provides a powerful package manager for protobuf dependencies that simplifies dependency management through a decentralized, Git-based approach. Unlike centralized solutions, EasyP works directly with Git repositor","content":"EasyP provides a powerful package manager for protobuf dependencies that simplifies dependency management through a decentralized, Git-based approach. Unlike centralized solutions, EasyP works directly with Git repositories, giving you complete control over your dependencies."},{"id":"cli/package-manager/package-manager::overview::1","title":"Package Manager","section":"Overview","path":"/docs/guide/cli/package-manager/package-manager#overview","headings":["Overview"],"excerpt":"Overview The EasyP package manager follows the **Go modules philosophy** - any Git repository can serve as a package source. This approach provides several key advantages:","content":"Overview The EasyP package manager follows the **Go modules philosophy** - any Git repository can serve as a package source. This approach provides several key advantages:"},{"id":"cli/package-manager/package-manager::overview::2","title":"Package Manager","section":"Overview","path":"/docs/guide/cli/package-manager/package-manager#overview","headings":["Overview"],"excerpt":"Overview **Decentralized**: No single point of failure or control **Security**: Direct access to source repositories **Flexibility**: Support for public, private, and enterprise repositories **Reproducibility**: Lock fil","content":"Overview **Decentralized**: No single point of failure or control **Security**: Direct access to source repositories **Flexibility**: Support for public, private, and enterprise repositories **Reproducibility**: Lock files ensure consistent builds across environments **Performance**: Local caching minimizes network requests"},{"id":"cli/package-manager/package-manager::key-features::3","title":"Package Manager","section":"Key Features","path":"/docs/guide/cli/package-manager/package-manager#key-features","headings":["Key Features"],"excerpt":"Key Features Feature Description --------- ------------- **Git-Native** Works with any Git repository - no special server required **Multiple Version Formats** Tags, commits, pseudo-versions, latest **Lock Files** Reprod","content":"Key Features Feature Description --------- ------------- **Git-Native** Works with any Git repository - no special server required **Multiple Version Formats** Tags, commits, pseudo-versions, latest **Lock Files** Reproducible builds with easyp.lock **Local Caching** Go modules-style cache architecture **Vendoring Support** Copy dependencies locally for offline builds **YAML Configuration** Simple, readable dependency declarations"},{"id":"cli/package-manager/package-manager::architecture::4","title":"Package Manager","section":"Architecture","path":"/docs/guide/cli/package-manager/package-manager#architecture","headings":["Architecture"],"excerpt":"Architecture EasyP uses a two-tier caching system inspired by Go modules:","content":"Architecture EasyP uses a two-tier caching system inspired by Go modules:"},{"id":"cli/package-manager/package-manager::cache-location::5","title":"Package Manager","section":"Cache Location","path":"/docs/guide/cli/package-manager/package-manager#cache-location","headings":["Cache Location"],"excerpt":"Cache Location Environment Location How to Set ------------- ---------- ------------ **Default** $HOME/.easyp Automatic **Custom** Any directory Set EASYPPATH environment variable **CI/CD** Project-relative export EASYPP","content":"Cache Location Environment Location How to Set ------------- ---------- ------------ **Default** $HOME/.easyp Automatic **Custom** Any directory Set EASYPPATH environment variable **CI/CD** Project-relative export EASYPPATH=$CI_PROJECT_DIR/.easyp"},{"id":"cli/package-manager/package-manager::basic-configuration::6","title":"Package Manager","section":"Basic Configuration","path":"/docs/guide/cli/package-manager/package-manager#basic-configuration","headings":["Basic Configuration"],"excerpt":"Basic Configuration Configure dependencies in your easyp.yaml file:","content":"Basic Configuration Configure dependencies in your easyp.yaml file:"},{"id":"cli/package-manager/package-manager::advanced-configuration-examples::7","title":"Package Manager","section":"Advanced Configuration Examples","path":"/docs/guide/cli/package-manager/package-manager#advanced-configuration-examples","headings":["Advanced Configuration Examples"],"excerpt":"Advanced Configuration Examples","content":"Advanced Configuration Examples"},{"id":"cli/package-manager/package-manager::multi-environment-setup::8","title":"Package Manager","section":"Multi-Environment Setup","path":"/docs/guide/cli/package-manager/package-manager#multi-environment-setup","headings":["Multi-Environment Setup"],"excerpt":"Multi-Environment Setup ```yaml development.easyp.yaml deps: - github.com/googleapis/googleapis # Latest for development - github.com/mycompany/internal-protos # Latest internal changes - github.com/bufbuild/protoc-gen-v","content":"Multi-Environment Setup ```yaml development.easyp.yaml deps: - github.com/googleapis/googleapis # Latest for development - github.com/mycompany/internal-protos # Latest internal changes - github.com/bufbuild/protoc-gen-validate # Latest features"},{"id":"cli/package-manager/package-manager::multi-environment-setup::9","title":"Package Manager","section":"Multi-Environment Setup","path":"/docs/guide/cli/package-manager/package-manager#multi-environment-setup","headings":["Multi-Environment Setup"],"excerpt":"Multi-Environment Setup production.easyp.yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1 # Pinned - github.com/mycompany/internal-protos@v2.1.0 # Stable release - github.com/bufbuild/protoc-gen-validate","content":"Multi-Environment Setup production.easyp.yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1 # Pinned - github.com/mycompany/internal-protos@v2.1.0 # Stable release - github.com/bufbuild/protoc-gen-validate@v0.10.1 # Tested version ```"},{"id":"cli/package-manager/package-manager::private-repository-setup::10","title":"Package Manager","section":"Private Repository Setup","path":"/docs/guide/cli/package-manager/package-manager#private-repository-setup","headings":["Private Repository Setup"],"excerpt":"Private Repository Setup ```yaml deps: # Public dependencies - github.com/googleapis/googleapis@common-protos-1_3_1","content":"Private Repository Setup ```yaml deps: # Public dependencies - github.com/googleapis/googleapis@common-protos-1_3_1"},{"id":"cli/package-manager/package-manager::private-repository-setup::11","title":"Package Manager","section":"Private Repository Setup","path":"/docs/guide/cli/package-manager/package-manager#private-repository-setup","headings":["Private Repository Setup"],"excerpt":"Private Repository Setup Private company repositories - github.com/mycompany/auth-protos@v1.5.0 - github.com/mycompany/common-types@v2.0.1","content":"Private Repository Setup Private company repositories - github.com/mycompany/auth-protos@v1.5.0 - github.com/mycompany/common-types@v2.0.1"},{"id":"cli/package-manager/package-manager::private-repository-setup::12","title":"Package Manager","section":"Private Repository Setup","path":"/docs/guide/cli/package-manager/package-manager#private-repository-setup","headings":["Private Repository Setup"],"excerpt":"Private Repository Setup Internal GitLab - gitlab.company.com/platform/messaging-protos@v0.3.0 ```","content":"Private Repository Setup Internal GitLab - gitlab.company.com/platform/messaging-protos@v0.3.0 ```"},{"id":"cli/package-manager/package-manager::versioning-strategies::13","title":"Package Manager","section":"Versioning Strategies","path":"/docs/guide/cli/package-manager/package-manager#versioning-strategies","headings":["Versioning Strategies"],"excerpt":"Versioning Strategies EasyP supports multiple versioning approaches to fit different development workflows:","content":"Versioning Strategies EasyP supports multiple versioning approaches to fit different development workflows:"},{"id":"cli/package-manager/package-manager::1-semantic-version-tags-recommended-for-production::14","title":"Package Manager","section":"1. Semantic Version Tags (Recommended for Production)","path":"/docs/guide/cli/package-manager/package-manager#1-semantic-version-tags-recommended-for-production","headings":["1. Semantic Version Tags (Recommended for Production)"],"excerpt":"Semantic Version Tags (Recommended for Production)","content":"Semantic Version Tags (Recommended for Production)"},{"id":"cli/package-manager/package-manager::1-semantic-version-tags-recommended-for-production::15","title":"Package Manager","section":"1. Semantic Version Tags (Recommended for Production)","path":"/docs/guide/cli/package-manager/package-manager#1-semantic-version-tags-recommended-for-production","headings":["1. Semantic Version Tags (Recommended for Production)"],"excerpt":"Semantic Version Tags (Recommended for Production) **Use when:** Production deployments Stable API consumption Reproducible builds required","content":"Semantic Version Tags (Recommended for Production) **Use when:** Production deployments Stable API consumption Reproducible builds required"},{"id":"cli/package-manager/package-manager::2-latest-tag-development::16","title":"Package Manager","section":"2. Latest Tag (Development)","path":"/docs/guide/cli/package-manager/package-manager#2-latest-tag-development","headings":["2. Latest Tag (Development)"],"excerpt":"Latest Tag (Development) **Use when:** Active development Want latest features Compatibility testing","content":"Latest Tag (Development) **Use when:** Active development Want latest features Compatibility testing"},{"id":"cli/package-manager/package-manager::3-commit-hashes-bleeding-edge::17","title":"Package Manager","section":"3. Commit Hashes (Bleeding Edge)","path":"/docs/guide/cli/package-manager/package-manager#3-commit-hashes-bleeding-edge","headings":["3. Commit Hashes (Bleeding Edge)"],"excerpt":"Commit Hashes (Bleeding Edge) **Use when:** Need unreleased features Testing specific fixes Contributing to upstream","content":"Commit Hashes (Bleeding Edge) **Use when:** Need unreleased features Testing specific fixes Contributing to upstream"},{"id":"cli/package-manager/package-manager::4-pseudo-versions-automatic::18","title":"Package Manager","section":"4. Pseudo-Versions (Automatic)","path":"/docs/guide/cli/package-manager/package-manager#4-pseudo-versions-automatic","headings":["4. Pseudo-Versions (Automatic)"],"excerpt":"Pseudo-Versions (Automatic) When EasyP can't find a suitable tag, it generates pseudo-versions automatically:","content":"Pseudo-Versions (Automatic) When EasyP can't find a suitable tag, it generates pseudo-versions automatically:"},{"id":"cli/package-manager/package-manager::4-pseudo-versions-automatic::19","title":"Package Manager","section":"4. Pseudo-Versions (Automatic)","path":"/docs/guide/cli/package-manager/package-manager#4-pseudo-versions-automatic","headings":["4. Pseudo-Versions (Automatic)"],"excerpt":"Pseudo-Versions (Automatic) This ensures every commit can be referenced with a version-like identifier.","content":"Pseudo-Versions (Automatic) This ensures every commit can be referenced with a version-like identifier."},{"id":"cli/package-manager/package-manager::easyp-mod-download::20","title":"Package Manager","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download Downloads and installs all dependencies declared in your configuration.","content":"easyp mod download Downloads and installs all dependencies declared in your configuration."},{"id":"cli/package-manager/package-manager::easyp-mod-download::21","title":"Package Manager","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download **What happens:** **Resolves versions**: Converts tags/latest to specific commits **Downloads archives**: Stores .zip files in cache/download **Verifies checksums**: Ensures archive integrity **Extract","content":"easyp mod download **What happens:** **Resolves versions**: Converts tags/latest to specific commits **Downloads archives**: Stores .zip files in cache/download **Verifies checksums**: Ensures archive integrity **Extracts modules**: Unpacks to cache/mod with proper structure **Updates lock file**: Records exact versions and content hashes"},{"id":"cli/package-manager/package-manager::easyp-mod-download::22","title":"Package Manager","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download **Usage:** ```bash Use default easyp.yaml easyp mod download","content":"easyp mod download **Usage:** ```bash Use default easyp.yaml easyp mod download"},{"id":"cli/package-manager/package-manager::easyp-mod-download::23","title":"Package Manager","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download Use custom config file easyp --cfg production.easyp.yaml mod download","content":"easyp mod download Use custom config file easyp --cfg production.easyp.yaml mod download"},{"id":"cli/package-manager/package-manager::easyp-mod-download::24","title":"Package Manager","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download With custom cache location EASYPPATH=/tmp/easyp-cache easyp mod download ```","content":"easyp mod download With custom cache location EASYPPATH=/tmp/easyp-cache easyp mod download ```"},{"id":"cli/package-manager/package-manager::easyp-mod-download::25","title":"Package Manager","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download **Example output:**","content":"easyp mod download **Example output:**"},{"id":"cli/package-manager/package-manager::easyp-mod-vendor::26","title":"Package Manager","section":"easyp mod vendor","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor Copies all installed proto files to a local easyp_vendor/ directory for offline usage.","content":"easyp mod vendor Copies all installed proto files to a local easyp_vendor/ directory for offline usage."},{"id":"cli/package-manager/package-manager::easyp-mod-vendor::27","title":"Package Manager","section":"easyp mod vendor","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor **Use cases:** **Docker builds**: Avoid network dependencies in containers **Air-gapped environments**: No internet access during builds **Reproducible builds**: Bundle exact dependency versions **Perfor","content":"easyp mod vendor **Use cases:** **Docker builds**: Avoid network dependencies in containers **Air-gapped environments**: No internet access during builds **Reproducible builds**: Bundle exact dependency versions **Performance**: Eliminate network latency in repeated builds"},{"id":"cli/package-manager/package-manager::easyp-mod-vendor::28","title":"Package Manager","section":"easyp mod vendor","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor **Result structure:**","content":"easyp mod vendor **Result structure:**"},{"id":"cli/package-manager/package-manager::easyp-mod-update::29","title":"Package Manager","section":"easyp mod update","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-update","headings":["easyp mod update"],"excerpt":"easyp mod update Updates module versions based on current configuration and writes resolved versions to the lock file.","content":"easyp mod update Updates module versions based on current configuration and writes resolved versions to the lock file."},{"id":"cli/package-manager/package-manager::easyp-mod-update::30","title":"Package Manager","section":"easyp mod update","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-update","headings":["easyp mod update"],"excerpt":"easyp mod update **Behavior:** Respects version constraints in easyp.yaml Updates to latest compatible versions Regenerates easyp.lock with new versions and hashes","content":"easyp mod update **Behavior:** Respects version constraints in easyp.yaml Updates to latest compatible versions Regenerates easyp.lock with new versions and hashes"},{"id":"cli/package-manager/package-manager::lock-files::31","title":"Package Manager","section":"Lock Files","path":"/docs/guide/cli/package-manager/package-manager#lock-files","headings":["Lock Files"],"excerpt":"Lock Files The easyp.lock file ensures reproducible builds by recording exact versions and content hashes:","content":"Lock Files The easyp.lock file ensures reproducible builds by recording exact versions and content hashes:"},{"id":"cli/package-manager/package-manager::lock-file-format::32","title":"Package Manager","section":"Lock File Format","path":"/docs/guide/cli/package-manager/package-manager#lock-file-format","headings":["Lock File Format"],"excerpt":"Lock File Format Each line contains three components: **Module path**: Full repository path **Exact version**: Resolved version (tag or pseudo-version) **Content hash**: SHA256 of extracted content (h1: prefix)","content":"Lock File Format Each line contains three components: **Module path**: Full repository path **Exact version**: Resolved version (tag or pseudo-version) **Content hash**: SHA256 of extracted content (h1: prefix)"},{"id":"cli/package-manager/package-manager::best-practices::33","title":"Package Manager","section":"Best Practices","path":"/docs/guide/cli/package-manager/package-manager#best-practices","headings":["Best Practices"],"excerpt":"Best Practices ✅ **Always commit easyp.lock** - Ensures team consistency ✅ **Run mod update deliberately** - Don't auto-update in CI ✅ **Review lock changes** - Understand what's being updated ❌ **Don't edit manually** -","content":"Best Practices ✅ **Always commit easyp.lock** - Ensures team consistency ✅ **Run mod update deliberately** - Don't auto-update in CI ✅ **Review lock changes** - Understand what's being updated ❌ **Don't edit manually** - Let EasyP manage the format"},{"id":"cli/package-manager/package-manager::public-repositories::34","title":"Package Manager","section":"Public Repositories","path":"/docs/guide/cli/package-manager/package-manager#public-repositories","headings":["Public Repositories"],"excerpt":"Public Repositories No setup required - works out of the box:","content":"Public Repositories No setup required - works out of the box:"},{"id":"cli/package-manager/package-manager::ssh-keys-recommended::35","title":"Package Manager","section":"SSH Keys (Recommended)","path":"/docs/guide/cli/package-manager/package-manager#ssh-keys-recommended","headings":["SSH Keys (Recommended)"],"excerpt":"SSH Keys (Recommended) Configure Git to use SSH for GitHub/GitLab:","content":"SSH Keys (Recommended) Configure Git to use SSH for GitHub/GitLab:"},{"id":"cli/package-manager/package-manager::ssh-keys-recommended::36","title":"Package Manager","section":"SSH Keys (Recommended)","path":"/docs/guide/cli/package-manager/package-manager#ssh-keys-recommended","headings":["SSH Keys (Recommended)"],"excerpt":"SSH Keys (Recommended) ```bash For GitHub git config --global url.\"git@github.com:\".insteadOf \"https://github.com/\"","content":"SSH Keys (Recommended) ```bash For GitHub git config --global url.\"git@github.com:\".insteadOf \"https://github.com/\""},{"id":"cli/package-manager/package-manager::ssh-keys-recommended::37","title":"Package Manager","section":"SSH Keys (Recommended)","path":"/docs/guide/cli/package-manager/package-manager#ssh-keys-recommended","headings":["SSH Keys (Recommended)"],"excerpt":"SSH Keys (Recommended) For GitLab git config --global url.\"git@gitlab.com:\".insteadOf \"https://gitlab.com/\"","content":"SSH Keys (Recommended) For GitLab git config --global url.\"git@gitlab.com:\".insteadOf \"https://gitlab.com/\""},{"id":"cli/package-manager/package-manager::ssh-keys-recommended::38","title":"Package Manager","section":"SSH Keys (Recommended)","path":"/docs/guide/cli/package-manager/package-manager#ssh-keys-recommended","headings":["SSH Keys (Recommended)"],"excerpt":"SSH Keys (Recommended) For custom domains git config --global url.\"git@gitlab.company.com:\".insteadOf \"https://gitlab.company.com/\" ```","content":"SSH Keys (Recommended) For custom domains git config --global url.\"git@gitlab.company.com:\".insteadOf \"https://gitlab.company.com/\" ```"},{"id":"cli/package-manager/package-manager::ssh-keys-recommended::39","title":"Package Manager","section":"SSH Keys (Recommended)","path":"/docs/guide/cli/package-manager/package-manager#ssh-keys-recommended","headings":["SSH Keys (Recommended)"],"excerpt":"SSH Keys (Recommended) Then use normal HTTPS URLs in your config:","content":"SSH Keys (Recommended) Then use normal HTTPS URLs in your config:"},{"id":"cli/package-manager/package-manager::personal-access-tokens::40","title":"Package Manager","section":"Personal Access Tokens","path":"/docs/guide/cli/package-manager/package-manager#personal-access-tokens","headings":["Personal Access Tokens"],"excerpt":"Personal Access Tokens For HTTPS authentication:","content":"Personal Access Tokens For HTTPS authentication:"},{"id":"cli/package-manager/package-manager::personal-access-tokens::41","title":"Package Manager","section":"Personal Access Tokens","path":"/docs/guide/cli/package-manager/package-manager#personal-access-tokens","headings":["Personal Access Tokens"],"excerpt":"Personal Access Tokens ```bash Method 1: Credential helper git config --global credential.helper store echo \"https://username:token@github.com\" >> ~/.git-credentials","content":"Personal Access Tokens ```bash Method 1: Credential helper git config --global credential.helper store echo \"https://username:token@github.com\" >> ~/.git-credentials"},{"id":"cli/package-manager/package-manager::personal-access-tokens::42","title":"Package Manager","section":"Personal Access Tokens","path":"/docs/guide/cli/package-manager/package-manager#personal-access-tokens","headings":["Personal Access Tokens"],"excerpt":"Personal Access Tokens Method 2: URL rewriting git config --global url.\"https://username:token@github.com/mycompany\".insteadOf \"https://github.com/mycompany\" ```","content":"Personal Access Tokens Method 2: URL rewriting git config --global url.\"https://username:token@github.com/mycompany\".insteadOf \"https://github.com/mycompany\" ```"},{"id":"cli/package-manager/package-manager::corporate-environments::43","title":"Package Manager","section":"Corporate Environments","path":"/docs/guide/cli/package-manager/package-manager#corporate-environments","headings":["Corporate Environments"],"excerpt":"Corporate Environments ```bash Configure proxy git config --global http.proxy http://proxy.company.com:8080 git config --global https.proxy https://proxy.company.com:8080","content":"Corporate Environments ```bash Configure proxy git config --global http.proxy http://proxy.company.com:8080 git config --global https.proxy https://proxy.company.com:8080"},{"id":"cli/package-manager/package-manager::corporate-environments::44","title":"Package Manager","section":"Corporate Environments","path":"/docs/guide/cli/package-manager/package-manager#corporate-environments","headings":["Corporate Environments"],"excerpt":"Corporate Environments Configure certificates for internal Git servers git config --global http.sslCAInfo /path/to/certificate.pem ```","content":"Corporate Environments Configure certificates for internal Git servers git config --global http.sslCAInfo /path/to/certificate.pem ```"},{"id":"cli/package-manager/package-manager::initial-project-setup::45","title":"Package Manager","section":"Initial Project Setup","path":"/docs/guide/cli/package-manager/package-manager#initial-project-setup","headings":["Initial Project Setup"],"excerpt":"Initial Project Setup ```bash Create configuration cat > easyp.yaml << EOF deps: - github.com/googleapis/googleapis - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 EOF","content":"Initial Project Setup ```bash Create configuration cat > easyp.yaml << EOF deps: - github.com/googleapis/googleapis - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 EOF"},{"id":"cli/package-manager/package-manager::initial-project-setup::46","title":"Package Manager","section":"Initial Project Setup","path":"/docs/guide/cli/package-manager/package-manager#initial-project-setup","headings":["Initial Project Setup"],"excerpt":"Initial Project Setup Download dependencies easyp mod download","content":"Initial Project Setup Download dependencies easyp mod download"},{"id":"cli/package-manager/package-manager::initial-project-setup::47","title":"Package Manager","section":"Initial Project Setup","path":"/docs/guide/cli/package-manager/package-manager#initial-project-setup","headings":["Initial Project Setup"],"excerpt":"Initial Project Setup Verify installation ls ~/.easyp/mod/github.com/googleapis/googleapis/ ```","content":"Initial Project Setup Verify installation ls ~/.easyp/mod/github.com/googleapis/googleapis/ ```"},{"id":"cli/package-manager/package-manager::adding-new-dependencies::48","title":"Package Manager","section":"Adding New Dependencies","path":"/docs/guide/cli/package-manager/package-manager#adding-new-dependencies","headings":["Adding New Dependencies"],"excerpt":"Adding New Dependencies ```bash Edit easyp.yaml echo \" - github.com/bufbuild/protoc-gen-validate@v0.10.1\" >> easyp.yaml","content":"Adding New Dependencies ```bash Edit easyp.yaml echo \" - github.com/bufbuild/protoc-gen-validate@v0.10.1\" >> easyp.yaml"},{"id":"cli/package-manager/package-manager::adding-new-dependencies::49","title":"Package Manager","section":"Adding New Dependencies","path":"/docs/guide/cli/package-manager/package-manager#adding-new-dependencies","headings":["Adding New Dependencies"],"excerpt":"Adding New Dependencies Download new dependency easyp mod download","content":"Adding New Dependencies Download new dependency easyp mod download"},{"id":"cli/package-manager/package-manager::adding-new-dependencies::50","title":"Package Manager","section":"Adding New Dependencies","path":"/docs/guide/cli/package-manager/package-manager#adding-new-dependencies","headings":["Adding New Dependencies"],"excerpt":"Adding New Dependencies Commit lock file changes git add easyp.lock git commit -m \"Add protoc-gen-validate dependency\" ```","content":"Adding New Dependencies Commit lock file changes git add easyp.lock git commit -m \"Add protoc-gen-validate dependency\" ```"},{"id":"cli/package-manager/package-manager::updating-dependencies::51","title":"Package Manager","section":"Updating Dependencies","path":"/docs/guide/cli/package-manager/package-manager#updating-dependencies","headings":["Updating Dependencies"],"excerpt":"Updating Dependencies ```bash Update to latest compatible versions easyp mod update","content":"Updating Dependencies ```bash Update to latest compatible versions easyp mod update"},{"id":"cli/package-manager/package-manager::updating-dependencies::52","title":"Package Manager","section":"Updating Dependencies","path":"/docs/guide/cli/package-manager/package-manager#updating-dependencies","headings":["Updating Dependencies"],"excerpt":"Updating Dependencies Review changes git diff easyp.lock","content":"Updating Dependencies Review changes git diff easyp.lock"},{"id":"cli/package-manager/package-manager::updating-dependencies::53","title":"Package Manager","section":"Updating Dependencies","path":"/docs/guide/cli/package-manager/package-manager#updating-dependencies","headings":["Updating Dependencies"],"excerpt":"Updating Dependencies Test with new versions easyp generate easyp lint","content":"Updating Dependencies Test with new versions easyp generate easyp lint"},{"id":"cli/package-manager/package-manager::updating-dependencies::54","title":"Package Manager","section":"Updating Dependencies","path":"/docs/guide/cli/package-manager/package-manager#updating-dependencies","headings":["Updating Dependencies"],"excerpt":"Updating Dependencies Commit if everything works git add easyp.lock git commit -m \"Update dependencies\" ```","content":"Updating Dependencies Commit if everything works git add easyp.lock git commit -m \"Update dependencies\" ```"},{"id":"cli/package-manager/package-manager::offline-development::55","title":"Package Manager","section":"Offline Development","path":"/docs/guide/cli/package-manager/package-manager#offline-development","headings":["Offline Development"],"excerpt":"Offline Development ```bash Vendor all dependencies easyp mod vendor","content":"Offline Development ```bash Vendor all dependencies easyp mod vendor"},{"id":"cli/package-manager/package-manager::offline-development::56","title":"Package Manager","section":"Offline Development","path":"/docs/guide/cli/package-manager/package-manager#offline-development","headings":["Offline Development"],"excerpt":"Offline Development Now your project works offline easyp generate ```","content":"Offline Development Now your project works offline easyp generate ```"},{"id":"cli/package-manager/package-manager::repository-not-found-or-authentication-failed::57","title":"Package Manager","section":"\"Repository not found\" or \"Authentication failed\"","path":"/docs/guide/cli/package-manager/package-manager#repository-not-found-or-authentication-failed","headings":["\"Repository not found\" or \"Authentication failed\""],"excerpt":"\"Repository not found\" or \"Authentication failed\" **Problem**: Can't access private repository **Solution**: Check authentication setup","content":"\"Repository not found\" or \"Authentication failed\" **Problem**: Can't access private repository **Solution**: Check authentication setup"},{"id":"cli/package-manager/package-manager::repository-not-found-or-authentication-failed::58","title":"Package Manager","section":"\"Repository not found\" or \"Authentication failed\"","path":"/docs/guide/cli/package-manager/package-manager#repository-not-found-or-authentication-failed","headings":["\"Repository not found\" or \"Authentication failed\""],"excerpt":"\"Repository not found\" or \"Authentication failed\" ```bash Test Git access git ls-remote https://github.com/mycompany/private-repo","content":"\"Repository not found\" or \"Authentication failed\" ```bash Test Git access git ls-remote https://github.com/mycompany/private-repo"},{"id":"cli/package-manager/package-manager::repository-not-found-or-authentication-failed::59","title":"Package Manager","section":"\"Repository not found\" or \"Authentication failed\"","path":"/docs/guide/cli/package-manager/package-manager#repository-not-found-or-authentication-failed","headings":["\"Repository not found\" or \"Authentication failed\""],"excerpt":"\"Repository not found\" or \"Authentication failed\" Check Git configuration git config --list grep url ```","content":"\"Repository not found\" or \"Authentication failed\" Check Git configuration git config --list grep url ```"},{"id":"cli/package-manager/package-manager::version-not-found::60","title":"Package Manager","section":"\"Version not found\"","path":"/docs/guide/cli/package-manager/package-manager#version-not-found","headings":["\"Version not found\""],"excerpt":"\"Version not found\" **Problem**: Specified tag/version doesn't exist **Solution**: Check available tags","content":"\"Version not found\" **Problem**: Specified tag/version doesn't exist **Solution**: Check available tags"},{"id":"cli/package-manager/package-manager::version-not-found::61","title":"Package Manager","section":"\"Version not found\"","path":"/docs/guide/cli/package-manager/package-manager#version-not-found","headings":["\"Version not found\""],"excerpt":"\"Version not found\" ```bash List available tags git ls-remote --tags https://github.com/googleapis/googleapis","content":"\"Version not found\" ```bash List available tags git ls-remote --tags https://github.com/googleapis/googleapis"},{"id":"cli/package-manager/package-manager::version-not-found::62","title":"Package Manager","section":"\"Version not found\"","path":"/docs/guide/cli/package-manager/package-manager#version-not-found","headings":["\"Version not found\""],"excerpt":"\"Version not found\" Use existing tag or commit hash deps: - github.com/googleapis/googleapis@common-protos-1_3_1 # Valid tag ```","content":"\"Version not found\" Use existing tag or commit hash deps: - github.com/googleapis/googleapis@common-protos-1_3_1 # Valid tag ```"},{"id":"cli/package-manager/package-manager::cache-corruption-or-checksum-mismatch::63","title":"Package Manager","section":"\"Cache corruption\" or \"Checksum mismatch\"","path":"/docs/guide/cli/package-manager/package-manager#cache-corruption-or-checksum-mismatch","headings":["\"Cache corruption\" or \"Checksum mismatch\""],"excerpt":"\"Cache corruption\" or \"Checksum mismatch\" **Problem**: Corrupted cache files **Solution**: Clear cache and re-download","content":"\"Cache corruption\" or \"Checksum mismatch\" **Problem**: Corrupted cache files **Solution**: Clear cache and re-download"},{"id":"cli/package-manager/package-manager::cache-corruption-or-checksum-mismatch::64","title":"Package Manager","section":"\"Cache corruption\" or \"Checksum mismatch\"","path":"/docs/guide/cli/package-manager/package-manager#cache-corruption-or-checksum-mismatch","headings":["\"Cache corruption\" or \"Checksum mismatch\""],"excerpt":"\"Cache corruption\" or \"Checksum mismatch\" ```bash Clear everything rm -rf ~/.easyp","content":"\"Cache corruption\" or \"Checksum mismatch\" ```bash Clear everything rm -rf ~/.easyp"},{"id":"cli/package-manager/package-manager::cache-corruption-or-checksum-mismatch::65","title":"Package Manager","section":"\"Cache corruption\" or \"Checksum mismatch\"","path":"/docs/guide/cli/package-manager/package-manager#cache-corruption-or-checksum-mismatch","headings":["\"Cache corruption\" or \"Checksum mismatch\""],"excerpt":"\"Cache corruption\" or \"Checksum mismatch\" Or clear just downloads rm -rf ~/.easyp/cache/download","content":"\"Cache corruption\" or \"Checksum mismatch\" Or clear just downloads rm -rf ~/.easyp/cache/download"},{"id":"cli/package-manager/package-manager::cache-corruption-or-checksum-mismatch::66","title":"Package Manager","section":"\"Cache corruption\" or \"Checksum mismatch\"","path":"/docs/guide/cli/package-manager/package-manager#cache-corruption-or-checksum-mismatch","headings":["\"Cache corruption\" or \"Checksum mismatch\""],"excerpt":"\"Cache corruption\" or \"Checksum mismatch\" Re-download easyp mod download ```","content":"\"Cache corruption\" or \"Checksum mismatch\" Re-download easyp mod download ```"},{"id":"cli/package-manager/package-manager::network-timeouts::67","title":"Package Manager","section":"Network timeouts","path":"/docs/guide/cli/package-manager/package-manager#network-timeouts","headings":["Network timeouts"],"excerpt":"Network timeouts **Problem**: Slow or unreliable network **Solution**: Configure Git timeouts","content":"Network timeouts **Problem**: Slow or unreliable network **Solution**: Configure Git timeouts"},{"id":"cli/package-manager/package-manager::network-timeouts::68","title":"Package Manager","section":"Network timeouts","path":"/docs/guide/cli/package-manager/package-manager#network-timeouts","headings":["Network timeouts"],"excerpt":"Network timeouts ```bash Increase timeout git config --global http.lowSpeedLimit 1000 git config --global http.lowSpeedTime 300","content":"Network timeouts ```bash Increase timeout git config --global http.lowSpeedLimit 1000 git config --global http.lowSpeedTime 300"},{"id":"cli/package-manager/package-manager::network-timeouts::69","title":"Package Manager","section":"Network timeouts","path":"/docs/guide/cli/package-manager/package-manager#network-timeouts","headings":["Network timeouts"],"excerpt":"Network timeouts Use proxy if available git config --global http.proxy http://proxy.company.com:8080 ```","content":"Network timeouts Use proxy if available git config --global http.proxy http://proxy.company.com:8080 ```"},{"id":"cli/package-manager/package-manager::for-large-teams::70","title":"Package Manager","section":"For Large Teams","path":"/docs/guide/cli/package-manager/package-manager#for-large-teams","headings":["For Large Teams"],"excerpt":"For Large Teams ```bash Use shared cache server (if available) export EASYPPATH=/shared/easyp-cache","content":"For Large Teams ```bash Use shared cache server (if available) export EASYPPATH=/shared/easyp-cache"},{"id":"cli/package-manager/package-manager::for-large-teams::71","title":"Package Manager","section":"For Large Teams","path":"/docs/guide/cli/package-manager/package-manager#for-large-teams","headings":["For Large Teams"],"excerpt":"For Large Teams Or use team-specific cache export EASYPPATH=/team-cache/easyp ```","content":"For Large Teams Or use team-specific cache export EASYPPATH=/team-cache/easyp ```"},{"id":"cli/package-manager/package-manager::for-cicd-systems::72","title":"Package Manager","section":"For CI/CD Systems","path":"/docs/guide/cli/package-manager/package-manager#for-cicd-systems","headings":["For CI/CD Systems"],"excerpt":"For CI/CD Systems ```bash Use project-relative cache export EASYPPATH=$CI_PROJECT_DIR/.easyp","content":"For CI/CD Systems ```bash Use project-relative cache export EASYPPATH=$CI_PROJECT_DIR/.easyp"},{"id":"cli/package-manager/package-manager::for-cicd-systems::73","title":"Package Manager","section":"For CI/CD Systems","path":"/docs/guide/cli/package-manager/package-manager#for-cicd-systems","headings":["For CI/CD Systems"],"excerpt":"For CI/CD Systems Cache between builds (GitLab CI example) cache: key: easyp-$CI_COMMIT_REF_SLUG paths: - .easyp/ ```","content":"For CI/CD Systems Cache between builds (GitLab CI example) cache: key: easyp-$CI_COMMIT_REF_SLUG paths: - .easyp/ ```"},{"id":"cli/package-manager/package-manager::cache-size-management::74","title":"Package Manager","section":"Cache Size Management","path":"/docs/guide/cli/package-manager/package-manager#cache-size-management","headings":["Cache Size Management"],"excerpt":"Cache Size Management ```bash Check cache usage du -sh ~/.easyp du -sh ~/.easyp/cache/download # Archives only du -sh ~/.easyp/mod # Extracted modules","content":"Cache Size Management ```bash Check cache usage du -sh ~/.easyp du -sh ~/.easyp/cache/download # Archives only du -sh ~/.easyp/mod # Extracted modules"},{"id":"cli/package-manager/package-manager::cache-size-management::75","title":"Package Manager","section":"Cache Size Management","path":"/docs/guide/cli/package-manager/package-manager#cache-size-management","headings":["Cache Size Management"],"excerpt":"Cache Size Management Clean old versions (manual) find ~/.easyp/mod -type d -name \"v0.0.0-*\" -mtime +30 -exec rm -rf {} \\; ```","content":"Cache Size Management Clean old versions (manual) find ~/.easyp/mod -type d -name \"v0.0.0-*\" -mtime +30 -exec rm -rf {} \\; ```"},{"id":"cli/package-manager/package-manager::docker-multi-stage-build::76","title":"Package Manager","section":"Docker Multi-stage Build","path":"/docs/guide/cli/package-manager/package-manager#docker-multi-stage-build","headings":["Docker Multi-stage Build"],"excerpt":"Docker Multi-stage Build ```dockerfile Stage 1: Download dependencies FROM ghcr.io/easyp-tech/easyp:latest AS deps WORKDIR /workspace COPY easyp.yaml easyp.lock ./ RUN easyp mod vendor","content":"Docker Multi-stage Build ```dockerfile Stage 1: Download dependencies FROM ghcr.io/easyp-tech/easyp:latest AS deps WORKDIR /workspace COPY easyp.yaml easyp.lock ./ RUN easyp mod vendor"},{"id":"cli/package-manager/package-manager::docker-multi-stage-build::77","title":"Package Manager","section":"Docker Multi-stage Build","path":"/docs/guide/cli/package-manager/package-manager#docker-multi-stage-build","headings":["Docker Multi-stage Build"],"excerpt":"Docker Multi-stage Build Stage 2: Build application FROM alpine:latest AS build WORKDIR /app COPY --from=deps /workspace/easyp_vendor ./easyp_vendor COPY . . Use vendored dependencies for generation RUN easyp generate ``","content":"Docker Multi-stage Build Stage 2: Build application FROM alpine:latest AS build WORKDIR /app COPY --from=deps /workspace/easyp_vendor ./easyp_vendor COPY . . Use vendored dependencies for generation RUN easyp generate ```"},{"id":"cli/package-manager/package-manager::monorepo-structure::78","title":"Package Manager","section":"Monorepo Structure","path":"/docs/guide/cli/package-manager/package-manager#monorepo-structure","headings":["Monorepo Structure"],"excerpt":"Monorepo Structure Each easyp.yaml can have different dependencies based on service needs.","content":"Monorepo Structure Each easyp.yaml can have different dependencies based on service needs."},{"id":"cli/package-manager/package-manager::development-workflow::79","title":"Package Manager","section":"Development Workflow","path":"/docs/guide/cli/package-manager/package-manager#development-workflow","headings":["Development Workflow"],"excerpt":"Development Workflow ✅ Use **latest tags** during active development ✅ **Pin versions** for production deployments ✅ **Commit lock files** to ensure reproducibility ✅ **Review dependency updates** before merging ✅ **Test","content":"Development Workflow ✅ Use **latest tags** during active development ✅ **Pin versions** for production deployments ✅ **Commit lock files** to ensure reproducibility ✅ **Review dependency updates** before merging ✅ **Test after updates** to catch compatibility issues"},{"id":"cli/package-manager/package-manager::security::80","title":"Package Manager","section":"Security","path":"/docs/guide/cli/package-manager/package-manager#security","headings":["Security"],"excerpt":"Security ✅ **Pin to specific versions** in production ✅ **Use SSH keys** for private repositories ✅ **Review new dependencies** for security implications ✅ **Monitor for vulnerabilities** in dependencies ❌ **Don't embed ","content":"Security ✅ **Pin to specific versions** in production ✅ **Use SSH keys** for private repositories ✅ **Review new dependencies** for security implications ✅ **Monitor for vulnerabilities** in dependencies ❌ **Don't embed credentials** in configuration files"},{"id":"cli/package-manager/package-manager::performance::81","title":"Package Manager","section":"Performance","path":"/docs/guide/cli/package-manager/package-manager#performance","headings":["Performance"],"excerpt":"Performance ✅ **Cache aggressively** in CI/CD systems ✅ **Use vendoring** for frequently rebuilt projects ✅ **Clean old cache** periodically to save space ✅ **Use shared cache** for team environments","content":"Performance ✅ **Cache aggressively** in CI/CD systems ✅ **Use vendoring** for frequently rebuilt projects ✅ **Clean old cache** periodically to save space ✅ **Use shared cache** for team environments"},{"id":"cli/package-manager/package-manager::team-collaboration::82","title":"Package Manager","section":"Team Collaboration","path":"/docs/guide/cli/package-manager/package-manager#team-collaboration","headings":["Team Collaboration"],"excerpt":"Team Collaboration ✅ **Document authentication setup** for new team members ✅ **Use consistent tooling** across environments ✅ **Automate dependency updates** with proper testing ✅ **Share cache locations** when possible","content":"Team Collaboration ✅ **Document authentication setup** for new team members ✅ **Use consistent tooling** across environments ✅ **Automate dependency updates** with proper testing ✅ **Share cache locations** when possible"},{"id":"cli/package-manager/package-manager::team-collaboration::83","title":"Package Manager","section":"Team Collaboration","path":"/docs/guide/cli/package-manager/package-manager#team-collaboration","headings":["Team Collaboration"],"excerpt":"Team Collaboration The EasyP package manager provides a robust, decentralized solution for protobuf dependency management that scales from individual projects to enterprise environments while maintaining the simplicity a","content":"Team Collaboration The EasyP package manager provides a robust, decentralized solution for protobuf dependency management that scales from individual projects to enterprise environments while maintaining the simplicity and reliability developers expect."},{"id":"introduction/install::install-from-systems-package-manager::0","title":"Install the EasyP cli","section":"Install from system's package manager","path":"/docs/guide/introduction/install#install-from-systems-package-manager","headings":["Install from system's package manager"],"excerpt":"Install from system's package manager","content":"Install from system's package manager"},{"id":"introduction/install::recommended-installation-method::1","title":"Install the EasyP cli","section":"Recommended installation method","path":"/docs/guide/introduction/install#recommended-installation-method","headings":["Recommended installation method"],"excerpt":"Recommended installation method","content":"Recommended installation method"},{"id":"introduction/install::homebrew::2","title":"Install the EasyP cli","section":"Homebrew","path":"/docs/guide/introduction/install#homebrew","headings":["Homebrew"],"excerpt":"Homebrew You can install a binary release on macOS using brew:","content":"Homebrew You can install a binary release on macOS using brew:"},{"id":"introduction/install::homebrew::3","title":"Install the EasyP cli","section":"Homebrew","path":"/docs/guide/introduction/install#homebrew","headings":["Homebrew"],"excerpt":"Homebrew Work in progress apt, yum, pacman, etc.","content":"Homebrew Work in progress apt, yum, pacman, etc."},{"id":"introduction/install::_not-recommended_::4","title":"Install the EasyP cli","section":"_Not recommended_","path":"/docs/guide/introduction/install#_not-recommended_","headings":["_Not recommended_"],"excerpt":"_Not recommended_ Local installation is not recommended because package managers provide: Automatic updates and security patches Better integration with system package management Easier installation and removal process V","content":"_Not recommended_ Local installation is not recommended because package managers provide: Automatic updates and security patches Better integration with system package management Easier installation and removal process Verified and signed binaries"},{"id":"introduction/install::go-install::5","title":"Install the EasyP cli","section":"Go install","path":"/docs/guide/introduction/install#go-install","headings":["Go install"],"excerpt":"Go install It will install the latest stable version of easyp.","content":"Go install It will install the latest stable version of easyp."},{"id":"introduction/install::build-from-source::6","title":"Install the EasyP cli","section":"Build from source","path":"/docs/guide/introduction/install#build-from-source","headings":["Build from source"],"excerpt":"Build from source Clone repository","content":"Build from source Clone repository"},{"id":"introduction/install::build-from-source::7","title":"Install the EasyP cli","section":"Build from source","path":"/docs/guide/introduction/install#build-from-source","headings":["Build from source"],"excerpt":"Build from source Build by golang","content":"Build from source Build by golang"},{"id":"introduction/quickstart::top::0","title":"Quickstart","path":"/docs/guide/introduction/quickstart","headings":[],"excerpt":"EasyP is a modern toolkit for working with Protobuf files. In this quickstart, you'll learn to:","content":"EasyP is a modern toolkit for working with Protobuf files. In this quickstart, you'll learn to:"},{"id":"introduction/quickstart::top::1","title":"Quickstart","path":"/docs/guide/introduction/quickstart","headings":[],"excerpt":"**Initialize** your project with EasyP configuration **Set up linting** to catch errors and ensure best practices **Manage dependencies** from Git repositories **Generate code** from your Protobuf files","content":"**Initialize** your project with EasyP configuration **Set up linting** to catch errors and ensure best practices **Manage dependencies** from Git repositories **Generate code** from your Protobuf files"},{"id":"introduction/quickstart::prerequisites::2","title":"Quickstart","section":"Prerequisites","path":"/docs/guide/introduction/quickstart#prerequisites","headings":["Prerequisites"],"excerpt":"Prerequisites Before you begin, make sure you have:","content":"Prerequisites Before you begin, make sure you have:"},{"id":"introduction/quickstart::prerequisites::3","title":"Quickstart","section":"Prerequisites","path":"/docs/guide/introduction/quickstart#prerequisites","headings":["Prerequisites"],"excerpt":"Prerequisites **EasyP CLI installed** - See Installation guide if you haven't already **Git** installed and in your $PATH **Protobuf files** ready to work with (or create some as you go)","content":"Prerequisites **EasyP CLI installed** - See Installation guide if you haven't already **Git** installed and in your $PATH **Protobuf files** ready to work with (or create some as you go)"},{"id":"introduction/quickstart::prerequisites::4","title":"Quickstart","section":"Prerequisites","path":"/docs/guide/introduction/quickstart#prerequisites","headings":["Prerequisites"],"excerpt":"Prerequisites You can verify your installation:","content":"Prerequisites You can verify your installation:"},{"id":"introduction/quickstart::initialize-your-project::5","title":"Quickstart","section":"Initialize your project","path":"/docs/guide/introduction/quickstart#initialize-your-project","headings":["Initialize your project"],"excerpt":"Initialize your project Start by creating an easyp.yaml configuration file in your project root:","content":"Initialize your project Start by creating an easyp.yaml configuration file in your project root:"},{"id":"introduction/quickstart::initialize-your-project::6","title":"Quickstart","section":"Initialize your project","path":"/docs/guide/introduction/quickstart#initialize-your-project","headings":["Initialize your project"],"excerpt":"Initialize your project This command generates a commented template with default lint and breaking settings. easyp init is interactive: if buf.yml/buf.yaml exists in the target root, EasyP asks whether to migrate it; if ","content":"Initialize your project This command generates a commented template with default lint and breaking settings. easyp init is interactive: if buf.yml/buf.yaml exists in the target root, EasyP asks whether to migrate it; if easyp.yaml already exists, it asks before overwriting."},{"id":"introduction/quickstart::configure-linting::7","title":"Quickstart","section":"Configure linting","path":"/docs/guide/introduction/quickstart#configure-linting","headings":["Configure linting"],"excerpt":"Configure linting Linting helps catch errors and ensures your Protobuf files follow best practices. EasyP provides default rules compatible with Buf standards.","content":"Configure linting Linting helps catch errors and ensures your Protobuf files follow best practices. EasyP provides default rules compatible with Buf standards."},{"id":"introduction/quickstart::configure-linting::8","title":"Quickstart","section":"Configure linting","path":"/docs/guide/introduction/quickstart#configure-linting","headings":["Configure linting"],"excerpt":"Configure linting easyp init already generates a lint section. Adjust it if needed, for example:","content":"Configure linting easyp init already generates a lint section. Adjust it if needed, for example:"},{"id":"introduction/quickstart::configure-linting::9","title":"Quickstart","section":"Configure linting","path":"/docs/guide/introduction/quickstart#configure-linting","headings":["Configure linting"],"excerpt":"Configure linting Now you can run the linter:","content":"Configure linting Now you can run the linter:"},{"id":"introduction/quickstart::configure-linting::10","title":"Quickstart","section":"Configure linting","path":"/docs/guide/introduction/quickstart#configure-linting","headings":["Configure linting"],"excerpt":"Configure linting The linter will check all your .proto files and report any issues found.","content":"Configure linting The linter will check all your .proto files and report any issues found."},{"id":"introduction/quickstart::configure-linting::11","title":"Quickstart","section":"Configure linting","path":"/docs/guide/introduction/quickstart#configure-linting","headings":["Configure linting"],"excerpt":"Configure linting ::: tip EasyP's linting rules are 100% compatible with Buf, making migration easy if you're switching tools. :::","content":"Configure linting ::: tip EasyP's linting rules are 100% compatible with Buf, making migration easy if you're switching tools. :::"},{"id":"introduction/quickstart::manage-dependencies::12","title":"Quickstart","section":"Manage dependencies","path":"/docs/guide/introduction/quickstart#manage-dependencies","headings":["Manage dependencies"],"excerpt":"Manage dependencies If your project uses third-party Protobuf packages (like Google APIs or gRPC Gateway), EasyP makes it easy to manage them.","content":"Manage dependencies If your project uses third-party Protobuf packages (like Google APIs or gRPC Gateway), EasyP makes it easy to manage them."},{"id":"introduction/quickstart::dependency-format::13","title":"Quickstart","section":"Dependency format","path":"/docs/guide/introduction/quickstart#dependency-format","headings":["Dependency format"],"excerpt":"Dependency format Dependencies use a simple format: $GIT_LINK@$VERSION","content":"Dependency format Dependencies use a simple format: $GIT_LINK@$VERSION"},{"id":"introduction/quickstart::dependency-format::14","title":"Quickstart","section":"Dependency format","path":"/docs/guide/introduction/quickstart#dependency-format","headings":["Dependency format"],"excerpt":"Dependency format **$GIT_LINK** - URL to any Git repository (GitHub, GitLab, etc.) **$VERSION** - Git tag or commit hash (optional)","content":"Dependency format **$GIT_LINK** - URL to any Git repository (GitHub, GitLab, etc.) **$VERSION** - Git tag or commit hash (optional)"},{"id":"introduction/quickstart::dependency-format::15","title":"Quickstart","section":"Dependency format","path":"/docs/guide/introduction/quickstart#dependency-format","headings":["Dependency format"],"excerpt":"Dependency format If you omit the version, EasyP downloads the latest commit from the default branch.","content":"Dependency format If you omit the version, EasyP downloads the latest commit from the default branch."},{"id":"introduction/quickstart::add-dependencies::16","title":"Quickstart","section":"Add dependencies","path":"/docs/guide/introduction/quickstart#add-dependencies","headings":["Add dependencies"],"excerpt":"Add dependencies Update your easyp.yaml to include dependencies:","content":"Add dependencies Update your easyp.yaml to include dependencies:"},{"id":"introduction/quickstart::download-dependencies::17","title":"Quickstart","section":"Download dependencies","path":"/docs/guide/introduction/quickstart#download-dependencies","headings":["Download dependencies"],"excerpt":"Download dependencies Download the packages you specified:","content":"Download dependencies Download the packages you specified:"},{"id":"introduction/quickstart::download-dependencies::18","title":"Quickstart","section":"Download dependencies","path":"/docs/guide/introduction/quickstart#download-dependencies","headings":["Download dependencies"],"excerpt":"Download dependencies This command: Downloads dependencies from easyp.lock if it exists Otherwise, downloads from easyp.yaml and creates easyp.lock","content":"Download dependencies This command: Downloads dependencies from easyp.lock if it exists Otherwise, downloads from easyp.yaml and creates easyp.lock"},{"id":"introduction/quickstart::download-dependencies::19","title":"Quickstart","section":"Download dependencies","path":"/docs/guide/introduction/quickstart#download-dependencies","headings":["Download dependencies"],"excerpt":"Download dependencies ::: info **Tip:** Use easyp mod update to ignore the lock file and fetch the latest versions from easyp.yaml. :::","content":"Download dependencies ::: info **Tip:** Use easyp mod update to ignore the lock file and fetch the latest versions from easyp.yaml. :::"},{"id":"introduction/quickstart::generate-code::20","title":"Quickstart","section":"Generate code","path":"/docs/guide/introduction/quickstart#generate-code","headings":["Generate code"],"excerpt":"Generate code Now let's configure code generation. EasyP supports all standard Protobuf plugins.","content":"Generate code Now let's configure code generation. EasyP supports all standard Protobuf plugins."},{"id":"introduction/quickstart::configure-generation::21","title":"Quickstart","section":"Configure generation","path":"/docs/guide/introduction/quickstart#configure-generation","headings":["Configure generation"],"excerpt":"Configure generation Add plugin configuration to your easyp.yaml:","content":"Configure generation Add plugin configuration to your easyp.yaml:"},{"id":"introduction/quickstart::run-code-generation::22","title":"Quickstart","section":"Run code generation","path":"/docs/guide/introduction/quickstart#run-code-generation","headings":["Run code generation"],"excerpt":"Run code generation Generate your code stubs:","content":"Run code generation Generate your code stubs:"},{"id":"introduction/quickstart::run-code-generation::23","title":"Quickstart","section":"Run code generation","path":"/docs/guide/introduction/quickstart#run-code-generation","headings":["Run code generation"],"excerpt":"Run code generation EasyP will: Resolve all dependencies Connect to the EasyP service (or run locally) Execute the configured plugins Output generated code to the specified directories","content":"Run code generation EasyP will: Resolve all dependencies Connect to the EasyP service (or run locally) Execute the configured plugins Output generated code to the specified directories"},{"id":"introduction/quickstart::run-code-generation::24","title":"Quickstart","section":"Run code generation","path":"/docs/guide/introduction/quickstart#run-code-generation","headings":["Run code generation"],"excerpt":"Run code generation ::: tip EasyP uses a hybrid runtime with WASM for speed and Docker for heavy plugins, giving you the best of both worlds. :::","content":"Run code generation ::: tip EasyP uses a hybrid runtime with WASM for speed and Docker for heavy plugins, giving you the best of both worlds. :::"},{"id":"introduction/quickstart::next-steps::25","title":"Quickstart","section":"Next steps","path":"/docs/guide/introduction/quickstart#next-steps","headings":["Next steps"],"excerpt":"Next steps Congratulations! 🎉 You've successfully: ✅ Initialized an EasyP project ✅ Configured linting rules ✅ Managed third-party dependencies ✅ Generated code from your Protobuf files","content":"Next steps Congratulations! 🎉 You've successfully: ✅ Initialized an EasyP project ✅ Configured linting rules ✅ Managed third-party dependencies ✅ Generated code from your Protobuf files"},{"id":"introduction/quickstart::learn-more::26","title":"Quickstart","section":"Learn more","path":"/docs/guide/introduction/quickstart#learn-more","headings":["Learn more"],"excerpt":"Learn more **CLI Reference** - Deep dive into all CLI commands **API Service** - Set up remote code generation **Configuration** - Explore all configuration options","content":"Learn more **CLI Reference** - Deep dive into all CLI commands **API Service** - Set up remote code generation **Configuration** - Explore all configuration options"},{"id":"introduction/quickstart::learn-more::27","title":"Quickstart","section":"Learn more","path":"/docs/guide/introduction/quickstart#learn-more","headings":["Learn more"],"excerpt":"Learn more *Enjoy working with Protobuf without any pain! 🚀*","content":"Learn more *Enjoy working with Protobuf without any pain! 🚀*"},{"id":"introduction/what-is::top::0","title":"What is EasyP?","path":"/docs/guide/introduction/what-is","headings":[],"excerpt":"EasyP is a modern Protocol Buffers toolkit that consolidates your entire protobuf workflow into a single, powerful CLI tool. It combines linting, package management, code generation, and compatibility checking in a unifi","content":"EasyP is a modern Protocol Buffers toolkit that consolidates your entire protobuf workflow into a single, powerful CLI tool. It combines linting, package management, code generation, and compatibility checking in a unified interface designed to eliminate the complexity of traditional protobuf development."},{"id":"introduction/what-is::top::1","title":"What is EasyP?","path":"/docs/guide/introduction/what-is","headings":[],"excerpt":"Just want to try it out? Skip to the Quickstart.","content":"Just want to try it out? Skip to the Quickstart."},{"id":"introduction/what-is::the-problem-fragmented-proto-workflows::2","title":"What is EasyP?","section":"The Problem: Fragmented Proto Workflows","path":"/docs/guide/introduction/what-is#the-problem-fragmented-proto-workflows","headings":["The Problem: Fragmented Proto Workflows"],"excerpt":"The Problem: Fragmented Proto Workflows Working with Protocol Buffers across projects creates unnecessary complexity and friction:","content":"The Problem: Fragmented Proto Workflows Working with Protocol Buffers across projects creates unnecessary complexity and friction:"},{"id":"introduction/what-is::tool-chaos::3","title":"What is EasyP?","section":"Tool Chaos","path":"/docs/guide/introduction/what-is#tool-chaos","headings":["Tool Chaos"],"excerpt":"Tool Chaos **Multiple tools for different tasks**: Separate tools for linting, generation, and dependency management **Inconsistent configurations**: Different config formats across projects and teams **Complex setup**: ","content":"Tool Chaos **Multiple tools for different tasks**: Separate tools for linting, generation, and dependency management **Inconsistent configurations**: Different config formats across projects and teams **Complex setup**: Time-consuming onboarding for new developers joining projects"},{"id":"introduction/what-is::dependency-management-issues::4","title":"What is EasyP?","section":"Dependency Management Issues","path":"/docs/guide/introduction/what-is#dependency-management-issues","headings":["Dependency Management Issues"],"excerpt":"Dependency Management Issues **No standardized approach**: Each project handles proto dependencies differently **Version conflicts**: Difficult to resolve conflicts between different proto libraries **Build reproducibili","content":"Dependency Management Issues **No standardized approach**: Each project handles proto dependencies differently **Version conflicts**: Difficult to resolve conflicts between different proto libraries **Build reproducibility**: Hard to ensure consistent builds across environments"},{"id":"introduction/what-is::development-friction::5","title":"What is EasyP?","section":"Development Friction","path":"/docs/guide/introduction/what-is#development-friction","headings":["Development Friction"],"excerpt":"Development Friction **Manual processes**: Repetitive workflows for common proto tasks **Configuration sprawl**: Multiple config files with different formats **Time-consuming compatibility checks**: Manual verification o","content":"Development Friction **Manual processes**: Repetitive workflows for common proto tasks **Configuration sprawl**: Multiple config files with different formats **Time-consuming compatibility checks**: Manual verification of API changes"},{"id":"introduction/what-is::the-solution-unified-proto-toolkit::6","title":"What is EasyP?","section":"The Solution: Unified Proto Toolkit","path":"/docs/guide/introduction/what-is#the-solution-unified-proto-toolkit","headings":["The Solution: Unified Proto Toolkit"],"excerpt":"The Solution: Unified Proto Toolkit EasyP addresses these challenges by providing a comprehensive, opinionated toolkit that standardizes protobuf workflows:","content":"The Solution: Unified Proto Toolkit EasyP addresses these challenges by providing a comprehensive, opinionated toolkit that standardizes protobuf workflows:"},{"id":"introduction/what-is::one-tool-all-tasks::7","title":"What is EasyP?","section":"One Tool, All Tasks","path":"/docs/guide/introduction/what-is#one-tool-all-tasks","headings":["One Tool, All Tasks"],"excerpt":"One Tool, All Tasks Instead of juggling multiple tools, EasyP provides everything you need: **Linting** with comprehensive rule sets **Package management** with Git-native dependencies **Code generation** with local and ","content":"One Tool, All Tasks Instead of juggling multiple tools, EasyP provides everything you need: **Linting** with comprehensive rule sets **Package management** with Git-native dependencies **Code generation** with local and remote plugin support **Breaking change detection** for API compatibility"},{"id":"introduction/what-is::standardized-configuration::8","title":"What is EasyP?","section":"Standardized Configuration","path":"/docs/guide/introduction/what-is#standardized-configuration","headings":["Standardized Configuration"],"excerpt":"Standardized Configuration A single easyp.yaml file configures your entire protobuf workflow, eliminating configuration sprawl and ensuring consistency across projects.","content":"Standardized Configuration A single easyp.yaml file configures your entire protobuf workflow, eliminating configuration sprawl and ensuring consistency across projects."},{"id":"introduction/what-is::git-native-dependencies::9","title":"What is EasyP?","section":"Git-Native Dependencies","path":"/docs/guide/introduction/what-is#git-native-dependencies","headings":["Git-Native Dependencies"],"excerpt":"Git-Native Dependencies Direct integration with Git repositories for proto dependencies eliminates the need for centralized registries while providing version control and reproducibility.","content":"Git-Native Dependencies Direct integration with Git repositories for proto dependencies eliminates the need for centralized registries while providing version control and reproducibility."},{"id":"introduction/what-is::key-features::10","title":"What is EasyP?","section":"Key Features","path":"/docs/guide/introduction/what-is#key-features","headings":["Key Features"],"excerpt":"Key Features Feature Description --------- ------------- 🔍 **Comprehensive Linting** Built-in support for buf's linting rules with customizable configurations to enforce API design best practices. 📦 **Smart Package Man","content":"Key Features Feature Description --------- ------------- 🔍 **Comprehensive Linting** Built-in support for buf's linting rules with customizable configurations to enforce API design best practices. 📦 **Smart Package Manager** Git-based dependency management with lock file support for reproducible builds across environments. ⚡ **Code Generation** Multi-language code generation with support for both local protoc plugins and remote plugin execution. 🔄 **Breaking Change Detection** Automated API compatibility verification against Git branches to prevent accidental breaking changes. 🌐 **Remote Plugin Support** Execute plugins via centralized EasyP API service for consistent, isolated execution without local dependencies. 🎯 **Developer Experience** Auto-completion, intuitive commands, clear error messages, and comprehensive documentation."},{"id":"introduction/what-is::supported-plugin-types::11","title":"What is EasyP?","section":"Supported Plugin Types","path":"/docs/guide/introduction/what-is#supported-plugin-types","headings":["Supported Plugin Types"],"excerpt":"Supported Plugin Types EasyP provides flexibility in how you execute code generation plugins:","content":"Supported Plugin Types EasyP provides flexibility in how you execute code generation plugins:"},{"id":"introduction/what-is::local-plugins::12","title":"What is EasyP?","section":"Local Plugins","path":"/docs/guide/introduction/what-is#local-plugins","headings":["Local Plugins"],"excerpt":"Local Plugins Standard protoc plugins installed on your system:","content":"Local Plugins Standard protoc plugins installed on your system:"},{"id":"introduction/what-is::remote-plugins::13","title":"What is EasyP?","section":"Remote Plugins","path":"/docs/guide/introduction/what-is#remote-plugins","headings":["Remote Plugins"],"excerpt":"Remote Plugins Plugins executed via EasyP API service for consistent results:","content":"Remote Plugins Plugins executed via EasyP API service for consistent results:"},{"id":"introduction/what-is::custom-plugins::14","title":"What is EasyP?","section":"Custom Plugins","path":"/docs/guide/introduction/what-is#custom-plugins","headings":["Custom Plugins"],"excerpt":"Custom Plugins Support for custom plugin development and distribution through the ecosystem.","content":"Custom Plugins Support for custom plugin development and distribution through the ecosystem."},{"id":"introduction/what-is::decentralized-package-management::15","title":"What is EasyP?","section":"Decentralized Package Management","path":"/docs/guide/introduction/what-is#decentralized-package-management","headings":["Decentralized Package Management"],"excerpt":"Decentralized Package Management Unlike other tools, EasyP doesn't rely on a centralized server for package distribution. Instead, any Git repository can serve as a package source, giving you:","content":"Decentralized Package Management Unlike other tools, EasyP doesn't rely on a centralized server for package distribution. Instead, any Git repository can serve as a package source, giving you:"},{"id":"introduction/what-is::decentralized-package-management::16","title":"What is EasyP?","section":"Decentralized Package Management","path":"/docs/guide/introduction/what-is#decentralized-package-management","headings":["Decentralized Package Management"],"excerpt":"Decentralized Package Management **Flexibility and Control**: Use any Git hosting service (GitHub, GitLab, self-hosted) **No Vendor Lock-in**: Your dependencies aren't tied to a specific registry **Version Control**: Ful","content":"Decentralized Package Management **Flexibility and Control**: Use any Git hosting service (GitHub, GitLab, self-hosted) **No Vendor Lock-in**: Your dependencies aren't tied to a specific registry **Version Control**: Full Git history and branching for your proto dependencies **Enterprise-Friendly**: Works with private repositories and corporate Git infrastructure"},{"id":"introduction/what-is::seamless-migration-from-buf::17","title":"What is EasyP?","section":"Seamless Migration from Buf","path":"/docs/guide/introduction/what-is#seamless-migration-from-buf","headings":["Seamless Migration from Buf"],"excerpt":"Seamless Migration from Buf EasyP is designed with buf compatibility in mind:","content":"Seamless Migration from Buf EasyP is designed with buf compatibility in mind:"},{"id":"introduction/what-is::seamless-migration-from-buf::18","title":"What is EasyP?","section":"Seamless Migration from Buf","path":"/docs/guide/introduction/what-is#seamless-migration-from-buf","headings":["Seamless Migration from Buf"],"excerpt":"Seamless Migration from Buf **Compatible rule sets**: Uses the same linting rules as buf **Familiar configuration**: Similar YAML structure with enhanced features **Drop-in replacement**: Can often replace buf with minim","content":"Seamless Migration from Buf **Compatible rule sets**: Uses the same linting rules as buf **Familiar configuration**: Similar YAML structure with enhanced features **Drop-in replacement**: Can often replace buf with minimal configuration changes **Gradual migration**: Adopt EasyP features incrementally without disrupting existing workflows"},{"id":"introduction/what-is::easyp-vs-bufbuild-comparison::19","title":"What is EasyP?","section":"EasyP vs buf.build Comparison","path":"/docs/guide/introduction/what-is#easyp-vs-bufbuild-comparison","headings":["EasyP vs buf.build Comparison"],"excerpt":"EasyP vs buf.build Comparison Feature EasyP buf.build --------- -------- ----------- **Dependency Management** Git-based repositories Buf Schema Registry (BSR) **Vendor Lock-in** None - works with any Git hosting Tied to","content":"EasyP vs buf.build Comparison Feature EasyP buf.build --------- -------- ----------- **Dependency Management** Git-based repositories Buf Schema Registry (BSR) **Vendor Lock-in** None - works with any Git hosting Tied to BSR for full features **Plugin Execution** Local + Remote plugins Local + BSR plugins **Private Dependencies** Any Git provider (GitHub, GitLab, etc.) BSR or manual management **Offline Development** Full support with mod vendor Limited without BSR access **Enterprise Integration** Works with existing Git infrastructure Requires BSR setup **Breaking Change Detection** Against any Git reference Against any Git reference **Package Distribution** Any Git repository BSR required for publishing **License** Apache 2.0 Apache 2.0 **Community** Growing Established"},{"id":"introduction/what-is::easyp-vs-bufbuild-comparison::20","title":"What is EasyP?","section":"EasyP vs buf.build Comparison","path":"/docs/guide/introduction/what-is#easyp-vs-bufbuild-comparison","headings":["EasyP vs buf.build Comparison"],"excerpt":"EasyP vs buf.build Comparison **Migration Benefits:** **No infrastructure changes**: Continue using your existing Git repositories **Gradual adoption**: Start with EasyP while keeping existing buf configurations **Enhanc","content":"EasyP vs buf.build Comparison **Migration Benefits:** **No infrastructure changes**: Continue using your existing Git repositories **Gradual adoption**: Start with EasyP while keeping existing buf configurations **Enhanced flexibility**: Access to both local and remote plugin execution **Simplified workflows**: Single configuration file for all protobuf operations"},{"id":"introduction/what-is::our-goals-for-protobuf::21","title":"What is EasyP?","section":"Our Goals for Protobuf","path":"/docs/guide/introduction/what-is#our-goals-for-protobuf","headings":["Our Goals for Protobuf"],"excerpt":"Our Goals for Protobuf EasyP's mission is to accelerate the adoption of **schema-driven API development** by making Protocol Buffers more accessible and reliable:","content":"Our Goals for Protobuf EasyP's mission is to accelerate the adoption of **schema-driven API development** by making Protocol Buffers more accessible and reliable:"},{"id":"introduction/what-is::modern-protobuf-ecosystem::22","title":"What is EasyP?","section":"Modern Protobuf Ecosystem","path":"/docs/guide/introduction/what-is#modern-protobuf-ecosystem","headings":["Modern Protobuf Ecosystem"],"excerpt":"Modern Protobuf Ecosystem We're building on Protobuf's proven foundation to create a modern development experience that rivals the simplicity of REST/JSON while providing superior type safety and performance.","content":"Modern Protobuf Ecosystem We're building on Protobuf's proven foundation to create a modern development experience that rivals the simplicity of REST/JSON while providing superior type safety and performance."},{"id":"introduction/what-is::developer-experience-first::23","title":"What is EasyP?","section":"Developer Experience First","path":"/docs/guide/introduction/what-is#developer-experience-first","headings":["Developer Experience First"],"excerpt":"Developer Experience First Every feature is designed with developer productivity in mind, from intuitive CLI commands to comprehensive error messages and documentation.","content":"Developer Experience First Every feature is designed with developer productivity in mind, from intuitive CLI commands to comprehensive error messages and documentation."},{"id":"introduction/what-is::enterprise-ready::24","title":"What is EasyP?","section":"Enterprise Ready","path":"/docs/guide/introduction/what-is#enterprise-ready","headings":["Enterprise Ready"],"excerpt":"Enterprise Ready Built for teams and organizations with features like reproducible builds, private repository support, and comprehensive CI/CD integration.","content":"Enterprise Ready Built for teams and organizations with features like reproducible builds, private repository support, and comprehensive CI/CD integration."},{"id":"introduction/what-is::for-individual-developers::25","title":"What is EasyP?","section":"For Individual Developers","path":"/docs/guide/introduction/what-is#for-individual-developers","headings":["For Individual Developers"],"excerpt":"For Individual Developers **Quick Setup**: Get started with protobuf projects in minutes, not hours **Unified Workflow**: One tool for all your protobuf needs **Clear Documentation**: Comprehensive guides and examples","content":"For Individual Developers **Quick Setup**: Get started with protobuf projects in minutes, not hours **Unified Workflow**: One tool for all your protobuf needs **Clear Documentation**: Comprehensive guides and examples"},{"id":"introduction/what-is::for-teams::26","title":"What is EasyP?","section":"For Teams","path":"/docs/guide/introduction/what-is#for-teams","headings":["For Teams"],"excerpt":"For Teams **Consistent Standards**: Enforced linting rules and formatting across all projects **Reproducible Builds**: Lock files ensure everyone builds the same way **Easy Onboarding**: New team members can be productiv","content":"For Teams **Consistent Standards**: Enforced linting rules and formatting across all projects **Reproducible Builds**: Lock files ensure everyone builds the same way **Easy Onboarding**: New team members can be productive immediately"},{"id":"introduction/what-is::for-organizations::27","title":"What is EasyP?","section":"For Organizations","path":"/docs/guide/introduction/what-is#for-organizations","headings":["For Organizations"],"excerpt":"For Organizations **No Vendor Lock-in**: Git-based dependencies work with your existing infrastructure **Enterprise Security**: Support for private repositories and custom authentication **CI/CD Ready**: Designed for aut","content":"For Organizations **No Vendor Lock-in**: Git-based dependencies work with your existing infrastructure **Enterprise Security**: Support for private repositories and custom authentication **CI/CD Ready**: Designed for automated workflows and continuous integration"},{"id":"introduction/what-is::whats-next::28","title":"What is EasyP?","section":"What's Next?","path":"/docs/guide/introduction/what-is#whats-next","headings":["What's Next?"],"excerpt":"What's Next? EasyP simplifies protobuf development so you can focus on building great APIs instead of managing toolchain complexity. Whether you're starting a new project or migrating from existing tools, EasyP provides ","content":"What's Next? EasyP simplifies protobuf development so you can focus on building great APIs instead of managing toolchain complexity. Whether you're starting a new project or migrating from existing tools, EasyP provides a smooth path to modern protobuf development."},{"id":"introduction/what-is::whats-next::29","title":"What is EasyP?","section":"What's Next?","path":"/docs/guide/introduction/what-is#whats-next","headings":["What's Next?"],"excerpt":"What's Next? Ready to get started? Check out our Installation Guide and Quickstart Tutorial.","content":"What's Next? Ready to get started? Check out our Installation Guide and Quickstart Tutorial."},{"id":"introduction/what-is::stargazers-over-time::30","title":"What is EasyP?","section":"Stargazers over time","path":"/docs/guide/introduction/what-is#stargazers-over-time","headings":["Stargazers over time"],"excerpt":"Stargazers over time Stargazers over time","content":"Stargazers over time Stargazers over time"},{"id":"migration/buf-cli::top::0","title":"Buf CLI","path":"/docs/guide/migration/buf-cli","headings":[],"excerpt":"Buf CLI Work in progress","content":"Buf CLI Work in progress"},{"id":"migration/protoc::top::0","title":"Protoc","path":"/docs/guide/migration/protoc","headings":[],"excerpt":"Protoc Work in progress","content":"Protoc Work in progress"},{"id":"migration/protolock::top::0","title":"Protolock","path":"/docs/guide/migration/protolock","headings":[],"excerpt":"Protolock Work in progress","content":"Protolock Work in progress"},{"id":"migration/prototool::top::0","title":"Prototool","path":"/docs/guide/migration/prototool","headings":[],"excerpt":"Prototool Work in progress","content":"Prototool Work in progress"}]
\ No newline at end of file
diff --git a/docs/dist/search/index.ru.json b/docs/dist/search/index.ru.json
deleted file mode 100644
index 3ce4ae7b..00000000
--- a/docs/dist/search/index.ru.json
+++ /dev/null
@@ -1 +0,0 @@
-[{"id":"api-service/overview::top::0","title":"Обзор API Service","path":"/docs/guide/api-service/overview","headings":[],"excerpt":"**Централизованный сервис выполнения protobuf‑плагинов для консистентной изолированной генерации кода**","content":"**Централизованный сервис выполнения protobuf‑плагинов для консистентной изолированной генерации кода**"},{"id":"api-service/overview::top::1","title":"Обзор API Service","path":"/docs/guide/api-service/overview","headings":[],"excerpt":"EasyP API Service устраняет хаос управления плагинами, предоставляя централизованный запуск protobuf/gRPC плагинов в изолированных Docker‑контейнерах. Он даёт единую платформу, позволяющую командам стандартизировать проц","content":"EasyP API Service устраняет хаос управления плагинами, предоставляя централизованный запуск protobuf/gRPC плагинов в изолированных Docker‑контейнерах. Он даёт единую платформу, позволяющую командам стандартизировать процесс генерации кода без операционных затрат на установку и поддержку плагинов на машинах разработчиков."},{"id":"api-service/overview::easyp-api-service::2","title":"Обзор API Service","section":"Зачем нужен EasyP API Service?","path":"/docs/guide/api-service/overview#easyp-api-service","headings":["Зачем нужен EasyP API Service?"],"excerpt":"Зачем нужен EasyP API Service?","content":"Зачем нужен EasyP API Service?"},{"id":"api-service/overview::top::3","title":"Обзор API Service","section":"Проблема","path":"/docs/guide/api-service/overview","headings":["Проблема"],"excerpt":"Проблема Управление генерацией protobuf/gRPC кода в командах порождает существенную операционную сложность:","content":"Проблема Управление генерацией protobuf/gRPC кода в командах порождает существенную операционную сложность:"},{"id":"api-service/overview::top::4","title":"Обзор API Service","section":"Несогласованность версий","path":"/docs/guide/api-service/overview","headings":["Несогласованность версий"],"excerpt":"Несогласованность версий Разработчики локально используют разные версии плагинов → расхождения в генерированном коде и падения сборки Синдром «у меня работает» при различиях окружений Требуется ручная координация, чтобы ","content":"Несогласованность версий Разработчики локально используют разные версии плагинов → расхождения в генерированном коде и падения сборки Синдром «у меня работает» при различиях окружений Требуется ручная координация, чтобы вся команда была синхронизирована по версиям"},{"id":"api-service/overview::top::5","title":"Обзор API Service","section":"Операционные накладные расходы","path":"/docs/guide/api-service/overview","headings":["Операционные накладные расходы"],"excerpt":"Операционные накладные расходы DevOps тратят время на установку и обновление плагинов на рабочих станциях Новый разработчик — ручная настройка правильных версий Обновление плагинов требует коммуникации с каждым отдельно ","content":"Операционные накладные расходы DevOps тратят время на установку и обновление плагинов на рабочих станциях Новый разработчик — ручная настройка правильных версий Обновление плагинов требует коммуникации с каждым отдельно Нет централизованного контроля утверждённых версий"},{"id":"api-service/overview::top::6","title":"Обзор API Service","section":"Риски безопасности и комплаенса","path":"/docs/guide/api-service/overview","headings":["Риски безопасности и комплаенса"],"excerpt":"Риски безопасности и комплаенса Плагины ставятся из разных источников без валидации Нет аудита: какой плагин для какого билда использовался Сложно применять политики безопасности к инструментам генерации","content":"Риски безопасности и комплаенса Плагины ставятся из разных источников без валидации Нет аудита: какой плагин для какого билда использовался Сложно применять политики безопасности к инструментам генерации"},{"id":"api-service/overview::top::7","title":"Обзор API Service","section":"Решение: централизованный запуск плагинов","path":"/docs/guide/api-service/overview","headings":["Решение: централизованный запуск плагинов"],"excerpt":"Решение: централизованный запуск плагинов EasyP API Service решает эти проблемы за счёт централизованного управления:","content":"Решение: централизованный запуск плагинов EasyP API Service решает эти проблемы за счёт централизованного управления:"},{"id":"api-service/overview::top::8","title":"Обзор API Service","section":"Решение: централизованный запуск плагинов","path":"/docs/guide/api-service/overview","headings":["Решение: централизованный запуск плагинов"],"excerpt":"Решение: централизованный запуск плагинов Проблема Решение ---------- --------- **Контроль версий** Мгновенное распространение новых версий через Docker‑образы **Операции** Команда эксплуатации управляет конфигурациями б","content":"Решение: централизованный запуск плагинов Проблема Решение ---------- --------- **Контроль версий** Мгновенное распространение новых версий через Docker‑образы **Операции** Команда эксплуатации управляет конфигурациями без доступа на машины разработчиков **Безопасность** Все плагины запускаются в изолированных контейнерах с ограничениями ресурсов **Консистентность** Единая среда выполнения вне зависимости от локальной установки **Опыт разработчика** Не нужно устанавливать и сопровождать плагины локально"},{"id":"api-service/overview::top::9","title":"Обзор API Service","section":"Архитектура","path":"/docs/guide/api-service/overview","headings":["Архитектура"],"excerpt":"Архитектура Архитектура сервиса упрощена и сфокусирована на надёжном выполнении плагинов:","content":"Архитектура Архитектура сервиса упрощена и сфокусирована на надёжном выполнении плагинов:"},{"id":"api-service/overview::api-layer::10","title":"Обзор API Service","section":"API Layer","path":"/docs/guide/api-service/overview#api-layer","headings":["API Layer"],"excerpt":"API Layer **gRPC Server** — основной API для запросов генерации Каждый запуск плагина — отдельный gRPC‑запрос Получает CodeGeneratorRequest от CLI","content":"API Layer **gRPC Server** — основной API для запросов генерации Каждый запуск плагина — отдельный gRPC‑запрос Получает CodeGeneratorRequest от CLI"},{"id":"api-service/overview::execution-engine::11","title":"Обзор API Service","section":"Execution Engine","path":"/docs/guide/api-service/overview#execution-engine","headings":["Execution Engine"],"excerpt":"Execution Engine **Docker Runtime** — изолированный запуск плагинов Подтягивает образы из публичных реестров (Docker Hub и т.п.) Применяет лимиты CPU/памяти на плагин","content":"Execution Engine **Docker Runtime** — изолированный запуск плагинов Подтягивает образы из публичных реестров (Docker Hub и т.п.) Применяет лимиты CPU/памяти на плагин"},{"id":"api-service/overview::storage-layer::12","title":"Обзор API Service","section":"Storage Layer","path":"/docs/guide/api-service/overview#storage-layer","headings":["Storage Layer"],"excerpt":"Storage Layer **PostgreSQL** хранит параметры выполнения: - Ограничения ресурсов (CPU, память) - Конфигурацию и метаданные плагинов - Логи выполнения (аудит) - _Примечание: функциональность хранения будет расширяться_","content":"Storage Layer **PostgreSQL** хранит параметры выполнения: - Ограничения ресурсов (CPU, память) - Конфигурацию и метаданные плагинов - Логи выполнения (аудит) - _Примечание: функциональность хранения будет расширяться_"},{"id":"api-service/overview::monitoring::13","title":"Обзор API Service","section":"Monitoring","path":"/docs/guide/api-service/overview#monitoring","headings":["Monitoring"],"excerpt":"Monitoring **Prometheus** — сбор метрик Отслеживает время выполнения, успешность, использование ресурсов","content":"Monitoring **Prometheus** — сбор метрик Отслеживает время выполнения, успешность, использование ресурсов"},{"id":"api-service/overview::easyp-cli::14","title":"Обзор API Service","section":"Локальное выполнение (EasyP CLI)","path":"/docs/guide/api-service/overview#easyp-cli","headings":["Локальное выполнение (EasyP CLI)"],"excerpt":"Локальное выполнение (EasyP CLI) При локальном запуске CLI поддерживает: **Installed plugins**: системно установленные protoc плагины **WASM plugins**: лёгкие WebAssembly плагины","content":"Локальное выполнение (EasyP CLI) При локальном запуске CLI поддерживает: **Installed plugins**: системно установленные protoc плагины **WASM plugins**: лёгкие WebAssembly плагины"},{"id":"api-service/overview::api-service::15","title":"Обзор API Service","section":"Удалённое выполнение (API Service)","path":"/docs/guide/api-service/overview#api-service","headings":["Удалённое выполнение (API Service)"],"excerpt":"Удалённое выполнение (API Service) При работе через сервис: **Только Docker**: плагины запускаются как контейнеры **Центральный контроль**: операционная команда управляет доступными версиями **Консистентная среда**: один","content":"Удалённое выполнение (API Service) При работе через сервис: **Только Docker**: плагины запускаются как контейнеры **Центральный контроль**: операционная команда управляет доступными версиями **Консистентная среда**: одинаковое окружение для всех разработчиков"},{"id":"api-service/overview::top::16","title":"Обзор API Service","section":"Шаги выполнения","path":"/docs/guide/api-service/overview","headings":["Шаги выполнения"],"excerpt":"Шаги выполнения **CLI Parsing**: CLI парсит локальные .proto файлы **Request Sending**: Отправляет CodeGeneratorRequest в API Service (по одному на плагин) **Parameter Lookup**: Сервис получает параметры запуска из Postg","content":"Шаги выполнения **CLI Parsing**: CLI парсит локальные .proto файлы **Request Sending**: Отправляет CodeGeneratorRequest в API Service (по одному на плагин) **Parameter Lookup**: Сервис получает параметры запуска из PostgreSQL **Docker Execution**: Запускает плагин в изолированном контейнере **Metrics Recording**: Записывает метрики после завершения **Response**: Возвращает сгенерированный код обратно в CLI"},{"id":"api-service/overview::top::17","title":"Обзор API Service","section":"Ключевые возможности","path":"/docs/guide/api-service/overview","headings":["Ключевые возможности"],"excerpt":"Ключевые возможности Возможность Описание ------------- ---------- **🐳 Изоляция плагинов** Каждый плагин в отдельном безопасном контейнере **⚙️ Контроль ресурсов** Лимиты CPU и памяти на уровне контейнера **📊 Метрики &","content":"Ключевые возможности Возможность Описание ------------- ---------- **🐳 Изоляция плагинов** Каждый плагин в отдельном безопасном контейнере **⚙️ Контроль ресурсов** Лимиты CPU и памяти на уровне контейнера **📊 Метрики & мониторинг** Полный набор Prometheus метрик **🔄 Управление версиями** Централизованно через Docker‑образы **⚡ Простой протокол** Стандарт CodeGeneratorRequest/Response **🔒 Безопасность прежде всего** Изоляция + ограниченные ресурсы"},{"id":"api-service/overview::top::18","title":"Обзор API Service","section":"Конфигурация","path":"/docs/guide/api-service/overview","headings":["Конфигурация"],"excerpt":"Конфигурация Сервис настраивается через переменные окружения.","content":"Конфигурация Сервис настраивается через переменные окружения."},{"id":"api-service/overview::top::19","title":"Обзор API Service","section":"Хранение параметров плагинов","path":"/docs/guide/api-service/overview","headings":["Хранение параметров плагинов"],"excerpt":"Хранение параметров плагинов PostgreSQL хранит параметры выполнения для каждого плагина:","content":"Хранение параметров плагинов PostgreSQL хранит параметры выполнения для каждого плагина:"},{"id":"api-service/overview::top::20","title":"Обзор API Service","section":"Хранение параметров плагинов","path":"/docs/guide/api-service/overview","headings":["Хранение параметров плагинов"],"excerpt":"Хранение параметров плагинов ::: tip Схема хранения будет расширена — аудит логов, аналитика использования, кеширование плагинов. :::","content":"Хранение параметров плагинов ::: tip Схема хранения будет расширена — аудит логов, аналитика использования, кеширование плагинов. :::"},{"id":"api-service/overview::easyp-cli::21","title":"Обзор API Service","section":"Интеграция с EasyP CLI","path":"/docs/guide/api-service/overview#easyp-cli","headings":["Интеграция с EasyP CLI"],"excerpt":"Интеграция с EasyP CLI Пример easyp.yaml для удалённого запуска:","content":"Интеграция с EasyP CLI Пример easyp.yaml для удалённого запуска:"},{"id":"api-service/overview::easyp-cli::22","title":"Обзор API Service","section":"Интеграция с EasyP CLI","path":"/docs/guide/api-service/overview#easyp-cli","headings":["Интеграция с EasyP CLI"],"excerpt":"Интеграция с EasyP CLI Запуск генерации:","content":"Интеграция с EasyP CLI Запуск генерации:"},{"id":"api-service/overview::easyp-cli::23","title":"Обзор API Service","section":"Интеграция с EasyP CLI","path":"/docs/guide/api-service/overview#easyp-cli","headings":["Интеграция с EasyP CLI"],"excerpt":"Интеграция с EasyP CLI CLI: Парсит protobuf‑файлы Отправляет отдельные запросы в сервис для каждого плагина Получает ответы с кодом Записывает файлы в указанные директории","content":"Интеграция с EasyP CLI CLI: Парсит protobuf‑файлы Отправляет отдельные запросы в сервис для каждого плагина Получает ответы с кодом Записывает файлы в указанные директории"},{"id":"api-service/overview::top::24","title":"Обзор API Service","section":"Доступные метрики","path":"/docs/guide/api-service/overview","headings":["Доступные метрики"],"excerpt":"Доступные метрики Метрики Prometheus:","content":"Доступные метрики Метрики Prometheus:"},{"id":"api-service/overview::top::25","title":"Обзор API Service","section":"Доступные метрики","path":"/docs/guide/api-service/overview","headings":["Доступные метрики"],"excerpt":"Доступные метрики Метрика Описание --------- ---------- easyp_api_service_api_grpc_server_handled_total Общее число gRPC запросов по статусам easyp_api_service_api_grpc_server_handling_seconds Гистограмма задержек gRPC e","content":"Доступные метрики Метрика Описание --------- ---------- easyp_api_service_api_grpc_server_handled_total Общее число gRPC запросов по статусам easyp_api_service_api_grpc_server_handling_seconds Гистограмма задержек gRPC easyp_api_service_generated_plugin_code_total Выполнения плагинов по имени easyp_api_service_repo_call_duration_seconds Латентность запросов к БД easyp_api_service_repo_errors_total Количество ошибок доступа к БД easyp_api_service_standard_panics_total Число восстановленных паник"},{"id":"api-service/overview::top::26","title":"Обзор API Service","section":"Характеристики производительности","path":"/docs/guide/api-service/overview","headings":["Характеристики производительности"],"excerpt":"Характеристики производительности Показатель Типичное значение Примечания ----------- ------------------- ----------- **Cold Start** 2–5 сек Первая загрузка образа **Warm Start** 100–500 мс Образ закеширован **Throughput","content":"Характеристики производительности Показатель Типичное значение Примечания ----------- ------------------- ----------- **Cold Start** 2–5 сек Первая загрузка образа **Warm Start** 100–500 мс Образ закеширован **Throughput** 20–50 одновременных Зависит от ресурсов **Memory Usage** 50–200 MB На выполнение одного плагина"},{"id":"api-service/overview::top::27","title":"Обзор API Service","section":"Изоляция контейнеров","path":"/docs/guide/api-service/overview","headings":["Изоляция контейнеров"],"excerpt":"Изоляция контейнеров Каждый плагин в отдельном эфемерном контейнере Нет сетевого доступа в процессе выполнения Лимиты CPU/памяти через Docker Контейнер удаляется после завершения","content":"Изоляция контейнеров Каждый плагин в отдельном эфемерном контейнере Нет сетевого доступа в процессе выполнения Лимиты CPU/памяти через Docker Контейнер удаляется после завершения"},{"id":"api-service/overview::api::28","title":"Обзор API Service","section":"Безопасность API","path":"/docs/guide/api-service/overview#api","headings":["Безопасность API"],"excerpt":"Безопасность API gRPC транспорт Поддержка токенов аутентификации (в продакшн окружениях) Валидация входных данных Аудитные логи в PostgreSQL","content":"Безопасность API gRPC транспорт Поддержка токенов аутентификации (в продакшн окружениях) Валидация входных данных Аудитные логи в PostgreSQL"},{"id":"api-service/overview::top::29","title":"Обзор API Service","section":"Масштабирование","path":"/docs/guide/api-service/overview","headings":["Масштабирование"],"excerpt":"Масштабирование **Горизонтальное**: несколько инстансов за балансировщиком **Ресурсы**: настройка лимитов для тяжёлых плагинов **База данных**: репликация PostgreSQL для отказоустойчивости","content":"Масштабирование **Горизонтальное**: несколько инстансов за балансировщиком **Ресурсы**: настройка лимитов для тяжёлых плагинов **База данных**: репликация PostgreSQL для отказоустойчивости"},{"id":"api-service/overview::top::30","title":"Обзор API Service","section":"Мониторинг","path":"/docs/guide/api-service/overview","headings":["Мониторинг"],"excerpt":"Мониторинг **Метрики**: Prometheus **Алертинг**: оповещения на высокие ошибки/латентность **Логи**: структурированные для аудита и отладки","content":"Мониторинг **Метрики**: Prometheus **Алертинг**: оповещения на высокие ошибки/латентность **Логи**: структурированные для аудита и отладки"},{"id":"api-service/overview::top::31","title":"Обзор API Service","section":"План развития","path":"/docs/guide/api-service/overview","headings":["План развития"],"excerpt":"План развития Запланировано: Кеширование результатов генерации Расширенный аудит и аналитика использования Поддержка приватных реестров плагинов Более умное распределение ресурсов","content":"План развития Запланировано: Кеширование результатов генерации Расширенный аудит и аналитика использования Поддержка приватных реестров плагинов Более умное распределение ресурсов"},{"id":"api-service/overview::top::32","title":"Обзор API Service","section":"Сообщество и поддержка","path":"/docs/guide/api-service/overview","headings":["Сообщество и поддержка"],"excerpt":"Сообщество и поддержка **💬 Telegram чат** — обсуждения **🐛 GitHub Issues** — баги и запросы фич **📖 Документация** — полный набор материалов","content":"Сообщество и поддержка **💬 Telegram чат** — обсуждения **🐛 GitHub Issues** — баги и запросы фич **📖 Документация** — полный набор материалов"},{"id":"api-service/overview::top::33","title":"Обзор API Service","section":"Сообщество и поддержка","path":"/docs/guide/api-service/overview","headings":["Сообщество и поддержка"],"excerpt":"Сообщество и поддержка *Упростите свои protobuf‑воркфлоу с централизованным управлением выполнением плагинов.*","content":"Сообщество и поддержка *Упростите свои protobuf‑воркфлоу с централизованным управлением выполнением плагинов.*"},{"id":"ci-cd/github-actions::top::0","title":"GitHub Actions","path":"/docs/guide/ci-cd/github-actions","headings":[],"excerpt":"Полное руководство по интеграции EasyP в конвейеры GitHub Actions для линтинга, проверки несовместимых изменений, генерации кода и автоматизации релизов.","content":"Полное руководство по интеграции EasyP в конвейеры GitHub Actions для линтинга, проверки несовместимых изменений, генерации кода и автоматизации релизов."},{"id":"ci-cd/github-actions::easyp-ci::1","title":"GitHub Actions","section":"Зачем использовать EasyP в CI","path":"/docs/guide/ci-cd/github-actions#easyp-ci","headings":["Зачем использовать EasyP в CI"],"excerpt":"Зачем использовать EasyP в CI Встраивание EasyP в GitHub Actions даёт: Единообразие правил линтинга и генерации между разработчиками. Автоматическое выявление несовместимых изменений (breaking changes) до мержа. Гарантию","content":"Зачем использовать EasyP в CI Встраивание EasyP в GitHub Actions даёт: Единообразие правил линтинга и генерации между разработчиками. Автоматическое выявление несовместимых изменений (breaking changes) до мержа. Гарантию, что сгенерированный код не «устарел» относительно .proto. Возможность централизованной проверки зависимостей и версии конфигурации."},{"id":"ci-cd/github-actions::top::2","title":"GitHub Actions","section":"Предварительные требования","path":"/docs/guide/ci-cd/github-actions","headings":["Предварительные требования"],"excerpt":"Предварительные требования Репозиторий содержит файл конфигурации easyp.yaml (или находится в корне, если запускается без --cfg). Установлены / определены зависимости в секции deps (если нужны внешние импорты). Для прива","content":"Предварительные требования Репозиторий содержит файл конфигурации easyp.yaml (или находится в корне, если запускается без --cfg). Установлены / определены зависимости в секции deps (если нужны внешние импорты). Для приватных Git-репозиториев настроен доступ (SSH key / deploy key / токен). В workflow есть шаги по установке Go (если EasyP поставляется через go install) или заранее подготовленный бинарь."},{"id":"ci-cd/github-actions::top::3","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) Минимальный workflow для проверки линта и несовместимых изменений при открытия Pull Request:","content":"Базовый пример (быстрый старт) Минимальный workflow для проверки линта и несовместимых изменений при открытия Pull Request:"},{"id":"ci-cd/github-actions::top::4","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) ```yaml name: easyp-ci","content":"Базовый пример (быстрый старт) ```yaml name: easyp-ci"},{"id":"ci-cd/github-actions::top::5","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) on: pull_request: paths: - '**/*.proto' - 'easyp.yaml'","content":"Базовый пример (быстрый старт) on: pull_request: paths: - '**/*.proto' - 'easyp.yaml'"},{"id":"ci-cd/github-actions::top::6","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) jobs: lint-and-breaking: runs-on: ubuntu-latest","content":"Базовый пример (быстрый старт) jobs: lint-and-breaking: runs-on: ubuntu-latest"},{"id":"ci-cd/github-actions::top::7","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) steps: - name: Checkout uses: actions/checkout@v4","content":"Базовый пример (быстрый старт) steps: - name: Checkout uses: actions/checkout@v4"},{"id":"ci-cd/github-actions::top::8","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) name: Setup Go uses: actions/setup-go@v5 with: go-version: '1.22'","content":"Базовый пример (быстрый старт) name: Setup Go uses: actions/setup-go@v5 with: go-version: '1.22'"},{"id":"ci-cd/github-actions::top::9","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest","content":"Базовый пример (быстрый старт) name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest"},{"id":"ci-cd/github-actions::top::10","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) name: Verify EasyP version run: which easyp easyp version","content":"Базовый пример (быстрый старт) name: Verify EasyP version run: which easyp easyp version"},{"id":"ci-cd/github-actions::top::11","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) name: Lint run: easyp lint","content":"Базовый пример (быстрый старт) name: Lint run: easyp lint"},{"id":"ci-cd/github-actions::top::12","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) name: Breaking changes check (against main) run: easyp breaking --against git-ref=origin/main ```","content":"Базовый пример (быстрый старт) name: Breaking changes check (against main) run: easyp breaking --against git-ref=origin/main ```"},{"id":"ci-cd/github-actions::easyp::13","title":"GitHub Actions","section":"Установка EasyP","path":"/docs/guide/ci-cd/github-actions#easyp","headings":["Установка EasyP"],"excerpt":"Установка EasyP Варианты: Через go install (как в примере выше). Использование заранее собранного бинаря (артефакт релиза).","content":"Установка EasyP Варианты: Через go install (как в примере выше). Использование заранее собранного бинаря (артефакт релиза)."},{"id":"ci-cd/github-actions::top::14","title":"GitHub Actions","section":"Кэширование","path":"/docs/guide/ci-cd/github-actions","headings":["Кэширование"],"excerpt":"Кэширование Для ускорения повторных сборок можно кэшировать: Go модульный кеш (если используете генерацию с плагинами Go). Внешние зависимые Git-клонирования (папки vendor или содержимое deps при использовании easyp mod ","content":"Кэширование Для ускорения повторных сборок можно кэшировать: Go модульный кеш (если используете генерацию с плагинами Go). Внешние зависимые Git-клонирования (папки vendor или содержимое deps при использовании easyp mod download / easyp mod update). Сгенерированный код (если он тяжёлый, но чаще генерируется заново)."},{"id":"ci-cd/github-actions::top::15","title":"GitHub Actions","section":"Кэширование","path":"/docs/guide/ci-cd/github-actions","headings":["Кэширование"],"excerpt":"Кэширование Пример кэширования Go:","content":"Кэширование Пример кэширования Go:"},{"id":"ci-cd/github-actions::top::16","title":"GitHub Actions","section":"Кэширование","path":"/docs/guide/ci-cd/github-actions","headings":["Кэширование"],"excerpt":"Кэширование Пример кэширования каталога зависимостей EasyP (если вы используете локальный vendor-подход):","content":"Кэширование Пример кэширования каталога зависимостей EasyP (если вы используете локальный vendor-подход):"},{"id":"ci-cd/github-actions::top::17","title":"GitHub Actions","section":"Кэширование","path":"/docs/guide/ci-cd/github-actions","headings":["Кэширование"],"excerpt":"Кэширование (Создайте .easyp/deps как целевой каталог, если ваша стратегия скачивания такова.)","content":"Кэширование (Создайте .easyp/deps как целевой каталог, если ваша стратегия скачивания такова.)"},{"id":"ci-cd/github-actions::top::18","title":"GitHub Actions","section":"Линтинг","path":"/docs/guide/ci-cd/github-actions","headings":["Линтинг"],"excerpt":"Линтинг Рекомендуется: В PR: всегда запускать. На main: можно запускать для верификации перед релизом.","content":"Линтинг Рекомендуется: В PR: всегда запускать. На main: можно запускать для верификации перед релизом."},{"id":"ci-cd/github-actions::top::19","title":"GitHub Actions","section":"Линтинг","path":"/docs/guide/ci-cd/github-actions","headings":["Линтинг"],"excerpt":"Линтинг Расширенный пример с выводом подробностей и игнорированием комментариев (если включено в конфиг):","content":"Линтинг Расширенный пример с выводом подробностей и игнорированием комментариев (если включено в конфиг):"},{"id":"ci-cd/github-actions::breaking-changes::20","title":"GitHub Actions","section":"Проверка несовместимых изменений (Breaking Changes)","path":"/docs/guide/ci-cd/github-actions#breaking-changes","headings":["Проверка несовместимых изменений (Breaking Changes)"],"excerpt":"Проверка несовместимых изменений (Breaking Changes) EasyP может сравнивать текущее состояние против ветки / коммита / тега.","content":"Проверка несовместимых изменений (Breaking Changes) EasyP может сравнивать текущее состояние против ветки / коммита / тега."},{"id":"ci-cd/github-actions::breaking-changes::21","title":"GitHub Actions","section":"Проверка несовместимых изменений (Breaking Changes)","path":"/docs/guide/ci-cd/github-actions#breaking-changes","headings":["Проверка несовместимых изменений (Breaking Changes)"],"excerpt":"Проверка несовместимых изменений (Breaking Changes) Примеры: ```bash Сравнить против origin/main easyp breaking --against git-ref=origin/main","content":"Проверка несовместимых изменений (Breaking Changes) Примеры: ```bash Сравнить против origin/main easyp breaking --against git-ref=origin/main"},{"id":"ci-cd/github-actions::breaking-changes::22","title":"GitHub Actions","section":"Проверка несовместимых изменений (Breaking Changes)","path":"/docs/guide/ci-cd/github-actions#breaking-changes","headings":["Проверка несовместимых изменений (Breaking Changes)"],"excerpt":"Проверка несовместимых изменений (Breaking Changes) Сравнить против тега релиза easyp breaking --against git-ref=v1.5.2","content":"Проверка несовместимых изменений (Breaking Changes) Сравнить против тега релиза easyp breaking --against git-ref=v1.5.2"},{"id":"ci-cd/github-actions::breaking-changes::23","title":"GitHub Actions","section":"Проверка несовместимых изменений (Breaking Changes)","path":"/docs/guide/ci-cd/github-actions#breaking-changes","headings":["Проверка несовместимых изменений (Breaking Changes)"],"excerpt":"Проверка несовместимых изменений (Breaking Changes) Игнорировать определённые правила (если у вас настроено в easyp.yaml) easyp breaking ```","content":"Проверка несовместимых изменений (Breaking Changes) Игнорировать определённые правила (если у вас настроено в easyp.yaml) easyp breaking ```"},{"id":"ci-cd/github-actions::breaking-changes::24","title":"GitHub Actions","section":"Проверка несовместимых изменений (Breaking Changes)","path":"/docs/guide/ci-cd/github-actions#breaking-changes","headings":["Проверка несовместимых изменений (Breaking Changes)"],"excerpt":"Проверка несовместимых изменений (Breaking Changes) Workflow шаг:","content":"Проверка несовместимых изменений (Breaking Changes) Workflow шаг:"},{"id":"ci-cd/github-actions::breaking-changes::25","title":"GitHub Actions","section":"Проверка несовместимых изменений (Breaking Changes)","path":"/docs/guide/ci-cd/github-actions#breaking-changes","headings":["Проверка несовместимых изменений (Breaking Changes)"],"excerpt":"Проверка несовместимых изменений (Breaking Changes)","content":"Проверка несовместимых изменений (Breaking Changes)"},{"id":"ci-cd/github-actions::breaking-changes::26","title":"GitHub Actions","section":"Проверка несовместимых изменений (Breaking Changes)","path":"/docs/guide/ci-cd/github-actions#breaking-changes","headings":["Проверка несовместимых изменений (Breaking Changes)"],"excerpt":"Проверка несовместимых изменений (Breaking Changes) Если нужно «мягко» пропустить (например, выводить предупреждения, но не падать билд):","content":"Проверка несовместимых изменений (Breaking Changes) Если нужно «мягко» пропустить (например, выводить предупреждения, но не падать билд):"},{"id":"ci-cd/github-actions::breaking-changes::27","title":"GitHub Actions","section":"Проверка несовместимых изменений (Breaking Changes)","path":"/docs/guide/ci-cd/github-actions#breaking-changes","headings":["Проверка несовместимых изменений (Breaking Changes)"],"excerpt":"Проверка несовместимых изменений (Breaking Changes)","content":"Проверка несовместимых изменений (Breaking Changes)"},{"id":"ci-cd/github-actions::top::28","title":"GitHub Actions","section":"Генерация кода","path":"/docs/guide/ci-cd/github-actions","headings":["Генерация кода"],"excerpt":"Генерация кода Обычно для генерации:","content":"Генерация кода Обычно для генерации:"},{"id":"ci-cd/github-actions::top::29","title":"GitHub Actions","section":"Генерация кода","path":"/docs/guide/ci-cd/github-actions","headings":["Генерация кода"],"excerpt":"Генерация кода Если нужно явно указать конфиг:","content":"Генерация кода Если нужно явно указать конфиг:"},{"id":"ci-cd/github-actions::top::30","title":"GitHub Actions","section":"Генерация кода","path":"/docs/guide/ci-cd/github-actions","headings":["Генерация кода"],"excerpt":"Генерация кода Можно добавить проверку «не осталось ли не закоммиченных изменений» (гарантия, что сгенерированный код актуален):","content":"Генерация кода Можно добавить проверку «не осталось ли не закоммиченных изменений» (гарантия, что сгенерированный код актуален):"},{"id":"ci-cd/github-actions::matrix-strategy::31","title":"GitHub Actions","section":"Матрица (Matrix strategy)","path":"/docs/guide/ci-cd/github-actions#matrix-strategy","headings":["Матрица (Matrix strategy)"],"excerpt":"Матрица (Matrix strategy) Если у вас несколько вариантов конфигураций или разных языков генерации (через плагины), можно использовать matrix:","content":"Матрица (Matrix strategy) Если у вас несколько вариантов конфигураций или разных языков генерации (через плагины), можно использовать matrix:"},{"id":"ci-cd/github-actions::matrix-strategy::32","title":"GitHub Actions","section":"Матрица (Matrix strategy)","path":"/docs/guide/ci-cd/github-actions#matrix-strategy","headings":["Матрица (Matrix strategy)"],"excerpt":"Матрица (Matrix strategy) ```yaml jobs: generate: runs-on: ubuntu-latest strategy: fail-fast: false matrix: lang: [go, python] steps: - uses: actions/checkout@v4","content":"Матрица (Matrix strategy) ```yaml jobs: generate: runs-on: ubuntu-latest strategy: fail-fast: false matrix: lang: [go, python] steps: - uses: actions/checkout@v4"},{"id":"ci-cd/github-actions::matrix-strategy::33","title":"GitHub Actions","section":"Матрица (Matrix strategy)","path":"/docs/guide/ci-cd/github-actions#matrix-strategy","headings":["Матрица (Matrix strategy)"],"excerpt":"Матрица (Matrix strategy) name: Setup Go (only for go) if: matrix.lang == 'go' uses: actions/setup-go@v5 with: go-version: '1.22'","content":"Матрица (Matrix strategy) name: Setup Go (only for go) if: matrix.lang == 'go' uses: actions/setup-go@v5 with: go-version: '1.22'"},{"id":"ci-cd/github-actions::matrix-strategy::34","title":"GitHub Actions","section":"Матрица (Matrix strategy)","path":"/docs/guide/ci-cd/github-actions#matrix-strategy","headings":["Матрица (Matrix strategy)"],"excerpt":"Матрица (Matrix strategy) name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest","content":"Матрица (Matrix strategy) name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest"},{"id":"ci-cd/github-actions::matrix-strategy::35","title":"GitHub Actions","section":"Матрица (Matrix strategy)","path":"/docs/guide/ci-cd/github-actions#matrix-strategy","headings":["Матрица (Matrix strategy)"],"excerpt":"Матрица (Matrix strategy) name: Generate run: if [ \"${{ matrix.lang }}\" = \"go\" ]; then easyp generate elif [ \"${{ matrix.lang }}\" = \"python\" ]; then easyp generate --plugin python fi ```","content":"Матрица (Matrix strategy) name: Generate run: if [ \"${{ matrix.lang }}\" = \"go\" ]; then easyp generate elif [ \"${{ matrix.lang }}\" = \"python\" ]; then easyp generate --plugin python fi ```"},{"id":"ci-cd/github-actions::deps::36","title":"GitHub Actions","section":"Работа с приватными репозиториями (deps)","path":"/docs/guide/ci-cd/github-actions#deps","headings":["Работа с приватными репозиториями (deps)"],"excerpt":"Работа с приватными репозиториями (deps) Если вы указываете приватные Git-пакеты в секции deps:","content":"Работа с приватными репозиториями (deps) Если вы указываете приватные Git-пакеты в секции deps:"},{"id":"ci-cd/github-actions::deps::37","title":"GitHub Actions","section":"Работа с приватными репозиториями (deps)","path":"/docs/guide/ci-cd/github-actions#deps","headings":["Работа с приватными репозиториями (deps)"],"excerpt":"Работа с приватными репозиториями (deps) Настройте deploy key или используйте GIT_SSH_COMMAND с токеном. Добавьте known_hosts (либо установите StrictHostKeyChecking=no для внутренних систем, но осознанно).","content":"Работа с приватными репозиториями (deps) Настройте deploy key или используйте GIT_SSH_COMMAND с токеном. Добавьте known_hosts (либо установите StrictHostKeyChecking=no для внутренних систем, но осознанно)."},{"id":"ci-cd/github-actions::deps::38","title":"GitHub Actions","section":"Работа с приватными репозиториями (deps)","path":"/docs/guide/ci-cd/github-actions#deps","headings":["Работа с приватными репозиториями (deps)"],"excerpt":"Работа с приватными репозиториями (deps) Пример:","content":"Работа с приватными репозиториями (deps) Пример:"},{"id":"ci-cd/github-actions::deps::39","title":"GitHub Actions","section":"Работа с приватными репозиториями (deps)","path":"/docs/guide/ci-cd/github-actions#deps","headings":["Работа с приватными репозиториями (deps)"],"excerpt":"Работа с приватными репозиториями (deps) ```yaml name: Prepare SSH run: mkdir -p ~/.ssh echo \"${{ secrets.DEPLOY_KEY }}\" > ~/.ssh/id_rsa chmod 600 ~/.ssh/id_rsa ssh-keyscan github.com >> ~/.ssh/known_hosts","content":"Работа с приватными репозиториями (deps) ```yaml name: Prepare SSH run: mkdir -p ~/.ssh echo \"${{ secrets.DEPLOY_KEY }}\" > ~/.ssh/id_rsa chmod 600 ~/.ssh/id_rsa ssh-keyscan github.com >> ~/.ssh/known_hosts"},{"id":"ci-cd/github-actions::deps::40","title":"GitHub Actions","section":"Работа с приватными репозиториями (deps)","path":"/docs/guide/ci-cd/github-actions#deps","headings":["Работа с приватными репозиториями (deps)"],"excerpt":"Работа с приватными репозиториями (deps) name: Update deps run: easyp mod update ```","content":"Работа с приватными репозиториями (deps) name: Update deps run: easyp mod update ```"},{"id":"ci-cd/github-actions::top::41","title":"GitHub Actions","section":"Оптимизация времени сборки","path":"/docs/guide/ci-cd/github-actions","headings":["Оптимизация времени сборки"],"excerpt":"Оптимизация времени сборки Используйте кэш для Go / deps. Запускайте линт/брейкинг только если изменились .proto или easyp.yaml (paths фильтр). Разделяйте workflow: быстрый линт в PR, тяжелая генерация в push на main. Вы","content":"Оптимизация времени сборки Используйте кэш для Go / deps. Запускайте линт/брейкинг только если изменились .proto или easyp.yaml (paths фильтр). Разделяйте workflow: быстрый линт в PR, тяжелая генерация в push на main. Выносите генерацию OpenAPI / gRPC-Gateway в отдельный job (параллелизм)."},{"id":"ci-cd/github-actions::workflow::42","title":"GitHub Actions","section":"Продвинутый workflow (многостадийный)","path":"/docs/guide/ci-cd/github-actions#workflow","headings":["Продвинутый workflow (многостадийный)"],"excerpt":"Продвинутый workflow (многостадийный) ```yaml name: easyp-pipeline","content":"Продвинутый workflow (многостадийный) ```yaml name: easyp-pipeline"},{"id":"ci-cd/github-actions::workflow::43","title":"GitHub Actions","section":"Продвинутый workflow (многостадийный)","path":"/docs/guide/ci-cd/github-actions#workflow","headings":["Продвинутый workflow (многостадийный)"],"excerpt":"Продвинутый workflow (многостадийный) on: pull_request: paths: - '**/*.proto' - 'easyp.yaml' push: branches: - main","content":"Продвинутый workflow (многостадийный) on: pull_request: paths: - '**/*.proto' - 'easyp.yaml' push: branches: - main"},{"id":"ci-cd/github-actions::workflow::44","title":"GitHub Actions","section":"Продвинутый workflow (многостадийный)","path":"/docs/guide/ci-cd/github-actions#workflow","headings":["Продвинутый workflow (многостадийный)"],"excerpt":"Продвинутый workflow (многостадийный) jobs: validate: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4","content":"Продвинутый workflow (многостадийный) jobs: validate: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4"},{"id":"ci-cd/github-actions::workflow::45","title":"GitHub Actions","section":"Продвинутый workflow (многостадийный)","path":"/docs/guide/ci-cd/github-actions#workflow","headings":["Продвинутый workflow (многостадийный)"],"excerpt":"Продвинутый workflow (многостадийный) uses: actions/setup-go@v5 with: go-version: '1.22'","content":"Продвинутый workflow (многостадийный) uses: actions/setup-go@v5 with: go-version: '1.22'"},{"id":"ci-cd/github-actions::workflow::46","title":"GitHub Actions","section":"Продвинутый workflow (многостадийный)","path":"/docs/guide/ci-cd/github-actions#workflow","headings":["Продвинутый workflow (многостадийный)"],"excerpt":"Продвинутый workflow (многостадийный) name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest","content":"Продвинутый workflow (многостадийный) name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest"},{"id":"ci-cd/github-actions::workflow::47","title":"GitHub Actions","section":"Продвинутый workflow (многостадийный)","path":"/docs/guide/ci-cd/github-actions#workflow","headings":["Продвинутый workflow (многостадийный)"],"excerpt":"Продвинутый workflow (многостадийный) name: Lint run: easyp lint","content":"Продвинутый workflow (многостадийный) name: Lint run: easyp lint"},{"id":"ci-cd/github-actions::workflow::48","title":"GitHub Actions","section":"Продвинутый workflow (многостадийный)","path":"/docs/guide/ci-cd/github-actions#workflow","headings":["Продвинутый workflow (многостадийный)"],"excerpt":"Продвинутый workflow (многостадийный) name: Breaking check (against main) if: github.event_name == 'pull_request' run: easyp breaking --against git-ref=origin/main","content":"Продвинутый workflow (многостадийный) name: Breaking check (against main) if: github.event_name == 'pull_request' run: easyp breaking --against git-ref=origin/main"},{"id":"ci-cd/github-actions::workflow::49","title":"GitHub Actions","section":"Продвинутый workflow (многостадийный)","path":"/docs/guide/ci-cd/github-actions#workflow","headings":["Продвинутый workflow (многостадийный)"],"excerpt":"Продвинутый workflow (многостадийный) generate: needs: validate if: github.event_name == 'push' runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-go@v5 with: go-version: '1.22' - name: Insta","content":"Продвинутый workflow (многостадийный) generate: needs: validate if: github.event_name == 'push' runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-go@v5 with: go-version: '1.22' - name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest - name: Generate Code run: easyp generate - name: Check diffs run: if [ -n \"$(git status --porcelain)\" ]; then echo \"Generated files changed after generate step.\" git diff --name-only exit 1 fi ```"},{"id":"ci-cd/github-actions::top::50","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) Можно добавить workflow, который по тегу создаёт релиз и валидирует proto:","content":"Автоматизация релиза (пример) Можно добавить workflow, который по тегу создаёт релиз и валидирует proto:"},{"id":"ci-cd/github-actions::top::51","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) ```yaml name: release-verify","content":"Автоматизация релиза (пример) ```yaml name: release-verify"},{"id":"ci-cd/github-actions::top::52","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) on: push: tags: - 'v*.*.*'","content":"Автоматизация релиза (пример) on: push: tags: - 'v*.*.*'"},{"id":"ci-cd/github-actions::top::53","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) jobs: release-check: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4","content":"Автоматизация релиза (пример) jobs: release-check: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4"},{"id":"ci-cd/github-actions::top::54","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) uses: actions/setup-go@v5 with: go-version: '1.22'","content":"Автоматизация релиза (пример) uses: actions/setup-go@v5 with: go-version: '1.22'"},{"id":"ci-cd/github-actions::top::55","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest","content":"Автоматизация релиза (пример) name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest"},{"id":"ci-cd/github-actions::top::56","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) name: Lint run: easyp lint","content":"Автоматизация релиза (пример) name: Lint run: easyp lint"},{"id":"ci-cd/github-actions::top::57","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) name: Breaking vs previous tag run: PREV_TAG=$(git tag --sort=-creatordate grep -v \"${GITHUB_REF_NAME}\" head -n1 true) if [ -n \"$PREV_TAG\" ]; then echo \"Comparing against $PREV_TAG\" easyp br","content":"Автоматизация релиза (пример) name: Breaking vs previous tag run: PREV_TAG=$(git tag --sort=-creatordate grep -v \"${GITHUB_REF_NAME}\" head -n1 true) if [ -n \"$PREV_TAG\" ]; then echo \"Comparing against $PREV_TAG\" easyp breaking --against git-ref=$PREV_TAG else echo \"No previous tag, skipping breaking check\" fi"},{"id":"ci-cd/github-actions::top::58","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) name: Generate to ensure consistency run: easyp generate ```","content":"Автоматизация релиза (пример) name: Generate to ensure consistency run: easyp generate ```"},{"id":"ci-cd/github-actions::top::59","title":"GitHub Actions","section":"Отладка","path":"/docs/guide/ci-cd/github-actions","headings":["Отладка"],"excerpt":"Отладка Если нужно больше логов:","content":"Отладка Если нужно больше логов:"},{"id":"ci-cd/github-actions::top::60","title":"GitHub Actions","section":"Отладка","path":"/docs/guide/ci-cd/github-actions","headings":["Отладка"],"excerpt":"Отладка Добавьте вывод окружения для диагностики:","content":"Отладка Добавьте вывод окружения для диагностики:"},{"id":"ci-cd/github-actions::top::61","title":"GitHub Actions","section":"Переменные окружения (примерно)","path":"/docs/guide/ci-cd/github-actions","headings":["Переменные окружения (примерно)"],"excerpt":"Переменные окружения (примерно) Переменная Назначение ------------ ----------- EASYP_SERVICE_HOST Хост удалённого API Service (если используете удалённые плагины) EASYP_SERVICE_GRPC_PORT Порт удалённого сервиса GIT_SSH_C","content":"Переменные окружения (примерно) Переменная Назначение ------------ ----------- EASYP_SERVICE_HOST Хост удалённого API Service (если используете удалённые плагины) EASYP_SERVICE_GRPC_PORT Порт удалённого сервиса GIT_SSH_COMMAND Кастомная команда SSH (частные репозитории) GOFLAGS Можно выставить -mod=readonly для Go генерации"},{"id":"ci-cd/github-actions::top::62","title":"GitHub Actions","section":"Переменные окружения (примерно)","path":"/docs/guide/ci-cd/github-actions","headings":["Переменные окружения (примерно)"],"excerpt":"Переменные окружения (примерно) (Используйте только те, что действительно нужны вашему проекту.)","content":"Переменные окружения (примерно) (Используйте только те, что действительно нужны вашему проекту.)"},{"id":"ci-cd/github-actions::top::63","title":"GitHub Actions","section":"Частые ошибки","path":"/docs/guide/ci-cd/github-actions","headings":["Частые ошибки"],"excerpt":"Частые ошибки Симптом Причина Решение --------- --------- --------- Линт падает на неизвестных правилах Правила указаны в easyp.yaml, но версия EasyP их не поддерживает Обновить EasyP (go install ...@latest) breaking сра","content":"Частые ошибки Симптом Причина Решение --------- --------- --------- Линт падает на неизвестных правилах Правила указаны в easyp.yaml, но версия EasyP их не поддерживает Обновить EasyP (go install ...@latest) breaking сравнение ничего не находит Неверный --against (нет fetch удалённой ветки) Добавить шаг git fetch --all --tags Сгенерированный код в PR отличается от main Отсутствует проверка генерации в CI Добавить шаг «Ensure generated code is up-to-date» Приватные deps не скачиваются Нет SSH ключа или токена Настроить secrets + шаг подготовки SSH Долгое выполнение Отсутствует кеш Добавить кэширование модулей и deps"},{"id":"ci-cd/github-actions::top::64","title":"GitHub Actions","section":"Рекомендации по поддержке","path":"/docs/guide/ci-cd/github-actions","headings":["Рекомендации по поддержке"],"excerpt":"Рекомендации по поддержке Заготовить шаблон workflow и копировать между сервисами (DRY). Включить paths фильтры, чтобы не тратить минуты на нерелевантные изменения. Проверять easyp.yaml при изменениях отдельно — можно за","content":"Рекомендации по поддержке Заготовить шаблон workflow и копировать между сервисами (DRY). Включить paths фильтры, чтобы не тратить минуты на нерелевантные изменения. Проверять easyp.yaml при изменениях отдельно — можно запускать «конфигурационный тест» (например, easyp lint без файлов, чтобы убедиться, что конфиг валиден). При появлении новых правил линтера обновляйте конфиг и фиксируйте ошибки сразу в одной ветке."},{"id":"ci-cd/github-actions::top::65","title":"GitHub Actions","section":"Рекомендации по поддержке","path":"/docs/guide/ci-cd/github-actions","headings":["Рекомендации по поддержке"],"excerpt":"Рекомендации по поддержке Готово: вы можете расширять разделы генерации, добавлять OpenAPI / grpc-gateway / validate плагины, матрицы по языкам и интегрировать тесты поверх сгенерированного кода, если требуется.","content":"Рекомендации по поддержке Готово: вы можете расширять разделы генерации, добавлять OpenAPI / grpc-gateway / validate плагины, матрицы по языкам и интегрировать тесты поверх сгенерированного кода, если требуется."},{"id":"ci-cd/gitlab::top::0","title":"GitLab CI","section":"В процессе разработки","path":"/docs/guide/ci-cd/gitlab","headings":["В процессе разработки"],"excerpt":"В процессе разработки Документация по интеграции EasyP с GitLab CI находится в процессе подготовки. Планируемые разделы: Быстрый старт (пример .gitlab-ci.yml для линтинга и проверки несовместимых изменений) Кэширование з","content":"В процессе разработки Документация по интеграции EasyP с GitLab CI находится в процессе подготовки. Планируемые разделы: Быстрый старт (пример .gitlab-ci.yml для линтинга и проверки несовместимых изменений) Кэширование зависимостей и ускорение сборок Генерация кода и проверка актуальности артефактов Работа с приватными Git-репозиториями в deps Матрицы (parallel jobs) для разных языков и плагинов Автоматизация релизов по тегам"},{"id":"ci-cd/gitlab::top::1","title":"GitLab CI","section":"В процессе разработки","path":"/docs/guide/ci-cd/gitlab","headings":["В процессе разработки"],"excerpt":"В процессе разработки Если вам нужен пример прямо сейчас, базовый минимальный вариант может выглядеть так:","content":"В процессе разработки Если вам нужен пример прямо сейчас, базовый минимальный вариант может выглядеть так:"},{"id":"ci-cd/gitlab::top::2","title":"GitLab CI","section":"В процессе разработки","path":"/docs/guide/ci-cd/gitlab","headings":["В процессе разработки"],"excerpt":"В процессе разработки ```yaml stages: - validate - generate","content":"В процессе разработки ```yaml stages: - validate - generate"},{"id":"ci-cd/gitlab::top::3","title":"GitLab CI","section":"В процессе разработки","path":"/docs/guide/ci-cd/gitlab","headings":["В процессе разработки"],"excerpt":"В процессе разработки variables: GO_VERSION: \"1.22\"","content":"В процессе разработки variables: GO_VERSION: \"1.22\""},{"id":"ci-cd/gitlab::top::4","title":"GitLab CI","section":"В процессе разработки","path":"/docs/guide/ci-cd/gitlab","headings":["В процессе разработки"],"excerpt":"В процессе разработки validate: stage: validate image: golang:${GO_VERSION} before_script: - go install github.com/easyp-tech/easyp/cmd/easyp@latest - echo \"EasyP version:\" - easyp version # При необходимости: git fetch ","content":"В процессе разработки validate: stage: validate image: golang:${GO_VERSION} before_script: - go install github.com/easyp-tech/easyp/cmd/easyp@latest - echo \"EasyP version:\" - easyp version # При необходимости: git fetch --all --tags script: - easyp lint - easyp breaking --against git-ref=origin/main only: changes: - \"**/*.proto\" - \"easyp.yaml\""},{"id":"ci-cd/gitlab::top::5","title":"GitLab CI","section":"В процессе разработки","path":"/docs/guide/ci-cd/gitlab","headings":["В процессе разработки"],"excerpt":"В процессе разработки generate: stage: generate image: golang:${GO_VERSION} before_script: - go install github.com/easyp-tech/easyp/cmd/easyp@latest script: - easyp generate - if [ -n \"$(git status --porcelain)\" ]; then ","content":"В процессе разработки generate: stage: generate image: golang:${GO_VERSION} before_script: - go install github.com/easyp-tech/easyp/cmd/easyp@latest script: - easyp generate - if [ -n \"$(git status --porcelain)\" ]; then echo \"Сгенерированный код не актуален. Закоммитьте изменения локально.\" git diff --name-only exit 1 fi only: - main"},{"id":"ci-cd/gitlab::top::6","title":"GitLab CI","section":"В процессе разработки","path":"/docs/guide/ci-cd/gitlab","headings":["В процессе разработки"],"excerpt":"В процессе разработки Дополнительные рекомендации будут добавлены позже.","content":"В процессе разработки Дополнительные рекомендации будут добавлены позже."},{"id":"cli/auto-completion/auto-completion::zsh::0","title":"Автодополнение","section":"Автодополнение для zsh","path":"/docs/guide/cli/auto-completion/auto-completion#zsh","headings":["Автодополнение для zsh"],"excerpt":"Автодополнение для zsh Добавьте следующую строку в ваш файл запуска ~/.zshrc:","content":"Автодополнение для zsh Добавьте следующую строку в ваш файл запуска ~/.zshrc:"},{"id":"cli/auto-completion/auto-completion::zsh::1","title":"Автодополнение","section":"Автодополнение для zsh","path":"/docs/guide/cli/auto-completion/auto-completion#zsh","headings":["Автодополнение для zsh"],"excerpt":"Автодополнение для zsh Перезапустите оболочку или выполните:","content":"Автодополнение для zsh Перезапустите оболочку или выполните:"},{"id":"cli/auto-completion/auto-completion::bash::2","title":"Автодополнение","section":"Автодополнение для Bash","path":"/docs/guide/cli/auto-completion/auto-completion#bash","headings":["Автодополнение для Bash"],"excerpt":"Автодополнение для Bash Установите bash-completion и подключите его в ~/.bashrc. Добавьте следующую строку в файл запуска ~/.bashrc:","content":"Автодополнение для Bash Установите bash-completion и подключите его в ~/.bashrc. Добавьте следующую строку в файл запуска ~/.bashrc:"},{"id":"cli/auto-completion/auto-completion::bash::3","title":"Автодополнение","section":"Автодополнение для Bash","path":"/docs/guide/cli/auto-completion/auto-completion#bash","headings":["Автодополнение для Bash"],"excerpt":"Автодополнение для Bash Перезапустите оболочку или выполните:","content":"Автодополнение для Bash Перезапустите оболочку или выполните:"},{"id":"cli/auto-completion/auto-completion::top::4","title":"Автодополнение","section":"Примечания","path":"/docs/guide/cli/auto-completion/auto-completion","headings":["Примечания"],"excerpt":"Примечания Команда easyp completion выводит скрипт автодополнения для соответствующей оболочки. Если используете другую оболочку (например, fish), можно сгенерировать вывод и сохранить вручную: При обновлении версии Easy","content":"Примечания Команда easyp completion выводит скрипт автодополнения для соответствующей оболочки. Если используете другую оболочку (например, fish), можно сгенерировать вывод и сохранить вручную: При обновлении версии EasyP рекомендуется заново перезагрузить оболочку, чтобы подтянуть возможные изменения в автодополнении."},{"id":"cli/breaking-changes/breaking-changes::top::0","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":[],"excerpt":"Обнаружение несовместимых изменений (Breaking Changes Detection)","content":"Обнаружение несовместимых изменений (Breaking Changes Detection)"},{"id":"cli/breaking-changes/breaking-changes::top::1","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":[],"excerpt":"Механизм EasyP для обнаружения несовместимых (breaking) изменений помогает поддерживать обратную совместимость ваших protobuf API, автоматически выявляя изменения, способные сломать существующих клиентов. Это критично дл","content":"Механизм EasyP для обнаружения несовместимых (breaking) изменений помогает поддерживать обратную совместимость ваших protobuf API, автоматически выявляя изменения, способные сломать существующих клиентов. Это критично для стабильных API в продакшене."},{"id":"cli/breaking-changes/breaking-changes::top::2","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Обзор","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Обзор"],"excerpt":"Обзор Проверка несовместимых изменений сравнивает текущий набор protobuf‑файлов с предыдущей версией (обычно из другой Git ветки) и фиксирует модификации, которые могут вызвать проблемы совместимости для уже работающих к","content":"Обзор Проверка несовместимых изменений сравнивает текущий набор protobuf‑файлов с предыдущей версией (обычно из другой Git ветки) и фиксирует модификации, которые могут вызвать проблемы совместимости для уже работающих клиентов."},{"id":"cli/breaking-changes/breaking-changes::top::3","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Ключевые возможности","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Ключевые возможности"],"excerpt":"Ключевые возможности **Сравнение через Git**: Сопоставление с любой Git‑ссылкой (ветка, тег, commit) **Комплексный анализ**: Проверка сервисов, сообщений, enum'ов, полей и import'ов **Выборочное игнорирование**: Пропуск ","content":"Ключевые возможности **Сравнение через Git**: Сопоставление с любой Git‑ссылкой (ветка, тег, commit) **Комплексный анализ**: Проверка сервисов, сообщений, enum'ов, полей и import'ов **Выборочное игнорирование**: Пропуск указанных директорий из анализа **Детализированные отчёты**: Понятные ошибки с именами файлов, строками и позициями"},{"id":"cli/breaking-changes/breaking-changes::top::4","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Как работает","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Как работает"],"excerpt":"Как работает Детектор breaking changes выполняет следующие шаги:","content":"Как работает Детектор breaking changes выполняет следующие шаги:"},{"id":"cli/breaking-changes/breaking-changes::top::5","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Как работает","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Как работает"],"excerpt":"Как работает **Получение ветки сравнения**: Забирает proto-файлы из указанной Git‑ссылки **Парсинг обеих версий**: Анализирует структуру текущих и предыдущих файлов **Сравнение сущностей**: Последовательно проверяет все ","content":"Как работает **Получение ветки сравнения**: Забирает proto-файлы из указанной Git‑ссылки **Парсинг обеих версий**: Анализирует структуру текущих и предыдущих файлов **Сравнение сущностей**: Последовательно проверяет все элементы protobuf на breaking изменения **Формирование отчёта**: Генерирует подробные записи об ошибках с локациями и описаниями"},{"id":"cli/breaking-changes/breaking-changes::top::6","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Уровень проверки","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Уровень проверки"],"excerpt":"Уровень проверки EasyP реализует уровень проверки **WIRE+**: ✅ **Полная совместимость по wire‑формату** — старые и новые версии могут обмениваться данными ✅ **Обнаружение удалений элементов** — сервисы, сообщения, поля и","content":"Уровень проверки EasyP реализует уровень проверки **WIRE+**: ✅ **Полная совместимость по wire‑формату** — старые и новые версии могут обмениваться данными ✅ **Обнаружение удалений элементов** — сервисы, сообщения, поля и т.п. ✅ **Безопасность типов** — выявляет несовместимые изменения типов ❌ **Переименования полей/методов** — пока не детектируются (в планах) ❌ **Изменения на уровне файлов** — переносы пакетов, file options ещё не проверяются"},{"id":"cli/breaking-changes/breaking-changes::top::7","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Уровень проверки","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Уровень проверки"],"excerpt":"Уровень проверки Это даёт сильные гарантии совместимости и меньше ограничений, чем инструменты, требующие совместимости сгенерированного кода.","content":"Уровень проверки Это даёт сильные гарантии совместимости и меньше ограничений, чем инструменты, требующие совместимости сгенерированного кода."},{"id":"cli/breaking-changes/breaking-changes::top::8","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Конфигурация","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Конфигурация"],"excerpt":"Конфигурация Настройка в easyp.yaml:","content":"Конфигурация Настройка в easyp.yaml:"},{"id":"cli/breaking-changes/breaking-changes::top::9","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Параметры конфигурации","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Параметры конфигурации"],"excerpt":"Параметры конфигурации Option Description Default Required -------- ------------- --------- ---------- against_git_ref Git‑ссылка для сравнения \"master\" No ignore Список директорий для исключения из анализа [] No","content":"Параметры конфигурации Option Description Default Required -------- ------------- --------- ---------- against_git_ref Git‑ссылка для сравнения \"master\" No ignore Список директорий для исключения из анализа [] No"},{"id":"cli/breaking-changes/breaking-changes::top::10","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Базовый пример","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Базовый пример"],"excerpt":"Базовый пример Сравнение текущих изменений с веткой main:","content":"Базовый пример Сравнение текущих изменений с веткой main:"},{"id":"cli/breaking-changes/breaking-changes::top::11","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Использование файла конфигурации","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Использование файла конфигурации"],"excerpt":"Использование файла конфигурации","content":"Использование файла конфигурации"},{"id":"cli/breaking-changes/breaking-changes::top::12","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Уровень проверки","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Уровень проверки"],"excerpt":"Уровень проверки EasyP сейчас работает на уровне **WIRE+**, обеспечивая совместимость wire‑формата плюс защиту от удалений и изменения критичных типов.","content":"Уровень проверки EasyP сейчас работает на уровне **WIRE+**, обеспечивая совместимость wire‑формата плюс защиту от удалений и изменения критичных типов."},{"id":"cli/breaking-changes/breaking-changes::buf::13","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Сравнение с категориями Buf","path":"/docs/guide/cli/breaking-changes/breaking-changes#buf","headings":["Сравнение с категориями Buf"],"excerpt":"Сравнение с категориями Buf Check Type Buf WIRE Buf WIRE_JSON Buf FILE EasyP Current ------------ ---------- --------------- ---------- --------------- **Element Deletions** Service deletion ❌ ❌ ✅ ✅ RPC method deletion ❌","content":"Сравнение с категориями Buf Check Type Buf WIRE Buf WIRE_JSON Buf FILE EasyP Current ------------ ---------- --------------- ---------- --------------- **Element Deletions** Service deletion ❌ ❌ ✅ ✅ RPC method deletion ❌ ❌ ✅ ✅ Message deletion ❌ ❌ ✅ ✅ Field deletion (by number) ✅ ✅ ✅ ✅ Enum deletion ❌ ❌ ✅ ✅ Enum value deletion ✅ ✅ ✅ ✅ OneOf deletion ❌ ❌ ✅ ✅ Import deletion ❌ ❌ ✅ ✅ **Type Changes** Field type change ✅ ✅ ✅ ✅ RPC request/response type ✅ ✅ ✅ ✅ Optional/required changes ✅ ✅ ✅ ✅ **Naming (Generated Code)** Field rename (same number) ❌ ✅ ✅ ❌ Enum value rename ❌ ✅ ✅ ✅ **File Structure** Package change ✅ ✅ ✅ ❌ File options (go_package, etc) ❌ ❌ ✅ ❌ Moving types between files ❌ ❌ ✅ ❌"},{"id":"cli/breaking-changes/breaking-changes::top::14","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Что это означает","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Что это означает"],"excerpt":"Что это означает **✅ EasyP обнаружит:** Все breaking изменения wire‑формата Удаления сервисов, методов, сообщений, полей Изменения типов, ломающие сериализацию Переименования enum‑значений (при сохранении номера)","content":"Что это означает **✅ EasyP обнаружит:** Все breaking изменения wire‑формата Удаления сервисов, методов, сообщений, полей Изменения типов, ломающие сериализацию Переименования enum‑значений (при сохранении номера)"},{"id":"cli/breaking-changes/breaking-changes::top::15","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Что это означает","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Что это означает"],"excerpt":"Что это означает **❌ EasyP НЕ обнаружит:** Переименование полей (с тем же номером) Изменение package File options (go_package, java_package, и т.п.) Перемещение типов между файлами в одном package","content":"Что это означает **❌ EasyP НЕ обнаружит:** Переименование полей (с тем же номером) Изменение package File options (go_package, java_package, и т.п.) Перемещение типов между файлами в одном package"},{"id":"cli/breaking-changes/breaking-changes::breaking-changes::16","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Правила Breaking Changes","path":"/docs/guide/cli/breaking-changes/breaking-changes#breaking-changes","headings":["Правила Breaking Changes"],"excerpt":"Правила Breaking Changes EasyP обнаруживает следующие типы breaking изменений:","content":"Правила Breaking Changes EasyP обнаруживает следующие типы breaking изменений:"},{"id":"cli/breaking-changes/breaking-changes::top::17","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Сравнение уровней","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Сравнение уровней"],"excerpt":"Сравнение уровней Detection Level Description EasyP Support ---------------- ------------- --------------- **WIRE** Совместимость только по wire‑формату ✅ **Full support** **WIRE+** Wire + обнаружение удалений ✅ **Curren","content":"Сравнение уровней Detection Level Description EasyP Support ---------------- ------------- --------------- **WIRE** Совместимость только по wire‑формату ✅ **Full support** **WIRE+** Wire + обнаружение удалений ✅ **Current level** **FILE** Совместимость сгенерированного кода ❌ Partial (planned)"},{"id":"cli/breaking-changes/breaking-changes::top::18","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Категории правил","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Категории правил"],"excerpt":"Категории правил Каждая категория имеет свою документацию с примерами:","content":"Категории правил Каждая категория имеет свою документацию с примерами:"},{"id":"cli/breaking-changes/breaking-changes::service-rpc::19","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"🚨 Изменения Service и RPC","path":"/docs/guide/cli/breaking-changes/breaking-changes#service-rpc","headings":["🚨 Изменения Service и RPC"],"excerpt":"🚨 Изменения Service и RPC Rule Description Status ------ ------------- --------- SERVICE_NO_DELETE Services cannot be deleted ✅ Implemented RPC_NO_DELETE RPC methods cannot be deleted ✅ Implemented RPC_SAME_REQUEST_TYPE","content":"🚨 Изменения Service и RPC Rule Description Status ------ ------------- --------- SERVICE_NO_DELETE Services cannot be deleted ✅ Implemented RPC_NO_DELETE RPC methods cannot be deleted ✅ Implemented RPC_SAME_REQUEST_TYPE RPC request types cannot be changed ✅ Implemented RPC_SAME_RESPONSE_TYPE RPC response types cannot be changed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::message-field::20","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"📦 Изменения Message и Field","path":"/docs/guide/cli/breaking-changes/breaking-changes#message-field","headings":["📦 Изменения Message и Field"],"excerpt":"📦 Изменения Message и Field Rule Description Status ------ ------------- --------- MESSAGE_NO_DELETE Messages cannot be deleted ✅ Implemented FIELD_NO_DELETE Fields cannot be deleted ✅ Implemented FIELD_SAME_TYPE Field ","content":"📦 Изменения Message и Field Rule Description Status ------ ------------- --------- MESSAGE_NO_DELETE Messages cannot be deleted ✅ Implemented FIELD_NO_DELETE Fields cannot be deleted ✅ Implemented FIELD_SAME_TYPE Field types cannot be changed ✅ Implemented FIELD_SAME_CARDINALITY Field optionality (optional/required) cannot be changed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::enum::21","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"🔢 Изменения Enum","path":"/docs/guide/cli/breaking-changes/breaking-changes#enum","headings":["🔢 Изменения Enum"],"excerpt":"🔢 Изменения Enum Rule Description Status ------ ------------- --------- ENUM_NO_DELETE Enums cannot be deleted ✅ Implemented ENUM_VALUE_NO_DELETE Enum values cannot be deleted ✅ Implemented ENUM_VALUE_SAME_NAME Enum val","content":"🔢 Изменения Enum Rule Description Status ------ ------------- --------- ENUM_NO_DELETE Enums cannot be deleted ✅ Implemented ENUM_VALUE_NO_DELETE Enum values cannot be deleted ✅ Implemented ENUM_VALUE_SAME_NAME Enum value names cannot be changed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::oneof::22","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"🔗 Изменения OneOf","path":"/docs/guide/cli/breaking-changes/breaking-changes#oneof","headings":["🔗 Изменения OneOf"],"excerpt":"🔗 Изменения OneOf Rule Description Status ------ ------------- --------- ONEOF_NO_DELETE OneOf fields cannot be deleted ✅ Implemented ONEOF_FIELD_NO_DELETE Fields within oneofs cannot be deleted ✅ Implemented ONEOF_FIEL","content":"🔗 Изменения OneOf Rule Description Status ------ ------------- --------- ONEOF_NO_DELETE OneOf fields cannot be deleted ✅ Implemented ONEOF_FIELD_NO_DELETE Fields within oneofs cannot be deleted ✅ Implemented ONEOF_FIELD_SAME_TYPE OneOf field types cannot be changed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::import::23","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"📥 Изменения Import","path":"/docs/guide/cli/breaking-changes/breaking-changes#import","headings":["📥 Изменения Import"],"excerpt":"📥 Изменения Import Rule Description Status ------ ------------- --------- IMPORT_NO_DELETE Import statements cannot be removed ✅ Implemented","content":"📥 Изменения Import Rule Description Status ------ ------------- --------- IMPORT_NO_DELETE Import statements cannot be removed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::top::24","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Не обнаруживается сейчас","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Не обнаруживается сейчас"],"excerpt":"Не обнаруживается сейчас Изменения ниже **НЕ детектируются** EasyP (могут ломать сгенерированный код):","content":"Не обнаруживается сейчас Изменения ниже **НЕ детектируются** EasyP (могут ломать сгенерированный код):"},{"id":"cli/breaking-changes/breaking-changes::top::25","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Не обнаруживается сейчас","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Не обнаруживается сейчас"],"excerpt":"Не обнаруживается сейчас Change Type Example Impact ------------- --------- -------- Field renaming string name = 1 → string full_name = 1 Ломает код Package changes package v1 → package v2 Меняются пути импорта File opt","content":"Не обнаруживается сейчас Change Type Example Impact ------------- --------- -------- Field renaming string name = 1 → string full_name = 1 Ломает код Package changes package v1 → package v2 Меняются пути импорта File options option go_package = \"old\" → option go_package = \"new\" Меняется расположение кода Moving between files Message перемещено в другой .proto Зависимости import'ов"},{"id":"cli/breaking-changes/breaking-changes::top::26","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Документация правил","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Документация правил"],"excerpt":"Документация правил См. подробные файлы правил для примеров и стратегий миграции:","content":"Документация правил См. подробные файлы правил для примеров и стратегий миграции:"},{"id":"cli/breaking-changes/breaking-changes::top::27","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Документация правил","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Документация правил"],"excerpt":"Документация правил Service: SERVICE_NO_DELETE, RPC_NO_DELETE, RPC_SAME_REQUEST_TYPE, RPC_SAME_RESPONSE_TYPE Message: MESSAGE_NO_DELETE, FIELD_NO_DELETE, FIELD_SAME_TYPE, FIELD_SAME_CARDINALITY Enum: ENUM_NO_DELETE, ENUM","content":"Документация правил Service: SERVICE_NO_DELETE, RPC_NO_DELETE, RPC_SAME_REQUEST_TYPE, RPC_SAME_RESPONSE_TYPE Message: MESSAGE_NO_DELETE, FIELD_NO_DELETE, FIELD_SAME_TYPE, FIELD_SAME_CARDINALITY Enum: ENUM_NO_DELETE, ENUM_VALUE_NO_DELETE, ENUM_VALUE_SAME_NAME OneOf: ONEOF_NO_DELETE, ONEOF_FIELD_NO_DELETE, ONEOF_FIELD_SAME_TYPE Import: IMPORT_NO_DELETE"},{"id":"cli/breaking-changes/breaking-changes::top::28","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Документация правил","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Документация правил"],"excerpt":"Документация правил Каждое правило содержит: ❌ Плохие примеры (breaking) ✅ Безопасные альтернативы 🔧 Стратегии миграции 📋 Реальные сообщения ошибок из EasyP","content":"Документация правил Каждое правило содержит: ❌ Плохие примеры (breaking) ✅ Безопасные альтернативы 🔧 Стратегии миграции 📋 Реальные сообщения ошибок из EasyP"},{"id":"cli/breaking-changes/breaking-changes::top::29","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"✅ Безопасные изменения (разрешены всегда)","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["✅ Безопасные изменения (разрешены всегда)"],"excerpt":"✅ Безопасные изменения (разрешены всегда) ```proto // Добавление новых элементов — безопасно message User { string name = 1; string email = 2; string phone = 3; // ✅ Новое поле }","content":"✅ Безопасные изменения (разрешены всегда) ```proto // Добавление новых элементов — безопасно message User { string name = 1; string email = 2; string phone = 3; // ✅ Новое поле }"},{"id":"cli/breaking-changes/breaking-changes::top::30","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"✅ Безопасные изменения (разрешены всегда)","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["✅ Безопасные изменения (разрешены всегда)"],"excerpt":"✅ Безопасные изменения (разрешены всегда) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc GetUserProfile(GetUserRequest) returns (UserProfile); // ✅ Новый RPC }","content":"✅ Безопасные изменения (разрешены всегда) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc GetUserProfile(GetUserRequest) returns (UserProfile); // ✅ Новый RPC }"},{"id":"cli/breaking-changes/breaking-changes::top::31","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"✅ Безопасные изменения (разрешены всегда)","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["✅ Безопасные изменения (разрешены всегда)"],"excerpt":"✅ Безопасные изменения (разрешены всегда) enum Status { STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; STATUS_PENDING = 2; // ✅ Новое enum значение } ```","content":"✅ Безопасные изменения (разрешены всегда) enum Status { STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; STATUS_PENDING = 2; // ✅ Новое enum значение } ```"},{"id":"cli/breaking-changes/breaking-changes::top::32","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"❌ Несовместимые изменения (обнаруживаются всегда)","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["❌ Несовместимые изменения (обнаруживаются всегда)"],"excerpt":"❌ Несовместимые изменения (обнаруживаются всегда) ```proto // Удаления и смена типов ломают совместимость message User { string name = 1; // ❌ Удалённое поле }","content":"❌ Несовместимые изменения (обнаруживаются всегда) ```proto // Удаления и смена типов ломают совместимость message User { string name = 1; // ❌ Удалённое поле }"},{"id":"cli/breaking-changes/breaking-changes::top::33","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"❌ Несовместимые изменения (обнаруживаются всегда)","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["❌ Несовместимые изменения (обнаруживаются всегда)"],"excerpt":"❌ Несовместимые изменения (обнаруживаются всегда) service UserService { // ❌ Удалённый RPC метод rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // ❌ Изменён тип запроса } ```","content":"❌ Несовместимые изменения (обнаруживаются всегда) service UserService { // ❌ Удалённый RPC метод rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // ❌ Изменён тип запроса } ```"},{"id":"cli/breaking-changes/breaking-changes::top::34","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Сценарий: Изменения пока не детектируются","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Сценарий: Изменения пока не детектируются"],"excerpt":"Сценарий: Изменения пока не детектируются ```proto // 🟡 Ломает сгенерированный код, но проходит проверки EasyP message User { string user_name = 1; // Переименовано с \"name\" string user_email = 2; // Переименовано с \"em","content":"Сценарий: Изменения пока не детектируются ```proto // 🟡 Ломает сгенерированный код, но проходит проверки EasyP message User { string user_name = 1; // Переименовано с \"name\" string user_email = 2; // Переименовано с \"email\" }"},{"id":"cli/breaking-changes/breaking-changes::top::35","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Сценарий: Изменения пока не детектируются","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Сценарий: Изменения пока не детектируются"],"excerpt":"Сценарий: Изменения пока не детектируются service UserService { rpc GetUserProfile(GetUserRequest) returns (GetUserResponse); // Переименовано с GetUser } ```","content":"Сценарий: Изменения пока не детектируются service UserService { rpc GetUserProfile(GetUserRequest) returns (GetUserResponse); // Переименовано с GetUser } ```"},{"id":"cli/breaking-changes/breaking-changes::top::36","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Текстовый формат (по умолчанию)","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Текстовый формат (по умолчанию)"],"excerpt":"Текстовый формат (по умолчанию)","content":"Текстовый формат (по умолчанию)"},{"id":"cli/breaking-changes/breaking-changes::1::37","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"1. Регулярный запуск","path":"/docs/guide/cli/breaking-changes/breaking-changes#1","headings":["1. Регулярный запуск"],"excerpt":"Регулярный запуск Добавьте проверку несовместимых изменений в CI/CD:","content":"Регулярный запуск Добавьте проверку несовместимых изменений в CI/CD:"},{"id":"cli/breaking-changes/breaking-changes::2::38","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"2. Защита веток","path":"/docs/guide/cli/breaking-changes/breaking-changes#2","headings":["2. Защита веток"],"excerpt":"Защита веток Блокируйте слияния с breaking изменениями:","content":"Защита веток Блокируйте слияния с breaking изменениями:"},{"id":"cli/breaking-changes/breaking-changes::3::39","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"3. Стратегия версионирования","path":"/docs/guide/cli/breaking-changes/breaking-changes#3","headings":["3. Стратегия версионирования"],"excerpt":"Стратегия версионирования При необходимости breaking изменений: Создайте новую версию пакета (myservice.v2) Поддерживайте старую версию в период миграции Добавляйте уведомления о деприкации","content":"Стратегия версионирования При необходимости breaking изменений: Создайте новую версию пакета (myservice.v2) Поддерживайте старую версию в период миграции Добавляйте уведомления о деприкации"},{"id":"cli/breaking-changes/breaking-changes::4::40","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"4. Игнорирование путей","path":"/docs/guide/cli/breaking-changes/breaking-changes#4","headings":["4. Игнорирование путей"],"excerpt":"Игнорирование путей Используйте ignore осознанно:","content":"Игнорирование путей Используйте ignore осознанно:"},{"id":"cli/breaking-changes/breaking-changes::repository-does-not-exist::41","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Проблема: \"Repository does not exist\"","path":"/docs/guide/cli/breaking-changes/breaking-changes#repository-does-not-exist","headings":["Проблема: \"Repository does not exist\""],"excerpt":"Проблема: \"Repository does not exist\" Решение: Выполняйте команду внутри Git репозитория с нужной веткой.","content":"Проблема: \"Repository does not exist\" Решение: Выполняйте команду внутри Git репозитория с нужной веткой."},{"id":"cli/breaking-changes/breaking-changes::cannot-find-git-ref::42","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Проблема: \"Cannot find git ref\"","path":"/docs/guide/cli/breaking-changes/breaking-changes#cannot-find-git-ref","headings":["Проблема: \"Cannot find git ref\""],"excerpt":"Проблема: \"Cannot find git ref\" Решение: Проверьте наличие ссылки:","content":"Проблема: \"Cannot find git ref\" Решение: Проверьте наличие ссылки:"},{"id":"cli/breaking-changes/breaking-changes::top::43","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Проблема: Ложные срабатывания на сгенерированный код","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Проблема: Ложные срабатывания на сгенерированный код"],"excerpt":"Проблема: Ложные срабатывания на сгенерированный код Решение: Исключите директории генерации:","content":"Проблема: Ложные срабатывания на сгенерированный код Решение: Исключите директории генерации:"},{"id":"cli/breaking-changes/breaking-changes::top::44","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Проблема: Очень много изменений","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Проблема: Очень много изменений"],"excerpt":"Проблема: Очень много изменений Решение: Создайте новую версию API Вносите изменения постепенно Используйте feature flags","content":"Проблема: Очень много изменений Решение: Создайте новую версию API Вносите изменения постепенно Используйте feature flags"},{"id":"cli/breaking-changes/breaking-changes::github-actions::45","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"GitHub Actions","path":"/docs/guide/cli/breaking-changes/breaking-changes#github-actions","headings":["GitHub Actions"],"excerpt":"GitHub Actions ```yaml name: API Compatibility Check","content":"GitHub Actions ```yaml name: API Compatibility Check"},{"id":"cli/breaking-changes/breaking-changes::github-actions::46","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"GitHub Actions","path":"/docs/guide/cli/breaking-changes/breaking-changes#github-actions","headings":["GitHub Actions"],"excerpt":"GitHub Actions on: pull_request: branches: [ main ]","content":"GitHub Actions on: pull_request: branches: [ main ]"},{"id":"cli/breaking-changes/breaking-changes::github-actions::47","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"GitHub Actions","path":"/docs/guide/cli/breaking-changes/breaking-changes#github-actions","headings":["GitHub Actions"],"excerpt":"GitHub Actions jobs: breaking-changes: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 with: fetch-depth: 0 - name: Install EasyP run: curl -sSfL https://raw.githubusercontent.com/easyp-tech/easyp/main/install.","content":"GitHub Actions jobs: breaking-changes: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 with: fetch-depth: 0 - name: Install EasyP run: curl -sSfL https://raw.githubusercontent.com/easyp-tech/easyp/main/install.sh sh - name: Check for breaking changes run: ./bin/easyp breaking --against origin/main ```"},{"id":"cli/breaking-changes/breaking-changes::pre-commit-pre-push-hook::48","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Pre-commit / pre-push hook","path":"/docs/guide/cli/breaking-changes/breaking-changes#pre-commit-pre-push-hook","headings":["Pre-commit / pre-push hook"],"excerpt":"Pre-commit / pre-push hook ```bash #!/bin/sh .git/hooks/pre-push","content":"Pre-commit / pre-push hook ```bash #!/bin/sh .git/hooks/pre-push"},{"id":"cli/breaking-changes/breaking-changes::pre-commit-pre-push-hook::49","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Pre-commit / pre-push hook","path":"/docs/guide/cli/breaking-changes/breaking-changes#pre-commit-pre-push-hook","headings":["Pre-commit / pre-push hook"],"excerpt":"Pre-commit / pre-push hook protected_branch='main' current_branch=$(git symbolic-ref HEAD sed -e 's,.*/\\(.*\\),\\1,')","content":"Pre-commit / pre-push hook protected_branch='main' current_branch=$(git symbolic-ref HEAD sed -e 's,.*/\\(.*\\),\\1,')"},{"id":"cli/breaking-changes/breaking-changes::pre-commit-pre-push-hook::50","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Pre-commit / pre-push hook","path":"/docs/guide/cli/breaking-changes/breaking-changes#pre-commit-pre-push-hook","headings":["Pre-commit / pre-push hook"],"excerpt":"Pre-commit / pre-push hook if [ $current_branch = $protected_branch ]; then echo \"Running breaking changes check...\" easyp breaking --against HEAD~1 if [ $? -eq 1 ]; then echo \"❌ Breaking changes detected. Push rejected.","content":"Pre-commit / pre-push hook if [ $current_branch = $protected_branch ]; then echo \"Running breaking changes check...\" easyp breaking --against HEAD~1 if [ $? -eq 1 ]; then echo \"❌ Breaking changes detected. Push rejected.\" exit 1 fi echo \"✅ No breaking changes detected.\" fi ```"},{"id":"cli/breaking-changes/breaking-changes::top::51","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Режим отладки","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Режим отладки"],"excerpt":"Режим отладки Включите debug‑логирование:","content":"Режим отладки Включите debug‑логирование:"},{"id":"cli/breaking-changes/breaking-changes::top::52","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Ручное сравнение","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Ручное сравнение"],"excerpt":"Ручное сравнение Для сложных случаев:","content":"Ручное сравнение Для сложных случаев:"},{"id":"cli/breaking-changes/breaking-changes::top::53","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Оптимизация производительности","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Оптимизация производительности"],"excerpt":"Оптимизация производительности Ограничьте область:","content":"Оптимизация производительности Ограничьте область:"},{"id":"cli/breaking-changes/breaking-changes::top::54","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Оптимизация производительности","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Оптимизация производительности"],"excerpt":"Оптимизация производительности","content":"Оптимизация производительности"},{"id":"cli/breaking-changes/breaking-changes::top::55","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Оптимизация производительности","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Оптимизация производительности"],"excerpt":"Оптимизация производительности Механизм обнаружения несовместимых изменений в EasyP обеспечивает надёжную основу для безопасной эволюции protobuf‑схем при сохранении совместимости API.","content":"Оптимизация производительности Механизм обнаружения несовместимых изменений в EasyP обеспечивает надёжную основу для безопасной эволюции protobuf‑схем при сохранении совместимости API."},{"id":"cli/breaking-changes/rules/enum-no-delete::top::0","title":"ENUM_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":[],"excerpt":"Это правило проверяет, что ни один enum не был удалён из proto‑файлов. Удаление enum ломает совместимость по wire‑формату и сгенерированный код: сохранённые данные могут содержать удалённые значения, а клиентский код опи","content":"Это правило проверяет, что ни один enum не был удалён из proto‑файлов. Удаление enum ломает совместимость по wire‑формату и сгенерированный код: сохранённые данные могут содержать удалённые значения, а клиентский код опирается на сгенерированные типы и константы enum."},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::1","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::2","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::3","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::4","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum UserRole { // [!code --] USER_ROLE_UNSPECIFIED = 0; // [!code --] USER_ROLE_ADMIN = 1; // [!code --] USER_ROLE_USER = 2; // [!code --] } // [!code --]","content":"Плохой (Breaking) enum UserRole { // [!code --] USER_ROLE_UNSPECIFIED = 0; // [!code --] USER_ROLE_ADMIN = 1; // [!code --] USER_ROLE_USER = 2; // [!code --] } // [!code --]"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::5","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3; } ```","content":"Плохой (Breaking) message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3; } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::6","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::7","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::8","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::9","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) // UserRole enum удалён — BREAKING CHANGE!","content":"Плохой (Breaking) // UserRole enum удалён — BREAKING CHANGE!"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::10","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3; // ERROR: UserRole больше не существует } ```","content":"Плохой (Breaking) message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3; // ERROR: UserRole больше не существует } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::11","title":"ENUM_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Удаление вложенного enum:** ```proto // Before message User { string name = 1; Status status = 2; enum Status { // [!code --] STATUS_UNSPECIFIED = 0; // [!code --] STATUS_ACTIVE = 1; // [!code --","content":"Дополнительные примеры **Удаление вложенного enum:** ```proto // Before message User { string name = 1; Status status = 2; enum Status { // [!code --] STATUS_UNSPECIFIED = 0; // [!code --] STATUS_ACTIVE = 1; // [!code --] STATUS_INACTIVE = 2; // [!code --] } // [!code --] }"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::12","title":"ENUM_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - BREAKING CHANGE! message User { string name = 1; Status status = 2; // ERROR: Status удалён // Вложенный enum Status удалён } ```","content":"Дополнительные примеры // After - BREAKING CHANGE! message User { string name = 1; Status status = 2; // ERROR: Status удалён // Вложенный enum Status удалён } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::13","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления — пометить enum deprecated:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления — пометить enum deprecated:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::14","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::15","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::16","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum UserRole { option deprecated = true; // [!code focus] USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_USER = 2; }","content":"Хороший (Безопасный) enum UserRole { option deprecated = true; // [!code focus] USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_USER = 2; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::17","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3 [deprecated = true]; // [!code focus] } ```","content":"Хороший (Безопасный) message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3 [deprecated = true]; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::18","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или заменить новым enum:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или заменить новым enum:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::19","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::20","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::21","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum UserRole { option deprecated = true; // [!code focus] // Старый enum USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_USER = 2; }","content":"Хороший (Безопасный) enum UserRole { option deprecated = true; // [!code focus] // Старый enum USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_USER = 2; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::22","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum UserPermission { // [!code focus] // Новый enum USER_PERMISSION_UNSPECIFIED = 0; // [!code focus] USER_PERMISSION_READ = 1; // [!code focus] USER_PERMISSION_WRITE = 2; // [!code focus] USER_PERM","content":"Хороший (Безопасный) enum UserPermission { // [!code focus] // Новый enum USER_PERMISSION_UNSPECIFIED = 0; // [!code focus] USER_PERMISSION_READ = 1; // [!code focus] USER_PERMISSION_WRITE = 2; // [!code focus] USER_PERMISSION_ADMIN = 3; // [!code focus] } // [!code focus]"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::23","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3 [deprecated = true]; // [!code focus] UserPermission created_by_permission = 4; // [!code focus] } ```","content":"Хороший (Безопасный) message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3 [deprecated = true]; // [!code focus] UserPermission created_by_permission = 4; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::24","title":"ENUM_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Данные с удалённым enum не десериализуются корректно **Generated Code:** Тип и константы удаляются — компиляция клиентов ломается **Field References:** Поля с типом удалённого enum становятся нев","content":"Влияние **Wire Format:** Данные с удалённым enum не десериализуются корректно **Generated Code:** Тип и константы удаляются — компиляция клиентов ломается **Field References:** Поля с типом удалённого enum становятся невалидны **Switch Statements:** switch по enum ломается (неизвестные кейсы)"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::25","title":"ENUM_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается:** ```go // Before order := &myapi.Order{ Id: \"order123\", Status: myapi.OrderStatus_ORDER_STATUS_PENDING, CreatedByRole: myapi.UserRole_USER_ROLE_ADMIN, // ERROR после удаления }","content":"Реальный пример **Код клиента ломается:** ```go // Before order := &myapi.Order{ Id: \"order123\", Status: myapi.OrderStatus_ORDER_STATUS_PENDING, CreatedByRole: myapi.UserRole_USER_ROLE_ADMIN, // ERROR после удаления }"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::26","title":"ENUM_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример switch order.CreatedByRole { case myapi.UserRole_USER_ROLE_ADMIN: // ERROR // Admin logic case myapi.UserRole_USER_ROLE_USER: // ERROR // User logic }","content":"Реальный пример switch order.CreatedByRole { case myapi.UserRole_USER_ROLE_ADMIN: // ERROR // Admin logic case myapi.UserRole_USER_ROLE_USER: // ERROR // User logic }"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::27","title":"ENUM_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример // undefined: myapi.UserRole // undefined: myapi.UserRole_USER_ROLE_ADMIN ```","content":"Реальный пример // undefined: myapi.UserRole // undefined: myapi.UserRole_USER_ROLE_ADMIN ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::28","title":"ENUM_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Старые данные становятся нечитаемыми:**","content":"Реальный пример **Старые данные становятся нечитаемыми:**"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::29","title":"ENUM_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Серверная логика ломается:**","content":"Реальный пример **Серверная логика ломается:**"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::30","title":"ENUM_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Депрецируйте enum:** **Пометьте поля со старым enum deprecated:** **Создайте новый enum:** **Сервер обрабатывает оба:** **Удалите старый enum в следующей major‑версии.**","content":"Стратегия миграции **Депрецируйте enum:** **Пометьте поля со старым enum deprecated:** **Создайте новый enum:** **Сервер обрабатывает оба:** **Удалите старый enum в следующей major‑версии.**"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum::31","title":"ENUM_NO_DELETE","section":"Редизайн enum","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum","headings":["Редизайн enum"],"excerpt":"Редизайн enum ```proto enum Priority { option deprecated = true; PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_HIGH = 2; }","content":"Редизайн enum ```proto enum Priority { option deprecated = true; PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_HIGH = 2; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum::32","title":"ENUM_NO_DELETE","section":"Редизайн enum","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum","headings":["Редизайн enum"],"excerpt":"Редизайн enum enum TaskPriority { TASK_PRIORITY_UNSPECIFIED = 0; TASK_PRIORITY_LOW = 1; TASK_PRIORITY_MEDIUM = 2; TASK_PRIORITY_HIGH = 3; TASK_PRIORITY_URGENT = 4; } ```","content":"Редизайн enum enum TaskPriority { TASK_PRIORITY_UNSPECIFIED = 0; TASK_PRIORITY_LOW = 1; TASK_PRIORITY_MEDIUM = 2; TASK_PRIORITY_HIGH = 3; TASK_PRIORITY_URGENT = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum::33","title":"ENUM_NO_DELETE","section":"Консолидация enum","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum","headings":["Консолидация enum"],"excerpt":"Консолидация enum ```proto enum Status { option deprecated = true; STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; }","content":"Консолидация enum ```proto enum Status { option deprecated = true; STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum::34","title":"ENUM_NO_DELETE","section":"Консолидация enum","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum","headings":["Консолидация enum"],"excerpt":"Консолидация enum enum State { option deprecated = true; STATE_UNSPECIFIED = 0; STATE_ENABLED = 1; }","content":"Консолидация enum enum State { option deprecated = true; STATE_UNSPECIFIED = 0; STATE_ENABLED = 1; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum::35","title":"ENUM_NO_DELETE","section":"Консолидация enum","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum","headings":["Консолидация enum"],"excerpt":"Консолидация enum enum EntityStatus { ENTITY_STATUS_UNSPECIFIED = 0; ENTITY_STATUS_ACTIVE = 1; ENTITY_STATUS_INACTIVE = 2; ENTITY_STATUS_ENABLED = 3; ENTITY_STATUS_DISABLED = 4; } ```","content":"Консолидация enum enum EntityStatus { ENTITY_STATUS_UNSPECIFIED = 0; ENTITY_STATUS_ACTIVE = 1; ENTITY_STATUS_INACTIVE = 2; ENTITY_STATUS_ENABLED = 3; ENTITY_STATUS_DISABLED = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum::36","title":"ENUM_NO_DELETE","section":"Перемещение enum в новый пакет","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum","headings":["Перемещение enum в новый пакет"],"excerpt":"Перемещение enum в новый пакет ```proto enum UserRole { option deprecated = true; USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; }","content":"Перемещение enum в новый пакет ```proto enum UserRole { option deprecated = true; USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum::37","title":"ENUM_NO_DELETE","section":"Перемещение enum в новый пакет","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum","headings":["Перемещение enum в новый пакет"],"excerpt":"Перемещение enum в новый пакет import \"common/roles.proto\";","content":"Перемещение enum в новый пакет import \"common/roles.proto\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum::38","title":"ENUM_NO_DELETE","section":"Перемещение enum в новый пакет","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum","headings":["Перемещение enum в новый пакет"],"excerpt":"Перемещение enum в новый пакет message Order { UserRole old_role = 3 [deprecated = true]; common.UserRole new_role = 4; } ```","content":"Перемещение enum в новый пакет message Order { UserRole old_role = 3 [deprecated = true]; common.UserRole new_role = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::39","title":"ENUM_NO_DELETE","section":"Версионирование / новая версия пакета","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Версионирование / новая версия пакета"],"excerpt":"Версионирование / новая версия пакета ```proto package myapi.v2;","content":"Версионирование / новая версия пакета ```proto package myapi.v2;"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::40","title":"ENUM_NO_DELETE","section":"Версионирование / новая версия пакета","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Версионирование / новая версия пакета"],"excerpt":"Версионирование / новая версия пакета enum UserPermission { USER_PERMISSION_UNSPECIFIED = 0; USER_PERMISSION_READ = 1; USER_PERMISSION_WRITE = 2; USER_PERMISSION_ADMIN = 3; }","content":"Версионирование / новая версия пакета enum UserPermission { USER_PERMISSION_UNSPECIFIED = 0; USER_PERMISSION_READ = 1; USER_PERMISSION_WRITE = 2; USER_PERMISSION_ADMIN = 3; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::41","title":"ENUM_NO_DELETE","section":"Версионирование / новая версия пакета","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Версионирование / новая версия пакета"],"excerpt":"Версионирование / новая версия пакета message Order { string id = 1; UserPermission created_by_permission = 2; } ```","content":"Версионирование / новая версия пакета message Order { string id = 1; UserPermission created_by_permission = 2; } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::0","title":"ENUM_VALUE_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":[],"excerpt":"Правило проверяет, что ни одно значение enum (enum value) не было удалено. Удаление значения ломает совместимость по wire‑формату и сгенерированный код: в уже сохранённых данных могут присутствовать удалённые значения, а","content":"Правило проверяет, что ни одно значение enum (enum value) не было удалено. Удаление значения ломает совместимость по wire‑формату и сгенерированный код: в уже сохранённых данных могут присутствовать удалённые значения, а клиентский код может ссылаться на соответствующие константы."},{"id":"cli/breaking-changes/rules/enum-value-no-delete::breaking::1","title":"ENUM_VALUE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::breaking::2","title":"ENUM_VALUE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::breaking::3","title":"ENUM_VALUE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; ORDER_STATUS_CANCELLED = 5; }","content":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; ORDER_STATUS_CANCELLED = 5; }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::breaking::4","title":"ENUM_VALUE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; PRIORITY_URGENT = 4; } ```","content":"Плохой (Breaking) enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; PRIORITY_URGENT = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::breaking::5","title":"ENUM_VALUE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::breaking::6","title":"ENUM_VALUE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::breaking::7","title":"ENUM_VALUE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; // ORDER_STATUS_CANCELLED = 5; // [!code --] ","content":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; // ORDER_STATUS_CANCELLED = 5; // [!code --] Удалено значение enum — BREAKING! }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::breaking::8","title":"ENUM_VALUE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; // PRIORITY_URGENT = 4; // [!code --] Удалено значение enum — BREAKING! } ```","content":"Плохой (Breaking) enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; // PRIORITY_URGENT = 4; // [!code --] Удалено значение enum — BREAKING! } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::9","title":"ENUM_VALUE_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Множественное удаление значений:** ```proto // Before enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_GUEST = 1; USER_ROLE_USER = 2; USER_ROLE_MODERATOR = 3; USER_ROLE_ADMIN = 4; USER_ROLE_S","content":"Дополнительные примеры **Множественное удаление значений:** ```proto // Before enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_GUEST = 1; USER_ROLE_USER = 2; USER_ROLE_MODERATOR = 3; USER_ROLE_ADMIN = 4; USER_ROLE_SUPERADMIN = 5; }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::10","title":"ENUM_VALUE_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - BREAKING CHANGES! enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_USER = 2; USER_ROLE_ADMIN = 4; // USER_ROLE_GUEST = 1; // BREAKING: deleted // USER_ROLE_MODERATOR = 3; // BREAKING","content":"Дополнительные примеры // After - BREAKING CHANGES! enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_USER = 2; USER_ROLE_ADMIN = 4; // USER_ROLE_GUEST = 1; // BREAKING: deleted // USER_ROLE_MODERATOR = 3; // BREAKING: deleted // USER_ROLE_SUPERADMIN = 5; // BREAKING: deleted } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::11","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления — пометить значения deprecated:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления — пометить значения deprecated:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::12","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::13","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; ORDER_STATUS_CANCELLED = 5 [deprecated = t","content":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; ORDER_STATUS_CANCELLED = 5 [deprecated = true]; // [!code focus] }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::14","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; PRIORITY_URGENT = 4 [deprecated = true]; // [!code focus] } ```","content":"Хороший (Безопасный) enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; PRIORITY_URGENT = 4 [deprecated = true]; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::15","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или зарезервировать номер и имя после удаления:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или зарезервировать номер и имя после удаления:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::16","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::17","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum OrderStatus { reserved 5; // [!code focus] reserved \"ORDER_STATUS_CANCELLED\"; // [!code focus]","content":"Хороший (Безопасный) enum OrderStatus { reserved 5; // [!code focus] reserved \"ORDER_STATUS_CANCELLED\"; // [!code focus]"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::18","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Хороший (Безопасный) ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::19","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum Priority { reserved 4; // [!code focus] reserved \"PRIORITY_URGENT\"; // [!code focus]","content":"Хороший (Безопасный) enum Priority { reserved 4; // [!code focus] reserved \"PRIORITY_URGENT\"; // [!code focus]"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::20","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; } ```","content":"Хороший (Безопасный) PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::21","title":"ENUM_VALUE_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Данные с удалёнными значениями не десериализуются корректно **Generated Code:** Константы исчезают — клиентский код не компилируется **Client Applications:** Ссылки на удалённые значения вызывают","content":"Влияние **Wire Format:** Данные с удалёнными значениями не десериализуются корректно **Generated Code:** Константы исчезают — клиентский код не компилируется **Client Applications:** Ссылки на удалённые значения вызывают ошибки компиляции **Switch Statements:** switch по enum ломается (неизвестные case) **Default Handling:** Поведение при неизвестных значениях меняется"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::22","title":"ENUM_VALUE_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается:** ```go order := &myapi.Order{ Status: myapi.OrderStatus_ORDER_STATUS_CANCELLED, // ERROR после удаления }","content":"Реальный пример **Код клиента ломается:** ```go order := &myapi.Order{ Status: myapi.OrderStatus_ORDER_STATUS_CANCELLED, // ERROR после удаления }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::23","title":"ENUM_VALUE_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример switch order.Status { case myapi.OrderStatus_ORDER_STATUS_PENDING: // Pending case myapi.OrderStatus_ORDER_STATUS_CANCELLED: // ERROR: undefined // Cancellation default: // Unknown } // undefined: myapi.O","content":"Реальный пример switch order.Status { case myapi.OrderStatus_ORDER_STATUS_PENDING: // Pending case myapi.OrderStatus_ORDER_STATUS_CANCELLED: // ERROR: undefined // Cancellation default: // Unknown } // undefined: myapi.OrderStatus_ORDER_STATUS_CANCELLED ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::24","title":"ENUM_VALUE_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Проблемы с уже сохранёнными данными:**","content":"Реальный пример **Проблемы с уже сохранёнными данными:**"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::25","title":"ENUM_VALUE_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Валидация на сервере:** ```go func validateOrderStatus(status OrderStatus) error { switch status { case OrderStatus_ORDER_STATUS_PENDING, OrderStatus_ORDER_STATUS_CONFIRMED, OrderStatus_ORDER_STATUS_SHI","content":"Реальный пример **Валидация на сервере:** ```go func validateOrderStatus(status OrderStatus) error { switch status { case OrderStatus_ORDER_STATUS_PENDING, OrderStatus_ORDER_STATUS_CONFIRMED, OrderStatus_ORDER_STATUS_SHIPPED, OrderStatus_ORDER_STATUS_DELIVERED, OrderStatus_ORDER_STATUS_CANCELLED: // ERROR после удаления return nil default: return errors.New(\"invalid order status\") } }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::26","title":"ENUM_VALUE_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример func canModifyOrder(order *Order) bool { return order.Status != OrderStatus_ORDER_STATUS_CANCELLED // ERROR } ```","content":"Реальный пример func canModifyOrder(order *Order) bool { return order.Status != OrderStatus_ORDER_STATUS_CANCELLED // ERROR } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::27","title":"ENUM_VALUE_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Сначала пометить deprecated:** **Перестать использовать deprecated значение в новом коде:** **Обработка legacy в клиенте:** **Резервирование после миграции:** **Никогда не переиспользовать номера** —","content":"Стратегия миграции **Сначала пометить deprecated:** **Перестать использовать deprecated значение в новом коде:** **Обработка legacy в клиенте:** **Резервирование после миграции:** **Никогда не переиспользовать номера** — зарезервированы навсегда."},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::28","title":"ENUM_VALUE_NO_DELETE","section":"Предотвращение переиспользования номера","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Предотвращение переиспользования номера"],"excerpt":"Предотвращение переиспользования номера ```proto enum Status { reserved 2; reserved \"STATUS_DELETED\";","content":"Предотвращение переиспользования номера ```proto enum Status { reserved 2; reserved \"STATUS_DELETED\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::29","title":"ENUM_VALUE_NO_DELETE","section":"Предотвращение переиспользования номера","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Предотвращение переиспользования номера"],"excerpt":"Предотвращение переиспользования номера STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; STATUS_INACTIVE = 3; // STATUS_DELETED = 2; // Не переиспользуем } ```","content":"Предотвращение переиспользования номера STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; STATUS_INACTIVE = 3; // STATUS_DELETED = 2; // Не переиспользуем } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::json::30","title":"ENUM_VALUE_NO_DELETE","section":"JSON совместимость","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#json","headings":["JSON совместимость"],"excerpt":"JSON совместимость ```proto enum Color { reserved 2; reserved \"RED\";","content":"JSON совместимость ```proto enum Color { reserved 2; reserved \"RED\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::json::31","title":"ENUM_VALUE_NO_DELETE","section":"JSON совместимость","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#json","headings":["JSON совместимость"],"excerpt":"JSON совместимость COLOR_UNSPECIFIED = 0; COLOR_BLUE = 1; COLOR_GREEN = 3; // COLOR_RED = 2; // Был удалён } ```","content":"JSON совместимость COLOR_UNSPECIFIED = 0; COLOR_BLUE = 1; COLOR_GREEN = 3; // COLOR_RED = 2; // Был удалён } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::0","title":"ENUM_VALUE_SAME_NAME","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":[],"excerpt":"Это правило проверяет, что имя enum значения для каждого номера (number) не изменилось. Переименование enum значения при сохранении его номера ломает совместимость JSON и сгенерированный код: клиенты ожидают конкретные и","content":"Это правило проверяет, что имя enum значения для каждого номера (number) не изменилось. Переименование enum значения при сохранении его номера ломает совместимость JSON и сгенерированный код: клиенты ожидают конкретные имена констант."},{"id":"cli/breaking-changes/rules/enum-value-same-name::breaking::1","title":"ENUM_VALUE_SAME_NAME","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-same-name::breaking::2","title":"ENUM_VALUE_SAME_NAME","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-value-same-name::breaking::3","title":"ENUM_VALUE_SAME_NAME","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; } ```","content":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::breaking::4","title":"ENUM_VALUE_SAME_NAME","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-same-name::breaking::5","title":"ENUM_VALUE_SAME_NAME","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-value-same-name::breaking::6","title":"ENUM_VALUE_SAME_NAME","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_APPROVED = 2; // [!code --] Было ORDER_STATUS_CONFIRMED ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_COMPLETED = 4; // [","content":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_APPROVED = 2; // [!code --] Было ORDER_STATUS_CONFIRMED ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_COMPLETED = 4; // [!code --] Было ORDER_STATUS_DELIVERED } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::7","title":"ENUM_VALUE_SAME_NAME","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Множественные переименования:** ```proto // Before enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_MODERATOR = 2; USER_ROLE_USER = 3; }","content":"Дополнительные примеры **Множественные переименования:** ```proto // Before enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_MODERATOR = 2; USER_ROLE_USER = 3; }"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::8","title":"ENUM_VALUE_SAME_NAME","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - ВСЁ BREAKING enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMINISTRATOR = 1; // BREAKING: ADMIN -> ADMINISTRATOR USER_ROLE_MOD = 2; // BREAKING: MODERATOR -> MOD USER_ROLE_MEMBER","content":"Дополнительные примеры // After - ВСЁ BREAKING enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMINISTRATOR = 1; // BREAKING: ADMIN -> ADMINISTRATOR USER_ROLE_MOD = 2; // BREAKING: MODERATOR -> MOD USER_ROLE_MEMBER = 3; // BREAKING: USER -> MEMBER } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::9","title":"ENUM_VALUE_SAME_NAME","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо переименования — добавить новые значения и пометить старые deprecated:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо переименования — добавить новые значения и пометить старые deprecated:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::10","title":"ENUM_VALUE_SAME_NAME","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::11","title":"ENUM_VALUE_SAME_NAME","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2 [deprecated = true]; // [!code focus] ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4 [depre","content":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2 [deprecated = true]; // [!code focus] ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4 [deprecated = true]; // [!code focus] ORDER_STATUS_APPROVED = 5; // [!code focus] // Новое значение вместо переименования ORDER_STATUS_COMPLETED = 6; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::12","title":"ENUM_VALUE_SAME_NAME","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или создать новую версию enum:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или создать новую версию enum:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::13","title":"ENUM_VALUE_SAME_NAME","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v2; // [!code focus]","content":"Хороший (Безопасный) package myapi.v2; // [!code focus]"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::14","title":"ENUM_VALUE_SAME_NAME","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_APPROVED = 2; // [!code focus] // «Чистые» имена в v2 ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_COMPLETED = 4; // ","content":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_APPROVED = 2; // [!code focus] // «Чистые» имена в v2 ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_COMPLETED = 4; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::15","title":"ENUM_VALUE_SAME_NAME","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Влияние"],"excerpt":"Влияние **Generated Code:** Меняются имена констант — компиляция клиентов ломается **JSON Compatibility:** JSON использует имена enum — старые документы не парсятся **Client Applications:** Код со старым именем константы","content":"Влияние **Generated Code:** Меняются имена констант — компиляция клиентов ломается **JSON Compatibility:** JSON использует имена enum — старые документы не парсятся **Client Applications:** Код со старым именем константы не компилируется **Documentation:** Документация устаревает с неправильными именами"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::16","title":"ENUM_VALUE_SAME_NAME","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Реальный пример"],"excerpt":"Реальный пример **Ломается код клиента:** ```go // Before status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // handle delivery }","content":"Реальный пример **Ломается код клиента:** ```go // Before status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // handle delivery }"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::17","title":"ENUM_VALUE_SAME_NAME","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Реальный пример"],"excerpt":"Реальный пример // After (переименовано) — ошибки компиляции status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED // ERROR: undefined if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // ERROR: undefined // han","content":"Реальный пример // After (переименовано) — ошибки компиляции status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED // ERROR: undefined if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // ERROR: undefined // handle delivery } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::18","title":"ENUM_VALUE_SAME_NAME","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Реальный пример"],"excerpt":"Реальный пример **JSON совместимость ломается:** ```json // Раньше { \"status\": \"ORDER_STATUS_CONFIRMED\" }","content":"Реальный пример **JSON совместимость ломается:** ```json // Раньше { \"status\": \"ORDER_STATUS_CONFIRMED\" }"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::19","title":"ENUM_VALUE_SAME_NAME","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Реальный пример"],"excerpt":"Реальный пример // После { \"status\": \"ORDER_STATUS_APPROVED\" // Старые JSON больше не парсятся } ```","content":"Реальный пример // После { \"status\": \"ORDER_STATUS_APPROVED\" // Старые JSON больше не парсятся } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::20","title":"ENUM_VALUE_SAME_NAME","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Добавьте новое значение вместо переименования:**","content":"Стратегия миграции **Добавьте новое значение вместо переименования:**"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::21","title":"ENUM_VALUE_SAME_NAME","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Сервер обрабатывает оба значения на переходном этапе** **Мигрируйте клиентов** на новые значения **Удалите (reserve) старое имя и номер** в следующей major‑версии:","content":"Стратегия миграции **Сервер обрабатывает оба значения на переходном этапе** **Мигрируйте клиентов** на новые значения **Удалите (reserve) старое имя и номер** в следующей major‑версии:"},{"id":"cli/breaking-changes/rules/enum-value-same-name::allow-alias::22","title":"ENUM_VALUE_SAME_NAME","section":"Allow Alias (исключение)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#allow-alias","headings":["Allow Alias (исключение)"],"excerpt":"Allow Alias (исключение) С allow_alias = true можно временно иметь два имени для одного номера:","content":"Allow Alias (исключение) С allow_alias = true можно временно иметь два имени для одного номера:"},{"id":"cli/breaking-changes/rules/enum-value-same-name::allow-alias::23","title":"ENUM_VALUE_SAME_NAME","section":"Allow Alias (исключение)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#allow-alias","headings":["Allow Alias (исключение)"],"excerpt":"Allow Alias (исключение) Примечание: Сейчас EasyP всё равно считает это breaking (может измениться в будущем).","content":"Allow Alias (исключение) Примечание: Сейчас EasyP всё равно считает это breaking (может измениться в будущем)."},{"id":"cli/breaking-changes/rules/field-no-delete::top::0","title":"FIELD_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":[],"excerpt":"Это правило проверяет, что ни одно поле сообщения (message field) не было удалено. Удаление поля ломает совместимость по wire‑формату и сгенерированный код: в существующих данных может присутствовать удалённое поле, а кл","content":"Это правило проверяет, что ни одно поле сообщения (message field) не было удалено. Удаление поля ломает совместимость по wire‑формату и сгенерированный код: в существующих данных может присутствовать удалённое поле, а клиентский код может ссылаться на него."},{"id":"cli/breaking-changes/rules/field-no-delete::breaking::1","title":"FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-no-delete::breaking::2","title":"FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-no-delete::breaking::3","title":"FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message User { string name = 1; string email = 2; int32 age = 3; string phone = 4; // [!code --] } ```","content":"Плохой (Breaking) message User { string name = 1; string email = 2; int32 age = 3; string phone = 4; // [!code --] } ```"},{"id":"cli/breaking-changes/rules/field-no-delete::breaking::4","title":"FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-no-delete::breaking::5","title":"FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-no-delete::breaking::6","title":"FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message User { string name = 1; string email = 2; int32 age = 3; // phone поле удалено — BREAKING CHANGE! } ```","content":"Плохой (Breaking) message User { string name = 1; string email = 2; int32 age = 3; // phone поле удалено — BREAKING CHANGE! } ```"},{"id":"cli/breaking-changes/rules/field-no-delete::top::7","title":"FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления — пометить поле deprecated:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления — пометить поле deprecated:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-no-delete::top::8","title":"FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-no-delete::top::9","title":"FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message User { string name = 1; string email = 2; int32 age = 3; string phone = 4 [deprecated = true]; // [!code focus] } ```","content":"Хороший (Безопасный) message User { string name = 1; string email = 2; int32 age = 3; string phone = 4 [deprecated = true]; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/field-no-delete::top::10","title":"FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или зарезервировать номер и имя поля после удаления:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или зарезервировать номер и имя поля после удаления:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-no-delete::top::11","title":"FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-no-delete::top::12","title":"FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message User { reserved 4; // [!code focus] reserved \"phone\"; // [!code focus] string name = 1; string email = 2; int32 age = 3; } ```","content":"Хороший (Безопасный) message User { reserved 4; // [!code focus] reserved \"phone\"; // [!code focus] string name = 1; string email = 2; int32 age = 3; } ```"},{"id":"cli/breaking-changes/rules/field-no-delete::top::13","title":"FIELD_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Старые сообщения с удалённым полем некорректно десериализуются **Generated Code:** Удаляются аксессоры (get/set), компиляция клиента ломается **Data Loss:** Потеря сохранённых данных, связанных с","content":"Влияние **Wire Format:** Старые сообщения с удалённым полем некорректно десериализуются **Generated Code:** Удаляются аксессоры (get/set), компиляция клиента ломается **Data Loss:** Потеря сохранённых данных, связанных с полем **JSON Compatibility:** JSON парсеры ожидают наличие поля и могут выдавать ошибки"},{"id":"cli/breaking-changes/rules/field-no-delete::top::14","title":"FIELD_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Сначала пометить deprecated:**","content":"Стратегия миграции **Сначала пометить deprecated:**"},{"id":"cli/breaking-changes/rules/field-no-delete::top::15","title":"FIELD_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Прекратить запись в поле** в прикладном коде","content":"Стратегия миграции **Прекратить запись в поле** в прикладном коде"},{"id":"cli/breaking-changes/rules/field-no-delete::top::16","title":"FIELD_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Зарезервировать поле** в следующей версии, чтобы избежать повторного использования:","content":"Стратегия миграции **Зарезервировать поле** в следующей версии, чтобы избежать повторного использования:"},{"id":"cli/breaking-changes/rules/field-no-delete::top::17","title":"FIELD_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Никогда не переиспользовать номер поля** — должен оставаться в reserved навсегда","content":"Стратегия миграции **Никогда не переиспользовать номер поля** — должен оставаться в reserved навсегда"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::0","title":"FIELD_SAME_CARDINALITY","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":[],"excerpt":"Правило проверяет, что поля сообщений сохраняют ту же кардинальность (обязательность / optional). Изменение кардинальности поля ломает совместимость по wire‑формату и сгенерированный код: семантика присутствия и ожидания","content":"Правило проверяет, что поля сообщений сохраняют ту же кардинальность (обязательность / optional). Изменение кардинальности поля ломает совместимость по wire‑формату и сгенерированный код: семантика присутствия и ожидания клиентского кода отличаются для optional и required (implicit) полей."},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::1","title":"FIELD_SAME_CARDINALITY","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::2","title":"FIELD_SAME_CARDINALITY","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::3","title":"FIELD_SAME_CARDINALITY","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message User { string name = 1; string email = 2; int32 age = 3; }","content":"Плохой (Breaking) message User { string name = 1; string email = 2; int32 age = 3; }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::4","title":"FIELD_SAME_CARDINALITY","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message CreateUserRequest { string name = 1; optional string email = 2; string phone = 3; } ```","content":"Плохой (Breaking) message CreateUserRequest { string name = 1; optional string email = 2; string phone = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::5","title":"FIELD_SAME_CARDINALITY","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::6","title":"FIELD_SAME_CARDINALITY","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::7","title":"FIELD_SAME_CARDINALITY","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message User { string name = 1; optional string email = 2; // [!code --] Было required (implicit), стало optional int32 age = 3; }","content":"Плохой (Breaking) message User { string name = 1; optional string email = 2; // [!code --] Было required (implicit), стало optional int32 age = 3; }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::8","title":"FIELD_SAME_CARDINALITY","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message CreateUserRequest { string name = 1; string email = 2; // [!code --] Было optional, стало требуемым (implicit required) string phone = 3; } ```","content":"Плохой (Breaking) message CreateUserRequest { string name = 1; string email = 2; // [!code --] Было optional, стало требуемым (implicit required) string phone = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::9","title":"FIELD_SAME_CARDINALITY","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Проблемы миграции Proto2 → Proto3:**","content":"Дополнительные примеры **Проблемы миграции Proto2 → Proto3:**"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::10","title":"FIELD_SAME_CARDINALITY","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры ```proto // Before (proto2) syntax = \"proto2\";","content":"Дополнительные примеры ```proto // Before (proto2) syntax = \"proto2\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::11","title":"FIELD_SAME_CARDINALITY","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры message Order { required string id = 1; optional string notes = 2; repeated string tags = 3; }","content":"Дополнительные примеры message Order { required string id = 1; optional string notes = 2; repeated string tags = 3; }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::12","title":"FIELD_SAME_CARDINALITY","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After (proto3) - BREAKING CHANGES! syntax = \"proto3\";","content":"Дополнительные примеры // After (proto3) - BREAKING CHANGES! syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::13","title":"FIELD_SAME_CARDINALITY","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры message Order { string id = 1; // BREAKING: required -> implicit optional string notes = 2; // BREAKING: explicit optional -> implicit optional repeated string tags = 3; // OK } ```","content":"Дополнительные примеры message Order { string id = 1; // BREAKING: required -> implicit optional string notes = 2; // BREAKING: explicit optional -> implicit optional repeated string tags = 3; // OK } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::14","title":"FIELD_SAME_CARDINALITY","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо изменения кардинальности — добавьте новое поле:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо изменения кардинальности — добавьте новое поле:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::15","title":"FIELD_SAME_CARDINALITY","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::16","title":"FIELD_SAME_CARDINALITY","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message User { string name = 1; string email = 2 [deprecated = true]; // [!code focus] Сохраняем старую кардинальность int32 age = 3; optional string email_optional = 4; // [!code focus] Новое option","content":"Хороший (Безопасный) message User { string name = 1; string email = 2 [deprecated = true]; // [!code focus] Сохраняем старую кардинальность int32 age = 3; optional string email_optional = 4; // [!code focus] Новое optional поле }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::17","title":"FIELD_SAME_CARDINALITY","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message CreateUserRequest { string name = 1; optional string email = 2 [deprecated = true]; // [!code focus] string phone = 3; string email_required = 4; // [!code focus] Новое требуемое поле } ```","content":"Хороший (Безопасный) message CreateUserRequest { string name = 1; optional string email = 2 [deprecated = true]; // [!code focus] string phone = 3; string email_required = 4; // [!code focus] Новое требуемое поле } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::18","title":"FIELD_SAME_CARDINALITY","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или создайте новую версию сообщения:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или создайте новую версию сообщения:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::19","title":"FIELD_SAME_CARDINALITY","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v2; // [!code focus]","content":"Хороший (Безопасный) package myapi.v2; // [!code focus]"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::20","title":"FIELD_SAME_CARDINALITY","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message User { string name = 1; optional string email = 2; // [!code focus] Чистая модель в v2 int32 age = 3; }","content":"Хороший (Безопасный) message User { string name = 1; optional string email = 2; // [!code focus] Чистая модель в v2 int32 age = 3; }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::21","title":"FIELD_SAME_CARDINALITY","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message CreateUserRequest { string name = 1; string email = 2; // [!code focus] Требуемое в v2 string phone = 3; } ```","content":"Хороший (Безопасный) message CreateUserRequest { string name = 1; string email = 2; // [!code focus] Требуемое в v2 string phone = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::22","title":"FIELD_SAME_CARDINALITY","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Меняется семантика присутствия — клиенты неправильно ожидают поля **Generated Code:** Меняются методы доступа / проверки (has, clear) **Validation:** Правила проверки обязательности переписываютс","content":"Влияние **Wire Format:** Меняется семантика присутствия — клиенты неправильно ожидают поля **Generated Code:** Меняются методы доступа / проверки (has, clear) **Validation:** Правила проверки обязательности переписываются **Default Values:** Optional и required по‑разному обрабатывают отсутствие значения"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::23","title":"FIELD_SAME_CARDINALITY","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается при смене кардинальности:** ```go // Before - поле фактически требуется (implicit) user := &myapi.User{ Name: \"John\", Email: \"john@example.com\", Age: 30, }","content":"Реальный пример **Код клиента ломается при смене кардинальности:** ```go // Before - поле фактически требуется (implicit) user := &myapi.User{ Name: \"John\", Email: \"john@example.com\", Age: 30, }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::24","title":"FIELD_SAME_CARDINALITY","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Реальный пример"],"excerpt":"Реальный пример if user.Email != \"\" { // Есть значение }","content":"Реальный пример if user.Email != \"\" { // Есть значение }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::25","title":"FIELD_SAME_CARDINALITY","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Реальный пример"],"excerpt":"Реальный пример // After - поле стало optional (pointer) user := &myapi.User{ Name: \"John\", Age: 30, // Email может отсутствовать }","content":"Реальный пример // After - поле стало optional (pointer) user := &myapi.User{ Name: \"John\", Age: 30, // Email может отсутствовать }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::26","title":"FIELD_SAME_CARDINALITY","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Реальный пример"],"excerpt":"Реальный пример if user.Email != nil && *user.Email != \"\" { // Есть значение (новый способ) }","content":"Реальный пример if user.Email != nil && *user.Email != \"\" { // Есть значение (новый способ) }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::27","title":"FIELD_SAME_CARDINALITY","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Реальный пример"],"excerpt":"Реальный пример user.Email = &emailValue // Присваивание указателя вместо строки ```","content":"Реальный пример user.Email = &emailValue // Присваивание указателя вместо строки ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::28","title":"FIELD_SAME_CARDINALITY","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Реальный пример"],"excerpt":"Реальный пример **Валидация на сервере:** ```go // Before func validateUser(user *User) error { if user.Email == \"\" { return errors.New(\"email is required\") } return nil }","content":"Реальный пример **Валидация на сервере:** ```go // Before func validateUser(user *User) error { if user.Email == \"\" { return errors.New(\"email is required\") } return nil }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::29","title":"FIELD_SAME_CARDINALITY","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Реальный пример"],"excerpt":"Реальный пример // After func validateUser(user *User) error { if user.Email == nil { return errors.New(\"email is required\") } if *user.Email == \"\" { return errors.New(\"email cannot be empty\") } return nil } ```","content":"Реальный пример // After func validateUser(user *User) error { if user.Email == nil { return errors.New(\"email is required\") } if *user.Email == \"\" { return errors.New(\"email cannot be empty\") } return nil } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::30","title":"FIELD_SAME_CARDINALITY","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Добавьте новое поле** с нужной кардинальностью:","content":"Стратегия миграции **Добавьте новое поле** с нужной кардинальностью:"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::31","title":"FIELD_SAME_CARDINALITY","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Период двойной записи** — заполняйте оба поля:","content":"Стратегия миграции **Период двойной записи** — заполняйте оба поля:"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::32","title":"FIELD_SAME_CARDINALITY","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Клиенты постепенно переходят**:","content":"Стратегия миграции **Клиенты постепенно переходят**:"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::33","title":"FIELD_SAME_CARDINALITY","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Удаление старого поля** в следующей major‑версии:","content":"Стратегия миграции **Удаление старого поля** в следующей major‑версии:"},{"id":"cli/breaking-changes/rules/field-same-cardinality::proto2-proto3::34","title":"FIELD_SAME_CARDINALITY","section":"Миграция Proto2 → Proto3","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#proto2-proto3","headings":["Миграция Proto2 → Proto3"],"excerpt":"Миграция Proto2 → Proto3 ```proto syntax = \"proto3\"; message Order { string id = 1; // BREAKING если был required }","content":"Миграция Proto2 → Proto3 ```proto syntax = \"proto3\"; message Order { string id = 1; // BREAKING если был required }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::proto2-proto3::35","title":"FIELD_SAME_CARDINALITY","section":"Миграция Proto2 → Proto3","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#proto2-proto3","headings":["Миграция Proto2 → Proto3"],"excerpt":"Миграция Proto2 → Proto3 // Сохранить семантику: syntax = \"proto3\"; message Order { string id = 1; optional string notes = 2; } ```","content":"Миграция Proto2 → Proto3 // Сохранить семантику: syntax = \"proto3\"; message Order { string id = 1; optional string notes = 2; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::optional-required::36","title":"FIELD_SAME_CARDINALITY","section":"Делать optional поле required","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#optional-required","headings":["Делать optional поле required"],"excerpt":"Делать optional поле required ```proto message CreateUserRequest { string name = 1; string email = 2; // BREAKING (раньше optional) }","content":"Делать optional поле required ```proto message CreateUserRequest { string name = 1; string email = 2; // BREAKING (раньше optional) }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::optional-required::37","title":"FIELD_SAME_CARDINALITY","section":"Делать optional поле required","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#optional-required","headings":["Делать optional поле required"],"excerpt":"Делать optional поле required message CreateUserRequest { string name = 1; optional string email = 2 [deprecated = true]; string required_email = 3; } ```","content":"Делать optional поле required message CreateUserRequest { string name = 1; optional string email = 2 [deprecated = true]; string required_email = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::required-optional::38","title":"FIELD_SAME_CARDINALITY","section":"Делать required поле optional","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#required-optional","headings":["Делать required поле optional"],"excerpt":"Делать required поле optional ```proto message User { optional string phone = 3; // BREAKING (было implicit required) }","content":"Делать required поле optional ```proto message User { optional string phone = 3; // BREAKING (было implicit required) }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::required-optional::39","title":"FIELD_SAME_CARDINALITY","section":"Делать required поле optional","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#required-optional","headings":["Делать required поле optional"],"excerpt":"Делать required поле optional message User { string phone = 3 [deprecated = true]; optional string phone_optional = 4; } ```","content":"Делать required поле optional message User { string phone = 3 [deprecated = true]; optional string phone_optional = 4; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::protobuf::40","title":"FIELD_SAME_CARDINALITY","section":"Типы кардинальности в Protobuf","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#protobuf","headings":["Типы кардинальности в Protobuf"],"excerpt":"Типы кардинальности в Protobuf","content":"Типы кардинальности в Protobuf"},{"id":"cli/breaking-changes/rules/field-same-cardinality::proto3::41","title":"FIELD_SAME_CARDINALITY","section":"Proto3","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#proto3","headings":["Proto3"],"excerpt":"Proto3 **Implicit optional**: string name = 1; **Explicit optional**: optional string email = 2; **Repeated**: repeated string tags = 3; **Map**: map metadata = 4;","content":"Proto3 **Implicit optional**: string name = 1; **Explicit optional**: optional string email = 2; **Repeated**: repeated string tags = 3; **Map**: map metadata = 4;"},{"id":"cli/breaking-changes/rules/field-same-cardinality::proto2::42","title":"FIELD_SAME_CARDINALITY","section":"Proto2","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#proto2","headings":["Proto2"],"excerpt":"Proto2 **Required**: required string id = 1; **Optional**: optional string email = 2; **Repeated**: repeated string tags = 3;","content":"Proto2 **Required**: required string id = 1; **Optional**: optional string email = 2; **Repeated**: repeated string tags = 3;"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::43","title":"FIELD_SAME_CARDINALITY","section":"Матрица Breaking изменений","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Матрица Breaking изменений"],"excerpt":"Матрица Breaking изменений From To Result ------ ---- -------- Required Optional ❌ BREAKING Optional Required ❌ BREAKING Implicit Explicit ❌ BREAKING Explicit Implicit ❌ BREAKING Single Repeated ❌ BREAKING Repeated Singl","content":"Матрица Breaking изменений From To Result ------ ---- -------- Required Optional ❌ BREAKING Optional Required ❌ BREAKING Implicit Explicit ❌ BREAKING Explicit Implicit ❌ BREAKING Single Repeated ❌ BREAKING Repeated Single ❌ BREAKING Field Map ❌ BREAKING Map Field ❌ BREAKING"},{"id":"cli/breaking-changes/rules/field-same-type::top::0","title":"FIELD_SAME_TYPE","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":[],"excerpt":"Правило проверяет, что типы полей сообщений (message fields) не изменяются. Смена типа поля ломает совместимость по wire‑формату и сгенерированный код: бинарное представление и ожидания клиентского кода различаются для р","content":"Правило проверяет, что типы полей сообщений (message fields) не изменяются. Смена типа поля ломает совместимость по wire‑формату и сгенерированный код: бинарное представление и ожидания клиентского кода различаются для разных типов."},{"id":"cli/breaking-changes/rules/field-same-type::breaking::1","title":"FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-type::breaking::2","title":"FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-same-type::breaking::3","title":"FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Product { string name = 1; int32 price = 2; bool available = 3; } ```","content":"Плохой (Breaking) message Product { string name = 1; int32 price = 2; bool available = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-type::breaking::4","title":"FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-type::breaking::5","title":"FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-same-type::breaking::6","title":"FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Product { string name = 1; string price = 2; // [!code --] Changed from int32 to string (изменён тип) bool available = 3; } ```","content":"Плохой (Breaking) message Product { string name = 1; string price = 2; // [!code --] Changed from int32 to string (изменён тип) bool available = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-type::top::7","title":"FIELD_SAME_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Несовместимые изменения типов:** ```proto // Before message Order { string id = 1; int64 timestamp = 2; repeated string tags = 3; OrderStatus status = 4; }","content":"Дополнительные примеры **Несовместимые изменения типов:** ```proto // Before message Order { string id = 1; int64 timestamp = 2; repeated string tags = 3; OrderStatus status = 4; }"},{"id":"cli/breaking-changes/rules/field-same-type::top::8","title":"FIELD_SAME_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - ВСЁ BREAKING message Order { int32 id = 1; // string -> int32: BREAKING string timestamp = 2; // int64 -> string: BREAKING string tags = 3; // repeated -> singular: BREAKING int32 status","content":"Дополнительные примеры // After - ВСЁ BREAKING message Order { int32 id = 1; // string -> int32: BREAKING string timestamp = 2; // int64 -> string: BREAKING string tags = 3; // repeated -> singular: BREAKING int32 status = 4; // enum -> int32: BREAKING } ```"},{"id":"cli/breaking-changes/rules/field-same-type::top::9","title":"FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо смены типа — добавьте новое поле:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо смены типа — добавьте новое поле:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-type::top::10","title":"FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-same-type::top::11","title":"FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Product { string name = 1; int32 price = 2 [deprecated = true]; // [!code focus] // Старое поле помечено deprecated bool available = 3; string price_formatted = 4; // [!code focus] // Новое п","content":"Хороший (Безопасный) message Product { string name = 1; int32 price = 2 [deprecated = true]; // [!code focus] // Старое поле помечено deprecated bool available = 3; string price_formatted = 4; // [!code focus] // Новое поле со строковым представлением } ```"},{"id":"cli/breaking-changes/rules/field-same-type::top::12","title":"FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или создайте новую версию сообщения:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или создайте новую версию сообщения:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-type::top::13","title":"FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v2; // [!code focus] // Новая версия package","content":"Хороший (Безопасный) package myapi.v2; // [!code focus] // Новая версия package"},{"id":"cli/breaking-changes/rules/field-same-type::top::14","title":"FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Product { string name = 1; string price = 2; // [!code focus] // В v2 уже string bool available = 3; } ```","content":"Хороший (Безопасный) message Product { string name = 1; string price = 2; // [!code focus] // В v2 уже string bool available = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-type::top::15","title":"FIELD_SAME_TYPE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Старые бинарные данные не десериализуются корректно **Generated Code:** Меняются типы в сгенерированном коде — клиенты не компилируются **Runtime Errors:** Ошибки парсинга при несовпадении ожидае","content":"Влияние **Wire Format:** Старые бинарные данные не десериализуются корректно **Generated Code:** Меняются типы в сгенерированном коде — клиенты не компилируются **Runtime Errors:** Ошибки парсинга при несовпадении ожидаемого типа **Data Corruption:** Неверная интерпретация байтов данных"},{"id":"cli/breaking-changes/rules/field-same-type::top::16","title":"FIELD_SAME_TYPE","section":"Типовые проблемы изменений типов","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Типовые проблемы изменений типов"],"excerpt":"Типовые проблемы изменений типов","content":"Типовые проблемы изменений типов"},{"id":"cli/breaking-changes/rules/field-same-type::top::17","title":"FIELD_SAME_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Добавьте новое поле** с нужным типом:","content":"Стратегия миграции **Добавьте новое поле** с нужным типом:"},{"id":"cli/breaking-changes/rules/field-same-type::top::18","title":"FIELD_SAME_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Период двойной записи** — заполняйте оба поля для совместимости","content":"Стратегия миграции **Период двойной записи** — заполняйте оба поля для совместимости"},{"id":"cli/breaking-changes/rules/field-same-type::top::19","title":"FIELD_SAME_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Мигрируйте клиентов** на новое поле постепенно","content":"Стратегия миграции **Мигрируйте клиентов** на новое поле постепенно"},{"id":"cli/breaking-changes/rules/field-same-type::top::20","title":"FIELD_SAME_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Удалите старое поле** в следующей major‑версии:","content":"Стратегия миграции **Удалите старое поле** в следующей major‑версии:"},{"id":"cli/breaking-changes/rules/field-same-type::wire::21","title":"FIELD_SAME_TYPE","section":"Безопасные изменения (Теоретически wire‑совместимые)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#wire","headings":["Безопасные изменения (Теоретически wire‑совместимые)"],"excerpt":"Безопасные изменения (Теоретически wire‑совместимые) Примечание: EasyP сейчас считает ЛЮБУЮ смену типа breaking. Однако технически некоторые случаи совместимы:","content":"Безопасные изменения (Теоретически wire‑совместимые) Примечание: EasyP сейчас считает ЛЮБУЮ смену типа breaking. Однако технически некоторые случаи совместимы:"},{"id":"cli/breaking-changes/rules/field-same-type::wire::22","title":"FIELD_SAME_TYPE","section":"Безопасные изменения (Теоретически wire‑совместимые)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#wire","headings":["Безопасные изменения (Теоретически wire‑совместимые)"],"excerpt":"Безопасные изменения (Теоретически wire‑совместимые) int32 ↔ uint32 (одно кодирование) int64 ↔ uint64 (одно кодирование) string → bytes (если все строки валидный UTF‑8)","content":"Безопасные изменения (Теоретически wire‑совместимые) int32 ↔ uint32 (одно кодирование) int64 ↔ uint64 (одно кодирование) string → bytes (если все строки валидный UTF‑8)"},{"id":"cli/breaking-changes/rules/field-same-type::wire::23","title":"FIELD_SAME_TYPE","section":"Безопасные изменения (Теоретически wire‑совместимые)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#wire","headings":["Безопасные изменения (Теоретически wire‑совместимые)"],"excerpt":"Безопасные изменения (Теоретически wire‑совместимые) Эти исключения могут получить отдельную обработку в будущих версиях EasyP с более гибкими уровнями строгости.","content":"Безопасные изменения (Теоретически wire‑совместимые) Эти исключения могут получить отдельную обработку в будущих версиях EasyP с более гибкими уровнями строгости."},{"id":"cli/breaking-changes/rules/import-no-delete::top::0","title":"IMPORT_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":[],"excerpt":"Это правило проверяет, что ни одна инструкция import не была удалена из proto‑файла. Удаление import ломает совместимость по wire‑формату и сгенерированный код: типы из импортируемых файлов могли использоваться в текущем","content":"Это правило проверяет, что ни одна инструкция import не была удалена из proto‑файла. Удаление import ломает совместимость по wire‑формату и сгенерированный код: типы из импортируемых файлов могли использоваться в текущем файле, и их удаление делает эти типы недоступными."},{"id":"cli/breaking-changes/rules/import-no-delete::breaking::1","title":"IMPORT_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/import-no-delete::breaking::2","title":"IMPORT_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/import-no-delete::breaking::3","title":"IMPORT_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; import \"common/user.proto\"; import \"common/address.proto\";","content":"Плохой (Breaking) import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; import \"common/user.proto\"; import \"common/address.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::breaking::4","title":"IMPORT_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3; common.User customer = 4; common.Address shipping_address = 5; } ```","content":"Плохой (Breaking) message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3; common.User customer = 4; common.Address shipping_address = 5; } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::breaking::5","title":"IMPORT_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/import-no-delete::breaking::6","title":"IMPORT_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/import-no-delete::breaking::7","title":"IMPORT_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) import \"google/protobuf/timestamp.proto\"; // import \"google/protobuf/duration.proto\"; // [!code --] Удалён import — BREAKING // import \"common/user.proto\"; // [!code --] Удалён import — BREAKING // impo","content":"Плохой (Breaking) import \"google/protobuf/timestamp.proto\"; // import \"google/protobuf/duration.proto\"; // [!code --] Удалён import — BREAKING // import \"common/user.proto\"; // [!code --] Удалён import — BREAKING // import \"common/address.proto\"; // [!code --] Удалён import — BREAKING"},{"id":"cli/breaking-changes/rules/import-no-delete::breaking::8","title":"IMPORT_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3; // ERROR: Duration недоступен common.User customer = 4; // ERROR: User недоступен c","content":"Плохой (Breaking) message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3; // ERROR: Duration недоступен common.User customer = 4; // ERROR: User недоступен common.Address shipping_address = 5; // ERROR: Address недоступен } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::top::9","title":"IMPORT_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Сервис ломается при удалённых import:** ```proto // Before import \"google/api/annotations.proto\"; import \"google/protobuf/empty.proto\"; import \"common/auth.proto\";","content":"Дополнительные примеры **Сервис ломается при удалённых import:** ```proto // Before import \"google/api/annotations.proto\"; import \"google/protobuf/empty.proto\"; import \"common/auth.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::top::10","title":"IMPORT_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры service OrderService { rpc GetOrder(GetOrderRequest) returns (Order) { option (google.api.http) = { get: \"/v1/orders/{id}\" }; } rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty); ","content":"Дополнительные примеры service OrderService { rpc GetOrder(GetOrderRequest) returns (Order) { option (google.api.http) = { get: \"/v1/orders/{id}\" }; } rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty); }"},{"id":"cli/breaking-changes/rules/import-no-delete::top::11","title":"IMPORT_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - BREAKING CHANGES! // import \"google/api/annotations.proto\"; // BREAKING: deleted // import \"google/protobuf/empty.proto\"; // BREAKING: deleted // import \"common/auth.proto\"; // BREAKING:","content":"Дополнительные примеры // After - BREAKING CHANGES! // import \"google/api/annotations.proto\"; // BREAKING: deleted // import \"google/protobuf/empty.proto\"; // BREAKING: deleted // import \"common/auth.proto\"; // BREAKING: deleted"},{"id":"cli/breaking-changes/rules/import-no-delete::top::12","title":"IMPORT_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры service OrderService { rpc GetOrder(GetOrderRequest) returns (Order) { option (google.api.http) = { // ERROR: annotations недоступен get: \"/v1/orders/{id}\" }; } rpc DeleteOrder(common.AuthRequest) ","content":"Дополнительные примеры service OrderService { rpc GetOrder(GetOrderRequest) returns (Order) { option (google.api.http) = { // ERROR: annotations недоступен get: \"/v1/orders/{id}\" }; } rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty); // ERROR: типы недоступны } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::top::13","title":"IMPORT_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления оставьте неиспользуемые import:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления оставьте неиспользуемые import:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/import-no-delete::top::14","title":"IMPORT_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/import-no-delete::top::15","title":"IMPORT_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; // [!code focus] // Оставляем даже если не используется import \"common/user.proto\"; // [!code focus] import \"common/","content":"Хороший (Безопасный) import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; // [!code focus] // Оставляем даже если не используется import \"common/user.proto\"; // [!code focus] import \"common/address.proto\"; // [!code focus]"},{"id":"cli/breaking-changes/rules/import-no-delete::top::16","title":"IMPORT_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Order { string id = 1; google.protobuf.Timestamp created_at = 2; // Поля, использовавшие Duration/User/Address, удалены — import оставлены } ```","content":"Хороший (Безопасный) message Order { string id = 1; google.protobuf.Timestamp created_at = 2; // Поля, использовавшие Duration/User/Address, удалены — import оставлены } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::top::17","title":"IMPORT_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или добавьте новые типы, сохранив старые import:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или добавьте новые типы, сохранив старые import:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/import-no-delete::top::18","title":"IMPORT_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/import-no-delete::top::19","title":"IMPORT_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; // [!code focus] import \"common/user.proto\"; // [!code focus] import \"common/address.proto\"; // [!code focus] import","content":"Хороший (Безопасный) import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; // [!code focus] import \"common/user.proto\"; // [!code focus] import \"common/address.proto\"; // [!code focus] import \"common/v2/user.proto\"; // [!code focus] // Новый import"},{"id":"cli/breaking-changes/rules/import-no-delete::top::20","title":"IMPORT_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3 [deprecated = true]; // [!code focus] common.User customer = 4 [deprecated = true","content":"Хороший (Безопасный) message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3 [deprecated = true]; // [!code focus] common.User customer = 4 [deprecated = true]; // [!code focus] common.Address shipping_address = 5 [deprecated = true]; // [!code focus] int32 processing_seconds = 6; common.v2.UserProfile customer_v2 = 7; string shipping_address_text = 8; } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::top::21","title":"IMPORT_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Влияние"],"excerpt":"Влияние **Generated Code:** Типы пропадают → ошибка компиляции **Wire Format:** Сообщения с удалёнными типами не десериализуются **Field References:** Поля с этими типами становятся невалидны **Service Definitions:** RPC","content":"Влияние **Generated Code:** Типы пропадают → ошибка компиляции **Wire Format:** Сообщения с удалёнными типами не десериализуются **Field References:** Поля с этими типами становятся невалидны **Service Definitions:** RPC с типами из удалённых файлов ломаются **Options Usage:** Пользовательские опции из импортов недоступны"},{"id":"cli/breaking-changes/rules/import-no-delete::top::22","title":"IMPORT_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается:**","content":"Реальный пример **Код клиента ломается:**"},{"id":"cli/breaking-changes/rules/import-no-delete::top::23","title":"IMPORT_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Серверная логика ломается:**","content":"Реальный пример **Серверная логика ломается:**"},{"id":"cli/breaking-changes/rules/import-no-delete::top::24","title":"IMPORT_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Компиляция proto ломается:**","content":"Реальный пример **Компиляция proto ломается:**"},{"id":"cli/breaking-changes/rules/import-no-delete::top::25","title":"IMPORT_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции Сохраняйте import даже если типы более не используются: Добавляйте новые import рядом со старыми: Депрецируйте поля со старыми типами постепенно: Сервер: поддерживайте оба варианта: Удаляйте import тол","content":"Стратегия миграции Сохраняйте import даже если типы более не используются: Добавляйте новые import рядом со старыми: Депрецируйте поля со старыми типами постепенно: Сервер: поддерживайте оба варианта: Удаляйте import только в следующей major‑версии после полной миграции."},{"id":"cli/breaking-changes/rules/import-no-delete::top::26","title":"IMPORT_NO_DELETE","section":"Замена зависимости","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Замена зависимости"],"excerpt":"Замена зависимости ```proto import \"old/user.proto\"; // Старый import \"new/user.proto\"; // Новый","content":"Замена зависимости ```proto import \"old/user.proto\"; // Старый import \"new/user.proto\"; // Новый"},{"id":"cli/breaking-changes/rules/import-no-delete::top::27","title":"IMPORT_NO_DELETE","section":"Замена зависимости","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Замена зависимости"],"excerpt":"Замена зависимости message Order { old.User customer = 4 [deprecated = true]; new.UserProfile customer_v2 = 5; } ```","content":"Замена зависимости message Order { old.User customer = 4 [deprecated = true]; new.UserProfile customer_v2 = 5; } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::top::28","title":"IMPORT_NO_DELETE","section":"Удаление функционала","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Удаление функционала"],"excerpt":"Удаление функционала ```proto import \"feature/analytics.proto\"; // Оставить даже если поле удалено","content":"Удаление функционала ```proto import \"feature/analytics.proto\"; // Оставить даже если поле удалено"},{"id":"cli/breaking-changes/rules/import-no-delete::top::29","title":"IMPORT_NO_DELETE","section":"Удаление функционала","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Удаление функционала"],"excerpt":"Удаление функционала message Order { string id = 1; // feature.AnalyticsData analytics = 2; // Поле удалено, import остаётся } ```","content":"Удаление функционала message Order { string id = 1; // feature.AnalyticsData analytics = 2; // Поле удалено, import остаётся } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::protobuf::30","title":"IMPORT_NO_DELETE","section":"Миграция версии protobuf","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#protobuf","headings":["Миграция версии protobuf"],"excerpt":"Миграция версии protobuf ```proto import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\";","content":"Миграция версии protobuf ```proto import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::protobuf::31","title":"IMPORT_NO_DELETE","section":"Миграция версии protobuf","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#protobuf","headings":["Миграция версии protobuf"],"excerpt":"Миграция версии protobuf message Event { google.protobuf.Timestamp timestamp = 1; int64 timestamp_millis = 2; } ```","content":"Миграция версии protobuf message Event { google.protobuf.Timestamp timestamp = 1; int64 timestamp_millis = 2; } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::top::32","title":"IMPORT_NO_DELETE","section":"Упрощение сложных зависимостей","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Упрощение сложных зависимостей"],"excerpt":"Упрощение сложных зависимостей ```proto import \"complex/config.proto\";","content":"Упрощение сложных зависимостей ```proto import \"complex/config.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::top::33","title":"IMPORT_NO_DELETE","section":"Упрощение сложных зависимостей","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Упрощение сложных зависимостей"],"excerpt":"Упрощение сложных зависимостей message Settings { complex.ConfigData config = 1 [deprecated = true]; string config_json = 2; } ```","content":"Упрощение сложных зависимостей message Settings { complex.ConfigData config = 1 [deprecated = true]; string config_json = 2; } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::import-vs::34","title":"IMPORT_NO_DELETE","section":"Удаление import vs использование поля","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#import-vs","headings":["Удаление import vs использование поля"],"excerpt":"Удаление import vs использование поля","content":"Удаление import vs использование поля"},{"id":"cli/breaking-changes/rules/import-no-delete::import::35","title":"IMPORT_NO_DELETE","section":"Аудит import","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#import","headings":["Аудит import"],"excerpt":"Аудит import (Даже если не найдено — не удаляем.)","content":"Аудит import (Даже если не найдено — не удаляем.)"},{"id":"cli/breaking-changes/rules/message-no-delete::top::0","title":"MESSAGE_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":[],"excerpt":"Это правило проверяет, что ни одно сообщение (message) не было удалено из proto‑файлов. Удаление message ломает совместимость по wire‑формату и сгенерированный код: в существующих данных могут присутствовать экземпляры у","content":"Это правило проверяет, что ни одно сообщение (message) не было удалено из proto‑файлов. Удаление message ломает совместимость по wire‑формату и сгенерированный код: в существующих данных могут присутствовать экземпляры удалённого типа, а клиентский код зависит от сгенерированных структур и классов."},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::1","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::2","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::3","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message User { string name = 1; string email = 2; Address address = 3; }","content":"Плохой (Breaking) message User { string name = 1; string email = 2; Address address = 3; }"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::4","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Address { // [!code --] string street = 1; // [!code --] string city = 2; // [!code --] string country = 3; // [!code --] } // [!code --]","content":"Плохой (Breaking) message Address { // [!code --] string street = 1; // [!code --] string city = 2; // [!code --] string country = 3; // [!code --] } // [!code --]"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::5","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Order { string id = 1; User user = 2; } ```","content":"Плохой (Breaking) message Order { string id = 1; User user = 2; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::6","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::7","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::8","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message User { string name = 1; string email = 2; Address address = 3; // ERROR: Address больше не существует }","content":"Плохой (Breaking) message User { string name = 1; string email = 2; Address address = 3; // ERROR: Address больше не существует }"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::9","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) // Address удалён — BREAKING CHANGE!","content":"Плохой (Breaking) // Address удалён — BREAKING CHANGE!"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::10","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Order { string id = 1; User user = 2; } ```","content":"Плохой (Breaking) message Order { string id = 1; User user = 2; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::top::11","title":"MESSAGE_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Удаление вложенного сообщения:**","content":"Дополнительные примеры **Удаление вложенного сообщения:**"},{"id":"cli/breaking-changes/rules/message-no-delete::top::12","title":"MESSAGE_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры ```proto // Before message User { string name = 1; Profile profile = 2; message Profile { // [!code --] string bio = 1; // [!code --] string avatar_url = 2; // [!code --] } // [!code --] }","content":"Дополнительные примеры ```proto // Before message User { string name = 1; Profile profile = 2; message Profile { // [!code --] string bio = 1; // [!code --] string avatar_url = 2; // [!code --] } // [!code --] }"},{"id":"cli/breaking-changes/rules/message-no-delete::top::13","title":"MESSAGE_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - BREAKING CHANGE! message User { string name = 1; Profile profile = 2; // ERROR: Profile удалён // Вложенное сообщение Profile удалено } ```","content":"Дополнительные примеры // After - BREAKING CHANGE! message User { string name = 1; Profile profile = 2; // ERROR: Profile удалён // Вложенное сообщение Profile удалено } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::top::14","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления — пометить как deprecated:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления — пометить как deprecated:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/message-no-delete::top::15","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/message-no-delete::top::16","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message User { string name = 1; string email = 2; Address address = 3 [deprecated = true]; // [!code focus] }","content":"Хороший (Безопасный) message User { string name = 1; string email = 2; Address address = 3 [deprecated = true]; // [!code focus] }"},{"id":"cli/breaking-changes/rules/message-no-delete::top::17","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Address { option deprecated = true; // [!code focus] string street = 1; string city = 2; string country = 3; }","content":"Хороший (Безопасный) message Address { option deprecated = true; // [!code focus] string street = 1; string city = 2; string country = 3; }"},{"id":"cli/breaking-changes/rules/message-no-delete::top::18","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Order { string id = 1; User user = 2; } ```","content":"Хороший (Безопасный) message Order { string id = 1; User user = 2; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::top::19","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или заменить новой версией сообщения:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или заменить новой версией сообщения:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/message-no-delete::top::20","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/message-no-delete::top::21","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message User { string name = 1; string email = 2; Address address = 3 [deprecated = true]; // [!code focus] // Старое поле AddressV2 address_v2 = 4; // [!code focus] // Новая улучшенная структура }","content":"Хороший (Безопасный) message User { string name = 1; string email = 2; Address address = 3 [deprecated = true]; // [!code focus] // Старое поле AddressV2 address_v2 = 4; // [!code focus] // Новая улучшенная структура }"},{"id":"cli/breaking-changes/rules/message-no-delete::top::22","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Address { option deprecated = true; // [!code focus] string street = 1; string city = 2; string country = 3; }","content":"Хороший (Безопасный) message Address { option deprecated = true; // [!code focus] string street = 1; string city = 2; string country = 3; }"},{"id":"cli/breaking-changes/rules/message-no-delete::top::23","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message AddressV2 { // [!code focus] string street_address = 1; // [!code focus] string city = 2; // [!code focus] string state = 3; // [!code focus] string postal_code = 4; // [!code focus] string c","content":"Хороший (Безопасный) message AddressV2 { // [!code focus] string street_address = 1; // [!code focus] string city = 2; // [!code focus] string state = 3; // [!code focus] string postal_code = 4; // [!code focus] string country = 5; // [!code focus] } // [!code focus]"},{"id":"cli/breaking-changes/rules/message-no-delete::top::24","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Order { string id = 1; User user = 2; } ```","content":"Хороший (Безопасный) message Order { string id = 1; User user = 2; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::top::25","title":"MESSAGE_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Старые данные с удалённым сообщением не десериализуются **Generated Code:** Классы/структуры удаляются — компиляция клиента ломается **Field References:** Поля, использующие удалённый тип, станов","content":"Влияние **Wire Format:** Старые данные с удалённым сообщением не десериализуются **Generated Code:** Классы/структуры удаляются — компиляция клиента ломается **Field References:** Поля, использующие удалённый тип, становятся невалидны **Nested Dependencies:** Все сообщения, ссылающиеся на удалённый тип, ломаются"},{"id":"cli/breaking-changes/rules/message-no-delete::top::26","title":"MESSAGE_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается:** ```go // Before user := &myapi.User{ Name: \"John Doe\", Email: \"john@example.com\", Address: &myapi.Address{ // ERROR после удаления Street: \"123 Main St\", City: \"New York\", Countr","content":"Реальный пример **Код клиента ломается:** ```go // Before user := &myapi.User{ Name: \"John Doe\", Email: \"john@example.com\", Address: &myapi.Address{ // ERROR после удаления Street: \"123 Main St\", City: \"New York\", Country: \"USA\", }, }"},{"id":"cli/breaking-changes/rules/message-no-delete::top::27","title":"MESSAGE_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример // undefined: myapi.Address ```","content":"Реальный пример // undefined: myapi.Address ```"},{"id":"cli/breaking-changes/rules/message-no-delete::top::28","title":"MESSAGE_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Старые данные становятся нечитаемыми:**","content":"Реальный пример **Старые данные становятся нечитаемыми:**"},{"id":"cli/breaking-changes/rules/message-no-delete::top::29","title":"MESSAGE_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Пометить как deprecated:** **Пометить поля, использующие его:** **Добавить замену при необходимости:** **Удалить в следующей major‑версии после периода миграции**","content":"Стратегия миграции **Пометить как deprecated:** **Пометить поля, использующие его:** **Добавить замену при необходимости:** **Удалить в следующей major‑версии после периода миграции**"},{"id":"cli/breaking-changes/rules/message-no-delete::top::30","title":"MESSAGE_NO_DELETE","section":"Рефакторинг структуры","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Рефакторинг структуры"],"excerpt":"Рефакторинг структуры ```proto message UserInfo { option deprecated = true; string name = 1; string email = 2; }","content":"Рефакторинг структуры ```proto message UserInfo { option deprecated = true; string name = 1; string email = 2; }"},{"id":"cli/breaking-changes/rules/message-no-delete::top::31","title":"MESSAGE_NO_DELETE","section":"Рефакторинг структуры","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Рефакторинг структуры"],"excerpt":"Рефакторинг структуры message UserProfile { string full_name = 1; string email_address = 2; string phone = 3; } ```","content":"Рефакторинг структуры message UserProfile { string full_name = 1; string email_address = 2; string phone = 3; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::top::32","title":"MESSAGE_NO_DELETE","section":"Удаление «неиспользуемых» сообщений","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Удаление «неиспользуемых» сообщений"],"excerpt":"Удаление «неиспользуемых» сообщений","content":"Удаление «неиспользуемых» сообщений"},{"id":"cli/breaking-changes/rules/message-no-delete::top::33","title":"MESSAGE_NO_DELETE","section":"Миграция версии","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Миграция версии"],"excerpt":"Миграция версии ```proto package myapi.v2;","content":"Миграция версии ```proto package myapi.v2;"},{"id":"cli/breaking-changes/rules/message-no-delete::top::34","title":"MESSAGE_NO_DELETE","section":"Миграция версии","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Миграция версии"],"excerpt":"Миграция версии message User { // Новая структура без устаревших ссылок } ```","content":"Миграция версии message User { // Новая структура без устаревших ссылок } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::0","title":"ONEOF_FIELD_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":[],"excerpt":"Правило проверяет, что ни одно поле внутри oneof группы не было удалено. Удаление поля из oneof ломает совместимость по wire‑формату и сгенерированный код: в сохранённых данных может присутствовать выбранный вариант, а к","content":"Правило проверяет, что ни одно поле внутри oneof группы не было удалено. Удаление поля из oneof ломает совместимость по wire‑формату и сгенерированный код: в сохранённых данных может присутствовать выбранный вариант, а клиентский код опирается на сгенерированные типы‑обёртки и методы доступа."},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::breaking::1","title":"ONEOF_FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::breaking::2","title":"ONEOF_FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::breaking::3","title":"ONEOF_FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4; string certificate = 5; } }","content":"Плохой (Breaking) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4; string certificate = 5; } }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::breaking::4","title":"ONEOF_FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; string category = 3; DateRange date_range = 4; } } ```","content":"Плохой (Breaking) message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; string category = 3; DateRange date_range = 4; } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::breaking::5","title":"ONEOF_FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::breaking::6","title":"ONEOF_FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::breaking::7","title":"ONEOF_FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; // string oauth_token = 4; // [!code --] Удалено поле oneof — BREAKING! // string certificate = 5","content":"Плохой (Breaking) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; // string oauth_token = 4; // [!code --] Удалено поле oneof — BREAKING! // string certificate = 5; // [!code --] Удалено поле oneof — BREAKING! } }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::breaking::8","title":"ONEOF_FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; // string category = 3; // [!code --] Удалено поле oneof — BREAKING! // DateRange date_range = 4; // [!code --] Удалено поле oneo","content":"Плохой (Breaking) message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; // string category = 3; // [!code --] Удалено поле oneof — BREAKING! // DateRange date_range = 4; // [!code --] Удалено поле oneof — BREAKING! } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::9","title":"ONEOF_FIELD_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Удаление вложенных oneof полей:** ```proto // Before message PaymentRequest { string order_id = 1; oneof payment_method { CreditCardPayment credit_card = 2; BankTransferPayment bank_transfer = 3;","content":"Дополнительные примеры **Удаление вложенных oneof полей:** ```proto // Before message PaymentRequest { string order_id = 1; oneof payment_method { CreditCardPayment credit_card = 2; BankTransferPayment bank_transfer = 3; CryptoPayment crypto = 4; // [!code --] GiftCardPayment gift_card = 5; // [!code --] } }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::10","title":"ONEOF_FIELD_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - BREAKING CHANGES! message PaymentRequest { string order_id = 1; oneof payment_method { CreditCardPayment credit_card = 2; BankTransferPayment bank_transfer = 3; // CryptoPayment crypto =","content":"Дополнительные примеры // After - BREAKING CHANGES! message PaymentRequest { string order_id = 1; oneof payment_method { CreditCardPayment credit_card = 2; BankTransferPayment bank_transfer = 3; // CryptoPayment crypto = 4; // BREAKING: deleted // GiftCardPayment gift_card = 5; // BREAKING: deleted } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::11","title":"ONEOF_FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления — пометить поля deprecated:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления — пометить поля deprecated:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::12","title":"ONEOF_FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::13","title":"ONEOF_FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4 [deprecated = true]; // [!code focus] string certificate = 5 [deprecate","content":"Хороший (Безопасный) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4 [deprecated = true]; // [!code focus] string certificate = 5 [deprecated = true]; // [!code focus] } }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::14","title":"ONEOF_FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; string category = 3 [deprecated = true]; // [!code focus] DateRange date_range = 4 [deprecated = true]; // [!code focus] } } `","content":"Хороший (Безопасный) message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; string category = 3 [deprecated = true]; // [!code focus] DateRange date_range = 4 [deprecated = true]; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::15","title":"ONEOF_FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или добавить новые поля, оставив старые:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или добавить новые поля, оставив старые:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::16","title":"ONEOF_FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::17","title":"ONEOF_FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4 [deprecated = true]; // [!code focus] // Старое поле string certificate","content":"Хороший (Безопасный) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4 [deprecated = true]; // [!code focus] // Старое поле string certificate = 5 [deprecated = true]; // [!code focus] OAuthCredentials oauth_v2 = 6; // [!code focus] // Новый структурированный вариант CertificateCredentials cert_v2 = 7; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::18","title":"ONEOF_FIELD_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Данные, содержащие удалённый вариант, не десериализуются корректно **Generated Code:** Удаляются типы‑обёртки и accessor методы — компиляция клиентов ломается **Type Safety:** Логика switch по ти","content":"Влияние **Wire Format:** Данные, содержащие удалённый вариант, не десериализуются корректно **Generated Code:** Удаляются типы‑обёртки и accessor методы — компиляция клиентов ломается **Type Safety:** Логика switch по типам oneof разваливается **Business Logic:** Код, ожидающий конкретный вариант, перестаёт работать"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::19","title":"ONEOF_FIELD_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается:** ```go // Before loginReq := &myapi.LoginRequest{ Username: \"user123\", }","content":"Реальный пример **Код клиента ломается:** ```go // Before loginReq := &myapi.LoginRequest{ Username: \"user123\", }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::20","title":"ONEOF_FIELD_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример loginReq.Credentials = &myapi.LoginRequest_OauthToken{ OauthToken: \"token123\", // ERROR после удаления поля }","content":"Реальный пример loginReq.Credentials = &myapi.LoginRequest_OauthToken{ OauthToken: \"token123\", // ERROR после удаления поля }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::21","title":"ONEOF_FIELD_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример switch cred := loginReq.Credentials.(type) { case *myapi.LoginRequest_Password: return authenticatePassword(cred.Password) case *myapi.LoginRequest_OauthToken: // ERROR: тип удалён return authenticateOAut","content":"Реальный пример switch cred := loginReq.Credentials.(type) { case *myapi.LoginRequest_Password: return authenticatePassword(cred.Password) case *myapi.LoginRequest_OauthToken: // ERROR: тип удалён return authenticateOAuth(cred.OauthToken) case *myapi.LoginRequest_Certificate: // ERROR: тип удалён return authenticateCert(cred.Certificate) default: return errors.New(\"unsupported credential type\") } // undefined: myapi.LoginRequest_OauthToken // undefined: myapi.LoginRequest_Certificate ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::22","title":"ONEOF_FIELD_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Серверная логика ломается:**","content":"Реальный пример **Серверная логика ломается:**"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::23","title":"ONEOF_FIELD_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Старые данные становятся нечитаемыми:**","content":"Реальный пример **Старые данные становятся нечитаемыми:**"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::24","title":"ONEOF_FIELD_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Депрецируйте сначала:** **Добавьте новые структурированные поля:** **Сервер: поддерживайте оба варианта:** **Мигрируйте клиентов на новое поле:** **Зарезервируйте номера удалённых полей в следующей m","content":"Стратегия миграции **Депрецируйте сначала:** **Добавьте новые структурированные поля:** **Сервер: поддерживайте оба варианта:** **Мигрируйте клиентов на новое поле:** **Зарезервируйте номера удалённых полей в следующей major‑версии:**"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::25","title":"ONEOF_FIELD_NO_DELETE","section":"Удаление неподдерживаемых методов аутентификации","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Удаление неподдерживаемых методов аутентификации"],"excerpt":"Удаление неподдерживаемых методов аутентификации","content":"Удаление неподдерживаемых методов аутентификации"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::26","title":"ONEOF_FIELD_NO_DELETE","section":"Изменения бизнес‑логики платежей","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Изменения бизнес‑логики платежей"],"excerpt":"Изменения бизнес‑логики платежей","content":"Изменения бизнес‑логики платежей"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::oneof-field-deletion-vs::27","title":"ONEOF_FIELD_NO_DELETE","section":"OneOf Field Deletion vs обычное удаление","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#oneof-field-deletion-vs","headings":["OneOf Field Deletion vs обычное удаление"],"excerpt":"OneOf Field Deletion vs обычное удаление","content":"OneOf Field Deletion vs обычное удаление"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::28","title":"ONEOF_FIELD_NO_DELETE","section":"Отличия от удаления обычного поля","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Отличия от удаления обычного поля"],"excerpt":"Отличия от удаления обычного поля ```proto message User { string name = 1; // string email = 2; // BREAKING: обычное поле }","content":"Отличия от удаления обычного поля ```proto message User { string name = 1; // string email = 2; // BREAKING: обычное поле }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::29","title":"ONEOF_FIELD_NO_DELETE","section":"Отличия от удаления обычного поля","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Отличия от удаления обычного поля"],"excerpt":"Отличия от удаления обычного поля message User { oneof contact { string email = 1; // string phone = 2; // BREAKING: поле в oneof } } ```","content":"Отличия от удаления обычного поля message User { oneof contact { string email = 1; // string phone = 2; // BREAKING: поле в oneof } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::30","title":"ONEOF_FIELD_NO_DELETE","section":"Влияние на сгенерированный код","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Влияние на сгенерированный код"],"excerpt":"Влияние на сгенерированный код ```go // Обычное поле: удаляется простой геттер // user.GetEmail()","content":"Влияние на сгенерированный код ```go // Обычное поле: удаляется простой геттер // user.GetEmail()"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::31","title":"ONEOF_FIELD_NO_DELETE","section":"Влияние на сгенерированный код","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Влияние на сгенерированный код"],"excerpt":"Влияние на сгенерированный код // Поле в oneof: пропадает тип-обёртка, кейсы switch ломаются // *LoginRequest_OauthToken ```","content":"Влияние на сгенерированный код // Поле в oneof: пропадает тип-обёртка, кейсы switch ломаются // *LoginRequest_OauthToken ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::0","title":"ONEOF_FIELD_SAME_TYPE","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":[],"excerpt":"Это правило проверяет, что тип поля внутри oneof НЕ меняется. Смена типа любого варианта oneof — несовместимое (breaking) изменение: существующие данные сериализованы с прежним типом, а клиентский код ожидает конкретные ","content":"Это правило проверяет, что тип поля внутри oneof НЕ меняется. Смена типа любого варианта oneof — несовместимое (breaking) изменение: существующие данные сериализованы с прежним типом, а клиентский код ожидает конкретные типы-обёртки и методы доступа, сгенерированные для каждого варианта."},{"id":"cli/breaking-changes/rules/oneof-field-same-type::breaking::1","title":"ONEOF_FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::breaking::2","title":"ONEOF_FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::breaking::3","title":"ONEOF_FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message SearchRequest { string query = 1; oneof filter { string category = 2; int32 user_id = 3; bool is_premium = 4; DateRange date_range = 5; } }","content":"Плохой (Breaking) message SearchRequest { string query = 1; oneof filter { string category = 2; int32 user_id = 3; bool is_premium = 4; DateRange date_range = 5; } }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::breaking::4","title":"ONEOF_FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message NotificationSettings { oneof delivery { string email = 1; int64 phone_number = 2; WebhookConfig webhook = 3; } } ```","content":"Плохой (Breaking) message NotificationSettings { oneof delivery { string email = 1; int64 phone_number = 2; WebhookConfig webhook = 3; } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::breaking::5","title":"ONEOF_FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::breaking::6","title":"ONEOF_FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::breaking::7","title":"ONEOF_FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message SearchRequest { string query = 1; oneof filter { int32 category = 2; // [!code --] Было string -> стало int32 (BREAKING) string user_id = 3; // [!code --] Было int32 -> стало string (BREAKING) s","content":"Плохой (Breaking) message SearchRequest { string query = 1; oneof filter { int32 category = 2; // [!code --] Было string -> стало int32 (BREAKING) string user_id = 3; // [!code --] Было int32 -> стало string (BREAKING) string is_premium = 4; // [!code --] Было bool -> стало string (BREAKING) string date_range = 5; // [!code --] Было DateRange -> стало string (BREAKING) } }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::breaking::8","title":"ONEOF_FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message NotificationSettings { oneof delivery { EmailConfig email = 1; // [!code --] Было string -> стало EmailConfig (BREAKING) string phone_number = 2; // [!code --] Было int64 -> стало string (BREAKI","content":"Плохой (Breaking) message NotificationSettings { oneof delivery { EmailConfig email = 1; // [!code --] Было string -> стало EmailConfig (BREAKING) string phone_number = 2; // [!code --] Было int64 -> стало string (BREAKING) string webhook = 3; // [!code --] Было WebhookConfig -> стало string (BREAKING) } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::9","title":"ONEOF_FIELD_SAME_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Комплексные изменения типов:** ```proto // Before message PaymentRequest { oneof payment_info { CreditCardInfo credit_card = 1; BankAccountInfo bank_account = 2; string paypal_email = 3; CryptoWa","content":"Дополнительные примеры **Комплексные изменения типов:** ```proto // Before message PaymentRequest { oneof payment_info { CreditCardInfo credit_card = 1; BankAccountInfo bank_account = 2; string paypal_email = 3; CryptoWalletInfo crypto = 4; } }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::10","title":"ONEOF_FIELD_SAME_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - ВСЁ BREAKING message PaymentRequest { oneof payment_info { string credit_card = 1; // CreditCardInfo -> string PayPalInfo bank_account = 2; // BankAccountInfo -> PayPalInfo PayPalInfo pa","content":"Дополнительные примеры // After - ВСЁ BREAKING message PaymentRequest { oneof payment_info { string credit_card = 1; // CreditCardInfo -> string PayPalInfo bank_account = 2; // BankAccountInfo -> PayPalInfo PayPalInfo paypal_email = 3; // string -> PayPalInfo string crypto = 4; // CryptoWalletInfo -> string } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::11","title":"ONEOF_FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо смены типа — добавьте новое поле в тот же oneof:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо смены типа — добавьте новое поле в тот же oneof:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::12","title":"ONEOF_FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::13","title":"ONEOF_FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message SearchRequest { string query = 1; oneof filter { string category = 2 [deprecated = true]; // Старый тип int32 user_id = 3 [deprecated = true]; bool is_premium = 4 [deprecated = true]; DateRan","content":"Хороший (Безопасный) message SearchRequest { string query = 1; oneof filter { string category = 2 [deprecated = true]; // Старый тип int32 user_id = 3 [deprecated = true]; bool is_premium = 4 [deprecated = true]; DateRange date_range = 5 [deprecated = true]; int32 category_id = 6; // Новая версия string user_identifier = 7; string premium_status = 8; string date_filter = 9; } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::14","title":"ONEOF_FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или создайте новый oneof:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или создайте новый oneof:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::15","title":"ONEOF_FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::16","title":"ONEOF_FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message SearchRequest { string query = 1; oneof filter { option deprecated = true; string category = 2 [deprecated = true]; int32 user_id = 3 [deprecated = true]; bool is_premium = 4 [deprecated = tr","content":"Хороший (Безопасный) message SearchRequest { string query = 1; oneof filter { option deprecated = true; string category = 2 [deprecated = true]; int32 user_id = 3 [deprecated = true]; bool is_premium = 4 [deprecated = true]; DateRange date_range = 5 [deprecated = true]; } oneof filter_v2 { int32 category_id = 6; string user_identifier = 7; PremiumFilter premium_filter = 8; TimeFilter time_filter = 9; } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::17","title":"ONEOF_FIELD_SAME_TYPE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Старые бинарные данные не читаются корректно **Generated Code:** Меняются типы-обёртки, код клиента не компилируется **Type Safety:** switch по варианту oneof ломается **Runtime Errors:** Ошибки ","content":"Влияние **Wire Format:** Старые бинарные данные не читаются корректно **Generated Code:** Меняются типы-обёртки, код клиента не компилируется **Type Safety:** switch по варианту oneof ломается **Runtime Errors:** Ошибки десериализации и логики при несовпадении типов"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::18","title":"ONEOF_FIELD_SAME_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Реальный пример"],"excerpt":"Реальный пример **Ломается клиентский код:** ```go // Before searchReq := &myapi.SearchRequest{ Query: \"golang jobs\", }","content":"Реальный пример **Ломается клиентский код:** ```go // Before searchReq := &myapi.SearchRequest{ Query: \"golang jobs\", }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::19","title":"ONEOF_FIELD_SAME_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Реальный пример"],"excerpt":"Реальный пример // Устанавливаем вариант oneof searchReq.Filter = &myapi.SearchRequest_Category{ Category: \"engineering\", }","content":"Реальный пример // Устанавливаем вариант oneof searchReq.Filter = &myapi.SearchRequest_Category{ Category: \"engineering\", }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::20","title":"ONEOF_FIELD_SAME_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Реальный пример"],"excerpt":"Реальный пример // Обработка вариантов switch filter := searchReq.Filter.(type) { case *myapi.SearchRequest_Category: return searchByCategory(filter.Category) case *myapi.SearchRequest_UserId: return searchByUserId(filte","content":"Реальный пример // Обработка вариантов switch filter := searchReq.Filter.(type) { case *myapi.SearchRequest_Category: return searchByCategory(filter.Category) case *myapi.SearchRequest_UserId: return searchByUserId(filter.UserId) default: return errors.New(\"unsupported filter\") }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::21","title":"ONEOF_FIELD_SAME_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Реальный пример"],"excerpt":"Реальный пример // After — тип Category стал int32 searchReq.Filter = &myapi.SearchRequest_Category{ Category: \"engineering\", // ERROR }","content":"Реальный пример // After — тип Category стал int32 searchReq.Filter = &myapi.SearchRequest_Category{ Category: \"engineering\", // ERROR }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::22","title":"ONEOF_FIELD_SAME_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Реальный пример"],"excerpt":"Реальный пример switch filter := searchReq.Filter.(type) { case *myapi.SearchRequest_Category: return searchByCategory(filter.Category) // ERROR case *myapi.SearchRequest_UserId: return searchByUserId(filter.UserId) // E","content":"Реальный пример switch filter := searchReq.Filter.(type) { case *myapi.SearchRequest_Category: return searchByCategory(filter.Category) // ERROR case *myapi.SearchRequest_UserId: return searchByUserId(filter.UserId) // ERROR: UserId теперь string } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::23","title":"ONEOF_FIELD_SAME_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Реальный пример"],"excerpt":"Реальный пример **Ломается серверная логика:** ```go // Before func handleSearchFilter(req *SearchRequest) (*SearchResult, error) { switch filter := req.Filter.(type) { case *SearchRequest_Category: return searchDatabase","content":"Реальный пример **Ломается серверная логика:** ```go // Before func handleSearchFilter(req *SearchRequest) (*SearchResult, error) { switch filter := req.Filter.(type) { case *SearchRequest_Category: return searchDatabase(\"category\", filter.Category), nil case *SearchRequest_UserId: return searchDatabase(\"user_id\", strconv.Itoa(int(filter.UserId))), nil default: return nil, errors.New(\"no filter specified\") } }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::24","title":"ONEOF_FIELD_SAME_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Реальный пример"],"excerpt":"Реальный пример // After — несовпадения типов func handleSearchFilter(req *SearchRequest) (*SearchResult, error) { switch filter := req.Filter.(type) { case *SearchRequest_Category: // filter.Category теперь int32, а код","content":"Реальный пример // After — несовпадения типов func handleSearchFilter(req *SearchRequest) (*SearchResult, error) { switch filter := req.Filter.(type) { case *SearchRequest_Category: // filter.Category теперь int32, а код ожидал string return searchDatabase(\"category\", filter.Category), nil // ERROR case *SearchRequest_UserId: userIdStr := filter.UserId // string вместо int32 userId, _ := strconv.Atoi(userIdStr) return searchDatabase(\"user_id\", strconv.Itoa(userId)), nil } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::25","title":"ONEOF_FIELD_SAME_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Реальный пример"],"excerpt":"Реальный пример **Порча данных:**","content":"Реальный пример **Порча данных:**"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::26","title":"ONEOF_FIELD_SAME_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции Добавьте новое поле: Сервер поддерживает оба: Клиенты переходят на category_id. Скрипты миграции преобразуют старые данные. В следующей major‑версии:","content":"Стратегия миграции Добавьте новое поле: Сервер поддерживает оба: Клиенты переходят на category_id. Скрипты миграции преобразуют старые данные. В следующей major‑версии:"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::27","title":"ONEOF_FIELD_SAME_TYPE","section":"Переход к структурированным типам","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Переход к структурированным типам"],"excerpt":"Переход к структурированным типам","content":"Переход к структурированным типам"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::28","title":"ONEOF_FIELD_SAME_TYPE","section":"Матрица совместимости","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Матрица совместимости"],"excerpt":"Матрица совместимости From Type To Type Результат ----------- --------- ----------- string int32/int64 ❌ BREAKING int32 string ❌ BREAKING bool string ❌ BREAKING message string ❌ BREAKING string message ❌ BREAKING enum in","content":"Матрица совместимости From Type To Type Результат ----------- --------- ----------- string int32/int64 ❌ BREAKING int32 string ❌ BREAKING bool string ❌ BREAKING message string ❌ BREAKING string message ❌ BREAKING enum int32 ❌ BREAKING"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::29","title":"ONEOF_FIELD_SAME_TYPE","section":"Влияние на сгенерированный код","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Влияние на сгенерированный код"],"excerpt":"Влияние на сгенерированный код","content":"Влияние на сгенерированный код"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::30","title":"ONEOF_FIELD_SAME_TYPE","section":"Валидация","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Валидация"],"excerpt":"Валидация **После (сломано):**","content":"Валидация **После (сломано):**"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::0","title":"ONEOF_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":[],"excerpt":"Это правило проверяет, что ни один oneof блок не был удалён из сообщений. Удаление oneof ломает совместимость по wire‑формату и сгенерированный код: существующие данные могут содержать ранее выбранный вариант, а клиентск","content":"Это правило проверяет, что ни один oneof блок не был удалён из сообщений. Удаление oneof ломает совместимость по wire‑формату и сгенерированный код: существующие данные могут содержать ранее выбранный вариант, а клиентский код зависит от типов-обёрток и методов доступа, генерируемых для oneof."},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::1","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::2","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::3","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4; } }","content":"Плохой (Breaking) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4; } }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::4","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message PaymentMethod { // [!code --] oneof method { // [!code --] CreditCard credit_card = 1; // [!code --] BankAccount bank_account = 2; // [!code --] PayPal paypal = 3; // [!code --] } // [!code --] ","content":"Плохой (Breaking) message PaymentMethod { // [!code --] oneof method { // [!code --] CreditCard credit_card = 1; // [!code --] BankAccount bank_account = 2; // [!code --] PayPal paypal = 3; // [!code --] } // [!code --] } // [!code --]"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::5","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Order { string id = 1; PaymentMethod payment = 2; } ```","content":"Плохой (Breaking) message Order { string id = 1; PaymentMethod payment = 2; } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::6","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::7","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::8","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message LoginRequest { string username = 1; // credentials oneof удалён — BREAKING CHANGE! string password = 2; // Теперь обычные поля string api_key = 3; // Потеряна взаимная исключаемость string oauth","content":"Плохой (Breaking) message LoginRequest { string username = 1; // credentials oneof удалён — BREAKING CHANGE! string password = 2; // Теперь обычные поля string api_key = 3; // Потеряна взаимная исключаемость string oauth_token = 4; }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::9","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message PaymentMethod { // method oneof удалён — BREAKING CHANGE! CreditCard credit_card = 1; // Теперь можно установить все поля одновременно BankAccount bank_account = 2; PayPal paypal = 3; }","content":"Плохой (Breaking) message PaymentMethod { // method oneof удалён — BREAKING CHANGE! CreditCard credit_card = 1; // Теперь можно установить все поля одновременно BankAccount bank_account = 2; PayPal paypal = 3; }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::10","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Order { string id = 1; PaymentMethod payment = 2; } ```","content":"Плохой (Breaking) message Order { string id = 1; PaymentMethod payment = 2; } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::11","title":"ONEOF_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Удаление вложенного oneof:** ```proto // Before message UserProfile { string name = 1; message ContactInfo { oneof contact_method { // [!code --] string email = 1; // [!code --] string phone = 2;","content":"Дополнительные примеры **Удаление вложенного oneof:** ```proto // Before message UserProfile { string name = 1; message ContactInfo { oneof contact_method { // [!code --] string email = 1; // [!code --] string phone = 2; // [!code --] string slack_id = 3; // [!code --] } // [!code --] } ContactInfo contact = 2; }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::12","title":"ONEOF_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - BREAKING CHANGE! message UserProfile { string name = 1; message ContactInfo { // contact_method oneof удалён string email = 1; // Больше не эксклюзивно string phone = 2; // Можно задать ","content":"Дополнительные примеры // After - BREAKING CHANGE! message UserProfile { string name = 1; message ContactInfo { // contact_method oneof удалён string email = 1; // Больше не эксклюзивно string phone = 2; // Можно задать всё сразу string slack_id = 3; } ContactInfo contact = 2; } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::13","title":"ONEOF_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления — депрецируйте oneof:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления — депрецируйте oneof:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::14","title":"ONEOF_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::15","title":"ONEOF_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message LoginRequest { string username = 1; oneof credentials { option deprecated = true; // [!code focus] string password = 2 [deprecated = true]; // [!code focus] string api_key = 3 [deprecated = t","content":"Хороший (Безопасный) message LoginRequest { string username = 1; oneof credentials { option deprecated = true; // [!code focus] string password = 2 [deprecated = true]; // [!code focus] string api_key = 3 [deprecated = true]; // [!code focus] string oauth_token = 4 [deprecated = true]; // [!code focus] } }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::16","title":"ONEOF_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message PaymentMethod { oneof method { option deprecated = true; // [!code focus] CreditCard credit_card = 1 [deprecated = true]; // [!code focus] BankAccount bank_account = 2 [deprecated = true]; //","content":"Хороший (Безопасный) message PaymentMethod { oneof method { option deprecated = true; // [!code focus] CreditCard credit_card = 1 [deprecated = true]; // [!code focus] BankAccount bank_account = 2 [deprecated = true]; // [!code focus] PayPal paypal = 3 [deprecated = true]; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::17","title":"ONEOF_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или заменить новой структурой:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или заменить новой структурой:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::18","title":"ONEOF_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::19","title":"ONEOF_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message LoginRequest { string username = 1; oneof credentials { option deprecated = true; // [!code focus] // Старый oneof string password = 2 [deprecated = true]; // [!code focus] string api_key = 3","content":"Хороший (Безопасный) message LoginRequest { string username = 1; oneof credentials { option deprecated = true; // [!code focus] // Старый oneof string password = 2 [deprecated = true]; // [!code focus] string api_key = 3 [deprecated = true]; // [!code focus] string oauth_token = 4 [deprecated = true]; // [!code focus] } oneof auth_method { // [!code focus] // Новый дизайн PasswordAuth password_auth = 5; // [!code focus] ApiKeyAuth api_auth = 6; // [!code focus] OAuthAuth oauth_auth = 7; // [!code focus] } // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::20","title":"ONEOF_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Теряются семантика взаимной исключаемости — больше одного поля может быть установлено **Generated Code:** Удаляются типы-обёртки и accessor методы — код клиента не компилируется **Business Logic:","content":"Влияние **Wire Format:** Теряются семантика взаимной исключаемости — больше одного поля может быть установлено **Generated Code:** Удаляются типы-обёртки и accessor методы — код клиента не компилируется **Business Logic:** Нарушаются инварианты «только один из» **Validation:** Логика проверок должна быть переписана вручную"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::21","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается:** ```go // Before - oneOf даёт взаимную исключаемость loginReq := &myapi.LoginRequest{ Username: \"user123\", }","content":"Реальный пример **Код клиента ломается:** ```go // Before - oneOf даёт взаимную исключаемость loginReq := &myapi.LoginRequest{ Username: \"user123\", }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::22","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример loginReq.Credentials = &myapi.LoginRequest_Password{ Password: \"secret123\", }","content":"Реальный пример loginReq.Credentials = &myapi.LoginRequest_Password{ Password: \"secret123\", }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::23","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример switch cred := loginReq.Credentials.(type) { case *myapi.LoginRequest_Password: // ERROR после удаления return authenticatePassword(cred.Password) case *myapi.LoginRequest_ApiKey: // ERROR после удаления ","content":"Реальный пример switch cred := loginReq.Credentials.(type) { case *myapi.LoginRequest_Password: // ERROR после удаления return authenticatePassword(cred.Password) case *myapi.LoginRequest_ApiKey: // ERROR после удаления return authenticateApiKey(cred.ApiKey) default: return errors.New(\"no credentials provided\") }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::24","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример // Compilation errors: // undefined: myapi.LoginRequest_Password // undefined field: loginReq.Credentials ```","content":"Реальный пример // Compilation errors: // undefined: myapi.LoginRequest_Password // undefined field: loginReq.Credentials ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::25","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Валидация на сервере ломается:** ```go // Before func validateLoginRequest(req *LoginRequest) error { if req.Credentials == nil { return errors.New(\"credentials required\") } switch req.Credentials.(type","content":"Реальный пример **Валидация на сервере ломается:** ```go // Before func validateLoginRequest(req *LoginRequest) error { if req.Credentials == nil { return errors.New(\"credentials required\") } switch req.Credentials.(type) { case *LoginRequest_Password: return validatePassword(req.GetPassword()) case *LoginRequest_ApiKey: return validateApiKey(req.GetApiKey()) case *LoginRequest_OauthToken: return validateOAuthToken(req.GetOauthToken()) default: return errors.New(\"unknown credential type\") } }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::26","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример // After func validateLoginRequest(req *LoginRequest) error { credCount := 0 if req.Password != \"\" { credCount++ } if req.ApiKey != \"\" { credCount++ } if req.OauthToken != \"\" { credCount++ }","content":"Реальный пример // After func validateLoginRequest(req *LoginRequest) error { credCount := 0 if req.Password != \"\" { credCount++ } if req.ApiKey != \"\" { credCount++ } if req.OauthToken != \"\" { credCount++ }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::27","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример if credCount == 0 { return errors.New(\"no credentials provided\") } if credCount > 1 { return errors.New(\"multiple credentials provided\") }","content":"Реальный пример if credCount == 0 { return errors.New(\"no credentials provided\") } if credCount > 1 { return errors.New(\"multiple credentials provided\") }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::28","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример if req.Password != \"\" { return validatePassword(req.Password) } // Дополнительные проверки вручную... return nil } ```","content":"Реальный пример if req.Password != \"\" { return validatePassword(req.Password) } // Дополнительные проверки вручную... return nil } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::29","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Проблемы бизнес‑логики:** ```go // Before payment := &PaymentMethod{ Method: &PaymentMethod_CreditCard{ CreditCard: &CreditCard{Number: \"1234\"}, }, }","content":"Реальный пример **Проблемы бизнес‑логики:** ```go // Before payment := &PaymentMethod{ Method: &PaymentMethod_CreditCard{ CreditCard: &CreditCard{Number: \"1234\"}, }, }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::30","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример // After — можно задать несколько способов сразу payment := &PaymentMethod{ CreditCard: &CreditCard{Number: \"1234\"}, BankAccount: &BankAccount{Number: \"5678\"}, // Ломает бизнес-логику } ```","content":"Реальный пример // After — можно задать несколько способов сразу payment := &PaymentMethod{ CreditCard: &CreditCard{Number: \"1234\"}, BankAccount: &BankAccount{Number: \"5678\"}, // Ломает бизнес-логику } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::31","title":"ONEOF_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Депрецируйте старый oneof и его поля:**","content":"Стратегия миграции **Депрецируйте старый oneof и его поля:**"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::32","title":"ONEOF_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Создайте новый блок при необходимости:**","content":"Стратегия миграции **Создайте новый блок при необходимости:**"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::33","title":"ONEOF_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Сервер: поддерживайте оба до миграции:**","content":"Стратегия миграции **Сервер: поддерживайте оба до миграции:**"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::34","title":"ONEOF_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Клиенты: переходите на новый oneof:**","content":"Стратегия миграции **Клиенты: переходите на новый oneof:**"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::35","title":"ONEOF_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Удалите старый oneof** в следующей major‑версии.","content":"Стратегия миграции **Удалите старый oneof** в следующей major‑версии."},{"id":"cli/breaking-changes/rules/oneof-no-delete::oneof::36","title":"ONEOF_NO_DELETE","section":"Замена oneof обычными полями","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#oneof","headings":["Замена oneof обычными полями"],"excerpt":"Замена oneof обычными полями ```proto message SearchRequest { // НЕЛЬЗЯ просто убрать oneof — ломает семантику string text_query = 1; // BREAKING int32 user_id = 2; // BREAKING string category = 3; // BREAKING }","content":"Замена oneof обычными полями ```proto message SearchRequest { // НЕЛЬЗЯ просто убрать oneof — ломает семантику string text_query = 1; // BREAKING int32 user_id = 2; // BREAKING string category = 3; // BREAKING }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::oneof::37","title":"ONEOF_NO_DELETE","section":"Замена oneof обычными полями","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#oneof","headings":["Замена oneof обычными полями"],"excerpt":"Замена oneof обычными полями message SearchRequest { oneof query { option deprecated = true; string text_query = 1 [deprecated = true]; int32 user_id = 2 [deprecated = true]; string category = 3 [deprecated = true]; } st","content":"Замена oneof обычными полями message SearchRequest { oneof query { option deprecated = true; string text_query = 1 [deprecated = true]; int32 user_id = 2 [deprecated = true]; string category = 3 [deprecated = true]; } string search_text = 4; repeated string filters = 5; } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::38","title":"ONEOF_NO_DELETE","section":"Упрощение структуры сообщения","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Упрощение структуры сообщения"],"excerpt":"Упрощение структуры сообщения ```proto message NotificationSettings { string email = 1; // BREAKING: был в oneof string phone = 2; // BREAKING string webhook_url = 3; // BREAKING }","content":"Упрощение структуры сообщения ```proto message NotificationSettings { string email = 1; // BREAKING: был в oneof string phone = 2; // BREAKING string webhook_url = 3; // BREAKING }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::39","title":"ONEOF_NO_DELETE","section":"Упрощение структуры сообщения","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Упрощение структуры сообщения"],"excerpt":"Упрощение структуры сообщения message NotificationSettings { oneof delivery_method { EmailNotification email = 1; SmsNotification phone = 2; WebhookNotification webhook = 3; } } ```","content":"Упрощение структуры сообщения message NotificationSettings { oneof delivery_method { EmailNotification email = 1; SmsNotification phone = 2; WebhookNotification webhook = 3; } } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::proto2-proto3::40","title":"ONEOF_NO_DELETE","section":"Миграция с proto2 на proto3","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#proto2-proto3","headings":["Миграция с proto2 на proto3"],"excerpt":"Миграция с proto2 на proto3 ```proto // proto2 message Request { optional string name = 1; oneof data { string text = 2; int32 number = 3; } }","content":"Миграция с proto2 на proto3 ```proto // proto2 message Request { optional string name = 1; oneof data { string text = 2; int32 number = 3; } }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::proto2-proto3::41","title":"ONEOF_NO_DELETE","section":"Миграция с proto2 на proto3","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#proto2-proto3","headings":["Миграция с proto2 на proto3"],"excerpt":"Миграция с proto2 на proto3 // proto3 — сохраняем oneof message Request { string name = 1; oneof data { string text = 2; int32 number = 3; } } ```","content":"Миграция с proto2 на proto3 // proto3 — сохраняем oneof message Request { string name = 1; oneof data { string text = 2; int32 number = 3; } } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::oneof::42","title":"ONEOF_NO_DELETE","section":"Что даёт oneof","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#oneof","headings":["Что даёт oneof"],"excerpt":"Что даёт oneof Взаимная исключаемость Типобезопасность в коде Ясность намерения API («выбери один») Эффективная сериализация — кодируется только выбранный вариант","content":"Что даёт oneof Взаимная исключаемость Типобезопасность в коде Ясность намерения API («выбери один») Эффективная сериализация — кодируется только выбранный вариант"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::43","title":"ONEOF_NO_DELETE","section":"Что теряется при удалении","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Что теряется при удалении"],"excerpt":"Что теряется при удалении Инвариант «только один» Генерируемые wrapper-типы и методы Автоматическая валидация выбора Понятность контракта API","content":"Что теряется при удалении Инвариант «только один» Генерируемые wrapper-типы и методы Автоматическая валидация выбора Понятность контракта API"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::44","title":"ONEOF_NO_DELETE","section":"Влияние на код генерации","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Влияние на код генерации"],"excerpt":"Влияние на код генерации ```go // С oneof type LoginRequest struct { Username string Credentials isLoginRequest_Credentials }","content":"Влияние на код генерации ```go // С oneof type LoginRequest struct { Username string Credentials isLoginRequest_Credentials }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::45","title":"ONEOF_NO_DELETE","section":"Влияние на код генерации","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Влияние на код генерации"],"excerpt":"Влияние на код генерации // Без oneof type LoginRequest struct { Username string Password string ApiKey string OauthToken string // Возможны многозначные конфликтующие состояния } ```","content":"Влияние на код генерации // Без oneof type LoginRequest struct { Username string Password string ApiKey string OauthToken string // Возможны многозначные конфликтующие состояния } ```"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::0","title":"RPC_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":[],"excerpt":"Правило проверяет, что ни один RPC‑метод не был удалён из service. Удаление RPC ломает сгенерированный код и клиентские приложения, которые этот метод вызывают.","content":"Правило проверяет, что ни один RPC‑метод не был удалён из service. Удаление RPC ломает сгенерированный код и клиентские приложения, которые этот метод вызывают."},{"id":"cli/breaking-changes/rules/rpc-no-delete::breaking::1","title":"RPC_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-no-delete::breaking::2","title":"RPC_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-no-delete::breaking::3","title":"RPC_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse","content":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse); // [!code --] } ```"},{"id":"cli/breaking-changes/rules/rpc-no-delete::breaking::4","title":"RPC_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-no-delete::breaking::5","title":"RPC_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-no-delete::breaking::6","title":"RPC_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); // DeleteUser RPC удалён — BREAKING CHANGE! } ```","content":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); // DeleteUser RPC удалён — BREAKING CHANGE! } ```"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::7","title":"RPC_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления — пометить RPC deprecated:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления — пометить RPC deprecated:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::8","title":"RPC_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::9","title":"RPC_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); rpc DeleteUser(DeleteUserRequest) returns (DeleteUserRespo","content":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse) { option deprecated = true; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::10","title":"RPC_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":["Влияние"],"excerpt":"Влияние **Generated Code:** Stub/метод исчезает — клиенты не компилируются **Client Applications:** Существующие вызовы метода падают при сборке **Runtime:** gRPC клиенты теряют определение метода","content":"Влияние **Generated Code:** Stub/метод исчезает — клиенты не компилируются **Client Applications:** Существующие вызовы метода падают при сборке **Runtime:** gRPC клиенты теряют определение метода"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::11","title":"RPC_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Сначала деприкация:**","content":"Стратегия миграции **Сначала деприкация:**"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::12","title":"RPC_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Имплементация может возвращать ошибку**, указывая что метод устарел (например, INTERNAL / UNIMPLEMENTED)","content":"Стратегия миграции **Имплементация может возвращать ошибку**, указывая что метод устарел (например, INTERNAL / UNIMPLEMENTED)"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::13","title":"RPC_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Удалить в следующей major‑версии** после миграции всех клиентов","content":"Стратегия миграции **Удалить в следующей major‑версии** после миграции всех клиентов"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::0","title":"RPC_SAME_REQUEST_TYPE","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":[],"excerpt":"Это правило проверяет, что RPC‑методы сохраняют прежний тип сообщения запроса (request message type). Изменение типа запроса RPC ломает совместимость по wire‑формату и сгенерированный код: клиенты ожидают конкретную стру","content":"Это правило проверяет, что RPC‑методы сохраняют прежний тип сообщения запроса (request message type). Изменение типа запроса RPC ломает совместимость по wire‑формату и сгенерированный код: клиенты ожидают конкретную структуру при вызове метода."},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::1","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::2","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::3","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); }","content":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::4","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message GetUserRequest { string user_id = 1; }","content":"Плохой (Breaking) message GetUserRequest { string user_id = 1; }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::5","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message UpdateUserRequest { string user_id = 1; string name = 2; string email = 3; } ```","content":"Плохой (Breaking) message UpdateUserRequest { string user_id = 1; string name = 2; string email = 3; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::6","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::7","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::8","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // [!code --] Изменён тип запроса rpc UpdateUser(UserUpdateRequest) returns (UpdateUserResponse); // [!code --] Изменён тип","content":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // [!code --] Изменён тип запроса rpc UpdateUser(UserUpdateRequest) returns (UpdateUserResponse); // [!code --] Изменён тип запроса }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::9","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message GetUserRequestV2 { // [!code --] Новый тип запроса string id = 1; bool include_profile = 2; }","content":"Плохой (Breaking) message GetUserRequestV2 { // [!code --] Новый тип запроса string id = 1; bool include_profile = 2; }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::10","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message UserUpdateRequest { // [!code --] Новый тип запроса string id = 1; UserProfile profile = 2; } ```","content":"Плохой (Breaking) message UserUpdateRequest { // [!code --] Новый тип запроса string id = 1; UserProfile profile = 2; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::11","title":"RPC_SAME_REQUEST_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Смена типа из другого пакета:** ```proto // Before import \"common/user.proto\";","content":"Дополнительные примеры **Смена типа из другого пакета:** ```proto // Before import \"common/user.proto\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::12","title":"RPC_SAME_REQUEST_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры service UserService { rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"Дополнительные примеры service UserService { rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::13","title":"RPC_SAME_REQUEST_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - BREAKING CHANGE! import \"v2/user.proto\";","content":"Дополнительные примеры // After - BREAKING CHANGE! import \"v2/user.proto\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::14","title":"RPC_SAME_REQUEST_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры service UserService { rpc CreateUser(v2.CreateUserRequest) returns (CreateUserResponse); // Другой package } ```","content":"Дополнительные примеры service UserService { rpc CreateUser(v2.CreateUserRequest) returns (CreateUserResponse); // Другой package } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::15","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо изменения типа — версионируйте RPC:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо изменения типа — версионируйте RPC:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::16","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::17","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; // [!code focus] } rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse); // [!code focus] ","content":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; // [!code focus] } rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse); // [!code focus] // Новый метод rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) { option deprecated = true; // [!code focus] } rpc UpdateUserV2(UserUpdateRequest) returns (UpdateUserResponse); // [!code focus] // Новый метод }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::18","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) // Старые сообщения — для обратной совместимости message GetUserRequest { string user_id = 1; }","content":"Хороший (Безопасный) // Старые сообщения — для обратной совместимости message GetUserRequest { string user_id = 1; }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::19","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) // Новая версия сообщения message GetUserRequestV2 { // [!code focus] string id = 1; // [!code focus] bool include_profile = 2; // [!code focus] } // [!code focus] ```","content":"Хороший (Безопасный) // Новая версия сообщения message GetUserRequestV2 { // [!code focus] string id = 1; // [!code focus] bool include_profile = 2; // [!code focus] } // [!code focus] ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::20","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или создайте новую версию сервиса (package v2):** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или создайте новую версию сервиса (package v2):** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::21","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v2; // [!code focus]","content":"Хороший (Безопасный) package myapi.v2; // [!code focus]"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::22","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus] }","content":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus] }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::23","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message GetUserRequest { // [!code focus] string id = 1; // [!code focus] bool include_profile = 2; // [!code focus] } // [!code focus] ```","content":"Хороший (Безопасный) message GetUserRequest { // [!code focus] string id = 1; // [!code focus] bool include_profile = 2; // [!code focus] } // [!code focus] ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::24","title":"RPC_SAME_REQUEST_TYPE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Старые запросы клиентов не десериализуются новым сервером **Generated Code:** Сигнатуры методов в stubs меняются — компиляция клиентов падает **gRPC Calls:** Требуется использовать другую структу","content":"Влияние **Wire Format:** Старые запросы клиентов не десериализуются новым сервером **Generated Code:** Сигнатуры методов в stubs меняются — компиляция клиентов падает **gRPC Calls:** Требуется использовать другую структуру запроса **Runtime Errors:** Несоответствие типов вызывает ошибки выполнения"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::25","title":"RPC_SAME_REQUEST_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается:** ```go // Before client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", })","content":"Реальный пример **Код клиента ломается:** ```go // Before client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", })"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::26","title":"RPC_SAME_REQUEST_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Реальный пример"],"excerpt":"Реальный пример // After (тип запроса изменён) client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ // ERROR: тип не найден UserId: \"user123\", // ERROR: поле не найдено })","content":"Реальный пример // After (тип запроса изменён) client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ // ERROR: тип не найден UserId: \"user123\", // ERROR: поле не найдено })"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::27","title":"RPC_SAME_REQUEST_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Реальный пример"],"excerpt":"Реальный пример // Новый корректный вызов: resp, err := client.GetUser(ctx, &myapi.GetUserRequestV2{ Id: \"user123\", IncludeProfile: true, }) ```","content":"Реальный пример // Новый корректный вызов: resp, err := client.GetUser(ctx, &myapi.GetUserRequestV2{ Id: \"user123\", IncludeProfile: true, }) ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::28","title":"RPC_SAME_REQUEST_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Реальный пример"],"excerpt":"Реальный пример **Серверная реализация ломается:** ```go // Before func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { userID := req.UserId // ... }","content":"Реальный пример **Серверная реализация ломается:** ```go // Before func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { userID := req.UserId // ... }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::29","title":"RPC_SAME_REQUEST_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Реальный пример"],"excerpt":"Реальный пример // After func (s *server) GetUser(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) { userID := req.Id include := req.IncludeProfile // ... новая логика } ```","content":"Реальный пример // After func (s *server) GetUser(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) { userID := req.Id include := req.IncludeProfile // ... новая логика } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::30","title":"RPC_SAME_REQUEST_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Добавьте новый RPC с новым типом запроса:**","content":"Стратегия миграции **Добавьте новый RPC с новым типом запроса:**"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::31","title":"RPC_SAME_REQUEST_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Поддерживайте оба метода на сервере:** ```go func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { return s.getUserInternal(req.UserId, false) }","content":"Стратегия миграции **Поддерживайте оба метода на сервере:** ```go func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { return s.getUserInternal(req.UserId, false) }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::32","title":"RPC_SAME_REQUEST_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции func (s *server) GetUserV2(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) { return s.getUserInternal(req.Id, req.IncludeProfile) } ```","content":"Стратегия миграции func (s *server) GetUserV2(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) { return s.getUserInternal(req.Id, req.IncludeProfile) } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::33","title":"RPC_SAME_REQUEST_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Мигрируйте клиентов на V2:**","content":"Стратегия миграции **Мигрируйте клиентов на V2:**"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::34","title":"RPC_SAME_REQUEST_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Удалите старый метод в следующей major‑версии:**","content":"Стратегия миграции **Удалите старый метод в следующей major‑версии:**"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::35","title":"RPC_SAME_REQUEST_TYPE","section":"Добавление обязательных полей","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Добавление обязательных полей"],"excerpt":"Добавление обязательных полей ```proto // ПЛОХО: меняем существующий запрос message GetUserRequest { string user_id = 1; bool include_deleted = 2; // BREAKING }","content":"Добавление обязательных полей ```proto // ПЛОХО: меняем существующий запрос message GetUserRequest { string user_id = 1; bool include_deleted = 2; // BREAKING }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::36","title":"RPC_SAME_REQUEST_TYPE","section":"Добавление обязательных полей","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Добавление обязательных полей"],"excerpt":"Добавление обязательных полей // Хорошо: новая версия message GetUserRequestV2 { string user_id = 1; bool include_deleted = 2; } ```","content":"Добавление обязательных полей // Хорошо: новая версия message GetUserRequestV2 { string user_id = 1; bool include_deleted = 2; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::37","title":"RPC_SAME_REQUEST_TYPE","section":"Реструктуризация данных запроса","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Реструктуризация данных запроса"],"excerpt":"Реструктуризация данных запроса ```proto // ПЛОХО: меняем структуру прямо message UpdateUserRequest { UserProfile profile = 1; // BREAKING }","content":"Реструктуризация данных запроса ```proto // ПЛОХО: меняем структуру прямо message UpdateUserRequest { UserProfile profile = 1; // BREAKING }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::38","title":"RPC_SAME_REQUEST_TYPE","section":"Реструктуризация данных запроса","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Реструктуризация данных запроса"],"excerpt":"Реструктуризация данных запроса // Хорошо: версионирование rpc UpdateUser(UpdateUserRequest) returns (...) { option deprecated = true; } rpc UpdateUserV2(UpdateUserRequestV2) returns (...); ```","content":"Реструктуризация данных запроса // Хорошо: версионирование rpc UpdateUser(UpdateUserRequest) returns (...) { option deprecated = true; } rpc UpdateUserV2(UpdateUserRequestV2) returns (...); ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::39","title":"RPC_SAME_REQUEST_TYPE","section":"Миграция пакета","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Миграция пакета"],"excerpt":"Миграция пакета ```proto // ПЛОХО: заменяем тип на пакет v2 прямо import \"v2/messages.proto\"; // BREAKING","content":"Миграция пакета ```proto // ПЛОХО: заменяем тип на пакет v2 прямо import \"v2/messages.proto\"; // BREAKING"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::40","title":"RPC_SAME_REQUEST_TYPE","section":"Миграция пакета","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Миграция пакета"],"excerpt":"Миграция пакета // Хорошо: добавляем новый RPC rpc OldMethod(v1.Request) returns (...) { option deprecated = true; } rpc NewMethod(v2.Request) returns (...); ```","content":"Миграция пакета // Хорошо: добавляем новый RPC rpc OldMethod(v1.Request) returns (...) { option deprecated = true; } rpc NewMethod(v2.Request) returns (...); ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::0","title":"RPC_SAME_RESPONSE_TYPE","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":[],"excerpt":"Это правило проверяет, что RPC‑методы сохраняют тот же тип ответного сообщения (response message type). Изменение типа ответа RPC ломает совместимость по wire‑формату и сгенерированный код: клиенты ожидают конкретную стр","content":"Это правило проверяет, что RPC‑методы сохраняют тот же тип ответного сообщения (response message type). Изменение типа ответа RPC ломает совместимость по wire‑формату и сгенерированный код: клиенты ожидают конкретную структуру при получении ответа."},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::1","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::2","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::3","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); }","content":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::4","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message GetUserResponse { string user_id = 1; string name = 2; string email = 3; }","content":"Плохой (Breaking) message GetUserResponse { string user_id = 1; string name = 2; string email = 3; }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::5","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message UpdateUserResponse { bool success = 1; string message = 2; } ```","content":"Плохой (Breaking) message UpdateUserResponse { bool success = 1; string message = 2; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::6","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::7","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::8","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponseV2); // [!code --] Изменён тип ответа rpc UpdateUser(UpdateUserRequest) returns (UserUpdateResponse); // [!code --] Изменён тип ","content":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponseV2); // [!code --] Изменён тип ответа rpc UpdateUser(UpdateUserRequest) returns (UserUpdateResponse); // [!code --] Изменён тип ответа }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::9","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message GetUserResponseV2 { // [!code --] Другой тип сообщения string id = 1; UserProfile profile = 2; repeated string permissions = 3; }","content":"Плохой (Breaking) message GetUserResponseV2 { // [!code --] Другой тип сообщения string id = 1; UserProfile profile = 2; repeated string permissions = 3; }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::10","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message UserUpdateResponse { // [!code --] Другой тип сообщения UpdateResult result = 1; UserProfile updated_profile = 2; } ```","content":"Плохой (Breaking) message UserUpdateResponse { // [!code --] Другой тип сообщения UpdateResult result = 1; UserProfile updated_profile = 2; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::11","title":"RPC_SAME_RESPONSE_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Смена типа из другого пакета:** ```proto // Before import \"common/responses.proto\";","content":"Дополнительные примеры **Смена типа из другого пакета:** ```proto // Before import \"common/responses.proto\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::12","title":"RPC_SAME_RESPONSE_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры service UserService { rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"Дополнительные примеры service UserService { rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::13","title":"RPC_SAME_RESPONSE_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - BREAKING CHANGE! import \"v2/responses.proto\";","content":"Дополнительные примеры // After - BREAKING CHANGE! import \"v2/responses.proto\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::14","title":"RPC_SAME_RESPONSE_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры service UserService { rpc CreateUser(CreateUserRequest) returns (v2.CreateUserResponse); // Другой package } ```","content":"Дополнительные примеры service UserService { rpc CreateUser(CreateUserRequest) returns (v2.CreateUserResponse); // Другой package } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::15","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо изменения типа — версионируйте RPC:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо изменения типа — версионируйте RPC:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::16","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::17","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; // [!code focus] } rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2); // [!code focus] ","content":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; // [!code focus] } rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2); // [!code focus] // Новый метод rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) { option deprecated = true; // [!code focus] } rpc UpdateUserV2(UpdateUserRequest) returns (UserUpdateResponse); // [!code focus] // Новый метод }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::18","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) // Старые сообщения сохраняем для обратной совместимости message GetUserResponse { string user_id = 1; string name = 2; string email = 3; }","content":"Хороший (Безопасный) // Старые сообщения сохраняем для обратной совместимости message GetUserResponse { string user_id = 1; string name = 2; string email = 3; }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::19","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) // Новая расширенная версия message GetUserResponseV2 { // [!code focus] string id = 1; // [!code focus] UserProfile profile = 2; // [!code focus] repeated string permissions = 3; // [!code focus] } ","content":"Хороший (Безопасный) // Новая расширенная версия message GetUserResponseV2 { // [!code focus] string id = 1; // [!code focus] UserProfile profile = 2; // [!code focus] repeated string permissions = 3; // [!code focus] } // [!code focus] ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::20","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или создайте новую версию сервиса (package v2):** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или создайте новую версию сервиса (package v2):** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::21","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v2; // [!code focus]","content":"Хороший (Безопасный) package myapi.v2; // [!code focus]"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::22","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus] }","content":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus] }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::23","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message GetUserResponse { // [!code focus] string id = 1; // [!code focus] UserProfile profile = 2; // [!code focus] repeated string permissions = 3; // [!code focus] } // [!code focus] ```","content":"Хороший (Безопасный) message GetUserResponse { // [!code focus] string id = 1; // [!code focus] UserProfile profile = 2; // [!code focus] repeated string permissions = 3; // [!code focus] } // [!code focus] ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::24","title":"RPC_SAME_RESPONSE_TYPE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Ответы сервера не десериализуются у старых клиентов **Generated Code:** Сигнатуры ожидают старый тип — компиляция падает **gRPC Calls:** Меняются типы в сгенерированных stub'ах **Runtime Errors:*","content":"Влияние **Wire Format:** Ответы сервера не десериализуются у старых клиентов **Generated Code:** Сигнатуры ожидают старый тип — компиляция падает **gRPC Calls:** Меняются типы в сгенерированных stub'ах **Runtime Errors:** Несоответствие типов ломает обработку ответа"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::25","title":"RPC_SAME_RESPONSE_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается:** ```go // Before client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", }) if err != nil { return err }","content":"Реальный пример **Код клиента ломается:** ```go // Before client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", }) if err != nil { return err }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::26","title":"RPC_SAME_RESPONSE_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реальный пример"],"excerpt":"Реальный пример userID := resp.UserId name := resp.Name","content":"Реальный пример userID := resp.UserId name := resp.Name"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::27","title":"RPC_SAME_RESPONSE_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реальный пример"],"excerpt":"Реальный пример // After (тип ответа изменён) client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", }) if err != nil { return err }","content":"Реальный пример // After (тип ответа изменён) client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", }) if err != nil { return err }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::28","title":"RPC_SAME_RESPONSE_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реальный пример"],"excerpt":"Реальный пример // Ошибки компиляции: userID := resp.UserId // ERROR name := resp.Name // ERROR","content":"Реальный пример // Ошибки компиляции: userID := resp.UserId // ERROR name := resp.Name // ERROR"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::29","title":"RPC_SAME_RESPONSE_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реальный пример"],"excerpt":"Реальный пример // Новый способ: userID := resp.Id profile := resp.Profile permissions := resp.Permissions ```","content":"Реальный пример // Новый способ: userID := resp.Id profile := resp.Profile permissions := resp.Permissions ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::30","title":"RPC_SAME_RESPONSE_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реальный пример"],"excerpt":"Реальный пример **Имплементация сервера также должна быть переписана:** ```go // Before func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { return &GetUserResponse{ UserId: \"use","content":"Реальный пример **Имплементация сервера также должна быть переписана:** ```go // Before func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { return &GetUserResponse{ UserId: \"user123\", Name: \"John Doe\", Email: \"john@example.com\", }, nil }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::31","title":"RPC_SAME_RESPONSE_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реальный пример"],"excerpt":"Реальный пример // After func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) { return &GetUserResponseV2{ Id: \"user123\", Profile: &UserProfile{ Name: \"John Doe\", Email: \"john@ex","content":"Реальный пример // After func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) { return &GetUserResponseV2{ Id: \"user123\", Profile: &UserProfile{ Name: \"John Doe\", Email: \"john@example.com\", }, Permissions: []string{\"read\"}, }, nil } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::32","title":"RPC_SAME_RESPONSE_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Добавьте новый RPC c новым типом ответа:**","content":"Стратегия миграции **Добавьте новый RPC c новым типом ответа:**"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::33","title":"RPC_SAME_RESPONSE_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Поддерживайте оба на сервере:** ```go func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { user := s.getUserInternal(req.UserId) return &GetUserResponse{ Use","content":"Стратегия миграции **Поддерживайте оба на сервере:** ```go func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { user := s.getUserInternal(req.UserId) return &GetUserResponse{ UserId: user.ID, Name: user.Name, Email: user.Email, }, nil }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::34","title":"RPC_SAME_RESPONSE_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции func (s *server) GetUserV2(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) { user := s.getUserInternal(req.UserId) return &GetUserResponseV2{ Id: user.ID, Profile: &UserProfile{ N","content":"Стратегия миграции func (s *server) GetUserV2(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) { user := s.getUserInternal(req.UserId) return &GetUserResponseV2{ Id: user.ID, Profile: &UserProfile{ Name: user.Name, Email: user.Email, }, Permissions: user.Permissions, }, nil } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::35","title":"RPC_SAME_RESPONSE_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Мигрируйте клиентов на новый RPC:**","content":"Стратегия миграции **Мигрируйте клиентов на новый RPC:**"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::36","title":"RPC_SAME_RESPONSE_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Удалите старый RPC** в следующей major‑версии:","content":"Стратегия миграции **Удалите старый RPC** в следующей major‑версии:"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::37","title":"RPC_SAME_RESPONSE_TYPE","section":"Добавление новых обязательных полей","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Добавление новых обязательных полей"],"excerpt":"Добавление новых обязательных полей ```proto // ПЛОХО: меняем существующий тип message GetUserResponse { string user_id = 1; string name = 2; UserProfile profile = 3; // BREAKING }","content":"Добавление новых обязательных полей ```proto // ПЛОХО: меняем существующий тип message GetUserResponse { string user_id = 1; string name = 2; UserProfile profile = 3; // BREAKING }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::38","title":"RPC_SAME_RESPONSE_TYPE","section":"Добавление новых обязательных полей","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Добавление новых обязательных полей"],"excerpt":"Добавление новых обязательных полей // Хорошо: новая версия message GetUserResponseV2 { string user_id = 1; string name = 2; UserProfile profile = 3; } ```","content":"Добавление новых обязательных полей // Хорошо: новая версия message GetUserResponseV2 { string user_id = 1; string name = 2; UserProfile profile = 3; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::39","title":"RPC_SAME_RESPONSE_TYPE","section":"Реструктуризация ответа","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реструктуризация ответа"],"excerpt":"Реструктуризация ответа ```proto // ПЛОХО: меняем структуру прямо message UpdateUserResponse { UserDetails details = 1; // BREAKING }","content":"Реструктуризация ответа ```proto // ПЛОХО: меняем структуру прямо message UpdateUserResponse { UserDetails details = 1; // BREAKING }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::40","title":"RPC_SAME_RESPONSE_TYPE","section":"Реструктуризация ответа","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реструктуризация ответа"],"excerpt":"Реструктуризация ответа // Хорошо: версионирование rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) { option deprecated = true; } rpc UpdateUserV2(UpdateUserRequest) returns (UpdateUserResponseV2); ```","content":"Реструктуризация ответа // Хорошо: версионирование rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) { option deprecated = true; } rpc UpdateUserV2(UpdateUserRequest) returns (UpdateUserResponseV2); ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::41","title":"RPC_SAME_RESPONSE_TYPE","section":"Изменение формата ошибок","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Изменение формата ошибок"],"excerpt":"Изменение формата ошибок ```proto // ПЛОХО: меняем формат напрямую message CreateUserResponse { ErrorDetails error = 1; // BREAKING }","content":"Изменение формата ошибок ```proto // ПЛОХО: меняем формат напрямую message CreateUserResponse { ErrorDetails error = 1; // BREAKING }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::42","title":"RPC_SAME_RESPONSE_TYPE","section":"Изменение формата ошибок","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Изменение формата ошибок"],"excerpt":"Изменение формата ошибок // Хорошо: новая версия rpc CreateUser(CreateUserRequest) returns (CreateUserResponse) { option deprecated = true; } rpc CreateUserV2(CreateUserRequest) returns (CreateUserResponseV2); ```","content":"Изменение формата ошибок // Хорошо: новая версия rpc CreateUser(CreateUserRequest) returns (CreateUserResponse) { option deprecated = true; } rpc CreateUserV2(CreateUserRequest) returns (CreateUserResponseV2); ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::43","title":"RPC_SAME_RESPONSE_TYPE","section":"Миграция формата","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Миграция формата"],"excerpt":"Миграция формата ```proto // ПЛОХО: перевод простой структуры в сложную message GetUserResponse { UserData data = 1; // BREAKING }","content":"Миграция формата ```proto // ПЛОХО: перевод простой структуры в сложную message GetUserResponse { UserData data = 1; // BREAKING }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::44","title":"RPC_SAME_RESPONSE_TYPE","section":"Миграция формата","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Миграция формата"],"excerpt":"Миграция формата // Хорошо: предоставляем обе версии rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; } rpc GetUserDetailed(GetUserRequest) returns (GetUserDetailedResponse); ```","content":"Миграция формата // Хорошо: предоставляем обе версии rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; } rpc GetUserDetailed(GetUserRequest) returns (GetUserDetailedResponse); ```"},{"id":"cli/breaking-changes/rules/service-no-delete::top::0","title":"SERVICE_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":[],"excerpt":"Данное правило проверяет, что ни один service не был удалён из proto‑файлов. Удаление service ломает сгенерированный код и клиентские приложения, которые на него опираются.","content":"Данное правило проверяет, что ни один service не был удалён из proto‑файлов. Удаление service ломает сгенерированный код и клиентские приложения, которые на него опираются."},{"id":"cli/breaking-changes/rules/service-no-delete::breaking::1","title":"SERVICE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/service-no-delete::breaking::2","title":"SERVICE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/service-no-delete::breaking::3","title":"SERVICE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/service-no-delete::breaking::4","title":"SERVICE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service OrderService { // [!code --] rpc GetOrder(GetOrderRequest) returns (GetOrderResponse); // [!code --] } // [!code --] ```","content":"Плохой (Breaking) service OrderService { // [!code --] rpc GetOrder(GetOrderRequest) returns (GetOrderResponse); // [!code --] } // [!code --] ```"},{"id":"cli/breaking-changes/rules/service-no-delete::breaking::5","title":"SERVICE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/service-no-delete::breaking::6","title":"SERVICE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/service-no-delete::breaking::7","title":"SERVICE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/service-no-delete::breaking::8","title":"SERVICE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) // OrderService удалён — BREAKING CHANGE! ```","content":"Плохой (Breaking) // OrderService удалён — BREAKING CHANGE! ```"},{"id":"cli/breaking-changes/rules/service-no-delete::top::9","title":"SERVICE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления — отметьте service как deprecated:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления — отметьте service как deprecated:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/service-no-delete::top::10","title":"SERVICE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/service-no-delete::top::11","title":"SERVICE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/service-no-delete::top::12","title":"SERVICE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) service OrderService { option deprecated = true; // [!code focus] rpc GetOrder(GetOrderRequest) returns (GetOrderResponse) { option deprecated = true; // [!code focus] } } ```","content":"Хороший (Безопасный) service OrderService { option deprecated = true; // [!code focus] rpc GetOrder(GetOrderRequest) returns (GetOrderResponse) { option deprecated = true; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/service-no-delete::top::13","title":"SERVICE_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":["Влияние"],"excerpt":"Влияние **Generated Code:** Классы / интерфейсы сервиса исчезают — клиенты не компилируются **Client Applications:** Существующие вызовы к удалённому сервису падают на этапе сборки **Runtime:** gRPC клиенты теряют опреде","content":"Влияние **Generated Code:** Классы / интерфейсы сервиса исчезают — клиенты не компилируются **Client Applications:** Существующие вызовы к удалённому сервису падают на этапе сборки **Runtime:** gRPC клиенты теряют определение метода/сервиса"},{"id":"cli/breaking-changes/rules/service-no-delete::top::14","title":"SERVICE_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Сначала деприкация:**","content":"Стратегия миграции **Сначала деприкация:**"},{"id":"cli/breaking-changes/rules/service-no-delete::top::15","title":"SERVICE_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Уведомите клиентов** о сроках вывода из эксплуатации","content":"Стратегия миграции **Уведомите клиентов** о сроках вывода из эксплуатации"},{"id":"cli/breaking-changes/rules/service-no-delete::top::16","title":"SERVICE_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Удалите после периода миграции** в следующей major‑версии","content":"Стратегия миграции **Удалите после периода миграции** в следующей major‑версии"},{"id":"cli/configuration/configuration::top::0","title":"EasyP Configuration Reference","path":"/docs/guide/cli/configuration/configuration","headings":[],"excerpt":"EasyP can be configured through CLI flags, environment variables, and configuration files. This guide covers all configuration options available in EasyP.","content":"EasyP can be configured through CLI flags, environment variables, and configuration files. This guide covers all configuration options available in EasyP."},{"id":"cli/configuration/configuration::global-flags::1","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags Available for all commands:","content":"Global Flags Available for all commands:"},{"id":"cli/configuration/configuration::global-flags::2","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --cfg -c EASYP_CFG Configuration file path easyp.yaml --config EASYP_CFG Alias for --cfg easyp.yaml --debug -d ","content":"Global Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --cfg -c EASYP_CFG Configuration file path easyp.yaml --config EASYP_CFG Alias for --cfg easyp.yaml --debug -d EASYP_DEBUG Enable debug mode false --format -f EASYP_FORMAT Формат вывода для команд с поддержкой нескольких форматов (text/json) значение по умолчанию зависит от команды"},{"id":"cli/configuration/configuration::global-flags::3","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags **Examples:** ```bash Use custom config file easyp --cfg production.easyp.yaml lint","content":"Global Flags **Examples:** ```bash Use custom config file easyp --cfg production.easyp.yaml lint"},{"id":"cli/configuration/configuration::global-flags::4","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags Enable debug logging easyp --debug lint","content":"Global Flags Enable debug logging easyp --debug lint"},{"id":"cli/configuration/configuration::global-flags::5","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags Short form easyp -c custom.yaml -d lint ```","content":"Global Flags Short form easyp -c custom.yaml -d lint ```"},{"id":"cli/configuration/configuration::command-specific-flags::6","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Lint command:**","content":"Command-Specific Flags **Lint command:**"},{"id":"cli/configuration/configuration::command-specific-flags::7","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --path -p Directory path to lint . --root -r Базовая директория для поиска файлов Текущая рабочая дир","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --path -p Directory path to lint . --root -r Базовая директория для поиска файлов Текущая рабочая директория --format -f EASYP_FORMAT Использует глобальный флаг формата (text/json) Использует глобальное значение по умолчанию"},{"id":"cli/configuration/configuration::command-specific-flags::8","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Lint specific directory easyp lint --path proto/","content":"Command-Specific Flags **Examples:** ```bash Lint specific directory easyp lint --path proto/"},{"id":"cli/configuration/configuration::command-specific-flags::9","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Lint из поддиректории с правильным разрешением импортов easyp lint --root src/IPC/Contracts --path .","content":"Command-Specific Flags Lint из поддиректории с правильным разрешением импортов easyp lint --root src/IPC/Contracts --path ."},{"id":"cli/configuration/configuration::command-specific-flags::10","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags JSON output format easyp --format json lint # глобальный флаг","content":"Command-Specific Flags JSON output format easyp --format json lint # глобальный флаг"},{"id":"cli/configuration/configuration::command-specific-flags::11","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Combined flags easyp -f json lint -p proto/ ```","content":"Command-Specific Flags Combined flags easyp -f json lint -p proto/ ```"},{"id":"cli/configuration/configuration::command-specific-flags::12","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Generate command:**","content":"Command-Specific Flags **Generate command:**"},{"id":"cli/configuration/configuration::command-specific-flags::13","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --path -p EASYP_ROOT_GENERATE_PATH Путь к директории с proto файлами для генерации . --root -r Базова","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --path -p EASYP_ROOT_GENERATE_PATH Путь к директории с proto файлами для генерации . --root -r Базовая директория для поиска файлов Текущая рабочая директория"},{"id":"cli/configuration/configuration::command-specific-flags::14","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Generate from specific path easyp generate --path api/","content":"Command-Specific Flags **Examples:** ```bash Generate from specific path easyp generate --path api/"},{"id":"cli/configuration/configuration::command-specific-flags::15","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Generate из поддиректории с правильным разрешением импортов easyp generate --root src/IPC/Contracts --path .","content":"Command-Specific Flags Generate из поддиректории с правильным разрешением импортов easyp generate --root src/IPC/Contracts --path ."},{"id":"cli/configuration/configuration::command-specific-flags::16","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Using environment variable EASYP_ROOT_GENERATE_PATH=proto/ easyp generate ```","content":"Command-Specific Flags Using environment variable EASYP_ROOT_GENERATE_PATH=proto/ easyp generate ```"},{"id":"cli/configuration/configuration::command-specific-flags::17","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Breaking command:**","content":"Command-Specific Flags **Breaking command:**"},{"id":"cli/configuration/configuration::command-specific-flags::18","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --against Git ref to compare against master --path -p Directory path to check . --format -f EASYP_FOR","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --against Git ref to compare against master --path -p Directory path to check . --format -f EASYP_FORMAT Использует глобальный флаг формата (text/json) Использует глобальное значение по умолчанию"},{"id":"cli/configuration/configuration::command-specific-flags::19","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Check against main branch easyp breaking --against main","content":"Command-Specific Flags **Examples:** ```bash Check against main branch easyp breaking --against main"},{"id":"cli/configuration/configuration::command-specific-flags::20","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Check specific directory against develop branch easyp breaking --against develop --path proto/","content":"Command-Specific Flags Check specific directory against develop branch easyp breaking --against develop --path proto/"},{"id":"cli/configuration/configuration::command-specific-flags::21","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags JSON output easyp --format json breaking --against main # глобальный флаг ```","content":"Command-Specific Flags JSON output easyp --format json breaking --against main # глобальный флаг ```"},{"id":"cli/configuration/configuration::command-specific-flags::22","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Init command:**","content":"Command-Specific Flags **Init command:**"},{"id":"cli/configuration/configuration::command-specific-flags::23","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --dir -d EASYP_INIT_DIR Directory to initialize .","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --dir -d EASYP_INIT_DIR Directory to initialize ."},{"id":"cli/configuration/configuration::command-specific-flags::24","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Initialize current directory easyp init","content":"Command-Specific Flags **Examples:** ```bash Initialize current directory easyp init"},{"id":"cli/configuration/configuration::command-specific-flags::25","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Initialize specific directory easyp init --dir proto-project/ ```","content":"Command-Specific Flags Initialize specific directory easyp init --dir proto-project/ ```"},{"id":"cli/configuration/configuration::command-specific-flags::26","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags easyp init работает интерактивно: Если в корне целевой директории есть buf.yml/buf.yaml, команда предложит миграцию из Buf. Если easyp.yaml уже существует, команда запросит подтверждение на перезап","content":"Command-Specific Flags easyp init работает интерактивно: Если в корне целевой директории есть buf.yml/buf.yaml, команда предложит миграцию из Buf. Если easyp.yaml уже существует, команда запросит подтверждение на перезапись."},{"id":"cli/configuration/configuration::command-specific-flags::27","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Validate-config command:**","content":"Command-Specific Flags **Validate-config command:**"},{"id":"cli/configuration/configuration::command-specific-flags::28","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --config -c EASYP_CFG Путь до файла конфигурации easyp.yaml --format (global) -f EASYP_FORMAT Глобаль","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --config -c EASYP_CFG Путь до файла конфигурации easyp.yaml --format (global) -f EASYP_FORMAT Глобальный формат вывода для команд с несколькими форматами (json или text) зависит от команды (json для validate-config)"},{"id":"cli/configuration/configuration::command-specific-flags::29","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Проверить конфиг по умолчанию с JSON выводом (статус 0 если ошибок нет) easyp validate-config","content":"Command-Specific Flags **Examples:** ```bash Проверить конфиг по умолчанию с JSON выводом (статус 0 если ошибок нет) easyp validate-config"},{"id":"cli/configuration/configuration::command-specific-flags::30","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Проверить другой файл и вывести в текстовом формате (глобальный --format) easyp --format text validate-config --config example.easyp.yaml ```","content":"Command-Specific Flags Проверить другой файл и вывести в текстовом формате (глобальный --format) easyp --format text validate-config --config example.easyp.yaml ```"},{"id":"cli/configuration/configuration::command-specific-flags::31","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Package management commands:**","content":"Command-Specific Flags **Package management commands:**"},{"id":"cli/configuration/configuration::easyp-mod-download::32","title":"EasyP Configuration Reference","section":"easyp mod download","path":"/docs/guide/cli/configuration/configuration#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download Downloads dependencies based on lock file priority:","content":"easyp mod download Downloads dependencies based on lock file priority:"},{"id":"cli/configuration/configuration::easyp-mod-download::33","title":"EasyP Configuration Reference","section":"easyp mod download","path":"/docs/guide/cli/configuration/configuration#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download **If easyp.lock exists** - downloads exact versions from lock file **If easyp.lock is missing** - downloads versions from easyp.yaml and creates easyp.lock","content":"easyp mod download **If easyp.lock exists** - downloads exact versions from lock file **If easyp.lock is missing** - downloads versions from easyp.yaml and creates easyp.lock"},{"id":"cli/configuration/configuration::easyp-mod-update::34","title":"EasyP Configuration Reference","section":"easyp mod update","path":"/docs/guide/cli/configuration/configuration#easyp-mod-update","headings":["easyp mod update"],"excerpt":"easyp mod update Always downloads dependencies from easyp.yaml, ignoring existing lock file:","content":"easyp mod update Always downloads dependencies from easyp.yaml, ignoring existing lock file:"},{"id":"cli/configuration/configuration::easyp-mod-update::35","title":"EasyP Configuration Reference","section":"easyp mod update","path":"/docs/guide/cli/configuration/configuration#easyp-mod-update","headings":["easyp mod update"],"excerpt":"easyp mod update **Ignores easyp.lock** completely **Downloads versions from easyp.yaml** **Creates/updates easyp.lock** with new versions","content":"easyp mod update **Ignores easyp.lock** completely **Downloads versions from easyp.yaml** **Creates/updates easyp.lock** with new versions"},{"id":"cli/configuration/configuration::easyp-mod-vendor::36","title":"EasyP Configuration Reference","section":"easyp mod vendor","path":"/docs/guide/cli/configuration/configuration#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor Copies proto files from dependencies to local vendor/ directory (similar to go mod vendor).","content":"easyp mod vendor Copies proto files from dependencies to local vendor/ directory (similar to go mod vendor)."},{"id":"cli/configuration/configuration::easyp-mod-vendor::37","title":"EasyP Configuration Reference","section":"easyp mod vendor","path":"/docs/guide/cli/configuration/configuration#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor No additional flags. Uses global --cfg flag for configuration.","content":"easyp mod vendor No additional flags. Uses global --cfg flag for configuration."},{"id":"cli/configuration/configuration::environment-variables::38","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables EasyP supports environment variables for configuration:","content":"Environment Variables EasyP supports environment variables for configuration:"},{"id":"cli/configuration/configuration::environment-variables::39","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables Variable Description Default ---------- ------------- --------- EASYP_CFG Path to configuration file easyp.yaml EASYP_DEBUG Enable debug logging false EASYPPATH Cache and modules storage directory $","content":"Environment Variables Variable Description Default ---------- ------------- --------- EASYP_CFG Path to configuration file easyp.yaml EASYP_DEBUG Enable debug logging false EASYPPATH Cache and modules storage directory $HOME/.easyp EASYP_FORMAT Формат вывода для поддерживаемых команд (text/json). Если не указан, каждая команда использует своё значение по умолчанию. значение по умолчанию зависит от команды EASYP_ROOT_GENERATE_PATH Root path for generate command . EASYP_INIT_DIR Directory for init command ."},{"id":"cli/configuration/configuration::environment-variables::40","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables **Examples:** ```bash Custom cache directory export EASYPPATH=/tmp/easyp-cache easyp mod download","content":"Environment Variables **Examples:** ```bash Custom cache directory export EASYPPATH=/tmp/easyp-cache easyp mod download"},{"id":"cli/configuration/configuration::environment-variables::41","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables Debug mode via environment export EASYP_DEBUG=true easyp lint","content":"Environment Variables Debug mode via environment export EASYP_DEBUG=true easyp lint"},{"id":"cli/configuration/configuration::environment-variables::42","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables Custom config file export EASYP_CFG=config/easyp.yaml easyp generate ```","content":"Environment Variables Custom config file export EASYP_CFG=config/easyp.yaml easyp generate ```"},{"id":"cli/configuration/configuration::configuration-file::43","title":"EasyP Configuration Reference","section":"Configuration File","path":"/docs/guide/cli/configuration/configuration#configuration-file","headings":["Configuration File"],"excerpt":"Configuration File The easyp.yaml file is the main configuration file for EasyP, defining how your proto files are linted, generated, and managed. This file is typically placed at the root of your project alongside your ","content":"Configuration File The easyp.yaml file is the main configuration file for EasyP, defining how your proto files are linted, generated, and managed. This file is typically placed at the root of your project alongside your proto files."},{"id":"cli/configuration/configuration::configuration-format::44","title":"EasyP Configuration Reference","section":"Configuration Format","path":"/docs/guide/cli/configuration/configuration#configuration-format","headings":["Configuration Format"],"excerpt":"Configuration Format EasyP supports both YAML and JSON configuration formats:","content":"Configuration Format EasyP supports both YAML and JSON configuration formats:"},{"id":"cli/configuration/configuration::top::45","title":"EasyP Configuration Reference","section":"Переменные окружения в конфигурации","path":"/docs/guide/cli/configuration/configuration","headings":["Переменные окружения в конфигурации"],"excerpt":"Переменные окружения в конфигурации EasyP поддерживает расширение переменных окружения непосредственно в файле конфигурации easyp.yaml. Это позволяет использовать переменные окружения для динамических значений конфигурац","content":"Переменные окружения в конфигурации EasyP поддерживает расширение переменных окружения непосредственно в файле конфигурации easyp.yaml. Это позволяет использовать переменные окружения для динамических значений конфигурации."},{"id":"cli/configuration/configuration::top::46","title":"EasyP Configuration Reference","section":"Переменные окружения в конфигурации","path":"/docs/guide/cli/configuration/configuration","headings":["Переменные окружения в конфигурации"],"excerpt":"Переменные окружения в конфигурации **Пример со всеми поддерживаемыми возможностями:** ```yaml deps: # Базовое расширение: ${VAR} - расширяется в значение переменной VAR - ${GOOGLEAPIS_REPO}@${GOOGLEAPIS_VERSION} # Значе","content":"Переменные окружения в конфигурации **Пример со всеми поддерживаемыми возможностями:** ```yaml deps: # Базовое расширение: ${VAR} - расширяется в значение переменной VAR - ${GOOGLEAPIS_REPO}@${GOOGLEAPIS_VERSION} # Значение по умолчанию: ${VAR:-default} - использует default, если VAR не установлена или пустая - ${GNOSTIC_REPO:-github.com/google/gnostic}@${GNOSTIC_VERSION:-v0.7.0}"},{"id":"cli/configuration/configuration::top::47","title":"EasyP Configuration Reference","section":"Переменные окружения в конфигурации","path":"/docs/guide/cli/configuration/configuration","headings":["Переменные окружения в конфигурации"],"excerpt":"Переменные окружения в конфигурации generate: inputs: # Значение по умолчанию, если INPUT_DIR не установлена - directory: ${INPUT_DIR:-proto} plugins: - name: go # Базовое расширение out: ${OUTPUT_DIR} opts: # Значение п","content":"Переменные окружения в конфигурации generate: inputs: # Значение по умолчанию, если INPUT_DIR не установлена - directory: ${INPUT_DIR:-proto} plugins: - name: go # Базовое расширение out: ${OUTPUT_DIR} opts: # Значение по умолчанию module: ${MODULE_NAME:-github.com/example/project} timeout: ${TIMEOUT:-30} # Экранирование: $$ становится буквальным $, $${VAR} становится буквальным ${VAR} path: \"${BASE_DIR}/$${TEMP}/file\" # Результат: \"/tmp/${TEMP}/file\" (если BASE_DIR=/tmp) literal: \"$$\" # Результат: \"$\" ```"},{"id":"cli/configuration/configuration::top::48","title":"EasyP Configuration Reference","section":"Переменные окружения в конфигурации","path":"/docs/guide/cli/configuration/configuration","headings":["Переменные окружения в конфигурации"],"excerpt":"Переменные окружения в конфигурации **Поддерживаемый синтаксис:** ${VAR} - расширяется в значение переменной VAR ${VAR:-default} - использует default, если VAR не установлена или пустая ${VAR:=default} - использует defau","content":"Переменные окружения в конфигурации **Поддерживаемый синтаксис:** ${VAR} - расширяется в значение переменной VAR ${VAR:-default} - использует default, если VAR не установлена или пустая ${VAR:=default} - использует default, если VAR не установлена или пустая ${VAR-default} - использует default, если VAR не установлена (пустая строка сохраняется) $${VAR} или $$VAR - экранирует в буквальную строку ${VAR} или $VAR $$ - экранирует в буквальный символ $"},{"id":"cli/configuration/configuration::top::49","title":"EasyP Configuration Reference","section":"Переменные окружения в конфигурации","path":"/docs/guide/cli/configuration/configuration","headings":["Переменные окружения в конфигурации"],"excerpt":"Переменные окружения в конфигурации **Примечание:** Переменные окружения расширяются до парсинга YAML, поэтому любой паттерн ${STRING} будет обработан. Используйте $$ для экранирования символов доллара, когда нужны буква","content":"Переменные окружения в конфигурации **Примечание:** Переменные окружения расширяются до парсинга YAML, поэтому любой паттерн ${STRING} будет обработан. Используйте $$ для экранирования символов доллара, когда нужны буквальные значения."},{"id":"cli/configuration/configuration::version::50","title":"EasyP Configuration Reference","section":"version","path":"/docs/guide/cli/configuration/configuration#version","headings":["version"],"excerpt":"version **Опционально (legacy-совместимость).** Поле поддерживается для обратной совместимости и может быть опущено в новых конфигурациях.","content":"version **Опционально (legacy-совместимость).** Поле поддерживается для обратной совместимости и может быть опущено в новых конфигурациях."},{"id":"cli/configuration/configuration::version::51","title":"EasyP Configuration Reference","section":"version","path":"/docs/guide/cli/configuration/configuration#version","headings":["version"],"excerpt":"version **Type:** string **Default:** не задано **Рекомендация:** если сохраняете поле, используйте v1alpha","content":"version **Type:** string **Default:** не задано **Рекомендация:** если сохраняете поле, используйте v1alpha"},{"id":"cli/configuration/configuration::version::52","title":"EasyP Configuration Reference","section":"version","path":"/docs/guide/cli/configuration/configuration#version","headings":["version"],"excerpt":"version На поведение рантайма это поле не влияет.","content":"version На поведение рантайма это поле не влияет."},{"id":"cli/configuration/configuration::lint::53","title":"EasyP Configuration Reference","section":"lint","path":"/docs/guide/cli/configuration/configuration#lint","headings":["lint"],"excerpt":"lint **Optional.** Configures proto file linting rules and behavior.","content":"lint **Optional.** Configures proto file linting rules and behavior."},{"id":"cli/configuration/configuration::lint::54","title":"EasyP Configuration Reference","section":"lint","path":"/docs/guide/cli/configuration/configuration#lint","headings":["lint"],"excerpt":"lint **Type:** object **Default:** Empty (no linting rules applied)","content":"lint **Type:** object **Default:** Empty (no linting rules applied)"},{"id":"cli/configuration/configuration::lintuse::55","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **Optional.** Specifies which linter rules or rule categories to apply.","content":"lint.use **Optional.** Specifies which linter rules or rule categories to apply."},{"id":"cli/configuration/configuration::lintuse::56","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **Type:** []string **Default:** [] (no rules)","content":"lint.use **Type:** []string **Default:** [] (no rules)"},{"id":"cli/configuration/configuration::lintuse::57","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **Available categories:** MINIMAL - Essential package consistency checks BASIC - Naming conventions and common patterns DEFAULT - Additional recommended rules COMMENTS - Comment requirements UNARY_RPC - Streamin","content":"lint.use **Available categories:** MINIMAL - Essential package consistency checks BASIC - Naming conventions and common patterns DEFAULT - Additional recommended rules COMMENTS - Comment requirements UNARY_RPC - Streaming RPC restrictions"},{"id":"cli/configuration/configuration::lintuse::58","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **Individual rules:** Any specific rule name (e.g., ENUM_PASCAL_CASE, FIELD_LOWER_SNAKE_CASE)","content":"lint.use **Individual rules:** Any specific rule name (e.g., ENUM_PASCAL_CASE, FIELD_LOWER_SNAKE_CASE)"},{"id":"cli/configuration/configuration::lintuse::59","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **MINIMAL:** DIRECTORY_SAME_PACKAGE PACKAGE_DEFINED PACKAGE_DIRECTORY_MATCH PACKAGE_SAME_DIRECTORY","content":"lint.use **MINIMAL:** DIRECTORY_SAME_PACKAGE PACKAGE_DEFINED PACKAGE_DIRECTORY_MATCH PACKAGE_SAME_DIRECTORY"},{"id":"cli/configuration/configuration::lintuse::60","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **BASIC:** ENUM_FIRST_VALUE_ZERO ENUM_NO_ALLOW_ALIAS ENUM_PASCAL_CASE ENUM_VALUE_UPPER_SNAKE_CASE FIELD_LOWER_SNAKE_CASE IMPORT_NO_PUBLIC IMPORT_NO_WEAK IMPORT_USED MESSAGE_PASCAL_CASE ONEOF_LOWER_SNAKE_CASE PAC","content":"lint.use **BASIC:** ENUM_FIRST_VALUE_ZERO ENUM_NO_ALLOW_ALIAS ENUM_PASCAL_CASE ENUM_VALUE_UPPER_SNAKE_CASE FIELD_LOWER_SNAKE_CASE IMPORT_NO_PUBLIC IMPORT_NO_WEAK IMPORT_USED MESSAGE_PASCAL_CASE ONEOF_LOWER_SNAKE_CASE PACKAGE_LOWER_SNAKE_CASE PACKAGE_SAME_CSHARP_NAMESPACE PACKAGE_SAME_GO_PACKAGE PACKAGE_SAME_JAVA_MULTIPLE_FILES PACKAGE_SAME_JAVA_PACKAGE PACKAGE_SAME_PHP_NAMESPACE PACKAGE_SAME_RUBY_PACKAGE PACKAGE_SAME_SWIFT_PREFIX RPC_PASCAL_CASE SERVICE_PASCAL_CASE"},{"id":"cli/configuration/configuration::lintuse::61","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **DEFAULT:** ENUM_VALUE_PREFIX ENUM_ZERO_VALUE_SUFFIX FILE_LOWER_SNAKE_CASE RPC_REQUEST_RESPONSE_UNIQUE RPC_REQUEST_STANDARD_NAME RPC_RESPONSE_STANDARD_NAME PACKAGE_VERSION_SUFFIX SERVICE_SUFFIX","content":"lint.use **DEFAULT:** ENUM_VALUE_PREFIX ENUM_ZERO_VALUE_SUFFIX FILE_LOWER_SNAKE_CASE RPC_REQUEST_RESPONSE_UNIQUE RPC_REQUEST_STANDARD_NAME RPC_RESPONSE_STANDARD_NAME PACKAGE_VERSION_SUFFIX SERVICE_SUFFIX"},{"id":"cli/configuration/configuration::lintuse::62","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **COMMENTS:** COMMENT_ENUM COMMENT_ENUM_VALUE COMMENT_FIELD COMMENT_MESSAGE COMMENT_ONEOF COMMENT_RPC COMMENT_SERVICE","content":"lint.use **COMMENTS:** COMMENT_ENUM COMMENT_ENUM_VALUE COMMENT_FIELD COMMENT_MESSAGE COMMENT_ONEOF COMMENT_RPC COMMENT_SERVICE"},{"id":"cli/configuration/configuration::lintuse::63","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **UNARY_RPC:** RPC_NO_CLIENT_STREAMING RPC_NO_SERVER_STREAMING","content":"lint.use **UNARY_RPC:** RPC_NO_CLIENT_STREAMING RPC_NO_SERVER_STREAMING"},{"id":"cli/configuration/configuration::lintenum_zero_value_suffix::64","title":"EasyP Configuration Reference","section":"lint.enum_zero_value_suffix","path":"/docs/guide/cli/configuration/configuration#lintenum_zero_value_suffix","headings":["lint.enum_zero_value_suffix"],"excerpt":"lint.enum_zero_value_suffix **Optional.** Specifies the required suffix for enum zero values.","content":"lint.enum_zero_value_suffix **Optional.** Specifies the required suffix for enum zero values."},{"id":"cli/configuration/configuration::lintenum_zero_value_suffix::65","title":"EasyP Configuration Reference","section":"lint.enum_zero_value_suffix","path":"/docs/guide/cli/configuration/configuration#lintenum_zero_value_suffix","headings":["lint.enum_zero_value_suffix"],"excerpt":"lint.enum_zero_value_suffix **Type:** string **Default:** \"\" (no suffix required) **Common values:** \"UNSPECIFIED\", \"UNKNOWN\", \"DEFAULT\"","content":"lint.enum_zero_value_suffix **Type:** string **Default:** \"\" (no suffix required) **Common values:** \"UNSPECIFIED\", \"UNKNOWN\", \"DEFAULT\""},{"id":"cli/configuration/configuration::lintenum_zero_value_suffix::66","title":"EasyP Configuration Reference","section":"lint.enum_zero_value_suffix","path":"/docs/guide/cli/configuration/configuration#lintenum_zero_value_suffix","headings":["lint.enum_zero_value_suffix"],"excerpt":"lint.enum_zero_value_suffix This enforces enum zero values like:","content":"lint.enum_zero_value_suffix This enforces enum zero values like:"},{"id":"cli/configuration/configuration::lintservice_suffix::67","title":"EasyP Configuration Reference","section":"lint.service_suffix","path":"/docs/guide/cli/configuration/configuration#lintservice_suffix","headings":["lint.service_suffix"],"excerpt":"lint.service_suffix **Optional.** Specifies the required suffix for service names.","content":"lint.service_suffix **Optional.** Specifies the required suffix for service names."},{"id":"cli/configuration/configuration::lintservice_suffix::68","title":"EasyP Configuration Reference","section":"lint.service_suffix","path":"/docs/guide/cli/configuration/configuration#lintservice_suffix","headings":["lint.service_suffix"],"excerpt":"lint.service_suffix **Type:** string **Default:** \"\" (no suffix required) **Common values:** \"Service\", \"API\", \"Svc\"","content":"lint.service_suffix **Type:** string **Default:** \"\" (no suffix required) **Common values:** \"Service\", \"API\", \"Svc\""},{"id":"cli/configuration/configuration::lintservice_suffix::69","title":"EasyP Configuration Reference","section":"lint.service_suffix","path":"/docs/guide/cli/configuration/configuration#lintservice_suffix","headings":["lint.service_suffix"],"excerpt":"lint.service_suffix This enforces service names like:","content":"lint.service_suffix This enforces service names like:"},{"id":"cli/configuration/configuration::lintignore::70","title":"EasyP Configuration Reference","section":"lint.ignore","path":"/docs/guide/cli/configuration/configuration#lintignore","headings":["lint.ignore"],"excerpt":"lint.ignore **Optional.** Directories or files to exclude from all linting rules.","content":"lint.ignore **Optional.** Directories or files to exclude from all linting rules."},{"id":"cli/configuration/configuration::lintignore::71","title":"EasyP Configuration Reference","section":"lint.ignore","path":"/docs/guide/cli/configuration/configuration#lintignore","headings":["lint.ignore"],"excerpt":"lint.ignore **Type:** []string **Default:** []","content":"lint.ignore **Type:** []string **Default:** []"},{"id":"cli/configuration/configuration::lintignore::72","title":"EasyP Configuration Reference","section":"lint.ignore","path":"/docs/guide/cli/configuration/configuration#lintignore","headings":["lint.ignore"],"excerpt":"lint.ignore Paths are relative to the easyp.yaml file location. Supports glob patterns.","content":"lint.ignore Paths are relative to the easyp.yaml file location. Supports glob patterns."},{"id":"cli/configuration/configuration::lintexcept::73","title":"EasyP Configuration Reference","section":"lint.except","path":"/docs/guide/cli/configuration/configuration#lintexcept","headings":["lint.except"],"excerpt":"lint.except **Optional.** Disables specific rules globally across the entire project.","content":"lint.except **Optional.** Disables specific rules globally across the entire project."},{"id":"cli/configuration/configuration::lintexcept::74","title":"EasyP Configuration Reference","section":"lint.except","path":"/docs/guide/cli/configuration/configuration#lintexcept","headings":["lint.except"],"excerpt":"lint.except **Type:** []string **Default:** []","content":"lint.except **Type:** []string **Default:** []"},{"id":"cli/configuration/configuration::lintallow_comment_ignores::75","title":"EasyP Configuration Reference","section":"lint.allow_comment_ignores","path":"/docs/guide/cli/configuration/configuration#lintallow_comment_ignores","headings":["lint.allow_comment_ignores"],"excerpt":"lint.allow_comment_ignores **Optional.** Enables inline comment-based rule ignoring within proto files.","content":"lint.allow_comment_ignores **Optional.** Enables inline comment-based rule ignoring within proto files."},{"id":"cli/configuration/configuration::lintallow_comment_ignores::76","title":"EasyP Configuration Reference","section":"lint.allow_comment_ignores","path":"/docs/guide/cli/configuration/configuration#lintallow_comment_ignores","headings":["lint.allow_comment_ignores"],"excerpt":"lint.allow_comment_ignores **Type:** boolean **Default:** false","content":"lint.allow_comment_ignores **Type:** boolean **Default:** false"},{"id":"cli/configuration/configuration::lintallow_comment_ignores::77","title":"EasyP Configuration Reference","section":"lint.allow_comment_ignores","path":"/docs/guide/cli/configuration/configuration#lintallow_comment_ignores","headings":["lint.allow_comment_ignores"],"excerpt":"lint.allow_comment_ignores When enabled, allows comments like:","content":"lint.allow_comment_ignores When enabled, allows comments like:"},{"id":"cli/configuration/configuration::lintignore_only::78","title":"EasyP Configuration Reference","section":"lint.ignore_only","path":"/docs/guide/cli/configuration/configuration#lintignore_only","headings":["lint.ignore_only"],"excerpt":"lint.ignore_only **Optional.** Disables specific rules only for certain files or directories.","content":"lint.ignore_only **Optional.** Disables specific rules only for certain files or directories."},{"id":"cli/configuration/configuration::lintignore_only::79","title":"EasyP Configuration Reference","section":"lint.ignore_only","path":"/docs/guide/cli/configuration/configuration#lintignore_only","headings":["lint.ignore_only"],"excerpt":"lint.ignore_only **Type:** mapstringstring **Default:** {}","content":"lint.ignore_only **Type:** mapstringstring **Default:** {}"},{"id":"cli/configuration/configuration::lintignore_only::80","title":"EasyP Configuration Reference","section":"lint.ignore_only","path":"/docs/guide/cli/configuration/configuration#lintignore_only","headings":["lint.ignore_only"],"excerpt":"lint.ignore_only **Key:** Rule name or category **Value:** Array of file paths or directories","content":"lint.ignore_only **Key:** Rule name or category **Value:** Array of file paths or directories"},{"id":"cli/configuration/configuration::deps::81","title":"EasyP Configuration Reference","section":"deps","path":"/docs/guide/cli/configuration/configuration#deps","headings":["deps"],"excerpt":"deps **Optional.** Lists external proto dependencies to download and manage.","content":"deps **Optional.** Lists external proto dependencies to download and manage."},{"id":"cli/configuration/configuration::deps::82","title":"EasyP Configuration Reference","section":"deps","path":"/docs/guide/cli/configuration/configuration#deps","headings":["deps"],"excerpt":"deps **Type:** []string **Default:** []","content":"deps **Type:** []string **Default:** []"},{"id":"cli/configuration/configuration::dependency-format::83","title":"EasyP Configuration Reference","section":"Dependency Format","path":"/docs/guide/cli/configuration/configuration#dependency-format","headings":["Dependency Format"],"excerpt":"Dependency Format Dependencies follow the format: $GIT_LINK@$VERSION","content":"Dependency Format Dependencies follow the format: $GIT_LINK@$VERSION"},{"id":"cli/configuration/configuration::dependency-format::84","title":"EasyP Configuration Reference","section":"Dependency Format","path":"/docs/guide/cli/configuration/configuration#dependency-format","headings":["Dependency Format"],"excerpt":"Dependency Format **Components:** $GIT_LINK - Git repository URL (GitHub, GitLab, etc.) $VERSION - Git tag or full commit hash (optional)","content":"Dependency Format **Components:** $GIT_LINK - Git repository URL (GitHub, GitLab, etc.) $VERSION - Git tag or full commit hash (optional)"},{"id":"cli/configuration/configuration::dependency-format::85","title":"EasyP Configuration Reference","section":"Dependency Format","path":"/docs/guide/cli/configuration/configuration#dependency-format","headings":["Dependency Format"],"excerpt":"Dependency Format **Format variations:** owner/repo - Latest commit from default branch owner/repo@v1.0.0 - Specific git tag owner/repo@47b927cbb41c4fdea1292baf - Full commit hash github.com/owner/repo@version - Full URL","content":"Dependency Format **Format variations:** owner/repo - Latest commit from default branch owner/repo@v1.0.0 - Specific git tag owner/repo@47b927cbb41c4fdea1292baf - Full commit hash github.com/owner/repo@version - Full URL with version gitlab.com/group/repo@tag - GitLab repository"},{"id":"cli/configuration/configuration::dependency-format::86","title":"EasyP Configuration Reference","section":"Dependency Format","path":"/docs/guide/cli/configuration/configuration#dependency-format","headings":["Dependency Format"],"excerpt":"Dependency Format **Note:** If @$VERSION is omitted, EasyP downloads the latest commit from the repository's default branch.","content":"Dependency Format **Note:** If @$VERSION is omitted, EasyP downloads the latest commit from the repository's default branch."},{"id":"cli/configuration/configuration::generate::87","title":"EasyP Configuration Reference","section":"generate","path":"/docs/guide/cli/configuration/configuration#generate","headings":["generate"],"excerpt":"generate **Optional.** Configures code generation from proto files.","content":"generate **Optional.** Configures code generation from proto files."},{"id":"cli/configuration/configuration::generate::88","title":"EasyP Configuration Reference","section":"generate","path":"/docs/guide/cli/configuration/configuration#generate","headings":["generate"],"excerpt":"generate **Type:** object **Default:** {}","content":"generate **Type:** object **Default:** {}"},{"id":"cli/configuration/configuration::generateinputs::89","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs **Required when generate is set.** Specifies sources of proto files for generation.","content":"generate.inputs **Required when generate is set.** Specifies sources of proto files for generation."},{"id":"cli/configuration/configuration::generateinputs::90","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs **Type:** []object (minimum 1 item) **Default:** not set","content":"generate.inputs **Type:** []object (minimum 1 item) **Default:** not set"},{"id":"cli/configuration/configuration::generateinputs::91","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs ```yaml generate: inputs: # Local directory - directory: \"proto\"","content":"generate.inputs ```yaml generate: inputs: # Local directory - directory: \"proto\""},{"id":"cli/configuration/configuration::generateinputs::92","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs Local directory with advanced options - directory: path: \"api/proto\" root: \".\"","content":"generate.inputs Local directory with advanced options - directory: path: \"api/proto\" root: \".\""},{"id":"cli/configuration/configuration::generateinputs::93","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs Remote git repository - git_repo: url: \"github.com/acme/common@v1.0.0\" sub_directory: \"proto\" root: \".\" ```","content":"generate.inputs Remote git repository - git_repo: url: \"github.com/acme/common@v1.0.0\" sub_directory: \"proto\" root: \".\" ```"},{"id":"cli/configuration/configuration::generateinputs::94","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs **Directory input fields:** directory (string or object) - Local directory path directory.path (string) - Directory path directory.root (string) - Root path for import resolution (default: \".\")","content":"generate.inputs **Directory input fields:** directory (string or object) - Local directory path directory.path (string) - Directory path directory.root (string) - Root path for import resolution (default: \".\")"},{"id":"cli/configuration/configuration::generateinputs::95","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs **Git repository input fields:** git_repo.url (string) - Repository URL with optional version git_repo.sub_directory (string) - Subdirectory within the repository git_repo.root (string) - Root path used f","content":"generate.inputs **Git repository input fields:** git_repo.url (string) - Repository URL with optional version git_repo.sub_directory (string) - Subdirectory within the repository git_repo.root (string) - Root path used for import resolution"},{"id":"cli/configuration/configuration::generateplugins::96","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins **Required when generate is set.** Configures protoc plugins for code generation.","content":"generate.plugins **Required when generate is set.** Configures protoc plugins for code generation."},{"id":"cli/configuration/configuration::generateplugins::97","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins **Type:** []object (minimum 1 item) **Default:** not set","content":"generate.plugins **Type:** []object (minimum 1 item) **Default:** not set"},{"id":"cli/configuration/configuration::generateplugins::98","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins ```yaml generate: plugins: # Local plugin - name: go out: . opts: paths: source_relative","content":"generate.plugins ```yaml generate: plugins: # Local plugin - name: go out: . opts: paths: source_relative"},{"id":"cli/configuration/configuration::generateplugins::99","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins Remote plugin - remote: \"buf.build/bufbuild/protovalidate-go:v0.4.0\" out: gen/go opts: paths: source_relative","content":"generate.plugins Remote plugin - remote: \"buf.build/bufbuild/protovalidate-go:v0.4.0\" out: gen/go opts: paths: source_relative"},{"id":"cli/configuration/configuration::generateplugins::100","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins Plugin with import dependencies - name: grpc-gateway out: . with_imports: true opts: paths: source_relative ```","content":"generate.plugins Plugin with import dependencies - name: grpc-gateway out: . with_imports: true opts: paths: source_relative ```"},{"id":"cli/configuration/configuration::generateplugins::101","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins **Plugin fields:** name (string, optional) - Plugin name (omit protoc-gen- prefix) remote (string, optional) - Remote plugin URL for execution path (string, optional) - Path to plugin executable file com","content":"generate.plugins **Plugin fields:** name (string, optional) - Plugin name (omit protoc-gen- prefix) remote (string, optional) - Remote plugin URL for execution path (string, optional) - Path to plugin executable file command ([]string, optional) - Command to execute plugin out (string, optional) - Output directory for generated files; defaults to the resolved generate root opts (mapstring, optional) - Plugin-specific options; each key can be a single scalar value or an array of scalar values with_imports (boolean, optional) - Include imported dependencies"},{"id":"cli/configuration/configuration::generateplugins::102","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins Plugin source is one-of: exactly one of name, remote, path, or command must be set.","content":"generate.plugins Plugin source is one-of: exactly one of name, remote, path, or command must be set."},{"id":"cli/configuration/configuration::generateplugins::103","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins **Common plugin options:** ```yaml Go plugin options opts: paths: source_relative # Generate files relative to input module: github.com/acme/api # Go module path","content":"generate.plugins **Common plugin options:** ```yaml Go plugin options opts: paths: source_relative # Generate files relative to input module: github.com/acme/api # Go module path"},{"id":"cli/configuration/configuration::generateplugins::104","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins gRPC Gateway options opts: paths: source_relative grpc_api_configuration: api.yaml # gRPC API configuration","content":"generate.plugins gRPC Gateway options opts: paths: source_relative grpc_api_configuration: api.yaml # gRPC API configuration"},{"id":"cli/configuration/configuration::generateplugins::105","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins OpenAPI v2 options opts: simple_operation_ids: true # Use simple operation IDs generate_unbound_methods: false # Skip unbound methods","content":"generate.plugins OpenAPI v2 options opts: simple_operation_ids: true # Use simple operation IDs generate_unbound_methods: false # Skip unbound methods"},{"id":"cli/configuration/configuration::generateplugins::106","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins ts-proto options with repeated key values opts: env: node outputServices: - grpc-js - generic-definitions ```","content":"generate.plugins ts-proto options with repeated key values opts: env: node outputServices: - grpc-js - generic-definitions ```"},{"id":"cli/configuration/configuration::generateplugins::107","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins When an opts value is a list, EasyP serializes it as repeated plugin params, e.g. outputServices=grpc-js,outputServices=generic-definitions.","content":"generate.plugins When an opts value is a list, EasyP serializes it as repeated plugin params, e.g. outputServices=grpc-js,outputServices=generic-definitions."},{"id":"cli/configuration/configuration::breaking::108","title":"EasyP Configuration Reference","section":"breaking","path":"/docs/guide/cli/configuration/configuration#breaking","headings":["breaking"],"excerpt":"breaking **Optional.** Configures backward compatibility checking.","content":"breaking **Optional.** Configures backward compatibility checking."},{"id":"cli/configuration/configuration::breaking::109","title":"EasyP Configuration Reference","section":"breaking","path":"/docs/guide/cli/configuration/configuration#breaking","headings":["breaking"],"excerpt":"breaking **Type:** object **Default:** {}","content":"breaking **Type:** object **Default:** {}"},{"id":"cli/configuration/configuration::breakingignore::110","title":"EasyP Configuration Reference","section":"breaking.ignore","path":"/docs/guide/cli/configuration/configuration#breakingignore","headings":["breaking.ignore"],"excerpt":"breaking.ignore **Optional.** Directories or files to exclude from breaking change detection.","content":"breaking.ignore **Optional.** Directories or files to exclude from breaking change detection."},{"id":"cli/configuration/configuration::breakingignore::111","title":"EasyP Configuration Reference","section":"breaking.ignore","path":"/docs/guide/cli/configuration/configuration#breakingignore","headings":["breaking.ignore"],"excerpt":"breaking.ignore **Type:** []string **Default:** []","content":"breaking.ignore **Type:** []string **Default:** []"},{"id":"cli/configuration/configuration::breakingagainst_git_ref::112","title":"EasyP Configuration Reference","section":"breaking.against_git_ref","path":"/docs/guide/cli/configuration/configuration#breakingagainst_git_ref","headings":["breaking.against_git_ref"],"excerpt":"breaking.against_git_ref **Optional.** Git reference (branch, tag, or commit) to compare against for breaking changes.","content":"breaking.against_git_ref **Optional.** Git reference (branch, tag, or commit) to compare against for breaking changes."},{"id":"cli/configuration/configuration::breakingagainst_git_ref::113","title":"EasyP Configuration Reference","section":"breaking.against_git_ref","path":"/docs/guide/cli/configuration/configuration#breakingagainst_git_ref","headings":["breaking.against_git_ref"],"excerpt":"breaking.against_git_ref **Type:** string **Default:** \"\" (falls back to CLI --against default: master)","content":"breaking.against_git_ref **Type:** string **Default:** \"\" (falls back to CLI --against default: master)"},{"id":"cli/configuration/configuration::breakingagainst_git_ref::114","title":"EasyP Configuration Reference","section":"breaking.against_git_ref","path":"/docs/guide/cli/configuration/configuration#breakingagainst_git_ref","headings":["breaking.against_git_ref"],"excerpt":"breaking.against_git_ref Can be overridden by the --against CLI flag.","content":"breaking.against_git_ref Can be overridden by the --against CLI flag."},{"id":"cli/configuration/configuration::configuration-validation::115","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation EasyP validates configuration files on startup and provides helpful error messages:","content":"Configuration Validation EasyP validates configuration files on startup and provides helpful error messages:"},{"id":"cli/configuration/configuration::configuration-validation::116","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation ```bash Invalid rule name Error: invalid rule: INVALID_RULE_NAME","content":"Configuration Validation ```bash Invalid rule name Error: invalid rule: INVALID_RULE_NAME"},{"id":"cli/configuration/configuration::configuration-validation::117","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation Missing required field in generate section Error: required field \"plugins\" is missing (path: generate.plugins)","content":"Configuration Validation Missing required field in generate section Error: required field \"plugins\" is missing (path: generate.plugins)"},{"id":"cli/configuration/configuration::configuration-validation::118","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation Invalid dependency format Error: invalid dependency format: invalid-repo-url ```","content":"Configuration Validation Invalid dependency format Error: invalid dependency format: invalid-repo-url ```"},{"id":"cli/configuration/configuration::configuration-validation::119","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation Use easyp --debug for detailed validation information.","content":"Configuration Validation Use easyp --debug for detailed validation information."},{"id":"cli/configuration/configuration::migration-from-buf::120","title":"EasyP Configuration Reference","section":"Migration from Buf","path":"/docs/guide/cli/configuration/configuration#migration-from-buf","headings":["Migration from Buf"],"excerpt":"Migration from Buf EasyP is fully compatible with Buf configurations. To migrate:","content":"Migration from Buf EasyP is fully compatible with Buf configurations. To migrate:"},{"id":"cli/configuration/configuration::migration-from-buf::121","title":"EasyP Configuration Reference","section":"Migration from Buf","path":"/docs/guide/cli/configuration/configuration#migration-from-buf","headings":["Migration from Buf"],"excerpt":"Migration from Buf Place buf.yaml or buf.yml in the project root Run easyp init and confirm migration when prompted Update deps format if using BSR modules Review migrated lint/breaking settings and adjust as needed","content":"Migration from Buf Place buf.yaml or buf.yml in the project root Run easyp init and confirm migration when prompted Update deps format if using BSR modules Review migrated lint/breaking settings and adjust as needed"},{"id":"cli/configuration/configuration::migration-from-buf::122","title":"EasyP Configuration Reference","section":"Migration from Buf","path":"/docs/guide/cli/configuration/configuration#migration-from-buf","headings":["Migration from Buf"],"excerpt":"Migration from Buf Most Buf configurations work without changes in EasyP.","content":"Migration from Buf Most Buf configurations work without changes in EasyP."},{"id":"cli/generator/examples/go::top::0","title":"Go","section":"Установка плагинов","path":"/docs/guide/cli/generator/examples/go","headings":["Установка плагинов"],"excerpt":"Установка плагинов Сначала установите необходимые плагины для работы с gRPC:","content":"Установка плагинов Сначала установите необходимые плагины для работы с gRPC:"},{"id":"cli/generator/examples/go::top::1","title":"Go","section":"Установка плагинов","path":"/docs/guide/cli/generator/examples/go","headings":["Установка плагинов"],"excerpt":"Установка плагинов Эти команды установят плагины protoc-gen-go и protoc-gen-go-grpc для использования с EasyP.","content":"Установка плагинов Эти команды установят плагины protoc-gen-go и protoc-gen-go-grpc для использования с EasyP."},{"id":"cli/generator/examples/go::proto::2","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса Ниже пример proto-файла для сервиса Echo:","content":"Пример proto‑сервиса Ниже пример proto-файла для сервиса Echo:"},{"id":"cli/generator/examples/go::proto::3","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса ```proto syntax = \"proto3\";","content":"Пример proto‑сервиса ```proto syntax = \"proto3\";"},{"id":"cli/generator/examples/go::proto::4","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса package api.echo.v1;","content":"Пример proto‑сервиса package api.echo.v1;"},{"id":"cli/generator/examples/go::proto::5","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";","content":"Пример proto‑сервиса option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";"},{"id":"cli/generator/examples/go::proto::6","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); rpc EchoStream(EchoStreamRequest) returns (EchoResponse); }","content":"Пример proto‑сервиса service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); rpc EchoStream(EchoStreamRequest) returns (EchoResponse); }"},{"id":"cli/generator/examples/go::proto::7","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса message EchoRequest { string payload = 1; }","content":"Пример proto‑сервиса message EchoRequest { string payload = 1; }"},{"id":"cli/generator/examples/go::proto::8","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса message EchoResponse { string payload = 2; }","content":"Пример proto‑сервиса message EchoResponse { string payload = 2; }"},{"id":"cli/generator/examples/go::proto::9","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса message EchoStreamRequest { string payload = 1; }","content":"Пример proto‑сервиса message EchoStreamRequest { string payload = 1; }"},{"id":"cli/generator/examples/go::proto::10","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса message EchoStreamResponse { string payload = 2; } ```","content":"Пример proto‑сервиса message EchoStreamResponse { string payload = 2; } ```"},{"id":"cli/generator/examples/go::top::11","title":"Go","section":"Настройка конфигурации","path":"/docs/guide/cli/generator/examples/go","headings":["Настройка конфигурации"],"excerpt":"Настройка конфигурации Создайте и настройте файл конфигурации easyp.yaml:","content":"Настройка конфигурации Создайте и настройте файл конфигурации easyp.yaml:"},{"id":"cli/generator/examples/go::top::12","title":"Go","section":"Настройка конфигурации","path":"/docs/guide/cli/generator/examples/go","headings":["Настройка конфигурации"],"excerpt":"Настройка конфигурации Этот файл указывает использование двух плагинов: go для генерации Go-кода и go-grpc для генерации gRPC-кода, вместе с их опциями.","content":"Настройка конфигурации Этот файл указывает использование двух плагинов: go для генерации Go-кода и go-grpc для генерации gRPC-кода, вместе с их опциями."},{"id":"cli/generator/examples/go::top::13","title":"Go","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/go","headings":["Генерация кода"],"excerpt":"Генерация кода Чтобы сгенерировать код, выполните команду:","content":"Генерация кода Чтобы сгенерировать код, выполните команду:"},{"id":"cli/generator/examples/go::top::14","title":"Go","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/go","headings":["Генерация кода"],"excerpt":"Генерация кода Если флаг --cfg не указан, по умолчанию используется файл easyp.yaml в текущей директории:","content":"Генерация кода Если флаг --cfg не указан, по умолчанию используется файл easyp.yaml в текущей директории:"},{"id":"cli/generator/examples/go::top::15","title":"Go","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/go","headings":["Генерация кода"],"excerpt":"Генерация кода Теперь у вас есть сгенерированный Go‑код, с которым можно напрямую работать.","content":"Генерация кода Теперь у вас есть сгенерированный Go‑код, с которым можно напрямую работать."},{"id":"cli/generator/examples/grpc-gateway::top::0","title":"gRPC-Gateway","section":"Установка плагинов","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Установка плагинов"],"excerpt":"Установка плагинов В дополнение к плагинам для работы с gRPC, необходимо установить следующие плагины для gRPC-Gateway:","content":"Установка плагинов В дополнение к плагинам для работы с gRPC, необходимо установить следующие плагины для gRPC-Gateway:"},{"id":"cli/generator/examples/grpc-gateway::top::1","title":"gRPC-Gateway","section":"Установка плагинов","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Установка плагинов"],"excerpt":"Установка плагинов go install google.golang.org/protobuf/cmd/protoc-gen-go@latest go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2@","content":"Установка плагинов go install google.golang.org/protobuf/cmd/protoc-gen-go@latest go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2@latest go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest"},{"id":"cli/generator/examples/grpc-gateway::top::2","title":"gRPC-Gateway","section":"Установка плагинов","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Установка плагинов"],"excerpt":"Установка плагинов Эти команды установят плагины protoc-gen-go, protoc-gen-go-grpc, protoc-gen-openapiv2 и protoc-gen-grpc-gateway для использования с EasyP.","content":"Установка плагинов Эти команды установят плагины protoc-gen-go, protoc-gen-go-grpc, protoc-gen-openapiv2 и protoc-gen-grpc-gateway для использования с EasyP."},{"id":"cli/generator/examples/grpc-gateway::proto::3","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса Ниже — исходный proto‑файл для сервиса Echo:","content":"Пример Proto сервиса Ниже — исходный proto‑файл для сервиса Echo:"},{"id":"cli/generator/examples/grpc-gateway::proto::4","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса syntax = \"proto3\";","content":"Пример Proto сервиса syntax = \"proto3\";"},{"id":"cli/generator/examples/grpc-gateway::proto::5","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса package api.echo.v1;","content":"Пример Proto сервиса package api.echo.v1;"},{"id":"cli/generator/examples/grpc-gateway::proto::6","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";","content":"Пример Proto сервиса option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";"},{"id":"cli/generator/examples/grpc-gateway::proto::7","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); }","content":"Пример Proto сервиса service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); }"},{"id":"cli/generator/examples/grpc-gateway::proto::8","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса message EchoRequest { string payload = 1; }","content":"Пример Proto сервиса message EchoRequest { string payload = 1; }"},{"id":"cli/generator/examples/grpc-gateway::proto::9","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса message EchoResponse { string payload = 2; }","content":"Пример Proto сервиса message EchoResponse { string payload = 2; }"},{"id":"cli/generator/examples/grpc-gateway::proto::10","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса Чтобы использовать gRPC-Gateway, обновите proto‑файл, добавив HTTP‑опции:","content":"Пример Proto сервиса Чтобы использовать gRPC-Gateway, обновите proto‑файл, добавив HTTP‑опции:"},{"id":"cli/generator/examples/grpc-gateway::proto::11","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса syntax = \"proto3\"; import \"google/api/annotations.proto\";","content":"Пример Proto сервиса syntax = \"proto3\"; import \"google/api/annotations.proto\";"},{"id":"cli/generator/examples/grpc-gateway::proto::12","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса package api.echo.v1;","content":"Пример Proto сервиса package api.echo.v1;"},{"id":"cli/generator/examples/grpc-gateway::proto::13","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";","content":"Пример Proto сервиса option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";"},{"id":"cli/generator/examples/grpc-gateway::proto::14","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse) { option (google.api.http) = { // [!code ++] post: \"/api/v1/echo\" // [!code ++] body: \"*\" // [!code ++] }; // [!code ++] } }","content":"Пример Proto сервиса service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse) { option (google.api.http) = { // [!code ++] post: \"/api/v1/echo\" // [!code ++] body: \"*\" // [!code ++] }; // [!code ++] } }"},{"id":"cli/generator/examples/grpc-gateway::proto::15","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса message EchoRequest { string payload = 1; }","content":"Пример Proto сервиса message EchoRequest { string payload = 1; }"},{"id":"cli/generator/examples/grpc-gateway::proto::16","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса message EchoResponse { string payload = 2; }","content":"Пример Proto сервиса message EchoResponse { string payload = 2; }"},{"id":"cli/generator/examples/grpc-gateway::top::17","title":"gRPC-Gateway","section":"Настройка конфигурации","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Настройка конфигурации"],"excerpt":"Настройка конфигурации Обновите файл easyp.yaml, добавив необходимые зависимости и плагины: deps: # [!code ++] - github.com/googleapis/googleapis # [!code ++]","content":"Настройка конфигурации Обновите файл easyp.yaml, добавив необходимые зависимости и плагины: deps: # [!code ++] - github.com/googleapis/googleapis # [!code ++]"},{"id":"cli/generator/examples/grpc-gateway::top::18","title":"gRPC-Gateway","section":"Настройка конфигурации","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Настройка конфигурации"],"excerpt":"Настройка конфигурации generate: plugins: - name: go out: . opts: paths: source_relative - name: go-grpc out: . opts: paths: source_relative require_unimplemented_servers: false - name: grpc-gateway # [!code ++] out: . #","content":"Настройка конфигурации generate: plugins: - name: go out: . opts: paths: source_relative - name: go-grpc out: . opts: paths: source_relative require_unimplemented_servers: false - name: grpc-gateway # [!code ++] out: . # [!code ++] opts: # [!code ++] paths: source_relative # [!code ++] - name: openapiv2 # [!code ++] out: . # [!code ++] opts: # [!code ++] simple_operation_ids: false # [!code ++] generate_unbound_methods: false # [!code ++]"},{"id":"cli/generator/examples/grpc-gateway::top::19","title":"gRPC-Gateway","section":"Настройка конфигурации","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Настройка конфигурации"],"excerpt":"Настройка конфигурации Секция deps перечисляет зависимости, необходимые для импортов proto‑файлов. В данном случае добавляем github.com/googleapis/googleapis, поскольку там находится файл annotations.proto, используемый ","content":"Настройка конфигурации Секция deps перечисляет зависимости, необходимые для импортов proto‑файлов. В данном случае добавляем github.com/googleapis/googleapis, поскольку там находится файл annotations.proto, используемый в определении сервиса."},{"id":"cli/generator/examples/grpc-gateway::top::20","title":"gRPC-Gateway","section":"Обновление зависимостей","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Обновление зависимостей"],"excerpt":"Обновление зависимостей После обновления конфигурации выполните команду для загрузки указанных зависимостей:","content":"Обновление зависимостей После обновления конфигурации выполните команду для загрузки указанных зависимостей:"},{"id":"cli/generator/examples/grpc-gateway::top::21","title":"gRPC-Gateway","section":"Обновление зависимостей","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Обновление зависимостей"],"excerpt":"Обновление зависимостей easyp mod update","content":"Обновление зависимостей easyp mod update"},{"id":"cli/generator/examples/grpc-gateway::top::22","title":"gRPC-Gateway","section":"Обновление зависимостей","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Обновление зависимостей"],"excerpt":"Обновление зависимостей Больше деталей по управлению зависимостями см. в разделе Package Manager.","content":"Обновление зависимостей Больше деталей по управлению зависимостями см. в разделе Package Manager."},{"id":"cli/generator/examples/grpc-gateway::top::23","title":"gRPC-Gateway","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Генерация кода"],"excerpt":"Генерация кода Для генерации кода используйте:","content":"Генерация кода Для генерации кода используйте:"},{"id":"cli/generator/examples/grpc-gateway::top::24","title":"gRPC-Gateway","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Генерация кода"],"excerpt":"Генерация кода easyp --cfg easyp.yaml generate","content":"Генерация кода easyp --cfg easyp.yaml generate"},{"id":"cli/generator/examples/grpc-gateway::top::25","title":"gRPC-Gateway","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Генерация кода"],"excerpt":"Генерация кода Если флаг --cfg не указан, по умолчанию используется файл easyp.yaml из текущей директории:","content":"Генерация кода Если флаг --cfg не указан, по умолчанию используется файл easyp.yaml из текущей директории:"},{"id":"cli/generator/examples/grpc-gateway::top::26","title":"gRPC-Gateway","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Генерация кода"],"excerpt":"Генерация кода Теперь у вас сгенерированы Go‑код и код gRPC-Gateway, с которыми можно работать напрямую.","content":"Генерация кода Теперь у вас сгенерированы Go‑код и код gRPC-Gateway, с которыми можно работать напрямую."},{"id":"cli/generator/examples/validate::top::0","title":"Validate","section":"Установка плагинов","path":"/docs/guide/cli/generator/examples/validate","headings":["Установка плагинов"],"excerpt":"Установка плагинов Сначала установите необходимые плагины для работы с gRPC и проверок (validate):","content":"Установка плагинов Сначала установите необходимые плагины для работы с gRPC и проверок (validate):"},{"id":"cli/generator/examples/validate::top::1","title":"Validate","section":"Установка плагинов","path":"/docs/guide/cli/generator/examples/validate","headings":["Установка плагинов"],"excerpt":"Установка плагинов Эти команды установят плагины protoc-gen-go, protoc-gen-go-grpc и protoc-gen-validate для использования вместе с EasyP.","content":"Установка плагинов Эти команды установят плагины protoc-gen-go, protoc-gen-go-grpc и protoc-gen-validate для использования вместе с EasyP."},{"id":"cli/generator/examples/validate::proto::2","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса Ниже пример proto‑файла для сервиса Echo:","content":"Пример Proto сервиса Ниже пример proto‑файла для сервиса Echo:"},{"id":"cli/generator/examples/validate::proto::3","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса ```proto syntax = \"proto3\";","content":"Пример Proto сервиса ```proto syntax = \"proto3\";"},{"id":"cli/generator/examples/validate::proto::4","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса package api.echo.v1;","content":"Пример Proto сервиса package api.echo.v1;"},{"id":"cli/generator/examples/validate::proto::5","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса import \"validate/validate.proto\";","content":"Пример Proto сервиса import \"validate/validate.proto\";"},{"id":"cli/generator/examples/validate::proto::6","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";","content":"Пример Proto сервиса option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";"},{"id":"cli/generator/examples/validate::proto::7","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); rpc EchoStream(EchoStreamRequest) returns (EchoResponse); }","content":"Пример Proto сервиса service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); rpc EchoStream(EchoStreamRequest) returns (EchoResponse); }"},{"id":"cli/generator/examples/validate::proto::8","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса message EchoRequest { string payload = 1 [(validate.rules).string = {max_len: 200}]; }","content":"Пример Proto сервиса message EchoRequest { string payload = 1 [(validate.rules).string = {max_len: 200}]; }"},{"id":"cli/generator/examples/validate::proto::9","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса message EchoResponse { string payload = 2; }","content":"Пример Proto сервиса message EchoResponse { string payload = 2; }"},{"id":"cli/generator/examples/validate::proto::10","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса message EchoStreamRequest { string payload = 1 [(validate.rules).string = {max_len: 200}]; }","content":"Пример Proto сервиса message EchoStreamRequest { string payload = 1 [(validate.rules).string = {max_len: 200}]; }"},{"id":"cli/generator/examples/validate::proto::11","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса message EchoStreamResponse { string payload = 2; } ```","content":"Пример Proto сервиса message EchoStreamResponse { string payload = 2; } ```"},{"id":"cli/generator/examples/validate::top::12","title":"Validate","section":"Настройка конфигурации","path":"/docs/guide/cli/generator/examples/validate","headings":["Настройка конфигурации"],"excerpt":"Настройка конфигурации Создайте и настройте файл конфигурации easyp.yaml:","content":"Настройка конфигурации Создайте и настройте файл конфигурации easyp.yaml:"},{"id":"cli/generator/examples/validate::top::13","title":"Validate","section":"Настройка конфигурации","path":"/docs/guide/cli/generator/examples/validate","headings":["Настройка конфигурации"],"excerpt":"Настройка конфигурации ```yaml deps: # [!code ++] - github.com/bufbuild/protoc-gen-validate # [!code ++]","content":"Настройка конфигурации ```yaml deps: # [!code ++] - github.com/bufbuild/protoc-gen-validate # [!code ++]"},{"id":"cli/generator/examples/validate::top::14","title":"Validate","section":"Настройка конфигурации","path":"/docs/guide/cli/generator/examples/validate","headings":["Настройка конфигурации"],"excerpt":"Настройка конфигурации generate: plugins: - name: go out: . opts: paths: source_relative - name: go-grpc out: . opts: paths: source_relative require_unimplemented_servers: false - name: validate out: . opts: paths: sourc","content":"Настройка конфигурации generate: plugins: - name: go out: . opts: paths: source_relative - name: go-grpc out: . opts: paths: source_relative require_unimplemented_servers: false - name: validate out: . opts: paths: source_relative lang: \"go\" ```"},{"id":"cli/generator/examples/validate::top::15","title":"Validate","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/validate","headings":["Генерация кода"],"excerpt":"Генерация кода Чтобы сгенерировать код, выполните команду:","content":"Генерация кода Чтобы сгенерировать код, выполните команду:"},{"id":"cli/generator/examples/validate::top::16","title":"Validate","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/validate","headings":["Генерация кода"],"excerpt":"Генерация кода Если флаг --cfg не указан, по умолчанию используется файл easyp.yaml из текущего каталога:","content":"Генерация кода Если флаг --cfg не указан, по умолчанию используется файл easyp.yaml из текущего каталога:"},{"id":"cli/generator/examples/validate::top::17","title":"Validate","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/validate","headings":["Генерация кода"],"excerpt":"Генерация кода Теперь у вас есть сгенерированный Go‑код с поддержкой валидации, и вы можете напрямую использовать его в проекте.","content":"Генерация кода Теперь у вас есть сгенерированный Go‑код с поддержкой валидации, и вы можете напрямую использовать его в проекте."},{"id":"cli/generator/generator::top::0","title":"Генератор","path":"/docs/guide/cli/generator/generator","headings":[],"excerpt":"EasyP включает мощный генератор, который упрощает процесс получения кода из proto‑файлов. Благодаря YAML‑конфигурациям работа становится гораздо более удобной и интуитивной по сравнению с прямым использованием команды pr","content":"EasyP включает мощный генератор, который упрощает процесс получения кода из proto‑файлов. Благодаря YAML‑конфигурациям работа становится гораздо более удобной и интуитивной по сравнению с прямым использованием команды protoc."},{"id":"cli/generator/generator::top::1","title":"Генератор","section":"Ключевые особенности генератора","path":"/docs/guide/cli/generator/generator","headings":["Ключевые особенности генератора"],"excerpt":"Ключевые особенности генератора **Упрощённая генерация кода**: - Генерация кода из proto через декларативную YAML‑конфигурацию. - Избавляет от необходимости писать длинные и сложные команды protoc.","content":"Ключевые особенности генератора **Упрощённая генерация кода**: - Генерация кода из proto через декларативную YAML‑конфигурацию. - Избавляет от необходимости писать длинные и сложные команды protoc."},{"id":"cli/generator/generator::top::2","title":"Генератор","section":"Ключевые особенности генератора","path":"/docs/guide/cli/generator/generator","headings":["Ключевые особенности генератора"],"excerpt":"Ключевые особенности генератора **Обёртка над protoc**: - EasyP выступает как удобный слой над protoc, предоставляя декларативный API. - Поддерживает все опции и плагины, доступные protoc.","content":"Ключевые особенности генератора **Обёртка над protoc**: - EasyP выступает как удобный слой над protoc, предоставляя декларативный API. - Поддерживает все опции и плагины, доступные protoc."},{"id":"cli/generator/generator::top::3","title":"Генератор","section":"Ключевые особенности генератора","path":"/docs/guide/cli/generator/generator","headings":["Ключевые особенности генератора"],"excerpt":"Ключевые особенности генератора **Гибкость и кастомизация**: - Используются те же параметры, что и у плагинов protoc, прямо в конфиге. - Поддерживается множество плагинов и их параметры в одной конфигурации.","content":"Ключевые особенности генератора **Гибкость и кастомизация**: - Используются те же параметры, что и у плагинов protoc, прямо в конфиге. - Поддерживается множество плагинов и их параметры в одной конфигурации."},{"id":"cli/generator/generator::top::4","title":"Генератор","section":"Ключевые особенности генератора","path":"/docs/guide/cli/generator/generator","headings":["Ключевые особенности генератора"],"excerpt":"Ключевые особенности генератора **Генерация из нескольких источников**: - Локальные директории и удалённые Git‑репозитории одновременно. - Лёгкая интеграция с существующими проектами и репозиториями.","content":"Ключевые особенности генератора **Генерация из нескольких источников**: - Локальные директории и удалённые Git‑репозитории одновременно. - Лёгкая интеграция с существующими проектами и репозиториями."},{"id":"cli/generator/generator::top::5","title":"Генератор","section":"Ключевые особенности генератора","path":"/docs/guide/cli/generator/generator","headings":["Ключевые особенности генератора"],"excerpt":"Ключевые особенности генератора **Удалённая генерация**: - Генерация из удалённых Git репозиториев без локального checkout.","content":"Ключевые особенности генератора **Удалённая генерация**: - Генерация из удалённых Git репозиториев без локального checkout."},{"id":"cli/generator/generator::top::6","title":"Генератор","section":"Ключевые особенности генератора","path":"/docs/guide/cli/generator/generator","headings":["Ключевые особенности генератора"],"excerpt":"Ключевые особенности генератора **Интеграция с менеджером пакетов**: - Прозрачная работа с зависимостями через пакетный менеджер EasyP. - Автоматическое разрешение и подключение proto‑зависимостей.","content":"Ключевые особенности генератора **Интеграция с менеджером пакетов**: - Прозрачная работа с зависимостями через пакетный менеджер EasyP. - Автоматическое разрешение и подключение proto‑зависимостей."},{"id":"cli/generator/generator::complete-configuration-example::7","title":"Генератор","section":"Complete Configuration Example","path":"/docs/guide/cli/generator/generator#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example ```yaml Package manager dependencies deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 - github.com/bufbuild/protoc-gen-validate@","content":"Complete Configuration Example ```yaml Package manager dependencies deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 - github.com/bufbuild/protoc-gen-validate@v0.10.1"},{"id":"cli/generator/generator::complete-configuration-example::8","title":"Генератор","section":"Complete Configuration Example","path":"/docs/guide/cli/generator/generator#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example Code generation configuration generate: inputs: # Local directory input - directory: path: \"proto\" root: \".\" # Remote Git repository input - git_repo: url: \"github.com/acme/weather@v1.2.3\" ","content":"Complete Configuration Example Code generation configuration generate: inputs: # Local directory input - directory: path: \"proto\" root: \".\" # Remote Git repository input - git_repo: url: \"github.com/acme/weather@v1.2.3\" sub_directory: \"proto/api\" # Another remote repository - git_repo: url: \"https://github.com/company/internal-protos.git\" sub_directory: \"definitions\" plugins: # Local plugin execution - name: go out: ./gen/go opts: paths: source_relative module: github.com/mycompany/myproject with_imports: true # Local plugin with custom options - name: go-grpc out: ./gen/go opts: paths: source_relative require_unimplemented_servers: false"},{"id":"cli/generator/generator::complete-configuration-example::9","title":"Генератор","section":"Complete Configuration Example","path":"/docs/guide/cli/generator/generator#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example Managed mode - автоматическая установка file и field опций managed: enabled: true disable: - module: github.com/googleapis/googleapis # Отключить для конкретного модуля override: - file_opt","content":"Complete Configuration Example Managed mode - автоматическая установка file и field опций managed: enabled: true disable: - module: github.com/googleapis/googleapis # Отключить для конкретного модуля override: - file_option: go_package_prefix value: github.com/mycompany/myproject/gen/go - file_option: java_package_prefix value: com.mycompany - file_option: csharp_namespace_prefix value: MyCompany - field_option: jstype value: JS_STRING path: api/v1/ # Применить к конкретному пути"},{"id":"cli/generator/generator::complete-configuration-example::10","title":"Генератор","section":"Complete Configuration Example","path":"/docs/guide/cli/generator/generator#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example ```","content":"Complete Configuration Example ```"},{"id":"cli/generator/generator::local-directory-input::11","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) Локальная директория — самый распространённый и простой способ указать откуда брать proto для генерации. Используйте этот вариант, если файлы уже находятся в репозитории проекта.","content":"Локальный ввод (Local Directory Input) Локальная директория — самый распространённый и простой способ указать откуда брать proto для генерации. Используйте этот вариант, если файлы уже находятся в репозитории проекта."},{"id":"cli/generator/generator::local-directory-input::12","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) **Когда применять:** Proto файлы находятся в кодовой базе проекта Нужен полный контроль над структурой каталогов Проект — один сервис или приложение Файлы меняются не слишком часто","content":"Локальный ввод (Local Directory Input) **Когда применять:** Proto файлы находятся в кодовой базе проекта Нужен полный контроль над структурой каталогов Проект — один сервис или приложение Файлы меняются не слишком часто"},{"id":"cli/generator/generator::local-directory-input::13","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input)","content":"Локальный ввод (Local Directory Input)"},{"id":"cli/generator/generator::local-directory-input::14","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) Параметр root особенно полезен в монорепозиториях: он позволяет управлять тем, откуда будут резолвиться пути импортов. Если указать родительскую директорию, импорты будут оцениватьс","content":"Локальный ввод (Local Directory Input) Параметр root особенно полезен в монорепозиториях: он позволяет управлять тем, откуда будут резолвиться пути импортов. Если указать родительскую директорию, импорты будут оцениваться относительно неё, а не текущего рабочего каталога."},{"id":"cli/generator/generator::local-directory-input::15","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) **Параметры:**","content":"Локальный ввод (Local Directory Input) **Параметры:**"},{"id":"cli/generator/generator::local-directory-input::16","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) Параметр Тип Обязателен Значение по умолчанию Описание ---------- ----- ------------ ----------------------- ---------- path string ✅ - Каталог, содержащий proto файлы root string ❌","content":"Локальный ввод (Local Directory Input) Параметр Тип Обязателен Значение по умолчанию Описание ---------- ----- ------------ ----------------------- ---------- path string ✅ - Каталог, содержащий proto файлы root string ❌ \".\" Корневая директория для разрешения import путей"},{"id":"cli/generator/generator::local-directory-input::17","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) **Примеры:**","content":"Локальный ввод (Local Directory Input) **Примеры:**"},{"id":"cli/generator/generator::local-directory-input::18","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) Ниже показана разница между базовым указанием директории и расширенной конфигурацией с пользовательским корнем импортов:","content":"Локальный ввод (Local Directory Input) Ниже показана разница между базовым указанием директории и расширенной конфигурацией с пользовательским корнем импортов:"},{"id":"cli/generator/generator::local-directory-input::19","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) ```yaml Basic usage - Simple path specification inputs: - directory: \"api/proto\"","content":"Локальный ввод (Local Directory Input) ```yaml Basic usage - Simple path specification inputs: - directory: \"api/proto\""},{"id":"cli/generator/generator::local-directory-input::20","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) Advanced usage with custom root - Controls import path resolution inputs: - directory: path: \"services/auth/proto\" root: \"services/auth\" # Imports will be relative to this path ```","content":"Локальный ввод (Local Directory Input) Advanced usage with custom root - Controls import path resolution inputs: - directory: path: \"services/auth/proto\" root: \"services/auth\" # Imports will be relative to this path ```"},{"id":"cli/generator/generator::git-remote-git-repository-input::21","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) Этот тип входных данных позволяет генерировать код из proto‑файлов, находящихся в удалённых репозиториях, без локального checkout. Особенно полезно при использовани","content":"Удалённый Git репозиторий (Remote Git Repository Input) Этот тип входных данных позволяет генерировать код из proto‑файлов, находящихся в удалённых репозиториях, без локального checkout. Особенно полезно при использовании API других команд или внешних поставщиков."},{"id":"cli/generator/generator::git-remote-git-repository-input::22","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) **Когда использовать:** Потребление proto определений из других сервисов/команд Интеграция с внешними вендорскими API Работа с общими библиотеками proto в нескольки","content":"Удалённый Git репозиторий (Remote Git Repository Input) **Когда использовать:** Потребление proto определений из других сервисов/команд Интеграция с внешними вендорскими API Работа с общими библиотеками proto в нескольких проектах Необходимо гарантировать корректную (зафиксированную) версию внешних API"},{"id":"cli/generator/generator::git-remote-git-repository-input::23","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) **Рекомендации:** В продакшене всегда фиксируйте версии (@v1.0.0, а не latest) Используйте семантические версии при наличии — проще сопровождать Предпочитайте публи","content":"Удалённый Git репозиторий (Remote Git Repository Input) **Рекомендации:** В продакшене всегда фиксируйте версии (@v1.0.0, а не latest) Используйте семантические версии при наличии — проще сопровождать Предпочитайте публичные теги вместо хеша коммита (лучше отслеживаемость)"},{"id":"cli/generator/generator::git-remote-git-repository-input::24","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input)","content":"Удалённый Git репозиторий (Remote Git Repository Input)"},{"id":"cli/generator/generator::git-remote-git-repository-input::25","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) Параметр root задаёт корень для разрешения импортов файлов из этого репозитория.","content":"Удалённый Git репозиторий (Remote Git Repository Input) Параметр root задаёт корень для разрешения импортов файлов из этого репозитория."},{"id":"cli/generator/generator::git-remote-git-repository-input::26","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) **Параметры:**","content":"Удалённый Git репозиторий (Remote Git Repository Input) **Параметры:**"},{"id":"cli/generator/generator::git-remote-git-repository-input::27","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) Параметр Тип Обязателен По умолчанию Описание ---------- ----- ------------ -------------- ---------- url string ✅ - URL Git репозитория с необязательной версией / ","content":"Удалённый Git репозиторий (Remote Git Repository Input) Параметр Тип Обязателен По умолчанию Описание ---------- ----- ------------ -------------- ---------- url string ✅ - URL Git репозитория с необязательной версией / тегом / коммитом sub_directory string ❌ \"\" Поддиректория внутри репозитория, где лежат proto root string ❌ \"\" Корневой путь для разрешения импортов"},{"id":"cli/generator/generator::git-remote-git-repository-input::28","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) **Варианты формата URL:**","content":"Удалённый Git репозиторий (Remote Git Repository Input) **Варианты формата URL:**"},{"id":"cli/generator/generator::git-remote-git-repository-input::29","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) EasyP поддерживает несколько форматов для ссылки на удалённые репозитории. Каждый подходит под разные требования по стабильности:","content":"Удалённый Git репозиторий (Remote Git Repository Input) EasyP поддерживает несколько форматов для ссылки на удалённые репозитории. Каждый подходит под разные требования по стабильности:"},{"id":"cli/generator/generator::git-remote-git-repository-input::30","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) **Tagged versions** — для продакшена, стабильные неизменяемые ссылки **Semantic versions** — читаемость и управление зависимостями **Commit hashes** — доступ к конк","content":"Удалённый Git репозиторий (Remote Git Repository Input) **Tagged versions** — для продакшена, стабильные неизменяемые ссылки **Semantic versions** — читаемость и управление зависимостями **Commit hashes** — доступ к конкретному коммиту, если нет тега **Latest** — только для разработки, непредсказуемо **Full HTTPS URLs** — приватные репозитории или нестандартный хостинг"},{"id":"cli/generator/generator::git-remote-git-repository-input::31","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) ```yaml Тег — стабильно для продакшена url: \"github.com/googleapis/googleapis@common-protos-1_3_1\"","content":"Удалённый Git репозиторий (Remote Git Repository Input) ```yaml Тег — стабильно для продакшена url: \"github.com/googleapis/googleapis@common-protos-1_3_1\""},{"id":"cli/generator/generator::git-remote-git-repository-input::32","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) Семантическая версия url: \"github.com/grpc-ecosystem/grpc-gateway@v2.19.1\"","content":"Удалённый Git репозиторий (Remote Git Repository Input) Семантическая версия url: \"github.com/grpc-ecosystem/grpc-gateway@v2.19.1\""},{"id":"cli/generator/generator::git-remote-git-repository-input::33","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) Хеш коммита — точечный фикс url: \"github.com/company/protos@abc123def456\"","content":"Удалённый Git репозиторий (Remote Git Repository Input) Хеш коммита — точечный фикс url: \"github.com/company/protos@abc123def456\""},{"id":"cli/generator/generator::git-remote-git-repository-input::34","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) Latest — только dev, НЕ для продакшена url: \"github.com/company/protos\"","content":"Удалённый Git репозиторий (Remote Git Repository Input) Latest — только dev, НЕ для продакшена url: \"github.com/company/protos\""},{"id":"cli/generator/generator::git-remote-git-repository-input::35","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) Полный HTTPS URL — приватный или кастомный Git url: \"https://github.com/company/private-protos.git\" ```","content":"Удалённый Git репозиторий (Remote Git Repository Input) Полный HTTPS URL — приватный или кастомный Git url: \"https://github.com/company/private-protos.git\" ```"},{"id":"cli/generator/generator::git-remote-git-repository-input::36","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) **Примеры:**","content":"Удалённый Git репозиторий (Remote Git Repository Input) **Примеры:**"},{"id":"cli/generator/generator::git-remote-git-repository-input::37","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) Ниже паттерны использования удалённых источников в разных сценариях:","content":"Удалённый Git репозиторий (Remote Git Repository Input) Ниже паттерны использования удалённых источников в разных сценариях:"},{"id":"cli/generator/generator::git-remote-git-repository-input::38","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input)","content":"Удалённый Git репозиторий (Remote Git Repository Input)"},{"id":"cli/generator/generator::top::39","title":"Генератор","section":"Конфигурация плагинов","path":"/docs/guide/cli/generator/generator","headings":["Конфигурация плагинов"],"excerpt":"Конфигурация плагинов Конфигурация плагинов определяет какие генераторы кода будут запущены и как они себя ведут. EasyP поддерживает любой плагин protoc, что делает его крайне гибким для разных языковых экосистем и сцена","content":"Конфигурация плагинов Конфигурация плагинов определяет какие генераторы кода будут запущены и как они себя ведут. EasyP поддерживает любой плагин protoc, что делает его крайне гибким для разных языковых экосистем и сценариев."},{"id":"cli/generator/generator::top::40","title":"Генератор","section":"Конфигурация плагинов","path":"/docs/guide/cli/generator/generator","headings":["Конфигурация плагинов"],"excerpt":"Конфигурация плагинов На верхнем уровне есть **четыре способа указать, как именно запускать плагин**:","content":"Конфигурация плагинов На верхнем уровне есть **четыре способа указать, как именно запускать плагин**:"},{"id":"cli/generator/generator::top::41","title":"Генератор","section":"Конфигурация плагинов","path":"/docs/guide/cli/generator/generator","headings":["Конфигурация плагинов"],"excerpt":"Конфигурация плагинов **name** – запуск плагина по имени из PATH или использование встроенного плагина. **path** – запуск плагина по абсолютному/относительному пути к исполняемому файлу. **remote** – удалённый плагин по ","content":"Конфигурация плагинов **name** – запуск плагина по имени из PATH или использование встроенного плагина. **path** – запуск плагина по абсолютному/относительному пути к исполняемому файлу. **remote** – удалённый плагин по URL (через remote‑executor EasyP). **command** – запуск плагина через произвольную команду (например, go run ...)."},{"id":"cli/generator/generator::top::42","title":"Генератор","section":"Конфигурация плагинов","path":"/docs/guide/cli/generator/generator","headings":["Конфигурация плагинов"],"excerpt":"Конфигурация плагинов Для каждого плагина должен быть указан **ровно один** из параметров name, path, remote или command.","content":"Конфигурация плагинов Для каждого плагина должен быть указан **ровно один** из параметров name, path, remote или command."},{"id":"cli/generator/generator::name::43","title":"Генератор","section":"Плагин по имени (name)","path":"/docs/guide/cli/generator/generator#name","headings":["Плагин по имени (name)"],"excerpt":"Плагин по имени (name) Локальный режим по имени — стандартный: плагины установлены в системе и запускаются напрямую через EasyP.","content":"Плагин по имени (name) Локальный режим по имени — стандартный: плагины установлены в системе и запускаются напрямую через EasyP."},{"id":"cli/generator/generator::name::44","title":"Генератор","section":"Плагин по имени (name)","path":"/docs/guide/cli/generator/generator#name","headings":["Плагин по имени (name)"],"excerpt":"Плагин по имени (name) **Когда использовать name:** Стандартные языки (Go, Python, TypeScript и т.д.) Есть контроль над окружением сборки Критична производительность (нет сетевых задержек) Хочется опираться на PATH или в","content":"Плагин по имени (name) **Когда использовать name:** Стандартные языки (Go, Python, TypeScript и т.д.) Есть контроль над окружением сборки Критична производительность (нет сетевых задержек) Хочется опираться на PATH или встроенные плагины"},{"id":"cli/generator/generator::name::45","title":"Генератор","section":"Плагин по имени (name)","path":"/docs/guide/cli/generator/generator#name","headings":["Плагин по имени (name)"],"excerpt":"Плагин по имени (name) **Требования к установке:** Плагины установлены и доступны в PATH (если не используются встроенные). Имена следуют шаблону protoc-gen-{name}. Установка через менеджеры пакетов (go install, npm inst","content":"Плагин по имени (name) **Требования к установке:** Плагины установлены и доступны в PATH (если не используются встроенные). Имена следуют шаблону protoc-gen-{name}. Установка через менеджеры пакетов (go install, npm install, pip install и т.п.)."},{"id":"cli/generator/generator::name::46","title":"Генератор","section":"Плагин по имени (name)","path":"/docs/guide/cli/generator/generator#name","headings":["Плагин по имени (name)"],"excerpt":"Плагин по имени (name) Параметр with_imports критичен при использовании зависимостей из пакетного менеджера: установите true, чтобы прототипы из секции deps попали в генерацию.","content":"Плагин по имени (name) Параметр with_imports критичен при использовании зависимостей из пакетного менеджера: установите true, чтобы прототипы из секции deps попали в генерацию."},{"id":"cli/generator/generator::path::47","title":"Генератор","section":"Плагин по пути (path)","path":"/docs/guide/cli/generator/generator#path","headings":["Плагин по пути (path)"],"excerpt":"Плагин по пути (path) Иногда нужно запускать плагин из конкретного бинарника, не добавляя его в PATH (например, бинарь в репозитории или в build‑директории). В этом случае можно указать явный путь:","content":"Плагин по пути (path) Иногда нужно запускать плагин из конкретного бинарника, не добавляя его в PATH (например, бинарь в репозитории или в build‑директории). В этом случае можно указать явный путь:"},{"id":"cli/generator/generator::path::48","title":"Генератор","section":"Плагин по пути (path)","path":"/docs/guide/cli/generator/generator#path","headings":["Плагин по пути (path)"],"excerpt":"Плагин по пути (path) **Когда использовать path:** Бинарники плагинов хранятся в репозитории (для воспроизводимых сборок). Используются несколько версий одного и того же плагина параллельно. Не хочется «загрязнять» глоба","content":"Плагин по пути (path) **Когда использовать path:** Бинарники плагинов хранятся в репозитории (для воспроизводимых сборок). Используются несколько версий одного и того же плагина параллельно. Не хочется «загрязнять» глобальный PATH."},{"id":"cli/generator/generator::remote::49","title":"Генератор","section":"Удалённый плагин (remote)","path":"/docs/guide/cli/generator/generator#remote","headings":["Удалённый плагин (remote)"],"excerpt":"Удалённый плагин (remote) Удалённые плагины выполняются по URL. EasyP отправляет на удалённую сторону CodeGeneratorRequest и получает обратно CodeGeneratorResponse.","content":"Удалённый плагин (remote) Удалённые плагины выполняются по URL. EasyP отправляет на удалённую сторону CodeGeneratorRequest и получает обратно CodeGeneratorResponse."},{"id":"cli/generator/generator::remote::50","title":"Генератор","section":"Удалённый плагин (remote)","path":"/docs/guide/cli/generator/generator#remote","headings":["Удалённый плагин (remote)"],"excerpt":"Удалённый плагин (remote) Ниже приведён реальный пример использования EasyP API Service как удалённого исполнителя плагинов (тот же формат используется в разделе про API Service):","content":"Удалённый плагин (remote) Ниже приведён реальный пример использования EasyP API Service как удалённого исполнителя плагинов (тот же формат используется в разделе про API Service):"},{"id":"cli/generator/generator::remote::51","title":"Генератор","section":"Удалённый плагин (remote)","path":"/docs/guide/cli/generator/generator#remote","headings":["Удалённый плагин (remote)"],"excerpt":"Удалённый плагин (remote) ```yaml generate: plugins: # Удалённое выполнение плагинов через EasyP API Service - remote: api.easyp.tech/protobuf/go:v1.36.10 out: . opts: paths: source_relative","content":"Удалённый плагин (remote) ```yaml generate: plugins: # Удалённое выполнение плагинов через EasyP API Service - remote: api.easyp.tech/protobuf/go:v1.36.10 out: . opts: paths: source_relative"},{"id":"cli/generator/generator::remote::52","title":"Генератор","section":"Удалённый плагин (remote)","path":"/docs/guide/cli/generator/generator#remote","headings":["Удалённый плагин (remote)"],"excerpt":"Удалённый плагин (remote) remote: api.easyp.tech/grpc/go:v1.5.1 out: . opts: paths: source_relative ```","content":"Удалённый плагин (remote) remote: api.easyp.tech/grpc/go:v1.5.1 out: . opts: paths: source_relative ```"},{"id":"cli/generator/generator::remote::53","title":"Генератор","section":"Удалённый плагин (remote)","path":"/docs/guide/cli/generator/generator#remote","headings":["Удалённый плагин (remote)"],"excerpt":"Удалённый плагин (remote) **Типичные сценарии для remote:** Централизованный сервис плагинов внутри компании (например, EasyP API Service). Запуск тяжёлых плагинов на выделенных машинах вместо CI‑агентов. Совместное испо","content":"Удалённый плагин (remote) **Типичные сценарии для remote:** Централизованный сервис плагинов внутри компании (например, EasyP API Service). Запуск тяжёлых плагинов на выделенных машинах вместо CI‑агентов. Совместное использование одной реализации плагина разными командами."},{"id":"cli/generator/generator::command::54","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) Вы можете указать плагин как массив команд для выполнения. Это полезно для запуска плагинов через go run или любые другие инструменты без предварительной установки бинарника пла","content":"Выполнение плагина через команду (command) Вы можете указать плагин как массив команд для выполнения. Это полезно для запуска плагинов через go run или любые другие инструменты без предварительной установки бинарника плагина:"},{"id":"cli/generator/generator::command::55","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command)","content":"Выполнение плагина через команду (command)"},{"id":"cli/generator/generator::command::56","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) В этом режиме EasyP: **запускает указанную команду** как дочерний процесс; **пишет CodeGeneratorRequest в stdin** процесса; **читает CodeGeneratorResponse из stdout**, как и для","content":"Выполнение плагина через команду (command) В этом режиме EasyP: **запускает указанную команду** как дочерний процесс; **пишет CodeGeneratorRequest в stdin** процесса; **читает CodeGeneratorResponse из stdout**, как и для обычных плагинов protoc."},{"id":"cli/generator/generator::command::57","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) **Приоритет источников плагина:** command — выполнение через указанную команду (наивысший приоритет) remote — удалённый плагин через URL name — локальный плагин из PATH или встр","content":"Выполнение плагина через команду (command) **Приоритет источников плагина:** command — выполнение через указанную команду (наивысший приоритет) remote — удалённый плагин через URL name — локальный плагин из PATH или встроенный плагин path — путь к исполняемому файлу плагина"},{"id":"cli/generator/generator::command::58","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) **Параметры (источники и общие опции плагина):**","content":"Выполнение плагина через команду (command) **Параметры (источники и общие опции плагина):**"},{"id":"cli/generator/generator::command::59","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) Параметр Тип Обязателен По умолчанию Описание ---------- ----- ------------ -------------- ---------- name string ❌ - Имя / идентификатор плагина (например, go, go-grpc, grpc-ga","content":"Выполнение плагина через команду (command) Параметр Тип Обязателен По умолчанию Описание ---------- ----- ------------ -------------- ---------- name string ❌ - Имя / идентификатор плагина (например, go, go-grpc, grpc-gateway) command []string ❌ - Команда для выполнения плагина (например, [\"go\", \"run\", \"package\"]) remote string ❌ - URL удалённого плагина path string ❌ - Путь к исполняемому файлу плагина out string ❌ resolved generate root Директория для сгенерированных файлов opts mapstring ❌ {} Специфичные опции плагина; значения-списки передаются как повторяющиеся key=value with_imports bool ❌ false Включать proto из зависимостей"},{"id":"cli/generator/generator::command::60","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) **Примечание:** Для каждого плагина должен быть указан ровно один источник (name, command, remote или path). Если opts.outputServices задан как [\"grpc-js\", \"generic-definitions\"","content":"Выполнение плагина через команду (command) **Примечание:** Для каждого плагина должен быть указан ровно один источник (name, command, remote или path). Если opts.outputServices задан как [\"grpc-js\", \"generic-definitions\"], EasyP передаст outputServices=grpc-js,outputServices=generic-definitions."},{"id":"cli/generator/generator::command::61","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) **Примеры использования источника command:**","content":"Выполнение плагина через команду (command) **Примеры использования источника command:**"},{"id":"cli/generator/generator::command::62","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) ```yaml generate: inputs: - directory: \"proto\"","content":"Выполнение плагина через команду (command) ```yaml generate: inputs: - directory: \"proto\""},{"id":"cli/generator/generator::command::63","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) plugins: # 1) gRPC-Gateway через go run (без предварительной установки бинарника) - command: [\"go\", \"run\", \"github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.","content":"Выполнение плагина через команду (command) plugins: # 1) gRPC-Gateway через go run (без предварительной установки бинарника) - command: [\"go\", \"run\", \"github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.25.1\"] out: ./gen/go opts: paths: source_relative generate_unbound_methods: true"},{"id":"cli/generator/generator::command::64","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) 2) protoc-gen-validate через go run - command: [\"go\", \"run\", \"github.com/bufbuild/protoc-gen-validate@v0.10.1\"] out: ./gen/go opts: paths: source_relative lang: go","content":"Выполнение плагина через команду (command) 2) protoc-gen-validate через go run - command: [\"go\", \"run\", \"github.com/bufbuild/protoc-gen-validate@v0.10.1\"] out: ./gen/go opts: paths: source_relative lang: go"},{"id":"cli/generator/generator::command::65","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) 3) Произвольный кастомный скрипт-обёртка - command: [\"bash\", \"./scripts/custom-protoc-plugin.sh\"] out: ./gen/custom opts: foo: bar ```","content":"Выполнение плагина через команду (command) 3) Произвольный кастомный скрипт-обёртка - command: [\"bash\", \"./scripts/custom-protoc-plugin.sh\"] out: ./gen/custom opts: foo: bar ```"},{"id":"cli/generator/generator::builtin-plugins::66","title":"Генератор","section":"Встроенные плагины (Builtin Plugins)","path":"/docs/guide/cli/generator/generator#builtin-plugins","headings":["Встроенные плагины (Builtin Plugins)"],"excerpt":"Встроенные плагины (Builtin Plugins) EasyP поддерживает встроенные плагины для базовых языков protobuf и gRPC. Эти плагины встроены в бинарник как WASM-модули и не требуют установки внешних зависимостей.","content":"Встроенные плагины (Builtin Plugins) EasyP поддерживает встроенные плагины для базовых языков protobuf и gRPC. Эти плагины встроены в бинарник как WASM-модули и не требуют установки внешних зависимостей."},{"id":"cli/generator/generator::builtin-plugins::67","title":"Генератор","section":"Встроенные плагины (Builtin Plugins)","path":"/docs/guide/cli/generator/generator#builtin-plugins","headings":["Встроенные плагины (Builtin Plugins)"],"excerpt":"Встроенные плагины (Builtin Plugins) **Преимущества встроенных плагинов:** **Портативность**: Один бинарник со всеми необходимыми плагинами **Удобство**: Не требуется установка внешних зависимостей **Стабильность**: Верс","content":"Встроенные плагины (Builtin Plugins) **Преимущества встроенных плагинов:** **Портативность**: Один бинарник со всеми необходимыми плагинами **Удобство**: Не требуется установка внешних зависимостей **Стабильность**: Версии плагинов зафиксированы в бинарнике **Изоляция**: Не зависит от системных установок плагинов"},{"id":"cli/generator/generator::builtin-plugins::68","title":"Генератор","section":"Встроенные плагины (Builtin Plugins)","path":"/docs/guide/cli/generator/generator#builtin-plugins","headings":["Встроенные плагины (Builtin Plugins)"],"excerpt":"Встроенные плагины (Builtin Plugins) **Поддерживаемые встроенные плагины:**","content":"Встроенные плагины (Builtin Plugins) **Поддерживаемые встроенные плагины:**"},{"id":"cli/generator/generator::protobuf::69","title":"Генератор","section":"Protobuf базовые плагины","path":"/docs/guide/cli/generator/generator#protobuf","headings":["Protobuf базовые плагины"],"excerpt":"Protobuf базовые плагины Следующие плагины встроены для генерации базового protobuf кода:","content":"Protobuf базовые плагины Следующие плагины встроены для генерации базового protobuf кода:"},{"id":"cli/generator/generator::protobuf::70","title":"Генератор","section":"Protobuf базовые плагины","path":"/docs/guide/cli/generator/generator#protobuf","headings":["Protobuf базовые плагины"],"excerpt":"Protobuf базовые плагины Имя плагина Описание Соответствующий protoc плагин ------------- ---------- ------------------------------- cpp Генерация C++ кода из proto файлов protoc-gen-cpp csharp Генерация C# кода из proto","content":"Protobuf базовые плагины Имя плагина Описание Соответствующий protoc плагин ------------- ---------- ------------------------------- cpp Генерация C++ кода из proto файлов protoc-gen-cpp csharp Генерация C# кода из proto файлов protoc-gen-csharp java Генерация Java кода из proto файлов protoc-gen-java kotlin Генерация Kotlin кода из proto файлов protoc-gen-kotlin objc Генерация Objective-C кода из proto файлов protoc-gen-objc php Генерация PHP кода из proto файлов protoc-gen-php python Генерация Python кода из proto файлов protoc-gen-python ruby Генерация Ruby кода из proto файлов protoc-gen-ruby"},{"id":"cli/generator/generator::grpc::71","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины Следующие плагины встроены для генерации gRPC кода:","content":"gRPC плагины Следующие плагины встроены для генерации gRPC кода:"},{"id":"cli/generator/generator::grpc::72","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины Имя плагина Описание Соответствующий protoc плагин ------------- ---------- ------------------------------- grpc_cpp Генерация gRPC кода для C++ grpc_cpp_plugin grpc_csharp Генерация gRPC кода для C# grpc_cs","content":"gRPC плагины Имя плагина Описание Соответствующий protoc плагин ------------- ---------- ------------------------------- grpc_cpp Генерация gRPC кода для C++ grpc_cpp_plugin grpc_csharp Генерация gRPC кода для C# grpc_csharp_plugin grpc_java Генерация gRPC кода для Java grpc_java_plugin grpc_node Генерация gRPC кода для Node.js grpc_node_plugin grpc_objc Генерация gRPC кода для Objective-C grpc_objective_c_plugin grpc_php Генерация gRPC кода для PHP grpc_php_plugin grpc_python Генерация gRPC кода для Python grpc_python_plugin grpc_ruby Генерация gRPC кода для Ruby grpc_ruby_plugin"},{"id":"cli/generator/generator::grpc::73","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины **Логика выбора плагина:**","content":"gRPC плагины **Логика выбора плагина:**"},{"id":"cli/generator/generator::grpc::74","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины EasyP использует следующий приоритет при выборе executor'а для плагина:","content":"gRPC плагины EasyP использует следующий приоритет при выборе executor'а для плагина:"},{"id":"cli/generator/generator::grpc::75","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины **Удалённый плагин** (если указан url) — всегда имеет наивысший приоритет **Встроенный плагин** (если плагин встроен и не найден в PATH) — используется автоматически **Локальный плагин** (из PATH) — использу","content":"gRPC плагины **Удалённый плагин** (если указан url) — всегда имеет наивысший приоритет **Встроенный плагин** (если плагин встроен и не найден в PATH) — используется автоматически **Локальный плагин** (из PATH) — используется по умолчанию для обратной совместимости"},{"id":"cli/generator/generator::grpc::76","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины **Пример использования:**","content":"gRPC плагины **Пример использования:**"},{"id":"cli/generator/generator::grpc::77","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины Встроенные плагины включены в бинарник EasyP:","content":"gRPC плагины Встроенные плагины включены в бинарник EasyP:"},{"id":"cli/generator/generator::grpc::78","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины ```bash Сборка go build ./cmd/easyp","content":"gRPC плагины ```bash Сборка go build ./cmd/easyp"},{"id":"cli/generator/generator::grpc::79","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины Установка go install github.com/easyp-tech/easyp/cmd/easyp@latest ```","content":"gRPC плагины Установка go install github.com/easyp-tech/easyp/cmd/easyp@latest ```"},{"id":"cli/generator/generator::grpc::80","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины **Обратная совместимость:**","content":"gRPC плагины **Обратная совместимость:**"},{"id":"cli/generator/generator::grpc::81","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины Встроенные плагины полностью совместимы с существующими конфигурациями. Если плагин найден в PATH, он будет использован вместо встроенного. Это гарантирует, что:","content":"gRPC плагины Встроенные плагины полностью совместимы с существующими конфигурациями. Если плагин найден в PATH, он будет использован вместо встроенного. Это гарантирует, что:"},{"id":"cli/generator/generator::grpc::82","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины Существующие конфигурации продолжают работать без изменений Можно переопределить встроенный плагин, установив его в системе Приоритет отдаётся локальным установкам для гибкости","content":"gRPC плагины Существующие конфигурации продолжают работать без изменений Можно переопределить встроенный плагин, установив его в системе Приоритет отдаётся локальным установкам для гибкости"},{"id":"cli/generator/generator::top::83","title":"Генератор","section":"Справочник опций плагинов","path":"/docs/guide/cli/generator/generator","headings":["Справочник опций плагинов"],"excerpt":"Справочник опций плагинов Ниже перечислены наиболее часто используемые плагины и их настройки. Каждый плагин имеет параметры, влияющие на результат генерации — понимание этих опций важно для получения нужного вывода.","content":"Справочник опций плагинов Ниже перечислены наиболее часто используемые плагины и их настройки. Каждый плагин имеет параметры, влияющие на результат генерации — понимание этих опций важно для получения нужного вывода."},{"id":"cli/generator/generator::go-plugins::84","title":"Генератор","section":"Go Plugins","path":"/docs/guide/cli/generator/generator#go-plugins","headings":["Go Plugins"],"excerpt":"Go Plugins Плагины для Go — самые зрелые и распространённые. Опция paths управляет тем, как формируются пути импортов; остальные опции дают тонкую настройку вывода.","content":"Go Plugins Плагины для Go — самые зрелые и распространённые. Опция paths управляет тем, как формируются пути импортов; остальные опции дают тонкую настройку вывода."},{"id":"cli/generator/generator::grpc-gateway-plugins::85","title":"Генератор","section":"gRPC-Gateway Plugins","path":"/docs/guide/cli/generator/generator#grpc-gateway-plugins","headings":["gRPC-Gateway Plugins"],"excerpt":"gRPC-Gateway Plugins Позволяют экспонировать gRPC сервисы как REST API и генерировать OpenAPI. Критично для HTTP/JSON поверх gRPC.","content":"gRPC-Gateway Plugins Позволяют экспонировать gRPC сервисы как REST API и генерировать OpenAPI. Критично для HTTP/JSON поверх gRPC."},{"id":"cli/generator/generator::validation-plugins::86","title":"Генератор","section":"Validation Plugins","path":"/docs/guide/cli/generator/generator#validation-plugins","headings":["Validation Plugins"],"excerpt":"Validation Plugins Генерируют код валидации на основе правил в proto, устраняя ручную проверку.","content":"Validation Plugins Генерируют код валидации на основе правил в proto, устраняя ручную проверку."},{"id":"cli/generator/generator::typescriptjavascript-plugins::87","title":"Генератор","section":"TypeScript/JavaScript Plugins","path":"/docs/guide/cli/generator/generator#typescriptjavascript-plugins","headings":["TypeScript/JavaScript Plugins"],"excerpt":"TypeScript/JavaScript Plugins TypeScript плагины нужны фронтенду: типобезопасные интерфейсы и клиенты.","content":"TypeScript/JavaScript Plugins TypeScript плагины нужны фронтенду: типобезопасные интерфейсы и клиенты."},{"id":"cli/generator/generator::managed-mode::88","title":"Генератор","section":"Managed Mode","path":"/docs/guide/cli/generator/generator#managed-mode","headings":["Managed Mode"],"excerpt":"Managed Mode Managed mode автоматически устанавливает file и field опции в protobuf дескрипторах во время генерации кода без изменения исходных .proto файлов. Эта функция совместима с managed mode в buf и обеспечивает ед","content":"Managed Mode Managed mode автоматически устанавливает file и field опции в protobuf дескрипторах во время генерации кода без изменения исходных .proto файлов. Эта функция совместима с managed mode в buf и обеспечивает единообразный способ управления языково-специфичными опциями в вашей кодовой базе."},{"id":"cli/generator/generator::managed-mode::89","title":"Генератор","section":"Managed Mode","path":"/docs/guide/cli/generator/generator#managed-mode","headings":["Managed Mode"],"excerpt":"Managed Mode **Ключевые преимущества:** **Без изменений proto файлов**: Опции применяются во время генерации, proto файлы остаются чистыми **Согласованные значения по умолчанию**: Автоматическое применение языковых согла","content":"Managed Mode **Ключевые преимущества:** **Без изменений proto файлов**: Опции применяются во время генерации, proto файлы остаются чистыми **Согласованные значения по умолчанию**: Автоматическое применение языковых соглашений об именовании **Централизованная конфигурация**: Управление всеми опциями в одном месте (easyp.yaml) **Правила для модулей**: Применение разных опций к разным модулям или путям **Совместимость с buf**: Работает так же, как managed mode в buf"},{"id":"cli/generator/generator::top::90","title":"Генератор","section":"Как это работает","path":"/docs/guide/cli/generator/generator","headings":["Как это работает"],"excerpt":"Как это работает Когда managed mode включён, EasyP автоматически применяет file и field опции к protobuf дескрипторам перед генерацией кода. Это происходит в памяти, поэтому исходные .proto файлы остаются неизменными.","content":"Как это работает Когда managed mode включён, EasyP автоматически применяет file и field опции к protobuf дескрипторам перед генерацией кода. Это происходит в памяти, поэтому исходные .proto файлы остаются неизменными."},{"id":"cli/generator/generator::top::91","title":"Генератор","section":"Как это работает","path":"/docs/guide/cli/generator/generator","headings":["Как это работает"],"excerpt":"Как это работает **Значения по умолчанию** применяются для определённых опций на основе языковых соглашений: Java: java_package_prefix по умолчанию \"com\", java_multiple_files по умолчанию true C#: csharp_namespace по умо","content":"Как это работает **Значения по умолчанию** применяются для определённых опций на основе языковых соглашений: Java: java_package_prefix по умолчанию \"com\", java_multiple_files по умолчанию true C#: csharp_namespace по умолчанию PascalCase имени пакета Ruby: ruby_package по умолчанию PascalCase с разделителем :: PHP: php_namespace по умолчанию PascalCase с разделителем \\ Objective-C: objc_class_prefix по умолчанию первые буквы частей пакета C++: cc_enable_arenas по умолчанию true"},{"id":"cli/generator/generator::top::92","title":"Генератор","section":"Как это работает","path":"/docs/guide/cli/generator/generator","headings":["Как это работает"],"excerpt":"Как это работает **Overrides** позволяют установить конкретные значения для опций с поддержкой фильтрации по модулю, protobuf package, пути или полю. Если не указаны module, package и path, override применяется ко всем ф","content":"Как это работает **Overrides** позволяют установить конкретные значения для опций с поддержкой фильтрации по модулю, protobuf package, пути или полю. Если не указаны module, package и path, override применяется ко всем файлам в запросе генерации, включая зависимости и git_repo inputs."},{"id":"cli/generator/generator::top::93","title":"Генератор","section":"Как это работает","path":"/docs/guide/cli/generator/generator","headings":["Как это работает"],"excerpt":"Как это работает **Disables** позволяют предотвратить изменение managed mode определённых опций или файлов. Это рекомендуемый способ исключить внешние зависимости, у которых свои опции уже заданы.","content":"Как это работает **Disables** позволяют предотвратить изменение managed mode определённых опций или файлов. Это рекомендуемый способ исключить внешние зависимости, у которых свои опции уже заданы."},{"id":"cli/generator/generator::top::94","title":"Генератор","section":"Конфигурация","path":"/docs/guide/cli/generator/generator","headings":["Конфигурация"],"excerpt":"Конфигурация ```yaml generate: managed: enabled: true disable: # Отключить managed mode для конкретного модуля - module: github.com/googleapis/googleapis # Отключить конкретную опцию глобально - file_option: java_package","content":"Конфигурация ```yaml generate: managed: enabled: true disable: # Отключить managed mode для конкретного модуля - module: github.com/googleapis/googleapis # Отключить конкретную опцию глобально - file_option: java_package_prefix"},{"id":"cli/generator/generator::top::95","title":"Генератор","section":"Конфигурация","path":"/docs/guide/cli/generator/generator","headings":["Конфигурация"],"excerpt":"Конфигурация Отключить для конкретного protobuf package - package: acme.weather.v1 file_option: java_package # Отключить для конкретного пути - path: legacy/ file_option: go_package # Отключить field опцию для конкретног","content":"Конфигурация Отключить для конкретного protobuf package - package: acme.weather.v1 file_option: java_package # Отключить для конкретного пути - path: legacy/ file_option: go_package # Отключить field опцию для конкретного поля - field_option: jstype field: com.example.User.id override: # Переопределить go_package_prefix для всех файлов - file_option: go_package_prefix value: github.com/mycompany/myproject/gen/go # Переопределить для конкретного модуля - file_option: java_package_prefix value: com.mycompany module: github.com/mycompany/internal-protos"},{"id":"cli/generator/generator::top::96","title":"Генератор","section":"Конфигурация","path":"/docs/guide/cli/generator/generator","headings":["Конфигурация"],"excerpt":"Конфигурация Переопределить для конкретного protobuf package - file_option: go_package_prefix value: github.com/mycompany/myproject/gen/go package: acme.weather.v1 # Переопределить для конкретного пути - file_option: csh","content":"Конфигурация Переопределить для конкретного protobuf package - file_option: go_package_prefix value: github.com/mycompany/myproject/gen/go package: acme.weather.v1 # Переопределить для конкретного пути - file_option: csharp_namespace_prefix value: MyCompany path: api/v1/ # Переопределить для нескольких файлов с одинаковым значением используя префиксный путь # Это совпадет и с internal/cms/bmi.proto, и с internal/cms/bmi_service.proto - file_option: go_package value: spec/cms/bmi path: \"internal/cms/bmi\" # Переопределить field опцию для конкретного пути - field_option: jstype value: JS_STRING path: api/v1/ # Переопределить для конкретного поля - field_option: jstype value: JS_NUMBER field: com.example.User.big_id ```"},{"id":"cli/generator/generator::file-options::97","title":"Генератор","section":"Поддерживаемые File Options","path":"/docs/guide/cli/generator/generator#file-options","headings":["Поддерживаемые File Options"],"excerpt":"Поддерживаемые File Options Опция Описание Есть значение по умолчанию? ------- ---------- ---------------------------- go_package Go import path ❌ go_package_prefix Префикс для Go import paths ❌ java_package Имя Java пак","content":"Поддерживаемые File Options Опция Описание Есть значение по умолчанию? ------- ---------- ---------------------------- go_package Go import path ❌ go_package_prefix Префикс для Go import paths ❌ java_package Имя Java пакета ❌ java_package_prefix Префикс для Java пакетов ✅ (\"com\") java_package_suffix Суффикс для Java пакетов ❌ java_multiple_files Генерировать несколько Java файлов ✅ (true) java_outer_classname Имя внешнего класса ✅ (PascalCase + \"Proto\") java_string_check_utf8 UTF-8 валидация ❌ csharp_namespace C# namespace ✅ (PascalCase) csharp_namespace_prefix Префикс для C# namespaces ❌ ruby_package Имя Ruby модуля ✅ (PascalCase с ::) ruby_package_suffix Суффикс для Ruby пакетов ❌ php_namespace PHP namespace ✅ (PascalCase с \\) php_metadata_namespace PHP metadata namespace ❌ php_metadata_namespace_suffix Суффикс для PHP metadata ❌ objc_class_prefix Objective-C префикс класса ✅ (Первые буквы) swift_prefix Swift префикс ❌ optimize_for Оптимизация генерации кода ❌ cc_enable_arenas C++ arena аллокация ✅ (true)"},{"id":"cli/generator/generator::field-options::98","title":"Генератор","section":"Поддерживаемые Field Options","path":"/docs/guide/cli/generator/generator#field-options","headings":["Поддерживаемые Field Options"],"excerpt":"Поддерживаемые Field Options Опция Описание Применяется к ------- ---------- --------------- jstype JavaScript тип для 64-битных целых чисел int64, uint64, sint64, fixed64, sfixed64","content":"Поддерживаемые Field Options Опция Описание Применяется к ------- ---------- --------------- jstype JavaScript тип для 64-битных целых чисел int64, uint64, sint64, fixed64, sfixed64"},{"id":"cli/generator/generator::top::99","title":"Генератор","section":"Базовая настройка со значениями по умолчанию","path":"/docs/guide/cli/generator/generator","headings":["Базовая настройка со значениями по умолчанию"],"excerpt":"Базовая настройка со значениями по умолчанию Включите managed mode для получения автоматических значений по умолчанию для всех поддерживаемых языков:","content":"Базовая настройка со значениями по умолчанию Включите managed mode для получения автоматических значений по умолчанию для всех поддерживаемых языков:"},{"id":"cli/generator/generator::top::100","title":"Генератор","section":"Базовая настройка со значениями по умолчанию","path":"/docs/guide/cli/generator/generator","headings":["Базовая настройка со значениями по умолчанию"],"excerpt":"Базовая настройка со значениями по умолчанию","content":"Базовая настройка со значениями по умолчанию"},{"id":"cli/generator/generator::top::101","title":"Генератор","section":"Базовая настройка со значениями по умолчанию","path":"/docs/guide/cli/generator/generator","headings":["Базовая настройка со значениями по умолчанию"],"excerpt":"Базовая настройка со значениями по умолчанию Это автоматически установит: java_package в com. для всех файлов java_multiple_files в true csharp_namespace в PascalCase имени пакета ruby_package в PascalCase с разделителем","content":"Базовая настройка со значениями по умолчанию Это автоматически установит: java_package в com. для всех файлов java_multiple_files в true csharp_namespace в PascalCase имени пакета ruby_package в PascalCase с разделителем :: И многое другое..."},{"id":"cli/generator/generator::go::102","title":"Генератор","section":"Кастомный префикс Go пакета","path":"/docs/guide/cli/generator/generator#go","headings":["Кастомный префикс Go пакета"],"excerpt":"Кастомный префикс Go пакета Переопределите префикс Go пакета для вашего проекта:","content":"Кастомный префикс Go пакета Переопределите префикс Go пакета для вашего проекта:"},{"id":"cli/generator/generator::go::103","title":"Генератор","section":"Кастомный префикс Go пакета","path":"/docs/guide/cli/generator/generator#go","headings":["Кастомный префикс Go пакета"],"excerpt":"Кастомный префикс Go пакета Это установит go_package в github.com/mycompany/myproject/gen/go/ для всех файлов.","content":"Кастомный префикс Go пакета Это установит go_package в github.com/mycompany/myproject/gen/go/ для всех файлов."},{"id":"cli/generator/generator::go::104","title":"Генератор","section":"Динамические пути Go пакетов с маркерами","path":"/docs/guide/cli/generator/generator#go","headings":["Динамические пути Go пакетов с маркерами"],"excerpt":"Динамические пути Go пакетов с маркерами Для более сложной генерации путей можно использовать маркеры в значениях go_package_prefix или go_package:","content":"Динамические пути Go пакетов с маркерами Для более сложной генерации путей можно использовать маркеры в значениях go_package_prefix или go_package:"},{"id":"cli/generator/generator::go::105","title":"Генератор","section":"Динамические пути Go пакетов с маркерами","path":"/docs/guide/cli/generator/generator#go","headings":["Динамические пути Go пакетов с маркерами"],"excerpt":"Динамические пути Go пакетов с маркерами","content":"Динамические пути Go пакетов с маркерами"},{"id":"cli/generator/generator::go::106","title":"Генератор","section":"Динамические пути Go пакетов с маркерами","path":"/docs/guide/cli/generator/generator#go","headings":["Динамические пути Go пакетов с маркерами"],"excerpt":"Динамические пути Go пакетов с маркерами **Доступные маркеры:** {{file_path}} - Полный путь файла без расширения .proto - Пример: internal/cms/as.proto → internal/cms/as {{file_dir}} - Только путь директории, без имени ф","content":"Динамические пути Go пакетов с маркерами **Доступные маркеры:** {{file_path}} - Полный путь файла без расширения .proto - Пример: internal/cms/as.proto → internal/cms/as {{file_dir}} - Только путь директории, без имени файла - Пример: internal/cms/as.proto → internal/cms {{file_dir_without:prefix/}} - Путь директории с удалением префикса и базового имени файла без суффиксов _service/_grpc - Пример: {{file_dir_without:internal/}} для internal/cms/as_service.proto → cms/as {{file_path_without:prefix/}} - Полный путь файла с удалением префикса - Пример: {{file_path_without:internal/}} для internal/cms/as.proto → cms/as"},{"id":"cli/generator/generator::top::107","title":"Генератор","section":"Переопределения для конкретных модулей","path":"/docs/guide/cli/generator/generator","headings":["Переопределения для конкретных модулей"],"excerpt":"Переопределения для конкретных модулей Примените разные опции к разным модулям:","content":"Переопределения для конкретных модулей Примените разные опции к разным модулям:"},{"id":"cli/generator/generator::top::108","title":"Генератор","section":"Переопределения для конкретных модулей","path":"/docs/guide/cli/generator/generator","headings":["Переопределения для конкретных модулей"],"excerpt":"Переопределения для конкретных модулей","content":"Переопределения для конкретных модулей"},{"id":"cli/generator/generator::top::109","title":"Генератор","section":"Переопределения для конкретных модулей","path":"/docs/guide/cli/generator/generator","headings":["Переопределения для конкретных модулей"],"excerpt":"Переопределения для конкретных модулей module должен точно совпадать с источником модуля в EasyP: это значение из deps или git_repo.url до @version (например, github.com/mycompany/internal-protos или https://github.com/m","content":"Переопределения для конкретных модулей module должен точно совпадать с источником модуля в EasyP: это значение из deps или git_repo.url до @version (например, github.com/mycompany/internal-protos или https://github.com/mycompany/internal-protos). Это не Go module path из go.mod."},{"id":"cli/generator/generator::top::110","title":"Генератор","section":"Переопределения для конкретных модулей","path":"/docs/guide/cli/generator/generator","headings":["Переопределения для конкретных модулей"],"excerpt":"Переопределения для конкретных модулей package должен точно совпадать со значением package в .proto файле, например acme.weather.v1.","content":"Переопределения для конкретных модулей package должен точно совпадать со значением package в .proto файле, например acme.weather.v1."},{"id":"cli/generator/generator::protobuf-package::111","title":"Генератор","section":"Переопределения для конкретного protobuf package","path":"/docs/guide/cli/generator/generator#protobuf-package","headings":["Переопределения для конкретного protobuf package"],"excerpt":"Переопределения для конкретного protobuf package Примените отдельные опции к файлам из конкретного protobuf package:","content":"Переопределения для конкретного protobuf package Примените отдельные опции к файлам из конкретного protobuf package:"},{"id":"cli/generator/generator::protobuf-package::112","title":"Генератор","section":"Переопределения для конкретного protobuf package","path":"/docs/guide/cli/generator/generator#protobuf-package","headings":["Переопределения для конкретного protobuf package"],"excerpt":"Переопределения для конкретного protobuf package","content":"Переопределения для конкретного protobuf package"},{"id":"cli/generator/generator::top::113","title":"Генератор","section":"Отключение для внешних зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Отключение для внешних зависимостей"],"excerpt":"Отключение для внешних зависимостей Отключите managed mode для внешних зависимостей, у которых уже установлены опции:","content":"Отключение для внешних зависимостей Отключите managed mode для внешних зависимостей, у которых уже установлены опции:"},{"id":"cli/generator/generator::top::114","title":"Генератор","section":"Отключение для внешних зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Отключение для внешних зависимостей"],"excerpt":"Отключение для внешних зависимостей","content":"Отключение для внешних зависимостей"},{"id":"cli/generator/generator::javascript::115","title":"Генератор","section":"Типобезопасность JavaScript","path":"/docs/guide/cli/generator/generator#javascript","headings":["Типобезопасность JavaScript"],"excerpt":"Типобезопасность JavaScript Установите jstype в JS_STRING для всех 64-битных целочисленных полей, чтобы предотвратить потерю точности в JavaScript:","content":"Типобезопасность JavaScript Установите jstype в JS_STRING для всех 64-битных целочисленных полей, чтобы предотвратить потерю точности в JavaScript:"},{"id":"cli/generator/generator::top::116","title":"Генератор","section":"Совпадение путей","path":"/docs/guide/cli/generator/generator","headings":["Совпадение путей"],"excerpt":"Совпадение путей Совпадение путей в managed mode использует префиксное совпадение (как в buf):","content":"Совпадение путей Совпадение путей в managed mode использует префиксное совпадение (как в buf):"},{"id":"cli/generator/generator::top::117","title":"Генератор","section":"Совпадение путей","path":"/docs/guide/cli/generator/generator","headings":["Совпадение путей"],"excerpt":"Совпадение путей **Путь директории** (заканчивается на /): Совпадает со всеми файлами в этой директории и поддиректориях - Пример: path: \"internal/cms/\" совпадает с internal/cms/as.proto, internal/cms/node.proto, interna","content":"Совпадение путей **Путь директории** (заканчивается на /): Совпадает со всеми файлами в этой директории и поддиректориях - Пример: path: \"internal/cms/\" совпадает с internal/cms/as.proto, internal/cms/node.proto, internal/cms/v1/service.proto **Точный путь файла** (заканчивается на .proto): Совпадает только с этим конкретным файлом - Пример: path: \"internal/cms/as.proto\" совпадает только с internal/cms/as.proto **Префиксный путь** (без завершающего / или .proto): Использует префиксное совпадение (не директориально-осознанное) - Пример: path: \"internal/cms\" совпадает с internal/cms/as.proto, но также с internal/cmsv2/file.proto - **Совет**: Используйте префиксные пути для группировки нескольких файлов с одинаковым значением. Например, path: \"internal/cms/bmi\" совпадает и с internal/cms/bmi.proto, и с internal/cms/bmi_service.proto, что позволяет установить одно и то же значение go_package для обоих файлов одним правилом."},{"id":"cli/generator/generator::top::118","title":"Генератор","section":"Приоритет правил","path":"/docs/guide/cli/generator/generator","headings":["Приоритет правил"],"excerpt":"Приоритет правил Когда несколько правил соответствуют одному файлу или полю, применяется следующий приоритет:","content":"Приоритет правил Когда несколько правил соответствуют одному файлу или полю, применяется следующий приоритет:"},{"id":"cli/generator/generator::top::119","title":"Генератор","section":"Приоритет правил","path":"/docs/guide/cli/generator/generator","headings":["Приоритет правил"],"excerpt":"Приоритет правил **Disable правила** имеют приоритет — если опция отключена, она не будет применена **Override правила** применяются по порядку — последнее совпадающее правило побеждает **Значения по умолчанию** применяю","content":"Приоритет правил **Disable правила** имеют приоритет — если опция отключена, она не будет применена **Override правила** применяются по порядку — последнее совпадающее правило побеждает **Значения по умолчанию** применяются только если нет совпадающего override и опция не отключена"},{"id":"cli/generator/generator::buf::120","title":"Генератор","section":"Совместимость с buf","path":"/docs/guide/cli/generator/generator#buf","headings":["Совместимость с buf"],"excerpt":"Совместимость с buf Managed mode в EasyP совместим с managed mode в buf. Тот же формат конфигурации и поведение применяются, что упрощает миграцию между инструментами или использование обоих в одном workflow.","content":"Совместимость с buf Managed mode в EasyP совместим с managed mode в buf. Тот же формат конфигурации и поведение применяются, что упрощает миграцию между инструментами или использование обоих в одном workflow."},{"id":"cli/generator/generator::descriptor-set::121","title":"Генератор","section":"Генерация Descriptor Set","path":"/docs/guide/cli/generator/generator#descriptor-set","headings":["Генерация Descriptor Set"],"excerpt":"Генерация Descriptor Set **https://protobuf.dev/programming-guides/techniques/#self-description**","content":"Генерация Descriptor Set **https://protobuf.dev/programming-guides/techniques/#self-description**"},{"id":"cli/generator/generator::descriptor-set::122","title":"Генератор","section":"Генерация Descriptor Set","path":"/docs/guide/cli/generator/generator#descriptor-set","headings":["Генерация Descriptor Set"],"excerpt":"Генерация Descriptor Set EasyP поддерживает генерацию бинарных FileDescriptorSet файлов с помощью флага --descriptor_set_out. Это позволяет создавать самоописывающиеся protobuf сообщения, которые включают информацию о сх","content":"Генерация Descriptor Set EasyP поддерживает генерацию бинарных FileDescriptorSet файлов с помощью флага --descriptor_set_out. Это позволяет создавать самоописывающиеся protobuf сообщения, которые включают информацию о схеме вместе с данными."},{"id":"cli/generator/generator::descriptor-set::123","title":"Генератор","section":"Генерация Descriptor Set","path":"/docs/guide/cli/generator/generator#descriptor-set","headings":["Генерация Descriptor Set"],"excerpt":"Генерация Descriptor Set **Флаги CLI:**","content":"Генерация Descriptor Set **Флаги CLI:**"},{"id":"cli/generator/generator::descriptor-set::124","title":"Генератор","section":"Генерация Descriptor Set","path":"/docs/guide/cli/generator/generator#descriptor-set","headings":["Генерация Descriptor Set"],"excerpt":"Генерация Descriptor Set --descriptor_set_out - Путь для вывода бинарного FileDescriptorSet --include_imports - Включить все транзитивные зависимости в FileDescriptorSet","content":"Генерация Descriptor Set --descriptor_set_out - Путь для вывода бинарного FileDescriptorSet --include_imports - Включить все транзитивные зависимости в FileDescriptorSet"},{"id":"cli/generator/generator::descriptor-set::125","title":"Генератор","section":"Генерация Descriptor Set","path":"/docs/guide/cli/generator/generator#descriptor-set","headings":["Генерация Descriptor Set"],"excerpt":"Генерация Descriptor Set **Пример:**","content":"Генерация Descriptor Set **Пример:**"},{"id":"cli/generator/generator::descriptor-set::126","title":"Генератор","section":"Генерация Descriptor Set","path":"/docs/guide/cli/generator/generator#descriptor-set","headings":["Генерация Descriptor Set"],"excerpt":"Генерация Descriptor Set ```bash Генерация descriptor set только с целевыми файлами easyp generate --descriptor_set_out=./schema.pb","content":"Генерация Descriptor Set ```bash Генерация descriptor set только с целевыми файлами easyp generate --descriptor_set_out=./schema.pb"},{"id":"cli/generator/generator::descriptor-set::127","title":"Генератор","section":"Генерация Descriptor Set","path":"/docs/guide/cli/generator/generator#descriptor-set","headings":["Генерация Descriptor Set"],"excerpt":"Генерация Descriptor Set Генерация descriptor set со всеми зависимостями easyp generate --descriptor_set_out=./schema.pb --include_imports ```","content":"Генерация Descriptor Set Генерация descriptor set со всеми зависимостями easyp generate --descriptor_set_out=./schema.pb --include_imports ```"},{"id":"cli/generator/generator::descriptor-set::128","title":"Генератор","section":"Генерация Descriptor Set","path":"/docs/guide/cli/generator/generator#descriptor-set","headings":["Генерация Descriptor Set"],"excerpt":"Генерация Descriptor Set Самоописывающиеся сообщения полезны для динамического парсинга сообщений, валидации схемы во время выполнения, реестров схем и создания универсальных gRPC клиентов. Для получения дополнительной и","content":"Генерация Descriptor Set Самоописывающиеся сообщения полезны для динамического парсинга сообщений, валидации схемы во время выполнения, реестров схем и создания универсальных gRPC клиентов. Для получения дополнительной информации см. документацию Protocol Buffers о самоописании."},{"id":"cli/generator/generator::top::129","title":"Генератор","section":"Интеграция с менеджером пакетов","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с менеджером пакетов"],"excerpt":"Интеграция с менеджером пакетов Одной из самых мощных возможностей EasyP является бесшовная интеграция генератора кода с менеджером пакетов. Это устраняет проблему ручного управления proto‑зависимостями и гарантирует, чт","content":"Интеграция с менеджером пакетов Одной из самых мощных возможностей EasyP является бесшовная интеграция генератора кода с менеджером пакетов. Это устраняет проблему ручного управления proto‑зависимостями и гарантирует, что при генерации используются корректные (зафиксированные) версии импортируемых файлов."},{"id":"cli/generator/generator::top::130","title":"Генератор","section":"Интеграция с менеджером пакетов","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с менеджером пакетов"],"excerpt":"Интеграция с менеджером пакетов **Ключевые преимущества:** **Автоматическое разрешение зависимостей**: не нужно вручную прописывать пути импортов **Согласованность версий**: фиксация в easyp.lock гарантирует воспроизводи","content":"Интеграция с менеджером пакетов **Ключевые преимущества:** **Автоматическое разрешение зависимостей**: не нужно вручную прописывать пути импортов **Согласованность версий**: фиксация в easyp.lock гарантирует воспроизводимость **Транзитивные зависимости**: вложенные цепочки подтягиваются автоматически **Производительность**: локальный кеш — скачивание один раз и повторное использование"},{"id":"cli/generator/generator::top::131","title":"Генератор","section":"Автоматическое разрешение зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Автоматическое разрешение зависимостей"],"excerpt":"Автоматическое разрешение зависимостей Когда вы указываете зависимости в секции deps, генератор автоматически добавляет их в путь импортов. Ваши proto‑файлы могут делать стандартные import из этих зависимостей без дополн","content":"Автоматическое разрешение зависимостей Когда вы указываете зависимости в секции deps, генератор автоматически добавляет их в путь импортов. Ваши proto‑файлы могут делать стандартные import из этих зависимостей без дополнительной настройки."},{"id":"cli/generator/generator::top::132","title":"Генератор","section":"Автоматическое разрешение зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Автоматическое разрешение зависимостей"],"excerpt":"Автоматическое разрешение зависимостей **Как это работает:** EasyP скачивает и кеширует зависимости из deps Во время генерации кешированные файлы автоматически добавляются в import‑path protoc Ваши proto‑файлы используют","content":"Автоматическое разрешение зависимостей **Как это работает:** EasyP скачивает и кеширует зависимости из deps Во время генерации кешированные файлы автоматически добавляются в import‑path protoc Ваши proto‑файлы используют обычные import строки для обращения к зависимостям При with_imports: true в вывод попадают и локальные файлы, и файлы зависимостей"},{"id":"cli/generator/generator::top::133","title":"Генератор","section":"Автоматическое разрешение зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Автоматическое разрешение зависимостей"],"excerpt":"Автоматическое разрешение зависимостей Ниже простой пример — зависимости указываются один раз в deps, далее они доступны при генерации автоматически:","content":"Автоматическое разрешение зависимостей Ниже простой пример — зависимости указываются один раз в deps, далее они доступны при генерации автоматически:"},{"id":"cli/generator/generator::top::134","title":"Генератор","section":"Автоматическое разрешение зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Автоматическое разрешение зависимостей"],"excerpt":"Автоматическое разрешение зависимостей ```yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc-ecosystem/grpc-gateway@v2.19.1","content":"Автоматическое разрешение зависимостей ```yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc-ecosystem/grpc-gateway@v2.19.1"},{"id":"cli/generator/generator::top::135","title":"Генератор","section":"Автоматическое разрешение зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Автоматическое разрешение зависимостей"],"excerpt":"Автоматическое разрешение зависимостей generate: inputs: - directory: \"proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true # This automatically includes googleapis and grpc-gateway pr","content":"Автоматическое разрешение зависимостей generate: inputs: - directory: \"proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true # This automatically includes googleapis and grpc-gateway protos ```"},{"id":"cli/generator/generator::top::136","title":"Генератор","section":"Примеры использования зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Примеры использования зависимостей"],"excerpt":"Примеры использования зависимостей Ниже показаны распространённые способы интеграции внешних proto‑зависимостей в процесс генерации.","content":"Примеры использования зависимостей Ниже показаны распространённые способы интеграции внешних proto‑зависимостей в процесс генерации."},{"id":"cli/generator/generator::google-apis::137","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs Google APIs — одна из самых популярных коллекций зависимостей: стандартные типы, аннотации для REST, проверки и общие структуры данных.","content":"Использование Google APIs Google APIs — одна из самых популярных коллекций зависимостей: стандартные типы, аннотации для REST, проверки и общие структуры данных."},{"id":"cli/generator/generator::google-apis::138","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs **Когда использовать Google APIs:** Построение REST поверх gRPC (gRPC-Gateway) Нужны стандартные типы (Timestamp, Duration, Any) Требуются аннотации поведения полей (field behavior) Интеграция с","content":"Использование Google APIs **Когда использовать Google APIs:** Построение REST поверх gRPC (gRPC-Gateway) Нужны стандартные типы (Timestamp, Duration, Any) Требуются аннотации поведения полей (field behavior) Интеграция с сервисами Google Cloud"},{"id":"cli/generator/generator::google-apis::139","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs Минимальная конфигурация для подключения Google APIs:","content":"Использование Google APIs Минимальная конфигурация для подключения Google APIs:"},{"id":"cli/generator/generator::google-apis::140","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs ```yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1","content":"Использование Google APIs ```yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1"},{"id":"cli/generator/generator::google-apis::141","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs generate: inputs: - directory: \"api/proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true ```","content":"Использование Google APIs generate: inputs: - directory: \"api/proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true ```"},{"id":"cli/generator/generator::google-apis::142","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs **Важно:** Всегда фиксируйте версию (например common-protos-1_3_1) — не используйте latest в продакшене.","content":"Использование Google APIs **Важно:** Всегда фиксируйте версию (например common-protos-1_3_1) — не используйте latest в продакшене."},{"id":"cli/generator/generator::google-apis::143","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs После настройки ваши proto могут импортировать определения Google API. Ниже пример сервиса с HTTP аннотацией:","content":"Использование Google APIs После настройки ваши proto могут импортировать определения Google API. Ниже пример сервиса с HTTP аннотацией:"},{"id":"cli/generator/generator::google-apis::144","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs ```proto // api/proto/service.proto syntax = \"proto3\";","content":"Использование Google APIs ```proto // api/proto/service.proto syntax = \"proto3\";"},{"id":"cli/generator/generator::google-apis::145","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs import \"google/api/annotations.proto\"; import \"google/protobuf/timestamp.proto\";","content":"Использование Google APIs import \"google/api/annotations.proto\"; import \"google/protobuf/timestamp.proto\";"},{"id":"cli/generator/generator::google-apis::146","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs service MyService { rpc GetData(GetDataRequest) returns (GetDataResponse) { option (google.api.http) = { get: \"/v1/data\" }; } } ```","content":"Использование Google APIs service MyService { rpc GetData(GetDataRequest) returns (GetDataResponse) { option (google.api.http) = { get: \"/v1/data\" }; } } ```"},{"id":"cli/generator/generator::top::147","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации protoc-gen-validate даёт мощную проверку полей прямо в определениях proto, устраняя необходимость писать отдельную логику валидации в приложении.","content":"Использование правил валидации protoc-gen-validate даёт мощную проверку полей прямо в определениях proto, устраняя необходимость писать отдельную логику валидации в приложении."},{"id":"cli/generator/generator::top::148","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации **Когда применять валидацию:** Проверка входных данных API Ограничения моделей БД Проверка конфигурационных файлов Любая ситуация, где критична целостность данных","content":"Использование правил валидации **Когда применять валидацию:** Проверка входных данных API Ограничения моделей БД Проверка конфигурационных файлов Любая ситуация, где критична целостность данных"},{"id":"cli/generator/generator::top::149","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации **Преимущества:** Правила валидации — часть proto (единый источник истины) Генерация создаёт функции проверки автоматически Единообразие проверок между языками Производительнее чем проверка","content":"Использование правил валидации **Преимущества:** Правила валидации — часть proto (единый источник истины) Генерация создаёт функции проверки автоматически Единообразие проверок между языками Производительнее чем проверка через runtime reflection"},{"id":"cli/generator/generator::top::150","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации ```yaml deps: - github.com/bufbuild/protoc-gen-validate@v0.10.1","content":"Использование правил валидации ```yaml deps: - github.com/bufbuild/protoc-gen-validate@v0.10.1"},{"id":"cli/generator/generator::top::151","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации generate: inputs: - directory: \"proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true - name: validate-go out: ./gen/go opts: paths: source_relative ```","content":"Использование правил валидации generate: inputs: - directory: \"proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true - name: validate-go out: ./gen/go opts: paths: source_relative ```"},{"id":"cli/generator/generator::top::152","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации **Примечание:** Нужны одновременно зависимость (для импортов proto) и плагин (для генерации кода), чтобы получить полноценную поддержку валидации.","content":"Использование правил валидации **Примечание:** Нужны одновременно зависимость (для импортов proto) и плагин (для генерации кода), чтобы получить полноценную поддержку валидации."},{"id":"cli/generator/generator::top::153","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации Так выглядят правила валидации в proto — сгенерированный код будет автоматически их применять:","content":"Использование правил валидации Так выглядят правила валидации в proto — сгенерированный код будет автоматически их применять:"},{"id":"cli/generator/generator::top::154","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации ```proto // proto/user.proto syntax = \"proto3\";","content":"Использование правил валидации ```proto // proto/user.proto syntax = \"proto3\";"},{"id":"cli/generator/generator::top::155","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации import \"validate/validate.proto\";","content":"Использование правил валидации import \"validate/validate.proto\";"},{"id":"cli/generator/generator::top::156","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации message User { string email = 1 [(validate.rules).string.email = true]; int32 age = 2 [(validate.rules).int32.gte = 0]; } ```","content":"Использование правил валидации message User { string email = 1 [(validate.rules).string.email = true]; int32 age = 2 [(validate.rules).int32.gte = 0]; } ```"},{"id":"cli/generator/generator::top::157","title":"Генератор","section":"Комплексная конфигурация с несколькими зависимостями","path":"/docs/guide/cli/generator/generator","headings":["Комплексная конфигурация с несколькими зависимостями"],"excerpt":"Комплексная конфигурация с несколькими зависимостями Пример ниже показывает продакшен‑конфигурацию, объединяющую несколько зависимостей и плагины для полного цикла разработки API:","content":"Комплексная конфигурация с несколькими зависимостями Пример ниже показывает продакшен‑конфигурацию, объединяющую несколько зависимостей и плагины для полного цикла разработки API:"},{"id":"cli/generator/generator::top::158","title":"Генератор","section":"Комплексная конфигурация с несколькими зависимостями","path":"/docs/guide/cli/generator/generator","headings":["Комплексная конфигурация с несколькими зависимостями"],"excerpt":"Комплексная конфигурация с несколькими зависимостями ```yaml deps: # Core Google APIs - Standard types and HTTP annotations - github.com/googleapis/googleapis@common-protos-1_3_1 # gRPC Gateway for REST APIs - Enables HT","content":"Комплексная конфигурация с несколькими зависимостями ```yaml deps: # Core Google APIs - Standard types and HTTP annotations - github.com/googleapis/googleapis@common-protos-1_3_1 # gRPC Gateway for REST APIs - Enables HTTP/JSON interfaces - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 # Validation rules - Field-level validation constraints - github.com/bufbuild/protoc-gen-validate@v0.10.1 # Company internal shared types - Common business objects - github.com/mycompany/shared-protos@v1.5.0"},{"id":"cli/generator/generator::top::159","title":"Генератор","section":"Комплексная конфигурация с несколькими зависимостями","path":"/docs/guide/cli/generator/generator","headings":["Комплексная конфигурация с несколькими зависимостями"],"excerpt":"Комплексная конфигурация с несколькими зависимостями generate: inputs: - directory: \"api/proto\" plugins: # Go code generation - Core protobuf structures - name: go out: ./gen/go opts: paths: source_relative module: githu","content":"Комплексная конфигурация с несколькими зависимостями generate: inputs: - directory: \"api/proto\" plugins: # Go code generation - Core protobuf structures - name: go out: ./gen/go opts: paths: source_relative module: github.com/mycompany/myservice with_imports: true # gRPC service stubs - Server and client interfaces - name: go-grpc out: ./gen/go opts: paths: source_relative require_unimplemented_servers: false # REST Gateway - HTTP-to-gRPC proxy code - name: grpc-gateway out: ./gen/go opts: paths: source_relative # OpenAPI documentation - API specification - name: openapiv2 out: ./gen/openapi opts: simple_operation_ids: true # Validation code - Input validation functions - name: validate-go out: ./gen/go opts: paths: source_relative ```"},{"id":"cli/generator/generator::top::160","title":"Генератор","section":"Интеграция с кешем зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с кешем зависимостей"],"excerpt":"Интеграция с кешем зависимостей Генератор использует модульный кеш EasyP для ускорения сборок:","content":"Интеграция с кешем зависимостей Генератор использует модульный кеш EasyP для ускорения сборок:"},{"id":"cli/generator/generator::top::161","title":"Генератор","section":"Интеграция с кешем зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с кешем зависимостей"],"excerpt":"Интеграция с кешем зависимостей ```bash Download dependencies once easyp mod download","content":"Интеграция с кешем зависимостей ```bash Download dependencies once easyp mod download"},{"id":"cli/generator/generator::top::162","title":"Генератор","section":"Интеграция с кешем зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с кешем зависимостей"],"excerpt":"Интеграция с кешем зависимостей Generate code (uses cached dependencies) easyp generate","content":"Интеграция с кешем зависимостей Generate code (uses cached dependencies) easyp generate"},{"id":"cli/generator/generator::top::163","title":"Генератор","section":"Интеграция с кешем зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с кешем зависимостей"],"excerpt":"Интеграция с кешем зависимостей Dependencies are cached in ~/.easyp/mod/ ls ~/.easyp/mod/github.com/googleapis/googleapis/ ```","content":"Интеграция с кешем зависимостей Dependencies are cached in ~/.easyp/mod/ ls ~/.easyp/mod/github.com/googleapis/googleapis/ ```"},{"id":"cli/generator/generator::top::164","title":"Генератор","section":"Удалённая генерация","path":"/docs/guide/cli/generator/generator","headings":["Удалённая генерация"],"excerpt":"Удалённая генерация Удалённая генерация — мощная возможность, позволяющая генерировать код из proto‑файлов в удалённых Git‑репозиториях без локального checkout. Это поддерживает микросервисную архитектуру, где команды ис","content":"Удалённая генерация Удалённая генерация — мощная возможность, позволяющая генерировать код из proto‑файлов в удалённых Git‑репозиториях без локального checkout. Это поддерживает микросервисную архитектуру, где команды используют API друг друга без жёсткой связки."},{"id":"cli/generator/generator::top::165","title":"Генератор","section":"Удалённая генерация","path":"/docs/guide/cli/generator/generator","headings":["Удалённая генерация"],"excerpt":"Удалённая генерация **Преимущества:** **Развязка разработки**: Команды развиваются независимо, используя версии API друг друга **Контроль версий**: Фиксация внешних API гарантирует стабильность **Меньше размер репозитори","content":"Удалённая генерация **Преимущества:** **Развязка разработки**: Команды развиваются независимо, используя версии API друг друга **Контроль версий**: Фиксация внешних API гарантирует стабильность **Меньше размер репозитория**: Нет необходимости в vendoring/submodule внешних proto **Автоматические обновления**: Легко перейти на новую версию по готовности"},{"id":"cli/generator/generator::top::166","title":"Генератор","section":"Удалённая генерация","path":"/docs/guide/cli/generator/generator","headings":["Удалённая генерация"],"excerpt":"Удалённая генерация **Рекомендации:** В продакшене используйте только тегированные версии В разработке можно тестировать latest, но в проде фиксируйте При наличии используйте семантическое версионирование Учитывайте сете","content":"Удалённая генерация **Рекомендации:** В продакшене используйте только тегированные версии В разработке можно тестировать latest, но в проде фиксируйте При наличии используйте семантическое версионирование Учитывайте сетевые ограничения в CI/CD"},{"id":"cli/generator/generator::proto::167","title":"Генератор","section":"Источники удалённых proto","path":"/docs/guide/cli/generator/generator#proto","headings":["Источники удалённых proto"],"excerpt":"Источники удалённых proto Генерация напрямую из удалённых репозиториев — полезно в микросервисной архитектуре, где разные команды владеют разными proto.","content":"Источники удалённых proto Генерация напрямую из удалённых репозиториев — полезно в микросервисной архитектуре, где разные команды владеют разными proto."},{"id":"cli/generator/generator::proto::168","title":"Генератор","section":"Источники удалённых proto","path":"/docs/guide/cli/generator/generator#proto","headings":["Источники удалённых proto"],"excerpt":"Источники удалённых proto **Типовой workflow:** Команда A публикует proto с версиями в Git Команда B добавляет их в свой easyp.yaml При генерации EasyP скачивает и подключает удалённые proto Сгенерированный код содержит ","content":"Источники удалённых proto **Типовой workflow:** Команда A публикует proto с версиями в Git Команда B добавляет их в свой easyp.yaml При генерации EasyP скачивает и подключает удалённые proto Сгенерированный код содержит клиентские библиотеки сервисов команды A"},{"id":"cli/generator/generator::proto::169","title":"Генератор","section":"Источники удалённых proto","path":"/docs/guide/cli/generator/generator#proto","headings":["Источники удалённых proto"],"excerpt":"Источники удалённых proto Практический пример объединения локальных и удалённых источников в одной конфигурации генерации:","content":"Источники удалённых proto Практический пример объединения локальных и удалённых источников в одной конфигурации генерации:"},{"id":"cli/generator/generator::top::170","title":"Генератор","section":"Сценарии использования удалённой генерации","path":"/docs/guide/cli/generator/generator","headings":["Сценарии использования удалённой генерации"],"excerpt":"Сценарии использования удалённой генерации Примеры ниже показывают реальные ситуации, где удалённая генерация даёт ощутимую выгоду.","content":"Сценарии использования удалённой генерации Примеры ниже показывают реальные ситуации, где удалённая генерация даёт ощутимую выгоду."},{"id":"cli/generator/generator::multi-team-development::171","title":"Генератор","section":"Много команд (Multi-Team Development)","path":"/docs/guide/cli/generator/generator#multi-team-development","headings":["Много команд (Multi-Team Development)"],"excerpt":"Много команд (Multi-Team Development) Мультикомандная разработка особенно выигрывает: вместо координации общих репозиториев и сложного управления зависимостями — независимая эволюция API с контролируемыми обновлениями че","content":"Много команд (Multi-Team Development) Мультикомандная разработка особенно выигрывает: вместо координации общих репозиториев и сложного управления зависимостями — независимая эволюция API с контролируемыми обновлениями через версии."},{"id":"cli/generator/generator::multi-team-development::172","title":"Генератор","section":"Много команд (Multi-Team Development)","path":"/docs/guide/cli/generator/generator#multi-team-development","headings":["Много команд (Multi-Team Development)"],"excerpt":"Много команд (Multi-Team Development) Паттерн ценен в крупных организациях, где: Команды имеют разные циклы релизов и скорости разработки Владение API определено, потребление — массовое Нужно избежать overhead от координ","content":"Много команд (Multi-Team Development) Паттерн ценен в крупных организациях, где: Команды имеют разные циклы релизов и скорости разработки Владение API определено, потребление — массовое Нужно избежать overhead от координации общих proto репозиториев Команды используют разные стеки, но должны взаимодействовать"},{"id":"cli/generator/generator::multi-team-development::173","title":"Генератор","section":"Много команд (Multi-Team Development)","path":"/docs/guide/cli/generator/generator#multi-team-development","headings":["Много команд (Multi-Team Development)"],"excerpt":"Много команд (Multi-Team Development)","content":"Много команд (Multi-Team Development)"},{"id":"cli/generator/generator::api::174","title":"Генератор","section":"Интеграция с API вендоров","path":"/docs/guide/cli/generator/generator#api","headings":["Интеграция с API вендоров"],"excerpt":"Интеграция с API вендоров Многие вендоры публикуют proto для своих API, позволяя генерировать типобезопасных клиентов вместо ручных HTTP реализаций. Это повышает типовую строгость, автоматизирует сериализацию и часто уск","content":"Интеграция с API вендоров Многие вендоры публикуют proto для своих API, позволяя генерировать типобезопасных клиентов вместо ручных HTTP реализаций. Это повышает типовую строгость, автоматизирует сериализацию и часто ускоряет работу."},{"id":"cli/generator/generator::api::175","title":"Генератор","section":"Интеграция с API вендоров","path":"/docs/guide/cli/generator/generator#api","headings":["Интеграция с API вендоров"],"excerpt":"Интеграция с API вендоров Преимущества использования proto от вендоров: **Type safety**: Проверка типов на этапе компиляции **Automatic updates**: Новые возможности приходят с обновлением версии **Consistency**: Единые п","content":"Интеграция с API вендоров Преимущества использования proto от вендоров: **Type safety**: Проверка типов на этапе компиляции **Automatic updates**: Новые возможности приходят с обновлением версии **Consistency**: Единые паттерны интерфейсов между интеграциями **Performance**: Бинарная сериализация быстрее JSON **Documentation**: Proto выступают источником истины для API"},{"id":"cli/generator/generator::top::176","title":"Генератор","section":"Команды","path":"/docs/guide/cli/generator/generator","headings":["Команды"],"excerpt":"Команды CLI EasyP предоставляет гибкие варианты запуска генерации с разными конфигурациями и окружениями.","content":"Команды CLI EasyP предоставляет гибкие варианты запуска генерации с разными конфигурациями и окружениями."},{"id":"cli/generator/generator::top::177","title":"Генератор","section":"Базовая генерация","path":"/docs/guide/cli/generator/generator","headings":["Базовая генерация"],"excerpt":"Базовая генерация Ниже наиболее часто применяемые варианты команд для разработки и продакшена:","content":"Базовая генерация Ниже наиболее часто применяемые варианты команд для разработки и продакшена:"},{"id":"cli/generator/generator::top::178","title":"Генератор","section":"Базовая генерация","path":"/docs/guide/cli/generator/generator","headings":["Базовая генерация"],"excerpt":"Базовая генерация ```bash Use default easyp.yaml configuration - Most common for development easyp generate","content":"Базовая генерация ```bash Use default easyp.yaml configuration - Most common for development easyp generate"},{"id":"cli/generator/generator::top::179","title":"Генератор","section":"Базовая генерация","path":"/docs/guide/cli/generator/generator","headings":["Базовая генерация"],"excerpt":"Базовая генерация Use custom configuration file - Essential for multi-environment setups easyp --cfg production.easyp.yaml generate","content":"Базовая генерация Use custom configuration file - Essential for multi-environment setups easyp --cfg production.easyp.yaml generate"},{"id":"cli/generator/generator::top::180","title":"Генератор","section":"Базовая генерация","path":"/docs/guide/cli/generator/generator","headings":["Базовая генерация"],"excerpt":"Базовая генерация Generate with debug logs - Helpful for debugging and CI/CD easyp --debug generate","content":"Базовая генерация Generate with debug logs - Helpful for debugging and CI/CD easyp --debug generate"},{"id":"cli/generator/generator::top::181","title":"Генератор","section":"Базовая генерация","path":"/docs/guide/cli/generator/generator","headings":["Базовая генерация"],"excerpt":"Базовая генерация Generate with custom cache location - Useful for CI systems or shared environments EASYPPATH=/tmp/easyp-cache easyp generate ```","content":"Базовая генерация Generate with custom cache location - Useful for CI systems or shared environments EASYPPATH=/tmp/easyp-cache easyp generate ```"},{"id":"cli/generator/generator::top::182","title":"Генератор","section":"Интеграция с менеджером пакетов","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с менеджером пакетов"],"excerpt":"Интеграция с менеджером пакетов Интеграция с менеджером пакетов позволяет либо явно управлять зависимостями, либо поручить это генератору. Явный путь даёт больше контроля, автоматический — больше удобства:","content":"Интеграция с менеджером пакетов Интеграция с менеджером пакетов позволяет либо явно управлять зависимостями, либо поручить это генератору. Явный путь даёт больше контроля, автоматический — больше удобства:"},{"id":"cli/generator/generator::top::183","title":"Генератор","section":"Интеграция с менеджером пакетов","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с менеджером пакетов"],"excerpt":"Интеграция с менеджером пакетов ```bash Explicit workflow - Better for CI/CD and when you want to cache dependencies easyp mod download # Download and cache dependencies first easyp generate # Generate code using cached ","content":"Интеграция с менеджером пакетов ```bash Explicit workflow - Better for CI/CD and when you want to cache dependencies easyp mod download # Download and cache dependencies first easyp generate # Generate code using cached dependencies"},{"id":"cli/generator/generator::top::184","title":"Генератор","section":"Интеграция с менеджером пакетов","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с менеджером пакетов"],"excerpt":"Интеграция с менеджером пакетов Automatic workflow - Convenient for development (generate downloads dependencies automatically) easyp generate ```","content":"Интеграция с менеджером пакетов Automatic workflow - Convenient for development (generate downloads dependencies automatically) easyp generate ```"},{"id":"cli/generator/generator::advanced-usage::185","title":"Генератор","section":"Расширенное использование (Advanced Usage)","path":"/docs/guide/cli/generator/generator#advanced-usage","headings":["Расширенное использование (Advanced Usage)"],"excerpt":"Расширенное использование (Advanced Usage) Эти варианты полезны для специфических сценариев деплоя, отладки или когда нужен более тонкий контроль процесса генерации:","content":"Расширенное использование (Advanced Usage) Эти варианты полезны для специфических сценариев деплоя, отладки или когда нужен более тонкий контроль процесса генерации:"},{"id":"cli/generator/generator::advanced-usage::186","title":"Генератор","section":"Расширенное использование (Advanced Usage)","path":"/docs/guide/cli/generator/generator#advanced-usage","headings":["Расширенное использование (Advanced Usage)"],"excerpt":"Расширенное использование (Advanced Usage) ```bash Генерация из конкретной директории (перекрывает настройку в файле конфигурации) easyp generate --path=./api/proto","content":"Расширенное использование (Advanced Usage) ```bash Генерация из конкретной директории (перекрывает настройку в файле конфигурации) easyp generate --path=./api/proto"},{"id":"cli/generator/generator::advanced-usage::187","title":"Генератор","section":"Расширенное использование (Advanced Usage)","path":"/docs/guide/cli/generator/generator#advanced-usage","headings":["Расширенное использование (Advanced Usage)"],"excerpt":"Расширенное использование (Advanced Usage) Генерация с vendored зависимостями (оффлайн / Docker контейнеры) easyp mod vendor easyp generate","content":"Расширенное использование (Advanced Usage) Генерация с vendored зависимостями (оффлайн / Docker контейнеры) easyp mod vendor easyp generate"},{"id":"cli/generator/generator::advanced-usage::188","title":"Генератор","section":"Расширенное использование (Advanced Usage)","path":"/docs/guide/cli/generator/generator#advanced-usage","headings":["Расширенное использование (Advanced Usage)"],"excerpt":"Расширенное использование (Advanced Usage) Генерация из кастомного project root (удобно для монореп и вложенных рабочих директорий) easyp generate --root=/usr/local/src/my-project --path=./api/proto ```","content":"Расширенное использование (Advanced Usage) Генерация из кастомного project root (удобно для монореп и вложенных рабочих директорий) easyp generate --root=/usr/local/src/my-project --path=./api/proto ```"},{"id":"cli/generator/generator::common-patterns::189","title":"Генератор","section":"Типовые паттерны (Common Patterns)","path":"/docs/guide/cli/generator/generator#common-patterns","headings":["Типовые паттерны (Common Patterns)"],"excerpt":"Типовые паттерны (Common Patterns) Эти схемы отражают реальные сценарии и лучшие практики организации генерации кода в разных структурах проектов.","content":"Типовые паттерны (Common Patterns) Эти схемы отражают реальные сценарии и лучшие практики организации генерации кода в разных структурах проектов."},{"id":"cli/generator/generator::multi-language-generation::190","title":"Генератор","section":"Мульти-языковая генерация (Multi-Language Generation)","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Мульти-языковая генерация (Multi-Language Generation)"],"excerpt":"Мульти-языковая генерация (Multi-Language Generation) Мульти-языковая генерация критична для компаний, использующих разные технологии в стеке. EasyP облегчает получение согласованных клиентских библиотек и типов для неск","content":"Мульти-языковая генерация (Multi-Language Generation) Мульти-языковая генерация критична для компаний, использующих разные технологии в стеке. EasyP облегчает получение согласованных клиентских библиотек и типов для нескольких языков из одного источника proto."},{"id":"cli/generator/generator::multi-language-generation::191","title":"Генератор","section":"Мульти-языковая генерация (Multi-Language Generation)","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Мульти-языковая генерация (Multi-Language Generation)"],"excerpt":"Мульти-языковая генерация (Multi-Language Generation) **Типовые сценарии:** **Full‑stack приложения**: backend на Go/Java + фронтенд на TypeScript **Платформы данных**: сервисы на Go + аналитика / ML на Python **Микросер","content":"Мульти-языковая генерация (Multi-Language Generation) **Типовые сценарии:** **Full‑stack приложения**: backend на Go/Java + фронтенд на TypeScript **Платформы данных**: сервисы на Go + аналитика / ML на Python **Микросервисы**: каждый сервис — оптимальный язык под задачу **Внешние SDK**: предоставление клиентских библиотек партнёрам **Интеграция с легаси**: современные gRPC сервисы + старые системы"},{"id":"cli/generator/generator::multi-language-generation::192","title":"Генератор","section":"Мульти-языковая генерация (Multi-Language Generation)","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Мульти-языковая генерация (Multi-Language Generation)"],"excerpt":"Мульти-языковая генерация (Multi-Language Generation) **Производительность:** Каждый плагин запускается отдельно — время растёт линейно от количества плагинов Для больших наборов используйте параллельный запуск (make -j4","content":"Мульти-языковая генерация (Multi-Language Generation) **Производительность:** Каждый плагин запускается отдельно — время растёт линейно от количества плагинов Для больших наборов используйте параллельный запуск (make -j4) Структурируйте выходные директории иерархически — меньше конфликтов Плагины имеют разную скорость — профилируйте сборку для поиска узких мест"},{"id":"cli/generator/generator::multi-language-generation::193","title":"Генератор","section":"Мульти-языковая генерация (Multi-Language Generation)","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Мульти-языковая генерация (Multi-Language Generation)"],"excerpt":"Мульти-языковая генерация (Multi-Language Generation) **Преимущества сопровождения:** Единый источник истины для API снижает риск расхождения схем Согласованные типы уменьшают интеграционные баги Автоматическая синхрониз","content":"Мульти-языковая генерация (Multi-Language Generation) **Преимущества сопровождения:** Единый источник истины для API снижает риск расхождения схем Согласованные типы уменьшают интеграционные баги Автоматическая синхронизация при изменении proto исключает ручные правки Меньше риска дрейфа API между реализациями на разных языках Рефакторинг упрощается — изменения транзитивно отражаются во всех артефактах"},{"id":"cli/generator/generator::multi-language-generation::194","title":"Генератор","section":"Мульти-языковая генерация (Multi-Language Generation)","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Мульти-языковая генерация (Multi-Language Generation)"],"excerpt":"Мульти-языковая генерация (Multi-Language Generation) Ниже пример типичной мульти-языковой конфигурации для full‑stack приложения: backend, веб‑клиент, аналитика и документация:","content":"Мульти-языковая генерация (Multi-Language Generation) Ниже пример типичной мульти-языковой конфигурации для full‑stack приложения: backend, веб‑клиент, аналитика и документация:"},{"id":"cli/generator/generator::multi-language-generation::195","title":"Генератор","section":"Мульти-языковая генерация (Multi-Language Generation)","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Мульти-языковая генерация (Multi-Language Generation)"],"excerpt":"Мульти-языковая генерация (Multi-Language Generation)","content":"Мульти-языковая генерация (Multi-Language Generation)"},{"id":"cli/generator/generator::multi-language-generation::196","title":"Генератор","section":"Мульти-языковая генерация (Multi-Language Generation)","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Мульти-языковая генерация (Multi-Language Generation)"],"excerpt":"Мульти-языковая генерация (Multi-Language Generation) **Совет по организации:** Используйте отдельные выходные директории для каждого языка, чтобы избежать конфликтов файлов и упростить интеграцию с языковыми сборочными ","content":"Мульти-языковая генерация (Multi-Language Generation) **Совет по организации:** Используйте отдельные выходные директории для каждого языка, чтобы избежать конфликтов файлов и упростить интеграцию с языковыми сборочными системами."},{"id":"cli/generator/generator::multi-language-generation::197","title":"Генератор","section":"Мульти-языковая генерация (Multi-Language Generation)","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Мульти-языковая генерация (Multi-Language Generation)"],"excerpt":"Мульти-языковая генерация (Multi-Language Generation) Генератор EasyP — комплексное решение для генерации кода из Protocol Buffers: от простой локальной разработки до сложных enterprise‑сценариев с удалёнными зависимостя","content":"Мульти-языковая генерация (Multi-Language Generation) Генератор EasyP — комплексное решение для генерации кода из Protocol Buffers: от простой локальной разработки до сложных enterprise‑сценариев с удалёнными зависимостями и мульти-языковым выводом."},{"id":"cli/linter/linter::proto::0","title":"Линтер","section":"Зачем нужен линтер для proto файлов?","path":"/docs/guide/cli/linter/linter#proto","headings":["Зачем нужен линтер для proto файлов?"],"excerpt":"Зачем нужен линтер для proto файлов? Линтеры играют ключевую роль в современной разработке, особенно когда речь о .proto файлах. Они обеспечивают единый стиль и структуру, помогают находить потенциальные ошибки на ранних","content":"Зачем нужен линтер для proto файлов? Линтеры играют ключевую роль в современной разработке, особенно когда речь о .proto файлах. Они обеспечивают единый стиль и структуру, помогают находить потенциальные ошибки на ранних этапах и поддерживают читаемость кода. Это даёт выгоды:"},{"id":"cli/linter/linter::proto::1","title":"Линтер","section":"Зачем нужен линтер для proto файлов?","path":"/docs/guide/cli/linter/linter#proto","headings":["Зачем нужен линтер для proto файлов?"],"excerpt":"Зачем нужен линтер для proto файлов? **Снижение затрат на разработку:** Ошибки ловятся раньше, меньше времени на отладку. **Улучшение командного взаимодействия:** Единообразный код легче понимать и сопровождать. **Бизнес","content":"Зачем нужен линтер для proto файлов? **Снижение затрат на разработку:** Ошибки ловятся раньше, меньше времени на отладку. **Улучшение командного взаимодействия:** Единообразный код легче понимать и сопровождать. **Бизнес-эффективность:** Более качественный код → меньше инцидентов в проде → ниже стоимость поддержки."},{"id":"cli/linter/linter::top::2","title":"Линтер","section":"Справочник по конфигурации","path":"/docs/guide/cli/linter/linter","headings":["Справочник по конфигурации"],"excerpt":"Справочник по конфигурации Конфигурация линтера настраивается в секции lint файла easyp.yaml.","content":"Справочник по конфигурации Конфигурация линтера настраивается в секции lint файла easyp.yaml."},{"id":"cli/linter/linter::use-string::3","title":"Линтер","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) Определяет набор правил или категорий для включения. Можно смешивать категории и конкретные правила.","content":"use ([]string) Определяет набор правил или категорий для включения. Можно смешивать категории и конкретные правила."},{"id":"cli/linter/linter::use-string::4","title":"Линтер","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) **Категории:** **MINIMAL**: Базовая согласованность пакетов **BASIC**: Соглашения по именованию и структуре **DEFAULT**: Рекомендованные правила для большинства проектов **COMMENTS**: Требования к коммента","content":"use ([]string) **Категории:** **MINIMAL**: Базовая согласованность пакетов **BASIC**: Соглашения по именованию и структуре **DEFAULT**: Рекомендованные правила для большинства проектов **COMMENTS**: Требования к комментариям **UNARY_RPC**: Ограничение на streaming RPC"},{"id":"cli/linter/linter::use-string::5","title":"Линтер","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) **Индивидуальные правила:** Любое имя правила (например ENUM_PASCAL_CASE, FIELD_LOWER_SNAKE_CASE)","content":"use ([]string) **Индивидуальные правила:** Любое имя правила (например ENUM_PASCAL_CASE, FIELD_LOWER_SNAKE_CASE)"},{"id":"cli/linter/linter::use-string::6","title":"Линтер","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) **Примеры:** ```yaml Только категории use: [MINIMAL, BASIC, DEFAULT]","content":"use ([]string) **Примеры:** ```yaml Только категории use: [MINIMAL, BASIC, DEFAULT]"},{"id":"cli/linter/linter::use-string::7","title":"Линтер","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) Смешивание use: - MINIMAL - COMMENT_SERVICE - COMMENT_RPC - ENUM_PASCAL_CASE","content":"use ([]string) Смешивание use: - MINIMAL - COMMENT_SERVICE - COMMENT_RPC - ENUM_PASCAL_CASE"},{"id":"cli/linter/linter::use-string::8","title":"Линтер","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) Точный набор use: - PACKAGE_DEFINED - SERVICE_PASCAL_CASE - FIELD_LOWER_SNAKE_CASE ```","content":"use ([]string) Точный набор use: - PACKAGE_DEFINED - SERVICE_PASCAL_CASE - FIELD_LOWER_SNAKE_CASE ```"},{"id":"cli/linter/linter::enum_zero_value_suffix-string::9","title":"Линтер","section":"enum_zero_value_suffix (string)","path":"/docs/guide/cli/linter/linter#enum_zero_value_suffix-string","headings":["enum_zero_value_suffix (string)"],"excerpt":"enum_zero_value_suffix (string) Обязывает нулевое значение enum иметь заданный суффикс.","content":"enum_zero_value_suffix (string) Обязывает нулевое значение enum иметь заданный суффикс."},{"id":"cli/linter/linter::enum_zero_value_suffix-string::10","title":"Линтер","section":"enum_zero_value_suffix (string)","path":"/docs/guide/cli/linter/linter#enum_zero_value_suffix-string","headings":["enum_zero_value_suffix (string)"],"excerpt":"enum_zero_value_suffix (string) **Обычно:** \"UNSPECIFIED\", \"UNKNOWN\", \"DEFAULT\"","content":"enum_zero_value_suffix (string) **Обычно:** \"UNSPECIFIED\", \"UNKNOWN\", \"DEFAULT\""},{"id":"cli/linter/linter::enum_zero_value_suffix-string::11","title":"Линтер","section":"enum_zero_value_suffix (string)","path":"/docs/guide/cli/linter/linter#enum_zero_value_suffix-string","headings":["enum_zero_value_suffix (string)"],"excerpt":"enum_zero_value_suffix (string)","content":"enum_zero_value_suffix (string)"},{"id":"cli/linter/linter::service_suffix-string::12","title":"Линтер","section":"service_suffix (string)","path":"/docs/guide/cli/linter/linter#service_suffix-string","headings":["service_suffix (string)"],"excerpt":"service_suffix (string) Требуемый суффикс для имён сервисов (унификация стиля).","content":"service_suffix (string) Требуемый суффикс для имён сервисов (унификация стиля)."},{"id":"cli/linter/linter::ignore-string::13","title":"Линтер","section":"ignore ([]string)","path":"/docs/guide/cli/linter/linter#ignore-string","headings":["ignore ([]string)"],"excerpt":"ignore ([]string) Полное исключение путей из линтинга.","content":"ignore ([]string) Полное исключение путей из линтинга."},{"id":"cli/linter/linter::ignore-string::14","title":"Линтер","section":"ignore ([]string)","path":"/docs/guide/cli/linter/linter#ignore-string","headings":["ignore ([]string)"],"excerpt":"ignore ([]string) **Use cases:** vendor / third_party сгенерированные файлы легаси подпакеты тестовые фикстуры","content":"ignore ([]string) **Use cases:** vendor / third_party сгенерированные файлы легаси подпакеты тестовые фикстуры"},{"id":"cli/linter/linter::except-string::15","title":"Линтер","section":"except ([]string)","path":"/docs/guide/cli/linter/linter#except-string","headings":["except ([]string)"],"excerpt":"except ([]string) Глобально отключает правила.","content":"except ([]string) Глобально отключает правила."},{"id":"cli/linter/linter::allow_comment_ignores-bool::16","title":"Линтер","section":"allow_comment_ignores (bool)","path":"/docs/guide/cli/linter/linter#allow_comment_ignores-bool","headings":["allow_comment_ignores (bool)"],"excerpt":"allow_comment_ignores (bool) Разрешает инлайн‑игнор правил комментариями.","content":"allow_comment_ignores (bool) Разрешает инлайн‑игнор правил комментариями."},{"id":"cli/linter/linter::ignore_only-mapstringstring::17","title":"Линтер","section":"ignore_only (map[string][]string)","path":"/docs/guide/cli/linter/linter#ignore_only-mapstringstring","headings":["ignore_only (map[string][]string)"],"excerpt":"ignore_only (mapstringstring) Таргетированное игнорирование конкретных правил для указанных путей.","content":"ignore_only (mapstringstring) Таргетированное игнорирование конкретных правил для указанных путей."},{"id":"cli/linter/linter::top::18","title":"Линтер","section":"Игнор правил комментариями","path":"/docs/guide/cli/linter/linter","headings":["Игнор правил комментариями"],"excerpt":"Игнор правил комментариями Если включён allow_comment_ignores, можно точечно отключать правила.","content":"Игнор правил комментариями Если включён allow_comment_ignores, можно точечно отключать правила."},{"id":"cli/linter/linter::top::19","title":"Линтер","section":"Несколько правил в одной строке","path":"/docs/guide/cli/linter/linter","headings":["Несколько правил в одной строке"],"excerpt":"Несколько правил в одной строке","content":"Несколько правил в одной строке"},{"id":"cli/linter/linter::top::20","title":"Линтер","section":"Используйте редко","path":"/docs/guide/cli/linter/linter","headings":["Используйте редко"],"excerpt":"Используйте редко Частое игнорирование = сигнал пересмотреть конфигурацию.","content":"Используйте редко Частое игнорирование = сигнал пересмотреть конфигурацию."},{"id":"cli/linter/linter::top::21","title":"Линтер","section":"Предпочитайте конфигурацию","path":"/docs/guide/cli/linter/linter","headings":["Предпочитайте конфигурацию"],"excerpt":"Предпочитайте конфигурацию Если нужно игнорировать правило в группе файлов — используйте ignore_only.","content":"Предпочитайте конфигурацию Если нужно игнорировать правило в группе файлов — используйте ignore_only."},{"id":"cli/linter/linter::top::22","title":"Линтер","section":"Категории линтера","path":"/docs/guide/cli/linter/linter","headings":["Категории линтера"],"excerpt":"Категории линтера Категории помогают быстро выбрать уровень строгости.","content":"Категории линтера Категории помогают быстро выбрать уровень строгости."},{"id":"cli/linter/linter::top::23","title":"Линтер","section":"Категории линтера","path":"/docs/guide/cli/linter/linter","headings":["Категории линтера"],"excerpt":"Категории линтера **Когда использовать:** **MINIMAL**: Минимальная базовая целостность **BASIC**: Частые соглашения имен **DEFAULT**: Дополнительные проверки качества **COMMENTS**: Обязательные комментарии (API, команды)","content":"Категории линтера **Когда использовать:** **MINIMAL**: Минимальная базовая целостность **BASIC**: Частые соглашения имен **DEFAULT**: Дополнительные проверки качества **COMMENTS**: Обязательные комментарии (API, команды) **UNARY_RPC**: Ограничить streaming RPC"},{"id":"cli/linter/linter::minimal::24","title":"Линтер","section":"MINIMAL","path":"/docs/guide/cli/linter/linter#minimal","headings":["MINIMAL"],"excerpt":"MINIMAL DIRECTORY_SAME_PACKAGE PACKAGE_DEFINED PACKAGE_DIRECTORY_MATCH PACKAGE_SAME_DIRECTORY","content":"MINIMAL DIRECTORY_SAME_PACKAGE PACKAGE_DEFINED PACKAGE_DIRECTORY_MATCH PACKAGE_SAME_DIRECTORY"},{"id":"cli/linter/linter::basic::25","title":"Линтер","section":"BASIC","path":"/docs/guide/cli/linter/linter#basic","headings":["BASIC"],"excerpt":"BASIC ENUM_FIRST_VALUE_ZERO ENUM_NO_ALLOW_ALIAS ENUM_PASCAL_CASE ENUM_VALUE_UPPER_SNAKE_CASE FIELD_LOWER_SNAKE_CASE IMPORT_NO_PUBLIC IMPORT_NO_WEAK IMPORT_USED MESSAGE_PASCAL_CASE ONEOF_LOWER_SNAKE_CASE PACKAGE_LOWER_SNA","content":"BASIC ENUM_FIRST_VALUE_ZERO ENUM_NO_ALLOW_ALIAS ENUM_PASCAL_CASE ENUM_VALUE_UPPER_SNAKE_CASE FIELD_LOWER_SNAKE_CASE IMPORT_NO_PUBLIC IMPORT_NO_WEAK IMPORT_USED MESSAGE_PASCAL_CASE ONEOF_LOWER_SNAKE_CASE PACKAGE_LOWER_SNAKE_CASE PACKAGE_SAME_CSHARP_NAMESPACE PACKAGE_SAME_GO_PACKAGE PACKAGE_SAME_JAVA_MULTIPLE_FILES PACKAGE_SAME_JAVA_PACKAGE PACKAGE_SAME_PHP_NAMESPACE PACKAGE_SAME_RUBY_PACKAGE PACKAGE_SAME_SWIFT_PREFIX RPC_PASCAL_CASE SERVICE_PASCAL_CASE"},{"id":"cli/linter/linter::default::26","title":"Линтер","section":"DEFAULT","path":"/docs/guide/cli/linter/linter#default","headings":["DEFAULT"],"excerpt":"DEFAULT ENUM_VALUE_PREFIX ENUM_ZERO_VALUE_SUFFIX FILE_LOWER_SNAKE_CASE RPC_REQUEST_RESPONSE_UNIQUE RPC_REQUEST_STANDARD_NAME RPC_RESPONSE_STANDARD_NAME PACKAGE_VERSION_SUFFIX SERVICE_SUFFIX","content":"DEFAULT ENUM_VALUE_PREFIX ENUM_ZERO_VALUE_SUFFIX FILE_LOWER_SNAKE_CASE RPC_REQUEST_RESPONSE_UNIQUE RPC_REQUEST_STANDARD_NAME RPC_RESPONSE_STANDARD_NAME PACKAGE_VERSION_SUFFIX SERVICE_SUFFIX"},{"id":"cli/linter/linter::comments::27","title":"Линтер","section":"COMMENTS","path":"/docs/guide/cli/linter/linter#comments","headings":["COMMENTS"],"excerpt":"COMMENTS COMMENT_ENUM COMMENT_ENUM_VALUE COMMENT_FIELD COMMENT_MESSAGE COMMENT_ONEOF COMMENT_RPC COMMENT_SERVICE","content":"COMMENTS COMMENT_ENUM COMMENT_ENUM_VALUE COMMENT_FIELD COMMENT_MESSAGE COMMENT_ONEOF COMMENT_RPC COMMENT_SERVICE"},{"id":"cli/linter/linter::unary_rpc::28","title":"Линтер","section":"UNARY_RPC","path":"/docs/guide/cli/linter/linter#unary_rpc","headings":["UNARY_RPC"],"excerpt":"UNARY_RPC RPC_NO_CLIENT_STREAMING RPC_NO_SERVER_STREAMING","content":"UNARY_RPC RPC_NO_CLIENT_STREAMING RPC_NO_SERVER_STREAMING"},{"id":"cli/linter/linter::top::29","title":"Линтер","section":"Заключение","path":"/docs/guide/cli/linter/linter","headings":["Заключение"],"excerpt":"Заключение Внедрение EasyP линдера для ваших proto файлов заметно улучшит workflow, качество и поддерживаемость кода. Полная совместимость с Buf позволяет командам мигрировать без боли, используя гибкую конфигурацию и мо","content":"Заключение Внедрение EasyP линдера для ваших proto файлов заметно улучшит workflow, качество и поддерживаемость кода. Полная совместимость с Buf позволяет командам мигрировать без боли, используя гибкую конфигурацию и мощные возможности из коробки."},{"id":"cli/linter/rules/comment-enum-value::top::0","title":"COMMENT_ENUM_VALUE","path":"/docs/guide/cli/linter/rules/comment-enum-value","headings":[],"excerpt":"Это правило проверяет, что все значения enum имеют комментарий.","content":"Это правило проверяет, что все значения enum имеют комментарий."},{"id":"cli/linter/rules/comment-enum-value::bad::1","title":"COMMENT_ENUM_VALUE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-enum-value#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-enum-value::bad::2","title":"COMMENT_ENUM_VALUE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-enum-value#bad","headings":["Bad"],"excerpt":"Bad enum Foo { BAR = 0; BAZ = 1; } ```","content":"Bad enum Foo { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/comment-enum-value::good::3","title":"COMMENT_ENUM_VALUE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-enum-value#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-enum-value::good::4","title":"COMMENT_ENUM_VALUE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-enum-value#good","headings":["Good"],"excerpt":"Good enum Foo { // BAR value for bar logic // [!code focus] BAR = 0; // BAZ value for baz logic // [!code focus] BAZ = 1; } ```","content":"Good enum Foo { // BAR value for bar logic // [!code focus] BAR = 0; // BAZ value for baz logic // [!code focus] BAZ = 1; } ```"},{"id":"cli/linter/rules/comment-enum::top::0","title":"COMMENT_ENUM","path":"/docs/guide/cli/linter/rules/comment-enum","headings":[],"excerpt":"Это правило проверяет, что enum имеет комментарий.","content":"Это правило проверяет, что enum имеет комментарий."},{"id":"cli/linter/rules/comment-enum::bad::1","title":"COMMENT_ENUM","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-enum#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-enum::bad::2","title":"COMMENT_ENUM","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-enum#bad","headings":["Bad"],"excerpt":"Bad enum Foo { BAR = 0; BAZ = 1; } ```","content":"Bad enum Foo { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/comment-enum::good::3","title":"COMMENT_ENUM","section":"Good","path":"/docs/guide/cli/linter/rules/comment-enum#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-enum::good::4","title":"COMMENT_ENUM","section":"Good","path":"/docs/guide/cli/linter/rules/comment-enum#good","headings":["Good"],"excerpt":"Good // Foo enum for bar and baz logic // [!code focus] enum Foo { BAR = 0; BAZ = 1; } ```","content":"Good // Foo enum for bar and baz logic // [!code focus] enum Foo { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/comment-field::top::0","title":"COMMENT_FIELD","path":"/docs/guide/cli/linter/rules/comment-field","headings":[],"excerpt":"Это правило проверяет, что все поля сообщений имеют комментарий.","content":"Это правило проверяет, что все поля сообщений имеют комментарий."},{"id":"cli/linter/rules/comment-field::bad::1","title":"COMMENT_FIELD","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-field#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-field::bad::2","title":"COMMENT_FIELD","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-field#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; string baz = 2; } ```","content":"Bad message Foo { string bar = 1; string baz = 2; } ```"},{"id":"cli/linter/rules/comment-field::good::3","title":"COMMENT_FIELD","section":"Good","path":"/docs/guide/cli/linter/rules/comment-field#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-field::good::4","title":"COMMENT_FIELD","section":"Good","path":"/docs/guide/cli/linter/rules/comment-field#good","headings":["Good"],"excerpt":"Good message Foo { // bar field for bar logic // [!code focus] string bar = 1; // baz field for baz logic // [!code focus] string baz = 2; } ```","content":"Good message Foo { // bar field for bar logic // [!code focus] string bar = 1; // baz field for baz logic // [!code focus] string baz = 2; } ```"},{"id":"cli/linter/rules/comment-message::top::0","title":"COMMENT_MESSAGE","path":"/docs/guide/cli/linter/rules/comment-message","headings":[],"excerpt":"Это правило проверяет, что message имеет комментарий.","content":"Это правило проверяет, что message имеет комментарий."},{"id":"cli/linter/rules/comment-message::bad::1","title":"COMMENT_MESSAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-message#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-message::bad::2","title":"COMMENT_MESSAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-message#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; string baz = 2; } ```","content":"Bad message Foo { string bar = 1; string baz = 2; } ```"},{"id":"cli/linter/rules/comment-message::good::3","title":"COMMENT_MESSAGE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-message#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-message::good::4","title":"COMMENT_MESSAGE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-message#good","headings":["Good"],"excerpt":"Good // Foo message for bar and baz logic // [!code focus] message Foo { // bar field for bar logic string bar = 1; // baz field for baz logic string baz = 2; } ```","content":"Good // Foo message for bar and baz logic // [!code focus] message Foo { // bar field for bar logic string bar = 1; // baz field for baz logic string baz = 2; } ```"},{"id":"cli/linter/rules/comment-oneof::top::0","title":"COMMENT_ONEOF","path":"/docs/guide/cli/linter/rules/comment-oneof","headings":[],"excerpt":"Это правило проверяет, что oneof имеет комментарий.","content":"Это правило проверяет, что oneof имеет комментарий."},{"id":"cli/linter/rules/comment-oneof::bad::1","title":"COMMENT_ONEOF","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-oneof#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-oneof::bad::2","title":"COMMENT_ONEOF","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-oneof#bad","headings":["Bad"],"excerpt":"Bad message Foo { oneof bar { string baz = 1; string qux = 2; } } ```","content":"Bad message Foo { oneof bar { string baz = 1; string qux = 2; } } ```"},{"id":"cli/linter/rules/comment-oneof::good::3","title":"COMMENT_ONEOF","section":"Good","path":"/docs/guide/cli/linter/rules/comment-oneof#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-oneof::good::4","title":"COMMENT_ONEOF","section":"Good","path":"/docs/guide/cli/linter/rules/comment-oneof#good","headings":["Good"],"excerpt":"Good message Foo { // bar oneof for baz and qux logic // [!code focus] oneof bar { string baz = 1; string qux = 2; } } ```","content":"Good message Foo { // bar oneof for baz and qux logic // [!code focus] oneof bar { string baz = 1; string qux = 2; } } ```"},{"id":"cli/linter/rules/comment-rpc::top::0","title":"COMMENT_RPC","path":"/docs/guide/cli/linter/rules/comment-rpc","headings":[],"excerpt":"This rule checks that rpc has a comment.","content":"This rule checks that rpc has a comment."},{"id":"cli/linter/rules/comment-rpc::bad::1","title":"COMMENT_RPC","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-rpc#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-rpc::bad::2","title":"COMMENT_RPC","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-rpc#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar (BarRequest) returns (BarResponse) {} rpc Baz (BazRequest) returns (BazResponse) {} } ```","content":"Bad service Foo { rpc Bar (BarRequest) returns (BarResponse) {} rpc Baz (BazRequest) returns (BazResponse) {} } ```"},{"id":"cli/linter/rules/comment-rpc::good::3","title":"COMMENT_RPC","section":"Good","path":"/docs/guide/cli/linter/rules/comment-rpc#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-rpc::good::4","title":"COMMENT_RPC","section":"Good","path":"/docs/guide/cli/linter/rules/comment-rpc#good","headings":["Good"],"excerpt":"Good service Foo { // Bar rpc for bar logic // [!code focus] rpc Bar (BarRequest) returns (BarResponse) {} // Baz rpc for baz logic // [!code focus] rpc Baz (BazRequest) returns (BazResponse) {} } ```","content":"Good service Foo { // Bar rpc for bar logic // [!code focus] rpc Bar (BarRequest) returns (BarResponse) {} // Baz rpc for baz logic // [!code focus] rpc Baz (BazRequest) returns (BazResponse) {} } ```"},{"id":"cli/linter/rules/comment-service::top::0","title":"COMMENT_SERVICE","path":"/docs/guide/cli/linter/rules/comment-service","headings":[],"excerpt":"Это правило проверяет, что сервис имеет комментарий.","content":"Это правило проверяет, что сервис имеет комментарий."},{"id":"cli/linter/rules/comment-service::bad::1","title":"COMMENT_SERVICE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-service#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-service::bad::2","title":"COMMENT_SERVICE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-service#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar (BarRequest) returns (BarResponse) {} } ```","content":"Bad service Foo { rpc Bar (BarRequest) returns (BarResponse) {} } ```"},{"id":"cli/linter/rules/comment-service::good::3","title":"COMMENT_SERVICE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-service#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-service::good::4","title":"COMMENT_SERVICE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-service#good","headings":["Good"],"excerpt":"Good // Foo service for bar logic // [!code focus] service Foo { // Bar rpc for bar logic rpc Bar (BarRequest) returns (BarResponse) {} } ```","content":"Good // Foo service for bar logic // [!code focus] service Foo { // Bar rpc for bar logic rpc Bar (BarRequest) returns (BarResponse) {} } ```"},{"id":"cli/linter/rules/directory-same-package::top::0","title":"DIRECTORY_SAME_PACKAGE","path":"/docs/guide/cli/linter/rules/directory-same-package","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/directory-same-package::top::1","title":"DIRECTORY_SAME_PACKAGE","path":"/docs/guide/cli/linter/rules/directory-same-package","headings":[],"excerpt":"Это правило проверяет, что все файлы в заданной директории находятся в одном и том же package.","content":"Это правило проверяет, что все файлы в заданной директории находятся в одном и том же package."},{"id":"cli/linter/rules/directory-same-package::bad::2","title":"DIRECTORY_SAME_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/directory-same-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: dir/foo.proto","content":"Bad ```proto // File: dir/foo.proto"},{"id":"cli/linter/rules/directory-same-package::bad::3","title":"DIRECTORY_SAME_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/directory-same-package#bad","headings":["Bad"],"excerpt":"Bad syntax = \"proto3\"; package foo;","content":"Bad syntax = \"proto3\"; package foo;"},{"id":"cli/linter/rules/directory-same-package::bad::4","title":"DIRECTORY_SAME_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/directory-same-package#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; } ```","content":"Bad message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/directory-same-package::good::5","title":"DIRECTORY_SAME_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/directory-same-package#good","headings":["Good"],"excerpt":"Good ```proto // File: dir/foo/foo.proto // [!code focus]","content":"Good ```proto // File: dir/foo/foo.proto // [!code focus]"},{"id":"cli/linter/rules/directory-same-package::good::6","title":"DIRECTORY_SAME_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/directory-same-package#good","headings":["Good"],"excerpt":"Good package dir.foo; // [!code focus]","content":"Good package dir.foo; // [!code focus]"},{"id":"cli/linter/rules/directory-same-package::good::7","title":"DIRECTORY_SAME_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/directory-same-package#good","headings":["Good"],"excerpt":"Good message Foo { string bar = 1; } ```","content":"Good message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/enum-first-value-zero::top::0","title":"ENUM_FIRST_VALUE_ZERO","path":"/docs/guide/cli/linter/rules/enum-first-value-zero","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-first-value-zero::top::1","title":"ENUM_FIRST_VALUE_ZERO","path":"/docs/guide/cli/linter/rules/enum-first-value-zero","headings":[],"excerpt":"Это правило проверяет, что первое значение enum равно нулю.","content":"Это правило проверяет, что первое значение enum равно нулю."},{"id":"cli/linter/rules/enum-first-value-zero::bad::2","title":"ENUM_FIRST_VALUE_ZERO","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-first-value-zero#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-first-value-zero::bad::3","title":"ENUM_FIRST_VALUE_ZERO","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-first-value-zero#bad","headings":["Bad"],"excerpt":"Bad enum Foo { BAR = 1; BAZ = 2; } ```","content":"Bad enum Foo { BAR = 1; BAZ = 2; } ```"},{"id":"cli/linter/rules/enum-first-value-zero::good::4","title":"ENUM_FIRST_VALUE_ZERO","section":"Good","path":"/docs/guide/cli/linter/rules/enum-first-value-zero#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-first-value-zero::good::5","title":"ENUM_FIRST_VALUE_ZERO","section":"Good","path":"/docs/guide/cli/linter/rules/enum-first-value-zero#good","headings":["Good"],"excerpt":"Good enum Foo { BAR = 0; // [!code focus] BAZ = 1; } ```","content":"Good enum Foo { BAR = 0; // [!code focus] BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-no-allow-alias::top::0","title":"ENUM_NO_ALLOW_ALIAS","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-no-allow-alias::top::1","title":"ENUM_NO_ALLOW_ALIAS","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias","headings":[],"excerpt":"Это правило проверяет, что опция allow_alias не установлена в значение true внутри enum.","content":"Это правило проверяет, что опция allow_alias не установлена в значение true внутри enum."},{"id":"cli/linter/rules/enum-no-allow-alias::bad::2","title":"ENUM_NO_ALLOW_ALIAS","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-no-allow-alias::bad::3","title":"ENUM_NO_ALLOW_ALIAS","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias#bad","headings":["Bad"],"excerpt":"Bad enum Foo { option allow_alias = true; // [!code focus] BAR = 0; BAZ = 1; } ```","content":"Bad enum Foo { option allow_alias = true; // [!code focus] BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-no-allow-alias::good::4","title":"ENUM_NO_ALLOW_ALIAS","section":"Good","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-no-allow-alias::good::5","title":"ENUM_NO_ALLOW_ALIAS","section":"Good","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias#good","headings":["Good"],"excerpt":"Good enum Foo { BAR = 0; BAZ = 1; } ```","content":"Good enum Foo { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-pascal-case::top::0","title":"ENUM_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/enum-pascal-case","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-pascal-case::top::1","title":"ENUM_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/enum-pascal-case","headings":[],"excerpt":"Это правило проверяет, что имена enum написаны в стиле PascalCase.","content":"Это правило проверяет, что имена enum написаны в стиле PascalCase."},{"id":"cli/linter/rules/enum-pascal-case::bad::2","title":"ENUM_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-pascal-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-pascal-case::bad::3","title":"ENUM_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-pascal-case#bad","headings":["Bad"],"excerpt":"Bad enum foo_bar { BAR = 0; BAZ = 1; } ```","content":"Bad enum foo_bar { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-pascal-case::good::4","title":"ENUM_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/enum-pascal-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-pascal-case::good::5","title":"ENUM_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/enum-pascal-case#good","headings":["Good"],"excerpt":"Good enum FooBar { // [!code focus] BAR = 0; BAZ = 1; } ```","content":"Good enum FooBar { // [!code focus] BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-value-prefix::top::0","title":"ENUM_VALUE_PREFIX","path":"/docs/guide/cli/linter/rules/enum-value-prefix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-value-prefix::top::1","title":"ENUM_VALUE_PREFIX","path":"/docs/guide/cli/linter/rules/enum-value-prefix","headings":[],"excerpt":"Это правило проверяет, что все значения enum имеют префикс, совпадающий с именем enum.","content":"Это правило проверяет, что все значения enum имеют префикс, совпадающий с именем enum."},{"id":"cli/linter/rules/enum-value-prefix::bad::2","title":"ENUM_VALUE_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-value-prefix#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-value-prefix::good::3","title":"ENUM_VALUE_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/enum-value-prefix#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-value-prefix::good::4","title":"ENUM_VALUE_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/enum-value-prefix#good","headings":["Good"],"excerpt":"Good enum Foo { FOO_BAR = 0; // [!code focus] } ```","content":"Good enum Foo { FOO_BAR = 0; // [!code focus] } ```"},{"id":"cli/linter/rules/enum-value-upper-snake-case::top::0","title":"ENUM_VALUE_UPPER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-value-upper-snake-case::top::1","title":"ENUM_VALUE_UPPER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case","headings":[],"excerpt":"Это правило проверяет, что значения enum записаны в стиле UPPER_SNAKE_CASE.","content":"Это правило проверяет, что значения enum записаны в стиле UPPER_SNAKE_CASE."},{"id":"cli/linter/rules/enum-value-upper-snake-case::bad::2","title":"ENUM_VALUE_UPPER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-value-upper-snake-case::bad::3","title":"ENUM_VALUE_UPPER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case#bad","headings":["Bad"],"excerpt":"Bad enum Foo { barName = 0; bazName = 1; } ```","content":"Bad enum Foo { barName = 0; bazName = 1; } ```"},{"id":"cli/linter/rules/enum-value-upper-snake-case::good::4","title":"ENUM_VALUE_UPPER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-value-upper-snake-case::good::5","title":"ENUM_VALUE_UPPER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case#good","headings":["Good"],"excerpt":"Good enum Foo { BAR_NAME = 0; // [!code focus] BAZ_NAME = 1; // [!code focus] } ```","content":"Good enum Foo { BAR_NAME = 0; // [!code focus] BAZ_NAME = 1; // [!code focus] } ```"},{"id":"cli/linter/rules/enum-zero-value-suffix::top::0","title":"ENUM_ZERO_VALUE_SUFFIX","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-zero-value-suffix::top::1","title":"ENUM_ZERO_VALUE_SUFFIX","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix","headings":[],"excerpt":"Это правило проверяет, что все нулевые значения enum имеют суффикс _NONE или ваш кастомный (пользовательский) суффикс.","content":"Это правило проверяет, что все нулевые значения enum имеют суффикс _NONE или ваш кастомный (пользовательский) суффикс."},{"id":"cli/linter/rules/enum-zero-value-suffix::bad::2","title":"ENUM_ZERO_VALUE_SUFFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-zero-value-suffix::good::3","title":"ENUM_ZERO_VALUE_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-zero-value-suffix::good::4","title":"ENUM_ZERO_VALUE_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix#good","headings":["Good"],"excerpt":"Good enum Foo { FOO_BAR_NONE = 0; // [!code focus] } ```","content":"Good enum Foo { FOO_BAR_NONE = 0; // [!code focus] } ```"},{"id":"cli/linter/rules/field-lower-snake-case::top::0","title":"FIELD_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/field-lower-snake-case","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/field-lower-snake-case::top::1","title":"FIELD_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/field-lower-snake-case","headings":[],"excerpt":"Это правило проверяет, что имена полей сообщений записаны в стиле lower_snake_case.","content":"Это правило проверяет, что имена полей сообщений записаны в стиле lower_snake_case."},{"id":"cli/linter/rules/field-lower-snake-case::bad::2","title":"FIELD_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/field-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/field-lower-snake-case::bad::3","title":"FIELD_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/field-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad message Foo { string BarName = 1; } ```","content":"Bad message Foo { string BarName = 1; } ```"},{"id":"cli/linter/rules/field-lower-snake-case::good::4","title":"FIELD_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/field-lower-snake-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/field-lower-snake-case::good::5","title":"FIELD_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/field-lower-snake-case#good","headings":["Good"],"excerpt":"Good message Foo { string bar_name = 1; // [!code focus] } ```","content":"Good message Foo { string bar_name = 1; // [!code focus] } ```"},{"id":"cli/linter/rules/file-lower-snake-case::top::0","title":"FILE_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/file-lower-snake-case","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/file-lower-snake-case::top::1","title":"FILE_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/file-lower-snake-case","headings":[],"excerpt":"Это правило проверяет, что все файлы имеют имя в формате lower_snake_case (только строчные буквы, цифры и символ подчеркивания, без пробелов и заглавных букв).","content":"Это правило проверяет, что все файлы имеют имя в формате lower_snake_case (только строчные буквы, цифры и символ подчеркивания, без пробелов и заглавных букв)."},{"id":"cli/linter/rules/file-lower-snake-case::bad::2","title":"FILE_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/file-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: bar/FooBaz.proto","content":"Bad ```proto // File: bar/FooBaz.proto"},{"id":"cli/linter/rules/file-lower-snake-case::good::3","title":"FILE_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/file-lower-snake-case#good","headings":["Good"],"excerpt":"Good ```proto // File: bar/foo_baz.proto // [!code focus]","content":"Good ```proto // File: bar/foo_baz.proto // [!code focus]"},{"id":"cli/linter/rules/import-no-public::top::0","title":"IMPORT_NO_PUBLIC","path":"/docs/guide/cli/linter/rules/import-no-public","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/import-no-public::top::1","title":"IMPORT_NO_PUBLIC","path":"/docs/guide/cli/linter/rules/import-no-public","headings":[],"excerpt":"Это правило проверяет, что в proto-файле не используются public импорты (оператор import public \"...\").","content":"Это правило проверяет, что в proto-файле не используются public импорты (оператор import public \"...\")."},{"id":"cli/linter/rules/import-no-public::bad::2","title":"IMPORT_NO_PUBLIC","section":"Bad","path":"/docs/guide/cli/linter/rules/import-no-public#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/import-no-public::bad::3","title":"IMPORT_NO_PUBLIC","section":"Bad","path":"/docs/guide/cli/linter/rules/import-no-public#bad","headings":["Bad"],"excerpt":"Bad import public \"bar.proto\"; ```","content":"Bad import public \"bar.proto\"; ```"},{"id":"cli/linter/rules/import-no-public::good::4","title":"IMPORT_NO_PUBLIC","section":"Good","path":"/docs/guide/cli/linter/rules/import-no-public#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/import-no-public::good::5","title":"IMPORT_NO_PUBLIC","section":"Good","path":"/docs/guide/cli/linter/rules/import-no-public#good","headings":["Good"],"excerpt":"Good import \"bar.proto\"; // [!code focus] ```","content":"Good import \"bar.proto\"; // [!code focus] ```"},{"id":"cli/linter/rules/import-no-weak::top::0","title":"IMPORT_NO_WEAK","path":"/docs/guide/cli/linter/rules/import-no-weak","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/import-no-weak::top::1","title":"IMPORT_NO_WEAK","path":"/docs/guide/cli/linter/rules/import-no-weak","headings":[],"excerpt":"Это правило проверяет, что в proto‑файле не используются weak‑импорты (import weak \"...\").","content":"Это правило проверяет, что в proto‑файле не используются weak‑импорты (import weak \"...\")."},{"id":"cli/linter/rules/import-no-weak::top::2","title":"IMPORT_NO_WEAK","path":"/docs/guide/cli/linter/rules/import-no-weak","headings":[],"excerpt":"Weak import (синтаксис import weak) допустим в proto2, но его использование усложняет анализ зависимостей и может приводить к неочевидным ошибкам при генерации кода. Рекомендуется всегда использовать обычный import.","content":"Weak import (синтаксис import weak) допустим в proto2, но его использование усложняет анализ зависимостей и может приводить к неочевидным ошибкам при генерации кода. Рекомендуется всегда использовать обычный import."},{"id":"cli/linter/rules/import-no-weak::bad::3","title":"IMPORT_NO_WEAK","section":"Bad","path":"/docs/guide/cli/linter/rules/import-no-weak#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto2\";","content":"Bad ```proto syntax = \"proto2\";"},{"id":"cli/linter/rules/import-no-weak::bad::4","title":"IMPORT_NO_WEAK","section":"Bad","path":"/docs/guide/cli/linter/rules/import-no-weak#bad","headings":["Bad"],"excerpt":"Bad import weak \"bar.proto\"; ```","content":"Bad import weak \"bar.proto\"; ```"},{"id":"cli/linter/rules/import-no-weak::good::5","title":"IMPORT_NO_WEAK","section":"Good","path":"/docs/guide/cli/linter/rules/import-no-weak#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto2\";","content":"Good ```proto syntax = \"proto2\";"},{"id":"cli/linter/rules/import-no-weak::good::6","title":"IMPORT_NO_WEAK","section":"Good","path":"/docs/guide/cli/linter/rules/import-no-weak#good","headings":["Good"],"excerpt":"Good import \"bar.proto\"; // [!code focus] ```","content":"Good import \"bar.proto\"; // [!code focus] ```"},{"id":"cli/linter/rules/import-used::top::0","title":"IMPORT_USED","path":"/docs/guide/cli/linter/rules/import-used","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/import-used::top::1","title":"IMPORT_USED","path":"/docs/guide/cli/linter/rules/import-used","headings":[],"excerpt":"Это правило проверяет, что все импорты используются в proto-файле.","content":"Это правило проверяет, что все импорты используются в proto-файле."},{"id":"cli/linter/rules/import-used::bad::2","title":"IMPORT_USED","section":"Bad","path":"/docs/guide/cli/linter/rules/import-used#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/import-used::good::3","title":"IMPORT_USED","section":"Good","path":"/docs/guide/cli/linter/rules/import-used#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/import-used::good::4","title":"IMPORT_USED","section":"Good","path":"/docs/guide/cli/linter/rules/import-used#good","headings":["Good"],"excerpt":"Good import \"bar.proto\"; // [!code focus]","content":"Good import \"bar.proto\"; // [!code focus]"},{"id":"cli/linter/rules/import-used::good::5","title":"IMPORT_USED","section":"Good","path":"/docs/guide/cli/linter/rules/import-used#good","headings":["Good"],"excerpt":"Good message Foo { bar.Bar bar = 1; // [!code focus] } ```","content":"Good message Foo { bar.Bar bar = 1; // [!code focus] } ```"},{"id":"cli/linter/rules/message-pascal-case::top::0","title":"MESSAGE_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/message-pascal-case","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/message-pascal-case::top::1","title":"MESSAGE_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/message-pascal-case","headings":[],"excerpt":"Это правило проверяет, что имена сообщений (message) записаны в стиле PascalCase.","content":"Это правило проверяет, что имена сообщений (message) записаны в стиле PascalCase."},{"id":"cli/linter/rules/message-pascal-case::bad::2","title":"MESSAGE_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/message-pascal-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/message-pascal-case::bad::3","title":"MESSAGE_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/message-pascal-case#bad","headings":["Bad"],"excerpt":"Bad message foo_bar { string bar_name = 1; } ```","content":"Bad message foo_bar { string bar_name = 1; } ```"},{"id":"cli/linter/rules/message-pascal-case::good::4","title":"MESSAGE_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/message-pascal-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/message-pascal-case::good::5","title":"MESSAGE_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/message-pascal-case#good","headings":["Good"],"excerpt":"Good message FooBar { // [!code focus] string bar_name = 1; } ```","content":"Good message FooBar { // [!code focus] string bar_name = 1; } ```"},{"id":"cli/linter/rules/oneof-lower-snake-case::top::0","title":"ONEOF_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/oneof-lower-snake-case::top::1","title":"ONEOF_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case","headings":[],"excerpt":"Это правило проверяет, что имена oneof записаны в стиле lower_snake_case.","content":"Это правило проверяет, что имена oneof записаны в стиле lower_snake_case."},{"id":"cli/linter/rules/oneof-lower-snake-case::bad::2","title":"ONEOF_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/oneof-lower-snake-case::bad::3","title":"ONEOF_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad message Foo { oneof BarName { string bar_name = 1; } } ```","content":"Bad message Foo { oneof BarName { string bar_name = 1; } } ```"},{"id":"cli/linter/rules/oneof-lower-snake-case::good::4","title":"ONEOF_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/oneof-lower-snake-case::good::5","title":"ONEOF_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case#good","headings":["Good"],"excerpt":"Good message Foo { oneof bar_name { // [!code focus] string bar_name = 1; } } ```","content":"Good message Foo { oneof bar_name { // [!code focus] string bar_name = 1; } } ```"},{"id":"cli/linter/rules/package-defined::top::0","title":"PACKAGE_DEFINED","path":"/docs/guide/cli/linter/rules/package-defined","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-defined::top::1","title":"PACKAGE_DEFINED","path":"/docs/guide/cli/linter/rules/package-defined","headings":[],"excerpt":"Это правило проверяет, что во всех файлах присутствует директива package.","content":"Это правило проверяет, что во всех файлах присутствует директива package."},{"id":"cli/linter/rules/package-defined::bad::2","title":"PACKAGE_DEFINED","section":"Bad","path":"/docs/guide/cli/linter/rules/package-defined#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-defined::bad::3","title":"PACKAGE_DEFINED","section":"Bad","path":"/docs/guide/cli/linter/rules/package-defined#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; }","content":"Bad message Foo { string bar = 1; }"},{"id":"cli/linter/rules/package-defined::good::4","title":"PACKAGE_DEFINED","section":"Good","path":"/docs/guide/cli/linter/rules/package-defined#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-defined::good::5","title":"PACKAGE_DEFINED","section":"Good","path":"/docs/guide/cli/linter/rules/package-defined#good","headings":["Good"],"excerpt":"Good package foo; // [!code focus]","content":"Good package foo; // [!code focus]"},{"id":"cli/linter/rules/package-defined::good::6","title":"PACKAGE_DEFINED","section":"Good","path":"/docs/guide/cli/linter/rules/package-defined#good","headings":["Good"],"excerpt":"Good message Foo { string bar = 1; } ```","content":"Good message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/package-directory-match::top::0","title":"PACKAGE_DIRECTORY_MATCH","path":"/docs/guide/cli/linter/rules/package-directory-match","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-directory-match::top::1","title":"PACKAGE_DIRECTORY_MATCH","path":"/docs/guide/cli/linter/rules/package-directory-match","headings":[],"excerpt":"Это правило проверяет, что все файлы находятся в директории, имя которой соответствует имени их пакета.","content":"Это правило проверяет, что все файлы находятся в директории, имя которой соответствует имени их пакета."},{"id":"cli/linter/rules/package-directory-match::bad::2","title":"PACKAGE_DIRECTORY_MATCH","section":"Bad","path":"/docs/guide/cli/linter/rules/package-directory-match#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: bar/foo.proto","content":"Bad ```proto // File: bar/foo.proto"},{"id":"cli/linter/rules/package-directory-match::bad::3","title":"PACKAGE_DIRECTORY_MATCH","section":"Bad","path":"/docs/guide/cli/linter/rules/package-directory-match#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; } ```","content":"Bad message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/package-directory-match::good::4","title":"PACKAGE_DIRECTORY_MATCH","section":"Good","path":"/docs/guide/cli/linter/rules/package-directory-match#good","headings":["Good"],"excerpt":"Good ```proto // File: bar/foo.proto // [!code focus]","content":"Good ```proto // File: bar/foo.proto // [!code focus]"},{"id":"cli/linter/rules/package-directory-match::good::5","title":"PACKAGE_DIRECTORY_MATCH","section":"Good","path":"/docs/guide/cli/linter/rules/package-directory-match#good","headings":["Good"],"excerpt":"Good package bar; // [!code focus]","content":"Good package bar; // [!code focus]"},{"id":"cli/linter/rules/package-directory-match::good::6","title":"PACKAGE_DIRECTORY_MATCH","section":"Good","path":"/docs/guide/cli/linter/rules/package-directory-match#good","headings":["Good"],"excerpt":"Good message Foo { string bar = 1; } ```","content":"Good message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/package-lower-snake-case::top::0","title":"PACKAGE_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/package-lower-snake-case","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-lower-snake-case::top::1","title":"PACKAGE_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/package-lower-snake-case","headings":[],"excerpt":"Это правило проверяет, что имена package записаны в формате lower_snake_case (строчные буквы, при необходимости цифры и символ подчеркивания, без пробелов и заглавных букв).","content":"Это правило проверяет, что имена package записаны в формате lower_snake_case (строчные буквы, при необходимости цифры и символ подчеркивания, без пробелов и заглавных букв)."},{"id":"cli/linter/rules/package-lower-snake-case::bad::2","title":"PACKAGE_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: bar/foo.proto syntax = \"proto3\";","content":"Bad ```proto // File: bar/foo.proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-lower-snake-case::good::3","title":"PACKAGE_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/package-lower-snake-case#good","headings":["Good"],"excerpt":"Good ```proto // File: bar/foo.proto syntax = \"proto3\";","content":"Good ```proto // File: bar/foo.proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-lower-snake-case::good::4","title":"PACKAGE_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/package-lower-snake-case#good","headings":["Good"],"excerpt":"Good package foo_bar; // [!code focus] ```","content":"Good package foo_bar; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-csharp-namespace::top::0","title":"PACKAGE_SAME_CSHARP_NAMESPACE","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-csharp-namespace::top::1","title":"PACKAGE_SAME_CSHARP_NAMESPACE","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace","headings":[],"excerpt":"Это правило проверяет, что все файлы с заданным пакетом используют одно и то же пространство имён C# (csharp_namespace).","content":"Это правило проверяет, что все файлы с заданным пакетом используют одно и то же пространство имён C# (csharp_namespace)."},{"id":"cli/linter/rules/package-same-csharp-namespace::bad::2","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-csharp-namespace::bad::3","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#bad","headings":["Bad"],"excerpt":"Bad option csharp_namespace = \"Foo.Bar\"; ```","content":"Bad option csharp_namespace = \"Foo.Bar\"; ```"},{"id":"cli/linter/rules/package-same-csharp-namespace::bad::4","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-csharp-namespace::bad::5","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#bad","headings":["Bad"],"excerpt":"Bad option csharp_namespace = \"Foo.Baz\"; ```","content":"Bad option csharp_namespace = \"Foo.Baz\"; ```"},{"id":"cli/linter/rules/package-same-csharp-namespace::good::6","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-csharp-namespace::good::7","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#good","headings":["Good"],"excerpt":"Good option csharp_namespace = \"Foo.Bar\"; // [!code focus] ```","content":"Good option csharp_namespace = \"Foo.Bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-csharp-namespace::good::8","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-csharp-namespace::good::9","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#good","headings":["Good"],"excerpt":"Good option csharp_namespace = \"Foo.Bar\"; // [!code focus] ```","content":"Good option csharp_namespace = \"Foo.Bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-directory::top::0","title":"PACKAGE_SAME_DIRECTORY","path":"/docs/guide/cli/linter/rules/package-same-directory","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-directory::top::1","title":"PACKAGE_SAME_DIRECTORY","path":"/docs/guide/cli/linter/rules/package-same-directory","headings":[],"excerpt":"Это правило проверяет, что все файлы с данным package находятся в одной директории.","content":"Это правило проверяет, что все файлы с данным package находятся в одной директории."},{"id":"cli/linter/rules/package-same-directory::bad::2","title":"PACKAGE_SAME_DIRECTORY","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-directory#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: bar/foo.proto","content":"Bad ```proto // File: bar/foo.proto"},{"id":"cli/linter/rules/package-same-directory::bad::3","title":"PACKAGE_SAME_DIRECTORY","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-directory#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; } ```","content":"Bad message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/package-same-directory::good::4","title":"PACKAGE_SAME_DIRECTORY","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-directory#good","headings":["Good"],"excerpt":"Good ```proto // File: bar/foo.proto // [!code focus]","content":"Good ```proto // File: bar/foo.proto // [!code focus]"},{"id":"cli/linter/rules/package-same-directory::good::5","title":"PACKAGE_SAME_DIRECTORY","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-directory#good","headings":["Good"],"excerpt":"Good package bar; // [!code focus]","content":"Good package bar; // [!code focus]"},{"id":"cli/linter/rules/package-same-directory::good::6","title":"PACKAGE_SAME_DIRECTORY","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-directory#good","headings":["Good"],"excerpt":"Good message Foo { string bar = 1; } ```","content":"Good message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/package-same-go-package::top::0","title":"PACKAGE_SAME_GO_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-go-package","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-go-package::top::1","title":"PACKAGE_SAME_GO_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-go-package","headings":[],"excerpt":"Это правило проверяет, что все файлы с одним и тем же package используют одно и то же значение опции go_package.","content":"Это правило проверяет, что все файлы с одним и тем же package используют одно и то же значение опции go_package."},{"id":"cli/linter/rules/package-same-go-package::bad::2","title":"PACKAGE_SAME_GO_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-go-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-go-package::bad::3","title":"PACKAGE_SAME_GO_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-go-package#bad","headings":["Bad"],"excerpt":"Bad option go_package = \"example.com/foo/bar\"; ```","content":"Bad option go_package = \"example.com/foo/bar\"; ```"},{"id":"cli/linter/rules/package-same-go-package::bad::4","title":"PACKAGE_SAME_GO_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-go-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-go-package::bad::5","title":"PACKAGE_SAME_GO_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-go-package#bad","headings":["Bad"],"excerpt":"Bad option go_package = \"example.com/foo/baz\"; ```","content":"Bad option go_package = \"example.com/foo/baz\"; ```"},{"id":"cli/linter/rules/package-same-go-package::good::6","title":"PACKAGE_SAME_GO_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-go-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-go-package::good::7","title":"PACKAGE_SAME_GO_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-go-package#good","headings":["Good"],"excerpt":"Good option go_package = \"example.com/foo/bar\"; // [!code focus] ```","content":"Good option go_package = \"example.com/foo/bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-go-package::good::8","title":"PACKAGE_SAME_GO_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-go-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-go-package::good::9","title":"PACKAGE_SAME_GO_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-go-package#good","headings":["Good"],"excerpt":"Good option go_package = \"example.com/foo/bar\"; // [!code focus] ```","content":"Good option go_package = \"example.com/foo/bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-java-multiple-files::top::0","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files","headings":[],"excerpt":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","content":"PACKAGE_SAME_JAVA_MULTIPLE_FILES"},{"id":"cli/linter/rules/package-same-java-multiple-files::top::1","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-java-multiple-files::top::2","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files","headings":[],"excerpt":"Это правило проверяет, что все файлы с одним и тем же package используют одинаковое значение опции java_package.","content":"Это правило проверяет, что все файлы с одним и тем же package используют одинаковое значение опции java_package."},{"id":"cli/linter/rules/package-same-java-multiple-files::bad::3","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-java-multiple-files::bad::4","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#bad","headings":["Bad"],"excerpt":"Bad option java_package = \"com.example.foo\"; ```","content":"Bad option java_package = \"com.example.foo\"; ```"},{"id":"cli/linter/rules/package-same-java-multiple-files::bad::5","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-java-multiple-files::bad::6","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#bad","headings":["Bad"],"excerpt":"Bad option java_package = \"com.example.bar\"; ```","content":"Bad option java_package = \"com.example.bar\"; ```"},{"id":"cli/linter/rules/package-same-java-multiple-files::good::7","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-java-multiple-files::good::8","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#good","headings":["Good"],"excerpt":"Good option java_package = \"com.example.foo\"; // [!code focus] ```","content":"Good option java_package = \"com.example.foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-java-multiple-files::good::9","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-java-multiple-files::good::10","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#good","headings":["Good"],"excerpt":"Good option java_package = \"com.example.foo\"; // [!code focus] ```","content":"Good option java_package = \"com.example.foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-java-package::top::0","title":"PACKAGE_SAME_JAVA_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-java-package","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-java-package::top::1","title":"PACKAGE_SAME_JAVA_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-java-package","headings":[],"excerpt":"Это правило проверяет, что все файлы с одним и тем же package используют одно и то же значение опции java_package.","content":"Это правило проверяет, что все файлы с одним и тем же package используют одно и то же значение опции java_package."},{"id":"cli/linter/rules/package-same-java-package::bad::2","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-java-package::bad::3","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-package#bad","headings":["Bad"],"excerpt":"Bad option java_package = \"com.example.foo\"; ```","content":"Bad option java_package = \"com.example.foo\"; ```"},{"id":"cli/linter/rules/package-same-java-package::bad::4","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-java-package::bad::5","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-package#bad","headings":["Bad"],"excerpt":"Bad option java_package = \"com.example.bar\"; ```","content":"Bad option java_package = \"com.example.bar\"; ```"},{"id":"cli/linter/rules/package-same-java-package::good::6","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-java-package::good::7","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-package#good","headings":["Good"],"excerpt":"Good option java_package = \"com.example.foo\"; // [!code focus] ```","content":"Good option java_package = \"com.example.foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-java-package::good::8","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-java-package::good::9","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-package#good","headings":["Good"],"excerpt":"Good option java_package = \"com.example.foo\"; // [!code focus] ```","content":"Good option java_package = \"com.example.foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-php-namespace::top::0","title":"PACKAGE_SAME_PHP_NAMESPACE","path":"/docs/guide/cli/linter/rules/package-same-php-namespace","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-php-namespace::top::1","title":"PACKAGE_SAME_PHP_NAMESPACE","path":"/docs/guide/cli/linter/rules/package-same-php-namespace","headings":[],"excerpt":"Это правило проверяет, что все файлы с одним и тем же package используют одно и то же значение опции php_namespace.","content":"Это правило проверяет, что все файлы с одним и тем же package используют одно и то же значение опции php_namespace."},{"id":"cli/linter/rules/package-same-php-namespace::bad::2","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-php-namespace::bad::3","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#bad","headings":["Bad"],"excerpt":"Bad option php_namespace = \"Foo\\\\Bar\"; ```","content":"Bad option php_namespace = \"Foo\\\\Bar\"; ```"},{"id":"cli/linter/rules/package-same-php-namespace::bad::4","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-php-namespace::bad::5","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#bad","headings":["Bad"],"excerpt":"Bad option php_namespace = \"Foo\\\\Baz\"; ```","content":"Bad option php_namespace = \"Foo\\\\Baz\"; ```"},{"id":"cli/linter/rules/package-same-php-namespace::good::6","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-php-namespace::good::7","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#good","headings":["Good"],"excerpt":"Good option php_namespace = \"Foo\\\\Bar\"; // [!code focus] ```","content":"Good option php_namespace = \"Foo\\\\Bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-php-namespace::good::8","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-php-namespace::good::9","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#good","headings":["Good"],"excerpt":"Good option php_namespace = \"Foo\\\\Bar\"; // [!code focus] ```","content":"Good option php_namespace = \"Foo\\\\Bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-ruby-package::top::0","title":"PACKAGE_SAME_RUBY_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-ruby-package","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-ruby-package::top::1","title":"PACKAGE_SAME_RUBY_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-ruby-package","headings":[],"excerpt":"This rule checks that all files with a given package are in the same Ruby package.","content":"This rule checks that all files with a given package are in the same Ruby package."},{"id":"cli/linter/rules/package-same-ruby-package::bad::2","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-ruby-package::bad::3","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#bad","headings":["Bad"],"excerpt":"Bad option ruby_package = \"Foo\"; ```","content":"Bad option ruby_package = \"Foo\"; ```"},{"id":"cli/linter/rules/package-same-ruby-package::bad::4","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-ruby-package::bad::5","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#bad","headings":["Bad"],"excerpt":"Bad option ruby_package = \"Bar\"; ```","content":"Bad option ruby_package = \"Bar\"; ```"},{"id":"cli/linter/rules/package-same-ruby-package::good::6","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-ruby-package::good::7","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#good","headings":["Good"],"excerpt":"Good option ruby_package = \"Foo\"; // [!code focus] ```","content":"Good option ruby_package = \"Foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-ruby-package::good::8","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-ruby-package::good::9","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#good","headings":["Good"],"excerpt":"Good option ruby_package = \"Foo\"; // [!code focus] ```","content":"Good option ruby_package = \"Foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-swift-prefix::top::0","title":"PACKAGE_SAME_SWIFT_PREFIX","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-swift-prefix::top::1","title":"PACKAGE_SAME_SWIFT_PREFIX","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix","headings":[],"excerpt":"Это правило проверяет, что все файлы с одним и тем же package используют один и тот же swift_prefix.","content":"Это правило проверяет, что все файлы с одним и тем же package используют один и тот же swift_prefix."},{"id":"cli/linter/rules/package-same-swift-prefix::bad::2","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-swift-prefix::bad::3","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#bad","headings":["Bad"],"excerpt":"Bad option swift_prefix = \"Foo\"; ```","content":"Bad option swift_prefix = \"Foo\"; ```"},{"id":"cli/linter/rules/package-same-swift-prefix::bad::4","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-swift-prefix::bad::5","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#bad","headings":["Bad"],"excerpt":"Bad option swift_prefix = \"Bar\"; ```","content":"Bad option swift_prefix = \"Bar\"; ```"},{"id":"cli/linter/rules/package-same-swift-prefix::good::6","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-swift-prefix::good::7","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#good","headings":["Good"],"excerpt":"Good option swift_prefix = \"Foo\"; // [!code focus] ```","content":"Good option swift_prefix = \"Foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-swift-prefix::good::8","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-swift-prefix::good::9","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#good","headings":["Good"],"excerpt":"Good option swift_prefix = \"Foo\"; // [!code focus] ```","content":"Good option swift_prefix = \"Foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-version-suffix::top::0","title":"PACKAGE_VERSION_SUFFIX","path":"/docs/guide/cli/linter/rules/package-version-suffix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-version-suffix::top::1","title":"PACKAGE_VERSION_SUFFIX","path":"/docs/guide/cli/linter/rules/package-version-suffix","headings":[],"excerpt":"Это правило проверяет, что суффикс версии пакета имеет формат _vX, где X — числовая версия.","content":"Это правило проверяет, что суффикс версии пакета имеет формат _vX, где X — числовая версия."},{"id":"cli/linter/rules/package-version-suffix::bad::2","title":"PACKAGE_VERSION_SUFFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-version-suffix#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-version-suffix::good::3","title":"PACKAGE_VERSION_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-version-suffix#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-version-suffix::good::4","title":"PACKAGE_VERSION_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-version-suffix#good","headings":["Good"],"excerpt":"Good package foo.v1; // [!code focus] ```","content":"Good package foo.v1; // [!code focus] ```"},{"id":"cli/linter/rules/rpc-no-client-streaming::top::0","title":"RPC_NO_CLIENT_STREAMING","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming","headings":[],"excerpt":"Это правило проверяет, что RPC не использует клиентский стриминг (запрос не является stream ...).","content":"Это правило проверяет, что RPC не использует клиентский стриминг (запрос не является stream ...)."},{"id":"cli/linter/rules/rpc-no-client-streaming::bad::1","title":"RPC_NO_CLIENT_STREAMING","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-no-client-streaming::bad::2","title":"RPC_NO_CLIENT_STREAMING","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar (stream BarRequest) returns (BarResponse) {} } ```","content":"Bad service Foo { rpc Bar (stream BarRequest) returns (BarResponse) {} } ```"},{"id":"cli/linter/rules/rpc-no-client-streaming::good::3","title":"RPC_NO_CLIENT_STREAMING","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-no-client-streaming::good::4","title":"RPC_NO_CLIENT_STREAMING","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming#good","headings":["Good"],"excerpt":"Good service Foo { rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-no-server-streaming::top::0","title":"RPC_NO_SERVER_STREAMING","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming","headings":[],"excerpt":"Это правило проверяет, что RPC не использует серверный стриминг (ответ не является stream ...).","content":"Это правило проверяет, что RPC не использует серверный стриминг (ответ не является stream ...)."},{"id":"cli/linter/rules/rpc-no-server-streaming::bad::1","title":"RPC_NO_SERVER_STREAMING","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-no-server-streaming::bad::2","title":"RPC_NO_SERVER_STREAMING","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar (BarRequest) returns (stream BarResponse) {} } ```","content":"Bad service Foo { rpc Bar (BarRequest) returns (stream BarResponse) {} } ```"},{"id":"cli/linter/rules/rpc-no-server-streaming::good::3","title":"RPC_NO_SERVER_STREAMING","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-no-server-streaming::good::4","title":"RPC_NO_SERVER_STREAMING","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming#good","headings":["Good"],"excerpt":"Good service Foo { rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-pascal-case::top::0","title":"RPC_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/rpc-pascal-case","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/rpc-pascal-case::top::1","title":"RPC_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/rpc-pascal-case","headings":[],"excerpt":"Это правило проверяет, что все имена RPC написаны в стиле PascalCase.","content":"Это правило проверяет, что все имена RPC написаны в стиле PascalCase."},{"id":"cli/linter/rules/rpc-pascal-case::bad::2","title":"RPC_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-pascal-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-pascal-case::bad::3","title":"RPC_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-pascal-case#bad","headings":["Bad"],"excerpt":"Bad service foo_bar { rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {} } ```","content":"Bad service foo_bar { rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {} } ```"},{"id":"cli/linter/rules/rpc-pascal-case::good::4","title":"RPC_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-pascal-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-pascal-case::good::5","title":"RPC_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-pascal-case#good","headings":["Good"],"excerpt":"Good service FooBar { rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} // [!code focus] } ```","content":"Good service FooBar { rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-request-response-unique::top::0","title":"RPC_REQUEST_RESPONSE_UNIQUE","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/rpc-request-response-unique::top::1","title":"RPC_REQUEST_RESPONSE_UNIQUE","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique","headings":[],"excerpt":"Это правило проверяет, что все сообщения запроса и ответа RPC уникальны: для каждого метода используются собственные (не переиспользуются одинаковые пары Request / Response у разных RPC).","content":"Это правило проверяет, что все сообщения запроса и ответа RPC уникальны: для каждого метода используются собственные (не переиспользуются одинаковые пары Request / Response у разных RPC)."},{"id":"cli/linter/rules/rpc-request-response-unique::bad::2","title":"RPC_REQUEST_RESPONSE_UNIQUE","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-request-response-unique::bad::3","title":"RPC_REQUEST_RESPONSE_UNIQUE","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} rpc GetBar (FooRequest) returns (FooResponse) {} } ```","content":"Bad service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} rpc GetBar (FooRequest) returns (FooResponse) {} } ```"},{"id":"cli/linter/rules/rpc-request-response-unique::good::4","title":"RPC_REQUEST_RESPONSE_UNIQUE","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-request-response-unique::good::5","title":"RPC_REQUEST_RESPONSE_UNIQUE","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique#good","headings":["Good"],"excerpt":"Good service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} // [!code focus] rpc GetBar (BarRequest) returns (BarResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} // [!code focus] rpc GetBar (BarRequest) returns (BarResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-request-standard-name::top::0","title":"RPC_REQUEST_STANDARD_NAME","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/rpc-request-standard-name::top::1","title":"RPC_REQUEST_STANDARD_NAME","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name","headings":[],"excerpt":"Это правило проверяет, что все сообщения запроса RPC названы в формате MethodRequest.","content":"Это правило проверяет, что все сообщения запроса RPC названы в формате MethodRequest."},{"id":"cli/linter/rules/rpc-request-standard-name::bad::2","title":"RPC_REQUEST_STANDARD_NAME","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-request-standard-name::bad::3","title":"RPC_REQUEST_STANDARD_NAME","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} } ```","content":"Bad service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} } ```"},{"id":"cli/linter/rules/rpc-request-standard-name::good::4","title":"RPC_REQUEST_STANDARD_NAME","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-request-standard-name::good::5","title":"RPC_REQUEST_STANDARD_NAME","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name#good","headings":["Good"],"excerpt":"Good service Foo { rpc GetFoo (GetFooRequest) returns (FooResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc GetFoo (GetFooRequest) returns (FooResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-response-standard-name::top::0","title":"RPC_RESPONSE_STANDARD_NAME","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/rpc-response-standard-name::top::1","title":"RPC_RESPONSE_STANDARD_NAME","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name","headings":[],"excerpt":"Это правило проверяет, что все сообщения ответа RPC названы в формате MethodResponse.","content":"Это правило проверяет, что все сообщения ответа RPC названы в формате MethodResponse."},{"id":"cli/linter/rules/rpc-response-standard-name::bad::2","title":"RPC_RESPONSE_STANDARD_NAME","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-response-standard-name::bad::3","title":"RPC_RESPONSE_STANDARD_NAME","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc GetFoo (GetFooRequest) returns (Foo) {} } ```","content":"Bad service Foo { rpc GetFoo (GetFooRequest) returns (Foo) {} } ```"},{"id":"cli/linter/rules/rpc-response-standard-name::good::4","title":"RPC_RESPONSE_STANDARD_NAME","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-response-standard-name::good::5","title":"RPC_RESPONSE_STANDARD_NAME","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name#good","headings":["Good"],"excerpt":"Good service Foo { rpc GetFoo (GetFooRequest) returns (GetFooResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc GetFoo (GetFooRequest) returns (GetFooResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/service-pascal-case::top::0","title":"SERVICE_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/service-pascal-case","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/service-pascal-case::top::1","title":"SERVICE_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/service-pascal-case","headings":[],"excerpt":"Это правило проверяет, что все имена сервисов написаны в стиле PascalCase.","content":"Это правило проверяет, что все имена сервисов написаны в стиле PascalCase."},{"id":"cli/linter/rules/service-pascal-case::bad::2","title":"SERVICE_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/service-pascal-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/service-pascal-case::bad::3","title":"SERVICE_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/service-pascal-case#bad","headings":["Bad"],"excerpt":"Bad service foo_bar { rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {} } ```","content":"Bad service foo_bar { rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {} } ```"},{"id":"cli/linter/rules/service-pascal-case::good::4","title":"SERVICE_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/service-pascal-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/service-pascal-case::good::5","title":"SERVICE_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/service-pascal-case#good","headings":["Good"],"excerpt":"Good service FooBar { // [!code focus] rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} } ```","content":"Good service FooBar { // [!code focus] rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} } ```"},{"id":"cli/linter/rules/service-suffix::top::0","title":"SERVICE_SUFFIX","path":"/docs/guide/cli/linter/rules/service-suffix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/service-suffix::top::1","title":"SERVICE_SUFFIX","path":"/docs/guide/cli/linter/rules/service-suffix","headings":[],"excerpt":"Это правило проверяет, что все сервисы имеют суффикс Service или ваш пользовательский суффикс.","content":"Это правило проверяет, что все сервисы имеют суффикс Service или ваш пользовательский суффикс."},{"id":"cli/linter/rules/service-suffix::bad::2","title":"SERVICE_SUFFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/service-suffix#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/service-suffix::bad::3","title":"SERVICE_SUFFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/service-suffix#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar(BarRequest) returns (BarResponse); } ```","content":"Bad service Foo { rpc Bar(BarRequest) returns (BarResponse); } ```"},{"id":"cli/linter/rules/service-suffix::good::4","title":"SERVICE_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/service-suffix#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/service-suffix::good::5","title":"SERVICE_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/service-suffix#good","headings":["Good"],"excerpt":"Good service FooService { // [!code focus] rpc Bar(BarRequest) returns (BarResponse); } ```","content":"Good service FooService { // [!code focus] rpc Bar(BarRequest) returns (BarResponse); } ```"},{"id":"cli/package-manager/easyp-vs-buf::top::0","title":"EasyP против Buf: управление пакетами","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":[],"excerpt":"EasyP против Buf: управление пакетами","content":"EasyP против Buf: управление пакетами"},{"id":"cli/package-manager/easyp-vs-buf::top::1","title":"EasyP против Buf: управление пакетами","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":[],"excerpt":"Этот документ даёт подробное сравнение децентрализованного подхода EasyP к управлению пакетами и централизованной модели Buf через Buf Schema Registry (BSR), чтобы помочь понять ключевые различия и выбрать подходящее реш","content":"Этот документ даёт подробное сравнение децентрализованного подхода EasyP к управлению пакетами и централизованной модели Buf через Buf Schema Registry (BSR), чтобы помочь понять ключевые различия и выбрать подходящее решение для ваших задач."},{"id":"cli/package-manager/easyp-vs-buf::easyp-git::2","title":"EasyP против Buf: управление пакетами","section":"EasyP: децентрализованный подход на базе Git","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-git","headings":["EasyP: децентрализованный подход на базе Git"],"excerpt":"EasyP: децентрализованный подход на базе Git","content":"EasyP: децентрализованный подход на базе Git"},{"id":"cli/package-manager/easyp-vs-buf::buf-bsr::3","title":"EasyP против Buf: управление пакетами","section":"Buf: централизованный реестр (BSR)","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-bsr","headings":["Buf: централизованный реестр (BSR)"],"excerpt":"Buf: централизованный реестр (BSR)","content":"Buf: централизованный реестр (BSR)"},{"id":"cli/package-manager/easyp-vs-buf::top::4","title":"EasyP против Buf: управление пакетами","section":"Краткое резюме различий","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":["Краткое резюме различий"],"excerpt":"Краткое резюме различий Аспект EasyP Buf -------- ------- ----- **Архитектура** Децентрализованная (Git) Централизованная (реестр BSR) **Источник зависимостей** Любой Git репозиторий Только модули BSR **Единая точка отка","content":"Краткое резюме различий Аспект EasyP Buf -------- ------- ----- **Архитектура** Децентрализованная (Git) Централизованная (реестр BSR) **Источник зависимостей** Любой Git репозиторий Только модули BSR **Единая точка отказа** Нет Да (buf.build) **Enterprise / air‑gapped** Полная поддержка Требует доступа к BSR или приватного BSR **Аутентификация** Git (SSH / HTTPS) Токены Buf + Git **Vendor lock‑in** Отсутствует Привязка к экосистеме Buf **Частные репозитории** Нативно через Git Нужно опубликовать в BSR **Оффлайн поддержка** Полная (через vendoring) Ограничена (кэшированные модули) **Стоимость** Бесплатно (использует существующий Git) Бесплатный тариф + платные планы **Сложность настройки** Минимальная Средняя (настройка BSR)"},{"id":"cli/package-manager/easyp-vs-buf::top::5","title":"EasyP против Buf: управление пакетами","section":"Подробное сравнение возможностей","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":["Подробное сравнение возможностей"],"excerpt":"Подробное сравнение возможностей","content":"Подробное сравнение возможностей"},{"id":"cli/package-manager/easyp-vs-buf::1::6","title":"EasyP против Buf: управление пакетами","section":"1. Философия управления зависимостями","path":"/docs/guide/cli/package-manager/easyp-vs-buf#1","headings":["1. Философия управления зависимостями"],"excerpt":"Философия управления зависимостями","content":"Философия управления зависимостями"},{"id":"cli/package-manager/easyp-vs-buf::easyp-git::7","title":"EasyP против Buf: управление пакетами","section":"EasyP: «Любой Git репозиторий — это пакет»","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-git","headings":["EasyP: «Любой Git репозиторий — это пакет»"],"excerpt":"EasyP: «Любой Git репозиторий — это пакет»","content":"EasyP: «Любой Git репозиторий — это пакет»"},{"id":"cli/package-manager/easyp-vs-buf::easyp-git::8","title":"EasyP против Buf: управление пакетами","section":"EasyP: «Любой Git репозиторий — это пакет»","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-git","headings":["EasyP: «Любой Git репозиторий — это пакет»"],"excerpt":"EasyP: «Любой Git репозиторий — это пакет» **Преимущества:** ✅ Использование любого существующего репозитория сразу ✅ Не нужно «публиковать» в отдельный реестр ✅ Истинный источник версий — Git ✅ Работает с приватными сер","content":"EasyP: «Любой Git репозиторий — это пакет» **Преимущества:** ✅ Использование любого существующего репозитория сразу ✅ Не нужно «публиковать» в отдельный реестр ✅ Истинный источник версий — Git ✅ Работает с приватными серверами без доп. настроек"},{"id":"cli/package-manager/easyp-vs-buf::buf::9","title":"EasyP против Buf: управление пакетами","section":"Buf: «Сначала реестр»","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Buf: «Сначала реестр»"],"excerpt":"Buf: «Сначала реестр» **Преимущества:** ✅ Курируемые, проверенные модули ✅ Богатые метаданные и документация ✅ Визуализация графа зависимостей ✅ Принуждение семантического версионирования","content":"Buf: «Сначала реестр» **Преимущества:** ✅ Курируемые, проверенные модули ✅ Богатые метаданные и документация ✅ Визуализация графа зависимостей ✅ Принуждение семантического версионирования"},{"id":"cli/package-manager/easyp-vs-buf::buf::10","title":"EasyP против Buf: управление пакетами","section":"Buf: «Сначала реестр»","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Buf: «Сначала реестр»"],"excerpt":"Buf: «Сначала реестр» **Ограничения:** ❌ Нужно опубликовать в BSR перед использованием ❌ Требует аккаунт и аутентификацию ❌ Нельзя напрямую сослаться на произвольный Git репозиторий","content":"Buf: «Сначала реестр» **Ограничения:** ❌ Нужно опубликовать в BSR перед использованием ❌ Требует аккаунт и аутентификацию ❌ Нельзя напрямую сослаться на произвольный Git репозиторий"},{"id":"cli/package-manager/easyp-vs-buf::2-airgapped::11","title":"EasyP против Buf: управление пакетами","section":"2. Корпоративные и изолированные (air‑gapped) среды","path":"/docs/guide/cli/package-manager/easyp-vs-buf#2-airgapped","headings":["2. Корпоративные и изолированные (air‑gapped) среды"],"excerpt":"Корпоративные и изолированные (air‑gapped) среды","content":"Корпоративные и изолированные (air‑gapped) среды"},{"id":"cli/package-manager/easyp-vs-buf::easyp::12","title":"EasyP против Buf: управление пакетами","section":"EasyP: Полноценная оффлайн‑поддержка","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Полноценная оффлайн‑поддержка"],"excerpt":"EasyP: Полноценная оффлайн‑поддержка **Сценарий**: крупная компания со строгими сетевыми политиками","content":"EasyP: Полноценная оффлайн‑поддержка **Сценарий**: крупная компания со строгими сетевыми политиками"},{"id":"cli/package-manager/easyp-vs-buf::easyp::13","title":"EasyP против Buf: управление пакетами","section":"EasyP: Полноценная оффлайн‑поддержка","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Полноценная оффлайн‑поддержка"],"excerpt":"EasyP: Полноценная оффлайн‑поддержка ```bash Среда с доступом в интернет easyp mod download # Скачивает в ~/.easyp/ easyp mod vendor # Создает easyp_vendor/","content":"EasyP: Полноценная оффлайн‑поддержка ```bash Среда с доступом в интернет easyp mod download # Скачивает в ~/.easyp/ easyp mod vendor # Создает easyp_vendor/"},{"id":"cli/package-manager/easyp-vs-buf::easyp::14","title":"EasyP против Buf: управление пакетами","section":"EasyP: Полноценная оффлайн‑поддержка","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Полноценная оффлайн‑поддержка"],"excerpt":"EasyP: Полноценная оффлайн‑поддержка Перенос в изолированный сегмент tar -czf easyp-deps.tar.gz ~/.easyp easyp_vendor/ ... перенос архива ...","content":"EasyP: Полноценная оффлайн‑поддержка Перенос в изолированный сегмент tar -czf easyp-deps.tar.gz ~/.easyp easyp_vendor/ ... перенос архива ..."},{"id":"cli/package-manager/easyp-vs-buf::easyp::15","title":"EasyP против Buf: управление пакетами","section":"EasyP: Полноценная оффлайн‑поддержка","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Полноценная оффлайн‑поддержка"],"excerpt":"EasyP: Полноценная оффлайн‑поддержка В изолированной среде tar -xzf easyp-deps.tar.gz export EASYPPATH=$PWD/.easyp easyp generate # Работает оффлайн ```","content":"EasyP: Полноценная оффлайн‑поддержка В изолированной среде tar -xzf easyp-deps.tar.gz export EASYPPATH=$PWD/.easyp easyp generate # Работает оффлайн ```"},{"id":"cli/package-manager/easyp-vs-buf::easyp::16","title":"EasyP против Buf: управление пакетами","section":"EasyP: Полноценная оффлайн‑поддержка","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Полноценная оффлайн‑поддержка"],"excerpt":"EasyP: Полноценная оффлайн‑поддержка **Плюсы:** ✅ Не зависит от внешних сервисов ✅ Не нужен внутренний реестр ✅ Использует существующую Git инфраструктуру ✅ Простая файловая дистрибуция","content":"EasyP: Полноценная оффлайн‑поддержка **Плюсы:** ✅ Не зависит от внешних сервисов ✅ Не нужен внутренний реестр ✅ Использует существующую Git инфраструктуру ✅ Простая файловая дистрибуция"},{"id":"cli/package-manager/easyp-vs-buf::buf::17","title":"EasyP против Buf: управление пакетами","section":"Buf: Требует инфраструктуру реестра","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Buf: Требует инфраструктуру реестра"],"excerpt":"Buf: Требует инфраструктуру реестра ```bash Вариант 1: использовать buf.build (нужен интернет) buf mod download","content":"Buf: Требует инфраструктуру реестра ```bash Вариант 1: использовать buf.build (нужен интернет) buf mod download"},{"id":"cli/package-manager/easyp-vs-buf::buf::18","title":"EasyP против Buf: управление пакетами","section":"Buf: Требует инфраструктуру реестра","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Buf: Требует инфраструктуру реестра"],"excerpt":"Buf: Требует инфраструктуру реестра Вариант 2: поднимать приватный BSR (сложно) Развернуть сервер реестра Перепубликовать все модули внутрь Настроить доступы, аутентификацию Поддерживать работоспособность ```","content":"Buf: Требует инфраструктуру реестра Вариант 2: поднимать приватный BSR (сложно) Развернуть сервер реестра Перепубликовать все модули внутрь Настроить доступы, аутентификацию Поддерживать работоспособность ```"},{"id":"cli/package-manager/easyp-vs-buf::buf::19","title":"EasyP против Buf: управление пакетами","section":"Buf: Требует инфраструктуру реестра","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Buf: Требует инфраструктуру реестра"],"excerpt":"Buf: Требует инфраструктуру реестра **Минусы:** ❌ Постоянный интернет или дорогой приватный BSR ❌ Сложная инфраструктура для частных установок ❌ Все модули нужно републиковать ❌ Дополнительные операционные затраты","content":"Buf: Требует инфраструктуру реестра **Минусы:** ❌ Постоянный интернет или дорогой приватный BSR ❌ Сложная инфраструктура для частных установок ❌ Все модули нужно републиковать ❌ Дополнительные операционные затраты"},{"id":"cli/package-manager/easyp-vs-buf::easyp::20","title":"EasyP против Buf: управление пакетами","section":"EasyP: Прямой контроль","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Прямой контроль"],"excerpt":"EasyP: Прямой контроль ```yaml Полный контроль источников deps: # Публичный репозиторий — ваша конкретная версия - github.com/googleapis/googleapis@common-protos-1_3_1","content":"EasyP: Прямой контроль ```yaml Полный контроль источников deps: # Публичный репозиторий — ваша конкретная версия - github.com/googleapis/googleapis@common-protos-1_3_1"},{"id":"cli/package-manager/easyp-vs-buf::easyp::21","title":"EasyP против Buf: управление пакетами","section":"EasyP: Прямой контроль","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Прямой контроль"],"excerpt":"EasyP: Прямой контроль Внутренний репозиторий - gitlab.company.com/security/validated-protos@v1.0.0","content":"EasyP: Прямой контроль Внутренний репозиторий - gitlab.company.com/security/validated-protos@v1.0.0"},{"id":"cli/package-manager/easyp-vs-buf::easyp::22","title":"EasyP против Buf: управление пакетами","section":"EasyP: Прямой контроль","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Прямой контроль"],"excerpt":"EasyP: Прямой контроль Точный коммит (горячий фикс) - github.com/bufbuild/protoc-gen-validate@abc123def456 ```","content":"EasyP: Прямой контроль Точный коммит (горячий фикс) - github.com/bufbuild/protoc-gen-validate@abc123def456 ```"},{"id":"cli/package-manager/easyp-vs-buf::easyp::23","title":"EasyP против Buf: управление пакетами","section":"EasyP: Прямой контроль","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Прямой контроль"],"excerpt":"EasyP: Прямой контроль **Преимущества по безопасности:** ✅ Нет посредника — берём из исходного репозитория ✅ Аудит через историю Git ✅ Нельзя «забанить» доступ извне ✅ Свои процессы сканирования / валидации ✅ Можно форкн","content":"EasyP: Прямой контроль **Преимущества по безопасности:** ✅ Нет посредника — берём из исходного репозитория ✅ Аудит через историю Git ✅ Нельзя «забанить» доступ извне ✅ Свои процессы сканирования / валидации ✅ Можно форкнуть и удерживать критические версии"},{"id":"cli/package-manager/easyp-vs-buf::buf::24","title":"EasyP против Buf: управление пакетами","section":"Buf: Зависимость от реестра","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Buf: Зависимость от реестра"],"excerpt":"Buf: Зависимость от реестра **Риски:** ⚠️ Посредник контролирует доступность ⚠️ Возможны ограничения / санкции на аккаунт ⚠️ Модуль могут удалить или депрекейтнуть ⚠️ Политики обновлений диктуются стороной ⚠️ Нужно довер","content":"Buf: Зависимость от реестра **Риски:** ⚠️ Посредник контролирует доступность ⚠️ Возможны ограничения / санкции на аккаунт ⚠️ Модуль могут удалить или депрекейтнуть ⚠️ Политики обновлений диктуются стороной ⚠️ Нужно доверять внешней безопасности"},{"id":"cli/package-manager/easyp-vs-buf::1::25","title":"EasyP против Buf: управление пакетами","section":"Сценарий 1: Стартап с публичными зависимостями","path":"/docs/guide/cli/package-manager/easyp-vs-buf#1","headings":["Сценарий 1: Стартап с публичными зависимостями"],"excerpt":"Сценарий 1: Стартап с публичными зависимостями **EasyP:**","content":"Сценарий 1: Стартап с публичными зависимостями **EasyP:**"},{"id":"cli/package-manager/easyp-vs-buf::1::26","title":"EasyP против Buf: управление пакетами","section":"Сценарий 1: Стартап с публичными зависимостями","path":"/docs/guide/cli/package-manager/easyp-vs-buf#1","headings":["Сценарий 1: Стартап с публичными зависимостями"],"excerpt":"Сценарий 1: Стартап с публичными зависимостями **Buf:**","content":"Сценарий 1: Стартап с публичными зависимостями **Buf:**"},{"id":"cli/package-manager/easyp-vs-buf::1::27","title":"EasyP против Buf: управление пакетами","section":"Сценарий 1: Стартап с публичными зависимостями","path":"/docs/guide/cli/package-manager/easyp-vs-buf#1","headings":["Сценарий 1: Стартап с публичными зависимостями"],"excerpt":"Сценарий 1: Стартап с публичными зависимостями **Итог:** Паритет — оба хорошо подходят для публичных пакетов.","content":"Сценарий 1: Стартап с публичными зависимостями **Итог:** Паритет — оба хорошо подходят для публичных пакетов."},{"id":"cli/package-manager/easyp-vs-buf::2::28","title":"EasyP против Buf: управление пакетами","section":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями","path":"/docs/guide/cli/package-manager/easyp-vs-buf#2","headings":["Сценарий 2: Компания со смешанными публичными/приватными зависимостями"],"excerpt":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями **EasyP:**","content":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями **EasyP:**"},{"id":"cli/package-manager/easyp-vs-buf::2::29","title":"EasyP против Buf: управление пакетами","section":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями","path":"/docs/guide/cli/package-manager/easyp-vs-buf#2","headings":["Сценарий 2: Компания со смешанными публичными/приватными зависимостями"],"excerpt":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями **Buf:**","content":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями **Buf:**"},{"id":"cli/package-manager/easyp-vs-buf::2::30","title":"EasyP против Buf: управление пакетами","section":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями","path":"/docs/guide/cli/package-manager/easyp-vs-buf#2","headings":["Сценарий 2: Компания со смешанными публичными/приватными зависимостями"],"excerpt":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями **Итог:** **EasyP** — не требует публикации внутрь BSR.","content":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями **Итог:** **EasyP** — не требует публикации внутрь BSR."},{"id":"cli/package-manager/easyp-vs-buf::3-airgap::31","title":"EasyP против Buf: управление пакетами","section":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap)","path":"/docs/guide/cli/package-manager/easyp-vs-buf#3-airgap","headings":["Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap)"],"excerpt":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap) **EasyP:**","content":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap) **EasyP:**"},{"id":"cli/package-manager/easyp-vs-buf::3-airgap::32","title":"EasyP против Buf: управление пакетами","section":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap)","path":"/docs/guide/cli/package-manager/easyp-vs-buf#3-airgap","headings":["Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap)"],"excerpt":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap) **Buf:**","content":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap) **Buf:**"},{"id":"cli/package-manager/easyp-vs-buf::3-airgap::33","title":"EasyP против Buf: управление пакетами","section":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap)","path":"/docs/guide/cli/package-manager/easyp-vs-buf#3-airgap","headings":["Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap)"],"excerpt":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap) **Итог:** **EasyP** — значительно проще.","content":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap) **Итог:** **EasyP** — значительно проще."},{"id":"cli/package-manager/easyp-vs-buf::4::34","title":"EasyP против Buf: управление пакетами","section":"Сценарий 4: Комплаенс и аудит","path":"/docs/guide/cli/package-manager/easyp-vs-buf#4","headings":["Сценарий 4: Комплаенс и аудит"],"excerpt":"Сценарий 4: Комплаенс и аудит **EasyP:** ✅ Прямой аудит изменений (коммиты) ✅ Нет внешних точек зависимости в проде ✅ Повторяемость через фиксированные коммиты / vendor ✅ Управление уязвимостями — в ваших руках","content":"Сценарий 4: Комплаенс и аудит **EasyP:** ✅ Прямой аудит изменений (коммиты) ✅ Нет внешних точек зависимости в проде ✅ Повторяемость через фиксированные коммиты / vendor ✅ Управление уязвимостями — в ваших руках"},{"id":"cli/package-manager/easyp-vs-buf::4::35","title":"EasyP против Buf: управление пакетами","section":"Сценарий 4: Комплаенс и аудит","path":"/docs/guide/cli/package-manager/easyp-vs-buf#4","headings":["Сценарий 4: Комплаенс и аудит"],"excerpt":"Сценарий 4: Комплаенс и аудит **Buf:** ⚠️ Нужно учитывать BSR в области аудита ⚠️ Дополнительный риск третьей стороны ⚠️ Модули — внешние контролируемые артефакты ⚠️ Сложнее трассировать от реестра к исходникам","content":"Сценарий 4: Комплаенс и аудит **Buf:** ⚠️ Нужно учитывать BSR в области аудита ⚠️ Дополнительный риск третьей стороны ⚠️ Модули — внешние контролируемые артефакты ⚠️ Сложнее трассировать от реестра к исходникам"},{"id":"cli/package-manager/easyp-vs-buf::4::36","title":"EasyP против Buf: управление пакетами","section":"Сценарий 4: Комплаенс и аудит","path":"/docs/guide/cli/package-manager/easyp-vs-buf#4","headings":["Сценарий 4: Комплаенс и аудит"],"excerpt":"Сценарий 4: Комплаенс и аудит **Итог:** **EasyP** — проще для комплаенса.","content":"Сценарий 4: Комплаенс и аудит **Итог:** **EasyP** — проще для комплаенса."},{"id":"cli/package-manager/easyp-vs-buf::easyp::37","title":"EasyP против Buf: управление пакетами","section":"EasyP: Нулевая дополнительная инфраструктура","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Нулевая дополнительная инфраструктура"],"excerpt":"EasyP: Нулевая дополнительная инфраструктура **Затраты:** ✅ $0 — используете существующий Git ✅ Нет дополнительных сервисов/серверов ✅ Нет лицензирования ✅ Масштабирование в рамках Git","content":"EasyP: Нулевая дополнительная инфраструктура **Затраты:** ✅ $0 — используете существующий Git ✅ Нет дополнительных сервисов/серверов ✅ Нет лицензирования ✅ Масштабирование в рамках Git"},{"id":"cli/package-manager/easyp-vs-buf::easyp::38","title":"EasyP против Buf: управление пакетами","section":"EasyP: Нулевая дополнительная инфраструктура","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Нулевая дополнительная инфраструктура"],"excerpt":"EasyP: Нулевая дополнительная инфраструктура **Инфраструктура:** Использует текущие репозитории (GitHub/GitLab/и т.д.) Аутентификация — штатная Резервирование/DR — как уже настроено для Git","content":"EasyP: Нулевая дополнительная инфраструктура **Инфраструктура:** Использует текущие репозитории (GitHub/GitLab/и т.д.) Аутентификация — штатная Резервирование/DR — как уже настроено для Git"},{"id":"cli/package-manager/easyp-vs-buf::buf::39","title":"EasyP против Buf: управление пакетами","section":"Buf: Затраты на реестр","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Buf: Затраты на реестр"],"excerpt":"Buf: Затраты на реестр **Hosted BSR (buf.build):** ✅ Бесплатный уровень ❌ Платные тарифы для приватного и расширенного использования ❌ Потенциальные изменения ценовой политики ❌ Вопросы локализации данных","content":"Buf: Затраты на реестр **Hosted BSR (buf.build):** ✅ Бесплатный уровень ❌ Платные тарифы для приватного и расширенного использования ❌ Потенциальные изменения ценовой политики ❌ Вопросы локализации данных"},{"id":"cli/package-manager/easyp-vs-buf::buf::40","title":"EasyP против Buf: управление пакетами","section":"Buf: Затраты на реестр","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Buf: Затраты на реестр"],"excerpt":"Buf: Затраты на реестр **Приватный BSR:** ❌ Серверы, БД, балансировка ❌ Мониторинг, обновления, бэкапы ❌ Лицензирование enterprise функционала ❌ Доп. планирование отказоустойчивости","content":"Buf: Затраты на реестр **Приватный BSR:** ❌ Серверы, БД, балансировка ❌ Мониторинг, обновления, бэкапы ❌ Лицензирование enterprise функционала ❌ Доп. планирование отказоустойчивости"},{"id":"cli/package-manager/easyp-vs-buf::easyp::41","title":"EasyP против Buf: управление пакетами","section":"EasyP: Нет привязки","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Нет привязки"],"excerpt":"EasyP: Нет привязки **Миграция ИЗ EasyP:** (Обычные Git ссылки — легко перенести в другой инструмент.)","content":"EasyP: Нет привязки **Миграция ИЗ EasyP:** (Обычные Git ссылки — легко перенести в другой инструмент.)"},{"id":"cli/package-manager/easyp-vs-buf::easyp::42","title":"EasyP против Buf: управление пакетами","section":"EasyP: Нет привязки","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Нет привязки"],"excerpt":"EasyP: Нет привязки **Миграция В EasyP:**","content":"EasyP: Нет привязки **Миграция В EasyP:**"},{"id":"cli/package-manager/easyp-vs-buf::buf-lockin::43","title":"EasyP против Buf: управление пакетами","section":"Buf: Потенциальный lock‑in","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-lockin","headings":["Buf: Потенциальный lock‑in"],"excerpt":"Buf: Потенциальный lock‑in **Миграция ИЗ Buf:** ❌ Нужно сопоставить BSR модули с исходными Git репо ❌ Имена модулей BSR не совпадают с URL ❌ Возможна потеря удобных метаданных ❌ Сложно при глубокой интеграции с BSR","content":"Buf: Потенциальный lock‑in **Миграция ИЗ Buf:** ❌ Нужно сопоставить BSR модули с исходными Git репо ❌ Имена модулей BSR не совпадают с URL ❌ Возможна потеря удобных метаданных ❌ Сложно при глубокой интеграции с BSR"},{"id":"cli/package-manager/easyp-vs-buf::buf-lockin::44","title":"EasyP против Buf: управление пакетами","section":"Buf: Потенциальный lock‑in","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-lockin","headings":["Buf: Потенциальный lock‑in"],"excerpt":"Buf: Потенциальный lock‑in **Миграция В Buf:** ❌ Нужно опубликовать всё в BSR ❌ Нельзя ссылаться напрямую на Git ❌ Принять workflow BSR (push/pull модулей)","content":"Buf: Потенциальный lock‑in **Миграция В Buf:** ❌ Нужно опубликовать всё в BSR ❌ Нельзя ссылаться напрямую на Git ❌ Принять workflow BSR (push/pull модулей)"},{"id":"cli/package-manager/easyp-vs-buf::easyp::45","title":"EasyP против Buf: управление пакетами","section":"Выберите EasyP, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["Выберите EasyP, если:"],"excerpt":"Выберите EasyP, если: ✅ **Air‑gapped / закрытые среды** Нужна работа без внешних сервисов Строгий комплаенс / контроль цепочки поставок","content":"Выберите EasyP, если: ✅ **Air‑gapped / закрытые среды** Нужна работа без внешних сервисов Строгий комплаенс / контроль цепочки поставок"},{"id":"cli/package-manager/easyp-vs-buf::easyp::46","title":"EasyP против Buf: управление пакетами","section":"Выберите EasyP, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["Выберите EasyP, если:"],"excerpt":"Выберите EasyP, если: ✅ **Фокус на безопасности** Контроль источников зависимостей Минимизация рисков третьих сторон","content":"Выберите EasyP, если: ✅ **Фокус на безопасности** Контроль источников зависимостей Минимизация рисков третьих сторон"},{"id":"cli/package-manager/easyp-vs-buf::easyp::47","title":"EasyP против Buf: управление пакетами","section":"Выберите EasyP, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["Выберите EasyP, если:"],"excerpt":"Выберите EasyP, если: ✅ **Git‑центричная культура** Частные репозитории — норма Не хотите добавлять новый ключевой сервис","content":"Выберите EasyP, если: ✅ **Git‑центричная культура** Частные репозитории — норма Не хотите добавлять новый ключевой сервис"},{"id":"cli/package-manager/easyp-vs-buf::easyp::48","title":"EasyP против Buf: управление пакетами","section":"Выберите EasyP, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["Выберите EasyP, если:"],"excerpt":"Выберите EasyP, если: ✅ **Ограниченный бюджет** Минимизация операционных расходов Предсказуемая стоимость = 0","content":"Выберите EasyP, если: ✅ **Ограниченный бюджет** Минимизация операционных расходов Предсказуемая стоимость = 0"},{"id":"cli/package-manager/easyp-vs-buf::easyp::49","title":"EasyP против Buf: управление пакетами","section":"Выберите EasyP, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["Выберите EasyP, если:"],"excerpt":"Выберите EasyP, если: ✅ **Смешанные публичные/частные зависимости** Не хотите перекладывать всё в реестр Нужна гибкость форматов и размещения","content":"Выберите EasyP, если: ✅ **Смешанные публичные/частные зависимости** Не хотите перекладывать всё в реестр Нужна гибкость форматов и размещения"},{"id":"cli/package-manager/easyp-vs-buf::buf::50","title":"EasyP против Buf: управление пакетами","section":"Выберите Buf, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Выберите Buf, если:"],"excerpt":"Выберите Buf, если: ✅ **Глубокая интеграция в экосистему BSR** Уже используете линтеры / генерацию Buf Нужны курируемые официальные модули Важны метаданные и граф зависимостей","content":"Выберите Buf, если: ✅ **Глубокая интеграция в экосистему BSR** Уже используете линтеры / генерацию Buf Нужны курируемые официальные модули Важны метаданные и граф зависимостей"},{"id":"cli/package-manager/easyp-vs-buf::buf::51","title":"EasyP против Buf: управление пакетами","section":"Выберите Buf, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Выберите Buf, если:"],"excerpt":"Выберите Buf, если: ✅ **Сотрудничество и открытая разработка** Централизованное обнаружение модулей Совместная работа над общими пакетами","content":"Выберите Buf, если: ✅ **Сотрудничество и открытая разработка** Централизованное обнаружение модулей Совместная работа над общими пакетами"},{"id":"cli/package-manager/easyp-vs-buf::buf::52","title":"EasyP против Buf: управление пакетами","section":"Выберите Buf, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Выберите Buf, если:"],"excerpt":"Выберите Buf, если: ✅ **Команда новичков в protobuf** Требуется «направляющая» структура Ценность документации внутри реестра","content":"Выберите Buf, если: ✅ **Команда новичков в protobuf** Требуется «направляющая» структура Ценность документации внутри реестра"},{"id":"cli/package-manager/easyp-vs-buf::buf::53","title":"EasyP против Buf: управление пакетами","section":"Выберите Buf, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Выберите Buf, если:"],"excerpt":"Выберите Buf, если: ✅ **Небольшой набор публичных зависимостей** В основном используете популярные общие пакеты Вас устраивает зависимость от BSR","content":"Выберите Buf, если: ✅ **Небольшой набор публичных зависимостей** В основном используете популярные общие пакеты Вас устраивает зависимость от BSR"},{"id":"cli/package-manager/easyp-vs-buf::buf-easyp::54","title":"EasyP против Buf: управление пакетами","section":"Переход с Buf на EasyP","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-easyp","headings":["Переход с Buf на EasyP"],"excerpt":"Переход с Buf на EasyP Найдите исходные Git репозитории для каждого модуля BSR Сопоставьте имена BSR → Git ссылки (с версиями/тегами) Обновите конфигурацию (easyp.yaml) Протестируйте генерацию и совместимость","content":"Переход с Buf на EasyP Найдите исходные Git репозитории для каждого модуля BSR Сопоставьте имена BSR → Git ссылки (с версиями/тегами) Обновите конфигурацию (easyp.yaml) Протестируйте генерацию и совместимость"},{"id":"cli/package-manager/easyp-vs-buf::buf-easyp::55","title":"EasyP против Buf: управление пакетами","section":"Переход с Buf на EasyP","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-easyp","headings":["Переход с Buf на EasyP"],"excerpt":"Переход с Buf на EasyP ```yaml Было (buf.yaml) deps: - buf.build/googleapis/googleapis - buf.build/grpc/grpc","content":"Переход с Buf на EasyP ```yaml Было (buf.yaml) deps: - buf.build/googleapis/googleapis - buf.build/grpc/grpc"},{"id":"cli/package-manager/easyp-vs-buf::buf-easyp::56","title":"EasyP против Buf: управление пакетами","section":"Переход с Buf на EasyP","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-easyp","headings":["Переход с Buf на EasyP"],"excerpt":"Переход с Buf на EasyP Стало (easyp.yaml) deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc/grpc@v1.50.0 ```","content":"Переход с Buf на EasyP Стало (easyp.yaml) deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc/grpc@v1.50.0 ```"},{"id":"cli/package-manager/easyp-vs-buf::easyp-buf::57","title":"EasyP против Buf: управление пакетами","section":"Переход с EasyP на Buf","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-buf","headings":["Переход с EasyP на Buf"],"excerpt":"Переход с EasyP на Buf Опубликуйте используемые репозитории как модули BSR Настройте аутентификацию / организацию Buf Замените Git ссылки на BSR модули Перейдите к push/pull workflow Buf","content":"Переход с EasyP на Buf Опубликуйте используемые репозитории как модули BSR Настройте аутентификацию / организацию Buf Замените Git ссылки на BSR модули Перейдите к push/pull workflow Buf"},{"id":"cli/package-manager/easyp-vs-buf::top::58","title":"EasyP против Buf: управление пакетами","section":"Заключение","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":["Заключение"],"excerpt":"Заключение Оба инструмента решают задачу управления зависимостями protobuf, но подходят под разные приоритеты:","content":"Заключение Оба инструмента решают задачу управления зависимостями protobuf, но подходят под разные приоритеты:"},{"id":"cli/package-manager/easyp-vs-buf::top::59","title":"EasyP против Buf: управление пакетами","section":"Заключение","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":["Заключение"],"excerpt":"Заключение **Сильные стороны EasyP:** Корпоративные / изолированные среды Жёсткие требования безопасности и аудита Минимальные затраты и отсутствие доп. инфраструктуры Прямое использование Git (без промежуточного слоя) П","content":"Заключение **Сильные стороны EasyP:** Корпоративные / изолированные среды Жёсткие требования безопасности и аудита Минимальные затраты и отсутствие доп. инфраструктуры Прямое использование Git (без промежуточного слоя) Простота масштабирования"},{"id":"cli/package-manager/easyp-vs-buf::top::60","title":"EasyP против Buf: управление пакетами","section":"Заключение","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":["Заключение"],"excerpt":"Заключение **Сильные стороны Buf:** Богатая экосистема вокруг реестра Курируемые и документированные модули Удобство для новых команд в protobuf Средства визуализации и централизованного обмена","content":"Заключение **Сильные стороны Buf:** Богатая экосистема вокруг реестра Курируемые и документированные модули Удобство для новых команд в protobuf Средства визуализации и централизованного обмена"},{"id":"cli/package-manager/easyp-vs-buf::top::61","title":"EasyP против Buf: управление пакетами","section":"Заключение","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":["Заключение"],"excerpt":"Заключение Выбор часто сводится к балансу между **контролем vs. удобством**, **безопасностью vs. централизованными функциями**, и **стоимостью vs. managed‑сервисом**.","content":"Заключение Выбор часто сводится к балансу между **контролем vs. удобством**, **безопасностью vs. централизованными функциями**, и **стоимостью vs. managed‑сервисом**."},{"id":"cli/package-manager/easyp-vs-buf::top::62","title":"EasyP против Buf: управление пакетами","section":"Заключение","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":["Заключение"],"excerpt":"Заключение Для большинства enterprise‑окружений децентрализованный Git‑подход EasyP обеспечивает нужные гибкость, безопасность и предсказуемость расходов, тогда как Buf отлично подходит командам, которым важна централизо","content":"Заключение Для большинства enterprise‑окружений децентрализованный Git‑подход EasyP обеспечивает нужные гибкость, безопасность и предсказуемость расходов, тогда как Buf отлично подходит командам, которым важна централизованная коллаборация и богатая экосистема вокруг реестра."},{"id":"cli/package-manager/package-manager::top::0","title":"Менеджер пакетов","path":"/docs/guide/cli/package-manager/package-manager","headings":[],"excerpt":"EasyP предоставляет мощный менеджер пакетов для protobuf‑зависимостей, упрощающий их управление за счёт децентрализованного подхода на базе Git. В отличие от централизованных решений, EasyP работает напрямую с Git‑репози","content":"EasyP предоставляет мощный менеджер пакетов для protobuf‑зависимостей, упрощающий их управление за счёт децентрализованного подхода на базе Git. В отличие от централизованных решений, EasyP работает напрямую с Git‑репозиториями, давая вам полный контроль."},{"id":"cli/package-manager/package-manager::top::1","title":"Менеджер пакетов","section":"Обзор","path":"/docs/guide/cli/package-manager/package-manager","headings":["Обзор"],"excerpt":"Обзор Менеджер пакетов EasyP следует философии **Go modules** — любой Git‑репозиторий может быть источником. Это даёт преимущества:","content":"Обзор Менеджер пакетов EasyP следует философии **Go modules** — любой Git‑репозиторий может быть источником. Это даёт преимущества:"},{"id":"cli/package-manager/package-manager::top::2","title":"Менеджер пакетов","section":"Обзор","path":"/docs/guide/cli/package-manager/package-manager","headings":["Обзор"],"excerpt":"Обзор **Децентрализация** — нет единой точки отказа или контроля **Безопасность** — прямой доступ к исходникам **Гибкость** — публичные, приватные и корпоративные репозитории **Воспроизводимость** — lock‑файлы обеспечива","content":"Обзор **Децентрализация** — нет единой точки отказа или контроля **Безопасность** — прямой доступ к исходникам **Гибкость** — публичные, приватные и корпоративные репозитории **Воспроизводимость** — lock‑файлы обеспечивают одинаковые сборки **Производительность** — локальный кеш сокращает сетевые запросы"},{"id":"cli/package-manager/package-manager::top::3","title":"Менеджер пакетов","section":"Основные возможности","path":"/docs/guide/cli/package-manager/package-manager","headings":["Основные возможности"],"excerpt":"Основные возможности Возможность Описание ------------- ---------- **Git-Native** Любой Git репозиторий, не нужен спец‑сервер **Множество форматов версий** Теги, коммиты, псевдо‑версии, latest **Lock Files** Воспроизводи","content":"Основные возможности Возможность Описание ------------- ---------- **Git-Native** Любой Git репозиторий, не нужен спец‑сервер **Множество форматов версий** Теги, коммиты, псевдо‑версии, latest **Lock Files** Воспроизводимые сборки через easyp.lock **Локальный кеш** Архитектура как у Go modules **Vendoring** Локальное копирование для оффлайн сборок **YAML конфигурация** Простые и читаемые декларации"},{"id":"cli/package-manager/package-manager::top::4","title":"Менеджер пакетов","section":"Архитектура","path":"/docs/guide/cli/package-manager/package-manager","headings":["Архитектура"],"excerpt":"Архитектура EasyP использует двухуровневый кеш, вдохновлённый Go modules:","content":"Архитектура EasyP использует двухуровневый кеш, вдохновлённый Go modules:"},{"id":"cli/package-manager/package-manager::top::5","title":"Менеджер пакетов","section":"Расположение кеша","path":"/docs/guide/cli/package-manager/package-manager","headings":["Расположение кеша"],"excerpt":"Расположение кеша Окружение Путь Как задать ----------- ------ ----------- **По умолчанию** $HOME/.easyp Автоматически **Свое** Любая директория Переменная EASYPPATH **CI/CD** В каталоге проекта export EASYPPATH=$CI_PROJ","content":"Расположение кеша Окружение Путь Как задать ----------- ------ ----------- **По умолчанию** $HOME/.easyp Автоматически **Свое** Любая директория Переменная EASYPPATH **CI/CD** В каталоге проекта export EASYPPATH=$CI_PROJECT_DIR/.easyp"},{"id":"cli/package-manager/package-manager::top::6","title":"Менеджер пакетов","section":"Базовая конфигурация","path":"/docs/guide/cli/package-manager/package-manager","headings":["Базовая конфигурация"],"excerpt":"Базовая конфигурация Зависимости описываются в easyp.yaml:","content":"Базовая конфигурация Зависимости описываются в easyp.yaml:"},{"id":"cli/package-manager/package-manager::multi-environment-setup::7","title":"Менеджер пакетов","section":"Multi-Environment Setup","path":"/docs/guide/cli/package-manager/package-manager#multi-environment-setup","headings":["Multi-Environment Setup"],"excerpt":"Multi-Environment Setup ```yaml development.easyp.yaml deps: - github.com/googleapis/googleapis # Последнее для разработки - github.com/mycompany/internal-protos # Внутренние изменения - github.com/bufbuild/protoc-gen-va","content":"Multi-Environment Setup ```yaml development.easyp.yaml deps: - github.com/googleapis/googleapis # Последнее для разработки - github.com/mycompany/internal-protos # Внутренние изменения - github.com/bufbuild/protoc-gen-validate # Новые фичи"},{"id":"cli/package-manager/package-manager::multi-environment-setup::8","title":"Менеджер пакетов","section":"Multi-Environment Setup","path":"/docs/guide/cli/package-manager/package-manager#multi-environment-setup","headings":["Multi-Environment Setup"],"excerpt":"Multi-Environment Setup production.easyp.yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1 # Зафиксировано - github.com/mycompany/internal-protos@v2.1.0 # Стабильно - github.com/bufbuild/protoc-gen-valida","content":"Multi-Environment Setup production.easyp.yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1 # Зафиксировано - github.com/mycompany/internal-protos@v2.1.0 # Стабильно - github.com/bufbuild/protoc-gen-validate@v0.10.1 # Проверено ```"},{"id":"cli/package-manager/package-manager::top::9","title":"Менеджер пакетов","section":"Приватные репозитории","path":"/docs/guide/cli/package-manager/package-manager","headings":["Приватные репозитории"],"excerpt":"Приватные репозитории ```yaml deps: # Публичное - github.com/googleapis/googleapis@common-protos-1_3_1","content":"Приватные репозитории ```yaml deps: # Публичное - github.com/googleapis/googleapis@common-protos-1_3_1"},{"id":"cli/package-manager/package-manager::top::10","title":"Менеджер пакетов","section":"Приватные репозитории","path":"/docs/guide/cli/package-manager/package-manager","headings":["Приватные репозитории"],"excerpt":"Приватные репозитории Частные - github.com/mycompany/auth-protos@v1.5.0 - github.com/mycompany/common-types@v2.0.1","content":"Приватные репозитории Частные - github.com/mycompany/auth-protos@v1.5.0 - github.com/mycompany/common-types@v2.0.1"},{"id":"cli/package-manager/package-manager::top::11","title":"Менеджер пакетов","section":"Приватные репозитории","path":"/docs/guide/cli/package-manager/package-manager","headings":["Приватные репозитории"],"excerpt":"Приватные репозитории Внутренний GitLab - gitlab.company.com/platform/messaging-protos@v0.3.0 ```","content":"Приватные репозитории Внутренний GitLab - gitlab.company.com/platform/messaging-protos@v0.3.0 ```"},{"id":"cli/package-manager/package-manager::top::12","title":"Менеджер пакетов","section":"Стратегии версионирования","path":"/docs/guide/cli/package-manager/package-manager","headings":["Стратегии версионирования"],"excerpt":"Стратегии версионирования Поддерживаются разные способы фиксации версий:","content":"Стратегии версионирования Поддерживаются разные способы фиксации версий:"},{"id":"cli/package-manager/package-manager::1::13","title":"Менеджер пакетов","section":"1. Семантические теги (для продакшена)","path":"/docs/guide/cli/package-manager/package-manager#1","headings":["1. Семантические теги (для продакшена)"],"excerpt":"Семантические теги (для продакшена)","content":"Семантические теги (для продакшена)"},{"id":"cli/package-manager/package-manager::1::14","title":"Менеджер пакетов","section":"1. Семантические теги (для продакшена)","path":"/docs/guide/cli/package-manager/package-manager#1","headings":["1. Семантические теги (для продакшена)"],"excerpt":"Семантические теги (для продакшена) **Используйте когда:** Продакшен Стабильное потребление API Нужна воспроизводимость","content":"Семантические теги (для продакшена) **Используйте когда:** Продакшен Стабильное потребление API Нужна воспроизводимость"},{"id":"cli/package-manager/package-manager::2-development::15","title":"Менеджер пакетов","section":"2. Последний тег (development)","path":"/docs/guide/cli/package-manager/package-manager#2-development","headings":["2. Последний тег (development)"],"excerpt":"Последний тег (development) **Подходит для:** Активной разработки Получения свежих возможностей Тестирования совместимости","content":"Последний тег (development) **Подходит для:** Активной разработки Получения свежих возможностей Тестирования совместимости"},{"id":"cli/package-manager/package-manager::3-bleeding-edge::16","title":"Менеджер пакетов","section":"3. Хеш коммита (Bleeding Edge)","path":"/docs/guide/cli/package-manager/package-manager#3-bleeding-edge","headings":["3. Хеш коммита (Bleeding Edge)"],"excerpt":"Хеш коммита (Bleeding Edge) **Когда нужно:** Нерелизные фичи Тест конкретного фикса Вклад в upstream","content":"Хеш коммита (Bleeding Edge) **Когда нужно:** Нерелизные фичи Тест конкретного фикса Вклад в upstream"},{"id":"cli/package-manager/package-manager::4::17","title":"Менеджер пакетов","section":"4. Псевдо‑версии (автоматически)","path":"/docs/guide/cli/package-manager/package-manager#4","headings":["4. Псевдо‑версии (автоматически)"],"excerpt":"Псевдо‑версии (автоматически) Если нет подходящего тега — создаётся псевдо‑версия:","content":"Псевдо‑версии (автоматически) Если нет подходящего тега — создаётся псевдо‑версия:"},{"id":"cli/package-manager/package-manager::easyp-mod-download::18","title":"Менеджер пакетов","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download Скачивает и устанавливает все объявленные зависимости.","content":"easyp mod download Скачивает и устанавливает все объявленные зависимости."},{"id":"cli/package-manager/package-manager::easyp-mod-download::19","title":"Менеджер пакетов","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download **Что делает:** Разрешает версии (теги → коммиты) Скачивает архивы в cache/download Проверяет контрольные суммы Распаковывает в cache/mod Обновляет easyp.lock","content":"easyp mod download **Что делает:** Разрешает версии (теги → коммиты) Скачивает архивы в cache/download Проверяет контрольные суммы Распаковывает в cache/mod Обновляет easyp.lock"},{"id":"cli/package-manager/package-manager::easyp-mod-download::20","title":"Менеджер пакетов","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download **Пример:**","content":"easyp mod download **Пример:**"},{"id":"cli/package-manager/package-manager::easyp-mod-vendor::21","title":"Менеджер пакетов","section":"easyp mod vendor","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor Копирует все proto зависимости в локальный easyp_vendor/ для оффлайна.","content":"easyp mod vendor Копирует все proto зависимости в локальный easyp_vendor/ для оффлайна."},{"id":"cli/package-manager/package-manager::easyp-mod-vendor::22","title":"Менеджер пакетов","section":"easyp mod vendor","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor **Сценарии:** Docker сборки Air-gapped окружения Воспроизводимость Ускорение","content":"easyp mod vendor **Сценарии:** Docker сборки Air-gapped окружения Воспроизводимость Ускорение"},{"id":"cli/package-manager/package-manager::easyp-mod-update::23","title":"Менеджер пакетов","section":"easyp mod update","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-update","headings":["easyp mod update"],"excerpt":"easyp mod update Обновляет версии согласно easyp.yaml, пересоздаёт lock.","content":"easyp mod update Обновляет версии согласно easyp.yaml, пересоздаёт lock."},{"id":"cli/package-manager/package-manager::lock::24","title":"Менеджер пакетов","section":"Lock файл","path":"/docs/guide/cli/package-manager/package-manager#lock","headings":["Lock файл"],"excerpt":"Lock файл easyp.lock фиксирует точные версии и хеш содержимого:","content":"Lock файл easyp.lock фиксирует точные версии и хеш содержимого:"},{"id":"cli/package-manager/package-manager::lock::25","title":"Менеджер пакетов","section":"Lock файл","path":"/docs/guide/cli/package-manager/package-manager#lock","headings":["Lock файл"],"excerpt":"Lock файл **Формат строки:** Путь модуля Версия (тег или псевдо) Хеш содержимого (h1:)","content":"Lock файл **Формат строки:** Путь модуля Версия (тег или псевдо) Хеш содержимого (h1:)"},{"id":"cli/package-manager/package-manager::lock::26","title":"Менеджер пакетов","section":"Lock файл","path":"/docs/guide/cli/package-manager/package-manager#lock","headings":["Lock файл"],"excerpt":"Lock файл **Практики:** ✅ Коммитить easyp.lock ✅ Осознанно обновлять mod update ✅ Ревью изменений версий ❌ Не редактировать вручную","content":"Lock файл **Практики:** ✅ Коммитить easyp.lock ✅ Осознанно обновлять mod update ✅ Ревью изменений версий ❌ Не редактировать вручную"},{"id":"cli/package-manager/package-manager::top::27","title":"Менеджер пакетов","section":"Публичные репозитории","path":"/docs/guide/cli/package-manager/package-manager","headings":["Публичные репозитории"],"excerpt":"Публичные репозитории Работают без настроек:","content":"Публичные репозитории Работают без настроек:"},{"id":"cli/package-manager/package-manager::ssh::28","title":"Менеджер пакетов","section":"SSH ключи (рекомендуется)","path":"/docs/guide/cli/package-manager/package-manager#ssh","headings":["SSH ключи (рекомендуется)"],"excerpt":"SSH ключи (рекомендуется) Конфиг остаётся с HTTPS URL:","content":"SSH ключи (рекомендуется) Конфиг остаётся с HTTPS URL:"},{"id":"cli/package-manager/package-manager::personal-access-tokens::29","title":"Менеджер пакетов","section":"Personal Access Tokens","path":"/docs/guide/cli/package-manager/package-manager#personal-access-tokens","headings":["Personal Access Tokens"],"excerpt":"Personal Access Tokens ```bash git config --global credential.helper store echo \"https://username:token@github.com\" >> ~/.git-credentials","content":"Personal Access Tokens ```bash git config --global credential.helper store echo \"https://username:token@github.com\" >> ~/.git-credentials"},{"id":"cli/package-manager/package-manager::personal-access-tokens::30","title":"Менеджер пакетов","section":"Personal Access Tokens","path":"/docs/guide/cli/package-manager/package-manager#personal-access-tokens","headings":["Personal Access Tokens"],"excerpt":"Personal Access Tokens git config --global url.\"https://username:token@github.com/mycompany\".insteadOf \"https://github.com/mycompany\" ```","content":"Personal Access Tokens git config --global url.\"https://username:token@github.com/mycompany\".insteadOf \"https://github.com/mycompany\" ```"},{"id":"cli/package-manager/package-manager::top::31","title":"Менеджер пакетов","section":"Инициализация проекта","path":"/docs/guide/cli/package-manager/package-manager","headings":["Инициализация проекта"],"excerpt":"Инициализация проекта ```bash cat > easyp.yaml << EOF deps: - github.com/googleapis/googleapis - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 EOF","content":"Инициализация проекта ```bash cat > easyp.yaml << EOF deps: - github.com/googleapis/googleapis - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 EOF"},{"id":"cli/package-manager/package-manager::top::32","title":"Менеджер пакетов","section":"Инициализация проекта","path":"/docs/guide/cli/package-manager/package-manager","headings":["Инициализация проекта"],"excerpt":"Инициализация проекта easyp mod download ls ~/.easyp/mod/github.com/googleapis/googleapis/ ```","content":"Инициализация проекта easyp mod download ls ~/.easyp/mod/github.com/googleapis/googleapis/ ```"},{"id":"cli/package-manager/package-manager::repository-not-found-authentication-failed::33","title":"Менеджер пакетов","section":"\"Repository not found\" / \"Authentication failed\"","path":"/docs/guide/cli/package-manager/package-manager#repository-not-found-authentication-failed","headings":["\"Repository not found\" / \"Authentication failed\""],"excerpt":"\"Repository not found\" / \"Authentication failed\"","content":"\"Repository not found\" / \"Authentication failed\""},{"id":"cli/package-manager/package-manager::cache-corruption-checksum-mismatch::34","title":"Менеджер пакетов","section":"\"Cache corruption\" / \"Checksum mismatch\"","path":"/docs/guide/cli/package-manager/package-manager#cache-corruption-checksum-mismatch","headings":["\"Cache corruption\" / \"Checksum mismatch\""],"excerpt":"\"Cache corruption\" / \"Checksum mismatch\"","content":"\"Cache corruption\" / \"Checksum mismatch\""},{"id":"cli/package-manager/package-manager::docker-multi-stage::35","title":"Менеджер пакетов","section":"Docker multi-stage","path":"/docs/guide/cli/package-manager/package-manager#docker-multi-stage","headings":["Docker multi-stage"],"excerpt":"Docker multi-stage ```dockerfile FROM ghcr.io/easyp-tech/easyp:latest AS deps WORKDIR /workspace COPY easyp.yaml easyp.lock ./ RUN easyp mod vendor","content":"Docker multi-stage ```dockerfile FROM ghcr.io/easyp-tech/easyp:latest AS deps WORKDIR /workspace COPY easyp.yaml easyp.lock ./ RUN easyp mod vendor"},{"id":"cli/package-manager/package-manager::docker-multi-stage::36","title":"Менеджер пакетов","section":"Docker multi-stage","path":"/docs/guide/cli/package-manager/package-manager#docker-multi-stage","headings":["Docker multi-stage"],"excerpt":"Docker multi-stage FROM alpine:latest AS build WORKDIR /app COPY --from=deps /workspace/easyp_vendor ./easyp_vendor COPY . . RUN easyp generate ```","content":"Docker multi-stage FROM alpine:latest AS build WORKDIR /app COPY --from=deps /workspace/easyp_vendor ./easyp_vendor COPY . . RUN easyp generate ```"},{"id":"cli/package-manager/package-manager::monorepo::37","title":"Менеджер пакетов","section":"Monorepo","path":"/docs/guide/cli/package-manager/package-manager#monorepo","headings":["Monorepo"],"excerpt":"Monorepo Каждый easyp.yaml может иметь свой набор зависимостей.","content":"Monorepo Каждый easyp.yaml может иметь свой набор зависимостей."},{"id":"cli/package-manager/package-manager::workflow::38","title":"Менеджер пакетов","section":"Workflow разработки","path":"/docs/guide/cli/package-manager/package-manager#workflow","headings":["Workflow разработки"],"excerpt":"Workflow разработки ✅ Latest теги в активной разработке ✅ Фиксация версий в продакшене ✅ Коммит lock файла ✅ Ревью обновлений ✅ Тест после обновления","content":"Workflow разработки ✅ Latest теги в активной разработке ✅ Фиксация версий в продакшене ✅ Коммит lock файла ✅ Ревью обновлений ✅ Тест после обновления"},{"id":"cli/package-manager/package-manager::top::39","title":"Менеджер пакетов","section":"Безопасность","path":"/docs/guide/cli/package-manager/package-manager","headings":["Безопасность"],"excerpt":"Безопасность ✅ Фиксируйте версии ✅ Используйте SSH ключи ✅ Оценивайте новые зависимости ✅ Следите за уязвимостями ❌ Не храните секреты в конфиге","content":"Безопасность ✅ Фиксируйте версии ✅ Используйте SSH ключи ✅ Оценивайте новые зависимости ✅ Следите за уязвимостями ❌ Не храните секреты в конфиге"},{"id":"cli/package-manager/package-manager::top::40","title":"Менеджер пакетов","section":"Производительность","path":"/docs/guide/cli/package-manager/package-manager","headings":["Производительность"],"excerpt":"Производительность ✅ Агрессивное кеширование в CI ✅ Vendoring для частых сборок ✅ Чистка старого кеша ✅ Общий кеш для команды","content":"Производительность ✅ Агрессивное кеширование в CI ✅ Vendoring для частых сборок ✅ Чистка старого кеша ✅ Общий кеш для команды"},{"id":"cli/package-manager/package-manager::top::41","title":"Менеджер пакетов","section":"Командная работа","path":"/docs/guide/cli/package-manager/package-manager","headings":["Командная работа"],"excerpt":"Командная работа ✅ Документация по аутентификации ✅ Единые инструменты ✅ Автоматизация обновлений с тестами ✅ Общий кеш при возможности","content":"Командная работа ✅ Документация по аутентификации ✅ Единые инструменты ✅ Автоматизация обновлений с тестами ✅ Общий кеш при возможности"},{"id":"cli/package-manager/package-manager::top::42","title":"Менеджер пакетов","section":"Командная работа","path":"/docs/guide/cli/package-manager/package-manager","headings":["Командная работа"],"excerpt":"Командная работа Менеджер пакетов EasyP — масштабируемое децентрализованное решение от одиночных проектов до enterprise, сохраняя простоту и надёжность.","content":"Командная работа Менеджер пакетов EasyP — масштабируемое децентрализованное решение от одиночных проектов до enterprise, сохраняя простоту и надёжность."},{"id":"introduction/install::top::0","title":"Установка EasyP CLI","section":"Установка через менеджер пакетов системы","path":"/docs/guide/introduction/install","headings":["Установка через менеджер пакетов системы"],"excerpt":"Установка через менеджер пакетов системы","content":"Установка через менеджер пакетов системы"},{"id":"introduction/install::top::1","title":"Установка EasyP CLI","section":"Рекомендуемый способ установки","path":"/docs/guide/introduction/install","headings":["Рекомендуемый способ установки"],"excerpt":"Рекомендуемый способ установки","content":"Рекомендуемый способ установки"},{"id":"introduction/install::homebrew::2","title":"Установка EasyP CLI","section":"Homebrew","path":"/docs/guide/introduction/install#homebrew","headings":["Homebrew"],"excerpt":"Homebrew Можно установить бинарный релиз в macOS через Homebrew:","content":"Homebrew Можно установить бинарный релиз в macOS через Homebrew:"},{"id":"introduction/install::homebrew::3","title":"Установка EasyP CLI","section":"Homebrew","path":"/docs/guide/introduction/install#homebrew","headings":["Homebrew"],"excerpt":"Homebrew Work in progress — поддержка других менеджеров (apt, yum, pacman и т.д.) в процессе.","content":"Homebrew Work in progress — поддержка других менеджеров (apt, yum, pacman и т.д.) в процессе."},{"id":"introduction/install::_-_::4","title":"Установка EasyP CLI","section":"_Не рекомендуется_","path":"/docs/guide/introduction/install#_-_","headings":["_Не рекомендуется_"],"excerpt":"_Не рекомендуется_ Локальная установка менее предпочтительна, потому что пакетные менеджеры обеспечивают: Автоматические обновления и патчи безопасности Лучшую интеграцию с системой Упрощённую установку и удаление Подпис","content":"_Не рекомендуется_ Локальная установка менее предпочтительна, потому что пакетные менеджеры обеспечивают: Автоматические обновления и патчи безопасности Лучшую интеграцию с системой Упрощённую установку и удаление Подписанные и проверенные бинарники"},{"id":"introduction/install::go-install::5","title":"Установка EasyP CLI","section":"Установка через go install","path":"/docs/guide/introduction/install#go-install","headings":["Установка через go install"],"excerpt":"Установка через go install Команда установит последнюю стабильную версию easyp:","content":"Установка через go install Команда установит последнюю стабильную версию easyp:"},{"id":"introduction/install::top::6","title":"Установка EasyP CLI","section":"Сборка из исходников","path":"/docs/guide/introduction/install","headings":["Сборка из исходников"],"excerpt":"Сборка из исходников Клонирование репозитория","content":"Сборка из исходников Клонирование репозитория"},{"id":"introduction/install::top::7","title":"Установка EasyP CLI","section":"Сборка из исходников","path":"/docs/guide/introduction/install","headings":["Сборка из исходников"],"excerpt":"Сборка из исходников Сборка с помощью Go","content":"Сборка из исходников Сборка с помощью Go"},{"id":"introduction/quickstart::top::0","title":"Быстрый старт (Quickstart)","path":"/docs/guide/introduction/quickstart","headings":[],"excerpt":"EasyP — современный toolkit для работы с файлами Protobuf. В этом кратком руководстве вы научитесь:","content":"EasyP — современный toolkit для работы с файлами Protobuf. В этом кратком руководстве вы научитесь:"},{"id":"introduction/quickstart::top::1","title":"Быстрый старт (Quickstart)","path":"/docs/guide/introduction/quickstart","headings":[],"excerpt":"**Инициализировать** проект с конфигурацией EasyP **Настраивать линтинг**, чтобы ловить ошибки и соблюдать лучшие практики **Управлять зависимостями** из Git‑репозиториев **Генерировать код** из ваших Protobuf файлов","content":"**Инициализировать** проект с конфигурацией EasyP **Настраивать линтинг**, чтобы ловить ошибки и соблюдать лучшие практики **Управлять зависимостями** из Git‑репозиториев **Генерировать код** из ваших Protobuf файлов"},{"id":"introduction/quickstart::top::2","title":"Быстрый старт (Quickstart)","section":"Предварительные требования","path":"/docs/guide/introduction/quickstart","headings":["Предварительные требования"],"excerpt":"Предварительные требования Перед началом убедитесь, что у вас установлены:","content":"Предварительные требования Перед началом убедитесь, что у вас установлены:"},{"id":"introduction/quickstart::top::3","title":"Быстрый старт (Quickstart)","section":"Предварительные требования","path":"/docs/guide/introduction/quickstart","headings":["Предварительные требования"],"excerpt":"Предварительные требования **EasyP CLI** — см. руководство по установке **Git** доступен в вашем $PATH **Файлы .proto** (или создайте их по ходу)","content":"Предварительные требования **EasyP CLI** — см. руководство по установке **Git** доступен в вашем $PATH **Файлы .proto** (или создайте их по ходу)"},{"id":"introduction/quickstart::top::4","title":"Быстрый старт (Quickstart)","section":"Предварительные требования","path":"/docs/guide/introduction/quickstart","headings":["Предварительные требования"],"excerpt":"Предварительные требования Проверить версию EasyP:","content":"Предварительные требования Проверить версию EasyP:"},{"id":"introduction/quickstart::top::5","title":"Быстрый старт (Quickstart)","section":"Инициализация проекта","path":"/docs/guide/introduction/quickstart","headings":["Инициализация проекта"],"excerpt":"Инициализация проекта Создайте базовый файл конфигурации easyp.yaml в корне проекта:","content":"Инициализация проекта Создайте базовый файл конфигурации easyp.yaml в корне проекта:"},{"id":"introduction/quickstart::top::6","title":"Быстрый старт (Quickstart)","section":"Инициализация проекта","path":"/docs/guide/introduction/quickstart","headings":["Инициализация проекта"],"excerpt":"Инициализация проекта Команда генерирует шаблон easyp.yaml с комментариями, дефолтными lint-правилами и настройками breaking-check. easyp init работает интерактивно: если в корне есть buf.yml/buf.yaml, EasyP предложит ми","content":"Инициализация проекта Команда генерирует шаблон easyp.yaml с комментариями, дефолтными lint-правилами и настройками breaking-check. easyp init работает интерактивно: если в корне есть buf.yml/buf.yaml, EasyP предложит миграцию; если easyp.yaml уже существует, попросит подтверждение перед перезаписью."},{"id":"introduction/quickstart::top::7","title":"Быстрый старт (Quickstart)","section":"Настройка линтинга","path":"/docs/guide/introduction/quickstart","headings":["Настройка линтинга"],"excerpt":"Настройка линтинга Линтинг помогает находить проблемы и поддерживать единый стиль. EasyP использует правила, совместимые с Buf.","content":"Настройка линтинга Линтинг помогает находить проблемы и поддерживать единый стиль. EasyP использует правила, совместимые с Buf."},{"id":"introduction/quickstart::top::8","title":"Быстрый старт (Quickstart)","section":"Настройка линтинга","path":"/docs/guide/introduction/quickstart","headings":["Настройка линтинга"],"excerpt":"Настройка линтинга Секция lint уже создаётся командой easyp init. При необходимости отредактируйте её, например так:","content":"Настройка линтинга Секция lint уже создаётся командой easyp init. При необходимости отредактируйте её, например так:"},{"id":"introduction/quickstart::top::9","title":"Быстрый старт (Quickstart)","section":"Настройка линтинга","path":"/docs/guide/introduction/quickstart","headings":["Настройка линтинга"],"excerpt":"Настройка линтинга Запустите линтер:","content":"Настройка линтинга Запустите линтер:"},{"id":"introduction/quickstart::top::10","title":"Быстрый старт (Quickstart)","section":"Настройка линтинга","path":"/docs/guide/introduction/quickstart","headings":["Настройка линтинга"],"excerpt":"Настройка линтинга Линтер проверит все .proto файлы и сообщит о найденных проблемах.","content":"Настройка линтинга Линтер проверит все .proto файлы и сообщит о найденных проблемах."},{"id":"introduction/quickstart::top::11","title":"Быстрый старт (Quickstart)","section":"Настройка линтинга","path":"/docs/guide/introduction/quickstart","headings":["Настройка линтинга"],"excerpt":"Настройка линтинга ::: tip Правила линтинга EasyP на 100% совместимы с Buf — мигрировать просто. :::","content":"Настройка линтинга ::: tip Правила линтинга EasyP на 100% совместимы с Buf — мигрировать просто. :::"},{"id":"introduction/quickstart::top::12","title":"Быстрый старт (Quickstart)","section":"Управление зависимостями","path":"/docs/guide/introduction/quickstart","headings":["Управление зависимостями"],"excerpt":"Управление зависимостями Если вы используете сторонние protobuf пакеты (например Google APIs или gRPC Gateway), EasyP упрощает их подключение.","content":"Управление зависимостями Если вы используете сторонние protobuf пакеты (например Google APIs или gRPC Gateway), EasyP упрощает их подключение."},{"id":"introduction/quickstart::top::13","title":"Быстрый старт (Quickstart)","section":"Формат зависимости","path":"/docs/guide/introduction/quickstart","headings":["Формат зависимости"],"excerpt":"Формат зависимости Запись: $GIT_LINK@$VERSION","content":"Формат зависимости Запись: $GIT_LINK@$VERSION"},{"id":"introduction/quickstart::top::14","title":"Быстрый старт (Quickstart)","section":"Формат зависимости","path":"/docs/guide/introduction/quickstart","headings":["Формат зависимости"],"excerpt":"Формат зависимости **$GIT_LINK** — URL любого Git‑репозитория (GitHub, GitLab и т.д.) **$VERSION** — тег или хеш коммита (опционально)","content":"Формат зависимости **$GIT_LINK** — URL любого Git‑репозитория (GitHub, GitLab и т.д.) **$VERSION** — тег или хеш коммита (опционально)"},{"id":"introduction/quickstart::top::15","title":"Быстрый старт (Quickstart)","section":"Формат зависимости","path":"/docs/guide/introduction/quickstart","headings":["Формат зависимости"],"excerpt":"Формат зависимости Если версия не указана — берётся последний коммит из основной ветки.","content":"Формат зависимости Если версия не указана — берётся последний коммит из основной ветки."},{"id":"introduction/quickstart::top::16","title":"Быстрый старт (Quickstart)","section":"Добавление зависимостей","path":"/docs/guide/introduction/quickstart","headings":["Добавление зависимостей"],"excerpt":"Добавление зависимостей Дополните easyp.yaml:","content":"Добавление зависимостей Дополните easyp.yaml:"},{"id":"introduction/quickstart::top::17","title":"Быстрый старт (Quickstart)","section":"Загрузка зависимостей","path":"/docs/guide/introduction/quickstart","headings":["Загрузка зависимостей"],"excerpt":"Загрузка зависимостей Команда: Скачивает версии из easyp.lock, если он существует Иначе — берёт из easyp.yaml и создаёт easyp.lock","content":"Загрузка зависимостей Команда: Скачивает версии из easyp.lock, если он существует Иначе — берёт из easyp.yaml и создаёт easyp.lock"},{"id":"introduction/quickstart::top::18","title":"Быстрый старт (Quickstart)","section":"Загрузка зависимостей","path":"/docs/guide/introduction/quickstart","headings":["Загрузка зависимостей"],"excerpt":"Загрузка зависимостей ::: info Совет: easyp mod update — игнорирует lock‑файл и подтягивает актуальные версии из easyp.yaml. :::","content":"Загрузка зависимостей ::: info Совет: easyp mod update — игнорирует lock‑файл и подтягивает актуальные версии из easyp.yaml. :::"},{"id":"introduction/quickstart::top::19","title":"Быстрый старт (Quickstart)","section":"Генерация кода","path":"/docs/guide/introduction/quickstart","headings":["Генерация кода"],"excerpt":"Генерация кода EasyP поддерживает все стандартные protoc‑плагины.","content":"Генерация кода EasyP поддерживает все стандартные protoc‑плагины."},{"id":"introduction/quickstart::top::20","title":"Быстрый старт (Quickstart)","section":"Конфигурация генерации","path":"/docs/guide/introduction/quickstart","headings":["Конфигурация генерации"],"excerpt":"Конфигурация генерации Добавьте плагины:","content":"Конфигурация генерации Добавьте плагины:"},{"id":"introduction/quickstart::top::21","title":"Быстрый старт (Quickstart)","section":"Запуск генерации","path":"/docs/guide/introduction/quickstart","headings":["Запуск генерации"],"excerpt":"Запуск генерации EasyP выполнит: Разрешение всех зависимостей Подключение к сервису EasyP (или локальный режим) Запуск указанных плагинов Вывод сгенерированного кода в нужные директории","content":"Запуск генерации EasyP выполнит: Разрешение всех зависимостей Подключение к сервису EasyP (или локальный режим) Запуск указанных плагинов Вывод сгенерированного кода в нужные директории"},{"id":"introduction/quickstart::top::22","title":"Быстрый старт (Quickstart)","section":"Запуск генерации","path":"/docs/guide/introduction/quickstart","headings":["Запуск генерации"],"excerpt":"Запуск генерации ::: tip Гибридный рантайм: WASM для скорости, Docker — для тяжёлых плагинов. :::","content":"Запуск генерации ::: tip Гибридный рантайм: WASM для скорости, Docker — для тяжёлых плагинов. :::"},{"id":"introduction/quickstart::top::23","title":"Быстрый старт (Quickstart)","section":"Следующие шаги","path":"/docs/guide/introduction/quickstart","headings":["Следующие шаги"],"excerpt":"Следующие шаги Поздравляем! 🎉 Вы успешно: ✅ Инициализировали проект EasyP ✅ Настроили линтинг ✅ Управляете внешними зависимостями ✅ Сгенерировали код из .proto","content":"Следующие шаги Поздравляем! 🎉 Вы успешно: ✅ Инициализировали проект EasyP ✅ Настроили линтинг ✅ Управляете внешними зависимостями ✅ Сгенерировали код из .proto"},{"id":"introduction/quickstart::top::24","title":"Быстрый старт (Quickstart)","section":"Узнать больше","path":"/docs/guide/introduction/quickstart","headings":["Узнать больше"],"excerpt":"Узнать больше **CLI Reference** — подробности по командам **API Service** — удалённая генерация **Configuration** — все опции конфигурации","content":"Узнать больше **CLI Reference** — подробности по командам **API Service** — удалённая генерация **Configuration** — все опции конфигурации"},{"id":"introduction/quickstart::top::25","title":"Быстрый старт (Quickstart)","section":"Узнать больше","path":"/docs/guide/introduction/quickstart","headings":["Узнать больше"],"excerpt":"Узнать больше *Приятной работы с Protobuf — без боли! 🚀*","content":"Узнать больше *Приятной работы с Protobuf — без боли! 🚀*"},{"id":"introduction/what-is::top::0","title":"Что такое EasyP?","path":"/docs/guide/introduction/what-is","headings":[],"excerpt":"EasyP — это современный инструментарий для работы с Protocol Buffers, который объединяет весь ваш protobuf‑workflow в один мощный CLI‑инструмент. Он совмещает линтинг, управление пакетами, генерацию кода и проверку совме","content":"EasyP — это современный инструментарий для работы с Protocol Buffers, который объединяет весь ваш protobuf‑workflow в один мощный CLI‑инструмент. Он совмещает линтинг, управление пакетами, генерацию кода и проверку совместимости в единой среде и устраняет сложность традиционной работы с protobuf."},{"id":"introduction/what-is::top::1","title":"Что такое EasyP?","path":"/docs/guide/introduction/what-is","headings":[],"excerpt":"Хотите просто попробовать? Перейдите сразу к разделу Quickstart.","content":"Хотите просто попробовать? Перейдите сразу к разделу Quickstart."},{"id":"introduction/what-is::protobuf::2","title":"Что такое EasyP?","section":"Проблема: фрагментированные protobuf‑процессы","path":"/docs/guide/introduction/what-is#protobuf","headings":["Проблема: фрагментированные protobuf‑процессы"],"excerpt":"Проблема: фрагментированные protobuf‑процессы Работа с Protocol Buffers в разных проектах часто создает лишнюю сложность и трение:","content":"Проблема: фрагментированные protobuf‑процессы Работа с Protocol Buffers в разных проектах часто создает лишнюю сложность и трение:"},{"id":"introduction/what-is::top::3","title":"Что такое EasyP?","section":"Хаос инструментов","path":"/docs/guide/introduction/what-is","headings":["Хаос инструментов"],"excerpt":"Хаос инструментов **Много отдельных утилит**: Отдельно для линтинга, генерации и управления зависимостями **Несогласованные конфигурации**: Разные форматы и правила в разных командах **Сложный онбординг**: Новым разработ","content":"Хаос инструментов **Много отдельных утилит**: Отдельно для линтинга, генерации и управления зависимостями **Несогласованные конфигурации**: Разные форматы и правила в разных командах **Сложный онбординг**: Новым разработчикам нужно долго вникать"},{"id":"introduction/what-is::top::4","title":"Что такое EasyP?","section":"Проблемы управления зависимостями","path":"/docs/guide/introduction/what-is","headings":["Проблемы управления зависимостями"],"excerpt":"Проблемы управления зависимостями **Нет стандартизированного подхода**: Каждый проект решает это по‑своему **Конфликты версий**: Трудно сводить разные версии одних и тех же proto‑библиотек **Неповторяемость сборок**: Сло","content":"Проблемы управления зависимостями **Нет стандартизированного подхода**: Каждый проект решает это по‑своему **Конфликты версий**: Трудно сводить разные версии одних и тех же proto‑библиотек **Неповторяемость сборок**: Сложно гарантировать одинаковый результат в разных окружениях"},{"id":"introduction/what-is::top::5","title":"Что такое EasyP?","section":"Трение в разработке","path":"/docs/guide/introduction/what-is","headings":["Трение в разработке"],"excerpt":"Трение в разработке **Ручные операции**: Много повторяющихся шагов **Разрастание конфигураций**: Множество файлов и форматов **Затратная проверка совместимости**: Часто вручную и постфактум","content":"Трение в разработке **Ручные операции**: Много повторяющихся шагов **Разрастание конфигураций**: Множество файлов и форматов **Затратная проверка совместимости**: Часто вручную и постфактум"},{"id":"introduction/what-is::protobuf::6","title":"Что такое EasyP?","section":"Решение: единый protobuf‑инструментарий","path":"/docs/guide/introduction/what-is#protobuf","headings":["Решение: единый protobuf‑инструментарий"],"excerpt":"Решение: единый protobuf‑инструментарий EasyP устраняет эти проблемы, предоставляя целостный opinionated‑подход и стандартизируя процессы:","content":"Решение: единый protobuf‑инструментарий EasyP устраняет эти проблемы, предоставляя целостный opinionated‑подход и стандартизируя процессы:"},{"id":"introduction/what-is::top::7","title":"Что такое EasyP?","section":"Один инструмент — все задачи","path":"/docs/guide/introduction/what-is","headings":["Один инструмент — все задачи"],"excerpt":"Один инструмент — все задачи Вместо жонглирования утилитами EasyP даёт: **Linting** с расширенными наборами правил **Package management** с Git‑нативными зависимостями **Code generation** локально и удалённо **Breaking c","content":"Один инструмент — все задачи Вместо жонглирования утилитами EasyP даёт: **Linting** с расширенными наборами правил **Package management** с Git‑нативными зависимостями **Code generation** локально и удалённо **Breaking change detection** для контроля совместимости API"},{"id":"introduction/what-is::top::8","title":"Что такое EasyP?","section":"Единая конфигурация","path":"/docs/guide/introduction/what-is","headings":["Единая конфигурация"],"excerpt":"Единая конфигурация Один файл easyp.yaml описывает весь workflow — меньше расхождений, проще сопровождать.","content":"Единая конфигурация Один файл easyp.yaml описывает весь workflow — меньше расхождений, проще сопровождать."},{"id":"introduction/what-is::gitnative::9","title":"Что такое EasyP?","section":"Git‑native зависимости","path":"/docs/guide/introduction/what-is#gitnative","headings":["Git‑native зависимости"],"excerpt":"Git‑native зависимости Прямое использование Git‑репозиториев вместо централизованных реестров: прозрачная история, контроль версий, воспроизводимые сборки.","content":"Git‑native зависимости Прямое использование Git‑репозиториев вместо централизованных реестров: прозрачная история, контроль версий, воспроизводимые сборки."},{"id":"introduction/what-is::top::10","title":"Что такое EasyP?","section":"Ключевые возможности","path":"/docs/guide/introduction/what-is","headings":["Ключевые возможности"],"excerpt":"Ключевые возможности Feature Description --------- ------------- 🔍 **Comprehensive Linting** Полная поддержка правил buf с настраиваемыми профилями для лучших практик API‑дизайна. 📦 **Smart Package Manager** Git‑ориент","content":"Ключевые возможности Feature Description --------- ------------- 🔍 **Comprehensive Linting** Полная поддержка правил buf с настраиваемыми профилями для лучших практик API‑дизайна. 📦 **Smart Package Manager** Git‑ориентированное управление зависимостями с lock‑файлом для воспроизводимости. ⚡ **Code Generation** Многозадачная генерация кода с поддержкой локальных и удалённых protoc‑плагинов. 🔄 **Breaking Change Detection** Автоматическая проверка совместимости API против веток Git. 🌐 **Remote Plugin Support** Выполнение плагинов через централизованный EasyP API сервис без локальных установок. 🎯 **Developer Experience** Автодополнение, понятные ошибки, единая структура и документация."},{"id":"introduction/what-is::top::11","title":"Что такое EasyP?","section":"Типы поддерживаемых плагинов","path":"/docs/guide/introduction/what-is","headings":["Типы поддерживаемых плагинов"],"excerpt":"Типы поддерживаемых плагинов EasyP гибко подходит к выполнению генерации:","content":"Типы поддерживаемых плагинов EasyP гибко подходит к выполнению генерации:"},{"id":"introduction/what-is::local-plugins::12","title":"Что такое EasyP?","section":"Local Plugins","path":"/docs/guide/introduction/what-is#local-plugins","headings":["Local Plugins"],"excerpt":"Local Plugins Стандартные установленные protoc‑плагины:","content":"Local Plugins Стандартные установленные protoc‑плагины:"},{"id":"introduction/what-is::remote-plugins::13","title":"Что такое EasyP?","section":"Remote Plugins","path":"/docs/guide/introduction/what-is#remote-plugins","headings":["Remote Plugins"],"excerpt":"Remote Plugins Плагины через EasyP API сервис для воспроизводимости:","content":"Remote Plugins Плагины через EasyP API сервис для воспроизводимости:"},{"id":"introduction/what-is::custom-plugins::14","title":"Что такое EasyP?","section":"Custom Plugins","path":"/docs/guide/introduction/what-is#custom-plugins","headings":["Custom Plugins"],"excerpt":"Custom Plugins Поддержка экосистемы пользовательских расширений.","content":"Custom Plugins Поддержка экосистемы пользовательских расширений."},{"id":"introduction/what-is::top::15","title":"Что такое EasyP?","section":"Децентрализованный менеджмент пакетов","path":"/docs/guide/introduction/what-is","headings":["Децентрализованный менеджмент пакетов"],"excerpt":"Децентрализованный менеджмент пакетов В отличие от других решений EasyP не требует централизованного реестра. Любой Git‑репозиторий может быть источником:","content":"Децентрализованный менеджмент пакетов В отличие от других решений EasyP не требует централизованного реестра. Любой Git‑репозиторий может быть источником:"},{"id":"introduction/what-is::top::16","title":"Что такое EasyP?","section":"Децентрализованный менеджмент пакетов","path":"/docs/guide/introduction/what-is","headings":["Децентрализованный менеджмент пакетов"],"excerpt":"Децентрализованный менеджмент пакетов **Гибкость**: Любой Git‑хостинг (GitHub, GitLab, self‑hosted) **Нет vendor lock‑in**: Зависимости не привязаны к одному провайдеру **Полная история**: Ветки, теги, ревью **Enterprise","content":"Децентрализованный менеджмент пакетов **Гибкость**: Любой Git‑хостинг (GitHub, GitLab, self‑hosted) **Нет vendor lock‑in**: Зависимости не привязаны к одному провайдеру **Полная история**: Ветки, теги, ревью **Enterprise‑совместимость**: Поддержка приватных репозиториев"},{"id":"introduction/what-is::buf::17","title":"Что такое EasyP?","section":"Бесшовная миграция с Buf","path":"/docs/guide/introduction/what-is#buf","headings":["Бесшовная миграция с Buf"],"excerpt":"Бесшовная миграция с Buf EasyP изначально совместим с экосистемой buf:","content":"Бесшовная миграция с Buf EasyP изначально совместим с экосистемой buf:"},{"id":"introduction/what-is::buf::18","title":"Что такое EasyP?","section":"Бесшовная миграция с Buf","path":"/docs/guide/introduction/what-is#buf","headings":["Бесшовная миграция с Buf"],"excerpt":"Бесшовная миграция с Buf **Совпадающие rule sets** **Похожая структура YAML** **Минимальные изменения для замены** **Постепенное внедрение** без ломки текущего пайплайна","content":"Бесшовная миграция с Buf **Совпадающие rule sets** **Похожая структура YAML** **Минимальные изменения для замены** **Постепенное внедрение** без ломки текущего пайплайна"},{"id":"introduction/what-is::easyp-vs-bufbuild::19","title":"Что такое EasyP?","section":"EasyP vs buf.build","path":"/docs/guide/introduction/what-is#easyp-vs-bufbuild","headings":["EasyP vs buf.build"],"excerpt":"EasyP vs buf.build Feature EasyP buf.build --------- -------- ----------- **Dependency Management** Git‑репозитории Buf Schema Registry (BSR) **Vendor Lock-in** Нет Привязка к BSR для полного функционала **Plugin Executi","content":"EasyP vs buf.build Feature EasyP buf.build --------- -------- ----------- **Dependency Management** Git‑репозитории Buf Schema Registry (BSR) **Vendor Lock-in** Нет Привязка к BSR для полного функционала **Plugin Execution** Local + Remote Local + BSR plugins **Private Dependencies** Любой Git провайдер BSR или ручное управление **Offline Development** Полная поддержка (mod vendor) Ограниченно без доступа к BSR **Enterprise Integration** Использует существующий Git Требует настройку BSR **Breaking Change Detection** Против любой Git ссылки Аналогично **Package Distribution** Любой Git Публикация через BSR **License** Apache 2.0 Apache 2.0 **Community** Growing Established"},{"id":"introduction/what-is::easyp-vs-bufbuild::20","title":"Что такое EasyP?","section":"EasyP vs buf.build","path":"/docs/guide/introduction/what-is#easyp-vs-bufbuild","headings":["EasyP vs buf.build"],"excerpt":"EasyP vs buf.build **Преимущества миграции:** Без изменения инфраструктуры Плавное принятие новых возможностей Гибрид локальных и удалённых плагинов Единая конфигурация вместо набора файлов","content":"EasyP vs buf.build **Преимущества миграции:** Без изменения инфраструктуры Плавное принятие новых возможностей Гибрид локальных и удалённых плагинов Единая конфигурация вместо набора файлов"},{"id":"introduction/what-is::protobuf::21","title":"Что такое EasyP?","section":"Наши цели для Protobuf","path":"/docs/guide/introduction/what-is#protobuf","headings":["Наши цели для Protobuf"],"excerpt":"Наши цели для Protobuf Миссия EasyP — ускорить принятие **schema‑driven API** через удобный, надёжный и прозрачный инструментарий.","content":"Наши цели для Protobuf Миссия EasyP — ускорить принятие **schema‑driven API** через удобный, надёжный и прозрачный инструментарий."},{"id":"introduction/what-is::top::22","title":"Что такое EasyP?","section":"Современная экосистема","path":"/docs/guide/introduction/what-is","headings":["Современная экосистема"],"excerpt":"Современная экосистема Повышаем DX вокруг protobuf, чтобы конкурентно выглядеть по простоте против REST/JSON, сохраняя типовую строгость и производительность.","content":"Современная экосистема Повышаем DX вокруг protobuf, чтобы конкурентно выглядеть по простоте против REST/JSON, сохраняя типовую строгость и производительность."},{"id":"introduction/what-is::developer-experience::23","title":"Что такое EasyP?","section":"Developer Experience прежде всего","path":"/docs/guide/introduction/what-is#developer-experience","headings":["Developer Experience прежде всего"],"excerpt":"Developer Experience прежде всего Интуитивный CLI, понятные ошибки, ясные сообщения, минимальная фрагментация.","content":"Developer Experience прежде всего Интуитивный CLI, понятные ошибки, ясные сообщения, минимальная фрагментация."},{"id":"introduction/what-is::enterprise::24","title":"Что такое EasyP?","section":"Готов к Enterprise","path":"/docs/guide/introduction/what-is#enterprise","headings":["Готов к Enterprise"],"excerpt":"Готов к Enterprise Воспроизводимые сборки, приватные репозитории, интеграция в CI/CD.","content":"Готов к Enterprise Воспроизводимые сборки, приватные репозитории, интеграция в CI/CD."},{"id":"introduction/what-is::top::25","title":"Что такое EasyP?","section":"Для индивидуальных разработчиков","path":"/docs/guide/introduction/what-is","headings":["Для индивидуальных разработчиков"],"excerpt":"Для индивидуальных разработчиков Быстрый старт за минуты Один инструмент — меньше когнитивной нагрузки Понятная документация","content":"Для индивидуальных разработчиков Быстрый старт за минуты Один инструмент — меньше когнитивной нагрузки Понятная документация"},{"id":"introduction/what-is::top::26","title":"Что такое EasyP?","section":"Для команд","path":"/docs/guide/introduction/what-is","headings":["Для команд"],"excerpt":"Для команд Единые стандарты Повторяемые сборки (lock‑файл) Ускоренный онбординг","content":"Для команд Единые стандарты Повторяемые сборки (lock‑файл) Ускоренный онбординг"},{"id":"introduction/what-is::top::27","title":"Что такое EasyP?","section":"Для организаций","path":"/docs/guide/introduction/what-is","headings":["Для организаций"],"excerpt":"Для организаций Нет vendor lock‑in Безопасность приватных репозиториев Лёгкая интеграция в существующие пайплайны","content":"Для организаций Нет vendor lock‑in Безопасность приватных репозиториев Лёгкая интеграция в существующие пайплайны"},{"id":"introduction/what-is::top::28","title":"Что такое EasyP?","section":"Что дальше?","path":"/docs/guide/introduction/what-is","headings":["Что дальше?"],"excerpt":"Что дальше? EasyP упрощает работу с protobuf — фокусируйтесь на API, а не на рутине. Хотите начать?","content":"Что дальше? EasyP упрощает работу с protobuf — фокусируйтесь на API, а не на рутине. Хотите начать?"},{"id":"introduction/what-is::top::29","title":"Что такое EasyP?","section":"Что дальше?","path":"/docs/guide/introduction/what-is","headings":["Что дальше?"],"excerpt":"Что дальше? Смотрите Installation Guide и Quickstart.","content":"Что дальше? Смотрите Installation Guide и Quickstart."},{"id":"introduction/what-is::stargazers-over-time::30","title":"Что такое EasyP?","section":"Stargazers over time","path":"/docs/guide/introduction/what-is#stargazers-over-time","headings":["Stargazers over time"],"excerpt":"Stargazers over time Stargazers over time","content":"Stargazers over time Stargazers over time"},{"id":"migration/buf-cli::top::0","title":"Buf CLI","path":"/docs/guide/migration/buf-cli","headings":[],"excerpt":"Buf CLI В работе","content":"Buf CLI В работе"},{"id":"migration/protoc::top::0","title":"Миграция с protoc на EasyP","path":"/docs/guide/migration/protoc","headings":[],"excerpt":"Исходная англоязычная версия файла содержала только заголовок и пометку “Work in progress”. Ниже — полноценный русскоязычный черновик раздела миграции. Уточни, если требуется сократить или изменить уровень детализации.","content":"Исходная англоязычная версия файла содержала только заголовок и пометку “Work in progress”. Ниже — полноценный русскоязычный черновик раздела миграции. Уточни, если требуется сократить или изменить уровень детализации."},{"id":"migration/protoc::1::1","title":"Миграция с protoc на EasyP","section":"1. Краткое сравнение","path":"/docs/guide/migration/protoc#1","headings":["1. Краткое сравнение"],"excerpt":"Краткое сравнение Аспект protoc EasyP -------- ---------- ------- Базовая роль Базовый компилятор .proto файлов Инструмент “всё в одном”: линтинг, проверка несовместимых изменений, менеджер пакетов, генерация Конфигураци","content":"Краткое сравнение Аспект protoc EasyP -------- ---------- ------- Базовая роль Базовый компилятор .proto файлов Инструмент “всё в одном”: линтинг, проверка несовместимых изменений, менеджер пакетов, генерация Конфигурация Чаще shell‑скрипты / Makefile / вручную передаваемые флаги Единый файл easyp.yaml (YAML или JSON) Управление зависимостями Ручной git clone, submodule, vendoring Секция deps с Git‑репозиториями Набор правил линтера Нет встроенного Встроенный линтер с правилами (можно включать/исключать) Проверка breaking changes Отсутствует из коробки Команда easyp breaking Расширенные плагины Установка и вызов через флаги --plugin Плагины через конфиг; поддержка удалённого выполнения (API Service) и стандартного локального Единообразие в CI Нужно собирать вручную Консистентные команды: lint, breaking, generate"},{"id":"migration/protoc::2::2","title":"Миграция с protoc на EasyP","section":"2. Когда имеет смысл мигрировать","path":"/docs/guide/migration/protoc#2","headings":["2. Когда имеет смысл мигрировать"],"excerpt":"Когда имеет смысл мигрировать Миграция на EasyP особенно полезна если: Есть потребность в автоматической проверке качества (стиль, именование) .proto файлов. Нужна защита от нелегитимных несовместимых изменений при эволю","content":"Когда имеет смысл мигрировать Миграция на EasyP особенно полезна если: Есть потребность в автоматической проверке качества (стиль, именование) .proto файлов. Нужна защита от нелегитимных несовместимых изменений при эволюции схем. В проекте используется несколько языков генерации и растёт число скриптов вокруг protoc. Вы хотите единый конфиг вместо множества shell/Makefile комбинаций. Планируется централизованное исполнение плагинов (через API Service) или унификация окружения в CI."},{"id":"migration/protoc::3-protoc::3","title":"Миграция с protoc на EasyP","section":"3. Типичный сценарий “до” (только protoc)","path":"/docs/guide/migration/protoc#3-protoc","headings":["3. Типичный сценарий “до” (только protoc)"],"excerpt":"Типичный сценарий “до” (только protoc) Пример: локальные скрипты / Makefile:","content":"Типичный сценарий “до” (только protoc) Пример: локальные скрипты / Makefile:"},{"id":"migration/protoc::3-protoc::4","title":"Миграция с protoc на EasyP","section":"3. Типичный сценарий “до” (только protoc)","path":"/docs/guide/migration/protoc#3-protoc","headings":["3. Типичный сценарий “до” (только protoc)"],"excerpt":"Типичный сценарий “до” (только protoc)","content":"Типичный сценарий “до” (только protoc)"},{"id":"migration/protoc::3-protoc::5","title":"Миграция с protoc на EasyP","section":"3. Типичный сценарий “до” (только protoc)","path":"/docs/guide/migration/protoc#3-protoc","headings":["3. Типичный сценарий “до” (только protoc)"],"excerpt":"Типичный сценарий “до” (только protoc) Дополнительные зависимости (googleapis, validate, grpc-gateway) скачиваются вручную или через submodules.","content":"Типичный сценарий “до” (только protoc) Дополнительные зависимости (googleapis, validate, grpc-gateway) скачиваются вручную или через submodules."},{"id":"migration/protoc::4-easyp::6","title":"Миграция с protoc на EasyP","section":"4. Типичный сценарий “после” (EasyP)","path":"/docs/guide/migration/protoc#4-easyp","headings":["4. Типичный сценарий “после” (EasyP)"],"excerpt":"Типичный сценарий “после” (EasyP) Единый файл easyp.yaml:","content":"Типичный сценарий “после” (EasyP) Единый файл easyp.yaml:"},{"id":"migration/protoc::4-easyp::7","title":"Миграция с protoc на EasyP","section":"4. Типичный сценарий “после” (EasyP)","path":"/docs/guide/migration/protoc#4-easyp","headings":["4. Типичный сценарий “после” (EasyP)"],"excerpt":"Типичный сценарий “после” (EasyP) ```yaml deps: - github.com/googleapis/googleapis - github.com/envoyproxy/protoc-gen-validate","content":"Типичный сценарий “после” (EasyP) ```yaml deps: - github.com/googleapis/googleapis - github.com/envoyproxy/protoc-gen-validate"},{"id":"migration/protoc::4-easyp::8","title":"Миграция с protoc на EasyP","section":"4. Типичный сценарий “после” (EasyP)","path":"/docs/guide/migration/protoc#4-easyp","headings":["4. Типичный сценарий “после” (EasyP)"],"excerpt":"Типичный сценарий “после” (EasyP) generate: plugins: - name: go out: gen/go opts: paths: source_relative - name: go-grpc out: gen/go opts: paths: source_relative require_unimplemented_servers: false - name: validate out:","content":"Типичный сценарий “после” (EasyP) generate: plugins: - name: go out: gen/go opts: paths: source_relative - name: go-grpc out: gen/go opts: paths: source_relative require_unimplemented_servers: false - name: validate out: gen/go opts: paths: source_relative lang: \"go\" ```"},{"id":"migration/protoc::4-easyp::9","title":"Миграция с protoc на EasyP","section":"4. Типичный сценарий “после” (EasyP)","path":"/docs/guide/migration/protoc#4-easyp","headings":["4. Типичный сценарий “после” (EasyP)"],"excerpt":"Типичный сценарий “после” (EasyP) Команды:","content":"Типичный сценарий “после” (EasyP) Команды:"},{"id":"migration/protoc::5::10","title":"Миграция с protoc на EasyP","section":"5. Пошаговая миграция","path":"/docs/guide/migration/protoc#5","headings":["5. Пошаговая миграция"],"excerpt":"Пошаговая миграция Инвентаризация: - Соберите список всех вызовов protoc (скрипты, Makefile, CI). - Зафиксируйте используемые плагины и их версии. Создание easyp.yaml: - Поле version не обязательно (можете оставить его т","content":"Пошаговая миграция Инвентаризация: - Соберите список всех вызовов protoc (скрипты, Makefile, CI). - Зафиксируйте используемые плагины и их версии. Создание easyp.yaml: - Поле version не обязательно (можете оставить его только для обратной совместимости). - Перенесите плагины в секцию generate.plugins. - Укажите опции, которые ранее передавались в командной строке. Зависимости: - Все внешние каталоги (googleapis, validate, grpc-gateway и т.п.) занесите в deps. - Удалите лишние submodules при необходимости. Линтер: - Запустите easyp lint и посмотрите на предупреждения. - При необходимости добавьте lint.use, lint.ignore, lint.except. Проверка breaking changes: - Выберите референс (обычно origin/main или предыдущий тег). - Запустите easyp breaking --against git-ref=origin/main. - Настройте игнорируемые изменения (breaking.ignore), если нужно. Обновление CI: - Замените прямые вызовы protoc на easyp generate. - Добавьте отдельные шаги lint и breaking. Очистка: - Удалите устаревшие генерационные скрипты, если они дублируют функционал EasyP. Документация: - Обновите README / CONTRIBUTING (новый способ генерации). Верификация: - Сравните результат генерации до и после (git diff). - Убедитесь, что имена файлов и пути совпадают или скорректируйте структуру."},{"id":"migration/protoc::6-ci-github-actions::11","title":"Миграция с protoc на EasyP","section":"6. Замена в CI (пример GitHub Actions)","path":"/docs/guide/migration/protoc#6-ci-github-actions","headings":["6. Замена в CI (пример GitHub Actions)"],"excerpt":"Замена в CI (пример GitHub Actions) ```yaml name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest","content":"Замена в CI (пример GitHub Actions) ```yaml name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest"},{"id":"migration/protoc::6-ci-github-actions::12","title":"Миграция с protoc на EasyP","section":"6. Замена в CI (пример GitHub Actions)","path":"/docs/guide/migration/protoc#6-ci-github-actions","headings":["6. Замена в CI (пример GitHub Actions)"],"excerpt":"Замена в CI (пример GitHub Actions) name: Lint run: easyp lint","content":"Замена в CI (пример GitHub Actions) name: Lint run: easyp lint"},{"id":"migration/protoc::6-ci-github-actions::13","title":"Миграция с protoc на EasyP","section":"6. Замена в CI (пример GitHub Actions)","path":"/docs/guide/migration/protoc#6-ci-github-actions","headings":["6. Замена в CI (пример GitHub Actions)"],"excerpt":"Замена в CI (пример GitHub Actions) name: Breaking run: easyp breaking --against git-ref=origin/main","content":"Замена в CI (пример GitHub Actions) name: Breaking run: easyp breaking --against git-ref=origin/main"},{"id":"migration/protoc::6-ci-github-actions::14","title":"Миграция с protoc на EasyP","section":"6. Замена в CI (пример GitHub Actions)","path":"/docs/guide/migration/protoc#6-ci-github-actions","headings":["6. Замена в CI (пример GitHub Actions)"],"excerpt":"Замена в CI (пример GitHub Actions) name: Generate run: easyp generate ```","content":"Замена в CI (пример GitHub Actions) name: Generate run: easyp generate ```"},{"id":"migration/protoc::7::15","title":"Миграция с protoc на EasyP","section":"7. Работа с плагинами","path":"/docs/guide/migration/protoc#7","headings":["7. Работа с плагинами"],"excerpt":"Работа с плагинами Тип В protoc В EasyP ----- ---------- --------- Стандартные (protoc-gen-go) Указание через --go_out plugins: - name: go ... gRPC --go-grpc_out Второй плагин go-grpc Validate Доп. установка + --validate","content":"Работа с плагинами Тип В protoc В EasyP ----- ---------- --------- Стандартные (protoc-gen-go) Указание через --go_out plugins: - name: go ... gRPC --go-grpc_out Второй плагин go-grpc Validate Доп. установка + --validate_out - name: validate с opts gRPC-Gateway / OpenAPI --grpc-gateway_out / --openapiv2_out Плагины grpc-gateway, openapiv2 Кастомные Путь к бинарю / --plugin=protoc-gen-xxx - name: xxx или удалённый remote: (если используется API Service)"},{"id":"migration/protoc::7::16","title":"Миграция с protoc на EasyP","section":"7. Работа с плагинами","path":"/docs/guide/migration/protoc#7","headings":["7. Работа с плагинами"],"excerpt":"Работа с плагинами Если вы переходите на удалённое выполнение (API Service), записи в конфиге могут выглядеть так:","content":"Работа с плагинами Если вы переходите на удалённое выполнение (API Service), записи в конфиге могут выглядеть так:"},{"id":"migration/protoc::8::17","title":"Миграция с protoc на EasyP","section":"8. Проверка корректности после миграции","path":"/docs/guide/migration/protoc#8","headings":["8. Проверка корректности после миграции"],"excerpt":"Проверка корректности после миграции git diff после easyp generate — не должно быть неожиданных изменений. Сравнить размер и содержимое каталога сгенерированных файлов. Запустить ваш потребляющий код (сборка, тесты). Про","content":"Проверка корректности после миграции git diff после easyp generate — не должно быть неожиданных изменений. Сравнить размер и содержимое каталога сгенерированных файлов. Запустить ваш потребляющий код (сборка, тесты). Проверить, что плагины (validate, grpc-gateway) продолжают вставлять необходимые аннотации / опции. Линт не должен выдавать критичных ошибок — скорректируйте стиль .proto, если требуется."},{"id":"migration/protoc::9::18","title":"Миграция с protoc на EasyP","section":"9. Частые проблемы","path":"/docs/guide/migration/protoc#9","headings":["9. Частые проблемы"],"excerpt":"Частые проблемы Проблема Причина Решение ---------- --------- --------- Плагин не найден Не установлен или не указан в PATH Выполнить go install ... или добавить в конфиг как remote Ошибка импорта .proto Отсутствует репо","content":"Частые проблемы Проблема Причина Решение ---------- --------- --------- Плагин не найден Не установлен или не указан в PATH Выполнить go install ... или добавить в конфиг как remote Ошибка импорта .proto Отсутствует репозиторий в deps Добавить адрес в секцию deps и easyp mod update Несовместимые изменения на каждом PR Отсутствует игнор/настройка сравнения Уточнить ветку/тег в --against или настроить breaking.ignore Локально работает, в CI падает В CI нет зависимостей (не вызван update) Добавить шаг easyp mod update перед generate Дубликаты сгенерированных файлов Изменена структура путей или out Синхронизировать out и paths: source_relative опции"},{"id":"migration/protoc::10-go::19","title":"Миграция с protoc на EasyP","section":"10. Минимальный пример конфигурации (только Go)","path":"/docs/guide/migration/protoc#10-go","headings":["10. Минимальный пример конфигурации (только Go)"],"excerpt":"Минимальный пример конфигурации (только Go)","content":"Минимальный пример конфигурации (только Go)"},{"id":"migration/protoc::10-go::20","title":"Миграция с protoc на EasyP","section":"10. Минимальный пример конфигурации (только Go)","path":"/docs/guide/migration/protoc#10-go","headings":["10. Минимальный пример конфигурации (только Go)"],"excerpt":"Минимальный пример конфигурации (только Go) Команды:","content":"Минимальный пример конфигурации (только Go) Команды:"},{"id":"migration/protoc::11-go-grpc-gateway-validate-breaking-lint::21","title":"Миграция с protoc на EasyP","section":"11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)","path":"/docs/guide/migration/protoc#11-go-grpc-gateway-validate-breaking-lint","headings":["11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)"],"excerpt":"Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint) ```yaml lint: use: - ENUM_FIRST_VALUE_ZERO - SERVICE_SUFFIX allow_comment_ignores: false enum_zero_value_suffix: _NONE service_suffix: Service","content":"Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint) ```yaml lint: use: - ENUM_FIRST_VALUE_ZERO - SERVICE_SUFFIX allow_comment_ignores: false enum_zero_value_suffix: _NONE service_suffix: Service"},{"id":"migration/protoc::11-go-grpc-gateway-validate-breaking-lint::22","title":"Миграция с protoc на EasyP","section":"11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)","path":"/docs/guide/migration/protoc#11-go-grpc-gateway-validate-breaking-lint","headings":["11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)"],"excerpt":"Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint) deps: - github.com/googleapis/googleapis - github.com/envoyproxy/protoc-gen-validate","content":"Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint) deps: - github.com/googleapis/googleapis - github.com/envoyproxy/protoc-gen-validate"},{"id":"migration/protoc::11-go-grpc-gateway-validate-breaking-lint::23","title":"Миграция с protoc на EasyP","section":"11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)","path":"/docs/guide/migration/protoc#11-go-grpc-gateway-validate-breaking-lint","headings":["11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)"],"excerpt":"Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint) generate: plugins: - name: go out: gen/go opts: paths: source_relative - name: go-grpc out: gen/go opts: paths: source_relative require_unimplemented_","content":"Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint) generate: plugins: - name: go out: gen/go opts: paths: source_relative - name: go-grpc out: gen/go opts: paths: source_relative require_unimplemented_servers: false - name: validate out: gen/go opts: paths: source_relative lang: \"go\" - name: grpc-gateway out: gen/go opts: paths: source_relative - name: openapiv2 out: gen/openapi opts: simple_operation_ids: true"},{"id":"migration/protoc::11-go-grpc-gateway-validate-breaking-lint::24","title":"Миграция с protoc на EasyP","section":"11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)","path":"/docs/guide/migration/protoc#11-go-grpc-gateway-validate-breaking-lint","headings":["11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)"],"excerpt":"Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint) breaking: against_git_ref: main ignore: - ENUM_VALUE_SAME_NAME ```","content":"Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint) breaking: against_git_ref: main ignore: - ENUM_VALUE_SAME_NAME ```"},{"id":"migration/protoc::12-checklist::25","title":"Миграция с protoc на EasyP","section":"12. Checklist миграции","path":"/docs/guide/migration/protoc#12-checklist","headings":["12. Checklist миграции"],"excerpt":"Checklist миграции [ ] Собраны все текущие вызовы protoc. [ ] Создан easyp.yaml с секциями generate и (опционально) lint, breaking. [ ] Добавлены все внешние зависимости в deps. [ ] Успешно выполнен easyp mod update. [ ]","content":"Checklist миграции [ ] Собраны все текущие вызовы protoc. [ ] Создан easyp.yaml с секциями generate и (опционально) lint, breaking. [ ] Добавлены все внешние зависимости в deps. [ ] Успешно выполнен easyp mod update. [ ] easyp generate даёт идентичный или ожидаемо обновлённый результат. [ ] easyp lint проходит без критичных ошибок (или ошибки обработаны). [ ] easyp breaking --against git-ref=origin/main не выдаёт неожиданных блокирующих нарушений. [ ] CI обновлён (заменены прямые вызовы protoc). [ ] Документация проекта обновлена (README: как генерировать)."},{"id":"migration/protoc::13::26","title":"Миграция с protoc на EasyP","section":"13. Дополнительные рекомендации","path":"/docs/guide/migration/protoc#13","headings":["13. Дополнительные рекомендации"],"excerpt":"Дополнительные рекомендации Сначала мигрируйте один сервис / пакет — снизит риск массовых конфликтов. Закоммитьте easyp.yaml отдельно, затем выполните генерацию и линт — проще ревью. Если нужны разные наборы плагинов для","content":"Дополнительные рекомендации Сначала мигрируйте один сервис / пакет — снизит риск массовых конфликтов. Закоммитьте easyp.yaml отдельно, затем выполните генерацию и линт — проще ревью. Если нужны разные наборы плагинов для разных микросервисов — используйте несколько конфигов (например: easyp.microservice-a.yaml + easyp.microservice-b.yaml). Внедрите проверку актуальности генерации: шаг CI, который валидирует отсутствие diff после easyp generate."},{"id":"migration/protoc::14::27","title":"Миграция с protoc на EasyP","section":"14. Статус","path":"/docs/guide/migration/protoc#14","headings":["14. Статус"],"excerpt":"Статус Этот файл — русская расширенная версия, заменяющая placeholder “Work in progress”. При появлении новых возможностей EasyP (дополнительные поля в конфиге, новые плагины, расширения breaking‑проверок) обновите соотв","content":"Статус Этот файл — русская расширенная версия, заменяющая placeholder “Work in progress”. При появлении новых возможностей EasyP (дополнительные поля в конфиге, новые плагины, расширения breaking‑проверок) обновите соответствующие разделы."},{"id":"migration/protoc::14::28","title":"Миграция с protoc на EasyP","section":"14. Статус","path":"/docs/guide/migration/protoc#14","headings":["14. Статус"],"excerpt":"Статус Если нужен упрощённый вариант (только перевод без расширения), сообщи — могу сократить до минимальных двух блоков.","content":"Статус Если нужен упрощённый вариант (только перевод без расширения), сообщи — могу сократить до минимальных двух блоков."},{"id":"migration/protolock::top::0","title":"Protolock","path":"/docs/guide/migration/protolock","headings":[],"excerpt":"Protolock В процессе разработки","content":"Protolock В процессе разработки"},{"id":"migration/prototool::top::0","title":"Prototool","section":"Состояние","path":"/docs/guide/migration/prototool","headings":["Состояние"],"excerpt":"Состояние Этот раздел был помечен как “Work in progress” в оригинальной английской версии. Ниже — переведённое и дополненное практическое руководство по миграции с Prototool на EasyP. Имя инструмента Prototool не перевод","content":"Состояние Этот раздел был помечен как “Work in progress” в оригинальной английской версии. Ниже — переведённое и дополненное практическое руководство по миграции с Prototool на EasyP. Имя инструмента Prototool не переводится."},{"id":"migration/prototool::top::1","title":"Prototool","section":"Цель миграции","path":"/docs/guide/migration/prototool","headings":["Цель миграции"],"excerpt":"Цель миграции Перейти от конфигурации и рабочих процессов Prototool к эквиваленту на EasyP с минимальными изменениями, сохранив: Линтинг .proto файлов. Генерацию кода через protoc-плагины. Управление зависимостями. Прове","content":"Цель миграции Перейти от конфигурации и рабочих процессов Prototool к эквиваленту на EasyP с минимальными изменениями, сохранив: Линтинг .proto файлов. Генерацию кода через protoc-плагины. Управление зависимостями. Проверку несовместимых изменений (в Prototool это приходилось реализовывать внешними инструментами; в EasyP встроено)."},{"id":"migration/prototool::top::2","title":"Prototool","section":"Кратко о различиях","path":"/docs/guide/migration/prototool","headings":["Кратко о различиях"],"excerpt":"Кратко о различиях Область Prototool EasyP Комментарий --------- ----------- ------- ------------- Конфигурация prototool.yaml easyp.yaml Форматы YAML/JSON поддерживаются; структура отличается. Линтинг Встроенные наборы ","content":"Кратко о различиях Область Prototool EasyP Комментарий --------- ----------- ------- ------------- Конфигурация prototool.yaml easyp.yaml Форматы YAML/JSON поддерживаются; структура отличается. Линтинг Встроенные наборы + кастомные правила Наборы через lint.use, тонкая настройка ignore/except EasyP даёт больше гибкости группировки. Генерация Раздел generate + плагины через Docker/локально generate.plugins (локальные/WASM/удалённые) EasyP может выполнять плагины удалённо (API Service). Зависимости Обычно через include-пути / внешние git clone вручную Секция deps (Git репозитории) + mod update Более декларативно. Breaking Changes Нет встроенного механизма Секция breaking + команда easyp breaking Из коробки. Lock-in Зависимость от модели Prototool Минималистичный формат, «любой Git — пакет» Облегчает выход / интеграцию с другими экосистемами."},{"id":"migration/prototool::prototool::3","title":"Prototool","section":"Типовая структура Prototool (упрощённо)","path":"/docs/guide/migration/prototool#prototool","headings":["Типовая структура Prototool (упрощённо)"],"excerpt":"Типовая структура Prototool (упрощённо)","content":"Типовая структура Prototool (упрощённо)"},{"id":"migration/prototool::prototool::4","title":"Prototool","section":"Типовая структура Prototool (упрощённо)","path":"/docs/guide/migration/prototool#prototool","headings":["Типовая структура Prototool (упрощённо)"],"excerpt":"Типовая структура Prototool (упрощённо) Особенности: include_paths задаёт пути поиска импортов. lint.group + rules.add/remove регулируют активные проверки. generate.plugins описывает плагины для protoc.","content":"Типовая структура Prototool (упрощённо) Особенности: include_paths задаёт пути поиска импортов. lint.group + rules.add/remove регулируют активные проверки. generate.plugins описывает плагины для protoc."},{"id":"migration/prototool::prototool::5","title":"Prototool","section":"Типовая структура Prototool (упрощённо)","path":"/docs/guide/migration/prototool#prototool","headings":["Типовая структура Prototool (упрощённо)"],"excerpt":"Типовая структура Prototool (упрощённо) ---","content":"Типовая структура Prototool (упрощённо) ---"},{"id":"migration/prototool::easyp::6","title":"Prototool","section":"Эквивалент на EasyP","path":"/docs/guide/migration/prototool#easyp","headings":["Эквивалент на EasyP"],"excerpt":"Эквивалент на EasyP ```yaml easyp.yaml (пример) deps: - github.com/org/common-protos # вместо manual include - github.com/org/third-party-protos","content":"Эквивалент на EasyP ```yaml easyp.yaml (пример) deps: - github.com/org/common-protos # вместо manual include - github.com/org/third-party-protos"},{"id":"migration/prototool::easyp::7","title":"Prototool","section":"Эквивалент на EasyP","path":"/docs/guide/migration/prototool#easyp","headings":["Эквивалент на EasyP"],"excerpt":"Эквивалент на EasyP lint: use: - MINIMAL - BASIC enum_zero_value_suffix: \"_NONE\" service_suffix: \"Service\" ignore: - COMMENT_FIELD except: - ENUM_VALUE_PREFIX allow_comment_ignores: true","content":"Эквивалент на EasyP lint: use: - MINIMAL - BASIC enum_zero_value_suffix: \"_NONE\" service_suffix: \"Service\" ignore: - COMMENT_FIELD except: - ENUM_VALUE_PREFIX allow_comment_ignores: true"},{"id":"migration/prototool::easyp::8","title":"Prototool","section":"Эквивалент на EasyP","path":"/docs/guide/migration/prototool#easyp","headings":["Эквивалент на EasyP"],"excerpt":"Эквивалент на EasyP generate: plugins: - name: go out: gen/go opts: paths: source_relative - name: go-grpc out: gen/go opts: paths: source_relative require_unimplemented_servers: false","content":"Эквивалент на EasyP generate: plugins: - name: go out: gen/go opts: paths: source_relative - name: go-grpc out: gen/go opts: paths: source_relative require_unimplemented_servers: false"},{"id":"migration/prototool::easyp::9","title":"Prototool","section":"Эквивалент на EasyP","path":"/docs/guide/migration/prototool#easyp","headings":["Эквивалент на EasyP"],"excerpt":"Эквивалент на EasyP breaking: against_git_ref: main ignore: - FIELD_SAME_TYPE ```","content":"Эквивалент на EasyP breaking: against_git_ref: main ignore: - FIELD_SAME_TYPE ```"},{"id":"migration/prototool::easyp::10","title":"Prototool","section":"Эквивалент на EasyP","path":"/docs/guide/migration/prototool#easyp","headings":["Эквивалент на EasyP"],"excerpt":"Эквивалент на EasyP Комментарии: deps заменяет необходимость вручную прописывать include paths: EasyP подтянет их через git. lint.use активирует наборы правил (MINIMAL/BASIC/DEFAULT и т.д.). Дополнительные настройки (enu","content":"Эквивалент на EasyP Комментарии: deps заменяет необходимость вручную прописывать include paths: EasyP подтянет их через git. lint.use активирует наборы правил (MINIMAL/BASIC/DEFAULT и т.д.). Дополнительные настройки (enum_zero_value_suffix, service_suffix) задают политики нейминга. breaking позволяет сразу контролировать несовместимые изменения."},{"id":"migration/prototool::top::11","title":"Prototool","section":"Шаги миграции","path":"/docs/guide/migration/prototool","headings":["Шаги миграции"],"excerpt":"Шаги миграции Инвентаризация: - Соберите текущий prototool.yaml, списки include paths и плагины. - Зафиксируйте используемые кастомные правила, если есть.","content":"Шаги миграции Инвентаризация: - Соберите текущий prototool.yaml, списки include paths и плагины. - Зафиксируйте используемые кастомные правила, если есть."},{"id":"migration/prototool::top::12","title":"Prototool","section":"Шаги миграции","path":"/docs/guide/migration/prototool","headings":["Шаги миграции"],"excerpt":"Шаги миграции Зависимости: - Любые каталоги, которые вы вручную добавляли в include_paths, преобразуйте в git-репозитории (если ещё нет). - Добавьте их в deps (формат: github.com/owner/repo или путь к вашей приватной сис","content":"Шаги миграции Зависимости: - Любые каталоги, которые вы вручную добавляли в include_paths, преобразуйте в git-репозитории (если ещё нет). - Добавьте их в deps (формат: github.com/owner/repo или путь к вашей приватной системе Git)."},{"id":"migration/prototool::top::13","title":"Prototool","section":"Шаги миграции","path":"/docs/guide/migration/prototool","headings":["Шаги миграции"],"excerpt":"Шаги миграции Линтинг: - Определите какой group использовался (basic, default, …) → сопоставьте с наборами EasyP (MINIMAL, BASIC, DEFAULT). - Индивидуальные добавления (rules.add) перенесите в lint.use или except/ignore:","content":"Шаги миграции Линтинг: - Определите какой group использовался (basic, default, …) → сопоставьте с наборами EasyP (MINIMAL, BASIC, DEFAULT). - Индивидуальные добавления (rules.add) перенесите в lint.use или except/ignore: - Если правило нужно активировать — включите через набор или явно. - Если нужно отключить — добавьте в ignore."},{"id":"migration/prototool::top::14","title":"Prototool","section":"Шаги миграции","path":"/docs/guide/migration/prototool","headings":["Шаги миграции"],"excerpt":"Шаги миграции Генерация: - Сохраните список плагинов. В большинстве случаев имена совпадут (go, go-grpc, др.). - Если раньше использовали Docker-окружение Prototool — проверьте поддержку удалённых плагинов через API Serv","content":"Шаги миграции Генерация: - Сохраните список плагинов. В большинстве случаев имена совпадут (go, go-grpc, др.). - Если раньше использовали Docker-окружение Prototool — проверьте поддержку удалённых плагинов через API Service EasyP (опционально). - Перепишите в секцию generate.plugins."},{"id":"migration/prototool::top::15","title":"Prototool","section":"Шаги миграции","path":"/docs/guide/migration/prototool","headings":["Шаги миграции"],"excerpt":"Шаги миграции Дополнительные опции: - Настройки нейминга enum/service перенести в enum_zero_value_suffix, service_suffix. - Если были внешние скрипты для проверки breaking changes — удалите их и включите breaking с again","content":"Шаги миграции Дополнительные опции: - Настройки нейминга enum/service перенести в enum_zero_value_suffix, service_suffix. - Если были внешние скрипты для проверки breaking changes — удалите их и включите breaking с against_git_ref."},{"id":"migration/prototool::top::16","title":"Prototool","section":"Шаги миграции","path":"/docs/guide/migration/prototool","headings":["Шаги миграции"],"excerpt":"Шаги миграции Верификация: - Запустите: easyp mod update (скачивание deps). - Затем: easyp lint. - Далее: easyp generate. - И, если нужно: easyp breaking --against git-ref=origin/main.","content":"Шаги миграции Верификация: - Запустите: easyp mod update (скачивание deps). - Затем: easyp lint. - Далее: easyp generate. - И, если нужно: easyp breaking --against git-ref=origin/main."},{"id":"migration/prototool::top::17","title":"Prototool","section":"Шаги миграции","path":"/docs/guide/migration/prototool","headings":["Шаги миграции"],"excerpt":"Шаги миграции CI/CD: - Обновите workflow (GitHub Actions / GitLab) — замените вызовы Prototool на EasyP команды. - Добавьте шаг проверки несовместимых изменений.","content":"Шаги миграции CI/CD: - Обновите workflow (GitHub Actions / GitLab) — замените вызовы Prototool на EasyP команды. - Добавьте шаг проверки несовместимых изменений."},{"id":"migration/prototool::top::18","title":"Prototool","section":"Сопоставление правил (общая идея)","path":"/docs/guide/migration/prototool","headings":["Сопоставление правил (общая идея)"],"excerpt":"Сопоставление правил (общая идея) Prototool концепт EasyP ------------------- ------ lint.group lint.use (наборы) rules.add/remove except / ignore include_paths deps (git источники) plugins generate.plugins (внешние скри","content":"Сопоставление правил (общая идея) Prototool концепт EasyP ------------------- ------ lint.group lint.use (наборы) rules.add/remove except / ignore include_paths deps (git источники) plugins generate.plugins (внешние скрипты для breaking) breaking секция + команда"},{"id":"migration/prototool::top::19","title":"Prototool","section":"Сопоставление правил (общая идея)","path":"/docs/guide/migration/prototool","headings":["Сопоставление правил (общая идея)"],"excerpt":"Сопоставление правил (общая идея) ---","content":"Сопоставление правил (общая идея) ---"},{"id":"migration/prototool::top::20","title":"Prototool","section":"Приватные репозитории","path":"/docs/guide/migration/prototool","headings":["Приватные репозитории"],"excerpt":"Приватные репозитории Если ранее Prototool просто видел локальные каталоги, теперь: Добавьте SSH ключи/токены в CI для доступа к приватным Git. Укажите их в deps как обычные git-URL (формат зависит от реализации EasyP; д","content":"Приватные репозитории Если ранее Prototool просто видел локальные каталоги, теперь: Добавьте SSH ключи/токены в CI для доступа к приватным Git. Укажите их в deps как обычные git-URL (формат зависит от реализации EasyP; для публичных — стандартный)."},{"id":"migration/prototool::top::21","title":"Prototool","section":"Типовые проблемы при миграции","path":"/docs/guide/migration/prototool","headings":["Типовые проблемы при миграции"],"excerpt":"Типовые проблемы при миграции Проблема Причина Решение ---------- --------- --------- Правила линтера не совпадают Неверное сопоставление групп Проверить документацию EasyP по наборам правил Импорты не находятся Забыли д","content":"Типовые проблемы при миграции Проблема Причина Решение ---------- --------- --------- Правила линтера не совпадают Неверное сопоставление групп Проверить документацию EasyP по наборам правил Импорты не находятся Забыли добавить репозиторий в deps Добавить в deps и выполнить easyp mod update Генерация падает на опциях Плагин требует другие flags Проверить opts и документацию плагина breaking сообщает слишком много Слишком строгий базовый набор Добавить конкретные правила в breaking.ignore Долгая генерация Нет кеша/много deps Включить кэширование в CI (vendor/.easyp/deps)"},{"id":"migration/prototool::top::22","title":"Prototool","section":"Типовые проблемы при миграции","path":"/docs/guide/migration/prototool","headings":["Типовые проблемы при миграции"],"excerpt":"Типовые проблемы при миграции ---","content":"Типовые проблемы при миграции ---"},{"id":"migration/prototool::top::23","title":"Prototool","section":"Минимальная конфигурация после миграции","path":"/docs/guide/migration/prototool","headings":["Минимальная конфигурация после миграции"],"excerpt":"Минимальная конфигурация после миграции","content":"Минимальная конфигурация после миграции"},{"id":"migration/prototool::top::24","title":"Prototool","section":"Минимальная конфигурация после миграции","path":"/docs/guide/migration/prototool","headings":["Минимальная конфигурация после миграции"],"excerpt":"Минимальная конфигурация после миграции ---","content":"Минимальная конфигурация после миграции ---"},{"id":"migration/prototool::top::25","title":"Prototool","section":"Рекомендации по упрощению","path":"/docs/guide/migration/prototool","headings":["Рекомендации по упрощению"],"excerpt":"Рекомендации по упрощению Начните с минимального lint.use (MINIMAL), затем постепенно включайте дополнительные наборы. Не переносите слепо все ignore — часть правил может уже быть улучшена в EasyP. Сначала настроить deps","content":"Рекомендации по упрощению Начните с минимального lint.use (MINIMAL), затем постепенно включайте дополнительные наборы. Не переносите слепо все ignore — часть правил может уже быть улучшена в EasyP. Сначала настроить deps и генерацию, затем усложнять линт/нейминг. Фиксируйте миграцию по шагам (коммиты: deps → lint → generate → breaking → CI)."},{"id":"migration/prototool::top::26","title":"Prototool","section":"Проверка результата","path":"/docs/guide/migration/prototool","headings":["Проверка результата"],"excerpt":"Проверка результата Скрипт локальной быстрой проверки (пример):","content":"Проверка результата Скрипт локальной быстрой проверки (пример):"},{"id":"migration/prototool::top::27","title":"Prototool","section":"Проверка результата","path":"/docs/guide/migration/prototool","headings":["Проверка результата"],"excerpt":"Проверка результата ```bash #!/usr/bin/env bash set -euo pipefail","content":"Проверка результата ```bash #!/usr/bin/env bash set -euo pipefail"},{"id":"migration/prototool::top::28","title":"Prototool","section":"Проверка результата","path":"/docs/guide/migration/prototool","headings":["Проверка результата"],"excerpt":"Проверка результата echo \"[1] deps update\" easyp mod update","content":"Проверка результата echo \"[1] deps update\" easyp mod update"},{"id":"migration/prototool::top::29","title":"Prototool","section":"Проверка результата","path":"/docs/guide/migration/prototool","headings":["Проверка результата"],"excerpt":"Проверка результата echo \"[2] lint\" easyp lint","content":"Проверка результата echo \"[2] lint\" easyp lint"},{"id":"migration/prototool::top::30","title":"Prototool","section":"Проверка результата","path":"/docs/guide/migration/prototool","headings":["Проверка результата"],"excerpt":"Проверка результата echo \"[3] breaking vs main\" easyp breaking --against git-ref=origin/main echo \"Breaking changes detected (review needed)\"","content":"Проверка результата echo \"[3] breaking vs main\" easyp breaking --against git-ref=origin/main echo \"Breaking changes detected (review needed)\""},{"id":"migration/prototool::top::31","title":"Prototool","section":"Проверка результата","path":"/docs/guide/migration/prototool","headings":["Проверка результата"],"excerpt":"Проверка результата echo \"[4] generate\" easyp generate","content":"Проверка результата echo \"[4] generate\" easyp generate"},{"id":"migration/prototool::top::32","title":"Prototool","section":"Проверка результата","path":"/docs/guide/migration/prototool","headings":["Проверка результата"],"excerpt":"Проверка результата echo \"Done.\" ```","content":"Проверка результата echo \"Done.\" ```"},{"id":"migration/prototool::top::33","title":"Prototool","section":"Заключение","path":"/docs/guide/migration/prototool","headings":["Заключение"],"excerpt":"Заключение Миграция с Prototool на EasyP сводится к: Переносу путей и внешних каталогов в декларативные deps. Переформатированию линта под lint.use + ignore/except. Переносу генерации в generate.plugins. Добавлению встро","content":"Заключение Миграция с Prototool на EasyP сводится к: Переносу путей и внешних каталогов в декларативные deps. Переформатированию линта под lint.use + ignore/except. Переносу генерации в generate.plugins. Добавлению встроенного механизма breaking. Адаптации CI."},{"id":"migration/prototool::top::34","title":"Prototool","section":"Заключение","path":"/docs/guide/migration/prototool","headings":["Заключение"],"excerpt":"Заключение После этого конфигурация становится более прозрачной, а проверка несовместимых изменений — из коробки.","content":"Заключение После этого конфигурация становится более прозрачной, а проверка несовместимых изменений — из коробки."},{"id":"migration/prototool::top::35","title":"Prototool","section":"Заключение","path":"/docs/guide/migration/prototool","headings":["Заключение"],"excerpt":"Заключение *Готово: базовый перевод и расширенное руководство по миграции с Prototool на EasyP.*","content":"Заключение *Готово: базовый перевод и расширенное руководство по миграции с Prototool на EasyP.*"},{"id":"TRANSLATION_STATUS::top::0","title":"Translation Status (ru-guide)","path":"/docs/guide/TRANSLATION_STATUS","headings":[],"excerpt":"Этот файл отслеживает прогресс перевода русской документации. Используемые статусы: TODO — требуется перевод IN_PROGRESS — перевод начат, требуется вычитка DONE — перевод завершён и вычитан SKIPPED — не требует перевода ","content":"Этот файл отслеживает прогресс перевода русской документации. Используемые статусы: TODO — требуется перевод IN_PROGRESS — перевод начат, требуется вычитка DONE — перевод завершён и вычитан SKIPPED — не требует перевода (намеренно оставлено на английском)"},{"id":"TRANSLATION_STATUS::top::1","title":"Translation Status (ru-guide)","path":"/docs/guide/TRANSLATION_STATUS","headings":[],"excerpt":"Правила: После полного перевода файла убрать исходный английский текст и маркер Термины протокола и ключевые идентификаторы (названия правил, CLI команды, YAML ключи) НЕ переводим. Если структура исходного файла изменила","content":"Правила: После полного перевода файла убрать исходный английский текст и маркер Термины протокола и ключевые идентификаторы (названия правил, CLI команды, YAML ключи) НЕ переводим. Если структура исходного файла изменилась — добавить в начало: Для больших изменений: сначала IN_PROGRESS, после вычитки менять на DONE."},{"id":"TRANSLATION_STATUS::summary::2","title":"Translation Status (ru-guide)","section":"Summary","path":"/docs/guide/TRANSLATION_STATUS#summary","headings":["Summary"],"excerpt":"Summary Итого файлов: 76 DONE: 76 IN_PROGRESS: 0 TODO: 0","content":"Summary Итого файлов: 76 DONE: 76 IN_PROGRESS: 0 TODO: 0"},{"id":"TRANSLATION_STATUS::priority-order::3","title":"Translation Status (ru-guide)","section":"Priority Order (рекомендованный)","path":"/docs/guide/TRANSLATION_STATUS#priority-order","headings":["Priority Order (рекомендованный)"],"excerpt":"Priority Order (рекомендованный) introduction/what-is.md introduction/quickstart.md introduction/install.md cli/linter/linter.md cli/generator/generator.md cli/package-manager/package-manager.md cli/breaking-changes/brea","content":"Priority Order (рекомендованный) introduction/what-is.md introduction/quickstart.md introduction/install.md cli/linter/linter.md cli/generator/generator.md cli/package-manager/package-manager.md cli/breaking-changes/breaking-changes.md api-service/overview.md migration/* (пакетом)"},{"id":"TRANSLATION_STATUS::priority-order::4","title":"Translation Status (ru-guide)","section":"Priority Order (рекомендованный)","path":"/docs/guide/TRANSLATION_STATUS#priority-order","headings":["Priority Order (рекомендованный)"],"excerpt":"Priority Order (рекомендованный) ---","content":"Priority Order (рекомендованный) ---"},{"id":"TRANSLATION_STATUS::file-status-table::5","title":"Translation Status (ru-guide)","section":"File Status Table","path":"/docs/guide/TRANSLATION_STATUS#file-status-table","headings":["File Status Table"],"excerpt":"File Status Table File Status Notes ------ -------- ------- introduction/what-is.md DONE Полный перевод выполнен introduction/quickstart.md DONE Структура сохранена, перевод вычитан introduction/install.md DONE Переведен","content":"File Status Table File Status Notes ------ -------- ------- introduction/what-is.md DONE Полный перевод выполнен introduction/quickstart.md DONE Структура сохранена, перевод вычитан introduction/install.md DONE Переведено, команды проверены api-service/overview.md DONE Переведено ci-cd/github-actions.md DONE Переведено ci-cd/gitlab.md DONE Переведено cli/auto-completion/auto-completion.md DONE Переведено cli/breaking-changes/breaking-changes.md DONE Переведено и вычитано cli/breaking-changes/rules/enum-no-delete.md DONE Переведено cli/breaking-changes/rules/enum-value-no-delete.md DONE Переведено cli/breaking-changes/rules/enum-value-same-name.md DONE Переведено cli/breaking-changes/rules/field-no-delete.md DONE Переведено cli/breaking-changes/rules/field-same-cardinality.md DONE Переведено cli/breaking-changes/rules/field-same-type.md DONE Переведено cli/breaking-changes/rules/import-no-delete.md DONE Переведено cli/breaking-changes/rules/message-no-delete.md DONE Переведено cli/breaking-changes/rules/oneof-field-no-delete.md DONE Переведено cli/breaking-changes/rules/oneof-field-same-type.md DONE Переведено cli/breaking-changes/rules/oneof-no-delete.md DONE Переведено cli/breaking-changes/rules/rpc-no-delete.md DONE Переведено cli/breaking-changes/rules/rpc-same-request-type.md DONE Переведено cli/breaking-changes/rules/rpc-same-response-type.md DONE Переведено cli/breaking-changes/rules/service-no-delete.md DONE Переведено cli/configuration/configuration.md DONE Переведено cli/generator/examples/go.md DONE Переведено cli/generator/examples/grpc-gateway.md DONE Переведено cli/generator/examples/validate.md DONE Переведено cli/generator/generator.md DONE Переведено и вычитано cli/linter/linter.md DONE Переведено и вычитано cli/linter/rules/comment-enum-value.md DONE Переведено cli/linter/rules/comment-enum.md DONE Переведено cli/linter/rules/comment-field.md DONE Переведено cli/linter/rules/comment-message.md DONE Переведено cli/linter/rules/comment-oneof.md DONE Переведено cli/linter/rules/comment-rpc.md DONE Переведено cli/linter/rules/comment-service.md DONE Переведено cli/linter/rules/directory-same-package.md DONE Переведено cli/linter/rules/enum-first-value-zero.md DONE Переведено cli/linter/rules/enum-no-allow-alias.md DONE Переведено cli/linter/rules/enum-pascal-case.md DONE Переведено cli/linter/rules/enum-value-prefix.md DONE Переведено cli/linter/rules/enum-value-upper-snake-case.md DONE Переведено cli/linter/rules/enum-zero-value-suffix.md DONE Переведено cli/linter/rules/field-lower-snake-case.md DONE Переведено cli/linter/rules/file-lower-snake-case.md DONE Переведено cli/linter/rules/import-no-public.md DONE Переведено cli/linter/rules/import-no-weak.md DONE Переведено cli/linter/rules/import-used.md DONE Переведено cli/linter/rules/message-pascal-case.md DONE Переведено cli/linter/rules/oneof-lower-snake-case.md DONE Переведено cli/linter/rules/package-defined.md DONE Переведено cli/linter/rules/package-directory-match.md DONE Переведено cli/linter/rules/package-lower-snake-case.md DONE Переведено cli/linter/rules/package-same-csharp-namespace.md DONE Переведено cli/linter/rules/package-same-directory.md DONE Переведено cli/linter/rules/package-same-go-package.md DONE Переведено cli/linter/rules/package-same-java-multiple-files.md DONE Переведено cli/linter/rules/package-same-java-package.md DONE Переведено cli/linter/rules/package-same-php-namespace.md DONE Переведено cli/linter/rules/package-same-ruby-package.md DONE Переведено cli/linter/rules/package-same-swift-prefix.md DONE Переведено cli/linter/rules/package-version-suffix.md DONE Переведено cli/linter/rules/rpc-no-client-streaming.md DONE Переведено cli/linter/rules/rpc-no-server-streaming.md DONE Переведено cli/linter/rules/rpc-pascal-case.md DONE Переведено cli/linter/rules/rpc-request-response-unique.md DONE Переведено cli/linter/rules/rpc-request-standard-name.md DONE Переведено cli/linter/rules/rpc-response-standard-name.md DONE Переведено cli/linter/rules/service-pascal-case.md DONE Переведено cli/linter/rules/service-suffix.md DONE Переведено cli/package-manager/easyp-vs-buf.md DONE Переведено cli/package-manager/package-manager.md DONE Переведено и вычитано migration/buf-cli.md DONE Переведено migration/protoc.md DONE Переведено migration/protolock.md DONE Переведено migration/prototool.md DONE Переведено"},{"id":"TRANSLATION_STATUS::workflow::6","title":"Translation Status (ru-guide)","section":"Workflow","path":"/docs/guide/TRANSLATION_STATUS#workflow","headings":["Workflow"],"excerpt":"Workflow Выбираем файл со статусом TODO. Меняем статус на IN_PROGRESS здесь. Переводим, проверяем терминологию (сверка с глоссарием — добавить позже). Меняем статус на DONE. Удаляем маркер внутри файла.","content":"Workflow Выбираем файл со статусом TODO. Меняем статус на IN_PROGRESS здесь. Переводим, проверяем терминологию (сверка с глоссарием — добавить позже). Меняем статус на DONE. Удаляем маркер внутри файла."},{"id":"TRANSLATION_STATUS::planned-terminology::7","title":"Translation Status (ru-guide)","section":"Planned Terminology (черновик)","path":"/docs/guide/TRANSLATION_STATUS#planned-terminology","headings":["Planned Terminology (черновик)"],"excerpt":"Planned Terminology (черновик) EN RU Notes ---- ---- ------- Linting Линтинг Транслитерация Breaking Changes Несовместимые изменения Название секции Dependency Зависимость Code Generation Генерация кода Lock file Lock-фа","content":"Planned Terminology (черновик) EN RU Notes ---- ---- ------- Linting Линтинг Транслитерация Breaking Changes Несовместимые изменения Название секции Dependency Зависимость Code Generation Генерация кода Lock file Lock-файл Remote Plugin Удалённый плагин Package Manager Менеджер пакетов"},{"id":"TRANSLATION_STATUS::planned-terminology::8","title":"Translation Status (ru-guide)","section":"Planned Terminology (черновик)","path":"/docs/guide/TRANSLATION_STATUS#planned-terminology","headings":["Planned Terminology (черновик)"],"excerpt":"Planned Terminology (черновик) (Будет дополнено.)","content":"Planned Terminology (черновик) (Будет дополнено.)"},{"id":"TRANSLATION_STATUS::planned-terminology::9","title":"Translation Status (ru-guide)","section":"Planned Terminology (черновик)","path":"/docs/guide/TRANSLATION_STATUS#planned-terminology","headings":["Planned Terminology (черновик)"],"excerpt":"Planned Terminology (черновик) ---","content":"Planned Terminology (черновик) ---"},{"id":"TRANSLATION_STATUS::top::10","title":"Translation Status (ru-guide)","section":"История обновлений","path":"/docs/guide/TRANSLATION_STATUS","headings":["История обновлений"],"excerpt":"История обновлений Initial file created: all statuses set (3 IN_PROGRESS, rest TODO). Marked breaking-changes page as DONE. Linter rules (41 файлов) переведены: статусы DONE. Breaking-changes rules (15 файлов) вычитаны и","content":"История обновлений Initial file created: all statuses set (3 IN_PROGRESS, rest TODO). Marked breaking-changes page as DONE. Linter rules (41 файлов) переведены: статусы DONE. Breaking-changes rules (15 файлов) вычитаны и помечены DONE. Все оставшиеся страницы переведены: итог DONE = 76."}]
\ No newline at end of file
diff --git a/docs/dist/site.webmanifest b/docs/dist/site.webmanifest
deleted file mode 100644
index 5814f0fc..00000000
--- a/docs/dist/site.webmanifest
+++ /dev/null
@@ -1,44 +0,0 @@
-{
-  "name": "EasyP - Modern Protobuf Toolkit",
-  "short_name": "EasyP",
-  "description": "Современный инструментарий для работы с Protocol Buffers и gRPC API",
-  "start_url": "/",
-  "display": "standalone",
-  "background_color": "#020617",
-  "theme_color": "#3b82f6",
-  "orientation": "portrait-primary",
-  "categories": [
-    "developer",
-    "productivity"
-  ],
-  "lang": "ru",
-  "icons": [
-    {
-      "src": "/favicon-16.png",
-      "sizes": "16x16",
-      "type": "image/png"
-    },
-    {
-      "src": "/favicon-32.png",
-      "sizes": "32x32",
-      "type": "image/png"
-    },
-    {
-      "src": "/apple-touch-icon.png",
-      "sizes": "180x180",
-      "type": "image/png"
-    },
-    {
-      "src": "/icon-192.png",
-      "sizes": "192x192",
-      "type": "image/png",
-      "purpose": "maskable any"
-    },
-    {
-      "src": "/icon-512.png",
-      "sizes": "512x512",
-      "type": "image/png",
-      "purpose": "maskable any"
-    }
-  ]
-}
\ No newline at end of file
diff --git a/docs/index.html b/docs/index.html
deleted file mode 100644
index f17f4178..00000000
--- a/docs/index.html
+++ /dev/null
@@ -1,44 +0,0 @@
-<!DOCTYPE html>
-<html lang="ru" class="dark">
-
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>EasyP | Modern Protobuf Toolkit</title>
-
-    <!-- Favicon -->
-    <link rel="icon" type="image/png" sizes="32x32" href="/favicon-32.png">
-    <link rel="icon" type="image/png" sizes="16x16" href="/favicon-16.png">
-    <link rel="icon" type="image/x-icon" href="/favicon.ico">
-    <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
-    <link rel="manifest" href="/site.webmanifest">
-    <meta name="theme-color" content="#3b82f6">
-
-    <!-- Meta tags -->
-    <meta name="description" content="EasyP - Modern Protobuf Toolkit для разработки и управления API">
-    <meta name="keywords" content="protobuf, grpc, api, toolkit, easyp, protocol buffers">
-    <meta name="author" content="EasyP Team">
-
-    <!-- Open Graph -->
-    <meta property="og:type" content="website">
-    <meta property="og:title" content="EasyP | Modern Protobuf Toolkit">
-    <meta property="og:description" content="Современный инструментарий для работы с Protocol Buffers и gRPC API">
-    <meta property="og:image" content="/apple-touch-icon.png">
-
-    <!-- Twitter -->
-    <meta name="twitter:card" content="summary">
-    <meta name="twitter:title" content="EasyP | Modern Protobuf Toolkit">
-    <meta name="twitter:description" content="Современный инструментарий для работы с Protocol Buffers и gRPC API">
-
-    <!-- Fonts -->
-    <link
-        href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap"
-        rel="stylesheet">
-</head>
-
-<body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-</body>
-
-</html>
\ No newline at end of file
diff --git a/docs/index.html.backup b/docs/index.html.backup
deleted file mode 100644
index e283fc5e..00000000
--- a/docs/index.html.backup
+++ /dev/null
@@ -1,681 +0,0 @@
-<!DOCTYPE html>
-<html lang="ru" class="dark">
-
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>EasyP | Modern Protobuf Toolkit</title>
-
-    <!-- React & ReactDOM -->
-    <script crossorigin src="https://unpkg.com/react@18/umd/react.development.js"></script>
-    <script crossorigin src="https://unpkg.com/react-dom@18/umd/react-dom.development.js"></script>
-
-    <!-- Babel -->
-    <script src="https://unpkg.com/@babel/standalone/babel.min.js"></script>
-
-    <!-- Tailwind CSS -->
-    <script src="https://cdn.tailwindcss.com"></script>
-
-    <!-- Lucide Icons -->
-    <script src="https://unpkg.com/lucide@latest"></script>
-
-    <!-- Fonts -->
-    <link
-        href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap"
-        rel="stylesheet">
-
-    <script>
-        tailwind.config = {
-            darkMode: 'class',
-            theme: {
-                extend: {
-                    fontFamily: {
-                        sans: ['Inter', 'sans-serif'],
-                        mono: ['JetBrains Mono', 'monospace'],
-                    },
-                    colors: {
-                        // Modern Palette based on Slate
-                        background: '#020617', // Slate 950
-                        surface: '#0f172a',    // Slate 900
-                        surfaceHighlight: '#1e293b', // Slate 800
-                        border: '#334155',     // Slate 700
-                        primary: '#3b82f6',    // Blue 500
-                        primaryGlow: '#60a5fa', // Blue 400
-                        secondary: '#8b5cf6',  // Violet 500
-                    },
-                    animation: {
-                        'float': 'float 6s ease-in-out infinite',
-                        'fade-in-up': 'fadeInUp 0.8s ease-out forwards',
-                    },
-                    keyframes: {
-                        float: {
-                            '0%, 100%': { transform: 'translateY(0)' },
-                            '50%': { transform: 'translateY(-20px)' },
-                        },
-                        fadeInUp: {
-                            '0%': { opacity: '0', transform: 'translateY(20px)' },
-                            '100%': { opacity: '1', transform: 'translateY(0)' },
-                        }
-                    }
-                }
-            }
-        }
-    </script>
-
-    <style>
-        body {
-            background-color: #020617;
-            color: #e2e8f0;
-        }
-
-        /* Smooth Gradients */
-        .bg-glow-gradient {
-            background: radial-gradient(circle at center, rgba(59, 130, 246, 0.15) 0%, transparent 70%);
-        }
-
-        .text-gradient {
-            background: linear-gradient(to right, #60a5fa, #a78bfa);
-            -webkit-background-clip: text;
-            -webkit-text-fill-color: transparent;
-        }
-
-        /* Glassmorphism */
-        .glass-panel {
-            background: rgba(15, 23, 42, 0.6);
-            backdrop-filter: blur(12px);
-            border: 1px solid rgba(255, 255, 255, 0.08);
-        }
-
-        /* Custom Scrollbar */
-        ::-webkit-scrollbar {
-            width: 8px;
-        }
-
-        ::-webkit-scrollbar-track {
-            background: #020617;
-        }
-
-        ::-webkit-scrollbar-thumb {
-            background: #334155;
-            border-radius: 4px;
-        }
-
-        ::-webkit-scrollbar-thumb:hover {
-            background: #475569;
-        }
-    </style>
-</head>
-
-<body>
-    <div id="root"></div>
-
-    <script type="text/babel">
-        const { useState, useEffect, useRef } = React;
-
-        // Helper to create Lucide icons
-        const createLucideIcon = (iconName) => ({ size = 20, className, ...props }) => {
-            const iconData = lucide.icons[iconName];
-            if (!iconData) return null;
-            return (
-                <svg
-                    xmlns="http://www.w3.org/2000/svg"
-                    width={size}
-                    height={size}
-                    viewBox="0 0 24 24"
-                    fill="none"
-                    stroke="currentColor"
-                    strokeWidth="2"
-                    strokeLinecap="round"
-                    strokeLinejoin="round"
-                    className={className}
-                    {...props}
-                >
-                    {iconData.map((child, index) => {
-                        const [tagName, attrs] = child;
-                        return React.createElement(tagName, { ...attrs, key: index });
-                    })}
-                </svg>
-            );
-        };
-
-        const TerminalIcon = createLucideIcon('Terminal');
-        const ServerIcon = createLucideIcon('Server');
-        const ZapIcon = createLucideIcon('Zap');
-        const BoxIcon = createLucideIcon('Box');
-        const ShieldIcon = createLucideIcon('Shield');
-        const CheckCircleIcon = createLucideIcon('CheckCircle');
-        const ArrowRightIcon = createLucideIcon('ArrowRight');
-        const CopyIcon = createLucideIcon('Copy');
-        const ChevronRightIcon = createLucideIcon('ChevronRight');
-        const ChevronDownIcon = createLucideIcon('ChevronDown');
-        const GlobeIcon = createLucideIcon('Globe');
-        const GithubIcon = createLucideIcon('Github');
-        const CodeIcon = createLucideIcon('Code');
-        const LayersIcon = createLucideIcon('Layers');
-        const LockIcon = createLucideIcon('Lock');
-        const SearchIcon = createLucideIcon('Search');
-        const HeartIcon = createLucideIcon('Heart');
-        const PackageIcon = createLucideIcon('Package');
-        const BookOpenIcon = createLucideIcon('BookOpen');
-
-        // --- COMPONENTS ---
-
-        const Navbar = () => (
-            <nav className="fixed top-0 w-full z-50 glass-panel border-b-0 border-white/5">
-                <div className="max-w-7xl mx-auto px-6">
-                    <div className="flex items-center justify-between h-16">
-                        {/* Logo */}
-                        <div className="flex items-center gap-2 cursor-pointer">
-                            <div className="w-8 h-8 bg-primary/20 rounded-lg flex items-center justify-center border border-primary/30">
-                                <span className="font-bold text-primary">E</span>
-                            </div>
-                            <span className="font-semibold text-lg tracking-tight text-white">EasyP</span>
-                        </div>
-
-                        {/* Links */}
-                        <div className="hidden md:flex items-center space-x-8 text-sm font-medium text-slate-400">
-                            <a href="#features" className="hover:text-white transition-colors">Features</a>
-                            <a href="#registry" className="hover:text-white transition-colors">Registry</a>
-                            <a href="#enterprise" className="hover:text-white transition-colors">Enterprise</a>
-                            <a href="https://github.com" className="hover:text-white transition-colors flex items-center gap-2">
-                                <CodeIcon size={16} /> GitHub
-                            </a>
-                        </div>
-
-                        {/* CTA */}
-                        <div className="flex items-center gap-4">
-                            <a href="#" className="hidden sm:flex items-center gap-2 text-sm font-medium text-slate-400 hover:text-pink-400 transition-colors">
-                                <HeartIcon size={16} /> Sponsor
-                            </a>
-                            <button className="bg-white text-black px-4 py-2 rounded-full text-sm font-semibold hover:bg-slate-200 transition-all shadow-lg shadow-white/10">
-                                Get Started
-                            </button>
-                        </div>
-                    </div>
-                </div>
-            </nav>
-        );
-
-        const Hero = () => {
-            const [installMethod, setInstallMethod] = useState('brew');
-            const [isDropdownOpen, setIsDropdownOpen] = useState(false);
-            const dropdownRef = useRef(null);
-
-            // Auto-detect OS on mount
-            useEffect(() => {
-                const platform = navigator.platform.toLowerCase();
-                const userAgent = navigator.userAgent.toLowerCase();
-
-                if (platform.includes('mac') || userAgent.includes('mac')) {
-                    setInstallMethod('brew');
-                } else if (platform.includes('linux') || userAgent.includes('linux') || platform.includes('win') || userAgent.includes('win')) {
-                    setInstallMethod('go');
-                } else {
-                    setInstallMethod('go');
-                }
-
-                const handleClickOutside = (event) => {
-                    if (dropdownRef.current && !dropdownRef.current.contains(event.target)) {
-                        setIsDropdownOpen(false);
-                    }
-                };
-                document.addEventListener('mousedown', handleClickOutside);
-                return () => document.removeEventListener('mousedown', handleClickOutside);
-            }, []);
-
-            const installOptions = [
-                { id: 'brew', label: 'Brew', fullLabel: 'macOS (Homebrew)', cmd: 'brew install easyp-tech/tap/easyp' },
-                { id: 'go', label: 'Go', fullLabel: 'Go Install (Any OS)', cmd: 'go install github.com/easyp-tech/easyp/cmd/easyp@latest' },
-                { id: 'docker', label: 'Docker', fullLabel: 'Docker', cmd: 'docker pull easyp/easyp:latest' }
-            ];
-
-            const activeOption = installOptions.find(o => o.id === installMethod) || installOptions[0];
-
-            return (
-                <section className="relative pt-32 pb-20 lg:pt-48 lg:pb-32 overflow-hidden">
-                    {/* Ambient Background */}
-                    <div className="absolute top-0 left-1/2 -translate-x-1/2 w-[1000px] h-[600px] bg-primary/20 rounded-full blur-[120px] opacity-30 pointer-events-none"></div>
-
-                    <div className="max-w-7xl mx-auto px-6 relative z-10">
-                        <div className="flex flex-col items-center text-center mb-16">
-
-                            <div className="flex gap-3 mb-8 animate-fade-in-up">
-                                <div className="inline-flex items-center gap-2 px-3 py-1 rounded-full bg-slate-800/50 border border-slate-700/50 text-primary text-xs font-medium">
-                                    <span className="relative flex h-2 w-2">
-                                        <span className="animate-ping absolute inline-flex h-full w-full rounded-full bg-primary opacity-75"></span>
-                                        <span className="relative inline-flex rounded-full h-2 w-2 bg-primary"></span>
-                                    </span>
-                                    v1.0 Beta
-                                </div>
-                                <div className="inline-flex items-center gap-2 px-3 py-1 rounded-full bg-slate-800/50 border border-slate-700/50 text-slate-300 text-xs font-medium">
-                                    <ShieldIcon size={12} className="text-emerald-400" />
-                                    Apache 2.0 License
-                                </div>
-                            </div>
-
-                            <h1 className="text-5xl lg:text-7xl font-bold text-white tracking-tight leading-[1.1] mb-6 max-w-4xl animate-fade-in-up [animation-delay:100ms]">
-                                The Modern Standard for <br />
-                                <span className="text-gradient">Protobuf Workflows</span>
-                            </h1>
-
-                            <p className="text-lg text-slate-400 max-w-2xl mb-10 leading-relaxed animate-fade-in-up [animation-delay:200ms]">
-                                Единый Git-native инструментарий для линтинга, генерации кода и управления зависимостями.
-                                Полностью Open Source. Суверенно.
-                            </p>
-
-                            <div className="flex flex-col sm:flex-row items-center gap-4 animate-fade-in-up [animation-delay:300ms] w-full max-w-2xl relative z-20">
-
-                                {/* Install Box with Integrated Dropdown */}
-                                <div className="relative w-full sm:w-auto flex-grow group" ref={dropdownRef}>
-                                    <div className="flex items-center bg-slate-900 border border-slate-800 rounded-xl px-1 py-1 pr-2 shadow-xl w-full group-hover:border-slate-600 transition-colors">
-
-                                        {/* Trigger Button */}
-                                        <button
-                                            onClick={() => setIsDropdownOpen(!isDropdownOpen)}
-                                            className="flex items-center gap-2 text-slate-300 hover:text-white hover:bg-slate-800 transition-all text-sm font-medium px-3 py-2 rounded-lg shrink-0 border-r border-slate-800/50 mr-2"
-                                            title="Select installation method"
-                                        >
-                                            <span>{activeOption.label}</span>
-                                            <ChevronDownIcon size={14} className={`text-slate-500 transition-transform duration-200 ${isDropdownOpen ? 'rotate-180' : ''}`} />
-                                        </button>
-
-                                        {/* Command Code */}
-                                        <div className="flex-grow overflow-hidden flex items-center">
-                                            <ChevronRightIcon size={14} className="text-slate-600 mr-2 shrink-0" />
-                                            <code className="font-mono text-sm text-slate-300 whitespace-nowrap overflow-x-auto no-scrollbar block selection:bg-primary/30 selection:text-white">
-                                                {activeOption.cmd}
-                                            </code>
-                                        </div>
-
-                                        {/* Copy Button */}
-                                        <button
-                                            className="p-2 hover:bg-slate-800 rounded-lg transition-colors text-slate-500 hover:text-white shrink-0 ml-2"
-                                            title="Copy to clipboard"
-                                            onClick={() => navigator.clipboard.writeText(activeOption.cmd)}
-                                        >
-                                            <CopyIcon size={16} />
-                                        </button>
-                                    </div>
-
-                                    {/* Dropdown Menu */}
-                                    {isDropdownOpen && (
-                                        <div className="absolute top-full left-0 mt-2 w-64 bg-slate-900 border border-slate-800 rounded-xl shadow-2xl overflow-hidden animate-fade-in-up z-30">
-                                            <div className="py-1">
-                                                {installOptions.map(opt => (
-                                                    <button
-                                                        key={opt.id}
-                                                        onClick={() => {
-                                                            setInstallMethod(opt.id);
-                                                            setIsDropdownOpen(false);
-                                                        }}
-                                                        className={`w-full text-left px-4 py-3 text-sm transition-colors flex items-center justify-between group ${installMethod === opt.id ? 'bg-primary/10' : 'hover:bg-slate-800'}`}
-                                                    >
-                                                        <span className={`${installMethod === opt.id ? 'text-primary font-medium' : 'text-slate-300 group-hover:text-white'}`}>
-                                                            {opt.fullLabel}
-                                                        </span>
-                                                        {installMethod === opt.id && <CheckCircleIcon size={16} className="text-primary" />}
-                                                    </button>
-                                                ))}
-                                            </div>
-                                        </div>
-                                    )}
-                                </div>
-
-                                {/* Explore Docs Button (Reverted to original style) */}
-                                <button className="w-full sm:w-auto px-6 py-3 rounded-full bg-primary/10 text-primary font-medium hover:bg-primary/20 transition-colors border border-primary/20 whitespace-nowrap">
-                                    Explore Documentation
-                                </button>
-                            </div>
-                        </div>
-
-                        {/* Hero Image / Visual */}
-                        <div className="relative max-w-5xl mx-auto rounded-xl border border-slate-800 bg-slate-950/80 shadow-2xl shadow-primary/10 overflow-hidden animate-fade-in-up [animation-delay:500ms]">
-                            <div className="flex items-center px-4 py-3 border-b border-slate-800 bg-slate-900/50 gap-2">
-                                <div className="w-3 h-3 rounded-full bg-slate-700"></div>
-                                <div className="w-3 h-3 rounded-full bg-slate-700"></div>
-                                <div className="w-3 h-3 rounded-full bg-slate-700"></div>
-                                <div className="ml-4 text-xs text-slate-500 font-mono">easyp — zsh</div>
-                            </div>
-                            <div className="p-6 sm:p-10 font-mono text-sm sm:text-base leading-loose">
-                                <div className="flex items-start gap-2">
-                                    <span className="text-primary font-bold">➜</span>
-                                    <span className="text-slate-300">easyp generate --remote</span>
-                                </div>
-                                <div className="text-slate-400 mt-2 pl-4 border-l-2 border-slate-800">
-                                    <div className="flex items-center gap-2">
-                                        <span className="text-emerald-400">✔</span>
-                                        <span>Resolving dependencies from <span className="text-slate-300 underline decoration-slate-700">easyp.lock</span>...</span>
-                                    </div>
-                                    <div className="flex items-center gap-2 mt-1">
-                                        <span className="text-emerald-400">✔</span>
-                                        <span>Connecting to EasyP Service... <span className="text-xs bg-emerald-500/10 text-emerald-400 px-1.5 py-0.5 rounded">Connected</span></span>
-                                    </div>
-                                    <div className="mt-2">
-                                        <span className="text-blue-400">[INFO]</span> Dispatching plugins:
-                                        <div className="pl-4 mt-1 text-slate-500">
-                                            ├─ protoc-gen-go (v1.31) <span className="text-xs border border-slate-700 px-1 rounded text-slate-400">WASM</span><br />
-                                            └─ custom-java-gen (v2.0) <span className="text-xs border border-slate-700 px-1 rounded text-slate-400">DOCKER</span>
-                                        </div>
-                                    </div>
-                                    <div className="mt-2 text-slate-300">
-                                        ✨ Generation complete in <span className="text-primary">420ms</span>.
-                                    </div>
-                                </div>
-                                <div className="flex items-start gap-2 mt-4 animate-pulse">
-                                    <span className="text-primary font-bold">➜</span>
-                                    <span className="w-2 h-5 bg-slate-500 inline-block align-middle"></span>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </section>
-            );
-        };
-
-        // ... existing code for TrustedBy, FeatureSwitcher, ArchitectureComparison, RegistryPreview, Footer ...
-
-        const TrustedBy = () => (
-            <section className="py-12 border-y border-white/5 bg-slate-900/30">
-                <div className="max-w-7xl mx-auto px-6 text-center">
-                    <p className="text-sm font-medium text-slate-500 mb-8 uppercase tracking-wider">Trusted by engineering teams at</p>
-                    <div className="flex flex-wrap justify-center items-center gap-12 opacity-40 grayscale hover:grayscale-0 hover:opacity-100 transition-all duration-500">
-                        {/* Simple text placeholders for logos for clean look */}
-                        {['ACME Corp', 'TechFlow', 'DataSystems', 'CloudScale', 'DevCore'].map(name => (
-                            <span key={name} className="text-xl font-bold text-white cursor-default">{name}</span>
-                        ))}
-                    </div>
-                </div>
-            </section>
-        );
-
-        const FeatureSwitcher = () => {
-            const [activeTab, setActiveTab] = useState('cli');
-
-            return (
-                <section id="features" className="py-32 bg-background relative">
-                    <div className="max-w-7xl mx-auto px-6">
-                        <div className="text-center mb-16">
-                            <h2 className="text-3xl md:text-4xl font-bold text-white mb-4">
-                                Two modes. <span className="text-primary">One platform.</span>
-                            </h2>
-                            <p className="text-slate-400 text-lg max-w-2xl mx-auto">
-                                EasyP combines a developer-friendly CLI with a powerful remote execution engine.
-                            </p>
-                        </div>
-
-                        {/* Toggle */}
-                        <div className="flex justify-center mb-16">
-                            <div className="bg-slate-900 p-1.5 rounded-full border border-slate-800 inline-flex shadow-inner">
-                                <button
-                                    onClick={() => setActiveTab('cli')}
-                                    className={`px-8 py-2.5 rounded-full text-sm font-medium transition-all duration-300 ${activeTab === 'cli' ? 'bg-white text-black shadow-lg' : 'text-slate-400 hover:text-white'}`}
-                                >
-                                    Local Development
-                                </button>
-                                <button
-                                    onClick={() => setActiveTab('server')}
-                                    className={`px-8 py-2.5 rounded-full text-sm font-medium transition-all duration-300 ${activeTab === 'server' ? 'bg-white text-black shadow-lg' : 'text-slate-400 hover:text-white'}`}
-                                >
-                                    Remote Infrastructure
-                                </button>
-                            </div>
-                        </div>
-
-                        {/* Content Area */}
-                        <div className="grid lg:grid-cols-2 gap-12 items-center">
-
-                            {/* Left Text */}
-                            <div className="space-y-8">
-                                {activeTab === 'cli' ? (
-                                    <div className="animate-fade-in-up">
-                                        <h3 className="text-2xl font-semibold text-white mb-4">Supercharge your workflow</h3>
-                                        <p className="text-slate-400 text-lg leading-relaxed mb-8">
-                                            Все инструменты в одном бинарнике. Линтинг, форматирование и детекция breaking changes работают мгновенно.
-                                        </p>
-                                        <ul className="space-y-4">
-                                            {[
-                                                { title: 'Package Manager', desc: 'Управление версиями через easyp.lock. Как npm, но для Protobuf.' },
-                                                { title: 'Instant Linting', desc: '100% совместимость с правилами Buf' },
-                                                { title: 'API Safety', desc: 'Проверка обратной совместимости в CI' }
-                                            ].map((item, i) => (
-                                                <li key={i} className="flex gap-4">
-                                                    <div className="w-6 h-6 rounded-full bg-primary/10 flex items-center justify-center shrink-0 text-primary mt-1">
-                                                        {i === 0 ? <PackageIcon size={14} /> : <CheckCircleIcon size={14} />}
-                                                    </div>
-                                                    <div>
-                                                        <h4 className="text-white font-medium">{item.title}</h4>
-                                                        <p className="text-sm text-slate-500">{item.desc}</p>
-                                                    </div>
-                                                </li>
-                                            ))}
-                                        </ul>
-                                    </div>
-                                ) : (
-                                    <div className="animate-fade-in-up">
-                                        <h3 className="text-2xl font-semibold text-white mb-4">Your infrastructure, your rules</h3>
-                                        <p className="text-slate-400 text-lg leading-relaxed mb-8">
-                                            Забудьте о проблеме "works on my machine". Централизованный сервер генерации гарантирует идентичный результат для всей команды.
-                                        </p>
-                                        <ul className="space-y-4">
-                                            {[
-                                                { title: 'Docker Native', desc: 'Запуск любых плагинов (Java, Python, Node) в контейнерах' },
-                                                { title: 'Air-Gap Ready', desc: 'Работает в полностью изолированных контурах' },
-                                                { title: 'Cost Effective', desc: 'Платите за инфраструктуру, а не за пользователей' }
-                                            ].map((item, i) => (
-                                                <li key={i} className="flex gap-4">
-                                                    <div className="w-6 h-6 rounded-full bg-secondary/10 flex items-center justify-center shrink-0 text-secondary mt-1">
-                                                        <ShieldIcon size={14} />
-                                                    </div>
-                                                    <div>
-                                                        <h4 className="text-white font-medium">{item.title}</h4>
-                                                        <p className="text-sm text-slate-500">{item.desc}</p>
-                                                    </div>
-                                                </li>
-                                            ))}
-                                        </ul>
-                                    </div>
-                                )}
-                            </div>
-
-                            {/* Right Visual */}
-                            <div className="relative group">
-                                <div className="absolute -inset-1 bg-gradient-to-r from-primary to-secondary rounded-2xl blur opacity-20 group-hover:opacity-40 transition duration-1000 group-hover:duration-200"></div>
-                                <div className="relative rounded-xl bg-slate-900 border border-slate-800 overflow-hidden shadow-2xl h-[400px] flex flex-col">
-                                    <div className="flex items-center px-4 py-3 border-b border-slate-800 bg-slate-900/50 gap-2">
-                                        <div className="w-3 h-3 rounded-full bg-slate-700"></div>
-                                        <div className="w-3 h-3 rounded-full bg-slate-700"></div>
-                                    </div>
-                                    <div className="p-6 font-mono text-sm flex-grow overflow-hidden">
-                                        {activeTab === 'cli' ? (
-                                            <div className="space-y-2">
-                                                <div className="text-slate-400"># easyp.yaml configuration</div>
-                                                <div className="text-purple-400">version: <span className="text-green-400">v1</span></div>
-                                                <div className="text-purple-400">deps:</div>
-                                                <div className="pl-4 text-slate-300">- github.com/googleapis/googleapis@v1.0</div>
-                                                <div className="text-purple-400 mt-2">lint:</div>
-                                                <div className="pl-4 text-blue-400">use:</div>
-                                                <div className="pl-8 text-slate-300">- STANDARD</div>
-                                                <div className="pl-8 text-slate-300">- COMMENTS</div>
-                                                <div className="text-purple-400 mt-4">breaking:</div>
-                                                <div className="pl-4 text-blue-400">use:</div>
-                                                <div className="pl-8 text-slate-300">- WIRE_JSON</div>
-                                            </div>
-                                        ) : (
-                                            <div className="space-y-2">
-                                                <div className="text-slate-400"># Server Infrastructure</div>
-                                                <div className="flex items-center gap-2 py-2 border-b border-slate-800/50">
-                                                    <BoxIcon size={16} className="text-blue-400" />
-                                                    <span className="text-slate-200">EasyP Service</span>
-                                                    <span className="ml-auto text-xs bg-green-500/10 text-green-500 px-2 rounded-full">Healthy</span>
-                                                </div>
-                                                <div className="pl-4 border-l border-slate-800 space-y-3 mt-3">
-                                                    <div className="flex items-center gap-2">
-                                                        <div className="w-2 h-2 bg-slate-600 rounded-full"></div>
-                                                        <span className="text-slate-400">Registry:</span>
-                                                        <span className="text-slate-200">Local Docker</span>
-                                                    </div>
-                                                    <div className="flex items-center gap-2">
-                                                        <div className="w-2 h-2 bg-slate-600 rounded-full"></div>
-                                                        <span className="text-slate-400">Plugins:</span>
-                                                        <span className="text-slate-200">14 Loaded</span>
-                                                    </div>
-                                                    <div className="flex items-center gap-2">
-                                                        <div className="w-2 h-2 bg-slate-600 rounded-full"></div>
-                                                        <span className="text-slate-400">Uptime:</span>
-                                                        <span className="text-slate-200">42d 12h</span>
-                                                    </div>
-                                                </div>
-                                            </div>
-                                        )}
-                                    </div>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </section>
-            );
-        };
-
-        const ArchitectureComparison = () => (
-            <section className="py-24 border-y border-white/5 bg-slate-900/20">
-                <div className="max-w-5xl mx-auto px-6">
-                    <div className="text-center mb-16">
-                        <h2 className="text-3xl font-bold text-white">Why EasyP is the smarter choice</h2>
-                        <p className="text-slate-400 mt-4">A fundamental shift in how you manage Protobuf infrastructure.</p>
-                    </div>
-
-                    <div className="grid md:grid-cols-3 gap-8">
-                        {/* Card 1 */}
-                        <div className="glass-panel p-8 rounded-2xl hover:border-primary/30 transition-colors group">
-                            <div className="w-12 h-12 bg-blue-500/10 rounded-lg flex items-center justify-center text-blue-400 mb-6 group-hover:scale-110 transition-transform">
-                                <GlobeIcon size={24} />
-                            </div>
-                            <h3 className="text-xl font-semibold text-white mb-3">Data Sovereignty</h3>
-                            <p className="text-slate-400 text-sm leading-relaxed">
-                                Unlike SaaS solutions where schemas live in the cloud, EasyP is <strong>Git-Native</strong>. Your data never leaves your secure repositories.
-                            </p>
-                        </div>
-
-                        {/* Card 2 */}
-                        <div className="glass-panel p-8 rounded-2xl hover:border-secondary/30 transition-colors group">
-                            <div className="w-12 h-12 bg-violet-500/10 rounded-lg flex items-center justify-center text-violet-400 mb-6 group-hover:scale-110 transition-transform">
-                                <LayersIcon size={24} />
-                            </div>
-                            <h3 className="text-xl font-semibold text-white mb-3">Hybrid Runtime</h3>
-                            <p className="text-slate-400 text-sm leading-relaxed">
-                                Don't choose between speed and compatibility. EasyP uses <strong>Wasm</strong> for speed and <strong>Docker</strong> for heavy plugins.
-                            </p>
-                        </div>
-
-                        {/* Card 3 */}
-                        <div className="glass-panel p-8 rounded-2xl hover:border-emerald-500/30 transition-colors group">
-                            <div className="w-12 h-12 bg-emerald-500/10 rounded-lg flex items-center justify-center text-emerald-400 mb-6 group-hover:scale-110 transition-transform">
-                                <LockIcon size={24} />
-                            </div>
-                            <h3 className="text-xl font-semibold text-white mb-3">No Vendor Lock-in</h3>
-                            <p className="text-slate-400 text-sm leading-relaxed">
-                                The entire platform is <strong>Open Source</strong> (Apache 2.0). Host the server yourself, anywhere. No per-user pricing tax.
-                            </p>
-                        </div>
-                    </div>
-                </div>
-            </section>
-        );
-
-        const RegistryPreview = () => (
-            <section id="registry" className="py-24 relative overflow-hidden">
-                <div className="max-w-7xl mx-auto px-6">
-                    <div className="flex items-center justify-between mb-12">
-                        <h2 className="text-2xl font-bold text-white">Plugin Registry</h2>
-                        <a href="#" className="text-sm text-primary hover:text-primaryGlow flex items-center gap-1">
-                            View all <ArrowRightIcon size={14} />
-                        </a>
-                    </div>
-
-                    <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 gap-6">
-                        {[
-                            { name: 'Go', version: 'v1.36.0', type: 'Official' },
-                            { name: 'Python', version: 'v4.24.0', type: 'Docker' },
-                            { name: 'Java', version: 'v3.21.0', type: 'Community' },
-                            { name: 'TypeScript', version: 'v1.12.0', type: 'Wasm' },
-                        ].map((plugin, i) => (
-                            <div key={i} className="bg-slate-900 border border-slate-800 p-6 rounded-xl hover:border-slate-600 transition-all cursor-pointer group">
-                                <div className="flex justify-between items-start mb-4">
-                                    <div className="w-10 h-10 bg-slate-800 rounded flex items-center justify-center text-lg font-bold text-white group-hover:bg-white group-hover:text-black transition-colors">
-                                        {plugin.name[0]}
-                                    </div>
-                                    <span className="text-xs font-mono text-slate-500 bg-slate-950 px-2 py-1 rounded border border-slate-800">
-                                        {plugin.type}
-                                    </span>
-                                </div>
-                                <h4 className="text-white font-medium mb-1">{plugin.name}</h4>
-                                <p className="text-xs text-slate-500 font-mono">{plugin.version}</p>
-                            </div>
-                        ))}
-                    </div>
-                </div>
-            </section>
-        );
-
-        const Footer = () => (
-            <footer className="bg-slate-950 border-t border-slate-800 py-16">
-                <div className="max-w-7xl mx-auto px-6">
-                    <div className="grid md:grid-cols-4 gap-12">
-                        <div className="col-span-2">
-                            <div className="flex items-center gap-2 mb-6">
-                                <div className="w-6 h-6 bg-primary/20 rounded flex items-center justify-center text-primary text-xs font-bold">E</div>
-                                <span className="font-bold text-white">EasyP</span>
-                            </div>
-                            <p className="text-slate-400 text-sm max-w-xs leading-relaxed mb-4">
-                                The sovereign, open-source standard for Protobuf workflows. Built for modern engineering teams.
-                            </p>
-                            <div className="flex items-center gap-2 text-xs text-slate-500">
-                                <ShieldIcon size={12} /> Licensed under Apache 2.0
-                            </div>
-                        </div>
-                        <div>
-                            <h4 className="text-white font-medium mb-4">Product</h4>
-                            <ul className="space-y-3 text-sm text-slate-400">
-                                <li><a href="#" className="hover:text-primary">CLI Tool</a></li>
-                                <li><a href="#" className="hover:text-primary">API Service</a></li>
-                                <li><a href="#" className="hover:text-primary">Registry</a></li>
-                                <li><a href="#" className="hover:text-primary">Enterprise</a></li>
-                            </ul>
-                        </div>
-                        <div>
-                            <h4 className="text-white font-medium mb-4">Community</h4>
-                            <ul className="space-y-3 text-sm text-slate-400">
-                                <li><a href="#" className="hover:text-primary">GitHub</a></li>
-                                <li><a href="#" className="hover:text-primary">Telegram</a></li>
-                                <li><a href="#" className="hover:text-primary">Documentation</a></li>
-                            </ul>
-                        </div>
-                    </div>
-                    <div className="border-t border-slate-800 mt-16 pt-8 flex flex-col md:flex-row justify-between items-center text-xs text-slate-600">
-                        <p>&copy; 2025 EasyP Tech. All rights reserved.</p>
-                        <div className="flex gap-6 mt-4 md:mt-0">
-                            <a href="#" className="hover:text-slate-400">Privacy</a>
-                            <a href="#" className="hover:text-slate-400">Terms</a>
-                        </div>
-                    </div>
-                </div>
-            </footer>
-        );
-
-        const App = () => (
-            <div className="min-h-screen bg-background text-slate-200 font-sans selection:bg-primary/30">
-                <Navbar />
-                <Hero />
-                <TrustedBy />
-                <FeatureSwitcher />
-                <ArchitectureComparison />
-                <RegistryPreview />
-                <Footer />
-            </div>
-        );
-
-        ReactDOM.createRoot(document.getElementById('root')).render(<App />);
-    </script>
-</body>
-
-</html>
\ No newline at end of file
diff --git a/docs/package-lock.json b/docs/package-lock.json
deleted file mode 100644
index f76c1391..00000000
--- a/docs/package-lock.json
+++ /dev/null
@@ -1,5435 +0,0 @@
-{
-  "name": "docs",
-  "version": "1.0.0",
-  "lockfileVersion": 3,
-  "requires": true,
-  "packages": {
-    "": {
-      "name": "docs",
-      "version": "1.0.0",
-      "license": "ISC",
-      "dependencies": {
-        "@headlessui/react": "^2.2.9",
-        "@types/prismjs": "^1.26.5",
-        "@types/react-syntax-highlighter": "^15.5.13",
-        "buffer": "^6.0.3",
-        "fuse.js": "^7.1.0",
-        "gray-matter": "^4.0.3",
-        "i18next": "^25.6.3",
-        "lucide-react": "^0.554.0",
-        "markdown-to-jsx": "^7.7.17",
-        "mermaid": "^11.12.1",
-        "prism-react-renderer": "^2.4.1",
-        "prismjs": "^1.30.0",
-        "react": "^19.2.0",
-        "react-dom": "^19.2.0",
-        "react-i18next": "^16.3.5",
-        "react-router-dom": "^7.9.6",
-        "react-simple-code-editor": "^0.14.1",
-        "react-syntax-highlighter": "^16.1.0",
-        "rehype-highlight": "^7.0.2",
-        "rehype-raw": "^7.0.0"
-      },
-      "devDependencies": {
-        "@types/react": "^19.2.6",
-        "@types/react-dom": "^19.2.3",
-        "@vitejs/plugin-react": "^5.1.1",
-        "autoprefixer": "^10.4.22",
-        "postcss": "^8.5.6",
-        "tailwindcss": "^3.4.18",
-        "typescript": "^5.9.3",
-        "vite": "^7.2.4"
-      }
-    },
-    "node_modules/@alloc/quick-lru": {
-      "version": "5.2.0",
-      "resolved": "https://registry.npmjs.org/@alloc/quick-lru/-/quick-lru-5.2.0.tgz",
-      "integrity": "sha512-UrcABB+4bUrFABwbluTIBErXwvbsU/V7TZWfmbgJfbkwiBuziS9gxdODUyuiecfdGQ85jglMW6juS3+z5TsKLw==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/@antfu/install-pkg": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/@antfu/install-pkg/-/install-pkg-1.1.0.tgz",
-      "integrity": "sha512-MGQsmw10ZyI+EJo45CdSER4zEb+p31LpDAFp2Z3gkSd1yqVZGi0Ebx++YTEMonJy4oChEMLsxZ64j8FH6sSqtQ==",
-      "license": "MIT",
-      "dependencies": {
-        "package-manager-detector": "^1.3.0",
-        "tinyexec": "^1.0.1"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/antfu"
-      }
-    },
-    "node_modules/@antfu/utils": {
-      "version": "9.3.0",
-      "resolved": "https://registry.npmjs.org/@antfu/utils/-/utils-9.3.0.tgz",
-      "integrity": "sha512-9hFT4RauhcUzqOE4f1+frMKLZrgNog5b06I7VmZQV1BkvwvqrbC8EBZf3L1eEL2AKb6rNKjER0sEvJiSP1FXEA==",
-      "license": "MIT",
-      "funding": {
-        "url": "https://github.com/sponsors/antfu"
-      }
-    },
-    "node_modules/@babel/code-frame": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz",
-      "integrity": "sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/helper-validator-identifier": "^7.27.1",
-        "js-tokens": "^4.0.0",
-        "picocolors": "^1.1.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/compat-data": {
-      "version": "7.28.5",
-      "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.28.5.tgz",
-      "integrity": "sha512-6uFXyCayocRbqhZOB+6XcuZbkMNimwfVGFji8CTZnCzOHVGvDqzvitu1re2AU5LROliz7eQPhB8CpAMvnx9EjA==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/core": {
-      "version": "7.28.5",
-      "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.28.5.tgz",
-      "integrity": "sha512-e7jT4DxYvIDLk1ZHmU/m/mB19rex9sv0c2ftBtjSBv+kVM/902eh0fINUzD7UwLLNR+jU585GxUJ8/EBfAM5fw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/code-frame": "^7.27.1",
-        "@babel/generator": "^7.28.5",
-        "@babel/helper-compilation-targets": "^7.27.2",
-        "@babel/helper-module-transforms": "^7.28.3",
-        "@babel/helpers": "^7.28.4",
-        "@babel/parser": "^7.28.5",
-        "@babel/template": "^7.27.2",
-        "@babel/traverse": "^7.28.5",
-        "@babel/types": "^7.28.5",
-        "@jridgewell/remapping": "^2.3.5",
-        "convert-source-map": "^2.0.0",
-        "debug": "^4.1.0",
-        "gensync": "^1.0.0-beta.2",
-        "json5": "^2.2.3",
-        "semver": "^6.3.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/babel"
-      }
-    },
-    "node_modules/@babel/generator": {
-      "version": "7.28.5",
-      "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.5.tgz",
-      "integrity": "sha512-3EwLFhZ38J4VyIP6WNtt2kUdW9dokXA9Cr4IVIFHuCpZ3H8/YFOl5JjZHisrn1fATPBmKKqXzDFvh9fUwHz6CQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/parser": "^7.28.5",
-        "@babel/types": "^7.28.5",
-        "@jridgewell/gen-mapping": "^0.3.12",
-        "@jridgewell/trace-mapping": "^0.3.28",
-        "jsesc": "^3.0.2"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/helper-compilation-targets": {
-      "version": "7.27.2",
-      "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.27.2.tgz",
-      "integrity": "sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/compat-data": "^7.27.2",
-        "@babel/helper-validator-option": "^7.27.1",
-        "browserslist": "^4.24.0",
-        "lru-cache": "^5.1.1",
-        "semver": "^6.3.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/helper-globals": {
-      "version": "7.28.0",
-      "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.28.0.tgz",
-      "integrity": "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/helper-module-imports": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.27.1.tgz",
-      "integrity": "sha512-0gSFWUPNXNopqtIPQvlD5WgXYI5GY2kP2cCvoT8kczjbfcfuIljTbcWrulD1CIPIX2gt1wghbDy08yE1p+/r3w==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/traverse": "^7.27.1",
-        "@babel/types": "^7.27.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/helper-module-transforms": {
-      "version": "7.28.3",
-      "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.3.tgz",
-      "integrity": "sha512-gytXUbs8k2sXS9PnQptz5o0QnpLL51SwASIORY6XaBKF88nsOT0Zw9szLqlSGQDP/4TljBAD5y98p2U1fqkdsw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/helper-module-imports": "^7.27.1",
-        "@babel/helper-validator-identifier": "^7.27.1",
-        "@babel/traverse": "^7.28.3"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0"
-      }
-    },
-    "node_modules/@babel/helper-plugin-utils": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.27.1.tgz",
-      "integrity": "sha512-1gn1Up5YXka3YYAHGKpbideQ5Yjf1tDa9qYcgysz+cNCXukyLl6DjPXhD3VRwSb8c0J9tA4b2+rHEZtc6R0tlw==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/helper-string-parser": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz",
-      "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/helper-validator-identifier": {
-      "version": "7.28.5",
-      "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz",
-      "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/helper-validator-option": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.27.1.tgz",
-      "integrity": "sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/helpers": {
-      "version": "7.28.4",
-      "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.4.tgz",
-      "integrity": "sha512-HFN59MmQXGHVyYadKLVumYsA9dBFun/ldYxipEjzA4196jpLZd8UjEEBLkbEkvfYreDqJhZxYAWFPtrfhNpj4w==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/template": "^7.27.2",
-        "@babel/types": "^7.28.4"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/parser": {
-      "version": "7.28.5",
-      "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.28.5.tgz",
-      "integrity": "sha512-KKBU1VGYR7ORr3At5HAtUQ+TV3SzRCXmA/8OdDZiLDBIZxVyzXuztPjfLd3BV1PRAQGCMWWSHYhL0F8d5uHBDQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/types": "^7.28.5"
-      },
-      "bin": {
-        "parser": "bin/babel-parser.js"
-      },
-      "engines": {
-        "node": ">=6.0.0"
-      }
-    },
-    "node_modules/@babel/plugin-transform-react-jsx-self": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-jsx-self/-/plugin-transform-react-jsx-self-7.27.1.tgz",
-      "integrity": "sha512-6UzkCs+ejGdZ5mFFC/OCUrv028ab2fp1znZmCZjAOBKiBK2jXD1O+BPSfX8X2qjJ75fZBMSnQn3Rq2mrBJK2mw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.27.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-transform-react-jsx-source": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-jsx-source/-/plugin-transform-react-jsx-source-7.27.1.tgz",
-      "integrity": "sha512-zbwoTsBruTeKB9hSq73ha66iFeJHuaFkUbwvqElnygoNbj/jHRsSeokowZFN3CZ64IvEqcmmkVe89OPXc7ldAw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.27.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/runtime": {
-      "version": "7.28.4",
-      "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.28.4.tgz",
-      "integrity": "sha512-Q/N6JNWvIvPnLDvjlE1OUBLPQHH6l3CltCEsHIujp45zQUSSh8K+gHnaEX45yAT1nyngnINhvWtzN+Nb9D8RAQ==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/template": {
-      "version": "7.27.2",
-      "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.27.2.tgz",
-      "integrity": "sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/code-frame": "^7.27.1",
-        "@babel/parser": "^7.27.2",
-        "@babel/types": "^7.27.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/traverse": {
-      "version": "7.28.5",
-      "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.28.5.tgz",
-      "integrity": "sha512-TCCj4t55U90khlYkVV/0TfkJkAkUg3jZFA3Neb7unZT8CPok7iiRfaX0F+WnqWqt7OxhOn0uBKXCw4lbL8W0aQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/code-frame": "^7.27.1",
-        "@babel/generator": "^7.28.5",
-        "@babel/helper-globals": "^7.28.0",
-        "@babel/parser": "^7.28.5",
-        "@babel/template": "^7.27.2",
-        "@babel/types": "^7.28.5",
-        "debug": "^4.3.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/types": {
-      "version": "7.28.5",
-      "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.28.5.tgz",
-      "integrity": "sha512-qQ5m48eI/MFLQ5PxQj4PFaprjyCTLI37ElWMmNs0K8Lk3dVeOdNpB3ks8jc7yM5CDmVC73eMVk/trk3fgmrUpA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/helper-string-parser": "^7.27.1",
-        "@babel/helper-validator-identifier": "^7.28.5"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@braintree/sanitize-url": {
-      "version": "7.1.1",
-      "resolved": "https://registry.npmjs.org/@braintree/sanitize-url/-/sanitize-url-7.1.1.tgz",
-      "integrity": "sha512-i1L7noDNxtFyL5DmZafWy1wRVhGehQmzZaz1HiN5e7iylJMSZR7ekOV7NsIqa5qBldlLrsKv4HbgFUVlQrz8Mw==",
-      "license": "MIT"
-    },
-    "node_modules/@chevrotain/cst-dts-gen": {
-      "version": "11.0.3",
-      "resolved": "https://registry.npmjs.org/@chevrotain/cst-dts-gen/-/cst-dts-gen-11.0.3.tgz",
-      "integrity": "sha512-BvIKpRLeS/8UbfxXxgC33xOumsacaeCKAjAeLyOn7Pcp95HiRbrpl14S+9vaZLolnbssPIUuiUd8IvgkRyt6NQ==",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "@chevrotain/gast": "11.0.3",
-        "@chevrotain/types": "11.0.3",
-        "lodash-es": "4.17.21"
-      }
-    },
-    "node_modules/@chevrotain/gast": {
-      "version": "11.0.3",
-      "resolved": "https://registry.npmjs.org/@chevrotain/gast/-/gast-11.0.3.tgz",
-      "integrity": "sha512-+qNfcoNk70PyS/uxmj3li5NiECO+2YKZZQMbmjTqRI3Qchu8Hig/Q9vgkHpI3alNjr7M+a2St5pw5w5F6NL5/Q==",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "@chevrotain/types": "11.0.3",
-        "lodash-es": "4.17.21"
-      }
-    },
-    "node_modules/@chevrotain/regexp-to-ast": {
-      "version": "11.0.3",
-      "resolved": "https://registry.npmjs.org/@chevrotain/regexp-to-ast/-/regexp-to-ast-11.0.3.tgz",
-      "integrity": "sha512-1fMHaBZxLFvWI067AVbGJav1eRY7N8DDvYCTwGBiE/ytKBgP8azTdgyrKyWZ9Mfh09eHWb5PgTSO8wi7U824RA==",
-      "license": "Apache-2.0"
-    },
-    "node_modules/@chevrotain/types": {
-      "version": "11.0.3",
-      "resolved": "https://registry.npmjs.org/@chevrotain/types/-/types-11.0.3.tgz",
-      "integrity": "sha512-gsiM3G8b58kZC2HaWR50gu6Y1440cHiJ+i3JUvcp/35JchYejb2+5MVeJK0iKThYpAa/P2PYFV4hoi44HD+aHQ==",
-      "license": "Apache-2.0"
-    },
-    "node_modules/@chevrotain/utils": {
-      "version": "11.0.3",
-      "resolved": "https://registry.npmjs.org/@chevrotain/utils/-/utils-11.0.3.tgz",
-      "integrity": "sha512-YslZMgtJUyuMbZ+aKvfF3x1f5liK4mWNxghFRv7jqRR9C3R3fAOGTTKvxXDa2Y1s9zSbcpuO0cAxDYsc9SrXoQ==",
-      "license": "Apache-2.0"
-    },
-    "node_modules/@esbuild/aix-ppc64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.12.tgz",
-      "integrity": "sha512-Hhmwd6CInZ3dwpuGTF8fJG6yoWmsToE+vYgD4nytZVxcu1ulHpUQRAB1UJ8+N1Am3Mz4+xOByoQoSZf4D+CpkA==",
-      "cpu": [
-        "ppc64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "aix"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/android-arm": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.25.12.tgz",
-      "integrity": "sha512-VJ+sKvNA/GE7Ccacc9Cha7bpS8nyzVv0jdVgwNDaR4gDMC/2TTRc33Ip8qrNYUcpkOHUT5OZ0bUcNNVZQ9RLlg==",
-      "cpu": [
-        "arm"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "android"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/android-arm64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.25.12.tgz",
-      "integrity": "sha512-6AAmLG7zwD1Z159jCKPvAxZd4y/VTO0VkprYy+3N2FtJ8+BQWFXU+OxARIwA46c5tdD9SsKGZ/1ocqBS/gAKHg==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "android"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/android-x64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.25.12.tgz",
-      "integrity": "sha512-5jbb+2hhDHx5phYR2By8GTWEzn6I9UqR11Kwf22iKbNpYrsmRB18aX/9ivc5cabcUiAT/wM+YIZ6SG9QO6a8kg==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "android"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/darwin-arm64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.25.12.tgz",
-      "integrity": "sha512-N3zl+lxHCifgIlcMUP5016ESkeQjLj/959RxxNYIthIg+CQHInujFuXeWbWMgnTo4cp5XVHqFPmpyu9J65C1Yg==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/darwin-x64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.25.12.tgz",
-      "integrity": "sha512-HQ9ka4Kx21qHXwtlTUVbKJOAnmG1ipXhdWTmNXiPzPfWKpXqASVcWdnf2bnL73wgjNrFXAa3yYvBSd9pzfEIpA==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/freebsd-arm64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.12.tgz",
-      "integrity": "sha512-gA0Bx759+7Jve03K1S0vkOu5Lg/85dou3EseOGUes8flVOGxbhDDh/iZaoek11Y8mtyKPGF3vP8XhnkDEAmzeg==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "freebsd"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/freebsd-x64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.25.12.tgz",
-      "integrity": "sha512-TGbO26Yw2xsHzxtbVFGEXBFH0FRAP7gtcPE7P5yP7wGy7cXK2oO7RyOhL5NLiqTlBh47XhmIUXuGciXEqYFfBQ==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "freebsd"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/linux-arm": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.25.12.tgz",
-      "integrity": "sha512-lPDGyC1JPDou8kGcywY0YILzWlhhnRjdof3UlcoqYmS9El818LLfJJc3PXXgZHrHCAKs/Z2SeZtDJr5MrkxtOw==",
-      "cpu": [
-        "arm"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/linux-arm64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.25.12.tgz",
-      "integrity": "sha512-8bwX7a8FghIgrupcxb4aUmYDLp8pX06rGh5HqDT7bB+8Rdells6mHvrFHHW2JAOPZUbnjUpKTLg6ECyzvas2AQ==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/linux-ia32": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.25.12.tgz",
-      "integrity": "sha512-0y9KrdVnbMM2/vG8KfU0byhUN+EFCny9+8g202gYqSSVMonbsCfLjUO+rCci7pM0WBEtz+oK/PIwHkzxkyharA==",
-      "cpu": [
-        "ia32"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/linux-loong64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.25.12.tgz",
-      "integrity": "sha512-h///Lr5a9rib/v1GGqXVGzjL4TMvVTv+s1DPoxQdz7l/AYv6LDSxdIwzxkrPW438oUXiDtwM10o9PmwS/6Z0Ng==",
-      "cpu": [
-        "loong64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/linux-mips64el": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.25.12.tgz",
-      "integrity": "sha512-iyRrM1Pzy9GFMDLsXn1iHUm18nhKnNMWscjmp4+hpafcZjrr2WbT//d20xaGljXDBYHqRcl8HnxbX6uaA/eGVw==",
-      "cpu": [
-        "mips64el"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/linux-ppc64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.25.12.tgz",
-      "integrity": "sha512-9meM/lRXxMi5PSUqEXRCtVjEZBGwB7P/D4yT8UG/mwIdze2aV4Vo6U5gD3+RsoHXKkHCfSxZKzmDssVlRj1QQA==",
-      "cpu": [
-        "ppc64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/linux-riscv64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.25.12.tgz",
-      "integrity": "sha512-Zr7KR4hgKUpWAwb1f3o5ygT04MzqVrGEGXGLnj15YQDJErYu/BGg+wmFlIDOdJp0PmB0lLvxFIOXZgFRrdjR0w==",
-      "cpu": [
-        "riscv64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/linux-s390x": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.25.12.tgz",
-      "integrity": "sha512-MsKncOcgTNvdtiISc/jZs/Zf8d0cl/t3gYWX8J9ubBnVOwlk65UIEEvgBORTiljloIWnBzLs4qhzPkJcitIzIg==",
-      "cpu": [
-        "s390x"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/linux-x64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.25.12.tgz",
-      "integrity": "sha512-uqZMTLr/zR/ed4jIGnwSLkaHmPjOjJvnm6TVVitAa08SLS9Z0VM8wIRx7gWbJB5/J54YuIMInDquWyYvQLZkgw==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/netbsd-arm64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.25.12.tgz",
-      "integrity": "sha512-xXwcTq4GhRM7J9A8Gv5boanHhRa/Q9KLVmcyXHCTaM4wKfIpWkdXiMog/KsnxzJ0A1+nD+zoecuzqPmCRyBGjg==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "netbsd"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/netbsd-x64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.25.12.tgz",
-      "integrity": "sha512-Ld5pTlzPy3YwGec4OuHh1aCVCRvOXdH8DgRjfDy/oumVovmuSzWfnSJg+VtakB9Cm0gxNO9BzWkj6mtO1FMXkQ==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "netbsd"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/openbsd-arm64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.12.tgz",
-      "integrity": "sha512-fF96T6KsBo/pkQI950FARU9apGNTSlZGsv1jZBAlcLL1MLjLNIWPBkj5NlSz8aAzYKg+eNqknrUJ24QBybeR5A==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "openbsd"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/openbsd-x64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.25.12.tgz",
-      "integrity": "sha512-MZyXUkZHjQxUvzK7rN8DJ3SRmrVrke8ZyRusHlP+kuwqTcfWLyqMOE3sScPPyeIXN/mDJIfGXvcMqCgYKekoQw==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "openbsd"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/openharmony-arm64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.25.12.tgz",
-      "integrity": "sha512-rm0YWsqUSRrjncSXGA7Zv78Nbnw4XL6/dzr20cyrQf7ZmRcsovpcRBdhD43Nuk3y7XIoW2OxMVvwuRvk9XdASg==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "openharmony"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/sunos-x64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.12.tgz",
-      "integrity": "sha512-3wGSCDyuTHQUzt0nV7bocDy72r2lI33QL3gkDNGkod22EsYl04sMf0qLb8luNKTOmgF/eDEDP5BFNwoBKH441w==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "sunos"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/win32-arm64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.25.12.tgz",
-      "integrity": "sha512-rMmLrur64A7+DKlnSuwqUdRKyd3UE7oPJZmnljqEptesKM8wx9J8gx5u0+9Pq0fQQW8vqeKebwNXdfOyP+8Bsg==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/win32-ia32": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.25.12.tgz",
-      "integrity": "sha512-HkqnmmBoCbCwxUKKNPBixiWDGCpQGVsrQfJoVGYLPT41XWF8lHuE5N6WhVia2n4o5QK5M4tYr21827fNhi4byQ==",
-      "cpu": [
-        "ia32"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@esbuild/win32-x64": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.25.12.tgz",
-      "integrity": "sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@floating-ui/core": {
-      "version": "1.7.3",
-      "resolved": "https://registry.npmjs.org/@floating-ui/core/-/core-1.7.3.tgz",
-      "integrity": "sha512-sGnvb5dmrJaKEZ+LDIpguvdX3bDlEllmv4/ClQ9awcmCZrlx5jQyyMWFM5kBI+EyNOCDDiKk8il0zeuX3Zlg/w==",
-      "license": "MIT",
-      "dependencies": {
-        "@floating-ui/utils": "^0.2.10"
-      }
-    },
-    "node_modules/@floating-ui/dom": {
-      "version": "1.7.4",
-      "resolved": "https://registry.npmjs.org/@floating-ui/dom/-/dom-1.7.4.tgz",
-      "integrity": "sha512-OOchDgh4F2CchOX94cRVqhvy7b3AFb+/rQXyswmzmGakRfkMgoWVjfnLWkRirfLEfuD4ysVW16eXzwt3jHIzKA==",
-      "license": "MIT",
-      "dependencies": {
-        "@floating-ui/core": "^1.7.3",
-        "@floating-ui/utils": "^0.2.10"
-      }
-    },
-    "node_modules/@floating-ui/react": {
-      "version": "0.26.28",
-      "resolved": "https://registry.npmjs.org/@floating-ui/react/-/react-0.26.28.tgz",
-      "integrity": "sha512-yORQuuAtVpiRjpMhdc0wJj06b9JFjrYF4qp96j++v2NBpbi6SEGF7donUJ3TMieerQ6qVkAv1tgr7L4r5roTqw==",
-      "license": "MIT",
-      "dependencies": {
-        "@floating-ui/react-dom": "^2.1.2",
-        "@floating-ui/utils": "^0.2.8",
-        "tabbable": "^6.0.0"
-      },
-      "peerDependencies": {
-        "react": ">=16.8.0",
-        "react-dom": ">=16.8.0"
-      }
-    },
-    "node_modules/@floating-ui/react-dom": {
-      "version": "2.1.6",
-      "resolved": "https://registry.npmjs.org/@floating-ui/react-dom/-/react-dom-2.1.6.tgz",
-      "integrity": "sha512-4JX6rEatQEvlmgU80wZyq9RT96HZJa88q8hp0pBd+LrczeDI4o6uA2M+uvxngVHo4Ihr8uibXxH6+70zhAFrVw==",
-      "license": "MIT",
-      "dependencies": {
-        "@floating-ui/dom": "^1.7.4"
-      },
-      "peerDependencies": {
-        "react": ">=16.8.0",
-        "react-dom": ">=16.8.0"
-      }
-    },
-    "node_modules/@floating-ui/utils": {
-      "version": "0.2.10",
-      "resolved": "https://registry.npmjs.org/@floating-ui/utils/-/utils-0.2.10.tgz",
-      "integrity": "sha512-aGTxbpbg8/b5JfU1HXSrbH3wXZuLPJcNEcZQFMxLs3oSzgtVu6nFPkbbGGUvBcUjKV2YyB9Wxxabo+HEH9tcRQ==",
-      "license": "MIT"
-    },
-    "node_modules/@headlessui/react": {
-      "version": "2.2.9",
-      "resolved": "https://registry.npmjs.org/@headlessui/react/-/react-2.2.9.tgz",
-      "integrity": "sha512-Mb+Un58gwBn0/yWZfyrCh0TJyurtT+dETj7YHleylHk5od3dv2XqETPGWMyQ5/7sYN7oWdyM1u9MvC0OC8UmzQ==",
-      "license": "MIT",
-      "dependencies": {
-        "@floating-ui/react": "^0.26.16",
-        "@react-aria/focus": "^3.20.2",
-        "@react-aria/interactions": "^3.25.0",
-        "@tanstack/react-virtual": "^3.13.9",
-        "use-sync-external-store": "^1.5.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "peerDependencies": {
-        "react": "^18 || ^19 || ^19.0.0-rc",
-        "react-dom": "^18 || ^19 || ^19.0.0-rc"
-      }
-    },
-    "node_modules/@iconify/types": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/@iconify/types/-/types-2.0.0.tgz",
-      "integrity": "sha512-+wluvCrRhXrhyOmRDJ3q8mux9JkKy5SJ/v8ol2tu4FVjyYvtEzkc/3pK15ET6RKg4b4w4BmTk1+gsCUhf21Ykg==",
-      "license": "MIT"
-    },
-    "node_modules/@iconify/utils": {
-      "version": "3.0.2",
-      "resolved": "https://registry.npmjs.org/@iconify/utils/-/utils-3.0.2.tgz",
-      "integrity": "sha512-EfJS0rLfVuRuJRn4psJHtK2A9TqVnkxPpHY6lYHiB9+8eSuudsxbwMiavocG45ujOo6FJ+CIRlRnlOGinzkaGQ==",
-      "license": "MIT",
-      "dependencies": {
-        "@antfu/install-pkg": "^1.1.0",
-        "@antfu/utils": "^9.2.0",
-        "@iconify/types": "^2.0.0",
-        "debug": "^4.4.1",
-        "globals": "^15.15.0",
-        "kolorist": "^1.8.0",
-        "local-pkg": "^1.1.1",
-        "mlly": "^1.7.4"
-      }
-    },
-    "node_modules/@jridgewell/gen-mapping": {
-      "version": "0.3.13",
-      "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz",
-      "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@jridgewell/sourcemap-codec": "^1.5.0",
-        "@jridgewell/trace-mapping": "^0.3.24"
-      }
-    },
-    "node_modules/@jridgewell/remapping": {
-      "version": "2.3.5",
-      "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz",
-      "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@jridgewell/gen-mapping": "^0.3.5",
-        "@jridgewell/trace-mapping": "^0.3.24"
-      }
-    },
-    "node_modules/@jridgewell/resolve-uri": {
-      "version": "3.1.2",
-      "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
-      "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=6.0.0"
-      }
-    },
-    "node_modules/@jridgewell/sourcemap-codec": {
-      "version": "1.5.5",
-      "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
-      "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/@jridgewell/trace-mapping": {
-      "version": "0.3.31",
-      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
-      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@jridgewell/resolve-uri": "^3.1.0",
-        "@jridgewell/sourcemap-codec": "^1.4.14"
-      }
-    },
-    "node_modules/@mermaid-js/parser": {
-      "version": "0.6.3",
-      "resolved": "https://registry.npmjs.org/@mermaid-js/parser/-/parser-0.6.3.tgz",
-      "integrity": "sha512-lnjOhe7zyHjc+If7yT4zoedx2vo4sHaTmtkl1+or8BRTnCtDmcTpAjpzDSfCZrshM5bCoz0GyidzadJAH1xobA==",
-      "license": "MIT",
-      "dependencies": {
-        "langium": "3.3.1"
-      }
-    },
-    "node_modules/@nodelib/fs.scandir": {
-      "version": "2.1.5",
-      "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
-      "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@nodelib/fs.stat": "2.0.5",
-        "run-parallel": "^1.1.9"
-      },
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/@nodelib/fs.stat": {
-      "version": "2.0.5",
-      "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz",
-      "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/@nodelib/fs.walk": {
-      "version": "1.2.8",
-      "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz",
-      "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@nodelib/fs.scandir": "2.1.5",
-        "fastq": "^1.6.0"
-      },
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/@react-aria/focus": {
-      "version": "3.21.2",
-      "resolved": "https://registry.npmjs.org/@react-aria/focus/-/focus-3.21.2.tgz",
-      "integrity": "sha512-JWaCR7wJVggj+ldmM/cb/DXFg47CXR55lznJhZBh4XVqJjMKwaOOqpT5vNN7kpC1wUpXicGNuDnJDN1S/+6dhQ==",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "@react-aria/interactions": "^3.25.6",
-        "@react-aria/utils": "^3.31.0",
-        "@react-types/shared": "^3.32.1",
-        "@swc/helpers": "^0.5.0",
-        "clsx": "^2.0.0"
-      },
-      "peerDependencies": {
-        "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0-rc.1",
-        "react-dom": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0-rc.1"
-      }
-    },
-    "node_modules/@react-aria/interactions": {
-      "version": "3.25.6",
-      "resolved": "https://registry.npmjs.org/@react-aria/interactions/-/interactions-3.25.6.tgz",
-      "integrity": "sha512-5UgwZmohpixwNMVkMvn9K1ceJe6TzlRlAfuYoQDUuOkk62/JVJNDLAPKIf5YMRc7d2B0rmfgaZLMtbREb0Zvkw==",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "@react-aria/ssr": "^3.9.10",
-        "@react-aria/utils": "^3.31.0",
-        "@react-stately/flags": "^3.1.2",
-        "@react-types/shared": "^3.32.1",
-        "@swc/helpers": "^0.5.0"
-      },
-      "peerDependencies": {
-        "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0-rc.1",
-        "react-dom": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0-rc.1"
-      }
-    },
-    "node_modules/@react-aria/ssr": {
-      "version": "3.9.10",
-      "resolved": "https://registry.npmjs.org/@react-aria/ssr/-/ssr-3.9.10.tgz",
-      "integrity": "sha512-hvTm77Pf+pMBhuBm760Li0BVIO38jv1IBws1xFm1NoL26PU+fe+FMW5+VZWyANR6nYL65joaJKZqOdTQMkO9IQ==",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "@swc/helpers": "^0.5.0"
-      },
-      "engines": {
-        "node": ">= 12"
-      },
-      "peerDependencies": {
-        "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0-rc.1"
-      }
-    },
-    "node_modules/@react-aria/utils": {
-      "version": "3.31.0",
-      "resolved": "https://registry.npmjs.org/@react-aria/utils/-/utils-3.31.0.tgz",
-      "integrity": "sha512-ABOzCsZrWzf78ysswmguJbx3McQUja7yeGj6/vZo4JVsZNlxAN+E9rs381ExBRI0KzVo6iBTeX5De8eMZPJXig==",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "@react-aria/ssr": "^3.9.10",
-        "@react-stately/flags": "^3.1.2",
-        "@react-stately/utils": "^3.10.8",
-        "@react-types/shared": "^3.32.1",
-        "@swc/helpers": "^0.5.0",
-        "clsx": "^2.0.0"
-      },
-      "peerDependencies": {
-        "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0-rc.1",
-        "react-dom": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0-rc.1"
-      }
-    },
-    "node_modules/@react-stately/flags": {
-      "version": "3.1.2",
-      "resolved": "https://registry.npmjs.org/@react-stately/flags/-/flags-3.1.2.tgz",
-      "integrity": "sha512-2HjFcZx1MyQXoPqcBGALwWWmgFVUk2TuKVIQxCbRq7fPyWXIl6VHcakCLurdtYC2Iks7zizvz0Idv48MQ38DWg==",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "@swc/helpers": "^0.5.0"
-      }
-    },
-    "node_modules/@react-stately/utils": {
-      "version": "3.10.8",
-      "resolved": "https://registry.npmjs.org/@react-stately/utils/-/utils-3.10.8.tgz",
-      "integrity": "sha512-SN3/h7SzRsusVQjQ4v10LaVsDc81jyyR0DD5HnsQitm/I5WDpaSr2nRHtyloPFU48jlql1XX/S04T2DLQM7Y3g==",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "@swc/helpers": "^0.5.0"
-      },
-      "peerDependencies": {
-        "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0-rc.1"
-      }
-    },
-    "node_modules/@react-types/shared": {
-      "version": "3.32.1",
-      "resolved": "https://registry.npmjs.org/@react-types/shared/-/shared-3.32.1.tgz",
-      "integrity": "sha512-famxyD5emrGGpFuUlgOP6fVW2h/ZaF405G5KDi3zPHzyjAWys/8W6NAVJtNbkCkhedmvL0xOhvt8feGXyXaw5w==",
-      "license": "Apache-2.0",
-      "peerDependencies": {
-        "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0-rc.1"
-      }
-    },
-    "node_modules/@rolldown/pluginutils": {
-      "version": "1.0.0-beta.47",
-      "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.0-beta.47.tgz",
-      "integrity": "sha512-8QagwMH3kNCuzD8EWL8R2YPW5e4OrHNSAHRFDdmFqEwEaD/KcNKjVoumo+gP2vW5eKB2UPbM6vTYiGZX0ixLnw==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/@rollup/rollup-android-arm-eabi": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.53.3.tgz",
-      "integrity": "sha512-mRSi+4cBjrRLoaal2PnqH82Wqyb+d3HsPUN/W+WslCXsZsyHa9ZeQQX/pQsZaVIWDkPcpV6jJ+3KLbTbgnwv8w==",
-      "cpu": [
-        "arm"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "android"
-      ]
-    },
-    "node_modules/@rollup/rollup-android-arm64": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.53.3.tgz",
-      "integrity": "sha512-CbDGaMpdE9sh7sCmTrTUyllhrg65t6SwhjlMJsLr+J8YjFuPmCEjbBSx4Z/e4SmDyH3aB5hGaJUP2ltV/vcs4w==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "android"
-      ]
-    },
-    "node_modules/@rollup/rollup-darwin-arm64": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.53.3.tgz",
-      "integrity": "sha512-Nr7SlQeqIBpOV6BHHGZgYBuSdanCXuw09hon14MGOLGmXAFYjx1wNvquVPmpZnl0tLjg25dEdr4IQ6GgyToCUA==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "darwin"
-      ]
-    },
-    "node_modules/@rollup/rollup-darwin-x64": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.53.3.tgz",
-      "integrity": "sha512-DZ8N4CSNfl965CmPktJ8oBnfYr3F8dTTNBQkRlffnUarJ2ohudQD17sZBa097J8xhQ26AwhHJ5mvUyQW8ddTsQ==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "darwin"
-      ]
-    },
-    "node_modules/@rollup/rollup-freebsd-arm64": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.53.3.tgz",
-      "integrity": "sha512-yMTrCrK92aGyi7GuDNtGn2sNW+Gdb4vErx4t3Gv/Tr+1zRb8ax4z8GWVRfr3Jw8zJWvpGHNpss3vVlbF58DZ4w==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "freebsd"
-      ]
-    },
-    "node_modules/@rollup/rollup-freebsd-x64": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.53.3.tgz",
-      "integrity": "sha512-lMfF8X7QhdQzseM6XaX0vbno2m3hlyZFhwcndRMw8fbAGUGL3WFMBdK0hbUBIUYcEcMhVLr1SIamDeuLBnXS+Q==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "freebsd"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.53.3.tgz",
-      "integrity": "sha512-k9oD15soC/Ln6d2Wv/JOFPzZXIAIFLp6B+i14KhxAfnq76ajt0EhYc5YPeX6W1xJkAdItcVT+JhKl1QZh44/qw==",
-      "cpu": [
-        "arm"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-arm-musleabihf": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.53.3.tgz",
-      "integrity": "sha512-vTNlKq+N6CK/8UktsrFuc+/7NlEYVxgaEgRXVUVK258Z5ymho29skzW1sutgYjqNnquGwVUObAaxae8rZ6YMhg==",
-      "cpu": [
-        "arm"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-arm64-gnu": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.53.3.tgz",
-      "integrity": "sha512-RGrFLWgMhSxRs/EWJMIFM1O5Mzuz3Xy3/mnxJp/5cVhZ2XoCAxJnmNsEyeMJtpK+wu0FJFWz+QF4mjCA7AUQ3w==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-arm64-musl": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.53.3.tgz",
-      "integrity": "sha512-kASyvfBEWYPEwe0Qv4nfu6pNkITLTb32p4yTgzFCocHnJLAHs+9LjUu9ONIhvfT/5lv4YS5muBHyuV84epBo/A==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-loong64-gnu": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.53.3.tgz",
-      "integrity": "sha512-JiuKcp2teLJwQ7vkJ95EwESWkNRFJD7TQgYmCnrPtlu50b4XvT5MOmurWNrCj3IFdyjBQ5p9vnrX4JM6I8OE7g==",
-      "cpu": [
-        "loong64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-ppc64-gnu": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.53.3.tgz",
-      "integrity": "sha512-EoGSa8nd6d3T7zLuqdojxC20oBfNT8nexBbB/rkxgKj5T5vhpAQKKnD+h3UkoMuTyXkP5jTjK/ccNRmQrPNDuw==",
-      "cpu": [
-        "ppc64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-riscv64-gnu": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.53.3.tgz",
-      "integrity": "sha512-4s+Wped2IHXHPnAEbIB0YWBv7SDohqxobiiPA1FIWZpX+w9o2i4LezzH/NkFUl8LRci/8udci6cLq+jJQlh+0g==",
-      "cpu": [
-        "riscv64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-riscv64-musl": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.53.3.tgz",
-      "integrity": "sha512-68k2g7+0vs2u9CxDt5ktXTngsxOQkSEV/xBbwlqYcUrAVh6P9EgMZvFsnHy4SEiUl46Xf0IObWVbMvPrr2gw8A==",
-      "cpu": [
-        "riscv64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-s390x-gnu": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.53.3.tgz",
-      "integrity": "sha512-VYsFMpULAz87ZW6BVYw3I6sWesGpsP9OPcyKe8ofdg9LHxSbRMd7zrVrr5xi/3kMZtpWL/wC+UIJWJYVX5uTKg==",
-      "cpu": [
-        "s390x"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-x64-gnu": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.53.3.tgz",
-      "integrity": "sha512-3EhFi1FU6YL8HTUJZ51imGJWEX//ajQPfqWLI3BQq4TlvHy4X0MOr5q3D2Zof/ka0d5FNdPwZXm3Yyib/UEd+w==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-x64-musl": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.53.3.tgz",
-      "integrity": "sha512-eoROhjcc6HbZCJr+tvVT8X4fW3/5g/WkGvvmwz/88sDtSJzO7r/blvoBDgISDiCjDRZmHpwud7h+6Q9JxFwq1Q==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-openharmony-arm64": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.53.3.tgz",
-      "integrity": "sha512-OueLAWgrNSPGAdUdIjSWXw+u/02BRTcnfw9PN41D2vq/JSEPnJnVuBgw18VkN8wcd4fjUs+jFHVM4t9+kBSNLw==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "openharmony"
-      ]
-    },
-    "node_modules/@rollup/rollup-win32-arm64-msvc": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.53.3.tgz",
-      "integrity": "sha512-GOFuKpsxR/whszbF/bzydebLiXIHSgsEUp6M0JI8dWvi+fFa1TD6YQa4aSZHtpmh2/uAlj/Dy+nmby3TJ3pkTw==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "win32"
-      ]
-    },
-    "node_modules/@rollup/rollup-win32-ia32-msvc": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.53.3.tgz",
-      "integrity": "sha512-iah+THLcBJdpfZ1TstDFbKNznlzoxa8fmnFYK4V67HvmuNYkVdAywJSoteUszvBQ9/HqN2+9AZghbajMsFT+oA==",
-      "cpu": [
-        "ia32"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "win32"
-      ]
-    },
-    "node_modules/@rollup/rollup-win32-x64-gnu": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.53.3.tgz",
-      "integrity": "sha512-J9QDiOIZlZLdcot5NXEepDkstocktoVjkaKUtqzgzpt2yWjGlbYiKyp05rWwk4nypbYUNoFAztEgixoLaSETkg==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "win32"
-      ]
-    },
-    "node_modules/@rollup/rollup-win32-x64-msvc": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.53.3.tgz",
-      "integrity": "sha512-UhTd8u31dXadv0MopwGgNOBpUVROFKWVQgAg5N1ESyCz8AuBcMqm4AuTjrwgQKGDfoFuz02EuMRHQIw/frmYKQ==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "win32"
-      ]
-    },
-    "node_modules/@swc/helpers": {
-      "version": "0.5.17",
-      "resolved": "https://registry.npmjs.org/@swc/helpers/-/helpers-0.5.17.tgz",
-      "integrity": "sha512-5IKx/Y13RsYd+sauPb2x+U/xZikHjolzfuDgTAl/Tdf3Q8rslRvC19NKDLgAJQ6wsqADk10ntlv08nPFw/gO/A==",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "tslib": "^2.8.0"
-      }
-    },
-    "node_modules/@tanstack/react-virtual": {
-      "version": "3.13.12",
-      "resolved": "https://registry.npmjs.org/@tanstack/react-virtual/-/react-virtual-3.13.12.tgz",
-      "integrity": "sha512-Gd13QdxPSukP8ZrkbgS2RwoZseTTbQPLnQEn7HY/rqtM+8Zt95f7xKC7N0EsKs7aoz0WzZ+fditZux+F8EzYxA==",
-      "license": "MIT",
-      "dependencies": {
-        "@tanstack/virtual-core": "3.13.12"
-      },
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/tannerlinsley"
-      },
-      "peerDependencies": {
-        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
-        "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
-      }
-    },
-    "node_modules/@tanstack/virtual-core": {
-      "version": "3.13.12",
-      "resolved": "https://registry.npmjs.org/@tanstack/virtual-core/-/virtual-core-3.13.12.tgz",
-      "integrity": "sha512-1YBOJfRHV4sXUmWsFSf5rQor4Ss82G8dQWLRbnk3GA4jeP8hQt1hxXh0tmflpC0dz3VgEv/1+qwPyLeWkQuPFA==",
-      "license": "MIT",
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/tannerlinsley"
-      }
-    },
-    "node_modules/@types/babel__core": {
-      "version": "7.20.5",
-      "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz",
-      "integrity": "sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/parser": "^7.20.7",
-        "@babel/types": "^7.20.7",
-        "@types/babel__generator": "*",
-        "@types/babel__template": "*",
-        "@types/babel__traverse": "*"
-      }
-    },
-    "node_modules/@types/babel__generator": {
-      "version": "7.27.0",
-      "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.27.0.tgz",
-      "integrity": "sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/types": "^7.0.0"
-      }
-    },
-    "node_modules/@types/babel__template": {
-      "version": "7.4.4",
-      "resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.4.tgz",
-      "integrity": "sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/parser": "^7.1.0",
-        "@babel/types": "^7.0.0"
-      }
-    },
-    "node_modules/@types/babel__traverse": {
-      "version": "7.28.0",
-      "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.28.0.tgz",
-      "integrity": "sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/types": "^7.28.2"
-      }
-    },
-    "node_modules/@types/d3": {
-      "version": "7.4.3",
-      "resolved": "https://registry.npmjs.org/@types/d3/-/d3-7.4.3.tgz",
-      "integrity": "sha512-lZXZ9ckh5R8uiFVt8ogUNf+pIrK4EsWrx2Np75WvF/eTpJ0FMHNhjXk8CKEx/+gpHbNQyJWehbFaTvqmHWB3ww==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/d3-array": "*",
-        "@types/d3-axis": "*",
-        "@types/d3-brush": "*",
-        "@types/d3-chord": "*",
-        "@types/d3-color": "*",
-        "@types/d3-contour": "*",
-        "@types/d3-delaunay": "*",
-        "@types/d3-dispatch": "*",
-        "@types/d3-drag": "*",
-        "@types/d3-dsv": "*",
-        "@types/d3-ease": "*",
-        "@types/d3-fetch": "*",
-        "@types/d3-force": "*",
-        "@types/d3-format": "*",
-        "@types/d3-geo": "*",
-        "@types/d3-hierarchy": "*",
-        "@types/d3-interpolate": "*",
-        "@types/d3-path": "*",
-        "@types/d3-polygon": "*",
-        "@types/d3-quadtree": "*",
-        "@types/d3-random": "*",
-        "@types/d3-scale": "*",
-        "@types/d3-scale-chromatic": "*",
-        "@types/d3-selection": "*",
-        "@types/d3-shape": "*",
-        "@types/d3-time": "*",
-        "@types/d3-time-format": "*",
-        "@types/d3-timer": "*",
-        "@types/d3-transition": "*",
-        "@types/d3-zoom": "*"
-      }
-    },
-    "node_modules/@types/d3-array": {
-      "version": "3.2.2",
-      "resolved": "https://registry.npmjs.org/@types/d3-array/-/d3-array-3.2.2.tgz",
-      "integrity": "sha512-hOLWVbm7uRza0BYXpIIW5pxfrKe0W+D5lrFiAEYR+pb6w3N2SwSMaJbXdUfSEv+dT4MfHBLtn5js0LAWaO6otw==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-axis": {
-      "version": "3.0.6",
-      "resolved": "https://registry.npmjs.org/@types/d3-axis/-/d3-axis-3.0.6.tgz",
-      "integrity": "sha512-pYeijfZuBd87T0hGn0FO1vQ/cgLk6E1ALJjfkC0oJ8cbwkZl3TpgS8bVBLZN+2jjGgg38epgxb2zmoGtSfvgMw==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/d3-selection": "*"
-      }
-    },
-    "node_modules/@types/d3-brush": {
-      "version": "3.0.6",
-      "resolved": "https://registry.npmjs.org/@types/d3-brush/-/d3-brush-3.0.6.tgz",
-      "integrity": "sha512-nH60IZNNxEcrh6L1ZSMNA28rj27ut/2ZmI3r96Zd+1jrZD++zD3LsMIjWlvg4AYrHn/Pqz4CF3veCxGjtbqt7A==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/d3-selection": "*"
-      }
-    },
-    "node_modules/@types/d3-chord": {
-      "version": "3.0.6",
-      "resolved": "https://registry.npmjs.org/@types/d3-chord/-/d3-chord-3.0.6.tgz",
-      "integrity": "sha512-LFYWWd8nwfwEmTZG9PfQxd17HbNPksHBiJHaKuY1XeqscXacsS2tyoo6OdRsjf+NQYeB6XrNL3a25E3gH69lcg==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-color": {
-      "version": "3.1.3",
-      "resolved": "https://registry.npmjs.org/@types/d3-color/-/d3-color-3.1.3.tgz",
-      "integrity": "sha512-iO90scth9WAbmgv7ogoq57O9YpKmFBbmoEoCHDB2xMBY0+/KVrqAaCDyCE16dUspeOvIxFFRI+0sEtqDqy2b4A==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-contour": {
-      "version": "3.0.6",
-      "resolved": "https://registry.npmjs.org/@types/d3-contour/-/d3-contour-3.0.6.tgz",
-      "integrity": "sha512-BjzLgXGnCWjUSYGfH1cpdo41/hgdWETu4YxpezoztawmqsvCeep+8QGfiY6YbDvfgHz/DkjeIkkZVJavB4a3rg==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/d3-array": "*",
-        "@types/geojson": "*"
-      }
-    },
-    "node_modules/@types/d3-delaunay": {
-      "version": "6.0.4",
-      "resolved": "https://registry.npmjs.org/@types/d3-delaunay/-/d3-delaunay-6.0.4.tgz",
-      "integrity": "sha512-ZMaSKu4THYCU6sV64Lhg6qjf1orxBthaC161plr5KuPHo3CNm8DTHiLw/5Eq2b6TsNP0W0iJrUOFscY6Q450Hw==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-dispatch": {
-      "version": "3.0.7",
-      "resolved": "https://registry.npmjs.org/@types/d3-dispatch/-/d3-dispatch-3.0.7.tgz",
-      "integrity": "sha512-5o9OIAdKkhN1QItV2oqaE5KMIiXAvDWBDPrD85e58Qlz1c1kI/J0NcqbEG88CoTwJrYe7ntUCVfeUl2UJKbWgA==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-drag": {
-      "version": "3.0.7",
-      "resolved": "https://registry.npmjs.org/@types/d3-drag/-/d3-drag-3.0.7.tgz",
-      "integrity": "sha512-HE3jVKlzU9AaMazNufooRJ5ZpWmLIoc90A37WU2JMmeq28w1FQqCZswHZ3xR+SuxYftzHq6WU6KJHvqxKzTxxQ==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/d3-selection": "*"
-      }
-    },
-    "node_modules/@types/d3-dsv": {
-      "version": "3.0.7",
-      "resolved": "https://registry.npmjs.org/@types/d3-dsv/-/d3-dsv-3.0.7.tgz",
-      "integrity": "sha512-n6QBF9/+XASqcKK6waudgL0pf/S5XHPPI8APyMLLUHd8NqouBGLsU8MgtO7NINGtPBtk9Kko/W4ea0oAspwh9g==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-ease": {
-      "version": "3.0.2",
-      "resolved": "https://registry.npmjs.org/@types/d3-ease/-/d3-ease-3.0.2.tgz",
-      "integrity": "sha512-NcV1JjO5oDzoK26oMzbILE6HW7uVXOHLQvHshBUW4UMdZGfiY6v5BeQwh9a9tCzv+CeefZQHJt5SRgK154RtiA==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-fetch": {
-      "version": "3.0.7",
-      "resolved": "https://registry.npmjs.org/@types/d3-fetch/-/d3-fetch-3.0.7.tgz",
-      "integrity": "sha512-fTAfNmxSb9SOWNB9IoG5c8Hg6R+AzUHDRlsXsDZsNp6sxAEOP0tkP3gKkNSO/qmHPoBFTxNrjDprVHDQDvo5aA==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/d3-dsv": "*"
-      }
-    },
-    "node_modules/@types/d3-force": {
-      "version": "3.0.10",
-      "resolved": "https://registry.npmjs.org/@types/d3-force/-/d3-force-3.0.10.tgz",
-      "integrity": "sha512-ZYeSaCF3p73RdOKcjj+swRlZfnYpK1EbaDiYICEEp5Q6sUiqFaFQ9qgoshp5CzIyyb/yD09kD9o2zEltCexlgw==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-format": {
-      "version": "3.0.4",
-      "resolved": "https://registry.npmjs.org/@types/d3-format/-/d3-format-3.0.4.tgz",
-      "integrity": "sha512-fALi2aI6shfg7vM5KiR1wNJnZ7r6UuggVqtDA+xiEdPZQwy/trcQaHnwShLuLdta2rTymCNpxYTiMZX/e09F4g==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-geo": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/@types/d3-geo/-/d3-geo-3.1.0.tgz",
-      "integrity": "sha512-856sckF0oP/diXtS4jNsiQw/UuK5fQG8l/a9VVLeSouf1/PPbBE1i1W852zVwKwYCBkFJJB7nCFTbk6UMEXBOQ==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/geojson": "*"
-      }
-    },
-    "node_modules/@types/d3-hierarchy": {
-      "version": "3.1.7",
-      "resolved": "https://registry.npmjs.org/@types/d3-hierarchy/-/d3-hierarchy-3.1.7.tgz",
-      "integrity": "sha512-tJFtNoYBtRtkNysX1Xq4sxtjK8YgoWUNpIiUee0/jHGRwqvzYxkq0hGVbbOGSz+JgFxxRu4K8nb3YpG3CMARtg==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-interpolate": {
-      "version": "3.0.4",
-      "resolved": "https://registry.npmjs.org/@types/d3-interpolate/-/d3-interpolate-3.0.4.tgz",
-      "integrity": "sha512-mgLPETlrpVV1YRJIglr4Ez47g7Yxjl1lj7YKsiMCb27VJH9W8NVM6Bb9d8kkpG/uAQS5AmbA48q2IAolKKo1MA==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/d3-color": "*"
-      }
-    },
-    "node_modules/@types/d3-path": {
-      "version": "3.1.1",
-      "resolved": "https://registry.npmjs.org/@types/d3-path/-/d3-path-3.1.1.tgz",
-      "integrity": "sha512-VMZBYyQvbGmWyWVea0EHs/BwLgxc+MKi1zLDCONksozI4YJMcTt8ZEuIR4Sb1MMTE8MMW49v0IwI5+b7RmfWlg==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-polygon": {
-      "version": "3.0.2",
-      "resolved": "https://registry.npmjs.org/@types/d3-polygon/-/d3-polygon-3.0.2.tgz",
-      "integrity": "sha512-ZuWOtMaHCkN9xoeEMr1ubW2nGWsp4nIql+OPQRstu4ypeZ+zk3YKqQT0CXVe/PYqrKpZAi+J9mTs05TKwjXSRA==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-quadtree": {
-      "version": "3.0.6",
-      "resolved": "https://registry.npmjs.org/@types/d3-quadtree/-/d3-quadtree-3.0.6.tgz",
-      "integrity": "sha512-oUzyO1/Zm6rsxKRHA1vH0NEDG58HrT5icx/azi9MF1TWdtttWl0UIUsjEQBBh+SIkrpd21ZjEv7ptxWys1ncsg==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-random": {
-      "version": "3.0.3",
-      "resolved": "https://registry.npmjs.org/@types/d3-random/-/d3-random-3.0.3.tgz",
-      "integrity": "sha512-Imagg1vJ3y76Y2ea0871wpabqp613+8/r0mCLEBfdtqC7xMSfj9idOnmBYyMoULfHePJyxMAw3nWhJxzc+LFwQ==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-scale": {
-      "version": "4.0.9",
-      "resolved": "https://registry.npmjs.org/@types/d3-scale/-/d3-scale-4.0.9.tgz",
-      "integrity": "sha512-dLmtwB8zkAeO/juAMfnV+sItKjlsw2lKdZVVy6LRr0cBmegxSABiLEpGVmSJJ8O08i4+sGR6qQtb6WtuwJdvVw==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/d3-time": "*"
-      }
-    },
-    "node_modules/@types/d3-scale-chromatic": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/@types/d3-scale-chromatic/-/d3-scale-chromatic-3.1.0.tgz",
-      "integrity": "sha512-iWMJgwkK7yTRmWqRB5plb1kadXyQ5Sj8V/zYlFGMUBbIPKQScw+Dku9cAAMgJG+z5GYDoMjWGLVOvjghDEFnKQ==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-selection": {
-      "version": "3.0.11",
-      "resolved": "https://registry.npmjs.org/@types/d3-selection/-/d3-selection-3.0.11.tgz",
-      "integrity": "sha512-bhAXu23DJWsrI45xafYpkQ4NtcKMwWnAC/vKrd2l+nxMFuvOT3XMYTIj2opv8vq8AO5Yh7Qac/nSeP/3zjTK0w==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-shape": {
-      "version": "3.1.7",
-      "resolved": "https://registry.npmjs.org/@types/d3-shape/-/d3-shape-3.1.7.tgz",
-      "integrity": "sha512-VLvUQ33C+3J+8p+Daf+nYSOsjB4GXp19/S/aGo60m9h1v6XaxjiT82lKVWJCfzhtuZ3yD7i/TPeC/fuKLLOSmg==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/d3-path": "*"
-      }
-    },
-    "node_modules/@types/d3-time": {
-      "version": "3.0.4",
-      "resolved": "https://registry.npmjs.org/@types/d3-time/-/d3-time-3.0.4.tgz",
-      "integrity": "sha512-yuzZug1nkAAaBlBBikKZTgzCeA+k1uy4ZFwWANOfKw5z5LRhV0gNA7gNkKm7HoK+HRN0wX3EkxGk0fpbWhmB7g==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-time-format": {
-      "version": "4.0.3",
-      "resolved": "https://registry.npmjs.org/@types/d3-time-format/-/d3-time-format-4.0.3.tgz",
-      "integrity": "sha512-5xg9rC+wWL8kdDj153qZcsJ0FWiFt0J5RB6LYUNZjwSnesfblqrI/bJ1wBdJ8OQfncgbJG5+2F+qfqnqyzYxyg==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-timer": {
-      "version": "3.0.2",
-      "resolved": "https://registry.npmjs.org/@types/d3-timer/-/d3-timer-3.0.2.tgz",
-      "integrity": "sha512-Ps3T8E8dZDam6fUyNiMkekK3XUsaUEik+idO9/YjPtfj2qruF8tFBXS7XhtE4iIXBLxhmLjP3SXpLhVf21I9Lw==",
-      "license": "MIT"
-    },
-    "node_modules/@types/d3-transition": {
-      "version": "3.0.9",
-      "resolved": "https://registry.npmjs.org/@types/d3-transition/-/d3-transition-3.0.9.tgz",
-      "integrity": "sha512-uZS5shfxzO3rGlu0cC3bjmMFKsXv+SmZZcgp0KD22ts4uGXp5EVYGzu/0YdwZeKmddhcAccYtREJKkPfXkZuCg==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/d3-selection": "*"
-      }
-    },
-    "node_modules/@types/d3-zoom": {
-      "version": "3.0.8",
-      "resolved": "https://registry.npmjs.org/@types/d3-zoom/-/d3-zoom-3.0.8.tgz",
-      "integrity": "sha512-iqMC4/YlFCSlO8+2Ii1GGGliCAY4XdeG748w5vQUbevlbDu0zSjH/+jojorQVBK/se0j6DUFNPBGSqD3YWYnDw==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/d3-interpolate": "*",
-        "@types/d3-selection": "*"
-      }
-    },
-    "node_modules/@types/estree": {
-      "version": "1.0.8",
-      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
-      "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/@types/geojson": {
-      "version": "7946.0.16",
-      "resolved": "https://registry.npmjs.org/@types/geojson/-/geojson-7946.0.16.tgz",
-      "integrity": "sha512-6C8nqWur3j98U6+lXDfTUWIfgvZU+EumvpHKcYjujKH7woYyLj2sUmff0tRhrqM7BohUw7Pz3ZB1jj2gW9Fvmg==",
-      "license": "MIT"
-    },
-    "node_modules/@types/hast": {
-      "version": "3.0.4",
-      "resolved": "https://registry.npmjs.org/@types/hast/-/hast-3.0.4.tgz",
-      "integrity": "sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/unist": "*"
-      }
-    },
-    "node_modules/@types/mdast": {
-      "version": "4.0.4",
-      "resolved": "https://registry.npmjs.org/@types/mdast/-/mdast-4.0.4.tgz",
-      "integrity": "sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/unist": "*"
-      }
-    },
-    "node_modules/@types/prismjs": {
-      "version": "1.26.5",
-      "resolved": "https://registry.npmjs.org/@types/prismjs/-/prismjs-1.26.5.tgz",
-      "integrity": "sha512-AUZTa7hQ2KY5L7AmtSiqxlhWxb4ina0yd8hNbl4TWuqnv/pFP0nDMb3YrfSBf4hJVGLh2YEIBfKaBW/9UEl6IQ==",
-      "license": "MIT"
-    },
-    "node_modules/@types/react": {
-      "version": "19.2.6",
-      "resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.6.tgz",
-      "integrity": "sha512-p/jUvulfgU7oKtj6Xpk8cA2Y1xKTtICGpJYeJXz2YVO2UcvjQgeRMLDGfDeqeRW2Ta+0QNFwcc8X3GH8SxZz6w==",
-      "license": "MIT",
-      "dependencies": {
-        "csstype": "^3.2.2"
-      }
-    },
-    "node_modules/@types/react-dom": {
-      "version": "19.2.3",
-      "resolved": "https://registry.npmjs.org/@types/react-dom/-/react-dom-19.2.3.tgz",
-      "integrity": "sha512-jp2L/eY6fn+KgVVQAOqYItbF0VY/YApe5Mz2F0aykSO8gx31bYCZyvSeYxCHKvzHG5eZjc+zyaS5BrBWya2+kQ==",
-      "dev": true,
-      "license": "MIT",
-      "peerDependencies": {
-        "@types/react": "^19.2.0"
-      }
-    },
-    "node_modules/@types/react-syntax-highlighter": {
-      "version": "15.5.13",
-      "resolved": "https://registry.npmjs.org/@types/react-syntax-highlighter/-/react-syntax-highlighter-15.5.13.tgz",
-      "integrity": "sha512-uLGJ87j6Sz8UaBAooU0T6lWJ0dBmjZgN1PZTrj05TNql2/XpC6+4HhMT5syIdFUUt+FASfCeLLv4kBygNU+8qA==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/react": "*"
-      }
-    },
-    "node_modules/@types/trusted-types": {
-      "version": "2.0.7",
-      "resolved": "https://registry.npmjs.org/@types/trusted-types/-/trusted-types-2.0.7.tgz",
-      "integrity": "sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw==",
-      "license": "MIT",
-      "optional": true
-    },
-    "node_modules/@types/unist": {
-      "version": "3.0.3",
-      "resolved": "https://registry.npmjs.org/@types/unist/-/unist-3.0.3.tgz",
-      "integrity": "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==",
-      "license": "MIT"
-    },
-    "node_modules/@ungap/structured-clone": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@ungap/structured-clone/-/structured-clone-1.3.0.tgz",
-      "integrity": "sha512-WmoN8qaIAo7WTYWbAZuG8PYEhn5fkz7dZrqTBZ7dtt//lL2Gwms1IcnQ5yHqjDfX8Ft5j4YzDM23f87zBfDe9g==",
-      "license": "ISC"
-    },
-    "node_modules/@vitejs/plugin-react": {
-      "version": "5.1.1",
-      "resolved": "https://registry.npmjs.org/@vitejs/plugin-react/-/plugin-react-5.1.1.tgz",
-      "integrity": "sha512-WQfkSw0QbQ5aJ2CHYw23ZGkqnRwqKHD/KYsMeTkZzPT4Jcf0DcBxBtwMJxnu6E7oxw5+JC6ZAiePgh28uJ1HBA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@babel/core": "^7.28.5",
-        "@babel/plugin-transform-react-jsx-self": "^7.27.1",
-        "@babel/plugin-transform-react-jsx-source": "^7.27.1",
-        "@rolldown/pluginutils": "1.0.0-beta.47",
-        "@types/babel__core": "^7.20.5",
-        "react-refresh": "^0.18.0"
-      },
-      "engines": {
-        "node": "^20.19.0 || >=22.12.0"
-      },
-      "peerDependencies": {
-        "vite": "^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0"
-      }
-    },
-    "node_modules/acorn": {
-      "version": "8.15.0",
-      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz",
-      "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
-      "license": "MIT",
-      "bin": {
-        "acorn": "bin/acorn"
-      },
-      "engines": {
-        "node": ">=0.4.0"
-      }
-    },
-    "node_modules/any-promise": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/any-promise/-/any-promise-1.3.0.tgz",
-      "integrity": "sha512-7UvmKalWRt1wgjL1RrGxoSJW/0QZFIegpeGvZG9kjp8vrRu55XTHbwnqq2GpXm9uLbcuhxm3IqX9OB4MZR1b2A==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/anymatch": {
-      "version": "3.1.3",
-      "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz",
-      "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==",
-      "dev": true,
-      "license": "ISC",
-      "dependencies": {
-        "normalize-path": "^3.0.0",
-        "picomatch": "^2.0.4"
-      },
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/anymatch/node_modules/picomatch": {
-      "version": "2.3.1",
-      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
-      "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8.6"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/jonschlinkert"
-      }
-    },
-    "node_modules/arg": {
-      "version": "5.0.2",
-      "resolved": "https://registry.npmjs.org/arg/-/arg-5.0.2.tgz",
-      "integrity": "sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/argparse": {
-      "version": "1.0.10",
-      "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
-      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
-      "license": "MIT",
-      "dependencies": {
-        "sprintf-js": "~1.0.2"
-      }
-    },
-    "node_modules/autoprefixer": {
-      "version": "10.4.22",
-      "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.22.tgz",
-      "integrity": "sha512-ARe0v/t9gO28Bznv6GgqARmVqcWOV3mfgUPn9becPHMiD3o9BwlRgaeccZnwTpZ7Zwqrm+c1sUSsMxIzQzc8Xg==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/postcss/"
-        },
-        {
-          "type": "tidelift",
-          "url": "https://tidelift.com/funding/github/npm/autoprefixer"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "browserslist": "^4.27.0",
-        "caniuse-lite": "^1.0.30001754",
-        "fraction.js": "^5.3.4",
-        "normalize-range": "^0.1.2",
-        "picocolors": "^1.1.1",
-        "postcss-value-parser": "^4.2.0"
-      },
-      "bin": {
-        "autoprefixer": "bin/autoprefixer"
-      },
-      "engines": {
-        "node": "^10 || ^12 || >=14"
-      },
-      "peerDependencies": {
-        "postcss": "^8.1.0"
-      }
-    },
-    "node_modules/base64-js": {
-      "version": "1.5.1",
-      "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
-      "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "MIT"
-    },
-    "node_modules/baseline-browser-mapping": {
-      "version": "2.8.30",
-      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.8.30.tgz",
-      "integrity": "sha512-aTUKW4ptQhS64+v2d6IkPzymEzzhw+G0bA1g3uBRV3+ntkH+svttKseW5IOR4Ed6NUVKqnY7qT3dKvzQ7io4AA==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "bin": {
-        "baseline-browser-mapping": "dist/cli.js"
-      }
-    },
-    "node_modules/binary-extensions": {
-      "version": "2.3.0",
-      "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz",
-      "integrity": "sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/braces": {
-      "version": "3.0.3",
-      "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
-      "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "fill-range": "^7.1.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/browserslist": {
-      "version": "4.28.0",
-      "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.0.tgz",
-      "integrity": "sha512-tbydkR/CxfMwelN0vwdP/pLkDwyAASZ+VfWm4EOwlB6SWhx1sYnWLqo8N5j0rAzPfzfRaxt0mM/4wPU/Su84RQ==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/browserslist"
-        },
-        {
-          "type": "tidelift",
-          "url": "https://tidelift.com/funding/github/npm/browserslist"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "baseline-browser-mapping": "^2.8.25",
-        "caniuse-lite": "^1.0.30001754",
-        "electron-to-chromium": "^1.5.249",
-        "node-releases": "^2.0.27",
-        "update-browserslist-db": "^1.1.4"
-      },
-      "bin": {
-        "browserslist": "cli.js"
-      },
-      "engines": {
-        "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
-      }
-    },
-    "node_modules/buffer": {
-      "version": "6.0.3",
-      "resolved": "https://registry.npmjs.org/buffer/-/buffer-6.0.3.tgz",
-      "integrity": "sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA==",
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "base64-js": "^1.3.1",
-        "ieee754": "^1.2.1"
-      }
-    },
-    "node_modules/camelcase-css": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/camelcase-css/-/camelcase-css-2.0.1.tgz",
-      "integrity": "sha512-QOSvevhslijgYwRx6Rv7zKdMF8lbRmx+uQGx2+vDc+KI/eBnsy9kit5aj23AgGu3pa4t9AgwbnXWqS+iOY+2aA==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 6"
-      }
-    },
-    "node_modules/caniuse-lite": {
-      "version": "1.0.30001756",
-      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001756.tgz",
-      "integrity": "sha512-4HnCNKbMLkLdhJz3TToeVWHSnfJvPaq6vu/eRP0Ahub/07n484XHhBF5AJoSGHdVrS8tKFauUQz8Bp9P7LVx7A==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/browserslist"
-        },
-        {
-          "type": "tidelift",
-          "url": "https://tidelift.com/funding/github/npm/caniuse-lite"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ],
-      "license": "CC-BY-4.0"
-    },
-    "node_modules/character-entities": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/character-entities/-/character-entities-2.0.2.tgz",
-      "integrity": "sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==",
-      "license": "MIT",
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/character-entities-legacy": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/character-entities-legacy/-/character-entities-legacy-3.0.0.tgz",
-      "integrity": "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==",
-      "license": "MIT",
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/character-reference-invalid": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/character-reference-invalid/-/character-reference-invalid-2.0.1.tgz",
-      "integrity": "sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==",
-      "license": "MIT",
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/chevrotain": {
-      "version": "11.0.3",
-      "resolved": "https://registry.npmjs.org/chevrotain/-/chevrotain-11.0.3.tgz",
-      "integrity": "sha512-ci2iJH6LeIkvP9eJW6gpueU8cnZhv85ELY8w8WiFtNjMHA5ad6pQLaJo9mEly/9qUyCpvqX8/POVUTf18/HFdw==",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "@chevrotain/cst-dts-gen": "11.0.3",
-        "@chevrotain/gast": "11.0.3",
-        "@chevrotain/regexp-to-ast": "11.0.3",
-        "@chevrotain/types": "11.0.3",
-        "@chevrotain/utils": "11.0.3",
-        "lodash-es": "4.17.21"
-      }
-    },
-    "node_modules/chevrotain-allstar": {
-      "version": "0.3.1",
-      "resolved": "https://registry.npmjs.org/chevrotain-allstar/-/chevrotain-allstar-0.3.1.tgz",
-      "integrity": "sha512-b7g+y9A0v4mxCW1qUhf3BSVPg+/NvGErk/dOkrDaHA0nQIQGAtrOjlX//9OQtRlSCy+x9rfB5N8yC71lH1nvMw==",
-      "license": "MIT",
-      "dependencies": {
-        "lodash-es": "^4.17.21"
-      },
-      "peerDependencies": {
-        "chevrotain": "^11.0.0"
-      }
-    },
-    "node_modules/chokidar": {
-      "version": "3.6.0",
-      "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.6.0.tgz",
-      "integrity": "sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "anymatch": "~3.1.2",
-        "braces": "~3.0.2",
-        "glob-parent": "~5.1.2",
-        "is-binary-path": "~2.1.0",
-        "is-glob": "~4.0.1",
-        "normalize-path": "~3.0.0",
-        "readdirp": "~3.6.0"
-      },
-      "engines": {
-        "node": ">= 8.10.0"
-      },
-      "funding": {
-        "url": "https://paulmillr.com/funding/"
-      },
-      "optionalDependencies": {
-        "fsevents": "~2.3.2"
-      }
-    },
-    "node_modules/chokidar/node_modules/glob-parent": {
-      "version": "5.1.2",
-      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz",
-      "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==",
-      "dev": true,
-      "license": "ISC",
-      "dependencies": {
-        "is-glob": "^4.0.1"
-      },
-      "engines": {
-        "node": ">= 6"
-      }
-    },
-    "node_modules/clsx": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/clsx/-/clsx-2.1.1.tgz",
-      "integrity": "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/comma-separated-tokens": {
-      "version": "2.0.3",
-      "resolved": "https://registry.npmjs.org/comma-separated-tokens/-/comma-separated-tokens-2.0.3.tgz",
-      "integrity": "sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==",
-      "license": "MIT",
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/commander": {
-      "version": "4.1.1",
-      "resolved": "https://registry.npmjs.org/commander/-/commander-4.1.1.tgz",
-      "integrity": "sha512-NOKm8xhkzAjzFx8B2v5OAHT+u5pRQc2UCa2Vq9jYL/31o2wi9mxBA7LIFs3sV5VSC49z6pEhfbMULvShKj26WA==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 6"
-      }
-    },
-    "node_modules/confbox": {
-      "version": "0.2.2",
-      "resolved": "https://registry.npmjs.org/confbox/-/confbox-0.2.2.tgz",
-      "integrity": "sha512-1NB+BKqhtNipMsov4xI/NnhCKp9XG9NamYp5PVm9klAT0fsrNPjaFICsCFhNhwZJKNh7zB/3q8qXz0E9oaMNtQ==",
-      "license": "MIT"
-    },
-    "node_modules/convert-source-map": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz",
-      "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/cookie": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/cookie/-/cookie-1.0.2.tgz",
-      "integrity": "sha512-9Kr/j4O16ISv8zBBhJoi4bXOYNTkFLOqSL3UDB0njXxCXNezjeyVrJyGOWtgfs/q2km1gwBcfH8q1yEGoMYunA==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/cose-base": {
-      "version": "1.0.3",
-      "resolved": "https://registry.npmjs.org/cose-base/-/cose-base-1.0.3.tgz",
-      "integrity": "sha512-s9whTXInMSgAp/NVXVNuVxVKzGH2qck3aQlVHxDCdAEPgtMKwc4Wq6/QKhgdEdgbLSi9rBTAcPoRa6JpiG4ksg==",
-      "license": "MIT",
-      "dependencies": {
-        "layout-base": "^1.0.0"
-      }
-    },
-    "node_modules/cssesc": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/cssesc/-/cssesc-3.0.0.tgz",
-      "integrity": "sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==",
-      "dev": true,
-      "license": "MIT",
-      "bin": {
-        "cssesc": "bin/cssesc"
-      },
-      "engines": {
-        "node": ">=4"
-      }
-    },
-    "node_modules/csstype": {
-      "version": "3.2.3",
-      "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
-      "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==",
-      "license": "MIT"
-    },
-    "node_modules/cytoscape": {
-      "version": "3.33.1",
-      "resolved": "https://registry.npmjs.org/cytoscape/-/cytoscape-3.33.1.tgz",
-      "integrity": "sha512-iJc4TwyANnOGR1OmWhsS9ayRS3s+XQ185FmuHObThD+5AeJCakAAbWv8KimMTt08xCCLNgneQwFp+JRJOr9qGQ==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10"
-      }
-    },
-    "node_modules/cytoscape-cose-bilkent": {
-      "version": "4.1.0",
-      "resolved": "https://registry.npmjs.org/cytoscape-cose-bilkent/-/cytoscape-cose-bilkent-4.1.0.tgz",
-      "integrity": "sha512-wgQlVIUJF13Quxiv5e1gstZ08rnZj2XaLHGoFMYXz7SkNfCDOOteKBE6SYRfA9WxxI/iBc3ajfDoc6hb/MRAHQ==",
-      "license": "MIT",
-      "dependencies": {
-        "cose-base": "^1.0.0"
-      },
-      "peerDependencies": {
-        "cytoscape": "^3.2.0"
-      }
-    },
-    "node_modules/cytoscape-fcose": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/cytoscape-fcose/-/cytoscape-fcose-2.2.0.tgz",
-      "integrity": "sha512-ki1/VuRIHFCzxWNrsshHYPs6L7TvLu3DL+TyIGEsRcvVERmxokbf5Gdk7mFxZnTdiGtnA4cfSmjZJMviqSuZrQ==",
-      "license": "MIT",
-      "dependencies": {
-        "cose-base": "^2.2.0"
-      },
-      "peerDependencies": {
-        "cytoscape": "^3.2.0"
-      }
-    },
-    "node_modules/cytoscape-fcose/node_modules/cose-base": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/cose-base/-/cose-base-2.2.0.tgz",
-      "integrity": "sha512-AzlgcsCbUMymkADOJtQm3wO9S3ltPfYOFD5033keQn9NJzIbtnZj+UdBJe7DYml/8TdbtHJW3j58SOnKhWY/5g==",
-      "license": "MIT",
-      "dependencies": {
-        "layout-base": "^2.0.0"
-      }
-    },
-    "node_modules/cytoscape-fcose/node_modules/layout-base": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/layout-base/-/layout-base-2.0.1.tgz",
-      "integrity": "sha512-dp3s92+uNI1hWIpPGH3jK2kxE2lMjdXdr+DH8ynZHpd6PUlH6x6cbuXnoMmiNumznqaNO31xu9e79F0uuZ0JFg==",
-      "license": "MIT"
-    },
-    "node_modules/d3": {
-      "version": "7.9.0",
-      "resolved": "https://registry.npmjs.org/d3/-/d3-7.9.0.tgz",
-      "integrity": "sha512-e1U46jVP+w7Iut8Jt8ri1YsPOvFpg46k+K8TpCb0P+zjCkjkPnV7WzfDJzMHy1LnA+wj5pLT1wjO901gLXeEhA==",
-      "license": "ISC",
-      "dependencies": {
-        "d3-array": "3",
-        "d3-axis": "3",
-        "d3-brush": "3",
-        "d3-chord": "3",
-        "d3-color": "3",
-        "d3-contour": "4",
-        "d3-delaunay": "6",
-        "d3-dispatch": "3",
-        "d3-drag": "3",
-        "d3-dsv": "3",
-        "d3-ease": "3",
-        "d3-fetch": "3",
-        "d3-force": "3",
-        "d3-format": "3",
-        "d3-geo": "3",
-        "d3-hierarchy": "3",
-        "d3-interpolate": "3",
-        "d3-path": "3",
-        "d3-polygon": "3",
-        "d3-quadtree": "3",
-        "d3-random": "3",
-        "d3-scale": "4",
-        "d3-scale-chromatic": "3",
-        "d3-selection": "3",
-        "d3-shape": "3",
-        "d3-time": "3",
-        "d3-time-format": "4",
-        "d3-timer": "3",
-        "d3-transition": "3",
-        "d3-zoom": "3"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-array": {
-      "version": "3.2.4",
-      "resolved": "https://registry.npmjs.org/d3-array/-/d3-array-3.2.4.tgz",
-      "integrity": "sha512-tdQAmyA18i4J7wprpYq8ClcxZy3SC31QMeByyCFyRt7BVHdREQZ5lpzoe5mFEYZUWe+oq8HBvk9JjpibyEV4Jg==",
-      "license": "ISC",
-      "dependencies": {
-        "internmap": "1 - 2"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-axis": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/d3-axis/-/d3-axis-3.0.0.tgz",
-      "integrity": "sha512-IH5tgjV4jE/GhHkRV0HiVYPDtvfjHQlQfJHs0usq7M30XcSBvOotpmH1IgkcXsO/5gEQZD43B//fc7SRT5S+xw==",
-      "license": "ISC",
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-brush": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/d3-brush/-/d3-brush-3.0.0.tgz",
-      "integrity": "sha512-ALnjWlVYkXsVIGlOsuWH1+3udkYFI48Ljihfnh8FZPF2QS9o+PzGLBslO0PjzVoHLZ2KCVgAM8NVkXPJB2aNnQ==",
-      "license": "ISC",
-      "dependencies": {
-        "d3-dispatch": "1 - 3",
-        "d3-drag": "2 - 3",
-        "d3-interpolate": "1 - 3",
-        "d3-selection": "3",
-        "d3-transition": "3"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-chord": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/d3-chord/-/d3-chord-3.0.1.tgz",
-      "integrity": "sha512-VE5S6TNa+j8msksl7HwjxMHDM2yNK3XCkusIlpX5kwauBfXuyLAtNg9jCp/iHH61tgI4sb6R/EIMWCqEIdjT/g==",
-      "license": "ISC",
-      "dependencies": {
-        "d3-path": "1 - 3"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-color": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/d3-color/-/d3-color-3.1.0.tgz",
-      "integrity": "sha512-zg/chbXyeBtMQ1LbD/WSoW2DpC3I0mpmPdW+ynRTj/x2DAWYrIY7qeZIHidozwV24m4iavr15lNwIwLxRmOxhA==",
-      "license": "ISC",
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-contour": {
-      "version": "4.0.2",
-      "resolved": "https://registry.npmjs.org/d3-contour/-/d3-contour-4.0.2.tgz",
-      "integrity": "sha512-4EzFTRIikzs47RGmdxbeUvLWtGedDUNkTcmzoeyg4sP/dvCexO47AaQL7VKy/gul85TOxw+IBgA8US2xwbToNA==",
-      "license": "ISC",
-      "dependencies": {
-        "d3-array": "^3.2.0"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-delaunay": {
-      "version": "6.0.4",
-      "resolved": "https://registry.npmjs.org/d3-delaunay/-/d3-delaunay-6.0.4.tgz",
-      "integrity": "sha512-mdjtIZ1XLAM8bm/hx3WwjfHt6Sggek7qH043O8KEjDXN40xi3vx/6pYSVTwLjEgiXQTbvaouWKynLBiUZ6SK6A==",
-      "license": "ISC",
-      "dependencies": {
-        "delaunator": "5"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-dispatch": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/d3-dispatch/-/d3-dispatch-3.0.1.tgz",
-      "integrity": "sha512-rzUyPU/S7rwUflMyLc1ETDeBj0NRuHKKAcvukozwhshr6g6c5d8zh4c2gQjY2bZ0dXeGLWc1PF174P2tVvKhfg==",
-      "license": "ISC",
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-drag": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/d3-drag/-/d3-drag-3.0.0.tgz",
-      "integrity": "sha512-pWbUJLdETVA8lQNJecMxoXfH6x+mO2UQo8rSmZ+QqxcbyA3hfeprFgIT//HW2nlHChWeIIMwS2Fq+gEARkhTkg==",
-      "license": "ISC",
-      "dependencies": {
-        "d3-dispatch": "1 - 3",
-        "d3-selection": "3"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-dsv": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/d3-dsv/-/d3-dsv-3.0.1.tgz",
-      "integrity": "sha512-UG6OvdI5afDIFP9w4G0mNq50dSOsXHJaRE8arAS5o9ApWnIElp8GZw1Dun8vP8OyHOZ/QJUKUJwxiiCCnUwm+Q==",
-      "license": "ISC",
-      "dependencies": {
-        "commander": "7",
-        "iconv-lite": "0.6",
-        "rw": "1"
-      },
-      "bin": {
-        "csv2json": "bin/dsv2json.js",
-        "csv2tsv": "bin/dsv2dsv.js",
-        "dsv2dsv": "bin/dsv2dsv.js",
-        "dsv2json": "bin/dsv2json.js",
-        "json2csv": "bin/json2dsv.js",
-        "json2dsv": "bin/json2dsv.js",
-        "json2tsv": "bin/json2dsv.js",
-        "tsv2csv": "bin/dsv2dsv.js",
-        "tsv2json": "bin/dsv2json.js"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-dsv/node_modules/commander": {
-      "version": "7.2.0",
-      "resolved": "https://registry.npmjs.org/commander/-/commander-7.2.0.tgz",
-      "integrity": "sha512-QrWXB+ZQSVPmIWIhtEO9H+gwHaMGYiF5ChvoJ+K9ZGHG/sVsa6yiesAD1GC/x46sET00Xlwo1u49RVVVzvcSkw==",
-      "license": "MIT",
-      "engines": {
-        "node": ">= 10"
-      }
-    },
-    "node_modules/d3-ease": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/d3-ease/-/d3-ease-3.0.1.tgz",
-      "integrity": "sha512-wR/XK3D3XcLIZwpbvQwQ5fK+8Ykds1ip7A2Txe0yxncXSdq1L9skcG7blcedkOX+ZcgxGAmLX1FrRGbADwzi0w==",
-      "license": "BSD-3-Clause",
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-fetch": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/d3-fetch/-/d3-fetch-3.0.1.tgz",
-      "integrity": "sha512-kpkQIM20n3oLVBKGg6oHrUchHM3xODkTzjMoj7aWQFq5QEM+R6E4WkzT5+tojDY7yjez8KgCBRoj4aEr99Fdqw==",
-      "license": "ISC",
-      "dependencies": {
-        "d3-dsv": "1 - 3"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-force": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/d3-force/-/d3-force-3.0.0.tgz",
-      "integrity": "sha512-zxV/SsA+U4yte8051P4ECydjD/S+qeYtnaIyAs9tgHCqfguma/aAQDjo85A9Z6EKhBirHRJHXIgJUlffT4wdLg==",
-      "license": "ISC",
-      "dependencies": {
-        "d3-dispatch": "1 - 3",
-        "d3-quadtree": "1 - 3",
-        "d3-timer": "1 - 3"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-format": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/d3-format/-/d3-format-3.1.0.tgz",
-      "integrity": "sha512-YyUI6AEuY/Wpt8KWLgZHsIU86atmikuoOmCfommt0LYHiQSPjvX2AcFc38PX0CBpr2RCyZhjex+NS/LPOv6YqA==",
-      "license": "ISC",
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-geo": {
-      "version": "3.1.1",
-      "resolved": "https://registry.npmjs.org/d3-geo/-/d3-geo-3.1.1.tgz",
-      "integrity": "sha512-637ln3gXKXOwhalDzinUgY83KzNWZRKbYubaG+fGVuc/dxO64RRljtCTnf5ecMyE1RIdtqpkVcq0IbtU2S8j2Q==",
-      "license": "ISC",
-      "dependencies": {
-        "d3-array": "2.5.0 - 3"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-hierarchy": {
-      "version": "3.1.2",
-      "resolved": "https://registry.npmjs.org/d3-hierarchy/-/d3-hierarchy-3.1.2.tgz",
-      "integrity": "sha512-FX/9frcub54beBdugHjDCdikxThEqjnR93Qt7PvQTOHxyiNCAlvMrHhclk3cD5VeAaq9fxmfRp+CnWw9rEMBuA==",
-      "license": "ISC",
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-interpolate": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/d3-interpolate/-/d3-interpolate-3.0.1.tgz",
-      "integrity": "sha512-3bYs1rOD33uo8aqJfKP3JWPAibgw8Zm2+L9vBKEHJ2Rg+viTR7o5Mmv5mZcieN+FRYaAOWX5SJATX6k1PWz72g==",
-      "license": "ISC",
-      "dependencies": {
-        "d3-color": "1 - 3"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-path": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/d3-path/-/d3-path-3.1.0.tgz",
-      "integrity": "sha512-p3KP5HCf/bvjBSSKuXid6Zqijx7wIfNW+J/maPs+iwR35at5JCbLUT0LzF1cnjbCHWhqzQTIN2Jpe8pRebIEFQ==",
-      "license": "ISC",
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-polygon": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/d3-polygon/-/d3-polygon-3.0.1.tgz",
-      "integrity": "sha512-3vbA7vXYwfe1SYhED++fPUQlWSYTTGmFmQiany/gdbiWgU/iEyQzyymwL9SkJjFFuCS4902BSzewVGsHHmHtXg==",
-      "license": "ISC",
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-quadtree": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/d3-quadtree/-/d3-quadtree-3.0.1.tgz",
-      "integrity": "sha512-04xDrxQTDTCFwP5H6hRhsRcb9xxv2RzkcsygFzmkSIOJy3PeRJP7sNk3VRIbKXcog561P9oU0/rVH6vDROAgUw==",
-      "license": "ISC",
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-random": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/d3-random/-/d3-random-3.0.1.tgz",
-      "integrity": "sha512-FXMe9GfxTxqd5D6jFsQ+DJ8BJS4E/fT5mqqdjovykEB2oFbTMDVdg1MGFxfQW+FBOGoB++k8swBrgwSHT1cUXQ==",
-      "license": "ISC",
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-sankey": {
-      "version": "0.12.3",
-      "resolved": "https://registry.npmjs.org/d3-sankey/-/d3-sankey-0.12.3.tgz",
-      "integrity": "sha512-nQhsBRmM19Ax5xEIPLMY9ZmJ/cDvd1BG3UVvt5h3WRxKg5zGRbvnteTyWAbzeSvlh3tW7ZEmq4VwR5mB3tutmQ==",
-      "license": "BSD-3-Clause",
-      "dependencies": {
-        "d3-array": "1 - 2",
-        "d3-shape": "^1.2.0"
-      }
-    },
-    "node_modules/d3-sankey/node_modules/d3-array": {
-      "version": "2.12.1",
-      "resolved": "https://registry.npmjs.org/d3-array/-/d3-array-2.12.1.tgz",
-      "integrity": "sha512-B0ErZK/66mHtEsR1TkPEEkwdy+WDesimkM5gpZr5Dsg54BiTA5RXtYW5qTLIAcekaS9xfZrzBLF/OAkB3Qn1YQ==",
-      "license": "BSD-3-Clause",
-      "dependencies": {
-        "internmap": "^1.0.0"
-      }
-    },
-    "node_modules/d3-sankey/node_modules/d3-path": {
-      "version": "1.0.9",
-      "resolved": "https://registry.npmjs.org/d3-path/-/d3-path-1.0.9.tgz",
-      "integrity": "sha512-VLaYcn81dtHVTjEHd8B+pbe9yHWpXKZUC87PzoFmsFrJqgFwDe/qxfp5MlfsfM1V5E/iVt0MmEbWQ7FVIXh/bg==",
-      "license": "BSD-3-Clause"
-    },
-    "node_modules/d3-sankey/node_modules/d3-shape": {
-      "version": "1.3.7",
-      "resolved": "https://registry.npmjs.org/d3-shape/-/d3-shape-1.3.7.tgz",
-      "integrity": "sha512-EUkvKjqPFUAZyOlhY5gzCxCeI0Aep04LwIRpsZ/mLFelJiUfnK56jo5JMDSE7yyP2kLSb6LtF+S5chMk7uqPqw==",
-      "license": "BSD-3-Clause",
-      "dependencies": {
-        "d3-path": "1"
-      }
-    },
-    "node_modules/d3-sankey/node_modules/internmap": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/internmap/-/internmap-1.0.1.tgz",
-      "integrity": "sha512-lDB5YccMydFBtasVtxnZ3MRBHuaoE8GKsppq+EchKL2U4nK/DmEpPHNH8MZe5HkMtpSiTSOZwfN0tzYjO/lJEw==",
-      "license": "ISC"
-    },
-    "node_modules/d3-scale": {
-      "version": "4.0.2",
-      "resolved": "https://registry.npmjs.org/d3-scale/-/d3-scale-4.0.2.tgz",
-      "integrity": "sha512-GZW464g1SH7ag3Y7hXjf8RoUuAFIqklOAq3MRl4OaWabTFJY9PN/E1YklhXLh+OQ3fM9yS2nOkCoS+WLZ6kvxQ==",
-      "license": "ISC",
-      "dependencies": {
-        "d3-array": "2.10.0 - 3",
-        "d3-format": "1 - 3",
-        "d3-interpolate": "1.2.0 - 3",
-        "d3-time": "2.1.1 - 3",
-        "d3-time-format": "2 - 4"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-scale-chromatic": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/d3-scale-chromatic/-/d3-scale-chromatic-3.1.0.tgz",
-      "integrity": "sha512-A3s5PWiZ9YCXFye1o246KoscMWqf8BsD9eRiJ3He7C9OBaxKhAd5TFCdEx/7VbKtxxTsu//1mMJFrEt572cEyQ==",
-      "license": "ISC",
-      "dependencies": {
-        "d3-color": "1 - 3",
-        "d3-interpolate": "1 - 3"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-selection": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/d3-selection/-/d3-selection-3.0.0.tgz",
-      "integrity": "sha512-fmTRWbNMmsmWq6xJV8D19U/gw/bwrHfNXxrIN+HfZgnzqTHp9jOmKMhsTUjXOJnZOdZY9Q28y4yebKzqDKlxlQ==",
-      "license": "ISC",
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-shape": {
-      "version": "3.2.0",
-      "resolved": "https://registry.npmjs.org/d3-shape/-/d3-shape-3.2.0.tgz",
-      "integrity": "sha512-SaLBuwGm3MOViRq2ABk3eLoxwZELpH6zhl3FbAoJ7Vm1gofKx6El1Ib5z23NUEhF9AsGl7y+dzLe5Cw2AArGTA==",
-      "license": "ISC",
-      "dependencies": {
-        "d3-path": "^3.1.0"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-time": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/d3-time/-/d3-time-3.1.0.tgz",
-      "integrity": "sha512-VqKjzBLejbSMT4IgbmVgDjpkYrNWUYJnbCGo874u7MMKIWsILRX+OpX/gTk8MqjpT1A/c6HY2dCA77ZN0lkQ2Q==",
-      "license": "ISC",
-      "dependencies": {
-        "d3-array": "2 - 3"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-time-format": {
-      "version": "4.1.0",
-      "resolved": "https://registry.npmjs.org/d3-time-format/-/d3-time-format-4.1.0.tgz",
-      "integrity": "sha512-dJxPBlzC7NugB2PDLwo9Q8JiTR3M3e4/XANkreKSUxF8vvXKqm1Yfq4Q5dl8budlunRVlUUaDUgFt7eA8D6NLg==",
-      "license": "ISC",
-      "dependencies": {
-        "d3-time": "1 - 3"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-timer": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/d3-timer/-/d3-timer-3.0.1.tgz",
-      "integrity": "sha512-ndfJ/JxxMd3nw31uyKoY2naivF+r29V+Lc0svZxe1JvvIRmi8hUsrMvdOwgS1o6uBHmiz91geQ0ylPP0aj1VUA==",
-      "license": "ISC",
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/d3-transition": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/d3-transition/-/d3-transition-3.0.1.tgz",
-      "integrity": "sha512-ApKvfjsSR6tg06xrL434C0WydLr7JewBB3V+/39RMHsaXTOG0zmt/OAXeng5M5LBm0ojmxJrpomQVZ1aPvBL4w==",
-      "license": "ISC",
-      "dependencies": {
-        "d3-color": "1 - 3",
-        "d3-dispatch": "1 - 3",
-        "d3-ease": "1 - 3",
-        "d3-interpolate": "1 - 3",
-        "d3-timer": "1 - 3"
-      },
-      "engines": {
-        "node": ">=12"
-      },
-      "peerDependencies": {
-        "d3-selection": "2 - 3"
-      }
-    },
-    "node_modules/d3-zoom": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/d3-zoom/-/d3-zoom-3.0.0.tgz",
-      "integrity": "sha512-b8AmV3kfQaqWAuacbPuNbL6vahnOJflOhexLzMMNLga62+/nh0JzvJ0aO/5a5MVgUFGS7Hu1P9P03o3fJkDCyw==",
-      "license": "ISC",
-      "dependencies": {
-        "d3-dispatch": "1 - 3",
-        "d3-drag": "2 - 3",
-        "d3-interpolate": "1 - 3",
-        "d3-selection": "2 - 3",
-        "d3-transition": "2 - 3"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/dagre-d3-es": {
-      "version": "7.0.13",
-      "resolved": "https://registry.npmjs.org/dagre-d3-es/-/dagre-d3-es-7.0.13.tgz",
-      "integrity": "sha512-efEhnxpSuwpYOKRm/L5KbqoZmNNukHa/Flty4Wp62JRvgH2ojwVgPgdYyr4twpieZnyRDdIH7PY2mopX26+j2Q==",
-      "license": "MIT",
-      "dependencies": {
-        "d3": "^7.9.0",
-        "lodash-es": "^4.17.21"
-      }
-    },
-    "node_modules/dayjs": {
-      "version": "1.11.19",
-      "resolved": "https://registry.npmjs.org/dayjs/-/dayjs-1.11.19.tgz",
-      "integrity": "sha512-t5EcLVS6QPBNqM2z8fakk/NKel+Xzshgt8FFKAn+qwlD1pzZWxh0nVCrvFK7ZDb6XucZeF9z8C7CBWTRIVApAw==",
-      "license": "MIT"
-    },
-    "node_modules/debug": {
-      "version": "4.4.3",
-      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
-      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
-      "license": "MIT",
-      "dependencies": {
-        "ms": "^2.1.3"
-      },
-      "engines": {
-        "node": ">=6.0"
-      },
-      "peerDependenciesMeta": {
-        "supports-color": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/decode-named-character-reference": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/decode-named-character-reference/-/decode-named-character-reference-1.2.0.tgz",
-      "integrity": "sha512-c6fcElNV6ShtZXmsgNgFFV5tVX2PaV4g+MOAkb8eXHvn6sryJBrZa9r0zV6+dtTyoCKxtDy5tyQ5ZwQuidtd+Q==",
-      "license": "MIT",
-      "dependencies": {
-        "character-entities": "^2.0.0"
-      },
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/delaunator": {
-      "version": "5.0.1",
-      "resolved": "https://registry.npmjs.org/delaunator/-/delaunator-5.0.1.tgz",
-      "integrity": "sha512-8nvh+XBe96aCESrGOqMp/84b13H9cdKbG5P2ejQCh4d4sK9RL4371qou9drQjMhvnPmhWl5hnmqbEE0fXr9Xnw==",
-      "license": "ISC",
-      "dependencies": {
-        "robust-predicates": "^3.0.2"
-      }
-    },
-    "node_modules/dequal": {
-      "version": "2.0.3",
-      "resolved": "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz",
-      "integrity": "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/devlop": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/devlop/-/devlop-1.1.0.tgz",
-      "integrity": "sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==",
-      "license": "MIT",
-      "dependencies": {
-        "dequal": "^2.0.0"
-      },
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/didyoumean": {
-      "version": "1.2.2",
-      "resolved": "https://registry.npmjs.org/didyoumean/-/didyoumean-1.2.2.tgz",
-      "integrity": "sha512-gxtyfqMg7GKyhQmb056K7M3xszy/myH8w+B4RT+QXBQsvAOdc3XymqDDPHx1BgPgsdAA5SIifona89YtRATDzw==",
-      "dev": true,
-      "license": "Apache-2.0"
-    },
-    "node_modules/dlv": {
-      "version": "1.1.3",
-      "resolved": "https://registry.npmjs.org/dlv/-/dlv-1.1.3.tgz",
-      "integrity": "sha512-+HlytyjlPKnIG8XuRG8WvmBP8xs8P71y+SKKS6ZXWoEgLuePxtDoUEiH7WkdePWrQ5JBpE6aoVqfZfJUQkjXwA==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/dompurify": {
-      "version": "3.3.0",
-      "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.3.0.tgz",
-      "integrity": "sha512-r+f6MYR1gGN1eJv0TVQbhA7if/U7P87cdPl3HN5rikqaBSBxLiCb/b9O+2eG0cxz0ghyU+mU1QkbsOwERMYlWQ==",
-      "license": "(MPL-2.0 OR Apache-2.0)",
-      "optionalDependencies": {
-        "@types/trusted-types": "^2.0.7"
-      }
-    },
-    "node_modules/electron-to-chromium": {
-      "version": "1.5.259",
-      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.259.tgz",
-      "integrity": "sha512-I+oLXgpEJzD6Cwuwt1gYjxsDmu/S/Kd41mmLA3O+/uH2pFRO/DvOjUyGozL8j3KeLV6WyZ7ssPwELMsXCcsJAQ==",
-      "dev": true,
-      "license": "ISC"
-    },
-    "node_modules/entities": {
-      "version": "6.0.1",
-      "resolved": "https://registry.npmjs.org/entities/-/entities-6.0.1.tgz",
-      "integrity": "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==",
-      "license": "BSD-2-Clause",
-      "engines": {
-        "node": ">=0.12"
-      },
-      "funding": {
-        "url": "https://github.com/fb55/entities?sponsor=1"
-      }
-    },
-    "node_modules/esbuild": {
-      "version": "0.25.12",
-      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.12.tgz",
-      "integrity": "sha512-bbPBYYrtZbkt6Os6FiTLCTFxvq4tt3JKall1vRwshA3fdVztsLAatFaZobhkBC8/BrPetoa0oksYoKXoG4ryJg==",
-      "dev": true,
-      "hasInstallScript": true,
-      "license": "MIT",
-      "bin": {
-        "esbuild": "bin/esbuild"
-      },
-      "engines": {
-        "node": ">=18"
-      },
-      "optionalDependencies": {
-        "@esbuild/aix-ppc64": "0.25.12",
-        "@esbuild/android-arm": "0.25.12",
-        "@esbuild/android-arm64": "0.25.12",
-        "@esbuild/android-x64": "0.25.12",
-        "@esbuild/darwin-arm64": "0.25.12",
-        "@esbuild/darwin-x64": "0.25.12",
-        "@esbuild/freebsd-arm64": "0.25.12",
-        "@esbuild/freebsd-x64": "0.25.12",
-        "@esbuild/linux-arm": "0.25.12",
-        "@esbuild/linux-arm64": "0.25.12",
-        "@esbuild/linux-ia32": "0.25.12",
-        "@esbuild/linux-loong64": "0.25.12",
-        "@esbuild/linux-mips64el": "0.25.12",
-        "@esbuild/linux-ppc64": "0.25.12",
-        "@esbuild/linux-riscv64": "0.25.12",
-        "@esbuild/linux-s390x": "0.25.12",
-        "@esbuild/linux-x64": "0.25.12",
-        "@esbuild/netbsd-arm64": "0.25.12",
-        "@esbuild/netbsd-x64": "0.25.12",
-        "@esbuild/openbsd-arm64": "0.25.12",
-        "@esbuild/openbsd-x64": "0.25.12",
-        "@esbuild/openharmony-arm64": "0.25.12",
-        "@esbuild/sunos-x64": "0.25.12",
-        "@esbuild/win32-arm64": "0.25.12",
-        "@esbuild/win32-ia32": "0.25.12",
-        "@esbuild/win32-x64": "0.25.12"
-      }
-    },
-    "node_modules/escalade": {
-      "version": "3.2.0",
-      "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
-      "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/esprima": {
-      "version": "4.0.1",
-      "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz",
-      "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==",
-      "license": "BSD-2-Clause",
-      "bin": {
-        "esparse": "bin/esparse.js",
-        "esvalidate": "bin/esvalidate.js"
-      },
-      "engines": {
-        "node": ">=4"
-      }
-    },
-    "node_modules/exsolve": {
-      "version": "1.0.8",
-      "resolved": "https://registry.npmjs.org/exsolve/-/exsolve-1.0.8.tgz",
-      "integrity": "sha512-LmDxfWXwcTArk8fUEnOfSZpHOJ6zOMUJKOtFLFqJLoKJetuQG874Uc7/Kki7zFLzYybmZhp1M7+98pfMqeX8yA==",
-      "license": "MIT"
-    },
-    "node_modules/extend-shallow": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
-      "integrity": "sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug==",
-      "license": "MIT",
-      "dependencies": {
-        "is-extendable": "^0.1.0"
-      },
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/fast-glob": {
-      "version": "3.3.3",
-      "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz",
-      "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@nodelib/fs.stat": "^2.0.2",
-        "@nodelib/fs.walk": "^1.2.3",
-        "glob-parent": "^5.1.2",
-        "merge2": "^1.3.0",
-        "micromatch": "^4.0.8"
-      },
-      "engines": {
-        "node": ">=8.6.0"
-      }
-    },
-    "node_modules/fast-glob/node_modules/glob-parent": {
-      "version": "5.1.2",
-      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz",
-      "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==",
-      "dev": true,
-      "license": "ISC",
-      "dependencies": {
-        "is-glob": "^4.0.1"
-      },
-      "engines": {
-        "node": ">= 6"
-      }
-    },
-    "node_modules/fastq": {
-      "version": "1.19.1",
-      "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.19.1.tgz",
-      "integrity": "sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==",
-      "dev": true,
-      "license": "ISC",
-      "dependencies": {
-        "reusify": "^1.0.4"
-      }
-    },
-    "node_modules/fault": {
-      "version": "1.0.4",
-      "resolved": "https://registry.npmjs.org/fault/-/fault-1.0.4.tgz",
-      "integrity": "sha512-CJ0HCB5tL5fYTEA7ToAq5+kTwd++Borf1/bifxd9iT70QcXr4MRrO3Llf8Ifs70q+SJcGHFtnIE/Nw6giCtECA==",
-      "license": "MIT",
-      "dependencies": {
-        "format": "^0.2.0"
-      },
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/fdir": {
-      "version": "6.5.0",
-      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
-      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=12.0.0"
-      },
-      "peerDependencies": {
-        "picomatch": "^3 || ^4"
-      },
-      "peerDependenciesMeta": {
-        "picomatch": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/fill-range": {
-      "version": "7.1.1",
-      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
-      "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "to-regex-range": "^5.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/format": {
-      "version": "0.2.2",
-      "resolved": "https://registry.npmjs.org/format/-/format-0.2.2.tgz",
-      "integrity": "sha512-wzsgA6WOq+09wrU1tsJ09udeR/YZRaeArL9e1wPbFg3GG2yDnC2ldKpxs4xunpFF9DgqCqOIra3bc1HWrJ37Ww==",
-      "engines": {
-        "node": ">=0.4.x"
-      }
-    },
-    "node_modules/fraction.js": {
-      "version": "5.3.4",
-      "resolved": "https://registry.npmjs.org/fraction.js/-/fraction.js-5.3.4.tgz",
-      "integrity": "sha512-1X1NTtiJphryn/uLQz3whtY6jK3fTqoE3ohKs0tT+Ujr1W59oopxmoEh7Lu5p6vBaPbgoM0bzveAW4Qi5RyWDQ==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": "*"
-      },
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/rawify"
-      }
-    },
-    "node_modules/fsevents": {
-      "version": "2.3.3",
-      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
-      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
-      "dev": true,
-      "hasInstallScript": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "engines": {
-        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
-      }
-    },
-    "node_modules/function-bind": {
-      "version": "1.1.2",
-      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
-      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
-      "dev": true,
-      "license": "MIT",
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/fuse.js": {
-      "version": "7.1.0",
-      "resolved": "https://registry.npmjs.org/fuse.js/-/fuse.js-7.1.0.tgz",
-      "integrity": "sha512-trLf4SzuuUxfusZADLINj+dE8clK1frKdmqiJNb1Es75fmI5oY6X2mxLVUciLLjxqw/xr72Dhy+lER6dGd02FQ==",
-      "license": "Apache-2.0",
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/gensync": {
-      "version": "1.0.0-beta.2",
-      "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz",
-      "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/glob-parent": {
-      "version": "6.0.2",
-      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz",
-      "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==",
-      "dev": true,
-      "license": "ISC",
-      "dependencies": {
-        "is-glob": "^4.0.3"
-      },
-      "engines": {
-        "node": ">=10.13.0"
-      }
-    },
-    "node_modules/globals": {
-      "version": "15.15.0",
-      "resolved": "https://registry.npmjs.org/globals/-/globals-15.15.0.tgz",
-      "integrity": "sha512-7ACyT3wmyp3I61S4fG682L0VA2RGD9otkqGJIwNUMF1SWUombIIk+af1unuDYgMm082aHYwD+mzJvv9Iu8dsgg==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=18"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/gray-matter": {
-      "version": "4.0.3",
-      "resolved": "https://registry.npmjs.org/gray-matter/-/gray-matter-4.0.3.tgz",
-      "integrity": "sha512-5v6yZd4JK3eMI3FqqCouswVqwugaA9r4dNZB1wwcmrD02QkV5H0y7XBQW8QwQqEaZY1pM9aqORSORhJRdNK44Q==",
-      "license": "MIT",
-      "dependencies": {
-        "js-yaml": "^3.13.1",
-        "kind-of": "^6.0.2",
-        "section-matter": "^1.0.0",
-        "strip-bom-string": "^1.0.0"
-      },
-      "engines": {
-        "node": ">=6.0"
-      }
-    },
-    "node_modules/hachure-fill": {
-      "version": "0.5.2",
-      "resolved": "https://registry.npmjs.org/hachure-fill/-/hachure-fill-0.5.2.tgz",
-      "integrity": "sha512-3GKBOn+m2LX9iq+JC1064cSFprJY4jL1jCXTcpnfER5HYE2l/4EfWSGzkPa/ZDBmYI0ZOEj5VHV/eKnPGkHuOg==",
-      "license": "MIT"
-    },
-    "node_modules/hasown": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
-      "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "function-bind": "^1.1.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/hast-util-from-parse5": {
-      "version": "8.0.3",
-      "resolved": "https://registry.npmjs.org/hast-util-from-parse5/-/hast-util-from-parse5-8.0.3.tgz",
-      "integrity": "sha512-3kxEVkEKt0zvcZ3hCRYI8rqrgwtlIOFMWkbclACvjlDw8Li9S2hk/d51OI0nr/gIpdMHNepwgOKqZ/sy0Clpyg==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/hast": "^3.0.0",
-        "@types/unist": "^3.0.0",
-        "devlop": "^1.0.0",
-        "hastscript": "^9.0.0",
-        "property-information": "^7.0.0",
-        "vfile": "^6.0.0",
-        "vfile-location": "^5.0.0",
-        "web-namespaces": "^2.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/hast-util-is-element": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/hast-util-is-element/-/hast-util-is-element-3.0.0.tgz",
-      "integrity": "sha512-Val9mnv2IWpLbNPqc/pUem+a7Ipj2aHacCwgNfTiK0vJKl0LF+4Ba4+v1oPHFpf3bLYmreq0/l3Gud9S5OH42g==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/hast": "^3.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/hast-util-parse-selector": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/hast-util-parse-selector/-/hast-util-parse-selector-4.0.0.tgz",
-      "integrity": "sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/hast": "^3.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/hast-util-raw": {
-      "version": "9.1.0",
-      "resolved": "https://registry.npmjs.org/hast-util-raw/-/hast-util-raw-9.1.0.tgz",
-      "integrity": "sha512-Y8/SBAHkZGoNkpzqqfCldijcuUKh7/su31kEBp67cFY09Wy0mTRgtsLYsiIxMJxlu0f6AA5SUTbDR8K0rxnbUw==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/hast": "^3.0.0",
-        "@types/unist": "^3.0.0",
-        "@ungap/structured-clone": "^1.0.0",
-        "hast-util-from-parse5": "^8.0.0",
-        "hast-util-to-parse5": "^8.0.0",
-        "html-void-elements": "^3.0.0",
-        "mdast-util-to-hast": "^13.0.0",
-        "parse5": "^7.0.0",
-        "unist-util-position": "^5.0.0",
-        "unist-util-visit": "^5.0.0",
-        "vfile": "^6.0.0",
-        "web-namespaces": "^2.0.0",
-        "zwitch": "^2.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/hast-util-to-parse5": {
-      "version": "8.0.0",
-      "resolved": "https://registry.npmjs.org/hast-util-to-parse5/-/hast-util-to-parse5-8.0.0.tgz",
-      "integrity": "sha512-3KKrV5ZVI8if87DVSi1vDeByYrkGzg4mEfeu4alwgmmIeARiBLKCZS2uw5Gb6nU9x9Yufyj3iudm6i7nl52PFw==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/hast": "^3.0.0",
-        "comma-separated-tokens": "^2.0.0",
-        "devlop": "^1.0.0",
-        "property-information": "^6.0.0",
-        "space-separated-tokens": "^2.0.0",
-        "web-namespaces": "^2.0.0",
-        "zwitch": "^2.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/hast-util-to-parse5/node_modules/property-information": {
-      "version": "6.5.0",
-      "resolved": "https://registry.npmjs.org/property-information/-/property-information-6.5.0.tgz",
-      "integrity": "sha512-PgTgs/BlvHxOu8QuEN7wi5A0OmXaBcHpmCSTehcs6Uuu9IkDIEo13Hy7n898RHfrQ49vKCoGeWZSaAK01nwVig==",
-      "license": "MIT",
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/hast-util-to-text": {
-      "version": "4.0.2",
-      "resolved": "https://registry.npmjs.org/hast-util-to-text/-/hast-util-to-text-4.0.2.tgz",
-      "integrity": "sha512-KK6y/BN8lbaq654j7JgBydev7wuNMcID54lkRav1P0CaE1e47P72AWWPiGKXTJU271ooYzcvTAn/Zt0REnvc7A==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/hast": "^3.0.0",
-        "@types/unist": "^3.0.0",
-        "hast-util-is-element": "^3.0.0",
-        "unist-util-find-after": "^5.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/hastscript": {
-      "version": "9.0.1",
-      "resolved": "https://registry.npmjs.org/hastscript/-/hastscript-9.0.1.tgz",
-      "integrity": "sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/hast": "^3.0.0",
-        "comma-separated-tokens": "^2.0.0",
-        "hast-util-parse-selector": "^4.0.0",
-        "property-information": "^7.0.0",
-        "space-separated-tokens": "^2.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/highlight.js": {
-      "version": "11.11.1",
-      "resolved": "https://registry.npmjs.org/highlight.js/-/highlight.js-11.11.1.tgz",
-      "integrity": "sha512-Xwwo44whKBVCYoliBQwaPvtd/2tYFkRQtXDWj1nackaV2JPXx3L0+Jvd8/qCJ2p+ML0/XVkJ2q+Mr+UVdpJK5w==",
-      "license": "BSD-3-Clause",
-      "engines": {
-        "node": ">=12.0.0"
-      }
-    },
-    "node_modules/highlightjs-vue": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/highlightjs-vue/-/highlightjs-vue-1.0.0.tgz",
-      "integrity": "sha512-PDEfEF102G23vHmPhLyPboFCD+BkMGu+GuJe2d9/eH4FsCwvgBpnc9n0pGE+ffKdph38s6foEZiEjdgHdzp+IA==",
-      "license": "CC0-1.0"
-    },
-    "node_modules/html-parse-stringify": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/html-parse-stringify/-/html-parse-stringify-3.0.1.tgz",
-      "integrity": "sha512-KknJ50kTInJ7qIScF3jeaFRpMpE8/lfiTdzf/twXyPBLAGrLRTmkz3AdTnKeh40X8k9L2fdYwEp/42WGXIRGcg==",
-      "license": "MIT",
-      "dependencies": {
-        "void-elements": "3.1.0"
-      }
-    },
-    "node_modules/html-void-elements": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/html-void-elements/-/html-void-elements-3.0.0.tgz",
-      "integrity": "sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg==",
-      "license": "MIT",
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/i18next": {
-      "version": "25.6.3",
-      "resolved": "https://registry.npmjs.org/i18next/-/i18next-25.6.3.tgz",
-      "integrity": "sha512-AEQvoPDljhp67a1+NsnG/Wb1Nh6YoSvtrmeEd24sfGn3uujCtXCF3cXpr7ulhMywKNFF7p3TX1u2j7y+caLOJg==",
-      "funding": [
-        {
-          "type": "individual",
-          "url": "https://locize.com"
-        },
-        {
-          "type": "individual",
-          "url": "https://locize.com/i18next.html"
-        },
-        {
-          "type": "individual",
-          "url": "https://www.i18next.com/how-to/faq#i18next-is-awesome.-how-can-i-support-the-project"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "@babel/runtime": "^7.28.4"
-      },
-      "peerDependencies": {
-        "typescript": "^5"
-      },
-      "peerDependenciesMeta": {
-        "typescript": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/iconv-lite": {
-      "version": "0.6.3",
-      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz",
-      "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==",
-      "license": "MIT",
-      "dependencies": {
-        "safer-buffer": ">= 2.1.2 < 3.0.0"
-      },
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/ieee754": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
-      "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==",
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "BSD-3-Clause"
-    },
-    "node_modules/internmap": {
-      "version": "2.0.3",
-      "resolved": "https://registry.npmjs.org/internmap/-/internmap-2.0.3.tgz",
-      "integrity": "sha512-5Hh7Y1wQbvY5ooGgPbDaL5iYLAPzMTUrjMulskHLH6wnv/A+1q5rgEaiuqEjB+oxGXIVZs1FF+R/KPN3ZSQYYg==",
-      "license": "ISC",
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/is-alphabetical": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/is-alphabetical/-/is-alphabetical-2.0.1.tgz",
-      "integrity": "sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==",
-      "license": "MIT",
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/is-alphanumerical": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/is-alphanumerical/-/is-alphanumerical-2.0.1.tgz",
-      "integrity": "sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==",
-      "license": "MIT",
-      "dependencies": {
-        "is-alphabetical": "^2.0.0",
-        "is-decimal": "^2.0.0"
-      },
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/is-binary-path": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz",
-      "integrity": "sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "binary-extensions": "^2.0.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/is-core-module": {
-      "version": "2.16.1",
-      "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.1.tgz",
-      "integrity": "sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "hasown": "^2.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-decimal": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/is-decimal/-/is-decimal-2.0.1.tgz",
-      "integrity": "sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==",
-      "license": "MIT",
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/is-extendable": {
-      "version": "0.1.1",
-      "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz",
-      "integrity": "sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/is-extglob": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
-      "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/is-glob": {
-      "version": "4.0.3",
-      "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",
-      "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "is-extglob": "^2.1.1"
-      },
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/is-hexadecimal": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/is-hexadecimal/-/is-hexadecimal-2.0.1.tgz",
-      "integrity": "sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==",
-      "license": "MIT",
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/is-number": {
-      "version": "7.0.0",
-      "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
-      "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.12.0"
-      }
-    },
-    "node_modules/jiti": {
-      "version": "1.21.7",
-      "resolved": "https://registry.npmjs.org/jiti/-/jiti-1.21.7.tgz",
-      "integrity": "sha512-/imKNG4EbWNrVjoNC/1H5/9GFy+tqjGBHCaSsN+P2RnPqjsLmv6UD3Ej+Kj8nBWaRAwyk7kK5ZUc+OEatnTR3A==",
-      "dev": true,
-      "license": "MIT",
-      "bin": {
-        "jiti": "bin/jiti.js"
-      }
-    },
-    "node_modules/js-tokens": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
-      "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/js-yaml": {
-      "version": "3.14.2",
-      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.2.tgz",
-      "integrity": "sha512-PMSmkqxr106Xa156c2M265Z+FTrPl+oxd/rgOQy2tijQeK5TxQ43psO1ZCwhVOSdnn+RzkzlRz/eY4BgJBYVpg==",
-      "license": "MIT",
-      "dependencies": {
-        "argparse": "^1.0.7",
-        "esprima": "^4.0.0"
-      },
-      "bin": {
-        "js-yaml": "bin/js-yaml.js"
-      }
-    },
-    "node_modules/jsesc": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz",
-      "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==",
-      "dev": true,
-      "license": "MIT",
-      "bin": {
-        "jsesc": "bin/jsesc"
-      },
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/json5": {
-      "version": "2.2.3",
-      "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
-      "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==",
-      "dev": true,
-      "license": "MIT",
-      "bin": {
-        "json5": "lib/cli.js"
-      },
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/katex": {
-      "version": "0.16.25",
-      "resolved": "https://registry.npmjs.org/katex/-/katex-0.16.25.tgz",
-      "integrity": "sha512-woHRUZ/iF23GBP1dkDQMh1QBad9dmr8/PAwNA54VrSOVYgI12MAcE14TqnDdQOdzyEonGzMepYnqBMYdsoAr8Q==",
-      "funding": [
-        "https://opencollective.com/katex",
-        "https://github.com/sponsors/katex"
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "commander": "^8.3.0"
-      },
-      "bin": {
-        "katex": "cli.js"
-      }
-    },
-    "node_modules/katex/node_modules/commander": {
-      "version": "8.3.0",
-      "resolved": "https://registry.npmjs.org/commander/-/commander-8.3.0.tgz",
-      "integrity": "sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww==",
-      "license": "MIT",
-      "engines": {
-        "node": ">= 12"
-      }
-    },
-    "node_modules/khroma": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/khroma/-/khroma-2.1.0.tgz",
-      "integrity": "sha512-Ls993zuzfayK269Svk9hzpeGUKob/sIgZzyHYdjQoAdQetRKpOLj+k/QQQ/6Qi0Yz65mlROrfd+Ev+1+7dz9Kw=="
-    },
-    "node_modules/kind-of": {
-      "version": "6.0.3",
-      "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz",
-      "integrity": "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/kolorist": {
-      "version": "1.8.0",
-      "resolved": "https://registry.npmjs.org/kolorist/-/kolorist-1.8.0.tgz",
-      "integrity": "sha512-Y+60/zizpJ3HRH8DCss+q95yr6145JXZo46OTpFvDZWLfRCE4qChOyk1b26nMaNpfHHgxagk9dXT5OP0Tfe+dQ==",
-      "license": "MIT"
-    },
-    "node_modules/langium": {
-      "version": "3.3.1",
-      "resolved": "https://registry.npmjs.org/langium/-/langium-3.3.1.tgz",
-      "integrity": "sha512-QJv/h939gDpvT+9SiLVlY7tZC3xB2qK57v0J04Sh9wpMb6MP1q8gB21L3WIo8T5P1MSMg3Ep14L7KkDCFG3y4w==",
-      "license": "MIT",
-      "dependencies": {
-        "chevrotain": "~11.0.3",
-        "chevrotain-allstar": "~0.3.0",
-        "vscode-languageserver": "~9.0.1",
-        "vscode-languageserver-textdocument": "~1.0.11",
-        "vscode-uri": "~3.0.8"
-      },
-      "engines": {
-        "node": ">=16.0.0"
-      }
-    },
-    "node_modules/layout-base": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/layout-base/-/layout-base-1.0.2.tgz",
-      "integrity": "sha512-8h2oVEZNktL4BH2JCOI90iD1yXwL6iNW7KcCKT2QZgQJR2vbqDsldCTPRU9NifTCqHZci57XvQQ15YTu+sTYPg==",
-      "license": "MIT"
-    },
-    "node_modules/lilconfig": {
-      "version": "3.1.3",
-      "resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-3.1.3.tgz",
-      "integrity": "sha512-/vlFKAoH5Cgt3Ie+JLhRbwOsCQePABiU3tJ1egGvyQ+33R/vcwM2Zl2QR/LzjsBeItPt3oSVXapn+m4nQDvpzw==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=14"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/antonk52"
-      }
-    },
-    "node_modules/lines-and-columns": {
-      "version": "1.2.4",
-      "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz",
-      "integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/local-pkg": {
-      "version": "1.1.2",
-      "resolved": "https://registry.npmjs.org/local-pkg/-/local-pkg-1.1.2.tgz",
-      "integrity": "sha512-arhlxbFRmoQHl33a0Zkle/YWlmNwoyt6QNZEIJcqNbdrsix5Lvc4HyyI3EnwxTYlZYc32EbYrQ8SzEZ7dqgg9A==",
-      "license": "MIT",
-      "dependencies": {
-        "mlly": "^1.7.4",
-        "pkg-types": "^2.3.0",
-        "quansync": "^0.2.11"
-      },
-      "engines": {
-        "node": ">=14"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/antfu"
-      }
-    },
-    "node_modules/lodash-es": {
-      "version": "4.17.21",
-      "resolved": "https://registry.npmjs.org/lodash-es/-/lodash-es-4.17.21.tgz",
-      "integrity": "sha512-mKnC+QJ9pWVzv+C4/U3rRsHapFfHvQFoFB92e52xeyGMcX6/OlIl78je1u8vePzYZSkkogMPJ2yjxxsb89cxyw==",
-      "license": "MIT"
-    },
-    "node_modules/lowlight": {
-      "version": "3.3.0",
-      "resolved": "https://registry.npmjs.org/lowlight/-/lowlight-3.3.0.tgz",
-      "integrity": "sha512-0JNhgFoPvP6U6lE/UdVsSq99tn6DhjjpAj5MxG49ewd2mOBVtwWYIT8ClyABhq198aXXODMU6Ox8DrGy/CpTZQ==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/hast": "^3.0.0",
-        "devlop": "^1.0.0",
-        "highlight.js": "~11.11.0"
-      },
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/lru-cache": {
-      "version": "5.1.1",
-      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz",
-      "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==",
-      "dev": true,
-      "license": "ISC",
-      "dependencies": {
-        "yallist": "^3.0.2"
-      }
-    },
-    "node_modules/lucide-react": {
-      "version": "0.554.0",
-      "resolved": "https://registry.npmjs.org/lucide-react/-/lucide-react-0.554.0.tgz",
-      "integrity": "sha512-St+z29uthEJVx0Is7ellNkgTEhaeSoA42I7JjOCBCrc5X6LYMGSv0P/2uS5HDLTExP5tpiqRD2PyUEOS6s9UXA==",
-      "license": "ISC",
-      "peerDependencies": {
-        "react": "^16.5.1 || ^17.0.0 || ^18.0.0 || ^19.0.0"
-      }
-    },
-    "node_modules/markdown-to-jsx": {
-      "version": "7.7.17",
-      "resolved": "https://registry.npmjs.org/markdown-to-jsx/-/markdown-to-jsx-7.7.17.tgz",
-      "integrity": "sha512-7mG/1feQ0TX5I7YyMZVDgCC/y2I3CiEhIRQIhyov9nGBP5eoVrOXXHuL5ZP8GRfxVZKRiXWJgwXkb9It+nQZfQ==",
-      "license": "MIT",
-      "engines": {
-        "node": ">= 10"
-      },
-      "peerDependencies": {
-        "react": ">= 0.14.0"
-      },
-      "peerDependenciesMeta": {
-        "react": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/marked": {
-      "version": "16.4.2",
-      "resolved": "https://registry.npmjs.org/marked/-/marked-16.4.2.tgz",
-      "integrity": "sha512-TI3V8YYWvkVf3KJe1dRkpnjs68JUPyEa5vjKrp1XEEJUAOaQc+Qj+L1qWbPd0SJuAdQkFU0h73sXXqwDYxsiDA==",
-      "license": "MIT",
-      "bin": {
-        "marked": "bin/marked.js"
-      },
-      "engines": {
-        "node": ">= 20"
-      }
-    },
-    "node_modules/mdast-util-to-hast": {
-      "version": "13.2.0",
-      "resolved": "https://registry.npmjs.org/mdast-util-to-hast/-/mdast-util-to-hast-13.2.0.tgz",
-      "integrity": "sha512-QGYKEuUsYT9ykKBCMOEDLsU5JRObWQusAolFMeko/tYPufNkRffBAQjIE+99jbA87xv6FgmjLtwjh9wBWajwAA==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/hast": "^3.0.0",
-        "@types/mdast": "^4.0.0",
-        "@ungap/structured-clone": "^1.0.0",
-        "devlop": "^1.0.0",
-        "micromark-util-sanitize-uri": "^2.0.0",
-        "trim-lines": "^3.0.0",
-        "unist-util-position": "^5.0.0",
-        "unist-util-visit": "^5.0.0",
-        "vfile": "^6.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/merge2": {
-      "version": "1.4.1",
-      "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",
-      "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/mermaid": {
-      "version": "11.12.1",
-      "resolved": "https://registry.npmjs.org/mermaid/-/mermaid-11.12.1.tgz",
-      "integrity": "sha512-UlIZrRariB11TY1RtTgUWp65tphtBv4CSq7vyS2ZZ2TgoMjs2nloq+wFqxiwcxlhHUvs7DPGgMjs2aeQxz5h9g==",
-      "license": "MIT",
-      "dependencies": {
-        "@braintree/sanitize-url": "^7.1.1",
-        "@iconify/utils": "^3.0.1",
-        "@mermaid-js/parser": "^0.6.3",
-        "@types/d3": "^7.4.3",
-        "cytoscape": "^3.29.3",
-        "cytoscape-cose-bilkent": "^4.1.0",
-        "cytoscape-fcose": "^2.2.0",
-        "d3": "^7.9.0",
-        "d3-sankey": "^0.12.3",
-        "dagre-d3-es": "7.0.13",
-        "dayjs": "^1.11.18",
-        "dompurify": "^3.2.5",
-        "katex": "^0.16.22",
-        "khroma": "^2.1.0",
-        "lodash-es": "^4.17.21",
-        "marked": "^16.2.1",
-        "roughjs": "^4.6.6",
-        "stylis": "^4.3.6",
-        "ts-dedent": "^2.2.0",
-        "uuid": "^11.1.0"
-      }
-    },
-    "node_modules/micromark-util-character": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/micromark-util-character/-/micromark-util-character-2.1.1.tgz",
-      "integrity": "sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==",
-      "funding": [
-        {
-          "type": "GitHub Sponsors",
-          "url": "https://github.com/sponsors/unifiedjs"
-        },
-        {
-          "type": "OpenCollective",
-          "url": "https://opencollective.com/unified"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "micromark-util-symbol": "^2.0.0",
-        "micromark-util-types": "^2.0.0"
-      }
-    },
-    "node_modules/micromark-util-encode": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/micromark-util-encode/-/micromark-util-encode-2.0.1.tgz",
-      "integrity": "sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==",
-      "funding": [
-        {
-          "type": "GitHub Sponsors",
-          "url": "https://github.com/sponsors/unifiedjs"
-        },
-        {
-          "type": "OpenCollective",
-          "url": "https://opencollective.com/unified"
-        }
-      ],
-      "license": "MIT"
-    },
-    "node_modules/micromark-util-sanitize-uri": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/micromark-util-sanitize-uri/-/micromark-util-sanitize-uri-2.0.1.tgz",
-      "integrity": "sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==",
-      "funding": [
-        {
-          "type": "GitHub Sponsors",
-          "url": "https://github.com/sponsors/unifiedjs"
-        },
-        {
-          "type": "OpenCollective",
-          "url": "https://opencollective.com/unified"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "micromark-util-character": "^2.0.0",
-        "micromark-util-encode": "^2.0.0",
-        "micromark-util-symbol": "^2.0.0"
-      }
-    },
-    "node_modules/micromark-util-symbol": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/micromark-util-symbol/-/micromark-util-symbol-2.0.1.tgz",
-      "integrity": "sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==",
-      "funding": [
-        {
-          "type": "GitHub Sponsors",
-          "url": "https://github.com/sponsors/unifiedjs"
-        },
-        {
-          "type": "OpenCollective",
-          "url": "https://opencollective.com/unified"
-        }
-      ],
-      "license": "MIT"
-    },
-    "node_modules/micromark-util-types": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/micromark-util-types/-/micromark-util-types-2.0.2.tgz",
-      "integrity": "sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==",
-      "funding": [
-        {
-          "type": "GitHub Sponsors",
-          "url": "https://github.com/sponsors/unifiedjs"
-        },
-        {
-          "type": "OpenCollective",
-          "url": "https://opencollective.com/unified"
-        }
-      ],
-      "license": "MIT"
-    },
-    "node_modules/micromatch": {
-      "version": "4.0.8",
-      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",
-      "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "braces": "^3.0.3",
-        "picomatch": "^2.3.1"
-      },
-      "engines": {
-        "node": ">=8.6"
-      }
-    },
-    "node_modules/micromatch/node_modules/picomatch": {
-      "version": "2.3.1",
-      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
-      "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8.6"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/jonschlinkert"
-      }
-    },
-    "node_modules/mlly": {
-      "version": "1.8.0",
-      "resolved": "https://registry.npmjs.org/mlly/-/mlly-1.8.0.tgz",
-      "integrity": "sha512-l8D9ODSRWLe2KHJSifWGwBqpTZXIXTeo8mlKjY+E2HAakaTeNpqAyBZ8GSqLzHgw4XmHmC8whvpjJNMbFZN7/g==",
-      "license": "MIT",
-      "dependencies": {
-        "acorn": "^8.15.0",
-        "pathe": "^2.0.3",
-        "pkg-types": "^1.3.1",
-        "ufo": "^1.6.1"
-      }
-    },
-    "node_modules/mlly/node_modules/confbox": {
-      "version": "0.1.8",
-      "resolved": "https://registry.npmjs.org/confbox/-/confbox-0.1.8.tgz",
-      "integrity": "sha512-RMtmw0iFkeR4YV+fUOSucriAQNb9g8zFR52MWCtl+cCZOFRNL6zeB395vPzFhEjjn4fMxXudmELnl/KF/WrK6w==",
-      "license": "MIT"
-    },
-    "node_modules/mlly/node_modules/pkg-types": {
-      "version": "1.3.1",
-      "resolved": "https://registry.npmjs.org/pkg-types/-/pkg-types-1.3.1.tgz",
-      "integrity": "sha512-/Jm5M4RvtBFVkKWRu2BLUTNP8/M2a+UwuAX+ae4770q1qVGtfjG+WTCupoZixokjmHiry8uI+dlY8KXYV5HVVQ==",
-      "license": "MIT",
-      "dependencies": {
-        "confbox": "^0.1.8",
-        "mlly": "^1.7.4",
-        "pathe": "^2.0.1"
-      }
-    },
-    "node_modules/ms": {
-      "version": "2.1.3",
-      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
-      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
-      "license": "MIT"
-    },
-    "node_modules/mz": {
-      "version": "2.7.0",
-      "resolved": "https://registry.npmjs.org/mz/-/mz-2.7.0.tgz",
-      "integrity": "sha512-z81GNO7nnYMEhrGh9LeymoE4+Yr0Wn5McHIZMK5cfQCl+NDX08sCZgUc9/6MHni9IWuFLm1Z3HTCXu2z9fN62Q==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "any-promise": "^1.0.0",
-        "object-assign": "^4.0.1",
-        "thenify-all": "^1.0.0"
-      }
-    },
-    "node_modules/nanoid": {
-      "version": "3.3.11",
-      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
-      "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ],
-      "license": "MIT",
-      "bin": {
-        "nanoid": "bin/nanoid.cjs"
-      },
-      "engines": {
-        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
-      }
-    },
-    "node_modules/node-releases": {
-      "version": "2.0.27",
-      "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.27.tgz",
-      "integrity": "sha512-nmh3lCkYZ3grZvqcCH+fjmQ7X+H0OeZgP40OierEaAptX4XofMh5kwNbWh7lBduUzCcV/8kZ+NDLCwm2iorIlA==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/normalize-path": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz",
-      "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/normalize-range": {
-      "version": "0.1.2",
-      "resolved": "https://registry.npmjs.org/normalize-range/-/normalize-range-0.1.2.tgz",
-      "integrity": "sha512-bdok/XvKII3nUpklnV6P2hxtMNrCboOjAcyBuQnWEhO665FwrSNRxU+AqpsyvO6LgGYPspN+lu5CLtw4jPRKNA==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/object-assign": {
-      "version": "4.1.1",
-      "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
-      "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/object-hash": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/object-hash/-/object-hash-3.0.0.tgz",
-      "integrity": "sha512-RSn9F68PjH9HqtltsSnqYC1XXoWe9Bju5+213R98cNGttag9q9yAOTzdbsqvIa7aNm5WffBZFpWYr2aWrklWAw==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 6"
-      }
-    },
-    "node_modules/package-manager-detector": {
-      "version": "1.5.0",
-      "resolved": "https://registry.npmjs.org/package-manager-detector/-/package-manager-detector-1.5.0.tgz",
-      "integrity": "sha512-uBj69dVlYe/+wxj8JOpr97XfsxH/eumMt6HqjNTmJDf/6NO9s+0uxeOneIz3AsPt2m6y9PqzDzd3ATcU17MNfw==",
-      "license": "MIT"
-    },
-    "node_modules/parse-entities": {
-      "version": "4.0.2",
-      "resolved": "https://registry.npmjs.org/parse-entities/-/parse-entities-4.0.2.tgz",
-      "integrity": "sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/unist": "^2.0.0",
-        "character-entities-legacy": "^3.0.0",
-        "character-reference-invalid": "^2.0.0",
-        "decode-named-character-reference": "^1.0.0",
-        "is-alphanumerical": "^2.0.0",
-        "is-decimal": "^2.0.0",
-        "is-hexadecimal": "^2.0.0"
-      },
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/parse-entities/node_modules/@types/unist": {
-      "version": "2.0.11",
-      "resolved": "https://registry.npmjs.org/@types/unist/-/unist-2.0.11.tgz",
-      "integrity": "sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==",
-      "license": "MIT"
-    },
-    "node_modules/parse5": {
-      "version": "7.3.0",
-      "resolved": "https://registry.npmjs.org/parse5/-/parse5-7.3.0.tgz",
-      "integrity": "sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==",
-      "license": "MIT",
-      "dependencies": {
-        "entities": "^6.0.0"
-      },
-      "funding": {
-        "url": "https://github.com/inikulin/parse5?sponsor=1"
-      }
-    },
-    "node_modules/path-data-parser": {
-      "version": "0.1.0",
-      "resolved": "https://registry.npmjs.org/path-data-parser/-/path-data-parser-0.1.0.tgz",
-      "integrity": "sha512-NOnmBpt5Y2RWbuv0LMzsayp3lVylAHLPUTut412ZA3l+C4uw4ZVkQbjShYCQ8TCpUMdPapr4YjUqLYD6v68j+w==",
-      "license": "MIT"
-    },
-    "node_modules/path-parse": {
-      "version": "1.0.7",
-      "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz",
-      "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/pathe": {
-      "version": "2.0.3",
-      "resolved": "https://registry.npmjs.org/pathe/-/pathe-2.0.3.tgz",
-      "integrity": "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==",
-      "license": "MIT"
-    },
-    "node_modules/picocolors": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
-      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
-      "dev": true,
-      "license": "ISC"
-    },
-    "node_modules/picomatch": {
-      "version": "4.0.3",
-      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
-      "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=12"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/jonschlinkert"
-      }
-    },
-    "node_modules/pify": {
-      "version": "2.3.0",
-      "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz",
-      "integrity": "sha512-udgsAY+fTnvv7kI7aaxbqwWNb0AHiB0qBO89PZKPkoTmGOgdbrHDKD+0B2X4uTfJ/FT1R09r9gTsjUjNJotuog==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/pirates": {
-      "version": "4.0.7",
-      "resolved": "https://registry.npmjs.org/pirates/-/pirates-4.0.7.tgz",
-      "integrity": "sha512-TfySrs/5nm8fQJDcBDuUng3VOUKsd7S+zqvbOTiGXHfxX4wK31ard+hoNuvkicM/2YFzlpDgABOevKSsB4G/FA==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 6"
-      }
-    },
-    "node_modules/pkg-types": {
-      "version": "2.3.0",
-      "resolved": "https://registry.npmjs.org/pkg-types/-/pkg-types-2.3.0.tgz",
-      "integrity": "sha512-SIqCzDRg0s9npO5XQ3tNZioRY1uK06lA41ynBC1YmFTmnY6FjUjVt6s4LoADmwoig1qqD0oK8h1p/8mlMx8Oig==",
-      "license": "MIT",
-      "dependencies": {
-        "confbox": "^0.2.2",
-        "exsolve": "^1.0.7",
-        "pathe": "^2.0.3"
-      }
-    },
-    "node_modules/points-on-curve": {
-      "version": "0.2.0",
-      "resolved": "https://registry.npmjs.org/points-on-curve/-/points-on-curve-0.2.0.tgz",
-      "integrity": "sha512-0mYKnYYe9ZcqMCWhUjItv/oHjvgEsfKvnUTg8sAtnHr3GVy7rGkXCb6d5cSyqrWqL4k81b9CPg3urd+T7aop3A==",
-      "license": "MIT"
-    },
-    "node_modules/points-on-path": {
-      "version": "0.2.1",
-      "resolved": "https://registry.npmjs.org/points-on-path/-/points-on-path-0.2.1.tgz",
-      "integrity": "sha512-25ClnWWuw7JbWZcgqY/gJ4FQWadKxGWk+3kR/7kD0tCaDtPPMj7oHu2ToLaVhfpnHrZzYby2w6tUA0eOIuUg8g==",
-      "license": "MIT",
-      "dependencies": {
-        "path-data-parser": "0.1.0",
-        "points-on-curve": "0.2.0"
-      }
-    },
-    "node_modules/postcss": {
-      "version": "8.5.6",
-      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.6.tgz",
-      "integrity": "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/postcss/"
-        },
-        {
-          "type": "tidelift",
-          "url": "https://tidelift.com/funding/github/npm/postcss"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "nanoid": "^3.3.11",
-        "picocolors": "^1.1.1",
-        "source-map-js": "^1.2.1"
-      },
-      "engines": {
-        "node": "^10 || ^12 || >=14"
-      }
-    },
-    "node_modules/postcss-import": {
-      "version": "15.1.0",
-      "resolved": "https://registry.npmjs.org/postcss-import/-/postcss-import-15.1.0.tgz",
-      "integrity": "sha512-hpr+J05B2FVYUAXHeK1YyI267J/dDDhMU6B6civm8hSY1jYJnBXxzKDKDswzJmtLHryrjhnDjqqp/49t8FALew==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "postcss-value-parser": "^4.0.0",
-        "read-cache": "^1.0.0",
-        "resolve": "^1.1.7"
-      },
-      "engines": {
-        "node": ">=14.0.0"
-      },
-      "peerDependencies": {
-        "postcss": "^8.0.0"
-      }
-    },
-    "node_modules/postcss-js": {
-      "version": "4.1.0",
-      "resolved": "https://registry.npmjs.org/postcss-js/-/postcss-js-4.1.0.tgz",
-      "integrity": "sha512-oIAOTqgIo7q2EOwbhb8UalYePMvYoIeRY2YKntdpFQXNosSu3vLrniGgmH9OKs/qAkfoj5oB3le/7mINW1LCfw==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/postcss/"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "camelcase-css": "^2.0.1"
-      },
-      "engines": {
-        "node": "^12 || ^14 || >= 16"
-      },
-      "peerDependencies": {
-        "postcss": "^8.4.21"
-      }
-    },
-    "node_modules/postcss-load-config": {
-      "version": "6.0.1",
-      "resolved": "https://registry.npmjs.org/postcss-load-config/-/postcss-load-config-6.0.1.tgz",
-      "integrity": "sha512-oPtTM4oerL+UXmx+93ytZVN82RrlY/wPUV8IeDxFrzIjXOLF1pN+EmKPLbubvKHT2HC20xXsCAH2Z+CKV6Oz/g==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/postcss/"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "lilconfig": "^3.1.1"
-      },
-      "engines": {
-        "node": ">= 18"
-      },
-      "peerDependencies": {
-        "jiti": ">=1.21.0",
-        "postcss": ">=8.0.9",
-        "tsx": "^4.8.1",
-        "yaml": "^2.4.2"
-      },
-      "peerDependenciesMeta": {
-        "jiti": {
-          "optional": true
-        },
-        "postcss": {
-          "optional": true
-        },
-        "tsx": {
-          "optional": true
-        },
-        "yaml": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/postcss-nested": {
-      "version": "6.2.0",
-      "resolved": "https://registry.npmjs.org/postcss-nested/-/postcss-nested-6.2.0.tgz",
-      "integrity": "sha512-HQbt28KulC5AJzG+cZtj9kvKB93CFCdLvog1WFLf1D+xmMvPGlBstkpTEZfK5+AN9hfJocyBFCNiqyS48bpgzQ==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/postcss/"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "postcss-selector-parser": "^6.1.1"
-      },
-      "engines": {
-        "node": ">=12.0"
-      },
-      "peerDependencies": {
-        "postcss": "^8.2.14"
-      }
-    },
-    "node_modules/postcss-selector-parser": {
-      "version": "6.1.2",
-      "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.1.2.tgz",
-      "integrity": "sha512-Q8qQfPiZ+THO/3ZrOrO0cJJKfpYCagtMUkXbnEfmgUjwXg6z/WBeOyS9APBBPCTSiDV+s4SwQGu8yFsiMRIudg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "cssesc": "^3.0.0",
-        "util-deprecate": "^1.0.2"
-      },
-      "engines": {
-        "node": ">=4"
-      }
-    },
-    "node_modules/postcss-value-parser": {
-      "version": "4.2.0",
-      "resolved": "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz",
-      "integrity": "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/prism-react-renderer": {
-      "version": "2.4.1",
-      "resolved": "https://registry.npmjs.org/prism-react-renderer/-/prism-react-renderer-2.4.1.tgz",
-      "integrity": "sha512-ey8Ls/+Di31eqzUxC46h8MksNuGx/n0AAC8uKpwFau4RPDYLuE3EXTp8N8G2vX2N7UC/+IXeNUnlWBGGcAG+Ig==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/prismjs": "^1.26.0",
-        "clsx": "^2.0.0"
-      },
-      "peerDependencies": {
-        "react": ">=16.0.0"
-      }
-    },
-    "node_modules/prismjs": {
-      "version": "1.30.0",
-      "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.30.0.tgz",
-      "integrity": "sha512-DEvV2ZF2r2/63V+tK8hQvrR2ZGn10srHbXviTlcv7Kpzw8jWiNTqbVgjO3IY8RxrrOUF8VPMQQFysYYYv0YZxw==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/property-information": {
-      "version": "7.1.0",
-      "resolved": "https://registry.npmjs.org/property-information/-/property-information-7.1.0.tgz",
-      "integrity": "sha512-TwEZ+X+yCJmYfL7TPUOcvBZ4QfoT5YenQiJuX//0th53DE6w0xxLEtfK3iyryQFddXuvkIk51EEgrJQ0WJkOmQ==",
-      "license": "MIT",
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/quansync": {
-      "version": "0.2.11",
-      "resolved": "https://registry.npmjs.org/quansync/-/quansync-0.2.11.tgz",
-      "integrity": "sha512-AifT7QEbW9Nri4tAwR5M/uzpBuqfZf+zwaEM/QkzEjj7NBuFD2rBuy0K3dE+8wltbezDV7JMA0WfnCPYRSYbXA==",
-      "funding": [
-        {
-          "type": "individual",
-          "url": "https://github.com/sponsors/antfu"
-        },
-        {
-          "type": "individual",
-          "url": "https://github.com/sponsors/sxzz"
-        }
-      ],
-      "license": "MIT"
-    },
-    "node_modules/queue-microtask": {
-      "version": "1.2.3",
-      "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz",
-      "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "MIT"
-    },
-    "node_modules/react": {
-      "version": "19.2.0",
-      "resolved": "https://registry.npmjs.org/react/-/react-19.2.0.tgz",
-      "integrity": "sha512-tmbWg6W31tQLeB5cdIBOicJDJRR2KzXsV7uSK9iNfLWQ5bIZfxuPEHp7M8wiHyHnn0DD1i7w3Zmin0FtkrwoCQ==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/react-dom": {
-      "version": "19.2.0",
-      "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.0.tgz",
-      "integrity": "sha512-UlbRu4cAiGaIewkPyiRGJk0imDN2T3JjieT6spoL2UeSf5od4n5LB/mQ4ejmxhCFT1tYe8IvaFulzynWovsEFQ==",
-      "license": "MIT",
-      "dependencies": {
-        "scheduler": "^0.27.0"
-      },
-      "peerDependencies": {
-        "react": "^19.2.0"
-      }
-    },
-    "node_modules/react-i18next": {
-      "version": "16.3.5",
-      "resolved": "https://registry.npmjs.org/react-i18next/-/react-i18next-16.3.5.tgz",
-      "integrity": "sha512-F7Kglc+T0aE6W2rO5eCAFBEuWRpNb5IFmXOYEgztjZEuiuSLTe/xBIEG6Q3S0fbl8GXMNo+Q7gF8bpokFNWJww==",
-      "license": "MIT",
-      "dependencies": {
-        "@babel/runtime": "^7.27.6",
-        "html-parse-stringify": "^3.0.1",
-        "use-sync-external-store": "^1.6.0"
-      },
-      "peerDependencies": {
-        "i18next": ">= 25.6.2",
-        "react": ">= 16.8.0",
-        "typescript": "^5"
-      },
-      "peerDependenciesMeta": {
-        "react-dom": {
-          "optional": true
-        },
-        "react-native": {
-          "optional": true
-        },
-        "typescript": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/react-refresh": {
-      "version": "0.18.0",
-      "resolved": "https://registry.npmjs.org/react-refresh/-/react-refresh-0.18.0.tgz",
-      "integrity": "sha512-QgT5//D3jfjJb6Gsjxv0Slpj23ip+HtOpnNgnb2S5zU3CB26G/IDPGoy4RJB42wzFE46DRsstbW6tKHoKbhAxw==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/react-router": {
-      "version": "7.9.6",
-      "resolved": "https://registry.npmjs.org/react-router/-/react-router-7.9.6.tgz",
-      "integrity": "sha512-Y1tUp8clYRXpfPITyuifmSoE2vncSME18uVLgaqyxh9H35JWpIfzHo+9y3Fzh5odk/jxPW29IgLgzcdwxGqyNA==",
-      "license": "MIT",
-      "dependencies": {
-        "cookie": "^1.0.1",
-        "set-cookie-parser": "^2.6.0"
-      },
-      "engines": {
-        "node": ">=20.0.0"
-      },
-      "peerDependencies": {
-        "react": ">=18",
-        "react-dom": ">=18"
-      },
-      "peerDependenciesMeta": {
-        "react-dom": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/react-router-dom": {
-      "version": "7.9.6",
-      "resolved": "https://registry.npmjs.org/react-router-dom/-/react-router-dom-7.9.6.tgz",
-      "integrity": "sha512-2MkC2XSXq6HjGcihnx1s0DBWQETI4mlis4Ux7YTLvP67xnGxCvq+BcCQSO81qQHVUTM1V53tl4iVVaY5sReCOA==",
-      "license": "MIT",
-      "dependencies": {
-        "react-router": "7.9.6"
-      },
-      "engines": {
-        "node": ">=20.0.0"
-      },
-      "peerDependencies": {
-        "react": ">=18",
-        "react-dom": ">=18"
-      }
-    },
-    "node_modules/react-simple-code-editor": {
-      "version": "0.14.1",
-      "resolved": "https://registry.npmjs.org/react-simple-code-editor/-/react-simple-code-editor-0.14.1.tgz",
-      "integrity": "sha512-BR5DtNRy+AswWJECyA17qhUDvrrCZ6zXOCfkQY5zSmb96BVUbpVAv03WpcjcwtCwiLbIANx3gebHOcXYn1EHow==",
-      "license": "MIT",
-      "peerDependencies": {
-        "react": ">=16.8.0",
-        "react-dom": ">=16.8.0"
-      }
-    },
-    "node_modules/react-syntax-highlighter": {
-      "version": "16.1.0",
-      "resolved": "https://registry.npmjs.org/react-syntax-highlighter/-/react-syntax-highlighter-16.1.0.tgz",
-      "integrity": "sha512-E40/hBiP5rCNwkeBN1vRP+xow1X0pndinO+z3h7HLsHyjztbyjfzNWNKuAsJj+7DLam9iT4AaaOZnueCU+Nplg==",
-      "license": "MIT",
-      "dependencies": {
-        "@babel/runtime": "^7.28.4",
-        "highlight.js": "^10.4.1",
-        "highlightjs-vue": "^1.0.0",
-        "lowlight": "^1.17.0",
-        "prismjs": "^1.30.0",
-        "refractor": "^5.0.0"
-      },
-      "engines": {
-        "node": ">= 16.20.2"
-      },
-      "peerDependencies": {
-        "react": ">= 0.14.0"
-      }
-    },
-    "node_modules/react-syntax-highlighter/node_modules/highlight.js": {
-      "version": "10.7.3",
-      "resolved": "https://registry.npmjs.org/highlight.js/-/highlight.js-10.7.3.tgz",
-      "integrity": "sha512-tzcUFauisWKNHaRkN4Wjl/ZA07gENAjFl3J/c480dprkGTg5EQstgaNFqBfUqCq54kZRIEcreTsAgF/m2quD7A==",
-      "license": "BSD-3-Clause",
-      "engines": {
-        "node": "*"
-      }
-    },
-    "node_modules/react-syntax-highlighter/node_modules/lowlight": {
-      "version": "1.20.0",
-      "resolved": "https://registry.npmjs.org/lowlight/-/lowlight-1.20.0.tgz",
-      "integrity": "sha512-8Ktj+prEb1RoCPkEOrPMYUN/nCggB7qAWe3a7OpMjWQkh3l2RD5wKRQ+o8Q8YuI9RG/xs95waaI/E6ym/7NsTw==",
-      "license": "MIT",
-      "dependencies": {
-        "fault": "^1.0.0",
-        "highlight.js": "~10.7.0"
-      },
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/read-cache": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/read-cache/-/read-cache-1.0.0.tgz",
-      "integrity": "sha512-Owdv/Ft7IjOgm/i0xvNDZ1LrRANRfew4b2prF3OWMQLxLfu3bS8FVhCsrSCMK4lR56Y9ya+AThoTpDCTxCmpRA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "pify": "^2.3.0"
-      }
-    },
-    "node_modules/readdirp": {
-      "version": "3.6.0",
-      "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz",
-      "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "picomatch": "^2.2.1"
-      },
-      "engines": {
-        "node": ">=8.10.0"
-      }
-    },
-    "node_modules/readdirp/node_modules/picomatch": {
-      "version": "2.3.1",
-      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
-      "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8.6"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/jonschlinkert"
-      }
-    },
-    "node_modules/refractor": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/refractor/-/refractor-5.0.0.tgz",
-      "integrity": "sha512-QXOrHQF5jOpjjLfiNk5GFnWhRXvxjUVnlFxkeDmewR5sXkr3iM46Zo+CnRR8B+MDVqkULW4EcLVcRBNOPXHosw==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/hast": "^3.0.0",
-        "@types/prismjs": "^1.0.0",
-        "hastscript": "^9.0.0",
-        "parse-entities": "^4.0.0"
-      },
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/rehype-highlight": {
-      "version": "7.0.2",
-      "resolved": "https://registry.npmjs.org/rehype-highlight/-/rehype-highlight-7.0.2.tgz",
-      "integrity": "sha512-k158pK7wdC2qL3M5NcZROZ2tR/l7zOzjxXd5VGdcfIyoijjQqpHd3JKtYSBDpDZ38UI2WJWuFAtkMDxmx5kstA==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/hast": "^3.0.0",
-        "hast-util-to-text": "^4.0.0",
-        "lowlight": "^3.0.0",
-        "unist-util-visit": "^5.0.0",
-        "vfile": "^6.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/rehype-raw": {
-      "version": "7.0.0",
-      "resolved": "https://registry.npmjs.org/rehype-raw/-/rehype-raw-7.0.0.tgz",
-      "integrity": "sha512-/aE8hCfKlQeA8LmyeyQvQF3eBiLRGNlfBJEvWH7ivp9sBqs7TNqBL5X3v157rM4IFETqDnIOO+z5M/biZbo9Ww==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/hast": "^3.0.0",
-        "hast-util-raw": "^9.0.0",
-        "vfile": "^6.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/resolve": {
-      "version": "1.22.11",
-      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.11.tgz",
-      "integrity": "sha512-RfqAvLnMl313r7c9oclB1HhUEAezcpLjz95wFH4LVuhk9JF/r22qmVP9AMmOU4vMX7Q8pN8jwNg/CSpdFnMjTQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "is-core-module": "^2.16.1",
-        "path-parse": "^1.0.7",
-        "supports-preserve-symlinks-flag": "^1.0.0"
-      },
-      "bin": {
-        "resolve": "bin/resolve"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/reusify": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz",
-      "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "iojs": ">=1.0.0",
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/robust-predicates": {
-      "version": "3.0.2",
-      "resolved": "https://registry.npmjs.org/robust-predicates/-/robust-predicates-3.0.2.tgz",
-      "integrity": "sha512-IXgzBWvWQwE6PrDI05OvmXUIruQTcoMDzRsOd5CDvHCVLcLHMTSYvOK5Cm46kWqlV3yAbuSpBZdJ5oP5OUoStg==",
-      "license": "Unlicense"
-    },
-    "node_modules/rollup": {
-      "version": "4.53.3",
-      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.53.3.tgz",
-      "integrity": "sha512-w8GmOxZfBmKknvdXU1sdM9NHcoQejwF/4mNgj2JuEEdRaHwwF12K7e9eXn1nLZ07ad+du76mkVsyeb2rKGllsA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@types/estree": "1.0.8"
-      },
-      "bin": {
-        "rollup": "dist/bin/rollup"
-      },
-      "engines": {
-        "node": ">=18.0.0",
-        "npm": ">=8.0.0"
-      },
-      "optionalDependencies": {
-        "@rollup/rollup-android-arm-eabi": "4.53.3",
-        "@rollup/rollup-android-arm64": "4.53.3",
-        "@rollup/rollup-darwin-arm64": "4.53.3",
-        "@rollup/rollup-darwin-x64": "4.53.3",
-        "@rollup/rollup-freebsd-arm64": "4.53.3",
-        "@rollup/rollup-freebsd-x64": "4.53.3",
-        "@rollup/rollup-linux-arm-gnueabihf": "4.53.3",
-        "@rollup/rollup-linux-arm-musleabihf": "4.53.3",
-        "@rollup/rollup-linux-arm64-gnu": "4.53.3",
-        "@rollup/rollup-linux-arm64-musl": "4.53.3",
-        "@rollup/rollup-linux-loong64-gnu": "4.53.3",
-        "@rollup/rollup-linux-ppc64-gnu": "4.53.3",
-        "@rollup/rollup-linux-riscv64-gnu": "4.53.3",
-        "@rollup/rollup-linux-riscv64-musl": "4.53.3",
-        "@rollup/rollup-linux-s390x-gnu": "4.53.3",
-        "@rollup/rollup-linux-x64-gnu": "4.53.3",
-        "@rollup/rollup-linux-x64-musl": "4.53.3",
-        "@rollup/rollup-openharmony-arm64": "4.53.3",
-        "@rollup/rollup-win32-arm64-msvc": "4.53.3",
-        "@rollup/rollup-win32-ia32-msvc": "4.53.3",
-        "@rollup/rollup-win32-x64-gnu": "4.53.3",
-        "@rollup/rollup-win32-x64-msvc": "4.53.3",
-        "fsevents": "~2.3.2"
-      }
-    },
-    "node_modules/roughjs": {
-      "version": "4.6.6",
-      "resolved": "https://registry.npmjs.org/roughjs/-/roughjs-4.6.6.tgz",
-      "integrity": "sha512-ZUz/69+SYpFN/g/lUlo2FXcIjRkSu3nDarreVdGGndHEBJ6cXPdKguS8JGxwj5HA5xIbVKSmLgr5b3AWxtRfvQ==",
-      "license": "MIT",
-      "dependencies": {
-        "hachure-fill": "^0.5.2",
-        "path-data-parser": "^0.1.0",
-        "points-on-curve": "^0.2.0",
-        "points-on-path": "^0.2.1"
-      }
-    },
-    "node_modules/run-parallel": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz",
-      "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "queue-microtask": "^1.2.2"
-      }
-    },
-    "node_modules/rw": {
-      "version": "1.3.3",
-      "resolved": "https://registry.npmjs.org/rw/-/rw-1.3.3.tgz",
-      "integrity": "sha512-PdhdWy89SiZogBLaw42zdeqtRJ//zFd2PgQavcICDUgJT5oW10QCRKbJ6bg4r0/UY2M6BWd5tkxuGFRvCkgfHQ==",
-      "license": "BSD-3-Clause"
-    },
-    "node_modules/safer-buffer": {
-      "version": "2.1.2",
-      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
-      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
-      "license": "MIT"
-    },
-    "node_modules/scheduler": {
-      "version": "0.27.0",
-      "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.27.0.tgz",
-      "integrity": "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q==",
-      "license": "MIT"
-    },
-    "node_modules/section-matter": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/section-matter/-/section-matter-1.0.0.tgz",
-      "integrity": "sha512-vfD3pmTzGpufjScBh50YHKzEu2lxBWhVEHsNGoEXmCmn2hKGfeNLYMzCJpe8cD7gqX7TJluOVpBkAequ6dgMmA==",
-      "license": "MIT",
-      "dependencies": {
-        "extend-shallow": "^2.0.1",
-        "kind-of": "^6.0.0"
-      },
-      "engines": {
-        "node": ">=4"
-      }
-    },
-    "node_modules/semver": {
-      "version": "6.3.1",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
-      "dev": true,
-      "license": "ISC",
-      "bin": {
-        "semver": "bin/semver.js"
-      }
-    },
-    "node_modules/set-cookie-parser": {
-      "version": "2.7.2",
-      "resolved": "https://registry.npmjs.org/set-cookie-parser/-/set-cookie-parser-2.7.2.tgz",
-      "integrity": "sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw==",
-      "license": "MIT"
-    },
-    "node_modules/source-map-js": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
-      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
-      "dev": true,
-      "license": "BSD-3-Clause",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/space-separated-tokens": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/space-separated-tokens/-/space-separated-tokens-2.0.2.tgz",
-      "integrity": "sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==",
-      "license": "MIT",
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/sprintf-js": {
-      "version": "1.0.3",
-      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz",
-      "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==",
-      "license": "BSD-3-Clause"
-    },
-    "node_modules/strip-bom-string": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/strip-bom-string/-/strip-bom-string-1.0.0.tgz",
-      "integrity": "sha512-uCC2VHvQRYu+lMh4My/sFNmF2klFymLX1wHJeXnbEJERpV/ZsVuonzerjfrGpIGF7LBVa1O7i9kjiWvJiFck8g==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/stylis": {
-      "version": "4.3.6",
-      "resolved": "https://registry.npmjs.org/stylis/-/stylis-4.3.6.tgz",
-      "integrity": "sha512-yQ3rwFWRfwNUY7H5vpU0wfdkNSnvnJinhF9830Swlaxl03zsOjCfmX0ugac+3LtK0lYSgwL/KXc8oYL3mG4YFQ==",
-      "license": "MIT"
-    },
-    "node_modules/sucrase": {
-      "version": "3.35.1",
-      "resolved": "https://registry.npmjs.org/sucrase/-/sucrase-3.35.1.tgz",
-      "integrity": "sha512-DhuTmvZWux4H1UOnWMB3sk0sbaCVOoQZjv8u1rDoTV0HTdGem9hkAZtl4JZy8P2z4Bg0nT+YMeOFyVr4zcG5Tw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@jridgewell/gen-mapping": "^0.3.2",
-        "commander": "^4.0.0",
-        "lines-and-columns": "^1.1.6",
-        "mz": "^2.7.0",
-        "pirates": "^4.0.1",
-        "tinyglobby": "^0.2.11",
-        "ts-interface-checker": "^0.1.9"
-      },
-      "bin": {
-        "sucrase": "bin/sucrase",
-        "sucrase-node": "bin/sucrase-node"
-      },
-      "engines": {
-        "node": ">=16 || 14 >=14.17"
-      }
-    },
-    "node_modules/supports-preserve-symlinks-flag": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz",
-      "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/tabbable": {
-      "version": "6.3.0",
-      "resolved": "https://registry.npmjs.org/tabbable/-/tabbable-6.3.0.tgz",
-      "integrity": "sha512-EIHvdY5bPLuWForiR/AN2Bxngzpuwn1is4asboytXtpTgsArc+WmSJKVLlhdh71u7jFcryDqB2A8lQvj78MkyQ==",
-      "license": "MIT"
-    },
-    "node_modules/tailwindcss": {
-      "version": "3.4.18",
-      "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-3.4.18.tgz",
-      "integrity": "sha512-6A2rnmW5xZMdw11LYjhcI5846rt9pbLSabY5XPxo+XWdxwZaFEn47Go4NzFiHu9sNNmr/kXivP1vStfvMaK1GQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@alloc/quick-lru": "^5.2.0",
-        "arg": "^5.0.2",
-        "chokidar": "^3.6.0",
-        "didyoumean": "^1.2.2",
-        "dlv": "^1.1.3",
-        "fast-glob": "^3.3.2",
-        "glob-parent": "^6.0.2",
-        "is-glob": "^4.0.3",
-        "jiti": "^1.21.7",
-        "lilconfig": "^3.1.3",
-        "micromatch": "^4.0.8",
-        "normalize-path": "^3.0.0",
-        "object-hash": "^3.0.0",
-        "picocolors": "^1.1.1",
-        "postcss": "^8.4.47",
-        "postcss-import": "^15.1.0",
-        "postcss-js": "^4.0.1",
-        "postcss-load-config": "^4.0.2 || ^5.0 || ^6.0",
-        "postcss-nested": "^6.2.0",
-        "postcss-selector-parser": "^6.1.2",
-        "resolve": "^1.22.8",
-        "sucrase": "^3.35.0"
-      },
-      "bin": {
-        "tailwind": "lib/cli.js",
-        "tailwindcss": "lib/cli.js"
-      },
-      "engines": {
-        "node": ">=14.0.0"
-      }
-    },
-    "node_modules/thenify": {
-      "version": "3.3.1",
-      "resolved": "https://registry.npmjs.org/thenify/-/thenify-3.3.1.tgz",
-      "integrity": "sha512-RVZSIV5IG10Hk3enotrhvz0T9em6cyHBLkH/YAZuKqd8hRkKhSfCGIcP2KUY0EPxndzANBmNllzWPwak+bheSw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "any-promise": "^1.0.0"
-      }
-    },
-    "node_modules/thenify-all": {
-      "version": "1.6.0",
-      "resolved": "https://registry.npmjs.org/thenify-all/-/thenify-all-1.6.0.tgz",
-      "integrity": "sha512-RNxQH/qI8/t3thXJDwcstUO4zeqo64+Uy/+sNVRBx4Xn2OX+OZ9oP+iJnNFqplFra2ZUVeKCSa2oVWi3T4uVmA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "thenify": ">= 3.1.0 < 4"
-      },
-      "engines": {
-        "node": ">=0.8"
-      }
-    },
-    "node_modules/tinyexec": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-1.0.2.tgz",
-      "integrity": "sha512-W/KYk+NFhkmsYpuHq5JykngiOCnxeVL8v8dFnqxSD8qEEdRfXk1SDM6JzNqcERbcGYj9tMrDQBYV9cjgnunFIg==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/tinyglobby": {
-      "version": "0.2.15",
-      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",
-      "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "fdir": "^6.5.0",
-        "picomatch": "^4.0.3"
-      },
-      "engines": {
-        "node": ">=12.0.0"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/SuperchupuDev"
-      }
-    },
-    "node_modules/to-regex-range": {
-      "version": "5.0.1",
-      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
-      "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "is-number": "^7.0.0"
-      },
-      "engines": {
-        "node": ">=8.0"
-      }
-    },
-    "node_modules/trim-lines": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/trim-lines/-/trim-lines-3.0.1.tgz",
-      "integrity": "sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==",
-      "license": "MIT",
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/ts-dedent": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/ts-dedent/-/ts-dedent-2.2.0.tgz",
-      "integrity": "sha512-q5W7tVM71e2xjHZTlgfTDoPF/SmqKG5hddq9SzR49CH2hayqRKJtQ4mtRlSxKaJlR/+9rEM+mnBHf7I2/BQcpQ==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=6.10"
-      }
-    },
-    "node_modules/ts-interface-checker": {
-      "version": "0.1.13",
-      "resolved": "https://registry.npmjs.org/ts-interface-checker/-/ts-interface-checker-0.1.13.tgz",
-      "integrity": "sha512-Y/arvbn+rrz3JCKl9C4kVNfTfSm2/mEp5FSz5EsZSANGPSlQrpRI5M4PKF+mJnE52jOO90PnPSc3Ur3bTQw0gA==",
-      "dev": true,
-      "license": "Apache-2.0"
-    },
-    "node_modules/tslib": {
-      "version": "2.8.1",
-      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
-      "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
-      "license": "0BSD"
-    },
-    "node_modules/typescript": {
-      "version": "5.9.3",
-      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
-      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
-      "devOptional": true,
-      "license": "Apache-2.0",
-      "bin": {
-        "tsc": "bin/tsc",
-        "tsserver": "bin/tsserver"
-      },
-      "engines": {
-        "node": ">=14.17"
-      }
-    },
-    "node_modules/ufo": {
-      "version": "1.6.1",
-      "resolved": "https://registry.npmjs.org/ufo/-/ufo-1.6.1.tgz",
-      "integrity": "sha512-9a4/uxlTWJ4+a5i0ooc1rU7C7YOw3wT+UGqdeNNHWnOF9qcMBgLRS+4IYUqbczewFx4mLEig6gawh7X6mFlEkA==",
-      "license": "MIT"
-    },
-    "node_modules/unist-util-find-after": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/unist-util-find-after/-/unist-util-find-after-5.0.0.tgz",
-      "integrity": "sha512-amQa0Ep2m6hE2g72AugUItjbuM8X8cGQnFoHk0pGfrFeT9GZhzN5SW8nRsiGKK7Aif4CrACPENkA6P/Lw6fHGQ==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/unist": "^3.0.0",
-        "unist-util-is": "^6.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/unist-util-is": {
-      "version": "6.0.1",
-      "resolved": "https://registry.npmjs.org/unist-util-is/-/unist-util-is-6.0.1.tgz",
-      "integrity": "sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/unist": "^3.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/unist-util-position": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/unist-util-position/-/unist-util-position-5.0.0.tgz",
-      "integrity": "sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/unist": "^3.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/unist-util-stringify-position": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/unist-util-stringify-position/-/unist-util-stringify-position-4.0.0.tgz",
-      "integrity": "sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/unist": "^3.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/unist-util-visit": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/unist-util-visit/-/unist-util-visit-5.0.0.tgz",
-      "integrity": "sha512-MR04uvD+07cwl/yhVuVWAtw+3GOR/knlL55Nd/wAdblk27GCVt3lqpTivy/tkJcZoNPzTwS1Y+KMojlLDhoTzg==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/unist": "^3.0.0",
-        "unist-util-is": "^6.0.0",
-        "unist-util-visit-parents": "^6.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/unist-util-visit-parents": {
-      "version": "6.0.2",
-      "resolved": "https://registry.npmjs.org/unist-util-visit-parents/-/unist-util-visit-parents-6.0.2.tgz",
-      "integrity": "sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/unist": "^3.0.0",
-        "unist-util-is": "^6.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/update-browserslist-db": {
-      "version": "1.1.4",
-      "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.1.4.tgz",
-      "integrity": "sha512-q0SPT4xyU84saUX+tomz1WLkxUbuaJnR1xWt17M7fJtEJigJeWUNGUqrauFXsHnqev9y9JTRGwk13tFBuKby4A==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/browserslist"
-        },
-        {
-          "type": "tidelift",
-          "url": "https://tidelift.com/funding/github/npm/browserslist"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "escalade": "^3.2.0",
-        "picocolors": "^1.1.1"
-      },
-      "bin": {
-        "update-browserslist-db": "cli.js"
-      },
-      "peerDependencies": {
-        "browserslist": ">= 4.21.0"
-      }
-    },
-    "node_modules/use-sync-external-store": {
-      "version": "1.6.0",
-      "resolved": "https://registry.npmjs.org/use-sync-external-store/-/use-sync-external-store-1.6.0.tgz",
-      "integrity": "sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w==",
-      "license": "MIT",
-      "peerDependencies": {
-        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
-      }
-    },
-    "node_modules/util-deprecate": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
-      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/uuid": {
-      "version": "11.1.0",
-      "resolved": "https://registry.npmjs.org/uuid/-/uuid-11.1.0.tgz",
-      "integrity": "sha512-0/A9rDy9P7cJ+8w1c9WD9V//9Wj15Ce2MPz8Ri6032usz+NfePxx5AcN3bN+r6ZL6jEo066/yNYB3tn4pQEx+A==",
-      "funding": [
-        "https://github.com/sponsors/broofa",
-        "https://github.com/sponsors/ctavan"
-      ],
-      "license": "MIT",
-      "bin": {
-        "uuid": "dist/esm/bin/uuid"
-      }
-    },
-    "node_modules/vfile": {
-      "version": "6.0.3",
-      "resolved": "https://registry.npmjs.org/vfile/-/vfile-6.0.3.tgz",
-      "integrity": "sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/unist": "^3.0.0",
-        "vfile-message": "^4.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/vfile-location": {
-      "version": "5.0.3",
-      "resolved": "https://registry.npmjs.org/vfile-location/-/vfile-location-5.0.3.tgz",
-      "integrity": "sha512-5yXvWDEgqeiYiBe1lbxYF7UMAIm/IcopxMHrMQDq3nvKcjPKIhZklUKL+AE7J7uApI4kwe2snsK+eI6UTj9EHg==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/unist": "^3.0.0",
-        "vfile": "^6.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/vfile-message": {
-      "version": "4.0.3",
-      "resolved": "https://registry.npmjs.org/vfile-message/-/vfile-message-4.0.3.tgz",
-      "integrity": "sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/unist": "^3.0.0",
-        "unist-util-stringify-position": "^4.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/unified"
-      }
-    },
-    "node_modules/vite": {
-      "version": "7.2.4",
-      "resolved": "https://registry.npmjs.org/vite/-/vite-7.2.4.tgz",
-      "integrity": "sha512-NL8jTlbo0Tn4dUEXEsUg8KeyG/Lkmc4Fnzb8JXN/Ykm9G4HNImjtABMJgkQoVjOBN/j2WAwDTRytdqJbZsah7w==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "esbuild": "^0.25.0",
-        "fdir": "^6.5.0",
-        "picomatch": "^4.0.3",
-        "postcss": "^8.5.6",
-        "rollup": "^4.43.0",
-        "tinyglobby": "^0.2.15"
-      },
-      "bin": {
-        "vite": "bin/vite.js"
-      },
-      "engines": {
-        "node": "^20.19.0 || >=22.12.0"
-      },
-      "funding": {
-        "url": "https://github.com/vitejs/vite?sponsor=1"
-      },
-      "optionalDependencies": {
-        "fsevents": "~2.3.3"
-      },
-      "peerDependencies": {
-        "@types/node": "^20.19.0 || >=22.12.0",
-        "jiti": ">=1.21.0",
-        "less": "^4.0.0",
-        "lightningcss": "^1.21.0",
-        "sass": "^1.70.0",
-        "sass-embedded": "^1.70.0",
-        "stylus": ">=0.54.8",
-        "sugarss": "^5.0.0",
-        "terser": "^5.16.0",
-        "tsx": "^4.8.1",
-        "yaml": "^2.4.2"
-      },
-      "peerDependenciesMeta": {
-        "@types/node": {
-          "optional": true
-        },
-        "jiti": {
-          "optional": true
-        },
-        "less": {
-          "optional": true
-        },
-        "lightningcss": {
-          "optional": true
-        },
-        "sass": {
-          "optional": true
-        },
-        "sass-embedded": {
-          "optional": true
-        },
-        "stylus": {
-          "optional": true
-        },
-        "sugarss": {
-          "optional": true
-        },
-        "terser": {
-          "optional": true
-        },
-        "tsx": {
-          "optional": true
-        },
-        "yaml": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/void-elements": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/void-elements/-/void-elements-3.1.0.tgz",
-      "integrity": "sha512-Dhxzh5HZuiHQhbvTW9AMetFfBHDMYpo23Uo9btPXgdYP+3T5S+p+jgNy7spra+veYhBP2dCSgxR/i2Y02h5/6w==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/vscode-jsonrpc": {
-      "version": "8.2.0",
-      "resolved": "https://registry.npmjs.org/vscode-jsonrpc/-/vscode-jsonrpc-8.2.0.tgz",
-      "integrity": "sha512-C+r0eKJUIfiDIfwJhria30+TYWPtuHJXHtI7J0YlOmKAo7ogxP20T0zxB7HZQIFhIyvoBPwWskjxrvAtfjyZfA==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=14.0.0"
-      }
-    },
-    "node_modules/vscode-languageserver": {
-      "version": "9.0.1",
-      "resolved": "https://registry.npmjs.org/vscode-languageserver/-/vscode-languageserver-9.0.1.tgz",
-      "integrity": "sha512-woByF3PDpkHFUreUa7Hos7+pUWdeWMXRd26+ZX2A8cFx6v/JPTtd4/uN0/jB6XQHYaOlHbio03NTHCqrgG5n7g==",
-      "license": "MIT",
-      "dependencies": {
-        "vscode-languageserver-protocol": "3.17.5"
-      },
-      "bin": {
-        "installServerIntoExtension": "bin/installServerIntoExtension"
-      }
-    },
-    "node_modules/vscode-languageserver-protocol": {
-      "version": "3.17.5",
-      "resolved": "https://registry.npmjs.org/vscode-languageserver-protocol/-/vscode-languageserver-protocol-3.17.5.tgz",
-      "integrity": "sha512-mb1bvRJN8SVznADSGWM9u/b07H7Ecg0I3OgXDuLdn307rl/J3A9YD6/eYOssqhecL27hK1IPZAsaqh00i/Jljg==",
-      "license": "MIT",
-      "dependencies": {
-        "vscode-jsonrpc": "8.2.0",
-        "vscode-languageserver-types": "3.17.5"
-      }
-    },
-    "node_modules/vscode-languageserver-textdocument": {
-      "version": "1.0.12",
-      "resolved": "https://registry.npmjs.org/vscode-languageserver-textdocument/-/vscode-languageserver-textdocument-1.0.12.tgz",
-      "integrity": "sha512-cxWNPesCnQCcMPeenjKKsOCKQZ/L6Tv19DTRIGuLWe32lyzWhihGVJ/rcckZXJxfdKCFvRLS3fpBIsV/ZGX4zA==",
-      "license": "MIT"
-    },
-    "node_modules/vscode-languageserver-types": {
-      "version": "3.17.5",
-      "resolved": "https://registry.npmjs.org/vscode-languageserver-types/-/vscode-languageserver-types-3.17.5.tgz",
-      "integrity": "sha512-Ld1VelNuX9pdF39h2Hgaeb5hEZM2Z3jUrrMgWQAu82jMtZp7p3vJT3BzToKtZI7NgQssZje5o0zryOrhQvzQAg==",
-      "license": "MIT"
-    },
-    "node_modules/vscode-uri": {
-      "version": "3.0.8",
-      "resolved": "https://registry.npmjs.org/vscode-uri/-/vscode-uri-3.0.8.tgz",
-      "integrity": "sha512-AyFQ0EVmsOZOlAnxoFOGOq1SQDWAB7C6aqMGS23svWAllfOaxbuFvcT8D1i8z3Gyn8fraVeZNNmN6e9bxxXkKw==",
-      "license": "MIT"
-    },
-    "node_modules/web-namespaces": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/web-namespaces/-/web-namespaces-2.0.1.tgz",
-      "integrity": "sha512-bKr1DkiNa2krS7qxNtdrtHAmzuYGFQLiQ13TsorsdT6ULTkPLKuu5+GsFpDlg6JFjUTwX2DyhMPG2be8uPrqsQ==",
-      "license": "MIT",
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    },
-    "node_modules/yallist": {
-      "version": "3.1.1",
-      "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz",
-      "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==",
-      "dev": true,
-      "license": "ISC"
-    },
-    "node_modules/zwitch": {
-      "version": "2.0.4",
-      "resolved": "https://registry.npmjs.org/zwitch/-/zwitch-2.0.4.tgz",
-      "integrity": "sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==",
-      "license": "MIT",
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/wooorm"
-      }
-    }
-  }
-}
diff --git a/docs/package.json b/docs/package.json
deleted file mode 100644
index ef87988f..00000000
--- a/docs/package.json
+++ /dev/null
@@ -1,48 +0,0 @@
-{
-  "name": "docs",
-  "version": "1.0.0",
-  "description": "",
-  "main": "index.js",
-  "scripts": {
-    "dev": "npm run generate:search-index && vite",
-    "generate:search-index": "node scripts/generate-search-index.mjs",
-    "build": "npm run generate:search-index && tsc -b && vite build",
-    "preview": "vite preview"
-  },
-  "type": "module",
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "dependencies": {
-    "@headlessui/react": "^2.2.9",
-    "@types/prismjs": "^1.26.5",
-    "@types/react-syntax-highlighter": "^15.5.13",
-    "buffer": "^6.0.3",
-    "fuse.js": "^7.1.0",
-    "gray-matter": "^4.0.3",
-    "i18next": "^25.6.3",
-    "lucide-react": "^0.554.0",
-    "markdown-to-jsx": "^7.7.17",
-    "mermaid": "^11.12.1",
-    "prism-react-renderer": "^2.4.1",
-    "prismjs": "^1.30.0",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "react-i18next": "^16.3.5",
-    "react-router-dom": "^7.9.6",
-    "react-simple-code-editor": "^0.14.1",
-    "react-syntax-highlighter": "^16.1.0",
-    "rehype-highlight": "^7.0.2",
-    "rehype-raw": "^7.0.0"
-  },
-  "devDependencies": {
-    "@types/react": "^19.2.6",
-    "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^5.1.1",
-    "autoprefixer": "^10.4.22",
-    "postcss": "^8.5.6",
-    "tailwindcss": "^3.4.18",
-    "typescript": "^5.9.3",
-    "vite": "^7.2.4"
-  }
-}
diff --git a/docs/postcss.config.js b/docs/postcss.config.js
deleted file mode 100644
index d41ad635..00000000
--- a/docs/postcss.config.js
+++ /dev/null
@@ -1,6 +0,0 @@
-export default {
-    plugins: {
-        tailwindcss: {},
-        autoprefixer: {},
-    },
-}
diff --git a/docs/public/apple-touch-icon.png b/docs/public/apple-touch-icon.png
deleted file mode 100644
index 86c15fe8..00000000
Binary files a/docs/public/apple-touch-icon.png and /dev/null differ
diff --git a/docs/public/apple-touch-icon.svg b/docs/public/apple-touch-icon.svg
deleted file mode 100644
index 95187755..00000000
--- a/docs/public/apple-touch-icon.svg
+++ /dev/null
@@ -1,32 +0,0 @@
-<svg width="180" height="180" viewBox="0 0 180 180" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <defs>
-    <linearGradient id="appleIconGradient" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#60a5fa"/>
-      <stop offset="100%" style="stop-color:#3b82f6"/>
-    </linearGradient>
-    <linearGradient id="appleBgGradient" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#1e293b"/>
-      <stop offset="100%" style="stop-color:#0f172a"/>
-    </linearGradient>
-    <filter id="appleShadow">
-      <feDropShadow dx="0" dy="4" stdDeviation="8" floodOpacity="0.3"/>
-    </filter>
-  </defs>
-
-  <!-- Background with rounded corners for Apple style -->
-  <rect width="180" height="180" rx="40" fill="url(#appleBgGradient)" filter="url(#appleShadow)"/>
-
-  <!-- Subtle inner glow -->
-  <rect width="180" height="180" rx="40" fill="url(#appleIconGradient)" opacity="0.1"/>
-
-  <!-- Letter E -->
-  <path d="M45 50h50v15h-30v20h25v15h-25v20h30v15H45V50z" fill="url(#appleIconGradient)"/>
-
-  <!-- Letter P -->
-  <path d="M105 50h35c8 0 15 7 15 15v10c0 8-7 15-15 15h-20v45h-15V50zm15 25h20c3 0 5-2 5-5v-5c0-3-2-5-5-5h-20v15z" fill="url(#appleIconGradient)"/>
-
-  <!-- Decorative accent dots -->
-  <circle cx="150" cy="30" r="8" fill="#60a5fa" opacity="0.8"/>
-  <circle cx="30" cy="150" r="6" fill="#8b5cf6" opacity="0.7"/>
-  <circle cx="160" cy="140" r="4" fill="#06b6d4" opacity="0.6"/>
-</svg>
diff --git a/docs/public/assets/partners/comazo.svg b/docs/public/assets/partners/comazo.svg
deleted file mode 100644
index a0ff51bd..00000000
--- a/docs/public/assets/partners/comazo.svg
+++ /dev/null
@@ -1,52 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<!-- Creator: CorelDRAW 2017 -->
-<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" width="145mm" height="71mm" version="1.1" style="shape-rendering:geometricPrecision; text-rendering:geometricPrecision; image-rendering:optimizeQuality; fill-rule:evenodd; clip-rule:evenodd"
-viewBox="0 0 14500 7100"
- xmlns:xlink="http://www.w3.org/1999/xlink">
- <defs>
-  <font id="FontID0" horiz-adv-x="600" font-variant="normal" style="fill-rule:nonzero" font-weight="400">
-	<font-face 
-		font-family="CourierPS">
-		<font-face-src>
-			<font-face-name name="CourierPS"/>
-		</font-face-src>
-	</font-face>
-   <missing-glyph><path d="M0 0z"/></missing-glyph>
-   <glyph unicode="8" horiz-adv-x="600" d="M378.999 308.669l0 0c23.1717,-7.83943 44.1705,-19.6688 62.9964,-35.6661 37.3333,-31.8354 55.9999,-72.1658 55.9999,-120.504 0,-48.1699 -18.8259,-88.1631 -56.3277,-119.83 -37.6705,-31.8354 -84.9974,-47.6735 -141.831,-47.6735 -57.0021,0 -104.17,15.8381 -141.672,47.6735 -37.5019,31.6668 -56.1685,71.66 -56.1685,119.83 0,48.3385 18.8352,88.6689 56.5057,120.504 18.4981,15.6601 39.1597,27.4989 61.9942,35.6661l0 0c-19.828,7.83006 -37.8297,18.6666 -53.827,32.6596 -35.1697,30.8332 -52.6656,69.8337 -52.6656,116.674 0,47.1677 17.4959,86.3274 52.6656,117.329 35.1603,31.1704 79.6681,46.6713 133.326,46.6713 53.6678,0 98.1661,-15.5009 133.336,-46.6713 35.1697,-31.0018 52.6656,-70.1615 52.6656,-117.329 0,-46.8399 -17.4959,-85.8403 -52.6656,-116.674 -16.3345,-13.993 -34.3361,-24.8295 -54.3328,-32.6596zm-79.0031 21.3266c35.8347,0 66.8365,12.0073 92.8368,36.0033 26.1689,24.0053 39.169,52.497 39.169,85.5031 0,35.6661 -12.3352,65.0007 -37.1647,87.9945 -24.8389,23.0031 -56.3371,34.5047 -94.8412,34.5047 -38.4947,0 -69.9929,-11.5016 -94.8318,-34.5047 -24.8295,-22.9938 -37.1647,-52.3284 -37.1647,-87.9945 0,-33.0061 13.0001,-61.4978 39.169,-85.5031 26.0003,-23.996 57.0021,-36.0033 92.8274,-36.0033zm-0.159224 -47.9919c-42.1662,0 -76.6709,-12.0073 -103.505,-35.8347 -26.8339,-23.8367 -40.3304,-54.5013 -40.3304,-91.8346 0,-37.1647 13.4966,-67.6701 40.3304,-91.4975 26.8339,-23.8367 61.3386,-35.8347 103.505,-35.8347 41.9976,0 76.493,11.998 103.495,35.8347 27.1711,23.8274 40.6676,54.3328 40.6676,91.4975 0,37.3333 -13.4966,67.9979 -40.499,92.0032 -27.1711,23.8274 -61.6664,35.6661 -103.664,35.6661z"/>
-   <glyph unicode="I" horiz-adv-x="600" d="M276 48.0013l0 466.001 -179.998 0 0 48.0013 205.502 0 205.492 0 0 -48.0013 -179.998 0 0 -466.001 179.998 0 0 -48.0013 -205.492 0 -205.502 0 0 48.0013 179.998 0z"/>
-   <glyph unicode="C" horiz-adv-x="600" d="M535.001 62.0036c-35.1697,-29.0068 -69.6651,-49.4999 -103.505,-61.6664 -33.8304,-12.1666 -73.4958,-18.3388 -119.165,-18.3388 -78.0009,0 -142.833,28.3325 -194.169,84.9974 -51.4948,56.5057 -77.1673,127.838 -77.1673,213.837 0,89.9989 24.8389,162.502 74.5073,217.162 49.6684,54.6699 115.334,82.0002 197.166,82.0002 51.4948,0.33718 96.9954,-14.3301 136.829,-43.8334 13.3373,-9.99363 23.6681,-13.4966 30.8332,-10.1622 7.16507,3.16574 10.668,12.663 10.668,28.3325l0 10.668 45.9969 -7.33366c-5.4979,-31.8354 -8.16724,-61.835 -7.83006,-89.9989 0.33718,-28.3325 3.99933,-58.5007 10.8366,-90.6639l-46.9991 -6.34085c-2.33216,50.3334 -19.341,89.8397 -51.167,118.5 -31.8354,28.501 -74.8352,42.8406 -128.84,42.8406 -65.6657,0 -117.826,-22.666 -156.667,-68.0073 -38.8319,-45.1633 -58.3321,-105.996 -58.3321,-182.161 0,-72.9994 20.1652,-132.999 60.505,-179.67 40.1618,-46.8305 91.666,-70.1615 154.494,-70.1615 38.6726,0 72.503,5.16072 101.838,15.4915 29.166,10.3402 59.9993,28.1732 92.1624,53.5085l28.0046 -39.0004z"/>
-   <glyph unicode="N" horiz-adv-x="600" d="M143.002 48.0013l106.998 0 0 -48.0013 -121.169 0 -121.834 0 0 48.0013 85.0067 0 0 466.001 -85.0067 0 0 48.0013 84.3324 0 84.8382 0 0 0 291.829 -521.008 0 0 0 0 0 473.007 -109.996 0 0 48.0013 117.498 0 117.498 0 0 -48.0013 -73.9922 0 0 -527.002 -39.169 0 -39.169 0 -297.664 530.337 0 0 0 0 0 -469.335z"/>
-   <glyph unicode="4" horiz-adv-x="600" d="M355.996 141.999l-277.995 0 0 27.8361 0 27.8267 251.995 424.341 38.504 0 38.504 0 0 -432.002 0 0 92.996 0 0 -48.0013 -92.996 0 0 0 0 -93.9982 92.996 0 0 -48.0013 -140.501 0 -140.501 0 0 48.0013 136.998 0 0 93.9982zm0 48.0013l0 0 0 380.17 0 0 0 0 -220.993 -371.834 -4.83291 -8.33583 0 0 225.826 0z"/>
-   <glyph unicode="E" horiz-adv-x="600" d="M53.9956 0l0 48.0013 88.0039 0 0 466.001 -88.0039 0 0 48.0013 139.171 0 0 0 349.833 0 0 0 2.50075 -90.0082 2.50075 -89.9989 -46.9991 0 -9.83441 132.006 -298.17 0 0 0 0 -197.999 0 0 166.998 0 0 74.0016 48.0013 0 0 -97.6697 0 -98.3347 -48.0013 0 0 74.0016 -166.998 0 0 0 0 -220 0 0 304.164 0 6.83725 134.001 46.9991 0 0 -90.6732 0 -91.3289 0 0 -357.832 0 0 0 -139.171 0z"/>
-   <glyph unicode="1" horiz-adv-x="600" d="M276 48.0013l0 518.161 0 0 -161.996 -77.1579 -18.0016 39.9933 195.826 93.0054 35.1697 0 0 0 0 -574.002 178.003 0 0 -48.0013 -203.497 0 -203.507 0 0 48.0013 178.003 0z"/>
-   <glyph unicode=" " horiz-adv-x="600" d=""/>
-   <glyph unicode="S" horiz-adv-x="600" d="M468.998 394.004c-3.33433,52.0006 -15.6695,87.4981 -36.9961,106.493 -21.336,19.0038 -59.6714,28.501 -114.838,28.501 -45.9969,0 -84.1638,-11.5016 -114.66,-34.3268 -30.3368,-23.0031 -45.5005,-51.6728 -45.5005,-86.1681 0,-33.1654 13.1594,-58.5007 39.4969,-76.0059 26.4967,-17.3273 70.0022,-29.166 130.666,-35.6661 76.3337,-8.16724 129.337,-22.9938 158.999,-44.8262 29.166,-21.5046 43.8334,-56.1685 43.8334,-104.001 0,-47.8327 -19.8374,-87.5075 -59.6621,-118.837 -39.834,-31.4982 -90.0082,-47.1677 -150.504,-47.1677 -58.8379,0 -109.331,13.0001 -151.169,39.0004 -9.16941,5.83508 -16.8309,7.33366 -22.9938,4.66432 -6.17226,-2.82856 -10.3402,-9.66582 -12.6723,-20.8302l-4.83291 -24.8295 -47.1677 4.83291c5.4979,33.4932 7.83943,62.3314 6.83725,86.3274 -1.33935,24.0053 -6.17226,52.6656 -14.8359,85.8403l46.9991 6.33149c6.17226,-43.337 24.6703,-76.0059 55.3349,-98.1661 30.6646,-22.1696 72.9994,-33.1654 126.499,-33.1654 53.6678,0 96.3304,10.3308 127.838,30.9924 31.4982,20.671 47.3269,48.6663 47.3269,83.836 0,33.6711 -10.4994,56.8335 -31.4982,70.0022 -21.1674,12.663 -65.8343,22.666 -133.664,30.1682 -71.173,7.83006 -123.67,24.8295 -157.5,50.8298 -33.5025,26.0003 -50.3334,62.8372 -50.3334,110.333 0,49.4999 20.1652,90.5046 60.4957,123.005 40.3398,32.5004 91.1696,48.8255 152.34,48.8255 52.497,0 97.1639,-11.998 134.329,-36.1625 9.16941,-6.1629 16.8309,-7.99865 23.0031,-5.32931 6.1629,2.49138 10.1622,9.16005 12.1666,19.9966l3.50292 18.4981 40.499 -6.33149c-10.1716,-30.3368 -16.0067,-59.1657 -17.6738,-86.6645 -1.66717,-27.3397 0.833583,-56.6649 7.33366,-88.0039l-50.9984 -1.99498z"/>
-  </font>
-  <style type="text/css">
-   <![CDATA[
-    @font-face { font-family:"CourierPS";font-variant:normal;font-weight:normal;src:url("#FontID0") format(svg)}
-    .fil1 {fill:#2F435F}
-    .fil0 {fill:#2F435F;fill-rule:nonzero}
-    .fnt0 {font-weight:normal;font-size:1067.68px;font-family:'CourierPS'}
-   ]]>
-  </style>
- </defs>
- <g id="Слой_x0020_1">
-  <metadata id="CorelCorpID_0Corel-Layer"/>
-  <g id="_2473141620144">
-   <g id="Comazo_x0020_логотип.eps">
-    <path class="fil0" d="M1104.42 4031.09c-156.47,0 -285.52,-44.21 -386.71,-132.86 -101.35,-88.67 -152.13,-202.58 -152.13,-341.73 0,-118.24 34.46,-213.7 103.96,-286.24 69.22,-72.56 155.44,-108.51 258.82,-108.51 78.48,0 164.6,31.35 259.01,94.24 94.49,62.99 165.72,100.72 213.9,113.12 48.16,12.5 96.35,18.57 144.61,18.57 17.08,0 32.54,-0.73 47.11,-2.49 14.56,-1.64 28.95,-3.77 42.95,-6.16 28.29,-7.73 51.16,-16.64 69.41,-26.65 41.22,-24.29 61.69,-55.27 61.69,-93.24 0,-62.17 -61.69,-114.22 -184.86,-156.24 -62.09,-21.89 -131.49,-37.79 -208.04,-47.91 -76.73,-10.03 -162.65,-15.07 -257.73,-15.07 -313.25,0 -577.84,59.02 -793.32,177.64 -215.35,118.55 -323.09,262.45 -323.09,431.82 0,152.27 85.53,277.04 256.19,374.62 170.69,97.39 386.81,146.02 648.42,146.02 383.43,0 676.6,-94.33 878.83,-283.39l-123.46 -41.02c-176.76,123.69 -361.8,185.48 -555.56,185.48l0 0z"/>
-    <path class="fil0" d="M3335.71 3970.02c-71.36,56.03 -166.05,84.21 -284.32,84.21 -176.77,0 -316.06,-60.92 -418.26,-183.23 -102.43,-121.92 -153.39,-256.56 -153.39,-403.87 0,-98.57 35.23,-175.17 105.98,-229.52 70.85,-54.52 169.62,-81.83 296.95,-81.83 161.58,0 295.3,53.9 401.07,161.46 105.81,107.69 158.73,245.71 158.73,414.16 0,103 -35.72,182.44 -106.76,238.62zm385.92 -775.54c-191.12,-103.07 -433.52,-154.56 -727.56,-154.56 -305.05,0 -561.25,55.89 -768.9,167.99 -207.13,112.1 -310.93,249.46 -310.93,411.87 0,161.75 95.68,293.79 287.11,396.49 191.32,102.63 433.72,153.75 726.76,153.75 308.06,0 564.73,-55.69 770.64,-167.72 206.11,-112.27 309.09,-250.77 309.09,-415.81 0,-158.16 -95.57,-288.74 -286.21,-392.01z"/>
-    <path class="fil0" d="M7021.21 3237.06c178.31,0 267.6,97.18 267.6,291.68l0 228.59c0,107.16 -19.2,182.8 -57.14,227.68 -20.37,23.16 -45.09,40.46 -75.3,51.88 -30.01,11.58 -68.54,17.34 -114.59,17.34l0 87.05 1010.98 0 0 -87.05c-100.65,0 -165.65,-11.64 -195.78,-34.66 -29.91,-25.74 -44.48,-65.81 -44.48,-119.98l0 -412.06c0,-156.31 -36.57,-270.98 -108.98,-344.09 -72.79,-72.82 -186.88,-109.4 -343.16,-109.4 -230.04,0 -550.24,91.76 -960.54,274.74 -45.07,-182.98 -194.49,-274.74 -448.08,-274.74 -200.68,0 -511.17,91.76 -931.34,274.74l0 -304.75 -77.54 0 -722.64 153.59 0 63.08c139.98,30.88 220.29,54.06 240.96,69.52 23.92,15.53 36.01,37.32 36.01,65.73l0 513.94c0,68.03 -18.06,115.89 -53.37,143.27 -36.02,27.42 -100.24,41.07 -193.2,41.07l-24.22 0 0 87.05 1082.88 0 0 -87.05 -33.3 0c-170.05,0 -255.58,-55.79 -255.58,-168.32l0 -483.24c262.48,-110.42 466.34,-165.61 611.43,-165.61 174.07,0 261.1,85.52 261.1,256.92l0 376.47c0,71.08 -17.64,119.5 -52.67,145.45 -35.26,25.57 -98.21,38.33 -187.97,38.33l0 87.05 1004.72 0 0 -87.05c-160.57,0 -240.77,-58.57 -240.77,-176.05l0 -475.51c270.71,-110.42 472.17,-165.61 604.97,-165.61l0 0z"/>
-    <path class="fil0" d="M5522.94 1600.82l-447.24 666.44 -726.31 -538.3 286.69 1004.04 129.09 -73.04c119.11,-55.63 274.43,-100.25 465.66,-133.56 253.48,-47.98 559.01,-71.92 917.84,-71.92 348.09,0 654.76,24.37 919.08,73.1 93.05,17.19 180.52,37.71 262.08,61.7 81.46,24.05 149.35,48.01 203.4,72.05l127.81 71.67 287.68 -1004.04 -724.48 538.3 -447.34 -666.44 -626.8 650.76 -627.16 -650.76z"/>
-    <path class="fil0" d="M9301.61 3914.73c-126.25,73.8 -222.6,110.57 -290.49,110.57 -65.5,0 -117.63,-16.19 -155.75,-48.85 -21.15,-19.67 -36.49,-39.79 -45.47,-60.95 -9.27,-21.14 -13.46,-44.71 -13.46,-71.45 0,-65.77 21.74,-113.17 65.56,-141.7 44.11,-29.05 118.16,-57.75 222.52,-86.98 104.16,-28.88 176.66,-54.8 217.09,-77.07l0 376.43zm731.73 29.46c-46.43,23.18 -84.87,34.77 -114.38,34.77 -62.68,0 -93.95,-40.47 -93.95,-120.75l0 -497.2c0,-100.22 -74.9,-178.77 -224.34,-235.58 -150.02,-57.02 -308.99,-85.51 -477.55,-85.51 -142.96,0 -315.43,27.3 -517.32,81.83 -202.04,54.62 -302.81,133.15 -302.81,236.32 0,28.51 5.67,59.39 17.85,92.88l481.3 -101.97 -5.7 -20.79 0 -28.41c0,-103.73 77.25,-155.59 232.17,-155.59 76.66,0 141.24,17.56 194.24,51.86 52.69,34.95 78.76,76.14 78.76,124.05l0 97.74c-115.25,58.85 -281.49,110.07 -498.56,153.29 -216.77,43.31 -358.64,89.3 -424.57,138.03 -66.62,48.89 -99.54,109.98 -99.54,183.71 0,84.78 45.66,152.2 137,202.13 91.25,50.03 212.37,75.02 362.87,75.02 95.57,0 181.37,-11.59 257.82,-35.11 76.29,-23.56 167.66,-67.49 273.89,-132.79 33,108.14 132.99,162.32 300.27,162.32 63.62,0 143.77,-15.18 240.19,-45.54 96.24,-30.15 179.05,-67.13 247.73,-110.73l-65.37 -63.98z"/>
-    <path class="fil0" d="M12098.67 4141.28l200.57 -365.18 -131.85 0c-111.72,100.49 -195.86,162.39 -251.74,185.67 -56.32,22.98 -153.99,34.49 -294.53,34.49l-553.25 0 1147.47 -858.24 0 -74.95 -1438.72 0c-97.86,0 -146.9,-15.8 -146.9,-47.45l7.43 -22.25 -144.14 0 -139.47 439.28 139.47 0c76.19,-96.48 134.02,-157.15 174.05,-182.16 49.92,-28.15 115.47,-42.58 196.64,-42.58l598.51 0 -1136.88 847.91 0 85.46 1773.34 0z"/>
-    <path class="fil0" d="M13827.47 3970.02c-71.26,56.03 -165.79,84.21 -284.19,84.21 -176.55,0 -316.05,-60.92 -418.39,-183.23 -101.83,-121.92 -153.3,-256.56 -153.3,-403.87 0,-98.57 35.54,-175.17 106.2,-229.52 70.35,-54.52 169.71,-81.83 297.15,-81.83 160.99,0 294.71,53.9 400.72,161.46 105.59,107.69 158.68,245.71 158.68,414.16 0,103 -35.62,182.44 -106.87,238.62zm385.81 -775.54c-190.72,-103.07 -433.04,-154.56 -727.43,-154.56 -304.76,0 -560.87,55.89 -768.51,167.99 -207.47,112.1 -311.22,249.46 -311.22,411.87 0,161.75 95.68,293.79 287.47,396.49 191.33,102.63 433.22,153.75 726.71,153.75 307.55,0 564.33,-55.69 770.53,-167.72 205.88,-112.27 309.17,-250.77 309.17,-415.81 0,-158.16 -95.57,-288.74 -286.72,-392.01z"/>
-   </g>
-   <g transform="matrix(0.999999 0 0 1 -3225.78 1927.83)">
-    <text x="7250" y="3550"  class="fil1 fnt0">SINCE 1884</text>
-   </g>
-  </g>
- </g>
-</svg>
diff --git a/docs/public/assets/partners/h3.png b/docs/public/assets/partners/h3.png
deleted file mode 100644
index 257723c2..00000000
Binary files a/docs/public/assets/partners/h3.png and /dev/null differ
diff --git a/docs/public/assets/partners/openide.png b/docs/public/assets/partners/openide.png
deleted file mode 100644
index 82855b78..00000000
Binary files a/docs/public/assets/partners/openide.png and /dev/null differ
diff --git a/docs/public/assets/partners/pt.png b/docs/public/assets/partners/pt.png
deleted file mode 100644
index c9a3409f..00000000
Binary files a/docs/public/assets/partners/pt.png and /dev/null differ
diff --git a/docs/public/assets/partners/yadro.png b/docs/public/assets/partners/yadro.png
deleted file mode 100644
index bae4cb3d..00000000
Binary files a/docs/public/assets/partners/yadro.png and /dev/null differ
diff --git a/docs/public/docs/blog/finally-give-up-gin-echo.md b/docs/public/docs/blog/finally-give-up-gin-echo.md
deleted file mode 100644
index 8b13b6a4..00000000
--- a/docs/public/docs/blog/finally-give-up-gin-echo.md
+++ /dev/null
@@ -1,279 +0,0 @@
-# Finally Give Up Gin, Echo, and <Your Framework Here>
-
-## Introduction: Rethinking Traditions in the Go World
-
-In the world of Go development, choosing a framework often becomes a loyalty issue comparable to choosing between Apple and Android. Frameworks like Gin, Echo, and Beego have been faithful companions to developers for years, helping to quickly deploy projects and achieve early successes. They offered convenient tools and familiar work patterns, but over time it becomes evident that each has its own "language." This creates difficulties when transitioning between them or integrating with other systems.
-
-The situation worsens as projects grow and scalability and maintenance become critically important. Here, every incompatible component or diversity of approaches becomes an obstacle requiring additional resources and time. It's as if every time you switch from one framework to another, you move to a new house where even the familiar light switch isn't where your hand automatically reaches.
-
-### For those who want to delve deeper into the history and features of each framework, I suggest reviewing these detailed overviews and comparisons:
-
-- [Beego: An Overview and Comparison with Other Frameworks](https://medium.com/@eric.a.nugroho/beego-an-overview-and-comparison-with-other-framework-5211b08124ea)
-- [Building Microservice Using Golang Echo Framework](https://medium.com/cuddle-ai/building-microservice-using-golang-echo-framework-ff10ba06d508)
-- [Go with Gin](https://maneeshaindrachapa.medium.com/go-with-gin-83865cd5cd81)
-
-In this article, we'll explore why it's time to abandon the familiar diversity in favor of standardization and how gRPC-Gateway can become the "universal translator" capable of uniting the disparate dialects of Go frameworks into a single, universally understood language for microservice interaction.
-
-## Standardization, Standardization, and More Standardization
-
-When it comes to creating servers in Go, each framework offers its own set of rules and tools. Initially, this seems like a big plus: you can choose exactly what suits your specific needs and work style. However, imagine the complexity when you need to combine modules written using different frameworks in one project. It's comparable to trying to assemble a puzzle where each piece is produced by different manufacturers and doesn't fit with the others.
-
-Examples of Gin, Echo, and, heaven forbid, Beego often come up in developer conversations. They have undoubtedly had a huge impact on the Go community and have supported many projects at different stages of their lifecycle. Especially Gin, which has been a reliable tool for many for over 10 years. But modern development realities require flexibility and scalability, and being tied to one framework can seriously limit both of these characteristics.
-
-For example, if your project started using Echo and you want to integrate a third-party library written for Gin, you'll face the need to rewrite code or create "bridges" between API differences. This not only increases the workload but also adds additional complexity to code maintenance and updates.
-
-Standardization is the key to solving these problems. Transitioning to use gRPC and HTTP/2, as well as adopting tools like gRPC-Gateway, opens new horizons in terms of compatibility and universal communication. Think of gRPC-Gateway as a universal translator that allows you to speak the same language with different systems without getting into the specifics of each one.
-
-## Getting to Know gRPC-Gateway
-
-gRPC-Gateway is a magical bridge connecting the old world of RESTful JSON APIs and the modern world of gRPC. It allows your services to speak two languages, serving both traditional HTTP requests and powerful gRPC calls. This is especially convenient when you have diverse clients: some prefer to communicate via simple HTTP requests, while others use gRPC.
-
-Let's consider a real-life example: you manage a web service that provides weather information. Your data isn't just text; it's voluminous datasets from weather stations. Here, gRPC is perfect for transmitting this data with high speed and reliability. But your clients aren't just other servers; they're also mobile applications and web browsers that expect convenient and understandable JSON responses.
-
-This is where gRPC-Gateway comes into play: it transforms HTTP requests into gRPC calls and back, making your service accessible to everyone without the need to support two different APIs. All of this happens behind the scenes, and for the end user, it looks like normal interaction with a website or application.
-
-Sample code you might see without gRPC-Gateway looks something like this:
-
-```proto
-syntax = "proto3";
-
-package your.service.v1;
-
-option go_package = "github.com/yourorg/yourprotos/gen/go/your/service/v1";
-
-message StringMessage {
-  string value = 1;
-}
-
-service YourService {
-  rpc Echo(StringMessage) returns (StringMessage) {}
-}
-```
-
-Now let's add a bit of gRPC-Gateway "magic":
-
-```proto
-syntax = "proto3";
-package your.service.v1;
-option go_package = "github.com/yourorg/yourprotos/gen/go/your/service/v1";
-import "google/api/annotations.proto";
-
-message StringMessage {
-  string value = 1;
-}
-
-service YourService {
-  rpc Echo(StringMessage) returns (StringMessage) {
-      option (google.api.http) = {
-      post: "/v1/example/echo"
-      body: "*"
-    };
-  }
-}
-```
-
-These few lines allow you to automatically accept HTTP POST requests at `/v1/example/echo` and process them as gRPC calls. This is an example of how gRPC-Gateway simplifies developers' lives by providing a single, universally understood API.
-
-## Combining gRPC and HTTP Servers
-
-The ability to simultaneously use gRPC and HTTP in one application is like having both a sports car and an SUV at your disposal; you can enjoy speed and power when needed, and reliability and versatility at other times. gRPC-Gateway allows your service to easily switch between these two "transports," providing such flexibility.
-
-Let's look at a typical workflow:
-
-- *HTTP request*: The client sends an HTTP request that reaches gRPC-Gateway.
-- *Conversion to gRPC*: The Gateway parses the request, converts it to the corresponding gRPC call, and forwards it to the gRPC server.
-- *gRPC server processing*: The gRPC server processes the request and sends a response back to the Gateway.
-- *Conversion to HTTP*: The Gateway translates the gRPC response back to a format understandable by the HTTP client and sends it back.
-
-This process can be represented as a diagram:
-
-```mermaid
-sequenceDiagram
-    participant WebClient as Web Client
-    participant GRPCGateway as HTTP Server (gRPC-Gateway)
-    participant GRPCServer as gRPC Server
-
-    WebClient->>GRPCGateway: HTTP Request
-    GRPCGateway->>GRPCServer: gRPC Request
-    GRPCServer->>GRPCGateway: gRPC Response
-    GRPCGateway->>WebClient: HTTP Response
-```
-
-In real life, this looks like the following: when a user requests information through a web interface, their request goes through gRPC-Gateway, which translates it into a gRPC call. Then, after receiving a response from the gRPC service, the Gateway "translates" it back into an HTTP response and sends it to the user, ensuring a smooth and seamless interaction process.
-
-At the code level, this might look like:
-```go
-package main
-
-import (
-	"context"
-	"log"
-	"net"
-	"net/http"
-
-	"github.com/grpc-ecosystem/grpc-gateway/v2/runtime"
-	"golang.org/x/sync/errgroup"
-	"google.golang.org/grpc"
-	"google.golang.org/grpc/credentials/insecure"
-
-	echo "path/to/your/protobuf_package" 
-)
-
-const (
-	grpcServerEndpoint = "localhost:50051"
-	httpServerEndpoint = "localhost:8080"
-)
-
-type EchoService struct {
-	echo.UnimplementedEchoServiceServer
-}
-
-func (s *EchoService) Echo(ctx context.Context, in *echo.EchoRequest) (*echo.EchoResponse, error) {
-	return &echo.EchoResponse{Message: "Echo: " + in.Message}, nil
-}
-
-func main() {
-	g, ctx := errgroup.WithContext(context.Background())
-
-	g.Go(func() error {
-		return startGRPCServer(ctx)
-	})
-
-	g.Go(func() error {
-		return startHTTPServer(ctx)
-	})
-
-	if err := g.Wait(); err != nil {
-		log.Fatalf("Failed to start servers: %s", err)
-	}
-}
-
-func startGRPCServer(ctx context.Context) (err error) {
-	lis, err := net.Listen("tcp", grpcServerEndpoint)
-	if err != nil {
-		return err
-	}
-
-	s := grpc.NewServer()
-	echo.RegisterEchoServiceServer(s, &EchoService{})
-
-	go func() {
-		<-ctx.Done()
-		s.GracefulStop()
-	}()
-
-	log.Printf("Starting gRPC server on %s", grpcServerEndpoint)
-	return s.Serve(lis)
-}
-
-func startHTTPServer(ctx context.Context) (err error) {
-	mux := runtime.NewServeMux()
-	opts := []grpc.DialOption{grpc.WithTransportCredentials(insecure.NewCredentials())}
-	err = echo.RegisterEchoServiceHandlerFromEndpoint(ctx, mux, grpcServerEndpoint, opts)
-	if err != nil {
-		return err
-	}
-
-	srv := &http.Server{
-		Addr:    httpServerEndpoint,
-		Handler: mux,
-	}
-
-	go func() {
-		<-ctx.Done()
-		srv.Shutdown(ctx)
-	}()
-
-	log.Printf("Starting HTTP server on %s", httpServerEndpoint)
-	return srv.ListenAndServe()
-}
-```
-
-This simple example shows how you can ensure the operation of both gRPC and HTTP servers within a single application, giving users freedom of choice and providing developers with convenient tools for API management.
-
-## Benefits of Using gRPC-Gateway
-
-gRPC-Gateway doesn't just simplify development—it unlocks new possibilities for systems where compatibility and flexibility are required. This is especially important in modern microservice architectures where systems must interact with each other seamlessly and efficiently.
-
-## Single Source of Truth: One Schema for gRPC and RESTful API
-
-Using a single .proto file to describe both gRPC and RESTful APIs, we achieve unity and consistency of interfaces. This eliminates the need to maintain different API versions for different protocols, simplifying updates and reducing the chance of errors. If you make changes to the .proto file, they are automatically reflected in both the RESTful API and gRPC.
-
-## Reducing Code Duplication and Simplifying Maintenance
-
-Since gRPC-Gateway translates REST requests into gRPC calls, developers don't need to write separate implementations for each protocol. This frees up effort and time for creating additional features rather than duplicating existing functionality.
-
-## Automatic Generation of Client Code and OpenAPI (Swagger) Documentation
-
-gRPC-Gateway allows automatic generation of client libraries for various programming languages and API documentation in OpenAPI (Swagger) format. This not only speeds up the development process of client parts of the system but also ensures documentation is up-to-date, making API interaction transparent and understandable for all parties.
-
-```mermaid
-sequenceDiagram
-    participant Developer as Developer
-    participant ProtoFile as .proto file
-    participant CodeGen as Code Generator
-    participant ClientLib as Client Library
-    participant APIDocs as API Documentation
-
-    Developer->>ProtoFile: Defines API
-    ProtoFile->>CodeGen: Transfers API structure
-    CodeGen->>ClientLib: Generates code
-    CodeGen->>APIDocs: Generates documentation
-    APIDocs-->>Developer: Uses for integration
-    ClientLib-->>Developer: Uses for client development
-```
-
-An example benefit might look like this: imagine your team is implementing a new feature in the system. Previously, this would have required updating several API documents and implementations in different languages. Now, changes are made to a single .proto file, and all necessary updates are generated automatically.
-
-These benefits make gRPC-Gateway a powerful tool that can significantly simplify the development and maintenance process of microservice architectures, making them more modular, flexible, and easy to scale.
-
-## Disadvantages and Limitations of gRPC-Gateway
-
-Despite significant advantages, gRPC-Gateway is not without drawbacks, especially when it comes to complex use cases and integration with existing systems. Let's consider some of these limitations:
-
-## Limited Configuration and Customization
-
-gRPC-Gateway works great "out of the box" for many standard scenarios, but its customization capabilities may be insufficient for unique requirements. For example, complex routing requirements, fine-tuning security, or specific request handling may require additional effort and sometimes writing an additional proxy layer.
-
-```mermaid
-graph TD
-    A[Client Request] --> B[gRPC-Gateway]
-    B --> C{Route Check}
-    C -->|Route OK| D[gRPC Service]
-    C -->|Customization Required| E[Additional Proxy Layer]
-    E --> D
-    D --> F{gRPC Service Response}
-    F -->|Convert to HTTP| B
-```
-
-## Higher Entry Barrier for Beginners
-
-To effectively use gRPC-Gateway, developers need to learn not only the basics of REST and HTTP but also the specifics of working with gRPC and protobuf. This can create additional difficulties for beginners or teams accustomed to more traditional REST APIs.
-
-## Interaction with Other Tools and Libraries
-
-Integration with some monitoring, logging, or tracing tools can be difficult since gRPC-Gateway represents another layer of abstraction. Therefore, additional configuration or searching for specialized solutions compatible with gRPC may be required.
-
-## Insufficient Control Over HTTP-Specific Features
-
-Some HTTP-specific features, such as cache management, cookies, and redirects, may not be as easily implementable through gRPC-Gateway. This may require additional workarounds or development of additional code to control these aspects at the HTTP level.
-
-## File Transfer Issues
-
-File transfer can be problematic when using gRPC-Gateway. Due to gRPC specifics, large files must be split into many small parts for transmission, which can be inefficient and complex to implement. In some cases, a more traditional approach to file handling and transfer may be required.
-
-## Performance Impact
-
-Although gRPC-Gateway is relatively efficient, introducing an additional proxy layer can slightly increase request processing latency. In systems where every millisecond matters, this can become a critical factor.
-
-## Conclusion
-
-So, we've figured out that gRPC-Gateway isn't just another technical gadget. It's like a bridge between two worlds: the cozy island of REST and the swift continent of gRPC. And this bridge can lead us to something amazing—APIs that are easier to maintain, faster to work with, and friendlier to developers.
-
-## Some Reflections
-
-The world of technology doesn't stand still, and neither do we. Today, choosing gRPC-Gateway might seem like an innovation, but tomorrow it will already be part of the "good old classics." So if you feel it's time to expand horizons and explore new technologies, perhaps gRPC-Gateway is exactly what you need.
-
-## That's All... For Now!
-
-Don't be afraid to experiment and try new solutions. Perhaps gRPC-Gateway won't become a panacea for all your pains, but it can definitely become one of those tools you'll remember with gratitude. And what will happen tomorrow? Who knows, maybe we'll meet again at a new turn of technological evolution!
\ No newline at end of file
diff --git a/docs/public/docs/blog/working-with-proto-errors-correctly.md b/docs/public/docs/blog/working-with-proto-errors-correctly.md
deleted file mode 100644
index 369e32a0..00000000
--- a/docs/public/docs/blog/working-with-proto-errors-correctly.md
+++ /dev/null
@@ -1,223 +0,0 @@
-# Let's Work with Proto Errors Correctly :)
-
-## Protobuf Error Handling
-
-In programming, there are always several ways to solve the same problem. But not all of them are equally effective. Today, let's talk about ways to handle errors in gRPC — successful ones and not so much.
-
-```proto
-message Result {
-  oneof response {
-    error.v1.Error error = 1;
-    info.v1.Info info = 2;
-  }
-}
-```
-
-At first glance, it might seem that using oneof to represent either an error or a result is convenient. However, this approach introduces unnecessary complexity into the message exchange protocol and degrades code readability. gRPC provides built-in tools for working with errors that allow you to elegantly and efficiently convey error information.
-
-Why is using `oneof` for errors a bad idea? First, it makes it difficult to use gRPC's standard error mechanism and status codes, which are designed for this purpose. Second, it can lead to confusion on the client side when needing to distinguish successful responses from errors.
-
-```mermaid
-sequenceDiagram
-    participant Client as Client
-    participant Service as Service
-    Client->>Service: Query
-    alt Success
-      Service-->>Client: Info
-    else Error
-      Service-->>Client: Error
-    end
-```
-The diagram shows how handling two types of requests complicates the client logic
-
-## Error Codes in gRPC
-
-Error codes in gRPC architecture are especially important for effective interaction between client and server. They help the client understand the cause of the problem and respond appropriately.
-
-Proper and effective error management in gRPC plays a key role in creating reliable and maintainable systems. Using standard error codes and gRPC mechanisms not only simplifies error handling on the client side but also ensures clarity and predictability of system behavior. Instead of using constructs like oneof for error handling, it's better to use gRPC's built-in capabilities for transmitting detailed error information.
-
-Here's how you can use the gRPC code codes.NotFound to report that something is missing:
-
-```go
-import "google.golang.org/grpc/status"
-import "google.golang.org/grpc/codes"
-
-// ...
-
-err := status.Error(codes.NotFound, "couldn't find the cat")
-
-// ...
-```
-
-This approach simplifies error handling on the client side, which makes it easier to understand the response data structure. Additionally, errors returned via status.Error are converted to HTTP statuses when transported through gRPC-Gateway, making errors understandable even outside of gRPC.
-
-But what if we need more flexibility in the error response? For example, adding additional meta-information or custom error codes?
-
-The gRPC system itself has the ability to attach additional data to an error — and thus extend the problem context:
-
-```go
-import (
-  "google.golang.org/grpc/status"
-  "google.golang.org/grpc/codes"
-  "google.golang.org/genproto/googleapis/rpc/errdetails"
-)
-
-// ...
-
-st := status.New(codes.InvalidArgument, "invalid parameter")
-// General error form
-errInfo := &errdetails.ErrorInfo{
-	Reason: "Insufficient funds in account",
-	Domain: "finance",
-	Metadata: map[string]string{
-		"my_meta_info": "my_meta_details",
-	},
-}
-
-st, err := st.WithDetails(errInfo)
-if err != nil {
-	return fmt.Sprintf("st.WithDetails: %w", err)
-}
-
-return st.Err()
-```
-
-But in cases when you want to get more detailed errors — for example, specifying the problematic field. In such cases, you can use the BadRequest type and provide more details about the error.
-
-## Defining and Using Custom Errors
-
-But! What if the standard details options don't fit? We can create our own error types! :)
-
-First, let's define a custom error in a proto file. We need to create a CustomErrorDetail error message. It will contain information about errors related to user data:
-
-```proto
-syntax = "proto3";
-
-package myerrors;
-
-message CustomErrorDetail {
-  string reason = 1;
-  string field = 2;
-  string help = 3;
-}
-```
-
-Now that we have the custom error definition, we can use it to pass more specific and detailed error information. This is especially useful when you need to point to specific fields or parameters that caused the error. Creating and using such CustomErrorDetail in server code allows not only reporting problems but also providing the client with recommendations for fixing them, making the interaction more transparent and efficient.
-
-```go
-import (
-  "google.golang.org/grpc/status"
-  "google.golang.org/grpc/codes"
-  "google.golang.org/protobuf/types/known/anypb"
-  "myerrors"
-)
-
-// ...
-
-customErrorDetail := &myerrors.CustomErrorDetail{
-    Reason: "Value out of range",
-    Field: "age",
-    Help: "The age must be between 0 and 120",
-}
-
-st := status.New(codes.InvalidArgument, "invalid parameter")
-st, err = st.WithDetails(customErrorDetail)
-if err != nil {
-    return fmt.Sprintf("Unexpected error attaching custom error detail: %w", err)
-}
-
-return st.Err()
-```
-
-## Working from the Client Side
-
-Now let's look at how the client side will interact with the gRPC error handling system we described earlier.
-
-### Handling Standard Errors
-
-When a client receives a response from a gRPC server, it can check for errors using standard gRPC mechanisms, for example:
-
-```go
-import (
-  "context"
-  "google.golang.org/grpc"
-  "google.golang.org/grpc/codes"
-  "google.golang.org/grpc/status"
-  "log"
-)
-
-func main() {
-  conn, err := grpc.Dial("localhost:50051", grpc.WithInsecure())
-  if err != nil {
-    log.Fatalf("did not connect: %v", err)
-  }
-  defer conn.Close()
-
-  client := NewYourServiceClient(conn)
-  response, err := client.YourMethod(context.Background(), &YourRequest{})
-  if err != nil {
-    st, ok := status.FromError(err)
-    if ok {
-      switch st.Code() {
-      case codes.InvalidArgument:
-        log.Println("Invalid argument error:", st.Message())
-      case codes.NotFound:
-        log.Println("Not found error:", st.Message())
-      // Handle other error codes as necessary
-      default:
-        log.Println("Unexpected error:", st.Message())
-      }
-    } else {
-      log.Fatalf("failed to call YourMethod: %v", err)
-    }
-  } else {
-    log.Println("Response:", response)
-  }
-}
-```
-
-### Extracting Additional Error Details
-
-And now for the most interesting part: for the client side to extract details for analysis, we need to process these details.
-
-Here's how it can be done:
-
-```go
-import (
-  "google.golang.org/grpc/status"
-  "google.golang.org/genproto/googleapis/rpc/errdetails"
-  "myerrors"
-  "log"
-)
-
-// ...
-
-func handleError(err error) {
-  st, ok := status.FromError(err)
-  if !ok {
-    log.Fatalf("An unexpected error occurred: %v", err)
-  }
-
-  for _, detail := range st.Details() {
-    switch t := detail.(type) {
-    case *errdetails.BadRequest:
-      // Handle bad request details
-      for _, violation := range t.GetFieldViolations() {
-        log.Printf("The field %s was wrong: %s\\n", violation.GetField(), violation.GetDescription())
-      }
-    case *myerrors.CustomErrorDetail:
-      // Handle custom error details
-      log.Printf("Custom error detail: Reason: %s, Field: %s, Help: %s\\n", t.Reason, t.Field, t.Help)
-    // Add handling for other error types as necessary
-    default:
-      log.Printf("Received an unknown error detail type: %v\\n", t)
-    }
-  }
-}
-```
-
-### Conclusion
-
-We've covered how to use standard gRPC error codes, how to add additional data to errors, and how to create and handle custom errors. These approaches allow for more flexible and detailed error handling, which is especially important for complex systems where a simple error message may be insufficient.
-
-When designing an API, it's important to remember that the client side should be able to easily and unambiguously interpret server responses. Using standard gRPC mechanisms for errors helps achieve this goal, improving the interaction between client and server and making the system as a whole more robust and understandable.
diff --git a/docs/public/docs/guide/api-service/overview.md b/docs/public/docs/guide/api-service/overview.md
deleted file mode 100644
index c4a5d466..00000000
--- a/docs/public/docs/guide/api-service/overview.md
+++ /dev/null
@@ -1,312 +0,0 @@
-# API Service Overview
-
-**Centralized protobuf plugin execution service for consistent, isolated code generation**
-
-The EasyP API Service eliminates plugin management chaos by providing centralized execution of protobuf/gRPC plugins as isolated Docker containers. It offers a unified platform for teams to standardize their code generation workflows without the operational overhead of managing plugins across individual developer machines.
-
-## Why EasyP API Service?
-
-### The Challenge
-
-Managing protobuf/gRPC code generation across development teams creates significant operational complexity:
-
-#### Version Inconsistencies
-- Developers use different plugin versions locally, causing build failures and inconsistent generated code
-- "Works on my machine" syndrome when generated code differs between environments
-- Manual coordination required to keep entire teams synchronized on plugin versions
-
-#### Operational Overhead
-- DevOps teams spend significant time managing plugin installations across developer machines
-- Each new team member requires manual setup of correct plugin versions
-- Plugin updates require coordinating with every developer individually
-- No centralized control over which plugin versions are approved for use
-
-#### Security & Compliance Risks
-- Developers install plugins from various sources without security validation
-- No audit trail of which plugins were used for which builds
-- Difficult to enforce security policies on code generation tools
-
-### The Solution: Centralized Plugin Execution
-
-EasyP API Service eliminates these operational headaches by centralizing plugin management:
-
-| Challenge | Solution |
-|-----------|----------|
-| **Version Control** | Deploy new plugin versions to entire team instantly via Docker images |
-| **Operations** | Operations team controls plugin configurations without touching developer machines |
-| **Security** | All plugins run in isolated Docker containers with resource constraints |
-| **Consistency** | Consistent execution environment regardless of developer's local setup |
-| **Developer Experience** | No local plugin installation or maintenance required |
-
-## Architecture Overview
-
-The EasyP API Service uses a streamlined architecture focused on reliable plugin execution:
-
-```mermaid
-graph TB
-    subgraph "Client Layer"
-        CLI[EasyP CLI]
-    end
-    
-    subgraph "EasyP API Service"
-        GRPC[gRPC Server]
-        CORE[Core Engine]
-        METRICS[Metrics Collector]
-    end
-    
-    subgraph "Plugin Execution"
-        DOCKER[Docker Runtime]
-        REGISTRY[Docker Hub Registry]
-    end
-    
-    subgraph "Storage"
-        DB[(PostgreSQL)]
-    end
-    
-    subgraph "Monitoring"
-        PROM[Prometheus]
-    end
-    
-    CLI -->|CodeGeneratorRequest| GRPC
-    GRPC --> CORE
-    
-    CORE -->|Fetch plugin params| DB
-    CORE -->|Execute plugin| DOCKER
-    CORE -->|Record metrics| METRICS
-    
-    DOCKER -->|Pull images| REGISTRY
-    
-    METRICS --> PROM
-```
-
-## Key Components
-
-### API Layer
-- **gRPC Server**: Primary API for code generation requests
-- Each plugin execution is a separate gRPC request
-- Receives `CodeGeneratorRequest` from CLI
-
-### Execution Engine
-- **Docker Runtime**: Isolated container execution for plugins
-- Pulls plugin images from public Docker registries (Docker Hub, etc.)
-- Enforces resource limits (CPU, memory) per plugin
-
-### Storage Layer
-- **PostgreSQL**: Stores plugin execution parameters
-  - Resource limits (CPU, memory allocation)
-  - Plugin configuration and metadata
-  - Execution logs for auditing
-  - _Note: Storage capabilities will be expanded in future releases_
-
-### Monitoring
-- **Prometheus**: Metrics collection and monitoring
-- Tracks execution times, success rates, and resource usage
-
-## How It Works
-
-### Local Execution (EasyP CLI)
-When running locally, the EasyP CLI supports:
-- **Installed plugins**: System-installed protoc plugins
-- **WASM plugins**: Fast, lightweight WebAssembly plugins
-
-### Remote Execution (API Service)
-When using the API Service:
-- **Docker only**: All plugins run as Docker containers
-- **Centralized control**: Operations team manages available plugins
-- **Consistent environment**: Same execution environment for all developers
-
-## Plugin Execution Flow
-
-```mermaid
-sequenceDiagram
-    participant CLI as EasyP CLI
-    participant API as gRPC Server
-    participant DB as PostgreSQL
-    participant Docker as Docker Engine
-    participant Registry as Docker Registry
-    
-    Note over CLI: Parse protobuf files
-    CLI->>API: CodeGeneratorRequest (per plugin)
-    
-    API->>DB: Fetch plugin parameters
-    Note over DB: CPU/memory limits<br/>Docker image name<br/>Execution config
-    DB-->>API: Plugin execution params
-    
-    API->>Docker: Pull plugin image (if needed)
-    Docker->>Registry: Download image
-    Registry-->>Docker: Plugin image
-    
-    API->>Docker: Run plugin container
-    Note over Docker: Isolated execution<br/>Resource limits applied
-    Docker-->>API: CodeGeneratorResponse
-    
-    API->>PROM: Record metrics
-    Note over PROM: Execution time<br/>Success/failure<br/>Resource usage
-    
-    API-->>CLI: CodeGeneratorResponse
-```
-
-### Execution Steps
-
-1. **CLI Parsing**: CLI parses protobuf files locally
-2. **Request Sending**: CLI sends `CodeGeneratorRequest` to API Service (one request per plugin)
-3. **Parameter Lookup**: API Service fetches plugin execution parameters from PostgreSQL
-4. **Docker Execution**: API Service runs plugin in isolated Docker container
-5. **Metrics Recording**: Execution metrics are recorded (at end of request)
-6. **Response**: Generated code is returned to CLI
-
-## Key Features
-
-| Feature | Description |
-|---------|-------------|
-| **🐳 Plugin Isolation** | Each plugin runs in a secure, isolated Docker container |
-| **⚙️ Resource Control** | CPU and memory limits enforced per plugin |
-| **📊 Metrics & Monitoring** | Prometheus metrics for all operations |
-| **🔄 Version Management** | Centralized plugin version control via Docker images |
-| **⚡ Simple Protocol** | Standard `CodeGeneratorRequest/Response` protocol |
-| **🔒 Security First** | Container isolation with resource constraints |
-
-## Configuration
-
-The service is configured via environment variables:
-
-### Server Configuration
-```bash
-EASYP_SERVICE_HOST=0.0.0.0
-EASYP_SERVICE_GRPC_PORT=8080
-```
-
-### Database Configuration
-```bash
-EASYP_SERVICE_DB_HOST=localhost
-EASYP_SERVICE_DB_PORT=5432
-EASYP_SERVICE_DB_NAME=easyp_service
-EASYP_SERVICE_DB_USER=easyp
-EASYP_SERVICE_DB_PASSWORD=password
-```
-
-### Docker Configuration
-```bash
-# Docker socket for container execution
-DOCKER_HOST=unix:///var/run/docker.sock
-```
-
-## Plugin Parameters Storage
-
-PostgreSQL stores execution parameters for each plugin:
-
-```sql
--- Example plugin configuration
-{
-  "plugin_name": "protobuf/go:v1.36.10",
-  "docker_image": "easyp/protoc-gen-go:v1.36.10",
-  "resources": {
-    "cpu_limit": "1.0",
-    "memory_limit": "512MB"
-  },
-  "execution_config": {
-    "timeout": "30s",
-    "network": "none"
-  }
-}
-```
-
-::: tip
-The storage schema and capabilities will be expanded in future releases to support additional features like audit logging, usage analytics, and plugin caching.
-:::
-
-## Integration with EasyP CLI
-
-Configure your `easyp.yaml` to use remote plugin execution:
-
-```yaml
-generate:
-  plugins:
-    # Remote plugin execution via API Service
-    - remote: api.easyp.tech/protobuf/go:v1.36.10
-      out: .
-      opts:
-        paths: source_relative
-    
-    - remote: api.easyp.tech/grpc/go:v1.5.1
-      out: .
-      opts:
-        paths: source_relative
-```
-
-Then generate code:
-
-```bash
-easyp generate
-```
-
-The CLI will:
-1. Parse your protobuf files
-2. Send separate requests to API Service for each plugin
-3. Receive generated code responses
-4. Write generated files to specified output directories
-
-## Available Metrics
-
-Prometheus metrics exposed by the service:
-
-| Metric | Description |
-|--------|-------------|
-| `easyp_api_service_api_grpc_server_handled_total` | Total gRPC requests by status code |
-| `easyp_api_service_api_grpc_server_handling_seconds` | gRPC request latency histogram |
-| `easyp_api_service_generated_plugin_code_total` | Plugin executions by plugin name |
-| `easyp_api_service_repo_call_duration_seconds` | Database query latency |
-| `easyp_api_service_repo_errors_total` | Database errors count |
-| `easyp_api_service_standard_panics_total` | Recovered panics count |
-
-## Performance Characteristics
-
-| Metric | Typical Value | Notes |
-|--------|---------------|-------|
-| **Cold Start** | 2-5 seconds | First time pulling plugin image |
-| **Warm Start** | 100-500ms | Plugin image cached by Docker |
-| **Throughput** | 20-50 concurrent | Depends on available resources |
-| **Memory Usage** | 50-200MB | Per plugin execution |
-
-## Security
-
-### Container Isolation
-- Each plugin runs in a separate, ephemeral container
-- No network access during plugin execution
-- Resource limits (CPU, memory) enforced via Docker
-- Containers destroyed after execution
-
-### API Security
-- gRPC-based communication
-- Support for authentication tokens (production deployments)
-- Input validation for all requests
-- Execution audit logs stored in PostgreSQL
-
-## Production Considerations
-
-### Scalability
-- **Horizontal scaling**: Deploy multiple service instances behind load balancer
-- **Resource management**: Configure appropriate CPU/memory limits per plugin
-- **Database**: PostgreSQL can be replicated for high availability
-
-### Monitoring
-- **Prometheus metrics**: Monitor all aspects of service health
-- **Alerting**: Set up alerts for high error rates or slow execution
-- **Logs**: Structured logging for debugging and audit trails
-
-### Future Enhancements
-The API Service is actively developed with planned features including:
-- Plugin result caching for faster repeated executions
-- Enhanced audit logging and usage analytics
-- Support for custom plugin registries
-- Advanced resource scheduling and optimization
-
-## Community and Support
-
-- **💬 [Telegram Chat](https://t.me/easyptech)** - Community discussion
-- **🐛 [GitHub Issues](https://github.com/easyp-tech/service/issues)** - Bug reports and features
-- **📖 [Documentation](https://easyp.tech)** - Complete documentation
-
----
-
-*Simplify your protobuf workflows with centralized plugin execution*
\ No newline at end of file
diff --git a/docs/public/docs/guide/ci-cd/github-actions.md b/docs/public/docs/guide/ci-cd/github-actions.md
deleted file mode 100644
index 183d6073..00000000
--- a/docs/public/docs/guide/ci-cd/github-actions.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Github Actions
-
-## Work in progress
\ No newline at end of file
diff --git a/docs/public/docs/guide/ci-cd/gitlab.md b/docs/public/docs/guide/ci-cd/gitlab.md
deleted file mode 100644
index 2de4597c..00000000
--- a/docs/public/docs/guide/ci-cd/gitlab.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Gitlab
-
-## Work in progress
\ No newline at end of file
diff --git a/docs/public/docs/guide/cli/auto-completion/auto-completion.md b/docs/public/docs/guide/cli/auto-completion/auto-completion.md
deleted file mode 100644
index ad650b77..00000000
--- a/docs/public/docs/guide/cli/auto-completion/auto-completion.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# Auto completion
-
-## zsh auto-completion
-
-1. Add the following line to your ~/.zshrc startup script:
-
-```bash
-source <(easyp completion zsh)
-```
-
-2. Re-launch your shell or run:
-
-```bash
-source ~/.zshrc
-```
-
-## Bash auto-completion
-
-1. Install [bash-completion](https://github.com/scop/bash-completion#installation) and add the software to your `~/.bashrc`.
-2. Add the following line to your ~/.bashrc startup script:
-
-```bash
-source <(easyp completion bash)
-```
-
-3. Re-launch your shell or run:
-
-```bash
-source ~/.bashrc
-```
-
diff --git a/docs/public/docs/guide/cli/breaking-changes/breaking-changes.md b/docs/public/docs/guide/cli/breaking-changes/breaking-changes.md
deleted file mode 100644
index db5be1ba..00000000
--- a/docs/public/docs/guide/cli/breaking-changes/breaking-changes.md
+++ /dev/null
@@ -1,456 +0,0 @@
-# Breaking Changes Detection
-
-[[toc]]
-
-EasyP's breaking changes detection helps you maintain backward compatibility in your protobuf APIs by automatically identifying changes that could break existing clients. This is crucial for maintaining stable APIs in production environments.
-
-## Overview
-
-The breaking changes checker compares your current protobuf files against a previous version (typically from another Git branch) and identifies modifications that could cause compatibility issues for existing clients.
-
-### Key Features
-
-- **Git-based Comparison**: Compare against any Git reference (branch, tag, or commit)
-- **Comprehensive Analysis**: Checks services, messages, enums, fields, and imports
-- **Selective Ignore**: Skip specific directories from breaking change analysis
-- **Detailed Reports**: Clear error messages with file locations and line numbers
-
-## How It Works
-
-The breaking changes detector follows this process:
-
-1. **Checkout Comparison Branch**: Retrieves proto files from the specified Git reference
-2. **Parse Both Versions**: Analyzes current and previous proto file structures
-3. **Compare Entities**: Systematically checks all protobuf elements for breaking changes
-4. **Generate Report**: Produces detailed issue reports with locations and descriptions
-
-## Detection Level
-
-EasyP implements **WIRE+ level** breaking change detection:
-- ✅ **Full wire format compatibility** - ensures old and new versions can exchange data
-- ✅ **Element deletion detection** - catches deleted services, messages, fields, etc.
-- ✅ **Type safety** - detects incompatible type changes
-- ❌ **Field/method renames** - currently not detected (planned for future releases)
-- ❌ **File-level changes** - package moves, file options not checked yet
-
-This provides strong compatibility guarantees while being less strict than some tools that check generated code compatibility.
-
-## Configuration
-
-Configure breaking changes detection in your `easyp.yaml`:
-
-```yaml
-breaking:
-  # Git reference to compare against (branch, tag, or commit hash)
-  against_git_ref: "main"
-  
-  # Directories to ignore during breaking changes analysis
-  ignore:
-    - "experimental"
-    - "internal/proto"
-    - "vendor"
-
-  # Additional options to braking check
-  use:
-    - FILE
-```
-
-### Configuration Options
-
-| Option            | Description                                  | Default | Required |
-|-------------------|----------------------------------------------|---------|----------|
-| `against_git_ref` | Git reference to compare against             | `"master"` | No |
-| `ignore`          | List of directories to exclude from analysis | `[]` | No |
-| `use`             | List of braking check options                | `[]` | No |
-
-## Usage
-
-### Basic Usage
-
-Compare current changes against the main branch:
-
-```bash
-easyp breaking --against main
-```
-
-### Using Configuration File
-
-With a custom configuration file:
-
-```bash
-easyp --cfg my-config.yaml breaking
-```
-
-### Override Git Reference
-
-Override the configured branch:
-
-```bash
-easyp breaking --against feature/new-api
-```
-
-## Detection Level
-
-EasyP currently implements **WIRE+ level** breaking change detection, which provides comprehensive wire format compatibility plus some generated code protections:
-
-### Comparison with Buf Categories
-
-| Check Type | Buf WIRE | Buf WIRE_JSON | Buf FILE | EasyP Current |
-|------------|----------|---------------|----------|---------------|
-| **Element Deletions** |
-| Service deletion | ❌ | ❌ | ✅ | ✅ |
-| RPC method deletion | ❌ | ❌ | ✅ | ✅ |
-| Message deletion | ❌ | ❌ | ✅ | ✅ |
-| Field deletion (by number) | ✅ | ✅ | ✅ | ✅ |
-| Enum deletion | ❌ | ❌ | ✅ | ✅ |
-| Enum value deletion | ✅ | ✅ | ✅ | ✅ |
-| OneOf deletion | ❌ | ❌ | ✅ | ✅ |
-| Import deletion | ❌ | ❌ | ✅ | ✅ |
-| **Type Changes** |
-| Field type change | ✅ | ✅ | ✅ | ✅ |
-| RPC request/response type | ✅ | ✅ | ✅ | ✅ |
-| Optional/required changes | ✅ | ✅ | ✅ | ✅ |
-| **Naming (Generated Code)** |
-| Field rename (same number) | ❌ | ✅ | ✅ | ❌ |
-| Enum value rename | ❌ | ✅ | ✅ | ✅ |
-| **File Structure** |
-| Package change | ✅ | ✅ | ✅ | ❌ |
-| File options (go_package, etc) | ❌ | ❌ | ✅ | ❌ |
-| Moving types between files | ❌ | ❌ | ✅ | ❌ |
-
-### What This Means
-
-**✅ EasyP WILL detect:**
-- All wire format breaking changes
-- Deletion of services, methods, messages, fields
-- Type changes that break serialization
-- Enum value renames (same number, different name)
-
-**❌ EasyP will NOT detect:**
-- Field renames (same number, different name)
-- Package name changes
-- File option changes (go_package, java_package, etc.)
-- Moving types between files in the same package
-
-## Breaking Change Rules
-
-EasyP detects the following types of breaking changes:
-
-### Comparison with Other Tools
-
-| Detection Level | Description | EasyP Support |
-|----------------|-------------|---------------|
-| **WIRE** | Wire format compatibility only | ✅ **Full support** |
-| **WIRE+** | Wire + element deletion detection | ✅ **Current level** |
-| **FILE** | Generated code compatibility | ✅ **Current level** |
-## Breaking Change Rules
-
-EasyP detects the following categories of breaking changes. Each rule has detailed documentation with examples:
-
-### 🚨 Service and RPC Changes
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [SERVICE_NO_DELETE](./rules/service-no-delete.md) | Services cannot be deleted | ✅ Implemented |
-| [RPC_NO_DELETE](./rules/rpc-no-delete.md) | RPC methods cannot be deleted | ✅ Implemented |
-| [RPC_SAME_REQUEST_TYPE](./rules/rpc-same-request-type.md) | RPC request types cannot be changed | ✅ Implemented |
-| [RPC_SAME_RESPONSE_TYPE](./rules/rpc-same-response-type.md) | RPC response types cannot be changed | ✅ Implemented |
-
-### 📦 Message and Field Changes
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [MESSAGE_NO_DELETE](./rules/message-no-delete.md) | Messages cannot be deleted | ✅ Implemented |
-| [FIELD_NO_DELETE](./rules/field-no-delete.md) | Fields cannot be deleted | ✅ Implemented |
-| [FIELD_SAME_TYPE](./rules/field-same-type.md) | Field types cannot be changed | ✅ Implemented |
-| [FIELD_SAME_CARDINALITY](./rules/field-same-cardinality.md) | Field optionality (optional/required) cannot be changed | ✅ Implemented |
-
-### 🔢 Enum Changes
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [ENUM_NO_DELETE](./rules/enum-no-delete.md) | Enums cannot be deleted | ✅ Implemented |
-| [ENUM_VALUE_NO_DELETE](./rules/enum-value-no-delete.md) | Enum values cannot be deleted | ✅ Implemented |
-| [ENUM_VALUE_SAME_NAME](./rules/enum-value-same-name.md) | Enum value names cannot be changed | ✅ Implemented |
-
-### 🔗 OneOf Changes
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [ONEOF_NO_DELETE](./rules/oneof-no-delete.md) | OneOf fields cannot be deleted | ✅ Implemented |
-| [ONEOF_FIELD_NO_DELETE](./rules/oneof-field-no-delete.md) | Fields within oneofs cannot be deleted | ✅ Implemented |
-| [ONEOF_FIELD_SAME_TYPE](./rules/oneof-field-same-type.md) | OneOf field types cannot be changed | ✅ Implemented |
-
-### 📥 Import Changes
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [IMPORT_NO_DELETE](./rules/import-no-delete.md) | Import statements cannot be removed | ✅ Implemented |
-
-## Not Currently Detected
-
-The following changes are **NOT detected** by EasyP (but may break generated code):
-
-| Change Type | Example | Impact |
-|-------------|---------|---------|
-| Field renaming | `string name = 1` → `string full_name = 1` | Generated code breaks |
-| Package changes | `package v1` → `package v2` | Import paths change |
-| File options | `option go_package = "old"` → `option go_package = "new"` | Generated code location |
-| Moving between files | Message moved to different .proto file | Import dependencies |
-
-## Detailed Rules Documentation
-
-For comprehensive examples and migration strategies, see the individual rule documentation:
-
-- **Service Changes**: [SERVICE_NO_DELETE](./rules/service-no-delete.md), [RPC_NO_DELETE](./rules/rpc-no-delete.md), [RPC_SAME_REQUEST_TYPE](./rules/rpc-same-request-type.md), [RPC_SAME_RESPONSE_TYPE](./rules/rpc-same-response-type.md)
-- **Message Changes**: [MESSAGE_NO_DELETE](./rules/message-no-delete.md), [FIELD_NO_DELETE](./rules/field-no-delete.md), [FIELD_SAME_TYPE](./rules/field-same-type.md), [FIELD_SAME_CARDINALITY](./rules/field-same-cardinality.md)
-- **Enum Changes**: [ENUM_NO_DELETE](./rules/enum-no-delete.md), [ENUM_VALUE_NO_DELETE](./rules/enum-value-no-delete.md), [ENUM_VALUE_SAME_NAME](./rules/enum-value-same-name.md)
-- **OneOf Changes**: [ONEOF_NO_DELETE](./rules/oneof-no-delete.md), [ONEOF_FIELD_NO_DELETE](./rules/oneof-field-no-delete.md), [ONEOF_FIELD_SAME_TYPE](./rules/oneof-field-same-type.md)
-- **Import Changes**: [IMPORT_NO_DELETE](./rules/import-no-delete.md)
-
-Each rule includes:
-- ❌ **Bad examples** with actual breaking changes
-- ✅ **Good alternatives** showing safe approaches  
-- 🔧 **Migration strategies** for handling necessary changes
-- 📋 **Real error messages** from EasyP
-
-## Quick Examples
-
-### ✅ Safe Changes (Always Allowed)
-```proto
-// Adding new elements is always safe
-message User {
-  string name = 1;
-  string email = 2;
-  string phone = 3;  // ✅ New field - safe
-}
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc GetUserProfile(GetUserRequest) returns (UserProfile);  // ✅ New RPC - safe
-}
-
-enum Status {
-  STATUS_UNSPECIFIED = 0;
-  STATUS_ACTIVE = 1;
-  STATUS_PENDING = 2;  // ✅ New enum value - safe
-}
-```
-
-### ❌ Breaking Changes (Always Detected)
-```proto
-// Deletions and type changes break compatibility
-message User {
-  string name = 1;
-  // ❌ Deleted field - BREAKING
-}
-
-service UserService {
-  // ❌ Deleted RPC method - BREAKING  
-  rpc GetUser(GetUserRequestV2) returns (GetUserResponse);  // ❌ Changed request type - BREAKING
-}
-```
-
-### Scenario 3: Breaking Changes (Currently Not Detected)
-
-```proto
-// 🟡 Breaks generated code but passes EasyP checks
-message User {
-  string user_name = 1;    // Renamed from "name"
-  string user_email = 2;   // Renamed from "email"
-}
-
-service UserService {
-  rpc GetUserProfile(GetUserRequest) returns (GetUserResponse);  // Renamed from GetUser
-}
-```
-
-## Output Format
-
-### Text Format (Default)
-
-```
-services.proto:45:1: Previously present RPC "DeleteUser" on service "UserService" was deleted. (BREAKING_CHECK)
-messages.proto:15:3: Previously present field "2" with name "email" on message "User" was deleted. (BREAKING_CHECK)
-```
-
-### JSON Format
-
-```bash
-easyp --format json breaking --against main
-```
-
-```json
-{
-  "path": "services.proto",
-  "position": {
-    "line": 45,
-    "column": 1
-  },
-  "source_name": "",
-  "message": "Previously present RPC \"DeleteUser\" on service \"UserService\" was deleted.",
-  "rule_name": "BREAKING_CHECK"
-}
-```
-
-## Best Practices
-
-### 1. Regular Checks
-Run breaking change detection in your CI/CD pipeline:
-
-```yaml
-# GitHub Actions example
-- name: Check for breaking changes
-  run: easyp breaking --against origin/main
-```
-
-### 2. Branch Protection
-Use breaking change checks to protect important branches:
-
-```yaml
-# Only allow PRs that don't introduce breaking changes
-if: github.event_name == 'pull_request'
-run: |
-  easyp breaking --against origin/main
-  if [ $? -eq 1 ]; then
-    echo "Breaking changes detected!"
-    exit 1
-  fi
-```
-
-### 3. Versioning Strategy
-When breaking changes are necessary:
-
-- Create a new package version (e.g., `myservice.v2`)
-- Maintain the old version during migration period
-- Use deprecation notices in the old version
-
-### 4. Ignore Patterns
-Use ignore patterns wisely:
-
-```yaml
-breaking:
-  ignore:
-    - "experimental/**"      # Experimental APIs
-    - "internal/**"          # Internal-only APIs
-    - "**/testing/**"        # Test utilities
-```
-
-## Common Issues and Solutions
-
-### Issue: "Repository does not exist"
-**Solution**: Ensure you're running the command in a Git repository with the specified branch available.
-
-### Issue: "Cannot find git ref"
-**Solution**: Verify the branch/tag name exists and is accessible:
-```bash
-git branch -a  # List all branches
-git tag        # List all tags
-```
-
-### Issue: False Positives in Generated Code
-**Solution**: Add generated directories to ignore list:
-```yaml
-breaking:
-  ignore:
-    - "generated/**"
-    - "**/pb/**"
-```
-
-### Issue: Large Number of Changes
-**Solution**: For major refactoring, consider:
-1. Creating a new API version
-2. Implementing changes incrementally
-3. Using feature flags for gradual rollout
-
-## Integration Examples
-
-### CI/CD Pipeline Integration
-
-#### GitHub Actions
-
-```yaml
-name: API Compatibility Check
-
-on:
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  breaking-changes:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          fetch-depth: 0  # Fetch full history
-      
-      - name: Install EasyP
-        run: |
-          curl -sSfL https://raw.githubusercontent.com/easyp-tech/easyp/main/install.sh | sh
-          
-      - name: Check for breaking changes
-        run: |
-          ./bin/easyp breaking --against origin/main
-```
-
-#### GitLab CI
-
-```yaml
-breaking-changes:
-  stage: test
-  image: easyp/lint:latest
-  script:
-    - git fetch origin main
-    - easyp breaking --against origin/main
-  rules:
-    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
-```
-
-### Pre-commit Hook
-
-```bash
-#!/bin/sh
-# .git/hooks/pre-push
-
-protected_branch='main'
-current_branch=$(git symbolic-ref HEAD | sed -e 's,.*/\(.*\),\1,')
-
-if [ $current_branch = $protected_branch ]; then
-    echo "Running breaking changes check..."
-    easyp breaking --against HEAD~1
-    if [ $? -eq 1 ]; then
-        echo "❌ Breaking changes detected. Push rejected."
-        exit 1
-    fi
-    echo "✅ No breaking changes detected."
-fi
-```
-
-## Troubleshooting
-
-### Debug Mode
-Enable debug logging for detailed information:
-
-```bash
-easyp --debug breaking --against main
-```
-
-### Manual Comparison
-For complex cases, you can manually inspect the comparison:
-
-```bash
-# Compare specific files
-git show main:path/to/file.proto > old_version.proto
-easyp lint old_version.proto  # Validate old version
-easyp lint current_file.proto  # Validate current version
-```
-
-### Performance Optimization
-For large repositories:
-
-```bash
-# Limit scope to specific paths
-easyp breaking --against main --path api/
-```
-
-The breaking changes detection in EasyP provides a robust foundation for maintaining API compatibility while allowing your protobuf schemas to evolve safely over time.
\ No newline at end of file
diff --git a/docs/public/docs/guide/cli/breaking-changes/rules/enum-no-delete.md b/docs/public/docs/guide/cli/breaking-changes/rules/enum-no-delete.md
deleted file mode 100644
index 2bd79b8f..00000000
--- a/docs/public/docs/guide/cli/breaking-changes/rules/enum-no-delete.md
+++ /dev/null
@@ -1,338 +0,0 @@
-# ENUM_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no enums are deleted from proto files. Deleting an enum breaks both wire format compatibility and generated code, as existing data may contain values from the deleted enum and client code depends on the generated enum types.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-enum UserRole { // [!code --]
-  USER_ROLE_UNSPECIFIED = 0; // [!code --]
-  USER_ROLE_ADMIN = 1; // [!code --]
-  USER_ROLE_USER = 2; // [!code --]
-} // [!code --]
-
-message Order {
-  string id = 1;
-  OrderStatus status = 2;
-  UserRole created_by_role = 3;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-// UserRole enum was deleted - BREAKING CHANGE!
-
-message Order {
-  string id = 1;
-  OrderStatus status = 2;
-  UserRole created_by_role = 3; // ERROR: UserRole no longer exists!
-}
-```
-
-**Error:**
-```
-user.proto:8:1: Previously present enum "UserRole" was deleted from file. (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Nested enum deletion:**
-
-```proto
-// Before
-message User {
-  string name = 1;
-  Status status = 2;
-  
-  enum Status { // [!code --]
-    STATUS_UNSPECIFIED = 0; // [!code --]
-    STATUS_ACTIVE = 1; // [!code --]
-    STATUS_INACTIVE = 2; // [!code --]
-  } // [!code --]
-}
-
-// After - BREAKING CHANGE!
-message User {
-  string name = 1;
-  Status status = 2;  // ERROR: Status enum deleted
-  
-  // Status nested enum was deleted
-}
-```
-
-### Good
-
-**Instead of deleting, deprecate the enum:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-enum UserRole {
-  option deprecated = true; // [!code focus]
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMIN = 1;
-  USER_ROLE_USER = 2;
-}
-
-message Order {
-  string id = 1;
-  OrderStatus status = 2;
-  UserRole created_by_role = 3 [deprecated = true]; // [!code focus]
-}
-```
-
-**Or replace with new enum:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-enum UserRole {
-  option deprecated = true; // [!code focus] // Old enum
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMIN = 1;
-  USER_ROLE_USER = 2;
-}
-
-enum UserPermission { // [!code focus] // New enum with better design
-  USER_PERMISSION_UNSPECIFIED = 0; // [!code focus]
-  USER_PERMISSION_READ = 1; // [!code focus]
-  USER_PERMISSION_WRITE = 2; // [!code focus]
-  USER_PERMISSION_ADMIN = 3; // [!code focus]
-} // [!code focus]
-
-message Order {
-  string id = 1;
-  OrderStatus status = 2;
-  UserRole created_by_role = 3 [deprecated = true]; // [!code focus] // Old field
-  UserPermission created_by_permission = 4; // [!code focus] // New field
-}
-```
-
-## Impact
-
-- **Wire Format:** Existing data with the deleted enum cannot be deserialized
-- **Generated Code:** Enum types/constants are removed, breaking client compilation
-- **Field References:** Fields using the deleted enum type become invalid
-- **Switch Statements:** Client code with enum switch cases breaks
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-order := &myapi.Order{
-    Id:            "order123",
-    Status:        myapi.OrderStatus_ORDER_STATUS_PENDING,
-    CreatedByRole: myapi.UserRole_USER_ROLE_ADMIN,  // ERROR after deletion
-}
-
-// Check role
-switch order.CreatedByRole {
-case myapi.UserRole_USER_ROLE_ADMIN:  // ERROR: undefined type
-    // Admin logic
-case myapi.UserRole_USER_ROLE_USER:   // ERROR: undefined type
-    // User logic
-}
-
-// Generated code compilation fails:
-// undefined: myapi.UserRole
-// undefined: myapi.UserRole_USER_ROLE_ADMIN
-```
-
-**Existing data becomes unreadable:**
-```json
-// Serialized data before deletion
-{
-  "id": "order123",
-  "status": "ORDER_STATUS_PENDING",
-  "created_by_role": "USER_ROLE_ADMIN"
-}
-
-// After UserRole deletion - deserialization fails
-// Parser doesn't know how to handle "created_by_role" field
-```
-
-**Server implementation breaks:**
-```go
-// Before - server handles enum
-func validateOrder(order *Order) error {
-    switch order.CreatedByRole {
-    case UserRole_USER_ROLE_ADMIN:  // ERROR: type not found
-        return nil  // Admins can create any order
-    case UserRole_USER_ROLE_USER:   // ERROR: type not found
-        // Additional validation for regular users
-        return validateUserOrder(order)
-    default:
-        return errors.New("invalid user role")
-    }
-}
-```
-
-## Migration Strategy
-
-1. **Deprecate the enum first:**
-   ```proto
-   enum OldEnum {
-     option deprecated = true;
-     // ... values
-   }
-   ```
-
-2. **Stop using in new fields** and deprecate existing fields:
-   ```proto
-   OldEnum old_field = 5 [deprecated = true];
-   ```
-
-3. **Create replacement** if needed:
-   ```proto
-   enum NewEnum {
-     // Better designed enum values
-   }
-   NewEnum new_field = 6;
-   ```
-
-4. **Update server code** to handle both during transition:
-   ```go
-   func handleRole(oldRole OldEnum, newRole NewEnum) {
-       // Handle both enum types during migration
-       if newRole != NEW_ENUM_UNSPECIFIED {
-           // Use new enum
-           return handleNewRole(newRole)
-       }
-       // Fall back to old enum
-       return handleOldRole(oldRole)
-   }
-   ```
-
-5. **Remove after migration period** in a new major version
-
-## Common Scenarios
-
-### Enum Redesign
-```proto
-// Instead of deleting old enum
-enum Priority {
-  option deprecated = true;  // Deprecate old design
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_HIGH = 2;
-}
-
-enum TaskPriority {  // Create new enum with better naming
-  TASK_PRIORITY_UNSPECIFIED = 0;
-  TASK_PRIORITY_LOW = 1;
-  TASK_PRIORITY_MEDIUM = 2;
-  TASK_PRIORITY_HIGH = 3;
-  TASK_PRIORITY_URGENT = 4;
-}
-```
-
-### Consolidating Enums
-```proto
-// Instead of deleting multiple enums
-enum Status {
-  option deprecated = true;  // Keep old enum
-  STATUS_UNSPECIFIED = 0;
-  STATUS_ACTIVE = 1;
-}
-
-enum State {
-  option deprecated = true;  // Keep old enum
-  STATE_UNSPECIFIED = 0;
-  STATE_ENABLED = 1;
-}
-
-enum EntityStatus {  // New consolidated enum
-  ENTITY_STATUS_UNSPECIFIED = 0;
-  ENTITY_STATUS_ACTIVE = 1;
-  ENTITY_STATUS_INACTIVE = 2;
-  ENTITY_STATUS_ENABLED = 3;
-  ENTITY_STATUS_DISABLED = 4;
-}
-```
-
-### Moving Enum to Different Package
-```proto
-// Instead of deleting from current package
-enum UserRole {
-  option deprecated = true;  // Mark as deprecated
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMIN = 1;
-}
-
-// Import from new location
-import "common/roles.proto";
-
-message Order {
-  UserRole old_role = 3 [deprecated = true];
-  common.UserRole new_role = 4;  // Reference from new package
-}
-```
-
-### Version Migration
-```proto
-// Clean approach - new package version
-package myapi.v2;
-
-// Redesigned enums without deprecated ones
-enum UserPermission {
-  USER_PERMISSION_UNSPECIFIED = 0;
-  USER_PERMISSION_READ = 1;
-  USER_PERMISSION_WRITE = 2;
-  USER_PERMISSION_ADMIN = 3;
-}
-
-message Order {
-  string id = 1;
-  UserPermission created_by_permission = 2;  // Clean design in v2
-}
-```
diff --git a/docs/public/docs/guide/cli/breaking-changes/rules/enum-value-no-delete.md b/docs/public/docs/guide/cli/breaking-changes/rules/enum-value-no-delete.md
deleted file mode 100644
index de6a62b1..00000000
--- a/docs/public/docs/guide/cli/breaking-changes/rules/enum-value-no-delete.md
+++ /dev/null
@@ -1,332 +0,0 @@
-# ENUM_VALUE_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no enum values are deleted from enums. Deleting an enum value breaks both wire format compatibility and generated code, as existing data may contain the deleted enum value and client code may reference the generated constants.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-  ORDER_STATUS_CANCELLED = 5;
-}
-
-enum Priority {
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_MEDIUM = 2;
-  PRIORITY_HIGH = 3;
-  PRIORITY_URGENT = 4;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-  // ORDER_STATUS_CANCELLED = 5; // [!code --] Deleted enum value - BREAKING!
-}
-
-enum Priority {
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_MEDIUM = 2;
-  PRIORITY_HIGH = 3;
-  // PRIORITY_URGENT = 4; // [!code --] Deleted enum value - BREAKING!
-}
-```
-
-**Error:**
-```
-order.proto:9:3: Previously present enum value "5" on enum "OrderStatus" was deleted. (BREAKING_CHECK)
-priority.proto:8:3: Previously present enum value "4" on enum "Priority" was deleted. (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Multiple value deletions:**
-
-```proto
-// Before
-enum UserRole {
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_GUEST = 1;
-  USER_ROLE_USER = 2;
-  USER_ROLE_MODERATOR = 3;
-  USER_ROLE_ADMIN = 4;
-  USER_ROLE_SUPERADMIN = 5;
-}
-
-// After - BREAKING CHANGES!
-enum UserRole {
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_USER = 2;
-  USER_ROLE_ADMIN = 4;
-  // USER_ROLE_GUEST = 1;      // BREAKING: deleted
-  // USER_ROLE_MODERATOR = 3;  // BREAKING: deleted  
-  // USER_ROLE_SUPERADMIN = 5; // BREAKING: deleted
-}
-```
-
-### Good
-
-**Instead of deleting, deprecate the enum values:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-  ORDER_STATUS_CANCELLED = 5 [deprecated = true]; // [!code focus]
-}
-
-enum Priority {
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_MEDIUM = 2;
-  PRIORITY_HIGH = 3;
-  PRIORITY_URGENT = 4 [deprecated = true]; // [!code focus]
-}
-```
-
-**Or reserve the enum values after removal:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  reserved 5; // [!code focus]
-  reserved "ORDER_STATUS_CANCELLED"; // [!code focus]
-  
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-enum Priority {
-  reserved 4; // [!code focus]
-  reserved "PRIORITY_URGENT"; // [!code focus]
-  
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_MEDIUM = 2;
-  PRIORITY_HIGH = 3;
-}
-```
-
-## Impact
-
-- **Wire Format:** Existing data with deleted enum values cannot be properly deserialized
-- **Generated Code:** Enum constants are removed, breaking client compilation
-- **Client Applications:** Code referencing deleted enum values fails to compile
-- **Switch Statements:** Case statements for deleted values cause compilation errors
-- **Default Handling:** Unknown enum values may be handled differently
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-order := &myapi.Order{
-    Status: myapi.OrderStatus_ORDER_STATUS_CANCELLED,  // ERROR after deletion
-}
-
-// Switch statement breaks
-switch order.Status {
-case myapi.OrderStatus_ORDER_STATUS_PENDING:
-    // Handle pending
-case myapi.OrderStatus_ORDER_STATUS_CANCELLED:  // ERROR: undefined constant
-    // Handle cancellation
-default:
-    // Handle unknown
-}
-
-// Generated code compilation fails:
-// undefined: myapi.OrderStatus_ORDER_STATUS_CANCELLED
-```
-
-**Existing data becomes problematic:**
-```json
-// Serialized data before deletion
-{
-  "id": "order123",
-  "status": "ORDER_STATUS_CANCELLED"
-}
-
-// After enum value deletion
-// Data deserializes but status becomes UNSPECIFIED (0)
-// or causes parsing errors depending on implementation
-```
-
-**Server validation breaks:**
-```go
-// Before - server handles all enum values
-func validateOrderStatus(status OrderStatus) error {
-    switch status {
-    case OrderStatus_ORDER_STATUS_PENDING,
-         OrderStatus_ORDER_STATUS_CONFIRMED,
-         OrderStatus_ORDER_STATUS_SHIPPED,
-         OrderStatus_ORDER_STATUS_DELIVERED,
-         OrderStatus_ORDER_STATUS_CANCELLED:  // ERROR: undefined
-        return nil
-    default:
-        return errors.New("invalid order status")
-    }
-}
-
-// Server logic that depends on cancelled status
-func canModifyOrder(order *Order) bool {
-    return order.Status != OrderStatus_ORDER_STATUS_CANCELLED  // ERROR: undefined
-}
-```
-
-## Migration Strategy
-
-1. **Deprecate enum values first:**
-   ```proto
-   ORDER_STATUS_CANCELLED = 5 [deprecated = true];
-   ```
-
-2. **Stop using deprecated values** in new code:
-   ```go
-   // Don't set deprecated values in new code
-   order.Status = OrderStatus_ORDER_STATUS_DELIVERED  // Use alternative
-   ```
-
-3. **Update client code** to handle deprecated values gracefully:
-   ```go
-   switch order.Status {
-   case OrderStatus_ORDER_STATUS_CANCELLED:
-       // Handle legacy cancelled orders
-       log.Warn("Processing deprecated cancelled status")
-       // Convert to new status or handle specially
-   }
-   ```
-
-4. **Reserve the values** after sufficient migration period:
-   ```proto
-   reserved 5, "ORDER_STATUS_CANCELLED";
-   ```
-
-5. **Never reuse enum numbers** - they must remain reserved permanently
-
-## Common Scenarios
-
-### Business Logic Changes
-```proto
-// Instead of deleting discontinued status
-enum ProductStatus {
-  PRODUCT_STATUS_UNSPECIFIED = 0;
-  PRODUCT_STATUS_ACTIVE = 1;
-  PRODUCT_STATUS_INACTIVE = 2;
-  // PRODUCT_STATUS_DISCONTINUED = 3;  // Don't delete!
-  
-  // Better approach:
-  PRODUCT_STATUS_DISCONTINUED = 3 [deprecated = true];
-}
-```
-
-### Workflow Simplification
-```proto
-// Instead of removing intermediate states
-enum TaskStatus {
-  TASK_STATUS_UNSPECIFIED = 0;
-  TASK_STATUS_TODO = 1;
-  TASK_STATUS_IN_PROGRESS = 2;
-  // TASK_STATUS_IN_REVIEW = 3;    // Don't delete intermediate states!
-  // TASK_STATUS_APPROVED = 4;     // Don't delete!
-  TASK_STATUS_DONE = 5;
-  
-  // Better approach:
-  TASK_STATUS_IN_REVIEW = 3 [deprecated = true];
-  TASK_STATUS_APPROVED = 4 [deprecated = true];
-}
-```
-
-### Enum Consolidation
-```proto
-// When merging similar enum values
-enum NotificationLevel {
-  NOTIFICATION_LEVEL_UNSPECIFIED = 0;
-  NOTIFICATION_LEVEL_INFO = 1;
-  NOTIFICATION_LEVEL_WARNING = 2;
-  NOTIFICATION_LEVEL_ERROR = 3;
-  // Don't delete these even if consolidating:
-  NOTIFICATION_LEVEL_DEBUG = 4 [deprecated = true];  // Keep deprecated
-  NOTIFICATION_LEVEL_TRACE = 5 [deprecated = true];  // Keep deprecated
-}
-```
-
-## Wire Format Considerations
-
-### Enum Value Reuse Prevention
-```proto
-enum Status {
-  // Never reuse numbers, even after deletion
-  reserved 2;  // Was STATUS_DELETED, now reserved forever
-  reserved "STATUS_DELETED";
-  
-  STATUS_UNSPECIFIED = 0;
-  STATUS_ACTIVE = 1;
-  // STATUS_DELETED = 2;  // This number can never be reused
-  STATUS_INACTIVE = 3;
-}
-```
-
-### JSON Compatibility
-```proto
-// JSON uses enum names, so both number and name should be reserved
-enum Color {
-  reserved 2;      // Reserve the number
-  reserved "RED";  // Reserve the name for JSON compatibility
-  
-  COLOR_UNSPECIFIED = 0;
-  COLOR_BLUE = 1;
-  // COLOR_RED = 2;  // Was deleted, now reserved
-  COLOR_GREEN = 3;
-}
-```
-
-### Proto2 vs Proto3 Behavior
-```proto
-// Proto2: Unknown enum values are preserved in unknown fields
-// Proto3: Unknown enum values are preserved as-is
-// Both cases: Don't delete values that might exist in stored data
-
-// Safe approach for both syntax versions:
-enum MyEnum {
-  MY_ENUM_UNSPECIFIED = 0;
-  MY_ENUM_VALUE_OLD = 1 [deprecated = true];  // Don't delete
-  MY_ENUM_VALUE_NEW = 2;
-}
-```
diff --git a/docs/public/docs/guide/cli/breaking-changes/rules/enum-value-same-name.md b/docs/public/docs/guide/cli/breaking-changes/rules/enum-value-same-name.md
deleted file mode 100644
index f05a8f56..00000000
--- a/docs/public/docs/guide/cli/breaking-changes/rules/enum-value-same-name.md
+++ /dev/null
@@ -1,173 +0,0 @@
-# ENUM_VALUE_SAME_NAME
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that enum values maintain the same name for each number. Changing an enum value's name (while keeping the same number) breaks both JSON compatibility and generated code, as clients expect specific constant names.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_APPROVED = 2; // [!code --] Changed from ORDER_STATUS_CONFIRMED
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_COMPLETED = 4; // [!code --] Changed from ORDER_STATUS_DELIVERED
-}
-```
-
-**Error:**
-```
-order.proto:7:3: Enum value "2" on enum "OrderStatus" changed name from "ORDER_STATUS_CONFIRMED" to "ORDER_STATUS_APPROVED". (BREAKING_CHECK)
-order.proto:9:3: Enum value "4" on enum "OrderStatus" changed name from "ORDER_STATUS_DELIVERED" to "ORDER_STATUS_COMPLETED". (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Multiple renames breaking clients:**
-
-```proto
-// Before
-enum UserRole {
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMIN = 1;
-  USER_ROLE_MODERATOR = 2;
-  USER_ROLE_USER = 3;
-}
-
-// After - ALL BREAKING CHANGES!
-enum UserRole {
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMINISTRATOR = 1;  // BREAKING: ADMIN -> ADMINISTRATOR
-  USER_ROLE_MOD = 2;           // BREAKING: MODERATOR -> MOD  
-  USER_ROLE_MEMBER = 3;        // BREAKING: USER -> MEMBER
-}
-```
-
-### Good
-
-**Instead of renaming, add new values and deprecate old ones:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2 [deprecated = true]; // [!code focus]
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4 [deprecated = true]; // [!code focus]
-  ORDER_STATUS_APPROVED = 5; // [!code focus] // New value instead of renaming
-  ORDER_STATUS_COMPLETED = 6; // [!code focus] // New value instead of renaming
-}
-```
-
-**Or create a new enum version:**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus] // New package version
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_APPROVED = 2; // [!code focus] // Clean names in v2
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_COMPLETED = 4; // [!code focus]
-}
-```
-
-## Impact
-
-- **Generated Code:** Constant names change, breaking client compilation
-- **JSON Compatibility:** JSON serialization uses enum names, breaking parsers
-- **Client Applications:** Code referencing old constant names fails to compile
-- **Documentation:** API docs become outdated with wrong enum names
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED
-if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED {
-    // handle delivery
-}
-
-// After rename - compilation fails
-status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED  // ERROR: undefined constant
-if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED {  // ERROR: undefined constant
-    // handle delivery
-}
-```
-
-**JSON compatibility breaks:**
-```json
-// Before - JSON uses old names
-{
-  "status": "ORDER_STATUS_CONFIRMED"
-}
-
-// After - parser expects new names
-{
-  "status": "ORDER_STATUS_APPROVED"  // Old JSON fails to parse
-}
-```
-
-## Migration Strategy
-
-1. **Add new enum values** instead of renaming:
-   ```proto
-   ORDER_STATUS_CONFIRMED = 2 [deprecated = true];
-   ORDER_STATUS_APPROVED = 5;  // New value
-   ```
-
-2. **Update server code** to handle both old and new values during transition
-
-3. **Migrate clients** to use new enum values
-
-4. **Remove deprecated values** in next major version:
-   ```proto
-   reserved 2, "ORDER_STATUS_CONFIRMED";
-   ORDER_STATUS_APPROVED = 5;
-   ```
-
-## Allow Alias Exception
-
-With `allow_alias = true`, you can temporarily have multiple names for the same value:
-
-```proto
-enum Status {
-  option allow_alias = true;
-  STATUS_UNSPECIFIED = 0;
-  STATUS_OLD_NAME = 1 [deprecated = true];
-  STATUS_NEW_NAME = 1;  // Same number, different name - allowed with alias
-}
-```
-
-Note: EasyP currently detects this as breaking even with `allow_alias`. This may be refined in future versions.
\ No newline at end of file
diff --git a/docs/public/docs/guide/cli/breaking-changes/rules/field-no-delete.md b/docs/public/docs/guide/cli/breaking-changes/rules/field-no-delete.md
deleted file mode 100644
index c1813cbf..00000000
--- a/docs/public/docs/guide/cli/breaking-changes/rules/field-no-delete.md
+++ /dev/null
@@ -1,100 +0,0 @@
-# FIELD_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no message fields are deleted. Deleting a field breaks both wire format compatibility and generated code, as existing data may contain the deleted field and client code may reference it.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-  string phone = 4; // [!code --]
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-  // phone field was deleted - BREAKING CHANGE!
-}
-```
-
-**Error:**
-```
-user.proto:6:3: Previously present field "4" with name "phone" on message "User" was deleted. (BREAKING_CHECK)
-```
-
-### Good
-
-**Instead of deleting, deprecate the field:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-  string phone = 4 [deprecated = true]; // [!code focus]
-}
-```
-
-**Or reserve the field number after removal:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  reserved 4; // [!code focus]
-  reserved "phone"; // [!code focus]
-  
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-}
-```
-
-## Impact
-
-- **Wire Format:** Old messages with the deleted field cannot be properly deserialized
-- **Generated Code:** Field accessors are removed, breaking client compilation
-- **Data Loss:** Existing serialized data loses information
-- **JSON Compatibility:** JSON parsers expect the field to exist
-
-## Migration Strategy
-
-1. **Deprecate first:**
-   ```proto
-   string old_field = 5 [deprecated = true];
-   ```
-
-2. **Stop writing to the field** in your application code
-
-3. **Reserve the field** in next version to prevent accidental reuse:
-   ```proto
-   reserved 5;
-   reserved "old_field";
-   ```
-
-4. **Never reuse field numbers** - they must remain reserved permanently
\ No newline at end of file
diff --git a/docs/public/docs/guide/cli/breaking-changes/rules/field-same-cardinality.md b/docs/public/docs/guide/cli/breaking-changes/rules/field-same-cardinality.md
deleted file mode 100644
index 82114adb..00000000
--- a/docs/public/docs/guide/cli/breaking-changes/rules/field-same-cardinality.md
+++ /dev/null
@@ -1,290 +0,0 @@
-# FIELD_SAME_CARDINALITY
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that message fields maintain the same cardinality (optionality). Changing a field's cardinality breaks both wire format compatibility and generated code, as the presence semantics and client code expectations differ between optional and required fields.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-}
-
-message CreateUserRequest {
-  string name = 1;
-  optional string email = 2;
-  string phone = 3;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  optional string email = 2; // [!code --] Changed from required to optional
-  int32 age = 3;
-}
-
-message CreateUserRequest {
-  string name = 1;
-  string email = 2; // [!code --] Changed from optional to required
-  string phone = 3;
-}
-```
-
-**Error:**
-```
-user.proto:6:3: Field "2" with name "email" on message "User" became optional. (BREAKING_CHECK)
-request.proto:7:3: Field "2" with name "email" on message "CreateUserRequest" became not optional. (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Proto2 to Proto3 migration issues:**
-
-```proto
-// Before (proto2)
-syntax = "proto2";
-
-message Order {
-  required string id = 1;
-  optional string notes = 2;
-  repeated string tags = 3;
-}
-
-// After (proto3) - BREAKING CHANGES!
-syntax = "proto3";
-
-message Order {
-  string id = 1;           // BREAKING: required -> implicit optional
-  string notes = 2;        // BREAKING: explicit optional -> implicit optional  
-  repeated string tags = 3; // OK: repeated unchanged
-}
-```
-
-### Good
-
-**Instead of changing cardinality, add new field:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2 [deprecated = true]; // [!code focus] // Keep original cardinality
-  int32 age = 3;
-  optional string email_optional = 4; // [!code focus] // New field with desired cardinality
-}
-
-message CreateUserRequest {
-  string name = 1;
-  optional string email = 2 [deprecated = true]; // [!code focus] // Keep original cardinality
-  string phone = 3;
-  string email_required = 4; // [!code focus] // New field with desired cardinality
-}
-```
-
-**Or create a new message version:**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus] // New package version
-
-message User {
-  string name = 1;
-  optional string email = 2; // [!code focus] // Clean cardinality in v2
-  int32 age = 3;
-}
-
-message CreateUserRequest {
-  string name = 1;
-  string email = 2; // [!code focus] // Required in v2
-  string phone = 3;
-}
-```
-
-## Impact
-
-- **Wire Format:** Field presence semantics change, breaking deserialization expectations
-- **Generated Code:** Field accessor methods change (hasField(), clearField())
-- **Validation:** Required field validation changes at runtime
-- **Default Values:** Optional vs required fields handle defaults differently
-
-## Real-World Example
-
-**Client code breaks with cardinality changes:**
-```go
-// Before - required field (proto3 implicit)
-user := &myapi.User{
-    Name:  "John",
-    Email: "john@example.com", // Must be set
-    Age:   30,
-}
-
-// Check if email is set (implicit presence)
-if user.Email != "" {
-    // Email is provided
-}
-
-// After - optional field (explicit presence) 
-user := &myapi.User{
-    Name: "John",
-    Age:  30,
-    // Email can be nil/unset
-}
-
-// Check if email is set (explicit presence)
-if user.Email != nil && *user.Email != "" {  // Different API!
-    // Email is provided
-}
-
-// Setting email also changes
-user.Email = &emailValue  // Pointer assignment vs direct
-```
-
-**Server validation breaks:**
-```go
-// Before - implicit required field
-func validateUser(user *User) error {
-    if user.Email == "" {  // Empty string check
-        return errors.New("email is required")
-    }
-    return nil
-}
-
-// After - explicit optional field
-func validateUser(user *User) error {
-    if user.Email == nil {  // Nil pointer check  
-        return errors.New("email is required")
-    }
-    if *user.Email == "" {  // Dereference to check empty
-        return errors.New("email cannot be empty")
-    }
-    return nil
-}
-```
-
-## Migration Strategy
-
-1. **Add new field** with correct cardinality:
-   ```proto
-   string old_email = 2 [deprecated = true];
-   optional string new_email = 5;  // New field with desired cardinality
-   ```
-
-2. **Dual-write period** - populate both fields during transition:
-   ```go
-   user := &User{
-       Name:     "John",
-       OldEmail: email,      // Legacy field
-       NewEmail: &email,     // New optional field
-   }
-   ```
-
-3. **Update clients** to use new field gradually:
-   ```go
-   // Check both fields during migration
-   email := user.NewEmail
-   if email == nil && user.OldEmail != "" {
-       emailValue := user.OldEmail
-       email = &emailValue  // Fallback to old field
-   }
-   ```
-
-4. **Remove old field** in next major version:
-   ```proto
-   reserved 2, "old_email";
-   optional string new_email = 5;
-   ```
-
-## Common Scenarios
-
-### Proto2 to Proto3 Migration
-```proto
-// Instead of direct syntax migration
-syntax = "proto3";
-message Order {
-  string id = 1;  // BREAKING: was required in proto2
-}
-
-// Maintain semantics during migration  
-syntax = "proto3";
-message Order {
-  string id = 1;  // Keep as implicit required
-  // Add explicit optional fields only when needed
-  optional string notes = 2;
-}
-```
-
-### Making Optional Fields Required
-```proto
-// Instead of changing existing field
-message CreateUserRequest {
-  string name = 1;
-  string email = 2;  // BREAKING: was optional
-}
-
-// Add new required field
-message CreateUserRequest {
-  string name = 1;
-  optional string email = 2 [deprecated = true];
-  string required_email = 3;  // New required field
-}
-```
-
-### Making Required Fields Optional
-```proto
-// Instead of changing existing field  
-message User {
-  optional string phone = 3;  // BREAKING: was required
-}
-
-// Add new optional field
-message User {
-  string phone = 3 [deprecated = true];  // Keep required
-  optional string phone_optional = 4;   // New optional field
-}
-```
-
-## Cardinality Types in Protobuf
-
-### Proto3 Cardinality
-- **Implicit optional**: `string name = 1;` (default in proto3)
-- **Explicit optional**: `optional string email = 2;` 
-- **Repeated**: `repeated string tags = 3;`
-- **Map**: `map<string, string> metadata = 4;`
-
-### Proto2 Cardinality  
-- **Required**: `required string id = 1;`
-- **Optional**: `optional string email = 2;`
-- **Repeated**: `repeated string tags = 3;`
-
-### Breaking Changes Matrix
-
-| From | To | Result |
-|------|----|---------| 
-| Required | Optional | ❌ BREAKING |
-| Optional | Required | ❌ BREAKING |
-| Implicit | Explicit | ❌ BREAKING |  
-| Explicit | Implicit | ❌ BREAKING |
-| Single | Repeated | ❌ BREAKING |
-| Repeated | Single | ❌ BREAKING |
-| Field | Map | ❌ BREAKING |
-| Map | Field | ❌ BREAKING |
\ No newline at end of file
diff --git a/docs/public/docs/guide/cli/breaking-changes/rules/field-same-type.md b/docs/public/docs/guide/cli/breaking-changes/rules/field-same-type.md
deleted file mode 100644
index 123255a6..00000000
--- a/docs/public/docs/guide/cli/breaking-changes/rules/field-same-type.md
+++ /dev/null
@@ -1,152 +0,0 @@
-# FIELD_SAME_TYPE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that message fields maintain the same type. Changing a field's type breaks wire format compatibility and generated code, as the binary representation and client code expectations differ between types.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message Product {
-  string name = 1;
-  int32 price = 2;
-  bool available = 3;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message Product {
-  string name = 1;
-  string price = 2; // [!code --] Changed from int32 to string
-  bool available = 3;
-}
-```
-
-**Error:**
-```
-product.proto:5:3: Field "2" with name "price" on message "Product" changed type from "int32" to "string". (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Incompatible type changes:**
-
-```proto
-// Before
-message Order {
-  string id = 1;
-  int64 timestamp = 2;
-  repeated string tags = 3;
-  OrderStatus status = 4;
-}
-
-// After - ALL BREAKING CHANGES!
-message Order {
-  int32 id = 1;           // string -> int32: BREAKING
-  string timestamp = 2;   // int64 -> string: BREAKING  
-  string tags = 3;        // repeated -> singular: BREAKING
-  int32 status = 4;       // enum -> int32: BREAKING
-}
-```
-
-### Good
-
-**Instead of changing type, add a new field:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message Product {
-  string name = 1;
-  int32 price = 2 [deprecated = true]; // [!code focus]
-  bool available = 3;
-  string price_formatted = 4; // [!code focus] // New field for string price
-}
-```
-
-**Or create a new message version:**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus] // New package version
-
-message Product {
-  string name = 1;
-  string price = 2; // [!code focus] // Now string in v2
-  bool available = 3;
-}
-```
-
-## Impact
-
-- **Wire Format:** Binary data cannot be deserialized correctly between versions
-- **Generated Code:** Field types change, breaking client compilation
-- **Runtime Errors:** Type mismatches cause parsing failures
-- **Data Corruption:** Incorrect interpretation of binary data
-
-## Common Type Change Issues
-
-### Numeric Types
-```proto
-// BREAKING: Different wire representations
-int32 -> int64   // Different encoding
-int32 -> uint32  // Different sign interpretation
-int32 -> string  // Completely different format
-```
-
-### Collection Types
-```proto
-// BREAKING: Structure changes
-string -> repeated string     // Singular to collection
-repeated int32 -> map<string, int32>  // Array to map
-```
-
-### Message Types
-```proto
-// BREAKING: Different message structure
-UserInfo -> UserProfile  // Different message types
-string -> UserInfo       // Scalar to message
-```
-
-## Migration Strategy
-
-1. **Add new field** with correct type:
-   ```proto
-   int32 old_price = 2 [deprecated = true];
-   string new_price = 5;  // New field
-   ```
-
-2. **Dual-write period** - populate both fields during transition
-
-3. **Update clients** to use new field
-
-4. **Remove old field** in next major version:
-   ```proto
-   reserved 2, "old_price";
-   string new_price = 5;
-   ```
-
-## Safe Type Changes (Wire Compatible)
-
-Note: EasyP currently treats ALL type changes as breaking. However, some changes are technically wire-compatible:
-
-- `int32` ↔ `uint32` (same encoding)
-- `int64` ↔ `uint64` (same encoding)  
-- `string` → `bytes` (if UTF-8 valid)
-
-These may be supported in future EasyP versions with different strictness levels.
\ No newline at end of file
diff --git a/docs/public/docs/guide/cli/breaking-changes/rules/import-no-delete.md b/docs/public/docs/guide/cli/breaking-changes/rules/import-no-delete.md
deleted file mode 100644
index b2f65259..00000000
--- a/docs/public/docs/guide/cli/breaking-changes/rules/import-no-delete.md
+++ /dev/null
@@ -1,411 +0,0 @@
-# IMPORT_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no import statements are deleted from proto files. Deleting an import breaks both wire format compatibility and generated code, as the imported types may be referenced in the current file and removing the import makes those types unavailable.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-import "google/protobuf/timestamp.proto";
-import "google/protobuf/duration.proto";
-import "common/user.proto";
-import "common/address.proto";
-
-message Order {
-  string id = 1;
-  google.protobuf.Timestamp created_at = 2;
-  google.protobuf.Duration processing_time = 3;
-  common.User customer = 4;
-  common.Address shipping_address = 5;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-import "google/protobuf/timestamp.proto";
-// import "google/protobuf/duration.proto";  // [!code --] Deleted import - BREAKING!
-// import "common/user.proto";               // [!code --] Deleted import - BREAKING!
-// import "common/address.proto";            // [!code --] Deleted import - BREAKING!
-
-message Order {
-  string id = 1;
-  google.protobuf.Timestamp created_at = 2;
-  google.protobuf.Duration processing_time = 3;  // ERROR: Duration not available
-  common.User customer = 4;                      // ERROR: User not available
-  common.Address shipping_address = 5;           // ERROR: Address not available
-}
-```
-
-**Error:**
-```
-order.proto:5:1: Previously import "google/protobuf/duration.proto" was deleted. (BREAKING_CHECK)
-order.proto:6:1: Previously import "common/user.proto" was deleted. (BREAKING_CHECK)
-order.proto:7:1: Previously import "common/address.proto" was deleted. (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Service definition breaks with deleted imports:**
-
-```proto
-// Before
-import "google/api/annotations.proto";
-import "google/protobuf/empty.proto";
-import "common/auth.proto";
-
-service OrderService {
-  rpc GetOrder(GetOrderRequest) returns (Order) {
-    option (google.api.http) = {
-      get: "/v1/orders/{id}"
-    };
-  }
-  
-  rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty);
-}
-
-// After - BREAKING CHANGES!
-// import "google/api/annotations.proto";    // BREAKING: deleted
-// import "google/protobuf/empty.proto";     // BREAKING: deleted  
-// import "common/auth.proto";               // BREAKING: deleted
-
-service OrderService {
-  rpc GetOrder(GetOrderRequest) returns (Order) {
-    option (google.api.http) = {  // ERROR: annotations not available
-      get: "/v1/orders/{id}"
-    };
-  }
-  
-  rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty);  // ERROR: types not available
-}
-```
-
-### Good
-
-**Instead of deleting, keep unused imports:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-import "google/protobuf/timestamp.proto";
-import "google/protobuf/duration.proto";  // [!code focus] // Keep even if unused
-import "common/user.proto";               // [!code focus] // Keep even if unused
-import "common/address.proto";            // [!code focus] // Keep even if unused
-
-message Order {
-  string id = 1;
-  google.protobuf.Timestamp created_at = 2;
-  // Removed fields that used Duration, User, Address but kept imports
-}
-```
-
-**Or replace with equivalent types while keeping imports:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-import "google/protobuf/timestamp.proto";
-import "google/protobuf/duration.proto";  // [!code focus] // Keep original import
-import "common/user.proto";               // [!code focus] // Keep original import
-import "common/address.proto";            // [!code focus] // Keep original import
-import "common/v2/user.proto";            // [!code focus] // Add new import
-
-message Order {
-  string id = 1;
-  google.protobuf.Timestamp created_at = 2;
-  google.protobuf.Duration processing_time = 3 [deprecated = true]; // [!code focus] // Keep old field
-  common.User customer = 4 [deprecated = true];                    // [!code focus] // Keep old field
-  common.Address shipping_address = 5 [deprecated = true];         // [!code focus] // Keep old field
-  
-  int32 processing_seconds = 6;             // [!code focus] // New field instead of Duration
-  common.v2.UserProfile customer_v2 = 7;    // [!code focus] // New field with updated type
-  string shipping_address_text = 8;         // [!code focus] // New field with simpler type
-}
-```
-
-## Impact
-
-- **Generated Code:** Imported types become unavailable, breaking compilation
-- **Wire Format:** Messages using imported types cannot be deserialized
-- **Field References:** Any field using imported types becomes invalid
-- **Service Definitions:** RPC methods using imported types break
-- **Options Usage:** Custom options from imports become unavailable
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-order := &myapi.Order{
-    Id:        "order123",
-    CreatedAt: timestamppb.New(time.Now()),              // Uses google.protobuf.Timestamp
-    Customer: &common.User{                              // ERROR after import deletion
-        Id:   "user456",
-        Name: "John Doe",
-    },
-    ShippingAddress: &common.Address{                    // ERROR after import deletion
-        Street: "123 Main St",
-        City:   "New York",
-    },
-}
-
-// Generated code compilation fails:
-// undefined: common.User
-// undefined: common.Address
-```
-
-**Server implementation breaks:**
-```go
-// Before - server uses imported types
-func (s *server) CreateOrder(ctx context.Context, req *CreateOrderRequest) (*Order, error) {
-    return &Order{
-        Id:        generateOrderId(),
-        CreatedAt: timestamppb.New(time.Now()),
-        Customer: &common.User{                          // ERROR after import deletion
-            Id:   req.CustomerId,
-            Name: req.CustomerName,
-        },
-        ShippingAddress: &common.Address{                // ERROR after import deletion
-            Street: req.ShippingStreet,
-            City:   req.ShippingCity,
-        },
-    }, nil
-}
-```
-
-**Proto compilation breaks:**
-```bash
-# After deleting imports
-$ protoc --go_out=. order.proto
-order.proto:8:3: "common.User" is not defined.
-order.proto:9:3: "common.Address" is not defined.
-order.proto:10:3: "google.protobuf.Duration" is not defined.
-```
-
-## Migration Strategy
-
-1. **Keep imports even when unused:**
-   ```proto
-   // Always keep existing imports
-   import "common/user.proto";  // Keep even if no fields use it
-   ```
-
-2. **Add new imports alongside old ones:**
-   ```proto
-   import "common/user.proto";     // Keep old import
-   import "common/v2/user.proto";  // Add new import
-   ```
-
-3. **Deprecate fields using old imports gradually:**
-   ```proto
-   message Order {
-     common.User customer = 4 [deprecated = true];
-     common.v2.UserProfile customer_v2 = 5;  // New field
-   }
-   ```
-
-4. **Update server code** to handle both old and new fields:
-   ```go
-   func convertToOrder(req *CreateOrderRequest) *Order {
-       order := &Order{Id: generateId()}
-       
-       // Handle new field first
-       if req.CustomerProfileV2 != nil {
-           order.CustomerV2 = req.CustomerProfileV2
-           return order
-       }
-       
-       // Fall back to old field (still works due to kept import)
-       if req.CustomerProfile != nil {
-           order.Customer = req.CustomerProfile
-       }
-       
-       return order
-   }
-   ```
-
-5. **Only remove imports in major version updates** after all fields are migrated
-
-## Common Scenarios
-
-### Replacing Dependencies
-```proto
-// Instead of deleting old import immediately
-// import "old/user.proto";  // Don't delete!
-
-// Keep both during transition
-import "old/user.proto";    // Keep for backward compatibility
-import "new/user.proto";    // Add new dependency
-
-message Order {
-  old.User customer = 4 [deprecated = true];
-  new.UserProfile customer_v2 = 5;
-}
-```
-
-### Removing Unused Features
-```proto
-// Even if removing features, keep imports
-import "feature/analytics.proto";  // Keep even if analytics removed
-
-message Order {
-  string id = 1;
-  // feature.AnalyticsData analytics = 2;  // Field removed but import kept
-}
-```
-
-### Protobuf Version Migration
-```proto
-// When migrating protobuf versions, keep old imports
-import "google/protobuf/timestamp.proto";  // Keep standard imports
-import "google/protobuf/duration.proto";   // Even if switching to alternatives
-
-// Prefer keeping both old and new approaches
-message Event {
-  google.protobuf.Timestamp timestamp = 1;    // Keep old
-  int64 timestamp_millis = 2;                 // Add alternative
-}
-```
-
-### Simplifying Dependencies
-```proto
-// Instead of removing complex type imports
-// import "complex/config.proto";  // Don't delete!
-
-// Keep complex import, add simple alternative
-import "complex/config.proto";
-
-message Settings {
-  complex.ConfigData config = 1 [deprecated = true];  // Keep complex option
-  string config_json = 2;                            // Add simple option
-}
-```
-
-## Import Categories and Impact
-
-### Standard Google Imports
-```proto
-// Critical - used throughout protobuf ecosystem
-import "google/protobuf/timestamp.proto";    // Never delete
-import "google/protobuf/duration.proto";     // Never delete
-import "google/protobuf/empty.proto";        // Never delete
-import "google/api/annotations.proto";       // Never delete if using gRPC-Gateway
-```
-
-### Common Library Imports
-```proto
-// Shared types across services
-import "common/user.proto";        // High impact - affects all user references
-import "common/address.proto";     // High impact - affects all address fields
-import "common/money.proto";       // High impact - affects all monetary fields
-```
-
-### Feature-Specific Imports
-```proto
-// Feature modules that might be deprecated
-import "features/analytics.proto";  // Medium impact - specific feature
-import "features/logging.proto";    // Medium impact - specific feature
-import "internal/debug.proto";      // Low impact - internal use
-```
-
-## Wire Format Considerations
-
-### Import Deletion vs Field Usage
-```proto
-// Import deletion breaks even if types aren't directly used as fields
-import "common/enums.proto";
-
-message Order {
-  // Even if no fields directly use common.enums types,
-  // nested messages or oneof fields might use them
-  oneof payment {
-    CreditCardPayment card = 1;  // This might internally use common.enums
-  }
-}
-```
-
-### Transitive Dependencies
-```proto
-// Deleting an import can break transitive dependencies
-import "user.proto";  // Don't delete even if not directly used
-
-message Order {
-  PaymentInfo payment = 1;  // PaymentInfo might internally reference user.proto types
-}
-```
-
-### JSON Serialization Impact
-```proto
-// Imports affect JSON field names and validation
-import "google/protobuf/field_mask.proto";
-
-message UpdateRequest {
-  google.protobuf.FieldMask update_mask = 1;  // JSON serialization depends on import
-}
-```
-
-## Prevention Strategies
-
-### Import Auditing
-```bash
-# Check which imports are actually used
-$ grep -r "google.protobuf.Duration" *.proto
-$ grep -r "common.User" *.proto
-
-# But still keep imports even if grep shows no usage!
-```
-
-### Linting Configuration
-```yaml
-# Configure linters to allow unused imports
-lint:
-  ignore:
-    - IMPORT_UNUSED  # Allow unused imports for backward compatibility
-```
-
-### Documentation
-```proto
-// Document why imports are kept
-import "legacy/types.proto";  // Keep for backward compatibility with v1 clients
-import "common/user.proto";   // Required for existing serialized data
-```
-
-## Import vs Field Deletion
-
-### Different Breaking Change Types
-```proto
-// Import deletion (this rule)
-// import "user.proto";  // BREAKING: import deleted
-
-// vs Field deletion (different rule)
-message Order {
-  string id = 1;
-  // User customer = 2;  // BREAKING: field deleted (different from import)
-}
-```
-
-### Compound Breaking Changes
-```proto
-// Worst case: both import AND field deleted
-// import "user.proto";  // BREAKING: import deleted
-message Order {
-  string id = 1;
-  // User customer = 2;  // BREAKING: field also deleted
-}
-// This creates multiple breaking change violations
-```
diff --git a/docs/public/docs/guide/cli/breaking-changes/rules/message-no-delete.md b/docs/public/docs/guide/cli/breaking-changes/rules/message-no-delete.md
deleted file mode 100644
index 5fe69c70..00000000
--- a/docs/public/docs/guide/cli/breaking-changes/rules/message-no-delete.md
+++ /dev/null
@@ -1,250 +0,0 @@
-# MESSAGE_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no messages are deleted from proto files. Deleting a message breaks both wire format compatibility and generated code, as existing data may reference the deleted message and client code depends on the generated types.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  Address address = 3;
-}
-
-message Address { // [!code --]
-  string street = 1; // [!code --]
-  string city = 2; // [!code --]
-  string country = 3; // [!code --]
-} // [!code --]
-
-message Order {
-  string id = 1;
-  User user = 2;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  Address address = 3;  // ERROR: Address message no longer exists!
-}
-
-// Address message was deleted - BREAKING CHANGE!
-
-message Order {
-  string id = 1;
-  User user = 2;
-}
-```
-
-**Error:**
-```
-user.proto:8:1: Previously present message "Address" was deleted from file. (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Nested message deletion:**
-
-```proto
-// Before
-message User {
-  string name = 1;
-  Profile profile = 2;
-  
-  message Profile { // [!code --]
-    string bio = 1; // [!code --]
-    string avatar_url = 2; // [!code --]
-  } // [!code --]
-}
-
-// After - BREAKING CHANGE!
-message User {
-  string name = 1;
-  Profile profile = 2;  // ERROR: Profile message deleted
-  
-  // Profile nested message was deleted
-}
-```
-
-### Good
-
-**Instead of deleting, deprecate the message:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  Address address = 3 [deprecated = true]; // [!code focus]
-}
-
-message Address {
-  option deprecated = true; // [!code focus]
-  string street = 1;
-  string city = 2;
-  string country = 3;
-}
-
-message Order {
-  string id = 1;
-  User user = 2;
-}
-```
-
-**Or replace with new message version:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  Address address = 3 [deprecated = true]; // [!code focus] // Old field
-  AddressV2 address_v2 = 4; // [!code focus] // New field with better structure
-}
-
-message Address {
-  option deprecated = true; // [!code focus]
-  string street = 1;
-  string city = 2;
-  string country = 3;
-}
-
-message AddressV2 { // [!code focus]
-  string street_address = 1; // [!code focus]
-  string city = 2; // [!code focus]
-  string state = 3; // [!code focus]
-  string postal_code = 4; // [!code focus]
-  string country = 5; // [!code focus]
-} // [!code focus]
-
-message Order {
-  string id = 1;
-  User user = 2;
-}
-```
-
-## Impact
-
-- **Wire Format:** Existing data with the deleted message cannot be deserialized
-- **Generated Code:** Message classes/structs are removed, breaking client compilation
-- **Field References:** Fields using the deleted message type become invalid
-- **Nested Dependencies:** All messages referencing the deleted message break
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-user := &myapi.User{
-    Name:  "John Doe",
-    Email: "john@example.com",
-    Address: &myapi.Address{  // ERROR after deletion
-        Street:  "123 Main St",
-        City:    "New York",
-        Country: "USA",
-    },
-}
-
-// Generated code compilation fails:
-// undefined: myapi.Address
-```
-
-**Existing data becomes unreadable:**
-```json
-// Serialized data before deletion
-{
-  "name": "John Doe",
-  "email": "john@example.com", 
-  "address": {
-    "street": "123 Main St",
-    "city": "New York",
-    "country": "USA"
-  }
-}
-
-// After Address deletion - deserialization fails
-// Parser doesn't know how to handle "address" field
-```
-
-## Migration Strategy
-
-1. **Deprecate the message first:**
-   ```proto
-   message OldMessage {
-     option deprecated = true;
-     // ... fields
-   }
-   ```
-
-2. **Stop using in new fields** and deprecate existing fields that use it:
-   ```proto
-   OldMessage old_data = 5 [deprecated = true];
-   ```
-
-3. **Create replacement** with new structure if needed:
-   ```proto
-   NewMessage new_data = 6;  // Better design
-   ```
-
-4. **Remove after migration period** in a new major version
-
-## Common Scenarios
-
-### Refactoring Message Structure
-```proto
-// Instead of deleting UserInfo and creating UserProfile
-message UserInfo {
-  option deprecated = true;  // Deprecate old
-  string name = 1;
-  string email = 2;
-}
-
-message UserProfile {  // Create new alongside
-  string full_name = 1;
-  string email_address = 2;
-  string phone = 3;
-  // Better field organization
-}
-```
-
-### Removing Unused Messages
-```proto
-// Even if message seems unused, it might be in serialized data
-message OldConfig {
-  option deprecated = true;  // Always deprecate first
-  // Don't delete immediately - data might exist
-}
-```
-
-### Version Migration
-```proto
-// Clean approach - new package version
-package myapi.v2;
-
-message User {
-  // Redesigned message structure
-  // No deprecated Address references
-}
-```
diff --git a/docs/public/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete.md b/docs/public/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete.md
deleted file mode 100644
index 66718800..00000000
--- a/docs/public/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete.md
+++ /dev/null
@@ -1,413 +0,0 @@
-# ONEOF_FIELD_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no fields are deleted from oneOf groups. Deleting a field from a oneOf breaks both wire format compatibility and generated code, as existing data may use the deleted oneOf option and client code depends on the generated field types and accessor methods.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    string oauth_token = 4;
-    string certificate = 5;
-  }
-}
-
-message SearchQuery {
-  oneof filter {
-    string text = 1;
-    int32 user_id = 2;
-    string category = 3;
-    DateRange date_range = 4;
-  }
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    // string oauth_token = 4;  // [!code --] Deleted oneOf field - BREAKING!
-    // string certificate = 5;  // [!code --] Deleted oneOf field - BREAKING!
-  }
-}
-
-message SearchQuery {
-  oneof filter {
-    string text = 1;
-    int32 user_id = 2;
-    // string category = 3;     // [!code --] Deleted oneOf field - BREAKING!
-    // DateRange date_range = 4; // [!code --] Deleted oneOf field - BREAKING!
-  }
-}
-```
-
-**Error:**
-```
-login.proto:7:5: Previously present field "4" with name "oauth_token" on OneOf "credentials" was deleted. (BREAKING_CHECK)
-login.proto:8:5: Previously present field "5" with name "certificate" on OneOf "credentials" was deleted. (BREAKING_CHECK)
-search.proto:6:5: Previously present field "3" with name "category" on OneOf "filter" was deleted. (BREAKING_CHECK)
-search.proto:7:5: Previously present field "4" with name "date_range" on OneOf "filter" was deleted. (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Nested message oneOf field deletion:**
-
-```proto
-// Before
-message PaymentRequest {
-  string order_id = 1;
-  
-  oneof payment_method {
-    CreditCardPayment credit_card = 2;
-    BankTransferPayment bank_transfer = 3;
-    CryptoPayment crypto = 4;         // [!code --] 
-    GiftCardPayment gift_card = 5;    // [!code --]
-  }
-}
-
-// After - BREAKING CHANGES!
-message PaymentRequest {
-  string order_id = 1;
-  
-  oneof payment_method {
-    CreditCardPayment credit_card = 2;
-    BankTransferPayment bank_transfer = 3;
-    // CryptoPayment crypto = 4;      // BREAKING: deleted
-    // GiftCardPayment gift_card = 5; // BREAKING: deleted
-  }
-}
-```
-
-### Good
-
-**Instead of deleting, deprecate the oneOf fields:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    string oauth_token = 4 [deprecated = true]; // [!code focus]
-    string certificate = 5 [deprecated = true]; // [!code focus]
-  }
-}
-
-message SearchQuery {
-  oneof filter {
-    string text = 1;
-    int32 user_id = 2;
-    string category = 3 [deprecated = true]; // [!code focus]
-    DateRange date_range = 4 [deprecated = true]; // [!code focus]
-  }
-}
-```
-
-**Or add new oneOf fields while keeping old ones:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    string oauth_token = 4 [deprecated = true]; // [!code focus] // Keep old field
-    string certificate = 5 [deprecated = true]; // [!code focus] // Keep old field
-    
-    OAuthCredentials oauth_v2 = 6; // [!code focus] // New structured approach
-    CertificateCredentials cert_v2 = 7; // [!code focus] // New structured approach
-  }
-}
-```
-
-## Impact
-
-- **Wire Format:** Existing data with deleted oneOf fields cannot be deserialized properly
-- **Generated Code:** OneOf field accessor methods are removed, breaking client compilation
-- **Type Safety:** Generated oneOf wrapper types lose options, breaking switch statements
-- **Business Logic:** Client code handling specific oneOf cases breaks
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-loginReq := &myapi.LoginRequest{
-    Username: "user123",
-}
-
-// Set OAuth token (oneOf field)
-loginReq.Credentials = &myapi.LoginRequest_OauthToken{
-    OauthToken: "token123",  // ERROR after field deletion
-}
-
-// Switch on oneOf field types
-switch cred := loginReq.Credentials.(type) {
-case *myapi.LoginRequest_Password:
-    return authenticatePassword(cred.Password)
-case *myapi.LoginRequest_OauthToken:  // ERROR: undefined type after deletion
-    return authenticateOAuth(cred.OauthToken)
-case *myapi.LoginRequest_Certificate: // ERROR: undefined type after deletion
-    return authenticateCert(cred.Certificate)
-default:
-    return errors.New("unsupported credential type")
-}
-
-// Generated code compilation fails:
-// undefined: myapi.LoginRequest_OauthToken
-// undefined: myapi.LoginRequest_Certificate
-```
-
-**Server handling breaks:**
-```go
-// Before - server handles all oneOf field types
-func authenticateUser(req *LoginRequest) error {
-    switch cred := req.Credentials.(type) {
-    case *LoginRequest_Password:
-        return validatePassword(cred.Password)
-    case *LoginRequest_ApiKey:
-        return validateApiKey(cred.ApiKey)
-    case *LoginRequest_OauthToken:    // ERROR after deletion
-        return validateOAuth(cred.OauthToken)
-    case *LoginRequest_Certificate:   // ERROR after deletion
-        return validateCertificate(cred.Certificate)
-    default:
-        return errors.New("no valid credentials provided")
-    }
-}
-```
-
-**Existing data becomes unreadable:**
-```json
-// Serialized data before deletion
-{
-  "username": "user123",
-  "oauth_token": "abc123xyz"
-}
-
-// After oneOf field deletion
-// Data deserializes but oauth_token is lost or causes parsing errors
-// User authentication fails due to missing credential data
-```
-
-## Migration Strategy
-
-1. **Deprecate oneOf fields first:**
-   ```proto
-   oneof credentials {
-     string password = 2;
-     string oauth_token = 4 [deprecated = true];
-   }
-   ```
-
-2. **Add new fields** if replacement is needed:
-   ```proto
-   oneof credentials {
-     string password = 2;
-     string oauth_token = 4 [deprecated = true];
-     OAuthCredentials oauth_v2 = 6;  // New structured field
-   }
-   ```
-
-3. **Update server code** to handle both old and new fields:
-   ```go
-   func authenticateUser(req *LoginRequest) error {
-       switch cred := req.Credentials.(type) {
-       case *LoginRequest_OauthV2:
-           // Handle new structured OAuth
-           return validateOAuthV2(cred.OauthV2)
-       case *LoginRequest_OauthToken:
-           // Handle legacy OAuth (deprecated)
-           log.Warn("Using deprecated oauth_token field")
-           return validateOAuthLegacy(cred.OauthToken)
-       // ... other cases
-       }
-   }
-   ```
-
-4. **Migrate clients** to use new fields:
-   ```go
-   // Update client to use new structured field
-   loginReq.Credentials = &LoginRequest_OauthV2{
-       OauthV2: &OAuthCredentials{
-           Token:        "token123",
-           RefreshToken: "refresh456",
-           ExpiresAt:    timestamp,
-       },
-   }
-   ```
-
-5. **Reserve field numbers** after removal in next major version:
-   ```proto
-   oneof credentials {
-     reserved 4, 5;
-     reserved "oauth_token", "certificate";
-     
-     string password = 2;
-     string api_key = 3;
-     OAuthCredentials oauth_v2 = 6;
-   }
-   ```
-
-## Common Scenarios
-
-### Removing Unsupported Authentication Methods
-```proto
-// Instead of deleting discontinued auth methods
-message AuthRequest {
-  oneof method {
-    PasswordAuth password = 1;
-    ApiKeyAuth api_key = 2;
-    // LdapAuth ldap = 3;  // Don't delete even if LDAP discontinued!
-    
-    // Better approach:
-    LdapAuth ldap = 3 [deprecated = true];  // Mark as deprecated
-    OidcAuth oidc = 4;  // Add new method
-  }
-}
-```
-
-### Simplifying OneOf Options
-```proto
-// Instead of removing complex options
-message SearchRequest {
-  oneof query_type {
-    string simple_text = 1;
-    // ComplexQuery complex = 2;  // Don't delete complex queries!
-    
-    // Better approach:
-    ComplexQuery complex = 2 [deprecated = true];
-    AdvancedQuery advanced = 3;  // Replacement with better design
-  }
-}
-```
-
-### Business Logic Changes
-```proto
-// Instead of removing payment methods
-message PaymentRequest {
-  oneof payment_method {
-    CreditCard credit_card = 1;
-    // Check check = 2;  // Don't delete even if checks discontinued!
-    BankTransfer bank_transfer = 3;
-    
-    // Better approach:
-    Check check = 2 [deprecated = true];  // Keep for existing data
-    DigitalWallet digital_wallet = 4;     // Add new methods
-  }
-}
-```
-
-## OneOf Field Deletion vs Other Deletions
-
-### Different from Regular Field Deletion
-```proto
-// Regular field deletion (also breaking)
-message User {
-  string name = 1;
-  // string email = 2;  // BREAKING: regular field deletion
-}
-
-// OneOf field deletion (breaks oneOf semantics)
-message User {
-  oneof contact {
-    string email = 1;
-    // string phone = 2;  // BREAKING: oneOf field deletion
-  }
-}
-```
-
-### Impact on Generated Code
-```go
-// Regular field - simple accessor removed
-// user.GetEmail() // Method removed
-
-// OneOf field - wrapper type removed  
-// *LoginRequest_OauthToken  // Entire type removed
-// switch statement cases break completely
-```
-
-### Wire Format Considerations
-```proto
-// OneOf fields share the same "choice" semantics
-// Removing a choice breaks clients that made that choice
-
-message Request {
-  oneof data {
-    string text = 1;      // Choice A
-    bytes binary = 2;     // Choice B - if removed, clients using B break
-    JsonData json = 3;    // Choice C
-  }
-}
-```
-
-## Validation and Error Handling
-
-### Before Deletion (Type Safe)
-```go
-func validateRequest(req *Request) error {
-    switch data := req.Data.(type) {
-    case *Request_Text:
-        return validateText(data.Text)
-    case *Request_Binary:      // Type exists
-        return validateBinary(data.Binary)
-    case *Request_Json:
-        return validateJson(data.Json)
-    case nil:
-        return errors.New("no data provided")
-    default:
-        return errors.New("unknown data type")
-    }
-}
-```
-
-### After Deletion (Broken)
-```go
-func validateRequest(req *Request) error {
-    switch data := req.Data.(type) {
-    case *Request_Text:
-        return validateText(data.Text)
-    // case *Request_Binary:   // ERROR: type no longer exists
-    //     return validateBinary(data.Binary)
-    case *Request_Json:
-        return validateJson(data.Json)
-    case nil:
-        return errors.New("no data provided")
-    default:
-        // Existing binary data falls here now!
-        return errors.New("unknown data type")
-    }
-}
-```
diff --git a/docs/public/docs/guide/cli/breaking-changes/rules/oneof-field-same-type.md b/docs/public/docs/guide/cli/breaking-changes/rules/oneof-field-same-type.md
deleted file mode 100644
index de940ba4..00000000
--- a/docs/public/docs/guide/cli/breaking-changes/rules/oneof-field-same-type.md
+++ /dev/null
@@ -1,415 +0,0 @@
-# ONEOF_FIELD_SAME_TYPE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that oneOf field types cannot be changed. Changing the type of a field within a oneOf breaks both wire format compatibility and generated code, as existing data contains the old type and client code expects specific field types in oneOf wrapper structures.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message SearchRequest {
-  string query = 1;
-  
-  oneof filter {
-    string category = 2;
-    int32 user_id = 3;
-    bool is_premium = 4;
-    DateRange date_range = 5;
-  }
-}
-
-message NotificationSettings {
-  oneof delivery {
-    string email = 1;
-    int64 phone_number = 2;
-    WebhookConfig webhook = 3;
-  }
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message SearchRequest {
-  string query = 1;
-  
-  oneof filter {
-    int32 category = 2;        // [!code --] Changed from string to int32 - BREAKING!
-    string user_id = 3;        // [!code --] Changed from int32 to string - BREAKING!
-    string is_premium = 4;     // [!code --] Changed from bool to string - BREAKING!
-    string date_range = 5;     // [!code --] Changed from DateRange to string - BREAKING!
-  }
-}
-
-message NotificationSettings {
-  oneof delivery {
-    EmailConfig email = 1;     // [!code --] Changed from string to EmailConfig - BREAKING!
-    string phone_number = 2;   // [!code --] Changed from int64 to string - BREAKING!
-    string webhook = 3;        // [!code --] Changed from WebhookConfig to string - BREAKING!
-  }
-}
-```
-
-**Error:**
-```
-search.proto:6:5: Field "2" with name "category" on OneOf "filter" changed type from "string" to "int32". (BREAKING_CHECK)
-search.proto:7:5: Field "3" with name "user_id" on OneOf "filter" changed type from "int32" to "string". (BREAKING_CHECK)
-search.proto:8:5: Field "4" with name "is_premium" on OneOf "filter" changed type from "bool" to "string". (BREAKING_CHECK)
-search.proto:9:5: Field "5" with name "date_range" on OneOf "filter" changed type from "DateRange" to "string". (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Complex type changes:**
-
-```proto
-// Before
-message PaymentRequest {
-  oneof payment_info {
-    CreditCardInfo credit_card = 1;
-    BankAccountInfo bank_account = 2;
-    string paypal_email = 3;
-    CryptoWalletInfo crypto = 4;
-  }
-}
-
-// After - ALL BREAKING CHANGES!
-message PaymentRequest {
-  oneof payment_info {
-    string credit_card = 1;           // BREAKING: CreditCardInfo -> string
-    PayPalInfo bank_account = 2;      // BREAKING: BankAccountInfo -> PayPalInfo  
-    PayPalInfo paypal_email = 3;      // BREAKING: string -> PayPalInfo
-    string crypto = 4;                // BREAKING: CryptoWalletInfo -> string
-  }
-}
-```
-
-### Good
-
-**Instead of changing type, add new oneOf field:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message SearchRequest {
-  string query = 1;
-  
-  oneof filter {
-    string category = 2 [deprecated = true];     // [!code focus] // Keep original type
-    int32 user_id = 3 [deprecated = true];       // [!code focus] // Keep original type
-    bool is_premium = 4 [deprecated = true];     // [!code focus] // Keep original type
-    DateRange date_range = 5 [deprecated = true]; // [!code focus] // Keep original type
-    
-    int32 category_id = 6;                       // [!code focus] // New field with desired type
-    string user_identifier = 7;                 // [!code focus] // New field with desired type
-    string premium_status = 8;                  // [!code focus] // New field with desired type
-    string date_filter = 9;                    // [!code focus] // New field with desired type
-  }
-}
-```
-
-**Or create a new oneOf group:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message SearchRequest {
-  string query = 1;
-  
-  oneof filter {
-    option deprecated = true;                   // [!code focus] // Deprecate old oneOf
-    string category = 2 [deprecated = true];    // [!code focus]
-    int32 user_id = 3 [deprecated = true];      // [!code focus]
-    bool is_premium = 4 [deprecated = true];    // [!code focus]
-    DateRange date_range = 5 [deprecated = true]; // [!code focus]
-  }
-  
-  oneof filter_v2 {                            // [!code focus] // New oneOf with correct types
-    int32 category_id = 6;                     // [!code focus]
-    string user_identifier = 7;               // [!code focus]
-    PremiumFilter premium_filter = 8;          // [!code focus]
-    TimeFilter time_filter = 9;               // [!code focus]
-  }                                           // [!code focus]
-}
-```
-
-## Impact
-
-- **Wire Format:** Binary data cannot be deserialized correctly between versions
-- **Generated Code:** OneOf wrapper types change, breaking client compilation  
-- **Type Safety:** Switch statements on oneOf types break with compilation errors
-- **Runtime Errors:** Type mismatches cause parsing failures for existing data
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-searchReq := &myapi.SearchRequest{
-    Query: "golang jobs",
-}
-
-// Set filter using oneOf (original types)
-searchReq.Filter = &myapi.SearchRequest_Category{
-    Category: "engineering",  // string type
-}
-
-// Handle filter types
-switch filter := searchReq.Filter.(type) {
-case *myapi.SearchRequest_Category:
-    return searchByCategory(filter.Category)  // string parameter
-case *myapi.SearchRequest_UserId:
-    return searchByUserId(filter.UserId)      // int32 parameter
-default:
-    return errors.New("unsupported filter")
-}
-
-// After type change - compilation fails
-searchReq.Filter = &myapi.SearchRequest_Category{
-    Category: "engineering",  // ERROR: expects int32, not string
-}
-
-// Switch statement breaks
-switch filter := searchReq.Filter.(type) {
-case *myapi.SearchRequest_Category:
-    return searchByCategory(filter.Category)  // ERROR: Category is now int32
-case *myapi.SearchRequest_UserId:   
-    return searchByUserId(filter.UserId)      // ERROR: UserId is now string
-}
-```
-
-**Server implementation breaks:**
-```go
-// Before - server expects original types
-func handleSearchFilter(req *SearchRequest) (*SearchResult, error) {
-    switch filter := req.Filter.(type) {
-    case *SearchRequest_Category:
-        categoryName := filter.Category  // string
-        return searchDatabase("category", categoryName), nil
-    case *SearchRequest_UserId:
-        userId := filter.UserId  // int32
-        return searchDatabase("user_id", strconv.Itoa(int(userId))), nil
-    default:
-        return nil, errors.New("no filter specified")
-    }
-}
-
-// After type change - runtime errors
-func handleSearchFilter(req *SearchRequest) (*SearchResult, error) {
-    switch filter := req.Filter.(type) {
-    case *SearchRequest_Category:
-        categoryId := filter.Category  // now int32, but code expects string
-        return searchDatabase("category", categoryId), nil  // ERROR: type mismatch
-    case *SearchRequest_UserId:
-        userIdStr := filter.UserId  // now string, but conversion logic expects int32
-        userId, _ := strconv.Atoi(userIdStr)  // Works but semantics changed
-        return searchDatabase("user_id", strconv.Itoa(userId)), nil
-    }
-}
-```
-
-**Existing data corruption:**
-```json
-// Serialized data before type change
-{
-  "query": "golang jobs",
-  "category": "engineering"
-}
-
-// After changing category from string to int32
-// Data cannot be deserialized - "engineering" is not a valid int32
-// Results in parsing errors or data loss
-```
-
-## Migration Strategy
-
-1. **Add new oneOf fields** with correct types:
-   ```proto
-   oneof filter {
-     string category = 2 [deprecated = true];
-     int32 category_id = 6;  // New field with desired type
-   }
-   ```
-
-2. **Update server code** to handle both old and new fields:
-   ```go
-   func handleSearchFilter(req *SearchRequest) error {
-       switch filter := req.Filter.(type) {
-       case *SearchRequest_CategoryId:
-           // Handle new int32 field
-           return searchByCategoryId(filter.CategoryId)
-       case *SearchRequest_Category:
-           // Handle legacy string field (deprecated)
-           log.Warn("Using deprecated string category field")
-           categoryId := convertCategoryNameToId(filter.Category)
-           return searchByCategoryId(categoryId)
-       }
-   }
-   ```
-
-3. **Migrate clients** to use new fields:
-   ```go
-   // Update client to use new typed field
-   searchReq.Filter = &SearchRequest_CategoryId{
-       CategoryId: 123,  // int32 instead of string
-   }
-   ```
-
-4. **Provide migration utilities** for data conversion:
-   ```go
-   func MigrateSearchRequest(old *SearchRequestV1) *SearchRequestV2 {
-       new := &SearchRequestV2{Query: old.Query}
-       
-       switch filter := old.Filter.(type) {
-       case *SearchRequestV1_Category:
-           // Convert string category to int32 ID
-           categoryId := lookupCategoryId(filter.Category)
-           new.Filter = &SearchRequestV2_CategoryId{CategoryId: categoryId}
-       }
-       
-       return new
-   }
-   ```
-
-5. **Remove old fields** in next major version:
-   ```proto
-   oneof filter {
-     reserved 2, "category";
-     int32 category_id = 6;
-   }
-   ```
-
-## Common Scenarios
-
-### Improving Type Safety
-```proto
-// Instead of changing loose string types to structured types
-message ConfigRequest {
-  oneof setting {
-    // string database_url = 1;  // Don't change type directly!
-    
-    // Add new structured field instead
-    string database_url = 1 [deprecated = true];
-    DatabaseConfig database_config = 5;  // New structured field
-  }
-}
-```
-
-### Standardizing Field Types  
-```proto
-// Instead of converting between numeric types
-message FilterRequest {
-  oneof criteria {
-    // int32 timestamp = 1;  // Don't change to int64 directly!
-    
-    // Add new field with correct type
-    int32 timestamp = 1 [deprecated = true];
-    int64 timestamp_millis = 5;  // New field with proper precision
-  }
-}
-```
-
-### Message Structure Changes
-```proto
-// Instead of flattening/expanding message types
-message PaymentRequest {
-  oneof payment {
-    // string card_number = 1;  // Don't change to structured type!
-    
-    // Provide both options during transition
-    string card_number = 1 [deprecated = true];
-    CreditCardDetails card_details = 5;  // New structured approach
-  }
-}
-```
-
-## Type Change Compatibility Matrix
-
-### Never Compatible (Always Breaking)
-| From Type | To Type | Result |
-|-----------|---------|---------|
-| `string` | `int32/int64` | ❌ BREAKING |
-| `int32` | `string` | ❌ BREAKING |  
-| `bool` | `string` | ❌ BREAKING |
-| `message` | `string` | ❌ BREAKING |
-| `string` | `message` | ❌ BREAKING |
-| `enum` | `int32` | ❌ BREAKING |
-
-### Generated Code Impact
-```go
-// String to int32 change breaks wrapper types
-// Before:
-type SearchRequest_Category struct {
-    Category string
-}
-
-// After:  
-type SearchRequest_Category struct {
-    Category int32  // Different type - compilation fails
-}
-
-// All client code using SearchRequest_Category breaks
-```
-
-### Wire Format Considerations
-```proto
-// OneOf fields in wire format are identified by field number
-// Type changes break deserialization even if field number stays same
-
-message Request {
-  oneof data {
-    string text = 1;    // Wire tag: 1, type: string
-    // int32 text = 1;   // Same wire tag, different type - BREAKING!
-  }
-}
-```
-
-## Validation and Error Handling
-
-### Type-Safe Validation (Before Change)
-```go
-func validateSearchFilter(req *SearchRequest) error {
-    switch filter := req.Filter.(type) {
-    case *SearchRequest_Category:
-        if filter.Category == "" {  // String validation
-            return errors.New("category cannot be empty")
-        }
-    case *SearchRequest_UserId:
-        if filter.UserId <= 0 {  // Integer validation
-            return errors.New("user_id must be positive")
-        }
-    }
-    return nil
-}
-```
-
-### Broken Validation (After Type Change)
-```go
-func validateSearchFilter(req *SearchRequest) error {
-    switch filter := req.Filter.(type) {
-    case *SearchRequest_Category:
-        if filter.Category <= 0 {  // ERROR: Category is now int32, validation logic wrong
-            return errors.New("category must be positive")
-        }
-    case *SearchRequest_UserId:
-        if filter.UserId == "" {  // ERROR: UserId is now string, validation logic wrong  
-            return errors.New("user_id cannot be empty")
-        }
-    }
-    return nil
-}
-```
diff --git a/docs/public/docs/guide/cli/breaking-changes/rules/oneof-no-delete.md b/docs/public/docs/guide/cli/breaking-changes/rules/oneof-no-delete.md
deleted file mode 100644
index eda1eb01..00000000
--- a/docs/public/docs/guide/cli/breaking-changes/rules/oneof-no-delete.md
+++ /dev/null
@@ -1,414 +0,0 @@
-# ONEOF_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no oneOf fields are deleted from messages. Deleting a oneOf breaks both wire format compatibility and generated code, as existing data may use the oneOf structure and client code depends on the generated oneOf types and accessor methods.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    string oauth_token = 4;
-  }
-}
-
-message PaymentMethod { // [!code --]
-  oneof method { // [!code --]
-    CreditCard credit_card = 1; // [!code --]
-    BankAccount bank_account = 2; // [!code --]
-    PayPal paypal = 3; // [!code --]
-  } // [!code --]
-} // [!code --]
-
-message Order {
-  string id = 1;
-  PaymentMethod payment = 2;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  // credentials oneof was deleted - BREAKING CHANGE!
-  string password = 2;     // Now regular fields
-  string api_key = 3;      // Lost exclusive semantics
-  string oauth_token = 4;
-}
-
-message PaymentMethod {
-  // method oneof was deleted - BREAKING CHANGE!
-  CreditCard credit_card = 1;  // Now all can be set simultaneously
-  BankAccount bank_account = 2;
-  PayPal paypal = 3;
-}
-
-message Order {
-  string id = 1;
-  PaymentMethod payment = 2;
-}
-```
-
-**Error:**
-```
-login.proto:5:3: Previously present oneof "credentials" was deleted. (BREAKING_CHECK)
-payment.proto:2:3: Previously present oneof "method" was deleted. (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Nested oneOf deletion:**
-
-```proto
-// Before
-message UserProfile {
-  string name = 1;
-  
-  message ContactInfo {
-    oneof contact_method { // [!code --]
-      string email = 1; // [!code --]
-      string phone = 2; // [!code --]
-      string slack_id = 3; // [!code --]
-    } // [!code --]
-  }
-  
-  ContactInfo contact = 2;
-}
-
-// After - BREAKING CHANGE!
-message UserProfile {
-  string name = 1;
-  
-  message ContactInfo {
-    // contact_method oneof was deleted
-    string email = 1;    // No longer mutually exclusive
-    string phone = 2;    // Can set all fields now
-    string slack_id = 3;
-  }
-  
-  ContactInfo contact = 2;
-}
-```
-
-### Good
-
-**Instead of deleting, deprecate the oneOf:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    option deprecated = true; // [!code focus]
-    string password = 2 [deprecated = true]; // [!code focus]
-    string api_key = 3 [deprecated = true]; // [!code focus]
-    string oauth_token = 4 [deprecated = true]; // [!code focus]
-  }
-}
-
-message PaymentMethod {
-  oneof method {
-    option deprecated = true; // [!code focus]
-    CreditCard credit_card = 1 [deprecated = true]; // [!code focus]
-    BankAccount bank_account = 2 [deprecated = true]; // [!code focus]
-    PayPal paypal = 3 [deprecated = true]; // [!code focus]
-  }
-}
-```
-
-**Or replace with new structure:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    option deprecated = true; // [!code focus] // Old oneOf
-    string password = 2 [deprecated = true]; // [!code focus]
-    string api_key = 3 [deprecated = true]; // [!code focus]
-    string oauth_token = 4 [deprecated = true]; // [!code focus]
-  }
-  
-  oneof auth_method { // [!code focus] // New oneOf with better design
-    PasswordAuth password_auth = 5; // [!code focus]
-    ApiKeyAuth api_auth = 6; // [!code focus]
-    OAuthAuth oauth_auth = 7; // [!code focus]
-  } // [!code focus]
-}
-```
-
-## Impact
-
-- **Wire Format:** OneOf semantics are lost - fields are no longer mutually exclusive
-- **Generated Code:** OneOf accessor methods are removed, breaking client compilation
-- **Business Logic:** Mutual exclusivity constraints are violated
-- **Validation:** Client code expecting only one field to be set may break
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - oneOf provides mutual exclusivity
-loginReq := &myapi.LoginRequest{
-    Username: "user123",
-}
-
-// Set one of the credential options (oneOf semantics)
-loginReq.Credentials = &myapi.LoginRequest_Password{
-    Password: "secret123",
-}
-
-// Check which credential type is set
-switch cred := loginReq.Credentials.(type) {
-case *myapi.LoginRequest_Password:  // ERROR after oneOf deletion
-    return authenticatePassword(cred.Password)
-case *myapi.LoginRequest_ApiKey:    // ERROR after oneOf deletion  
-    return authenticateApiKey(cred.ApiKey)
-default:
-    return errors.New("no credentials provided")
-}
-
-// Generated code compilation fails:
-// undefined: myapi.LoginRequest_Password
-// undefined field: loginReq.Credentials
-```
-
-**Server validation breaks:**
-```go
-// Before - server validates oneOf semantics
-func validateLoginRequest(req *LoginRequest) error {
-    if req.Credentials == nil {
-        return errors.New("credentials required")
-    }
-    
-    // OneOf ensures only one credential type is set
-    switch req.Credentials.(type) {
-    case *LoginRequest_Password:
-        return validatePassword(req.GetPassword())
-    case *LoginRequest_ApiKey:
-        return validateApiKey(req.GetApiKey())
-    case *LoginRequest_OauthToken:
-        return validateOAuthToken(req.GetOauthToken())
-    default:
-        return errors.New("unknown credential type")
-    }
-}
-
-// After oneOf deletion - validation logic breaks
-func validateLoginRequest(req *LoginRequest) error {
-    // No more oneOf - multiple fields can be set!
-    credCount := 0
-    if req.Password != "" { credCount++ }
-    if req.ApiKey != "" { credCount++ }      
-    if req.OauthToken != "" { credCount++ }
-    
-    if credCount == 0 {
-        return errors.New("no credentials provided")
-    }
-    if credCount > 1 {
-        return errors.New("multiple credentials provided") // Manual check needed!
-    }
-    
-    // Lost type safety - need manual checks
-    if req.Password != "" {
-        return validatePassword(req.Password)
-    }
-    // ... more manual validation
-}
-```
-
-**Business logic problems:**
-```go
-// Before - oneOf guarantees mutual exclusivity
-payment := &PaymentMethod{
-    Method: &PaymentMethod_CreditCard{
-        CreditCard: &CreditCard{Number: "1234"},
-    },
-}
-// Impossible to set multiple payment methods simultaneously
-
-// After oneOf deletion - business logic can break
-payment := &PaymentMethod{
-    CreditCard:  &CreditCard{Number: "1234"},
-    BankAccount: &BankAccount{Number: "5678"}, // Both set! Logic breaks!
-}
-```
-
-## Migration Strategy
-
-1. **Deprecate the oneOf and all its fields:**
-   ```proto
-   oneof old_credentials {
-     option deprecated = true;
-     string password = 2 [deprecated = true];
-     string api_key = 3 [deprecated = true];
-   }
-   ```
-
-2. **Create new structure** if needed:
-   ```proto
-   oneof new_auth_method {
-     PasswordAuth password_auth = 5;
-     ApiKeyAuth api_auth = 6;
-   }
-   ```
-
-3. **Update server code** to handle both during transition:
-   ```go
-   func handleAuth(req *LoginRequest) error {
-       // Handle new structure first
-       if req.NewAuthMethod != nil {
-           return handleNewAuth(req.NewAuthMethod)
-       }
-       
-       // Fall back to old oneOf (deprecated)
-       if req.Credentials != nil {
-           return handleOldAuth(req.Credentials)
-       }
-       
-       return errors.New("no auth method provided")
-   }
-   ```
-
-4. **Migrate clients** to use new structure:
-   ```go
-   // Update client to use new oneOf
-   loginReq.NewAuthMethod = &LoginRequest_PasswordAuth{
-       PasswordAuth: &PasswordAuth{
-           Username: "user123",
-           Password: "secret123",
-       },
-   }
-   ```
-
-5. **Remove old oneOf** in next major version
-
-## Common Scenarios
-
-### Replacing OneOf with Regular Fields
-```proto
-// Instead of removing oneOf structure entirely
-message SearchRequest {
-  // Don't delete oneOf - breaks mutual exclusivity
-  string text_query = 1;    // BREAKING: was in oneOf
-  int32 user_id = 2;        // BREAKING: was in oneOf  
-  string category = 3;      // BREAKING: was in oneOf
-}
-
-// Keep oneOf, add new fields if needed
-message SearchRequest {
-  oneof query {
-    option deprecated = true;
-    string text_query = 1 [deprecated = true];
-    int32 user_id = 2 [deprecated = true];
-    string category = 3 [deprecated = true];
-  }
-  
-  // Add new non-exclusive fields if that's the intent
-  string search_text = 4;
-  repeated string filters = 5;
-}
-```
-
-### Simplifying Message Structure
-```proto
-// Instead of flattening oneOf structure
-message NotificationSettings {
-  // Don't delete oneOf - loses type safety
-  string email = 1;         // BREAKING: was in oneOf
-  string phone = 2;         // BREAKING: was in oneOf
-  string webhook_url = 3;   // BREAKING: was in oneOf
-}
-
-// Keep oneOf for type safety
-message NotificationSettings {
-  oneof delivery_method {
-    EmailNotification email = 1;
-    SmsNotification phone = 2; 
-    WebhookNotification webhook = 3;
-  }
-}
-```
-
-### Proto Syntax Migration
-```proto
-// When migrating from proto2 to proto3
-// Don't lose oneOf semantics during migration
-
-// proto2
-message Request {
-  optional string name = 1;
-  oneof data {
-    string text = 2;
-    int32 number = 3;
-  }
-}
-
-// proto3 - keep oneOf structure
-message Request {
-  string name = 1;
-  oneof data {  // Don't delete this!
-    string text = 2;
-    int32 number = 3;
-  }
-}
-```
-
-## OneOf Semantics
-
-### What OneOf Provides
-- **Mutual Exclusivity**: Only one field can be set at a time
-- **Type Safety**: Generated code enforces single choice
-- **Clear Intent**: API design expresses "choose one" semantics
-- **Efficient Wire Format**: Only selected field is serialized
-
-### What's Lost When Deleted
-- **Business Logic**: No enforcement of mutual exclusivity
-- **Generated Code**: No oneOf wrapper types or methods
-- **Validation**: Manual checks needed for exclusivity
-- **API Clarity**: Intent of "choose one" is lost
-
-### Generated Code Impact
-```go
-// With oneOf - type safe
-type LoginRequest struct {
-    Username string
-    // Types that are assignable to Credentials:
-    //   *LoginRequest_Password
-    //   *LoginRequest_ApiKey
-    Credentials isLoginRequest_Credentials
-}
-
-// Without oneOf - no type safety
-type LoginRequest struct {
-    Username    string
-    Password    string  // All can be set simultaneously
-    ApiKey      string  // No mutual exclusivity
-    OauthToken  string
-}
-```
diff --git a/docs/public/docs/guide/cli/breaking-changes/rules/rpc-no-delete.md b/docs/public/docs/guide/cli/breaking-changes/rules/rpc-no-delete.md
deleted file mode 100644
index 613393c6..00000000
--- a/docs/public/docs/guide/cli/breaking-changes/rules/rpc-no-delete.md
+++ /dev/null
@@ -1,78 +0,0 @@
-# RPC_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no RPC methods are deleted from services. Deleting an RPC method breaks both generated code and client applications that call the method.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-  rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse); // [!code --]
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-  // DeleteUser RPC was deleted - BREAKING CHANGE!
-}
-```
-
-**Error:**
-```
-services.proto:7:1: Previously present RPC "DeleteUser" on service "UserService" was deleted. (BREAKING_CHECK)
-```
-
-### Good
-
-**Instead of deleting, deprecate the RPC:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-  rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-}
-```
-
-## Impact
-
-- **Generated Code:** RPC method stubs are removed, breaking client compilation
-- **Client Applications:** Existing calls to the RPC fail to compile
-- **Runtime:** gRPC clients lose method definition
-
-## Migration Strategy
-
-1. **Deprecate first:**
-   ```proto
-   rpc OldMethod(OldRequest) returns (OldResponse) {
-     option deprecated = true;
-   }
-   ```
-
-2. **Return error from implementation** indicating method is no longer supported
-
-3. **Remove in next major version** after clients have migrated
\ No newline at end of file
diff --git a/docs/public/docs/guide/cli/breaking-changes/rules/rpc-same-request-type.md b/docs/public/docs/guide/cli/breaking-changes/rules/rpc-same-request-type.md
deleted file mode 100644
index bcdfb37a..00000000
--- a/docs/public/docs/guide/cli/breaking-changes/rules/rpc-same-request-type.md
+++ /dev/null
@@ -1,256 +0,0 @@
-# RPC_SAME_REQUEST_TYPE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that RPC methods maintain the same request message type. Changing an RPC's request type breaks both wire format compatibility and generated code, as clients expect specific message structures when calling the method.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse);
-}
-
-message GetUserRequest {
-  string user_id = 1;
-}
-
-message UpdateUserRequest {
-  string user_id = 1;
-  string name = 2;
-  string email = 3;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // [!code --] Changed request type
-  rpc UpdateUser(UserUpdateRequest) returns (UpdateUserResponse); // [!code --] Changed request type
-}
-
-message GetUserRequestV2 { // [!code --] Different message type
-  string id = 1;
-  bool include_profile = 2;
-}
-
-message UserUpdateRequest { // [!code --] Different message type  
-  string id = 1;
-  UserProfile profile = 2;
-}
-```
-
-**Error:**
-```
-user_service.proto:6:3: RPC "GetUser" on service "UserService" changed request type from "GetUserRequest" to "GetUserRequestV2". (BREAKING_CHECK)
-user_service.proto:7:3: RPC "UpdateUser" on service "UserService" changed request type from "UpdateUserRequest" to "UserUpdateRequest". (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Cross-package type changes:**
-
-```proto
-// Before
-import "common/user.proto";
-
-service UserService {
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-// After - BREAKING CHANGE!
-import "v2/user.proto";
-
-service UserService {
-  rpc CreateUser(v2.CreateUserRequest) returns (CreateUserResponse); // Different package
-}
-```
-
-### Good
-
-**Instead of changing request type, version the RPC:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-  rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse); // [!code focus] // New RPC method
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-  rpc UpdateUserV2(UserUpdateRequest) returns (UpdateUserResponse); // [!code focus] // New RPC method
-}
-
-// Keep old messages for backward compatibility
-message GetUserRequest {
-  string user_id = 1;
-}
-
-// Add new messages for enhanced functionality  
-message GetUserRequestV2 { // [!code focus]
-  string id = 1; // [!code focus]
-  bool include_profile = 2; // [!code focus]
-} // [!code focus]
-```
-
-**Or create a new service version:**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus] // New package version
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] // Clean interface in v2
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus]
-}
-
-message GetUserRequest { // [!code focus]
-  string id = 1; // [!code focus] // Improved field names
-  bool include_profile = 2; // [!code focus]
-} // [!code focus]
-```
-
-## Impact
-
-- **Wire Format:** Existing client requests cannot be deserialized by new server
-- **Generated Code:** Client stubs expect different request message types, breaking compilation
-- **gRPC Calls:** Method signatures change in generated client code
-- **Runtime Errors:** Type mismatches cause RPC call failures
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-client := myapi.NewUserServiceClient(conn)
-resp, err := client.GetUser(ctx, &myapi.GetUserRequest{
-    UserId: "user123",
-})
-
-// After request type change - compilation fails  
-client := myapi.NewUserServiceClient(conn)
-resp, err := client.GetUser(ctx, &myapi.GetUserRequest{  // ERROR: type not found
-    UserId: "user123",  // ERROR: field not found
-})
-
-// Must use new type:
-resp, err := client.GetUser(ctx, &myapi.GetUserRequestV2{
-    Id: "user123",               // Different field name
-    IncludeProfile: true,        // New required field
-})
-```
-
-**Server implementation breaks:**
-```go
-// Before - server expects GetUserRequest
-func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
-    userID := req.UserId  // This field exists
-    // ... implementation
-}
-
-// After - server must handle GetUserRequestV2
-func (s *server) GetUser(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) {
-    userID := req.Id              // Different field name
-    includeProfile := req.IncludeProfile  // New field to handle
-    // ... implementation must change
-}
-```
-
-## Migration Strategy
-
-1. **Add new RPC method** with improved request type:
-   ```proto
-   rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-     option deprecated = true;
-   }
-   rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse);
-   ```
-
-2. **Implement both methods** on server during transition:
-   ```go
-   func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
-       // Legacy implementation
-       return s.getUserInternal(req.UserId, false)
-   }
-   
-   func (s *server) GetUserV2(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) {
-       // New implementation  
-       return s.getUserInternal(req.Id, req.IncludeProfile)
-   }
-   ```
-
-3. **Migrate clients** to use new RPC method:
-   ```go
-   // Update client calls to use V2
-   resp, err := client.GetUserV2(ctx, &myapi.GetUserRequestV2{
-       Id: userID,
-       IncludeProfile: true,
-   })
-   ```
-
-4. **Remove old RPC** in next major version:
-   ```proto
-   // Only keep new version
-   rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse);
-   ```
-
-## Common Scenarios
-
-### Adding Required Fields
-```proto
-// Instead of modifying existing request
-message GetUserRequest {
-  string user_id = 1;
-  bool include_deleted = 2; // BREAKING: new required field
-}
-
-// Add new RPC method  
-message GetUserRequestV2 {
-  string user_id = 1;
-  bool include_deleted = 2;  // Safe in new method
-}
-```
-
-### Restructuring Request Data
-```proto
-// Instead of changing field structure
-message UpdateUserRequest {
-  UserProfile profile = 1; // BREAKING: was individual fields
-}
-
-// Version the RPC
-rpc UpdateUser(UpdateUserRequest) returns (...) {
-  option deprecated = true;
-}
-rpc UpdateUserV2(UpdateUserRequestV2) returns (...);
-```
-
-### Package Migrations
-```proto
-// Instead of changing import packages
-import "v2/messages.proto";  // BREAKING: different package
-
-// Keep old RPC, add new one
-rpc OldMethod(v1.Request) returns (...) {
-  option deprecated = true;  
-}
-rpc NewMethod(v2.Request) returns (...);
-```
diff --git a/docs/public/docs/guide/cli/breaking-changes/rules/rpc-same-response-type.md b/docs/public/docs/guide/cli/breaking-changes/rules/rpc-same-response-type.md
deleted file mode 100644
index 46994412..00000000
--- a/docs/public/docs/guide/cli/breaking-changes/rules/rpc-same-response-type.md
+++ /dev/null
@@ -1,321 +0,0 @@
-# RPC_SAME_RESPONSE_TYPE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that RPC methods maintain the same response message type. Changing an RPC's response type breaks both wire format compatibility and generated code, as clients expect specific message structures when receiving responses from the method.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse);
-}
-
-message GetUserResponse {
-  string user_id = 1;
-  string name = 2;
-  string email = 3;
-}
-
-message UpdateUserResponse {
-  bool success = 1;
-  string message = 2;
-}
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponseV2); // [!code --] Changed response type
-  rpc UpdateUser(UpdateUserRequest) returns (UserUpdateResponse); // [!code --] Changed response type
-}
-
-message GetUserResponseV2 { // [!code --] Different message type
-  string id = 1;
-  UserProfile profile = 2;
-  repeated string permissions = 3;
-}
-
-message UserUpdateResponse { // [!code --] Different message type  
-  UpdateResult result = 1;
-  UserProfile updated_profile = 2;
-}
-```
-
-**Error:**
-```
-user_service.proto:6:3: RPC "GetUser" on service "UserService" changed response type from "GetUserResponse" to "GetUserResponseV2". (BREAKING_CHECK)
-user_service.proto:7:3: RPC "UpdateUser" on service "UserService" changed response type from "UpdateUserResponse" to "UserUpdateResponse". (BREAKING_CHECK)
-```
-
-### More Examples
-
-**Cross-package type changes:**
-
-```proto
-// Before
-import "common/responses.proto";
-
-service UserService {
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-// After - BREAKING CHANGE!
-import "v2/responses.proto";
-
-service UserService {
-  rpc CreateUser(CreateUserRequest) returns (v2.CreateUserResponse); // Different package
-}
-```
-
-### Good
-
-**Instead of changing response type, version the RPC:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-  rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2); // [!code focus] // New RPC method
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-  rpc UpdateUserV2(UpdateUserRequest) returns (UserUpdateResponse); // [!code focus] // New RPC method
-}
-
-// Keep old messages for backward compatibility
-message GetUserResponse {
-  string user_id = 1;
-  string name = 2;
-  string email = 3;
-}
-
-// Add new messages for enhanced functionality  
-message GetUserResponseV2 { // [!code focus]
-  string id = 1; // [!code focus]
-  UserProfile profile = 2; // [!code focus]
-  repeated string permissions = 3; // [!code focus]
-} // [!code focus]
-```
-
-**Or create a new service version:**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus] // New package version
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] // Clean interface in v2
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus]
-}
-
-message GetUserResponse { // [!code focus]
-  string id = 1; // [!code focus] // Improved field names
-  UserProfile profile = 2; // [!code focus]
-  repeated string permissions = 3; // [!code focus]
-} // [!code focus]
-```
-
-## Impact
-
-- **Wire Format:** Server responses cannot be deserialized by existing clients
-- **Generated Code:** Client stubs expect different response message types, breaking compilation
-- **gRPC Calls:** Method signatures change in generated client code
-- **Runtime Errors:** Type mismatches cause RPC response handling failures
-
-## Real-World Example
-
-**Client code breaks:**
-```go
-// Before - this code works
-client := myapi.NewUserServiceClient(conn)
-resp, err := client.GetUser(ctx, &myapi.GetUserRequest{
-    UserId: "user123",
-})
-if err != nil {
-    return err
-}
-
-// Access response fields
-userID := resp.UserId  // This field exists
-name := resp.Name      // This field exists
-
-// After response type change - compilation fails  
-client := myapi.NewUserServiceClient(conn)
-resp, err := client.GetUser(ctx, &myapi.GetUserRequest{
-    UserId: "user123",
-})
-if err != nil {
-    return err
-}
-
-// Access response fields - COMPILATION ERRORS
-userID := resp.UserId  // ERROR: field not found
-name := resp.Name      // ERROR: field not found
-
-// Must use new fields:
-userID := resp.Id                    // Different field name
-profile := resp.Profile             // New structure
-permissions := resp.Permissions     // New field
-```
-
-**Server implementation breaks:**
-```go
-// Before - server returns GetUserResponse
-func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
-    return &GetUserResponse{
-        UserId: "user123",
-        Name:   "John Doe", 
-        Email:  "john@example.com",
-    }, nil
-}
-
-// After - server must return GetUserResponseV2
-func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) {
-    return &GetUserResponseV2{
-        Id: "user123",                    // Different field name
-        Profile: &UserProfile{           // New structure required
-            Name:  "John Doe",
-            Email: "john@example.com",
-        },
-        Permissions: []string{"read"},   // New field to populate
-    }, nil
-}
-```
-
-## Migration Strategy
-
-1. **Add new RPC method** with improved response type:
-   ```proto
-   rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-     option deprecated = true;
-   }
-   rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2);
-   ```
-
-2. **Implement both methods** on server during transition:
-   ```go
-   func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
-       // Legacy implementation
-       user := s.getUserInternal(req.UserId)
-       return &GetUserResponse{
-           UserId: user.ID,
-           Name:   user.Name,
-           Email:  user.Email,
-       }, nil
-   }
-   
-   func (s *server) GetUserV2(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) {
-       // New implementation with enhanced response
-       user := s.getUserInternal(req.UserId)
-       return &GetUserResponseV2{
-           Id: user.ID,
-           Profile: &UserProfile{
-               Name:  user.Name,
-               Email: user.Email,
-           },
-           Permissions: user.Permissions,
-       }, nil
-   }
-   ```
-
-3. **Migrate clients** to use new RPC method:
-   ```go
-   // Update client calls to use V2
-   resp, err := client.GetUserV2(ctx, &myapi.GetUserRequest{
-       UserId: userID,
-   })
-   if err != nil {
-       return err
-   }
-   
-   // Handle new response structure
-   profile := resp.Profile
-   permissions := resp.Permissions
-   ```
-
-4. **Remove old RPC** in next major version:
-   ```proto
-   // Only keep new version
-   rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2);
-   ```
-
-## Common Scenarios
-
-### Adding Fields to Response
-```proto
-// Instead of modifying existing response
-message GetUserResponse {
-  string user_id = 1;
-  string name = 2;
-  UserProfile profile = 3; // BREAKING: new required field
-}
-
-// Add new RPC method  
-message GetUserResponseV2 {
-  string user_id = 1;
-  string name = 2;
-  UserProfile profile = 3;  // Safe in new method
-}
-```
-
-### Restructuring Response Data
-```proto
-// Instead of changing field structure
-message UpdateUserResponse {
-  UserDetails details = 1; // BREAKING: was individual fields
-}
-
-// Version the RPC
-rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) {
-  option deprecated = true;
-}
-rpc UpdateUserV2(UpdateUserRequest) returns (UpdateUserResponseV2);
-```
-
-### Error Handling Changes
-```proto
-// Instead of changing error structure
-message CreateUserResponse {
-  ErrorDetails error = 1; // BREAKING: different error format
-}
-
-// Keep old RPC, add new one
-rpc CreateUser(CreateUserRequest) returns (CreateUserResponse) {
-  option deprecated = true;  
-}
-rpc CreateUserV2(CreateUserRequest) returns (CreateUserResponseV2);
-```
-
-### Response Format Migration
-```proto
-// Instead of changing from simple to complex response
-message GetUserResponse {
-  // BREAKING: changed from simple fields to nested structure
-  UserData data = 1;
-}
-
-// Provide both formats during transition
-rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-  option deprecated = true;
-}
-rpc GetUserDetailed(GetUserRequest) returns (GetUserDetailedResponse);
-```
diff --git a/docs/public/docs/guide/cli/breaking-changes/rules/service-no-delete.md b/docs/public/docs/guide/cli/breaking-changes/rules/service-no-delete.md
deleted file mode 100644
index f2b77af9..00000000
--- a/docs/public/docs/guide/cli/breaking-changes/rules/service-no-delete.md
+++ /dev/null
@@ -1,87 +0,0 @@
-# SERVICE_NO_DELETE
-
-Categories:
-
-- **WIRE+**
-
-This rule checks that no services are deleted from proto files. Deleting a service breaks both generated code and client applications that depend on the service.
-
-## Examples
-
-### Bad
-
-**Before:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-service OrderService { // [!code --]
-  rpc GetOrder(GetOrderRequest) returns (GetOrderResponse); // [!code --]
-} // [!code --]
-```
-
-**After:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-// OrderService was deleted - BREAKING CHANGE!
-```
-
-**Error:**
-```
-services.proto:8:1: Previously present service "OrderService" was deleted from file. (BREAKING_CHECK)
-```
-
-### Good
-
-**Instead of deleting, deprecate the service:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-service OrderService {
-  option deprecated = true; // [!code focus]
-  rpc GetOrder(GetOrderRequest) returns (GetOrderResponse) {
-    option deprecated = true; // [!code focus]
-  }
-}
-```
-
-## Impact
-
-- **Generated Code:** Service classes/interfaces are removed, breaking client compilation
-- **Client Applications:** Existing client code fails to compile
-- **Runtime:** gRPC clients lose service definition
-
-## Migration Strategy
-
-1. **Deprecate first:**
-   ```proto
-   service OldService {
-     option deprecated = true;
-     // ... methods
-   }
-   ```
-
-2. **Notify clients** about deprecation timeline
-
-3. **Remove after migration period** in a new major version
\ No newline at end of file
diff --git a/docs/public/docs/guide/cli/configuration/configuration.md b/docs/public/docs/guide/cli/configuration/configuration.md
deleted file mode 100644
index 5ee5a61f..00000000
--- a/docs/public/docs/guide/cli/configuration/configuration.md
+++ /dev/null
@@ -1,930 +0,0 @@
-# EasyP Configuration Reference
-
-EasyP can be configured through CLI flags, environment variables, and configuration files. This guide covers all configuration options available in EasyP.
-
-## CLI Flags
-
-### Global Flags
-
-Available for all commands:
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--cfg` | `-c` | `EASYP_CFG` | Configuration file path | `easyp.yaml` |
-| `--config` | | `EASYP_CFG` | Alias for `--cfg` | `easyp.yaml` |
-| `--debug` | `-d` | `EASYP_DEBUG` | Enable debug mode | `false` |
-| `--format` | `-f` | `EASYP_FORMAT` | Output format for commands that support multiple formats (`text`/`json`) | command-specific default |
-
-**Examples:**
-```bash
-# Use custom config file
-easyp --cfg production.easyp.yaml lint
-
-# Enable debug logging
-easyp --debug lint
-
-# Short form
-easyp -c custom.yaml -d lint
-```
-
-### Command-Specific Flags
-
-**Lint command:**
-```bash
-easyp lint [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--path` | `-p` | | Directory path to lint | `.` |
-| `--root` | `-r` | | Base directory for file search | Current working directory |
-| `--format` | `-f` | `EASYP_FORMAT` | Uses global format flag (`text`/`json`) | Inherits global default |
-
-**Examples:**
-```bash
-# Lint specific directory
-easyp lint --path proto/
-
-# Lint from subdirectory with proper import resolution
-easyp lint --root src/IPC/Contracts --path .
-
-# JSON output format
-easyp --format json lint   # global flag
-
-# Combined flags
-easyp -f json lint -p proto/
-```
-
-**Generate command:**
-```bash
-easyp generate [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--path` | `-p` | `EASYP_ROOT_GENERATE_PATH` | Directory path with proto files to generate | `.` |
-| `--root` | `-r` | | Base directory for file search | Current working directory |
-
-**Examples:**
-```bash
-# Generate from specific path
-easyp generate --path api/
-
-# Generate from subdirectory with proper import resolution
-easyp generate --root src/IPC/Contracts --path .
-
-# Using environment variable
-EASYP_ROOT_GENERATE_PATH=proto/ easyp generate
-```
-
-**Breaking command:**
-```bash
-easyp breaking [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--against` | | | Git ref to compare against | `master` |
-| `--path` | `-p` | | Directory path to check | `.` |
-| `--format` | `-f` | `EASYP_FORMAT` | Uses global format flag (`text`/`json`) | Inherits global default |
-
-**Examples:**
-```bash
-# Check against main branch
-easyp breaking --against main
-
-# Check specific directory against develop branch
-easyp breaking --against develop --path proto/
-
-# JSON output
-easyp --format json breaking --against main   # global flag
-```
-
-**Init command:**
-```bash
-easyp init [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--dir` | `-d` | `EASYP_INIT_DIR` | Directory to initialize | `.` |
-
-**Examples:**
-```bash
-# Initialize current directory
-easyp init
-
-# Initialize specific directory
-easyp init --dir proto-project/
-```
-
-`easyp init` is interactive:
-- If `buf.yml`/`buf.yaml` exists in the target directory root, it asks whether to migrate from Buf.
-- If `easyp.yaml` already exists, it asks for overwrite confirmation.
-
-**Validate-config command:**
-```bash
-easyp validate-config [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--config` | `-c` | `EASYP_CFG` | Configuration file path | `easyp.yaml` |
-| `--format` (global) | `-f` | `EASYP_FORMAT` | Output format for commands that support multiple formats (`json` or `text`) | command-specific (`json` for `validate-config`) |
-
-**Examples:**
-```bash
-# Validate default config with JSON output (exit 0 when no errors)
-easyp validate-config
-
-# Validate a different file with text output (global --format)
-easyp --format text validate-config --config example.easyp.yaml
-```
-
-**Package management commands:**
-
-#### `easyp mod download`
-Downloads dependencies based on lock file priority:
-
-1. **If `easyp.lock` exists** - downloads exact versions from lock file
-2. **If `easyp.lock` is missing** - downloads versions from `easyp.yaml` and creates `easyp.lock`
-
-```bash
-# Download exact versions (recommended for production)
-easyp mod download
-```
-
-#### `easyp mod update`  
-Always downloads dependencies from `easyp.yaml`, ignoring existing lock file:
-
-1. **Ignores `easyp.lock`** completely
-2. **Downloads versions from `easyp.yaml`**
-3. **Creates/updates `easyp.lock`** with new versions
-
-```bash
-# Update dependencies and lock file
-easyp mod update
-```
-
-#### `easyp mod vendor`
-Copies proto files from dependencies to local `vendor/` directory (similar to `go mod vendor`).
-
-```bash
-# Create local vendor directory with dependencies
-easyp mod vendor
-```
-
-No additional flags. Uses global `--cfg` flag for configuration.
-
-## Environment Variables
-
-EasyP supports environment variables for configuration:
-
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `EASYP_CFG` | Path to configuration file | `easyp.yaml` |
-| `EASYP_DEBUG` | Enable debug logging | `false` |
-| `EASYPPATH` | Cache and modules storage directory | `$HOME/.easyp` |
-| `EASYP_FORMAT` | Output format for supported commands (`text`/`json`). If not set, each command uses its own default. | command-specific default |
-| `EASYP_ROOT_GENERATE_PATH` | Root path for generate command | `.` |
-| `EASYP_INIT_DIR` | Directory for init command | `.` |
-
-**Examples:**
-```bash
-# Custom cache directory
-export EASYPPATH=/tmp/easyp-cache
-easyp mod download
-
-# Debug mode via environment
-export EASYP_DEBUG=true
-easyp lint
-
-# Custom config file
-export EASYP_CFG=config/easyp.yaml
-easyp generate
-```
-
-## Configuration File
-
-The `easyp.yaml` file is the main configuration file for EasyP, defining how your proto files are linted, generated, and managed. This file is typically placed at the root of your project alongside your proto files.
-
-### File Structure Overview
-
-```
-.
-├── easyp.yaml
-├── easyp.lock
-├── proto/
-│   ├── user/
-│   │   └── user.proto
-│   └── order/
-│       └── order.proto
-└── vendor/
-```
-
-### Configuration Format
-
-EasyP supports both YAML and JSON configuration formats:
-
-#### YAML Format (Recommended)
-```yaml
-lint:
-  use:
-    - BASIC
-    - COMMENT_SERVICE
-deps:
-  - github.com/googleapis/googleapis@v1.0.0
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-breaking:
-  ignore:
-    - proto/experimental/
-  against_git_ref: main
-```
-
-#### JSON Format
-```json
-{
-  "lint": {
-    "use": ["BASIC", "COMMENT_SERVICE"]
-  },
-  "deps": [
-    "github.com/googleapis/googleapis@v1.0.0"
-  ],
-  "generate": {
-    "inputs": [
-      {"directory": "proto"}
-    ],
-    "plugins": [
-      {
-        "name": "go",
-        "out": ".",
-        "opts": {
-          "paths": "source_relative"
-        }
-      }
-    ]
-  },
-  "breaking": {
-    "ignore": ["proto/experimental/"],
-    "against_git_ref": "main"
-  }
-}
-```
-
-### Environment Variables in Configuration
-
-EasyP supports environment variable expansion directly in the `easyp.yaml` configuration file. This allows you to use environment variables for dynamic configuration values.
-
-**Example with all supported features:**
-```yaml
-deps:
-  # Basic expansion: ${VAR} - expands to the value of VAR
-  - ${GOOGLEAPIS_REPO}@${GOOGLEAPIS_VERSION}
-  
-  # Default value: ${VAR:-default} - uses default if VAR is unset or empty
-  - ${GNOSTIC_REPO:-github.com/google/gnostic}@${GNOSTIC_VERSION:-v0.7.0}
-
-generate:
-  inputs:
-    # Default value if INPUT_DIR is not set
-    - directory: ${INPUT_DIR:-proto}
-  plugins:
-    - name: go
-      # Basic expansion
-      out: ${OUTPUT_DIR}
-      opts:
-        # Default value
-        module: ${MODULE_NAME:-github.com/example/project}
-        timeout: ${TIMEOUT:-30}
-        
-        # Escaping: $$ becomes literal $, $${VAR} becomes literal ${VAR}
-        path: "${BASE_DIR}/$${TEMP}/file"     # Result: "/tmp/${TEMP}/file" (if BASE_DIR=/tmp)
-        literal: "$$"                         # Result: "$"
-```
-
-**Supported syntax:**
-- `${VAR}` - expands to the value of `VAR`
-- `${VAR:-default}` - uses `default` if `VAR` is unset or empty
-- `${VAR:=default}` - uses `default` if `VAR` is unset or empty
-- `${VAR-default}` - uses `default` if `VAR` is unset (empty string is kept)
-- `$${VAR}` or `$$VAR` - escapes to literal `${VAR}` or `$VAR`
-- `$$` - escapes to literal `$`
-
-**Note:** Environment variables are expanded before YAML parsing, so any `${STRING}` pattern will be processed. Use `$$` to escape dollar signs when you need literal values.
-
-## Configuration Fields
-
-### `version`
-
-**Optional (legacy compatibility).** This field is accepted for backward compatibility and can be omitted in new configs.
-
-**Type:** `string`
-**Default:** omitted
-**Recommendation:** if you keep it, use `v1alpha`
-
-```yaml
-# Optional compatibility field (can be omitted)
-version: v1alpha
-```
-
-The runtime behavior does not depend on this field.
-
-### `lint`
-
-**Optional.** Configures proto file linting rules and behavior.
-
-**Type:** `object`
-**Default:** Empty (no linting rules applied)
-
-```yaml
-lint:
-  use:
-    - BASIC
-    - COMMENT_SERVICE
-  enum_zero_value_suffix: "UNSPECIFIED"
-  service_suffix: "Service"
-  ignore:
-    - vendor/
-    - proto/legacy/
-  except:
-    - COMMENT_FIELD
-  allow_comment_ignores: true
-  ignore_only:
-    COMMENT_SERVICE:
-      - proto/experimental/
-```
-
-#### `lint.use`
-
-**Optional.** Specifies which linter rules or rule categories to apply.
-
-**Type:** `[]string`
-**Default:** `[]` (no rules)
-
-**Available categories:**
-- `MINIMAL` - Essential package consistency checks
-- `BASIC` - Naming conventions and common patterns
-- `DEFAULT` - Additional recommended rules
-- `COMMENTS` - Comment requirements
-- `UNARY_RPC` - Streaming RPC restrictions
-
-**Individual rules:** Any specific rule name (e.g., `ENUM_PASCAL_CASE`, `FIELD_LOWER_SNAKE_CASE`)
-
-```yaml
-lint:
-  use:
-    - MINIMAL           # Use all minimal rules
-    - BASIC             # Use all basic rules
-    - COMMENT_SERVICE   # Require service comments
-    - ENUM_PASCAL_CASE  # Specific rule
-```
-
-**Rule Categories:**
-
-**MINIMAL:**
-- `DIRECTORY_SAME_PACKAGE`
-- `PACKAGE_DEFINED`
-- `PACKAGE_DIRECTORY_MATCH`
-- `PACKAGE_SAME_DIRECTORY`
-
-**BASIC:**
-- `ENUM_FIRST_VALUE_ZERO`
-- `ENUM_NO_ALLOW_ALIAS`
-- `ENUM_PASCAL_CASE`
-- `ENUM_VALUE_UPPER_SNAKE_CASE`
-- `FIELD_LOWER_SNAKE_CASE`
-- `IMPORT_NO_PUBLIC`
-- `IMPORT_NO_WEAK`
-- `IMPORT_USED`
-- `MESSAGE_PASCAL_CASE`
-- `ONEOF_LOWER_SNAKE_CASE`
-- `PACKAGE_LOWER_SNAKE_CASE`
-- `PACKAGE_SAME_CSHARP_NAMESPACE`
-- `PACKAGE_SAME_GO_PACKAGE`
-- `PACKAGE_SAME_JAVA_MULTIPLE_FILES`
-- `PACKAGE_SAME_JAVA_PACKAGE`
-- `PACKAGE_SAME_PHP_NAMESPACE`
-- `PACKAGE_SAME_RUBY_PACKAGE`
-- `PACKAGE_SAME_SWIFT_PREFIX`
-- `RPC_PASCAL_CASE`
-- `SERVICE_PASCAL_CASE`
-
-**DEFAULT:**
-- `ENUM_VALUE_PREFIX`
-- `ENUM_ZERO_VALUE_SUFFIX`
-- `FILE_LOWER_SNAKE_CASE`
-- `RPC_REQUEST_RESPONSE_UNIQUE`
-- `RPC_REQUEST_STANDARD_NAME`
-- `RPC_RESPONSE_STANDARD_NAME`
-- `PACKAGE_VERSION_SUFFIX`
-- `SERVICE_SUFFIX`
-
-**COMMENTS:**
-- `COMMENT_ENUM`
-- `COMMENT_ENUM_VALUE`
-- `COMMENT_FIELD`
-- `COMMENT_MESSAGE`
-- `COMMENT_ONEOF`
-- `COMMENT_RPC`
-- `COMMENT_SERVICE`
-
-**UNARY_RPC:**
-- `RPC_NO_CLIENT_STREAMING`
-- `RPC_NO_SERVER_STREAMING`
-
-#### `lint.enum_zero_value_suffix`
-
-**Optional.** Specifies the required suffix for enum zero values.
-
-**Type:** `string`
-**Default:** `""` (no suffix required)
-**Common values:** `"UNSPECIFIED"`, `"UNKNOWN"`, `"DEFAULT"`
-
-```yaml
-lint:
-  enum_zero_value_suffix: "UNSPECIFIED"
-```
-
-This enforces enum zero values like:
-```proto
-enum Status {
-  STATUS_UNSPECIFIED = 0;  // Required suffix
-  STATUS_ACTIVE = 1;
-  STATUS_INACTIVE = 2;
-}
-```
-
-#### `lint.service_suffix`
-
-**Optional.** Specifies the required suffix for service names.
-
-**Type:** `string`
-**Default:** `""` (no suffix required)
-**Common values:** `"Service"`, `"API"`, `"Svc"`
-
-```yaml
-lint:
-  service_suffix: "Service"
-```
-
-This enforces service names like:
-```proto
-service UserService {    // Required "Service" suffix
-  rpc GetUser(...) returns (...);
-}
-```
-
-#### `lint.ignore`
-
-**Optional.** Directories or files to exclude from all linting rules.
-
-**Type:** `[]string`
-**Default:** `[]`
-
-```yaml
-lint:
-  ignore:
-    - vendor/
-    - proto/legacy/
-    - testdata/
-    - "**/*_test.proto"
-```
-
-Paths are relative to the `easyp.yaml` file location. Supports glob patterns.
-
-#### `lint.except`
-
-**Optional.** Disables specific rules globally across the entire project.
-
-**Type:** `[]string`
-**Default:** `[]`
-
-```yaml
-lint:
-  except:
-    - COMMENT_FIELD
-    - COMMENT_MESSAGE
-    - SERVICE_SUFFIX
-```
-
-#### `lint.allow_comment_ignores`
-
-**Optional.** Enables inline comment-based rule ignoring within proto files.
-
-**Type:** `boolean`
-**Default:** `false`
-
-```yaml
-lint:
-  allow_comment_ignores: true
-```
-
-When enabled, allows comments like:
-```proto
-// buf:lint:ignore COMMENT_SERVICE
-service LegacyAPI {
-  // nolint:COMMENT_RPC
-  rpc GetData(...) returns (...);
-}
-```
-
-#### `lint.ignore_only`
-
-**Optional.** Disables specific rules only for certain files or directories.
-
-**Type:** `map[string][]string`
-**Default:** `{}`
-
-```yaml
-lint:
-  ignore_only:
-    COMMENT_SERVICE:
-      - proto/legacy/
-      - vendor/
-    SERVICE_SUFFIX:
-      - proto/external/
-```
-
-**Key:** Rule name or category
-**Value:** Array of file paths or directories
-
-### `deps`
-
-**Optional.** Lists external proto dependencies to download and manage.
-
-**Type:** `[]string`  
-**Default:** `[]`
-
-#### Dependency Format
-
-Dependencies follow the format: `$GIT_LINK@$VERSION`
-
-**Components:**
-- `$GIT_LINK` - Git repository URL (GitHub, GitLab, etc.)
-- `$VERSION` - Git tag or full commit hash (optional)
-
-**Format variations:**
-- `owner/repo` - Latest commit from default branch
-- `owner/repo@v1.0.0` - Specific git tag
-- `owner/repo@47b927cbb41c4fdea1292baf` - Full commit hash
-- `github.com/owner/repo@version` - Full URL with version
-- `gitlab.com/group/repo@tag` - GitLab repository
-
-```yaml
-deps:
-  # Latest commit from default branch
-  - googleapis/googleapis
-  
-  # Specific tag (recommended for production)
-  - googleapis/googleapis@v1.0.0
-  
-  # Full commit hash (most precise)
-  - googleapis/googleapis@47b927cbb41c4fdea1292bafadb8976f
-  
-  # Different Git hosting
-  - gitlab.com/acme/proto@v2.1.0
-```
-
-**Note:** If `@$VERSION` is omitted, EasyP downloads the latest commit from the repository's default branch.
-
-### `generate`
-
-**Optional.** Configures code generation from proto files.
-
-**Type:** `object`
-**Default:** `{}`
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-    - git_repo:
-        url: "github.com/acme/common@v1.0.0"
-        sub_directory: "proto"
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-```
-
-#### `generate.inputs`
-
-**Required when `generate` is set.** Specifies sources of proto files for generation.
-
-**Type:** `[]object` (minimum 1 item)
-**Default:** not set
-
-```yaml
-generate:
-  inputs:
-    # Local directory
-    - directory: "proto"
-
-    # Local directory with advanced options
-    - directory:
-        path: "api/proto"
-        root: "."
-
-    # Remote git repository
-    - git_repo:
-        url: "github.com/acme/common@v1.0.0"
-        sub_directory: "proto"
-        root: "."
-```
-
-**Directory input fields:**
-- `directory` (string or object) - Local directory path
-- `directory.path` (string) - Directory path
-- `directory.root` (string) - Root path for import resolution (default: ".")
-
-**Git repository input fields:**
-- `git_repo.url` (string) - Repository URL with optional version
-- `git_repo.sub_directory` (string) - Subdirectory within the repository
-- `git_repo.root` (string) - Root path used for import resolution
-
-#### `generate.plugins`
-
-**Required when `generate` is set.** Configures protoc plugins for code generation.
-
-**Type:** `[]object` (minimum 1 item)
-**Default:** not set
-
-```yaml
-generate:
-  plugins:
-    # Local plugin
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-
-    # Remote plugin
-    - remote: "buf.build/bufbuild/protovalidate-go:v0.4.0"
-      out: gen/go
-      opts:
-        paths: source_relative
-
-    # Plugin with import dependencies
-    - name: grpc-gateway
-      out: .
-      with_imports: true
-      opts:
-        paths: source_relative
-```
-
-**Plugin fields:**
-- `name` (string, optional) - Plugin name (omit `protoc-gen-` prefix)
-- `remote` (string, optional) - Remote plugin URL for execution
-- `path` (string, optional) - Path to plugin executable file
-- `command` ([]string, optional) - Command to execute plugin
-- `out` (string, optional) - Output directory for generated files; defaults to the resolved generate root
-- `opts` (map[string](string | number | boolean | array<string | number | boolean>), optional) - Plugin-specific options; each key can be a single scalar value or an array of scalar values
-- `with_imports` (boolean, optional) - Include imported dependencies
-
-Plugin source is `one-of`: exactly one of `name`, `remote`, `path`, or `command` must be set.
-
-**Common plugin options:**
-```yaml
-# Go plugin options
-opts:
-  paths: source_relative              # Generate files relative to input
-  module: github.com/acme/api        # Go module path
-
-# gRPC Gateway options
-opts:
-  paths: source_relative
-  grpc_api_configuration: api.yaml   # gRPC API configuration
-
-# OpenAPI v2 options
-opts:
-  simple_operation_ids: true         # Use simple operation IDs
-  generate_unbound_methods: false    # Skip unbound methods
-
-# ts-proto options with repeated key values
-opts:
-  env: node
-  outputServices:
-    - grpc-js
-    - generic-definitions
-```
-
-When an `opts` value is a list, EasyP serializes it as repeated plugin params, e.g. `outputServices=grpc-js,outputServices=generic-definitions`.
-
-### `breaking`
-
-**Optional.** Configures backward compatibility checking.
-
-**Type:** `object`
-**Default:** `{}`
-
-```yaml
-breaking:
-  ignore:
-    - proto/experimental/
-    - proto/internal/
-  against_git_ref: main
-```
-
-#### `breaking.ignore`
-
-**Optional.** Directories or files to exclude from breaking change detection.
-
-**Type:** `[]string`
-**Default:** `[]`
-
-```yaml
-breaking:
-  ignore:
-    - proto/experimental/
-    - proto/alpha/
-    - testdata/
-```
-
-#### `breaking.against_git_ref`
-
-**Optional.** Git reference (branch, tag, or commit) to compare against for breaking changes.
-
-**Type:** `string`
-**Default:** `""` (falls back to CLI `--against` default: `master`)
-
-```yaml
-breaking:
-  against_git_ref: main
-```
-
-Can be overridden by the `--against` CLI flag.
-
-
-
-## Configuration Examples
-
-### Minimal Configuration
-
-```yaml
-lint:
-  use:
-    - MINIMAL
-```
-
-### Development Configuration
-
-```yaml
-lint:
-  use:
-    - BASIC
-    - COMMENT_SERVICE
-    - COMMENT_RPC
-  allow_comment_ignores: true
-  ignore:
-    - vendor/
-    - testdata/
-deps:
-  - github.com/googleapis/googleapis@v1.0.0
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-```
-
-### Production Configuration
-
-```yaml
-lint:
-  use:
-    - MINIMAL
-    - BASIC
-    - DEFAULT
-    - COMMENTS
-  enum_zero_value_suffix: "UNSPECIFIED"
-  service_suffix: "Service"
-  ignore:
-    - vendor/
-  except: []
-  allow_comment_ignores: false
-deps:
-  - github.com/googleapis/googleapis@v1.56.0
-  - github.com/grpc-ecosystem/grpc-gateway@v2.18.0
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-        module: github.com/acme/api/gen/go
-    - name: go-grpc
-      out: gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-    - name: grpc-gateway
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: openapiv2
-      out: gen/openapi
-      opts:
-        simple_operation_ids: true
-breaking:
-  ignore:
-    - proto/experimental/
-  against_git_ref: main
-```
-
-### Multi-Service Configuration
-
-```yaml
-lint:
-  use:
-    - BASIC
-    - COMMENT_SERVICE
-    - COMMENT_RPC
-  service_suffix: "Service"
-  ignore_only:
-    COMMENT_FIELD:
-      - proto/internal/
-    SERVICE_SUFFIX:
-      - proto/legacy/
-deps:
-  - github.com/googleapis/googleapis@v1.0.0
-  - github.com/acme/common-proto@v2.1.0
-generate:
-  inputs:
-    - directory: "proto/public"
-    - directory: "proto/internal"
-    - git_repo:
-        url: "github.com/acme/shared-proto@v1.0.0"
-        sub_directory: "proto"
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: grpc-gateway
-      out: gen/go
-      opts:
-        paths: source_relative
-    - remote: "buf.build/bufbuild/protovalidate-go:v0.4.0"
-      out: gen/go
-      opts:
-        paths: source_relative
-breaking:
-  ignore:
-    - proto/internal/
-    - proto/experimental/
-  against_git_ref: develop
-```
-
-## Configuration Validation
-
-EasyP validates configuration files on startup and provides helpful error messages:
-
-```bash
-# Invalid rule name
-Error: invalid rule: INVALID_RULE_NAME
-
-# Missing required field in generate section
-Error: required field "plugins" is missing (path: generate.plugins)
-
-# Invalid dependency format
-Error: invalid dependency format: invalid-repo-url
-```
-
-Use `easyp --debug` for detailed validation information.
-
-## Migration from Buf
-
-EasyP is fully compatible with Buf configurations. To migrate:
-
-1. Place `buf.yaml` or `buf.yml` in the project root
-2. Run `easyp init` and confirm migration when prompted
-3. Update `deps` format if using BSR modules
-4. Review migrated lint/breaking settings and adjust as needed
-
-Most Buf configurations work without changes in EasyP.
diff --git a/docs/public/docs/guide/cli/generator/examples/go.md b/docs/public/docs/guide/cli/generator/examples/go.md
deleted file mode 100644
index 9a599eae..00000000
--- a/docs/public/docs/guide/cli/generator/examples/go.md
+++ /dev/null
@@ -1,82 +0,0 @@
-# Go
-
-## Installing Plugins
-
-First, install the necessary plugins for working with gRPC:
-
-```shell
-go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
-go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
-```
-
-These commands will install the `protoc-gen-go` and `protoc-gen-go-grpc` plugins for use with EasyP.
-
-## Example Proto Service
-
-Here is an example proto file for an Echo service:
-
-```proto
-syntax = "proto3";
-
-package api.echo.v1;
-
-option go_package = "github.com/easyp-tech/example/api/echo/v1;pb";
-
-service EchoAPI {
-  rpc Echo(EchoRequest) returns (EchoResponse);
-  rpc EchoStream(EchoStreamRequest) returns (EchoResponse);
-}
-
-message EchoRequest {
-  string payload = 1;
-}
-
-message EchoResponse {
-  string payload = 2;
-}
-
-message EchoStreamRequest {
-  string payload = 1;
-}
-
-message EchoStreamResponse {
-  string payload = 2;
-}
-```
-
-## Configuration Setup
-
-Create and configure the easyp.yaml configuration file:
-
-```yaml
-generate:
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-```
-
-This file specifies that two plugins will be used: `go` for generating Go code and `go-grpc` for generating gRPC code, along with their respective options.
-
-## Generating Code
-
-To generate code, use the following command:
-
-```shell
-easyp --cfg easyp.yaml generate
-```
-
-If the --cfg flag is not specified, the easyp.yaml file in the current directory will be used by default:
-
-```shell
-easyp generate
-```
-
-Now you have the generated Go code, which you can interact with directly.
-
diff --git a/docs/public/docs/guide/cli/generator/examples/grpc-gateway.md b/docs/public/docs/guide/cli/generator/examples/grpc-gateway.md
deleted file mode 100644
index 12b23425..00000000
--- a/docs/public/docs/guide/cli/generator/examples/grpc-gateway.md
+++ /dev/null
@@ -1,127 +0,0 @@
-# gRPC-Gateway
-
-## Installing Plugins
-
-In addition to the plugins for working with gRPC, you also need to install the following plugins for gRPC-Gateway:
-
-```bash
-go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
-go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
-go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2@latest
-go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest
-```
-
-These commands will install the `protoc-gen-go`, `protoc-gen-go-grpc`, `protoc-gen-openapiv2`, and
-`protoc-gen-grpc-gateway` plugins for use with EasyP`.
-
-## Example Proto Service
-
-Here is the initial proto file for an Echo service:
-
-```proto
-syntax = "proto3";
-
-package api.echo.v1;
-
-option go_package = "github.com/easyp-tech/example/api/echo/v1;pb";
-
-service EchoAPI {
-  rpc Echo(EchoRequest) returns (EchoResponse);
-}
-
-message EchoRequest {
-  string payload = 1;
-}
-
-message EchoResponse {
-  string payload = 2;
-}
-```
-
-To use gRPC-Gateway, update the proto file to include HTTP options:
-
-```proto
-syntax = "proto3";
-import "google/api/annotations.proto";
-
-package api.echo.v1;
-
-option go_package = "github.com/easyp-tech/example/api/echo/v1;pb";
-
-service EchoAPI {
-  rpc Echo(EchoRequest) returns (EchoResponse) {
-    option (google.api.http) = { // [!code ++]
-      post: "/api/v1/echo"       // [!code ++]
-      body: "*"                  // [!code ++]
-    };                           // [!code ++]
-  }
-}
-
-message EchoRequest {
-  string payload = 1;
-}
-
-message EchoResponse {
-  string payload = 2;
-}
-```
-
-## Configuration Setup
-
-Update your `easyp.yaml` configuration file to include the necessary dependencies and plugins:
-
-```yaml
-deps:  # [!code ++]
-  - github.com/googleapis/googleapis  # [!code ++]
-
-generate:
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-    - name: grpc-gateway  # [!code ++]
-      out: .  # [!code ++]
-      opts:  # [!code ++]
-        paths: source_relative  # [!code ++]
-    - name: openapiv2        # [!code ++]
-      out: .  # [!code ++]
-      opts: # [!code ++]
-        simple_operation_ids: false  # [!code ++]
-        generate_unbound_methods: false  # [!code ++]
-```
-
-The `deps` section lists dependencies required for proto file imports.
-In this case, we add `github.com/googleapis/googleapis`
-because it contains the `annotations.proto` file used in the proto service definition.
-
-### Updating Dependencies
-
-After updating your configuration file, run the following command to download the specified dependencies:
-
-```bash
-easyp mod update
-```
-
-For more details on managing dependencies, refer to the [Package Manager](../../package-manager/package-manager.md) section.
-
-## Generating Code
-
-To generate the code, use the following command:
-
-```bash
-easyp --cfg easyp.yaml generate
-```
-
-If the `--cfg` flag is not specified, the `easyp.yaml` file in the current directory will be used by default:
-
-```bash
-easyp generate
-```
-
-Now you have the generated Go and gRPC-Gateway code, which you can interact with directly. 
diff --git a/docs/public/docs/guide/cli/generator/examples/validate.md b/docs/public/docs/guide/cli/generator/examples/validate.md
deleted file mode 100644
index 08d8b831..00000000
--- a/docs/public/docs/guide/cli/generator/examples/validate.md
+++ /dev/null
@@ -1,90 +0,0 @@
-# Validate
-
-## Installing Plugins
-
-First, install the necessary plugins for working with gRPC:
-
-```shell
-go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
-go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
-go install github.com/envoyproxy/protoc-gen-validate@latest
-```
-
-These commands will install the `protoc-gen-go` and `protoc-gen-go-grpc` and `protoc-gen-validate` plugins for use with EasyP.
-
-## Example Proto Service
-
-Here is an example proto file for an Echo service:
-
-```proto
-syntax = "proto3";
-
-package api.echo.v1;
-
-import "validate/validate.proto";
-
-option go_package = "github.com/easyp-tech/example/api/echo/v1;pb";
-
-service EchoAPI {
-  rpc Echo(EchoRequest) returns (EchoResponse);
-  rpc EchoStream(EchoStreamRequest) returns (EchoResponse);
-}
-
-message EchoRequest {
-  string payload = 1 [(validate.rules).string = {max_len: 200}];
-}
-
-message EchoResponse {
-  string payload = 2;
-}
-
-message EchoStreamRequest {
-  string payload = 1 [(validate.rules).string = {max_len: 200}];
-}
-
-message EchoStreamResponse {
-  string payload = 2;
-}
-```
-
-## Configuration Setup
-
-Create and configure the easyp.yaml configuration file:
-
-```yaml
-deps: # [!code ++]
-  - github.com/bufbuild/protoc-gen-validate  # [!code ++]
-
-generate:
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-    - name: validate
-      out: .
-      opts:
-        paths: source_relative
-        lang: "go"
-```
-
-## Generating Code
-
-To generate code, use the following command:
-
-```shell
-easyp --cfg easyp.yaml generate
-```
-
-If the --cfg flag is not specified, the easyp.yaml file in the current directory will be used by default:
-
-```shell
-easyp generate
-```
-
-Now you have the generated Go code, which you can interact with directly.
diff --git a/docs/public/docs/guide/cli/generator/generator.md b/docs/public/docs/guide/cli/generator/generator.md
deleted file mode 100644
index fcb3510b..00000000
--- a/docs/public/docs/guide/cli/generator/generator.md
+++ /dev/null
@@ -1,1326 +0,0 @@
-# Generator
-
-[[toc]]
-
-EasyP includes a powerful generator that simplifies the process of generating code from proto files. By using YAML configurations, EasyP makes this process more user-friendly and intuitive compared to using the protoc command directly.
-
-## Key Features of the Generator
-
-1. **Simplified Code Generation**:
-    - Generate code from proto files using a `YAML` configuration.
-    - Avoid the need to write long and complex protoc commands.
-
-2. **Wrapper around protoc**:
-    - EasyP functions as a wrapper around protoc, providing a more convenient API through configuration files.
-    - Supports all options and plugins available in protoc.
-
-3. **Flexibility and Customization**:
-    - Use the same parameters as protoc plugins, directly in the configuration file.
-    - Support for multiple plugins and their parameters in a single configuration.
-
-4. **Generate Code from Multiple Sources**:
-    - Generate code from local directories or remote repositories.
-    - Easily integrate with existing projects and repositories.
-
-5. **Remote Generation**:
-    - Generate code from remote Git repositories without local checkout.
-
-6. **Package Manager Integration**:
-    - Seamless integration with EasyP's package manager for dependency management.
-    - Automatic resolution and inclusion of proto dependencies.
-
-## Configuration Reference
-
-### Complete Configuration Example
-
-```yaml
-# Package manager dependencies
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-  - github.com/bufbuild/protoc-gen-validate@v0.10.1
-
-# Code generation configuration
-generate:
-  inputs:
-    # Local directory input
-    - directory: 
-        path: "proto"
-        root: "."
-    
-    # Remote Git repository input
-    - git_repo:
-        url: "github.com/acme/weather@v1.2.3"
-        sub_directory: "proto/api"
-    # Another remote repository
-    - git_repo:
-        url: "https://github.com/company/internal-protos.git"
-        sub_directory: "definitions"
-  plugins:
-    # Local plugin execution
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        module: github.com/mycompany/myproject
-      with_imports: true
-    
-    # Local plugin with custom options
-    - name: go-grpc
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-
-  # Managed mode - automatically set file and field options
-  managed:
-    enabled: true
-    disable:
-      - module: github.com/googleapis/googleapis  # Disable for specific module
-    override:
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-      - file_option: java_package_prefix
-        value: com.mycompany
-      - file_option: csharp_namespace_prefix
-        value: MyCompany
-      - field_option: jstype
-        value: JS_STRING
-        path: api/v1/  # Apply to specific path
-
-```
-
-### Input Sources
-
-#### Local Directory Input
-
-Local directory input is the most common and straightforward way to specify proto files for generation. Use this when your proto files are already present in your project directory structure.
-
-**When to use:**
-- Proto files are part of your project repository
-- You need full control over proto file organization
-- Working with a single service or application
-- Proto files don't change frequently
-
-```yaml
-inputs:
-  - directory: "proto"                    # Simple string format
-  
-  # OR detailed format
-  - directory:
-      path: "proto"                       # Path to proto files
-      root: "."                          # Root directory for import resolution
-```
-
-The `root` parameter is particularly useful in monorepo setups where you need to control import path resolution. When `root` is set to a parent directory, import paths in your proto files will be resolved relative to that root, not the current working directory.
-
-**Parameters:**
-
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `path` | string | ✅ | - | Path to the directory containing proto files |
-| `root` | string | ❌ | `"."` | Root directory used for import path resolution |
-
-**Examples:**
-
-These examples show the difference between basic directory specification and advanced configuration with custom import resolution:
-
-```yaml
-# Basic usage - Simple path specification
-inputs:
-  - directory: "api/proto"
-
-# Advanced usage with custom root - Controls import path resolution
-inputs:
-  - directory:
-      path: "services/auth/proto" 
-      root: "services/auth"        # Imports will be relative to this path
-```
-
-#### Remote Git Repository Input
-
-Remote Git repository input allows you to generate code from proto files hosted in external repositories without requiring a local checkout. This is particularly powerful for consuming APIs from other teams or external vendors.
-
-**When to use:**
-- Consuming proto definitions from other teams or services
-- Integrating with vendor APIs that provide proto definitions
-- Working with shared proto libraries across multiple projects
-- You want to ensure you're always using the correct version of external APIs
-
-**Recommended approach:**
-- Always pin to specific versions in production (`@v1.0.0`, not latest)
-- Use semantic versions when available for easier dependency management
-- Prefer public tags over commit hashes for better traceability
-
-```yaml
-inputs:
-  - git_repo:
-      url: "github.com/company/protos@v1.0.0"    # Required: Repository URL with optional version
-      sub_directory: "api"                        # Optional: Subdirectory within repo
-```
-
-The `root` parameter controls import resolution root for files from this repository.
-
-**Parameters:**
-
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `url` | string | ✅ | - | Git repository URL with optional version/tag/commit |
-| `sub_directory` | string | ❌ | `""` | Subdirectory within the repository containing proto files |
-| `root` | string | ❌ | `""` | Root path used for import resolution |
-
-**URL Format Options:**
-
-EasyP supports multiple URL formats to give you flexibility in how you reference remote repositories. Each format serves different use cases depending on your stability and versioning requirements:
-
-- **Tagged versions** are recommended for production as they provide stable, immutable references
-- **Semantic versions** offer better readability and dependency management
-- **Commit hashes** give you access to specific commits when tags aren't available
-- **Latest** should only be used in development environments due to unpredictability
-- **Full HTTPS URLs** are useful for private repositories or non-GitHub hosting
-
-```yaml
-# Tag version - Best for production stability
-url: "github.com/googleapis/googleapis@common-protos-1_3_1"
-
-# Semantic version - Easier dependency management
-url: "github.com/grpc-ecosystem/grpc-gateway@v2.19.1"  
-
-# Commit hash - When you need a specific commit
-url: "github.com/company/protos@abc123def456"
-
-# Latest - Development only, not recommended for production
-url: "github.com/company/protos"
-
-# Full HTTPS URL - For private repos or custom Git hosts
-url: "https://github.com/company/private-protos.git"
-```
-
-**Examples:**
-
-These examples demonstrate common patterns for consuming remote proto definitions from different types of repositories:
-
-```yaml
-# Public repository with specific version - Most common for external APIs
-inputs:
-  - git_repo:
-      url: "github.com/googleapis/googleapis@common-protos-1_3_1"
-      sub_directory: "google"
-# Private repository with authentication - For internal company APIs
-inputs:
-  - git_repo:
-      url: "github.com/mycompany/internal-protos@v2.1.0"
-      sub_directory: "api/definitions"
-# Multiple remote sources - Common in microservices architectures
-inputs:
-  - git_repo:
-      url: "github.com/grpc-ecosystem/grpc-gateway@v2.19.1"
-      sub_directory: "protoc-gen-openapiv2/options"
-  - git_repo:
-      url: "github.com/bufbuild/protoc-gen-validate@v0.10.1"  
-      sub_directory: "validate"
-```
-
-### Plugin Configuration
-
-Plugin configuration is where you specify which code generators to run and how they should behave. EasyP supports any protoc plugin, making it extremely flexible for different language ecosystems and use cases.
-
-At a high level, there are **four ways to specify how a plugin should be executed**:
-
-- **`name`** – run plugin by name from `PATH` or use a builtin plugin.
-- **`path`** – run plugin by absolute/relative path to an executable file.
-- **`remote`** – run plugin via remote URL (EasyP remote executor).
-- **`command`** – run plugin via arbitrary command (for example, `go run ...`).
-
-Only **one** of `name`, `path`, `remote`, or `command` must be specified for each plugin.
-
-#### Plugin by Name (`name`)
-
-Local plugin execution by name is the standard approach where plugins are installed on your system and executed directly by EasyP.
-
-**When to use `name`:**
-- Standard language support (Go, Python, TypeScript, etc.)
-- You have control over the build environment
-- Performance is critical (no network overhead)
-- You want to rely on PATH or builtin plugins
-
-**Installation requirements:**
-- Plugins must be installed and available in your PATH (if not using builtin plugins).
-- Plugin names follow the `protoc-gen-{name}` convention.
-- Use package managers (go install, npm install, pip install) for installation.
-
-```yaml
-plugins:
-  - name: go                              # Plugin name (must be installed locally or builtin)
-    out: ./generated                      # Output directory
-    opts:                                 # Plugin-specific options
-      paths: source_relative
-      module: github.com/mycompany/project
-    with_imports: true                    # Include dependency imports
-```
-
-The `with_imports` parameter is crucial when you're using dependencies from the package manager. Set it to `true` to include proto files from your `deps` section in the generation process.
-
-#### Plugin by Path (`path`)
-
-Sometimes you need to run a plugin from a specific binary without putting it into `PATH` (for example, a binary in your repo or in a build directory). In this case you can specify an explicit path:
-
-```yaml
-plugins:
-  - path: ./bin/protoc-gen-my-custom
-    out: ./gen/custom
-    opts:
-      foo: bar
-```
-
-**When to use `path`:**
-- You keep plugin binaries in the repository (for reproducible builds).
-- You use different plugin versions side-by-side.
-- You don't want to pollute the global `PATH`.
-
-#### Remote Plugin (`remote`)
-
-Remote plugins are executed via a remote URL. EasyP will send a `CodeGeneratorRequest` to the remote endpoint and receive a `CodeGeneratorResponse` back.
-
-Below is a real example of using the EasyP API Service as a remote plugin executor (same format as in the API Service docs):
-
-```yaml
-generate:
-  plugins:
-    # Remote plugin execution via EasyP API Service
-    - remote: api.easyp.tech/protobuf/go:v1.36.10
-      out: .
-      opts:
-        paths: source_relative
-
-    - remote: api.easyp.tech/grpc/go:v1.5.1
-      out: .
-      opts:
-        paths: source_relative
-```
-
-**Typical use cases for `remote`:**
-- Centralized plugin service inside your organization (e.g. EasyP API Service).
-- Running heavy plugins on a dedicated server instead of CI agents.
-- Sharing the same plugin implementation across multiple teams.
-
-#### Executing Plugin via Command (`command`)
-
-You can specify a plugin as an array of commands to execute. This is useful for running plugins via `go run` or any other tool without prior installation of the plugin binary:
-
-```yaml
-plugins:
-  - command: ["go", "run", "github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.25.1"]
-    out: ./gen/go
-    opts:
-      paths: source_relative
-```
-
-In this mode EasyP:
-- **builds and runs the command** you provide as a child process;
-- **writes `CodeGeneratorRequest` to stdin** of the process;
-- **reads `CodeGeneratorResponse` from stdout**, just like with regular protoc plugins.
-
-**Plugin Source Priority:**
-1. `command` — execute via specified command (highest priority)
-2. `remote` — remote plugin via URL
-3. `name` — local plugin from PATH or builtin plugin
-4. `path` — path to plugin executable file
-
-**Parameters (plugin sources and common options):**
-
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `name` | string | ❌ | - | Plugin name or identifier (e.g. `go`, `go-grpc`, `grpc-gateway`) |
-| `command` | []string | ❌ | - | Command to execute plugin (e.g., `["go", "run", "package"]`) |
-| `remote` | string | ❌ | - | Remote plugin URL |
-| `path` | string | ❌ | - | Path to plugin executable file |
-| `out` | string | ❌ | resolved generate root | Output directory for generated files |
-| `opts` | map[string](string \| number \| boolean \| array<string \| number \| boolean>) | ❌ | `{}` | Plugin-specific options; list values are emitted as repeated `key=value` params |
-| `with_imports` | bool | ❌ | `false` | Include proto files from dependencies |
-
-**Note:** Only one plugin source (`name`, `command`, `remote`, or `path`) must be specified for each plugin.
-If `opts.outputServices` is set to `["grpc-js", "generic-definitions"]`, EasyP sends `outputServices=grpc-js,outputServices=generic-definitions`.
-
-**Command source examples:**
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-
-  plugins:
-    # 1) gRPC-Gateway via go run (no pre-installed binary required)
-    - command: ["go", "run", "github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.25.1"]
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        generate_unbound_methods: true
-
-    # 2) protoc-gen-validate via go run
-    - command: ["go", "run", "github.com/bufbuild/protoc-gen-validate@v0.10.1"]
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        lang: go
-
-    # 3) Any custom wrapper script
-    - command: ["bash", "./scripts/custom-protoc-plugin.sh"]
-      out: ./gen/custom
-      opts:
-        foo: bar
-```
-
-#### Builtin Plugins
-
-EasyP includes builtin plugins for basic protobuf and gRPC languages. These plugins are embedded in the binary as WASM modules and do not require installation of external dependencies.
-
-**Benefits of builtin plugins:**
-- **Portability**: Single binary with all necessary plugins
-- **Convenience**: No need to install external dependencies
-- **Stability**: Plugin versions are fixed in the binary
-- **Isolation**: Independent of system plugin installations
-
-**Supported builtin plugins:**
-
-#### Protobuf Base Plugins
-
-The following plugins are builtin for generating base protobuf code:
-
-| Plugin Name | Description | Corresponding protoc Plugin |
-|-------------|-------------|----------------------------|
-| `cpp` | Generate C++ code from proto files | `protoc-gen-cpp` |
-| `csharp` | Generate C# code from proto files | `protoc-gen-csharp` |
-| `java` | Generate Java code from proto files | `protoc-gen-java` |
-| `kotlin` | Generate Kotlin code from proto files | `protoc-gen-kotlin` |
-| `objc` | Generate Objective-C code from proto files | `protoc-gen-objc` |
-| `php` | Generate PHP code from proto files | `protoc-gen-php` |
-| `python` | Generate Python code from proto files | `protoc-gen-python` |
-| `ruby` | Generate Ruby code from proto files | `protoc-gen-ruby` |
-
-#### gRPC Plugins
-
-The following plugins are builtin for generating gRPC code:
-
-| Plugin Name | Description | Corresponding protoc Plugin |
-|-------------|-------------|----------------------------|
-| `grpc_cpp` | Generate gRPC code for C++ | `grpc_cpp_plugin` |
-| `grpc_csharp` | Generate gRPC code for C# | `grpc_csharp_plugin` |
-| `grpc_java` | Generate gRPC code for Java | `grpc_java_plugin` |
-| `grpc_node` | Generate gRPC code for Node.js | `grpc_node_plugin` |
-| `grpc_objc` | Generate gRPC code for Objective-C | `grpc_objective_c_plugin` |
-| `grpc_php` | Generate gRPC code for PHP | `grpc_php_plugin` |
-| `grpc_python` | Generate gRPC code for Python | `grpc_python_plugin` |
-| `grpc_ruby` | Generate gRPC code for Ruby | `grpc_ruby_plugin` |
-
-**Plugin Selection Logic:**
-
-EasyP uses the following priority when selecting an executor for a plugin:
-
-1. **Remote plugin** (if `url` is specified) — always has the highest priority
-2. **Builtin plugin** (if plugin is builtin and not found in PATH) — used automatically
-3. **Local plugin** (from PATH) — used by default for backward compatibility
-
-**Usage Example:**
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    # Builtin Python plugin (automatically used if protoc-gen-python is not found in PATH)
-    - name: python
-      out: ./gen/python
-      opts:
-        pyi_out: ./gen/python
-    
-    # Builtin gRPC plugin for Python
-    - name: grpc_python
-      out: ./gen/python
-    
-    # Builtin C++ plugin (automatically used if protoc-gen-cpp is not found in PATH)
-    - name: cpp
-      out: ./gen/cpp
-      opts:
-        dllexport_decl: EXPORT
-    
-    # Builtin gRPC plugin for C++
-    - name: grpc_cpp
-      out: ./gen/cpp
-```
-
-**Requirements:**
-
-Builtin plugins are included in the EasyP binary:
-
-```bash
-# Build
-go build ./cmd/easyp
-
-# Install
-go install github.com/easyp-tech/easyp/cmd/easyp@latest
-```
-
-**Backward Compatibility:**
-
-Builtin plugins are fully compatible with existing configurations. If a plugin is found in PATH, it will be used instead of the builtin one. This ensures that:
-
-- Existing configurations continue to work without changes
-- You can override a builtin plugin by installing it in your system
-- Priority is given to local installations for flexibility
-
-### Plugin Options Reference
-
-This section covers the most commonly used plugins and their configuration options. Each plugin has specific parameters that control how code is generated, and understanding these options is crucial for getting the output you need.
-
-#### Go Plugins
-
-Go plugins are the most mature and widely used protoc plugins. The `paths` option controls how import paths are resolved, while other options provide fine-grained control over the generated code:
-
-```yaml
-plugins:
-  # protoc-gen-go - Generates Go structs and basic protobuf functionality
-  - name: go
-    out: ./gen/go
-    opts:
-      paths: source_relative              # source_relative | import
-      module: github.com/company/project  # Go module path for import generation
-      
-  # protoc-gen-go-grpc - Generates gRPC service stubs and clients
-  - name: go-grpc
-    out: ./gen/go
-    opts:
-      paths: source_relative
-      require_unimplemented_servers: false  # Generate UnimplementedServer embedding
-```
-
-#### gRPC-Gateway Plugins
-
-gRPC-Gateway plugins enable you to serve gRPC services as REST APIs and generate OpenAPI documentation. These are essential for building HTTP/JSON APIs from gRPC services:
-
-```yaml
-plugins:
-  # protoc-gen-grpc-gateway - Generates REST-to-gRPC reverse proxy
-  - name: grpc-gateway
-    out: ./gen/go
-    opts:
-      paths: source_relative
-      generate_unbound_methods: true      # Include methods without HTTP bindings
-      
-  # protoc-gen-openapiv2 - Generates OpenAPI/Swagger documentation
-  - name: openapiv2  
-    out: ./gen/openapi
-    opts:
-      simple_operation_ids: true          # Use simple names for operation IDs
-      generate_unbound_methods: false     # Exclude methods without HTTP bindings
-      json_names_for_fields: true         # Use JSON names instead of proto names
-```
-
-#### Validation Plugins
-
-Validation plugins generate code that automatically validates proto message fields based on constraints defined in your proto files. This eliminates the need for manual validation code:
-
-```yaml
-plugins:
-  # protoc-gen-validate - Generates field validation code
-  - name: validate-go
-    out: ./gen/go
-    opts:
-      paths: source_relative
-      lang: go                           # Target language for validation code
-```
-
-#### TypeScript/JavaScript Plugins
-
-TypeScript plugins are essential for frontend development, providing type-safe interfaces for your proto definitions and gRPC services in web applications:
-
-```yaml
-plugins:
-  # protoc-gen-ts - Generates TypeScript definitions and serialization
-  - name: ts
-    out: ./gen/typescript  
-    opts:
-      declaration: true                   # Generate .d.ts type definition files
-      target: es2017                     # ECMAScript target for compatibility
-      
-  # protoc-gen-grpc-web - Generates gRPC-Web clients for browsers
-  - name: grpc-web
-    out: ./gen/web
-    opts:
-      import_style: typescript           # Module system for generated code
-      mode: grpcweb                      # Transport mode for gRPC-Web
-```
-
-## Managed Mode
-
-Managed mode automatically sets file and field options in your protobuf descriptors during code generation without modifying the original `.proto` files. This feature is compatible with `buf`'s managed mode and provides a consistent way to manage language-specific options across your codebase.
-
-**Key benefits:**
-- **No proto file modifications**: Options are applied at generation time, keeping your proto files clean
-- **Consistent defaults**: Automatic application of language-specific naming conventions
-- **Centralized configuration**: Manage all options in one place (`easyp.yaml`)
-- **Module-specific rules**: Apply different options to different modules or paths
-- **buf compatibility**: Works the same way as `buf` managed mode
-
-### How It Works
-
-When managed mode is enabled, EasyP automatically applies file and field options to your protobuf descriptors before code generation. This happens in memory, so your original `.proto` files remain unchanged.
-
-**Default values** are applied for certain options based on language conventions:
-- Java: `java_package_prefix` defaults to `"com"`, `java_multiple_files` defaults to `true`
-- C#: `csharp_namespace` defaults to PascalCase of package name
-- Ruby: `ruby_package` defaults to PascalCase with `::` separator
-- PHP: `php_namespace` defaults to PascalCase with `\` separator
-- Objective-C: `objc_class_prefix` defaults to first letters of package parts
-- C++: `cc_enable_arenas` defaults to `true`
-
-**Overrides** allow you to set specific values for options, with support for filtering by module, protobuf package, path, or field. Without `module`, `package`, or `path`, an override applies to all files in the generation request, including dependencies and `git_repo` inputs.
-
-**Disables** allow you to prevent managed mode from modifying specific options or files. This is the recommended way to exclude external dependencies that already define their own options.
-
-### Configuration
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    disable:
-      # Disable managed mode for specific module
-      - module: github.com/googleapis/googleapis
-      
-      # Disable specific option globally
-      - file_option: java_package_prefix
-
-      # Disable for specific protobuf package
-      - package: acme.weather.v1
-        file_option: java_package
-      
-      # Disable for specific path
-      - path: legacy/
-        file_option: go_package
-      
-      # Disable field option for specific field
-      - field_option: jstype
-        field: com.example.User.id
-    
-    override:
-      # Override go_package_prefix for all files
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-      
-      # Override for specific module
-      - file_option: java_package_prefix
-        value: com.mycompany
-        module: github.com/mycompany/internal-protos
-
-      # Override for specific protobuf package
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-        package: acme.weather.v1
-      
-      # Override for specific path
-      - file_option: csharp_namespace_prefix
-        value: MyCompany
-        path: api/v1/
-      
-      # Override for multiple files with same value using prefix path
-      # This matches both internal/cms/bmi.proto and internal/cms/bmi_service.proto
-      - file_option: go_package
-        value: spec/cms/bmi
-        path: "internal/cms/bmi"
-      
-      # Override field option for specific path
-      - field_option: jstype
-        value: JS_STRING
-        path: api/v1/
-      
-      # Override for specific field
-      - field_option: jstype
-        value: JS_NUMBER
-        field: com.example.User.big_id
-```
-
-### Supported File Options
-
-| Option | Description | Has Default? |
-|--------|-------------|--------------|
-| `go_package` | Go import path | ❌ |
-| `go_package_prefix` | Prefix for Go import paths | ❌ |
-| `java_package` | Java package name | ❌ |
-| `java_package_prefix` | Prefix for Java packages | ✅ (`"com"`) |
-| `java_package_suffix` | Suffix for Java packages | ❌ |
-| `java_multiple_files` | Generate multiple Java files | ✅ (`true`) |
-| `java_outer_classname` | Outer class name | ✅ (PascalCase + "Proto") |
-| `java_string_check_utf8` | UTF-8 validation | ❌ |
-| `csharp_namespace` | C# namespace | ✅ (PascalCase) |
-| `csharp_namespace_prefix` | Prefix for C# namespaces | ❌ |
-| `ruby_package` | Ruby module name | ✅ (PascalCase with `::`) |
-| `ruby_package_suffix` | Suffix for Ruby packages | ❌ |
-| `php_namespace` | PHP namespace | ✅ (PascalCase with `\`) |
-| `php_metadata_namespace` | PHP metadata namespace | ❌ |
-| `php_metadata_namespace_suffix` | Suffix for PHP metadata | ❌ |
-| `objc_class_prefix` | Objective-C class prefix | ✅ (First letters) |
-| `swift_prefix` | Swift prefix | ❌ |
-| `optimize_for` | Code generation optimization | ❌ |
-| `cc_enable_arenas` | C++ arena allocation | ✅ (`true`) |
-
-### Supported Field Options
-
-| Option | Description | Applies To |
-|--------|-------------|------------|
-| `jstype` | JavaScript type for 64-bit integers | `int64`, `uint64`, `sint64`, `fixed64`, `sfixed64` |
-
-### Examples
-
-#### Basic Setup with Defaults
-
-Enable managed mode to get automatic defaults for all supported languages:
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-    - name: java
-      out: ./gen/java
-    - name: csharp
-      out: ./gen/csharp
-  managed:
-    enabled: true
-```
-
-This will automatically:
-- Set `java_package` to `com.<package>` for all files
-- Set `java_multiple_files` to `true`
-- Set `csharp_namespace` to PascalCase of package name
-- Set `ruby_package` to PascalCase with `::` separator
-- And more...
-
-#### Custom Go Package Prefix
-
-Override the Go package prefix for your project:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-```
-
-This will set `go_package` to `github.com/mycompany/myproject/gen/go/<package>` for all files.
-
-#### Dynamic Go Package Paths with Markers
-
-For more complex path generation, you can use markers in `go_package_prefix` or `go_package` values:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      # Use file path directly (without .proto extension)
-      - file_option: go_package_prefix
-        value: github.com/mycompany/{{file_path}}
-      
-      # Use only directory path
-      - file_option: go_package_prefix
-        value: github.com/mycompany/{{file_dir}}
-      
-      # Remove prefix from directory path
-      - file_option: go_package_prefix
-        value: github.com/mycompany/{{file_dir_without:internal/}}
-      
-      # Remove prefix from full file path
-      - file_option: go_package_prefix
-        value: github.com/mycompany/{{file_path_without:internal/}}
-```
-
-**Available markers:**
-- `{{file_path}}` - Full file path without `.proto` extension
-  - Example: `internal/cms/as.proto` → `internal/cms/as`
-- `{{file_dir}}` - Directory path only, without filename
-  - Example: `internal/cms/as.proto` → `internal/cms`
-- `{{file_dir_without:prefix/}}` - Directory path with prefix removed, and base filename without `_service`/`_grpc` suffixes
-  - Example: `{{file_dir_without:internal/}}` for `internal/cms/as_service.proto` → `cms/as`
-- `{{file_path_without:prefix/}}` - Full file path with prefix removed
-  - Example: `{{file_path_without:internal/}}` for `internal/cms/as.proto` → `cms/as`
-
-#### Module-Specific Overrides
-
-Apply different options to different modules:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      # Default for all files
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-      
-      # Specific override for internal module
-      - file_option: go_package_prefix
-        value: github.com/mycompany/internal/gen/go
-        module: github.com/mycompany/internal-protos
-```
-
-`module` matches the EasyP module source exactly: the dependency or `git_repo.url` value before `@version` (for example `github.com/mycompany/internal-protos` or `https://github.com/mycompany/internal-protos`). It is not the Go module path from `go.mod`.
-
-`package` matches the protobuf `package` declaration exactly, for example `acme.weather.v1`.
-
-#### Package-Specific Overrides
-
-Apply different options to files from a specific protobuf package:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-      - file_option: go_package
-        package: acme.weather.v1
-        value: github.com/mycompany/myproject/gen/go/acme/weather/v1
-```
-
-#### Disabling for External Dependencies
-
-Disable managed mode for external dependencies that already have their options set:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    disable:
-      - module: github.com/googleapis/googleapis
-      - module: github.com/grpc-ecosystem/grpc-gateway
-```
-
-#### JavaScript Type Safety
-
-Set `jstype` to `JS_STRING` for all 64-bit integer fields to prevent precision loss in JavaScript:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      - field_option: jstype
-        value: JS_STRING
-        path: api/v1/  # Apply to specific path
-```
-
-### Path Matching
-
-Path matching in managed mode uses prefix-based matching (same as `buf`):
-
-- **Directory path** (ending with `/`): Matches all files in that directory and subdirectories
-  - Example: `path: "internal/cms/"` matches `internal/cms/as.proto`, `internal/cms/node.proto`, `internal/cms/v1/service.proto`
-- **Exact file path** (ending with `.proto`): Matches only that specific file
-  - Example: `path: "internal/cms/as.proto"` matches only `internal/cms/as.proto`
-- **Prefix path** (no trailing `/` or `.proto`): Uses prefix matching (not directory-aware)
-  - Example: `path: "internal/cms"` matches `internal/cms/as.proto` but also `internal/cmsv2/file.proto`
-
-### Rule Precedence
-
-When multiple rules match the same file or field, the following precedence applies:
-
-1. **Disable rules** take precedence - if an option is disabled, it won't be applied
-2. **Override rules** are applied in order - the last matching rule wins
-3. **Default values** are applied only if no override matches and the option isn't disabled
-
-### Compatibility with buf
-
-EasyP's managed mode is compatible with `buf`'s managed mode. The same configuration format and behavior apply, making it easy to migrate between tools or use both in the same workflow.
-
-## Descriptor Set Generation
-
-**https://protobuf.dev/programming-guides/techniques/#self-description**
-
-EasyP supports generating binary FileDescriptorSet files using the `--descriptor_set_out` flag. This allows you to create self-describing protobuf messages that include schema information alongside the data.
-
-**CLI flags:**
-
-- `--descriptor_set_out <path>` - Output path for the binary FileDescriptorSet
-- `--include_imports` - Include all transitive dependencies in the FileDescriptorSet
-
-**Example:**
-
-```bash
-# Generate descriptor set with only target files
-easyp generate --descriptor_set_out=./schema.pb
-
-# Generate descriptor set with all dependencies
-easyp generate --descriptor_set_out=./schema.pb --include_imports
-```
-
-Self-describing messages are useful for dynamic message parsing, runtime schema validation, schema registries, and building generic gRPC clients. For more information, see the [Protocol Buffers documentation on self-description](https://protobuf.dev/programming-guides/techniques/#self-description).
-
-## Package Manager Integration
-
-One of EasyP's most powerful features is the seamless integration between the package manager and code generator. This integration eliminates the common problem of managing proto dependencies manually and ensures that your generated code always has access to the correct versions of imported proto files.
-
-**Key benefits:**
-- **Automatic dependency resolution**: No need to manually manage proto import paths
-- **Version consistency**: Dependencies are locked to specific versions via `easyp.lock`
-- **Transitive dependencies**: EasyP handles dependencies of dependencies automatically
-- **Performance**: Local caching means dependencies are downloaded once and reused
-
-### Automatic Dependency Resolution
-
-When you define dependencies in the `deps` section, the generator automatically includes them in the proto path. This means your proto files can import from these dependencies without any additional configuration.
-
-**How it works:**
-1. EasyP downloads and caches dependencies based on your `deps` configuration
-2. During generation, these cached proto files are automatically added to the protoc import path
-3. Your proto files can import from dependencies using standard import statements
-4. Generated code includes both your local protos and dependency protos when `with_imports: true`
-
-Here's a simple example showing how dependency resolution works automatically. Notice that you only need to specify the dependencies once in the `deps` section:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-      with_imports: true    # This automatically includes googleapis and grpc-gateway protos
-```
-
-### Dependency Usage Examples
-
-The following examples demonstrate common patterns for integrating external proto dependencies into your code generation workflow.
-
-#### Using Google APIs
-
-Google APIs are among the most commonly used proto dependencies, providing standard types and annotations for REST APIs, field validation, and common data structures.
-
-**When to use Google APIs:**
-- Building REST APIs with gRPC-Gateway
-- Need standard types like `Timestamp`, `Duration`, `Any`
-- Want to use Google's field behavior annotations
-- Building services that integrate with Google Cloud
-
-This configuration shows the minimal setup needed to use Google APIs in your proto files:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-
-generate:
-  inputs:
-    - directory: "api/proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-      with_imports: true
-```
-
-**Important:** Always use a pinned version (like `common-protos-1_3_1`) rather than latest to ensure build reproducibility.
-
-Once configured, your proto files can import and use Google API definitions. Here's an example of a service using HTTP annotations:
-
-```proto
-// api/proto/service.proto
-syntax = "proto3";
-
-import "google/api/annotations.proto";
-import "google/protobuf/timestamp.proto";
-
-service MyService {
-  rpc GetData(GetDataRequest) returns (GetDataResponse) {
-    option (google.api.http) = {
-      get: "/v1/data"
-    };
-  }
-}
-```
-
-#### Using Validation Rules
-
-Protoc-gen-validate provides powerful field validation capabilities that can be embedded directly in your proto definitions, eliminating the need for separate validation logic in your application code.
-
-**When to use validation:**
-- Input validation for API endpoints
-- Database model constraints
-- Configuration file validation
-- Any scenario where data integrity is critical
-
-**Benefits:**
-- Validation rules are part of the proto definition (single source of truth)
-- Code generation creates validation functions automatically
-- Consistent validation across different languages
-- Better performance than runtime reflection-based validation
-
-```yaml
-deps:
-  - github.com/bufbuild/protoc-gen-validate@v0.10.1
-
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-      with_imports: true
-    - name: validate-go
-      out: ./gen/go  
-      opts:
-        paths: source_relative
-```
-
-**Note:** You need both the dependency (for proto imports) and the plugin (for code generation) to get full validation support.
-
-Here's how validation rules look in your proto files. The generated code will automatically validate these constraints:
-
-```proto
-// proto/user.proto
-syntax = "proto3";
-
-import "validate/validate.proto";
-
-message User {
-  string email = 1 [(validate.rules).string.email = true];
-  int32 age = 2 [(validate.rules).int32.gte = 0];
-}
-```
-
-#### Complex Multi-Dependency Setup
-
-This example demonstrates a production-ready configuration that combines multiple dependencies and plugins for a complete API development workflow:
-
-```yaml
-deps:
-  # Core Google APIs - Standard types and HTTP annotations
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  
-  # gRPC Gateway for REST APIs - Enables HTTP/JSON interfaces
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-  
-  # Validation rules - Field-level validation constraints
-  - github.com/bufbuild/protoc-gen-validate@v0.10.1
-  
-  # Company internal shared types - Common business objects
-  - github.com/mycompany/shared-protos@v1.5.0
-
-generate:
-  inputs:
-    - directory: "api/proto"
-  plugins:
-    # Go code generation - Core protobuf structures
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        module: github.com/mycompany/myservice
-      with_imports: true
-      
-    # gRPC service stubs - Server and client interfaces
-    - name: go-grpc
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-        
-    # REST Gateway - HTTP-to-gRPC proxy code
-    - name: grpc-gateway
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        
-    # OpenAPI documentation - API specification
-    - name: openapiv2
-      out: ./gen/openapi
-      opts:
-        simple_operation_ids: true
-        
-    # Validation code - Input validation functions
-    - name: validate-go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-```
-
-### Dependency Cache Integration
-
-The generator leverages EasyP's module cache for fast builds:
-
-```bash
-# Download dependencies once
-easyp mod download
-
-# Generate code (uses cached dependencies)
-easyp generate
-
-# Dependencies are cached in ~/.easyp/mod/
-ls ~/.easyp/mod/github.com/googleapis/googleapis/
-```
-
-## Remote Generation
-
-Remote generation is a powerful feature that allows you to generate code from proto files hosted in remote Git repositories without requiring a local checkout. This enables true microservices architecture where teams can consume each other's APIs without tight coupling.
-
-**Key advantages:**
-- **Decoupled development**: Teams can work independently while consuming each other's APIs
-- **Version control**: Pin to specific versions of external APIs for stability
-- **Reduced repository size**: No need to vendor or submodule external proto files
-- **Automatic updates**: Easy to update to newer versions when ready
-
-**Best practices:**
-- Always use tagged versions in production environments
-- Test with latest versions in development, but pin in production
-- Use semantic versioning when available for easier dependency management
-- Consider the network implications for CI/CD systems
-
-### Remote Proto Sources
-
-Generate from remote repositories directly. This is particularly useful in microservices architectures where different teams own different proto definitions.
-
-**Typical workflow:**
-1. Team A publishes proto definitions in a Git repository with proper versioning
-2. Team B references these protos in their `easyp.yaml` configuration
-3. During generation, EasyP automatically fetches and uses the remote protos
-4. Generated code includes client libraries for Team A's services
-
-Here's a practical example showing how to combine local and remote proto sources in a single generation configuration:
-
-```yaml
-generate:
-  inputs:
-    # Local protos - Your service's own API definitions
-    - directory: "proto"
-    
-    # Remote public repository - External vendor API
-    - git_repo:
-        url: "github.com/acme/weather-api@v2.1.0"
-        sub_directory: "proto/weather/v1"
-    # Remote private repository - Internal company API
-    - git_repo:
-        url: "github.com/mycompany/internal-apis@main"
-        sub_directory: "user-service/proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-      with_imports: true
-```
-
-
-
-### Remote Generation Use Cases
-
-These examples demonstrate real-world scenarios where remote generation provides significant value in distributed development environments.
-
-#### Multi-Team Development
-
-Multi-team development is where remote generation truly shines. Instead of coordinating shared repositories or complex dependency management, teams can independently evolve their APIs while consumers automatically get updates through versioned dependencies.
-
-This pattern is especially valuable in large organizations where:
-- Teams have different release cycles and development velocities
-- API ownership is clearly defined but consumption is widespread  
-- You want to avoid the overhead of coordinating shared proto repositories
-- Different teams use different technology stacks but need to communicate
-
-```yaml
-# Team A (Order Service) generates from Team B's proto definitions
-generate:
-  inputs:
-    # Local service definitions - APIs owned by this team
-    - directory: "proto/orders"
-    
-    # User service protos from another team - Stable, versioned API
-    - git_repo:
-        url: "github.com/company/user-service@v1.8.0"  
-        sub_directory: "api/proto"
-    # Payment service protos - Different team, different version
-    - git_repo:
-        url: "github.com/company/payment-service@v2.3.1"
-        sub_directory: "proto/payment/v2"  
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        module: github.com/company/order-service
-      with_imports: true
-```
-
-#### Vendor API Integration
-
-Many vendors now provide proto definitions for their APIs, enabling strongly-typed client generation instead of relying on hand-written HTTP clients. This approach provides better type safety, automatic serialization, and often better performance.
-
-Benefits of using vendor proto definitions:
-- **Type safety**: Compile-time checking of API calls and data structures
-- **Automatic updates**: New API features become available through version updates
-- **Consistency**: Same interface patterns across different vendor integrations
-- **Performance**: Binary serialization is often faster than JSON
-- **Documentation**: Proto files serve as authoritative API documentation
-
-```yaml
-# Generate clients for external vendor APIs
-generate:
-  inputs:
-    # Vendor's public proto definitions - Financial services
-    - git_repo:
-        url: "github.com/stripe/stripe-proto@v1.0.0"
-        sub_directory: "proto"
-    # Communication service APIs - SMS/Voice integration
-    - git_repo:  
-        url: "github.com/twilio/twilio-protos@v2.1.0"
-        sub_directory: "definitions"
-  plugins:
-    - name: go
-      out: ./clients/go
-      opts:
-        paths: source_relative
-        module: github.com/mycompany/integrations
-```
-
-
-
-## Commands
-
-The EasyP command-line interface provides flexible options for running code generation with different configurations and environments.
-
-### Basic Generation
-
-These are the most commonly used command patterns for everyday development and production use:
-
-```bash
-# Use default easyp.yaml configuration - Most common for development
-easyp generate
-
-# Use custom configuration file - Essential for multi-environment setups  
-easyp --cfg production.easyp.yaml generate
-
-# Generate with debug logs - Helpful for debugging and CI/CD
-easyp --debug generate
-
-# Generate with custom cache location - Useful for CI systems or shared environments
-EASYPPATH=/tmp/easyp-cache easyp generate
-```
-
-### Integration with Package Manager
-
-EasyP's package manager integration means you can either explicitly manage dependencies or let the generator handle them automatically. The explicit approach gives you more control, while the automatic approach is more convenient:
-
-```bash
-# Explicit workflow - Better for CI/CD and when you want to cache dependencies
-easyp mod download    # Download and cache dependencies first
-easyp generate        # Generate code using cached dependencies
-
-# Automatic workflow - Convenient for development (generate downloads dependencies automatically)
-easyp generate
-```
-
-### Advanced Usage
-
-These advanced usage patterns are useful for specific deployment scenarios, debugging, or when you need fine-grained control over the generation process:
-
-```bash
-# Generate from specific input directory - Override config file settings
-easyp generate --path=./api/proto
-
-# Generate using vendored dependencies - For offline builds or Docker containers
-easyp mod vendor
-easyp generate
-
-# Generate from a custom project root - Useful in monorepos or nested workdirs
-easyp generate --root=/usr/local/src/my-project --path=./api/proto
-```
-
-## Common Patterns
-
-These patterns represent real-world scenarios and best practices for organizing code generation in different project structures.
-
-
-
-### Multi-Language Generation
-
-Multi-language generation is essential for organizations using different technologies across their stack. EasyP makes it easy to generate consistent client libraries and types for multiple programming languages from the same proto definitions.
-
-**Common scenarios:**
-- **Full-stack applications**: Go/Java backend with TypeScript frontend for web apps
-- **Data platforms**: Go services with Python data science tools and analysis scripts  
-- **Microservices**: Different services implemented in optimal languages for their domain
-- **Client libraries**: Providing SDKs in multiple languages for external developers
-- **Legacy integration**: Modern gRPC services with legacy systems using different languages
-
-**Performance considerations:**
-- Each plugin runs independently, so generation time scales linearly with plugin count
-- Consider using parallel execution (`make -j4`) for large numbers of plugins
-- Output directories should be organized hierarchically to avoid file conflicts
-- Some plugins are faster than others - profile your build to identify bottlenecks
-
-**Maintenance benefits:**
-- Single source of truth for API definitions prevents schema drift
-- Consistent types across all languages reduce integration bugs
-- Automatic synchronization when proto definitions change eliminates manual updates
-- Reduced chance of API drift between different language implementations
-- Easier refactoring since changes propagate to all generated code
-
-This example shows a typical multi-language setup for a full-stack application with backend services, web frontend, data analysis, and documentation:
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-    
-  plugins:
-    # Go backend services - Primary implementation language
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        module: github.com/company/backend
-      with_imports: true
-      
-    - name: go-grpc  # gRPC server and client stubs
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        
-    # TypeScript frontend - Web application client code
-    - name: ts  
-      out: ./gen/typescript
-      opts:
-        declaration: true       # Generate type definitions
-        target: es2020         # Modern JavaScript for browsers
-        
-    # Python data science - Analytics and ML workflows
-    - name: python
-      out: ./gen/python
-      opts:
-        mypy_out: ./gen/python-stubs  # Type checking support
-        
-    # Documentation - API reference for developers
-    - name: doc
-      out: ./docs/api
-      opts:
-        markdown: true         # Generate markdown documentation
-```
-
-**Organization tip:** Use separate output directories for each language to avoid file conflicts and make it easier to integrate with language-specific build systems.
-
-
-
-
-
-The EasyP generator provides a comprehensive solution for protocol buffer code generation, supporting everything from simple local development to complex enterprise multi-language workflows with remote dependencies.
diff --git a/docs/public/docs/guide/cli/linter/linter.md b/docs/public/docs/guide/cli/linter/linter.md
deleted file mode 100644
index 40c5db58..00000000
--- a/docs/public/docs/guide/cli/linter/linter.md
+++ /dev/null
@@ -1,418 +0,0 @@
-# Linter
-
-[[toc]]
-
-## Why Use a Linter for Proto Files?
-
-Linters play a crucial role in modern software development, particularly for proto files. By enforcing style and formatting rules, linters help maintain code quality, reduce potential bugs, and ensure that the codebase is clean and readable. This leads to several benefits:
-
-- **Reduced Development Costs:** Linters catch errors early in the development cycle, saving time and resources that would be spent on debugging and fixing issues later.
-- **Improved Team Collaboration:** A standardized codebase makes it easier for team members to understand and work with each other's code, facilitating a smoother collaborative environment.
-- **Business Efficiency:** Teams using linters often produce higher quality code, which translates to fewer production issues and maintenance costs. This makes businesses that adopt linting practices more competitive and cost-effective.
-
-## Configuration Reference
-
-EasyP linter provides flexible configuration options to adapt to different project requirements. All configuration is done through the `lint` section in your `easyp.yaml` file.
-
-### Complete Configuration Example
-
-```yaml
-lint:
-  # Rules and categories to use
-  use:
-    - MINIMAL
-    - BASIC
-    - COMMENT_SERVICE
-    - COMMENT_RPC
-  
-  # Custom suffixes for naming conventions
-  enum_zero_value_suffix: "UNSPECIFIED"
-  service_suffix: "Service"
-  
-  # Directory and rule exclusions
-  ignore:
-    - "vendor/"
-    - "third_party/"
-    - "legacy/old_protos/"
-  
-  except:
-    - COMMENT_FIELD
-    - COMMENT_MESSAGE
-  
-  # Comment-based rule ignoring
-  allow_comment_ignores: true
-  
-  # File-specific rule ignoring
-  ignore_only:
-    COMMENT_SERVICE: ["legacy/", "vendor/"]
-    SERVICE_SUFFIX: ["proto/external/"]
-```
-
-### Configuration Parameters
-
-#### `use` ([]string)
-Specifies which linter rules or rule categories to apply. You can mix individual rules with predefined categories.
-
-**Available categories:**
-- **MINIMAL**: Basic package consistency checks
-- **BASIC**: Naming conventions and usage patterns  
-- **DEFAULT**: Recommended rules for most projects
-- **COMMENTS**: Comment presence and formatting
-- **UNARY_RPC**: Restrictions on streaming RPCs
-
-**Individual rules**: Any specific rule name (e.g., `ENUM_PASCAL_CASE`, `FIELD_LOWER_SNAKE_CASE`)
-
-**Examples:**
-```yaml
-# Use predefined categories
-use: [MINIMAL, BASIC, DEFAULT]
-
-# Mix categories with individual rules
-use:
-  - MINIMAL
-  - COMMENT_SERVICE
-  - COMMENT_RPC
-  - ENUM_PASCAL_CASE
-
-# Use only specific rules
-use:
-  - PACKAGE_DEFINED
-  - SERVICE_PASCAL_CASE
-  - FIELD_LOWER_SNAKE_CASE
-```
-
-#### `enum_zero_value_suffix` (string)
-Defines the required suffix for zero-value enum entries. This enforces a consistent naming pattern for the default enum value.
-
-**Default**: Empty (no suffix required)
-**Common values**: `"UNSPECIFIED"`, `"UNKNOWN"`, `"DEFAULT"`
-
-**Example:**
-```yaml
-enum_zero_value_suffix: "UNSPECIFIED"
-```
-
-With this setting, enum definitions must follow this pattern:
-```proto
-enum Status {
-  STATUS_UNSPECIFIED = 0;  // Required suffix
-  STATUS_ACTIVE = 1;
-  STATUS_INACTIVE = 2;
-}
-```
-
-#### `service_suffix` (string)
-Specifies the required suffix for service names. This ensures consistent service naming across your project.
-
-**Default**: Empty (no suffix required)
-**Common values**: `"Service"`, `"API"`, `"Svc"`
-
-**Example:**
-```yaml
-service_suffix: "Service"
-```
-
-With this setting, service definitions must follow this pattern:
-```proto
-service UserService {     // Required "Service" suffix
-  rpc GetUser(...) returns (...);
-}
-```
-
-#### `ignore` ([]string)
-Lists directories or file paths to completely exclude from linting. Supports glob patterns and relative paths from the project root.
-
-**Use cases:**
-- Third-party or vendor proto files
-- Generated proto files
-- Legacy code being phased out
-- Test fixtures that intentionally violate rules
-
-**Examples:**
-```yaml
-ignore:
-  - "vendor/"                    # Exclude vendor directory
-  - "third_party/"              # Exclude third-party protos
-  - "testdata/"                 # Exclude test fixtures
-  - "proto/legacy/"             # Exclude legacy protos
-  - "**/*_test.proto"           # Exclude test proto files
-```
-
-#### `except` ([]string)
-Disables specific rules globally across the entire project. Use this when certain rules don't fit your project's conventions.
-
-**When to use:**
-- Legacy projects with established naming conventions
-- Projects with specific style requirements
-- Gradual adoption of linting rules
-
-**Examples:**
-```yaml
-except:
-  - COMMENT_FIELD              # Don't require field comments
-  - COMMENT_MESSAGE            # Don't require message comments
-  - SERVICE_SUFFIX             # Don't enforce service suffix
-  - ENUM_ZERO_VALUE_SUFFIX     # Don't enforce enum zero suffix
-```
-
-#### `allow_comment_ignores` (bool)
-Enables or disables the ability to ignore specific rules using inline comments in proto files.
-
-**Default**: `false`
-**Recommended**: `true` for flexibility during development
-
-**Example:**
-```yaml
-allow_comment_ignores: true
-```
-
-When enabled, you can use comments to ignore rules on specific elements:
-```proto
-// buf:lint:ignore COMMENT_SERVICE
-service LegacyUserAPI {
-  // nolint:COMMENT_RPC
-  rpc GetUser(...) returns (...);
-}
-```
-
-#### `ignore_only` (map[string][]string)
-Allows you to disable specific rules only for certain files or directories, while keeping them active elsewhere.
-
-**Use cases:**
-- Legacy code that can't be easily updated
-- Third-party protos with different conventions
-- Generated code that doesn't follow your style
-- Gradual migration strategies
-
-**Format**: `rule_name: [list_of_paths]`
-
-**Examples:**
-```yaml
-ignore_only:
-  # Don't require service comments in legacy directory
-  COMMENT_SERVICE: 
-    - "proto/legacy/"
-    - "vendor/"
-  
-  # Don't enforce service suffix for external APIs
-  SERVICE_SUFFIX:
-    - "proto/external/"
-    - "third_party/"
-  
-  # Allow old naming in specific files
-  FIELD_LOWER_SNAKE_CASE:
-    - "proto/legacy/old_messages.proto"
-    - "vendor/external_api.proto"
-```
-
-## Comment-Based Rule Ignoring
-
-When `allow_comment_ignores` is enabled, you can use inline comments to ignore specific linter rules for individual proto elements. This provides fine-grained control over rule enforcement.
-
-### Supported Comment Formats
-
-EasyP supports two comment formats for maximum compatibility:
-
-#### Buf-compatible format
-```proto
-// buf:lint:ignore RULE_NAME
-```
-
-#### EasyP native format  
-```proto
-// nolint:RULE_NAME
-```
-
-### Usage Examples
-
-#### Ignoring Service Rules
-```proto
-// buf:lint:ignore COMMENT_SERVICE
-// buf:lint:ignore SERVICE_SUFFIX  
-service UserAPI {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-}
-```
-
-#### Ignoring RPC Rules
-```proto
-service UserService {
-  // nolint:COMMENT_RPC
-  // nolint:RPC_REQUEST_STANDARD_NAME
-  rpc GetUserInfo(UserInfoReq) returns (UserInfoResp);
-}
-```
-
-#### Ignoring Message and Field Rules
-```proto
-// buf:lint:ignore COMMENT_MESSAGE
-message UserData {
-  // nolint:COMMENT_FIELD
-  // nolint:FIELD_LOWER_SNAKE_CASE
-  string userName = 1;
-}
-```
-
-#### Ignoring Enum Rules
-```proto
-// nolint:COMMENT_ENUM
-// nolint:ENUM_ZERO_VALUE_SUFFIX
-enum UserType {
-  UNKNOWN = 0;  // Would normally require suffix
-  ADMIN = 1;
-  USER = 2;
-}
-```
-
-#### Multiple Rules on One Line
-```proto
-// buf:lint:ignore COMMENT_SERVICE,SERVICE_SUFFIX
-service LegacyAPI {
-  // nolint:COMMENT_RPC,RPC_REQUEST_STANDARD_NAME
-  rpc getData(DataReq) returns (DataResp);
-}
-```
-
-### Best Practices for Comment Ignores
-
-#### Use Sparingly
-Comment ignores should be the exception, not the rule. Overuse indicates that your linting configuration may need adjustment.
-
-**Good:**
-```proto
-// Legacy service - buf:lint:ignore SERVICE_SUFFIX
-service UserAPI {
-  rpc GetUser(...) returns (...);
-}
-```
-
-**Bad:**
-```proto
-// nolint:COMMENT_SERVICE,SERVICE_SUFFIX,COMMENT_RPC
-service UserAPI {
-  // nolint:COMMENT_RPC,RPC_REQUEST_STANDARD_NAME
-  rpc getUser(...) returns (...);
-  // nolint:COMMENT_RPC,RPC_RESPONSE_STANDARD_NAME  
-  rpc updateUser(...) returns (...);
-}
-```
-
-#### Add Explanatory Comments
-Always explain why you're ignoring a rule to help future maintainers understand the decision.
-
-```proto
-// Third-party API compatibility requires non-standard naming
-// buf:lint:ignore SERVICE_SUFFIX
-service ExternalUserAPI {
-  // Legacy method name for backwards compatibility
-  // nolint:RPC_REQUEST_STANDARD_NAME
-  rpc getUserData(UserReq) returns (UserResp);
-}
-```
-
-#### Prefer Configuration Over Comments
-When multiple files need the same rule ignored, use `ignore_only` configuration instead of individual comments.
-
-**Instead of:**
-```proto
-// In file1.proto
-// buf:lint:ignore COMMENT_SERVICE
-service API1 { ... }
-
-// In file2.proto  
-// buf:lint:ignore COMMENT_SERVICE
-service API2 { ... }
-```
-
-**Use:**
-```yaml
-# In easyp.yaml
-lint:
-  ignore_only:
-    COMMENT_SERVICE: ["legacy/"]
-```
-
-## Linter Categories
-
-To accommodate different project needs and preferences, EasyP linter provides predefined rule categories. These categories group together various rules, allowing teams to quickly select the level of strictness or areas they want to focus on during linting.
-
-**When to use each category:**
-
-- **MINIMAL:** Essential for any proto project - ensures basic consistency and prevents fundamental issues
-- **BASIC:** Recommended for most projects - enforces common naming conventions and best practices  
-- **DEFAULT:** Additional quality checks - useful for mature projects with established workflows
-- **COMMENTS:** Documentation requirements - important for public APIs and team collaboration
-- **UNARY_RPC:** Streaming restrictions - use when your architecture requires only unary RPCs
-
-The available categories are:
-- **MINIMAL:** Basic checks to ensure package consistency.
-- **BASIC:** Additional checks for naming conventions and usage patterns.
-- **DEFAULT:** A set of default rules that most projects should use.
-- **COMMENTS:** Ensures that comments are present and properly formatted.
-- **UNARY_RPC:** Specific rules for unary RPC services.
-
-### Rule Groupings
-
-Below are the rule groupings under each category:
-
-#### MINIMAL
-
-- `DIRECTORY_SAME_PACKAGE`
-- `PACKAGE_DEFINED`
-- `PACKAGE_DIRECTORY_MATCH`
-- `PACKAGE_SAME_DIRECTORY`
-
-#### BASIC
-
-- `ENUM_FIRST_VALUE_ZERO`
-- `ENUM_NO_ALLOW_ALIAS`
-- `ENUM_PASCAL_CASE`
-- `ENUM_VALUE_UPPER_SNAKE_CASE`
-- `FIELD_LOWER_SNAKE_CASE`
-- `IMPORT_NO_PUBLIC`
-- `IMPORT_NO_WEAK`
-- `IMPORT_USED`
-- `MESSAGE_PASCAL_CASE`
-- `ONEOF_LOWER_SNAKE_CASE`
-- `PACKAGE_LOWER_SNAKE_CASE`
-- `PACKAGE_SAME_CSHARP_NAMESPACE`
-- `PACKAGE_SAME_GO_PACKAGE`
-- `PACKAGE_SAME_JAVA_MULTIPLE_FILES`
-- `PACKAGE_SAME_JAVA_PACKAGE`
-- `PACKAGE_SAME_PHP_NAMESPACE`
-- `PACKAGE_SAME_RUBY_PACKAGE`
-- `PACKAGE_SAME_SWIFT_PREFIX`
-- `RPC_PASCAL_CASE`
-- `SERVICE_PASCAL_CASE`
-
-#### DEFAULT
-
-- `ENUM_VALUE_PREFIX`
-- `ENUM_ZERO_VALUE_SUFFIX`
-- `FILE_LOWER_SNAKE_CASE`
-- `RPC_REQUEST_RESPONSE_UNIQUE`
-- `RPC_REQUEST_STANDARD_NAME`
-- `RPC_RESPONSE_STANDARD_NAME`
-- `PACKAGE_VERSION_SUFFIX`
-- `SERVICE_SUFFIX`
-
-#### COMMENTS
-
-- `COMMENT_ENUM`
-- `COMMENT_ENUM_VALUE`
-- `COMMENT_FIELD`
-- `COMMENT_MESSAGE`
-- `COMMENT_ONEOF`
-- `COMMENT_RPC`
-- `COMMENT_SERVICE`
-
-#### UNARY_RPC
-
-- `RPC_NO_CLIENT_STREAMING`
-- `RPC_NO_SERVER_STREAMING`
-
-## Conclusion
-
-Adopting the EasyP linter for your proto files can significantly enhance your development workflow, code quality, 
-and overall project maintainability. With full compatibility with the Buf linter, teams can easily migrate and start benefiting
-from our tool's robust features and flexible configuration options.
\ No newline at end of file
diff --git a/docs/public/docs/guide/cli/linter/rules/comment-enum-value.md b/docs/public/docs/guide/cli/linter/rules/comment-enum-value.md
deleted file mode 100644
index c82b0f95..00000000
--- a/docs/public/docs/guide/cli/linter/rules/comment-enum-value.md
+++ /dev/null
@@ -1,34 +0,0 @@
-# COMMENT_ENUM_VALUE
-
-Categories:
-
-- **COMMENT**
-
-This rule checks that enum values have a comment.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    BAR = 0;
-    BAZ = 1;
-}
-```
-
-### Good
-
-```proto
-
-syntax = "proto3";
-
-enum Foo {
-    // BAR value for bar logic // [!code focus]
-    BAR = 0; 
-    // BAZ value for baz logic // [!code focus]
-    BAZ = 1; 
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/comment-enum.md b/docs/public/docs/guide/cli/linter/rules/comment-enum.md
deleted file mode 100644
index ec908792..00000000
--- a/docs/public/docs/guide/cli/linter/rules/comment-enum.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# COMMENT_ENUM
-
-Categories:
-
-- **COMMENT**
-
-This rule checks that enum has a comment.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    BAR = 0;
-    BAZ = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-// Foo enum for bar and baz logic // [!code focus]
-enum Foo {
-    BAR = 0; 
-    BAZ = 1; 
-}
-```
\ No newline at end of file
diff --git a/docs/public/docs/guide/cli/linter/rules/comment-field.md b/docs/public/docs/guide/cli/linter/rules/comment-field.md
deleted file mode 100644
index 6c0abbbb..00000000
--- a/docs/public/docs/guide/cli/linter/rules/comment-field.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# COMMENT_FIELD
-
-Categories:
-
-- **COMMENT**
-
-This rule checks that all message fields have a comment.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    string bar = 1;
-    string baz = 2;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    // bar field for bar logic // [!code focus]
-    string bar = 1; 
-    // baz field for baz logic // [!code focus]
-    string baz = 2; 
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/comment-message.md b/docs/public/docs/guide/cli/linter/rules/comment-message.md
deleted file mode 100644
index 10f2bdb6..00000000
--- a/docs/public/docs/guide/cli/linter/rules/comment-message.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# COMMENT_MESSAGE
-
-Categories:
-
-- **COMMENT**
-
-This rule checks that message has a comment.
-
-## Examples
-
-### Bad
-
-```proto
-
-syntax = "proto3";
-
-message Foo {
-    string bar = 1;
-    string baz = 2;
-}
-```
-
-### Good
-
-```proto
-
-syntax = "proto3";
-
-// Foo message for bar and baz logic // [!code focus]
-message Foo {
-    // bar field for bar logic 
-    string bar = 1; 
-    // baz field for baz logic
-    string baz = 2; 
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/comment-oneof.md b/docs/public/docs/guide/cli/linter/rules/comment-oneof.md
deleted file mode 100644
index 7e37fb86..00000000
--- a/docs/public/docs/guide/cli/linter/rules/comment-oneof.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# COMMENT_ONEOF
-
-Categories:
-
-- **COMMENT**
-
-This rule checks that oneof has a comment.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    oneof bar {
-        string baz = 1;
-        string qux = 2;
-    }
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    // bar oneof for baz and qux logic // [!code focus]
-    oneof bar {
-        string baz = 1; 
-        string qux = 2; 
-    }
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/comment-rpc.md b/docs/public/docs/guide/cli/linter/rules/comment-rpc.md
deleted file mode 100644
index 24a64bb2..00000000
--- a/docs/public/docs/guide/cli/linter/rules/comment-rpc.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# COMMENT_RPC
-
-Categories:
-
-- **COMMENT**
-
-This rule checks that rpc has a comment.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (BarResponse) {}
-    rpc Baz (BazRequest) returns (BazResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    // Bar rpc for bar logic // [!code focus]
-    rpc Bar (BarRequest) returns (BarResponse) {}
-    // Baz rpc for baz logic // [!code focus]
-    rpc Baz (BazRequest) returns (BazResponse) {}
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/comment-service.md b/docs/public/docs/guide/cli/linter/rules/comment-service.md
deleted file mode 100644
index 15beb817..00000000
--- a/docs/public/docs/guide/cli/linter/rules/comment-service.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# COMMENT_SERVICE
-
-Categories:
-
-- **COMMENT**
-
-This rule checks that service has a comment.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (BarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-// Foo service for bar logic // [!code focus]
-service Foo {
-    // Bar rpc for bar logic 
-    rpc Bar (BarRequest) returns (BarResponse) {}
-}
-```
-
-
diff --git a/docs/public/docs/guide/cli/linter/rules/directory-same-package.md b/docs/public/docs/guide/cli/linter/rules/directory-same-package.md
deleted file mode 100644
index 207f7b4f..00000000
--- a/docs/public/docs/guide/cli/linter/rules/directory-same-package.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# DIRECTORY_SAME_PACKAGE
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files in a given directory are in the same package.
-
-## Examples
-
-### Bad
-
-```proto
-// File: dir/foo.proto
-
-syntax = "proto3";
-   
-package foo;
-
-message Foo {
-    string bar = 1;
-}
-```
-
-### Good
-
-```proto
-// File: dir/foo/foo.proto // [!code focus]
-
-syntax = "proto3";
-
-package dir.foo; // [!code focus]
-
-message Foo {
-    string bar = 1;
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/enum-first-value-zero.md b/docs/public/docs/guide/cli/linter/rules/enum-first-value-zero.md
deleted file mode 100644
index fb1e90d3..00000000
--- a/docs/public/docs/guide/cli/linter/rules/enum-first-value-zero.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# ENUM_FIRST_VALUE_ZERO
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that the first value of an enum is zero.
-
-## Examples
-
-### Bad
-
-```proto
-
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    BAR = 1;
-    BAZ = 2;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    BAR = 0; // [!code focus]
-    BAZ = 1;
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/enum-no-allow-alias.md b/docs/public/docs/guide/cli/linter/rules/enum-no-allow-alias.md
deleted file mode 100644
index b352c45e..00000000
--- a/docs/public/docs/guide/cli/linter/rules/enum-no-allow-alias.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# ENUM_NO_ALLOW_ALIAS
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that the `allow_alias` option is not set to `true` in an enum.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    option allow_alias = true; // [!code focus]
-    BAR = 0;
-    BAZ = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    BAR = 0;
-    BAZ = 1;
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/enum-pascal-case.md b/docs/public/docs/guide/cli/linter/rules/enum-pascal-case.md
deleted file mode 100644
index 7e42519e..00000000
--- a/docs/public/docs/guide/cli/linter/rules/enum-pascal-case.md
+++ /dev/null
@@ -1,37 +0,0 @@
-# ENUM_PASCAL_CASE
-
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that enum names are in PascalCase.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum foo_bar {
-    BAR = 0;
-    BAZ = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum FooBar { // [!code focus]
-    BAR = 0;
-    BAZ = 1;
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/enum-value-prefix.md b/docs/public/docs/guide/cli/linter/rules/enum-value-prefix.md
deleted file mode 100644
index 0ee42f23..00000000
--- a/docs/public/docs/guide/cli/linter/rules/enum-value-prefix.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# ENUM_VALUE_PREFIX
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all enum values are prefixed with the enum name.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    BAR = 0;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    FOO_BAR = 0; // [!code focus]
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/enum-value-upper-snake-case.md b/docs/public/docs/guide/cli/linter/rules/enum-value-upper-snake-case.md
deleted file mode 100644
index bbb13a04..00000000
--- a/docs/public/docs/guide/cli/linter/rules/enum-value-upper-snake-case.md
+++ /dev/null
@@ -1,37 +0,0 @@
-# ENUM_VALUE_UPPER_SNAKE_CASE
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that enum values are in UPPER_SNAKE_CASE.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    barName = 0;
-    bazName = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    BAR_NAME = 0; // [!code focus]
-    BAZ_NAME = 1; // [!code focus]
-}
-```
-
diff --git a/docs/public/docs/guide/cli/linter/rules/enum-zero-value-suffix.md b/docs/public/docs/guide/cli/linter/rules/enum-zero-value-suffix.md
deleted file mode 100644
index b23a7aae..00000000
--- a/docs/public/docs/guide/cli/linter/rules/enum-zero-value-suffix.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# ENUM_ZERO_VALUE_SUFFIX
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all enum zero values are suffixed with `_NONE` or your custom suffix.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    BAR = 0;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    FOO_BAR_NONE = 0; // [!code focus]
-}
-```
-
-
diff --git a/docs/public/docs/guide/cli/linter/rules/field-lower-snake-case.md b/docs/public/docs/guide/cli/linter/rules/field-lower-snake-case.md
deleted file mode 100644
index 464b69b5..00000000
--- a/docs/public/docs/guide/cli/linter/rules/field-lower-snake-case.md
+++ /dev/null
@@ -1,34 +0,0 @@
-# FIELD_LOWER_SNAKE_CASE
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that field names of messages are in lower_snake_case.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    string BarName = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    string bar_name = 1; // [!code focus]
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/file-lower-snake-case.md b/docs/public/docs/guide/cli/linter/rules/file-lower-snake-case.md
deleted file mode 100644
index edf5735a..00000000
--- a/docs/public/docs/guide/cli/linter/rules/file-lower-snake-case.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# FILE_LOWER_SNAKE_CASE
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files are in lower_snake_case.
-
-## Examples
-
-### Bad
-
-```proto
-// File: bar/FooBaz.proto
-
-syntax = "proto3";
-```
-
-### Good
-
-```proto
-// File: bar/foo_baz.proto // [!code focus]
-
-syntax = "proto3";
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/import-no-public.md b/docs/public/docs/guide/cli/linter/rules/import-no-public.md
deleted file mode 100644
index 4df55a20..00000000
--- a/docs/public/docs/guide/cli/linter/rules/import-no-public.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# IMPORT_NO_PUBLIC
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that no public imports are used in a proto file.
-
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-import public "bar.proto";
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-import "bar.proto"; // [!code focus]
-```
-
diff --git a/docs/public/docs/guide/cli/linter/rules/import-no-weak.md b/docs/public/docs/guide/cli/linter/rules/import-no-weak.md
deleted file mode 100644
index c2a0a0fd..00000000
--- a/docs/public/docs/guide/cli/linter/rules/import-no-weak.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# IMPORT_NO_WEAK
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that no weak imports are used in a proto file.
-
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto2";
-
-package foo;
-
-import weak "bar.proto";
-```
-
-### Good
-
-```proto
-syntax = "proto2";
-
-package foo;
-
-import "bar.proto"; // [!code focus]
-```
-
diff --git a/docs/public/docs/guide/cli/linter/rules/import-used.md b/docs/public/docs/guide/cli/linter/rules/import-used.md
deleted file mode 100644
index 1e4daa84..00000000
--- a/docs/public/docs/guide/cli/linter/rules/import-used.md
+++ /dev/null
@@ -1,34 +0,0 @@
-# IMPORT_USED
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all imports are used in a proto file.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-import "bar.proto";
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-import "bar.proto"; // [!code focus]
-
-message Foo {
-    bar.Bar bar = 1; // [!code focus]
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/message-pascal-case.md b/docs/public/docs/guide/cli/linter/rules/message-pascal-case.md
deleted file mode 100644
index 36edaac2..00000000
--- a/docs/public/docs/guide/cli/linter/rules/message-pascal-case.md
+++ /dev/null
@@ -1,34 +0,0 @@
-# MESSAGE_PASCAL_CASE
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that message names are in PascalCase.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message foo_bar {
-    string bar_name = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message FooBar { // [!code focus]
-    string bar_name = 1;
-}
-```
\ No newline at end of file
diff --git a/docs/public/docs/guide/cli/linter/rules/oneof-lower-snake-case.md b/docs/public/docs/guide/cli/linter/rules/oneof-lower-snake-case.md
deleted file mode 100644
index a24faea5..00000000
--- a/docs/public/docs/guide/cli/linter/rules/oneof-lower-snake-case.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# ONEOF_LOWER_SNAKE_CASE
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that oneof names are in lower_snake_case.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    oneof BarName {
-        string bar_name = 1;
-    }
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    oneof bar_name { // [!code focus]
-        string bar_name = 1;
-    }
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/package-defined.md b/docs/public/docs/guide/cli/linter/rules/package-defined.md
deleted file mode 100644
index 72eb19c0..00000000
--- a/docs/public/docs/guide/cli/linter/rules/package-defined.md
+++ /dev/null
@@ -1,35 +0,0 @@
-
-# PACKAGE_DEFINED
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files have a package declaration.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    string bar = 1;
-}
-
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo; // [!code focus]
-
-message Foo {
-    string bar = 1;
-}
-```
-
diff --git a/docs/public/docs/guide/cli/linter/rules/package-directory-match.md b/docs/public/docs/guide/cli/linter/rules/package-directory-match.md
deleted file mode 100644
index 74be408f..00000000
--- a/docs/public/docs/guide/cli/linter/rules/package-directory-match.md
+++ /dev/null
@@ -1,39 +0,0 @@
-# PACKAGE_DIRECTORY_MATCH
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files are in a directory that matches their package name.
-
-## Examples
-
-### Bad
-
-```proto
-// File: bar/foo.proto
-
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    string bar = 1;
-}
-
-```
-
-### Good
-
-```proto
-// File: bar/foo.proto // [!code focus]
-
-syntax = "proto3";
-
-package bar; // [!code focus]
-
-message Foo {
-    string bar = 1;
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/package-lower-snake-case.md b/docs/public/docs/guide/cli/linter/rules/package-lower-snake-case.md
deleted file mode 100644
index 2c34f2ed..00000000
--- a/docs/public/docs/guide/cli/linter/rules/package-lower-snake-case.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# PACKAGE_LOWER_SNAKE_CASE
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that package names are in lower_snake_case.
-
-## Examples
-
-### Bad
-
-```proto
-// File: bar/foo.proto
-syntax = "proto3";
-
-package FooBar;
-```
-
-### Good
-
-```proto
-// File: bar/foo.proto
-syntax = "proto3";
-
-package foo_bar; // [!code focus]
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/package-same-csharp-namespace.md b/docs/public/docs/guide/cli/linter/rules/package-same-csharp-namespace.md
deleted file mode 100644
index 91a2b113..00000000
--- a/docs/public/docs/guide/cli/linter/rules/package-same-csharp-namespace.md
+++ /dev/null
@@ -1,56 +0,0 @@
-# PACKAGE_SAME_CSHARP_NAMESPACE
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same C# namespace.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option csharp_namespace = "Foo.Bar";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option csharp_namespace = "Foo.Baz";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto 
-
-syntax = "proto3";
-
-package pkg;
-
-option csharp_namespace = "Foo.Bar";
-```
-
-```proto
-
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option csharp_namespace = "Foo.Bar"; // [!code focus]
-```
-
diff --git a/docs/public/docs/guide/cli/linter/rules/package-same-directory.md b/docs/public/docs/guide/cli/linter/rules/package-same-directory.md
deleted file mode 100644
index 50274a4e..00000000
--- a/docs/public/docs/guide/cli/linter/rules/package-same-directory.md
+++ /dev/null
@@ -1,40 +0,0 @@
-# PACKAGE_SAME_DIRECTORY
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same directory.
-
-## Examples
-
-### Bad
-
-```proto
-// File: bar/foo.proto
-
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    string bar = 1;
-}
-
-```
-
-### Good
-
-```proto
-// File: bar/foo.proto // [!code focus]
-
-syntax = "proto3";
-
-package bar; // [!code focus]
-
-message Foo {
-    string bar = 1;
-}
-
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/package-same-go-package.md b/docs/public/docs/guide/cli/linter/rules/package-same-go-package.md
deleted file mode 100644
index 54f60292..00000000
--- a/docs/public/docs/guide/cli/linter/rules/package-same-go-package.md
+++ /dev/null
@@ -1,56 +0,0 @@
-# PACKAGE_SAME_GO_PACKAGE
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same Go package.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option go_package = "example.com/foo/bar";
-
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option go_package = "example.com/foo/baz";
-
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option go_package = "example.com/foo/bar"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option go_package = "example.com/foo/bar"; // [!code focus]
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/package-same-java-multiple-files.md b/docs/public/docs/guide/cli/linter/rules/package-same-java-multiple-files.md
deleted file mode 100644
index 9cebc6bc..00000000
--- a/docs/public/docs/guide/cli/linter/rules/package-same-java-multiple-files.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# PACKAGE_SAME_JAVA_MULTIPLE_FILES
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same Java package.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo";
-```
-
-```proto
-
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.bar";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo"; // [!code focus]
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/package-same-java-package.md b/docs/public/docs/guide/cli/linter/rules/package-same-java-package.md
deleted file mode 100644
index a2439eed..00000000
--- a/docs/public/docs/guide/cli/linter/rules/package-same-java-package.md
+++ /dev/null
@@ -1,57 +0,0 @@
-# PACKAGE_SAME_JAVA_PACKAGE
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same Java package.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.bar";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo"; // [!code focus]
-```
-
-
diff --git a/docs/public/docs/guide/cli/linter/rules/package-same-php-namespace.md b/docs/public/docs/guide/cli/linter/rules/package-same-php-namespace.md
deleted file mode 100644
index a8fe8670..00000000
--- a/docs/public/docs/guide/cli/linter/rules/package-same-php-namespace.md
+++ /dev/null
@@ -1,56 +0,0 @@
-# PACKAGE_SAME_PHP_NAMESPACE
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same PHP namespace.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option php_namespace = "Foo\\Bar";
-
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option php_namespace = "Foo\\Baz";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option php_namespace = "Foo\\Bar"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option php_namespace = "Foo\\Bar"; // [!code focus]
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/package-same-ruby-package.md b/docs/public/docs/guide/cli/linter/rules/package-same-ruby-package.md
deleted file mode 100644
index eb2cfce4..00000000
--- a/docs/public/docs/guide/cli/linter/rules/package-same-ruby-package.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# PACKAGE_SAME_RUBY_PACKAGE
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same Ruby package.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option ruby_package = "Foo";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option ruby_package = "Bar";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option ruby_package = "Foo"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option ruby_package = "Foo"; // [!code focus]
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/package-same-swift-prefix.md b/docs/public/docs/guide/cli/linter/rules/package-same-swift-prefix.md
deleted file mode 100644
index 907a6924..00000000
--- a/docs/public/docs/guide/cli/linter/rules/package-same-swift-prefix.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# PACKAGE_SAME_SWIFT_PREFIX
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same Swift prefix.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option swift_prefix = "Foo";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option swift_prefix = "Bar";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option swift_prefix = "Foo"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option swift_prefix = "Foo"; // [!code focus]
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/package-version-suffix.md b/docs/public/docs/guide/cli/linter/rules/package-version-suffix.md
deleted file mode 100644
index 43c500c0..00000000
--- a/docs/public/docs/guide/cli/linter/rules/package-version-suffix.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# PACKAGE_VERSION_SUFFIX
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that the package version suffix is `_vX` where `X` is a number of version.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;   
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo.v1; // [!code focus]
-```
-
-
diff --git a/docs/public/docs/guide/cli/linter/rules/rpc-no-client-streaming.md b/docs/public/docs/guide/cli/linter/rules/rpc-no-client-streaming.md
deleted file mode 100644
index 84f4f8c4..00000000
--- a/docs/public/docs/guide/cli/linter/rules/rpc-no-client-streaming.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# RPC_NO_CLIENT_STREAMING
-
-Categories:
-
-- **UNARY_RPC**
-
-This rule checks that rpc has no client streaming.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (stream BarRequest) returns (BarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus]
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/rpc-no-server-streaming.md b/docs/public/docs/guide/cli/linter/rules/rpc-no-server-streaming.md
deleted file mode 100644
index 8ea8558a..00000000
--- a/docs/public/docs/guide/cli/linter/rules/rpc-no-server-streaming.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# RPC_NO_SERVER_STREAMING
-
-Categories:
-
-- **UNARY_RPC**
-
-This rule checks that rpc has no server streaming.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (stream BarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus]
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/rpc-pascal-case.md b/docs/public/docs/guide/cli/linter/rules/rpc-pascal-case.md
deleted file mode 100644
index 31007997..00000000
--- a/docs/public/docs/guide/cli/linter/rules/rpc-pascal-case.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# RPC_PASCAL_CASE
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all RPC names are in PascalCase.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service foo_bar {
-    rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service FooBar {
-    rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} // [!code focus]
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/rpc-request-response-unique.md b/docs/public/docs/guide/cli/linter/rules/rpc-request-response-unique.md
deleted file mode 100644
index d35a5e3c..00000000
--- a/docs/public/docs/guide/cli/linter/rules/rpc-request-response-unique.md
+++ /dev/null
@@ -1,35 +0,0 @@
-# RPC_REQUEST_RESPONSE_UNIQUE
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all RPC request and response messages are unique.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (FooRequest) returns (FooResponse) {}
-    rpc GetBar (FooRequest) returns (FooResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (FooRequest) returns (FooResponse) {} // [!code focus]
-    rpc GetBar (BarRequest) returns (BarResponse) {} // [!code focus]
-}
-```
-
-
diff --git a/docs/public/docs/guide/cli/linter/rules/rpc-request-standard-name.md b/docs/public/docs/guide/cli/linter/rules/rpc-request-standard-name.md
deleted file mode 100644
index c33768a7..00000000
--- a/docs/public/docs/guide/cli/linter/rules/rpc-request-standard-name.md
+++ /dev/null
@@ -1,30 +0,0 @@
-# RPC_REQUEST_STANDARD_NAME
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all RPC request messages are named `MethodRequest`.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (FooRequest) returns (FooResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (GetFooRequest) returns (FooResponse) {} // [!code focus]
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/rpc-response-standard-name.md b/docs/public/docs/guide/cli/linter/rules/rpc-response-standard-name.md
deleted file mode 100644
index 0f7b9980..00000000
--- a/docs/public/docs/guide/cli/linter/rules/rpc-response-standard-name.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# RPC_RESPONSE_STANDARD_NAME
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all RPC response messages are named `MethodResponse`.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (GetFooRequest) returns (Foo) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (GetFooRequest) returns (GetFooResponse) {} // [!code focus]
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/service-pascal-case.md b/docs/public/docs/guide/cli/linter/rules/service-pascal-case.md
deleted file mode 100644
index f30504f4..00000000
--- a/docs/public/docs/guide/cli/linter/rules/service-pascal-case.md
+++ /dev/null
@@ -1,30 +0,0 @@
-# SERVICE_PASCAL_CASE
-
-Categories:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all service names are in PascalCase.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service foo_bar {
-    rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service FooBar { // [!code focus]
-    rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} 
-}
-```
diff --git a/docs/public/docs/guide/cli/linter/rules/service-suffix.md b/docs/public/docs/guide/cli/linter/rules/service-suffix.md
deleted file mode 100644
index af781ecc..00000000
--- a/docs/public/docs/guide/cli/linter/rules/service-suffix.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# SERVICE_SUFFIX
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all services are suffixed with `Service` or your custom suffix.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar(BarRequest) returns (BarResponse);
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service FooService { // [!code focus]
-    rpc Bar(BarRequest) returns (BarResponse); 
-}
-```
-
diff --git a/docs/public/docs/guide/cli/package-manager/easyp-vs-buf.md b/docs/public/docs/guide/cli/package-manager/easyp-vs-buf.md
deleted file mode 100644
index 021e1ddd..00000000
--- a/docs/public/docs/guide/cli/package-manager/easyp-vs-buf.md
+++ /dev/null
@@ -1,453 +0,0 @@
-# EasyP vs Buf Package Management
-
-[[toc]]
-
-This document provides a comprehensive comparison between EasyP's decentralized package management approach and Buf's centralized Buf Schema Registry (BSR) model, helping you understand the key differences and choose the right solution for your needs.
-
-## Architecture Comparison
-
-### EasyP: Decentralized Git-Based Approach
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                     EasyP Architecture                          │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│  Developer Machine           Git Repositories                   │
-│  ┌──────────────┐           ┌─────────────────┐                │
-│  │              │  clone/   │ github.com/     │                │
-│  │ ~/.easyp/    │◄─────────►│ googleapis/     │                │
-│  │ cache/       │  fetch    │ googleapis      │                │
-│  │              │           │                 │                │
-│  │ mod/         │           ├─────────────────┤                │
-│  │              │           │ company.com/    │                │
-│  └──────────────┘           │ internal-protos │                │
-│                              │                 │                │
-│                              ├─────────────────┤                │
-│                              │ gitlab.com/     │                │
-│                              │ team/shared     │                │
-│                              └─────────────────┘                │
-│                                                                 │
-│  ✅ Direct repository access                                    │
-│  ✅ No single point of failure                                  │
-│  ✅ Works with any Git hosting                                  │
-│  ✅ Complete control over dependencies                          │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-### Buf: Centralized Registry Approach
-
-```
-┌────────────────────────────────────────────────────────────────┐
-│                      Buf Architecture                          │
-├────────────────────────────────────────────────────────────────┤
-│                                                                │
-│  Developer Machine               Buf Schema Registry (BSR)     │
-│  ┌──────────────┐              ┌─────────────────────────────┐ │
-│  │              │   push/pull  │                             │ │
-│  │ ~/.cache/    │◄────────────►│  buf.build                  │ │
-│  │ bufcli/      │   modules    │                             │ │
-│  │              │              │ ┌─────────────────────────┐ │ │
-│  │              │              │ │ googleapis/googleapis   │ │ │
-│  │              │              │ ├─────────────────────────┤ │ │
-│  │              │              │ │ grpc/grpc               │ │ │
-│  │              │              │ ├─────────────────────────┤ │ │
-│  │              │              │ │ envoyproxy/protoc-gen-  │ │ │
-│  │              │              │ │ validate                │ │ │
-│  └──────────────┘              │ └─────────────────────────┘ │ │
-│                                │                             │ │
-│                                └─────────────────────────────┘ │
-│                                                                │
-│  ⚠️  Centralized dependency                                    │
-│  ⚠️  Single point of control                                   │
-│  ⚠️  Requires buf.build access                                 │
-│  ⚠️  Limited to BSR ecosystem                                  │
-│                                                                │
-└────────────────────────────────────────────────────────────────┘
-```
-
-## Key Differences Summary
-
-| Aspect | EasyP | Buf |
-|--------|-------|-----|
-| **Architecture** | Decentralized (Git-based) | Centralized (BSR registry) |
-| **Dependency Source** | Any Git repository | Buf Schema Registry only |
-| **Single Point of Failure** | No | Yes (buf.build) |
-| **Enterprise Deployment** | Fully air-gapped support | Requires BSR access or private BSR |
-| **Authentication** | Git credentials (SSH/HTTPS) | Buf tokens + Git credentials |
-| **Vendor Lock-in** | None | Buf ecosystem |
-| **Private Repositories** | Native Git support | Must publish to BSR first |
-| **Offline Support** | Full (via vendoring) | Limited (cached modules only) |
-| **Cost** | Free (uses existing Git) | Free tier + paid plans |
-| **Setup Complexity** | Minimal | Moderate (BSR setup) |
-
-## Detailed Feature Comparison
-
-### 1. Dependency Management Philosophy
-
-#### EasyP: "Any Git Repository is a Package"
-```yaml
-# Direct Git repository references
-deps:
-  - github.com/googleapis/googleapis@v1.2.3
-  - gitlab.company.com/protos/internal@v2.0.1
-  - git.example.com/team/shared-types@main
-```
-
-**Advantages:**
-- ✅ Use any existing Git repository immediately
-- ✅ No need to "publish" to a separate registry
-- ✅ Version control is the source of truth
-- ✅ Works with private Git servers out-of-the-box
-
-#### Buf: "Registry-First Approach"
-```yaml
-# buf.yaml - Must reference BSR modules
-version: v1
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/grpc/grpc
-  - buf.build/envoyproxy/protoc-gen-validate
-```
-
-**Advantages:**
-- ✅ Curated, high-quality modules
-- ✅ Rich metadata and documentation
-- ✅ Dependency graph visualization
-- ✅ Semantic versioning enforcement
-
-**Limitations:**
-- ❌ Must publish to BSR before use
-- ❌ Requires BSR account and authentication
-- ❌ Cannot reference arbitrary Git repositories directly
-
-### 2. Enterprise and Air-Gapped Environments
-
-#### EasyP: Full Air-Gap Support
-
-**Scenario**: Large enterprise with strict network policies
-
-```bash
-# 1. Initial setup (with internet)
-easyp mod download          # Downloads to ~/.easyp/
-easyp mod vendor           # Creates easyp_vendor/
-
-# 2. Transfer to air-gapped environment
-tar -czf easyp-deps.tar.gz ~/.easyp easyp_vendor/
-# ... transfer archive ...
-
-# 3. Air-gapped environment (no internet)
-tar -xzf easyp-deps.tar.gz
-export EASYPPATH=$PWD/.easyp
-easyp generate             # Works offline
-```
-
-**Benefits:**
-- ✅ Complete independence from external services
-- ✅ No need for internal registry infrastructure
-- ✅ Uses existing Git infrastructure
-- ✅ Simple file-based distribution
-
-#### Buf: Requires BSR Infrastructure
-
-**Scenario**: Same enterprise setup
-
-```bash
-# Option 1: Use buf.build (requires internet)
-buf mod download           # Must reach buf.build
-
-# Option 2: Set up private BSR (complex)
-# - Deploy BSR server infrastructure
-# - Migrate all modules to private BSR
-# - Configure authentication and access
-# - Maintain registry server
-```
-
-**Challenges:**
-- ❌ Requires constant internet access OR expensive private BSR
-- ❌ Complex infrastructure for private deployments
-- ❌ All modules must be re-published to private registry
-- ❌ Additional operational overhead
-
-### 3. Security and Control
-
-#### EasyP: Direct Control
-```yaml
-# Full control over dependency sources
-deps:
-  # Public repository - your choice of version
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-
-  # Internal repository - complete control
-  - gitlab.company.com/security/validated-protos@v1.0.0
-
-  # Specific commit for security fix
-  - github.com/bufbuild/protoc-gen-validate@abc123def456
-```
-
-**Security advantages:**
-- ✅ **No intermediary** - direct from source repository
-- ✅ **Audit trail** - Git commit history is the source of truth
-- ✅ **Cannot be "banned"** - no external party can revoke access
-- ✅ **Custom validation** - implement your own security scanning
-- ✅ **Fork protection** - easily fork and maintain dependencies
-
-#### Buf: Registry Dependency
-
-```yaml
-# Dependencies controlled by BSR
-deps:
-  - buf.build/googleapis/googleapis  # Controlled by Buf
-  - buf.build/grpc/grpc             # Could be removed/updated
-```
-
-**Security considerations:**
-- ⚠️ **Intermediary risk** - BSR controls what's available
-- ⚠️ **Account suspension** - Could lose access to dependencies
-- ⚠️ **Module removal** - Modules can be deleted from registry
-- ⚠️ **Update policies** - BSR may force updates or deprecations
-- ⚠️ **Third-party trust** - Must trust Buf's security practices
-
-### 4. Real-World Scenarios
-
-#### Scenario 1: Startup with Public Dependencies
-
-**EasyP Approach:**
-```yaml
-# Simple, direct references
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-```
-
-**Buf Approach:**
-```yaml
-# Requires understanding BSR module names
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/grpcecosystem/grpc-gateway
-```
-
-**Winner**: Tie - both work well for public dependencies
-
-#### Scenario 2: Enterprise with Mixed Public/Private Dependencies
-
-**EasyP Approach:**
-```yaml
-deps:
-  # Public
-  - github.com/googleapis/googleapis@v1.2.3
-
-  # Private (existing Git repos)
-  - github.com/mycompany/auth-protos@v2.0.0
-  - gitlab.enterprise.com/platform/shared-types@v1.5.1
-```
-
-**Buf Approach:**
-```yaml
-# All must be published to BSR first
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/mycompany/auth-protos      # Requires BSR publication
-  - buf.build/mycompany/shared-types     # Requires BSR publication
-```
-
-**Winner**: **EasyP** - no additional setup for private repos
-
-#### Scenario 3: Government/Defense Contractor (Air-Gapped)
-
-**EasyP Approach:**
-```bash
-# Internet-connected environment
-easyp mod vendor
-
-# Transfer to classified environment
-# Works immediately without any external dependencies
-```
-
-**Buf Approach:**
-```bash
-# Must deploy and maintain private BSR infrastructure
-# All modules must be re-published internally
-# Complex operational overhead
-```
-
-**Winner**: **EasyP** - significantly simpler air-gap deployment
-
-#### Scenario 4: Compliance and Auditing
-
-**EasyP Approach:**
-- ✅ **Direct audit trail**: Git commits show exact changes
-- ✅ **Compliance-friendly**: No external dependencies in production
-- ✅ **Reproducible**: Lock files pin exact Git commits
-- ✅ **Vulnerability management**: Direct control over security updates
-
-**Buf Approach:**
-- ⚠️ **Registry dependency**: Must audit BSR's security practices
-- ⚠️ **Third-party risk**: BSR is part of your compliance scope
-- ⚠️ **Limited control**: Cannot control when modules are updated/removed
-- ⚠️ **Audit complexity**: Must trace registry → Git → actual code
-
-**Winner**: **EasyP** - cleaner compliance story
-
-### 5. Cost and Infrastructure
-
-#### EasyP: Zero Additional Infrastructure
-
-**Costs:**
-- ✅ **$0** - Uses existing Git infrastructure
-- ✅ **No additional servers** to maintain
-- ✅ **No licensing fees** for registry software
-- ✅ **Scales with Git** - proven enterprise scalability
-
-**Infrastructure:**
-- Uses existing Git repositories (GitHub, GitLab, etc.)
-- Leverages existing authentication systems
-- No additional backup/disaster recovery needed
-
-#### Buf: Registry Infrastructure Costs
-
-**BSR Hosted (buf.build):**
-- ✅ Free tier available
-- ❌ Paid plans for private modules and teams
-- ❌ Subject to external pricing changes
-- ❌ Data locality concerns for some enterprises
-
-**Private BSR Deployment:**
-- ❌ Significant infrastructure costs (servers, databases, load balancers)
-- ❌ Operational overhead (monitoring, updates, backups)
-- ❌ Licensing costs for enterprise features
-- ❌ Additional disaster recovery planning
-
-### 6. Migration and Lock-in
-
-#### EasyP: No Lock-in
-
-**Migration FROM EasyP:**
-```yaml
-# EasyP dependencies are just Git repositories
-# Can easily migrate to any other system that supports Git
-deps:
-  - github.com/googleapis/googleapis@v1.2.3  # Standard Git reference
-```
-
-**Migration TO EasyP:**
-```bash
-# From any Git-based system
-# Just reference the same repositories directly
-```
-
-#### Buf: Potential Lock-in
-
-**Migration FROM Buf:**
-- ❌ Must identify original Git repositories for each BSR module
-- ❌ BSR-specific module names don't translate directly
-- ❌ May lose version history and metadata
-- ❌ Complex if heavily integrated with BSR ecosystem
-
-**Migration TO Buf:**
-- ❌ Must publish all dependencies to BSR first
-- ❌ Cannot reference Git repositories directly
-- ❌ Must adopt BSR workflow and tooling
-
-## When to Choose Each Solution
-
-### Choose EasyP When:
-
-✅ **Enterprise/Air-gapped environments**
-- Need to work without external dependencies
-- Strict compliance requirements
-- Air-gapped or classified networks
-
-✅ **Security-first organizations**
-- Want direct control over dependency sources
-- Need to audit entire supply chain
-- Concerned about third-party service risks
-
-✅ **Existing Git-heavy workflows**
-- Team already comfortable with Git
-- Extensive private repository usage
-- Want to minimize new tools/infrastructure
-
-✅ **Cost-sensitive projects**
-- Want to avoid additional licensing costs
-- Don't want infrastructure overhead
-- Need predictable, zero-cost scaling
-
-✅ **Mixed public/private dependencies**
-- Heavy use of internal Git repositories
-- Don't want to republish existing repos
-- Need flexibility in dependency sources
-
-### Choose Buf When:
-
-✅ **Heavy BSR ecosystem usage**
-- Already invested in Buf tooling (lint, breaking changes, generation)
-- Want curated, high-quality modules
-- Benefit from BSR's rich metadata and docs
-
-✅ **Collaborative development**
-- Need dependency graph visualization
-- Want centralized module discovery
-- Benefit from BSR's collaboration features
-
-✅ **Simple public-only dependencies**
-- Primarily use well-known public modules
-- Don't mind BSR dependency
-- Value the curated module experience
-
-✅ **Team new to protobuf**
-- Benefit from BSR's documentation and examples
-- Want guided module discovery
-- Prefer opinionated, structured approach
-
-## Migration Paths
-
-### Migrating from Buf to EasyP
-
-1. **Identify source repositories** for each BSR module
-2. **Map BSR modules** to Git repository references
-3. **Update configuration** to use Git URLs
-4. **Test compatibility** and resolve any issues
-
-Example migration:
-```yaml
-# Before (buf.yaml)
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/grpc/grpc
-
-# After (easyp.yaml)
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/grpc/grpc@v1.50.0
-```
-
-### Migrating from EasyP to Buf
-
-1. **Publish modules** to BSR (if not already available)
-2. **Create BSR account** and configure authentication
-3. **Update configuration** to reference BSR modules
-4. **Adopt BSR workflow** (push, pull, etc.)
-
-## Conclusion
-
-Both EasyP and Buf offer valid approaches to protobuf dependency management, but they serve different needs:
-
-**EasyP excels in:**
-- Enterprise and air-gapped environments
-- Security-conscious organizations
-- Cost-sensitive projects
-- Direct Git repository usage
-- Zero-infrastructure deployments
-
-**Buf excels in:**
-- Collaborative, open-source focused teams
-- Organizations wanting curated, high-quality modules
-- Teams new to protobuf ecosystem
-- Projects heavily using BSR features
-
-The choice between EasyP and Buf often comes down to your organization's priorities around **control vs. convenience**, **security vs. collaboration features**, and **infrastructure costs vs. managed services**.
-
-For many enterprise environments, EasyP's decentralized, Git-native approach provides the security, control, and cost-effectiveness needed for production protobuf workflows, while Buf's centralized registry excels in collaborative, open-source focused development environments.
diff --git a/docs/public/docs/guide/cli/package-manager/package-manager.md b/docs/public/docs/guide/cli/package-manager/package-manager.md
deleted file mode 100644
index 72562b83..00000000
--- a/docs/public/docs/guide/cli/package-manager/package-manager.md
+++ /dev/null
@@ -1,552 +0,0 @@
-# Package Manager
-
-[[toc]]
-
-EasyP provides a powerful package manager for protobuf dependencies that simplifies dependency management through a decentralized, Git-based approach. Unlike centralized solutions, EasyP works directly with Git repositories, giving you complete control over your dependencies.
-
-## Overview
-
-The EasyP package manager follows the **Go modules philosophy** - any Git repository can serve as a package source. This approach provides several key advantages:
-
-- **Decentralized**: No single point of failure or control
-- **Security**: Direct access to source repositories
-- **Flexibility**: Support for public, private, and enterprise repositories
-- **Reproducibility**: Lock files ensure consistent builds across environments
-- **Performance**: Local caching minimizes network requests
-
-### Key Features
-
-| Feature | Description |
-|---------|-------------|
-| **Git-Native** | Works with any Git repository - no special server required |
-| **Multiple Version Formats** | Tags, commits, pseudo-versions, latest |
-| **Lock Files** | Reproducible builds with `easyp.lock` |
-| **Local Caching** | Go modules-style cache architecture |
-| **Vendoring Support** | Copy dependencies locally for offline builds |
-| **YAML Configuration** | Simple, readable dependency declarations |
-
-## Architecture
-
-EasyP uses a two-tier caching system inspired by Go modules:
-
-```
-~/.easyp/
-├── cache/
-│   ├── download/              # Downloaded archives + checksums
-│   │   └── github.com/
-│   │       └── googleapis/
-│   │           └── googleapis/
-│   │               ├── v1.2.3.zip       # Archive
-│   │               ├── v1.2.3.ziphash   # Checksum
-│   │               └── v1.2.3.info      # Metadata
-│   └── {git-hash}/            # Git bare repositories (internal)
-└── mod/                       # Extracted, ready-to-use modules
-    └── github.com/
-        └── googleapis/
-            └── googleapis/
-                ├── v1.2.3/           # Tagged version
-                │   ├── google/
-                │   │   ├── api/
-                │   │   └── rpc/
-                │   └── ...
-                └── v0.0.0-20250101123456-abc123def/  # Pseudo-version
-                    ├── google/
-                    └── ...
-```
-
-### Cache Location
-
-| Environment | Location | How to Set |
-|-------------|----------|------------|
-| **Default** | `$HOME/.easyp` | Automatic |
-| **Custom** | Any directory | Set `EASYPPATH` environment variable |
-| **CI/CD** | Project-relative | `export EASYPPATH=$CI_PROJECT_DIR/.easyp` |
-
-## Configuration
-
-### Basic Configuration
-
-Configure dependencies in your `easyp.yaml` file:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-  - github.com/bufbuild/protoc-gen-validate
-```
-
-### Advanced Configuration Examples
-
-#### Multi-Environment Setup
-```yaml
-# development.easyp.yaml
-deps:
-  - github.com/googleapis/googleapis              # Latest for development
-  - github.com/mycompany/internal-protos          # Latest internal changes
-  - github.com/bufbuild/protoc-gen-validate       # Latest features
-
-# production.easyp.yaml
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1       # Pinned
-  - github.com/mycompany/internal-protos@v2.1.0                # Stable release
-  - github.com/bufbuild/protoc-gen-validate@v0.10.1           # Tested version
-```
-
-#### Private Repository Setup
-```yaml
-deps:
-  # Public dependencies
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-
-  # Private company repositories
-  - github.com/mycompany/auth-protos@v1.5.0
-  - github.com/mycompany/common-types@v2.0.1
-
-  # Internal GitLab
-  - gitlab.company.com/platform/messaging-protos@v0.3.0
-```
-
-## Versioning Strategies
-
-EasyP supports multiple versioning approaches to fit different development workflows:
-
-### 1. Semantic Version Tags (Recommended for Production)
-
-```yaml
-deps:
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-```
-
-**Use when:**
-- Production deployments
-- Stable API consumption
-- Reproducible builds required
-
-### 2. Latest Tag (Development)
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis    # Uses latest available tag
-  - github.com/bufbuild/protoc-gen-validate
-```
-
-**Use when:**
-- Active development
-- Want latest features
-- Compatibility testing
-
-### 3. Commit Hashes (Bleeding Edge)
-
-```yaml
-deps:
-  - github.com/bufbuild/protoc-gen-validate@abc123def456789abcdef123456789abcdef1234
-```
-
-**Use when:**
-- Need unreleased features
-- Testing specific fixes
-- Contributing to upstream
-
-### 4. Pseudo-Versions (Automatic)
-
-When EasyP can't find a suitable tag, it generates pseudo-versions automatically:
-
-```
-Format: v0.0.0-{timestamp}-{short-commit-hash}
-Example: v0.0.0-20250908104020-660ec2d64e07f2fa8947527443af058b3d7169df
-```
-
-This ensures every commit can be referenced with a version-like identifier.
-
-## Commands
-
-### `easyp mod download`
-
-Downloads and installs all dependencies declared in your configuration.
-
-**What happens:**
-1. **Resolves versions**: Converts tags/latest to specific commits
-2. **Downloads archives**: Stores `.zip` files in cache/download
-3. **Verifies checksums**: Ensures archive integrity
-4. **Extracts modules**: Unpacks to cache/mod with proper structure
-5. **Updates lock file**: Records exact versions and content hashes
-
-**Usage:**
-```bash
-# Use default easyp.yaml
-easyp mod download
-
-# Use custom config file
-easyp --cfg production.easyp.yaml mod download
-
-# With custom cache location
-EASYPPATH=/tmp/easyp-cache easyp mod download
-```
-
-**Example output:**
-```
-INFO Download package package=github.com/googleapis/googleapis version=v0.0.0-20250909114430 commit=8727b5ba
-INFO Install package package=github.com/googleapis/googleapis version=v0.0.0-20250909114430 commit=8727b5ba
-INFO Download package package=github.com/grpc-ecosystem/grpc-gateway version=v2.19.1 commit=a070de73
-INFO Install package package=github.com/grpc-ecosystem/grpc-gateway version=v2.19.1 commit=a070de73
-```
-
-### `easyp mod vendor`
-
-Copies all installed proto files to a local `easyp_vendor/` directory for offline usage.
-
-**Use cases:**
-- **Docker builds**: Avoid network dependencies in containers
-- **Air-gapped environments**: No internet access during builds
-- **Reproducible builds**: Bundle exact dependency versions
-- **Performance**: Eliminate network latency in repeated builds
-
-**Usage:**
-```bash
-easyp mod vendor
-```
-
-**Result structure:**
-```
-easyp_vendor/
-├── github.com/
-│   ├── googleapis/
-│   │   └── googleapis/
-│   │       ├── google/
-│   │       │   ├── api/
-│   │       │   │   ├── annotations.proto
-│   │       │   │   └── http.proto
-│   │       │   └── rpc/
-│   │       │       └── status.proto
-│   │       └── ...
-│   └── grpc-ecosystem/
-│       └── grpc-gateway/
-│           └── protoc-gen-openapiv2/
-│               └── options/
-│                   └── annotations.proto
-```
-
-### `easyp mod update`
-
-Updates module versions based on current configuration and writes resolved versions to the lock file.
-
-**Behavior:**
-- Respects version constraints in `easyp.yaml`
-- Updates to latest compatible versions
-- Regenerates `easyp.lock` with new versions and hashes
-
-**Usage:**
-```bash
-easyp mod update
-```
-
-## Lock Files
-
-The `easyp.lock` file ensures reproducible builds by recording exact versions and content hashes:
-
-```
-github.com/bufbuild/protoc-gen-validate v0.0.0-20250908104020-660ec2d64e07f2fa8947527443af058b3d7169df h1:ZZ5JyUkmrj9OBHM+gOCzeL5L/pAKVbsUl051yhhJTjU=
-github.com/googleapis/googleapis v0.0.0-20250909114430-8727b5ba7f23fbbfddda58239e8bc6b547e05878 h1:eI+XYpPio3fxl9H5/VjW2PxlxM/7yqPjEq3oQ6jUkj4=
-github.com/grpc-ecosystem/grpc-gateway v2.19.1 h1:01NNlCezvwUQ07ZvblXH0kelWq8hNl2qb44bOMcaSTQ=
-```
-
-### Lock File Format
-
-Each line contains three components:
-- **Module path**: Full repository path
-- **Exact version**: Resolved version (tag or pseudo-version)
-- **Content hash**: SHA256 of extracted content (`h1:` prefix)
-
-### Best Practices
-
-✅ **Always commit `easyp.lock`** - Ensures team consistency
-✅ **Run `mod update` deliberately** - Don't auto-update in CI
-✅ **Review lock changes** - Understand what's being updated
-❌ **Don't edit manually** - Let EasyP manage the format
-
-## Authentication
-
-### Public Repositories
-
-No setup required - works out of the box:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/bufbuild/protoc-gen-validate
-```
-
-### Private Repositories
-
-#### SSH Keys (Recommended)
-
-Configure Git to use SSH for GitHub/GitLab:
-
-```bash
-# For GitHub
-git config --global url."git@github.com:".insteadOf "https://github.com/"
-
-# For GitLab
-git config --global url."git@gitlab.com:".insteadOf "https://gitlab.com/"
-
-# For custom domains
-git config --global url."git@gitlab.company.com:".insteadOf "https://gitlab.company.com/"
-```
-
-Then use normal HTTPS URLs in your config:
-
-```yaml
-deps:
-  - github.com/mycompany/private-protos@v1.0.0
-  - gitlab.company.com/platform/shared-types@v2.1.0
-```
-
-#### Personal Access Tokens
-
-For HTTPS authentication:
-
-```bash
-# Method 1: Credential helper
-git config --global credential.helper store
-echo "https://username:token@github.com" >> ~/.git-credentials
-
-# Method 2: URL rewriting
-git config --global url."https://username:token@github.com/mycompany".insteadOf "https://github.com/mycompany"
-```
-
-#### Corporate Environments
-
-```bash
-# Configure proxy
-git config --global http.proxy http://proxy.company.com:8080
-git config --global https.proxy https://proxy.company.com:8080
-
-# Configure certificates for internal Git servers
-git config --global http.sslCAInfo /path/to/certificate.pem
-```
-
-## Common Workflows
-
-### Initial Project Setup
-
-```bash
-# 1. Create configuration
-cat > easyp.yaml << EOF
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-EOF
-
-# 2. Download dependencies
-easyp mod download
-
-# 3. Verify installation
-ls ~/.easyp/mod/github.com/googleapis/googleapis/
-```
-
-### Adding New Dependencies
-
-```bash
-# 1. Edit easyp.yaml
-echo "  - github.com/bufbuild/protoc-gen-validate@v0.10.1" >> easyp.yaml
-
-# 2. Download new dependency
-easyp mod download
-
-# 3. Commit lock file changes
-git add easyp.lock
-git commit -m "Add protoc-gen-validate dependency"
-```
-
-### Updating Dependencies
-
-```bash
-# Update to latest compatible versions
-easyp mod update
-
-# Review changes
-git diff easyp.lock
-
-# Test with new versions
-easyp generate
-easyp lint
-
-# Commit if everything works
-git add easyp.lock
-git commit -m "Update dependencies"
-```
-
-### Offline Development
-
-```bash
-# Vendor all dependencies
-easyp mod vendor
-
-# Now your project works offline
-easyp generate
-```
-
-## Troubleshooting
-
-### Common Issues
-
-#### "Repository not found" or "Authentication failed"
-
-**Problem**: Can't access private repository
-**Solution**: Check authentication setup
-
-```bash
-# Test Git access
-git ls-remote https://github.com/mycompany/private-repo
-
-# Check Git configuration
-git config --list | grep url
-```
-
-#### "Version not found"
-
-**Problem**: Specified tag/version doesn't exist
-**Solution**: Check available tags
-
-```bash
-# List available tags
-git ls-remote --tags https://github.com/googleapis/googleapis
-
-# Use existing tag or commit hash
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1  # Valid tag
-```
-
-#### "Cache corruption" or "Checksum mismatch"
-
-**Problem**: Corrupted cache files
-**Solution**: Clear cache and re-download
-
-```bash
-# Clear everything
-rm -rf ~/.easyp
-
-# Or clear just downloads
-rm -rf ~/.easyp/cache/download
-
-# Re-download
-easyp mod download
-```
-
-#### Network timeouts
-
-**Problem**: Slow or unreliable network
-**Solution**: Configure Git timeouts
-
-```bash
-# Increase timeout
-git config --global http.lowSpeedLimit 1000
-git config --global http.lowSpeedTime 300
-
-# Use proxy if available
-git config --global http.proxy http://proxy.company.com:8080
-```
-
-### Performance Optimization
-
-#### For Large Teams
-
-```bash
-# Use shared cache server (if available)
-export EASYPPATH=/shared/easyp-cache
-
-# Or use team-specific cache
-export EASYPPATH=/team-cache/easyp
-```
-
-#### For CI/CD Systems
-
-```bash
-# Use project-relative cache
-export EASYPPATH=$CI_PROJECT_DIR/.easyp
-
-# Cache between builds (GitLab CI example)
-cache:
-  key: easyp-$CI_COMMIT_REF_SLUG
-  paths:
-    - .easyp/
-```
-
-#### Cache Size Management
-
-```bash
-# Check cache usage
-du -sh ~/.easyp
-du -sh ~/.easyp/cache/download    # Archives only
-du -sh ~/.easyp/mod               # Extracted modules
-
-# Clean old versions (manual)
-find ~/.easyp/mod -type d -name "v0.0.0-*" -mtime +30 -exec rm -rf {} \;
-```
-
-## Integration Examples
-
-### Docker Multi-stage Build
-
-```dockerfile
-# Stage 1: Download dependencies
-FROM ghcr.io/easyp-tech/easyp:latest AS deps
-WORKDIR /workspace
-COPY easyp.yaml easyp.lock ./
-RUN easyp mod vendor
-
-# Stage 2: Build application
-FROM alpine:latest AS build
-WORKDIR /app
-COPY --from=deps /workspace/easyp_vendor ./easyp_vendor
-COPY . .
-# Use vendored dependencies for generation
-RUN easyp generate
-```
-
-### Monorepo Structure
-
-```
-my-monorepo/
-├── services/
-│   ├── auth-service/
-│   │   └── easyp.yaml          # Service-specific deps
-│   └── user-service/
-│       └── easyp.yaml          # Different deps
-├── shared/
-│   └── common-protos/          # Internal protos
-└── easyp.yaml                  # Global/shared deps
-```
-
-Each `easyp.yaml` can have different dependencies based on service needs.
-
-## Best Practices
-
-### Development Workflow
-- ✅ Use **latest tags** during active development
-- ✅ **Pin versions** for production deployments
-- ✅ **Commit lock files** to ensure reproducibility
-- ✅ **Review dependency updates** before merging
-- ✅ **Test after updates** to catch compatibility issues
-
-### Security
-- ✅ **Pin to specific versions** in production
-- ✅ **Use SSH keys** for private repositories
-- ✅ **Review new dependencies** for security implications
-- ✅ **Monitor for vulnerabilities** in dependencies
-- ❌ **Don't embed credentials** in configuration files
-
-### Performance
-- ✅ **Cache aggressively** in CI/CD systems
-- ✅ **Use vendoring** for frequently rebuilt projects
-- ✅ **Clean old cache** periodically to save space
-- ✅ **Use shared cache** for team environments
-
-### Team Collaboration
-- ✅ **Document authentication setup** for new team members
-- ✅ **Use consistent tooling** across environments
-- ✅ **Automate dependency updates** with proper testing
-- ✅ **Share cache locations** when possible
-
-The EasyP package manager provides a robust, decentralized solution for protobuf dependency management that scales from individual projects to enterprise environments while maintaining the simplicity and reliability developers expect.
diff --git a/docs/public/docs/guide/introduction/install.md b/docs/public/docs/guide/introduction/install.md
deleted file mode 100644
index 8a4919ec..00000000
--- a/docs/public/docs/guide/introduction/install.md
+++ /dev/null
@@ -1,51 +0,0 @@
-# Install the EasyP cli
-
-### Install from system's package manager
-
-##### Recommended installation method
-
-#### Homebrew
-
-You can install a binary release on macOS using brew:
-
-```bash
-brew install easyp-tech/tap/easyp
-```
-
-`Work in progress`
-apt, yum, pacman, etc.
-
-## Local Installation
-
-#### _**Not recommended**_
-
-Local installation is not recommended because package managers provide:
-- Automatic updates and security patches
-- Better integration with system package management
-- Easier installation and removal process
-- Verified and signed binaries
-
-#### Requires Go 1.24 or later
-
-### Go install
-
-It will install the latest stable version of easyp.
-
-```bash
-go install github.com/easyp-tech/easyp/cmd/easyp@latest
-```
-
-### Build from source
-
-
-1. Clone repository
-
-```bash
-git clone https://github.com/easyp-tech/easyp.git
-```
-
-2. Build by golang
-
-```bash
-go build ./cmd/easyp
-```
diff --git a/docs/public/docs/guide/introduction/quickstart.md b/docs/public/docs/guide/introduction/quickstart.md
deleted file mode 100644
index 03cdfe49..00000000
--- a/docs/public/docs/guide/introduction/quickstart.md
+++ /dev/null
@@ -1,163 +0,0 @@
-# Quickstart
-
-EasyP is a modern toolkit for working with Protobuf files. In this quickstart, you'll learn to:
-
-1. **Initialize** your project with EasyP configuration
-2. **Set up linting** to catch errors and ensure best practices
-3. **Manage dependencies** from Git repositories
-4. **Generate code** from your Protobuf files
-
-## Prerequisites
-
-Before you begin, make sure you have:
-
-- **EasyP CLI installed** - See [Installation guide](/docs/guide/introduction/install) if you haven't already
-- **Git** installed and in your `$PATH`
-- **Protobuf files** ready to work with (or create some as you go)
-
-You can verify your installation:
-
-```bash
-easyp --version
-```
-
-## Initialize your project
-
-Start by creating an `easyp.yaml` configuration file in your project root:
-
-```bash
-easyp init
-```
-
-This command generates a commented template with default lint and breaking settings.
-`easyp init` is interactive: if `buf.yml`/`buf.yaml` exists in the target root, EasyP asks whether to migrate it; if `easyp.yaml` already exists, it asks before overwriting.
-
-## Configure linting
-
-Linting helps catch errors and ensures your Protobuf files follow best practices. EasyP provides default rules compatible with Buf standards.
-
-`easyp init` already generates a lint section. Adjust it if needed, for example:
-
-```yaml
-lint:
-  use:
-    - DEFAULT
-```
-
-Now you can run the linter:
-
-```bash
-easyp lint
-```
-
-The linter will check all your `.proto` files and report any issues found.
-
-::: tip
-EasyP's linting rules are 100% compatible with Buf, making migration easy if you're switching tools.
-:::
-
-## Manage dependencies
-
-If your project uses third-party Protobuf packages (like Google APIs or gRPC Gateway), EasyP makes it easy to manage them.
-
-### Dependency format
-
-Dependencies use a simple format: `$GIT_LINK@$VERSION`
-
-- **`$GIT_LINK`** - URL to any Git repository (GitHub, GitLab, etc.)
-- **`$VERSION`** - Git tag or commit hash (optional)
-
-If you omit the version, EasyP downloads the latest commit from the default branch.
-
-### Add dependencies
-
-Update your `easyp.yaml` to include dependencies:
-
-```yaml
-lint:
-  use:
-    - DEFAULT
-deps:
-  - github.com/googleapis/googleapis                          # Latest commit
-  - github.com/grpc-ecosystem/grpc-gateway@v2.20.0           # Specific version
-```
-
-### Download dependencies
-
-Download the packages you specified:
-
-```bash
-easyp mod download
-```
-
-This command:
-- Downloads dependencies from `easyp.lock` if it exists
-- Otherwise, downloads from `easyp.yaml` and creates `easyp.lock`
-
-::: info
-**Tip:** Use `easyp mod update` to ignore the lock file and fetch the latest versions from `easyp.yaml`.
-:::
-
-## Generate code
-
-Now let's configure code generation. EasyP supports all standard Protobuf plugins.
-
-### Configure generation
-
-Add plugin configuration to your `easyp.yaml`:
-
-```yaml
-lint:
-  use:
-    - DEFAULT
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/grpc-ecosystem/grpc-gateway@v2.20.0
-generate:
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-```
-
-### Run code generation
-
-Generate your code stubs:
-
-```bash
-easyp generate
-```
-
-EasyP will:
-1. Resolve all dependencies
-2. Connect to the EasyP service (or run locally)
-3. Execute the configured plugins
-4. Output generated code to the specified directories
-
-::: tip
-EasyP uses a hybrid runtime with WASM for speed and Docker for heavy plugins, giving you the best of both worlds.
-:::
-
-## Next steps
-
-Congratulations! 🎉 You've successfully:
-- ✅ Initialized an EasyP project
-- ✅ Configured linting rules
-- ✅ Managed third-party dependencies
-- ✅ Generated code from your Protobuf files
-
-### Learn more
-
-- **[CLI Reference](/docs/guide/cli/linter/linter)** - Deep dive into all CLI commands
-- **[API Service](/docs/guide/api-service/overview)** - Set up remote code generation
-- **[Configuration](/docs)** - Explore all configuration options
-
----
-
-*Enjoy working with Protobuf without any pain! 🚀*
diff --git a/docs/public/docs/guide/introduction/what-is.md b/docs/public/docs/guide/introduction/what-is.md
deleted file mode 100644
index 1bbd29dd..00000000
--- a/docs/public/docs/guide/introduction/what-is.md
+++ /dev/null
@@ -1,159 +0,0 @@
-# What is EasyP?
-
-EasyP is a modern Protocol Buffers toolkit that consolidates your entire protobuf workflow into a single, powerful CLI tool. It combines linting, package management, code generation, and compatibility checking in a unified interface designed to eliminate the complexity of traditional protobuf development.
-
-<div class="tip custom-block" style="padding-top: 8px">
-
-Just want to try it out? Skip to the [Quickstart](./guide/introduction/quickstart).
-
-</div>
-
-## The Problem: Fragmented Proto Workflows
-
-Working with Protocol Buffers across projects creates unnecessary complexity and friction:
-
-### Tool Chaos
-- **Multiple tools for different tasks**: Separate tools for linting, generation, and dependency management
-- **Inconsistent configurations**: Different config formats across projects and teams
-- **Complex setup**: Time-consuming onboarding for new developers joining projects
-
-### Dependency Management Issues  
-- **No standardized approach**: Each project handles proto dependencies differently
-- **Version conflicts**: Difficult to resolve conflicts between different proto libraries
-- **Build reproducibility**: Hard to ensure consistent builds across environments
-
-### Development Friction
-- **Manual processes**: Repetitive workflows for common proto tasks
-- **Configuration sprawl**: Multiple config files with different formats
-- **Time-consuming compatibility checks**: Manual verification of API changes
-
-## The Solution: Unified Proto Toolkit
-
-EasyP addresses these challenges by providing a comprehensive, opinionated toolkit that standardizes protobuf workflows:
-
-### One Tool, All Tasks
-Instead of juggling multiple tools, EasyP provides everything you need:
-- **Linting** with comprehensive rule sets
-- **Package management** with Git-native dependencies
-- **Code generation** with local and remote plugin support
-- **Breaking change detection** for API compatibility
-
-### Standardized Configuration
-A single `easyp.yaml` file configures your entire protobuf workflow, eliminating configuration sprawl and ensuring consistency across projects.
-
-### Git-Native Dependencies
-Direct integration with Git repositories for proto dependencies eliminates the need for centralized registries while providing version control and reproducibility.
-
-## Key Features
-
-| Feature | Description |
-|---------|-------------|
-| 🔍 **Comprehensive Linting** | Built-in support for buf's linting rules with customizable configurations to enforce API design best practices. |
-| 📦 **Smart Package Manager** | Git-based dependency management with lock file support for reproducible builds across environments. |
-| ⚡ **Code Generation** | Multi-language code generation with support for both local protoc plugins and remote plugin execution. |
-| 🔄 **Breaking Change Detection** | Automated API compatibility verification against Git branches to prevent accidental breaking changes. |
-| 🌐 **Remote Plugin Support** | Execute plugins via centralized EasyP API service for consistent, isolated execution without local dependencies. |
-| 🎯 **Developer Experience** | Auto-completion, intuitive commands, clear error messages, and comprehensive documentation. |
-
-## Supported Plugin Types
-
-EasyP provides flexibility in how you execute code generation plugins:
-
-### Local Plugins
-Standard protoc plugins installed on your system:
-```yaml
-plugins:
-  - name: go
-    out: .
-    opts:
-      paths: source_relative
-```
-
-### Remote Plugins
-Plugins executed via EasyP API service for consistent results:
-```yaml
-plugins:
-  - remote: api.easyp.tech/protoc-gen-typescript:latest
-    out: ./web/generated
-```
-
-### Custom Plugins
-Support for custom plugin development and distribution through the ecosystem.
-
-## Decentralized Package Management
-
-Unlike other tools, EasyP doesn't rely on a centralized server for package distribution. Instead, any Git repository can serve as a package source, giving you:
-
-- **Flexibility and Control**: Use any Git hosting service (GitHub, GitLab, self-hosted)
-- **No Vendor Lock-in**: Your dependencies aren't tied to a specific registry
-- **Version Control**: Full Git history and branching for your proto dependencies
-- **Enterprise-Friendly**: Works with private repositories and corporate Git infrastructure
-
-## Seamless Migration from Buf
-
-EasyP is designed with buf compatibility in mind:
-
-- **Compatible rule sets**: Uses the same linting rules as buf
-- **Familiar configuration**: Similar YAML structure with enhanced features
-- **Drop-in replacement**: Can often replace buf with minimal configuration changes
-- **Gradual migration**: Adopt EasyP features incrementally without disrupting existing workflows
-
-### EasyP vs buf.build Comparison
-
-| Feature | EasyP | buf.build |
-|---------|--------|-----------|
-| **Dependency Management** | Git-based repositories | Buf Schema Registry (BSR) |
-| **Vendor Lock-in** | None - works with any Git hosting | Tied to BSR for full features |
-| **Plugin Execution** | Local + Remote plugins | Local + BSR plugins |
-| **Private Dependencies** | Any Git provider (GitHub, GitLab, etc.) | BSR or manual management |
-| **Offline Development** | Full support with `mod vendor` | Limited without BSR access |
-| **Enterprise Integration** | Works with existing Git infrastructure | Requires BSR setup |
-| **Breaking Change Detection** | Against any Git reference | Against any Git reference |
-| **Package Distribution** | Any Git repository | BSR required for publishing |
-| **License** | Apache 2.0 | Apache 2.0 |
-| **Community** | Growing | Established |
-
-**Migration Benefits:**
-- **No infrastructure changes**: Continue using your existing Git repositories
-- **Gradual adoption**: Start with EasyP while keeping existing buf configurations
-- **Enhanced flexibility**: Access to both local and remote plugin execution
-- **Simplified workflows**: Single configuration file for all protobuf operations
-
-## Our Goals for Protobuf
-
-EasyP's mission is to accelerate the adoption of **schema-driven API development** by making Protocol Buffers more accessible and reliable:
-
-### Modern Protobuf Ecosystem
-We're building on Protobuf's proven foundation to create a modern development experience that rivals the simplicity of REST/JSON while providing superior type safety and performance.
-
-### Developer Experience First
-Every feature is designed with developer productivity in mind, from intuitive CLI commands to comprehensive error messages and documentation.
-
-### Enterprise Ready
-Built for teams and organizations with features like reproducible builds, private repository support, and comprehensive CI/CD integration.
-
-## Why Choose EasyP?
-
-### For Individual Developers
-- **Quick Setup**: Get started with protobuf projects in minutes, not hours
-- **Unified Workflow**: One tool for all your protobuf needs
-- **Clear Documentation**: Comprehensive guides and examples
-
-### For Teams
-- **Consistent Standards**: Enforced linting rules and formatting across all projects
-- **Reproducible Builds**: Lock files ensure everyone builds the same way
-- **Easy Onboarding**: New team members can be productive immediately
-
-### For Organizations
-- **No Vendor Lock-in**: Git-based dependencies work with your existing infrastructure
-- **Enterprise Security**: Support for private repositories and custom authentication
-- **CI/CD Ready**: Designed for automated workflows and continuous integration
-
-## What's Next?
-
-EasyP simplifies protobuf development so you can focus on building great APIs instead of managing toolchain complexity. Whether you're starting a new project or migrating from existing tools, EasyP provides a smooth path to modern protobuf development.
-
-Ready to get started? Check out our [Installation Guide](/docs/guide/introduction/install) and [Quickstart Tutorial](/docs/guide/introduction/quickstart).
-
-## Stargazers over time
-[![Stargazers over time](https://starchart.cc/easyp-tech/easyp.svg?variant=adaptive)](https://starchart.cc/easyp-tech/easyp)
diff --git a/docs/public/docs/guide/migration/buf-cli.md b/docs/public/docs/guide/migration/buf-cli.md
deleted file mode 100644
index 1061787f..00000000
--- a/docs/public/docs/guide/migration/buf-cli.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Buf CLI
-
-## Work in progress
\ No newline at end of file
diff --git a/docs/public/docs/guide/migration/protoc.md b/docs/public/docs/guide/migration/protoc.md
deleted file mode 100644
index b2adda0d..00000000
--- a/docs/public/docs/guide/migration/protoc.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Protoc
-
-## Work in progress
\ No newline at end of file
diff --git a/docs/public/docs/guide/migration/protolock.md b/docs/public/docs/guide/migration/protolock.md
deleted file mode 100644
index f82aa550..00000000
--- a/docs/public/docs/guide/migration/protolock.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Protolock
-
-## Work in progress
\ No newline at end of file
diff --git a/docs/public/docs/guide/migration/prototool.md b/docs/public/docs/guide/migration/prototool.md
deleted file mode 100644
index 40967d2a..00000000
--- a/docs/public/docs/guide/migration/prototool.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Prototool
-
-## Work in progress
\ No newline at end of file
diff --git a/docs/public/docs/ru-blog/finally-give-up-gin-echo.md b/docs/public/docs/ru-blog/finally-give-up-gin-echo.md
deleted file mode 100644
index c0ce3246..00000000
--- a/docs/public/docs/ru-blog/finally-give-up-gin-echo.md
+++ /dev/null
@@ -1,278 +0,0 @@
-# Откажитесь уже наконец от gin, echo и <иной ваш фреймворк>
-
-## Введение: Пересмотр Традиций в Мире Go
-В мире разработки на Go выбор фреймворка часто превращается в лояльность, сопоставимую с выбором между Apple и Android. Фреймворки вроде Gin, Echo и Beego долгие годы были верными спутниками программистов, помогая быстро развертывать проекты и достигать первых успехов. Они предлагали удобные инструменты и привычные шаблоны работы, но со временем становится очевидным, что у каждого свой «язык». Это создаёт трудности при переходе между ними или интеграции с другими системами.
-
-Ситуация усугубляется, если проекты разрастаются, а масштабируемость и поддержка становятся критически важными. Здесь каждый несовместимый компонент или разнообразие подходов превращается в препятствие, требующее дополнительных ресурсов и времени. Как если бы вы каждый раз, переходя с одного фреймворка на другой, переезжали в новый дом, где даже привычный световой выключатель находится не там, куда рука тянется автоматически.
-
-### Для тех, кто хочет углубиться в историю и особенности каждого фреймворка, предлагаю ознакомиться с подробными обзорами и сравнениями:
-
-- [Beego: An Overview and Comparison with Other Frameworks](https://medium.com/@eric.a.nugroho/beego-an-overview-and-comparison-with-other-framework-5211b08124ea)
-- [Building Microservice Using Golang Echo Framework](https://medium.com/cuddle-ai/building-microservice-using-golang-echo-framework-ff10ba06d508)
-- [Go with Gin](https://maneeshaindrachapa.medium.com/go-with-gin-83865cd5cd81)
-
-В этой статье мы рассмотрим, почему пришло время отказаться от привычной многообразности в пользу стандартизации и как gRPC-Gateway может стать «универсальным переводчиком», способным объединить разрозненные диалекты Go-фреймворков в единый, понятный всем язык взаимодействия микросервисов.
-
-## Стандартизация, стандартизация и еще раз стандартизация
-
-Когда речь заходит о создании серверов на Go, каждый фреймворк предлагает свой набор правил и инструментов. Изначально это кажется большим плюсом: вы можете выбрать именно то, что подходит под ваши конкретные нужды и стиль работы. Однако, представьте себе сложность, когда в одном проекте необходимо совместить модули, написанные с использованием разных фреймворков. Это сравнимо с попыткой собрать пазл, где каждая часть произведена разными производителями и не сочетается с остальными.
-
-Примеры Gin, Echo и, не дай Бог, Beego часто всплывают в беседах разработчиков. Они, без сомнения, оказали огромное влияние на сообщество Go и поддерживали многие проекты на разных этапах их жизненного цикла. Особенно Gin, который уже более 10 лет является надёжным инструментом для многих. Но современные реалии разработки требуют гибкости и возможности масштабирования, а привязка к одному фреймворку может серьёзно ограничить обе эти характеристики.
-
-Так, к примеру, если ваш проект начался с использования Echo, и вы хотите интегрировать стороннюю библиотеку, написанную для Gin, вы столкнетесь с необходимостью переписывания кода или создания «мостов» между различиями в API. Это не только увеличивает рабочий объём, но и вносит дополнительную сложность в поддержку и обновление кода.
-
-Стандартизация — это ключ к решению этих проблем. Переход к использованию gRPC и HTTP/2, а также адаптация таких инструментов, как gRPC-Gateway, открывает новые горизонты в вопросах совместимости и универсальной коммуникации. Подумайте о gRPC-Gateway как об универсальном переводчике, который позволяет вам говорить на одном языке с разными системами, не вдаваясь в особенности каждой из них.
-
-## Знакомство с gRPC-Gateway
-
-gRPC-Gateway — это магический мост, соединяющий старый мир RESTful JSON API и современный мир gRPC. Он позволяет вашим сервисам говорить на двух языках, обслуживая и традиционные HTTP запросы, и мощные gRPC вызовы. Это особенно удобно, когда у вас есть разнообразные клиенты: некоторые из них предпочитают общаться через простые HTTP запросы, в то время как другие — через gRPC.
-
-Давайте рассмотрим жизненный пример: вы управляете веб-сервисом, который предоставляет информацию о погоде. Ваши данные — это не просто текст, это объёмные наборы данных с метеостанций. Здесь gRPC идеально подходит для пересылки этих данных с высокой скоростью и надежностью. Но ваши клиенты — это не только другие сервера, но и мобильные приложения и веб-браузеры, которые ожидают удобные и понятные JSON ответы.
-
-Вот как gRPC-Gateway вступает в игру: он трансформирует HTTP запросы в gRPC вызовы и обратно, делая ваш сервис доступным для всех, без необходимости поддержки двух разных API. Всё это происходит за кулисами, и для конечного пользователя это выглядит как обычная работа с веб-сайтом или приложением.
-
-Пример кода, который вы могли бы видеть без gRPC-Gateway, выглядит примерно так:
-
-```proto
-syntax = "proto3";
-
-package your.service.v1;
-
-option go_package = "github.com/yourorg/yourprotos/gen/go/your/service/v1";
-
-message StringMessage {
-  string value = 1;
-}
-
-service YourService {
-  rpc Echo(StringMessage) returns (StringMessage) {}
-}
-```
-
-А теперь добавим немного "магии" gRPC-Gateway:
-
-```proto
-syntax = "proto3";
-package your.service.v1;
-option go_package = "github.com/yourorg/yourprotos/gen/go/your/service/v1";
-import "google/api/annotations.proto";
-
-message StringMessage {
-  string value = 1;
-}
-
-service YourService {
-  rpc Echo(StringMessage) returns (StringMessage) {
-      option (google.api.http) = {
-      post: "/v1/example/echo"
-      body: "*"
-    };
-  }
-}
-```
-
-Эти несколько строк позволяют вам автоматически принимать HTTP POST запросы на адрес `/v1/example/echo` и обрабатывать их как вызовы gRPC. Это пример того, как gRPC-Gateway упрощает жизнь разработчикам, предоставляя единый, универсально понятный API.
-
-## Сочетание GRPC и HTTP серверов
-
-Возможность одновременного использования gRPC и HTTP в одном приложении – это как иметь в своем распоряжении и спортивный автомобиль, и внедорожник; вы можете наслаждаться скоростью и мощью, когда это необходимо, и надежностью и универсальностью в другой раз. gRPC-Gateway позволяет вашему сервису легко переключаться между этими двумя "транспортами", предоставляя такую гибкость.
-
-Давайте рассмотрим обычный рабочий процесс:
-
-- *HTTP запрос*: Клиент отправляет HTTP запрос, который достигает gRPC-Gateway.
-- *Преобразование в gRPC*: Gateway анализирует запрос, преобразует его в соответствующий gRPC вызов и перенаправляет его на gRPC сервер.
-- *Обработка gRPC сервером*: gRPC сервер обрабатывает запрос и отправляет ответ обратно в Gateway.
-- *Преобразование в HTTP*: Gateway переводит gRPC ответ обратно в формат, понятный HTTP клиенту, и отправляет его обратно.
-
-Этот процесс можно представить в виде диаграммы:
-
-```mermaid
-sequenceDiagram
-    participant WebClient as Web Client
-    participant GRPCGateway as HTTP Server (gRPC-Gateway)
-    participant GRPCServer as gRPC Server
-
-    WebClient->>GRPCGateway: HTTP Request
-    GRPCGateway->>GRPCServer: gRPC Request
-    GRPCServer->>GRPCGateway: gRPC Response
-    GRPCGateway->>WebClient: HTTP Response
-```
-
-В реальной жизни это выглядит следующим образом: когда пользователь запрашивает информацию через веб-интерфейс, его запрос идет через gRPC-Gateway, который транслирует его в gRPC вызов. Затем, получив ответ от gRPC сервиса, Gateway «переводит» его обратно в HTTP ответ и отправляет пользователю, обеспечивая плавный и незаметный процесс взаимодействия.
-
-А на уровне кода, это может выглядеть так:
-```go
-package main
-
-import (
-	"context"
-	"log"
-	"net"
-	"net/http"
-
-	"github.com/grpc-ecosystem/grpc-gateway/v2/runtime"
-	"golang.org/x/sync/errgroup"
-	"google.golang.org/grpc"
-	"google.golang.org/grpc/credentials/insecure"
-
-	echo "path/to/your/protobuf_package" 
-)
-
-const (
-	grpcServerEndpoint = "localhost:50051"
-	httpServerEndpoint = "localhost:8080"
-)
-
-type EchoService struct {
-	echo.UnimplementedEchoServiceServer
-}
-
-func (s *EchoService) Echo(ctx context.Context, in *echo.EchoRequest) (*echo.EchoResponse, error) {
-	return &echo.EchoResponse{Message: "Echo: " + in.Message}, nil
-}
-
-func main() {
-	g, ctx := errgroup.WithContext(context.Background())
-
-	g.Go(func() error {
-		return startGRPCServer(ctx)
-	})
-
-	g.Go(func() error {
-		return startHTTPServer(ctx)
-	})
-
-	if err := g.Wait(); err != nil {
-		log.Fatalf("Не удалось запустить серверы: %s", err)
-	}
-}
-
-func startGRPCServer(ctx context.Context) (err error) {
-	lis, err := net.Listen("tcp", grpcServerEndpoint)
-	if err != nil {
-		return err
-	}
-
-	s := grpc.NewServer()
-	echo.RegisterEchoServiceServer(s, &EchoService{})
-
-	go func() {
-		<-ctx.Done()
-		s.GracefulStop()
-	}()
-
-	log.Printf("Запуск gRPC сервера на %s", grpcServerEndpoint)
-	return s.Serve(lis)
-}
-
-func startHTTPServer(ctx context.Context) (err error) {
-	mux := runtime.NewServeMux()
-	opts := []grpc.DialOption{grpc.WithTransportCredentials(insecure.NewCredentials())}
-	err = echo.RegisterEchoServiceHandlerFromEndpoint(ctx, mux, grpcServerEndpoint, opts)
-	if err != nil {
-		return err
-	}
-
-	srv := &http.Server{
-		Addr:    httpServerEndpoint,
-		Handler: mux,
-	}
-
-	go func() {
-		<-ctx.Done()
-		srv.Shutdown(ctx)
-	}()
-
-	log.Printf("Запуск HTTP сервера на %s", httpServerEndpoint)
-	return srv.ListenAndServe()
-}
-```
-
-Этот простой пример показывает, как в рамках одного приложения можно обеспечить работу и gRPC, и HTTP серверов, давая пользователям свободу выбора и обеспечивая разработчикам удобные инструменты для управления API.
-
-## Преимущества использования gRPC-Gateway
-
-gRPC-Gateway не просто облегчает разработку — он раскрывает новые возможности для систем, где требуется совместимость и гибкость. Это особенно важно в современных микросервисных архитектурах, где системы должны взаимодействовать друг с другом беспрепятственно и эффективно.
-
-## Единая точка истины: одна схема для GRPC и RESTful API
-
-Используя один .proto файл для описания как gRPC, так и RESTful API, мы получаем единство и согласованность интерфейсов. Это избавляет от необходимости поддерживать разные версии API для разных протоколов, что упрощает обновления и снижает шансы на ошибки. Если вы вносите изменения в .proto файл, они автоматически отражаются и в RESTful API, и в gRPC.
-
-## Сокращение дублирования кода и упрощение поддержки
-
-Поскольку gRPC-Gateway транслирует запросы REST в вызовы gRPC, разработчикам не нужно писать отдельные реализации для каждого протокола. Это освобождает усилия и время на создание дополнительных фич, а не на дублирование существующей функциональности.
-
-## Автоматическая генерация клиентского кода и документации OpenAPI (Swagger)
-
-gRPC-Gateway позволяет автоматически генерировать клиентские библиотеки для различных языков программирования и документацию API в формате OpenAPI (Swagger). Это не только ускоряет процесс разработки клиентских частей системы, но и обеспечивает актуальность документации, делая взаимодействие с API прозрачным и понятным для всех сторон.
-
-```mermaid
-sequenceDiagram
-    participant Developer as Developer
-    participant ProtoFile as .proto file
-    participant CodeGen as Code Generator
-    participant ClientLib as Client Library
-    participant APIDocs as API Documentation
-
-    Developer->>ProtoFile: Defines API
-    ProtoFile->>CodeGen: Transfers API structure
-    CodeGen->>ClientLib: Generates code
-    CodeGen->>APIDocs: Generates documentation
-    APIDocs-->>Developer: Uses for integration
-    ClientLib-->>Developer: Uses for client development
-```
-
-Пример преимущества может выглядеть так: представьте, что ваша команда внедряет новую функцию в систему. Ранее это требовало бы обновления нескольких документов API и реализаций на разных языках. Теперь же, изменения вносятся в один .proto файл, и все необходимые обновления генерируются автоматически.
-
-Эти преимущества делают gRPC-Gateway мощным инструментом, который может значительно упростить процесс разработки и поддержки микросервисных архитектур, делая их более модульными, гибкими и лёгкими в масштабировании.
-
-## Недостатки и ограничения gRPC-Gateway
-
-Несмотря на значительные преимущества, gRPC-Gateway не лишен недостатков, особенно когда речь заходит о сложных случаях использования и интеграции с существующими системами. Рассмотрим некоторые из этих ограничений:
-
-## Ограниченная настройка и кастомизация
-
-gRPC-Gateway прекрасно работает «из коробки» для многих стандартных сценариев, но его возможности кастомизации могут быть недостаточными для уникальных требований. Например, сложные требования к маршрутизации, тонкая настройка безопасности или специфичная обработка запросов могут потребовать дополнительных усилий и иногда написания дополнительного слоя проксирования.
-
-```mermaid
-graph TD
-    A[Client Request] --> B[gRPC-Gateway]
-    B --> C{Route Check}
-    C -->|Route OK| D[gRPC Service]
-    C -->|Customization Required| E[Additional Proxy Layer]
-    E --> D
-    D --> F{gRPC Service Response}
-    F -->|Convert to HTTP| B
-```
-
-## Более высокий порог входа для новичков
-
-Для эффективного использования gRPC-Gateway, разработчикам необходимо изучить не только основы REST и HTTP, но и особенности работы с gRPC и protobuf. Это может создать дополнительные трудности для новичков или команд, привыкших к более традиционным REST API.
-
-## Взаимодействие с другими инструментами и библиотеками
-
-Интеграция с некоторыми инструментами мониторинга, логирования или трассировки может быть затруднена, так как gRPC-Gateway представляет собой ещё один уровень абстракции. Поэтому может потребоваться дополнительная настройка или поиск специализированных решений, которые совместимы с gRPC.
-
-## Недостаточный контроль над HTTP-специфичными функциями
-
-Некоторые HTTP-специфичные возможности, такие как управление кэшированием, куками, редиректами, могут быть не так легко реализуемы через gRPC-Gateway. Это может потребовать дополнительных обходных решений или разработки дополнительного кода для контроля над этими аспектами на уровне HTTP.
-
-## Проблемы с передачей файлов
-
-Передача файлов может быть проблематичной при использовании gRPC-Gateway. Из-за особенностей gRPC, большие файлы придется разбивать на множество маленьких частей для передачи, что может быть неэффективным и сложным в реализации. В некоторых случаях, может потребоваться более традиционный подход к обработке и передаче файлов.
-
-## Влияние на производительность
-
-Хотя gRPC-Gateway относительно эффективен, введение дополнительного прокси-слоя может немного увеличить задержку обработки запросов. В системах, где каждая миллисекунда имеет значение, это может стать критичным фактором.
-
-## Заключение
-
-Итак, мы разобрались, что gRPC-Gateway — это не просто ещё одна техническая штучка. Это как мостик между двумя мирами: уютным островом REST и стремительным континентом gRPC. И этот мостик может привести нас к чему-то удивительному — к API, которые проще в поддержке, быстрее в работе и дружелюбнее к разработчикам.
-
-## Немного Размышлений
-
-Мир технологий не стоит на месте, и мы тоже. Сегодня выбор в пользу gRPC-Gateway может показаться нововведением, но завтра он уже станет частью «старой доброй классики». Так что, если вы чувствуете, что пора расширять горизонты и исследовать новые технологии, возможно, gRPC-Gateway — это именно то, что нужно.
-
-## Вот и Всё... Пока!
-
-Не бойтесь экспериментировать и пробовать новые решения. Возможно, gRPC-Gateway не станет панацеей для всех ваших болей, но он определённо может стать одним из тех инструментов, который вы будете вспоминать с благодарностью. А что будет завтра? Кто знает, может, мы уже встретимся на новом повороте технологической эволюции!
diff --git a/docs/public/docs/ru-blog/working-with-proto-errors-correctly.md b/docs/public/docs/ru-blog/working-with-proto-errors-correctly.md
deleted file mode 100644
index 58ff3596..00000000
--- a/docs/public/docs/ru-blog/working-with-proto-errors-correctly.md
+++ /dev/null
@@ -1,220 +0,0 @@
-# Давайте работать с proto ошибками правильно :)
-
-## Protobuf Error Handling
-
-В программировании всегда есть несколько способов решения одной и той же проблемы. Но не все они одинаково эффективны. Сегодня поговорим о способах обработки ошибок в gRPC — удачных и не очень.
-
-```proto
-message Result {
-  oneof response {
-    error.v1.Error error = 1;
-    info.v1.Info info = 2;
-  }
-}
-```
-
-На первый взгляд может показаться, что использование oneof для представления либо ошибки, либо результата — это удобно. Однако такой подход вносит ненужную сложность в протокол обмена сообщениями и ухудшает читаемость кода. gRPC предоставляет встроенные средства для работы с ошибками, которые позволяют элегантно и эффективно передавать информацию об ошибках.
-
-Почему же использование `oneof` для ошибок — плохая идея? Во-первых, это затрудняет использование стандартного механизма ошибок gRPC и кодов состояний, которые предназначены для этой цели. Во-вторых, это может привести к путанице на стороне клиента при необходимости различать успешные ответы от ошибок.
-
-```mermaid
-sequenceDiagram
-    participant Client as Client
-    participant Service as Service
-    Client->>Service: Query
-    alt Success
-      Service-->>Client: Info
-    else Error
-      Service-->>Client: Error
-    end
-```
-На схеме видно, как обработка двух типов запроса утяжеляет логику клиента
-
-## Коды ошибок в gRPC
-
-Коды ошибок в архитектуре gRPC особенно важны для эффективного взаимодействия между клиентом и сервером. Они помогают клиенту понять причину проблемы и правильно отреагировать на нее.
-
-Правильное и эффективное управление ошибками в gRPC играет ключевую роль в создании надежных и поддерживаемых систем. Использование стандартных кодов ошибок и механизмов gRPC позволяет не только упростить обработку ошибок на стороне клиента, но и обеспечить ясность и предсказуемость поведения системы. Вместо того чтобы использовать конструкции вроде oneof для обработки ошибок, лучше воспользоваться встроенными возможностями gRPC для передачи детализированной информации об ошибках.
-
-Вот, как можно использовать gRPC-код codes.NotFound, чтобы сообщить об отсутствии чего-либо
-
-
-```go
-import "google.golang.org/grpc/status"
-import "google.golang.org/grpc/codes"
-
-// ...
-
-err := status.Error(codes.NotFound, "не нашел котика")
-
-// ...
-```
-
-Такой подход упрощает обработку ошибок на стороне клиента, а это облегчает понимание структуры данных ответа. Кроме того, ошибки, возвращаемые через status.Error преобразуются в HTTP-статусы при транспортировке через gRPC-Gateway, в таком случае ошибки становятся понятными и вне gRPC
-
-Но, что делать, если нам нужно больше гибкости в ответе ошибки? К примеру добавить дополнительную мета-инфу или же кастомные коды ошибок?
-
-В самой системе gRPC есть возможность прикрепить доп. данные к ошибке — и таким способом расширить контекст проблемы
-
-```go
-import (
-  "google.golang.org/grpc/status"
-  "google.golang.org/grpc/codes"
-  "google.golang.org/genproto/googleapis/rpc/errdetails"
-)
-
-// ...
-
-st := status.New(codes.InvalidArgument, "invalid parameter")
-// Общая форма ошибки
-errInfo := &errdetails.ErrorInfo{
-	Reason: "Не хватает средств на счету",
-	Domain: "finance",
-	Metadata: map[string]string{
-		"my_meta_info": "my_meta_details",
-	},
-}
-
-st, err := st.WithDetails(errInfo)
-if err != nil {
-	return fmt.Sprintf("st.WithDetails: %w", err)
-}
-
-return st.Err()
-```
-
-Но, в случаях, когда хочется получать более детализированные ошибки — например, с уточнением проблемного поля. В таком случае можно воспользоваться типом BadRequest и прописать больше деталей об ошибке.
-
-## Определение и использование кастомной ошибки
-
-Но! Что делать, если стандартные варианты details не подходят? Мы можем сделать свои собственные типы ошибок! :)
-
-Сначала определим кастомную ошибку в proto файле. Нам нужно создать message ошибки CustomErrorDetail. В ней будет содержаться информация об ошибках, связанных с пользовательскими данными:
-
-```proto
-syntax = "proto3";
-
-package myerrors;
-
-message CustomErrorDetail {
-  string reason = 1;
-  string field = 2;
-  string help = 3;
-}
-```
-
-Теперь, когда у нас есть определение кастомной ошибки, мы можем использовать её, чтобы передавать более специфичную и детализированную информацию об ошибках. Это особенно полезно, когда требуется указать на конкретные поля или параметры, вызвавшие ошибку. Создание и использование такогоCustomErrorDetailв коде сервера позволяет не только сообщать о проблемах, но и предоставлять клиенту рекомендации по их исправлению, что делает взаимодействие более прозрачным и эффективным.
-
-```go
-import (
-  "google.golang.org/grpc/status"
-  "google.golang.org/grpc/codes"
-  "google.golang.org/protobuf/types/known/anypb"
-  "myerrors"
-)
-
-// ...
-
-customErrorDetail := &myerrors.CustomErrorDetail{
-    Reason: "Value out of range",
-    Field: "age",
-    Help: "The age must be between 0 and 120",
-}
-
-st := status.New(codes.InvalidArgument, "invalid parameter")
-st, err = st.WithDetails(customErrorDetail)
-if err != nil {
-    return fmt.Sprintf("Unexpected error attaching custom error detail: %w", err)
-}
-
-return st.Err()
-```
-
-## Работа с клиентской стороны
-Теперь давайте рассмотрим, как клиентская сторона будет взаимодействовать с системой обработки ошибок в gRPC, которую мы описали ранее.
-
-### Обработка стандартных ошибок
-Когда клиент получает ответ от gRPC сервера, он может проверять наличие ошибок с помощью стандартных механизмов gRPC, например:
-
-```go
-import (
-  "context"
-  "google.golang.org/grpc"
-  "google.golang.org/grpc/codes"
-  "google.golang.org/grpc/status"
-  "log"
-)н
-
-func main() {
-  conn, err := grpc.Dial("localhost:50051", grpc.WithInsecure())
-  if err != nil {
-    log.Fatalf("did not connect: %v", err)
-  }
-  defer conn.Close()
-
-  client := NewYourServiceClient(conn)
-  response, err := client.YourMethod(context.Background(), &YourRequest{})
-  if err != nil {
-    st, ok := status.FromError(err)
-    if ok {
-      switch st.Code() {
-      case codes.InvalidArgument:
-        log.Println("Invalid argument error:", st.Message())
-      case codes.NotFound:
-        log.Println("Not found error:", st.Message())
-      // Обработайте другие коды ошибок по необходимости
-      default:
-        log.Println("Unexpected error:", st.Message())
-      }
-    } else {
-      log.Fatalf("failed to call YourMethod: %v", err)
-    }
-  } else {
-    log.Println("Response:", response)
-  }
-}
-```
-
-### Извлечение дополнительных деталей ошибок
-
-А теперь самое интересное: чтобы клиентская сторона могла извлечь details для анализа, нам нужно эти самые details обработать.
-
-Вот, как это можно сделать:
-```go
-import (
-  "google.golang.org/grpc/status"
-  "google.golang.org/genproto/googleapis/rpc/errdetails"
-  "myerrors"
-  "log"
-)
-
-// ...
-
-func handleError(err error) {
-  st, ok := status.FromError(err)
-  if !ok {
-    log.Fatalf("An unexpected error occurred: %v", err)
-  }
-
-  for _, detail := range st.Details() {
-    switch t := detail.(type) {
-    case *errdetails.BadRequest:
-      // Обработка деталей неверного запроса
-      for _, violation := range t.GetFieldViolations() {
-        log.Printf("The field %s was wrong: %s\\\\n", violation.GetField(), violation.GetDescription())
-      }
-    case *myerrors.CustomErrorDetail:
-      // Обработка кастомных деталей ошибок
-      log.Printf("Custom error detail: Reason: %s, Field: %s, Help: %s\\\\n", t.Reason, t.Field, t.Help)
-    // Добавьте обработку других типов ошибок по необходимости
-    default:
-      log.Printf("Received an unknown error detail type: %v\\\\n", t)
-    }
-  }
-}
-```
-
-### Заключение
-Мы рассмотрели, как использовать стандартные коды ошибок gRPC, как добавлять дополнительные данные к ошибкам и как создавать и обрабатывать кастомные ошибки. Эти подходы позволяют более гибко и детализированно подходить к обработке ошибок, что особенно важно для сложных систем, где простое сообщение об ошибке может быть недостаточным.
-
-При проектировании API важно помнить, что клиентская сторона должна иметь возможность легко и однозначно интерпретировать ответы сервера. Использование стандартных механизмов gRPC для ошибок помогает достичь этой цели, улучшая взаимодействие между клиентом и сервером и делая систему в целом более устойчивой и понятной.
diff --git a/docs/public/docs/ru-guide/TRANSLATION_STATUS.md b/docs/public/docs/ru-guide/TRANSLATION_STATUS.md
deleted file mode 100644
index 5269f99a..00000000
--- a/docs/public/docs/ru-guide/TRANSLATION_STATUS.md
+++ /dev/null
@@ -1,150 +0,0 @@
-# Translation Status (ru-guide)
-
-Этот файл отслеживает прогресс перевода русской документации.  
-Используемые статусы:
-- TODO — требуется перевод
-- IN_PROGRESS — перевод начат, требуется вычитка
-- DONE — перевод завершён и вычитан
-- SKIPPED — не требует перевода (намеренно оставлено на английском)
-
-Правила:
-1. После полного перевода файла убрать исходный английский текст и маркер <!-- TODO -->
-2. Термины протокола и ключевые идентификаторы (названия правил, CLI команды, YAML ключи) НЕ переводим.
-3. Если структура исходного файла изменилась — добавить в начало: `<!-- SOURCE_UPDATED: <commit or date> -->`
-4. Для больших изменений: сначала IN_PROGRESS, после вычитки менять на DONE.
-
-## Summary
-
-Итого файлов: 76  
-DONE: 76  
-IN_PROGRESS: 0  
-TODO: 0
-
-## Priority Order (рекомендованный)
-
-1. introduction/what-is.md
-2. introduction/quickstart.md
-3. introduction/install.md
-4. cli/linter/linter.md
-5. cli/generator/generator.md
-6. cli/package-manager/package-manager.md
-7. cli/breaking-changes/breaking-changes.md
-8. api-service/overview.md
-9. migration/* (пакетом)
-
----
-
-## File Status Table
-
-| File | Status | Notes |
-|------|--------|-------|
-| introduction/what-is.md | DONE | Полный перевод выполнен |
-| introduction/quickstart.md | DONE | Структура сохранена, перевод вычитан |
-| introduction/install.md | DONE | Переведено, команды проверены |
-| api-service/overview.md | DONE | Переведено |
-| ci-cd/github-actions.md | DONE | Переведено |
-| ci-cd/gitlab.md | DONE | Переведено |
-| cli/auto-completion/auto-completion.md | DONE | Переведено |
-| cli/breaking-changes/breaking-changes.md | DONE | Переведено и вычитано |
-| cli/breaking-changes/rules/enum-no-delete.md | DONE | Переведено |
-| cli/breaking-changes/rules/enum-value-no-delete.md | DONE | Переведено |
-| cli/breaking-changes/rules/enum-value-same-name.md | DONE | Переведено |
-| cli/breaking-changes/rules/field-no-delete.md | DONE | Переведено |
-| cli/breaking-changes/rules/field-same-cardinality.md | DONE | Переведено |
-| cli/breaking-changes/rules/field-same-type.md | DONE | Переведено |
-| cli/breaking-changes/rules/import-no-delete.md | DONE | Переведено |
-| cli/breaking-changes/rules/message-no-delete.md | DONE | Переведено |
-| cli/breaking-changes/rules/oneof-field-no-delete.md | DONE | Переведено |
-| cli/breaking-changes/rules/oneof-field-same-type.md | DONE | Переведено |
-| cli/breaking-changes/rules/oneof-no-delete.md | DONE | Переведено |
-| cli/breaking-changes/rules/rpc-no-delete.md | DONE | Переведено |
-| cli/breaking-changes/rules/rpc-same-request-type.md | DONE | Переведено |
-| cli/breaking-changes/rules/rpc-same-response-type.md | DONE | Переведено |
-| cli/breaking-changes/rules/service-no-delete.md | DONE | Переведено |
-| cli/configuration/configuration.md | DONE | Переведено |
-| cli/generator/examples/go.md | DONE | Переведено |
-| cli/generator/examples/grpc-gateway.md | DONE | Переведено |
-| cli/generator/examples/validate.md | DONE | Переведено |
-| cli/generator/generator.md | DONE | Переведено и вычитано |
-| cli/linter/linter.md | DONE | Переведено и вычитано |
-| cli/linter/rules/comment-enum-value.md | DONE | Переведено |
-| cli/linter/rules/comment-enum.md | DONE | Переведено |
-| cli/linter/rules/comment-field.md | DONE | Переведено |
-| cli/linter/rules/comment-message.md | DONE | Переведено |
-| cli/linter/rules/comment-oneof.md | DONE | Переведено |
-| cli/linter/rules/comment-rpc.md | DONE | Переведено |
-| cli/linter/rules/comment-service.md | DONE | Переведено |
-| cli/linter/rules/directory-same-package.md | DONE | Переведено |
-| cli/linter/rules/enum-first-value-zero.md | DONE | Переведено |
-| cli/linter/rules/enum-no-allow-alias.md | DONE | Переведено |
-| cli/linter/rules/enum-pascal-case.md | DONE | Переведено |
-| cli/linter/rules/enum-value-prefix.md | DONE | Переведено |
-| cli/linter/rules/enum-value-upper-snake-case.md | DONE | Переведено |
-| cli/linter/rules/enum-zero-value-suffix.md | DONE | Переведено |
-| cli/linter/rules/field-lower-snake-case.md | DONE | Переведено |
-| cli/linter/rules/file-lower-snake-case.md | DONE | Переведено |
-| cli/linter/rules/import-no-public.md | DONE | Переведено |
-| cli/linter/rules/import-no-weak.md | DONE | Переведено |
-| cli/linter/rules/import-used.md | DONE | Переведено |
-| cli/linter/rules/message-pascal-case.md | DONE | Переведено |
-| cli/linter/rules/oneof-lower-snake-case.md | DONE | Переведено |
-| cli/linter/rules/package-defined.md | DONE | Переведено |
-| cli/linter/rules/package-directory-match.md | DONE | Переведено |
-| cli/linter/rules/package-lower-snake-case.md | DONE | Переведено |
-| cli/linter/rules/package-same-csharp-namespace.md | DONE | Переведено |
-| cli/linter/rules/package-same-directory.md | DONE | Переведено |
-| cli/linter/rules/package-same-go-package.md | DONE | Переведено |
-| cli/linter/rules/package-same-java-multiple-files.md | DONE | Переведено |
-| cli/linter/rules/package-same-java-package.md | DONE | Переведено |
-| cli/linter/rules/package-same-php-namespace.md | DONE | Переведено |
-| cli/linter/rules/package-same-ruby-package.md | DONE | Переведено |
-| cli/linter/rules/package-same-swift-prefix.md | DONE | Переведено |
-| cli/linter/rules/package-version-suffix.md | DONE | Переведено |
-| cli/linter/rules/rpc-no-client-streaming.md | DONE | Переведено |
-| cli/linter/rules/rpc-no-server-streaming.md | DONE | Переведено |
-| cli/linter/rules/rpc-pascal-case.md | DONE | Переведено |
-| cli/linter/rules/rpc-request-response-unique.md | DONE | Переведено |
-| cli/linter/rules/rpc-request-standard-name.md | DONE | Переведено |
-| cli/linter/rules/rpc-response-standard-name.md | DONE | Переведено |
-| cli/linter/rules/service-pascal-case.md | DONE | Переведено |
-| cli/linter/rules/service-suffix.md | DONE | Переведено |
-| cli/package-manager/easyp-vs-buf.md | DONE | Переведено |
-| cli/package-manager/package-manager.md | DONE | Переведено и вычитано |
-| migration/buf-cli.md | DONE | Переведено |
-| migration/protoc.md | DONE | Переведено |
-| migration/protolock.md | DONE | Переведено |
-| migration/prototool.md | DONE | Переведено |
-
----
-
-## Workflow
-
-1. Выбираем файл со статусом TODO.
-2. Меняем статус на IN_PROGRESS здесь.
-3. Переводим, проверяем терминологию (сверка с глоссарием — добавить позже).
-4. Меняем статус на DONE.
-5. Удаляем маркер `<!-- TODO -->` внутри файла.
-
-## Planned Terminology (черновик)
-
-| EN | RU | Notes |
-|----|----|-------|
-| Linting | Линтинг | Транслитерация |
-| Breaking Changes | Несовместимые изменения | Название секции |
-| Dependency | Зависимость |  |
-| Code Generation | Генерация кода |  |
-| Lock file | Lock-файл |  |
-| Remote Plugin | Удалённый плагин |  |
-| Package Manager | Менеджер пакетов |  |
-
-(Будет дополнено.)
-
----
-
-## История обновлений
-
-- Initial file created: all statuses set (3 IN_PROGRESS, rest TODO).
-- Marked breaking-changes page as DONE.
-- Linter rules (41 файлов) переведены: статусы DONE.
-- Breaking-changes rules (15 файлов) вычитаны и помечены DONE.
-- Все оставшиеся страницы переведены: итог DONE = 76.
diff --git a/docs/public/docs/ru-guide/api-service/overview.md b/docs/public/docs/ru-guide/api-service/overview.md
deleted file mode 100644
index 07885700..00000000
--- a/docs/public/docs/ru-guide/api-service/overview.md
+++ /dev/null
@@ -1,312 +0,0 @@
-# Обзор API Service
-
-**Централизованный сервис выполнения protobuf‑плагинов для консистентной изолированной генерации кода**
-
-EasyP API Service устраняет хаос управления плагинами, предоставляя централизованный запуск protobuf/gRPC плагинов в изолированных Docker‑контейнерах. Он даёт единую платформу, позволяющую командам стандартизировать процесс генерации кода без операционных затрат на установку и поддержку плагинов на машинах разработчиков.
-
-## Зачем нужен EasyP API Service?
-
-### Проблема
-
-Управление генерацией protobuf/gRPC кода в командах порождает существенную операционную сложность:
-
-#### Несогласованность версий
-- Разработчики локально используют разные версии плагинов → расхождения в генерированном коде и падения сборки
-- Синдром «у меня работает» при различиях окружений
-- Требуется ручная координация, чтобы вся команда была синхронизирована по версиям
-
-#### Операционные накладные расходы
-- DevOps тратят время на установку и обновление плагинов на рабочих станциях
-- Новый разработчик — ручная настройка правильных версий
-- Обновление плагинов требует коммуникации с каждым отдельно
-- Нет централизованного контроля утверждённых версий
-
-#### Риски безопасности и комплаенса
-- Плагины ставятся из разных источников без валидации
-- Нет аудита: какой плагин для какого билда использовался
-- Сложно применять политики безопасности к инструментам генерации
-
-### Решение: централизованный запуск плагинов
-
-EasyP API Service решает эти проблемы за счёт централизованного управления:
-
-| Проблема | Решение |
-|----------|---------|
-| **Контроль версий** | Мгновенное распространение новых версий через Docker‑образы |
-| **Операции** | Команда эксплуатации управляет конфигурациями без доступа на машины разработчиков |
-| **Безопасность** | Все плагины запускаются в изолированных контейнерах с ограничениями ресурсов |
-| **Консистентность** | Единая среда выполнения вне зависимости от локальной установки |
-| **Опыт разработчика** | Не нужно устанавливать и сопровождать плагины локально |
-
-## Архитектура
-
-Архитектура сервиса упрощена и сфокусирована на надёжном выполнении плагинов:
-
-```mermaid
-graph TB
-    subgraph "Client Layer"
-        CLI[EasyP CLI]
-    end
-    
-    subgraph "EasyP API Service"
-        GRPC[gRPC Server]
-        CORE[Core Engine]
-        METRICS[Metrics Collector]
-    end
-    
-    subgraph "Plugin Execution"
-        DOCKER[Docker Runtime]
-        REGISTRY[Docker Hub Registry]
-    end
-    
-    subgraph "Storage"
-        DB[(PostgreSQL)]
-    end
-    
-    subgraph "Monitoring"
-        PROM[Prometheus]
-    end
-    
-    CLI -->|CodeGeneratorRequest| GRPC
-    GRPC --> CORE
-    
-    CORE -->|Fetch plugin params| DB
-    CORE -->|Execute plugin| DOCKER
-    CORE -->|Record metrics| METRICS
-    
-    DOCKER -->|Pull images| REGISTRY
-    
-    METRICS --> PROM
-```
-
-## Ключевые компоненты
-
-### API Layer
-- **gRPC Server** — основной API для запросов генерации
-- Каждый запуск плагина — отдельный gRPC‑запрос
-- Получает `CodeGeneratorRequest` от CLI
-
-### Execution Engine
-- **Docker Runtime** — изолированный запуск плагинов
-- Подтягивает образы из публичных реестров (Docker Hub и т.п.)
-- Применяет лимиты CPU/памяти на плагин
-
-### Storage Layer
-- **PostgreSQL** хранит параметры выполнения:
-  - Ограничения ресурсов (CPU, память)
-  - Конфигурацию и метаданные плагинов
-  - Логи выполнения (аудит)
-  - _Примечание: функциональность хранения будет расширяться_
-
-### Monitoring
-- **Prometheus** — сбор метрик
-- Отслеживает время выполнения, успешность, использование ресурсов
-
-## Как это работает
-
-### Локальное выполнение (EasyP CLI)
-При локальном запуске CLI поддерживает:
-- **Installed plugins**: системно установленные protoc плагины
-- **WASM plugins**: лёгкие WebAssembly плагины
-
-### Удалённое выполнение (API Service)
-При работе через сервис:
-- **Только Docker**: плагины запускаются как контейнеры
-- **Центральный контроль**: операционная команда управляет доступными версиями
-- **Консистентная среда**: одинаковое окружение для всех разработчиков
-
-## Поток выполнения плагина
-
-```mermaid
-sequenceDiagram
-    participant CLI as EasyP CLI
-    participant API as gRPC Server
-    participant DB as PostgreSQL
-    participant Docker as Docker Engine
-    participant Registry as Docker Registry
-    
-    Note over CLI: Парсинг protobuf-файлов
-    CLI->>API: CodeGeneratorRequest (на каждый плагин)
-    
-    API->>DB: Получение параметров плагина
-    Note over DB: Лимиты CPU/памяти<br/>Имя Docker-образа<br/>Конфиг запуска
-    DB-->>API: Параметры выполнения
-    
-    API->>Docker: Pull образ (если нужно)
-    Docker->>Registry: Загрузка образа
-    Registry-->>Docker: Образ плагина
-    
-    API->>Docker: Запуск контейнера
-    Note over Docker: Изолированное выполнение<br/>Лимиты ресурсов применены
-    Docker-->>API: CodeGeneratorResponse
-    
-    API->>PROM: Запись метрик
-    Note over PROM: Время, статус,<br/>использование ресурсов
-    
-    API-->>CLI: CodeGeneratorResponse
-```
-
-### Шаги выполнения
-
-1. **CLI Parsing**: CLI парсит локальные `.proto` файлы  
-2. **Request Sending**: Отправляет `CodeGeneratorRequest` в API Service (по одному на плагин)  
-3. **Parameter Lookup**: Сервис получает параметры запуска из PostgreSQL  
-4. **Docker Execution**: Запускает плагин в изолированном контейнере  
-5. **Metrics Recording**: Записывает метрики после завершения  
-6. **Response**: Возвращает сгенерированный код обратно в CLI  
-
-## Ключевые возможности
-
-| Возможность | Описание |
-|-------------|----------|
-| **🐳 Изоляция плагинов** | Каждый плагин в отдельном безопасном контейнере |
-| **⚙️ Контроль ресурсов** | Лимиты CPU и памяти на уровне контейнера |
-| **📊 Метрики & мониторинг** | Полный набор Prometheus метрик |
-| **🔄 Управление версиями** | Централизованно через Docker‑образы |
-| **⚡ Простой протокол** | Стандарт `CodeGeneratorRequest/Response` |
-| **🔒 Безопасность прежде всего** | Изоляция + ограниченные ресурсы |
-
-## Конфигурация
-
-Сервис настраивается через переменные окружения.
-
-### Конфигурация сервера
-```bash
-EASYP_SERVICE_HOST=0.0.0.0
-EASYP_SERVICE_GRPC_PORT=8080
-```
-
-### Конфигурация БД
-```bash
-EASYP_SERVICE_DB_HOST=localhost
-EASYP_SERVICE_DB_PORT=5432
-EASYP_SERVICE_DB_NAME=easyp_service
-EASYP_SERVICE_DB_USER=easyp
-EASYP_SERVICE_DB_PASSWORD=password
-```
-
-### Конфигурация Docker
-```bash
-# Docker socket для запуска контейнеров
-DOCKER_HOST=unix:///var/run/docker.sock
-```
-
-## Хранение параметров плагинов
-
-PostgreSQL хранит параметры выполнения для каждого плагина:
-
-```sql
--- Пример конфигурации плагина
-{
-  "plugin_name": "protobuf/go:v1.36.10",
-  "docker_image": "easyp/protoc-gen-go:v1.36.10",
-  "resources": {
-    "cpu_limit": "1.0",
-    "memory_limit": "512MB"
-  },
-  "execution_config": {
-    "timeout": "30s",
-    "network": "none"
-  }
-}
-```
-
-::: tip
-Схема хранения будет расширена — аудит логов, аналитика использования, кеширование плагинов.
-:::
-
-## Интеграция с EasyP CLI
-
-Пример `easyp.yaml` для удалённого запуска:
-
-```yaml
-generate:
-  plugins:
-    # Удалённый запуск через API Service
-    - remote: api.easyp.tech/protobuf/go:v1.36.10
-      out: .
-      opts:
-        paths: source_relative
-    
-    - remote: api.easyp.tech/grpc/go:v1.5.1
-      out: .
-      opts:
-        paths: source_relative
-```
-
-Запуск генерации:
-
-```bash
-easyp generate
-```
-
-CLI:
-1. Парсит protobuf‑файлы
-2. Отправляет отдельные запросы в сервис для каждого плагина
-3. Получает ответы с кодом
-4. Записывает файлы в указанные директории
-
-## Доступные метрики
-
-Метрики Prometheus:
-
-| Метрика | Описание |
-|---------|----------|
-| `easyp_api_service_api_grpc_server_handled_total` | Общее число gRPC запросов по статусам |
-| `easyp_api_service_api_grpc_server_handling_seconds` | Гистограмма задержек gRPC |
-| `easyp_api_service_generated_plugin_code_total` | Выполнения плагинов по имени |
-| `easyp_api_service_repo_call_duration_seconds` | Латентность запросов к БД |
-| `easyp_api_service_repo_errors_total` | Количество ошибок доступа к БД |
-| `easyp_api_service_standard_panics_total` | Число восстановленных паник |
-
-## Характеристики производительности
-
-| Показатель | Типичное значение | Примечания |
-|-----------|-------------------|-----------|
-| **Cold Start** | 2–5 сек | Первая загрузка образа |
-| **Warm Start** | 100–500 мс | Образ закеширован |
-| **Throughput** | 20–50 одновременных | Зависит от ресурсов |
-| **Memory Usage** | 50–200 MB | На выполнение одного плагина |
-
-## Безопасность
-
-### Изоляция контейнеров
-- Каждый плагин в отдельном эфемерном контейнере
-- Нет сетевого доступа в процессе выполнения
-- Лимиты CPU/памяти через Docker
-- Контейнер удаляется после завершения
-
-### Безопасность API
-- gRPC транспорт
-- Поддержка токенов аутентификации (в продакшн окружениях)
-- Валидация входных данных
-- Аудитные логи в PostgreSQL
-
-## Продакшн‑аспекты
-
-### Масштабирование
-- **Горизонтальное**: несколько инстансов за балансировщиком
-- **Ресурсы**: настройка лимитов для тяжёлых плагинов
-- **База данных**: репликация PostgreSQL для отказоустойчивости
-
-### Мониторинг
-- **Метрики**: Prometheus
-- **Алертинг**: оповещения на высокие ошибки/латентность
-- **Логи**: структурированные для аудита и отладки
-
-### План развития
-Запланировано:
-- Кеширование результатов генерации
-- Расширенный аудит и аналитика использования
-- Поддержка приватных реестров плагинов
-- Более умное распределение ресурсов
-
-## Сообщество и поддержка
-
-- **💬 [Telegram чат](https://t.me/easyptech)** — обсуждения
-- **🐛 [GitHub Issues](https://github.com/easyp-tech/service/issues)** — баги и запросы фич
-- **📖 [Документация](https://easyp.tech)** — полный набор материалов
-
----
-
-*Упростите свои protobuf‑воркфлоу с централизованным управлением выполнением плагинов.*
\ No newline at end of file
diff --git a/docs/public/docs/ru-guide/ci-cd/github-actions.md b/docs/public/docs/ru-guide/ci-cd/github-actions.md
deleted file mode 100644
index be13a10f..00000000
--- a/docs/public/docs/ru-guide/ci-cd/github-actions.md
+++ /dev/null
@@ -1,412 +0,0 @@
-# GitHub Actions
-
-Полное руководство по интеграции EasyP в конвейеры GitHub Actions для линтинга, проверки несовместимых изменений, генерации кода и автоматизации релизов.
-
-## Зачем использовать EasyP в CI
-
-Встраивание EasyP в GitHub Actions даёт:
-
-- Единообразие правил линтинга и генерации между разработчиками.
-- Автоматическое выявление несовместимых изменений (breaking changes) до мержа.
-- Гарантию, что сгенерированный код не «устарел» относительно .proto.
-- Возможность централизованной проверки зависимостей и версии конфигурации.
-
-## Предварительные требования
-
-1. Репозиторий содержит файл конфигурации `easyp.yaml` (или находится в корне, если запускается без `--cfg`).
-2. Установлены / определены зависимости в секции `deps` (если нужны внешние импорты).
-3. Для приватных Git-репозиториев настроен доступ (SSH key / deploy key / токен).
-4. В workflow есть шаги по установке Go (если EasyP поставляется через `go install`) или заранее подготовленный бинарь.
-
-## Базовый пример (быстрый старт)
-
-Минимальный workflow для проверки линта и несовместимых изменений при открытия Pull Request:
-
-```yaml
-name: easyp-ci
-
-on:
-  pull_request:
-    paths:
-      - '**/*.proto'
-      - 'easyp.yaml'
-
-jobs:
-  lint-and-breaking:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Go
-        uses: actions/setup-go@v5
-        with:
-          go-version: '1.22'
-
-      - name: Install EasyP
-        run: go install github.com/easyp-tech/easyp/cmd/easyp@latest
-
-      - name: Verify EasyP version
-        run: |
-          which easyp
-          easyp --version
-
-      - name: Lint
-        run: easyp lint
-
-      - name: Breaking changes check (against main)
-        run: easyp breaking --against git-ref=origin/main
-```
-
-## Установка EasyP
-
-Варианты:
-
-1. Через `go install` (как в примере выше).
-2. Использование заранее собранного бинаря (артефакт релиза).
-
-```yaml
-- name: Download EasyP binary
-  run: |
-    curl -sL https://github.com/easyp-tech/easyp/releases/download/v1.0.0/easyp_linux_amd64 -o /usr/local/bin/easyp
-    chmod +x /usr/local/bin/easyp
-```
-
-## Кэширование
-
-Для ускорения повторных сборок можно кэшировать:
-
-- Go модульный кеш (если используете генерацию с плагинами Go).
-- Внешние зависимые Git-клонирования (папки `vendor` или содержимое `deps` при использовании `easyp mod download` / `easyp mod update`).
-- Сгенерированный код (если он тяжёлый, но чаще генерируется заново).
-
-Пример кэширования Go:
-
-```yaml
-- name: Cache Go build
-  uses: actions/cache@v4
-  with:
-    path: |
-      ~/go/pkg/mod
-      ~/.cache/go-build
-    key: go-${{ runner.os }}-${{ hashFiles('**/go.sum') }}
-    restore-keys: |
-      go-${{ runner.os }}-
-```
-
-Пример кэширования каталога зависимостей EasyP (если вы используете локальный vendor-подход):
-
-```yaml
-- name: Cache proto deps
-  uses: actions/cache@v4
-  with:
-    path: .easyp/deps
-    key: deps-${{ runner.os }}-${{ hashFiles('easyp.yaml') }}
-    restore-keys: |
-      deps-${{ runner.os }}-
-```
-
-(Создайте `.easyp/deps` как целевой каталог, если ваша стратегия скачивания такова.)
-
-## Линтинг
-
-Команда:
-
-```bash
-easyp lint
-```
-
-Рекомендуется:
-
-- В PR: всегда запускать.
-- На main: можно запускать для верификации перед релизом.
-
-Расширенный пример с выводом подробностей и игнорированием комментариев (если включено в конфиг):
-
-```yaml
-- name: Lint proto files
-  run: |
-    set -e
-    easyp lint -v
-```
-
-## Проверка несовместимых изменений (Breaking Changes)
-
-EasyP может сравнивать текущее состояние против ветки / коммита / тега.
-
-Примеры:
-
-```bash
-# Сравнить против origin/main
-easyp breaking --against git-ref=origin/main
-
-# Сравнить против тега релиза
-easyp breaking --against git-ref=v1.5.2
-
-# Игнорировать определённые правила (если у вас настроено в easyp.yaml)
-easyp breaking
-```
-
-Workflow шаг:
-
-```yaml
-- name: Breaking changes check
-  run: easyp breaking --against git-ref=origin/main
-```
-
-Если нужно «мягко» пропустить (например, выводить предупреждения, но не падать билд):
-
-```yaml
-- name: Breaking changes (soft)
-  run: |
-    if ! easyp breaking --against git-ref=origin/main; then
-      echo "::warning title=Breaking Changes Detected::Обнаружены потенциально несовместимые изменения"
-    fi
-```
-
-## Генерация кода
-
-Обычно для генерации:
-
-```bash
-easyp generate
-```
-
-Если нужно явно указать конфиг:
-
-```bash
-easyp --cfg easyp.yaml generate
-```
-
-Пример шага:
-
-```yaml
-- name: Generate code
-  run: |
-    easyp generate
-    git status --short
-```
-
-Можно добавить проверку «не осталось ли не закоммиченных изменений» (гарантия, что сгенерированный код актуален):
-
-```yaml
-- name: Ensure generated code is up-to-date
-  run: |
-    easyp generate
-    if [ -n "$(git status --porcelain)" ]; then
-      echo "Generated code is outdated. Please commit changes."
-      git diff --name-only
-      exit 1
-    fi
-```
-
-## Матрица (Matrix strategy)
-
-Если у вас несколько вариантов конфигураций или разных языков генерации (через плагины), можно использовать matrix:
-
-```yaml
-jobs:
-  generate:
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        lang: [go, python]
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup Go (only for go)
-        if: matrix.lang == 'go'
-        uses: actions/setup-go@v5
-        with:
-          go-version: '1.22'
-
-      - name: Install EasyP
-        run: go install github.com/easyp-tech/easyp/cmd/easyp@latest
-
-      - name: Generate
-        run: |
-          if [ "${{ matrix.lang }}" = "go" ]; then
-            easyp generate
-          elif [ "${{ matrix.lang }}" = "python" ]; then
-            easyp generate --plugin python
-          fi
-```
-
-## Работа с приватными репозиториями (deps)
-
-Если вы указываете приватные Git-пакеты в секции `deps`:
-
-1. Настройте deploy key или используйте `GIT_SSH_COMMAND` с токеном.
-2. Добавьте known_hosts (либо установите `StrictHostKeyChecking=no` для внутренних систем, но осознанно).
-
-Пример:
-
-```yaml
-- name: Prepare SSH
-  run: |
-    mkdir -p ~/.ssh
-    echo "${{ secrets.DEPLOY_KEY }}" > ~/.ssh/id_rsa
-    chmod 600 ~/.ssh/id_rsa
-    ssh-keyscan github.com >> ~/.ssh/known_hosts
-
-- name: Update deps
-  run: easyp mod update
-```
-
-## Оптимизация времени сборки
-
-- Используйте кэш для Go / deps.
-- Запускайте линт/брейкинг только если изменились `.proto` или `easyp.yaml` (paths фильтр).
-- Разделяйте workflow: быстрый линт в PR, тяжелая генерация в push на main.
-- Выносите генерацию OpenAPI / gRPC-Gateway в отдельный job (параллелизм).
-
-## Продвинутый workflow (многостадийный)
-
-```yaml
-name: easyp-pipeline
-
-on:
-  pull_request:
-    paths:
-      - '**/*.proto'
-      - 'easyp.yaml'
-  push:
-    branches:
-      - main
-
-jobs:
-  validate:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-go@v5
-        with:
-          go-version: '1.22'
-
-      - name: Install EasyP
-        run: go install github.com/easyp-tech/easyp/cmd/easyp@latest
-
-      - name: Lint
-        run: easyp lint
-
-      - name: Breaking check (against main)
-        if: github.event_name == 'pull_request'
-        run: easyp breaking --against git-ref=origin/main
-
-  generate:
-    needs: validate
-    if: github.event_name == 'push'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-go@v5
-        with:
-          go-version: '1.22'
-      - name: Install EasyP
-        run: go install github.com/easyp-tech/easyp/cmd/easyp@latest
-      - name: Generate Code
-        run: easyp generate
-      - name: Check diffs
-        run: |
-          if [ -n "$(git status --porcelain)" ]; then
-            echo "Generated files changed after generate step."
-            git diff --name-only
-            exit 1
-          fi
-```
-
-## Автоматизация релиза (пример)
-
-Можно добавить workflow, который по тегу создаёт релиз и валидирует proto:
-
-```yaml
-name: release-verify
-
-on:
-  push:
-    tags:
-      - 'v*.*.*'
-
-jobs:
-  release-check:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-go@v5
-        with:
-          go-version: '1.22'
-
-      - name: Install EasyP
-        run: go install github.com/easyp-tech/easyp/cmd/easyp@latest
-
-      - name: Lint
-        run: easyp lint
-
-      - name: Breaking vs previous tag
-        run: |
-          PREV_TAG=$(git tag --sort=-creatordate | grep -v "${GITHUB_REF_NAME}" | head -n1 || true)
-          if [ -n "$PREV_TAG" ]; then
-            echo "Comparing against $PREV_TAG"
-            easyp breaking --against git-ref=$PREV_TAG
-          else
-            echo "No previous tag, skipping breaking check"
-          fi
-
-      - name: Generate to ensure consistency
-        run: easyp generate
-```
-
-## Отладка
-
-Если нужно больше логов:
-
-```bash
-easyp lint -v
-easyp breaking -v --against git-ref=origin/main
-easyp generate -v
-```
-
-Добавьте вывод окружения для диагностики:
-
-```yaml
-- name: Debug environment
-  run: |
-    env | sort
-    easyp --version
-```
-
-## Переменные окружения (примерно)
-
-| Переменная | Назначение |
-|------------|-----------|
-| `EASYP_SERVICE_HOST` | Хост удалённого API Service (если используете удалённые плагины) |
-| `EASYP_SERVICE_GRPC_PORT` | Порт удалённого сервиса |
-| `GIT_SSH_COMMAND` | Кастомная команда SSH (частные репозитории) |
-| `GOFLAGS` | Можно выставить `-mod=readonly` для Go генерации |
-
-(Используйте только те, что действительно нужны вашему проекту.)
-
-## Частые ошибки
-
-| Симптом | Причина | Решение |
-|---------|---------|---------|
-| Линт падает на неизвестных правилах | Правила указаны в `easyp.yaml`, но версия EasyP их не поддерживает | Обновить EasyP (`go install ...@latest`) |
-| `breaking` сравнение ничего не находит | Неверный `--against` (нет fetch удалённой ветки) | Добавить шаг `git fetch --all --tags` |
-| Сгенерированный код в PR отличается от main | Отсутствует проверка генерации в CI | Добавить шаг «Ensure generated code is up-to-date» |
-| Приватные deps не скачиваются | Нет SSH ключа или токена | Настроить secrets + шаг подготовки SSH |
-| Долгое выполнение | Отсутствует кеш | Добавить кэширование модулей и deps |
-
-## Рекомендации по поддержке
-
-- Заготовить шаблон workflow и копировать между сервисами (DRY).
-- Включить `paths` фильтры, чтобы не тратить минуты на нерелевантные изменения.
-- Проверять `easyp.yaml` при изменениях отдельно — можно запускать «конфигурационный тест» (например, `easyp lint` без файлов, чтобы убедиться, что конфиг валиден).
-- При появлении новых правил линтера обновляйте конфиг и фиксируйте ошибки сразу в одной ветке.
-
----
-
-Готово: вы можете расширять разделы генерации, добавлять OpenAPI / grpc-gateway / validate плагины, матрицы по языкам и интегрировать тесты поверх сгенерированного кода, если требуется.
diff --git a/docs/public/docs/ru-guide/ci-cd/gitlab.md b/docs/public/docs/ru-guide/ci-cd/gitlab.md
deleted file mode 100644
index 9446e1ca..00000000
--- a/docs/public/docs/ru-guide/ci-cd/gitlab.md
+++ /dev/null
@@ -1,59 +0,0 @@
-# GitLab CI
-
-## В процессе разработки
-
-Документация по интеграции EasyP с GitLab CI находится в процессе подготовки.  
-Планируемые разделы:
-
-- Быстрый старт (пример `.gitlab-ci.yml` для линтинга и проверки несовместимых изменений)
-- Кэширование зависимостей и ускорение сборок
-- Генерация кода и проверка актуальности артефактов
-- Работа с приватными Git-репозиториями в `deps`
-- Матрицы (parallel jobs) для разных языков и плагинов
-- Автоматизация релизов по тегам
-
-Если вам нужен пример прямо сейчас, базовый минимальный вариант может выглядеть так:
-
-```yaml
-stages:
-  - validate
-  - generate
-
-variables:
-  GO_VERSION: "1.22"
-
-validate:
-  stage: validate
-  image: golang:${GO_VERSION}
-  before_script:
-    - go install github.com/easyp-tech/easyp/cmd/easyp@latest
-    - echo "EasyP version:"
-    - easyp --version
-    # При необходимости: git fetch --all --tags
-  script:
-    - easyp lint
-    - easyp breaking --against git-ref=origin/main
-  only:
-    changes:
-      - "**/*.proto"
-      - "easyp.yaml"
-
-generate:
-  stage: generate
-  image: golang:${GO_VERSION}
-  before_script:
-    - go install github.com/easyp-tech/easyp/cmd/easyp@latest
-  script:
-    - easyp generate
-    - |
-      if [ -n "$(git status --porcelain)" ]; then
-        echo "Сгенерированный код не актуален. Закоммитьте изменения локально."
-        git diff --name-only
-        exit 1
-      fi
-  only:
-    - main
-
-```
-
-Дополнительные рекомендации будут добавлены позже.
\ No newline at end of file
diff --git a/docs/public/docs/ru-guide/cli/auto-completion/auto-completion.md b/docs/public/docs/ru-guide/cli/auto-completion/auto-completion.md
deleted file mode 100644
index 7a6a1979..00000000
--- a/docs/public/docs/ru-guide/cli/auto-completion/auto-completion.md
+++ /dev/null
@@ -1,39 +0,0 @@
-# Автодополнение
-
-## Автодополнение для zsh
-
-1. Добавьте следующую строку в ваш файл запуска `~/.zshrc`:
-
-```bash
-source <(easyp completion zsh)
-```
-
-2. Перезапустите оболочку или выполните:
-
-```bash
-source ~/.zshrc
-```
-
-## Автодополнение для Bash
-
-1. Установите [bash-completion](https://github.com/scop/bash-completion#installation) и подключите его в `~/.bashrc`.
-2. Добавьте следующую строку в файл запуска `~/.bashrc`:
-
-```bash
-source <(easyp completion bash)
-```
-
-3. Перезапустите оболочку или выполните:
-
-```bash
-source ~/.bashrc
-```
-
-## Примечания
-
-- Команда `easyp completion <shell>` выводит скрипт автодополнения для соответствующей оболочки.
-- Если используете другую оболочку (например, `fish`), можно сгенерировать вывод и сохранить вручную:
-  ```bash
-  easyp completion fish > ~/.config/fish/completions/easyp.fish
-  ```
-- При обновлении версии EasyP рекомендуется заново перезагрузить оболочку, чтобы подтянуть возможные изменения в автодополнении.
\ No newline at end of file
diff --git a/docs/public/docs/ru-guide/cli/breaking-changes/breaking-changes.md b/docs/public/docs/ru-guide/cli/breaking-changes/breaking-changes.md
deleted file mode 100644
index ce7970d6..00000000
--- a/docs/public/docs/ru-guide/cli/breaking-changes/breaking-changes.md
+++ /dev/null
@@ -1,439 +0,0 @@
-# Обнаружение несовместимых изменений (Breaking Changes Detection)
-
-[[toc]]
-
-Механизм EasyP для обнаружения несовместимых (breaking) изменений помогает поддерживать обратную совместимость ваших protobuf API, автоматически выявляя изменения, способные сломать существующих клиентов. Это критично для стабильных API в продакшене.
-
-## Обзор
-
-Проверка несовместимых изменений сравнивает текущий набор protobuf‑файлов с предыдущей версией (обычно из другой Git ветки) и фиксирует модификации, которые могут вызвать проблемы совместимости для уже работающих клиентов.
-
-### Ключевые возможности
-
-- **Сравнение через Git**: Сопоставление с любой Git‑ссылкой (ветка, тег, commit)
-- **Комплексный анализ**: Проверка сервисов, сообщений, enum'ов, полей и import'ов
-- **Выборочное игнорирование**: Пропуск указанных директорий из анализа
-- **Детализированные отчёты**: Понятные ошибки с именами файлов, строками и позициями
-
-## Как работает
-
-Детектор breaking changes выполняет следующие шаги:
-
-1. **Получение ветки сравнения**: Забирает proto-файлы из указанной Git‑ссылки
-2. **Парсинг обеих версий**: Анализирует структуру текущих и предыдущих файлов
-3. **Сравнение сущностей**: Последовательно проверяет все элементы protobuf на breaking изменения
-4. **Формирование отчёта**: Генерирует подробные записи об ошибках с локациями и описаниями
-
-## Уровень проверки
-
-EasyP реализует уровень проверки **WIRE+**:
-- ✅ **Полная совместимость по wire‑формату** — старые и новые версии могут обмениваться данными
-- ✅ **Обнаружение удалений элементов** — сервисы, сообщения, поля и т.п.
-- ✅ **Безопасность типов** — выявляет несовместимые изменения типов
-- ❌ **Переименования полей/методов** — пока не детектируются (в планах)
-- ❌ **Изменения на уровне файлов** — переносы пакетов, file options ещё не проверяются
-
-Это даёт сильные гарантии совместимости и меньше ограничений, чем инструменты, требующие совместимости сгенерированного кода.
-
-## Конфигурация
-
-Настройка в `easyp.yaml`:
-
-```yaml
-breaking:
-  # Git reference для сравнения (branch, tag или commit hash)
-  against_git_ref: "main"
-  
-  # Директории, игнорируемые в анализе breaking changes
-  ignore:
-    - "experimental"
-    - "internal/proto"
-    - "vendor"
-```
-
-### Параметры конфигурации
-
-| Option | Description | Default | Required |
-|--------|-------------|---------|----------|
-| `against_git_ref` | Git‑ссылка для сравнения | `"master"` | No |
-| `ignore` | Список директорий для исключения из анализа | `[]` | No |
-
-## Использование
-
-### Базовый пример
-
-Сравнение текущих изменений с веткой main:
-
-```bash
-easyp breaking --against main
-```
-
-### Использование файла конфигурации
-
-```bash
-easyp --cfg my-config.yaml breaking
-```
-
-### Переопределение Git‑ссылки
-
-```bash
-easyp breaking --against feature/new-api
-```
-
-## Уровень проверки
-
-EasyP сейчас работает на уровне **WIRE+**, обеспечивая совместимость wire‑формата плюс защиту от удалений и изменения критичных типов.
-
-### Сравнение с категориями Buf
-
-| Check Type | Buf WIRE | Buf WIRE_JSON | Buf FILE | EasyP Current |
-|------------|----------|---------------|----------|---------------|
-| **Element Deletions** |
-| Service deletion | ❌ | ❌ | ✅ | ✅ |
-| RPC method deletion | ❌ | ❌ | ✅ | ✅ |
-| Message deletion | ❌ | ❌ | ✅ | ✅ |
-| Field deletion (by number) | ✅ | ✅ | ✅ | ✅ |
-| Enum deletion | ❌ | ❌ | ✅ | ✅ |
-| Enum value deletion | ✅ | ✅ | ✅ | ✅ |
-| OneOf deletion | ❌ | ❌ | ✅ | ✅ |
-| Import deletion | ❌ | ❌ | ✅ | ✅ |
-| **Type Changes** |
-| Field type change | ✅ | ✅ | ✅ | ✅ |
-| RPC request/response type | ✅ | ✅ | ✅ | ✅ |
-| Optional/required changes | ✅ | ✅ | ✅ | ✅ |
-| **Naming (Generated Code)** |
-| Field rename (same number) | ❌ | ✅ | ✅ | ❌ |
-| Enum value rename | ❌ | ✅ | ✅ | ✅ |
-| **File Structure** |
-| Package change | ✅ | ✅ | ✅ | ❌ |
-| File options (go_package, etc) | ❌ | ❌ | ✅ | ❌ |
-| Moving types between files | ❌ | ❌ | ✅ | ❌ |
-
-### Что это означает
-
-**✅ EasyP обнаружит:**
-- Все breaking изменения wire‑формата
-- Удаления сервисов, методов, сообщений, полей
-- Изменения типов, ломающие сериализацию
-- Переименования enum‑значений (при сохранении номера)
-
-**❌ EasyP НЕ обнаружит:**
-- Переименование полей (с тем же номером)
-- Изменение package
-- File options (go_package, java_package, и т.п.)
-- Перемещение типов между файлами в одном package
-
-## Правила Breaking Changes
-
-EasyP обнаруживает следующие типы breaking изменений:
-
-### Сравнение уровней
-
-| Detection Level | Description | EasyP Support |
-|----------------|-------------|---------------|
-| **WIRE** | Совместимость только по wire‑формату | ✅ **Full support** |
-| **WIRE+** | Wire + обнаружение удалений | ✅ **Current level** |
-| **FILE** | Совместимость сгенерированного кода | ❌ Partial (planned) |
-
-## Категории правил
-
-Каждая категория имеет свою документацию с примерами:
-
-### 🚨 Изменения Service и RPC
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [SERVICE_NO_DELETE](./rules/service-no-delete.md) | Services cannot be deleted | ✅ Implemented |
-| [RPC_NO_DELETE](./rules/rpc-no-delete.md) | RPC methods cannot be deleted | ✅ Implemented |
-| [RPC_SAME_REQUEST_TYPE](./rules/rpc-same-request-type.md) | RPC request types cannot be changed | ✅ Implemented |
-| [RPC_SAME_RESPONSE_TYPE](./rules/rpc-same-response-type.md) | RPC response types cannot be changed | ✅ Implemented |
-
-### 📦 Изменения Message и Field
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [MESSAGE_NO_DELETE](./rules/message-no-delete.md) | Messages cannot be deleted | ✅ Implemented |
-| [FIELD_NO_DELETE](./rules/field-no-delete.md) | Fields cannot be deleted | ✅ Implemented |
-| [FIELD_SAME_TYPE](./rules/field-same-type.md) | Field types cannot be changed | ✅ Implemented |
-| [FIELD_SAME_CARDINALITY](./rules/field-same-cardinality.md) | Field optionality (optional/required) cannot be changed | ✅ Implemented |
-
-### 🔢 Изменения Enum
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [ENUM_NO_DELETE](./rules/enum-no-delete.md) | Enums cannot be deleted | ✅ Implemented |
-| [ENUM_VALUE_NO_DELETE](./rules/enum-value-no-delete.md) | Enum values cannot be deleted | ✅ Implemented |
-| [ENUM_VALUE_SAME_NAME](./rules/enum-value-same-name.md) | Enum value names cannot be changed | ✅ Implemented |
-
-### 🔗 Изменения OneOf
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [ONEOF_NO_DELETE](./rules/oneof-no-delete.md) | OneOf fields cannot be deleted | ✅ Implemented |
-| [ONEOF_FIELD_NO_DELETE](./rules/oneof-field-no-delete.md) | Fields within oneofs cannot be deleted | ✅ Implemented |
-| [ONEOF_FIELD_SAME_TYPE](./rules/oneof-field-same-type.md) | OneOf field types cannot be changed | ✅ Implemented |
-
-### 📥 Изменения Import
-
-| Rule | Description | Status |
-|------|-------------|---------|
-| [IMPORT_NO_DELETE](./rules/import-no-delete.md) | Import statements cannot be removed | ✅ Implemented |
-
-## Не обнаруживается сейчас
-
-Изменения ниже **НЕ детектируются** EasyP (могут ломать сгенерированный код):
-
-| Change Type | Example | Impact |
-|-------------|---------|--------|
-| Field renaming | `string name = 1` → `string full_name = 1` | Ломает код |
-| Package changes | `package v1` → `package v2` | Меняются пути импорта |
-| File options | `option go_package = "old"` → `option go_package = "new"` | Меняется расположение кода |
-| Moving between files | Message перемещено в другой .proto | Зависимости import'ов |
-
-## Документация правил
-
-См. подробные файлы правил для примеров и стратегий миграции:
-
-- Service: [SERVICE_NO_DELETE](./rules/service-no-delete.md), [RPC_NO_DELETE](./rules/rpc-no-delete.md), [RPC_SAME_REQUEST_TYPE](./rules/rpc-same-request-type.md), [RPC_SAME_RESPONSE_TYPE](./rules/rpc-same-response-type.md)
-- Message: [MESSAGE_NO_DELETE](./rules/message-no-delete.md), [FIELD_NO_DELETE](./rules/field-no-delete.md), [FIELD_SAME_TYPE](./rules/field-same-type.md), [FIELD_SAME_CARDINALITY](./rules/field-same-cardinality.md)
-- Enum: [ENUM_NO_DELETE](./rules/enum-no-delete.md), [ENUM_VALUE_NO_DELETE](./rules/enum-value-no-delete.md), [ENUM_VALUE_SAME_NAME](./rules/enum-value-same-name.md)
-- OneOf: [ONEOF_NO_DELETE](./rules/oneof-no-delete.md), [ONEOF_FIELD_NO_DELETE](./rules/oneof-field-no-delete.md), [ONEOF_FIELD_SAME_TYPE](./rules/oneof-field-same-type.md)
-- Import: [IMPORT_NO_DELETE](./rules/import-no-delete.md)
-
-Каждое правило содержит:
-- ❌ Плохие примеры (breaking)
-- ✅ Безопасные альтернативы
-- 🔧 Стратегии миграции
-- 📋 Реальные сообщения ошибок из EasyP
-
-## Быстрые примеры
-
-### ✅ Безопасные изменения (разрешены всегда)
-```proto
-// Добавление новых элементов — безопасно
-message User {
-  string name = 1;
-  string email = 2;
-  string phone = 3;  // ✅ Новое поле
-}
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc GetUserProfile(GetUserRequest) returns (UserProfile);  // ✅ Новый RPC
-}
-
-enum Status {
-  STATUS_UNSPECIFIED = 0;
-  STATUS_ACTIVE = 1;
-  STATUS_PENDING = 2;  // ✅ Новое enum значение
-}
-```
-
-### ❌ Несовместимые изменения (обнаруживаются всегда)
-```proto
-// Удаления и смена типов ломают совместимость
-message User {
-  string name = 1;
-  // ❌ Удалённое поле
-}
-
-service UserService {
-  // ❌ Удалённый RPC метод
-  rpc GetUser(GetUserRequestV2) returns (GetUserResponse);  // ❌ Изменён тип запроса
-}
-```
-
-### Сценарий: Изменения пока не детектируются
-
-```proto
-// 🟡 Ломает сгенерированный код, но проходит проверки EasyP
-message User {
-  string user_name = 1;    // Переименовано с "name"
-  string user_email = 2;   // Переименовано с "email"
-}
-
-service UserService {
-  rpc GetUserProfile(GetUserRequest) returns (GetUserResponse);  // Переименовано с GetUser
-}
-```
-
-## Формат вывода
-
-### Текстовый формат (по умолчанию)
-
-```
-services.proto:45:1: Previously present RPC "DeleteUser" on service "UserService" was deleted. (BREAKING_CHECK)
-messages.proto:15:3: Previously present field "2" with name "email" on message "User" was deleted. (BREAKING_CHECK)
-```
-
-### JSON формат
-
-```bash
-easyp --format json breaking --against main
-```
-
-```json
-{
-  "path": "services.proto",
-  "position": {
-    "line": 45,
-    "column": 1
-  },
-  "source_name": "",
-  "message": "Previously present RPC \"DeleteUser\" on service \"UserService\" was deleted.",
-  "rule_name": "BREAKING_CHECK"
-}
-```
-
-## Best Practices
-
-### 1. Регулярный запуск
-Добавьте проверку несовместимых изменений в CI/CD:
-
-```yaml
-- name: Check for breaking changes
-  run: easyp breaking --against origin/main
-```
-
-### 2. Защита веток
-Блокируйте слияния с breaking изменениями:
-
-```yaml
-if: github.event_name == 'pull_request'
-run: |
-  easyp breaking --against origin/main
-  if [ $? -eq 1 ]; then
-    echo "Breaking changes detected!"
-    exit 1
-  fi
-```
-
-### 3. Стратегия версионирования
-При необходимости breaking изменений:
-- Создайте новую версию пакета (`myservice.v2`)
-- Поддерживайте старую версию в период миграции
-- Добавляйте уведомления о деприкации
-
-### 4. Игнорирование путей
-Используйте ignore осознанно:
-
-```yaml
-breaking:
-  ignore:
-    - "experimental/**"
-    - "internal/**"
-    - "**/testing/**"
-```
-
-## Частые проблемы
-
-### Проблема: "Repository does not exist"
-Решение: Выполняйте команду внутри Git репозитория с нужной веткой.
-
-### Проблема: "Cannot find git ref"
-Решение: Проверьте наличие ссылки:
-```bash
-git branch -a
-git tag
-```
-
-### Проблема: Ложные срабатывания на сгенерированный код
-Решение: Исключите директории генерации:
-```yaml
-breaking:
-  ignore:
-    - "generated/**"
-    - "**/pb/**"
-```
-
-### Проблема: Очень много изменений
-Решение:
-1. Создайте новую версию API
-2. Вносите изменения постепенно
-3. Используйте feature flags
-
-## Примеры интеграции
-
-### GitHub Actions
-
-```yaml
-name: API Compatibility Check
-
-on:
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  breaking-changes:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          fetch-depth: 0
-      - name: Install EasyP
-        run: |
-          curl -sSfL https://raw.githubusercontent.com/easyp-tech/easyp/main/install.sh | sh
-      - name: Check for breaking changes
-        run: |
-          ./bin/easyp breaking --against origin/main
-```
-
-### GitLab CI
-
-```yaml
-breaking-changes:
-  stage: test
-  image: easyp/lint:latest
-  script:
-    - git fetch origin main
-    - easyp breaking --against origin/main
-  rules:
-    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
-```
-
-### Pre-commit / pre-push hook
-
-```bash
-#!/bin/sh
-# .git/hooks/pre-push
-
-protected_branch='main'
-current_branch=$(git symbolic-ref HEAD | sed -e 's,.*/\(.*\),\1,')
-
-if [ $current_branch = $protected_branch ]; then
-    echo "Running breaking changes check..."
-    easyp breaking --against HEAD~1
-    if [ $? -eq 1 ]; then
-        echo "❌ Breaking changes detected. Push rejected."
-        exit 1
-    fi
-    echo "✅ No breaking changes detected."
-fi
-```
-
-## Troubleshooting
-
-### Режим отладки
-Включите debug‑логирование:
-
-```bash
-easyp --debug breaking --against main
-```
-
-### Ручное сравнение
-Для сложных случаев:
-
-```bash
-git show main:path/to/file.proto > old_version.proto
-easyp lint old_version.proto
-easyp lint current_file.proto
-```
-
-### Оптимизация производительности
-Ограничьте область:
-
-```bash
-easyp breaking --against main --path api/
-```
-
-Механизм обнаружения несовместимых изменений в EasyP обеспечивает надёжную основу для безопасной эволюции protobuf‑схем при сохранении совместимости API.
diff --git a/docs/public/docs/ru-guide/cli/breaking-changes/rules/enum-no-delete.md b/docs/public/docs/ru-guide/cli/breaking-changes/rules/enum-no-delete.md
deleted file mode 100644
index 9e5a6131..00000000
--- a/docs/public/docs/ru-guide/cli/breaking-changes/rules/enum-no-delete.md
+++ /dev/null
@@ -1,319 +0,0 @@
-<!-- TODO: Review translation -->
-
-# ENUM_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что ни один enum не был удалён из proto‑файлов. Удаление enum ломает совместимость по wire‑формату и сгенерированный код: сохранённые данные могут содержать удалённые значения, а клиентский код опирается на сгенерированные типы и константы enum.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-enum UserRole { // [!code --]
-  USER_ROLE_UNSPECIFIED = 0; // [!code --]
-  USER_ROLE_ADMIN = 1; // [!code --]
-  USER_ROLE_USER = 2; // [!code --]
-} // [!code --]
-
-message Order {
-  string id = 1;
-  OrderStatus status = 2;
-  UserRole created_by_role = 3;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-// UserRole enum удалён — BREAKING CHANGE!
-
-message Order {
-  string id = 1;
-  OrderStatus status = 2;
-  UserRole created_by_role = 3; // ERROR: UserRole больше не существует
-}
-```
-
-**Ошибка:**
-```
-user.proto:8:1: Previously present enum "UserRole" was deleted from file. (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Удаление вложенного enum:**
-```proto
-// Before
-message User {
-  string name = 1;
-  Status status = 2;
-  
-  enum Status { // [!code --]
-    STATUS_UNSPECIFIED = 0; // [!code --]
-    STATUS_ACTIVE = 1; // [!code --]
-    STATUS_INACTIVE = 2; // [!code --]
-  } // [!code --]
-}
-
-// After - BREAKING CHANGE!
-message User {
-  string name = 1;
-  Status status = 2;  // ERROR: Status удалён
-  
-  // Вложенный enum Status удалён
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления — пометить enum deprecated:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-enum UserRole {
-  option deprecated = true; // [!code focus]
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMIN = 1;
-  USER_ROLE_USER = 2;
-}
-
-message Order {
-  string id = 1;
-  OrderStatus status = 2;
-  UserRole created_by_role = 3 [deprecated = true]; // [!code focus]
-}
-```
-
-**Или заменить новым enum:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-enum UserRole {
-  option deprecated = true; // [!code focus] // Старый enum
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMIN = 1;
-  USER_ROLE_USER = 2;
-}
-
-enum UserPermission { // [!code focus] // Новый enum
-  USER_PERMISSION_UNSPECIFIED = 0; // [!code focus]
-  USER_PERMISSION_READ = 1; // [!code focus]
-  USER_PERMISSION_WRITE = 2; // [!code focus]
-  USER_PERMISSION_ADMIN = 3; // [!code focus]
-} // [!code focus]
-
-message Order {
-  string id = 1;
-  OrderStatus status = 2;
-  UserRole created_by_role = 3 [deprecated = true]; // [!code focus]
-  UserPermission created_by_permission = 4; // [!code focus]
-}
-```
-
-## Влияние
-
-- **Wire Format:** Данные с удалённым enum не десериализуются корректно
-- **Generated Code:** Тип и константы удаляются — компиляция клиентов ломается
-- **Field References:** Поля с типом удалённого enum становятся невалидны
-- **Switch Statements:** `switch` по enum ломается (неизвестные кейсы)
-
-## Реальный пример
-
-**Код клиента ломается:**
-```go
-// Before
-order := &myapi.Order{
-    Id:            "order123",
-    Status:        myapi.OrderStatus_ORDER_STATUS_PENDING,
-    CreatedByRole: myapi.UserRole_USER_ROLE_ADMIN,  // ERROR после удаления
-}
-
-switch order.CreatedByRole {
-case myapi.UserRole_USER_ROLE_ADMIN:  // ERROR
-    // Admin logic
-case myapi.UserRole_USER_ROLE_USER:   // ERROR
-    // User logic
-}
-
-// undefined: myapi.UserRole
-// undefined: myapi.UserRole_USER_ROLE_ADMIN
-```
-
-**Старые данные становятся нечитаемыми:**
-```json
-{
-  "id": "order123",
-  "status": "ORDER_STATUS_PENDING",
-  "created_by_role": "USER_ROLE_ADMIN"
-}
-// После удаления UserRole — парсер не знает поле created_by_role
-```
-
-**Серверная логика ломается:**
-```go
-func validateOrder(order *Order) error {
-    switch order.CreatedByRole {
-    case UserRole_USER_ROLE_ADMIN:  // ERROR
-        return nil
-    case UserRole_USER_ROLE_USER:   // ERROR
-        return validateUserOrder(order)
-    default:
-        return errors.New("invalid user role")
-    }
-}
-```
-
-## Стратегия миграции
-
-1. **Депрецируйте enum:**
-   ```proto
-   enum OldEnum {
-     option deprecated = true;
-     // ...
-   }
-   ```
-2. **Пометьте поля со старым enum deprecated:**
-   ```proto
-   OldEnum old_field = 5 [deprecated = true];
-   ```
-3. **Создайте новый enum:**
-   ```proto
-   enum NewEnum {
-     // Улучшенный набор значений
-   }
-   NewEnum new_field = 6;
-   ```
-4. **Сервер обрабатывает оба:**
-   ```go
-   func handleRole(oldRole OldEnum, newRole NewEnum) {
-       if newRole != NEW_ENUM_UNSPECIFIED {
-           return handleNewRole(newRole)
-       }
-       return handleOldRole(oldRole)
-   }
-   ```
-5. **Удалите старый enum в следующей major‑версии.**
-
-## Типовые сценарии
-
-### Редизайн enum
-```proto
-enum Priority {
-  option deprecated = true;
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_HIGH = 2;
-}
-
-enum TaskPriority {
-  TASK_PRIORITY_UNSPECIFIED = 0;
-  TASK_PRIORITY_LOW = 1;
-  TASK_PRIORITY_MEDIUM = 2;
-  TASK_PRIORITY_HIGH = 3;
-  TASK_PRIORITY_URGENT = 4;
-}
-```
-
-### Консолидация enum
-```proto
-enum Status {
-  option deprecated = true;
-  STATUS_UNSPECIFIED = 0;
-  STATUS_ACTIVE = 1;
-}
-
-enum State {
-  option deprecated = true;
-  STATE_UNSPECIFIED = 0;
-  STATE_ENABLED = 1;
-}
-
-enum EntityStatus {
-  ENTITY_STATUS_UNSPECIFIED = 0;
-  ENTITY_STATUS_ACTIVE = 1;
-  ENTITY_STATUS_INACTIVE = 2;
-  ENTITY_STATUS_ENABLED = 3;
-  ENTITY_STATUS_DISABLED = 4;
-}
-```
-
-### Перемещение enum в новый пакет
-```proto
-enum UserRole {
-  option deprecated = true;
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMIN = 1;
-}
-
-import "common/roles.proto";
-
-message Order {
-  UserRole old_role = 3 [deprecated = true];
-  common.UserRole new_role = 4;
-}
-```
-
-### Версионирование / новая версия пакета
-```proto
-package myapi.v2;
-
-enum UserPermission {
-  USER_PERMISSION_UNSPECIFIED = 0;
-  USER_PERMISSION_READ = 1;
-  USER_PERMISSION_WRITE = 2;
-  USER_PERMISSION_ADMIN = 3;
-}
-
-message Order {
-  string id = 1;
-  UserPermission created_by_permission = 2;
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/breaking-changes/rules/enum-value-no-delete.md b/docs/public/docs/ru-guide/cli/breaking-changes/rules/enum-value-no-delete.md
deleted file mode 100644
index 6466badd..00000000
--- a/docs/public/docs/ru-guide/cli/breaking-changes/rules/enum-value-no-delete.md
+++ /dev/null
@@ -1,299 +0,0 @@
-<!-- TODO: Review translation -->
-
-# ENUM_VALUE_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Правило проверяет, что ни одно значение enum (enum value) не было удалено. Удаление значения ломает совместимость по wire‑формату и сгенерированный код: в уже сохранённых данных могут присутствовать удалённые значения, а клиентский код может ссылаться на соответствующие константы.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-  ORDER_STATUS_CANCELLED = 5;
-}
-
-enum Priority {
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_MEDIUM = 2;
-  PRIORITY_HIGH = 3;
-  PRIORITY_URGENT = 4;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-  // ORDER_STATUS_CANCELLED = 5; // [!code --] Удалено значение enum — BREAKING!
-}
-
-enum Priority {
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_MEDIUM = 2;
-  PRIORITY_HIGH = 3;
-  // PRIORITY_URGENT = 4; // [!code --] Удалено значение enum — BREAKING!
-}
-```
-
-**Ошибка:**
-```
-order.proto:9:3: Previously present enum value "5" on enum "OrderStatus" was deleted. (BREAKING_CHECK)
-priority.proto:8:3: Previously present enum value "4" on enum "Priority" was deleted. (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Множественное удаление значений:**
-```proto
-// Before
-enum UserRole {
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_GUEST = 1;
-  USER_ROLE_USER = 2;
-  USER_ROLE_MODERATOR = 3;
-  USER_ROLE_ADMIN = 4;
-  USER_ROLE_SUPERADMIN = 5;
-}
-
-// After - BREAKING CHANGES!
-enum UserRole {
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_USER = 2;
-  USER_ROLE_ADMIN = 4;
-  // USER_ROLE_GUEST = 1;      // BREAKING: deleted
-  // USER_ROLE_MODERATOR = 3;  // BREAKING: deleted
-  // USER_ROLE_SUPERADMIN = 5; // BREAKING: deleted
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления — пометить значения deprecated:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-  ORDER_STATUS_CANCELLED = 5 [deprecated = true]; // [!code focus]
-}
-
-enum Priority {
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_MEDIUM = 2;
-  PRIORITY_HIGH = 3;
-  PRIORITY_URGENT = 4 [deprecated = true]; // [!code focus]
-}
-```
-
-**Или зарезервировать номер и имя после удаления:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  reserved 5; // [!code focus]
-  reserved "ORDER_STATUS_CANCELLED"; // [!code focus]
-
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-
-enum Priority {
-  reserved 4; // [!code focus]
-  reserved "PRIORITY_URGENT"; // [!code focus]
-
-  PRIORITY_UNSPECIFIED = 0;
-  PRIORITY_LOW = 1;
-  PRIORITY_MEDIUM = 2;
-  PRIORITY_HIGH = 3;
-}
-```
-
-## Влияние
-
-- **Wire Format:** Данные с удалёнными значениями не десериализуются корректно
-- **Generated Code:** Константы исчезают — клиентский код не компилируется
-- **Client Applications:** Ссылки на удалённые значения вызывают ошибки компиляции
-- **Switch Statements:** `switch` по enum ломается (неизвестные case)
-- **Default Handling:** Поведение при неизвестных значениях меняется
-
-## Реальный пример
-
-**Код клиента ломается:**
-```go
-order := &myapi.Order{
-    Status: myapi.OrderStatus_ORDER_STATUS_CANCELLED, // ERROR после удаления
-}
-
-switch order.Status {
-case myapi.OrderStatus_ORDER_STATUS_PENDING:
-    // Pending
-case myapi.OrderStatus_ORDER_STATUS_CANCELLED: // ERROR: undefined
-    // Cancellation
-default:
-    // Unknown
-}
-// undefined: myapi.OrderStatus_ORDER_STATUS_CANCELLED
-```
-
-**Проблемы с уже сохранёнными данными:**
-```json
-{
-  "id": "order123",
-  "status": "ORDER_STATUS_CANCELLED"
-}
-// После удаления: парсер даёт UNSPECIFIED (0) или ошибку
-```
-
-**Валидация на сервере:**
-```go
-func validateOrderStatus(status OrderStatus) error {
-    switch status {
-    case OrderStatus_ORDER_STATUS_PENDING,
-         OrderStatus_ORDER_STATUS_CONFIRMED,
-         OrderStatus_ORDER_STATUS_SHIPPED,
-         OrderStatus_ORDER_STATUS_DELIVERED,
-         OrderStatus_ORDER_STATUS_CANCELLED: // ERROR после удаления
-        return nil
-    default:
-        return errors.New("invalid order status")
-    }
-}
-
-func canModifyOrder(order *Order) bool {
-    return order.Status != OrderStatus_ORDER_STATUS_CANCELLED // ERROR
-}
-```
-
-## Стратегия миграции
-
-1. **Сначала пометить deprecated:**
-   ```proto
-   ORDER_STATUS_CANCELLED = 5 [deprecated = true];
-   ```
-2. **Перестать использовать deprecated значение в новом коде:**
-   ```go
-   order.Status = OrderStatus_ORDER_STATUS_DELIVERED
-   ```
-3. **Обработка legacy в клиенте:**
-   ```go
-   switch order.Status {
-   case OrderStatus_ORDER_STATUS_CANCELLED:
-       log.Warn("Legacy cancelled status")
-       // Дополнительная логика
-   }
-   ```
-4. **Резервирование после миграции:**
-   ```proto
-   reserved 5, "ORDER_STATUS_CANCELLED";
-   ```
-5. **Никогда не переиспользовать номера** — зарезервированы навсегда.
-
-## Типовые сценарии
-
-### Изменения бизнес‑логики
-```proto
-enum ProductStatus {
-  PRODUCT_STATUS_UNSPECIFIED = 0;
-  PRODUCT_STATUS_ACTIVE = 1;
-  PRODUCT_STATUS_INACTIVE = 2;
-  PRODUCT_STATUS_DISCONTINUED = 3 [deprecated = true];
-}
-```
-
-### Упрощение workflow
-```proto
-enum TaskStatus {
-  TASK_STATUS_UNSPECIFIED = 0;
-  TASK_STATUS_TODO = 1;
-  TASK_STATUS_IN_PROGRESS = 2;
-  TASK_STATUS_IN_REVIEW = 3 [deprecated = true];
-  TASK_STATUS_APPROVED = 4 [deprecated = true];
-  TASK_STATUS_DONE = 5;
-}
-```
-
-### Объединение enum
-```proto
-enum NotificationLevel {
-  NOTIFICATION_LEVEL_UNSPECIFIED = 0;
-  NOTIFICATION_LEVEL_INFO = 1;
-  NOTIFICATION_LEVEL_WARNING = 2;
-  NOTIFICATION_LEVEL_ERROR = 3;
-  NOTIFICATION_LEVEL_DEBUG = 4 [deprecated = true];
-  NOTIFICATION_LEVEL_TRACE = 5 [deprecated = true];
-}
-```
-
-## Особенности wire‑формата
-
-### Предотвращение переиспользования номера
-```proto
-enum Status {
-  reserved 2;
-  reserved "STATUS_DELETED";
-
-  STATUS_UNSPECIFIED = 0;
-  STATUS_ACTIVE = 1;
-  STATUS_INACTIVE = 3;
-  // STATUS_DELETED = 2; // Не переиспользуем
-}
-```
-
-### JSON совместимость
-```proto
-enum Color {
-  reserved 2;
-  reserved "RED";
-
-  COLOR_UNSPECIFIED = 0;
-  COLOR_BLUE = 1;
-  COLOR_GREEN = 3;
-  // COLOR_RED = 2; // Был удалён
-}
-```
-
-### Proto2 vs Proto3
-```proto
-enum MyEnum {
-  MY_ENUM_UNSPECIFIED = 0;
-  MY_ENUM_VALUE_OLD = 1 [deprecated = true];
-  MY_ENUM_VALUE_NEW = 2;
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/breaking-changes/rules/enum-value-same-name.md b/docs/public/docs/ru-guide/cli/breaking-changes/rules/enum-value-same-name.md
deleted file mode 100644
index f45ee254..00000000
--- a/docs/public/docs/ru-guide/cli/breaking-changes/rules/enum-value-same-name.md
+++ /dev/null
@@ -1,172 +0,0 @@
-<!-- TODO: Review translation -->
-
-# ENUM_VALUE_SAME_NAME
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что имя enum значения для каждого номера (number) не изменилось. Переименование enum значения при сохранении его номера ломает совместимость JSON и сгенерированный код: клиенты ожидают конкретные имена констант.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2;
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_APPROVED = 2; // [!code --] Было ORDER_STATUS_CONFIRMED
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_COMPLETED = 4; // [!code --] Было ORDER_STATUS_DELIVERED
-}
-```
-
-**Ошибка:**
-```
-order.proto:7:3: Enum value "2" on enum "OrderStatus" changed name from "ORDER_STATUS_CONFIRMED" to "ORDER_STATUS_APPROVED". (BREAKING_CHECK)
-order.proto:9:3: Enum value "4" on enum "OrderStatus" changed name from "ORDER_STATUS_DELIVERED" to "ORDER_STATUS_COMPLETED". (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Множественные переименования:**
-```proto
-// Before
-enum UserRole {
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMIN = 1;
-  USER_ROLE_MODERATOR = 2;
-  USER_ROLE_USER = 3;
-}
-
-// After - ВСЁ BREAKING
-enum UserRole {
-  USER_ROLE_UNSPECIFIED = 0;
-  USER_ROLE_ADMINISTRATOR = 1;  // BREAKING: ADMIN -> ADMINISTRATOR
-  USER_ROLE_MOD = 2;            // BREAKING: MODERATOR -> MOD
-  USER_ROLE_MEMBER = 3;         // BREAKING: USER -> MEMBER
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо переименования — добавить новые значения и пометить старые deprecated:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_CONFIRMED = 2 [deprecated = true]; // [!code focus]
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_DELIVERED = 4 [deprecated = true]; // [!code focus]
-  ORDER_STATUS_APPROVED = 5; // [!code focus] // Новое значение вместо переименования
-  ORDER_STATUS_COMPLETED = 6; // [!code focus]
-}
-```
-
-**Или создать новую версию enum:**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus]
-
-enum OrderStatus {
-  ORDER_STATUS_UNSPECIFIED = 0;
-  ORDER_STATUS_PENDING = 1;
-  ORDER_STATUS_APPROVED = 2; // [!code focus] // «Чистые» имена в v2
-  ORDER_STATUS_SHIPPED = 3;
-  ORDER_STATUS_COMPLETED = 4; // [!code focus]
-}
-```
-
-## Влияние
-
-- **Generated Code:** Меняются имена констант — компиляция клиентов ломается
-- **JSON Compatibility:** JSON использует имена enum — старые документы не парсятся
-- **Client Applications:** Код со старым именем константы не компилируется
-- **Documentation:** Документация устаревает с неправильными именами
-
-## Реальный пример
-
-**Ломается код клиента:**
-```go
-// Before
-status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED
-if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED {
-    // handle delivery
-}
-
-// After (переименовано) — ошибки компиляции
-status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED  // ERROR: undefined
-if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // ERROR: undefined
-    // handle delivery
-}
-```
-
-**JSON совместимость ломается:**
-```json
-// Раньше
-{
-  "status": "ORDER_STATUS_CONFIRMED"
-}
-
-// После
-{
-  "status": "ORDER_STATUS_APPROVED" // Старые JSON больше не парсятся
-}
-```
-
-## Стратегия миграции
-
-1. **Добавьте новое значение вместо переименования:**
-   ```proto
-   ORDER_STATUS_CONFIRMED = 2 [deprecated = true];
-   ORDER_STATUS_APPROVED = 5;
-   ```
-
-2. **Сервер обрабатывает оба значения на переходном этапе**
-3. **Мигрируйте клиентов** на новые значения
-4. **Удалите (reserve) старое имя и номер** в следующей major‑версии:
-   ```proto
-   reserved 2, "ORDER_STATUS_CONFIRMED";
-   ORDER_STATUS_APPROVED = 5;
-   ```
-
-## Allow Alias (исключение)
-
-С `allow_alias = true` можно временно иметь два имени для одного номера:
-
-```proto
-enum Status {
-  option allow_alias = true;
-  STATUS_UNSPECIFIED = 0;
-  STATUS_OLD_NAME = 1 [deprecated = true];
-  STATUS_NEW_NAME = 1; // Один номер, два имени
-}
-```
-
-Примечание: Сейчас EasyP всё равно считает это breaking (может измениться в будущем).
diff --git a/docs/public/docs/ru-guide/cli/breaking-changes/rules/field-no-delete.md b/docs/public/docs/ru-guide/cli/breaking-changes/rules/field-no-delete.md
deleted file mode 100644
index 63419210..00000000
--- a/docs/public/docs/ru-guide/cli/breaking-changes/rules/field-no-delete.md
+++ /dev/null
@@ -1,102 +0,0 @@
-<!-- TODO: Review translation -->
-
-# FIELD_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что ни одно поле сообщения (message field) не было удалено. Удаление поля ломает совместимость по wire‑формату и сгенерированный код: в существующих данных может присутствовать удалённое поле, а клиентский код может ссылаться на него.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-  string phone = 4; // [!code --]
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-  // phone поле удалено — BREAKING CHANGE!
-}
-```
-
-**Ошибка:**
-```
-user.proto:6:3: Previously present field "4" with name "phone" on message "User" was deleted. (BREAKING_CHECK)
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления — пометить поле deprecated:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-  string phone = 4 [deprecated = true]; // [!code focus]
-}
-```
-
-**Или зарезервировать номер и имя поля после удаления:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  reserved 4; // [!code focus]
-  reserved "phone"; // [!code focus]
-  
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-}
-```
-
-## Влияние
-
-- **Wire Format:** Старые сообщения с удалённым полем некорректно десериализуются
-- **Generated Code:** Удаляются аксессоры (get/set), компиляция клиента ломается
-- **Data Loss:** Потеря сохранённых данных, связанных с полем
-- **JSON Compatibility:** JSON парсеры ожидают наличие поля и могут выдавать ошибки
-
-## Стратегия миграции
-
-1. **Сначала пометить deprecated:**
-   ```proto
-   string old_field = 5 [deprecated = true];
-   ```
-
-2. **Прекратить запись в поле** в прикладном коде
-
-3. **Зарезервировать поле** в следующей версии, чтобы избежать повторного использования:
-   ```proto
-   reserved 5;
-   reserved "old_field";
-   ```
-
-4. **Никогда не переиспользовать номер поля** — должен оставаться в reserved навсегда
\ No newline at end of file
diff --git a/docs/public/docs/ru-guide/cli/breaking-changes/rules/field-same-cardinality.md b/docs/public/docs/ru-guide/cli/breaking-changes/rules/field-same-cardinality.md
deleted file mode 100644
index 753c778c..00000000
--- a/docs/public/docs/ru-guide/cli/breaking-changes/rules/field-same-cardinality.md
+++ /dev/null
@@ -1,282 +0,0 @@
-<!-- TODO: Review translation -->
-
-# FIELD_SAME_CARDINALITY
-
-Категории:
-
-- **WIRE+**
-
-Правило проверяет, что поля сообщений сохраняют ту же кардинальность (обязательность / optional). Изменение кардинальности поля ломает совместимость по wire‑формату и сгенерированный код: семантика присутствия и ожидания клиентского кода отличаются для optional и required (implicit) полей.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  int32 age = 3;
-}
-
-message CreateUserRequest {
-  string name = 1;
-  optional string email = 2;
-  string phone = 3;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  optional string email = 2; // [!code --] Было required (implicit), стало optional
-  int32 age = 3;
-}
-
-message CreateUserRequest {
-  string name = 1;
-  string email = 2; // [!code --] Было optional, стало требуемым (implicit required)
-  string phone = 3;
-}
-```
-
-**Ошибка:**
-```
-user.proto:6:3: Field "2" with name "email" on message "User" became optional. (BREAKING_CHECK)
-request.proto:7:3: Field "2" with name "email" on message "CreateUserRequest" became not optional. (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Проблемы миграции Proto2 → Proto3:**
-
-```proto
-// Before (proto2)
-syntax = "proto2";
-
-message Order {
-  required string id = 1;
-  optional string notes = 2;
-  repeated string tags = 3;
-}
-
-// After (proto3) - BREAKING CHANGES!
-syntax = "proto3";
-
-message Order {
-  string id = 1;           // BREAKING: required -> implicit optional
-  string notes = 2;        // BREAKING: explicit optional -> implicit optional
-  repeated string tags = 3; // OK
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо изменения кардинальности — добавьте новое поле:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2 [deprecated = true]; // [!code focus] Сохраняем старую кардинальность
-  int32 age = 3;
-  optional string email_optional = 4; // [!code focus] Новое optional поле
-}
-
-message CreateUserRequest {
-  string name = 1;
-  optional string email = 2 [deprecated = true]; // [!code focus]
-  string phone = 3;
-  string email_required = 4; // [!code focus] Новое требуемое поле
-}
-```
-
-**Или создайте новую версию сообщения:**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus]
-
-message User {
-  string name = 1;
-  optional string email = 2; // [!code focus] Чистая модель в v2
-  int32 age = 3;
-}
-
-message CreateUserRequest {
-  string name = 1;
-  string email = 2; // [!code focus] Требуемое в v2
-  string phone = 3;
-}
-```
-
-## Влияние
-
-- **Wire Format:** Меняется семантика присутствия — клиенты неправильно ожидают поля
-- **Generated Code:** Меняются методы доступа / проверки (has, clear)
-- **Validation:** Правила проверки обязательности переписываются
-- **Default Values:** Optional и required по‑разному обрабатывают отсутствие значения
-
-## Реальный пример
-
-**Код клиента ломается при смене кардинальности:**
-```go
-// Before - поле фактически требуется (implicit)
-user := &myapi.User{
-    Name:  "John",
-    Email: "john@example.com",
-    Age:   30,
-}
-
-if user.Email != "" {
-    // Есть значение
-}
-
-// After - поле стало optional (pointer)
-user := &myapi.User{
-    Name: "John",
-    Age:  30,
-    // Email может отсутствовать
-}
-
-if user.Email != nil && *user.Email != "" {
-    // Есть значение (новый способ)
-}
-
-user.Email = &emailValue // Присваивание указателя вместо строки
-```
-
-**Валидация на сервере:**
-```go
-// Before
-func validateUser(user *User) error {
-    if user.Email == "" {
-        return errors.New("email is required")
-    }
-    return nil
-}
-
-// After
-func validateUser(user *User) error {
-    if user.Email == nil {
-        return errors.New("email is required")
-    }
-    if *user.Email == "" {
-        return errors.New("email cannot be empty")
-    }
-    return nil
-}
-```
-
-## Стратегия миграции
-
-1. **Добавьте новое поле** с нужной кардинальностью:
-   ```proto
-   string old_email = 2 [deprecated = true];
-   optional string new_email = 5;
-   ```
-
-2. **Период двойной записи** — заполняйте оба поля:
-   ```go
-   user := &User{
-       Name:     "John",
-       OldEmail: email,
-       NewEmail: &email,
-   }
-   ```
-
-3. **Клиенты постепенно переходят**:
-   ```go
-   email := user.NewEmail
-   if email == nil && user.OldEmail != "" {
-       v := user.OldEmail
-       email = &v
-   }
-   ```
-
-4. **Удаление старого поля** в следующей major‑версии:
-   ```proto
-   reserved 2, "old_email";
-   optional string new_email = 5;
-   ```
-
-## Типовые сценарии
-
-### Миграция Proto2 → Proto3
-```proto
-syntax = "proto3";
-message Order {
-  string id = 1; // BREAKING если был required
-}
-
-// Сохранить семантику:
-syntax = "proto3";
-message Order {
-  string id = 1;
-  optional string notes = 2;
-}
-```
-
-### Делать optional поле required
-```proto
-message CreateUserRequest {
-  string name = 1;
-  string email = 2; // BREAKING (раньше optional)
-}
-
-message CreateUserRequest {
-  string name = 1;
-  optional string email = 2 [deprecated = true];
-  string required_email = 3;
-}
-```
-
-### Делать required поле optional
-```proto
-message User {
-  optional string phone = 3; // BREAKING (было implicit required)
-}
-
-message User {
-  string phone = 3 [deprecated = true];
-  optional string phone_optional = 4;
-}
-```
-
-## Типы кардинальности в Protobuf
-
-### Proto3
-- **Implicit optional**: `string name = 1;`
-- **Explicit optional**: `optional string email = 2;`
-- **Repeated**: `repeated string tags = 3;`
-- **Map**: `map<string, string> metadata = 4;`
-
-### Proto2
-- **Required**: `required string id = 1;`
-- **Optional**: `optional string email = 2;`
-- **Repeated**: `repeated string tags = 3;`
-
-### Матрица Breaking изменений
-
-| From | To | Result |
-|------|----|--------|
-| Required | Optional | ❌ BREAKING |
-| Optional | Required | ❌ BREAKING |
-| Implicit | Explicit | ❌ BREAKING |
-| Explicit | Implicit | ❌ BREAKING |
-| Single | Repeated | ❌ BREAKING |
-| Repeated | Single | ❌ BREAKING |
-| Field | Map | ❌ BREAKING |
-| Map | Field | ❌ BREAKING |
\ No newline at end of file
diff --git a/docs/public/docs/ru-guide/cli/breaking-changes/rules/field-same-type.md b/docs/public/docs/ru-guide/cli/breaking-changes/rules/field-same-type.md
deleted file mode 100644
index 05b7ee85..00000000
--- a/docs/public/docs/ru-guide/cli/breaking-changes/rules/field-same-type.md
+++ /dev/null
@@ -1,153 +0,0 @@
-<!-- TODO: Review translation -->
-
-# FIELD_SAME_TYPE
-
-Категории:
-
-- **WIRE+**
-
-Правило проверяет, что типы полей сообщений (message fields) не изменяются. Смена типа поля ломает совместимость по wire‑формату и сгенерированный код: бинарное представление и ожидания клиентского кода различаются для разных типов.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message Product {
-  string name = 1;
-  int32 price = 2;
-  bool available = 3;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message Product {
-  string name = 1;
-  string price = 2; // [!code --] Changed from int32 to string (изменён тип)
-  bool available = 3;
-}
-```
-
-**Ошибка:**
-```
-product.proto:5:3: Field "2" with name "price" on message "Product" changed type from "int32" to "string". (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Несовместимые изменения типов:**
-```proto
-// Before
-message Order {
-  string id = 1;
-  int64 timestamp = 2;
-  repeated string tags = 3;
-  OrderStatus status = 4;
-}
-
-// After - ВСЁ BREAKING
-message Order {
-  int32 id = 1;           // string -> int32: BREAKING
-  string timestamp = 2;   // int64 -> string: BREAKING
-  string tags = 3;        // repeated -> singular: BREAKING
-  int32 status = 4;       // enum -> int32: BREAKING
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо смены типа — добавьте новое поле:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message Product {
-  string name = 1;
-  int32 price = 2 [deprecated = true]; // [!code focus] // Старое поле помечено deprecated
-  bool available = 3;
-  string price_formatted = 4; // [!code focus] // Новое поле со строковым представлением
-}
-```
-
-**Или создайте новую версию сообщения:**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus] // Новая версия package
-
-message Product {
-  string name = 1;
-  string price = 2; // [!code focus] // В v2 уже string
-  bool available = 3;
-}
-```
-
-## Влияние
-
-- **Wire Format:** Старые бинарные данные не десериализуются корректно
-- **Generated Code:** Меняются типы в сгенерированном коде — клиенты не компилируются
-- **Runtime Errors:** Ошибки парсинга при несовпадении ожидаемого типа
-- **Data Corruption:** Неверная интерпретация байтов данных
-
-## Типовые проблемы изменений типов
-
-### Числовые типы
-```proto
-// BREAKING: различное кодирование/семантика
-int32 -> int64    // Иное кодирование
-int32 -> uint32   // Меняется знак
-int32 -> string   // Совсем другой формат
-```
-
-### Коллекции
-```proto
-// BREAKING: изменяется структура
-string -> repeated string              // Одиночное -> коллекция
-repeated int32 -> map<string, int32>   // Массив -> map
-```
-
-### Message типы
-```proto
-// BREAKING: другая структура сообщения
-UserInfo -> UserProfile  // Совершенно разные сообщения
-string -> UserInfo       // Скаляр -> сообщение
-```
-
-## Стратегия миграции
-
-1. **Добавьте новое поле** с нужным типом:
-   ```proto
-   int32 old_price = 2 [deprecated = true];
-   string new_price = 5; // Новое поле
-   ```
-
-2. **Период двойной записи** — заполняйте оба поля для совместимости
-
-3. **Мигрируйте клиентов** на новое поле постепенно
-
-4. **Удалите старое поле** в следующей major‑версии:
-   ```proto
-   reserved 2, "old_price";
-   string new_price = 5;
-   ```
-
-## Безопасные изменения (Теоретически wire‑совместимые)
-
-Примечание: EasyP сейчас считает ЛЮБУЮ смену типа breaking. Однако технически некоторые случаи совместимы:
-
-- `int32` ↔ `uint32` (одно кодирование)
-- `int64` ↔ `uint64` (одно кодирование)
-- `string` → `bytes` (если все строки валидный UTF‑8)
-
-Эти исключения могут получить отдельную обработку в будущих версиях EasyP с более гибкими уровнями строгости.
\ No newline at end of file
diff --git a/docs/public/docs/ru-guide/cli/breaking-changes/rules/import-no-delete.md b/docs/public/docs/ru-guide/cli/breaking-changes/rules/import-no-delete.md
deleted file mode 100644
index 297309eb..00000000
--- a/docs/public/docs/ru-guide/cli/breaking-changes/rules/import-no-delete.md
+++ /dev/null
@@ -1,357 +0,0 @@
-<!-- TODO: Review translation -->
-
-# IMPORT_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что ни одна инструкция `import` не была удалена из proto‑файла. Удаление import ломает совместимость по wire‑формату и сгенерированный код: типы из импортируемых файлов могли использоваться в текущем файле, и их удаление делает эти типы недоступными.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-import "google/protobuf/timestamp.proto";
-import "google/protobuf/duration.proto";
-import "common/user.proto";
-import "common/address.proto";
-
-message Order {
-  string id = 1;
-  google.protobuf.Timestamp created_at = 2;
-  google.protobuf.Duration processing_time = 3;
-  common.User customer = 4;
-  common.Address shipping_address = 5;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-import "google/protobuf/timestamp.proto";
-// import "google/protobuf/duration.proto";  // [!code --] Удалён import — BREAKING
-// import "common/user.proto";               // [!code --] Удалён import — BREAKING
-// import "common/address.proto";            // [!code --] Удалён import — BREAKING
-
-message Order {
-  string id = 1;
-  google.protobuf.Timestamp created_at = 2;
-  google.protobuf.Duration processing_time = 3;  // ERROR: Duration недоступен
-  common.User customer = 4;                      // ERROR: User недоступен
-  common.Address shipping_address = 5;           // ERROR: Address недоступен
-}
-```
-
-**Ошибка:**
-```
-order.proto:5:1: Previously import "google/protobuf/duration.proto" was deleted. (BREAKING_CHECK)
-order.proto:6:1: Previously import "common/user.proto" was deleted. (BREAKING_CHECK)
-order.proto:7:1: Previously import "common/address.proto" was deleted. (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Сервис ломается при удалённых import:**
-```proto
-// Before
-import "google/api/annotations.proto";
-import "google/protobuf/empty.proto";
-import "common/auth.proto";
-
-service OrderService {
-  rpc GetOrder(GetOrderRequest) returns (Order) {
-    option (google.api.http) = {
-      get: "/v1/orders/{id}"
-    };
-  }
-  
-  rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty);
-}
-
-// After - BREAKING CHANGES!
-// import "google/api/annotations.proto";    // BREAKING: deleted
-// import "google/protobuf/empty.proto";     // BREAKING: deleted
-// import "common/auth.proto";               // BREAKING: deleted
-
-service OrderService {
-  rpc GetOrder(GetOrderRequest) returns (Order) {
-    option (google.api.http) = {  // ERROR: annotations недоступен
-      get: "/v1/orders/{id}"
-    };
-  }
-  
-  rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty);  // ERROR: типы недоступны
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления оставьте неиспользуемые import:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-import "google/protobuf/timestamp.proto";
-import "google/protobuf/duration.proto";  // [!code focus] // Оставляем даже если не используется
-import "common/user.proto";               // [!code focus]
-import "common/address.proto";            // [!code focus]
-
-message Order {
-  string id = 1;
-  google.protobuf.Timestamp created_at = 2;
-  // Поля, использовавшие Duration/User/Address, удалены — import оставлены
-}
-```
-
-**Или добавьте новые типы, сохранив старые import:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-import "google/protobuf/timestamp.proto";
-import "google/protobuf/duration.proto";  // [!code focus]
-import "common/user.proto";               // [!code focus]
-import "common/address.proto";            // [!code focus]
-import "common/v2/user.proto";            // [!code focus] // Новый import
-
-message Order {
-  string id = 1;
-  google.protobuf.Timestamp created_at = 2;
-  google.protobuf.Duration processing_time = 3 [deprecated = true]; // [!code focus]
-  common.User customer = 4 [deprecated = true];                     // [!code focus]
-  common.Address shipping_address = 5 [deprecated = true];          // [!code focus]
-  
-  int32 processing_seconds = 6;
-  common.v2.UserProfile customer_v2 = 7;
-  string shipping_address_text = 8;
-}
-```
-
-## Влияние
-
-- **Generated Code:** Типы пропадают → ошибка компиляции
-- **Wire Format:** Сообщения с удалёнными типами не десериализуются
-- **Field References:** Поля с этими типами становятся невалидны
-- **Service Definitions:** RPC с типами из удалённых файлов ломаются
-- **Options Usage:** Пользовательские опции из импортов недоступны
-
-## Реальный пример
-
-**Код клиента ломается:**
-```go
-order := &myapi.Order{
-    Id:        "order123",
-    CreatedAt: timestamppb.New(time.Now()),
-    Customer: &common.User{          // ERROR после удаления import
-        Id:   "user456",
-        Name: "John Doe",
-    },
-    ShippingAddress: &common.Address{ // ERROR после удаления import
-        Street: "123 Main St",
-        City:   "New York",
-    },
-}
-// undefined: common.User
-// undefined: common.Address
-```
-
-**Серверная логика ломается:**
-```go
-func (s *server) CreateOrder(ctx context.Context, req *CreateOrderRequest) (*Order, error) {
-    return &Order{
-        Id:        generateOrderId(),
-        CreatedAt: timestamppb.New(time.Now()),
-        Customer: &common.User{          // ERROR
-            Id:   req.CustomerId,
-            Name: req.CustomerName,
-        },
-        ShippingAddress: &common.Address{ // ERROR
-            Street: req.ShippingStreet,
-            City:   req.ShippingCity,
-        },
-    }, nil
-}
-```
-
-**Компиляция proto ломается:**
-```bash
-$ protoc --go_out=. order.proto
-order.proto:8:3: "common.User" is not defined.
-order.proto:9:3: "common.Address" is not defined.
-order.proto:10:3: "google.protobuf.Duration" is not defined.
-```
-
-## Стратегия миграции
-
-1. Сохраняйте import даже если типы более не используются:
-   ```proto
-   import "common/user.proto"; // Оставить
-   ```
-2. Добавляйте новые import рядом со старыми:
-   ```proto
-   import "common/user.proto";
-   import "common/v2/user.proto";
-   ```
-3. Депрецируйте поля со старыми типами постепенно:
-   ```proto
-   message Order {
-     common.User customer = 4 [deprecated = true];
-     common.v2.UserProfile customer_v2 = 5;
-   }
-   ```
-4. Сервер: поддерживайте оба варианта:
-   ```go
-   if req.CustomerProfileV2 != nil { order.CustomerV2 = req.CustomerProfileV2; return order }
-   if req.CustomerProfile != nil { order.Customer = req.CustomerProfile }
-   ```
-5. Удаляйте import только в следующей major‑версии после полной миграции.
-
-## Типовые сценарии
-
-### Замена зависимости
-```proto
-import "old/user.proto";    // Старый
-import "new/user.proto";    // Новый
-
-message Order {
-  old.User customer = 4 [deprecated = true];
-  new.UserProfile customer_v2 = 5;
-}
-```
-
-### Удаление функционала
-```proto
-import "feature/analytics.proto"; // Оставить даже если поле удалено
-
-message Order {
-  string id = 1;
-  // feature.AnalyticsData analytics = 2; // Поле удалено, import остаётся
-}
-```
-
-### Миграция версии protobuf
-```proto
-import "google/protobuf/timestamp.proto";
-import "google/protobuf/duration.proto";
-
-message Event {
-  google.protobuf.Timestamp timestamp = 1;
-  int64 timestamp_millis = 2;
-}
-```
-
-### Упрощение сложных зависимостей
-```proto
-import "complex/config.proto";
-
-message Settings {
-  complex.ConfigData config = 1 [deprecated = true];
-  string config_json = 2;
-}
-```
-
-## Категории import и влияние
-
-### Стандартные Google imports
-```proto
-import "google/protobuf/timestamp.proto";
-import "google/protobuf/duration.proto";
-import "google/protobuf/empty.proto";
-import "google/api/annotations.proto";
-```
-
-### Общие библиотечные imports
-```proto
-import "common/user.proto";
-import "common/address.proto";
-import "common/money.proto";
-```
-
-### Фичевые imports
-```proto
-import "features/analytics.proto";
-import "features/logging.proto";
-import "internal/debug.proto";
-```
-
-## Особенности wire‑формата
-
-### Удаление import vs использование поля
-```proto
-import "common/enums.proto";
-message Order {
-  oneof payment {
-    CreditCardPayment card = 1;
-  }
-}
-```
-
-### Транзитивные зависимости
-```proto
-import "user.proto";
-message Order {
-  PaymentInfo payment = 1;
-}
-```
-
-### JSON сериализация
-```proto
-import "google/protobuf/field_mask.proto";
-message UpdateRequest {
-  google.protobuf.FieldMask update_mask = 1;
-}
-```
-
-## Профилактика
-
-### Аудит import
-```bash
-grep -r "google.protobuf.Duration" *.proto
-grep -r "common.User" *.proto
-```
-(Даже если не найдено — не удаляем.)
-
-### Настройка линтера
-```yaml
-lint:
-  ignore:
-    - IMPORT_UNUSED
-```
-
-### Документация
-```proto
-import "legacy/types.proto";  // Для обратной совместимости
-import "common/user.proto";   // Требуется для уже сохранённых данных
-```
-
-## Import vs удаление поля
-
-### Разные типы breaking
-```proto
-// import "user.proto"; // BREAKING: удалён import
-message Order {
-  string id = 1;
-  // User customer = 2; // BREAKING: удалено поле
-}
-```
-
-### Составные нарушения
-```proto
-// import "user.proto"; // BREAKING
-message Order {
-  string id = 1;
-  // User customer = 2; // BREAKING
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/breaking-changes/rules/message-no-delete.md b/docs/public/docs/ru-guide/cli/breaking-changes/rules/message-no-delete.md
deleted file mode 100644
index 05b17321..00000000
--- a/docs/public/docs/ru-guide/cli/breaking-changes/rules/message-no-delete.md
+++ /dev/null
@@ -1,240 +0,0 @@
-<!-- TODO: Review translation -->
-
-# MESSAGE_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что ни одно сообщение (message) не было удалено из proto‑файлов. Удаление message ломает совместимость по wire‑формату и сгенерированный код: в существующих данных могут присутствовать экземпляры удалённого типа, а клиентский код зависит от сгенерированных структур и классов.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  Address address = 3;
-}
-
-message Address { // [!code --]
-  string street = 1; // [!code --]
-  string city = 2; // [!code --]
-  string country = 3; // [!code --]
-} // [!code --]
-
-message Order {
-  string id = 1;
-  User user = 2;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  Address address = 3;  // ERROR: Address больше не существует
-}
-
-// Address удалён — BREAKING CHANGE!
-
-message Order {
-  string id = 1;
-  User user = 2;
-}
-```
-
-**Ошибка:**
-```
-user.proto:8:1: Previously present message "Address" was deleted from file. (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Удаление вложенного сообщения:**
-
-```proto
-// Before
-message User {
-  string name = 1;
-  Profile profile = 2;
-  
-  message Profile { // [!code --]
-    string bio = 1; // [!code --]
-    string avatar_url = 2; // [!code --]
-  } // [!code --]
-}
-
-// After - BREAKING CHANGE!
-message User {
-  string name = 1;
-  Profile profile = 2;  // ERROR: Profile удалён
-  
-  // Вложенное сообщение Profile удалено
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления — пометить как deprecated:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  Address address = 3 [deprecated = true]; // [!code focus]
-}
-
-message Address {
-  option deprecated = true; // [!code focus]
-  string street = 1;
-  string city = 2;
-  string country = 3;
-}
-
-message Order {
-  string id = 1;
-  User user = 2;
-}
-```
-
-**Или заменить новой версией сообщения:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message User {
-  string name = 1;
-  string email = 2;
-  Address address = 3 [deprecated = true]; // [!code focus] // Старое поле
-  AddressV2 address_v2 = 4; // [!code focus] // Новая улучшенная структура
-}
-
-message Address {
-  option deprecated = true; // [!code focus]
-  string street = 1;
-  string city = 2;
-  string country = 3;
-}
-
-message AddressV2 { // [!code focus]
-  string street_address = 1; // [!code focus]
-  string city = 2; // [!code focus]
-  string state = 3; // [!code focus]
-  string postal_code = 4; // [!code focus]
-  string country = 5; // [!code focus]
-} // [!code focus]
-
-message Order {
-  string id = 1;
-  User user = 2;
-}
-```
-
-## Влияние
-
-- **Wire Format:** Старые данные с удалённым сообщением не десериализуются
-- **Generated Code:** Классы/структуры удаляются — компиляция клиента ломается
-- **Field References:** Поля, использующие удалённый тип, становятся невалидны
-- **Nested Dependencies:** Все сообщения, ссылающиеся на удалённый тип, ломаются
-
-## Реальный пример
-
-**Код клиента ломается:**
-```go
-// Before
-user := &myapi.User{
-    Name:  "John Doe",
-    Email: "john@example.com",
-    Address: &myapi.Address{  // ERROR после удаления
-        Street:  "123 Main St",
-        City:    "New York",
-        Country: "USA",
-    },
-}
-
-// undefined: myapi.Address
-```
-
-**Старые данные становятся нечитаемыми:**
-```json
-{
-  "name": "John Doe",
-  "email": "john@example.com",
-  "address": {
-    "street": "123 Main St",
-    "city": "New York",
-    "country": "USA"
-  }
-}
-// После удаления Address: парсер не знает поле address
-```
-
-## Стратегия миграции
-
-1. **Пометить как deprecated:**
-   ```proto
-   message OldMessage {
-     option deprecated = true;
-     // ... fields
-   }
-   ```
-2. **Пометить поля, использующие его:**
-   ```proto
-   OldMessage old_data = 5 [deprecated = true];
-   ```
-3. **Добавить замену при необходимости:**
-   ```proto
-   NewMessage new_data = 6;
-   ```
-4. **Удалить в следующей major‑версии после периода миграции**
-
-## Типовые сценарии
-
-### Рефакторинг структуры
-```proto
-message UserInfo {
-  option deprecated = true;
-  string name = 1;
-  string email = 2;
-}
-
-message UserProfile {
-  string full_name = 1;
-  string email_address = 2;
-  string phone = 3;
-}
-```
-
-### Удаление «неиспользуемых» сообщений
-```proto
-message OldConfig {
-  option deprecated = true;
-  // Не удалять сразу — могут быть сохранённые данные
-}
-```
-
-### Миграция версии
-```proto
-package myapi.v2;
-
-message User {
-  // Новая структура без устаревших ссылок
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/breaking-changes/rules/oneof-field-no-delete.md b/docs/public/docs/ru-guide/cli/breaking-changes/rules/oneof-field-no-delete.md
deleted file mode 100644
index c3966516..00000000
--- a/docs/public/docs/ru-guide/cli/breaking-changes/rules/oneof-field-no-delete.md
+++ /dev/null
@@ -1,373 +0,0 @@
-<!-- TODO: Review translation -->
-
-# ONEOF_FIELD_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Правило проверяет, что ни одно поле внутри `oneof` группы не было удалено. Удаление поля из `oneof` ломает совместимость по wire‑формату и сгенерированный код: в сохранённых данных может присутствовать выбранный вариант, а клиентский код опирается на сгенерированные типы‑обёртки и методы доступа.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    string oauth_token = 4;
-    string certificate = 5;
-  }
-}
-
-message SearchQuery {
-  oneof filter {
-    string text = 1;
-    int32 user_id = 2;
-    string category = 3;
-    DateRange date_range = 4;
-  }
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    // string oauth_token = 4;  // [!code --] Удалено поле oneof — BREAKING!
-    // string certificate = 5;  // [!code --] Удалено поле oneof — BREAKING!
-  }
-}
-
-message SearchQuery {
-  oneof filter {
-    string text = 1;
-    int32 user_id = 2;
-    // string category = 3;     // [!code --] Удалено поле oneof — BREAKING!
-    // DateRange date_range = 4; // [!code --] Удалено поле oneof — BREAKING!
-  }
-}
-```
-
-**Ошибка:**
-```
-login.proto:7:5: Previously present field "4" with name "oauth_token" on OneOf "credentials" was deleted. (BREAKING_CHECK)
-login.proto:8:5: Previously present field "5" with name "certificate" on OneOf "credentials" was deleted. (BREAKING_CHECK)
-search.proto:6:5: Previously present field "3" with name "category" on OneOf "filter" was deleted. (BREAKING_CHECK)
-search.proto:7:5: Previously present field "4" with name "date_range" on OneOf "filter" was deleted. (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Удаление вложенных oneof полей:**
-```proto
-// Before
-message PaymentRequest {
-  string order_id = 1;
-  
-  oneof payment_method {
-    CreditCardPayment credit_card = 2;
-    BankTransferPayment bank_transfer = 3;
-    CryptoPayment crypto = 4;         // [!code --] 
-    GiftCardPayment gift_card = 5;    // [!code --]
-  }
-}
-
-// After - BREAKING CHANGES!
-message PaymentRequest {
-  string order_id = 1;
-  
-  oneof payment_method {
-    CreditCardPayment credit_card = 2;
-    BankTransferPayment bank_transfer = 3;
-    // CryptoPayment crypto = 4;      // BREAKING: deleted
-    // GiftCardPayment gift_card = 5; // BREAKING: deleted
-  }
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления — пометить поля deprecated:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    string oauth_token = 4 [deprecated = true]; // [!code focus]
-    string certificate = 5 [deprecated = true]; // [!code focus]
-  }
-}
-
-message SearchQuery {
-  oneof filter {
-    string text = 1;
-    int32 user_id = 2;
-    string category = 3 [deprecated = true]; // [!code focus]
-    DateRange date_range = 4 [deprecated = true]; // [!code focus]
-  }
-}
-```
-
-**Или добавить новые поля, оставив старые:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    string oauth_token = 4 [deprecated = true]; // [!code focus] // Старое поле
-    string certificate = 5 [deprecated = true]; // [!code focus]
-    
-    OAuthCredentials oauth_v2 = 6; // [!code focus] // Новый структурированный вариант
-    CertificateCredentials cert_v2 = 7; // [!code focus]
-  }
-}
-```
-
-## Влияние
-
-- **Wire Format:** Данные, содержащие удалённый вариант, не десериализуются корректно
-- **Generated Code:** Удаляются типы‑обёртки и accessor методы — компиляция клиентов ломается
-- **Type Safety:** Логика `switch` по типам oneof разваливается
-- **Business Logic:** Код, ожидающий конкретный вариант, перестаёт работать
-
-## Реальный пример
-
-**Код клиента ломается:**
-```go
-// Before
-loginReq := &myapi.LoginRequest{
-    Username: "user123",
-}
-
-loginReq.Credentials = &myapi.LoginRequest_OauthToken{
-    OauthToken: "token123", // ERROR после удаления поля
-}
-
-switch cred := loginReq.Credentials.(type) {
-case *myapi.LoginRequest_Password:
-    return authenticatePassword(cred.Password)
-case *myapi.LoginRequest_OauthToken:  // ERROR: тип удалён
-    return authenticateOAuth(cred.OauthToken)
-case *myapi.LoginRequest_Certificate: // ERROR: тип удалён
-    return authenticateCert(cred.Certificate)
-default:
-    return errors.New("unsupported credential type")
-}
-// undefined: myapi.LoginRequest_OauthToken
-// undefined: myapi.LoginRequest_Certificate
-```
-
-**Серверная логика ломается:**
-```go
-func authenticateUser(req *LoginRequest) error {
-    switch cred := req.Credentials.(type) {
-    case *LoginRequest_Password:
-        return validatePassword(cred.Password)
-    case *LoginRequest_ApiKey:
-        return validateApiKey(cred.ApiKey)
-    case *LoginRequest_OauthToken:    // ERROR после удаления
-        return validateOAuth(cred.OauthToken)
-    case *LoginRequest_Certificate:   // ERROR после удаления
-        return validateCertificate(cred.Certificate)
-    default:
-        return errors.New("no valid credentials provided")
-    }
-}
-```
-
-**Старые данные становятся нечитаемыми:**
-```json
-{
-  "username": "user123",
-  "oauth_token": "abc123xyz"
-}
-// После удаления: токен теряется или вызывает ошибку парсинга
-```
-
-## Стратегия миграции
-
-1. **Депрецируйте сначала:**
-   ```proto
-   oneof credentials {
-     string password = 2;
-     string oauth_token = 4 [deprecated = true];
-   }
-   ```
-2. **Добавьте новые структурированные поля:**
-   ```proto
-   oneof credentials {
-     string password = 2;
-     string oauth_token = 4 [deprecated = true];
-     OAuthCredentials oauth_v2 = 6;
-   }
-   ```
-3. **Сервер: поддерживайте оба варианта:**
-   ```go
-   switch cred := req.Credentials.(type) {
-   case *LoginRequest_OauthV2:
-       return validateOAuthV2(cred.OauthV2)
-   case *LoginRequest_OauthToken:
-       log.Warn("Deprecated oauth_token used")
-       return validateOAuthLegacy(cred.OauthToken)
-   }
-   ```
-4. **Мигрируйте клиентов на новое поле:**
-   ```go
-   loginReq.Credentials = &LoginRequest_OauthV2{
-       OauthV2: &OAuthCredentials{
-           Token: "token123",
-           RefreshToken: "refresh456",
-           ExpiresAt: timestamp,
-       },
-   }
-   ```
-5. **Зарезервируйте номера удалённых полей в следующей major‑версии:**
-   ```proto
-   oneof credentials {
-     reserved 4, 5;
-     reserved "oauth_token", "certificate";
-     string password = 2;
-     string api_key = 3;
-     OAuthCredentials oauth_v2 = 6;
-   }
-   ```
-
-## Типовые сценарии
-
-### Удаление неподдерживаемых методов аутентификации
-```proto
-message AuthRequest {
-  oneof method {
-    PasswordAuth password = 1;
-    ApiKeyAuth api_key = 2;
-    // LdapAuth ldap = 3;  // НЕЛЬЗЯ просто удалить
-    LdapAuth ldap = 3 [deprecated = true];
-    OidcAuth oidc = 4;
-  }
-}
-```
-
-### Упрощение вариантов oneof
-```proto
-message SearchRequest {
-  oneof query_type {
-    string simple_text = 1;
-    // ComplexQuery complex = 2; // Не удалять напрямую
-    ComplexQuery complex = 2 [deprecated = true];
-    AdvancedQuery advanced = 3;
-  }
-}
-```
-
-### Изменения бизнес‑логики платежей
-```proto
-message PaymentRequest {
-  oneof payment_method {
-    CreditCard credit_card = 1;
-    BankTransfer bank_transfer = 3;
-    // Check check = 2; // Не удалять
-    Check check = 2 [deprecated = true];
-    DigitalWallet digital_wallet = 4;
-  }
-}
-```
-
-## OneOf Field Deletion vs обычное удаление
-
-### Отличия от удаления обычного поля
-```proto
-message User {
-  string name = 1;
-  // string email = 2; // BREAKING: обычное поле
-}
-
-message User {
-  oneof contact {
-    string email = 1;
-    // string phone = 2; // BREAKING: поле в oneof
-  }
-}
-```
-
-### Влияние на сгенерированный код
-```go
-// Обычное поле: удаляется простой геттер
-// user.GetEmail()
-
-// Поле в oneof: пропадает тип-обёртка, кейсы switch ломаются
-// *LoginRequest_OauthToken
-```
-
-### Wire‑особенности
-```proto
-message Request {
-  oneof data {
-    string text = 1;
-    bytes binary = 2;  // Если удалить — клиенты, использующие binary, ломаются
-    JsonData json = 3;
-  }
-}
-```
-
-## Валидация и обработка ошибок
-
-### До удаления (типобезопасно)
-```go
-switch data := req.Data.(type) {
-case *Request_Text:
-    return validateText(data.Text)
-case *Request_Binary:
-    return validateBinary(data.Binary)
-case *Request_Json:
-    return validateJson(data.Json)
-case nil:
-    return errors.New("no data provided")
-default:
-    return errors.New("unknown data type")
-}
-```
-
-### После удаления (сломано)
-```go
-switch data := req.Data.(type) {
-case *Request_Text:
-    return validateText(data.Text)
-// case *Request_Binary: // Тип исчез — кейс не компилируется
-case *Request_Json:
-    return validateJson(data.Json)
-case nil:
-    return errors.New("no data provided")
-default:
-    return errors.New("unknown data type") // Старые бинарные данные попадают сюда
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/breaking-changes/rules/oneof-field-same-type.md b/docs/public/docs/ru-guide/cli/breaking-changes/rules/oneof-field-same-type.md
deleted file mode 100644
index e0bf4577..00000000
--- a/docs/public/docs/ru-guide/cli/breaking-changes/rules/oneof-field-same-type.md
+++ /dev/null
@@ -1,347 +0,0 @@
-<!-- TODO: Review translation -->
-
-# ONEOF_FIELD_SAME_TYPE
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что тип поля внутри `oneof` НЕ меняется. Смена типа любого варианта `oneof` — несовместимое (breaking) изменение: существующие данные сериализованы с прежним типом, а клиентский код ожидает конкретные типы-обёртки и методы доступа, сгенерированные для каждого варианта.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message SearchRequest {
-  string query = 1;
-  
-  oneof filter {
-    string category = 2;
-    int32 user_id = 3;
-    bool is_premium = 4;
-    DateRange date_range = 5;
-  }
-}
-
-message NotificationSettings {
-  oneof delivery {
-    string email = 1;
-    int64 phone_number = 2;
-    WebhookConfig webhook = 3;
-  }
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message SearchRequest {
-  string query = 1;
-  
-  oneof filter {
-    int32 category = 2;        // [!code --] Было string -> стало int32 (BREAKING)
-    string user_id = 3;        // [!code --] Было int32 -> стало string (BREAKING)
-    string is_premium = 4;     // [!code --] Было bool -> стало string (BREAKING)
-    string date_range = 5;     // [!code --] Было DateRange -> стало string (BREAKING)
-  }
-}
-
-message NotificationSettings {
-  oneof delivery {
-    EmailConfig email = 1;     // [!code --] Было string -> стало EmailConfig (BREAKING)
-    string phone_number = 2;   // [!code --] Было int64 -> стало string (BREAKING)
-    string webhook = 3;        // [!code --] Было WebhookConfig -> стало string (BREAKING)
-  }
-}
-```
-
-**Ошибка:**
-```
-search.proto:6:5: Field "2" with name "category" on OneOf "filter" changed type from "string" to "int32". (BREAKING_CHECK)
-search.proto:7:5: Field "3" with name "user_id" on OneOf "filter" changed type from "int32" to "string". (BREAKING_CHECK)
-search.proto:8:5: Field "4" with name "is_premium" on OneOf "filter" changed type from "bool" to "string". (BREAKING_CHECK)
-search.proto:9:5: Field "5" with name "date_range" on OneOf "filter" changed type from "DateRange" to "string". (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Комплексные изменения типов:**
-```proto
-// Before
-message PaymentRequest {
-  oneof payment_info {
-    CreditCardInfo credit_card = 1;
-    BankAccountInfo bank_account = 2;
-    string paypal_email = 3;
-    CryptoWalletInfo crypto = 4;
-  }
-}
-
-// After - ВСЁ BREAKING
-message PaymentRequest {
-  oneof payment_info {
-    string credit_card = 1;           // CreditCardInfo -> string
-    PayPalInfo bank_account = 2;      // BankAccountInfo -> PayPalInfo
-    PayPalInfo paypal_email = 3;      // string -> PayPalInfo
-    string crypto = 4;                // CryptoWalletInfo -> string
-  }
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо смены типа — добавьте новое поле в тот же oneof:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message SearchRequest {
-  string query = 1;
-  
-  oneof filter {
-    string category = 2 [deprecated = true];         // Старый тип
-    int32 user_id = 3 [deprecated = true];
-    bool is_premium = 4 [deprecated = true];
-    DateRange date_range = 5 [deprecated = true];
-    
-    int32 category_id = 6;        // Новая версия
-    string user_identifier = 7;
-    string premium_status = 8;
-    string date_filter = 9;
-  }
-}
-```
-
-**Или создайте новый oneof:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message SearchRequest {
-  string query = 1;
-  
-  oneof filter {
-    option deprecated = true;
-    string category = 2 [deprecated = true];
-    int32 user_id = 3 [deprecated = true];
-    bool is_premium = 4 [deprecated = true];
-    DateRange date_range = 5 [deprecated = true];
-  }
-  
-  oneof filter_v2 {
-    int32 category_id = 6;
-    string user_identifier = 7;
-    PremiumFilter premium_filter = 8;
-    TimeFilter time_filter = 9;
-  }
-}
-```
-
-## Влияние
-
-- **Wire Format:** Старые бинарные данные не читаются корректно
-- **Generated Code:** Меняются типы-обёртки, код клиента не компилируется
-- **Type Safety:** `switch` по варианту oneof ломается
-- **Runtime Errors:** Ошибки десериализации и логики при несовпадении типов
-
-## Реальный пример
-
-**Ломается клиентский код:**
-```go
-// Before
-searchReq := &myapi.SearchRequest{
-    Query: "golang jobs",
-}
-
-// Устанавливаем вариант oneof
-searchReq.Filter = &myapi.SearchRequest_Category{
-    Category: "engineering",
-}
-
-// Обработка вариантов
-switch filter := searchReq.Filter.(type) {
-case *myapi.SearchRequest_Category:
-    return searchByCategory(filter.Category)
-case *myapi.SearchRequest_UserId:
-    return searchByUserId(filter.UserId)
-default:
-    return errors.New("unsupported filter")
-}
-
-// After — тип Category стал int32
-searchReq.Filter = &myapi.SearchRequest_Category{
-    Category: "engineering", // ERROR
-}
-
-switch filter := searchReq.Filter.(type) {
-case *myapi.SearchRequest_Category:
-    return searchByCategory(filter.Category) // ERROR
-case *myapi.SearchRequest_UserId:
-    return searchByUserId(filter.UserId)     // ERROR: UserId теперь string
-}
-```
-
-**Ломается серверная логика:**
-```go
-// Before
-func handleSearchFilter(req *SearchRequest) (*SearchResult, error) {
-    switch filter := req.Filter.(type) {
-    case *SearchRequest_Category:
-        return searchDatabase("category", filter.Category), nil
-    case *SearchRequest_UserId:
-        return searchDatabase("user_id", strconv.Itoa(int(filter.UserId))), nil
-    default:
-        return nil, errors.New("no filter specified")
-    }
-}
-
-// After — несовпадения типов
-func handleSearchFilter(req *SearchRequest) (*SearchResult, error) {
-    switch filter := req.Filter.(type) {
-    case *SearchRequest_Category:
-        // filter.Category теперь int32, а код ожидал string
-        return searchDatabase("category", filter.Category), nil // ERROR
-    case *SearchRequest_UserId:
-        userIdStr := filter.UserId // string вместо int32
-        userId, _ := strconv.Atoi(userIdStr)
-        return searchDatabase("user_id", strconv.Itoa(userId)), nil
-    }
-}
-```
-
-**Порча данных:**
-```json
-{
-  "query": "golang jobs",
-  "category": "engineering"
-}
-// После смены типа: "engineering" не может быть интерпретировано как int32
-```
-
-## Стратегия миграции
-
-1. Добавьте новое поле:
-   ```proto
-   oneof filter {
-     string category = 2 [deprecated = true];
-     int32 category_id = 6;
-   }
-   ```
-2. Сервер поддерживает оба:
-   ```go
-   switch filter := req.Filter.(type) {
-   case *SearchRequest_CategoryId:
-       return searchByCategoryId(filter.CategoryId)
-   case *SearchRequest_Category:
-       log.Warn("Deprecated string category used")
-       id := convertCategoryNameToId(filter.Category)
-       return searchByCategoryId(id)
-   }
-   ```
-3. Клиенты переходят на `category_id`.
-4. Скрипты миграции преобразуют старые данные.
-5. В следующей major‑версии:
-   ```proto
-   oneof filter {
-     reserved 2, "category";
-     int32 category_id = 6;
-   }
-   ```
-
-## Типовые сценарии
-
-### Повышение типобезопасности
-```proto
-message ConfigRequest {
-  oneof setting {
-    string database_url = 1 [deprecated = true];
-    DatabaseConfig database_config = 5;
-  }
-}
-```
-
-### Стандартизация числовых типов
-```proto
-message FilterRequest {
-  oneof criteria {
-    int32 timestamp = 1 [deprecated = true];
-    int64 timestamp_millis = 5;
-  }
-}
-```
-
-### Переход к структурированным типам
-```proto
-message PaymentRequest {
-  oneof payment {
-    string card_number = 1 [deprecated = true];
-    CreditCardDetails card_details = 5;
-  }
-}
-```
-
-## Матрица совместимости
-
-| From Type | To Type | Результат |
-|-----------|---------|-----------|
-| `string` | `int32/int64` | ❌ BREAKING |
-| `int32` | `string` | ❌ BREAKING |
-| `bool` | `string` | ❌ BREAKING |
-| `message` | `string` | ❌ BREAKING |
-| `string` | `message` | ❌ BREAKING |
-| `enum` | `int32` | ❌ BREAKING |
-
-### Влияние на сгенерированный код
-```go
-// Before:
-type SearchRequest_Category struct {
-    Category string
-}
-// After:
-type SearchRequest_Category struct {
-    Category int32
-}
-```
-
-### Wire‑формат
-```proto
-message Request {
-  oneof data {
-    string text = 1;
-    // int32 text = 1; // Тот же номер, другой тип — BREAKING
-  }
-}
-```
-
-## Валидация
-
-**До:**
-```go
-switch f := req.Filter.(type) {
-case *SearchRequest_Category:
-    if f.Category == "" { return errors.New("category cannot be empty") }
-case *SearchRequest_UserId:
-    if f.UserId <= 0 { return errors.New("user_id must be positive") }
-}
-```
-
-**После (сломано):**
-```go
-switch f := req.Filter.(type) {
-case *SearchRequest_Category:
-    if f.Category <= 0 { return errors.New("category must be positive") } // Логика ожидала string
-case *SearchRequest_UserId:
-    if f.UserId == "" { return errors.New("user_id cannot be empty") }    // Был int32
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/breaking-changes/rules/oneof-no-delete.md b/docs/public/docs/ru-guide/cli/breaking-changes/rules/oneof-no-delete.md
deleted file mode 100644
index 728c3e83..00000000
--- a/docs/public/docs/ru-guide/cli/breaking-changes/rules/oneof-no-delete.md
+++ /dev/null
@@ -1,393 +0,0 @@
-<!-- TODO: Review translation -->
-
-# ONEOF_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что ни один `oneof` блок не был удалён из сообщений. Удаление `oneof` ломает совместимость по wire‑формату и сгенерированный код: существующие данные могут содержать ранее выбранный вариант, а клиентский код зависит от типов-обёрток и методов доступа, генерируемых для `oneof`.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    string password = 2;
-    string api_key = 3;
-    string oauth_token = 4;
-  }
-}
-
-message PaymentMethod { // [!code --]
-  oneof method { // [!code --]
-    CreditCard credit_card = 1; // [!code --]
-    BankAccount bank_account = 2; // [!code --]
-    PayPal paypal = 3; // [!code --]
-  } // [!code --]
-} // [!code --]
-
-message Order {
-  string id = 1;
-  PaymentMethod payment = 2;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  // credentials oneof удалён — BREAKING CHANGE!
-  string password = 2;     // Теперь обычные поля
-  string api_key = 3;      // Потеряна взаимная исключаемость
-  string oauth_token = 4;
-}
-
-message PaymentMethod {
-  // method oneof удалён — BREAKING CHANGE!
-  CreditCard credit_card = 1;  // Теперь можно установить все поля одновременно
-  BankAccount bank_account = 2;
-  PayPal paypal = 3;
-}
-
-message Order {
-  string id = 1;
-  PaymentMethod payment = 2;
-}
-```
-
-**Ошибка:**
-```
-login.proto:5:3: Previously present oneof "credentials" was deleted. (BREAKING_CHECK)
-payment.proto:2:3: Previously present oneof "method" was deleted. (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Удаление вложенного oneof:**
-```proto
-// Before
-message UserProfile {
-  string name = 1;
-  
-  message ContactInfo {
-    oneof contact_method { // [!code --]
-      string email = 1; // [!code --]
-      string phone = 2; // [!code --]
-      string slack_id = 3; // [!code --]
-    } // [!code --]
-  }
-  
-  ContactInfo contact = 2;
-}
-
-// After - BREAKING CHANGE!
-message UserProfile {
-  string name = 1;
-  
-  message ContactInfo {
-    // contact_method oneof удалён
-    string email = 1;    // Больше не эксклюзивно
-    string phone = 2;    // Можно задать всё сразу
-    string slack_id = 3;
-  }
-  
-  ContactInfo contact = 2;
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления — депрецируйте oneof:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    option deprecated = true; // [!code focus]
-    string password = 2 [deprecated = true]; // [!code focus]
-    string api_key = 3 [deprecated = true]; // [!code focus]
-    string oauth_token = 4 [deprecated = true]; // [!code focus]
-  }
-}
-
-message PaymentMethod {
-  oneof method {
-    option deprecated = true; // [!code focus]
-    CreditCard credit_card = 1 [deprecated = true]; // [!code focus]
-    BankAccount bank_account = 2 [deprecated = true]; // [!code focus]
-    PayPal paypal = 3 [deprecated = true]; // [!code focus]
-  }
-}
-```
-
-**Или заменить новой структурой:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-message LoginRequest {
-  string username = 1;
-  
-  oneof credentials {
-    option deprecated = true; // [!code focus] // Старый oneof
-    string password = 2 [deprecated = true]; // [!code focus]
-    string api_key = 3 [deprecated = true]; // [!code focus]
-    string oauth_token = 4 [deprecated = true]; // [!code focus]
-  }
-  
-  oneof auth_method { // [!code focus] // Новый дизайн
-    PasswordAuth password_auth = 5; // [!code focus]
-    ApiKeyAuth api_auth = 6; // [!code focus]
-    OAuthAuth oauth_auth = 7; // [!code focus]
-  } // [!code focus]
-}
-```
-
-## Влияние
-
-- **Wire Format:** Теряются семантика взаимной исключаемости — больше одного поля может быть установлено
-- **Generated Code:** Удаляются типы-обёртки и accessor методы — код клиента не компилируется
-- **Business Logic:** Нарушаются инварианты «только один из»
-- **Validation:** Логика проверок должна быть переписана вручную
-
-## Реальный пример
-
-**Код клиента ломается:**
-```go
-// Before - oneOf даёт взаимную исключаемость
-loginReq := &myapi.LoginRequest{
-    Username: "user123",
-}
-
-loginReq.Credentials = &myapi.LoginRequest_Password{
-    Password: "secret123",
-}
-
-switch cred := loginReq.Credentials.(type) {
-case *myapi.LoginRequest_Password:  // ERROR после удаления
-    return authenticatePassword(cred.Password)
-case *myapi.LoginRequest_ApiKey:    // ERROR после удаления
-    return authenticateApiKey(cred.ApiKey)
-default:
-    return errors.New("no credentials provided")
-}
-
-// Compilation errors:
-// undefined: myapi.LoginRequest_Password
-// undefined field: loginReq.Credentials
-```
-
-**Валидация на сервере ломается:**
-```go
-// Before
-func validateLoginRequest(req *LoginRequest) error {
-    if req.Credentials == nil {
-        return errors.New("credentials required")
-    }
-    switch req.Credentials.(type) {
-    case *LoginRequest_Password:
-        return validatePassword(req.GetPassword())
-    case *LoginRequest_ApiKey:
-        return validateApiKey(req.GetApiKey())
-    case *LoginRequest_OauthToken:
-        return validateOAuthToken(req.GetOauthToken())
-    default:
-        return errors.New("unknown credential type")
-    }
-}
-
-// After
-func validateLoginRequest(req *LoginRequest) error {
-    credCount := 0
-    if req.Password != "" { credCount++ }
-    if req.ApiKey != "" { credCount++ }
-    if req.OauthToken != "" { credCount++ }
-
-    if credCount == 0 {
-        return errors.New("no credentials provided")
-    }
-    if credCount > 1 {
-        return errors.New("multiple credentials provided")
-    }
-
-    if req.Password != "" {
-        return validatePassword(req.Password)
-    }
-    // Дополнительные проверки вручную...
-    return nil
-}
-```
-
-**Проблемы бизнес‑логики:**
-```go
-// Before
-payment := &PaymentMethod{
-    Method: &PaymentMethod_CreditCard{
-        CreditCard: &CreditCard{Number: "1234"},
-    },
-}
-
-// After — можно задать несколько способов сразу
-payment := &PaymentMethod{
-    CreditCard:  &CreditCard{Number: "1234"},
-    BankAccount: &BankAccount{Number: "5678"}, // Ломает бизнес-логику
-}
-```
-
-## Стратегия миграции
-
-1. **Депрецируйте старый oneof и его поля:**
-   ```proto
-   oneof old_credentials {
-     option deprecated = true;
-     string password = 2 [deprecated = true];
-     string api_key = 3 [deprecated = true];
-   }
-   ```
-
-2. **Создайте новый блок при необходимости:**
-   ```proto
-   oneof new_auth_method {
-     PasswordAuth password_auth = 5;
-     ApiKeyAuth api_auth = 6;
-   }
-   ```
-
-3. **Сервер: поддерживайте оба до миграции:**
-   ```go
-   func handleAuth(req *LoginRequest) error {
-       if req.NewAuthMethod != nil {
-           return handleNewAuth(req.NewAuthMethod)
-       }
-       if req.Credentials != nil {
-           return handleOldAuth(req.Credentials)
-       }
-       return errors.New("no auth method provided")
-   }
-   ```
-
-4. **Клиенты: переходите на новый oneof:**
-   ```go
-   loginReq.NewAuthMethod = &LoginRequest_PasswordAuth{
-       PasswordAuth: &PasswordAuth{
-           Username: "user123",
-           Password: "secret123",
-       },
-   }
-   ```
-
-5. **Удалите старый oneof** в следующей major‑версии.
-
-## Типовые сценарии
-
-### Замена oneof обычными полями
-```proto
-message SearchRequest {
-  // НЕЛЬЗЯ просто убрать oneof — ломает семантику
-  string text_query = 1;    // BREAKING
-  int32 user_id = 2;        // BREAKING
-  string category = 3;      // BREAKING
-}
-
-message SearchRequest {
-  oneof query {
-    option deprecated = true;
-    string text_query = 1 [deprecated = true];
-    int32 user_id = 2 [deprecated = true];
-    string category = 3 [deprecated = true];
-  }
-  string search_text = 4;
-  repeated string filters = 5;
-}
-```
-
-### Упрощение структуры сообщения
-```proto
-message NotificationSettings {
-  string email = 1;       // BREAKING: был в oneof
-  string phone = 2;       // BREAKING
-  string webhook_url = 3; // BREAKING
-}
-
-message NotificationSettings {
-  oneof delivery_method {
-    EmailNotification email = 1;
-    SmsNotification phone = 2;
-    WebhookNotification webhook = 3;
-  }
-}
-```
-
-### Миграция с proto2 на proto3
-```proto
-// proto2
-message Request {
-  optional string name = 1;
-  oneof data {
-    string text = 2;
-    int32 number = 3;
-  }
-}
-
-// proto3 — сохраняем oneof
-message Request {
-  string name = 1;
-  oneof data {
-    string text = 2;
-    int32 number = 3;
-  }
-}
-```
-
-## Семантика OneOf
-
-### Что даёт oneof
-- Взаимная исключаемость
-- Типобезопасность в коде
-- Ясность намерения API («выбери один»)
-- Эффективная сериализация — кодируется только выбранный вариант
-
-### Что теряется при удалении
-- Инвариант «только один»
-- Генерируемые wrapper-типы и методы
-- Автоматическая валидация выбора
-- Понятность контракта API
-
-### Влияние на код генерации
-```go
-// С oneof
-type LoginRequest struct {
-    Username string
-    Credentials isLoginRequest_Credentials
-}
-
-// Без oneof
-type LoginRequest struct {
-    Username   string
-    Password   string
-    ApiKey     string
-    OauthToken string
-    // Возможны многозначные конфликтующие состояния
-}
-```
-
diff --git a/docs/public/docs/ru-guide/cli/breaking-changes/rules/rpc-no-delete.md b/docs/public/docs/ru-guide/cli/breaking-changes/rules/rpc-no-delete.md
deleted file mode 100644
index cdaae484..00000000
--- a/docs/public/docs/ru-guide/cli/breaking-changes/rules/rpc-no-delete.md
+++ /dev/null
@@ -1,80 +0,0 @@
-<!-- TODO: Review translation -->
-
-# RPC_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Правило проверяет, что ни один RPC‑метод не был удалён из service. Удаление RPC ломает сгенерированный код и клиентские приложения, которые этот метод вызывают.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-  rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse); // [!code --]
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-  // DeleteUser RPC удалён — BREAKING CHANGE!
-}
-```
-
-**Ошибка:**
-```
-services.proto:7:1: Previously present RPC "DeleteUser" on service "UserService" was deleted. (BREAKING_CHECK)
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления — пометить RPC deprecated:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-  rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-}
-```
-
-## Влияние
-
-- **Generated Code:** Stub/метод исчезает — клиенты не компилируются
-- **Client Applications:** Существующие вызовы метода падают при сборке
-- **Runtime:** gRPC клиенты теряют определение метода
-
-## Стратегия миграции
-
-1. **Сначала деприкация:**
-   ```proto
-   rpc OldMethod(OldRequest) returns (OldResponse) {
-     option deprecated = true;
-   }
-   ```
-
-2. **Имплементация может возвращать ошибку**, указывая что метод устарел (например, INTERNAL / UNIMPLEMENTED)
-
-3. **Удалить в следующей major‑версии** после миграции всех клиентов
\ No newline at end of file
diff --git a/docs/public/docs/ru-guide/cli/breaking-changes/rules/rpc-same-request-type.md b/docs/public/docs/ru-guide/cli/breaking-changes/rules/rpc-same-request-type.md
deleted file mode 100644
index 7fd98fbd..00000000
--- a/docs/public/docs/ru-guide/cli/breaking-changes/rules/rpc-same-request-type.md
+++ /dev/null
@@ -1,253 +0,0 @@
-<!-- TODO: Review translation -->
-
-# RPC_SAME_REQUEST_TYPE
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что RPC‑методы сохраняют прежний тип сообщения запроса (request message type). Изменение типа запроса RPC ломает совместимость по wire‑формату и сгенерированный код: клиенты ожидают конкретную структуру при вызове метода.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse);
-}
-
-message GetUserRequest {
-  string user_id = 1;
-}
-
-message UpdateUserRequest {
-  string user_id = 1;
-  string name = 2;
-  string email = 3;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // [!code --] Изменён тип запроса
-  rpc UpdateUser(UserUpdateRequest) returns (UpdateUserResponse); // [!code --] Изменён тип запроса
-}
-
-message GetUserRequestV2 { // [!code --] Новый тип запроса
-  string id = 1;
-  bool include_profile = 2;
-}
-
-message UserUpdateRequest { // [!code --] Новый тип запроса
-  string id = 1;
-  UserProfile profile = 2;
-}
-```
-
-**Ошибка:**
-```
-user_service.proto:6:3: RPC "GetUser" on service "UserService" changed request type from "GetUserRequest" to "GetUserRequestV2". (BREAKING_CHECK)
-user_service.proto:7:3: RPC "UpdateUser" on service "UserService" changed request type from "UpdateUserRequest" to "UserUpdateRequest". (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Смена типа из другого пакета:**
-```proto
-// Before
-import "common/user.proto";
-
-service UserService {
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-// After - BREAKING CHANGE!
-import "v2/user.proto";
-
-service UserService {
-  rpc CreateUser(v2.CreateUserRequest) returns (CreateUserResponse); // Другой package
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо изменения типа — версионируйте RPC:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-  rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse); // [!code focus] // Новый метод
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-  rpc UpdateUserV2(UserUpdateRequest) returns (UpdateUserResponse); // [!code focus] // Новый метод
-}
-
-// Старые сообщения — для обратной совместимости
-message GetUserRequest {
-  string user_id = 1;
-}
-
-// Новая версия сообщения
-message GetUserRequestV2 { // [!code focus]
-  string id = 1; // [!code focus]
-  bool include_profile = 2; // [!code focus]
-} // [!code focus]
-```
-
-**Или создайте новую версию сервиса (package v2):**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus]
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus]
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus]
-}
-
-message GetUserRequest { // [!code focus]
-  string id = 1; // [!code focus]
-  bool include_profile = 2; // [!code focus]
-} // [!code focus]
-```
-
-## Влияние
-
-- **Wire Format:** Старые запросы клиентов не десериализуются новым сервером
-- **Generated Code:** Сигнатуры методов в stubs меняются — компиляция клиентов падает
-- **gRPC Calls:** Требуется использовать другую структуру запроса
-- **Runtime Errors:** Несоответствие типов вызывает ошибки выполнения
-
-## Реальный пример
-
-**Код клиента ломается:**
-```go
-// Before
-client := myapi.NewUserServiceClient(conn)
-resp, err := client.GetUser(ctx, &myapi.GetUserRequest{
-    UserId: "user123",
-})
-
-// After (тип запроса изменён)
-client := myapi.NewUserServiceClient(conn)
-resp, err := client.GetUser(ctx, &myapi.GetUserRequest{  // ERROR: тип не найден
-    UserId: "user123",  // ERROR: поле не найдено
-})
-
-// Новый корректный вызов:
-resp, err := client.GetUser(ctx, &myapi.GetUserRequestV2{
-    Id: "user123",
-    IncludeProfile: true,
-})
-```
-
-**Серверная реализация ломается:**
-```go
-// Before
-func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
-    userID := req.UserId
-    // ...
-}
-
-// After
-func (s *server) GetUser(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) {
-    userID := req.Id
-    include := req.IncludeProfile
-    // ... новая логика
-}
-```
-
-## Стратегия миграции
-
-1. **Добавьте новый RPC с новым типом запроса:**
-   ```proto
-   rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-     option deprecated = true;
-   }
-   rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse);
-   ```
-
-2. **Поддерживайте оба метода на сервере:**
-   ```go
-   func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
-       return s.getUserInternal(req.UserId, false)
-   }
-
-   func (s *server) GetUserV2(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) {
-       return s.getUserInternal(req.Id, req.IncludeProfile)
-   }
-   ```
-
-3. **Мигрируйте клиентов на V2:**
-   ```go
-   resp, err := client.GetUserV2(ctx, &myapi.GetUserRequestV2{
-       Id: userID,
-       IncludeProfile: true,
-   })
-   ```
-
-4. **Удалите старый метод в следующей major‑версии:**
-   ```proto
-   rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse);
-   ```
-
-## Типовые сценарии
-
-### Добавление обязательных полей
-```proto
-// ПЛОХО: меняем существующий запрос
-message GetUserRequest {
-  string user_id = 1;
-  bool include_deleted = 2; // BREAKING
-}
-
-// Хорошо: новая версия
-message GetUserRequestV2 {
-  string user_id = 1;
-  bool include_deleted = 2;
-}
-```
-
-### Реструктуризация данных запроса
-```proto
-// ПЛОХО: меняем структуру прямо
-message UpdateUserRequest {
-  UserProfile profile = 1; // BREAKING
-}
-
-// Хорошо: версионирование
-rpc UpdateUser(UpdateUserRequest) returns (...) {
-  option deprecated = true;
-}
-rpc UpdateUserV2(UpdateUserRequestV2) returns (...);
-```
-
-### Миграция пакета
-```proto
-// ПЛОХО: заменяем тип на пакет v2 прямо
-import "v2/messages.proto"; // BREAKING
-
-// Хорошо: добавляем новый RPC
-rpc OldMethod(v1.Request) returns (...) {
-  option deprecated = true;
-}
-rpc NewMethod(v2.Request) returns (...);
-```
diff --git a/docs/public/docs/ru-guide/cli/breaking-changes/rules/rpc-same-response-type.md b/docs/public/docs/ru-guide/cli/breaking-changes/rules/rpc-same-response-type.md
deleted file mode 100644
index 7f8eaeb4..00000000
--- a/docs/public/docs/ru-guide/cli/breaking-changes/rules/rpc-same-response-type.md
+++ /dev/null
@@ -1,314 +0,0 @@
-<!-- TODO: Review translation -->
-
-# RPC_SAME_RESPONSE_TYPE
-
-Категории:
-
-- **WIRE+**
-
-Это правило проверяет, что RPC‑методы сохраняют тот же тип ответного сообщения (response message type). Изменение типа ответа RPC ломает совместимость по wire‑формату и сгенерированный код: клиенты ожидают конкретную структуру при получении ответа.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse);
-}
-
-message GetUserResponse {
-  string user_id = 1;
-  string name = 2;
-  string email = 3;
-}
-
-message UpdateUserResponse {
-  bool success = 1;
-  string message = 2;
-}
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponseV2); // [!code --] Изменён тип ответа
-  rpc UpdateUser(UpdateUserRequest) returns (UserUpdateResponse); // [!code --] Изменён тип ответа
-}
-
-message GetUserResponseV2 { // [!code --] Другой тип сообщения
-  string id = 1;
-  UserProfile profile = 2;
-  repeated string permissions = 3;
-}
-
-message UserUpdateResponse { // [!code --] Другой тип сообщения
-  UpdateResult result = 1;
-  UserProfile updated_profile = 2;
-}
-```
-
-**Ошибка:**
-```
-user_service.proto:6:3: RPC "GetUser" on service "UserService" changed response type from "GetUserResponse" to "GetUserResponseV2". (BREAKING_CHECK)
-user_service.proto:7:3: RPC "UpdateUser" on service "UserService" changed response type from "UpdateUserResponse" to "UserUpdateResponse". (BREAKING_CHECK)
-```
-
-### Дополнительные примеры
-
-**Смена типа из другого пакета:**
-```proto
-// Before
-import "common/responses.proto";
-
-service UserService {
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-// After - BREAKING CHANGE!
-import "v2/responses.proto";
-
-service UserService {
-  rpc CreateUser(CreateUserRequest) returns (v2.CreateUserResponse); // Другой package
-}
-```
-
-### Хороший (Безопасный)
-
-**Вместо изменения типа — версионируйте RPC:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-  rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2); // [!code focus] // Новый метод
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) {
-    option deprecated = true; // [!code focus]
-  }
-  rpc UpdateUserV2(UpdateUserRequest) returns (UserUpdateResponse); // [!code focus] // Новый метод
-}
-
-// Старые сообщения сохраняем для обратной совместимости
-message GetUserResponse {
-  string user_id = 1;
-  string name = 2;
-  string email = 3;
-}
-
-// Новая расширенная версия
-message GetUserResponseV2 { // [!code focus]
-  string id = 1; // [!code focus]
-  UserProfile profile = 2; // [!code focus]
-  repeated string permissions = 3; // [!code focus]
-} // [!code focus]
-```
-
-**Или создайте новую версию сервиса (package v2):**
-```proto
-syntax = "proto3";
-
-package myapi.v2; // [!code focus]
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus]
-  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus]
-}
-
-message GetUserResponse { // [!code focus]
-  string id = 1; // [!code focus]
-  UserProfile profile = 2; // [!code focus]
-  repeated string permissions = 3; // [!code focus]
-} // [!code focus]
-```
-
-## Влияние
-
-- **Wire Format:** Ответы сервера не десериализуются у старых клиентов
-- **Generated Code:** Сигнатуры ожидают старый тип — компиляция падает
-- **gRPC Calls:** Меняются типы в сгенерированных stub'ах
-- **Runtime Errors:** Несоответствие типов ломает обработку ответа
-
-## Реальный пример
-
-**Код клиента ломается:**
-```go
-// Before
-client := myapi.NewUserServiceClient(conn)
-resp, err := client.GetUser(ctx, &myapi.GetUserRequest{
-    UserId: "user123",
-})
-if err != nil {
-    return err
-}
-
-userID := resp.UserId
-name := resp.Name
-
-// After (тип ответа изменён)
-client := myapi.NewUserServiceClient(conn)
-resp, err := client.GetUser(ctx, &myapi.GetUserRequest{
-    UserId: "user123",
-})
-if err != nil {
-    return err
-}
-
-// Ошибки компиляции:
-userID := resp.UserId  // ERROR
-name := resp.Name      // ERROR
-
-// Новый способ:
-userID := resp.Id
-profile := resp.Profile
-permissions := resp.Permissions
-```
-
-**Имплементация сервера также должна быть переписана:**
-```go
-// Before
-func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
-    return &GetUserResponse{
-        UserId: "user123",
-        Name:   "John Doe",
-        Email:  "john@example.com",
-    }, nil
-}
-
-// After
-func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) {
-    return &GetUserResponseV2{
-        Id: "user123",
-        Profile: &UserProfile{
-            Name:  "John Doe",
-            Email: "john@example.com",
-        },
-        Permissions: []string{"read"},
-    }, nil
-}
-```
-
-## Стратегия миграции
-
-1. **Добавьте новый RPC c новым типом ответа:**
-   ```proto
-   rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-     option deprecated = true;
-   }
-   rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2);
-   ```
-
-2. **Поддерживайте оба на сервере:**
-   ```go
-   func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
-       user := s.getUserInternal(req.UserId)
-       return &GetUserResponse{
-           UserId: user.ID,
-           Name:   user.Name,
-           Email:  user.Email,
-       }, nil
-   }
-
-   func (s *server) GetUserV2(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) {
-       user := s.getUserInternal(req.UserId)
-       return &GetUserResponseV2{
-           Id: user.ID,
-           Profile: &UserProfile{
-               Name:  user.Name,
-               Email: user.Email,
-           },
-           Permissions: user.Permissions,
-       }, nil
-   }
-   ```
-
-3. **Мигрируйте клиентов на новый RPC:**
-   ```go
-   resp, err := client.GetUserV2(ctx, &myapi.GetUserRequest{
-       UserId: userID,
-   })
-   if err != nil {
-       return err
-   }
-   profile := resp.Profile
-   permissions := resp.Permissions
-   ```
-
-4. **Удалите старый RPC** в следующей major‑версии:
-   ```proto
-   rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2);
-   ```
-
-## Типовые сценарии
-
-### Добавление новых обязательных полей
-```proto
-// ПЛОХО: меняем существующий тип
-message GetUserResponse {
-  string user_id = 1;
-  string name = 2;
-  UserProfile profile = 3; // BREAKING
-}
-
-// Хорошо: новая версия
-message GetUserResponseV2 {
-  string user_id = 1;
-  string name = 2;
-  UserProfile profile = 3;
-}
-```
-
-### Реструктуризация ответа
-```proto
-// ПЛОХО: меняем структуру прямо
-message UpdateUserResponse {
-  UserDetails details = 1; // BREAKING
-}
-
-// Хорошо: версионирование
-rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) {
-  option deprecated = true;
-}
-rpc UpdateUserV2(UpdateUserRequest) returns (UpdateUserResponseV2);
-```
-
-### Изменение формата ошибок
-```proto
-// ПЛОХО: меняем формат напрямую
-message CreateUserResponse {
-  ErrorDetails error = 1; // BREAKING
-}
-
-// Хорошо: новая версия
-rpc CreateUser(CreateUserRequest) returns (CreateUserResponse) {
-  option deprecated = true;
-}
-rpc CreateUserV2(CreateUserRequest) returns (CreateUserResponseV2);
-```
-
-### Миграция формата
-```proto
-// ПЛОХО: перевод простой структуры в сложную
-message GetUserResponse {
-  UserData data = 1; // BREAKING
-}
-
-// Хорошо: предоставляем обе версии
-rpc GetUser(GetUserRequest) returns (GetUserResponse) {
-  option deprecated = true;
-}
-rpc GetUserDetailed(GetUserRequest) returns (GetUserDetailedResponse);
-```
diff --git a/docs/public/docs/ru-guide/cli/breaking-changes/rules/service-no-delete.md b/docs/public/docs/ru-guide/cli/breaking-changes/rules/service-no-delete.md
deleted file mode 100644
index 58b47ff3..00000000
--- a/docs/public/docs/ru-guide/cli/breaking-changes/rules/service-no-delete.md
+++ /dev/null
@@ -1,89 +0,0 @@
-<!-- TODO: Review translation -->
-
-# SERVICE_NO_DELETE
-
-Категории:
-
-- **WIRE+**
-
-Данное правило проверяет, что ни один service не был удалён из proto‑файлов. Удаление service ломает сгенерированный код и клиентские приложения, которые на него опираются.
-
-## Примеры
-
-### Плохой (Breaking)
-
-**До:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-service OrderService { // [!code --]
-  rpc GetOrder(GetOrderRequest) returns (GetOrderResponse); // [!code --]
-} // [!code --]
-```
-
-**После:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-// OrderService удалён — BREAKING CHANGE!
-```
-
-**Ошибка:**
-```
-services.proto:8:1: Previously present service "OrderService" was deleted from file. (BREAKING_CHECK)
-```
-
-### Хороший (Безопасный)
-
-**Вместо удаления — отметьте service как deprecated:**
-```proto
-syntax = "proto3";
-
-package myapi.v1;
-
-service UserService {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
-}
-
-service OrderService {
-  option deprecated = true; // [!code focus]
-  rpc GetOrder(GetOrderRequest) returns (GetOrderResponse) {
-    option deprecated = true; // [!code focus]
-  }
-}
-```
-
-## Влияние
-
-- **Generated Code:** Классы / интерфейсы сервиса исчезают — клиенты не компилируются
-- **Client Applications:** Существующие вызовы к удалённому сервису падают на этапе сборки
-- **Runtime:** gRPC клиенты теряют определение метода/сервиса
-
-## Стратегия миграции
-
-1. **Сначала деприкация:**
-   ```proto
-   service OldService {
-     option deprecated = true;
-     // ... methods
-   }
-   ```
-
-2. **Уведомите клиентов** о сроках вывода из эксплуатации
-
-3. **Удалите после периода миграции** в следующей major‑версии
\ No newline at end of file
diff --git a/docs/public/docs/ru-guide/cli/configuration/configuration.md b/docs/public/docs/ru-guide/cli/configuration/configuration.md
deleted file mode 100644
index 4a2c722e..00000000
--- a/docs/public/docs/ru-guide/cli/configuration/configuration.md
+++ /dev/null
@@ -1,930 +0,0 @@
-# EasyP Configuration Reference
-
-EasyP can be configured through CLI flags, environment variables, and configuration files. This guide covers all configuration options available in EasyP.
-
-## CLI Flags
-
-### Global Flags
-
-Available for all commands:
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--cfg` | `-c` | `EASYP_CFG` | Configuration file path | `easyp.yaml` |
-| `--config` | | `EASYP_CFG` | Alias for `--cfg` | `easyp.yaml` |
-| `--debug` | `-d` | `EASYP_DEBUG` | Enable debug mode | `false` |
-| `--format` | `-f` | `EASYP_FORMAT` | Формат вывода для команд с поддержкой нескольких форматов (`text`/`json`) | значение по умолчанию зависит от команды |
-
-**Examples:**
-```bash
-# Use custom config file
-easyp --cfg production.easyp.yaml lint
-
-# Enable debug logging
-easyp --debug lint
-
-# Short form
-easyp -c custom.yaml -d lint
-```
-
-### Command-Specific Flags
-
-**Lint command:**
-```bash
-easyp lint [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--path` | `-p` | | Directory path to lint | `.` |
-| `--root` | `-r` | | Базовая директория для поиска файлов | Текущая рабочая директория |
-| `--format` | `-f` | `EASYP_FORMAT` | Использует глобальный флаг формата (`text`/`json`) | Использует глобальное значение по умолчанию |
-
-**Examples:**
-```bash
-# Lint specific directory
-easyp lint --path proto/
-
-# Lint из поддиректории с правильным разрешением импортов
-easyp lint --root src/IPC/Contracts --path .
-
-# JSON output format
-easyp --format json lint   # глобальный флаг
-
-# Combined flags
-easyp -f json lint -p proto/
-```
-
-**Generate command:**
-```bash
-easyp generate [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--path` | `-p` | `EASYP_ROOT_GENERATE_PATH` | Путь к директории с proto файлами для генерации | `.` |
-| `--root` | `-r` | | Базовая директория для поиска файлов | Текущая рабочая директория |
-
-**Examples:**
-```bash
-# Generate from specific path
-easyp generate --path api/
-
-# Generate из поддиректории с правильным разрешением импортов
-easyp generate --root src/IPC/Contracts --path .
-
-# Using environment variable
-EASYP_ROOT_GENERATE_PATH=proto/ easyp generate
-```
-
-**Breaking command:**
-```bash
-easyp breaking [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--against` | | | Git ref to compare against | `master` |
-| `--path` | `-p` | | Directory path to check | `.` |
-| `--format` | `-f` | `EASYP_FORMAT` | Использует глобальный флаг формата (`text`/`json`) | Использует глобальное значение по умолчанию |
-
-**Examples:**
-```bash
-# Check against main branch
-easyp breaking --against main
-
-# Check specific directory against develop branch
-easyp breaking --against develop --path proto/
-
-# JSON output
-easyp --format json breaking --against main   # глобальный флаг
-```
-
-**Init command:**
-```bash
-easyp init [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--dir` | `-d` | `EASYP_INIT_DIR` | Directory to initialize | `.` |
-
-**Examples:**
-```bash
-# Initialize current directory
-easyp init
-
-# Initialize specific directory
-easyp init --dir proto-project/
-```
-
-`easyp init` работает интерактивно:
-- Если в корне целевой директории есть `buf.yml`/`buf.yaml`, команда предложит миграцию из Buf.
-- Если `easyp.yaml` уже существует, команда запросит подтверждение на перезапись.
-
-**Validate-config command:**
-```bash
-easyp validate-config [flags]
-```
-
-| Flag | Short | Environment | Description | Default |
-|------|-------|-------------|-------------|---------|
-| `--config` | `-c` | `EASYP_CFG` | Путь до файла конфигурации | `easyp.yaml` |
-| `--format` (global) | `-f` | `EASYP_FORMAT` | Глобальный формат вывода для команд с несколькими форматами (`json` или `text`) | зависит от команды (`json` для `validate-config`) |
-
-**Examples:**
-```bash
-# Проверить конфиг по умолчанию с JSON выводом (статус 0 если ошибок нет)
-easyp validate-config
-
-# Проверить другой файл и вывести в текстовом формате (глобальный --format)
-easyp --format text validate-config --config example.easyp.yaml
-```
-
-**Package management commands:**
-
-#### `easyp mod download`
-Downloads dependencies based on lock file priority:
-
-1. **If `easyp.lock` exists** - downloads exact versions from lock file
-2. **If `easyp.lock` is missing** - downloads versions from `easyp.yaml` and creates `easyp.lock`
-
-```bash
-# Download exact versions (recommended for production)
-easyp mod download
-```
-
-#### `easyp mod update`  
-Always downloads dependencies from `easyp.yaml`, ignoring existing lock file:
-
-1. **Ignores `easyp.lock`** completely
-2. **Downloads versions from `easyp.yaml`**
-3. **Creates/updates `easyp.lock`** with new versions
-
-```bash
-# Update dependencies and lock file
-easyp mod update
-```
-
-#### `easyp mod vendor`
-Copies proto files from dependencies to local `vendor/` directory (similar to `go mod vendor`).
-
-```bash
-# Create local vendor directory with dependencies
-easyp mod vendor
-```
-
-No additional flags. Uses global `--cfg` flag for configuration.
-
-## Environment Variables
-
-EasyP supports environment variables for configuration:
-
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `EASYP_CFG` | Path to configuration file | `easyp.yaml` |
-| `EASYP_DEBUG` | Enable debug logging | `false` |
-| `EASYPPATH` | Cache and modules storage directory | `$HOME/.easyp` |
-| `EASYP_FORMAT` | Формат вывода для поддерживаемых команд (`text`/`json`). Если не указан, каждая команда использует своё значение по умолчанию. | значение по умолчанию зависит от команды |
-| `EASYP_ROOT_GENERATE_PATH` | Root path for generate command | `.` |
-| `EASYP_INIT_DIR` | Directory for init command | `.` |
-
-**Examples:**
-```bash
-# Custom cache directory
-export EASYPPATH=/tmp/easyp-cache
-easyp mod download
-
-# Debug mode via environment
-export EASYP_DEBUG=true
-easyp lint
-
-# Custom config file
-export EASYP_CFG=config/easyp.yaml
-easyp generate
-```
-
-## Configuration File
-
-The `easyp.yaml` file is the main configuration file for EasyP, defining how your proto files are linted, generated, and managed. This file is typically placed at the root of your project alongside your proto files.
-
-### File Structure Overview
-
-```
-.
-├── easyp.yaml
-├── easyp.lock
-├── proto/
-│   ├── user/
-│   │   └── user.proto
-│   └── order/
-│       └── order.proto
-└── vendor/
-```
-
-### Configuration Format
-
-EasyP supports both YAML and JSON configuration formats:
-
-#### YAML Format (Recommended)
-```yaml
-lint:
-  use:
-    - BASIC
-    - COMMENT_SERVICE
-deps:
-  - github.com/googleapis/googleapis@v1.0.0
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-breaking:
-  ignore:
-    - proto/experimental/
-  against_git_ref: main
-```
-
-#### JSON Format
-```json
-{
-  "lint": {
-    "use": ["BASIC", "COMMENT_SERVICE"]
-  },
-  "deps": [
-    "github.com/googleapis/googleapis@v1.0.0"
-  ],
-  "generate": {
-    "inputs": [
-      {"directory": "proto"}
-    ],
-    "plugins": [
-      {
-        "name": "go",
-        "out": ".",
-        "opts": {
-          "paths": "source_relative"
-        }
-      }
-    ]
-  },
-  "breaking": {
-    "ignore": ["proto/experimental/"],
-    "against_git_ref": "main"
-  }
-}
-```
-
-### Переменные окружения в конфигурации
-
-EasyP поддерживает расширение переменных окружения непосредственно в файле конфигурации `easyp.yaml`. Это позволяет использовать переменные окружения для динамических значений конфигурации.
-
-**Пример со всеми поддерживаемыми возможностями:**
-```yaml
-deps:
-  # Базовое расширение: ${VAR} - расширяется в значение переменной VAR
-  - ${GOOGLEAPIS_REPO}@${GOOGLEAPIS_VERSION}
-  
-  # Значение по умолчанию: ${VAR:-default} - использует default, если VAR не установлена или пустая
-  - ${GNOSTIC_REPO:-github.com/google/gnostic}@${GNOSTIC_VERSION:-v0.7.0}
-
-generate:
-  inputs:
-    # Значение по умолчанию, если INPUT_DIR не установлена
-    - directory: ${INPUT_DIR:-proto}
-  plugins:
-    - name: go
-      # Базовое расширение
-      out: ${OUTPUT_DIR}
-      opts:
-        # Значение по умолчанию
-        module: ${MODULE_NAME:-github.com/example/project}
-        timeout: ${TIMEOUT:-30}
-        
-        # Экранирование: $$ становится буквальным $, $${VAR} становится буквальным ${VAR}
-        path: "${BASE_DIR}/$${TEMP}/file"         # Результат: "/tmp/${TEMP}/file" (если BASE_DIR=/tmp)
-        literal: "$$"                             # Результат: "$"
-```
-
-**Поддерживаемый синтаксис:**
-- `${VAR}` - расширяется в значение переменной `VAR`
-- `${VAR:-default}` - использует `default`, если `VAR` не установлена или пустая
-- `${VAR:=default}` - использует `default`, если `VAR` не установлена или пустая
-- `${VAR-default}` - использует `default`, если `VAR` не установлена (пустая строка сохраняется)
-- `$${VAR}` или `$$VAR` - экранирует в буквальную строку `${VAR}` или `$VAR`
-- `$$` - экранирует в буквальный символ `$`
-
-**Примечание:** Переменные окружения расширяются до парсинга YAML, поэтому любой паттерн `${STRING}` будет обработан. Используйте `$$` для экранирования символов доллара, когда нужны буквальные значения.
-
-## Configuration Fields
-
-### `version`
-
-**Опционально (legacy-совместимость).** Поле поддерживается для обратной совместимости и может быть опущено в новых конфигурациях.
-
-**Type:** `string`
-**Default:** не задано
-**Рекомендация:** если сохраняете поле, используйте `v1alpha`
-
-```yaml
-# Опциональное поле для совместимости (можно опустить)
-version: v1alpha
-```
-
-На поведение рантайма это поле не влияет.
-
-### `lint`
-
-**Optional.** Configures proto file linting rules and behavior.
-
-**Type:** `object`
-**Default:** Empty (no linting rules applied)
-
-```yaml
-lint:
-  use:
-    - BASIC
-    - COMMENT_SERVICE
-  enum_zero_value_suffix: "UNSPECIFIED"
-  service_suffix: "Service"
-  ignore:
-    - vendor/
-    - proto/legacy/
-  except:
-    - COMMENT_FIELD
-  allow_comment_ignores: true
-  ignore_only:
-    COMMENT_SERVICE:
-      - proto/experimental/
-```
-
-#### `lint.use`
-
-**Optional.** Specifies which linter rules or rule categories to apply.
-
-**Type:** `[]string`
-**Default:** `[]` (no rules)
-
-**Available categories:**
-- `MINIMAL` - Essential package consistency checks
-- `BASIC` - Naming conventions and common patterns
-- `DEFAULT` - Additional recommended rules
-- `COMMENTS` - Comment requirements
-- `UNARY_RPC` - Streaming RPC restrictions
-
-**Individual rules:** Any specific rule name (e.g., `ENUM_PASCAL_CASE`, `FIELD_LOWER_SNAKE_CASE`)
-
-```yaml
-lint:
-  use:
-    - MINIMAL           # Use all minimal rules
-    - BASIC             # Use all basic rules
-    - COMMENT_SERVICE   # Require service comments
-    - ENUM_PASCAL_CASE  # Specific rule
-```
-
-**Rule Categories:**
-
-**MINIMAL:**
-- `DIRECTORY_SAME_PACKAGE`
-- `PACKAGE_DEFINED`
-- `PACKAGE_DIRECTORY_MATCH`
-- `PACKAGE_SAME_DIRECTORY`
-
-**BASIC:**
-- `ENUM_FIRST_VALUE_ZERO`
-- `ENUM_NO_ALLOW_ALIAS`
-- `ENUM_PASCAL_CASE`
-- `ENUM_VALUE_UPPER_SNAKE_CASE`
-- `FIELD_LOWER_SNAKE_CASE`
-- `IMPORT_NO_PUBLIC`
-- `IMPORT_NO_WEAK`
-- `IMPORT_USED`
-- `MESSAGE_PASCAL_CASE`
-- `ONEOF_LOWER_SNAKE_CASE`
-- `PACKAGE_LOWER_SNAKE_CASE`
-- `PACKAGE_SAME_CSHARP_NAMESPACE`
-- `PACKAGE_SAME_GO_PACKAGE`
-- `PACKAGE_SAME_JAVA_MULTIPLE_FILES`
-- `PACKAGE_SAME_JAVA_PACKAGE`
-- `PACKAGE_SAME_PHP_NAMESPACE`
-- `PACKAGE_SAME_RUBY_PACKAGE`
-- `PACKAGE_SAME_SWIFT_PREFIX`
-- `RPC_PASCAL_CASE`
-- `SERVICE_PASCAL_CASE`
-
-**DEFAULT:**
-- `ENUM_VALUE_PREFIX`
-- `ENUM_ZERO_VALUE_SUFFIX`
-- `FILE_LOWER_SNAKE_CASE`
-- `RPC_REQUEST_RESPONSE_UNIQUE`
-- `RPC_REQUEST_STANDARD_NAME`
-- `RPC_RESPONSE_STANDARD_NAME`
-- `PACKAGE_VERSION_SUFFIX`
-- `SERVICE_SUFFIX`
-
-**COMMENTS:**
-- `COMMENT_ENUM`
-- `COMMENT_ENUM_VALUE`
-- `COMMENT_FIELD`
-- `COMMENT_MESSAGE`
-- `COMMENT_ONEOF`
-- `COMMENT_RPC`
-- `COMMENT_SERVICE`
-
-**UNARY_RPC:**
-- `RPC_NO_CLIENT_STREAMING`
-- `RPC_NO_SERVER_STREAMING`
-
-#### `lint.enum_zero_value_suffix`
-
-**Optional.** Specifies the required suffix for enum zero values.
-
-**Type:** `string`
-**Default:** `""` (no suffix required)
-**Common values:** `"UNSPECIFIED"`, `"UNKNOWN"`, `"DEFAULT"`
-
-```yaml
-lint:
-  enum_zero_value_suffix: "UNSPECIFIED"
-```
-
-This enforces enum zero values like:
-```proto
-enum Status {
-  STATUS_UNSPECIFIED = 0;  // Required suffix
-  STATUS_ACTIVE = 1;
-  STATUS_INACTIVE = 2;
-}
-```
-
-#### `lint.service_suffix`
-
-**Optional.** Specifies the required suffix for service names.
-
-**Type:** `string`
-**Default:** `""` (no suffix required)
-**Common values:** `"Service"`, `"API"`, `"Svc"`
-
-```yaml
-lint:
-  service_suffix: "Service"
-```
-
-This enforces service names like:
-```proto
-service UserService {    // Required "Service" suffix
-  rpc GetUser(...) returns (...);
-}
-```
-
-#### `lint.ignore`
-
-**Optional.** Directories or files to exclude from all linting rules.
-
-**Type:** `[]string`
-**Default:** `[]`
-
-```yaml
-lint:
-  ignore:
-    - vendor/
-    - proto/legacy/
-    - testdata/
-    - "**/*_test.proto"
-```
-
-Paths are relative to the `easyp.yaml` file location. Supports glob patterns.
-
-#### `lint.except`
-
-**Optional.** Disables specific rules globally across the entire project.
-
-**Type:** `[]string`
-**Default:** `[]`
-
-```yaml
-lint:
-  except:
-    - COMMENT_FIELD
-    - COMMENT_MESSAGE
-    - SERVICE_SUFFIX
-```
-
-#### `lint.allow_comment_ignores`
-
-**Optional.** Enables inline comment-based rule ignoring within proto files.
-
-**Type:** `boolean`
-**Default:** `false`
-
-```yaml
-lint:
-  allow_comment_ignores: true
-```
-
-When enabled, allows comments like:
-```proto
-// buf:lint:ignore COMMENT_SERVICE
-service LegacyAPI {
-  // nolint:COMMENT_RPC
-  rpc GetData(...) returns (...);
-}
-```
-
-#### `lint.ignore_only`
-
-**Optional.** Disables specific rules only for certain files or directories.
-
-**Type:** `map[string][]string`
-**Default:** `{}`
-
-```yaml
-lint:
-  ignore_only:
-    COMMENT_SERVICE:
-      - proto/legacy/
-      - vendor/
-    SERVICE_SUFFIX:
-      - proto/external/
-```
-
-**Key:** Rule name or category
-**Value:** Array of file paths or directories
-
-### `deps`
-
-**Optional.** Lists external proto dependencies to download and manage.
-
-**Type:** `[]string`  
-**Default:** `[]`
-
-#### Dependency Format
-
-Dependencies follow the format: `$GIT_LINK@$VERSION`
-
-**Components:**
-- `$GIT_LINK` - Git repository URL (GitHub, GitLab, etc.)
-- `$VERSION` - Git tag or full commit hash (optional)
-
-**Format variations:**
-- `owner/repo` - Latest commit from default branch
-- `owner/repo@v1.0.0` - Specific git tag
-- `owner/repo@47b927cbb41c4fdea1292baf` - Full commit hash
-- `github.com/owner/repo@version` - Full URL with version
-- `gitlab.com/group/repo@tag` - GitLab repository
-
-```yaml
-deps:
-  # Latest commit from default branch
-  - googleapis/googleapis
-  
-  # Specific tag (recommended for production)
-  - googleapis/googleapis@v1.0.0
-  
-  # Full commit hash (most precise)
-  - googleapis/googleapis@47b927cbb41c4fdea1292bafadb8976f
-  
-  # Different Git hosting
-  - gitlab.com/acme/proto@v2.1.0
-```
-
-**Note:** If `@$VERSION` is omitted, EasyP downloads the latest commit from the repository's default branch.
-
-### `generate`
-
-**Optional.** Configures code generation from proto files.
-
-**Type:** `object`
-**Default:** `{}`
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-    - git_repo:
-        url: "github.com/acme/common@v1.0.0"
-        sub_directory: "proto"
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-```
-
-#### `generate.inputs`
-
-**Required when `generate` is set.** Specifies sources of proto files for generation.
-
-**Type:** `[]object` (minimum 1 item)
-**Default:** not set
-
-```yaml
-generate:
-  inputs:
-    # Local directory
-    - directory: "proto"
-
-    # Local directory with advanced options
-    - directory:
-        path: "api/proto"
-        root: "."
-
-    # Remote git repository
-    - git_repo:
-        url: "github.com/acme/common@v1.0.0"
-        sub_directory: "proto"
-        root: "."
-```
-
-**Directory input fields:**
-- `directory` (string or object) - Local directory path
-- `directory.path` (string) - Directory path
-- `directory.root` (string) - Root path for import resolution (default: ".")
-
-**Git repository input fields:**
-- `git_repo.url` (string) - Repository URL with optional version
-- `git_repo.sub_directory` (string) - Subdirectory within the repository
-- `git_repo.root` (string) - Root path used for import resolution
-
-#### `generate.plugins`
-
-**Required when `generate` is set.** Configures protoc plugins for code generation.
-
-**Type:** `[]object` (minimum 1 item)
-**Default:** not set
-
-```yaml
-generate:
-  plugins:
-    # Local plugin
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-
-    # Remote plugin
-    - remote: "buf.build/bufbuild/protovalidate-go:v0.4.0"
-      out: gen/go
-      opts:
-        paths: source_relative
-
-    # Plugin with import dependencies
-    - name: grpc-gateway
-      out: .
-      with_imports: true
-      opts:
-        paths: source_relative
-```
-
-**Plugin fields:**
-- `name` (string, optional) - Plugin name (omit `protoc-gen-` prefix)
-- `remote` (string, optional) - Remote plugin URL for execution
-- `path` (string, optional) - Path to plugin executable file
-- `command` ([]string, optional) - Command to execute plugin
-- `out` (string, optional) - Output directory for generated files; defaults to the resolved generate root
-- `opts` (map[string](string | number | boolean | array<string | number | boolean>), optional) - Plugin-specific options; each key can be a single scalar value or an array of scalar values
-- `with_imports` (boolean, optional) - Include imported dependencies
-
-Plugin source is `one-of`: exactly one of `name`, `remote`, `path`, or `command` must be set.
-
-**Common plugin options:**
-```yaml
-# Go plugin options
-opts:
-  paths: source_relative              # Generate files relative to input
-  module: github.com/acme/api        # Go module path
-
-# gRPC Gateway options
-opts:
-  paths: source_relative
-  grpc_api_configuration: api.yaml   # gRPC API configuration
-
-# OpenAPI v2 options
-opts:
-  simple_operation_ids: true         # Use simple operation IDs
-  generate_unbound_methods: false    # Skip unbound methods
-
-# ts-proto options with repeated key values
-opts:
-  env: node
-  outputServices:
-    - grpc-js
-    - generic-definitions
-```
-
-When an `opts` value is a list, EasyP serializes it as repeated plugin params, e.g. `outputServices=grpc-js,outputServices=generic-definitions`.
-
-### `breaking`
-
-**Optional.** Configures backward compatibility checking.
-
-**Type:** `object`
-**Default:** `{}`
-
-```yaml
-breaking:
-  ignore:
-    - proto/experimental/
-    - proto/internal/
-  against_git_ref: main
-```
-
-#### `breaking.ignore`
-
-**Optional.** Directories or files to exclude from breaking change detection.
-
-**Type:** `[]string`
-**Default:** `[]`
-
-```yaml
-breaking:
-  ignore:
-    - proto/experimental/
-    - proto/alpha/
-    - testdata/
-```
-
-#### `breaking.against_git_ref`
-
-**Optional.** Git reference (branch, tag, or commit) to compare against for breaking changes.
-
-**Type:** `string`
-**Default:** `""` (falls back to CLI `--against` default: `master`)
-
-```yaml
-breaking:
-  against_git_ref: main
-```
-
-Can be overridden by the `--against` CLI flag.
-
-
-
-## Configuration Examples
-
-### Minimal Configuration
-
-```yaml
-lint:
-  use:
-    - MINIMAL
-```
-
-### Development Configuration
-
-```yaml
-lint:
-  use:
-    - BASIC
-    - COMMENT_SERVICE
-    - COMMENT_RPC
-  allow_comment_ignores: true
-  ignore:
-    - vendor/
-    - testdata/
-deps:
-  - github.com/googleapis/googleapis@v1.0.0
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-```
-
-### Production Configuration
-
-```yaml
-lint:
-  use:
-    - MINIMAL
-    - BASIC
-    - DEFAULT
-    - COMMENTS
-  enum_zero_value_suffix: "UNSPECIFIED"
-  service_suffix: "Service"
-  ignore:
-    - vendor/
-  except: []
-  allow_comment_ignores: false
-deps:
-  - github.com/googleapis/googleapis@v1.56.0
-  - github.com/grpc-ecosystem/grpc-gateway@v2.18.0
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-        module: github.com/acme/api/gen/go
-    - name: go-grpc
-      out: gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-    - name: grpc-gateway
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: openapiv2
-      out: gen/openapi
-      opts:
-        simple_operation_ids: true
-breaking:
-  ignore:
-    - proto/experimental/
-  against_git_ref: main
-```
-
-### Multi-Service Configuration
-
-```yaml
-lint:
-  use:
-    - BASIC
-    - COMMENT_SERVICE
-    - COMMENT_RPC
-  service_suffix: "Service"
-  ignore_only:
-    COMMENT_FIELD:
-      - proto/internal/
-    SERVICE_SUFFIX:
-      - proto/legacy/
-deps:
-  - github.com/googleapis/googleapis@v1.0.0
-  - github.com/acme/common-proto@v2.1.0
-generate:
-  inputs:
-    - directory: "proto/public"
-    - directory: "proto/internal"
-    - git_repo:
-        url: "github.com/acme/shared-proto@v1.0.0"
-        sub_directory: "proto"
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: grpc-gateway
-      out: gen/go
-      opts:
-        paths: source_relative
-    - remote: "buf.build/bufbuild/protovalidate-go:v0.4.0"
-      out: gen/go
-      opts:
-        paths: source_relative
-breaking:
-  ignore:
-    - proto/internal/
-    - proto/experimental/
-  against_git_ref: develop
-```
-
-## Configuration Validation
-
-EasyP validates configuration files on startup and provides helpful error messages:
-
-```bash
-# Invalid rule name
-Error: invalid rule: INVALID_RULE_NAME
-
-# Missing required field in generate section
-Error: required field "plugins" is missing (path: generate.plugins)
-
-# Invalid dependency format
-Error: invalid dependency format: invalid-repo-url
-```
-
-Use `easyp --debug` for detailed validation information.
-
-## Migration from Buf
-
-EasyP is fully compatible with Buf configurations. To migrate:
-
-1. Place `buf.yaml` or `buf.yml` in the project root
-2. Run `easyp init` and confirm migration when prompted
-3. Update `deps` format if using BSR modules
-4. Review migrated lint/breaking settings and adjust as needed
-
-Most Buf configurations work without changes in EasyP.
diff --git a/docs/public/docs/ru-guide/cli/generator/examples/go.md b/docs/public/docs/ru-guide/cli/generator/examples/go.md
deleted file mode 100644
index bd9680e9..00000000
--- a/docs/public/docs/ru-guide/cli/generator/examples/go.md
+++ /dev/null
@@ -1,81 +0,0 @@
-# Go
-
-## Установка плагинов
-
-Сначала установите необходимые плагины для работы с gRPC:
-
-```shell
-go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
-go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
-```
-
-Эти команды установят плагины `protoc-gen-go` и `protoc-gen-go-grpc` для использования с EasyP.
-
-## Пример proto‑сервиса
-
-Ниже пример proto-файла для сервиса Echo:
-
-```proto
-syntax = "proto3";
-
-package api.echo.v1;
-
-option go_package = "github.com/easyp-tech/example/api/echo/v1;pb";
-
-service EchoAPI {
-  rpc Echo(EchoRequest) returns (EchoResponse);
-  rpc EchoStream(EchoStreamRequest) returns (EchoResponse);
-}
-
-message EchoRequest {
-  string payload = 1;
-}
-
-message EchoResponse {
-  string payload = 2;
-}
-
-message EchoStreamRequest {
-  string payload = 1;
-}
-
-message EchoStreamResponse {
-  string payload = 2;
-}
-```
-
-## Настройка конфигурации
-
-Создайте и настройте файл конфигурации `easyp.yaml`:
-
-```yaml
-generate:
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-```
-
-Этот файл указывает использование двух плагинов: `go` для генерации Go-кода и `go-grpc` для генерации gRPC-кода, вместе с их опциями.
-
-## Генерация кода
-
-Чтобы сгенерировать код, выполните команду:
-
-```shell
-easyp --cfg easyp.yaml generate
-```
-
-Если флаг `--cfg` не указан, по умолчанию используется файл `easyp.yaml` в текущей директории:
-
-```shell
-easyp generate
-```
-
-Теперь у вас есть сгенерированный Go‑код, с которым можно напрямую работать.
\ No newline at end of file
diff --git a/docs/public/docs/ru-guide/cli/generator/examples/grpc-gateway.md b/docs/public/docs/ru-guide/cli/generator/examples/grpc-gateway.md
deleted file mode 100644
index da53345b..00000000
--- a/docs/public/docs/ru-guide/cli/generator/examples/grpc-gateway.md
+++ /dev/null
@@ -1,112 +0,0 @@
-# gRPC-Gateway
-
-## Установка плагинов
-
-В дополнение к плагинам для работы с gRPC, необходимо установить следующие плагины для gRPC-Gateway:
-
-    go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
-    go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
-    go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2@latest
-    go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest
-
-Эти команды установят плагины `protoc-gen-go`, `protoc-gen-go-grpc`, `protoc-gen-openapiv2` и
-`protoc-gen-grpc-gateway` для использования с EasyP.
-
-## Пример Proto сервиса
-
-Ниже — исходный proto‑файл для сервиса Echo:
-
-    syntax = "proto3";
-
-    package api.echo.v1;
-
-    option go_package = "github.com/easyp-tech/example/api/echo/v1;pb";
-
-    service EchoAPI {
-      rpc Echo(EchoRequest) returns (EchoResponse);
-    }
-
-    message EchoRequest {
-      string payload = 1;
-    }
-
-    message EchoResponse {
-      string payload = 2;
-    }
-
-Чтобы использовать gRPC-Gateway, обновите proto‑файл, добавив HTTP‑опции:
-
-    syntax = "proto3";
-    import "google/api/annotations.proto";
-
-    package api.echo.v1;
-
-    option go_package = "github.com/easyp-tech/example/api/echo/v1;pb";
-
-    service EchoAPI {
-      rpc Echo(EchoRequest) returns (EchoResponse) {
-        option (google.api.http) = { // [!code ++]
-          post: "/api/v1/echo"       // [!code ++]
-          body: "*"                  // [!code ++]
-        };                           // [!code ++]
-      }
-    }
-
-    message EchoRequest {
-      string payload = 1;
-    }
-
-    message EchoResponse {
-      string payload = 2;
-    }
-
-## Настройка конфигурации
-
-Обновите файл `easyp.yaml`, добавив необходимые зависимости и плагины:
-    deps:  # [!code ++]
-      - github.com/googleapis/googleapis  # [!code ++]
-
-    generate:
-      plugins:
-        - name: go
-          out: .
-          opts:
-            paths: source_relative
-        - name: go-grpc
-          out: .
-          opts:
-            paths: source_relative
-            require_unimplemented_servers: false
-        - name: grpc-gateway  # [!code ++]
-          out: .  # [!code ++]
-          opts:  # [!code ++]
-            paths: source_relative  # [!code ++]
-        - name: openapiv2        # [!code ++]
-          out: .  # [!code ++]
-          opts: # [!code ++]
-            simple_operation_ids: false  # [!code ++]
-            generate_unbound_methods: false  # [!code ++]
-
-Секция `deps` перечисляет зависимости, необходимые для импортов proto‑файлов.
-В данном случае добавляем `github.com/googleapis/googleapis`,
-поскольку там находится файл `annotations.proto`, используемый в определении сервиса.
-
-### Обновление зависимостей
-
-После обновления конфигурации выполните команду для загрузки указанных зависимостей:
-
-    easyp mod update
-
-Больше деталей по управлению зависимостями см. в разделе [Package Manager](../../package-manager/package-manager.md).
-
-## Генерация кода
-
-Для генерации кода используйте:
-
-    easyp --cfg easyp.yaml generate
-
-Если флаг `--cfg` не указан, по умолчанию используется файл `easyp.yaml` из текущей директории:
-
-    easyp generate
-
-Теперь у вас сгенерированы Go‑код и код gRPC-Gateway, с которыми можно работать напрямую.
\ No newline at end of file
diff --git a/docs/public/docs/ru-guide/cli/generator/examples/validate.md b/docs/public/docs/ru-guide/cli/generator/examples/validate.md
deleted file mode 100644
index 38c638d9..00000000
--- a/docs/public/docs/ru-guide/cli/generator/examples/validate.md
+++ /dev/null
@@ -1,90 +0,0 @@
-# Validate
-
-## Установка плагинов
-
-Сначала установите необходимые плагины для работы с gRPC и проверок (validate):
-
-```shell
-go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
-go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
-go install github.com/envoyproxy/protoc-gen-validate@latest
-```
-
-Эти команды установят плагины `protoc-gen-go`, `protoc-gen-go-grpc` и `protoc-gen-validate` для использования вместе с EasyP.
-
-## Пример Proto сервиса
-
-Ниже пример proto‑файла для сервиса Echo:
-
-```proto
-syntax = "proto3";
-
-package api.echo.v1;
-
-import "validate/validate.proto";
-
-option go_package = "github.com/easyp-tech/example/api/echo/v1;pb";
-
-service EchoAPI {
-  rpc Echo(EchoRequest) returns (EchoResponse);
-  rpc EchoStream(EchoStreamRequest) returns (EchoResponse);
-}
-
-message EchoRequest {
-  string payload = 1 [(validate.rules).string = {max_len: 200}];
-}
-
-message EchoResponse {
-  string payload = 2;
-}
-
-message EchoStreamRequest {
-  string payload = 1 [(validate.rules).string = {max_len: 200}];
-}
-
-message EchoStreamResponse {
-  string payload = 2;
-}
-```
-
-## Настройка конфигурации
-
-Создайте и настройте файл конфигурации `easyp.yaml`:
-
-```yaml
-deps: # [!code ++]
-  - github.com/bufbuild/protoc-gen-validate  # [!code ++]
-
-generate:
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-    - name: validate
-      out: .
-      opts:
-        paths: source_relative
-        lang: "go"
-```
-
-## Генерация кода
-
-Чтобы сгенерировать код, выполните команду:
-
-```shell
-easyp --cfg easyp.yaml generate
-```
-
-Если флаг `--cfg` не указан, по умолчанию используется файл `easyp.yaml` из текущего каталога:
-
-```shell
-easyp generate
-```
-
-Теперь у вас есть сгенерированный Go‑код с поддержкой валидации, и вы можете напрямую использовать его в проекте.
\ No newline at end of file
diff --git a/docs/public/docs/ru-guide/cli/generator/generator.md b/docs/public/docs/ru-guide/cli/generator/generator.md
deleted file mode 100644
index 88582b07..00000000
--- a/docs/public/docs/ru-guide/cli/generator/generator.md
+++ /dev/null
@@ -1,1325 +0,0 @@
-# Генератор
-
-[[toc]]
-
-EasyP включает мощный генератор, который упрощает процесс получения кода из proto‑файлов. Благодаря YAML‑конфигурациям работа становится гораздо более удобной и интуитивной по сравнению с прямым использованием команды protoc.
-
-## Ключевые особенности генератора
-
-1. **Упрощённая генерация кода**:
-    - Генерация кода из proto через декларативную `YAML`‑конфигурацию.
-    - Избавляет от необходимости писать длинные и сложные команды protoc.
-
-2. **Обёртка над protoc**:
-    - EasyP выступает как удобный слой над protoc, предоставляя декларативный API.
-    - Поддерживает все опции и плагины, доступные protoc.
-
-3. **Гибкость и кастомизация**:
-    - Используются те же параметры, что и у плагинов protoc, прямо в конфиге.
-    - Поддерживается множество плагинов и их параметры в одной конфигурации.
-
-4. **Генерация из нескольких источников**:
-    - Локальные директории и удалённые Git‑репозитории одновременно.
-    - Лёгкая интеграция с существующими проектами и репозиториями.
-
-5. **Удалённая генерация**:
-    - Генерация из удалённых Git репозиториев без локального checkout.
-
-6. **Интеграция с менеджером пакетов**:
-    - Прозрачная работа с зависимостями через пакетный менеджер EasyP.
-    - Автоматическое разрешение и подключение proto‑зависимостей.
-
-## Configuration Reference
-
-### Complete Configuration Example
-
-```yaml
-# Package manager dependencies
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-  - github.com/bufbuild/protoc-gen-validate@v0.10.1
-
-# Code generation configuration
-generate:
-  inputs:
-    # Local directory input
-    - directory: 
-        path: "proto"
-        root: "."
-    
-    # Remote Git repository input
-    - git_repo:
-        url: "github.com/acme/weather@v1.2.3"
-        sub_directory: "proto/api"
-    # Another remote repository
-    - git_repo:
-        url: "https://github.com/company/internal-protos.git"
-        sub_directory: "definitions"
-  plugins:
-    # Local plugin execution
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        module: github.com/mycompany/myproject
-      with_imports: true
-    
-    # Local plugin with custom options
-    - name: go-grpc
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-
-  # Managed mode - автоматическая установка file и field опций
-  managed:
-    enabled: true
-    disable:
-      - module: github.com/googleapis/googleapis  # Отключить для конкретного модуля
-    override:
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-      - file_option: java_package_prefix
-        value: com.mycompany
-      - file_option: csharp_namespace_prefix
-        value: MyCompany
-      - field_option: jstype
-        value: JS_STRING
-        path: api/v1/  # Применить к конкретному пути
-
-```
-
-### Input Sources
-
-#### Локальный ввод (Local Directory Input)
-
-Локальная директория — самый распространённый и простой способ указать откуда брать proto для генерации. Используйте этот вариант, если файлы уже находятся в репозитории проекта.
-
-**Когда применять:**
-- Proto файлы находятся в кодовой базе проекта
-- Нужен полный контроль над структурой каталогов
-- Проект — один сервис или приложение
-- Файлы меняются не слишком часто
-
-```yaml
-inputs:
-  - directory: "proto"                    # Простой строковый формат
-  
-  # Или подробный формат
-  - directory:
-      path: "proto"                       # Путь к proto файлам
-      root: "."                           # Корень для разрешения import
-```
-
-Параметр `root` особенно полезен в монорепозиториях: он позволяет управлять тем, откуда будут резолвиться пути импортов. Если указать родительскую директорию, импорты будут оцениваться относительно неё, а не текущего рабочего каталога.
-
-**Параметры:**
-
-| Параметр | Тип | Обязателен | Значение по умолчанию | Описание |
-|----------|-----|------------|-----------------------|----------|
-| `path` | string | ✅ | - | Каталог, содержащий proto файлы |
-| `root` | string | ❌ | `"."` | Корневая директория для разрешения import путей |
-
-**Примеры:**
-
-Ниже показана разница между базовым указанием директории и расширенной конфигурацией с пользовательским корнем импортов:
-
-```yaml
-# Basic usage - Simple path specification
-inputs:
-  - directory: "api/proto"
-
-# Advanced usage with custom root - Controls import path resolution
-inputs:
-  - directory:
-      path: "services/auth/proto" 
-      root: "services/auth"        # Imports will be relative to this path
-```
-
-#### Удалённый Git репозиторий (Remote Git Repository Input)
-
-Этот тип входных данных позволяет генерировать код из proto‑файлов, находящихся в удалённых репозиториях, без локального checkout. Особенно полезно при использовании API других команд или внешних поставщиков.
-
-**Когда использовать:**
-- Потребление proto определений из других сервисов/команд
-- Интеграция с внешними вендорскими API
-- Работа с общими библиотеками proto в нескольких проектах
-- Необходимо гарантировать корректную (зафиксированную) версию внешних API
-
-**Рекомендации:**
-- В продакшене всегда фиксируйте версии (`@v1.0.0`, а не latest)
-- Используйте семантические версии при наличии — проще сопровождать
-- Предпочитайте публичные теги вместо хеша коммита (лучше отслеживаемость)
-
-```yaml
-inputs:
-  - git_repo:
-      url: "github.com/company/protos@v1.0.0"    # Обязательное: репозиторий + версия
-      sub_directory: "api"                       # Опционально: поддиректория внутри репо
-```
-
-Параметр `root` задаёт корень для разрешения импортов файлов из этого репозитория.
-
-**Параметры:**
-
-| Параметр | Тип | Обязателен | По умолчанию | Описание |
-|----------|-----|------------|--------------|----------|
-| `url` | string | ✅ | - | URL Git репозитория с необязательной версией / тегом / коммитом |
-| `sub_directory` | string | ❌ | `""` | Поддиректория внутри репозитория, где лежат proto |
-| `root` | string | ❌ | `""` | Корневой путь для разрешения импортов |
-
-**Варианты формата URL:**
-
-EasyP поддерживает несколько форматов для ссылки на удалённые репозитории. Каждый подходит под разные требования по стабильности:
-
-- **Tagged versions** — для продакшена, стабильные неизменяемые ссылки
-- **Semantic versions** — читаемость и управление зависимостями
-- **Commit hashes** — доступ к конкретному коммиту, если нет тега
-- **Latest** — только для разработки, непредсказуемо
-- **Full HTTPS URLs** — приватные репозитории или нестандартный хостинг
-
-```yaml
-# Тег — стабильно для продакшена
-url: "github.com/googleapis/googleapis@common-protos-1_3_1"
-
-# Семантическая версия
-url: "github.com/grpc-ecosystem/grpc-gateway@v2.19.1"  
-
-# Хеш коммита — точечный фикс
-url: "github.com/company/protos@abc123def456"
-
-# Latest — только dev, НЕ для продакшена
-url: "github.com/company/protos"
-
-# Полный HTTPS URL — приватный или кастомный Git
-url: "https://github.com/company/private-protos.git"
-```
-
-**Примеры:**
-
-Ниже паттерны использования удалённых источников в разных сценариях:
-
-```yaml
-# Публичный репозиторий с фиксированной версией — типично для внешних API
-inputs:
-  - git_repo:
-      url: "github.com/googleapis/googleapis@common-protos-1_3_1"
-      sub_directory: "google"
-# Приватный репозиторий с аутентификацией — внутренние API
-inputs:
-  - git_repo:
-      url: "github.com/mycompany/internal-protos@v2.1.0"
-      sub_directory: "api/definitions"
-# Несколько удалённых источников — часто в микросервисной архитектуре
-inputs:
-  - git_repo:
-      url: "github.com/grpc-ecosystem/grpc-gateway@v2.19.1"
-      sub_directory: "protoc-gen-openapiv2/options"
-  - git_repo:
-      url: "github.com/bufbuild/protoc-gen-validate@v0.10.1"  
-      sub_directory: "validate"
-```
-
-### Конфигурация плагинов
-
-Конфигурация плагинов определяет какие генераторы кода будут запущены и как они себя ведут. EasyP поддерживает любой плагин protoc, что делает его крайне гибким для разных языковых экосистем и сценариев.
-
-На верхнем уровне есть **четыре способа указать, как именно запускать плагин**:
-
-- **`name`** – запуск плагина по имени из `PATH` или использование встроенного плагина.
-- **`path`** – запуск плагина по абсолютному/относительному пути к исполняемому файлу.
-- **`remote`** – удалённый плагин по URL (через remote‑executor EasyP).
-- **`command`** – запуск плагина через произвольную команду (например, `go run ...`).
-
-Для каждого плагина должен быть указан **ровно один** из параметров `name`, `path`, `remote` или `command`.
-
-#### Плагин по имени (`name`)
-
-Локальный режим по имени — стандартный: плагины установлены в системе и запускаются напрямую через EasyP.
-
-**Когда использовать `name`:**
-- Стандартные языки (Go, Python, TypeScript и т.д.)
-- Есть контроль над окружением сборки
-- Критична производительность (нет сетевых задержек)
-- Хочется опираться на `PATH` или встроенные плагины
-
-**Требования к установке:**
-- Плагины установлены и доступны в `PATH` (если не используются встроенные).
-- Имена следуют шаблону `protoc-gen-{name}`.
-- Установка через менеджеры пакетов (go install, npm install, pip install и т.п.).
-
-```yaml
-plugins:
-  - name: go                              # Имя плагина (локальный или встроенный)
-    out: ./generated                      # Директория для вывода
-    opts:                                 # Опции конкретного плагина
-      paths: source_relative
-      module: github.com/mycompany/project
-    with_imports: true                    # Включить импорт зависимостей
-```
-
-Параметр `with_imports` критичен при использовании зависимостей из пакетного менеджера: установите `true`, чтобы прототипы из секции `deps` попали в генерацию.
-
-#### Плагин по пути (`path`)
-
-Иногда нужно запускать плагин из конкретного бинарника, не добавляя его в `PATH` (например, бинарь в репозитории или в build‑директории). В этом случае можно указать явный путь:
-
-```yaml
-plugins:
-  - path: ./bin/protoc-gen-my-custom
-    out: ./gen/custom
-    opts:
-      foo: bar
-```
-
-**Когда использовать `path`:**
-- Бинарники плагинов хранятся в репозитории (для воспроизводимых сборок).
-- Используются несколько версий одного и того же плагина параллельно.
-- Не хочется «загрязнять» глобальный `PATH`.
-
-#### Удалённый плагин (`remote`)
-
-Удалённые плагины выполняются по URL. EasyP отправляет на удалённую сторону `CodeGeneratorRequest` и получает обратно `CodeGeneratorResponse`.
-
-Ниже приведён реальный пример использования EasyP API Service как удалённого исполнителя плагинов (тот же формат используется в разделе про API Service):
-
-```yaml
-generate:
-  plugins:
-    # Удалённое выполнение плагинов через EasyP API Service
-    - remote: api.easyp.tech/protobuf/go:v1.36.10
-      out: .
-      opts:
-        paths: source_relative
-
-    - remote: api.easyp.tech/grpc/go:v1.5.1
-      out: .
-      opts:
-        paths: source_relative
-```
-
-**Типичные сценарии для `remote`:**
-- Централизованный сервис плагинов внутри компании (например, EasyP API Service).
-- Запуск тяжёлых плагинов на выделенных машинах вместо CI‑агентов.
-- Совместное использование одной реализации плагина разными командами.
-
-#### Выполнение плагина через команду (`command`)
-
-Вы можете указать плагин как массив команд для выполнения. Это полезно для запуска плагинов через `go run` или любые другие инструменты без предварительной установки бинарника плагина:
-
-```yaml
-plugins:
-  - command: ["go", "run", "github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.25.1"]
-    out: ./gen/go
-    opts:
-      paths: source_relative
-```
-
-В этом режиме EasyP:
-- **запускает указанную команду** как дочерний процесс;
-- **пишет `CodeGeneratorRequest` в stdin** процесса;
-- **читает `CodeGeneratorResponse` из stdout**, как и для обычных плагинов protoc.
-
-**Приоритет источников плагина:**
-1. `command` — выполнение через указанную команду (наивысший приоритет)
-2. `remote` — удалённый плагин через URL
-3. `name` — локальный плагин из PATH или встроенный плагин
-4. `path` — путь к исполняемому файлу плагина
-
-**Параметры (источники и общие опции плагина):**
-
-| Параметр | Тип | Обязателен | По умолчанию | Описание |
-|----------|-----|------------|--------------|----------|
-| `name` | string | ❌ | - | Имя / идентификатор плагина (например, `go`, `go-grpc`, `grpc-gateway`) |
-| `command` | []string | ❌ | - | Команда для выполнения плагина (например, `["go", "run", "package"]`) |
-| `remote` | string | ❌ | - | URL удалённого плагина |
-| `path` | string | ❌ | - | Путь к исполняемому файлу плагина |
-| `out` | string | ❌ | resolved generate root | Директория для сгенерированных файлов |
-| `opts` | map[string](string \| number \| boolean \| array<string \| number \| boolean>) | ❌ | `{}` | Специфичные опции плагина; значения-списки передаются как повторяющиеся `key=value` |
-| `with_imports` | bool | ❌ | `false` | Включать proto из зависимостей |
-
-**Примечание:** Для каждого плагина должен быть указан ровно один источник (`name`, `command`, `remote` или `path`).
-Если `opts.outputServices` задан как `["grpc-js", "generic-definitions"]`, EasyP передаст `outputServices=grpc-js,outputServices=generic-definitions`.
-
-**Примеры использования источника `command`:**
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-
-  plugins:
-    # 1) gRPC-Gateway через go run (без предварительной установки бинарника)
-    - command: ["go", "run", "github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.25.1"]
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        generate_unbound_methods: true
-
-    # 2) protoc-gen-validate через go run
-    - command: ["go", "run", "github.com/bufbuild/protoc-gen-validate@v0.10.1"]
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        lang: go
-
-    # 3) Произвольный кастомный скрипт-обёртка
-    - command: ["bash", "./scripts/custom-protoc-plugin.sh"]
-      out: ./gen/custom
-      opts:
-        foo: bar
-```
-
-#### Встроенные плагины (Builtin Plugins)
-
-EasyP поддерживает встроенные плагины для базовых языков protobuf и gRPC. Эти плагины встроены в бинарник как WASM-модули и не требуют установки внешних зависимостей.
-
-**Преимущества встроенных плагинов:**
-- **Портативность**: Один бинарник со всеми необходимыми плагинами
-- **Удобство**: Не требуется установка внешних зависимостей
-- **Стабильность**: Версии плагинов зафиксированы в бинарнике
-- **Изоляция**: Не зависит от системных установок плагинов
-
-**Поддерживаемые встроенные плагины:**
-
-#### Protobuf базовые плагины
-
-Следующие плагины встроены для генерации базового protobuf кода:
-
-| Имя плагина | Описание | Соответствующий protoc плагин |
-|-------------|----------|-------------------------------|
-| `cpp` | Генерация C++ кода из proto файлов | `protoc-gen-cpp` |
-| `csharp` | Генерация C# кода из proto файлов | `protoc-gen-csharp` |
-| `java` | Генерация Java кода из proto файлов | `protoc-gen-java` |
-| `kotlin` | Генерация Kotlin кода из proto файлов | `protoc-gen-kotlin` |
-| `objc` | Генерация Objective-C кода из proto файлов | `protoc-gen-objc` |
-| `php` | Генерация PHP кода из proto файлов | `protoc-gen-php` |
-| `python` | Генерация Python кода из proto файлов | `protoc-gen-python` |
-| `ruby` | Генерация Ruby кода из proto файлов | `protoc-gen-ruby` |
-
-#### gRPC плагины
-
-Следующие плагины встроены для генерации gRPC кода:
-
-| Имя плагина | Описание | Соответствующий protoc плагин |
-|-------------|----------|-------------------------------|
-| `grpc_cpp` | Генерация gRPC кода для C++ | `grpc_cpp_plugin` |
-| `grpc_csharp` | Генерация gRPC кода для C# | `grpc_csharp_plugin` |
-| `grpc_java` | Генерация gRPC кода для Java | `grpc_java_plugin` |
-| `grpc_node` | Генерация gRPC кода для Node.js | `grpc_node_plugin` |
-| `grpc_objc` | Генерация gRPC кода для Objective-C | `grpc_objective_c_plugin` |
-| `grpc_php` | Генерация gRPC кода для PHP | `grpc_php_plugin` |
-| `grpc_python` | Генерация gRPC кода для Python | `grpc_python_plugin` |
-| `grpc_ruby` | Генерация gRPC кода для Ruby | `grpc_ruby_plugin` |
-
-**Логика выбора плагина:**
-
-EasyP использует следующий приоритет при выборе executor'а для плагина:
-
-1. **Удалённый плагин** (если указан `url`) — всегда имеет наивысший приоритет
-2. **Встроенный плагин** (если плагин встроен и не найден в PATH) — используется автоматически
-3. **Локальный плагин** (из PATH) — используется по умолчанию для обратной совместимости
-
-**Пример использования:**
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    # Встроенный плагин Python (автоматически используется, если protoc-gen-python не найден в PATH)
-    - name: python
-      out: ./gen/python
-      opts:
-        pyi_out: ./gen/python
-    
-    # Встроенный gRPC плагин для Python
-    - name: grpc_python
-      out: ./gen/python
-    
-    # Встроенный плагин C++ (автоматически используется, если protoc-gen-cpp не найден в PATH)
-    - name: cpp
-      out: ./gen/cpp
-      opts:
-        dllexport_decl: EXPORT
-    
-    # Встроенный gRPC плагин для C++
-    - name: grpc_cpp
-      out: ./gen/cpp
-```
-
-**Требования:**
-
-Встроенные плагины включены в бинарник EasyP:
-
-```bash
-# Сборка
-go build ./cmd/easyp
-
-# Установка
-go install github.com/easyp-tech/easyp/cmd/easyp@latest
-```
-
-**Обратная совместимость:**
-
-Встроенные плагины полностью совместимы с существующими конфигурациями. Если плагин найден в PATH, он будет использован вместо встроенного. Это гарантирует, что:
-
-- Существующие конфигурации продолжают работать без изменений
-- Можно переопределить встроенный плагин, установив его в системе
-- Приоритет отдаётся локальным установкам для гибкости
-
-### Справочник опций плагинов
-
-Ниже перечислены наиболее часто используемые плагины и их настройки. Каждый плагин имеет параметры, влияющие на результат генерации — понимание этих опций важно для получения нужного вывода.
-
-#### Go Plugins
-
-Плагины для Go — самые зрелые и распространённые. Опция `paths` управляет тем, как формируются пути импортов; остальные опции дают тонкую настройку вывода.
-
-```yaml
-plugins:
-  # protoc-gen-go — генерирует структуры и базовые protobuf функции
-  - name: go
-    out: ./gen/go
-    opts:
-      paths: source_relative              # source_relative | import
-      module: github.com/company/project  # Go module path для импорта
-      
-  # protoc-gen-go-grpc — генерирует gRPC серверные/клиентские заглушки
-  - name: go-grpc
-    out: ./gen/go
-    opts:
-      paths: source_relative
-      require_unimplemented_servers: false  # Включение UnimplementedServer
-```
-
-#### gRPC-Gateway Plugins
-
-Позволяют экспонировать gRPC сервисы как REST API и генерировать OpenAPI. Критично для HTTP/JSON поверх gRPC.
-
-```yaml
-plugins:
-  # protoc-gen-grpc-gateway — reverse proxy REST→gRPC
-  - name: grpc-gateway
-    out: ./gen/go
-    opts:
-      paths: source_relative
-      generate_unbound_methods: true      # Включать методы без HTTP привязок
-      
-  # protoc-gen-openapiv2 — генерирует OpenAPI/Swagger
-  - name: openapiv2  
-    out: ./gen/openapi
-    opts:
-      simple_operation_ids: true          # Простые operationId
-      generate_unbound_methods: false     # Исключить методы без HTTP аннотаций
-      json_names_for_fields: true         # Использовать JSON имена
-```
-
-#### Validation Plugins
-
-Генерируют код валидации на основе правил в proto, устраняя ручную проверку.
-
-```yaml
-plugins:
-  # protoc-gen-validate — генерация проверок полей
-  - name: validate-go
-    out: ./gen/go
-    opts:
-      paths: source_relative
-      lang: go                           # Целевой язык
-```
-
-#### TypeScript/JavaScript Plugins
-
-TypeScript плагины нужны фронтенду: типобезопасные интерфейсы и клиенты.
-
-```yaml
-plugins:
-  # protoc-gen-ts — типы и сериализация
-  - name: ts
-    out: ./gen/typescript  
-    opts:
-      declaration: true                   # Генерация .d.ts
-      target: es2017                      # Целевой ECMAScript
-      
-  # protoc-gen-grpc-web — gRPC-Web клиенты для браузера
-  - name: grpc-web
-    out: ./gen/web
-    opts:
-      import_style: typescript           # Стиль импорта
-      mode: grpcweb                      # Режим транспорта
-```
-
-## Managed Mode
-
-Managed mode автоматически устанавливает file и field опции в protobuf дескрипторах во время генерации кода без изменения исходных `.proto` файлов. Эта функция совместима с managed mode в `buf` и обеспечивает единообразный способ управления языково-специфичными опциями в вашей кодовой базе.
-
-**Ключевые преимущества:**
-- **Без изменений proto файлов**: Опции применяются во время генерации, proto файлы остаются чистыми
-- **Согласованные значения по умолчанию**: Автоматическое применение языковых соглашений об именовании
-- **Централизованная конфигурация**: Управление всеми опциями в одном месте (`easyp.yaml`)
-- **Правила для модулей**: Применение разных опций к разным модулям или путям
-- **Совместимость с buf**: Работает так же, как managed mode в `buf`
-
-### Как это работает
-
-Когда managed mode включён, EasyP автоматически применяет file и field опции к protobuf дескрипторам перед генерацией кода. Это происходит в памяти, поэтому исходные `.proto` файлы остаются неизменными.
-
-**Значения по умолчанию** применяются для определённых опций на основе языковых соглашений:
-- Java: `java_package_prefix` по умолчанию `"com"`, `java_multiple_files` по умолчанию `true`
-- C#: `csharp_namespace` по умолчанию PascalCase имени пакета
-- Ruby: `ruby_package` по умолчанию PascalCase с разделителем `::`
-- PHP: `php_namespace` по умолчанию PascalCase с разделителем `\`
-- Objective-C: `objc_class_prefix` по умолчанию первые буквы частей пакета
-- C++: `cc_enable_arenas` по умолчанию `true`
-
-**Overrides** позволяют установить конкретные значения для опций с поддержкой фильтрации по модулю, protobuf package, пути или полю. Если не указаны `module`, `package` и `path`, override применяется ко всем файлам в запросе генерации, включая зависимости и `git_repo` inputs.
-
-**Disables** позволяют предотвратить изменение managed mode определённых опций или файлов. Это рекомендуемый способ исключить внешние зависимости, у которых свои опции уже заданы.
-
-### Конфигурация
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    disable:
-      # Отключить managed mode для конкретного модуля
-      - module: github.com/googleapis/googleapis
-      
-      # Отключить конкретную опцию глобально
-      - file_option: java_package_prefix
-
-      # Отключить для конкретного protobuf package
-      - package: acme.weather.v1
-        file_option: java_package
-      
-      # Отключить для конкретного пути
-      - path: legacy/
-        file_option: go_package
-      
-      # Отключить field опцию для конкретного поля
-      - field_option: jstype
-        field: com.example.User.id
-    
-    override:
-      # Переопределить go_package_prefix для всех файлов
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-      
-      # Переопределить для конкретного модуля
-      - file_option: java_package_prefix
-        value: com.mycompany
-        module: github.com/mycompany/internal-protos
-
-      # Переопределить для конкретного protobuf package
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-        package: acme.weather.v1
-      
-      # Переопределить для конкретного пути
-      - file_option: csharp_namespace_prefix
-        value: MyCompany
-        path: api/v1/
-      
-      # Переопределить для нескольких файлов с одинаковым значением используя префиксный путь
-      # Это совпадет и с internal/cms/bmi.proto, и с internal/cms/bmi_service.proto
-      - file_option: go_package
-        value: spec/cms/bmi
-        path: "internal/cms/bmi"
-      
-      # Переопределить field опцию для конкретного пути
-      - field_option: jstype
-        value: JS_STRING
-        path: api/v1/
-      
-      # Переопределить для конкретного поля
-      - field_option: jstype
-        value: JS_NUMBER
-        field: com.example.User.big_id
-```
-
-### Поддерживаемые File Options
-
-| Опция | Описание | Есть значение по умолчанию? |
-|-------|----------|----------------------------|
-| `go_package` | Go import path | ❌ |
-| `go_package_prefix` | Префикс для Go import paths | ❌ |
-| `java_package` | Имя Java пакета | ❌ |
-| `java_package_prefix` | Префикс для Java пакетов | ✅ (`"com"`) |
-| `java_package_suffix` | Суффикс для Java пакетов | ❌ |
-| `java_multiple_files` | Генерировать несколько Java файлов | ✅ (`true`) |
-| `java_outer_classname` | Имя внешнего класса | ✅ (PascalCase + "Proto") |
-| `java_string_check_utf8` | UTF-8 валидация | ❌ |
-| `csharp_namespace` | C# namespace | ✅ (PascalCase) |
-| `csharp_namespace_prefix` | Префикс для C# namespaces | ❌ |
-| `ruby_package` | Имя Ruby модуля | ✅ (PascalCase с `::`) |
-| `ruby_package_suffix` | Суффикс для Ruby пакетов | ❌ |
-| `php_namespace` | PHP namespace | ✅ (PascalCase с `\`) |
-| `php_metadata_namespace` | PHP metadata namespace | ❌ |
-| `php_metadata_namespace_suffix` | Суффикс для PHP metadata | ❌ |
-| `objc_class_prefix` | Objective-C префикс класса | ✅ (Первые буквы) |
-| `swift_prefix` | Swift префикс | ❌ |
-| `optimize_for` | Оптимизация генерации кода | ❌ |
-| `cc_enable_arenas` | C++ arena аллокация | ✅ (`true`) |
-
-### Поддерживаемые Field Options
-
-| Опция | Описание | Применяется к |
-|-------|----------|---------------|
-| `jstype` | JavaScript тип для 64-битных целых чисел | `int64`, `uint64`, `sint64`, `fixed64`, `sfixed64` |
-
-### Примеры
-
-#### Базовая настройка со значениями по умолчанию
-
-Включите managed mode для получения автоматических значений по умолчанию для всех поддерживаемых языков:
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-    - name: java
-      out: ./gen/java
-    - name: csharp
-      out: ./gen/csharp
-  managed:
-    enabled: true
-```
-
-Это автоматически установит:
-- `java_package` в `com.<package>` для всех файлов
-- `java_multiple_files` в `true`
-- `csharp_namespace` в PascalCase имени пакета
-- `ruby_package` в PascalCase с разделителем `::`
-- И многое другое...
-
-#### Кастомный префикс Go пакета
-
-Переопределите префикс Go пакета для вашего проекта:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-```
-
-Это установит `go_package` в `github.com/mycompany/myproject/gen/go/<package>` для всех файлов.
-
-#### Динамические пути Go пакетов с маркерами
-
-Для более сложной генерации путей можно использовать маркеры в значениях `go_package_prefix` или `go_package`:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      # Использовать путь файла напрямую (без расширения .proto)
-      - file_option: go_package_prefix
-        value: github.com/mycompany/{{file_path}}
-      
-      # Использовать только путь директории
-      - file_option: go_package_prefix
-        value: github.com/mycompany/{{file_dir}}
-      
-      # Удалить префикс из пути директории
-      - file_option: go_package_prefix
-        value: github.com/mycompany/{{file_dir_without:internal/}}
-      
-      # Удалить префикс из полного пути файла
-      - file_option: go_package_prefix
-        value: github.com/mycompany/{{file_path_without:internal/}}
-```
-
-**Доступные маркеры:**
-- `{{file_path}}` - Полный путь файла без расширения `.proto`
-  - Пример: `internal/cms/as.proto` → `internal/cms/as`
-- `{{file_dir}}` - Только путь директории, без имени файла
-  - Пример: `internal/cms/as.proto` → `internal/cms`
-- `{{file_dir_without:prefix/}}` - Путь директории с удалением префикса и базового имени файла без суффиксов `_service`/`_grpc`
-  - Пример: `{{file_dir_without:internal/}}` для `internal/cms/as_service.proto` → `cms/as`
-- `{{file_path_without:prefix/}}` - Полный путь файла с удалением префикса
-  - Пример: `{{file_path_without:internal/}}` для `internal/cms/as.proto` → `cms/as`
-
-#### Переопределения для конкретных модулей
-
-Примените разные опции к разным модулям:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      # Значение по умолчанию для всех файлов
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-      
-      # Конкретное переопределение для внутреннего модуля
-      - file_option: go_package_prefix
-        value: github.com/mycompany/internal/gen/go
-        module: github.com/mycompany/internal-protos
-```
-
-`module` должен точно совпадать с источником модуля в EasyP: это значение из `deps` или `git_repo.url` до `@version` (например, `github.com/mycompany/internal-protos` или `https://github.com/mycompany/internal-protos`). Это не Go module path из `go.mod`.
-
-`package` должен точно совпадать со значением `package` в `.proto` файле, например `acme.weather.v1`.
-
-#### Переопределения для конкретного protobuf package
-
-Примените отдельные опции к файлам из конкретного protobuf package:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      - file_option: go_package_prefix
-        value: github.com/mycompany/myproject/gen/go
-      - file_option: go_package
-        package: acme.weather.v1
-        value: github.com/mycompany/myproject/gen/go/acme/weather/v1
-```
-
-#### Отключение для внешних зависимостей
-
-Отключите managed mode для внешних зависимостей, у которых уже установлены опции:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    disable:
-      - module: github.com/googleapis/googleapis
-      - module: github.com/grpc-ecosystem/grpc-gateway
-```
-
-#### Типобезопасность JavaScript
-
-Установите `jstype` в `JS_STRING` для всех 64-битных целочисленных полей, чтобы предотвратить потерю точности в JavaScript:
-
-```yaml
-generate:
-  managed:
-    enabled: true
-    override:
-      - field_option: jstype
-        value: JS_STRING
-        path: api/v1/  # Применить к конкретному пути
-```
-
-### Совпадение путей
-
-Совпадение путей в managed mode использует префиксное совпадение (как в `buf`):
-
-- **Путь директории** (заканчивается на `/`): Совпадает со всеми файлами в этой директории и поддиректориях
-  - Пример: `path: "internal/cms/"` совпадает с `internal/cms/as.proto`, `internal/cms/node.proto`, `internal/cms/v1/service.proto`
-- **Точный путь файла** (заканчивается на `.proto`): Совпадает только с этим конкретным файлом
-  - Пример: `path: "internal/cms/as.proto"` совпадает только с `internal/cms/as.proto`
-- **Префиксный путь** (без завершающего `/` или `.proto`): Использует префиксное совпадение (не директориально-осознанное)
-  - Пример: `path: "internal/cms"` совпадает с `internal/cms/as.proto`, но также с `internal/cmsv2/file.proto`
-  - **Совет**: Используйте префиксные пути для группировки нескольких файлов с одинаковым значением. Например, `path: "internal/cms/bmi"` совпадает и с `internal/cms/bmi.proto`, и с `internal/cms/bmi_service.proto`, что позволяет установить одно и то же значение `go_package` для обоих файлов одним правилом.
-
-### Приоритет правил
-
-Когда несколько правил соответствуют одному файлу или полю, применяется следующий приоритет:
-
-1. **Disable правила** имеют приоритет — если опция отключена, она не будет применена
-2. **Override правила** применяются по порядку — последнее совпадающее правило побеждает
-3. **Значения по умолчанию** применяются только если нет совпадающего override и опция не отключена
-
-### Совместимость с buf
-
-Managed mode в EasyP совместим с managed mode в `buf`. Тот же формат конфигурации и поведение применяются, что упрощает миграцию между инструментами или использование обоих в одном workflow.
-
-## Генерация Descriptor Set
-
-**https://protobuf.dev/programming-guides/techniques/#self-description**
-
-EasyP поддерживает генерацию бинарных FileDescriptorSet файлов с помощью флага `--descriptor_set_out`. Это позволяет создавать самоописывающиеся protobuf сообщения, которые включают информацию о схеме вместе с данными.
-
-**Флаги CLI:**
-
-- `--descriptor_set_out <путь>` - Путь для вывода бинарного FileDescriptorSet
-- `--include_imports` - Включить все транзитивные зависимости в FileDescriptorSet
-
-**Пример:**
-
-```bash
-# Генерация descriptor set только с целевыми файлами
-easyp generate --descriptor_set_out=./schema.pb
-
-# Генерация descriptor set со всеми зависимостями
-easyp generate --descriptor_set_out=./schema.pb --include_imports
-```
-
-Самоописывающиеся сообщения полезны для динамического парсинга сообщений, валидации схемы во время выполнения, реестров схем и создания универсальных gRPC клиентов. Для получения дополнительной информации см. [документацию Protocol Buffers о самоописании](https://protobuf.dev/programming-guides/techniques/#self-description).
-
-## Интеграция с менеджером пакетов
-
-Одной из самых мощных возможностей EasyP является бесшовная интеграция генератора кода с менеджером пакетов. Это устраняет проблему ручного управления proto‑зависимостями и гарантирует, что при генерации используются корректные (зафиксированные) версии импортируемых файлов.
-
-**Ключевые преимущества:**
-- **Автоматическое разрешение зависимостей**: не нужно вручную прописывать пути импортов
-- **Согласованность версий**: фиксация в `easyp.lock` гарантирует воспроизводимость
-- **Транзитивные зависимости**: вложенные цепочки подтягиваются автоматически
-- **Производительность**: локальный кеш — скачивание один раз и повторное использование
-
-### Автоматическое разрешение зависимостей
-
-Когда вы указываете зависимости в секции `deps`, генератор автоматически добавляет их в путь импортов. Ваши proto‑файлы могут делать стандартные `import` из этих зависимостей без дополнительной настройки.
-
-**Как это работает:**
-1. EasyP скачивает и кеширует зависимости из `deps`
-2. Во время генерации кешированные файлы автоматически добавляются в import‑path protoc
-3. Ваши proto‑файлы используют обычные import строки для обращения к зависимостям
-4. При `with_imports: true` в вывод попадают и локальные файлы, и файлы зависимостей
-
-Ниже простой пример — зависимости указываются один раз в `deps`, далее они доступны при генерации автоматически:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-      with_imports: true    # This automatically includes googleapis and grpc-gateway protos
-```
-
-### Примеры использования зависимостей
-
-Ниже показаны распространённые способы интеграции внешних proto‑зависимостей в процесс генерации.
-
-#### Использование Google APIs
-
-Google APIs — одна из самых популярных коллекций зависимостей: стандартные типы, аннотации для REST, проверки и общие структуры данных.
-
-**Когда использовать Google APIs:**
-- Построение REST поверх gRPC (gRPC-Gateway)
-- Нужны стандартные типы (`Timestamp`, `Duration`, `Any`)
-- Требуются аннотации поведения полей (field behavior)
-- Интеграция с сервисами Google Cloud
-
-Минимальная конфигурация для подключения Google APIs:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-
-generate:
-  inputs:
-    - directory: "api/proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-      with_imports: true
-```
-
-**Важно:** Всегда фиксируйте версию (например `common-protos-1_3_1`) — не используйте latest в продакшене.
-
-После настройки ваши proto могут импортировать определения Google API. Ниже пример сервиса с HTTP аннотацией:
-
-```proto
-// api/proto/service.proto
-syntax = "proto3";
-
-import "google/api/annotations.proto";
-import "google/protobuf/timestamp.proto";
-
-service MyService {
-  rpc GetData(GetDataRequest) returns (GetDataResponse) {
-    option (google.api.http) = {
-      get: "/v1/data"
-    };
-  }
-}
-```
-
-#### Использование правил валидации
-
-`protoc-gen-validate` даёт мощную проверку полей прямо в определениях proto, устраняя необходимость писать отдельную логику валидации в приложении.
-
-**Когда применять валидацию:**
-- Проверка входных данных API
-- Ограничения моделей БД
-- Проверка конфигурационных файлов
-- Любая ситуация, где критична целостность данных
-
-**Преимущества:**
-- Правила валидации — часть proto (единый источник истины)
-- Генерация создаёт функции проверки автоматически
-- Единообразие проверок между языками
-- Производительнее чем проверка через runtime reflection
-
-```yaml
-deps:
-  - github.com/bufbuild/protoc-gen-validate@v0.10.1
-
-generate:
-  inputs:
-    - directory: "proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-      with_imports: true
-    - name: validate-go
-      out: ./gen/go  
-      opts:
-        paths: source_relative
-```
-
-**Примечание:** Нужны одновременно зависимость (для импортов proto) и плагин (для генерации кода), чтобы получить полноценную поддержку валидации.
-
-Так выглядят правила валидации в proto — сгенерированный код будет автоматически их применять:
-
-```proto
-// proto/user.proto
-syntax = "proto3";
-
-import "validate/validate.proto";
-
-message User {
-  string email = 1 [(validate.rules).string.email = true];
-  int32 age = 2 [(validate.rules).int32.gte = 0];
-}
-```
-
-#### Комплексная конфигурация с несколькими зависимостями
-
-Пример ниже показывает продакшен‑конфигурацию, объединяющую несколько зависимостей и плагины для полного цикла разработки API:
-
-```yaml
-deps:
-  # Core Google APIs - Standard types and HTTP annotations
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  
-  # gRPC Gateway for REST APIs - Enables HTTP/JSON interfaces
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-  
-  # Validation rules - Field-level validation constraints
-  - github.com/bufbuild/protoc-gen-validate@v0.10.1
-  
-  # Company internal shared types - Common business objects
-  - github.com/mycompany/shared-protos@v1.5.0
-
-generate:
-  inputs:
-    - directory: "api/proto"
-  plugins:
-    # Go code generation - Core protobuf structures
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        module: github.com/mycompany/myservice
-      with_imports: true
-      
-    # gRPC service stubs - Server and client interfaces
-    - name: go-grpc
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-        
-    # REST Gateway - HTTP-to-gRPC proxy code
-    - name: grpc-gateway
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        
-    # OpenAPI documentation - API specification
-    - name: openapiv2
-      out: ./gen/openapi
-      opts:
-        simple_operation_ids: true
-        
-    # Validation code - Input validation functions
-    - name: validate-go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-```
-
-### Интеграция с кешем зависимостей
-
-Генератор использует модульный кеш EasyP для ускорения сборок:
-
-```bash
-# Download dependencies once
-easyp mod download
-
-# Generate code (uses cached dependencies)
-easyp generate
-
-# Dependencies are cached in ~/.easyp/mod/
-ls ~/.easyp/mod/github.com/googleapis/googleapis/
-```
-
-## Удалённая генерация
-
-Удалённая генерация — мощная возможность, позволяющая генерировать код из proto‑файлов в удалённых Git‑репозиториях без локального checkout. Это поддерживает микросервисную архитектуру, где команды используют API друг друга без жёсткой связки.
-
-**Преимущества:**
-- **Развязка разработки**: Команды развиваются независимо, используя версии API друг друга
-- **Контроль версий**: Фиксация внешних API гарантирует стабильность
-- **Меньше размер репозитория**: Нет необходимости в vendoring/submodule внешних proto
-- **Автоматические обновления**: Легко перейти на новую версию по готовности
-
-**Рекомендации:**
-- В продакшене используйте только тегированные версии
-- В разработке можно тестировать latest, но в проде фиксируйте
-- При наличии используйте семантическое версионирование
-- Учитывайте сетевые ограничения в CI/CD
-
-### Источники удалённых proto
-
-Генерация напрямую из удалённых репозиториев — полезно в микросервисной архитектуре, где разные команды владеют разными proto.
-
-**Типовой workflow:**
-1. Команда A публикует proto с версиями в Git
-2. Команда B добавляет их в свой `easyp.yaml`
-3. При генерации EasyP скачивает и подключает удалённые proto
-4. Сгенерированный код содержит клиентские библиотеки сервисов команды A
-
-Практический пример объединения локальных и удалённых источников в одной конфигурации генерации:
-
-```yaml
-generate:
-  inputs:
-    # Local protos - Your service's own API definitions
-    - directory: "proto"
-    
-    # Remote public repository - External vendor API
-    - git_repo:
-        url: "github.com/acme/weather-api@v2.1.0"
-        sub_directory: "proto/weather/v1"
-    # Remote private repository - Internal company API
-    - git_repo:
-        url: "github.com/mycompany/internal-apis@main"
-        sub_directory: "user-service/proto"
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-      with_imports: true
-```
-
-
-
-### Сценарии использования удалённой генерации
-
-Примеры ниже показывают реальные ситуации, где удалённая генерация даёт ощутимую выгоду.
-
-#### Много команд (Multi-Team Development)
-
-Мультикомандная разработка особенно выигрывает: вместо координации общих репозиториев и сложного управления зависимостями — независимая эволюция API с контролируемыми обновлениями через версии.
-
-Паттерн ценен в крупных организациях, где:
-- Команды имеют разные циклы релизов и скорости разработки
-- Владение API определено, потребление — массовое  
-- Нужно избежать overhead от координации общих proto репозиториев
-- Команды используют разные стеки, но должны взаимодействовать
-
-```yaml
-# Team A (Order Service) generates from Team B's proto definitions
-generate:
-  inputs:
-    # Local service definitions - APIs owned by this team
-    - directory: "proto/orders"
-    
-    # User service protos from another team - Stable, versioned API
-    - git_repo:
-        url: "github.com/company/user-service@v1.8.0"  
-        sub_directory: "api/proto"
-    # Payment service protos - Different team, different version
-    - git_repo:
-        url: "github.com/company/payment-service@v2.3.1"
-        sub_directory: "proto/payment/v2"  
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        module: github.com/company/order-service
-      with_imports: true
-```
-
-#### Интеграция с API вендоров
-
-Многие вендоры публикуют proto для своих API, позволяя генерировать типобезопасных клиентов вместо ручных HTTP реализаций. Это повышает типовую строгость, автоматизирует сериализацию и часто ускоряет работу.
-
-Преимущества использования proto от вендоров:
-- **Type safety**: Проверка типов на этапе компиляции
-- **Automatic updates**: Новые возможности приходят с обновлением версии
-- **Consistency**: Единые паттерны интерфейсов между интеграциями
-- **Performance**: Бинарная сериализация быстрее JSON
-- **Documentation**: Proto выступают источником истины для API
-
-```yaml
-# Generate clients for external vendor APIs
-generate:
-  inputs:
-    # Vendor's public proto definitions - Financial services
-    - git_repo:
-        url: "github.com/stripe/stripe-proto@v1.0.0"
-        sub_directory: "proto"
-    # Communication service APIs - SMS/Voice integration
-    - git_repo:  
-        url: "github.com/twilio/twilio-protos@v2.1.0"
-        sub_directory: "definitions"
-  plugins:
-    - name: go
-      out: ./clients/go
-      opts:
-        paths: source_relative
-        module: github.com/mycompany/integrations
-```
-
-
-
-## Команды
-
-CLI EasyP предоставляет гибкие варианты запуска генерации с разными конфигурациями и окружениями.
-
-### Базовая генерация
-
-Ниже наиболее часто применяемые варианты команд для разработки и продакшена:
-
-```bash
-# Use default easyp.yaml configuration - Most common for development
-easyp generate
-
-# Use custom configuration file - Essential for multi-environment setups  
-easyp --cfg production.easyp.yaml generate
-
-# Generate with debug logs - Helpful for debugging and CI/CD
-easyp --debug generate
-
-# Generate with custom cache location - Useful for CI systems or shared environments
-EASYPPATH=/tmp/easyp-cache easyp generate
-```
-
-### Интеграция с менеджером пакетов
-
-Интеграция с менеджером пакетов позволяет либо явно управлять зависимостями, либо поручить это генератору. Явный путь даёт больше контроля, автоматический — больше удобства:
-
-```bash
-# Explicit workflow - Better for CI/CD and when you want to cache dependencies
-easyp mod download    # Download and cache dependencies first
-easyp generate        # Generate code using cached dependencies
-
-# Automatic workflow - Convenient for development (generate downloads dependencies automatically)
-easyp generate
-```
-
-### Расширенное использование (Advanced Usage)
-
-Эти варианты полезны для специфических сценариев деплоя, отладки или когда нужен более тонкий контроль процесса генерации:
-
-```bash
-# Генерация из конкретной директории (перекрывает настройку в файле конфигурации)
-easyp generate --path=./api/proto
-
-# Генерация с vendored зависимостями (оффлайн / Docker контейнеры)
-easyp mod vendor
-easyp generate
-
-# Генерация из кастомного project root (удобно для монореп и вложенных рабочих директорий)
-easyp generate --root=/usr/local/src/my-project --path=./api/proto
-```
-
-## Типовые паттерны (Common Patterns)
-
-Эти схемы отражают реальные сценарии и лучшие практики организации генерации кода в разных структурах проектов.
-
-### Мульти-языковая генерация (Multi-Language Generation)
-
-Мульти-языковая генерация критична для компаний, использующих разные технологии в стеке. EasyP облегчает получение согласованных клиентских библиотек и типов для нескольких языков из одного источника proto.
-
-**Типовые сценарии:**
-- **Full‑stack приложения**: backend на Go/Java + фронтенд на TypeScript
-- **Платформы данных**: сервисы на Go + аналитика / ML на Python  
-- **Микросервисы**: каждый сервис — оптимальный язык под задачу
-- **Внешние SDK**: предоставление клиентских библиотек партнёрам
-- **Интеграция с легаси**: современные gRPC сервисы + старые системы
-
-**Производительность:**
-- Каждый плагин запускается отдельно — время растёт линейно от количества плагинов
-- Для больших наборов используйте параллельный запуск (`make -j4`)
-- Структурируйте выходные директории иерархически — меньше конфликтов
-- Плагины имеют разную скорость — профилируйте сборку для поиска узких мест
-
-**Преимущества сопровождения:**
-- Единый источник истины для API снижает риск расхождения схем
-- Согласованные типы уменьшают интеграционные баги
-- Автоматическая синхронизация при изменении proto исключает ручные правки
-- Меньше риска дрейфа API между реализациями на разных языках
-- Рефакторинг упрощается — изменения транзитивно отражаются во всех артефактах
-
-Ниже пример типичной мульти-языковой конфигурации для full‑stack приложения: backend, веб‑клиент, аналитика и документация:
-
-```yaml
-generate:
-  inputs:
-    - directory: "proto"
-    
-  plugins:
-    # Go backend services - Primary implementation language
-    - name: go
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        module: github.com/company/backend
-      with_imports: true
-      
-    - name: go-grpc  # gRPC server and client stubs
-      out: ./gen/go
-      opts:
-        paths: source_relative
-        
-    # TypeScript frontend - Web application client code
-    - name: ts  
-      out: ./gen/typescript
-      opts:
-        declaration: true       # Generate type definitions
-        target: es2020         # Modern JavaScript for browsers
-        
-    # Python data science - Analytics and ML workflows
-    - name: python
-      out: ./gen/python
-      opts:
-        mypy_out: ./gen/python-stubs  # Type checking support
-        
-    # Documentation - API reference for developers
-    - name: doc
-      out: ./docs/api
-      opts:
-        markdown: true         # Generate markdown documentation
-```
-
-**Совет по организации:** Используйте отдельные выходные директории для каждого языка, чтобы избежать конфликтов файлов и упростить интеграцию с языковыми сборочными системами.
-
-
-
-
-
-Генератор EasyP — комплексное решение для генерации кода из Protocol Buffers: от простой локальной разработки до сложных enterprise‑сценариев с удалёнными зависимостями и мульти-языковым выводом.
diff --git a/docs/public/docs/ru-guide/cli/linter/linter.md b/docs/public/docs/ru-guide/cli/linter/linter.md
deleted file mode 100644
index e31b5063..00000000
--- a/docs/public/docs/ru-guide/cli/linter/linter.md
+++ /dev/null
@@ -1,334 +0,0 @@
-# Линтер
-
-[[toc]]
-
-## Зачем нужен линтер для proto файлов?
-
-Линтеры играют ключевую роль в современной разработке, особенно когда речь о `.proto` файлах. Они обеспечивают единый стиль и структуру, помогают находить потенциальные ошибки на ранних этапах и поддерживают читаемость кода. Это даёт выгоды:
-
-- **Снижение затрат на разработку:** Ошибки ловятся раньше, меньше времени на отладку.
-- **Улучшение командного взаимодействия:** Единообразный код легче понимать и сопровождать.
-- **Бизнес-эффективность:** Более качественный код → меньше инцидентов в проде → ниже стоимость поддержки.
-
-## Справочник по конфигурации
-
-Конфигурация линтера настраивается в секции `lint` файла `easyp.yaml`.
-
-### Полный пример конфигурации
-
-```yaml
-lint:
-  # Используемые категории и правила
-  use:
-    - MINIMAL
-    - BASIC
-    - COMMENT_SERVICE
-    - COMMENT_RPC
-  
-  # Кастомные суффиксы
-  enum_zero_value_suffix: "UNSPECIFIED"
-  service_suffix: "Service"
-  
-  # Исключения директорий и файлов
-  ignore:
-    - "vendor/"
-    - "third_party/"
-    - "legacy/old_protos/"
-  
-  except:
-    - COMMENT_FIELD
-    - COMMENT_MESSAGE
-  
-  # Разрешить игнорирование правил комментариями
-  allow_comment_ignores: true
-  
-  # Игнор отдельных правил только для указанных путей
-  ignore_only:
-    COMMENT_SERVICE: ["legacy/", "vendor/"]
-    SERVICE_SUFFIX: ["proto/external/"]
-```
-
-### Параметры конфигурации
-
-#### `use` ([]string)
-Определяет набор правил или категорий для включения. Можно смешивать категории и конкретные правила.
-
-**Категории:**
-- **MINIMAL**: Базовая согласованность пакетов
-- **BASIC**: Соглашения по именованию и структуре  
-- **DEFAULT**: Рекомендованные правила для большинства проектов
-- **COMMENTS**: Требования к комментариям
-- **UNARY_RPC**: Ограничение на streaming RPC
-
-**Индивидуальные правила:** Любое имя правила (например `ENUM_PASCAL_CASE`, `FIELD_LOWER_SNAKE_CASE`)
-
-**Примеры:**
-```yaml
-# Только категории
-use: [MINIMAL, BASIC, DEFAULT]
-
-# Смешивание
-use:
-  - MINIMAL
-  - COMMENT_SERVICE
-  - COMMENT_RPC
-  - ENUM_PASCAL_CASE
-
-# Точный набор
-use:
-  - PACKAGE_DEFINED
-  - SERVICE_PASCAL_CASE
-  - FIELD_LOWER_SNAKE_CASE
-```
-
-#### `enum_zero_value_suffix` (string)
-Обязывает нулевое значение enum иметь заданный суффикс.
-
-**Обычно:** `"UNSPECIFIED"`, `"UNKNOWN"`, `"DEFAULT"`
-```yaml
-enum_zero_value_suffix: "UNSPECIFIED"
-```
-
-```proto
-enum Status {
-  STATUS_UNSPECIFIED = 0;  // Требуемый суффикс
-  STATUS_ACTIVE = 1;
-  STATUS_INACTIVE = 2;
-}
-```
-
-#### `service_suffix` (string)
-Требуемый суффикс для имён сервисов (унификация стиля).
-
-```yaml
-service_suffix: "Service"
-```
-
-```proto
-service UserService { // Обязательный суффикс
-  rpc GetUser(...) returns (...);
-}
-```
-
-#### `ignore` ([]string)
-Полное исключение путей из линтинга.
-
-**Use cases:**
-- vendor / third_party
-- сгенерированные файлы
-- легаси подпакеты
-- тестовые фикстуры
-
-```yaml
-ignore:
-  - "vendor/"
-  - "third_party/"
-  - "testdata/"
-  - "proto/legacy/"
-  - "**/*_test.proto"
-```
-
-#### `except` ([]string)
-Глобально отключает правила.
-
-```yaml
-except:
-  - COMMENT_FIELD
-  - COMMENT_MESSAGE
-  - SERVICE_SUFFIX
-  - ENUM_ZERO_VALUE_SUFFIX
-```
-
-#### `allow_comment_ignores` (bool)
-Разрешает инлайн‑игнор правил комментариями.
-
-```yaml
-allow_comment_ignores: true
-```
-
-```proto
-// buf:lint:ignore COMMENT_SERVICE
-service LegacyUserAPI {
-  // nolint:COMMENT_RPC
-  rpc GetUser(...) returns (...);
-}
-```
-
-#### `ignore_only` (map[string][]string)
-Таргетированное игнорирование конкретных правил для указанных путей.
-
-```yaml
-ignore_only:
-  COMMENT_SERVICE:
-    - "proto/legacy/"
-    - "vendor/"
-  SERVICE_SUFFIX:
-    - "proto/external/"
-    - "third_party/"
-  FIELD_LOWER_SNAKE_CASE:
-    - "proto/legacy/old_messages.proto"
-    - "vendor/external_api.proto"
-```
-
-## Игнор правил комментариями
-
-Если включён `allow_comment_ignores`, можно точечно отключать правила.
-
-### Форматы комментариев
-
-#### Совместимый с Buf
-```proto
-// buf:lint:ignore RULE_NAME
-```
-
-#### Нативный EasyP
-```proto
-// nolint:RULE_NAME
-```
-
-### Примеры
-
-#### Игнор правил сервиса
-```proto
-// buf:lint:ignore COMMENT_SERVICE
-// buf:lint:ignore SERVICE_SUFFIX
-service UserAPI {
-  rpc GetUser(GetUserRequest) returns (GetUserResponse);
-}
-```
-
-#### Игнор RPC
-```proto
-service UserService {
-  // nolint:COMMENT_RPC
-  // nolint:RPC_REQUEST_STANDARD_NAME
-  rpc GetUserInfo(UserInfoReq) returns (UserInfoResp);
-}
-```
-
-#### Игнор Message и Field
-```proto
-// buf:lint:ignore COMMENT_MESSAGE
-message UserData {
-  // nolint:COMMENT_FIELD
-  // nolint:FIELD_LOWER_SNAKE_CASE
-  string userName = 1;
-}
-```
-
-#### Игнор Enum
-```proto
-// nolint:COMMENT_ENUM
-// nolint:ENUM_ZERO_VALUE_SUFFIX
-enum UserType {
-  UNKNOWN = 0; // Обычно требовался бы суффикс
-  ADMIN = 1;
-  USER = 2;
-}
-```
-
-#### Несколько правил в одной строке
-```proto
-// buf:lint:ignore COMMENT_SERVICE,SERVICE_SUFFIX
-service LegacyAPI {
-  // nolint:COMMENT_RPC,RPC_REQUEST_STANDARD_NAME
-  rpc getData(DataReq) returns (DataResp);
-}
-```
-
-### Рекомендации
-
-#### Используйте редко
-Частое игнорирование = сигнал пересмотреть конфигурацию.
-```proto
-// Легаси сервис - buf:lint:ignore SERVICE_SUFFIX
-service UserAPI { ... }
-```
-
-#### Плохой пример
-```proto
-// nolint:COMMENT_SERVICE,SERVICE_SUFFIX,COMMENT_RPC
-service UserAPI { ... }
-```
-
-#### Добавляйте пояснения
-```proto
-// Совместимость с внешним API
-// buf:lint:ignore SERVICE_SUFFIX
-service ExternalUserAPI {
-  // Легаси имя метода
-  // nolint:RPC_REQUEST_STANDARD_NAME
-  rpc getUserData(UserReq) returns (UserResp);
-}
-```
-
-#### Предпочитайте конфигурацию
-Если нужно игнорировать правило в группе файлов — используйте `ignore_only`.
-
-## Категории линтера
-
-Категории помогают быстро выбрать уровень строгости.
-
-**Когда использовать:**
-- **MINIMAL**: Минимальная базовая целостность
-- **BASIC**: Частые соглашения имен
-- **DEFAULT**: Дополнительные проверки качества
-- **COMMENTS**: Обязательные комментарии (API, команды)
-- **UNARY_RPC**: Ограничить streaming RPC
-
-### Группировки правил
-
-#### MINIMAL
-- `DIRECTORY_SAME_PACKAGE`
-- `PACKAGE_DEFINED`
-- `PACKAGE_DIRECTORY_MATCH`
-- `PACKAGE_SAME_DIRECTORY`
-
-#### BASIC
-- `ENUM_FIRST_VALUE_ZERO`
-- `ENUM_NO_ALLOW_ALIAS`
-- `ENUM_PASCAL_CASE`
-- `ENUM_VALUE_UPPER_SNAKE_CASE`
-- `FIELD_LOWER_SNAKE_CASE`
-- `IMPORT_NO_PUBLIC`
-- `IMPORT_NO_WEAK`
-- `IMPORT_USED`
-- `MESSAGE_PASCAL_CASE`
-- `ONEOF_LOWER_SNAKE_CASE`
-- `PACKAGE_LOWER_SNAKE_CASE`
-- `PACKAGE_SAME_CSHARP_NAMESPACE`
-- `PACKAGE_SAME_GO_PACKAGE`
-- `PACKAGE_SAME_JAVA_MULTIPLE_FILES`
-- `PACKAGE_SAME_JAVA_PACKAGE`
-- `PACKAGE_SAME_PHP_NAMESPACE`
-- `PACKAGE_SAME_RUBY_PACKAGE`
-- `PACKAGE_SAME_SWIFT_PREFIX`
-- `RPC_PASCAL_CASE`
-- `SERVICE_PASCAL_CASE`
-
-#### DEFAULT
-- `ENUM_VALUE_PREFIX`
-- `ENUM_ZERO_VALUE_SUFFIX`
-- `FILE_LOWER_SNAKE_CASE`
-- `RPC_REQUEST_RESPONSE_UNIQUE`
-- `RPC_REQUEST_STANDARD_NAME`
-- `RPC_RESPONSE_STANDARD_NAME`
-- `PACKAGE_VERSION_SUFFIX`
-- `SERVICE_SUFFIX`
-
-#### COMMENTS
-- `COMMENT_ENUM`
-- `COMMENT_ENUM_VALUE`
-- `COMMENT_FIELD`
-- `COMMENT_MESSAGE`
-- `COMMENT_ONEOF`
-- `COMMENT_RPC`
-- `COMMENT_SERVICE`
-
-#### UNARY_RPC
-- `RPC_NO_CLIENT_STREAMING`
-- `RPC_NO_SERVER_STREAMING`
-
-## Заключение
-
-Внедрение EasyP линдера для ваших proto файлов заметно улучшит workflow, качество и поддерживаемость кода. Полная совместимость с Buf позволяет командам мигрировать без боли, используя гибкую конфигурацию и мощные возможности из коробки.
\ No newline at end of file
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/comment-enum-value.md b/docs/public/docs/ru-guide/cli/linter/rules/comment-enum-value.md
deleted file mode 100644
index 2fefd116..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/comment-enum-value.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# COMMENT_ENUM_VALUE
-
-Категории:
-
-- **COMMENT**
-
-Это правило проверяет, что все значения enum имеют комментарий.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    BAR = 0;
-    BAZ = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    // BAR value for bar logic // [!code focus]
-    BAR = 0;
-    // BAZ value for baz logic // [!code focus]
-    BAZ = 1;
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/comment-enum.md b/docs/public/docs/ru-guide/cli/linter/rules/comment-enum.md
deleted file mode 100644
index 5d97f653..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/comment-enum.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# COMMENT_ENUM
-
-Категории:
-
-- **COMMENT**
-
-Это правило проверяет, что enum имеет комментарий.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    BAR = 0;
-    BAZ = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-// Foo enum for bar and baz logic // [!code focus]
-enum Foo {
-    BAR = 0;
-    BAZ = 1;
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/comment-field.md b/docs/public/docs/ru-guide/cli/linter/rules/comment-field.md
deleted file mode 100644
index 47716e4e..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/comment-field.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# COMMENT_FIELD
-
-Категории:
-
-- **COMMENT**
-
-Это правило проверяет, что все поля сообщений имеют комментарий.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    string bar = 1;
-    string baz = 2;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    // bar field for bar logic // [!code focus]
-    string bar = 1;
-    // baz field for baz logic // [!code focus]
-    string baz = 2;
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/comment-message.md b/docs/public/docs/ru-guide/cli/linter/rules/comment-message.md
deleted file mode 100644
index 42be0bcc..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/comment-message.md
+++ /dev/null
@@ -1,34 +0,0 @@
-# COMMENT_MESSAGE
-
-Категории:
-
-- **COMMENT**
-
-Это правило проверяет, что message имеет комментарий.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    string bar = 1;
-    string baz = 2;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-// Foo message for bar and baz logic // [!code focus]
-message Foo {
-    // bar field for bar logic 
-    string bar = 1; 
-    // baz field for baz logic
-    string baz = 2; 
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/comment-oneof.md b/docs/public/docs/ru-guide/cli/linter/rules/comment-oneof.md
deleted file mode 100644
index b214cd00..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/comment-oneof.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# COMMENT_ONEOF
-
-Категории:
-
-- **COMMENT**
-
-Это правило проверяет, что oneof имеет комментарий.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    oneof bar {
-        string baz = 1;
-        string qux = 2;
-    }
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    // bar oneof for baz and qux logic // [!code focus]
-    oneof bar {
-        string baz = 1;
-        string qux = 2;
-    }
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/comment-rpc.md b/docs/public/docs/ru-guide/cli/linter/rules/comment-rpc.md
deleted file mode 100644
index 24a64bb2..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/comment-rpc.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# COMMENT_RPC
-
-Categories:
-
-- **COMMENT**
-
-This rule checks that rpc has a comment.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (BarResponse) {}
-    rpc Baz (BazRequest) returns (BazResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    // Bar rpc for bar logic // [!code focus]
-    rpc Bar (BarRequest) returns (BarResponse) {}
-    // Baz rpc for baz logic // [!code focus]
-    rpc Baz (BazRequest) returns (BazResponse) {}
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/comment-service.md b/docs/public/docs/ru-guide/cli/linter/rules/comment-service.md
deleted file mode 100644
index ee9edfd0..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/comment-service.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# COMMENT_SERVICE
-
-Категории:
-
-- **COMMENT**
-
-Это правило проверяет, что сервис имеет комментарий.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (BarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-// Foo service for bar logic // [!code focus]
-service Foo {
-    // Bar rpc for bar logic 
-    rpc Bar (BarRequest) returns (BarResponse) {}
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/directory-same-package.md b/docs/public/docs/ru-guide/cli/linter/rules/directory-same-package.md
deleted file mode 100644
index 06a40e12..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/directory-same-package.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# DIRECTORY_SAME_PACKAGE
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы в заданной директории находятся в одном и том же package.
-
-## Примеры
-
-### Bad
-
-```proto
-// File: dir/foo.proto
-
-syntax = "proto3";
-   
-package foo;
-
-message Foo {
-    string bar = 1;
-}
-```
-
-### Good
-
-```proto
-// File: dir/foo/foo.proto // [!code focus]
-
-syntax = "proto3";
-
-package dir.foo; // [!code focus]
-
-message Foo {
-    string bar = 1;
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/enum-first-value-zero.md b/docs/public/docs/ru-guide/cli/linter/rules/enum-first-value-zero.md
deleted file mode 100644
index 21199e3e..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/enum-first-value-zero.md
+++ /dev/null
@@ -1,37 +0,0 @@
-# ENUM_FIRST_VALUE_ZERO
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что первое значение enum равно нулю.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    BAR = 1;
-    BAZ = 2;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    BAR = 0; // [!code focus]
-    BAZ = 1;
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/enum-no-allow-alias.md b/docs/public/docs/ru-guide/cli/linter/rules/enum-no-allow-alias.md
deleted file mode 100644
index 9b9c75a6..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/enum-no-allow-alias.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# ENUM_NO_ALLOW_ALIAS
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что опция `allow_alias` не установлена в значение `true` внутри enum.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    option allow_alias = true; // [!code focus]
-    BAR = 0;
-    BAZ = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    BAR = 0;
-    BAZ = 1;
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/enum-pascal-case.md b/docs/public/docs/ru-guide/cli/linter/rules/enum-pascal-case.md
deleted file mode 100644
index 8da8d881..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/enum-pascal-case.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# ENUM_PASCAL_CASE
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что имена enum написаны в стиле PascalCase.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum foo_bar {
-    BAR = 0;
-    BAZ = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum FooBar { // [!code focus]
-    BAR = 0;
-    BAZ = 1;
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/enum-value-prefix.md b/docs/public/docs/ru-guide/cli/linter/rules/enum-value-prefix.md
deleted file mode 100644
index 6f9e6866..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/enum-value-prefix.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# ENUM_VALUE_PREFIX
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все значения enum имеют префикс, совпадающий с именем enum.
-
-## Examples
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    BAR = 0;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    FOO_BAR = 0; // [!code focus]
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/enum-value-upper-snake-case.md b/docs/public/docs/ru-guide/cli/linter/rules/enum-value-upper-snake-case.md
deleted file mode 100644
index ec8fe3e5..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/enum-value-upper-snake-case.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# ENUM_VALUE_UPPER_SNAKE_CASE
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что значения enum записаны в стиле UPPER_SNAKE_CASE.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    barName = 0;
-    bazName = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-enum Foo {
-    BAR_NAME = 0; // [!code focus]
-    BAZ_NAME = 1; // [!code focus]
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/enum-zero-value-suffix.md b/docs/public/docs/ru-guide/cli/linter/rules/enum-zero-value-suffix.md
deleted file mode 100644
index 31d417c6..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/enum-zero-value-suffix.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# ENUM_ZERO_VALUE_SUFFIX
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все нулевые значения enum имеют суффикс `_NONE` или ваш кастомный (пользовательский) суффикс.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    BAR = 0;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-enum Foo {
-    FOO_BAR_NONE = 0; // [!code focus]
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/field-lower-snake-case.md b/docs/public/docs/ru-guide/cli/linter/rules/field-lower-snake-case.md
deleted file mode 100644
index 6abc42a5..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/field-lower-snake-case.md
+++ /dev/null
@@ -1,35 +0,0 @@
-# FIELD_LOWER_SNAKE_CASE
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что имена полей сообщений записаны в стиле lower_snake_case.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    string BarName = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    string bar_name = 1; // [!code focus]
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/file-lower-snake-case.md b/docs/public/docs/ru-guide/cli/linter/rules/file-lower-snake-case.md
deleted file mode 100644
index 94d7f60e..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/file-lower-snake-case.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# FILE_LOWER_SNAKE_CASE
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы имеют имя в формате lower_snake_case (только строчные буквы, цифры и символ подчеркивания, без пробелов и заглавных букв).
-
-## Examples
-
-### Bad
-
-```proto
-// File: bar/FooBaz.proto
-
-syntax = "proto3";
-```
-
-### Good
-
-```proto
-// File: bar/foo_baz.proto // [!code focus]
-
-syntax = "proto3";
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/import-no-public.md b/docs/public/docs/ru-guide/cli/linter/rules/import-no-public.md
deleted file mode 100644
index a5a7c499..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/import-no-public.md
+++ /dev/null
@@ -1,30 +0,0 @@
-# IMPORT_NO_PUBLIC
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что в proto-файле не используются `public` импорты (оператор `import public "..."`).
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-import public "bar.proto";
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-import "bar.proto"; // [!code focus]
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/import-no-weak.md b/docs/public/docs/ru-guide/cli/linter/rules/import-no-weak.md
deleted file mode 100644
index 036d3d2d..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/import-no-weak.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# IMPORT_NO_WEAK
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что в proto‑файле не используются weak‑импорты (`import weak "..."`).
-
-Weak import (синтаксис `import weak`) допустим в proto2, но его использование усложняет анализ зависимостей и может приводить к неочевидным ошибкам при генерации кода. Рекомендуется всегда использовать обычный `import`.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto2";
-
-package foo;
-
-import weak "bar.proto";
-```
-
-### Good
-
-```proto
-syntax = "proto2";
-
-package foo;
-
-import "bar.proto"; // [!code focus]
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/import-used.md b/docs/public/docs/ru-guide/cli/linter/rules/import-used.md
deleted file mode 100644
index f289a36c..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/import-used.md
+++ /dev/null
@@ -1,34 +0,0 @@
-# IMPORT_USED
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все импорты используются в proto-файле.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-import "bar.proto";
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-import "bar.proto"; // [!code focus]
-
-message Foo {
-    bar.Bar bar = 1; // [!code focus]
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/message-pascal-case.md b/docs/public/docs/ru-guide/cli/linter/rules/message-pascal-case.md
deleted file mode 100644
index cc764e9f..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/message-pascal-case.md
+++ /dev/null
@@ -1,34 +0,0 @@
-# MESSAGE_PASCAL_CASE
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что имена сообщений (message) записаны в стиле PascalCase.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message foo_bar {
-    string bar_name = 1;
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message FooBar { // [!code focus]
-    string bar_name = 1;
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/oneof-lower-snake-case.md b/docs/public/docs/ru-guide/cli/linter/rules/oneof-lower-snake-case.md
deleted file mode 100644
index 9256efe4..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/oneof-lower-snake-case.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# ONEOF_LOWER_SNAKE_CASE
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что имена oneof записаны в стиле lower_snake_case.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    oneof BarName {
-        string bar_name = 1;
-    }
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    oneof bar_name { // [!code focus]
-        string bar_name = 1;
-    }
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/package-defined.md b/docs/public/docs/ru-guide/cli/linter/rules/package-defined.md
deleted file mode 100644
index 3a8109ed..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/package-defined.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# PACKAGE_DEFINED
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что во всех файлах присутствует директива package.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-message Foo {
-    string bar = 1;
-}
-
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo; // [!code focus]
-
-message Foo {
-    string bar = 1;
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/package-directory-match.md b/docs/public/docs/ru-guide/cli/linter/rules/package-directory-match.md
deleted file mode 100644
index efd04dd6..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/package-directory-match.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# PACKAGE_DIRECTORY_MATCH
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы находятся в директории, имя которой соответствует имени их пакета.
-
-## Examples
-
-### Bad
-
-```proto
-// File: bar/foo.proto
-
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    string bar = 1;
-}
-```
-
-### Good
-
-```proto
-// File: bar/foo.proto // [!code focus]
-
-syntax = "proto3";
-
-package bar; // [!code focus]
-
-message Foo {
-    string bar = 1;
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/package-lower-snake-case.md b/docs/public/docs/ru-guide/cli/linter/rules/package-lower-snake-case.md
deleted file mode 100644
index 237f995b..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/package-lower-snake-case.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# PACKAGE_LOWER_SNAKE_CASE
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что имена package записаны в формате lower_snake_case (строчные буквы, при необходимости цифры и символ подчеркивания, без пробелов и заглавных букв).
-
-## Примеры
-
-### Bad
-
-```proto
-// File: bar/foo.proto
-syntax = "proto3";
-
-package FooBar;
-```
-
-### Good
-
-```proto
-// File: bar/foo.proto
-syntax = "proto3";
-
-package foo_bar; // [!code focus]
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/package-same-csharp-namespace.md b/docs/public/docs/ru-guide/cli/linter/rules/package-same-csharp-namespace.md
deleted file mode 100644
index 072ee316..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/package-same-csharp-namespace.md
+++ /dev/null
@@ -1,54 +0,0 @@
-# PACKAGE_SAME_CSHARP_NAMESPACE
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы с заданным пакетом используют одно и то же пространство имён C# (`csharp_namespace`).
-
-## Примеры
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option csharp_namespace = "Foo.Bar";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option csharp_namespace = "Foo.Baz";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option csharp_namespace = "Foo.Bar"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option csharp_namespace = "Foo.Bar"; // [!code focus]
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/package-same-directory.md b/docs/public/docs/ru-guide/cli/linter/rules/package-same-directory.md
deleted file mode 100644
index a5354e2e..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/package-same-directory.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# PACKAGE_SAME_DIRECTORY
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы с данным package находятся в одной директории.
-
-## Examples
-
-### Bad
-
-```proto
-// File: bar/foo.proto
-
-syntax = "proto3";
-
-package foo;
-
-message Foo {
-    string bar = 1;
-}
-```
-
-### Good
-
-```proto
-// File: bar/foo.proto // [!code focus]
-
-syntax = "proto3";
-
-package bar; // [!code focus]
-
-message Foo {
-    string bar = 1;
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/package-same-go-package.md b/docs/public/docs/ru-guide/cli/linter/rules/package-same-go-package.md
deleted file mode 100644
index 3a4012ca..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/package-same-go-package.md
+++ /dev/null
@@ -1,54 +0,0 @@
-# PACKAGE_SAME_GO_PACKAGE
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы с одним и тем же package используют одно и то же значение опции `go_package`.
-
-## Примеры
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option go_package = "example.com/foo/bar";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option go_package = "example.com/foo/baz";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option go_package = "example.com/foo/bar"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option go_package = "example.com/foo/bar"; // [!code focus]
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/package-same-java-multiple-files.md b/docs/public/docs/ru-guide/cli/linter/rules/package-same-java-multiple-files.md
deleted file mode 100644
index cf070c8f..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/package-same-java-multiple-files.md
+++ /dev/null
@@ -1,54 +0,0 @@
-# PACKAGE_SAME_JAVA_MULTIPLE_FILES
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы с одним и тем же `package` используют одинаковое значение опции `java_package`.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.bar";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo"; // [!code focus]
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/package-same-java-package.md b/docs/public/docs/ru-guide/cli/linter/rules/package-same-java-package.md
deleted file mode 100644
index cc6fca4b..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/package-same-java-package.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# PACKAGE_SAME_JAVA_PACKAGE
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы с одним и тем же `package` используют одно и то же значение опции `java_package`.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.bar";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option java_package = "com.example.foo"; // [!code focus]
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/package-same-php-namespace.md b/docs/public/docs/ru-guide/cli/linter/rules/package-same-php-namespace.md
deleted file mode 100644
index 20a225e3..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/package-same-php-namespace.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# PACKAGE_SAME_PHP_NAMESPACE
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы с одним и тем же `package` используют одно и то же значение опции `php_namespace`.
-
-## Примеры
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option php_namespace = "Foo\\Bar";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option php_namespace = "Foo\\Baz";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option php_namespace = "Foo\\Bar"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option php_namespace = "Foo\\Bar"; // [!code focus]
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/package-same-ruby-package.md b/docs/public/docs/ru-guide/cli/linter/rules/package-same-ruby-package.md
deleted file mode 100644
index eb2cfce4..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/package-same-ruby-package.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# PACKAGE_SAME_RUBY_PACKAGE
-
-Categories:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-This rule checks that all files with a given package are in the same Ruby package.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option ruby_package = "Foo";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option ruby_package = "Bar";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option ruby_package = "Foo"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option ruby_package = "Foo"; // [!code focus]
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/package-same-swift-prefix.md b/docs/public/docs/ru-guide/cli/linter/rules/package-same-swift-prefix.md
deleted file mode 100644
index f99f5989..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/package-same-swift-prefix.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# PACKAGE_SAME_SWIFT_PREFIX
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все файлы с одним и тем же package используют один и тот же `swift_prefix`.
-
-## Examples
-
-### Bad
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option swift_prefix = "Foo";
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option swift_prefix = "Bar";
-```
-
-### Good
-
-```proto
-// File: pkg/foo.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option swift_prefix = "Foo"; // [!code focus]
-```
-
-```proto
-// File: pkg/bar.proto
-
-syntax = "proto3";
-
-package pkg;
-
-option swift_prefix = "Foo"; // [!code focus]
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/package-version-suffix.md b/docs/public/docs/ru-guide/cli/linter/rules/package-version-suffix.md
deleted file mode 100644
index 5f1df064..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/package-version-suffix.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# PACKAGE_VERSION_SUFFIX
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что суффикс версии пакета имеет формат `_vX`, где `X` — числовая версия.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-package foo;
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-package foo.v1; // [!code focus]
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/rpc-no-client-streaming.md b/docs/public/docs/ru-guide/cli/linter/rules/rpc-no-client-streaming.md
deleted file mode 100644
index b3b7edfd..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/rpc-no-client-streaming.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# RPC_NO_CLIENT_STREAMING
-
-Категории:
-
-- **UNARY_RPC**
-
-Это правило проверяет, что RPC не использует клиентский стриминг (запрос не является `stream ...`).
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (stream BarRequest) returns (BarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus]
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/rpc-no-server-streaming.md b/docs/public/docs/ru-guide/cli/linter/rules/rpc-no-server-streaming.md
deleted file mode 100644
index 17c3bea6..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/rpc-no-server-streaming.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# RPC_NO_SERVER_STREAMING
-
-Категории:
-
-- **UNARY_RPC**
-
-Это правило проверяет, что RPC не использует серверный стриминг (ответ не является `stream ...`).
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (stream BarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus]
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/rpc-pascal-case.md b/docs/public/docs/ru-guide/cli/linter/rules/rpc-pascal-case.md
deleted file mode 100644
index a0ec51a8..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/rpc-pascal-case.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# RPC_PASCAL_CASE
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все имена RPC написаны в стиле PascalCase.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service foo_bar {
-    rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service FooBar {
-    rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} // [!code focus]
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/rpc-request-response-unique.md b/docs/public/docs/ru-guide/cli/linter/rules/rpc-request-response-unique.md
deleted file mode 100644
index 37114dfa..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/rpc-request-response-unique.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# RPC_REQUEST_RESPONSE_UNIQUE
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все сообщения запроса и ответа RPC уникальны: для каждого метода используются собственные (не переиспользуются одинаковые пары `Request` / `Response` у разных RPC).
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (FooRequest) returns (FooResponse) {}
-    rpc GetBar (FooRequest) returns (FooResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (FooRequest) returns (FooResponse) {} // [!code focus]
-    rpc GetBar (BarRequest) returns (BarResponse) {} // [!code focus]
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/rpc-request-standard-name.md b/docs/public/docs/ru-guide/cli/linter/rules/rpc-request-standard-name.md
deleted file mode 100644
index 4eddeb72..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/rpc-request-standard-name.md
+++ /dev/null
@@ -1,30 +0,0 @@
-# RPC_REQUEST_STANDARD_NAME
-
-Категории:
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все сообщения запроса RPC названы в формате `MethodRequest`.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (FooRequest) returns (FooResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (GetFooRequest) returns (FooResponse) {} // [!code focus]
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/rpc-response-standard-name.md b/docs/public/docs/ru-guide/cli/linter/rules/rpc-response-standard-name.md
deleted file mode 100644
index d339f3aa..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/rpc-response-standard-name.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# RPC_RESPONSE_STANDARD_NAME
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все сообщения ответа RPC названы в формате `MethodResponse`.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (GetFooRequest) returns (Foo) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc GetFoo (GetFooRequest) returns (GetFooResponse) {} // [!code focus]
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/service-pascal-case.md b/docs/public/docs/ru-guide/cli/linter/rules/service-pascal-case.md
deleted file mode 100644
index 73344ecc..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/service-pascal-case.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# SERVICE_PASCAL_CASE
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все имена сервисов написаны в стиле PascalCase.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service foo_bar {
-    rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {}
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service FooBar { // [!code focus]
-    rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} 
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/linter/rules/service-suffix.md b/docs/public/docs/ru-guide/cli/linter/rules/service-suffix.md
deleted file mode 100644
index 4a248642..00000000
--- a/docs/public/docs/ru-guide/cli/linter/rules/service-suffix.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# SERVICE_SUFFIX
-
-Категории:
-
-- **MINIMAL**
-- **BASIC**
-- **DEFAULT**
-
-Это правило проверяет, что все сервисы имеют суффикс `Service` или ваш пользовательский суффикс.
-
-## Примеры
-
-### Bad
-
-```proto
-syntax = "proto3";
-
-service Foo {
-    rpc Bar(BarRequest) returns (BarResponse);
-}
-```
-
-### Good
-
-```proto
-syntax = "proto3";
-
-service FooService { // [!code focus]
-    rpc Bar(BarRequest) returns (BarResponse); 
-}
-```
diff --git a/docs/public/docs/ru-guide/cli/package-manager/easyp-vs-buf.md b/docs/public/docs/ru-guide/cli/package-manager/easyp-vs-buf.md
deleted file mode 100644
index 93f5d8ed..00000000
--- a/docs/public/docs/ru-guide/cli/package-manager/easyp-vs-buf.md
+++ /dev/null
@@ -1,428 +0,0 @@
-# EasyP против Buf: управление пакетами
-
-[[toc]]
-
-Этот документ даёт подробное сравнение децентрализованного подхода EasyP к управлению пакетами и централизованной модели Buf через Buf Schema Registry (BSR), чтобы помочь понять ключевые различия и выбрать подходящее решение для ваших задач.
-
-## Сравнение архитектуры
-
-### EasyP: децентрализованный подход на базе Git
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                     Архитектура EasyP                           │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│  Машина разработчика           Git репозитории                  │
-│  ┌──────────────┐           ┌─────────────────┐                │
-│  │              │  clone/   │ github.com/     │                │
-│  │ ~/.easyp/    │◄─────────►│ googleapis/     │                │
-│  │ cache/       │  fetch    │ googleapis      │                │
-│  │              │           │                 │                │
-│  │ mod/         │           ├─────────────────┤                │
-│  │              │           │ company.com/    │                │
-│  └──────────────┘           │ internal-protos │                │
-│                              │                 │                │
-│                              ├─────────────────┤                │
-│                              │ gitlab.com/     │                │
-│                              │ team/shared     │                │
-│                              └─────────────────┘                │
-│                                                                 │
-│  ✅ Прямой доступ к репозиториям                                │
-│  ✅ Нет единой точки отказа                                     │
-│  ✅ Работает с любым Git хостингом                              │
-│  ✅ Полный контроль над зависимостями                          │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-### Buf: централизованный реестр (BSR)
-
-```
-┌────────────────────────────────────────────────────────────────┐
-│                      Архитектура Buf                           │
-├────────────────────────────────────────────────────────────────┤
-│                                                                │
-│  Машина разработчика               Buf Schema Registry (BSR)   │
-│  ┌──────────────┐              ┌─────────────────────────────┐ │
-│  │              │   push/pull  │                             │ │
-│  │ ~/.cache/    │◄────────────►│  buf.build                  │ │
-│  │ bufcli/      │   modules    │                             │ │
-│  │              │              │ ┌─────────────────────────┐ │ │
-│  │              │              │ │ googleapis/googleapis   │ │ │
-│  │              │              │ ├─────────────────────────┤ │ │
-│  │              │              │ │ grpc/grpc               │ │ │
-│  │              │              │ ├─────────────────────────┤ │ │
-│  │              │              │ │ envoyproxy/protoc-gen-  │ │ │
-│  │              │              │ │ validate                │ │ │
-│  └──────────────┘              │ └─────────────────────────┘ │ │
-│                                │                             │ │
-│                                └─────────────────────────────┘ │
-│                                                                │
-│  ⚠️ Централизованная зависимость                               │
-│  ⚠️ Единая точка контроля                                      │
-│  ⚠️ Требуется доступ к buf.build                               │
-│  ⚠️ Ограничение экосистемой BSR                                │
-│                                                                │
-└────────────────────────────────────────────────────────────────┘
-```
-
-## Краткое резюме различий
-
-| Аспект | EasyP | Buf |
-|--------|-------|-----|
-| **Архитектура** | Децентрализованная (Git) | Централизованная (реестр BSR) |
-| **Источник зависимостей** | Любой Git репозиторий | Только модули BSR |
-| **Единая точка отказа** | Нет | Да (buf.build) |
-| **Enterprise / air‑gapped** | Полная поддержка | Требует доступа к BSR или приватного BSR |
-| **Аутентификация** | Git (SSH / HTTPS) | Токены Buf + Git |
-| **Vendor lock‑in** | Отсутствует | Привязка к экосистеме Buf |
-| **Частные репозитории** | Нативно через Git | Нужно опубликовать в BSR |
-| **Оффлайн поддержка** | Полная (через vendoring) | Ограничена (кэшированные модули) |
-| **Стоимость** | Бесплатно (использует существующий Git) | Бесплатный тариф + платные планы |
-| **Сложность настройки** | Минимальная | Средняя (настройка BSR) |
-
-## Подробное сравнение возможностей
-
-### 1. Философия управления зависимостями
-
-#### EasyP: «Любой Git репозиторий — это пакет»
-```yaml
-# Прямые ссылки на Git репозитории
-deps:
-  - github.com/googleapis/googleapis@v1.2.3
-  - gitlab.company.com/protos/internal@v2.0.1
-  - git.example.com/team/shared-types@main
-```
-
-**Преимущества:**
-- ✅ Использование любого существующего репозитория сразу
-- ✅ Не нужно «публиковать» в отдельный реестр
-- ✅ Истинный источник версий — Git
-- ✅ Работает с приватными серверами без доп. настроек
-
-#### Buf: «Сначала реестр»
-```yaml
-# buf.yaml — ссылки только на модули BSR
-version: v1
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/grpc/grpc
-  - buf.build/envoyproxy/protoc-gen-validate
-```
-
-**Преимущества:**
-- ✅ Курируемые, проверенные модули
-- ✅ Богатые метаданные и документация
-- ✅ Визуализация графа зависимостей
-- ✅ Принуждение семантического версионирования
-
-**Ограничения:**
-- ❌ Нужно опубликовать в BSR перед использованием
-- ❌ Требует аккаунт и аутентификацию
-- ❌ Нельзя напрямую сослаться на произвольный Git репозиторий
-
-### 2. Корпоративные и изолированные (air‑gapped) среды
-
-#### EasyP: Полноценная оффлайн‑поддержка
-
-**Сценарий**: крупная компания со строгими сетевыми политиками
-
-```bash
-# 1. Среда с доступом в интернет
-easyp mod download          # Скачивает в ~/.easyp/
-easyp mod vendor            # Создает easyp_vendor/
-
-# 2. Перенос в изолированный сегмент
-tar -czf easyp-deps.tar.gz ~/.easyp easyp_vendor/
-# ... перенос архива ...
-
-# 3. В изолированной среде
-tar -xzf easyp-deps.tar.gz
-export EASYPPATH=$PWD/.easyp
-easyp generate              # Работает оффлайн
-```
-
-**Плюсы:**
-- ✅ Не зависит от внешних сервисов
-- ✅ Не нужен внутренний реестр
-- ✅ Использует существующую Git инфраструктуру
-- ✅ Простая файловая дистрибуция
-
-#### Buf: Требует инфраструктуру реестра
-
-```bash
-# Вариант 1: использовать buf.build (нужен интернет)
-buf mod download
-
-# Вариант 2: поднимать приватный BSR (сложно)
-# - Развернуть сервер реестра
-# - Перепубликовать все модули внутрь
-# - Настроить доступы, аутентификацию
-# - Поддерживать работоспособность
-```
-
-**Минусы:**
-- ❌ Постоянный интернет или дорогой приватный BSR
-- ❌ Сложная инфраструктура для частных установок
-- ❌ Все модули нужно републиковать
-- ❌ Дополнительные операционные затраты
-
-### 3. Безопасность и контроль
-
-#### EasyP: Прямой контроль
-```yaml
-# Полный контроль источников
-deps:
-  # Публичный репозиторий — ваша конкретная версия
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-
-  # Внутренний репозиторий
-  - gitlab.company.com/security/validated-protos@v1.0.0
-
-  # Точный коммит (горячий фикс)
-  - github.com/bufbuild/protoc-gen-validate@abc123def456
-```
-
-**Преимущества по безопасности:**
-- ✅ Нет посредника — берём из исходного репозитория
-- ✅ Аудит через историю Git
-- ✅ Нельзя «забанить» доступ извне
-- ✅ Свои процессы сканирования / валидации
-- ✅ Можно форкнуть и удерживать критические версии
-
-#### Buf: Зависимость от реестра
-```yaml
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/grpc/grpc
-```
-
-**Риски:**
-- ⚠️ Посредник контролирует доступность
-- ⚠️ Возможны ограничения / санкции на аккаунт
-- ⚠️ Модуль могут удалить или депрекейтнуть
-- ⚠️ Политики обновлений диктуются стороной
-- ⚠️ Нужно доверять внешней безопасности
-
-### 4. Реальные сценарии
-
-#### Сценарий 1: Стартап с публичными зависимостями
-
-**EasyP:**
-```yaml
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-```
-
-**Buf:**
-```yaml
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/grpcecosystem/grpc-gateway
-```
-
-**Итог:** Паритет — оба хорошо подходят для публичных пакетов.
-
-#### Сценарий 2: Компания со смешанными публичными/приватными зависимостями
-
-**EasyP:**
-```yaml
-deps:
-  - github.com/googleapis/googleapis@v1.2.3
-  - github.com/mycompany/auth-protos@v2.0.0
-  - gitlab.enterprise.com/platform/shared-types@v1.5.1
-```
-
-**Buf:**
-```yaml
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/mycompany/auth-protos
-  - buf.build/mycompany/shared-types
-```
-
-**Итог:** **EasyP** — не требует публикации внутрь BSR.
-
-#### Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap)
-
-**EasyP:**
-```bash
-easyp mod vendor
-# Архив → перенос → распаковка → generate (без сети)
-```
-
-**Buf:**
-```bash
-# Нужен приватный BSR с поддержкой полного оффлайна
-# Сложный цикл публикации и обслуживания
-```
-
-**Итог:** **EasyP** — значительно проще.
-
-#### Сценарий 4: Комплаенс и аудит
-
-**EasyP:**
-- ✅ Прямой аудит изменений (коммиты)
-- ✅ Нет внешних точек зависимости в проде
-- ✅ Повторяемость через фиксированные коммиты / vendor
-- ✅ Управление уязвимостями — в ваших руках
-
-**Buf:**
-- ⚠️ Нужно учитывать BSR в области аудита
-- ⚠️ Дополнительный риск третьей стороны
-- ⚠️ Модули — внешние контролируемые артефакты
-- ⚠️ Сложнее трассировать от реестра к исходникам
-
-**Итог:** **EasyP** — проще для комплаенса.
-
-### 5. Стоимость и инфраструктура
-
-#### EasyP: Нулевая дополнительная инфраструктура
-
-**Затраты:**
-- ✅ $0 — используете существующий Git
-- ✅ Нет дополнительных сервисов/серверов
-- ✅ Нет лицензирования
-- ✅ Масштабирование в рамках Git
-
-**Инфраструктура:**
-- Использует текущие репозитории (GitHub/GitLab/и т.д.)
-- Аутентификация — штатная
-- Резервирование/DR — как уже настроено для Git
-
-#### Buf: Затраты на реестр
-
-**Hosted BSR (buf.build):**
-- ✅ Бесплатный уровень
-- ❌ Платные тарифы для приватного и расширенного использования
-- ❌ Потенциальные изменения ценовой политики
-- ❌ Вопросы локализации данных
-
-**Приватный BSR:**
-- ❌ Серверы, БД, балансировка
-- ❌ Мониторинг, обновления, бэкапы
-- ❌ Лицензирование enterprise функционала
-- ❌ Доп. планирование отказоустойчивости
-
-### 6. Миграция и lock‑in
-
-#### EasyP: Нет привязки
-
-**Миграция ИЗ EasyP:**
-```yaml
-deps:
-  - github.com/googleapis/googleapis@v1.2.3
-```
-(Обычные Git ссылки — легко перенести в другой инструмент.)
-
-**Миграция В EasyP:**
-```bash
-# Просто указываете те же Git репозитории
-```
-
-#### Buf: Потенциальный lock‑in
-
-**Миграция ИЗ Buf:**
-- ❌ Нужно сопоставить BSR модули с исходными Git репо
-- ❌ Имена модулей BSR не совпадают с URL
-- ❌ Возможна потеря удобных метаданных
-- ❌ Сложно при глубокой интеграции с BSR
-
-**Миграция В Buf:**
-- ❌ Нужно опубликовать всё в BSR
-- ❌ Нельзя ссылаться напрямую на Git
-- ❌ Принять workflow BSR (push/pull модулей)
-
-## Когда выбирать каждое решение
-
-### Выберите EasyP, если:
-
-✅ **Air‑gapped / закрытые среды**
-- Нужна работа без внешних сервисов
-- Строгий комплаенс / контроль цепочки поставок
-
-✅ **Фокус на безопасности**
-- Контроль источников зависимостей
-- Минимизация рисков третьих сторон
-
-✅ **Git‑центричная культура**
-- Частные репозитории — норма
-- Не хотите добавлять новый ключевой сервис
-
-✅ **Ограниченный бюджет**
-- Минимизация операционных расходов
-- Предсказуемая стоимость = 0
-
-✅ **Смешанные публичные/частные зависимости**
-- Не хотите перекладывать всё в реестр
-- Нужна гибкость форматов и размещения
-
-### Выберите Buf, если:
-
-✅ **Глубокая интеграция в экосистему BSR**
-- Уже используете линтеры / генерацию Buf
-- Нужны курируемые официальные модули
-- Важны метаданные и граф зависимостей
-
-✅ **Сотрудничество и открытая разработка**
-- Централизованное обнаружение модулей
-- Совместная работа над общими пакетами
-
-✅ **Команда новичков в protobuf**
-- Требуется «направляющая» структура
-- Ценность документации внутри реестра
-
-✅ **Небольшой набор публичных зависимостей**
-- В основном используете популярные общие пакеты
-- Вас устраивает зависимость от BSR
-
-## Пути миграции
-
-### Переход с Buf на EasyP
-
-1. Найдите исходные Git репозитории для каждого модуля BSR  
-2. Сопоставьте имена BSR → Git ссылки (с версиями/тегами)  
-3. Обновите конфигурацию (`easyp.yaml`)  
-4. Протестируйте генерацию и совместимость  
-
-```yaml
-# Было (buf.yaml)
-deps:
-  - buf.build/googleapis/googleapis
-  - buf.build/grpc/grpc
-
-# Стало (easyp.yaml)
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/grpc/grpc@v1.50.0
-```
-
-### Переход с EasyP на Buf
-
-1. Опубликуйте используемые репозитории как модули BSR  
-2. Настройте аутентификацию / организацию Buf  
-3. Замените Git ссылки на BSR модули  
-4. Перейдите к push/pull workflow Buf  
-
-## Заключение
-
-Оба инструмента решают задачу управления зависимостями protobuf, но подходят под разные приоритеты:
-
-**Сильные стороны EasyP:**
-- Корпоративные / изолированные среды
-- Жёсткие требования безопасности и аудита
-- Минимальные затраты и отсутствие доп. инфраструктуры
-- Прямое использование Git (без промежуточного слоя)
-- Простота масштабирования
-
-**Сильные стороны Buf:**
-- Богатая экосистема вокруг реестра
-- Курируемые и документированные модули
-- Удобство для новых команд в protobuf
-- Средства визуализации и централизованного обмена
-
-Выбор часто сводится к балансу между **контролем vs. удобством**, **безопасностью vs. централизованными функциями**, и **стоимостью vs. managed‑сервисом**.
-
-Для большинства enterprise‑окружений децентрализованный Git‑подход EasyP обеспечивает нужные гибкость, безопасность и предсказуемость расходов, тогда как Buf отлично подходит командам, которым важна централизованная коллаборация и богатая экосистема вокруг реестра.
diff --git a/docs/public/docs/ru-guide/cli/package-manager/package-manager.md b/docs/public/docs/ru-guide/cli/package-manager/package-manager.md
deleted file mode 100644
index 98567fad..00000000
--- a/docs/public/docs/ru-guide/cli/package-manager/package-manager.md
+++ /dev/null
@@ -1,458 +0,0 @@
-# Менеджер пакетов
-
-[[toc]]
-
-EasyP предоставляет мощный менеджер пакетов для protobuf‑зависимостей, упрощающий их управление за счёт децентрализованного подхода на базе Git. В отличие от централизованных решений, EasyP работает напрямую с Git‑репозиториями, давая вам полный контроль.
-
-## Обзор
-
-Менеджер пакетов EasyP следует философии **Go modules** — любой Git‑репозиторий может быть источником. Это даёт преимущества:
-
-- **Децентрализация** — нет единой точки отказа или контроля
-- **Безопасность** — прямой доступ к исходникам
-- **Гибкость** — публичные, приватные и корпоративные репозитории
-- **Воспроизводимость** — lock‑файлы обеспечивают одинаковые сборки
-- **Производительность** — локальный кеш сокращает сетевые запросы
-
-### Основные возможности
-
-| Возможность | Описание |
-|-------------|----------|
-| **Git-Native** | Любой Git репозиторий, не нужен спец‑сервер |
-| **Множество форматов версий** | Теги, коммиты, псевдо‑версии, latest |
-| **Lock Files** | Воспроизводимые сборки через `easyp.lock` |
-| **Локальный кеш** | Архитектура как у Go modules |
-| **Vendoring** | Локальное копирование для оффлайн сборок |
-| **YAML конфигурация** | Простые и читаемые декларации |
-
-## Архитектура
-
-EasyP использует двухуровневый кеш, вдохновлённый Go modules:
-
-```
-~/.easyp/
-├── cache/
-│   ├── download/              # Архивы + контрольные суммы
-│   │   └── github.com/
-│   │       └── googleapis/
-│   │           └── googleapis/
-│   │               ├── v1.2.3.zip       # Архив
-│   │               ├── v1.2.3.ziphash   # Checksum
-│   │               └── v1.2.3.info      # Метаданные
-│   └── {git-hash}/            # Bare репозитории Git (внутренне)
-└── mod/                       # Распакованные готовые модули
-    └── github.com/
-        └── googleapis/
-            └── googleapis/
-                ├── v1.2.3/           # Тегированная версия
-                │   ├── google/
-                │   │   ├── api/
-                │   │   └── rpc/
-                │   └── ...
-                └── v0.0.0-20250101123456-abc123def/  # Псевдо‑версия
-                    ├── google/
-                    └── ...
-```
-
-### Расположение кеша
-
-| Окружение | Путь | Как задать |
-|-----------|------|-----------|
-| **По умолчанию** | `$HOME/.easyp` | Автоматически |
-| **Свое** | Любая директория | Переменная `EASYPPATH` |
-| **CI/CD** | В каталоге проекта | `export EASYPPATH=$CI_PROJECT_DIR/.easyp` |
-
-## Конфигурация
-
-### Базовая конфигурация
-
-Зависимости описываются в `easyp.yaml`:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-  - github.com/bufbuild/protoc-gen-validate
-```
-
-### Расширенные примеры
-
-#### Multi-Environment Setup
-```yaml
-# development.easyp.yaml
-deps:
-  - github.com/googleapis/googleapis              # Последнее для разработки
-  - github.com/mycompany/internal-protos          # Внутренние изменения
-  - github.com/bufbuild/protoc-gen-validate       # Новые фичи
-
-# production.easyp.yaml
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1       # Зафиксировано
-  - github.com/mycompany/internal-protos@v2.1.0                # Стабильно
-  - github.com/bufbuild/protoc-gen-validate@v0.10.1            # Проверено
-```
-
-#### Приватные репозитории
-```yaml
-deps:
-  # Публичное
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-
-  # Частные
-  - github.com/mycompany/auth-protos@v1.5.0
-  - github.com/mycompany/common-types@v2.0.1
-
-  # Внутренний GitLab
-  - gitlab.company.com/platform/messaging-protos@v0.3.0
-```
-
-## Стратегии версионирования
-
-Поддерживаются разные способы фиксации версий:
-
-### 1. Семантические теги (для продакшена)
-
-```yaml
-deps:
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-```
-
-**Используйте когда:**
-- Продакшен
-- Стабильное потребление API
-- Нужна воспроизводимость
-
-### 2. Последний тег (development)
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/bufbuild/protoc-gen-validate
-```
-
-**Подходит для:**
-- Активной разработки
-- Получения свежих возможностей
-- Тестирования совместимости
-
-### 3. Хеш коммита (Bleeding Edge)
-
-```yaml
-deps:
-  - github.com/bufbuild/protoc-gen-validate@abc123def456789abcdef123456789abcdef1234
-```
-
-**Когда нужно:**
-- Нерелизные фичи
-- Тест конкретного фикса
-- Вклад в upstream
-
-### 4. Псевдо‑версии (автоматически)
-
-Если нет подходящего тега — создаётся псевдо‑версия:
-
-```
-Формат: v0.0.0-{timestamp}-{short-commit-hash}
-Пример: v0.0.0-20250908104020-660ec2d64e07f2fa8947527443af058b3d7169df
-```
-
-## Команды
-
-### `easyp mod download`
-
-Скачивает и устанавливает все объявленные зависимости.
-
-**Что делает:**
-1. Разрешает версии (теги → коммиты)
-2. Скачивает архивы в `cache/download`
-3. Проверяет контрольные суммы
-4. Распаковывает в `cache/mod`
-5. Обновляет `easyp.lock`
-
-**Пример:**
-```bash
-easyp mod download
-easyp --cfg production.easyp.yaml mod download
-EASYPPATH=/tmp/easyp-cache easyp mod download
-```
-
-### `easyp mod vendor`
-
-Копирует все proto зависимости в локальный `easyp_vendor/` для оффлайна.
-
-**Сценарии:**
-- Docker сборки
-- Air-gapped окружения
-- Воспроизводимость
-- Ускорение
-
-```bash
-easyp mod vendor
-```
-
-Структура:
-```
-easyp_vendor/
-├── github.com/
-│   ├── googleapis/
-│   │   └── googleapis/
-│   │       ├── google/
-│   │       │   ├── api/
-│   │       │   │   ├── annotations.proto
-│   │       │   │   └── http.proto
-│   │       │   └── rpc/
-│   │       │       └── status.proto
-│   │       └── ...
-│   └── grpc-ecosystem/
-│       └── grpc-gateway/
-│           └── protoc-gen-openapiv2/
-│               └── options/
-│                   └── annotations.proto
-```
-
-### `easyp mod update`
-
-Обновляет версии согласно `easyp.yaml`, пересоздаёт lock.
-
-```bash
-easyp mod update
-```
-
-## Lock файл
-
-`easyp.lock` фиксирует точные версии и хеш содержимого:
-
-```
-github.com/bufbuild/protoc-gen-validate v0.0.0-20250908104020-660ec2d64e07f2fa8947527443af058b3d7169df h1:ZZ5JyUkmrj9OBHM+gOCzeL5L/pAKVbsUl051yhhJTjU=
-github.com/googleapis/googleapis v0.0.0-20250909114430-8727b5ba7f23fbbfddda58239e8bc6b547e05878 h1:eI+XYpPio3fxl9H5/VjW2PxlxM/7yqPjEq3oQ6jUkj4=
-github.com/grpc-ecosystem/grpc-gateway v2.19.1 h1:01NNlCezvwUQ07ZvblXH0kelWq8hNl2qb44bOMcaSTQ=
-```
-
-**Формат строки:**
-- Путь модуля
-- Версия (тег или псевдо)
-- Хеш содержимого (`h1:`)
-
-**Практики:**
-✅ Коммитить `easyp.lock`  
-✅ Осознанно обновлять `mod update`  
-✅ Ревью изменений версий  
-❌ Не редактировать вручную  
-
-## Аутентификация
-
-### Публичные репозитории
-
-Работают без настроек:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/bufbuild/protoc-gen-validate
-```
-
-### Приватные репозитории
-
-#### SSH ключи (рекомендуется)
-
-```bash
-git config --global url."git@github.com:".insteadOf "https://github.com/"
-git config --global url."git@gitlab.com:".insteadOf "https://gitlab.com/"
-git config --global url."git@gitlab.company.com:".insteadOf "https://gitlab.company.com/"
-```
-
-Конфиг остаётся с HTTPS URL:
-
-```yaml
-deps:
-  - github.com/mycompany/private-protos@v1.0.0
-  - gitlab.company.com/platform/shared-types@v2.1.0
-```
-
-#### Personal Access Tokens
-
-```bash
-git config --global credential.helper store
-echo "https://username:token@github.com" >> ~/.git-credentials
-
-git config --global url."https://username:token@github.com/mycompany".insteadOf "https://github.com/mycompany"
-```
-
-#### Корпоративная среда
-
-```bash
-git config --global http.proxy http://proxy.company.com:8080
-git config --global https.proxy https://proxy.company.com:8080
-git config --global http.sslCAInfo /path/to/certificate.pem
-```
-
-## Типовые workflows
-
-### Инициализация проекта
-
-```bash
-cat > easyp.yaml << EOF
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-EOF
-
-easyp mod download
-ls ~/.easyp/mod/github.com/googleapis/googleapis/
-```
-
-### Добавление зависимости
-
-```bash
-echo "  - github.com/bufbuild/protoc-gen-validate@v0.10.1" >> easyp.yaml
-easyp mod download
-git add easyp.lock
-git commit -m "Add protoc-gen-validate dependency"
-```
-
-### Обновление
-
-```bash
-easyp mod update
-git diff easyp.lock
-easyp generate
-easyp lint
-git add easyp.lock
-git commit -m "Update dependencies"
-```
-
-### Оффлайн режим
-
-```bash
-easyp mod vendor
-easyp generate
-```
-
-## Troubleshooting
-
-### Частые проблемы
-
-#### "Repository not found" / "Authentication failed"
-
-```bash
-git ls-remote https://github.com/mycompany/private-repo
-git config --list | grep url
-```
-
-#### "Version not found"
-
-```bash
-git ls-remote --tags https://github.com/googleapis/googleapis
-# Проверить корректный тег
-deps:
-  - github.com/googleapis/googleapis@common-protos-1_3_1
-```
-
-#### "Cache corruption" / "Checksum mismatch"
-
-```bash
-rm -rf ~/.easyp
-rm -rf ~/.easyp/cache/download
-easyp mod download
-```
-
-#### Тайм-ауты сети
-
-```bash
-git config --global http.lowSpeedLimit 1000
-git config --global http.lowSpeedTime 300
-git config --global http.proxy http://proxy.company.com:8080
-```
-
-### Оптимизация
-
-#### Для больших команд
-
-```bash
-export EASYPPATH=/shared/easyp-cache
-export EASYPPATH=/team-cache/easyp
-```
-
-#### Для CI/CD
-
-```bash
-export EASYPPATH=$CI_PROJECT_DIR/.easyp
-# Пример кеширования (GitLab CI)
-cache:
-  key: easyp-$CI_COMMIT_REF_SLUG
-  paths:
-    - .easyp/
-```
-
-#### Управление размером кеша
-
-```bash
-du -sh ~/.easyp
-du -sh ~/.easyp/cache/download
-du -sh ~/.easyp/mod
-find ~/.easyp/mod -type d -name "v0.0.0-*" -mtime +30 -exec rm -rf {} \;
-```
-
-## Примеры интеграции
-
-### Docker multi-stage
-
-```dockerfile
-FROM ghcr.io/easyp-tech/easyp:latest AS deps
-WORKDIR /workspace
-COPY easyp.yaml easyp.lock ./
-RUN easyp mod vendor
-
-FROM alpine:latest AS build
-WORKDIR /app
-COPY --from=deps /workspace/easyp_vendor ./easyp_vendor
-COPY . .
-RUN easyp generate
-```
-
-### Monorepo
-
-```
-my-monorepo/
-├── services/
-│   ├── auth-service/
-│   │   └── easyp.yaml
-│   └── user-service/
-│       └── easyp.yaml
-├── shared/
-│   └── common-protos/
-└── easyp.yaml
-```
-
-Каждый `easyp.yaml` может иметь свой набор зависимостей.
-
-## Лучшие практики
-
-### Workflow разработки
-- ✅ Latest теги в активной разработке
-- ✅ Фиксация версий в продакшене
-- ✅ Коммит lock файла
-- ✅ Ревью обновлений
-- ✅ Тест после обновления
-
-### Безопасность
-- ✅ Фиксируйте версии
-- ✅ Используйте SSH ключи
-- ✅ Оценивайте новые зависимости
-- ✅ Следите за уязвимостями
-- ❌ Не храните секреты в конфиге
-
-### Производительность
-- ✅ Агрессивное кеширование в CI
-- ✅ Vendoring для частых сборок
-- ✅ Чистка старого кеша
-- ✅ Общий кеш для команды
-
-### Командная работа
-- ✅ Документация по аутентификации
-- ✅ Единые инструменты
-- ✅ Автоматизация обновлений с тестами
-- ✅ Общий кеш при возможности
-
-Менеджер пакетов EasyP — масштабируемое децентрализованное решение от одиночных проектов до enterprise, сохраняя простоту и надёжность.
diff --git a/docs/public/docs/ru-guide/introduction/install.md b/docs/public/docs/ru-guide/introduction/install.md
deleted file mode 100644
index 56a40499..00000000
--- a/docs/public/docs/ru-guide/introduction/install.md
+++ /dev/null
@@ -1,50 +0,0 @@
-# Установка EasyP CLI
-
-### Установка через менеджер пакетов системы
-
-##### Рекомендуемый способ установки
-
-#### Homebrew
-
-Можно установить бинарный релиз в macOS через Homebrew:
-
-```bash
-brew install easyp-tech/tap/easyp
-```
-
-`Work in progress` — поддержка других менеджеров (apt, yum, pacman и т.д.) в процессе.
-
-## Локальная установка
-
-#### _**Не рекомендуется**_
-
-Локальная установка менее предпочтительна, потому что пакетные менеджеры обеспечивают:
-- Автоматические обновления и патчи безопасности
-- Лучшую интеграцию с системой
-- Упрощённую установку и удаление
-- Подписанные и проверенные бинарники
-
-#### Требуется Go 1.24 или новее
-
-### Установка через go install
-
-Команда установит последнюю стабильную версию easyp:
-
-```bash
-go install github.com/easyp-tech/easyp/cmd/easyp@latest
-```
-
-### Сборка из исходников
-
-1. Клонирование репозитория
-
-```bash
-git clone https://github.com/easyp-tech/easyp.git
-```
-
-2. Сборка с помощью Go
-
-```bash
-go build ./cmd/easyp
-```
-
diff --git a/docs/public/docs/ru-guide/introduction/quickstart.md b/docs/public/docs/ru-guide/introduction/quickstart.md
deleted file mode 100644
index a223a450..00000000
--- a/docs/public/docs/ru-guide/introduction/quickstart.md
+++ /dev/null
@@ -1,159 +0,0 @@
-# Быстрый старт (Quickstart)
-
-EasyP — современный toolkit для работы с файлами Protobuf. В этом кратком руководстве вы научитесь:
-
-1. **Инициализировать** проект с конфигурацией EasyP
-2. **Настраивать линтинг**, чтобы ловить ошибки и соблюдать лучшие практики
-3. **Управлять зависимостями** из Git‑репозиториев
-4. **Генерировать код** из ваших Protobuf файлов
-
-## Предварительные требования
-
-Перед началом убедитесь, что у вас установлены:
-
-- **EasyP CLI** — см. [руководство по установке](/docs/guide/introduction/install)
-- **Git** доступен в вашем `$PATH`
-- **Файлы `.proto`** (или создайте их по ходу)
-
-Проверить версию EasyP:
-
-```bash
-easyp --version
-```
-
-## Инициализация проекта
-
-Создайте базовый файл конфигурации `easyp.yaml` в корне проекта:
-
-```bash
-easyp init
-```
-
-Команда генерирует шаблон `easyp.yaml` с комментариями, дефолтными lint-правилами и настройками breaking-check.
-`easyp init` работает интерактивно: если в корне есть `buf.yml`/`buf.yaml`, EasyP предложит миграцию; если `easyp.yaml` уже существует, попросит подтверждение перед перезаписью.
-
-## Настройка линтинга
-
-Линтинг помогает находить проблемы и поддерживать единый стиль. EasyP использует правила, совместимые с Buf.
-
-Секция `lint` уже создаётся командой `easyp init`. При необходимости отредактируйте её, например так:
-
-```yaml
-lint:
-  use:
-    - DEFAULT
-```
-
-Запустите линтер:
-
-```bash
-easyp lint
-```
-
-Линтер проверит все `.proto` файлы и сообщит о найденных проблемах.
-
-::: tip
-Правила линтинга EasyP на 100% совместимы с Buf — мигрировать просто.
-:::
-
-## Управление зависимостями
-
-Если вы используете сторонние protobuf пакеты (например Google APIs или gRPC Gateway), EasyP упрощает их подключение.
-
-### Формат зависимости
-
-Запись: `$GIT_LINK@$VERSION`
-
-- **`$GIT_LINK`** — URL любого Git‑репозитория (GitHub, GitLab и т.д.)
-- **`$VERSION`** — тег или хеш коммита (опционально)
-
-Если версия не указана — берётся последний коммит из основной ветки.
-
-### Добавление зависимостей
-
-Дополните `easyp.yaml`:
-
-```yaml
-lint:
-  use:
-    - DEFAULT
-deps:
-  - github.com/googleapis/googleapis                          # Последний коммит
-  - github.com/grpc-ecosystem/grpc-gateway@v2.20.0           # Конкретная версия
-```
-
-### Загрузка зависимостей
-
-```bash
-easyp mod download
-```
-
-Команда:
-- Скачивает версии из `easyp.lock`, если он существует
-- Иначе — берёт из `easyp.yaml` и создаёт `easyp.lock`
-
-::: info
-Совет: `easyp mod update` — игнорирует lock‑файл и подтягивает актуальные версии из `easyp.yaml`.
-:::
-
-## Генерация кода
-
-EasyP поддерживает все стандартные protoc‑плагины.
-
-### Конфигурация генерации
-
-Добавьте плагины:
-
-```yaml
-lint:
-  use:
-    - DEFAULT
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/grpc-ecosystem/grpc-gateway@v2.20.0
-generate:
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-```
-
-### Запуск генерации
-
-```bash
-easyp generate
-```
-
-EasyP выполнит:
-1. Разрешение всех зависимостей
-2. Подключение к сервису EasyP (или локальный режим)
-3. Запуск указанных плагинов
-4. Вывод сгенерированного кода в нужные директории
-
-::: tip
-Гибридный рантайм: WASM для скорости, Docker — для тяжёлых плагинов.
-:::
-
-## Следующие шаги
-
-Поздравляем! 🎉 Вы успешно:
-- ✅ Инициализировали проект EasyP
-- ✅ Настроили линтинг
-- ✅ Управляете внешними зависимостями
-- ✅ Сгенерировали код из `.proto`
-
-### Узнать больше
-
-- **[CLI Reference](/docs/guide/cli/linter/linter)** — подробности по командам
-- **[API Service](/docs/guide/api-service/overview)** — удалённая генерация
-- **[Configuration](/docs)** — все опции конфигурации
-
----
-
-*Приятной работы с Protobuf — без боли! 🚀*
diff --git a/docs/public/docs/ru-guide/introduction/what-is.md b/docs/public/docs/ru-guide/introduction/what-is.md
deleted file mode 100644
index 3985b093..00000000
--- a/docs/public/docs/ru-guide/introduction/what-is.md
+++ /dev/null
@@ -1,157 +0,0 @@
-# Что такое EasyP?
-
-EasyP — это современный инструментарий для работы с Protocol Buffers, который объединяет весь ваш protobuf‑workflow в один мощный CLI‑инструмент. Он совмещает линтинг, управление пакетами, генерацию кода и проверку совместимости в единой среде и устраняет сложность традиционной работы с protobuf.
-
-<div class="tip custom-block" style="padding-top: 8px">
-Хотите просто попробовать? Перейдите сразу к разделу [Quickstart](./guide/introduction/quickstart).
-</div>
-
-## Проблема: фрагментированные protobuf‑процессы
-
-Работа с Protocol Buffers в разных проектах часто создает лишнюю сложность и трение:
-
-### Хаос инструментов
-- **Много отдельных утилит**: Отдельно для линтинга, генерации и управления зависимостями
-- **Несогласованные конфигурации**: Разные форматы и правила в разных командах
-- **Сложный онбординг**: Новым разработчикам нужно долго вникать
-
-### Проблемы управления зависимостями
-- **Нет стандартизированного подхода**: Каждый проект решает это по‑своему
-- **Конфликты версий**: Трудно сводить разные версии одних и тех же proto‑библиотек
-- **Неповторяемость сборок**: Сложно гарантировать одинаковый результат в разных окружениях
-
-### Трение в разработке
-- **Ручные операции**: Много повторяющихся шагов
-- **Разрастание конфигураций**: Множество файлов и форматов
-- **Затратная проверка совместимости**: Часто вручную и постфактум
-
-## Решение: единый protobuf‑инструментарий
-
-EasyP устраняет эти проблемы, предоставляя целостный opinionated‑подход и стандартизируя процессы:
-
-### Один инструмент — все задачи
-Вместо жонглирования утилитами EasyP даёт:
-- **Linting** с расширенными наборами правил
-- **Package management** с Git‑нативными зависимостями
-- **Code generation** локально и удалённо
-- **Breaking change detection** для контроля совместимости API
-
-### Единая конфигурация
-Один файл `easyp.yaml` описывает весь workflow — меньше расхождений, проще сопровождать.
-
-### Git‑native зависимости
-Прямое использование Git‑репозиториев вместо централизованных реестров: прозрачная история, контроль версий, воспроизводимые сборки.
-
-## Ключевые возможности
-
-| Feature | Description |
-|---------|-------------|
-| 🔍 **Comprehensive Linting** | Полная поддержка правил buf с настраиваемыми профилями для лучших практик API‑дизайна. |
-| 📦 **Smart Package Manager** | Git‑ориентированное управление зависимостями с lock‑файлом для воспроизводимости. |
-| ⚡ **Code Generation** | Многозадачная генерация кода с поддержкой локальных и удалённых protoc‑плагинов. |
-| 🔄 **Breaking Change Detection** | Автоматическая проверка совместимости API против веток Git. |
-| 🌐 **Remote Plugin Support** | Выполнение плагинов через централизованный EasyP API сервис без локальных установок. |
-| 🎯 **Developer Experience** | Автодополнение, понятные ошибки, единая структура и документация. |
-
-## Типы поддерживаемых плагинов
-
-EasyP гибко подходит к выполнению генерации:
-
-### Local Plugins
-Стандартные установленные protoc‑плагины:
-```yaml
-plugins:
-  - name: go
-    out: .
-    opts:
-      paths: source_relative
-```
-
-### Remote Plugins
-Плагины через EasyP API сервис для воспроизводимости:
-```yaml
-plugins:
-  - remote: api.easyp.tech/protoc-gen-typescript:latest
-    out: ./web/generated
-```
-
-### Custom Plugins
-Поддержка экосистемы пользовательских расширений.
-
-## Децентрализованный менеджмент пакетов
-
-В отличие от других решений EasyP не требует централизованного реестра. Любой Git‑репозиторий может быть источником:
-
-- **Гибкость**: Любой Git‑хостинг (GitHub, GitLab, self‑hosted)
-- **Нет vendor lock‑in**: Зависимости не привязаны к одному провайдеру
-- **Полная история**: Ветки, теги, ревью
-- **Enterprise‑совместимость**: Поддержка приватных репозиториев
-
-## Бесшовная миграция с Buf
-
-EasyP изначально совместим с экосистемой buf:
-
-- **Совпадающие rule sets**
-- **Похожая структура YAML**
-- **Минимальные изменения для замены**
-- **Постепенное внедрение** без ломки текущего пайплайна
-
-### EasyP vs buf.build
-
-| Feature | EasyP | buf.build |
-|---------|--------|-----------|
-| **Dependency Management** | Git‑репозитории | Buf Schema Registry (BSR) |
-| **Vendor Lock-in** | Нет | Привязка к BSR для полного функционала |
-| **Plugin Execution** | Local + Remote | Local + BSR plugins |
-| **Private Dependencies** | Любой Git провайдер | BSR или ручное управление |
-| **Offline Development** | Полная поддержка (`mod vendor`) | Ограниченно без доступа к BSR |
-| **Enterprise Integration** | Использует существующий Git | Требует настройку BSR |
-| **Breaking Change Detection** | Против любой Git ссылки | Аналогично |
-| **Package Distribution** | Любой Git | Публикация через BSR |
-| **License** | Apache 2.0 | Apache 2.0 |
-| **Community** | Growing | Established |
-
-**Преимущества миграции:**
-- Без изменения инфраструктуры
-- Плавное принятие новых возможностей
-- Гибрид локальных и удалённых плагинов
-- Единая конфигурация вместо набора файлов
-
-## Наши цели для Protobuf
-
-Миссия EasyP — ускорить принятие **schema‑driven API** через удобный, надёжный и прозрачный инструментарий.
-
-### Современная экосистема
-Повышаем DX вокруг protobuf, чтобы конкурентно выглядеть по простоте против REST/JSON, сохраняя типовую строгость и производительность.
-
-### Developer Experience прежде всего
-Интуитивный CLI, понятные ошибки, ясные сообщения, минимальная фрагментация.
-
-### Готов к Enterprise
-Воспроизводимые сборки, приватные репозитории, интеграция в CI/CD.
-
-## Почему EasyP?
-
-### Для индивидуальных разработчиков
-- Быстрый старт за минуты
-- Один инструмент — меньше когнитивной нагрузки
-- Понятная документация
-
-### Для команд
-- Единые стандарты
-- Повторяемые сборки (lock‑файл)
-- Ускоренный онбординг
-
-### Для организаций
-- Нет vendor lock‑in
-- Безопасность приватных репозиториев
-- Лёгкая интеграция в существующие пайплайны
-
-## Что дальше?
-
-EasyP упрощает работу с protobuf — фокусируйтесь на API, а не на рутине. Хотите начать?
-
-Смотрите [Installation Guide](/docs/guide/introduction/install) и [Quickstart](/docs/guide/introduction/quickstart).
-
-## Stargazers over time
-[![Stargazers over time](https://starchart.cc/easyp-tech/easyp.svg?variant=adaptive)](https://starchart.cc/easyp-tech/easyp)
diff --git a/docs/public/docs/ru-guide/migration/buf-cli.md b/docs/public/docs/ru-guide/migration/buf-cli.md
deleted file mode 100644
index 6cd855fd..00000000
--- a/docs/public/docs/ru-guide/migration/buf-cli.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Buf CLI
-
-## В работе
\ No newline at end of file
diff --git a/docs/public/docs/ru-guide/migration/protoc.md b/docs/public/docs/ru-guide/migration/protoc.md
deleted file mode 100644
index 3d65c269..00000000
--- a/docs/public/docs/ru-guide/migration/protoc.md
+++ /dev/null
@@ -1,248 +0,0 @@
-# Миграция с protoc на EasyP
-
-> Исходная англоязычная версия файла содержала только заголовок и пометку “Work in progress”. Ниже — полноценный русскоязычный черновик раздела миграции. Уточни, если требуется сократить или изменить уровень детализации.
-
-## 1. Краткое сравнение
-
-| Аспект | `protoc` | EasyP |
-|--------|----------|-------|
-| Базовая роль | Базовый компилятор `.proto` файлов | Инструмент “всё в одном”: линтинг, проверка несовместимых изменений, менеджер пакетов, генерация |
-| Конфигурация | Чаще shell‑скрипты / Makefile / вручную передаваемые флаги | Единый файл `easyp.yaml` (YAML или JSON) |
-| Управление зависимостями | Ручной `git clone`, `submodule`, vendoring | Секция `deps` с Git‑репозиториями |
-| Набор правил линтера | Нет встроенного | Встроенный линтер с правилами (можно включать/исключать) |
-| Проверка breaking changes | Отсутствует из коробки | Команда `easyp breaking` |
-| Расширенные плагины | Установка и вызов через флаги `--plugin` | Плагины через конфиг; поддержка удалённого выполнения (API Service) и стандартного локального |
-| Единообразие в CI | Нужно собирать вручную | Консистентные команды: `lint`, `breaking`, `generate` |
-
-## 2. Когда имеет смысл мигрировать
-
-Миграция на EasyP особенно полезна если:
-- Есть потребность в автоматической проверке качества (стиль, именование) `.proto` файлов.
-- Нужна защита от нелегитимных несовместимых изменений при эволюции схем.
-- В проекте используется несколько языков генерации и растёт число скриптов вокруг `protoc`.
-- Вы хотите единый конфиг вместо множества shell/Makefile комбинаций.
-- Планируется централизованное исполнение плагинов (через API Service) или унификация окружения в CI.
-
-## 3. Типичный сценарий “до” (только protoc)
-
-Пример: локальные скрипты / Makefile:
-
-```makefile
-protoc \
-  -I . \
-  -I third_party \
-  --go_out=./gen/go --go_opt=paths=source_relative \
-  --go-grpc_out=./gen/go --go-grpc_opt=paths=source_relative \
-  api/echo/v1/echo.proto
-```
-
-Дополнительные зависимости (googleapis, validate, grpc-gateway) скачиваются вручную или через submodules.
-
-## 4. Типичный сценарий “после” (EasyP)
-
-Единый файл `easyp.yaml`:
-
-```yaml
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/envoyproxy/protoc-gen-validate
-
-generate:
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-    - name: validate
-      out: gen/go
-      opts:
-        paths: source_relative
-        lang: "go"
-```
-
-Команды:
-```bash
-easyp mod update      # Скачивание/обновление deps
-easyp lint            # Линтинг .proto
-easyp breaking --against git-ref=origin/main
-easyp generate        # Генерация кода
-```
-
-## 5. Пошаговая миграция
-
-1. Инвентаризация:
-   - Соберите список всех вызовов `protoc` (скрипты, Makefile, CI).
-   - Зафиксируйте используемые плагины и их версии.
-2. Создание `easyp.yaml`:
-   - Поле `version` не обязательно (можете оставить его только для обратной совместимости).
-   - Перенесите плагины в секцию `generate.plugins`.
-   - Укажите опции, которые ранее передавались в командной строке.
-3. Зависимости:
-   - Все внешние каталоги (googleapis, validate, grpc-gateway и т.п.) занесите в `deps`.
-   - Удалите лишние submodules при необходимости.
-4. Линтер:
-   - Запустите `easyp lint` и посмотрите на предупреждения.
-   - При необходимости добавьте `lint.use`, `lint.ignore`, `lint.except`.
-5. Проверка breaking changes:
-   - Выберите референс (обычно `origin/main` или предыдущий тег).
-   - Запустите `easyp breaking --against git-ref=origin/main`.
-   - Настройте игнорируемые изменения (`breaking.ignore`), если нужно.
-6. Обновление CI:
-   - Замените прямые вызовы `protoc` на `easyp generate`.
-   - Добавьте отдельные шаги `lint` и `breaking`.
-7. Очистка:
-   - Удалите устаревшие генерационные скрипты, если они дублируют функционал EasyP.
-8. Документация:
-   - Обновите README / CONTRIBUTING (новый способ генерации).
-9. Верификация:
-   - Сравните результат генерации до и после (git diff).
-   - Убедитесь, что имена файлов и пути совпадают или скорректируйте структуру.
-
-## 6. Замена в CI (пример GitHub Actions)
-
-```yaml
-- name: Install EasyP
-  run: go install github.com/easyp-tech/easyp/cmd/easyp@latest
-
-- name: Lint
-  run: easyp lint
-
-- name: Breaking
-  run: easyp breaking --against git-ref=origin/main
-
-- name: Generate
-  run: easyp generate
-```
-
-## 7. Работа с плагинами
-
-| Тип | В protoc | В EasyP |
-|-----|----------|---------|
-| Стандартные (`protoc-gen-go`) | Указание через `--go_out` | `plugins: - name: go ...` |
-| gRPC | `--go-grpc_out` | Второй плагин `go-grpc` |
-| Validate | Доп. установка + `--validate_out` | `- name: validate` с opts |
-| gRPC-Gateway / OpenAPI | `--grpc-gateway_out` / `--openapiv2_out` | Плагины `grpc-gateway`, `openapiv2` |
-| Кастомные | Путь к бинарю / `--plugin=protoc-gen-xxx` | `- name: xxx` или удалённый `remote:` (если используется API Service) |
-
-Если вы переходите на удалённое выполнение (API Service), записи в конфиге могут выглядеть так:
-
-```yaml
-generate:
-  plugins:
-    - remote: api.easyp.tech/protobuf/go:v1.36.10
-      out: gen/go
-      opts:
-        paths: source_relative
-```
-
-## 8. Проверка корректности после миграции
-
-1. `git diff` после `easyp generate` — не должно быть неожиданных изменений.
-2. Сравнить размер и содержимое каталога сгенерированных файлов.
-3. Запустить ваш потребляющий код (сборка, тесты).
-4. Проверить, что плагины (validate, grpc-gateway) продолжают вставлять необходимые аннотации / опции.
-5. Линт не должен выдавать критичных ошибок — скорректируйте стиль .proto, если требуется.
-
-## 9. Частые проблемы
-
-| Проблема | Причина | Решение |
-|----------|---------|---------|
-| Плагин не найден | Не установлен или не указан в PATH | Выполнить `go install ...` или добавить в конфиг как remote |
-| Ошибка импорта `.proto` | Отсутствует репозиторий в `deps` | Добавить адрес в секцию `deps` и `easyp mod update` |
-| Несовместимые изменения на каждом PR | Отсутствует игнор/настройка сравнения | Уточнить ветку/тег в `--against` или настроить `breaking.ignore` |
-| Локально работает, в CI падает | В CI нет зависимостей (не вызван update) | Добавить шаг `easyp mod update` перед `generate` |
-| Дубликаты сгенерированных файлов | Изменена структура путей или `out` | Синхронизировать `out` и `paths: source_relative` опции |
-
-## 10. Минимальный пример конфигурации (только Go)
-
-```yaml
-generate:
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-```
-
-Команды:
-```bash
-easyp generate
-```
-
-## 11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)
-
-```yaml
-lint:
-  use:
-    - ENUM_FIRST_VALUE_ZERO
-    - SERVICE_SUFFIX
-  allow_comment_ignores: false
-  enum_zero_value_suffix: _NONE
-  service_suffix: Service
-
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/envoyproxy/protoc-gen-validate
-
-generate:
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-    - name: validate
-      out: gen/go
-      opts:
-        paths: source_relative
-        lang: "go"
-    - name: grpc-gateway
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: openapiv2
-      out: gen/openapi
-      opts:
-        simple_operation_ids: true
-
-breaking:
-  against_git_ref: main
-  ignore:
-    - ENUM_VALUE_SAME_NAME
-```
-
-## 12. Checklist миграции
-
-- [ ] Собраны все текущие вызовы `protoc`.
-- [ ] Создан `easyp.yaml` с секциями `generate` и (опционально) `lint`, `breaking`.
-- [ ] Добавлены все внешние зависимости в `deps`.
-- [ ] Успешно выполнен `easyp mod update`.
-- [ ] `easyp generate` даёт идентичный или ожидаемо обновлённый результат.
-- [ ] `easyp lint` проходит без критичных ошибок (или ошибки обработаны).
-- [ ] `easyp breaking --against git-ref=origin/main` не выдаёт неожиданных блокирующих нарушений.
-- [ ] CI обновлён (заменены прямые вызовы `protoc`).
-- [ ] Документация проекта обновлена (README: как генерировать).
-
-## 13. Дополнительные рекомендации
-
-- Сначала мигрируйте один сервис / пакет — снизит риск массовых конфликтов.
-- Закоммитьте `easyp.yaml` отдельно, затем выполните генерацию и линт — проще ревью.
-- Если нужны разные наборы плагинов для разных микросервисов — используйте несколько конфигов (например: `easyp.microservice-a.yaml` + `easyp.microservice-b.yaml`).
-- Внедрите проверку актуальности генерации: шаг CI, который валидирует отсутствие diff после `easyp generate`.
-
-## 14. Статус
-
-Этот файл — русская расширенная версия, заменяющая placeholder “Work in progress”. При появлении новых возможностей EasyP (дополнительные поля в конфиге, новые плагины, расширения breaking‑проверок) обновите соответствующие разделы.
-
----
-
-Если нужен упрощённый вариант (только перевод без расширения), сообщи — могу сократить до минимальных двух блоков.
diff --git a/docs/public/docs/ru-guide/migration/protolock.md b/docs/public/docs/ru-guide/migration/protolock.md
deleted file mode 100644
index 9907d004..00000000
--- a/docs/public/docs/ru-guide/migration/protolock.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Protolock
-
-## В процессе разработки
\ No newline at end of file
diff --git a/docs/public/docs/ru-guide/migration/prototool.md b/docs/public/docs/ru-guide/migration/prototool.md
deleted file mode 100644
index 28082a85..00000000
--- a/docs/public/docs/ru-guide/migration/prototool.md
+++ /dev/null
@@ -1,238 +0,0 @@
-# Prototool
-
-## Состояние
-Этот раздел был помечен как “Work in progress” в оригинальной английской версии. Ниже — переведённое и дополненное практическое руководство по миграции с Prototool на EasyP. Имя инструмента Prototool не переводится.
-
----
-
-## Цель миграции
-Перейти от конфигурации и рабочих процессов Prototool к эквиваленту на EasyP с минимальными изменениями, сохранив:
-- Линтинг .proto файлов.
-- Генерацию кода через protoc-плагины.
-- Управление зависимостями.
-- Проверку несовместимых изменений (в Prototool это приходилось реализовывать внешними инструментами; в EasyP встроено).
-
----
-
-## Кратко о различиях
-
-| Область | Prototool | EasyP | Комментарий |
-|---------|-----------|-------|-------------|
-| Конфигурация | `prototool.yaml` | `easyp.yaml` | Форматы YAML/JSON поддерживаются; структура отличается. |
-| Линтинг | Встроенные наборы + кастомные правила | Наборы через `lint.use`, тонкая настройка ignore/except | EasyP даёт больше гибкости группировки. |
-| Генерация | Раздел `generate` + плагины через Docker/локально | `generate.plugins` (локальные/WASM/удалённые) | EasyP может выполнять плагины удалённо (API Service). |
-| Зависимости | Обычно через include-пути / внешние git clone вручную | Секция `deps` (Git репозитории) + `mod update` | Более декларативно. |
-| Breaking Changes | Нет встроенного механизма | Секция `breaking` + команда `easyp breaking` | Из коробки. |
-| Lock-in | Зависимость от модели Prototool | Минималистичный формат, «любой Git — пакет» | Облегчает выход / интеграцию с другими экосистемами. |
-
----
-
-## Типовая структура Prototool (упрощённо)
-
-```yaml
-# prototool.yaml (пример)
-protoc:
-  include_paths:
-    - api
-    - third_party
-lint:
-  group: basic
-  rules:
-    add:
-      - ENUM_VALUE_PREFIX
-generate:
-  plugins:
-    - name: go
-      out: gen/go
-    - name: go-grpc
-      out: gen/go
-```
-
-Особенности:
-- `include_paths` задаёт пути поиска импортов.
-- `lint.group` + `rules.add/remove` регулируют активные проверки.
-- `generate.plugins` описывает плагины для protoc.
-
----
-
-## Эквивалент на EasyP
-
-```yaml
-# easyp.yaml (пример)
-deps:
-  - github.com/org/common-protos         # вместо manual include
-  - github.com/org/third-party-protos
-
-lint:
-  use:
-    - MINIMAL
-    - BASIC
-  enum_zero_value_suffix: "_NONE"
-  service_suffix: "Service"
-  ignore:
-    - COMMENT_FIELD
-  except:
-    - ENUM_VALUE_PREFIX
-  allow_comment_ignores: true
-
-generate:
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: gen/go
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-
-breaking:
-  against_git_ref: main
-  ignore:
-    - FIELD_SAME_TYPE
-```
-
-Комментарии:
-- `deps` заменяет необходимость вручную прописывать include paths: EasyP подтянет их через git.
-- `lint.use` активирует наборы правил (MINIMAL/BASIC/DEFAULT и т.д.).
-- Дополнительные настройки (`enum_zero_value_suffix`, `service_suffix`) задают политики нейминга.
-- `breaking` позволяет сразу контролировать несовместимые изменения.
-
----
-
-## Шаги миграции
-
-1. Инвентаризация:
-   - Соберите текущий `prototool.yaml`, списки include paths и плагины.
-   - Зафиксируйте используемые кастомные правила, если есть.
-
-2. Зависимости:
-   - Любые каталоги, которые вы вручную добавляли в `include_paths`, преобразуйте в git-репозитории (если ещё нет).
-   - Добавьте их в `deps` (формат: `github.com/owner/repo` или путь к вашей приватной системе Git).
-
-3. Линтинг:
-   - Определите какой group использовался (`basic`, `default`, …) → сопоставьте с наборами EasyP (`MINIMAL`, `BASIC`, `DEFAULT`).
-   - Индивидуальные добавления (`rules.add`) перенесите в `lint.use` или `except`/`ignore`:
-     - Если правило нужно активировать — включите через набор или явно.
-     - Если нужно отключить — добавьте в `ignore`.
-
-4. Генерация:
-   - Сохраните список плагинов. В большинстве случаев имена совпадут (`go`, `go-grpc`, др.).
-   - Если раньше использовали Docker-окружение Prototool — проверьте поддержку удалённых плагинов через API Service EasyP (опционально).
-   - Перепишите в секцию `generate.plugins`.
-
-5. Дополнительные опции:
-   - Настройки нейминга enum/service перенести в `enum_zero_value_suffix`, `service_suffix`.
-   - Если были внешние скрипты для проверки breaking changes — удалите их и включите `breaking` с `against_git_ref`.
-
-6. Верификация:
-   - Запустите: `easyp mod update` (скачивание deps).
-   - Затем: `easyp lint`.
-   - Далее: `easyp generate`.
-   - И, если нужно: `easyp breaking --against git-ref=origin/main`.
-
-7. CI/CD:
-   - Обновите workflow (GitHub Actions / GitLab) — замените вызовы Prototool на EasyP команды.
-   - Добавьте шаг проверки несовместимых изменений.
-
----
-
-## Сопоставление правил (общая идея)
-
-| Prototool концепт | EasyP |
-|-------------------|------|
-| lint.group        | lint.use (наборы) |
-| rules.add/remove  | except / ignore |
-| include_paths     | deps (git источники) |
-| plugins           | generate.plugins |
-| (внешние скрипты для breaking) | breaking секция + команда |
-
----
-
-## Приватные репозитории
-
-Если ранее Prototool просто видел локальные каталоги, теперь:
-- Добавьте SSH ключи/токены в CI для доступа к приватным Git.
-- Укажите их в `deps` как обычные git-URL (формат зависит от реализации EasyP; для публичных — стандартный).
-
----
-
-## Типовые проблемы при миграции
-
-| Проблема | Причина | Решение |
-|----------|---------|---------|
-| Правила линтера не совпадают | Неверное сопоставление групп | Проверить документацию EasyP по наборам правил |
-| Импорты не находятся | Забыли добавить репозиторий в deps | Добавить в `deps` и выполнить `easyp mod update` |
-| Генерация падает на опциях | Плагин требует другие flags | Проверить `opts` и документацию плагина |
-| breaking сообщает слишком много | Слишком строгий базовый набор | Добавить конкретные правила в `breaking.ignore` |
-| Долгая генерация | Нет кеша/много deps | Включить кэширование в CI (vendor/.easyp/deps) |
-
----
-
-## Минимальная конфигурация после миграции
-
-```yaml
-lint:
-  use:
-    - MINIMAL
-generate:
-  plugins:
-    - name: go
-      out: gen/go
-      opts:
-        paths: source_relative
-breaking:
-  against_git_ref: main
-```
-
----
-
-## Рекомендации по упрощению
-
-- Начните с минимального `lint.use` (MINIMAL), затем постепенно включайте дополнительные наборы.
-- Не переносите слепо все ignore — часть правил может уже быть улучшена в EasyP.
-- Сначала настроить deps и генерацию, затем усложнять линт/нейминг.
-- Фиксируйте миграцию по шагам (коммиты: deps → lint → generate → breaking → CI).
-
----
-
-## Проверка результата
-
-Скрипт локальной быстрой проверки (пример):
-
-```bash
-#!/usr/bin/env bash
-set -euo pipefail
-
-echo "[1] deps update"
-easyp mod update
-
-echo "[2] lint"
-easyp lint
-
-echo "[3] breaking vs main"
-easyp breaking --against git-ref=origin/main || echo "Breaking changes detected (review needed)"
-
-echo "[4] generate"
-easyp generate
-
-echo "Done."
-```
-
----
-
-## Заключение
-
-Миграция с Prototool на EasyP сводится к:
-1. Переносу путей и внешних каталогов в декларативные `deps`.
-2. Переформатированию линта под `lint.use` + `ignore/except`.
-3. Переносу генерации в `generate.plugins`.
-4. Добавлению встроенного механизма `breaking`.
-5. Адаптации CI.
-
-После этого конфигурация становится более прозрачной, а проверка несовместимых изменений — из коробки.
-
----
-
-*Готово: базовый перевод и расширенное руководство по миграции с Prototool на EasyP.*
\ No newline at end of file
diff --git a/docs/public/favicon-16.png b/docs/public/favicon-16.png
deleted file mode 100644
index ea5395c6..00000000
Binary files a/docs/public/favicon-16.png and /dev/null differ
diff --git a/docs/public/favicon-16.svg b/docs/public/favicon-16.svg
deleted file mode 100644
index 714459df..00000000
--- a/docs/public/favicon-16.svg
+++ /dev/null
@@ -1,20 +0,0 @@
-<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <defs>
-    <linearGradient id="favicon16Gradient" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#60a5fa"/>
-      <stop offset="100%" style="stop-color:#3b82f6"/>
-    </linearGradient>
-  </defs>
-
-  <!-- Background -->
-  <rect width="16" height="16" rx="3" fill="#1e293b"/>
-
-  <!-- Letter E -->
-  <path d="M2 3h5v1.5h-2.5v1.5h2v1.5h-2v1.5H7V13H2V3z" fill="url(#favicon16Gradient)"/>
-
-  <!-- Letter P -->
-  <path d="M8.5 3h3c.8 0 1.5.7 1.5 1.5v1c0 .8-.7 1.5-1.5 1.5h-1.5V13h-1V3zm1 1.5v1.5h1.5c.3 0 .5-.2.5-.5v-.5c0-.3-.2-.5-.5-.5h-1.5z" fill="url(#favicon16Gradient)"/>
-
-  <!-- Accent dot -->
-  <circle cx="13" cy="3" r="1" fill="#60a5fa" opacity="0.9"/>
-</svg>
diff --git a/docs/public/favicon-32.png b/docs/public/favicon-32.png
deleted file mode 100644
index 54b6368c..00000000
Binary files a/docs/public/favicon-32.png and /dev/null differ
diff --git a/docs/public/favicon-512.png b/docs/public/favicon-512.png
deleted file mode 100644
index 24ff37cc..00000000
Binary files a/docs/public/favicon-512.png and /dev/null differ
diff --git a/docs/public/favicon.icns b/docs/public/favicon.icns
deleted file mode 100644
index 125fb672..00000000
Binary files a/docs/public/favicon.icns and /dev/null differ
diff --git a/docs/public/favicon.ico b/docs/public/favicon.ico
deleted file mode 100644
index 54b6368c..00000000
Binary files a/docs/public/favicon.ico and /dev/null differ
diff --git a/docs/public/favicon.svg b/docs/public/favicon.svg
deleted file mode 100644
index fe3a1ed4..00000000
--- a/docs/public/favicon.svg
+++ /dev/null
@@ -1,21 +0,0 @@
-<svg width="32" height="32" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <defs>
-    <linearGradient id="faviconGradient" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#60a5fa"/>
-      <stop offset="100%" style="stop-color:#3b82f6"/>
-    </linearGradient>
-  </defs>
-
-  <!-- Background -->
-  <rect width="32" height="32" rx="6" fill="#1e293b"/>
-  <rect width="32" height="32" rx="6" fill="url(#faviconGradient)" opacity="0.15"/>
-
-  <!-- Letter E -->
-  <path d="M8 9h8v3h-5v3h4v3h-4v3h5v3H8V9z" fill="url(#faviconGradient)"/>
-
-  <!-- Letter P -->
-  <path d="M17 9h6c1.5 0 3 1 3 3v1c0 2-1.5 3-3 3h-3v5h-3V9zm3 4h2c.5 0 1-.5 1-1s-.5-1-1-1h-2v2z" fill="url(#faviconGradient)"/>
-
-  <!-- Accent dot -->
-  <circle cx="27" cy="5" r="2" fill="#60a5fa" opacity="0.8"/>
-</svg>
diff --git a/docs/public/icon-192.png b/docs/public/icon-192.png
deleted file mode 100644
index f6750e43..00000000
Binary files a/docs/public/icon-192.png and /dev/null differ
diff --git a/docs/public/icon-512.png b/docs/public/icon-512.png
deleted file mode 100644
index 24ff37cc..00000000
Binary files a/docs/public/icon-512.png and /dev/null differ
diff --git a/docs/public/search/index.en.json b/docs/public/search/index.en.json
deleted file mode 100644
index 06b951b8..00000000
--- a/docs/public/search/index.en.json
+++ /dev/null
@@ -1 +0,0 @@
-[{"id":"api-service/overview::top::0","title":"API Service Overview","path":"/docs/guide/api-service/overview","headings":[],"excerpt":"**Centralized protobuf plugin execution service for consistent, isolated code generation**","content":"**Centralized protobuf plugin execution service for consistent, isolated code generation**"},{"id":"api-service/overview::top::1","title":"API Service Overview","path":"/docs/guide/api-service/overview","headings":[],"excerpt":"The EasyP API Service eliminates plugin management chaos by providing centralized execution of protobuf/gRPC plugins as isolated Docker containers. It offers a unified platform for teams to standardize their code generat","content":"The EasyP API Service eliminates plugin management chaos by providing centralized execution of protobuf/gRPC plugins as isolated Docker containers. It offers a unified platform for teams to standardize their code generation workflows without the operational overhead of managing plugins across individual developer machines."},{"id":"api-service/overview::the-challenge::2","title":"API Service Overview","section":"The Challenge","path":"/docs/guide/api-service/overview#the-challenge","headings":["The Challenge"],"excerpt":"The Challenge Managing protobuf/gRPC code generation across development teams creates significant operational complexity:","content":"The Challenge Managing protobuf/gRPC code generation across development teams creates significant operational complexity:"},{"id":"api-service/overview::version-inconsistencies::3","title":"API Service Overview","section":"Version Inconsistencies","path":"/docs/guide/api-service/overview#version-inconsistencies","headings":["Version Inconsistencies"],"excerpt":"Version Inconsistencies Developers use different plugin versions locally, causing build failures and inconsistent generated code \"Works on my machine\" syndrome when generated code differs between environments Manual coor","content":"Version Inconsistencies Developers use different plugin versions locally, causing build failures and inconsistent generated code \"Works on my machine\" syndrome when generated code differs between environments Manual coordination required to keep entire teams synchronized on plugin versions"},{"id":"api-service/overview::operational-overhead::4","title":"API Service Overview","section":"Operational Overhead","path":"/docs/guide/api-service/overview#operational-overhead","headings":["Operational Overhead"],"excerpt":"Operational Overhead DevOps teams spend significant time managing plugin installations across developer machines Each new team member requires manual setup of correct plugin versions Plugin updates require coordinating w","content":"Operational Overhead DevOps teams spend significant time managing plugin installations across developer machines Each new team member requires manual setup of correct plugin versions Plugin updates require coordinating with every developer individually No centralized control over which plugin versions are approved for use"},{"id":"api-service/overview::security-compliance-risks::5","title":"API Service Overview","section":"Security & Compliance Risks","path":"/docs/guide/api-service/overview#security-compliance-risks","headings":["Security & Compliance Risks"],"excerpt":"Security & Compliance Risks Developers install plugins from various sources without security validation No audit trail of which plugins were used for which builds Difficult to enforce security policies on code generation","content":"Security & Compliance Risks Developers install plugins from various sources without security validation No audit trail of which plugins were used for which builds Difficult to enforce security policies on code generation tools"},{"id":"api-service/overview::the-solution-centralized-plugin-execution::6","title":"API Service Overview","section":"The Solution: Centralized Plugin Execution","path":"/docs/guide/api-service/overview#the-solution-centralized-plugin-execution","headings":["The Solution: Centralized Plugin Execution"],"excerpt":"The Solution: Centralized Plugin Execution EasyP API Service eliminates these operational headaches by centralizing plugin management:","content":"The Solution: Centralized Plugin Execution EasyP API Service eliminates these operational headaches by centralizing plugin management:"},{"id":"api-service/overview::the-solution-centralized-plugin-execution::7","title":"API Service Overview","section":"The Solution: Centralized Plugin Execution","path":"/docs/guide/api-service/overview#the-solution-centralized-plugin-execution","headings":["The Solution: Centralized Plugin Execution"],"excerpt":"The Solution: Centralized Plugin Execution Challenge Solution ----------- ---------- **Version Control** Deploy new plugin versions to entire team instantly via Docker images **Operations** Operations team controls plugi","content":"The Solution: Centralized Plugin Execution Challenge Solution ----------- ---------- **Version Control** Deploy new plugin versions to entire team instantly via Docker images **Operations** Operations team controls plugin configurations without touching developer machines **Security** All plugins run in isolated Docker containers with resource constraints **Consistency** Consistent execution environment regardless of developer's local setup **Developer Experience** No local plugin installation or maintenance required"},{"id":"api-service/overview::architecture-overview::8","title":"API Service Overview","section":"Architecture Overview","path":"/docs/guide/api-service/overview#architecture-overview","headings":["Architecture Overview"],"excerpt":"Architecture Overview The EasyP API Service uses a streamlined architecture focused on reliable plugin execution:","content":"Architecture Overview The EasyP API Service uses a streamlined architecture focused on reliable plugin execution:"},{"id":"api-service/overview::api-layer::9","title":"API Service Overview","section":"API Layer","path":"/docs/guide/api-service/overview#api-layer","headings":["API Layer"],"excerpt":"API Layer **gRPC Server**: Primary API for code generation requests Each plugin execution is a separate gRPC request Receives CodeGeneratorRequest from CLI","content":"API Layer **gRPC Server**: Primary API for code generation requests Each plugin execution is a separate gRPC request Receives CodeGeneratorRequest from CLI"},{"id":"api-service/overview::execution-engine::10","title":"API Service Overview","section":"Execution Engine","path":"/docs/guide/api-service/overview#execution-engine","headings":["Execution Engine"],"excerpt":"Execution Engine **Docker Runtime**: Isolated container execution for plugins Pulls plugin images from public Docker registries (Docker Hub, etc.) Enforces resource limits (CPU, memory) per plugin","content":"Execution Engine **Docker Runtime**: Isolated container execution for plugins Pulls plugin images from public Docker registries (Docker Hub, etc.) Enforces resource limits (CPU, memory) per plugin"},{"id":"api-service/overview::storage-layer::11","title":"API Service Overview","section":"Storage Layer","path":"/docs/guide/api-service/overview#storage-layer","headings":["Storage Layer"],"excerpt":"Storage Layer **PostgreSQL**: Stores plugin execution parameters - Resource limits (CPU, memory allocation) - Plugin configuration and metadata - Execution logs for auditing - _Note: Storage capabilities will be expanded","content":"Storage Layer **PostgreSQL**: Stores plugin execution parameters - Resource limits (CPU, memory allocation) - Plugin configuration and metadata - Execution logs for auditing - _Note: Storage capabilities will be expanded in future releases_"},{"id":"api-service/overview::monitoring::12","title":"API Service Overview","section":"Monitoring","path":"/docs/guide/api-service/overview#monitoring","headings":["Monitoring"],"excerpt":"Monitoring **Prometheus**: Metrics collection and monitoring Tracks execution times, success rates, and resource usage","content":"Monitoring **Prometheus**: Metrics collection and monitoring Tracks execution times, success rates, and resource usage"},{"id":"api-service/overview::local-execution-easyp-cli::13","title":"API Service Overview","section":"Local Execution (EasyP CLI)","path":"/docs/guide/api-service/overview#local-execution-easyp-cli","headings":["Local Execution (EasyP CLI)"],"excerpt":"Local Execution (EasyP CLI) When running locally, the EasyP CLI supports: **Installed plugins**: System-installed protoc plugins **WASM plugins**: Fast, lightweight WebAssembly plugins","content":"Local Execution (EasyP CLI) When running locally, the EasyP CLI supports: **Installed plugins**: System-installed protoc plugins **WASM plugins**: Fast, lightweight WebAssembly plugins"},{"id":"api-service/overview::remote-execution-api-service::14","title":"API Service Overview","section":"Remote Execution (API Service)","path":"/docs/guide/api-service/overview#remote-execution-api-service","headings":["Remote Execution (API Service)"],"excerpt":"Remote Execution (API Service) When using the API Service: **Docker only**: All plugins run as Docker containers **Centralized control**: Operations team manages available plugins **Consistent environment**: Same executi","content":"Remote Execution (API Service) When using the API Service: **Docker only**: All plugins run as Docker containers **Centralized control**: Operations team manages available plugins **Consistent environment**: Same execution environment for all developers"},{"id":"api-service/overview::execution-steps::15","title":"API Service Overview","section":"Execution Steps","path":"/docs/guide/api-service/overview#execution-steps","headings":["Execution Steps"],"excerpt":"Execution Steps **CLI Parsing**: CLI parses protobuf files locally **Request Sending**: CLI sends CodeGeneratorRequest to API Service (one request per plugin) **Parameter Lookup**: API Service fetches plugin execution pa","content":"Execution Steps **CLI Parsing**: CLI parses protobuf files locally **Request Sending**: CLI sends CodeGeneratorRequest to API Service (one request per plugin) **Parameter Lookup**: API Service fetches plugin execution parameters from PostgreSQL **Docker Execution**: API Service runs plugin in isolated Docker container **Metrics Recording**: Execution metrics are recorded (at end of request) **Response**: Generated code is returned to CLI"},{"id":"api-service/overview::key-features::16","title":"API Service Overview","section":"Key Features","path":"/docs/guide/api-service/overview#key-features","headings":["Key Features"],"excerpt":"Key Features Feature Description --------- ------------- **🐳 Plugin Isolation** Each plugin runs in a secure, isolated Docker container **⚙️ Resource Control** CPU and memory limits enforced per plugin **📊 Metrics & Mo","content":"Key Features Feature Description --------- ------------- **🐳 Plugin Isolation** Each plugin runs in a secure, isolated Docker container **⚙️ Resource Control** CPU and memory limits enforced per plugin **📊 Metrics & Monitoring** Prometheus metrics for all operations **🔄 Version Management** Centralized plugin version control via Docker images **⚡ Simple Protocol** Standard CodeGeneratorRequest/Response protocol **🔒 Security First** Container isolation with resource constraints"},{"id":"api-service/overview::configuration::17","title":"API Service Overview","section":"Configuration","path":"/docs/guide/api-service/overview#configuration","headings":["Configuration"],"excerpt":"Configuration The service is configured via environment variables:","content":"Configuration The service is configured via environment variables:"},{"id":"api-service/overview::plugin-parameters-storage::18","title":"API Service Overview","section":"Plugin Parameters Storage","path":"/docs/guide/api-service/overview#plugin-parameters-storage","headings":["Plugin Parameters Storage"],"excerpt":"Plugin Parameters Storage PostgreSQL stores execution parameters for each plugin:","content":"Plugin Parameters Storage PostgreSQL stores execution parameters for each plugin:"},{"id":"api-service/overview::plugin-parameters-storage::19","title":"API Service Overview","section":"Plugin Parameters Storage","path":"/docs/guide/api-service/overview#plugin-parameters-storage","headings":["Plugin Parameters Storage"],"excerpt":"Plugin Parameters Storage ::: tip The storage schema and capabilities will be expanded in future releases to support additional features like audit logging, usage analytics, and plugin caching. :::","content":"Plugin Parameters Storage ::: tip The storage schema and capabilities will be expanded in future releases to support additional features like audit logging, usage analytics, and plugin caching. :::"},{"id":"api-service/overview::integration-with-easyp-cli::20","title":"API Service Overview","section":"Integration with EasyP CLI","path":"/docs/guide/api-service/overview#integration-with-easyp-cli","headings":["Integration with EasyP CLI"],"excerpt":"Integration with EasyP CLI Configure your easyp.yaml to use remote plugin execution:","content":"Integration with EasyP CLI Configure your easyp.yaml to use remote plugin execution:"},{"id":"api-service/overview::integration-with-easyp-cli::21","title":"API Service Overview","section":"Integration with EasyP CLI","path":"/docs/guide/api-service/overview#integration-with-easyp-cli","headings":["Integration with EasyP CLI"],"excerpt":"Integration with EasyP CLI Then generate code:","content":"Integration with EasyP CLI Then generate code:"},{"id":"api-service/overview::integration-with-easyp-cli::22","title":"API Service Overview","section":"Integration with EasyP CLI","path":"/docs/guide/api-service/overview#integration-with-easyp-cli","headings":["Integration with EasyP CLI"],"excerpt":"Integration with EasyP CLI The CLI will: Parse your protobuf files Send separate requests to API Service for each plugin Receive generated code responses Write generated files to specified output directories","content":"Integration with EasyP CLI The CLI will: Parse your protobuf files Send separate requests to API Service for each plugin Receive generated code responses Write generated files to specified output directories"},{"id":"api-service/overview::available-metrics::23","title":"API Service Overview","section":"Available Metrics","path":"/docs/guide/api-service/overview#available-metrics","headings":["Available Metrics"],"excerpt":"Available Metrics Prometheus metrics exposed by the service:","content":"Available Metrics Prometheus metrics exposed by the service:"},{"id":"api-service/overview::available-metrics::24","title":"API Service Overview","section":"Available Metrics","path":"/docs/guide/api-service/overview#available-metrics","headings":["Available Metrics"],"excerpt":"Available Metrics Metric Description -------- ------------- easyp_api_service_api_grpc_server_handled_total Total gRPC requests by status code easyp_api_service_api_grpc_server_handling_seconds gRPC request latency histo","content":"Available Metrics Metric Description -------- ------------- easyp_api_service_api_grpc_server_handled_total Total gRPC requests by status code easyp_api_service_api_grpc_server_handling_seconds gRPC request latency histogram easyp_api_service_generated_plugin_code_total Plugin executions by plugin name easyp_api_service_repo_call_duration_seconds Database query latency easyp_api_service_repo_errors_total Database errors count easyp_api_service_standard_panics_total Recovered panics count"},{"id":"api-service/overview::performance-characteristics::25","title":"API Service Overview","section":"Performance Characteristics","path":"/docs/guide/api-service/overview#performance-characteristics","headings":["Performance Characteristics"],"excerpt":"Performance Characteristics Metric Typical Value Notes -------- --------------- ------- **Cold Start** 2-5 seconds First time pulling plugin image **Warm Start** 100-500ms Plugin image cached by Docker **Throughput** 20-","content":"Performance Characteristics Metric Typical Value Notes -------- --------------- ------- **Cold Start** 2-5 seconds First time pulling plugin image **Warm Start** 100-500ms Plugin image cached by Docker **Throughput** 20-50 concurrent Depends on available resources **Memory Usage** 50-200MB Per plugin execution"},{"id":"api-service/overview::container-isolation::26","title":"API Service Overview","section":"Container Isolation","path":"/docs/guide/api-service/overview#container-isolation","headings":["Container Isolation"],"excerpt":"Container Isolation Each plugin runs in a separate, ephemeral container No network access during plugin execution Resource limits (CPU, memory) enforced via Docker Containers destroyed after execution","content":"Container Isolation Each plugin runs in a separate, ephemeral container No network access during plugin execution Resource limits (CPU, memory) enforced via Docker Containers destroyed after execution"},{"id":"api-service/overview::api-security::27","title":"API Service Overview","section":"API Security","path":"/docs/guide/api-service/overview#api-security","headings":["API Security"],"excerpt":"API Security gRPC-based communication Support for authentication tokens (production deployments) Input validation for all requests Execution audit logs stored in PostgreSQL","content":"API Security gRPC-based communication Support for authentication tokens (production deployments) Input validation for all requests Execution audit logs stored in PostgreSQL"},{"id":"api-service/overview::scalability::28","title":"API Service Overview","section":"Scalability","path":"/docs/guide/api-service/overview#scalability","headings":["Scalability"],"excerpt":"Scalability **Horizontal scaling**: Deploy multiple service instances behind load balancer **Resource management**: Configure appropriate CPU/memory limits per plugin **Database**: PostgreSQL can be replicated for high a","content":"Scalability **Horizontal scaling**: Deploy multiple service instances behind load balancer **Resource management**: Configure appropriate CPU/memory limits per plugin **Database**: PostgreSQL can be replicated for high availability"},{"id":"api-service/overview::monitoring::29","title":"API Service Overview","section":"Monitoring","path":"/docs/guide/api-service/overview#monitoring","headings":["Monitoring"],"excerpt":"Monitoring **Prometheus metrics**: Monitor all aspects of service health **Alerting**: Set up alerts for high error rates or slow execution **Logs**: Structured logging for debugging and audit trails","content":"Monitoring **Prometheus metrics**: Monitor all aspects of service health **Alerting**: Set up alerts for high error rates or slow execution **Logs**: Structured logging for debugging and audit trails"},{"id":"api-service/overview::future-enhancements::30","title":"API Service Overview","section":"Future Enhancements","path":"/docs/guide/api-service/overview#future-enhancements","headings":["Future Enhancements"],"excerpt":"Future Enhancements The API Service is actively developed with planned features including: Plugin result caching for faster repeated executions Enhanced audit logging and usage analytics Support for custom plugin registr","content":"Future Enhancements The API Service is actively developed with planned features including: Plugin result caching for faster repeated executions Enhanced audit logging and usage analytics Support for custom plugin registries Advanced resource scheduling and optimization"},{"id":"api-service/overview::community-and-support::31","title":"API Service Overview","section":"Community and Support","path":"/docs/guide/api-service/overview#community-and-support","headings":["Community and Support"],"excerpt":"Community and Support **💬 Telegram Chat** - Community discussion **🐛 GitHub Issues** - Bug reports and features **📖 Documentation** - Complete documentation","content":"Community and Support **💬 Telegram Chat** - Community discussion **🐛 GitHub Issues** - Bug reports and features **📖 Documentation** - Complete documentation"},{"id":"api-service/overview::community-and-support::32","title":"API Service Overview","section":"Community and Support","path":"/docs/guide/api-service/overview#community-and-support","headings":["Community and Support"],"excerpt":"Community and Support *Simplify your protobuf workflows with centralized plugin execution*","content":"Community and Support *Simplify your protobuf workflows with centralized plugin execution*"},{"id":"ci-cd/github-actions::top::0","title":"Github Actions","path":"/docs/guide/ci-cd/github-actions","headings":[],"excerpt":"Github Actions Work in progress","content":"Github Actions Work in progress"},{"id":"ci-cd/gitlab::top::0","title":"Gitlab","path":"/docs/guide/ci-cd/gitlab","headings":[],"excerpt":"Gitlab Work in progress","content":"Gitlab Work in progress"},{"id":"cli/auto-completion/auto-completion::zsh-auto-completion::0","title":"Auto completion","section":"zsh auto-completion","path":"/docs/guide/cli/auto-completion/auto-completion#zsh-auto-completion","headings":["zsh auto-completion"],"excerpt":"zsh auto-completion Add the following line to your ~/.zshrc startup script:","content":"zsh auto-completion Add the following line to your ~/.zshrc startup script:"},{"id":"cli/auto-completion/auto-completion::zsh-auto-completion::1","title":"Auto completion","section":"zsh auto-completion","path":"/docs/guide/cli/auto-completion/auto-completion#zsh-auto-completion","headings":["zsh auto-completion"],"excerpt":"zsh auto-completion Re-launch your shell or run:","content":"zsh auto-completion Re-launch your shell or run:"},{"id":"cli/auto-completion/auto-completion::bash-auto-completion::2","title":"Auto completion","section":"Bash auto-completion","path":"/docs/guide/cli/auto-completion/auto-completion#bash-auto-completion","headings":["Bash auto-completion"],"excerpt":"Bash auto-completion Install bash-completion and add the software to your ~/.bashrc. Add the following line to your ~/.bashrc startup script:","content":"Bash auto-completion Install bash-completion and add the software to your ~/.bashrc. Add the following line to your ~/.bashrc startup script:"},{"id":"cli/auto-completion/auto-completion::bash-auto-completion::3","title":"Auto completion","section":"Bash auto-completion","path":"/docs/guide/cli/auto-completion/auto-completion#bash-auto-completion","headings":["Bash auto-completion"],"excerpt":"Bash auto-completion Re-launch your shell or run:","content":"Bash auto-completion Re-launch your shell or run:"},{"id":"cli/breaking-changes/breaking-changes::top::0","title":"Breaking Changes Detection","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":[],"excerpt":"EasyP's breaking changes detection helps you maintain backward compatibility in your protobuf APIs by automatically identifying changes that could break existing clients. This is crucial for maintaining stable APIs in pr","content":"EasyP's breaking changes detection helps you maintain backward compatibility in your protobuf APIs by automatically identifying changes that could break existing clients. This is crucial for maintaining stable APIs in production environments."},{"id":"cli/breaking-changes/breaking-changes::overview::1","title":"Breaking Changes Detection","section":"Overview","path":"/docs/guide/cli/breaking-changes/breaking-changes#overview","headings":["Overview"],"excerpt":"Overview The breaking changes checker compares your current protobuf files against a previous version (typically from another Git branch) and identifies modifications that could cause compatibility issues for existing cl","content":"Overview The breaking changes checker compares your current protobuf files against a previous version (typically from another Git branch) and identifies modifications that could cause compatibility issues for existing clients."},{"id":"cli/breaking-changes/breaking-changes::key-features::2","title":"Breaking Changes Detection","section":"Key Features","path":"/docs/guide/cli/breaking-changes/breaking-changes#key-features","headings":["Key Features"],"excerpt":"Key Features **Git-based Comparison**: Compare against any Git reference (branch, tag, or commit) **Comprehensive Analysis**: Checks services, messages, enums, fields, and imports **Selective Ignore**: Skip specific dire","content":"Key Features **Git-based Comparison**: Compare against any Git reference (branch, tag, or commit) **Comprehensive Analysis**: Checks services, messages, enums, fields, and imports **Selective Ignore**: Skip specific directories from breaking change analysis **Detailed Reports**: Clear error messages with file locations and line numbers"},{"id":"cli/breaking-changes/breaking-changes::how-it-works::3","title":"Breaking Changes Detection","section":"How It Works","path":"/docs/guide/cli/breaking-changes/breaking-changes#how-it-works","headings":["How It Works"],"excerpt":"How It Works The breaking changes detector follows this process:","content":"How It Works The breaking changes detector follows this process:"},{"id":"cli/breaking-changes/breaking-changes::how-it-works::4","title":"Breaking Changes Detection","section":"How It Works","path":"/docs/guide/cli/breaking-changes/breaking-changes#how-it-works","headings":["How It Works"],"excerpt":"How It Works **Checkout Comparison Branch**: Retrieves proto files from the specified Git reference **Parse Both Versions**: Analyzes current and previous proto file structures **Compare Entities**: Systematically checks","content":"How It Works **Checkout Comparison Branch**: Retrieves proto files from the specified Git reference **Parse Both Versions**: Analyzes current and previous proto file structures **Compare Entities**: Systematically checks all protobuf elements for breaking changes **Generate Report**: Produces detailed issue reports with locations and descriptions"},{"id":"cli/breaking-changes/breaking-changes::detection-level::5","title":"Breaking Changes Detection","section":"Detection Level","path":"/docs/guide/cli/breaking-changes/breaking-changes#detection-level","headings":["Detection Level"],"excerpt":"Detection Level EasyP implements **WIRE+ level** breaking change detection: ✅ **Full wire format compatibility** - ensures old and new versions can exchange data ✅ **Element deletion detection** - catches deleted service","content":"Detection Level EasyP implements **WIRE+ level** breaking change detection: ✅ **Full wire format compatibility** - ensures old and new versions can exchange data ✅ **Element deletion detection** - catches deleted services, messages, fields, etc. ✅ **Type safety** - detects incompatible type changes ❌ **Field/method renames** - currently not detected (planned for future releases) ❌ **File-level changes** - package moves, file options not checked yet"},{"id":"cli/breaking-changes/breaking-changes::detection-level::6","title":"Breaking Changes Detection","section":"Detection Level","path":"/docs/guide/cli/breaking-changes/breaking-changes#detection-level","headings":["Detection Level"],"excerpt":"Detection Level This provides strong compatibility guarantees while being less strict than some tools that check generated code compatibility.","content":"Detection Level This provides strong compatibility guarantees while being less strict than some tools that check generated code compatibility."},{"id":"cli/breaking-changes/breaking-changes::configuration::7","title":"Breaking Changes Detection","section":"Configuration","path":"/docs/guide/cli/breaking-changes/breaking-changes#configuration","headings":["Configuration"],"excerpt":"Configuration Configure breaking changes detection in your easyp.yaml:","content":"Configuration Configure breaking changes detection in your easyp.yaml:"},{"id":"cli/breaking-changes/breaking-changes::configuration::8","title":"Breaking Changes Detection","section":"Configuration","path":"/docs/guide/cli/breaking-changes/breaking-changes#configuration","headings":["Configuration"],"excerpt":"Configuration ```yaml breaking: # Git reference to compare against (branch, tag, or commit hash) against_git_ref: \"main\" # Directories to ignore during breaking changes analysis ignore: - \"experimental\" - \"internal/proto","content":"Configuration ```yaml breaking: # Git reference to compare against (branch, tag, or commit hash) against_git_ref: \"main\" # Directories to ignore during breaking changes analysis ignore: - \"experimental\" - \"internal/proto\" - \"vendor\""},{"id":"cli/breaking-changes/breaking-changes::configuration::9","title":"Breaking Changes Detection","section":"Configuration","path":"/docs/guide/cli/breaking-changes/breaking-changes#configuration","headings":["Configuration"],"excerpt":"Configuration Additional options to braking check use: - FILE ```","content":"Configuration Additional options to braking check use: - FILE ```"},{"id":"cli/breaking-changes/breaking-changes::configuration-options::10","title":"Breaking Changes Detection","section":"Configuration Options","path":"/docs/guide/cli/breaking-changes/breaking-changes#configuration-options","headings":["Configuration Options"],"excerpt":"Configuration Options Option Description Default Required ------------------- ---------------------------------------------- --------- ---------- against_git_ref Git reference to compare against \"master\" No ignore List o","content":"Configuration Options Option Description Default Required ------------------- ---------------------------------------------- --------- ---------- against_git_ref Git reference to compare against \"master\" No ignore List of directories to exclude from analysis [] No use List of braking check options [] No"},{"id":"cli/breaking-changes/breaking-changes::basic-usage::11","title":"Breaking Changes Detection","section":"Basic Usage","path":"/docs/guide/cli/breaking-changes/breaking-changes#basic-usage","headings":["Basic Usage"],"excerpt":"Basic Usage Compare current changes against the main branch:","content":"Basic Usage Compare current changes against the main branch:"},{"id":"cli/breaking-changes/breaking-changes::using-configuration-file::12","title":"Breaking Changes Detection","section":"Using Configuration File","path":"/docs/guide/cli/breaking-changes/breaking-changes#using-configuration-file","headings":["Using Configuration File"],"excerpt":"Using Configuration File With a custom configuration file:","content":"Using Configuration File With a custom configuration file:"},{"id":"cli/breaking-changes/breaking-changes::override-git-reference::13","title":"Breaking Changes Detection","section":"Override Git Reference","path":"/docs/guide/cli/breaking-changes/breaking-changes#override-git-reference","headings":["Override Git Reference"],"excerpt":"Override Git Reference Override the configured branch:","content":"Override Git Reference Override the configured branch:"},{"id":"cli/breaking-changes/breaking-changes::detection-level::14","title":"Breaking Changes Detection","section":"Detection Level","path":"/docs/guide/cli/breaking-changes/breaking-changes#detection-level","headings":["Detection Level"],"excerpt":"Detection Level EasyP currently implements **WIRE+ level** breaking change detection, which provides comprehensive wire format compatibility plus some generated code protections:","content":"Detection Level EasyP currently implements **WIRE+ level** breaking change detection, which provides comprehensive wire format compatibility plus some generated code protections:"},{"id":"cli/breaking-changes/breaking-changes::comparison-with-buf-categories::15","title":"Breaking Changes Detection","section":"Comparison with Buf Categories","path":"/docs/guide/cli/breaking-changes/breaking-changes#comparison-with-buf-categories","headings":["Comparison with Buf Categories"],"excerpt":"Comparison with Buf Categories Check Type Buf WIRE Buf WIRE_JSON Buf FILE EasyP Current ------------ ---------- --------------- ---------- --------------- **Element Deletions** Service deletion ❌ ❌ ✅ ✅ RPC method deletio","content":"Comparison with Buf Categories Check Type Buf WIRE Buf WIRE_JSON Buf FILE EasyP Current ------------ ---------- --------------- ---------- --------------- **Element Deletions** Service deletion ❌ ❌ ✅ ✅ RPC method deletion ❌ ❌ ✅ ✅ Message deletion ❌ ❌ ✅ ✅ Field deletion (by number) ✅ ✅ ✅ ✅ Enum deletion ❌ ❌ ✅ ✅ Enum value deletion ✅ ✅ ✅ ✅ OneOf deletion ❌ ❌ ✅ ✅ Import deletion ❌ ❌ ✅ ✅ **Type Changes** Field type change ✅ ✅ ✅ ✅ RPC request/response type ✅ ✅ ✅ ✅ Optional/required changes ✅ ✅ ✅ ✅ **Naming (Generated Code)** Field rename (same number) ❌ ✅ ✅ ❌ Enum value rename ❌ ✅ ✅ ✅ **File Structure** Package change ✅ ✅ ✅ ❌ File options (go_package, etc) ❌ ❌ ✅ ❌ Moving types between files ❌ ❌ ✅ ❌"},{"id":"cli/breaking-changes/breaking-changes::what-this-means::16","title":"Breaking Changes Detection","section":"What This Means","path":"/docs/guide/cli/breaking-changes/breaking-changes#what-this-means","headings":["What This Means"],"excerpt":"What This Means **✅ EasyP WILL detect:** All wire format breaking changes Deletion of services, methods, messages, fields Type changes that break serialization Enum value renames (same number, different name)","content":"What This Means **✅ EasyP WILL detect:** All wire format breaking changes Deletion of services, methods, messages, fields Type changes that break serialization Enum value renames (same number, different name)"},{"id":"cli/breaking-changes/breaking-changes::what-this-means::17","title":"Breaking Changes Detection","section":"What This Means","path":"/docs/guide/cli/breaking-changes/breaking-changes#what-this-means","headings":["What This Means"],"excerpt":"What This Means **❌ EasyP will NOT detect:** Field renames (same number, different name) Package name changes File option changes (go_package, java_package, etc.) Moving types between files in the same package","content":"What This Means **❌ EasyP will NOT detect:** Field renames (same number, different name) Package name changes File option changes (go_package, java_package, etc.) Moving types between files in the same package"},{"id":"cli/breaking-changes/breaking-changes::breaking-change-rules::18","title":"Breaking Changes Detection","section":"Breaking Change Rules","path":"/docs/guide/cli/breaking-changes/breaking-changes#breaking-change-rules","headings":["Breaking Change Rules"],"excerpt":"Breaking Change Rules EasyP detects the following types of breaking changes:","content":"Breaking Change Rules EasyP detects the following types of breaking changes:"},{"id":"cli/breaking-changes/breaking-changes::comparison-with-other-tools::19","title":"Breaking Changes Detection","section":"Comparison with Other Tools","path":"/docs/guide/cli/breaking-changes/breaking-changes#comparison-with-other-tools","headings":["Comparison with Other Tools"],"excerpt":"Comparison with Other Tools Detection Level Description EasyP Support ---------------- ------------- --------------- **WIRE** Wire format compatibility only ✅ **Full support** **WIRE+** Wire + element deletion detection ","content":"Comparison with Other Tools Detection Level Description EasyP Support ---------------- ------------- --------------- **WIRE** Wire format compatibility only ✅ **Full support** **WIRE+** Wire + element deletion detection ✅ **Current level** **FILE** Generated code compatibility ✅ **Current level**"},{"id":"cli/breaking-changes/breaking-changes::breaking-change-rules::20","title":"Breaking Changes Detection","section":"Breaking Change Rules","path":"/docs/guide/cli/breaking-changes/breaking-changes#breaking-change-rules","headings":["Breaking Change Rules"],"excerpt":"Breaking Change Rules EasyP detects the following categories of breaking changes. Each rule has detailed documentation with examples:","content":"Breaking Change Rules EasyP detects the following categories of breaking changes. Each rule has detailed documentation with examples:"},{"id":"cli/breaking-changes/breaking-changes::service-and-rpc-changes::21","title":"Breaking Changes Detection","section":"🚨 Service and RPC Changes","path":"/docs/guide/cli/breaking-changes/breaking-changes#service-and-rpc-changes","headings":["🚨 Service and RPC Changes"],"excerpt":"🚨 Service and RPC Changes Rule Description Status ------ ------------- --------- SERVICE_NO_DELETE Services cannot be deleted ✅ Implemented RPC_NO_DELETE RPC methods cannot be deleted ✅ Implemented RPC_SAME_REQUEST_TYPE","content":"🚨 Service and RPC Changes Rule Description Status ------ ------------- --------- SERVICE_NO_DELETE Services cannot be deleted ✅ Implemented RPC_NO_DELETE RPC methods cannot be deleted ✅ Implemented RPC_SAME_REQUEST_TYPE RPC request types cannot be changed ✅ Implemented RPC_SAME_RESPONSE_TYPE RPC response types cannot be changed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::message-and-field-changes::22","title":"Breaking Changes Detection","section":"📦 Message and Field Changes","path":"/docs/guide/cli/breaking-changes/breaking-changes#message-and-field-changes","headings":["📦 Message and Field Changes"],"excerpt":"📦 Message and Field Changes Rule Description Status ------ ------------- --------- MESSAGE_NO_DELETE Messages cannot be deleted ✅ Implemented FIELD_NO_DELETE Fields cannot be deleted ✅ Implemented FIELD_SAME_TYPE Field ","content":"📦 Message and Field Changes Rule Description Status ------ ------------- --------- MESSAGE_NO_DELETE Messages cannot be deleted ✅ Implemented FIELD_NO_DELETE Fields cannot be deleted ✅ Implemented FIELD_SAME_TYPE Field types cannot be changed ✅ Implemented FIELD_SAME_CARDINALITY Field optionality (optional/required) cannot be changed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::enum-changes::23","title":"Breaking Changes Detection","section":"🔢 Enum Changes","path":"/docs/guide/cli/breaking-changes/breaking-changes#enum-changes","headings":["🔢 Enum Changes"],"excerpt":"🔢 Enum Changes Rule Description Status ------ ------------- --------- ENUM_NO_DELETE Enums cannot be deleted ✅ Implemented ENUM_VALUE_NO_DELETE Enum values cannot be deleted ✅ Implemented ENUM_VALUE_SAME_NAME Enum value","content":"🔢 Enum Changes Rule Description Status ------ ------------- --------- ENUM_NO_DELETE Enums cannot be deleted ✅ Implemented ENUM_VALUE_NO_DELETE Enum values cannot be deleted ✅ Implemented ENUM_VALUE_SAME_NAME Enum value names cannot be changed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::oneof-changes::24","title":"Breaking Changes Detection","section":"🔗 OneOf Changes","path":"/docs/guide/cli/breaking-changes/breaking-changes#oneof-changes","headings":["🔗 OneOf Changes"],"excerpt":"🔗 OneOf Changes Rule Description Status ------ ------------- --------- ONEOF_NO_DELETE OneOf fields cannot be deleted ✅ Implemented ONEOF_FIELD_NO_DELETE Fields within oneofs cannot be deleted ✅ Implemented ONEOF_FIELD_","content":"🔗 OneOf Changes Rule Description Status ------ ------------- --------- ONEOF_NO_DELETE OneOf fields cannot be deleted ✅ Implemented ONEOF_FIELD_NO_DELETE Fields within oneofs cannot be deleted ✅ Implemented ONEOF_FIELD_SAME_TYPE OneOf field types cannot be changed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::import-changes::25","title":"Breaking Changes Detection","section":"📥 Import Changes","path":"/docs/guide/cli/breaking-changes/breaking-changes#import-changes","headings":["📥 Import Changes"],"excerpt":"📥 Import Changes Rule Description Status ------ ------------- --------- IMPORT_NO_DELETE Import statements cannot be removed ✅ Implemented","content":"📥 Import Changes Rule Description Status ------ ------------- --------- IMPORT_NO_DELETE Import statements cannot be removed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::not-currently-detected::26","title":"Breaking Changes Detection","section":"Not Currently Detected","path":"/docs/guide/cli/breaking-changes/breaking-changes#not-currently-detected","headings":["Not Currently Detected"],"excerpt":"Not Currently Detected The following changes are **NOT detected** by EasyP (but may break generated code):","content":"Not Currently Detected The following changes are **NOT detected** by EasyP (but may break generated code):"},{"id":"cli/breaking-changes/breaking-changes::not-currently-detected::27","title":"Breaking Changes Detection","section":"Not Currently Detected","path":"/docs/guide/cli/breaking-changes/breaking-changes#not-currently-detected","headings":["Not Currently Detected"],"excerpt":"Not Currently Detected Change Type Example Impact ------------- --------- --------- Field renaming string name = 1 → string full_name = 1 Generated code breaks Package changes package v1 → package v2 Import paths change ","content":"Not Currently Detected Change Type Example Impact ------------- --------- --------- Field renaming string name = 1 → string full_name = 1 Generated code breaks Package changes package v1 → package v2 Import paths change File options option go_package = \"old\" → option go_package = \"new\" Generated code location Moving between files Message moved to different .proto file Import dependencies"},{"id":"cli/breaking-changes/breaking-changes::detailed-rules-documentation::28","title":"Breaking Changes Detection","section":"Detailed Rules Documentation","path":"/docs/guide/cli/breaking-changes/breaking-changes#detailed-rules-documentation","headings":["Detailed Rules Documentation"],"excerpt":"Detailed Rules Documentation For comprehensive examples and migration strategies, see the individual rule documentation:","content":"Detailed Rules Documentation For comprehensive examples and migration strategies, see the individual rule documentation:"},{"id":"cli/breaking-changes/breaking-changes::detailed-rules-documentation::29","title":"Breaking Changes Detection","section":"Detailed Rules Documentation","path":"/docs/guide/cli/breaking-changes/breaking-changes#detailed-rules-documentation","headings":["Detailed Rules Documentation"],"excerpt":"Detailed Rules Documentation **Service Changes**: SERVICE_NO_DELETE, RPC_NO_DELETE, RPC_SAME_REQUEST_TYPE, RPC_SAME_RESPONSE_TYPE **Message Changes**: MESSAGE_NO_DELETE, FIELD_NO_DELETE, FIELD_SAME_TYPE, FIELD_SAME_CARDI","content":"Detailed Rules Documentation **Service Changes**: SERVICE_NO_DELETE, RPC_NO_DELETE, RPC_SAME_REQUEST_TYPE, RPC_SAME_RESPONSE_TYPE **Message Changes**: MESSAGE_NO_DELETE, FIELD_NO_DELETE, FIELD_SAME_TYPE, FIELD_SAME_CARDINALITY **Enum Changes**: ENUM_NO_DELETE, ENUM_VALUE_NO_DELETE, ENUM_VALUE_SAME_NAME **OneOf Changes**: ONEOF_NO_DELETE, ONEOF_FIELD_NO_DELETE, ONEOF_FIELD_SAME_TYPE **Import Changes**: IMPORT_NO_DELETE"},{"id":"cli/breaking-changes/breaking-changes::detailed-rules-documentation::30","title":"Breaking Changes Detection","section":"Detailed Rules Documentation","path":"/docs/guide/cli/breaking-changes/breaking-changes#detailed-rules-documentation","headings":["Detailed Rules Documentation"],"excerpt":"Detailed Rules Documentation Each rule includes: ❌ **Bad examples** with actual breaking changes ✅ **Good alternatives** showing safe approaches 🔧 **Migration strategies** for handling necessary changes 📋 **Real error ","content":"Detailed Rules Documentation Each rule includes: ❌ **Bad examples** with actual breaking changes ✅ **Good alternatives** showing safe approaches 🔧 **Migration strategies** for handling necessary changes 📋 **Real error messages** from EasyP"},{"id":"cli/breaking-changes/breaking-changes::safe-changes-always-allowed::31","title":"Breaking Changes Detection","section":"✅ Safe Changes (Always Allowed)","path":"/docs/guide/cli/breaking-changes/breaking-changes#safe-changes-always-allowed","headings":["✅ Safe Changes (Always Allowed)"],"excerpt":"✅ Safe Changes (Always Allowed) ```proto // Adding new elements is always safe message User { string name = 1; string email = 2; string phone = 3; // ✅ New field - safe }","content":"✅ Safe Changes (Always Allowed) ```proto // Adding new elements is always safe message User { string name = 1; string email = 2; string phone = 3; // ✅ New field - safe }"},{"id":"cli/breaking-changes/breaking-changes::safe-changes-always-allowed::32","title":"Breaking Changes Detection","section":"✅ Safe Changes (Always Allowed)","path":"/docs/guide/cli/breaking-changes/breaking-changes#safe-changes-always-allowed","headings":["✅ Safe Changes (Always Allowed)"],"excerpt":"✅ Safe Changes (Always Allowed) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc GetUserProfile(GetUserRequest) returns (UserProfile); // ✅ New RPC - safe }","content":"✅ Safe Changes (Always Allowed) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc GetUserProfile(GetUserRequest) returns (UserProfile); // ✅ New RPC - safe }"},{"id":"cli/breaking-changes/breaking-changes::safe-changes-always-allowed::33","title":"Breaking Changes Detection","section":"✅ Safe Changes (Always Allowed)","path":"/docs/guide/cli/breaking-changes/breaking-changes#safe-changes-always-allowed","headings":["✅ Safe Changes (Always Allowed)"],"excerpt":"✅ Safe Changes (Always Allowed) enum Status { STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; STATUS_PENDING = 2; // ✅ New enum value - safe } ```","content":"✅ Safe Changes (Always Allowed) enum Status { STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; STATUS_PENDING = 2; // ✅ New enum value - safe } ```"},{"id":"cli/breaking-changes/breaking-changes::breaking-changes-always-detected::34","title":"Breaking Changes Detection","section":"❌ Breaking Changes (Always Detected)","path":"/docs/guide/cli/breaking-changes/breaking-changes#breaking-changes-always-detected","headings":["❌ Breaking Changes (Always Detected)"],"excerpt":"❌ Breaking Changes (Always Detected) ```proto // Deletions and type changes break compatibility message User { string name = 1; // ❌ Deleted field - BREAKING }","content":"❌ Breaking Changes (Always Detected) ```proto // Deletions and type changes break compatibility message User { string name = 1; // ❌ Deleted field - BREAKING }"},{"id":"cli/breaking-changes/breaking-changes::breaking-changes-always-detected::35","title":"Breaking Changes Detection","section":"❌ Breaking Changes (Always Detected)","path":"/docs/guide/cli/breaking-changes/breaking-changes#breaking-changes-always-detected","headings":["❌ Breaking Changes (Always Detected)"],"excerpt":"❌ Breaking Changes (Always Detected) service UserService { // ❌ Deleted RPC method - BREAKING rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // ❌ Changed request type - BREAKING } ```","content":"❌ Breaking Changes (Always Detected) service UserService { // ❌ Deleted RPC method - BREAKING rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // ❌ Changed request type - BREAKING } ```"},{"id":"cli/breaking-changes/breaking-changes::scenario-3-breaking-changes-currently-not-detected::36","title":"Breaking Changes Detection","section":"Scenario 3: Breaking Changes (Currently Not Detected)","path":"/docs/guide/cli/breaking-changes/breaking-changes#scenario-3-breaking-changes-currently-not-detected","headings":["Scenario 3: Breaking Changes (Currently Not Detected)"],"excerpt":"Scenario 3: Breaking Changes (Currently Not Detected) ```proto // 🟡 Breaks generated code but passes EasyP checks message User { string user_name = 1; // Renamed from \"name\" string user_email = 2; // Renamed from \"email","content":"Scenario 3: Breaking Changes (Currently Not Detected) ```proto // 🟡 Breaks generated code but passes EasyP checks message User { string user_name = 1; // Renamed from \"name\" string user_email = 2; // Renamed from \"email\" }"},{"id":"cli/breaking-changes/breaking-changes::scenario-3-breaking-changes-currently-not-detected::37","title":"Breaking Changes Detection","section":"Scenario 3: Breaking Changes (Currently Not Detected)","path":"/docs/guide/cli/breaking-changes/breaking-changes#scenario-3-breaking-changes-currently-not-detected","headings":["Scenario 3: Breaking Changes (Currently Not Detected)"],"excerpt":"Scenario 3: Breaking Changes (Currently Not Detected) service UserService { rpc GetUserProfile(GetUserRequest) returns (GetUserResponse); // Renamed from GetUser } ```","content":"Scenario 3: Breaking Changes (Currently Not Detected) service UserService { rpc GetUserProfile(GetUserRequest) returns (GetUserResponse); // Renamed from GetUser } ```"},{"id":"cli/breaking-changes/breaking-changes::1-regular-checks::38","title":"Breaking Changes Detection","section":"1. Regular Checks","path":"/docs/guide/cli/breaking-changes/breaking-changes#1-regular-checks","headings":["1. Regular Checks"],"excerpt":"Regular Checks Run breaking change detection in your CI/CD pipeline:","content":"Regular Checks Run breaking change detection in your CI/CD pipeline:"},{"id":"cli/breaking-changes/breaking-changes::2-branch-protection::39","title":"Breaking Changes Detection","section":"2. Branch Protection","path":"/docs/guide/cli/breaking-changes/breaking-changes#2-branch-protection","headings":["2. Branch Protection"],"excerpt":"Branch Protection Use breaking change checks to protect important branches:","content":"Branch Protection Use breaking change checks to protect important branches:"},{"id":"cli/breaking-changes/breaking-changes::3-versioning-strategy::40","title":"Breaking Changes Detection","section":"3. Versioning Strategy","path":"/docs/guide/cli/breaking-changes/breaking-changes#3-versioning-strategy","headings":["3. Versioning Strategy"],"excerpt":"Versioning Strategy When breaking changes are necessary:","content":"Versioning Strategy When breaking changes are necessary:"},{"id":"cli/breaking-changes/breaking-changes::3-versioning-strategy::41","title":"Breaking Changes Detection","section":"3. Versioning Strategy","path":"/docs/guide/cli/breaking-changes/breaking-changes#3-versioning-strategy","headings":["3. Versioning Strategy"],"excerpt":"Versioning Strategy Create a new package version (e.g., myservice.v2) Maintain the old version during migration period Use deprecation notices in the old version","content":"Versioning Strategy Create a new package version (e.g., myservice.v2) Maintain the old version during migration period Use deprecation notices in the old version"},{"id":"cli/breaking-changes/breaking-changes::4-ignore-patterns::42","title":"Breaking Changes Detection","section":"4. Ignore Patterns","path":"/docs/guide/cli/breaking-changes/breaking-changes#4-ignore-patterns","headings":["4. Ignore Patterns"],"excerpt":"Ignore Patterns Use ignore patterns wisely:","content":"Ignore Patterns Use ignore patterns wisely:"},{"id":"cli/breaking-changes/breaking-changes::issue-repository-does-not-exist::43","title":"Breaking Changes Detection","section":"Issue: \"Repository does not exist\"","path":"/docs/guide/cli/breaking-changes/breaking-changes#issue-repository-does-not-exist","headings":["Issue: \"Repository does not exist\""],"excerpt":"Issue: \"Repository does not exist\" **Solution**: Ensure you're running the command in a Git repository with the specified branch available.","content":"Issue: \"Repository does not exist\" **Solution**: Ensure you're running the command in a Git repository with the specified branch available."},{"id":"cli/breaking-changes/breaking-changes::issue-cannot-find-git-ref::44","title":"Breaking Changes Detection","section":"Issue: \"Cannot find git ref\"","path":"/docs/guide/cli/breaking-changes/breaking-changes#issue-cannot-find-git-ref","headings":["Issue: \"Cannot find git ref\""],"excerpt":"Issue: \"Cannot find git ref\" **Solution**: Verify the branch/tag name exists and is accessible:","content":"Issue: \"Cannot find git ref\" **Solution**: Verify the branch/tag name exists and is accessible:"},{"id":"cli/breaking-changes/breaking-changes::issue-false-positives-in-generated-code::45","title":"Breaking Changes Detection","section":"Issue: False Positives in Generated Code","path":"/docs/guide/cli/breaking-changes/breaking-changes#issue-false-positives-in-generated-code","headings":["Issue: False Positives in Generated Code"],"excerpt":"Issue: False Positives in Generated Code **Solution**: Add generated directories to ignore list:","content":"Issue: False Positives in Generated Code **Solution**: Add generated directories to ignore list:"},{"id":"cli/breaking-changes/breaking-changes::issue-large-number-of-changes::46","title":"Breaking Changes Detection","section":"Issue: Large Number of Changes","path":"/docs/guide/cli/breaking-changes/breaking-changes#issue-large-number-of-changes","headings":["Issue: Large Number of Changes"],"excerpt":"Issue: Large Number of Changes **Solution**: For major refactoring, consider: Creating a new API version Implementing changes incrementally Using feature flags for gradual rollout","content":"Issue: Large Number of Changes **Solution**: For major refactoring, consider: Creating a new API version Implementing changes incrementally Using feature flags for gradual rollout"},{"id":"cli/breaking-changes/breaking-changes::github-actions::47","title":"Breaking Changes Detection","section":"GitHub Actions","path":"/docs/guide/cli/breaking-changes/breaking-changes#github-actions","headings":["GitHub Actions"],"excerpt":"GitHub Actions ```yaml name: API Compatibility Check","content":"GitHub Actions ```yaml name: API Compatibility Check"},{"id":"cli/breaking-changes/breaking-changes::github-actions::48","title":"Breaking Changes Detection","section":"GitHub Actions","path":"/docs/guide/cli/breaking-changes/breaking-changes#github-actions","headings":["GitHub Actions"],"excerpt":"GitHub Actions on: pull_request: branches: [ main ]","content":"GitHub Actions on: pull_request: branches: [ main ]"},{"id":"cli/breaking-changes/breaking-changes::github-actions::49","title":"Breaking Changes Detection","section":"GitHub Actions","path":"/docs/guide/cli/breaking-changes/breaking-changes#github-actions","headings":["GitHub Actions"],"excerpt":"GitHub Actions jobs: breaking-changes: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 with: fetch-depth: 0 # Fetch full history - name: Install EasyP run: curl -sSfL https://raw.githubusercontent.com/easyp-tec","content":"GitHub Actions jobs: breaking-changes: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 with: fetch-depth: 0 # Fetch full history - name: Install EasyP run: curl -sSfL https://raw.githubusercontent.com/easyp-tech/easyp/main/install.sh sh - name: Check for breaking changes run: ./bin/easyp breaking --against origin/main ```"},{"id":"cli/breaking-changes/breaking-changes::pre-commit-hook::50","title":"Breaking Changes Detection","section":"Pre-commit Hook","path":"/docs/guide/cli/breaking-changes/breaking-changes#pre-commit-hook","headings":["Pre-commit Hook"],"excerpt":"Pre-commit Hook ```bash #!/bin/sh .git/hooks/pre-push","content":"Pre-commit Hook ```bash #!/bin/sh .git/hooks/pre-push"},{"id":"cli/breaking-changes/breaking-changes::pre-commit-hook::51","title":"Breaking Changes Detection","section":"Pre-commit Hook","path":"/docs/guide/cli/breaking-changes/breaking-changes#pre-commit-hook","headings":["Pre-commit Hook"],"excerpt":"Pre-commit Hook protected_branch='main' current_branch=$(git symbolic-ref HEAD sed -e 's,.*/\\(.*\\),\\1,')","content":"Pre-commit Hook protected_branch='main' current_branch=$(git symbolic-ref HEAD sed -e 's,.*/\\(.*\\),\\1,')"},{"id":"cli/breaking-changes/breaking-changes::pre-commit-hook::52","title":"Breaking Changes Detection","section":"Pre-commit Hook","path":"/docs/guide/cli/breaking-changes/breaking-changes#pre-commit-hook","headings":["Pre-commit Hook"],"excerpt":"Pre-commit Hook if [ $current_branch = $protected_branch ]; then echo \"Running breaking changes check...\" easyp breaking --against HEAD~1 if [ $? -eq 1 ]; then echo \"❌ Breaking changes detected. Push rejected.\" exit 1 fi","content":"Pre-commit Hook if [ $current_branch = $protected_branch ]; then echo \"Running breaking changes check...\" easyp breaking --against HEAD~1 if [ $? -eq 1 ]; then echo \"❌ Breaking changes detected. Push rejected.\" exit 1 fi echo \"✅ No breaking changes detected.\" fi ```"},{"id":"cli/breaking-changes/breaking-changes::debug-mode::53","title":"Breaking Changes Detection","section":"Debug Mode","path":"/docs/guide/cli/breaking-changes/breaking-changes#debug-mode","headings":["Debug Mode"],"excerpt":"Debug Mode Enable debug logging for detailed information:","content":"Debug Mode Enable debug logging for detailed information:"},{"id":"cli/breaking-changes/breaking-changes::manual-comparison::54","title":"Breaking Changes Detection","section":"Manual Comparison","path":"/docs/guide/cli/breaking-changes/breaking-changes#manual-comparison","headings":["Manual Comparison"],"excerpt":"Manual Comparison For complex cases, you can manually inspect the comparison:","content":"Manual Comparison For complex cases, you can manually inspect the comparison:"},{"id":"cli/breaking-changes/breaking-changes::performance-optimization::55","title":"Breaking Changes Detection","section":"Performance Optimization","path":"/docs/guide/cli/breaking-changes/breaking-changes#performance-optimization","headings":["Performance Optimization"],"excerpt":"Performance Optimization For large repositories:","content":"Performance Optimization For large repositories:"},{"id":"cli/breaking-changes/breaking-changes::performance-optimization::56","title":"Breaking Changes Detection","section":"Performance Optimization","path":"/docs/guide/cli/breaking-changes/breaking-changes#performance-optimization","headings":["Performance Optimization"],"excerpt":"Performance Optimization The breaking changes detection in EasyP provides a robust foundation for maintaining API compatibility while allowing your protobuf schemas to evolve safely over time.","content":"Performance Optimization The breaking changes detection in EasyP provides a robust foundation for maintaining API compatibility while allowing your protobuf schemas to evolve safely over time."},{"id":"cli/breaking-changes/rules/enum-no-delete::top::0","title":"ENUM_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":[],"excerpt":"This rule checks that no enums are deleted from proto files. Deleting an enum breaks both wire format compatibility and generated code, as existing data may contain values from the deleted enum and client code depends on","content":"This rule checks that no enums are deleted from proto files. Deleting an enum breaks both wire format compatibility and generated code, as existing data may contain values from the deleted enum and client code depends on the generated enum types."},{"id":"cli/breaking-changes/rules/enum-no-delete::bad::1","title":"ENUM_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::bad::2","title":"ENUM_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#bad","headings":["Bad"],"excerpt":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::bad::3","title":"ENUM_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#bad","headings":["Bad"],"excerpt":"Bad enum UserRole { // [!code --] USER_ROLE_UNSPECIFIED = 0; // [!code --] USER_ROLE_ADMIN = 1; // [!code --] USER_ROLE_USER = 2; // [!code --] } // [!code --]","content":"Bad enum UserRole { // [!code --] USER_ROLE_UNSPECIFIED = 0; // [!code --] USER_ROLE_ADMIN = 1; // [!code --] USER_ROLE_USER = 2; // [!code --] } // [!code --]"},{"id":"cli/breaking-changes/rules/enum-no-delete::bad::4","title":"ENUM_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3; } ```","content":"Bad message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3; } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::bad::5","title":"ENUM_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::bad::6","title":"ENUM_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#bad","headings":["Bad"],"excerpt":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::bad::7","title":"ENUM_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#bad","headings":["Bad"],"excerpt":"Bad // UserRole enum was deleted - BREAKING CHANGE!","content":"Bad // UserRole enum was deleted - BREAKING CHANGE!"},{"id":"cli/breaking-changes/rules/enum-no-delete::bad::8","title":"ENUM_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3; // ERROR: UserRole no longer exists! } ```","content":"Bad message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3; // ERROR: UserRole no longer exists! } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::more-examples::9","title":"ENUM_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples **Nested enum deletion:**","content":"More Examples **Nested enum deletion:**"},{"id":"cli/breaking-changes/rules/enum-no-delete::more-examples::10","title":"ENUM_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before message User { string name = 1; Status status = 2; enum Status { // [!code --] STATUS_UNSPECIFIED = 0; // [!code --] STATUS_ACTIVE = 1; // [!code --] STATUS_INACTIVE = 2; // [!code --] } ","content":"More Examples ```proto // Before message User { string name = 1; Status status = 2; enum Status { // [!code --] STATUS_UNSPECIFIED = 0; // [!code --] STATUS_ACTIVE = 1; // [!code --] STATUS_INACTIVE = 2; // [!code --] } // [!code --] }"},{"id":"cli/breaking-changes/rules/enum-no-delete::more-examples::11","title":"ENUM_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - BREAKING CHANGE! message User { string name = 1; Status status = 2; // ERROR: Status enum deleted // Status nested enum was deleted } ```","content":"More Examples // After - BREAKING CHANGE! message User { string name = 1; Status status = 2; // ERROR: Status enum deleted // Status nested enum was deleted } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::12","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, deprecate the enum:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, deprecate the enum:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::13","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::14","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good enum UserRole { option deprecated = true; // [!code focus] USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_USER = 2; }","content":"Good enum UserRole { option deprecated = true; // [!code focus] USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_USER = 2; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::15","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3 [deprecated = true]; // [!code focus] } ```","content":"Good message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3 [deprecated = true]; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::16","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good **Or replace with new enum:** ```proto syntax = \"proto3\";","content":"Good **Or replace with new enum:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::17","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::18","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good enum UserRole { option deprecated = true; // [!code focus] // Old enum USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_USER = 2; }","content":"Good enum UserRole { option deprecated = true; // [!code focus] // Old enum USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_USER = 2; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::19","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good enum UserPermission { // [!code focus] // New enum with better design USER_PERMISSION_UNSPECIFIED = 0; // [!code focus] USER_PERMISSION_READ = 1; // [!code focus] USER_PERMISSION_WRITE = 2; // [!code focus] USER_PER","content":"Good enum UserPermission { // [!code focus] // New enum with better design USER_PERMISSION_UNSPECIFIED = 0; // [!code focus] USER_PERMISSION_READ = 1; // [!code focus] USER_PERMISSION_WRITE = 2; // [!code focus] USER_PERMISSION_ADMIN = 3; // [!code focus] } // [!code focus]"},{"id":"cli/breaking-changes/rules/enum-no-delete::good::20","title":"ENUM_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#good","headings":["Good"],"excerpt":"Good message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3 [deprecated = true]; // [!code focus] // Old field UserPermission created_by_permission = 4; // [!code focus] // New field } ```","content":"Good message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3 [deprecated = true]; // [!code focus] // Old field UserPermission created_by_permission = 4; // [!code focus] // New field } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::impact::21","title":"ENUM_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Existing data with the deleted enum cannot be deserialized **Generated Code:** Enum types/constants are removed, breaking client compilation **Field References:** Fields using the deleted enum typ","content":"Impact **Wire Format:** Existing data with the deleted enum cannot be deserialized **Generated Code:** Enum types/constants are removed, breaking client compilation **Field References:** Fields using the deleted enum type become invalid **Switch Statements:** Client code with enum switch cases breaks"},{"id":"cli/breaking-changes/rules/enum-no-delete::real-world-example::22","title":"ENUM_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works order := &myapi.Order{ Id: \"order123\", Status: myapi.OrderStatus_ORDER_STATUS_PENDING, CreatedByRole: myapi.UserRole_USER_ROLE_ADMIN, // ERROR ","content":"Real-World Example **Client code breaks:** ```go // Before - this code works order := &myapi.Order{ Id: \"order123\", Status: myapi.OrderStatus_ORDER_STATUS_PENDING, CreatedByRole: myapi.UserRole_USER_ROLE_ADMIN, // ERROR after deletion }"},{"id":"cli/breaking-changes/rules/enum-no-delete::real-world-example::23","title":"ENUM_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Check role switch order.CreatedByRole { case myapi.UserRole_USER_ROLE_ADMIN: // ERROR: undefined type // Admin logic case myapi.UserRole_USER_ROLE_USER: // ERROR: undefined type // User logic }","content":"Real-World Example // Check role switch order.CreatedByRole { case myapi.UserRole_USER_ROLE_ADMIN: // ERROR: undefined type // Admin logic case myapi.UserRole_USER_ROLE_USER: // ERROR: undefined type // User logic }"},{"id":"cli/breaking-changes/rules/enum-no-delete::real-world-example::24","title":"ENUM_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Generated code compilation fails: // undefined: myapi.UserRole // undefined: myapi.UserRole_USER_ROLE_ADMIN ```","content":"Real-World Example // Generated code compilation fails: // undefined: myapi.UserRole // undefined: myapi.UserRole_USER_ROLE_ADMIN ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::real-world-example::25","title":"ENUM_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Existing data becomes unreadable:** ```json // Serialized data before deletion { \"id\": \"order123\", \"status\": \"ORDER_STATUS_PENDING\", \"created_by_role\": \"USER_ROLE_ADMIN\" }","content":"Real-World Example **Existing data becomes unreadable:** ```json // Serialized data before deletion { \"id\": \"order123\", \"status\": \"ORDER_STATUS_PENDING\", \"created_by_role\": \"USER_ROLE_ADMIN\" }"},{"id":"cli/breaking-changes/rules/enum-no-delete::real-world-example::26","title":"ENUM_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After UserRole deletion - deserialization fails // Parser doesn't know how to handle \"created_by_role\" field ```","content":"Real-World Example // After UserRole deletion - deserialization fails // Parser doesn't know how to handle \"created_by_role\" field ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::real-world-example::27","title":"ENUM_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server implementation breaks:**","content":"Real-World Example **Server implementation breaks:**"},{"id":"cli/breaking-changes/rules/enum-no-delete::migration-strategy::28","title":"ENUM_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate the enum first:**","content":"Migration Strategy **Deprecate the enum first:**"},{"id":"cli/breaking-changes/rules/enum-no-delete::migration-strategy::29","title":"ENUM_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Stop using in new fields** and deprecate existing fields:","content":"Migration Strategy **Stop using in new fields** and deprecate existing fields:"},{"id":"cli/breaking-changes/rules/enum-no-delete::migration-strategy::30","title":"ENUM_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Create replacement** if needed:","content":"Migration Strategy **Create replacement** if needed:"},{"id":"cli/breaking-changes/rules/enum-no-delete::migration-strategy::31","title":"ENUM_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update server code** to handle both during transition:","content":"Migration Strategy **Update server code** to handle both during transition:"},{"id":"cli/breaking-changes/rules/enum-no-delete::migration-strategy::32","title":"ENUM_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove after migration period** in a new major version","content":"Migration Strategy **Remove after migration period** in a new major version"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum-redesign::33","title":"ENUM_NO_DELETE","section":"Enum Redesign","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum-redesign","headings":["Enum Redesign"],"excerpt":"Enum Redesign ```proto // Instead of deleting old enum enum Priority { option deprecated = true; // Deprecate old design PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_HIGH = 2; }","content":"Enum Redesign ```proto // Instead of deleting old enum enum Priority { option deprecated = true; // Deprecate old design PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_HIGH = 2; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum-redesign::34","title":"ENUM_NO_DELETE","section":"Enum Redesign","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum-redesign","headings":["Enum Redesign"],"excerpt":"Enum Redesign enum TaskPriority { // Create new enum with better naming TASK_PRIORITY_UNSPECIFIED = 0; TASK_PRIORITY_LOW = 1; TASK_PRIORITY_MEDIUM = 2; TASK_PRIORITY_HIGH = 3; TASK_PRIORITY_URGENT = 4; } ```","content":"Enum Redesign enum TaskPriority { // Create new enum with better naming TASK_PRIORITY_UNSPECIFIED = 0; TASK_PRIORITY_LOW = 1; TASK_PRIORITY_MEDIUM = 2; TASK_PRIORITY_HIGH = 3; TASK_PRIORITY_URGENT = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::consolidating-enums::35","title":"ENUM_NO_DELETE","section":"Consolidating Enums","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#consolidating-enums","headings":["Consolidating Enums"],"excerpt":"Consolidating Enums ```proto // Instead of deleting multiple enums enum Status { option deprecated = true; // Keep old enum STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; }","content":"Consolidating Enums ```proto // Instead of deleting multiple enums enum Status { option deprecated = true; // Keep old enum STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::consolidating-enums::36","title":"ENUM_NO_DELETE","section":"Consolidating Enums","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#consolidating-enums","headings":["Consolidating Enums"],"excerpt":"Consolidating Enums enum State { option deprecated = true; // Keep old enum STATE_UNSPECIFIED = 0; STATE_ENABLED = 1; }","content":"Consolidating Enums enum State { option deprecated = true; // Keep old enum STATE_UNSPECIFIED = 0; STATE_ENABLED = 1; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::consolidating-enums::37","title":"ENUM_NO_DELETE","section":"Consolidating Enums","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#consolidating-enums","headings":["Consolidating Enums"],"excerpt":"Consolidating Enums enum EntityStatus { // New consolidated enum ENTITY_STATUS_UNSPECIFIED = 0; ENTITY_STATUS_ACTIVE = 1; ENTITY_STATUS_INACTIVE = 2; ENTITY_STATUS_ENABLED = 3; ENTITY_STATUS_DISABLED = 4; } ```","content":"Consolidating Enums enum EntityStatus { // New consolidated enum ENTITY_STATUS_UNSPECIFIED = 0; ENTITY_STATUS_ACTIVE = 1; ENTITY_STATUS_INACTIVE = 2; ENTITY_STATUS_ENABLED = 3; ENTITY_STATUS_DISABLED = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::moving-enum-to-different-package::38","title":"ENUM_NO_DELETE","section":"Moving Enum to Different Package","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#moving-enum-to-different-package","headings":["Moving Enum to Different Package"],"excerpt":"Moving Enum to Different Package ```proto // Instead of deleting from current package enum UserRole { option deprecated = true; // Mark as deprecated USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; }","content":"Moving Enum to Different Package ```proto // Instead of deleting from current package enum UserRole { option deprecated = true; // Mark as deprecated USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::moving-enum-to-different-package::39","title":"ENUM_NO_DELETE","section":"Moving Enum to Different Package","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#moving-enum-to-different-package","headings":["Moving Enum to Different Package"],"excerpt":"Moving Enum to Different Package // Import from new location import \"common/roles.proto\";","content":"Moving Enum to Different Package // Import from new location import \"common/roles.proto\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::moving-enum-to-different-package::40","title":"ENUM_NO_DELETE","section":"Moving Enum to Different Package","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#moving-enum-to-different-package","headings":["Moving Enum to Different Package"],"excerpt":"Moving Enum to Different Package message Order { UserRole old_role = 3 [deprecated = true]; common.UserRole new_role = 4; // Reference from new package } ```","content":"Moving Enum to Different Package message Order { UserRole old_role = 3 [deprecated = true]; common.UserRole new_role = 4; // Reference from new package } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::version-migration::41","title":"ENUM_NO_DELETE","section":"Version Migration","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#version-migration","headings":["Version Migration"],"excerpt":"Version Migration ```proto // Clean approach - new package version package myapi.v2;","content":"Version Migration ```proto // Clean approach - new package version package myapi.v2;"},{"id":"cli/breaking-changes/rules/enum-no-delete::version-migration::42","title":"ENUM_NO_DELETE","section":"Version Migration","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#version-migration","headings":["Version Migration"],"excerpt":"Version Migration // Redesigned enums without deprecated ones enum UserPermission { USER_PERMISSION_UNSPECIFIED = 0; USER_PERMISSION_READ = 1; USER_PERMISSION_WRITE = 2; USER_PERMISSION_ADMIN = 3; }","content":"Version Migration // Redesigned enums without deprecated ones enum UserPermission { USER_PERMISSION_UNSPECIFIED = 0; USER_PERMISSION_READ = 1; USER_PERMISSION_WRITE = 2; USER_PERMISSION_ADMIN = 3; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::version-migration::43","title":"ENUM_NO_DELETE","section":"Version Migration","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#version-migration","headings":["Version Migration"],"excerpt":"Version Migration message Order { string id = 1; UserPermission created_by_permission = 2; // Clean design in v2 } ```","content":"Version Migration message Order { string id = 1; UserPermission created_by_permission = 2; // Clean design in v2 } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::0","title":"ENUM_VALUE_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":[],"excerpt":"This rule checks that no enum values are deleted from enums. Deleting an enum value breaks both wire format compatibility and generated code, as existing data may contain the deleted enum value and client code may refere","content":"This rule checks that no enum values are deleted from enums. Deleting an enum value breaks both wire format compatibility and generated code, as existing data may contain the deleted enum value and client code may reference the generated constants."},{"id":"cli/breaking-changes/rules/enum-value-no-delete::bad::1","title":"ENUM_VALUE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::bad::2","title":"ENUM_VALUE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#bad","headings":["Bad"],"excerpt":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; ORDER_STATUS_CANCELLED = 5; }","content":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; ORDER_STATUS_CANCELLED = 5; }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::bad::3","title":"ENUM_VALUE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#bad","headings":["Bad"],"excerpt":"Bad enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; PRIORITY_URGENT = 4; } ```","content":"Bad enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; PRIORITY_URGENT = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::bad::4","title":"ENUM_VALUE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::bad::5","title":"ENUM_VALUE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#bad","headings":["Bad"],"excerpt":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; // ORDER_STATUS_CANCELLED = 5; // [!code --] Deleted enum v","content":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; // ORDER_STATUS_CANCELLED = 5; // [!code --] Deleted enum value - BREAKING! }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::bad::6","title":"ENUM_VALUE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#bad","headings":["Bad"],"excerpt":"Bad enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; // PRIORITY_URGENT = 4; // [!code --] Deleted enum value - BREAKING! } ```","content":"Bad enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; // PRIORITY_URGENT = 4; // [!code --] Deleted enum value - BREAKING! } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::more-examples::7","title":"ENUM_VALUE_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples **Multiple value deletions:**","content":"More Examples **Multiple value deletions:**"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::more-examples::8","title":"ENUM_VALUE_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_GUEST = 1; USER_ROLE_USER = 2; USER_ROLE_MODERATOR = 3; USER_ROLE_ADMIN = 4; USER_ROLE_SUPERADMIN = 5; }","content":"More Examples ```proto // Before enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_GUEST = 1; USER_ROLE_USER = 2; USER_ROLE_MODERATOR = 3; USER_ROLE_ADMIN = 4; USER_ROLE_SUPERADMIN = 5; }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::more-examples::9","title":"ENUM_VALUE_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - BREAKING CHANGES! enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_USER = 2; USER_ROLE_ADMIN = 4; // USER_ROLE_GUEST = 1; // BREAKING: deleted // USER_ROLE_MODERATOR = 3; // BREAKING: deleted","content":"More Examples // After - BREAKING CHANGES! enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_USER = 2; USER_ROLE_ADMIN = 4; // USER_ROLE_GUEST = 1; // BREAKING: deleted // USER_ROLE_MODERATOR = 3; // BREAKING: deleted // USER_ROLE_SUPERADMIN = 5; // BREAKING: deleted } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::good::10","title":"ENUM_VALUE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, deprecate the enum values:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, deprecate the enum values:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::good::11","title":"ENUM_VALUE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#good","headings":["Good"],"excerpt":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; ORDER_STATUS_CANCELLED = 5 [deprecated = true]; // [!code ","content":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; ORDER_STATUS_CANCELLED = 5 [deprecated = true]; // [!code focus] }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::good::12","title":"ENUM_VALUE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#good","headings":["Good"],"excerpt":"Good enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; PRIORITY_URGENT = 4 [deprecated = true]; // [!code focus] } ```","content":"Good enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; PRIORITY_URGENT = 4 [deprecated = true]; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::good::13","title":"ENUM_VALUE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#good","headings":["Good"],"excerpt":"Good **Or reserve the enum values after removal:** ```proto syntax = \"proto3\";","content":"Good **Or reserve the enum values after removal:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::good::14","title":"ENUM_VALUE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#good","headings":["Good"],"excerpt":"Good enum OrderStatus { reserved 5; // [!code focus] reserved \"ORDER_STATUS_CANCELLED\"; // [!code focus] ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER","content":"Good enum OrderStatus { reserved 5; // [!code focus] reserved \"ORDER_STATUS_CANCELLED\"; // [!code focus] ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::good::15","title":"ENUM_VALUE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#good","headings":["Good"],"excerpt":"Good enum Priority { reserved 4; // [!code focus] reserved \"PRIORITY_URGENT\"; // [!code focus] PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; } ```","content":"Good enum Priority { reserved 4; // [!code focus] reserved \"PRIORITY_URGENT\"; // [!code focus] PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::impact::16","title":"ENUM_VALUE_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Existing data with deleted enum values cannot be properly deserialized **Generated Code:** Enum constants are removed, breaking client compilation **Client Applications:** Code referencing deleted","content":"Impact **Wire Format:** Existing data with deleted enum values cannot be properly deserialized **Generated Code:** Enum constants are removed, breaking client compilation **Client Applications:** Code referencing deleted enum values fails to compile **Switch Statements:** Case statements for deleted values cause compilation errors **Default Handling:** Unknown enum values may be handled differently"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::real-world-example::17","title":"ENUM_VALUE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works order := &myapi.Order{ Status: myapi.OrderStatus_ORDER_STATUS_CANCELLED, // ERROR after deletion }","content":"Real-World Example **Client code breaks:** ```go // Before - this code works order := &myapi.Order{ Status: myapi.OrderStatus_ORDER_STATUS_CANCELLED, // ERROR after deletion }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::real-world-example::18","title":"ENUM_VALUE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Switch statement breaks switch order.Status { case myapi.OrderStatus_ORDER_STATUS_PENDING: // Handle pending case myapi.OrderStatus_ORDER_STATUS_CANCELLED: // ERROR: undefined constant // Handle can","content":"Real-World Example // Switch statement breaks switch order.Status { case myapi.OrderStatus_ORDER_STATUS_PENDING: // Handle pending case myapi.OrderStatus_ORDER_STATUS_CANCELLED: // ERROR: undefined constant // Handle cancellation default: // Handle unknown }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::real-world-example::19","title":"ENUM_VALUE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Generated code compilation fails: // undefined: myapi.OrderStatus_ORDER_STATUS_CANCELLED ```","content":"Real-World Example // Generated code compilation fails: // undefined: myapi.OrderStatus_ORDER_STATUS_CANCELLED ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::real-world-example::20","title":"ENUM_VALUE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Existing data becomes problematic:** ```json // Serialized data before deletion { \"id\": \"order123\", \"status\": \"ORDER_STATUS_CANCELLED\" }","content":"Real-World Example **Existing data becomes problematic:** ```json // Serialized data before deletion { \"id\": \"order123\", \"status\": \"ORDER_STATUS_CANCELLED\" }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::real-world-example::21","title":"ENUM_VALUE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After enum value deletion // Data deserializes but status becomes UNSPECIFIED (0) // or causes parsing errors depending on implementation ```","content":"Real-World Example // After enum value deletion // Data deserializes but status becomes UNSPECIFIED (0) // or causes parsing errors depending on implementation ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::real-world-example::22","title":"ENUM_VALUE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server validation breaks:** ```go // Before - server handles all enum values func validateOrderStatus(status OrderStatus) error { switch status { case OrderStatus_ORDER_STATUS_PENDING, OrderStatus_OR","content":"Real-World Example **Server validation breaks:** ```go // Before - server handles all enum values func validateOrderStatus(status OrderStatus) error { switch status { case OrderStatus_ORDER_STATUS_PENDING, OrderStatus_ORDER_STATUS_CONFIRMED, OrderStatus_ORDER_STATUS_SHIPPED, OrderStatus_ORDER_STATUS_DELIVERED, OrderStatus_ORDER_STATUS_CANCELLED: // ERROR: undefined return nil default: return errors.New(\"invalid order status\") } }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::real-world-example::23","title":"ENUM_VALUE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Server logic that depends on cancelled status func canModifyOrder(order *Order) bool { return order.Status != OrderStatus_ORDER_STATUS_CANCELLED // ERROR: undefined } ```","content":"Real-World Example // Server logic that depends on cancelled status func canModifyOrder(order *Order) bool { return order.Status != OrderStatus_ORDER_STATUS_CANCELLED // ERROR: undefined } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::migration-strategy::24","title":"ENUM_VALUE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate enum values first:**","content":"Migration Strategy **Deprecate enum values first:**"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::migration-strategy::25","title":"ENUM_VALUE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Stop using deprecated values** in new code:","content":"Migration Strategy **Stop using deprecated values** in new code:"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::migration-strategy::26","title":"ENUM_VALUE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update client code** to handle deprecated values gracefully:","content":"Migration Strategy **Update client code** to handle deprecated values gracefully:"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::migration-strategy::27","title":"ENUM_VALUE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Reserve the values** after sufficient migration period:","content":"Migration Strategy **Reserve the values** after sufficient migration period:"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::migration-strategy::28","title":"ENUM_VALUE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Never reuse enum numbers** - they must remain reserved permanently","content":"Migration Strategy **Never reuse enum numbers** - they must remain reserved permanently"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::proto2-vs-proto3-behavior::29","title":"ENUM_VALUE_NO_DELETE","section":"Proto2 vs Proto3 Behavior","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#proto2-vs-proto3-behavior","headings":["Proto2 vs Proto3 Behavior"],"excerpt":"Proto2 vs Proto3 Behavior ```proto // Proto2: Unknown enum values are preserved in unknown fields // Proto3: Unknown enum values are preserved as-is // Both cases: Don't delete values that might exist in stored data","content":"Proto2 vs Proto3 Behavior ```proto // Proto2: Unknown enum values are preserved in unknown fields // Proto3: Unknown enum values are preserved as-is // Both cases: Don't delete values that might exist in stored data"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::proto2-vs-proto3-behavior::30","title":"ENUM_VALUE_NO_DELETE","section":"Proto2 vs Proto3 Behavior","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#proto2-vs-proto3-behavior","headings":["Proto2 vs Proto3 Behavior"],"excerpt":"Proto2 vs Proto3 Behavior // Safe approach for both syntax versions: enum MyEnum { MY_ENUM_UNSPECIFIED = 0; MY_ENUM_VALUE_OLD = 1 [deprecated = true]; // Don't delete MY_ENUM_VALUE_NEW = 2; } ```","content":"Proto2 vs Proto3 Behavior // Safe approach for both syntax versions: enum MyEnum { MY_ENUM_UNSPECIFIED = 0; MY_ENUM_VALUE_OLD = 1 [deprecated = true]; // Don't delete MY_ENUM_VALUE_NEW = 2; } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::0","title":"ENUM_VALUE_SAME_NAME","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":[],"excerpt":"This rule checks that enum values maintain the same name for each number. Changing an enum value's name (while keeping the same number) breaks both JSON compatibility and generated code, as clients expect specific consta","content":"This rule checks that enum values maintain the same name for each number. Changing an enum value's name (while keeping the same number) breaks both JSON compatibility and generated code, as clients expect specific constant names."},{"id":"cli/breaking-changes/rules/enum-value-same-name::bad::1","title":"ENUM_VALUE_SAME_NAME","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-same-name::bad::2","title":"ENUM_VALUE_SAME_NAME","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#bad","headings":["Bad"],"excerpt":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; } ```","content":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::bad::3","title":"ENUM_VALUE_SAME_NAME","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-same-name::bad::4","title":"ENUM_VALUE_SAME_NAME","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#bad","headings":["Bad"],"excerpt":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_APPROVED = 2; // [!code --] Changed from ORDER_STATUS_CONFIRMED ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_COMPLETED = 4; // [!code ","content":"Bad enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_APPROVED = 2; // [!code --] Changed from ORDER_STATUS_CONFIRMED ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_COMPLETED = 4; // [!code --] Changed from ORDER_STATUS_DELIVERED } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::more-examples::5","title":"ENUM_VALUE_SAME_NAME","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#more-examples","headings":["More Examples"],"excerpt":"More Examples **Multiple renames breaking clients:**","content":"More Examples **Multiple renames breaking clients:**"},{"id":"cli/breaking-changes/rules/enum-value-same-name::more-examples::6","title":"ENUM_VALUE_SAME_NAME","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_MODERATOR = 2; USER_ROLE_USER = 3; }","content":"More Examples ```proto // Before enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_MODERATOR = 2; USER_ROLE_USER = 3; }"},{"id":"cli/breaking-changes/rules/enum-value-same-name::more-examples::7","title":"ENUM_VALUE_SAME_NAME","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - ALL BREAKING CHANGES! enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMINISTRATOR = 1; // BREAKING: ADMIN -> ADMINISTRATOR USER_ROLE_MOD = 2; // BREAKING: MODERATOR -> MOD USER_ROLE_MEMBER","content":"More Examples // After - ALL BREAKING CHANGES! enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMINISTRATOR = 1; // BREAKING: ADMIN -> ADMINISTRATOR USER_ROLE_MOD = 2; // BREAKING: MODERATOR -> MOD USER_ROLE_MEMBER = 3; // BREAKING: USER -> MEMBER } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::good::8","title":"ENUM_VALUE_SAME_NAME","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#good","headings":["Good"],"excerpt":"Good **Instead of renaming, add new values and deprecate old ones:** ```proto syntax = \"proto3\";","content":"Good **Instead of renaming, add new values and deprecate old ones:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-same-name::good::9","title":"ENUM_VALUE_SAME_NAME","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#good","headings":["Good"],"excerpt":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2 [deprecated = true]; // [!code focus] ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4 [deprecated = true]; /","content":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2 [deprecated = true]; // [!code focus] ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4 [deprecated = true]; // [!code focus] ORDER_STATUS_APPROVED = 5; // [!code focus] // New value instead of renaming ORDER_STATUS_COMPLETED = 6; // [!code focus] // New value instead of renaming } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::good::10","title":"ENUM_VALUE_SAME_NAME","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#good","headings":["Good"],"excerpt":"Good **Or create a new enum version:** ```proto syntax = \"proto3\";","content":"Good **Or create a new enum version:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-same-name::good::11","title":"ENUM_VALUE_SAME_NAME","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#good","headings":["Good"],"excerpt":"Good package myapi.v2; // [!code focus] // New package version","content":"Good package myapi.v2; // [!code focus] // New package version"},{"id":"cli/breaking-changes/rules/enum-value-same-name::good::12","title":"ENUM_VALUE_SAME_NAME","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#good","headings":["Good"],"excerpt":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_APPROVED = 2; // [!code focus] // Clean names in v2 ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_COMPLETED = 4; // [!code focus] } ``","content":"Good enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_APPROVED = 2; // [!code focus] // Clean names in v2 ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_COMPLETED = 4; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::impact::13","title":"ENUM_VALUE_SAME_NAME","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#impact","headings":["Impact"],"excerpt":"Impact **Generated Code:** Constant names change, breaking client compilation **JSON Compatibility:** JSON serialization uses enum names, breaking parsers **Client Applications:** Code referencing old constant names fail","content":"Impact **Generated Code:** Constant names change, breaking client compilation **JSON Compatibility:** JSON serialization uses enum names, breaking parsers **Client Applications:** Code referencing old constant names fails to compile **Documentation:** API docs become outdated with wrong enum names"},{"id":"cli/breaking-changes/rules/enum-value-same-name::real-world-example::14","title":"ENUM_VALUE_SAME_NAME","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // handle delivery }","content":"Real-World Example **Client code breaks:** ```go // Before - this code works status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // handle delivery }"},{"id":"cli/breaking-changes/rules/enum-value-same-name::real-world-example::15","title":"ENUM_VALUE_SAME_NAME","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After rename - compilation fails status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED // ERROR: undefined constant if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // ERROR: undefined con","content":"Real-World Example // After rename - compilation fails status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED // ERROR: undefined constant if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // ERROR: undefined constant // handle delivery } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::real-world-example::16","title":"ENUM_VALUE_SAME_NAME","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **JSON compatibility breaks:** ```json // Before - JSON uses old names { \"status\": \"ORDER_STATUS_CONFIRMED\" }","content":"Real-World Example **JSON compatibility breaks:** ```json // Before - JSON uses old names { \"status\": \"ORDER_STATUS_CONFIRMED\" }"},{"id":"cli/breaking-changes/rules/enum-value-same-name::real-world-example::17","title":"ENUM_VALUE_SAME_NAME","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After - parser expects new names { \"status\": \"ORDER_STATUS_APPROVED\" // Old JSON fails to parse } ```","content":"Real-World Example // After - parser expects new names { \"status\": \"ORDER_STATUS_APPROVED\" // Old JSON fails to parse } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::migration-strategy::18","title":"ENUM_VALUE_SAME_NAME","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Add new enum values** instead of renaming:","content":"Migration Strategy **Add new enum values** instead of renaming:"},{"id":"cli/breaking-changes/rules/enum-value-same-name::migration-strategy::19","title":"ENUM_VALUE_SAME_NAME","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update server code** to handle both old and new values during transition","content":"Migration Strategy **Update server code** to handle both old and new values during transition"},{"id":"cli/breaking-changes/rules/enum-value-same-name::migration-strategy::20","title":"ENUM_VALUE_SAME_NAME","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Migrate clients** to use new enum values","content":"Migration Strategy **Migrate clients** to use new enum values"},{"id":"cli/breaking-changes/rules/enum-value-same-name::migration-strategy::21","title":"ENUM_VALUE_SAME_NAME","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove deprecated values** in next major version:","content":"Migration Strategy **Remove deprecated values** in next major version:"},{"id":"cli/breaking-changes/rules/enum-value-same-name::allow-alias-exception::22","title":"ENUM_VALUE_SAME_NAME","section":"Allow Alias Exception","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#allow-alias-exception","headings":["Allow Alias Exception"],"excerpt":"Allow Alias Exception With allow_alias = true, you can temporarily have multiple names for the same value:","content":"Allow Alias Exception With allow_alias = true, you can temporarily have multiple names for the same value:"},{"id":"cli/breaking-changes/rules/enum-value-same-name::allow-alias-exception::23","title":"ENUM_VALUE_SAME_NAME","section":"Allow Alias Exception","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#allow-alias-exception","headings":["Allow Alias Exception"],"excerpt":"Allow Alias Exception Note: EasyP currently detects this as breaking even with allow_alias. This may be refined in future versions.","content":"Allow Alias Exception Note: EasyP currently detects this as breaking even with allow_alias. This may be refined in future versions."},{"id":"cli/breaking-changes/rules/field-no-delete::top::0","title":"FIELD_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":[],"excerpt":"This rule checks that no message fields are deleted. Deleting a field breaks both wire format compatibility and generated code, as existing data may contain the deleted field and client code may reference it.","content":"This rule checks that no message fields are deleted. Deleting a field breaks both wire format compatibility and generated code, as existing data may contain the deleted field and client code may reference it."},{"id":"cli/breaking-changes/rules/field-no-delete::bad::1","title":"FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-no-delete::bad::2","title":"FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#bad","headings":["Bad"],"excerpt":"Bad message User { string name = 1; string email = 2; int32 age = 3; string phone = 4; // [!code --] } ```","content":"Bad message User { string name = 1; string email = 2; int32 age = 3; string phone = 4; // [!code --] } ```"},{"id":"cli/breaking-changes/rules/field-no-delete::bad::3","title":"FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-no-delete::bad::4","title":"FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#bad","headings":["Bad"],"excerpt":"Bad message User { string name = 1; string email = 2; int32 age = 3; // phone field was deleted - BREAKING CHANGE! } ```","content":"Bad message User { string name = 1; string email = 2; int32 age = 3; // phone field was deleted - BREAKING CHANGE! } ```"},{"id":"cli/breaking-changes/rules/field-no-delete::good::5","title":"FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, deprecate the field:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, deprecate the field:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-no-delete::good::6","title":"FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#good","headings":["Good"],"excerpt":"Good message User { string name = 1; string email = 2; int32 age = 3; string phone = 4 [deprecated = true]; // [!code focus] } ```","content":"Good message User { string name = 1; string email = 2; int32 age = 3; string phone = 4 [deprecated = true]; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/field-no-delete::good::7","title":"FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#good","headings":["Good"],"excerpt":"Good **Or reserve the field number after removal:** ```proto syntax = \"proto3\";","content":"Good **Or reserve the field number after removal:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-no-delete::good::8","title":"FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#good","headings":["Good"],"excerpt":"Good message User { reserved 4; // [!code focus] reserved \"phone\"; // [!code focus] string name = 1; string email = 2; int32 age = 3; } ```","content":"Good message User { reserved 4; // [!code focus] reserved \"phone\"; // [!code focus] string name = 1; string email = 2; int32 age = 3; } ```"},{"id":"cli/breaking-changes/rules/field-no-delete::impact::9","title":"FIELD_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Old messages with the deleted field cannot be properly deserialized **Generated Code:** Field accessors are removed, breaking client compilation **Data Loss:** Existing serialized data loses infor","content":"Impact **Wire Format:** Old messages with the deleted field cannot be properly deserialized **Generated Code:** Field accessors are removed, breaking client compilation **Data Loss:** Existing serialized data loses information **JSON Compatibility:** JSON parsers expect the field to exist"},{"id":"cli/breaking-changes/rules/field-no-delete::migration-strategy::10","title":"FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate first:**","content":"Migration Strategy **Deprecate first:**"},{"id":"cli/breaking-changes/rules/field-no-delete::migration-strategy::11","title":"FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Stop writing to the field** in your application code","content":"Migration Strategy **Stop writing to the field** in your application code"},{"id":"cli/breaking-changes/rules/field-no-delete::migration-strategy::12","title":"FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Reserve the field** in next version to prevent accidental reuse:","content":"Migration Strategy **Reserve the field** in next version to prevent accidental reuse:"},{"id":"cli/breaking-changes/rules/field-no-delete::migration-strategy::13","title":"FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Never reuse field numbers** - they must remain reserved permanently","content":"Migration Strategy **Never reuse field numbers** - they must remain reserved permanently"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::0","title":"FIELD_SAME_CARDINALITY","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":[],"excerpt":"This rule checks that message fields maintain the same cardinality (optionality). Changing a field's cardinality breaks both wire format compatibility and generated code, as the presence semantics and client code expecta","content":"This rule checks that message fields maintain the same cardinality (optionality). Changing a field's cardinality breaks both wire format compatibility and generated code, as the presence semantics and client code expectations differ between optional and required fields."},{"id":"cli/breaking-changes/rules/field-same-cardinality::bad::1","title":"FIELD_SAME_CARDINALITY","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::bad::2","title":"FIELD_SAME_CARDINALITY","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#bad","headings":["Bad"],"excerpt":"Bad message User { string name = 1; string email = 2; int32 age = 3; }","content":"Bad message User { string name = 1; string email = 2; int32 age = 3; }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::bad::3","title":"FIELD_SAME_CARDINALITY","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#bad","headings":["Bad"],"excerpt":"Bad message CreateUserRequest { string name = 1; optional string email = 2; string phone = 3; } ```","content":"Bad message CreateUserRequest { string name = 1; optional string email = 2; string phone = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::bad::4","title":"FIELD_SAME_CARDINALITY","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::bad::5","title":"FIELD_SAME_CARDINALITY","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#bad","headings":["Bad"],"excerpt":"Bad message User { string name = 1; optional string email = 2; // [!code --] Changed from required to optional int32 age = 3; }","content":"Bad message User { string name = 1; optional string email = 2; // [!code --] Changed from required to optional int32 age = 3; }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::bad::6","title":"FIELD_SAME_CARDINALITY","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#bad","headings":["Bad"],"excerpt":"Bad message CreateUserRequest { string name = 1; string email = 2; // [!code --] Changed from optional to required string phone = 3; } ```","content":"Bad message CreateUserRequest { string name = 1; string email = 2; // [!code --] Changed from optional to required string phone = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::more-examples::7","title":"FIELD_SAME_CARDINALITY","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#more-examples","headings":["More Examples"],"excerpt":"More Examples **Proto2 to Proto3 migration issues:**","content":"More Examples **Proto2 to Proto3 migration issues:**"},{"id":"cli/breaking-changes/rules/field-same-cardinality::more-examples::8","title":"FIELD_SAME_CARDINALITY","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before (proto2) syntax = \"proto2\";","content":"More Examples ```proto // Before (proto2) syntax = \"proto2\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::more-examples::9","title":"FIELD_SAME_CARDINALITY","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#more-examples","headings":["More Examples"],"excerpt":"More Examples message Order { required string id = 1; optional string notes = 2; repeated string tags = 3; }","content":"More Examples message Order { required string id = 1; optional string notes = 2; repeated string tags = 3; }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::more-examples::10","title":"FIELD_SAME_CARDINALITY","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#more-examples","headings":["More Examples"],"excerpt":"More Examples // After (proto3) - BREAKING CHANGES! syntax = \"proto3\";","content":"More Examples // After (proto3) - BREAKING CHANGES! syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::more-examples::11","title":"FIELD_SAME_CARDINALITY","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#more-examples","headings":["More Examples"],"excerpt":"More Examples message Order { string id = 1; // BREAKING: required -> implicit optional string notes = 2; // BREAKING: explicit optional -> implicit optional repeated string tags = 3; // OK: repeated unchanged } ```","content":"More Examples message Order { string id = 1; // BREAKING: required -> implicit optional string notes = 2; // BREAKING: explicit optional -> implicit optional repeated string tags = 3; // OK: repeated unchanged } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::good::12","title":"FIELD_SAME_CARDINALITY","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#good","headings":["Good"],"excerpt":"Good **Instead of changing cardinality, add new field:** ```proto syntax = \"proto3\";","content":"Good **Instead of changing cardinality, add new field:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::good::13","title":"FIELD_SAME_CARDINALITY","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#good","headings":["Good"],"excerpt":"Good message User { string name = 1; string email = 2 [deprecated = true]; // [!code focus] // Keep original cardinality int32 age = 3; optional string email_optional = 4; // [!code focus] // New field with desired cardi","content":"Good message User { string name = 1; string email = 2 [deprecated = true]; // [!code focus] // Keep original cardinality int32 age = 3; optional string email_optional = 4; // [!code focus] // New field with desired cardinality }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::good::14","title":"FIELD_SAME_CARDINALITY","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#good","headings":["Good"],"excerpt":"Good message CreateUserRequest { string name = 1; optional string email = 2 [deprecated = true]; // [!code focus] // Keep original cardinality string phone = 3; string email_required = 4; // [!code focus] // New field wi","content":"Good message CreateUserRequest { string name = 1; optional string email = 2 [deprecated = true]; // [!code focus] // Keep original cardinality string phone = 3; string email_required = 4; // [!code focus] // New field with desired cardinality } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::good::15","title":"FIELD_SAME_CARDINALITY","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#good","headings":["Good"],"excerpt":"Good **Or create a new message version:** ```proto syntax = \"proto3\";","content":"Good **Or create a new message version:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::good::16","title":"FIELD_SAME_CARDINALITY","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#good","headings":["Good"],"excerpt":"Good package myapi.v2; // [!code focus] // New package version","content":"Good package myapi.v2; // [!code focus] // New package version"},{"id":"cli/breaking-changes/rules/field-same-cardinality::good::17","title":"FIELD_SAME_CARDINALITY","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#good","headings":["Good"],"excerpt":"Good message User { string name = 1; optional string email = 2; // [!code focus] // Clean cardinality in v2 int32 age = 3; }","content":"Good message User { string name = 1; optional string email = 2; // [!code focus] // Clean cardinality in v2 int32 age = 3; }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::good::18","title":"FIELD_SAME_CARDINALITY","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#good","headings":["Good"],"excerpt":"Good message CreateUserRequest { string name = 1; string email = 2; // [!code focus] // Required in v2 string phone = 3; } ```","content":"Good message CreateUserRequest { string name = 1; string email = 2; // [!code focus] // Required in v2 string phone = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::impact::19","title":"FIELD_SAME_CARDINALITY","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Field presence semantics change, breaking deserialization expectations **Generated Code:** Field accessor methods change (hasField(), clearField()) **Validation:** Required field validation change","content":"Impact **Wire Format:** Field presence semantics change, breaking deserialization expectations **Generated Code:** Field accessor methods change (hasField(), clearField()) **Validation:** Required field validation changes at runtime **Default Values:** Optional vs required fields handle defaults differently"},{"id":"cli/breaking-changes/rules/field-same-cardinality::real-world-example::20","title":"FIELD_SAME_CARDINALITY","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks with cardinality changes:** ```go // Before - required field (proto3 implicit) user := &myapi.User{ Name: \"John\", Email: \"john@example.com\", // Must be set Age: 30, }","content":"Real-World Example **Client code breaks with cardinality changes:** ```go // Before - required field (proto3 implicit) user := &myapi.User{ Name: \"John\", Email: \"john@example.com\", // Must be set Age: 30, }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::real-world-example::21","title":"FIELD_SAME_CARDINALITY","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Check if email is set (implicit presence) if user.Email != \"\" { // Email is provided }","content":"Real-World Example // Check if email is set (implicit presence) if user.Email != \"\" { // Email is provided }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::real-world-example::22","title":"FIELD_SAME_CARDINALITY","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After - optional field (explicit presence) user := &myapi.User{ Name: \"John\", Age: 30, // Email can be nil/unset }","content":"Real-World Example // After - optional field (explicit presence) user := &myapi.User{ Name: \"John\", Age: 30, // Email can be nil/unset }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::real-world-example::23","title":"FIELD_SAME_CARDINALITY","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Check if email is set (explicit presence) if user.Email != nil && *user.Email != \"\" { // Different API! // Email is provided }","content":"Real-World Example // Check if email is set (explicit presence) if user.Email != nil && *user.Email != \"\" { // Different API! // Email is provided }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::real-world-example::24","title":"FIELD_SAME_CARDINALITY","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Setting email also changes user.Email = &emailValue // Pointer assignment vs direct ```","content":"Real-World Example // Setting email also changes user.Email = &emailValue // Pointer assignment vs direct ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::real-world-example::25","title":"FIELD_SAME_CARDINALITY","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server validation breaks:** ```go // Before - implicit required field func validateUser(user *User) error { if user.Email == \"\" { // Empty string check return errors.New(\"email is required\") } return","content":"Real-World Example **Server validation breaks:** ```go // Before - implicit required field func validateUser(user *User) error { if user.Email == \"\" { // Empty string check return errors.New(\"email is required\") } return nil }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::real-world-example::26","title":"FIELD_SAME_CARDINALITY","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After - explicit optional field func validateUser(user *User) error { if user.Email == nil { // Nil pointer check return errors.New(\"email is required\") } if *user.Email == \"\" { // Dereference to ch","content":"Real-World Example // After - explicit optional field func validateUser(user *User) error { if user.Email == nil { // Nil pointer check return errors.New(\"email is required\") } if *user.Email == \"\" { // Dereference to check empty return errors.New(\"email cannot be empty\") } return nil } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::migration-strategy::27","title":"FIELD_SAME_CARDINALITY","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Add new field** with correct cardinality:","content":"Migration Strategy **Add new field** with correct cardinality:"},{"id":"cli/breaking-changes/rules/field-same-cardinality::migration-strategy::28","title":"FIELD_SAME_CARDINALITY","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Dual-write period** - populate both fields during transition:","content":"Migration Strategy **Dual-write period** - populate both fields during transition:"},{"id":"cli/breaking-changes/rules/field-same-cardinality::migration-strategy::29","title":"FIELD_SAME_CARDINALITY","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update clients** to use new field gradually:","content":"Migration Strategy **Update clients** to use new field gradually:"},{"id":"cli/breaking-changes/rules/field-same-cardinality::migration-strategy::30","title":"FIELD_SAME_CARDINALITY","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove old field** in next major version:","content":"Migration Strategy **Remove old field** in next major version:"},{"id":"cli/breaking-changes/rules/field-same-cardinality::proto2-to-proto3-migration::31","title":"FIELD_SAME_CARDINALITY","section":"Proto2 to Proto3 Migration","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#proto2-to-proto3-migration","headings":["Proto2 to Proto3 Migration"],"excerpt":"Proto2 to Proto3 Migration ```proto // Instead of direct syntax migration syntax = \"proto3\"; message Order { string id = 1; // BREAKING: was required in proto2 }","content":"Proto2 to Proto3 Migration ```proto // Instead of direct syntax migration syntax = \"proto3\"; message Order { string id = 1; // BREAKING: was required in proto2 }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::proto2-to-proto3-migration::32","title":"FIELD_SAME_CARDINALITY","section":"Proto2 to Proto3 Migration","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#proto2-to-proto3-migration","headings":["Proto2 to Proto3 Migration"],"excerpt":"Proto2 to Proto3 Migration // Maintain semantics during migration syntax = \"proto3\"; message Order { string id = 1; // Keep as implicit required // Add explicit optional fields only when needed optional string notes = 2;","content":"Proto2 to Proto3 Migration // Maintain semantics during migration syntax = \"proto3\"; message Order { string id = 1; // Keep as implicit required // Add explicit optional fields only when needed optional string notes = 2; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::making-optional-fields-required::33","title":"FIELD_SAME_CARDINALITY","section":"Making Optional Fields Required","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#making-optional-fields-required","headings":["Making Optional Fields Required"],"excerpt":"Making Optional Fields Required ```proto // Instead of changing existing field message CreateUserRequest { string name = 1; string email = 2; // BREAKING: was optional }","content":"Making Optional Fields Required ```proto // Instead of changing existing field message CreateUserRequest { string name = 1; string email = 2; // BREAKING: was optional }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::making-optional-fields-required::34","title":"FIELD_SAME_CARDINALITY","section":"Making Optional Fields Required","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#making-optional-fields-required","headings":["Making Optional Fields Required"],"excerpt":"Making Optional Fields Required // Add new required field message CreateUserRequest { string name = 1; optional string email = 2 [deprecated = true]; string required_email = 3; // New required field } ```","content":"Making Optional Fields Required // Add new required field message CreateUserRequest { string name = 1; optional string email = 2 [deprecated = true]; string required_email = 3; // New required field } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::making-required-fields-optional::35","title":"FIELD_SAME_CARDINALITY","section":"Making Required Fields Optional","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#making-required-fields-optional","headings":["Making Required Fields Optional"],"excerpt":"Making Required Fields Optional ```proto // Instead of changing existing field message User { optional string phone = 3; // BREAKING: was required }","content":"Making Required Fields Optional ```proto // Instead of changing existing field message User { optional string phone = 3; // BREAKING: was required }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::making-required-fields-optional::36","title":"FIELD_SAME_CARDINALITY","section":"Making Required Fields Optional","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#making-required-fields-optional","headings":["Making Required Fields Optional"],"excerpt":"Making Required Fields Optional // Add new optional field message User { string phone = 3 [deprecated = true]; // Keep required optional string phone_optional = 4; // New optional field } ```","content":"Making Required Fields Optional // Add new optional field message User { string phone = 3 [deprecated = true]; // Keep required optional string phone_optional = 4; // New optional field } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::proto3-cardinality::37","title":"FIELD_SAME_CARDINALITY","section":"Proto3 Cardinality","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#proto3-cardinality","headings":["Proto3 Cardinality"],"excerpt":"Proto3 Cardinality **Implicit optional**: string name = 1; (default in proto3) **Explicit optional**: optional string email = 2; **Repeated**: repeated string tags = 3; **Map**: map metadata = 4;","content":"Proto3 Cardinality **Implicit optional**: string name = 1; (default in proto3) **Explicit optional**: optional string email = 2; **Repeated**: repeated string tags = 3; **Map**: map metadata = 4;"},{"id":"cli/breaking-changes/rules/field-same-cardinality::proto2-cardinality::38","title":"FIELD_SAME_CARDINALITY","section":"Proto2 Cardinality","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#proto2-cardinality","headings":["Proto2 Cardinality"],"excerpt":"Proto2 Cardinality **Required**: required string id = 1; **Optional**: optional string email = 2; **Repeated**: repeated string tags = 3;","content":"Proto2 Cardinality **Required**: required string id = 1; **Optional**: optional string email = 2; **Repeated**: repeated string tags = 3;"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking-changes-matrix::39","title":"FIELD_SAME_CARDINALITY","section":"Breaking Changes Matrix","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking-changes-matrix","headings":["Breaking Changes Matrix"],"excerpt":"Breaking Changes Matrix From To Result ------ ---- --------- Required Optional ❌ BREAKING Optional Required ❌ BREAKING Implicit Explicit ❌ BREAKING Explicit Implicit ❌ BREAKING Single Repeated ❌ BREAKING Repeated Single ","content":"Breaking Changes Matrix From To Result ------ ---- --------- Required Optional ❌ BREAKING Optional Required ❌ BREAKING Implicit Explicit ❌ BREAKING Explicit Implicit ❌ BREAKING Single Repeated ❌ BREAKING Repeated Single ❌ BREAKING Field Map ❌ BREAKING Map Field ❌ BREAKING"},{"id":"cli/breaking-changes/rules/field-same-type::top::0","title":"FIELD_SAME_TYPE","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":[],"excerpt":"This rule checks that message fields maintain the same type. Changing a field's type breaks wire format compatibility and generated code, as the binary representation and client code expectations differ between types.","content":"This rule checks that message fields maintain the same type. Changing a field's type breaks wire format compatibility and generated code, as the binary representation and client code expectations differ between types."},{"id":"cli/breaking-changes/rules/field-same-type::bad::1","title":"FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-type::bad::2","title":"FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#bad","headings":["Bad"],"excerpt":"Bad message Product { string name = 1; int32 price = 2; bool available = 3; } ```","content":"Bad message Product { string name = 1; int32 price = 2; bool available = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-type::bad::3","title":"FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-type::bad::4","title":"FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#bad","headings":["Bad"],"excerpt":"Bad message Product { string name = 1; string price = 2; // [!code --] Changed from int32 to string bool available = 3; } ```","content":"Bad message Product { string name = 1; string price = 2; // [!code --] Changed from int32 to string bool available = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-type::more-examples::5","title":"FIELD_SAME_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#more-examples","headings":["More Examples"],"excerpt":"More Examples **Incompatible type changes:**","content":"More Examples **Incompatible type changes:**"},{"id":"cli/breaking-changes/rules/field-same-type::more-examples::6","title":"FIELD_SAME_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before message Order { string id = 1; int64 timestamp = 2; repeated string tags = 3; OrderStatus status = 4; }","content":"More Examples ```proto // Before message Order { string id = 1; int64 timestamp = 2; repeated string tags = 3; OrderStatus status = 4; }"},{"id":"cli/breaking-changes/rules/field-same-type::more-examples::7","title":"FIELD_SAME_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - ALL BREAKING CHANGES! message Order { int32 id = 1; // string -> int32: BREAKING string timestamp = 2; // int64 -> string: BREAKING string tags = 3; // repeated -> singular: BREAKING int32 status","content":"More Examples // After - ALL BREAKING CHANGES! message Order { int32 id = 1; // string -> int32: BREAKING string timestamp = 2; // int64 -> string: BREAKING string tags = 3; // repeated -> singular: BREAKING int32 status = 4; // enum -> int32: BREAKING } ```"},{"id":"cli/breaking-changes/rules/field-same-type::good::8","title":"FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#good","headings":["Good"],"excerpt":"Good **Instead of changing type, add a new field:** ```proto syntax = \"proto3\";","content":"Good **Instead of changing type, add a new field:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-type::good::9","title":"FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#good","headings":["Good"],"excerpt":"Good message Product { string name = 1; int32 price = 2 [deprecated = true]; // [!code focus] bool available = 3; string price_formatted = 4; // [!code focus] // New field for string price } ```","content":"Good message Product { string name = 1; int32 price = 2 [deprecated = true]; // [!code focus] bool available = 3; string price_formatted = 4; // [!code focus] // New field for string price } ```"},{"id":"cli/breaking-changes/rules/field-same-type::good::10","title":"FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#good","headings":["Good"],"excerpt":"Good **Or create a new message version:** ```proto syntax = \"proto3\";","content":"Good **Or create a new message version:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-type::good::11","title":"FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#good","headings":["Good"],"excerpt":"Good package myapi.v2; // [!code focus] // New package version","content":"Good package myapi.v2; // [!code focus] // New package version"},{"id":"cli/breaking-changes/rules/field-same-type::good::12","title":"FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#good","headings":["Good"],"excerpt":"Good message Product { string name = 1; string price = 2; // [!code focus] // Now string in v2 bool available = 3; } ```","content":"Good message Product { string name = 1; string price = 2; // [!code focus] // Now string in v2 bool available = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-type::impact::13","title":"FIELD_SAME_TYPE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Binary data cannot be deserialized correctly between versions **Generated Code:** Field types change, breaking client compilation **Runtime Errors:** Type mismatches cause parsing failures **Data ","content":"Impact **Wire Format:** Binary data cannot be deserialized correctly between versions **Generated Code:** Field types change, breaking client compilation **Runtime Errors:** Type mismatches cause parsing failures **Data Corruption:** Incorrect interpretation of binary data"},{"id":"cli/breaking-changes/rules/field-same-type::migration-strategy::14","title":"FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Add new field** with correct type:","content":"Migration Strategy **Add new field** with correct type:"},{"id":"cli/breaking-changes/rules/field-same-type::migration-strategy::15","title":"FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Dual-write period** - populate both fields during transition","content":"Migration Strategy **Dual-write period** - populate both fields during transition"},{"id":"cli/breaking-changes/rules/field-same-type::migration-strategy::16","title":"FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update clients** to use new field","content":"Migration Strategy **Update clients** to use new field"},{"id":"cli/breaking-changes/rules/field-same-type::migration-strategy::17","title":"FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove old field** in next major version:","content":"Migration Strategy **Remove old field** in next major version:"},{"id":"cli/breaking-changes/rules/field-same-type::safe-type-changes-wire-compatible::18","title":"FIELD_SAME_TYPE","section":"Safe Type Changes (Wire Compatible)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#safe-type-changes-wire-compatible","headings":["Safe Type Changes (Wire Compatible)"],"excerpt":"Safe Type Changes (Wire Compatible) Note: EasyP currently treats ALL type changes as breaking. However, some changes are technically wire-compatible:","content":"Safe Type Changes (Wire Compatible) Note: EasyP currently treats ALL type changes as breaking. However, some changes are technically wire-compatible:"},{"id":"cli/breaking-changes/rules/field-same-type::safe-type-changes-wire-compatible::19","title":"FIELD_SAME_TYPE","section":"Safe Type Changes (Wire Compatible)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#safe-type-changes-wire-compatible","headings":["Safe Type Changes (Wire Compatible)"],"excerpt":"Safe Type Changes (Wire Compatible) int32 ↔ uint32 (same encoding) int64 ↔ uint64 (same encoding) string → bytes (if UTF-8 valid)","content":"Safe Type Changes (Wire Compatible) int32 ↔ uint32 (same encoding) int64 ↔ uint64 (same encoding) string → bytes (if UTF-8 valid)"},{"id":"cli/breaking-changes/rules/field-same-type::safe-type-changes-wire-compatible::20","title":"FIELD_SAME_TYPE","section":"Safe Type Changes (Wire Compatible)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#safe-type-changes-wire-compatible","headings":["Safe Type Changes (Wire Compatible)"],"excerpt":"Safe Type Changes (Wire Compatible) These may be supported in future EasyP versions with different strictness levels.","content":"Safe Type Changes (Wire Compatible) These may be supported in future EasyP versions with different strictness levels."},{"id":"cli/breaking-changes/rules/import-no-delete::top::0","title":"IMPORT_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":[],"excerpt":"This rule checks that no import statements are deleted from proto files. Deleting an import breaks both wire format compatibility and generated code, as the imported types may be referenced in the current file and removi","content":"This rule checks that no import statements are deleted from proto files. Deleting an import breaks both wire format compatibility and generated code, as the imported types may be referenced in the current file and removing the import makes those types unavailable."},{"id":"cli/breaking-changes/rules/import-no-delete::bad::1","title":"IMPORT_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/import-no-delete::bad::2","title":"IMPORT_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#bad","headings":["Bad"],"excerpt":"Bad import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; import \"common/user.proto\"; import \"common/address.proto\";","content":"Bad import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; import \"common/user.proto\"; import \"common/address.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::bad::3","title":"IMPORT_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3; common.User customer = 4; common.Address shipping_address = 5; } ```","content":"Bad message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3; common.User customer = 4; common.Address shipping_address = 5; } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::bad::4","title":"IMPORT_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/import-no-delete::bad::5","title":"IMPORT_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#bad","headings":["Bad"],"excerpt":"Bad import \"google/protobuf/timestamp.proto\"; // import \"google/protobuf/duration.proto\"; // [!code --] Deleted import - BREAKING! // import \"common/user.proto\"; // [!code --] Deleted import - BREAKING! // import \"common","content":"Bad import \"google/protobuf/timestamp.proto\"; // import \"google/protobuf/duration.proto\"; // [!code --] Deleted import - BREAKING! // import \"common/user.proto\"; // [!code --] Deleted import - BREAKING! // import \"common/address.proto\"; // [!code --] Deleted import - BREAKING!"},{"id":"cli/breaking-changes/rules/import-no-delete::bad::6","title":"IMPORT_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3; // ERROR: Duration not available common.User customer = 4; // ERROR: User not available common.Ad","content":"Bad message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3; // ERROR: Duration not available common.User customer = 4; // ERROR: User not available common.Address shipping_address = 5; // ERROR: Address not available } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::more-examples::7","title":"IMPORT_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples **Service definition breaks with deleted imports:**","content":"More Examples **Service definition breaks with deleted imports:**"},{"id":"cli/breaking-changes/rules/import-no-delete::more-examples::8","title":"IMPORT_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before import \"google/api/annotations.proto\"; import \"google/protobuf/empty.proto\"; import \"common/auth.proto\";","content":"More Examples ```proto // Before import \"google/api/annotations.proto\"; import \"google/protobuf/empty.proto\"; import \"common/auth.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::more-examples::9","title":"IMPORT_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples service OrderService { rpc GetOrder(GetOrderRequest) returns (Order) { option (google.api.http) = { get: \"/v1/orders/{id}\" }; } rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty); }","content":"More Examples service OrderService { rpc GetOrder(GetOrderRequest) returns (Order) { option (google.api.http) = { get: \"/v1/orders/{id}\" }; } rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty); }"},{"id":"cli/breaking-changes/rules/import-no-delete::more-examples::10","title":"IMPORT_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - BREAKING CHANGES! // import \"google/api/annotations.proto\"; // BREAKING: deleted // import \"google/protobuf/empty.proto\"; // BREAKING: deleted // import \"common/auth.proto\"; // BREAKING: deleted","content":"More Examples // After - BREAKING CHANGES! // import \"google/api/annotations.proto\"; // BREAKING: deleted // import \"google/protobuf/empty.proto\"; // BREAKING: deleted // import \"common/auth.proto\"; // BREAKING: deleted"},{"id":"cli/breaking-changes/rules/import-no-delete::more-examples::11","title":"IMPORT_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples service OrderService { rpc GetOrder(GetOrderRequest) returns (Order) { option (google.api.http) = { // ERROR: annotations not available get: \"/v1/orders/{id}\" }; } rpc DeleteOrder(common.AuthRequest) return","content":"More Examples service OrderService { rpc GetOrder(GetOrderRequest) returns (Order) { option (google.api.http) = { // ERROR: annotations not available get: \"/v1/orders/{id}\" }; } rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty); // ERROR: types not available } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::good::12","title":"IMPORT_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, keep unused imports:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, keep unused imports:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/import-no-delete::good::13","title":"IMPORT_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#good","headings":["Good"],"excerpt":"Good import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; // [!code focus] // Keep even if unused import \"common/user.proto\"; // [!code focus] // Keep even if unused import \"common/address.p","content":"Good import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; // [!code focus] // Keep even if unused import \"common/user.proto\"; // [!code focus] // Keep even if unused import \"common/address.proto\"; // [!code focus] // Keep even if unused"},{"id":"cli/breaking-changes/rules/import-no-delete::good::14","title":"IMPORT_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#good","headings":["Good"],"excerpt":"Good message Order { string id = 1; google.protobuf.Timestamp created_at = 2; // Removed fields that used Duration, User, Address but kept imports } ```","content":"Good message Order { string id = 1; google.protobuf.Timestamp created_at = 2; // Removed fields that used Duration, User, Address but kept imports } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::good::15","title":"IMPORT_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#good","headings":["Good"],"excerpt":"Good **Or replace with equivalent types while keeping imports:** ```proto syntax = \"proto3\";","content":"Good **Or replace with equivalent types while keeping imports:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/import-no-delete::good::16","title":"IMPORT_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#good","headings":["Good"],"excerpt":"Good import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; // [!code focus] // Keep original import import \"common/user.proto\"; // [!code focus] // Keep original import import \"common/address","content":"Good import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; // [!code focus] // Keep original import import \"common/user.proto\"; // [!code focus] // Keep original import import \"common/address.proto\"; // [!code focus] // Keep original import import \"common/v2/user.proto\"; // [!code focus] // Add new import"},{"id":"cli/breaking-changes/rules/import-no-delete::good::17","title":"IMPORT_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#good","headings":["Good"],"excerpt":"Good message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3 [deprecated = true]; // [!code focus] // Keep old field common.User customer = 4 [deprecated = tr","content":"Good message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3 [deprecated = true]; // [!code focus] // Keep old field common.User customer = 4 [deprecated = true]; // [!code focus] // Keep old field common.Address shipping_address = 5 [deprecated = true]; // [!code focus] // Keep old field int32 processing_seconds = 6; // [!code focus] // New field instead of Duration common.v2.UserProfile customer_v2 = 7; // [!code focus] // New field with updated type string shipping_address_text = 8; // [!code focus] // New field with simpler type } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::impact::18","title":"IMPORT_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Generated Code:** Imported types become unavailable, breaking compilation **Wire Format:** Messages using imported types cannot be deserialized **Field References:** Any field using imported types becomes invali","content":"Impact **Generated Code:** Imported types become unavailable, breaking compilation **Wire Format:** Messages using imported types cannot be deserialized **Field References:** Any field using imported types becomes invalid **Service Definitions:** RPC methods using imported types break **Options Usage:** Custom options from imports become unavailable"},{"id":"cli/breaking-changes/rules/import-no-delete::real-world-example::19","title":"IMPORT_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works order := &myapi.Order{ Id: \"order123\", CreatedAt: timestamppb.New(time.Now()), // Uses google.protobuf.Timestamp Customer: &common.User{ // ERR","content":"Real-World Example **Client code breaks:** ```go // Before - this code works order := &myapi.Order{ Id: \"order123\", CreatedAt: timestamppb.New(time.Now()), // Uses google.protobuf.Timestamp Customer: &common.User{ // ERROR after import deletion Id: \"user456\", Name: \"John Doe\", }, ShippingAddress: &common.Address{ // ERROR after import deletion Street: \"123 Main St\", City: \"New York\", }, }"},{"id":"cli/breaking-changes/rules/import-no-delete::real-world-example::20","title":"IMPORT_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Generated code compilation fails: // undefined: common.User // undefined: common.Address ```","content":"Real-World Example // Generated code compilation fails: // undefined: common.User // undefined: common.Address ```"},{"id":"cli/breaking-changes/rules/import-no-delete::real-world-example::21","title":"IMPORT_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server implementation breaks:**","content":"Real-World Example **Server implementation breaks:**"},{"id":"cli/breaking-changes/rules/import-no-delete::real-world-example::22","title":"IMPORT_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Proto compilation breaks:**","content":"Real-World Example **Proto compilation breaks:**"},{"id":"cli/breaking-changes/rules/import-no-delete::migration-strategy::23","title":"IMPORT_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Keep imports even when unused:**","content":"Migration Strategy **Keep imports even when unused:**"},{"id":"cli/breaking-changes/rules/import-no-delete::migration-strategy::24","title":"IMPORT_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Add new imports alongside old ones:**","content":"Migration Strategy **Add new imports alongside old ones:**"},{"id":"cli/breaking-changes/rules/import-no-delete::migration-strategy::25","title":"IMPORT_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate fields using old imports gradually:**","content":"Migration Strategy **Deprecate fields using old imports gradually:**"},{"id":"cli/breaking-changes/rules/import-no-delete::migration-strategy::26","title":"IMPORT_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update server code** to handle both old and new fields:","content":"Migration Strategy **Update server code** to handle both old and new fields:"},{"id":"cli/breaking-changes/rules/import-no-delete::migration-strategy::27","title":"IMPORT_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Only remove imports in major version updates** after all fields are migrated","content":"Migration Strategy **Only remove imports in major version updates** after all fields are migrated"},{"id":"cli/breaking-changes/rules/import-no-delete::replacing-dependencies::28","title":"IMPORT_NO_DELETE","section":"Replacing Dependencies","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#replacing-dependencies","headings":["Replacing Dependencies"],"excerpt":"Replacing Dependencies ```proto // Instead of deleting old import immediately // import \"old/user.proto\"; // Don't delete!","content":"Replacing Dependencies ```proto // Instead of deleting old import immediately // import \"old/user.proto\"; // Don't delete!"},{"id":"cli/breaking-changes/rules/import-no-delete::replacing-dependencies::29","title":"IMPORT_NO_DELETE","section":"Replacing Dependencies","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#replacing-dependencies","headings":["Replacing Dependencies"],"excerpt":"Replacing Dependencies // Keep both during transition import \"old/user.proto\"; // Keep for backward compatibility import \"new/user.proto\"; // Add new dependency","content":"Replacing Dependencies // Keep both during transition import \"old/user.proto\"; // Keep for backward compatibility import \"new/user.proto\"; // Add new dependency"},{"id":"cli/breaking-changes/rules/import-no-delete::replacing-dependencies::30","title":"IMPORT_NO_DELETE","section":"Replacing Dependencies","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#replacing-dependencies","headings":["Replacing Dependencies"],"excerpt":"Replacing Dependencies message Order { old.User customer = 4 [deprecated = true]; new.UserProfile customer_v2 = 5; } ```","content":"Replacing Dependencies message Order { old.User customer = 4 [deprecated = true]; new.UserProfile customer_v2 = 5; } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::removing-unused-features::31","title":"IMPORT_NO_DELETE","section":"Removing Unused Features","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#removing-unused-features","headings":["Removing Unused Features"],"excerpt":"Removing Unused Features ```proto // Even if removing features, keep imports import \"feature/analytics.proto\"; // Keep even if analytics removed","content":"Removing Unused Features ```proto // Even if removing features, keep imports import \"feature/analytics.proto\"; // Keep even if analytics removed"},{"id":"cli/breaking-changes/rules/import-no-delete::removing-unused-features::32","title":"IMPORT_NO_DELETE","section":"Removing Unused Features","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#removing-unused-features","headings":["Removing Unused Features"],"excerpt":"Removing Unused Features message Order { string id = 1; // feature.AnalyticsData analytics = 2; // Field removed but import kept } ```","content":"Removing Unused Features message Order { string id = 1; // feature.AnalyticsData analytics = 2; // Field removed but import kept } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::protobuf-version-migration::33","title":"IMPORT_NO_DELETE","section":"Protobuf Version Migration","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#protobuf-version-migration","headings":["Protobuf Version Migration"],"excerpt":"Protobuf Version Migration ```proto // When migrating protobuf versions, keep old imports import \"google/protobuf/timestamp.proto\"; // Keep standard imports import \"google/protobuf/duration.proto\"; // Even if switching t","content":"Protobuf Version Migration ```proto // When migrating protobuf versions, keep old imports import \"google/protobuf/timestamp.proto\"; // Keep standard imports import \"google/protobuf/duration.proto\"; // Even if switching to alternatives"},{"id":"cli/breaking-changes/rules/import-no-delete::protobuf-version-migration::34","title":"IMPORT_NO_DELETE","section":"Protobuf Version Migration","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#protobuf-version-migration","headings":["Protobuf Version Migration"],"excerpt":"Protobuf Version Migration // Prefer keeping both old and new approaches message Event { google.protobuf.Timestamp timestamp = 1; // Keep old int64 timestamp_millis = 2; // Add alternative } ```","content":"Protobuf Version Migration // Prefer keeping both old and new approaches message Event { google.protobuf.Timestamp timestamp = 1; // Keep old int64 timestamp_millis = 2; // Add alternative } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::simplifying-dependencies::35","title":"IMPORT_NO_DELETE","section":"Simplifying Dependencies","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#simplifying-dependencies","headings":["Simplifying Dependencies"],"excerpt":"Simplifying Dependencies ```proto // Instead of removing complex type imports // import \"complex/config.proto\"; // Don't delete!","content":"Simplifying Dependencies ```proto // Instead of removing complex type imports // import \"complex/config.proto\"; // Don't delete!"},{"id":"cli/breaking-changes/rules/import-no-delete::simplifying-dependencies::36","title":"IMPORT_NO_DELETE","section":"Simplifying Dependencies","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#simplifying-dependencies","headings":["Simplifying Dependencies"],"excerpt":"Simplifying Dependencies // Keep complex import, add simple alternative import \"complex/config.proto\";","content":"Simplifying Dependencies // Keep complex import, add simple alternative import \"complex/config.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::simplifying-dependencies::37","title":"IMPORT_NO_DELETE","section":"Simplifying Dependencies","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#simplifying-dependencies","headings":["Simplifying Dependencies"],"excerpt":"Simplifying Dependencies message Settings { complex.ConfigData config = 1 [deprecated = true]; // Keep complex option string config_json = 2; // Add simple option } ```","content":"Simplifying Dependencies message Settings { complex.ConfigData config = 1 [deprecated = true]; // Keep complex option string config_json = 2; // Add simple option } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::import-deletion-vs-field-usage::38","title":"IMPORT_NO_DELETE","section":"Import Deletion vs Field Usage","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#import-deletion-vs-field-usage","headings":["Import Deletion vs Field Usage"],"excerpt":"Import Deletion vs Field Usage ```proto // Import deletion breaks even if types aren't directly used as fields import \"common/enums.proto\";","content":"Import Deletion vs Field Usage ```proto // Import deletion breaks even if types aren't directly used as fields import \"common/enums.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::import-deletion-vs-field-usage::39","title":"IMPORT_NO_DELETE","section":"Import Deletion vs Field Usage","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#import-deletion-vs-field-usage","headings":["Import Deletion vs Field Usage"],"excerpt":"Import Deletion vs Field Usage message Order { // Even if no fields directly use common.enums types, // nested messages or oneof fields might use them oneof payment { CreditCardPayment card = 1; // This might internally ","content":"Import Deletion vs Field Usage message Order { // Even if no fields directly use common.enums types, // nested messages or oneof fields might use them oneof payment { CreditCardPayment card = 1; // This might internally use common.enums } } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::transitive-dependencies::40","title":"IMPORT_NO_DELETE","section":"Transitive Dependencies","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#transitive-dependencies","headings":["Transitive Dependencies"],"excerpt":"Transitive Dependencies ```proto // Deleting an import can break transitive dependencies import \"user.proto\"; // Don't delete even if not directly used","content":"Transitive Dependencies ```proto // Deleting an import can break transitive dependencies import \"user.proto\"; // Don't delete even if not directly used"},{"id":"cli/breaking-changes/rules/import-no-delete::transitive-dependencies::41","title":"IMPORT_NO_DELETE","section":"Transitive Dependencies","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#transitive-dependencies","headings":["Transitive Dependencies"],"excerpt":"Transitive Dependencies message Order { PaymentInfo payment = 1; // PaymentInfo might internally reference user.proto types } ```","content":"Transitive Dependencies message Order { PaymentInfo payment = 1; // PaymentInfo might internally reference user.proto types } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::json-serialization-impact::42","title":"IMPORT_NO_DELETE","section":"JSON Serialization Impact","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#json-serialization-impact","headings":["JSON Serialization Impact"],"excerpt":"JSON Serialization Impact ```proto // Imports affect JSON field names and validation import \"google/protobuf/field_mask.proto\";","content":"JSON Serialization Impact ```proto // Imports affect JSON field names and validation import \"google/protobuf/field_mask.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::json-serialization-impact::43","title":"IMPORT_NO_DELETE","section":"JSON Serialization Impact","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#json-serialization-impact","headings":["JSON Serialization Impact"],"excerpt":"JSON Serialization Impact message UpdateRequest { google.protobuf.FieldMask update_mask = 1; // JSON serialization depends on import } ```","content":"JSON Serialization Impact message UpdateRequest { google.protobuf.FieldMask update_mask = 1; // JSON serialization depends on import } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::import-auditing::44","title":"IMPORT_NO_DELETE","section":"Import Auditing","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#import-auditing","headings":["Import Auditing"],"excerpt":"Import Auditing ```bash Check which imports are actually used $ grep -r \"google.protobuf.Duration\" *.proto $ grep -r \"common.User\" *.proto","content":"Import Auditing ```bash Check which imports are actually used $ grep -r \"google.protobuf.Duration\" *.proto $ grep -r \"common.User\" *.proto"},{"id":"cli/breaking-changes/rules/import-no-delete::import-auditing::45","title":"IMPORT_NO_DELETE","section":"Import Auditing","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#import-auditing","headings":["Import Auditing"],"excerpt":"Import Auditing But still keep imports even if grep shows no usage! ```","content":"Import Auditing But still keep imports even if grep shows no usage! ```"},{"id":"cli/breaking-changes/rules/import-no-delete::different-breaking-change-types::46","title":"IMPORT_NO_DELETE","section":"Different Breaking Change Types","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#different-breaking-change-types","headings":["Different Breaking Change Types"],"excerpt":"Different Breaking Change Types ```proto // Import deletion (this rule) // import \"user.proto\"; // BREAKING: import deleted","content":"Different Breaking Change Types ```proto // Import deletion (this rule) // import \"user.proto\"; // BREAKING: import deleted"},{"id":"cli/breaking-changes/rules/import-no-delete::different-breaking-change-types::47","title":"IMPORT_NO_DELETE","section":"Different Breaking Change Types","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#different-breaking-change-types","headings":["Different Breaking Change Types"],"excerpt":"Different Breaking Change Types // vs Field deletion (different rule) message Order { string id = 1; // User customer = 2; // BREAKING: field deleted (different from import) } ```","content":"Different Breaking Change Types // vs Field deletion (different rule) message Order { string id = 1; // User customer = 2; // BREAKING: field deleted (different from import) } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::top::0","title":"MESSAGE_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":[],"excerpt":"This rule checks that no messages are deleted from proto files. Deleting a message breaks both wire format compatibility and generated code, as existing data may reference the deleted message and client code depends on t","content":"This rule checks that no messages are deleted from proto files. Deleting a message breaks both wire format compatibility and generated code, as existing data may reference the deleted message and client code depends on the generated types."},{"id":"cli/breaking-changes/rules/message-no-delete::bad::1","title":"MESSAGE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/message-no-delete::bad::2","title":"MESSAGE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#bad","headings":["Bad"],"excerpt":"Bad message User { string name = 1; string email = 2; Address address = 3; }","content":"Bad message User { string name = 1; string email = 2; Address address = 3; }"},{"id":"cli/breaking-changes/rules/message-no-delete::bad::3","title":"MESSAGE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Address { // [!code --] string street = 1; // [!code --] string city = 2; // [!code --] string country = 3; // [!code --] } // [!code --]","content":"Bad message Address { // [!code --] string street = 1; // [!code --] string city = 2; // [!code --] string country = 3; // [!code --] } // [!code --]"},{"id":"cli/breaking-changes/rules/message-no-delete::bad::4","title":"MESSAGE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Order { string id = 1; User user = 2; } ```","content":"Bad message Order { string id = 1; User user = 2; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::bad::5","title":"MESSAGE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/message-no-delete::bad::6","title":"MESSAGE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#bad","headings":["Bad"],"excerpt":"Bad message User { string name = 1; string email = 2; Address address = 3; // ERROR: Address message no longer exists! }","content":"Bad message User { string name = 1; string email = 2; Address address = 3; // ERROR: Address message no longer exists! }"},{"id":"cli/breaking-changes/rules/message-no-delete::bad::7","title":"MESSAGE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#bad","headings":["Bad"],"excerpt":"Bad // Address message was deleted - BREAKING CHANGE!","content":"Bad // Address message was deleted - BREAKING CHANGE!"},{"id":"cli/breaking-changes/rules/message-no-delete::bad::8","title":"MESSAGE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Order { string id = 1; User user = 2; } ```","content":"Bad message Order { string id = 1; User user = 2; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::more-examples::9","title":"MESSAGE_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples **Nested message deletion:**","content":"More Examples **Nested message deletion:**"},{"id":"cli/breaking-changes/rules/message-no-delete::more-examples::10","title":"MESSAGE_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before message User { string name = 1; Profile profile = 2; message Profile { // [!code --] string bio = 1; // [!code --] string avatar_url = 2; // [!code --] } // [!code --] }","content":"More Examples ```proto // Before message User { string name = 1; Profile profile = 2; message Profile { // [!code --] string bio = 1; // [!code --] string avatar_url = 2; // [!code --] } // [!code --] }"},{"id":"cli/breaking-changes/rules/message-no-delete::more-examples::11","title":"MESSAGE_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - BREAKING CHANGE! message User { string name = 1; Profile profile = 2; // ERROR: Profile message deleted // Profile nested message was deleted } ```","content":"More Examples // After - BREAKING CHANGE! message User { string name = 1; Profile profile = 2; // ERROR: Profile message deleted // Profile nested message was deleted } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::good::12","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, deprecate the message:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, deprecate the message:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/message-no-delete::good::13","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good message User { string name = 1; string email = 2; Address address = 3 [deprecated = true]; // [!code focus] }","content":"Good message User { string name = 1; string email = 2; Address address = 3 [deprecated = true]; // [!code focus] }"},{"id":"cli/breaking-changes/rules/message-no-delete::good::14","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good message Address { option deprecated = true; // [!code focus] string street = 1; string city = 2; string country = 3; }","content":"Good message Address { option deprecated = true; // [!code focus] string street = 1; string city = 2; string country = 3; }"},{"id":"cli/breaking-changes/rules/message-no-delete::good::15","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good message Order { string id = 1; User user = 2; } ```","content":"Good message Order { string id = 1; User user = 2; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::good::16","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good **Or replace with new message version:** ```proto syntax = \"proto3\";","content":"Good **Or replace with new message version:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/message-no-delete::good::17","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good message User { string name = 1; string email = 2; Address address = 3 [deprecated = true]; // [!code focus] // Old field AddressV2 address_v2 = 4; // [!code focus] // New field with better structure }","content":"Good message User { string name = 1; string email = 2; Address address = 3 [deprecated = true]; // [!code focus] // Old field AddressV2 address_v2 = 4; // [!code focus] // New field with better structure }"},{"id":"cli/breaking-changes/rules/message-no-delete::good::18","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good message Address { option deprecated = true; // [!code focus] string street = 1; string city = 2; string country = 3; }","content":"Good message Address { option deprecated = true; // [!code focus] string street = 1; string city = 2; string country = 3; }"},{"id":"cli/breaking-changes/rules/message-no-delete::good::19","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good message AddressV2 { // [!code focus] string street_address = 1; // [!code focus] string city = 2; // [!code focus] string state = 3; // [!code focus] string postal_code = 4; // [!code focus] string country = 5; // [","content":"Good message AddressV2 { // [!code focus] string street_address = 1; // [!code focus] string city = 2; // [!code focus] string state = 3; // [!code focus] string postal_code = 4; // [!code focus] string country = 5; // [!code focus] } // [!code focus]"},{"id":"cli/breaking-changes/rules/message-no-delete::good::20","title":"MESSAGE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#good","headings":["Good"],"excerpt":"Good message Order { string id = 1; User user = 2; } ```","content":"Good message Order { string id = 1; User user = 2; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::impact::21","title":"MESSAGE_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Existing data with the deleted message cannot be deserialized **Generated Code:** Message classes/structs are removed, breaking client compilation **Field References:** Fields using the deleted me","content":"Impact **Wire Format:** Existing data with the deleted message cannot be deserialized **Generated Code:** Message classes/structs are removed, breaking client compilation **Field References:** Fields using the deleted message type become invalid **Nested Dependencies:** All messages referencing the deleted message break"},{"id":"cli/breaking-changes/rules/message-no-delete::real-world-example::22","title":"MESSAGE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works user := &myapi.User{ Name: \"John Doe\", Email: \"john@example.com\", Address: &myapi.Address{ // ERROR after deletion Street: \"123 Main St\", City:","content":"Real-World Example **Client code breaks:** ```go // Before - this code works user := &myapi.User{ Name: \"John Doe\", Email: \"john@example.com\", Address: &myapi.Address{ // ERROR after deletion Street: \"123 Main St\", City: \"New York\", Country: \"USA\", }, }"},{"id":"cli/breaking-changes/rules/message-no-delete::real-world-example::23","title":"MESSAGE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Generated code compilation fails: // undefined: myapi.Address ```","content":"Real-World Example // Generated code compilation fails: // undefined: myapi.Address ```"},{"id":"cli/breaking-changes/rules/message-no-delete::real-world-example::24","title":"MESSAGE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Existing data becomes unreadable:** ```json // Serialized data before deletion { \"name\": \"John Doe\", \"email\": \"john@example.com\", \"address\": { \"street\": \"123 Main St\", \"city\": \"New York\", \"country\": ","content":"Real-World Example **Existing data becomes unreadable:** ```json // Serialized data before deletion { \"name\": \"John Doe\", \"email\": \"john@example.com\", \"address\": { \"street\": \"123 Main St\", \"city\": \"New York\", \"country\": \"USA\" } }"},{"id":"cli/breaking-changes/rules/message-no-delete::real-world-example::25","title":"MESSAGE_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After Address deletion - deserialization fails // Parser doesn't know how to handle \"address\" field ```","content":"Real-World Example // After Address deletion - deserialization fails // Parser doesn't know how to handle \"address\" field ```"},{"id":"cli/breaking-changes/rules/message-no-delete::migration-strategy::26","title":"MESSAGE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate the message first:**","content":"Migration Strategy **Deprecate the message first:**"},{"id":"cli/breaking-changes/rules/message-no-delete::migration-strategy::27","title":"MESSAGE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Stop using in new fields** and deprecate existing fields that use it:","content":"Migration Strategy **Stop using in new fields** and deprecate existing fields that use it:"},{"id":"cli/breaking-changes/rules/message-no-delete::migration-strategy::28","title":"MESSAGE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Create replacement** with new structure if needed:","content":"Migration Strategy **Create replacement** with new structure if needed:"},{"id":"cli/breaking-changes/rules/message-no-delete::migration-strategy::29","title":"MESSAGE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove after migration period** in a new major version","content":"Migration Strategy **Remove after migration period** in a new major version"},{"id":"cli/breaking-changes/rules/message-no-delete::refactoring-message-structure::30","title":"MESSAGE_NO_DELETE","section":"Refactoring Message Structure","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#refactoring-message-structure","headings":["Refactoring Message Structure"],"excerpt":"Refactoring Message Structure ```proto // Instead of deleting UserInfo and creating UserProfile message UserInfo { option deprecated = true; // Deprecate old string name = 1; string email = 2; }","content":"Refactoring Message Structure ```proto // Instead of deleting UserInfo and creating UserProfile message UserInfo { option deprecated = true; // Deprecate old string name = 1; string email = 2; }"},{"id":"cli/breaking-changes/rules/message-no-delete::refactoring-message-structure::31","title":"MESSAGE_NO_DELETE","section":"Refactoring Message Structure","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#refactoring-message-structure","headings":["Refactoring Message Structure"],"excerpt":"Refactoring Message Structure message UserProfile { // Create new alongside string full_name = 1; string email_address = 2; string phone = 3; // Better field organization } ```","content":"Refactoring Message Structure message UserProfile { // Create new alongside string full_name = 1; string email_address = 2; string phone = 3; // Better field organization } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::version-migration::32","title":"MESSAGE_NO_DELETE","section":"Version Migration","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#version-migration","headings":["Version Migration"],"excerpt":"Version Migration ```proto // Clean approach - new package version package myapi.v2;","content":"Version Migration ```proto // Clean approach - new package version package myapi.v2;"},{"id":"cli/breaking-changes/rules/message-no-delete::version-migration::33","title":"MESSAGE_NO_DELETE","section":"Version Migration","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#version-migration","headings":["Version Migration"],"excerpt":"Version Migration message User { // Redesigned message structure // No deprecated Address references } ```","content":"Version Migration message User { // Redesigned message structure // No deprecated Address references } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::0","title":"ONEOF_FIELD_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":[],"excerpt":"This rule checks that no fields are deleted from oneOf groups. Deleting a field from a oneOf breaks both wire format compatibility and generated code, as existing data may use the deleted oneOf option and client code dep","content":"This rule checks that no fields are deleted from oneOf groups. Deleting a field from a oneOf breaks both wire format compatibility and generated code, as existing data may use the deleted oneOf option and client code depends on the generated field types and accessor methods."},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::bad::1","title":"ONEOF_FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::bad::2","title":"ONEOF_FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#bad","headings":["Bad"],"excerpt":"Bad message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4; string certificate = 5; } }","content":"Bad message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4; string certificate = 5; } }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::bad::3","title":"ONEOF_FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#bad","headings":["Bad"],"excerpt":"Bad message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; string category = 3; DateRange date_range = 4; } } ```","content":"Bad message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; string category = 3; DateRange date_range = 4; } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::bad::4","title":"ONEOF_FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::bad::5","title":"ONEOF_FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#bad","headings":["Bad"],"excerpt":"Bad message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; // string oauth_token = 4; // [!code --] Deleted oneOf field - BREAKING! // string certificate = 5; // [!code -","content":"Bad message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; // string oauth_token = 4; // [!code --] Deleted oneOf field - BREAKING! // string certificate = 5; // [!code --] Deleted oneOf field - BREAKING! } }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::bad::6","title":"ONEOF_FIELD_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#bad","headings":["Bad"],"excerpt":"Bad message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; // string category = 3; // [!code --] Deleted oneOf field - BREAKING! // DateRange date_range = 4; // [!code --] Deleted oneOf field - BREAKING","content":"Bad message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; // string category = 3; // [!code --] Deleted oneOf field - BREAKING! // DateRange date_range = 4; // [!code --] Deleted oneOf field - BREAKING! } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::more-examples::7","title":"ONEOF_FIELD_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples **Nested message oneOf field deletion:**","content":"More Examples **Nested message oneOf field deletion:**"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::more-examples::8","title":"ONEOF_FIELD_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before message PaymentRequest { string order_id = 1; oneof payment_method { CreditCardPayment credit_card = 2; BankTransferPayment bank_transfer = 3; CryptoPayment crypto = 4; // [!code --] Gift","content":"More Examples ```proto // Before message PaymentRequest { string order_id = 1; oneof payment_method { CreditCardPayment credit_card = 2; BankTransferPayment bank_transfer = 3; CryptoPayment crypto = 4; // [!code --] GiftCardPayment gift_card = 5; // [!code --] } }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::more-examples::9","title":"ONEOF_FIELD_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - BREAKING CHANGES! message PaymentRequest { string order_id = 1; oneof payment_method { CreditCardPayment credit_card = 2; BankTransferPayment bank_transfer = 3; // CryptoPayment crypto = 4; // BR","content":"More Examples // After - BREAKING CHANGES! message PaymentRequest { string order_id = 1; oneof payment_method { CreditCardPayment credit_card = 2; BankTransferPayment bank_transfer = 3; // CryptoPayment crypto = 4; // BREAKING: deleted // GiftCardPayment gift_card = 5; // BREAKING: deleted } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::good::10","title":"ONEOF_FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, deprecate the oneOf fields:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, deprecate the oneOf fields:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::good::11","title":"ONEOF_FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#good","headings":["Good"],"excerpt":"Good message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4 [deprecated = true]; // [!code focus] string certificate = 5 [deprecated = true]; // [!","content":"Good message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4 [deprecated = true]; // [!code focus] string certificate = 5 [deprecated = true]; // [!code focus] } }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::good::12","title":"ONEOF_FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#good","headings":["Good"],"excerpt":"Good message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; string category = 3 [deprecated = true]; // [!code focus] DateRange date_range = 4 [deprecated = true]; // [!code focus] } } ```","content":"Good message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; string category = 3 [deprecated = true]; // [!code focus] DateRange date_range = 4 [deprecated = true]; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::good::13","title":"ONEOF_FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#good","headings":["Good"],"excerpt":"Good **Or add new oneOf fields while keeping old ones:** ```proto syntax = \"proto3\";","content":"Good **Or add new oneOf fields while keeping old ones:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::good::14","title":"ONEOF_FIELD_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#good","headings":["Good"],"excerpt":"Good message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4 [deprecated = true]; // [!code focus] // Keep old field string certificate = 5 [depreca","content":"Good message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4 [deprecated = true]; // [!code focus] // Keep old field string certificate = 5 [deprecated = true]; // [!code focus] // Keep old field OAuthCredentials oauth_v2 = 6; // [!code focus] // New structured approach CertificateCredentials cert_v2 = 7; // [!code focus] // New structured approach } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::impact::15","title":"ONEOF_FIELD_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Existing data with deleted oneOf fields cannot be deserialized properly **Generated Code:** OneOf field accessor methods are removed, breaking client compilation **Type Safety:** Generated oneOf w","content":"Impact **Wire Format:** Existing data with deleted oneOf fields cannot be deserialized properly **Generated Code:** OneOf field accessor methods are removed, breaking client compilation **Type Safety:** Generated oneOf wrapper types lose options, breaking switch statements **Business Logic:** Client code handling specific oneOf cases breaks"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::real-world-example::16","title":"ONEOF_FIELD_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works loginReq := &myapi.LoginRequest{ Username: \"user123\", }","content":"Real-World Example **Client code breaks:** ```go // Before - this code works loginReq := &myapi.LoginRequest{ Username: \"user123\", }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::real-world-example::17","title":"ONEOF_FIELD_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Set OAuth token (oneOf field) loginReq.Credentials = &myapi.LoginRequest_OauthToken{ OauthToken: \"token123\", // ERROR after field deletion }","content":"Real-World Example // Set OAuth token (oneOf field) loginReq.Credentials = &myapi.LoginRequest_OauthToken{ OauthToken: \"token123\", // ERROR after field deletion }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::real-world-example::18","title":"ONEOF_FIELD_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Switch on oneOf field types switch cred := loginReq.Credentials.(type) { case *myapi.LoginRequest_Password: return authenticatePassword(cred.Password) case *myapi.LoginRequest_OauthToken: // ERROR: ","content":"Real-World Example // Switch on oneOf field types switch cred := loginReq.Credentials.(type) { case *myapi.LoginRequest_Password: return authenticatePassword(cred.Password) case *myapi.LoginRequest_OauthToken: // ERROR: undefined type after deletion return authenticateOAuth(cred.OauthToken) case *myapi.LoginRequest_Certificate: // ERROR: undefined type after deletion return authenticateCert(cred.Certificate) default: return errors.New(\"unsupported credential type\") }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::real-world-example::19","title":"ONEOF_FIELD_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Generated code compilation fails: // undefined: myapi.LoginRequest_OauthToken // undefined: myapi.LoginRequest_Certificate ```","content":"Real-World Example // Generated code compilation fails: // undefined: myapi.LoginRequest_OauthToken // undefined: myapi.LoginRequest_Certificate ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::real-world-example::20","title":"ONEOF_FIELD_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server handling breaks:**","content":"Real-World Example **Server handling breaks:**"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::real-world-example::21","title":"ONEOF_FIELD_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Existing data becomes unreadable:** ```json // Serialized data before deletion { \"username\": \"user123\", \"oauth_token\": \"abc123xyz\" }","content":"Real-World Example **Existing data becomes unreadable:** ```json // Serialized data before deletion { \"username\": \"user123\", \"oauth_token\": \"abc123xyz\" }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::real-world-example::22","title":"ONEOF_FIELD_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After oneOf field deletion // Data deserializes but oauth_token is lost or causes parsing errors // User authentication fails due to missing credential data ```","content":"Real-World Example // After oneOf field deletion // Data deserializes but oauth_token is lost or causes parsing errors // User authentication fails due to missing credential data ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::migration-strategy::23","title":"ONEOF_FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate oneOf fields first:**","content":"Migration Strategy **Deprecate oneOf fields first:**"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::migration-strategy::24","title":"ONEOF_FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Add new fields** if replacement is needed:","content":"Migration Strategy **Add new fields** if replacement is needed:"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::migration-strategy::25","title":"ONEOF_FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update server code** to handle both old and new fields:","content":"Migration Strategy **Update server code** to handle both old and new fields:"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::migration-strategy::26","title":"ONEOF_FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Migrate clients** to use new fields:","content":"Migration Strategy **Migrate clients** to use new fields:"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::migration-strategy::27","title":"ONEOF_FIELD_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Reserve field numbers** after removal in next major version:","content":"Migration Strategy **Reserve field numbers** after removal in next major version:"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::removing-unsupported-authentication-methods::28","title":"ONEOF_FIELD_NO_DELETE","section":"Removing Unsupported Authentication Methods","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#removing-unsupported-authentication-methods","headings":["Removing Unsupported Authentication Methods"],"excerpt":"Removing Unsupported Authentication Methods","content":"Removing Unsupported Authentication Methods"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::oneof-field-deletion-vs-other-deletions::29","title":"ONEOF_FIELD_NO_DELETE","section":"OneOf Field Deletion vs Other Deletions","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#oneof-field-deletion-vs-other-deletions","headings":["OneOf Field Deletion vs Other Deletions"],"excerpt":"OneOf Field Deletion vs Other Deletions","content":"OneOf Field Deletion vs Other Deletions"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::different-from-regular-field-deletion::30","title":"ONEOF_FIELD_NO_DELETE","section":"Different from Regular Field Deletion","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#different-from-regular-field-deletion","headings":["Different from Regular Field Deletion"],"excerpt":"Different from Regular Field Deletion ```proto // Regular field deletion (also breaking) message User { string name = 1; // string email = 2; // BREAKING: regular field deletion }","content":"Different from Regular Field Deletion ```proto // Regular field deletion (also breaking) message User { string name = 1; // string email = 2; // BREAKING: regular field deletion }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::different-from-regular-field-deletion::31","title":"ONEOF_FIELD_NO_DELETE","section":"Different from Regular Field Deletion","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#different-from-regular-field-deletion","headings":["Different from Regular Field Deletion"],"excerpt":"Different from Regular Field Deletion // OneOf field deletion (breaks oneOf semantics) message User { oneof contact { string email = 1; // string phone = 2; // BREAKING: oneOf field deletion } } ```","content":"Different from Regular Field Deletion // OneOf field deletion (breaks oneOf semantics) message User { oneof contact { string email = 1; // string phone = 2; // BREAKING: oneOf field deletion } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::impact-on-generated-code::32","title":"ONEOF_FIELD_NO_DELETE","section":"Impact on Generated Code","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#impact-on-generated-code","headings":["Impact on Generated Code"],"excerpt":"Impact on Generated Code ```go // Regular field - simple accessor removed // user.GetEmail() // Method removed","content":"Impact on Generated Code ```go // Regular field - simple accessor removed // user.GetEmail() // Method removed"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::impact-on-generated-code::33","title":"ONEOF_FIELD_NO_DELETE","section":"Impact on Generated Code","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#impact-on-generated-code","headings":["Impact on Generated Code"],"excerpt":"Impact on Generated Code // OneOf field - wrapper type removed // *LoginRequest_OauthToken // Entire type removed // switch statement cases break completely ```","content":"Impact on Generated Code // OneOf field - wrapper type removed // *LoginRequest_OauthToken // Entire type removed // switch statement cases break completely ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::wire-format-considerations::34","title":"ONEOF_FIELD_NO_DELETE","section":"Wire Format Considerations","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#wire-format-considerations","headings":["Wire Format Considerations"],"excerpt":"Wire Format Considerations ```proto // OneOf fields share the same \"choice\" semantics // Removing a choice breaks clients that made that choice","content":"Wire Format Considerations ```proto // OneOf fields share the same \"choice\" semantics // Removing a choice breaks clients that made that choice"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::wire-format-considerations::35","title":"ONEOF_FIELD_NO_DELETE","section":"Wire Format Considerations","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#wire-format-considerations","headings":["Wire Format Considerations"],"excerpt":"Wire Format Considerations message Request { oneof data { string text = 1; // Choice A bytes binary = 2; // Choice B - if removed, clients using B break JsonData json = 3; // Choice C } } ```","content":"Wire Format Considerations message Request { oneof data { string text = 1; // Choice A bytes binary = 2; // Choice B - if removed, clients using B break JsonData json = 3; // Choice C } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::0","title":"ONEOF_FIELD_SAME_TYPE","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":[],"excerpt":"This rule checks that oneOf field types cannot be changed. Changing the type of a field within a oneOf breaks both wire format compatibility and generated code, as existing data contains the old type and client code expe","content":"This rule checks that oneOf field types cannot be changed. Changing the type of a field within a oneOf breaks both wire format compatibility and generated code, as existing data contains the old type and client code expects specific field types in oneOf wrapper structures."},{"id":"cli/breaking-changes/rules/oneof-field-same-type::bad::1","title":"ONEOF_FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::bad::2","title":"ONEOF_FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#bad","headings":["Bad"],"excerpt":"Bad message SearchRequest { string query = 1; oneof filter { string category = 2; int32 user_id = 3; bool is_premium = 4; DateRange date_range = 5; } }","content":"Bad message SearchRequest { string query = 1; oneof filter { string category = 2; int32 user_id = 3; bool is_premium = 4; DateRange date_range = 5; } }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::bad::3","title":"ONEOF_FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#bad","headings":["Bad"],"excerpt":"Bad message NotificationSettings { oneof delivery { string email = 1; int64 phone_number = 2; WebhookConfig webhook = 3; } } ```","content":"Bad message NotificationSettings { oneof delivery { string email = 1; int64 phone_number = 2; WebhookConfig webhook = 3; } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::bad::4","title":"ONEOF_FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::bad::5","title":"ONEOF_FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#bad","headings":["Bad"],"excerpt":"Bad message SearchRequest { string query = 1; oneof filter { int32 category = 2; // [!code --] Changed from string to int32 - BREAKING! string user_id = 3; // [!code --] Changed from int32 to string - BREAKING! string is","content":"Bad message SearchRequest { string query = 1; oneof filter { int32 category = 2; // [!code --] Changed from string to int32 - BREAKING! string user_id = 3; // [!code --] Changed from int32 to string - BREAKING! string is_premium = 4; // [!code --] Changed from bool to string - BREAKING! string date_range = 5; // [!code --] Changed from DateRange to string - BREAKING! } }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::bad::6","title":"ONEOF_FIELD_SAME_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#bad","headings":["Bad"],"excerpt":"Bad message NotificationSettings { oneof delivery { EmailConfig email = 1; // [!code --] Changed from string to EmailConfig - BREAKING! string phone_number = 2; // [!code --] Changed from int64 to string - BREAKING! stri","content":"Bad message NotificationSettings { oneof delivery { EmailConfig email = 1; // [!code --] Changed from string to EmailConfig - BREAKING! string phone_number = 2; // [!code --] Changed from int64 to string - BREAKING! string webhook = 3; // [!code --] Changed from WebhookConfig to string - BREAKING! } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::more-examples::7","title":"ONEOF_FIELD_SAME_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#more-examples","headings":["More Examples"],"excerpt":"More Examples **Complex type changes:**","content":"More Examples **Complex type changes:**"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::more-examples::8","title":"ONEOF_FIELD_SAME_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before message PaymentRequest { oneof payment_info { CreditCardInfo credit_card = 1; BankAccountInfo bank_account = 2; string paypal_email = 3; CryptoWalletInfo crypto = 4; } }","content":"More Examples ```proto // Before message PaymentRequest { oneof payment_info { CreditCardInfo credit_card = 1; BankAccountInfo bank_account = 2; string paypal_email = 3; CryptoWalletInfo crypto = 4; } }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::more-examples::9","title":"ONEOF_FIELD_SAME_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - ALL BREAKING CHANGES! message PaymentRequest { oneof payment_info { string credit_card = 1; // BREAKING: CreditCardInfo -> string PayPalInfo bank_account = 2; // BREAKING: BankAccountInfo -> PayP","content":"More Examples // After - ALL BREAKING CHANGES! message PaymentRequest { oneof payment_info { string credit_card = 1; // BREAKING: CreditCardInfo -> string PayPalInfo bank_account = 2; // BREAKING: BankAccountInfo -> PayPalInfo PayPalInfo paypal_email = 3; // BREAKING: string -> PayPalInfo string crypto = 4; // BREAKING: CryptoWalletInfo -> string } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::good::10","title":"ONEOF_FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#good","headings":["Good"],"excerpt":"Good **Instead of changing type, add new oneOf field:** ```proto syntax = \"proto3\";","content":"Good **Instead of changing type, add new oneOf field:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::good::11","title":"ONEOF_FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#good","headings":["Good"],"excerpt":"Good message SearchRequest { string query = 1; oneof filter { string category = 2 [deprecated = true]; // [!code focus] // Keep original type int32 user_id = 3 [deprecated = true]; // [!code focus] // Keep original type ","content":"Good message SearchRequest { string query = 1; oneof filter { string category = 2 [deprecated = true]; // [!code focus] // Keep original type int32 user_id = 3 [deprecated = true]; // [!code focus] // Keep original type bool is_premium = 4 [deprecated = true]; // [!code focus] // Keep original type DateRange date_range = 5 [deprecated = true]; // [!code focus] // Keep original type int32 category_id = 6; // [!code focus] // New field with desired type string user_identifier = 7; // [!code focus] // New field with desired type string premium_status = 8; // [!code focus] // New field with desired type string date_filter = 9; // [!code focus] // New field with desired type } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::good::12","title":"ONEOF_FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#good","headings":["Good"],"excerpt":"Good **Or create a new oneOf group:** ```proto syntax = \"proto3\";","content":"Good **Or create a new oneOf group:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::good::13","title":"ONEOF_FIELD_SAME_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#good","headings":["Good"],"excerpt":"Good message SearchRequest { string query = 1; oneof filter { option deprecated = true; // [!code focus] // Deprecate old oneOf string category = 2 [deprecated = true]; // [!code focus] int32 user_id = 3 [deprecated = tr","content":"Good message SearchRequest { string query = 1; oneof filter { option deprecated = true; // [!code focus] // Deprecate old oneOf string category = 2 [deprecated = true]; // [!code focus] int32 user_id = 3 [deprecated = true]; // [!code focus] bool is_premium = 4 [deprecated = true]; // [!code focus] DateRange date_range = 5 [deprecated = true]; // [!code focus] } oneof filter_v2 { // [!code focus] // New oneOf with correct types int32 category_id = 6; // [!code focus] string user_identifier = 7; // [!code focus] PremiumFilter premium_filter = 8; // [!code focus] TimeFilter time_filter = 9; // [!code focus] } // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::impact::14","title":"ONEOF_FIELD_SAME_TYPE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Binary data cannot be deserialized correctly between versions **Generated Code:** OneOf wrapper types change, breaking client compilation **Type Safety:** Switch statements on oneOf types break wi","content":"Impact **Wire Format:** Binary data cannot be deserialized correctly between versions **Generated Code:** OneOf wrapper types change, breaking client compilation **Type Safety:** Switch statements on oneOf types break with compilation errors **Runtime Errors:** Type mismatches cause parsing failures for existing data"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::15","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works searchReq := &myapi.SearchRequest{ Query: \"golang jobs\", }","content":"Real-World Example **Client code breaks:** ```go // Before - this code works searchReq := &myapi.SearchRequest{ Query: \"golang jobs\", }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::16","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Set filter using oneOf (original types) searchReq.Filter = &myapi.SearchRequest_Category{ Category: \"engineering\", // string type }","content":"Real-World Example // Set filter using oneOf (original types) searchReq.Filter = &myapi.SearchRequest_Category{ Category: \"engineering\", // string type }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::17","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Handle filter types switch filter := searchReq.Filter.(type) { case *myapi.SearchRequest_Category: return searchByCategory(filter.Category) // string parameter case *myapi.SearchRequest_UserId: retu","content":"Real-World Example // Handle filter types switch filter := searchReq.Filter.(type) { case *myapi.SearchRequest_Category: return searchByCategory(filter.Category) // string parameter case *myapi.SearchRequest_UserId: return searchByUserId(filter.UserId) // int32 parameter default: return errors.New(\"unsupported filter\") }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::18","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After type change - compilation fails searchReq.Filter = &myapi.SearchRequest_Category{ Category: \"engineering\", // ERROR: expects int32, not string }","content":"Real-World Example // After type change - compilation fails searchReq.Filter = &myapi.SearchRequest_Category{ Category: \"engineering\", // ERROR: expects int32, not string }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::19","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Switch statement breaks switch filter := searchReq.Filter.(type) { case *myapi.SearchRequest_Category: return searchByCategory(filter.Category) // ERROR: Category is now int32 case *myapi.SearchRequ","content":"Real-World Example // Switch statement breaks switch filter := searchReq.Filter.(type) { case *myapi.SearchRequest_Category: return searchByCategory(filter.Category) // ERROR: Category is now int32 case *myapi.SearchRequest_UserId: return searchByUserId(filter.UserId) // ERROR: UserId is now string } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::20","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server implementation breaks:** ```go // Before - server expects original types func handleSearchFilter(req *SearchRequest) (*SearchResult, error) { switch filter := req.Filter.(type) { case *SearchR","content":"Real-World Example **Server implementation breaks:** ```go // Before - server expects original types func handleSearchFilter(req *SearchRequest) (*SearchResult, error) { switch filter := req.Filter.(type) { case *SearchRequest_Category: categoryName := filter.Category // string return searchDatabase(\"category\", categoryName), nil case *SearchRequest_UserId: userId := filter.UserId // int32 return searchDatabase(\"user_id\", strconv.Itoa(int(userId))), nil default: return nil, errors.New(\"no filter specified\") } }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::21","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After type change - runtime errors func handleSearchFilter(req *SearchRequest) (*SearchResult, error) { switch filter := req.Filter.(type) { case *SearchRequest_Category: categoryId := filter.Catego","content":"Real-World Example // After type change - runtime errors func handleSearchFilter(req *SearchRequest) (*SearchResult, error) { switch filter := req.Filter.(type) { case *SearchRequest_Category: categoryId := filter.Category // now int32, but code expects string return searchDatabase(\"category\", categoryId), nil // ERROR: type mismatch case *SearchRequest_UserId: userIdStr := filter.UserId // now string, but conversion logic expects int32 userId, _ := strconv.Atoi(userIdStr) // Works but semantics changed return searchDatabase(\"user_id\", strconv.Itoa(userId)), nil } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::22","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Existing data corruption:** ```json // Serialized data before type change { \"query\": \"golang jobs\", \"category\": \"engineering\" }","content":"Real-World Example **Existing data corruption:** ```json // Serialized data before type change { \"query\": \"golang jobs\", \"category\": \"engineering\" }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::real-world-example::23","title":"ONEOF_FIELD_SAME_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After changing category from string to int32 // Data cannot be deserialized - \"engineering\" is not a valid int32 // Results in parsing errors or data loss ```","content":"Real-World Example // After changing category from string to int32 // Data cannot be deserialized - \"engineering\" is not a valid int32 // Results in parsing errors or data loss ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::migration-strategy::24","title":"ONEOF_FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Add new oneOf fields** with correct types:","content":"Migration Strategy **Add new oneOf fields** with correct types:"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::migration-strategy::25","title":"ONEOF_FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update server code** to handle both old and new fields:","content":"Migration Strategy **Update server code** to handle both old and new fields:"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::migration-strategy::26","title":"ONEOF_FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Migrate clients** to use new fields:","content":"Migration Strategy **Migrate clients** to use new fields:"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::migration-strategy::27","title":"ONEOF_FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Provide migration utilities** for data conversion:","content":"Migration Strategy **Provide migration utilities** for data conversion:"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::migration-strategy::28","title":"ONEOF_FIELD_SAME_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove old fields** in next major version:","content":"Migration Strategy **Remove old fields** in next major version:"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::type-change-compatibility-matrix::29","title":"ONEOF_FIELD_SAME_TYPE","section":"Type Change Compatibility Matrix","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#type-change-compatibility-matrix","headings":["Type Change Compatibility Matrix"],"excerpt":"Type Change Compatibility Matrix","content":"Type Change Compatibility Matrix"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::never-compatible-always-breaking::30","title":"ONEOF_FIELD_SAME_TYPE","section":"Never Compatible (Always Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#never-compatible-always-breaking","headings":["Never Compatible (Always Breaking)"],"excerpt":"Never Compatible (Always Breaking) From Type To Type Result ----------- --------- --------- string int32/int64 ❌ BREAKING int32 string ❌ BREAKING bool string ❌ BREAKING message string ❌ BREAKING string message ❌ BREAKING","content":"Never Compatible (Always Breaking) From Type To Type Result ----------- --------- --------- string int32/int64 ❌ BREAKING int32 string ❌ BREAKING bool string ❌ BREAKING message string ❌ BREAKING string message ❌ BREAKING enum int32 ❌ BREAKING"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::generated-code-impact::31","title":"ONEOF_FIELD_SAME_TYPE","section":"Generated Code Impact","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#generated-code-impact","headings":["Generated Code Impact"],"excerpt":"Generated Code Impact ```go // String to int32 change breaks wrapper types // Before: type SearchRequest_Category struct { Category string }","content":"Generated Code Impact ```go // String to int32 change breaks wrapper types // Before: type SearchRequest_Category struct { Category string }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::generated-code-impact::32","title":"ONEOF_FIELD_SAME_TYPE","section":"Generated Code Impact","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#generated-code-impact","headings":["Generated Code Impact"],"excerpt":"Generated Code Impact // After: type SearchRequest_Category struct { Category int32 // Different type - compilation fails }","content":"Generated Code Impact // After: type SearchRequest_Category struct { Category int32 // Different type - compilation fails }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::generated-code-impact::33","title":"ONEOF_FIELD_SAME_TYPE","section":"Generated Code Impact","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#generated-code-impact","headings":["Generated Code Impact"],"excerpt":"Generated Code Impact // All client code using SearchRequest_Category breaks ```","content":"Generated Code Impact // All client code using SearchRequest_Category breaks ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::wire-format-considerations::34","title":"ONEOF_FIELD_SAME_TYPE","section":"Wire Format Considerations","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#wire-format-considerations","headings":["Wire Format Considerations"],"excerpt":"Wire Format Considerations ```proto // OneOf fields in wire format are identified by field number // Type changes break deserialization even if field number stays same","content":"Wire Format Considerations ```proto // OneOf fields in wire format are identified by field number // Type changes break deserialization even if field number stays same"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::wire-format-considerations::35","title":"ONEOF_FIELD_SAME_TYPE","section":"Wire Format Considerations","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#wire-format-considerations","headings":["Wire Format Considerations"],"excerpt":"Wire Format Considerations message Request { oneof data { string text = 1; // Wire tag: 1, type: string // int32 text = 1; // Same wire tag, different type - BREAKING! } } ```","content":"Wire Format Considerations message Request { oneof data { string text = 1; // Wire tag: 1, type: string // int32 text = 1; // Same wire tag, different type - BREAKING! } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::type-safe-validation-before-change::36","title":"ONEOF_FIELD_SAME_TYPE","section":"Type-Safe Validation (Before Change)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#type-safe-validation-before-change","headings":["Type-Safe Validation (Before Change)"],"excerpt":"Type-Safe Validation (Before Change)","content":"Type-Safe Validation (Before Change)"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::broken-validation-after-type-change::37","title":"ONEOF_FIELD_SAME_TYPE","section":"Broken Validation (After Type Change)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#broken-validation-after-type-change","headings":["Broken Validation (After Type Change)"],"excerpt":"Broken Validation (After Type Change)","content":"Broken Validation (After Type Change)"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::0","title":"ONEOF_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":[],"excerpt":"This rule checks that no oneOf fields are deleted from messages. Deleting a oneOf breaks both wire format compatibility and generated code, as existing data may use the oneOf structure and client code depends on the gene","content":"This rule checks that no oneOf fields are deleted from messages. Deleting a oneOf breaks both wire format compatibility and generated code, as existing data may use the oneOf structure and client code depends on the generated oneOf types and accessor methods."},{"id":"cli/breaking-changes/rules/oneof-no-delete::bad::1","title":"ONEOF_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-no-delete::bad::2","title":"ONEOF_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#bad","headings":["Bad"],"excerpt":"Bad message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4; } }","content":"Bad message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4; } }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::bad::3","title":"ONEOF_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#bad","headings":["Bad"],"excerpt":"Bad message PaymentMethod { // [!code --] oneof method { // [!code --] CreditCard credit_card = 1; // [!code --] BankAccount bank_account = 2; // [!code --] PayPal paypal = 3; // [!code --] } // [!code --] } // [!code --","content":"Bad message PaymentMethod { // [!code --] oneof method { // [!code --] CreditCard credit_card = 1; // [!code --] BankAccount bank_account = 2; // [!code --] PayPal paypal = 3; // [!code --] } // [!code --] } // [!code --]"},{"id":"cli/breaking-changes/rules/oneof-no-delete::bad::4","title":"ONEOF_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Order { string id = 1; PaymentMethod payment = 2; } ```","content":"Bad message Order { string id = 1; PaymentMethod payment = 2; } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::bad::5","title":"ONEOF_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-no-delete::bad::6","title":"ONEOF_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#bad","headings":["Bad"],"excerpt":"Bad message LoginRequest { string username = 1; // credentials oneof was deleted - BREAKING CHANGE! string password = 2; // Now regular fields string api_key = 3; // Lost exclusive semantics string oauth_token = 4; }","content":"Bad message LoginRequest { string username = 1; // credentials oneof was deleted - BREAKING CHANGE! string password = 2; // Now regular fields string api_key = 3; // Lost exclusive semantics string oauth_token = 4; }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::bad::7","title":"ONEOF_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#bad","headings":["Bad"],"excerpt":"Bad message PaymentMethod { // method oneof was deleted - BREAKING CHANGE! CreditCard credit_card = 1; // Now all can be set simultaneously BankAccount bank_account = 2; PayPal paypal = 3; }","content":"Bad message PaymentMethod { // method oneof was deleted - BREAKING CHANGE! CreditCard credit_card = 1; // Now all can be set simultaneously BankAccount bank_account = 2; PayPal paypal = 3; }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::bad::8","title":"ONEOF_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#bad","headings":["Bad"],"excerpt":"Bad message Order { string id = 1; PaymentMethod payment = 2; } ```","content":"Bad message Order { string id = 1; PaymentMethod payment = 2; } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::more-examples::9","title":"ONEOF_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples **Nested oneOf deletion:**","content":"More Examples **Nested oneOf deletion:**"},{"id":"cli/breaking-changes/rules/oneof-no-delete::more-examples::10","title":"ONEOF_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before message UserProfile { string name = 1; message ContactInfo { oneof contact_method { // [!code --] string email = 1; // [!code --] string phone = 2; // [!code --] string slack_id = 3; // [","content":"More Examples ```proto // Before message UserProfile { string name = 1; message ContactInfo { oneof contact_method { // [!code --] string email = 1; // [!code --] string phone = 2; // [!code --] string slack_id = 3; // [!code --] } // [!code --] } ContactInfo contact = 2; }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::more-examples::11","title":"ONEOF_NO_DELETE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - BREAKING CHANGE! message UserProfile { string name = 1; message ContactInfo { // contact_method oneof was deleted string email = 1; // No longer mutually exclusive string phone = 2; // Can set al","content":"More Examples // After - BREAKING CHANGE! message UserProfile { string name = 1; message ContactInfo { // contact_method oneof was deleted string email = 1; // No longer mutually exclusive string phone = 2; // Can set all fields now string slack_id = 3; } ContactInfo contact = 2; } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::good::12","title":"ONEOF_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, deprecate the oneOf:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, deprecate the oneOf:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-no-delete::good::13","title":"ONEOF_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#good","headings":["Good"],"excerpt":"Good message LoginRequest { string username = 1; oneof credentials { option deprecated = true; // [!code focus] string password = 2 [deprecated = true]; // [!code focus] string api_key = 3 [deprecated = true]; // [!code ","content":"Good message LoginRequest { string username = 1; oneof credentials { option deprecated = true; // [!code focus] string password = 2 [deprecated = true]; // [!code focus] string api_key = 3 [deprecated = true]; // [!code focus] string oauth_token = 4 [deprecated = true]; // [!code focus] } }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::good::14","title":"ONEOF_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#good","headings":["Good"],"excerpt":"Good message PaymentMethod { oneof method { option deprecated = true; // [!code focus] CreditCard credit_card = 1 [deprecated = true]; // [!code focus] BankAccount bank_account = 2 [deprecated = true]; // [!code focus] P","content":"Good message PaymentMethod { oneof method { option deprecated = true; // [!code focus] CreditCard credit_card = 1 [deprecated = true]; // [!code focus] BankAccount bank_account = 2 [deprecated = true]; // [!code focus] PayPal paypal = 3 [deprecated = true]; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::good::15","title":"ONEOF_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#good","headings":["Good"],"excerpt":"Good **Or replace with new structure:** ```proto syntax = \"proto3\";","content":"Good **Or replace with new structure:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-no-delete::good::16","title":"ONEOF_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#good","headings":["Good"],"excerpt":"Good message LoginRequest { string username = 1; oneof credentials { option deprecated = true; // [!code focus] // Old oneOf string password = 2 [deprecated = true]; // [!code focus] string api_key = 3 [deprecated = true","content":"Good message LoginRequest { string username = 1; oneof credentials { option deprecated = true; // [!code focus] // Old oneOf string password = 2 [deprecated = true]; // [!code focus] string api_key = 3 [deprecated = true]; // [!code focus] string oauth_token = 4 [deprecated = true]; // [!code focus] } oneof auth_method { // [!code focus] // New oneOf with better design PasswordAuth password_auth = 5; // [!code focus] ApiKeyAuth api_auth = 6; // [!code focus] OAuthAuth oauth_auth = 7; // [!code focus] } // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::impact::17","title":"ONEOF_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** OneOf semantics are lost - fields are no longer mutually exclusive **Generated Code:** OneOf accessor methods are removed, breaking client compilation **Business Logic:** Mutual exclusivity constr","content":"Impact **Wire Format:** OneOf semantics are lost - fields are no longer mutually exclusive **Generated Code:** OneOf accessor methods are removed, breaking client compilation **Business Logic:** Mutual exclusivity constraints are violated **Validation:** Client code expecting only one field to be set may break"},{"id":"cli/breaking-changes/rules/oneof-no-delete::real-world-example::18","title":"ONEOF_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - oneOf provides mutual exclusivity loginReq := &myapi.LoginRequest{ Username: \"user123\", }","content":"Real-World Example **Client code breaks:** ```go // Before - oneOf provides mutual exclusivity loginReq := &myapi.LoginRequest{ Username: \"user123\", }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::real-world-example::19","title":"ONEOF_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Set one of the credential options (oneOf semantics) loginReq.Credentials = &myapi.LoginRequest_Password{ Password: \"secret123\", }","content":"Real-World Example // Set one of the credential options (oneOf semantics) loginReq.Credentials = &myapi.LoginRequest_Password{ Password: \"secret123\", }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::real-world-example::20","title":"ONEOF_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Check which credential type is set switch cred := loginReq.Credentials.(type) { case *myapi.LoginRequest_Password: // ERROR after oneOf deletion return authenticatePassword(cred.Password) case *myap","content":"Real-World Example // Check which credential type is set switch cred := loginReq.Credentials.(type) { case *myapi.LoginRequest_Password: // ERROR after oneOf deletion return authenticatePassword(cred.Password) case *myapi.LoginRequest_ApiKey: // ERROR after oneOf deletion return authenticateApiKey(cred.ApiKey) default: return errors.New(\"no credentials provided\") }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::real-world-example::21","title":"ONEOF_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Generated code compilation fails: // undefined: myapi.LoginRequest_Password // undefined field: loginReq.Credentials ```","content":"Real-World Example // Generated code compilation fails: // undefined: myapi.LoginRequest_Password // undefined field: loginReq.Credentials ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::real-world-example::22","title":"ONEOF_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server validation breaks:** ```go // Before - server validates oneOf semantics func validateLoginRequest(req *LoginRequest) error { if req.Credentials == nil { return errors.New(\"credentials required","content":"Real-World Example **Server validation breaks:** ```go // Before - server validates oneOf semantics func validateLoginRequest(req *LoginRequest) error { if req.Credentials == nil { return errors.New(\"credentials required\") } // OneOf ensures only one credential type is set switch req.Credentials.(type) { case *LoginRequest_Password: return validatePassword(req.GetPassword()) case *LoginRequest_ApiKey: return validateApiKey(req.GetApiKey()) case *LoginRequest_OauthToken: return validateOAuthToken(req.GetOauthToken()) default: return errors.New(\"unknown credential type\") } }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::real-world-example::23","title":"ONEOF_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After oneOf deletion - validation logic breaks func validateLoginRequest(req *LoginRequest) error { // No more oneOf - multiple fields can be set! credCount := 0 if req.Password != \"\" { credCount++ ","content":"Real-World Example // After oneOf deletion - validation logic breaks func validateLoginRequest(req *LoginRequest) error { // No more oneOf - multiple fields can be set! credCount := 0 if req.Password != \"\" { credCount++ } if req.ApiKey != \"\" { credCount++ } if req.OauthToken != \"\" { credCount++ } if credCount == 0 { return errors.New(\"no credentials provided\") } if credCount > 1 { return errors.New(\"multiple credentials provided\") // Manual check needed! } // Lost type safety - need manual checks if req.Password != \"\" { return validatePassword(req.Password) } // ... more manual validation } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::real-world-example::24","title":"ONEOF_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Business logic problems:** ```go // Before - oneOf guarantees mutual exclusivity payment := &PaymentMethod{ Method: &PaymentMethod_CreditCard{ CreditCard: &CreditCard{Number: \"1234\"}, }, } // Impossi","content":"Real-World Example **Business logic problems:** ```go // Before - oneOf guarantees mutual exclusivity payment := &PaymentMethod{ Method: &PaymentMethod_CreditCard{ CreditCard: &CreditCard{Number: \"1234\"}, }, } // Impossible to set multiple payment methods simultaneously"},{"id":"cli/breaking-changes/rules/oneof-no-delete::real-world-example::25","title":"ONEOF_NO_DELETE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After oneOf deletion - business logic can break payment := &PaymentMethod{ CreditCard: &CreditCard{Number: \"1234\"}, BankAccount: &BankAccount{Number: \"5678\"}, // Both set! Logic breaks! } ```","content":"Real-World Example // After oneOf deletion - business logic can break payment := &PaymentMethod{ CreditCard: &CreditCard{Number: \"1234\"}, BankAccount: &BankAccount{Number: \"5678\"}, // Both set! Logic breaks! } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::migration-strategy::26","title":"ONEOF_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate the oneOf and all its fields:**","content":"Migration Strategy **Deprecate the oneOf and all its fields:**"},{"id":"cli/breaking-changes/rules/oneof-no-delete::migration-strategy::27","title":"ONEOF_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Create new structure** if needed:","content":"Migration Strategy **Create new structure** if needed:"},{"id":"cli/breaking-changes/rules/oneof-no-delete::migration-strategy::28","title":"ONEOF_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Update server code** to handle both during transition:","content":"Migration Strategy **Update server code** to handle both during transition:"},{"id":"cli/breaking-changes/rules/oneof-no-delete::migration-strategy::29","title":"ONEOF_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Migrate clients** to use new structure:","content":"Migration Strategy **Migrate clients** to use new structure:"},{"id":"cli/breaking-changes/rules/oneof-no-delete::migration-strategy::30","title":"ONEOF_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove old oneOf** in next major version","content":"Migration Strategy **Remove old oneOf** in next major version"},{"id":"cli/breaking-changes/rules/oneof-no-delete::replacing-oneof-with-regular-fields::31","title":"ONEOF_NO_DELETE","section":"Replacing OneOf with Regular Fields","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#replacing-oneof-with-regular-fields","headings":["Replacing OneOf with Regular Fields"],"excerpt":"Replacing OneOf with Regular Fields ```proto // Instead of removing oneOf structure entirely message SearchRequest { // Don't delete oneOf - breaks mutual exclusivity string text_query = 1; // BREAKING: was in oneOf int3","content":"Replacing OneOf with Regular Fields ```proto // Instead of removing oneOf structure entirely message SearchRequest { // Don't delete oneOf - breaks mutual exclusivity string text_query = 1; // BREAKING: was in oneOf int32 user_id = 2; // BREAKING: was in oneOf string category = 3; // BREAKING: was in oneOf }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::replacing-oneof-with-regular-fields::32","title":"ONEOF_NO_DELETE","section":"Replacing OneOf with Regular Fields","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#replacing-oneof-with-regular-fields","headings":["Replacing OneOf with Regular Fields"],"excerpt":"Replacing OneOf with Regular Fields // Keep oneOf, add new fields if needed message SearchRequest { oneof query { option deprecated = true; string text_query = 1 [deprecated = true]; int32 user_id = 2 [deprecated = true]","content":"Replacing OneOf with Regular Fields // Keep oneOf, add new fields if needed message SearchRequest { oneof query { option deprecated = true; string text_query = 1 [deprecated = true]; int32 user_id = 2 [deprecated = true]; string category = 3 [deprecated = true]; } // Add new non-exclusive fields if that's the intent string search_text = 4; repeated string filters = 5; } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::simplifying-message-structure::33","title":"ONEOF_NO_DELETE","section":"Simplifying Message Structure","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#simplifying-message-structure","headings":["Simplifying Message Structure"],"excerpt":"Simplifying Message Structure ```proto // Instead of flattening oneOf structure message NotificationSettings { // Don't delete oneOf - loses type safety string email = 1; // BREAKING: was in oneOf string phone = 2; // BR","content":"Simplifying Message Structure ```proto // Instead of flattening oneOf structure message NotificationSettings { // Don't delete oneOf - loses type safety string email = 1; // BREAKING: was in oneOf string phone = 2; // BREAKING: was in oneOf string webhook_url = 3; // BREAKING: was in oneOf }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::simplifying-message-structure::34","title":"ONEOF_NO_DELETE","section":"Simplifying Message Structure","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#simplifying-message-structure","headings":["Simplifying Message Structure"],"excerpt":"Simplifying Message Structure // Keep oneOf for type safety message NotificationSettings { oneof delivery_method { EmailNotification email = 1; SmsNotification phone = 2; WebhookNotification webhook = 3; } } ```","content":"Simplifying Message Structure // Keep oneOf for type safety message NotificationSettings { oneof delivery_method { EmailNotification email = 1; SmsNotification phone = 2; WebhookNotification webhook = 3; } } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::proto-syntax-migration::35","title":"ONEOF_NO_DELETE","section":"Proto Syntax Migration","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#proto-syntax-migration","headings":["Proto Syntax Migration"],"excerpt":"Proto Syntax Migration ```proto // When migrating from proto2 to proto3 // Don't lose oneOf semantics during migration","content":"Proto Syntax Migration ```proto // When migrating from proto2 to proto3 // Don't lose oneOf semantics during migration"},{"id":"cli/breaking-changes/rules/oneof-no-delete::proto-syntax-migration::36","title":"ONEOF_NO_DELETE","section":"Proto Syntax Migration","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#proto-syntax-migration","headings":["Proto Syntax Migration"],"excerpt":"Proto Syntax Migration // proto2 message Request { optional string name = 1; oneof data { string text = 2; int32 number = 3; } }","content":"Proto Syntax Migration // proto2 message Request { optional string name = 1; oneof data { string text = 2; int32 number = 3; } }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::proto-syntax-migration::37","title":"ONEOF_NO_DELETE","section":"Proto Syntax Migration","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#proto-syntax-migration","headings":["Proto Syntax Migration"],"excerpt":"Proto Syntax Migration // proto3 - keep oneOf structure message Request { string name = 1; oneof data { // Don't delete this! string text = 2; int32 number = 3; } } ```","content":"Proto Syntax Migration // proto3 - keep oneOf structure message Request { string name = 1; oneof data { // Don't delete this! string text = 2; int32 number = 3; } } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::what-oneof-provides::38","title":"ONEOF_NO_DELETE","section":"What OneOf Provides","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#what-oneof-provides","headings":["What OneOf Provides"],"excerpt":"What OneOf Provides **Mutual Exclusivity**: Only one field can be set at a time **Type Safety**: Generated code enforces single choice **Clear Intent**: API design expresses \"choose one\" semantics **Efficient Wire Format","content":"What OneOf Provides **Mutual Exclusivity**: Only one field can be set at a time **Type Safety**: Generated code enforces single choice **Clear Intent**: API design expresses \"choose one\" semantics **Efficient Wire Format**: Only selected field is serialized"},{"id":"cli/breaking-changes/rules/oneof-no-delete::whats-lost-when-deleted::39","title":"ONEOF_NO_DELETE","section":"What's Lost When Deleted","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#whats-lost-when-deleted","headings":["What's Lost When Deleted"],"excerpt":"What's Lost When Deleted **Business Logic**: No enforcement of mutual exclusivity **Generated Code**: No oneOf wrapper types or methods **Validation**: Manual checks needed for exclusivity **API Clarity**: Intent of \"cho","content":"What's Lost When Deleted **Business Logic**: No enforcement of mutual exclusivity **Generated Code**: No oneOf wrapper types or methods **Validation**: Manual checks needed for exclusivity **API Clarity**: Intent of \"choose one\" is lost"},{"id":"cli/breaking-changes/rules/oneof-no-delete::generated-code-impact::40","title":"ONEOF_NO_DELETE","section":"Generated Code Impact","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#generated-code-impact","headings":["Generated Code Impact"],"excerpt":"Generated Code Impact ```go // With oneOf - type safe type LoginRequest struct { Username string // Types that are assignable to Credentials: // *LoginRequest_Password // *LoginRequest_ApiKey Credentials isLoginRequest_C","content":"Generated Code Impact ```go // With oneOf - type safe type LoginRequest struct { Username string // Types that are assignable to Credentials: // *LoginRequest_Password // *LoginRequest_ApiKey Credentials isLoginRequest_Credentials }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::generated-code-impact::41","title":"ONEOF_NO_DELETE","section":"Generated Code Impact","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#generated-code-impact","headings":["Generated Code Impact"],"excerpt":"Generated Code Impact // Without oneOf - no type safety type LoginRequest struct { Username string Password string // All can be set simultaneously ApiKey string // No mutual exclusivity OauthToken string } ```","content":"Generated Code Impact // Without oneOf - no type safety type LoginRequest struct { Username string Password string // All can be set simultaneously ApiKey string // No mutual exclusivity OauthToken string } ```"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::0","title":"RPC_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":[],"excerpt":"This rule checks that no RPC methods are deleted from services. Deleting an RPC method breaks both generated code and client applications that call the method.","content":"This rule checks that no RPC methods are deleted from services. Deleting an RPC method breaks both generated code and client applications that call the method."},{"id":"cli/breaking-changes/rules/rpc-no-delete::bad::1","title":"RPC_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-no-delete::bad::2","title":"RPC_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#bad","headings":["Bad"],"excerpt":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse); // [!code -","content":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse); // [!code --] } ```"},{"id":"cli/breaking-changes/rules/rpc-no-delete::bad::3","title":"RPC_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-no-delete::bad::4","title":"RPC_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#bad","headings":["Bad"],"excerpt":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); // DeleteUser RPC was deleted - BREAKING CHANGE! } ```","content":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); // DeleteUser RPC was deleted - BREAKING CHANGE! } ```"},{"id":"cli/breaking-changes/rules/rpc-no-delete::good::5","title":"RPC_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, deprecate the RPC:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, deprecate the RPC:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-no-delete::good::6","title":"RPC_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#good","headings":["Good"],"excerpt":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse) { option de","content":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse) { option deprecated = true; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/rpc-no-delete::impact::7","title":"RPC_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Generated Code:** RPC method stubs are removed, breaking client compilation **Client Applications:** Existing calls to the RPC fail to compile **Runtime:** gRPC clients lose method definition","content":"Impact **Generated Code:** RPC method stubs are removed, breaking client compilation **Client Applications:** Existing calls to the RPC fail to compile **Runtime:** gRPC clients lose method definition"},{"id":"cli/breaking-changes/rules/rpc-no-delete::migration-strategy::8","title":"RPC_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate first:**","content":"Migration Strategy **Deprecate first:**"},{"id":"cli/breaking-changes/rules/rpc-no-delete::migration-strategy::9","title":"RPC_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Return error from implementation** indicating method is no longer supported","content":"Migration Strategy **Return error from implementation** indicating method is no longer supported"},{"id":"cli/breaking-changes/rules/rpc-no-delete::migration-strategy::10","title":"RPC_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove in next major version** after clients have migrated","content":"Migration Strategy **Remove in next major version** after clients have migrated"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::0","title":"RPC_SAME_REQUEST_TYPE","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":[],"excerpt":"This rule checks that RPC methods maintain the same request message type. Changing an RPC's request type breaks both wire format compatibility and generated code, as clients expect specific message structures when callin","content":"This rule checks that RPC methods maintain the same request message type. Changing an RPC's request type breaks both wire format compatibility and generated code, as clients expect specific message structures when calling the method."},{"id":"cli/breaking-changes/rules/rpc-same-request-type::bad::1","title":"RPC_SAME_REQUEST_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::bad::2","title":"RPC_SAME_REQUEST_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#bad","headings":["Bad"],"excerpt":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); }","content":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::bad::3","title":"RPC_SAME_REQUEST_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#bad","headings":["Bad"],"excerpt":"Bad message GetUserRequest { string user_id = 1; }","content":"Bad message GetUserRequest { string user_id = 1; }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::bad::4","title":"RPC_SAME_REQUEST_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#bad","headings":["Bad"],"excerpt":"Bad message UpdateUserRequest { string user_id = 1; string name = 2; string email = 3; } ```","content":"Bad message UpdateUserRequest { string user_id = 1; string name = 2; string email = 3; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::bad::5","title":"RPC_SAME_REQUEST_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::bad::6","title":"RPC_SAME_REQUEST_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#bad","headings":["Bad"],"excerpt":"Bad service UserService { rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // [!code --] Changed request type rpc UpdateUser(UserUpdateRequest) returns (UpdateUserResponse); // [!code --] Changed request type }","content":"Bad service UserService { rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // [!code --] Changed request type rpc UpdateUser(UserUpdateRequest) returns (UpdateUserResponse); // [!code --] Changed request type }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::bad::7","title":"RPC_SAME_REQUEST_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#bad","headings":["Bad"],"excerpt":"Bad message GetUserRequestV2 { // [!code --] Different message type string id = 1; bool include_profile = 2; }","content":"Bad message GetUserRequestV2 { // [!code --] Different message type string id = 1; bool include_profile = 2; }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::bad::8","title":"RPC_SAME_REQUEST_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#bad","headings":["Bad"],"excerpt":"Bad message UserUpdateRequest { // [!code --] Different message type string id = 1; UserProfile profile = 2; } ```","content":"Bad message UserUpdateRequest { // [!code --] Different message type string id = 1; UserProfile profile = 2; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::more-examples::9","title":"RPC_SAME_REQUEST_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#more-examples","headings":["More Examples"],"excerpt":"More Examples **Cross-package type changes:**","content":"More Examples **Cross-package type changes:**"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::more-examples::10","title":"RPC_SAME_REQUEST_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before import \"common/user.proto\";","content":"More Examples ```proto // Before import \"common/user.proto\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::more-examples::11","title":"RPC_SAME_REQUEST_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#more-examples","headings":["More Examples"],"excerpt":"More Examples service UserService { rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"More Examples service UserService { rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::more-examples::12","title":"RPC_SAME_REQUEST_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - BREAKING CHANGE! import \"v2/user.proto\";","content":"More Examples // After - BREAKING CHANGE! import \"v2/user.proto\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::more-examples::13","title":"RPC_SAME_REQUEST_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#more-examples","headings":["More Examples"],"excerpt":"More Examples service UserService { rpc CreateUser(v2.CreateUserRequest) returns (CreateUserResponse); // Different package } ```","content":"More Examples service UserService { rpc CreateUser(v2.CreateUserRequest) returns (CreateUserResponse); // Different package } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::good::14","title":"RPC_SAME_REQUEST_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#good","headings":["Good"],"excerpt":"Good **Instead of changing request type, version the RPC:** ```proto syntax = \"proto3\";","content":"Good **Instead of changing request type, version the RPC:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::good::15","title":"RPC_SAME_REQUEST_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#good","headings":["Good"],"excerpt":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; // [!code focus] } rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse); // [!code focus] // New RPC metho","content":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; // [!code focus] } rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse); // [!code focus] // New RPC method rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) { option deprecated = true; // [!code focus] } rpc UpdateUserV2(UserUpdateRequest) returns (UpdateUserResponse); // [!code focus] // New RPC method }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::good::16","title":"RPC_SAME_REQUEST_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#good","headings":["Good"],"excerpt":"Good // Keep old messages for backward compatibility message GetUserRequest { string user_id = 1; }","content":"Good // Keep old messages for backward compatibility message GetUserRequest { string user_id = 1; }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::good::17","title":"RPC_SAME_REQUEST_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#good","headings":["Good"],"excerpt":"Good // Add new messages for enhanced functionality message GetUserRequestV2 { // [!code focus] string id = 1; // [!code focus] bool include_profile = 2; // [!code focus] } // [!code focus] ```","content":"Good // Add new messages for enhanced functionality message GetUserRequestV2 { // [!code focus] string id = 1; // [!code focus] bool include_profile = 2; // [!code focus] } // [!code focus] ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::good::18","title":"RPC_SAME_REQUEST_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#good","headings":["Good"],"excerpt":"Good **Or create a new service version:** ```proto syntax = \"proto3\";","content":"Good **Or create a new service version:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::good::19","title":"RPC_SAME_REQUEST_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#good","headings":["Good"],"excerpt":"Good package myapi.v2; // [!code focus] // New package version","content":"Good package myapi.v2; // [!code focus] // New package version"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::good::20","title":"RPC_SAME_REQUEST_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#good","headings":["Good"],"excerpt":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] // Clean interface in v2 rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus] }","content":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] // Clean interface in v2 rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus] }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::good::21","title":"RPC_SAME_REQUEST_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#good","headings":["Good"],"excerpt":"Good message GetUserRequest { // [!code focus] string id = 1; // [!code focus] // Improved field names bool include_profile = 2; // [!code focus] } // [!code focus] ```","content":"Good message GetUserRequest { // [!code focus] string id = 1; // [!code focus] // Improved field names bool include_profile = 2; // [!code focus] } // [!code focus] ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::impact::22","title":"RPC_SAME_REQUEST_TYPE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Existing client requests cannot be deserialized by new server **Generated Code:** Client stubs expect different request message types, breaking compilation **gRPC Calls:** Method signatures change","content":"Impact **Wire Format:** Existing client requests cannot be deserialized by new server **Generated Code:** Client stubs expect different request message types, breaking compilation **gRPC Calls:** Method signatures change in generated client code **Runtime Errors:** Type mismatches cause RPC call failures"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::real-world-example::23","title":"RPC_SAME_REQUEST_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", })","content":"Real-World Example **Client code breaks:** ```go // Before - this code works client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", })"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::real-world-example::24","title":"RPC_SAME_REQUEST_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After request type change - compilation fails client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ // ERROR: type not found UserId: \"user123\", // ERROR:","content":"Real-World Example // After request type change - compilation fails client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ // ERROR: type not found UserId: \"user123\", // ERROR: field not found })"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::real-world-example::25","title":"RPC_SAME_REQUEST_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Must use new type: resp, err := client.GetUser(ctx, &myapi.GetUserRequestV2{ Id: \"user123\", // Different field name IncludeProfile: true, // New required field }) ```","content":"Real-World Example // Must use new type: resp, err := client.GetUser(ctx, &myapi.GetUserRequestV2{ Id: \"user123\", // Different field name IncludeProfile: true, // New required field }) ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::real-world-example::26","title":"RPC_SAME_REQUEST_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server implementation breaks:** ```go // Before - server expects GetUserRequest func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { userID := req.UserId // ","content":"Real-World Example **Server implementation breaks:** ```go // Before - server expects GetUserRequest func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { userID := req.UserId // This field exists // ... implementation }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::real-world-example::27","title":"RPC_SAME_REQUEST_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After - server must handle GetUserRequestV2 func (s *server) GetUser(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) { userID := req.Id // Different field name includeProfile :","content":"Real-World Example // After - server must handle GetUserRequestV2 func (s *server) GetUser(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) { userID := req.Id // Different field name includeProfile := req.IncludeProfile // New field to handle // ... implementation must change } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::migration-strategy::28","title":"RPC_SAME_REQUEST_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Add new RPC method** with improved request type:","content":"Migration Strategy **Add new RPC method** with improved request type:"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::migration-strategy::29","title":"RPC_SAME_REQUEST_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Implement both methods** on server during transition:","content":"Migration Strategy **Implement both methods** on server during transition:"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::migration-strategy::30","title":"RPC_SAME_REQUEST_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Migrate clients** to use new RPC method:","content":"Migration Strategy **Migrate clients** to use new RPC method:"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::migration-strategy::31","title":"RPC_SAME_REQUEST_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove old RPC** in next major version:","content":"Migration Strategy **Remove old RPC** in next major version:"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::adding-required-fields::32","title":"RPC_SAME_REQUEST_TYPE","section":"Adding Required Fields","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#adding-required-fields","headings":["Adding Required Fields"],"excerpt":"Adding Required Fields ```proto // Instead of modifying existing request message GetUserRequest { string user_id = 1; bool include_deleted = 2; // BREAKING: new required field }","content":"Adding Required Fields ```proto // Instead of modifying existing request message GetUserRequest { string user_id = 1; bool include_deleted = 2; // BREAKING: new required field }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::adding-required-fields::33","title":"RPC_SAME_REQUEST_TYPE","section":"Adding Required Fields","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#adding-required-fields","headings":["Adding Required Fields"],"excerpt":"Adding Required Fields // Add new RPC method message GetUserRequestV2 { string user_id = 1; bool include_deleted = 2; // Safe in new method } ```","content":"Adding Required Fields // Add new RPC method message GetUserRequestV2 { string user_id = 1; bool include_deleted = 2; // Safe in new method } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::restructuring-request-data::34","title":"RPC_SAME_REQUEST_TYPE","section":"Restructuring Request Data","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#restructuring-request-data","headings":["Restructuring Request Data"],"excerpt":"Restructuring Request Data ```proto // Instead of changing field structure message UpdateUserRequest { UserProfile profile = 1; // BREAKING: was individual fields }","content":"Restructuring Request Data ```proto // Instead of changing field structure message UpdateUserRequest { UserProfile profile = 1; // BREAKING: was individual fields }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::restructuring-request-data::35","title":"RPC_SAME_REQUEST_TYPE","section":"Restructuring Request Data","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#restructuring-request-data","headings":["Restructuring Request Data"],"excerpt":"Restructuring Request Data // Version the RPC rpc UpdateUser(UpdateUserRequest) returns (...) { option deprecated = true; } rpc UpdateUserV2(UpdateUserRequestV2) returns (...); ```","content":"Restructuring Request Data // Version the RPC rpc UpdateUser(UpdateUserRequest) returns (...) { option deprecated = true; } rpc UpdateUserV2(UpdateUserRequestV2) returns (...); ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::package-migrations::36","title":"RPC_SAME_REQUEST_TYPE","section":"Package Migrations","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#package-migrations","headings":["Package Migrations"],"excerpt":"Package Migrations ```proto // Instead of changing import packages import \"v2/messages.proto\"; // BREAKING: different package","content":"Package Migrations ```proto // Instead of changing import packages import \"v2/messages.proto\"; // BREAKING: different package"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::package-migrations::37","title":"RPC_SAME_REQUEST_TYPE","section":"Package Migrations","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#package-migrations","headings":["Package Migrations"],"excerpt":"Package Migrations // Keep old RPC, add new one rpc OldMethod(v1.Request) returns (...) { option deprecated = true; } rpc NewMethod(v2.Request) returns (...); ```","content":"Package Migrations // Keep old RPC, add new one rpc OldMethod(v1.Request) returns (...) { option deprecated = true; } rpc NewMethod(v2.Request) returns (...); ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::0","title":"RPC_SAME_RESPONSE_TYPE","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":[],"excerpt":"This rule checks that RPC methods maintain the same response message type. Changing an RPC's response type breaks both wire format compatibility and generated code, as clients expect specific message structures when rece","content":"This rule checks that RPC methods maintain the same response message type. Changing an RPC's response type breaks both wire format compatibility and generated code, as clients expect specific message structures when receiving responses from the method."},{"id":"cli/breaking-changes/rules/rpc-same-response-type::bad::1","title":"RPC_SAME_RESPONSE_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::bad::2","title":"RPC_SAME_RESPONSE_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#bad","headings":["Bad"],"excerpt":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); }","content":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::bad::3","title":"RPC_SAME_RESPONSE_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#bad","headings":["Bad"],"excerpt":"Bad message GetUserResponse { string user_id = 1; string name = 2; string email = 3; }","content":"Bad message GetUserResponse { string user_id = 1; string name = 2; string email = 3; }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::bad::4","title":"RPC_SAME_RESPONSE_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#bad","headings":["Bad"],"excerpt":"Bad message UpdateUserResponse { bool success = 1; string message = 2; } ```","content":"Bad message UpdateUserResponse { bool success = 1; string message = 2; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::bad::5","title":"RPC_SAME_RESPONSE_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::bad::6","title":"RPC_SAME_RESPONSE_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#bad","headings":["Bad"],"excerpt":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponseV2); // [!code --] Changed response type rpc UpdateUser(UpdateUserRequest) returns (UserUpdateResponse); // [!code --] Changed response type }","content":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponseV2); // [!code --] Changed response type rpc UpdateUser(UpdateUserRequest) returns (UserUpdateResponse); // [!code --] Changed response type }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::bad::7","title":"RPC_SAME_RESPONSE_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#bad","headings":["Bad"],"excerpt":"Bad message GetUserResponseV2 { // [!code --] Different message type string id = 1; UserProfile profile = 2; repeated string permissions = 3; }","content":"Bad message GetUserResponseV2 { // [!code --] Different message type string id = 1; UserProfile profile = 2; repeated string permissions = 3; }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::bad::8","title":"RPC_SAME_RESPONSE_TYPE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#bad","headings":["Bad"],"excerpt":"Bad message UserUpdateResponse { // [!code --] Different message type UpdateResult result = 1; UserProfile updated_profile = 2; } ```","content":"Bad message UserUpdateResponse { // [!code --] Different message type UpdateResult result = 1; UserProfile updated_profile = 2; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::more-examples::9","title":"RPC_SAME_RESPONSE_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#more-examples","headings":["More Examples"],"excerpt":"More Examples **Cross-package type changes:**","content":"More Examples **Cross-package type changes:**"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::more-examples::10","title":"RPC_SAME_RESPONSE_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#more-examples","headings":["More Examples"],"excerpt":"More Examples ```proto // Before import \"common/responses.proto\";","content":"More Examples ```proto // Before import \"common/responses.proto\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::more-examples::11","title":"RPC_SAME_RESPONSE_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#more-examples","headings":["More Examples"],"excerpt":"More Examples service UserService { rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"More Examples service UserService { rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::more-examples::12","title":"RPC_SAME_RESPONSE_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#more-examples","headings":["More Examples"],"excerpt":"More Examples // After - BREAKING CHANGE! import \"v2/responses.proto\";","content":"More Examples // After - BREAKING CHANGE! import \"v2/responses.proto\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::more-examples::13","title":"RPC_SAME_RESPONSE_TYPE","section":"More Examples","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#more-examples","headings":["More Examples"],"excerpt":"More Examples service UserService { rpc CreateUser(CreateUserRequest) returns (v2.CreateUserResponse); // Different package } ```","content":"More Examples service UserService { rpc CreateUser(CreateUserRequest) returns (v2.CreateUserResponse); // Different package } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::good::14","title":"RPC_SAME_RESPONSE_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#good","headings":["Good"],"excerpt":"Good **Instead of changing response type, version the RPC:** ```proto syntax = \"proto3\";","content":"Good **Instead of changing response type, version the RPC:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::good::15","title":"RPC_SAME_RESPONSE_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#good","headings":["Good"],"excerpt":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; // [!code focus] } rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2); // [!code focus] // New RPC metho","content":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; // [!code focus] } rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2); // [!code focus] // New RPC method rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) { option deprecated = true; // [!code focus] } rpc UpdateUserV2(UpdateUserRequest) returns (UserUpdateResponse); // [!code focus] // New RPC method }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::good::16","title":"RPC_SAME_RESPONSE_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#good","headings":["Good"],"excerpt":"Good // Keep old messages for backward compatibility message GetUserResponse { string user_id = 1; string name = 2; string email = 3; }","content":"Good // Keep old messages for backward compatibility message GetUserResponse { string user_id = 1; string name = 2; string email = 3; }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::good::17","title":"RPC_SAME_RESPONSE_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#good","headings":["Good"],"excerpt":"Good // Add new messages for enhanced functionality message GetUserResponseV2 { // [!code focus] string id = 1; // [!code focus] UserProfile profile = 2; // [!code focus] repeated string permissions = 3; // [!code focus]","content":"Good // Add new messages for enhanced functionality message GetUserResponseV2 { // [!code focus] string id = 1; // [!code focus] UserProfile profile = 2; // [!code focus] repeated string permissions = 3; // [!code focus] } // [!code focus] ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::good::18","title":"RPC_SAME_RESPONSE_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#good","headings":["Good"],"excerpt":"Good **Or create a new service version:** ```proto syntax = \"proto3\";","content":"Good **Or create a new service version:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::good::19","title":"RPC_SAME_RESPONSE_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#good","headings":["Good"],"excerpt":"Good package myapi.v2; // [!code focus] // New package version","content":"Good package myapi.v2; // [!code focus] // New package version"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::good::20","title":"RPC_SAME_RESPONSE_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#good","headings":["Good"],"excerpt":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] // Clean interface in v2 rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus] }","content":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] // Clean interface in v2 rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus] }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::good::21","title":"RPC_SAME_RESPONSE_TYPE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#good","headings":["Good"],"excerpt":"Good message GetUserResponse { // [!code focus] string id = 1; // [!code focus] // Improved field names UserProfile profile = 2; // [!code focus] repeated string permissions = 3; // [!code focus] } // [!code focus] ```","content":"Good message GetUserResponse { // [!code focus] string id = 1; // [!code focus] // Improved field names UserProfile profile = 2; // [!code focus] repeated string permissions = 3; // [!code focus] } // [!code focus] ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::impact::22","title":"RPC_SAME_RESPONSE_TYPE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#impact","headings":["Impact"],"excerpt":"Impact **Wire Format:** Server responses cannot be deserialized by existing clients **Generated Code:** Client stubs expect different response message types, breaking compilation **gRPC Calls:** Method signatures change ","content":"Impact **Wire Format:** Server responses cannot be deserialized by existing clients **Generated Code:** Client stubs expect different response message types, breaking compilation **gRPC Calls:** Method signatures change in generated client code **Runtime Errors:** Type mismatches cause RPC response handling failures"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::real-world-example::23","title":"RPC_SAME_RESPONSE_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Client code breaks:** ```go // Before - this code works client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", }) if err != nil { return","content":"Real-World Example **Client code breaks:** ```go // Before - this code works client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", }) if err != nil { return err }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::real-world-example::24","title":"RPC_SAME_RESPONSE_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Access response fields userID := resp.UserId // This field exists name := resp.Name // This field exists","content":"Real-World Example // Access response fields userID := resp.UserId // This field exists name := resp.Name // This field exists"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::real-world-example::25","title":"RPC_SAME_RESPONSE_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After response type change - compilation fails client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", }) if err != nil { return err }","content":"Real-World Example // After response type change - compilation fails client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", }) if err != nil { return err }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::real-world-example::26","title":"RPC_SAME_RESPONSE_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Access response fields - COMPILATION ERRORS userID := resp.UserId // ERROR: field not found name := resp.Name // ERROR: field not found","content":"Real-World Example // Access response fields - COMPILATION ERRORS userID := resp.UserId // ERROR: field not found name := resp.Name // ERROR: field not found"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::real-world-example::27","title":"RPC_SAME_RESPONSE_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // Must use new fields: userID := resp.Id // Different field name profile := resp.Profile // New structure permissions := resp.Permissions // New field ```","content":"Real-World Example // Must use new fields: userID := resp.Id // Different field name profile := resp.Profile // New structure permissions := resp.Permissions // New field ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::real-world-example::28","title":"RPC_SAME_RESPONSE_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example **Server implementation breaks:** ```go // Before - server returns GetUserResponse func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { return &GetUserResponse","content":"Real-World Example **Server implementation breaks:** ```go // Before - server returns GetUserResponse func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { return &GetUserResponse{ UserId: \"user123\", Name: \"John Doe\", Email: \"john@example.com\", }, nil }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::real-world-example::29","title":"RPC_SAME_RESPONSE_TYPE","section":"Real-World Example","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#real-world-example","headings":["Real-World Example"],"excerpt":"Real-World Example // After - server must return GetUserResponseV2 func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) { return &GetUserResponseV2{ Id: \"user123\", // Different f","content":"Real-World Example // After - server must return GetUserResponseV2 func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) { return &GetUserResponseV2{ Id: \"user123\", // Different field name Profile: &UserProfile{ // New structure required Name: \"John Doe\", Email: \"john@example.com\", }, Permissions: []string{\"read\"}, // New field to populate }, nil } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::migration-strategy::30","title":"RPC_SAME_RESPONSE_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Add new RPC method** with improved response type:","content":"Migration Strategy **Add new RPC method** with improved response type:"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::migration-strategy::31","title":"RPC_SAME_RESPONSE_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Implement both methods** on server during transition:","content":"Migration Strategy **Implement both methods** on server during transition:"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::migration-strategy::32","title":"RPC_SAME_RESPONSE_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Migrate clients** to use new RPC method:","content":"Migration Strategy **Migrate clients** to use new RPC method:"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::migration-strategy::33","title":"RPC_SAME_RESPONSE_TYPE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove old RPC** in next major version:","content":"Migration Strategy **Remove old RPC** in next major version:"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::adding-fields-to-response::34","title":"RPC_SAME_RESPONSE_TYPE","section":"Adding Fields to Response","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#adding-fields-to-response","headings":["Adding Fields to Response"],"excerpt":"Adding Fields to Response ```proto // Instead of modifying existing response message GetUserResponse { string user_id = 1; string name = 2; UserProfile profile = 3; // BREAKING: new required field }","content":"Adding Fields to Response ```proto // Instead of modifying existing response message GetUserResponse { string user_id = 1; string name = 2; UserProfile profile = 3; // BREAKING: new required field }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::adding-fields-to-response::35","title":"RPC_SAME_RESPONSE_TYPE","section":"Adding Fields to Response","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#adding-fields-to-response","headings":["Adding Fields to Response"],"excerpt":"Adding Fields to Response // Add new RPC method message GetUserResponseV2 { string user_id = 1; string name = 2; UserProfile profile = 3; // Safe in new method } ```","content":"Adding Fields to Response // Add new RPC method message GetUserResponseV2 { string user_id = 1; string name = 2; UserProfile profile = 3; // Safe in new method } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::restructuring-response-data::36","title":"RPC_SAME_RESPONSE_TYPE","section":"Restructuring Response Data","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#restructuring-response-data","headings":["Restructuring Response Data"],"excerpt":"Restructuring Response Data ```proto // Instead of changing field structure message UpdateUserResponse { UserDetails details = 1; // BREAKING: was individual fields }","content":"Restructuring Response Data ```proto // Instead of changing field structure message UpdateUserResponse { UserDetails details = 1; // BREAKING: was individual fields }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::restructuring-response-data::37","title":"RPC_SAME_RESPONSE_TYPE","section":"Restructuring Response Data","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#restructuring-response-data","headings":["Restructuring Response Data"],"excerpt":"Restructuring Response Data // Version the RPC rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) { option deprecated = true; } rpc UpdateUserV2(UpdateUserRequest) returns (UpdateUserResponseV2); ```","content":"Restructuring Response Data // Version the RPC rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) { option deprecated = true; } rpc UpdateUserV2(UpdateUserRequest) returns (UpdateUserResponseV2); ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::error-handling-changes::38","title":"RPC_SAME_RESPONSE_TYPE","section":"Error Handling Changes","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#error-handling-changes","headings":["Error Handling Changes"],"excerpt":"Error Handling Changes ```proto // Instead of changing error structure message CreateUserResponse { ErrorDetails error = 1; // BREAKING: different error format }","content":"Error Handling Changes ```proto // Instead of changing error structure message CreateUserResponse { ErrorDetails error = 1; // BREAKING: different error format }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::error-handling-changes::39","title":"RPC_SAME_RESPONSE_TYPE","section":"Error Handling Changes","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#error-handling-changes","headings":["Error Handling Changes"],"excerpt":"Error Handling Changes // Keep old RPC, add new one rpc CreateUser(CreateUserRequest) returns (CreateUserResponse) { option deprecated = true; } rpc CreateUserV2(CreateUserRequest) returns (CreateUserResponseV2); ```","content":"Error Handling Changes // Keep old RPC, add new one rpc CreateUser(CreateUserRequest) returns (CreateUserResponse) { option deprecated = true; } rpc CreateUserV2(CreateUserRequest) returns (CreateUserResponseV2); ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::response-format-migration::40","title":"RPC_SAME_RESPONSE_TYPE","section":"Response Format Migration","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#response-format-migration","headings":["Response Format Migration"],"excerpt":"Response Format Migration ```proto // Instead of changing from simple to complex response message GetUserResponse { // BREAKING: changed from simple fields to nested structure UserData data = 1; }","content":"Response Format Migration ```proto // Instead of changing from simple to complex response message GetUserResponse { // BREAKING: changed from simple fields to nested structure UserData data = 1; }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::response-format-migration::41","title":"RPC_SAME_RESPONSE_TYPE","section":"Response Format Migration","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#response-format-migration","headings":["Response Format Migration"],"excerpt":"Response Format Migration // Provide both formats during transition rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; } rpc GetUserDetailed(GetUserRequest) returns (GetUserDetailedResponse","content":"Response Format Migration // Provide both formats during transition rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; } rpc GetUserDetailed(GetUserRequest) returns (GetUserDetailedResponse); ```"},{"id":"cli/breaking-changes/rules/service-no-delete::top::0","title":"SERVICE_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":[],"excerpt":"This rule checks that no services are deleted from proto files. Deleting a service breaks both generated code and client applications that depend on the service.","content":"This rule checks that no services are deleted from proto files. Deleting a service breaks both generated code and client applications that depend on the service."},{"id":"cli/breaking-changes/rules/service-no-delete::bad::1","title":"SERVICE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#bad","headings":["Bad"],"excerpt":"Bad **Before:** ```proto syntax = \"proto3\";","content":"Bad **Before:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/service-no-delete::bad::2","title":"SERVICE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#bad","headings":["Bad"],"excerpt":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/service-no-delete::bad::3","title":"SERVICE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#bad","headings":["Bad"],"excerpt":"Bad service OrderService { // [!code --] rpc GetOrder(GetOrderRequest) returns (GetOrderResponse); // [!code --] } // [!code --] ```","content":"Bad service OrderService { // [!code --] rpc GetOrder(GetOrderRequest) returns (GetOrderResponse); // [!code --] } // [!code --] ```"},{"id":"cli/breaking-changes/rules/service-no-delete::bad::4","title":"SERVICE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#bad","headings":["Bad"],"excerpt":"Bad **After:** ```proto syntax = \"proto3\";","content":"Bad **After:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/service-no-delete::bad::5","title":"SERVICE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#bad","headings":["Bad"],"excerpt":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"Bad service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/service-no-delete::bad::6","title":"SERVICE_NO_DELETE","section":"Bad","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#bad","headings":["Bad"],"excerpt":"Bad // OrderService was deleted - BREAKING CHANGE! ```","content":"Bad // OrderService was deleted - BREAKING CHANGE! ```"},{"id":"cli/breaking-changes/rules/service-no-delete::good::7","title":"SERVICE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#good","headings":["Good"],"excerpt":"Good **Instead of deleting, deprecate the service:** ```proto syntax = \"proto3\";","content":"Good **Instead of deleting, deprecate the service:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/service-no-delete::good::8","title":"SERVICE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#good","headings":["Good"],"excerpt":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"Good service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/service-no-delete::good::9","title":"SERVICE_NO_DELETE","section":"Good","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#good","headings":["Good"],"excerpt":"Good service OrderService { option deprecated = true; // [!code focus] rpc GetOrder(GetOrderRequest) returns (GetOrderResponse) { option deprecated = true; // [!code focus] } } ```","content":"Good service OrderService { option deprecated = true; // [!code focus] rpc GetOrder(GetOrderRequest) returns (GetOrderResponse) { option deprecated = true; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/service-no-delete::impact::10","title":"SERVICE_NO_DELETE","section":"Impact","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#impact","headings":["Impact"],"excerpt":"Impact **Generated Code:** Service classes/interfaces are removed, breaking client compilation **Client Applications:** Existing client code fails to compile **Runtime:** gRPC clients lose service definition","content":"Impact **Generated Code:** Service classes/interfaces are removed, breaking client compilation **Client Applications:** Existing client code fails to compile **Runtime:** gRPC clients lose service definition"},{"id":"cli/breaking-changes/rules/service-no-delete::migration-strategy::11","title":"SERVICE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Deprecate first:**","content":"Migration Strategy **Deprecate first:**"},{"id":"cli/breaking-changes/rules/service-no-delete::migration-strategy::12","title":"SERVICE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Notify clients** about deprecation timeline","content":"Migration Strategy **Notify clients** about deprecation timeline"},{"id":"cli/breaking-changes/rules/service-no-delete::migration-strategy::13","title":"SERVICE_NO_DELETE","section":"Migration Strategy","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#migration-strategy","headings":["Migration Strategy"],"excerpt":"Migration Strategy **Remove after migration period** in a new major version","content":"Migration Strategy **Remove after migration period** in a new major version"},{"id":"cli/configuration/configuration::top::0","title":"EasyP Configuration Reference","path":"/docs/guide/cli/configuration/configuration","headings":[],"excerpt":"EasyP can be configured through CLI flags, environment variables, and configuration files. This guide covers all configuration options available in EasyP.","content":"EasyP can be configured through CLI flags, environment variables, and configuration files. This guide covers all configuration options available in EasyP."},{"id":"cli/configuration/configuration::global-flags::1","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags Available for all commands:","content":"Global Flags Available for all commands:"},{"id":"cli/configuration/configuration::global-flags::2","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --cfg -c EASYP_CFG Configuration file path easyp.yaml --config EASYP_CFG Alias for --cfg easyp.yaml --debug -d ","content":"Global Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --cfg -c EASYP_CFG Configuration file path easyp.yaml --config EASYP_CFG Alias for --cfg easyp.yaml --debug -d EASYP_DEBUG Enable debug mode false --format -f EASYP_FORMAT Output format for commands that support multiple formats (text/json) command-specific default"},{"id":"cli/configuration/configuration::global-flags::3","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags **Examples:** ```bash Use custom config file easyp --cfg production.easyp.yaml lint","content":"Global Flags **Examples:** ```bash Use custom config file easyp --cfg production.easyp.yaml lint"},{"id":"cli/configuration/configuration::global-flags::4","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags Enable debug logging easyp --debug lint","content":"Global Flags Enable debug logging easyp --debug lint"},{"id":"cli/configuration/configuration::global-flags::5","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags Short form easyp -c custom.yaml -d lint ```","content":"Global Flags Short form easyp -c custom.yaml -d lint ```"},{"id":"cli/configuration/configuration::command-specific-flags::6","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Lint command:**","content":"Command-Specific Flags **Lint command:**"},{"id":"cli/configuration/configuration::command-specific-flags::7","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --path -p Directory path to lint . --root -r Base directory for file search Current working directory","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --path -p Directory path to lint . --root -r Base directory for file search Current working directory --format -f EASYP_FORMAT Uses global format flag (text/json) Inherits global default"},{"id":"cli/configuration/configuration::command-specific-flags::8","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Lint specific directory easyp lint --path proto/","content":"Command-Specific Flags **Examples:** ```bash Lint specific directory easyp lint --path proto/"},{"id":"cli/configuration/configuration::command-specific-flags::9","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Lint from subdirectory with proper import resolution easyp lint --root src/IPC/Contracts --path .","content":"Command-Specific Flags Lint from subdirectory with proper import resolution easyp lint --root src/IPC/Contracts --path ."},{"id":"cli/configuration/configuration::command-specific-flags::10","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags JSON output format easyp --format json lint # global flag","content":"Command-Specific Flags JSON output format easyp --format json lint # global flag"},{"id":"cli/configuration/configuration::command-specific-flags::11","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Combined flags easyp -f json lint -p proto/ ```","content":"Command-Specific Flags Combined flags easyp -f json lint -p proto/ ```"},{"id":"cli/configuration/configuration::command-specific-flags::12","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Generate command:**","content":"Command-Specific Flags **Generate command:**"},{"id":"cli/configuration/configuration::command-specific-flags::13","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --path -p EASYP_ROOT_GENERATE_PATH Directory path with proto files to generate . --root -r Base direc","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --path -p EASYP_ROOT_GENERATE_PATH Directory path with proto files to generate . --root -r Base directory for file search Current working directory"},{"id":"cli/configuration/configuration::command-specific-flags::14","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Generate from specific path easyp generate --path api/","content":"Command-Specific Flags **Examples:** ```bash Generate from specific path easyp generate --path api/"},{"id":"cli/configuration/configuration::command-specific-flags::15","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Generate from subdirectory with proper import resolution easyp generate --root src/IPC/Contracts --path .","content":"Command-Specific Flags Generate from subdirectory with proper import resolution easyp generate --root src/IPC/Contracts --path ."},{"id":"cli/configuration/configuration::command-specific-flags::16","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Using environment variable EASYP_ROOT_GENERATE_PATH=proto/ easyp generate ```","content":"Command-Specific Flags Using environment variable EASYP_ROOT_GENERATE_PATH=proto/ easyp generate ```"},{"id":"cli/configuration/configuration::command-specific-flags::17","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Breaking command:**","content":"Command-Specific Flags **Breaking command:**"},{"id":"cli/configuration/configuration::command-specific-flags::18","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --against Git ref to compare against master --path -p Directory path to check . --format -f EASYP_FOR","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --against Git ref to compare against master --path -p Directory path to check . --format -f EASYP_FORMAT Uses global format flag (text/json) Inherits global default"},{"id":"cli/configuration/configuration::command-specific-flags::19","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Check against main branch easyp breaking --against main","content":"Command-Specific Flags **Examples:** ```bash Check against main branch easyp breaking --against main"},{"id":"cli/configuration/configuration::command-specific-flags::20","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Check specific directory against develop branch easyp breaking --against develop --path proto/","content":"Command-Specific Flags Check specific directory against develop branch easyp breaking --against develop --path proto/"},{"id":"cli/configuration/configuration::command-specific-flags::21","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags JSON output easyp --format json breaking --against main # global flag ```","content":"Command-Specific Flags JSON output easyp --format json breaking --against main # global flag ```"},{"id":"cli/configuration/configuration::command-specific-flags::22","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Init command:**","content":"Command-Specific Flags **Init command:**"},{"id":"cli/configuration/configuration::command-specific-flags::23","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --dir -d EASYP_INIT_DIR Directory to initialize .","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --dir -d EASYP_INIT_DIR Directory to initialize ."},{"id":"cli/configuration/configuration::command-specific-flags::24","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Initialize current directory easyp init","content":"Command-Specific Flags **Examples:** ```bash Initialize current directory easyp init"},{"id":"cli/configuration/configuration::command-specific-flags::25","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Initialize specific directory easyp init --dir proto-project/ ```","content":"Command-Specific Flags Initialize specific directory easyp init --dir proto-project/ ```"},{"id":"cli/configuration/configuration::command-specific-flags::26","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags easyp init is interactive: If buf.yml/buf.yaml exists in the target directory root, it asks whether to migrate from Buf. If easyp.yaml already exists, it asks for overwrite confirmation.","content":"Command-Specific Flags easyp init is interactive: If buf.yml/buf.yaml exists in the target directory root, it asks whether to migrate from Buf. If easyp.yaml already exists, it asks for overwrite confirmation."},{"id":"cli/configuration/configuration::command-specific-flags::27","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Validate-config command:**","content":"Command-Specific Flags **Validate-config command:**"},{"id":"cli/configuration/configuration::command-specific-flags::28","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --config -c EASYP_CFG Configuration file path easyp.yaml --format (global) -f EASYP_FORMAT Output for","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --config -c EASYP_CFG Configuration file path easyp.yaml --format (global) -f EASYP_FORMAT Output format for commands that support multiple formats (json or text) command-specific (json for validate-config)"},{"id":"cli/configuration/configuration::command-specific-flags::29","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Validate default config with JSON output (exit 0 when no errors) easyp validate-config","content":"Command-Specific Flags **Examples:** ```bash Validate default config with JSON output (exit 0 when no errors) easyp validate-config"},{"id":"cli/configuration/configuration::command-specific-flags::30","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Validate a different file with text output (global --format) easyp --format text validate-config --config example.easyp.yaml ```","content":"Command-Specific Flags Validate a different file with text output (global --format) easyp --format text validate-config --config example.easyp.yaml ```"},{"id":"cli/configuration/configuration::command-specific-flags::31","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Package management commands:**","content":"Command-Specific Flags **Package management commands:**"},{"id":"cli/configuration/configuration::easyp-mod-download::32","title":"EasyP Configuration Reference","section":"easyp mod download","path":"/docs/guide/cli/configuration/configuration#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download Downloads dependencies based on lock file priority:","content":"easyp mod download Downloads dependencies based on lock file priority:"},{"id":"cli/configuration/configuration::easyp-mod-download::33","title":"EasyP Configuration Reference","section":"easyp mod download","path":"/docs/guide/cli/configuration/configuration#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download **If easyp.lock exists** - downloads exact versions from lock file **If easyp.lock is missing** - downloads versions from easyp.yaml and creates easyp.lock","content":"easyp mod download **If easyp.lock exists** - downloads exact versions from lock file **If easyp.lock is missing** - downloads versions from easyp.yaml and creates easyp.lock"},{"id":"cli/configuration/configuration::easyp-mod-update::34","title":"EasyP Configuration Reference","section":"easyp mod update","path":"/docs/guide/cli/configuration/configuration#easyp-mod-update","headings":["easyp mod update"],"excerpt":"easyp mod update Always downloads dependencies from easyp.yaml, ignoring existing lock file:","content":"easyp mod update Always downloads dependencies from easyp.yaml, ignoring existing lock file:"},{"id":"cli/configuration/configuration::easyp-mod-update::35","title":"EasyP Configuration Reference","section":"easyp mod update","path":"/docs/guide/cli/configuration/configuration#easyp-mod-update","headings":["easyp mod update"],"excerpt":"easyp mod update **Ignores easyp.lock** completely **Downloads versions from easyp.yaml** **Creates/updates easyp.lock** with new versions","content":"easyp mod update **Ignores easyp.lock** completely **Downloads versions from easyp.yaml** **Creates/updates easyp.lock** with new versions"},{"id":"cli/configuration/configuration::easyp-mod-vendor::36","title":"EasyP Configuration Reference","section":"easyp mod vendor","path":"/docs/guide/cli/configuration/configuration#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor Copies proto files from dependencies to local vendor/ directory (similar to go mod vendor).","content":"easyp mod vendor Copies proto files from dependencies to local vendor/ directory (similar to go mod vendor)."},{"id":"cli/configuration/configuration::easyp-mod-vendor::37","title":"EasyP Configuration Reference","section":"easyp mod vendor","path":"/docs/guide/cli/configuration/configuration#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor No additional flags. Uses global --cfg flag for configuration.","content":"easyp mod vendor No additional flags. Uses global --cfg flag for configuration."},{"id":"cli/configuration/configuration::environment-variables::38","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables EasyP supports environment variables for configuration:","content":"Environment Variables EasyP supports environment variables for configuration:"},{"id":"cli/configuration/configuration::environment-variables::39","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables Variable Description Default ---------- ------------- --------- EASYP_CFG Path to configuration file easyp.yaml EASYP_DEBUG Enable debug logging false EASYPPATH Cache and modules storage directory $","content":"Environment Variables Variable Description Default ---------- ------------- --------- EASYP_CFG Path to configuration file easyp.yaml EASYP_DEBUG Enable debug logging false EASYPPATH Cache and modules storage directory $HOME/.easyp EASYP_FORMAT Output format for supported commands (text/json). If not set, each command uses its own default. command-specific default EASYP_ROOT_GENERATE_PATH Root path for generate command . EASYP_INIT_DIR Directory for init command ."},{"id":"cli/configuration/configuration::environment-variables::40","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables **Examples:** ```bash Custom cache directory export EASYPPATH=/tmp/easyp-cache easyp mod download","content":"Environment Variables **Examples:** ```bash Custom cache directory export EASYPPATH=/tmp/easyp-cache easyp mod download"},{"id":"cli/configuration/configuration::environment-variables::41","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables Debug mode via environment export EASYP_DEBUG=true easyp lint","content":"Environment Variables Debug mode via environment export EASYP_DEBUG=true easyp lint"},{"id":"cli/configuration/configuration::environment-variables::42","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables Custom config file export EASYP_CFG=config/easyp.yaml easyp generate ```","content":"Environment Variables Custom config file export EASYP_CFG=config/easyp.yaml easyp generate ```"},{"id":"cli/configuration/configuration::configuration-file::43","title":"EasyP Configuration Reference","section":"Configuration File","path":"/docs/guide/cli/configuration/configuration#configuration-file","headings":["Configuration File"],"excerpt":"Configuration File The easyp.yaml file is the main configuration file for EasyP, defining how your proto files are linted, generated, and managed. This file is typically placed at the root of your project alongside your ","content":"Configuration File The easyp.yaml file is the main configuration file for EasyP, defining how your proto files are linted, generated, and managed. This file is typically placed at the root of your project alongside your proto files."},{"id":"cli/configuration/configuration::configuration-format::44","title":"EasyP Configuration Reference","section":"Configuration Format","path":"/docs/guide/cli/configuration/configuration#configuration-format","headings":["Configuration Format"],"excerpt":"Configuration Format EasyP supports both YAML and JSON configuration formats:","content":"Configuration Format EasyP supports both YAML and JSON configuration formats:"},{"id":"cli/configuration/configuration::environment-variables-in-configuration::45","title":"EasyP Configuration Reference","section":"Environment Variables in Configuration","path":"/docs/guide/cli/configuration/configuration#environment-variables-in-configuration","headings":["Environment Variables in Configuration"],"excerpt":"Environment Variables in Configuration EasyP supports environment variable expansion directly in the easyp.yaml configuration file. This allows you to use environment variables for dynamic configuration values.","content":"Environment Variables in Configuration EasyP supports environment variable expansion directly in the easyp.yaml configuration file. This allows you to use environment variables for dynamic configuration values."},{"id":"cli/configuration/configuration::environment-variables-in-configuration::46","title":"EasyP Configuration Reference","section":"Environment Variables in Configuration","path":"/docs/guide/cli/configuration/configuration#environment-variables-in-configuration","headings":["Environment Variables in Configuration"],"excerpt":"Environment Variables in Configuration **Example with all supported features:** ```yaml deps: # Basic expansion: ${VAR} - expands to the value of VAR - ${GOOGLEAPIS_REPO}@${GOOGLEAPIS_VERSION} # Default value: ${VAR:-def","content":"Environment Variables in Configuration **Example with all supported features:** ```yaml deps: # Basic expansion: ${VAR} - expands to the value of VAR - ${GOOGLEAPIS_REPO}@${GOOGLEAPIS_VERSION} # Default value: ${VAR:-default} - uses default if VAR is unset or empty - ${GNOSTIC_REPO:-github.com/google/gnostic}@${GNOSTIC_VERSION:-v0.7.0}"},{"id":"cli/configuration/configuration::environment-variables-in-configuration::47","title":"EasyP Configuration Reference","section":"Environment Variables in Configuration","path":"/docs/guide/cli/configuration/configuration#environment-variables-in-configuration","headings":["Environment Variables in Configuration"],"excerpt":"Environment Variables in Configuration generate: inputs: # Default value if INPUT_DIR is not set - directory: ${INPUT_DIR:-proto} plugins: - name: go # Basic expansion out: ${OUTPUT_DIR} opts: # Default value module: ${M","content":"Environment Variables in Configuration generate: inputs: # Default value if INPUT_DIR is not set - directory: ${INPUT_DIR:-proto} plugins: - name: go # Basic expansion out: ${OUTPUT_DIR} opts: # Default value module: ${MODULE_NAME:-github.com/example/project} timeout: ${TIMEOUT:-30} # Escaping: $$ becomes literal $, $${VAR} becomes literal ${VAR} path: \"${BASE_DIR}/$${TEMP}/file\" # Result: \"/tmp/${TEMP}/file\" (if BASE_DIR=/tmp) literal: \"$$\" # Result: \"$\" ```"},{"id":"cli/configuration/configuration::environment-variables-in-configuration::48","title":"EasyP Configuration Reference","section":"Environment Variables in Configuration","path":"/docs/guide/cli/configuration/configuration#environment-variables-in-configuration","headings":["Environment Variables in Configuration"],"excerpt":"Environment Variables in Configuration **Supported syntax:** ${VAR} - expands to the value of VAR ${VAR:-default} - uses default if VAR is unset or empty ${VAR:=default} - uses default if VAR is unset or empty ${VAR-defa","content":"Environment Variables in Configuration **Supported syntax:** ${VAR} - expands to the value of VAR ${VAR:-default} - uses default if VAR is unset or empty ${VAR:=default} - uses default if VAR is unset or empty ${VAR-default} - uses default if VAR is unset (empty string is kept) $${VAR} or $$VAR - escapes to literal ${VAR} or $VAR $$ - escapes to literal $"},{"id":"cli/configuration/configuration::environment-variables-in-configuration::49","title":"EasyP Configuration Reference","section":"Environment Variables in Configuration","path":"/docs/guide/cli/configuration/configuration#environment-variables-in-configuration","headings":["Environment Variables in Configuration"],"excerpt":"Environment Variables in Configuration **Note:** Environment variables are expanded before YAML parsing, so any ${STRING} pattern will be processed. Use $$ to escape dollar signs when you need literal values.","content":"Environment Variables in Configuration **Note:** Environment variables are expanded before YAML parsing, so any ${STRING} pattern will be processed. Use $$ to escape dollar signs when you need literal values."},{"id":"cli/configuration/configuration::version::50","title":"EasyP Configuration Reference","section":"version","path":"/docs/guide/cli/configuration/configuration#version","headings":["version"],"excerpt":"version **Optional (legacy compatibility).** This field is accepted for backward compatibility and can be omitted in new configs.","content":"version **Optional (legacy compatibility).** This field is accepted for backward compatibility and can be omitted in new configs."},{"id":"cli/configuration/configuration::version::51","title":"EasyP Configuration Reference","section":"version","path":"/docs/guide/cli/configuration/configuration#version","headings":["version"],"excerpt":"version **Type:** string **Default:** omitted **Recommendation:** if you keep it, use v1alpha","content":"version **Type:** string **Default:** omitted **Recommendation:** if you keep it, use v1alpha"},{"id":"cli/configuration/configuration::version::52","title":"EasyP Configuration Reference","section":"version","path":"/docs/guide/cli/configuration/configuration#version","headings":["version"],"excerpt":"version The runtime behavior does not depend on this field.","content":"version The runtime behavior does not depend on this field."},{"id":"cli/configuration/configuration::lint::53","title":"EasyP Configuration Reference","section":"lint","path":"/docs/guide/cli/configuration/configuration#lint","headings":["lint"],"excerpt":"lint **Optional.** Configures proto file linting rules and behavior.","content":"lint **Optional.** Configures proto file linting rules and behavior."},{"id":"cli/configuration/configuration::lint::54","title":"EasyP Configuration Reference","section":"lint","path":"/docs/guide/cli/configuration/configuration#lint","headings":["lint"],"excerpt":"lint **Type:** object **Default:** Empty (no linting rules applied)","content":"lint **Type:** object **Default:** Empty (no linting rules applied)"},{"id":"cli/configuration/configuration::lintuse::55","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **Optional.** Specifies which linter rules or rule categories to apply.","content":"lint.use **Optional.** Specifies which linter rules or rule categories to apply."},{"id":"cli/configuration/configuration::lintuse::56","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **Type:** []string **Default:** [] (no rules)","content":"lint.use **Type:** []string **Default:** [] (no rules)"},{"id":"cli/configuration/configuration::lintuse::57","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **Available categories:** MINIMAL - Essential package consistency checks BASIC - Naming conventions and common patterns DEFAULT - Additional recommended rules COMMENTS - Comment requirements UNARY_RPC - Streamin","content":"lint.use **Available categories:** MINIMAL - Essential package consistency checks BASIC - Naming conventions and common patterns DEFAULT - Additional recommended rules COMMENTS - Comment requirements UNARY_RPC - Streaming RPC restrictions"},{"id":"cli/configuration/configuration::lintuse::58","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **Individual rules:** Any specific rule name (e.g., ENUM_PASCAL_CASE, FIELD_LOWER_SNAKE_CASE)","content":"lint.use **Individual rules:** Any specific rule name (e.g., ENUM_PASCAL_CASE, FIELD_LOWER_SNAKE_CASE)"},{"id":"cli/configuration/configuration::lintuse::59","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **MINIMAL:** DIRECTORY_SAME_PACKAGE PACKAGE_DEFINED PACKAGE_DIRECTORY_MATCH PACKAGE_SAME_DIRECTORY","content":"lint.use **MINIMAL:** DIRECTORY_SAME_PACKAGE PACKAGE_DEFINED PACKAGE_DIRECTORY_MATCH PACKAGE_SAME_DIRECTORY"},{"id":"cli/configuration/configuration::lintuse::60","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **BASIC:** ENUM_FIRST_VALUE_ZERO ENUM_NO_ALLOW_ALIAS ENUM_PASCAL_CASE ENUM_VALUE_UPPER_SNAKE_CASE FIELD_LOWER_SNAKE_CASE IMPORT_NO_PUBLIC IMPORT_NO_WEAK IMPORT_USED MESSAGE_PASCAL_CASE ONEOF_LOWER_SNAKE_CASE PAC","content":"lint.use **BASIC:** ENUM_FIRST_VALUE_ZERO ENUM_NO_ALLOW_ALIAS ENUM_PASCAL_CASE ENUM_VALUE_UPPER_SNAKE_CASE FIELD_LOWER_SNAKE_CASE IMPORT_NO_PUBLIC IMPORT_NO_WEAK IMPORT_USED MESSAGE_PASCAL_CASE ONEOF_LOWER_SNAKE_CASE PACKAGE_LOWER_SNAKE_CASE PACKAGE_SAME_CSHARP_NAMESPACE PACKAGE_SAME_GO_PACKAGE PACKAGE_SAME_JAVA_MULTIPLE_FILES PACKAGE_SAME_JAVA_PACKAGE PACKAGE_SAME_PHP_NAMESPACE PACKAGE_SAME_RUBY_PACKAGE PACKAGE_SAME_SWIFT_PREFIX RPC_PASCAL_CASE SERVICE_PASCAL_CASE"},{"id":"cli/configuration/configuration::lintuse::61","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **DEFAULT:** ENUM_VALUE_PREFIX ENUM_ZERO_VALUE_SUFFIX FILE_LOWER_SNAKE_CASE RPC_REQUEST_RESPONSE_UNIQUE RPC_REQUEST_STANDARD_NAME RPC_RESPONSE_STANDARD_NAME PACKAGE_VERSION_SUFFIX SERVICE_SUFFIX","content":"lint.use **DEFAULT:** ENUM_VALUE_PREFIX ENUM_ZERO_VALUE_SUFFIX FILE_LOWER_SNAKE_CASE RPC_REQUEST_RESPONSE_UNIQUE RPC_REQUEST_STANDARD_NAME RPC_RESPONSE_STANDARD_NAME PACKAGE_VERSION_SUFFIX SERVICE_SUFFIX"},{"id":"cli/configuration/configuration::lintuse::62","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **COMMENTS:** COMMENT_ENUM COMMENT_ENUM_VALUE COMMENT_FIELD COMMENT_MESSAGE COMMENT_ONEOF COMMENT_RPC COMMENT_SERVICE","content":"lint.use **COMMENTS:** COMMENT_ENUM COMMENT_ENUM_VALUE COMMENT_FIELD COMMENT_MESSAGE COMMENT_ONEOF COMMENT_RPC COMMENT_SERVICE"},{"id":"cli/configuration/configuration::lintuse::63","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **UNARY_RPC:** RPC_NO_CLIENT_STREAMING RPC_NO_SERVER_STREAMING","content":"lint.use **UNARY_RPC:** RPC_NO_CLIENT_STREAMING RPC_NO_SERVER_STREAMING"},{"id":"cli/configuration/configuration::lintenum_zero_value_suffix::64","title":"EasyP Configuration Reference","section":"lint.enum_zero_value_suffix","path":"/docs/guide/cli/configuration/configuration#lintenum_zero_value_suffix","headings":["lint.enum_zero_value_suffix"],"excerpt":"lint.enum_zero_value_suffix **Optional.** Specifies the required suffix for enum zero values.","content":"lint.enum_zero_value_suffix **Optional.** Specifies the required suffix for enum zero values."},{"id":"cli/configuration/configuration::lintenum_zero_value_suffix::65","title":"EasyP Configuration Reference","section":"lint.enum_zero_value_suffix","path":"/docs/guide/cli/configuration/configuration#lintenum_zero_value_suffix","headings":["lint.enum_zero_value_suffix"],"excerpt":"lint.enum_zero_value_suffix **Type:** string **Default:** \"\" (no suffix required) **Common values:** \"UNSPECIFIED\", \"UNKNOWN\", \"DEFAULT\"","content":"lint.enum_zero_value_suffix **Type:** string **Default:** \"\" (no suffix required) **Common values:** \"UNSPECIFIED\", \"UNKNOWN\", \"DEFAULT\""},{"id":"cli/configuration/configuration::lintenum_zero_value_suffix::66","title":"EasyP Configuration Reference","section":"lint.enum_zero_value_suffix","path":"/docs/guide/cli/configuration/configuration#lintenum_zero_value_suffix","headings":["lint.enum_zero_value_suffix"],"excerpt":"lint.enum_zero_value_suffix This enforces enum zero values like:","content":"lint.enum_zero_value_suffix This enforces enum zero values like:"},{"id":"cli/configuration/configuration::lintservice_suffix::67","title":"EasyP Configuration Reference","section":"lint.service_suffix","path":"/docs/guide/cli/configuration/configuration#lintservice_suffix","headings":["lint.service_suffix"],"excerpt":"lint.service_suffix **Optional.** Specifies the required suffix for service names.","content":"lint.service_suffix **Optional.** Specifies the required suffix for service names."},{"id":"cli/configuration/configuration::lintservice_suffix::68","title":"EasyP Configuration Reference","section":"lint.service_suffix","path":"/docs/guide/cli/configuration/configuration#lintservice_suffix","headings":["lint.service_suffix"],"excerpt":"lint.service_suffix **Type:** string **Default:** \"\" (no suffix required) **Common values:** \"Service\", \"API\", \"Svc\"","content":"lint.service_suffix **Type:** string **Default:** \"\" (no suffix required) **Common values:** \"Service\", \"API\", \"Svc\""},{"id":"cli/configuration/configuration::lintservice_suffix::69","title":"EasyP Configuration Reference","section":"lint.service_suffix","path":"/docs/guide/cli/configuration/configuration#lintservice_suffix","headings":["lint.service_suffix"],"excerpt":"lint.service_suffix This enforces service names like:","content":"lint.service_suffix This enforces service names like:"},{"id":"cli/configuration/configuration::lintignore::70","title":"EasyP Configuration Reference","section":"lint.ignore","path":"/docs/guide/cli/configuration/configuration#lintignore","headings":["lint.ignore"],"excerpt":"lint.ignore **Optional.** Directories or files to exclude from all linting rules.","content":"lint.ignore **Optional.** Directories or files to exclude from all linting rules."},{"id":"cli/configuration/configuration::lintignore::71","title":"EasyP Configuration Reference","section":"lint.ignore","path":"/docs/guide/cli/configuration/configuration#lintignore","headings":["lint.ignore"],"excerpt":"lint.ignore **Type:** []string **Default:** []","content":"lint.ignore **Type:** []string **Default:** []"},{"id":"cli/configuration/configuration::lintignore::72","title":"EasyP Configuration Reference","section":"lint.ignore","path":"/docs/guide/cli/configuration/configuration#lintignore","headings":["lint.ignore"],"excerpt":"lint.ignore Paths are relative to the easyp.yaml file location. Supports glob patterns.","content":"lint.ignore Paths are relative to the easyp.yaml file location. Supports glob patterns."},{"id":"cli/configuration/configuration::lintexcept::73","title":"EasyP Configuration Reference","section":"lint.except","path":"/docs/guide/cli/configuration/configuration#lintexcept","headings":["lint.except"],"excerpt":"lint.except **Optional.** Disables specific rules globally across the entire project.","content":"lint.except **Optional.** Disables specific rules globally across the entire project."},{"id":"cli/configuration/configuration::lintexcept::74","title":"EasyP Configuration Reference","section":"lint.except","path":"/docs/guide/cli/configuration/configuration#lintexcept","headings":["lint.except"],"excerpt":"lint.except **Type:** []string **Default:** []","content":"lint.except **Type:** []string **Default:** []"},{"id":"cli/configuration/configuration::lintallow_comment_ignores::75","title":"EasyP Configuration Reference","section":"lint.allow_comment_ignores","path":"/docs/guide/cli/configuration/configuration#lintallow_comment_ignores","headings":["lint.allow_comment_ignores"],"excerpt":"lint.allow_comment_ignores **Optional.** Enables inline comment-based rule ignoring within proto files.","content":"lint.allow_comment_ignores **Optional.** Enables inline comment-based rule ignoring within proto files."},{"id":"cli/configuration/configuration::lintallow_comment_ignores::76","title":"EasyP Configuration Reference","section":"lint.allow_comment_ignores","path":"/docs/guide/cli/configuration/configuration#lintallow_comment_ignores","headings":["lint.allow_comment_ignores"],"excerpt":"lint.allow_comment_ignores **Type:** boolean **Default:** false","content":"lint.allow_comment_ignores **Type:** boolean **Default:** false"},{"id":"cli/configuration/configuration::lintallow_comment_ignores::77","title":"EasyP Configuration Reference","section":"lint.allow_comment_ignores","path":"/docs/guide/cli/configuration/configuration#lintallow_comment_ignores","headings":["lint.allow_comment_ignores"],"excerpt":"lint.allow_comment_ignores When enabled, allows comments like:","content":"lint.allow_comment_ignores When enabled, allows comments like:"},{"id":"cli/configuration/configuration::lintignore_only::78","title":"EasyP Configuration Reference","section":"lint.ignore_only","path":"/docs/guide/cli/configuration/configuration#lintignore_only","headings":["lint.ignore_only"],"excerpt":"lint.ignore_only **Optional.** Disables specific rules only for certain files or directories.","content":"lint.ignore_only **Optional.** Disables specific rules only for certain files or directories."},{"id":"cli/configuration/configuration::lintignore_only::79","title":"EasyP Configuration Reference","section":"lint.ignore_only","path":"/docs/guide/cli/configuration/configuration#lintignore_only","headings":["lint.ignore_only"],"excerpt":"lint.ignore_only **Type:** mapstringstring **Default:** {}","content":"lint.ignore_only **Type:** mapstringstring **Default:** {}"},{"id":"cli/configuration/configuration::lintignore_only::80","title":"EasyP Configuration Reference","section":"lint.ignore_only","path":"/docs/guide/cli/configuration/configuration#lintignore_only","headings":["lint.ignore_only"],"excerpt":"lint.ignore_only **Key:** Rule name or category **Value:** Array of file paths or directories","content":"lint.ignore_only **Key:** Rule name or category **Value:** Array of file paths or directories"},{"id":"cli/configuration/configuration::deps::81","title":"EasyP Configuration Reference","section":"deps","path":"/docs/guide/cli/configuration/configuration#deps","headings":["deps"],"excerpt":"deps **Optional.** Lists external proto dependencies to download and manage.","content":"deps **Optional.** Lists external proto dependencies to download and manage."},{"id":"cli/configuration/configuration::deps::82","title":"EasyP Configuration Reference","section":"deps","path":"/docs/guide/cli/configuration/configuration#deps","headings":["deps"],"excerpt":"deps **Type:** []string **Default:** []","content":"deps **Type:** []string **Default:** []"},{"id":"cli/configuration/configuration::dependency-format::83","title":"EasyP Configuration Reference","section":"Dependency Format","path":"/docs/guide/cli/configuration/configuration#dependency-format","headings":["Dependency Format"],"excerpt":"Dependency Format Dependencies follow the format: $GIT_LINK@$VERSION","content":"Dependency Format Dependencies follow the format: $GIT_LINK@$VERSION"},{"id":"cli/configuration/configuration::dependency-format::84","title":"EasyP Configuration Reference","section":"Dependency Format","path":"/docs/guide/cli/configuration/configuration#dependency-format","headings":["Dependency Format"],"excerpt":"Dependency Format **Components:** $GIT_LINK - Git repository URL (GitHub, GitLab, etc.) $VERSION - Git tag or full commit hash (optional)","content":"Dependency Format **Components:** $GIT_LINK - Git repository URL (GitHub, GitLab, etc.) $VERSION - Git tag or full commit hash (optional)"},{"id":"cli/configuration/configuration::dependency-format::85","title":"EasyP Configuration Reference","section":"Dependency Format","path":"/docs/guide/cli/configuration/configuration#dependency-format","headings":["Dependency Format"],"excerpt":"Dependency Format **Format variations:** owner/repo - Latest commit from default branch owner/repo@v1.0.0 - Specific git tag owner/repo@47b927cbb41c4fdea1292baf - Full commit hash github.com/owner/repo@version - Full URL","content":"Dependency Format **Format variations:** owner/repo - Latest commit from default branch owner/repo@v1.0.0 - Specific git tag owner/repo@47b927cbb41c4fdea1292baf - Full commit hash github.com/owner/repo@version - Full URL with version gitlab.com/group/repo@tag - GitLab repository"},{"id":"cli/configuration/configuration::dependency-format::86","title":"EasyP Configuration Reference","section":"Dependency Format","path":"/docs/guide/cli/configuration/configuration#dependency-format","headings":["Dependency Format"],"excerpt":"Dependency Format **Note:** If @$VERSION is omitted, EasyP downloads the latest commit from the repository's default branch.","content":"Dependency Format **Note:** If @$VERSION is omitted, EasyP downloads the latest commit from the repository's default branch."},{"id":"cli/configuration/configuration::generate::87","title":"EasyP Configuration Reference","section":"generate","path":"/docs/guide/cli/configuration/configuration#generate","headings":["generate"],"excerpt":"generate **Optional.** Configures code generation from proto files.","content":"generate **Optional.** Configures code generation from proto files."},{"id":"cli/configuration/configuration::generate::88","title":"EasyP Configuration Reference","section":"generate","path":"/docs/guide/cli/configuration/configuration#generate","headings":["generate"],"excerpt":"generate **Type:** object **Default:** {}","content":"generate **Type:** object **Default:** {}"},{"id":"cli/configuration/configuration::generateinputs::89","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs **Required when generate is set.** Specifies sources of proto files for generation.","content":"generate.inputs **Required when generate is set.** Specifies sources of proto files for generation."},{"id":"cli/configuration/configuration::generateinputs::90","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs **Type:** []object (minimum 1 item) **Default:** not set","content":"generate.inputs **Type:** []object (minimum 1 item) **Default:** not set"},{"id":"cli/configuration/configuration::generateinputs::91","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs ```yaml generate: inputs: # Local directory - directory: \"proto\"","content":"generate.inputs ```yaml generate: inputs: # Local directory - directory: \"proto\""},{"id":"cli/configuration/configuration::generateinputs::92","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs Local directory with advanced options - directory: path: \"api/proto\" root: \".\"","content":"generate.inputs Local directory with advanced options - directory: path: \"api/proto\" root: \".\""},{"id":"cli/configuration/configuration::generateinputs::93","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs Remote git repository - git_repo: url: \"github.com/acme/common@v1.0.0\" sub_directory: \"proto\" root: \".\" ```","content":"generate.inputs Remote git repository - git_repo: url: \"github.com/acme/common@v1.0.0\" sub_directory: \"proto\" root: \".\" ```"},{"id":"cli/configuration/configuration::generateinputs::94","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs **Directory input fields:** directory (string or object) - Local directory path directory.path (string) - Directory path directory.root (string) - Root path for import resolution (default: \".\")","content":"generate.inputs **Directory input fields:** directory (string or object) - Local directory path directory.path (string) - Directory path directory.root (string) - Root path for import resolution (default: \".\")"},{"id":"cli/configuration/configuration::generateinputs::95","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs **Git repository input fields:** git_repo.url (string) - Repository URL with optional version git_repo.sub_directory (string) - Subdirectory within the repository git_repo.root (string) - Root path used f","content":"generate.inputs **Git repository input fields:** git_repo.url (string) - Repository URL with optional version git_repo.sub_directory (string) - Subdirectory within the repository git_repo.root (string) - Root path used for import resolution"},{"id":"cli/configuration/configuration::generateplugins::96","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins **Required when generate is set.** Configures protoc plugins for code generation.","content":"generate.plugins **Required when generate is set.** Configures protoc plugins for code generation."},{"id":"cli/configuration/configuration::generateplugins::97","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins **Type:** []object (minimum 1 item) **Default:** not set","content":"generate.plugins **Type:** []object (minimum 1 item) **Default:** not set"},{"id":"cli/configuration/configuration::generateplugins::98","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins ```yaml generate: plugins: # Local plugin - name: go out: . opts: paths: source_relative","content":"generate.plugins ```yaml generate: plugins: # Local plugin - name: go out: . opts: paths: source_relative"},{"id":"cli/configuration/configuration::generateplugins::99","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins Remote plugin - remote: \"buf.build/bufbuild/protovalidate-go:v0.4.0\" out: gen/go opts: paths: source_relative","content":"generate.plugins Remote plugin - remote: \"buf.build/bufbuild/protovalidate-go:v0.4.0\" out: gen/go opts: paths: source_relative"},{"id":"cli/configuration/configuration::generateplugins::100","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins Plugin with import dependencies - name: grpc-gateway out: . with_imports: true opts: paths: source_relative ```","content":"generate.plugins Plugin with import dependencies - name: grpc-gateway out: . with_imports: true opts: paths: source_relative ```"},{"id":"cli/configuration/configuration::generateplugins::101","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins **Plugin fields:** name (string, optional) - Plugin name (omit protoc-gen- prefix) remote (string, optional) - Remote plugin URL for execution path (string, optional) - Path to plugin executable file com","content":"generate.plugins **Plugin fields:** name (string, optional) - Plugin name (omit protoc-gen- prefix) remote (string, optional) - Remote plugin URL for execution path (string, optional) - Path to plugin executable file command ([]string, optional) - Command to execute plugin out (string, optional) - Output directory for generated files; defaults to the resolved generate root opts (mapstring, optional) - Plugin-specific options; each key can be a single scalar value or an array of scalar values with_imports (boolean, optional) - Include imported dependencies"},{"id":"cli/configuration/configuration::generateplugins::102","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins Plugin source is one-of: exactly one of name, remote, path, or command must be set.","content":"generate.plugins Plugin source is one-of: exactly one of name, remote, path, or command must be set."},{"id":"cli/configuration/configuration::generateplugins::103","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins **Common plugin options:** ```yaml Go plugin options opts: paths: source_relative # Generate files relative to input module: github.com/acme/api # Go module path","content":"generate.plugins **Common plugin options:** ```yaml Go plugin options opts: paths: source_relative # Generate files relative to input module: github.com/acme/api # Go module path"},{"id":"cli/configuration/configuration::generateplugins::104","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins gRPC Gateway options opts: paths: source_relative grpc_api_configuration: api.yaml # gRPC API configuration","content":"generate.plugins gRPC Gateway options opts: paths: source_relative grpc_api_configuration: api.yaml # gRPC API configuration"},{"id":"cli/configuration/configuration::generateplugins::105","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins OpenAPI v2 options opts: simple_operation_ids: true # Use simple operation IDs generate_unbound_methods: false # Skip unbound methods","content":"generate.plugins OpenAPI v2 options opts: simple_operation_ids: true # Use simple operation IDs generate_unbound_methods: false # Skip unbound methods"},{"id":"cli/configuration/configuration::generateplugins::106","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins ts-proto options with repeated key values opts: env: node outputServices: - grpc-js - generic-definitions ```","content":"generate.plugins ts-proto options with repeated key values opts: env: node outputServices: - grpc-js - generic-definitions ```"},{"id":"cli/configuration/configuration::generateplugins::107","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins When an opts value is a list, EasyP serializes it as repeated plugin params, e.g. outputServices=grpc-js,outputServices=generic-definitions.","content":"generate.plugins When an opts value is a list, EasyP serializes it as repeated plugin params, e.g. outputServices=grpc-js,outputServices=generic-definitions."},{"id":"cli/configuration/configuration::breaking::108","title":"EasyP Configuration Reference","section":"breaking","path":"/docs/guide/cli/configuration/configuration#breaking","headings":["breaking"],"excerpt":"breaking **Optional.** Configures backward compatibility checking.","content":"breaking **Optional.** Configures backward compatibility checking."},{"id":"cli/configuration/configuration::breaking::109","title":"EasyP Configuration Reference","section":"breaking","path":"/docs/guide/cli/configuration/configuration#breaking","headings":["breaking"],"excerpt":"breaking **Type:** object **Default:** {}","content":"breaking **Type:** object **Default:** {}"},{"id":"cli/configuration/configuration::breakingignore::110","title":"EasyP Configuration Reference","section":"breaking.ignore","path":"/docs/guide/cli/configuration/configuration#breakingignore","headings":["breaking.ignore"],"excerpt":"breaking.ignore **Optional.** Directories or files to exclude from breaking change detection.","content":"breaking.ignore **Optional.** Directories or files to exclude from breaking change detection."},{"id":"cli/configuration/configuration::breakingignore::111","title":"EasyP Configuration Reference","section":"breaking.ignore","path":"/docs/guide/cli/configuration/configuration#breakingignore","headings":["breaking.ignore"],"excerpt":"breaking.ignore **Type:** []string **Default:** []","content":"breaking.ignore **Type:** []string **Default:** []"},{"id":"cli/configuration/configuration::breakingagainst_git_ref::112","title":"EasyP Configuration Reference","section":"breaking.against_git_ref","path":"/docs/guide/cli/configuration/configuration#breakingagainst_git_ref","headings":["breaking.against_git_ref"],"excerpt":"breaking.against_git_ref **Optional.** Git reference (branch, tag, or commit) to compare against for breaking changes.","content":"breaking.against_git_ref **Optional.** Git reference (branch, tag, or commit) to compare against for breaking changes."},{"id":"cli/configuration/configuration::breakingagainst_git_ref::113","title":"EasyP Configuration Reference","section":"breaking.against_git_ref","path":"/docs/guide/cli/configuration/configuration#breakingagainst_git_ref","headings":["breaking.against_git_ref"],"excerpt":"breaking.against_git_ref **Type:** string **Default:** \"\" (falls back to CLI --against default: master)","content":"breaking.against_git_ref **Type:** string **Default:** \"\" (falls back to CLI --against default: master)"},{"id":"cli/configuration/configuration::breakingagainst_git_ref::114","title":"EasyP Configuration Reference","section":"breaking.against_git_ref","path":"/docs/guide/cli/configuration/configuration#breakingagainst_git_ref","headings":["breaking.against_git_ref"],"excerpt":"breaking.against_git_ref Can be overridden by the --against CLI flag.","content":"breaking.against_git_ref Can be overridden by the --against CLI flag."},{"id":"cli/configuration/configuration::configuration-validation::115","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation EasyP validates configuration files on startup and provides helpful error messages:","content":"Configuration Validation EasyP validates configuration files on startup and provides helpful error messages:"},{"id":"cli/configuration/configuration::configuration-validation::116","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation ```bash Invalid rule name Error: invalid rule: INVALID_RULE_NAME","content":"Configuration Validation ```bash Invalid rule name Error: invalid rule: INVALID_RULE_NAME"},{"id":"cli/configuration/configuration::configuration-validation::117","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation Missing required field in generate section Error: required field \"plugins\" is missing (path: generate.plugins)","content":"Configuration Validation Missing required field in generate section Error: required field \"plugins\" is missing (path: generate.plugins)"},{"id":"cli/configuration/configuration::configuration-validation::118","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation Invalid dependency format Error: invalid dependency format: invalid-repo-url ```","content":"Configuration Validation Invalid dependency format Error: invalid dependency format: invalid-repo-url ```"},{"id":"cli/configuration/configuration::configuration-validation::119","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation Use easyp --debug for detailed validation information.","content":"Configuration Validation Use easyp --debug for detailed validation information."},{"id":"cli/configuration/configuration::migration-from-buf::120","title":"EasyP Configuration Reference","section":"Migration from Buf","path":"/docs/guide/cli/configuration/configuration#migration-from-buf","headings":["Migration from Buf"],"excerpt":"Migration from Buf EasyP is fully compatible with Buf configurations. To migrate:","content":"Migration from Buf EasyP is fully compatible with Buf configurations. To migrate:"},{"id":"cli/configuration/configuration::migration-from-buf::121","title":"EasyP Configuration Reference","section":"Migration from Buf","path":"/docs/guide/cli/configuration/configuration#migration-from-buf","headings":["Migration from Buf"],"excerpt":"Migration from Buf Place buf.yaml or buf.yml in the project root Run easyp init and confirm migration when prompted Update deps format if using BSR modules Review migrated lint/breaking settings and adjust as needed","content":"Migration from Buf Place buf.yaml or buf.yml in the project root Run easyp init and confirm migration when prompted Update deps format if using BSR modules Review migrated lint/breaking settings and adjust as needed"},{"id":"cli/configuration/configuration::migration-from-buf::122","title":"EasyP Configuration Reference","section":"Migration from Buf","path":"/docs/guide/cli/configuration/configuration#migration-from-buf","headings":["Migration from Buf"],"excerpt":"Migration from Buf Most Buf configurations work without changes in EasyP.","content":"Migration from Buf Most Buf configurations work without changes in EasyP."},{"id":"cli/generator/examples/go::installing-plugins::0","title":"Go","section":"Installing Plugins","path":"/docs/guide/cli/generator/examples/go#installing-plugins","headings":["Installing Plugins"],"excerpt":"Installing Plugins First, install the necessary plugins for working with gRPC:","content":"Installing Plugins First, install the necessary plugins for working with gRPC:"},{"id":"cli/generator/examples/go::installing-plugins::1","title":"Go","section":"Installing Plugins","path":"/docs/guide/cli/generator/examples/go#installing-plugins","headings":["Installing Plugins"],"excerpt":"Installing Plugins These commands will install the protoc-gen-go and protoc-gen-go-grpc plugins for use with EasyP.","content":"Installing Plugins These commands will install the protoc-gen-go and protoc-gen-go-grpc plugins for use with EasyP."},{"id":"cli/generator/examples/go::example-proto-service::2","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service Here is an example proto file for an Echo service:","content":"Example Proto Service Here is an example proto file for an Echo service:"},{"id":"cli/generator/examples/go::example-proto-service::3","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service ```proto syntax = \"proto3\";","content":"Example Proto Service ```proto syntax = \"proto3\";"},{"id":"cli/generator/examples/go::example-proto-service::4","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service package api.echo.v1;","content":"Example Proto Service package api.echo.v1;"},{"id":"cli/generator/examples/go::example-proto-service::5","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";","content":"Example Proto Service option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";"},{"id":"cli/generator/examples/go::example-proto-service::6","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); rpc EchoStream(EchoStreamRequest) returns (EchoResponse); }","content":"Example Proto Service service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); rpc EchoStream(EchoStreamRequest) returns (EchoResponse); }"},{"id":"cli/generator/examples/go::example-proto-service::7","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoRequest { string payload = 1; }","content":"Example Proto Service message EchoRequest { string payload = 1; }"},{"id":"cli/generator/examples/go::example-proto-service::8","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoResponse { string payload = 2; }","content":"Example Proto Service message EchoResponse { string payload = 2; }"},{"id":"cli/generator/examples/go::example-proto-service::9","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoStreamRequest { string payload = 1; }","content":"Example Proto Service message EchoStreamRequest { string payload = 1; }"},{"id":"cli/generator/examples/go::example-proto-service::10","title":"Go","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/go#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoStreamResponse { string payload = 2; } ```","content":"Example Proto Service message EchoStreamResponse { string payload = 2; } ```"},{"id":"cli/generator/examples/go::configuration-setup::11","title":"Go","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/go#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup Create and configure the easyp.yaml configuration file:","content":"Configuration Setup Create and configure the easyp.yaml configuration file:"},{"id":"cli/generator/examples/go::configuration-setup::12","title":"Go","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/go#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup This file specifies that two plugins will be used: go for generating Go code and go-grpc for generating gRPC code, along with their respective options.","content":"Configuration Setup This file specifies that two plugins will be used: go for generating Go code and go-grpc for generating gRPC code, along with their respective options."},{"id":"cli/generator/examples/go::generating-code::13","title":"Go","section":"Generating Code","path":"/docs/guide/cli/generator/examples/go#generating-code","headings":["Generating Code"],"excerpt":"Generating Code To generate code, use the following command:","content":"Generating Code To generate code, use the following command:"},{"id":"cli/generator/examples/go::generating-code::14","title":"Go","section":"Generating Code","path":"/docs/guide/cli/generator/examples/go#generating-code","headings":["Generating Code"],"excerpt":"Generating Code If the --cfg flag is not specified, the easyp.yaml file in the current directory will be used by default:","content":"Generating Code If the --cfg flag is not specified, the easyp.yaml file in the current directory will be used by default:"},{"id":"cli/generator/examples/go::generating-code::15","title":"Go","section":"Generating Code","path":"/docs/guide/cli/generator/examples/go#generating-code","headings":["Generating Code"],"excerpt":"Generating Code Now you have the generated Go code, which you can interact with directly.","content":"Generating Code Now you have the generated Go code, which you can interact with directly."},{"id":"cli/generator/examples/grpc-gateway::installing-plugins::0","title":"gRPC-Gateway","section":"Installing Plugins","path":"/docs/guide/cli/generator/examples/grpc-gateway#installing-plugins","headings":["Installing Plugins"],"excerpt":"Installing Plugins In addition to the plugins for working with gRPC, you also need to install the following plugins for gRPC-Gateway:","content":"Installing Plugins In addition to the plugins for working with gRPC, you also need to install the following plugins for gRPC-Gateway:"},{"id":"cli/generator/examples/grpc-gateway::installing-plugins::1","title":"gRPC-Gateway","section":"Installing Plugins","path":"/docs/guide/cli/generator/examples/grpc-gateway#installing-plugins","headings":["Installing Plugins"],"excerpt":"Installing Plugins These commands will install the protoc-gen-go, protoc-gen-go-grpc, protoc-gen-openapiv2, and protoc-gen-grpc-gateway plugins for use with EasyP`.","content":"Installing Plugins These commands will install the protoc-gen-go, protoc-gen-go-grpc, protoc-gen-openapiv2, and protoc-gen-grpc-gateway plugins for use with EasyP`."},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::2","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service Here is the initial proto file for an Echo service:","content":"Example Proto Service Here is the initial proto file for an Echo service:"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::3","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service ```proto syntax = \"proto3\";","content":"Example Proto Service ```proto syntax = \"proto3\";"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::4","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service package api.echo.v1;","content":"Example Proto Service package api.echo.v1;"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::5","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";","content":"Example Proto Service option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::6","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); }","content":"Example Proto Service service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); }"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::7","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoRequest { string payload = 1; }","content":"Example Proto Service message EchoRequest { string payload = 1; }"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::8","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoResponse { string payload = 2; } ```","content":"Example Proto Service message EchoResponse { string payload = 2; } ```"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::9","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service To use gRPC-Gateway, update the proto file to include HTTP options:","content":"Example Proto Service To use gRPC-Gateway, update the proto file to include HTTP options:"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::10","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service ```proto syntax = \"proto3\"; import \"google/api/annotations.proto\";","content":"Example Proto Service ```proto syntax = \"proto3\"; import \"google/api/annotations.proto\";"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::11","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service package api.echo.v1;","content":"Example Proto Service package api.echo.v1;"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::12","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";","content":"Example Proto Service option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::13","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse) { option (google.api.http) = { // [!code ++] post: \"/api/v1/echo\" // [!code ++] body: \"*\" // [!code ++] }; // [!code ++] } }","content":"Example Proto Service service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse) { option (google.api.http) = { // [!code ++] post: \"/api/v1/echo\" // [!code ++] body: \"*\" // [!code ++] }; // [!code ++] } }"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::14","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoRequest { string payload = 1; }","content":"Example Proto Service message EchoRequest { string payload = 1; }"},{"id":"cli/generator/examples/grpc-gateway::example-proto-service::15","title":"gRPC-Gateway","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/grpc-gateway#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoResponse { string payload = 2; } ```","content":"Example Proto Service message EchoResponse { string payload = 2; } ```"},{"id":"cli/generator/examples/grpc-gateway::configuration-setup::16","title":"gRPC-Gateway","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/grpc-gateway#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup Update your easyp.yaml configuration file to include the necessary dependencies and plugins:","content":"Configuration Setup Update your easyp.yaml configuration file to include the necessary dependencies and plugins:"},{"id":"cli/generator/examples/grpc-gateway::configuration-setup::17","title":"gRPC-Gateway","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/grpc-gateway#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup ```yaml deps: # [!code ++] - github.com/googleapis/googleapis # [!code ++]","content":"Configuration Setup ```yaml deps: # [!code ++] - github.com/googleapis/googleapis # [!code ++]"},{"id":"cli/generator/examples/grpc-gateway::configuration-setup::18","title":"gRPC-Gateway","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/grpc-gateway#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup generate: plugins: - name: go out: . opts: paths: source_relative - name: go-grpc out: . opts: paths: source_relative require_unimplemented_servers: false - name: grpc-gateway # [!code ++] out: . # [!","content":"Configuration Setup generate: plugins: - name: go out: . opts: paths: source_relative - name: go-grpc out: . opts: paths: source_relative require_unimplemented_servers: false - name: grpc-gateway # [!code ++] out: . # [!code ++] opts: # [!code ++] paths: source_relative # [!code ++] - name: openapiv2 # [!code ++] out: . # [!code ++] opts: # [!code ++] simple_operation_ids: false # [!code ++] generate_unbound_methods: false # [!code ++] ```"},{"id":"cli/generator/examples/grpc-gateway::configuration-setup::19","title":"gRPC-Gateway","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/grpc-gateway#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup The deps section lists dependencies required for proto file imports. In this case, we add github.com/googleapis/googleapis because it contains the annotations.proto file used in the proto service defi","content":"Configuration Setup The deps section lists dependencies required for proto file imports. In this case, we add github.com/googleapis/googleapis because it contains the annotations.proto file used in the proto service definition."},{"id":"cli/generator/examples/grpc-gateway::updating-dependencies::20","title":"gRPC-Gateway","section":"Updating Dependencies","path":"/docs/guide/cli/generator/examples/grpc-gateway#updating-dependencies","headings":["Updating Dependencies"],"excerpt":"Updating Dependencies After updating your configuration file, run the following command to download the specified dependencies:","content":"Updating Dependencies After updating your configuration file, run the following command to download the specified dependencies:"},{"id":"cli/generator/examples/grpc-gateway::updating-dependencies::21","title":"gRPC-Gateway","section":"Updating Dependencies","path":"/docs/guide/cli/generator/examples/grpc-gateway#updating-dependencies","headings":["Updating Dependencies"],"excerpt":"Updating Dependencies For more details on managing dependencies, refer to the Package Manager section.","content":"Updating Dependencies For more details on managing dependencies, refer to the Package Manager section."},{"id":"cli/generator/examples/grpc-gateway::generating-code::22","title":"gRPC-Gateway","section":"Generating Code","path":"/docs/guide/cli/generator/examples/grpc-gateway#generating-code","headings":["Generating Code"],"excerpt":"Generating Code To generate the code, use the following command:","content":"Generating Code To generate the code, use the following command:"},{"id":"cli/generator/examples/grpc-gateway::generating-code::23","title":"gRPC-Gateway","section":"Generating Code","path":"/docs/guide/cli/generator/examples/grpc-gateway#generating-code","headings":["Generating Code"],"excerpt":"Generating Code If the --cfg flag is not specified, the easyp.yaml file in the current directory will be used by default:","content":"Generating Code If the --cfg flag is not specified, the easyp.yaml file in the current directory will be used by default:"},{"id":"cli/generator/examples/grpc-gateway::generating-code::24","title":"gRPC-Gateway","section":"Generating Code","path":"/docs/guide/cli/generator/examples/grpc-gateway#generating-code","headings":["Generating Code"],"excerpt":"Generating Code Now you have the generated Go and gRPC-Gateway code, which you can interact with directly.","content":"Generating Code Now you have the generated Go and gRPC-Gateway code, which you can interact with directly."},{"id":"cli/generator/examples/validate::installing-plugins::0","title":"Validate","section":"Installing Plugins","path":"/docs/guide/cli/generator/examples/validate#installing-plugins","headings":["Installing Plugins"],"excerpt":"Installing Plugins First, install the necessary plugins for working with gRPC:","content":"Installing Plugins First, install the necessary plugins for working with gRPC:"},{"id":"cli/generator/examples/validate::installing-plugins::1","title":"Validate","section":"Installing Plugins","path":"/docs/guide/cli/generator/examples/validate#installing-plugins","headings":["Installing Plugins"],"excerpt":"Installing Plugins These commands will install the protoc-gen-go and protoc-gen-go-grpc and protoc-gen-validate plugins for use with EasyP.","content":"Installing Plugins These commands will install the protoc-gen-go and protoc-gen-go-grpc and protoc-gen-validate plugins for use with EasyP."},{"id":"cli/generator/examples/validate::example-proto-service::2","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service Here is an example proto file for an Echo service:","content":"Example Proto Service Here is an example proto file for an Echo service:"},{"id":"cli/generator/examples/validate::example-proto-service::3","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service ```proto syntax = \"proto3\";","content":"Example Proto Service ```proto syntax = \"proto3\";"},{"id":"cli/generator/examples/validate::example-proto-service::4","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service package api.echo.v1;","content":"Example Proto Service package api.echo.v1;"},{"id":"cli/generator/examples/validate::example-proto-service::5","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service import \"validate/validate.proto\";","content":"Example Proto Service import \"validate/validate.proto\";"},{"id":"cli/generator/examples/validate::example-proto-service::6","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";","content":"Example Proto Service option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";"},{"id":"cli/generator/examples/validate::example-proto-service::7","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); rpc EchoStream(EchoStreamRequest) returns (EchoResponse); }","content":"Example Proto Service service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); rpc EchoStream(EchoStreamRequest) returns (EchoResponse); }"},{"id":"cli/generator/examples/validate::example-proto-service::8","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoRequest { string payload = 1 [(validate.rules).string = {max_len: 200}]; }","content":"Example Proto Service message EchoRequest { string payload = 1 [(validate.rules).string = {max_len: 200}]; }"},{"id":"cli/generator/examples/validate::example-proto-service::9","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoResponse { string payload = 2; }","content":"Example Proto Service message EchoResponse { string payload = 2; }"},{"id":"cli/generator/examples/validate::example-proto-service::10","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoStreamRequest { string payload = 1 [(validate.rules).string = {max_len: 200}]; }","content":"Example Proto Service message EchoStreamRequest { string payload = 1 [(validate.rules).string = {max_len: 200}]; }"},{"id":"cli/generator/examples/validate::example-proto-service::11","title":"Validate","section":"Example Proto Service","path":"/docs/guide/cli/generator/examples/validate#example-proto-service","headings":["Example Proto Service"],"excerpt":"Example Proto Service message EchoStreamResponse { string payload = 2; } ```","content":"Example Proto Service message EchoStreamResponse { string payload = 2; } ```"},{"id":"cli/generator/examples/validate::configuration-setup::12","title":"Validate","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/validate#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup Create and configure the easyp.yaml configuration file:","content":"Configuration Setup Create and configure the easyp.yaml configuration file:"},{"id":"cli/generator/examples/validate::configuration-setup::13","title":"Validate","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/validate#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup ```yaml deps: # [!code ++] - github.com/bufbuild/protoc-gen-validate # [!code ++]","content":"Configuration Setup ```yaml deps: # [!code ++] - github.com/bufbuild/protoc-gen-validate # [!code ++]"},{"id":"cli/generator/examples/validate::configuration-setup::14","title":"Validate","section":"Configuration Setup","path":"/docs/guide/cli/generator/examples/validate#configuration-setup","headings":["Configuration Setup"],"excerpt":"Configuration Setup generate: plugins: - name: go out: . opts: paths: source_relative - name: go-grpc out: . opts: paths: source_relative require_unimplemented_servers: false - name: validate out: . opts: paths: source_r","content":"Configuration Setup generate: plugins: - name: go out: . opts: paths: source_relative - name: go-grpc out: . opts: paths: source_relative require_unimplemented_servers: false - name: validate out: . opts: paths: source_relative lang: \"go\" ```"},{"id":"cli/generator/examples/validate::generating-code::15","title":"Validate","section":"Generating Code","path":"/docs/guide/cli/generator/examples/validate#generating-code","headings":["Generating Code"],"excerpt":"Generating Code To generate code, use the following command:","content":"Generating Code To generate code, use the following command:"},{"id":"cli/generator/examples/validate::generating-code::16","title":"Validate","section":"Generating Code","path":"/docs/guide/cli/generator/examples/validate#generating-code","headings":["Generating Code"],"excerpt":"Generating Code If the --cfg flag is not specified, the easyp.yaml file in the current directory will be used by default:","content":"Generating Code If the --cfg flag is not specified, the easyp.yaml file in the current directory will be used by default:"},{"id":"cli/generator/examples/validate::generating-code::17","title":"Validate","section":"Generating Code","path":"/docs/guide/cli/generator/examples/validate#generating-code","headings":["Generating Code"],"excerpt":"Generating Code Now you have the generated Go code, which you can interact with directly.","content":"Generating Code Now you have the generated Go code, which you can interact with directly."},{"id":"cli/generator/generator::top::0","title":"Generator","path":"/docs/guide/cli/generator/generator","headings":[],"excerpt":"EasyP includes a powerful generator that simplifies the process of generating code from proto files. By using YAML configurations, EasyP makes this process more user-friendly and intuitive compared to using the protoc co","content":"EasyP includes a powerful generator that simplifies the process of generating code from proto files. By using YAML configurations, EasyP makes this process more user-friendly and intuitive compared to using the protoc command directly."},{"id":"cli/generator/generator::key-features-of-the-generator::1","title":"Generator","section":"Key Features of the Generator","path":"/docs/guide/cli/generator/generator#key-features-of-the-generator","headings":["Key Features of the Generator"],"excerpt":"Key Features of the Generator **Simplified Code Generation**: - Generate code from proto files using a YAML configuration. - Avoid the need to write long and complex protoc commands.","content":"Key Features of the Generator **Simplified Code Generation**: - Generate code from proto files using a YAML configuration. - Avoid the need to write long and complex protoc commands."},{"id":"cli/generator/generator::key-features-of-the-generator::2","title":"Generator","section":"Key Features of the Generator","path":"/docs/guide/cli/generator/generator#key-features-of-the-generator","headings":["Key Features of the Generator"],"excerpt":"Key Features of the Generator **Wrapper around protoc**: - EasyP functions as a wrapper around protoc, providing a more convenient API through configuration files. - Supports all options and plugins available in protoc.","content":"Key Features of the Generator **Wrapper around protoc**: - EasyP functions as a wrapper around protoc, providing a more convenient API through configuration files. - Supports all options and plugins available in protoc."},{"id":"cli/generator/generator::key-features-of-the-generator::3","title":"Generator","section":"Key Features of the Generator","path":"/docs/guide/cli/generator/generator#key-features-of-the-generator","headings":["Key Features of the Generator"],"excerpt":"Key Features of the Generator **Flexibility and Customization**: - Use the same parameters as protoc plugins, directly in the configuration file. - Support for multiple plugins and their parameters in a single configurat","content":"Key Features of the Generator **Flexibility and Customization**: - Use the same parameters as protoc plugins, directly in the configuration file. - Support for multiple plugins and their parameters in a single configuration."},{"id":"cli/generator/generator::key-features-of-the-generator::4","title":"Generator","section":"Key Features of the Generator","path":"/docs/guide/cli/generator/generator#key-features-of-the-generator","headings":["Key Features of the Generator"],"excerpt":"Key Features of the Generator **Generate Code from Multiple Sources**: - Generate code from local directories or remote repositories. - Easily integrate with existing projects and repositories.","content":"Key Features of the Generator **Generate Code from Multiple Sources**: - Generate code from local directories or remote repositories. - Easily integrate with existing projects and repositories."},{"id":"cli/generator/generator::key-features-of-the-generator::5","title":"Generator","section":"Key Features of the Generator","path":"/docs/guide/cli/generator/generator#key-features-of-the-generator","headings":["Key Features of the Generator"],"excerpt":"Key Features of the Generator **Remote Generation**: - Generate code from remote Git repositories without local checkout.","content":"Key Features of the Generator **Remote Generation**: - Generate code from remote Git repositories without local checkout."},{"id":"cli/generator/generator::key-features-of-the-generator::6","title":"Generator","section":"Key Features of the Generator","path":"/docs/guide/cli/generator/generator#key-features-of-the-generator","headings":["Key Features of the Generator"],"excerpt":"Key Features of the Generator **Package Manager Integration**: - Seamless integration with EasyP's package manager for dependency management. - Automatic resolution and inclusion of proto dependencies.","content":"Key Features of the Generator **Package Manager Integration**: - Seamless integration with EasyP's package manager for dependency management. - Automatic resolution and inclusion of proto dependencies."},{"id":"cli/generator/generator::complete-configuration-example::7","title":"Generator","section":"Complete Configuration Example","path":"/docs/guide/cli/generator/generator#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example ```yaml Package manager dependencies deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 - github.com/bufbuild/protoc-gen-validate@","content":"Complete Configuration Example ```yaml Package manager dependencies deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 - github.com/bufbuild/protoc-gen-validate@v0.10.1"},{"id":"cli/generator/generator::complete-configuration-example::8","title":"Generator","section":"Complete Configuration Example","path":"/docs/guide/cli/generator/generator#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example Code generation configuration generate: inputs: # Local directory input - directory: path: \"proto\" root: \".\" # Remote Git repository input - git_repo: url: \"github.com/acme/weather@v1.2.3\" ","content":"Complete Configuration Example Code generation configuration generate: inputs: # Local directory input - directory: path: \"proto\" root: \".\" # Remote Git repository input - git_repo: url: \"github.com/acme/weather@v1.2.3\" sub_directory: \"proto/api\" # Another remote repository - git_repo: url: \"https://github.com/company/internal-protos.git\" sub_directory: \"definitions\" plugins: # Local plugin execution - name: go out: ./gen/go opts: paths: source_relative module: github.com/mycompany/myproject with_imports: true # Local plugin with custom options - name: go-grpc out: ./gen/go opts: paths: source_relative require_unimplemented_servers: false"},{"id":"cli/generator/generator::complete-configuration-example::9","title":"Generator","section":"Complete Configuration Example","path":"/docs/guide/cli/generator/generator#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example Managed mode - automatically set file and field options managed: enabled: true disable: - module: github.com/googleapis/googleapis # Disable for specific module override: - file_option: go_","content":"Complete Configuration Example Managed mode - automatically set file and field options managed: enabled: true disable: - module: github.com/googleapis/googleapis # Disable for specific module override: - file_option: go_package_prefix value: github.com/mycompany/myproject/gen/go - file_option: java_package_prefix value: com.mycompany - file_option: csharp_namespace_prefix value: MyCompany - field_option: jstype value: JS_STRING path: api/v1/ # Apply to specific path"},{"id":"cli/generator/generator::complete-configuration-example::10","title":"Generator","section":"Complete Configuration Example","path":"/docs/guide/cli/generator/generator#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example ```","content":"Complete Configuration Example ```"},{"id":"cli/generator/generator::local-directory-input::11","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input Local directory input is the most common and straightforward way to specify proto files for generation. Use this when your proto files are already present in your project directory structure.","content":"Local Directory Input Local directory input is the most common and straightforward way to specify proto files for generation. Use this when your proto files are already present in your project directory structure."},{"id":"cli/generator/generator::local-directory-input::12","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input **When to use:** Proto files are part of your project repository You need full control over proto file organization Working with a single service or application Proto files don't change frequently","content":"Local Directory Input **When to use:** Proto files are part of your project repository You need full control over proto file organization Working with a single service or application Proto files don't change frequently"},{"id":"cli/generator/generator::local-directory-input::13","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input The root parameter is particularly useful in monorepo setups where you need to control import path resolution. When root is set to a parent directory, import paths in your proto files will be resolv","content":"Local Directory Input The root parameter is particularly useful in monorepo setups where you need to control import path resolution. When root is set to a parent directory, import paths in your proto files will be resolved relative to that root, not the current working directory."},{"id":"cli/generator/generator::local-directory-input::14","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input **Parameters:**","content":"Local Directory Input **Parameters:**"},{"id":"cli/generator/generator::local-directory-input::15","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input Parameter Type Required Default Description ----------- ------ ---------- --------- ------------- path string ✅ - Path to the directory containing proto files root string ❌ \".\" Root directory used f","content":"Local Directory Input Parameter Type Required Default Description ----------- ------ ---------- --------- ------------- path string ✅ - Path to the directory containing proto files root string ❌ \".\" Root directory used for import path resolution"},{"id":"cli/generator/generator::local-directory-input::16","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input **Examples:**","content":"Local Directory Input **Examples:**"},{"id":"cli/generator/generator::local-directory-input::17","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input These examples show the difference between basic directory specification and advanced configuration with custom import resolution:","content":"Local Directory Input These examples show the difference between basic directory specification and advanced configuration with custom import resolution:"},{"id":"cli/generator/generator::local-directory-input::18","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input ```yaml Basic usage - Simple path specification inputs: - directory: \"api/proto\"","content":"Local Directory Input ```yaml Basic usage - Simple path specification inputs: - directory: \"api/proto\""},{"id":"cli/generator/generator::local-directory-input::19","title":"Generator","section":"Local Directory Input","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Local Directory Input"],"excerpt":"Local Directory Input Advanced usage with custom root - Controls import path resolution inputs: - directory: path: \"services/auth/proto\" root: \"services/auth\" # Imports will be relative to this path ```","content":"Local Directory Input Advanced usage with custom root - Controls import path resolution inputs: - directory: path: \"services/auth/proto\" root: \"services/auth\" # Imports will be relative to this path ```"},{"id":"cli/generator/generator::remote-git-repository-input::20","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input Remote Git repository input allows you to generate code from proto files hosted in external repositories without requiring a local checkout. This is particularly powerful for consuming APIs fr","content":"Remote Git Repository Input Remote Git repository input allows you to generate code from proto files hosted in external repositories without requiring a local checkout. This is particularly powerful for consuming APIs from other teams or external vendors."},{"id":"cli/generator/generator::remote-git-repository-input::21","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input **When to use:** Consuming proto definitions from other teams or services Integrating with vendor APIs that provide proto definitions Working with shared proto libraries across multiple projec","content":"Remote Git Repository Input **When to use:** Consuming proto definitions from other teams or services Integrating with vendor APIs that provide proto definitions Working with shared proto libraries across multiple projects You want to ensure you're always using the correct version of external APIs"},{"id":"cli/generator/generator::remote-git-repository-input::22","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input **Recommended approach:** Always pin to specific versions in production (@v1.0.0, not latest) Use semantic versions when available for easier dependency management Prefer public tags over comm","content":"Remote Git Repository Input **Recommended approach:** Always pin to specific versions in production (@v1.0.0, not latest) Use semantic versions when available for easier dependency management Prefer public tags over commit hashes for better traceability"},{"id":"cli/generator/generator::remote-git-repository-input::23","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input The root parameter controls import resolution root for files from this repository.","content":"Remote Git Repository Input The root parameter controls import resolution root for files from this repository."},{"id":"cli/generator/generator::remote-git-repository-input::24","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input **Parameters:**","content":"Remote Git Repository Input **Parameters:**"},{"id":"cli/generator/generator::remote-git-repository-input::25","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input Parameter Type Required Default Description ----------- ------ ---------- --------- ------------- url string ✅ - Git repository URL with optional version/tag/commit sub_directory string ❌ \"\" S","content":"Remote Git Repository Input Parameter Type Required Default Description ----------- ------ ---------- --------- ------------- url string ✅ - Git repository URL with optional version/tag/commit sub_directory string ❌ \"\" Subdirectory within the repository containing proto files root string ❌ \"\" Root path used for import resolution"},{"id":"cli/generator/generator::remote-git-repository-input::26","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input **URL Format Options:**","content":"Remote Git Repository Input **URL Format Options:**"},{"id":"cli/generator/generator::remote-git-repository-input::27","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input EasyP supports multiple URL formats to give you flexibility in how you reference remote repositories. Each format serves different use cases depending on your stability and versioning requirem","content":"Remote Git Repository Input EasyP supports multiple URL formats to give you flexibility in how you reference remote repositories. Each format serves different use cases depending on your stability and versioning requirements:"},{"id":"cli/generator/generator::remote-git-repository-input::28","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input **Tagged versions** are recommended for production as they provide stable, immutable references **Semantic versions** offer better readability and dependency management **Commit hashes** give ","content":"Remote Git Repository Input **Tagged versions** are recommended for production as they provide stable, immutable references **Semantic versions** offer better readability and dependency management **Commit hashes** give you access to specific commits when tags aren't available **Latest** should only be used in development environments due to unpredictability **Full HTTPS URLs** are useful for private repositories or non-GitHub hosting"},{"id":"cli/generator/generator::remote-git-repository-input::29","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input ```yaml Tag version - Best for production stability url: \"github.com/googleapis/googleapis@common-protos-1_3_1\"","content":"Remote Git Repository Input ```yaml Tag version - Best for production stability url: \"github.com/googleapis/googleapis@common-protos-1_3_1\""},{"id":"cli/generator/generator::remote-git-repository-input::30","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input Semantic version - Easier dependency management url: \"github.com/grpc-ecosystem/grpc-gateway@v2.19.1\"","content":"Remote Git Repository Input Semantic version - Easier dependency management url: \"github.com/grpc-ecosystem/grpc-gateway@v2.19.1\""},{"id":"cli/generator/generator::remote-git-repository-input::31","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input Commit hash - When you need a specific commit url: \"github.com/company/protos@abc123def456\"","content":"Remote Git Repository Input Commit hash - When you need a specific commit url: \"github.com/company/protos@abc123def456\""},{"id":"cli/generator/generator::remote-git-repository-input::32","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input Latest - Development only, not recommended for production url: \"github.com/company/protos\"","content":"Remote Git Repository Input Latest - Development only, not recommended for production url: \"github.com/company/protos\""},{"id":"cli/generator/generator::remote-git-repository-input::33","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input Full HTTPS URL - For private repos or custom Git hosts url: \"https://github.com/company/private-protos.git\" ```","content":"Remote Git Repository Input Full HTTPS URL - For private repos or custom Git hosts url: \"https://github.com/company/private-protos.git\" ```"},{"id":"cli/generator/generator::remote-git-repository-input::34","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input **Examples:**","content":"Remote Git Repository Input **Examples:**"},{"id":"cli/generator/generator::remote-git-repository-input::35","title":"Generator","section":"Remote Git Repository Input","path":"/docs/guide/cli/generator/generator#remote-git-repository-input","headings":["Remote Git Repository Input"],"excerpt":"Remote Git Repository Input These examples demonstrate common patterns for consuming remote proto definitions from different types of repositories:","content":"Remote Git Repository Input These examples demonstrate common patterns for consuming remote proto definitions from different types of repositories:"},{"id":"cli/generator/generator::plugin-configuration::36","title":"Generator","section":"Plugin Configuration","path":"/docs/guide/cli/generator/generator#plugin-configuration","headings":["Plugin Configuration"],"excerpt":"Plugin Configuration Plugin configuration is where you specify which code generators to run and how they should behave. EasyP supports any protoc plugin, making it extremely flexible for different language ecosystems and","content":"Plugin Configuration Plugin configuration is where you specify which code generators to run and how they should behave. EasyP supports any protoc plugin, making it extremely flexible for different language ecosystems and use cases."},{"id":"cli/generator/generator::plugin-configuration::37","title":"Generator","section":"Plugin Configuration","path":"/docs/guide/cli/generator/generator#plugin-configuration","headings":["Plugin Configuration"],"excerpt":"Plugin Configuration At a high level, there are **four ways to specify how a plugin should be executed**:","content":"Plugin Configuration At a high level, there are **four ways to specify how a plugin should be executed**:"},{"id":"cli/generator/generator::plugin-configuration::38","title":"Generator","section":"Plugin Configuration","path":"/docs/guide/cli/generator/generator#plugin-configuration","headings":["Plugin Configuration"],"excerpt":"Plugin Configuration **name** – run plugin by name from PATH or use a builtin plugin. **path** – run plugin by absolute/relative path to an executable file. **remote** – run plugin via remote URL (EasyP remote executor).","content":"Plugin Configuration **name** – run plugin by name from PATH or use a builtin plugin. **path** – run plugin by absolute/relative path to an executable file. **remote** – run plugin via remote URL (EasyP remote executor). **command** – run plugin via arbitrary command (for example, go run ...)."},{"id":"cli/generator/generator::plugin-configuration::39","title":"Generator","section":"Plugin Configuration","path":"/docs/guide/cli/generator/generator#plugin-configuration","headings":["Plugin Configuration"],"excerpt":"Plugin Configuration Only **one** of name, path, remote, or command must be specified for each plugin.","content":"Plugin Configuration Only **one** of name, path, remote, or command must be specified for each plugin."},{"id":"cli/generator/generator::plugin-by-name-name::40","title":"Generator","section":"Plugin by Name (name)","path":"/docs/guide/cli/generator/generator#plugin-by-name-name","headings":["Plugin by Name (name)"],"excerpt":"Plugin by Name (name) Local plugin execution by name is the standard approach where plugins are installed on your system and executed directly by EasyP.","content":"Plugin by Name (name) Local plugin execution by name is the standard approach where plugins are installed on your system and executed directly by EasyP."},{"id":"cli/generator/generator::plugin-by-name-name::41","title":"Generator","section":"Plugin by Name (name)","path":"/docs/guide/cli/generator/generator#plugin-by-name-name","headings":["Plugin by Name (name)"],"excerpt":"Plugin by Name (name) **When to use name:** Standard language support (Go, Python, TypeScript, etc.) You have control over the build environment Performance is critical (no network overhead) You want to rely on PATH or b","content":"Plugin by Name (name) **When to use name:** Standard language support (Go, Python, TypeScript, etc.) You have control over the build environment Performance is critical (no network overhead) You want to rely on PATH or builtin plugins"},{"id":"cli/generator/generator::plugin-by-name-name::42","title":"Generator","section":"Plugin by Name (name)","path":"/docs/guide/cli/generator/generator#plugin-by-name-name","headings":["Plugin by Name (name)"],"excerpt":"Plugin by Name (name) **Installation requirements:** Plugins must be installed and available in your PATH (if not using builtin plugins). Plugin names follow the protoc-gen-{name} convention. Use package managers (go ins","content":"Plugin by Name (name) **Installation requirements:** Plugins must be installed and available in your PATH (if not using builtin plugins). Plugin names follow the protoc-gen-{name} convention. Use package managers (go install, npm install, pip install) for installation."},{"id":"cli/generator/generator::plugin-by-name-name::43","title":"Generator","section":"Plugin by Name (name)","path":"/docs/guide/cli/generator/generator#plugin-by-name-name","headings":["Plugin by Name (name)"],"excerpt":"Plugin by Name (name) The with_imports parameter is crucial when you're using dependencies from the package manager. Set it to true to include proto files from your deps section in the generation process.","content":"Plugin by Name (name) The with_imports parameter is crucial when you're using dependencies from the package manager. Set it to true to include proto files from your deps section in the generation process."},{"id":"cli/generator/generator::plugin-by-path-path::44","title":"Generator","section":"Plugin by Path (path)","path":"/docs/guide/cli/generator/generator#plugin-by-path-path","headings":["Plugin by Path (path)"],"excerpt":"Plugin by Path (path) Sometimes you need to run a plugin from a specific binary without putting it into PATH (for example, a binary in your repo or in a build directory). In this case you can specify an explicit path:","content":"Plugin by Path (path) Sometimes you need to run a plugin from a specific binary without putting it into PATH (for example, a binary in your repo or in a build directory). In this case you can specify an explicit path:"},{"id":"cli/generator/generator::plugin-by-path-path::45","title":"Generator","section":"Plugin by Path (path)","path":"/docs/guide/cli/generator/generator#plugin-by-path-path","headings":["Plugin by Path (path)"],"excerpt":"Plugin by Path (path) **When to use path:** You keep plugin binaries in the repository (for reproducible builds). You use different plugin versions side-by-side. You don't want to pollute the global PATH.","content":"Plugin by Path (path) **When to use path:** You keep plugin binaries in the repository (for reproducible builds). You use different plugin versions side-by-side. You don't want to pollute the global PATH."},{"id":"cli/generator/generator::remote-plugin-remote::46","title":"Generator","section":"Remote Plugin (remote)","path":"/docs/guide/cli/generator/generator#remote-plugin-remote","headings":["Remote Plugin (remote)"],"excerpt":"Remote Plugin (remote) Remote plugins are executed via a remote URL. EasyP will send a CodeGeneratorRequest to the remote endpoint and receive a CodeGeneratorResponse back.","content":"Remote Plugin (remote) Remote plugins are executed via a remote URL. EasyP will send a CodeGeneratorRequest to the remote endpoint and receive a CodeGeneratorResponse back."},{"id":"cli/generator/generator::remote-plugin-remote::47","title":"Generator","section":"Remote Plugin (remote)","path":"/docs/guide/cli/generator/generator#remote-plugin-remote","headings":["Remote Plugin (remote)"],"excerpt":"Remote Plugin (remote) Below is a real example of using the EasyP API Service as a remote plugin executor (same format as in the API Service docs):","content":"Remote Plugin (remote) Below is a real example of using the EasyP API Service as a remote plugin executor (same format as in the API Service docs):"},{"id":"cli/generator/generator::remote-plugin-remote::48","title":"Generator","section":"Remote Plugin (remote)","path":"/docs/guide/cli/generator/generator#remote-plugin-remote","headings":["Remote Plugin (remote)"],"excerpt":"Remote Plugin (remote) ```yaml generate: plugins: # Remote plugin execution via EasyP API Service - remote: api.easyp.tech/protobuf/go:v1.36.10 out: . opts: paths: source_relative","content":"Remote Plugin (remote) ```yaml generate: plugins: # Remote plugin execution via EasyP API Service - remote: api.easyp.tech/protobuf/go:v1.36.10 out: . opts: paths: source_relative"},{"id":"cli/generator/generator::remote-plugin-remote::49","title":"Generator","section":"Remote Plugin (remote)","path":"/docs/guide/cli/generator/generator#remote-plugin-remote","headings":["Remote Plugin (remote)"],"excerpt":"Remote Plugin (remote) remote: api.easyp.tech/grpc/go:v1.5.1 out: . opts: paths: source_relative ```","content":"Remote Plugin (remote) remote: api.easyp.tech/grpc/go:v1.5.1 out: . opts: paths: source_relative ```"},{"id":"cli/generator/generator::remote-plugin-remote::50","title":"Generator","section":"Remote Plugin (remote)","path":"/docs/guide/cli/generator/generator#remote-plugin-remote","headings":["Remote Plugin (remote)"],"excerpt":"Remote Plugin (remote) **Typical use cases for remote:** Centralized plugin service inside your organization (e.g. EasyP API Service). Running heavy plugins on a dedicated server instead of CI agents. Sharing the same pl","content":"Remote Plugin (remote) **Typical use cases for remote:** Centralized plugin service inside your organization (e.g. EasyP API Service). Running heavy plugins on a dedicated server instead of CI agents. Sharing the same plugin implementation across multiple teams."},{"id":"cli/generator/generator::executing-plugin-via-command-command::51","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) You can specify a plugin as an array of commands to execute. This is useful for running plugins via go run or any other tool without prior installation of the plugin binary:","content":"Executing Plugin via Command (command) You can specify a plugin as an array of commands to execute. This is useful for running plugins via go run or any other tool without prior installation of the plugin binary:"},{"id":"cli/generator/generator::executing-plugin-via-command-command::52","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command)","content":"Executing Plugin via Command (command)"},{"id":"cli/generator/generator::executing-plugin-via-command-command::53","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) In this mode EasyP: **builds and runs the command** you provide as a child process; **writes CodeGeneratorRequest to stdin** of the process; **reads CodeGeneratorResponse from stdou","content":"Executing Plugin via Command (command) In this mode EasyP: **builds and runs the command** you provide as a child process; **writes CodeGeneratorRequest to stdin** of the process; **reads CodeGeneratorResponse from stdout**, just like with regular protoc plugins."},{"id":"cli/generator/generator::executing-plugin-via-command-command::54","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) **Plugin Source Priority:** command — execute via specified command (highest priority) remote — remote plugin via URL name — local plugin from PATH or builtin plugin path — path to ","content":"Executing Plugin via Command (command) **Plugin Source Priority:** command — execute via specified command (highest priority) remote — remote plugin via URL name — local plugin from PATH or builtin plugin path — path to plugin executable file"},{"id":"cli/generator/generator::executing-plugin-via-command-command::55","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) **Parameters (plugin sources and common options):**","content":"Executing Plugin via Command (command) **Parameters (plugin sources and common options):**"},{"id":"cli/generator/generator::executing-plugin-via-command-command::56","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) Parameter Type Required Default Description ----------- ------ ---------- --------- ------------- name string ❌ - Plugin name or identifier (e.g. go, go-grpc, grpc-gateway) command ","content":"Executing Plugin via Command (command) Parameter Type Required Default Description ----------- ------ ---------- --------- ------------- name string ❌ - Plugin name or identifier (e.g. go, go-grpc, grpc-gateway) command []string ❌ - Command to execute plugin (e.g., [\"go\", \"run\", \"package\"]) remote string ❌ - Remote plugin URL path string ❌ - Path to plugin executable file out string ❌ resolved generate root Output directory for generated files opts mapstring ❌ {} Plugin-specific options; list values are emitted as repeated key=value params with_imports bool ❌ false Include proto files from dependencies"},{"id":"cli/generator/generator::executing-plugin-via-command-command::57","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) **Note:** Only one plugin source (name, command, remote, or path) must be specified for each plugin. If opts.outputServices is set to [\"grpc-js\", \"generic-definitions\"], EasyP sends","content":"Executing Plugin via Command (command) **Note:** Only one plugin source (name, command, remote, or path) must be specified for each plugin. If opts.outputServices is set to [\"grpc-js\", \"generic-definitions\"], EasyP sends outputServices=grpc-js,outputServices=generic-definitions."},{"id":"cli/generator/generator::executing-plugin-via-command-command::58","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) **Command source examples:**","content":"Executing Plugin via Command (command) **Command source examples:**"},{"id":"cli/generator/generator::executing-plugin-via-command-command::59","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) ```yaml generate: inputs: - directory: \"proto\"","content":"Executing Plugin via Command (command) ```yaml generate: inputs: - directory: \"proto\""},{"id":"cli/generator/generator::executing-plugin-via-command-command::60","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) plugins: # 1) gRPC-Gateway via go run (no pre-installed binary required) - command: [\"go\", \"run\", \"github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.25.1\"] out: .","content":"Executing Plugin via Command (command) plugins: # 1) gRPC-Gateway via go run (no pre-installed binary required) - command: [\"go\", \"run\", \"github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.25.1\"] out: ./gen/go opts: paths: source_relative generate_unbound_methods: true"},{"id":"cli/generator/generator::executing-plugin-via-command-command::61","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) 2) protoc-gen-validate via go run - command: [\"go\", \"run\", \"github.com/bufbuild/protoc-gen-validate@v0.10.1\"] out: ./gen/go opts: paths: source_relative lang: go","content":"Executing Plugin via Command (command) 2) protoc-gen-validate via go run - command: [\"go\", \"run\", \"github.com/bufbuild/protoc-gen-validate@v0.10.1\"] out: ./gen/go opts: paths: source_relative lang: go"},{"id":"cli/generator/generator::executing-plugin-via-command-command::62","title":"Generator","section":"Executing Plugin via Command (command)","path":"/docs/guide/cli/generator/generator#executing-plugin-via-command-command","headings":["Executing Plugin via Command (command)"],"excerpt":"Executing Plugin via Command (command) 3) Any custom wrapper script - command: [\"bash\", \"./scripts/custom-protoc-plugin.sh\"] out: ./gen/custom opts: foo: bar ```","content":"Executing Plugin via Command (command) 3) Any custom wrapper script - command: [\"bash\", \"./scripts/custom-protoc-plugin.sh\"] out: ./gen/custom opts: foo: bar ```"},{"id":"cli/generator/generator::builtin-plugins::63","title":"Generator","section":"Builtin Plugins","path":"/docs/guide/cli/generator/generator#builtin-plugins","headings":["Builtin Plugins"],"excerpt":"Builtin Plugins EasyP includes builtin plugins for basic protobuf and gRPC languages. These plugins are embedded in the binary as WASM modules and do not require installation of external dependencies.","content":"Builtin Plugins EasyP includes builtin plugins for basic protobuf and gRPC languages. These plugins are embedded in the binary as WASM modules and do not require installation of external dependencies."},{"id":"cli/generator/generator::builtin-plugins::64","title":"Generator","section":"Builtin Plugins","path":"/docs/guide/cli/generator/generator#builtin-plugins","headings":["Builtin Plugins"],"excerpt":"Builtin Plugins **Benefits of builtin plugins:** **Portability**: Single binary with all necessary plugins **Convenience**: No need to install external dependencies **Stability**: Plugin versions are fixed in the binary ","content":"Builtin Plugins **Benefits of builtin plugins:** **Portability**: Single binary with all necessary plugins **Convenience**: No need to install external dependencies **Stability**: Plugin versions are fixed in the binary **Isolation**: Independent of system plugin installations"},{"id":"cli/generator/generator::builtin-plugins::65","title":"Generator","section":"Builtin Plugins","path":"/docs/guide/cli/generator/generator#builtin-plugins","headings":["Builtin Plugins"],"excerpt":"Builtin Plugins **Supported builtin plugins:**","content":"Builtin Plugins **Supported builtin plugins:**"},{"id":"cli/generator/generator::protobuf-base-plugins::66","title":"Generator","section":"Protobuf Base Plugins","path":"/docs/guide/cli/generator/generator#protobuf-base-plugins","headings":["Protobuf Base Plugins"],"excerpt":"Protobuf Base Plugins The following plugins are builtin for generating base protobuf code:","content":"Protobuf Base Plugins The following plugins are builtin for generating base protobuf code:"},{"id":"cli/generator/generator::protobuf-base-plugins::67","title":"Generator","section":"Protobuf Base Plugins","path":"/docs/guide/cli/generator/generator#protobuf-base-plugins","headings":["Protobuf Base Plugins"],"excerpt":"Protobuf Base Plugins Plugin Name Description Corresponding protoc Plugin ------------- ------------- ---------------------------- cpp Generate C++ code from proto files protoc-gen-cpp csharp Generate C# code from proto ","content":"Protobuf Base Plugins Plugin Name Description Corresponding protoc Plugin ------------- ------------- ---------------------------- cpp Generate C++ code from proto files protoc-gen-cpp csharp Generate C# code from proto files protoc-gen-csharp java Generate Java code from proto files protoc-gen-java kotlin Generate Kotlin code from proto files protoc-gen-kotlin objc Generate Objective-C code from proto files protoc-gen-objc php Generate PHP code from proto files protoc-gen-php python Generate Python code from proto files protoc-gen-python ruby Generate Ruby code from proto files protoc-gen-ruby"},{"id":"cli/generator/generator::grpc-plugins::68","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins The following plugins are builtin for generating gRPC code:","content":"gRPC Plugins The following plugins are builtin for generating gRPC code:"},{"id":"cli/generator/generator::grpc-plugins::69","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins Plugin Name Description Corresponding protoc Plugin ------------- ------------- ---------------------------- grpc_cpp Generate gRPC code for C++ grpc_cpp_plugin grpc_csharp Generate gRPC code for C# grpc_csh","content":"gRPC Plugins Plugin Name Description Corresponding protoc Plugin ------------- ------------- ---------------------------- grpc_cpp Generate gRPC code for C++ grpc_cpp_plugin grpc_csharp Generate gRPC code for C# grpc_csharp_plugin grpc_java Generate gRPC code for Java grpc_java_plugin grpc_node Generate gRPC code for Node.js grpc_node_plugin grpc_objc Generate gRPC code for Objective-C grpc_objective_c_plugin grpc_php Generate gRPC code for PHP grpc_php_plugin grpc_python Generate gRPC code for Python grpc_python_plugin grpc_ruby Generate gRPC code for Ruby grpc_ruby_plugin"},{"id":"cli/generator/generator::grpc-plugins::70","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins **Plugin Selection Logic:**","content":"gRPC Plugins **Plugin Selection Logic:**"},{"id":"cli/generator/generator::grpc-plugins::71","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins EasyP uses the following priority when selecting an executor for a plugin:","content":"gRPC Plugins EasyP uses the following priority when selecting an executor for a plugin:"},{"id":"cli/generator/generator::grpc-plugins::72","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins **Remote plugin** (if url is specified) — always has the highest priority **Builtin plugin** (if plugin is builtin and not found in PATH) — used automatically **Local plugin** (from PATH) — used by default f","content":"gRPC Plugins **Remote plugin** (if url is specified) — always has the highest priority **Builtin plugin** (if plugin is builtin and not found in PATH) — used automatically **Local plugin** (from PATH) — used by default for backward compatibility"},{"id":"cli/generator/generator::grpc-plugins::73","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins **Usage Example:**","content":"gRPC Plugins **Usage Example:**"},{"id":"cli/generator/generator::grpc-plugins::74","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins **Requirements:**","content":"gRPC Plugins **Requirements:**"},{"id":"cli/generator/generator::grpc-plugins::75","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins Builtin plugins are included in the EasyP binary:","content":"gRPC Plugins Builtin plugins are included in the EasyP binary:"},{"id":"cli/generator/generator::grpc-plugins::76","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins ```bash Build go build ./cmd/easyp","content":"gRPC Plugins ```bash Build go build ./cmd/easyp"},{"id":"cli/generator/generator::grpc-plugins::77","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins Install go install github.com/easyp-tech/easyp/cmd/easyp@latest ```","content":"gRPC Plugins Install go install github.com/easyp-tech/easyp/cmd/easyp@latest ```"},{"id":"cli/generator/generator::grpc-plugins::78","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins **Backward Compatibility:**","content":"gRPC Plugins **Backward Compatibility:**"},{"id":"cli/generator/generator::grpc-plugins::79","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins Builtin plugins are fully compatible with existing configurations. If a plugin is found in PATH, it will be used instead of the builtin one. This ensures that:","content":"gRPC Plugins Builtin plugins are fully compatible with existing configurations. If a plugin is found in PATH, it will be used instead of the builtin one. This ensures that:"},{"id":"cli/generator/generator::grpc-plugins::80","title":"Generator","section":"gRPC Plugins","path":"/docs/guide/cli/generator/generator#grpc-plugins","headings":["gRPC Plugins"],"excerpt":"gRPC Plugins Existing configurations continue to work without changes You can override a builtin plugin by installing it in your system Priority is given to local installations for flexibility","content":"gRPC Plugins Existing configurations continue to work without changes You can override a builtin plugin by installing it in your system Priority is given to local installations for flexibility"},{"id":"cli/generator/generator::plugin-options-reference::81","title":"Generator","section":"Plugin Options Reference","path":"/docs/guide/cli/generator/generator#plugin-options-reference","headings":["Plugin Options Reference"],"excerpt":"Plugin Options Reference This section covers the most commonly used plugins and their configuration options. Each plugin has specific parameters that control how code is generated, and understanding these options is cruc","content":"Plugin Options Reference This section covers the most commonly used plugins and their configuration options. Each plugin has specific parameters that control how code is generated, and understanding these options is crucial for getting the output you need."},{"id":"cli/generator/generator::go-plugins::82","title":"Generator","section":"Go Plugins","path":"/docs/guide/cli/generator/generator#go-plugins","headings":["Go Plugins"],"excerpt":"Go Plugins Go plugins are the most mature and widely used protoc plugins. The paths option controls how import paths are resolved, while other options provide fine-grained control over the generated code:","content":"Go Plugins Go plugins are the most mature and widely used protoc plugins. The paths option controls how import paths are resolved, while other options provide fine-grained control over the generated code:"},{"id":"cli/generator/generator::grpc-gateway-plugins::83","title":"Generator","section":"gRPC-Gateway Plugins","path":"/docs/guide/cli/generator/generator#grpc-gateway-plugins","headings":["gRPC-Gateway Plugins"],"excerpt":"gRPC-Gateway Plugins gRPC-Gateway plugins enable you to serve gRPC services as REST APIs and generate OpenAPI documentation. These are essential for building HTTP/JSON APIs from gRPC services:","content":"gRPC-Gateway Plugins gRPC-Gateway plugins enable you to serve gRPC services as REST APIs and generate OpenAPI documentation. These are essential for building HTTP/JSON APIs from gRPC services:"},{"id":"cli/generator/generator::validation-plugins::84","title":"Generator","section":"Validation Plugins","path":"/docs/guide/cli/generator/generator#validation-plugins","headings":["Validation Plugins"],"excerpt":"Validation Plugins Validation plugins generate code that automatically validates proto message fields based on constraints defined in your proto files. This eliminates the need for manual validation code:","content":"Validation Plugins Validation plugins generate code that automatically validates proto message fields based on constraints defined in your proto files. This eliminates the need for manual validation code:"},{"id":"cli/generator/generator::typescriptjavascript-plugins::85","title":"Generator","section":"TypeScript/JavaScript Plugins","path":"/docs/guide/cli/generator/generator#typescriptjavascript-plugins","headings":["TypeScript/JavaScript Plugins"],"excerpt":"TypeScript/JavaScript Plugins TypeScript plugins are essential for frontend development, providing type-safe interfaces for your proto definitions and gRPC services in web applications:","content":"TypeScript/JavaScript Plugins TypeScript plugins are essential for frontend development, providing type-safe interfaces for your proto definitions and gRPC services in web applications:"},{"id":"cli/generator/generator::managed-mode::86","title":"Generator","section":"Managed Mode","path":"/docs/guide/cli/generator/generator#managed-mode","headings":["Managed Mode"],"excerpt":"Managed Mode Managed mode automatically sets file and field options in your protobuf descriptors during code generation without modifying the original .proto files. This feature is compatible with buf's managed mode and ","content":"Managed Mode Managed mode automatically sets file and field options in your protobuf descriptors during code generation without modifying the original .proto files. This feature is compatible with buf's managed mode and provides a consistent way to manage language-specific options across your codebase."},{"id":"cli/generator/generator::managed-mode::87","title":"Generator","section":"Managed Mode","path":"/docs/guide/cli/generator/generator#managed-mode","headings":["Managed Mode"],"excerpt":"Managed Mode **Key benefits:** **No proto file modifications**: Options are applied at generation time, keeping your proto files clean **Consistent defaults**: Automatic application of language-specific naming convention","content":"Managed Mode **Key benefits:** **No proto file modifications**: Options are applied at generation time, keeping your proto files clean **Consistent defaults**: Automatic application of language-specific naming conventions **Centralized configuration**: Manage all options in one place (easyp.yaml) **Module-specific rules**: Apply different options to different modules or paths **buf compatibility**: Works the same way as buf managed mode"},{"id":"cli/generator/generator::how-it-works::88","title":"Generator","section":"How It Works","path":"/docs/guide/cli/generator/generator#how-it-works","headings":["How It Works"],"excerpt":"How It Works When managed mode is enabled, EasyP automatically applies file and field options to your protobuf descriptors before code generation. This happens in memory, so your original .proto files remain unchanged.","content":"How It Works When managed mode is enabled, EasyP automatically applies file and field options to your protobuf descriptors before code generation. This happens in memory, so your original .proto files remain unchanged."},{"id":"cli/generator/generator::how-it-works::89","title":"Generator","section":"How It Works","path":"/docs/guide/cli/generator/generator#how-it-works","headings":["How It Works"],"excerpt":"How It Works **Default values** are applied for certain options based on language conventions: Java: java_package_prefix defaults to \"com\", java_multiple_files defaults to true C#: csharp_namespace defaults to PascalCase","content":"How It Works **Default values** are applied for certain options based on language conventions: Java: java_package_prefix defaults to \"com\", java_multiple_files defaults to true C#: csharp_namespace defaults to PascalCase of package name Ruby: ruby_package defaults to PascalCase with :: separator PHP: php_namespace defaults to PascalCase with \\ separator Objective-C: objc_class_prefix defaults to first letters of package parts C++: cc_enable_arenas defaults to true"},{"id":"cli/generator/generator::how-it-works::90","title":"Generator","section":"How It Works","path":"/docs/guide/cli/generator/generator#how-it-works","headings":["How It Works"],"excerpt":"How It Works **Overrides** allow you to set specific values for options, with support for filtering by module, protobuf package, path, or field. Without module, package, or path, an override applies to all files in the g","content":"How It Works **Overrides** allow you to set specific values for options, with support for filtering by module, protobuf package, path, or field. Without module, package, or path, an override applies to all files in the generation request, including dependencies and git_repo inputs."},{"id":"cli/generator/generator::how-it-works::91","title":"Generator","section":"How It Works","path":"/docs/guide/cli/generator/generator#how-it-works","headings":["How It Works"],"excerpt":"How It Works **Disables** allow you to prevent managed mode from modifying specific options or files. This is the recommended way to exclude external dependencies that already define their own options.","content":"How It Works **Disables** allow you to prevent managed mode from modifying specific options or files. This is the recommended way to exclude external dependencies that already define their own options."},{"id":"cli/generator/generator::configuration::92","title":"Generator","section":"Configuration","path":"/docs/guide/cli/generator/generator#configuration","headings":["Configuration"],"excerpt":"Configuration ```yaml generate: managed: enabled: true disable: # Disable managed mode for specific module - module: github.com/googleapis/googleapis # Disable specific option globally - file_option: java_package_prefix","content":"Configuration ```yaml generate: managed: enabled: true disable: # Disable managed mode for specific module - module: github.com/googleapis/googleapis # Disable specific option globally - file_option: java_package_prefix"},{"id":"cli/generator/generator::configuration::93","title":"Generator","section":"Configuration","path":"/docs/guide/cli/generator/generator#configuration","headings":["Configuration"],"excerpt":"Configuration Disable for specific protobuf package - package: acme.weather.v1 file_option: java_package # Disable for specific path - path: legacy/ file_option: go_package # Disable field option for specific field - fie","content":"Configuration Disable for specific protobuf package - package: acme.weather.v1 file_option: java_package # Disable for specific path - path: legacy/ file_option: go_package # Disable field option for specific field - field_option: jstype field: com.example.User.id override: # Override go_package_prefix for all files - file_option: go_package_prefix value: github.com/mycompany/myproject/gen/go # Override for specific module - file_option: java_package_prefix value: com.mycompany module: github.com/mycompany/internal-protos"},{"id":"cli/generator/generator::configuration::94","title":"Generator","section":"Configuration","path":"/docs/guide/cli/generator/generator#configuration","headings":["Configuration"],"excerpt":"Configuration Override for specific protobuf package - file_option: go_package_prefix value: github.com/mycompany/myproject/gen/go package: acme.weather.v1 # Override for specific path - file_option: csharp_namespace_pre","content":"Configuration Override for specific protobuf package - file_option: go_package_prefix value: github.com/mycompany/myproject/gen/go package: acme.weather.v1 # Override for specific path - file_option: csharp_namespace_prefix value: MyCompany path: api/v1/ # Override for multiple files with same value using prefix path # This matches both internal/cms/bmi.proto and internal/cms/bmi_service.proto - file_option: go_package value: spec/cms/bmi path: \"internal/cms/bmi\" # Override field option for specific path - field_option: jstype value: JS_STRING path: api/v1/ # Override for specific field - field_option: jstype value: JS_NUMBER field: com.example.User.big_id ```"},{"id":"cli/generator/generator::supported-file-options::95","title":"Generator","section":"Supported File Options","path":"/docs/guide/cli/generator/generator#supported-file-options","headings":["Supported File Options"],"excerpt":"Supported File Options Option Description Has Default? -------- ------------- -------------- go_package Go import path ❌ go_package_prefix Prefix for Go import paths ❌ java_package Java package name ❌ java_package_prefix","content":"Supported File Options Option Description Has Default? -------- ------------- -------------- go_package Go import path ❌ go_package_prefix Prefix for Go import paths ❌ java_package Java package name ❌ java_package_prefix Prefix for Java packages ✅ (\"com\") java_package_suffix Suffix for Java packages ❌ java_multiple_files Generate multiple Java files ✅ (true) java_outer_classname Outer class name ✅ (PascalCase + \"Proto\") java_string_check_utf8 UTF-8 validation ❌ csharp_namespace C# namespace ✅ (PascalCase) csharp_namespace_prefix Prefix for C# namespaces ❌ ruby_package Ruby module name ✅ (PascalCase with ::) ruby_package_suffix Suffix for Ruby packages ❌ php_namespace PHP namespace ✅ (PascalCase with \\) php_metadata_namespace PHP metadata namespace ❌ php_metadata_namespace_suffix Suffix for PHP metadata ❌ objc_class_prefix Objective-C class prefix ✅ (First letters) swift_prefix Swift prefix ❌ optimize_for Code generation optimization ❌ cc_enable_arenas C++ arena allocation ✅ (true)"},{"id":"cli/generator/generator::supported-field-options::96","title":"Generator","section":"Supported Field Options","path":"/docs/guide/cli/generator/generator#supported-field-options","headings":["Supported Field Options"],"excerpt":"Supported Field Options Option Description Applies To -------- ------------- ------------ jstype JavaScript type for 64-bit integers int64, uint64, sint64, fixed64, sfixed64","content":"Supported Field Options Option Description Applies To -------- ------------- ------------ jstype JavaScript type for 64-bit integers int64, uint64, sint64, fixed64, sfixed64"},{"id":"cli/generator/generator::basic-setup-with-defaults::97","title":"Generator","section":"Basic Setup with Defaults","path":"/docs/guide/cli/generator/generator#basic-setup-with-defaults","headings":["Basic Setup with Defaults"],"excerpt":"Basic Setup with Defaults Enable managed mode to get automatic defaults for all supported languages:","content":"Basic Setup with Defaults Enable managed mode to get automatic defaults for all supported languages:"},{"id":"cli/generator/generator::basic-setup-with-defaults::98","title":"Generator","section":"Basic Setup with Defaults","path":"/docs/guide/cli/generator/generator#basic-setup-with-defaults","headings":["Basic Setup with Defaults"],"excerpt":"Basic Setup with Defaults This will automatically: Set java_package to com. for all files Set java_multiple_files to true Set csharp_namespace to PascalCase of package name Set ruby_package to PascalCase with :: separato","content":"Basic Setup with Defaults This will automatically: Set java_package to com. for all files Set java_multiple_files to true Set csharp_namespace to PascalCase of package name Set ruby_package to PascalCase with :: separator And more..."},{"id":"cli/generator/generator::custom-go-package-prefix::99","title":"Generator","section":"Custom Go Package Prefix","path":"/docs/guide/cli/generator/generator#custom-go-package-prefix","headings":["Custom Go Package Prefix"],"excerpt":"Custom Go Package Prefix Override the Go package prefix for your project:","content":"Custom Go Package Prefix Override the Go package prefix for your project:"},{"id":"cli/generator/generator::custom-go-package-prefix::100","title":"Generator","section":"Custom Go Package Prefix","path":"/docs/guide/cli/generator/generator#custom-go-package-prefix","headings":["Custom Go Package Prefix"],"excerpt":"Custom Go Package Prefix This will set go_package to github.com/mycompany/myproject/gen/go/ for all files.","content":"Custom Go Package Prefix This will set go_package to github.com/mycompany/myproject/gen/go/ for all files."},{"id":"cli/generator/generator::dynamic-go-package-paths-with-markers::101","title":"Generator","section":"Dynamic Go Package Paths with Markers","path":"/docs/guide/cli/generator/generator#dynamic-go-package-paths-with-markers","headings":["Dynamic Go Package Paths with Markers"],"excerpt":"Dynamic Go Package Paths with Markers For more complex path generation, you can use markers in go_package_prefix or go_package values:","content":"Dynamic Go Package Paths with Markers For more complex path generation, you can use markers in go_package_prefix or go_package values:"},{"id":"cli/generator/generator::dynamic-go-package-paths-with-markers::102","title":"Generator","section":"Dynamic Go Package Paths with Markers","path":"/docs/guide/cli/generator/generator#dynamic-go-package-paths-with-markers","headings":["Dynamic Go Package Paths with Markers"],"excerpt":"Dynamic Go Package Paths with Markers","content":"Dynamic Go Package Paths with Markers"},{"id":"cli/generator/generator::dynamic-go-package-paths-with-markers::103","title":"Generator","section":"Dynamic Go Package Paths with Markers","path":"/docs/guide/cli/generator/generator#dynamic-go-package-paths-with-markers","headings":["Dynamic Go Package Paths with Markers"],"excerpt":"Dynamic Go Package Paths with Markers **Available markers:** {{file_path}} - Full file path without .proto extension - Example: internal/cms/as.proto → internal/cms/as {{file_dir}} - Directory path only, without filename","content":"Dynamic Go Package Paths with Markers **Available markers:** {{file_path}} - Full file path without .proto extension - Example: internal/cms/as.proto → internal/cms/as {{file_dir}} - Directory path only, without filename - Example: internal/cms/as.proto → internal/cms {{file_dir_without:prefix/}} - Directory path with prefix removed, and base filename without _service/_grpc suffixes - Example: {{file_dir_without:internal/}} for internal/cms/as_service.proto → cms/as {{file_path_without:prefix/}} - Full file path with prefix removed - Example: {{file_path_without:internal/}} for internal/cms/as.proto → cms/as"},{"id":"cli/generator/generator::module-specific-overrides::104","title":"Generator","section":"Module-Specific Overrides","path":"/docs/guide/cli/generator/generator#module-specific-overrides","headings":["Module-Specific Overrides"],"excerpt":"Module-Specific Overrides Apply different options to different modules:","content":"Module-Specific Overrides Apply different options to different modules:"},{"id":"cli/generator/generator::module-specific-overrides::105","title":"Generator","section":"Module-Specific Overrides","path":"/docs/guide/cli/generator/generator#module-specific-overrides","headings":["Module-Specific Overrides"],"excerpt":"Module-Specific Overrides module matches the EasyP module source exactly: the dependency or git_repo.url value before @version (for example github.com/mycompany/internal-protos or https://github.com/mycompany/internal-pr","content":"Module-Specific Overrides module matches the EasyP module source exactly: the dependency or git_repo.url value before @version (for example github.com/mycompany/internal-protos or https://github.com/mycompany/internal-protos). It is not the Go module path from go.mod."},{"id":"cli/generator/generator::module-specific-overrides::106","title":"Generator","section":"Module-Specific Overrides","path":"/docs/guide/cli/generator/generator#module-specific-overrides","headings":["Module-Specific Overrides"],"excerpt":"Module-Specific Overrides package matches the protobuf package declaration exactly, for example acme.weather.v1.","content":"Module-Specific Overrides package matches the protobuf package declaration exactly, for example acme.weather.v1."},{"id":"cli/generator/generator::package-specific-overrides::107","title":"Generator","section":"Package-Specific Overrides","path":"/docs/guide/cli/generator/generator#package-specific-overrides","headings":["Package-Specific Overrides"],"excerpt":"Package-Specific Overrides Apply different options to files from a specific protobuf package:","content":"Package-Specific Overrides Apply different options to files from a specific protobuf package:"},{"id":"cli/generator/generator::disabling-for-external-dependencies::108","title":"Generator","section":"Disabling for External Dependencies","path":"/docs/guide/cli/generator/generator#disabling-for-external-dependencies","headings":["Disabling for External Dependencies"],"excerpt":"Disabling for External Dependencies Disable managed mode for external dependencies that already have their options set:","content":"Disabling for External Dependencies Disable managed mode for external dependencies that already have their options set:"},{"id":"cli/generator/generator::disabling-for-external-dependencies::109","title":"Generator","section":"Disabling for External Dependencies","path":"/docs/guide/cli/generator/generator#disabling-for-external-dependencies","headings":["Disabling for External Dependencies"],"excerpt":"Disabling for External Dependencies","content":"Disabling for External Dependencies"},{"id":"cli/generator/generator::javascript-type-safety::110","title":"Generator","section":"JavaScript Type Safety","path":"/docs/guide/cli/generator/generator#javascript-type-safety","headings":["JavaScript Type Safety"],"excerpt":"JavaScript Type Safety Set jstype to JS_STRING for all 64-bit integer fields to prevent precision loss in JavaScript:","content":"JavaScript Type Safety Set jstype to JS_STRING for all 64-bit integer fields to prevent precision loss in JavaScript:"},{"id":"cli/generator/generator::path-matching::111","title":"Generator","section":"Path Matching","path":"/docs/guide/cli/generator/generator#path-matching","headings":["Path Matching"],"excerpt":"Path Matching Path matching in managed mode uses prefix-based matching (same as buf):","content":"Path Matching Path matching in managed mode uses prefix-based matching (same as buf):"},{"id":"cli/generator/generator::path-matching::112","title":"Generator","section":"Path Matching","path":"/docs/guide/cli/generator/generator#path-matching","headings":["Path Matching"],"excerpt":"Path Matching **Directory path** (ending with /): Matches all files in that directory and subdirectories - Example: path: \"internal/cms/\" matches internal/cms/as.proto, internal/cms/node.proto, internal/cms/v1/service.pr","content":"Path Matching **Directory path** (ending with /): Matches all files in that directory and subdirectories - Example: path: \"internal/cms/\" matches internal/cms/as.proto, internal/cms/node.proto, internal/cms/v1/service.proto **Exact file path** (ending with .proto): Matches only that specific file - Example: path: \"internal/cms/as.proto\" matches only internal/cms/as.proto **Prefix path** (no trailing / or .proto): Uses prefix matching (not directory-aware) - Example: path: \"internal/cms\" matches internal/cms/as.proto but also internal/cmsv2/file.proto"},{"id":"cli/generator/generator::rule-precedence::113","title":"Generator","section":"Rule Precedence","path":"/docs/guide/cli/generator/generator#rule-precedence","headings":["Rule Precedence"],"excerpt":"Rule Precedence When multiple rules match the same file or field, the following precedence applies:","content":"Rule Precedence When multiple rules match the same file or field, the following precedence applies:"},{"id":"cli/generator/generator::rule-precedence::114","title":"Generator","section":"Rule Precedence","path":"/docs/guide/cli/generator/generator#rule-precedence","headings":["Rule Precedence"],"excerpt":"Rule Precedence **Disable rules** take precedence - if an option is disabled, it won't be applied **Override rules** are applied in order - the last matching rule wins **Default values** are applied only if no override m","content":"Rule Precedence **Disable rules** take precedence - if an option is disabled, it won't be applied **Override rules** are applied in order - the last matching rule wins **Default values** are applied only if no override matches and the option isn't disabled"},{"id":"cli/generator/generator::compatibility-with-buf::115","title":"Generator","section":"Compatibility with buf","path":"/docs/guide/cli/generator/generator#compatibility-with-buf","headings":["Compatibility with buf"],"excerpt":"Compatibility with buf EasyP's managed mode is compatible with buf's managed mode. The same configuration format and behavior apply, making it easy to migrate between tools or use both in the same workflow.","content":"Compatibility with buf EasyP's managed mode is compatible with buf's managed mode. The same configuration format and behavior apply, making it easy to migrate between tools or use both in the same workflow."},{"id":"cli/generator/generator::descriptor-set-generation::116","title":"Generator","section":"Descriptor Set Generation","path":"/docs/guide/cli/generator/generator#descriptor-set-generation","headings":["Descriptor Set Generation"],"excerpt":"Descriptor Set Generation **https://protobuf.dev/programming-guides/techniques/#self-description**","content":"Descriptor Set Generation **https://protobuf.dev/programming-guides/techniques/#self-description**"},{"id":"cli/generator/generator::descriptor-set-generation::117","title":"Generator","section":"Descriptor Set Generation","path":"/docs/guide/cli/generator/generator#descriptor-set-generation","headings":["Descriptor Set Generation"],"excerpt":"Descriptor Set Generation EasyP supports generating binary FileDescriptorSet files using the --descriptor_set_out flag. This allows you to create self-describing protobuf messages that include schema information alongsid","content":"Descriptor Set Generation EasyP supports generating binary FileDescriptorSet files using the --descriptor_set_out flag. This allows you to create self-describing protobuf messages that include schema information alongside the data."},{"id":"cli/generator/generator::descriptor-set-generation::118","title":"Generator","section":"Descriptor Set Generation","path":"/docs/guide/cli/generator/generator#descriptor-set-generation","headings":["Descriptor Set Generation"],"excerpt":"Descriptor Set Generation **CLI flags:**","content":"Descriptor Set Generation **CLI flags:**"},{"id":"cli/generator/generator::descriptor-set-generation::119","title":"Generator","section":"Descriptor Set Generation","path":"/docs/guide/cli/generator/generator#descriptor-set-generation","headings":["Descriptor Set Generation"],"excerpt":"Descriptor Set Generation --descriptor_set_out - Output path for the binary FileDescriptorSet --include_imports - Include all transitive dependencies in the FileDescriptorSet","content":"Descriptor Set Generation --descriptor_set_out - Output path for the binary FileDescriptorSet --include_imports - Include all transitive dependencies in the FileDescriptorSet"},{"id":"cli/generator/generator::descriptor-set-generation::120","title":"Generator","section":"Descriptor Set Generation","path":"/docs/guide/cli/generator/generator#descriptor-set-generation","headings":["Descriptor Set Generation"],"excerpt":"Descriptor Set Generation **Example:**","content":"Descriptor Set Generation **Example:**"},{"id":"cli/generator/generator::descriptor-set-generation::121","title":"Generator","section":"Descriptor Set Generation","path":"/docs/guide/cli/generator/generator#descriptor-set-generation","headings":["Descriptor Set Generation"],"excerpt":"Descriptor Set Generation ```bash Generate descriptor set with only target files easyp generate --descriptor_set_out=./schema.pb","content":"Descriptor Set Generation ```bash Generate descriptor set with only target files easyp generate --descriptor_set_out=./schema.pb"},{"id":"cli/generator/generator::descriptor-set-generation::122","title":"Generator","section":"Descriptor Set Generation","path":"/docs/guide/cli/generator/generator#descriptor-set-generation","headings":["Descriptor Set Generation"],"excerpt":"Descriptor Set Generation Generate descriptor set with all dependencies easyp generate --descriptor_set_out=./schema.pb --include_imports ```","content":"Descriptor Set Generation Generate descriptor set with all dependencies easyp generate --descriptor_set_out=./schema.pb --include_imports ```"},{"id":"cli/generator/generator::descriptor-set-generation::123","title":"Generator","section":"Descriptor Set Generation","path":"/docs/guide/cli/generator/generator#descriptor-set-generation","headings":["Descriptor Set Generation"],"excerpt":"Descriptor Set Generation Self-describing messages are useful for dynamic message parsing, runtime schema validation, schema registries, and building generic gRPC clients. For more information, see the Protocol Buffers d","content":"Descriptor Set Generation Self-describing messages are useful for dynamic message parsing, runtime schema validation, schema registries, and building generic gRPC clients. For more information, see the Protocol Buffers documentation on self-description."},{"id":"cli/generator/generator::package-manager-integration::124","title":"Generator","section":"Package Manager Integration","path":"/docs/guide/cli/generator/generator#package-manager-integration","headings":["Package Manager Integration"],"excerpt":"Package Manager Integration One of EasyP's most powerful features is the seamless integration between the package manager and code generator. This integration eliminates the common problem of managing proto dependencies ","content":"Package Manager Integration One of EasyP's most powerful features is the seamless integration between the package manager and code generator. This integration eliminates the common problem of managing proto dependencies manually and ensures that your generated code always has access to the correct versions of imported proto files."},{"id":"cli/generator/generator::package-manager-integration::125","title":"Generator","section":"Package Manager Integration","path":"/docs/guide/cli/generator/generator#package-manager-integration","headings":["Package Manager Integration"],"excerpt":"Package Manager Integration **Key benefits:** **Automatic dependency resolution**: No need to manually manage proto import paths **Version consistency**: Dependencies are locked to specific versions via easyp.lock **Tran","content":"Package Manager Integration **Key benefits:** **Automatic dependency resolution**: No need to manually manage proto import paths **Version consistency**: Dependencies are locked to specific versions via easyp.lock **Transitive dependencies**: EasyP handles dependencies of dependencies automatically **Performance**: Local caching means dependencies are downloaded once and reused"},{"id":"cli/generator/generator::automatic-dependency-resolution::126","title":"Generator","section":"Automatic Dependency Resolution","path":"/docs/guide/cli/generator/generator#automatic-dependency-resolution","headings":["Automatic Dependency Resolution"],"excerpt":"Automatic Dependency Resolution When you define dependencies in the deps section, the generator automatically includes them in the proto path. This means your proto files can import from these dependencies without any ad","content":"Automatic Dependency Resolution When you define dependencies in the deps section, the generator automatically includes them in the proto path. This means your proto files can import from these dependencies without any additional configuration."},{"id":"cli/generator/generator::automatic-dependency-resolution::127","title":"Generator","section":"Automatic Dependency Resolution","path":"/docs/guide/cli/generator/generator#automatic-dependency-resolution","headings":["Automatic Dependency Resolution"],"excerpt":"Automatic Dependency Resolution **How it works:** EasyP downloads and caches dependencies based on your deps configuration During generation, these cached proto files are automatically added to the protoc import path You","content":"Automatic Dependency Resolution **How it works:** EasyP downloads and caches dependencies based on your deps configuration During generation, these cached proto files are automatically added to the protoc import path Your proto files can import from dependencies using standard import statements Generated code includes both your local protos and dependency protos when with_imports: true"},{"id":"cli/generator/generator::automatic-dependency-resolution::128","title":"Generator","section":"Automatic Dependency Resolution","path":"/docs/guide/cli/generator/generator#automatic-dependency-resolution","headings":["Automatic Dependency Resolution"],"excerpt":"Automatic Dependency Resolution Here's a simple example showing how dependency resolution works automatically. Notice that you only need to specify the dependencies once in the deps section:","content":"Automatic Dependency Resolution Here's a simple example showing how dependency resolution works automatically. Notice that you only need to specify the dependencies once in the deps section:"},{"id":"cli/generator/generator::automatic-dependency-resolution::129","title":"Generator","section":"Automatic Dependency Resolution","path":"/docs/guide/cli/generator/generator#automatic-dependency-resolution","headings":["Automatic Dependency Resolution"],"excerpt":"Automatic Dependency Resolution ```yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc-ecosystem/grpc-gateway@v2.19.1","content":"Automatic Dependency Resolution ```yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc-ecosystem/grpc-gateway@v2.19.1"},{"id":"cli/generator/generator::automatic-dependency-resolution::130","title":"Generator","section":"Automatic Dependency Resolution","path":"/docs/guide/cli/generator/generator#automatic-dependency-resolution","headings":["Automatic Dependency Resolution"],"excerpt":"Automatic Dependency Resolution generate: inputs: - directory: \"proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true # This automatically includes googleapis and grpc-gateway protos ``","content":"Automatic Dependency Resolution generate: inputs: - directory: \"proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true # This automatically includes googleapis and grpc-gateway protos ```"},{"id":"cli/generator/generator::dependency-usage-examples::131","title":"Generator","section":"Dependency Usage Examples","path":"/docs/guide/cli/generator/generator#dependency-usage-examples","headings":["Dependency Usage Examples"],"excerpt":"Dependency Usage Examples The following examples demonstrate common patterns for integrating external proto dependencies into your code generation workflow.","content":"Dependency Usage Examples The following examples demonstrate common patterns for integrating external proto dependencies into your code generation workflow."},{"id":"cli/generator/generator::using-google-apis::132","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs Google APIs are among the most commonly used proto dependencies, providing standard types and annotations for REST APIs, field validation, and common data structures.","content":"Using Google APIs Google APIs are among the most commonly used proto dependencies, providing standard types and annotations for REST APIs, field validation, and common data structures."},{"id":"cli/generator/generator::using-google-apis::133","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs **When to use Google APIs:** Building REST APIs with gRPC-Gateway Need standard types like Timestamp, Duration, Any Want to use Google's field behavior annotations Building services that integrate with ","content":"Using Google APIs **When to use Google APIs:** Building REST APIs with gRPC-Gateway Need standard types like Timestamp, Duration, Any Want to use Google's field behavior annotations Building services that integrate with Google Cloud"},{"id":"cli/generator/generator::using-google-apis::134","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs This configuration shows the minimal setup needed to use Google APIs in your proto files:","content":"Using Google APIs This configuration shows the minimal setup needed to use Google APIs in your proto files:"},{"id":"cli/generator/generator::using-google-apis::135","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs ```yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1","content":"Using Google APIs ```yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1"},{"id":"cli/generator/generator::using-google-apis::136","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs generate: inputs: - directory: \"api/proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true ```","content":"Using Google APIs generate: inputs: - directory: \"api/proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true ```"},{"id":"cli/generator/generator::using-google-apis::137","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs **Important:** Always use a pinned version (like common-protos-1_3_1) rather than latest to ensure build reproducibility.","content":"Using Google APIs **Important:** Always use a pinned version (like common-protos-1_3_1) rather than latest to ensure build reproducibility."},{"id":"cli/generator/generator::using-google-apis::138","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs Once configured, your proto files can import and use Google API definitions. Here's an example of a service using HTTP annotations:","content":"Using Google APIs Once configured, your proto files can import and use Google API definitions. Here's an example of a service using HTTP annotations:"},{"id":"cli/generator/generator::using-google-apis::139","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs ```proto // api/proto/service.proto syntax = \"proto3\";","content":"Using Google APIs ```proto // api/proto/service.proto syntax = \"proto3\";"},{"id":"cli/generator/generator::using-google-apis::140","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs import \"google/api/annotations.proto\"; import \"google/protobuf/timestamp.proto\";","content":"Using Google APIs import \"google/api/annotations.proto\"; import \"google/protobuf/timestamp.proto\";"},{"id":"cli/generator/generator::using-google-apis::141","title":"Generator","section":"Using Google APIs","path":"/docs/guide/cli/generator/generator#using-google-apis","headings":["Using Google APIs"],"excerpt":"Using Google APIs service MyService { rpc GetData(GetDataRequest) returns (GetDataResponse) { option (google.api.http) = { get: \"/v1/data\" }; } } ```","content":"Using Google APIs service MyService { rpc GetData(GetDataRequest) returns (GetDataResponse) { option (google.api.http) = { get: \"/v1/data\" }; } } ```"},{"id":"cli/generator/generator::using-validation-rules::142","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules Protoc-gen-validate provides powerful field validation capabilities that can be embedded directly in your proto definitions, eliminating the need for separate validation logic in your application c","content":"Using Validation Rules Protoc-gen-validate provides powerful field validation capabilities that can be embedded directly in your proto definitions, eliminating the need for separate validation logic in your application code."},{"id":"cli/generator/generator::using-validation-rules::143","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules **When to use validation:** Input validation for API endpoints Database model constraints Configuration file validation Any scenario where data integrity is critical","content":"Using Validation Rules **When to use validation:** Input validation for API endpoints Database model constraints Configuration file validation Any scenario where data integrity is critical"},{"id":"cli/generator/generator::using-validation-rules::144","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules **Benefits:** Validation rules are part of the proto definition (single source of truth) Code generation creates validation functions automatically Consistent validation across different languages ","content":"Using Validation Rules **Benefits:** Validation rules are part of the proto definition (single source of truth) Code generation creates validation functions automatically Consistent validation across different languages Better performance than runtime reflection-based validation"},{"id":"cli/generator/generator::using-validation-rules::145","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules ```yaml deps: - github.com/bufbuild/protoc-gen-validate@v0.10.1","content":"Using Validation Rules ```yaml deps: - github.com/bufbuild/protoc-gen-validate@v0.10.1"},{"id":"cli/generator/generator::using-validation-rules::146","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules generate: inputs: - directory: \"proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true - name: validate-go out: ./gen/go opts: paths: source_relative ```","content":"Using Validation Rules generate: inputs: - directory: \"proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true - name: validate-go out: ./gen/go opts: paths: source_relative ```"},{"id":"cli/generator/generator::using-validation-rules::147","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules **Note:** You need both the dependency (for proto imports) and the plugin (for code generation) to get full validation support.","content":"Using Validation Rules **Note:** You need both the dependency (for proto imports) and the plugin (for code generation) to get full validation support."},{"id":"cli/generator/generator::using-validation-rules::148","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules Here's how validation rules look in your proto files. The generated code will automatically validate these constraints:","content":"Using Validation Rules Here's how validation rules look in your proto files. The generated code will automatically validate these constraints:"},{"id":"cli/generator/generator::using-validation-rules::149","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules ```proto // proto/user.proto syntax = \"proto3\";","content":"Using Validation Rules ```proto // proto/user.proto syntax = \"proto3\";"},{"id":"cli/generator/generator::using-validation-rules::150","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules import \"validate/validate.proto\";","content":"Using Validation Rules import \"validate/validate.proto\";"},{"id":"cli/generator/generator::using-validation-rules::151","title":"Generator","section":"Using Validation Rules","path":"/docs/guide/cli/generator/generator#using-validation-rules","headings":["Using Validation Rules"],"excerpt":"Using Validation Rules message User { string email = 1 [(validate.rules).string.email = true]; int32 age = 2 [(validate.rules).int32.gte = 0]; } ```","content":"Using Validation Rules message User { string email = 1 [(validate.rules).string.email = true]; int32 age = 2 [(validate.rules).int32.gte = 0]; } ```"},{"id":"cli/generator/generator::complex-multi-dependency-setup::152","title":"Generator","section":"Complex Multi-Dependency Setup","path":"/docs/guide/cli/generator/generator#complex-multi-dependency-setup","headings":["Complex Multi-Dependency Setup"],"excerpt":"Complex Multi-Dependency Setup This example demonstrates a production-ready configuration that combines multiple dependencies and plugins for a complete API development workflow:","content":"Complex Multi-Dependency Setup This example demonstrates a production-ready configuration that combines multiple dependencies and plugins for a complete API development workflow:"},{"id":"cli/generator/generator::complex-multi-dependency-setup::153","title":"Generator","section":"Complex Multi-Dependency Setup","path":"/docs/guide/cli/generator/generator#complex-multi-dependency-setup","headings":["Complex Multi-Dependency Setup"],"excerpt":"Complex Multi-Dependency Setup ```yaml deps: # Core Google APIs - Standard types and HTTP annotations - github.com/googleapis/googleapis@common-protos-1_3_1 # gRPC Gateway for REST APIs - Enables HTTP/JSON interfaces - g","content":"Complex Multi-Dependency Setup ```yaml deps: # Core Google APIs - Standard types and HTTP annotations - github.com/googleapis/googleapis@common-protos-1_3_1 # gRPC Gateway for REST APIs - Enables HTTP/JSON interfaces - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 # Validation rules - Field-level validation constraints - github.com/bufbuild/protoc-gen-validate@v0.10.1 # Company internal shared types - Common business objects - github.com/mycompany/shared-protos@v1.5.0"},{"id":"cli/generator/generator::complex-multi-dependency-setup::154","title":"Generator","section":"Complex Multi-Dependency Setup","path":"/docs/guide/cli/generator/generator#complex-multi-dependency-setup","headings":["Complex Multi-Dependency Setup"],"excerpt":"Complex Multi-Dependency Setup generate: inputs: - directory: \"api/proto\" plugins: # Go code generation - Core protobuf structures - name: go out: ./gen/go opts: paths: source_relative module: github.com/mycompany/myserv","content":"Complex Multi-Dependency Setup generate: inputs: - directory: \"api/proto\" plugins: # Go code generation - Core protobuf structures - name: go out: ./gen/go opts: paths: source_relative module: github.com/mycompany/myservice with_imports: true # gRPC service stubs - Server and client interfaces - name: go-grpc out: ./gen/go opts: paths: source_relative require_unimplemented_servers: false # REST Gateway - HTTP-to-gRPC proxy code - name: grpc-gateway out: ./gen/go opts: paths: source_relative # OpenAPI documentation - API specification - name: openapiv2 out: ./gen/openapi opts: simple_operation_ids: true # Validation code - Input validation functions - name: validate-go out: ./gen/go opts: paths: source_relative ```"},{"id":"cli/generator/generator::dependency-cache-integration::155","title":"Generator","section":"Dependency Cache Integration","path":"/docs/guide/cli/generator/generator#dependency-cache-integration","headings":["Dependency Cache Integration"],"excerpt":"Dependency Cache Integration The generator leverages EasyP's module cache for fast builds:","content":"Dependency Cache Integration The generator leverages EasyP's module cache for fast builds:"},{"id":"cli/generator/generator::dependency-cache-integration::156","title":"Generator","section":"Dependency Cache Integration","path":"/docs/guide/cli/generator/generator#dependency-cache-integration","headings":["Dependency Cache Integration"],"excerpt":"Dependency Cache Integration ```bash Download dependencies once easyp mod download","content":"Dependency Cache Integration ```bash Download dependencies once easyp mod download"},{"id":"cli/generator/generator::dependency-cache-integration::157","title":"Generator","section":"Dependency Cache Integration","path":"/docs/guide/cli/generator/generator#dependency-cache-integration","headings":["Dependency Cache Integration"],"excerpt":"Dependency Cache Integration Generate code (uses cached dependencies) easyp generate","content":"Dependency Cache Integration Generate code (uses cached dependencies) easyp generate"},{"id":"cli/generator/generator::dependency-cache-integration::158","title":"Generator","section":"Dependency Cache Integration","path":"/docs/guide/cli/generator/generator#dependency-cache-integration","headings":["Dependency Cache Integration"],"excerpt":"Dependency Cache Integration Dependencies are cached in ~/.easyp/mod/ ls ~/.easyp/mod/github.com/googleapis/googleapis/ ```","content":"Dependency Cache Integration Dependencies are cached in ~/.easyp/mod/ ls ~/.easyp/mod/github.com/googleapis/googleapis/ ```"},{"id":"cli/generator/generator::remote-generation::159","title":"Generator","section":"Remote Generation","path":"/docs/guide/cli/generator/generator#remote-generation","headings":["Remote Generation"],"excerpt":"Remote Generation Remote generation is a powerful feature that allows you to generate code from proto files hosted in remote Git repositories without requiring a local checkout. This enables true microservices architectu","content":"Remote Generation Remote generation is a powerful feature that allows you to generate code from proto files hosted in remote Git repositories without requiring a local checkout. This enables true microservices architecture where teams can consume each other's APIs without tight coupling."},{"id":"cli/generator/generator::remote-generation::160","title":"Generator","section":"Remote Generation","path":"/docs/guide/cli/generator/generator#remote-generation","headings":["Remote Generation"],"excerpt":"Remote Generation **Key advantages:** **Decoupled development**: Teams can work independently while consuming each other's APIs **Version control**: Pin to specific versions of external APIs for stability **Reduced repos","content":"Remote Generation **Key advantages:** **Decoupled development**: Teams can work independently while consuming each other's APIs **Version control**: Pin to specific versions of external APIs for stability **Reduced repository size**: No need to vendor or submodule external proto files **Automatic updates**: Easy to update to newer versions when ready"},{"id":"cli/generator/generator::remote-generation::161","title":"Generator","section":"Remote Generation","path":"/docs/guide/cli/generator/generator#remote-generation","headings":["Remote Generation"],"excerpt":"Remote Generation **Best practices:** Always use tagged versions in production environments Test with latest versions in development, but pin in production Use semantic versioning when available for easier dependency man","content":"Remote Generation **Best practices:** Always use tagged versions in production environments Test with latest versions in development, but pin in production Use semantic versioning when available for easier dependency management Consider the network implications for CI/CD systems"},{"id":"cli/generator/generator::remote-proto-sources::162","title":"Generator","section":"Remote Proto Sources","path":"/docs/guide/cli/generator/generator#remote-proto-sources","headings":["Remote Proto Sources"],"excerpt":"Remote Proto Sources Generate from remote repositories directly. This is particularly useful in microservices architectures where different teams own different proto definitions.","content":"Remote Proto Sources Generate from remote repositories directly. This is particularly useful in microservices architectures where different teams own different proto definitions."},{"id":"cli/generator/generator::remote-proto-sources::163","title":"Generator","section":"Remote Proto Sources","path":"/docs/guide/cli/generator/generator#remote-proto-sources","headings":["Remote Proto Sources"],"excerpt":"Remote Proto Sources **Typical workflow:** Team A publishes proto definitions in a Git repository with proper versioning Team B references these protos in their easyp.yaml configuration During generation, EasyP automatic","content":"Remote Proto Sources **Typical workflow:** Team A publishes proto definitions in a Git repository with proper versioning Team B references these protos in their easyp.yaml configuration During generation, EasyP automatically fetches and uses the remote protos Generated code includes client libraries for Team A's services"},{"id":"cli/generator/generator::remote-proto-sources::164","title":"Generator","section":"Remote Proto Sources","path":"/docs/guide/cli/generator/generator#remote-proto-sources","headings":["Remote Proto Sources"],"excerpt":"Remote Proto Sources Here's a practical example showing how to combine local and remote proto sources in a single generation configuration:","content":"Remote Proto Sources Here's a practical example showing how to combine local and remote proto sources in a single generation configuration:"},{"id":"cli/generator/generator::remote-generation-use-cases::165","title":"Generator","section":"Remote Generation Use Cases","path":"/docs/guide/cli/generator/generator#remote-generation-use-cases","headings":["Remote Generation Use Cases"],"excerpt":"Remote Generation Use Cases These examples demonstrate real-world scenarios where remote generation provides significant value in distributed development environments.","content":"Remote Generation Use Cases These examples demonstrate real-world scenarios where remote generation provides significant value in distributed development environments."},{"id":"cli/generator/generator::multi-team-development::166","title":"Generator","section":"Multi-Team Development","path":"/docs/guide/cli/generator/generator#multi-team-development","headings":["Multi-Team Development"],"excerpt":"Multi-Team Development Multi-team development is where remote generation truly shines. Instead of coordinating shared repositories or complex dependency management, teams can independently evolve their APIs while consume","content":"Multi-Team Development Multi-team development is where remote generation truly shines. Instead of coordinating shared repositories or complex dependency management, teams can independently evolve their APIs while consumers automatically get updates through versioned dependencies."},{"id":"cli/generator/generator::multi-team-development::167","title":"Generator","section":"Multi-Team Development","path":"/docs/guide/cli/generator/generator#multi-team-development","headings":["Multi-Team Development"],"excerpt":"Multi-Team Development This pattern is especially valuable in large organizations where: Teams have different release cycles and development velocities API ownership is clearly defined but consumption is widespread You w","content":"Multi-Team Development This pattern is especially valuable in large organizations where: Teams have different release cycles and development velocities API ownership is clearly defined but consumption is widespread You want to avoid the overhead of coordinating shared proto repositories Different teams use different technology stacks but need to communicate"},{"id":"cli/generator/generator::vendor-api-integration::168","title":"Generator","section":"Vendor API Integration","path":"/docs/guide/cli/generator/generator#vendor-api-integration","headings":["Vendor API Integration"],"excerpt":"Vendor API Integration Many vendors now provide proto definitions for their APIs, enabling strongly-typed client generation instead of relying on hand-written HTTP clients. This approach provides better type safety, auto","content":"Vendor API Integration Many vendors now provide proto definitions for their APIs, enabling strongly-typed client generation instead of relying on hand-written HTTP clients. This approach provides better type safety, automatic serialization, and often better performance."},{"id":"cli/generator/generator::vendor-api-integration::169","title":"Generator","section":"Vendor API Integration","path":"/docs/guide/cli/generator/generator#vendor-api-integration","headings":["Vendor API Integration"],"excerpt":"Vendor API Integration Benefits of using vendor proto definitions: **Type safety**: Compile-time checking of API calls and data structures **Automatic updates**: New API features become available through version updates ","content":"Vendor API Integration Benefits of using vendor proto definitions: **Type safety**: Compile-time checking of API calls and data structures **Automatic updates**: New API features become available through version updates **Consistency**: Same interface patterns across different vendor integrations **Performance**: Binary serialization is often faster than JSON **Documentation**: Proto files serve as authoritative API documentation"},{"id":"cli/generator/generator::commands::170","title":"Generator","section":"Commands","path":"/docs/guide/cli/generator/generator#commands","headings":["Commands"],"excerpt":"Commands The EasyP command-line interface provides flexible options for running code generation with different configurations and environments.","content":"Commands The EasyP command-line interface provides flexible options for running code generation with different configurations and environments."},{"id":"cli/generator/generator::basic-generation::171","title":"Generator","section":"Basic Generation","path":"/docs/guide/cli/generator/generator#basic-generation","headings":["Basic Generation"],"excerpt":"Basic Generation These are the most commonly used command patterns for everyday development and production use:","content":"Basic Generation These are the most commonly used command patterns for everyday development and production use:"},{"id":"cli/generator/generator::basic-generation::172","title":"Generator","section":"Basic Generation","path":"/docs/guide/cli/generator/generator#basic-generation","headings":["Basic Generation"],"excerpt":"Basic Generation ```bash Use default easyp.yaml configuration - Most common for development easyp generate","content":"Basic Generation ```bash Use default easyp.yaml configuration - Most common for development easyp generate"},{"id":"cli/generator/generator::basic-generation::173","title":"Generator","section":"Basic Generation","path":"/docs/guide/cli/generator/generator#basic-generation","headings":["Basic Generation"],"excerpt":"Basic Generation Use custom configuration file - Essential for multi-environment setups easyp --cfg production.easyp.yaml generate","content":"Basic Generation Use custom configuration file - Essential for multi-environment setups easyp --cfg production.easyp.yaml generate"},{"id":"cli/generator/generator::basic-generation::174","title":"Generator","section":"Basic Generation","path":"/docs/guide/cli/generator/generator#basic-generation","headings":["Basic Generation"],"excerpt":"Basic Generation Generate with debug logs - Helpful for debugging and CI/CD easyp --debug generate","content":"Basic Generation Generate with debug logs - Helpful for debugging and CI/CD easyp --debug generate"},{"id":"cli/generator/generator::basic-generation::175","title":"Generator","section":"Basic Generation","path":"/docs/guide/cli/generator/generator#basic-generation","headings":["Basic Generation"],"excerpt":"Basic Generation Generate with custom cache location - Useful for CI systems or shared environments EASYPPATH=/tmp/easyp-cache easyp generate ```","content":"Basic Generation Generate with custom cache location - Useful for CI systems or shared environments EASYPPATH=/tmp/easyp-cache easyp generate ```"},{"id":"cli/generator/generator::integration-with-package-manager::176","title":"Generator","section":"Integration with Package Manager","path":"/docs/guide/cli/generator/generator#integration-with-package-manager","headings":["Integration with Package Manager"],"excerpt":"Integration with Package Manager EasyP's package manager integration means you can either explicitly manage dependencies or let the generator handle them automatically. The explicit approach gives you more control, while","content":"Integration with Package Manager EasyP's package manager integration means you can either explicitly manage dependencies or let the generator handle them automatically. The explicit approach gives you more control, while the automatic approach is more convenient:"},{"id":"cli/generator/generator::integration-with-package-manager::177","title":"Generator","section":"Integration with Package Manager","path":"/docs/guide/cli/generator/generator#integration-with-package-manager","headings":["Integration with Package Manager"],"excerpt":"Integration with Package Manager ```bash Explicit workflow - Better for CI/CD and when you want to cache dependencies easyp mod download # Download and cache dependencies first easyp generate # Generate code using cached","content":"Integration with Package Manager ```bash Explicit workflow - Better for CI/CD and when you want to cache dependencies easyp mod download # Download and cache dependencies first easyp generate # Generate code using cached dependencies"},{"id":"cli/generator/generator::integration-with-package-manager::178","title":"Generator","section":"Integration with Package Manager","path":"/docs/guide/cli/generator/generator#integration-with-package-manager","headings":["Integration with Package Manager"],"excerpt":"Integration with Package Manager Automatic workflow - Convenient for development (generate downloads dependencies automatically) easyp generate ```","content":"Integration with Package Manager Automatic workflow - Convenient for development (generate downloads dependencies automatically) easyp generate ```"},{"id":"cli/generator/generator::advanced-usage::179","title":"Generator","section":"Advanced Usage","path":"/docs/guide/cli/generator/generator#advanced-usage","headings":["Advanced Usage"],"excerpt":"Advanced Usage These advanced usage patterns are useful for specific deployment scenarios, debugging, or when you need fine-grained control over the generation process:","content":"Advanced Usage These advanced usage patterns are useful for specific deployment scenarios, debugging, or when you need fine-grained control over the generation process:"},{"id":"cli/generator/generator::advanced-usage::180","title":"Generator","section":"Advanced Usage","path":"/docs/guide/cli/generator/generator#advanced-usage","headings":["Advanced Usage"],"excerpt":"Advanced Usage ```bash Generate from specific input directory - Override config file settings easyp generate --path=./api/proto","content":"Advanced Usage ```bash Generate from specific input directory - Override config file settings easyp generate --path=./api/proto"},{"id":"cli/generator/generator::advanced-usage::181","title":"Generator","section":"Advanced Usage","path":"/docs/guide/cli/generator/generator#advanced-usage","headings":["Advanced Usage"],"excerpt":"Advanced Usage Generate using vendored dependencies - For offline builds or Docker containers easyp mod vendor easyp generate","content":"Advanced Usage Generate using vendored dependencies - For offline builds or Docker containers easyp mod vendor easyp generate"},{"id":"cli/generator/generator::advanced-usage::182","title":"Generator","section":"Advanced Usage","path":"/docs/guide/cli/generator/generator#advanced-usage","headings":["Advanced Usage"],"excerpt":"Advanced Usage Generate from a custom project root - Useful in monorepos or nested workdirs easyp generate --root=/usr/local/src/my-project --path=./api/proto ```","content":"Advanced Usage Generate from a custom project root - Useful in monorepos or nested workdirs easyp generate --root=/usr/local/src/my-project --path=./api/proto ```"},{"id":"cli/generator/generator::common-patterns::183","title":"Generator","section":"Common Patterns","path":"/docs/guide/cli/generator/generator#common-patterns","headings":["Common Patterns"],"excerpt":"Common Patterns These patterns represent real-world scenarios and best practices for organizing code generation in different project structures.","content":"Common Patterns These patterns represent real-world scenarios and best practices for organizing code generation in different project structures."},{"id":"cli/generator/generator::multi-language-generation::184","title":"Generator","section":"Multi-Language Generation","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Multi-Language Generation"],"excerpt":"Multi-Language Generation Multi-language generation is essential for organizations using different technologies across their stack. EasyP makes it easy to generate consistent client libraries and types for multiple progr","content":"Multi-Language Generation Multi-language generation is essential for organizations using different technologies across their stack. EasyP makes it easy to generate consistent client libraries and types for multiple programming languages from the same proto definitions."},{"id":"cli/generator/generator::multi-language-generation::185","title":"Generator","section":"Multi-Language Generation","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Multi-Language Generation"],"excerpt":"Multi-Language Generation **Common scenarios:** **Full-stack applications**: Go/Java backend with TypeScript frontend for web apps **Data platforms**: Go services with Python data science tools and analysis scripts **Mic","content":"Multi-Language Generation **Common scenarios:** **Full-stack applications**: Go/Java backend with TypeScript frontend for web apps **Data platforms**: Go services with Python data science tools and analysis scripts **Microservices**: Different services implemented in optimal languages for their domain **Client libraries**: Providing SDKs in multiple languages for external developers **Legacy integration**: Modern gRPC services with legacy systems using different languages"},{"id":"cli/generator/generator::multi-language-generation::186","title":"Generator","section":"Multi-Language Generation","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Multi-Language Generation"],"excerpt":"Multi-Language Generation **Performance considerations:** Each plugin runs independently, so generation time scales linearly with plugin count Consider using parallel execution (make -j4) for large numbers of plugins Out","content":"Multi-Language Generation **Performance considerations:** Each plugin runs independently, so generation time scales linearly with plugin count Consider using parallel execution (make -j4) for large numbers of plugins Output directories should be organized hierarchically to avoid file conflicts Some plugins are faster than others - profile your build to identify bottlenecks"},{"id":"cli/generator/generator::multi-language-generation::187","title":"Generator","section":"Multi-Language Generation","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Multi-Language Generation"],"excerpt":"Multi-Language Generation **Maintenance benefits:** Single source of truth for API definitions prevents schema drift Consistent types across all languages reduce integration bugs Automatic synchronization when proto defi","content":"Multi-Language Generation **Maintenance benefits:** Single source of truth for API definitions prevents schema drift Consistent types across all languages reduce integration bugs Automatic synchronization when proto definitions change eliminates manual updates Reduced chance of API drift between different language implementations Easier refactoring since changes propagate to all generated code"},{"id":"cli/generator/generator::multi-language-generation::188","title":"Generator","section":"Multi-Language Generation","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Multi-Language Generation"],"excerpt":"Multi-Language Generation This example shows a typical multi-language setup for a full-stack application with backend services, web frontend, data analysis, and documentation:","content":"Multi-Language Generation This example shows a typical multi-language setup for a full-stack application with backend services, web frontend, data analysis, and documentation:"},{"id":"cli/generator/generator::multi-language-generation::189","title":"Generator","section":"Multi-Language Generation","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Multi-Language Generation"],"excerpt":"Multi-Language Generation **Organization tip:** Use separate output directories for each language to avoid file conflicts and make it easier to integrate with language-specific build systems.","content":"Multi-Language Generation **Organization tip:** Use separate output directories for each language to avoid file conflicts and make it easier to integrate with language-specific build systems."},{"id":"cli/generator/generator::multi-language-generation::190","title":"Generator","section":"Multi-Language Generation","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Multi-Language Generation"],"excerpt":"Multi-Language Generation The EasyP generator provides a comprehensive solution for protocol buffer code generation, supporting everything from simple local development to complex enterprise multi-language workflows with","content":"Multi-Language Generation The EasyP generator provides a comprehensive solution for protocol buffer code generation, supporting everything from simple local development to complex enterprise multi-language workflows with remote dependencies."},{"id":"cli/linter/linter::why-use-a-linter-for-proto-files::0","title":"Linter","section":"Why Use a Linter for Proto Files?","path":"/docs/guide/cli/linter/linter#why-use-a-linter-for-proto-files","headings":["Why Use a Linter for Proto Files?"],"excerpt":"Why Use a Linter for Proto Files? Linters play a crucial role in modern software development, particularly for proto files. By enforcing style and formatting rules, linters help maintain code quality, reduce potential bu","content":"Why Use a Linter for Proto Files? Linters play a crucial role in modern software development, particularly for proto files. By enforcing style and formatting rules, linters help maintain code quality, reduce potential bugs, and ensure that the codebase is clean and readable. This leads to several benefits:"},{"id":"cli/linter/linter::why-use-a-linter-for-proto-files::1","title":"Linter","section":"Why Use a Linter for Proto Files?","path":"/docs/guide/cli/linter/linter#why-use-a-linter-for-proto-files","headings":["Why Use a Linter for Proto Files?"],"excerpt":"Why Use a Linter for Proto Files? **Reduced Development Costs:** Linters catch errors early in the development cycle, saving time and resources that would be spent on debugging and fixing issues later. **Improved Team Co","content":"Why Use a Linter for Proto Files? **Reduced Development Costs:** Linters catch errors early in the development cycle, saving time and resources that would be spent on debugging and fixing issues later. **Improved Team Collaboration:** A standardized codebase makes it easier for team members to understand and work with each other's code, facilitating a smoother collaborative environment. **Business Efficiency:** Teams using linters often produce higher quality code, which translates to fewer production issues and maintenance costs. This makes businesses that adopt linting practices more competitive and cost-effective."},{"id":"cli/linter/linter::configuration-reference::2","title":"Linter","section":"Configuration Reference","path":"/docs/guide/cli/linter/linter#configuration-reference","headings":["Configuration Reference"],"excerpt":"Configuration Reference EasyP linter provides flexible configuration options to adapt to different project requirements. All configuration is done through the lint section in your easyp.yaml file.","content":"Configuration Reference EasyP linter provides flexible configuration options to adapt to different project requirements. All configuration is done through the lint section in your easyp.yaml file."},{"id":"cli/linter/linter::complete-configuration-example::3","title":"Linter","section":"Complete Configuration Example","path":"/docs/guide/cli/linter/linter#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example","content":"Complete Configuration Example"},{"id":"cli/linter/linter::use-string::4","title":"Linter","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) Specifies which linter rules or rule categories to apply. You can mix individual rules with predefined categories.","content":"use ([]string) Specifies which linter rules or rule categories to apply. You can mix individual rules with predefined categories."},{"id":"cli/linter/linter::use-string::5","title":"Linter","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) **Available categories:** **MINIMAL**: Basic package consistency checks **BASIC**: Naming conventions and usage patterns **DEFAULT**: Recommended rules for most projects **COMMENTS**: Comment presence and ","content":"use ([]string) **Available categories:** **MINIMAL**: Basic package consistency checks **BASIC**: Naming conventions and usage patterns **DEFAULT**: Recommended rules for most projects **COMMENTS**: Comment presence and formatting **UNARY_RPC**: Restrictions on streaming RPCs"},{"id":"cli/linter/linter::use-string::6","title":"Linter","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) **Individual rules**: Any specific rule name (e.g., ENUM_PASCAL_CASE, FIELD_LOWER_SNAKE_CASE)","content":"use ([]string) **Individual rules**: Any specific rule name (e.g., ENUM_PASCAL_CASE, FIELD_LOWER_SNAKE_CASE)"},{"id":"cli/linter/linter::use-string::7","title":"Linter","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) **Examples:** ```yaml Use predefined categories use: [MINIMAL, BASIC, DEFAULT]","content":"use ([]string) **Examples:** ```yaml Use predefined categories use: [MINIMAL, BASIC, DEFAULT]"},{"id":"cli/linter/linter::use-string::8","title":"Linter","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) Mix categories with individual rules use: - MINIMAL - COMMENT_SERVICE - COMMENT_RPC - ENUM_PASCAL_CASE","content":"use ([]string) Mix categories with individual rules use: - MINIMAL - COMMENT_SERVICE - COMMENT_RPC - ENUM_PASCAL_CASE"},{"id":"cli/linter/linter::use-string::9","title":"Linter","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) Use only specific rules use: - PACKAGE_DEFINED - SERVICE_PASCAL_CASE - FIELD_LOWER_SNAKE_CASE ```","content":"use ([]string) Use only specific rules use: - PACKAGE_DEFINED - SERVICE_PASCAL_CASE - FIELD_LOWER_SNAKE_CASE ```"},{"id":"cli/linter/linter::enum_zero_value_suffix-string::10","title":"Linter","section":"enum_zero_value_suffix (string)","path":"/docs/guide/cli/linter/linter#enum_zero_value_suffix-string","headings":["enum_zero_value_suffix (string)"],"excerpt":"enum_zero_value_suffix (string) Defines the required suffix for zero-value enum entries. This enforces a consistent naming pattern for the default enum value.","content":"enum_zero_value_suffix (string) Defines the required suffix for zero-value enum entries. This enforces a consistent naming pattern for the default enum value."},{"id":"cli/linter/linter::enum_zero_value_suffix-string::11","title":"Linter","section":"enum_zero_value_suffix (string)","path":"/docs/guide/cli/linter/linter#enum_zero_value_suffix-string","headings":["enum_zero_value_suffix (string)"],"excerpt":"enum_zero_value_suffix (string) **Default**: Empty (no suffix required) **Common values**: \"UNSPECIFIED\", \"UNKNOWN\", \"DEFAULT\"","content":"enum_zero_value_suffix (string) **Default**: Empty (no suffix required) **Common values**: \"UNSPECIFIED\", \"UNKNOWN\", \"DEFAULT\""},{"id":"cli/linter/linter::enum_zero_value_suffix-string::12","title":"Linter","section":"enum_zero_value_suffix (string)","path":"/docs/guide/cli/linter/linter#enum_zero_value_suffix-string","headings":["enum_zero_value_suffix (string)"],"excerpt":"enum_zero_value_suffix (string) **Example:**","content":"enum_zero_value_suffix (string) **Example:**"},{"id":"cli/linter/linter::enum_zero_value_suffix-string::13","title":"Linter","section":"enum_zero_value_suffix (string)","path":"/docs/guide/cli/linter/linter#enum_zero_value_suffix-string","headings":["enum_zero_value_suffix (string)"],"excerpt":"enum_zero_value_suffix (string) With this setting, enum definitions must follow this pattern:","content":"enum_zero_value_suffix (string) With this setting, enum definitions must follow this pattern:"},{"id":"cli/linter/linter::service_suffix-string::14","title":"Linter","section":"service_suffix (string)","path":"/docs/guide/cli/linter/linter#service_suffix-string","headings":["service_suffix (string)"],"excerpt":"service_suffix (string) Specifies the required suffix for service names. This ensures consistent service naming across your project.","content":"service_suffix (string) Specifies the required suffix for service names. This ensures consistent service naming across your project."},{"id":"cli/linter/linter::service_suffix-string::15","title":"Linter","section":"service_suffix (string)","path":"/docs/guide/cli/linter/linter#service_suffix-string","headings":["service_suffix (string)"],"excerpt":"service_suffix (string) **Default**: Empty (no suffix required) **Common values**: \"Service\", \"API\", \"Svc\"","content":"service_suffix (string) **Default**: Empty (no suffix required) **Common values**: \"Service\", \"API\", \"Svc\""},{"id":"cli/linter/linter::service_suffix-string::16","title":"Linter","section":"service_suffix (string)","path":"/docs/guide/cli/linter/linter#service_suffix-string","headings":["service_suffix (string)"],"excerpt":"service_suffix (string) **Example:**","content":"service_suffix (string) **Example:**"},{"id":"cli/linter/linter::service_suffix-string::17","title":"Linter","section":"service_suffix (string)","path":"/docs/guide/cli/linter/linter#service_suffix-string","headings":["service_suffix (string)"],"excerpt":"service_suffix (string) With this setting, service definitions must follow this pattern:","content":"service_suffix (string) With this setting, service definitions must follow this pattern:"},{"id":"cli/linter/linter::ignore-string::18","title":"Linter","section":"ignore ([]string)","path":"/docs/guide/cli/linter/linter#ignore-string","headings":["ignore ([]string)"],"excerpt":"ignore ([]string) Lists directories or file paths to completely exclude from linting. Supports glob patterns and relative paths from the project root.","content":"ignore ([]string) Lists directories or file paths to completely exclude from linting. Supports glob patterns and relative paths from the project root."},{"id":"cli/linter/linter::ignore-string::19","title":"Linter","section":"ignore ([]string)","path":"/docs/guide/cli/linter/linter#ignore-string","headings":["ignore ([]string)"],"excerpt":"ignore ([]string) **Use cases:** Third-party or vendor proto files Generated proto files Legacy code being phased out Test fixtures that intentionally violate rules","content":"ignore ([]string) **Use cases:** Third-party or vendor proto files Generated proto files Legacy code being phased out Test fixtures that intentionally violate rules"},{"id":"cli/linter/linter::ignore-string::20","title":"Linter","section":"ignore ([]string)","path":"/docs/guide/cli/linter/linter#ignore-string","headings":["ignore ([]string)"],"excerpt":"ignore ([]string) **Examples:**","content":"ignore ([]string) **Examples:**"},{"id":"cli/linter/linter::except-string::21","title":"Linter","section":"except ([]string)","path":"/docs/guide/cli/linter/linter#except-string","headings":["except ([]string)"],"excerpt":"except ([]string) Disables specific rules globally across the entire project. Use this when certain rules don't fit your project's conventions.","content":"except ([]string) Disables specific rules globally across the entire project. Use this when certain rules don't fit your project's conventions."},{"id":"cli/linter/linter::except-string::22","title":"Linter","section":"except ([]string)","path":"/docs/guide/cli/linter/linter#except-string","headings":["except ([]string)"],"excerpt":"except ([]string) **When to use:** Legacy projects with established naming conventions Projects with specific style requirements Gradual adoption of linting rules","content":"except ([]string) **When to use:** Legacy projects with established naming conventions Projects with specific style requirements Gradual adoption of linting rules"},{"id":"cli/linter/linter::except-string::23","title":"Linter","section":"except ([]string)","path":"/docs/guide/cli/linter/linter#except-string","headings":["except ([]string)"],"excerpt":"except ([]string) **Examples:**","content":"except ([]string) **Examples:**"},{"id":"cli/linter/linter::allow_comment_ignores-bool::24","title":"Linter","section":"allow_comment_ignores (bool)","path":"/docs/guide/cli/linter/linter#allow_comment_ignores-bool","headings":["allow_comment_ignores (bool)"],"excerpt":"allow_comment_ignores (bool) Enables or disables the ability to ignore specific rules using inline comments in proto files.","content":"allow_comment_ignores (bool) Enables or disables the ability to ignore specific rules using inline comments in proto files."},{"id":"cli/linter/linter::allow_comment_ignores-bool::25","title":"Linter","section":"allow_comment_ignores (bool)","path":"/docs/guide/cli/linter/linter#allow_comment_ignores-bool","headings":["allow_comment_ignores (bool)"],"excerpt":"allow_comment_ignores (bool) **Default**: false **Recommended**: true for flexibility during development","content":"allow_comment_ignores (bool) **Default**: false **Recommended**: true for flexibility during development"},{"id":"cli/linter/linter::allow_comment_ignores-bool::26","title":"Linter","section":"allow_comment_ignores (bool)","path":"/docs/guide/cli/linter/linter#allow_comment_ignores-bool","headings":["allow_comment_ignores (bool)"],"excerpt":"allow_comment_ignores (bool) **Example:**","content":"allow_comment_ignores (bool) **Example:**"},{"id":"cli/linter/linter::allow_comment_ignores-bool::27","title":"Linter","section":"allow_comment_ignores (bool)","path":"/docs/guide/cli/linter/linter#allow_comment_ignores-bool","headings":["allow_comment_ignores (bool)"],"excerpt":"allow_comment_ignores (bool) When enabled, you can use comments to ignore rules on specific elements:","content":"allow_comment_ignores (bool) When enabled, you can use comments to ignore rules on specific elements:"},{"id":"cli/linter/linter::ignore_only-mapstringstring::28","title":"Linter","section":"ignore_only (map[string][]string)","path":"/docs/guide/cli/linter/linter#ignore_only-mapstringstring","headings":["ignore_only (map[string][]string)"],"excerpt":"ignore_only (mapstringstring) Allows you to disable specific rules only for certain files or directories, while keeping them active elsewhere.","content":"ignore_only (mapstringstring) Allows you to disable specific rules only for certain files or directories, while keeping them active elsewhere."},{"id":"cli/linter/linter::ignore_only-mapstringstring::29","title":"Linter","section":"ignore_only (map[string][]string)","path":"/docs/guide/cli/linter/linter#ignore_only-mapstringstring","headings":["ignore_only (map[string][]string)"],"excerpt":"ignore_only (mapstringstring) **Use cases:** Legacy code that can't be easily updated Third-party protos with different conventions Generated code that doesn't follow your style Gradual migration strategies","content":"ignore_only (mapstringstring) **Use cases:** Legacy code that can't be easily updated Third-party protos with different conventions Generated code that doesn't follow your style Gradual migration strategies"},{"id":"cli/linter/linter::ignore_only-mapstringstring::30","title":"Linter","section":"ignore_only (map[string][]string)","path":"/docs/guide/cli/linter/linter#ignore_only-mapstringstring","headings":["ignore_only (map[string][]string)"],"excerpt":"ignore_only (mapstringstring) **Format**: rule_name: [list_of_paths]","content":"ignore_only (mapstringstring) **Format**: rule_name: [list_of_paths]"},{"id":"cli/linter/linter::ignore_only-mapstringstring::31","title":"Linter","section":"ignore_only (map[string][]string)","path":"/docs/guide/cli/linter/linter#ignore_only-mapstringstring","headings":["ignore_only (map[string][]string)"],"excerpt":"ignore_only (mapstringstring) **Examples:**","content":"ignore_only (mapstringstring) **Examples:**"},{"id":"cli/linter/linter::comment-based-rule-ignoring::32","title":"Linter","section":"Comment-Based Rule Ignoring","path":"/docs/guide/cli/linter/linter#comment-based-rule-ignoring","headings":["Comment-Based Rule Ignoring"],"excerpt":"Comment-Based Rule Ignoring When allow_comment_ignores is enabled, you can use inline comments to ignore specific linter rules for individual proto elements. This provides fine-grained control over rule enforcement.","content":"Comment-Based Rule Ignoring When allow_comment_ignores is enabled, you can use inline comments to ignore specific linter rules for individual proto elements. This provides fine-grained control over rule enforcement."},{"id":"cli/linter/linter::supported-comment-formats::33","title":"Linter","section":"Supported Comment Formats","path":"/docs/guide/cli/linter/linter#supported-comment-formats","headings":["Supported Comment Formats"],"excerpt":"Supported Comment Formats EasyP supports two comment formats for maximum compatibility:","content":"Supported Comment Formats EasyP supports two comment formats for maximum compatibility:"},{"id":"cli/linter/linter::ignoring-message-and-field-rules::34","title":"Linter","section":"Ignoring Message and Field Rules","path":"/docs/guide/cli/linter/linter#ignoring-message-and-field-rules","headings":["Ignoring Message and Field Rules"],"excerpt":"Ignoring Message and Field Rules","content":"Ignoring Message and Field Rules"},{"id":"cli/linter/linter::best-practices-for-comment-ignores::35","title":"Linter","section":"Best Practices for Comment Ignores","path":"/docs/guide/cli/linter/linter#best-practices-for-comment-ignores","headings":["Best Practices for Comment Ignores"],"excerpt":"Best Practices for Comment Ignores","content":"Best Practices for Comment Ignores"},{"id":"cli/linter/linter::use-sparingly::36","title":"Linter","section":"Use Sparingly","path":"/docs/guide/cli/linter/linter#use-sparingly","headings":["Use Sparingly"],"excerpt":"Use Sparingly Comment ignores should be the exception, not the rule. Overuse indicates that your linting configuration may need adjustment.","content":"Use Sparingly Comment ignores should be the exception, not the rule. Overuse indicates that your linting configuration may need adjustment."},{"id":"cli/linter/linter::add-explanatory-comments::37","title":"Linter","section":"Add Explanatory Comments","path":"/docs/guide/cli/linter/linter#add-explanatory-comments","headings":["Add Explanatory Comments"],"excerpt":"Add Explanatory Comments Always explain why you're ignoring a rule to help future maintainers understand the decision.","content":"Add Explanatory Comments Always explain why you're ignoring a rule to help future maintainers understand the decision."},{"id":"cli/linter/linter::prefer-configuration-over-comments::38","title":"Linter","section":"Prefer Configuration Over Comments","path":"/docs/guide/cli/linter/linter#prefer-configuration-over-comments","headings":["Prefer Configuration Over Comments"],"excerpt":"Prefer Configuration Over Comments When multiple files need the same rule ignored, use ignore_only configuration instead of individual comments.","content":"Prefer Configuration Over Comments When multiple files need the same rule ignored, use ignore_only configuration instead of individual comments."},{"id":"cli/linter/linter::prefer-configuration-over-comments::39","title":"Linter","section":"Prefer Configuration Over Comments","path":"/docs/guide/cli/linter/linter#prefer-configuration-over-comments","headings":["Prefer Configuration Over Comments"],"excerpt":"Prefer Configuration Over Comments **Instead of:** ```proto // In file1.proto // buf:lint:ignore COMMENT_SERVICE service API1 { ... }","content":"Prefer Configuration Over Comments **Instead of:** ```proto // In file1.proto // buf:lint:ignore COMMENT_SERVICE service API1 { ... }"},{"id":"cli/linter/linter::prefer-configuration-over-comments::40","title":"Linter","section":"Prefer Configuration Over Comments","path":"/docs/guide/cli/linter/linter#prefer-configuration-over-comments","headings":["Prefer Configuration Over Comments"],"excerpt":"Prefer Configuration Over Comments // In file2.proto // buf:lint:ignore COMMENT_SERVICE service API2 { ... } ```","content":"Prefer Configuration Over Comments // In file2.proto // buf:lint:ignore COMMENT_SERVICE service API2 { ... } ```"},{"id":"cli/linter/linter::prefer-configuration-over-comments::41","title":"Linter","section":"Prefer Configuration Over Comments","path":"/docs/guide/cli/linter/linter#prefer-configuration-over-comments","headings":["Prefer Configuration Over Comments"],"excerpt":"Prefer Configuration Over Comments **Use:**","content":"Prefer Configuration Over Comments **Use:**"},{"id":"cli/linter/linter::linter-categories::42","title":"Linter","section":"Linter Categories","path":"/docs/guide/cli/linter/linter#linter-categories","headings":["Linter Categories"],"excerpt":"Linter Categories To accommodate different project needs and preferences, EasyP linter provides predefined rule categories. These categories group together various rules, allowing teams to quickly select the level of str","content":"Linter Categories To accommodate different project needs and preferences, EasyP linter provides predefined rule categories. These categories group together various rules, allowing teams to quickly select the level of strictness or areas they want to focus on during linting."},{"id":"cli/linter/linter::linter-categories::43","title":"Linter","section":"Linter Categories","path":"/docs/guide/cli/linter/linter#linter-categories","headings":["Linter Categories"],"excerpt":"Linter Categories **When to use each category:**","content":"Linter Categories **When to use each category:**"},{"id":"cli/linter/linter::linter-categories::44","title":"Linter","section":"Linter Categories","path":"/docs/guide/cli/linter/linter#linter-categories","headings":["Linter Categories"],"excerpt":"Linter Categories **MINIMAL:** Essential for any proto project - ensures basic consistency and prevents fundamental issues **BASIC:** Recommended for most projects - enforces common naming conventions and best practices ","content":"Linter Categories **MINIMAL:** Essential for any proto project - ensures basic consistency and prevents fundamental issues **BASIC:** Recommended for most projects - enforces common naming conventions and best practices **DEFAULT:** Additional quality checks - useful for mature projects with established workflows **COMMENTS:** Documentation requirements - important for public APIs and team collaboration **UNARY_RPC:** Streaming restrictions - use when your architecture requires only unary RPCs"},{"id":"cli/linter/linter::linter-categories::45","title":"Linter","section":"Linter Categories","path":"/docs/guide/cli/linter/linter#linter-categories","headings":["Linter Categories"],"excerpt":"Linter Categories The available categories are: **MINIMAL:** Basic checks to ensure package consistency. **BASIC:** Additional checks for naming conventions and usage patterns. **DEFAULT:** A set of default rules that mo","content":"Linter Categories The available categories are: **MINIMAL:** Basic checks to ensure package consistency. **BASIC:** Additional checks for naming conventions and usage patterns. **DEFAULT:** A set of default rules that most projects should use. **COMMENTS:** Ensures that comments are present and properly formatted. **UNARY_RPC:** Specific rules for unary RPC services."},{"id":"cli/linter/linter::rule-groupings::46","title":"Linter","section":"Rule Groupings","path":"/docs/guide/cli/linter/linter#rule-groupings","headings":["Rule Groupings"],"excerpt":"Rule Groupings Below are the rule groupings under each category:","content":"Rule Groupings Below are the rule groupings under each category:"},{"id":"cli/linter/linter::minimal::47","title":"Linter","section":"MINIMAL","path":"/docs/guide/cli/linter/linter#minimal","headings":["MINIMAL"],"excerpt":"MINIMAL DIRECTORY_SAME_PACKAGE PACKAGE_DEFINED PACKAGE_DIRECTORY_MATCH PACKAGE_SAME_DIRECTORY","content":"MINIMAL DIRECTORY_SAME_PACKAGE PACKAGE_DEFINED PACKAGE_DIRECTORY_MATCH PACKAGE_SAME_DIRECTORY"},{"id":"cli/linter/linter::basic::48","title":"Linter","section":"BASIC","path":"/docs/guide/cli/linter/linter#basic","headings":["BASIC"],"excerpt":"BASIC ENUM_FIRST_VALUE_ZERO ENUM_NO_ALLOW_ALIAS ENUM_PASCAL_CASE ENUM_VALUE_UPPER_SNAKE_CASE FIELD_LOWER_SNAKE_CASE IMPORT_NO_PUBLIC IMPORT_NO_WEAK IMPORT_USED MESSAGE_PASCAL_CASE ONEOF_LOWER_SNAKE_CASE PACKAGE_LOWER_SNA","content":"BASIC ENUM_FIRST_VALUE_ZERO ENUM_NO_ALLOW_ALIAS ENUM_PASCAL_CASE ENUM_VALUE_UPPER_SNAKE_CASE FIELD_LOWER_SNAKE_CASE IMPORT_NO_PUBLIC IMPORT_NO_WEAK IMPORT_USED MESSAGE_PASCAL_CASE ONEOF_LOWER_SNAKE_CASE PACKAGE_LOWER_SNAKE_CASE PACKAGE_SAME_CSHARP_NAMESPACE PACKAGE_SAME_GO_PACKAGE PACKAGE_SAME_JAVA_MULTIPLE_FILES PACKAGE_SAME_JAVA_PACKAGE PACKAGE_SAME_PHP_NAMESPACE PACKAGE_SAME_RUBY_PACKAGE PACKAGE_SAME_SWIFT_PREFIX RPC_PASCAL_CASE SERVICE_PASCAL_CASE"},{"id":"cli/linter/linter::default::49","title":"Linter","section":"DEFAULT","path":"/docs/guide/cli/linter/linter#default","headings":["DEFAULT"],"excerpt":"DEFAULT ENUM_VALUE_PREFIX ENUM_ZERO_VALUE_SUFFIX FILE_LOWER_SNAKE_CASE RPC_REQUEST_RESPONSE_UNIQUE RPC_REQUEST_STANDARD_NAME RPC_RESPONSE_STANDARD_NAME PACKAGE_VERSION_SUFFIX SERVICE_SUFFIX","content":"DEFAULT ENUM_VALUE_PREFIX ENUM_ZERO_VALUE_SUFFIX FILE_LOWER_SNAKE_CASE RPC_REQUEST_RESPONSE_UNIQUE RPC_REQUEST_STANDARD_NAME RPC_RESPONSE_STANDARD_NAME PACKAGE_VERSION_SUFFIX SERVICE_SUFFIX"},{"id":"cli/linter/linter::comments::50","title":"Linter","section":"COMMENTS","path":"/docs/guide/cli/linter/linter#comments","headings":["COMMENTS"],"excerpt":"COMMENTS COMMENT_ENUM COMMENT_ENUM_VALUE COMMENT_FIELD COMMENT_MESSAGE COMMENT_ONEOF COMMENT_RPC COMMENT_SERVICE","content":"COMMENTS COMMENT_ENUM COMMENT_ENUM_VALUE COMMENT_FIELD COMMENT_MESSAGE COMMENT_ONEOF COMMENT_RPC COMMENT_SERVICE"},{"id":"cli/linter/linter::unary_rpc::51","title":"Linter","section":"UNARY_RPC","path":"/docs/guide/cli/linter/linter#unary_rpc","headings":["UNARY_RPC"],"excerpt":"UNARY_RPC RPC_NO_CLIENT_STREAMING RPC_NO_SERVER_STREAMING","content":"UNARY_RPC RPC_NO_CLIENT_STREAMING RPC_NO_SERVER_STREAMING"},{"id":"cli/linter/linter::conclusion::52","title":"Linter","section":"Conclusion","path":"/docs/guide/cli/linter/linter#conclusion","headings":["Conclusion"],"excerpt":"Conclusion Adopting the EasyP linter for your proto files can significantly enhance your development workflow, code quality, and overall project maintainability. With full compatibility with the Buf linter, teams can eas","content":"Conclusion Adopting the EasyP linter for your proto files can significantly enhance your development workflow, code quality, and overall project maintainability. With full compatibility with the Buf linter, teams can easily migrate and start benefiting from our tool's robust features and flexible configuration options."},{"id":"cli/linter/rules/comment-enum-value::top::0","title":"COMMENT_ENUM_VALUE","path":"/docs/guide/cli/linter/rules/comment-enum-value","headings":[],"excerpt":"This rule checks that enum values have a comment.","content":"This rule checks that enum values have a comment."},{"id":"cli/linter/rules/comment-enum-value::bad::1","title":"COMMENT_ENUM_VALUE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-enum-value#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-enum-value::bad::2","title":"COMMENT_ENUM_VALUE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-enum-value#bad","headings":["Bad"],"excerpt":"Bad enum Foo { BAR = 0; BAZ = 1; } ```","content":"Bad enum Foo { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/comment-enum-value::good::3","title":"COMMENT_ENUM_VALUE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-enum-value#good","headings":["Good"],"excerpt":"Good enum Foo { // BAR value for bar logic // [!code focus] BAR = 0; // BAZ value for baz logic // [!code focus] BAZ = 1; } ```","content":"Good enum Foo { // BAR value for bar logic // [!code focus] BAR = 0; // BAZ value for baz logic // [!code focus] BAZ = 1; } ```"},{"id":"cli/linter/rules/comment-enum::top::0","title":"COMMENT_ENUM","path":"/docs/guide/cli/linter/rules/comment-enum","headings":[],"excerpt":"This rule checks that enum has a comment.","content":"This rule checks that enum has a comment."},{"id":"cli/linter/rules/comment-enum::bad::1","title":"COMMENT_ENUM","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-enum#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-enum::bad::2","title":"COMMENT_ENUM","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-enum#bad","headings":["Bad"],"excerpt":"Bad enum Foo { BAR = 0; BAZ = 1; } ```","content":"Bad enum Foo { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/comment-enum::good::3","title":"COMMENT_ENUM","section":"Good","path":"/docs/guide/cli/linter/rules/comment-enum#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-enum::good::4","title":"COMMENT_ENUM","section":"Good","path":"/docs/guide/cli/linter/rules/comment-enum#good","headings":["Good"],"excerpt":"Good // Foo enum for bar and baz logic // [!code focus] enum Foo { BAR = 0; BAZ = 1; } ```","content":"Good // Foo enum for bar and baz logic // [!code focus] enum Foo { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/comment-field::top::0","title":"COMMENT_FIELD","path":"/docs/guide/cli/linter/rules/comment-field","headings":[],"excerpt":"This rule checks that all message fields have a comment.","content":"This rule checks that all message fields have a comment."},{"id":"cli/linter/rules/comment-field::bad::1","title":"COMMENT_FIELD","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-field#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-field::bad::2","title":"COMMENT_FIELD","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-field#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; string baz = 2; } ```","content":"Bad message Foo { string bar = 1; string baz = 2; } ```"},{"id":"cli/linter/rules/comment-field::good::3","title":"COMMENT_FIELD","section":"Good","path":"/docs/guide/cli/linter/rules/comment-field#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-field::good::4","title":"COMMENT_FIELD","section":"Good","path":"/docs/guide/cli/linter/rules/comment-field#good","headings":["Good"],"excerpt":"Good message Foo { // bar field for bar logic // [!code focus] string bar = 1; // baz field for baz logic // [!code focus] string baz = 2; } ```","content":"Good message Foo { // bar field for bar logic // [!code focus] string bar = 1; // baz field for baz logic // [!code focus] string baz = 2; } ```"},{"id":"cli/linter/rules/comment-message::top::0","title":"COMMENT_MESSAGE","path":"/docs/guide/cli/linter/rules/comment-message","headings":[],"excerpt":"This rule checks that message has a comment.","content":"This rule checks that message has a comment."},{"id":"cli/linter/rules/comment-message::bad::1","title":"COMMENT_MESSAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-message#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; string baz = 2; } ```","content":"Bad message Foo { string bar = 1; string baz = 2; } ```"},{"id":"cli/linter/rules/comment-message::good::2","title":"COMMENT_MESSAGE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-message#good","headings":["Good"],"excerpt":"Good // Foo message for bar and baz logic // [!code focus] message Foo { // bar field for bar logic string bar = 1; // baz field for baz logic string baz = 2; } ```","content":"Good // Foo message for bar and baz logic // [!code focus] message Foo { // bar field for bar logic string bar = 1; // baz field for baz logic string baz = 2; } ```"},{"id":"cli/linter/rules/comment-oneof::top::0","title":"COMMENT_ONEOF","path":"/docs/guide/cli/linter/rules/comment-oneof","headings":[],"excerpt":"This rule checks that oneof has a comment.","content":"This rule checks that oneof has a comment."},{"id":"cli/linter/rules/comment-oneof::bad::1","title":"COMMENT_ONEOF","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-oneof#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-oneof::bad::2","title":"COMMENT_ONEOF","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-oneof#bad","headings":["Bad"],"excerpt":"Bad message Foo { oneof bar { string baz = 1; string qux = 2; } } ```","content":"Bad message Foo { oneof bar { string baz = 1; string qux = 2; } } ```"},{"id":"cli/linter/rules/comment-oneof::good::3","title":"COMMENT_ONEOF","section":"Good","path":"/docs/guide/cli/linter/rules/comment-oneof#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-oneof::good::4","title":"COMMENT_ONEOF","section":"Good","path":"/docs/guide/cli/linter/rules/comment-oneof#good","headings":["Good"],"excerpt":"Good message Foo { // bar oneof for baz and qux logic // [!code focus] oneof bar { string baz = 1; string qux = 2; } } ```","content":"Good message Foo { // bar oneof for baz and qux logic // [!code focus] oneof bar { string baz = 1; string qux = 2; } } ```"},{"id":"cli/linter/rules/comment-rpc::top::0","title":"COMMENT_RPC","path":"/docs/guide/cli/linter/rules/comment-rpc","headings":[],"excerpt":"This rule checks that rpc has a comment.","content":"This rule checks that rpc has a comment."},{"id":"cli/linter/rules/comment-rpc::bad::1","title":"COMMENT_RPC","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-rpc#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-rpc::bad::2","title":"COMMENT_RPC","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-rpc#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar (BarRequest) returns (BarResponse) {} rpc Baz (BazRequest) returns (BazResponse) {} } ```","content":"Bad service Foo { rpc Bar (BarRequest) returns (BarResponse) {} rpc Baz (BazRequest) returns (BazResponse) {} } ```"},{"id":"cli/linter/rules/comment-rpc::good::3","title":"COMMENT_RPC","section":"Good","path":"/docs/guide/cli/linter/rules/comment-rpc#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-rpc::good::4","title":"COMMENT_RPC","section":"Good","path":"/docs/guide/cli/linter/rules/comment-rpc#good","headings":["Good"],"excerpt":"Good service Foo { // Bar rpc for bar logic // [!code focus] rpc Bar (BarRequest) returns (BarResponse) {} // Baz rpc for baz logic // [!code focus] rpc Baz (BazRequest) returns (BazResponse) {} } ```","content":"Good service Foo { // Bar rpc for bar logic // [!code focus] rpc Bar (BarRequest) returns (BarResponse) {} // Baz rpc for baz logic // [!code focus] rpc Baz (BazRequest) returns (BazResponse) {} } ```"},{"id":"cli/linter/rules/comment-service::top::0","title":"COMMENT_SERVICE","path":"/docs/guide/cli/linter/rules/comment-service","headings":[],"excerpt":"This rule checks that service has a comment.","content":"This rule checks that service has a comment."},{"id":"cli/linter/rules/comment-service::bad::1","title":"COMMENT_SERVICE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-service#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-service::bad::2","title":"COMMENT_SERVICE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-service#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar (BarRequest) returns (BarResponse) {} } ```","content":"Bad service Foo { rpc Bar (BarRequest) returns (BarResponse) {} } ```"},{"id":"cli/linter/rules/comment-service::good::3","title":"COMMENT_SERVICE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-service#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-service::good::4","title":"COMMENT_SERVICE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-service#good","headings":["Good"],"excerpt":"Good // Foo service for bar logic // [!code focus] service Foo { // Bar rpc for bar logic rpc Bar (BarRequest) returns (BarResponse) {} } ```","content":"Good // Foo service for bar logic // [!code focus] service Foo { // Bar rpc for bar logic rpc Bar (BarRequest) returns (BarResponse) {} } ```"},{"id":"cli/linter/rules/directory-same-package::top::0","title":"DIRECTORY_SAME_PACKAGE","path":"/docs/guide/cli/linter/rules/directory-same-package","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/directory-same-package::top::1","title":"DIRECTORY_SAME_PACKAGE","path":"/docs/guide/cli/linter/rules/directory-same-package","headings":[],"excerpt":"This rule checks that all files in a given directory are in the same package.","content":"This rule checks that all files in a given directory are in the same package."},{"id":"cli/linter/rules/directory-same-package::bad::2","title":"DIRECTORY_SAME_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/directory-same-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: dir/foo.proto","content":"Bad ```proto // File: dir/foo.proto"},{"id":"cli/linter/rules/directory-same-package::bad::3","title":"DIRECTORY_SAME_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/directory-same-package#bad","headings":["Bad"],"excerpt":"Bad syntax = \"proto3\"; package foo;","content":"Bad syntax = \"proto3\"; package foo;"},{"id":"cli/linter/rules/directory-same-package::bad::4","title":"DIRECTORY_SAME_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/directory-same-package#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; } ```","content":"Bad message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/directory-same-package::good::5","title":"DIRECTORY_SAME_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/directory-same-package#good","headings":["Good"],"excerpt":"Good ```proto // File: dir/foo/foo.proto // [!code focus]","content":"Good ```proto // File: dir/foo/foo.proto // [!code focus]"},{"id":"cli/linter/rules/directory-same-package::good::6","title":"DIRECTORY_SAME_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/directory-same-package#good","headings":["Good"],"excerpt":"Good package dir.foo; // [!code focus]","content":"Good package dir.foo; // [!code focus]"},{"id":"cli/linter/rules/directory-same-package::good::7","title":"DIRECTORY_SAME_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/directory-same-package#good","headings":["Good"],"excerpt":"Good message Foo { string bar = 1; } ```","content":"Good message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/enum-first-value-zero::top::0","title":"ENUM_FIRST_VALUE_ZERO","path":"/docs/guide/cli/linter/rules/enum-first-value-zero","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-first-value-zero::top::1","title":"ENUM_FIRST_VALUE_ZERO","path":"/docs/guide/cli/linter/rules/enum-first-value-zero","headings":[],"excerpt":"This rule checks that the first value of an enum is zero.","content":"This rule checks that the first value of an enum is zero."},{"id":"cli/linter/rules/enum-first-value-zero::bad::2","title":"ENUM_FIRST_VALUE_ZERO","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-first-value-zero#bad","headings":["Bad"],"excerpt":"Bad enum Foo { BAR = 1; BAZ = 2; } ```","content":"Bad enum Foo { BAR = 1; BAZ = 2; } ```"},{"id":"cli/linter/rules/enum-first-value-zero::good::3","title":"ENUM_FIRST_VALUE_ZERO","section":"Good","path":"/docs/guide/cli/linter/rules/enum-first-value-zero#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-first-value-zero::good::4","title":"ENUM_FIRST_VALUE_ZERO","section":"Good","path":"/docs/guide/cli/linter/rules/enum-first-value-zero#good","headings":["Good"],"excerpt":"Good enum Foo { BAR = 0; // [!code focus] BAZ = 1; } ```","content":"Good enum Foo { BAR = 0; // [!code focus] BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-no-allow-alias::top::0","title":"ENUM_NO_ALLOW_ALIAS","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-no-allow-alias::top::1","title":"ENUM_NO_ALLOW_ALIAS","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias","headings":[],"excerpt":"This rule checks that the allow_alias option is not set to true in an enum.","content":"This rule checks that the allow_alias option is not set to true in an enum."},{"id":"cli/linter/rules/enum-no-allow-alias::bad::2","title":"ENUM_NO_ALLOW_ALIAS","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-no-allow-alias::bad::3","title":"ENUM_NO_ALLOW_ALIAS","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias#bad","headings":["Bad"],"excerpt":"Bad enum Foo { option allow_alias = true; // [!code focus] BAR = 0; BAZ = 1; } ```","content":"Bad enum Foo { option allow_alias = true; // [!code focus] BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-no-allow-alias::good::4","title":"ENUM_NO_ALLOW_ALIAS","section":"Good","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-no-allow-alias::good::5","title":"ENUM_NO_ALLOW_ALIAS","section":"Good","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias#good","headings":["Good"],"excerpt":"Good enum Foo { BAR = 0; BAZ = 1; } ```","content":"Good enum Foo { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-pascal-case::top::0","title":"ENUM_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/enum-pascal-case","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-pascal-case::top::1","title":"ENUM_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/enum-pascal-case","headings":[],"excerpt":"This rule checks that enum names are in PascalCase.","content":"This rule checks that enum names are in PascalCase."},{"id":"cli/linter/rules/enum-pascal-case::bad::2","title":"ENUM_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-pascal-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-pascal-case::bad::3","title":"ENUM_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-pascal-case#bad","headings":["Bad"],"excerpt":"Bad enum foo_bar { BAR = 0; BAZ = 1; } ```","content":"Bad enum foo_bar { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-pascal-case::good::4","title":"ENUM_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/enum-pascal-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-pascal-case::good::5","title":"ENUM_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/enum-pascal-case#good","headings":["Good"],"excerpt":"Good enum FooBar { // [!code focus] BAR = 0; BAZ = 1; } ```","content":"Good enum FooBar { // [!code focus] BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-value-prefix::top::0","title":"ENUM_VALUE_PREFIX","path":"/docs/guide/cli/linter/rules/enum-value-prefix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-value-prefix::top::1","title":"ENUM_VALUE_PREFIX","path":"/docs/guide/cli/linter/rules/enum-value-prefix","headings":[],"excerpt":"This rule checks that all enum values are prefixed with the enum name.","content":"This rule checks that all enum values are prefixed with the enum name."},{"id":"cli/linter/rules/enum-value-prefix::bad::2","title":"ENUM_VALUE_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-value-prefix#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-value-prefix::good::3","title":"ENUM_VALUE_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/enum-value-prefix#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-value-prefix::good::4","title":"ENUM_VALUE_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/enum-value-prefix#good","headings":["Good"],"excerpt":"Good enum Foo { FOO_BAR = 0; // [!code focus] } ```","content":"Good enum Foo { FOO_BAR = 0; // [!code focus] } ```"},{"id":"cli/linter/rules/enum-value-upper-snake-case::top::0","title":"ENUM_VALUE_UPPER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-value-upper-snake-case::top::1","title":"ENUM_VALUE_UPPER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case","headings":[],"excerpt":"This rule checks that enum values are in UPPER_SNAKE_CASE.","content":"This rule checks that enum values are in UPPER_SNAKE_CASE."},{"id":"cli/linter/rules/enum-value-upper-snake-case::bad::2","title":"ENUM_VALUE_UPPER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-value-upper-snake-case::bad::3","title":"ENUM_VALUE_UPPER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case#bad","headings":["Bad"],"excerpt":"Bad enum Foo { barName = 0; bazName = 1; } ```","content":"Bad enum Foo { barName = 0; bazName = 1; } ```"},{"id":"cli/linter/rules/enum-value-upper-snake-case::good::4","title":"ENUM_VALUE_UPPER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-value-upper-snake-case::good::5","title":"ENUM_VALUE_UPPER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case#good","headings":["Good"],"excerpt":"Good enum Foo { BAR_NAME = 0; // [!code focus] BAZ_NAME = 1; // [!code focus] } ```","content":"Good enum Foo { BAR_NAME = 0; // [!code focus] BAZ_NAME = 1; // [!code focus] } ```"},{"id":"cli/linter/rules/enum-zero-value-suffix::top::0","title":"ENUM_ZERO_VALUE_SUFFIX","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-zero-value-suffix::top::1","title":"ENUM_ZERO_VALUE_SUFFIX","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix","headings":[],"excerpt":"This rule checks that all enum zero values are suffixed with _NONE or your custom suffix.","content":"This rule checks that all enum zero values are suffixed with _NONE or your custom suffix."},{"id":"cli/linter/rules/enum-zero-value-suffix::bad::2","title":"ENUM_ZERO_VALUE_SUFFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-zero-value-suffix::good::3","title":"ENUM_ZERO_VALUE_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-zero-value-suffix::good::4","title":"ENUM_ZERO_VALUE_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix#good","headings":["Good"],"excerpt":"Good enum Foo { FOO_BAR_NONE = 0; // [!code focus] } ```","content":"Good enum Foo { FOO_BAR_NONE = 0; // [!code focus] } ```"},{"id":"cli/linter/rules/field-lower-snake-case::top::0","title":"FIELD_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/field-lower-snake-case","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/field-lower-snake-case::top::1","title":"FIELD_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/field-lower-snake-case","headings":[],"excerpt":"This rule checks that field names of messages are in lower_snake_case.","content":"This rule checks that field names of messages are in lower_snake_case."},{"id":"cli/linter/rules/field-lower-snake-case::bad::2","title":"FIELD_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/field-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/field-lower-snake-case::bad::3","title":"FIELD_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/field-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad message Foo { string BarName = 1; } ```","content":"Bad message Foo { string BarName = 1; } ```"},{"id":"cli/linter/rules/field-lower-snake-case::good::4","title":"FIELD_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/field-lower-snake-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/field-lower-snake-case::good::5","title":"FIELD_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/field-lower-snake-case#good","headings":["Good"],"excerpt":"Good message Foo { string bar_name = 1; // [!code focus] } ```","content":"Good message Foo { string bar_name = 1; // [!code focus] } ```"},{"id":"cli/linter/rules/file-lower-snake-case::top::0","title":"FILE_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/file-lower-snake-case","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/file-lower-snake-case::top::1","title":"FILE_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/file-lower-snake-case","headings":[],"excerpt":"This rule checks that all files are in lower_snake_case.","content":"This rule checks that all files are in lower_snake_case."},{"id":"cli/linter/rules/file-lower-snake-case::bad::2","title":"FILE_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/file-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: bar/FooBaz.proto","content":"Bad ```proto // File: bar/FooBaz.proto"},{"id":"cli/linter/rules/file-lower-snake-case::good::3","title":"FILE_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/file-lower-snake-case#good","headings":["Good"],"excerpt":"Good ```proto // File: bar/foo_baz.proto // [!code focus]","content":"Good ```proto // File: bar/foo_baz.proto // [!code focus]"},{"id":"cli/linter/rules/import-no-public::top::0","title":"IMPORT_NO_PUBLIC","path":"/docs/guide/cli/linter/rules/import-no-public","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/import-no-public::top::1","title":"IMPORT_NO_PUBLIC","path":"/docs/guide/cli/linter/rules/import-no-public","headings":[],"excerpt":"This rule checks that no public imports are used in a proto file.","content":"This rule checks that no public imports are used in a proto file."},{"id":"cli/linter/rules/import-no-public::bad::2","title":"IMPORT_NO_PUBLIC","section":"Bad","path":"/docs/guide/cli/linter/rules/import-no-public#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/import-no-public::bad::3","title":"IMPORT_NO_PUBLIC","section":"Bad","path":"/docs/guide/cli/linter/rules/import-no-public#bad","headings":["Bad"],"excerpt":"Bad import public \"bar.proto\"; ```","content":"Bad import public \"bar.proto\"; ```"},{"id":"cli/linter/rules/import-no-public::good::4","title":"IMPORT_NO_PUBLIC","section":"Good","path":"/docs/guide/cli/linter/rules/import-no-public#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/import-no-public::good::5","title":"IMPORT_NO_PUBLIC","section":"Good","path":"/docs/guide/cli/linter/rules/import-no-public#good","headings":["Good"],"excerpt":"Good import \"bar.proto\"; // [!code focus] ```","content":"Good import \"bar.proto\"; // [!code focus] ```"},{"id":"cli/linter/rules/import-no-weak::top::0","title":"IMPORT_NO_WEAK","path":"/docs/guide/cli/linter/rules/import-no-weak","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/import-no-weak::top::1","title":"IMPORT_NO_WEAK","path":"/docs/guide/cli/linter/rules/import-no-weak","headings":[],"excerpt":"This rule checks that no weak imports are used in a proto file.","content":"This rule checks that no weak imports are used in a proto file."},{"id":"cli/linter/rules/import-no-weak::bad::2","title":"IMPORT_NO_WEAK","section":"Bad","path":"/docs/guide/cli/linter/rules/import-no-weak#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto2\";","content":"Bad ```proto syntax = \"proto2\";"},{"id":"cli/linter/rules/import-no-weak::bad::3","title":"IMPORT_NO_WEAK","section":"Bad","path":"/docs/guide/cli/linter/rules/import-no-weak#bad","headings":["Bad"],"excerpt":"Bad import weak \"bar.proto\"; ```","content":"Bad import weak \"bar.proto\"; ```"},{"id":"cli/linter/rules/import-no-weak::good::4","title":"IMPORT_NO_WEAK","section":"Good","path":"/docs/guide/cli/linter/rules/import-no-weak#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto2\";","content":"Good ```proto syntax = \"proto2\";"},{"id":"cli/linter/rules/import-no-weak::good::5","title":"IMPORT_NO_WEAK","section":"Good","path":"/docs/guide/cli/linter/rules/import-no-weak#good","headings":["Good"],"excerpt":"Good import \"bar.proto\"; // [!code focus] ```","content":"Good import \"bar.proto\"; // [!code focus] ```"},{"id":"cli/linter/rules/import-used::top::0","title":"IMPORT_USED","path":"/docs/guide/cli/linter/rules/import-used","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/import-used::top::1","title":"IMPORT_USED","path":"/docs/guide/cli/linter/rules/import-used","headings":[],"excerpt":"This rule checks that all imports are used in a proto file.","content":"This rule checks that all imports are used in a proto file."},{"id":"cli/linter/rules/import-used::bad::2","title":"IMPORT_USED","section":"Bad","path":"/docs/guide/cli/linter/rules/import-used#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/import-used::good::3","title":"IMPORT_USED","section":"Good","path":"/docs/guide/cli/linter/rules/import-used#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/import-used::good::4","title":"IMPORT_USED","section":"Good","path":"/docs/guide/cli/linter/rules/import-used#good","headings":["Good"],"excerpt":"Good import \"bar.proto\"; // [!code focus]","content":"Good import \"bar.proto\"; // [!code focus]"},{"id":"cli/linter/rules/import-used::good::5","title":"IMPORT_USED","section":"Good","path":"/docs/guide/cli/linter/rules/import-used#good","headings":["Good"],"excerpt":"Good message Foo { bar.Bar bar = 1; // [!code focus] } ```","content":"Good message Foo { bar.Bar bar = 1; // [!code focus] } ```"},{"id":"cli/linter/rules/message-pascal-case::top::0","title":"MESSAGE_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/message-pascal-case","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/message-pascal-case::top::1","title":"MESSAGE_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/message-pascal-case","headings":[],"excerpt":"This rule checks that message names are in PascalCase.","content":"This rule checks that message names are in PascalCase."},{"id":"cli/linter/rules/message-pascal-case::bad::2","title":"MESSAGE_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/message-pascal-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/message-pascal-case::bad::3","title":"MESSAGE_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/message-pascal-case#bad","headings":["Bad"],"excerpt":"Bad message foo_bar { string bar_name = 1; } ```","content":"Bad message foo_bar { string bar_name = 1; } ```"},{"id":"cli/linter/rules/message-pascal-case::good::4","title":"MESSAGE_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/message-pascal-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/message-pascal-case::good::5","title":"MESSAGE_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/message-pascal-case#good","headings":["Good"],"excerpt":"Good message FooBar { // [!code focus] string bar_name = 1; } ```","content":"Good message FooBar { // [!code focus] string bar_name = 1; } ```"},{"id":"cli/linter/rules/oneof-lower-snake-case::top::0","title":"ONEOF_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/oneof-lower-snake-case::top::1","title":"ONEOF_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case","headings":[],"excerpt":"This rule checks that oneof names are in lower_snake_case.","content":"This rule checks that oneof names are in lower_snake_case."},{"id":"cli/linter/rules/oneof-lower-snake-case::bad::2","title":"ONEOF_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/oneof-lower-snake-case::bad::3","title":"ONEOF_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad message Foo { oneof BarName { string bar_name = 1; } } ```","content":"Bad message Foo { oneof BarName { string bar_name = 1; } } ```"},{"id":"cli/linter/rules/oneof-lower-snake-case::good::4","title":"ONEOF_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/oneof-lower-snake-case::good::5","title":"ONEOF_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case#good","headings":["Good"],"excerpt":"Good message Foo { oneof bar_name { // [!code focus] string bar_name = 1; } } ```","content":"Good message Foo { oneof bar_name { // [!code focus] string bar_name = 1; } } ```"},{"id":"cli/linter/rules/package-defined::top::0","title":"PACKAGE_DEFINED","path":"/docs/guide/cli/linter/rules/package-defined","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-defined::top::1","title":"PACKAGE_DEFINED","path":"/docs/guide/cli/linter/rules/package-defined","headings":[],"excerpt":"This rule checks that all files have a package declaration.","content":"This rule checks that all files have a package declaration."},{"id":"cli/linter/rules/package-defined::bad::2","title":"PACKAGE_DEFINED","section":"Bad","path":"/docs/guide/cli/linter/rules/package-defined#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-defined::bad::3","title":"PACKAGE_DEFINED","section":"Bad","path":"/docs/guide/cli/linter/rules/package-defined#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; }","content":"Bad message Foo { string bar = 1; }"},{"id":"cli/linter/rules/package-defined::good::4","title":"PACKAGE_DEFINED","section":"Good","path":"/docs/guide/cli/linter/rules/package-defined#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-defined::good::5","title":"PACKAGE_DEFINED","section":"Good","path":"/docs/guide/cli/linter/rules/package-defined#good","headings":["Good"],"excerpt":"Good package foo; // [!code focus]","content":"Good package foo; // [!code focus]"},{"id":"cli/linter/rules/package-defined::good::6","title":"PACKAGE_DEFINED","section":"Good","path":"/docs/guide/cli/linter/rules/package-defined#good","headings":["Good"],"excerpt":"Good message Foo { string bar = 1; } ```","content":"Good message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/package-directory-match::top::0","title":"PACKAGE_DIRECTORY_MATCH","path":"/docs/guide/cli/linter/rules/package-directory-match","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-directory-match::top::1","title":"PACKAGE_DIRECTORY_MATCH","path":"/docs/guide/cli/linter/rules/package-directory-match","headings":[],"excerpt":"This rule checks that all files are in a directory that matches their package name.","content":"This rule checks that all files are in a directory that matches their package name."},{"id":"cli/linter/rules/package-directory-match::bad::2","title":"PACKAGE_DIRECTORY_MATCH","section":"Bad","path":"/docs/guide/cli/linter/rules/package-directory-match#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: bar/foo.proto","content":"Bad ```proto // File: bar/foo.proto"},{"id":"cli/linter/rules/package-directory-match::bad::3","title":"PACKAGE_DIRECTORY_MATCH","section":"Bad","path":"/docs/guide/cli/linter/rules/package-directory-match#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; }","content":"Bad message Foo { string bar = 1; }"},{"id":"cli/linter/rules/package-directory-match::good::4","title":"PACKAGE_DIRECTORY_MATCH","section":"Good","path":"/docs/guide/cli/linter/rules/package-directory-match#good","headings":["Good"],"excerpt":"Good ```proto // File: bar/foo.proto // [!code focus]","content":"Good ```proto // File: bar/foo.proto // [!code focus]"},{"id":"cli/linter/rules/package-directory-match::good::5","title":"PACKAGE_DIRECTORY_MATCH","section":"Good","path":"/docs/guide/cli/linter/rules/package-directory-match#good","headings":["Good"],"excerpt":"Good package bar; // [!code focus]","content":"Good package bar; // [!code focus]"},{"id":"cli/linter/rules/package-directory-match::good::6","title":"PACKAGE_DIRECTORY_MATCH","section":"Good","path":"/docs/guide/cli/linter/rules/package-directory-match#good","headings":["Good"],"excerpt":"Good message Foo { string bar = 1; } ```","content":"Good message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/package-lower-snake-case::top::0","title":"PACKAGE_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/package-lower-snake-case","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-lower-snake-case::top::1","title":"PACKAGE_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/package-lower-snake-case","headings":[],"excerpt":"This rule checks that package names are in lower_snake_case.","content":"This rule checks that package names are in lower_snake_case."},{"id":"cli/linter/rules/package-lower-snake-case::bad::2","title":"PACKAGE_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: bar/foo.proto syntax = \"proto3\";","content":"Bad ```proto // File: bar/foo.proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-lower-snake-case::good::3","title":"PACKAGE_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/package-lower-snake-case#good","headings":["Good"],"excerpt":"Good ```proto // File: bar/foo.proto syntax = \"proto3\";","content":"Good ```proto // File: bar/foo.proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-lower-snake-case::good::4","title":"PACKAGE_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/package-lower-snake-case#good","headings":["Good"],"excerpt":"Good package foo_bar; // [!code focus] ```","content":"Good package foo_bar; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-csharp-namespace::top::0","title":"PACKAGE_SAME_CSHARP_NAMESPACE","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-csharp-namespace::top::1","title":"PACKAGE_SAME_CSHARP_NAMESPACE","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace","headings":[],"excerpt":"This rule checks that all files with a given package are in the same C# namespace.","content":"This rule checks that all files with a given package are in the same C# namespace."},{"id":"cli/linter/rules/package-same-csharp-namespace::bad::2","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-csharp-namespace::bad::3","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#bad","headings":["Bad"],"excerpt":"Bad option csharp_namespace = \"Foo.Bar\"; ```","content":"Bad option csharp_namespace = \"Foo.Bar\"; ```"},{"id":"cli/linter/rules/package-same-csharp-namespace::bad::4","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-csharp-namespace::bad::5","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#bad","headings":["Bad"],"excerpt":"Bad option csharp_namespace = \"Foo.Baz\"; ```","content":"Bad option csharp_namespace = \"Foo.Baz\"; ```"},{"id":"cli/linter/rules/package-same-csharp-namespace::good::6","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-csharp-namespace::good::7","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#good","headings":["Good"],"excerpt":"Good option csharp_namespace = \"Foo.Bar\"; ```","content":"Good option csharp_namespace = \"Foo.Bar\"; ```"},{"id":"cli/linter/rules/package-same-csharp-namespace::good::8","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#good","headings":["Good"],"excerpt":"Good option csharp_namespace = \"Foo.Bar\"; // [!code focus] ```","content":"Good option csharp_namespace = \"Foo.Bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-directory::top::0","title":"PACKAGE_SAME_DIRECTORY","path":"/docs/guide/cli/linter/rules/package-same-directory","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-directory::top::1","title":"PACKAGE_SAME_DIRECTORY","path":"/docs/guide/cli/linter/rules/package-same-directory","headings":[],"excerpt":"This rule checks that all files with a given package are in the same directory.","content":"This rule checks that all files with a given package are in the same directory."},{"id":"cli/linter/rules/package-same-directory::bad::2","title":"PACKAGE_SAME_DIRECTORY","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-directory#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: bar/foo.proto","content":"Bad ```proto // File: bar/foo.proto"},{"id":"cli/linter/rules/package-same-directory::bad::3","title":"PACKAGE_SAME_DIRECTORY","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-directory#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; }","content":"Bad message Foo { string bar = 1; }"},{"id":"cli/linter/rules/package-same-directory::good::4","title":"PACKAGE_SAME_DIRECTORY","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-directory#good","headings":["Good"],"excerpt":"Good ```proto // File: bar/foo.proto // [!code focus]","content":"Good ```proto // File: bar/foo.proto // [!code focus]"},{"id":"cli/linter/rules/package-same-directory::good::5","title":"PACKAGE_SAME_DIRECTORY","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-directory#good","headings":["Good"],"excerpt":"Good package bar; // [!code focus]","content":"Good package bar; // [!code focus]"},{"id":"cli/linter/rules/package-same-directory::good::6","title":"PACKAGE_SAME_DIRECTORY","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-directory#good","headings":["Good"],"excerpt":"Good message Foo { string bar = 1; }","content":"Good message Foo { string bar = 1; }"},{"id":"cli/linter/rules/package-same-go-package::top::0","title":"PACKAGE_SAME_GO_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-go-package","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-go-package::top::1","title":"PACKAGE_SAME_GO_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-go-package","headings":[],"excerpt":"This rule checks that all files with a given package are in the same Go package.","content":"This rule checks that all files with a given package are in the same Go package."},{"id":"cli/linter/rules/package-same-go-package::bad::2","title":"PACKAGE_SAME_GO_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-go-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-go-package::bad::3","title":"PACKAGE_SAME_GO_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-go-package#bad","headings":["Bad"],"excerpt":"Bad option go_package = \"example.com/foo/bar\";","content":"Bad option go_package = \"example.com/foo/bar\";"},{"id":"cli/linter/rules/package-same-go-package::bad::4","title":"PACKAGE_SAME_GO_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-go-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-go-package::bad::5","title":"PACKAGE_SAME_GO_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-go-package#bad","headings":["Bad"],"excerpt":"Bad option go_package = \"example.com/foo/baz\";","content":"Bad option go_package = \"example.com/foo/baz\";"},{"id":"cli/linter/rules/package-same-go-package::good::6","title":"PACKAGE_SAME_GO_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-go-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-go-package::good::7","title":"PACKAGE_SAME_GO_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-go-package#good","headings":["Good"],"excerpt":"Good option go_package = \"example.com/foo/bar\"; // [!code focus] ```","content":"Good option go_package = \"example.com/foo/bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-go-package::good::8","title":"PACKAGE_SAME_GO_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-go-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-go-package::good::9","title":"PACKAGE_SAME_GO_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-go-package#good","headings":["Good"],"excerpt":"Good option go_package = \"example.com/foo/bar\"; // [!code focus] ```","content":"Good option go_package = \"example.com/foo/bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-java-multiple-files::top::0","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files","headings":[],"excerpt":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","content":"PACKAGE_SAME_JAVA_MULTIPLE_FILES"},{"id":"cli/linter/rules/package-same-java-multiple-files::top::1","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-java-multiple-files::top::2","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files","headings":[],"excerpt":"This rule checks that all files with a given package are in the same Java package.","content":"This rule checks that all files with a given package are in the same Java package."},{"id":"cli/linter/rules/package-same-java-multiple-files::bad::3","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-java-multiple-files::bad::4","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#bad","headings":["Bad"],"excerpt":"Bad option java_package = \"com.example.foo\"; ```","content":"Bad option java_package = \"com.example.foo\"; ```"},{"id":"cli/linter/rules/package-same-java-multiple-files::bad::5","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#bad","headings":["Bad"],"excerpt":"Bad option java_package = \"com.example.bar\"; ```","content":"Bad option java_package = \"com.example.bar\"; ```"},{"id":"cli/linter/rules/package-same-java-multiple-files::good::6","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-java-multiple-files::good::7","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#good","headings":["Good"],"excerpt":"Good option java_package = \"com.example.foo\"; // [!code focus] ```","content":"Good option java_package = \"com.example.foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-java-multiple-files::good::8","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-java-multiple-files::good::9","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#good","headings":["Good"],"excerpt":"Good option java_package = \"com.example.foo\"; // [!code focus] ```","content":"Good option java_package = \"com.example.foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-java-package::top::0","title":"PACKAGE_SAME_JAVA_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-java-package","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-java-package::top::1","title":"PACKAGE_SAME_JAVA_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-java-package","headings":[],"excerpt":"This rule checks that all files with a given package are in the same Java package.","content":"This rule checks that all files with a given package are in the same Java package."},{"id":"cli/linter/rules/package-same-java-package::bad::2","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-java-package::bad::3","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-package#bad","headings":["Bad"],"excerpt":"Bad option java_package = \"com.example.foo\"; ```","content":"Bad option java_package = \"com.example.foo\"; ```"},{"id":"cli/linter/rules/package-same-java-package::bad::4","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-java-package::bad::5","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-package#bad","headings":["Bad"],"excerpt":"Bad option java_package = \"com.example.bar\"; ```","content":"Bad option java_package = \"com.example.bar\"; ```"},{"id":"cli/linter/rules/package-same-java-package::good::6","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-java-package::good::7","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-package#good","headings":["Good"],"excerpt":"Good option java_package = \"com.example.foo\"; // [!code focus] ```","content":"Good option java_package = \"com.example.foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-java-package::good::8","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-java-package::good::9","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-package#good","headings":["Good"],"excerpt":"Good option java_package = \"com.example.foo\"; // [!code focus] ```","content":"Good option java_package = \"com.example.foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-php-namespace::top::0","title":"PACKAGE_SAME_PHP_NAMESPACE","path":"/docs/guide/cli/linter/rules/package-same-php-namespace","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-php-namespace::top::1","title":"PACKAGE_SAME_PHP_NAMESPACE","path":"/docs/guide/cli/linter/rules/package-same-php-namespace","headings":[],"excerpt":"This rule checks that all files with a given package are in the same PHP namespace.","content":"This rule checks that all files with a given package are in the same PHP namespace."},{"id":"cli/linter/rules/package-same-php-namespace::bad::2","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-php-namespace::bad::3","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#bad","headings":["Bad"],"excerpt":"Bad option php_namespace = \"Foo\\\\Bar\";","content":"Bad option php_namespace = \"Foo\\\\Bar\";"},{"id":"cli/linter/rules/package-same-php-namespace::bad::4","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-php-namespace::bad::5","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#bad","headings":["Bad"],"excerpt":"Bad option php_namespace = \"Foo\\\\Baz\"; ```","content":"Bad option php_namespace = \"Foo\\\\Baz\"; ```"},{"id":"cli/linter/rules/package-same-php-namespace::good::6","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-php-namespace::good::7","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#good","headings":["Good"],"excerpt":"Good option php_namespace = \"Foo\\\\Bar\"; // [!code focus] ```","content":"Good option php_namespace = \"Foo\\\\Bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-php-namespace::good::8","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-php-namespace::good::9","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#good","headings":["Good"],"excerpt":"Good option php_namespace = \"Foo\\\\Bar\"; // [!code focus] ```","content":"Good option php_namespace = \"Foo\\\\Bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-ruby-package::top::0","title":"PACKAGE_SAME_RUBY_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-ruby-package","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-ruby-package::top::1","title":"PACKAGE_SAME_RUBY_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-ruby-package","headings":[],"excerpt":"This rule checks that all files with a given package are in the same Ruby package.","content":"This rule checks that all files with a given package are in the same Ruby package."},{"id":"cli/linter/rules/package-same-ruby-package::bad::2","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-ruby-package::bad::3","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#bad","headings":["Bad"],"excerpt":"Bad option ruby_package = \"Foo\"; ```","content":"Bad option ruby_package = \"Foo\"; ```"},{"id":"cli/linter/rules/package-same-ruby-package::bad::4","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-ruby-package::bad::5","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#bad","headings":["Bad"],"excerpt":"Bad option ruby_package = \"Bar\"; ```","content":"Bad option ruby_package = \"Bar\"; ```"},{"id":"cli/linter/rules/package-same-ruby-package::good::6","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-ruby-package::good::7","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#good","headings":["Good"],"excerpt":"Good option ruby_package = \"Foo\"; // [!code focus] ```","content":"Good option ruby_package = \"Foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-ruby-package::good::8","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-ruby-package::good::9","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#good","headings":["Good"],"excerpt":"Good option ruby_package = \"Foo\"; // [!code focus] ```","content":"Good option ruby_package = \"Foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-swift-prefix::top::0","title":"PACKAGE_SAME_SWIFT_PREFIX","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-swift-prefix::top::1","title":"PACKAGE_SAME_SWIFT_PREFIX","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix","headings":[],"excerpt":"This rule checks that all files with a given package are in the same Swift prefix.","content":"This rule checks that all files with a given package are in the same Swift prefix."},{"id":"cli/linter/rules/package-same-swift-prefix::bad::2","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-swift-prefix::bad::3","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#bad","headings":["Bad"],"excerpt":"Bad option swift_prefix = \"Foo\"; ```","content":"Bad option swift_prefix = \"Foo\"; ```"},{"id":"cli/linter/rules/package-same-swift-prefix::bad::4","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-swift-prefix::bad::5","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#bad","headings":["Bad"],"excerpt":"Bad option swift_prefix = \"Bar\"; ```","content":"Bad option swift_prefix = \"Bar\"; ```"},{"id":"cli/linter/rules/package-same-swift-prefix::good::6","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-swift-prefix::good::7","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#good","headings":["Good"],"excerpt":"Good option swift_prefix = \"Foo\"; // [!code focus] ```","content":"Good option swift_prefix = \"Foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-swift-prefix::good::8","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-swift-prefix::good::9","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#good","headings":["Good"],"excerpt":"Good option swift_prefix = \"Foo\"; // [!code focus] ```","content":"Good option swift_prefix = \"Foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-version-suffix::top::0","title":"PACKAGE_VERSION_SUFFIX","path":"/docs/guide/cli/linter/rules/package-version-suffix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-version-suffix::top::1","title":"PACKAGE_VERSION_SUFFIX","path":"/docs/guide/cli/linter/rules/package-version-suffix","headings":[],"excerpt":"This rule checks that the package version suffix is _vX where X is a number of version.","content":"This rule checks that the package version suffix is _vX where X is a number of version."},{"id":"cli/linter/rules/package-version-suffix::bad::2","title":"PACKAGE_VERSION_SUFFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-version-suffix#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-version-suffix::good::3","title":"PACKAGE_VERSION_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-version-suffix#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-version-suffix::good::4","title":"PACKAGE_VERSION_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-version-suffix#good","headings":["Good"],"excerpt":"Good package foo.v1; // [!code focus] ```","content":"Good package foo.v1; // [!code focus] ```"},{"id":"cli/linter/rules/rpc-no-client-streaming::top::0","title":"RPC_NO_CLIENT_STREAMING","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming","headings":[],"excerpt":"This rule checks that rpc has no client streaming.","content":"This rule checks that rpc has no client streaming."},{"id":"cli/linter/rules/rpc-no-client-streaming::bad::1","title":"RPC_NO_CLIENT_STREAMING","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-no-client-streaming::bad::2","title":"RPC_NO_CLIENT_STREAMING","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar (stream BarRequest) returns (BarResponse) {} } ```","content":"Bad service Foo { rpc Bar (stream BarRequest) returns (BarResponse) {} } ```"},{"id":"cli/linter/rules/rpc-no-client-streaming::good::3","title":"RPC_NO_CLIENT_STREAMING","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-no-client-streaming::good::4","title":"RPC_NO_CLIENT_STREAMING","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming#good","headings":["Good"],"excerpt":"Good service Foo { rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-no-server-streaming::top::0","title":"RPC_NO_SERVER_STREAMING","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming","headings":[],"excerpt":"This rule checks that rpc has no server streaming.","content":"This rule checks that rpc has no server streaming."},{"id":"cli/linter/rules/rpc-no-server-streaming::bad::1","title":"RPC_NO_SERVER_STREAMING","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-no-server-streaming::bad::2","title":"RPC_NO_SERVER_STREAMING","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar (BarRequest) returns (stream BarResponse) {} } ```","content":"Bad service Foo { rpc Bar (BarRequest) returns (stream BarResponse) {} } ```"},{"id":"cli/linter/rules/rpc-no-server-streaming::good::3","title":"RPC_NO_SERVER_STREAMING","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-no-server-streaming::good::4","title":"RPC_NO_SERVER_STREAMING","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming#good","headings":["Good"],"excerpt":"Good service Foo { rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-pascal-case::top::0","title":"RPC_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/rpc-pascal-case","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/rpc-pascal-case::top::1","title":"RPC_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/rpc-pascal-case","headings":[],"excerpt":"This rule checks that all RPC names are in PascalCase.","content":"This rule checks that all RPC names are in PascalCase."},{"id":"cli/linter/rules/rpc-pascal-case::bad::2","title":"RPC_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-pascal-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-pascal-case::bad::3","title":"RPC_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-pascal-case#bad","headings":["Bad"],"excerpt":"Bad service foo_bar { rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {} } ```","content":"Bad service foo_bar { rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {} } ```"},{"id":"cli/linter/rules/rpc-pascal-case::good::4","title":"RPC_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-pascal-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-pascal-case::good::5","title":"RPC_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-pascal-case#good","headings":["Good"],"excerpt":"Good service FooBar { rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} // [!code focus] } ```","content":"Good service FooBar { rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-request-response-unique::top::0","title":"RPC_REQUEST_RESPONSE_UNIQUE","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/rpc-request-response-unique::top::1","title":"RPC_REQUEST_RESPONSE_UNIQUE","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique","headings":[],"excerpt":"This rule checks that all RPC request and response messages are unique.","content":"This rule checks that all RPC request and response messages are unique."},{"id":"cli/linter/rules/rpc-request-response-unique::bad::2","title":"RPC_REQUEST_RESPONSE_UNIQUE","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-request-response-unique::bad::3","title":"RPC_REQUEST_RESPONSE_UNIQUE","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} rpc GetBar (FooRequest) returns (FooResponse) {} } ```","content":"Bad service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} rpc GetBar (FooRequest) returns (FooResponse) {} } ```"},{"id":"cli/linter/rules/rpc-request-response-unique::good::4","title":"RPC_REQUEST_RESPONSE_UNIQUE","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-request-response-unique::good::5","title":"RPC_REQUEST_RESPONSE_UNIQUE","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique#good","headings":["Good"],"excerpt":"Good service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} // [!code focus] rpc GetBar (BarRequest) returns (BarResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} // [!code focus] rpc GetBar (BarRequest) returns (BarResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-request-standard-name::top::0","title":"RPC_REQUEST_STANDARD_NAME","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/rpc-request-standard-name::top::1","title":"RPC_REQUEST_STANDARD_NAME","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name","headings":[],"excerpt":"This rule checks that all RPC request messages are named MethodRequest.","content":"This rule checks that all RPC request messages are named MethodRequest."},{"id":"cli/linter/rules/rpc-request-standard-name::bad::2","title":"RPC_REQUEST_STANDARD_NAME","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-request-standard-name::bad::3","title":"RPC_REQUEST_STANDARD_NAME","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} } ```","content":"Bad service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} } ```"},{"id":"cli/linter/rules/rpc-request-standard-name::good::4","title":"RPC_REQUEST_STANDARD_NAME","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-request-standard-name::good::5","title":"RPC_REQUEST_STANDARD_NAME","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name#good","headings":["Good"],"excerpt":"Good service Foo { rpc GetFoo (GetFooRequest) returns (FooResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc GetFoo (GetFooRequest) returns (FooResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-response-standard-name::top::0","title":"RPC_RESPONSE_STANDARD_NAME","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/rpc-response-standard-name::top::1","title":"RPC_RESPONSE_STANDARD_NAME","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name","headings":[],"excerpt":"This rule checks that all RPC response messages are named MethodResponse.","content":"This rule checks that all RPC response messages are named MethodResponse."},{"id":"cli/linter/rules/rpc-response-standard-name::bad::2","title":"RPC_RESPONSE_STANDARD_NAME","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-response-standard-name::bad::3","title":"RPC_RESPONSE_STANDARD_NAME","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc GetFoo (GetFooRequest) returns (Foo) {} } ```","content":"Bad service Foo { rpc GetFoo (GetFooRequest) returns (Foo) {} } ```"},{"id":"cli/linter/rules/rpc-response-standard-name::good::4","title":"RPC_RESPONSE_STANDARD_NAME","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-response-standard-name::good::5","title":"RPC_RESPONSE_STANDARD_NAME","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name#good","headings":["Good"],"excerpt":"Good service Foo { rpc GetFoo (GetFooRequest) returns (GetFooResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc GetFoo (GetFooRequest) returns (GetFooResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/service-pascal-case::top::0","title":"SERVICE_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/service-pascal-case","headings":[],"excerpt":"Categories: **MINIMAL** **BASIC** **DEFAULT**","content":"Categories: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/service-pascal-case::top::1","title":"SERVICE_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/service-pascal-case","headings":[],"excerpt":"This rule checks that all service names are in PascalCase.","content":"This rule checks that all service names are in PascalCase."},{"id":"cli/linter/rules/service-pascal-case::bad::2","title":"SERVICE_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/service-pascal-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/service-pascal-case::bad::3","title":"SERVICE_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/service-pascal-case#bad","headings":["Bad"],"excerpt":"Bad service foo_bar { rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {} } ```","content":"Bad service foo_bar { rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {} } ```"},{"id":"cli/linter/rules/service-pascal-case::good::4","title":"SERVICE_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/service-pascal-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/service-pascal-case::good::5","title":"SERVICE_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/service-pascal-case#good","headings":["Good"],"excerpt":"Good service FooBar { // [!code focus] rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} } ```","content":"Good service FooBar { // [!code focus] rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} } ```"},{"id":"cli/linter/rules/service-suffix::top::0","title":"SERVICE_SUFFIX","path":"/docs/guide/cli/linter/rules/service-suffix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/service-suffix::top::1","title":"SERVICE_SUFFIX","path":"/docs/guide/cli/linter/rules/service-suffix","headings":[],"excerpt":"This rule checks that all services are suffixed with Service or your custom suffix.","content":"This rule checks that all services are suffixed with Service or your custom suffix."},{"id":"cli/linter/rules/service-suffix::bad::2","title":"SERVICE_SUFFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/service-suffix#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/service-suffix::bad::3","title":"SERVICE_SUFFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/service-suffix#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar(BarRequest) returns (BarResponse); } ```","content":"Bad service Foo { rpc Bar(BarRequest) returns (BarResponse); } ```"},{"id":"cli/linter/rules/service-suffix::good::4","title":"SERVICE_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/service-suffix#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/service-suffix::good::5","title":"SERVICE_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/service-suffix#good","headings":["Good"],"excerpt":"Good service FooService { // [!code focus] rpc Bar(BarRequest) returns (BarResponse); } ```","content":"Good service FooService { // [!code focus] rpc Bar(BarRequest) returns (BarResponse); } ```"},{"id":"cli/package-manager/easyp-vs-buf::top::0","title":"EasyP vs Buf Package Management","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":[],"excerpt":"EasyP vs Buf Package Management","content":"EasyP vs Buf Package Management"},{"id":"cli/package-manager/easyp-vs-buf::top::1","title":"EasyP vs Buf Package Management","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":[],"excerpt":"This document provides a comprehensive comparison between EasyP's decentralized package management approach and Buf's centralized Buf Schema Registry (BSR) model, helping you understand the key differences and choose the","content":"This document provides a comprehensive comparison between EasyP's decentralized package management approach and Buf's centralized Buf Schema Registry (BSR) model, helping you understand the key differences and choose the right solution for your needs."},{"id":"cli/package-manager/easyp-vs-buf::easyp-decentralized-git-based-approach::2","title":"EasyP vs Buf Package Management","section":"EasyP: Decentralized Git-Based Approach","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-decentralized-git-based-approach","headings":["EasyP: Decentralized Git-Based Approach"],"excerpt":"EasyP: Decentralized Git-Based Approach","content":"EasyP: Decentralized Git-Based Approach"},{"id":"cli/package-manager/easyp-vs-buf::buf-centralized-registry-approach::3","title":"EasyP vs Buf Package Management","section":"Buf: Centralized Registry Approach","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-centralized-registry-approach","headings":["Buf: Centralized Registry Approach"],"excerpt":"Buf: Centralized Registry Approach","content":"Buf: Centralized Registry Approach"},{"id":"cli/package-manager/easyp-vs-buf::key-differences-summary::4","title":"EasyP vs Buf Package Management","section":"Key Differences Summary","path":"/docs/guide/cli/package-manager/easyp-vs-buf#key-differences-summary","headings":["Key Differences Summary"],"excerpt":"Key Differences Summary Aspect EasyP Buf -------- ------- ----- **Architecture** Decentralized (Git-based) Centralized (BSR registry) **Dependency Source** Any Git repository Buf Schema Registry only **Single Point of Fa","content":"Key Differences Summary Aspect EasyP Buf -------- ------- ----- **Architecture** Decentralized (Git-based) Centralized (BSR registry) **Dependency Source** Any Git repository Buf Schema Registry only **Single Point of Failure** No Yes (buf.build) **Enterprise Deployment** Fully air-gapped support Requires BSR access or private BSR **Authentication** Git credentials (SSH/HTTPS) Buf tokens + Git credentials **Vendor Lock-in** None Buf ecosystem **Private Repositories** Native Git support Must publish to BSR first **Offline Support** Full (via vendoring) Limited (cached modules only) **Cost** Free (uses existing Git) Free tier + paid plans **Setup Complexity** Minimal Moderate (BSR setup)"},{"id":"cli/package-manager/easyp-vs-buf::1-dependency-management-philosophy::5","title":"EasyP vs Buf Package Management","section":"1. Dependency Management Philosophy","path":"/docs/guide/cli/package-manager/easyp-vs-buf#1-dependency-management-philosophy","headings":["1. Dependency Management Philosophy"],"excerpt":"Dependency Management Philosophy","content":"Dependency Management Philosophy"},{"id":"cli/package-manager/easyp-vs-buf::easyp-any-git-repository-is-a-package::6","title":"EasyP vs Buf Package Management","section":"EasyP: \"Any Git Repository is a Package\"","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-any-git-repository-is-a-package","headings":["EasyP: \"Any Git Repository is a Package\""],"excerpt":"EasyP: \"Any Git Repository is a Package\"","content":"EasyP: \"Any Git Repository is a Package\""},{"id":"cli/package-manager/easyp-vs-buf::easyp-any-git-repository-is-a-package::7","title":"EasyP vs Buf Package Management","section":"EasyP: \"Any Git Repository is a Package\"","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-any-git-repository-is-a-package","headings":["EasyP: \"Any Git Repository is a Package\""],"excerpt":"EasyP: \"Any Git Repository is a Package\" **Advantages:** ✅ Use any existing Git repository immediately ✅ No need to \"publish\" to a separate registry ✅ Version control is the source of truth ✅ Works with private Git serve","content":"EasyP: \"Any Git Repository is a Package\" **Advantages:** ✅ Use any existing Git repository immediately ✅ No need to \"publish\" to a separate registry ✅ Version control is the source of truth ✅ Works with private Git servers out-of-the-box"},{"id":"cli/package-manager/easyp-vs-buf::buf-registry-first-approach::8","title":"EasyP vs Buf Package Management","section":"Buf: \"Registry-First Approach\"","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-registry-first-approach","headings":["Buf: \"Registry-First Approach\""],"excerpt":"Buf: \"Registry-First Approach\"","content":"Buf: \"Registry-First Approach\""},{"id":"cli/package-manager/easyp-vs-buf::buf-registry-first-approach::9","title":"EasyP vs Buf Package Management","section":"Buf: \"Registry-First Approach\"","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-registry-first-approach","headings":["Buf: \"Registry-First Approach\""],"excerpt":"Buf: \"Registry-First Approach\" **Advantages:** ✅ Curated, high-quality modules ✅ Rich metadata and documentation ✅ Dependency graph visualization ✅ Semantic versioning enforcement","content":"Buf: \"Registry-First Approach\" **Advantages:** ✅ Curated, high-quality modules ✅ Rich metadata and documentation ✅ Dependency graph visualization ✅ Semantic versioning enforcement"},{"id":"cli/package-manager/easyp-vs-buf::buf-registry-first-approach::10","title":"EasyP vs Buf Package Management","section":"Buf: \"Registry-First Approach\"","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-registry-first-approach","headings":["Buf: \"Registry-First Approach\""],"excerpt":"Buf: \"Registry-First Approach\" **Limitations:** ❌ Must publish to BSR before use ❌ Requires BSR account and authentication ❌ Cannot reference arbitrary Git repositories directly","content":"Buf: \"Registry-First Approach\" **Limitations:** ❌ Must publish to BSR before use ❌ Requires BSR account and authentication ❌ Cannot reference arbitrary Git repositories directly"},{"id":"cli/package-manager/easyp-vs-buf::2-enterprise-and-air-gapped-environments::11","title":"EasyP vs Buf Package Management","section":"2. Enterprise and Air-Gapped Environments","path":"/docs/guide/cli/package-manager/easyp-vs-buf#2-enterprise-and-air-gapped-environments","headings":["2. Enterprise and Air-Gapped Environments"],"excerpt":"Enterprise and Air-Gapped Environments","content":"Enterprise and Air-Gapped Environments"},{"id":"cli/package-manager/easyp-vs-buf::easyp-full-air-gap-support::12","title":"EasyP vs Buf Package Management","section":"EasyP: Full Air-Gap Support","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-full-air-gap-support","headings":["EasyP: Full Air-Gap Support"],"excerpt":"EasyP: Full Air-Gap Support **Scenario**: Large enterprise with strict network policies","content":"EasyP: Full Air-Gap Support **Scenario**: Large enterprise with strict network policies"},{"id":"cli/package-manager/easyp-vs-buf::easyp-full-air-gap-support::13","title":"EasyP vs Buf Package Management","section":"EasyP: Full Air-Gap Support","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-full-air-gap-support","headings":["EasyP: Full Air-Gap Support"],"excerpt":"EasyP: Full Air-Gap Support ```bash Initial setup (with internet) easyp mod download # Downloads to ~/.easyp/ easyp mod vendor # Creates easyp_vendor/","content":"EasyP: Full Air-Gap Support ```bash Initial setup (with internet) easyp mod download # Downloads to ~/.easyp/ easyp mod vendor # Creates easyp_vendor/"},{"id":"cli/package-manager/easyp-vs-buf::easyp-full-air-gap-support::14","title":"EasyP vs Buf Package Management","section":"EasyP: Full Air-Gap Support","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-full-air-gap-support","headings":["EasyP: Full Air-Gap Support"],"excerpt":"EasyP: Full Air-Gap Support Transfer to air-gapped environment tar -czf easyp-deps.tar.gz ~/.easyp easyp_vendor/ ... transfer archive ...","content":"EasyP: Full Air-Gap Support Transfer to air-gapped environment tar -czf easyp-deps.tar.gz ~/.easyp easyp_vendor/ ... transfer archive ..."},{"id":"cli/package-manager/easyp-vs-buf::easyp-full-air-gap-support::15","title":"EasyP vs Buf Package Management","section":"EasyP: Full Air-Gap Support","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-full-air-gap-support","headings":["EasyP: Full Air-Gap Support"],"excerpt":"EasyP: Full Air-Gap Support Air-gapped environment (no internet) tar -xzf easyp-deps.tar.gz export EASYPPATH=$PWD/.easyp easyp generate # Works offline ```","content":"EasyP: Full Air-Gap Support Air-gapped environment (no internet) tar -xzf easyp-deps.tar.gz export EASYPPATH=$PWD/.easyp easyp generate # Works offline ```"},{"id":"cli/package-manager/easyp-vs-buf::easyp-full-air-gap-support::16","title":"EasyP vs Buf Package Management","section":"EasyP: Full Air-Gap Support","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-full-air-gap-support","headings":["EasyP: Full Air-Gap Support"],"excerpt":"EasyP: Full Air-Gap Support **Benefits:** ✅ Complete independence from external services ✅ No need for internal registry infrastructure ✅ Uses existing Git infrastructure ✅ Simple file-based distribution","content":"EasyP: Full Air-Gap Support **Benefits:** ✅ Complete independence from external services ✅ No need for internal registry infrastructure ✅ Uses existing Git infrastructure ✅ Simple file-based distribution"},{"id":"cli/package-manager/easyp-vs-buf::buf-requires-bsr-infrastructure::17","title":"EasyP vs Buf Package Management","section":"Buf: Requires BSR Infrastructure","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-requires-bsr-infrastructure","headings":["Buf: Requires BSR Infrastructure"],"excerpt":"Buf: Requires BSR Infrastructure **Scenario**: Same enterprise setup","content":"Buf: Requires BSR Infrastructure **Scenario**: Same enterprise setup"},{"id":"cli/package-manager/easyp-vs-buf::buf-requires-bsr-infrastructure::18","title":"EasyP vs Buf Package Management","section":"Buf: Requires BSR Infrastructure","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-requires-bsr-infrastructure","headings":["Buf: Requires BSR Infrastructure"],"excerpt":"Buf: Requires BSR Infrastructure ```bash Option 1: Use buf.build (requires internet) buf mod download # Must reach buf.build","content":"Buf: Requires BSR Infrastructure ```bash Option 1: Use buf.build (requires internet) buf mod download # Must reach buf.build"},{"id":"cli/package-manager/easyp-vs-buf::buf-requires-bsr-infrastructure::19","title":"EasyP vs Buf Package Management","section":"Buf: Requires BSR Infrastructure","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-requires-bsr-infrastructure","headings":["Buf: Requires BSR Infrastructure"],"excerpt":"Buf: Requires BSR Infrastructure Option 2: Set up private BSR (complex) Deploy BSR server infrastructure Migrate all modules to private BSR Configure authentication and access Maintain registry server ```","content":"Buf: Requires BSR Infrastructure Option 2: Set up private BSR (complex) Deploy BSR server infrastructure Migrate all modules to private BSR Configure authentication and access Maintain registry server ```"},{"id":"cli/package-manager/easyp-vs-buf::buf-requires-bsr-infrastructure::20","title":"EasyP vs Buf Package Management","section":"Buf: Requires BSR Infrastructure","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-requires-bsr-infrastructure","headings":["Buf: Requires BSR Infrastructure"],"excerpt":"Buf: Requires BSR Infrastructure **Challenges:** ❌ Requires constant internet access OR expensive private BSR ❌ Complex infrastructure for private deployments ❌ All modules must be re-published to private registry ❌ Addi","content":"Buf: Requires BSR Infrastructure **Challenges:** ❌ Requires constant internet access OR expensive private BSR ❌ Complex infrastructure for private deployments ❌ All modules must be re-published to private registry ❌ Additional operational overhead"},{"id":"cli/package-manager/easyp-vs-buf::easyp-direct-control::21","title":"EasyP vs Buf Package Management","section":"EasyP: Direct Control","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-direct-control","headings":["EasyP: Direct Control"],"excerpt":"EasyP: Direct Control ```yaml Full control over dependency sources deps: # Public repository - your choice of version - github.com/googleapis/googleapis@common-protos-1_3_1","content":"EasyP: Direct Control ```yaml Full control over dependency sources deps: # Public repository - your choice of version - github.com/googleapis/googleapis@common-protos-1_3_1"},{"id":"cli/package-manager/easyp-vs-buf::easyp-direct-control::22","title":"EasyP vs Buf Package Management","section":"EasyP: Direct Control","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-direct-control","headings":["EasyP: Direct Control"],"excerpt":"EasyP: Direct Control Internal repository - complete control - gitlab.company.com/security/validated-protos@v1.0.0","content":"EasyP: Direct Control Internal repository - complete control - gitlab.company.com/security/validated-protos@v1.0.0"},{"id":"cli/package-manager/easyp-vs-buf::easyp-direct-control::23","title":"EasyP vs Buf Package Management","section":"EasyP: Direct Control","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-direct-control","headings":["EasyP: Direct Control"],"excerpt":"EasyP: Direct Control Specific commit for security fix - github.com/bufbuild/protoc-gen-validate@abc123def456 ```","content":"EasyP: Direct Control Specific commit for security fix - github.com/bufbuild/protoc-gen-validate@abc123def456 ```"},{"id":"cli/package-manager/easyp-vs-buf::easyp-direct-control::24","title":"EasyP vs Buf Package Management","section":"EasyP: Direct Control","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-direct-control","headings":["EasyP: Direct Control"],"excerpt":"EasyP: Direct Control **Security advantages:** ✅ **No intermediary** - direct from source repository ✅ **Audit trail** - Git commit history is the source of truth ✅ **Cannot be \"banned\"** - no external party can revoke a","content":"EasyP: Direct Control **Security advantages:** ✅ **No intermediary** - direct from source repository ✅ **Audit trail** - Git commit history is the source of truth ✅ **Cannot be \"banned\"** - no external party can revoke access ✅ **Custom validation** - implement your own security scanning ✅ **Fork protection** - easily fork and maintain dependencies"},{"id":"cli/package-manager/easyp-vs-buf::buf-registry-dependency::25","title":"EasyP vs Buf Package Management","section":"Buf: Registry Dependency","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-registry-dependency","headings":["Buf: Registry Dependency"],"excerpt":"Buf: Registry Dependency **Security considerations:** ⚠️ **Intermediary risk** - BSR controls what's available ⚠️ **Account suspension** - Could lose access to dependencies ⚠️ **Module removal** - Modules can be deleted ","content":"Buf: Registry Dependency **Security considerations:** ⚠️ **Intermediary risk** - BSR controls what's available ⚠️ **Account suspension** - Could lose access to dependencies ⚠️ **Module removal** - Modules can be deleted from registry ⚠️ **Update policies** - BSR may force updates or deprecations ⚠️ **Third-party trust** - Must trust Buf's security practices"},{"id":"cli/package-manager/easyp-vs-buf::scenario-1-startup-with-public-dependencies::26","title":"EasyP vs Buf Package Management","section":"Scenario 1: Startup with Public Dependencies","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-1-startup-with-public-dependencies","headings":["Scenario 1: Startup with Public Dependencies"],"excerpt":"Scenario 1: Startup with Public Dependencies **EasyP Approach:**","content":"Scenario 1: Startup with Public Dependencies **EasyP Approach:**"},{"id":"cli/package-manager/easyp-vs-buf::scenario-1-startup-with-public-dependencies::27","title":"EasyP vs Buf Package Management","section":"Scenario 1: Startup with Public Dependencies","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-1-startup-with-public-dependencies","headings":["Scenario 1: Startup with Public Dependencies"],"excerpt":"Scenario 1: Startup with Public Dependencies **Buf Approach:**","content":"Scenario 1: Startup with Public Dependencies **Buf Approach:**"},{"id":"cli/package-manager/easyp-vs-buf::scenario-1-startup-with-public-dependencies::28","title":"EasyP vs Buf Package Management","section":"Scenario 1: Startup with Public Dependencies","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-1-startup-with-public-dependencies","headings":["Scenario 1: Startup with Public Dependencies"],"excerpt":"Scenario 1: Startup with Public Dependencies **Winner**: Tie - both work well for public dependencies","content":"Scenario 1: Startup with Public Dependencies **Winner**: Tie - both work well for public dependencies"},{"id":"cli/package-manager/easyp-vs-buf::scenario-2-enterprise-with-mixed-publicprivate-dependencies::29","title":"EasyP vs Buf Package Management","section":"Scenario 2: Enterprise with Mixed Public/Private Dependencies","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-2-enterprise-with-mixed-publicprivate-dependencies","headings":["Scenario 2: Enterprise with Mixed Public/Private Dependencies"],"excerpt":"Scenario 2: Enterprise with Mixed Public/Private Dependencies **EasyP Approach:** ```yaml deps: # Public - github.com/googleapis/googleapis@v1.2.3","content":"Scenario 2: Enterprise with Mixed Public/Private Dependencies **EasyP Approach:** ```yaml deps: # Public - github.com/googleapis/googleapis@v1.2.3"},{"id":"cli/package-manager/easyp-vs-buf::scenario-2-enterprise-with-mixed-publicprivate-dependencies::30","title":"EasyP vs Buf Package Management","section":"Scenario 2: Enterprise with Mixed Public/Private Dependencies","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-2-enterprise-with-mixed-publicprivate-dependencies","headings":["Scenario 2: Enterprise with Mixed Public/Private Dependencies"],"excerpt":"Scenario 2: Enterprise with Mixed Public/Private Dependencies Private (existing Git repos) - github.com/mycompany/auth-protos@v2.0.0 - gitlab.enterprise.com/platform/shared-types@v1.5.1 ```","content":"Scenario 2: Enterprise with Mixed Public/Private Dependencies Private (existing Git repos) - github.com/mycompany/auth-protos@v2.0.0 - gitlab.enterprise.com/platform/shared-types@v1.5.1 ```"},{"id":"cli/package-manager/easyp-vs-buf::scenario-2-enterprise-with-mixed-publicprivate-dependencies::31","title":"EasyP vs Buf Package Management","section":"Scenario 2: Enterprise with Mixed Public/Private Dependencies","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-2-enterprise-with-mixed-publicprivate-dependencies","headings":["Scenario 2: Enterprise with Mixed Public/Private Dependencies"],"excerpt":"Scenario 2: Enterprise with Mixed Public/Private Dependencies **Buf Approach:**","content":"Scenario 2: Enterprise with Mixed Public/Private Dependencies **Buf Approach:**"},{"id":"cli/package-manager/easyp-vs-buf::scenario-2-enterprise-with-mixed-publicprivate-dependencies::32","title":"EasyP vs Buf Package Management","section":"Scenario 2: Enterprise with Mixed Public/Private Dependencies","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-2-enterprise-with-mixed-publicprivate-dependencies","headings":["Scenario 2: Enterprise with Mixed Public/Private Dependencies"],"excerpt":"Scenario 2: Enterprise with Mixed Public/Private Dependencies **Winner**: **EasyP** - no additional setup for private repos","content":"Scenario 2: Enterprise with Mixed Public/Private Dependencies **Winner**: **EasyP** - no additional setup for private repos"},{"id":"cli/package-manager/easyp-vs-buf::scenario-3-governmentdefense-contractor-air-gapped::33","title":"EasyP vs Buf Package Management","section":"Scenario 3: Government/Defense Contractor (Air-Gapped)","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-3-governmentdefense-contractor-air-gapped","headings":["Scenario 3: Government/Defense Contractor (Air-Gapped)"],"excerpt":"Scenario 3: Government/Defense Contractor (Air-Gapped) **EasyP Approach:** ```bash Internet-connected environment easyp mod vendor","content":"Scenario 3: Government/Defense Contractor (Air-Gapped) **EasyP Approach:** ```bash Internet-connected environment easyp mod vendor"},{"id":"cli/package-manager/easyp-vs-buf::scenario-3-governmentdefense-contractor-air-gapped::34","title":"EasyP vs Buf Package Management","section":"Scenario 3: Government/Defense Contractor (Air-Gapped)","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-3-governmentdefense-contractor-air-gapped","headings":["Scenario 3: Government/Defense Contractor (Air-Gapped)"],"excerpt":"Scenario 3: Government/Defense Contractor (Air-Gapped) Transfer to classified environment Works immediately without any external dependencies ```","content":"Scenario 3: Government/Defense Contractor (Air-Gapped) Transfer to classified environment Works immediately without any external dependencies ```"},{"id":"cli/package-manager/easyp-vs-buf::scenario-3-governmentdefense-contractor-air-gapped::35","title":"EasyP vs Buf Package Management","section":"Scenario 3: Government/Defense Contractor (Air-Gapped)","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-3-governmentdefense-contractor-air-gapped","headings":["Scenario 3: Government/Defense Contractor (Air-Gapped)"],"excerpt":"Scenario 3: Government/Defense Contractor (Air-Gapped) **Buf Approach:**","content":"Scenario 3: Government/Defense Contractor (Air-Gapped) **Buf Approach:**"},{"id":"cli/package-manager/easyp-vs-buf::scenario-3-governmentdefense-contractor-air-gapped::36","title":"EasyP vs Buf Package Management","section":"Scenario 3: Government/Defense Contractor (Air-Gapped)","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-3-governmentdefense-contractor-air-gapped","headings":["Scenario 3: Government/Defense Contractor (Air-Gapped)"],"excerpt":"Scenario 3: Government/Defense Contractor (Air-Gapped) **Winner**: **EasyP** - significantly simpler air-gap deployment","content":"Scenario 3: Government/Defense Contractor (Air-Gapped) **Winner**: **EasyP** - significantly simpler air-gap deployment"},{"id":"cli/package-manager/easyp-vs-buf::scenario-4-compliance-and-auditing::37","title":"EasyP vs Buf Package Management","section":"Scenario 4: Compliance and Auditing","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-4-compliance-and-auditing","headings":["Scenario 4: Compliance and Auditing"],"excerpt":"Scenario 4: Compliance and Auditing **EasyP Approach:** ✅ **Direct audit trail**: Git commits show exact changes ✅ **Compliance-friendly**: No external dependencies in production ✅ **Reproducible**: Lock files pin exact ","content":"Scenario 4: Compliance and Auditing **EasyP Approach:** ✅ **Direct audit trail**: Git commits show exact changes ✅ **Compliance-friendly**: No external dependencies in production ✅ **Reproducible**: Lock files pin exact Git commits ✅ **Vulnerability management**: Direct control over security updates"},{"id":"cli/package-manager/easyp-vs-buf::scenario-4-compliance-and-auditing::38","title":"EasyP vs Buf Package Management","section":"Scenario 4: Compliance and Auditing","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-4-compliance-and-auditing","headings":["Scenario 4: Compliance and Auditing"],"excerpt":"Scenario 4: Compliance and Auditing **Buf Approach:** ⚠️ **Registry dependency**: Must audit BSR's security practices ⚠️ **Third-party risk**: BSR is part of your compliance scope ⚠️ **Limited control**: Cannot control w","content":"Scenario 4: Compliance and Auditing **Buf Approach:** ⚠️ **Registry dependency**: Must audit BSR's security practices ⚠️ **Third-party risk**: BSR is part of your compliance scope ⚠️ **Limited control**: Cannot control when modules are updated/removed ⚠️ **Audit complexity**: Must trace registry → Git → actual code"},{"id":"cli/package-manager/easyp-vs-buf::scenario-4-compliance-and-auditing::39","title":"EasyP vs Buf Package Management","section":"Scenario 4: Compliance and Auditing","path":"/docs/guide/cli/package-manager/easyp-vs-buf#scenario-4-compliance-and-auditing","headings":["Scenario 4: Compliance and Auditing"],"excerpt":"Scenario 4: Compliance and Auditing **Winner**: **EasyP** - cleaner compliance story","content":"Scenario 4: Compliance and Auditing **Winner**: **EasyP** - cleaner compliance story"},{"id":"cli/package-manager/easyp-vs-buf::easyp-zero-additional-infrastructure::40","title":"EasyP vs Buf Package Management","section":"EasyP: Zero Additional Infrastructure","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-zero-additional-infrastructure","headings":["EasyP: Zero Additional Infrastructure"],"excerpt":"EasyP: Zero Additional Infrastructure **Costs:** ✅ **$0** - Uses existing Git infrastructure ✅ **No additional servers** to maintain ✅ **No licensing fees** for registry software ✅ **Scales with Git** - proven enterprise","content":"EasyP: Zero Additional Infrastructure **Costs:** ✅ **$0** - Uses existing Git infrastructure ✅ **No additional servers** to maintain ✅ **No licensing fees** for registry software ✅ **Scales with Git** - proven enterprise scalability"},{"id":"cli/package-manager/easyp-vs-buf::easyp-zero-additional-infrastructure::41","title":"EasyP vs Buf Package Management","section":"EasyP: Zero Additional Infrastructure","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-zero-additional-infrastructure","headings":["EasyP: Zero Additional Infrastructure"],"excerpt":"EasyP: Zero Additional Infrastructure **Infrastructure:** Uses existing Git repositories (GitHub, GitLab, etc.) Leverages existing authentication systems No additional backup/disaster recovery needed","content":"EasyP: Zero Additional Infrastructure **Infrastructure:** Uses existing Git repositories (GitHub, GitLab, etc.) Leverages existing authentication systems No additional backup/disaster recovery needed"},{"id":"cli/package-manager/easyp-vs-buf::buf-registry-infrastructure-costs::42","title":"EasyP vs Buf Package Management","section":"Buf: Registry Infrastructure Costs","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-registry-infrastructure-costs","headings":["Buf: Registry Infrastructure Costs"],"excerpt":"Buf: Registry Infrastructure Costs **BSR Hosted (buf.build):** ✅ Free tier available ❌ Paid plans for private modules and teams ❌ Subject to external pricing changes ❌ Data locality concerns for some enterprises","content":"Buf: Registry Infrastructure Costs **BSR Hosted (buf.build):** ✅ Free tier available ❌ Paid plans for private modules and teams ❌ Subject to external pricing changes ❌ Data locality concerns for some enterprises"},{"id":"cli/package-manager/easyp-vs-buf::buf-registry-infrastructure-costs::43","title":"EasyP vs Buf Package Management","section":"Buf: Registry Infrastructure Costs","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-registry-infrastructure-costs","headings":["Buf: Registry Infrastructure Costs"],"excerpt":"Buf: Registry Infrastructure Costs **Private BSR Deployment:** ❌ Significant infrastructure costs (servers, databases, load balancers) ❌ Operational overhead (monitoring, updates, backups) ❌ Licensing costs for enterpris","content":"Buf: Registry Infrastructure Costs **Private BSR Deployment:** ❌ Significant infrastructure costs (servers, databases, load balancers) ❌ Operational overhead (monitoring, updates, backups) ❌ Licensing costs for enterprise features ❌ Additional disaster recovery planning"},{"id":"cli/package-manager/easyp-vs-buf::easyp-no-lock-in::44","title":"EasyP vs Buf Package Management","section":"EasyP: No Lock-in","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-no-lock-in","headings":["EasyP: No Lock-in"],"excerpt":"EasyP: No Lock-in **Migration FROM EasyP:**","content":"EasyP: No Lock-in **Migration FROM EasyP:**"},{"id":"cli/package-manager/easyp-vs-buf::easyp-no-lock-in::45","title":"EasyP vs Buf Package Management","section":"EasyP: No Lock-in","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-no-lock-in","headings":["EasyP: No Lock-in"],"excerpt":"EasyP: No Lock-in **Migration TO EasyP:**","content":"EasyP: No Lock-in **Migration TO EasyP:**"},{"id":"cli/package-manager/easyp-vs-buf::buf-potential-lock-in::46","title":"EasyP vs Buf Package Management","section":"Buf: Potential Lock-in","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-potential-lock-in","headings":["Buf: Potential Lock-in"],"excerpt":"Buf: Potential Lock-in **Migration FROM Buf:** ❌ Must identify original Git repositories for each BSR module ❌ BSR-specific module names don't translate directly ❌ May lose version history and metadata ❌ Complex if heavi","content":"Buf: Potential Lock-in **Migration FROM Buf:** ❌ Must identify original Git repositories for each BSR module ❌ BSR-specific module names don't translate directly ❌ May lose version history and metadata ❌ Complex if heavily integrated with BSR ecosystem"},{"id":"cli/package-manager/easyp-vs-buf::buf-potential-lock-in::47","title":"EasyP vs Buf Package Management","section":"Buf: Potential Lock-in","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-potential-lock-in","headings":["Buf: Potential Lock-in"],"excerpt":"Buf: Potential Lock-in **Migration TO Buf:** ❌ Must publish all dependencies to BSR first ❌ Cannot reference Git repositories directly ❌ Must adopt BSR workflow and tooling","content":"Buf: Potential Lock-in **Migration TO Buf:** ❌ Must publish all dependencies to BSR first ❌ Cannot reference Git repositories directly ❌ Must adopt BSR workflow and tooling"},{"id":"cli/package-manager/easyp-vs-buf::choose-easyp-when::48","title":"EasyP vs Buf Package Management","section":"Choose EasyP When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-easyp-when","headings":["Choose EasyP When:"],"excerpt":"Choose EasyP When: ✅ **Enterprise/Air-gapped environments** Need to work without external dependencies Strict compliance requirements Air-gapped or classified networks","content":"Choose EasyP When: ✅ **Enterprise/Air-gapped environments** Need to work without external dependencies Strict compliance requirements Air-gapped or classified networks"},{"id":"cli/package-manager/easyp-vs-buf::choose-easyp-when::49","title":"EasyP vs Buf Package Management","section":"Choose EasyP When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-easyp-when","headings":["Choose EasyP When:"],"excerpt":"Choose EasyP When: ✅ **Security-first organizations** Want direct control over dependency sources Need to audit entire supply chain Concerned about third-party service risks","content":"Choose EasyP When: ✅ **Security-first organizations** Want direct control over dependency sources Need to audit entire supply chain Concerned about third-party service risks"},{"id":"cli/package-manager/easyp-vs-buf::choose-easyp-when::50","title":"EasyP vs Buf Package Management","section":"Choose EasyP When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-easyp-when","headings":["Choose EasyP When:"],"excerpt":"Choose EasyP When: ✅ **Existing Git-heavy workflows** Team already comfortable with Git Extensive private repository usage Want to minimize new tools/infrastructure","content":"Choose EasyP When: ✅ **Existing Git-heavy workflows** Team already comfortable with Git Extensive private repository usage Want to minimize new tools/infrastructure"},{"id":"cli/package-manager/easyp-vs-buf::choose-easyp-when::51","title":"EasyP vs Buf Package Management","section":"Choose EasyP When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-easyp-when","headings":["Choose EasyP When:"],"excerpt":"Choose EasyP When: ✅ **Cost-sensitive projects** Want to avoid additional licensing costs Don't want infrastructure overhead Need predictable, zero-cost scaling","content":"Choose EasyP When: ✅ **Cost-sensitive projects** Want to avoid additional licensing costs Don't want infrastructure overhead Need predictable, zero-cost scaling"},{"id":"cli/package-manager/easyp-vs-buf::choose-easyp-when::52","title":"EasyP vs Buf Package Management","section":"Choose EasyP When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-easyp-when","headings":["Choose EasyP When:"],"excerpt":"Choose EasyP When: ✅ **Mixed public/private dependencies** Heavy use of internal Git repositories Don't want to republish existing repos Need flexibility in dependency sources","content":"Choose EasyP When: ✅ **Mixed public/private dependencies** Heavy use of internal Git repositories Don't want to republish existing repos Need flexibility in dependency sources"},{"id":"cli/package-manager/easyp-vs-buf::choose-buf-when::53","title":"EasyP vs Buf Package Management","section":"Choose Buf When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-buf-when","headings":["Choose Buf When:"],"excerpt":"Choose Buf When: ✅ **Heavy BSR ecosystem usage** Already invested in Buf tooling (lint, breaking changes, generation) Want curated, high-quality modules Benefit from BSR's rich metadata and docs","content":"Choose Buf When: ✅ **Heavy BSR ecosystem usage** Already invested in Buf tooling (lint, breaking changes, generation) Want curated, high-quality modules Benefit from BSR's rich metadata and docs"},{"id":"cli/package-manager/easyp-vs-buf::choose-buf-when::54","title":"EasyP vs Buf Package Management","section":"Choose Buf When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-buf-when","headings":["Choose Buf When:"],"excerpt":"Choose Buf When: ✅ **Collaborative development** Need dependency graph visualization Want centralized module discovery Benefit from BSR's collaboration features","content":"Choose Buf When: ✅ **Collaborative development** Need dependency graph visualization Want centralized module discovery Benefit from BSR's collaboration features"},{"id":"cli/package-manager/easyp-vs-buf::choose-buf-when::55","title":"EasyP vs Buf Package Management","section":"Choose Buf When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-buf-when","headings":["Choose Buf When:"],"excerpt":"Choose Buf When: ✅ **Simple public-only dependencies** Primarily use well-known public modules Don't mind BSR dependency Value the curated module experience","content":"Choose Buf When: ✅ **Simple public-only dependencies** Primarily use well-known public modules Don't mind BSR dependency Value the curated module experience"},{"id":"cli/package-manager/easyp-vs-buf::choose-buf-when::56","title":"EasyP vs Buf Package Management","section":"Choose Buf When:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#choose-buf-when","headings":["Choose Buf When:"],"excerpt":"Choose Buf When: ✅ **Team new to protobuf** Benefit from BSR's documentation and examples Want guided module discovery Prefer opinionated, structured approach","content":"Choose Buf When: ✅ **Team new to protobuf** Benefit from BSR's documentation and examples Want guided module discovery Prefer opinionated, structured approach"},{"id":"cli/package-manager/easyp-vs-buf::migrating-from-buf-to-easyp::57","title":"EasyP vs Buf Package Management","section":"Migrating from Buf to EasyP","path":"/docs/guide/cli/package-manager/easyp-vs-buf#migrating-from-buf-to-easyp","headings":["Migrating from Buf to EasyP"],"excerpt":"Migrating from Buf to EasyP **Identify source repositories** for each BSR module **Map BSR modules** to Git repository references **Update configuration** to use Git URLs **Test compatibility** and resolve any issues","content":"Migrating from Buf to EasyP **Identify source repositories** for each BSR module **Map BSR modules** to Git repository references **Update configuration** to use Git URLs **Test compatibility** and resolve any issues"},{"id":"cli/package-manager/easyp-vs-buf::migrating-from-buf-to-easyp::58","title":"EasyP vs Buf Package Management","section":"Migrating from Buf to EasyP","path":"/docs/guide/cli/package-manager/easyp-vs-buf#migrating-from-buf-to-easyp","headings":["Migrating from Buf to EasyP"],"excerpt":"Migrating from Buf to EasyP Example migration: ```yaml Before (buf.yaml) deps: - buf.build/googleapis/googleapis - buf.build/grpc/grpc","content":"Migrating from Buf to EasyP Example migration: ```yaml Before (buf.yaml) deps: - buf.build/googleapis/googleapis - buf.build/grpc/grpc"},{"id":"cli/package-manager/easyp-vs-buf::migrating-from-buf-to-easyp::59","title":"EasyP vs Buf Package Management","section":"Migrating from Buf to EasyP","path":"/docs/guide/cli/package-manager/easyp-vs-buf#migrating-from-buf-to-easyp","headings":["Migrating from Buf to EasyP"],"excerpt":"Migrating from Buf to EasyP After (easyp.yaml) deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc/grpc@v1.50.0 ```","content":"Migrating from Buf to EasyP After (easyp.yaml) deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc/grpc@v1.50.0 ```"},{"id":"cli/package-manager/easyp-vs-buf::migrating-from-easyp-to-buf::60","title":"EasyP vs Buf Package Management","section":"Migrating from EasyP to Buf","path":"/docs/guide/cli/package-manager/easyp-vs-buf#migrating-from-easyp-to-buf","headings":["Migrating from EasyP to Buf"],"excerpt":"Migrating from EasyP to Buf **Publish modules** to BSR (if not already available) **Create BSR account** and configure authentication **Update configuration** to reference BSR modules **Adopt BSR workflow** (push, pull, ","content":"Migrating from EasyP to Buf **Publish modules** to BSR (if not already available) **Create BSR account** and configure authentication **Update configuration** to reference BSR modules **Adopt BSR workflow** (push, pull, etc.)"},{"id":"cli/package-manager/easyp-vs-buf::conclusion::61","title":"EasyP vs Buf Package Management","section":"Conclusion","path":"/docs/guide/cli/package-manager/easyp-vs-buf#conclusion","headings":["Conclusion"],"excerpt":"Conclusion Both EasyP and Buf offer valid approaches to protobuf dependency management, but they serve different needs:","content":"Conclusion Both EasyP and Buf offer valid approaches to protobuf dependency management, but they serve different needs:"},{"id":"cli/package-manager/easyp-vs-buf::conclusion::62","title":"EasyP vs Buf Package Management","section":"Conclusion","path":"/docs/guide/cli/package-manager/easyp-vs-buf#conclusion","headings":["Conclusion"],"excerpt":"Conclusion **EasyP excels in:** Enterprise and air-gapped environments Security-conscious organizations Cost-sensitive projects Direct Git repository usage Zero-infrastructure deployments","content":"Conclusion **EasyP excels in:** Enterprise and air-gapped environments Security-conscious organizations Cost-sensitive projects Direct Git repository usage Zero-infrastructure deployments"},{"id":"cli/package-manager/easyp-vs-buf::conclusion::63","title":"EasyP vs Buf Package Management","section":"Conclusion","path":"/docs/guide/cli/package-manager/easyp-vs-buf#conclusion","headings":["Conclusion"],"excerpt":"Conclusion **Buf excels in:** Collaborative, open-source focused teams Organizations wanting curated, high-quality modules Teams new to protobuf ecosystem Projects heavily using BSR features","content":"Conclusion **Buf excels in:** Collaborative, open-source focused teams Organizations wanting curated, high-quality modules Teams new to protobuf ecosystem Projects heavily using BSR features"},{"id":"cli/package-manager/easyp-vs-buf::conclusion::64","title":"EasyP vs Buf Package Management","section":"Conclusion","path":"/docs/guide/cli/package-manager/easyp-vs-buf#conclusion","headings":["Conclusion"],"excerpt":"Conclusion The choice between EasyP and Buf often comes down to your organization's priorities around **control vs. convenience**, **security vs. collaboration features**, and **infrastructure costs vs. managed services*","content":"Conclusion The choice between EasyP and Buf often comes down to your organization's priorities around **control vs. convenience**, **security vs. collaboration features**, and **infrastructure costs vs. managed services**."},{"id":"cli/package-manager/easyp-vs-buf::conclusion::65","title":"EasyP vs Buf Package Management","section":"Conclusion","path":"/docs/guide/cli/package-manager/easyp-vs-buf#conclusion","headings":["Conclusion"],"excerpt":"Conclusion For many enterprise environments, EasyP's decentralized, Git-native approach provides the security, control, and cost-effectiveness needed for production protobuf workflows, while Buf's centralized registry ex","content":"Conclusion For many enterprise environments, EasyP's decentralized, Git-native approach provides the security, control, and cost-effectiveness needed for production protobuf workflows, while Buf's centralized registry excels in collaborative, open-source focused development environments."},{"id":"cli/package-manager/package-manager::top::0","title":"Package Manager","path":"/docs/guide/cli/package-manager/package-manager","headings":[],"excerpt":"EasyP provides a powerful package manager for protobuf dependencies that simplifies dependency management through a decentralized, Git-based approach. Unlike centralized solutions, EasyP works directly with Git repositor","content":"EasyP provides a powerful package manager for protobuf dependencies that simplifies dependency management through a decentralized, Git-based approach. Unlike centralized solutions, EasyP works directly with Git repositories, giving you complete control over your dependencies."},{"id":"cli/package-manager/package-manager::overview::1","title":"Package Manager","section":"Overview","path":"/docs/guide/cli/package-manager/package-manager#overview","headings":["Overview"],"excerpt":"Overview The EasyP package manager follows the **Go modules philosophy** - any Git repository can serve as a package source. This approach provides several key advantages:","content":"Overview The EasyP package manager follows the **Go modules philosophy** - any Git repository can serve as a package source. This approach provides several key advantages:"},{"id":"cli/package-manager/package-manager::overview::2","title":"Package Manager","section":"Overview","path":"/docs/guide/cli/package-manager/package-manager#overview","headings":["Overview"],"excerpt":"Overview **Decentralized**: No single point of failure or control **Security**: Direct access to source repositories **Flexibility**: Support for public, private, and enterprise repositories **Reproducibility**: Lock fil","content":"Overview **Decentralized**: No single point of failure or control **Security**: Direct access to source repositories **Flexibility**: Support for public, private, and enterprise repositories **Reproducibility**: Lock files ensure consistent builds across environments **Performance**: Local caching minimizes network requests"},{"id":"cli/package-manager/package-manager::key-features::3","title":"Package Manager","section":"Key Features","path":"/docs/guide/cli/package-manager/package-manager#key-features","headings":["Key Features"],"excerpt":"Key Features Feature Description --------- ------------- **Git-Native** Works with any Git repository - no special server required **Multiple Version Formats** Tags, commits, pseudo-versions, latest **Lock Files** Reprod","content":"Key Features Feature Description --------- ------------- **Git-Native** Works with any Git repository - no special server required **Multiple Version Formats** Tags, commits, pseudo-versions, latest **Lock Files** Reproducible builds with easyp.lock **Local Caching** Go modules-style cache architecture **Vendoring Support** Copy dependencies locally for offline builds **YAML Configuration** Simple, readable dependency declarations"},{"id":"cli/package-manager/package-manager::architecture::4","title":"Package Manager","section":"Architecture","path":"/docs/guide/cli/package-manager/package-manager#architecture","headings":["Architecture"],"excerpt":"Architecture EasyP uses a two-tier caching system inspired by Go modules:","content":"Architecture EasyP uses a two-tier caching system inspired by Go modules:"},{"id":"cli/package-manager/package-manager::cache-location::5","title":"Package Manager","section":"Cache Location","path":"/docs/guide/cli/package-manager/package-manager#cache-location","headings":["Cache Location"],"excerpt":"Cache Location Environment Location How to Set ------------- ---------- ------------ **Default** $HOME/.easyp Automatic **Custom** Any directory Set EASYPPATH environment variable **CI/CD** Project-relative export EASYPP","content":"Cache Location Environment Location How to Set ------------- ---------- ------------ **Default** $HOME/.easyp Automatic **Custom** Any directory Set EASYPPATH environment variable **CI/CD** Project-relative export EASYPPATH=$CI_PROJECT_DIR/.easyp"},{"id":"cli/package-manager/package-manager::basic-configuration::6","title":"Package Manager","section":"Basic Configuration","path":"/docs/guide/cli/package-manager/package-manager#basic-configuration","headings":["Basic Configuration"],"excerpt":"Basic Configuration Configure dependencies in your easyp.yaml file:","content":"Basic Configuration Configure dependencies in your easyp.yaml file:"},{"id":"cli/package-manager/package-manager::advanced-configuration-examples::7","title":"Package Manager","section":"Advanced Configuration Examples","path":"/docs/guide/cli/package-manager/package-manager#advanced-configuration-examples","headings":["Advanced Configuration Examples"],"excerpt":"Advanced Configuration Examples","content":"Advanced Configuration Examples"},{"id":"cli/package-manager/package-manager::multi-environment-setup::8","title":"Package Manager","section":"Multi-Environment Setup","path":"/docs/guide/cli/package-manager/package-manager#multi-environment-setup","headings":["Multi-Environment Setup"],"excerpt":"Multi-Environment Setup ```yaml development.easyp.yaml deps: - github.com/googleapis/googleapis # Latest for development - github.com/mycompany/internal-protos # Latest internal changes - github.com/bufbuild/protoc-gen-v","content":"Multi-Environment Setup ```yaml development.easyp.yaml deps: - github.com/googleapis/googleapis # Latest for development - github.com/mycompany/internal-protos # Latest internal changes - github.com/bufbuild/protoc-gen-validate # Latest features"},{"id":"cli/package-manager/package-manager::multi-environment-setup::9","title":"Package Manager","section":"Multi-Environment Setup","path":"/docs/guide/cli/package-manager/package-manager#multi-environment-setup","headings":["Multi-Environment Setup"],"excerpt":"Multi-Environment Setup production.easyp.yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1 # Pinned - github.com/mycompany/internal-protos@v2.1.0 # Stable release - github.com/bufbuild/protoc-gen-validate","content":"Multi-Environment Setup production.easyp.yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1 # Pinned - github.com/mycompany/internal-protos@v2.1.0 # Stable release - github.com/bufbuild/protoc-gen-validate@v0.10.1 # Tested version ```"},{"id":"cli/package-manager/package-manager::private-repository-setup::10","title":"Package Manager","section":"Private Repository Setup","path":"/docs/guide/cli/package-manager/package-manager#private-repository-setup","headings":["Private Repository Setup"],"excerpt":"Private Repository Setup ```yaml deps: # Public dependencies - github.com/googleapis/googleapis@common-protos-1_3_1","content":"Private Repository Setup ```yaml deps: # Public dependencies - github.com/googleapis/googleapis@common-protos-1_3_1"},{"id":"cli/package-manager/package-manager::private-repository-setup::11","title":"Package Manager","section":"Private Repository Setup","path":"/docs/guide/cli/package-manager/package-manager#private-repository-setup","headings":["Private Repository Setup"],"excerpt":"Private Repository Setup Private company repositories - github.com/mycompany/auth-protos@v1.5.0 - github.com/mycompany/common-types@v2.0.1","content":"Private Repository Setup Private company repositories - github.com/mycompany/auth-protos@v1.5.0 - github.com/mycompany/common-types@v2.0.1"},{"id":"cli/package-manager/package-manager::private-repository-setup::12","title":"Package Manager","section":"Private Repository Setup","path":"/docs/guide/cli/package-manager/package-manager#private-repository-setup","headings":["Private Repository Setup"],"excerpt":"Private Repository Setup Internal GitLab - gitlab.company.com/platform/messaging-protos@v0.3.0 ```","content":"Private Repository Setup Internal GitLab - gitlab.company.com/platform/messaging-protos@v0.3.0 ```"},{"id":"cli/package-manager/package-manager::versioning-strategies::13","title":"Package Manager","section":"Versioning Strategies","path":"/docs/guide/cli/package-manager/package-manager#versioning-strategies","headings":["Versioning Strategies"],"excerpt":"Versioning Strategies EasyP supports multiple versioning approaches to fit different development workflows:","content":"Versioning Strategies EasyP supports multiple versioning approaches to fit different development workflows:"},{"id":"cli/package-manager/package-manager::1-semantic-version-tags-recommended-for-production::14","title":"Package Manager","section":"1. Semantic Version Tags (Recommended for Production)","path":"/docs/guide/cli/package-manager/package-manager#1-semantic-version-tags-recommended-for-production","headings":["1. Semantic Version Tags (Recommended for Production)"],"excerpt":"Semantic Version Tags (Recommended for Production)","content":"Semantic Version Tags (Recommended for Production)"},{"id":"cli/package-manager/package-manager::1-semantic-version-tags-recommended-for-production::15","title":"Package Manager","section":"1. Semantic Version Tags (Recommended for Production)","path":"/docs/guide/cli/package-manager/package-manager#1-semantic-version-tags-recommended-for-production","headings":["1. Semantic Version Tags (Recommended for Production)"],"excerpt":"Semantic Version Tags (Recommended for Production) **Use when:** Production deployments Stable API consumption Reproducible builds required","content":"Semantic Version Tags (Recommended for Production) **Use when:** Production deployments Stable API consumption Reproducible builds required"},{"id":"cli/package-manager/package-manager::2-latest-tag-development::16","title":"Package Manager","section":"2. Latest Tag (Development)","path":"/docs/guide/cli/package-manager/package-manager#2-latest-tag-development","headings":["2. Latest Tag (Development)"],"excerpt":"Latest Tag (Development) **Use when:** Active development Want latest features Compatibility testing","content":"Latest Tag (Development) **Use when:** Active development Want latest features Compatibility testing"},{"id":"cli/package-manager/package-manager::3-commit-hashes-bleeding-edge::17","title":"Package Manager","section":"3. Commit Hashes (Bleeding Edge)","path":"/docs/guide/cli/package-manager/package-manager#3-commit-hashes-bleeding-edge","headings":["3. Commit Hashes (Bleeding Edge)"],"excerpt":"Commit Hashes (Bleeding Edge) **Use when:** Need unreleased features Testing specific fixes Contributing to upstream","content":"Commit Hashes (Bleeding Edge) **Use when:** Need unreleased features Testing specific fixes Contributing to upstream"},{"id":"cli/package-manager/package-manager::4-pseudo-versions-automatic::18","title":"Package Manager","section":"4. Pseudo-Versions (Automatic)","path":"/docs/guide/cli/package-manager/package-manager#4-pseudo-versions-automatic","headings":["4. Pseudo-Versions (Automatic)"],"excerpt":"Pseudo-Versions (Automatic) When EasyP can't find a suitable tag, it generates pseudo-versions automatically:","content":"Pseudo-Versions (Automatic) When EasyP can't find a suitable tag, it generates pseudo-versions automatically:"},{"id":"cli/package-manager/package-manager::4-pseudo-versions-automatic::19","title":"Package Manager","section":"4. Pseudo-Versions (Automatic)","path":"/docs/guide/cli/package-manager/package-manager#4-pseudo-versions-automatic","headings":["4. Pseudo-Versions (Automatic)"],"excerpt":"Pseudo-Versions (Automatic) This ensures every commit can be referenced with a version-like identifier.","content":"Pseudo-Versions (Automatic) This ensures every commit can be referenced with a version-like identifier."},{"id":"cli/package-manager/package-manager::easyp-mod-download::20","title":"Package Manager","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download Downloads and installs all dependencies declared in your configuration.","content":"easyp mod download Downloads and installs all dependencies declared in your configuration."},{"id":"cli/package-manager/package-manager::easyp-mod-download::21","title":"Package Manager","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download **What happens:** **Resolves versions**: Converts tags/latest to specific commits **Downloads archives**: Stores .zip files in cache/download **Verifies checksums**: Ensures archive integrity **Extract","content":"easyp mod download **What happens:** **Resolves versions**: Converts tags/latest to specific commits **Downloads archives**: Stores .zip files in cache/download **Verifies checksums**: Ensures archive integrity **Extracts modules**: Unpacks to cache/mod with proper structure **Updates lock file**: Records exact versions and content hashes"},{"id":"cli/package-manager/package-manager::easyp-mod-download::22","title":"Package Manager","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download **Usage:** ```bash Use default easyp.yaml easyp mod download","content":"easyp mod download **Usage:** ```bash Use default easyp.yaml easyp mod download"},{"id":"cli/package-manager/package-manager::easyp-mod-download::23","title":"Package Manager","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download Use custom config file easyp --cfg production.easyp.yaml mod download","content":"easyp mod download Use custom config file easyp --cfg production.easyp.yaml mod download"},{"id":"cli/package-manager/package-manager::easyp-mod-download::24","title":"Package Manager","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download With custom cache location EASYPPATH=/tmp/easyp-cache easyp mod download ```","content":"easyp mod download With custom cache location EASYPPATH=/tmp/easyp-cache easyp mod download ```"},{"id":"cli/package-manager/package-manager::easyp-mod-download::25","title":"Package Manager","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download **Example output:**","content":"easyp mod download **Example output:**"},{"id":"cli/package-manager/package-manager::easyp-mod-vendor::26","title":"Package Manager","section":"easyp mod vendor","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor Copies all installed proto files to a local easyp_vendor/ directory for offline usage.","content":"easyp mod vendor Copies all installed proto files to a local easyp_vendor/ directory for offline usage."},{"id":"cli/package-manager/package-manager::easyp-mod-vendor::27","title":"Package Manager","section":"easyp mod vendor","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor **Use cases:** **Docker builds**: Avoid network dependencies in containers **Air-gapped environments**: No internet access during builds **Reproducible builds**: Bundle exact dependency versions **Perfor","content":"easyp mod vendor **Use cases:** **Docker builds**: Avoid network dependencies in containers **Air-gapped environments**: No internet access during builds **Reproducible builds**: Bundle exact dependency versions **Performance**: Eliminate network latency in repeated builds"},{"id":"cli/package-manager/package-manager::easyp-mod-vendor::28","title":"Package Manager","section":"easyp mod vendor","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor **Result structure:**","content":"easyp mod vendor **Result structure:**"},{"id":"cli/package-manager/package-manager::easyp-mod-update::29","title":"Package Manager","section":"easyp mod update","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-update","headings":["easyp mod update"],"excerpt":"easyp mod update Updates module versions based on current configuration and writes resolved versions to the lock file.","content":"easyp mod update Updates module versions based on current configuration and writes resolved versions to the lock file."},{"id":"cli/package-manager/package-manager::easyp-mod-update::30","title":"Package Manager","section":"easyp mod update","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-update","headings":["easyp mod update"],"excerpt":"easyp mod update **Behavior:** Respects version constraints in easyp.yaml Updates to latest compatible versions Regenerates easyp.lock with new versions and hashes","content":"easyp mod update **Behavior:** Respects version constraints in easyp.yaml Updates to latest compatible versions Regenerates easyp.lock with new versions and hashes"},{"id":"cli/package-manager/package-manager::lock-files::31","title":"Package Manager","section":"Lock Files","path":"/docs/guide/cli/package-manager/package-manager#lock-files","headings":["Lock Files"],"excerpt":"Lock Files The easyp.lock file ensures reproducible builds by recording exact versions and content hashes:","content":"Lock Files The easyp.lock file ensures reproducible builds by recording exact versions and content hashes:"},{"id":"cli/package-manager/package-manager::lock-file-format::32","title":"Package Manager","section":"Lock File Format","path":"/docs/guide/cli/package-manager/package-manager#lock-file-format","headings":["Lock File Format"],"excerpt":"Lock File Format Each line contains three components: **Module path**: Full repository path **Exact version**: Resolved version (tag or pseudo-version) **Content hash**: SHA256 of extracted content (h1: prefix)","content":"Lock File Format Each line contains three components: **Module path**: Full repository path **Exact version**: Resolved version (tag or pseudo-version) **Content hash**: SHA256 of extracted content (h1: prefix)"},{"id":"cli/package-manager/package-manager::best-practices::33","title":"Package Manager","section":"Best Practices","path":"/docs/guide/cli/package-manager/package-manager#best-practices","headings":["Best Practices"],"excerpt":"Best Practices ✅ **Always commit easyp.lock** - Ensures team consistency ✅ **Run mod update deliberately** - Don't auto-update in CI ✅ **Review lock changes** - Understand what's being updated ❌ **Don't edit manually** -","content":"Best Practices ✅ **Always commit easyp.lock** - Ensures team consistency ✅ **Run mod update deliberately** - Don't auto-update in CI ✅ **Review lock changes** - Understand what's being updated ❌ **Don't edit manually** - Let EasyP manage the format"},{"id":"cli/package-manager/package-manager::public-repositories::34","title":"Package Manager","section":"Public Repositories","path":"/docs/guide/cli/package-manager/package-manager#public-repositories","headings":["Public Repositories"],"excerpt":"Public Repositories No setup required - works out of the box:","content":"Public Repositories No setup required - works out of the box:"},{"id":"cli/package-manager/package-manager::ssh-keys-recommended::35","title":"Package Manager","section":"SSH Keys (Recommended)","path":"/docs/guide/cli/package-manager/package-manager#ssh-keys-recommended","headings":["SSH Keys (Recommended)"],"excerpt":"SSH Keys (Recommended) Configure Git to use SSH for GitHub/GitLab:","content":"SSH Keys (Recommended) Configure Git to use SSH for GitHub/GitLab:"},{"id":"cli/package-manager/package-manager::ssh-keys-recommended::36","title":"Package Manager","section":"SSH Keys (Recommended)","path":"/docs/guide/cli/package-manager/package-manager#ssh-keys-recommended","headings":["SSH Keys (Recommended)"],"excerpt":"SSH Keys (Recommended) ```bash For GitHub git config --global url.\"git@github.com:\".insteadOf \"https://github.com/\"","content":"SSH Keys (Recommended) ```bash For GitHub git config --global url.\"git@github.com:\".insteadOf \"https://github.com/\""},{"id":"cli/package-manager/package-manager::ssh-keys-recommended::37","title":"Package Manager","section":"SSH Keys (Recommended)","path":"/docs/guide/cli/package-manager/package-manager#ssh-keys-recommended","headings":["SSH Keys (Recommended)"],"excerpt":"SSH Keys (Recommended) For GitLab git config --global url.\"git@gitlab.com:\".insteadOf \"https://gitlab.com/\"","content":"SSH Keys (Recommended) For GitLab git config --global url.\"git@gitlab.com:\".insteadOf \"https://gitlab.com/\""},{"id":"cli/package-manager/package-manager::ssh-keys-recommended::38","title":"Package Manager","section":"SSH Keys (Recommended)","path":"/docs/guide/cli/package-manager/package-manager#ssh-keys-recommended","headings":["SSH Keys (Recommended)"],"excerpt":"SSH Keys (Recommended) For custom domains git config --global url.\"git@gitlab.company.com:\".insteadOf \"https://gitlab.company.com/\" ```","content":"SSH Keys (Recommended) For custom domains git config --global url.\"git@gitlab.company.com:\".insteadOf \"https://gitlab.company.com/\" ```"},{"id":"cli/package-manager/package-manager::ssh-keys-recommended::39","title":"Package Manager","section":"SSH Keys (Recommended)","path":"/docs/guide/cli/package-manager/package-manager#ssh-keys-recommended","headings":["SSH Keys (Recommended)"],"excerpt":"SSH Keys (Recommended) Then use normal HTTPS URLs in your config:","content":"SSH Keys (Recommended) Then use normal HTTPS URLs in your config:"},{"id":"cli/package-manager/package-manager::personal-access-tokens::40","title":"Package Manager","section":"Personal Access Tokens","path":"/docs/guide/cli/package-manager/package-manager#personal-access-tokens","headings":["Personal Access Tokens"],"excerpt":"Personal Access Tokens For HTTPS authentication:","content":"Personal Access Tokens For HTTPS authentication:"},{"id":"cli/package-manager/package-manager::personal-access-tokens::41","title":"Package Manager","section":"Personal Access Tokens","path":"/docs/guide/cli/package-manager/package-manager#personal-access-tokens","headings":["Personal Access Tokens"],"excerpt":"Personal Access Tokens ```bash Method 1: Credential helper git config --global credential.helper store echo \"https://username:token@github.com\" >> ~/.git-credentials","content":"Personal Access Tokens ```bash Method 1: Credential helper git config --global credential.helper store echo \"https://username:token@github.com\" >> ~/.git-credentials"},{"id":"cli/package-manager/package-manager::personal-access-tokens::42","title":"Package Manager","section":"Personal Access Tokens","path":"/docs/guide/cli/package-manager/package-manager#personal-access-tokens","headings":["Personal Access Tokens"],"excerpt":"Personal Access Tokens Method 2: URL rewriting git config --global url.\"https://username:token@github.com/mycompany\".insteadOf \"https://github.com/mycompany\" ```","content":"Personal Access Tokens Method 2: URL rewriting git config --global url.\"https://username:token@github.com/mycompany\".insteadOf \"https://github.com/mycompany\" ```"},{"id":"cli/package-manager/package-manager::corporate-environments::43","title":"Package Manager","section":"Corporate Environments","path":"/docs/guide/cli/package-manager/package-manager#corporate-environments","headings":["Corporate Environments"],"excerpt":"Corporate Environments ```bash Configure proxy git config --global http.proxy http://proxy.company.com:8080 git config --global https.proxy https://proxy.company.com:8080","content":"Corporate Environments ```bash Configure proxy git config --global http.proxy http://proxy.company.com:8080 git config --global https.proxy https://proxy.company.com:8080"},{"id":"cli/package-manager/package-manager::corporate-environments::44","title":"Package Manager","section":"Corporate Environments","path":"/docs/guide/cli/package-manager/package-manager#corporate-environments","headings":["Corporate Environments"],"excerpt":"Corporate Environments Configure certificates for internal Git servers git config --global http.sslCAInfo /path/to/certificate.pem ```","content":"Corporate Environments Configure certificates for internal Git servers git config --global http.sslCAInfo /path/to/certificate.pem ```"},{"id":"cli/package-manager/package-manager::initial-project-setup::45","title":"Package Manager","section":"Initial Project Setup","path":"/docs/guide/cli/package-manager/package-manager#initial-project-setup","headings":["Initial Project Setup"],"excerpt":"Initial Project Setup ```bash Create configuration cat > easyp.yaml << EOF deps: - github.com/googleapis/googleapis - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 EOF","content":"Initial Project Setup ```bash Create configuration cat > easyp.yaml << EOF deps: - github.com/googleapis/googleapis - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 EOF"},{"id":"cli/package-manager/package-manager::initial-project-setup::46","title":"Package Manager","section":"Initial Project Setup","path":"/docs/guide/cli/package-manager/package-manager#initial-project-setup","headings":["Initial Project Setup"],"excerpt":"Initial Project Setup Download dependencies easyp mod download","content":"Initial Project Setup Download dependencies easyp mod download"},{"id":"cli/package-manager/package-manager::initial-project-setup::47","title":"Package Manager","section":"Initial Project Setup","path":"/docs/guide/cli/package-manager/package-manager#initial-project-setup","headings":["Initial Project Setup"],"excerpt":"Initial Project Setup Verify installation ls ~/.easyp/mod/github.com/googleapis/googleapis/ ```","content":"Initial Project Setup Verify installation ls ~/.easyp/mod/github.com/googleapis/googleapis/ ```"},{"id":"cli/package-manager/package-manager::adding-new-dependencies::48","title":"Package Manager","section":"Adding New Dependencies","path":"/docs/guide/cli/package-manager/package-manager#adding-new-dependencies","headings":["Adding New Dependencies"],"excerpt":"Adding New Dependencies ```bash Edit easyp.yaml echo \" - github.com/bufbuild/protoc-gen-validate@v0.10.1\" >> easyp.yaml","content":"Adding New Dependencies ```bash Edit easyp.yaml echo \" - github.com/bufbuild/protoc-gen-validate@v0.10.1\" >> easyp.yaml"},{"id":"cli/package-manager/package-manager::adding-new-dependencies::49","title":"Package Manager","section":"Adding New Dependencies","path":"/docs/guide/cli/package-manager/package-manager#adding-new-dependencies","headings":["Adding New Dependencies"],"excerpt":"Adding New Dependencies Download new dependency easyp mod download","content":"Adding New Dependencies Download new dependency easyp mod download"},{"id":"cli/package-manager/package-manager::adding-new-dependencies::50","title":"Package Manager","section":"Adding New Dependencies","path":"/docs/guide/cli/package-manager/package-manager#adding-new-dependencies","headings":["Adding New Dependencies"],"excerpt":"Adding New Dependencies Commit lock file changes git add easyp.lock git commit -m \"Add protoc-gen-validate dependency\" ```","content":"Adding New Dependencies Commit lock file changes git add easyp.lock git commit -m \"Add protoc-gen-validate dependency\" ```"},{"id":"cli/package-manager/package-manager::updating-dependencies::51","title":"Package Manager","section":"Updating Dependencies","path":"/docs/guide/cli/package-manager/package-manager#updating-dependencies","headings":["Updating Dependencies"],"excerpt":"Updating Dependencies ```bash Update to latest compatible versions easyp mod update","content":"Updating Dependencies ```bash Update to latest compatible versions easyp mod update"},{"id":"cli/package-manager/package-manager::updating-dependencies::52","title":"Package Manager","section":"Updating Dependencies","path":"/docs/guide/cli/package-manager/package-manager#updating-dependencies","headings":["Updating Dependencies"],"excerpt":"Updating Dependencies Review changes git diff easyp.lock","content":"Updating Dependencies Review changes git diff easyp.lock"},{"id":"cli/package-manager/package-manager::updating-dependencies::53","title":"Package Manager","section":"Updating Dependencies","path":"/docs/guide/cli/package-manager/package-manager#updating-dependencies","headings":["Updating Dependencies"],"excerpt":"Updating Dependencies Test with new versions easyp generate easyp lint","content":"Updating Dependencies Test with new versions easyp generate easyp lint"},{"id":"cli/package-manager/package-manager::updating-dependencies::54","title":"Package Manager","section":"Updating Dependencies","path":"/docs/guide/cli/package-manager/package-manager#updating-dependencies","headings":["Updating Dependencies"],"excerpt":"Updating Dependencies Commit if everything works git add easyp.lock git commit -m \"Update dependencies\" ```","content":"Updating Dependencies Commit if everything works git add easyp.lock git commit -m \"Update dependencies\" ```"},{"id":"cli/package-manager/package-manager::offline-development::55","title":"Package Manager","section":"Offline Development","path":"/docs/guide/cli/package-manager/package-manager#offline-development","headings":["Offline Development"],"excerpt":"Offline Development ```bash Vendor all dependencies easyp mod vendor","content":"Offline Development ```bash Vendor all dependencies easyp mod vendor"},{"id":"cli/package-manager/package-manager::offline-development::56","title":"Package Manager","section":"Offline Development","path":"/docs/guide/cli/package-manager/package-manager#offline-development","headings":["Offline Development"],"excerpt":"Offline Development Now your project works offline easyp generate ```","content":"Offline Development Now your project works offline easyp generate ```"},{"id":"cli/package-manager/package-manager::repository-not-found-or-authentication-failed::57","title":"Package Manager","section":"\"Repository not found\" or \"Authentication failed\"","path":"/docs/guide/cli/package-manager/package-manager#repository-not-found-or-authentication-failed","headings":["\"Repository not found\" or \"Authentication failed\""],"excerpt":"\"Repository not found\" or \"Authentication failed\" **Problem**: Can't access private repository **Solution**: Check authentication setup","content":"\"Repository not found\" or \"Authentication failed\" **Problem**: Can't access private repository **Solution**: Check authentication setup"},{"id":"cli/package-manager/package-manager::repository-not-found-or-authentication-failed::58","title":"Package Manager","section":"\"Repository not found\" or \"Authentication failed\"","path":"/docs/guide/cli/package-manager/package-manager#repository-not-found-or-authentication-failed","headings":["\"Repository not found\" or \"Authentication failed\""],"excerpt":"\"Repository not found\" or \"Authentication failed\" ```bash Test Git access git ls-remote https://github.com/mycompany/private-repo","content":"\"Repository not found\" or \"Authentication failed\" ```bash Test Git access git ls-remote https://github.com/mycompany/private-repo"},{"id":"cli/package-manager/package-manager::repository-not-found-or-authentication-failed::59","title":"Package Manager","section":"\"Repository not found\" or \"Authentication failed\"","path":"/docs/guide/cli/package-manager/package-manager#repository-not-found-or-authentication-failed","headings":["\"Repository not found\" or \"Authentication failed\""],"excerpt":"\"Repository not found\" or \"Authentication failed\" Check Git configuration git config --list grep url ```","content":"\"Repository not found\" or \"Authentication failed\" Check Git configuration git config --list grep url ```"},{"id":"cli/package-manager/package-manager::version-not-found::60","title":"Package Manager","section":"\"Version not found\"","path":"/docs/guide/cli/package-manager/package-manager#version-not-found","headings":["\"Version not found\""],"excerpt":"\"Version not found\" **Problem**: Specified tag/version doesn't exist **Solution**: Check available tags","content":"\"Version not found\" **Problem**: Specified tag/version doesn't exist **Solution**: Check available tags"},{"id":"cli/package-manager/package-manager::version-not-found::61","title":"Package Manager","section":"\"Version not found\"","path":"/docs/guide/cli/package-manager/package-manager#version-not-found","headings":["\"Version not found\""],"excerpt":"\"Version not found\" ```bash List available tags git ls-remote --tags https://github.com/googleapis/googleapis","content":"\"Version not found\" ```bash List available tags git ls-remote --tags https://github.com/googleapis/googleapis"},{"id":"cli/package-manager/package-manager::version-not-found::62","title":"Package Manager","section":"\"Version not found\"","path":"/docs/guide/cli/package-manager/package-manager#version-not-found","headings":["\"Version not found\""],"excerpt":"\"Version not found\" Use existing tag or commit hash deps: - github.com/googleapis/googleapis@common-protos-1_3_1 # Valid tag ```","content":"\"Version not found\" Use existing tag or commit hash deps: - github.com/googleapis/googleapis@common-protos-1_3_1 # Valid tag ```"},{"id":"cli/package-manager/package-manager::cache-corruption-or-checksum-mismatch::63","title":"Package Manager","section":"\"Cache corruption\" or \"Checksum mismatch\"","path":"/docs/guide/cli/package-manager/package-manager#cache-corruption-or-checksum-mismatch","headings":["\"Cache corruption\" or \"Checksum mismatch\""],"excerpt":"\"Cache corruption\" or \"Checksum mismatch\" **Problem**: Corrupted cache files **Solution**: Clear cache and re-download","content":"\"Cache corruption\" or \"Checksum mismatch\" **Problem**: Corrupted cache files **Solution**: Clear cache and re-download"},{"id":"cli/package-manager/package-manager::cache-corruption-or-checksum-mismatch::64","title":"Package Manager","section":"\"Cache corruption\" or \"Checksum mismatch\"","path":"/docs/guide/cli/package-manager/package-manager#cache-corruption-or-checksum-mismatch","headings":["\"Cache corruption\" or \"Checksum mismatch\""],"excerpt":"\"Cache corruption\" or \"Checksum mismatch\" ```bash Clear everything rm -rf ~/.easyp","content":"\"Cache corruption\" or \"Checksum mismatch\" ```bash Clear everything rm -rf ~/.easyp"},{"id":"cli/package-manager/package-manager::cache-corruption-or-checksum-mismatch::65","title":"Package Manager","section":"\"Cache corruption\" or \"Checksum mismatch\"","path":"/docs/guide/cli/package-manager/package-manager#cache-corruption-or-checksum-mismatch","headings":["\"Cache corruption\" or \"Checksum mismatch\""],"excerpt":"\"Cache corruption\" or \"Checksum mismatch\" Or clear just downloads rm -rf ~/.easyp/cache/download","content":"\"Cache corruption\" or \"Checksum mismatch\" Or clear just downloads rm -rf ~/.easyp/cache/download"},{"id":"cli/package-manager/package-manager::cache-corruption-or-checksum-mismatch::66","title":"Package Manager","section":"\"Cache corruption\" or \"Checksum mismatch\"","path":"/docs/guide/cli/package-manager/package-manager#cache-corruption-or-checksum-mismatch","headings":["\"Cache corruption\" or \"Checksum mismatch\""],"excerpt":"\"Cache corruption\" or \"Checksum mismatch\" Re-download easyp mod download ```","content":"\"Cache corruption\" or \"Checksum mismatch\" Re-download easyp mod download ```"},{"id":"cli/package-manager/package-manager::network-timeouts::67","title":"Package Manager","section":"Network timeouts","path":"/docs/guide/cli/package-manager/package-manager#network-timeouts","headings":["Network timeouts"],"excerpt":"Network timeouts **Problem**: Slow or unreliable network **Solution**: Configure Git timeouts","content":"Network timeouts **Problem**: Slow or unreliable network **Solution**: Configure Git timeouts"},{"id":"cli/package-manager/package-manager::network-timeouts::68","title":"Package Manager","section":"Network timeouts","path":"/docs/guide/cli/package-manager/package-manager#network-timeouts","headings":["Network timeouts"],"excerpt":"Network timeouts ```bash Increase timeout git config --global http.lowSpeedLimit 1000 git config --global http.lowSpeedTime 300","content":"Network timeouts ```bash Increase timeout git config --global http.lowSpeedLimit 1000 git config --global http.lowSpeedTime 300"},{"id":"cli/package-manager/package-manager::network-timeouts::69","title":"Package Manager","section":"Network timeouts","path":"/docs/guide/cli/package-manager/package-manager#network-timeouts","headings":["Network timeouts"],"excerpt":"Network timeouts Use proxy if available git config --global http.proxy http://proxy.company.com:8080 ```","content":"Network timeouts Use proxy if available git config --global http.proxy http://proxy.company.com:8080 ```"},{"id":"cli/package-manager/package-manager::for-large-teams::70","title":"Package Manager","section":"For Large Teams","path":"/docs/guide/cli/package-manager/package-manager#for-large-teams","headings":["For Large Teams"],"excerpt":"For Large Teams ```bash Use shared cache server (if available) export EASYPPATH=/shared/easyp-cache","content":"For Large Teams ```bash Use shared cache server (if available) export EASYPPATH=/shared/easyp-cache"},{"id":"cli/package-manager/package-manager::for-large-teams::71","title":"Package Manager","section":"For Large Teams","path":"/docs/guide/cli/package-manager/package-manager#for-large-teams","headings":["For Large Teams"],"excerpt":"For Large Teams Or use team-specific cache export EASYPPATH=/team-cache/easyp ```","content":"For Large Teams Or use team-specific cache export EASYPPATH=/team-cache/easyp ```"},{"id":"cli/package-manager/package-manager::for-cicd-systems::72","title":"Package Manager","section":"For CI/CD Systems","path":"/docs/guide/cli/package-manager/package-manager#for-cicd-systems","headings":["For CI/CD Systems"],"excerpt":"For CI/CD Systems ```bash Use project-relative cache export EASYPPATH=$CI_PROJECT_DIR/.easyp","content":"For CI/CD Systems ```bash Use project-relative cache export EASYPPATH=$CI_PROJECT_DIR/.easyp"},{"id":"cli/package-manager/package-manager::for-cicd-systems::73","title":"Package Manager","section":"For CI/CD Systems","path":"/docs/guide/cli/package-manager/package-manager#for-cicd-systems","headings":["For CI/CD Systems"],"excerpt":"For CI/CD Systems Cache between builds (GitLab CI example) cache: key: easyp-$CI_COMMIT_REF_SLUG paths: - .easyp/ ```","content":"For CI/CD Systems Cache between builds (GitLab CI example) cache: key: easyp-$CI_COMMIT_REF_SLUG paths: - .easyp/ ```"},{"id":"cli/package-manager/package-manager::cache-size-management::74","title":"Package Manager","section":"Cache Size Management","path":"/docs/guide/cli/package-manager/package-manager#cache-size-management","headings":["Cache Size Management"],"excerpt":"Cache Size Management ```bash Check cache usage du -sh ~/.easyp du -sh ~/.easyp/cache/download # Archives only du -sh ~/.easyp/mod # Extracted modules","content":"Cache Size Management ```bash Check cache usage du -sh ~/.easyp du -sh ~/.easyp/cache/download # Archives only du -sh ~/.easyp/mod # Extracted modules"},{"id":"cli/package-manager/package-manager::cache-size-management::75","title":"Package Manager","section":"Cache Size Management","path":"/docs/guide/cli/package-manager/package-manager#cache-size-management","headings":["Cache Size Management"],"excerpt":"Cache Size Management Clean old versions (manual) find ~/.easyp/mod -type d -name \"v0.0.0-*\" -mtime +30 -exec rm -rf {} \\; ```","content":"Cache Size Management Clean old versions (manual) find ~/.easyp/mod -type d -name \"v0.0.0-*\" -mtime +30 -exec rm -rf {} \\; ```"},{"id":"cli/package-manager/package-manager::docker-multi-stage-build::76","title":"Package Manager","section":"Docker Multi-stage Build","path":"/docs/guide/cli/package-manager/package-manager#docker-multi-stage-build","headings":["Docker Multi-stage Build"],"excerpt":"Docker Multi-stage Build ```dockerfile Stage 1: Download dependencies FROM ghcr.io/easyp-tech/easyp:latest AS deps WORKDIR /workspace COPY easyp.yaml easyp.lock ./ RUN easyp mod vendor","content":"Docker Multi-stage Build ```dockerfile Stage 1: Download dependencies FROM ghcr.io/easyp-tech/easyp:latest AS deps WORKDIR /workspace COPY easyp.yaml easyp.lock ./ RUN easyp mod vendor"},{"id":"cli/package-manager/package-manager::docker-multi-stage-build::77","title":"Package Manager","section":"Docker Multi-stage Build","path":"/docs/guide/cli/package-manager/package-manager#docker-multi-stage-build","headings":["Docker Multi-stage Build"],"excerpt":"Docker Multi-stage Build Stage 2: Build application FROM alpine:latest AS build WORKDIR /app COPY --from=deps /workspace/easyp_vendor ./easyp_vendor COPY . . Use vendored dependencies for generation RUN easyp generate ``","content":"Docker Multi-stage Build Stage 2: Build application FROM alpine:latest AS build WORKDIR /app COPY --from=deps /workspace/easyp_vendor ./easyp_vendor COPY . . Use vendored dependencies for generation RUN easyp generate ```"},{"id":"cli/package-manager/package-manager::monorepo-structure::78","title":"Package Manager","section":"Monorepo Structure","path":"/docs/guide/cli/package-manager/package-manager#monorepo-structure","headings":["Monorepo Structure"],"excerpt":"Monorepo Structure Each easyp.yaml can have different dependencies based on service needs.","content":"Monorepo Structure Each easyp.yaml can have different dependencies based on service needs."},{"id":"cli/package-manager/package-manager::development-workflow::79","title":"Package Manager","section":"Development Workflow","path":"/docs/guide/cli/package-manager/package-manager#development-workflow","headings":["Development Workflow"],"excerpt":"Development Workflow ✅ Use **latest tags** during active development ✅ **Pin versions** for production deployments ✅ **Commit lock files** to ensure reproducibility ✅ **Review dependency updates** before merging ✅ **Test","content":"Development Workflow ✅ Use **latest tags** during active development ✅ **Pin versions** for production deployments ✅ **Commit lock files** to ensure reproducibility ✅ **Review dependency updates** before merging ✅ **Test after updates** to catch compatibility issues"},{"id":"cli/package-manager/package-manager::security::80","title":"Package Manager","section":"Security","path":"/docs/guide/cli/package-manager/package-manager#security","headings":["Security"],"excerpt":"Security ✅ **Pin to specific versions** in production ✅ **Use SSH keys** for private repositories ✅ **Review new dependencies** for security implications ✅ **Monitor for vulnerabilities** in dependencies ❌ **Don't embed ","content":"Security ✅ **Pin to specific versions** in production ✅ **Use SSH keys** for private repositories ✅ **Review new dependencies** for security implications ✅ **Monitor for vulnerabilities** in dependencies ❌ **Don't embed credentials** in configuration files"},{"id":"cli/package-manager/package-manager::performance::81","title":"Package Manager","section":"Performance","path":"/docs/guide/cli/package-manager/package-manager#performance","headings":["Performance"],"excerpt":"Performance ✅ **Cache aggressively** in CI/CD systems ✅ **Use vendoring** for frequently rebuilt projects ✅ **Clean old cache** periodically to save space ✅ **Use shared cache** for team environments","content":"Performance ✅ **Cache aggressively** in CI/CD systems ✅ **Use vendoring** for frequently rebuilt projects ✅ **Clean old cache** periodically to save space ✅ **Use shared cache** for team environments"},{"id":"cli/package-manager/package-manager::team-collaboration::82","title":"Package Manager","section":"Team Collaboration","path":"/docs/guide/cli/package-manager/package-manager#team-collaboration","headings":["Team Collaboration"],"excerpt":"Team Collaboration ✅ **Document authentication setup** for new team members ✅ **Use consistent tooling** across environments ✅ **Automate dependency updates** with proper testing ✅ **Share cache locations** when possible","content":"Team Collaboration ✅ **Document authentication setup** for new team members ✅ **Use consistent tooling** across environments ✅ **Automate dependency updates** with proper testing ✅ **Share cache locations** when possible"},{"id":"cli/package-manager/package-manager::team-collaboration::83","title":"Package Manager","section":"Team Collaboration","path":"/docs/guide/cli/package-manager/package-manager#team-collaboration","headings":["Team Collaboration"],"excerpt":"Team Collaboration The EasyP package manager provides a robust, decentralized solution for protobuf dependency management that scales from individual projects to enterprise environments while maintaining the simplicity a","content":"Team Collaboration The EasyP package manager provides a robust, decentralized solution for protobuf dependency management that scales from individual projects to enterprise environments while maintaining the simplicity and reliability developers expect."},{"id":"introduction/install::install-from-systems-package-manager::0","title":"Install the EasyP cli","section":"Install from system's package manager","path":"/docs/guide/introduction/install#install-from-systems-package-manager","headings":["Install from system's package manager"],"excerpt":"Install from system's package manager","content":"Install from system's package manager"},{"id":"introduction/install::recommended-installation-method::1","title":"Install the EasyP cli","section":"Recommended installation method","path":"/docs/guide/introduction/install#recommended-installation-method","headings":["Recommended installation method"],"excerpt":"Recommended installation method","content":"Recommended installation method"},{"id":"introduction/install::homebrew::2","title":"Install the EasyP cli","section":"Homebrew","path":"/docs/guide/introduction/install#homebrew","headings":["Homebrew"],"excerpt":"Homebrew You can install a binary release on macOS using brew:","content":"Homebrew You can install a binary release on macOS using brew:"},{"id":"introduction/install::homebrew::3","title":"Install the EasyP cli","section":"Homebrew","path":"/docs/guide/introduction/install#homebrew","headings":["Homebrew"],"excerpt":"Homebrew Work in progress apt, yum, pacman, etc.","content":"Homebrew Work in progress apt, yum, pacman, etc."},{"id":"introduction/install::_not-recommended_::4","title":"Install the EasyP cli","section":"_Not recommended_","path":"/docs/guide/introduction/install#_not-recommended_","headings":["_Not recommended_"],"excerpt":"_Not recommended_ Local installation is not recommended because package managers provide: Automatic updates and security patches Better integration with system package management Easier installation and removal process V","content":"_Not recommended_ Local installation is not recommended because package managers provide: Automatic updates and security patches Better integration with system package management Easier installation and removal process Verified and signed binaries"},{"id":"introduction/install::go-install::5","title":"Install the EasyP cli","section":"Go install","path":"/docs/guide/introduction/install#go-install","headings":["Go install"],"excerpt":"Go install It will install the latest stable version of easyp.","content":"Go install It will install the latest stable version of easyp."},{"id":"introduction/install::build-from-source::6","title":"Install the EasyP cli","section":"Build from source","path":"/docs/guide/introduction/install#build-from-source","headings":["Build from source"],"excerpt":"Build from source Clone repository","content":"Build from source Clone repository"},{"id":"introduction/install::build-from-source::7","title":"Install the EasyP cli","section":"Build from source","path":"/docs/guide/introduction/install#build-from-source","headings":["Build from source"],"excerpt":"Build from source Build by golang","content":"Build from source Build by golang"},{"id":"introduction/quickstart::top::0","title":"Quickstart","path":"/docs/guide/introduction/quickstart","headings":[],"excerpt":"EasyP is a modern toolkit for working with Protobuf files. In this quickstart, you'll learn to:","content":"EasyP is a modern toolkit for working with Protobuf files. In this quickstart, you'll learn to:"},{"id":"introduction/quickstart::top::1","title":"Quickstart","path":"/docs/guide/introduction/quickstart","headings":[],"excerpt":"**Initialize** your project with EasyP configuration **Set up linting** to catch errors and ensure best practices **Manage dependencies** from Git repositories **Generate code** from your Protobuf files","content":"**Initialize** your project with EasyP configuration **Set up linting** to catch errors and ensure best practices **Manage dependencies** from Git repositories **Generate code** from your Protobuf files"},{"id":"introduction/quickstart::prerequisites::2","title":"Quickstart","section":"Prerequisites","path":"/docs/guide/introduction/quickstart#prerequisites","headings":["Prerequisites"],"excerpt":"Prerequisites Before you begin, make sure you have:","content":"Prerequisites Before you begin, make sure you have:"},{"id":"introduction/quickstart::prerequisites::3","title":"Quickstart","section":"Prerequisites","path":"/docs/guide/introduction/quickstart#prerequisites","headings":["Prerequisites"],"excerpt":"Prerequisites **EasyP CLI installed** - See Installation guide if you haven't already **Git** installed and in your $PATH **Protobuf files** ready to work with (or create some as you go)","content":"Prerequisites **EasyP CLI installed** - See Installation guide if you haven't already **Git** installed and in your $PATH **Protobuf files** ready to work with (or create some as you go)"},{"id":"introduction/quickstart::prerequisites::4","title":"Quickstart","section":"Prerequisites","path":"/docs/guide/introduction/quickstart#prerequisites","headings":["Prerequisites"],"excerpt":"Prerequisites You can verify your installation:","content":"Prerequisites You can verify your installation:"},{"id":"introduction/quickstart::initialize-your-project::5","title":"Quickstart","section":"Initialize your project","path":"/docs/guide/introduction/quickstart#initialize-your-project","headings":["Initialize your project"],"excerpt":"Initialize your project Start by creating an easyp.yaml configuration file in your project root:","content":"Initialize your project Start by creating an easyp.yaml configuration file in your project root:"},{"id":"introduction/quickstart::initialize-your-project::6","title":"Quickstart","section":"Initialize your project","path":"/docs/guide/introduction/quickstart#initialize-your-project","headings":["Initialize your project"],"excerpt":"Initialize your project This command generates a commented template with default lint and breaking settings. easyp init is interactive: if buf.yml/buf.yaml exists in the target root, EasyP asks whether to migrate it; if ","content":"Initialize your project This command generates a commented template with default lint and breaking settings. easyp init is interactive: if buf.yml/buf.yaml exists in the target root, EasyP asks whether to migrate it; if easyp.yaml already exists, it asks before overwriting."},{"id":"introduction/quickstart::configure-linting::7","title":"Quickstart","section":"Configure linting","path":"/docs/guide/introduction/quickstart#configure-linting","headings":["Configure linting"],"excerpt":"Configure linting Linting helps catch errors and ensures your Protobuf files follow best practices. EasyP provides default rules compatible with Buf standards.","content":"Configure linting Linting helps catch errors and ensures your Protobuf files follow best practices. EasyP provides default rules compatible with Buf standards."},{"id":"introduction/quickstart::configure-linting::8","title":"Quickstart","section":"Configure linting","path":"/docs/guide/introduction/quickstart#configure-linting","headings":["Configure linting"],"excerpt":"Configure linting easyp init already generates a lint section. Adjust it if needed, for example:","content":"Configure linting easyp init already generates a lint section. Adjust it if needed, for example:"},{"id":"introduction/quickstart::configure-linting::9","title":"Quickstart","section":"Configure linting","path":"/docs/guide/introduction/quickstart#configure-linting","headings":["Configure linting"],"excerpt":"Configure linting Now you can run the linter:","content":"Configure linting Now you can run the linter:"},{"id":"introduction/quickstart::configure-linting::10","title":"Quickstart","section":"Configure linting","path":"/docs/guide/introduction/quickstart#configure-linting","headings":["Configure linting"],"excerpt":"Configure linting The linter will check all your .proto files and report any issues found.","content":"Configure linting The linter will check all your .proto files and report any issues found."},{"id":"introduction/quickstart::configure-linting::11","title":"Quickstart","section":"Configure linting","path":"/docs/guide/introduction/quickstart#configure-linting","headings":["Configure linting"],"excerpt":"Configure linting ::: tip EasyP's linting rules are 100% compatible with Buf, making migration easy if you're switching tools. :::","content":"Configure linting ::: tip EasyP's linting rules are 100% compatible with Buf, making migration easy if you're switching tools. :::"},{"id":"introduction/quickstart::manage-dependencies::12","title":"Quickstart","section":"Manage dependencies","path":"/docs/guide/introduction/quickstart#manage-dependencies","headings":["Manage dependencies"],"excerpt":"Manage dependencies If your project uses third-party Protobuf packages (like Google APIs or gRPC Gateway), EasyP makes it easy to manage them.","content":"Manage dependencies If your project uses third-party Protobuf packages (like Google APIs or gRPC Gateway), EasyP makes it easy to manage them."},{"id":"introduction/quickstart::dependency-format::13","title":"Quickstart","section":"Dependency format","path":"/docs/guide/introduction/quickstart#dependency-format","headings":["Dependency format"],"excerpt":"Dependency format Dependencies use a simple format: $GIT_LINK@$VERSION","content":"Dependency format Dependencies use a simple format: $GIT_LINK@$VERSION"},{"id":"introduction/quickstart::dependency-format::14","title":"Quickstart","section":"Dependency format","path":"/docs/guide/introduction/quickstart#dependency-format","headings":["Dependency format"],"excerpt":"Dependency format **$GIT_LINK** - URL to any Git repository (GitHub, GitLab, etc.) **$VERSION** - Git tag or commit hash (optional)","content":"Dependency format **$GIT_LINK** - URL to any Git repository (GitHub, GitLab, etc.) **$VERSION** - Git tag or commit hash (optional)"},{"id":"introduction/quickstart::dependency-format::15","title":"Quickstart","section":"Dependency format","path":"/docs/guide/introduction/quickstart#dependency-format","headings":["Dependency format"],"excerpt":"Dependency format If you omit the version, EasyP downloads the latest commit from the default branch.","content":"Dependency format If you omit the version, EasyP downloads the latest commit from the default branch."},{"id":"introduction/quickstart::add-dependencies::16","title":"Quickstart","section":"Add dependencies","path":"/docs/guide/introduction/quickstart#add-dependencies","headings":["Add dependencies"],"excerpt":"Add dependencies Update your easyp.yaml to include dependencies:","content":"Add dependencies Update your easyp.yaml to include dependencies:"},{"id":"introduction/quickstart::download-dependencies::17","title":"Quickstart","section":"Download dependencies","path":"/docs/guide/introduction/quickstart#download-dependencies","headings":["Download dependencies"],"excerpt":"Download dependencies Download the packages you specified:","content":"Download dependencies Download the packages you specified:"},{"id":"introduction/quickstart::download-dependencies::18","title":"Quickstart","section":"Download dependencies","path":"/docs/guide/introduction/quickstart#download-dependencies","headings":["Download dependencies"],"excerpt":"Download dependencies This command: Downloads dependencies from easyp.lock if it exists Otherwise, downloads from easyp.yaml and creates easyp.lock","content":"Download dependencies This command: Downloads dependencies from easyp.lock if it exists Otherwise, downloads from easyp.yaml and creates easyp.lock"},{"id":"introduction/quickstart::download-dependencies::19","title":"Quickstart","section":"Download dependencies","path":"/docs/guide/introduction/quickstart#download-dependencies","headings":["Download dependencies"],"excerpt":"Download dependencies ::: info **Tip:** Use easyp mod update to ignore the lock file and fetch the latest versions from easyp.yaml. :::","content":"Download dependencies ::: info **Tip:** Use easyp mod update to ignore the lock file and fetch the latest versions from easyp.yaml. :::"},{"id":"introduction/quickstart::generate-code::20","title":"Quickstart","section":"Generate code","path":"/docs/guide/introduction/quickstart#generate-code","headings":["Generate code"],"excerpt":"Generate code Now let's configure code generation. EasyP supports all standard Protobuf plugins.","content":"Generate code Now let's configure code generation. EasyP supports all standard Protobuf plugins."},{"id":"introduction/quickstart::configure-generation::21","title":"Quickstart","section":"Configure generation","path":"/docs/guide/introduction/quickstart#configure-generation","headings":["Configure generation"],"excerpt":"Configure generation Add plugin configuration to your easyp.yaml:","content":"Configure generation Add plugin configuration to your easyp.yaml:"},{"id":"introduction/quickstart::run-code-generation::22","title":"Quickstart","section":"Run code generation","path":"/docs/guide/introduction/quickstart#run-code-generation","headings":["Run code generation"],"excerpt":"Run code generation Generate your code stubs:","content":"Run code generation Generate your code stubs:"},{"id":"introduction/quickstart::run-code-generation::23","title":"Quickstart","section":"Run code generation","path":"/docs/guide/introduction/quickstart#run-code-generation","headings":["Run code generation"],"excerpt":"Run code generation EasyP will: Resolve all dependencies Connect to the EasyP service (or run locally) Execute the configured plugins Output generated code to the specified directories","content":"Run code generation EasyP will: Resolve all dependencies Connect to the EasyP service (or run locally) Execute the configured plugins Output generated code to the specified directories"},{"id":"introduction/quickstart::run-code-generation::24","title":"Quickstart","section":"Run code generation","path":"/docs/guide/introduction/quickstart#run-code-generation","headings":["Run code generation"],"excerpt":"Run code generation ::: tip EasyP uses a hybrid runtime with WASM for speed and Docker for heavy plugins, giving you the best of both worlds. :::","content":"Run code generation ::: tip EasyP uses a hybrid runtime with WASM for speed and Docker for heavy plugins, giving you the best of both worlds. :::"},{"id":"introduction/quickstart::next-steps::25","title":"Quickstart","section":"Next steps","path":"/docs/guide/introduction/quickstart#next-steps","headings":["Next steps"],"excerpt":"Next steps Congratulations! 🎉 You've successfully: ✅ Initialized an EasyP project ✅ Configured linting rules ✅ Managed third-party dependencies ✅ Generated code from your Protobuf files","content":"Next steps Congratulations! 🎉 You've successfully: ✅ Initialized an EasyP project ✅ Configured linting rules ✅ Managed third-party dependencies ✅ Generated code from your Protobuf files"},{"id":"introduction/quickstart::learn-more::26","title":"Quickstart","section":"Learn more","path":"/docs/guide/introduction/quickstart#learn-more","headings":["Learn more"],"excerpt":"Learn more **CLI Reference** - Deep dive into all CLI commands **API Service** - Set up remote code generation **Configuration** - Explore all configuration options","content":"Learn more **CLI Reference** - Deep dive into all CLI commands **API Service** - Set up remote code generation **Configuration** - Explore all configuration options"},{"id":"introduction/quickstart::learn-more::27","title":"Quickstart","section":"Learn more","path":"/docs/guide/introduction/quickstart#learn-more","headings":["Learn more"],"excerpt":"Learn more *Enjoy working with Protobuf without any pain! 🚀*","content":"Learn more *Enjoy working with Protobuf without any pain! 🚀*"},{"id":"introduction/what-is::top::0","title":"What is EasyP?","path":"/docs/guide/introduction/what-is","headings":[],"excerpt":"EasyP is a modern Protocol Buffers toolkit that consolidates your entire protobuf workflow into a single, powerful CLI tool. It combines linting, package management, code generation, and compatibility checking in a unifi","content":"EasyP is a modern Protocol Buffers toolkit that consolidates your entire protobuf workflow into a single, powerful CLI tool. It combines linting, package management, code generation, and compatibility checking in a unified interface designed to eliminate the complexity of traditional protobuf development."},{"id":"introduction/what-is::top::1","title":"What is EasyP?","path":"/docs/guide/introduction/what-is","headings":[],"excerpt":"Just want to try it out? Skip to the Quickstart.","content":"Just want to try it out? Skip to the Quickstart."},{"id":"introduction/what-is::the-problem-fragmented-proto-workflows::2","title":"What is EasyP?","section":"The Problem: Fragmented Proto Workflows","path":"/docs/guide/introduction/what-is#the-problem-fragmented-proto-workflows","headings":["The Problem: Fragmented Proto Workflows"],"excerpt":"The Problem: Fragmented Proto Workflows Working with Protocol Buffers across projects creates unnecessary complexity and friction:","content":"The Problem: Fragmented Proto Workflows Working with Protocol Buffers across projects creates unnecessary complexity and friction:"},{"id":"introduction/what-is::tool-chaos::3","title":"What is EasyP?","section":"Tool Chaos","path":"/docs/guide/introduction/what-is#tool-chaos","headings":["Tool Chaos"],"excerpt":"Tool Chaos **Multiple tools for different tasks**: Separate tools for linting, generation, and dependency management **Inconsistent configurations**: Different config formats across projects and teams **Complex setup**: ","content":"Tool Chaos **Multiple tools for different tasks**: Separate tools for linting, generation, and dependency management **Inconsistent configurations**: Different config formats across projects and teams **Complex setup**: Time-consuming onboarding for new developers joining projects"},{"id":"introduction/what-is::dependency-management-issues::4","title":"What is EasyP?","section":"Dependency Management Issues","path":"/docs/guide/introduction/what-is#dependency-management-issues","headings":["Dependency Management Issues"],"excerpt":"Dependency Management Issues **No standardized approach**: Each project handles proto dependencies differently **Version conflicts**: Difficult to resolve conflicts between different proto libraries **Build reproducibili","content":"Dependency Management Issues **No standardized approach**: Each project handles proto dependencies differently **Version conflicts**: Difficult to resolve conflicts between different proto libraries **Build reproducibility**: Hard to ensure consistent builds across environments"},{"id":"introduction/what-is::development-friction::5","title":"What is EasyP?","section":"Development Friction","path":"/docs/guide/introduction/what-is#development-friction","headings":["Development Friction"],"excerpt":"Development Friction **Manual processes**: Repetitive workflows for common proto tasks **Configuration sprawl**: Multiple config files with different formats **Time-consuming compatibility checks**: Manual verification o","content":"Development Friction **Manual processes**: Repetitive workflows for common proto tasks **Configuration sprawl**: Multiple config files with different formats **Time-consuming compatibility checks**: Manual verification of API changes"},{"id":"introduction/what-is::the-solution-unified-proto-toolkit::6","title":"What is EasyP?","section":"The Solution: Unified Proto Toolkit","path":"/docs/guide/introduction/what-is#the-solution-unified-proto-toolkit","headings":["The Solution: Unified Proto Toolkit"],"excerpt":"The Solution: Unified Proto Toolkit EasyP addresses these challenges by providing a comprehensive, opinionated toolkit that standardizes protobuf workflows:","content":"The Solution: Unified Proto Toolkit EasyP addresses these challenges by providing a comprehensive, opinionated toolkit that standardizes protobuf workflows:"},{"id":"introduction/what-is::one-tool-all-tasks::7","title":"What is EasyP?","section":"One Tool, All Tasks","path":"/docs/guide/introduction/what-is#one-tool-all-tasks","headings":["One Tool, All Tasks"],"excerpt":"One Tool, All Tasks Instead of juggling multiple tools, EasyP provides everything you need: **Linting** with comprehensive rule sets **Package management** with Git-native dependencies **Code generation** with local and ","content":"One Tool, All Tasks Instead of juggling multiple tools, EasyP provides everything you need: **Linting** with comprehensive rule sets **Package management** with Git-native dependencies **Code generation** with local and remote plugin support **Breaking change detection** for API compatibility"},{"id":"introduction/what-is::standardized-configuration::8","title":"What is EasyP?","section":"Standardized Configuration","path":"/docs/guide/introduction/what-is#standardized-configuration","headings":["Standardized Configuration"],"excerpt":"Standardized Configuration A single easyp.yaml file configures your entire protobuf workflow, eliminating configuration sprawl and ensuring consistency across projects.","content":"Standardized Configuration A single easyp.yaml file configures your entire protobuf workflow, eliminating configuration sprawl and ensuring consistency across projects."},{"id":"introduction/what-is::git-native-dependencies::9","title":"What is EasyP?","section":"Git-Native Dependencies","path":"/docs/guide/introduction/what-is#git-native-dependencies","headings":["Git-Native Dependencies"],"excerpt":"Git-Native Dependencies Direct integration with Git repositories for proto dependencies eliminates the need for centralized registries while providing version control and reproducibility.","content":"Git-Native Dependencies Direct integration with Git repositories for proto dependencies eliminates the need for centralized registries while providing version control and reproducibility."},{"id":"introduction/what-is::key-features::10","title":"What is EasyP?","section":"Key Features","path":"/docs/guide/introduction/what-is#key-features","headings":["Key Features"],"excerpt":"Key Features Feature Description --------- ------------- 🔍 **Comprehensive Linting** Built-in support for buf's linting rules with customizable configurations to enforce API design best practices. 📦 **Smart Package Man","content":"Key Features Feature Description --------- ------------- 🔍 **Comprehensive Linting** Built-in support for buf's linting rules with customizable configurations to enforce API design best practices. 📦 **Smart Package Manager** Git-based dependency management with lock file support for reproducible builds across environments. ⚡ **Code Generation** Multi-language code generation with support for both local protoc plugins and remote plugin execution. 🔄 **Breaking Change Detection** Automated API compatibility verification against Git branches to prevent accidental breaking changes. 🌐 **Remote Plugin Support** Execute plugins via centralized EasyP API service for consistent, isolated execution without local dependencies. 🎯 **Developer Experience** Auto-completion, intuitive commands, clear error messages, and comprehensive documentation."},{"id":"introduction/what-is::supported-plugin-types::11","title":"What is EasyP?","section":"Supported Plugin Types","path":"/docs/guide/introduction/what-is#supported-plugin-types","headings":["Supported Plugin Types"],"excerpt":"Supported Plugin Types EasyP provides flexibility in how you execute code generation plugins:","content":"Supported Plugin Types EasyP provides flexibility in how you execute code generation plugins:"},{"id":"introduction/what-is::local-plugins::12","title":"What is EasyP?","section":"Local Plugins","path":"/docs/guide/introduction/what-is#local-plugins","headings":["Local Plugins"],"excerpt":"Local Plugins Standard protoc plugins installed on your system:","content":"Local Plugins Standard protoc plugins installed on your system:"},{"id":"introduction/what-is::remote-plugins::13","title":"What is EasyP?","section":"Remote Plugins","path":"/docs/guide/introduction/what-is#remote-plugins","headings":["Remote Plugins"],"excerpt":"Remote Plugins Plugins executed via EasyP API service for consistent results:","content":"Remote Plugins Plugins executed via EasyP API service for consistent results:"},{"id":"introduction/what-is::custom-plugins::14","title":"What is EasyP?","section":"Custom Plugins","path":"/docs/guide/introduction/what-is#custom-plugins","headings":["Custom Plugins"],"excerpt":"Custom Plugins Support for custom plugin development and distribution through the ecosystem.","content":"Custom Plugins Support for custom plugin development and distribution through the ecosystem."},{"id":"introduction/what-is::decentralized-package-management::15","title":"What is EasyP?","section":"Decentralized Package Management","path":"/docs/guide/introduction/what-is#decentralized-package-management","headings":["Decentralized Package Management"],"excerpt":"Decentralized Package Management Unlike other tools, EasyP doesn't rely on a centralized server for package distribution. Instead, any Git repository can serve as a package source, giving you:","content":"Decentralized Package Management Unlike other tools, EasyP doesn't rely on a centralized server for package distribution. Instead, any Git repository can serve as a package source, giving you:"},{"id":"introduction/what-is::decentralized-package-management::16","title":"What is EasyP?","section":"Decentralized Package Management","path":"/docs/guide/introduction/what-is#decentralized-package-management","headings":["Decentralized Package Management"],"excerpt":"Decentralized Package Management **Flexibility and Control**: Use any Git hosting service (GitHub, GitLab, self-hosted) **No Vendor Lock-in**: Your dependencies aren't tied to a specific registry **Version Control**: Ful","content":"Decentralized Package Management **Flexibility and Control**: Use any Git hosting service (GitHub, GitLab, self-hosted) **No Vendor Lock-in**: Your dependencies aren't tied to a specific registry **Version Control**: Full Git history and branching for your proto dependencies **Enterprise-Friendly**: Works with private repositories and corporate Git infrastructure"},{"id":"introduction/what-is::seamless-migration-from-buf::17","title":"What is EasyP?","section":"Seamless Migration from Buf","path":"/docs/guide/introduction/what-is#seamless-migration-from-buf","headings":["Seamless Migration from Buf"],"excerpt":"Seamless Migration from Buf EasyP is designed with buf compatibility in mind:","content":"Seamless Migration from Buf EasyP is designed with buf compatibility in mind:"},{"id":"introduction/what-is::seamless-migration-from-buf::18","title":"What is EasyP?","section":"Seamless Migration from Buf","path":"/docs/guide/introduction/what-is#seamless-migration-from-buf","headings":["Seamless Migration from Buf"],"excerpt":"Seamless Migration from Buf **Compatible rule sets**: Uses the same linting rules as buf **Familiar configuration**: Similar YAML structure with enhanced features **Drop-in replacement**: Can often replace buf with minim","content":"Seamless Migration from Buf **Compatible rule sets**: Uses the same linting rules as buf **Familiar configuration**: Similar YAML structure with enhanced features **Drop-in replacement**: Can often replace buf with minimal configuration changes **Gradual migration**: Adopt EasyP features incrementally without disrupting existing workflows"},{"id":"introduction/what-is::easyp-vs-bufbuild-comparison::19","title":"What is EasyP?","section":"EasyP vs buf.build Comparison","path":"/docs/guide/introduction/what-is#easyp-vs-bufbuild-comparison","headings":["EasyP vs buf.build Comparison"],"excerpt":"EasyP vs buf.build Comparison Feature EasyP buf.build --------- -------- ----------- **Dependency Management** Git-based repositories Buf Schema Registry (BSR) **Vendor Lock-in** None - works with any Git hosting Tied to","content":"EasyP vs buf.build Comparison Feature EasyP buf.build --------- -------- ----------- **Dependency Management** Git-based repositories Buf Schema Registry (BSR) **Vendor Lock-in** None - works with any Git hosting Tied to BSR for full features **Plugin Execution** Local + Remote plugins Local + BSR plugins **Private Dependencies** Any Git provider (GitHub, GitLab, etc.) BSR or manual management **Offline Development** Full support with mod vendor Limited without BSR access **Enterprise Integration** Works with existing Git infrastructure Requires BSR setup **Breaking Change Detection** Against any Git reference Against any Git reference **Package Distribution** Any Git repository BSR required for publishing **License** Apache 2.0 Apache 2.0 **Community** Growing Established"},{"id":"introduction/what-is::easyp-vs-bufbuild-comparison::20","title":"What is EasyP?","section":"EasyP vs buf.build Comparison","path":"/docs/guide/introduction/what-is#easyp-vs-bufbuild-comparison","headings":["EasyP vs buf.build Comparison"],"excerpt":"EasyP vs buf.build Comparison **Migration Benefits:** **No infrastructure changes**: Continue using your existing Git repositories **Gradual adoption**: Start with EasyP while keeping existing buf configurations **Enhanc","content":"EasyP vs buf.build Comparison **Migration Benefits:** **No infrastructure changes**: Continue using your existing Git repositories **Gradual adoption**: Start with EasyP while keeping existing buf configurations **Enhanced flexibility**: Access to both local and remote plugin execution **Simplified workflows**: Single configuration file for all protobuf operations"},{"id":"introduction/what-is::our-goals-for-protobuf::21","title":"What is EasyP?","section":"Our Goals for Protobuf","path":"/docs/guide/introduction/what-is#our-goals-for-protobuf","headings":["Our Goals for Protobuf"],"excerpt":"Our Goals for Protobuf EasyP's mission is to accelerate the adoption of **schema-driven API development** by making Protocol Buffers more accessible and reliable:","content":"Our Goals for Protobuf EasyP's mission is to accelerate the adoption of **schema-driven API development** by making Protocol Buffers more accessible and reliable:"},{"id":"introduction/what-is::modern-protobuf-ecosystem::22","title":"What is EasyP?","section":"Modern Protobuf Ecosystem","path":"/docs/guide/introduction/what-is#modern-protobuf-ecosystem","headings":["Modern Protobuf Ecosystem"],"excerpt":"Modern Protobuf Ecosystem We're building on Protobuf's proven foundation to create a modern development experience that rivals the simplicity of REST/JSON while providing superior type safety and performance.","content":"Modern Protobuf Ecosystem We're building on Protobuf's proven foundation to create a modern development experience that rivals the simplicity of REST/JSON while providing superior type safety and performance."},{"id":"introduction/what-is::developer-experience-first::23","title":"What is EasyP?","section":"Developer Experience First","path":"/docs/guide/introduction/what-is#developer-experience-first","headings":["Developer Experience First"],"excerpt":"Developer Experience First Every feature is designed with developer productivity in mind, from intuitive CLI commands to comprehensive error messages and documentation.","content":"Developer Experience First Every feature is designed with developer productivity in mind, from intuitive CLI commands to comprehensive error messages and documentation."},{"id":"introduction/what-is::enterprise-ready::24","title":"What is EasyP?","section":"Enterprise Ready","path":"/docs/guide/introduction/what-is#enterprise-ready","headings":["Enterprise Ready"],"excerpt":"Enterprise Ready Built for teams and organizations with features like reproducible builds, private repository support, and comprehensive CI/CD integration.","content":"Enterprise Ready Built for teams and organizations with features like reproducible builds, private repository support, and comprehensive CI/CD integration."},{"id":"introduction/what-is::for-individual-developers::25","title":"What is EasyP?","section":"For Individual Developers","path":"/docs/guide/introduction/what-is#for-individual-developers","headings":["For Individual Developers"],"excerpt":"For Individual Developers **Quick Setup**: Get started with protobuf projects in minutes, not hours **Unified Workflow**: One tool for all your protobuf needs **Clear Documentation**: Comprehensive guides and examples","content":"For Individual Developers **Quick Setup**: Get started with protobuf projects in minutes, not hours **Unified Workflow**: One tool for all your protobuf needs **Clear Documentation**: Comprehensive guides and examples"},{"id":"introduction/what-is::for-teams::26","title":"What is EasyP?","section":"For Teams","path":"/docs/guide/introduction/what-is#for-teams","headings":["For Teams"],"excerpt":"For Teams **Consistent Standards**: Enforced linting rules and formatting across all projects **Reproducible Builds**: Lock files ensure everyone builds the same way **Easy Onboarding**: New team members can be productiv","content":"For Teams **Consistent Standards**: Enforced linting rules and formatting across all projects **Reproducible Builds**: Lock files ensure everyone builds the same way **Easy Onboarding**: New team members can be productive immediately"},{"id":"introduction/what-is::for-organizations::27","title":"What is EasyP?","section":"For Organizations","path":"/docs/guide/introduction/what-is#for-organizations","headings":["For Organizations"],"excerpt":"For Organizations **No Vendor Lock-in**: Git-based dependencies work with your existing infrastructure **Enterprise Security**: Support for private repositories and custom authentication **CI/CD Ready**: Designed for aut","content":"For Organizations **No Vendor Lock-in**: Git-based dependencies work with your existing infrastructure **Enterprise Security**: Support for private repositories and custom authentication **CI/CD Ready**: Designed for automated workflows and continuous integration"},{"id":"introduction/what-is::whats-next::28","title":"What is EasyP?","section":"What's Next?","path":"/docs/guide/introduction/what-is#whats-next","headings":["What's Next?"],"excerpt":"What's Next? EasyP simplifies protobuf development so you can focus on building great APIs instead of managing toolchain complexity. Whether you're starting a new project or migrating from existing tools, EasyP provides ","content":"What's Next? EasyP simplifies protobuf development so you can focus on building great APIs instead of managing toolchain complexity. Whether you're starting a new project or migrating from existing tools, EasyP provides a smooth path to modern protobuf development."},{"id":"introduction/what-is::whats-next::29","title":"What is EasyP?","section":"What's Next?","path":"/docs/guide/introduction/what-is#whats-next","headings":["What's Next?"],"excerpt":"What's Next? Ready to get started? Check out our Installation Guide and Quickstart Tutorial.","content":"What's Next? Ready to get started? Check out our Installation Guide and Quickstart Tutorial."},{"id":"introduction/what-is::stargazers-over-time::30","title":"What is EasyP?","section":"Stargazers over time","path":"/docs/guide/introduction/what-is#stargazers-over-time","headings":["Stargazers over time"],"excerpt":"Stargazers over time Stargazers over time","content":"Stargazers over time Stargazers over time"},{"id":"migration/buf-cli::top::0","title":"Buf CLI","path":"/docs/guide/migration/buf-cli","headings":[],"excerpt":"Buf CLI Work in progress","content":"Buf CLI Work in progress"},{"id":"migration/protoc::top::0","title":"Protoc","path":"/docs/guide/migration/protoc","headings":[],"excerpt":"Protoc Work in progress","content":"Protoc Work in progress"},{"id":"migration/protolock::top::0","title":"Protolock","path":"/docs/guide/migration/protolock","headings":[],"excerpt":"Protolock Work in progress","content":"Protolock Work in progress"},{"id":"migration/prototool::top::0","title":"Prototool","path":"/docs/guide/migration/prototool","headings":[],"excerpt":"Prototool Work in progress","content":"Prototool Work in progress"}]
\ No newline at end of file
diff --git a/docs/public/search/index.ru.json b/docs/public/search/index.ru.json
deleted file mode 100644
index 3ce4ae7b..00000000
--- a/docs/public/search/index.ru.json
+++ /dev/null
@@ -1 +0,0 @@
-[{"id":"api-service/overview::top::0","title":"Обзор API Service","path":"/docs/guide/api-service/overview","headings":[],"excerpt":"**Централизованный сервис выполнения protobuf‑плагинов для консистентной изолированной генерации кода**","content":"**Централизованный сервис выполнения protobuf‑плагинов для консистентной изолированной генерации кода**"},{"id":"api-service/overview::top::1","title":"Обзор API Service","path":"/docs/guide/api-service/overview","headings":[],"excerpt":"EasyP API Service устраняет хаос управления плагинами, предоставляя централизованный запуск protobuf/gRPC плагинов в изолированных Docker‑контейнерах. Он даёт единую платформу, позволяющую командам стандартизировать проц","content":"EasyP API Service устраняет хаос управления плагинами, предоставляя централизованный запуск protobuf/gRPC плагинов в изолированных Docker‑контейнерах. Он даёт единую платформу, позволяющую командам стандартизировать процесс генерации кода без операционных затрат на установку и поддержку плагинов на машинах разработчиков."},{"id":"api-service/overview::easyp-api-service::2","title":"Обзор API Service","section":"Зачем нужен EasyP API Service?","path":"/docs/guide/api-service/overview#easyp-api-service","headings":["Зачем нужен EasyP API Service?"],"excerpt":"Зачем нужен EasyP API Service?","content":"Зачем нужен EasyP API Service?"},{"id":"api-service/overview::top::3","title":"Обзор API Service","section":"Проблема","path":"/docs/guide/api-service/overview","headings":["Проблема"],"excerpt":"Проблема Управление генерацией protobuf/gRPC кода в командах порождает существенную операционную сложность:","content":"Проблема Управление генерацией protobuf/gRPC кода в командах порождает существенную операционную сложность:"},{"id":"api-service/overview::top::4","title":"Обзор API Service","section":"Несогласованность версий","path":"/docs/guide/api-service/overview","headings":["Несогласованность версий"],"excerpt":"Несогласованность версий Разработчики локально используют разные версии плагинов → расхождения в генерированном коде и падения сборки Синдром «у меня работает» при различиях окружений Требуется ручная координация, чтобы ","content":"Несогласованность версий Разработчики локально используют разные версии плагинов → расхождения в генерированном коде и падения сборки Синдром «у меня работает» при различиях окружений Требуется ручная координация, чтобы вся команда была синхронизирована по версиям"},{"id":"api-service/overview::top::5","title":"Обзор API Service","section":"Операционные накладные расходы","path":"/docs/guide/api-service/overview","headings":["Операционные накладные расходы"],"excerpt":"Операционные накладные расходы DevOps тратят время на установку и обновление плагинов на рабочих станциях Новый разработчик — ручная настройка правильных версий Обновление плагинов требует коммуникации с каждым отдельно ","content":"Операционные накладные расходы DevOps тратят время на установку и обновление плагинов на рабочих станциях Новый разработчик — ручная настройка правильных версий Обновление плагинов требует коммуникации с каждым отдельно Нет централизованного контроля утверждённых версий"},{"id":"api-service/overview::top::6","title":"Обзор API Service","section":"Риски безопасности и комплаенса","path":"/docs/guide/api-service/overview","headings":["Риски безопасности и комплаенса"],"excerpt":"Риски безопасности и комплаенса Плагины ставятся из разных источников без валидации Нет аудита: какой плагин для какого билда использовался Сложно применять политики безопасности к инструментам генерации","content":"Риски безопасности и комплаенса Плагины ставятся из разных источников без валидации Нет аудита: какой плагин для какого билда использовался Сложно применять политики безопасности к инструментам генерации"},{"id":"api-service/overview::top::7","title":"Обзор API Service","section":"Решение: централизованный запуск плагинов","path":"/docs/guide/api-service/overview","headings":["Решение: централизованный запуск плагинов"],"excerpt":"Решение: централизованный запуск плагинов EasyP API Service решает эти проблемы за счёт централизованного управления:","content":"Решение: централизованный запуск плагинов EasyP API Service решает эти проблемы за счёт централизованного управления:"},{"id":"api-service/overview::top::8","title":"Обзор API Service","section":"Решение: централизованный запуск плагинов","path":"/docs/guide/api-service/overview","headings":["Решение: централизованный запуск плагинов"],"excerpt":"Решение: централизованный запуск плагинов Проблема Решение ---------- --------- **Контроль версий** Мгновенное распространение новых версий через Docker‑образы **Операции** Команда эксплуатации управляет конфигурациями б","content":"Решение: централизованный запуск плагинов Проблема Решение ---------- --------- **Контроль версий** Мгновенное распространение новых версий через Docker‑образы **Операции** Команда эксплуатации управляет конфигурациями без доступа на машины разработчиков **Безопасность** Все плагины запускаются в изолированных контейнерах с ограничениями ресурсов **Консистентность** Единая среда выполнения вне зависимости от локальной установки **Опыт разработчика** Не нужно устанавливать и сопровождать плагины локально"},{"id":"api-service/overview::top::9","title":"Обзор API Service","section":"Архитектура","path":"/docs/guide/api-service/overview","headings":["Архитектура"],"excerpt":"Архитектура Архитектура сервиса упрощена и сфокусирована на надёжном выполнении плагинов:","content":"Архитектура Архитектура сервиса упрощена и сфокусирована на надёжном выполнении плагинов:"},{"id":"api-service/overview::api-layer::10","title":"Обзор API Service","section":"API Layer","path":"/docs/guide/api-service/overview#api-layer","headings":["API Layer"],"excerpt":"API Layer **gRPC Server** — основной API для запросов генерации Каждый запуск плагина — отдельный gRPC‑запрос Получает CodeGeneratorRequest от CLI","content":"API Layer **gRPC Server** — основной API для запросов генерации Каждый запуск плагина — отдельный gRPC‑запрос Получает CodeGeneratorRequest от CLI"},{"id":"api-service/overview::execution-engine::11","title":"Обзор API Service","section":"Execution Engine","path":"/docs/guide/api-service/overview#execution-engine","headings":["Execution Engine"],"excerpt":"Execution Engine **Docker Runtime** — изолированный запуск плагинов Подтягивает образы из публичных реестров (Docker Hub и т.п.) Применяет лимиты CPU/памяти на плагин","content":"Execution Engine **Docker Runtime** — изолированный запуск плагинов Подтягивает образы из публичных реестров (Docker Hub и т.п.) Применяет лимиты CPU/памяти на плагин"},{"id":"api-service/overview::storage-layer::12","title":"Обзор API Service","section":"Storage Layer","path":"/docs/guide/api-service/overview#storage-layer","headings":["Storage Layer"],"excerpt":"Storage Layer **PostgreSQL** хранит параметры выполнения: - Ограничения ресурсов (CPU, память) - Конфигурацию и метаданные плагинов - Логи выполнения (аудит) - _Примечание: функциональность хранения будет расширяться_","content":"Storage Layer **PostgreSQL** хранит параметры выполнения: - Ограничения ресурсов (CPU, память) - Конфигурацию и метаданные плагинов - Логи выполнения (аудит) - _Примечание: функциональность хранения будет расширяться_"},{"id":"api-service/overview::monitoring::13","title":"Обзор API Service","section":"Monitoring","path":"/docs/guide/api-service/overview#monitoring","headings":["Monitoring"],"excerpt":"Monitoring **Prometheus** — сбор метрик Отслеживает время выполнения, успешность, использование ресурсов","content":"Monitoring **Prometheus** — сбор метрик Отслеживает время выполнения, успешность, использование ресурсов"},{"id":"api-service/overview::easyp-cli::14","title":"Обзор API Service","section":"Локальное выполнение (EasyP CLI)","path":"/docs/guide/api-service/overview#easyp-cli","headings":["Локальное выполнение (EasyP CLI)"],"excerpt":"Локальное выполнение (EasyP CLI) При локальном запуске CLI поддерживает: **Installed plugins**: системно установленные protoc плагины **WASM plugins**: лёгкие WebAssembly плагины","content":"Локальное выполнение (EasyP CLI) При локальном запуске CLI поддерживает: **Installed plugins**: системно установленные protoc плагины **WASM plugins**: лёгкие WebAssembly плагины"},{"id":"api-service/overview::api-service::15","title":"Обзор API Service","section":"Удалённое выполнение (API Service)","path":"/docs/guide/api-service/overview#api-service","headings":["Удалённое выполнение (API Service)"],"excerpt":"Удалённое выполнение (API Service) При работе через сервис: **Только Docker**: плагины запускаются как контейнеры **Центральный контроль**: операционная команда управляет доступными версиями **Консистентная среда**: один","content":"Удалённое выполнение (API Service) При работе через сервис: **Только Docker**: плагины запускаются как контейнеры **Центральный контроль**: операционная команда управляет доступными версиями **Консистентная среда**: одинаковое окружение для всех разработчиков"},{"id":"api-service/overview::top::16","title":"Обзор API Service","section":"Шаги выполнения","path":"/docs/guide/api-service/overview","headings":["Шаги выполнения"],"excerpt":"Шаги выполнения **CLI Parsing**: CLI парсит локальные .proto файлы **Request Sending**: Отправляет CodeGeneratorRequest в API Service (по одному на плагин) **Parameter Lookup**: Сервис получает параметры запуска из Postg","content":"Шаги выполнения **CLI Parsing**: CLI парсит локальные .proto файлы **Request Sending**: Отправляет CodeGeneratorRequest в API Service (по одному на плагин) **Parameter Lookup**: Сервис получает параметры запуска из PostgreSQL **Docker Execution**: Запускает плагин в изолированном контейнере **Metrics Recording**: Записывает метрики после завершения **Response**: Возвращает сгенерированный код обратно в CLI"},{"id":"api-service/overview::top::17","title":"Обзор API Service","section":"Ключевые возможности","path":"/docs/guide/api-service/overview","headings":["Ключевые возможности"],"excerpt":"Ключевые возможности Возможность Описание ------------- ---------- **🐳 Изоляция плагинов** Каждый плагин в отдельном безопасном контейнере **⚙️ Контроль ресурсов** Лимиты CPU и памяти на уровне контейнера **📊 Метрики &","content":"Ключевые возможности Возможность Описание ------------- ---------- **🐳 Изоляция плагинов** Каждый плагин в отдельном безопасном контейнере **⚙️ Контроль ресурсов** Лимиты CPU и памяти на уровне контейнера **📊 Метрики & мониторинг** Полный набор Prometheus метрик **🔄 Управление версиями** Централизованно через Docker‑образы **⚡ Простой протокол** Стандарт CodeGeneratorRequest/Response **🔒 Безопасность прежде всего** Изоляция + ограниченные ресурсы"},{"id":"api-service/overview::top::18","title":"Обзор API Service","section":"Конфигурация","path":"/docs/guide/api-service/overview","headings":["Конфигурация"],"excerpt":"Конфигурация Сервис настраивается через переменные окружения.","content":"Конфигурация Сервис настраивается через переменные окружения."},{"id":"api-service/overview::top::19","title":"Обзор API Service","section":"Хранение параметров плагинов","path":"/docs/guide/api-service/overview","headings":["Хранение параметров плагинов"],"excerpt":"Хранение параметров плагинов PostgreSQL хранит параметры выполнения для каждого плагина:","content":"Хранение параметров плагинов PostgreSQL хранит параметры выполнения для каждого плагина:"},{"id":"api-service/overview::top::20","title":"Обзор API Service","section":"Хранение параметров плагинов","path":"/docs/guide/api-service/overview","headings":["Хранение параметров плагинов"],"excerpt":"Хранение параметров плагинов ::: tip Схема хранения будет расширена — аудит логов, аналитика использования, кеширование плагинов. :::","content":"Хранение параметров плагинов ::: tip Схема хранения будет расширена — аудит логов, аналитика использования, кеширование плагинов. :::"},{"id":"api-service/overview::easyp-cli::21","title":"Обзор API Service","section":"Интеграция с EasyP CLI","path":"/docs/guide/api-service/overview#easyp-cli","headings":["Интеграция с EasyP CLI"],"excerpt":"Интеграция с EasyP CLI Пример easyp.yaml для удалённого запуска:","content":"Интеграция с EasyP CLI Пример easyp.yaml для удалённого запуска:"},{"id":"api-service/overview::easyp-cli::22","title":"Обзор API Service","section":"Интеграция с EasyP CLI","path":"/docs/guide/api-service/overview#easyp-cli","headings":["Интеграция с EasyP CLI"],"excerpt":"Интеграция с EasyP CLI Запуск генерации:","content":"Интеграция с EasyP CLI Запуск генерации:"},{"id":"api-service/overview::easyp-cli::23","title":"Обзор API Service","section":"Интеграция с EasyP CLI","path":"/docs/guide/api-service/overview#easyp-cli","headings":["Интеграция с EasyP CLI"],"excerpt":"Интеграция с EasyP CLI CLI: Парсит protobuf‑файлы Отправляет отдельные запросы в сервис для каждого плагина Получает ответы с кодом Записывает файлы в указанные директории","content":"Интеграция с EasyP CLI CLI: Парсит protobuf‑файлы Отправляет отдельные запросы в сервис для каждого плагина Получает ответы с кодом Записывает файлы в указанные директории"},{"id":"api-service/overview::top::24","title":"Обзор API Service","section":"Доступные метрики","path":"/docs/guide/api-service/overview","headings":["Доступные метрики"],"excerpt":"Доступные метрики Метрики Prometheus:","content":"Доступные метрики Метрики Prometheus:"},{"id":"api-service/overview::top::25","title":"Обзор API Service","section":"Доступные метрики","path":"/docs/guide/api-service/overview","headings":["Доступные метрики"],"excerpt":"Доступные метрики Метрика Описание --------- ---------- easyp_api_service_api_grpc_server_handled_total Общее число gRPC запросов по статусам easyp_api_service_api_grpc_server_handling_seconds Гистограмма задержек gRPC e","content":"Доступные метрики Метрика Описание --------- ---------- easyp_api_service_api_grpc_server_handled_total Общее число gRPC запросов по статусам easyp_api_service_api_grpc_server_handling_seconds Гистограмма задержек gRPC easyp_api_service_generated_plugin_code_total Выполнения плагинов по имени easyp_api_service_repo_call_duration_seconds Латентность запросов к БД easyp_api_service_repo_errors_total Количество ошибок доступа к БД easyp_api_service_standard_panics_total Число восстановленных паник"},{"id":"api-service/overview::top::26","title":"Обзор API Service","section":"Характеристики производительности","path":"/docs/guide/api-service/overview","headings":["Характеристики производительности"],"excerpt":"Характеристики производительности Показатель Типичное значение Примечания ----------- ------------------- ----------- **Cold Start** 2–5 сек Первая загрузка образа **Warm Start** 100–500 мс Образ закеширован **Throughput","content":"Характеристики производительности Показатель Типичное значение Примечания ----------- ------------------- ----------- **Cold Start** 2–5 сек Первая загрузка образа **Warm Start** 100–500 мс Образ закеширован **Throughput** 20–50 одновременных Зависит от ресурсов **Memory Usage** 50–200 MB На выполнение одного плагина"},{"id":"api-service/overview::top::27","title":"Обзор API Service","section":"Изоляция контейнеров","path":"/docs/guide/api-service/overview","headings":["Изоляция контейнеров"],"excerpt":"Изоляция контейнеров Каждый плагин в отдельном эфемерном контейнере Нет сетевого доступа в процессе выполнения Лимиты CPU/памяти через Docker Контейнер удаляется после завершения","content":"Изоляция контейнеров Каждый плагин в отдельном эфемерном контейнере Нет сетевого доступа в процессе выполнения Лимиты CPU/памяти через Docker Контейнер удаляется после завершения"},{"id":"api-service/overview::api::28","title":"Обзор API Service","section":"Безопасность API","path":"/docs/guide/api-service/overview#api","headings":["Безопасность API"],"excerpt":"Безопасность API gRPC транспорт Поддержка токенов аутентификации (в продакшн окружениях) Валидация входных данных Аудитные логи в PostgreSQL","content":"Безопасность API gRPC транспорт Поддержка токенов аутентификации (в продакшн окружениях) Валидация входных данных Аудитные логи в PostgreSQL"},{"id":"api-service/overview::top::29","title":"Обзор API Service","section":"Масштабирование","path":"/docs/guide/api-service/overview","headings":["Масштабирование"],"excerpt":"Масштабирование **Горизонтальное**: несколько инстансов за балансировщиком **Ресурсы**: настройка лимитов для тяжёлых плагинов **База данных**: репликация PostgreSQL для отказоустойчивости","content":"Масштабирование **Горизонтальное**: несколько инстансов за балансировщиком **Ресурсы**: настройка лимитов для тяжёлых плагинов **База данных**: репликация PostgreSQL для отказоустойчивости"},{"id":"api-service/overview::top::30","title":"Обзор API Service","section":"Мониторинг","path":"/docs/guide/api-service/overview","headings":["Мониторинг"],"excerpt":"Мониторинг **Метрики**: Prometheus **Алертинг**: оповещения на высокие ошибки/латентность **Логи**: структурированные для аудита и отладки","content":"Мониторинг **Метрики**: Prometheus **Алертинг**: оповещения на высокие ошибки/латентность **Логи**: структурированные для аудита и отладки"},{"id":"api-service/overview::top::31","title":"Обзор API Service","section":"План развития","path":"/docs/guide/api-service/overview","headings":["План развития"],"excerpt":"План развития Запланировано: Кеширование результатов генерации Расширенный аудит и аналитика использования Поддержка приватных реестров плагинов Более умное распределение ресурсов","content":"План развития Запланировано: Кеширование результатов генерации Расширенный аудит и аналитика использования Поддержка приватных реестров плагинов Более умное распределение ресурсов"},{"id":"api-service/overview::top::32","title":"Обзор API Service","section":"Сообщество и поддержка","path":"/docs/guide/api-service/overview","headings":["Сообщество и поддержка"],"excerpt":"Сообщество и поддержка **💬 Telegram чат** — обсуждения **🐛 GitHub Issues** — баги и запросы фич **📖 Документация** — полный набор материалов","content":"Сообщество и поддержка **💬 Telegram чат** — обсуждения **🐛 GitHub Issues** — баги и запросы фич **📖 Документация** — полный набор материалов"},{"id":"api-service/overview::top::33","title":"Обзор API Service","section":"Сообщество и поддержка","path":"/docs/guide/api-service/overview","headings":["Сообщество и поддержка"],"excerpt":"Сообщество и поддержка *Упростите свои protobuf‑воркфлоу с централизованным управлением выполнением плагинов.*","content":"Сообщество и поддержка *Упростите свои protobuf‑воркфлоу с централизованным управлением выполнением плагинов.*"},{"id":"ci-cd/github-actions::top::0","title":"GitHub Actions","path":"/docs/guide/ci-cd/github-actions","headings":[],"excerpt":"Полное руководство по интеграции EasyP в конвейеры GitHub Actions для линтинга, проверки несовместимых изменений, генерации кода и автоматизации релизов.","content":"Полное руководство по интеграции EasyP в конвейеры GitHub Actions для линтинга, проверки несовместимых изменений, генерации кода и автоматизации релизов."},{"id":"ci-cd/github-actions::easyp-ci::1","title":"GitHub Actions","section":"Зачем использовать EasyP в CI","path":"/docs/guide/ci-cd/github-actions#easyp-ci","headings":["Зачем использовать EasyP в CI"],"excerpt":"Зачем использовать EasyP в CI Встраивание EasyP в GitHub Actions даёт: Единообразие правил линтинга и генерации между разработчиками. Автоматическое выявление несовместимых изменений (breaking changes) до мержа. Гарантию","content":"Зачем использовать EasyP в CI Встраивание EasyP в GitHub Actions даёт: Единообразие правил линтинга и генерации между разработчиками. Автоматическое выявление несовместимых изменений (breaking changes) до мержа. Гарантию, что сгенерированный код не «устарел» относительно .proto. Возможность централизованной проверки зависимостей и версии конфигурации."},{"id":"ci-cd/github-actions::top::2","title":"GitHub Actions","section":"Предварительные требования","path":"/docs/guide/ci-cd/github-actions","headings":["Предварительные требования"],"excerpt":"Предварительные требования Репозиторий содержит файл конфигурации easyp.yaml (или находится в корне, если запускается без --cfg). Установлены / определены зависимости в секции deps (если нужны внешние импорты). Для прива","content":"Предварительные требования Репозиторий содержит файл конфигурации easyp.yaml (или находится в корне, если запускается без --cfg). Установлены / определены зависимости в секции deps (если нужны внешние импорты). Для приватных Git-репозиториев настроен доступ (SSH key / deploy key / токен). В workflow есть шаги по установке Go (если EasyP поставляется через go install) или заранее подготовленный бинарь."},{"id":"ci-cd/github-actions::top::3","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) Минимальный workflow для проверки линта и несовместимых изменений при открытия Pull Request:","content":"Базовый пример (быстрый старт) Минимальный workflow для проверки линта и несовместимых изменений при открытия Pull Request:"},{"id":"ci-cd/github-actions::top::4","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) ```yaml name: easyp-ci","content":"Базовый пример (быстрый старт) ```yaml name: easyp-ci"},{"id":"ci-cd/github-actions::top::5","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) on: pull_request: paths: - '**/*.proto' - 'easyp.yaml'","content":"Базовый пример (быстрый старт) on: pull_request: paths: - '**/*.proto' - 'easyp.yaml'"},{"id":"ci-cd/github-actions::top::6","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) jobs: lint-and-breaking: runs-on: ubuntu-latest","content":"Базовый пример (быстрый старт) jobs: lint-and-breaking: runs-on: ubuntu-latest"},{"id":"ci-cd/github-actions::top::7","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) steps: - name: Checkout uses: actions/checkout@v4","content":"Базовый пример (быстрый старт) steps: - name: Checkout uses: actions/checkout@v4"},{"id":"ci-cd/github-actions::top::8","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) name: Setup Go uses: actions/setup-go@v5 with: go-version: '1.22'","content":"Базовый пример (быстрый старт) name: Setup Go uses: actions/setup-go@v5 with: go-version: '1.22'"},{"id":"ci-cd/github-actions::top::9","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest","content":"Базовый пример (быстрый старт) name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest"},{"id":"ci-cd/github-actions::top::10","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) name: Verify EasyP version run: which easyp easyp version","content":"Базовый пример (быстрый старт) name: Verify EasyP version run: which easyp easyp version"},{"id":"ci-cd/github-actions::top::11","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) name: Lint run: easyp lint","content":"Базовый пример (быстрый старт) name: Lint run: easyp lint"},{"id":"ci-cd/github-actions::top::12","title":"GitHub Actions","section":"Базовый пример (быстрый старт)","path":"/docs/guide/ci-cd/github-actions","headings":["Базовый пример (быстрый старт)"],"excerpt":"Базовый пример (быстрый старт) name: Breaking changes check (against main) run: easyp breaking --against git-ref=origin/main ```","content":"Базовый пример (быстрый старт) name: Breaking changes check (against main) run: easyp breaking --against git-ref=origin/main ```"},{"id":"ci-cd/github-actions::easyp::13","title":"GitHub Actions","section":"Установка EasyP","path":"/docs/guide/ci-cd/github-actions#easyp","headings":["Установка EasyP"],"excerpt":"Установка EasyP Варианты: Через go install (как в примере выше). Использование заранее собранного бинаря (артефакт релиза).","content":"Установка EasyP Варианты: Через go install (как в примере выше). Использование заранее собранного бинаря (артефакт релиза)."},{"id":"ci-cd/github-actions::top::14","title":"GitHub Actions","section":"Кэширование","path":"/docs/guide/ci-cd/github-actions","headings":["Кэширование"],"excerpt":"Кэширование Для ускорения повторных сборок можно кэшировать: Go модульный кеш (если используете генерацию с плагинами Go). Внешние зависимые Git-клонирования (папки vendor или содержимое deps при использовании easyp mod ","content":"Кэширование Для ускорения повторных сборок можно кэшировать: Go модульный кеш (если используете генерацию с плагинами Go). Внешние зависимые Git-клонирования (папки vendor или содержимое deps при использовании easyp mod download / easyp mod update). Сгенерированный код (если он тяжёлый, но чаще генерируется заново)."},{"id":"ci-cd/github-actions::top::15","title":"GitHub Actions","section":"Кэширование","path":"/docs/guide/ci-cd/github-actions","headings":["Кэширование"],"excerpt":"Кэширование Пример кэширования Go:","content":"Кэширование Пример кэширования Go:"},{"id":"ci-cd/github-actions::top::16","title":"GitHub Actions","section":"Кэширование","path":"/docs/guide/ci-cd/github-actions","headings":["Кэширование"],"excerpt":"Кэширование Пример кэширования каталога зависимостей EasyP (если вы используете локальный vendor-подход):","content":"Кэширование Пример кэширования каталога зависимостей EasyP (если вы используете локальный vendor-подход):"},{"id":"ci-cd/github-actions::top::17","title":"GitHub Actions","section":"Кэширование","path":"/docs/guide/ci-cd/github-actions","headings":["Кэширование"],"excerpt":"Кэширование (Создайте .easyp/deps как целевой каталог, если ваша стратегия скачивания такова.)","content":"Кэширование (Создайте .easyp/deps как целевой каталог, если ваша стратегия скачивания такова.)"},{"id":"ci-cd/github-actions::top::18","title":"GitHub Actions","section":"Линтинг","path":"/docs/guide/ci-cd/github-actions","headings":["Линтинг"],"excerpt":"Линтинг Рекомендуется: В PR: всегда запускать. На main: можно запускать для верификации перед релизом.","content":"Линтинг Рекомендуется: В PR: всегда запускать. На main: можно запускать для верификации перед релизом."},{"id":"ci-cd/github-actions::top::19","title":"GitHub Actions","section":"Линтинг","path":"/docs/guide/ci-cd/github-actions","headings":["Линтинг"],"excerpt":"Линтинг Расширенный пример с выводом подробностей и игнорированием комментариев (если включено в конфиг):","content":"Линтинг Расширенный пример с выводом подробностей и игнорированием комментариев (если включено в конфиг):"},{"id":"ci-cd/github-actions::breaking-changes::20","title":"GitHub Actions","section":"Проверка несовместимых изменений (Breaking Changes)","path":"/docs/guide/ci-cd/github-actions#breaking-changes","headings":["Проверка несовместимых изменений (Breaking Changes)"],"excerpt":"Проверка несовместимых изменений (Breaking Changes) EasyP может сравнивать текущее состояние против ветки / коммита / тега.","content":"Проверка несовместимых изменений (Breaking Changes) EasyP может сравнивать текущее состояние против ветки / коммита / тега."},{"id":"ci-cd/github-actions::breaking-changes::21","title":"GitHub Actions","section":"Проверка несовместимых изменений (Breaking Changes)","path":"/docs/guide/ci-cd/github-actions#breaking-changes","headings":["Проверка несовместимых изменений (Breaking Changes)"],"excerpt":"Проверка несовместимых изменений (Breaking Changes) Примеры: ```bash Сравнить против origin/main easyp breaking --against git-ref=origin/main","content":"Проверка несовместимых изменений (Breaking Changes) Примеры: ```bash Сравнить против origin/main easyp breaking --against git-ref=origin/main"},{"id":"ci-cd/github-actions::breaking-changes::22","title":"GitHub Actions","section":"Проверка несовместимых изменений (Breaking Changes)","path":"/docs/guide/ci-cd/github-actions#breaking-changes","headings":["Проверка несовместимых изменений (Breaking Changes)"],"excerpt":"Проверка несовместимых изменений (Breaking Changes) Сравнить против тега релиза easyp breaking --against git-ref=v1.5.2","content":"Проверка несовместимых изменений (Breaking Changes) Сравнить против тега релиза easyp breaking --against git-ref=v1.5.2"},{"id":"ci-cd/github-actions::breaking-changes::23","title":"GitHub Actions","section":"Проверка несовместимых изменений (Breaking Changes)","path":"/docs/guide/ci-cd/github-actions#breaking-changes","headings":["Проверка несовместимых изменений (Breaking Changes)"],"excerpt":"Проверка несовместимых изменений (Breaking Changes) Игнорировать определённые правила (если у вас настроено в easyp.yaml) easyp breaking ```","content":"Проверка несовместимых изменений (Breaking Changes) Игнорировать определённые правила (если у вас настроено в easyp.yaml) easyp breaking ```"},{"id":"ci-cd/github-actions::breaking-changes::24","title":"GitHub Actions","section":"Проверка несовместимых изменений (Breaking Changes)","path":"/docs/guide/ci-cd/github-actions#breaking-changes","headings":["Проверка несовместимых изменений (Breaking Changes)"],"excerpt":"Проверка несовместимых изменений (Breaking Changes) Workflow шаг:","content":"Проверка несовместимых изменений (Breaking Changes) Workflow шаг:"},{"id":"ci-cd/github-actions::breaking-changes::25","title":"GitHub Actions","section":"Проверка несовместимых изменений (Breaking Changes)","path":"/docs/guide/ci-cd/github-actions#breaking-changes","headings":["Проверка несовместимых изменений (Breaking Changes)"],"excerpt":"Проверка несовместимых изменений (Breaking Changes)","content":"Проверка несовместимых изменений (Breaking Changes)"},{"id":"ci-cd/github-actions::breaking-changes::26","title":"GitHub Actions","section":"Проверка несовместимых изменений (Breaking Changes)","path":"/docs/guide/ci-cd/github-actions#breaking-changes","headings":["Проверка несовместимых изменений (Breaking Changes)"],"excerpt":"Проверка несовместимых изменений (Breaking Changes) Если нужно «мягко» пропустить (например, выводить предупреждения, но не падать билд):","content":"Проверка несовместимых изменений (Breaking Changes) Если нужно «мягко» пропустить (например, выводить предупреждения, но не падать билд):"},{"id":"ci-cd/github-actions::breaking-changes::27","title":"GitHub Actions","section":"Проверка несовместимых изменений (Breaking Changes)","path":"/docs/guide/ci-cd/github-actions#breaking-changes","headings":["Проверка несовместимых изменений (Breaking Changes)"],"excerpt":"Проверка несовместимых изменений (Breaking Changes)","content":"Проверка несовместимых изменений (Breaking Changes)"},{"id":"ci-cd/github-actions::top::28","title":"GitHub Actions","section":"Генерация кода","path":"/docs/guide/ci-cd/github-actions","headings":["Генерация кода"],"excerpt":"Генерация кода Обычно для генерации:","content":"Генерация кода Обычно для генерации:"},{"id":"ci-cd/github-actions::top::29","title":"GitHub Actions","section":"Генерация кода","path":"/docs/guide/ci-cd/github-actions","headings":["Генерация кода"],"excerpt":"Генерация кода Если нужно явно указать конфиг:","content":"Генерация кода Если нужно явно указать конфиг:"},{"id":"ci-cd/github-actions::top::30","title":"GitHub Actions","section":"Генерация кода","path":"/docs/guide/ci-cd/github-actions","headings":["Генерация кода"],"excerpt":"Генерация кода Можно добавить проверку «не осталось ли не закоммиченных изменений» (гарантия, что сгенерированный код актуален):","content":"Генерация кода Можно добавить проверку «не осталось ли не закоммиченных изменений» (гарантия, что сгенерированный код актуален):"},{"id":"ci-cd/github-actions::matrix-strategy::31","title":"GitHub Actions","section":"Матрица (Matrix strategy)","path":"/docs/guide/ci-cd/github-actions#matrix-strategy","headings":["Матрица (Matrix strategy)"],"excerpt":"Матрица (Matrix strategy) Если у вас несколько вариантов конфигураций или разных языков генерации (через плагины), можно использовать matrix:","content":"Матрица (Matrix strategy) Если у вас несколько вариантов конфигураций или разных языков генерации (через плагины), можно использовать matrix:"},{"id":"ci-cd/github-actions::matrix-strategy::32","title":"GitHub Actions","section":"Матрица (Matrix strategy)","path":"/docs/guide/ci-cd/github-actions#matrix-strategy","headings":["Матрица (Matrix strategy)"],"excerpt":"Матрица (Matrix strategy) ```yaml jobs: generate: runs-on: ubuntu-latest strategy: fail-fast: false matrix: lang: [go, python] steps: - uses: actions/checkout@v4","content":"Матрица (Matrix strategy) ```yaml jobs: generate: runs-on: ubuntu-latest strategy: fail-fast: false matrix: lang: [go, python] steps: - uses: actions/checkout@v4"},{"id":"ci-cd/github-actions::matrix-strategy::33","title":"GitHub Actions","section":"Матрица (Matrix strategy)","path":"/docs/guide/ci-cd/github-actions#matrix-strategy","headings":["Матрица (Matrix strategy)"],"excerpt":"Матрица (Matrix strategy) name: Setup Go (only for go) if: matrix.lang == 'go' uses: actions/setup-go@v5 with: go-version: '1.22'","content":"Матрица (Matrix strategy) name: Setup Go (only for go) if: matrix.lang == 'go' uses: actions/setup-go@v5 with: go-version: '1.22'"},{"id":"ci-cd/github-actions::matrix-strategy::34","title":"GitHub Actions","section":"Матрица (Matrix strategy)","path":"/docs/guide/ci-cd/github-actions#matrix-strategy","headings":["Матрица (Matrix strategy)"],"excerpt":"Матрица (Matrix strategy) name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest","content":"Матрица (Matrix strategy) name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest"},{"id":"ci-cd/github-actions::matrix-strategy::35","title":"GitHub Actions","section":"Матрица (Matrix strategy)","path":"/docs/guide/ci-cd/github-actions#matrix-strategy","headings":["Матрица (Matrix strategy)"],"excerpt":"Матрица (Matrix strategy) name: Generate run: if [ \"${{ matrix.lang }}\" = \"go\" ]; then easyp generate elif [ \"${{ matrix.lang }}\" = \"python\" ]; then easyp generate --plugin python fi ```","content":"Матрица (Matrix strategy) name: Generate run: if [ \"${{ matrix.lang }}\" = \"go\" ]; then easyp generate elif [ \"${{ matrix.lang }}\" = \"python\" ]; then easyp generate --plugin python fi ```"},{"id":"ci-cd/github-actions::deps::36","title":"GitHub Actions","section":"Работа с приватными репозиториями (deps)","path":"/docs/guide/ci-cd/github-actions#deps","headings":["Работа с приватными репозиториями (deps)"],"excerpt":"Работа с приватными репозиториями (deps) Если вы указываете приватные Git-пакеты в секции deps:","content":"Работа с приватными репозиториями (deps) Если вы указываете приватные Git-пакеты в секции deps:"},{"id":"ci-cd/github-actions::deps::37","title":"GitHub Actions","section":"Работа с приватными репозиториями (deps)","path":"/docs/guide/ci-cd/github-actions#deps","headings":["Работа с приватными репозиториями (deps)"],"excerpt":"Работа с приватными репозиториями (deps) Настройте deploy key или используйте GIT_SSH_COMMAND с токеном. Добавьте known_hosts (либо установите StrictHostKeyChecking=no для внутренних систем, но осознанно).","content":"Работа с приватными репозиториями (deps) Настройте deploy key или используйте GIT_SSH_COMMAND с токеном. Добавьте known_hosts (либо установите StrictHostKeyChecking=no для внутренних систем, но осознанно)."},{"id":"ci-cd/github-actions::deps::38","title":"GitHub Actions","section":"Работа с приватными репозиториями (deps)","path":"/docs/guide/ci-cd/github-actions#deps","headings":["Работа с приватными репозиториями (deps)"],"excerpt":"Работа с приватными репозиториями (deps) Пример:","content":"Работа с приватными репозиториями (deps) Пример:"},{"id":"ci-cd/github-actions::deps::39","title":"GitHub Actions","section":"Работа с приватными репозиториями (deps)","path":"/docs/guide/ci-cd/github-actions#deps","headings":["Работа с приватными репозиториями (deps)"],"excerpt":"Работа с приватными репозиториями (deps) ```yaml name: Prepare SSH run: mkdir -p ~/.ssh echo \"${{ secrets.DEPLOY_KEY }}\" > ~/.ssh/id_rsa chmod 600 ~/.ssh/id_rsa ssh-keyscan github.com >> ~/.ssh/known_hosts","content":"Работа с приватными репозиториями (deps) ```yaml name: Prepare SSH run: mkdir -p ~/.ssh echo \"${{ secrets.DEPLOY_KEY }}\" > ~/.ssh/id_rsa chmod 600 ~/.ssh/id_rsa ssh-keyscan github.com >> ~/.ssh/known_hosts"},{"id":"ci-cd/github-actions::deps::40","title":"GitHub Actions","section":"Работа с приватными репозиториями (deps)","path":"/docs/guide/ci-cd/github-actions#deps","headings":["Работа с приватными репозиториями (deps)"],"excerpt":"Работа с приватными репозиториями (deps) name: Update deps run: easyp mod update ```","content":"Работа с приватными репозиториями (deps) name: Update deps run: easyp mod update ```"},{"id":"ci-cd/github-actions::top::41","title":"GitHub Actions","section":"Оптимизация времени сборки","path":"/docs/guide/ci-cd/github-actions","headings":["Оптимизация времени сборки"],"excerpt":"Оптимизация времени сборки Используйте кэш для Go / deps. Запускайте линт/брейкинг только если изменились .proto или easyp.yaml (paths фильтр). Разделяйте workflow: быстрый линт в PR, тяжелая генерация в push на main. Вы","content":"Оптимизация времени сборки Используйте кэш для Go / deps. Запускайте линт/брейкинг только если изменились .proto или easyp.yaml (paths фильтр). Разделяйте workflow: быстрый линт в PR, тяжелая генерация в push на main. Выносите генерацию OpenAPI / gRPC-Gateway в отдельный job (параллелизм)."},{"id":"ci-cd/github-actions::workflow::42","title":"GitHub Actions","section":"Продвинутый workflow (многостадийный)","path":"/docs/guide/ci-cd/github-actions#workflow","headings":["Продвинутый workflow (многостадийный)"],"excerpt":"Продвинутый workflow (многостадийный) ```yaml name: easyp-pipeline","content":"Продвинутый workflow (многостадийный) ```yaml name: easyp-pipeline"},{"id":"ci-cd/github-actions::workflow::43","title":"GitHub Actions","section":"Продвинутый workflow (многостадийный)","path":"/docs/guide/ci-cd/github-actions#workflow","headings":["Продвинутый workflow (многостадийный)"],"excerpt":"Продвинутый workflow (многостадийный) on: pull_request: paths: - '**/*.proto' - 'easyp.yaml' push: branches: - main","content":"Продвинутый workflow (многостадийный) on: pull_request: paths: - '**/*.proto' - 'easyp.yaml' push: branches: - main"},{"id":"ci-cd/github-actions::workflow::44","title":"GitHub Actions","section":"Продвинутый workflow (многостадийный)","path":"/docs/guide/ci-cd/github-actions#workflow","headings":["Продвинутый workflow (многостадийный)"],"excerpt":"Продвинутый workflow (многостадийный) jobs: validate: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4","content":"Продвинутый workflow (многостадийный) jobs: validate: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4"},{"id":"ci-cd/github-actions::workflow::45","title":"GitHub Actions","section":"Продвинутый workflow (многостадийный)","path":"/docs/guide/ci-cd/github-actions#workflow","headings":["Продвинутый workflow (многостадийный)"],"excerpt":"Продвинутый workflow (многостадийный) uses: actions/setup-go@v5 with: go-version: '1.22'","content":"Продвинутый workflow (многостадийный) uses: actions/setup-go@v5 with: go-version: '1.22'"},{"id":"ci-cd/github-actions::workflow::46","title":"GitHub Actions","section":"Продвинутый workflow (многостадийный)","path":"/docs/guide/ci-cd/github-actions#workflow","headings":["Продвинутый workflow (многостадийный)"],"excerpt":"Продвинутый workflow (многостадийный) name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest","content":"Продвинутый workflow (многостадийный) name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest"},{"id":"ci-cd/github-actions::workflow::47","title":"GitHub Actions","section":"Продвинутый workflow (многостадийный)","path":"/docs/guide/ci-cd/github-actions#workflow","headings":["Продвинутый workflow (многостадийный)"],"excerpt":"Продвинутый workflow (многостадийный) name: Lint run: easyp lint","content":"Продвинутый workflow (многостадийный) name: Lint run: easyp lint"},{"id":"ci-cd/github-actions::workflow::48","title":"GitHub Actions","section":"Продвинутый workflow (многостадийный)","path":"/docs/guide/ci-cd/github-actions#workflow","headings":["Продвинутый workflow (многостадийный)"],"excerpt":"Продвинутый workflow (многостадийный) name: Breaking check (against main) if: github.event_name == 'pull_request' run: easyp breaking --against git-ref=origin/main","content":"Продвинутый workflow (многостадийный) name: Breaking check (against main) if: github.event_name == 'pull_request' run: easyp breaking --against git-ref=origin/main"},{"id":"ci-cd/github-actions::workflow::49","title":"GitHub Actions","section":"Продвинутый workflow (многостадийный)","path":"/docs/guide/ci-cd/github-actions#workflow","headings":["Продвинутый workflow (многостадийный)"],"excerpt":"Продвинутый workflow (многостадийный) generate: needs: validate if: github.event_name == 'push' runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-go@v5 with: go-version: '1.22' - name: Insta","content":"Продвинутый workflow (многостадийный) generate: needs: validate if: github.event_name == 'push' runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-go@v5 with: go-version: '1.22' - name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest - name: Generate Code run: easyp generate - name: Check diffs run: if [ -n \"$(git status --porcelain)\" ]; then echo \"Generated files changed after generate step.\" git diff --name-only exit 1 fi ```"},{"id":"ci-cd/github-actions::top::50","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) Можно добавить workflow, который по тегу создаёт релиз и валидирует proto:","content":"Автоматизация релиза (пример) Можно добавить workflow, который по тегу создаёт релиз и валидирует proto:"},{"id":"ci-cd/github-actions::top::51","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) ```yaml name: release-verify","content":"Автоматизация релиза (пример) ```yaml name: release-verify"},{"id":"ci-cd/github-actions::top::52","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) on: push: tags: - 'v*.*.*'","content":"Автоматизация релиза (пример) on: push: tags: - 'v*.*.*'"},{"id":"ci-cd/github-actions::top::53","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) jobs: release-check: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4","content":"Автоматизация релиза (пример) jobs: release-check: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4"},{"id":"ci-cd/github-actions::top::54","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) uses: actions/setup-go@v5 with: go-version: '1.22'","content":"Автоматизация релиза (пример) uses: actions/setup-go@v5 with: go-version: '1.22'"},{"id":"ci-cd/github-actions::top::55","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest","content":"Автоматизация релиза (пример) name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest"},{"id":"ci-cd/github-actions::top::56","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) name: Lint run: easyp lint","content":"Автоматизация релиза (пример) name: Lint run: easyp lint"},{"id":"ci-cd/github-actions::top::57","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) name: Breaking vs previous tag run: PREV_TAG=$(git tag --sort=-creatordate grep -v \"${GITHUB_REF_NAME}\" head -n1 true) if [ -n \"$PREV_TAG\" ]; then echo \"Comparing against $PREV_TAG\" easyp br","content":"Автоматизация релиза (пример) name: Breaking vs previous tag run: PREV_TAG=$(git tag --sort=-creatordate grep -v \"${GITHUB_REF_NAME}\" head -n1 true) if [ -n \"$PREV_TAG\" ]; then echo \"Comparing against $PREV_TAG\" easyp breaking --against git-ref=$PREV_TAG else echo \"No previous tag, skipping breaking check\" fi"},{"id":"ci-cd/github-actions::top::58","title":"GitHub Actions","section":"Автоматизация релиза (пример)","path":"/docs/guide/ci-cd/github-actions","headings":["Автоматизация релиза (пример)"],"excerpt":"Автоматизация релиза (пример) name: Generate to ensure consistency run: easyp generate ```","content":"Автоматизация релиза (пример) name: Generate to ensure consistency run: easyp generate ```"},{"id":"ci-cd/github-actions::top::59","title":"GitHub Actions","section":"Отладка","path":"/docs/guide/ci-cd/github-actions","headings":["Отладка"],"excerpt":"Отладка Если нужно больше логов:","content":"Отладка Если нужно больше логов:"},{"id":"ci-cd/github-actions::top::60","title":"GitHub Actions","section":"Отладка","path":"/docs/guide/ci-cd/github-actions","headings":["Отладка"],"excerpt":"Отладка Добавьте вывод окружения для диагностики:","content":"Отладка Добавьте вывод окружения для диагностики:"},{"id":"ci-cd/github-actions::top::61","title":"GitHub Actions","section":"Переменные окружения (примерно)","path":"/docs/guide/ci-cd/github-actions","headings":["Переменные окружения (примерно)"],"excerpt":"Переменные окружения (примерно) Переменная Назначение ------------ ----------- EASYP_SERVICE_HOST Хост удалённого API Service (если используете удалённые плагины) EASYP_SERVICE_GRPC_PORT Порт удалённого сервиса GIT_SSH_C","content":"Переменные окружения (примерно) Переменная Назначение ------------ ----------- EASYP_SERVICE_HOST Хост удалённого API Service (если используете удалённые плагины) EASYP_SERVICE_GRPC_PORT Порт удалённого сервиса GIT_SSH_COMMAND Кастомная команда SSH (частные репозитории) GOFLAGS Можно выставить -mod=readonly для Go генерации"},{"id":"ci-cd/github-actions::top::62","title":"GitHub Actions","section":"Переменные окружения (примерно)","path":"/docs/guide/ci-cd/github-actions","headings":["Переменные окружения (примерно)"],"excerpt":"Переменные окружения (примерно) (Используйте только те, что действительно нужны вашему проекту.)","content":"Переменные окружения (примерно) (Используйте только те, что действительно нужны вашему проекту.)"},{"id":"ci-cd/github-actions::top::63","title":"GitHub Actions","section":"Частые ошибки","path":"/docs/guide/ci-cd/github-actions","headings":["Частые ошибки"],"excerpt":"Частые ошибки Симптом Причина Решение --------- --------- --------- Линт падает на неизвестных правилах Правила указаны в easyp.yaml, но версия EasyP их не поддерживает Обновить EasyP (go install ...@latest) breaking сра","content":"Частые ошибки Симптом Причина Решение --------- --------- --------- Линт падает на неизвестных правилах Правила указаны в easyp.yaml, но версия EasyP их не поддерживает Обновить EasyP (go install ...@latest) breaking сравнение ничего не находит Неверный --against (нет fetch удалённой ветки) Добавить шаг git fetch --all --tags Сгенерированный код в PR отличается от main Отсутствует проверка генерации в CI Добавить шаг «Ensure generated code is up-to-date» Приватные deps не скачиваются Нет SSH ключа или токена Настроить secrets + шаг подготовки SSH Долгое выполнение Отсутствует кеш Добавить кэширование модулей и deps"},{"id":"ci-cd/github-actions::top::64","title":"GitHub Actions","section":"Рекомендации по поддержке","path":"/docs/guide/ci-cd/github-actions","headings":["Рекомендации по поддержке"],"excerpt":"Рекомендации по поддержке Заготовить шаблон workflow и копировать между сервисами (DRY). Включить paths фильтры, чтобы не тратить минуты на нерелевантные изменения. Проверять easyp.yaml при изменениях отдельно — можно за","content":"Рекомендации по поддержке Заготовить шаблон workflow и копировать между сервисами (DRY). Включить paths фильтры, чтобы не тратить минуты на нерелевантные изменения. Проверять easyp.yaml при изменениях отдельно — можно запускать «конфигурационный тест» (например, easyp lint без файлов, чтобы убедиться, что конфиг валиден). При появлении новых правил линтера обновляйте конфиг и фиксируйте ошибки сразу в одной ветке."},{"id":"ci-cd/github-actions::top::65","title":"GitHub Actions","section":"Рекомендации по поддержке","path":"/docs/guide/ci-cd/github-actions","headings":["Рекомендации по поддержке"],"excerpt":"Рекомендации по поддержке Готово: вы можете расширять разделы генерации, добавлять OpenAPI / grpc-gateway / validate плагины, матрицы по языкам и интегрировать тесты поверх сгенерированного кода, если требуется.","content":"Рекомендации по поддержке Готово: вы можете расширять разделы генерации, добавлять OpenAPI / grpc-gateway / validate плагины, матрицы по языкам и интегрировать тесты поверх сгенерированного кода, если требуется."},{"id":"ci-cd/gitlab::top::0","title":"GitLab CI","section":"В процессе разработки","path":"/docs/guide/ci-cd/gitlab","headings":["В процессе разработки"],"excerpt":"В процессе разработки Документация по интеграции EasyP с GitLab CI находится в процессе подготовки. Планируемые разделы: Быстрый старт (пример .gitlab-ci.yml для линтинга и проверки несовместимых изменений) Кэширование з","content":"В процессе разработки Документация по интеграции EasyP с GitLab CI находится в процессе подготовки. Планируемые разделы: Быстрый старт (пример .gitlab-ci.yml для линтинга и проверки несовместимых изменений) Кэширование зависимостей и ускорение сборок Генерация кода и проверка актуальности артефактов Работа с приватными Git-репозиториями в deps Матрицы (parallel jobs) для разных языков и плагинов Автоматизация релизов по тегам"},{"id":"ci-cd/gitlab::top::1","title":"GitLab CI","section":"В процессе разработки","path":"/docs/guide/ci-cd/gitlab","headings":["В процессе разработки"],"excerpt":"В процессе разработки Если вам нужен пример прямо сейчас, базовый минимальный вариант может выглядеть так:","content":"В процессе разработки Если вам нужен пример прямо сейчас, базовый минимальный вариант может выглядеть так:"},{"id":"ci-cd/gitlab::top::2","title":"GitLab CI","section":"В процессе разработки","path":"/docs/guide/ci-cd/gitlab","headings":["В процессе разработки"],"excerpt":"В процессе разработки ```yaml stages: - validate - generate","content":"В процессе разработки ```yaml stages: - validate - generate"},{"id":"ci-cd/gitlab::top::3","title":"GitLab CI","section":"В процессе разработки","path":"/docs/guide/ci-cd/gitlab","headings":["В процессе разработки"],"excerpt":"В процессе разработки variables: GO_VERSION: \"1.22\"","content":"В процессе разработки variables: GO_VERSION: \"1.22\""},{"id":"ci-cd/gitlab::top::4","title":"GitLab CI","section":"В процессе разработки","path":"/docs/guide/ci-cd/gitlab","headings":["В процессе разработки"],"excerpt":"В процессе разработки validate: stage: validate image: golang:${GO_VERSION} before_script: - go install github.com/easyp-tech/easyp/cmd/easyp@latest - echo \"EasyP version:\" - easyp version # При необходимости: git fetch ","content":"В процессе разработки validate: stage: validate image: golang:${GO_VERSION} before_script: - go install github.com/easyp-tech/easyp/cmd/easyp@latest - echo \"EasyP version:\" - easyp version # При необходимости: git fetch --all --tags script: - easyp lint - easyp breaking --against git-ref=origin/main only: changes: - \"**/*.proto\" - \"easyp.yaml\""},{"id":"ci-cd/gitlab::top::5","title":"GitLab CI","section":"В процессе разработки","path":"/docs/guide/ci-cd/gitlab","headings":["В процессе разработки"],"excerpt":"В процессе разработки generate: stage: generate image: golang:${GO_VERSION} before_script: - go install github.com/easyp-tech/easyp/cmd/easyp@latest script: - easyp generate - if [ -n \"$(git status --porcelain)\" ]; then ","content":"В процессе разработки generate: stage: generate image: golang:${GO_VERSION} before_script: - go install github.com/easyp-tech/easyp/cmd/easyp@latest script: - easyp generate - if [ -n \"$(git status --porcelain)\" ]; then echo \"Сгенерированный код не актуален. Закоммитьте изменения локально.\" git diff --name-only exit 1 fi only: - main"},{"id":"ci-cd/gitlab::top::6","title":"GitLab CI","section":"В процессе разработки","path":"/docs/guide/ci-cd/gitlab","headings":["В процессе разработки"],"excerpt":"В процессе разработки Дополнительные рекомендации будут добавлены позже.","content":"В процессе разработки Дополнительные рекомендации будут добавлены позже."},{"id":"cli/auto-completion/auto-completion::zsh::0","title":"Автодополнение","section":"Автодополнение для zsh","path":"/docs/guide/cli/auto-completion/auto-completion#zsh","headings":["Автодополнение для zsh"],"excerpt":"Автодополнение для zsh Добавьте следующую строку в ваш файл запуска ~/.zshrc:","content":"Автодополнение для zsh Добавьте следующую строку в ваш файл запуска ~/.zshrc:"},{"id":"cli/auto-completion/auto-completion::zsh::1","title":"Автодополнение","section":"Автодополнение для zsh","path":"/docs/guide/cli/auto-completion/auto-completion#zsh","headings":["Автодополнение для zsh"],"excerpt":"Автодополнение для zsh Перезапустите оболочку или выполните:","content":"Автодополнение для zsh Перезапустите оболочку или выполните:"},{"id":"cli/auto-completion/auto-completion::bash::2","title":"Автодополнение","section":"Автодополнение для Bash","path":"/docs/guide/cli/auto-completion/auto-completion#bash","headings":["Автодополнение для Bash"],"excerpt":"Автодополнение для Bash Установите bash-completion и подключите его в ~/.bashrc. Добавьте следующую строку в файл запуска ~/.bashrc:","content":"Автодополнение для Bash Установите bash-completion и подключите его в ~/.bashrc. Добавьте следующую строку в файл запуска ~/.bashrc:"},{"id":"cli/auto-completion/auto-completion::bash::3","title":"Автодополнение","section":"Автодополнение для Bash","path":"/docs/guide/cli/auto-completion/auto-completion#bash","headings":["Автодополнение для Bash"],"excerpt":"Автодополнение для Bash Перезапустите оболочку или выполните:","content":"Автодополнение для Bash Перезапустите оболочку или выполните:"},{"id":"cli/auto-completion/auto-completion::top::4","title":"Автодополнение","section":"Примечания","path":"/docs/guide/cli/auto-completion/auto-completion","headings":["Примечания"],"excerpt":"Примечания Команда easyp completion выводит скрипт автодополнения для соответствующей оболочки. Если используете другую оболочку (например, fish), можно сгенерировать вывод и сохранить вручную: При обновлении версии Easy","content":"Примечания Команда easyp completion выводит скрипт автодополнения для соответствующей оболочки. Если используете другую оболочку (например, fish), можно сгенерировать вывод и сохранить вручную: При обновлении версии EasyP рекомендуется заново перезагрузить оболочку, чтобы подтянуть возможные изменения в автодополнении."},{"id":"cli/breaking-changes/breaking-changes::top::0","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":[],"excerpt":"Обнаружение несовместимых изменений (Breaking Changes Detection)","content":"Обнаружение несовместимых изменений (Breaking Changes Detection)"},{"id":"cli/breaking-changes/breaking-changes::top::1","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":[],"excerpt":"Механизм EasyP для обнаружения несовместимых (breaking) изменений помогает поддерживать обратную совместимость ваших protobuf API, автоматически выявляя изменения, способные сломать существующих клиентов. Это критично дл","content":"Механизм EasyP для обнаружения несовместимых (breaking) изменений помогает поддерживать обратную совместимость ваших protobuf API, автоматически выявляя изменения, способные сломать существующих клиентов. Это критично для стабильных API в продакшене."},{"id":"cli/breaking-changes/breaking-changes::top::2","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Обзор","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Обзор"],"excerpt":"Обзор Проверка несовместимых изменений сравнивает текущий набор protobuf‑файлов с предыдущей версией (обычно из другой Git ветки) и фиксирует модификации, которые могут вызвать проблемы совместимости для уже работающих к","content":"Обзор Проверка несовместимых изменений сравнивает текущий набор protobuf‑файлов с предыдущей версией (обычно из другой Git ветки) и фиксирует модификации, которые могут вызвать проблемы совместимости для уже работающих клиентов."},{"id":"cli/breaking-changes/breaking-changes::top::3","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Ключевые возможности","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Ключевые возможности"],"excerpt":"Ключевые возможности **Сравнение через Git**: Сопоставление с любой Git‑ссылкой (ветка, тег, commit) **Комплексный анализ**: Проверка сервисов, сообщений, enum'ов, полей и import'ов **Выборочное игнорирование**: Пропуск ","content":"Ключевые возможности **Сравнение через Git**: Сопоставление с любой Git‑ссылкой (ветка, тег, commit) **Комплексный анализ**: Проверка сервисов, сообщений, enum'ов, полей и import'ов **Выборочное игнорирование**: Пропуск указанных директорий из анализа **Детализированные отчёты**: Понятные ошибки с именами файлов, строками и позициями"},{"id":"cli/breaking-changes/breaking-changes::top::4","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Как работает","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Как работает"],"excerpt":"Как работает Детектор breaking changes выполняет следующие шаги:","content":"Как работает Детектор breaking changes выполняет следующие шаги:"},{"id":"cli/breaking-changes/breaking-changes::top::5","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Как работает","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Как работает"],"excerpt":"Как работает **Получение ветки сравнения**: Забирает proto-файлы из указанной Git‑ссылки **Парсинг обеих версий**: Анализирует структуру текущих и предыдущих файлов **Сравнение сущностей**: Последовательно проверяет все ","content":"Как работает **Получение ветки сравнения**: Забирает proto-файлы из указанной Git‑ссылки **Парсинг обеих версий**: Анализирует структуру текущих и предыдущих файлов **Сравнение сущностей**: Последовательно проверяет все элементы protobuf на breaking изменения **Формирование отчёта**: Генерирует подробные записи об ошибках с локациями и описаниями"},{"id":"cli/breaking-changes/breaking-changes::top::6","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Уровень проверки","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Уровень проверки"],"excerpt":"Уровень проверки EasyP реализует уровень проверки **WIRE+**: ✅ **Полная совместимость по wire‑формату** — старые и новые версии могут обмениваться данными ✅ **Обнаружение удалений элементов** — сервисы, сообщения, поля и","content":"Уровень проверки EasyP реализует уровень проверки **WIRE+**: ✅ **Полная совместимость по wire‑формату** — старые и новые версии могут обмениваться данными ✅ **Обнаружение удалений элементов** — сервисы, сообщения, поля и т.п. ✅ **Безопасность типов** — выявляет несовместимые изменения типов ❌ **Переименования полей/методов** — пока не детектируются (в планах) ❌ **Изменения на уровне файлов** — переносы пакетов, file options ещё не проверяются"},{"id":"cli/breaking-changes/breaking-changes::top::7","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Уровень проверки","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Уровень проверки"],"excerpt":"Уровень проверки Это даёт сильные гарантии совместимости и меньше ограничений, чем инструменты, требующие совместимости сгенерированного кода.","content":"Уровень проверки Это даёт сильные гарантии совместимости и меньше ограничений, чем инструменты, требующие совместимости сгенерированного кода."},{"id":"cli/breaking-changes/breaking-changes::top::8","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Конфигурация","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Конфигурация"],"excerpt":"Конфигурация Настройка в easyp.yaml:","content":"Конфигурация Настройка в easyp.yaml:"},{"id":"cli/breaking-changes/breaking-changes::top::9","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Параметры конфигурации","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Параметры конфигурации"],"excerpt":"Параметры конфигурации Option Description Default Required -------- ------------- --------- ---------- against_git_ref Git‑ссылка для сравнения \"master\" No ignore Список директорий для исключения из анализа [] No","content":"Параметры конфигурации Option Description Default Required -------- ------------- --------- ---------- against_git_ref Git‑ссылка для сравнения \"master\" No ignore Список директорий для исключения из анализа [] No"},{"id":"cli/breaking-changes/breaking-changes::top::10","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Базовый пример","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Базовый пример"],"excerpt":"Базовый пример Сравнение текущих изменений с веткой main:","content":"Базовый пример Сравнение текущих изменений с веткой main:"},{"id":"cli/breaking-changes/breaking-changes::top::11","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Использование файла конфигурации","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Использование файла конфигурации"],"excerpt":"Использование файла конфигурации","content":"Использование файла конфигурации"},{"id":"cli/breaking-changes/breaking-changes::top::12","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Уровень проверки","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Уровень проверки"],"excerpt":"Уровень проверки EasyP сейчас работает на уровне **WIRE+**, обеспечивая совместимость wire‑формата плюс защиту от удалений и изменения критичных типов.","content":"Уровень проверки EasyP сейчас работает на уровне **WIRE+**, обеспечивая совместимость wire‑формата плюс защиту от удалений и изменения критичных типов."},{"id":"cli/breaking-changes/breaking-changes::buf::13","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Сравнение с категориями Buf","path":"/docs/guide/cli/breaking-changes/breaking-changes#buf","headings":["Сравнение с категориями Buf"],"excerpt":"Сравнение с категориями Buf Check Type Buf WIRE Buf WIRE_JSON Buf FILE EasyP Current ------------ ---------- --------------- ---------- --------------- **Element Deletions** Service deletion ❌ ❌ ✅ ✅ RPC method deletion ❌","content":"Сравнение с категориями Buf Check Type Buf WIRE Buf WIRE_JSON Buf FILE EasyP Current ------------ ---------- --------------- ---------- --------------- **Element Deletions** Service deletion ❌ ❌ ✅ ✅ RPC method deletion ❌ ❌ ✅ ✅ Message deletion ❌ ❌ ✅ ✅ Field deletion (by number) ✅ ✅ ✅ ✅ Enum deletion ❌ ❌ ✅ ✅ Enum value deletion ✅ ✅ ✅ ✅ OneOf deletion ❌ ❌ ✅ ✅ Import deletion ❌ ❌ ✅ ✅ **Type Changes** Field type change ✅ ✅ ✅ ✅ RPC request/response type ✅ ✅ ✅ ✅ Optional/required changes ✅ ✅ ✅ ✅ **Naming (Generated Code)** Field rename (same number) ❌ ✅ ✅ ❌ Enum value rename ❌ ✅ ✅ ✅ **File Structure** Package change ✅ ✅ ✅ ❌ File options (go_package, etc) ❌ ❌ ✅ ❌ Moving types between files ❌ ❌ ✅ ❌"},{"id":"cli/breaking-changes/breaking-changes::top::14","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Что это означает","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Что это означает"],"excerpt":"Что это означает **✅ EasyP обнаружит:** Все breaking изменения wire‑формата Удаления сервисов, методов, сообщений, полей Изменения типов, ломающие сериализацию Переименования enum‑значений (при сохранении номера)","content":"Что это означает **✅ EasyP обнаружит:** Все breaking изменения wire‑формата Удаления сервисов, методов, сообщений, полей Изменения типов, ломающие сериализацию Переименования enum‑значений (при сохранении номера)"},{"id":"cli/breaking-changes/breaking-changes::top::15","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Что это означает","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Что это означает"],"excerpt":"Что это означает **❌ EasyP НЕ обнаружит:** Переименование полей (с тем же номером) Изменение package File options (go_package, java_package, и т.п.) Перемещение типов между файлами в одном package","content":"Что это означает **❌ EasyP НЕ обнаружит:** Переименование полей (с тем же номером) Изменение package File options (go_package, java_package, и т.п.) Перемещение типов между файлами в одном package"},{"id":"cli/breaking-changes/breaking-changes::breaking-changes::16","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Правила Breaking Changes","path":"/docs/guide/cli/breaking-changes/breaking-changes#breaking-changes","headings":["Правила Breaking Changes"],"excerpt":"Правила Breaking Changes EasyP обнаруживает следующие типы breaking изменений:","content":"Правила Breaking Changes EasyP обнаруживает следующие типы breaking изменений:"},{"id":"cli/breaking-changes/breaking-changes::top::17","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Сравнение уровней","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Сравнение уровней"],"excerpt":"Сравнение уровней Detection Level Description EasyP Support ---------------- ------------- --------------- **WIRE** Совместимость только по wire‑формату ✅ **Full support** **WIRE+** Wire + обнаружение удалений ✅ **Curren","content":"Сравнение уровней Detection Level Description EasyP Support ---------------- ------------- --------------- **WIRE** Совместимость только по wire‑формату ✅ **Full support** **WIRE+** Wire + обнаружение удалений ✅ **Current level** **FILE** Совместимость сгенерированного кода ❌ Partial (planned)"},{"id":"cli/breaking-changes/breaking-changes::top::18","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Категории правил","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Категории правил"],"excerpt":"Категории правил Каждая категория имеет свою документацию с примерами:","content":"Категории правил Каждая категория имеет свою документацию с примерами:"},{"id":"cli/breaking-changes/breaking-changes::service-rpc::19","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"🚨 Изменения Service и RPC","path":"/docs/guide/cli/breaking-changes/breaking-changes#service-rpc","headings":["🚨 Изменения Service и RPC"],"excerpt":"🚨 Изменения Service и RPC Rule Description Status ------ ------------- --------- SERVICE_NO_DELETE Services cannot be deleted ✅ Implemented RPC_NO_DELETE RPC methods cannot be deleted ✅ Implemented RPC_SAME_REQUEST_TYPE","content":"🚨 Изменения Service и RPC Rule Description Status ------ ------------- --------- SERVICE_NO_DELETE Services cannot be deleted ✅ Implemented RPC_NO_DELETE RPC methods cannot be deleted ✅ Implemented RPC_SAME_REQUEST_TYPE RPC request types cannot be changed ✅ Implemented RPC_SAME_RESPONSE_TYPE RPC response types cannot be changed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::message-field::20","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"📦 Изменения Message и Field","path":"/docs/guide/cli/breaking-changes/breaking-changes#message-field","headings":["📦 Изменения Message и Field"],"excerpt":"📦 Изменения Message и Field Rule Description Status ------ ------------- --------- MESSAGE_NO_DELETE Messages cannot be deleted ✅ Implemented FIELD_NO_DELETE Fields cannot be deleted ✅ Implemented FIELD_SAME_TYPE Field ","content":"📦 Изменения Message и Field Rule Description Status ------ ------------- --------- MESSAGE_NO_DELETE Messages cannot be deleted ✅ Implemented FIELD_NO_DELETE Fields cannot be deleted ✅ Implemented FIELD_SAME_TYPE Field types cannot be changed ✅ Implemented FIELD_SAME_CARDINALITY Field optionality (optional/required) cannot be changed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::enum::21","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"🔢 Изменения Enum","path":"/docs/guide/cli/breaking-changes/breaking-changes#enum","headings":["🔢 Изменения Enum"],"excerpt":"🔢 Изменения Enum Rule Description Status ------ ------------- --------- ENUM_NO_DELETE Enums cannot be deleted ✅ Implemented ENUM_VALUE_NO_DELETE Enum values cannot be deleted ✅ Implemented ENUM_VALUE_SAME_NAME Enum val","content":"🔢 Изменения Enum Rule Description Status ------ ------------- --------- ENUM_NO_DELETE Enums cannot be deleted ✅ Implemented ENUM_VALUE_NO_DELETE Enum values cannot be deleted ✅ Implemented ENUM_VALUE_SAME_NAME Enum value names cannot be changed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::oneof::22","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"🔗 Изменения OneOf","path":"/docs/guide/cli/breaking-changes/breaking-changes#oneof","headings":["🔗 Изменения OneOf"],"excerpt":"🔗 Изменения OneOf Rule Description Status ------ ------------- --------- ONEOF_NO_DELETE OneOf fields cannot be deleted ✅ Implemented ONEOF_FIELD_NO_DELETE Fields within oneofs cannot be deleted ✅ Implemented ONEOF_FIEL","content":"🔗 Изменения OneOf Rule Description Status ------ ------------- --------- ONEOF_NO_DELETE OneOf fields cannot be deleted ✅ Implemented ONEOF_FIELD_NO_DELETE Fields within oneofs cannot be deleted ✅ Implemented ONEOF_FIELD_SAME_TYPE OneOf field types cannot be changed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::import::23","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"📥 Изменения Import","path":"/docs/guide/cli/breaking-changes/breaking-changes#import","headings":["📥 Изменения Import"],"excerpt":"📥 Изменения Import Rule Description Status ------ ------------- --------- IMPORT_NO_DELETE Import statements cannot be removed ✅ Implemented","content":"📥 Изменения Import Rule Description Status ------ ------------- --------- IMPORT_NO_DELETE Import statements cannot be removed ✅ Implemented"},{"id":"cli/breaking-changes/breaking-changes::top::24","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Не обнаруживается сейчас","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Не обнаруживается сейчас"],"excerpt":"Не обнаруживается сейчас Изменения ниже **НЕ детектируются** EasyP (могут ломать сгенерированный код):","content":"Не обнаруживается сейчас Изменения ниже **НЕ детектируются** EasyP (могут ломать сгенерированный код):"},{"id":"cli/breaking-changes/breaking-changes::top::25","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Не обнаруживается сейчас","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Не обнаруживается сейчас"],"excerpt":"Не обнаруживается сейчас Change Type Example Impact ------------- --------- -------- Field renaming string name = 1 → string full_name = 1 Ломает код Package changes package v1 → package v2 Меняются пути импорта File opt","content":"Не обнаруживается сейчас Change Type Example Impact ------------- --------- -------- Field renaming string name = 1 → string full_name = 1 Ломает код Package changes package v1 → package v2 Меняются пути импорта File options option go_package = \"old\" → option go_package = \"new\" Меняется расположение кода Moving between files Message перемещено в другой .proto Зависимости import'ов"},{"id":"cli/breaking-changes/breaking-changes::top::26","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Документация правил","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Документация правил"],"excerpt":"Документация правил См. подробные файлы правил для примеров и стратегий миграции:","content":"Документация правил См. подробные файлы правил для примеров и стратегий миграции:"},{"id":"cli/breaking-changes/breaking-changes::top::27","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Документация правил","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Документация правил"],"excerpt":"Документация правил Service: SERVICE_NO_DELETE, RPC_NO_DELETE, RPC_SAME_REQUEST_TYPE, RPC_SAME_RESPONSE_TYPE Message: MESSAGE_NO_DELETE, FIELD_NO_DELETE, FIELD_SAME_TYPE, FIELD_SAME_CARDINALITY Enum: ENUM_NO_DELETE, ENUM","content":"Документация правил Service: SERVICE_NO_DELETE, RPC_NO_DELETE, RPC_SAME_REQUEST_TYPE, RPC_SAME_RESPONSE_TYPE Message: MESSAGE_NO_DELETE, FIELD_NO_DELETE, FIELD_SAME_TYPE, FIELD_SAME_CARDINALITY Enum: ENUM_NO_DELETE, ENUM_VALUE_NO_DELETE, ENUM_VALUE_SAME_NAME OneOf: ONEOF_NO_DELETE, ONEOF_FIELD_NO_DELETE, ONEOF_FIELD_SAME_TYPE Import: IMPORT_NO_DELETE"},{"id":"cli/breaking-changes/breaking-changes::top::28","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Документация правил","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Документация правил"],"excerpt":"Документация правил Каждое правило содержит: ❌ Плохие примеры (breaking) ✅ Безопасные альтернативы 🔧 Стратегии миграции 📋 Реальные сообщения ошибок из EasyP","content":"Документация правил Каждое правило содержит: ❌ Плохие примеры (breaking) ✅ Безопасные альтернативы 🔧 Стратегии миграции 📋 Реальные сообщения ошибок из EasyP"},{"id":"cli/breaking-changes/breaking-changes::top::29","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"✅ Безопасные изменения (разрешены всегда)","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["✅ Безопасные изменения (разрешены всегда)"],"excerpt":"✅ Безопасные изменения (разрешены всегда) ```proto // Добавление новых элементов — безопасно message User { string name = 1; string email = 2; string phone = 3; // ✅ Новое поле }","content":"✅ Безопасные изменения (разрешены всегда) ```proto // Добавление новых элементов — безопасно message User { string name = 1; string email = 2; string phone = 3; // ✅ Новое поле }"},{"id":"cli/breaking-changes/breaking-changes::top::30","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"✅ Безопасные изменения (разрешены всегда)","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["✅ Безопасные изменения (разрешены всегда)"],"excerpt":"✅ Безопасные изменения (разрешены всегда) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc GetUserProfile(GetUserRequest) returns (UserProfile); // ✅ Новый RPC }","content":"✅ Безопасные изменения (разрешены всегда) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc GetUserProfile(GetUserRequest) returns (UserProfile); // ✅ Новый RPC }"},{"id":"cli/breaking-changes/breaking-changes::top::31","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"✅ Безопасные изменения (разрешены всегда)","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["✅ Безопасные изменения (разрешены всегда)"],"excerpt":"✅ Безопасные изменения (разрешены всегда) enum Status { STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; STATUS_PENDING = 2; // ✅ Новое enum значение } ```","content":"✅ Безопасные изменения (разрешены всегда) enum Status { STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; STATUS_PENDING = 2; // ✅ Новое enum значение } ```"},{"id":"cli/breaking-changes/breaking-changes::top::32","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"❌ Несовместимые изменения (обнаруживаются всегда)","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["❌ Несовместимые изменения (обнаруживаются всегда)"],"excerpt":"❌ Несовместимые изменения (обнаруживаются всегда) ```proto // Удаления и смена типов ломают совместимость message User { string name = 1; // ❌ Удалённое поле }","content":"❌ Несовместимые изменения (обнаруживаются всегда) ```proto // Удаления и смена типов ломают совместимость message User { string name = 1; // ❌ Удалённое поле }"},{"id":"cli/breaking-changes/breaking-changes::top::33","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"❌ Несовместимые изменения (обнаруживаются всегда)","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["❌ Несовместимые изменения (обнаруживаются всегда)"],"excerpt":"❌ Несовместимые изменения (обнаруживаются всегда) service UserService { // ❌ Удалённый RPC метод rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // ❌ Изменён тип запроса } ```","content":"❌ Несовместимые изменения (обнаруживаются всегда) service UserService { // ❌ Удалённый RPC метод rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // ❌ Изменён тип запроса } ```"},{"id":"cli/breaking-changes/breaking-changes::top::34","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Сценарий: Изменения пока не детектируются","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Сценарий: Изменения пока не детектируются"],"excerpt":"Сценарий: Изменения пока не детектируются ```proto // 🟡 Ломает сгенерированный код, но проходит проверки EasyP message User { string user_name = 1; // Переименовано с \"name\" string user_email = 2; // Переименовано с \"em","content":"Сценарий: Изменения пока не детектируются ```proto // 🟡 Ломает сгенерированный код, но проходит проверки EasyP message User { string user_name = 1; // Переименовано с \"name\" string user_email = 2; // Переименовано с \"email\" }"},{"id":"cli/breaking-changes/breaking-changes::top::35","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Сценарий: Изменения пока не детектируются","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Сценарий: Изменения пока не детектируются"],"excerpt":"Сценарий: Изменения пока не детектируются service UserService { rpc GetUserProfile(GetUserRequest) returns (GetUserResponse); // Переименовано с GetUser } ```","content":"Сценарий: Изменения пока не детектируются service UserService { rpc GetUserProfile(GetUserRequest) returns (GetUserResponse); // Переименовано с GetUser } ```"},{"id":"cli/breaking-changes/breaking-changes::top::36","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Текстовый формат (по умолчанию)","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Текстовый формат (по умолчанию)"],"excerpt":"Текстовый формат (по умолчанию)","content":"Текстовый формат (по умолчанию)"},{"id":"cli/breaking-changes/breaking-changes::1::37","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"1. Регулярный запуск","path":"/docs/guide/cli/breaking-changes/breaking-changes#1","headings":["1. Регулярный запуск"],"excerpt":"Регулярный запуск Добавьте проверку несовместимых изменений в CI/CD:","content":"Регулярный запуск Добавьте проверку несовместимых изменений в CI/CD:"},{"id":"cli/breaking-changes/breaking-changes::2::38","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"2. Защита веток","path":"/docs/guide/cli/breaking-changes/breaking-changes#2","headings":["2. Защита веток"],"excerpt":"Защита веток Блокируйте слияния с breaking изменениями:","content":"Защита веток Блокируйте слияния с breaking изменениями:"},{"id":"cli/breaking-changes/breaking-changes::3::39","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"3. Стратегия версионирования","path":"/docs/guide/cli/breaking-changes/breaking-changes#3","headings":["3. Стратегия версионирования"],"excerpt":"Стратегия версионирования При необходимости breaking изменений: Создайте новую версию пакета (myservice.v2) Поддерживайте старую версию в период миграции Добавляйте уведомления о деприкации","content":"Стратегия версионирования При необходимости breaking изменений: Создайте новую версию пакета (myservice.v2) Поддерживайте старую версию в период миграции Добавляйте уведомления о деприкации"},{"id":"cli/breaking-changes/breaking-changes::4::40","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"4. Игнорирование путей","path":"/docs/guide/cli/breaking-changes/breaking-changes#4","headings":["4. Игнорирование путей"],"excerpt":"Игнорирование путей Используйте ignore осознанно:","content":"Игнорирование путей Используйте ignore осознанно:"},{"id":"cli/breaking-changes/breaking-changes::repository-does-not-exist::41","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Проблема: \"Repository does not exist\"","path":"/docs/guide/cli/breaking-changes/breaking-changes#repository-does-not-exist","headings":["Проблема: \"Repository does not exist\""],"excerpt":"Проблема: \"Repository does not exist\" Решение: Выполняйте команду внутри Git репозитория с нужной веткой.","content":"Проблема: \"Repository does not exist\" Решение: Выполняйте команду внутри Git репозитория с нужной веткой."},{"id":"cli/breaking-changes/breaking-changes::cannot-find-git-ref::42","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Проблема: \"Cannot find git ref\"","path":"/docs/guide/cli/breaking-changes/breaking-changes#cannot-find-git-ref","headings":["Проблема: \"Cannot find git ref\""],"excerpt":"Проблема: \"Cannot find git ref\" Решение: Проверьте наличие ссылки:","content":"Проблема: \"Cannot find git ref\" Решение: Проверьте наличие ссылки:"},{"id":"cli/breaking-changes/breaking-changes::top::43","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Проблема: Ложные срабатывания на сгенерированный код","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Проблема: Ложные срабатывания на сгенерированный код"],"excerpt":"Проблема: Ложные срабатывания на сгенерированный код Решение: Исключите директории генерации:","content":"Проблема: Ложные срабатывания на сгенерированный код Решение: Исключите директории генерации:"},{"id":"cli/breaking-changes/breaking-changes::top::44","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Проблема: Очень много изменений","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Проблема: Очень много изменений"],"excerpt":"Проблема: Очень много изменений Решение: Создайте новую версию API Вносите изменения постепенно Используйте feature flags","content":"Проблема: Очень много изменений Решение: Создайте новую версию API Вносите изменения постепенно Используйте feature flags"},{"id":"cli/breaking-changes/breaking-changes::github-actions::45","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"GitHub Actions","path":"/docs/guide/cli/breaking-changes/breaking-changes#github-actions","headings":["GitHub Actions"],"excerpt":"GitHub Actions ```yaml name: API Compatibility Check","content":"GitHub Actions ```yaml name: API Compatibility Check"},{"id":"cli/breaking-changes/breaking-changes::github-actions::46","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"GitHub Actions","path":"/docs/guide/cli/breaking-changes/breaking-changes#github-actions","headings":["GitHub Actions"],"excerpt":"GitHub Actions on: pull_request: branches: [ main ]","content":"GitHub Actions on: pull_request: branches: [ main ]"},{"id":"cli/breaking-changes/breaking-changes::github-actions::47","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"GitHub Actions","path":"/docs/guide/cli/breaking-changes/breaking-changes#github-actions","headings":["GitHub Actions"],"excerpt":"GitHub Actions jobs: breaking-changes: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 with: fetch-depth: 0 - name: Install EasyP run: curl -sSfL https://raw.githubusercontent.com/easyp-tech/easyp/main/install.","content":"GitHub Actions jobs: breaking-changes: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 with: fetch-depth: 0 - name: Install EasyP run: curl -sSfL https://raw.githubusercontent.com/easyp-tech/easyp/main/install.sh sh - name: Check for breaking changes run: ./bin/easyp breaking --against origin/main ```"},{"id":"cli/breaking-changes/breaking-changes::pre-commit-pre-push-hook::48","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Pre-commit / pre-push hook","path":"/docs/guide/cli/breaking-changes/breaking-changes#pre-commit-pre-push-hook","headings":["Pre-commit / pre-push hook"],"excerpt":"Pre-commit / pre-push hook ```bash #!/bin/sh .git/hooks/pre-push","content":"Pre-commit / pre-push hook ```bash #!/bin/sh .git/hooks/pre-push"},{"id":"cli/breaking-changes/breaking-changes::pre-commit-pre-push-hook::49","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Pre-commit / pre-push hook","path":"/docs/guide/cli/breaking-changes/breaking-changes#pre-commit-pre-push-hook","headings":["Pre-commit / pre-push hook"],"excerpt":"Pre-commit / pre-push hook protected_branch='main' current_branch=$(git symbolic-ref HEAD sed -e 's,.*/\\(.*\\),\\1,')","content":"Pre-commit / pre-push hook protected_branch='main' current_branch=$(git symbolic-ref HEAD sed -e 's,.*/\\(.*\\),\\1,')"},{"id":"cli/breaking-changes/breaking-changes::pre-commit-pre-push-hook::50","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Pre-commit / pre-push hook","path":"/docs/guide/cli/breaking-changes/breaking-changes#pre-commit-pre-push-hook","headings":["Pre-commit / pre-push hook"],"excerpt":"Pre-commit / pre-push hook if [ $current_branch = $protected_branch ]; then echo \"Running breaking changes check...\" easyp breaking --against HEAD~1 if [ $? -eq 1 ]; then echo \"❌ Breaking changes detected. Push rejected.","content":"Pre-commit / pre-push hook if [ $current_branch = $protected_branch ]; then echo \"Running breaking changes check...\" easyp breaking --against HEAD~1 if [ $? -eq 1 ]; then echo \"❌ Breaking changes detected. Push rejected.\" exit 1 fi echo \"✅ No breaking changes detected.\" fi ```"},{"id":"cli/breaking-changes/breaking-changes::top::51","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Режим отладки","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Режим отладки"],"excerpt":"Режим отладки Включите debug‑логирование:","content":"Режим отладки Включите debug‑логирование:"},{"id":"cli/breaking-changes/breaking-changes::top::52","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Ручное сравнение","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Ручное сравнение"],"excerpt":"Ручное сравнение Для сложных случаев:","content":"Ручное сравнение Для сложных случаев:"},{"id":"cli/breaking-changes/breaking-changes::top::53","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Оптимизация производительности","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Оптимизация производительности"],"excerpt":"Оптимизация производительности Ограничьте область:","content":"Оптимизация производительности Ограничьте область:"},{"id":"cli/breaking-changes/breaking-changes::top::54","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Оптимизация производительности","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Оптимизация производительности"],"excerpt":"Оптимизация производительности","content":"Оптимизация производительности"},{"id":"cli/breaking-changes/breaking-changes::top::55","title":"Обнаружение несовместимых изменений (Breaking Changes Detection)","section":"Оптимизация производительности","path":"/docs/guide/cli/breaking-changes/breaking-changes","headings":["Оптимизация производительности"],"excerpt":"Оптимизация производительности Механизм обнаружения несовместимых изменений в EasyP обеспечивает надёжную основу для безопасной эволюции protobuf‑схем при сохранении совместимости API.","content":"Оптимизация производительности Механизм обнаружения несовместимых изменений в EasyP обеспечивает надёжную основу для безопасной эволюции protobuf‑схем при сохранении совместимости API."},{"id":"cli/breaking-changes/rules/enum-no-delete::top::0","title":"ENUM_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":[],"excerpt":"Это правило проверяет, что ни один enum не был удалён из proto‑файлов. Удаление enum ломает совместимость по wire‑формату и сгенерированный код: сохранённые данные могут содержать удалённые значения, а клиентский код опи","content":"Это правило проверяет, что ни один enum не был удалён из proto‑файлов. Удаление enum ломает совместимость по wire‑формату и сгенерированный код: сохранённые данные могут содержать удалённые значения, а клиентский код опирается на сгенерированные типы и константы enum."},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::1","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::2","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::3","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::4","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum UserRole { // [!code --] USER_ROLE_UNSPECIFIED = 0; // [!code --] USER_ROLE_ADMIN = 1; // [!code --] USER_ROLE_USER = 2; // [!code --] } // [!code --]","content":"Плохой (Breaking) enum UserRole { // [!code --] USER_ROLE_UNSPECIFIED = 0; // [!code --] USER_ROLE_ADMIN = 1; // [!code --] USER_ROLE_USER = 2; // [!code --] } // [!code --]"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::5","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3; } ```","content":"Плохой (Breaking) message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3; } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::6","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::7","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::8","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::9","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) // UserRole enum удалён — BREAKING CHANGE!","content":"Плохой (Breaking) // UserRole enum удалён — BREAKING CHANGE!"},{"id":"cli/breaking-changes/rules/enum-no-delete::breaking::10","title":"ENUM_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3; // ERROR: UserRole больше не существует } ```","content":"Плохой (Breaking) message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3; // ERROR: UserRole больше не существует } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::11","title":"ENUM_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Удаление вложенного enum:** ```proto // Before message User { string name = 1; Status status = 2; enum Status { // [!code --] STATUS_UNSPECIFIED = 0; // [!code --] STATUS_ACTIVE = 1; // [!code --","content":"Дополнительные примеры **Удаление вложенного enum:** ```proto // Before message User { string name = 1; Status status = 2; enum Status { // [!code --] STATUS_UNSPECIFIED = 0; // [!code --] STATUS_ACTIVE = 1; // [!code --] STATUS_INACTIVE = 2; // [!code --] } // [!code --] }"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::12","title":"ENUM_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - BREAKING CHANGE! message User { string name = 1; Status status = 2; // ERROR: Status удалён // Вложенный enum Status удалён } ```","content":"Дополнительные примеры // After - BREAKING CHANGE! message User { string name = 1; Status status = 2; // ERROR: Status удалён // Вложенный enum Status удалён } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::13","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления — пометить enum deprecated:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления — пометить enum deprecated:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::14","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::15","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::16","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum UserRole { option deprecated = true; // [!code focus] USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_USER = 2; }","content":"Хороший (Безопасный) enum UserRole { option deprecated = true; // [!code focus] USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_USER = 2; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::17","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3 [deprecated = true]; // [!code focus] } ```","content":"Хороший (Безопасный) message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3 [deprecated = true]; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::18","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или заменить новым enum:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или заменить новым enum:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::19","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::20","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::21","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum UserRole { option deprecated = true; // [!code focus] // Старый enum USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_USER = 2; }","content":"Хороший (Безопасный) enum UserRole { option deprecated = true; // [!code focus] // Старый enum USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_USER = 2; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::22","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum UserPermission { // [!code focus] // Новый enum USER_PERMISSION_UNSPECIFIED = 0; // [!code focus] USER_PERMISSION_READ = 1; // [!code focus] USER_PERMISSION_WRITE = 2; // [!code focus] USER_PERM","content":"Хороший (Безопасный) enum UserPermission { // [!code focus] // Новый enum USER_PERMISSION_UNSPECIFIED = 0; // [!code focus] USER_PERMISSION_READ = 1; // [!code focus] USER_PERMISSION_WRITE = 2; // [!code focus] USER_PERMISSION_ADMIN = 3; // [!code focus] } // [!code focus]"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::23","title":"ENUM_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3 [deprecated = true]; // [!code focus] UserPermission created_by_permission = 4; // [!code focus] } ```","content":"Хороший (Безопасный) message Order { string id = 1; OrderStatus status = 2; UserRole created_by_role = 3 [deprecated = true]; // [!code focus] UserPermission created_by_permission = 4; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::24","title":"ENUM_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Данные с удалённым enum не десериализуются корректно **Generated Code:** Тип и константы удаляются — компиляция клиентов ломается **Field References:** Поля с типом удалённого enum становятся нев","content":"Влияние **Wire Format:** Данные с удалённым enum не десериализуются корректно **Generated Code:** Тип и константы удаляются — компиляция клиентов ломается **Field References:** Поля с типом удалённого enum становятся невалидны **Switch Statements:** switch по enum ломается (неизвестные кейсы)"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::25","title":"ENUM_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается:** ```go // Before order := &myapi.Order{ Id: \"order123\", Status: myapi.OrderStatus_ORDER_STATUS_PENDING, CreatedByRole: myapi.UserRole_USER_ROLE_ADMIN, // ERROR после удаления }","content":"Реальный пример **Код клиента ломается:** ```go // Before order := &myapi.Order{ Id: \"order123\", Status: myapi.OrderStatus_ORDER_STATUS_PENDING, CreatedByRole: myapi.UserRole_USER_ROLE_ADMIN, // ERROR после удаления }"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::26","title":"ENUM_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример switch order.CreatedByRole { case myapi.UserRole_USER_ROLE_ADMIN: // ERROR // Admin logic case myapi.UserRole_USER_ROLE_USER: // ERROR // User logic }","content":"Реальный пример switch order.CreatedByRole { case myapi.UserRole_USER_ROLE_ADMIN: // ERROR // Admin logic case myapi.UserRole_USER_ROLE_USER: // ERROR // User logic }"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::27","title":"ENUM_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример // undefined: myapi.UserRole // undefined: myapi.UserRole_USER_ROLE_ADMIN ```","content":"Реальный пример // undefined: myapi.UserRole // undefined: myapi.UserRole_USER_ROLE_ADMIN ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::28","title":"ENUM_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Старые данные становятся нечитаемыми:**","content":"Реальный пример **Старые данные становятся нечитаемыми:**"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::29","title":"ENUM_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Серверная логика ломается:**","content":"Реальный пример **Серверная логика ломается:**"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::30","title":"ENUM_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Депрецируйте enum:** **Пометьте поля со старым enum deprecated:** **Создайте новый enum:** **Сервер обрабатывает оба:** **Удалите старый enum в следующей major‑версии.**","content":"Стратегия миграции **Депрецируйте enum:** **Пометьте поля со старым enum deprecated:** **Создайте новый enum:** **Сервер обрабатывает оба:** **Удалите старый enum в следующей major‑версии.**"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum::31","title":"ENUM_NO_DELETE","section":"Редизайн enum","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum","headings":["Редизайн enum"],"excerpt":"Редизайн enum ```proto enum Priority { option deprecated = true; PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_HIGH = 2; }","content":"Редизайн enum ```proto enum Priority { option deprecated = true; PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_HIGH = 2; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum::32","title":"ENUM_NO_DELETE","section":"Редизайн enum","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum","headings":["Редизайн enum"],"excerpt":"Редизайн enum enum TaskPriority { TASK_PRIORITY_UNSPECIFIED = 0; TASK_PRIORITY_LOW = 1; TASK_PRIORITY_MEDIUM = 2; TASK_PRIORITY_HIGH = 3; TASK_PRIORITY_URGENT = 4; } ```","content":"Редизайн enum enum TaskPriority { TASK_PRIORITY_UNSPECIFIED = 0; TASK_PRIORITY_LOW = 1; TASK_PRIORITY_MEDIUM = 2; TASK_PRIORITY_HIGH = 3; TASK_PRIORITY_URGENT = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum::33","title":"ENUM_NO_DELETE","section":"Консолидация enum","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum","headings":["Консолидация enum"],"excerpt":"Консолидация enum ```proto enum Status { option deprecated = true; STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; }","content":"Консолидация enum ```proto enum Status { option deprecated = true; STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum::34","title":"ENUM_NO_DELETE","section":"Консолидация enum","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum","headings":["Консолидация enum"],"excerpt":"Консолидация enum enum State { option deprecated = true; STATE_UNSPECIFIED = 0; STATE_ENABLED = 1; }","content":"Консолидация enum enum State { option deprecated = true; STATE_UNSPECIFIED = 0; STATE_ENABLED = 1; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum::35","title":"ENUM_NO_DELETE","section":"Консолидация enum","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum","headings":["Консолидация enum"],"excerpt":"Консолидация enum enum EntityStatus { ENTITY_STATUS_UNSPECIFIED = 0; ENTITY_STATUS_ACTIVE = 1; ENTITY_STATUS_INACTIVE = 2; ENTITY_STATUS_ENABLED = 3; ENTITY_STATUS_DISABLED = 4; } ```","content":"Консолидация enum enum EntityStatus { ENTITY_STATUS_UNSPECIFIED = 0; ENTITY_STATUS_ACTIVE = 1; ENTITY_STATUS_INACTIVE = 2; ENTITY_STATUS_ENABLED = 3; ENTITY_STATUS_DISABLED = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum::36","title":"ENUM_NO_DELETE","section":"Перемещение enum в новый пакет","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum","headings":["Перемещение enum в новый пакет"],"excerpt":"Перемещение enum в новый пакет ```proto enum UserRole { option deprecated = true; USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; }","content":"Перемещение enum в новый пакет ```proto enum UserRole { option deprecated = true; USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum::37","title":"ENUM_NO_DELETE","section":"Перемещение enum в новый пакет","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum","headings":["Перемещение enum в новый пакет"],"excerpt":"Перемещение enum в новый пакет import \"common/roles.proto\";","content":"Перемещение enum в новый пакет import \"common/roles.proto\";"},{"id":"cli/breaking-changes/rules/enum-no-delete::enum::38","title":"ENUM_NO_DELETE","section":"Перемещение enum в новый пакет","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete#enum","headings":["Перемещение enum в новый пакет"],"excerpt":"Перемещение enum в новый пакет message Order { UserRole old_role = 3 [deprecated = true]; common.UserRole new_role = 4; } ```","content":"Перемещение enum в новый пакет message Order { UserRole old_role = 3 [deprecated = true]; common.UserRole new_role = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::39","title":"ENUM_NO_DELETE","section":"Версионирование / новая версия пакета","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Версионирование / новая версия пакета"],"excerpt":"Версионирование / новая версия пакета ```proto package myapi.v2;","content":"Версионирование / новая версия пакета ```proto package myapi.v2;"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::40","title":"ENUM_NO_DELETE","section":"Версионирование / новая версия пакета","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Версионирование / новая версия пакета"],"excerpt":"Версионирование / новая версия пакета enum UserPermission { USER_PERMISSION_UNSPECIFIED = 0; USER_PERMISSION_READ = 1; USER_PERMISSION_WRITE = 2; USER_PERMISSION_ADMIN = 3; }","content":"Версионирование / новая версия пакета enum UserPermission { USER_PERMISSION_UNSPECIFIED = 0; USER_PERMISSION_READ = 1; USER_PERMISSION_WRITE = 2; USER_PERMISSION_ADMIN = 3; }"},{"id":"cli/breaking-changes/rules/enum-no-delete::top::41","title":"ENUM_NO_DELETE","section":"Версионирование / новая версия пакета","path":"/docs/guide/cli/breaking-changes/rules/enum-no-delete","headings":["Версионирование / новая версия пакета"],"excerpt":"Версионирование / новая версия пакета message Order { string id = 1; UserPermission created_by_permission = 2; } ```","content":"Версионирование / новая версия пакета message Order { string id = 1; UserPermission created_by_permission = 2; } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::0","title":"ENUM_VALUE_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":[],"excerpt":"Правило проверяет, что ни одно значение enum (enum value) не было удалено. Удаление значения ломает совместимость по wire‑формату и сгенерированный код: в уже сохранённых данных могут присутствовать удалённые значения, а","content":"Правило проверяет, что ни одно значение enum (enum value) не было удалено. Удаление значения ломает совместимость по wire‑формату и сгенерированный код: в уже сохранённых данных могут присутствовать удалённые значения, а клиентский код может ссылаться на соответствующие константы."},{"id":"cli/breaking-changes/rules/enum-value-no-delete::breaking::1","title":"ENUM_VALUE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::breaking::2","title":"ENUM_VALUE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::breaking::3","title":"ENUM_VALUE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; ORDER_STATUS_CANCELLED = 5; }","content":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; ORDER_STATUS_CANCELLED = 5; }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::breaking::4","title":"ENUM_VALUE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; PRIORITY_URGENT = 4; } ```","content":"Плохой (Breaking) enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; PRIORITY_URGENT = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::breaking::5","title":"ENUM_VALUE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::breaking::6","title":"ENUM_VALUE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::breaking::7","title":"ENUM_VALUE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; // ORDER_STATUS_CANCELLED = 5; // [!code --] ","content":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; // ORDER_STATUS_CANCELLED = 5; // [!code --] Удалено значение enum — BREAKING! }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::breaking::8","title":"ENUM_VALUE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; // PRIORITY_URGENT = 4; // [!code --] Удалено значение enum — BREAKING! } ```","content":"Плохой (Breaking) enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; // PRIORITY_URGENT = 4; // [!code --] Удалено значение enum — BREAKING! } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::9","title":"ENUM_VALUE_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Множественное удаление значений:** ```proto // Before enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_GUEST = 1; USER_ROLE_USER = 2; USER_ROLE_MODERATOR = 3; USER_ROLE_ADMIN = 4; USER_ROLE_S","content":"Дополнительные примеры **Множественное удаление значений:** ```proto // Before enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_GUEST = 1; USER_ROLE_USER = 2; USER_ROLE_MODERATOR = 3; USER_ROLE_ADMIN = 4; USER_ROLE_SUPERADMIN = 5; }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::10","title":"ENUM_VALUE_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - BREAKING CHANGES! enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_USER = 2; USER_ROLE_ADMIN = 4; // USER_ROLE_GUEST = 1; // BREAKING: deleted // USER_ROLE_MODERATOR = 3; // BREAKING","content":"Дополнительные примеры // After - BREAKING CHANGES! enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_USER = 2; USER_ROLE_ADMIN = 4; // USER_ROLE_GUEST = 1; // BREAKING: deleted // USER_ROLE_MODERATOR = 3; // BREAKING: deleted // USER_ROLE_SUPERADMIN = 5; // BREAKING: deleted } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::11","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления — пометить значения deprecated:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления — пометить значения deprecated:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::12","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::13","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; ORDER_STATUS_CANCELLED = 5 [deprecated = t","content":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; ORDER_STATUS_CANCELLED = 5 [deprecated = true]; // [!code focus] }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::14","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; PRIORITY_URGENT = 4 [deprecated = true]; // [!code focus] } ```","content":"Хороший (Безопасный) enum Priority { PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; PRIORITY_URGENT = 4 [deprecated = true]; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::15","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или зарезервировать номер и имя после удаления:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или зарезервировать номер и имя после удаления:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::16","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::17","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum OrderStatus { reserved 5; // [!code focus] reserved \"ORDER_STATUS_CANCELLED\"; // [!code focus]","content":"Хороший (Безопасный) enum OrderStatus { reserved 5; // [!code focus] reserved \"ORDER_STATUS_CANCELLED\"; // [!code focus]"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::18","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }","content":"Хороший (Безопасный) ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::19","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum Priority { reserved 4; // [!code focus] reserved \"PRIORITY_URGENT\"; // [!code focus]","content":"Хороший (Безопасный) enum Priority { reserved 4; // [!code focus] reserved \"PRIORITY_URGENT\"; // [!code focus]"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::20","title":"ENUM_VALUE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; } ```","content":"Хороший (Безопасный) PRIORITY_UNSPECIFIED = 0; PRIORITY_LOW = 1; PRIORITY_MEDIUM = 2; PRIORITY_HIGH = 3; } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::21","title":"ENUM_VALUE_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Данные с удалёнными значениями не десериализуются корректно **Generated Code:** Константы исчезают — клиентский код не компилируется **Client Applications:** Ссылки на удалённые значения вызывают","content":"Влияние **Wire Format:** Данные с удалёнными значениями не десериализуются корректно **Generated Code:** Константы исчезают — клиентский код не компилируется **Client Applications:** Ссылки на удалённые значения вызывают ошибки компиляции **Switch Statements:** switch по enum ломается (неизвестные case) **Default Handling:** Поведение при неизвестных значениях меняется"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::22","title":"ENUM_VALUE_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается:** ```go order := &myapi.Order{ Status: myapi.OrderStatus_ORDER_STATUS_CANCELLED, // ERROR после удаления }","content":"Реальный пример **Код клиента ломается:** ```go order := &myapi.Order{ Status: myapi.OrderStatus_ORDER_STATUS_CANCELLED, // ERROR после удаления }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::23","title":"ENUM_VALUE_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример switch order.Status { case myapi.OrderStatus_ORDER_STATUS_PENDING: // Pending case myapi.OrderStatus_ORDER_STATUS_CANCELLED: // ERROR: undefined // Cancellation default: // Unknown } // undefined: myapi.O","content":"Реальный пример switch order.Status { case myapi.OrderStatus_ORDER_STATUS_PENDING: // Pending case myapi.OrderStatus_ORDER_STATUS_CANCELLED: // ERROR: undefined // Cancellation default: // Unknown } // undefined: myapi.OrderStatus_ORDER_STATUS_CANCELLED ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::24","title":"ENUM_VALUE_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Проблемы с уже сохранёнными данными:**","content":"Реальный пример **Проблемы с уже сохранёнными данными:**"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::25","title":"ENUM_VALUE_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Валидация на сервере:** ```go func validateOrderStatus(status OrderStatus) error { switch status { case OrderStatus_ORDER_STATUS_PENDING, OrderStatus_ORDER_STATUS_CONFIRMED, OrderStatus_ORDER_STATUS_SHI","content":"Реальный пример **Валидация на сервере:** ```go func validateOrderStatus(status OrderStatus) error { switch status { case OrderStatus_ORDER_STATUS_PENDING, OrderStatus_ORDER_STATUS_CONFIRMED, OrderStatus_ORDER_STATUS_SHIPPED, OrderStatus_ORDER_STATUS_DELIVERED, OrderStatus_ORDER_STATUS_CANCELLED: // ERROR после удаления return nil default: return errors.New(\"invalid order status\") } }"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::26","title":"ENUM_VALUE_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример func canModifyOrder(order *Order) bool { return order.Status != OrderStatus_ORDER_STATUS_CANCELLED // ERROR } ```","content":"Реальный пример func canModifyOrder(order *Order) bool { return order.Status != OrderStatus_ORDER_STATUS_CANCELLED // ERROR } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::27","title":"ENUM_VALUE_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Сначала пометить deprecated:** **Перестать использовать deprecated значение в новом коде:** **Обработка legacy в клиенте:** **Резервирование после миграции:** **Никогда не переиспользовать номера** —","content":"Стратегия миграции **Сначала пометить deprecated:** **Перестать использовать deprecated значение в новом коде:** **Обработка legacy в клиенте:** **Резервирование после миграции:** **Никогда не переиспользовать номера** — зарезервированы навсегда."},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::28","title":"ENUM_VALUE_NO_DELETE","section":"Предотвращение переиспользования номера","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Предотвращение переиспользования номера"],"excerpt":"Предотвращение переиспользования номера ```proto enum Status { reserved 2; reserved \"STATUS_DELETED\";","content":"Предотвращение переиспользования номера ```proto enum Status { reserved 2; reserved \"STATUS_DELETED\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::top::29","title":"ENUM_VALUE_NO_DELETE","section":"Предотвращение переиспользования номера","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete","headings":["Предотвращение переиспользования номера"],"excerpt":"Предотвращение переиспользования номера STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; STATUS_INACTIVE = 3; // STATUS_DELETED = 2; // Не переиспользуем } ```","content":"Предотвращение переиспользования номера STATUS_UNSPECIFIED = 0; STATUS_ACTIVE = 1; STATUS_INACTIVE = 3; // STATUS_DELETED = 2; // Не переиспользуем } ```"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::json::30","title":"ENUM_VALUE_NO_DELETE","section":"JSON совместимость","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#json","headings":["JSON совместимость"],"excerpt":"JSON совместимость ```proto enum Color { reserved 2; reserved \"RED\";","content":"JSON совместимость ```proto enum Color { reserved 2; reserved \"RED\";"},{"id":"cli/breaking-changes/rules/enum-value-no-delete::json::31","title":"ENUM_VALUE_NO_DELETE","section":"JSON совместимость","path":"/docs/guide/cli/breaking-changes/rules/enum-value-no-delete#json","headings":["JSON совместимость"],"excerpt":"JSON совместимость COLOR_UNSPECIFIED = 0; COLOR_BLUE = 1; COLOR_GREEN = 3; // COLOR_RED = 2; // Был удалён } ```","content":"JSON совместимость COLOR_UNSPECIFIED = 0; COLOR_BLUE = 1; COLOR_GREEN = 3; // COLOR_RED = 2; // Был удалён } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::0","title":"ENUM_VALUE_SAME_NAME","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":[],"excerpt":"Это правило проверяет, что имя enum значения для каждого номера (number) не изменилось. Переименование enum значения при сохранении его номера ломает совместимость JSON и сгенерированный код: клиенты ожидают конкретные и","content":"Это правило проверяет, что имя enum значения для каждого номера (number) не изменилось. Переименование enum значения при сохранении его номера ломает совместимость JSON и сгенерированный код: клиенты ожидают конкретные имена констант."},{"id":"cli/breaking-changes/rules/enum-value-same-name::breaking::1","title":"ENUM_VALUE_SAME_NAME","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-same-name::breaking::2","title":"ENUM_VALUE_SAME_NAME","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-value-same-name::breaking::3","title":"ENUM_VALUE_SAME_NAME","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; } ```","content":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2; ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4; } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::breaking::4","title":"ENUM_VALUE_SAME_NAME","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-same-name::breaking::5","title":"ENUM_VALUE_SAME_NAME","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-value-same-name::breaking::6","title":"ENUM_VALUE_SAME_NAME","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_APPROVED = 2; // [!code --] Было ORDER_STATUS_CONFIRMED ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_COMPLETED = 4; // [","content":"Плохой (Breaking) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_APPROVED = 2; // [!code --] Было ORDER_STATUS_CONFIRMED ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_COMPLETED = 4; // [!code --] Было ORDER_STATUS_DELIVERED } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::7","title":"ENUM_VALUE_SAME_NAME","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Множественные переименования:** ```proto // Before enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_MODERATOR = 2; USER_ROLE_USER = 3; }","content":"Дополнительные примеры **Множественные переименования:** ```proto // Before enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMIN = 1; USER_ROLE_MODERATOR = 2; USER_ROLE_USER = 3; }"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::8","title":"ENUM_VALUE_SAME_NAME","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - ВСЁ BREAKING enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMINISTRATOR = 1; // BREAKING: ADMIN -> ADMINISTRATOR USER_ROLE_MOD = 2; // BREAKING: MODERATOR -> MOD USER_ROLE_MEMBER","content":"Дополнительные примеры // After - ВСЁ BREAKING enum UserRole { USER_ROLE_UNSPECIFIED = 0; USER_ROLE_ADMINISTRATOR = 1; // BREAKING: ADMIN -> ADMINISTRATOR USER_ROLE_MOD = 2; // BREAKING: MODERATOR -> MOD USER_ROLE_MEMBER = 3; // BREAKING: USER -> MEMBER } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::9","title":"ENUM_VALUE_SAME_NAME","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо переименования — добавить новые значения и пометить старые deprecated:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо переименования — добавить новые значения и пометить старые deprecated:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::10","title":"ENUM_VALUE_SAME_NAME","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::11","title":"ENUM_VALUE_SAME_NAME","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2 [deprecated = true]; // [!code focus] ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4 [depre","content":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_CONFIRMED = 2 [deprecated = true]; // [!code focus] ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_DELIVERED = 4 [deprecated = true]; // [!code focus] ORDER_STATUS_APPROVED = 5; // [!code focus] // Новое значение вместо переименования ORDER_STATUS_COMPLETED = 6; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::12","title":"ENUM_VALUE_SAME_NAME","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или создать новую версию enum:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или создать новую версию enum:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::13","title":"ENUM_VALUE_SAME_NAME","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v2; // [!code focus]","content":"Хороший (Безопасный) package myapi.v2; // [!code focus]"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::14","title":"ENUM_VALUE_SAME_NAME","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_APPROVED = 2; // [!code focus] // «Чистые» имена в v2 ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_COMPLETED = 4; // ","content":"Хороший (Безопасный) enum OrderStatus { ORDER_STATUS_UNSPECIFIED = 0; ORDER_STATUS_PENDING = 1; ORDER_STATUS_APPROVED = 2; // [!code focus] // «Чистые» имена в v2 ORDER_STATUS_SHIPPED = 3; ORDER_STATUS_COMPLETED = 4; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::15","title":"ENUM_VALUE_SAME_NAME","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Влияние"],"excerpt":"Влияние **Generated Code:** Меняются имена констант — компиляция клиентов ломается **JSON Compatibility:** JSON использует имена enum — старые документы не парсятся **Client Applications:** Код со старым именем константы","content":"Влияние **Generated Code:** Меняются имена констант — компиляция клиентов ломается **JSON Compatibility:** JSON использует имена enum — старые документы не парсятся **Client Applications:** Код со старым именем константы не компилируется **Documentation:** Документация устаревает с неправильными именами"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::16","title":"ENUM_VALUE_SAME_NAME","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Реальный пример"],"excerpt":"Реальный пример **Ломается код клиента:** ```go // Before status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // handle delivery }","content":"Реальный пример **Ломается код клиента:** ```go // Before status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // handle delivery }"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::17","title":"ENUM_VALUE_SAME_NAME","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Реальный пример"],"excerpt":"Реальный пример // After (переименовано) — ошибки компиляции status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED // ERROR: undefined if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // ERROR: undefined // han","content":"Реальный пример // After (переименовано) — ошибки компиляции status := myapi.OrderStatus_ORDER_STATUS_CONFIRMED // ERROR: undefined if order.Status == myapi.OrderStatus_ORDER_STATUS_DELIVERED { // ERROR: undefined // handle delivery } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::18","title":"ENUM_VALUE_SAME_NAME","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Реальный пример"],"excerpt":"Реальный пример **JSON совместимость ломается:** ```json // Раньше { \"status\": \"ORDER_STATUS_CONFIRMED\" }","content":"Реальный пример **JSON совместимость ломается:** ```json // Раньше { \"status\": \"ORDER_STATUS_CONFIRMED\" }"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::19","title":"ENUM_VALUE_SAME_NAME","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Реальный пример"],"excerpt":"Реальный пример // После { \"status\": \"ORDER_STATUS_APPROVED\" // Старые JSON больше не парсятся } ```","content":"Реальный пример // После { \"status\": \"ORDER_STATUS_APPROVED\" // Старые JSON больше не парсятся } ```"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::20","title":"ENUM_VALUE_SAME_NAME","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Добавьте новое значение вместо переименования:**","content":"Стратегия миграции **Добавьте новое значение вместо переименования:**"},{"id":"cli/breaking-changes/rules/enum-value-same-name::top::21","title":"ENUM_VALUE_SAME_NAME","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Сервер обрабатывает оба значения на переходном этапе** **Мигрируйте клиентов** на новые значения **Удалите (reserve) старое имя и номер** в следующей major‑версии:","content":"Стратегия миграции **Сервер обрабатывает оба значения на переходном этапе** **Мигрируйте клиентов** на новые значения **Удалите (reserve) старое имя и номер** в следующей major‑версии:"},{"id":"cli/breaking-changes/rules/enum-value-same-name::allow-alias::22","title":"ENUM_VALUE_SAME_NAME","section":"Allow Alias (исключение)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#allow-alias","headings":["Allow Alias (исключение)"],"excerpt":"Allow Alias (исключение) С allow_alias = true можно временно иметь два имени для одного номера:","content":"Allow Alias (исключение) С allow_alias = true можно временно иметь два имени для одного номера:"},{"id":"cli/breaking-changes/rules/enum-value-same-name::allow-alias::23","title":"ENUM_VALUE_SAME_NAME","section":"Allow Alias (исключение)","path":"/docs/guide/cli/breaking-changes/rules/enum-value-same-name#allow-alias","headings":["Allow Alias (исключение)"],"excerpt":"Allow Alias (исключение) Примечание: Сейчас EasyP всё равно считает это breaking (может измениться в будущем).","content":"Allow Alias (исключение) Примечание: Сейчас EasyP всё равно считает это breaking (может измениться в будущем)."},{"id":"cli/breaking-changes/rules/field-no-delete::top::0","title":"FIELD_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":[],"excerpt":"Это правило проверяет, что ни одно поле сообщения (message field) не было удалено. Удаление поля ломает совместимость по wire‑формату и сгенерированный код: в существующих данных может присутствовать удалённое поле, а кл","content":"Это правило проверяет, что ни одно поле сообщения (message field) не было удалено. Удаление поля ломает совместимость по wire‑формату и сгенерированный код: в существующих данных может присутствовать удалённое поле, а клиентский код может ссылаться на него."},{"id":"cli/breaking-changes/rules/field-no-delete::breaking::1","title":"FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-no-delete::breaking::2","title":"FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-no-delete::breaking::3","title":"FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message User { string name = 1; string email = 2; int32 age = 3; string phone = 4; // [!code --] } ```","content":"Плохой (Breaking) message User { string name = 1; string email = 2; int32 age = 3; string phone = 4; // [!code --] } ```"},{"id":"cli/breaking-changes/rules/field-no-delete::breaking::4","title":"FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-no-delete::breaking::5","title":"FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-no-delete::breaking::6","title":"FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message User { string name = 1; string email = 2; int32 age = 3; // phone поле удалено — BREAKING CHANGE! } ```","content":"Плохой (Breaking) message User { string name = 1; string email = 2; int32 age = 3; // phone поле удалено — BREAKING CHANGE! } ```"},{"id":"cli/breaking-changes/rules/field-no-delete::top::7","title":"FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления — пометить поле deprecated:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления — пометить поле deprecated:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-no-delete::top::8","title":"FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-no-delete::top::9","title":"FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message User { string name = 1; string email = 2; int32 age = 3; string phone = 4 [deprecated = true]; // [!code focus] } ```","content":"Хороший (Безопасный) message User { string name = 1; string email = 2; int32 age = 3; string phone = 4 [deprecated = true]; // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/field-no-delete::top::10","title":"FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или зарезервировать номер и имя поля после удаления:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или зарезервировать номер и имя поля после удаления:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-no-delete::top::11","title":"FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-no-delete::top::12","title":"FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message User { reserved 4; // [!code focus] reserved \"phone\"; // [!code focus] string name = 1; string email = 2; int32 age = 3; } ```","content":"Хороший (Безопасный) message User { reserved 4; // [!code focus] reserved \"phone\"; // [!code focus] string name = 1; string email = 2; int32 age = 3; } ```"},{"id":"cli/breaking-changes/rules/field-no-delete::top::13","title":"FIELD_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Старые сообщения с удалённым полем некорректно десериализуются **Generated Code:** Удаляются аксессоры (get/set), компиляция клиента ломается **Data Loss:** Потеря сохранённых данных, связанных с","content":"Влияние **Wire Format:** Старые сообщения с удалённым полем некорректно десериализуются **Generated Code:** Удаляются аксессоры (get/set), компиляция клиента ломается **Data Loss:** Потеря сохранённых данных, связанных с полем **JSON Compatibility:** JSON парсеры ожидают наличие поля и могут выдавать ошибки"},{"id":"cli/breaking-changes/rules/field-no-delete::top::14","title":"FIELD_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Сначала пометить deprecated:**","content":"Стратегия миграции **Сначала пометить deprecated:**"},{"id":"cli/breaking-changes/rules/field-no-delete::top::15","title":"FIELD_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Прекратить запись в поле** в прикладном коде","content":"Стратегия миграции **Прекратить запись в поле** в прикладном коде"},{"id":"cli/breaking-changes/rules/field-no-delete::top::16","title":"FIELD_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Зарезервировать поле** в следующей версии, чтобы избежать повторного использования:","content":"Стратегия миграции **Зарезервировать поле** в следующей версии, чтобы избежать повторного использования:"},{"id":"cli/breaking-changes/rules/field-no-delete::top::17","title":"FIELD_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Никогда не переиспользовать номер поля** — должен оставаться в reserved навсегда","content":"Стратегия миграции **Никогда не переиспользовать номер поля** — должен оставаться в reserved навсегда"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::0","title":"FIELD_SAME_CARDINALITY","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":[],"excerpt":"Правило проверяет, что поля сообщений сохраняют ту же кардинальность (обязательность / optional). Изменение кардинальности поля ломает совместимость по wire‑формату и сгенерированный код: семантика присутствия и ожидания","content":"Правило проверяет, что поля сообщений сохраняют ту же кардинальность (обязательность / optional). Изменение кардинальности поля ломает совместимость по wire‑формату и сгенерированный код: семантика присутствия и ожидания клиентского кода отличаются для optional и required (implicit) полей."},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::1","title":"FIELD_SAME_CARDINALITY","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::2","title":"FIELD_SAME_CARDINALITY","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::3","title":"FIELD_SAME_CARDINALITY","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message User { string name = 1; string email = 2; int32 age = 3; }","content":"Плохой (Breaking) message User { string name = 1; string email = 2; int32 age = 3; }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::4","title":"FIELD_SAME_CARDINALITY","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message CreateUserRequest { string name = 1; optional string email = 2; string phone = 3; } ```","content":"Плохой (Breaking) message CreateUserRequest { string name = 1; optional string email = 2; string phone = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::5","title":"FIELD_SAME_CARDINALITY","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::6","title":"FIELD_SAME_CARDINALITY","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::7","title":"FIELD_SAME_CARDINALITY","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message User { string name = 1; optional string email = 2; // [!code --] Было required (implicit), стало optional int32 age = 3; }","content":"Плохой (Breaking) message User { string name = 1; optional string email = 2; // [!code --] Было required (implicit), стало optional int32 age = 3; }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::8","title":"FIELD_SAME_CARDINALITY","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message CreateUserRequest { string name = 1; string email = 2; // [!code --] Было optional, стало требуемым (implicit required) string phone = 3; } ```","content":"Плохой (Breaking) message CreateUserRequest { string name = 1; string email = 2; // [!code --] Было optional, стало требуемым (implicit required) string phone = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::9","title":"FIELD_SAME_CARDINALITY","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Проблемы миграции Proto2 → Proto3:**","content":"Дополнительные примеры **Проблемы миграции Proto2 → Proto3:**"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::10","title":"FIELD_SAME_CARDINALITY","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры ```proto // Before (proto2) syntax = \"proto2\";","content":"Дополнительные примеры ```proto // Before (proto2) syntax = \"proto2\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::11","title":"FIELD_SAME_CARDINALITY","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры message Order { required string id = 1; optional string notes = 2; repeated string tags = 3; }","content":"Дополнительные примеры message Order { required string id = 1; optional string notes = 2; repeated string tags = 3; }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::12","title":"FIELD_SAME_CARDINALITY","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After (proto3) - BREAKING CHANGES! syntax = \"proto3\";","content":"Дополнительные примеры // After (proto3) - BREAKING CHANGES! syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::13","title":"FIELD_SAME_CARDINALITY","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры message Order { string id = 1; // BREAKING: required -> implicit optional string notes = 2; // BREAKING: explicit optional -> implicit optional repeated string tags = 3; // OK } ```","content":"Дополнительные примеры message Order { string id = 1; // BREAKING: required -> implicit optional string notes = 2; // BREAKING: explicit optional -> implicit optional repeated string tags = 3; // OK } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::14","title":"FIELD_SAME_CARDINALITY","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо изменения кардинальности — добавьте новое поле:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо изменения кардинальности — добавьте новое поле:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::15","title":"FIELD_SAME_CARDINALITY","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::16","title":"FIELD_SAME_CARDINALITY","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message User { string name = 1; string email = 2 [deprecated = true]; // [!code focus] Сохраняем старую кардинальность int32 age = 3; optional string email_optional = 4; // [!code focus] Новое option","content":"Хороший (Безопасный) message User { string name = 1; string email = 2 [deprecated = true]; // [!code focus] Сохраняем старую кардинальность int32 age = 3; optional string email_optional = 4; // [!code focus] Новое optional поле }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::17","title":"FIELD_SAME_CARDINALITY","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message CreateUserRequest { string name = 1; optional string email = 2 [deprecated = true]; // [!code focus] string phone = 3; string email_required = 4; // [!code focus] Новое требуемое поле } ```","content":"Хороший (Безопасный) message CreateUserRequest { string name = 1; optional string email = 2 [deprecated = true]; // [!code focus] string phone = 3; string email_required = 4; // [!code focus] Новое требуемое поле } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::18","title":"FIELD_SAME_CARDINALITY","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или создайте новую версию сообщения:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или создайте новую версию сообщения:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::19","title":"FIELD_SAME_CARDINALITY","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v2; // [!code focus]","content":"Хороший (Безопасный) package myapi.v2; // [!code focus]"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::20","title":"FIELD_SAME_CARDINALITY","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message User { string name = 1; optional string email = 2; // [!code focus] Чистая модель в v2 int32 age = 3; }","content":"Хороший (Безопасный) message User { string name = 1; optional string email = 2; // [!code focus] Чистая модель в v2 int32 age = 3; }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::21","title":"FIELD_SAME_CARDINALITY","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message CreateUserRequest { string name = 1; string email = 2; // [!code focus] Требуемое в v2 string phone = 3; } ```","content":"Хороший (Безопасный) message CreateUserRequest { string name = 1; string email = 2; // [!code focus] Требуемое в v2 string phone = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::22","title":"FIELD_SAME_CARDINALITY","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Меняется семантика присутствия — клиенты неправильно ожидают поля **Generated Code:** Меняются методы доступа / проверки (has, clear) **Validation:** Правила проверки обязательности переписываютс","content":"Влияние **Wire Format:** Меняется семантика присутствия — клиенты неправильно ожидают поля **Generated Code:** Меняются методы доступа / проверки (has, clear) **Validation:** Правила проверки обязательности переписываются **Default Values:** Optional и required по‑разному обрабатывают отсутствие значения"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::23","title":"FIELD_SAME_CARDINALITY","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается при смене кардинальности:** ```go // Before - поле фактически требуется (implicit) user := &myapi.User{ Name: \"John\", Email: \"john@example.com\", Age: 30, }","content":"Реальный пример **Код клиента ломается при смене кардинальности:** ```go // Before - поле фактически требуется (implicit) user := &myapi.User{ Name: \"John\", Email: \"john@example.com\", Age: 30, }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::24","title":"FIELD_SAME_CARDINALITY","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Реальный пример"],"excerpt":"Реальный пример if user.Email != \"\" { // Есть значение }","content":"Реальный пример if user.Email != \"\" { // Есть значение }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::25","title":"FIELD_SAME_CARDINALITY","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Реальный пример"],"excerpt":"Реальный пример // After - поле стало optional (pointer) user := &myapi.User{ Name: \"John\", Age: 30, // Email может отсутствовать }","content":"Реальный пример // After - поле стало optional (pointer) user := &myapi.User{ Name: \"John\", Age: 30, // Email может отсутствовать }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::26","title":"FIELD_SAME_CARDINALITY","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Реальный пример"],"excerpt":"Реальный пример if user.Email != nil && *user.Email != \"\" { // Есть значение (новый способ) }","content":"Реальный пример if user.Email != nil && *user.Email != \"\" { // Есть значение (новый способ) }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::27","title":"FIELD_SAME_CARDINALITY","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Реальный пример"],"excerpt":"Реальный пример user.Email = &emailValue // Присваивание указателя вместо строки ```","content":"Реальный пример user.Email = &emailValue // Присваивание указателя вместо строки ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::28","title":"FIELD_SAME_CARDINALITY","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Реальный пример"],"excerpt":"Реальный пример **Валидация на сервере:** ```go // Before func validateUser(user *User) error { if user.Email == \"\" { return errors.New(\"email is required\") } return nil }","content":"Реальный пример **Валидация на сервере:** ```go // Before func validateUser(user *User) error { if user.Email == \"\" { return errors.New(\"email is required\") } return nil }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::29","title":"FIELD_SAME_CARDINALITY","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Реальный пример"],"excerpt":"Реальный пример // After func validateUser(user *User) error { if user.Email == nil { return errors.New(\"email is required\") } if *user.Email == \"\" { return errors.New(\"email cannot be empty\") } return nil } ```","content":"Реальный пример // After func validateUser(user *User) error { if user.Email == nil { return errors.New(\"email is required\") } if *user.Email == \"\" { return errors.New(\"email cannot be empty\") } return nil } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::30","title":"FIELD_SAME_CARDINALITY","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Добавьте новое поле** с нужной кардинальностью:","content":"Стратегия миграции **Добавьте новое поле** с нужной кардинальностью:"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::31","title":"FIELD_SAME_CARDINALITY","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Период двойной записи** — заполняйте оба поля:","content":"Стратегия миграции **Период двойной записи** — заполняйте оба поля:"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::32","title":"FIELD_SAME_CARDINALITY","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Клиенты постепенно переходят**:","content":"Стратегия миграции **Клиенты постепенно переходят**:"},{"id":"cli/breaking-changes/rules/field-same-cardinality::top::33","title":"FIELD_SAME_CARDINALITY","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Удаление старого поля** в следующей major‑версии:","content":"Стратегия миграции **Удаление старого поля** в следующей major‑версии:"},{"id":"cli/breaking-changes/rules/field-same-cardinality::proto2-proto3::34","title":"FIELD_SAME_CARDINALITY","section":"Миграция Proto2 → Proto3","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#proto2-proto3","headings":["Миграция Proto2 → Proto3"],"excerpt":"Миграция Proto2 → Proto3 ```proto syntax = \"proto3\"; message Order { string id = 1; // BREAKING если был required }","content":"Миграция Proto2 → Proto3 ```proto syntax = \"proto3\"; message Order { string id = 1; // BREAKING если был required }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::proto2-proto3::35","title":"FIELD_SAME_CARDINALITY","section":"Миграция Proto2 → Proto3","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#proto2-proto3","headings":["Миграция Proto2 → Proto3"],"excerpt":"Миграция Proto2 → Proto3 // Сохранить семантику: syntax = \"proto3\"; message Order { string id = 1; optional string notes = 2; } ```","content":"Миграция Proto2 → Proto3 // Сохранить семантику: syntax = \"proto3\"; message Order { string id = 1; optional string notes = 2; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::optional-required::36","title":"FIELD_SAME_CARDINALITY","section":"Делать optional поле required","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#optional-required","headings":["Делать optional поле required"],"excerpt":"Делать optional поле required ```proto message CreateUserRequest { string name = 1; string email = 2; // BREAKING (раньше optional) }","content":"Делать optional поле required ```proto message CreateUserRequest { string name = 1; string email = 2; // BREAKING (раньше optional) }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::optional-required::37","title":"FIELD_SAME_CARDINALITY","section":"Делать optional поле required","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#optional-required","headings":["Делать optional поле required"],"excerpt":"Делать optional поле required message CreateUserRequest { string name = 1; optional string email = 2 [deprecated = true]; string required_email = 3; } ```","content":"Делать optional поле required message CreateUserRequest { string name = 1; optional string email = 2 [deprecated = true]; string required_email = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::required-optional::38","title":"FIELD_SAME_CARDINALITY","section":"Делать required поле optional","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#required-optional","headings":["Делать required поле optional"],"excerpt":"Делать required поле optional ```proto message User { optional string phone = 3; // BREAKING (было implicit required) }","content":"Делать required поле optional ```proto message User { optional string phone = 3; // BREAKING (было implicit required) }"},{"id":"cli/breaking-changes/rules/field-same-cardinality::required-optional::39","title":"FIELD_SAME_CARDINALITY","section":"Делать required поле optional","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#required-optional","headings":["Делать required поле optional"],"excerpt":"Делать required поле optional message User { string phone = 3 [deprecated = true]; optional string phone_optional = 4; } ```","content":"Делать required поле optional message User { string phone = 3 [deprecated = true]; optional string phone_optional = 4; } ```"},{"id":"cli/breaking-changes/rules/field-same-cardinality::protobuf::40","title":"FIELD_SAME_CARDINALITY","section":"Типы кардинальности в Protobuf","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#protobuf","headings":["Типы кардинальности в Protobuf"],"excerpt":"Типы кардинальности в Protobuf","content":"Типы кардинальности в Protobuf"},{"id":"cli/breaking-changes/rules/field-same-cardinality::proto3::41","title":"FIELD_SAME_CARDINALITY","section":"Proto3","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#proto3","headings":["Proto3"],"excerpt":"Proto3 **Implicit optional**: string name = 1; **Explicit optional**: optional string email = 2; **Repeated**: repeated string tags = 3; **Map**: map metadata = 4;","content":"Proto3 **Implicit optional**: string name = 1; **Explicit optional**: optional string email = 2; **Repeated**: repeated string tags = 3; **Map**: map metadata = 4;"},{"id":"cli/breaking-changes/rules/field-same-cardinality::proto2::42","title":"FIELD_SAME_CARDINALITY","section":"Proto2","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#proto2","headings":["Proto2"],"excerpt":"Proto2 **Required**: required string id = 1; **Optional**: optional string email = 2; **Repeated**: repeated string tags = 3;","content":"Proto2 **Required**: required string id = 1; **Optional**: optional string email = 2; **Repeated**: repeated string tags = 3;"},{"id":"cli/breaking-changes/rules/field-same-cardinality::breaking::43","title":"FIELD_SAME_CARDINALITY","section":"Матрица Breaking изменений","path":"/docs/guide/cli/breaking-changes/rules/field-same-cardinality#breaking","headings":["Матрица Breaking изменений"],"excerpt":"Матрица Breaking изменений From To Result ------ ---- -------- Required Optional ❌ BREAKING Optional Required ❌ BREAKING Implicit Explicit ❌ BREAKING Explicit Implicit ❌ BREAKING Single Repeated ❌ BREAKING Repeated Singl","content":"Матрица Breaking изменений From To Result ------ ---- -------- Required Optional ❌ BREAKING Optional Required ❌ BREAKING Implicit Explicit ❌ BREAKING Explicit Implicit ❌ BREAKING Single Repeated ❌ BREAKING Repeated Single ❌ BREAKING Field Map ❌ BREAKING Map Field ❌ BREAKING"},{"id":"cli/breaking-changes/rules/field-same-type::top::0","title":"FIELD_SAME_TYPE","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":[],"excerpt":"Правило проверяет, что типы полей сообщений (message fields) не изменяются. Смена типа поля ломает совместимость по wire‑формату и сгенерированный код: бинарное представление и ожидания клиентского кода различаются для р","content":"Правило проверяет, что типы полей сообщений (message fields) не изменяются. Смена типа поля ломает совместимость по wire‑формату и сгенерированный код: бинарное представление и ожидания клиентского кода различаются для разных типов."},{"id":"cli/breaking-changes/rules/field-same-type::breaking::1","title":"FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-type::breaking::2","title":"FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-same-type::breaking::3","title":"FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Product { string name = 1; int32 price = 2; bool available = 3; } ```","content":"Плохой (Breaking) message Product { string name = 1; int32 price = 2; bool available = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-type::breaking::4","title":"FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-type::breaking::5","title":"FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-same-type::breaking::6","title":"FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Product { string name = 1; string price = 2; // [!code --] Changed from int32 to string (изменён тип) bool available = 3; } ```","content":"Плохой (Breaking) message Product { string name = 1; string price = 2; // [!code --] Changed from int32 to string (изменён тип) bool available = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-type::top::7","title":"FIELD_SAME_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Несовместимые изменения типов:** ```proto // Before message Order { string id = 1; int64 timestamp = 2; repeated string tags = 3; OrderStatus status = 4; }","content":"Дополнительные примеры **Несовместимые изменения типов:** ```proto // Before message Order { string id = 1; int64 timestamp = 2; repeated string tags = 3; OrderStatus status = 4; }"},{"id":"cli/breaking-changes/rules/field-same-type::top::8","title":"FIELD_SAME_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - ВСЁ BREAKING message Order { int32 id = 1; // string -> int32: BREAKING string timestamp = 2; // int64 -> string: BREAKING string tags = 3; // repeated -> singular: BREAKING int32 status","content":"Дополнительные примеры // After - ВСЁ BREAKING message Order { int32 id = 1; // string -> int32: BREAKING string timestamp = 2; // int64 -> string: BREAKING string tags = 3; // repeated -> singular: BREAKING int32 status = 4; // enum -> int32: BREAKING } ```"},{"id":"cli/breaking-changes/rules/field-same-type::top::9","title":"FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо смены типа — добавьте новое поле:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо смены типа — добавьте новое поле:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-type::top::10","title":"FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/field-same-type::top::11","title":"FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Product { string name = 1; int32 price = 2 [deprecated = true]; // [!code focus] // Старое поле помечено deprecated bool available = 3; string price_formatted = 4; // [!code focus] // Новое п","content":"Хороший (Безопасный) message Product { string name = 1; int32 price = 2 [deprecated = true]; // [!code focus] // Старое поле помечено deprecated bool available = 3; string price_formatted = 4; // [!code focus] // Новое поле со строковым представлением } ```"},{"id":"cli/breaking-changes/rules/field-same-type::top::12","title":"FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или создайте новую версию сообщения:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или создайте новую версию сообщения:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/field-same-type::top::13","title":"FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v2; // [!code focus] // Новая версия package","content":"Хороший (Безопасный) package myapi.v2; // [!code focus] // Новая версия package"},{"id":"cli/breaking-changes/rules/field-same-type::top::14","title":"FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Product { string name = 1; string price = 2; // [!code focus] // В v2 уже string bool available = 3; } ```","content":"Хороший (Безопасный) message Product { string name = 1; string price = 2; // [!code focus] // В v2 уже string bool available = 3; } ```"},{"id":"cli/breaking-changes/rules/field-same-type::top::15","title":"FIELD_SAME_TYPE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Старые бинарные данные не десериализуются корректно **Generated Code:** Меняются типы в сгенерированном коде — клиенты не компилируются **Runtime Errors:** Ошибки парсинга при несовпадении ожидае","content":"Влияние **Wire Format:** Старые бинарные данные не десериализуются корректно **Generated Code:** Меняются типы в сгенерированном коде — клиенты не компилируются **Runtime Errors:** Ошибки парсинга при несовпадении ожидаемого типа **Data Corruption:** Неверная интерпретация байтов данных"},{"id":"cli/breaking-changes/rules/field-same-type::top::16","title":"FIELD_SAME_TYPE","section":"Типовые проблемы изменений типов","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Типовые проблемы изменений типов"],"excerpt":"Типовые проблемы изменений типов","content":"Типовые проблемы изменений типов"},{"id":"cli/breaking-changes/rules/field-same-type::top::17","title":"FIELD_SAME_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Добавьте новое поле** с нужным типом:","content":"Стратегия миграции **Добавьте новое поле** с нужным типом:"},{"id":"cli/breaking-changes/rules/field-same-type::top::18","title":"FIELD_SAME_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Период двойной записи** — заполняйте оба поля для совместимости","content":"Стратегия миграции **Период двойной записи** — заполняйте оба поля для совместимости"},{"id":"cli/breaking-changes/rules/field-same-type::top::19","title":"FIELD_SAME_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Мигрируйте клиентов** на новое поле постепенно","content":"Стратегия миграции **Мигрируйте клиентов** на новое поле постепенно"},{"id":"cli/breaking-changes/rules/field-same-type::top::20","title":"FIELD_SAME_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/field-same-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Удалите старое поле** в следующей major‑версии:","content":"Стратегия миграции **Удалите старое поле** в следующей major‑версии:"},{"id":"cli/breaking-changes/rules/field-same-type::wire::21","title":"FIELD_SAME_TYPE","section":"Безопасные изменения (Теоретически wire‑совместимые)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#wire","headings":["Безопасные изменения (Теоретически wire‑совместимые)"],"excerpt":"Безопасные изменения (Теоретически wire‑совместимые) Примечание: EasyP сейчас считает ЛЮБУЮ смену типа breaking. Однако технически некоторые случаи совместимы:","content":"Безопасные изменения (Теоретически wire‑совместимые) Примечание: EasyP сейчас считает ЛЮБУЮ смену типа breaking. Однако технически некоторые случаи совместимы:"},{"id":"cli/breaking-changes/rules/field-same-type::wire::22","title":"FIELD_SAME_TYPE","section":"Безопасные изменения (Теоретически wire‑совместимые)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#wire","headings":["Безопасные изменения (Теоретически wire‑совместимые)"],"excerpt":"Безопасные изменения (Теоретически wire‑совместимые) int32 ↔ uint32 (одно кодирование) int64 ↔ uint64 (одно кодирование) string → bytes (если все строки валидный UTF‑8)","content":"Безопасные изменения (Теоретически wire‑совместимые) int32 ↔ uint32 (одно кодирование) int64 ↔ uint64 (одно кодирование) string → bytes (если все строки валидный UTF‑8)"},{"id":"cli/breaking-changes/rules/field-same-type::wire::23","title":"FIELD_SAME_TYPE","section":"Безопасные изменения (Теоретически wire‑совместимые)","path":"/docs/guide/cli/breaking-changes/rules/field-same-type#wire","headings":["Безопасные изменения (Теоретически wire‑совместимые)"],"excerpt":"Безопасные изменения (Теоретически wire‑совместимые) Эти исключения могут получить отдельную обработку в будущих версиях EasyP с более гибкими уровнями строгости.","content":"Безопасные изменения (Теоретически wire‑совместимые) Эти исключения могут получить отдельную обработку в будущих версиях EasyP с более гибкими уровнями строгости."},{"id":"cli/breaking-changes/rules/import-no-delete::top::0","title":"IMPORT_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":[],"excerpt":"Это правило проверяет, что ни одна инструкция import не была удалена из proto‑файла. Удаление import ломает совместимость по wire‑формату и сгенерированный код: типы из импортируемых файлов могли использоваться в текущем","content":"Это правило проверяет, что ни одна инструкция import не была удалена из proto‑файла. Удаление import ломает совместимость по wire‑формату и сгенерированный код: типы из импортируемых файлов могли использоваться в текущем файле, и их удаление делает эти типы недоступными."},{"id":"cli/breaking-changes/rules/import-no-delete::breaking::1","title":"IMPORT_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/import-no-delete::breaking::2","title":"IMPORT_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/import-no-delete::breaking::3","title":"IMPORT_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; import \"common/user.proto\"; import \"common/address.proto\";","content":"Плохой (Breaking) import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; import \"common/user.proto\"; import \"common/address.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::breaking::4","title":"IMPORT_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3; common.User customer = 4; common.Address shipping_address = 5; } ```","content":"Плохой (Breaking) message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3; common.User customer = 4; common.Address shipping_address = 5; } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::breaking::5","title":"IMPORT_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/import-no-delete::breaking::6","title":"IMPORT_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/import-no-delete::breaking::7","title":"IMPORT_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) import \"google/protobuf/timestamp.proto\"; // import \"google/protobuf/duration.proto\"; // [!code --] Удалён import — BREAKING // import \"common/user.proto\"; // [!code --] Удалён import — BREAKING // impo","content":"Плохой (Breaking) import \"google/protobuf/timestamp.proto\"; // import \"google/protobuf/duration.proto\"; // [!code --] Удалён import — BREAKING // import \"common/user.proto\"; // [!code --] Удалён import — BREAKING // import \"common/address.proto\"; // [!code --] Удалён import — BREAKING"},{"id":"cli/breaking-changes/rules/import-no-delete::breaking::8","title":"IMPORT_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3; // ERROR: Duration недоступен common.User customer = 4; // ERROR: User недоступен c","content":"Плохой (Breaking) message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3; // ERROR: Duration недоступен common.User customer = 4; // ERROR: User недоступен common.Address shipping_address = 5; // ERROR: Address недоступен } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::top::9","title":"IMPORT_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Сервис ломается при удалённых import:** ```proto // Before import \"google/api/annotations.proto\"; import \"google/protobuf/empty.proto\"; import \"common/auth.proto\";","content":"Дополнительные примеры **Сервис ломается при удалённых import:** ```proto // Before import \"google/api/annotations.proto\"; import \"google/protobuf/empty.proto\"; import \"common/auth.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::top::10","title":"IMPORT_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры service OrderService { rpc GetOrder(GetOrderRequest) returns (Order) { option (google.api.http) = { get: \"/v1/orders/{id}\" }; } rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty); ","content":"Дополнительные примеры service OrderService { rpc GetOrder(GetOrderRequest) returns (Order) { option (google.api.http) = { get: \"/v1/orders/{id}\" }; } rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty); }"},{"id":"cli/breaking-changes/rules/import-no-delete::top::11","title":"IMPORT_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - BREAKING CHANGES! // import \"google/api/annotations.proto\"; // BREAKING: deleted // import \"google/protobuf/empty.proto\"; // BREAKING: deleted // import \"common/auth.proto\"; // BREAKING:","content":"Дополнительные примеры // After - BREAKING CHANGES! // import \"google/api/annotations.proto\"; // BREAKING: deleted // import \"google/protobuf/empty.proto\"; // BREAKING: deleted // import \"common/auth.proto\"; // BREAKING: deleted"},{"id":"cli/breaking-changes/rules/import-no-delete::top::12","title":"IMPORT_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры service OrderService { rpc GetOrder(GetOrderRequest) returns (Order) { option (google.api.http) = { // ERROR: annotations недоступен get: \"/v1/orders/{id}\" }; } rpc DeleteOrder(common.AuthRequest) ","content":"Дополнительные примеры service OrderService { rpc GetOrder(GetOrderRequest) returns (Order) { option (google.api.http) = { // ERROR: annotations недоступен get: \"/v1/orders/{id}\" }; } rpc DeleteOrder(common.AuthRequest) returns (google.protobuf.Empty); // ERROR: типы недоступны } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::top::13","title":"IMPORT_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления оставьте неиспользуемые import:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления оставьте неиспользуемые import:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/import-no-delete::top::14","title":"IMPORT_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/import-no-delete::top::15","title":"IMPORT_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; // [!code focus] // Оставляем даже если не используется import \"common/user.proto\"; // [!code focus] import \"common/","content":"Хороший (Безопасный) import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; // [!code focus] // Оставляем даже если не используется import \"common/user.proto\"; // [!code focus] import \"common/address.proto\"; // [!code focus]"},{"id":"cli/breaking-changes/rules/import-no-delete::top::16","title":"IMPORT_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Order { string id = 1; google.protobuf.Timestamp created_at = 2; // Поля, использовавшие Duration/User/Address, удалены — import оставлены } ```","content":"Хороший (Безопасный) message Order { string id = 1; google.protobuf.Timestamp created_at = 2; // Поля, использовавшие Duration/User/Address, удалены — import оставлены } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::top::17","title":"IMPORT_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или добавьте новые типы, сохранив старые import:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или добавьте новые типы, сохранив старые import:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/import-no-delete::top::18","title":"IMPORT_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/import-no-delete::top::19","title":"IMPORT_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; // [!code focus] import \"common/user.proto\"; // [!code focus] import \"common/address.proto\"; // [!code focus] import","content":"Хороший (Безопасный) import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\"; // [!code focus] import \"common/user.proto\"; // [!code focus] import \"common/address.proto\"; // [!code focus] import \"common/v2/user.proto\"; // [!code focus] // Новый import"},{"id":"cli/breaking-changes/rules/import-no-delete::top::20","title":"IMPORT_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3 [deprecated = true]; // [!code focus] common.User customer = 4 [deprecated = true","content":"Хороший (Безопасный) message Order { string id = 1; google.protobuf.Timestamp created_at = 2; google.protobuf.Duration processing_time = 3 [deprecated = true]; // [!code focus] common.User customer = 4 [deprecated = true]; // [!code focus] common.Address shipping_address = 5 [deprecated = true]; // [!code focus] int32 processing_seconds = 6; common.v2.UserProfile customer_v2 = 7; string shipping_address_text = 8; } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::top::21","title":"IMPORT_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Влияние"],"excerpt":"Влияние **Generated Code:** Типы пропадают → ошибка компиляции **Wire Format:** Сообщения с удалёнными типами не десериализуются **Field References:** Поля с этими типами становятся невалидны **Service Definitions:** RPC","content":"Влияние **Generated Code:** Типы пропадают → ошибка компиляции **Wire Format:** Сообщения с удалёнными типами не десериализуются **Field References:** Поля с этими типами становятся невалидны **Service Definitions:** RPC с типами из удалённых файлов ломаются **Options Usage:** Пользовательские опции из импортов недоступны"},{"id":"cli/breaking-changes/rules/import-no-delete::top::22","title":"IMPORT_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается:**","content":"Реальный пример **Код клиента ломается:**"},{"id":"cli/breaking-changes/rules/import-no-delete::top::23","title":"IMPORT_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Серверная логика ломается:**","content":"Реальный пример **Серверная логика ломается:**"},{"id":"cli/breaking-changes/rules/import-no-delete::top::24","title":"IMPORT_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Компиляция proto ломается:**","content":"Реальный пример **Компиляция proto ломается:**"},{"id":"cli/breaking-changes/rules/import-no-delete::top::25","title":"IMPORT_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции Сохраняйте import даже если типы более не используются: Добавляйте новые import рядом со старыми: Депрецируйте поля со старыми типами постепенно: Сервер: поддерживайте оба варианта: Удаляйте import тол","content":"Стратегия миграции Сохраняйте import даже если типы более не используются: Добавляйте новые import рядом со старыми: Депрецируйте поля со старыми типами постепенно: Сервер: поддерживайте оба варианта: Удаляйте import только в следующей major‑версии после полной миграции."},{"id":"cli/breaking-changes/rules/import-no-delete::top::26","title":"IMPORT_NO_DELETE","section":"Замена зависимости","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Замена зависимости"],"excerpt":"Замена зависимости ```proto import \"old/user.proto\"; // Старый import \"new/user.proto\"; // Новый","content":"Замена зависимости ```proto import \"old/user.proto\"; // Старый import \"new/user.proto\"; // Новый"},{"id":"cli/breaking-changes/rules/import-no-delete::top::27","title":"IMPORT_NO_DELETE","section":"Замена зависимости","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Замена зависимости"],"excerpt":"Замена зависимости message Order { old.User customer = 4 [deprecated = true]; new.UserProfile customer_v2 = 5; } ```","content":"Замена зависимости message Order { old.User customer = 4 [deprecated = true]; new.UserProfile customer_v2 = 5; } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::top::28","title":"IMPORT_NO_DELETE","section":"Удаление функционала","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Удаление функционала"],"excerpt":"Удаление функционала ```proto import \"feature/analytics.proto\"; // Оставить даже если поле удалено","content":"Удаление функционала ```proto import \"feature/analytics.proto\"; // Оставить даже если поле удалено"},{"id":"cli/breaking-changes/rules/import-no-delete::top::29","title":"IMPORT_NO_DELETE","section":"Удаление функционала","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Удаление функционала"],"excerpt":"Удаление функционала message Order { string id = 1; // feature.AnalyticsData analytics = 2; // Поле удалено, import остаётся } ```","content":"Удаление функционала message Order { string id = 1; // feature.AnalyticsData analytics = 2; // Поле удалено, import остаётся } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::protobuf::30","title":"IMPORT_NO_DELETE","section":"Миграция версии protobuf","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#protobuf","headings":["Миграция версии protobuf"],"excerpt":"Миграция версии protobuf ```proto import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\";","content":"Миграция версии protobuf ```proto import \"google/protobuf/timestamp.proto\"; import \"google/protobuf/duration.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::protobuf::31","title":"IMPORT_NO_DELETE","section":"Миграция версии protobuf","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#protobuf","headings":["Миграция версии protobuf"],"excerpt":"Миграция версии protobuf message Event { google.protobuf.Timestamp timestamp = 1; int64 timestamp_millis = 2; } ```","content":"Миграция версии protobuf message Event { google.protobuf.Timestamp timestamp = 1; int64 timestamp_millis = 2; } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::top::32","title":"IMPORT_NO_DELETE","section":"Упрощение сложных зависимостей","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Упрощение сложных зависимостей"],"excerpt":"Упрощение сложных зависимостей ```proto import \"complex/config.proto\";","content":"Упрощение сложных зависимостей ```proto import \"complex/config.proto\";"},{"id":"cli/breaking-changes/rules/import-no-delete::top::33","title":"IMPORT_NO_DELETE","section":"Упрощение сложных зависимостей","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete","headings":["Упрощение сложных зависимостей"],"excerpt":"Упрощение сложных зависимостей message Settings { complex.ConfigData config = 1 [deprecated = true]; string config_json = 2; } ```","content":"Упрощение сложных зависимостей message Settings { complex.ConfigData config = 1 [deprecated = true]; string config_json = 2; } ```"},{"id":"cli/breaking-changes/rules/import-no-delete::import-vs::34","title":"IMPORT_NO_DELETE","section":"Удаление import vs использование поля","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#import-vs","headings":["Удаление import vs использование поля"],"excerpt":"Удаление import vs использование поля","content":"Удаление import vs использование поля"},{"id":"cli/breaking-changes/rules/import-no-delete::import::35","title":"IMPORT_NO_DELETE","section":"Аудит import","path":"/docs/guide/cli/breaking-changes/rules/import-no-delete#import","headings":["Аудит import"],"excerpt":"Аудит import (Даже если не найдено — не удаляем.)","content":"Аудит import (Даже если не найдено — не удаляем.)"},{"id":"cli/breaking-changes/rules/message-no-delete::top::0","title":"MESSAGE_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":[],"excerpt":"Это правило проверяет, что ни одно сообщение (message) не было удалено из proto‑файлов. Удаление message ломает совместимость по wire‑формату и сгенерированный код: в существующих данных могут присутствовать экземпляры у","content":"Это правило проверяет, что ни одно сообщение (message) не было удалено из proto‑файлов. Удаление message ломает совместимость по wire‑формату и сгенерированный код: в существующих данных могут присутствовать экземпляры удалённого типа, а клиентский код зависит от сгенерированных структур и классов."},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::1","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::2","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::3","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message User { string name = 1; string email = 2; Address address = 3; }","content":"Плохой (Breaking) message User { string name = 1; string email = 2; Address address = 3; }"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::4","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Address { // [!code --] string street = 1; // [!code --] string city = 2; // [!code --] string country = 3; // [!code --] } // [!code --]","content":"Плохой (Breaking) message Address { // [!code --] string street = 1; // [!code --] string city = 2; // [!code --] string country = 3; // [!code --] } // [!code --]"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::5","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Order { string id = 1; User user = 2; } ```","content":"Плохой (Breaking) message Order { string id = 1; User user = 2; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::6","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::7","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::8","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message User { string name = 1; string email = 2; Address address = 3; // ERROR: Address больше не существует }","content":"Плохой (Breaking) message User { string name = 1; string email = 2; Address address = 3; // ERROR: Address больше не существует }"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::9","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) // Address удалён — BREAKING CHANGE!","content":"Плохой (Breaking) // Address удалён — BREAKING CHANGE!"},{"id":"cli/breaking-changes/rules/message-no-delete::breaking::10","title":"MESSAGE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Order { string id = 1; User user = 2; } ```","content":"Плохой (Breaking) message Order { string id = 1; User user = 2; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::top::11","title":"MESSAGE_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Удаление вложенного сообщения:**","content":"Дополнительные примеры **Удаление вложенного сообщения:**"},{"id":"cli/breaking-changes/rules/message-no-delete::top::12","title":"MESSAGE_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры ```proto // Before message User { string name = 1; Profile profile = 2; message Profile { // [!code --] string bio = 1; // [!code --] string avatar_url = 2; // [!code --] } // [!code --] }","content":"Дополнительные примеры ```proto // Before message User { string name = 1; Profile profile = 2; message Profile { // [!code --] string bio = 1; // [!code --] string avatar_url = 2; // [!code --] } // [!code --] }"},{"id":"cli/breaking-changes/rules/message-no-delete::top::13","title":"MESSAGE_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - BREAKING CHANGE! message User { string name = 1; Profile profile = 2; // ERROR: Profile удалён // Вложенное сообщение Profile удалено } ```","content":"Дополнительные примеры // After - BREAKING CHANGE! message User { string name = 1; Profile profile = 2; // ERROR: Profile удалён // Вложенное сообщение Profile удалено } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::top::14","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления — пометить как deprecated:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления — пометить как deprecated:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/message-no-delete::top::15","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/message-no-delete::top::16","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message User { string name = 1; string email = 2; Address address = 3 [deprecated = true]; // [!code focus] }","content":"Хороший (Безопасный) message User { string name = 1; string email = 2; Address address = 3 [deprecated = true]; // [!code focus] }"},{"id":"cli/breaking-changes/rules/message-no-delete::top::17","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Address { option deprecated = true; // [!code focus] string street = 1; string city = 2; string country = 3; }","content":"Хороший (Безопасный) message Address { option deprecated = true; // [!code focus] string street = 1; string city = 2; string country = 3; }"},{"id":"cli/breaking-changes/rules/message-no-delete::top::18","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Order { string id = 1; User user = 2; } ```","content":"Хороший (Безопасный) message Order { string id = 1; User user = 2; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::top::19","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или заменить новой версией сообщения:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или заменить новой версией сообщения:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/message-no-delete::top::20","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/message-no-delete::top::21","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message User { string name = 1; string email = 2; Address address = 3 [deprecated = true]; // [!code focus] // Старое поле AddressV2 address_v2 = 4; // [!code focus] // Новая улучшенная структура }","content":"Хороший (Безопасный) message User { string name = 1; string email = 2; Address address = 3 [deprecated = true]; // [!code focus] // Старое поле AddressV2 address_v2 = 4; // [!code focus] // Новая улучшенная структура }"},{"id":"cli/breaking-changes/rules/message-no-delete::top::22","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Address { option deprecated = true; // [!code focus] string street = 1; string city = 2; string country = 3; }","content":"Хороший (Безопасный) message Address { option deprecated = true; // [!code focus] string street = 1; string city = 2; string country = 3; }"},{"id":"cli/breaking-changes/rules/message-no-delete::top::23","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message AddressV2 { // [!code focus] string street_address = 1; // [!code focus] string city = 2; // [!code focus] string state = 3; // [!code focus] string postal_code = 4; // [!code focus] string c","content":"Хороший (Безопасный) message AddressV2 { // [!code focus] string street_address = 1; // [!code focus] string city = 2; // [!code focus] string state = 3; // [!code focus] string postal_code = 4; // [!code focus] string country = 5; // [!code focus] } // [!code focus]"},{"id":"cli/breaking-changes/rules/message-no-delete::top::24","title":"MESSAGE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message Order { string id = 1; User user = 2; } ```","content":"Хороший (Безопасный) message Order { string id = 1; User user = 2; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::top::25","title":"MESSAGE_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Старые данные с удалённым сообщением не десериализуются **Generated Code:** Классы/структуры удаляются — компиляция клиента ломается **Field References:** Поля, использующие удалённый тип, станов","content":"Влияние **Wire Format:** Старые данные с удалённым сообщением не десериализуются **Generated Code:** Классы/структуры удаляются — компиляция клиента ломается **Field References:** Поля, использующие удалённый тип, становятся невалидны **Nested Dependencies:** Все сообщения, ссылающиеся на удалённый тип, ломаются"},{"id":"cli/breaking-changes/rules/message-no-delete::top::26","title":"MESSAGE_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается:** ```go // Before user := &myapi.User{ Name: \"John Doe\", Email: \"john@example.com\", Address: &myapi.Address{ // ERROR после удаления Street: \"123 Main St\", City: \"New York\", Countr","content":"Реальный пример **Код клиента ломается:** ```go // Before user := &myapi.User{ Name: \"John Doe\", Email: \"john@example.com\", Address: &myapi.Address{ // ERROR после удаления Street: \"123 Main St\", City: \"New York\", Country: \"USA\", }, }"},{"id":"cli/breaking-changes/rules/message-no-delete::top::27","title":"MESSAGE_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример // undefined: myapi.Address ```","content":"Реальный пример // undefined: myapi.Address ```"},{"id":"cli/breaking-changes/rules/message-no-delete::top::28","title":"MESSAGE_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Старые данные становятся нечитаемыми:**","content":"Реальный пример **Старые данные становятся нечитаемыми:**"},{"id":"cli/breaking-changes/rules/message-no-delete::top::29","title":"MESSAGE_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Пометить как deprecated:** **Пометить поля, использующие его:** **Добавить замену при необходимости:** **Удалить в следующей major‑версии после периода миграции**","content":"Стратегия миграции **Пометить как deprecated:** **Пометить поля, использующие его:** **Добавить замену при необходимости:** **Удалить в следующей major‑версии после периода миграции**"},{"id":"cli/breaking-changes/rules/message-no-delete::top::30","title":"MESSAGE_NO_DELETE","section":"Рефакторинг структуры","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Рефакторинг структуры"],"excerpt":"Рефакторинг структуры ```proto message UserInfo { option deprecated = true; string name = 1; string email = 2; }","content":"Рефакторинг структуры ```proto message UserInfo { option deprecated = true; string name = 1; string email = 2; }"},{"id":"cli/breaking-changes/rules/message-no-delete::top::31","title":"MESSAGE_NO_DELETE","section":"Рефакторинг структуры","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Рефакторинг структуры"],"excerpt":"Рефакторинг структуры message UserProfile { string full_name = 1; string email_address = 2; string phone = 3; } ```","content":"Рефакторинг структуры message UserProfile { string full_name = 1; string email_address = 2; string phone = 3; } ```"},{"id":"cli/breaking-changes/rules/message-no-delete::top::32","title":"MESSAGE_NO_DELETE","section":"Удаление «неиспользуемых» сообщений","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Удаление «неиспользуемых» сообщений"],"excerpt":"Удаление «неиспользуемых» сообщений","content":"Удаление «неиспользуемых» сообщений"},{"id":"cli/breaking-changes/rules/message-no-delete::top::33","title":"MESSAGE_NO_DELETE","section":"Миграция версии","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Миграция версии"],"excerpt":"Миграция версии ```proto package myapi.v2;","content":"Миграция версии ```proto package myapi.v2;"},{"id":"cli/breaking-changes/rules/message-no-delete::top::34","title":"MESSAGE_NO_DELETE","section":"Миграция версии","path":"/docs/guide/cli/breaking-changes/rules/message-no-delete","headings":["Миграция версии"],"excerpt":"Миграция версии message User { // Новая структура без устаревших ссылок } ```","content":"Миграция версии message User { // Новая структура без устаревших ссылок } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::0","title":"ONEOF_FIELD_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":[],"excerpt":"Правило проверяет, что ни одно поле внутри oneof группы не было удалено. Удаление поля из oneof ломает совместимость по wire‑формату и сгенерированный код: в сохранённых данных может присутствовать выбранный вариант, а к","content":"Правило проверяет, что ни одно поле внутри oneof группы не было удалено. Удаление поля из oneof ломает совместимость по wire‑формату и сгенерированный код: в сохранённых данных может присутствовать выбранный вариант, а клиентский код опирается на сгенерированные типы‑обёртки и методы доступа."},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::breaking::1","title":"ONEOF_FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::breaking::2","title":"ONEOF_FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::breaking::3","title":"ONEOF_FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4; string certificate = 5; } }","content":"Плохой (Breaking) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4; string certificate = 5; } }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::breaking::4","title":"ONEOF_FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; string category = 3; DateRange date_range = 4; } } ```","content":"Плохой (Breaking) message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; string category = 3; DateRange date_range = 4; } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::breaking::5","title":"ONEOF_FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::breaking::6","title":"ONEOF_FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::breaking::7","title":"ONEOF_FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; // string oauth_token = 4; // [!code --] Удалено поле oneof — BREAKING! // string certificate = 5","content":"Плохой (Breaking) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; // string oauth_token = 4; // [!code --] Удалено поле oneof — BREAKING! // string certificate = 5; // [!code --] Удалено поле oneof — BREAKING! } }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::breaking::8","title":"ONEOF_FIELD_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; // string category = 3; // [!code --] Удалено поле oneof — BREAKING! // DateRange date_range = 4; // [!code --] Удалено поле oneo","content":"Плохой (Breaking) message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; // string category = 3; // [!code --] Удалено поле oneof — BREAKING! // DateRange date_range = 4; // [!code --] Удалено поле oneof — BREAKING! } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::9","title":"ONEOF_FIELD_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Удаление вложенных oneof полей:** ```proto // Before message PaymentRequest { string order_id = 1; oneof payment_method { CreditCardPayment credit_card = 2; BankTransferPayment bank_transfer = 3;","content":"Дополнительные примеры **Удаление вложенных oneof полей:** ```proto // Before message PaymentRequest { string order_id = 1; oneof payment_method { CreditCardPayment credit_card = 2; BankTransferPayment bank_transfer = 3; CryptoPayment crypto = 4; // [!code --] GiftCardPayment gift_card = 5; // [!code --] } }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::10","title":"ONEOF_FIELD_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - BREAKING CHANGES! message PaymentRequest { string order_id = 1; oneof payment_method { CreditCardPayment credit_card = 2; BankTransferPayment bank_transfer = 3; // CryptoPayment crypto =","content":"Дополнительные примеры // After - BREAKING CHANGES! message PaymentRequest { string order_id = 1; oneof payment_method { CreditCardPayment credit_card = 2; BankTransferPayment bank_transfer = 3; // CryptoPayment crypto = 4; // BREAKING: deleted // GiftCardPayment gift_card = 5; // BREAKING: deleted } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::11","title":"ONEOF_FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления — пометить поля deprecated:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления — пометить поля deprecated:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::12","title":"ONEOF_FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::13","title":"ONEOF_FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4 [deprecated = true]; // [!code focus] string certificate = 5 [deprecate","content":"Хороший (Безопасный) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4 [deprecated = true]; // [!code focus] string certificate = 5 [deprecated = true]; // [!code focus] } }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::14","title":"ONEOF_FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; string category = 3 [deprecated = true]; // [!code focus] DateRange date_range = 4 [deprecated = true]; // [!code focus] } } `","content":"Хороший (Безопасный) message SearchQuery { oneof filter { string text = 1; int32 user_id = 2; string category = 3 [deprecated = true]; // [!code focus] DateRange date_range = 4 [deprecated = true]; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::15","title":"ONEOF_FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или добавить новые поля, оставив старые:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или добавить новые поля, оставив старые:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::16","title":"ONEOF_FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::17","title":"ONEOF_FIELD_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4 [deprecated = true]; // [!code focus] // Старое поле string certificate","content":"Хороший (Безопасный) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4 [deprecated = true]; // [!code focus] // Старое поле string certificate = 5 [deprecated = true]; // [!code focus] OAuthCredentials oauth_v2 = 6; // [!code focus] // Новый структурированный вариант CertificateCredentials cert_v2 = 7; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::18","title":"ONEOF_FIELD_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Данные, содержащие удалённый вариант, не десериализуются корректно **Generated Code:** Удаляются типы‑обёртки и accessor методы — компиляция клиентов ломается **Type Safety:** Логика switch по ти","content":"Влияние **Wire Format:** Данные, содержащие удалённый вариант, не десериализуются корректно **Generated Code:** Удаляются типы‑обёртки и accessor методы — компиляция клиентов ломается **Type Safety:** Логика switch по типам oneof разваливается **Business Logic:** Код, ожидающий конкретный вариант, перестаёт работать"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::19","title":"ONEOF_FIELD_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается:** ```go // Before loginReq := &myapi.LoginRequest{ Username: \"user123\", }","content":"Реальный пример **Код клиента ломается:** ```go // Before loginReq := &myapi.LoginRequest{ Username: \"user123\", }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::20","title":"ONEOF_FIELD_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример loginReq.Credentials = &myapi.LoginRequest_OauthToken{ OauthToken: \"token123\", // ERROR после удаления поля }","content":"Реальный пример loginReq.Credentials = &myapi.LoginRequest_OauthToken{ OauthToken: \"token123\", // ERROR после удаления поля }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::21","title":"ONEOF_FIELD_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример switch cred := loginReq.Credentials.(type) { case *myapi.LoginRequest_Password: return authenticatePassword(cred.Password) case *myapi.LoginRequest_OauthToken: // ERROR: тип удалён return authenticateOAut","content":"Реальный пример switch cred := loginReq.Credentials.(type) { case *myapi.LoginRequest_Password: return authenticatePassword(cred.Password) case *myapi.LoginRequest_OauthToken: // ERROR: тип удалён return authenticateOAuth(cred.OauthToken) case *myapi.LoginRequest_Certificate: // ERROR: тип удалён return authenticateCert(cred.Certificate) default: return errors.New(\"unsupported credential type\") } // undefined: myapi.LoginRequest_OauthToken // undefined: myapi.LoginRequest_Certificate ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::22","title":"ONEOF_FIELD_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Серверная логика ломается:**","content":"Реальный пример **Серверная логика ломается:**"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::23","title":"ONEOF_FIELD_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Старые данные становятся нечитаемыми:**","content":"Реальный пример **Старые данные становятся нечитаемыми:**"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::24","title":"ONEOF_FIELD_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Депрецируйте сначала:** **Добавьте новые структурированные поля:** **Сервер: поддерживайте оба варианта:** **Мигрируйте клиентов на новое поле:** **Зарезервируйте номера удалённых полей в следующей m","content":"Стратегия миграции **Депрецируйте сначала:** **Добавьте новые структурированные поля:** **Сервер: поддерживайте оба варианта:** **Мигрируйте клиентов на новое поле:** **Зарезервируйте номера удалённых полей в следующей major‑версии:**"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::25","title":"ONEOF_FIELD_NO_DELETE","section":"Удаление неподдерживаемых методов аутентификации","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Удаление неподдерживаемых методов аутентификации"],"excerpt":"Удаление неподдерживаемых методов аутентификации","content":"Удаление неподдерживаемых методов аутентификации"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::26","title":"ONEOF_FIELD_NO_DELETE","section":"Изменения бизнес‑логики платежей","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Изменения бизнес‑логики платежей"],"excerpt":"Изменения бизнес‑логики платежей","content":"Изменения бизнес‑логики платежей"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::oneof-field-deletion-vs::27","title":"ONEOF_FIELD_NO_DELETE","section":"OneOf Field Deletion vs обычное удаление","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete#oneof-field-deletion-vs","headings":["OneOf Field Deletion vs обычное удаление"],"excerpt":"OneOf Field Deletion vs обычное удаление","content":"OneOf Field Deletion vs обычное удаление"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::28","title":"ONEOF_FIELD_NO_DELETE","section":"Отличия от удаления обычного поля","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Отличия от удаления обычного поля"],"excerpt":"Отличия от удаления обычного поля ```proto message User { string name = 1; // string email = 2; // BREAKING: обычное поле }","content":"Отличия от удаления обычного поля ```proto message User { string name = 1; // string email = 2; // BREAKING: обычное поле }"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::29","title":"ONEOF_FIELD_NO_DELETE","section":"Отличия от удаления обычного поля","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Отличия от удаления обычного поля"],"excerpt":"Отличия от удаления обычного поля message User { oneof contact { string email = 1; // string phone = 2; // BREAKING: поле в oneof } } ```","content":"Отличия от удаления обычного поля message User { oneof contact { string email = 1; // string phone = 2; // BREAKING: поле в oneof } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::30","title":"ONEOF_FIELD_NO_DELETE","section":"Влияние на сгенерированный код","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Влияние на сгенерированный код"],"excerpt":"Влияние на сгенерированный код ```go // Обычное поле: удаляется простой геттер // user.GetEmail()","content":"Влияние на сгенерированный код ```go // Обычное поле: удаляется простой геттер // user.GetEmail()"},{"id":"cli/breaking-changes/rules/oneof-field-no-delete::top::31","title":"ONEOF_FIELD_NO_DELETE","section":"Влияние на сгенерированный код","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete","headings":["Влияние на сгенерированный код"],"excerpt":"Влияние на сгенерированный код // Поле в oneof: пропадает тип-обёртка, кейсы switch ломаются // *LoginRequest_OauthToken ```","content":"Влияние на сгенерированный код // Поле в oneof: пропадает тип-обёртка, кейсы switch ломаются // *LoginRequest_OauthToken ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::0","title":"ONEOF_FIELD_SAME_TYPE","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":[],"excerpt":"Это правило проверяет, что тип поля внутри oneof НЕ меняется. Смена типа любого варианта oneof — несовместимое (breaking) изменение: существующие данные сериализованы с прежним типом, а клиентский код ожидает конкретные ","content":"Это правило проверяет, что тип поля внутри oneof НЕ меняется. Смена типа любого варианта oneof — несовместимое (breaking) изменение: существующие данные сериализованы с прежним типом, а клиентский код ожидает конкретные типы-обёртки и методы доступа, сгенерированные для каждого варианта."},{"id":"cli/breaking-changes/rules/oneof-field-same-type::breaking::1","title":"ONEOF_FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::breaking::2","title":"ONEOF_FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::breaking::3","title":"ONEOF_FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message SearchRequest { string query = 1; oneof filter { string category = 2; int32 user_id = 3; bool is_premium = 4; DateRange date_range = 5; } }","content":"Плохой (Breaking) message SearchRequest { string query = 1; oneof filter { string category = 2; int32 user_id = 3; bool is_premium = 4; DateRange date_range = 5; } }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::breaking::4","title":"ONEOF_FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message NotificationSettings { oneof delivery { string email = 1; int64 phone_number = 2; WebhookConfig webhook = 3; } } ```","content":"Плохой (Breaking) message NotificationSettings { oneof delivery { string email = 1; int64 phone_number = 2; WebhookConfig webhook = 3; } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::breaking::5","title":"ONEOF_FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::breaking::6","title":"ONEOF_FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::breaking::7","title":"ONEOF_FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message SearchRequest { string query = 1; oneof filter { int32 category = 2; // [!code --] Было string -> стало int32 (BREAKING) string user_id = 3; // [!code --] Было int32 -> стало string (BREAKING) s","content":"Плохой (Breaking) message SearchRequest { string query = 1; oneof filter { int32 category = 2; // [!code --] Было string -> стало int32 (BREAKING) string user_id = 3; // [!code --] Было int32 -> стало string (BREAKING) string is_premium = 4; // [!code --] Было bool -> стало string (BREAKING) string date_range = 5; // [!code --] Было DateRange -> стало string (BREAKING) } }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::breaking::8","title":"ONEOF_FIELD_SAME_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message NotificationSettings { oneof delivery { EmailConfig email = 1; // [!code --] Было string -> стало EmailConfig (BREAKING) string phone_number = 2; // [!code --] Было int64 -> стало string (BREAKI","content":"Плохой (Breaking) message NotificationSettings { oneof delivery { EmailConfig email = 1; // [!code --] Было string -> стало EmailConfig (BREAKING) string phone_number = 2; // [!code --] Было int64 -> стало string (BREAKING) string webhook = 3; // [!code --] Было WebhookConfig -> стало string (BREAKING) } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::9","title":"ONEOF_FIELD_SAME_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Комплексные изменения типов:** ```proto // Before message PaymentRequest { oneof payment_info { CreditCardInfo credit_card = 1; BankAccountInfo bank_account = 2; string paypal_email = 3; CryptoWa","content":"Дополнительные примеры **Комплексные изменения типов:** ```proto // Before message PaymentRequest { oneof payment_info { CreditCardInfo credit_card = 1; BankAccountInfo bank_account = 2; string paypal_email = 3; CryptoWalletInfo crypto = 4; } }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::10","title":"ONEOF_FIELD_SAME_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - ВСЁ BREAKING message PaymentRequest { oneof payment_info { string credit_card = 1; // CreditCardInfo -> string PayPalInfo bank_account = 2; // BankAccountInfo -> PayPalInfo PayPalInfo pa","content":"Дополнительные примеры // After - ВСЁ BREAKING message PaymentRequest { oneof payment_info { string credit_card = 1; // CreditCardInfo -> string PayPalInfo bank_account = 2; // BankAccountInfo -> PayPalInfo PayPalInfo paypal_email = 3; // string -> PayPalInfo string crypto = 4; // CryptoWalletInfo -> string } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::11","title":"ONEOF_FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо смены типа — добавьте новое поле в тот же oneof:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо смены типа — добавьте новое поле в тот же oneof:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::12","title":"ONEOF_FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::13","title":"ONEOF_FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message SearchRequest { string query = 1; oneof filter { string category = 2 [deprecated = true]; // Старый тип int32 user_id = 3 [deprecated = true]; bool is_premium = 4 [deprecated = true]; DateRan","content":"Хороший (Безопасный) message SearchRequest { string query = 1; oneof filter { string category = 2 [deprecated = true]; // Старый тип int32 user_id = 3 [deprecated = true]; bool is_premium = 4 [deprecated = true]; DateRange date_range = 5 [deprecated = true]; int32 category_id = 6; // Новая версия string user_identifier = 7; string premium_status = 8; string date_filter = 9; } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::14","title":"ONEOF_FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или создайте новый oneof:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или создайте новый oneof:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::15","title":"ONEOF_FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::16","title":"ONEOF_FIELD_SAME_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message SearchRequest { string query = 1; oneof filter { option deprecated = true; string category = 2 [deprecated = true]; int32 user_id = 3 [deprecated = true]; bool is_premium = 4 [deprecated = tr","content":"Хороший (Безопасный) message SearchRequest { string query = 1; oneof filter { option deprecated = true; string category = 2 [deprecated = true]; int32 user_id = 3 [deprecated = true]; bool is_premium = 4 [deprecated = true]; DateRange date_range = 5 [deprecated = true]; } oneof filter_v2 { int32 category_id = 6; string user_identifier = 7; PremiumFilter premium_filter = 8; TimeFilter time_filter = 9; } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::17","title":"ONEOF_FIELD_SAME_TYPE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Старые бинарные данные не читаются корректно **Generated Code:** Меняются типы-обёртки, код клиента не компилируется **Type Safety:** switch по варианту oneof ломается **Runtime Errors:** Ошибки ","content":"Влияние **Wire Format:** Старые бинарные данные не читаются корректно **Generated Code:** Меняются типы-обёртки, код клиента не компилируется **Type Safety:** switch по варианту oneof ломается **Runtime Errors:** Ошибки десериализации и логики при несовпадении типов"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::18","title":"ONEOF_FIELD_SAME_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Реальный пример"],"excerpt":"Реальный пример **Ломается клиентский код:** ```go // Before searchReq := &myapi.SearchRequest{ Query: \"golang jobs\", }","content":"Реальный пример **Ломается клиентский код:** ```go // Before searchReq := &myapi.SearchRequest{ Query: \"golang jobs\", }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::19","title":"ONEOF_FIELD_SAME_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Реальный пример"],"excerpt":"Реальный пример // Устанавливаем вариант oneof searchReq.Filter = &myapi.SearchRequest_Category{ Category: \"engineering\", }","content":"Реальный пример // Устанавливаем вариант oneof searchReq.Filter = &myapi.SearchRequest_Category{ Category: \"engineering\", }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::20","title":"ONEOF_FIELD_SAME_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Реальный пример"],"excerpt":"Реальный пример // Обработка вариантов switch filter := searchReq.Filter.(type) { case *myapi.SearchRequest_Category: return searchByCategory(filter.Category) case *myapi.SearchRequest_UserId: return searchByUserId(filte","content":"Реальный пример // Обработка вариантов switch filter := searchReq.Filter.(type) { case *myapi.SearchRequest_Category: return searchByCategory(filter.Category) case *myapi.SearchRequest_UserId: return searchByUserId(filter.UserId) default: return errors.New(\"unsupported filter\") }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::21","title":"ONEOF_FIELD_SAME_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Реальный пример"],"excerpt":"Реальный пример // After — тип Category стал int32 searchReq.Filter = &myapi.SearchRequest_Category{ Category: \"engineering\", // ERROR }","content":"Реальный пример // After — тип Category стал int32 searchReq.Filter = &myapi.SearchRequest_Category{ Category: \"engineering\", // ERROR }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::22","title":"ONEOF_FIELD_SAME_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Реальный пример"],"excerpt":"Реальный пример switch filter := searchReq.Filter.(type) { case *myapi.SearchRequest_Category: return searchByCategory(filter.Category) // ERROR case *myapi.SearchRequest_UserId: return searchByUserId(filter.UserId) // E","content":"Реальный пример switch filter := searchReq.Filter.(type) { case *myapi.SearchRequest_Category: return searchByCategory(filter.Category) // ERROR case *myapi.SearchRequest_UserId: return searchByUserId(filter.UserId) // ERROR: UserId теперь string } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::23","title":"ONEOF_FIELD_SAME_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Реальный пример"],"excerpt":"Реальный пример **Ломается серверная логика:** ```go // Before func handleSearchFilter(req *SearchRequest) (*SearchResult, error) { switch filter := req.Filter.(type) { case *SearchRequest_Category: return searchDatabase","content":"Реальный пример **Ломается серверная логика:** ```go // Before func handleSearchFilter(req *SearchRequest) (*SearchResult, error) { switch filter := req.Filter.(type) { case *SearchRequest_Category: return searchDatabase(\"category\", filter.Category), nil case *SearchRequest_UserId: return searchDatabase(\"user_id\", strconv.Itoa(int(filter.UserId))), nil default: return nil, errors.New(\"no filter specified\") } }"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::24","title":"ONEOF_FIELD_SAME_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Реальный пример"],"excerpt":"Реальный пример // After — несовпадения типов func handleSearchFilter(req *SearchRequest) (*SearchResult, error) { switch filter := req.Filter.(type) { case *SearchRequest_Category: // filter.Category теперь int32, а код","content":"Реальный пример // After — несовпадения типов func handleSearchFilter(req *SearchRequest) (*SearchResult, error) { switch filter := req.Filter.(type) { case *SearchRequest_Category: // filter.Category теперь int32, а код ожидал string return searchDatabase(\"category\", filter.Category), nil // ERROR case *SearchRequest_UserId: userIdStr := filter.UserId // string вместо int32 userId, _ := strconv.Atoi(userIdStr) return searchDatabase(\"user_id\", strconv.Itoa(userId)), nil } } ```"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::25","title":"ONEOF_FIELD_SAME_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Реальный пример"],"excerpt":"Реальный пример **Порча данных:**","content":"Реальный пример **Порча данных:**"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::26","title":"ONEOF_FIELD_SAME_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции Добавьте новое поле: Сервер поддерживает оба: Клиенты переходят на category_id. Скрипты миграции преобразуют старые данные. В следующей major‑версии:","content":"Стратегия миграции Добавьте новое поле: Сервер поддерживает оба: Клиенты переходят на category_id. Скрипты миграции преобразуют старые данные. В следующей major‑версии:"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::27","title":"ONEOF_FIELD_SAME_TYPE","section":"Переход к структурированным типам","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Переход к структурированным типам"],"excerpt":"Переход к структурированным типам","content":"Переход к структурированным типам"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::28","title":"ONEOF_FIELD_SAME_TYPE","section":"Матрица совместимости","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Матрица совместимости"],"excerpt":"Матрица совместимости From Type To Type Результат ----------- --------- ----------- string int32/int64 ❌ BREAKING int32 string ❌ BREAKING bool string ❌ BREAKING message string ❌ BREAKING string message ❌ BREAKING enum in","content":"Матрица совместимости From Type To Type Результат ----------- --------- ----------- string int32/int64 ❌ BREAKING int32 string ❌ BREAKING bool string ❌ BREAKING message string ❌ BREAKING string message ❌ BREAKING enum int32 ❌ BREAKING"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::29","title":"ONEOF_FIELD_SAME_TYPE","section":"Влияние на сгенерированный код","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Влияние на сгенерированный код"],"excerpt":"Влияние на сгенерированный код","content":"Влияние на сгенерированный код"},{"id":"cli/breaking-changes/rules/oneof-field-same-type::top::30","title":"ONEOF_FIELD_SAME_TYPE","section":"Валидация","path":"/docs/guide/cli/breaking-changes/rules/oneof-field-same-type","headings":["Валидация"],"excerpt":"Валидация **После (сломано):**","content":"Валидация **После (сломано):**"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::0","title":"ONEOF_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":[],"excerpt":"Это правило проверяет, что ни один oneof блок не был удалён из сообщений. Удаление oneof ломает совместимость по wire‑формату и сгенерированный код: существующие данные могут содержать ранее выбранный вариант, а клиентск","content":"Это правило проверяет, что ни один oneof блок не был удалён из сообщений. Удаление oneof ломает совместимость по wire‑формату и сгенерированный код: существующие данные могут содержать ранее выбранный вариант, а клиентский код зависит от типов-обёрток и методов доступа, генерируемых для oneof."},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::1","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::2","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::3","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4; } }","content":"Плохой (Breaking) message LoginRequest { string username = 1; oneof credentials { string password = 2; string api_key = 3; string oauth_token = 4; } }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::4","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message PaymentMethod { // [!code --] oneof method { // [!code --] CreditCard credit_card = 1; // [!code --] BankAccount bank_account = 2; // [!code --] PayPal paypal = 3; // [!code --] } // [!code --] ","content":"Плохой (Breaking) message PaymentMethod { // [!code --] oneof method { // [!code --] CreditCard credit_card = 1; // [!code --] BankAccount bank_account = 2; // [!code --] PayPal paypal = 3; // [!code --] } // [!code --] } // [!code --]"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::5","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Order { string id = 1; PaymentMethod payment = 2; } ```","content":"Плохой (Breaking) message Order { string id = 1; PaymentMethod payment = 2; } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::6","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::7","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::8","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message LoginRequest { string username = 1; // credentials oneof удалён — BREAKING CHANGE! string password = 2; // Теперь обычные поля string api_key = 3; // Потеряна взаимная исключаемость string oauth","content":"Плохой (Breaking) message LoginRequest { string username = 1; // credentials oneof удалён — BREAKING CHANGE! string password = 2; // Теперь обычные поля string api_key = 3; // Потеряна взаимная исключаемость string oauth_token = 4; }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::9","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message PaymentMethod { // method oneof удалён — BREAKING CHANGE! CreditCard credit_card = 1; // Теперь можно установить все поля одновременно BankAccount bank_account = 2; PayPal paypal = 3; }","content":"Плохой (Breaking) message PaymentMethod { // method oneof удалён — BREAKING CHANGE! CreditCard credit_card = 1; // Теперь можно установить все поля одновременно BankAccount bank_account = 2; PayPal paypal = 3; }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::breaking::10","title":"ONEOF_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message Order { string id = 1; PaymentMethod payment = 2; } ```","content":"Плохой (Breaking) message Order { string id = 1; PaymentMethod payment = 2; } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::11","title":"ONEOF_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Удаление вложенного oneof:** ```proto // Before message UserProfile { string name = 1; message ContactInfo { oneof contact_method { // [!code --] string email = 1; // [!code --] string phone = 2;","content":"Дополнительные примеры **Удаление вложенного oneof:** ```proto // Before message UserProfile { string name = 1; message ContactInfo { oneof contact_method { // [!code --] string email = 1; // [!code --] string phone = 2; // [!code --] string slack_id = 3; // [!code --] } // [!code --] } ContactInfo contact = 2; }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::12","title":"ONEOF_NO_DELETE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - BREAKING CHANGE! message UserProfile { string name = 1; message ContactInfo { // contact_method oneof удалён string email = 1; // Больше не эксклюзивно string phone = 2; // Можно задать ","content":"Дополнительные примеры // After - BREAKING CHANGE! message UserProfile { string name = 1; message ContactInfo { // contact_method oneof удалён string email = 1; // Больше не эксклюзивно string phone = 2; // Можно задать всё сразу string slack_id = 3; } ContactInfo contact = 2; } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::13","title":"ONEOF_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления — депрецируйте oneof:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления — депрецируйте oneof:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::14","title":"ONEOF_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::15","title":"ONEOF_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message LoginRequest { string username = 1; oneof credentials { option deprecated = true; // [!code focus] string password = 2 [deprecated = true]; // [!code focus] string api_key = 3 [deprecated = t","content":"Хороший (Безопасный) message LoginRequest { string username = 1; oneof credentials { option deprecated = true; // [!code focus] string password = 2 [deprecated = true]; // [!code focus] string api_key = 3 [deprecated = true]; // [!code focus] string oauth_token = 4 [deprecated = true]; // [!code focus] } }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::16","title":"ONEOF_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message PaymentMethod { oneof method { option deprecated = true; // [!code focus] CreditCard credit_card = 1 [deprecated = true]; // [!code focus] BankAccount bank_account = 2 [deprecated = true]; //","content":"Хороший (Безопасный) message PaymentMethod { oneof method { option deprecated = true; // [!code focus] CreditCard credit_card = 1 [deprecated = true]; // [!code focus] BankAccount bank_account = 2 [deprecated = true]; // [!code focus] PayPal paypal = 3 [deprecated = true]; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::17","title":"ONEOF_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или заменить новой структурой:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или заменить новой структурой:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::18","title":"ONEOF_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::19","title":"ONEOF_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message LoginRequest { string username = 1; oneof credentials { option deprecated = true; // [!code focus] // Старый oneof string password = 2 [deprecated = true]; // [!code focus] string api_key = 3","content":"Хороший (Безопасный) message LoginRequest { string username = 1; oneof credentials { option deprecated = true; // [!code focus] // Старый oneof string password = 2 [deprecated = true]; // [!code focus] string api_key = 3 [deprecated = true]; // [!code focus] string oauth_token = 4 [deprecated = true]; // [!code focus] } oneof auth_method { // [!code focus] // Новый дизайн PasswordAuth password_auth = 5; // [!code focus] ApiKeyAuth api_auth = 6; // [!code focus] OAuthAuth oauth_auth = 7; // [!code focus] } // [!code focus] } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::20","title":"ONEOF_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Теряются семантика взаимной исключаемости — больше одного поля может быть установлено **Generated Code:** Удаляются типы-обёртки и accessor методы — код клиента не компилируется **Business Logic:","content":"Влияние **Wire Format:** Теряются семантика взаимной исключаемости — больше одного поля может быть установлено **Generated Code:** Удаляются типы-обёртки и accessor методы — код клиента не компилируется **Business Logic:** Нарушаются инварианты «только один из» **Validation:** Логика проверок должна быть переписана вручную"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::21","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается:** ```go // Before - oneOf даёт взаимную исключаемость loginReq := &myapi.LoginRequest{ Username: \"user123\", }","content":"Реальный пример **Код клиента ломается:** ```go // Before - oneOf даёт взаимную исключаемость loginReq := &myapi.LoginRequest{ Username: \"user123\", }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::22","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример loginReq.Credentials = &myapi.LoginRequest_Password{ Password: \"secret123\", }","content":"Реальный пример loginReq.Credentials = &myapi.LoginRequest_Password{ Password: \"secret123\", }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::23","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример switch cred := loginReq.Credentials.(type) { case *myapi.LoginRequest_Password: // ERROR после удаления return authenticatePassword(cred.Password) case *myapi.LoginRequest_ApiKey: // ERROR после удаления ","content":"Реальный пример switch cred := loginReq.Credentials.(type) { case *myapi.LoginRequest_Password: // ERROR после удаления return authenticatePassword(cred.Password) case *myapi.LoginRequest_ApiKey: // ERROR после удаления return authenticateApiKey(cred.ApiKey) default: return errors.New(\"no credentials provided\") }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::24","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример // Compilation errors: // undefined: myapi.LoginRequest_Password // undefined field: loginReq.Credentials ```","content":"Реальный пример // Compilation errors: // undefined: myapi.LoginRequest_Password // undefined field: loginReq.Credentials ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::25","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Валидация на сервере ломается:** ```go // Before func validateLoginRequest(req *LoginRequest) error { if req.Credentials == nil { return errors.New(\"credentials required\") } switch req.Credentials.(type","content":"Реальный пример **Валидация на сервере ломается:** ```go // Before func validateLoginRequest(req *LoginRequest) error { if req.Credentials == nil { return errors.New(\"credentials required\") } switch req.Credentials.(type) { case *LoginRequest_Password: return validatePassword(req.GetPassword()) case *LoginRequest_ApiKey: return validateApiKey(req.GetApiKey()) case *LoginRequest_OauthToken: return validateOAuthToken(req.GetOauthToken()) default: return errors.New(\"unknown credential type\") } }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::26","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример // After func validateLoginRequest(req *LoginRequest) error { credCount := 0 if req.Password != \"\" { credCount++ } if req.ApiKey != \"\" { credCount++ } if req.OauthToken != \"\" { credCount++ }","content":"Реальный пример // After func validateLoginRequest(req *LoginRequest) error { credCount := 0 if req.Password != \"\" { credCount++ } if req.ApiKey != \"\" { credCount++ } if req.OauthToken != \"\" { credCount++ }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::27","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример if credCount == 0 { return errors.New(\"no credentials provided\") } if credCount > 1 { return errors.New(\"multiple credentials provided\") }","content":"Реальный пример if credCount == 0 { return errors.New(\"no credentials provided\") } if credCount > 1 { return errors.New(\"multiple credentials provided\") }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::28","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример if req.Password != \"\" { return validatePassword(req.Password) } // Дополнительные проверки вручную... return nil } ```","content":"Реальный пример if req.Password != \"\" { return validatePassword(req.Password) } // Дополнительные проверки вручную... return nil } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::29","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример **Проблемы бизнес‑логики:** ```go // Before payment := &PaymentMethod{ Method: &PaymentMethod_CreditCard{ CreditCard: &CreditCard{Number: \"1234\"}, }, }","content":"Реальный пример **Проблемы бизнес‑логики:** ```go // Before payment := &PaymentMethod{ Method: &PaymentMethod_CreditCard{ CreditCard: &CreditCard{Number: \"1234\"}, }, }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::30","title":"ONEOF_NO_DELETE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Реальный пример"],"excerpt":"Реальный пример // After — можно задать несколько способов сразу payment := &PaymentMethod{ CreditCard: &CreditCard{Number: \"1234\"}, BankAccount: &BankAccount{Number: \"5678\"}, // Ломает бизнес-логику } ```","content":"Реальный пример // After — можно задать несколько способов сразу payment := &PaymentMethod{ CreditCard: &CreditCard{Number: \"1234\"}, BankAccount: &BankAccount{Number: \"5678\"}, // Ломает бизнес-логику } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::31","title":"ONEOF_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Депрецируйте старый oneof и его поля:**","content":"Стратегия миграции **Депрецируйте старый oneof и его поля:**"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::32","title":"ONEOF_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Создайте новый блок при необходимости:**","content":"Стратегия миграции **Создайте новый блок при необходимости:**"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::33","title":"ONEOF_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Сервер: поддерживайте оба до миграции:**","content":"Стратегия миграции **Сервер: поддерживайте оба до миграции:**"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::34","title":"ONEOF_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Клиенты: переходите на новый oneof:**","content":"Стратегия миграции **Клиенты: переходите на новый oneof:**"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::35","title":"ONEOF_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Удалите старый oneof** в следующей major‑версии.","content":"Стратегия миграции **Удалите старый oneof** в следующей major‑версии."},{"id":"cli/breaking-changes/rules/oneof-no-delete::oneof::36","title":"ONEOF_NO_DELETE","section":"Замена oneof обычными полями","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#oneof","headings":["Замена oneof обычными полями"],"excerpt":"Замена oneof обычными полями ```proto message SearchRequest { // НЕЛЬЗЯ просто убрать oneof — ломает семантику string text_query = 1; // BREAKING int32 user_id = 2; // BREAKING string category = 3; // BREAKING }","content":"Замена oneof обычными полями ```proto message SearchRequest { // НЕЛЬЗЯ просто убрать oneof — ломает семантику string text_query = 1; // BREAKING int32 user_id = 2; // BREAKING string category = 3; // BREAKING }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::oneof::37","title":"ONEOF_NO_DELETE","section":"Замена oneof обычными полями","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#oneof","headings":["Замена oneof обычными полями"],"excerpt":"Замена oneof обычными полями message SearchRequest { oneof query { option deprecated = true; string text_query = 1 [deprecated = true]; int32 user_id = 2 [deprecated = true]; string category = 3 [deprecated = true]; } st","content":"Замена oneof обычными полями message SearchRequest { oneof query { option deprecated = true; string text_query = 1 [deprecated = true]; int32 user_id = 2 [deprecated = true]; string category = 3 [deprecated = true]; } string search_text = 4; repeated string filters = 5; } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::38","title":"ONEOF_NO_DELETE","section":"Упрощение структуры сообщения","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Упрощение структуры сообщения"],"excerpt":"Упрощение структуры сообщения ```proto message NotificationSettings { string email = 1; // BREAKING: был в oneof string phone = 2; // BREAKING string webhook_url = 3; // BREAKING }","content":"Упрощение структуры сообщения ```proto message NotificationSettings { string email = 1; // BREAKING: был в oneof string phone = 2; // BREAKING string webhook_url = 3; // BREAKING }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::39","title":"ONEOF_NO_DELETE","section":"Упрощение структуры сообщения","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Упрощение структуры сообщения"],"excerpt":"Упрощение структуры сообщения message NotificationSettings { oneof delivery_method { EmailNotification email = 1; SmsNotification phone = 2; WebhookNotification webhook = 3; } } ```","content":"Упрощение структуры сообщения message NotificationSettings { oneof delivery_method { EmailNotification email = 1; SmsNotification phone = 2; WebhookNotification webhook = 3; } } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::proto2-proto3::40","title":"ONEOF_NO_DELETE","section":"Миграция с proto2 на proto3","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#proto2-proto3","headings":["Миграция с proto2 на proto3"],"excerpt":"Миграция с proto2 на proto3 ```proto // proto2 message Request { optional string name = 1; oneof data { string text = 2; int32 number = 3; } }","content":"Миграция с proto2 на proto3 ```proto // proto2 message Request { optional string name = 1; oneof data { string text = 2; int32 number = 3; } }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::proto2-proto3::41","title":"ONEOF_NO_DELETE","section":"Миграция с proto2 на proto3","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#proto2-proto3","headings":["Миграция с proto2 на proto3"],"excerpt":"Миграция с proto2 на proto3 // proto3 — сохраняем oneof message Request { string name = 1; oneof data { string text = 2; int32 number = 3; } } ```","content":"Миграция с proto2 на proto3 // proto3 — сохраняем oneof message Request { string name = 1; oneof data { string text = 2; int32 number = 3; } } ```"},{"id":"cli/breaking-changes/rules/oneof-no-delete::oneof::42","title":"ONEOF_NO_DELETE","section":"Что даёт oneof","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete#oneof","headings":["Что даёт oneof"],"excerpt":"Что даёт oneof Взаимная исключаемость Типобезопасность в коде Ясность намерения API («выбери один») Эффективная сериализация — кодируется только выбранный вариант","content":"Что даёт oneof Взаимная исключаемость Типобезопасность в коде Ясность намерения API («выбери один») Эффективная сериализация — кодируется только выбранный вариант"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::43","title":"ONEOF_NO_DELETE","section":"Что теряется при удалении","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Что теряется при удалении"],"excerpt":"Что теряется при удалении Инвариант «только один» Генерируемые wrapper-типы и методы Автоматическая валидация выбора Понятность контракта API","content":"Что теряется при удалении Инвариант «только один» Генерируемые wrapper-типы и методы Автоматическая валидация выбора Понятность контракта API"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::44","title":"ONEOF_NO_DELETE","section":"Влияние на код генерации","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Влияние на код генерации"],"excerpt":"Влияние на код генерации ```go // С oneof type LoginRequest struct { Username string Credentials isLoginRequest_Credentials }","content":"Влияние на код генерации ```go // С oneof type LoginRequest struct { Username string Credentials isLoginRequest_Credentials }"},{"id":"cli/breaking-changes/rules/oneof-no-delete::top::45","title":"ONEOF_NO_DELETE","section":"Влияние на код генерации","path":"/docs/guide/cli/breaking-changes/rules/oneof-no-delete","headings":["Влияние на код генерации"],"excerpt":"Влияние на код генерации // Без oneof type LoginRequest struct { Username string Password string ApiKey string OauthToken string // Возможны многозначные конфликтующие состояния } ```","content":"Влияние на код генерации // Без oneof type LoginRequest struct { Username string Password string ApiKey string OauthToken string // Возможны многозначные конфликтующие состояния } ```"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::0","title":"RPC_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":[],"excerpt":"Правило проверяет, что ни один RPC‑метод не был удалён из service. Удаление RPC ломает сгенерированный код и клиентские приложения, которые этот метод вызывают.","content":"Правило проверяет, что ни один RPC‑метод не был удалён из service. Удаление RPC ломает сгенерированный код и клиентские приложения, которые этот метод вызывают."},{"id":"cli/breaking-changes/rules/rpc-no-delete::breaking::1","title":"RPC_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-no-delete::breaking::2","title":"RPC_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-no-delete::breaking::3","title":"RPC_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse","content":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse); // [!code --] } ```"},{"id":"cli/breaking-changes/rules/rpc-no-delete::breaking::4","title":"RPC_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-no-delete::breaking::5","title":"RPC_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-no-delete::breaking::6","title":"RPC_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); // DeleteUser RPC удалён — BREAKING CHANGE! } ```","content":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); // DeleteUser RPC удалён — BREAKING CHANGE! } ```"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::7","title":"RPC_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления — пометить RPC deprecated:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления — пометить RPC deprecated:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::8","title":"RPC_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::9","title":"RPC_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); rpc DeleteUser(DeleteUserRequest) returns (DeleteUserRespo","content":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse) { option deprecated = true; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::10","title":"RPC_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":["Влияние"],"excerpt":"Влияние **Generated Code:** Stub/метод исчезает — клиенты не компилируются **Client Applications:** Существующие вызовы метода падают при сборке **Runtime:** gRPC клиенты теряют определение метода","content":"Влияние **Generated Code:** Stub/метод исчезает — клиенты не компилируются **Client Applications:** Существующие вызовы метода падают при сборке **Runtime:** gRPC клиенты теряют определение метода"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::11","title":"RPC_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Сначала деприкация:**","content":"Стратегия миграции **Сначала деприкация:**"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::12","title":"RPC_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Имплементация может возвращать ошибку**, указывая что метод устарел (например, INTERNAL / UNIMPLEMENTED)","content":"Стратегия миграции **Имплементация может возвращать ошибку**, указывая что метод устарел (например, INTERNAL / UNIMPLEMENTED)"},{"id":"cli/breaking-changes/rules/rpc-no-delete::top::13","title":"RPC_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Удалить в следующей major‑версии** после миграции всех клиентов","content":"Стратегия миграции **Удалить в следующей major‑версии** после миграции всех клиентов"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::0","title":"RPC_SAME_REQUEST_TYPE","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":[],"excerpt":"Это правило проверяет, что RPC‑методы сохраняют прежний тип сообщения запроса (request message type). Изменение типа запроса RPC ломает совместимость по wire‑формату и сгенерированный код: клиенты ожидают конкретную стру","content":"Это правило проверяет, что RPC‑методы сохраняют прежний тип сообщения запроса (request message type). Изменение типа запроса RPC ломает совместимость по wire‑формату и сгенерированный код: клиенты ожидают конкретную структуру при вызове метода."},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::1","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::2","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::3","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); }","content":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::4","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message GetUserRequest { string user_id = 1; }","content":"Плохой (Breaking) message GetUserRequest { string user_id = 1; }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::5","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message UpdateUserRequest { string user_id = 1; string name = 2; string email = 3; } ```","content":"Плохой (Breaking) message UpdateUserRequest { string user_id = 1; string name = 2; string email = 3; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::6","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::7","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::8","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // [!code --] Изменён тип запроса rpc UpdateUser(UserUpdateRequest) returns (UpdateUserResponse); // [!code --] Изменён тип","content":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequestV2) returns (GetUserResponse); // [!code --] Изменён тип запроса rpc UpdateUser(UserUpdateRequest) returns (UpdateUserResponse); // [!code --] Изменён тип запроса }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::9","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message GetUserRequestV2 { // [!code --] Новый тип запроса string id = 1; bool include_profile = 2; }","content":"Плохой (Breaking) message GetUserRequestV2 { // [!code --] Новый тип запроса string id = 1; bool include_profile = 2; }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::breaking::10","title":"RPC_SAME_REQUEST_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message UserUpdateRequest { // [!code --] Новый тип запроса string id = 1; UserProfile profile = 2; } ```","content":"Плохой (Breaking) message UserUpdateRequest { // [!code --] Новый тип запроса string id = 1; UserProfile profile = 2; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::11","title":"RPC_SAME_REQUEST_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Смена типа из другого пакета:** ```proto // Before import \"common/user.proto\";","content":"Дополнительные примеры **Смена типа из другого пакета:** ```proto // Before import \"common/user.proto\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::12","title":"RPC_SAME_REQUEST_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры service UserService { rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"Дополнительные примеры service UserService { rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::13","title":"RPC_SAME_REQUEST_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - BREAKING CHANGE! import \"v2/user.proto\";","content":"Дополнительные примеры // After - BREAKING CHANGE! import \"v2/user.proto\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::14","title":"RPC_SAME_REQUEST_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры service UserService { rpc CreateUser(v2.CreateUserRequest) returns (CreateUserResponse); // Другой package } ```","content":"Дополнительные примеры service UserService { rpc CreateUser(v2.CreateUserRequest) returns (CreateUserResponse); // Другой package } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::15","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо изменения типа — версионируйте RPC:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо изменения типа — версионируйте RPC:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::16","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::17","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; // [!code focus] } rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse); // [!code focus] ","content":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; // [!code focus] } rpc GetUserV2(GetUserRequestV2) returns (GetUserResponse); // [!code focus] // Новый метод rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) { option deprecated = true; // [!code focus] } rpc UpdateUserV2(UserUpdateRequest) returns (UpdateUserResponse); // [!code focus] // Новый метод }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::18","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) // Старые сообщения — для обратной совместимости message GetUserRequest { string user_id = 1; }","content":"Хороший (Безопасный) // Старые сообщения — для обратной совместимости message GetUserRequest { string user_id = 1; }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::19","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) // Новая версия сообщения message GetUserRequestV2 { // [!code focus] string id = 1; // [!code focus] bool include_profile = 2; // [!code focus] } // [!code focus] ```","content":"Хороший (Безопасный) // Новая версия сообщения message GetUserRequestV2 { // [!code focus] string id = 1; // [!code focus] bool include_profile = 2; // [!code focus] } // [!code focus] ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::20","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или создайте новую версию сервиса (package v2):** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или создайте новую версию сервиса (package v2):** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::21","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v2; // [!code focus]","content":"Хороший (Безопасный) package myapi.v2; // [!code focus]"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::22","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus] }","content":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus] }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::23","title":"RPC_SAME_REQUEST_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message GetUserRequest { // [!code focus] string id = 1; // [!code focus] bool include_profile = 2; // [!code focus] } // [!code focus] ```","content":"Хороший (Безопасный) message GetUserRequest { // [!code focus] string id = 1; // [!code focus] bool include_profile = 2; // [!code focus] } // [!code focus] ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::24","title":"RPC_SAME_REQUEST_TYPE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Старые запросы клиентов не десериализуются новым сервером **Generated Code:** Сигнатуры методов в stubs меняются — компиляция клиентов падает **gRPC Calls:** Требуется использовать другую структу","content":"Влияние **Wire Format:** Старые запросы клиентов не десериализуются новым сервером **Generated Code:** Сигнатуры методов в stubs меняются — компиляция клиентов падает **gRPC Calls:** Требуется использовать другую структуру запроса **Runtime Errors:** Несоответствие типов вызывает ошибки выполнения"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::25","title":"RPC_SAME_REQUEST_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается:** ```go // Before client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", })","content":"Реальный пример **Код клиента ломается:** ```go // Before client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", })"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::26","title":"RPC_SAME_REQUEST_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Реальный пример"],"excerpt":"Реальный пример // After (тип запроса изменён) client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ // ERROR: тип не найден UserId: \"user123\", // ERROR: поле не найдено })","content":"Реальный пример // After (тип запроса изменён) client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ // ERROR: тип не найден UserId: \"user123\", // ERROR: поле не найдено })"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::27","title":"RPC_SAME_REQUEST_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Реальный пример"],"excerpt":"Реальный пример // Новый корректный вызов: resp, err := client.GetUser(ctx, &myapi.GetUserRequestV2{ Id: \"user123\", IncludeProfile: true, }) ```","content":"Реальный пример // Новый корректный вызов: resp, err := client.GetUser(ctx, &myapi.GetUserRequestV2{ Id: \"user123\", IncludeProfile: true, }) ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::28","title":"RPC_SAME_REQUEST_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Реальный пример"],"excerpt":"Реальный пример **Серверная реализация ломается:** ```go // Before func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { userID := req.UserId // ... }","content":"Реальный пример **Серверная реализация ломается:** ```go // Before func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { userID := req.UserId // ... }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::29","title":"RPC_SAME_REQUEST_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Реальный пример"],"excerpt":"Реальный пример // After func (s *server) GetUser(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) { userID := req.Id include := req.IncludeProfile // ... новая логика } ```","content":"Реальный пример // After func (s *server) GetUser(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) { userID := req.Id include := req.IncludeProfile // ... новая логика } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::30","title":"RPC_SAME_REQUEST_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Добавьте новый RPC с новым типом запроса:**","content":"Стратегия миграции **Добавьте новый RPC с новым типом запроса:**"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::31","title":"RPC_SAME_REQUEST_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Поддерживайте оба метода на сервере:** ```go func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { return s.getUserInternal(req.UserId, false) }","content":"Стратегия миграции **Поддерживайте оба метода на сервере:** ```go func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { return s.getUserInternal(req.UserId, false) }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::32","title":"RPC_SAME_REQUEST_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции func (s *server) GetUserV2(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) { return s.getUserInternal(req.Id, req.IncludeProfile) } ```","content":"Стратегия миграции func (s *server) GetUserV2(ctx context.Context, req *GetUserRequestV2) (*GetUserResponse, error) { return s.getUserInternal(req.Id, req.IncludeProfile) } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::33","title":"RPC_SAME_REQUEST_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Мигрируйте клиентов на V2:**","content":"Стратегия миграции **Мигрируйте клиентов на V2:**"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::34","title":"RPC_SAME_REQUEST_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Удалите старый метод в следующей major‑версии:**","content":"Стратегия миграции **Удалите старый метод в следующей major‑версии:**"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::35","title":"RPC_SAME_REQUEST_TYPE","section":"Добавление обязательных полей","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Добавление обязательных полей"],"excerpt":"Добавление обязательных полей ```proto // ПЛОХО: меняем существующий запрос message GetUserRequest { string user_id = 1; bool include_deleted = 2; // BREAKING }","content":"Добавление обязательных полей ```proto // ПЛОХО: меняем существующий запрос message GetUserRequest { string user_id = 1; bool include_deleted = 2; // BREAKING }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::36","title":"RPC_SAME_REQUEST_TYPE","section":"Добавление обязательных полей","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Добавление обязательных полей"],"excerpt":"Добавление обязательных полей // Хорошо: новая версия message GetUserRequestV2 { string user_id = 1; bool include_deleted = 2; } ```","content":"Добавление обязательных полей // Хорошо: новая версия message GetUserRequestV2 { string user_id = 1; bool include_deleted = 2; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::37","title":"RPC_SAME_REQUEST_TYPE","section":"Реструктуризация данных запроса","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Реструктуризация данных запроса"],"excerpt":"Реструктуризация данных запроса ```proto // ПЛОХО: меняем структуру прямо message UpdateUserRequest { UserProfile profile = 1; // BREAKING }","content":"Реструктуризация данных запроса ```proto // ПЛОХО: меняем структуру прямо message UpdateUserRequest { UserProfile profile = 1; // BREAKING }"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::38","title":"RPC_SAME_REQUEST_TYPE","section":"Реструктуризация данных запроса","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Реструктуризация данных запроса"],"excerpt":"Реструктуризация данных запроса // Хорошо: версионирование rpc UpdateUser(UpdateUserRequest) returns (...) { option deprecated = true; } rpc UpdateUserV2(UpdateUserRequestV2) returns (...); ```","content":"Реструктуризация данных запроса // Хорошо: версионирование rpc UpdateUser(UpdateUserRequest) returns (...) { option deprecated = true; } rpc UpdateUserV2(UpdateUserRequestV2) returns (...); ```"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::39","title":"RPC_SAME_REQUEST_TYPE","section":"Миграция пакета","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Миграция пакета"],"excerpt":"Миграция пакета ```proto // ПЛОХО: заменяем тип на пакет v2 прямо import \"v2/messages.proto\"; // BREAKING","content":"Миграция пакета ```proto // ПЛОХО: заменяем тип на пакет v2 прямо import \"v2/messages.proto\"; // BREAKING"},{"id":"cli/breaking-changes/rules/rpc-same-request-type::top::40","title":"RPC_SAME_REQUEST_TYPE","section":"Миграция пакета","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-request-type","headings":["Миграция пакета"],"excerpt":"Миграция пакета // Хорошо: добавляем новый RPC rpc OldMethod(v1.Request) returns (...) { option deprecated = true; } rpc NewMethod(v2.Request) returns (...); ```","content":"Миграция пакета // Хорошо: добавляем новый RPC rpc OldMethod(v1.Request) returns (...) { option deprecated = true; } rpc NewMethod(v2.Request) returns (...); ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::0","title":"RPC_SAME_RESPONSE_TYPE","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":[],"excerpt":"Это правило проверяет, что RPC‑методы сохраняют тот же тип ответного сообщения (response message type). Изменение типа ответа RPC ломает совместимость по wire‑формату и сгенерированный код: клиенты ожидают конкретную стр","content":"Это правило проверяет, что RPC‑методы сохраняют тот же тип ответного сообщения (response message type). Изменение типа ответа RPC ломает совместимость по wire‑формату и сгенерированный код: клиенты ожидают конкретную структуру при получении ответа."},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::1","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::2","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::3","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); }","content":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::4","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message GetUserResponse { string user_id = 1; string name = 2; string email = 3; }","content":"Плохой (Breaking) message GetUserResponse { string user_id = 1; string name = 2; string email = 3; }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::5","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message UpdateUserResponse { bool success = 1; string message = 2; } ```","content":"Плохой (Breaking) message UpdateUserResponse { bool success = 1; string message = 2; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::6","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::7","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::8","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponseV2); // [!code --] Изменён тип ответа rpc UpdateUser(UpdateUserRequest) returns (UserUpdateResponse); // [!code --] Изменён тип ","content":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponseV2); // [!code --] Изменён тип ответа rpc UpdateUser(UpdateUserRequest) returns (UserUpdateResponse); // [!code --] Изменён тип ответа }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::9","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message GetUserResponseV2 { // [!code --] Другой тип сообщения string id = 1; UserProfile profile = 2; repeated string permissions = 3; }","content":"Плохой (Breaking) message GetUserResponseV2 { // [!code --] Другой тип сообщения string id = 1; UserProfile profile = 2; repeated string permissions = 3; }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::breaking::10","title":"RPC_SAME_RESPONSE_TYPE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) message UserUpdateResponse { // [!code --] Другой тип сообщения UpdateResult result = 1; UserProfile updated_profile = 2; } ```","content":"Плохой (Breaking) message UserUpdateResponse { // [!code --] Другой тип сообщения UpdateResult result = 1; UserProfile updated_profile = 2; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::11","title":"RPC_SAME_RESPONSE_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры **Смена типа из другого пакета:** ```proto // Before import \"common/responses.proto\";","content":"Дополнительные примеры **Смена типа из другого пакета:** ```proto // Before import \"common/responses.proto\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::12","title":"RPC_SAME_RESPONSE_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры service UserService { rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"Дополнительные примеры service UserService { rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::13","title":"RPC_SAME_RESPONSE_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры // After - BREAKING CHANGE! import \"v2/responses.proto\";","content":"Дополнительные примеры // After - BREAKING CHANGE! import \"v2/responses.proto\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::14","title":"RPC_SAME_RESPONSE_TYPE","section":"Дополнительные примеры","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Дополнительные примеры"],"excerpt":"Дополнительные примеры service UserService { rpc CreateUser(CreateUserRequest) returns (v2.CreateUserResponse); // Другой package } ```","content":"Дополнительные примеры service UserService { rpc CreateUser(CreateUserRequest) returns (v2.CreateUserResponse); // Другой package } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::15","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо изменения типа — версионируйте RPC:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо изменения типа — версионируйте RPC:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::16","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::17","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; // [!code focus] } rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2); // [!code focus] ","content":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; // [!code focus] } rpc GetUserV2(GetUserRequest) returns (GetUserResponseV2); // [!code focus] // Новый метод rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) { option deprecated = true; // [!code focus] } rpc UpdateUserV2(UpdateUserRequest) returns (UserUpdateResponse); // [!code focus] // Новый метод }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::18","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) // Старые сообщения сохраняем для обратной совместимости message GetUserResponse { string user_id = 1; string name = 2; string email = 3; }","content":"Хороший (Безопасный) // Старые сообщения сохраняем для обратной совместимости message GetUserResponse { string user_id = 1; string name = 2; string email = 3; }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::19","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) // Новая расширенная версия message GetUserResponseV2 { // [!code focus] string id = 1; // [!code focus] UserProfile profile = 2; // [!code focus] repeated string permissions = 3; // [!code focus] } ","content":"Хороший (Безопасный) // Новая расширенная версия message GetUserResponseV2 { // [!code focus] string id = 1; // [!code focus] UserProfile profile = 2; // [!code focus] repeated string permissions = 3; // [!code focus] } // [!code focus] ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::20","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Или создайте новую версию сервиса (package v2):** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Или создайте новую версию сервиса (package v2):** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::21","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v2; // [!code focus]","content":"Хороший (Безопасный) package myapi.v2; // [!code focus]"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::22","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus] }","content":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); // [!code focus] rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse); // [!code focus] }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::23","title":"RPC_SAME_RESPONSE_TYPE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) message GetUserResponse { // [!code focus] string id = 1; // [!code focus] UserProfile profile = 2; // [!code focus] repeated string permissions = 3; // [!code focus] } // [!code focus] ```","content":"Хороший (Безопасный) message GetUserResponse { // [!code focus] string id = 1; // [!code focus] UserProfile profile = 2; // [!code focus] repeated string permissions = 3; // [!code focus] } // [!code focus] ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::24","title":"RPC_SAME_RESPONSE_TYPE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Влияние"],"excerpt":"Влияние **Wire Format:** Ответы сервера не десериализуются у старых клиентов **Generated Code:** Сигнатуры ожидают старый тип — компиляция падает **gRPC Calls:** Меняются типы в сгенерированных stub'ах **Runtime Errors:*","content":"Влияние **Wire Format:** Ответы сервера не десериализуются у старых клиентов **Generated Code:** Сигнатуры ожидают старый тип — компиляция падает **gRPC Calls:** Меняются типы в сгенерированных stub'ах **Runtime Errors:** Несоответствие типов ломает обработку ответа"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::25","title":"RPC_SAME_RESPONSE_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реальный пример"],"excerpt":"Реальный пример **Код клиента ломается:** ```go // Before client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", }) if err != nil { return err }","content":"Реальный пример **Код клиента ломается:** ```go // Before client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", }) if err != nil { return err }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::26","title":"RPC_SAME_RESPONSE_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реальный пример"],"excerpt":"Реальный пример userID := resp.UserId name := resp.Name","content":"Реальный пример userID := resp.UserId name := resp.Name"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::27","title":"RPC_SAME_RESPONSE_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реальный пример"],"excerpt":"Реальный пример // After (тип ответа изменён) client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", }) if err != nil { return err }","content":"Реальный пример // After (тип ответа изменён) client := myapi.NewUserServiceClient(conn) resp, err := client.GetUser(ctx, &myapi.GetUserRequest{ UserId: \"user123\", }) if err != nil { return err }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::28","title":"RPC_SAME_RESPONSE_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реальный пример"],"excerpt":"Реальный пример // Ошибки компиляции: userID := resp.UserId // ERROR name := resp.Name // ERROR","content":"Реальный пример // Ошибки компиляции: userID := resp.UserId // ERROR name := resp.Name // ERROR"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::29","title":"RPC_SAME_RESPONSE_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реальный пример"],"excerpt":"Реальный пример // Новый способ: userID := resp.Id profile := resp.Profile permissions := resp.Permissions ```","content":"Реальный пример // Новый способ: userID := resp.Id profile := resp.Profile permissions := resp.Permissions ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::30","title":"RPC_SAME_RESPONSE_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реальный пример"],"excerpt":"Реальный пример **Имплементация сервера также должна быть переписана:** ```go // Before func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { return &GetUserResponse{ UserId: \"use","content":"Реальный пример **Имплементация сервера также должна быть переписана:** ```go // Before func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { return &GetUserResponse{ UserId: \"user123\", Name: \"John Doe\", Email: \"john@example.com\", }, nil }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::31","title":"RPC_SAME_RESPONSE_TYPE","section":"Реальный пример","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реальный пример"],"excerpt":"Реальный пример // After func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) { return &GetUserResponseV2{ Id: \"user123\", Profile: &UserProfile{ Name: \"John Doe\", Email: \"john@ex","content":"Реальный пример // After func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) { return &GetUserResponseV2{ Id: \"user123\", Profile: &UserProfile{ Name: \"John Doe\", Email: \"john@example.com\", }, Permissions: []string{\"read\"}, }, nil } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::32","title":"RPC_SAME_RESPONSE_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Добавьте новый RPC c новым типом ответа:**","content":"Стратегия миграции **Добавьте новый RPC c новым типом ответа:**"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::33","title":"RPC_SAME_RESPONSE_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Поддерживайте оба на сервере:** ```go func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { user := s.getUserInternal(req.UserId) return &GetUserResponse{ Use","content":"Стратегия миграции **Поддерживайте оба на сервере:** ```go func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) { user := s.getUserInternal(req.UserId) return &GetUserResponse{ UserId: user.ID, Name: user.Name, Email: user.Email, }, nil }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::34","title":"RPC_SAME_RESPONSE_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции func (s *server) GetUserV2(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) { user := s.getUserInternal(req.UserId) return &GetUserResponseV2{ Id: user.ID, Profile: &UserProfile{ N","content":"Стратегия миграции func (s *server) GetUserV2(ctx context.Context, req *GetUserRequest) (*GetUserResponseV2, error) { user := s.getUserInternal(req.UserId) return &GetUserResponseV2{ Id: user.ID, Profile: &UserProfile{ Name: user.Name, Email: user.Email, }, Permissions: user.Permissions, }, nil } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::35","title":"RPC_SAME_RESPONSE_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Мигрируйте клиентов на новый RPC:**","content":"Стратегия миграции **Мигрируйте клиентов на новый RPC:**"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::36","title":"RPC_SAME_RESPONSE_TYPE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Удалите старый RPC** в следующей major‑версии:","content":"Стратегия миграции **Удалите старый RPC** в следующей major‑версии:"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::37","title":"RPC_SAME_RESPONSE_TYPE","section":"Добавление новых обязательных полей","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Добавление новых обязательных полей"],"excerpt":"Добавление новых обязательных полей ```proto // ПЛОХО: меняем существующий тип message GetUserResponse { string user_id = 1; string name = 2; UserProfile profile = 3; // BREAKING }","content":"Добавление новых обязательных полей ```proto // ПЛОХО: меняем существующий тип message GetUserResponse { string user_id = 1; string name = 2; UserProfile profile = 3; // BREAKING }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::38","title":"RPC_SAME_RESPONSE_TYPE","section":"Добавление новых обязательных полей","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Добавление новых обязательных полей"],"excerpt":"Добавление новых обязательных полей // Хорошо: новая версия message GetUserResponseV2 { string user_id = 1; string name = 2; UserProfile profile = 3; } ```","content":"Добавление новых обязательных полей // Хорошо: новая версия message GetUserResponseV2 { string user_id = 1; string name = 2; UserProfile profile = 3; } ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::39","title":"RPC_SAME_RESPONSE_TYPE","section":"Реструктуризация ответа","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реструктуризация ответа"],"excerpt":"Реструктуризация ответа ```proto // ПЛОХО: меняем структуру прямо message UpdateUserResponse { UserDetails details = 1; // BREAKING }","content":"Реструктуризация ответа ```proto // ПЛОХО: меняем структуру прямо message UpdateUserResponse { UserDetails details = 1; // BREAKING }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::40","title":"RPC_SAME_RESPONSE_TYPE","section":"Реструктуризация ответа","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Реструктуризация ответа"],"excerpt":"Реструктуризация ответа // Хорошо: версионирование rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) { option deprecated = true; } rpc UpdateUserV2(UpdateUserRequest) returns (UpdateUserResponseV2); ```","content":"Реструктуризация ответа // Хорошо: версионирование rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse) { option deprecated = true; } rpc UpdateUserV2(UpdateUserRequest) returns (UpdateUserResponseV2); ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::41","title":"RPC_SAME_RESPONSE_TYPE","section":"Изменение формата ошибок","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Изменение формата ошибок"],"excerpt":"Изменение формата ошибок ```proto // ПЛОХО: меняем формат напрямую message CreateUserResponse { ErrorDetails error = 1; // BREAKING }","content":"Изменение формата ошибок ```proto // ПЛОХО: меняем формат напрямую message CreateUserResponse { ErrorDetails error = 1; // BREAKING }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::42","title":"RPC_SAME_RESPONSE_TYPE","section":"Изменение формата ошибок","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Изменение формата ошибок"],"excerpt":"Изменение формата ошибок // Хорошо: новая версия rpc CreateUser(CreateUserRequest) returns (CreateUserResponse) { option deprecated = true; } rpc CreateUserV2(CreateUserRequest) returns (CreateUserResponseV2); ```","content":"Изменение формата ошибок // Хорошо: новая версия rpc CreateUser(CreateUserRequest) returns (CreateUserResponse) { option deprecated = true; } rpc CreateUserV2(CreateUserRequest) returns (CreateUserResponseV2); ```"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::43","title":"RPC_SAME_RESPONSE_TYPE","section":"Миграция формата","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Миграция формата"],"excerpt":"Миграция формата ```proto // ПЛОХО: перевод простой структуры в сложную message GetUserResponse { UserData data = 1; // BREAKING }","content":"Миграция формата ```proto // ПЛОХО: перевод простой структуры в сложную message GetUserResponse { UserData data = 1; // BREAKING }"},{"id":"cli/breaking-changes/rules/rpc-same-response-type::top::44","title":"RPC_SAME_RESPONSE_TYPE","section":"Миграция формата","path":"/docs/guide/cli/breaking-changes/rules/rpc-same-response-type","headings":["Миграция формата"],"excerpt":"Миграция формата // Хорошо: предоставляем обе версии rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; } rpc GetUserDetailed(GetUserRequest) returns (GetUserDetailedResponse); ```","content":"Миграция формата // Хорошо: предоставляем обе версии rpc GetUser(GetUserRequest) returns (GetUserResponse) { option deprecated = true; } rpc GetUserDetailed(GetUserRequest) returns (GetUserDetailedResponse); ```"},{"id":"cli/breaking-changes/rules/service-no-delete::top::0","title":"SERVICE_NO_DELETE","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":[],"excerpt":"Данное правило проверяет, что ни один service не был удалён из proto‑файлов. Удаление service ломает сгенерированный код и клиентские приложения, которые на него опираются.","content":"Данное правило проверяет, что ни один service не был удалён из proto‑файлов. Удаление service ломает сгенерированный код и клиентские приложения, которые на него опираются."},{"id":"cli/breaking-changes/rules/service-no-delete::breaking::1","title":"SERVICE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **До:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/service-no-delete::breaking::2","title":"SERVICE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/service-no-delete::breaking::3","title":"SERVICE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/service-no-delete::breaking::4","title":"SERVICE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service OrderService { // [!code --] rpc GetOrder(GetOrderRequest) returns (GetOrderResponse); // [!code --] } // [!code --] ```","content":"Плохой (Breaking) service OrderService { // [!code --] rpc GetOrder(GetOrderRequest) returns (GetOrderResponse); // [!code --] } // [!code --] ```"},{"id":"cli/breaking-changes/rules/service-no-delete::breaking::5","title":"SERVICE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";","content":"Плохой (Breaking) **После:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/service-no-delete::breaking::6","title":"SERVICE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) package myapi.v1;","content":"Плохой (Breaking) package myapi.v1;"},{"id":"cli/breaking-changes/rules/service-no-delete::breaking::7","title":"SERVICE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"Плохой (Breaking) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/service-no-delete::breaking::8","title":"SERVICE_NO_DELETE","section":"Плохой (Breaking)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete#breaking","headings":["Плохой (Breaking)"],"excerpt":"Плохой (Breaking) // OrderService удалён — BREAKING CHANGE! ```","content":"Плохой (Breaking) // OrderService удалён — BREAKING CHANGE! ```"},{"id":"cli/breaking-changes/rules/service-no-delete::top::9","title":"SERVICE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) **Вместо удаления — отметьте service как deprecated:** ```proto syntax = \"proto3\";","content":"Хороший (Безопасный) **Вместо удаления — отметьте service как deprecated:** ```proto syntax = \"proto3\";"},{"id":"cli/breaking-changes/rules/service-no-delete::top::10","title":"SERVICE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) package myapi.v1;","content":"Хороший (Безопасный) package myapi.v1;"},{"id":"cli/breaking-changes/rules/service-no-delete::top::11","title":"SERVICE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }","content":"Хороший (Безопасный) service UserService { rpc GetUser(GetUserRequest) returns (GetUserResponse); rpc CreateUser(CreateUserRequest) returns (CreateUserResponse); }"},{"id":"cli/breaking-changes/rules/service-no-delete::top::12","title":"SERVICE_NO_DELETE","section":"Хороший (Безопасный)","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":["Хороший (Безопасный)"],"excerpt":"Хороший (Безопасный) service OrderService { option deprecated = true; // [!code focus] rpc GetOrder(GetOrderRequest) returns (GetOrderResponse) { option deprecated = true; // [!code focus] } } ```","content":"Хороший (Безопасный) service OrderService { option deprecated = true; // [!code focus] rpc GetOrder(GetOrderRequest) returns (GetOrderResponse) { option deprecated = true; // [!code focus] } } ```"},{"id":"cli/breaking-changes/rules/service-no-delete::top::13","title":"SERVICE_NO_DELETE","section":"Влияние","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":["Влияние"],"excerpt":"Влияние **Generated Code:** Классы / интерфейсы сервиса исчезают — клиенты не компилируются **Client Applications:** Существующие вызовы к удалённому сервису падают на этапе сборки **Runtime:** gRPC клиенты теряют опреде","content":"Влияние **Generated Code:** Классы / интерфейсы сервиса исчезают — клиенты не компилируются **Client Applications:** Существующие вызовы к удалённому сервису падают на этапе сборки **Runtime:** gRPC клиенты теряют определение метода/сервиса"},{"id":"cli/breaking-changes/rules/service-no-delete::top::14","title":"SERVICE_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Сначала деприкация:**","content":"Стратегия миграции **Сначала деприкация:**"},{"id":"cli/breaking-changes/rules/service-no-delete::top::15","title":"SERVICE_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Уведомите клиентов** о сроках вывода из эксплуатации","content":"Стратегия миграции **Уведомите клиентов** о сроках вывода из эксплуатации"},{"id":"cli/breaking-changes/rules/service-no-delete::top::16","title":"SERVICE_NO_DELETE","section":"Стратегия миграции","path":"/docs/guide/cli/breaking-changes/rules/service-no-delete","headings":["Стратегия миграции"],"excerpt":"Стратегия миграции **Удалите после периода миграции** в следующей major‑версии","content":"Стратегия миграции **Удалите после периода миграции** в следующей major‑версии"},{"id":"cli/configuration/configuration::top::0","title":"EasyP Configuration Reference","path":"/docs/guide/cli/configuration/configuration","headings":[],"excerpt":"EasyP can be configured through CLI flags, environment variables, and configuration files. This guide covers all configuration options available in EasyP.","content":"EasyP can be configured through CLI flags, environment variables, and configuration files. This guide covers all configuration options available in EasyP."},{"id":"cli/configuration/configuration::global-flags::1","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags Available for all commands:","content":"Global Flags Available for all commands:"},{"id":"cli/configuration/configuration::global-flags::2","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --cfg -c EASYP_CFG Configuration file path easyp.yaml --config EASYP_CFG Alias for --cfg easyp.yaml --debug -d ","content":"Global Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --cfg -c EASYP_CFG Configuration file path easyp.yaml --config EASYP_CFG Alias for --cfg easyp.yaml --debug -d EASYP_DEBUG Enable debug mode false --format -f EASYP_FORMAT Формат вывода для команд с поддержкой нескольких форматов (text/json) значение по умолчанию зависит от команды"},{"id":"cli/configuration/configuration::global-flags::3","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags **Examples:** ```bash Use custom config file easyp --cfg production.easyp.yaml lint","content":"Global Flags **Examples:** ```bash Use custom config file easyp --cfg production.easyp.yaml lint"},{"id":"cli/configuration/configuration::global-flags::4","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags Enable debug logging easyp --debug lint","content":"Global Flags Enable debug logging easyp --debug lint"},{"id":"cli/configuration/configuration::global-flags::5","title":"EasyP Configuration Reference","section":"Global Flags","path":"/docs/guide/cli/configuration/configuration#global-flags","headings":["Global Flags"],"excerpt":"Global Flags Short form easyp -c custom.yaml -d lint ```","content":"Global Flags Short form easyp -c custom.yaml -d lint ```"},{"id":"cli/configuration/configuration::command-specific-flags::6","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Lint command:**","content":"Command-Specific Flags **Lint command:**"},{"id":"cli/configuration/configuration::command-specific-flags::7","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --path -p Directory path to lint . --root -r Базовая директория для поиска файлов Текущая рабочая дир","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --path -p Directory path to lint . --root -r Базовая директория для поиска файлов Текущая рабочая директория --format -f EASYP_FORMAT Использует глобальный флаг формата (text/json) Использует глобальное значение по умолчанию"},{"id":"cli/configuration/configuration::command-specific-flags::8","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Lint specific directory easyp lint --path proto/","content":"Command-Specific Flags **Examples:** ```bash Lint specific directory easyp lint --path proto/"},{"id":"cli/configuration/configuration::command-specific-flags::9","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Lint из поддиректории с правильным разрешением импортов easyp lint --root src/IPC/Contracts --path .","content":"Command-Specific Flags Lint из поддиректории с правильным разрешением импортов easyp lint --root src/IPC/Contracts --path ."},{"id":"cli/configuration/configuration::command-specific-flags::10","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags JSON output format easyp --format json lint # глобальный флаг","content":"Command-Specific Flags JSON output format easyp --format json lint # глобальный флаг"},{"id":"cli/configuration/configuration::command-specific-flags::11","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Combined flags easyp -f json lint -p proto/ ```","content":"Command-Specific Flags Combined flags easyp -f json lint -p proto/ ```"},{"id":"cli/configuration/configuration::command-specific-flags::12","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Generate command:**","content":"Command-Specific Flags **Generate command:**"},{"id":"cli/configuration/configuration::command-specific-flags::13","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --path -p EASYP_ROOT_GENERATE_PATH Путь к директории с proto файлами для генерации . --root -r Базова","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --path -p EASYP_ROOT_GENERATE_PATH Путь к директории с proto файлами для генерации . --root -r Базовая директория для поиска файлов Текущая рабочая директория"},{"id":"cli/configuration/configuration::command-specific-flags::14","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Generate from specific path easyp generate --path api/","content":"Command-Specific Flags **Examples:** ```bash Generate from specific path easyp generate --path api/"},{"id":"cli/configuration/configuration::command-specific-flags::15","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Generate из поддиректории с правильным разрешением импортов easyp generate --root src/IPC/Contracts --path .","content":"Command-Specific Flags Generate из поддиректории с правильным разрешением импортов easyp generate --root src/IPC/Contracts --path ."},{"id":"cli/configuration/configuration::command-specific-flags::16","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Using environment variable EASYP_ROOT_GENERATE_PATH=proto/ easyp generate ```","content":"Command-Specific Flags Using environment variable EASYP_ROOT_GENERATE_PATH=proto/ easyp generate ```"},{"id":"cli/configuration/configuration::command-specific-flags::17","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Breaking command:**","content":"Command-Specific Flags **Breaking command:**"},{"id":"cli/configuration/configuration::command-specific-flags::18","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --against Git ref to compare against master --path -p Directory path to check . --format -f EASYP_FOR","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --against Git ref to compare against master --path -p Directory path to check . --format -f EASYP_FORMAT Использует глобальный флаг формата (text/json) Использует глобальное значение по умолчанию"},{"id":"cli/configuration/configuration::command-specific-flags::19","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Check against main branch easyp breaking --against main","content":"Command-Specific Flags **Examples:** ```bash Check against main branch easyp breaking --against main"},{"id":"cli/configuration/configuration::command-specific-flags::20","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Check specific directory against develop branch easyp breaking --against develop --path proto/","content":"Command-Specific Flags Check specific directory against develop branch easyp breaking --against develop --path proto/"},{"id":"cli/configuration/configuration::command-specific-flags::21","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags JSON output easyp --format json breaking --against main # глобальный флаг ```","content":"Command-Specific Flags JSON output easyp --format json breaking --against main # глобальный флаг ```"},{"id":"cli/configuration/configuration::command-specific-flags::22","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Init command:**","content":"Command-Specific Flags **Init command:**"},{"id":"cli/configuration/configuration::command-specific-flags::23","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --dir -d EASYP_INIT_DIR Directory to initialize .","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --dir -d EASYP_INIT_DIR Directory to initialize ."},{"id":"cli/configuration/configuration::command-specific-flags::24","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Initialize current directory easyp init","content":"Command-Specific Flags **Examples:** ```bash Initialize current directory easyp init"},{"id":"cli/configuration/configuration::command-specific-flags::25","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Initialize specific directory easyp init --dir proto-project/ ```","content":"Command-Specific Flags Initialize specific directory easyp init --dir proto-project/ ```"},{"id":"cli/configuration/configuration::command-specific-flags::26","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags easyp init работает интерактивно: Если в корне целевой директории есть buf.yml/buf.yaml, команда предложит миграцию из Buf. Если easyp.yaml уже существует, команда запросит подтверждение на перезап","content":"Command-Specific Flags easyp init работает интерактивно: Если в корне целевой директории есть buf.yml/buf.yaml, команда предложит миграцию из Buf. Если easyp.yaml уже существует, команда запросит подтверждение на перезапись."},{"id":"cli/configuration/configuration::command-specific-flags::27","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Validate-config command:**","content":"Command-Specific Flags **Validate-config command:**"},{"id":"cli/configuration/configuration::command-specific-flags::28","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --config -c EASYP_CFG Путь до файла конфигурации easyp.yaml --format (global) -f EASYP_FORMAT Глобаль","content":"Command-Specific Flags Flag Short Environment Description Default ------ ------- ------------- ------------- --------- --config -c EASYP_CFG Путь до файла конфигурации easyp.yaml --format (global) -f EASYP_FORMAT Глобальный формат вывода для команд с несколькими форматами (json или text) зависит от команды (json для validate-config)"},{"id":"cli/configuration/configuration::command-specific-flags::29","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Examples:** ```bash Проверить конфиг по умолчанию с JSON выводом (статус 0 если ошибок нет) easyp validate-config","content":"Command-Specific Flags **Examples:** ```bash Проверить конфиг по умолчанию с JSON выводом (статус 0 если ошибок нет) easyp validate-config"},{"id":"cli/configuration/configuration::command-specific-flags::30","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags Проверить другой файл и вывести в текстовом формате (глобальный --format) easyp --format text validate-config --config example.easyp.yaml ```","content":"Command-Specific Flags Проверить другой файл и вывести в текстовом формате (глобальный --format) easyp --format text validate-config --config example.easyp.yaml ```"},{"id":"cli/configuration/configuration::command-specific-flags::31","title":"EasyP Configuration Reference","section":"Command-Specific Flags","path":"/docs/guide/cli/configuration/configuration#command-specific-flags","headings":["Command-Specific Flags"],"excerpt":"Command-Specific Flags **Package management commands:**","content":"Command-Specific Flags **Package management commands:**"},{"id":"cli/configuration/configuration::easyp-mod-download::32","title":"EasyP Configuration Reference","section":"easyp mod download","path":"/docs/guide/cli/configuration/configuration#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download Downloads dependencies based on lock file priority:","content":"easyp mod download Downloads dependencies based on lock file priority:"},{"id":"cli/configuration/configuration::easyp-mod-download::33","title":"EasyP Configuration Reference","section":"easyp mod download","path":"/docs/guide/cli/configuration/configuration#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download **If easyp.lock exists** - downloads exact versions from lock file **If easyp.lock is missing** - downloads versions from easyp.yaml and creates easyp.lock","content":"easyp mod download **If easyp.lock exists** - downloads exact versions from lock file **If easyp.lock is missing** - downloads versions from easyp.yaml and creates easyp.lock"},{"id":"cli/configuration/configuration::easyp-mod-update::34","title":"EasyP Configuration Reference","section":"easyp mod update","path":"/docs/guide/cli/configuration/configuration#easyp-mod-update","headings":["easyp mod update"],"excerpt":"easyp mod update Always downloads dependencies from easyp.yaml, ignoring existing lock file:","content":"easyp mod update Always downloads dependencies from easyp.yaml, ignoring existing lock file:"},{"id":"cli/configuration/configuration::easyp-mod-update::35","title":"EasyP Configuration Reference","section":"easyp mod update","path":"/docs/guide/cli/configuration/configuration#easyp-mod-update","headings":["easyp mod update"],"excerpt":"easyp mod update **Ignores easyp.lock** completely **Downloads versions from easyp.yaml** **Creates/updates easyp.lock** with new versions","content":"easyp mod update **Ignores easyp.lock** completely **Downloads versions from easyp.yaml** **Creates/updates easyp.lock** with new versions"},{"id":"cli/configuration/configuration::easyp-mod-vendor::36","title":"EasyP Configuration Reference","section":"easyp mod vendor","path":"/docs/guide/cli/configuration/configuration#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor Copies proto files from dependencies to local vendor/ directory (similar to go mod vendor).","content":"easyp mod vendor Copies proto files from dependencies to local vendor/ directory (similar to go mod vendor)."},{"id":"cli/configuration/configuration::easyp-mod-vendor::37","title":"EasyP Configuration Reference","section":"easyp mod vendor","path":"/docs/guide/cli/configuration/configuration#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor No additional flags. Uses global --cfg flag for configuration.","content":"easyp mod vendor No additional flags. Uses global --cfg flag for configuration."},{"id":"cli/configuration/configuration::environment-variables::38","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables EasyP supports environment variables for configuration:","content":"Environment Variables EasyP supports environment variables for configuration:"},{"id":"cli/configuration/configuration::environment-variables::39","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables Variable Description Default ---------- ------------- --------- EASYP_CFG Path to configuration file easyp.yaml EASYP_DEBUG Enable debug logging false EASYPPATH Cache and modules storage directory $","content":"Environment Variables Variable Description Default ---------- ------------- --------- EASYP_CFG Path to configuration file easyp.yaml EASYP_DEBUG Enable debug logging false EASYPPATH Cache and modules storage directory $HOME/.easyp EASYP_FORMAT Формат вывода для поддерживаемых команд (text/json). Если не указан, каждая команда использует своё значение по умолчанию. значение по умолчанию зависит от команды EASYP_ROOT_GENERATE_PATH Root path for generate command . EASYP_INIT_DIR Directory for init command ."},{"id":"cli/configuration/configuration::environment-variables::40","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables **Examples:** ```bash Custom cache directory export EASYPPATH=/tmp/easyp-cache easyp mod download","content":"Environment Variables **Examples:** ```bash Custom cache directory export EASYPPATH=/tmp/easyp-cache easyp mod download"},{"id":"cli/configuration/configuration::environment-variables::41","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables Debug mode via environment export EASYP_DEBUG=true easyp lint","content":"Environment Variables Debug mode via environment export EASYP_DEBUG=true easyp lint"},{"id":"cli/configuration/configuration::environment-variables::42","title":"EasyP Configuration Reference","section":"Environment Variables","path":"/docs/guide/cli/configuration/configuration#environment-variables","headings":["Environment Variables"],"excerpt":"Environment Variables Custom config file export EASYP_CFG=config/easyp.yaml easyp generate ```","content":"Environment Variables Custom config file export EASYP_CFG=config/easyp.yaml easyp generate ```"},{"id":"cli/configuration/configuration::configuration-file::43","title":"EasyP Configuration Reference","section":"Configuration File","path":"/docs/guide/cli/configuration/configuration#configuration-file","headings":["Configuration File"],"excerpt":"Configuration File The easyp.yaml file is the main configuration file for EasyP, defining how your proto files are linted, generated, and managed. This file is typically placed at the root of your project alongside your ","content":"Configuration File The easyp.yaml file is the main configuration file for EasyP, defining how your proto files are linted, generated, and managed. This file is typically placed at the root of your project alongside your proto files."},{"id":"cli/configuration/configuration::configuration-format::44","title":"EasyP Configuration Reference","section":"Configuration Format","path":"/docs/guide/cli/configuration/configuration#configuration-format","headings":["Configuration Format"],"excerpt":"Configuration Format EasyP supports both YAML and JSON configuration formats:","content":"Configuration Format EasyP supports both YAML and JSON configuration formats:"},{"id":"cli/configuration/configuration::top::45","title":"EasyP Configuration Reference","section":"Переменные окружения в конфигурации","path":"/docs/guide/cli/configuration/configuration","headings":["Переменные окружения в конфигурации"],"excerpt":"Переменные окружения в конфигурации EasyP поддерживает расширение переменных окружения непосредственно в файле конфигурации easyp.yaml. Это позволяет использовать переменные окружения для динамических значений конфигурац","content":"Переменные окружения в конфигурации EasyP поддерживает расширение переменных окружения непосредственно в файле конфигурации easyp.yaml. Это позволяет использовать переменные окружения для динамических значений конфигурации."},{"id":"cli/configuration/configuration::top::46","title":"EasyP Configuration Reference","section":"Переменные окружения в конфигурации","path":"/docs/guide/cli/configuration/configuration","headings":["Переменные окружения в конфигурации"],"excerpt":"Переменные окружения в конфигурации **Пример со всеми поддерживаемыми возможностями:** ```yaml deps: # Базовое расширение: ${VAR} - расширяется в значение переменной VAR - ${GOOGLEAPIS_REPO}@${GOOGLEAPIS_VERSION} # Значе","content":"Переменные окружения в конфигурации **Пример со всеми поддерживаемыми возможностями:** ```yaml deps: # Базовое расширение: ${VAR} - расширяется в значение переменной VAR - ${GOOGLEAPIS_REPO}@${GOOGLEAPIS_VERSION} # Значение по умолчанию: ${VAR:-default} - использует default, если VAR не установлена или пустая - ${GNOSTIC_REPO:-github.com/google/gnostic}@${GNOSTIC_VERSION:-v0.7.0}"},{"id":"cli/configuration/configuration::top::47","title":"EasyP Configuration Reference","section":"Переменные окружения в конфигурации","path":"/docs/guide/cli/configuration/configuration","headings":["Переменные окружения в конфигурации"],"excerpt":"Переменные окружения в конфигурации generate: inputs: # Значение по умолчанию, если INPUT_DIR не установлена - directory: ${INPUT_DIR:-proto} plugins: - name: go # Базовое расширение out: ${OUTPUT_DIR} opts: # Значение п","content":"Переменные окружения в конфигурации generate: inputs: # Значение по умолчанию, если INPUT_DIR не установлена - directory: ${INPUT_DIR:-proto} plugins: - name: go # Базовое расширение out: ${OUTPUT_DIR} opts: # Значение по умолчанию module: ${MODULE_NAME:-github.com/example/project} timeout: ${TIMEOUT:-30} # Экранирование: $$ становится буквальным $, $${VAR} становится буквальным ${VAR} path: \"${BASE_DIR}/$${TEMP}/file\" # Результат: \"/tmp/${TEMP}/file\" (если BASE_DIR=/tmp) literal: \"$$\" # Результат: \"$\" ```"},{"id":"cli/configuration/configuration::top::48","title":"EasyP Configuration Reference","section":"Переменные окружения в конфигурации","path":"/docs/guide/cli/configuration/configuration","headings":["Переменные окружения в конфигурации"],"excerpt":"Переменные окружения в конфигурации **Поддерживаемый синтаксис:** ${VAR} - расширяется в значение переменной VAR ${VAR:-default} - использует default, если VAR не установлена или пустая ${VAR:=default} - использует defau","content":"Переменные окружения в конфигурации **Поддерживаемый синтаксис:** ${VAR} - расширяется в значение переменной VAR ${VAR:-default} - использует default, если VAR не установлена или пустая ${VAR:=default} - использует default, если VAR не установлена или пустая ${VAR-default} - использует default, если VAR не установлена (пустая строка сохраняется) $${VAR} или $$VAR - экранирует в буквальную строку ${VAR} или $VAR $$ - экранирует в буквальный символ $"},{"id":"cli/configuration/configuration::top::49","title":"EasyP Configuration Reference","section":"Переменные окружения в конфигурации","path":"/docs/guide/cli/configuration/configuration","headings":["Переменные окружения в конфигурации"],"excerpt":"Переменные окружения в конфигурации **Примечание:** Переменные окружения расширяются до парсинга YAML, поэтому любой паттерн ${STRING} будет обработан. Используйте $$ для экранирования символов доллара, когда нужны буква","content":"Переменные окружения в конфигурации **Примечание:** Переменные окружения расширяются до парсинга YAML, поэтому любой паттерн ${STRING} будет обработан. Используйте $$ для экранирования символов доллара, когда нужны буквальные значения."},{"id":"cli/configuration/configuration::version::50","title":"EasyP Configuration Reference","section":"version","path":"/docs/guide/cli/configuration/configuration#version","headings":["version"],"excerpt":"version **Опционально (legacy-совместимость).** Поле поддерживается для обратной совместимости и может быть опущено в новых конфигурациях.","content":"version **Опционально (legacy-совместимость).** Поле поддерживается для обратной совместимости и может быть опущено в новых конфигурациях."},{"id":"cli/configuration/configuration::version::51","title":"EasyP Configuration Reference","section":"version","path":"/docs/guide/cli/configuration/configuration#version","headings":["version"],"excerpt":"version **Type:** string **Default:** не задано **Рекомендация:** если сохраняете поле, используйте v1alpha","content":"version **Type:** string **Default:** не задано **Рекомендация:** если сохраняете поле, используйте v1alpha"},{"id":"cli/configuration/configuration::version::52","title":"EasyP Configuration Reference","section":"version","path":"/docs/guide/cli/configuration/configuration#version","headings":["version"],"excerpt":"version На поведение рантайма это поле не влияет.","content":"version На поведение рантайма это поле не влияет."},{"id":"cli/configuration/configuration::lint::53","title":"EasyP Configuration Reference","section":"lint","path":"/docs/guide/cli/configuration/configuration#lint","headings":["lint"],"excerpt":"lint **Optional.** Configures proto file linting rules and behavior.","content":"lint **Optional.** Configures proto file linting rules and behavior."},{"id":"cli/configuration/configuration::lint::54","title":"EasyP Configuration Reference","section":"lint","path":"/docs/guide/cli/configuration/configuration#lint","headings":["lint"],"excerpt":"lint **Type:** object **Default:** Empty (no linting rules applied)","content":"lint **Type:** object **Default:** Empty (no linting rules applied)"},{"id":"cli/configuration/configuration::lintuse::55","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **Optional.** Specifies which linter rules or rule categories to apply.","content":"lint.use **Optional.** Specifies which linter rules or rule categories to apply."},{"id":"cli/configuration/configuration::lintuse::56","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **Type:** []string **Default:** [] (no rules)","content":"lint.use **Type:** []string **Default:** [] (no rules)"},{"id":"cli/configuration/configuration::lintuse::57","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **Available categories:** MINIMAL - Essential package consistency checks BASIC - Naming conventions and common patterns DEFAULT - Additional recommended rules COMMENTS - Comment requirements UNARY_RPC - Streamin","content":"lint.use **Available categories:** MINIMAL - Essential package consistency checks BASIC - Naming conventions and common patterns DEFAULT - Additional recommended rules COMMENTS - Comment requirements UNARY_RPC - Streaming RPC restrictions"},{"id":"cli/configuration/configuration::lintuse::58","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **Individual rules:** Any specific rule name (e.g., ENUM_PASCAL_CASE, FIELD_LOWER_SNAKE_CASE)","content":"lint.use **Individual rules:** Any specific rule name (e.g., ENUM_PASCAL_CASE, FIELD_LOWER_SNAKE_CASE)"},{"id":"cli/configuration/configuration::lintuse::59","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **MINIMAL:** DIRECTORY_SAME_PACKAGE PACKAGE_DEFINED PACKAGE_DIRECTORY_MATCH PACKAGE_SAME_DIRECTORY","content":"lint.use **MINIMAL:** DIRECTORY_SAME_PACKAGE PACKAGE_DEFINED PACKAGE_DIRECTORY_MATCH PACKAGE_SAME_DIRECTORY"},{"id":"cli/configuration/configuration::lintuse::60","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **BASIC:** ENUM_FIRST_VALUE_ZERO ENUM_NO_ALLOW_ALIAS ENUM_PASCAL_CASE ENUM_VALUE_UPPER_SNAKE_CASE FIELD_LOWER_SNAKE_CASE IMPORT_NO_PUBLIC IMPORT_NO_WEAK IMPORT_USED MESSAGE_PASCAL_CASE ONEOF_LOWER_SNAKE_CASE PAC","content":"lint.use **BASIC:** ENUM_FIRST_VALUE_ZERO ENUM_NO_ALLOW_ALIAS ENUM_PASCAL_CASE ENUM_VALUE_UPPER_SNAKE_CASE FIELD_LOWER_SNAKE_CASE IMPORT_NO_PUBLIC IMPORT_NO_WEAK IMPORT_USED MESSAGE_PASCAL_CASE ONEOF_LOWER_SNAKE_CASE PACKAGE_LOWER_SNAKE_CASE PACKAGE_SAME_CSHARP_NAMESPACE PACKAGE_SAME_GO_PACKAGE PACKAGE_SAME_JAVA_MULTIPLE_FILES PACKAGE_SAME_JAVA_PACKAGE PACKAGE_SAME_PHP_NAMESPACE PACKAGE_SAME_RUBY_PACKAGE PACKAGE_SAME_SWIFT_PREFIX RPC_PASCAL_CASE SERVICE_PASCAL_CASE"},{"id":"cli/configuration/configuration::lintuse::61","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **DEFAULT:** ENUM_VALUE_PREFIX ENUM_ZERO_VALUE_SUFFIX FILE_LOWER_SNAKE_CASE RPC_REQUEST_RESPONSE_UNIQUE RPC_REQUEST_STANDARD_NAME RPC_RESPONSE_STANDARD_NAME PACKAGE_VERSION_SUFFIX SERVICE_SUFFIX","content":"lint.use **DEFAULT:** ENUM_VALUE_PREFIX ENUM_ZERO_VALUE_SUFFIX FILE_LOWER_SNAKE_CASE RPC_REQUEST_RESPONSE_UNIQUE RPC_REQUEST_STANDARD_NAME RPC_RESPONSE_STANDARD_NAME PACKAGE_VERSION_SUFFIX SERVICE_SUFFIX"},{"id":"cli/configuration/configuration::lintuse::62","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **COMMENTS:** COMMENT_ENUM COMMENT_ENUM_VALUE COMMENT_FIELD COMMENT_MESSAGE COMMENT_ONEOF COMMENT_RPC COMMENT_SERVICE","content":"lint.use **COMMENTS:** COMMENT_ENUM COMMENT_ENUM_VALUE COMMENT_FIELD COMMENT_MESSAGE COMMENT_ONEOF COMMENT_RPC COMMENT_SERVICE"},{"id":"cli/configuration/configuration::lintuse::63","title":"EasyP Configuration Reference","section":"lint.use","path":"/docs/guide/cli/configuration/configuration#lintuse","headings":["lint.use"],"excerpt":"lint.use **UNARY_RPC:** RPC_NO_CLIENT_STREAMING RPC_NO_SERVER_STREAMING","content":"lint.use **UNARY_RPC:** RPC_NO_CLIENT_STREAMING RPC_NO_SERVER_STREAMING"},{"id":"cli/configuration/configuration::lintenum_zero_value_suffix::64","title":"EasyP Configuration Reference","section":"lint.enum_zero_value_suffix","path":"/docs/guide/cli/configuration/configuration#lintenum_zero_value_suffix","headings":["lint.enum_zero_value_suffix"],"excerpt":"lint.enum_zero_value_suffix **Optional.** Specifies the required suffix for enum zero values.","content":"lint.enum_zero_value_suffix **Optional.** Specifies the required suffix for enum zero values."},{"id":"cli/configuration/configuration::lintenum_zero_value_suffix::65","title":"EasyP Configuration Reference","section":"lint.enum_zero_value_suffix","path":"/docs/guide/cli/configuration/configuration#lintenum_zero_value_suffix","headings":["lint.enum_zero_value_suffix"],"excerpt":"lint.enum_zero_value_suffix **Type:** string **Default:** \"\" (no suffix required) **Common values:** \"UNSPECIFIED\", \"UNKNOWN\", \"DEFAULT\"","content":"lint.enum_zero_value_suffix **Type:** string **Default:** \"\" (no suffix required) **Common values:** \"UNSPECIFIED\", \"UNKNOWN\", \"DEFAULT\""},{"id":"cli/configuration/configuration::lintenum_zero_value_suffix::66","title":"EasyP Configuration Reference","section":"lint.enum_zero_value_suffix","path":"/docs/guide/cli/configuration/configuration#lintenum_zero_value_suffix","headings":["lint.enum_zero_value_suffix"],"excerpt":"lint.enum_zero_value_suffix This enforces enum zero values like:","content":"lint.enum_zero_value_suffix This enforces enum zero values like:"},{"id":"cli/configuration/configuration::lintservice_suffix::67","title":"EasyP Configuration Reference","section":"lint.service_suffix","path":"/docs/guide/cli/configuration/configuration#lintservice_suffix","headings":["lint.service_suffix"],"excerpt":"lint.service_suffix **Optional.** Specifies the required suffix for service names.","content":"lint.service_suffix **Optional.** Specifies the required suffix for service names."},{"id":"cli/configuration/configuration::lintservice_suffix::68","title":"EasyP Configuration Reference","section":"lint.service_suffix","path":"/docs/guide/cli/configuration/configuration#lintservice_suffix","headings":["lint.service_suffix"],"excerpt":"lint.service_suffix **Type:** string **Default:** \"\" (no suffix required) **Common values:** \"Service\", \"API\", \"Svc\"","content":"lint.service_suffix **Type:** string **Default:** \"\" (no suffix required) **Common values:** \"Service\", \"API\", \"Svc\""},{"id":"cli/configuration/configuration::lintservice_suffix::69","title":"EasyP Configuration Reference","section":"lint.service_suffix","path":"/docs/guide/cli/configuration/configuration#lintservice_suffix","headings":["lint.service_suffix"],"excerpt":"lint.service_suffix This enforces service names like:","content":"lint.service_suffix This enforces service names like:"},{"id":"cli/configuration/configuration::lintignore::70","title":"EasyP Configuration Reference","section":"lint.ignore","path":"/docs/guide/cli/configuration/configuration#lintignore","headings":["lint.ignore"],"excerpt":"lint.ignore **Optional.** Directories or files to exclude from all linting rules.","content":"lint.ignore **Optional.** Directories or files to exclude from all linting rules."},{"id":"cli/configuration/configuration::lintignore::71","title":"EasyP Configuration Reference","section":"lint.ignore","path":"/docs/guide/cli/configuration/configuration#lintignore","headings":["lint.ignore"],"excerpt":"lint.ignore **Type:** []string **Default:** []","content":"lint.ignore **Type:** []string **Default:** []"},{"id":"cli/configuration/configuration::lintignore::72","title":"EasyP Configuration Reference","section":"lint.ignore","path":"/docs/guide/cli/configuration/configuration#lintignore","headings":["lint.ignore"],"excerpt":"lint.ignore Paths are relative to the easyp.yaml file location. Supports glob patterns.","content":"lint.ignore Paths are relative to the easyp.yaml file location. Supports glob patterns."},{"id":"cli/configuration/configuration::lintexcept::73","title":"EasyP Configuration Reference","section":"lint.except","path":"/docs/guide/cli/configuration/configuration#lintexcept","headings":["lint.except"],"excerpt":"lint.except **Optional.** Disables specific rules globally across the entire project.","content":"lint.except **Optional.** Disables specific rules globally across the entire project."},{"id":"cli/configuration/configuration::lintexcept::74","title":"EasyP Configuration Reference","section":"lint.except","path":"/docs/guide/cli/configuration/configuration#lintexcept","headings":["lint.except"],"excerpt":"lint.except **Type:** []string **Default:** []","content":"lint.except **Type:** []string **Default:** []"},{"id":"cli/configuration/configuration::lintallow_comment_ignores::75","title":"EasyP Configuration Reference","section":"lint.allow_comment_ignores","path":"/docs/guide/cli/configuration/configuration#lintallow_comment_ignores","headings":["lint.allow_comment_ignores"],"excerpt":"lint.allow_comment_ignores **Optional.** Enables inline comment-based rule ignoring within proto files.","content":"lint.allow_comment_ignores **Optional.** Enables inline comment-based rule ignoring within proto files."},{"id":"cli/configuration/configuration::lintallow_comment_ignores::76","title":"EasyP Configuration Reference","section":"lint.allow_comment_ignores","path":"/docs/guide/cli/configuration/configuration#lintallow_comment_ignores","headings":["lint.allow_comment_ignores"],"excerpt":"lint.allow_comment_ignores **Type:** boolean **Default:** false","content":"lint.allow_comment_ignores **Type:** boolean **Default:** false"},{"id":"cli/configuration/configuration::lintallow_comment_ignores::77","title":"EasyP Configuration Reference","section":"lint.allow_comment_ignores","path":"/docs/guide/cli/configuration/configuration#lintallow_comment_ignores","headings":["lint.allow_comment_ignores"],"excerpt":"lint.allow_comment_ignores When enabled, allows comments like:","content":"lint.allow_comment_ignores When enabled, allows comments like:"},{"id":"cli/configuration/configuration::lintignore_only::78","title":"EasyP Configuration Reference","section":"lint.ignore_only","path":"/docs/guide/cli/configuration/configuration#lintignore_only","headings":["lint.ignore_only"],"excerpt":"lint.ignore_only **Optional.** Disables specific rules only for certain files or directories.","content":"lint.ignore_only **Optional.** Disables specific rules only for certain files or directories."},{"id":"cli/configuration/configuration::lintignore_only::79","title":"EasyP Configuration Reference","section":"lint.ignore_only","path":"/docs/guide/cli/configuration/configuration#lintignore_only","headings":["lint.ignore_only"],"excerpt":"lint.ignore_only **Type:** mapstringstring **Default:** {}","content":"lint.ignore_only **Type:** mapstringstring **Default:** {}"},{"id":"cli/configuration/configuration::lintignore_only::80","title":"EasyP Configuration Reference","section":"lint.ignore_only","path":"/docs/guide/cli/configuration/configuration#lintignore_only","headings":["lint.ignore_only"],"excerpt":"lint.ignore_only **Key:** Rule name or category **Value:** Array of file paths or directories","content":"lint.ignore_only **Key:** Rule name or category **Value:** Array of file paths or directories"},{"id":"cli/configuration/configuration::deps::81","title":"EasyP Configuration Reference","section":"deps","path":"/docs/guide/cli/configuration/configuration#deps","headings":["deps"],"excerpt":"deps **Optional.** Lists external proto dependencies to download and manage.","content":"deps **Optional.** Lists external proto dependencies to download and manage."},{"id":"cli/configuration/configuration::deps::82","title":"EasyP Configuration Reference","section":"deps","path":"/docs/guide/cli/configuration/configuration#deps","headings":["deps"],"excerpt":"deps **Type:** []string **Default:** []","content":"deps **Type:** []string **Default:** []"},{"id":"cli/configuration/configuration::dependency-format::83","title":"EasyP Configuration Reference","section":"Dependency Format","path":"/docs/guide/cli/configuration/configuration#dependency-format","headings":["Dependency Format"],"excerpt":"Dependency Format Dependencies follow the format: $GIT_LINK@$VERSION","content":"Dependency Format Dependencies follow the format: $GIT_LINK@$VERSION"},{"id":"cli/configuration/configuration::dependency-format::84","title":"EasyP Configuration Reference","section":"Dependency Format","path":"/docs/guide/cli/configuration/configuration#dependency-format","headings":["Dependency Format"],"excerpt":"Dependency Format **Components:** $GIT_LINK - Git repository URL (GitHub, GitLab, etc.) $VERSION - Git tag or full commit hash (optional)","content":"Dependency Format **Components:** $GIT_LINK - Git repository URL (GitHub, GitLab, etc.) $VERSION - Git tag or full commit hash (optional)"},{"id":"cli/configuration/configuration::dependency-format::85","title":"EasyP Configuration Reference","section":"Dependency Format","path":"/docs/guide/cli/configuration/configuration#dependency-format","headings":["Dependency Format"],"excerpt":"Dependency Format **Format variations:** owner/repo - Latest commit from default branch owner/repo@v1.0.0 - Specific git tag owner/repo@47b927cbb41c4fdea1292baf - Full commit hash github.com/owner/repo@version - Full URL","content":"Dependency Format **Format variations:** owner/repo - Latest commit from default branch owner/repo@v1.0.0 - Specific git tag owner/repo@47b927cbb41c4fdea1292baf - Full commit hash github.com/owner/repo@version - Full URL with version gitlab.com/group/repo@tag - GitLab repository"},{"id":"cli/configuration/configuration::dependency-format::86","title":"EasyP Configuration Reference","section":"Dependency Format","path":"/docs/guide/cli/configuration/configuration#dependency-format","headings":["Dependency Format"],"excerpt":"Dependency Format **Note:** If @$VERSION is omitted, EasyP downloads the latest commit from the repository's default branch.","content":"Dependency Format **Note:** If @$VERSION is omitted, EasyP downloads the latest commit from the repository's default branch."},{"id":"cli/configuration/configuration::generate::87","title":"EasyP Configuration Reference","section":"generate","path":"/docs/guide/cli/configuration/configuration#generate","headings":["generate"],"excerpt":"generate **Optional.** Configures code generation from proto files.","content":"generate **Optional.** Configures code generation from proto files."},{"id":"cli/configuration/configuration::generate::88","title":"EasyP Configuration Reference","section":"generate","path":"/docs/guide/cli/configuration/configuration#generate","headings":["generate"],"excerpt":"generate **Type:** object **Default:** {}","content":"generate **Type:** object **Default:** {}"},{"id":"cli/configuration/configuration::generateinputs::89","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs **Required when generate is set.** Specifies sources of proto files for generation.","content":"generate.inputs **Required when generate is set.** Specifies sources of proto files for generation."},{"id":"cli/configuration/configuration::generateinputs::90","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs **Type:** []object (minimum 1 item) **Default:** not set","content":"generate.inputs **Type:** []object (minimum 1 item) **Default:** not set"},{"id":"cli/configuration/configuration::generateinputs::91","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs ```yaml generate: inputs: # Local directory - directory: \"proto\"","content":"generate.inputs ```yaml generate: inputs: # Local directory - directory: \"proto\""},{"id":"cli/configuration/configuration::generateinputs::92","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs Local directory with advanced options - directory: path: \"api/proto\" root: \".\"","content":"generate.inputs Local directory with advanced options - directory: path: \"api/proto\" root: \".\""},{"id":"cli/configuration/configuration::generateinputs::93","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs Remote git repository - git_repo: url: \"github.com/acme/common@v1.0.0\" sub_directory: \"proto\" root: \".\" ```","content":"generate.inputs Remote git repository - git_repo: url: \"github.com/acme/common@v1.0.0\" sub_directory: \"proto\" root: \".\" ```"},{"id":"cli/configuration/configuration::generateinputs::94","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs **Directory input fields:** directory (string or object) - Local directory path directory.path (string) - Directory path directory.root (string) - Root path for import resolution (default: \".\")","content":"generate.inputs **Directory input fields:** directory (string or object) - Local directory path directory.path (string) - Directory path directory.root (string) - Root path for import resolution (default: \".\")"},{"id":"cli/configuration/configuration::generateinputs::95","title":"EasyP Configuration Reference","section":"generate.inputs","path":"/docs/guide/cli/configuration/configuration#generateinputs","headings":["generate.inputs"],"excerpt":"generate.inputs **Git repository input fields:** git_repo.url (string) - Repository URL with optional version git_repo.sub_directory (string) - Subdirectory within the repository git_repo.root (string) - Root path used f","content":"generate.inputs **Git repository input fields:** git_repo.url (string) - Repository URL with optional version git_repo.sub_directory (string) - Subdirectory within the repository git_repo.root (string) - Root path used for import resolution"},{"id":"cli/configuration/configuration::generateplugins::96","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins **Required when generate is set.** Configures protoc plugins for code generation.","content":"generate.plugins **Required when generate is set.** Configures protoc plugins for code generation."},{"id":"cli/configuration/configuration::generateplugins::97","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins **Type:** []object (minimum 1 item) **Default:** not set","content":"generate.plugins **Type:** []object (minimum 1 item) **Default:** not set"},{"id":"cli/configuration/configuration::generateplugins::98","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins ```yaml generate: plugins: # Local plugin - name: go out: . opts: paths: source_relative","content":"generate.plugins ```yaml generate: plugins: # Local plugin - name: go out: . opts: paths: source_relative"},{"id":"cli/configuration/configuration::generateplugins::99","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins Remote plugin - remote: \"buf.build/bufbuild/protovalidate-go:v0.4.0\" out: gen/go opts: paths: source_relative","content":"generate.plugins Remote plugin - remote: \"buf.build/bufbuild/protovalidate-go:v0.4.0\" out: gen/go opts: paths: source_relative"},{"id":"cli/configuration/configuration::generateplugins::100","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins Plugin with import dependencies - name: grpc-gateway out: . with_imports: true opts: paths: source_relative ```","content":"generate.plugins Plugin with import dependencies - name: grpc-gateway out: . with_imports: true opts: paths: source_relative ```"},{"id":"cli/configuration/configuration::generateplugins::101","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins **Plugin fields:** name (string, optional) - Plugin name (omit protoc-gen- prefix) remote (string, optional) - Remote plugin URL for execution path (string, optional) - Path to plugin executable file com","content":"generate.plugins **Plugin fields:** name (string, optional) - Plugin name (omit protoc-gen- prefix) remote (string, optional) - Remote plugin URL for execution path (string, optional) - Path to plugin executable file command ([]string, optional) - Command to execute plugin out (string, optional) - Output directory for generated files; defaults to the resolved generate root opts (mapstring, optional) - Plugin-specific options; each key can be a single scalar value or an array of scalar values with_imports (boolean, optional) - Include imported dependencies"},{"id":"cli/configuration/configuration::generateplugins::102","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins Plugin source is one-of: exactly one of name, remote, path, or command must be set.","content":"generate.plugins Plugin source is one-of: exactly one of name, remote, path, or command must be set."},{"id":"cli/configuration/configuration::generateplugins::103","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins **Common plugin options:** ```yaml Go plugin options opts: paths: source_relative # Generate files relative to input module: github.com/acme/api # Go module path","content":"generate.plugins **Common plugin options:** ```yaml Go plugin options opts: paths: source_relative # Generate files relative to input module: github.com/acme/api # Go module path"},{"id":"cli/configuration/configuration::generateplugins::104","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins gRPC Gateway options opts: paths: source_relative grpc_api_configuration: api.yaml # gRPC API configuration","content":"generate.plugins gRPC Gateway options opts: paths: source_relative grpc_api_configuration: api.yaml # gRPC API configuration"},{"id":"cli/configuration/configuration::generateplugins::105","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins OpenAPI v2 options opts: simple_operation_ids: true # Use simple operation IDs generate_unbound_methods: false # Skip unbound methods","content":"generate.plugins OpenAPI v2 options opts: simple_operation_ids: true # Use simple operation IDs generate_unbound_methods: false # Skip unbound methods"},{"id":"cli/configuration/configuration::generateplugins::106","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins ts-proto options with repeated key values opts: env: node outputServices: - grpc-js - generic-definitions ```","content":"generate.plugins ts-proto options with repeated key values opts: env: node outputServices: - grpc-js - generic-definitions ```"},{"id":"cli/configuration/configuration::generateplugins::107","title":"EasyP Configuration Reference","section":"generate.plugins","path":"/docs/guide/cli/configuration/configuration#generateplugins","headings":["generate.plugins"],"excerpt":"generate.plugins When an opts value is a list, EasyP serializes it as repeated plugin params, e.g. outputServices=grpc-js,outputServices=generic-definitions.","content":"generate.plugins When an opts value is a list, EasyP serializes it as repeated plugin params, e.g. outputServices=grpc-js,outputServices=generic-definitions."},{"id":"cli/configuration/configuration::breaking::108","title":"EasyP Configuration Reference","section":"breaking","path":"/docs/guide/cli/configuration/configuration#breaking","headings":["breaking"],"excerpt":"breaking **Optional.** Configures backward compatibility checking.","content":"breaking **Optional.** Configures backward compatibility checking."},{"id":"cli/configuration/configuration::breaking::109","title":"EasyP Configuration Reference","section":"breaking","path":"/docs/guide/cli/configuration/configuration#breaking","headings":["breaking"],"excerpt":"breaking **Type:** object **Default:** {}","content":"breaking **Type:** object **Default:** {}"},{"id":"cli/configuration/configuration::breakingignore::110","title":"EasyP Configuration Reference","section":"breaking.ignore","path":"/docs/guide/cli/configuration/configuration#breakingignore","headings":["breaking.ignore"],"excerpt":"breaking.ignore **Optional.** Directories or files to exclude from breaking change detection.","content":"breaking.ignore **Optional.** Directories or files to exclude from breaking change detection."},{"id":"cli/configuration/configuration::breakingignore::111","title":"EasyP Configuration Reference","section":"breaking.ignore","path":"/docs/guide/cli/configuration/configuration#breakingignore","headings":["breaking.ignore"],"excerpt":"breaking.ignore **Type:** []string **Default:** []","content":"breaking.ignore **Type:** []string **Default:** []"},{"id":"cli/configuration/configuration::breakingagainst_git_ref::112","title":"EasyP Configuration Reference","section":"breaking.against_git_ref","path":"/docs/guide/cli/configuration/configuration#breakingagainst_git_ref","headings":["breaking.against_git_ref"],"excerpt":"breaking.against_git_ref **Optional.** Git reference (branch, tag, or commit) to compare against for breaking changes.","content":"breaking.against_git_ref **Optional.** Git reference (branch, tag, or commit) to compare against for breaking changes."},{"id":"cli/configuration/configuration::breakingagainst_git_ref::113","title":"EasyP Configuration Reference","section":"breaking.against_git_ref","path":"/docs/guide/cli/configuration/configuration#breakingagainst_git_ref","headings":["breaking.against_git_ref"],"excerpt":"breaking.against_git_ref **Type:** string **Default:** \"\" (falls back to CLI --against default: master)","content":"breaking.against_git_ref **Type:** string **Default:** \"\" (falls back to CLI --against default: master)"},{"id":"cli/configuration/configuration::breakingagainst_git_ref::114","title":"EasyP Configuration Reference","section":"breaking.against_git_ref","path":"/docs/guide/cli/configuration/configuration#breakingagainst_git_ref","headings":["breaking.against_git_ref"],"excerpt":"breaking.against_git_ref Can be overridden by the --against CLI flag.","content":"breaking.against_git_ref Can be overridden by the --against CLI flag."},{"id":"cli/configuration/configuration::configuration-validation::115","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation EasyP validates configuration files on startup and provides helpful error messages:","content":"Configuration Validation EasyP validates configuration files on startup and provides helpful error messages:"},{"id":"cli/configuration/configuration::configuration-validation::116","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation ```bash Invalid rule name Error: invalid rule: INVALID_RULE_NAME","content":"Configuration Validation ```bash Invalid rule name Error: invalid rule: INVALID_RULE_NAME"},{"id":"cli/configuration/configuration::configuration-validation::117","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation Missing required field in generate section Error: required field \"plugins\" is missing (path: generate.plugins)","content":"Configuration Validation Missing required field in generate section Error: required field \"plugins\" is missing (path: generate.plugins)"},{"id":"cli/configuration/configuration::configuration-validation::118","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation Invalid dependency format Error: invalid dependency format: invalid-repo-url ```","content":"Configuration Validation Invalid dependency format Error: invalid dependency format: invalid-repo-url ```"},{"id":"cli/configuration/configuration::configuration-validation::119","title":"EasyP Configuration Reference","section":"Configuration Validation","path":"/docs/guide/cli/configuration/configuration#configuration-validation","headings":["Configuration Validation"],"excerpt":"Configuration Validation Use easyp --debug for detailed validation information.","content":"Configuration Validation Use easyp --debug for detailed validation information."},{"id":"cli/configuration/configuration::migration-from-buf::120","title":"EasyP Configuration Reference","section":"Migration from Buf","path":"/docs/guide/cli/configuration/configuration#migration-from-buf","headings":["Migration from Buf"],"excerpt":"Migration from Buf EasyP is fully compatible with Buf configurations. To migrate:","content":"Migration from Buf EasyP is fully compatible with Buf configurations. To migrate:"},{"id":"cli/configuration/configuration::migration-from-buf::121","title":"EasyP Configuration Reference","section":"Migration from Buf","path":"/docs/guide/cli/configuration/configuration#migration-from-buf","headings":["Migration from Buf"],"excerpt":"Migration from Buf Place buf.yaml or buf.yml in the project root Run easyp init and confirm migration when prompted Update deps format if using BSR modules Review migrated lint/breaking settings and adjust as needed","content":"Migration from Buf Place buf.yaml or buf.yml in the project root Run easyp init and confirm migration when prompted Update deps format if using BSR modules Review migrated lint/breaking settings and adjust as needed"},{"id":"cli/configuration/configuration::migration-from-buf::122","title":"EasyP Configuration Reference","section":"Migration from Buf","path":"/docs/guide/cli/configuration/configuration#migration-from-buf","headings":["Migration from Buf"],"excerpt":"Migration from Buf Most Buf configurations work without changes in EasyP.","content":"Migration from Buf Most Buf configurations work without changes in EasyP."},{"id":"cli/generator/examples/go::top::0","title":"Go","section":"Установка плагинов","path":"/docs/guide/cli/generator/examples/go","headings":["Установка плагинов"],"excerpt":"Установка плагинов Сначала установите необходимые плагины для работы с gRPC:","content":"Установка плагинов Сначала установите необходимые плагины для работы с gRPC:"},{"id":"cli/generator/examples/go::top::1","title":"Go","section":"Установка плагинов","path":"/docs/guide/cli/generator/examples/go","headings":["Установка плагинов"],"excerpt":"Установка плагинов Эти команды установят плагины protoc-gen-go и protoc-gen-go-grpc для использования с EasyP.","content":"Установка плагинов Эти команды установят плагины protoc-gen-go и protoc-gen-go-grpc для использования с EasyP."},{"id":"cli/generator/examples/go::proto::2","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса Ниже пример proto-файла для сервиса Echo:","content":"Пример proto‑сервиса Ниже пример proto-файла для сервиса Echo:"},{"id":"cli/generator/examples/go::proto::3","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса ```proto syntax = \"proto3\";","content":"Пример proto‑сервиса ```proto syntax = \"proto3\";"},{"id":"cli/generator/examples/go::proto::4","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса package api.echo.v1;","content":"Пример proto‑сервиса package api.echo.v1;"},{"id":"cli/generator/examples/go::proto::5","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";","content":"Пример proto‑сервиса option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";"},{"id":"cli/generator/examples/go::proto::6","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); rpc EchoStream(EchoStreamRequest) returns (EchoResponse); }","content":"Пример proto‑сервиса service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); rpc EchoStream(EchoStreamRequest) returns (EchoResponse); }"},{"id":"cli/generator/examples/go::proto::7","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса message EchoRequest { string payload = 1; }","content":"Пример proto‑сервиса message EchoRequest { string payload = 1; }"},{"id":"cli/generator/examples/go::proto::8","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса message EchoResponse { string payload = 2; }","content":"Пример proto‑сервиса message EchoResponse { string payload = 2; }"},{"id":"cli/generator/examples/go::proto::9","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса message EchoStreamRequest { string payload = 1; }","content":"Пример proto‑сервиса message EchoStreamRequest { string payload = 1; }"},{"id":"cli/generator/examples/go::proto::10","title":"Go","section":"Пример proto‑сервиса","path":"/docs/guide/cli/generator/examples/go#proto","headings":["Пример proto‑сервиса"],"excerpt":"Пример proto‑сервиса message EchoStreamResponse { string payload = 2; } ```","content":"Пример proto‑сервиса message EchoStreamResponse { string payload = 2; } ```"},{"id":"cli/generator/examples/go::top::11","title":"Go","section":"Настройка конфигурации","path":"/docs/guide/cli/generator/examples/go","headings":["Настройка конфигурации"],"excerpt":"Настройка конфигурации Создайте и настройте файл конфигурации easyp.yaml:","content":"Настройка конфигурации Создайте и настройте файл конфигурации easyp.yaml:"},{"id":"cli/generator/examples/go::top::12","title":"Go","section":"Настройка конфигурации","path":"/docs/guide/cli/generator/examples/go","headings":["Настройка конфигурации"],"excerpt":"Настройка конфигурации Этот файл указывает использование двух плагинов: go для генерации Go-кода и go-grpc для генерации gRPC-кода, вместе с их опциями.","content":"Настройка конфигурации Этот файл указывает использование двух плагинов: go для генерации Go-кода и go-grpc для генерации gRPC-кода, вместе с их опциями."},{"id":"cli/generator/examples/go::top::13","title":"Go","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/go","headings":["Генерация кода"],"excerpt":"Генерация кода Чтобы сгенерировать код, выполните команду:","content":"Генерация кода Чтобы сгенерировать код, выполните команду:"},{"id":"cli/generator/examples/go::top::14","title":"Go","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/go","headings":["Генерация кода"],"excerpt":"Генерация кода Если флаг --cfg не указан, по умолчанию используется файл easyp.yaml в текущей директории:","content":"Генерация кода Если флаг --cfg не указан, по умолчанию используется файл easyp.yaml в текущей директории:"},{"id":"cli/generator/examples/go::top::15","title":"Go","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/go","headings":["Генерация кода"],"excerpt":"Генерация кода Теперь у вас есть сгенерированный Go‑код, с которым можно напрямую работать.","content":"Генерация кода Теперь у вас есть сгенерированный Go‑код, с которым можно напрямую работать."},{"id":"cli/generator/examples/grpc-gateway::top::0","title":"gRPC-Gateway","section":"Установка плагинов","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Установка плагинов"],"excerpt":"Установка плагинов В дополнение к плагинам для работы с gRPC, необходимо установить следующие плагины для gRPC-Gateway:","content":"Установка плагинов В дополнение к плагинам для работы с gRPC, необходимо установить следующие плагины для gRPC-Gateway:"},{"id":"cli/generator/examples/grpc-gateway::top::1","title":"gRPC-Gateway","section":"Установка плагинов","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Установка плагинов"],"excerpt":"Установка плагинов go install google.golang.org/protobuf/cmd/protoc-gen-go@latest go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2@","content":"Установка плагинов go install google.golang.org/protobuf/cmd/protoc-gen-go@latest go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2@latest go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest"},{"id":"cli/generator/examples/grpc-gateway::top::2","title":"gRPC-Gateway","section":"Установка плагинов","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Установка плагинов"],"excerpt":"Установка плагинов Эти команды установят плагины protoc-gen-go, protoc-gen-go-grpc, protoc-gen-openapiv2 и protoc-gen-grpc-gateway для использования с EasyP.","content":"Установка плагинов Эти команды установят плагины protoc-gen-go, protoc-gen-go-grpc, protoc-gen-openapiv2 и protoc-gen-grpc-gateway для использования с EasyP."},{"id":"cli/generator/examples/grpc-gateway::proto::3","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса Ниже — исходный proto‑файл для сервиса Echo:","content":"Пример Proto сервиса Ниже — исходный proto‑файл для сервиса Echo:"},{"id":"cli/generator/examples/grpc-gateway::proto::4","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса syntax = \"proto3\";","content":"Пример Proto сервиса syntax = \"proto3\";"},{"id":"cli/generator/examples/grpc-gateway::proto::5","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса package api.echo.v1;","content":"Пример Proto сервиса package api.echo.v1;"},{"id":"cli/generator/examples/grpc-gateway::proto::6","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";","content":"Пример Proto сервиса option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";"},{"id":"cli/generator/examples/grpc-gateway::proto::7","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); }","content":"Пример Proto сервиса service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); }"},{"id":"cli/generator/examples/grpc-gateway::proto::8","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса message EchoRequest { string payload = 1; }","content":"Пример Proto сервиса message EchoRequest { string payload = 1; }"},{"id":"cli/generator/examples/grpc-gateway::proto::9","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса message EchoResponse { string payload = 2; }","content":"Пример Proto сервиса message EchoResponse { string payload = 2; }"},{"id":"cli/generator/examples/grpc-gateway::proto::10","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса Чтобы использовать gRPC-Gateway, обновите proto‑файл, добавив HTTP‑опции:","content":"Пример Proto сервиса Чтобы использовать gRPC-Gateway, обновите proto‑файл, добавив HTTP‑опции:"},{"id":"cli/generator/examples/grpc-gateway::proto::11","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса syntax = \"proto3\"; import \"google/api/annotations.proto\";","content":"Пример Proto сервиса syntax = \"proto3\"; import \"google/api/annotations.proto\";"},{"id":"cli/generator/examples/grpc-gateway::proto::12","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса package api.echo.v1;","content":"Пример Proto сервиса package api.echo.v1;"},{"id":"cli/generator/examples/grpc-gateway::proto::13","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";","content":"Пример Proto сервиса option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";"},{"id":"cli/generator/examples/grpc-gateway::proto::14","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse) { option (google.api.http) = { // [!code ++] post: \"/api/v1/echo\" // [!code ++] body: \"*\" // [!code ++] }; // [!code ++] } }","content":"Пример Proto сервиса service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse) { option (google.api.http) = { // [!code ++] post: \"/api/v1/echo\" // [!code ++] body: \"*\" // [!code ++] }; // [!code ++] } }"},{"id":"cli/generator/examples/grpc-gateway::proto::15","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса message EchoRequest { string payload = 1; }","content":"Пример Proto сервиса message EchoRequest { string payload = 1; }"},{"id":"cli/generator/examples/grpc-gateway::proto::16","title":"gRPC-Gateway","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/grpc-gateway#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса message EchoResponse { string payload = 2; }","content":"Пример Proto сервиса message EchoResponse { string payload = 2; }"},{"id":"cli/generator/examples/grpc-gateway::top::17","title":"gRPC-Gateway","section":"Настройка конфигурации","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Настройка конфигурации"],"excerpt":"Настройка конфигурации Обновите файл easyp.yaml, добавив необходимые зависимости и плагины: deps: # [!code ++] - github.com/googleapis/googleapis # [!code ++]","content":"Настройка конфигурации Обновите файл easyp.yaml, добавив необходимые зависимости и плагины: deps: # [!code ++] - github.com/googleapis/googleapis # [!code ++]"},{"id":"cli/generator/examples/grpc-gateway::top::18","title":"gRPC-Gateway","section":"Настройка конфигурации","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Настройка конфигурации"],"excerpt":"Настройка конфигурации generate: plugins: - name: go out: . opts: paths: source_relative - name: go-grpc out: . opts: paths: source_relative require_unimplemented_servers: false - name: grpc-gateway # [!code ++] out: . #","content":"Настройка конфигурации generate: plugins: - name: go out: . opts: paths: source_relative - name: go-grpc out: . opts: paths: source_relative require_unimplemented_servers: false - name: grpc-gateway # [!code ++] out: . # [!code ++] opts: # [!code ++] paths: source_relative # [!code ++] - name: openapiv2 # [!code ++] out: . # [!code ++] opts: # [!code ++] simple_operation_ids: false # [!code ++] generate_unbound_methods: false # [!code ++]"},{"id":"cli/generator/examples/grpc-gateway::top::19","title":"gRPC-Gateway","section":"Настройка конфигурации","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Настройка конфигурации"],"excerpt":"Настройка конфигурации Секция deps перечисляет зависимости, необходимые для импортов proto‑файлов. В данном случае добавляем github.com/googleapis/googleapis, поскольку там находится файл annotations.proto, используемый ","content":"Настройка конфигурации Секция deps перечисляет зависимости, необходимые для импортов proto‑файлов. В данном случае добавляем github.com/googleapis/googleapis, поскольку там находится файл annotations.proto, используемый в определении сервиса."},{"id":"cli/generator/examples/grpc-gateway::top::20","title":"gRPC-Gateway","section":"Обновление зависимостей","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Обновление зависимостей"],"excerpt":"Обновление зависимостей После обновления конфигурации выполните команду для загрузки указанных зависимостей:","content":"Обновление зависимостей После обновления конфигурации выполните команду для загрузки указанных зависимостей:"},{"id":"cli/generator/examples/grpc-gateway::top::21","title":"gRPC-Gateway","section":"Обновление зависимостей","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Обновление зависимостей"],"excerpt":"Обновление зависимостей easyp mod update","content":"Обновление зависимостей easyp mod update"},{"id":"cli/generator/examples/grpc-gateway::top::22","title":"gRPC-Gateway","section":"Обновление зависимостей","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Обновление зависимостей"],"excerpt":"Обновление зависимостей Больше деталей по управлению зависимостями см. в разделе Package Manager.","content":"Обновление зависимостей Больше деталей по управлению зависимостями см. в разделе Package Manager."},{"id":"cli/generator/examples/grpc-gateway::top::23","title":"gRPC-Gateway","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Генерация кода"],"excerpt":"Генерация кода Для генерации кода используйте:","content":"Генерация кода Для генерации кода используйте:"},{"id":"cli/generator/examples/grpc-gateway::top::24","title":"gRPC-Gateway","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Генерация кода"],"excerpt":"Генерация кода easyp --cfg easyp.yaml generate","content":"Генерация кода easyp --cfg easyp.yaml generate"},{"id":"cli/generator/examples/grpc-gateway::top::25","title":"gRPC-Gateway","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Генерация кода"],"excerpt":"Генерация кода Если флаг --cfg не указан, по умолчанию используется файл easyp.yaml из текущей директории:","content":"Генерация кода Если флаг --cfg не указан, по умолчанию используется файл easyp.yaml из текущей директории:"},{"id":"cli/generator/examples/grpc-gateway::top::26","title":"gRPC-Gateway","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/grpc-gateway","headings":["Генерация кода"],"excerpt":"Генерация кода Теперь у вас сгенерированы Go‑код и код gRPC-Gateway, с которыми можно работать напрямую.","content":"Генерация кода Теперь у вас сгенерированы Go‑код и код gRPC-Gateway, с которыми можно работать напрямую."},{"id":"cli/generator/examples/validate::top::0","title":"Validate","section":"Установка плагинов","path":"/docs/guide/cli/generator/examples/validate","headings":["Установка плагинов"],"excerpt":"Установка плагинов Сначала установите необходимые плагины для работы с gRPC и проверок (validate):","content":"Установка плагинов Сначала установите необходимые плагины для работы с gRPC и проверок (validate):"},{"id":"cli/generator/examples/validate::top::1","title":"Validate","section":"Установка плагинов","path":"/docs/guide/cli/generator/examples/validate","headings":["Установка плагинов"],"excerpt":"Установка плагинов Эти команды установят плагины protoc-gen-go, protoc-gen-go-grpc и protoc-gen-validate для использования вместе с EasyP.","content":"Установка плагинов Эти команды установят плагины protoc-gen-go, protoc-gen-go-grpc и protoc-gen-validate для использования вместе с EasyP."},{"id":"cli/generator/examples/validate::proto::2","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса Ниже пример proto‑файла для сервиса Echo:","content":"Пример Proto сервиса Ниже пример proto‑файла для сервиса Echo:"},{"id":"cli/generator/examples/validate::proto::3","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса ```proto syntax = \"proto3\";","content":"Пример Proto сервиса ```proto syntax = \"proto3\";"},{"id":"cli/generator/examples/validate::proto::4","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса package api.echo.v1;","content":"Пример Proto сервиса package api.echo.v1;"},{"id":"cli/generator/examples/validate::proto::5","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса import \"validate/validate.proto\";","content":"Пример Proto сервиса import \"validate/validate.proto\";"},{"id":"cli/generator/examples/validate::proto::6","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";","content":"Пример Proto сервиса option go_package = \"github.com/easyp-tech/example/api/echo/v1;pb\";"},{"id":"cli/generator/examples/validate::proto::7","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); rpc EchoStream(EchoStreamRequest) returns (EchoResponse); }","content":"Пример Proto сервиса service EchoAPI { rpc Echo(EchoRequest) returns (EchoResponse); rpc EchoStream(EchoStreamRequest) returns (EchoResponse); }"},{"id":"cli/generator/examples/validate::proto::8","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса message EchoRequest { string payload = 1 [(validate.rules).string = {max_len: 200}]; }","content":"Пример Proto сервиса message EchoRequest { string payload = 1 [(validate.rules).string = {max_len: 200}]; }"},{"id":"cli/generator/examples/validate::proto::9","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса message EchoResponse { string payload = 2; }","content":"Пример Proto сервиса message EchoResponse { string payload = 2; }"},{"id":"cli/generator/examples/validate::proto::10","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса message EchoStreamRequest { string payload = 1 [(validate.rules).string = {max_len: 200}]; }","content":"Пример Proto сервиса message EchoStreamRequest { string payload = 1 [(validate.rules).string = {max_len: 200}]; }"},{"id":"cli/generator/examples/validate::proto::11","title":"Validate","section":"Пример Proto сервиса","path":"/docs/guide/cli/generator/examples/validate#proto","headings":["Пример Proto сервиса"],"excerpt":"Пример Proto сервиса message EchoStreamResponse { string payload = 2; } ```","content":"Пример Proto сервиса message EchoStreamResponse { string payload = 2; } ```"},{"id":"cli/generator/examples/validate::top::12","title":"Validate","section":"Настройка конфигурации","path":"/docs/guide/cli/generator/examples/validate","headings":["Настройка конфигурации"],"excerpt":"Настройка конфигурации Создайте и настройте файл конфигурации easyp.yaml:","content":"Настройка конфигурации Создайте и настройте файл конфигурации easyp.yaml:"},{"id":"cli/generator/examples/validate::top::13","title":"Validate","section":"Настройка конфигурации","path":"/docs/guide/cli/generator/examples/validate","headings":["Настройка конфигурации"],"excerpt":"Настройка конфигурации ```yaml deps: # [!code ++] - github.com/bufbuild/protoc-gen-validate # [!code ++]","content":"Настройка конфигурации ```yaml deps: # [!code ++] - github.com/bufbuild/protoc-gen-validate # [!code ++]"},{"id":"cli/generator/examples/validate::top::14","title":"Validate","section":"Настройка конфигурации","path":"/docs/guide/cli/generator/examples/validate","headings":["Настройка конфигурации"],"excerpt":"Настройка конфигурации generate: plugins: - name: go out: . opts: paths: source_relative - name: go-grpc out: . opts: paths: source_relative require_unimplemented_servers: false - name: validate out: . opts: paths: sourc","content":"Настройка конфигурации generate: plugins: - name: go out: . opts: paths: source_relative - name: go-grpc out: . opts: paths: source_relative require_unimplemented_servers: false - name: validate out: . opts: paths: source_relative lang: \"go\" ```"},{"id":"cli/generator/examples/validate::top::15","title":"Validate","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/validate","headings":["Генерация кода"],"excerpt":"Генерация кода Чтобы сгенерировать код, выполните команду:","content":"Генерация кода Чтобы сгенерировать код, выполните команду:"},{"id":"cli/generator/examples/validate::top::16","title":"Validate","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/validate","headings":["Генерация кода"],"excerpt":"Генерация кода Если флаг --cfg не указан, по умолчанию используется файл easyp.yaml из текущего каталога:","content":"Генерация кода Если флаг --cfg не указан, по умолчанию используется файл easyp.yaml из текущего каталога:"},{"id":"cli/generator/examples/validate::top::17","title":"Validate","section":"Генерация кода","path":"/docs/guide/cli/generator/examples/validate","headings":["Генерация кода"],"excerpt":"Генерация кода Теперь у вас есть сгенерированный Go‑код с поддержкой валидации, и вы можете напрямую использовать его в проекте.","content":"Генерация кода Теперь у вас есть сгенерированный Go‑код с поддержкой валидации, и вы можете напрямую использовать его в проекте."},{"id":"cli/generator/generator::top::0","title":"Генератор","path":"/docs/guide/cli/generator/generator","headings":[],"excerpt":"EasyP включает мощный генератор, который упрощает процесс получения кода из proto‑файлов. Благодаря YAML‑конфигурациям работа становится гораздо более удобной и интуитивной по сравнению с прямым использованием команды pr","content":"EasyP включает мощный генератор, который упрощает процесс получения кода из proto‑файлов. Благодаря YAML‑конфигурациям работа становится гораздо более удобной и интуитивной по сравнению с прямым использованием команды protoc."},{"id":"cli/generator/generator::top::1","title":"Генератор","section":"Ключевые особенности генератора","path":"/docs/guide/cli/generator/generator","headings":["Ключевые особенности генератора"],"excerpt":"Ключевые особенности генератора **Упрощённая генерация кода**: - Генерация кода из proto через декларативную YAML‑конфигурацию. - Избавляет от необходимости писать длинные и сложные команды protoc.","content":"Ключевые особенности генератора **Упрощённая генерация кода**: - Генерация кода из proto через декларативную YAML‑конфигурацию. - Избавляет от необходимости писать длинные и сложные команды protoc."},{"id":"cli/generator/generator::top::2","title":"Генератор","section":"Ключевые особенности генератора","path":"/docs/guide/cli/generator/generator","headings":["Ключевые особенности генератора"],"excerpt":"Ключевые особенности генератора **Обёртка над protoc**: - EasyP выступает как удобный слой над protoc, предоставляя декларативный API. - Поддерживает все опции и плагины, доступные protoc.","content":"Ключевые особенности генератора **Обёртка над protoc**: - EasyP выступает как удобный слой над protoc, предоставляя декларативный API. - Поддерживает все опции и плагины, доступные protoc."},{"id":"cli/generator/generator::top::3","title":"Генератор","section":"Ключевые особенности генератора","path":"/docs/guide/cli/generator/generator","headings":["Ключевые особенности генератора"],"excerpt":"Ключевые особенности генератора **Гибкость и кастомизация**: - Используются те же параметры, что и у плагинов protoc, прямо в конфиге. - Поддерживается множество плагинов и их параметры в одной конфигурации.","content":"Ключевые особенности генератора **Гибкость и кастомизация**: - Используются те же параметры, что и у плагинов protoc, прямо в конфиге. - Поддерживается множество плагинов и их параметры в одной конфигурации."},{"id":"cli/generator/generator::top::4","title":"Генератор","section":"Ключевые особенности генератора","path":"/docs/guide/cli/generator/generator","headings":["Ключевые особенности генератора"],"excerpt":"Ключевые особенности генератора **Генерация из нескольких источников**: - Локальные директории и удалённые Git‑репозитории одновременно. - Лёгкая интеграция с существующими проектами и репозиториями.","content":"Ключевые особенности генератора **Генерация из нескольких источников**: - Локальные директории и удалённые Git‑репозитории одновременно. - Лёгкая интеграция с существующими проектами и репозиториями."},{"id":"cli/generator/generator::top::5","title":"Генератор","section":"Ключевые особенности генератора","path":"/docs/guide/cli/generator/generator","headings":["Ключевые особенности генератора"],"excerpt":"Ключевые особенности генератора **Удалённая генерация**: - Генерация из удалённых Git репозиториев без локального checkout.","content":"Ключевые особенности генератора **Удалённая генерация**: - Генерация из удалённых Git репозиториев без локального checkout."},{"id":"cli/generator/generator::top::6","title":"Генератор","section":"Ключевые особенности генератора","path":"/docs/guide/cli/generator/generator","headings":["Ключевые особенности генератора"],"excerpt":"Ключевые особенности генератора **Интеграция с менеджером пакетов**: - Прозрачная работа с зависимостями через пакетный менеджер EasyP. - Автоматическое разрешение и подключение proto‑зависимостей.","content":"Ключевые особенности генератора **Интеграция с менеджером пакетов**: - Прозрачная работа с зависимостями через пакетный менеджер EasyP. - Автоматическое разрешение и подключение proto‑зависимостей."},{"id":"cli/generator/generator::complete-configuration-example::7","title":"Генератор","section":"Complete Configuration Example","path":"/docs/guide/cli/generator/generator#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example ```yaml Package manager dependencies deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 - github.com/bufbuild/protoc-gen-validate@","content":"Complete Configuration Example ```yaml Package manager dependencies deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 - github.com/bufbuild/protoc-gen-validate@v0.10.1"},{"id":"cli/generator/generator::complete-configuration-example::8","title":"Генератор","section":"Complete Configuration Example","path":"/docs/guide/cli/generator/generator#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example Code generation configuration generate: inputs: # Local directory input - directory: path: \"proto\" root: \".\" # Remote Git repository input - git_repo: url: \"github.com/acme/weather@v1.2.3\" ","content":"Complete Configuration Example Code generation configuration generate: inputs: # Local directory input - directory: path: \"proto\" root: \".\" # Remote Git repository input - git_repo: url: \"github.com/acme/weather@v1.2.3\" sub_directory: \"proto/api\" # Another remote repository - git_repo: url: \"https://github.com/company/internal-protos.git\" sub_directory: \"definitions\" plugins: # Local plugin execution - name: go out: ./gen/go opts: paths: source_relative module: github.com/mycompany/myproject with_imports: true # Local plugin with custom options - name: go-grpc out: ./gen/go opts: paths: source_relative require_unimplemented_servers: false"},{"id":"cli/generator/generator::complete-configuration-example::9","title":"Генератор","section":"Complete Configuration Example","path":"/docs/guide/cli/generator/generator#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example Managed mode - автоматическая установка file и field опций managed: enabled: true disable: - module: github.com/googleapis/googleapis # Отключить для конкретного модуля override: - file_opt","content":"Complete Configuration Example Managed mode - автоматическая установка file и field опций managed: enabled: true disable: - module: github.com/googleapis/googleapis # Отключить для конкретного модуля override: - file_option: go_package_prefix value: github.com/mycompany/myproject/gen/go - file_option: java_package_prefix value: com.mycompany - file_option: csharp_namespace_prefix value: MyCompany - field_option: jstype value: JS_STRING path: api/v1/ # Применить к конкретному пути"},{"id":"cli/generator/generator::complete-configuration-example::10","title":"Генератор","section":"Complete Configuration Example","path":"/docs/guide/cli/generator/generator#complete-configuration-example","headings":["Complete Configuration Example"],"excerpt":"Complete Configuration Example ```","content":"Complete Configuration Example ```"},{"id":"cli/generator/generator::local-directory-input::11","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) Локальная директория — самый распространённый и простой способ указать откуда брать proto для генерации. Используйте этот вариант, если файлы уже находятся в репозитории проекта.","content":"Локальный ввод (Local Directory Input) Локальная директория — самый распространённый и простой способ указать откуда брать proto для генерации. Используйте этот вариант, если файлы уже находятся в репозитории проекта."},{"id":"cli/generator/generator::local-directory-input::12","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) **Когда применять:** Proto файлы находятся в кодовой базе проекта Нужен полный контроль над структурой каталогов Проект — один сервис или приложение Файлы меняются не слишком часто","content":"Локальный ввод (Local Directory Input) **Когда применять:** Proto файлы находятся в кодовой базе проекта Нужен полный контроль над структурой каталогов Проект — один сервис или приложение Файлы меняются не слишком часто"},{"id":"cli/generator/generator::local-directory-input::13","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input)","content":"Локальный ввод (Local Directory Input)"},{"id":"cli/generator/generator::local-directory-input::14","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) Параметр root особенно полезен в монорепозиториях: он позволяет управлять тем, откуда будут резолвиться пути импортов. Если указать родительскую директорию, импорты будут оцениватьс","content":"Локальный ввод (Local Directory Input) Параметр root особенно полезен в монорепозиториях: он позволяет управлять тем, откуда будут резолвиться пути импортов. Если указать родительскую директорию, импорты будут оцениваться относительно неё, а не текущего рабочего каталога."},{"id":"cli/generator/generator::local-directory-input::15","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) **Параметры:**","content":"Локальный ввод (Local Directory Input) **Параметры:**"},{"id":"cli/generator/generator::local-directory-input::16","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) Параметр Тип Обязателен Значение по умолчанию Описание ---------- ----- ------------ ----------------------- ---------- path string ✅ - Каталог, содержащий proto файлы root string ❌","content":"Локальный ввод (Local Directory Input) Параметр Тип Обязателен Значение по умолчанию Описание ---------- ----- ------------ ----------------------- ---------- path string ✅ - Каталог, содержащий proto файлы root string ❌ \".\" Корневая директория для разрешения import путей"},{"id":"cli/generator/generator::local-directory-input::17","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) **Примеры:**","content":"Локальный ввод (Local Directory Input) **Примеры:**"},{"id":"cli/generator/generator::local-directory-input::18","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) Ниже показана разница между базовым указанием директории и расширенной конфигурацией с пользовательским корнем импортов:","content":"Локальный ввод (Local Directory Input) Ниже показана разница между базовым указанием директории и расширенной конфигурацией с пользовательским корнем импортов:"},{"id":"cli/generator/generator::local-directory-input::19","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) ```yaml Basic usage - Simple path specification inputs: - directory: \"api/proto\"","content":"Локальный ввод (Local Directory Input) ```yaml Basic usage - Simple path specification inputs: - directory: \"api/proto\""},{"id":"cli/generator/generator::local-directory-input::20","title":"Генератор","section":"Локальный ввод (Local Directory Input)","path":"/docs/guide/cli/generator/generator#local-directory-input","headings":["Локальный ввод (Local Directory Input)"],"excerpt":"Локальный ввод (Local Directory Input) Advanced usage with custom root - Controls import path resolution inputs: - directory: path: \"services/auth/proto\" root: \"services/auth\" # Imports will be relative to this path ```","content":"Локальный ввод (Local Directory Input) Advanced usage with custom root - Controls import path resolution inputs: - directory: path: \"services/auth/proto\" root: \"services/auth\" # Imports will be relative to this path ```"},{"id":"cli/generator/generator::git-remote-git-repository-input::21","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) Этот тип входных данных позволяет генерировать код из proto‑файлов, находящихся в удалённых репозиториях, без локального checkout. Особенно полезно при использовани","content":"Удалённый Git репозиторий (Remote Git Repository Input) Этот тип входных данных позволяет генерировать код из proto‑файлов, находящихся в удалённых репозиториях, без локального checkout. Особенно полезно при использовании API других команд или внешних поставщиков."},{"id":"cli/generator/generator::git-remote-git-repository-input::22","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) **Когда использовать:** Потребление proto определений из других сервисов/команд Интеграция с внешними вендорскими API Работа с общими библиотеками proto в нескольки","content":"Удалённый Git репозиторий (Remote Git Repository Input) **Когда использовать:** Потребление proto определений из других сервисов/команд Интеграция с внешними вендорскими API Работа с общими библиотеками proto в нескольких проектах Необходимо гарантировать корректную (зафиксированную) версию внешних API"},{"id":"cli/generator/generator::git-remote-git-repository-input::23","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) **Рекомендации:** В продакшене всегда фиксируйте версии (@v1.0.0, а не latest) Используйте семантические версии при наличии — проще сопровождать Предпочитайте публи","content":"Удалённый Git репозиторий (Remote Git Repository Input) **Рекомендации:** В продакшене всегда фиксируйте версии (@v1.0.0, а не latest) Используйте семантические версии при наличии — проще сопровождать Предпочитайте публичные теги вместо хеша коммита (лучше отслеживаемость)"},{"id":"cli/generator/generator::git-remote-git-repository-input::24","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input)","content":"Удалённый Git репозиторий (Remote Git Repository Input)"},{"id":"cli/generator/generator::git-remote-git-repository-input::25","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) Параметр root задаёт корень для разрешения импортов файлов из этого репозитория.","content":"Удалённый Git репозиторий (Remote Git Repository Input) Параметр root задаёт корень для разрешения импортов файлов из этого репозитория."},{"id":"cli/generator/generator::git-remote-git-repository-input::26","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) **Параметры:**","content":"Удалённый Git репозиторий (Remote Git Repository Input) **Параметры:**"},{"id":"cli/generator/generator::git-remote-git-repository-input::27","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) Параметр Тип Обязателен По умолчанию Описание ---------- ----- ------------ -------------- ---------- url string ✅ - URL Git репозитория с необязательной версией / ","content":"Удалённый Git репозиторий (Remote Git Repository Input) Параметр Тип Обязателен По умолчанию Описание ---------- ----- ------------ -------------- ---------- url string ✅ - URL Git репозитория с необязательной версией / тегом / коммитом sub_directory string ❌ \"\" Поддиректория внутри репозитория, где лежат proto root string ❌ \"\" Корневой путь для разрешения импортов"},{"id":"cli/generator/generator::git-remote-git-repository-input::28","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) **Варианты формата URL:**","content":"Удалённый Git репозиторий (Remote Git Repository Input) **Варианты формата URL:**"},{"id":"cli/generator/generator::git-remote-git-repository-input::29","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) EasyP поддерживает несколько форматов для ссылки на удалённые репозитории. Каждый подходит под разные требования по стабильности:","content":"Удалённый Git репозиторий (Remote Git Repository Input) EasyP поддерживает несколько форматов для ссылки на удалённые репозитории. Каждый подходит под разные требования по стабильности:"},{"id":"cli/generator/generator::git-remote-git-repository-input::30","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) **Tagged versions** — для продакшена, стабильные неизменяемые ссылки **Semantic versions** — читаемость и управление зависимостями **Commit hashes** — доступ к конк","content":"Удалённый Git репозиторий (Remote Git Repository Input) **Tagged versions** — для продакшена, стабильные неизменяемые ссылки **Semantic versions** — читаемость и управление зависимостями **Commit hashes** — доступ к конкретному коммиту, если нет тега **Latest** — только для разработки, непредсказуемо **Full HTTPS URLs** — приватные репозитории или нестандартный хостинг"},{"id":"cli/generator/generator::git-remote-git-repository-input::31","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) ```yaml Тег — стабильно для продакшена url: \"github.com/googleapis/googleapis@common-protos-1_3_1\"","content":"Удалённый Git репозиторий (Remote Git Repository Input) ```yaml Тег — стабильно для продакшена url: \"github.com/googleapis/googleapis@common-protos-1_3_1\""},{"id":"cli/generator/generator::git-remote-git-repository-input::32","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) Семантическая версия url: \"github.com/grpc-ecosystem/grpc-gateway@v2.19.1\"","content":"Удалённый Git репозиторий (Remote Git Repository Input) Семантическая версия url: \"github.com/grpc-ecosystem/grpc-gateway@v2.19.1\""},{"id":"cli/generator/generator::git-remote-git-repository-input::33","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) Хеш коммита — точечный фикс url: \"github.com/company/protos@abc123def456\"","content":"Удалённый Git репозиторий (Remote Git Repository Input) Хеш коммита — точечный фикс url: \"github.com/company/protos@abc123def456\""},{"id":"cli/generator/generator::git-remote-git-repository-input::34","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) Latest — только dev, НЕ для продакшена url: \"github.com/company/protos\"","content":"Удалённый Git репозиторий (Remote Git Repository Input) Latest — только dev, НЕ для продакшена url: \"github.com/company/protos\""},{"id":"cli/generator/generator::git-remote-git-repository-input::35","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) Полный HTTPS URL — приватный или кастомный Git url: \"https://github.com/company/private-protos.git\" ```","content":"Удалённый Git репозиторий (Remote Git Repository Input) Полный HTTPS URL — приватный или кастомный Git url: \"https://github.com/company/private-protos.git\" ```"},{"id":"cli/generator/generator::git-remote-git-repository-input::36","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) **Примеры:**","content":"Удалённый Git репозиторий (Remote Git Repository Input) **Примеры:**"},{"id":"cli/generator/generator::git-remote-git-repository-input::37","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input) Ниже паттерны использования удалённых источников в разных сценариях:","content":"Удалённый Git репозиторий (Remote Git Repository Input) Ниже паттерны использования удалённых источников в разных сценариях:"},{"id":"cli/generator/generator::git-remote-git-repository-input::38","title":"Генератор","section":"Удалённый Git репозиторий (Remote Git Repository Input)","path":"/docs/guide/cli/generator/generator#git-remote-git-repository-input","headings":["Удалённый Git репозиторий (Remote Git Repository Input)"],"excerpt":"Удалённый Git репозиторий (Remote Git Repository Input)","content":"Удалённый Git репозиторий (Remote Git Repository Input)"},{"id":"cli/generator/generator::top::39","title":"Генератор","section":"Конфигурация плагинов","path":"/docs/guide/cli/generator/generator","headings":["Конфигурация плагинов"],"excerpt":"Конфигурация плагинов Конфигурация плагинов определяет какие генераторы кода будут запущены и как они себя ведут. EasyP поддерживает любой плагин protoc, что делает его крайне гибким для разных языковых экосистем и сцена","content":"Конфигурация плагинов Конфигурация плагинов определяет какие генераторы кода будут запущены и как они себя ведут. EasyP поддерживает любой плагин protoc, что делает его крайне гибким для разных языковых экосистем и сценариев."},{"id":"cli/generator/generator::top::40","title":"Генератор","section":"Конфигурация плагинов","path":"/docs/guide/cli/generator/generator","headings":["Конфигурация плагинов"],"excerpt":"Конфигурация плагинов На верхнем уровне есть **четыре способа указать, как именно запускать плагин**:","content":"Конфигурация плагинов На верхнем уровне есть **четыре способа указать, как именно запускать плагин**:"},{"id":"cli/generator/generator::top::41","title":"Генератор","section":"Конфигурация плагинов","path":"/docs/guide/cli/generator/generator","headings":["Конфигурация плагинов"],"excerpt":"Конфигурация плагинов **name** – запуск плагина по имени из PATH или использование встроенного плагина. **path** – запуск плагина по абсолютному/относительному пути к исполняемому файлу. **remote** – удалённый плагин по ","content":"Конфигурация плагинов **name** – запуск плагина по имени из PATH или использование встроенного плагина. **path** – запуск плагина по абсолютному/относительному пути к исполняемому файлу. **remote** – удалённый плагин по URL (через remote‑executor EasyP). **command** – запуск плагина через произвольную команду (например, go run ...)."},{"id":"cli/generator/generator::top::42","title":"Генератор","section":"Конфигурация плагинов","path":"/docs/guide/cli/generator/generator","headings":["Конфигурация плагинов"],"excerpt":"Конфигурация плагинов Для каждого плагина должен быть указан **ровно один** из параметров name, path, remote или command.","content":"Конфигурация плагинов Для каждого плагина должен быть указан **ровно один** из параметров name, path, remote или command."},{"id":"cli/generator/generator::name::43","title":"Генератор","section":"Плагин по имени (name)","path":"/docs/guide/cli/generator/generator#name","headings":["Плагин по имени (name)"],"excerpt":"Плагин по имени (name) Локальный режим по имени — стандартный: плагины установлены в системе и запускаются напрямую через EasyP.","content":"Плагин по имени (name) Локальный режим по имени — стандартный: плагины установлены в системе и запускаются напрямую через EasyP."},{"id":"cli/generator/generator::name::44","title":"Генератор","section":"Плагин по имени (name)","path":"/docs/guide/cli/generator/generator#name","headings":["Плагин по имени (name)"],"excerpt":"Плагин по имени (name) **Когда использовать name:** Стандартные языки (Go, Python, TypeScript и т.д.) Есть контроль над окружением сборки Критична производительность (нет сетевых задержек) Хочется опираться на PATH или в","content":"Плагин по имени (name) **Когда использовать name:** Стандартные языки (Go, Python, TypeScript и т.д.) Есть контроль над окружением сборки Критична производительность (нет сетевых задержек) Хочется опираться на PATH или встроенные плагины"},{"id":"cli/generator/generator::name::45","title":"Генератор","section":"Плагин по имени (name)","path":"/docs/guide/cli/generator/generator#name","headings":["Плагин по имени (name)"],"excerpt":"Плагин по имени (name) **Требования к установке:** Плагины установлены и доступны в PATH (если не используются встроенные). Имена следуют шаблону protoc-gen-{name}. Установка через менеджеры пакетов (go install, npm inst","content":"Плагин по имени (name) **Требования к установке:** Плагины установлены и доступны в PATH (если не используются встроенные). Имена следуют шаблону protoc-gen-{name}. Установка через менеджеры пакетов (go install, npm install, pip install и т.п.)."},{"id":"cli/generator/generator::name::46","title":"Генератор","section":"Плагин по имени (name)","path":"/docs/guide/cli/generator/generator#name","headings":["Плагин по имени (name)"],"excerpt":"Плагин по имени (name) Параметр with_imports критичен при использовании зависимостей из пакетного менеджера: установите true, чтобы прототипы из секции deps попали в генерацию.","content":"Плагин по имени (name) Параметр with_imports критичен при использовании зависимостей из пакетного менеджера: установите true, чтобы прототипы из секции deps попали в генерацию."},{"id":"cli/generator/generator::path::47","title":"Генератор","section":"Плагин по пути (path)","path":"/docs/guide/cli/generator/generator#path","headings":["Плагин по пути (path)"],"excerpt":"Плагин по пути (path) Иногда нужно запускать плагин из конкретного бинарника, не добавляя его в PATH (например, бинарь в репозитории или в build‑директории). В этом случае можно указать явный путь:","content":"Плагин по пути (path) Иногда нужно запускать плагин из конкретного бинарника, не добавляя его в PATH (например, бинарь в репозитории или в build‑директории). В этом случае можно указать явный путь:"},{"id":"cli/generator/generator::path::48","title":"Генератор","section":"Плагин по пути (path)","path":"/docs/guide/cli/generator/generator#path","headings":["Плагин по пути (path)"],"excerpt":"Плагин по пути (path) **Когда использовать path:** Бинарники плагинов хранятся в репозитории (для воспроизводимых сборок). Используются несколько версий одного и того же плагина параллельно. Не хочется «загрязнять» глоба","content":"Плагин по пути (path) **Когда использовать path:** Бинарники плагинов хранятся в репозитории (для воспроизводимых сборок). Используются несколько версий одного и того же плагина параллельно. Не хочется «загрязнять» глобальный PATH."},{"id":"cli/generator/generator::remote::49","title":"Генератор","section":"Удалённый плагин (remote)","path":"/docs/guide/cli/generator/generator#remote","headings":["Удалённый плагин (remote)"],"excerpt":"Удалённый плагин (remote) Удалённые плагины выполняются по URL. EasyP отправляет на удалённую сторону CodeGeneratorRequest и получает обратно CodeGeneratorResponse.","content":"Удалённый плагин (remote) Удалённые плагины выполняются по URL. EasyP отправляет на удалённую сторону CodeGeneratorRequest и получает обратно CodeGeneratorResponse."},{"id":"cli/generator/generator::remote::50","title":"Генератор","section":"Удалённый плагин (remote)","path":"/docs/guide/cli/generator/generator#remote","headings":["Удалённый плагин (remote)"],"excerpt":"Удалённый плагин (remote) Ниже приведён реальный пример использования EasyP API Service как удалённого исполнителя плагинов (тот же формат используется в разделе про API Service):","content":"Удалённый плагин (remote) Ниже приведён реальный пример использования EasyP API Service как удалённого исполнителя плагинов (тот же формат используется в разделе про API Service):"},{"id":"cli/generator/generator::remote::51","title":"Генератор","section":"Удалённый плагин (remote)","path":"/docs/guide/cli/generator/generator#remote","headings":["Удалённый плагин (remote)"],"excerpt":"Удалённый плагин (remote) ```yaml generate: plugins: # Удалённое выполнение плагинов через EasyP API Service - remote: api.easyp.tech/protobuf/go:v1.36.10 out: . opts: paths: source_relative","content":"Удалённый плагин (remote) ```yaml generate: plugins: # Удалённое выполнение плагинов через EasyP API Service - remote: api.easyp.tech/protobuf/go:v1.36.10 out: . opts: paths: source_relative"},{"id":"cli/generator/generator::remote::52","title":"Генератор","section":"Удалённый плагин (remote)","path":"/docs/guide/cli/generator/generator#remote","headings":["Удалённый плагин (remote)"],"excerpt":"Удалённый плагин (remote) remote: api.easyp.tech/grpc/go:v1.5.1 out: . opts: paths: source_relative ```","content":"Удалённый плагин (remote) remote: api.easyp.tech/grpc/go:v1.5.1 out: . opts: paths: source_relative ```"},{"id":"cli/generator/generator::remote::53","title":"Генератор","section":"Удалённый плагин (remote)","path":"/docs/guide/cli/generator/generator#remote","headings":["Удалённый плагин (remote)"],"excerpt":"Удалённый плагин (remote) **Типичные сценарии для remote:** Централизованный сервис плагинов внутри компании (например, EasyP API Service). Запуск тяжёлых плагинов на выделенных машинах вместо CI‑агентов. Совместное испо","content":"Удалённый плагин (remote) **Типичные сценарии для remote:** Централизованный сервис плагинов внутри компании (например, EasyP API Service). Запуск тяжёлых плагинов на выделенных машинах вместо CI‑агентов. Совместное использование одной реализации плагина разными командами."},{"id":"cli/generator/generator::command::54","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) Вы можете указать плагин как массив команд для выполнения. Это полезно для запуска плагинов через go run или любые другие инструменты без предварительной установки бинарника пла","content":"Выполнение плагина через команду (command) Вы можете указать плагин как массив команд для выполнения. Это полезно для запуска плагинов через go run или любые другие инструменты без предварительной установки бинарника плагина:"},{"id":"cli/generator/generator::command::55","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command)","content":"Выполнение плагина через команду (command)"},{"id":"cli/generator/generator::command::56","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) В этом режиме EasyP: **запускает указанную команду** как дочерний процесс; **пишет CodeGeneratorRequest в stdin** процесса; **читает CodeGeneratorResponse из stdout**, как и для","content":"Выполнение плагина через команду (command) В этом режиме EasyP: **запускает указанную команду** как дочерний процесс; **пишет CodeGeneratorRequest в stdin** процесса; **читает CodeGeneratorResponse из stdout**, как и для обычных плагинов protoc."},{"id":"cli/generator/generator::command::57","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) **Приоритет источников плагина:** command — выполнение через указанную команду (наивысший приоритет) remote — удалённый плагин через URL name — локальный плагин из PATH или встр","content":"Выполнение плагина через команду (command) **Приоритет источников плагина:** command — выполнение через указанную команду (наивысший приоритет) remote — удалённый плагин через URL name — локальный плагин из PATH или встроенный плагин path — путь к исполняемому файлу плагина"},{"id":"cli/generator/generator::command::58","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) **Параметры (источники и общие опции плагина):**","content":"Выполнение плагина через команду (command) **Параметры (источники и общие опции плагина):**"},{"id":"cli/generator/generator::command::59","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) Параметр Тип Обязателен По умолчанию Описание ---------- ----- ------------ -------------- ---------- name string ❌ - Имя / идентификатор плагина (например, go, go-grpc, grpc-ga","content":"Выполнение плагина через команду (command) Параметр Тип Обязателен По умолчанию Описание ---------- ----- ------------ -------------- ---------- name string ❌ - Имя / идентификатор плагина (например, go, go-grpc, grpc-gateway) command []string ❌ - Команда для выполнения плагина (например, [\"go\", \"run\", \"package\"]) remote string ❌ - URL удалённого плагина path string ❌ - Путь к исполняемому файлу плагина out string ❌ resolved generate root Директория для сгенерированных файлов opts mapstring ❌ {} Специфичные опции плагина; значения-списки передаются как повторяющиеся key=value with_imports bool ❌ false Включать proto из зависимостей"},{"id":"cli/generator/generator::command::60","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) **Примечание:** Для каждого плагина должен быть указан ровно один источник (name, command, remote или path). Если opts.outputServices задан как [\"grpc-js\", \"generic-definitions\"","content":"Выполнение плагина через команду (command) **Примечание:** Для каждого плагина должен быть указан ровно один источник (name, command, remote или path). Если opts.outputServices задан как [\"grpc-js\", \"generic-definitions\"], EasyP передаст outputServices=grpc-js,outputServices=generic-definitions."},{"id":"cli/generator/generator::command::61","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) **Примеры использования источника command:**","content":"Выполнение плагина через команду (command) **Примеры использования источника command:**"},{"id":"cli/generator/generator::command::62","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) ```yaml generate: inputs: - directory: \"proto\"","content":"Выполнение плагина через команду (command) ```yaml generate: inputs: - directory: \"proto\""},{"id":"cli/generator/generator::command::63","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) plugins: # 1) gRPC-Gateway через go run (без предварительной установки бинарника) - command: [\"go\", \"run\", \"github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.","content":"Выполнение плагина через команду (command) plugins: # 1) gRPC-Gateway через go run (без предварительной установки бинарника) - command: [\"go\", \"run\", \"github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.25.1\"] out: ./gen/go opts: paths: source_relative generate_unbound_methods: true"},{"id":"cli/generator/generator::command::64","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) 2) protoc-gen-validate через go run - command: [\"go\", \"run\", \"github.com/bufbuild/protoc-gen-validate@v0.10.1\"] out: ./gen/go opts: paths: source_relative lang: go","content":"Выполнение плагина через команду (command) 2) protoc-gen-validate через go run - command: [\"go\", \"run\", \"github.com/bufbuild/protoc-gen-validate@v0.10.1\"] out: ./gen/go opts: paths: source_relative lang: go"},{"id":"cli/generator/generator::command::65","title":"Генератор","section":"Выполнение плагина через команду (command)","path":"/docs/guide/cli/generator/generator#command","headings":["Выполнение плагина через команду (command)"],"excerpt":"Выполнение плагина через команду (command) 3) Произвольный кастомный скрипт-обёртка - command: [\"bash\", \"./scripts/custom-protoc-plugin.sh\"] out: ./gen/custom opts: foo: bar ```","content":"Выполнение плагина через команду (command) 3) Произвольный кастомный скрипт-обёртка - command: [\"bash\", \"./scripts/custom-protoc-plugin.sh\"] out: ./gen/custom opts: foo: bar ```"},{"id":"cli/generator/generator::builtin-plugins::66","title":"Генератор","section":"Встроенные плагины (Builtin Plugins)","path":"/docs/guide/cli/generator/generator#builtin-plugins","headings":["Встроенные плагины (Builtin Plugins)"],"excerpt":"Встроенные плагины (Builtin Plugins) EasyP поддерживает встроенные плагины для базовых языков protobuf и gRPC. Эти плагины встроены в бинарник как WASM-модули и не требуют установки внешних зависимостей.","content":"Встроенные плагины (Builtin Plugins) EasyP поддерживает встроенные плагины для базовых языков protobuf и gRPC. Эти плагины встроены в бинарник как WASM-модули и не требуют установки внешних зависимостей."},{"id":"cli/generator/generator::builtin-plugins::67","title":"Генератор","section":"Встроенные плагины (Builtin Plugins)","path":"/docs/guide/cli/generator/generator#builtin-plugins","headings":["Встроенные плагины (Builtin Plugins)"],"excerpt":"Встроенные плагины (Builtin Plugins) **Преимущества встроенных плагинов:** **Портативность**: Один бинарник со всеми необходимыми плагинами **Удобство**: Не требуется установка внешних зависимостей **Стабильность**: Верс","content":"Встроенные плагины (Builtin Plugins) **Преимущества встроенных плагинов:** **Портативность**: Один бинарник со всеми необходимыми плагинами **Удобство**: Не требуется установка внешних зависимостей **Стабильность**: Версии плагинов зафиксированы в бинарнике **Изоляция**: Не зависит от системных установок плагинов"},{"id":"cli/generator/generator::builtin-plugins::68","title":"Генератор","section":"Встроенные плагины (Builtin Plugins)","path":"/docs/guide/cli/generator/generator#builtin-plugins","headings":["Встроенные плагины (Builtin Plugins)"],"excerpt":"Встроенные плагины (Builtin Plugins) **Поддерживаемые встроенные плагины:**","content":"Встроенные плагины (Builtin Plugins) **Поддерживаемые встроенные плагины:**"},{"id":"cli/generator/generator::protobuf::69","title":"Генератор","section":"Protobuf базовые плагины","path":"/docs/guide/cli/generator/generator#protobuf","headings":["Protobuf базовые плагины"],"excerpt":"Protobuf базовые плагины Следующие плагины встроены для генерации базового protobuf кода:","content":"Protobuf базовые плагины Следующие плагины встроены для генерации базового protobuf кода:"},{"id":"cli/generator/generator::protobuf::70","title":"Генератор","section":"Protobuf базовые плагины","path":"/docs/guide/cli/generator/generator#protobuf","headings":["Protobuf базовые плагины"],"excerpt":"Protobuf базовые плагины Имя плагина Описание Соответствующий protoc плагин ------------- ---------- ------------------------------- cpp Генерация C++ кода из proto файлов protoc-gen-cpp csharp Генерация C# кода из proto","content":"Protobuf базовые плагины Имя плагина Описание Соответствующий protoc плагин ------------- ---------- ------------------------------- cpp Генерация C++ кода из proto файлов protoc-gen-cpp csharp Генерация C# кода из proto файлов protoc-gen-csharp java Генерация Java кода из proto файлов protoc-gen-java kotlin Генерация Kotlin кода из proto файлов protoc-gen-kotlin objc Генерация Objective-C кода из proto файлов protoc-gen-objc php Генерация PHP кода из proto файлов protoc-gen-php python Генерация Python кода из proto файлов protoc-gen-python ruby Генерация Ruby кода из proto файлов protoc-gen-ruby"},{"id":"cli/generator/generator::grpc::71","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины Следующие плагины встроены для генерации gRPC кода:","content":"gRPC плагины Следующие плагины встроены для генерации gRPC кода:"},{"id":"cli/generator/generator::grpc::72","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины Имя плагина Описание Соответствующий protoc плагин ------------- ---------- ------------------------------- grpc_cpp Генерация gRPC кода для C++ grpc_cpp_plugin grpc_csharp Генерация gRPC кода для C# grpc_cs","content":"gRPC плагины Имя плагина Описание Соответствующий protoc плагин ------------- ---------- ------------------------------- grpc_cpp Генерация gRPC кода для C++ grpc_cpp_plugin grpc_csharp Генерация gRPC кода для C# grpc_csharp_plugin grpc_java Генерация gRPC кода для Java grpc_java_plugin grpc_node Генерация gRPC кода для Node.js grpc_node_plugin grpc_objc Генерация gRPC кода для Objective-C grpc_objective_c_plugin grpc_php Генерация gRPC кода для PHP grpc_php_plugin grpc_python Генерация gRPC кода для Python grpc_python_plugin grpc_ruby Генерация gRPC кода для Ruby grpc_ruby_plugin"},{"id":"cli/generator/generator::grpc::73","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины **Логика выбора плагина:**","content":"gRPC плагины **Логика выбора плагина:**"},{"id":"cli/generator/generator::grpc::74","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины EasyP использует следующий приоритет при выборе executor'а для плагина:","content":"gRPC плагины EasyP использует следующий приоритет при выборе executor'а для плагина:"},{"id":"cli/generator/generator::grpc::75","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины **Удалённый плагин** (если указан url) — всегда имеет наивысший приоритет **Встроенный плагин** (если плагин встроен и не найден в PATH) — используется автоматически **Локальный плагин** (из PATH) — использу","content":"gRPC плагины **Удалённый плагин** (если указан url) — всегда имеет наивысший приоритет **Встроенный плагин** (если плагин встроен и не найден в PATH) — используется автоматически **Локальный плагин** (из PATH) — используется по умолчанию для обратной совместимости"},{"id":"cli/generator/generator::grpc::76","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины **Пример использования:**","content":"gRPC плагины **Пример использования:**"},{"id":"cli/generator/generator::grpc::77","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины Встроенные плагины включены в бинарник EasyP:","content":"gRPC плагины Встроенные плагины включены в бинарник EasyP:"},{"id":"cli/generator/generator::grpc::78","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины ```bash Сборка go build ./cmd/easyp","content":"gRPC плагины ```bash Сборка go build ./cmd/easyp"},{"id":"cli/generator/generator::grpc::79","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины Установка go install github.com/easyp-tech/easyp/cmd/easyp@latest ```","content":"gRPC плагины Установка go install github.com/easyp-tech/easyp/cmd/easyp@latest ```"},{"id":"cli/generator/generator::grpc::80","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины **Обратная совместимость:**","content":"gRPC плагины **Обратная совместимость:**"},{"id":"cli/generator/generator::grpc::81","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины Встроенные плагины полностью совместимы с существующими конфигурациями. Если плагин найден в PATH, он будет использован вместо встроенного. Это гарантирует, что:","content":"gRPC плагины Встроенные плагины полностью совместимы с существующими конфигурациями. Если плагин найден в PATH, он будет использован вместо встроенного. Это гарантирует, что:"},{"id":"cli/generator/generator::grpc::82","title":"Генератор","section":"gRPC плагины","path":"/docs/guide/cli/generator/generator#grpc","headings":["gRPC плагины"],"excerpt":"gRPC плагины Существующие конфигурации продолжают работать без изменений Можно переопределить встроенный плагин, установив его в системе Приоритет отдаётся локальным установкам для гибкости","content":"gRPC плагины Существующие конфигурации продолжают работать без изменений Можно переопределить встроенный плагин, установив его в системе Приоритет отдаётся локальным установкам для гибкости"},{"id":"cli/generator/generator::top::83","title":"Генератор","section":"Справочник опций плагинов","path":"/docs/guide/cli/generator/generator","headings":["Справочник опций плагинов"],"excerpt":"Справочник опций плагинов Ниже перечислены наиболее часто используемые плагины и их настройки. Каждый плагин имеет параметры, влияющие на результат генерации — понимание этих опций важно для получения нужного вывода.","content":"Справочник опций плагинов Ниже перечислены наиболее часто используемые плагины и их настройки. Каждый плагин имеет параметры, влияющие на результат генерации — понимание этих опций важно для получения нужного вывода."},{"id":"cli/generator/generator::go-plugins::84","title":"Генератор","section":"Go Plugins","path":"/docs/guide/cli/generator/generator#go-plugins","headings":["Go Plugins"],"excerpt":"Go Plugins Плагины для Go — самые зрелые и распространённые. Опция paths управляет тем, как формируются пути импортов; остальные опции дают тонкую настройку вывода.","content":"Go Plugins Плагины для Go — самые зрелые и распространённые. Опция paths управляет тем, как формируются пути импортов; остальные опции дают тонкую настройку вывода."},{"id":"cli/generator/generator::grpc-gateway-plugins::85","title":"Генератор","section":"gRPC-Gateway Plugins","path":"/docs/guide/cli/generator/generator#grpc-gateway-plugins","headings":["gRPC-Gateway Plugins"],"excerpt":"gRPC-Gateway Plugins Позволяют экспонировать gRPC сервисы как REST API и генерировать OpenAPI. Критично для HTTP/JSON поверх gRPC.","content":"gRPC-Gateway Plugins Позволяют экспонировать gRPC сервисы как REST API и генерировать OpenAPI. Критично для HTTP/JSON поверх gRPC."},{"id":"cli/generator/generator::validation-plugins::86","title":"Генератор","section":"Validation Plugins","path":"/docs/guide/cli/generator/generator#validation-plugins","headings":["Validation Plugins"],"excerpt":"Validation Plugins Генерируют код валидации на основе правил в proto, устраняя ручную проверку.","content":"Validation Plugins Генерируют код валидации на основе правил в proto, устраняя ручную проверку."},{"id":"cli/generator/generator::typescriptjavascript-plugins::87","title":"Генератор","section":"TypeScript/JavaScript Plugins","path":"/docs/guide/cli/generator/generator#typescriptjavascript-plugins","headings":["TypeScript/JavaScript Plugins"],"excerpt":"TypeScript/JavaScript Plugins TypeScript плагины нужны фронтенду: типобезопасные интерфейсы и клиенты.","content":"TypeScript/JavaScript Plugins TypeScript плагины нужны фронтенду: типобезопасные интерфейсы и клиенты."},{"id":"cli/generator/generator::managed-mode::88","title":"Генератор","section":"Managed Mode","path":"/docs/guide/cli/generator/generator#managed-mode","headings":["Managed Mode"],"excerpt":"Managed Mode Managed mode автоматически устанавливает file и field опции в protobuf дескрипторах во время генерации кода без изменения исходных .proto файлов. Эта функция совместима с managed mode в buf и обеспечивает ед","content":"Managed Mode Managed mode автоматически устанавливает file и field опции в protobuf дескрипторах во время генерации кода без изменения исходных .proto файлов. Эта функция совместима с managed mode в buf и обеспечивает единообразный способ управления языково-специфичными опциями в вашей кодовой базе."},{"id":"cli/generator/generator::managed-mode::89","title":"Генератор","section":"Managed Mode","path":"/docs/guide/cli/generator/generator#managed-mode","headings":["Managed Mode"],"excerpt":"Managed Mode **Ключевые преимущества:** **Без изменений proto файлов**: Опции применяются во время генерации, proto файлы остаются чистыми **Согласованные значения по умолчанию**: Автоматическое применение языковых согла","content":"Managed Mode **Ключевые преимущества:** **Без изменений proto файлов**: Опции применяются во время генерации, proto файлы остаются чистыми **Согласованные значения по умолчанию**: Автоматическое применение языковых соглашений об именовании **Централизованная конфигурация**: Управление всеми опциями в одном месте (easyp.yaml) **Правила для модулей**: Применение разных опций к разным модулям или путям **Совместимость с buf**: Работает так же, как managed mode в buf"},{"id":"cli/generator/generator::top::90","title":"Генератор","section":"Как это работает","path":"/docs/guide/cli/generator/generator","headings":["Как это работает"],"excerpt":"Как это работает Когда managed mode включён, EasyP автоматически применяет file и field опции к protobuf дескрипторам перед генерацией кода. Это происходит в памяти, поэтому исходные .proto файлы остаются неизменными.","content":"Как это работает Когда managed mode включён, EasyP автоматически применяет file и field опции к protobuf дескрипторам перед генерацией кода. Это происходит в памяти, поэтому исходные .proto файлы остаются неизменными."},{"id":"cli/generator/generator::top::91","title":"Генератор","section":"Как это работает","path":"/docs/guide/cli/generator/generator","headings":["Как это работает"],"excerpt":"Как это работает **Значения по умолчанию** применяются для определённых опций на основе языковых соглашений: Java: java_package_prefix по умолчанию \"com\", java_multiple_files по умолчанию true C#: csharp_namespace по умо","content":"Как это работает **Значения по умолчанию** применяются для определённых опций на основе языковых соглашений: Java: java_package_prefix по умолчанию \"com\", java_multiple_files по умолчанию true C#: csharp_namespace по умолчанию PascalCase имени пакета Ruby: ruby_package по умолчанию PascalCase с разделителем :: PHP: php_namespace по умолчанию PascalCase с разделителем \\ Objective-C: objc_class_prefix по умолчанию первые буквы частей пакета C++: cc_enable_arenas по умолчанию true"},{"id":"cli/generator/generator::top::92","title":"Генератор","section":"Как это работает","path":"/docs/guide/cli/generator/generator","headings":["Как это работает"],"excerpt":"Как это работает **Overrides** позволяют установить конкретные значения для опций с поддержкой фильтрации по модулю, protobuf package, пути или полю. Если не указаны module, package и path, override применяется ко всем ф","content":"Как это работает **Overrides** позволяют установить конкретные значения для опций с поддержкой фильтрации по модулю, protobuf package, пути или полю. Если не указаны module, package и path, override применяется ко всем файлам в запросе генерации, включая зависимости и git_repo inputs."},{"id":"cli/generator/generator::top::93","title":"Генератор","section":"Как это работает","path":"/docs/guide/cli/generator/generator","headings":["Как это работает"],"excerpt":"Как это работает **Disables** позволяют предотвратить изменение managed mode определённых опций или файлов. Это рекомендуемый способ исключить внешние зависимости, у которых свои опции уже заданы.","content":"Как это работает **Disables** позволяют предотвратить изменение managed mode определённых опций или файлов. Это рекомендуемый способ исключить внешние зависимости, у которых свои опции уже заданы."},{"id":"cli/generator/generator::top::94","title":"Генератор","section":"Конфигурация","path":"/docs/guide/cli/generator/generator","headings":["Конфигурация"],"excerpt":"Конфигурация ```yaml generate: managed: enabled: true disable: # Отключить managed mode для конкретного модуля - module: github.com/googleapis/googleapis # Отключить конкретную опцию глобально - file_option: java_package","content":"Конфигурация ```yaml generate: managed: enabled: true disable: # Отключить managed mode для конкретного модуля - module: github.com/googleapis/googleapis # Отключить конкретную опцию глобально - file_option: java_package_prefix"},{"id":"cli/generator/generator::top::95","title":"Генератор","section":"Конфигурация","path":"/docs/guide/cli/generator/generator","headings":["Конфигурация"],"excerpt":"Конфигурация Отключить для конкретного protobuf package - package: acme.weather.v1 file_option: java_package # Отключить для конкретного пути - path: legacy/ file_option: go_package # Отключить field опцию для конкретног","content":"Конфигурация Отключить для конкретного protobuf package - package: acme.weather.v1 file_option: java_package # Отключить для конкретного пути - path: legacy/ file_option: go_package # Отключить field опцию для конкретного поля - field_option: jstype field: com.example.User.id override: # Переопределить go_package_prefix для всех файлов - file_option: go_package_prefix value: github.com/mycompany/myproject/gen/go # Переопределить для конкретного модуля - file_option: java_package_prefix value: com.mycompany module: github.com/mycompany/internal-protos"},{"id":"cli/generator/generator::top::96","title":"Генератор","section":"Конфигурация","path":"/docs/guide/cli/generator/generator","headings":["Конфигурация"],"excerpt":"Конфигурация Переопределить для конкретного protobuf package - file_option: go_package_prefix value: github.com/mycompany/myproject/gen/go package: acme.weather.v1 # Переопределить для конкретного пути - file_option: csh","content":"Конфигурация Переопределить для конкретного protobuf package - file_option: go_package_prefix value: github.com/mycompany/myproject/gen/go package: acme.weather.v1 # Переопределить для конкретного пути - file_option: csharp_namespace_prefix value: MyCompany path: api/v1/ # Переопределить для нескольких файлов с одинаковым значением используя префиксный путь # Это совпадет и с internal/cms/bmi.proto, и с internal/cms/bmi_service.proto - file_option: go_package value: spec/cms/bmi path: \"internal/cms/bmi\" # Переопределить field опцию для конкретного пути - field_option: jstype value: JS_STRING path: api/v1/ # Переопределить для конкретного поля - field_option: jstype value: JS_NUMBER field: com.example.User.big_id ```"},{"id":"cli/generator/generator::file-options::97","title":"Генератор","section":"Поддерживаемые File Options","path":"/docs/guide/cli/generator/generator#file-options","headings":["Поддерживаемые File Options"],"excerpt":"Поддерживаемые File Options Опция Описание Есть значение по умолчанию? ------- ---------- ---------------------------- go_package Go import path ❌ go_package_prefix Префикс для Go import paths ❌ java_package Имя Java пак","content":"Поддерживаемые File Options Опция Описание Есть значение по умолчанию? ------- ---------- ---------------------------- go_package Go import path ❌ go_package_prefix Префикс для Go import paths ❌ java_package Имя Java пакета ❌ java_package_prefix Префикс для Java пакетов ✅ (\"com\") java_package_suffix Суффикс для Java пакетов ❌ java_multiple_files Генерировать несколько Java файлов ✅ (true) java_outer_classname Имя внешнего класса ✅ (PascalCase + \"Proto\") java_string_check_utf8 UTF-8 валидация ❌ csharp_namespace C# namespace ✅ (PascalCase) csharp_namespace_prefix Префикс для C# namespaces ❌ ruby_package Имя Ruby модуля ✅ (PascalCase с ::) ruby_package_suffix Суффикс для Ruby пакетов ❌ php_namespace PHP namespace ✅ (PascalCase с \\) php_metadata_namespace PHP metadata namespace ❌ php_metadata_namespace_suffix Суффикс для PHP metadata ❌ objc_class_prefix Objective-C префикс класса ✅ (Первые буквы) swift_prefix Swift префикс ❌ optimize_for Оптимизация генерации кода ❌ cc_enable_arenas C++ arena аллокация ✅ (true)"},{"id":"cli/generator/generator::field-options::98","title":"Генератор","section":"Поддерживаемые Field Options","path":"/docs/guide/cli/generator/generator#field-options","headings":["Поддерживаемые Field Options"],"excerpt":"Поддерживаемые Field Options Опция Описание Применяется к ------- ---------- --------------- jstype JavaScript тип для 64-битных целых чисел int64, uint64, sint64, fixed64, sfixed64","content":"Поддерживаемые Field Options Опция Описание Применяется к ------- ---------- --------------- jstype JavaScript тип для 64-битных целых чисел int64, uint64, sint64, fixed64, sfixed64"},{"id":"cli/generator/generator::top::99","title":"Генератор","section":"Базовая настройка со значениями по умолчанию","path":"/docs/guide/cli/generator/generator","headings":["Базовая настройка со значениями по умолчанию"],"excerpt":"Базовая настройка со значениями по умолчанию Включите managed mode для получения автоматических значений по умолчанию для всех поддерживаемых языков:","content":"Базовая настройка со значениями по умолчанию Включите managed mode для получения автоматических значений по умолчанию для всех поддерживаемых языков:"},{"id":"cli/generator/generator::top::100","title":"Генератор","section":"Базовая настройка со значениями по умолчанию","path":"/docs/guide/cli/generator/generator","headings":["Базовая настройка со значениями по умолчанию"],"excerpt":"Базовая настройка со значениями по умолчанию","content":"Базовая настройка со значениями по умолчанию"},{"id":"cli/generator/generator::top::101","title":"Генератор","section":"Базовая настройка со значениями по умолчанию","path":"/docs/guide/cli/generator/generator","headings":["Базовая настройка со значениями по умолчанию"],"excerpt":"Базовая настройка со значениями по умолчанию Это автоматически установит: java_package в com. для всех файлов java_multiple_files в true csharp_namespace в PascalCase имени пакета ruby_package в PascalCase с разделителем","content":"Базовая настройка со значениями по умолчанию Это автоматически установит: java_package в com. для всех файлов java_multiple_files в true csharp_namespace в PascalCase имени пакета ruby_package в PascalCase с разделителем :: И многое другое..."},{"id":"cli/generator/generator::go::102","title":"Генератор","section":"Кастомный префикс Go пакета","path":"/docs/guide/cli/generator/generator#go","headings":["Кастомный префикс Go пакета"],"excerpt":"Кастомный префикс Go пакета Переопределите префикс Go пакета для вашего проекта:","content":"Кастомный префикс Go пакета Переопределите префикс Go пакета для вашего проекта:"},{"id":"cli/generator/generator::go::103","title":"Генератор","section":"Кастомный префикс Go пакета","path":"/docs/guide/cli/generator/generator#go","headings":["Кастомный префикс Go пакета"],"excerpt":"Кастомный префикс Go пакета Это установит go_package в github.com/mycompany/myproject/gen/go/ для всех файлов.","content":"Кастомный префикс Go пакета Это установит go_package в github.com/mycompany/myproject/gen/go/ для всех файлов."},{"id":"cli/generator/generator::go::104","title":"Генератор","section":"Динамические пути Go пакетов с маркерами","path":"/docs/guide/cli/generator/generator#go","headings":["Динамические пути Go пакетов с маркерами"],"excerpt":"Динамические пути Go пакетов с маркерами Для более сложной генерации путей можно использовать маркеры в значениях go_package_prefix или go_package:","content":"Динамические пути Go пакетов с маркерами Для более сложной генерации путей можно использовать маркеры в значениях go_package_prefix или go_package:"},{"id":"cli/generator/generator::go::105","title":"Генератор","section":"Динамические пути Go пакетов с маркерами","path":"/docs/guide/cli/generator/generator#go","headings":["Динамические пути Go пакетов с маркерами"],"excerpt":"Динамические пути Go пакетов с маркерами","content":"Динамические пути Go пакетов с маркерами"},{"id":"cli/generator/generator::go::106","title":"Генератор","section":"Динамические пути Go пакетов с маркерами","path":"/docs/guide/cli/generator/generator#go","headings":["Динамические пути Go пакетов с маркерами"],"excerpt":"Динамические пути Go пакетов с маркерами **Доступные маркеры:** {{file_path}} - Полный путь файла без расширения .proto - Пример: internal/cms/as.proto → internal/cms/as {{file_dir}} - Только путь директории, без имени ф","content":"Динамические пути Go пакетов с маркерами **Доступные маркеры:** {{file_path}} - Полный путь файла без расширения .proto - Пример: internal/cms/as.proto → internal/cms/as {{file_dir}} - Только путь директории, без имени файла - Пример: internal/cms/as.proto → internal/cms {{file_dir_without:prefix/}} - Путь директории с удалением префикса и базового имени файла без суффиксов _service/_grpc - Пример: {{file_dir_without:internal/}} для internal/cms/as_service.proto → cms/as {{file_path_without:prefix/}} - Полный путь файла с удалением префикса - Пример: {{file_path_without:internal/}} для internal/cms/as.proto → cms/as"},{"id":"cli/generator/generator::top::107","title":"Генератор","section":"Переопределения для конкретных модулей","path":"/docs/guide/cli/generator/generator","headings":["Переопределения для конкретных модулей"],"excerpt":"Переопределения для конкретных модулей Примените разные опции к разным модулям:","content":"Переопределения для конкретных модулей Примените разные опции к разным модулям:"},{"id":"cli/generator/generator::top::108","title":"Генератор","section":"Переопределения для конкретных модулей","path":"/docs/guide/cli/generator/generator","headings":["Переопределения для конкретных модулей"],"excerpt":"Переопределения для конкретных модулей","content":"Переопределения для конкретных модулей"},{"id":"cli/generator/generator::top::109","title":"Генератор","section":"Переопределения для конкретных модулей","path":"/docs/guide/cli/generator/generator","headings":["Переопределения для конкретных модулей"],"excerpt":"Переопределения для конкретных модулей module должен точно совпадать с источником модуля в EasyP: это значение из deps или git_repo.url до @version (например, github.com/mycompany/internal-protos или https://github.com/m","content":"Переопределения для конкретных модулей module должен точно совпадать с источником модуля в EasyP: это значение из deps или git_repo.url до @version (например, github.com/mycompany/internal-protos или https://github.com/mycompany/internal-protos). Это не Go module path из go.mod."},{"id":"cli/generator/generator::top::110","title":"Генератор","section":"Переопределения для конкретных модулей","path":"/docs/guide/cli/generator/generator","headings":["Переопределения для конкретных модулей"],"excerpt":"Переопределения для конкретных модулей package должен точно совпадать со значением package в .proto файле, например acme.weather.v1.","content":"Переопределения для конкретных модулей package должен точно совпадать со значением package в .proto файле, например acme.weather.v1."},{"id":"cli/generator/generator::protobuf-package::111","title":"Генератор","section":"Переопределения для конкретного protobuf package","path":"/docs/guide/cli/generator/generator#protobuf-package","headings":["Переопределения для конкретного protobuf package"],"excerpt":"Переопределения для конкретного protobuf package Примените отдельные опции к файлам из конкретного protobuf package:","content":"Переопределения для конкретного protobuf package Примените отдельные опции к файлам из конкретного protobuf package:"},{"id":"cli/generator/generator::protobuf-package::112","title":"Генератор","section":"Переопределения для конкретного protobuf package","path":"/docs/guide/cli/generator/generator#protobuf-package","headings":["Переопределения для конкретного protobuf package"],"excerpt":"Переопределения для конкретного protobuf package","content":"Переопределения для конкретного protobuf package"},{"id":"cli/generator/generator::top::113","title":"Генератор","section":"Отключение для внешних зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Отключение для внешних зависимостей"],"excerpt":"Отключение для внешних зависимостей Отключите managed mode для внешних зависимостей, у которых уже установлены опции:","content":"Отключение для внешних зависимостей Отключите managed mode для внешних зависимостей, у которых уже установлены опции:"},{"id":"cli/generator/generator::top::114","title":"Генератор","section":"Отключение для внешних зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Отключение для внешних зависимостей"],"excerpt":"Отключение для внешних зависимостей","content":"Отключение для внешних зависимостей"},{"id":"cli/generator/generator::javascript::115","title":"Генератор","section":"Типобезопасность JavaScript","path":"/docs/guide/cli/generator/generator#javascript","headings":["Типобезопасность JavaScript"],"excerpt":"Типобезопасность JavaScript Установите jstype в JS_STRING для всех 64-битных целочисленных полей, чтобы предотвратить потерю точности в JavaScript:","content":"Типобезопасность JavaScript Установите jstype в JS_STRING для всех 64-битных целочисленных полей, чтобы предотвратить потерю точности в JavaScript:"},{"id":"cli/generator/generator::top::116","title":"Генератор","section":"Совпадение путей","path":"/docs/guide/cli/generator/generator","headings":["Совпадение путей"],"excerpt":"Совпадение путей Совпадение путей в managed mode использует префиксное совпадение (как в buf):","content":"Совпадение путей Совпадение путей в managed mode использует префиксное совпадение (как в buf):"},{"id":"cli/generator/generator::top::117","title":"Генератор","section":"Совпадение путей","path":"/docs/guide/cli/generator/generator","headings":["Совпадение путей"],"excerpt":"Совпадение путей **Путь директории** (заканчивается на /): Совпадает со всеми файлами в этой директории и поддиректориях - Пример: path: \"internal/cms/\" совпадает с internal/cms/as.proto, internal/cms/node.proto, interna","content":"Совпадение путей **Путь директории** (заканчивается на /): Совпадает со всеми файлами в этой директории и поддиректориях - Пример: path: \"internal/cms/\" совпадает с internal/cms/as.proto, internal/cms/node.proto, internal/cms/v1/service.proto **Точный путь файла** (заканчивается на .proto): Совпадает только с этим конкретным файлом - Пример: path: \"internal/cms/as.proto\" совпадает только с internal/cms/as.proto **Префиксный путь** (без завершающего / или .proto): Использует префиксное совпадение (не директориально-осознанное) - Пример: path: \"internal/cms\" совпадает с internal/cms/as.proto, но также с internal/cmsv2/file.proto - **Совет**: Используйте префиксные пути для группировки нескольких файлов с одинаковым значением. Например, path: \"internal/cms/bmi\" совпадает и с internal/cms/bmi.proto, и с internal/cms/bmi_service.proto, что позволяет установить одно и то же значение go_package для обоих файлов одним правилом."},{"id":"cli/generator/generator::top::118","title":"Генератор","section":"Приоритет правил","path":"/docs/guide/cli/generator/generator","headings":["Приоритет правил"],"excerpt":"Приоритет правил Когда несколько правил соответствуют одному файлу или полю, применяется следующий приоритет:","content":"Приоритет правил Когда несколько правил соответствуют одному файлу или полю, применяется следующий приоритет:"},{"id":"cli/generator/generator::top::119","title":"Генератор","section":"Приоритет правил","path":"/docs/guide/cli/generator/generator","headings":["Приоритет правил"],"excerpt":"Приоритет правил **Disable правила** имеют приоритет — если опция отключена, она не будет применена **Override правила** применяются по порядку — последнее совпадающее правило побеждает **Значения по умолчанию** применяю","content":"Приоритет правил **Disable правила** имеют приоритет — если опция отключена, она не будет применена **Override правила** применяются по порядку — последнее совпадающее правило побеждает **Значения по умолчанию** применяются только если нет совпадающего override и опция не отключена"},{"id":"cli/generator/generator::buf::120","title":"Генератор","section":"Совместимость с buf","path":"/docs/guide/cli/generator/generator#buf","headings":["Совместимость с buf"],"excerpt":"Совместимость с buf Managed mode в EasyP совместим с managed mode в buf. Тот же формат конфигурации и поведение применяются, что упрощает миграцию между инструментами или использование обоих в одном workflow.","content":"Совместимость с buf Managed mode в EasyP совместим с managed mode в buf. Тот же формат конфигурации и поведение применяются, что упрощает миграцию между инструментами или использование обоих в одном workflow."},{"id":"cli/generator/generator::descriptor-set::121","title":"Генератор","section":"Генерация Descriptor Set","path":"/docs/guide/cli/generator/generator#descriptor-set","headings":["Генерация Descriptor Set"],"excerpt":"Генерация Descriptor Set **https://protobuf.dev/programming-guides/techniques/#self-description**","content":"Генерация Descriptor Set **https://protobuf.dev/programming-guides/techniques/#self-description**"},{"id":"cli/generator/generator::descriptor-set::122","title":"Генератор","section":"Генерация Descriptor Set","path":"/docs/guide/cli/generator/generator#descriptor-set","headings":["Генерация Descriptor Set"],"excerpt":"Генерация Descriptor Set EasyP поддерживает генерацию бинарных FileDescriptorSet файлов с помощью флага --descriptor_set_out. Это позволяет создавать самоописывающиеся protobuf сообщения, которые включают информацию о сх","content":"Генерация Descriptor Set EasyP поддерживает генерацию бинарных FileDescriptorSet файлов с помощью флага --descriptor_set_out. Это позволяет создавать самоописывающиеся protobuf сообщения, которые включают информацию о схеме вместе с данными."},{"id":"cli/generator/generator::descriptor-set::123","title":"Генератор","section":"Генерация Descriptor Set","path":"/docs/guide/cli/generator/generator#descriptor-set","headings":["Генерация Descriptor Set"],"excerpt":"Генерация Descriptor Set **Флаги CLI:**","content":"Генерация Descriptor Set **Флаги CLI:**"},{"id":"cli/generator/generator::descriptor-set::124","title":"Генератор","section":"Генерация Descriptor Set","path":"/docs/guide/cli/generator/generator#descriptor-set","headings":["Генерация Descriptor Set"],"excerpt":"Генерация Descriptor Set --descriptor_set_out - Путь для вывода бинарного FileDescriptorSet --include_imports - Включить все транзитивные зависимости в FileDescriptorSet","content":"Генерация Descriptor Set --descriptor_set_out - Путь для вывода бинарного FileDescriptorSet --include_imports - Включить все транзитивные зависимости в FileDescriptorSet"},{"id":"cli/generator/generator::descriptor-set::125","title":"Генератор","section":"Генерация Descriptor Set","path":"/docs/guide/cli/generator/generator#descriptor-set","headings":["Генерация Descriptor Set"],"excerpt":"Генерация Descriptor Set **Пример:**","content":"Генерация Descriptor Set **Пример:**"},{"id":"cli/generator/generator::descriptor-set::126","title":"Генератор","section":"Генерация Descriptor Set","path":"/docs/guide/cli/generator/generator#descriptor-set","headings":["Генерация Descriptor Set"],"excerpt":"Генерация Descriptor Set ```bash Генерация descriptor set только с целевыми файлами easyp generate --descriptor_set_out=./schema.pb","content":"Генерация Descriptor Set ```bash Генерация descriptor set только с целевыми файлами easyp generate --descriptor_set_out=./schema.pb"},{"id":"cli/generator/generator::descriptor-set::127","title":"Генератор","section":"Генерация Descriptor Set","path":"/docs/guide/cli/generator/generator#descriptor-set","headings":["Генерация Descriptor Set"],"excerpt":"Генерация Descriptor Set Генерация descriptor set со всеми зависимостями easyp generate --descriptor_set_out=./schema.pb --include_imports ```","content":"Генерация Descriptor Set Генерация descriptor set со всеми зависимостями easyp generate --descriptor_set_out=./schema.pb --include_imports ```"},{"id":"cli/generator/generator::descriptor-set::128","title":"Генератор","section":"Генерация Descriptor Set","path":"/docs/guide/cli/generator/generator#descriptor-set","headings":["Генерация Descriptor Set"],"excerpt":"Генерация Descriptor Set Самоописывающиеся сообщения полезны для динамического парсинга сообщений, валидации схемы во время выполнения, реестров схем и создания универсальных gRPC клиентов. Для получения дополнительной и","content":"Генерация Descriptor Set Самоописывающиеся сообщения полезны для динамического парсинга сообщений, валидации схемы во время выполнения, реестров схем и создания универсальных gRPC клиентов. Для получения дополнительной информации см. документацию Protocol Buffers о самоописании."},{"id":"cli/generator/generator::top::129","title":"Генератор","section":"Интеграция с менеджером пакетов","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с менеджером пакетов"],"excerpt":"Интеграция с менеджером пакетов Одной из самых мощных возможностей EasyP является бесшовная интеграция генератора кода с менеджером пакетов. Это устраняет проблему ручного управления proto‑зависимостями и гарантирует, чт","content":"Интеграция с менеджером пакетов Одной из самых мощных возможностей EasyP является бесшовная интеграция генератора кода с менеджером пакетов. Это устраняет проблему ручного управления proto‑зависимостями и гарантирует, что при генерации используются корректные (зафиксированные) версии импортируемых файлов."},{"id":"cli/generator/generator::top::130","title":"Генератор","section":"Интеграция с менеджером пакетов","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с менеджером пакетов"],"excerpt":"Интеграция с менеджером пакетов **Ключевые преимущества:** **Автоматическое разрешение зависимостей**: не нужно вручную прописывать пути импортов **Согласованность версий**: фиксация в easyp.lock гарантирует воспроизводи","content":"Интеграция с менеджером пакетов **Ключевые преимущества:** **Автоматическое разрешение зависимостей**: не нужно вручную прописывать пути импортов **Согласованность версий**: фиксация в easyp.lock гарантирует воспроизводимость **Транзитивные зависимости**: вложенные цепочки подтягиваются автоматически **Производительность**: локальный кеш — скачивание один раз и повторное использование"},{"id":"cli/generator/generator::top::131","title":"Генератор","section":"Автоматическое разрешение зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Автоматическое разрешение зависимостей"],"excerpt":"Автоматическое разрешение зависимостей Когда вы указываете зависимости в секции deps, генератор автоматически добавляет их в путь импортов. Ваши proto‑файлы могут делать стандартные import из этих зависимостей без дополн","content":"Автоматическое разрешение зависимостей Когда вы указываете зависимости в секции deps, генератор автоматически добавляет их в путь импортов. Ваши proto‑файлы могут делать стандартные import из этих зависимостей без дополнительной настройки."},{"id":"cli/generator/generator::top::132","title":"Генератор","section":"Автоматическое разрешение зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Автоматическое разрешение зависимостей"],"excerpt":"Автоматическое разрешение зависимостей **Как это работает:** EasyP скачивает и кеширует зависимости из deps Во время генерации кешированные файлы автоматически добавляются в import‑path protoc Ваши proto‑файлы используют","content":"Автоматическое разрешение зависимостей **Как это работает:** EasyP скачивает и кеширует зависимости из deps Во время генерации кешированные файлы автоматически добавляются в import‑path protoc Ваши proto‑файлы используют обычные import строки для обращения к зависимостям При with_imports: true в вывод попадают и локальные файлы, и файлы зависимостей"},{"id":"cli/generator/generator::top::133","title":"Генератор","section":"Автоматическое разрешение зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Автоматическое разрешение зависимостей"],"excerpt":"Автоматическое разрешение зависимостей Ниже простой пример — зависимости указываются один раз в deps, далее они доступны при генерации автоматически:","content":"Автоматическое разрешение зависимостей Ниже простой пример — зависимости указываются один раз в deps, далее они доступны при генерации автоматически:"},{"id":"cli/generator/generator::top::134","title":"Генератор","section":"Автоматическое разрешение зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Автоматическое разрешение зависимостей"],"excerpt":"Автоматическое разрешение зависимостей ```yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc-ecosystem/grpc-gateway@v2.19.1","content":"Автоматическое разрешение зависимостей ```yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc-ecosystem/grpc-gateway@v2.19.1"},{"id":"cli/generator/generator::top::135","title":"Генератор","section":"Автоматическое разрешение зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Автоматическое разрешение зависимостей"],"excerpt":"Автоматическое разрешение зависимостей generate: inputs: - directory: \"proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true # This automatically includes googleapis and grpc-gateway pr","content":"Автоматическое разрешение зависимостей generate: inputs: - directory: \"proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true # This automatically includes googleapis and grpc-gateway protos ```"},{"id":"cli/generator/generator::top::136","title":"Генератор","section":"Примеры использования зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Примеры использования зависимостей"],"excerpt":"Примеры использования зависимостей Ниже показаны распространённые способы интеграции внешних proto‑зависимостей в процесс генерации.","content":"Примеры использования зависимостей Ниже показаны распространённые способы интеграции внешних proto‑зависимостей в процесс генерации."},{"id":"cli/generator/generator::google-apis::137","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs Google APIs — одна из самых популярных коллекций зависимостей: стандартные типы, аннотации для REST, проверки и общие структуры данных.","content":"Использование Google APIs Google APIs — одна из самых популярных коллекций зависимостей: стандартные типы, аннотации для REST, проверки и общие структуры данных."},{"id":"cli/generator/generator::google-apis::138","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs **Когда использовать Google APIs:** Построение REST поверх gRPC (gRPC-Gateway) Нужны стандартные типы (Timestamp, Duration, Any) Требуются аннотации поведения полей (field behavior) Интеграция с","content":"Использование Google APIs **Когда использовать Google APIs:** Построение REST поверх gRPC (gRPC-Gateway) Нужны стандартные типы (Timestamp, Duration, Any) Требуются аннотации поведения полей (field behavior) Интеграция с сервисами Google Cloud"},{"id":"cli/generator/generator::google-apis::139","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs Минимальная конфигурация для подключения Google APIs:","content":"Использование Google APIs Минимальная конфигурация для подключения Google APIs:"},{"id":"cli/generator/generator::google-apis::140","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs ```yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1","content":"Использование Google APIs ```yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1"},{"id":"cli/generator/generator::google-apis::141","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs generate: inputs: - directory: \"api/proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true ```","content":"Использование Google APIs generate: inputs: - directory: \"api/proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true ```"},{"id":"cli/generator/generator::google-apis::142","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs **Важно:** Всегда фиксируйте версию (например common-protos-1_3_1) — не используйте latest в продакшене.","content":"Использование Google APIs **Важно:** Всегда фиксируйте версию (например common-protos-1_3_1) — не используйте latest в продакшене."},{"id":"cli/generator/generator::google-apis::143","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs После настройки ваши proto могут импортировать определения Google API. Ниже пример сервиса с HTTP аннотацией:","content":"Использование Google APIs После настройки ваши proto могут импортировать определения Google API. Ниже пример сервиса с HTTP аннотацией:"},{"id":"cli/generator/generator::google-apis::144","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs ```proto // api/proto/service.proto syntax = \"proto3\";","content":"Использование Google APIs ```proto // api/proto/service.proto syntax = \"proto3\";"},{"id":"cli/generator/generator::google-apis::145","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs import \"google/api/annotations.proto\"; import \"google/protobuf/timestamp.proto\";","content":"Использование Google APIs import \"google/api/annotations.proto\"; import \"google/protobuf/timestamp.proto\";"},{"id":"cli/generator/generator::google-apis::146","title":"Генератор","section":"Использование Google APIs","path":"/docs/guide/cli/generator/generator#google-apis","headings":["Использование Google APIs"],"excerpt":"Использование Google APIs service MyService { rpc GetData(GetDataRequest) returns (GetDataResponse) { option (google.api.http) = { get: \"/v1/data\" }; } } ```","content":"Использование Google APIs service MyService { rpc GetData(GetDataRequest) returns (GetDataResponse) { option (google.api.http) = { get: \"/v1/data\" }; } } ```"},{"id":"cli/generator/generator::top::147","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации protoc-gen-validate даёт мощную проверку полей прямо в определениях proto, устраняя необходимость писать отдельную логику валидации в приложении.","content":"Использование правил валидации protoc-gen-validate даёт мощную проверку полей прямо в определениях proto, устраняя необходимость писать отдельную логику валидации в приложении."},{"id":"cli/generator/generator::top::148","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации **Когда применять валидацию:** Проверка входных данных API Ограничения моделей БД Проверка конфигурационных файлов Любая ситуация, где критична целостность данных","content":"Использование правил валидации **Когда применять валидацию:** Проверка входных данных API Ограничения моделей БД Проверка конфигурационных файлов Любая ситуация, где критична целостность данных"},{"id":"cli/generator/generator::top::149","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации **Преимущества:** Правила валидации — часть proto (единый источник истины) Генерация создаёт функции проверки автоматически Единообразие проверок между языками Производительнее чем проверка","content":"Использование правил валидации **Преимущества:** Правила валидации — часть proto (единый источник истины) Генерация создаёт функции проверки автоматически Единообразие проверок между языками Производительнее чем проверка через runtime reflection"},{"id":"cli/generator/generator::top::150","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации ```yaml deps: - github.com/bufbuild/protoc-gen-validate@v0.10.1","content":"Использование правил валидации ```yaml deps: - github.com/bufbuild/protoc-gen-validate@v0.10.1"},{"id":"cli/generator/generator::top::151","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации generate: inputs: - directory: \"proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true - name: validate-go out: ./gen/go opts: paths: source_relative ```","content":"Использование правил валидации generate: inputs: - directory: \"proto\" plugins: - name: go out: ./gen/go opts: paths: source_relative with_imports: true - name: validate-go out: ./gen/go opts: paths: source_relative ```"},{"id":"cli/generator/generator::top::152","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации **Примечание:** Нужны одновременно зависимость (для импортов proto) и плагин (для генерации кода), чтобы получить полноценную поддержку валидации.","content":"Использование правил валидации **Примечание:** Нужны одновременно зависимость (для импортов proto) и плагин (для генерации кода), чтобы получить полноценную поддержку валидации."},{"id":"cli/generator/generator::top::153","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации Так выглядят правила валидации в proto — сгенерированный код будет автоматически их применять:","content":"Использование правил валидации Так выглядят правила валидации в proto — сгенерированный код будет автоматически их применять:"},{"id":"cli/generator/generator::top::154","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации ```proto // proto/user.proto syntax = \"proto3\";","content":"Использование правил валидации ```proto // proto/user.proto syntax = \"proto3\";"},{"id":"cli/generator/generator::top::155","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации import \"validate/validate.proto\";","content":"Использование правил валидации import \"validate/validate.proto\";"},{"id":"cli/generator/generator::top::156","title":"Генератор","section":"Использование правил валидации","path":"/docs/guide/cli/generator/generator","headings":["Использование правил валидации"],"excerpt":"Использование правил валидации message User { string email = 1 [(validate.rules).string.email = true]; int32 age = 2 [(validate.rules).int32.gte = 0]; } ```","content":"Использование правил валидации message User { string email = 1 [(validate.rules).string.email = true]; int32 age = 2 [(validate.rules).int32.gte = 0]; } ```"},{"id":"cli/generator/generator::top::157","title":"Генератор","section":"Комплексная конфигурация с несколькими зависимостями","path":"/docs/guide/cli/generator/generator","headings":["Комплексная конфигурация с несколькими зависимостями"],"excerpt":"Комплексная конфигурация с несколькими зависимостями Пример ниже показывает продакшен‑конфигурацию, объединяющую несколько зависимостей и плагины для полного цикла разработки API:","content":"Комплексная конфигурация с несколькими зависимостями Пример ниже показывает продакшен‑конфигурацию, объединяющую несколько зависимостей и плагины для полного цикла разработки API:"},{"id":"cli/generator/generator::top::158","title":"Генератор","section":"Комплексная конфигурация с несколькими зависимостями","path":"/docs/guide/cli/generator/generator","headings":["Комплексная конфигурация с несколькими зависимостями"],"excerpt":"Комплексная конфигурация с несколькими зависимостями ```yaml deps: # Core Google APIs - Standard types and HTTP annotations - github.com/googleapis/googleapis@common-protos-1_3_1 # gRPC Gateway for REST APIs - Enables HT","content":"Комплексная конфигурация с несколькими зависимостями ```yaml deps: # Core Google APIs - Standard types and HTTP annotations - github.com/googleapis/googleapis@common-protos-1_3_1 # gRPC Gateway for REST APIs - Enables HTTP/JSON interfaces - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 # Validation rules - Field-level validation constraints - github.com/bufbuild/protoc-gen-validate@v0.10.1 # Company internal shared types - Common business objects - github.com/mycompany/shared-protos@v1.5.0"},{"id":"cli/generator/generator::top::159","title":"Генератор","section":"Комплексная конфигурация с несколькими зависимостями","path":"/docs/guide/cli/generator/generator","headings":["Комплексная конфигурация с несколькими зависимостями"],"excerpt":"Комплексная конфигурация с несколькими зависимостями generate: inputs: - directory: \"api/proto\" plugins: # Go code generation - Core protobuf structures - name: go out: ./gen/go opts: paths: source_relative module: githu","content":"Комплексная конфигурация с несколькими зависимостями generate: inputs: - directory: \"api/proto\" plugins: # Go code generation - Core protobuf structures - name: go out: ./gen/go opts: paths: source_relative module: github.com/mycompany/myservice with_imports: true # gRPC service stubs - Server and client interfaces - name: go-grpc out: ./gen/go opts: paths: source_relative require_unimplemented_servers: false # REST Gateway - HTTP-to-gRPC proxy code - name: grpc-gateway out: ./gen/go opts: paths: source_relative # OpenAPI documentation - API specification - name: openapiv2 out: ./gen/openapi opts: simple_operation_ids: true # Validation code - Input validation functions - name: validate-go out: ./gen/go opts: paths: source_relative ```"},{"id":"cli/generator/generator::top::160","title":"Генератор","section":"Интеграция с кешем зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с кешем зависимостей"],"excerpt":"Интеграция с кешем зависимостей Генератор использует модульный кеш EasyP для ускорения сборок:","content":"Интеграция с кешем зависимостей Генератор использует модульный кеш EasyP для ускорения сборок:"},{"id":"cli/generator/generator::top::161","title":"Генератор","section":"Интеграция с кешем зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с кешем зависимостей"],"excerpt":"Интеграция с кешем зависимостей ```bash Download dependencies once easyp mod download","content":"Интеграция с кешем зависимостей ```bash Download dependencies once easyp mod download"},{"id":"cli/generator/generator::top::162","title":"Генератор","section":"Интеграция с кешем зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с кешем зависимостей"],"excerpt":"Интеграция с кешем зависимостей Generate code (uses cached dependencies) easyp generate","content":"Интеграция с кешем зависимостей Generate code (uses cached dependencies) easyp generate"},{"id":"cli/generator/generator::top::163","title":"Генератор","section":"Интеграция с кешем зависимостей","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с кешем зависимостей"],"excerpt":"Интеграция с кешем зависимостей Dependencies are cached in ~/.easyp/mod/ ls ~/.easyp/mod/github.com/googleapis/googleapis/ ```","content":"Интеграция с кешем зависимостей Dependencies are cached in ~/.easyp/mod/ ls ~/.easyp/mod/github.com/googleapis/googleapis/ ```"},{"id":"cli/generator/generator::top::164","title":"Генератор","section":"Удалённая генерация","path":"/docs/guide/cli/generator/generator","headings":["Удалённая генерация"],"excerpt":"Удалённая генерация Удалённая генерация — мощная возможность, позволяющая генерировать код из proto‑файлов в удалённых Git‑репозиториях без локального checkout. Это поддерживает микросервисную архитектуру, где команды ис","content":"Удалённая генерация Удалённая генерация — мощная возможность, позволяющая генерировать код из proto‑файлов в удалённых Git‑репозиториях без локального checkout. Это поддерживает микросервисную архитектуру, где команды используют API друг друга без жёсткой связки."},{"id":"cli/generator/generator::top::165","title":"Генератор","section":"Удалённая генерация","path":"/docs/guide/cli/generator/generator","headings":["Удалённая генерация"],"excerpt":"Удалённая генерация **Преимущества:** **Развязка разработки**: Команды развиваются независимо, используя версии API друг друга **Контроль версий**: Фиксация внешних API гарантирует стабильность **Меньше размер репозитори","content":"Удалённая генерация **Преимущества:** **Развязка разработки**: Команды развиваются независимо, используя версии API друг друга **Контроль версий**: Фиксация внешних API гарантирует стабильность **Меньше размер репозитория**: Нет необходимости в vendoring/submodule внешних proto **Автоматические обновления**: Легко перейти на новую версию по готовности"},{"id":"cli/generator/generator::top::166","title":"Генератор","section":"Удалённая генерация","path":"/docs/guide/cli/generator/generator","headings":["Удалённая генерация"],"excerpt":"Удалённая генерация **Рекомендации:** В продакшене используйте только тегированные версии В разработке можно тестировать latest, но в проде фиксируйте При наличии используйте семантическое версионирование Учитывайте сете","content":"Удалённая генерация **Рекомендации:** В продакшене используйте только тегированные версии В разработке можно тестировать latest, но в проде фиксируйте При наличии используйте семантическое версионирование Учитывайте сетевые ограничения в CI/CD"},{"id":"cli/generator/generator::proto::167","title":"Генератор","section":"Источники удалённых proto","path":"/docs/guide/cli/generator/generator#proto","headings":["Источники удалённых proto"],"excerpt":"Источники удалённых proto Генерация напрямую из удалённых репозиториев — полезно в микросервисной архитектуре, где разные команды владеют разными proto.","content":"Источники удалённых proto Генерация напрямую из удалённых репозиториев — полезно в микросервисной архитектуре, где разные команды владеют разными proto."},{"id":"cli/generator/generator::proto::168","title":"Генератор","section":"Источники удалённых proto","path":"/docs/guide/cli/generator/generator#proto","headings":["Источники удалённых proto"],"excerpt":"Источники удалённых proto **Типовой workflow:** Команда A публикует proto с версиями в Git Команда B добавляет их в свой easyp.yaml При генерации EasyP скачивает и подключает удалённые proto Сгенерированный код содержит ","content":"Источники удалённых proto **Типовой workflow:** Команда A публикует proto с версиями в Git Команда B добавляет их в свой easyp.yaml При генерации EasyP скачивает и подключает удалённые proto Сгенерированный код содержит клиентские библиотеки сервисов команды A"},{"id":"cli/generator/generator::proto::169","title":"Генератор","section":"Источники удалённых proto","path":"/docs/guide/cli/generator/generator#proto","headings":["Источники удалённых proto"],"excerpt":"Источники удалённых proto Практический пример объединения локальных и удалённых источников в одной конфигурации генерации:","content":"Источники удалённых proto Практический пример объединения локальных и удалённых источников в одной конфигурации генерации:"},{"id":"cli/generator/generator::top::170","title":"Генератор","section":"Сценарии использования удалённой генерации","path":"/docs/guide/cli/generator/generator","headings":["Сценарии использования удалённой генерации"],"excerpt":"Сценарии использования удалённой генерации Примеры ниже показывают реальные ситуации, где удалённая генерация даёт ощутимую выгоду.","content":"Сценарии использования удалённой генерации Примеры ниже показывают реальные ситуации, где удалённая генерация даёт ощутимую выгоду."},{"id":"cli/generator/generator::multi-team-development::171","title":"Генератор","section":"Много команд (Multi-Team Development)","path":"/docs/guide/cli/generator/generator#multi-team-development","headings":["Много команд (Multi-Team Development)"],"excerpt":"Много команд (Multi-Team Development) Мультикомандная разработка особенно выигрывает: вместо координации общих репозиториев и сложного управления зависимостями — независимая эволюция API с контролируемыми обновлениями че","content":"Много команд (Multi-Team Development) Мультикомандная разработка особенно выигрывает: вместо координации общих репозиториев и сложного управления зависимостями — независимая эволюция API с контролируемыми обновлениями через версии."},{"id":"cli/generator/generator::multi-team-development::172","title":"Генератор","section":"Много команд (Multi-Team Development)","path":"/docs/guide/cli/generator/generator#multi-team-development","headings":["Много команд (Multi-Team Development)"],"excerpt":"Много команд (Multi-Team Development) Паттерн ценен в крупных организациях, где: Команды имеют разные циклы релизов и скорости разработки Владение API определено, потребление — массовое Нужно избежать overhead от координ","content":"Много команд (Multi-Team Development) Паттерн ценен в крупных организациях, где: Команды имеют разные циклы релизов и скорости разработки Владение API определено, потребление — массовое Нужно избежать overhead от координации общих proto репозиториев Команды используют разные стеки, но должны взаимодействовать"},{"id":"cli/generator/generator::multi-team-development::173","title":"Генератор","section":"Много команд (Multi-Team Development)","path":"/docs/guide/cli/generator/generator#multi-team-development","headings":["Много команд (Multi-Team Development)"],"excerpt":"Много команд (Multi-Team Development)","content":"Много команд (Multi-Team Development)"},{"id":"cli/generator/generator::api::174","title":"Генератор","section":"Интеграция с API вендоров","path":"/docs/guide/cli/generator/generator#api","headings":["Интеграция с API вендоров"],"excerpt":"Интеграция с API вендоров Многие вендоры публикуют proto для своих API, позволяя генерировать типобезопасных клиентов вместо ручных HTTP реализаций. Это повышает типовую строгость, автоматизирует сериализацию и часто уск","content":"Интеграция с API вендоров Многие вендоры публикуют proto для своих API, позволяя генерировать типобезопасных клиентов вместо ручных HTTP реализаций. Это повышает типовую строгость, автоматизирует сериализацию и часто ускоряет работу."},{"id":"cli/generator/generator::api::175","title":"Генератор","section":"Интеграция с API вендоров","path":"/docs/guide/cli/generator/generator#api","headings":["Интеграция с API вендоров"],"excerpt":"Интеграция с API вендоров Преимущества использования proto от вендоров: **Type safety**: Проверка типов на этапе компиляции **Automatic updates**: Новые возможности приходят с обновлением версии **Consistency**: Единые п","content":"Интеграция с API вендоров Преимущества использования proto от вендоров: **Type safety**: Проверка типов на этапе компиляции **Automatic updates**: Новые возможности приходят с обновлением версии **Consistency**: Единые паттерны интерфейсов между интеграциями **Performance**: Бинарная сериализация быстрее JSON **Documentation**: Proto выступают источником истины для API"},{"id":"cli/generator/generator::top::176","title":"Генератор","section":"Команды","path":"/docs/guide/cli/generator/generator","headings":["Команды"],"excerpt":"Команды CLI EasyP предоставляет гибкие варианты запуска генерации с разными конфигурациями и окружениями.","content":"Команды CLI EasyP предоставляет гибкие варианты запуска генерации с разными конфигурациями и окружениями."},{"id":"cli/generator/generator::top::177","title":"Генератор","section":"Базовая генерация","path":"/docs/guide/cli/generator/generator","headings":["Базовая генерация"],"excerpt":"Базовая генерация Ниже наиболее часто применяемые варианты команд для разработки и продакшена:","content":"Базовая генерация Ниже наиболее часто применяемые варианты команд для разработки и продакшена:"},{"id":"cli/generator/generator::top::178","title":"Генератор","section":"Базовая генерация","path":"/docs/guide/cli/generator/generator","headings":["Базовая генерация"],"excerpt":"Базовая генерация ```bash Use default easyp.yaml configuration - Most common for development easyp generate","content":"Базовая генерация ```bash Use default easyp.yaml configuration - Most common for development easyp generate"},{"id":"cli/generator/generator::top::179","title":"Генератор","section":"Базовая генерация","path":"/docs/guide/cli/generator/generator","headings":["Базовая генерация"],"excerpt":"Базовая генерация Use custom configuration file - Essential for multi-environment setups easyp --cfg production.easyp.yaml generate","content":"Базовая генерация Use custom configuration file - Essential for multi-environment setups easyp --cfg production.easyp.yaml generate"},{"id":"cli/generator/generator::top::180","title":"Генератор","section":"Базовая генерация","path":"/docs/guide/cli/generator/generator","headings":["Базовая генерация"],"excerpt":"Базовая генерация Generate with debug logs - Helpful for debugging and CI/CD easyp --debug generate","content":"Базовая генерация Generate with debug logs - Helpful for debugging and CI/CD easyp --debug generate"},{"id":"cli/generator/generator::top::181","title":"Генератор","section":"Базовая генерация","path":"/docs/guide/cli/generator/generator","headings":["Базовая генерация"],"excerpt":"Базовая генерация Generate with custom cache location - Useful for CI systems or shared environments EASYPPATH=/tmp/easyp-cache easyp generate ```","content":"Базовая генерация Generate with custom cache location - Useful for CI systems or shared environments EASYPPATH=/tmp/easyp-cache easyp generate ```"},{"id":"cli/generator/generator::top::182","title":"Генератор","section":"Интеграция с менеджером пакетов","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с менеджером пакетов"],"excerpt":"Интеграция с менеджером пакетов Интеграция с менеджером пакетов позволяет либо явно управлять зависимостями, либо поручить это генератору. Явный путь даёт больше контроля, автоматический — больше удобства:","content":"Интеграция с менеджером пакетов Интеграция с менеджером пакетов позволяет либо явно управлять зависимостями, либо поручить это генератору. Явный путь даёт больше контроля, автоматический — больше удобства:"},{"id":"cli/generator/generator::top::183","title":"Генератор","section":"Интеграция с менеджером пакетов","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с менеджером пакетов"],"excerpt":"Интеграция с менеджером пакетов ```bash Explicit workflow - Better for CI/CD and when you want to cache dependencies easyp mod download # Download and cache dependencies first easyp generate # Generate code using cached ","content":"Интеграция с менеджером пакетов ```bash Explicit workflow - Better for CI/CD and when you want to cache dependencies easyp mod download # Download and cache dependencies first easyp generate # Generate code using cached dependencies"},{"id":"cli/generator/generator::top::184","title":"Генератор","section":"Интеграция с менеджером пакетов","path":"/docs/guide/cli/generator/generator","headings":["Интеграция с менеджером пакетов"],"excerpt":"Интеграция с менеджером пакетов Automatic workflow - Convenient for development (generate downloads dependencies automatically) easyp generate ```","content":"Интеграция с менеджером пакетов Automatic workflow - Convenient for development (generate downloads dependencies automatically) easyp generate ```"},{"id":"cli/generator/generator::advanced-usage::185","title":"Генератор","section":"Расширенное использование (Advanced Usage)","path":"/docs/guide/cli/generator/generator#advanced-usage","headings":["Расширенное использование (Advanced Usage)"],"excerpt":"Расширенное использование (Advanced Usage) Эти варианты полезны для специфических сценариев деплоя, отладки или когда нужен более тонкий контроль процесса генерации:","content":"Расширенное использование (Advanced Usage) Эти варианты полезны для специфических сценариев деплоя, отладки или когда нужен более тонкий контроль процесса генерации:"},{"id":"cli/generator/generator::advanced-usage::186","title":"Генератор","section":"Расширенное использование (Advanced Usage)","path":"/docs/guide/cli/generator/generator#advanced-usage","headings":["Расширенное использование (Advanced Usage)"],"excerpt":"Расширенное использование (Advanced Usage) ```bash Генерация из конкретной директории (перекрывает настройку в файле конфигурации) easyp generate --path=./api/proto","content":"Расширенное использование (Advanced Usage) ```bash Генерация из конкретной директории (перекрывает настройку в файле конфигурации) easyp generate --path=./api/proto"},{"id":"cli/generator/generator::advanced-usage::187","title":"Генератор","section":"Расширенное использование (Advanced Usage)","path":"/docs/guide/cli/generator/generator#advanced-usage","headings":["Расширенное использование (Advanced Usage)"],"excerpt":"Расширенное использование (Advanced Usage) Генерация с vendored зависимостями (оффлайн / Docker контейнеры) easyp mod vendor easyp generate","content":"Расширенное использование (Advanced Usage) Генерация с vendored зависимостями (оффлайн / Docker контейнеры) easyp mod vendor easyp generate"},{"id":"cli/generator/generator::advanced-usage::188","title":"Генератор","section":"Расширенное использование (Advanced Usage)","path":"/docs/guide/cli/generator/generator#advanced-usage","headings":["Расширенное использование (Advanced Usage)"],"excerpt":"Расширенное использование (Advanced Usage) Генерация из кастомного project root (удобно для монореп и вложенных рабочих директорий) easyp generate --root=/usr/local/src/my-project --path=./api/proto ```","content":"Расширенное использование (Advanced Usage) Генерация из кастомного project root (удобно для монореп и вложенных рабочих директорий) easyp generate --root=/usr/local/src/my-project --path=./api/proto ```"},{"id":"cli/generator/generator::common-patterns::189","title":"Генератор","section":"Типовые паттерны (Common Patterns)","path":"/docs/guide/cli/generator/generator#common-patterns","headings":["Типовые паттерны (Common Patterns)"],"excerpt":"Типовые паттерны (Common Patterns) Эти схемы отражают реальные сценарии и лучшие практики организации генерации кода в разных структурах проектов.","content":"Типовые паттерны (Common Patterns) Эти схемы отражают реальные сценарии и лучшие практики организации генерации кода в разных структурах проектов."},{"id":"cli/generator/generator::multi-language-generation::190","title":"Генератор","section":"Мульти-языковая генерация (Multi-Language Generation)","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Мульти-языковая генерация (Multi-Language Generation)"],"excerpt":"Мульти-языковая генерация (Multi-Language Generation) Мульти-языковая генерация критична для компаний, использующих разные технологии в стеке. EasyP облегчает получение согласованных клиентских библиотек и типов для неск","content":"Мульти-языковая генерация (Multi-Language Generation) Мульти-языковая генерация критична для компаний, использующих разные технологии в стеке. EasyP облегчает получение согласованных клиентских библиотек и типов для нескольких языков из одного источника proto."},{"id":"cli/generator/generator::multi-language-generation::191","title":"Генератор","section":"Мульти-языковая генерация (Multi-Language Generation)","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Мульти-языковая генерация (Multi-Language Generation)"],"excerpt":"Мульти-языковая генерация (Multi-Language Generation) **Типовые сценарии:** **Full‑stack приложения**: backend на Go/Java + фронтенд на TypeScript **Платформы данных**: сервисы на Go + аналитика / ML на Python **Микросер","content":"Мульти-языковая генерация (Multi-Language Generation) **Типовые сценарии:** **Full‑stack приложения**: backend на Go/Java + фронтенд на TypeScript **Платформы данных**: сервисы на Go + аналитика / ML на Python **Микросервисы**: каждый сервис — оптимальный язык под задачу **Внешние SDK**: предоставление клиентских библиотек партнёрам **Интеграция с легаси**: современные gRPC сервисы + старые системы"},{"id":"cli/generator/generator::multi-language-generation::192","title":"Генератор","section":"Мульти-языковая генерация (Multi-Language Generation)","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Мульти-языковая генерация (Multi-Language Generation)"],"excerpt":"Мульти-языковая генерация (Multi-Language Generation) **Производительность:** Каждый плагин запускается отдельно — время растёт линейно от количества плагинов Для больших наборов используйте параллельный запуск (make -j4","content":"Мульти-языковая генерация (Multi-Language Generation) **Производительность:** Каждый плагин запускается отдельно — время растёт линейно от количества плагинов Для больших наборов используйте параллельный запуск (make -j4) Структурируйте выходные директории иерархически — меньше конфликтов Плагины имеют разную скорость — профилируйте сборку для поиска узких мест"},{"id":"cli/generator/generator::multi-language-generation::193","title":"Генератор","section":"Мульти-языковая генерация (Multi-Language Generation)","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Мульти-языковая генерация (Multi-Language Generation)"],"excerpt":"Мульти-языковая генерация (Multi-Language Generation) **Преимущества сопровождения:** Единый источник истины для API снижает риск расхождения схем Согласованные типы уменьшают интеграционные баги Автоматическая синхрониз","content":"Мульти-языковая генерация (Multi-Language Generation) **Преимущества сопровождения:** Единый источник истины для API снижает риск расхождения схем Согласованные типы уменьшают интеграционные баги Автоматическая синхронизация при изменении proto исключает ручные правки Меньше риска дрейфа API между реализациями на разных языках Рефакторинг упрощается — изменения транзитивно отражаются во всех артефактах"},{"id":"cli/generator/generator::multi-language-generation::194","title":"Генератор","section":"Мульти-языковая генерация (Multi-Language Generation)","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Мульти-языковая генерация (Multi-Language Generation)"],"excerpt":"Мульти-языковая генерация (Multi-Language Generation) Ниже пример типичной мульти-языковой конфигурации для full‑stack приложения: backend, веб‑клиент, аналитика и документация:","content":"Мульти-языковая генерация (Multi-Language Generation) Ниже пример типичной мульти-языковой конфигурации для full‑stack приложения: backend, веб‑клиент, аналитика и документация:"},{"id":"cli/generator/generator::multi-language-generation::195","title":"Генератор","section":"Мульти-языковая генерация (Multi-Language Generation)","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Мульти-языковая генерация (Multi-Language Generation)"],"excerpt":"Мульти-языковая генерация (Multi-Language Generation)","content":"Мульти-языковая генерация (Multi-Language Generation)"},{"id":"cli/generator/generator::multi-language-generation::196","title":"Генератор","section":"Мульти-языковая генерация (Multi-Language Generation)","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Мульти-языковая генерация (Multi-Language Generation)"],"excerpt":"Мульти-языковая генерация (Multi-Language Generation) **Совет по организации:** Используйте отдельные выходные директории для каждого языка, чтобы избежать конфликтов файлов и упростить интеграцию с языковыми сборочными ","content":"Мульти-языковая генерация (Multi-Language Generation) **Совет по организации:** Используйте отдельные выходные директории для каждого языка, чтобы избежать конфликтов файлов и упростить интеграцию с языковыми сборочными системами."},{"id":"cli/generator/generator::multi-language-generation::197","title":"Генератор","section":"Мульти-языковая генерация (Multi-Language Generation)","path":"/docs/guide/cli/generator/generator#multi-language-generation","headings":["Мульти-языковая генерация (Multi-Language Generation)"],"excerpt":"Мульти-языковая генерация (Multi-Language Generation) Генератор EasyP — комплексное решение для генерации кода из Protocol Buffers: от простой локальной разработки до сложных enterprise‑сценариев с удалёнными зависимостя","content":"Мульти-языковая генерация (Multi-Language Generation) Генератор EasyP — комплексное решение для генерации кода из Protocol Buffers: от простой локальной разработки до сложных enterprise‑сценариев с удалёнными зависимостями и мульти-языковым выводом."},{"id":"cli/linter/linter::proto::0","title":"Линтер","section":"Зачем нужен линтер для proto файлов?","path":"/docs/guide/cli/linter/linter#proto","headings":["Зачем нужен линтер для proto файлов?"],"excerpt":"Зачем нужен линтер для proto файлов? Линтеры играют ключевую роль в современной разработке, особенно когда речь о .proto файлах. Они обеспечивают единый стиль и структуру, помогают находить потенциальные ошибки на ранних","content":"Зачем нужен линтер для proto файлов? Линтеры играют ключевую роль в современной разработке, особенно когда речь о .proto файлах. Они обеспечивают единый стиль и структуру, помогают находить потенциальные ошибки на ранних этапах и поддерживают читаемость кода. Это даёт выгоды:"},{"id":"cli/linter/linter::proto::1","title":"Линтер","section":"Зачем нужен линтер для proto файлов?","path":"/docs/guide/cli/linter/linter#proto","headings":["Зачем нужен линтер для proto файлов?"],"excerpt":"Зачем нужен линтер для proto файлов? **Снижение затрат на разработку:** Ошибки ловятся раньше, меньше времени на отладку. **Улучшение командного взаимодействия:** Единообразный код легче понимать и сопровождать. **Бизнес","content":"Зачем нужен линтер для proto файлов? **Снижение затрат на разработку:** Ошибки ловятся раньше, меньше времени на отладку. **Улучшение командного взаимодействия:** Единообразный код легче понимать и сопровождать. **Бизнес-эффективность:** Более качественный код → меньше инцидентов в проде → ниже стоимость поддержки."},{"id":"cli/linter/linter::top::2","title":"Линтер","section":"Справочник по конфигурации","path":"/docs/guide/cli/linter/linter","headings":["Справочник по конфигурации"],"excerpt":"Справочник по конфигурации Конфигурация линтера настраивается в секции lint файла easyp.yaml.","content":"Справочник по конфигурации Конфигурация линтера настраивается в секции lint файла easyp.yaml."},{"id":"cli/linter/linter::use-string::3","title":"Линтер","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) Определяет набор правил или категорий для включения. Можно смешивать категории и конкретные правила.","content":"use ([]string) Определяет набор правил или категорий для включения. Можно смешивать категории и конкретные правила."},{"id":"cli/linter/linter::use-string::4","title":"Линтер","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) **Категории:** **MINIMAL**: Базовая согласованность пакетов **BASIC**: Соглашения по именованию и структуре **DEFAULT**: Рекомендованные правила для большинства проектов **COMMENTS**: Требования к коммента","content":"use ([]string) **Категории:** **MINIMAL**: Базовая согласованность пакетов **BASIC**: Соглашения по именованию и структуре **DEFAULT**: Рекомендованные правила для большинства проектов **COMMENTS**: Требования к комментариям **UNARY_RPC**: Ограничение на streaming RPC"},{"id":"cli/linter/linter::use-string::5","title":"Линтер","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) **Индивидуальные правила:** Любое имя правила (например ENUM_PASCAL_CASE, FIELD_LOWER_SNAKE_CASE)","content":"use ([]string) **Индивидуальные правила:** Любое имя правила (например ENUM_PASCAL_CASE, FIELD_LOWER_SNAKE_CASE)"},{"id":"cli/linter/linter::use-string::6","title":"Линтер","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) **Примеры:** ```yaml Только категории use: [MINIMAL, BASIC, DEFAULT]","content":"use ([]string) **Примеры:** ```yaml Только категории use: [MINIMAL, BASIC, DEFAULT]"},{"id":"cli/linter/linter::use-string::7","title":"Линтер","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) Смешивание use: - MINIMAL - COMMENT_SERVICE - COMMENT_RPC - ENUM_PASCAL_CASE","content":"use ([]string) Смешивание use: - MINIMAL - COMMENT_SERVICE - COMMENT_RPC - ENUM_PASCAL_CASE"},{"id":"cli/linter/linter::use-string::8","title":"Линтер","section":"use ([]string)","path":"/docs/guide/cli/linter/linter#use-string","headings":["use ([]string)"],"excerpt":"use ([]string) Точный набор use: - PACKAGE_DEFINED - SERVICE_PASCAL_CASE - FIELD_LOWER_SNAKE_CASE ```","content":"use ([]string) Точный набор use: - PACKAGE_DEFINED - SERVICE_PASCAL_CASE - FIELD_LOWER_SNAKE_CASE ```"},{"id":"cli/linter/linter::enum_zero_value_suffix-string::9","title":"Линтер","section":"enum_zero_value_suffix (string)","path":"/docs/guide/cli/linter/linter#enum_zero_value_suffix-string","headings":["enum_zero_value_suffix (string)"],"excerpt":"enum_zero_value_suffix (string) Обязывает нулевое значение enum иметь заданный суффикс.","content":"enum_zero_value_suffix (string) Обязывает нулевое значение enum иметь заданный суффикс."},{"id":"cli/linter/linter::enum_zero_value_suffix-string::10","title":"Линтер","section":"enum_zero_value_suffix (string)","path":"/docs/guide/cli/linter/linter#enum_zero_value_suffix-string","headings":["enum_zero_value_suffix (string)"],"excerpt":"enum_zero_value_suffix (string) **Обычно:** \"UNSPECIFIED\", \"UNKNOWN\", \"DEFAULT\"","content":"enum_zero_value_suffix (string) **Обычно:** \"UNSPECIFIED\", \"UNKNOWN\", \"DEFAULT\""},{"id":"cli/linter/linter::enum_zero_value_suffix-string::11","title":"Линтер","section":"enum_zero_value_suffix (string)","path":"/docs/guide/cli/linter/linter#enum_zero_value_suffix-string","headings":["enum_zero_value_suffix (string)"],"excerpt":"enum_zero_value_suffix (string)","content":"enum_zero_value_suffix (string)"},{"id":"cli/linter/linter::service_suffix-string::12","title":"Линтер","section":"service_suffix (string)","path":"/docs/guide/cli/linter/linter#service_suffix-string","headings":["service_suffix (string)"],"excerpt":"service_suffix (string) Требуемый суффикс для имён сервисов (унификация стиля).","content":"service_suffix (string) Требуемый суффикс для имён сервисов (унификация стиля)."},{"id":"cli/linter/linter::ignore-string::13","title":"Линтер","section":"ignore ([]string)","path":"/docs/guide/cli/linter/linter#ignore-string","headings":["ignore ([]string)"],"excerpt":"ignore ([]string) Полное исключение путей из линтинга.","content":"ignore ([]string) Полное исключение путей из линтинга."},{"id":"cli/linter/linter::ignore-string::14","title":"Линтер","section":"ignore ([]string)","path":"/docs/guide/cli/linter/linter#ignore-string","headings":["ignore ([]string)"],"excerpt":"ignore ([]string) **Use cases:** vendor / third_party сгенерированные файлы легаси подпакеты тестовые фикстуры","content":"ignore ([]string) **Use cases:** vendor / third_party сгенерированные файлы легаси подпакеты тестовые фикстуры"},{"id":"cli/linter/linter::except-string::15","title":"Линтер","section":"except ([]string)","path":"/docs/guide/cli/linter/linter#except-string","headings":["except ([]string)"],"excerpt":"except ([]string) Глобально отключает правила.","content":"except ([]string) Глобально отключает правила."},{"id":"cli/linter/linter::allow_comment_ignores-bool::16","title":"Линтер","section":"allow_comment_ignores (bool)","path":"/docs/guide/cli/linter/linter#allow_comment_ignores-bool","headings":["allow_comment_ignores (bool)"],"excerpt":"allow_comment_ignores (bool) Разрешает инлайн‑игнор правил комментариями.","content":"allow_comment_ignores (bool) Разрешает инлайн‑игнор правил комментариями."},{"id":"cli/linter/linter::ignore_only-mapstringstring::17","title":"Линтер","section":"ignore_only (map[string][]string)","path":"/docs/guide/cli/linter/linter#ignore_only-mapstringstring","headings":["ignore_only (map[string][]string)"],"excerpt":"ignore_only (mapstringstring) Таргетированное игнорирование конкретных правил для указанных путей.","content":"ignore_only (mapstringstring) Таргетированное игнорирование конкретных правил для указанных путей."},{"id":"cli/linter/linter::top::18","title":"Линтер","section":"Игнор правил комментариями","path":"/docs/guide/cli/linter/linter","headings":["Игнор правил комментариями"],"excerpt":"Игнор правил комментариями Если включён allow_comment_ignores, можно точечно отключать правила.","content":"Игнор правил комментариями Если включён allow_comment_ignores, можно точечно отключать правила."},{"id":"cli/linter/linter::top::19","title":"Линтер","section":"Несколько правил в одной строке","path":"/docs/guide/cli/linter/linter","headings":["Несколько правил в одной строке"],"excerpt":"Несколько правил в одной строке","content":"Несколько правил в одной строке"},{"id":"cli/linter/linter::top::20","title":"Линтер","section":"Используйте редко","path":"/docs/guide/cli/linter/linter","headings":["Используйте редко"],"excerpt":"Используйте редко Частое игнорирование = сигнал пересмотреть конфигурацию.","content":"Используйте редко Частое игнорирование = сигнал пересмотреть конфигурацию."},{"id":"cli/linter/linter::top::21","title":"Линтер","section":"Предпочитайте конфигурацию","path":"/docs/guide/cli/linter/linter","headings":["Предпочитайте конфигурацию"],"excerpt":"Предпочитайте конфигурацию Если нужно игнорировать правило в группе файлов — используйте ignore_only.","content":"Предпочитайте конфигурацию Если нужно игнорировать правило в группе файлов — используйте ignore_only."},{"id":"cli/linter/linter::top::22","title":"Линтер","section":"Категории линтера","path":"/docs/guide/cli/linter/linter","headings":["Категории линтера"],"excerpt":"Категории линтера Категории помогают быстро выбрать уровень строгости.","content":"Категории линтера Категории помогают быстро выбрать уровень строгости."},{"id":"cli/linter/linter::top::23","title":"Линтер","section":"Категории линтера","path":"/docs/guide/cli/linter/linter","headings":["Категории линтера"],"excerpt":"Категории линтера **Когда использовать:** **MINIMAL**: Минимальная базовая целостность **BASIC**: Частые соглашения имен **DEFAULT**: Дополнительные проверки качества **COMMENTS**: Обязательные комментарии (API, команды)","content":"Категории линтера **Когда использовать:** **MINIMAL**: Минимальная базовая целостность **BASIC**: Частые соглашения имен **DEFAULT**: Дополнительные проверки качества **COMMENTS**: Обязательные комментарии (API, команды) **UNARY_RPC**: Ограничить streaming RPC"},{"id":"cli/linter/linter::minimal::24","title":"Линтер","section":"MINIMAL","path":"/docs/guide/cli/linter/linter#minimal","headings":["MINIMAL"],"excerpt":"MINIMAL DIRECTORY_SAME_PACKAGE PACKAGE_DEFINED PACKAGE_DIRECTORY_MATCH PACKAGE_SAME_DIRECTORY","content":"MINIMAL DIRECTORY_SAME_PACKAGE PACKAGE_DEFINED PACKAGE_DIRECTORY_MATCH PACKAGE_SAME_DIRECTORY"},{"id":"cli/linter/linter::basic::25","title":"Линтер","section":"BASIC","path":"/docs/guide/cli/linter/linter#basic","headings":["BASIC"],"excerpt":"BASIC ENUM_FIRST_VALUE_ZERO ENUM_NO_ALLOW_ALIAS ENUM_PASCAL_CASE ENUM_VALUE_UPPER_SNAKE_CASE FIELD_LOWER_SNAKE_CASE IMPORT_NO_PUBLIC IMPORT_NO_WEAK IMPORT_USED MESSAGE_PASCAL_CASE ONEOF_LOWER_SNAKE_CASE PACKAGE_LOWER_SNA","content":"BASIC ENUM_FIRST_VALUE_ZERO ENUM_NO_ALLOW_ALIAS ENUM_PASCAL_CASE ENUM_VALUE_UPPER_SNAKE_CASE FIELD_LOWER_SNAKE_CASE IMPORT_NO_PUBLIC IMPORT_NO_WEAK IMPORT_USED MESSAGE_PASCAL_CASE ONEOF_LOWER_SNAKE_CASE PACKAGE_LOWER_SNAKE_CASE PACKAGE_SAME_CSHARP_NAMESPACE PACKAGE_SAME_GO_PACKAGE PACKAGE_SAME_JAVA_MULTIPLE_FILES PACKAGE_SAME_JAVA_PACKAGE PACKAGE_SAME_PHP_NAMESPACE PACKAGE_SAME_RUBY_PACKAGE PACKAGE_SAME_SWIFT_PREFIX RPC_PASCAL_CASE SERVICE_PASCAL_CASE"},{"id":"cli/linter/linter::default::26","title":"Линтер","section":"DEFAULT","path":"/docs/guide/cli/linter/linter#default","headings":["DEFAULT"],"excerpt":"DEFAULT ENUM_VALUE_PREFIX ENUM_ZERO_VALUE_SUFFIX FILE_LOWER_SNAKE_CASE RPC_REQUEST_RESPONSE_UNIQUE RPC_REQUEST_STANDARD_NAME RPC_RESPONSE_STANDARD_NAME PACKAGE_VERSION_SUFFIX SERVICE_SUFFIX","content":"DEFAULT ENUM_VALUE_PREFIX ENUM_ZERO_VALUE_SUFFIX FILE_LOWER_SNAKE_CASE RPC_REQUEST_RESPONSE_UNIQUE RPC_REQUEST_STANDARD_NAME RPC_RESPONSE_STANDARD_NAME PACKAGE_VERSION_SUFFIX SERVICE_SUFFIX"},{"id":"cli/linter/linter::comments::27","title":"Линтер","section":"COMMENTS","path":"/docs/guide/cli/linter/linter#comments","headings":["COMMENTS"],"excerpt":"COMMENTS COMMENT_ENUM COMMENT_ENUM_VALUE COMMENT_FIELD COMMENT_MESSAGE COMMENT_ONEOF COMMENT_RPC COMMENT_SERVICE","content":"COMMENTS COMMENT_ENUM COMMENT_ENUM_VALUE COMMENT_FIELD COMMENT_MESSAGE COMMENT_ONEOF COMMENT_RPC COMMENT_SERVICE"},{"id":"cli/linter/linter::unary_rpc::28","title":"Линтер","section":"UNARY_RPC","path":"/docs/guide/cli/linter/linter#unary_rpc","headings":["UNARY_RPC"],"excerpt":"UNARY_RPC RPC_NO_CLIENT_STREAMING RPC_NO_SERVER_STREAMING","content":"UNARY_RPC RPC_NO_CLIENT_STREAMING RPC_NO_SERVER_STREAMING"},{"id":"cli/linter/linter::top::29","title":"Линтер","section":"Заключение","path":"/docs/guide/cli/linter/linter","headings":["Заключение"],"excerpt":"Заключение Внедрение EasyP линдера для ваших proto файлов заметно улучшит workflow, качество и поддерживаемость кода. Полная совместимость с Buf позволяет командам мигрировать без боли, используя гибкую конфигурацию и мо","content":"Заключение Внедрение EasyP линдера для ваших proto файлов заметно улучшит workflow, качество и поддерживаемость кода. Полная совместимость с Buf позволяет командам мигрировать без боли, используя гибкую конфигурацию и мощные возможности из коробки."},{"id":"cli/linter/rules/comment-enum-value::top::0","title":"COMMENT_ENUM_VALUE","path":"/docs/guide/cli/linter/rules/comment-enum-value","headings":[],"excerpt":"Это правило проверяет, что все значения enum имеют комментарий.","content":"Это правило проверяет, что все значения enum имеют комментарий."},{"id":"cli/linter/rules/comment-enum-value::bad::1","title":"COMMENT_ENUM_VALUE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-enum-value#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-enum-value::bad::2","title":"COMMENT_ENUM_VALUE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-enum-value#bad","headings":["Bad"],"excerpt":"Bad enum Foo { BAR = 0; BAZ = 1; } ```","content":"Bad enum Foo { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/comment-enum-value::good::3","title":"COMMENT_ENUM_VALUE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-enum-value#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-enum-value::good::4","title":"COMMENT_ENUM_VALUE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-enum-value#good","headings":["Good"],"excerpt":"Good enum Foo { // BAR value for bar logic // [!code focus] BAR = 0; // BAZ value for baz logic // [!code focus] BAZ = 1; } ```","content":"Good enum Foo { // BAR value for bar logic // [!code focus] BAR = 0; // BAZ value for baz logic // [!code focus] BAZ = 1; } ```"},{"id":"cli/linter/rules/comment-enum::top::0","title":"COMMENT_ENUM","path":"/docs/guide/cli/linter/rules/comment-enum","headings":[],"excerpt":"Это правило проверяет, что enum имеет комментарий.","content":"Это правило проверяет, что enum имеет комментарий."},{"id":"cli/linter/rules/comment-enum::bad::1","title":"COMMENT_ENUM","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-enum#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-enum::bad::2","title":"COMMENT_ENUM","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-enum#bad","headings":["Bad"],"excerpt":"Bad enum Foo { BAR = 0; BAZ = 1; } ```","content":"Bad enum Foo { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/comment-enum::good::3","title":"COMMENT_ENUM","section":"Good","path":"/docs/guide/cli/linter/rules/comment-enum#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-enum::good::4","title":"COMMENT_ENUM","section":"Good","path":"/docs/guide/cli/linter/rules/comment-enum#good","headings":["Good"],"excerpt":"Good // Foo enum for bar and baz logic // [!code focus] enum Foo { BAR = 0; BAZ = 1; } ```","content":"Good // Foo enum for bar and baz logic // [!code focus] enum Foo { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/comment-field::top::0","title":"COMMENT_FIELD","path":"/docs/guide/cli/linter/rules/comment-field","headings":[],"excerpt":"Это правило проверяет, что все поля сообщений имеют комментарий.","content":"Это правило проверяет, что все поля сообщений имеют комментарий."},{"id":"cli/linter/rules/comment-field::bad::1","title":"COMMENT_FIELD","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-field#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-field::bad::2","title":"COMMENT_FIELD","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-field#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; string baz = 2; } ```","content":"Bad message Foo { string bar = 1; string baz = 2; } ```"},{"id":"cli/linter/rules/comment-field::good::3","title":"COMMENT_FIELD","section":"Good","path":"/docs/guide/cli/linter/rules/comment-field#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-field::good::4","title":"COMMENT_FIELD","section":"Good","path":"/docs/guide/cli/linter/rules/comment-field#good","headings":["Good"],"excerpt":"Good message Foo { // bar field for bar logic // [!code focus] string bar = 1; // baz field for baz logic // [!code focus] string baz = 2; } ```","content":"Good message Foo { // bar field for bar logic // [!code focus] string bar = 1; // baz field for baz logic // [!code focus] string baz = 2; } ```"},{"id":"cli/linter/rules/comment-message::top::0","title":"COMMENT_MESSAGE","path":"/docs/guide/cli/linter/rules/comment-message","headings":[],"excerpt":"Это правило проверяет, что message имеет комментарий.","content":"Это правило проверяет, что message имеет комментарий."},{"id":"cli/linter/rules/comment-message::bad::1","title":"COMMENT_MESSAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-message#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-message::bad::2","title":"COMMENT_MESSAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-message#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; string baz = 2; } ```","content":"Bad message Foo { string bar = 1; string baz = 2; } ```"},{"id":"cli/linter/rules/comment-message::good::3","title":"COMMENT_MESSAGE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-message#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-message::good::4","title":"COMMENT_MESSAGE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-message#good","headings":["Good"],"excerpt":"Good // Foo message for bar and baz logic // [!code focus] message Foo { // bar field for bar logic string bar = 1; // baz field for baz logic string baz = 2; } ```","content":"Good // Foo message for bar and baz logic // [!code focus] message Foo { // bar field for bar logic string bar = 1; // baz field for baz logic string baz = 2; } ```"},{"id":"cli/linter/rules/comment-oneof::top::0","title":"COMMENT_ONEOF","path":"/docs/guide/cli/linter/rules/comment-oneof","headings":[],"excerpt":"Это правило проверяет, что oneof имеет комментарий.","content":"Это правило проверяет, что oneof имеет комментарий."},{"id":"cli/linter/rules/comment-oneof::bad::1","title":"COMMENT_ONEOF","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-oneof#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-oneof::bad::2","title":"COMMENT_ONEOF","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-oneof#bad","headings":["Bad"],"excerpt":"Bad message Foo { oneof bar { string baz = 1; string qux = 2; } } ```","content":"Bad message Foo { oneof bar { string baz = 1; string qux = 2; } } ```"},{"id":"cli/linter/rules/comment-oneof::good::3","title":"COMMENT_ONEOF","section":"Good","path":"/docs/guide/cli/linter/rules/comment-oneof#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-oneof::good::4","title":"COMMENT_ONEOF","section":"Good","path":"/docs/guide/cli/linter/rules/comment-oneof#good","headings":["Good"],"excerpt":"Good message Foo { // bar oneof for baz and qux logic // [!code focus] oneof bar { string baz = 1; string qux = 2; } } ```","content":"Good message Foo { // bar oneof for baz and qux logic // [!code focus] oneof bar { string baz = 1; string qux = 2; } } ```"},{"id":"cli/linter/rules/comment-rpc::top::0","title":"COMMENT_RPC","path":"/docs/guide/cli/linter/rules/comment-rpc","headings":[],"excerpt":"This rule checks that rpc has a comment.","content":"This rule checks that rpc has a comment."},{"id":"cli/linter/rules/comment-rpc::bad::1","title":"COMMENT_RPC","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-rpc#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-rpc::bad::2","title":"COMMENT_RPC","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-rpc#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar (BarRequest) returns (BarResponse) {} rpc Baz (BazRequest) returns (BazResponse) {} } ```","content":"Bad service Foo { rpc Bar (BarRequest) returns (BarResponse) {} rpc Baz (BazRequest) returns (BazResponse) {} } ```"},{"id":"cli/linter/rules/comment-rpc::good::3","title":"COMMENT_RPC","section":"Good","path":"/docs/guide/cli/linter/rules/comment-rpc#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-rpc::good::4","title":"COMMENT_RPC","section":"Good","path":"/docs/guide/cli/linter/rules/comment-rpc#good","headings":["Good"],"excerpt":"Good service Foo { // Bar rpc for bar logic // [!code focus] rpc Bar (BarRequest) returns (BarResponse) {} // Baz rpc for baz logic // [!code focus] rpc Baz (BazRequest) returns (BazResponse) {} } ```","content":"Good service Foo { // Bar rpc for bar logic // [!code focus] rpc Bar (BarRequest) returns (BarResponse) {} // Baz rpc for baz logic // [!code focus] rpc Baz (BazRequest) returns (BazResponse) {} } ```"},{"id":"cli/linter/rules/comment-service::top::0","title":"COMMENT_SERVICE","path":"/docs/guide/cli/linter/rules/comment-service","headings":[],"excerpt":"Это правило проверяет, что сервис имеет комментарий.","content":"Это правило проверяет, что сервис имеет комментарий."},{"id":"cli/linter/rules/comment-service::bad::1","title":"COMMENT_SERVICE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-service#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-service::bad::2","title":"COMMENT_SERVICE","section":"Bad","path":"/docs/guide/cli/linter/rules/comment-service#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar (BarRequest) returns (BarResponse) {} } ```","content":"Bad service Foo { rpc Bar (BarRequest) returns (BarResponse) {} } ```"},{"id":"cli/linter/rules/comment-service::good::3","title":"COMMENT_SERVICE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-service#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/comment-service::good::4","title":"COMMENT_SERVICE","section":"Good","path":"/docs/guide/cli/linter/rules/comment-service#good","headings":["Good"],"excerpt":"Good // Foo service for bar logic // [!code focus] service Foo { // Bar rpc for bar logic rpc Bar (BarRequest) returns (BarResponse) {} } ```","content":"Good // Foo service for bar logic // [!code focus] service Foo { // Bar rpc for bar logic rpc Bar (BarRequest) returns (BarResponse) {} } ```"},{"id":"cli/linter/rules/directory-same-package::top::0","title":"DIRECTORY_SAME_PACKAGE","path":"/docs/guide/cli/linter/rules/directory-same-package","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/directory-same-package::top::1","title":"DIRECTORY_SAME_PACKAGE","path":"/docs/guide/cli/linter/rules/directory-same-package","headings":[],"excerpt":"Это правило проверяет, что все файлы в заданной директории находятся в одном и том же package.","content":"Это правило проверяет, что все файлы в заданной директории находятся в одном и том же package."},{"id":"cli/linter/rules/directory-same-package::bad::2","title":"DIRECTORY_SAME_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/directory-same-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: dir/foo.proto","content":"Bad ```proto // File: dir/foo.proto"},{"id":"cli/linter/rules/directory-same-package::bad::3","title":"DIRECTORY_SAME_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/directory-same-package#bad","headings":["Bad"],"excerpt":"Bad syntax = \"proto3\"; package foo;","content":"Bad syntax = \"proto3\"; package foo;"},{"id":"cli/linter/rules/directory-same-package::bad::4","title":"DIRECTORY_SAME_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/directory-same-package#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; } ```","content":"Bad message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/directory-same-package::good::5","title":"DIRECTORY_SAME_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/directory-same-package#good","headings":["Good"],"excerpt":"Good ```proto // File: dir/foo/foo.proto // [!code focus]","content":"Good ```proto // File: dir/foo/foo.proto // [!code focus]"},{"id":"cli/linter/rules/directory-same-package::good::6","title":"DIRECTORY_SAME_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/directory-same-package#good","headings":["Good"],"excerpt":"Good package dir.foo; // [!code focus]","content":"Good package dir.foo; // [!code focus]"},{"id":"cli/linter/rules/directory-same-package::good::7","title":"DIRECTORY_SAME_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/directory-same-package#good","headings":["Good"],"excerpt":"Good message Foo { string bar = 1; } ```","content":"Good message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/enum-first-value-zero::top::0","title":"ENUM_FIRST_VALUE_ZERO","path":"/docs/guide/cli/linter/rules/enum-first-value-zero","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-first-value-zero::top::1","title":"ENUM_FIRST_VALUE_ZERO","path":"/docs/guide/cli/linter/rules/enum-first-value-zero","headings":[],"excerpt":"Это правило проверяет, что первое значение enum равно нулю.","content":"Это правило проверяет, что первое значение enum равно нулю."},{"id":"cli/linter/rules/enum-first-value-zero::bad::2","title":"ENUM_FIRST_VALUE_ZERO","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-first-value-zero#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-first-value-zero::bad::3","title":"ENUM_FIRST_VALUE_ZERO","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-first-value-zero#bad","headings":["Bad"],"excerpt":"Bad enum Foo { BAR = 1; BAZ = 2; } ```","content":"Bad enum Foo { BAR = 1; BAZ = 2; } ```"},{"id":"cli/linter/rules/enum-first-value-zero::good::4","title":"ENUM_FIRST_VALUE_ZERO","section":"Good","path":"/docs/guide/cli/linter/rules/enum-first-value-zero#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-first-value-zero::good::5","title":"ENUM_FIRST_VALUE_ZERO","section":"Good","path":"/docs/guide/cli/linter/rules/enum-first-value-zero#good","headings":["Good"],"excerpt":"Good enum Foo { BAR = 0; // [!code focus] BAZ = 1; } ```","content":"Good enum Foo { BAR = 0; // [!code focus] BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-no-allow-alias::top::0","title":"ENUM_NO_ALLOW_ALIAS","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-no-allow-alias::top::1","title":"ENUM_NO_ALLOW_ALIAS","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias","headings":[],"excerpt":"Это правило проверяет, что опция allow_alias не установлена в значение true внутри enum.","content":"Это правило проверяет, что опция allow_alias не установлена в значение true внутри enum."},{"id":"cli/linter/rules/enum-no-allow-alias::bad::2","title":"ENUM_NO_ALLOW_ALIAS","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-no-allow-alias::bad::3","title":"ENUM_NO_ALLOW_ALIAS","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias#bad","headings":["Bad"],"excerpt":"Bad enum Foo { option allow_alias = true; // [!code focus] BAR = 0; BAZ = 1; } ```","content":"Bad enum Foo { option allow_alias = true; // [!code focus] BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-no-allow-alias::good::4","title":"ENUM_NO_ALLOW_ALIAS","section":"Good","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-no-allow-alias::good::5","title":"ENUM_NO_ALLOW_ALIAS","section":"Good","path":"/docs/guide/cli/linter/rules/enum-no-allow-alias#good","headings":["Good"],"excerpt":"Good enum Foo { BAR = 0; BAZ = 1; } ```","content":"Good enum Foo { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-pascal-case::top::0","title":"ENUM_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/enum-pascal-case","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-pascal-case::top::1","title":"ENUM_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/enum-pascal-case","headings":[],"excerpt":"Это правило проверяет, что имена enum написаны в стиле PascalCase.","content":"Это правило проверяет, что имена enum написаны в стиле PascalCase."},{"id":"cli/linter/rules/enum-pascal-case::bad::2","title":"ENUM_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-pascal-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-pascal-case::bad::3","title":"ENUM_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-pascal-case#bad","headings":["Bad"],"excerpt":"Bad enum foo_bar { BAR = 0; BAZ = 1; } ```","content":"Bad enum foo_bar { BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-pascal-case::good::4","title":"ENUM_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/enum-pascal-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-pascal-case::good::5","title":"ENUM_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/enum-pascal-case#good","headings":["Good"],"excerpt":"Good enum FooBar { // [!code focus] BAR = 0; BAZ = 1; } ```","content":"Good enum FooBar { // [!code focus] BAR = 0; BAZ = 1; } ```"},{"id":"cli/linter/rules/enum-value-prefix::top::0","title":"ENUM_VALUE_PREFIX","path":"/docs/guide/cli/linter/rules/enum-value-prefix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-value-prefix::top::1","title":"ENUM_VALUE_PREFIX","path":"/docs/guide/cli/linter/rules/enum-value-prefix","headings":[],"excerpt":"Это правило проверяет, что все значения enum имеют префикс, совпадающий с именем enum.","content":"Это правило проверяет, что все значения enum имеют префикс, совпадающий с именем enum."},{"id":"cli/linter/rules/enum-value-prefix::bad::2","title":"ENUM_VALUE_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-value-prefix#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-value-prefix::good::3","title":"ENUM_VALUE_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/enum-value-prefix#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-value-prefix::good::4","title":"ENUM_VALUE_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/enum-value-prefix#good","headings":["Good"],"excerpt":"Good enum Foo { FOO_BAR = 0; // [!code focus] } ```","content":"Good enum Foo { FOO_BAR = 0; // [!code focus] } ```"},{"id":"cli/linter/rules/enum-value-upper-snake-case::top::0","title":"ENUM_VALUE_UPPER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-value-upper-snake-case::top::1","title":"ENUM_VALUE_UPPER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case","headings":[],"excerpt":"Это правило проверяет, что значения enum записаны в стиле UPPER_SNAKE_CASE.","content":"Это правило проверяет, что значения enum записаны в стиле UPPER_SNAKE_CASE."},{"id":"cli/linter/rules/enum-value-upper-snake-case::bad::2","title":"ENUM_VALUE_UPPER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-value-upper-snake-case::bad::3","title":"ENUM_VALUE_UPPER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case#bad","headings":["Bad"],"excerpt":"Bad enum Foo { barName = 0; bazName = 1; } ```","content":"Bad enum Foo { barName = 0; bazName = 1; } ```"},{"id":"cli/linter/rules/enum-value-upper-snake-case::good::4","title":"ENUM_VALUE_UPPER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-value-upper-snake-case::good::5","title":"ENUM_VALUE_UPPER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/enum-value-upper-snake-case#good","headings":["Good"],"excerpt":"Good enum Foo { BAR_NAME = 0; // [!code focus] BAZ_NAME = 1; // [!code focus] } ```","content":"Good enum Foo { BAR_NAME = 0; // [!code focus] BAZ_NAME = 1; // [!code focus] } ```"},{"id":"cli/linter/rules/enum-zero-value-suffix::top::0","title":"ENUM_ZERO_VALUE_SUFFIX","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/enum-zero-value-suffix::top::1","title":"ENUM_ZERO_VALUE_SUFFIX","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix","headings":[],"excerpt":"Это правило проверяет, что все нулевые значения enum имеют суффикс _NONE или ваш кастомный (пользовательский) суффикс.","content":"Это правило проверяет, что все нулевые значения enum имеют суффикс _NONE или ваш кастомный (пользовательский) суффикс."},{"id":"cli/linter/rules/enum-zero-value-suffix::bad::2","title":"ENUM_ZERO_VALUE_SUFFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-zero-value-suffix::good::3","title":"ENUM_ZERO_VALUE_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/enum-zero-value-suffix::good::4","title":"ENUM_ZERO_VALUE_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/enum-zero-value-suffix#good","headings":["Good"],"excerpt":"Good enum Foo { FOO_BAR_NONE = 0; // [!code focus] } ```","content":"Good enum Foo { FOO_BAR_NONE = 0; // [!code focus] } ```"},{"id":"cli/linter/rules/field-lower-snake-case::top::0","title":"FIELD_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/field-lower-snake-case","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/field-lower-snake-case::top::1","title":"FIELD_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/field-lower-snake-case","headings":[],"excerpt":"Это правило проверяет, что имена полей сообщений записаны в стиле lower_snake_case.","content":"Это правило проверяет, что имена полей сообщений записаны в стиле lower_snake_case."},{"id":"cli/linter/rules/field-lower-snake-case::bad::2","title":"FIELD_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/field-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/field-lower-snake-case::bad::3","title":"FIELD_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/field-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad message Foo { string BarName = 1; } ```","content":"Bad message Foo { string BarName = 1; } ```"},{"id":"cli/linter/rules/field-lower-snake-case::good::4","title":"FIELD_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/field-lower-snake-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/field-lower-snake-case::good::5","title":"FIELD_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/field-lower-snake-case#good","headings":["Good"],"excerpt":"Good message Foo { string bar_name = 1; // [!code focus] } ```","content":"Good message Foo { string bar_name = 1; // [!code focus] } ```"},{"id":"cli/linter/rules/file-lower-snake-case::top::0","title":"FILE_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/file-lower-snake-case","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/file-lower-snake-case::top::1","title":"FILE_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/file-lower-snake-case","headings":[],"excerpt":"Это правило проверяет, что все файлы имеют имя в формате lower_snake_case (только строчные буквы, цифры и символ подчеркивания, без пробелов и заглавных букв).","content":"Это правило проверяет, что все файлы имеют имя в формате lower_snake_case (только строчные буквы, цифры и символ подчеркивания, без пробелов и заглавных букв)."},{"id":"cli/linter/rules/file-lower-snake-case::bad::2","title":"FILE_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/file-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: bar/FooBaz.proto","content":"Bad ```proto // File: bar/FooBaz.proto"},{"id":"cli/linter/rules/file-lower-snake-case::good::3","title":"FILE_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/file-lower-snake-case#good","headings":["Good"],"excerpt":"Good ```proto // File: bar/foo_baz.proto // [!code focus]","content":"Good ```proto // File: bar/foo_baz.proto // [!code focus]"},{"id":"cli/linter/rules/import-no-public::top::0","title":"IMPORT_NO_PUBLIC","path":"/docs/guide/cli/linter/rules/import-no-public","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/import-no-public::top::1","title":"IMPORT_NO_PUBLIC","path":"/docs/guide/cli/linter/rules/import-no-public","headings":[],"excerpt":"Это правило проверяет, что в proto-файле не используются public импорты (оператор import public \"...\").","content":"Это правило проверяет, что в proto-файле не используются public импорты (оператор import public \"...\")."},{"id":"cli/linter/rules/import-no-public::bad::2","title":"IMPORT_NO_PUBLIC","section":"Bad","path":"/docs/guide/cli/linter/rules/import-no-public#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/import-no-public::bad::3","title":"IMPORT_NO_PUBLIC","section":"Bad","path":"/docs/guide/cli/linter/rules/import-no-public#bad","headings":["Bad"],"excerpt":"Bad import public \"bar.proto\"; ```","content":"Bad import public \"bar.proto\"; ```"},{"id":"cli/linter/rules/import-no-public::good::4","title":"IMPORT_NO_PUBLIC","section":"Good","path":"/docs/guide/cli/linter/rules/import-no-public#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/import-no-public::good::5","title":"IMPORT_NO_PUBLIC","section":"Good","path":"/docs/guide/cli/linter/rules/import-no-public#good","headings":["Good"],"excerpt":"Good import \"bar.proto\"; // [!code focus] ```","content":"Good import \"bar.proto\"; // [!code focus] ```"},{"id":"cli/linter/rules/import-no-weak::top::0","title":"IMPORT_NO_WEAK","path":"/docs/guide/cli/linter/rules/import-no-weak","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/import-no-weak::top::1","title":"IMPORT_NO_WEAK","path":"/docs/guide/cli/linter/rules/import-no-weak","headings":[],"excerpt":"Это правило проверяет, что в proto‑файле не используются weak‑импорты (import weak \"...\").","content":"Это правило проверяет, что в proto‑файле не используются weak‑импорты (import weak \"...\")."},{"id":"cli/linter/rules/import-no-weak::top::2","title":"IMPORT_NO_WEAK","path":"/docs/guide/cli/linter/rules/import-no-weak","headings":[],"excerpt":"Weak import (синтаксис import weak) допустим в proto2, но его использование усложняет анализ зависимостей и может приводить к неочевидным ошибкам при генерации кода. Рекомендуется всегда использовать обычный import.","content":"Weak import (синтаксис import weak) допустим в proto2, но его использование усложняет анализ зависимостей и может приводить к неочевидным ошибкам при генерации кода. Рекомендуется всегда использовать обычный import."},{"id":"cli/linter/rules/import-no-weak::bad::3","title":"IMPORT_NO_WEAK","section":"Bad","path":"/docs/guide/cli/linter/rules/import-no-weak#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto2\";","content":"Bad ```proto syntax = \"proto2\";"},{"id":"cli/linter/rules/import-no-weak::bad::4","title":"IMPORT_NO_WEAK","section":"Bad","path":"/docs/guide/cli/linter/rules/import-no-weak#bad","headings":["Bad"],"excerpt":"Bad import weak \"bar.proto\"; ```","content":"Bad import weak \"bar.proto\"; ```"},{"id":"cli/linter/rules/import-no-weak::good::5","title":"IMPORT_NO_WEAK","section":"Good","path":"/docs/guide/cli/linter/rules/import-no-weak#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto2\";","content":"Good ```proto syntax = \"proto2\";"},{"id":"cli/linter/rules/import-no-weak::good::6","title":"IMPORT_NO_WEAK","section":"Good","path":"/docs/guide/cli/linter/rules/import-no-weak#good","headings":["Good"],"excerpt":"Good import \"bar.proto\"; // [!code focus] ```","content":"Good import \"bar.proto\"; // [!code focus] ```"},{"id":"cli/linter/rules/import-used::top::0","title":"IMPORT_USED","path":"/docs/guide/cli/linter/rules/import-used","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/import-used::top::1","title":"IMPORT_USED","path":"/docs/guide/cli/linter/rules/import-used","headings":[],"excerpt":"Это правило проверяет, что все импорты используются в proto-файле.","content":"Это правило проверяет, что все импорты используются в proto-файле."},{"id":"cli/linter/rules/import-used::bad::2","title":"IMPORT_USED","section":"Bad","path":"/docs/guide/cli/linter/rules/import-used#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/import-used::good::3","title":"IMPORT_USED","section":"Good","path":"/docs/guide/cli/linter/rules/import-used#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/import-used::good::4","title":"IMPORT_USED","section":"Good","path":"/docs/guide/cli/linter/rules/import-used#good","headings":["Good"],"excerpt":"Good import \"bar.proto\"; // [!code focus]","content":"Good import \"bar.proto\"; // [!code focus]"},{"id":"cli/linter/rules/import-used::good::5","title":"IMPORT_USED","section":"Good","path":"/docs/guide/cli/linter/rules/import-used#good","headings":["Good"],"excerpt":"Good message Foo { bar.Bar bar = 1; // [!code focus] } ```","content":"Good message Foo { bar.Bar bar = 1; // [!code focus] } ```"},{"id":"cli/linter/rules/message-pascal-case::top::0","title":"MESSAGE_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/message-pascal-case","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/message-pascal-case::top::1","title":"MESSAGE_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/message-pascal-case","headings":[],"excerpt":"Это правило проверяет, что имена сообщений (message) записаны в стиле PascalCase.","content":"Это правило проверяет, что имена сообщений (message) записаны в стиле PascalCase."},{"id":"cli/linter/rules/message-pascal-case::bad::2","title":"MESSAGE_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/message-pascal-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/message-pascal-case::bad::3","title":"MESSAGE_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/message-pascal-case#bad","headings":["Bad"],"excerpt":"Bad message foo_bar { string bar_name = 1; } ```","content":"Bad message foo_bar { string bar_name = 1; } ```"},{"id":"cli/linter/rules/message-pascal-case::good::4","title":"MESSAGE_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/message-pascal-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/message-pascal-case::good::5","title":"MESSAGE_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/message-pascal-case#good","headings":["Good"],"excerpt":"Good message FooBar { // [!code focus] string bar_name = 1; } ```","content":"Good message FooBar { // [!code focus] string bar_name = 1; } ```"},{"id":"cli/linter/rules/oneof-lower-snake-case::top::0","title":"ONEOF_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/oneof-lower-snake-case::top::1","title":"ONEOF_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case","headings":[],"excerpt":"Это правило проверяет, что имена oneof записаны в стиле lower_snake_case.","content":"Это правило проверяет, что имена oneof записаны в стиле lower_snake_case."},{"id":"cli/linter/rules/oneof-lower-snake-case::bad::2","title":"ONEOF_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/oneof-lower-snake-case::bad::3","title":"ONEOF_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad message Foo { oneof BarName { string bar_name = 1; } } ```","content":"Bad message Foo { oneof BarName { string bar_name = 1; } } ```"},{"id":"cli/linter/rules/oneof-lower-snake-case::good::4","title":"ONEOF_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/oneof-lower-snake-case::good::5","title":"ONEOF_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/oneof-lower-snake-case#good","headings":["Good"],"excerpt":"Good message Foo { oneof bar_name { // [!code focus] string bar_name = 1; } } ```","content":"Good message Foo { oneof bar_name { // [!code focus] string bar_name = 1; } } ```"},{"id":"cli/linter/rules/package-defined::top::0","title":"PACKAGE_DEFINED","path":"/docs/guide/cli/linter/rules/package-defined","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-defined::top::1","title":"PACKAGE_DEFINED","path":"/docs/guide/cli/linter/rules/package-defined","headings":[],"excerpt":"Это правило проверяет, что во всех файлах присутствует директива package.","content":"Это правило проверяет, что во всех файлах присутствует директива package."},{"id":"cli/linter/rules/package-defined::bad::2","title":"PACKAGE_DEFINED","section":"Bad","path":"/docs/guide/cli/linter/rules/package-defined#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-defined::bad::3","title":"PACKAGE_DEFINED","section":"Bad","path":"/docs/guide/cli/linter/rules/package-defined#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; }","content":"Bad message Foo { string bar = 1; }"},{"id":"cli/linter/rules/package-defined::good::4","title":"PACKAGE_DEFINED","section":"Good","path":"/docs/guide/cli/linter/rules/package-defined#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-defined::good::5","title":"PACKAGE_DEFINED","section":"Good","path":"/docs/guide/cli/linter/rules/package-defined#good","headings":["Good"],"excerpt":"Good package foo; // [!code focus]","content":"Good package foo; // [!code focus]"},{"id":"cli/linter/rules/package-defined::good::6","title":"PACKAGE_DEFINED","section":"Good","path":"/docs/guide/cli/linter/rules/package-defined#good","headings":["Good"],"excerpt":"Good message Foo { string bar = 1; } ```","content":"Good message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/package-directory-match::top::0","title":"PACKAGE_DIRECTORY_MATCH","path":"/docs/guide/cli/linter/rules/package-directory-match","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-directory-match::top::1","title":"PACKAGE_DIRECTORY_MATCH","path":"/docs/guide/cli/linter/rules/package-directory-match","headings":[],"excerpt":"Это правило проверяет, что все файлы находятся в директории, имя которой соответствует имени их пакета.","content":"Это правило проверяет, что все файлы находятся в директории, имя которой соответствует имени их пакета."},{"id":"cli/linter/rules/package-directory-match::bad::2","title":"PACKAGE_DIRECTORY_MATCH","section":"Bad","path":"/docs/guide/cli/linter/rules/package-directory-match#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: bar/foo.proto","content":"Bad ```proto // File: bar/foo.proto"},{"id":"cli/linter/rules/package-directory-match::bad::3","title":"PACKAGE_DIRECTORY_MATCH","section":"Bad","path":"/docs/guide/cli/linter/rules/package-directory-match#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; } ```","content":"Bad message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/package-directory-match::good::4","title":"PACKAGE_DIRECTORY_MATCH","section":"Good","path":"/docs/guide/cli/linter/rules/package-directory-match#good","headings":["Good"],"excerpt":"Good ```proto // File: bar/foo.proto // [!code focus]","content":"Good ```proto // File: bar/foo.proto // [!code focus]"},{"id":"cli/linter/rules/package-directory-match::good::5","title":"PACKAGE_DIRECTORY_MATCH","section":"Good","path":"/docs/guide/cli/linter/rules/package-directory-match#good","headings":["Good"],"excerpt":"Good package bar; // [!code focus]","content":"Good package bar; // [!code focus]"},{"id":"cli/linter/rules/package-directory-match::good::6","title":"PACKAGE_DIRECTORY_MATCH","section":"Good","path":"/docs/guide/cli/linter/rules/package-directory-match#good","headings":["Good"],"excerpt":"Good message Foo { string bar = 1; } ```","content":"Good message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/package-lower-snake-case::top::0","title":"PACKAGE_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/package-lower-snake-case","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-lower-snake-case::top::1","title":"PACKAGE_LOWER_SNAKE_CASE","path":"/docs/guide/cli/linter/rules/package-lower-snake-case","headings":[],"excerpt":"Это правило проверяет, что имена package записаны в формате lower_snake_case (строчные буквы, при необходимости цифры и символ подчеркивания, без пробелов и заглавных букв).","content":"Это правило проверяет, что имена package записаны в формате lower_snake_case (строчные буквы, при необходимости цифры и символ подчеркивания, без пробелов и заглавных букв)."},{"id":"cli/linter/rules/package-lower-snake-case::bad::2","title":"PACKAGE_LOWER_SNAKE_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-lower-snake-case#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: bar/foo.proto syntax = \"proto3\";","content":"Bad ```proto // File: bar/foo.proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-lower-snake-case::good::3","title":"PACKAGE_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/package-lower-snake-case#good","headings":["Good"],"excerpt":"Good ```proto // File: bar/foo.proto syntax = \"proto3\";","content":"Good ```proto // File: bar/foo.proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-lower-snake-case::good::4","title":"PACKAGE_LOWER_SNAKE_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/package-lower-snake-case#good","headings":["Good"],"excerpt":"Good package foo_bar; // [!code focus] ```","content":"Good package foo_bar; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-csharp-namespace::top::0","title":"PACKAGE_SAME_CSHARP_NAMESPACE","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-csharp-namespace::top::1","title":"PACKAGE_SAME_CSHARP_NAMESPACE","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace","headings":[],"excerpt":"Это правило проверяет, что все файлы с заданным пакетом используют одно и то же пространство имён C# (csharp_namespace).","content":"Это правило проверяет, что все файлы с заданным пакетом используют одно и то же пространство имён C# (csharp_namespace)."},{"id":"cli/linter/rules/package-same-csharp-namespace::bad::2","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-csharp-namespace::bad::3","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#bad","headings":["Bad"],"excerpt":"Bad option csharp_namespace = \"Foo.Bar\"; ```","content":"Bad option csharp_namespace = \"Foo.Bar\"; ```"},{"id":"cli/linter/rules/package-same-csharp-namespace::bad::4","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-csharp-namespace::bad::5","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#bad","headings":["Bad"],"excerpt":"Bad option csharp_namespace = \"Foo.Baz\"; ```","content":"Bad option csharp_namespace = \"Foo.Baz\"; ```"},{"id":"cli/linter/rules/package-same-csharp-namespace::good::6","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-csharp-namespace::good::7","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#good","headings":["Good"],"excerpt":"Good option csharp_namespace = \"Foo.Bar\"; // [!code focus] ```","content":"Good option csharp_namespace = \"Foo.Bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-csharp-namespace::good::8","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-csharp-namespace::good::9","title":"PACKAGE_SAME_CSHARP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-csharp-namespace#good","headings":["Good"],"excerpt":"Good option csharp_namespace = \"Foo.Bar\"; // [!code focus] ```","content":"Good option csharp_namespace = \"Foo.Bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-directory::top::0","title":"PACKAGE_SAME_DIRECTORY","path":"/docs/guide/cli/linter/rules/package-same-directory","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-directory::top::1","title":"PACKAGE_SAME_DIRECTORY","path":"/docs/guide/cli/linter/rules/package-same-directory","headings":[],"excerpt":"Это правило проверяет, что все файлы с данным package находятся в одной директории.","content":"Это правило проверяет, что все файлы с данным package находятся в одной директории."},{"id":"cli/linter/rules/package-same-directory::bad::2","title":"PACKAGE_SAME_DIRECTORY","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-directory#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: bar/foo.proto","content":"Bad ```proto // File: bar/foo.proto"},{"id":"cli/linter/rules/package-same-directory::bad::3","title":"PACKAGE_SAME_DIRECTORY","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-directory#bad","headings":["Bad"],"excerpt":"Bad message Foo { string bar = 1; } ```","content":"Bad message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/package-same-directory::good::4","title":"PACKAGE_SAME_DIRECTORY","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-directory#good","headings":["Good"],"excerpt":"Good ```proto // File: bar/foo.proto // [!code focus]","content":"Good ```proto // File: bar/foo.proto // [!code focus]"},{"id":"cli/linter/rules/package-same-directory::good::5","title":"PACKAGE_SAME_DIRECTORY","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-directory#good","headings":["Good"],"excerpt":"Good package bar; // [!code focus]","content":"Good package bar; // [!code focus]"},{"id":"cli/linter/rules/package-same-directory::good::6","title":"PACKAGE_SAME_DIRECTORY","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-directory#good","headings":["Good"],"excerpt":"Good message Foo { string bar = 1; } ```","content":"Good message Foo { string bar = 1; } ```"},{"id":"cli/linter/rules/package-same-go-package::top::0","title":"PACKAGE_SAME_GO_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-go-package","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-go-package::top::1","title":"PACKAGE_SAME_GO_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-go-package","headings":[],"excerpt":"Это правило проверяет, что все файлы с одним и тем же package используют одно и то же значение опции go_package.","content":"Это правило проверяет, что все файлы с одним и тем же package используют одно и то же значение опции go_package."},{"id":"cli/linter/rules/package-same-go-package::bad::2","title":"PACKAGE_SAME_GO_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-go-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-go-package::bad::3","title":"PACKAGE_SAME_GO_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-go-package#bad","headings":["Bad"],"excerpt":"Bad option go_package = \"example.com/foo/bar\"; ```","content":"Bad option go_package = \"example.com/foo/bar\"; ```"},{"id":"cli/linter/rules/package-same-go-package::bad::4","title":"PACKAGE_SAME_GO_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-go-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-go-package::bad::5","title":"PACKAGE_SAME_GO_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-go-package#bad","headings":["Bad"],"excerpt":"Bad option go_package = \"example.com/foo/baz\"; ```","content":"Bad option go_package = \"example.com/foo/baz\"; ```"},{"id":"cli/linter/rules/package-same-go-package::good::6","title":"PACKAGE_SAME_GO_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-go-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-go-package::good::7","title":"PACKAGE_SAME_GO_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-go-package#good","headings":["Good"],"excerpt":"Good option go_package = \"example.com/foo/bar\"; // [!code focus] ```","content":"Good option go_package = \"example.com/foo/bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-go-package::good::8","title":"PACKAGE_SAME_GO_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-go-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-go-package::good::9","title":"PACKAGE_SAME_GO_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-go-package#good","headings":["Good"],"excerpt":"Good option go_package = \"example.com/foo/bar\"; // [!code focus] ```","content":"Good option go_package = \"example.com/foo/bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-java-multiple-files::top::0","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files","headings":[],"excerpt":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","content":"PACKAGE_SAME_JAVA_MULTIPLE_FILES"},{"id":"cli/linter/rules/package-same-java-multiple-files::top::1","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-java-multiple-files::top::2","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files","headings":[],"excerpt":"Это правило проверяет, что все файлы с одним и тем же package используют одинаковое значение опции java_package.","content":"Это правило проверяет, что все файлы с одним и тем же package используют одинаковое значение опции java_package."},{"id":"cli/linter/rules/package-same-java-multiple-files::bad::3","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-java-multiple-files::bad::4","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#bad","headings":["Bad"],"excerpt":"Bad option java_package = \"com.example.foo\"; ```","content":"Bad option java_package = \"com.example.foo\"; ```"},{"id":"cli/linter/rules/package-same-java-multiple-files::bad::5","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-java-multiple-files::bad::6","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#bad","headings":["Bad"],"excerpt":"Bad option java_package = \"com.example.bar\"; ```","content":"Bad option java_package = \"com.example.bar\"; ```"},{"id":"cli/linter/rules/package-same-java-multiple-files::good::7","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-java-multiple-files::good::8","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#good","headings":["Good"],"excerpt":"Good option java_package = \"com.example.foo\"; // [!code focus] ```","content":"Good option java_package = \"com.example.foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-java-multiple-files::good::9","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-java-multiple-files::good::10","title":"PACKAGE_SAME_JAVA_MULTIPLE_FILES","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-multiple-files#good","headings":["Good"],"excerpt":"Good option java_package = \"com.example.foo\"; // [!code focus] ```","content":"Good option java_package = \"com.example.foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-java-package::top::0","title":"PACKAGE_SAME_JAVA_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-java-package","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-java-package::top::1","title":"PACKAGE_SAME_JAVA_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-java-package","headings":[],"excerpt":"Это правило проверяет, что все файлы с одним и тем же package используют одно и то же значение опции java_package.","content":"Это правило проверяет, что все файлы с одним и тем же package используют одно и то же значение опции java_package."},{"id":"cli/linter/rules/package-same-java-package::bad::2","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-java-package::bad::3","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-package#bad","headings":["Bad"],"excerpt":"Bad option java_package = \"com.example.foo\"; ```","content":"Bad option java_package = \"com.example.foo\"; ```"},{"id":"cli/linter/rules/package-same-java-package::bad::4","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-java-package::bad::5","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-java-package#bad","headings":["Bad"],"excerpt":"Bad option java_package = \"com.example.bar\"; ```","content":"Bad option java_package = \"com.example.bar\"; ```"},{"id":"cli/linter/rules/package-same-java-package::good::6","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-java-package::good::7","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-package#good","headings":["Good"],"excerpt":"Good option java_package = \"com.example.foo\"; // [!code focus] ```","content":"Good option java_package = \"com.example.foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-java-package::good::8","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-java-package::good::9","title":"PACKAGE_SAME_JAVA_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-java-package#good","headings":["Good"],"excerpt":"Good option java_package = \"com.example.foo\"; // [!code focus] ```","content":"Good option java_package = \"com.example.foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-php-namespace::top::0","title":"PACKAGE_SAME_PHP_NAMESPACE","path":"/docs/guide/cli/linter/rules/package-same-php-namespace","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-php-namespace::top::1","title":"PACKAGE_SAME_PHP_NAMESPACE","path":"/docs/guide/cli/linter/rules/package-same-php-namespace","headings":[],"excerpt":"Это правило проверяет, что все файлы с одним и тем же package используют одно и то же значение опции php_namespace.","content":"Это правило проверяет, что все файлы с одним и тем же package используют одно и то же значение опции php_namespace."},{"id":"cli/linter/rules/package-same-php-namespace::bad::2","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-php-namespace::bad::3","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#bad","headings":["Bad"],"excerpt":"Bad option php_namespace = \"Foo\\\\Bar\"; ```","content":"Bad option php_namespace = \"Foo\\\\Bar\"; ```"},{"id":"cli/linter/rules/package-same-php-namespace::bad::4","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-php-namespace::bad::5","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#bad","headings":["Bad"],"excerpt":"Bad option php_namespace = \"Foo\\\\Baz\"; ```","content":"Bad option php_namespace = \"Foo\\\\Baz\"; ```"},{"id":"cli/linter/rules/package-same-php-namespace::good::6","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-php-namespace::good::7","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#good","headings":["Good"],"excerpt":"Good option php_namespace = \"Foo\\\\Bar\"; // [!code focus] ```","content":"Good option php_namespace = \"Foo\\\\Bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-php-namespace::good::8","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-php-namespace::good::9","title":"PACKAGE_SAME_PHP_NAMESPACE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-php-namespace#good","headings":["Good"],"excerpt":"Good option php_namespace = \"Foo\\\\Bar\"; // [!code focus] ```","content":"Good option php_namespace = \"Foo\\\\Bar\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-ruby-package::top::0","title":"PACKAGE_SAME_RUBY_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-ruby-package","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-ruby-package::top::1","title":"PACKAGE_SAME_RUBY_PACKAGE","path":"/docs/guide/cli/linter/rules/package-same-ruby-package","headings":[],"excerpt":"This rule checks that all files with a given package are in the same Ruby package.","content":"This rule checks that all files with a given package are in the same Ruby package."},{"id":"cli/linter/rules/package-same-ruby-package::bad::2","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-ruby-package::bad::3","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#bad","headings":["Bad"],"excerpt":"Bad option ruby_package = \"Foo\"; ```","content":"Bad option ruby_package = \"Foo\"; ```"},{"id":"cli/linter/rules/package-same-ruby-package::bad::4","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-ruby-package::bad::5","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#bad","headings":["Bad"],"excerpt":"Bad option ruby_package = \"Bar\"; ```","content":"Bad option ruby_package = \"Bar\"; ```"},{"id":"cli/linter/rules/package-same-ruby-package::good::6","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-ruby-package::good::7","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#good","headings":["Good"],"excerpt":"Good option ruby_package = \"Foo\"; // [!code focus] ```","content":"Good option ruby_package = \"Foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-ruby-package::good::8","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-ruby-package::good::9","title":"PACKAGE_SAME_RUBY_PACKAGE","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-ruby-package#good","headings":["Good"],"excerpt":"Good option ruby_package = \"Foo\"; // [!code focus] ```","content":"Good option ruby_package = \"Foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-swift-prefix::top::0","title":"PACKAGE_SAME_SWIFT_PREFIX","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-same-swift-prefix::top::1","title":"PACKAGE_SAME_SWIFT_PREFIX","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix","headings":[],"excerpt":"Это правило проверяет, что все файлы с одним и тем же package используют один и тот же swift_prefix.","content":"Это правило проверяет, что все файлы с одним и тем же package используют один и тот же swift_prefix."},{"id":"cli/linter/rules/package-same-swift-prefix::bad::2","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/foo.proto","content":"Bad ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-swift-prefix::bad::3","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#bad","headings":["Bad"],"excerpt":"Bad option swift_prefix = \"Foo\"; ```","content":"Bad option swift_prefix = \"Foo\"; ```"},{"id":"cli/linter/rules/package-same-swift-prefix::bad::4","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#bad","headings":["Bad"],"excerpt":"Bad ```proto // File: pkg/bar.proto","content":"Bad ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-swift-prefix::bad::5","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#bad","headings":["Bad"],"excerpt":"Bad option swift_prefix = \"Bar\"; ```","content":"Bad option swift_prefix = \"Bar\"; ```"},{"id":"cli/linter/rules/package-same-swift-prefix::good::6","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/foo.proto","content":"Good ```proto // File: pkg/foo.proto"},{"id":"cli/linter/rules/package-same-swift-prefix::good::7","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#good","headings":["Good"],"excerpt":"Good option swift_prefix = \"Foo\"; // [!code focus] ```","content":"Good option swift_prefix = \"Foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-same-swift-prefix::good::8","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#good","headings":["Good"],"excerpt":"Good ```proto // File: pkg/bar.proto","content":"Good ```proto // File: pkg/bar.proto"},{"id":"cli/linter/rules/package-same-swift-prefix::good::9","title":"PACKAGE_SAME_SWIFT_PREFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-same-swift-prefix#good","headings":["Good"],"excerpt":"Good option swift_prefix = \"Foo\"; // [!code focus] ```","content":"Good option swift_prefix = \"Foo\"; // [!code focus] ```"},{"id":"cli/linter/rules/package-version-suffix::top::0","title":"PACKAGE_VERSION_SUFFIX","path":"/docs/guide/cli/linter/rules/package-version-suffix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/package-version-suffix::top::1","title":"PACKAGE_VERSION_SUFFIX","path":"/docs/guide/cli/linter/rules/package-version-suffix","headings":[],"excerpt":"Это правило проверяет, что суффикс версии пакета имеет формат _vX, где X — числовая версия.","content":"Это правило проверяет, что суффикс версии пакета имеет формат _vX, где X — числовая версия."},{"id":"cli/linter/rules/package-version-suffix::bad::2","title":"PACKAGE_VERSION_SUFFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/package-version-suffix#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-version-suffix::good::3","title":"PACKAGE_VERSION_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-version-suffix#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/package-version-suffix::good::4","title":"PACKAGE_VERSION_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/package-version-suffix#good","headings":["Good"],"excerpt":"Good package foo.v1; // [!code focus] ```","content":"Good package foo.v1; // [!code focus] ```"},{"id":"cli/linter/rules/rpc-no-client-streaming::top::0","title":"RPC_NO_CLIENT_STREAMING","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming","headings":[],"excerpt":"Это правило проверяет, что RPC не использует клиентский стриминг (запрос не является stream ...).","content":"Это правило проверяет, что RPC не использует клиентский стриминг (запрос не является stream ...)."},{"id":"cli/linter/rules/rpc-no-client-streaming::bad::1","title":"RPC_NO_CLIENT_STREAMING","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-no-client-streaming::bad::2","title":"RPC_NO_CLIENT_STREAMING","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar (stream BarRequest) returns (BarResponse) {} } ```","content":"Bad service Foo { rpc Bar (stream BarRequest) returns (BarResponse) {} } ```"},{"id":"cli/linter/rules/rpc-no-client-streaming::good::3","title":"RPC_NO_CLIENT_STREAMING","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-no-client-streaming::good::4","title":"RPC_NO_CLIENT_STREAMING","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-no-client-streaming#good","headings":["Good"],"excerpt":"Good service Foo { rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-no-server-streaming::top::0","title":"RPC_NO_SERVER_STREAMING","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming","headings":[],"excerpt":"Это правило проверяет, что RPC не использует серверный стриминг (ответ не является stream ...).","content":"Это правило проверяет, что RPC не использует серверный стриминг (ответ не является stream ...)."},{"id":"cli/linter/rules/rpc-no-server-streaming::bad::1","title":"RPC_NO_SERVER_STREAMING","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-no-server-streaming::bad::2","title":"RPC_NO_SERVER_STREAMING","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar (BarRequest) returns (stream BarResponse) {} } ```","content":"Bad service Foo { rpc Bar (BarRequest) returns (stream BarResponse) {} } ```"},{"id":"cli/linter/rules/rpc-no-server-streaming::good::3","title":"RPC_NO_SERVER_STREAMING","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-no-server-streaming::good::4","title":"RPC_NO_SERVER_STREAMING","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-no-server-streaming#good","headings":["Good"],"excerpt":"Good service Foo { rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc Bar (BarRequest) returns (BarResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-pascal-case::top::0","title":"RPC_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/rpc-pascal-case","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/rpc-pascal-case::top::1","title":"RPC_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/rpc-pascal-case","headings":[],"excerpt":"Это правило проверяет, что все имена RPC написаны в стиле PascalCase.","content":"Это правило проверяет, что все имена RPC написаны в стиле PascalCase."},{"id":"cli/linter/rules/rpc-pascal-case::bad::2","title":"RPC_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-pascal-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-pascal-case::bad::3","title":"RPC_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-pascal-case#bad","headings":["Bad"],"excerpt":"Bad service foo_bar { rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {} } ```","content":"Bad service foo_bar { rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {} } ```"},{"id":"cli/linter/rules/rpc-pascal-case::good::4","title":"RPC_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-pascal-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-pascal-case::good::5","title":"RPC_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-pascal-case#good","headings":["Good"],"excerpt":"Good service FooBar { rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} // [!code focus] } ```","content":"Good service FooBar { rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-request-response-unique::top::0","title":"RPC_REQUEST_RESPONSE_UNIQUE","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/rpc-request-response-unique::top::1","title":"RPC_REQUEST_RESPONSE_UNIQUE","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique","headings":[],"excerpt":"Это правило проверяет, что все сообщения запроса и ответа RPC уникальны: для каждого метода используются собственные (не переиспользуются одинаковые пары Request / Response у разных RPC).","content":"Это правило проверяет, что все сообщения запроса и ответа RPC уникальны: для каждого метода используются собственные (не переиспользуются одинаковые пары Request / Response у разных RPC)."},{"id":"cli/linter/rules/rpc-request-response-unique::bad::2","title":"RPC_REQUEST_RESPONSE_UNIQUE","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-request-response-unique::bad::3","title":"RPC_REQUEST_RESPONSE_UNIQUE","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} rpc GetBar (FooRequest) returns (FooResponse) {} } ```","content":"Bad service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} rpc GetBar (FooRequest) returns (FooResponse) {} } ```"},{"id":"cli/linter/rules/rpc-request-response-unique::good::4","title":"RPC_REQUEST_RESPONSE_UNIQUE","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-request-response-unique::good::5","title":"RPC_REQUEST_RESPONSE_UNIQUE","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-request-response-unique#good","headings":["Good"],"excerpt":"Good service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} // [!code focus] rpc GetBar (BarRequest) returns (BarResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} // [!code focus] rpc GetBar (BarRequest) returns (BarResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-request-standard-name::top::0","title":"RPC_REQUEST_STANDARD_NAME","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name","headings":[],"excerpt":"Категории: **MINIMAL** **BASIC** **DEFAULT**","content":"Категории: **MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/rpc-request-standard-name::top::1","title":"RPC_REQUEST_STANDARD_NAME","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name","headings":[],"excerpt":"Это правило проверяет, что все сообщения запроса RPC названы в формате MethodRequest.","content":"Это правило проверяет, что все сообщения запроса RPC названы в формате MethodRequest."},{"id":"cli/linter/rules/rpc-request-standard-name::bad::2","title":"RPC_REQUEST_STANDARD_NAME","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-request-standard-name::bad::3","title":"RPC_REQUEST_STANDARD_NAME","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} } ```","content":"Bad service Foo { rpc GetFoo (FooRequest) returns (FooResponse) {} } ```"},{"id":"cli/linter/rules/rpc-request-standard-name::good::4","title":"RPC_REQUEST_STANDARD_NAME","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-request-standard-name::good::5","title":"RPC_REQUEST_STANDARD_NAME","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-request-standard-name#good","headings":["Good"],"excerpt":"Good service Foo { rpc GetFoo (GetFooRequest) returns (FooResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc GetFoo (GetFooRequest) returns (FooResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/rpc-response-standard-name::top::0","title":"RPC_RESPONSE_STANDARD_NAME","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/rpc-response-standard-name::top::1","title":"RPC_RESPONSE_STANDARD_NAME","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name","headings":[],"excerpt":"Это правило проверяет, что все сообщения ответа RPC названы в формате MethodResponse.","content":"Это правило проверяет, что все сообщения ответа RPC названы в формате MethodResponse."},{"id":"cli/linter/rules/rpc-response-standard-name::bad::2","title":"RPC_RESPONSE_STANDARD_NAME","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-response-standard-name::bad::3","title":"RPC_RESPONSE_STANDARD_NAME","section":"Bad","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc GetFoo (GetFooRequest) returns (Foo) {} } ```","content":"Bad service Foo { rpc GetFoo (GetFooRequest) returns (Foo) {} } ```"},{"id":"cli/linter/rules/rpc-response-standard-name::good::4","title":"RPC_RESPONSE_STANDARD_NAME","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/rpc-response-standard-name::good::5","title":"RPC_RESPONSE_STANDARD_NAME","section":"Good","path":"/docs/guide/cli/linter/rules/rpc-response-standard-name#good","headings":["Good"],"excerpt":"Good service Foo { rpc GetFoo (GetFooRequest) returns (GetFooResponse) {} // [!code focus] } ```","content":"Good service Foo { rpc GetFoo (GetFooRequest) returns (GetFooResponse) {} // [!code focus] } ```"},{"id":"cli/linter/rules/service-pascal-case::top::0","title":"SERVICE_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/service-pascal-case","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/service-pascal-case::top::1","title":"SERVICE_PASCAL_CASE","path":"/docs/guide/cli/linter/rules/service-pascal-case","headings":[],"excerpt":"Это правило проверяет, что все имена сервисов написаны в стиле PascalCase.","content":"Это правило проверяет, что все имена сервисов написаны в стиле PascalCase."},{"id":"cli/linter/rules/service-pascal-case::bad::2","title":"SERVICE_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/service-pascal-case#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/service-pascal-case::bad::3","title":"SERVICE_PASCAL_CASE","section":"Bad","path":"/docs/guide/cli/linter/rules/service-pascal-case#bad","headings":["Bad"],"excerpt":"Bad service foo_bar { rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {} } ```","content":"Bad service foo_bar { rpc get_foo_bar (FooBarRequest) returns (FooBarResponse) {} } ```"},{"id":"cli/linter/rules/service-pascal-case::good::4","title":"SERVICE_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/service-pascal-case#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/service-pascal-case::good::5","title":"SERVICE_PASCAL_CASE","section":"Good","path":"/docs/guide/cli/linter/rules/service-pascal-case#good","headings":["Good"],"excerpt":"Good service FooBar { // [!code focus] rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} } ```","content":"Good service FooBar { // [!code focus] rpc GetFooBar (FooBarRequest) returns (FooBarResponse) {} } ```"},{"id":"cli/linter/rules/service-suffix::top::0","title":"SERVICE_SUFFIX","path":"/docs/guide/cli/linter/rules/service-suffix","headings":[],"excerpt":"**MINIMAL** **BASIC** **DEFAULT**","content":"**MINIMAL** **BASIC** **DEFAULT**"},{"id":"cli/linter/rules/service-suffix::top::1","title":"SERVICE_SUFFIX","path":"/docs/guide/cli/linter/rules/service-suffix","headings":[],"excerpt":"Это правило проверяет, что все сервисы имеют суффикс Service или ваш пользовательский суффикс.","content":"Это правило проверяет, что все сервисы имеют суффикс Service или ваш пользовательский суффикс."},{"id":"cli/linter/rules/service-suffix::bad::2","title":"SERVICE_SUFFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/service-suffix#bad","headings":["Bad"],"excerpt":"Bad ```proto syntax = \"proto3\";","content":"Bad ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/service-suffix::bad::3","title":"SERVICE_SUFFIX","section":"Bad","path":"/docs/guide/cli/linter/rules/service-suffix#bad","headings":["Bad"],"excerpt":"Bad service Foo { rpc Bar(BarRequest) returns (BarResponse); } ```","content":"Bad service Foo { rpc Bar(BarRequest) returns (BarResponse); } ```"},{"id":"cli/linter/rules/service-suffix::good::4","title":"SERVICE_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/service-suffix#good","headings":["Good"],"excerpt":"Good ```proto syntax = \"proto3\";","content":"Good ```proto syntax = \"proto3\";"},{"id":"cli/linter/rules/service-suffix::good::5","title":"SERVICE_SUFFIX","section":"Good","path":"/docs/guide/cli/linter/rules/service-suffix#good","headings":["Good"],"excerpt":"Good service FooService { // [!code focus] rpc Bar(BarRequest) returns (BarResponse); } ```","content":"Good service FooService { // [!code focus] rpc Bar(BarRequest) returns (BarResponse); } ```"},{"id":"cli/package-manager/easyp-vs-buf::top::0","title":"EasyP против Buf: управление пакетами","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":[],"excerpt":"EasyP против Buf: управление пакетами","content":"EasyP против Buf: управление пакетами"},{"id":"cli/package-manager/easyp-vs-buf::top::1","title":"EasyP против Buf: управление пакетами","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":[],"excerpt":"Этот документ даёт подробное сравнение децентрализованного подхода EasyP к управлению пакетами и централизованной модели Buf через Buf Schema Registry (BSR), чтобы помочь понять ключевые различия и выбрать подходящее реш","content":"Этот документ даёт подробное сравнение децентрализованного подхода EasyP к управлению пакетами и централизованной модели Buf через Buf Schema Registry (BSR), чтобы помочь понять ключевые различия и выбрать подходящее решение для ваших задач."},{"id":"cli/package-manager/easyp-vs-buf::easyp-git::2","title":"EasyP против Buf: управление пакетами","section":"EasyP: децентрализованный подход на базе Git","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-git","headings":["EasyP: децентрализованный подход на базе Git"],"excerpt":"EasyP: децентрализованный подход на базе Git","content":"EasyP: децентрализованный подход на базе Git"},{"id":"cli/package-manager/easyp-vs-buf::buf-bsr::3","title":"EasyP против Buf: управление пакетами","section":"Buf: централизованный реестр (BSR)","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-bsr","headings":["Buf: централизованный реестр (BSR)"],"excerpt":"Buf: централизованный реестр (BSR)","content":"Buf: централизованный реестр (BSR)"},{"id":"cli/package-manager/easyp-vs-buf::top::4","title":"EasyP против Buf: управление пакетами","section":"Краткое резюме различий","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":["Краткое резюме различий"],"excerpt":"Краткое резюме различий Аспект EasyP Buf -------- ------- ----- **Архитектура** Децентрализованная (Git) Централизованная (реестр BSR) **Источник зависимостей** Любой Git репозиторий Только модули BSR **Единая точка отка","content":"Краткое резюме различий Аспект EasyP Buf -------- ------- ----- **Архитектура** Децентрализованная (Git) Централизованная (реестр BSR) **Источник зависимостей** Любой Git репозиторий Только модули BSR **Единая точка отказа** Нет Да (buf.build) **Enterprise / air‑gapped** Полная поддержка Требует доступа к BSR или приватного BSR **Аутентификация** Git (SSH / HTTPS) Токены Buf + Git **Vendor lock‑in** Отсутствует Привязка к экосистеме Buf **Частные репозитории** Нативно через Git Нужно опубликовать в BSR **Оффлайн поддержка** Полная (через vendoring) Ограничена (кэшированные модули) **Стоимость** Бесплатно (использует существующий Git) Бесплатный тариф + платные планы **Сложность настройки** Минимальная Средняя (настройка BSR)"},{"id":"cli/package-manager/easyp-vs-buf::top::5","title":"EasyP против Buf: управление пакетами","section":"Подробное сравнение возможностей","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":["Подробное сравнение возможностей"],"excerpt":"Подробное сравнение возможностей","content":"Подробное сравнение возможностей"},{"id":"cli/package-manager/easyp-vs-buf::1::6","title":"EasyP против Buf: управление пакетами","section":"1. Философия управления зависимостями","path":"/docs/guide/cli/package-manager/easyp-vs-buf#1","headings":["1. Философия управления зависимостями"],"excerpt":"Философия управления зависимостями","content":"Философия управления зависимостями"},{"id":"cli/package-manager/easyp-vs-buf::easyp-git::7","title":"EasyP против Buf: управление пакетами","section":"EasyP: «Любой Git репозиторий — это пакет»","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-git","headings":["EasyP: «Любой Git репозиторий — это пакет»"],"excerpt":"EasyP: «Любой Git репозиторий — это пакет»","content":"EasyP: «Любой Git репозиторий — это пакет»"},{"id":"cli/package-manager/easyp-vs-buf::easyp-git::8","title":"EasyP против Buf: управление пакетами","section":"EasyP: «Любой Git репозиторий — это пакет»","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-git","headings":["EasyP: «Любой Git репозиторий — это пакет»"],"excerpt":"EasyP: «Любой Git репозиторий — это пакет» **Преимущества:** ✅ Использование любого существующего репозитория сразу ✅ Не нужно «публиковать» в отдельный реестр ✅ Истинный источник версий — Git ✅ Работает с приватными сер","content":"EasyP: «Любой Git репозиторий — это пакет» **Преимущества:** ✅ Использование любого существующего репозитория сразу ✅ Не нужно «публиковать» в отдельный реестр ✅ Истинный источник версий — Git ✅ Работает с приватными серверами без доп. настроек"},{"id":"cli/package-manager/easyp-vs-buf::buf::9","title":"EasyP против Buf: управление пакетами","section":"Buf: «Сначала реестр»","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Buf: «Сначала реестр»"],"excerpt":"Buf: «Сначала реестр» **Преимущества:** ✅ Курируемые, проверенные модули ✅ Богатые метаданные и документация ✅ Визуализация графа зависимостей ✅ Принуждение семантического версионирования","content":"Buf: «Сначала реестр» **Преимущества:** ✅ Курируемые, проверенные модули ✅ Богатые метаданные и документация ✅ Визуализация графа зависимостей ✅ Принуждение семантического версионирования"},{"id":"cli/package-manager/easyp-vs-buf::buf::10","title":"EasyP против Buf: управление пакетами","section":"Buf: «Сначала реестр»","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Buf: «Сначала реестр»"],"excerpt":"Buf: «Сначала реестр» **Ограничения:** ❌ Нужно опубликовать в BSR перед использованием ❌ Требует аккаунт и аутентификацию ❌ Нельзя напрямую сослаться на произвольный Git репозиторий","content":"Buf: «Сначала реестр» **Ограничения:** ❌ Нужно опубликовать в BSR перед использованием ❌ Требует аккаунт и аутентификацию ❌ Нельзя напрямую сослаться на произвольный Git репозиторий"},{"id":"cli/package-manager/easyp-vs-buf::2-airgapped::11","title":"EasyP против Buf: управление пакетами","section":"2. Корпоративные и изолированные (air‑gapped) среды","path":"/docs/guide/cli/package-manager/easyp-vs-buf#2-airgapped","headings":["2. Корпоративные и изолированные (air‑gapped) среды"],"excerpt":"Корпоративные и изолированные (air‑gapped) среды","content":"Корпоративные и изолированные (air‑gapped) среды"},{"id":"cli/package-manager/easyp-vs-buf::easyp::12","title":"EasyP против Buf: управление пакетами","section":"EasyP: Полноценная оффлайн‑поддержка","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Полноценная оффлайн‑поддержка"],"excerpt":"EasyP: Полноценная оффлайн‑поддержка **Сценарий**: крупная компания со строгими сетевыми политиками","content":"EasyP: Полноценная оффлайн‑поддержка **Сценарий**: крупная компания со строгими сетевыми политиками"},{"id":"cli/package-manager/easyp-vs-buf::easyp::13","title":"EasyP против Buf: управление пакетами","section":"EasyP: Полноценная оффлайн‑поддержка","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Полноценная оффлайн‑поддержка"],"excerpt":"EasyP: Полноценная оффлайн‑поддержка ```bash Среда с доступом в интернет easyp mod download # Скачивает в ~/.easyp/ easyp mod vendor # Создает easyp_vendor/","content":"EasyP: Полноценная оффлайн‑поддержка ```bash Среда с доступом в интернет easyp mod download # Скачивает в ~/.easyp/ easyp mod vendor # Создает easyp_vendor/"},{"id":"cli/package-manager/easyp-vs-buf::easyp::14","title":"EasyP против Buf: управление пакетами","section":"EasyP: Полноценная оффлайн‑поддержка","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Полноценная оффлайн‑поддержка"],"excerpt":"EasyP: Полноценная оффлайн‑поддержка Перенос в изолированный сегмент tar -czf easyp-deps.tar.gz ~/.easyp easyp_vendor/ ... перенос архива ...","content":"EasyP: Полноценная оффлайн‑поддержка Перенос в изолированный сегмент tar -czf easyp-deps.tar.gz ~/.easyp easyp_vendor/ ... перенос архива ..."},{"id":"cli/package-manager/easyp-vs-buf::easyp::15","title":"EasyP против Buf: управление пакетами","section":"EasyP: Полноценная оффлайн‑поддержка","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Полноценная оффлайн‑поддержка"],"excerpt":"EasyP: Полноценная оффлайн‑поддержка В изолированной среде tar -xzf easyp-deps.tar.gz export EASYPPATH=$PWD/.easyp easyp generate # Работает оффлайн ```","content":"EasyP: Полноценная оффлайн‑поддержка В изолированной среде tar -xzf easyp-deps.tar.gz export EASYPPATH=$PWD/.easyp easyp generate # Работает оффлайн ```"},{"id":"cli/package-manager/easyp-vs-buf::easyp::16","title":"EasyP против Buf: управление пакетами","section":"EasyP: Полноценная оффлайн‑поддержка","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Полноценная оффлайн‑поддержка"],"excerpt":"EasyP: Полноценная оффлайн‑поддержка **Плюсы:** ✅ Не зависит от внешних сервисов ✅ Не нужен внутренний реестр ✅ Использует существующую Git инфраструктуру ✅ Простая файловая дистрибуция","content":"EasyP: Полноценная оффлайн‑поддержка **Плюсы:** ✅ Не зависит от внешних сервисов ✅ Не нужен внутренний реестр ✅ Использует существующую Git инфраструктуру ✅ Простая файловая дистрибуция"},{"id":"cli/package-manager/easyp-vs-buf::buf::17","title":"EasyP против Buf: управление пакетами","section":"Buf: Требует инфраструктуру реестра","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Buf: Требует инфраструктуру реестра"],"excerpt":"Buf: Требует инфраструктуру реестра ```bash Вариант 1: использовать buf.build (нужен интернет) buf mod download","content":"Buf: Требует инфраструктуру реестра ```bash Вариант 1: использовать buf.build (нужен интернет) buf mod download"},{"id":"cli/package-manager/easyp-vs-buf::buf::18","title":"EasyP против Buf: управление пакетами","section":"Buf: Требует инфраструктуру реестра","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Buf: Требует инфраструктуру реестра"],"excerpt":"Buf: Требует инфраструктуру реестра Вариант 2: поднимать приватный BSR (сложно) Развернуть сервер реестра Перепубликовать все модули внутрь Настроить доступы, аутентификацию Поддерживать работоспособность ```","content":"Buf: Требует инфраструктуру реестра Вариант 2: поднимать приватный BSR (сложно) Развернуть сервер реестра Перепубликовать все модули внутрь Настроить доступы, аутентификацию Поддерживать работоспособность ```"},{"id":"cli/package-manager/easyp-vs-buf::buf::19","title":"EasyP против Buf: управление пакетами","section":"Buf: Требует инфраструктуру реестра","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Buf: Требует инфраструктуру реестра"],"excerpt":"Buf: Требует инфраструктуру реестра **Минусы:** ❌ Постоянный интернет или дорогой приватный BSR ❌ Сложная инфраструктура для частных установок ❌ Все модули нужно републиковать ❌ Дополнительные операционные затраты","content":"Buf: Требует инфраструктуру реестра **Минусы:** ❌ Постоянный интернет или дорогой приватный BSR ❌ Сложная инфраструктура для частных установок ❌ Все модули нужно републиковать ❌ Дополнительные операционные затраты"},{"id":"cli/package-manager/easyp-vs-buf::easyp::20","title":"EasyP против Buf: управление пакетами","section":"EasyP: Прямой контроль","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Прямой контроль"],"excerpt":"EasyP: Прямой контроль ```yaml Полный контроль источников deps: # Публичный репозиторий — ваша конкретная версия - github.com/googleapis/googleapis@common-protos-1_3_1","content":"EasyP: Прямой контроль ```yaml Полный контроль источников deps: # Публичный репозиторий — ваша конкретная версия - github.com/googleapis/googleapis@common-protos-1_3_1"},{"id":"cli/package-manager/easyp-vs-buf::easyp::21","title":"EasyP против Buf: управление пакетами","section":"EasyP: Прямой контроль","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Прямой контроль"],"excerpt":"EasyP: Прямой контроль Внутренний репозиторий - gitlab.company.com/security/validated-protos@v1.0.0","content":"EasyP: Прямой контроль Внутренний репозиторий - gitlab.company.com/security/validated-protos@v1.0.0"},{"id":"cli/package-manager/easyp-vs-buf::easyp::22","title":"EasyP против Buf: управление пакетами","section":"EasyP: Прямой контроль","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Прямой контроль"],"excerpt":"EasyP: Прямой контроль Точный коммит (горячий фикс) - github.com/bufbuild/protoc-gen-validate@abc123def456 ```","content":"EasyP: Прямой контроль Точный коммит (горячий фикс) - github.com/bufbuild/protoc-gen-validate@abc123def456 ```"},{"id":"cli/package-manager/easyp-vs-buf::easyp::23","title":"EasyP против Buf: управление пакетами","section":"EasyP: Прямой контроль","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Прямой контроль"],"excerpt":"EasyP: Прямой контроль **Преимущества по безопасности:** ✅ Нет посредника — берём из исходного репозитория ✅ Аудит через историю Git ✅ Нельзя «забанить» доступ извне ✅ Свои процессы сканирования / валидации ✅ Можно форкн","content":"EasyP: Прямой контроль **Преимущества по безопасности:** ✅ Нет посредника — берём из исходного репозитория ✅ Аудит через историю Git ✅ Нельзя «забанить» доступ извне ✅ Свои процессы сканирования / валидации ✅ Можно форкнуть и удерживать критические версии"},{"id":"cli/package-manager/easyp-vs-buf::buf::24","title":"EasyP против Buf: управление пакетами","section":"Buf: Зависимость от реестра","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Buf: Зависимость от реестра"],"excerpt":"Buf: Зависимость от реестра **Риски:** ⚠️ Посредник контролирует доступность ⚠️ Возможны ограничения / санкции на аккаунт ⚠️ Модуль могут удалить или депрекейтнуть ⚠️ Политики обновлений диктуются стороной ⚠️ Нужно довер","content":"Buf: Зависимость от реестра **Риски:** ⚠️ Посредник контролирует доступность ⚠️ Возможны ограничения / санкции на аккаунт ⚠️ Модуль могут удалить или депрекейтнуть ⚠️ Политики обновлений диктуются стороной ⚠️ Нужно доверять внешней безопасности"},{"id":"cli/package-manager/easyp-vs-buf::1::25","title":"EasyP против Buf: управление пакетами","section":"Сценарий 1: Стартап с публичными зависимостями","path":"/docs/guide/cli/package-manager/easyp-vs-buf#1","headings":["Сценарий 1: Стартап с публичными зависимостями"],"excerpt":"Сценарий 1: Стартап с публичными зависимостями **EasyP:**","content":"Сценарий 1: Стартап с публичными зависимостями **EasyP:**"},{"id":"cli/package-manager/easyp-vs-buf::1::26","title":"EasyP против Buf: управление пакетами","section":"Сценарий 1: Стартап с публичными зависимостями","path":"/docs/guide/cli/package-manager/easyp-vs-buf#1","headings":["Сценарий 1: Стартап с публичными зависимостями"],"excerpt":"Сценарий 1: Стартап с публичными зависимостями **Buf:**","content":"Сценарий 1: Стартап с публичными зависимостями **Buf:**"},{"id":"cli/package-manager/easyp-vs-buf::1::27","title":"EasyP против Buf: управление пакетами","section":"Сценарий 1: Стартап с публичными зависимостями","path":"/docs/guide/cli/package-manager/easyp-vs-buf#1","headings":["Сценарий 1: Стартап с публичными зависимостями"],"excerpt":"Сценарий 1: Стартап с публичными зависимостями **Итог:** Паритет — оба хорошо подходят для публичных пакетов.","content":"Сценарий 1: Стартап с публичными зависимостями **Итог:** Паритет — оба хорошо подходят для публичных пакетов."},{"id":"cli/package-manager/easyp-vs-buf::2::28","title":"EasyP против Buf: управление пакетами","section":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями","path":"/docs/guide/cli/package-manager/easyp-vs-buf#2","headings":["Сценарий 2: Компания со смешанными публичными/приватными зависимостями"],"excerpt":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями **EasyP:**","content":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями **EasyP:**"},{"id":"cli/package-manager/easyp-vs-buf::2::29","title":"EasyP против Buf: управление пакетами","section":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями","path":"/docs/guide/cli/package-manager/easyp-vs-buf#2","headings":["Сценарий 2: Компания со смешанными публичными/приватными зависимостями"],"excerpt":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями **Buf:**","content":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями **Buf:**"},{"id":"cli/package-manager/easyp-vs-buf::2::30","title":"EasyP против Buf: управление пакетами","section":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями","path":"/docs/guide/cli/package-manager/easyp-vs-buf#2","headings":["Сценарий 2: Компания со смешанными публичными/приватными зависимостями"],"excerpt":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями **Итог:** **EasyP** — не требует публикации внутрь BSR.","content":"Сценарий 2: Компания со смешанными публичными/приватными зависимостями **Итог:** **EasyP** — не требует публикации внутрь BSR."},{"id":"cli/package-manager/easyp-vs-buf::3-airgap::31","title":"EasyP против Buf: управление пакетами","section":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap)","path":"/docs/guide/cli/package-manager/easyp-vs-buf#3-airgap","headings":["Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap)"],"excerpt":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap) **EasyP:**","content":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap) **EasyP:**"},{"id":"cli/package-manager/easyp-vs-buf::3-airgap::32","title":"EasyP против Buf: управление пакетами","section":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap)","path":"/docs/guide/cli/package-manager/easyp-vs-buf#3-airgap","headings":["Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap)"],"excerpt":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap) **Buf:**","content":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap) **Buf:**"},{"id":"cli/package-manager/easyp-vs-buf::3-airgap::33","title":"EasyP против Buf: управление пакетами","section":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap)","path":"/docs/guide/cli/package-manager/easyp-vs-buf#3-airgap","headings":["Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap)"],"excerpt":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap) **Итог:** **EasyP** — значительно проще.","content":"Сценарий 3: Государственный / оборонный подрядчик (полный air‑gap) **Итог:** **EasyP** — значительно проще."},{"id":"cli/package-manager/easyp-vs-buf::4::34","title":"EasyP против Buf: управление пакетами","section":"Сценарий 4: Комплаенс и аудит","path":"/docs/guide/cli/package-manager/easyp-vs-buf#4","headings":["Сценарий 4: Комплаенс и аудит"],"excerpt":"Сценарий 4: Комплаенс и аудит **EasyP:** ✅ Прямой аудит изменений (коммиты) ✅ Нет внешних точек зависимости в проде ✅ Повторяемость через фиксированные коммиты / vendor ✅ Управление уязвимостями — в ваших руках","content":"Сценарий 4: Комплаенс и аудит **EasyP:** ✅ Прямой аудит изменений (коммиты) ✅ Нет внешних точек зависимости в проде ✅ Повторяемость через фиксированные коммиты / vendor ✅ Управление уязвимостями — в ваших руках"},{"id":"cli/package-manager/easyp-vs-buf::4::35","title":"EasyP против Buf: управление пакетами","section":"Сценарий 4: Комплаенс и аудит","path":"/docs/guide/cli/package-manager/easyp-vs-buf#4","headings":["Сценарий 4: Комплаенс и аудит"],"excerpt":"Сценарий 4: Комплаенс и аудит **Buf:** ⚠️ Нужно учитывать BSR в области аудита ⚠️ Дополнительный риск третьей стороны ⚠️ Модули — внешние контролируемые артефакты ⚠️ Сложнее трассировать от реестра к исходникам","content":"Сценарий 4: Комплаенс и аудит **Buf:** ⚠️ Нужно учитывать BSR в области аудита ⚠️ Дополнительный риск третьей стороны ⚠️ Модули — внешние контролируемые артефакты ⚠️ Сложнее трассировать от реестра к исходникам"},{"id":"cli/package-manager/easyp-vs-buf::4::36","title":"EasyP против Buf: управление пакетами","section":"Сценарий 4: Комплаенс и аудит","path":"/docs/guide/cli/package-manager/easyp-vs-buf#4","headings":["Сценарий 4: Комплаенс и аудит"],"excerpt":"Сценарий 4: Комплаенс и аудит **Итог:** **EasyP** — проще для комплаенса.","content":"Сценарий 4: Комплаенс и аудит **Итог:** **EasyP** — проще для комплаенса."},{"id":"cli/package-manager/easyp-vs-buf::easyp::37","title":"EasyP против Buf: управление пакетами","section":"EasyP: Нулевая дополнительная инфраструктура","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Нулевая дополнительная инфраструктура"],"excerpt":"EasyP: Нулевая дополнительная инфраструктура **Затраты:** ✅ $0 — используете существующий Git ✅ Нет дополнительных сервисов/серверов ✅ Нет лицензирования ✅ Масштабирование в рамках Git","content":"EasyP: Нулевая дополнительная инфраструктура **Затраты:** ✅ $0 — используете существующий Git ✅ Нет дополнительных сервисов/серверов ✅ Нет лицензирования ✅ Масштабирование в рамках Git"},{"id":"cli/package-manager/easyp-vs-buf::easyp::38","title":"EasyP против Buf: управление пакетами","section":"EasyP: Нулевая дополнительная инфраструктура","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Нулевая дополнительная инфраструктура"],"excerpt":"EasyP: Нулевая дополнительная инфраструктура **Инфраструктура:** Использует текущие репозитории (GitHub/GitLab/и т.д.) Аутентификация — штатная Резервирование/DR — как уже настроено для Git","content":"EasyP: Нулевая дополнительная инфраструктура **Инфраструктура:** Использует текущие репозитории (GitHub/GitLab/и т.д.) Аутентификация — штатная Резервирование/DR — как уже настроено для Git"},{"id":"cli/package-manager/easyp-vs-buf::buf::39","title":"EasyP против Buf: управление пакетами","section":"Buf: Затраты на реестр","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Buf: Затраты на реестр"],"excerpt":"Buf: Затраты на реестр **Hosted BSR (buf.build):** ✅ Бесплатный уровень ❌ Платные тарифы для приватного и расширенного использования ❌ Потенциальные изменения ценовой политики ❌ Вопросы локализации данных","content":"Buf: Затраты на реестр **Hosted BSR (buf.build):** ✅ Бесплатный уровень ❌ Платные тарифы для приватного и расширенного использования ❌ Потенциальные изменения ценовой политики ❌ Вопросы локализации данных"},{"id":"cli/package-manager/easyp-vs-buf::buf::40","title":"EasyP против Buf: управление пакетами","section":"Buf: Затраты на реестр","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Buf: Затраты на реестр"],"excerpt":"Buf: Затраты на реестр **Приватный BSR:** ❌ Серверы, БД, балансировка ❌ Мониторинг, обновления, бэкапы ❌ Лицензирование enterprise функционала ❌ Доп. планирование отказоустойчивости","content":"Buf: Затраты на реестр **Приватный BSR:** ❌ Серверы, БД, балансировка ❌ Мониторинг, обновления, бэкапы ❌ Лицензирование enterprise функционала ❌ Доп. планирование отказоустойчивости"},{"id":"cli/package-manager/easyp-vs-buf::easyp::41","title":"EasyP против Buf: управление пакетами","section":"EasyP: Нет привязки","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Нет привязки"],"excerpt":"EasyP: Нет привязки **Миграция ИЗ EasyP:** (Обычные Git ссылки — легко перенести в другой инструмент.)","content":"EasyP: Нет привязки **Миграция ИЗ EasyP:** (Обычные Git ссылки — легко перенести в другой инструмент.)"},{"id":"cli/package-manager/easyp-vs-buf::easyp::42","title":"EasyP против Buf: управление пакетами","section":"EasyP: Нет привязки","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["EasyP: Нет привязки"],"excerpt":"EasyP: Нет привязки **Миграция В EasyP:**","content":"EasyP: Нет привязки **Миграция В EasyP:**"},{"id":"cli/package-manager/easyp-vs-buf::buf-lockin::43","title":"EasyP против Buf: управление пакетами","section":"Buf: Потенциальный lock‑in","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-lockin","headings":["Buf: Потенциальный lock‑in"],"excerpt":"Buf: Потенциальный lock‑in **Миграция ИЗ Buf:** ❌ Нужно сопоставить BSR модули с исходными Git репо ❌ Имена модулей BSR не совпадают с URL ❌ Возможна потеря удобных метаданных ❌ Сложно при глубокой интеграции с BSR","content":"Buf: Потенциальный lock‑in **Миграция ИЗ Buf:** ❌ Нужно сопоставить BSR модули с исходными Git репо ❌ Имена модулей BSR не совпадают с URL ❌ Возможна потеря удобных метаданных ❌ Сложно при глубокой интеграции с BSR"},{"id":"cli/package-manager/easyp-vs-buf::buf-lockin::44","title":"EasyP против Buf: управление пакетами","section":"Buf: Потенциальный lock‑in","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-lockin","headings":["Buf: Потенциальный lock‑in"],"excerpt":"Buf: Потенциальный lock‑in **Миграция В Buf:** ❌ Нужно опубликовать всё в BSR ❌ Нельзя ссылаться напрямую на Git ❌ Принять workflow BSR (push/pull модулей)","content":"Buf: Потенциальный lock‑in **Миграция В Buf:** ❌ Нужно опубликовать всё в BSR ❌ Нельзя ссылаться напрямую на Git ❌ Принять workflow BSR (push/pull модулей)"},{"id":"cli/package-manager/easyp-vs-buf::easyp::45","title":"EasyP против Buf: управление пакетами","section":"Выберите EasyP, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["Выберите EasyP, если:"],"excerpt":"Выберите EasyP, если: ✅ **Air‑gapped / закрытые среды** Нужна работа без внешних сервисов Строгий комплаенс / контроль цепочки поставок","content":"Выберите EasyP, если: ✅ **Air‑gapped / закрытые среды** Нужна работа без внешних сервисов Строгий комплаенс / контроль цепочки поставок"},{"id":"cli/package-manager/easyp-vs-buf::easyp::46","title":"EasyP против Buf: управление пакетами","section":"Выберите EasyP, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["Выберите EasyP, если:"],"excerpt":"Выберите EasyP, если: ✅ **Фокус на безопасности** Контроль источников зависимостей Минимизация рисков третьих сторон","content":"Выберите EasyP, если: ✅ **Фокус на безопасности** Контроль источников зависимостей Минимизация рисков третьих сторон"},{"id":"cli/package-manager/easyp-vs-buf::easyp::47","title":"EasyP против Buf: управление пакетами","section":"Выберите EasyP, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["Выберите EasyP, если:"],"excerpt":"Выберите EasyP, если: ✅ **Git‑центричная культура** Частные репозитории — норма Не хотите добавлять новый ключевой сервис","content":"Выберите EasyP, если: ✅ **Git‑центричная культура** Частные репозитории — норма Не хотите добавлять новый ключевой сервис"},{"id":"cli/package-manager/easyp-vs-buf::easyp::48","title":"EasyP против Buf: управление пакетами","section":"Выберите EasyP, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["Выберите EasyP, если:"],"excerpt":"Выберите EasyP, если: ✅ **Ограниченный бюджет** Минимизация операционных расходов Предсказуемая стоимость = 0","content":"Выберите EasyP, если: ✅ **Ограниченный бюджет** Минимизация операционных расходов Предсказуемая стоимость = 0"},{"id":"cli/package-manager/easyp-vs-buf::easyp::49","title":"EasyP против Buf: управление пакетами","section":"Выберите EasyP, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp","headings":["Выберите EasyP, если:"],"excerpt":"Выберите EasyP, если: ✅ **Смешанные публичные/частные зависимости** Не хотите перекладывать всё в реестр Нужна гибкость форматов и размещения","content":"Выберите EasyP, если: ✅ **Смешанные публичные/частные зависимости** Не хотите перекладывать всё в реестр Нужна гибкость форматов и размещения"},{"id":"cli/package-manager/easyp-vs-buf::buf::50","title":"EasyP против Buf: управление пакетами","section":"Выберите Buf, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Выберите Buf, если:"],"excerpt":"Выберите Buf, если: ✅ **Глубокая интеграция в экосистему BSR** Уже используете линтеры / генерацию Buf Нужны курируемые официальные модули Важны метаданные и граф зависимостей","content":"Выберите Buf, если: ✅ **Глубокая интеграция в экосистему BSR** Уже используете линтеры / генерацию Buf Нужны курируемые официальные модули Важны метаданные и граф зависимостей"},{"id":"cli/package-manager/easyp-vs-buf::buf::51","title":"EasyP против Buf: управление пакетами","section":"Выберите Buf, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Выберите Buf, если:"],"excerpt":"Выберите Buf, если: ✅ **Сотрудничество и открытая разработка** Централизованное обнаружение модулей Совместная работа над общими пакетами","content":"Выберите Buf, если: ✅ **Сотрудничество и открытая разработка** Централизованное обнаружение модулей Совместная работа над общими пакетами"},{"id":"cli/package-manager/easyp-vs-buf::buf::52","title":"EasyP против Buf: управление пакетами","section":"Выберите Buf, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Выберите Buf, если:"],"excerpt":"Выберите Buf, если: ✅ **Команда новичков в protobuf** Требуется «направляющая» структура Ценность документации внутри реестра","content":"Выберите Buf, если: ✅ **Команда новичков в protobuf** Требуется «направляющая» структура Ценность документации внутри реестра"},{"id":"cli/package-manager/easyp-vs-buf::buf::53","title":"EasyP против Buf: управление пакетами","section":"Выберите Buf, если:","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf","headings":["Выберите Buf, если:"],"excerpt":"Выберите Buf, если: ✅ **Небольшой набор публичных зависимостей** В основном используете популярные общие пакеты Вас устраивает зависимость от BSR","content":"Выберите Buf, если: ✅ **Небольшой набор публичных зависимостей** В основном используете популярные общие пакеты Вас устраивает зависимость от BSR"},{"id":"cli/package-manager/easyp-vs-buf::buf-easyp::54","title":"EasyP против Buf: управление пакетами","section":"Переход с Buf на EasyP","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-easyp","headings":["Переход с Buf на EasyP"],"excerpt":"Переход с Buf на EasyP Найдите исходные Git репозитории для каждого модуля BSR Сопоставьте имена BSR → Git ссылки (с версиями/тегами) Обновите конфигурацию (easyp.yaml) Протестируйте генерацию и совместимость","content":"Переход с Buf на EasyP Найдите исходные Git репозитории для каждого модуля BSR Сопоставьте имена BSR → Git ссылки (с версиями/тегами) Обновите конфигурацию (easyp.yaml) Протестируйте генерацию и совместимость"},{"id":"cli/package-manager/easyp-vs-buf::buf-easyp::55","title":"EasyP против Buf: управление пакетами","section":"Переход с Buf на EasyP","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-easyp","headings":["Переход с Buf на EasyP"],"excerpt":"Переход с Buf на EasyP ```yaml Было (buf.yaml) deps: - buf.build/googleapis/googleapis - buf.build/grpc/grpc","content":"Переход с Buf на EasyP ```yaml Было (buf.yaml) deps: - buf.build/googleapis/googleapis - buf.build/grpc/grpc"},{"id":"cli/package-manager/easyp-vs-buf::buf-easyp::56","title":"EasyP против Buf: управление пакетами","section":"Переход с Buf на EasyP","path":"/docs/guide/cli/package-manager/easyp-vs-buf#buf-easyp","headings":["Переход с Buf на EasyP"],"excerpt":"Переход с Buf на EasyP Стало (easyp.yaml) deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc/grpc@v1.50.0 ```","content":"Переход с Buf на EasyP Стало (easyp.yaml) deps: - github.com/googleapis/googleapis@common-protos-1_3_1 - github.com/grpc/grpc@v1.50.0 ```"},{"id":"cli/package-manager/easyp-vs-buf::easyp-buf::57","title":"EasyP против Buf: управление пакетами","section":"Переход с EasyP на Buf","path":"/docs/guide/cli/package-manager/easyp-vs-buf#easyp-buf","headings":["Переход с EasyP на Buf"],"excerpt":"Переход с EasyP на Buf Опубликуйте используемые репозитории как модули BSR Настройте аутентификацию / организацию Buf Замените Git ссылки на BSR модули Перейдите к push/pull workflow Buf","content":"Переход с EasyP на Buf Опубликуйте используемые репозитории как модули BSR Настройте аутентификацию / организацию Buf Замените Git ссылки на BSR модули Перейдите к push/pull workflow Buf"},{"id":"cli/package-manager/easyp-vs-buf::top::58","title":"EasyP против Buf: управление пакетами","section":"Заключение","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":["Заключение"],"excerpt":"Заключение Оба инструмента решают задачу управления зависимостями protobuf, но подходят под разные приоритеты:","content":"Заключение Оба инструмента решают задачу управления зависимостями protobuf, но подходят под разные приоритеты:"},{"id":"cli/package-manager/easyp-vs-buf::top::59","title":"EasyP против Buf: управление пакетами","section":"Заключение","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":["Заключение"],"excerpt":"Заключение **Сильные стороны EasyP:** Корпоративные / изолированные среды Жёсткие требования безопасности и аудита Минимальные затраты и отсутствие доп. инфраструктуры Прямое использование Git (без промежуточного слоя) П","content":"Заключение **Сильные стороны EasyP:** Корпоративные / изолированные среды Жёсткие требования безопасности и аудита Минимальные затраты и отсутствие доп. инфраструктуры Прямое использование Git (без промежуточного слоя) Простота масштабирования"},{"id":"cli/package-manager/easyp-vs-buf::top::60","title":"EasyP против Buf: управление пакетами","section":"Заключение","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":["Заключение"],"excerpt":"Заключение **Сильные стороны Buf:** Богатая экосистема вокруг реестра Курируемые и документированные модули Удобство для новых команд в protobuf Средства визуализации и централизованного обмена","content":"Заключение **Сильные стороны Buf:** Богатая экосистема вокруг реестра Курируемые и документированные модули Удобство для новых команд в protobuf Средства визуализации и централизованного обмена"},{"id":"cli/package-manager/easyp-vs-buf::top::61","title":"EasyP против Buf: управление пакетами","section":"Заключение","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":["Заключение"],"excerpt":"Заключение Выбор часто сводится к балансу между **контролем vs. удобством**, **безопасностью vs. централизованными функциями**, и **стоимостью vs. managed‑сервисом**.","content":"Заключение Выбор часто сводится к балансу между **контролем vs. удобством**, **безопасностью vs. централизованными функциями**, и **стоимостью vs. managed‑сервисом**."},{"id":"cli/package-manager/easyp-vs-buf::top::62","title":"EasyP против Buf: управление пакетами","section":"Заключение","path":"/docs/guide/cli/package-manager/easyp-vs-buf","headings":["Заключение"],"excerpt":"Заключение Для большинства enterprise‑окружений децентрализованный Git‑подход EasyP обеспечивает нужные гибкость, безопасность и предсказуемость расходов, тогда как Buf отлично подходит командам, которым важна централизо","content":"Заключение Для большинства enterprise‑окружений децентрализованный Git‑подход EasyP обеспечивает нужные гибкость, безопасность и предсказуемость расходов, тогда как Buf отлично подходит командам, которым важна централизованная коллаборация и богатая экосистема вокруг реестра."},{"id":"cli/package-manager/package-manager::top::0","title":"Менеджер пакетов","path":"/docs/guide/cli/package-manager/package-manager","headings":[],"excerpt":"EasyP предоставляет мощный менеджер пакетов для protobuf‑зависимостей, упрощающий их управление за счёт децентрализованного подхода на базе Git. В отличие от централизованных решений, EasyP работает напрямую с Git‑репози","content":"EasyP предоставляет мощный менеджер пакетов для protobuf‑зависимостей, упрощающий их управление за счёт децентрализованного подхода на базе Git. В отличие от централизованных решений, EasyP работает напрямую с Git‑репозиториями, давая вам полный контроль."},{"id":"cli/package-manager/package-manager::top::1","title":"Менеджер пакетов","section":"Обзор","path":"/docs/guide/cli/package-manager/package-manager","headings":["Обзор"],"excerpt":"Обзор Менеджер пакетов EasyP следует философии **Go modules** — любой Git‑репозиторий может быть источником. Это даёт преимущества:","content":"Обзор Менеджер пакетов EasyP следует философии **Go modules** — любой Git‑репозиторий может быть источником. Это даёт преимущества:"},{"id":"cli/package-manager/package-manager::top::2","title":"Менеджер пакетов","section":"Обзор","path":"/docs/guide/cli/package-manager/package-manager","headings":["Обзор"],"excerpt":"Обзор **Децентрализация** — нет единой точки отказа или контроля **Безопасность** — прямой доступ к исходникам **Гибкость** — публичные, приватные и корпоративные репозитории **Воспроизводимость** — lock‑файлы обеспечива","content":"Обзор **Децентрализация** — нет единой точки отказа или контроля **Безопасность** — прямой доступ к исходникам **Гибкость** — публичные, приватные и корпоративные репозитории **Воспроизводимость** — lock‑файлы обеспечивают одинаковые сборки **Производительность** — локальный кеш сокращает сетевые запросы"},{"id":"cli/package-manager/package-manager::top::3","title":"Менеджер пакетов","section":"Основные возможности","path":"/docs/guide/cli/package-manager/package-manager","headings":["Основные возможности"],"excerpt":"Основные возможности Возможность Описание ------------- ---------- **Git-Native** Любой Git репозиторий, не нужен спец‑сервер **Множество форматов версий** Теги, коммиты, псевдо‑версии, latest **Lock Files** Воспроизводи","content":"Основные возможности Возможность Описание ------------- ---------- **Git-Native** Любой Git репозиторий, не нужен спец‑сервер **Множество форматов версий** Теги, коммиты, псевдо‑версии, latest **Lock Files** Воспроизводимые сборки через easyp.lock **Локальный кеш** Архитектура как у Go modules **Vendoring** Локальное копирование для оффлайн сборок **YAML конфигурация** Простые и читаемые декларации"},{"id":"cli/package-manager/package-manager::top::4","title":"Менеджер пакетов","section":"Архитектура","path":"/docs/guide/cli/package-manager/package-manager","headings":["Архитектура"],"excerpt":"Архитектура EasyP использует двухуровневый кеш, вдохновлённый Go modules:","content":"Архитектура EasyP использует двухуровневый кеш, вдохновлённый Go modules:"},{"id":"cli/package-manager/package-manager::top::5","title":"Менеджер пакетов","section":"Расположение кеша","path":"/docs/guide/cli/package-manager/package-manager","headings":["Расположение кеша"],"excerpt":"Расположение кеша Окружение Путь Как задать ----------- ------ ----------- **По умолчанию** $HOME/.easyp Автоматически **Свое** Любая директория Переменная EASYPPATH **CI/CD** В каталоге проекта export EASYPPATH=$CI_PROJ","content":"Расположение кеша Окружение Путь Как задать ----------- ------ ----------- **По умолчанию** $HOME/.easyp Автоматически **Свое** Любая директория Переменная EASYPPATH **CI/CD** В каталоге проекта export EASYPPATH=$CI_PROJECT_DIR/.easyp"},{"id":"cli/package-manager/package-manager::top::6","title":"Менеджер пакетов","section":"Базовая конфигурация","path":"/docs/guide/cli/package-manager/package-manager","headings":["Базовая конфигурация"],"excerpt":"Базовая конфигурация Зависимости описываются в easyp.yaml:","content":"Базовая конфигурация Зависимости описываются в easyp.yaml:"},{"id":"cli/package-manager/package-manager::multi-environment-setup::7","title":"Менеджер пакетов","section":"Multi-Environment Setup","path":"/docs/guide/cli/package-manager/package-manager#multi-environment-setup","headings":["Multi-Environment Setup"],"excerpt":"Multi-Environment Setup ```yaml development.easyp.yaml deps: - github.com/googleapis/googleapis # Последнее для разработки - github.com/mycompany/internal-protos # Внутренние изменения - github.com/bufbuild/protoc-gen-va","content":"Multi-Environment Setup ```yaml development.easyp.yaml deps: - github.com/googleapis/googleapis # Последнее для разработки - github.com/mycompany/internal-protos # Внутренние изменения - github.com/bufbuild/protoc-gen-validate # Новые фичи"},{"id":"cli/package-manager/package-manager::multi-environment-setup::8","title":"Менеджер пакетов","section":"Multi-Environment Setup","path":"/docs/guide/cli/package-manager/package-manager#multi-environment-setup","headings":["Multi-Environment Setup"],"excerpt":"Multi-Environment Setup production.easyp.yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1 # Зафиксировано - github.com/mycompany/internal-protos@v2.1.0 # Стабильно - github.com/bufbuild/protoc-gen-valida","content":"Multi-Environment Setup production.easyp.yaml deps: - github.com/googleapis/googleapis@common-protos-1_3_1 # Зафиксировано - github.com/mycompany/internal-protos@v2.1.0 # Стабильно - github.com/bufbuild/protoc-gen-validate@v0.10.1 # Проверено ```"},{"id":"cli/package-manager/package-manager::top::9","title":"Менеджер пакетов","section":"Приватные репозитории","path":"/docs/guide/cli/package-manager/package-manager","headings":["Приватные репозитории"],"excerpt":"Приватные репозитории ```yaml deps: # Публичное - github.com/googleapis/googleapis@common-protos-1_3_1","content":"Приватные репозитории ```yaml deps: # Публичное - github.com/googleapis/googleapis@common-protos-1_3_1"},{"id":"cli/package-manager/package-manager::top::10","title":"Менеджер пакетов","section":"Приватные репозитории","path":"/docs/guide/cli/package-manager/package-manager","headings":["Приватные репозитории"],"excerpt":"Приватные репозитории Частные - github.com/mycompany/auth-protos@v1.5.0 - github.com/mycompany/common-types@v2.0.1","content":"Приватные репозитории Частные - github.com/mycompany/auth-protos@v1.5.0 - github.com/mycompany/common-types@v2.0.1"},{"id":"cli/package-manager/package-manager::top::11","title":"Менеджер пакетов","section":"Приватные репозитории","path":"/docs/guide/cli/package-manager/package-manager","headings":["Приватные репозитории"],"excerpt":"Приватные репозитории Внутренний GitLab - gitlab.company.com/platform/messaging-protos@v0.3.0 ```","content":"Приватные репозитории Внутренний GitLab - gitlab.company.com/platform/messaging-protos@v0.3.0 ```"},{"id":"cli/package-manager/package-manager::top::12","title":"Менеджер пакетов","section":"Стратегии версионирования","path":"/docs/guide/cli/package-manager/package-manager","headings":["Стратегии версионирования"],"excerpt":"Стратегии версионирования Поддерживаются разные способы фиксации версий:","content":"Стратегии версионирования Поддерживаются разные способы фиксации версий:"},{"id":"cli/package-manager/package-manager::1::13","title":"Менеджер пакетов","section":"1. Семантические теги (для продакшена)","path":"/docs/guide/cli/package-manager/package-manager#1","headings":["1. Семантические теги (для продакшена)"],"excerpt":"Семантические теги (для продакшена)","content":"Семантические теги (для продакшена)"},{"id":"cli/package-manager/package-manager::1::14","title":"Менеджер пакетов","section":"1. Семантические теги (для продакшена)","path":"/docs/guide/cli/package-manager/package-manager#1","headings":["1. Семантические теги (для продакшена)"],"excerpt":"Семантические теги (для продакшена) **Используйте когда:** Продакшен Стабильное потребление API Нужна воспроизводимость","content":"Семантические теги (для продакшена) **Используйте когда:** Продакшен Стабильное потребление API Нужна воспроизводимость"},{"id":"cli/package-manager/package-manager::2-development::15","title":"Менеджер пакетов","section":"2. Последний тег (development)","path":"/docs/guide/cli/package-manager/package-manager#2-development","headings":["2. Последний тег (development)"],"excerpt":"Последний тег (development) **Подходит для:** Активной разработки Получения свежих возможностей Тестирования совместимости","content":"Последний тег (development) **Подходит для:** Активной разработки Получения свежих возможностей Тестирования совместимости"},{"id":"cli/package-manager/package-manager::3-bleeding-edge::16","title":"Менеджер пакетов","section":"3. Хеш коммита (Bleeding Edge)","path":"/docs/guide/cli/package-manager/package-manager#3-bleeding-edge","headings":["3. Хеш коммита (Bleeding Edge)"],"excerpt":"Хеш коммита (Bleeding Edge) **Когда нужно:** Нерелизные фичи Тест конкретного фикса Вклад в upstream","content":"Хеш коммита (Bleeding Edge) **Когда нужно:** Нерелизные фичи Тест конкретного фикса Вклад в upstream"},{"id":"cli/package-manager/package-manager::4::17","title":"Менеджер пакетов","section":"4. Псевдо‑версии (автоматически)","path":"/docs/guide/cli/package-manager/package-manager#4","headings":["4. Псевдо‑версии (автоматически)"],"excerpt":"Псевдо‑версии (автоматически) Если нет подходящего тега — создаётся псевдо‑версия:","content":"Псевдо‑версии (автоматически) Если нет подходящего тега — создаётся псевдо‑версия:"},{"id":"cli/package-manager/package-manager::easyp-mod-download::18","title":"Менеджер пакетов","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download Скачивает и устанавливает все объявленные зависимости.","content":"easyp mod download Скачивает и устанавливает все объявленные зависимости."},{"id":"cli/package-manager/package-manager::easyp-mod-download::19","title":"Менеджер пакетов","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download **Что делает:** Разрешает версии (теги → коммиты) Скачивает архивы в cache/download Проверяет контрольные суммы Распаковывает в cache/mod Обновляет easyp.lock","content":"easyp mod download **Что делает:** Разрешает версии (теги → коммиты) Скачивает архивы в cache/download Проверяет контрольные суммы Распаковывает в cache/mod Обновляет easyp.lock"},{"id":"cli/package-manager/package-manager::easyp-mod-download::20","title":"Менеджер пакетов","section":"easyp mod download","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-download","headings":["easyp mod download"],"excerpt":"easyp mod download **Пример:**","content":"easyp mod download **Пример:**"},{"id":"cli/package-manager/package-manager::easyp-mod-vendor::21","title":"Менеджер пакетов","section":"easyp mod vendor","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor Копирует все proto зависимости в локальный easyp_vendor/ для оффлайна.","content":"easyp mod vendor Копирует все proto зависимости в локальный easyp_vendor/ для оффлайна."},{"id":"cli/package-manager/package-manager::easyp-mod-vendor::22","title":"Менеджер пакетов","section":"easyp mod vendor","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-vendor","headings":["easyp mod vendor"],"excerpt":"easyp mod vendor **Сценарии:** Docker сборки Air-gapped окружения Воспроизводимость Ускорение","content":"easyp mod vendor **Сценарии:** Docker сборки Air-gapped окружения Воспроизводимость Ускорение"},{"id":"cli/package-manager/package-manager::easyp-mod-update::23","title":"Менеджер пакетов","section":"easyp mod update","path":"/docs/guide/cli/package-manager/package-manager#easyp-mod-update","headings":["easyp mod update"],"excerpt":"easyp mod update Обновляет версии согласно easyp.yaml, пересоздаёт lock.","content":"easyp mod update Обновляет версии согласно easyp.yaml, пересоздаёт lock."},{"id":"cli/package-manager/package-manager::lock::24","title":"Менеджер пакетов","section":"Lock файл","path":"/docs/guide/cli/package-manager/package-manager#lock","headings":["Lock файл"],"excerpt":"Lock файл easyp.lock фиксирует точные версии и хеш содержимого:","content":"Lock файл easyp.lock фиксирует точные версии и хеш содержимого:"},{"id":"cli/package-manager/package-manager::lock::25","title":"Менеджер пакетов","section":"Lock файл","path":"/docs/guide/cli/package-manager/package-manager#lock","headings":["Lock файл"],"excerpt":"Lock файл **Формат строки:** Путь модуля Версия (тег или псевдо) Хеш содержимого (h1:)","content":"Lock файл **Формат строки:** Путь модуля Версия (тег или псевдо) Хеш содержимого (h1:)"},{"id":"cli/package-manager/package-manager::lock::26","title":"Менеджер пакетов","section":"Lock файл","path":"/docs/guide/cli/package-manager/package-manager#lock","headings":["Lock файл"],"excerpt":"Lock файл **Практики:** ✅ Коммитить easyp.lock ✅ Осознанно обновлять mod update ✅ Ревью изменений версий ❌ Не редактировать вручную","content":"Lock файл **Практики:** ✅ Коммитить easyp.lock ✅ Осознанно обновлять mod update ✅ Ревью изменений версий ❌ Не редактировать вручную"},{"id":"cli/package-manager/package-manager::top::27","title":"Менеджер пакетов","section":"Публичные репозитории","path":"/docs/guide/cli/package-manager/package-manager","headings":["Публичные репозитории"],"excerpt":"Публичные репозитории Работают без настроек:","content":"Публичные репозитории Работают без настроек:"},{"id":"cli/package-manager/package-manager::ssh::28","title":"Менеджер пакетов","section":"SSH ключи (рекомендуется)","path":"/docs/guide/cli/package-manager/package-manager#ssh","headings":["SSH ключи (рекомендуется)"],"excerpt":"SSH ключи (рекомендуется) Конфиг остаётся с HTTPS URL:","content":"SSH ключи (рекомендуется) Конфиг остаётся с HTTPS URL:"},{"id":"cli/package-manager/package-manager::personal-access-tokens::29","title":"Менеджер пакетов","section":"Personal Access Tokens","path":"/docs/guide/cli/package-manager/package-manager#personal-access-tokens","headings":["Personal Access Tokens"],"excerpt":"Personal Access Tokens ```bash git config --global credential.helper store echo \"https://username:token@github.com\" >> ~/.git-credentials","content":"Personal Access Tokens ```bash git config --global credential.helper store echo \"https://username:token@github.com\" >> ~/.git-credentials"},{"id":"cli/package-manager/package-manager::personal-access-tokens::30","title":"Менеджер пакетов","section":"Personal Access Tokens","path":"/docs/guide/cli/package-manager/package-manager#personal-access-tokens","headings":["Personal Access Tokens"],"excerpt":"Personal Access Tokens git config --global url.\"https://username:token@github.com/mycompany\".insteadOf \"https://github.com/mycompany\" ```","content":"Personal Access Tokens git config --global url.\"https://username:token@github.com/mycompany\".insteadOf \"https://github.com/mycompany\" ```"},{"id":"cli/package-manager/package-manager::top::31","title":"Менеджер пакетов","section":"Инициализация проекта","path":"/docs/guide/cli/package-manager/package-manager","headings":["Инициализация проекта"],"excerpt":"Инициализация проекта ```bash cat > easyp.yaml << EOF deps: - github.com/googleapis/googleapis - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 EOF","content":"Инициализация проекта ```bash cat > easyp.yaml << EOF deps: - github.com/googleapis/googleapis - github.com/grpc-ecosystem/grpc-gateway@v2.19.1 EOF"},{"id":"cli/package-manager/package-manager::top::32","title":"Менеджер пакетов","section":"Инициализация проекта","path":"/docs/guide/cli/package-manager/package-manager","headings":["Инициализация проекта"],"excerpt":"Инициализация проекта easyp mod download ls ~/.easyp/mod/github.com/googleapis/googleapis/ ```","content":"Инициализация проекта easyp mod download ls ~/.easyp/mod/github.com/googleapis/googleapis/ ```"},{"id":"cli/package-manager/package-manager::repository-not-found-authentication-failed::33","title":"Менеджер пакетов","section":"\"Repository not found\" / \"Authentication failed\"","path":"/docs/guide/cli/package-manager/package-manager#repository-not-found-authentication-failed","headings":["\"Repository not found\" / \"Authentication failed\""],"excerpt":"\"Repository not found\" / \"Authentication failed\"","content":"\"Repository not found\" / \"Authentication failed\""},{"id":"cli/package-manager/package-manager::cache-corruption-checksum-mismatch::34","title":"Менеджер пакетов","section":"\"Cache corruption\" / \"Checksum mismatch\"","path":"/docs/guide/cli/package-manager/package-manager#cache-corruption-checksum-mismatch","headings":["\"Cache corruption\" / \"Checksum mismatch\""],"excerpt":"\"Cache corruption\" / \"Checksum mismatch\"","content":"\"Cache corruption\" / \"Checksum mismatch\""},{"id":"cli/package-manager/package-manager::docker-multi-stage::35","title":"Менеджер пакетов","section":"Docker multi-stage","path":"/docs/guide/cli/package-manager/package-manager#docker-multi-stage","headings":["Docker multi-stage"],"excerpt":"Docker multi-stage ```dockerfile FROM ghcr.io/easyp-tech/easyp:latest AS deps WORKDIR /workspace COPY easyp.yaml easyp.lock ./ RUN easyp mod vendor","content":"Docker multi-stage ```dockerfile FROM ghcr.io/easyp-tech/easyp:latest AS deps WORKDIR /workspace COPY easyp.yaml easyp.lock ./ RUN easyp mod vendor"},{"id":"cli/package-manager/package-manager::docker-multi-stage::36","title":"Менеджер пакетов","section":"Docker multi-stage","path":"/docs/guide/cli/package-manager/package-manager#docker-multi-stage","headings":["Docker multi-stage"],"excerpt":"Docker multi-stage FROM alpine:latest AS build WORKDIR /app COPY --from=deps /workspace/easyp_vendor ./easyp_vendor COPY . . RUN easyp generate ```","content":"Docker multi-stage FROM alpine:latest AS build WORKDIR /app COPY --from=deps /workspace/easyp_vendor ./easyp_vendor COPY . . RUN easyp generate ```"},{"id":"cli/package-manager/package-manager::monorepo::37","title":"Менеджер пакетов","section":"Monorepo","path":"/docs/guide/cli/package-manager/package-manager#monorepo","headings":["Monorepo"],"excerpt":"Monorepo Каждый easyp.yaml может иметь свой набор зависимостей.","content":"Monorepo Каждый easyp.yaml может иметь свой набор зависимостей."},{"id":"cli/package-manager/package-manager::workflow::38","title":"Менеджер пакетов","section":"Workflow разработки","path":"/docs/guide/cli/package-manager/package-manager#workflow","headings":["Workflow разработки"],"excerpt":"Workflow разработки ✅ Latest теги в активной разработке ✅ Фиксация версий в продакшене ✅ Коммит lock файла ✅ Ревью обновлений ✅ Тест после обновления","content":"Workflow разработки ✅ Latest теги в активной разработке ✅ Фиксация версий в продакшене ✅ Коммит lock файла ✅ Ревью обновлений ✅ Тест после обновления"},{"id":"cli/package-manager/package-manager::top::39","title":"Менеджер пакетов","section":"Безопасность","path":"/docs/guide/cli/package-manager/package-manager","headings":["Безопасность"],"excerpt":"Безопасность ✅ Фиксируйте версии ✅ Используйте SSH ключи ✅ Оценивайте новые зависимости ✅ Следите за уязвимостями ❌ Не храните секреты в конфиге","content":"Безопасность ✅ Фиксируйте версии ✅ Используйте SSH ключи ✅ Оценивайте новые зависимости ✅ Следите за уязвимостями ❌ Не храните секреты в конфиге"},{"id":"cli/package-manager/package-manager::top::40","title":"Менеджер пакетов","section":"Производительность","path":"/docs/guide/cli/package-manager/package-manager","headings":["Производительность"],"excerpt":"Производительность ✅ Агрессивное кеширование в CI ✅ Vendoring для частых сборок ✅ Чистка старого кеша ✅ Общий кеш для команды","content":"Производительность ✅ Агрессивное кеширование в CI ✅ Vendoring для частых сборок ✅ Чистка старого кеша ✅ Общий кеш для команды"},{"id":"cli/package-manager/package-manager::top::41","title":"Менеджер пакетов","section":"Командная работа","path":"/docs/guide/cli/package-manager/package-manager","headings":["Командная работа"],"excerpt":"Командная работа ✅ Документация по аутентификации ✅ Единые инструменты ✅ Автоматизация обновлений с тестами ✅ Общий кеш при возможности","content":"Командная работа ✅ Документация по аутентификации ✅ Единые инструменты ✅ Автоматизация обновлений с тестами ✅ Общий кеш при возможности"},{"id":"cli/package-manager/package-manager::top::42","title":"Менеджер пакетов","section":"Командная работа","path":"/docs/guide/cli/package-manager/package-manager","headings":["Командная работа"],"excerpt":"Командная работа Менеджер пакетов EasyP — масштабируемое децентрализованное решение от одиночных проектов до enterprise, сохраняя простоту и надёжность.","content":"Командная работа Менеджер пакетов EasyP — масштабируемое децентрализованное решение от одиночных проектов до enterprise, сохраняя простоту и надёжность."},{"id":"introduction/install::top::0","title":"Установка EasyP CLI","section":"Установка через менеджер пакетов системы","path":"/docs/guide/introduction/install","headings":["Установка через менеджер пакетов системы"],"excerpt":"Установка через менеджер пакетов системы","content":"Установка через менеджер пакетов системы"},{"id":"introduction/install::top::1","title":"Установка EasyP CLI","section":"Рекомендуемый способ установки","path":"/docs/guide/introduction/install","headings":["Рекомендуемый способ установки"],"excerpt":"Рекомендуемый способ установки","content":"Рекомендуемый способ установки"},{"id":"introduction/install::homebrew::2","title":"Установка EasyP CLI","section":"Homebrew","path":"/docs/guide/introduction/install#homebrew","headings":["Homebrew"],"excerpt":"Homebrew Можно установить бинарный релиз в macOS через Homebrew:","content":"Homebrew Можно установить бинарный релиз в macOS через Homebrew:"},{"id":"introduction/install::homebrew::3","title":"Установка EasyP CLI","section":"Homebrew","path":"/docs/guide/introduction/install#homebrew","headings":["Homebrew"],"excerpt":"Homebrew Work in progress — поддержка других менеджеров (apt, yum, pacman и т.д.) в процессе.","content":"Homebrew Work in progress — поддержка других менеджеров (apt, yum, pacman и т.д.) в процессе."},{"id":"introduction/install::_-_::4","title":"Установка EasyP CLI","section":"_Не рекомендуется_","path":"/docs/guide/introduction/install#_-_","headings":["_Не рекомендуется_"],"excerpt":"_Не рекомендуется_ Локальная установка менее предпочтительна, потому что пакетные менеджеры обеспечивают: Автоматические обновления и патчи безопасности Лучшую интеграцию с системой Упрощённую установку и удаление Подпис","content":"_Не рекомендуется_ Локальная установка менее предпочтительна, потому что пакетные менеджеры обеспечивают: Автоматические обновления и патчи безопасности Лучшую интеграцию с системой Упрощённую установку и удаление Подписанные и проверенные бинарники"},{"id":"introduction/install::go-install::5","title":"Установка EasyP CLI","section":"Установка через go install","path":"/docs/guide/introduction/install#go-install","headings":["Установка через go install"],"excerpt":"Установка через go install Команда установит последнюю стабильную версию easyp:","content":"Установка через go install Команда установит последнюю стабильную версию easyp:"},{"id":"introduction/install::top::6","title":"Установка EasyP CLI","section":"Сборка из исходников","path":"/docs/guide/introduction/install","headings":["Сборка из исходников"],"excerpt":"Сборка из исходников Клонирование репозитория","content":"Сборка из исходников Клонирование репозитория"},{"id":"introduction/install::top::7","title":"Установка EasyP CLI","section":"Сборка из исходников","path":"/docs/guide/introduction/install","headings":["Сборка из исходников"],"excerpt":"Сборка из исходников Сборка с помощью Go","content":"Сборка из исходников Сборка с помощью Go"},{"id":"introduction/quickstart::top::0","title":"Быстрый старт (Quickstart)","path":"/docs/guide/introduction/quickstart","headings":[],"excerpt":"EasyP — современный toolkit для работы с файлами Protobuf. В этом кратком руководстве вы научитесь:","content":"EasyP — современный toolkit для работы с файлами Protobuf. В этом кратком руководстве вы научитесь:"},{"id":"introduction/quickstart::top::1","title":"Быстрый старт (Quickstart)","path":"/docs/guide/introduction/quickstart","headings":[],"excerpt":"**Инициализировать** проект с конфигурацией EasyP **Настраивать линтинг**, чтобы ловить ошибки и соблюдать лучшие практики **Управлять зависимостями** из Git‑репозиториев **Генерировать код** из ваших Protobuf файлов","content":"**Инициализировать** проект с конфигурацией EasyP **Настраивать линтинг**, чтобы ловить ошибки и соблюдать лучшие практики **Управлять зависимостями** из Git‑репозиториев **Генерировать код** из ваших Protobuf файлов"},{"id":"introduction/quickstart::top::2","title":"Быстрый старт (Quickstart)","section":"Предварительные требования","path":"/docs/guide/introduction/quickstart","headings":["Предварительные требования"],"excerpt":"Предварительные требования Перед началом убедитесь, что у вас установлены:","content":"Предварительные требования Перед началом убедитесь, что у вас установлены:"},{"id":"introduction/quickstart::top::3","title":"Быстрый старт (Quickstart)","section":"Предварительные требования","path":"/docs/guide/introduction/quickstart","headings":["Предварительные требования"],"excerpt":"Предварительные требования **EasyP CLI** — см. руководство по установке **Git** доступен в вашем $PATH **Файлы .proto** (или создайте их по ходу)","content":"Предварительные требования **EasyP CLI** — см. руководство по установке **Git** доступен в вашем $PATH **Файлы .proto** (или создайте их по ходу)"},{"id":"introduction/quickstart::top::4","title":"Быстрый старт (Quickstart)","section":"Предварительные требования","path":"/docs/guide/introduction/quickstart","headings":["Предварительные требования"],"excerpt":"Предварительные требования Проверить версию EasyP:","content":"Предварительные требования Проверить версию EasyP:"},{"id":"introduction/quickstart::top::5","title":"Быстрый старт (Quickstart)","section":"Инициализация проекта","path":"/docs/guide/introduction/quickstart","headings":["Инициализация проекта"],"excerpt":"Инициализация проекта Создайте базовый файл конфигурации easyp.yaml в корне проекта:","content":"Инициализация проекта Создайте базовый файл конфигурации easyp.yaml в корне проекта:"},{"id":"introduction/quickstart::top::6","title":"Быстрый старт (Quickstart)","section":"Инициализация проекта","path":"/docs/guide/introduction/quickstart","headings":["Инициализация проекта"],"excerpt":"Инициализация проекта Команда генерирует шаблон easyp.yaml с комментариями, дефолтными lint-правилами и настройками breaking-check. easyp init работает интерактивно: если в корне есть buf.yml/buf.yaml, EasyP предложит ми","content":"Инициализация проекта Команда генерирует шаблон easyp.yaml с комментариями, дефолтными lint-правилами и настройками breaking-check. easyp init работает интерактивно: если в корне есть buf.yml/buf.yaml, EasyP предложит миграцию; если easyp.yaml уже существует, попросит подтверждение перед перезаписью."},{"id":"introduction/quickstart::top::7","title":"Быстрый старт (Quickstart)","section":"Настройка линтинга","path":"/docs/guide/introduction/quickstart","headings":["Настройка линтинга"],"excerpt":"Настройка линтинга Линтинг помогает находить проблемы и поддерживать единый стиль. EasyP использует правила, совместимые с Buf.","content":"Настройка линтинга Линтинг помогает находить проблемы и поддерживать единый стиль. EasyP использует правила, совместимые с Buf."},{"id":"introduction/quickstart::top::8","title":"Быстрый старт (Quickstart)","section":"Настройка линтинга","path":"/docs/guide/introduction/quickstart","headings":["Настройка линтинга"],"excerpt":"Настройка линтинга Секция lint уже создаётся командой easyp init. При необходимости отредактируйте её, например так:","content":"Настройка линтинга Секция lint уже создаётся командой easyp init. При необходимости отредактируйте её, например так:"},{"id":"introduction/quickstart::top::9","title":"Быстрый старт (Quickstart)","section":"Настройка линтинга","path":"/docs/guide/introduction/quickstart","headings":["Настройка линтинга"],"excerpt":"Настройка линтинга Запустите линтер:","content":"Настройка линтинга Запустите линтер:"},{"id":"introduction/quickstart::top::10","title":"Быстрый старт (Quickstart)","section":"Настройка линтинга","path":"/docs/guide/introduction/quickstart","headings":["Настройка линтинга"],"excerpt":"Настройка линтинга Линтер проверит все .proto файлы и сообщит о найденных проблемах.","content":"Настройка линтинга Линтер проверит все .proto файлы и сообщит о найденных проблемах."},{"id":"introduction/quickstart::top::11","title":"Быстрый старт (Quickstart)","section":"Настройка линтинга","path":"/docs/guide/introduction/quickstart","headings":["Настройка линтинга"],"excerpt":"Настройка линтинга ::: tip Правила линтинга EasyP на 100% совместимы с Buf — мигрировать просто. :::","content":"Настройка линтинга ::: tip Правила линтинга EasyP на 100% совместимы с Buf — мигрировать просто. :::"},{"id":"introduction/quickstart::top::12","title":"Быстрый старт (Quickstart)","section":"Управление зависимостями","path":"/docs/guide/introduction/quickstart","headings":["Управление зависимостями"],"excerpt":"Управление зависимостями Если вы используете сторонние protobuf пакеты (например Google APIs или gRPC Gateway), EasyP упрощает их подключение.","content":"Управление зависимостями Если вы используете сторонние protobuf пакеты (например Google APIs или gRPC Gateway), EasyP упрощает их подключение."},{"id":"introduction/quickstart::top::13","title":"Быстрый старт (Quickstart)","section":"Формат зависимости","path":"/docs/guide/introduction/quickstart","headings":["Формат зависимости"],"excerpt":"Формат зависимости Запись: $GIT_LINK@$VERSION","content":"Формат зависимости Запись: $GIT_LINK@$VERSION"},{"id":"introduction/quickstart::top::14","title":"Быстрый старт (Quickstart)","section":"Формат зависимости","path":"/docs/guide/introduction/quickstart","headings":["Формат зависимости"],"excerpt":"Формат зависимости **$GIT_LINK** — URL любого Git‑репозитория (GitHub, GitLab и т.д.) **$VERSION** — тег или хеш коммита (опционально)","content":"Формат зависимости **$GIT_LINK** — URL любого Git‑репозитория (GitHub, GitLab и т.д.) **$VERSION** — тег или хеш коммита (опционально)"},{"id":"introduction/quickstart::top::15","title":"Быстрый старт (Quickstart)","section":"Формат зависимости","path":"/docs/guide/introduction/quickstart","headings":["Формат зависимости"],"excerpt":"Формат зависимости Если версия не указана — берётся последний коммит из основной ветки.","content":"Формат зависимости Если версия не указана — берётся последний коммит из основной ветки."},{"id":"introduction/quickstart::top::16","title":"Быстрый старт (Quickstart)","section":"Добавление зависимостей","path":"/docs/guide/introduction/quickstart","headings":["Добавление зависимостей"],"excerpt":"Добавление зависимостей Дополните easyp.yaml:","content":"Добавление зависимостей Дополните easyp.yaml:"},{"id":"introduction/quickstart::top::17","title":"Быстрый старт (Quickstart)","section":"Загрузка зависимостей","path":"/docs/guide/introduction/quickstart","headings":["Загрузка зависимостей"],"excerpt":"Загрузка зависимостей Команда: Скачивает версии из easyp.lock, если он существует Иначе — берёт из easyp.yaml и создаёт easyp.lock","content":"Загрузка зависимостей Команда: Скачивает версии из easyp.lock, если он существует Иначе — берёт из easyp.yaml и создаёт easyp.lock"},{"id":"introduction/quickstart::top::18","title":"Быстрый старт (Quickstart)","section":"Загрузка зависимостей","path":"/docs/guide/introduction/quickstart","headings":["Загрузка зависимостей"],"excerpt":"Загрузка зависимостей ::: info Совет: easyp mod update — игнорирует lock‑файл и подтягивает актуальные версии из easyp.yaml. :::","content":"Загрузка зависимостей ::: info Совет: easyp mod update — игнорирует lock‑файл и подтягивает актуальные версии из easyp.yaml. :::"},{"id":"introduction/quickstart::top::19","title":"Быстрый старт (Quickstart)","section":"Генерация кода","path":"/docs/guide/introduction/quickstart","headings":["Генерация кода"],"excerpt":"Генерация кода EasyP поддерживает все стандартные protoc‑плагины.","content":"Генерация кода EasyP поддерживает все стандартные protoc‑плагины."},{"id":"introduction/quickstart::top::20","title":"Быстрый старт (Quickstart)","section":"Конфигурация генерации","path":"/docs/guide/introduction/quickstart","headings":["Конфигурация генерации"],"excerpt":"Конфигурация генерации Добавьте плагины:","content":"Конфигурация генерации Добавьте плагины:"},{"id":"introduction/quickstart::top::21","title":"Быстрый старт (Quickstart)","section":"Запуск генерации","path":"/docs/guide/introduction/quickstart","headings":["Запуск генерации"],"excerpt":"Запуск генерации EasyP выполнит: Разрешение всех зависимостей Подключение к сервису EasyP (или локальный режим) Запуск указанных плагинов Вывод сгенерированного кода в нужные директории","content":"Запуск генерации EasyP выполнит: Разрешение всех зависимостей Подключение к сервису EasyP (или локальный режим) Запуск указанных плагинов Вывод сгенерированного кода в нужные директории"},{"id":"introduction/quickstart::top::22","title":"Быстрый старт (Quickstart)","section":"Запуск генерации","path":"/docs/guide/introduction/quickstart","headings":["Запуск генерации"],"excerpt":"Запуск генерации ::: tip Гибридный рантайм: WASM для скорости, Docker — для тяжёлых плагинов. :::","content":"Запуск генерации ::: tip Гибридный рантайм: WASM для скорости, Docker — для тяжёлых плагинов. :::"},{"id":"introduction/quickstart::top::23","title":"Быстрый старт (Quickstart)","section":"Следующие шаги","path":"/docs/guide/introduction/quickstart","headings":["Следующие шаги"],"excerpt":"Следующие шаги Поздравляем! 🎉 Вы успешно: ✅ Инициализировали проект EasyP ✅ Настроили линтинг ✅ Управляете внешними зависимостями ✅ Сгенерировали код из .proto","content":"Следующие шаги Поздравляем! 🎉 Вы успешно: ✅ Инициализировали проект EasyP ✅ Настроили линтинг ✅ Управляете внешними зависимостями ✅ Сгенерировали код из .proto"},{"id":"introduction/quickstart::top::24","title":"Быстрый старт (Quickstart)","section":"Узнать больше","path":"/docs/guide/introduction/quickstart","headings":["Узнать больше"],"excerpt":"Узнать больше **CLI Reference** — подробности по командам **API Service** — удалённая генерация **Configuration** — все опции конфигурации","content":"Узнать больше **CLI Reference** — подробности по командам **API Service** — удалённая генерация **Configuration** — все опции конфигурации"},{"id":"introduction/quickstart::top::25","title":"Быстрый старт (Quickstart)","section":"Узнать больше","path":"/docs/guide/introduction/quickstart","headings":["Узнать больше"],"excerpt":"Узнать больше *Приятной работы с Protobuf — без боли! 🚀*","content":"Узнать больше *Приятной работы с Protobuf — без боли! 🚀*"},{"id":"introduction/what-is::top::0","title":"Что такое EasyP?","path":"/docs/guide/introduction/what-is","headings":[],"excerpt":"EasyP — это современный инструментарий для работы с Protocol Buffers, который объединяет весь ваш protobuf‑workflow в один мощный CLI‑инструмент. Он совмещает линтинг, управление пакетами, генерацию кода и проверку совме","content":"EasyP — это современный инструментарий для работы с Protocol Buffers, который объединяет весь ваш protobuf‑workflow в один мощный CLI‑инструмент. Он совмещает линтинг, управление пакетами, генерацию кода и проверку совместимости в единой среде и устраняет сложность традиционной работы с protobuf."},{"id":"introduction/what-is::top::1","title":"Что такое EasyP?","path":"/docs/guide/introduction/what-is","headings":[],"excerpt":"Хотите просто попробовать? Перейдите сразу к разделу Quickstart.","content":"Хотите просто попробовать? Перейдите сразу к разделу Quickstart."},{"id":"introduction/what-is::protobuf::2","title":"Что такое EasyP?","section":"Проблема: фрагментированные protobuf‑процессы","path":"/docs/guide/introduction/what-is#protobuf","headings":["Проблема: фрагментированные protobuf‑процессы"],"excerpt":"Проблема: фрагментированные protobuf‑процессы Работа с Protocol Buffers в разных проектах часто создает лишнюю сложность и трение:","content":"Проблема: фрагментированные protobuf‑процессы Работа с Protocol Buffers в разных проектах часто создает лишнюю сложность и трение:"},{"id":"introduction/what-is::top::3","title":"Что такое EasyP?","section":"Хаос инструментов","path":"/docs/guide/introduction/what-is","headings":["Хаос инструментов"],"excerpt":"Хаос инструментов **Много отдельных утилит**: Отдельно для линтинга, генерации и управления зависимостями **Несогласованные конфигурации**: Разные форматы и правила в разных командах **Сложный онбординг**: Новым разработ","content":"Хаос инструментов **Много отдельных утилит**: Отдельно для линтинга, генерации и управления зависимостями **Несогласованные конфигурации**: Разные форматы и правила в разных командах **Сложный онбординг**: Новым разработчикам нужно долго вникать"},{"id":"introduction/what-is::top::4","title":"Что такое EasyP?","section":"Проблемы управления зависимостями","path":"/docs/guide/introduction/what-is","headings":["Проблемы управления зависимостями"],"excerpt":"Проблемы управления зависимостями **Нет стандартизированного подхода**: Каждый проект решает это по‑своему **Конфликты версий**: Трудно сводить разные версии одних и тех же proto‑библиотек **Неповторяемость сборок**: Сло","content":"Проблемы управления зависимостями **Нет стандартизированного подхода**: Каждый проект решает это по‑своему **Конфликты версий**: Трудно сводить разные версии одних и тех же proto‑библиотек **Неповторяемость сборок**: Сложно гарантировать одинаковый результат в разных окружениях"},{"id":"introduction/what-is::top::5","title":"Что такое EasyP?","section":"Трение в разработке","path":"/docs/guide/introduction/what-is","headings":["Трение в разработке"],"excerpt":"Трение в разработке **Ручные операции**: Много повторяющихся шагов **Разрастание конфигураций**: Множество файлов и форматов **Затратная проверка совместимости**: Часто вручную и постфактум","content":"Трение в разработке **Ручные операции**: Много повторяющихся шагов **Разрастание конфигураций**: Множество файлов и форматов **Затратная проверка совместимости**: Часто вручную и постфактум"},{"id":"introduction/what-is::protobuf::6","title":"Что такое EasyP?","section":"Решение: единый protobuf‑инструментарий","path":"/docs/guide/introduction/what-is#protobuf","headings":["Решение: единый protobuf‑инструментарий"],"excerpt":"Решение: единый protobuf‑инструментарий EasyP устраняет эти проблемы, предоставляя целостный opinionated‑подход и стандартизируя процессы:","content":"Решение: единый protobuf‑инструментарий EasyP устраняет эти проблемы, предоставляя целостный opinionated‑подход и стандартизируя процессы:"},{"id":"introduction/what-is::top::7","title":"Что такое EasyP?","section":"Один инструмент — все задачи","path":"/docs/guide/introduction/what-is","headings":["Один инструмент — все задачи"],"excerpt":"Один инструмент — все задачи Вместо жонглирования утилитами EasyP даёт: **Linting** с расширенными наборами правил **Package management** с Git‑нативными зависимостями **Code generation** локально и удалённо **Breaking c","content":"Один инструмент — все задачи Вместо жонглирования утилитами EasyP даёт: **Linting** с расширенными наборами правил **Package management** с Git‑нативными зависимостями **Code generation** локально и удалённо **Breaking change detection** для контроля совместимости API"},{"id":"introduction/what-is::top::8","title":"Что такое EasyP?","section":"Единая конфигурация","path":"/docs/guide/introduction/what-is","headings":["Единая конфигурация"],"excerpt":"Единая конфигурация Один файл easyp.yaml описывает весь workflow — меньше расхождений, проще сопровождать.","content":"Единая конфигурация Один файл easyp.yaml описывает весь workflow — меньше расхождений, проще сопровождать."},{"id":"introduction/what-is::gitnative::9","title":"Что такое EasyP?","section":"Git‑native зависимости","path":"/docs/guide/introduction/what-is#gitnative","headings":["Git‑native зависимости"],"excerpt":"Git‑native зависимости Прямое использование Git‑репозиториев вместо централизованных реестров: прозрачная история, контроль версий, воспроизводимые сборки.","content":"Git‑native зависимости Прямое использование Git‑репозиториев вместо централизованных реестров: прозрачная история, контроль версий, воспроизводимые сборки."},{"id":"introduction/what-is::top::10","title":"Что такое EasyP?","section":"Ключевые возможности","path":"/docs/guide/introduction/what-is","headings":["Ключевые возможности"],"excerpt":"Ключевые возможности Feature Description --------- ------------- 🔍 **Comprehensive Linting** Полная поддержка правил buf с настраиваемыми профилями для лучших практик API‑дизайна. 📦 **Smart Package Manager** Git‑ориент","content":"Ключевые возможности Feature Description --------- ------------- 🔍 **Comprehensive Linting** Полная поддержка правил buf с настраиваемыми профилями для лучших практик API‑дизайна. 📦 **Smart Package Manager** Git‑ориентированное управление зависимостями с lock‑файлом для воспроизводимости. ⚡ **Code Generation** Многозадачная генерация кода с поддержкой локальных и удалённых protoc‑плагинов. 🔄 **Breaking Change Detection** Автоматическая проверка совместимости API против веток Git. 🌐 **Remote Plugin Support** Выполнение плагинов через централизованный EasyP API сервис без локальных установок. 🎯 **Developer Experience** Автодополнение, понятные ошибки, единая структура и документация."},{"id":"introduction/what-is::top::11","title":"Что такое EasyP?","section":"Типы поддерживаемых плагинов","path":"/docs/guide/introduction/what-is","headings":["Типы поддерживаемых плагинов"],"excerpt":"Типы поддерживаемых плагинов EasyP гибко подходит к выполнению генерации:","content":"Типы поддерживаемых плагинов EasyP гибко подходит к выполнению генерации:"},{"id":"introduction/what-is::local-plugins::12","title":"Что такое EasyP?","section":"Local Plugins","path":"/docs/guide/introduction/what-is#local-plugins","headings":["Local Plugins"],"excerpt":"Local Plugins Стандартные установленные protoc‑плагины:","content":"Local Plugins Стандартные установленные protoc‑плагины:"},{"id":"introduction/what-is::remote-plugins::13","title":"Что такое EasyP?","section":"Remote Plugins","path":"/docs/guide/introduction/what-is#remote-plugins","headings":["Remote Plugins"],"excerpt":"Remote Plugins Плагины через EasyP API сервис для воспроизводимости:","content":"Remote Plugins Плагины через EasyP API сервис для воспроизводимости:"},{"id":"introduction/what-is::custom-plugins::14","title":"Что такое EasyP?","section":"Custom Plugins","path":"/docs/guide/introduction/what-is#custom-plugins","headings":["Custom Plugins"],"excerpt":"Custom Plugins Поддержка экосистемы пользовательских расширений.","content":"Custom Plugins Поддержка экосистемы пользовательских расширений."},{"id":"introduction/what-is::top::15","title":"Что такое EasyP?","section":"Децентрализованный менеджмент пакетов","path":"/docs/guide/introduction/what-is","headings":["Децентрализованный менеджмент пакетов"],"excerpt":"Децентрализованный менеджмент пакетов В отличие от других решений EasyP не требует централизованного реестра. Любой Git‑репозиторий может быть источником:","content":"Децентрализованный менеджмент пакетов В отличие от других решений EasyP не требует централизованного реестра. Любой Git‑репозиторий может быть источником:"},{"id":"introduction/what-is::top::16","title":"Что такое EasyP?","section":"Децентрализованный менеджмент пакетов","path":"/docs/guide/introduction/what-is","headings":["Децентрализованный менеджмент пакетов"],"excerpt":"Децентрализованный менеджмент пакетов **Гибкость**: Любой Git‑хостинг (GitHub, GitLab, self‑hosted) **Нет vendor lock‑in**: Зависимости не привязаны к одному провайдеру **Полная история**: Ветки, теги, ревью **Enterprise","content":"Децентрализованный менеджмент пакетов **Гибкость**: Любой Git‑хостинг (GitHub, GitLab, self‑hosted) **Нет vendor lock‑in**: Зависимости не привязаны к одному провайдеру **Полная история**: Ветки, теги, ревью **Enterprise‑совместимость**: Поддержка приватных репозиториев"},{"id":"introduction/what-is::buf::17","title":"Что такое EasyP?","section":"Бесшовная миграция с Buf","path":"/docs/guide/introduction/what-is#buf","headings":["Бесшовная миграция с Buf"],"excerpt":"Бесшовная миграция с Buf EasyP изначально совместим с экосистемой buf:","content":"Бесшовная миграция с Buf EasyP изначально совместим с экосистемой buf:"},{"id":"introduction/what-is::buf::18","title":"Что такое EasyP?","section":"Бесшовная миграция с Buf","path":"/docs/guide/introduction/what-is#buf","headings":["Бесшовная миграция с Buf"],"excerpt":"Бесшовная миграция с Buf **Совпадающие rule sets** **Похожая структура YAML** **Минимальные изменения для замены** **Постепенное внедрение** без ломки текущего пайплайна","content":"Бесшовная миграция с Buf **Совпадающие rule sets** **Похожая структура YAML** **Минимальные изменения для замены** **Постепенное внедрение** без ломки текущего пайплайна"},{"id":"introduction/what-is::easyp-vs-bufbuild::19","title":"Что такое EasyP?","section":"EasyP vs buf.build","path":"/docs/guide/introduction/what-is#easyp-vs-bufbuild","headings":["EasyP vs buf.build"],"excerpt":"EasyP vs buf.build Feature EasyP buf.build --------- -------- ----------- **Dependency Management** Git‑репозитории Buf Schema Registry (BSR) **Vendor Lock-in** Нет Привязка к BSR для полного функционала **Plugin Executi","content":"EasyP vs buf.build Feature EasyP buf.build --------- -------- ----------- **Dependency Management** Git‑репозитории Buf Schema Registry (BSR) **Vendor Lock-in** Нет Привязка к BSR для полного функционала **Plugin Execution** Local + Remote Local + BSR plugins **Private Dependencies** Любой Git провайдер BSR или ручное управление **Offline Development** Полная поддержка (mod vendor) Ограниченно без доступа к BSR **Enterprise Integration** Использует существующий Git Требует настройку BSR **Breaking Change Detection** Против любой Git ссылки Аналогично **Package Distribution** Любой Git Публикация через BSR **License** Apache 2.0 Apache 2.0 **Community** Growing Established"},{"id":"introduction/what-is::easyp-vs-bufbuild::20","title":"Что такое EasyP?","section":"EasyP vs buf.build","path":"/docs/guide/introduction/what-is#easyp-vs-bufbuild","headings":["EasyP vs buf.build"],"excerpt":"EasyP vs buf.build **Преимущества миграции:** Без изменения инфраструктуры Плавное принятие новых возможностей Гибрид локальных и удалённых плагинов Единая конфигурация вместо набора файлов","content":"EasyP vs buf.build **Преимущества миграции:** Без изменения инфраструктуры Плавное принятие новых возможностей Гибрид локальных и удалённых плагинов Единая конфигурация вместо набора файлов"},{"id":"introduction/what-is::protobuf::21","title":"Что такое EasyP?","section":"Наши цели для Protobuf","path":"/docs/guide/introduction/what-is#protobuf","headings":["Наши цели для Protobuf"],"excerpt":"Наши цели для Protobuf Миссия EasyP — ускорить принятие **schema‑driven API** через удобный, надёжный и прозрачный инструментарий.","content":"Наши цели для Protobuf Миссия EasyP — ускорить принятие **schema‑driven API** через удобный, надёжный и прозрачный инструментарий."},{"id":"introduction/what-is::top::22","title":"Что такое EasyP?","section":"Современная экосистема","path":"/docs/guide/introduction/what-is","headings":["Современная экосистема"],"excerpt":"Современная экосистема Повышаем DX вокруг protobuf, чтобы конкурентно выглядеть по простоте против REST/JSON, сохраняя типовую строгость и производительность.","content":"Современная экосистема Повышаем DX вокруг protobuf, чтобы конкурентно выглядеть по простоте против REST/JSON, сохраняя типовую строгость и производительность."},{"id":"introduction/what-is::developer-experience::23","title":"Что такое EasyP?","section":"Developer Experience прежде всего","path":"/docs/guide/introduction/what-is#developer-experience","headings":["Developer Experience прежде всего"],"excerpt":"Developer Experience прежде всего Интуитивный CLI, понятные ошибки, ясные сообщения, минимальная фрагментация.","content":"Developer Experience прежде всего Интуитивный CLI, понятные ошибки, ясные сообщения, минимальная фрагментация."},{"id":"introduction/what-is::enterprise::24","title":"Что такое EasyP?","section":"Готов к Enterprise","path":"/docs/guide/introduction/what-is#enterprise","headings":["Готов к Enterprise"],"excerpt":"Готов к Enterprise Воспроизводимые сборки, приватные репозитории, интеграция в CI/CD.","content":"Готов к Enterprise Воспроизводимые сборки, приватные репозитории, интеграция в CI/CD."},{"id":"introduction/what-is::top::25","title":"Что такое EasyP?","section":"Для индивидуальных разработчиков","path":"/docs/guide/introduction/what-is","headings":["Для индивидуальных разработчиков"],"excerpt":"Для индивидуальных разработчиков Быстрый старт за минуты Один инструмент — меньше когнитивной нагрузки Понятная документация","content":"Для индивидуальных разработчиков Быстрый старт за минуты Один инструмент — меньше когнитивной нагрузки Понятная документация"},{"id":"introduction/what-is::top::26","title":"Что такое EasyP?","section":"Для команд","path":"/docs/guide/introduction/what-is","headings":["Для команд"],"excerpt":"Для команд Единые стандарты Повторяемые сборки (lock‑файл) Ускоренный онбординг","content":"Для команд Единые стандарты Повторяемые сборки (lock‑файл) Ускоренный онбординг"},{"id":"introduction/what-is::top::27","title":"Что такое EasyP?","section":"Для организаций","path":"/docs/guide/introduction/what-is","headings":["Для организаций"],"excerpt":"Для организаций Нет vendor lock‑in Безопасность приватных репозиториев Лёгкая интеграция в существующие пайплайны","content":"Для организаций Нет vendor lock‑in Безопасность приватных репозиториев Лёгкая интеграция в существующие пайплайны"},{"id":"introduction/what-is::top::28","title":"Что такое EasyP?","section":"Что дальше?","path":"/docs/guide/introduction/what-is","headings":["Что дальше?"],"excerpt":"Что дальше? EasyP упрощает работу с protobuf — фокусируйтесь на API, а не на рутине. Хотите начать?","content":"Что дальше? EasyP упрощает работу с protobuf — фокусируйтесь на API, а не на рутине. Хотите начать?"},{"id":"introduction/what-is::top::29","title":"Что такое EasyP?","section":"Что дальше?","path":"/docs/guide/introduction/what-is","headings":["Что дальше?"],"excerpt":"Что дальше? Смотрите Installation Guide и Quickstart.","content":"Что дальше? Смотрите Installation Guide и Quickstart."},{"id":"introduction/what-is::stargazers-over-time::30","title":"Что такое EasyP?","section":"Stargazers over time","path":"/docs/guide/introduction/what-is#stargazers-over-time","headings":["Stargazers over time"],"excerpt":"Stargazers over time Stargazers over time","content":"Stargazers over time Stargazers over time"},{"id":"migration/buf-cli::top::0","title":"Buf CLI","path":"/docs/guide/migration/buf-cli","headings":[],"excerpt":"Buf CLI В работе","content":"Buf CLI В работе"},{"id":"migration/protoc::top::0","title":"Миграция с protoc на EasyP","path":"/docs/guide/migration/protoc","headings":[],"excerpt":"Исходная англоязычная версия файла содержала только заголовок и пометку “Work in progress”. Ниже — полноценный русскоязычный черновик раздела миграции. Уточни, если требуется сократить или изменить уровень детализации.","content":"Исходная англоязычная версия файла содержала только заголовок и пометку “Work in progress”. Ниже — полноценный русскоязычный черновик раздела миграции. Уточни, если требуется сократить или изменить уровень детализации."},{"id":"migration/protoc::1::1","title":"Миграция с protoc на EasyP","section":"1. Краткое сравнение","path":"/docs/guide/migration/protoc#1","headings":["1. Краткое сравнение"],"excerpt":"Краткое сравнение Аспект protoc EasyP -------- ---------- ------- Базовая роль Базовый компилятор .proto файлов Инструмент “всё в одном”: линтинг, проверка несовместимых изменений, менеджер пакетов, генерация Конфигураци","content":"Краткое сравнение Аспект protoc EasyP -------- ---------- ------- Базовая роль Базовый компилятор .proto файлов Инструмент “всё в одном”: линтинг, проверка несовместимых изменений, менеджер пакетов, генерация Конфигурация Чаще shell‑скрипты / Makefile / вручную передаваемые флаги Единый файл easyp.yaml (YAML или JSON) Управление зависимостями Ручной git clone, submodule, vendoring Секция deps с Git‑репозиториями Набор правил линтера Нет встроенного Встроенный линтер с правилами (можно включать/исключать) Проверка breaking changes Отсутствует из коробки Команда easyp breaking Расширенные плагины Установка и вызов через флаги --plugin Плагины через конфиг; поддержка удалённого выполнения (API Service) и стандартного локального Единообразие в CI Нужно собирать вручную Консистентные команды: lint, breaking, generate"},{"id":"migration/protoc::2::2","title":"Миграция с protoc на EasyP","section":"2. Когда имеет смысл мигрировать","path":"/docs/guide/migration/protoc#2","headings":["2. Когда имеет смысл мигрировать"],"excerpt":"Когда имеет смысл мигрировать Миграция на EasyP особенно полезна если: Есть потребность в автоматической проверке качества (стиль, именование) .proto файлов. Нужна защита от нелегитимных несовместимых изменений при эволю","content":"Когда имеет смысл мигрировать Миграция на EasyP особенно полезна если: Есть потребность в автоматической проверке качества (стиль, именование) .proto файлов. Нужна защита от нелегитимных несовместимых изменений при эволюции схем. В проекте используется несколько языков генерации и растёт число скриптов вокруг protoc. Вы хотите единый конфиг вместо множества shell/Makefile комбинаций. Планируется централизованное исполнение плагинов (через API Service) или унификация окружения в CI."},{"id":"migration/protoc::3-protoc::3","title":"Миграция с protoc на EasyP","section":"3. Типичный сценарий “до” (только protoc)","path":"/docs/guide/migration/protoc#3-protoc","headings":["3. Типичный сценарий “до” (только protoc)"],"excerpt":"Типичный сценарий “до” (только protoc) Пример: локальные скрипты / Makefile:","content":"Типичный сценарий “до” (только protoc) Пример: локальные скрипты / Makefile:"},{"id":"migration/protoc::3-protoc::4","title":"Миграция с protoc на EasyP","section":"3. Типичный сценарий “до” (только protoc)","path":"/docs/guide/migration/protoc#3-protoc","headings":["3. Типичный сценарий “до” (только protoc)"],"excerpt":"Типичный сценарий “до” (только protoc)","content":"Типичный сценарий “до” (только protoc)"},{"id":"migration/protoc::3-protoc::5","title":"Миграция с protoc на EasyP","section":"3. Типичный сценарий “до” (только protoc)","path":"/docs/guide/migration/protoc#3-protoc","headings":["3. Типичный сценарий “до” (только protoc)"],"excerpt":"Типичный сценарий “до” (только protoc) Дополнительные зависимости (googleapis, validate, grpc-gateway) скачиваются вручную или через submodules.","content":"Типичный сценарий “до” (только protoc) Дополнительные зависимости (googleapis, validate, grpc-gateway) скачиваются вручную или через submodules."},{"id":"migration/protoc::4-easyp::6","title":"Миграция с protoc на EasyP","section":"4. Типичный сценарий “после” (EasyP)","path":"/docs/guide/migration/protoc#4-easyp","headings":["4. Типичный сценарий “после” (EasyP)"],"excerpt":"Типичный сценарий “после” (EasyP) Единый файл easyp.yaml:","content":"Типичный сценарий “после” (EasyP) Единый файл easyp.yaml:"},{"id":"migration/protoc::4-easyp::7","title":"Миграция с protoc на EasyP","section":"4. Типичный сценарий “после” (EasyP)","path":"/docs/guide/migration/protoc#4-easyp","headings":["4. Типичный сценарий “после” (EasyP)"],"excerpt":"Типичный сценарий “после” (EasyP) ```yaml deps: - github.com/googleapis/googleapis - github.com/envoyproxy/protoc-gen-validate","content":"Типичный сценарий “после” (EasyP) ```yaml deps: - github.com/googleapis/googleapis - github.com/envoyproxy/protoc-gen-validate"},{"id":"migration/protoc::4-easyp::8","title":"Миграция с protoc на EasyP","section":"4. Типичный сценарий “после” (EasyP)","path":"/docs/guide/migration/protoc#4-easyp","headings":["4. Типичный сценарий “после” (EasyP)"],"excerpt":"Типичный сценарий “после” (EasyP) generate: plugins: - name: go out: gen/go opts: paths: source_relative - name: go-grpc out: gen/go opts: paths: source_relative require_unimplemented_servers: false - name: validate out:","content":"Типичный сценарий “после” (EasyP) generate: plugins: - name: go out: gen/go opts: paths: source_relative - name: go-grpc out: gen/go opts: paths: source_relative require_unimplemented_servers: false - name: validate out: gen/go opts: paths: source_relative lang: \"go\" ```"},{"id":"migration/protoc::4-easyp::9","title":"Миграция с protoc на EasyP","section":"4. Типичный сценарий “после” (EasyP)","path":"/docs/guide/migration/protoc#4-easyp","headings":["4. Типичный сценарий “после” (EasyP)"],"excerpt":"Типичный сценарий “после” (EasyP) Команды:","content":"Типичный сценарий “после” (EasyP) Команды:"},{"id":"migration/protoc::5::10","title":"Миграция с protoc на EasyP","section":"5. Пошаговая миграция","path":"/docs/guide/migration/protoc#5","headings":["5. Пошаговая миграция"],"excerpt":"Пошаговая миграция Инвентаризация: - Соберите список всех вызовов protoc (скрипты, Makefile, CI). - Зафиксируйте используемые плагины и их версии. Создание easyp.yaml: - Поле version не обязательно (можете оставить его т","content":"Пошаговая миграция Инвентаризация: - Соберите список всех вызовов protoc (скрипты, Makefile, CI). - Зафиксируйте используемые плагины и их версии. Создание easyp.yaml: - Поле version не обязательно (можете оставить его только для обратной совместимости). - Перенесите плагины в секцию generate.plugins. - Укажите опции, которые ранее передавались в командной строке. Зависимости: - Все внешние каталоги (googleapis, validate, grpc-gateway и т.п.) занесите в deps. - Удалите лишние submodules при необходимости. Линтер: - Запустите easyp lint и посмотрите на предупреждения. - При необходимости добавьте lint.use, lint.ignore, lint.except. Проверка breaking changes: - Выберите референс (обычно origin/main или предыдущий тег). - Запустите easyp breaking --against git-ref=origin/main. - Настройте игнорируемые изменения (breaking.ignore), если нужно. Обновление CI: - Замените прямые вызовы protoc на easyp generate. - Добавьте отдельные шаги lint и breaking. Очистка: - Удалите устаревшие генерационные скрипты, если они дублируют функционал EasyP. Документация: - Обновите README / CONTRIBUTING (новый способ генерации). Верификация: - Сравните результат генерации до и после (git diff). - Убедитесь, что имена файлов и пути совпадают или скорректируйте структуру."},{"id":"migration/protoc::6-ci-github-actions::11","title":"Миграция с protoc на EasyP","section":"6. Замена в CI (пример GitHub Actions)","path":"/docs/guide/migration/protoc#6-ci-github-actions","headings":["6. Замена в CI (пример GitHub Actions)"],"excerpt":"Замена в CI (пример GitHub Actions) ```yaml name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest","content":"Замена в CI (пример GitHub Actions) ```yaml name: Install EasyP run: go install github.com/easyp-tech/easyp/cmd/easyp@latest"},{"id":"migration/protoc::6-ci-github-actions::12","title":"Миграция с protoc на EasyP","section":"6. Замена в CI (пример GitHub Actions)","path":"/docs/guide/migration/protoc#6-ci-github-actions","headings":["6. Замена в CI (пример GitHub Actions)"],"excerpt":"Замена в CI (пример GitHub Actions) name: Lint run: easyp lint","content":"Замена в CI (пример GitHub Actions) name: Lint run: easyp lint"},{"id":"migration/protoc::6-ci-github-actions::13","title":"Миграция с protoc на EasyP","section":"6. Замена в CI (пример GitHub Actions)","path":"/docs/guide/migration/protoc#6-ci-github-actions","headings":["6. Замена в CI (пример GitHub Actions)"],"excerpt":"Замена в CI (пример GitHub Actions) name: Breaking run: easyp breaking --against git-ref=origin/main","content":"Замена в CI (пример GitHub Actions) name: Breaking run: easyp breaking --against git-ref=origin/main"},{"id":"migration/protoc::6-ci-github-actions::14","title":"Миграция с protoc на EasyP","section":"6. Замена в CI (пример GitHub Actions)","path":"/docs/guide/migration/protoc#6-ci-github-actions","headings":["6. Замена в CI (пример GitHub Actions)"],"excerpt":"Замена в CI (пример GitHub Actions) name: Generate run: easyp generate ```","content":"Замена в CI (пример GitHub Actions) name: Generate run: easyp generate ```"},{"id":"migration/protoc::7::15","title":"Миграция с protoc на EasyP","section":"7. Работа с плагинами","path":"/docs/guide/migration/protoc#7","headings":["7. Работа с плагинами"],"excerpt":"Работа с плагинами Тип В protoc В EasyP ----- ---------- --------- Стандартные (protoc-gen-go) Указание через --go_out plugins: - name: go ... gRPC --go-grpc_out Второй плагин go-grpc Validate Доп. установка + --validate","content":"Работа с плагинами Тип В protoc В EasyP ----- ---------- --------- Стандартные (protoc-gen-go) Указание через --go_out plugins: - name: go ... gRPC --go-grpc_out Второй плагин go-grpc Validate Доп. установка + --validate_out - name: validate с opts gRPC-Gateway / OpenAPI --grpc-gateway_out / --openapiv2_out Плагины grpc-gateway, openapiv2 Кастомные Путь к бинарю / --plugin=protoc-gen-xxx - name: xxx или удалённый remote: (если используется API Service)"},{"id":"migration/protoc::7::16","title":"Миграция с protoc на EasyP","section":"7. Работа с плагинами","path":"/docs/guide/migration/protoc#7","headings":["7. Работа с плагинами"],"excerpt":"Работа с плагинами Если вы переходите на удалённое выполнение (API Service), записи в конфиге могут выглядеть так:","content":"Работа с плагинами Если вы переходите на удалённое выполнение (API Service), записи в конфиге могут выглядеть так:"},{"id":"migration/protoc::8::17","title":"Миграция с protoc на EasyP","section":"8. Проверка корректности после миграции","path":"/docs/guide/migration/protoc#8","headings":["8. Проверка корректности после миграции"],"excerpt":"Проверка корректности после миграции git diff после easyp generate — не должно быть неожиданных изменений. Сравнить размер и содержимое каталога сгенерированных файлов. Запустить ваш потребляющий код (сборка, тесты). Про","content":"Проверка корректности после миграции git diff после easyp generate — не должно быть неожиданных изменений. Сравнить размер и содержимое каталога сгенерированных файлов. Запустить ваш потребляющий код (сборка, тесты). Проверить, что плагины (validate, grpc-gateway) продолжают вставлять необходимые аннотации / опции. Линт не должен выдавать критичных ошибок — скорректируйте стиль .proto, если требуется."},{"id":"migration/protoc::9::18","title":"Миграция с protoc на EasyP","section":"9. Частые проблемы","path":"/docs/guide/migration/protoc#9","headings":["9. Частые проблемы"],"excerpt":"Частые проблемы Проблема Причина Решение ---------- --------- --------- Плагин не найден Не установлен или не указан в PATH Выполнить go install ... или добавить в конфиг как remote Ошибка импорта .proto Отсутствует репо","content":"Частые проблемы Проблема Причина Решение ---------- --------- --------- Плагин не найден Не установлен или не указан в PATH Выполнить go install ... или добавить в конфиг как remote Ошибка импорта .proto Отсутствует репозиторий в deps Добавить адрес в секцию deps и easyp mod update Несовместимые изменения на каждом PR Отсутствует игнор/настройка сравнения Уточнить ветку/тег в --against или настроить breaking.ignore Локально работает, в CI падает В CI нет зависимостей (не вызван update) Добавить шаг easyp mod update перед generate Дубликаты сгенерированных файлов Изменена структура путей или out Синхронизировать out и paths: source_relative опции"},{"id":"migration/protoc::10-go::19","title":"Миграция с protoc на EasyP","section":"10. Минимальный пример конфигурации (только Go)","path":"/docs/guide/migration/protoc#10-go","headings":["10. Минимальный пример конфигурации (только Go)"],"excerpt":"Минимальный пример конфигурации (только Go)","content":"Минимальный пример конфигурации (только Go)"},{"id":"migration/protoc::10-go::20","title":"Миграция с protoc на EasyP","section":"10. Минимальный пример конфигурации (только Go)","path":"/docs/guide/migration/protoc#10-go","headings":["10. Минимальный пример конфигурации (только Go)"],"excerpt":"Минимальный пример конфигурации (только Go) Команды:","content":"Минимальный пример конфигурации (только Go) Команды:"},{"id":"migration/protoc::11-go-grpc-gateway-validate-breaking-lint::21","title":"Миграция с protoc на EasyP","section":"11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)","path":"/docs/guide/migration/protoc#11-go-grpc-gateway-validate-breaking-lint","headings":["11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)"],"excerpt":"Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint) ```yaml lint: use: - ENUM_FIRST_VALUE_ZERO - SERVICE_SUFFIX allow_comment_ignores: false enum_zero_value_suffix: _NONE service_suffix: Service","content":"Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint) ```yaml lint: use: - ENUM_FIRST_VALUE_ZERO - SERVICE_SUFFIX allow_comment_ignores: false enum_zero_value_suffix: _NONE service_suffix: Service"},{"id":"migration/protoc::11-go-grpc-gateway-validate-breaking-lint::22","title":"Миграция с protoc на EasyP","section":"11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)","path":"/docs/guide/migration/protoc#11-go-grpc-gateway-validate-breaking-lint","headings":["11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)"],"excerpt":"Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint) deps: - github.com/googleapis/googleapis - github.com/envoyproxy/protoc-gen-validate","content":"Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint) deps: - github.com/googleapis/googleapis - github.com/envoyproxy/protoc-gen-validate"},{"id":"migration/protoc::11-go-grpc-gateway-validate-breaking-lint::23","title":"Миграция с protoc на EasyP","section":"11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)","path":"/docs/guide/migration/protoc#11-go-grpc-gateway-validate-breaking-lint","headings":["11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)"],"excerpt":"Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint) generate: plugins: - name: go out: gen/go opts: paths: source_relative - name: go-grpc out: gen/go opts: paths: source_relative require_unimplemented_","content":"Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint) generate: plugins: - name: go out: gen/go opts: paths: source_relative - name: go-grpc out: gen/go opts: paths: source_relative require_unimplemented_servers: false - name: validate out: gen/go opts: paths: source_relative lang: \"go\" - name: grpc-gateway out: gen/go opts: paths: source_relative - name: openapiv2 out: gen/openapi opts: simple_operation_ids: true"},{"id":"migration/protoc::11-go-grpc-gateway-validate-breaking-lint::24","title":"Миграция с protoc на EasyP","section":"11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)","path":"/docs/guide/migration/protoc#11-go-grpc-gateway-validate-breaking-lint","headings":["11. Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint)"],"excerpt":"Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint) breaking: against_git_ref: main ignore: - ENUM_VALUE_SAME_NAME ```","content":"Расширенный пример (Go + gRPC + Gateway + Validate + Breaking и Lint) breaking: against_git_ref: main ignore: - ENUM_VALUE_SAME_NAME ```"},{"id":"migration/protoc::12-checklist::25","title":"Миграция с protoc на EasyP","section":"12. Checklist миграции","path":"/docs/guide/migration/protoc#12-checklist","headings":["12. Checklist миграции"],"excerpt":"Checklist миграции [ ] Собраны все текущие вызовы protoc. [ ] Создан easyp.yaml с секциями generate и (опционально) lint, breaking. [ ] Добавлены все внешние зависимости в deps. [ ] Успешно выполнен easyp mod update. [ ]","content":"Checklist миграции [ ] Собраны все текущие вызовы protoc. [ ] Создан easyp.yaml с секциями generate и (опционально) lint, breaking. [ ] Добавлены все внешние зависимости в deps. [ ] Успешно выполнен easyp mod update. [ ] easyp generate даёт идентичный или ожидаемо обновлённый результат. [ ] easyp lint проходит без критичных ошибок (или ошибки обработаны). [ ] easyp breaking --against git-ref=origin/main не выдаёт неожиданных блокирующих нарушений. [ ] CI обновлён (заменены прямые вызовы protoc). [ ] Документация проекта обновлена (README: как генерировать)."},{"id":"migration/protoc::13::26","title":"Миграция с protoc на EasyP","section":"13. Дополнительные рекомендации","path":"/docs/guide/migration/protoc#13","headings":["13. Дополнительные рекомендации"],"excerpt":"Дополнительные рекомендации Сначала мигрируйте один сервис / пакет — снизит риск массовых конфликтов. Закоммитьте easyp.yaml отдельно, затем выполните генерацию и линт — проще ревью. Если нужны разные наборы плагинов для","content":"Дополнительные рекомендации Сначала мигрируйте один сервис / пакет — снизит риск массовых конфликтов. Закоммитьте easyp.yaml отдельно, затем выполните генерацию и линт — проще ревью. Если нужны разные наборы плагинов для разных микросервисов — используйте несколько конфигов (например: easyp.microservice-a.yaml + easyp.microservice-b.yaml). Внедрите проверку актуальности генерации: шаг CI, который валидирует отсутствие diff после easyp generate."},{"id":"migration/protoc::14::27","title":"Миграция с protoc на EasyP","section":"14. Статус","path":"/docs/guide/migration/protoc#14","headings":["14. Статус"],"excerpt":"Статус Этот файл — русская расширенная версия, заменяющая placeholder “Work in progress”. При появлении новых возможностей EasyP (дополнительные поля в конфиге, новые плагины, расширения breaking‑проверок) обновите соотв","content":"Статус Этот файл — русская расширенная версия, заменяющая placeholder “Work in progress”. При появлении новых возможностей EasyP (дополнительные поля в конфиге, новые плагины, расширения breaking‑проверок) обновите соответствующие разделы."},{"id":"migration/protoc::14::28","title":"Миграция с protoc на EasyP","section":"14. Статус","path":"/docs/guide/migration/protoc#14","headings":["14. Статус"],"excerpt":"Статус Если нужен упрощённый вариант (только перевод без расширения), сообщи — могу сократить до минимальных двух блоков.","content":"Статус Если нужен упрощённый вариант (только перевод без расширения), сообщи — могу сократить до минимальных двух блоков."},{"id":"migration/protolock::top::0","title":"Protolock","path":"/docs/guide/migration/protolock","headings":[],"excerpt":"Protolock В процессе разработки","content":"Protolock В процессе разработки"},{"id":"migration/prototool::top::0","title":"Prototool","section":"Состояние","path":"/docs/guide/migration/prototool","headings":["Состояние"],"excerpt":"Состояние Этот раздел был помечен как “Work in progress” в оригинальной английской версии. Ниже — переведённое и дополненное практическое руководство по миграции с Prototool на EasyP. Имя инструмента Prototool не перевод","content":"Состояние Этот раздел был помечен как “Work in progress” в оригинальной английской версии. Ниже — переведённое и дополненное практическое руководство по миграции с Prototool на EasyP. Имя инструмента Prototool не переводится."},{"id":"migration/prototool::top::1","title":"Prototool","section":"Цель миграции","path":"/docs/guide/migration/prototool","headings":["Цель миграции"],"excerpt":"Цель миграции Перейти от конфигурации и рабочих процессов Prototool к эквиваленту на EasyP с минимальными изменениями, сохранив: Линтинг .proto файлов. Генерацию кода через protoc-плагины. Управление зависимостями. Прове","content":"Цель миграции Перейти от конфигурации и рабочих процессов Prototool к эквиваленту на EasyP с минимальными изменениями, сохранив: Линтинг .proto файлов. Генерацию кода через protoc-плагины. Управление зависимостями. Проверку несовместимых изменений (в Prototool это приходилось реализовывать внешними инструментами; в EasyP встроено)."},{"id":"migration/prototool::top::2","title":"Prototool","section":"Кратко о различиях","path":"/docs/guide/migration/prototool","headings":["Кратко о различиях"],"excerpt":"Кратко о различиях Область Prototool EasyP Комментарий --------- ----------- ------- ------------- Конфигурация prototool.yaml easyp.yaml Форматы YAML/JSON поддерживаются; структура отличается. Линтинг Встроенные наборы ","content":"Кратко о различиях Область Prototool EasyP Комментарий --------- ----------- ------- ------------- Конфигурация prototool.yaml easyp.yaml Форматы YAML/JSON поддерживаются; структура отличается. Линтинг Встроенные наборы + кастомные правила Наборы через lint.use, тонкая настройка ignore/except EasyP даёт больше гибкости группировки. Генерация Раздел generate + плагины через Docker/локально generate.plugins (локальные/WASM/удалённые) EasyP может выполнять плагины удалённо (API Service). Зависимости Обычно через include-пути / внешние git clone вручную Секция deps (Git репозитории) + mod update Более декларативно. Breaking Changes Нет встроенного механизма Секция breaking + команда easyp breaking Из коробки. Lock-in Зависимость от модели Prototool Минималистичный формат, «любой Git — пакет» Облегчает выход / интеграцию с другими экосистемами."},{"id":"migration/prototool::prototool::3","title":"Prototool","section":"Типовая структура Prototool (упрощённо)","path":"/docs/guide/migration/prototool#prototool","headings":["Типовая структура Prototool (упрощённо)"],"excerpt":"Типовая структура Prototool (упрощённо)","content":"Типовая структура Prototool (упрощённо)"},{"id":"migration/prototool::prototool::4","title":"Prototool","section":"Типовая структура Prototool (упрощённо)","path":"/docs/guide/migration/prototool#prototool","headings":["Типовая структура Prototool (упрощённо)"],"excerpt":"Типовая структура Prototool (упрощённо) Особенности: include_paths задаёт пути поиска импортов. lint.group + rules.add/remove регулируют активные проверки. generate.plugins описывает плагины для protoc.","content":"Типовая структура Prototool (упрощённо) Особенности: include_paths задаёт пути поиска импортов. lint.group + rules.add/remove регулируют активные проверки. generate.plugins описывает плагины для protoc."},{"id":"migration/prototool::prototool::5","title":"Prototool","section":"Типовая структура Prototool (упрощённо)","path":"/docs/guide/migration/prototool#prototool","headings":["Типовая структура Prototool (упрощённо)"],"excerpt":"Типовая структура Prototool (упрощённо) ---","content":"Типовая структура Prototool (упрощённо) ---"},{"id":"migration/prototool::easyp::6","title":"Prototool","section":"Эквивалент на EasyP","path":"/docs/guide/migration/prototool#easyp","headings":["Эквивалент на EasyP"],"excerpt":"Эквивалент на EasyP ```yaml easyp.yaml (пример) deps: - github.com/org/common-protos # вместо manual include - github.com/org/third-party-protos","content":"Эквивалент на EasyP ```yaml easyp.yaml (пример) deps: - github.com/org/common-protos # вместо manual include - github.com/org/third-party-protos"},{"id":"migration/prototool::easyp::7","title":"Prototool","section":"Эквивалент на EasyP","path":"/docs/guide/migration/prototool#easyp","headings":["Эквивалент на EasyP"],"excerpt":"Эквивалент на EasyP lint: use: - MINIMAL - BASIC enum_zero_value_suffix: \"_NONE\" service_suffix: \"Service\" ignore: - COMMENT_FIELD except: - ENUM_VALUE_PREFIX allow_comment_ignores: true","content":"Эквивалент на EasyP lint: use: - MINIMAL - BASIC enum_zero_value_suffix: \"_NONE\" service_suffix: \"Service\" ignore: - COMMENT_FIELD except: - ENUM_VALUE_PREFIX allow_comment_ignores: true"},{"id":"migration/prototool::easyp::8","title":"Prototool","section":"Эквивалент на EasyP","path":"/docs/guide/migration/prototool#easyp","headings":["Эквивалент на EasyP"],"excerpt":"Эквивалент на EasyP generate: plugins: - name: go out: gen/go opts: paths: source_relative - name: go-grpc out: gen/go opts: paths: source_relative require_unimplemented_servers: false","content":"Эквивалент на EasyP generate: plugins: - name: go out: gen/go opts: paths: source_relative - name: go-grpc out: gen/go opts: paths: source_relative require_unimplemented_servers: false"},{"id":"migration/prototool::easyp::9","title":"Prototool","section":"Эквивалент на EasyP","path":"/docs/guide/migration/prototool#easyp","headings":["Эквивалент на EasyP"],"excerpt":"Эквивалент на EasyP breaking: against_git_ref: main ignore: - FIELD_SAME_TYPE ```","content":"Эквивалент на EasyP breaking: against_git_ref: main ignore: - FIELD_SAME_TYPE ```"},{"id":"migration/prototool::easyp::10","title":"Prototool","section":"Эквивалент на EasyP","path":"/docs/guide/migration/prototool#easyp","headings":["Эквивалент на EasyP"],"excerpt":"Эквивалент на EasyP Комментарии: deps заменяет необходимость вручную прописывать include paths: EasyP подтянет их через git. lint.use активирует наборы правил (MINIMAL/BASIC/DEFAULT и т.д.). Дополнительные настройки (enu","content":"Эквивалент на EasyP Комментарии: deps заменяет необходимость вручную прописывать include paths: EasyP подтянет их через git. lint.use активирует наборы правил (MINIMAL/BASIC/DEFAULT и т.д.). Дополнительные настройки (enum_zero_value_suffix, service_suffix) задают политики нейминга. breaking позволяет сразу контролировать несовместимые изменения."},{"id":"migration/prototool::top::11","title":"Prototool","section":"Шаги миграции","path":"/docs/guide/migration/prototool","headings":["Шаги миграции"],"excerpt":"Шаги миграции Инвентаризация: - Соберите текущий prototool.yaml, списки include paths и плагины. - Зафиксируйте используемые кастомные правила, если есть.","content":"Шаги миграции Инвентаризация: - Соберите текущий prototool.yaml, списки include paths и плагины. - Зафиксируйте используемые кастомные правила, если есть."},{"id":"migration/prototool::top::12","title":"Prototool","section":"Шаги миграции","path":"/docs/guide/migration/prototool","headings":["Шаги миграции"],"excerpt":"Шаги миграции Зависимости: - Любые каталоги, которые вы вручную добавляли в include_paths, преобразуйте в git-репозитории (если ещё нет). - Добавьте их в deps (формат: github.com/owner/repo или путь к вашей приватной сис","content":"Шаги миграции Зависимости: - Любые каталоги, которые вы вручную добавляли в include_paths, преобразуйте в git-репозитории (если ещё нет). - Добавьте их в deps (формат: github.com/owner/repo или путь к вашей приватной системе Git)."},{"id":"migration/prototool::top::13","title":"Prototool","section":"Шаги миграции","path":"/docs/guide/migration/prototool","headings":["Шаги миграции"],"excerpt":"Шаги миграции Линтинг: - Определите какой group использовался (basic, default, …) → сопоставьте с наборами EasyP (MINIMAL, BASIC, DEFAULT). - Индивидуальные добавления (rules.add) перенесите в lint.use или except/ignore:","content":"Шаги миграции Линтинг: - Определите какой group использовался (basic, default, …) → сопоставьте с наборами EasyP (MINIMAL, BASIC, DEFAULT). - Индивидуальные добавления (rules.add) перенесите в lint.use или except/ignore: - Если правило нужно активировать — включите через набор или явно. - Если нужно отключить — добавьте в ignore."},{"id":"migration/prototool::top::14","title":"Prototool","section":"Шаги миграции","path":"/docs/guide/migration/prototool","headings":["Шаги миграции"],"excerpt":"Шаги миграции Генерация: - Сохраните список плагинов. В большинстве случаев имена совпадут (go, go-grpc, др.). - Если раньше использовали Docker-окружение Prototool — проверьте поддержку удалённых плагинов через API Serv","content":"Шаги миграции Генерация: - Сохраните список плагинов. В большинстве случаев имена совпадут (go, go-grpc, др.). - Если раньше использовали Docker-окружение Prototool — проверьте поддержку удалённых плагинов через API Service EasyP (опционально). - Перепишите в секцию generate.plugins."},{"id":"migration/prototool::top::15","title":"Prototool","section":"Шаги миграции","path":"/docs/guide/migration/prototool","headings":["Шаги миграции"],"excerpt":"Шаги миграции Дополнительные опции: - Настройки нейминга enum/service перенести в enum_zero_value_suffix, service_suffix. - Если были внешние скрипты для проверки breaking changes — удалите их и включите breaking с again","content":"Шаги миграции Дополнительные опции: - Настройки нейминга enum/service перенести в enum_zero_value_suffix, service_suffix. - Если были внешние скрипты для проверки breaking changes — удалите их и включите breaking с against_git_ref."},{"id":"migration/prototool::top::16","title":"Prototool","section":"Шаги миграции","path":"/docs/guide/migration/prototool","headings":["Шаги миграции"],"excerpt":"Шаги миграции Верификация: - Запустите: easyp mod update (скачивание deps). - Затем: easyp lint. - Далее: easyp generate. - И, если нужно: easyp breaking --against git-ref=origin/main.","content":"Шаги миграции Верификация: - Запустите: easyp mod update (скачивание deps). - Затем: easyp lint. - Далее: easyp generate. - И, если нужно: easyp breaking --against git-ref=origin/main."},{"id":"migration/prototool::top::17","title":"Prototool","section":"Шаги миграции","path":"/docs/guide/migration/prototool","headings":["Шаги миграции"],"excerpt":"Шаги миграции CI/CD: - Обновите workflow (GitHub Actions / GitLab) — замените вызовы Prototool на EasyP команды. - Добавьте шаг проверки несовместимых изменений.","content":"Шаги миграции CI/CD: - Обновите workflow (GitHub Actions / GitLab) — замените вызовы Prototool на EasyP команды. - Добавьте шаг проверки несовместимых изменений."},{"id":"migration/prototool::top::18","title":"Prototool","section":"Сопоставление правил (общая идея)","path":"/docs/guide/migration/prototool","headings":["Сопоставление правил (общая идея)"],"excerpt":"Сопоставление правил (общая идея) Prototool концепт EasyP ------------------- ------ lint.group lint.use (наборы) rules.add/remove except / ignore include_paths deps (git источники) plugins generate.plugins (внешние скри","content":"Сопоставление правил (общая идея) Prototool концепт EasyP ------------------- ------ lint.group lint.use (наборы) rules.add/remove except / ignore include_paths deps (git источники) plugins generate.plugins (внешние скрипты для breaking) breaking секция + команда"},{"id":"migration/prototool::top::19","title":"Prototool","section":"Сопоставление правил (общая идея)","path":"/docs/guide/migration/prototool","headings":["Сопоставление правил (общая идея)"],"excerpt":"Сопоставление правил (общая идея) ---","content":"Сопоставление правил (общая идея) ---"},{"id":"migration/prototool::top::20","title":"Prototool","section":"Приватные репозитории","path":"/docs/guide/migration/prototool","headings":["Приватные репозитории"],"excerpt":"Приватные репозитории Если ранее Prototool просто видел локальные каталоги, теперь: Добавьте SSH ключи/токены в CI для доступа к приватным Git. Укажите их в deps как обычные git-URL (формат зависит от реализации EasyP; д","content":"Приватные репозитории Если ранее Prototool просто видел локальные каталоги, теперь: Добавьте SSH ключи/токены в CI для доступа к приватным Git. Укажите их в deps как обычные git-URL (формат зависит от реализации EasyP; для публичных — стандартный)."},{"id":"migration/prototool::top::21","title":"Prototool","section":"Типовые проблемы при миграции","path":"/docs/guide/migration/prototool","headings":["Типовые проблемы при миграции"],"excerpt":"Типовые проблемы при миграции Проблема Причина Решение ---------- --------- --------- Правила линтера не совпадают Неверное сопоставление групп Проверить документацию EasyP по наборам правил Импорты не находятся Забыли д","content":"Типовые проблемы при миграции Проблема Причина Решение ---------- --------- --------- Правила линтера не совпадают Неверное сопоставление групп Проверить документацию EasyP по наборам правил Импорты не находятся Забыли добавить репозиторий в deps Добавить в deps и выполнить easyp mod update Генерация падает на опциях Плагин требует другие flags Проверить opts и документацию плагина breaking сообщает слишком много Слишком строгий базовый набор Добавить конкретные правила в breaking.ignore Долгая генерация Нет кеша/много deps Включить кэширование в CI (vendor/.easyp/deps)"},{"id":"migration/prototool::top::22","title":"Prototool","section":"Типовые проблемы при миграции","path":"/docs/guide/migration/prototool","headings":["Типовые проблемы при миграции"],"excerpt":"Типовые проблемы при миграции ---","content":"Типовые проблемы при миграции ---"},{"id":"migration/prototool::top::23","title":"Prototool","section":"Минимальная конфигурация после миграции","path":"/docs/guide/migration/prototool","headings":["Минимальная конфигурация после миграции"],"excerpt":"Минимальная конфигурация после миграции","content":"Минимальная конфигурация после миграции"},{"id":"migration/prototool::top::24","title":"Prototool","section":"Минимальная конфигурация после миграции","path":"/docs/guide/migration/prototool","headings":["Минимальная конфигурация после миграции"],"excerpt":"Минимальная конфигурация после миграции ---","content":"Минимальная конфигурация после миграции ---"},{"id":"migration/prototool::top::25","title":"Prototool","section":"Рекомендации по упрощению","path":"/docs/guide/migration/prototool","headings":["Рекомендации по упрощению"],"excerpt":"Рекомендации по упрощению Начните с минимального lint.use (MINIMAL), затем постепенно включайте дополнительные наборы. Не переносите слепо все ignore — часть правил может уже быть улучшена в EasyP. Сначала настроить deps","content":"Рекомендации по упрощению Начните с минимального lint.use (MINIMAL), затем постепенно включайте дополнительные наборы. Не переносите слепо все ignore — часть правил может уже быть улучшена в EasyP. Сначала настроить deps и генерацию, затем усложнять линт/нейминг. Фиксируйте миграцию по шагам (коммиты: deps → lint → generate → breaking → CI)."},{"id":"migration/prototool::top::26","title":"Prototool","section":"Проверка результата","path":"/docs/guide/migration/prototool","headings":["Проверка результата"],"excerpt":"Проверка результата Скрипт локальной быстрой проверки (пример):","content":"Проверка результата Скрипт локальной быстрой проверки (пример):"},{"id":"migration/prototool::top::27","title":"Prototool","section":"Проверка результата","path":"/docs/guide/migration/prototool","headings":["Проверка результата"],"excerpt":"Проверка результата ```bash #!/usr/bin/env bash set -euo pipefail","content":"Проверка результата ```bash #!/usr/bin/env bash set -euo pipefail"},{"id":"migration/prototool::top::28","title":"Prototool","section":"Проверка результата","path":"/docs/guide/migration/prototool","headings":["Проверка результата"],"excerpt":"Проверка результата echo \"[1] deps update\" easyp mod update","content":"Проверка результата echo \"[1] deps update\" easyp mod update"},{"id":"migration/prototool::top::29","title":"Prototool","section":"Проверка результата","path":"/docs/guide/migration/prototool","headings":["Проверка результата"],"excerpt":"Проверка результата echo \"[2] lint\" easyp lint","content":"Проверка результата echo \"[2] lint\" easyp lint"},{"id":"migration/prototool::top::30","title":"Prototool","section":"Проверка результата","path":"/docs/guide/migration/prototool","headings":["Проверка результата"],"excerpt":"Проверка результата echo \"[3] breaking vs main\" easyp breaking --against git-ref=origin/main echo \"Breaking changes detected (review needed)\"","content":"Проверка результата echo \"[3] breaking vs main\" easyp breaking --against git-ref=origin/main echo \"Breaking changes detected (review needed)\""},{"id":"migration/prototool::top::31","title":"Prototool","section":"Проверка результата","path":"/docs/guide/migration/prototool","headings":["Проверка результата"],"excerpt":"Проверка результата echo \"[4] generate\" easyp generate","content":"Проверка результата echo \"[4] generate\" easyp generate"},{"id":"migration/prototool::top::32","title":"Prototool","section":"Проверка результата","path":"/docs/guide/migration/prototool","headings":["Проверка результата"],"excerpt":"Проверка результата echo \"Done.\" ```","content":"Проверка результата echo \"Done.\" ```"},{"id":"migration/prototool::top::33","title":"Prototool","section":"Заключение","path":"/docs/guide/migration/prototool","headings":["Заключение"],"excerpt":"Заключение Миграция с Prototool на EasyP сводится к: Переносу путей и внешних каталогов в декларативные deps. Переформатированию линта под lint.use + ignore/except. Переносу генерации в generate.plugins. Добавлению встро","content":"Заключение Миграция с Prototool на EasyP сводится к: Переносу путей и внешних каталогов в декларативные deps. Переформатированию линта под lint.use + ignore/except. Переносу генерации в generate.plugins. Добавлению встроенного механизма breaking. Адаптации CI."},{"id":"migration/prototool::top::34","title":"Prototool","section":"Заключение","path":"/docs/guide/migration/prototool","headings":["Заключение"],"excerpt":"Заключение После этого конфигурация становится более прозрачной, а проверка несовместимых изменений — из коробки.","content":"Заключение После этого конфигурация становится более прозрачной, а проверка несовместимых изменений — из коробки."},{"id":"migration/prototool::top::35","title":"Prototool","section":"Заключение","path":"/docs/guide/migration/prototool","headings":["Заключение"],"excerpt":"Заключение *Готово: базовый перевод и расширенное руководство по миграции с Prototool на EasyP.*","content":"Заключение *Готово: базовый перевод и расширенное руководство по миграции с Prototool на EasyP.*"},{"id":"TRANSLATION_STATUS::top::0","title":"Translation Status (ru-guide)","path":"/docs/guide/TRANSLATION_STATUS","headings":[],"excerpt":"Этот файл отслеживает прогресс перевода русской документации. Используемые статусы: TODO — требуется перевод IN_PROGRESS — перевод начат, требуется вычитка DONE — перевод завершён и вычитан SKIPPED — не требует перевода ","content":"Этот файл отслеживает прогресс перевода русской документации. Используемые статусы: TODO — требуется перевод IN_PROGRESS — перевод начат, требуется вычитка DONE — перевод завершён и вычитан SKIPPED — не требует перевода (намеренно оставлено на английском)"},{"id":"TRANSLATION_STATUS::top::1","title":"Translation Status (ru-guide)","path":"/docs/guide/TRANSLATION_STATUS","headings":[],"excerpt":"Правила: После полного перевода файла убрать исходный английский текст и маркер Термины протокола и ключевые идентификаторы (названия правил, CLI команды, YAML ключи) НЕ переводим. Если структура исходного файла изменила","content":"Правила: После полного перевода файла убрать исходный английский текст и маркер Термины протокола и ключевые идентификаторы (названия правил, CLI команды, YAML ключи) НЕ переводим. Если структура исходного файла изменилась — добавить в начало: Для больших изменений: сначала IN_PROGRESS, после вычитки менять на DONE."},{"id":"TRANSLATION_STATUS::summary::2","title":"Translation Status (ru-guide)","section":"Summary","path":"/docs/guide/TRANSLATION_STATUS#summary","headings":["Summary"],"excerpt":"Summary Итого файлов: 76 DONE: 76 IN_PROGRESS: 0 TODO: 0","content":"Summary Итого файлов: 76 DONE: 76 IN_PROGRESS: 0 TODO: 0"},{"id":"TRANSLATION_STATUS::priority-order::3","title":"Translation Status (ru-guide)","section":"Priority Order (рекомендованный)","path":"/docs/guide/TRANSLATION_STATUS#priority-order","headings":["Priority Order (рекомендованный)"],"excerpt":"Priority Order (рекомендованный) introduction/what-is.md introduction/quickstart.md introduction/install.md cli/linter/linter.md cli/generator/generator.md cli/package-manager/package-manager.md cli/breaking-changes/brea","content":"Priority Order (рекомендованный) introduction/what-is.md introduction/quickstart.md introduction/install.md cli/linter/linter.md cli/generator/generator.md cli/package-manager/package-manager.md cli/breaking-changes/breaking-changes.md api-service/overview.md migration/* (пакетом)"},{"id":"TRANSLATION_STATUS::priority-order::4","title":"Translation Status (ru-guide)","section":"Priority Order (рекомендованный)","path":"/docs/guide/TRANSLATION_STATUS#priority-order","headings":["Priority Order (рекомендованный)"],"excerpt":"Priority Order (рекомендованный) ---","content":"Priority Order (рекомендованный) ---"},{"id":"TRANSLATION_STATUS::file-status-table::5","title":"Translation Status (ru-guide)","section":"File Status Table","path":"/docs/guide/TRANSLATION_STATUS#file-status-table","headings":["File Status Table"],"excerpt":"File Status Table File Status Notes ------ -------- ------- introduction/what-is.md DONE Полный перевод выполнен introduction/quickstart.md DONE Структура сохранена, перевод вычитан introduction/install.md DONE Переведен","content":"File Status Table File Status Notes ------ -------- ------- introduction/what-is.md DONE Полный перевод выполнен introduction/quickstart.md DONE Структура сохранена, перевод вычитан introduction/install.md DONE Переведено, команды проверены api-service/overview.md DONE Переведено ci-cd/github-actions.md DONE Переведено ci-cd/gitlab.md DONE Переведено cli/auto-completion/auto-completion.md DONE Переведено cli/breaking-changes/breaking-changes.md DONE Переведено и вычитано cli/breaking-changes/rules/enum-no-delete.md DONE Переведено cli/breaking-changes/rules/enum-value-no-delete.md DONE Переведено cli/breaking-changes/rules/enum-value-same-name.md DONE Переведено cli/breaking-changes/rules/field-no-delete.md DONE Переведено cli/breaking-changes/rules/field-same-cardinality.md DONE Переведено cli/breaking-changes/rules/field-same-type.md DONE Переведено cli/breaking-changes/rules/import-no-delete.md DONE Переведено cli/breaking-changes/rules/message-no-delete.md DONE Переведено cli/breaking-changes/rules/oneof-field-no-delete.md DONE Переведено cli/breaking-changes/rules/oneof-field-same-type.md DONE Переведено cli/breaking-changes/rules/oneof-no-delete.md DONE Переведено cli/breaking-changes/rules/rpc-no-delete.md DONE Переведено cli/breaking-changes/rules/rpc-same-request-type.md DONE Переведено cli/breaking-changes/rules/rpc-same-response-type.md DONE Переведено cli/breaking-changes/rules/service-no-delete.md DONE Переведено cli/configuration/configuration.md DONE Переведено cli/generator/examples/go.md DONE Переведено cli/generator/examples/grpc-gateway.md DONE Переведено cli/generator/examples/validate.md DONE Переведено cli/generator/generator.md DONE Переведено и вычитано cli/linter/linter.md DONE Переведено и вычитано cli/linter/rules/comment-enum-value.md DONE Переведено cli/linter/rules/comment-enum.md DONE Переведено cli/linter/rules/comment-field.md DONE Переведено cli/linter/rules/comment-message.md DONE Переведено cli/linter/rules/comment-oneof.md DONE Переведено cli/linter/rules/comment-rpc.md DONE Переведено cli/linter/rules/comment-service.md DONE Переведено cli/linter/rules/directory-same-package.md DONE Переведено cli/linter/rules/enum-first-value-zero.md DONE Переведено cli/linter/rules/enum-no-allow-alias.md DONE Переведено cli/linter/rules/enum-pascal-case.md DONE Переведено cli/linter/rules/enum-value-prefix.md DONE Переведено cli/linter/rules/enum-value-upper-snake-case.md DONE Переведено cli/linter/rules/enum-zero-value-suffix.md DONE Переведено cli/linter/rules/field-lower-snake-case.md DONE Переведено cli/linter/rules/file-lower-snake-case.md DONE Переведено cli/linter/rules/import-no-public.md DONE Переведено cli/linter/rules/import-no-weak.md DONE Переведено cli/linter/rules/import-used.md DONE Переведено cli/linter/rules/message-pascal-case.md DONE Переведено cli/linter/rules/oneof-lower-snake-case.md DONE Переведено cli/linter/rules/package-defined.md DONE Переведено cli/linter/rules/package-directory-match.md DONE Переведено cli/linter/rules/package-lower-snake-case.md DONE Переведено cli/linter/rules/package-same-csharp-namespace.md DONE Переведено cli/linter/rules/package-same-directory.md DONE Переведено cli/linter/rules/package-same-go-package.md DONE Переведено cli/linter/rules/package-same-java-multiple-files.md DONE Переведено cli/linter/rules/package-same-java-package.md DONE Переведено cli/linter/rules/package-same-php-namespace.md DONE Переведено cli/linter/rules/package-same-ruby-package.md DONE Переведено cli/linter/rules/package-same-swift-prefix.md DONE Переведено cli/linter/rules/package-version-suffix.md DONE Переведено cli/linter/rules/rpc-no-client-streaming.md DONE Переведено cli/linter/rules/rpc-no-server-streaming.md DONE Переведено cli/linter/rules/rpc-pascal-case.md DONE Переведено cli/linter/rules/rpc-request-response-unique.md DONE Переведено cli/linter/rules/rpc-request-standard-name.md DONE Переведено cli/linter/rules/rpc-response-standard-name.md DONE Переведено cli/linter/rules/service-pascal-case.md DONE Переведено cli/linter/rules/service-suffix.md DONE Переведено cli/package-manager/easyp-vs-buf.md DONE Переведено cli/package-manager/package-manager.md DONE Переведено и вычитано migration/buf-cli.md DONE Переведено migration/protoc.md DONE Переведено migration/protolock.md DONE Переведено migration/prototool.md DONE Переведено"},{"id":"TRANSLATION_STATUS::workflow::6","title":"Translation Status (ru-guide)","section":"Workflow","path":"/docs/guide/TRANSLATION_STATUS#workflow","headings":["Workflow"],"excerpt":"Workflow Выбираем файл со статусом TODO. Меняем статус на IN_PROGRESS здесь. Переводим, проверяем терминологию (сверка с глоссарием — добавить позже). Меняем статус на DONE. Удаляем маркер внутри файла.","content":"Workflow Выбираем файл со статусом TODO. Меняем статус на IN_PROGRESS здесь. Переводим, проверяем терминологию (сверка с глоссарием — добавить позже). Меняем статус на DONE. Удаляем маркер внутри файла."},{"id":"TRANSLATION_STATUS::planned-terminology::7","title":"Translation Status (ru-guide)","section":"Planned Terminology (черновик)","path":"/docs/guide/TRANSLATION_STATUS#planned-terminology","headings":["Planned Terminology (черновик)"],"excerpt":"Planned Terminology (черновик) EN RU Notes ---- ---- ------- Linting Линтинг Транслитерация Breaking Changes Несовместимые изменения Название секции Dependency Зависимость Code Generation Генерация кода Lock file Lock-фа","content":"Planned Terminology (черновик) EN RU Notes ---- ---- ------- Linting Линтинг Транслитерация Breaking Changes Несовместимые изменения Название секции Dependency Зависимость Code Generation Генерация кода Lock file Lock-файл Remote Plugin Удалённый плагин Package Manager Менеджер пакетов"},{"id":"TRANSLATION_STATUS::planned-terminology::8","title":"Translation Status (ru-guide)","section":"Planned Terminology (черновик)","path":"/docs/guide/TRANSLATION_STATUS#planned-terminology","headings":["Planned Terminology (черновик)"],"excerpt":"Planned Terminology (черновик) (Будет дополнено.)","content":"Planned Terminology (черновик) (Будет дополнено.)"},{"id":"TRANSLATION_STATUS::planned-terminology::9","title":"Translation Status (ru-guide)","section":"Planned Terminology (черновик)","path":"/docs/guide/TRANSLATION_STATUS#planned-terminology","headings":["Planned Terminology (черновик)"],"excerpt":"Planned Terminology (черновик) ---","content":"Planned Terminology (черновик) ---"},{"id":"TRANSLATION_STATUS::top::10","title":"Translation Status (ru-guide)","section":"История обновлений","path":"/docs/guide/TRANSLATION_STATUS","headings":["История обновлений"],"excerpt":"История обновлений Initial file created: all statuses set (3 IN_PROGRESS, rest TODO). Marked breaking-changes page as DONE. Linter rules (41 файлов) переведены: статусы DONE. Breaking-changes rules (15 файлов) вычитаны и","content":"История обновлений Initial file created: all statuses set (3 IN_PROGRESS, rest TODO). Marked breaking-changes page as DONE. Linter rules (41 файлов) переведены: статусы DONE. Breaking-changes rules (15 файлов) вычитаны и помечены DONE. Все оставшиеся страницы переведены: итог DONE = 76."}]
\ No newline at end of file
diff --git a/docs/public/site.webmanifest b/docs/public/site.webmanifest
deleted file mode 100644
index 5814f0fc..00000000
--- a/docs/public/site.webmanifest
+++ /dev/null
@@ -1,44 +0,0 @@
-{
-  "name": "EasyP - Modern Protobuf Toolkit",
-  "short_name": "EasyP",
-  "description": "Современный инструментарий для работы с Protocol Buffers и gRPC API",
-  "start_url": "/",
-  "display": "standalone",
-  "background_color": "#020617",
-  "theme_color": "#3b82f6",
-  "orientation": "portrait-primary",
-  "categories": [
-    "developer",
-    "productivity"
-  ],
-  "lang": "ru",
-  "icons": [
-    {
-      "src": "/favicon-16.png",
-      "sizes": "16x16",
-      "type": "image/png"
-    },
-    {
-      "src": "/favicon-32.png",
-      "sizes": "32x32",
-      "type": "image/png"
-    },
-    {
-      "src": "/apple-touch-icon.png",
-      "sizes": "180x180",
-      "type": "image/png"
-    },
-    {
-      "src": "/icon-192.png",
-      "sizes": "192x192",
-      "type": "image/png",
-      "purpose": "maskable any"
-    },
-    {
-      "src": "/icon-512.png",
-      "sizes": "512x512",
-      "type": "image/png",
-      "purpose": "maskable any"
-    }
-  ]
-}
\ No newline at end of file
diff --git a/docs/scripts/generate-search-index.mjs b/docs/scripts/generate-search-index.mjs
deleted file mode 100644
index e0be8186..00000000
--- a/docs/scripts/generate-search-index.mjs
+++ /dev/null
@@ -1,232 +0,0 @@
-import fs from 'node:fs/promises'
-import path from 'node:path'
-import matter from 'gray-matter'
-
-const DOCS_ROOT = path.resolve('public/docs')
-const OUTPUT_ROOT = path.resolve('public/search')
-
-const LANG_CONFIGS = [
-  { sourceDir: 'guide', outputFile: 'index.en.json' },
-  { sourceDir: 'ru-guide', outputFile: 'index.ru.json' },
-]
-
-const EXCERPT_LENGTH = 220
-const MIN_CHUNK_LENGTH = 30
-
-async function getMarkdownFiles(dirPath) {
-  const entries = await fs.readdir(dirPath, { withFileTypes: true })
-  const files = await Promise.all(
-    entries.map(async (entry) => {
-      const fullPath = path.join(dirPath, entry.name)
-      if (entry.isDirectory()) {
-        return getMarkdownFiles(fullPath)
-      }
-      if (entry.isFile() && entry.name.endsWith('.md')) {
-        return [fullPath]
-      }
-      return []
-    }),
-  )
-
-  return files.flat().sort((a, b) => a.localeCompare(b))
-}
-
-function normalizeWhitespace(value) {
-  return value.replace(/\r/g, '\n').replace(/\s+/g, ' ').trim()
-}
-
-function stripMarkdown(markdown) {
-  return normalizeWhitespace(
-    markdown
-      .replace(/```[\s\S]*?```/g, ' ')
-      .replace(/~~~[\s\S]*?~~~/g, ' ')
-      .replace(/<!--[\s\S]*?-->/g, ' ')
-      .replace(/!\[([^\]]*)\]\([^)]+\)/g, '$1')
-      .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
-      .replace(/\[([^\]]+)\]\[[^\]]*\]/g, '$1')
-      .replace(/^#{1,6}\s+/gm, '')
-      .replace(/^>\s?/gm, '')
-      .replace(/^[-*+]\s+/gm, '')
-      .replace(/^\d+\.\s+/gm, '')
-      .replace(/`([^`]+)`/g, '$1')
-      .replace(/\|/g, ' ')
-      .replace(/<[^>]+>/g, ' ')
-      .replace(/\n+/g, ' '),
-  )
-}
-
-function stripHeadingFormatting(heading) {
-  return normalizeWhitespace(
-    heading
-      .replace(/`([^`]+)`/g, '$1')
-      .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
-      .replace(/\*\*([^*]+)\*\*/g, '$1')
-      .replace(/\*([^*]+)\*/g, '$1')
-      .replace(/<[^>]+>/g, ' '),
-  )
-}
-
-function generateHeadingId(text) {
-  return text
-    .toLowerCase()
-    .replace(/[^\w\s-]/g, '')
-    .replace(/\s+/g, '-')
-    .replace(/-+/g, '-')
-    .replace(/^-|-$/g, '')
-}
-
-function splitIntoSections(content) {
-  const lines = content.split('\n')
-  const sections = []
-  let current = { heading: null, anchor: '', lines: [] }
-
-  for (const line of lines) {
-    const headingMatch = line.match(/^(#{2,6})\s+(.+)$/)
-    if (headingMatch) {
-      if (current.heading || current.lines.length > 0) {
-        sections.push(current)
-      }
-
-      const heading = stripHeadingFormatting(headingMatch[2].trim())
-      current = {
-        heading,
-        anchor: generateHeadingId(heading),
-        lines: [],
-      }
-      continue
-    }
-
-    current.lines.push(line)
-  }
-
-  if (current.heading || current.lines.length > 0) {
-    sections.push(current)
-  }
-
-  return sections
-    .map((section) => ({
-      ...section,
-      text: section.lines.join('\n').trim(),
-    }))
-    .filter((section) => section.heading || section.text.length > 0)
-}
-
-function splitSectionToChunks(sectionText) {
-  const parts = sectionText
-    .split(/\n{2,}/)
-    .map((part) => part.trim())
-    .filter(Boolean)
-
-  return parts.length > 0 ? parts : [sectionText]
-}
-
-function extractTitle(frontmatter, content, relativePath) {
-  if (typeof frontmatter.title === 'string' && frontmatter.title.trim()) {
-    return frontmatter.title.trim()
-  }
-
-  const h1Match = content.match(/^#\s+(.+)$/m)
-  if (h1Match?.[1]) {
-    return stripHeadingFormatting(h1Match[1])
-  }
-
-  const fileName = path.basename(relativePath, '.md')
-  return fileName
-    .replace(/[-_]/g, ' ')
-    .replace(/\b\w/g, (char) => char.toUpperCase())
-}
-
-function toDocsRoute(relativePath) {
-  const withoutExt = relativePath.replace(/\.md$/, '')
-  return `/docs/guide/${withoutExt.split(path.sep).join('/')}`
-}
-
-function buildChunkedDocuments(markdown, relativePath) {
-  const parsed = matter(markdown)
-  const content = parsed.content || markdown
-  const basePath = toDocsRoute(relativePath)
-  const pageId = relativePath.replace(/\.md$/, '').split(path.sep).join('/')
-  const title = extractTitle(parsed.data, content, relativePath)
-  const sections = splitIntoSections(content)
-
-  const documents = []
-  let chunkIndex = 0
-
-  for (const section of sections) {
-    const rawChunks = splitSectionToChunks(section.text || '')
-    for (const rawChunk of rawChunks) {
-      const chunkSource = section.heading
-        ? `${section.heading}\n${rawChunk}`
-        : rawChunk
-
-      const cleanContent = stripMarkdown(chunkSource)
-      if (cleanContent.length < MIN_CHUNK_LENGTH) {
-        continue
-      }
-
-      const excerptSource =
-        typeof parsed.data.description === 'string' && parsed.data.description.trim()
-          ? parsed.data.description.trim()
-          : cleanContent
-      const excerpt = excerptSource.slice(0, EXCERPT_LENGTH)
-      const pathWithHash = section.anchor ? `${basePath}#${section.anchor}` : basePath
-
-      documents.push({
-        id: `${pageId}::${section.anchor || 'top'}::${chunkIndex}`,
-        title,
-        section: section.heading || undefined,
-        path: pathWithHash,
-        headings: section.heading ? [section.heading] : [],
-        excerpt,
-        content: cleanContent,
-      })
-      chunkIndex += 1
-    }
-  }
-
-  if (documents.length > 0) {
-    return documents
-  }
-
-  const fallbackContent = stripMarkdown(content)
-  return [{
-    id: `${pageId}::top::0`,
-    title,
-    section: undefined,
-    path: basePath,
-    headings: [],
-    excerpt: fallbackContent.slice(0, EXCERPT_LENGTH),
-    content: fallbackContent,
-  }]
-}
-
-async function buildIndexForLanguage(sourceDir) {
-  const languageRoot = path.join(DOCS_ROOT, sourceDir)
-  const markdownFiles = await getMarkdownFiles(languageRoot)
-
-  const nestedDocuments = await Promise.all(
-    markdownFiles.map(async (absoluteFilePath) => {
-      const markdown = await fs.readFile(absoluteFilePath, 'utf8')
-      const relativePath = path.relative(languageRoot, absoluteFilePath)
-      return buildChunkedDocuments(markdown, relativePath)
-    }),
-  )
-
-  return nestedDocuments.flat()
-}
-
-async function main() {
-  await fs.mkdir(OUTPUT_ROOT, { recursive: true })
-
-  for (const config of LANG_CONFIGS) {
-    const documents = await buildIndexForLanguage(config.sourceDir)
-    const outputPath = path.join(OUTPUT_ROOT, config.outputFile)
-    await fs.writeFile(outputPath, JSON.stringify(documents), 'utf8')
-    console.log(`Generated ${config.outputFile}: ${documents.length} documents`)
-  }
-}
-
-main().catch((error) => {
-  console.error('Failed to generate search index:', error)
-  process.exit(1)
-})
diff --git a/docs/scripts/migrate-vitepress.js b/docs/scripts/migrate-vitepress.js
deleted file mode 100644
index a0e56fbd..00000000
--- a/docs/scripts/migrate-vitepress.js
+++ /dev/null
@@ -1,355 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('fs').promises;
-const path = require('path');
-const matter = require('gray-matter');
-
-// Configuration
-const CONFIG = {
-    sourceDir: path.join(__dirname, '../public/docs'),
-    targetDir: path.join(__dirname, '../public/docs-migrated'),
-    backupDir: path.join(__dirname, '../public/docs-backup'),
-    dryRun: process.argv.includes('--dry-run'),
-    verbose: process.argv.includes('--verbose'),
-    stats: {
-        processed: 0,
-        skipped: 0,
-        errors: 0,
-        modified: 0
-    }
-};
-
-// Color codes for console output
-const colors = {
-    reset: '\x1b[0m',
-    bright: '\x1b[1m',
-    green: '\x1b[32m',
-    yellow: '\x1b[33m',
-    red: '\x1b[31m',
-    blue: '\x1b[34m',
-    cyan: '\x1b[36m'
-};
-
-// Logging helpers
-const log = {
-    info: (msg) => console.log(`${colors.blue}ℹ${colors.reset} ${msg}`),
-    success: (msg) => console.log(`${colors.green}✓${colors.reset} ${msg}`),
-    warning: (msg) => console.log(`${colors.yellow}⚠${colors.reset} ${msg}`),
-    error: (msg) => console.error(`${colors.red}✗${colors.reset} ${msg}`),
-    verbose: (msg) => CONFIG.verbose && console.log(`${colors.cyan}›${colors.reset} ${msg}`)
-};
-
-/**
- * Extract title from markdown content
- */
-function extractTitle(content) {
-    const match = content.match(/^#\s+(.+)$/m);
-    return match ? match[1].trim() : 'Untitled';
-}
-
-/**
- * Convert VitePress container blocks to HTML
- */
-function convertContainerBlocks(content) {
-    const containerTypes = ['tip', 'warning', 'danger', 'info', 'details'];
-    let modified = false;
-
-    containerTypes.forEach(type => {
-        const regex = new RegExp(`:::\\s*${type}(?:\\s+(.*))?\\n([\\s\\S]*?)\\n:::`, 'g');
-        const matches = content.match(regex);
-        if (matches) {
-            modified = true;
-            content = content.replace(regex, (match, title, body) => {
-                const titleHtml = title ? `\n<p class="custom-block-title">${title}</p>\n` : '';
-                return `<div class="${type} custom-block">${titleHtml}${body}\n</div>`;
-            });
-        }
-    });
-
-    return { content, modified };
-}
-
-/**
- * Convert VitePress code group blocks
- */
-function convertCodeGroups(content) {
-    let modified = false;
-
-    // Convert code-group blocks
-    const codeGroupRegex = /:::code-group\n([\s\S]*?)\n:::/g;
-    const matches = content.match(codeGroupRegex);
-
-    if (matches) {
-        modified = true;
-        content = content.replace(codeGroupRegex, (match, groupContent) => {
-            // Parse individual code blocks within the group
-            const codeBlocks = [];
-            const blockRegex = /```(\w+)(?:\s+\[(.+?)\])?\n([\s\S]*?)```/g;
-            let blockMatch;
-
-            while ((blockMatch = blockRegex.exec(groupContent)) !== null) {
-                const [, lang, label, code] = blockMatch;
-                codeBlocks.push({
-                    lang,
-                    label: label || lang,
-                    code: code.trim()
-                });
-            }
-
-            // Convert to tabs structure (will need custom component)
-            if (codeBlocks.length > 0) {
-                let result = '<div class="code-group">\n';
-                result += '<div class="code-group-tabs">\n';
-                codeBlocks.forEach((block, i) => {
-                    result += `  <button class="code-group-tab${i === 0 ? ' active' : ''}" data-tab="${i}">${block.label}</button>\n`;
-                });
-                result += '</div>\n';
-                codeBlocks.forEach((block, i) => {
-                    result += `<div class="code-group-content${i === 0 ? ' active' : ''}" data-content="${i}">\n\n`;
-                    result += '```' + block.lang + '\n';
-                    result += block.code + '\n';
-                    result += '```\n\n</div>\n';
-                });
-                result += '</div>';
-                return result;
-            }
-
-            return match;
-        });
-    }
-
-    return { content, modified };
-}
-
-/**
- * Add or update frontmatter
- */
-function ensureFrontmatter(content, filePath) {
-    const parsed = matter(content);
-    let modified = false;
-
-    // Add title if missing
-    if (!parsed.data.title) {
-        parsed.data.title = extractTitle(parsed.content);
-        modified = true;
-    }
-
-    // Add toc if content has multiple headings and no explicit toc setting
-    if (parsed.data.toc === undefined) {
-        const headingCount = (parsed.content.match(/^#{2,4}\s+/gm) || []).length;
-        if (headingCount >= 3 || parsed.content.includes('[[toc]]')) {
-            parsed.data.toc = true;
-            modified = true;
-        }
-    }
-
-    // Add description if missing (extract from first paragraph)
-    if (!parsed.data.description) {
-        const firstParagraph = parsed.content.match(/^(?!#)(?!\s*$)(.+)$/m);
-        if (firstParagraph) {
-            parsed.data.description = firstParagraph[1].substring(0, 160).trim();
-            modified = true;
-        }
-    }
-
-    return {
-        content: matter.stringify(parsed.content, parsed.data),
-        modified
-    };
-}
-
-/**
- * Convert VitePress specific syntax
- */
-function convertVitePressSpecificSyntax(content) {
-    let modified = false;
-    let result = content;
-
-    // Convert badge syntax
-    if (result.includes('<Badge')) {
-        modified = true;
-        result = result.replace(
-            /<Badge\s+type="(\w+)"(?:\s+text="([^"]+)")?\s*\/>/g,
-            '<span class="badge badge-$1">$2</span>'
-        );
-    }
-
-    // Convert custom anchor links {#custom-id}
-    const anchorRegex = /^(#{1,6}\s+.+?)\s*\{#([\w-]+)\}\s*$/gm;
-    if (anchorRegex.test(result)) {
-        modified = true;
-        result = result.replace(anchorRegex, '$1');
-        log.verbose('Note: Custom anchor IDs detected. These will be auto-generated from heading text.');
-    }
-
-    // Convert VitePress table of contents placeholder
-    if (result.includes('[[toc]]') || result.includes('[toc]')) {
-        modified = true;
-        result = result.replace(/\[?\[toc\]\]?/gi, '[[toc]]');
-    }
-
-    return { content: result, modified };
-}
-
-/**
- * Process a single markdown file
- */
-async function processMarkdownFile(filePath) {
-    try {
-        const relativePath = path.relative(CONFIG.sourceDir, filePath);
-        log.verbose(`Processing: ${relativePath}`);
-
-        const content = await fs.readFile(filePath, 'utf-8');
-        let processedContent = content;
-        let wasModified = false;
-
-        // Apply transformations
-        const containerResult = convertContainerBlocks(processedContent);
-        processedContent = containerResult.content;
-        wasModified = wasModified || containerResult.modified;
-
-        const codeGroupResult = convertCodeGroups(processedContent);
-        processedContent = codeGroupResult.content;
-        wasModified = wasModified || codeGroupResult.modified;
-
-        const syntaxResult = convertVitePressSpecificSyntax(processedContent);
-        processedContent = syntaxResult.content;
-        wasModified = wasModified || syntaxResult.modified;
-
-        const frontmatterResult = ensureFrontmatter(processedContent, filePath);
-        processedContent = frontmatterResult.content;
-        wasModified = wasModified || frontmatterResult.modified;
-
-        // Save the processed file
-        const targetPath = path.join(CONFIG.targetDir, relativePath);
-
-        if (!CONFIG.dryRun) {
-            await fs.mkdir(path.dirname(targetPath), { recursive: true });
-            await fs.writeFile(targetPath, processedContent, 'utf-8');
-        }
-
-        if (wasModified) {
-            CONFIG.stats.modified++;
-            log.success(`Modified: ${relativePath}`);
-        } else {
-            CONFIG.stats.skipped++;
-            CONFIG.verbose && log.info(`Unchanged: ${relativePath}`);
-        }
-
-        CONFIG.stats.processed++;
-
-    } catch (error) {
-        CONFIG.stats.errors++;
-        log.error(`Error processing ${filePath}: ${error.message}`);
-    }
-}
-
-/**
- * Recursively find all markdown files
- */
-async function findMarkdownFiles(dir) {
-    const files = [];
-    const entries = await fs.readdir(dir, { withFileTypes: true });
-
-    for (const entry of entries) {
-        const fullPath = path.join(dir, entry.name);
-        if (entry.isDirectory()) {
-            files.push(...await findMarkdownFiles(fullPath));
-        } else if (entry.isFile() && entry.name.endsWith('.md')) {
-            files.push(fullPath);
-        }
-    }
-
-    return files;
-}
-
-/**
- * Create backup of source directory
- */
-async function createBackup() {
-    if (!CONFIG.dryRun) {
-        log.info('Creating backup...');
-        try {
-            // Remove old backup if exists
-            await fs.rm(CONFIG.backupDir, { recursive: true, force: true });
-            // Copy source to backup
-            await fs.cp(CONFIG.sourceDir, CONFIG.backupDir, { recursive: true });
-            log.success(`Backup created at: ${CONFIG.backupDir}`);
-        } catch (error) {
-            log.error(`Failed to create backup: ${error.message}`);
-            throw error;
-        }
-    }
-}
-
-/**
- * Main migration function
- */
-async function migrate() {
-    console.log(`${colors.bright}${colors.blue}
-╔══════════════════════════════════════════════╗
-║     VitePress → React Markdown Migration     ║
-╚══════════════════════════════════════════════╝
-${colors.reset}`);
-
-    // Parse command line arguments
-    if (process.argv.includes('--help')) {
-        console.log(`
-Usage: node migrate-vitepress.js [options]
-
-Options:
-  --dry-run    Preview changes without writing files
-  --verbose    Show detailed output
-  --help       Show this help message
-
-Source: ${CONFIG.sourceDir}
-Target: ${CONFIG.targetDir}
-        `);
-        process.exit(0);
-    }
-
-    if (CONFIG.dryRun) {
-        log.warning('DRY RUN MODE - No files will be modified');
-    }
-
-    try {
-        // Check if source directory exists
-        await fs.access(CONFIG.sourceDir);
-
-        // Create backup
-        await createBackup();
-
-        // Find all markdown files
-        log.info('Scanning for markdown files...');
-        const files = await findMarkdownFiles(CONFIG.sourceDir);
-        log.info(`Found ${files.length} markdown files`);
-
-        // Process each file
-        for (const file of files) {
-            await processMarkdownFile(file);
-        }
-
-        // Print summary
-        console.log(`\n${colors.bright}Migration Summary:${colors.reset}`);
-        console.log(`${colors.green}✓ Processed:${colors.reset} ${CONFIG.stats.processed}`);
-        console.log(`${colors.yellow}✎ Modified:${colors.reset} ${CONFIG.stats.modified}`);
-        console.log(`${colors.cyan}⊘ Skipped:${colors.reset} ${CONFIG.stats.skipped}`);
-        if (CONFIG.stats.errors > 0) {
-            console.log(`${colors.red}✗ Errors:${colors.reset} ${CONFIG.stats.errors}`);
-        }
-
-        if (!CONFIG.dryRun) {
-            log.success(`\nMigration complete! Files saved to: ${CONFIG.targetDir}`);
-            log.info('Original files backed up to: ' + CONFIG.backupDir);
-        } else {
-            log.info('\nRun without --dry-run to apply changes');
-        }
-
-    } catch (error) {
-        log.error(`Migration failed: ${error.message}`);
-        process.exit(1);
-    }
-}
-
-// Run migration
-migrate();
diff --git a/docs/src/App.tsx b/docs/src/App.tsx
deleted file mode 100644
index 5d1f7aef..00000000
--- a/docs/src/App.tsx
+++ /dev/null
@@ -1,29 +0,0 @@
-import { BrowserRouter, Routes, Route } from 'react-router-dom'
-import HomePage from './pages/HomePage'
-import BlogPage from './pages/BlogPage'
-import BlogPostPage from './pages/BlogPostPage'
-import DocsRoutes from './routes/DocsRoutes'
-import ErrorBoundary from './components/ErrorBoundary'
-
-function App() {
-    return (
-        <BrowserRouter>
-            <Routes>
-                <Route path="/" element={<HomePage />} />
-                <Route path="/blog" element={<BlogPage />} />
-                <Route path="/blog/:slug" element={<BlogPostPage />} />
-                <Route
-                    path="/docs/*"
-                    element={
-                        <ErrorBoundary>
-                            <DocsRoutes />
-                        </ErrorBoundary>
-                    }
-                />
-                <Route path="*" element={<div>404 Not Found</div>} />
-            </Routes>
-        </BrowserRouter>
-    )
-}
-
-export default App
diff --git a/docs/src/assets/icons/easyp-logo.svg b/docs/src/assets/icons/easyp-logo.svg
deleted file mode 100644
index b260bd57..00000000
--- a/docs/src/assets/icons/easyp-logo.svg
+++ /dev/null
@@ -1,39 +0,0 @@
-<svg width="32" height="32" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <!-- Background gradient definitions -->
-  <defs>
-    <linearGradient id="logoGradient" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#60a5fa;stop-opacity:1" />
-      <stop offset="100%" style="stop-color:#3b82f6;stop-opacity:1" />
-    </linearGradient>
-    <linearGradient id="logoGradientHover" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#93c5fd;stop-opacity:1" />
-      <stop offset="100%" style="stop-color:#60a5fa;stop-opacity:1" />
-    </linearGradient>
-    <filter id="glow">
-      <feGaussianBlur stdDeviation="3" result="coloredBlur"/>
-      <feMerge>
-        <feMergeNode in="coloredBlur"/>
-        <feMergeNode in="SourceGraphic"/>
-      </feMerge>
-    </filter>
-  </defs>
-
-  <!-- Background rounded square -->
-  <rect x="2" y="2" width="28" height="28" rx="6" ry="6" fill="#1e293b" stroke="url(#logoGradient)" stroke-width="1.5" opacity="0.9"/>
-
-  <!-- Inner glow effect -->
-  <rect x="2" y="2" width="28" height="28" rx="6" ry="6" fill="url(#logoGradient)" opacity="0.15"/>
-
-  <!-- Letter E -->
-  <g transform="translate(7, 9)">
-    <path d="M 0 0 L 7 0 L 7 2 L 2 2 L 2 6 L 6 6 L 6 8 L 2 8 L 2 12 L 7 12 L 7 14 L 0 14 Z" fill="url(#logoGradient)"/>
-  </g>
-
-  <!-- Letter P -->
-  <g transform="translate(16, 9)">
-    <path d="M 0 0 L 6 0 Q 8 0 8 2 L 8 5 Q 8 7 6 7 L 2 7 L 2 14 L 0 14 Z M 2 2 L 2 5 L 5 5 Q 6 5 6 4 L 6 3 Q 6 2 5 2 Z" fill="url(#logoGradient)"/>
-  </g>
-
-  <!-- Decorative dot accent -->
-  <circle cx="26" cy="6" r="1.5" fill="#60a5fa" opacity="0.8" filter="url(#glow)"/>
-</svg>
diff --git a/docs/src/assets/partners/.gitkeep b/docs/src/assets/partners/.gitkeep
deleted file mode 100644
index e69de29b..00000000
diff --git a/docs/src/components/ArchitectureComparison.tsx b/docs/src/components/ArchitectureComparison.tsx
deleted file mode 100644
index 64202ec4..00000000
--- a/docs/src/components/ArchitectureComparison.tsx
+++ /dev/null
@@ -1,67 +0,0 @@
-import { Globe, Layers, Lock } from 'lucide-react'
-import { useTranslation } from 'react-i18next'
-
-export default function ArchitectureComparison() {
-    const { t } = useTranslation()
-
-    const features = [
-        {
-            icon: Globe,
-            titleKey: 'architecture.dataSovereignty.title',
-            descriptionKey: 'architecture.dataSovereignty.description',
-            iconBg: 'bg-blue-500/10',
-            iconColor: 'text-blue-400',
-            hoverBorder: 'hover:border-blue-500/30'
-        },
-        {
-            icon: Layers,
-            titleKey: 'architecture.hybridRuntime.title',
-            descriptionKey: 'architecture.hybridRuntime.description',
-            iconBg: 'bg-purple-500/10',
-            iconColor: 'text-purple-400',
-            hoverBorder: 'hover:border-purple-500/30'
-        },
-        {
-            icon: Lock,
-            titleKey: 'architecture.noVendorLock.title',
-            descriptionKey: 'architecture.noVendorLock.description',
-            iconBg: 'bg-emerald-500/10',
-            iconColor: 'text-emerald-400',
-            hoverBorder: 'hover:border-emerald-500/30'
-        }
-    ]
-
-    return (
-        <section className="py-32 bg-slate-950/50 relative overflow-hidden">
-            {/* Background Decoration */}
-            <div className="absolute top-1/2 left-1/2 -translate-x-1/2 -translate-y-1/2 w-[800px] h-[800px] bg-primary/10 rounded-full blur-[150px] opacity-20 pointer-events-none"></div>
-
-            <div className="max-w-7xl mx-auto px-6 relative z-10">
-                <div className="text-center mb-20">
-                    <h2 className="text-3xl md:text-5xl font-bold text-white mb-5">
-                        {t('architecture.title')}
-                    </h2>
-                    <p className="text-slate-400 text-lg max-w-2xl mx-auto">
-                        {t('architecture.subtitle')}
-                    </p>
-                </div>
-
-                <div className="grid md:grid-cols-3 gap-8">
-                    {features.map((feature, i) => {
-                        const Icon = feature.icon
-
-                        return (
-                            <div key={i} className={`glass-panel p-8 rounded-2xl border border-white/5 ${feature.hoverBorder} transition-colors group`}>
-                                <div className={`w-14 h-14 ${feature.iconBg} rounded-xl flex items-center justify-center ${feature.iconColor} mb-6 group-hover:scale-110 transition-transform`}>
-                                    <Icon size={28} />
-                                </div>
-                                <h3 className="text-xl font-semibold text-white mb-3">{t(feature.titleKey)}</h3>
-                                <p className="text-slate-400 leading-relaxed" dangerouslySetInnerHTML={{ __html: t(feature.descriptionKey).replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>') }} />
-                            </div>
-                        )
-                    })}
-                </div>
-            </div>
-        </section>
-    )
-}
diff --git a/docs/src/components/EasyPLogo.tsx b/docs/src/components/EasyPLogo.tsx
deleted file mode 100644
index 0a9daacc..00000000
--- a/docs/src/components/EasyPLogo.tsx
+++ /dev/null
@@ -1,135 +0,0 @@
-import React from 'react';
-
-interface EasyPLogoProps {
-  size?: number;
-  className?: string;
-  showGlow?: boolean;
-  variant?: 'default' | 'mono' | 'gradient';
-}
-
-const EasyPLogo: React.FC<EasyPLogoProps> = ({
-  size = 32,
-  className = '',
-  showGlow = true,
-  variant = 'gradient'
-}) => {
-  const id = `easyp-logo-${Math.random().toString(36).substr(2, 9)}`;
-
-  const fillColor = variant === 'mono'
-    ? '#e2e8f0'
-    : variant === 'gradient'
-    ? `url(#${id}-gradient)`
-    : '#3b82f6';
-
-  return (
-    <svg
-      width={size}
-      height={size}
-      viewBox="0 0 32 32"
-      fill="none"
-      xmlns="http://www.w3.org/2000/svg"
-      className={className}
-      role="img"
-      aria-label="EasyP Logo"
-    >
-      <defs>
-        <linearGradient id={`${id}-gradient`} x1="0%" y1="0%" x2="100%" y2="100%">
-          <stop offset="0%" stopColor="#60a5fa" stopOpacity={1} />
-          <stop offset="100%" stopColor="#3b82f6" stopOpacity={1} />
-        </linearGradient>
-        <linearGradient id={`${id}-bg-gradient`} x1="0%" y1="0%" x2="100%" y2="100%">
-          <stop offset="0%" stopColor="#3b82f6" stopOpacity={0.2} />
-          <stop offset="100%" stopColor="#8b5cf6" stopOpacity={0.1} />
-        </linearGradient>
-        {showGlow && (
-          <filter id={`${id}-glow`}>
-            <feGaussianBlur stdDeviation="2" result="coloredBlur"/>
-            <feMerge>
-              <feMergeNode in="coloredBlur"/>
-              <feMergeNode in="SourceGraphic"/>
-            </feMerge>
-          </filter>
-        )}
-        <filter id={`${id}-shadow`}>
-          <feDropShadow dx="0" dy="1" stdDeviation="2" floodOpacity="0.2"/>
-        </filter>
-      </defs>
-
-      {/* Background rounded square */}
-      <rect
-        x="2"
-        y="2"
-        width="28"
-        height="28"
-        rx="6"
-        ry="6"
-        fill="#1e293b"
-        stroke={`url(#${id}-gradient)`}
-        strokeWidth="1.5"
-        opacity="0.9"
-        filter={`url(#${id}-shadow)`}
-      />
-
-      {/* Inner gradient overlay */}
-      <rect
-        x="2"
-        y="2"
-        width="28"
-        height="28"
-        rx="6"
-        ry="6"
-        fill={`url(#${id}-bg-gradient)`}
-      />
-
-      {/* Letter E - modernized design */}
-      <path
-        d="M 8 10 L 13 10 Q 13 10 13 10.5 L 13 11 Q 13 11.5 12.5 11.5 L 9.5 11.5 L 9.5 15 L 12 15 Q 12.5 15 12.5 15.5 L 12.5 16 Q 12.5 16.5 12 16.5 L 9.5 16.5 L 9.5 20 L 13 20 Q 13 20 13 20.5 L 13 21 Q 13 21.5 12.5 21.5 L 8 21.5 Q 8 21.5 8 21 L 8 10.5 Q 8 10 8 10 Z"
-        fill={fillColor}
-        filter={showGlow ? `url(#${id}-glow)` : undefined}
-      />
-
-      {/* Letter P - modernized design */}
-      <path
-        d="M 17 10 L 22 10 Q 24 10 24 12 L 24 14 Q 24 16 22 16 L 18.5 16 L 18.5 21 Q 18.5 21.5 18 21.5 L 17.5 21.5 Q 17 21.5 17 21 L 17 10.5 Q 17 10 17 10 Z M 18.5 11.5 L 18.5 14.5 L 21.5 14.5 Q 22.5 14.5 22.5 13.5 L 22.5 12.5 Q 22.5 11.5 21.5 11.5 L 18.5 11.5 Z"
-        fill={fillColor}
-        filter={showGlow ? `url(#${id}-glow)` : undefined}
-      />
-
-      {/* Accent dot in corner */}
-      <circle
-        cx="26"
-        cy="6"
-        r="1.5"
-        fill="#60a5fa"
-        opacity="0.8"
-        filter={showGlow ? `url(#${id}-glow)` : undefined}
-      >
-        <animate
-          attributeName="opacity"
-          values="0.8;1;0.8"
-          dur="2s"
-          repeatCount="indefinite"
-        />
-      </circle>
-
-      {/* Secondary accent dot */}
-      <circle
-        cx="6"
-        cy="26"
-        r="1"
-        fill="#8b5cf6"
-        opacity="0.6"
-      >
-        <animate
-          attributeName="opacity"
-          values="0.6;0.8;0.6"
-          dur="2s"
-          begin="1s"
-          repeatCount="indefinite"
-        />
-      </circle>
-    </svg>
-  );
-};
-
-export default EasyPLogo;
diff --git a/docs/src/components/ErrorBoundary.tsx b/docs/src/components/ErrorBoundary.tsx
deleted file mode 100644
index 0cd5353a..00000000
--- a/docs/src/components/ErrorBoundary.tsx
+++ /dev/null
@@ -1,41 +0,0 @@
-import { Component, ErrorInfo, ReactNode } from 'react'
-
-interface Props {
-    children: ReactNode
-}
-
-interface State {
-    hasError: boolean
-    error: Error | null
-}
-
-export default class ErrorBoundary extends Component<Props, State> {
-    public state: State = {
-        hasError: false,
-        error: null
-    }
-
-    public static getDerivedStateFromError(error: Error): State {
-        return { hasError: true, error }
-    }
-
-    public componentDidCatch(error: Error, errorInfo: ErrorInfo) {
-        console.error('Uncaught error:', error, errorInfo)
-    }
-
-    public render() {
-        if (this.state.hasError) {
-            return (
-                <div className="p-6 bg-red-500/10 border border-red-500/20 rounded-lg text-red-200">
-                    <h2 className="text-xl font-bold mb-2">Something went wrong</h2>
-                    <p className="mb-4">We encountered an error while rendering this page.</p>
-                    <pre className="bg-slate-900 p-4 rounded overflow-auto text-sm font-mono">
-                        {this.state.error?.toString()}
-                    </pre>
-                </div>
-            )
-        }
-
-        return this.props.children
-    }
-}
diff --git a/docs/src/components/FeatureSwitcher.tsx b/docs/src/components/FeatureSwitcher.tsx
deleted file mode 100644
index 4e4aa272..00000000
--- a/docs/src/components/FeatureSwitcher.tsx
+++ /dev/null
@@ -1,176 +0,0 @@
-import { useState } from 'react'
-import { Package, CheckCircle, Shield, Box } from 'lucide-react'
-import { useTranslation } from 'react-i18next'
-
-export default function FeatureSwitcher() {
-    const { t } = useTranslation()
-    const [activeTab, setActiveTab] = useState('cli')
-
-    return (
-        <section id="features" className="py-32 bg-background relative">
-            <div className="max-w-7xl mx-auto px-6">
-                <div className="text-center mb-16">
-                    <h2 className="text-3xl md:text-4xl font-bold text-white mb-4">
-                        {t('features.title')} <span className="text-primary">{t('features.titleHighlight')}</span>
-                    </h2>
-                    <p className="text-slate-400 text-lg max-w-2xl mx-auto">
-                        {t('features.subtitle')}
-                    </p>
-                </div>
-
-                {/* Toggle */}
-                <div className="flex justify-center mb-16">
-                    <div className="bg-slate-900 p-1.5 rounded-full border border-slate-800 inline-flex shadow-inner">
-                        <button
-                            onClick={() => setActiveTab('cli')}
-                            className={`px-8 py-2.5 rounded-full text-sm font-medium transition-all duration-300 ${activeTab === 'cli' ? 'bg-white text-black shadow-lg' : 'text-slate-400 hover:text-white'}`}
-                        >
-                            {t('features.localDev')}
-                        </button>
-                        <button
-                            onClick={() => setActiveTab('server')}
-                            className={`px-8 py-2.5 rounded-full text-sm font-medium transition-all duration-300 ${activeTab === 'server' ? 'bg-white text-black shadow-lg' : 'text-slate-400 hover:text-white'}`}
-                        >
-                            {t('features.remoteInfra')}
-                        </button>
-                    </div>
-                </div>
-
-                {/* Content Area */}
-                <div className="grid lg:grid-cols-2 gap-12 items-center">
-
-                    {/* Left Text */}
-                    <div className="space-y-8">
-                        {activeTab === 'cli' ? (
-                            <div className="animate-fade-in-up">
-                                <h3 className="text-2xl font-semibold text-white mb-4">{t('features.cli.title')}</h3>
-                                <p className="text-slate-400 text-lg leading-relaxed mb-8">
-                                    {t('features.cli.description')}
-                                </p>
-                                <ul className="space-y-4">
-                                    <li className="flex gap-4">
-                                        <div className="w-6 h-6 rounded-full bg-primary/10 flex items-center justify-center shrink-0 text-primary mt-1">
-                                            <Package size={14} />
-                                        </div>
-                                        <div>
-                                            <h4 className="text-white font-medium">{t('features.cli.packageManager.title')}</h4>
-                                            <p className="text-sm text-slate-500">{t('features.cli.packageManager.desc')}</p>
-                                        </div>
-                                    </li>
-                                    <li className="flex gap-4">
-                                        <div className="w-6 h-6 rounded-full bg-primary/10 flex items-center justify-center shrink-0 text-primary mt-1">
-                                            <CheckCircle size={14} />
-                                        </div>
-                                        <div>
-                                            <h4 className="text-white font-medium">{t('features.cli.linting.title')}</h4>
-                                            <p className="text-sm text-slate-500">{t('features.cli.linting.desc')}</p>
-                                        </div>
-                                    </li>
-                                    <li className="flex gap-4">
-                                        <div className="w-6 h-6 rounded-full bg-primary/10 flex items-center justify-center shrink-0 text-primary mt-1">
-                                            <CheckCircle size={14} />
-                                        </div>
-                                        <div>
-                                            <h4 className="text-white font-medium">{t('features.cli.apiSafety.title')}</h4>
-                                            <p className="text-sm text-slate-500">{t('features.cli.apiSafety.desc')}</p>
-                                        </div>
-                                    </li>
-                                </ul>
-                            </div>
-                        ) : (
-                            <div className="animate-fade-in-up">
-                                <h3 className="text-2xl font-semibold text-white mb-4">{t('features.server.title')}</h3>
-                                <p className="text-slate-400 text-lg leading-relaxed mb-8">
-                                    {t('features.server.description')}
-                                </p>
-                                <ul className="space-y-4">
-                                    <li className="flex gap-4">
-                                        <div className="w-6 h-6 rounded-full bg-secondary/10 flex items-center justify-center shrink-0 text-secondary mt-1">
-                                            <Shield size={14} />
-                                        </div>
-                                        <div>
-                                            <h4 className="text-white font-medium">{t('features.server.dockerNative.title')}</h4>
-                                            <p className="text-sm text-slate-500">{t('features.server.dockerNative.desc')}</p>
-                                        </div>
-                                    </li>
-                                    <li className="flex gap-4">
-                                        <div className="w-6 h-6 rounded-full bg-secondary/10 flex items-center justify-center shrink-0 text-secondary mt-1">
-                                            <Shield size={14} />
-                                        </div>
-                                        <div>
-                                            <h4 className="text-white font-medium">{t('features.server.airGap.title')}</h4>
-                                            <p className="text-sm text-slate-500">{t('features.server.airGap.desc')}</p>
-                                        </div>
-                                    </li>
-                                    <li className="flex gap-4">
-                                        <div className="w-6 h-6 rounded-full bg-secondary/10 flex items-center justify-center shrink-0 text-secondary mt-1">
-                                            <Shield size={14} />
-                                        </div>
-                                        <div>
-                                            <h4 className="text-white font-medium">{t('features.server.costEffective.title')}</h4>
-                                            <p className="text-sm text-slate-500">{t('features.server.costEffective.desc')}</p>
-                                        </div>
-                                    </li>
-                                </ul>
-                            </div>
-                        )}
-                    </div>
-
-                    {/* Right Visual */}
-                    <div className="relative group">
-                        <div className="absolute -inset-1 bg-gradient-to-r from-primary to-secondary rounded-2xl blur opacity-20 group-hover:opacity-40 transition duration-1000 group-hover:duration-200"></div>
-                        <div className="relative rounded-xl bg-slate-900 border border-slate-800 overflow-hidden shadow-2xl h-[400px] flex flex-col">
-                            <div className="flex items-center px-4 py-3 border-b border-slate-800 bg-slate-900/50 gap-2">
-                                <div className="w-3 h-3 rounded-full bg-slate-700"></div>
-                                <div className="w-3 h-3 rounded-full bg-slate-700"></div>
-                            </div>
-                            <div className="p-6 font-mono text-sm flex-grow overflow-hidden">
-                                {activeTab === 'cli' ? (
-                                    <div className="space-y-2">
-                                        <div className="text-slate-400"># easyp.yaml configuration</div>
-                                        <div className="text-purple-400">version: <span className="text-green-400">v1</span></div>
-                                        <div className="text-purple-400">deps:</div>
-                                        <div className="pl-4 text-slate-300">- github.com/googleapis/googleapis@v1.0</div>
-                                        <div className="text-purple-400 mt-2">lint:</div>
-                                        <div className="pl-4 text-blue-400">use:</div>
-                                        <div className="pl-8 text-slate-300">- STANDARD</div>
-                                        <div className="pl-8 text-slate-300">- COMMENTS</div>
-                                        <div className="text-purple-400 mt-4">breaking:</div>
-                                        <div className="pl-4 text-blue-400">ignore:</div>
-                                        <div className="pl-8 text-slate-300">- "proto/alfa/v1"</div>
-                                    </div>
-                                ) : (
-                                    <div className="space-y-2">
-                                        <div className="text-slate-400"># Server Infrastructure</div>
-                                        <div className="flex items-center gap-2 py-2 border-b border-slate-800/50">
-                                            <Box size={16} className="text-blue-400" />
-                                            <span className="text-slate-200">EasyP Service</span>
-                                            <span className="ml-auto text-xs bg-green-500/10 text-green-500 px-2 rounded-full">Healthy</span>
-                                        </div>
-                                        <div className="pl-4 border-l border-slate-800 space-y-3 mt-3">
-                                            <div className="flex items-center gap-2">
-                                                <div className="w-2 h-2 bg-slate-600 rounded-full"></div>
-                                                <span className="text-slate-400">Registry:</span>
-                                                <span className="text-slate-200">Local Docker</span>
-                                            </div>
-                                            <div className="flex items-center gap-2">
-                                                <div className="w-2 h-2 bg-slate-600 rounded-full"></div>
-                                                <span className="text-slate-400">Plugins:</span>
-                                                <span className="text-slate-200">14 Loaded</span>
-                                            </div>
-                                            <div className="flex items-center gap-2">
-                                                <div className="w-2 h-2 bg-slate-600 rounded-full"></div>
-                                                <span className="text-slate-400">Uptime:</span>
-                                                <span className="text-slate-200">42d 12h</span>
-                                            </div>
-                                        </div>
-                                    </div>
-                                )}
-                            </div>
-                        </div>
-                    </div>
-                </div>
-            </div>
-        </section>
-    )
-}
diff --git a/docs/src/components/Footer.tsx b/docs/src/components/Footer.tsx
deleted file mode 100644
index 0c0ff938..00000000
--- a/docs/src/components/Footer.tsx
+++ /dev/null
@@ -1,51 +0,0 @@
-import { Shield } from 'lucide-react'
-import { useTranslation } from 'react-i18next'
-
-export default function Footer() {
-    const { t } = useTranslation()
-    return (
-        <footer className="bg-slate-950 border-t border-slate-800 py-16">
-            <div className="max-w-7xl mx-auto px-6">
-                <div className="grid md:grid-cols-4 gap-12">
-                    <div className="col-span-2">
-                        <div className="flex items-center gap-2 mb-6">
-                            <div className="w-6 h-6 bg-primary/20 rounded flex items-center justify-center text-primary text-xs font-bold">E</div>
-                            <span className="font-bold text-white">EasyP</span>
-                        </div>
-                        <p className="text-slate-400 text-sm max-w-xs leading-relaxed mb-4">
-                            {t('footer.description')}
-                        </p>
-                        <div className="flex items-center gap-2 text-xs text-slate-500">
-                            <Shield size={12} /> {t('footer.license')}
-                        </div>
-                    </div>
-                    <div>
-                        <h4 className="text-white font-medium mb-4">{t('footer.product.title')}</h4>
-                        <ul className="space-y-3 text-sm text-slate-400">
-                            <li><a href="/docs/guide/cli/linter/linter" className="hover:text-primary">{t('footer.product.cliTool')}</a></li>
-                            <li><a href="/docs/guide/api-service/overview" className="hover:text-primary">{t('footer.product.apiService')}</a></li>
-                            {/* <li><a href="#" className="hover:text-primary">{t('footer.product.registry')}</a></li> */}
-                            <li><a href="/docs" className="hover:text-primary">{t('footer.product.documentation')}</a></li>
-                            {/* <li><a href="#" className="hover:text-primary">{t('footer.product.enterprise')}</a></li> */}
-                        </ul>
-                    </div>
-                    <div>
-                        <h4 className="text-white font-medium mb-4">{t('footer.community.title')}</h4>
-                        <ul className="space-y-3 text-sm text-slate-400">
-                            <li><a href="https://github.com/easyp-tech/easyp" className="hover:text-primary">{t('footer.community.github')}</a></li>
-                            <li><a href="https://t.me/easyptech" className="hover:text-primary">{t('footer.community.telegram')}</a></li>
-                            {/* <li><a href="#" className="hover:text-primary">{t('footer.community.youtube')}</a></li> */}
-                        </ul>
-                    </div>
-                </div>
-                <div className="border-t border-slate-800 mt-16 pt-8 flex flex-col md:flex-row justify-between items-center text-xs text-slate-600">
-                    <p>{t('footer.rights')}</p>
-                    {/* <div className="flex gap-6 mt-4 md:mt-0">
-                        <a href="#" className="hover:text-slate-400">{t('footer.privacy')}</a>
-                        <a href="#" className="hover:text-slate-400">{t('footer.terms')}</a>
-                    </div> */}
-                </div>
-            </div>
-        </footer>
-    )
-}
diff --git a/docs/src/components/Hero.tsx b/docs/src/components/Hero.tsx
deleted file mode 100644
index 31b5385f..00000000
--- a/docs/src/components/Hero.tsx
+++ /dev/null
@@ -1,201 +0,0 @@
-import { useState, useEffect, useRef } from 'react'
-import { Shield, ChevronRight, ChevronDown, Copy, CheckCircle } from 'lucide-react'
-import { useTranslation } from 'react-i18next'
-import { Link } from 'react-router-dom'
-import { GetLatestRelease } from '../utils/github'
-
-interface InstallOption {
-    id: string
-    label: string
-    fullLabel: string
-    cmd: string
-}
-
-export default function Hero() {
-    const { t } = useTranslation()
-    const [installMethod, setInstallMethod] = useState('brew')
-    const [isDropdownOpen, setIsDropdownOpen] = useState(false)
-    const [version, setVersion] = useState('vX.X.X')
-    const dropdownRef = useRef<HTMLDivElement>(null)
-
-    const installOptions: InstallOption[] = [
-        { id: 'brew', label: 'brew', fullLabel: 'macOS (homebrew)', cmd: 'brew install easyp-tech/tap/easyp' },
-        { id: 'go', label: 'go', fullLabel: 'go Install (any OS)', cmd: 'go install github.com/easyp-tech/easyp/cmd/easyp@latest' },
-        { id: 'docker', label: 'docker', fullLabel: 'docker', cmd: 'docker pull easyp/easyp:latest' }
-    ]
-
-    const activeOption = installOptions.find(o => o.id === installMethod) || installOptions[0]
-
-    // Auto-detect OS on mount
-    useEffect(() => {
-        const platform = navigator.platform.toLowerCase()
-        const userAgent = navigator.userAgent.toLowerCase()
-
-        if (platform.includes('mac') || userAgent.includes('mac')) {
-            setInstallMethod('brew')
-        } else if (platform.includes('linux') || userAgent.includes('linux') || platform.includes('win') || userAgent.includes('win')) {
-            setInstallMethod('go')
-        } else {
-            setInstallMethod('go')
-        }
-
-        const handleClickOutside = (event: MouseEvent) => {
-            if (dropdownRef.current && !dropdownRef.current.contains(event.target as Node)) {
-                setIsDropdownOpen(false)
-            }
-        }
-        document.addEventListener('mousedown', handleClickOutside)
-        return () => document.removeEventListener('mousedown', handleClickOutside)
-    }, [])
-
-    useEffect(() => {
-        GetLatestRelease().then(v => {
-            if (v !== 'unknown version') {
-                setVersion(v)
-            }
-        })
-    }, [])
-
-    const handleCopy = () => {
-        navigator.clipboard.writeText(activeOption.cmd)
-    }
-
-    return (
-        <section className="relative pt-32 pb-20 lg:pt-48 lg:pb-32 overflow-hidden">
-            {/* Ambient Background */}
-            <div className="absolute top-0 left-1/2 -translate-x-1/2 w-[1000px] h-[600px] bg-primary/20 rounded-full blur-[120px] opacity-30 pointer-events-none"></div>
-
-            <div className="max-w-7xl mx-auto px-6 relative z-10">
-                <div className="flex flex-col items-center text-center mb-16">
-
-                    <div className="flex gap-3 mb-8 animate-fade-in-up">
-                        <div className="inline-flex items-center gap-2 px-3 py-1 rounded-full bg-slate-800/50 border border-slate-700/50 text-primary text-xs font-medium">
-                            <span className="relative flex h-2 w-2">
-                                <span className="animate-ping absolute inline-flex h-full w-full rounded-full bg-primary opacity-75"></span>
-                                <span className="relative inline-flex rounded-full h-2 w-2 bg-primary"></span>
-                            </span>
-                            {version}
-                        </div>
-                        <div className="inline-flex items-center gap-2 px-3 py-1 rounded-full bg-slate-800/50 border border-slate-700/50 text-slate-300 text-xs font-medium">
-                            <Shield size={12} className="text-emerald-400" />
-                            {t('hero.badge.license')}
-                        </div>
-                    </div>
-
-                    <h1 className="text-5xl lg:text-7xl font-bold text-white tracking-tight leading-[1.1] mb-6 max-w-4xl animate-fade-in-up [animation-delay:100ms]">
-                        {t('hero.title')} <br />
-                        <span className="text-gradient">{t('hero.titleHighlight')}</span>
-                    </h1>
-
-                    <p className="text-lg text-slate-400 max-w-2xl mb-10 leading-relaxed animate-fade-in-up [animation-delay:200ms]">
-                        {t('hero.subtitle')}
-                    </p>
-
-                    <div className="flex flex-col sm:flex-row items-center gap-4 animate-fade-in-up [animation-delay:300ms] w-full max-w-2xl relative z-20">
-
-                        {/* Install Box with Integrated Dropdown */}
-                        <div className="relative w-full sm:w-auto flex-grow group" ref={dropdownRef}>
-                            <div className="flex items-center bg-slate-900 border border-slate-800 rounded-xl px-1 py-1 pr-2 shadow-xl w-full group-hover:border-slate-600 transition-colors">
-
-                                {/* Trigger Button */}
-                                <button
-                                    onClick={() => setIsDropdownOpen(!isDropdownOpen)}
-                                    className="flex items-center gap-2 text-slate-300 hover:text-white hover:bg-slate-800 transition-all text-sm font-medium px-3 py-2 rounded-lg shrink-0 border-r border-slate-800/50 mr-2"
-                                    title="Select installation method"
-                                >
-                                    <span>{activeOption.label}</span>
-                                    <ChevronDown size={14} className={`text-slate-500 transition-transform duration-200 ${isDropdownOpen ? 'rotate-180' : ''}`} />
-                                </button>
-
-                                {/* Command Code */}
-                                <div className="flex-grow overflow-hidden flex items-center">
-                                    <ChevronRight size={14} className="text-slate-600 mr-2 shrink-0" />
-                                    <code className="font-mono text-sm text-slate-300 whitespace-nowrap overflow-x-auto no-scrollbar block selection:bg-primary/30 selection:text-white">
-                                        {activeOption.cmd}
-                                    </code>
-                                </div>
-
-                                {/* Copy Button */}
-                                <button
-                                    className="p-2 hover:bg-slate-800 rounded-lg transition-colors text-slate-500 hover:text-white shrink-0 ml-2"
-                                    title="Copy to clipboard"
-                                    onClick={handleCopy}
-                                >
-                                    <Copy size={16} />
-                                </button>
-                            </div>
-
-                            {/* Dropdown Menu */}
-                            {isDropdownOpen && (
-                                <div className="absolute top-full left-0 mt-2 w-64 bg-slate-900 border border-slate-800 rounded-xl shadow-2xl overflow-hidden z-30">
-                                    <div className="py-1">
-                                        {installOptions.map(opt => (
-                                            <button
-                                                key={opt.id}
-                                                onClick={() => {
-                                                    setInstallMethod(opt.id)
-                                                    setIsDropdownOpen(false)
-                                                }}
-                                                className={`w-full text-left px-4 py-3 text-sm transition-colors flex items-center justify-between group ${installMethod === opt.id ? 'bg-primary/10' : 'hover:bg-slate-800'}`}
-                                            >
-                                                <span className={`${installMethod === opt.id ? 'text-primary font-medium' : 'text-slate-300 group-hover:text-white'}`}>
-                                                    {opt.fullLabel}
-                                                </span>
-                                                {installMethod === opt.id && <CheckCircle size={16} className="text-primary" />}
-                                            </button>
-                                        ))}
-                                    </div>
-                                </div>
-                            )}
-                        </div>
-
-                        {/* Explore Docs Button */}
-                        <Link to="/docs" className="w-full sm:w-auto px-6 py-3 rounded-full bg-primary/10 text-primary font-medium hover:bg-primary/20 transition-colors border border-primary/20 whitespace-nowrap text-center inline-block">
-                            {t('hero.exploreDocs')}
-                        </Link>
-                    </div>
-                </div>
-
-                {/* Hero Image / Visual */}
-                <div className="relative max-w-5xl mx-auto rounded-xl border border-slate-800 bg-slate-950/80 shadow-2xl shadow-primary/10 overflow-hidden animate-fade-in-up [animation-delay:500ms]">
-                    <div className="flex items-center px-4 py-3 border-b border-slate-800 bg-slate-900/50 gap-2">
-                        <div className="w-3 h-3 rounded-full bg-slate-700"></div>
-                        <div className="w-3 h-3 rounded-full bg-slate-700"></div>
-                        <div className="w-3 h-3 rounded-full bg-slate-700"></div>
-                        <div className="ml-4 text-xs text-slate-500 font-mono">easyp — zsh</div>
-                    </div>
-                    <div className="p-6 sm:p-10 font-mono text-sm sm:text-base leading-loose">
-                        <div className="flex items-start gap-2">
-                            <span className="text-primary font-bold">➜</span>
-                            <span className="text-slate-300">easyp generate -v</span>
-                        </div>
-                        <div className="text-slate-400 mt-2 pl-4 border-l-2 border-slate-800">
-                            <div className="flex items-center gap-2">
-                                <span className="text-emerald-400">✔</span>
-                                <span>Resolving dependencies from <span className="text-slate-300 underline decoration-slate-700">easyp.lock</span>...</span>
-                            </div>
-                            <div className="flex items-center gap-2 mt-1">
-                                <span className="text-emerald-400">✔</span>
-                                <span>Connecting to EasyP Service... <span className="text-xs bg-emerald-500/10 text-emerald-400 px-1.5 py-0.5 rounded">Connected</span></span>
-                            </div>
-                            <div className="mt-2">
-                                <span className="text-blue-400">[INFO]</span> Dispatching plugins:
-                                <div className="pl-4 mt-1 text-slate-500">
-                                    ├─ protoc-gen-go (v1.31) <span className="text-xs border border-slate-700 px-1 rounded text-slate-400">WASM</span><br />
-                                    └─ custom-java-gen (v2.0) <span className="text-xs border border-slate-700 px-1 rounded text-slate-400">DOCKER</span>
-                                </div>
-                            </div>
-                            <div className="mt-2 text-slate-300">
-                                ✨ Generation complete in <span className="text-primary">420ms</span>.
-                            </div>
-                        </div>
-                        <div className="flex items-start gap-2 mt-4 animate-pulse">
-                            <span className="text-primary font-bold">➜</span>
-                            <span className="w-2 h-5 bg-slate-500 inline-block align-middle"></span>
-                        </div>
-                    </div>
-                </div>
-            </div>
-        </section>
-    )
-}
diff --git a/docs/src/components/LanguageSwitcher.tsx b/docs/src/components/LanguageSwitcher.tsx
deleted file mode 100644
index 74db6b05..00000000
--- a/docs/src/components/LanguageSwitcher.tsx
+++ /dev/null
@@ -1,68 +0,0 @@
-import { useState, useRef, useEffect } from 'react'
-import { useTranslation } from 'react-i18next'
-import { Globe, Check } from 'lucide-react'
-
-export default function LanguageSwitcher() {
-    const { i18n } = useTranslation()
-    const [isOpen, setIsOpen] = useState(false)
-    const dropdownRef = useRef<HTMLDivElement>(null)
-
-    const languages = [
-        { code: 'en', label: 'English', disabled: false },
-        { code: 'ru', label: 'Русский', disabled: false }
-    ]
-
-    const currentLanguage = languages.find(lang => lang.code === i18n.language) || languages[0]
-
-    useEffect(() => {
-        const handleClickOutside = (event: MouseEvent) => {
-            if (dropdownRef.current && !dropdownRef.current.contains(event.target as Node)) {
-                setIsOpen(false)
-            }
-        }
-        document.addEventListener('mousedown', handleClickOutside)
-        return () => document.removeEventListener('mousedown', handleClickOutside)
-    }, [])
-
-    const changeLanguage = (langCode: string, isDisabled: boolean) => {
-        if (isDisabled) return // Don't allow changing to disabled language
-        i18n.changeLanguage(langCode)
-        setIsOpen(false)
-    }
-
-    return (
-        <div className="relative" ref={dropdownRef}>
-            <button
-                onClick={() => setIsOpen(!isOpen)}
-                className="flex items-center gap-2 px-3 py-2 rounded-lg hover:bg-slate-800 transition-colors text-slate-400 hover:text-white"
-                title="Change language"
-            >
-                <Globe size={18} />
-                <span className="text-sm font-medium">{currentLanguage.code.toUpperCase()}</span>
-            </button>
-
-            {isOpen && (
-                <div className="absolute right-0 top-full mt-2 w-40 bg-slate-900 border border-slate-800 rounded-xl shadow-2xl overflow-hidden z-50">
-                    <div className="py-1">
-                        {languages.map(lang => (
-                            <button
-                                key={lang.code}
-                                onClick={() => changeLanguage(lang.code, lang.disabled)}
-                                disabled={lang.disabled}
-                                className={`w-full text-left px-4 py-3 text-sm transition-colors flex items-center justify-between ${i18n.language === lang.code
-                                        ? 'bg-primary/10 text-primary font-medium'
-                                        : lang.disabled
-                                            ? 'text-slate-600 cursor-not-allowed opacity-50'
-                                            : 'text-slate-300 hover:bg-slate-800 hover:text-white'
-                                    }`}
-                            >
-                                <span className={lang.disabled ? 'line-through' : ''}>{lang.label}</span>
-                                {i18n.language === lang.code && !lang.disabled && <Check size={16} className="text-primary" />}
-                            </button>
-                        ))}
-                    </div>
-                </div>
-            )}
-        </div>
-    )
-}
diff --git a/docs/src/components/Mermaid.tsx b/docs/src/components/Mermaid.tsx
deleted file mode 100644
index 067e214a..00000000
--- a/docs/src/components/Mermaid.tsx
+++ /dev/null
@@ -1,295 +0,0 @@
-import React, { useEffect, useRef, useState } from 'react';
-import mermaid from 'mermaid';
-
-interface MermaidProps {
-  chart: string;
-  id?: string;
-}
-
-const Mermaid: React.FC<MermaidProps> = ({ chart, id }) => {
-  const ref = useRef<HTMLDivElement>(null);
-  const [isInitialized, setIsInitialized] = useState(false);
-  const [error, setError] = useState<string | null>(null);
-
-  useEffect(() => {
-    if (!isInitialized) {
-      mermaid.initialize({
-        startOnLoad: false,
-        theme: 'base',
-        securityLevel: 'loose',
-        themeVariables: {
-          // Background colors
-          background: '#020617',           // Slate 950 - main background
-          primaryColor: '#3b82f6',         // Blue 500 - primary
-          primaryTextColor: '#ffffff',     // White text
-          primaryBorderColor: '#60a5fa',   // Blue 400 - primary glow
-
-          // Secondary colors
-          secondaryColor: '#8b5cf6',       // Violet 500 - secondary
-          secondaryBorderColor: '#a78bfa', // Violet 400
-
-          // Tertiary colors
-          tertiaryColor: '#1e293b',        // Slate 800 - surface highlight
-          tertiaryTextColor: '#e2e8f0',    // Slate 200
-          tertiaryBorderColor: '#334155',  // Slate 700 - border
-
-          // Text colors
-          textColor: '#e2e8f0',           // Slate 200
-          secondaryTextColor: '#cbd5e1',   // Slate 300
-
-          // Background variations
-          primaryColorLight: '#60a5fa',    // Blue 400
-          primaryColorDark: '#1d4ed8',     // Blue 700
-
-          // Line colors
-          lineColor: '#334155',            // Slate 700 - border
-          edgeLabelBackground: '#0f172a',  // Slate 900 - surface
-
-          // Node colors
-          mainBkg: '#1e293b',              // Slate 800 - surface highlight
-          nodeBkg: '#1e293b',
-          nodeTextColor: '#e2e8f0',
-          nodeBorder: '#60a5fa',           // Blue 400 - primary glow
-
-          // Cluster colors
-          clusterBkg: '#0f172a',           // Slate 900 - surface
-          clusterBorder: '#334155',        // Slate 700 - border
-
-          // Active states
-          activeTaskBkgColor: '#3b82f6',   // Blue 500 - primary
-          activeTaskBorderColor: '#60a5fa', // Blue 400 - primary glow
-
-          // Grid and axis
-          gridColor: '#334155',            // Slate 700 - border
-          section0: '#1e293b',             // Slate 800
-          section1: '#0f172a',             // Slate 900
-          section2: '#020617',             // Slate 950
-          section3: '#1e293b',             // Slate 800
-
-          // Special elements
-          fillType0: '#3b82f6',            // Blue 500 - primary
-          fillType1: '#8b5cf6',            // Violet 500 - secondary
-          fillType2: '#06b6d4',            // Cyan 500
-          fillType3: '#10b981',            // Emerald 500
-          fillType4: '#f59e0b',            // Amber 500
-          fillType5: '#ef4444',            // Red 500
-          fillType6: '#ec4899',            // Pink 500
-          fillType7: '#8b5cf6',            // Violet 500
-
-          // Actor colors for sequence diagrams
-          actorBkg: '#1e293b',             // Slate 800
-          actorBorder: '#60a5fa',          // Blue 400
-          actorTextColor: '#e2e8f0',       // Slate 200
-          actorLineColor: '#334155',       // Slate 700
-
-          // Sequence diagram colors
-          activationBkgColor: '#3b82f6',   // Blue 500
-          activationBorderColor: '#60a5fa', // Blue 400
-          signalColor: '#e2e8f0',          // Slate 200
-          signalTextColor: '#e2e8f0',      // Slate 200
-
-          // Note colors
-          noteBkgColor: '#0f172a',         // Slate 900
-          noteBorderColor: '#8b5cf6',      // Violet 500
-          noteTextColor: '#e2e8f0',        // Slate 200
-
-          // Loop colors
-          loopTextColor: '#e2e8f0',        // Slate 200
-
-          // Label colors
-          labelColor: '#e2e8f0',           // Slate 200
-          labelTextColor: '#020617',       // Slate 950 (for contrast on light backgrounds)
-          labelBoxBkgColor: '#3b82f6',     // Blue 500
-          labelBoxBorderColor: '#60a5fa',  // Blue 400
-
-          // Error colors
-          errorBkgColor: '#ef4444',        // Red 500
-          errorTextColor: '#ffffff',
-
-          // Task colors for Gantt charts
-          cScale0: '#3b82f6',              // Blue 500
-          cScale1: '#8b5cf6',              // Violet 500
-          cScale2: '#06b6d4',              // Cyan 500
-          cScale3: '#10b981',              // Emerald 500
-          cScale4: '#f59e0b',              // Amber 500
-          cScale5: '#ef4444',              // Red 500
-
-          // Pie chart colors
-          pie1: '#3b82f6',                 // Blue 500
-          pie2: '#8b5cf6',                 // Violet 500
-          pie3: '#06b6d4',                 // Cyan 500
-          pie4: '#10b981',                 // Emerald 500
-          pie5: '#f59e0b',                 // Amber 500
-          pie6: '#ef4444',                 // Red 500
-          pie7: '#ec4899',                 // Pink 500
-          pie8: '#84cc16',                 // Lime 500
-          pie9: '#6366f1',                 // Indigo 500
-          pie10: '#14b8a6',                // Teal 500
-          pie11: '#f97316',                // Orange 500
-          pie12: '#a855f7',                // Purple 500
-          pieTitleTextSize: '18px',
-          pieTitleTextColor: '#e2e8f0',    // Slate 200
-          pieSectionTextSize: '14px',
-          pieSectionTextColor: '#ffffff',
-          pieLegendTextSize: '14px',
-          pieLegendTextColor: '#e2e8f0',   // Slate 200
-          pieStrokeColor: '#020617',       // Slate 950
-          pieStrokeWidth: '1px',
-          pieOuterStrokeWidth: '2px',
-          pieOuterStrokeColor: '#334155',  // Slate 700
-          pieOpacity: '0.9',
-
-          // Git graph colors
-          git0: '#3b82f6',                 // Blue 500
-          git1: '#8b5cf6',                 // Violet 500
-          git2: '#06b6d4',                 // Cyan 500
-          git3: '#10b981',                 // Emerald 500
-          git4: '#f59e0b',                 // Amber 500
-          git5: '#ef4444',                 // Red 500
-          git6: '#ec4899',                 // Pink 500
-          git7: '#84cc16',                 // Lime 500
-          gitBranchLabel0: '#e2e8f0',      // Slate 200
-          gitBranchLabel1: '#e2e8f0',
-          gitBranchLabel2: '#e2e8f0',
-          gitBranchLabel3: '#e2e8f0',
-          gitBranchLabel4: '#e2e8f0',
-          gitBranchLabel5: '#e2e8f0',
-          gitBranchLabel6: '#e2e8f0',
-          gitBranchLabel7: '#e2e8f0',
-        },
-        flowchart: {
-          curve: 'cardinal',
-          padding: 20,
-          nodeSpacing: 50,
-          rankSpacing: 50,
-          diagramPadding: 8,
-          htmlLabels: true,
-        },
-        sequence: {
-          diagramMarginX: 50,
-          diagramMarginY: 10,
-          actorMargin: 50,
-          width: 150,
-          height: 65,
-          boxMargin: 10,
-          boxTextMargin: 5,
-          noteMargin: 10,
-          messageMargin: 35,
-          mirrorActors: true,
-          bottomMarginAdj: 1,
-          useMaxWidth: true,
-          rightAngles: false,
-          showSequenceNumbers: false,
-        },
-        gantt: {
-          titleTopMargin: 25,
-          barHeight: 20,
-          fontSize: 11,
-          sectionFontSize: 11,
-        },
-        journey: {
-          diagramMarginX: 50,
-          diagramMarginY: 10,
-          leftMargin: 150,
-          width: 150,
-          height: 50,
-          boxMargin: 10,
-          boxTextMargin: 5,
-          noteMargin: 10,
-          messageMargin: 35,
-          bottomMarginAdj: 1,
-        },
-        pie: {
-          textPosition: 0.75,
-        },
-        requirement: {
-          rect_fill: '#1e293b',            // Slate 800
-          text_color: '#e2e8f0',           // Slate 200
-          rect_border_size: '1px',
-          rect_border_color: '#334155',    // Slate 700
-          rect_min_width: 200,
-          rect_min_height: 200,
-          fontSize: 14,
-        },
-        gitGraph: {
-          diagramPadding: 8,
-          nodeLabel: {
-            width: 75,
-            height: 100,
-            x: -25,
-            y: 0,
-          },
-        },
-      });
-      setIsInitialized(true);
-    }
-  }, [isInitialized]);
-
-  useEffect(() => {
-    if (!isInitialized || !ref.current) return;
-
-    const renderDiagram = async () => {
-      try {
-        setError(null);
-        const element = ref.current;
-        if (!element) return;
-
-        // Clear previous content
-        element.innerHTML = '';
-
-        // Generate unique ID for the diagram
-        const diagramId = id || `mermaid-${Math.random().toString(36).substr(2, 9)}`;
-
-        // Render the diagram
-        const { svg, bindFunctions } = await mermaid.render(diagramId, chart);
-
-        element.innerHTML = svg;
-
-        // Bind any interactive functions if they exist
-        if (bindFunctions) {
-          bindFunctions(element);
-        }
-      } catch (err) {
-        console.error('Mermaid rendering error:', err);
-        setError(err instanceof Error ? err.message : 'Failed to render diagram');
-      }
-    };
-
-    renderDiagram();
-  }, [chart, id, isInitialized]);
-
-  if (error) {
-    return (
-      <div className="border border-red-500/30 bg-red-500/10 p-4 rounded-lg backdrop-blur-sm">
-        <div className="text-red-300 text-sm font-medium">
-          Error rendering diagram
-        </div>
-        <div className="text-red-400 text-sm mt-1">
-          {error}
-        </div>
-        <details className="mt-2">
-          <summary className="text-red-300 text-xs cursor-pointer hover:text-red-200">
-            Show diagram code
-          </summary>
-          <pre className="text-red-400 text-xs mt-1 whitespace-pre-wrap font-mono bg-slate-900/50 p-2 rounded border border-red-500/20 overflow-x-auto">
-            {chart}
-          </pre>
-        </details>
-      </div>
-    );
-  }
-
-  return (
-    <div className="mermaid-container my-8">
-      <div
-        ref={ref}
-        className="flex justify-center items-center min-h-[200px] bg-slate-950/50 rounded-xl border border-slate-800/50 p-6 backdrop-blur-sm"
-        style={{
-          filter: 'drop-shadow(0 4px 20px rgba(59, 130, 246, 0.1))',
-        }}
-      />
-    </div>
-  );
-};
-
-export default Mermaid;
diff --git a/docs/src/components/Navbar.tsx b/docs/src/components/Navbar.tsx
deleted file mode 100644
index c544b2d3..00000000
--- a/docs/src/components/Navbar.tsx
+++ /dev/null
@@ -1,67 +0,0 @@
-import { Code } from 'lucide-react'
-import { useTranslation } from 'react-i18next'
-import { useLocation, useNavigate } from 'react-router-dom'
-import LanguageSwitcher from './LanguageSwitcher'
-
-export default function Navbar() {
-    const { t } = useTranslation()
-    const location = useLocation()
-    const navigate = useNavigate()
-    const isHomePage = location.pathname === '/'
-
-    const scrollToTop = () => {
-        if (isHomePage) {
-            window.scrollTo({ top: 0, behavior: 'smooth' })
-        } else {
-            navigate('/')
-            window.scrollTo(0, 0)
-        }
-    }
-
-
-    return (
-        <nav className="fixed top-0 w-full z-50 glass-panel border-b-0 border-white/5">
-            <div className="max-w-7xl mx-auto px-6">
-                <div className="flex items-center justify-between h-16">
-                    {/* Logo + Docs */}
-                    <div className="flex items-center gap-8">
-                        <div
-                            onClick={scrollToTop}
-                            className="flex items-center gap-2 cursor-pointer hover:opacity-80 transition-opacity"
-                        >
-                            <div className="w-8 h-8 bg-primary/20 rounded-lg flex items-center justify-center border border-primary/30">
-                                <span className="font-bold text-primary text-sm">EP</span>
-                            </div>
-                            <span className="font-semibold text-lg tracking-tight text-white">EasyP</span>
-                        </div>
-
-                        <a
-                            href="/docs"
-                            className="text-sm font-medium text-slate-400 hover:text-white transition-colors"
-                        >
-                            {t('nav.documentation')}
-                        </a>
-
-                        <a
-                            href="/blog"
-                            className="text-sm font-medium text-slate-400 hover:text-white transition-colors"
-                        >
-                            {t('nav.blog')}
-                        </a>
-                    </div>
-
-                    {/* Spacer */}
-                    <div className="flex-1"></div>
-
-                    {/* CTA */}
-                    <div className="flex items-center gap-4">
-                        <a href="https://github.com/easyp-tech/easyp" className="hidden sm:flex items-center gap-2 text-sm font-medium text-slate-400 hover:text-white transition-colors">
-                            <Code size={16} /> {t('nav.github')}
-                        </a>
-                        <LanguageSwitcher />
-                    </div>
-                </div>
-            </div>
-        </nav>
-    )
-}
diff --git a/docs/src/components/RegistryPreview.tsx b/docs/src/components/RegistryPreview.tsx
deleted file mode 100644
index fd4c15e1..00000000
--- a/docs/src/components/RegistryPreview.tsx
+++ /dev/null
@@ -1,40 +0,0 @@
-import { ArrowRight } from 'lucide-react'
-
-export default function RegistryPreview() {
-    const plugins = [
-        { name: 'Go', version: 'v1.36.0', type: 'Official' },
-        { name: 'Python', version: 'v4.24.0', type: 'Docker' },
-        { name: 'Java', version: 'v3.21.0', type: 'Community' },
-        { name: 'TypeScript', version: 'v1.12.0', type: 'Wasm' },
-    ]
-
-    return (
-        <section id="registry" className="py-24 relative overflow-hidden">
-            <div className="max-w-7xl mx-auto px-6">
-                <div className="flex items-center justify-between mb-12">
-                    <h2 className="text-2xl font-bold text-white">Plugin Registry</h2>
-                    <a href="#" className="text-sm text-primary hover:text-primaryGlow flex items-center gap-1">
-                        View all <ArrowRight size={14} />
-                    </a>
-                </div>
-
-                <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 gap-6">
-                    {plugins.map((plugin, i) => (
-                        <div key={i} className="bg-slate-900 border border-slate-800 p-6 rounded-xl hover:border-slate-600 transition-all cursor-pointer group">
-                            <div className="flex justify-between items-start mb-4">
-                                <div className="w-10 h-10 bg-slate-800 rounded flex items-center justify-center text-lg font-bold text-white group-hover:bg-white group-hover:text-black transition-colors">
-                                    {plugin.name[0]}
-                                </div>
-                                <span className="text-xs font-mono text-slate-500 bg-slate-950 px-2 py-1 rounded border border-slate-800">
-                                    {plugin.type}
-                                </span>
-                            </div>
-                            <h4 className="text-white font-medium mb-1">{plugin.name}</h4>
-                            <p className="text-xs text-slate-500 font-mono">{plugin.version}</p>
-                        </div>
-                    ))}
-                </div>
-            </div>
-        </section>
-    )
-}
diff --git a/docs/src/components/TrustedBy.tsx b/docs/src/components/TrustedBy.tsx
deleted file mode 100644
index c7f5f7f8..00000000
--- a/docs/src/components/TrustedBy.tsx
+++ /dev/null
@@ -1,67 +0,0 @@
-import { useTranslation } from 'react-i18next'
-import { useState } from 'react'
-
-interface Partner {
-    name: string
-    url: string
-    logo?: string
-}
-
-const partners: Partner[] = [
-    { name: 'comazo', url: 'https://comazo.ru/site_new/index.php', logo: '/assets/partners/comazo.svg' },
-    { name: 'YADRO', url: 'https://yadro.com/', logo: '/assets/partners/yadro.png' },
-    { name: 'h3', url: 'https://h3llo.cloud/', logo: '/assets/partners/h3.png' },
-    { name: 'OpenIDE', url: 'https://openide.ru/', logo: '/assets/partners/openide.png' },
-    { name: 'Positive Tech', url: 'https://ptsecurity.com/', logo: '/assets/partners/pt.png' },
-]
-
-function PartnerItem({ partner }: { partner: Partner }) {
-    const [imgError, setImgError] = useState(false)
-
-    return (
-        <a
-            href={partner.url}
-            target="_blank"
-            rel="noopener noreferrer"
-            className="opacity-40 grayscale whitespace-nowrap flex-shrink-0 hover:opacity-70 transition-opacity"
-        >
-            {partner.logo && !imgError ? (
-                <img
-                    src={partner.logo}
-                    alt={partner.name}
-                    className="h-8 w-auto"
-                    onError={() => setImgError(true)}
-                />
-            ) : (
-                <span className="text-xl font-bold text-white">
-                    {partner.name}
-                </span>
-            )}
-        </a>
-    )
-}
-
-export default function TrustedBy() {
-    const { t } = useTranslation()
-
-    const duplicatedPartners = [...partners, ...partners, ...partners, ...partners]
-
-    return (
-        <section className="py-12 border-y border-white/5 bg-slate-900/30 relative overflow-hidden">
-            <div className="max-w-7xl mx-auto px-6 text-center">
-                <p className="text-sm font-medium text-slate-500 mb-8 uppercase tracking-wider">{t('trustedBy.title')}</p>
-
-                <div className="relative">
-                    <div className="absolute left-0 top-0 bottom-0 w-[100px] bg-gradient-to-r from-background to-transparent z-10 pointer-events-none"></div>
-                    <div className="absolute right-0 top-0 bottom-0 w-[100px] bg-gradient-to-l from-background to-transparent z-10 pointer-events-none"></div>
-
-                    <div className="flex items-center gap-12 animate-marquee hover:[animation-play-state:paused]">
-                        {duplicatedPartners.map((partner, index) => (
-                            <PartnerItem key={`${partner.name}-${index}`} partner={partner} />
-                        ))}
-                    </div>
-                </div>
-            </div>
-        </section>
-    )
-}
diff --git a/docs/src/components/docs/DocsHeader.tsx b/docs/src/components/docs/DocsHeader.tsx
deleted file mode 100644
index 857727d0..00000000
--- a/docs/src/components/docs/DocsHeader.tsx
+++ /dev/null
@@ -1,49 +0,0 @@
-import { Link, useLocation } from 'react-router-dom'
-import { ChevronRight, Home } from 'lucide-react'
-import DocsSearch from './DocsSearch'
-
-export default function DocsHeader() {
-    const location = useLocation()
-    const pathSegments = location.pathname
-        .split('/')
-        .filter(segment => segment && segment !== 'docs')
-
-    return (
-        <header className="sticky top-0 z-30 w-full border-b border-gray-200 dark:border-gray-800 bg-white/80 dark:bg-gray-950/80 backdrop-blur supports-[backdrop-filter]:bg-white/60">
-            <div className="flex h-14 items-center gap-4 px-4 md:px-8">
-                {/* Breadcrumbs */}
-                <nav className="hidden md:flex items-center text-sm text-gray-500 dark:text-gray-400 overflow-hidden whitespace-nowrap">
-                    <Link to="/docs" className="hover:text-gray-900 dark:hover:text-gray-100 transition-colors flex-shrink-0">
-                        <Home className="w-4 h-4" />
-                    </Link>
-                    {pathSegments.map((segment, index) => {
-                        const path = `/docs/${pathSegments.slice(0, index + 1).join('/')}`
-                        const isLast = index === pathSegments.length - 1
-                        const title = segment.charAt(0).toUpperCase() + segment.slice(1).replace(/-/g, ' ')
-
-                        return (
-                            <div key={path} className="flex items-center flex-shrink-0">
-                                <ChevronRight className="w-4 h-4 mx-1 flex-shrink-0" />
-                                {isLast ? (
-                                    <span className="font-medium text-gray-900 dark:text-gray-100 truncate">
-                                        {title}
-                                    </span>
-                                ) : (
-                                    <Link
-                                        to={path}
-                                        className="hover:text-gray-900 dark:hover:text-gray-100 transition-colors truncate"
-                                    >
-                                        {title}
-                                    </Link>
-                                )}
-                            </div>
-                        )
-                    })}
-                </nav>
-
-                <div className="flex-1" />
-                <DocsSearch />
-            </div>
-        </header>
-    )
-}
diff --git a/docs/src/components/docs/DocsLayout.tsx b/docs/src/components/docs/DocsLayout.tsx
deleted file mode 100644
index 348b9a0c..00000000
--- a/docs/src/components/docs/DocsLayout.tsx
+++ /dev/null
@@ -1,78 +0,0 @@
-import { Outlet, useNavigate, Link } from 'react-router-dom'
-import { useEffect, useState } from 'react'
-import { Menu, X } from 'lucide-react'
-import DocsSidebar from './DocsSidebar'
-import TableOfContents from '../../lib/markdown/components/TableOfContents'
-import { useToc } from '../../contexts/TocContext'
-
-export default function DocsLayout() {
-    const navigate = useNavigate()
-    const [sidebarOpen, setSidebarOpen] = useState(false)
-    const tocContext = useToc()
-
-    // Set up window.routerNavigate for markdown link integration
-    useEffect(() => {
-        (window as any).routerNavigate = (path: string) => {
-            navigate(path)
-            // Закрываем sidebar на мобильных после навигации
-            setSidebarOpen(false)
-        }
-
-        return () => {
-            delete (window as any).routerNavigate
-        }
-    }, [navigate])
-
-    return (
-        <div className="min-h-screen bg-white dark:bg-gray-950">
-            {/* Documentation Layout */}
-            <div className="docs-layout">
-                {/* Sidebar */}
-                <DocsSidebar
-                    isOpen={sidebarOpen}
-                    onClose={() => setSidebarOpen(false)}
-                />
-
-                {/* Main Content Area */}
-                <main className="docs-main">
-                    {/* Mobile Header with Hamburger */}
-                    <div className="docs-mobile-header md:hidden">
-                        <button
-                            className="docs-sidebar-toggle"
-                            onClick={() => setSidebarOpen(!sidebarOpen)}
-                            aria-label="Toggle sidebar"
-                        >
-                            {sidebarOpen ? (
-                                <X className="w-6 h-6" />
-                            ) : (
-                                <Menu className="w-6 h-6" />
-                            )}
-                        </button>
-                        <Link to="/" className="flex items-center gap-2 hover:opacity-80 transition-opacity">
-                            <div className="w-6 h-6 bg-blue-500/20 rounded flex items-center justify-center border border-blue-500/30">
-                                <span className="font-bold text-blue-500 text-xs">EP</span>
-                            </div>
-                            <h1 className="text-lg font-bold text-gray-900 dark:text-white">
-                                EasyP
-                            </h1>
-                        </Link>
-                    </div>
-
-                    <div className="docs-content">
-                        <Outlet />
-                    </div>
-                </main>
-
-                {/* Table of Contents - Right Column */}
-                <aside className="docs-toc-container">
-                    {tocContext?.toc && tocContext.toc.length > 0 && (
-                        <TableOfContents
-                            toc={tocContext.toc}
-                            activeId={tocContext.activeId}
-                        />
-                    )}
-                </aside>
-            </div>
-        </div>
-    )
-}
diff --git a/docs/src/components/docs/DocsSearch.tsx b/docs/src/components/docs/DocsSearch.tsx
deleted file mode 100644
index e6332776..00000000
--- a/docs/src/components/docs/DocsSearch.tsx
+++ /dev/null
@@ -1,400 +0,0 @@
-import { useEffect, useMemo, useRef, useState } from 'react'
-import { useNavigate } from 'react-router-dom'
-import { Loader2, Search, X } from 'lucide-react'
-import { useTranslation } from 'react-i18next'
-import { resolveSearchLanguage, searchDocumentation } from '../../lib/search/search'
-import type { SearchHit, SearchResult } from '../../lib/search/types'
-
-const MIN_QUERY_LENGTH = 2
-const MAX_RESULTS = 20
-const SEARCH_DEBOUNCE_MS = 120
-
-interface ResultsProps {
-    query: string
-    isLoading: boolean
-    hasError: boolean
-    results: SearchResult[]
-    expandedPages: Set<string>
-    onSelectResult: (result: SearchHit) => void
-    onTogglePageMatches: (pagePath: string) => void
-    t: (key: string, options?: Record<string, unknown>) => string
-}
-
-function SearchResults({
-    query,
-    isLoading,
-    hasError,
-    results,
-    expandedPages,
-    onSelectResult,
-    onTogglePageMatches,
-    t,
-}: ResultsProps) {
-    if (query.trim().length < MIN_QUERY_LENGTH) {
-        return (
-            <p className="docs-search-state docs-search-state--hint">
-                {t('docsSearch.typeToSearch')}
-            </p>
-        )
-    }
-
-    if (isLoading) {
-        return (
-            <div className="docs-search-state docs-search-state--loading">
-                <Loader2 className="h-4 w-4 animate-spin" />
-                <span>{t('docsSearch.loading')}</span>
-            </div>
-        )
-    }
-
-    if (hasError) {
-        return (
-            <p className="docs-search-state docs-search-state--error">
-                {t('docsSearch.error')}
-            </p>
-        )
-    }
-
-    if (results.length === 0) {
-        return (
-            <p className="docs-search-state docs-search-state--empty">
-                {t('docsSearch.noResults')}
-            </p>
-        )
-    }
-
-    return (
-        <ul className="docs-search-results-list">
-            {results.map((result) => (
-                <li key={result.id}>
-                    <button
-                        type="button"
-                        className="docs-search-result-item"
-                        onClick={() => onSelectResult(result)}
-                    >
-                        <span className="docs-search-result-title">{result.title}</span>
-                        {result.section && (
-                            <span className="docs-search-result-section">{result.section}</span>
-                        )}
-                        <span className="docs-search-result-excerpt">{result.preview}</span>
-                    </button>
-                    {result.moreMatches && result.moreMatches.length > 0 && (
-                        <div className="docs-search-more-wrapper">
-                            <button
-                                type="button"
-                                className="docs-search-more-toggle"
-                                onClick={() => onTogglePageMatches(result.pagePath)}
-                            >
-                                {expandedPages.has(result.pagePath)
-                                    ? t('docsSearch.hideMoreMatches')
-                                    : t('docsSearch.showMoreMatches', { count: result.moreMatches.length })}
-                            </button>
-
-                            {expandedPages.has(result.pagePath) && (
-                                <ul className="docs-search-more-list">
-                                    {result.moreMatches.map((match) => (
-                                        <li key={match.id}>
-                                            <button
-                                                type="button"
-                                                className="docs-search-result-item docs-search-result-item--nested"
-                                                onClick={() => onSelectResult(match)}
-                                            >
-                                                {match.section && (
-                                                    <span className="docs-search-result-section">{match.section}</span>
-                                                )}
-                                                <span className="docs-search-result-excerpt">{match.preview}</span>
-                                            </button>
-                                        </li>
-                                    ))}
-                                </ul>
-                            )}
-                        </div>
-                    )}
-                </li>
-            ))}
-        </ul>
-    )
-}
-
-export default function DocsSearch() {
-    const navigate = useNavigate()
-    const { t, i18n } = useTranslation()
-    const desktopContainerRef = useRef<HTMLDivElement>(null)
-    const mobileInputRef = useRef<HTMLInputElement>(null)
-
-    const [desktopQuery, setDesktopQuery] = useState('')
-    const [mobileQuery, setMobileQuery] = useState('')
-    const [mobileOpen, setMobileOpen] = useState(false)
-    const [showDesktopDropdown, setShowDesktopDropdown] = useState(false)
-    const [isLoading, setIsLoading] = useState(false)
-    const [hasError, setHasError] = useState(false)
-    const [results, setResults] = useState<SearchResult[]>([])
-    const [expandedPages, setExpandedPages] = useState<Set<string>>(new Set())
-
-    const searchLanguage = useMemo(
-        () => resolveSearchLanguage(i18n.language),
-        [i18n.language],
-    )
-
-    const activeQuery = mobileOpen ? mobileQuery : desktopQuery
-
-    useEffect(() => {
-        const query = activeQuery.trim()
-
-        if (query.length < MIN_QUERY_LENGTH) {
-            setResults([])
-            setIsLoading(false)
-            setHasError(false)
-            setExpandedPages(new Set())
-            return
-        }
-
-        let cancelled = false
-        const timer = window.setTimeout(async () => {
-            setIsLoading(true)
-            setHasError(false)
-
-            try {
-                const searchResults = await searchDocumentation({
-                    query,
-                    language: searchLanguage,
-                    limit: MAX_RESULTS,
-                })
-                if (!cancelled) {
-                    setResults(searchResults)
-                    setExpandedPages(new Set())
-                }
-            } catch (error) {
-                console.error('Search failed:', error)
-                if (!cancelled) {
-                    setHasError(true)
-                    setResults([])
-                }
-            } finally {
-                if (!cancelled) {
-                    setIsLoading(false)
-                }
-            }
-        }, SEARCH_DEBOUNCE_MS)
-
-        return () => {
-            cancelled = true
-            window.clearTimeout(timer)
-        }
-    }, [activeQuery, searchLanguage])
-
-    useEffect(() => {
-        const onDocumentClick = (event: MouseEvent) => {
-            if (!desktopContainerRef.current) {
-                return
-            }
-
-            if (!desktopContainerRef.current.contains(event.target as Node)) {
-                setShowDesktopDropdown(false)
-            }
-        }
-
-        document.addEventListener('mousedown', onDocumentClick)
-        return () => {
-            document.removeEventListener('mousedown', onDocumentClick)
-        }
-    }, [])
-
-    useEffect(() => {
-        const onEsc = (event: KeyboardEvent) => {
-            if (event.key !== 'Escape') {
-                return
-            }
-            setShowDesktopDropdown(false)
-            setMobileOpen(false)
-        }
-
-        document.addEventListener('keydown', onEsc)
-        return () => {
-            document.removeEventListener('keydown', onEsc)
-        }
-    }, [])
-
-    useEffect(() => {
-        if (!mobileOpen) {
-            return
-        }
-
-        const frame = window.requestAnimationFrame(() => {
-            mobileInputRef.current?.focus()
-        })
-
-        return () => {
-            window.cancelAnimationFrame(frame)
-        }
-    }, [mobileOpen])
-
-    const selectResult = (result: SearchHit) => {
-        navigate(result.path, {
-            state: {
-                docSearchQuery: activeQuery.trim(),
-            },
-        })
-        setDesktopQuery('')
-        setMobileQuery('')
-        setResults([])
-        setShowDesktopDropdown(false)
-        setMobileOpen(false)
-        setExpandedPages(new Set())
-    }
-
-    const togglePageMatches = (pagePath: string) => {
-        setExpandedPages((prev) => {
-            const next = new Set(prev)
-            if (next.has(pagePath)) {
-                next.delete(pagePath)
-            } else {
-                next.add(pagePath)
-            }
-            return next
-        })
-    }
-
-    const openMobileSearch = () => {
-        setMobileQuery(desktopQuery)
-        setMobileOpen(true)
-    }
-
-    const closeMobileSearch = () => {
-        setMobileOpen(false)
-    }
-
-    const showDropdown = showDesktopDropdown && desktopQuery.trim().length >= MIN_QUERY_LENGTH
-
-    return (
-        <>
-            <div ref={desktopContainerRef} className="docs-search-desktop hidden md:block">
-                <div className="docs-search-input-wrapper">
-                    <Search className="docs-search-input-icon" />
-                    <input
-                        type="text"
-                        value={desktopQuery}
-                        onChange={(event) => {
-                            const nextValue = event.target.value
-                            setDesktopQuery(nextValue)
-                            if (nextValue.trim().length >= MIN_QUERY_LENGTH) {
-                                setShowDesktopDropdown(true)
-                            } else {
-                                setShowDesktopDropdown(false)
-                            }
-                        }}
-                        onFocus={() => {
-                            if (desktopQuery.trim().length >= MIN_QUERY_LENGTH) {
-                                setShowDesktopDropdown(true)
-                            }
-                        }}
-                        placeholder={t('docsSearch.placeholder')}
-                        className="docs-search-input"
-                    />
-                    {desktopQuery && (
-                        <button
-                            type="button"
-                            className="docs-search-clear"
-                            onClick={() => {
-                                setDesktopQuery('')
-                                setShowDesktopDropdown(false)
-                                setExpandedPages(new Set())
-                            }}
-                            aria-label={t('docsSearch.clear')}
-                        >
-                            <X className="h-4 w-4" />
-                        </button>
-                    )}
-                </div>
-
-                {showDropdown && (
-                    <div className="docs-search-dropdown">
-                        <SearchResults
-                            query={desktopQuery}
-                            isLoading={isLoading}
-                            hasError={hasError}
-                            results={results}
-                            expandedPages={expandedPages}
-                            onSelectResult={selectResult}
-                            onTogglePageMatches={togglePageMatches}
-                            t={t}
-                        />
-                    </div>
-                )}
-            </div>
-
-            <div className="md:hidden">
-                <button
-                    type="button"
-                    className="docs-search-mobile-trigger"
-                    onClick={openMobileSearch}
-                    aria-label={t('docsSearch.open')}
-                >
-                    <Search className="h-5 w-5" />
-                </button>
-            </div>
-
-            {mobileOpen && (
-                <div className="docs-search-mobile-overlay md:hidden">
-                    <button
-                        type="button"
-                        className="docs-search-mobile-backdrop"
-                        onClick={closeMobileSearch}
-                        aria-label={t('docsSearch.close')}
-                    />
-                    <div className="docs-search-mobile-sheet">
-                        <div className="docs-search-mobile-top">
-                            <div className="docs-search-input-wrapper docs-search-input-wrapper--mobile">
-                                <Search className="docs-search-input-icon" />
-                                <input
-                                    ref={mobileInputRef}
-                                    type="text"
-                                    value={mobileQuery}
-                                    onChange={(event) => {
-                                        setMobileQuery(event.target.value)
-                                    }}
-                                    placeholder={t('docsSearch.mobilePlaceholder')}
-                                    className="docs-search-input"
-                                />
-                                {mobileQuery && (
-                                    <button
-                                        type="button"
-                                        className="docs-search-clear"
-                                        onClick={() => {
-                                            setMobileQuery('')
-                                            setExpandedPages(new Set())
-                                        }}
-                                        aria-label={t('docsSearch.clear')}
-                                    >
-                                        <X className="h-4 w-4" />
-                                    </button>
-                                )}
-                            </div>
-
-                            <button
-                                type="button"
-                                className="docs-search-mobile-close"
-                                onClick={closeMobileSearch}
-                            >
-                                {t('docsSearch.cancel')}
-                            </button>
-                        </div>
-
-                        <div className="docs-search-mobile-results">
-                            <SearchResults
-                                query={mobileQuery}
-                                isLoading={isLoading}
-                                hasError={hasError}
-                                results={results}
-                                expandedPages={expandedPages}
-                                onSelectResult={selectResult}
-                                onTogglePageMatches={togglePageMatches}
-                                t={t}
-                            />
-                        </div>
-                    </div>
-                </div>
-            )}
-        </>
-    )
-}
diff --git a/docs/src/components/docs/DocsSidebar.tsx b/docs/src/components/docs/DocsSidebar.tsx
deleted file mode 100644
index 48c968ce..00000000
--- a/docs/src/components/docs/DocsSidebar.tsx
+++ /dev/null
@@ -1,137 +0,0 @@
-import { useEffect, useState } from 'react'
-import { useLocation, Link } from 'react-router-dom'
-import SidebarItem from './SidebarItem'
-import type { SidebarConfig } from '../../types/sidebar'
-import {
-    loadSidebarConfig,
-    getParentPaths,
-    getItemId,
-    saveExpandedState,
-    loadExpandedState,
-    isPathActive
-} from '../../utils/sidebarUtils'
-
-interface DocsSidebarProps {
-    isOpen: boolean
-    onClose: () => void
-}
-
-export default function DocsSidebar({ isOpen, onClose }: DocsSidebarProps) {
-    const location = useLocation()
-    const [sidebarData, setSidebarData] = useState<SidebarConfig>([])
-    const [expandedSections, setExpandedSections] = useState<Set<string>>(new Set())
-
-    // Загрузка конфигурации sidebar
-    useEffect(() => {
-        const config = loadSidebarConfig()
-        setSidebarData(config)
-    }, [])
-
-    // Загрузка сохраненного состояния из localStorage
-    useEffect(() => {
-        const saved = loadExpandedState()
-        setExpandedSections(saved)
-    }, [])
-
-    // Автоматическое разворачивание секции с активной страницей
-    useEffect(() => {
-        if (sidebarData.length > 0) {
-            const parentPaths = getParentPaths(sidebarData, location.pathname)
-            if (parentPaths.length > 0) {
-                setExpandedSections((prev) => {
-                    const newSet = new Set(prev)
-                    parentPaths.forEach((path) => newSet.add(path))
-                    return newSet
-                })
-            }
-        }
-    }, [location.pathname, sidebarData])
-
-    // Сохранение состояния в localStorage при изменении
-    useEffect(() => {
-        saveExpandedState(expandedSections)
-    }, [expandedSections])
-
-    const toggleSection = (id: string) => {
-        setExpandedSections((prev) => {
-            const newSet = new Set(prev)
-            if (newSet.has(id)) {
-                newSet.delete(id)
-            } else {
-                newSet.add(id)
-            }
-            return newSet
-        })
-    }
-
-    const renderItem = (item: any, index: number, level: number = 0) => {
-        const itemId = getItemId(item, index)
-        const isExpanded = expandedSections.has(itemId) || expandedSections.has(item.path || '')
-        const isActive = isPathActive(item.path, location.pathname)
-        const hasChildren = item.children && item.children.length > 0
-
-        return (
-            <div key={itemId}>
-                <SidebarItem
-                    item={item}
-                    level={level}
-                    isExpanded={isExpanded}
-                    isActive={isActive}
-                    onToggle={() => {
-                        const toggleId = item.path || itemId
-                        toggleSection(toggleId)
-                    }}
-                />
-
-                {/* Рекурсивный рендеринг children */}
-                {hasChildren && (
-                    <div
-                        className={`sidebar-children ${isExpanded ? 'sidebar-children--expanded' : ''
-                            }`}
-                    >
-                        {isExpanded &&
-                            item.children.map((child: any, childIndex: number) =>
-                                renderItem(child, childIndex, level + 1)
-                            )}
-                    </div>
-                )}
-            </div>
-        )
-    }
-
-    const sidebarClasses = `
-        docs-sidebar
-        ${isOpen ? 'docs-sidebar--open' : ''}
-    `.trim()
-
-    return (
-        <>
-            {/* Backdrop для мобильных */}
-            {isOpen && (
-                <div
-                    className="docs-sidebar-backdrop"
-                    onClick={onClose}
-                    aria-hidden="true"
-                />
-            )}
-
-            {/* Sidebar */}
-            <aside className={sidebarClasses}>
-                <div className="docs-sidebar-header">
-                    <Link to="/" className="flex items-center gap-2 hover:opacity-80 transition-opacity">
-                        <div className="w-8 h-8 bg-blue-500/20 rounded-lg flex items-center justify-center border border-blue-500/30">
-                            <span className="font-bold text-blue-500 text-sm">EP</span>
-                        </div>
-                        <h2 className="text-xl font-bold text-gray-900 dark:text-white">
-                            EasyP
-                        </h2>
-                    </Link>
-                </div>
-
-                <nav className="docs-sidebar-nav">
-                    {sidebarData.map((item, index) => renderItem(item, index, 0))}
-                </nav>
-            </aside>
-        </>
-    )
-}
diff --git a/docs/src/components/docs/MarkdownPage.tsx b/docs/src/components/docs/MarkdownPage.tsx
deleted file mode 100644
index aedf62ae..00000000
--- a/docs/src/components/docs/MarkdownPage.tsx
+++ /dev/null
@@ -1,368 +0,0 @@
-import { useState, useEffect } from 'react'
-import { useParams, useLocation, Link } from 'react-router-dom'
-import { MarkdownContent } from '../../lib/markdown'
-import { Loader2, AlertCircle, ChevronLeft, ChevronRight, Github } from 'lucide-react'
-import { useTranslation } from 'react-i18next'
-import DocsHeader from './DocsHeader'
-import { getPrevNext, loadSidebarConfig } from '../../utils/sidebarUtils'
-import type { SidebarItem } from '../../types/sidebar'
-
-interface MarkdownPageProps {
-    path?: string
-}
-
-export default function MarkdownPage({ path }: MarkdownPageProps) {
-    const params = useParams<{
-        category?: string;
-        subcategory?: string;
-        subsubcategory?: string;
-        section?: string;
-        page?: string
-    }>()
-    const location = useLocation()
-    const { i18n } = useTranslation()
-    const [content, setContent] = useState<string>('')
-    const [isLoading, setIsLoading] = useState(true)
-    const [error, setError] = useState<string | null>(null)
-    const [activeFilePath, setActiveFilePath] = useState<string>('')
-    const [prevNext, setPrevNext] = useState<{ prev: SidebarItem | null; next: SidebarItem | null }>({
-        prev: null,
-        next: null
-    })
-
-    useEffect(() => {
-        const loadMarkdown = async () => {
-            setIsLoading(true)
-            setError(null)
-
-            try {
-                // Construct the file path from either prop or route params
-                let filePath: string
-
-                if (path) {
-                    filePath = path
-                } else if (params.section) {
-                    // Five-level route: /docs/:category/:subcategory/:subsubcategory/:section/:page
-                    filePath = `${params.category}/${params.subcategory}/${params.subsubcategory}/${params.section}/${params.page}`
-                } else if (params.subsubcategory) {
-                    // Four-level route: /docs/:category/:subcategory/:subsubcategory/:page
-                    filePath = `${params.category}/${params.subcategory}/${params.subsubcategory}/${params.page}`
-                } else if (params.subcategory) {
-                    // Three-level route: /docs/:category/:subcategory/:page
-                    filePath = `${params.category}/${params.subcategory}/${params.page}`
-                } else if (params.category && params.page) {
-                    // Two-level route: /docs/:category/:page
-                    filePath = `${params.category}/${params.page}`
-                } else {
-                    throw new Error('Invalid route parameters')
-                }
-
-                // Helper to fetch and validate markdown
-                const fetchMarkdown = async (url: string): Promise<string | null> => {
-                    const response = await fetch(url);
-                    if (!response.ok) return null;
-
-                    const contentType = response.headers.get('content-type');
-                    if (contentType && contentType.includes('text/html')) {
-                        return null; // It's the SPA fallback, not the file
-                    }
-
-                    return response.text();
-                };
-
-                // Determine language-specific root directory and normalize relative path
-                // filePath at this point is like "guide/introduction/what-is" or "introduction/what-is" or "blog/finally-give-up-gin-echo"
-                const normalizeBase = (fp: string): string => {
-                    if (fp.startsWith('guide/')) return fp.slice('guide/'.length)
-                    if (fp.startsWith('ru-guide/')) return fp.slice('ru-guide/'.length)
-                    if (fp.startsWith('blog/')) return fp.slice('blog/'.length)
-                    return fp
-                }
-
-                const baseRelative = normalizeBase(filePath)
-
-                // Check if this is a blog path
-                const isBlogPath = filePath.startsWith('blog/')
-
-                // Build candidate paths in priority order:
-                let candidates: string[] = []
-
-                if (isBlogPath) {
-                    // For blog posts, only check the blog directory
-                    candidates = [`/docs/blog/${baseRelative}.md`]
-                } else {
-                    // For regular docs:
-                    // 1. Language-specific path (ru-guide/...)
-                    // 2. English fallback (guide/...)
-                    const langRoot = i18n.language === 'ru' ? 'ru-guide' : 'guide'
-                    candidates = [
-                        `/docs/${langRoot}/${baseRelative}.md`,
-                        `/docs/guide/${baseRelative}.md`
-                    ]
-
-                    // Support nested structure variant: /path/to/page/page.md
-                    if (params.page) {
-                        candidates.push(
-                            `/docs/${langRoot}/${baseRelative}/${params.page}.md`,
-                            `/docs/guide/${baseRelative}/${params.page}.md`
-                        )
-                    }
-                }
-
-                let text: string | null = null
-                for (const url of candidates) {
-                    text = await fetchMarkdown(url)
-                    if (text) {
-                        break
-                    }
-                }
-
-                if (!text) {
-                    throw new Error('Documentation page not found (checked language + fallback).')
-                }
-
-                setContent(text)
-                // Store the path that was actually loaded (relative to docs root)
-                // For the edit link, we need to know the correct path
-                const effectivePath = isBlogPath ? `blog/${baseRelative}.md` : `${i18n.language === 'ru' ? 'ru-guide' : 'guide'}/${baseRelative}.md`
-                setActiveFilePath(effectivePath)
-            } catch (err) {
-                console.error('Error loading markdown:', err)
-                setError(err instanceof Error ? err.message : 'An unexpected error occurred')
-            } finally {
-                setIsLoading(false)
-            }
-        }
-
-        loadMarkdown()
-    }, [path, params.category, params.subcategory, params.subsubcategory, params.section, params.page, i18n.language])
-
-    useEffect(() => {
-        const config = loadSidebarConfig()
-        const { prev, next } = getPrevNext(config, location.pathname)
-        setPrevNext({ prev, next })
-    }, [location.pathname])
-
-    useEffect(() => {
-        if (isLoading || !content) {
-            return
-        }
-
-        const rawHash = location.hash.replace(/^#/, '')
-        if (!rawHash) {
-            return
-        }
-
-        const targetId = decodeURIComponent(rawHash)
-        let attempts = 0
-        const maxAttempts = 20
-
-        const scrollToAnchor = () => {
-            const element = document.getElementById(targetId)
-            if (!element) {
-                return false
-            }
-
-            const y = element.getBoundingClientRect().top + window.scrollY - 88
-            window.scrollTo({
-                top: Math.max(0, y),
-                behavior: 'smooth',
-            })
-            return true
-        }
-
-        if (scrollToAnchor()) {
-            return
-        }
-
-        const intervalId = window.setInterval(() => {
-            attempts += 1
-            if (scrollToAnchor() || attempts >= maxAttempts) {
-                window.clearInterval(intervalId)
-            }
-        }, 120)
-
-        return () => {
-            window.clearInterval(intervalId)
-        }
-    }, [isLoading, content, location.hash])
-
-    useEffect(() => {
-        if (isLoading || !content) {
-            return
-        }
-
-        const state = location.state as { docSearchQuery?: string } | null
-        const query = state?.docSearchQuery?.trim()
-        if (!query || query.length < 2) {
-            return
-        }
-
-        const root = document.querySelector('.markdown-body') as HTMLElement | null
-        if (!root) {
-            return
-        }
-
-        const clearMarks = () => {
-            const marks = root.querySelectorAll('mark.docs-search-hit')
-            marks.forEach((mark) => {
-                const parent = mark.parentNode
-                if (!parent) return
-                parent.replaceChild(document.createTextNode(mark.textContent || ''), mark)
-                parent.normalize()
-            })
-        }
-
-        const markFirstOccurrence = (startFromAnchor: boolean): HTMLElement | null => {
-            const target = query.toLowerCase()
-            const hashId = decodeURIComponent(location.hash.replace(/^#/, ''))
-            const anchor = hashId ? document.getElementById(hashId) : null
-
-            const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT)
-            let reachedAnchor = !startFromAnchor || !anchor
-
-            while (walker.nextNode()) {
-                const node = walker.currentNode as Text
-                const parent = node.parentElement
-                const value = node.nodeValue || ''
-                if (!parent || !value.trim()) {
-                    continue
-                }
-
-                if (!reachedAnchor && anchor) {
-                    const relation = anchor.compareDocumentPosition(parent)
-                    const isFollowing = (relation & Node.DOCUMENT_POSITION_FOLLOWING) !== 0
-                    const isInside = anchor.contains(parent) || anchor === parent
-                    if (isFollowing || isInside) {
-                        reachedAnchor = true
-                    } else {
-                        continue
-                    }
-                }
-
-                const index = value.toLowerCase().indexOf(target)
-                if (index === -1) {
-                    continue
-                }
-
-                const range = document.createRange()
-                range.setStart(node, index)
-                range.setEnd(node, index + query.length)
-
-                const mark = document.createElement('mark')
-                mark.className = 'docs-search-hit'
-                range.surroundContents(mark)
-                return mark
-            }
-
-            return null
-        }
-
-        clearMarks()
-        const highlighted = markFirstOccurrence(true) || markFirstOccurrence(false)
-        if (!highlighted) {
-            return
-        }
-
-        const y = highlighted.getBoundingClientRect().top + window.scrollY - 100
-        window.scrollTo({
-            top: Math.max(0, y),
-            behavior: 'smooth',
-        })
-    }, [isLoading, content, location.hash, location.key, location.state])
-
-    if (isLoading) {
-        return (
-            <div className="flex items-center justify-center min-h-[60vh]">
-                <div className="text-center">
-                    <Loader2 className="w-12 h-12 text-blue-600 animate-spin mx-auto mb-4" />
-                    <p className="text-gray-600 dark:text-gray-400">Loading documentation...</p>
-                </div>
-            </div>
-        )
-    }
-
-    if (error) {
-        return (
-            <div className="flex items-center justify-center min-h-[60vh]">
-                <div className="text-center max-w-md">
-                    <AlertCircle className="w-12 h-12 text-red-500 mx-auto mb-4" />
-                    <h2 className="text-2xl font-bold text-gray-900 dark:text-white mb-2">
-                        Failed to Load Page
-                    </h2>
-                    <p className="text-gray-600 dark:text-gray-400 mb-4">
-                        {error}
-                    </p>
-                    <p className="text-sm text-gray-500">
-                        Please check the URL or try again later.
-                    </p>
-                </div>
-            </div>
-        )
-    }
-
-    return (
-        <div className="flex flex-col min-h-screen bg-white dark:bg-gray-950">
-            <DocsHeader />
-
-            <div className="flex-1 w-full max-w-4xl mx-auto px-4 md:px-8 py-8">
-                <MarkdownContent
-                    content={content}
-                    options={{
-                        enableToc: true,
-                        enableCodeFocus: true,
-                        enableHtmlBlocks: true,
-                        enableLinkProcessing: true,
-                        tocDepth: { min: 2, max: 4 }
-                    }}
-                />
-
-                <div className="mt-16 pt-8 border-t border-gray-200 dark:border-gray-800">
-                    <div className="flex justify-end mb-8">
-                        <a
-                            href={`https://github.com/easyp-tech/easyp/edit/main/docs/public/docs/${activeFilePath}`}
-                            target="_blank"
-                            rel="noopener noreferrer"
-                            className="flex items-center text-sm text-gray-500 hover:text-blue-600 dark:text-gray-400 dark:hover:text-blue-400 transition-colors"
-                        >
-                            <Github className="w-4 h-4 mr-2" />
-                            Edit this page on GitHub
-                        </a>
-                    </div>
-
-                    <div className="grid grid-cols-2 gap-4">
-                        {prevNext.prev ? (
-                            <Link
-                                to={prevNext.prev.path!}
-                                className="flex flex-col p-4 rounded-lg border border-gray-200 dark:border-gray-800 hover:border-blue-500 dark:hover:border-blue-500 transition-colors group"
-                            >
-                                <span className="text-xs text-gray-500 dark:text-gray-400 mb-1 flex items-center">
-                                    <ChevronLeft className="w-3 h-3 mr-1" />
-                                    Previous
-                                </span>
-                                <span className="font-medium text-blue-600 dark:text-blue-400 group-hover:underline truncate">
-                                    {prevNext.prev.title}
-                                </span>
-                            </Link>
-                        ) : <div />}
-
-                        {prevNext.next && (
-                            <Link
-                                to={prevNext.next.path!}
-                                className="flex flex-col items-end p-4 rounded-lg border border-gray-200 dark:border-gray-800 hover:border-blue-500 dark:hover:border-blue-500 transition-colors group"
-                            >
-                                <span className="text-xs text-gray-500 dark:text-gray-400 mb-1 flex items-center">
-                                    Next
-                                    <ChevronRight className="w-3 h-3 ml-1" />
-                                </span>
-                                <span className="font-medium text-blue-600 dark:text-blue-400 group-hover:underline truncate">
-                                    {prevNext.next.title}
-                                </span>
-                            </Link>
-                        )}
-                    </div>
-                </div>
-            </div>
-        </div>
-    )
-}
diff --git a/docs/src/components/docs/NotFound.tsx b/docs/src/components/docs/NotFound.tsx
deleted file mode 100644
index 24588ef0..00000000
--- a/docs/src/components/docs/NotFound.tsx
+++ /dev/null
@@ -1,47 +0,0 @@
-import { Link } from 'react-router-dom'
-import { FileQuestion, Home } from 'lucide-react'
-
-export default function NotFound() {
-    return (
-        <div className="flex flex-col items-center justify-center min-h-[60vh] px-4 text-center">
-            <div className="mb-8">
-                <FileQuestion className="w-24 h-24 text-gray-400 mx-auto mb-4" />
-            </div>
-
-            <h1 className="text-4xl font-bold text-gray-900 dark:text-white mb-4">
-                Page Not Found
-            </h1>
-
-            <p className="text-lg text-gray-600 dark:text-gray-400 mb-8 max-w-md">
-                The documentation page you're looking for doesn't exist.
-                It may have been moved or deleted.
-            </p>
-
-            <div className="flex flex-col sm:flex-row gap-4">
-                <Link
-                    to="/docs"
-                    className="inline-flex items-center gap-2 px-6 py-3 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition-colors"
-                >
-                    <Home className="w-5 h-5" />
-                    Go to Documentation Home
-                </Link>
-
-                <Link
-                    to="/"
-                    className="inline-flex items-center gap-2 px-6 py-3 border border-gray-300 dark:border-gray-700 text-gray-700 dark:text-gray-300 rounded-lg hover:bg-gray-50 dark:hover:bg-gray-800 transition-colors"
-                >
-                    Back to Main Site
-                </Link>
-            </div>
-
-            <div className="mt-12 text-sm text-gray-500 dark:text-gray-500">
-                <p className="mb-2">Looking for something specific?</p>
-                <ul className="space-y-1">
-                    <li><Link to="/docs/introduction/what-is" className="text-blue-600 hover:underline">What is EasyP?</Link></li>
-                    <li><Link to="/docs/introduction/quickstart" className="text-blue-600 hover:underline">Quickstart Guide</Link></li>
-                    <li><Link to="/docs/introduction/install" className="text-blue-600 hover:underline">Installation</Link></li>
-                </ul>
-            </div>
-        </div>
-    )
-}
diff --git a/docs/src/components/docs/SidebarItem.tsx b/docs/src/components/docs/SidebarItem.tsx
deleted file mode 100644
index 21654667..00000000
--- a/docs/src/components/docs/SidebarItem.tsx
+++ /dev/null
@@ -1,88 +0,0 @@
-import { Link } from 'react-router-dom'
-import { ChevronDown, ChevronRight } from 'lucide-react'
-import * as Icons from 'lucide-react'
-import type { SidebarItem as SidebarItemType } from '../../types/sidebar'
-
-interface SidebarItemProps {
-    item: SidebarItemType
-    level: number
-    isExpanded: boolean
-    isActive: boolean
-    onToggle?: () => void
-}
-
-export default function SidebarItem({
-    item,
-    level,
-    isExpanded,
-    isActive,
-    onToggle
-}: SidebarItemProps) {
-    const hasChildren = item.children && item.children.length > 0
-    const Icon = item.icon ? (Icons as any)[item.icon] : null
-
-    const itemClasses = `
-        sidebar-item
-        sidebar-item--level-${level}
-        ${isActive ? 'sidebar-item--active' : ''}
-        ${hasChildren ? 'sidebar-item--parent' : ''}
-    `.trim()
-
-    const content = (
-        <div className={itemClasses}>
-            <div className="sidebar-item__content">
-                {/* Иконка */}
-                {Icon && level === 0 && (
-                    <Icon className="sidebar-item__icon" size={18} />
-                )}
-
-                {/* Заголовок */}
-                {item.path ? (
-                    <Link
-                        to={item.path}
-                        className="sidebar-item__link"
-                    >
-                        {item.title}
-                    </Link>
-                ) : (
-                    <span
-                        className="sidebar-item__text"
-                        onClick={() => {
-                            // Если нет path но есть children, разворачиваем при клике
-                            if (hasChildren) {
-                                onToggle?.()
-                            }
-                        }}
-                        style={{ cursor: hasChildren ? 'pointer' : 'default' }}
-                    >
-                        {item.title}
-                    </span>
-                )}
-
-                {/* Кнопка разворачивания */}
-                {hasChildren && (
-                    <button
-                        className="sidebar-item__toggle"
-                        onClick={(e) => {
-                            e.preventDefault()
-                            onToggle?.()
-                        }}
-                        aria-label={isExpanded ? 'Collapse' : 'Expand'}
-                    >
-                        {isExpanded ? (
-                            <ChevronDown size={16} />
-                        ) : (
-                            <ChevronRight size={16} />
-                        )}
-                    </button>
-                )}
-            </div>
-        </div>
-    )
-
-    return (
-        <div className="sidebar-item-wrapper">
-            {content}
-        </div>
-    )
-}
diff --git a/docs/src/config/sidebar.en.json b/docs/src/config/sidebar.en.json
deleted file mode 100644
index 9a8a9803..00000000
--- a/docs/src/config/sidebar.en.json
+++ /dev/null
@@ -1,353 +0,0 @@
-[
-  {
-    "title": "Introduction",
-    "icon": "BookOpen",
-    "children": [
-      {
-        "title": "What is EasyP?",
-        "path": "/docs/guide/introduction/what-is"
-      },
-      {
-        "title": "Quickstart",
-        "path": "/docs/guide/introduction/quickstart"
-      },
-      {
-        "title": "Installation",
-        "path": "/docs/guide/introduction/install"
-      }
-    ]
-  },
-  {
-    "title": "EasyP CLI",
-    "icon": "Terminal",
-    "children": [
-      {
-        "title": "Linter",
-        "path": "/docs/guide/cli/linter/linter",
-        "children": [
-          {
-            "title": "Rules",
-            "children": [
-              {
-                "title": "Comment Enum Value",
-                "path": "/docs/guide/cli/linter/rules/comment-enum-value"
-              },
-              {
-                "title": "Comment Enum",
-                "path": "/docs/guide/cli/linter/rules/comment-enum"
-              },
-              {
-                "title": "Comment Field",
-                "path": "/docs/guide/cli/linter/rules/comment-field"
-              },
-              {
-                "title": "Comment Message",
-                "path": "/docs/guide/cli/linter/rules/comment-message"
-              },
-              {
-                "title": "Comment Oneof",
-                "path": "/docs/guide/cli/linter/rules/comment-oneof"
-              },
-              {
-                "title": "Comment RPC",
-                "path": "/docs/guide/cli/linter/rules/comment-rpc"
-              },
-              {
-                "title": "Comment Service",
-                "path": "/docs/guide/cli/linter/rules/comment-service"
-              },
-              {
-                "title": "Directory Same Package",
-                "path": "/docs/guide/cli/linter/rules/directory-same-package"
-              },
-              {
-                "title": "Enum First Value Zero",
-                "path": "/docs/guide/cli/linter/rules/enum-first-value-zero"
-              },
-              {
-                "title": "Enum No Allow Alias",
-                "path": "/docs/guide/cli/linter/rules/enum-no-allow-alias"
-              },
-              {
-                "title": "Enum Pascal Case",
-                "path": "/docs/guide/cli/linter/rules/enum-pascal-case"
-              },
-              {
-                "title": "Enum Value Prefix",
-                "path": "/docs/guide/cli/linter/rules/enum-value-prefix"
-              },
-              {
-                "title": "Enum Value Upper Snake Case",
-                "path": "/docs/guide/cli/linter/rules/enum-value-upper-snake-case"
-              },
-              {
-                "title": "Enum Zero Value Suffix",
-                "path": "/docs/guide/cli/linter/rules/enum-zero-value-suffix"
-              },
-              {
-                "title": "Field Lower Snake Case",
-                "path": "/docs/guide/cli/linter/rules/field-lower-snake-case"
-              },
-              {
-                "title": "File Lower Snake Case",
-                "path": "/docs/guide/cli/linter/rules/file-lower-snake-case"
-              },
-              {
-                "title": "Import No Public",
-                "path": "/docs/guide/cli/linter/rules/import-no-public"
-              },
-              {
-                "title": "Import No Weak",
-                "path": "/docs/guide/cli/linter/rules/import-no-weak"
-              },
-              {
-                "title": "Import Used",
-                "path": "/docs/guide/cli/linter/rules/import-used"
-              },
-              {
-                "title": "Message Pascal Case",
-                "path": "/docs/guide/cli/linter/rules/message-pascal-case"
-              },
-              {
-                "title": "Oneof Lower Snake Case",
-                "path": "/docs/guide/cli/linter/rules/oneof-lower-snake-case"
-              },
-              {
-                "title": "Package Defined",
-                "path": "/docs/guide/cli/linter/rules/package-defined"
-              },
-              {
-                "title": "Package Directory Match",
-                "path": "/docs/guide/cli/linter/rules/package-directory-match"
-              },
-              {
-                "title": "Package Lower Snake Case",
-                "path": "/docs/guide/cli/linter/rules/package-lower-snake-case"
-              },
-              {
-                "title": "Package Same C# Namespace",
-                "path": "/docs/guide/cli/linter/rules/package-same-csharp-namespace"
-              },
-              {
-                "title": "Package Same Directory",
-                "path": "/docs/guide/cli/linter/rules/package-same-directory"
-              },
-              {
-                "title": "Package Same Go Package",
-                "path": "/docs/guide/cli/linter/rules/package-same-go-package"
-              },
-              {
-                "title": "Package Same Java Multiple Files",
-                "path": "/docs/guide/cli/linter/rules/package-same-java-multiple-files"
-              },
-              {
-                "title": "Package Same Java Package",
-                "path": "/docs/guide/cli/linter/rules/package-same-java-package"
-              },
-              {
-                "title": "Package Same PHP Namespace",
-                "path": "/docs/guide/cli/linter/rules/package-same-php-namespace"
-              },
-              {
-                "title": "Package Same Ruby Package",
-                "path": "/docs/guide/cli/linter/rules/package-same-ruby-package"
-              },
-              {
-                "title": "Package Same Swift Prefix",
-                "path": "/docs/guide/cli/linter/rules/package-same-swift-prefix"
-              },
-              {
-                "title": "Package Version Suffix",
-                "path": "/docs/guide/cli/linter/rules/package-version-suffix"
-              },
-              {
-                "title": "RPC No Client Streaming",
-                "path": "/docs/guide/cli/linter/rules/rpc-no-client-streaming"
-              },
-              {
-                "title": "RPC No Server Streaming",
-                "path": "/docs/guide/cli/linter/rules/rpc-no-server-streaming"
-              },
-              {
-                "title": "RPC Pascal Case",
-                "path": "/docs/guide/cli/linter/rules/rpc-pascal-case"
-              },
-              {
-                "title": "RPC Request Response Unique",
-                "path": "/docs/guide/cli/linter/rules/rpc-request-response-unique"
-              },
-              {
-                "title": "RPC Request Standard Name",
-                "path": "/docs/guide/cli/linter/rules/rpc-request-standard-name"
-              },
-              {
-                "title": "RPC Response Standard Name",
-                "path": "/docs/guide/cli/linter/rules/rpc-response-standard-name"
-              },
-              {
-                "title": "Service Pascal Case",
-                "path": "/docs/guide/cli/linter/rules/service-pascal-case"
-              },
-              {
-                "title": "Service Suffix",
-                "path": "/docs/guide/cli/linter/rules/service-suffix"
-              }
-            ]
-          }
-        ]
-      },
-      {
-        "title": "Generator",
-        "path": "/docs/guide/cli/generator/generator",
-        "children": [
-          {
-            "title": "Examples",
-            "children": [
-              {
-                "title": "Go",
-                "path": "/docs/guide/cli/generator/examples/go"
-              },
-              {
-                "title": "gRPC Gateway",
-                "path": "/docs/guide/cli/generator/examples/grpc-gateway"
-              },
-              {
-                "title": "Validate",
-                "path": "/docs/guide/cli/generator/examples/validate"
-              }
-            ]
-          }
-        ]
-      },
-      {
-        "title": "Package Manager",
-        "path": "/docs/guide/cli/package-manager/package-manager"
-      },
-      {
-        "title": "Breaking Changes",
-        "path": "/docs/guide/cli/breaking-changes/breaking-changes",
-        "children": [
-          {
-            "title": "Rules",
-            "children": [
-              {
-                "title": "Enum No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/enum-no-delete"
-              },
-              {
-                "title": "Enum Value No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/enum-value-no-delete"
-              },
-              {
-                "title": "Enum Value Same Name",
-                "path": "/docs/guide/cli/breaking-changes/rules/enum-value-same-name"
-              },
-              {
-                "title": "Field No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/field-no-delete"
-              },
-              {
-                "title": "Field Same Cardinality",
-                "path": "/docs/guide/cli/breaking-changes/rules/field-same-cardinality"
-              },
-              {
-                "title": "Field Same Type",
-                "path": "/docs/guide/cli/breaking-changes/rules/field-same-type"
-              },
-              {
-                "title": "Import No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/import-no-delete"
-              },
-              {
-                "title": "Message No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/message-no-delete"
-              },
-              {
-                "title": "Oneof Field No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete"
-              },
-              {
-                "title": "Oneof Field Same Type",
-                "path": "/docs/guide/cli/breaking-changes/rules/oneof-field-same-type"
-              },
-              {
-                "title": "Oneof No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/oneof-no-delete"
-              },
-              {
-                "title": "RPC No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/rpc-no-delete"
-              },
-              {
-                "title": "RPC Same Request Type",
-                "path": "/docs/guide/cli/breaking-changes/rules/rpc-same-request-type"
-              },
-              {
-                "title": "RPC Same Response Type",
-                "path": "/docs/guide/cli/breaking-changes/rules/rpc-same-response-type"
-              },
-              {
-                "title": "Service No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/service-no-delete"
-              }
-            ]
-          }
-        ]
-      },
-      {
-        "title": "Auto Completion",
-        "path": "/docs/guide/cli/auto-completion/auto-completion"
-      },
-      {
-        "title": "Configuration",
-        "path": "/docs/guide/cli/configuration/configuration"
-      }
-    ]
-  },
-  {
-    "title": "EasyP API Service",
-    "icon": "Server",
-    "children": [
-      {
-        "title": "Overview",
-        "path": "/docs/guide/api-service/overview"
-      }
-    ]
-  },
-  {
-    "title": "Migration",
-    "icon": "ArrowRightLeft",
-    "children": [
-      {
-        "title": "From Buf CLI",
-        "path": "/docs/guide/migration/buf-cli"
-      },
-      {
-        "title": "From Protoc",
-        "path": "/docs/guide/migration/protoc"
-      },
-      {
-        "title": "From Protolock",
-        "path": "/docs/guide/migration/protolock"
-      },
-      {
-        "title": "From Prototool",
-        "path": "/docs/guide/migration/prototool"
-      }
-    ]
-  },
-  {
-    "title": "CI/CD",
-    "icon": "Workflow",
-    "children": [
-      {
-        "title": "GitHub Actions",
-        "path": "/docs/guide/ci-cd/github-actions"
-      },
-      {
-        "title": "GitLab CI",
-        "path": "/docs/guide/ci-cd/gitlab"
-      }
-    ]
-  }
-]
\ No newline at end of file
diff --git a/docs/src/config/sidebar.ru.json b/docs/src/config/sidebar.ru.json
deleted file mode 100644
index bfea030c..00000000
--- a/docs/src/config/sidebar.ru.json
+++ /dev/null
@@ -1,349 +0,0 @@
-[
-  {
-    "title": "Введение",
-    "icon": "BookOpen",
-    "children": [
-      {
-        "title": "Что такое EasyP?",
-        "path": "/docs/guide/introduction/what-is"
-      },
-      {
-        "title": "Быстрый старт",
-        "path": "/docs/guide/introduction/quickstart"
-      },
-      {
-        "title": "Установка",
-        "path": "/docs/guide/introduction/install"
-      }
-    ]
-  },
-  {
-    "title": "CLI EasyP",
-    "icon": "Terminal",
-    "children": [
-      {
-        "title": "Linter",
-        "path": "/docs/guide/cli/linter/linter",
-        "children": [
-          {
-            "title": "Rules",
-            "children": [
-              {
-                "title": "Comment Enum Value",
-                "path": "/docs/guide/cli/linter/rules/comment-enum-value"
-              },
-              {
-                "title": "Comment Enum",
-                "path": "/docs/guide/cli/linter/rules/comment-enum"
-              },
-              {
-                "title": "Comment Field",
-                "path": "/docs/guide/cli/linter/rules/comment-field"
-              },
-              {
-                "title": "Comment Message",
-                "path": "/docs/guide/cli/linter/rules/comment-message"
-              },
-              {
-                "title": "Comment Oneof",
-                "path": "/docs/guide/cli/linter/rules/comment-oneof"
-              },
-              {
-                "title": "Comment RPC",
-                "path": "/docs/guide/cli/linter/rules/comment-rpc"
-              },
-              {
-                "title": "Comment Service",
-                "path": "/docs/guide/cli/linter/rules/comment-service"
-              },
-              {
-                "title": "Directory Same Package",
-                "path": "/docs/guide/cli/linter/rules/directory-same-package"
-              },
-              {
-                "title": "Enum First Value Zero",
-                "path": "/docs/guide/cli/linter/rules/enum-first-value-zero"
-              },
-              {
-                "title": "Enum No Allow Alias",
-                "path": "/docs/guide/cli/linter/rules/enum-no-allow-alias"
-              },
-              {
-                "title": "Enum Pascal Case",
-                "path": "/docs/guide/cli/linter/rules/enum-pascal-case"
-              },
-              {
-                "title": "Enum Value Prefix",
-                "path": "/docs/guide/cli/linter/rules/enum-value-prefix"
-              },
-              {
-                "title": "Enum Value Upper Snake Case",
-                "path": "/docs/guide/cli/linter/rules/enum-value-upper-snake-case"
-              },
-              {
-                "title": "Enum Zero Value Suffix",
-                "path": "/docs/guide/cli/linter/rules/enum-zero-value-suffix"
-              },
-              {
-                "title": "Field Lower Snake Case",
-                "path": "/docs/guide/cli/linter/rules/field-lower-snake-case"
-              },
-              {
-                "title": "File Lower Snake Case",
-                "path": "/docs/guide/cli/linter/rules/file-lower-snake-case"
-              },
-              {
-                "title": "Import No Public",
-                "path": "/docs/guide/cli/linter/rules/import-no-public"
-              },
-              {
-                "title": "Import No Weak",
-                "path": "/docs/guide/cli/linter/rules/import-no-weak"
-              },
-              {
-                "title": "Import Used",
-                "path": "/docs/guide/cli/linter/rules/import-used"
-              },
-              {
-                "title": "Message Pascal Case",
-                "path": "/docs/guide/cli/linter/rules/message-pascal-case"
-              },
-              {
-                "title": "Oneof Lower Snake Case",
-                "path": "/docs/guide/cli/linter/rules/oneof-lower-snake-case"
-              },
-              {
-                "title": "Package Defined",
-                "path": "/docs/guide/cli/linter/rules/package-defined"
-              },
-              {
-                "title": "Package Directory Match",
-                "path": "/docs/guide/cli/linter/rules/package-directory-match"
-              },
-              {
-                "title": "Package Lower Snake Case",
-                "path": "/docs/guide/cli/linter/rules/package-lower-snake-case"
-              },
-              {
-                "title": "Package Same C# Namespace",
-                "path": "/docs/guide/cli/linter/rules/package-same-csharp-namespace"
-              },
-              {
-                "title": "Package Same Directory",
-                "path": "/docs/guide/cli/linter/rules/package-same-directory"
-              },
-              {
-                "title": "Package Same Go Package",
-                "path": "/docs/guide/cli/linter/rules/package-same-go-package"
-              },
-              {
-                "title": "Package Same Java Multiple Files",
-                "path": "/docs/guide/cli/linter/rules/package-same-java-multiple-files"
-              },
-              {
-                "title": "Package Same Java Package",
-                "path": "/docs/guide/cli/linter/rules/package-same-java-package"
-              },
-              {
-                "title": "Package Same PHP Namespace",
-                "path": "/docs/guide/cli/linter/rules/package-same-php-namespace"
-              },
-              {
-                "title": "Package Same Ruby Package",
-                "path": "/docs/guide/cli/linter/rules/package-same-ruby-package"
-              },
-              {
-                "title": "Package Same Swift Prefix",
-                "path": "/docs/guide/cli/linter/rules/package-same-swift-prefix"
-              },
-              {
-                "title": "Package Version Suffix",
-                "path": "/docs/guide/cli/linter/rules/package-version-suffix"
-              },
-              {
-                "title": "RPC No Client Streaming",
-                "path": "/docs/guide/cli/linter/rules/rpc-no-client-streaming"
-              },
-              {
-                "title": "RPC No Server Streaming",
-                "path": "/docs/guide/cli/linter/rules/rpc-no-server-streaming"
-              },
-              {
-                "title": "RPC Pascal Case",
-                "path": "/docs/guide/cli/linter/rules/rpc-pascal-case"
-              },
-              {
-                "title": "RPC Request Response Unique",
-                "path": "/docs/guide/cli/linter/rules/rpc-request-response-unique"
-              },
-              {
-                "title": "RPC Request Standard Name",
-                "path": "/docs/guide/cli/linter/rules/rpc-request-standard-name"
-              },
-              {
-                "title": "RPC Response Standard Name",
-                "path": "/docs/guide/cli/linter/rules/rpc-response-standard-name"
-              },
-              {
-                "title": "Service Pascal Case",
-                "path": "/docs/guide/cli/linter/rules/service-pascal-case"
-              },
-              {
-                "title": "Service Suffix",
-                "path": "/docs/guide/cli/linter/rules/service-suffix"
-              }
-            ]
-          }
-        ]
-      },
-      {
-        "title": "Generator",
-        "path": "/docs/guide/cli/generator/generator",
-        "children": [
-          {
-            "title": "Примеры",
-            "children": [
-              {
-                "title": "Go",
-                "path": "/docs/guide/cli/generator/examples/go"
-              },
-              {
-                "title": "gRPC Gateway",
-                "path": "/docs/guide/cli/generator/examples/grpc-gateway"
-              },
-              {
-                "title": "Validate",
-                "path": "/docs/guide/cli/generator/examples/validate"
-              }
-            ]
-          }
-        ]
-      },
-      {
-        "title": "Package Manager",
-        "path": "/docs/guide/cli/package-manager/package-manager"
-      },
-      {
-        "title": "Breaking Changes",
-        "path": "/docs/guide/cli/breaking-changes/breaking-changes",
-        "children": [
-          {
-            "title": "Rules",
-            "children": [
-              {
-                "title": "Enum No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/enum-no-delete"
-              },
-              {
-                "title": "Enum Value No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/enum-value-no-delete"
-              },
-              {
-                "title": "Enum Value Same Name",
-                "path": "/docs/guide/cli/breaking-changes/rules/enum-value-same-name"
-              },
-              {
-                "title": "Field No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/field-no-delete"
-              },
-              {
-                "title": "Field Same Cardinality",
-                "path": "/docs/guide/cli/breaking-changes/rules/field-same-cardinality"
-              },
-              {
-                "title": "Field Same Type",
-                "path": "/docs/guide/cli/breaking-changes/rules/field-same-type"
-              },
-              {
-                "title": "Import No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/import-no-delete"
-              },
-              {
-                "title": "Message No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/message-no-delete"
-              },
-              {
-                "title": "Oneof Field No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/oneof-field-no-delete"
-              },
-              {
-                "title": "Oneof Field Same Type",
-                "path": "/docs/guide/cli/breaking-changes/rules/oneof-field-same-type"
-              },
-              {
-                "title": "Oneof No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/oneof-no-delete"
-              },
-              {
-                "title": "RPC No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/rpc-no-delete"
-              },
-              {
-                "title": "RPC Same Request Type",
-                "path": "/docs/guide/cli/breaking-changes/rules/rpc-same-request-type"
-              },
-              {
-                "title": "RPC Same Response Type",
-                "path": "/docs/guide/cli/breaking-changes/rules/rpc-same-response-type"
-              },
-              {
-                "title": "Service No Delete",
-                "path": "/docs/guide/cli/breaking-changes/rules/service-no-delete"
-              }
-            ]
-          }
-        ]
-      },
-      {
-        "title": "Автодополнение",
-        "path": "/docs/guide/cli/auto-completion/auto-completion"
-      },
-      {
-        "title": "Конфигурация",
-        "path": "/docs/guide/cli/configuration/configuration"
-      }
-    ]
-  },
-  {
-    "title": "EasyP API Service",
-    "icon": "Server",
-    "children": [
-      {
-        "title": "Обзор",
-        "path": "/docs/guide/api-service/overview"
-      }
-    ]
-  },
-  {
-    "title": "Migration",
-    "icon": "ArrowRightLeft",
-    "children": [
-      {
-        "title": "Buf CLI",
-        "path": "/docs/guide/migration/buf-cli"
-      },
-      {
-        "title": "Protoc",
-        "path": "/docs/guide/migration/protoc"
-      },
-      {
-        "title": "Prototool",
-        "path": "/docs/guide/migration/prototool"
-      }
-    ]
-  },
-  {
-    "title": "CI/CD",
-    "icon": "Workflow",
-    "children": [
-      {
-        "title": "GitHub Actions",
-        "path": "/docs/guide/ci-cd/github-actions"
-      },
-      {
-        "title": "GitLab CI",
-        "path": "/docs/guide/ci-cd/gitlab"
-      }
-    ]
-  }
-]
\ No newline at end of file
diff --git a/docs/src/contexts/TocContext.tsx b/docs/src/contexts/TocContext.tsx
deleted file mode 100644
index 30f42813..00000000
--- a/docs/src/contexts/TocContext.tsx
+++ /dev/null
@@ -1,34 +0,0 @@
-import { createContext, useContext, useState, ReactNode } from 'react'
-import type { TocItem } from '../lib/markdown/types'
-
-interface TocContextValue {
-    toc: TocItem[]
-    setToc: (toc: TocItem[]) => void
-    activeId: string
-    setActiveId: (id: string) => void
-}
-
-const TocContext = createContext<TocContextValue | null>(null)
-
-export function useToc() {
-    const context = useContext(TocContext)
-    return context
-}
-
-interface TocProviderProps {
-    children: ReactNode
-}
-
-export function TocProvider({ children }: TocProviderProps) {
-    const [toc, setToc] = useState<TocItem[]>([])
-    const [activeId, setActiveId] = useState<string>('')
-
-    const value: TocContextValue = {
-        toc,
-        setToc,
-        activeId,
-        setActiveId
-    }
-
-    return <TocContext.Provider value={value}>{children}</TocContext.Provider>
-}
diff --git a/docs/src/i18n/config.ts b/docs/src/i18n/config.ts
deleted file mode 100644
index 9523f0ff..00000000
--- a/docs/src/i18n/config.ts
+++ /dev/null
@@ -1,42 +0,0 @@
-import i18n from 'i18next'
-import { initReactI18next } from 'react-i18next'
-import en from './locales/en.json'
-import ru from './locales/ru.json'
-
-// Get saved language from localStorage; else infer from browser; else default to English
-const getSavedLanguage = (): string => {
-    const saved = localStorage.getItem('language')
-    if (saved) return saved
-
-    // Infer from browser preferences if available
-    const navLangs = typeof navigator !== 'undefined'
-        ? (navigator.languages || [navigator.language]).map(l => l.toLowerCase())
-        : []
-
-    if (navLangs.some(l => l === 'ru' || l.startsWith('ru-'))) {
-        return 'ru'
-    }
-
-    return 'en'
-}
-
-i18n
-    .use(initReactI18next)
-    .init({
-        resources: {
-            en: { translation: en },
-            ru: { translation: ru }
-        },
-        lng: getSavedLanguage(),
-        fallbackLng: 'en',
-        interpolation: {
-            escapeValue: false // React already escapes
-        }
-    })
-
-// Save language preference when it changes
-i18n.on('languageChanged', (lng) => {
-    localStorage.setItem('language', lng)
-})
-
-export default i18n
diff --git a/docs/src/i18n/locales/en.json b/docs/src/i18n/locales/en.json
deleted file mode 100644
index 96d344ad..00000000
--- a/docs/src/i18n/locales/en.json
+++ /dev/null
@@ -1,115 +0,0 @@
-{
-  "nav": {
-    "features": "Features",
-    "registry": "Registry",
-    "enterprise": "Enterprise",
-    "documentation": "Docs",
-    "blog": "Blog",
-    "github": "GitHub",
-    "sponsor": "Sponsor",
-    "getStarted": "Get Started"
-  },
-  "hero": {
-    "badge": {
-      "beta": "Beta",
-      "license": "Apache 2.0 License"
-    },
-    "title": "The Modern Standard for",
-    "titleHighlight": "Protobuf Workflows",
-    "subtitle": "A unified Git-native toolkit for linting, code generation, and dependency management. Fully Open Source.",
-    "exploreDocs": "Explore Documentation"
-  },
-  "docsSearch": {
-    "placeholder": "Search docs...",
-    "mobilePlaceholder": "Search documentation...",
-    "open": "Open search",
-    "close": "Close search",
-    "cancel": "Cancel",
-    "clear": "Clear search",
-    "loading": "Searching...",
-    "noResults": "No results found",
-    "showMoreMatches": "Show {{count}} more matches on this page",
-    "hideMoreMatches": "Hide additional matches",
-    "typeToSearch": "Type at least 2 characters to search",
-    "error": "Unable to load search index. Try again later."
-  },
-  "trustedBy": {
-    "title": "Trusted by engineering teams at"
-  },
-  "features": {
-    "title": "Two modes.",
-    "titleHighlight": "One platform.",
-    "subtitle": "EasyP combines a developer-friendly CLI with a powerful remote execution engine.",
-    "localDev": "Local Development",
-    "remoteInfra": "Remote Infrastructure",
-    "cli": {
-      "title": "Supercharge your workflow",
-      "description": "All tools in a single binary. Linting, formatting, and breaking change detection work instantly.",
-      "packageManager": {
-        "title": "Package Manager",
-        "desc": "Version management via easyp.lock. Like npm, but for Protobuf."
-      },
-      "linting": {
-        "title": "Instant Linting",
-        "desc": "100% compatibility with Buf rules"
-      },
-      "apiSafety": {
-        "title": "API Safety",
-        "desc": "Backward compatibility checks in CI"
-      }
-    },
-    "server": {
-      "title": "Your infrastructure, your rules",
-      "description": "Forget \"works on my machine\" problems. Centralized generation server guarantees identical results for the entire team.",
-      "dockerNative": {
-        "title": "Docker Native",
-        "desc": "Run any plugins (Java, Python, Node) in containers"
-      },
-      "airGap": {
-        "title": "Air-Gap Ready",
-        "desc": "Works in completely isolated environments"
-      },
-      "costEffective": {
-        "title": "Cost Effective",
-        "desc": "Pay for infrastructure, not per user"
-      }
-    }
-  },
-  "architecture": {
-    "title": "Why EasyP is the smarter choice",
-    "subtitle": "A fundamental shift in how you manage Protobuf infrastructure.",
-    "dataSovereignty": {
-      "title": "Data Sovereignty",
-      "description": "Unlike SaaS solutions where schemas live in the cloud, EasyP is <strong>Git-Native</strong>. Your data never leaves your secure repositories."
-    },
-    "hybridRuntime": {
-      "title": "Hybrid Runtime",
-      "description": "Don't choose between speed and compatibility. EasyP uses <strong>Wasm</strong> for speed and <strong>Docker</strong> for heavy plugins."
-    },
-    "noVendorLock": {
-      "title": "No Vendor Lock-in",
-      "description": "The entire platform is <strong>Open Source</strong> (Apache 2.0). Host the server yourself, anywhere. No per-user pricing tax."
-    }
-  },
-  "footer": {
-    "description": "The open-source standard for Protobuf workflows. Built for modern engineering teams.",
-    "product": {
-      "title": "Product",
-      "cliTool": "CLI Tool",
-      "apiService": "API Service",
-      "registry": "Registry",
-      "documentation": "Documentation",
-      "enterprise": "Enterprise"
-    },
-    "community": {
-      "title": "Community",
-      "github": "GitHub",
-      "telegram": "Telegram",
-      "youtube": "YouTube"
-    },
-    "rights": "© 2025 EasyP Tech. All rights reserved.",
-    "privacy": "Privacy",
-    "terms": "Terms",
-    "license": "Licensed under Apache 2.0"
-  }
-}
diff --git a/docs/src/i18n/locales/ru.json b/docs/src/i18n/locales/ru.json
deleted file mode 100644
index 76758a83..00000000
--- a/docs/src/i18n/locales/ru.json
+++ /dev/null
@@ -1,115 +0,0 @@
-{
-    "nav": {
-        "features": "Возможности",
-        "registry": "Registry",
-        "enterprise": "Enterprise",
-        "documentation": "Docs",
-        "blog": "Blog",
-        "github": "GitHub",
-        "sponsor": "Поддержать",
-        "getStarted": "Начать"
-    },
-    "hero": {
-        "badge": {
-            "beta": "Beta",
-            "license": "Лицензия Apache 2.0"
-        },
-        "title": "Современный стандарт для",
-        "titleHighlight": "Protobuf Workflows",
-        "subtitle": "Единый Git-native инструментарий для линтинга, генерации кода и управления зависимостями. Полностью Open Source.",
-        "exploreDocs": "Изучить документацию"
-    },
-    "docsSearch": {
-        "placeholder": "Поиск по документации...",
-        "mobilePlaceholder": "Введите запрос для поиска...",
-        "open": "Открыть поиск",
-        "close": "Закрыть поиск",
-        "cancel": "Отмена",
-        "clear": "Очистить поиск",
-        "loading": "Ищем...",
-        "noResults": "Ничего не найдено",
-        "showMoreMatches": "Показать ещё {{count}} совпадений на этой странице",
-        "hideMoreMatches": "Скрыть дополнительные совпадения",
-        "typeToSearch": "Введите минимум 2 символа",
-        "error": "Не удалось загрузить поисковый индекс. Попробуйте позже."
-    },
-    "trustedBy": {
-        "title": "Нам доверяют команды разработчиков из"
-    },
-    "features": {
-        "title": "Два режима.",
-        "titleHighlight": "Одна платформа.",
-        "subtitle": "EasyP сочетает удобный CLI для разработчиков с мощным движком удаленного выполнения.",
-        "localDev": "Локальная разработка",
-        "remoteInfra": "Удаленная инфраструктура",
-        "cli": {
-            "title": "Ускорьте свой рабочий процесс",
-            "description": "Все инструменты в одном бинарнике. Линтинг, форматирование и детекция breaking changes работают мгновенно.",
-            "packageManager": {
-                "title": "Package Manager",
-                "desc": "Управление версиями через easyp.lock. Как npm, но для Protobuf."
-            },
-            "linting": {
-                "title": "Instant Linting",
-                "desc": "100% совместимость с правилами Buf"
-            },
-            "apiSafety": {
-                "title": "API Safety",
-                "desc": "Проверка обратной совместимости в CI"
-            }
-        },
-        "server": {
-            "title": "Ваша инфраструктура, ваши правила",
-            "description": "Забудьте о проблеме \"works on my machine\". Централизованный сервер генерации гарантирует идентичный результат для всей команды.",
-            "dockerNative": {
-                "title": "Docker Native",
-                "desc": "Запуск любых плагинов (Java, Python, Node) в контейнерах"
-            },
-            "airGap": {
-                "title": "Air-Gap Ready",
-                "desc": "Работает в полностью изолированных контурах"
-            },
-            "costEffective": {
-                "title": "Cost Effective",
-                "desc": "Платите за инфраструктуру, а не за пользователей"
-            }
-        }
-    },
-    "architecture": {
-        "title": "Почему EasyP — это лучший выбор",
-        "subtitle": "Фундаментальный сдвиг в управлении Protobuf-инфраструктурой.",
-        "dataSovereignty": {
-            "title": "Суверенность данных",
-            "description": "В отличие от SaaS-решений, где схемы хранятся в облаке, EasyP является <strong>Git-Native</strong>. Ваши данные никогда не покидают безопасные репозитории."
-        },
-        "hybridRuntime": {
-            "title": "Гибридная среда выполнения",
-            "description": "Не выбирайте между скоростью и совместимостью. EasyP использует <strong>Wasm</strong> для скорости и <strong>Docker</strong> для тяжелых плагинов."
-        },
-        "noVendorLock": {
-            "title": "Без привязки к поставщику",
-            "description": "Вся платформа является <strong>Open Source</strong> (Apache 2.0). Размещайте сервер где угодно. Никакой платы за пользователя."
-        }
-    },
-    "footer": {
-        "description": "Open-source стандарт для Protobuf workflows. Создан для современных инженерных команд.",
-        "product": {
-            "title": "Продукты",
-            "cliTool": "CLI Tool",
-            "apiService": "API Service",
-            "registry": "Registry",
-            "documentation": "Документация",
-            "enterprise": "Enterprise"
-        },
-        "community": {
-            "title": "Сообщество",
-            "github": "GitHub",
-            "telegram": "Telegram",
-            "youtube": "YouTube"
-        },
-        "rights": "© 2025 EasyP Tech. Все права защищены.",
-        "privacy": "Конфиденциальность",
-        "terms": "Условия",
-        "license": "Лицензия Apache 2.0"
-    }
-}
diff --git a/docs/src/index.css b/docs/src/index.css
deleted file mode 100644
index f712a50f..00000000
--- a/docs/src/index.css
+++ /dev/null
@@ -1,777 +0,0 @@
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
-
-body {
-    background-color: #020617;
-    color: #e2e8f0;
-    margin: 0;
-    padding: 0;
-}
-
-/* Smooth Gradients */
-.bg-glow-gradient {
-    background: radial-gradient(circle at center, rgba(59, 130, 246, 0.15) 0%, transparent 70%);
-}
-
-.text-gradient {
-    background: linear-gradient(to right, #60a5fa, #a78bfa);
-    -webkit-background-clip: text;
-    -webkit-text-fill-color: transparent;
-    background-clip: text;
-}
-
-/* Glassmorphism */
-.glass-panel {
-    background: rgba(15, 23, 42, 0.6);
-    backdrop-filter: blur(12px);
-    border: 1px solid rgba(255, 255, 255, 0.08);
-}
-
-/* Custom Scrollbar */
-::-webkit-scrollbar {
-    width: 8px;
-}
-
-::-webkit-scrollbar-track {
-    background: #020617;
-}
-
-::-webkit-scrollbar-thumb {
-    background: #334155;
-    border-radius: 4px;
-}
-
-::-webkit-scrollbar-thumb:hover {
-    background: #475569;
-}
-
-/* Hide scrollbar for command display */
-.no-scrollbar::-webkit-scrollbar {
-    display: none;
-}
-
-.no-scrollbar {
-    -ms-overflow-style: none;
-    scrollbar-width: none;
-}
-
-@keyframes marquee {
-    0% {
-        transform: translateX(0);
-    }
-
-    100% {
-        transform: translateX(-25%);
-    }
-}
-
-.animate-marquee {
-    animation: marquee 40s linear infinite;
-}
-
-/* Documentation Layout */
-.docs-layout {
-    display: grid;
-    grid-template-columns: 280px 1fr 280px;
-    /* sidebar | content | toc */
-    gap: 2rem;
-    min-height: 100vh;
-}
-
-/* Main content с max-width для читаемости */
-.docs-main {
-    max-width: 900px;
-    margin: 0 auto;
-    width: 100%;
-    overflow-y: auto;
-}
-
-/* TOC Container - скрыт на планшетах и меньше */
-.docs-toc-container {
-    display: block;
-}
-
-@media (max-width: 1200px) {
-    .docs-layout {
-        grid-template-columns: 280px 1fr;
-        /* hide TOC */
-    }
-
-    .docs-toc-container {
-        display: none;
-    }
-}
-
-@media (max-width: 768px) {
-    .docs-layout {
-        grid-template-columns: 1fr;
-    }
-}
-
-/* Documentation Sidebar */
-.docs-sidebar {
-    background: rgba(15, 23, 42, 0.6);
-    backdrop-filter: blur(12px);
-    border-right: 1px solid rgba(255, 255, 255, 0.08);
-    position: sticky;
-    top: 0;
-    height: 100vh;
-    overflow-y: auto;
-}
-
-@media (max-width: 768px) {
-    .docs-sidebar {
-        position: fixed;
-        left: 0;
-        top: 0;
-        width: 280px;
-        z-index: 50;
-        display: block;
-        transform: translateX(-100%);
-        transition: transform 0.3s ease;
-    }
-
-    .docs-sidebar--open {
-        display: block;
-        transform: translateX(0);
-    }
-}
-
-.docs-sidebar-header {
-    padding: 1.5rem;
-    border-bottom: 1px solid rgba(255, 255, 255, 0.08);
-    display: flex;
-    justify-content: space-between;
-    align-items: center;
-}
-
-.docs-sidebar-toggle {
-    background: none;
-    border: none;
-    color: #e2e8f0;
-    cursor: pointer;
-    padding: 0.5rem;
-    border-radius: 0.375rem;
-    transition: background-color 0.2s;
-}
-
-.docs-sidebar-toggle:hover {
-    background-color: rgba(255, 255, 255, 0.05);
-}
-
-.docs-sidebar-nav {
-    padding: 1rem;
-}
-
-/* Documentation Main Content */
-.docs-main {
-    overflow-y: auto;
-}
-
-.docs-content {
-    max-width: 1200px;
-    margin: 0 auto;
-    padding: 2rem;
-}
-
-@media (max-width: 768px) {
-    .docs-content {
-        padding: 1rem;
-    }
-}
-
-/* Markdown Page Specific */
-.markdown-page {
-    animation: fadeIn 0.3s ease-in-out;
-}
-
-@keyframes fadeIn {
-    from {
-        opacity: 0;
-        transform: translateY(10px);
-    }
-
-    to {
-        opacity: 1;
-        transform: translateY(0);
-    }
-}
-
-/* Sidebar Navigation Styles */
-
-/* Mobile Header */
-.docs-mobile-header {
-    display: flex;
-    align-items: center;
-    gap: 1rem;
-    padding: 1rem;
-    border-bottom: 1px solid rgba(255, 255, 255, 0.08);
-    background: rgba(15, 23, 42, 0.6);
-    backdrop-filter: blur(12px);
-    position: sticky;
-    top: 0;
-    z-index: 10;
-}
-
-/* Sidebar Toggle Button */
-.docs-sidebar-toggle {
-    background: none;
-    border: none;
-    color: #e2e8f0;
-    cursor: pointer;
-    padding: 0.5rem;
-    border-radius: 0.375rem;
-    transition: background-color 0.2s;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-}
-
-.docs-sidebar-toggle:hover {
-    background-color: rgba(255, 255, 255, 0.05);
-}
-
-/* Sidebar Backdrop */
-.docs-sidebar-backdrop {
-    position: fixed;
-    inset: 0;
-    background: rgba(0, 0, 0, 0.5);
-    z-index: 40;
-    animation: fadeIn 0.2s ease;
-}
-
-@media (min-width: 769px) {
-    .docs-sidebar-backdrop {
-        display: none;
-    }
-}
-
-/* Sidebar Items */
-.sidebar-item-wrapper {
-    margin: 0;
-}
-
-.sidebar-item {
-    transition: background-color 0.2s, border-color 0.2s;
-}
-
-.sidebar-item__content {
-    display: flex;
-    align-items: center;
-    gap: 0.75rem;
-    padding: 0.625rem 1rem;
-    position: relative;
-}
-
-.sidebar-item__icon {
-    flex-shrink: 0;
-    color: #94a3b8;
-}
-
-.sidebar-item__link,
-.sidebar-item__text {
-    flex: 1;
-    font-size: 0.875rem;
-    color: #cbd5e1;
-    text-decoration: none;
-    transition: color 0.2s;
-    display: block;
-}
-
-.sidebar-item__link:hover {
-    color: #e2e8f0;
-}
-
-.sidebar-item__text {
-    font-weight: 500;
-    color: #94a3b8;
-}
-
-.sidebar-item__toggle {
-    background: none;
-    border: none;
-    color: #64748b;
-    cursor: pointer;
-    padding: 0.25rem;
-    display: flex;
-    align-items: center;
-    transition: color 0.2s;
-    flex-shrink: 0;
-}
-
-.sidebar-item__toggle:hover {
-    color: #94a3b8;
-}
-
-/* Active state */
-.sidebar-item--active .sidebar-item__content {
-    background: rgba(59, 130, 246, 0.1);
-    border-left: 3px solid #3b82f6;
-    padding-left: calc(1rem - 3px);
-}
-
-.sidebar-item--active .sidebar-item__link {
-    color: #60a5fa;
-    font-weight: 500;
-}
-
-.sidebar-item--active .sidebar-item__icon {
-    color: #60a5fa;
-}
-
-/* Hover state */
-.sidebar-item:not(.sidebar-item--active):hover .sidebar-item__content {
-    background: rgba(255, 255, 255, 0.03);
-}
-
-/* Nested levels indentation */
-.sidebar-item--level-0 .sidebar-item__content {
-    padding-left: 1rem;
-}
-
-.sidebar-item--level-1 .sidebar-item__content {
-    padding-left: 2rem;
-}
-
-.sidebar-item--level-2 .sidebar-item__content {
-    padding-left: 3rem;
-}
-
-.sidebar-item--level-3 .sidebar-item__content {
-    padding-left: 4rem;
-}
-
-/* Active state indentation adjustment */
-.sidebar-item--active.sidebar-item--level-0 .sidebar-item__content {
-    padding-left: calc(1rem - 3px);
-}
-
-.sidebar-item--active.sidebar-item--level-1 .sidebar-item__content {
-    padding-left: calc(2rem - 3px);
-}
-
-.sidebar-item--active.sidebar-item--level-2 .sidebar-item__content {
-    padding-left: calc(3rem - 3px);
-}
-
-.sidebar-item--active.sidebar-item--level-3 .sidebar-item__content {
-    padding-left: calc(4rem - 3px);
-}
-
-/* Parent items */
-.sidebar-item--parent .sidebar-item__text,
-.sidebar-item--parent .sidebar-item__link {
-    font-weight: 500;
-}
-
-/* Children container */
-.sidebar-children {
-    max-height: 0;
-    overflow: hidden;
-    transition: max-height 0.3s ease;
-}
-
-.sidebar-children--expanded {
-    max-height: 2000px;
-    /* Large enough for content */
-}
-
-/* Mermaid Diagram Styles */
-.mermaid-container svg {
-    max-width: 100%;
-    height: auto;
-    background: transparent !important;
-}
-
-/* Mermaid node styling to match EasyP theme */
-.mermaid-container .node rect,
-.mermaid-container .node circle,
-.mermaid-container .node ellipse,
-.mermaid-container .node polygon {
-    fill: #1e293b !important;
-    stroke: #60a5fa !important;
-    stroke-width: 2px !important;
-}
-
-.mermaid-container .node .label,
-.mermaid-container .nodeLabel,
-.mermaid-container text {
-    fill: #e2e8f0 !important;
-    color: #e2e8f0 !important;
-    font-family: 'Inter', sans-serif !important;
-    font-size: 14px !important;
-}
-
-/* Mermaid edge styling */
-.mermaid-container .edgePath path {
-    stroke: #334155 !important;
-    stroke-width: 2px !important;
-}
-
-.mermaid-container .edgeLabel {
-    background-color: #0f172a !important;
-    color: #e2e8f0 !important;
-    border: 1px solid #334155 !important;
-    border-radius: 4px !important;
-    padding: 4px 8px !important;
-}
-
-/* Mermaid flowchart specific styles */
-.mermaid-container .flowchart-link {
-    stroke: #334155 !important;
-    stroke-width: 2px !important;
-}
-
-/* Mermaid sequence diagram styles */
-.mermaid-container .actor {
-    fill: #1e293b !important;
-    stroke: #60a5fa !important;
-    stroke-width: 2px !important;
-}
-
-.mermaid-container .actor-line {
-    stroke: #334155 !important;
-    stroke-width: 1px !important;
-    stroke-dasharray: 5, 5 !important;
-}
-
-.mermaid-container .messageLine0,
-.mermaid-container .messageLine1 {
-    stroke: #e2e8f0 !important;
-    stroke-width: 2px !important;
-}
-
-.mermaid-container .messageText {
-    fill: #e2e8f0 !important;
-    font-family: 'Inter', sans-serif !important;
-}
-
-/* Mermaid note styling */
-.mermaid-container .note {
-    fill: #0f172a !important;
-    stroke: #8b5cf6 !important;
-    stroke-width: 2px !important;
-}
-
-/* Mermaid gantt chart styles */
-.mermaid-container .section0,
-.mermaid-container .section1,
-.mermaid-container .section2,
-.mermaid-container .section3 {
-    fill: #1e293b !important;
-}
-
-.mermaid-container .task0,
-.mermaid-container .task1,
-.mermaid-container .task2,
-.mermaid-container .task3 {
-    fill: #3b82f6 !important;
-    stroke: #60a5fa !important;
-}
-
-.mermaid-container .active0,
-.mermaid-container .active1,
-.mermaid-container .active2,
-.mermaid-container .active3 {
-    fill: #8b5cf6 !important;
-    stroke: #a78bfa !important;
-}
-
-/* Mermaid git graph styles */
-.mermaid-container .commit-id,
-.mermaid-container .commit-msg {
-    fill: #e2e8f0 !important;
-    font-family: 'Inter', sans-serif !important;
-}
-
-/* Mermaid class diagram styles */
-.mermaid-container .classBox {
-    fill: #1e293b !important;
-    stroke: #60a5fa !important;
-    stroke-width: 2px !important;
-}
-
-.mermaid-container .classText {
-    fill: #e2e8f0 !important;
-    font-family: 'JetBrains Mono', monospace !important;
-}
-
-/* Mermaid state diagram styles */
-.mermaid-container .state-start circle,
-.mermaid-container .state-end circle {
-    fill: #3b82f6 !important;
-    stroke: #60a5fa !important;
-    stroke-width: 2px !important;
-}
-
-.mermaid-container .stateBox {
-    fill: #1e293b !important;
-    stroke: #60a5fa !important;
-    stroke-width: 2px !important;
-}
-
-/* Mermaid journey diagram styles */
-.mermaid-container .journey-section {
-    fill: #1e293b !important;
-}
-
-.mermaid-container .journey-task {
-    fill: #3b82f6 !important;
-    stroke: #60a5fa !important;
-}
-
-/* Hover effects for interactive elements */
-.mermaid-container .node:hover rect,
-.mermaid-container .node:hover circle,
-.mermaid-container .node:hover ellipse,
-.mermaid-container .node:hover polygon {
-    fill: #334155 !important;
-    stroke: #3b82f6 !important;
-    stroke-width: 3px !important;
-    transition: all 0.2s ease-in-out;
-}
-
-/* Ensure text remains readable on hover */
-.mermaid-container .node:hover .label,
-.mermaid-container .node:hover .nodeLabel {
-    fill: #ffffff !important;
-}
-
-/* Docs Search */
-.docs-search-desktop {
-    width: min(360px, 100%);
-}
-
-.docs-search-input-wrapper {
-    position: relative;
-}
-
-.docs-search-input-wrapper--mobile {
-    flex: 1;
-}
-
-.docs-search-input-icon {
-    position: absolute;
-    left: 0.75rem;
-    top: 50%;
-    transform: translateY(-50%);
-    width: 1rem;
-    height: 1rem;
-    color: #94a3b8;
-    pointer-events: none;
-}
-
-.docs-search-input {
-    width: 100%;
-    height: 2.3rem;
-    border-radius: 0.65rem;
-    border: 1px solid rgba(148, 163, 184, 0.35);
-    background: rgba(15, 23, 42, 0.72);
-    color: #f8fafc;
-    font-size: 0.875rem;
-    padding: 0 2.2rem 0 2.25rem;
-    transition: border-color 0.2s ease, box-shadow 0.2s ease;
-}
-
-.docs-search-input::placeholder {
-    color: #94a3b8;
-}
-
-.docs-search-input:focus {
-    outline: none;
-    border-color: #60a5fa;
-    box-shadow: 0 0 0 3px rgba(96, 165, 250, 0.2);
-}
-
-.docs-search-clear {
-    position: absolute;
-    right: 0.45rem;
-    top: 50%;
-    transform: translateY(-50%);
-    border: none;
-    background: transparent;
-    color: #94a3b8;
-    cursor: pointer;
-    width: 1.6rem;
-    height: 1.6rem;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    border-radius: 0.35rem;
-}
-
-.docs-search-clear:hover {
-    color: #e2e8f0;
-    background: rgba(148, 163, 184, 0.15);
-}
-
-.docs-search-dropdown {
-    position: absolute;
-    top: calc(100% + 0.5rem);
-    left: 0;
-    right: 0;
-    border: 1px solid rgba(148, 163, 184, 0.3);
-    background: rgba(2, 6, 23, 0.98);
-    border-radius: 0.8rem;
-    box-shadow: 0 18px 42px rgba(2, 6, 23, 0.45);
-    max-height: 22rem;
-    overflow: auto;
-    z-index: 45;
-}
-
-.docs-search-state {
-    padding: 0.9rem 1rem;
-    font-size: 0.875rem;
-    color: #94a3b8;
-}
-
-.docs-search-state--loading {
-    display: flex;
-    align-items: center;
-    gap: 0.5rem;
-}
-
-.docs-search-state--error {
-    color: #fda4af;
-}
-
-.docs-search-results-list {
-    list-style: none;
-    margin: 0;
-    padding: 0.35rem;
-}
-
-.docs-search-result-item {
-    width: 100%;
-    text-align: left;
-    border: none;
-    border-radius: 0.6rem;
-    background: transparent;
-    color: inherit;
-    cursor: pointer;
-    padding: 0.62rem 0.7rem;
-    display: flex;
-    flex-direction: column;
-    gap: 0.2rem;
-}
-
-.docs-search-result-item:hover {
-    background: rgba(30, 41, 59, 0.85);
-}
-
-.docs-search-result-item--nested {
-    margin-top: 0.25rem;
-    border: 1px solid rgba(148, 163, 184, 0.16);
-    background: rgba(15, 23, 42, 0.55);
-}
-
-.docs-search-result-title {
-    font-size: 0.86rem;
-    font-weight: 600;
-    color: #e2e8f0;
-}
-
-.docs-search-result-section {
-    font-size: 0.76rem;
-    font-weight: 500;
-    color: #93c5fd;
-    line-height: 1.25;
-}
-
-.docs-search-result-excerpt {
-    font-size: 0.74rem;
-    color: #94a3b8;
-    line-height: 1.3;
-}
-
-.docs-search-more-wrapper {
-    padding: 0 0.7rem 0.6rem 0.7rem;
-}
-
-.docs-search-more-toggle {
-    border: none;
-    background: transparent;
-    color: #60a5fa;
-    font-size: 0.75rem;
-    font-weight: 600;
-    cursor: pointer;
-    padding: 0.15rem 0;
-}
-
-.docs-search-more-toggle:hover {
-    color: #93c5fd;
-}
-
-.docs-search-more-list {
-    list-style: none;
-    margin: 0.25rem 0 0;
-    padding: 0;
-}
-
-.docs-search-mobile-trigger {
-    border: 1px solid rgba(148, 163, 184, 0.35);
-    background: rgba(15, 23, 42, 0.72);
-    color: #f8fafc;
-    width: 2.35rem;
-    height: 2.35rem;
-    border-radius: 0.7rem;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-}
-
-.docs-search-mobile-overlay {
-    position: fixed;
-    inset: 0;
-    z-index: 70;
-}
-
-.docs-search-mobile-backdrop {
-    position: absolute;
-    inset: 0;
-    border: 0;
-    background: rgba(2, 6, 23, 0.62);
-}
-
-.docs-search-mobile-sheet {
-    position: absolute;
-    top: 0;
-    left: 0;
-    right: 0;
-    border-bottom-left-radius: 1rem;
-    border-bottom-right-radius: 1rem;
-    border: 1px solid rgba(148, 163, 184, 0.25);
-    background: #020617;
-    box-shadow: 0 18px 42px rgba(2, 6, 23, 0.5);
-}
-
-.docs-search-mobile-top {
-    display: flex;
-    align-items: center;
-    gap: 0.7rem;
-    padding: 0.75rem 0.85rem;
-    border-bottom: 1px solid rgba(148, 163, 184, 0.2);
-}
-
-.docs-search-mobile-close {
-    border: none;
-    background: transparent;
-    color: #cbd5e1;
-    font-size: 0.85rem;
-    font-weight: 500;
-    padding: 0.3rem;
-}
-
-.docs-search-mobile-results {
-    max-height: calc(100vh - 6rem);
-    overflow: auto;
-    padding: 0.3rem;
-}
-
-.docs-search-hit {
-    background: rgba(250, 204, 21, 0.45);
-    color: #f8fafc;
-    padding: 0 0.1rem;
-    border-radius: 0.2rem;
-}
diff --git a/docs/src/lib/markdown/ExampleUsage.tsx b/docs/src/lib/markdown/ExampleUsage.tsx
deleted file mode 100644
index 15a738e1..00000000
--- a/docs/src/lib/markdown/ExampleUsage.tsx
+++ /dev/null
@@ -1,212 +0,0 @@
-import { useState } from 'react';
-import { MarkdownContent } from './index';
-import type { MarkdownProcessorOptions } from './types';
-
-// Example markdown content
-const exampleMarkdown = `---
-title: "Example Document"
-description: "Testing the markdown library"
----
-
-# Example Document
-
-[[toc]]
-
-This is a test document to demonstrate the markdown library features.
-
-<div class="tip custom-block">
-
-**Tip**: This is a custom tip block that shows how HTML content works in markdown.
-
-</div>
-
-## Code Example
-
-Here's some JavaScript code with focus:
-
-\`\`\`javascript
-function example() {
-    const message = "Hello World"; // [!code focus]
-    console.log(message); // [!code focus]
-    return message;
-}
-\`\`\`
-
-## Links
-
-- [Internal link](./other-page.md)
-- [External link](https://github.com/easyp-tech/easyp)
-- [Anchor link](#code-example)
-
-## More Sections
-
-### Subsection 1
-
-Some content here.
-
-### Subsection 2
-
-More content here.
-
-<div class="warning custom-block">
-
-**Warning**: This is a warning block example.
-
-</div>
-`;
-
-export function ExampleUsage() {
-  const [options, setOptions] = useState<MarkdownProcessorOptions>({
-    enableToc: true,
-    enableCodeFocus: true,
-    enableHtmlBlocks: true,
-    enableLinkProcessing: true,
-    tocDepth: { min: 2, max: 4 },
-    baseUrl: '/docs'
-  });
-
-  const [content, setContent] = useState(exampleMarkdown);
-
-  const toggleOption = (key: keyof MarkdownProcessorOptions) => {
-    setOptions(prev => ({
-      ...prev,
-      [key]: !prev[key]
-    }));
-  };
-
-  return (
-    <div className="example-usage">
-      <div className="controls">
-        <h2>Markdown Library Demo</h2>
-
-        <div className="options">
-          <h3>Options</h3>
-
-          <label>
-            <input
-              type="checkbox"
-              checked={options.enableToc}
-              onChange={() => toggleOption('enableToc')}
-            />
-            Enable Table of Contents
-          </label>
-
-          <label>
-            <input
-              type="checkbox"
-              checked={options.enableCodeFocus}
-              onChange={() => toggleOption('enableCodeFocus')}
-            />
-            Enable Code Focus
-          </label>
-
-          <label>
-            <input
-              type="checkbox"
-              checked={options.enableHtmlBlocks}
-              onChange={() => toggleOption('enableHtmlBlocks')}
-            />
-            Enable HTML Blocks
-          </label>
-
-          <label>
-            <input
-              type="checkbox"
-              checked={options.enableLinkProcessing}
-              onChange={() => toggleOption('enableLinkProcessing')}
-            />
-            Enable Link Processing
-          </label>
-        </div>
-
-        <div className="editor">
-          <h3>Edit Markdown</h3>
-          <textarea
-            value={content}
-            onChange={(e) => setContent(e.target.value)}
-            rows={15}
-            cols={80}
-            style={{
-              fontFamily: 'monospace',
-              width: '100%',
-              padding: '8px',
-              border: '1px solid #ccc',
-              borderRadius: '4px'
-            }}
-          />
-        </div>
-      </div>
-
-      <div className="preview">
-        <h3>Preview</h3>
-        <div className="markdown-preview">
-          <MarkdownContent
-            content={content}
-            options={options}
-            className="example-content"
-          />
-        </div>
-      </div>
-
-      <style>{`
-        .example-usage {
-          display: grid;
-          grid-template-columns: 1fr 1fr;
-          gap: 20px;
-          max-width: 1400px;
-          margin: 0 auto;
-          padding: 20px;
-        }
-
-        .controls {
-          border: 1px solid #e0e0e0;
-          border-radius: 8px;
-          padding: 20px;
-          background: #f9f9f9;
-        }
-
-        .options {
-          margin-bottom: 20px;
-        }
-
-        .options label {
-          display: block;
-          margin-bottom: 8px;
-          cursor: pointer;
-        }
-
-        .options input {
-          margin-right: 8px;
-        }
-
-        .preview {
-          border: 1px solid #e0e0e0;
-          border-radius: 8px;
-          padding: 20px;
-          background: white;
-        }
-
-        .markdown-preview {
-          max-height: 600px;
-          overflow-y: auto;
-          border: 1px solid #eee;
-          padding: 20px;
-          border-radius: 4px;
-        }
-
-        h2, h3 {
-          margin-top: 0;
-          color: #333;
-        }
-
-        @media (max-width: 768px) {
-          .example-usage {
-            grid-template-columns: 1fr;
-          }
-        }
-      `}</style>
-    </div>
-  );
-}
-
-export default ExampleUsage;
diff --git a/docs/src/lib/markdown/README.md b/docs/src/lib/markdown/README.md
deleted file mode 100644
index 43fa2f36..00000000
--- a/docs/src/lib/markdown/README.md
+++ /dev/null
@@ -1,400 +0,0 @@
-# EasyP Markdown Library
-
-A comprehensive React-based markdown processing library with advanced features for documentation sites.
-
-## Features
-
-- 🔗 **Table of Contents** - Automatic generation from headings with `[[toc]]` placeholder
-- 🎯 **Code Focus** - Highlight specific lines using `// [!code focus]` comments
-- 📦 **Custom HTML Blocks** - Support for tip, warning, danger, and details blocks
-- 🔗 **Link Processing** - Smart handling of internal/external links with React Router integration
-- ⚡ **React Integration** - Built for React with TypeScript support
-- 🎨 **Customizable Styling** - CSS classes for complete style control
-
-## Installation
-
-```bash
-# The library is part of the EasyP docs project
-# No separate installation needed
-```
-
-## Quick Start
-
-```tsx
-import { MarkdownContent } from '@/lib/markdown';
-
-function MyDocPage() {
-  const markdownContent = `
-# My Document
-
-[[toc]]
-
-## Introduction
-
-This is a sample document with various features.
-
-<div class="tip custom-block">
-**Tip**: This is a helpful tip!
-</div>
-
-## Code Example
-
-\`\`\`javascript
-function example() {
-    console.log("Hello"); // [!code focus]
-    return "world"; // [!code focus]
-}
-\`\`\`
-  `;
-
-  return (
-    <MarkdownContent
-      content={markdownContent}
-      options={{
-        enableToc: true,
-        enableCodeFocus: true,
-        enableHtmlBlocks: true,
-        enableLinkProcessing: true
-      }}
-    />
-  );
-}
-```
-
-## Configuration
-
-### MarkdownProcessorOptions
-
-```typescript
-interface MarkdownProcessorOptions {
-  enableToc?: boolean;           // Enable TOC generation (default: true)
-  enableCodeFocus?: boolean;     // Enable code focus (default: true)
-  enableHtmlBlocks?: boolean;    // Enable custom blocks (default: true)
-  enableLinkProcessing?: boolean; // Enable link processing (default: true)
-  baseUrl?: string;              // Base URL for relative links
-  className?: string;            // Additional CSS class
-  tocDepth?: {                   // TOC depth configuration
-    min: number;                 // Minimum heading level (default: 2)
-    max: number;                 // Maximum heading level (default: 4)
-  };
-}
-```
-
-## Features Guide
-
-### Table of Contents
-
-Add `[[toc]]` anywhere in your markdown to generate an automatic table of contents:
-
-```markdown
-# My Document
-
-[[toc]]
-
-## Section 1
-### Subsection 1.1
-### Subsection 1.2
-
-## Section 2
-```
-
-Configure TOC depth:
-
-```tsx
-<MarkdownContent
-  content={content}
-  options={{
-    tocDepth: { min: 2, max: 4 } // Include h2, h3, h4
-  }}
-/>
-```
-
-### Code Focus
-
-Highlight specific lines in code blocks using `[!code focus]` comments:
-
-```markdown
-\`\`\`javascript
-function example() {
-    const setup = "preliminary"; 
-    const result = process(); // [!code focus]
-    return result; // [!code focus]
-}
-\`\`\`
-```
-
-Supports multiple comment styles:
-- `// [!code focus]` (JavaScript, C++, etc.)
-- `# [!code focus]` (Python, Shell, etc.)  
-- `<!-- [!code focus] -->` (HTML, XML)
-- `/* [!code focus] */` (CSS, multiline)
-
-### Custom HTML Blocks
-
-Create informational blocks using HTML divs:
-
-```markdown
-<div class="tip custom-block">
-**Tip**: This is helpful information!
-</div>
-
-<div class="warning custom-block">
-**Warning**: Be careful with this!
-</div>
-
-<div class="danger custom-block">
-**Danger**: This could be harmful!
-</div>
-
-<div class="details custom-block">
-**Details**: Additional information here.
-</div>
-```
-
-### Link Processing
-
-Links are automatically processed for React Router navigation:
-
-```markdown
-- [Internal link](./other-page.md) → Converted to React Router navigation
-- [External link](https://example.com) → Opens in new tab with icon
-- [Anchor link](#section) → Smooth scrolling to section
-```
-
-## Components
-
-### MarkdownContent
-
-Main component for rendering markdown content:
-
-```tsx
-<MarkdownContent
-  content={markdownString}
-  options={processingOptions}
-  className="custom-styles"
-/>
-```
-
-### TableOfContents
-
-Standalone TOC component:
-
-```tsx
-import { TableOfContents, generateToc } from '@/lib/markdown';
-
-const toc = generateToc(markdownContent);
-
-<TableOfContents
-  toc={toc}
-  title="On This Page"
-  activeId={activeHeadingId}
-/>
-```
-
-### CodeBlock
-
-Standalone code block component:
-
-```tsx
-import { CodeBlock } from '@/lib/markdown';
-
-<CodeBlock
-  language="javascript"
-  hasFocus={true}
-  focusLines={[2, 3]}
->
-{`function example() {
-  console.log("hello");
-  return "world";
-}`}
-</CodeBlock>
-```
-
-### CustomBlock
-
-Standalone custom block component:
-
-```tsx
-import { CustomBlock } from '@/lib/markdown';
-
-<CustomBlock type="tip" title="Pro Tip">
-  This is a helpful tip!
-</CustomBlock>
-```
-
-## Utilities
-
-### Processing Functions
-
-```tsx
-import { 
-  processMarkdown, 
-  validateMarkdown, 
-  extractMarkdownMetadata 
-} from '@/lib/markdown';
-
-// Process markdown
-const result = processMarkdown(content, options);
-// { content: ReactNode, toc: TocItem[], frontmatter: object }
-
-// Validate markdown
-const validation = validateMarkdown(content);
-// { isValid: boolean, errors: string[], warnings: string[] }
-
-// Extract metadata
-const metadata = extractMarkdownMetadata(content);
-// { frontmatter, headingCount, wordCount, readingTime, ... }
-```
-
-### Path Utilities
-
-```tsx
-import { 
-  isExternalUrl, 
-  resolveMarkdownPath,
-  filePathToUrlPath 
-} from '@/lib/markdown';
-
-isExternalUrl('https://example.com'); // true
-resolveMarkdownPath('./doc.md', '/current/path'); // '/current/doc'
-filePathToUrlPath('guide/intro.md'); // '/guide/intro'
-```
-
-## Styling
-
-### CSS Classes
-
-The library generates semantic CSS classes for styling:
-
-```css
-/* Content containers */
-.markdown-content
-.markdown-content--with-toc
-.markdown-body
-
-/* Headings */
-.markdown-heading
-.markdown-heading--level-{1-6}
-.markdown-heading--with-anchor
-.heading-anchor
-
-/* Table of Contents */
-.toc-container
-.toc-title
-.toc-list
-.toc-item
-.toc-item--level-{2-4}
-.toc-link
-.toc-link--active
-
-/* Code blocks */
-.code-block
-.code-block--with-focus
-.code-pre
-.code-line
-.line-focus
-.line-dimmed
-.inline-code
-
-/* Custom blocks */
-.custom-block
-.custom-block--{tip|warning|danger|details}
-.custom-block__header
-.custom-block__icon
-.custom-block__title
-.custom-block__content
-
-/* Links */
-.markdown-link
-.markdown-link--{external|internal|anchor}
-.external-link-icon
-```
-
-### Import Styles
-
-```tsx
-import '@/lib/markdown/styles.css';
-```
-
-Or customize with your own CSS using the provided classes.
-
-## Advanced Usage
-
-### Custom Processor
-
-```tsx
-import { MarkdownProcessor } from '@/lib/markdown';
-
-const processor = new MarkdownProcessor({
-  enableToc: true,
-  enableCodeFocus: true,
-  tocDepth: { min: 1, max: 6 }
-});
-
-const result = processor.process(markdownContent);
-```
-
-### Frontmatter Support
-
-```markdown
----
-title: "My Document"
-description: "A great document"
-toc: true
----
-
-# My Document
-
-Content here...
-```
-
-```tsx
-const { frontmatter, content, toc } = processMarkdown(markdown);
-// frontmatter.title === "My Document"
-```
-
-### React Router Integration
-
-Set up navigation helper:
-
-```tsx
-// In your app root
-window.routerNavigate = navigate; // from useNavigate()
-```
-
-Links in markdown will automatically use React Router navigation.
-
-## Browser Support
-
-- Chrome/Edge 88+
-- Firefox 85+
-- Safari 14+
-
-## TypeScript
-
-Full TypeScript support with exported types:
-
-```tsx
-import type {
-  MarkdownProcessorOptions,
-  ProcessedMarkdown,
-  TocItem,
-  CodeBlockProps,
-  CustomBlockProps
-} from '@/lib/markdown';
-```
-
-## Performance
-
-- Efficient processing with memoized results
-- Lazy loading for large documents
-- Optimized re-renders with React hooks
-- Syntax highlighting via Prism (code splitting supported)
-
-## Contributing
-
-The library is part of the EasyP project. See the main repository for contribution guidelines.
-
-## License
-
-MIT License - see the main EasyP project for details.
\ No newline at end of file
diff --git a/docs/src/lib/markdown/components/CodeBlock.tsx b/docs/src/lib/markdown/components/CodeBlock.tsx
deleted file mode 100644
index 353b31df..00000000
--- a/docs/src/lib/markdown/components/CodeBlock.tsx
+++ /dev/null
@@ -1,578 +0,0 @@
-import React, { useState, useEffect } from 'react';
-import { Highlight } from 'prism-react-renderer';
-import Prism from 'prismjs';
-import { Copy, Check, Terminal } from 'lucide-react';
-import type { CodeBlockProps } from '../types';
-import { cyberTheme } from '../utils/prismTheme';
-
-// Prevent Prism from automatically highlighting everything immediately
-if (typeof window !== 'undefined') {
-  (window as any).Prism = Prism;
-}
-Prism.manual = true;
-
-// Singleton promise to ensure we only load languages once
-let prismInitPromise: Promise<void> | null = null;
-let prismReady = false;
-
-// Try to load languages synchronously if possible
-const initPrismSync = () => {
-  if (typeof window === 'undefined') return false;
-
-  try {
-    (window as any).Prism = Prism;
-    Prism.manual = true;
-
-    // Try synchronous registration for common languages
-    if (!Prism.languages.yaml) {
-      // Basic YAML highlighting patterns
-      Prism.languages.yaml = {
-        'scalar': {
-          pattern: /([^\s\x00-\x08\x0E-\x1F",[\]{}]|'(?:[^']|'')*'|"(?:\\.|[^\\"])*")(?:\s*(?:$|#))/,
-          lookbehind: true,
-          alias: 'string'
-        },
-        'comment': /#.*/,
-        'key': {
-          pattern: /(\s*(?:^|[:\-?\s])\s*)[^\s\x00-\x08\x0E-\x1F,[\]{}][^\s\x00-\x08\x0E-\x1F",[\]{}]*(?:\s+[^\s\x00-\x08\x0E-\x1F",[\]{}][^\s\x00-\x08\x0E-\x1F",[\]{}]*)*\s*(?=\s*:)/,
-          lookbehind: true,
-          alias: 'property'
-        },
-        'directive': {
-          pattern: /^%\w.*$/m,
-          alias: 'important'
-        },
-        'datetime': {
-          pattern: /([:\-?\s]\s*)([0-9]{4}-[0-9]{1,2}-[0-9]{1,2}([Tt ][0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}(\.[0-9]+)?([ ]?[+-][0-9]{1,2}:[0-9]{1,2}|Z)?)?)/,
-          lookbehind: true,
-          alias: 'number'
-        },
-        'boolean': {
-          pattern: /([:\-?\s]\s*)(?:true|false|yes|no|on|off)(?=\s*$)/m,
-          lookbehind: true,
-          alias: 'important'
-        },
-        'null': {
-          pattern: /([:\-?\s]\s*)(?:null|~)(?=\s*$)/m,
-          lookbehind: true,
-          alias: 'important'
-        },
-        'string': {
-          pattern: /([:\-?\s]\s*)(?:"(?:\\.|[^\\"])*"|'(?:[^']|'')*')(?=\s*$)/m,
-          lookbehind: true
-        },
-        'number': {
-          pattern: /([:\-?\s]\s*)[-+]?[0-9]+(?:\.[0-9]+)?(?:[eE][-+]?[0-9]+)?(?=\s*$)/m,
-          lookbehind: true
-        },
-        'tag': /![^\s]+/,
-        'important': /[&*][^\s]+/,
-        'punctuation': /---|[[\]{},]/
-      };
-    }
-
-    // Add basic Protobuf highlighting if not present
-    if (!Prism.languages.protobuf) {
-      Prism.languages.protobuf = {
-        'comment': [
-          /\/\/.*$/m,
-          /\/\*[\s\S]*?\*\//
-        ],
-        'string': {
-          pattern: /"(?:\\.|[^\\"\r\n])*"/,
-          greedy: true
-        },
-        'keyword': /\b(?:syntax|import|package|option|message|enum|service|rpc|returns|repeated|optional|required|oneof|map|reserved|extensions|extend|group)\b/,
-        'builtin': /\b(?:double|float|int32|int64|uint32|uint64|sint32|sint64|fixed32|fixed64|sfixed32|sfixed64|bool|string|bytes)\b/,
-        'number': /\b(?:0x[\da-f]+|\d*\.?\d+(?:e[+-]?\d+)?)\b/i,
-        'boolean': /\b(?:true|false)\b/,
-        'operator': /[=;]/,
-        'punctuation': /[{}[\](),]/
-      };
-    }
-
-    // Register aliases
-    if (Prism.languages.yaml) {
-      Prism.languages.yml = Prism.languages.yaml;
-    }
-    if (Prism.languages.protobuf) {
-      Prism.languages.proto = Prism.languages.protobuf;
-    }
-
-    prismReady = true;
-    return true;
-  } catch (error) {
-    console.warn('Prism sync init failed:', error);
-    return false;
-  }
-};
-
-/**
- * Hook to load Prism languages exactly once
- */
-const usePrism = () => {
-  const [isReady, setIsReady] = useState(prismReady);
-
-  useEffect(() => {
-    if (typeof window === 'undefined') return;
-
-    // Try sync init first
-    if (!prismReady && initPrismSync()) {
-      setIsReady(true);
-      return;
-    }
-
-    if (!prismInitPromise) {
-      // Initialize Prism
-      (window as any).Prism = Prism;
-      Prism.manual = true;
-
-      // Load languages asynchronously
-      prismInitPromise = Promise.all([
-        // @ts-ignore
-        import('prismjs/components/prism-protobuf'),
-        // @ts-ignore
-        import('prismjs/components/prism-yaml'),
-        // @ts-ignore
-        import('prismjs/components/prism-bash'),
-        // @ts-ignore
-        import('prismjs/components/prism-go'),
-        // @ts-ignore
-        import('prismjs/components/prism-json')
-      ]).then(() => {
-        // Register aliases
-        if (Prism.languages.protobuf) {
-          Prism.languages.proto = Prism.languages.protobuf;
-        }
-        if (Prism.languages.bash) {
-          Prism.languages.sh = Prism.languages.bash;
-          Prism.languages.shell = Prism.languages.bash;
-        }
-        if (Prism.languages.yaml) {
-          Prism.languages.yml = Prism.languages.yaml;
-        }
-
-        prismReady = true;
-      }).catch(error => {
-        console.error('Prism async init failed:', error);
-        // Fallback to sync init
-        initPrismSync();
-        prismReady = true;
-      });
-    }
-
-    // Wait for initialization
-    prismInitPromise.then(() => setIsReady(true));
-  }, []);
-
-  return isReady || prismReady;
-};
-
-interface CodeBlockComponentProps extends CodeBlockProps {
-  children?: string;
-  className?: string;
-}
-
-export function CodeBlock({
-  children = '',
-  className = '',
-  language,
-  hasFocus = false,
-  focusLines = []
-}: CodeBlockComponentProps) {
-  const [isCopied, setIsCopied] = useState(false);
-  usePrism();
-
-  // Extract language from className (format: language-xxx)
-  let extractedLanguage = language || className.replace(/language-/, '') || 'text';
-
-  // Handle proto/protobuf variations
-  if (extractedLanguage === 'proto') {
-    extractedLanguage = 'protobuf';
-  }
-
-  // Enhanced fallback language detection
-  if ((extractedLanguage === 'text' || extractedLanguage === '') && children) {
-    const codeContent = children.toLowerCase().trim();
-    const originalContent = children.trim();
-
-    // Protobuf detection first (to catch proto files with go_package option)
-    if (
-      // Explicit protobuf syntax patterns
-      /syntax\s*=\s*["']proto[23]?["']/i.test(originalContent) ||
-      /import\s+["'][^"']+\.proto["']/i.test(originalContent) ||
-      /package\s+[\w.]+;/i.test(originalContent) ||
-      // Proto options (like go_package)
-      /^\s*option\s+\w+/m.test(originalContent) ||
-      // Common protobuf constructs (more strict patterns)
-      (/^\s*message\s+\w+\s*\{/m.test(originalContent) && /^\s*\w+\s+\w+\s*=\s*\d+;/m.test(originalContent)) ||
-      (/^\s*enum\s+\w+\s*\{/m.test(originalContent) && /^\s*\w+\s*=\s*\d+;/m.test(originalContent)) ||
-      (/^\s*service\s+\w+\s*\{/m.test(originalContent) && /^\s*rpc\s+\w+/m.test(originalContent)) ||
-      // Proto3 specific patterns
-      /^\s*syntax\s*=.*proto/mi.test(originalContent)
-    ) {
-      extractedLanguage = 'protobuf';
-    }
-    // Go detection (check for clear Go patterns first)
-    else if (
-      // Go main function is a dead giveaway
-      /func\s+main\s*\(\s*\)/m.test(originalContent) ||
-      // Go package declaration (without semicolon, which proto has)
-      (/^\s*package\s+\w+\s*$/m.test(originalContent) && !codeContent.includes('.proto') && !codeContent.includes('syntax')) ||
-      // Go function declarations with clear patterns
-      /^\s*func\s+[\w\(\)]*\s*\w+\([^)]*\)\s*(\([^)]*\))?\s*\{?/m.test(originalContent) ||
-      // Go imports with parentheses (multi-line imports)
-      /^\s*import\s+\(/m.test(originalContent) ||
-      // Go imports with typical Go packages
-      /import\s+"(fmt|log|net|context|errors|strings|bytes|io|os|time|math|sync|reflect|encoding|crypto|database|testing)"/m.test(originalContent) ||
-      // Go short variable declaration (very Go-specific)
-      /\w+\s*:=/m.test(originalContent) ||
-      // Go defer statement
-      /^\s*defer\s+/m.test(originalContent) ||
-      // Go goroutine
-      /^\s*go\s+func/m.test(originalContent) ||
-      // Go channels
-      /make\(chan\s+/i.test(originalContent) ||
-      // Go interface{} or any
-      /interface\s*\{\s*\}/i.test(originalContent) ||
-      // Go struct definitions
-      /^\s*type\s+\w+\s+struct\s*\{/m.test(originalContent) ||
-      // Go error handling pattern
-      /if\s+err\s*!=\s*nil\s*\{/i.test(originalContent) ||
-      // Go context usage
-      /context\.(Background|TODO|WithCancel|WithTimeout)/i.test(originalContent) ||
-      // Go method receivers
-      /^\s*func\s*\(\s*\w+\s+[\*\w]+\s*\)\s*\w+/m.test(originalContent)
-    ) {
-      extractedLanguage = 'go';
-    }
-    // YAML detection (enhanced patterns)
-    else if (
-      // YAML keys
-      codeContent.includes('version:') ||
-      codeContent.includes('lint:') ||
-      codeContent.includes('use:') ||
-      codeContent.includes('generate:') ||
-      codeContent.includes('deps:') ||
-      codeContent.includes('plugins:') ||
-      codeContent.includes('breaking:') ||
-      codeContent.includes('ignore:') ||
-      codeContent.includes('except:') ||
-      codeContent.includes('ignore_only:') ||
-      // Common YAML patterns
-      /^\s*[\w-]+:\s*/m.test(originalContent) ||
-      /^\s*-\s+/.test(originalContent) ||
-      // YAML configuration suffixes
-      codeContent.includes('_suffix:') ||
-      codeContent.includes('_prefix:') ||
-      // YAML boolean values
-      /:\s*(true|false|yes|no)\s*$/m.test(originalContent)
-    ) {
-      extractedLanguage = 'yaml';
-    }
-    // Bash/Shell detection
-    else if (
-      codeContent.includes('easyp ') ||
-      codeContent.startsWith('npm ') ||
-      (codeContent.startsWith('go ') && !codeContent.includes('func')) || // go command, not Go code
-      codeContent.startsWith('$ ') ||
-      codeContent.startsWith('brew ') ||
-      codeContent.includes('#!/bin/') ||
-      /^[\$#]\s+/.test(originalContent) ||
-      codeContent.includes('docker ') ||
-      codeContent.includes('git ')
-    ) {
-      extractedLanguage = 'bash';
-    }
-    // JSON detection
-    else if (
-      (codeContent.startsWith('{') && codeContent.endsWith('}')) ||
-      (codeContent.startsWith('[') && codeContent.endsWith(']')) ||
-      // JSON-like structure
-      /^\s*["{[]/.test(originalContent)
-    ) {
-      extractedLanguage = 'json';
-    }
-    // Configuration detection (fallback to YAML for config-like content)
-    else if (
-      codeContent.includes('=') && codeContent.includes(':') ||
-      /^\w+\s*[:=]\s*.+$/m.test(originalContent)
-    ) {
-      extractedLanguage = 'yaml';
-    }
-  }
-
-
-  // Map language names for better compatibility with prism-react-renderer
-  const languageMap: { [key: string]: string } = {
-    'protobuf': 'proto',
-    'yaml': 'yaml',
-    'yml': 'yaml',
-    'bash': 'bash',
-    'shell': 'bash',
-    'json': 'json',
-    'go': 'go'
-  };
-
-  // Force protobuf language to be available
-  if (extractedLanguage === 'protobuf' && (!Prism.languages.protobuf || !Prism.languages.proto)) {
-    // Ensure protobuf is available even if async loading failed
-    initPrismSync();
-  }
-
-  // Force Go language to be available
-  if (extractedLanguage === 'go' && !Prism.languages.go) {
-    // Try to load Go language support
-    console.warn('Go language support not loaded, syntax highlighting may not work');
-  }
-
-  // Use mapped language or fallback to original
-  const finalLanguage = languageMap[extractedLanguage] || extractedLanguage;
-
-
-
-  // Clean the code content
-  const code = children.trim();
-
-  // Parse focus lines from code if not provided
-  const { cleanCode, parsedFocusLines } = React.useMemo(() => {
-    if (focusLines.length > 0) {
-      return { cleanCode: code, parsedFocusLines: focusLines };
-    }
-    return parseCodeFocus(code);
-  }, [code, focusLines]);
-
-  const shouldShowFocus = hasFocus || parsedFocusLines.length > 0;
-
-  const handleCopy = () => {
-    navigator.clipboard.writeText(cleanCode);
-    setIsCopied(true);
-    setTimeout(() => setIsCopied(false), 2000);
-  };
-
-  // Use standard Prism highlighting for all languages including protobuf
-  return (
-    <div className={`code-block group ${shouldShowFocus ? 'code-block--with-focus' : ''} ${className}`}>
-      {/* Window Header */}
-      <div className="flex items-center justify-between px-4 py-3 border-b border-white/5 bg-slate-900/50">
-        {/* Window Controls (Traffic Lights) */}
-        <div className="flex items-center gap-2">
-          <div className="w-3 h-3 rounded-full bg-slate-700/50 group-hover:bg-red-500/80 transition-colors duration-300" />
-          <div className="w-3 h-3 rounded-full bg-slate-700/50 group-hover:bg-yellow-500/80 transition-colors duration-300" />
-          <div className="w-3 h-3 rounded-full bg-slate-700/50 group-hover:bg-green-500/80 transition-colors duration-300" />
-        </div>
-
-        {/* Title / Language */}
-        <div className="absolute left-1/2 -translate-x-1/2 flex items-center gap-2 text-xs font-medium text-slate-500 font-mono">
-          <Terminal size={12} />
-          <span className="uppercase tracking-wider">
-            {finalLanguage === 'proto' || finalLanguage === 'protobuf' ? 'PROTOBUF' :
-             finalLanguage === 'yaml' ? 'YAML' :
-             finalLanguage === 'bash' ? 'BASH' :
-             finalLanguage === 'json' ? 'JSON' :
-             finalLanguage === 'go' ? 'GO' :
-             finalLanguage.toUpperCase()}
-          </span>
-        </div>
-
-        {/* Copy Button */}
-        <button
-          onClick={handleCopy}
-          className="flex items-center gap-2 px-3 py-1.5 text-xs text-slate-400 hover:text-white bg-slate-800/50 hover:bg-slate-700/50 border border-slate-600/30 hover:border-slate-500/50 rounded-md transition-all duration-200"
-        >
-          {isCopied ? <Check size={12} /> : <Copy size={12} />}
-          {isCopied ? 'Copied' : 'Copy'}
-        </button>
-      </div>
-
-      {/* Code Content */}
-      <Highlight
-        theme={cyberTheme}
-        code={cleanCode}
-        language={finalLanguage as any}
-        prism={Prism}
-      >
-        {({ className: highlightClassName, style, tokens, getTokenProps }) => (
-          <pre
-            className={`${highlightClassName} code-pre`}
-            style={{ ...style, background: 'transparent' }}
-          >
-            {tokens.map((line, lineIndex) => {
-              const lineNumber = lineIndex + 1;
-              const isFocusLine = parsedFocusLines.includes(lineNumber);
-              const isDimmedLine = shouldShowFocus && !isFocusLine;
-
-              return (
-                <div
-                  key={lineIndex}
-                  className={`
-                    code-line
-                    ${isFocusLine ? 'line-focus' : ''}
-                    ${isDimmedLine ? 'line-dimmed' : ''}
-                  `.trim()}
-                  data-line={lineNumber}
-                >
-                  <span className="line-number">{lineNumber}</span>
-                  <span className="line-content">
-                    {line.map((token, tokenIndex) => (
-                      <span key={tokenIndex} {...getTokenProps({ token })} />
-                    ))}
-                  </span>
-                </div>
-              );
-            })}
-          </pre>
-        )}
-      </Highlight>
-    </div>
-  );
-
-}
-
-/**
- * Inline Code Component with Syntax Highlighting
- */
-function InlineCode({ children }: { children: string }) {
-  usePrism();
-
-  // Heuristic to guess language
-  let lang = 'text';
-  if (children.includes('easyp') || children.startsWith('npm') || children.startsWith('go ')) {
-    lang = 'bash';
-  } else if (children.includes('message ') || children.includes('service ') || children.includes('rpc ') || /^[A-Z][a-zA-Z0-9_]*$/.test(children)) {
-    lang = 'protobuf';
-  }
-
-  return (
-    <Highlight
-      theme={cyberTheme}
-      code={children}
-      language={lang as any}
-      prism={Prism}
-    >
-      {({ className, style, tokens, getTokenProps }) => (
-        <code className={`inline-code ${className}`} style={{ ...style, backgroundColor: 'rgba(30, 41, 59, 0.5)' }}>
-          {tokens.map((line, i) => (
-            <span key={i}>
-              {line.map((token, key) => (
-                <span key={key} {...getTokenProps({ token })} />
-              ))}
-            </span>
-          ))}
-        </code>
-      )}
-    </Highlight>
-  );
-}
-
-/**
- * Parses code content to extract focus lines and clean code
- * @param code Raw code content
- * @returns Clean code and focus line numbers
- */
-function parseCodeFocus(code: string): {
-  cleanCode: string;
-  parsedFocusLines: number[];
-} {
-  const lines = code.split('\n');
-  const focusLines: number[] = [];
-  const cleanLines: string[] = [];
-
-  lines.forEach((line, index) => {
-    const lineNumber = index + 1;
-
-    // Check for focus comment patterns
-    const focusPatterns = [
-      /\/\/\s*\[!code\s+focus\]/i,
-      /\/\*\s*\[!code\s+focus\]\s*\*\//i,
-      /#\s*\[!code\s+focus\]/i,        // Python, shell comments
-      /<!--\s*\[!code\s+focus\]\s*-->/i, // HTML comments
-      /\/\/.*\[!code\s+focus\]/i,      // More flexible JS comments
-    ];
-
-    let hasFocusComment = false;
-    let cleanLine = line;
-
-    for (const pattern of focusPatterns) {
-      if (pattern.test(line)) {
-        hasFocusComment = true;
-        // Remove the focus comment from the line
-        cleanLine = line.replace(pattern, '').trim();
-        break;
-      }
-    }
-
-    if (hasFocusComment) {
-      focusLines.push(lineNumber);
-    }
-
-    cleanLines.push(cleanLine);
-  });
-
-  return {
-    cleanCode: cleanLines.join('\n'),
-    parsedFocusLines: focusLines
-  };
-}
-
-/**
- * Pre-processes code blocks to identify focus annotations
- * @param content Markdown content
- * @returns Content with focus data extracted
- */
-export function preprocessCodeFocus(content: string): string {
-  // This will be used to identify code blocks with focus before rendering
-  return content;
-}
-
-/**
- * Custom code component for markdown-to-jsx
- */
-export function MarkdownCodeBlock(props: any) {
-  const { children, className, ...rest } = props;
-
-
-
-  // Handle inline code
-  if (!className) {
-    return <InlineCode>{children}</InlineCode>;
-  }
-
-  return <CodeBlock className={className} {...rest}>{children}</CodeBlock>;
-}
-
-/**
- * Custom pre component for markdown-to-jsx
- */
-export function MarkdownPre(props: any) {
-  const { children, ...rest } = props;
-
-
-
-  // If children is a code element (or our custom MarkdownCodeBlock), render as CodeBlock directly
-  // This replaces the <pre> tag entirely with our CodeBlock component
-  if (React.isValidElement(children)) {
-    // Check if it's a standard 'code' tag or our custom MarkdownCodeBlock component
-    // We check for MarkdownCodeBlock by reference since they are in the same file
-    if (children.type === 'code' || children.type === MarkdownCodeBlock) {
-      const codeProps = children.props as any;
-
-      // IMPORTANT: We return CodeBlock directly. CodeBlock renders a <div> wrapper.
-      // If we wrapped this in a <pre>, we would get <pre><div>...</div></pre> which is invalid HTML.
-      // By returning CodeBlock directly, we replace the markdown <pre> with our <div class="code-block">.
-      return (
-        <CodeBlock
-          className={codeProps.className}
-          {...rest}
-        >
-          {codeProps.children}
-        </CodeBlock>
-      );
-    }
-  }
-
-  // Fallback for other pre content
-  return <pre {...rest}>{children}</pre>;
-}
-
-export default CodeBlock;
diff --git a/docs/src/lib/markdown/components/CustomBlock.tsx b/docs/src/lib/markdown/components/CustomBlock.tsx
deleted file mode 100644
index 68f032a5..00000000
--- a/docs/src/lib/markdown/components/CustomBlock.tsx
+++ /dev/null
@@ -1,231 +0,0 @@
-import React from 'react';
-import type { CustomBlockProps } from '../types';
-
-export function CustomBlock({
-  type,
-  title,
-  children,
-  className = ''
-}: CustomBlockProps) {
-  const blockClassName = `custom-block custom-block--${type} ${className}`;
-
-  const getDefaultTitle = () => {
-    switch (type) {
-      case 'tip':
-        return 'TIP';
-      case 'warning':
-        return 'WARNING';
-      case 'danger':
-        return 'DANGER';
-      case 'details':
-        return 'DETAILS';
-      default:
-        return '';
-    }
-  };
-
-  const getIcon = () => {
-    switch (type) {
-      case 'tip':
-        return (
-          <svg className="custom-block__icon" viewBox="0 0 24 24" fill="none">
-            <path
-              d="M12 2L2 7V17L12 22L22 17V7L12 2Z"
-              stroke="currentColor"
-              strokeWidth="2"
-              strokeLinecap="round"
-              strokeLinejoin="round"
-            />
-            <path
-              d="M12 8V12"
-              stroke="currentColor"
-              strokeWidth="2"
-              strokeLinecap="round"
-              strokeLinejoin="round"
-            />
-            <circle cx="12" cy="16" r="1" fill="currentColor" />
-          </svg>
-        );
-      case 'warning':
-        return (
-          <svg className="custom-block__icon" viewBox="0 0 24 24" fill="none">
-            <path
-              d="M10.29 3.86L1.82 18A2 2 0 003.54 21H20.46A2 2 0 0022.18 18L13.71 3.86A2 2 0 0010.29 3.86Z"
-              stroke="currentColor"
-              strokeWidth="2"
-              strokeLinecap="round"
-              strokeLinejoin="round"
-            />
-            <path
-              d="M12 9V13"
-              stroke="currentColor"
-              strokeWidth="2"
-              strokeLinecap="round"
-              strokeLinejoin="round"
-            />
-            <circle cx="12" cy="17" r="1" fill="currentColor" />
-          </svg>
-        );
-      case 'danger':
-        return (
-          <svg className="custom-block__icon" viewBox="0 0 24 24" fill="none">
-            <circle
-              cx="12"
-              cy="12"
-              r="10"
-              stroke="currentColor"
-              strokeWidth="2"
-            />
-            <path
-              d="M15 9L9 15"
-              stroke="currentColor"
-              strokeWidth="2"
-              strokeLinecap="round"
-              strokeLinejoin="round"
-            />
-            <path
-              d="M9 9L15 15"
-              stroke="currentColor"
-              strokeWidth="2"
-              strokeLinecap="round"
-              strokeLinejoin="round"
-            />
-          </svg>
-        );
-      case 'details':
-        return (
-          <svg className="custom-block__icon" viewBox="0 0 24 24" fill="none">
-            <circle
-              cx="12"
-              cy="12"
-              r="10"
-              stroke="currentColor"
-              strokeWidth="2"
-            />
-            <path
-              d="M12 16V12"
-              stroke="currentColor"
-              strokeWidth="2"
-              strokeLinecap="round"
-              strokeLinejoin="round"
-            />
-            <circle cx="12" cy="8" r="1" fill="currentColor" />
-          </svg>
-        );
-      default:
-        return null;
-    }
-  };
-
-  const displayTitle = title || getDefaultTitle();
-
-  if (type === 'details') {
-    return (
-      <details className={blockClassName}>
-        <summary className="custom-block__summary">
-          {getIcon()}
-          <span className="custom-block__title">{displayTitle}</span>
-        </summary>
-        <div className="custom-block__content">
-          {children}
-        </div>
-      </details>
-    );
-  }
-
-  return (
-    <div className={blockClassName}>
-      {displayTitle && (
-        <div className="custom-block__header">
-          {getIcon()}
-          <span className="custom-block__title">{displayTitle}</span>
-        </div>
-      )}
-      <div className="custom-block__content">
-        {children}
-      </div>
-    </div>
-  );
-}
-
-/**
- * Parses custom block div elements from markdown
- * @param props HTML div props
- * @returns CustomBlock component or regular div
- */
-export function parseCustomBlockDiv(props: any) {
-  const { className, children, style, ...rest } = props;
-
-  // Check if this is a custom block div
-  if (typeof className === 'string' && className.includes('custom-block')) {
-    const classes = className.split(' ');
-
-    // Extract block type from className
-    let blockType: CustomBlockProps['type'] | null = null;
-
-    if (classes.includes('tip')) blockType = 'tip';
-    else if (classes.includes('warning')) blockType = 'warning';
-    else if (classes.includes('danger')) blockType = 'danger';
-    else if (classes.includes('details')) blockType = 'details';
-
-    if (blockType) {
-      // Extract title from children if present
-      let title: string | undefined;
-      let content = children;
-
-      // Check if first child is a title element or text
-      if (React.Children.count(children) > 0) {
-        const firstChild = React.Children.toArray(children)[0];
-
-        if (React.isValidElement(firstChild) &&
-            (firstChild.type === 'h3' || firstChild.type === 'h4' || firstChild.type === 'strong')) {
-          const props = firstChild.props as any;
-          title = typeof props.children === 'string'
-            ? props.children
-            : undefined;
-          content = React.Children.toArray(children).slice(1);
-        }
-      }
-
-      return (
-        <CustomBlock
-          type={blockType}
-          title={title}
-          className={className.replace('custom-block', '').replace(blockType, '').trim()}
-          {...rest}
-        >
-          {content}
-        </CustomBlock>
-      );
-    }
-  }
-
-  // Return regular div for non-custom blocks
-  return <div className={className} style={style} {...rest}>{children}</div>;
-}
-
-/**
- * Creates a specific custom block component
- */
-export function createCustomBlock(type: CustomBlockProps['type']) {
-  return function CustomBlockComponent({ title, children, className, ...props }: Omit<CustomBlockProps, 'type'>) {
-    return (
-      <CustomBlock
-        type={type}
-        title={title}
-        className={className}
-        {...props}
-      >
-        {children}
-      </CustomBlock>
-    );
-  };
-}
-
-// Pre-made components for each type
-export const TipBlock = createCustomBlock('tip');
-export const WarningBlock = createCustomBlock('warning');
-export const DangerBlock = createCustomBlock('danger');
-export const DetailsBlock = createCustomBlock('details');
-
-export default CustomBlock;
diff --git a/docs/src/lib/markdown/components/Heading.tsx b/docs/src/lib/markdown/components/Heading.tsx
deleted file mode 100644
index a025de4c..00000000
--- a/docs/src/lib/markdown/components/Heading.tsx
+++ /dev/null
@@ -1,98 +0,0 @@
-import React from 'react';
-import type { HeadingComponentProps } from '../types';
-
-export function Heading({
-  level,
-  id,
-  children,
-  className = '',
-  ...props
-}: HeadingComponentProps & React.HTMLAttributes<HTMLHeadingElement>) {
-  const HeadingTag = `h${level}` as any;
-
-  // Generate anchor link icon
-  const AnchorIcon = () => (
-    <svg
-      className="heading-anchor-icon"
-      viewBox="0 0 24 24"
-      fill="none"
-      stroke="currentColor"
-      strokeWidth="2"
-      strokeLinecap="round"
-      strokeLinejoin="round"
-      aria-hidden="true"
-    >
-      <path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71" />
-      <path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71" />
-    </svg>
-  );
-
-  const handleAnchorClick = (e: React.MouseEvent) => {
-    e.preventDefault();
-    if (id) {
-      const element = document.getElementById(id);
-      if (element) {
-        element.scrollIntoView({
-          behavior: 'smooth',
-          block: 'start'
-        });
-
-        // Update URL hash
-        if (window.history.pushState) {
-          window.history.pushState(null, '', `#${id}`);
-        }
-      }
-    }
-  };
-
-  const headingClassName = `
-    markdown-heading
-    markdown-heading--level-${level}
-    ${id ? 'markdown-heading--with-anchor' : ''}
-    ${className}
-  `.trim();
-
-  const Tag = HeadingTag;
-
-  return (
-    <Tag
-      id={id}
-      className={headingClassName}
-      {...props}
-    >
-      <span className="heading-content">
-        {children}
-      </span>
-      {id && (
-        <a
-          href={`#${id}`}
-          className="heading-anchor"
-          onClick={handleAnchorClick}
-          aria-label={`Link to heading: ${typeof children === 'string' ? children : 'heading'}`}
-          title="Direct link to heading"
-        >
-          <AnchorIcon />
-        </a>
-      )}
-    </Tag>
-  );
-}
-
-/**
- * Creates heading components for different levels
- */
-export function createHeadingComponent(level: number) {
-  return function HeadingComponent(props: Omit<HeadingComponentProps, 'level'>) {
-    return <Heading level={level} {...props} />;
-  };
-}
-
-// Pre-made heading components
-export const H1 = createHeadingComponent(1);
-export const H2 = createHeadingComponent(2);
-export const H3 = createHeadingComponent(3);
-export const H4 = createHeadingComponent(4);
-export const H5 = createHeadingComponent(5);
-export const H6 = createHeadingComponent(6);
-
-export default Heading;
diff --git a/docs/src/lib/markdown/components/MarkdownContent.tsx b/docs/src/lib/markdown/components/MarkdownContent.tsx
deleted file mode 100644
index 01dfd78d..00000000
--- a/docs/src/lib/markdown/components/MarkdownContent.tsx
+++ /dev/null
@@ -1,209 +0,0 @@
-import { useMemo, useEffect } from 'react';
-import Markdown from 'markdown-to-jsx';
-import type { MarkdownContentProps, TocItem } from '../types';
-import { parseFrontmatter, removeTocPlaceholder } from '../utils/frontmatter';
-import { generateToc } from '../utils/headings';
-import { generateHeadingId } from '../utils/headings';
-import { useActiveHeading } from './TableOfContents';
-import { useToc } from '../../../contexts/TocContext';
-import { parseCustomBlockDiv } from './CustomBlock';
-import { LinkComponent } from '../plugins/links';
-import { MarkdownCodeBlock, MarkdownPre } from './CodeBlock';
-import { Heading } from './Heading';
-import { createMermaidHtmlOverrides, processMermaidAsHtml } from '../plugins/mermaid';
-
-// Custom heading component that prevents markdown formatting in headings
-function createMarkdownHeading(level: number) {
-  return function MarkdownHeading(props: any) {
-    // Convert children to string and prevent markdown interpretation
-    let text = '';
-    if (typeof props.children === 'string') {
-      text = props.children;
-    } else if (Array.isArray(props.children)) {
-      text = props.children.map((child: any) =>
-        typeof child === 'string' ? child : child.props?.children || ''
-      ).join('');
-    } else if (props.children?.props?.children) {
-      text = props.children.props.children;
-    }
-
-
-
-    // Generate ID from text
-    const id = generateHeadingId(text);
-
-    return <Heading level={level} id={id} {...props}>{text}</Heading>;
-  };
-}
-
-export function MarkdownContent({
-  content,
-  options = {},
-  className = ''
-}: MarkdownContentProps) {
-  const {
-    enableToc = true,
-    enableCodeFocus = true,
-    enableHtmlBlocks = true,
-    enableLinkProcessing = true,
-    tocDepth = { min: 2, max: 4 },
-    baseUrl
-  } = options;
-
-  // Parse frontmatter and process content
-  const { processedContent, toc, frontmatter } = useMemo(() => {
-    const { content: rawContent, frontmatter: fm, hasToc } = parseFrontmatter(content);
-
-    let processed = rawContent;
-
-    // Process Mermaid diagrams BEFORE markdown parsing
-    processed = processMermaidAsHtml(processed);
-
-    // Remove TOC placeholder if present
-    if (hasToc || enableToc) {
-      processed = removeTocPlaceholder(processed);
-    }
-
-    // Escape underscores in headings to prevent italic interpretation
-    processed = processed.replace(/^(#{1,6})\s+(.+)$/gm, (_match, hashes, title) => {
-      // Escape underscores only in the title part
-      const escapedTitle = title.replace(/_/g, '\\_');
-      return `${hashes} ${escapedTitle}`;
-    });
-
-    // Generate TOC if needed
-    let tocItems: TocItem[] = [];
-    if ((hasToc || enableToc) && processed) {
-      tocItems = generateToc(processed, tocDepth.min, tocDepth.max);
-
-      // Add heading IDs to content for anchor links
-      // Note: We don't modify the content string here because markdown-to-jsx
-      // doesn't support the {#id} syntax and renders it as text.
-      // Instead, IDs are generated by the custom Heading components.
-    }
-
-    return {
-      processedContent: processed,
-      toc: tocItems.length > 0 ? tocItems : undefined,
-      frontmatter: fm
-    };
-  }, [content, enableToc, tocDepth]);
-
-  // Track active heading and send to context
-  const activeHeadingId = useActiveHeading(toc || []);
-  const tocContext = useToc();
-
-  // Send TOC and activeId to context
-  useEffect(() => {
-    if (tocContext && toc) {
-      tocContext.setToc(toc);
-      tocContext.setActiveId(activeHeadingId);
-    }
-  }, [toc, activeHeadingId, tocContext]);
-
-  // Create markdown overrides
-  const markdownOverrides = useMemo(() => {
-    const overrides: any = {
-      // Headings with anchor support - prevent markdown interpretation in headings
-      h1: createMarkdownHeading(1),
-      h2: createMarkdownHeading(2),
-      h3: createMarkdownHeading(3),
-      h4: createMarkdownHeading(4),
-      h5: createMarkdownHeading(5),
-      h6: createMarkdownHeading(6),
-
-      // Prevent underscore interpretation as italics
-      em: (props: any) => {
-        const text = typeof props.children === 'string' ? props.children : props.children;
-        // If text contains underscores, render as plain text instead of italics
-        if (typeof text === 'string' && text.includes('_')) {
-          return <span>{text}</span>;
-        }
-        return <em {...props} />;
-      },
-
-      // Prevent underscore interpretation in strong tags
-      strong: (props: any) => {
-        const text = typeof props.children === 'string' ? props.children : props.children;
-        // If text contains underscores, render as plain text instead of bold
-        if (typeof text === 'string' && text.includes('_')) {
-          return <span>{text}</span>;
-        }
-        return <strong {...props} />;
-      },
-    };
-
-    // Add code block support
-    if (enableCodeFocus) {
-      overrides.pre = MarkdownPre;
-      overrides.code = MarkdownCodeBlock;
-    }
-
-    // Add HTML blocks support
-    if (enableHtmlBlocks) {
-      overrides.div = parseCustomBlockDiv;
-    }
-
-    // Add link processing
-    if (enableLinkProcessing) {
-      overrides.a = (props: any) => <LinkComponent {...props} baseUrl={baseUrl} />;
-    }
-
-    // Add Mermaid support
-    const mermaidOverrides = createMermaidHtmlOverrides();
-    Object.assign(overrides, mermaidOverrides);
-
-    return overrides;
-  }, [enableCodeFocus, enableHtmlBlocks, enableLinkProcessing, baseUrl]);
-
-  const markdownOptions = {
-    overrides: markdownOverrides,
-    wrapper: 'div' as any,
-    forceBlock: true
-  };
-
-  const containerClassName = `markdown-content ${className}`.trim();
-
-  return (
-    <div className={containerClassName}>
-      <div className="markdown-body">
-        {frontmatter.title && (
-          <header className="markdown-header">
-            <h1 className="markdown-title">{frontmatter.title}</h1>
-            {frontmatter.description && (
-              <p className="markdown-description">{frontmatter.description}</p>
-            )}
-          </header>
-        )}
-
-        <Markdown options={markdownOptions}>
-          {processedContent}
-        </Markdown>
-      </div>
-    </div>
-  );
-}
-
-/**
- * Hook for processing markdown content without rendering
- */
-export function useMarkdownProcessor(content: string, options: any = {}) {
-  return useMemo(() => {
-    const { content: rawContent, frontmatter, hasToc } = parseFrontmatter(content);
-
-    const processedContent = hasToc ? removeTocPlaceholder(rawContent) : rawContent;
-
-    const toc = hasToc || options.enableToc
-      ? generateToc(processedContent, options.tocDepth?.min || 2, options.tocDepth?.max || 4)
-      : undefined;
-
-    return {
-      content: processedContent,
-      frontmatter,
-      toc,
-      hasToc
-    };
-  }, [content, options]);
-}
-
-export default MarkdownContent;
diff --git a/docs/src/lib/markdown/components/TableOfContents.tsx b/docs/src/lib/markdown/components/TableOfContents.tsx
deleted file mode 100644
index c56c3783..00000000
--- a/docs/src/lib/markdown/components/TableOfContents.tsx
+++ /dev/null
@@ -1,151 +0,0 @@
-import React from 'react';
-import type { TocItem } from '../types';
-
-interface TableOfContentsProps {
-  toc: TocItem[];
-  title?: string;
-  className?: string;
-  maxDepth?: number;
-  activeId?: string;
-}
-
-export function TableOfContents({
-  toc,
-  title = "Table of Contents",
-  className = "",
-  maxDepth = 4,
-  activeId
-}: TableOfContentsProps) {
-  if (!toc || toc.length === 0) {
-    return null;
-  }
-
-  const handleClick = (e: React.MouseEvent<HTMLAnchorElement>, id: string) => {
-    e.preventDefault();
-
-    const element = document.getElementById(id);
-    if (element) {
-      element.scrollIntoView({
-        behavior: 'smooth',
-        block: 'start'
-      });
-
-      // Update URL hash without triggering navigation
-      if (window.history.pushState) {
-        window.history.pushState(null, '', `#${id}`);
-      }
-    }
-  };
-
-  const renderTocItem = (item: TocItem, depth: number = 0) => {
-    if (depth >= maxDepth) {
-      return null;
-    }
-
-    const isActive = activeId === item.id;
-    const hasChildren = item.children && item.children.length > 0;
-
-    return (
-      <li key={item.id} className={`toc-item toc-item--level-${item.level}`}>
-        <a
-          href={`#${item.id}`}
-          className={`toc-link ${isActive ? 'toc-link--active' : ''}`}
-          onClick={(e) => handleClick(e, item.id)}
-          title={item.text}
-        >
-          {item.text}
-        </a>
-        {hasChildren && (
-          <ul className={`toc-list toc-list--level-${item.level + 1}`}>
-            {item.children!.map(child => renderTocItem(child, depth + 1))}
-          </ul>
-        )}
-      </li>
-    );
-  };
-
-  return (
-    <nav className={`toc-container ${className}`} aria-label="Table of contents">
-      <h3 className="toc-title">{title}</h3>
-      <ul className="toc-list toc-list--root">
-        {toc.map(item => renderTocItem(item))}
-      </ul>
-    </nav>
-  );
-}
-
-// Hook to track active heading based on scroll position
-export function useActiveHeading(toc: TocItem[]) {
-  const [activeId, setActiveId] = React.useState<string>('');
-
-  React.useEffect(() => {
-    if (!toc || toc.length === 0) return;
-
-    // Helper to flatten TOC for scroll tracking
-    const getAllHeadings = (items: TocItem[]): TocItem[] => {
-      return items.reduce((acc: TocItem[], item) => {
-        acc.push(item);
-        if (item.children && item.children.length > 0) {
-          acc.push(...getAllHeadings(item.children));
-        }
-        return acc;
-      }, []);
-    };
-
-    const allHeadings = getAllHeadings(toc);
-
-    const handleScroll = () => {
-      const headings = allHeadings.map(item => {
-        const element = document.getElementById(item.id);
-        if (element) {
-          const rect = element.getBoundingClientRect();
-          return {
-            id: item.id,
-            top: rect.top,
-            element
-          };
-        }
-        return null;
-      }).filter(Boolean);
-
-      if (headings.length === 0) return;
-
-      // Find the heading that's currently in view
-      const threshold = 100; // Distance from top of viewport
-      let currentActive = '';
-
-      for (const heading of headings) {
-        if (heading!.top <= threshold) {
-          currentActive = heading!.id;
-        } else {
-          break;
-        }
-      }
-
-      // If no heading is above the threshold, use the first one
-      if (!currentActive && headings.length > 0) {
-        currentActive = headings[0]!.id;
-      }
-
-      setActiveId(currentActive);
-    };
-
-    // Initial check
-    handleScroll();
-
-    // Add scroll listener
-    window.addEventListener('scroll', handleScroll, { passive: true });
-
-    // Also check on resize in case layout changes
-    window.addEventListener('resize', handleScroll, { passive: true });
-
-    return () => {
-      window.removeEventListener('scroll', handleScroll);
-      window.removeEventListener('resize', handleScroll);
-    };
-  }, [toc]);
-
-  return activeId;
-}
-
-export default TableOfContents;
diff --git a/docs/src/lib/markdown/demo.tsx b/docs/src/lib/markdown/demo.tsx
deleted file mode 100644
index a1bcf375..00000000
--- a/docs/src/lib/markdown/demo.tsx
+++ /dev/null
@@ -1,330 +0,0 @@
-import { MarkdownContent } from './index';
-import './styles.css';
-
-const demoMarkdown = `---
-title: "EasyP Markdown Library Demo"
-description: "Complete demonstration of all markdown features"
----
-
-# EasyP Markdown Library Demo
-
-[[toc]]
-
-Welcome to the **EasyP Markdown Library**! This demo showcases all the powerful features available for processing markdown content in React applications.
-
-<div class="tip custom-block">
-
-**🎉 Features Included**: Table of Contents, Code Focus, Custom HTML Blocks, Smart Link Processing, and much more!
-
-</div>
-
-## Table of Contents Features
-
-The table of contents is automatically generated from your document headings. Simply add \`[[toc]]\` anywhere in your markdown, and it will be replaced with a beautiful, interactive table of contents.
-
-### How TOC Works
-
-- Extracts headings from H2 to H4 by default
-- Generates unique anchor IDs
-- Provides smooth scrolling navigation
-- Highlights active section while scrolling
-
-### TOC Configuration
-
-You can customize the TOC behavior:
-
-\`\`\`typescript
-const options = {
-  enableToc: true,
-  tocDepth: { min: 2, max: 4 } // Include h2, h3, h4
-};
-\`\`\`
-
-## Code Focus Feature
-
-One of the most powerful features is the ability to highlight specific lines in code blocks using special comments.
-
-### JavaScript Example
-
-\`\`\`javascript
-function processUser(userData) {
-  // Validate input data
-  if (!userData || !userData.email) {
-    throw new Error('Invalid user data'); // [!code focus]
-  }
-
-  // Process the user
-  const user = {
-    id: generateId(),
-    email: userData.email.toLowerCase(), // [!code focus]
-    name: userData.name || 'Anonymous',
-    createdAt: new Date() // [!code focus]
-  };
-
-  // Save to database
-  return saveUser(user);
-}
-\`\`\`
-
-### Python Example
-
-\`\`\`python
-def calculate_metrics(data):
-    """Calculate performance metrics from data."""
-    total = 0
-    count = 0
-
-    for item in data:
-        if item.is_valid():  # [!code focus]
-            total += item.value  # [!code focus]
-            count += 1  # [!code focus]
-
-    return {
-        'average': total / count if count > 0 else 0,
-        'total': total,
-        'count': count
-    }
-\`\`\`
-
-### Supported Comment Styles
-
-The library supports multiple comment syntaxes:
-
-- \`// [!code focus]\` - JavaScript, C++, Java, etc.
-- \`# [!code focus]\` - Python, Shell, YAML, etc.
-- \`<!-- [!code focus] -->\` - HTML, XML
-- \`/* [!code focus] */\` - CSS, multi-line comments
-
-## Custom HTML Blocks
-
-Create visually appealing information blocks using HTML divs with special classes.
-
-### Tip Block
-
-<div class="tip custom-block">
-
-**💡 Pro Tip**: Use tip blocks to provide helpful hints and best practices to your readers.
-
-This block can contain **any markdown content**, including:
-- Lists
-- Links
-- Code snippets
-- And more!
-
-</div>
-
-### Warning Block
-
-<div class="warning custom-block">
-
-**⚠️ Important Warning**: Always backup your data before making significant changes to your system configuration.
-
-Use warning blocks for information that could prevent issues or mistakes.
-
-</div>
-
-### Danger Block
-
-<div class="danger custom-block">
-
-**🚨 Critical Alert**: This operation will permanently delete all data and cannot be undone.
-
-Reserve danger blocks for truly critical information that could cause data loss or system damage.
-
-</div>
-
-### Details Block
-
-<div class="details custom-block">
-
-**📋 Additional Details**: Click to expand this section for more detailed information.
-
-This is perfect for optional information that doesn't need to be visible by default. You can include:
-
-1. Extended explanations
-2. Advanced configuration options
-3. Troubleshooting steps
-4. Reference materials
-
-</div>
-
-## Link Processing
-
-The library intelligently handles different types of links:
-
-### Internal Links
-- [Documentation Overview](./README.md) - Automatically converted for React Router
-- [Getting Started Guide](./getting-started.md) - Works with relative paths
-- [API Reference](../api/index.md) - Handles directory traversal
-
-### External Links
-- [EasyP GitHub Repository](https://github.com/easyp-tech/easyp) - Opens in new tab with icon
-- [React Documentation](https://react.dev) - External link indicator
-- [TypeScript Handbook](https://www.typescriptlang.org/docs/) - Secure external links
-
-### Anchor Links
-- [Jump to Code Focus Section](#code-focus-feature) - Smooth scrolling navigation
-- [Go to Custom Blocks](#custom-html-blocks) - Internal page anchors
-- [Back to Table of Contents](#table-of-contents-features) - Section navigation
-
-## Advanced Formatting
-
-### Lists and Structure
-
-#### Unordered Lists
-- **Primary item** with emphasis
-- *Secondary item* with italics
-- \`Code item\` with inline code
-- Regular item with [internal link](./example.md)
-- Item with [external link](https://example.com)
-
-#### Ordered Lists
-1. First step in the process
-2. Second step with **important** details
-3. Third step with \`code example\`
-4. Final step with completion
-
-#### Task Lists
-- [x] Implement Table of Contents generation
-- [x] Add Code Focus highlighting
-- [x] Create Custom HTML blocks
-- [x] Implement Link processing
-- [ ] Add mathematical formula support
-- [ ] Implement diagram rendering
-
-### Tables
-
-| Feature | Status | Description | Version |
-|---------|--------|-------------|---------|
-| TOC Generation | ✅ Complete | Automatic from headings | 1.0.0 |
-| Code Focus | ✅ Complete | Line highlighting | 1.0.0 |
-| HTML Blocks | ✅ Complete | Custom info blocks | 1.0.0 |
-| Link Processing | ✅ Complete | Smart link handling | 1.0.0 |
-| Math Support | 🔄 Planned | LaTeX formulas | 1.1.0 |
-| Diagrams | 🔄 Planned | Mermaid integration | 1.2.0 |
-
-### Blockquotes
-
-> **"The best documentation is the one that doesn't exist because the code is so clear."**
->
-> However, when documentation is necessary, it should be comprehensive, accessible, and maintainable.
->
-> — Software Engineering Wisdom
-
-### Code Examples
-
-#### Inline Code
-Use \`const variable = "value"\` for variable assignments, \`npm install package\` for commands, and \`<Component />\` for JSX elements.
-
-#### Configuration Example
-
-\`\`\`yaml
-# easyp.yaml configuration
-version: v1alpha
-lint:
-  use: [MINIMAL, BASIC, DEFAULT] # [!code focus]
-  enum_zero_value_suffix: "UNSPECIFIED" # [!code focus]
-  service_suffix: "Service" # [!code focus]
-  ignore:
-    - "vendor/"
-    - "third_party/"
-\`\`\`
-
-#### Usage Example
-
-\`\`\`tsx
-import { MarkdownContent } from '@/lib/markdown';
-import '@/lib/markdown/styles.css';
-
-export function DocumentationPage({ content }: { content: string }) {
-  return (
-    <div className="documentation">
-      <MarkdownContent  // [!code focus]
-        content={content}  // [!code focus]
-        options={{  // [!code focus]
-          enableToc: true,  // [!code focus]
-          enableCodeFocus: true,  // [!code focus]
-          enableHtmlBlocks: true,  // [!code focus]
-          enableLinkProcessing: true,  // [!code focus]
-          baseUrl: '/docs'  // [!code focus]
-        }}  // [!code focus]
-      />  // [!code focus]
-    </div>
-  );
-}
-\`\`\`
-
-## Performance and Optimization
-
-The library is built with performance in mind:
-
-### Key Optimizations
-- **Memoized Processing**: Results are cached to avoid recomputation
-- **Efficient Rendering**: Only re-renders when content changes
-- **Lazy Loading**: Large documents load progressively
-- **Code Splitting**: Syntax highlighting loads on demand
-
-### Memory Usage
-- Minimal memory footprint
-- Efficient garbage collection
-- Optimized for large documents
-- Smart caching strategies
-
-## Browser Compatibility
-
-| Browser | Minimum Version | Notes |
-|---------|----------------|-------|
-| Chrome | 88+ | Full support |
-| Firefox | 85+ | Full support |
-| Safari | 14+ | Full support |
-| Edge | 88+ | Full support |
-
----
-
-## Conclusion
-
-The **EasyP Markdown Library** provides a comprehensive solution for rendering markdown content in React applications. With features like:
-
-1. ✅ **Automatic Table of Contents**
-2. ✅ **Code Focus Highlighting**
-3. ✅ **Custom HTML Blocks**
-4. ✅ **Smart Link Processing**
-5. ✅ **TypeScript Support**
-6. ✅ **Customizable Styling**
-
-You can create professional documentation sites with ease.
-
-<div class="tip custom-block">
-
-**🚀 Ready to Get Started?** Check out the [README](./README.md) for installation and usage instructions, or explore the [example files](./example.md) for more detailed examples.
-
-</div>
-
-For more information about the EasyP project, visit our [GitHub repository](https://github.com/easyp-tech/easyp) or read the [full documentation](https://docs.easyp.tech).
-`;
-
-export function MarkdownDemo() {
-  return (
-    <div style={{
-      maxWidth: '1200px',
-      margin: '0 auto',
-      padding: '20px',
-      fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif'
-    }}>
-      <MarkdownContent
-        content={demoMarkdown}
-        options={{
-          enableToc: true,
-          enableCodeFocus: true,
-          enableHtmlBlocks: true,
-          enableLinkProcessing: true,
-          tocDepth: { min: 2, max: 4 },
-          baseUrl: '/docs'
-        }}
-        className="demo-content"
-      />
-    </div>
-  );
-}
-
-export default MarkdownDemo;
diff --git a/docs/src/lib/markdown/example.md b/docs/src/lib/markdown/example.md
deleted file mode 100644
index 9e202c5e..00000000
--- a/docs/src/lib/markdown/example.md
+++ /dev/null
@@ -1,165 +0,0 @@
----
-title: "Example Markdown Document"
-description: "A comprehensive example showcasing all markdown features"
-toc: true
----
-
-# Example Markdown Document
-
-[[toc]]
-
-This is an example markdown document that demonstrates all the features supported by the EasyP Markdown Library.
-
-<div class="tip custom-block" style="padding-top: 8px">
-
-This is a **tip block** that shows how HTML content is rendered within markdown. You can include any HTML elements here!
-
-</div>
-
-## Table of Contents Features
-
-The table of contents is automatically generated from headings in your document. You can control which headings are included by adjusting the `tocDepth` configuration.
-
-### Nested Heading Example
-
-This is a third-level heading that will appear nested in the TOC.
-
-#### Fourth Level Heading
-
-And this is a fourth-level heading for even deeper nesting.
-
-## Code Examples with Focus
-
-Here's a JavaScript example with focus highlighting:
-
-```javascript
-function greet(name) {
-    console.log("Setting up greeting..."); 
-    const message = `Hello, ${name}!`; // [!code focus]
-    console.log("Greeting prepared");
-    return message; // [!code focus]
-}
-
-// Usage example
-const greeting = greet("World"); // [!code focus]
-console.log(greeting);
-```
-
-And here's a Python example:
-
-```python
-def calculate_sum(numbers):
-    total = 0
-    for num in numbers: # [!code focus]
-        total += num # [!code focus]
-    return total
-
-# Example usage
-result = calculate_sum([1, 2, 3, 4, 5]) # [!code focus]
-print(f"Sum: {result}")
-```
-
-## Custom Blocks
-
-### Warning Block
-
-<div class="warning custom-block">
-
-**Warning**: This is a warning block. Use it to highlight important information that users should be aware of.
-
-</div>
-
-### Danger Block
-
-<div class="danger custom-block">
-
-**Danger**: This indicates something potentially harmful or destructive. Use sparingly and only when absolutely necessary.
-
-</div>
-
-### Details Block
-
-<div class="details custom-block">
-
-**Click to expand**: This is a collapsible details block that can contain additional information.
-
-You can include multiple paragraphs, lists, and even code blocks inside details blocks.
-
-</div>
-
-## Links and Navigation
-
-Here are examples of different types of links:
-
-- [Internal link to another page](./what-is.md)
-- [External link to GitHub](https://github.com/easyp-tech/easyp)
-- [Anchor link to code section](#code-examples-with-focus)
-- [Link to a specific heading](#nested-heading-example)
-
-## Lists and Formatting
-
-### Unordered Lists
-
-- First item
-- Second item with **bold text**
-- Third item with *italic text*
-- Fourth item with `inline code`
-
-### Ordered Lists
-
-1. First numbered item
-2. Second numbered item
-3. Third numbered item with a [link](https://example.com)
-
-### Task Lists
-
-- [x] Completed task
-- [ ] Incomplete task
-- [x] Another completed task
-
-## Tables
-
-| Feature | Supported | Notes |
-|---------|-----------|-------|
-| TOC Generation | ✅ | Automatic from headings |
-| Code Focus | ✅ | Using `[!code focus]` |
-| HTML Blocks | ✅ | Custom tip, warning, danger blocks |
-| Link Processing | ✅ | Internal and external links |
-
-## Blockquotes
-
-> This is a blockquote. It can be used to highlight important information or quotes from other sources.
-> 
-> Blockquotes can span multiple lines and paragraphs.
-
-## Inline Code and Formatting
-
-Here's some text with `inline code`, **bold text**, *italic text*, and ~~strikethrough text~~.
-
-You can also use combinations like ***bold and italic*** or `**bold code**`.
-
-## Mathematical Expressions
-
-While mathematical expressions aren't directly supported in the base library, you can always extend it with additional plugins for LaTeX support.
-
-## Images
-
-![Example Image](https://via.placeholder.com/600x300.png?text=Example+Image)
-
-## Horizontal Rules
-
-Use horizontal rules to separate sections:
-
----
-
-## Conclusion
-
-This example demonstrates the comprehensive markdown processing capabilities of the EasyP Markdown Library. The library handles:
-
-1. **Table of Contents**: Automatic generation from headings
-2. **Code Focus**: Highlighting specific lines in code blocks
-3. **Custom HTML Blocks**: Tip, warning, danger, and details blocks
-4. **Link Processing**: Internal navigation and external links
-5. **Standard Markdown**: All common markdown features
-
-For more information, visit the [EasyP documentation](https://github.com/easyp-tech/easyp).
\ No newline at end of file
diff --git a/docs/src/lib/markdown/index.ts b/docs/src/lib/markdown/index.ts
deleted file mode 100644
index 45a9dbbc..00000000
--- a/docs/src/lib/markdown/index.ts
+++ /dev/null
@@ -1,114 +0,0 @@
-/**
- * EasyP Markdown Library
- *
- * A comprehensive markdown processing library for React applications
- * with support for Table of Contents, code focus, HTML blocks, and link processing.
- */
-
-// Main processor and types
-export { MarkdownProcessor, processMarkdown, preprocessMarkdown, validateMarkdown, extractMarkdownMetadata } from './processor';
-export type { MarkdownProcessorOptions, ProcessedMarkdown } from './types';
-export type {
-  TocItem,
-  HeadingData,
-  CodeBlockProps,
-  CustomBlockProps,
-  LinkComponentProps,
-  HeadingComponentProps,
-  MarkdownContentProps,
-  FrontmatterData,
-  ParsedMarkdown
-} from './types';
-
-// Main React components
-export { MarkdownContent, useMarkdownProcessor } from './components/MarkdownContent';
-export { TableOfContents, useActiveHeading } from './components/TableOfContents';
-export { CodeBlock, MarkdownCodeBlock, MarkdownPre } from './components/CodeBlock';
-export { CustomBlock, parseCustomBlockDiv, TipBlock, WarningBlock, DangerBlock, DetailsBlock } from './components/CustomBlock';
-export { Heading, H1, H2, H3, H4, H5, H6 } from './components/Heading';
-
-// Plugin exports
-export { default as tocPlugin } from './plugins/toc';
-export { default as codeFocusPlugin } from './plugins/codeFocus';
-export { default as htmlBlocksPlugin } from './plugins/htmlBlocks';
-export { default as linksPlugin } from './plugins/links';
-
-// Utilities
-export {
-  parseFrontmatter,
-  removeTocPlaceholder,
-  extractTitle,
-  extractDescription
-} from './utils/frontmatter';
-
-export {
-  generateHeadingId,
-  extractHeadings,
-  buildTocStructure,
-  addHeadingIds,
-  generateToc,
-  flattenToc
-} from './utils/headings';
-
-export {
-  isExternalUrl,
-  isRelativePath,
-  isAnchorLink,
-  normalizePath,
-  joinPaths,
-  resolveMarkdownPath,
-  filePathToUrlPath,
-  getDirectoryPath,
-  getFileName,
-  getFileExtension,
-  isMarkdownFile,
-  resolveRouterHref
-} from './utils/paths';
-
-// Default configuration
-const defaultOptions = {
-  enableToc: true,
-  enableCodeFocus: true,
-  enableHtmlBlocks: true,
-  enableLinkProcessing: true,
-  tocDepth: { min: 2, max: 4 }
-} as const;
-
-export { defaultOptions };
-
-// Version info
-export const version = '1.0.0';
-
-// Re-export main components for convenience
-import { MarkdownProcessor as MP, processMarkdown as pm, validateMarkdown as vm, extractMarkdownMetadata as emm } from './processor';
-import { MarkdownContent as MC } from './components/MarkdownContent';
-
-// Convenience wrapper for quick usage
-export function createMarkdownProcessor(options?: any) {
-  return new MP({ ...defaultOptions, ...options });
-}
-
-// Quick processing functions
-export function quickProcess(content: string, options?: any) {
-  return pm(content, { ...defaultOptions, ...options });
-}
-
-export function quickValidate(content: string) {
-  return vm(content);
-}
-
-export function quickMetadata(content: string) {
-  return emm(content);
-}
-
-// Default export
-const markdownLib = {
-  MarkdownProcessor: MP,
-  MarkdownContent: MC,
-  processMarkdown: pm,
-  validateMarkdown: vm,
-  defaultOptions,
-  version
-};
-
-export default markdownLib;
diff --git a/docs/src/lib/markdown/plugins/codeFocus.tsx b/docs/src/lib/markdown/plugins/codeFocus.tsx
deleted file mode 100644
index f3a10edb..00000000
--- a/docs/src/lib/markdown/plugins/codeFocus.tsx
+++ /dev/null
@@ -1,238 +0,0 @@
-import React from 'react';
-import type { MarkdownProcessorOptions } from '../types';
-
-/**
- * Code Focus Plugin for markdown processing
- * Handles [!code focus] annotations in code blocks
- */
-
-/**
- * Processes code focus annotations in markdown content
- * @param content Markdown content
- * @param options Processing options
- * @returns Processed content with focus annotations handled
- */
-export function processCodeFocus(
-  content: string,
-  options?: MarkdownProcessorOptions
-): string {
-  if (!options?.enableCodeFocus) {
-    return content;
-  }
-
-  // Process code blocks and extract focus information
-  return content.replace(/```(\w+)?\n([\s\S]*?)```/g, (match, language, code) => {
-    const { cleanCode, hasFocus } = extractFocusFromCode(code);
-
-    if (hasFocus) {
-      // Add a data attribute to indicate this block has focus
-      const langPart = language ? language : '';
-      return `\`\`\`${langPart} focus\n${cleanCode}\`\`\``;
-    }
-
-    return match;
-  });
-}
-
-/**
- * Extracts focus information from code content
- * @param code Raw code content
- * @returns Clean code and focus status
- */
-export function extractFocusFromCode(code: string): {
-  cleanCode: string;
-  hasFocus: boolean;
-  focusLines: number[];
-} {
-  const lines = code.split('\n');
-  const focusLines: number[] = [];
-  const cleanLines: string[] = [];
-  let hasFocus = false;
-
-  lines.forEach((line, index) => {
-    const lineNumber = index + 1;
-
-    // Check for various focus comment patterns
-    const focusPatterns = [
-      /\/\/\s*\[!code\s+focus\]/i,           // JavaScript-style
-      /\/\*\s*\[!code\s+focus\]\s*\*\//i,   // Multi-line JS
-      /#\s*\[!code\s+focus\]/i,             // Python, shell, YAML
-      /<!--\s*\[!code\s+focus\]\s*-->/i,     // HTML/XML comments
-      /\{\{.*\[!code\s+focus\].*\}\}/i,     // Template comments
-      /\{\/\*\s*\[!code\s+focus\]\s*\*\/\}/i, // JSX comments
-    ];
-
-    let cleanLine = line;
-
-    // Check each pattern and clean the line if focus comment is found
-    for (const pattern of focusPatterns) {
-      if (pattern.test(line)) {
-        hasFocus = true;
-        focusLines.push(lineNumber);
-
-        // Remove the focus comment, preserving indentation
-        cleanLine = line.replace(pattern, '').trimEnd();
-
-        // If the line becomes empty after removing comment, keep original structure
-        if (cleanLine.trim() === '' && line.trim() !== '') {
-          cleanLine = line.replace(pattern, '').replace(/\s+$/, '');
-        }
-        break;
-      }
-    }
-
-    cleanLines.push(cleanLine);
-  });
-
-  return {
-    cleanCode: cleanLines.join('\n'),
-    hasFocus,
-    focusLines
-  };
-}
-
-/**
- * Checks if a code block contains focus annotations
- * @param code Code content
- * @returns True if contains focus annotations
- */
-export function hasCodeFocus(code: string): boolean {
-  const focusPattern = /\[!code\s+focus\]/i;
-  return focusPattern.test(code);
-}
-
-/**
- * Parses focus lines from code block metadata
- * @param metadata Code block metadata (e.g., "javascript focus")
- * @returns Whether block has focus and focus lines
- */
-export function parseFocusMetadata(metadata: string): {
-  hasFocus: boolean;
-  language?: string;
-} {
-  const parts = metadata.split(/\s+/);
-  const language = parts.find(part => !['focus', 'highlight', 'dim'].includes(part));
-  const hasFocus = parts.includes('focus');
-
-  return {
-    hasFocus,
-    language
-  };
-}
-
-/**
- * Pre-processes markdown content for code focus
- * @param content Raw markdown content
- * @param options Processing options
- * @returns Pre-processed content
- */
-export function preprocessCodeFocus(
-  content: string,
-  options?: MarkdownProcessorOptions
-): string {
-  if (!options?.enableCodeFocus) {
-    return content;
-  }
-
-  return processCodeFocus(content, options);
-}
-
-/**
- * Generates markdown overrides for code focus processing
- * @param options Processing options
- * @returns Markdown-to-jsx overrides
- */
-export function getCodeFocusOverrides(options?: MarkdownProcessorOptions) {
-  if (!options?.enableCodeFocus) {
-    return {};
-  }
-
-  return {
-    pre: (props: any) => {
-      const { children, ...rest } = props;
-
-      // Handle code blocks with focus
-      if (React.isValidElement(children) && children.type === 'code') {
-        const codeProps = children.props as any;
-        const className = codeProps.className || '';
-
-        // Check if this is a focused code block
-        const hasFocus = className.includes('focus');
-
-        return (
-          <div className={`code-block ${hasFocus ? 'code-block--with-focus' : ''}`}>
-            <pre {...rest} className={`${className} code-pre`}>
-              {children}
-            </pre>
-          </div>
-        );
-      }
-
-      return <pre {...rest}>{children}</pre>;
-    },
-
-    code: (props: any) => {
-      const { className, children, ...rest } = props;
-
-      // Handle inline code
-      if (!className) {
-        return <code className="inline-code" {...rest}>{children}</code>;
-      }
-
-      // Handle code blocks
-      const hasFocus = className.includes('focus');
-
-      if (hasFocus) {
-        const { cleanCode, focusLines } = extractFocusFromCode(children);
-
-        return (
-          <code
-            {...rest}
-            className={className}
-            data-focus="true"
-            data-focus-lines={focusLines.join(',')}
-          >
-            {cleanCode}
-          </code>
-        );
-      }
-
-      return <code {...rest} className={className}>{children}</code>;
-    }
-  };
-}
-
-/**
- * Validates code focus configuration
- * @param code Code content
- * @param focusLines Focus line numbers
- * @returns True if valid configuration
- */
-export function validateCodeFocus(code: string, focusLines: number[]): boolean {
-  const lines = code.split('\n');
-  const totalLines = lines.length;
-
-  return focusLines.every(line => line >= 1 && line <= totalLines);
-}
-
-/**
- * Normalizes focus line numbers (removes duplicates, sorts)
- * @param focusLines Array of line numbers
- * @returns Normalized array
- */
-export function normalizeFocusLines(focusLines: number[]): number[] {
-  return [...new Set(focusLines)]
-    .filter(line => typeof line === 'number' && line > 0)
-    .sort((a, b) => a - b);
-}
-
-export default {
-  processCodeFocus,
-  extractFocusFromCode,
-  hasCodeFocus,
-  parseFocusMetadata,
-  preprocessCodeFocus,
-  getCodeFocusOverrides,
-  validateCodeFocus,
-  normalizeFocusLines
-};
diff --git a/docs/src/lib/markdown/plugins/htmlBlocks.tsx b/docs/src/lib/markdown/plugins/htmlBlocks.tsx
deleted file mode 100644
index a5ce70c6..00000000
--- a/docs/src/lib/markdown/plugins/htmlBlocks.tsx
+++ /dev/null
@@ -1,229 +0,0 @@
-import type { MarkdownProcessorOptions } from '../types';
-import { parseCustomBlockDiv } from '../components/CustomBlock';
-
-/**
- * HTML Blocks Plugin for markdown processing
- * Handles custom block divs like tip, warning, danger, details
- */
-
-/**
- * Processes HTML blocks in markdown content
- * @param content Markdown content
- * @param options Processing options
- * @returns Processed content with HTML blocks handled
- */
-export function processHtmlBlocks(
-  content: string,
-  options?: MarkdownProcessorOptions
-): string {
-  if (!options?.enableHtmlBlocks) {
-    return content;
-  }
-
-  // Process custom block divs
-  return content.replace(
-    /<div\s+class="([^"]*custom-block[^"]*)"[^>]*>([\s\S]*?)<\/div>/gi,
-    (_match, className, innerContent) => {
-      // Normalize the custom block structure
-      return normalizeCustomBlock(className, innerContent);
-    }
-  );
-}
-
-/**
- * Normalizes custom block HTML structure
- * @param className CSS class string
- * @param content Inner content
- * @returns Normalized HTML structure
- */
-function normalizeCustomBlock(className: string, content: string): string {
-  const classes = className.split(' ');
-
-  // Detect block type
-  let blockType = '';
-  if (classes.includes('tip')) blockType = 'tip';
-  else if (classes.includes('warning')) blockType = 'warning';
-  else if (classes.includes('danger')) blockType = 'danger';
-  else if (classes.includes('details')) blockType = 'details';
-
-  if (!blockType) {
-    return `<div class="${className}">${content}</div>`;
-  }
-
-  // Extract and clean content
-  const cleanContent = content.trim();
-
-  // Add data attributes for easier processing
-  return `<div class="${className}" data-block-type="${blockType}">${cleanContent}</div>`;
-}
-
-/**
- * Checks if content contains HTML blocks
- * @param content Markdown content
- * @returns True if contains custom blocks
- */
-export function hasHtmlBlocks(content: string): boolean {
-  return /class="[^"]*custom-block[^"]*"/i.test(content);
-}
-
-/**
- * Pre-processes markdown content for HTML blocks
- * @param content Raw markdown content
- * @param options Processing options
- * @returns Pre-processed content
- */
-export function preprocessHtmlBlocks(
-  content: string,
-  options?: MarkdownProcessorOptions
-): string {
-  if (!options?.enableHtmlBlocks) {
-    return content;
-  }
-
-  return processHtmlBlocks(content, options);
-}
-
-/**
- * Generates markdown overrides for HTML blocks processing
- * @param options Processing options
- * @returns Markdown-to-jsx overrides
- */
-export function getHtmlBlocksOverrides(options?: MarkdownProcessorOptions) {
-  if (!options?.enableHtmlBlocks) {
-    return {};
-  }
-
-  return {
-    div: parseCustomBlockDiv,
-  };
-}
-
-/**
- * Parses custom block attributes from HTML
- * @param htmlString HTML string
- * @returns Parsed attributes
- */
-export function parseCustomBlockAttributes(htmlString: string): {
-  type?: string;
-  className?: string;
-  style?: string;
-} {
-  const classMatch = htmlString.match(/class="([^"]*)"/);
-  const styleMatch = htmlString.match(/style="([^"]*)"/);
-  const typeMatch = htmlString.match(/data-block-type="([^"]*)"/);
-
-  return {
-    type: typeMatch?.[1],
-    className: classMatch?.[1],
-    style: styleMatch?.[1]
-  };
-}
-
-/**
- * Extracts title from custom block content
- * @param content Block content
- * @returns Title and remaining content
- */
-export function extractBlockTitle(content: string): {
-  title?: string;
-  content: string;
-} {
-  // Look for title patterns at the beginning
-  const titlePatterns = [
-    /^<h[3-6][^>]*>([^<]+)<\/h[3-6]>/i,
-    /^<strong[^>]*>([^<]+)<\/strong>/i,
-    /^<b[^>]*>([^<]+)<\/b>/i,
-    /^\*\*([^*]+)\*\*/,
-    /^__([^_]+)__/
-  ];
-
-  for (const pattern of titlePatterns) {
-    const match = content.match(pattern);
-    if (match) {
-      const title = match[1].trim();
-      const remainingContent = content.replace(pattern, '').trim();
-      return { title, content: remainingContent };
-    }
-  }
-
-  return { content };
-}
-
-/**
- * Validates HTML block structure
- * @param htmlString HTML string
- * @returns True if valid custom block
- */
-export function validateHtmlBlock(htmlString: string): boolean {
-  // Check for required custom-block class
-  if (!htmlString.includes('custom-block')) {
-    return false;
-  }
-
-  // Check for proper div structure
-  const divPattern = /<div[^>]*>[\s\S]*<\/div>/i;
-  if (!divPattern.test(htmlString)) {
-    return false;
-  }
-
-  // Check for valid block type
-  const validTypes = ['tip', 'warning', 'danger', 'details'];
-  const hasValidType = validTypes.some(type =>
-    htmlString.includes(`class="[^"]*${type}[^"]*"`) ||
-    htmlString.includes(`class="[^"]*custom-block[^"]*${type}[^"]*"`)
-  );
-
-  return hasValidType;
-}
-
-/**
- * Cleans and sanitizes HTML block content
- * @param content Raw content
- * @returns Cleaned content
- */
-export function sanitizeBlockContent(content: string): string {
-  return content
-    .trim()
-    .replace(/^\s*[\r\n]/gm, '') // Remove empty lines at start
-    .replace(/[\r\n]\s*$/gm, '') // Remove empty lines at end
-    .replace(/\s+/g, ' ') // Normalize whitespace
-    .trim();
-}
-
-/**
- * Transforms legacy VitePress block syntax to standard HTML
- * @param content Markdown content
- * @returns Content with transformed blocks
- */
-export function transformLegacyBlocks(content: string): string {
-  // Transform VitePress-style blocks
-  return content
-    .replace(/::: tip\s*([^\n]*)\n([\s\S]*?):::/gi,
-      (_match, title, body) =>
-        `<div class="tip custom-block">${title ? `<strong>${title}</strong>\n` : ''}${body.trim()}</div>`
-    )
-    .replace(/::: warning\s*([^\n]*)\n([\s\S]*?):::/gi,
-      (_match, title, body) =>
-        `<div class="warning custom-block">${title ? `<strong>${title}</strong>\n` : ''}${body.trim()}</div>`
-    )
-    .replace(/::: danger\s*([^\n]*)\n([\s\S]*?):::/gi,
-      (_match, title, body) =>
-        `<div class="danger custom-block">${title ? `<strong>${title}</strong>\n` : ''}${body.trim()}</div>`
-    )
-    .replace(/::: details\s*([^\n]*)\n([\s\S]*?):::/gi,
-      (_match, title, body) =>
-        `<div class="details custom-block">${title ? `<strong>${title}</strong>\n` : ''}${body.trim()}</div>`
-    );
-}
-
-export default {
-  processHtmlBlocks,
-  hasHtmlBlocks,
-  preprocessHtmlBlocks,
-  getHtmlBlocksOverrides,
-  parseCustomBlockAttributes,
-  extractBlockTitle,
-  validateHtmlBlock,
-  sanitizeBlockContent,
-  transformLegacyBlocks
-};
diff --git a/docs/src/lib/markdown/plugins/links.tsx b/docs/src/lib/markdown/plugins/links.tsx
deleted file mode 100644
index b55cd7b8..00000000
--- a/docs/src/lib/markdown/plugins/links.tsx
+++ /dev/null
@@ -1,340 +0,0 @@
-import React from 'react';
-import type { MarkdownProcessorOptions, LinkComponentProps } from '../types';
-import {
-  isExternalUrl,
-  isAnchorLink,
-  resolveRouterHref,
-  isMarkdownFile,
-  filePathToUrlPath
-} from '../utils/paths';
-
-/**
- * Links Plugin for markdown processing
- * Handles link processing, routing, and external link handling
- */
-
-/**
- * Processes links in markdown content
- * @param content Markdown content
- * @param options Processing options
- * @returns Processed content with links handled
- */
-export function processLinks(
-  content: string,
-  options?: MarkdownProcessorOptions
-): string {
-  if (!options?.enableLinkProcessing) {
-    return content;
-  }
-
-  // Process markdown links [text](url)
-  return content.replace(
-    /\[([^\]]+)\]\(([^)]+)\)/g,
-    (_match, text, url) => {
-      const processedUrl = processLinkUrl(url, options);
-      return `[${text}](${processedUrl})`;
-    }
-  );
-}
-
-/**
- * Processes a single link URL
- * @param url Original URL
- * @param options Processing options
- * @returns Processed URL
- */
-function processLinkUrl(url: string, options?: MarkdownProcessorOptions): string {
-  // Don't process external URLs or anchors
-  if (isExternalUrl(url) || isAnchorLink(url)) {
-    return url;
-  }
-
-  // Convert markdown file paths to URL paths
-  if (isMarkdownFile(url)) {
-    return filePathToUrlPath(url);
-  }
-
-  // Add base URL if specified
-  if (options?.baseUrl && !url.startsWith('/')) {
-    return `${options.baseUrl.replace(/\/$/, '')}/${url}`;
-  }
-
-  return url;
-}
-
-/**
- * Link component for markdown-to-jsx
- */
-export function LinkComponent({
-  href = '',
-  children,
-  className = '',
-  title,
-  ...props
-}: LinkComponentProps & React.AnchorHTMLAttributes<HTMLAnchorElement>) {
-  const isExternal = isExternalUrl(href);
-  const isAnchor = isAnchorLink(href);
-
-  // Handle external links
-  if (isExternal) {
-    return (
-      <a
-        href={href}
-        className={`markdown-link markdown-link--external ${className}`}
-        title={title}
-        target="_blank"
-        rel="noopener noreferrer"
-        {...props}
-      >
-        {children}
-        <ExternalLinkIcon />
-      </a>
-    );
-  }
-
-  // Handle anchor links
-  if (isAnchor) {
-    const handleAnchorClick = (e: React.MouseEvent<HTMLAnchorElement>) => {
-      e.preventDefault();
-      const targetId = href.substring(1);
-      const element = document.getElementById(targetId);
-
-      if (element) {
-        element.scrollIntoView({
-          behavior: 'smooth',
-          block: 'start'
-        });
-
-        // Update URL hash
-        if (window.history.pushState) {
-          window.history.pushState(null, '', href);
-        }
-      }
-    };
-
-    return (
-      <a
-        href={href}
-        className={`markdown-link markdown-link--anchor ${className}`}
-        title={title}
-        onClick={handleAnchorClick}
-        {...props}
-      >
-        {children}
-      </a>
-    );
-  }
-
-  // Handle internal links (React Router navigation)
-  const handleInternalClick = (e: React.MouseEvent<HTMLAnchorElement>) => {
-    // Check if React Router is available
-    if (typeof window !== 'undefined' && (window as any).routerNavigate) {
-      e.preventDefault();
-      (window as any).routerNavigate(href);
-    }
-    // If React Router is not available, let the browser handle it
-  };
-
-  return (
-    <a
-      href={href}
-      className={`markdown-link markdown-link--internal ${className}`}
-      title={title}
-      onClick={handleInternalClick}
-      {...props}
-    >
-      {children}
-    </a>
-  );
-}
-
-/**
- * External link icon component
- */
-function ExternalLinkIcon() {
-  return (
-    <svg
-      className="external-link-icon"
-      viewBox="0 0 24 24"
-      fill="none"
-      stroke="currentColor"
-      strokeWidth="2"
-      strokeLinecap="round"
-      strokeLinejoin="round"
-      aria-hidden="true"
-    >
-      <path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6" />
-      <polyline points="15,3 21,3 21,9" />
-      <line x1="10" y1="14" x2="21" y2="3" />
-    </svg>
-  );
-}
-
-/**
- * Checks if content contains links
- * @param content Markdown content
- * @returns True if contains links
- */
-export function hasLinks(content: string): boolean {
-  return /\[([^\]]+)\]\(([^)]+)\)/g.test(content);
-}
-
-/**
- * Pre-processes markdown content for links
- * @param content Raw markdown content
- * @param options Processing options
- * @returns Pre-processed content
- */
-export function preprocessLinks(
-  content: string,
-  options?: MarkdownProcessorOptions
-): string {
-  if (!options?.enableLinkProcessing) {
-    return content;
-  }
-
-  return processLinks(content, options);
-}
-
-/**
- * Generates markdown overrides for link processing
- * @param options Processing options
- * @returns Markdown-to-jsx overrides
- */
-export function getLinksOverrides(options?: MarkdownProcessorOptions) {
-  if (!options?.enableLinkProcessing) {
-    return {};
-  }
-
-  return {
-    a: (props: any) => <LinkComponent {...props} />
-  };
-}
-
-/**
- * Extracts all links from markdown content
- * @param content Markdown content
- * @returns Array of link objects
- */
-export function extractLinks(content: string): Array<{
-  text: string;
-  url: string;
-  isExternal: boolean;
-  isAnchor: boolean;
-}> {
-  const links: Array<{
-    text: string;
-    url: string;
-    isExternal: boolean;
-    isAnchor: boolean;
-  }> = [];
-
-  const linkRegex = /\[([^\]]+)\]\(([^)]+)\)/g;
-  let match;
-
-  while ((match = linkRegex.exec(content)) !== null) {
-    const [, text, url] = match;
-    links.push({
-      text,
-      url,
-      isExternal: isExternalUrl(url),
-      isAnchor: isAnchorLink(url)
-    });
-  }
-
-  return links;
-}
-
-/**
- * Validates link URLs
- * @param url URL to validate
- * @returns True if valid URL
- */
-export function validateLinkUrl(url: string): boolean {
-  if (!url || url.trim() === '') {
-    return false;
-  }
-
-  // Check for external URLs
-  if (isExternalUrl(url)) {
-    try {
-      new URL(url);
-      return true;
-    } catch {
-      return false;
-    }
-  }
-
-  // Check for anchor links
-  if (isAnchorLink(url)) {
-    return url.length > 1; // Must have content after #
-  }
-
-  // Check for relative/absolute paths
-  return url.length > 0;
-}
-
-/**
- * Normalizes link URLs
- * @param url Original URL
- * @param baseUrl Base URL for relative links
- * @returns Normalized URL
- */
-export function normalizeLinkUrl(url: string, baseUrl?: string): string {
-  if (!url) return '';
-
-  // Don't modify external URLs or anchors
-  if (isExternalUrl(url) || isAnchorLink(url)) {
-    return url;
-  }
-
-  // Convert markdown files to URL paths
-  if (isMarkdownFile(url)) {
-    return filePathToUrlPath(url);
-  }
-
-  // Add base URL for relative paths
-  if (baseUrl && !url.startsWith('/')) {
-    const cleanBaseUrl = baseUrl.replace(/\/$/, '');
-    return `${cleanBaseUrl}/${url}`;
-  }
-
-  return url;
-}
-
-/**
- * Transforms relative links to absolute based on current path
- * @param content Markdown content
- * @param currentPath Current file path
- * @param baseUrl Base URL
- * @returns Content with transformed links
- */
-export function transformRelativeLinks(
-  content: string,
-  currentPath: string,
-  baseUrl?: string
-): string {
-  return content.replace(
-    /\[([^\]]+)\]\(([^)]+)\)/g,
-    (match, text, url) => {
-      if (isExternalUrl(url) || isAnchorLink(url)) {
-        return match;
-      }
-
-      const resolvedUrl = resolveRouterHref(url, currentPath, baseUrl);
-      return `[${text}](${resolvedUrl})`;
-    }
-  );
-}
-
-export default {
-  processLinks,
-  LinkComponent,
-  hasLinks,
-  preprocessLinks,
-  getLinksOverrides,
-  extractLinks,
-  validateLinkUrl,
-  normalizeLinkUrl,
-  transformRelativeLinks
-};
diff --git a/docs/src/lib/markdown/plugins/mermaid.tsx b/docs/src/lib/markdown/plugins/mermaid.tsx
deleted file mode 100644
index f76a8b15..00000000
--- a/docs/src/lib/markdown/plugins/mermaid.tsx
+++ /dev/null
@@ -1,262 +0,0 @@
-import React from 'react';
-import type { MarkdownProcessorOptions } from '../types';
-import Mermaid from '../../../components/Mermaid';
-
-/**
- * Processes Mermaid code blocks in markdown content
- * Converts ```mermaid blocks to Mermaid React components
- *
- * @param content The markdown content to process
- * @param options Processing options
- * @returns Processed content with Mermaid placeholders
- */
-export function processMermaid(
-  content: string,
-  _options?: MarkdownProcessorOptions
-): string {
-  // Find all mermaid code blocks
-  const mermaidRegex = /```mermaid\n([\s\S]*?)\n```/g;
-  let processedContent = content;
-  let match;
-  let diagramIndex = 0;
-
-  while ((match = mermaidRegex.exec(content)) !== null) {
-    const [fullMatch, diagramCode] = match;
-    const diagramId = `mermaid-diagram-${diagramIndex++}`;
-
-    // Clean up the diagram code
-    const cleanDiagramCode = diagramCode.trim();
-
-    // Create placeholder that will be replaced during rendering
-    const placeholder = `<MERMAID_DIAGRAM_${diagramId}>${cleanDiagramCode}</MERMAID_DIAGRAM_${diagramId}>`;
-
-    processedContent = processedContent.replace(fullMatch, placeholder);
-  }
-
-  return processedContent;
-}
-
-/**
- * Creates a component override for rendering Mermaid diagrams in markdown-to-jsx
- *
- * @returns Component overrides object for markdown-to-jsx
- */
-export function createMermaidOverrides() {
-  return {
-    // Handle custom Mermaid placeholder elements
-    MERMAID_DIAGRAM_0: ({ children }: { children: string }) => (
-      <Mermaid chart={children} id="mermaid-diagram-0" />
-    ),
-    MERMAID_DIAGRAM_1: ({ children }: { children: string }) => (
-      <Mermaid chart={children} id="mermaid-diagram-1" />
-    ),
-    MERMAID_DIAGRAM_2: ({ children }: { children: string }) => (
-      <Mermaid chart={children} id="mermaid-diagram-2" />
-    ),
-    MERMAID_DIAGRAM_3: ({ children }: { children: string }) => (
-      <Mermaid chart={children} id="mermaid-diagram-3" />
-    ),
-    MERMAID_DIAGRAM_4: ({ children }: { children: string }) => (
-      <Mermaid chart={children} id="mermaid-diagram-4" />
-    ),
-    // Add more as needed or use dynamic generation
-  };
-}
-
-/**
- * Creates dynamic Mermaid overrides for any number of diagrams
- *
- * @param content Processed markdown content
- * @returns Dynamic component overrides
- */
-export function createDynamicMermaidOverrides(content: string) {
-  const overrides: Record<string, React.ComponentType<{ children: string }>> = {};
-
-  // Find all mermaid placeholders
-  const placeholderRegex = /<MERMAID_DIAGRAM_(mermaid-diagram-\d+)>([\s\S]*?)<\/MERMAID_DIAGRAM_\1>/g;
-  let match;
-
-  while ((match = placeholderRegex.exec(content)) !== null) {
-    const [, diagramId, diagramCode] = match;
-    const componentName = `MERMAID_DIAGRAM_${diagramId.replace(/-/g, '_')}`;
-
-    overrides[componentName] = ({ children }: { children: string }) => (
-      <Mermaid chart={children || diagramCode} id={diagramId} />
-    );
-  }
-
-  return overrides;
-}
-
-/**
- * Alternative approach: Replace mermaid blocks with HTML that can be processed by markdown-to-jsx
- *
- * @param content The markdown content to process
- * @returns Content with mermaid blocks replaced by custom HTML elements
- */
-export function processMermaidAsHtml(content: string): string {
-  // More flexible regex that handles different line endings and whitespace
-  const mermaidRegex = /```mermaid\r?\n([\s\S]*?)\r?\n```/g;
-  let processedContent = content;
-  let diagramIndex = 0;
-
-
-
-  processedContent = processedContent.replace(mermaidRegex, (_match, diagramCode) => {
-    const diagramId = `mermaid-diagram-${diagramIndex++}`;
-    const cleanDiagramCode = diagramCode.trim();
-
-
-
-    // Create a div element that can be overridden by markdown-to-jsx
-    return `<div class="mermaid-diagram" data-id="${diagramId}" data-chart="${encodeURIComponent(cleanDiagramCode)}"></div>`;
-  });
-
-  return processedContent;
-}
-
-/**
- * Creates component overrides for the HTML approach
- */
-export function createMermaidHtmlOverrides() {
-  return {
-    div: (props: any) => {
-      // Check if this is a mermaid diagram div
-      if (props.className === 'mermaid-diagram' && props['data-chart']) {
-        const chart = props['data-chart'] ? decodeURIComponent(props['data-chart']) : '';
-        return <Mermaid chart={chart} id={props['data-id']} />;
-      }
-      // Return normal div for non-mermaid divs
-      return <div {...props} />;
-    }
-  };
-}
-
-/**
- * Validates Mermaid syntax
- *
- * @param diagramCode Mermaid diagram code
- * @returns Validation result
- */
-export function validateMermaidSyntax(diagramCode: string): {
-  isValid: boolean;
-  errors: string[];
-  warnings: string[];
-} {
-  const errors: string[] = [];
-  const warnings: string[] = [];
-
-  try {
-    // Basic syntax checks
-    const trimmedCode = diagramCode.trim();
-
-    if (!trimmedCode) {
-      errors.push('Empty diagram code');
-      return { isValid: false, errors, warnings };
-    }
-
-    // Check for common diagram types
-    const supportedTypes = [
-      'graph', 'flowchart', 'sequenceDiagram', 'classDiagram',
-      'stateDiagram', 'gantt', 'pie', 'gitgraph', 'erDiagram',
-      'journey', 'requirementDiagram'
-    ];
-
-    const firstLine = trimmedCode.split('\n')[0].toLowerCase();
-    const hasKnownType = supportedTypes.some(type =>
-      firstLine.includes(type.toLowerCase())
-    );
-
-    if (!hasKnownType) {
-      warnings.push('Diagram type not recognized, ensure it starts with a valid Mermaid diagram declaration');
-    }
-
-    // Check for balanced brackets/parentheses
-    const brackets = { '(': 0, '[': 0, '{': 0 };
-    for (const char of trimmedCode) {
-      if (char === '(') brackets['(']++;
-      if (char === ')') brackets['(']--;
-      if (char === '[') brackets['[']++;
-      if (char === ']') brackets['[']--;
-      if (char === '{') brackets['{']++;
-      if (char === '}') brackets['{']--;
-    }
-
-    Object.entries(brackets).forEach(([bracket, count]) => {
-      if (count !== 0) {
-        errors.push(`Unbalanced ${bracket} brackets`);
-      }
-    });
-
-  } catch (error) {
-    errors.push(`Syntax validation error: ${(error as Error).message}`);
-  }
-
-  return {
-    isValid: errors.length === 0,
-    errors,
-    warnings
-  };
-}
-
-/**
- * Extracts all Mermaid diagrams from content
- *
- * @param content Markdown content
- * @returns Array of diagram objects
- */
-export function extractMermaidDiagrams(content: string): Array<{
-  id: string;
-  code: string;
-  type: string;
-  validation: ReturnType<typeof validateMermaidSyntax>;
-}> {
-  const diagrams: Array<{
-    id: string;
-    code: string;
-    type: string;
-    validation: ReturnType<typeof validateMermaidSyntax>;
-  }> = [];
-
-  const mermaidRegex = /```mermaid\n([\s\S]*?)\n```/g;
-  let match;
-  let index = 0;
-
-  while ((match = mermaidRegex.exec(content)) !== null) {
-    const [, diagramCode] = match;
-    const cleanCode = diagramCode.trim();
-    const firstLine = cleanCode.split('\n')[0].toLowerCase();
-
-    // Determine diagram type
-    let type = 'unknown';
-    if (firstLine.includes('graph') || firstLine.includes('flowchart')) type = 'flowchart';
-    else if (firstLine.includes('sequencediagram')) type = 'sequence';
-    else if (firstLine.includes('classdiagram')) type = 'class';
-    else if (firstLine.includes('statediagram')) type = 'state';
-    else if (firstLine.includes('gantt')) type = 'gantt';
-    else if (firstLine.includes('pie')) type = 'pie';
-    else if (firstLine.includes('gitgraph')) type = 'gitgraph';
-    else if (firstLine.includes('erdiagram')) type = 'er';
-    else if (firstLine.includes('journey')) type = 'journey';
-    else if (firstLine.includes('requirementdiagram')) type = 'requirement';
-
-    diagrams.push({
-      id: `mermaid-diagram-${index++}`,
-      code: cleanCode,
-      type,
-      validation: validateMermaidSyntax(cleanCode)
-    });
-  }
-
-  return diagrams;
-}
-
-export default {
-  processMermaid,
-  processMermaidAsHtml,
-  createMermaidOverrides,
-  createDynamicMermaidOverrides,
-  createMermaidHtmlOverrides,
-  validateMermaidSyntax,
-  extractMermaidDiagrams
-};
diff --git a/docs/src/lib/markdown/plugins/toc.tsx b/docs/src/lib/markdown/plugins/toc.tsx
deleted file mode 100644
index 2fe96270..00000000
--- a/docs/src/lib/markdown/plugins/toc.tsx
+++ /dev/null
@@ -1,186 +0,0 @@
-import React from 'react';
-import type { TocItem, MarkdownProcessorOptions } from '../types';
-import { generateToc } from '../utils/headings';
-import { removeTocPlaceholder } from '../utils/frontmatter';
-import { parseFrontmatter } from '../utils/frontmatter';
-
-/**
- * TOC Plugin for markdown processing
- * Handles [[toc]] placeholder and generates table of contents
- */
-
-/**
- * Processes TOC in markdown content
- * @param content Markdown content
- * @param options Processing options
- * @returns Processed content and TOC data
- */
-export function processToc(
-  content: string,
-  options?: MarkdownProcessorOptions
-): {
-  content: string;
-  toc: TocItem[] | undefined;
-  hasToc: boolean;
-} {
-  const { hasToc } = parseFrontmatter(content);
-
-  if (!hasToc && !options?.enableToc) {
-    return {
-      content,
-      toc: undefined,
-      hasToc: false
-    };
-  }
-
-  // Remove [[toc]] placeholder from content
-  const processedContent = removeTocPlaceholder(content);
-
-  // Generate TOC from headings
-  const tocDepth = options?.tocDepth || { min: 2, max: 4 };
-  const toc = generateToc(processedContent, tocDepth.min, tocDepth.max);
-
-  return {
-    content: processedContent,
-    toc: toc.length > 0 ? toc : undefined,
-    hasToc: true
-  };
-}
-
-/**
- * Checks if content contains TOC placeholder
- * @param content Markdown content
- * @returns True if contains [[toc]], false otherwise
- */
-export function hasTocPlaceholder(content: string): boolean {
-  return /\[\[toc\]\]/i.test(content);
-}
-
-/**
- * Replaces [[toc]] placeholder with a React component placeholder
- * This is used during markdown-to-jsx processing
- * @param content Markdown content
- * @returns Content with TOC placeholder replaced
- */
-export function replaceTocPlaceholder(content: string): string {
-  return content.replace(
-    /\[\[toc\]\]/gi,
-    '<TocPlaceholder />'
-  );
-}
-
-/**
- * TOC Placeholder component that gets replaced during processing
- */
-export function TocPlaceholder() {
-  return <div className="toc-placeholder" />;
-}
-
-/**
- * Generates markdown overrides for TOC processing
- * @param toc TOC data
- * @returns Markdown-to-jsx overrides
- */
-export function getTocOverrides(_toc?: TocItem[]) {
-  return {
-    TocPlaceholder: () => {
-      // This will be replaced by the actual TOC component
-      return null;
-    }
-  };
-}
-
-/**
- * Pre-processes markdown content for TOC
- * This runs before markdown-to-jsx processing
- * @param content Raw markdown content
- * @param options Processing options
- * @returns Pre-processed content
- */
-export function preprocessToc(
-  content: string,
-  options?: MarkdownProcessorOptions
-): string {
-  if (!options?.enableToc && !hasTocPlaceholder(content)) {
-    return content;
-  }
-
-  // Replace [[toc]] with component placeholder
-  return replaceTocPlaceholder(content);
-}
-
-/**
- * Post-processes rendered content to inject TOC
- * @param renderedContent Rendered React content
- * @param toc TOC data
- * @returns Content with TOC injected
- */
-export function postprocessToc(
-  renderedContent: React.ReactNode,
-  toc?: TocItem[]
-): React.ReactNode {
-  if (!toc || toc.length === 0) {
-    return renderedContent;
-  }
-
-  // This would need to be implemented based on how we want to inject TOC
-  // For now, return the original content
-  return renderedContent;
-}
-
-/**
- * Validates TOC structure
- * @param toc TOC items
- * @returns True if valid, false otherwise
- */
-export function validateToc(toc: TocItem[]): boolean {
-  if (!Array.isArray(toc)) {
-    return false;
-  }
-
-  for (const item of toc) {
-    if (!item.id || !item.text || typeof item.level !== 'number') {
-      return false;
-    }
-
-    if (item.children && !validateToc(item.children)) {
-      return false;
-    }
-  }
-
-  return true;
-}
-
-/**
- * Filters TOC items by depth
- * @param toc TOC items
- * @param maxDepth Maximum depth to include
- * @returns Filtered TOC items
- */
-export function filterTocByDepth(toc: TocItem[], maxDepth: number): TocItem[] {
-  return toc.map(item => {
-    const filtered: TocItem = {
-      id: item.id,
-      text: item.text,
-      level: item.level
-    };
-
-    if (item.children && item.level < maxDepth) {
-      filtered.children = filterTocByDepth(item.children, maxDepth);
-    }
-
-    return filtered;
-  });
-}
-
-export default {
-  processToc,
-  hasTocPlaceholder,
-  replaceTocPlaceholder,
-  TocPlaceholder,
-  getTocOverrides,
-  preprocessToc,
-  postprocessToc,
-  validateToc,
-  filterTocByDepth
-};
diff --git a/docs/src/lib/markdown/processor.tsx b/docs/src/lib/markdown/processor.tsx
deleted file mode 100644
index 90a59201..00000000
--- a/docs/src/lib/markdown/processor.tsx
+++ /dev/null
@@ -1,254 +0,0 @@
-import type {
-  MarkdownProcessorOptions,
-  ProcessedMarkdown,
-  TocItem,
-  FrontmatterData
-} from './types';
-import { parseFrontmatter } from './utils/frontmatter';
-import { generateToc, extractHeadings } from './utils/headings';
-import { processToc } from './plugins/toc';
-import { processCodeFocus } from './plugins/codeFocus';
-import { processHtmlBlocks } from './plugins/htmlBlocks';
-import { processLinks } from './plugins/links';
-import { processMermaidAsHtml } from './plugins/mermaid';
-
-/**
- * Main markdown processor
- * Orchestrates all plugins and transformations
- */
-export class MarkdownProcessor {
-  private options: MarkdownProcessorOptions;
-
-  constructor(options: MarkdownProcessorOptions = {}) {
-    this.options = {
-      enableToc: true,
-      enableCodeFocus: true,
-      enableHtmlBlocks: true,
-      enableLinkProcessing: true,
-      tocDepth: { min: 2, max: 4 },
-      ...options
-    };
-  }
-
-  /**
-   * Processes markdown content through all enabled plugins
-   * @param content Raw markdown content
-   * @returns Processed markdown data
-   */
-  process(content: string): ProcessedMarkdown {
-    try {
-      // Step 1: Parse frontmatter
-      const { content: rawContent, frontmatter, hasToc } = parseFrontmatter(content);
-
-      // Step 2: Pre-process content through plugins
-      let processedContent = rawContent;
-
-      // Process Mermaid diagrams FIRST (before any other processing including markdown)
-      processedContent = processMermaidAsHtml(processedContent);
-
-      // Process TOC
-      if (this.options.enableToc && hasToc) {
-        const tocResult = processToc(processedContent, this.options);
-        processedContent = tocResult.content;
-      }
-
-      // Process code focus
-      if (this.options.enableCodeFocus) {
-        processedContent = processCodeFocus(processedContent, this.options);
-      }
-
-      // Process HTML blocks
-      if (this.options.enableHtmlBlocks) {
-        processedContent = processHtmlBlocks(processedContent, this.options);
-      }
-
-      // Process links
-      if (this.options.enableLinkProcessing) {
-        processedContent = processLinks(processedContent, this.options);
-      }
-
-      // Step 3: Generate TOC if needed
-      let toc: TocItem[] | undefined;
-      if ((this.options.enableToc && hasToc) || this.options.enableToc) {
-        const tocDepth = this.options.tocDepth || { min: 2, max: 4 };
-        toc = generateToc(processedContent, tocDepth.min, tocDepth.max);
-
-        // Add heading IDs for anchor links
-        if (toc.length > 0) {
-          // Note: We don't modify the content string here because markdown-to-jsx
-          // doesn't support the {#id} syntax and renders it as text.
-          // Heading IDs are generated by the custom Heading components instead.
-        }
-      }
-
-      // Step 4: Return processed data (content as string, will be rendered later)
-      return {
-        content: processedContent,
-        toc: toc && toc.length > 0 ? toc : undefined,
-        frontmatter
-      };
-
-    } catch (error) {
-      console.error('Error processing markdown:', error);
-
-      // Return fallback data
-      return {
-        content,
-        toc: undefined,
-        frontmatter: {}
-      };
-    }
-  }
-
-  /**
-   * Updates processor options
-   * @param options New options to merge
-   */
-  updateOptions(options: Partial<MarkdownProcessorOptions>) {
-    this.options = { ...this.options, ...options };
-  }
-
-  /**
-   * Gets current processor options
-   * @returns Current options
-   */
-  getOptions(): MarkdownProcessorOptions {
-    return { ...this.options };
-  }
-}
-
-/**
- * Convenience function for processing markdown
- * @param content Raw markdown content
- * @param options Processing options
- * @returns Processed markdown data
- */
-export function processMarkdown(
-  content: string,
-  options?: MarkdownProcessorOptions
-): ProcessedMarkdown {
-  const processor = new MarkdownProcessor(options);
-  return processor.process(content);
-}
-
-/**
- * Pre-processes markdown content for rendering
- * This runs all transformations but doesn't render to React
- * @param content Raw markdown content
- * @param options Processing options
- * @returns Pre-processed content string
- */
-export function preprocessMarkdown(
-  content: string,
-  options?: MarkdownProcessorOptions
-): {
-  content: string;
-  toc?: TocItem[];
-  frontmatter: FrontmatterData;
-} {
-  const processed = processMarkdown(content, options);
-
-  return {
-    content: typeof processed.content === 'string' ? processed.content : content,
-    toc: processed.toc,
-    frontmatter: processed.frontmatter || {}
-  };
-}
-
-/**
- * Validates markdown content
- * @param content Markdown content to validate
- * @returns Validation result
- */
-export function validateMarkdown(content: string): {
-  isValid: boolean;
-  errors: string[];
-  warnings: string[];
-} {
-  const errors: string[] = [];
-  const warnings: string[] = [];
-
-  try {
-    // Check if content is empty
-    if (!content || content.trim().length === 0) {
-      warnings.push('Content is empty');
-    }
-
-    // Try to parse frontmatter
-    try {
-      parseFrontmatter(content);
-    } catch (error) {
-      errors.push(`Frontmatter parsing error: ${(error as Error).message}`);
-    }
-
-    // Check for common markdown issues
-    if (content.includes('[[toc]]') && !content.match(/^#{1,6}\s+/m)) {
-      warnings.push('TOC placeholder found but no headings detected');
-    }
-
-    // Check for unmatched brackets in links
-    const linkMatches = content.match(/\[[^\]]*\]/g) || [];
-    const urlMatches = content.match(/\([^)]*\)/g) || [];
-
-    if (linkMatches.length !== urlMatches.length) {
-      warnings.push('Possible unmatched markdown link syntax');
-    }
-
-  } catch (error) {
-    errors.push(`Validation error: ${(error as Error).message}`);
-  }
-
-  return {
-    isValid: errors.length === 0,
-    errors,
-    warnings
-  };
-}
-
-/**
- * Extracts metadata from markdown content
- * @param content Markdown content
- * @returns Extracted metadata
- */
-export function extractMarkdownMetadata(content: string): {
-  frontmatter: FrontmatterData;
-  headingCount: number;
-  wordCount: number;
-  readingTime: number; // in minutes
-  hasCodeBlocks: boolean;
-  hasLinks: boolean;
-  hasToc: boolean;
-} {
-  const { frontmatter, hasToc } = parseFrontmatter(content);
-
-  // Extract content without frontmatter
-  const cleanContent = content.replace(/^---[\s\S]*?---\n?/, '');
-
-  // Count words (approximate)
-  const words = cleanContent.match(/\b\w+\b/g) || [];
-  const wordCount = words.length;
-
-  // Estimate reading time (average 200 words per minute)
-  const readingTime = Math.ceil(wordCount / 200);
-
-  // Count headings
-  const headings = extractHeadings(cleanContent);
-
-  // Check for code blocks
-  const hasCodeBlocks = /```[\s\S]*?```/g.test(cleanContent);
-
-  // Check for links
-  const hasLinks = /\[([^\]]+)\]\(([^)]+)\)/g.test(cleanContent);
-
-  return {
-    frontmatter,
-    headingCount: headings.length,
-    wordCount,
-    readingTime,
-    hasCodeBlocks,
-    hasLinks,
-    hasToc
-  };
-}
-
-export default MarkdownProcessor;
diff --git a/docs/src/lib/markdown/styles.css b/docs/src/lib/markdown/styles.css
deleted file mode 100644
index fdea683e..00000000
--- a/docs/src/lib/markdown/styles.css
+++ /dev/null
@@ -1,626 +0,0 @@
-/* EasyP Markdown Library Styles */
-
-/* Base markdown content styles */
-.markdown-content {
-  max-width: 100%;
-  line-height: 1.7;
-  color: #cbd5e1;
-  /* Slate 300 - softer than pure white */
-  font-size: 1rem;
-}
-
-.markdown-body {
-  min-width: 0;
-}
-
-.markdown-header {
-  margin-bottom: 2.5rem;
-  padding-bottom: 1.5rem;
-  border-bottom: 1px solid rgba(255, 255, 255, 0.08);
-}
-
-.markdown-title {
-  font-size: 2.5rem;
-  font-weight: 700;
-  margin: 0 0 0.75rem 0;
-  color: #f8fafc;
-  /* Slate 50 */
-  letter-spacing: -0.025em;
-  line-height: 1.2;
-}
-
-.markdown-description {
-  font-size: 1.125rem;
-  color: #94a3b8;
-  /* Slate 400 */
-  margin: 0;
-  line-height: 1.6;
-}
-
-/* Table of Contents styles - Minimal Native Theme */
-.toc-container {
-  position: sticky;
-  top: 2rem;
-  max-height: calc(100vh - 4rem);
-  overflow-y: auto;
-  padding: 0;
-  /* Removed padding to sit flush */
-
-  /* Removed glassmorphism box styles */
-  background: transparent;
-  border: none;
-  border-radius: 0;
-
-  /* Custom scrollbar */
-  scrollbar-width: thin;
-  scrollbar-color: rgba(148, 163, 184, 0.3) transparent;
-}
-
-.toc-container::-webkit-scrollbar {
-  width: 4px;
-}
-
-.toc-container::-webkit-scrollbar-track {
-  background: transparent;
-}
-
-.toc-container::-webkit-scrollbar-thumb {
-  background: rgba(148, 163, 184, 0.3);
-  border-radius: 2px;
-}
-
-.toc-container::-webkit-scrollbar-thumb:hover {
-  background: rgba(148, 163, 184, 0.5);
-}
-
-.markdown-toc {
-  min-width: 200px;
-}
-
-.toc-title {
-  font-size: 0.75rem;
-  font-weight: 600;
-  margin: 0 0 1rem 1rem;
-  /* Align with text padding */
-  color: #94a3b8;
-  /* Slate 400 */
-  text-transform: uppercase;
-  letter-spacing: 0.05em;
-}
-
-.toc-list {
-  list-style: none;
-  margin: 0;
-  padding: 0;
-}
-
-.toc-list--root {
-  margin: 0;
-  /* Optional: Add a subtle track line on the left */
-  border-left: 1px solid rgba(255, 255, 255, 0.05);
-}
-
-.toc-list--level-3 {
-  padding-left: 0;
-  /* Reset padding, handled by margin/indent */
-}
-
-.toc-list--level-4 {
-  padding-left: 0;
-}
-
-.toc-item {
-  margin: 0;
-}
-
-.toc-item--level-2 {
-  font-weight: 500;
-}
-
-.toc-item--level-3 {
-  font-weight: 400;
-  font-size: 0.8125rem;
-}
-
-.toc-item--level-4 {
-  font-weight: 400;
-  font-size: 0.75rem;
-}
-
-.toc-link {
-  display: block;
-  color: #64748b;
-  /* Slate 500 - Muted by default */
-  text-decoration: none;
-  padding: 0.375rem 1rem;
-  border-left: 2px solid transparent;
-  /* Active indicator placeholder */
-  margin-left: -1px;
-  /* Overlap the root border */
-  transition: all 0.2s ease;
-  line-height: 1.4;
-  font-size: 0.875rem;
-}
-
-/* Indentation for levels */
-.toc-item--level-3 .toc-link {
-  padding-left: 1.75rem;
-}
-
-.toc-item--level-4 .toc-link {
-  padding-left: 2.5rem;
-}
-
-.toc-link:hover {
-  color: #cbd5e1;
-  /* Slate 300 */
-  border-left-color: #475569;
-  /* Slate 600 */
-}
-
-.toc-link--active {
-  color: #60a5fa;
-  /* Blue 400 */
-  border-left-color: #3b82f6;
-  /* Blue 500 */
-  background-color: transparent;
-  /* No background */
-  font-weight: 500;
-}
-
-/* Heading styles */
-.markdown-heading {
-  position: relative;
-  scroll-margin-top: 6rem;
-  /* Increased for sticky header */
-}
-
-.markdown-heading--with-anchor:hover .heading-anchor {
-  opacity: 1;
-}
-
-.heading-content {
-  display: inline-block;
-}
-
-.heading-anchor {
-  position: absolute;
-  left: -1.5rem;
-  top: 50%;
-  transform: translateY(-50%);
-  opacity: 0;
-  color: #64748b;
-  text-decoration: none;
-  width: 1rem;
-  height: 1rem;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  transition: all 0.2s ease;
-}
-
-.heading-anchor:hover {
-  color: #3b82f6;
-}
-
-.heading-anchor-icon {
-  width: 1rem;
-  height: 1rem;
-}
-
-.markdown-heading--level-1 {
-  font-size: 2.25rem;
-  font-weight: 700;
-  margin: 3rem 0 1.5rem 0;
-  color: #f8fafc;
-  letter-spacing: -0.025em;
-}
-
-.markdown-heading--level-2 {
-  font-size: 1.75rem;
-  font-weight: 600;
-  margin: 3rem 0 1.25rem 0;
-  color: #f1f5f9;
-  /* Slate 100 */
-  padding-bottom: 0.75rem;
-  border-bottom: 1px solid rgba(255, 255, 255, 0.08);
-  letter-spacing: -0.015em;
-}
-
-.markdown-heading--level-3 {
-  font-size: 1.375rem;
-  font-weight: 600;
-  margin: 2rem 0 1rem 0;
-  color: #e2e8f0;
-  /* Slate 200 */
-}
-
-.markdown-heading--level-4 {
-  font-size: 1.125rem;
-  font-weight: 600;
-  margin: 1.5rem 0 0.75rem 0;
-  color: #e2e8f0;
-}
-
-.markdown-heading--level-5 {
-  font-size: 1rem;
-  font-weight: 600;
-  margin: 1.25rem 0 0.5rem 0;
-  color: #cbd5e1;
-}
-
-.markdown-heading--level-6 {
-  font-size: 0.875rem;
-  font-weight: 600;
-  margin: 1.25rem 0 0.5rem 0;
-  color: #cbd5e1;
-  text-transform: uppercase;
-  letter-spacing: 0.05em;
-}
-
-/* Code block styles */
-.code-block {
-  margin: 1.5rem 0;
-  border-radius: 12px;
-  overflow: hidden;
-  /* Glassmorphism */
-  background: rgba(15, 23, 42, 0.6);
-  backdrop-filter: blur(12px);
-  border: 1px solid rgba(255, 255, 255, 0.08);
-  box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
-}
-
-.code-block--with-focus {
-  position: relative;
-}
-
-.code-pre {
-  margin: 0;
-  padding: 1.25rem;
-  overflow-x: auto;
-  font-family: 'JetBrains Mono', 'SF Mono', Monaco, 'Cascadia Code', 'Roboto Mono', Consolas, 'Courier New', monospace;
-  font-size: 0.875rem;
-  line-height: 1.6;
-  color: #e2e8f0;
-}
-
-.code-line {
-  display: grid;
-  grid-template-columns: auto 1fr;
-  gap: 1.5rem;
-  padding: 0 0.25rem;
-  transition: all 0.2s ease;
-}
-
-.line-number {
-  color: #475569;
-  /* Slate 600 */
-  font-size: 0.75rem;
-  text-align: right;
-  user-select: none;
-  min-width: 1.5rem;
-}
-
-.line-content {
-  min-width: 0;
-}
-
-.line-focus {
-  background-color: rgba(59, 130, 246, 0.1);
-  border-left: 2px solid #3b82f6;
-  padding-left: 0.5rem;
-  margin-left: -0.5rem;
-}
-
-.line-dimmed {
-  opacity: 0.4;
-}
-
-/* Inline code styles - "Chip" style */
-.inline-code {
-  background-color: rgba(30, 41, 59, 0.5);
-  /* Slate 800/50 */
-  color: #93c5fd;
-  /* Blue 300 */
-  padding: 0.125rem 0.375rem;
-  border-radius: 6px;
-  font-family: 'JetBrains Mono', 'SF Mono', Monaco, 'Cascadia Code', 'Roboto Mono', Consolas, 'Courier New', monospace;
-  font-size: 0.85em;
-  border: 1px solid rgba(148, 163, 184, 0.1);
-  white-space: nowrap;
-}
-
-/* Custom block styles */
-.custom-block {
-  margin: 1.5rem 0;
-  padding: 1rem 1.25rem;
-  border-radius: 8px;
-  border-left: 4px solid;
-  background: rgba(15, 23, 42, 0.4);
-}
-
-.custom-block__header {
-  display: flex;
-  align-items: center;
-  gap: 0.75rem;
-  margin-bottom: 0.75rem;
-  font-weight: 600;
-}
-
-.custom-block__icon {
-  width: 1.25rem;
-  height: 1.25rem;
-  flex-shrink: 0;
-}
-
-.custom-block__title {
-  font-size: 0.875rem;
-  text-transform: uppercase;
-  letter-spacing: 0.05em;
-}
-
-.custom-block__content {
-  margin: 0;
-}
-
-.custom-block__content>*:first-child {
-  margin-top: 0;
-}
-
-.custom-block__content>*:last-child {
-  margin-bottom: 0;
-}
-
-/* Tip block */
-.custom-block--tip {
-  background-color: rgba(14, 165, 233, 0.1);
-  /* Sky 500/10 */
-  border-left-color: #0ea5e9;
-  color: #e0f2fe;
-}
-
-.custom-block--tip .custom-block__title {
-  color: #38bdf8;
-}
-
-.custom-block--tip .custom-block__icon {
-  color: #38bdf8;
-}
-
-/* Warning block */
-.custom-block--warning {
-  background-color: rgba(245, 158, 11, 0.1);
-  /* Amber 500/10 */
-  border-left-color: #f59e0b;
-  color: #fef3c7;
-}
-
-.custom-block--warning .custom-block__title {
-  color: #fbbf24;
-}
-
-.custom-block--warning .custom-block__icon {
-  color: #fbbf24;
-}
-
-/* Danger block */
-.custom-block--danger {
-  background-color: rgba(239, 68, 68, 0.1);
-  /* Red 500/10 */
-  border-left-color: #ef4444;
-  color: #fee2e2;
-}
-
-.custom-block--danger .custom-block__title {
-  color: #f87171;
-}
-
-.custom-block--danger .custom-block__icon {
-  color: #f87171;
-}
-
-/* Details block */
-.custom-block--details {
-  background-color: rgba(30, 41, 59, 0.4);
-  border-left-color: #64748b;
-  color: #cbd5e1;
-}
-
-.custom-block--details .custom-block__summary {
-  cursor: pointer;
-  display: flex;
-  align-items: center;
-  gap: 0.5rem;
-  font-weight: 600;
-  margin-bottom: 0.75rem;
-  user-select: none;
-}
-
-.custom-block--details .custom-block__title {
-  color: #94a3b8;
-}
-
-.custom-block--details .custom-block__icon {
-  color: #94a3b8;
-}
-
-.custom-block--details[open] .custom-block__summary {
-  margin-bottom: 0.75rem;
-}
-
-/* Link styles */
-.markdown-link {
-  color: #60a5fa;
-  /* Blue 400 */
-  text-decoration: none;
-  border-bottom: 1px solid transparent;
-  transition: all 0.2s ease;
-}
-
-.markdown-link:hover {
-  color: #93c5fd;
-  /* Blue 300 */
-  border-bottom-color: #93c5fd;
-}
-
-.markdown-link--external {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.25rem;
-}
-
-.external-link-icon {
-  width: 0.875rem;
-  height: 0.875rem;
-  opacity: 0.7;
-}
-
-.markdown-link--anchor {
-  color: #94a3b8;
-}
-
-.markdown-link--anchor:hover {
-  color: #60a5fa;
-}
-
-/* General markdown elements */
-.markdown-content p {
-  margin: 1.25rem 0;
-  line-height: 1.75;
-}
-
-.markdown-content ul,
-.markdown-content ol {
-  margin: 1.25rem 0;
-  padding-left: 1.5rem;
-}
-
-.markdown-content li {
-  margin: 0.5rem 0;
-  padding-left: 0.5rem;
-}
-
-.markdown-content li::marker {
-  color: #64748b;
-}
-
-.markdown-content blockquote {
-  margin: 1.5rem 0;
-  padding: 1rem 1.5rem;
-  border-left: 4px solid #475569;
-  background-color: rgba(30, 41, 59, 0.4);
-  border-radius: 0 8px 8px 0;
-  color: #94a3b8;
-  font-style: italic;
-}
-
-.markdown-content table {
-  width: 100%;
-  margin: 2rem 0;
-  border-collapse: separate;
-  border-spacing: 0;
-  border: 1px solid rgba(255, 255, 255, 0.08);
-  border-radius: 8px;
-  overflow: hidden;
-}
-
-.markdown-content th,
-.markdown-content td {
-  padding: 0.875rem 1.25rem;
-  text-align: left;
-  border-bottom: 1px solid rgba(255, 255, 255, 0.08);
-}
-
-.markdown-content th {
-  background-color: rgba(30, 41, 59, 0.6);
-  font-weight: 600;
-  color: #e2e8f0;
-}
-
-.markdown-content tr:last-child td {
-  border-bottom: none;
-}
-
-.markdown-content tr:hover td {
-  background-color: rgba(255, 255, 255, 0.02);
-}
-
-.markdown-content hr {
-  margin: 3rem 0;
-  border: none;
-  border-top: 1px solid rgba(255, 255, 255, 0.08);
-}
-
-.markdown-content img {
-  max-width: 100%;
-  height: auto;
-  border-radius: 8px;
-  margin: 2rem 0;
-  border: 1px solid rgba(255, 255, 255, 0.08);
-  box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1);
-}
-
-/* Responsive adjustments */
-@media (max-width: 768px) {
-  .markdown-title {
-    font-size: 2rem;
-  }
-
-  .markdown-heading--level-1 {
-    font-size: 1.875rem;
-  }
-
-  .markdown-heading--level-2 {
-    font-size: 1.5rem;
-  }
-
-  .heading-anchor {
-    display: none;
-  }
-
-  .code-pre {
-    padding: 1rem;
-    font-size: 0.8rem;
-  }
-}
-
-/* Print styles */
-@media print {
-  .toc-container {
-    display: none;
-  }
-
-  .markdown-content--with-toc {
-    grid-template-columns: 1fr;
-  }
-
-  .heading-anchor {
-    display: none;
-  }
-
-  .code-block {
-    border: 1px solid #ccc;
-    background: #f5f5f5 !important;
-    color: #000 !important;
-  }
-
-  .code-pre {
-    color: #000 !important;
-  }
-
-  .custom-block {
-    border: 1px solid #ccc;
-    background: #f9f9f9 !important;
-    color: #000 !important;
-  }
-
-  .markdown-content {
-    color: #000 !important;
-  }
-
-  .markdown-title,
-  .markdown-heading--level-1,
-  .markdown-heading--level-2 {
-    color: #000 !important;
-  }
-}
\ No newline at end of file
diff --git a/docs/src/lib/markdown/types.ts b/docs/src/lib/markdown/types.ts
deleted file mode 100644
index b6357892..00000000
--- a/docs/src/lib/markdown/types.ts
+++ /dev/null
@@ -1,80 +0,0 @@
-export interface TocItem {
-  id: string;
-  text: string;
-  level: number;
-  children?: TocItem[];
-}
-
-export interface MarkdownProcessorOptions {
-  enableToc?: boolean;
-  enableCodeFocus?: boolean;
-  enableHtmlBlocks?: boolean;
-  enableLinkProcessing?: boolean;
-  baseUrl?: string;
-  className?: string;
-  tocDepth?: {
-    min: number;
-    max: number;
-  };
-}
-
-export interface ProcessedMarkdown {
-  content: React.ReactNode;
-  toc?: TocItem[];
-  frontmatter?: Record<string, any>;
-}
-
-export interface HeadingData {
-  id: string;
-  text: string;
-  level: number;
-  element: HTMLElement;
-}
-
-export interface CodeBlockProps {
-  children?: string;
-  className?: string;
-  language?: string;
-  hasFocus?: boolean;
-  focusLines?: number[];
-}
-
-export interface CustomBlockProps {
-  type: 'tip' | 'warning' | 'danger' | 'details';
-  title?: string;
-  children: React.ReactNode;
-  className?: string;
-}
-
-export interface LinkComponentProps {
-  href?: string;
-  children: React.ReactNode;
-  className?: string;
-  title?: string;
-}
-
-export interface HeadingComponentProps {
-  level: number;
-  id?: string;
-  children: React.ReactNode;
-  className?: string;
-}
-
-export interface MarkdownContentProps {
-  content: string;
-  options?: MarkdownProcessorOptions;
-  className?: string;
-}
-
-export interface FrontmatterData {
-  [key: string]: any;
-  title?: string;
-  description?: string;
-  toc?: boolean;
-}
-
-export interface ParsedMarkdown {
-  content: string;
-  frontmatter: FrontmatterData;
-  hasToc: boolean;
-}
diff --git a/docs/src/lib/markdown/utils/frontmatter.ts b/docs/src/lib/markdown/utils/frontmatter.ts
deleted file mode 100644
index b82d080f..00000000
--- a/docs/src/lib/markdown/utils/frontmatter.ts
+++ /dev/null
@@ -1,82 +0,0 @@
-import matter from 'gray-matter';
-import type { FrontmatterData, ParsedMarkdown } from '../types';
-
-/**
- * Parses frontmatter from markdown content
- * @param markdown The raw markdown content
- * @returns Parsed markdown with frontmatter and content separated
- */
-export function parseFrontmatter(markdown: string): ParsedMarkdown {
-  try {
-    const parsed = matter(markdown);
-
-    const frontmatter: FrontmatterData = {
-      ...parsed.data,
-    };
-
-    // Check if TOC should be enabled based on frontmatter or [[toc]] presence
-    const hasTocInFrontmatter = frontmatter.toc === true;
-    const hasTocInContent = parsed.content.includes('[[toc]]');
-    const hasToc = hasTocInFrontmatter || hasTocInContent;
-
-    return {
-      content: parsed.content,
-      frontmatter,
-      hasToc,
-    };
-  } catch (error) {
-    console.warn('Failed to parse frontmatter:', error);
-
-    // Fallback: treat entire content as markdown without frontmatter
-    const hasToc = markdown.includes('[[toc]]');
-
-    return {
-      content: markdown,
-      frontmatter: {},
-      hasToc,
-    };
-  }
-}
-
-/**
- * Removes the [[toc]] placeholder from markdown content
- * @param content Markdown content
- * @returns Content with [[toc]] removed
- */
-export function removeTocPlaceholder(content: string): string {
-  return content.replace(/\[\[toc\]\]/g, '').trim();
-}
-
-/**
- * Extracts title from frontmatter or first heading
- * @param frontmatter Parsed frontmatter data
- * @param content Markdown content
- * @returns Extracted title or undefined
- */
-export function extractTitle(frontmatter: FrontmatterData, content: string): string | undefined {
-  // Try frontmatter first
-  if (frontmatter.title && typeof frontmatter.title === 'string') {
-    return frontmatter.title;
-  }
-
-  // Try to extract from first H1 heading
-  const h1Match = content.match(/^#\s+(.+)$/m);
-  if (h1Match) {
-    return h1Match[1].trim();
-  }
-
-  return undefined;
-}
-
-/**
- * Extracts description from frontmatter
- * @param frontmatter Parsed frontmatter data
- * @returns Description or undefined
- */
-export function extractDescription(frontmatter: FrontmatterData): string | undefined {
-  if (frontmatter.description && typeof frontmatter.description === 'string') {
-    return frontmatter.description;
-  }
-
-  return undefined;
-}
diff --git a/docs/src/lib/markdown/utils/headings.ts b/docs/src/lib/markdown/utils/headings.ts
deleted file mode 100644
index e41f79c2..00000000
--- a/docs/src/lib/markdown/utils/headings.ts
+++ /dev/null
@@ -1,184 +0,0 @@
-import type { TocItem, HeadingData } from '../types';
-
-/**
- * Извлекает текст из React children
- * @param children React children (может быть строкой, объектом или массивом)
- * @returns Строка с текстом
- */
-function extractTextFromChildren(children: any): string {
-  if (typeof children === 'string') {
-    return children;
-  }
-
-  if (Array.isArray(children)) {
-    return children.map(extractTextFromChildren).join('');
-  }
-
-  if (children && typeof children === 'object' && children.props) {
-    return extractTextFromChildren(children.props.children);
-  }
-
-  return '';
-}
-
-/**
- * Generates a URL-safe ID from heading text
- * @param text The heading text (может быть строкой или React children)
- * @returns URL-safe ID
- */
-export function generateHeadingId(text: any): string {
-  const textString = extractTextFromChildren(text);
-
-  return textString
-    .toLowerCase()
-    .replace(/[^\w\s-]/g, '') // Remove special characters except spaces and hyphens
-    .replace(/\s+/g, '-') // Replace spaces with hyphens
-    .replace(/-+/g, '-') // Replace multiple hyphens with single hyphen
-    .replace(/^-|-$/g, ''); // Remove leading/trailing hyphens
-}
-
-/**
- * Extracts headings from markdown content
- * @param content Markdown content
- * @param minLevel Minimum heading level to include (default: 2)
- * @param maxLevel Maximum heading level to include (default: 4)
- * @returns Array of heading data
- */
-export function extractHeadings(
-  content: string,
-  minLevel: number = 2,
-  maxLevel: number = 4
-): HeadingData[] {
-  const headings: HeadingData[] = [];
-  const lines = content.split('\n');
-
-  for (const line of lines) {
-    // Match markdown headings (### Text)
-    const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
-
-    if (headingMatch) {
-      const level = headingMatch[1].length;
-      const text = headingMatch[2].trim();
-
-      // Only include headings within the specified level range
-      if (level >= minLevel && level <= maxLevel) {
-        const id = generateHeadingId(text);
-
-        headings.push({
-          id,
-          text,
-          level,
-          element: null as any, // Will be populated when rendered in DOM
-        });
-      }
-    }
-  }
-
-  return headings;
-}
-
-/**
- * Builds a nested TOC structure from flat headings array
- * @param headings Flat array of headings
- * @returns Nested TOC structure
- */
-export function buildTocStructure(headings: HeadingData[]): TocItem[] {
-  const toc: TocItem[] = [];
-  const stack: TocItem[] = [];
-
-  for (const heading of headings) {
-    const tocItem: TocItem = {
-      id: heading.id,
-      text: heading.text,
-      level: heading.level,
-      children: [],
-    };
-
-    // Find the correct parent level
-    while (stack.length > 0 && stack[stack.length - 1].level >= heading.level) {
-      stack.pop();
-    }
-
-    // Add to parent or root
-    if (stack.length === 0) {
-      toc.push(tocItem);
-    } else {
-      const parent = stack[stack.length - 1];
-      if (!parent.children) {
-        parent.children = [];
-      }
-      parent.children.push(tocItem);
-    }
-
-    stack.push(tocItem);
-  }
-
-  return toc;
-}
-
-/**
- * Adds IDs to headings in markdown content
- * @param content Markdown content
- * @param headings Array of heading data with IDs
- * @returns Content with heading IDs added
- */
-export function addHeadingIds(content: string, headings: HeadingData[]): string {
-  let modifiedContent = content;
-
-  for (const heading of headings) {
-    // Find the heading in content and add an id
-    const headingRegex = new RegExp(`^(#{${heading.level}})\\s+${escapeRegex(heading.text)}$`, 'gm');
-    modifiedContent = modifiedContent.replace(
-      headingRegex,
-      `$1 ${heading.text} {#${heading.id}}`
-    );
-  }
-
-  return modifiedContent;
-}
-
-/**
- * Escapes special regex characters in text
- * @param text Text to escape
- * @returns Escaped text
- */
-function escapeRegex(text: string): string {
-  return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-
-/**
- * Generates TOC from markdown content
- * @param content Markdown content
- * @param minLevel Minimum heading level (default: 2)
- * @param maxLevel Maximum heading level (default: 4)
- * @returns TOC structure
- */
-export function generateToc(
-  content: string,
-  minLevel: number = 2,
-  maxLevel: number = 4
-): TocItem[] {
-  const headings = extractHeadings(content, minLevel, maxLevel);
-  return buildTocStructure(headings);
-}
-
-/**
- * Flattens nested TOC structure for easier iteration
- * @param toc Nested TOC structure
- * @returns Flat array of TOC items
- */
-export function flattenToc(toc: TocItem[]): TocItem[] {
-  const flattened: TocItem[] = [];
-
-  function traverse(items: TocItem[]) {
-    for (const item of items) {
-      flattened.push(item);
-      if (item.children && item.children.length > 0) {
-        traverse(item.children);
-      }
-    }
-  }
-
-  traverse(toc);
-  return flattened;
-}
diff --git a/docs/src/lib/markdown/utils/paths.ts b/docs/src/lib/markdown/utils/paths.ts
deleted file mode 100644
index f653937e..00000000
--- a/docs/src/lib/markdown/utils/paths.ts
+++ /dev/null
@@ -1,222 +0,0 @@
-/**
- * Checks if a URL is external (absolute URL with protocol)
- * @param url URL to check
- * @returns True if external, false if internal
- */
-export function isExternalUrl(url: string): boolean {
-  try {
-    new URL(url);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Checks if a path is relative (starts with ./ or ../)
- * @param path Path to check
- * @returns True if relative, false otherwise
- */
-export function isRelativePath(path: string): boolean {
-  return path.startsWith('./') || path.startsWith('../');
-}
-
-/**
- * Checks if a path is an anchor link (starts with #)
- * @param path Path to check
- * @returns True if anchor link, false otherwise
- */
-export function isAnchorLink(path: string): boolean {
-  return path.startsWith('#');
-}
-
-/**
- * Normalizes a path by removing double slashes and resolving relative paths
- * @param path Path to normalize
- * @returns Normalized path
- */
-export function normalizePath(path: string): string {
-  // Remove double slashes
-  let normalized = path.replace(/\/+/g, '/');
-
-  // Remove trailing slash unless it's the root
-  if (normalized.length > 1 && normalized.endsWith('/')) {
-    normalized = normalized.slice(0, -1);
-  }
-
-  return normalized;
-}
-
-/**
- * Joins path segments with proper slash handling
- * @param segments Path segments to join
- * @returns Joined path
- */
-export function joinPaths(...segments: string[]): string {
-  const filtered = segments.filter(segment => segment && segment !== '.');
-
-  if (filtered.length === 0) {
-    return '';
-  }
-
-  let joined = filtered[0];
-
-  for (let i = 1; i < filtered.length; i++) {
-    const segment = filtered[i];
-
-    // Add slash if needed
-    if (!joined.endsWith('/') && !segment.startsWith('/')) {
-      joined += '/';
-    }
-
-    // Remove duplicate slash
-    if (joined.endsWith('/') && segment.startsWith('/')) {
-      joined += segment.slice(1);
-    } else {
-      joined += segment;
-    }
-  }
-
-  return normalizePath(joined);
-}
-
-/**
- * Resolves a relative markdown path to an absolute path
- * @param currentPath Current page path
- * @param relativePath Relative path from markdown link
- * @param baseUrl Base URL for the application
- * @returns Resolved absolute path
- */
-export function resolveMarkdownPath(
-  currentPath: string,
-  relativePath: string,
-  baseUrl?: string
-): string {
-  // Handle anchor links
-  if (isAnchorLink(relativePath)) {
-    return relativePath;
-  }
-
-  // Handle external URLs
-  if (isExternalUrl(relativePath)) {
-    return relativePath;
-  }
-
-  // Handle absolute paths (starting with /)
-  if (relativePath.startsWith('/')) {
-    return baseUrl ? joinPaths(baseUrl, relativePath) : relativePath;
-  }
-
-  // Handle relative paths
-  const currentDir = currentPath.split('/').slice(0, -1).join('/');
-  const resolvedPath = joinPaths(currentDir, relativePath);
-
-  return baseUrl ? joinPaths(baseUrl, resolvedPath) : resolvedPath;
-}
-
-/**
- * Converts a file path to a URL path (removes .md extension, handles index files)
- * @param filePath File path (e.g., "guide/introduction/what-is.md")
- * @returns URL path (e.g., "/guide/introduction/what-is")
- */
-export function filePathToUrlPath(filePath: string): string {
-  let urlPath = filePath;
-
-  // Remove .md extension
-  if (urlPath.endsWith('.md')) {
-    urlPath = urlPath.slice(0, -3);
-  }
-
-  // Handle index files (convert "folder/index" to "folder/")
-  if (urlPath.endsWith('/index')) {
-    urlPath = urlPath.slice(0, -6);
-  } else if (urlPath === 'index') {
-    urlPath = '';
-  }
-
-  // Ensure starts with /
-  if (!urlPath.startsWith('/') && urlPath !== '') {
-    urlPath = '/' + urlPath;
-  }
-
-  // Handle empty path (root)
-  if (urlPath === '') {
-    urlPath = '/';
-  }
-
-  return urlPath;
-}
-
-/**
- * Extracts the directory path from a file path
- * @param filePath File path
- * @returns Directory path
- */
-export function getDirectoryPath(filePath: string): string {
-  const segments = filePath.split('/');
-  segments.pop(); // Remove filename
-  return segments.join('/') || '/';
-}
-
-/**
- * Extracts filename from a path
- * @param path File path
- * @returns Filename
- */
-export function getFileName(path: string): string {
-  return path.split('/').pop() || '';
-}
-
-/**
- * Extracts file extension from a path
- * @param path File path
- * @returns File extension (without dot) or empty string
- */
-export function getFileExtension(path: string): string {
-  const fileName = getFileName(path);
-  const dotIndex = fileName.lastIndexOf('.');
-
-  if (dotIndex === -1 || dotIndex === 0) {
-    return '';
-  }
-
-  return fileName.slice(dotIndex + 1);
-}
-
-/**
- * Checks if a path points to a markdown file
- * @param path File path
- * @returns True if markdown file, false otherwise
- */
-export function isMarkdownFile(path: string): boolean {
-  const extension = getFileExtension(path);
-  return extension === 'md' || extension === 'markdown';
-}
-
-/**
- * Resolves a link href for React Router navigation
- * @param href Original href
- * @param currentPath Current page path
- * @param baseUrl Base URL
- * @returns Resolved href for React Router
- */
-export function resolveRouterHref(
-  href: string,
-  currentPath: string,
-  baseUrl?: string
-): string {
-  // External links and anchors stay as is
-  if (isExternalUrl(href) || isAnchorLink(href)) {
-    return href;
-  }
-
-  // Resolve the path
-  let resolvedPath = resolveMarkdownPath(currentPath, href, baseUrl);
-
-  // Convert to URL path if it's a markdown file
-  if (isMarkdownFile(resolvedPath)) {
-    resolvedPath = filePathToUrlPath(resolvedPath);
-  }
-
-  return resolvedPath;
-}
diff --git a/docs/src/lib/markdown/utils/prismTheme.ts b/docs/src/lib/markdown/utils/prismTheme.ts
deleted file mode 100644
index 58ed5991..00000000
--- a/docs/src/lib/markdown/utils/prismTheme.ts
+++ /dev/null
@@ -1,65 +0,0 @@
-import type { PrismTheme } from 'prism-react-renderer';
-
-export const cyberTheme: PrismTheme = {
-    plain: {
-        color: '#e2e8f0', // Slate 200
-        backgroundColor: 'transparent',
-    },
-    styles: [
-        {
-            types: ['comment', 'prolog', 'doctype', 'cdata'],
-            style: {
-                color: '#64748b', // Slate 500
-                fontStyle: 'italic',
-            },
-        },
-        {
-            types: ['punctuation'],
-            style: {
-                color: '#94a3b8', // Slate 400
-            },
-        },
-        {
-            types: ['namespace'],
-            style: {
-                opacity: 0.7,
-            },
-        },
-        {
-            types: ['property', 'tag', 'boolean', 'number', 'constant', 'symbol', 'deleted'],
-            style: {
-                color: '#f472b6', // Pink 400
-            },
-        },
-        {
-            types: ['selector', 'attr-name', 'string', 'char', 'builtin', 'inserted'],
-            style: {
-                color: '#a78bfa', // Violet 400
-            },
-        },
-        {
-            types: ['operator', 'entity', 'url'],
-            style: {
-                color: '#60a5fa', // Blue 400
-            },
-        },
-        {
-            types: ['atrule', 'attr-value', 'keyword'],
-            style: {
-                color: '#818cf8', // Indigo 400
-            },
-        },
-        {
-            types: ['function', 'class-name'],
-            style: {
-                color: '#38bdf8', // Sky 400
-            },
-        },
-        {
-            types: ['regex', 'important', 'variable'],
-            style: {
-                color: '#fb7185', // Rose 400
-            },
-        },
-    ],
-};
diff --git a/docs/src/lib/search/search.ts b/docs/src/lib/search/search.ts
deleted file mode 100644
index 17f78f54..00000000
--- a/docs/src/lib/search/search.ts
+++ /dev/null
@@ -1,214 +0,0 @@
-import Fuse, { type FuseResult, type IFuseOptions } from 'fuse.js'
-import type { SearchDocument, SearchHit, SearchLanguage, SearchParams, SearchResult } from './types'
-
-const INDEX_BY_LANGUAGE: Record<SearchLanguage, string> = {
-    en: '/search/index.en.json',
-    ru: '/search/index.ru.json',
-}
-
-const DEFAULT_LIMIT = 10
-const MIN_QUERY_LENGTH = 2
-const PREVIEW_CONTEXT_BEFORE = 55
-const PREVIEW_CONTEXT_AFTER = 145
-const MAX_RESULTS_PER_PAGE = 3
-const RAW_RESULT_MULTIPLIER = 12
-const RAW_RESULT_FLOOR = 120
-
-const documentCache = new Map<SearchLanguage, Promise<SearchDocument[]>>()
-const fuseCache = new Map<SearchLanguage, Promise<Fuse<SearchDocument>>>()
-
-const fuseOptions: IFuseOptions<SearchDocument> = {
-    includeScore: true,
-    includeMatches: true,
-    ignoreLocation: true,
-    threshold: 0.35,
-    minMatchCharLength: MIN_QUERY_LENGTH,
-    keys: [
-        { name: 'title', weight: 0.45 },
-        { name: 'headings', weight: 0.3 },
-        { name: 'content', weight: 0.25 },
-    ],
-}
-
-export function resolveSearchLanguage(language: string): SearchLanguage {
-    const normalized = language.toLowerCase()
-    if (normalized === 'ru' || normalized.startsWith('ru-')) {
-        return 'ru'
-    }
-    return 'en'
-}
-
-async function fetchSearchIndex(language: SearchLanguage): Promise<SearchDocument[]> {
-    const response = await fetch(INDEX_BY_LANGUAGE[language], {
-        cache: 'no-cache',
-    })
-
-    if (!response.ok) {
-        throw new Error(`Failed to load search index for "${language}"`)
-    }
-
-    const payload: unknown = await response.json()
-
-    if (Array.isArray(payload)) {
-        return payload as SearchDocument[]
-    }
-
-    if (
-        payload &&
-        typeof payload === 'object' &&
-        'documents' in payload &&
-        Array.isArray((payload as { documents: unknown }).documents)
-    ) {
-        return (payload as { documents: SearchDocument[] }).documents
-    }
-
-    throw new Error(`Invalid search index format for "${language}"`)
-}
-
-async function getDocuments(language: SearchLanguage): Promise<SearchDocument[]> {
-    let loader = documentCache.get(language)
-    if (!loader) {
-        loader = fetchSearchIndex(language)
-        documentCache.set(language, loader)
-    }
-    return loader
-}
-
-async function getFuseInstance(language: SearchLanguage): Promise<Fuse<SearchDocument>> {
-    let fusePromise = fuseCache.get(language)
-    if (!fusePromise) {
-        fusePromise = getDocuments(language).then((documents) => new Fuse(documents, fuseOptions))
-        fuseCache.set(language, fusePromise)
-    }
-    return fusePromise
-}
-
-function getQueryTokens(query: string): string[] {
-    return query
-        .toLowerCase()
-        .split(/\s+/)
-        .map((token) => token.trim())
-        .filter((token) => token.length >= MIN_QUERY_LENGTH)
-}
-
-function documentContainsAllTokens(document: SearchDocument, tokens: string[]): boolean {
-    const haystack = `${document.title}\n${document.section || ''}\n${document.headings.join('\n')}\n${document.content}`.toLowerCase()
-    return tokens.every((token) => haystack.includes(token))
-}
-
-function buildSnippet(value: string, start: number, tokenLength: number): string {
-    const from = Math.max(0, start - PREVIEW_CONTEXT_BEFORE)
-    const to = Math.min(value.length, start + tokenLength + PREVIEW_CONTEXT_AFTER)
-
-    const prefix = from > 0 ? '...' : ''
-    const suffix = to < value.length ? '...' : ''
-    const snippet = value.slice(from, to).trim()
-
-    return snippet ? `${prefix}${snippet}${suffix}` : value.slice(0, PREVIEW_CONTEXT_AFTER).trim()
-}
-
-function buildPreviewFromMatch(result: FuseResult<SearchDocument>, queryTokens: string[]): string {
-    const fallback = result.item.excerpt
-    const fields = [
-        result.item.content,
-        result.item.section || '',
-        result.item.title,
-        ...result.item.headings,
-    ]
-
-    for (const field of fields) {
-        const lowerField = field.toLowerCase()
-        for (const token of queryTokens) {
-            const exactIndex = lowerField.indexOf(token)
-            if (exactIndex >= 0) {
-                return buildSnippet(field, exactIndex, token.length)
-            }
-        }
-    }
-
-    const match = result.matches?.find(
-        (entry) => typeof entry.value === 'string' && entry.indices && entry.indices.length > 0,
-    )
-    if (!match || typeof match.value !== 'string' || !match.indices || match.indices.length === 0) {
-        return fallback
-    }
-
-    const [start, end] = match.indices[0]
-    return buildSnippet(match.value, start, end - start + 1) || fallback
-}
-
-export async function searchDocumentation({
-    query,
-    language,
-    limit = DEFAULT_LIMIT,
-}: SearchParams): Promise<SearchResult[]> {
-    const normalizedQuery = query.trim()
-    if (normalizedQuery.length < MIN_QUERY_LENGTH) {
-        return []
-    }
-    const queryTokens = getQueryTokens(normalizedQuery)
-
-    const fuse = await getFuseInstance(language)
-    const rawLimit = Math.max(limit * RAW_RESULT_MULTIPLIER, RAW_RESULT_FLOOR)
-    const results = fuse.search(normalizedQuery, { limit: rawLimit })
-    const dedupe = new Set<string>()
-
-    const hits: SearchHit[] = results
-        .filter((result) => documentContainsAllTokens(result.item, queryTokens))
-        .map((result) => ({
-            ...result.item,
-            score: result.score ?? 1,
-            preview: buildPreviewFromMatch(result, queryTokens),
-            pagePath: result.item.path.split('#')[0],
-        }))
-        .filter((result) => {
-            const key = `${result.path}::${result.preview}`
-            if (dedupe.has(key)) {
-                return false
-            }
-            dedupe.add(key)
-            return true
-        })
-
-    const perPageBuckets = new Map<string, { visible: SearchHit[]; hidden: SearchHit[] }>()
-    for (const hit of hits) {
-        const bucket = perPageBuckets.get(hit.pagePath) || { visible: [], hidden: [] }
-        if (bucket.visible.length < MAX_RESULTS_PER_PAGE) {
-            bucket.visible.push(hit)
-        } else {
-            bucket.hidden.push(hit)
-        }
-        perPageBuckets.set(hit.pagePath, bucket)
-    }
-
-    const visibleHitIds = new Set<string>()
-    for (const bucket of perPageBuckets.values()) {
-        for (const hit of bucket.visible) {
-            visibleHitIds.add(hit.id)
-        }
-    }
-
-    const hiddenByPage = new Map<string, SearchHit[]>()
-    for (const [pagePath, bucket] of perPageBuckets.entries()) {
-        hiddenByPage.set(pagePath, bucket.hidden)
-    }
-
-    const attachedHiddenToPage = new Set<string>()
-    const mapped: SearchResult[] = hits
-        .filter((hit) => visibleHitIds.has(hit.id))
-        .map((hit) => {
-            if (!attachedHiddenToPage.has(hit.pagePath)) {
-                attachedHiddenToPage.add(hit.pagePath)
-                const hidden = hiddenByPage.get(hit.pagePath) || []
-                if (hidden.length > 0) {
-                    return {
-                        ...hit,
-                        moreMatches: hidden,
-                    }
-                }
-            }
-            return hit
-        })
-
-    return mapped.slice(0, limit)
-}
diff --git a/docs/src/lib/search/types.ts b/docs/src/lib/search/types.ts
deleted file mode 100644
index 09cfdcf4..00000000
--- a/docs/src/lib/search/types.ts
+++ /dev/null
@@ -1,27 +0,0 @@
-export type SearchLanguage = 'en' | 'ru'
-
-export interface SearchDocument {
-    id: string
-    title: string
-    section?: string
-    path: string
-    headings: string[]
-    excerpt: string
-    content: string
-}
-
-export interface SearchHit extends SearchDocument {
-    score: number
-    preview: string
-    pagePath: string
-}
-
-export interface SearchResult extends SearchHit {
-    moreMatches?: SearchHit[]
-}
-
-export interface SearchParams {
-    query: string
-    language: SearchLanguage
-    limit?: number
-}
diff --git a/docs/src/main.tsx b/docs/src/main.tsx
deleted file mode 100644
index 8dfb3c6b..00000000
--- a/docs/src/main.tsx
+++ /dev/null
@@ -1,18 +0,0 @@
-// Polyfill Buffer for gray-matter library
-import { Buffer } from 'buffer'
-    ; (globalThis as any).Buffer = Buffer
-
-
-import { StrictMode } from 'react'
-import { createRoot } from 'react-dom/client'
-import './index.css'
-import './lib/markdown/styles.css'
-import App from './App.tsx'
-import './i18n/config'
-
-
-createRoot(document.getElementById('root')!).render(
-    <StrictMode>
-        <App />
-    </StrictMode>,
-)
diff --git a/docs/src/pages/BlogPage.tsx b/docs/src/pages/BlogPage.tsx
deleted file mode 100644
index 131a81e7..00000000
--- a/docs/src/pages/BlogPage.tsx
+++ /dev/null
@@ -1,97 +0,0 @@
-import { Link } from 'react-router-dom'
-import Navbar from '../components/Navbar'
-import { Calendar, ArrowRight } from 'lucide-react'
-import { useTranslation } from 'react-i18next'
-
-interface BlogPost {
-    title: string
-    titleRu: string
-    slug: string
-    date: string
-    excerpt: string
-    excerptRu: string
-}
-
-const blogPosts: BlogPost[] = [
-    {
-        title: "Let's Work with Proto Errors Correctly :)",
-        titleRu: "Давайте работать с proto ошибками правильно :)",
-        slug: "working-with-proto-errors-correctly",
-        date: "2025-11-30",
-        excerpt: "Best practices for handling errors in gRPC and Protocol Buffers",
-        excerptRu: "Лучшие практики обработки ошибок в gRPC и Protocol Buffers"
-    },
-    {
-        title: "Finally, give up gin, echo and <your other framework>",
-        titleRu: "Откажитесь уже наконец от gin, echo и <иной ваш фреймворк>",
-        slug: "finally-give-up-gin-echo",
-        date: "2025-11-29",
-        excerpt: "Why it's time to reconsider your web framework choices",
-        excerptRu: "Почему пора пересмотреть выбор вашего веб-фреймворка"
-    }
-]
-
-export default function BlogPage() {
-    const { i18n } = useTranslation()
-    const isRu = i18n.language === 'ru'
-
-    return (
-        <div className="min-h-screen bg-gradient-to-b from-slate-950 via-slate-900 to-slate-950">
-            <Navbar />
-
-            <div className="max-w-4xl mx-auto px-6 pt-32 pb-20">
-                {/* Header */}
-                <div className="mb-16">
-                    <h1 className="text-5xl font-bold text-white mb-4">
-                        {isRu ? 'Блог' : 'Blog'}
-                    </h1>
-                    <p className="text-xl text-slate-400">
-                        {isRu
-                            ? 'Статьи о современных подходах к разработке'
-                            : 'Articles about modern development approaches'}
-                    </p>
-                </div>
-
-                {/* Blog Posts */}
-                <div className="space-y-8">
-                    {blogPosts.map((post) => (
-                        <Link
-                            key={post.slug}
-                            to={`/blog/${post.slug}`}
-                            className="group block glass-panel p-8 rounded-2xl border border-white/5 hover:border-primary/30 transition-all duration-300 hover:scale-[1.02]"
-                        >
-                            <div className="flex items-start justify-between gap-4 mb-4">
-                                <h2 className="text-2xl font-bold text-white group-hover:text-primary transition-colors">
-                                    {isRu ? post.titleRu : post.title}
-                                </h2>
-                                <ArrowRight className="w-6 h-6 text-slate-400 group-hover:text-primary group-hover:translate-x-1 transition-all flex-shrink-0" />
-                            </div>
-
-                            <p className="text-slate-400 mb-4">
-                                {isRu ? post.excerptRu : post.excerpt}
-                            </p>
-
-                            <div className="flex items-center text-sm text-slate-500">
-                                <Calendar className="w-4 h-4 mr-2" />
-                                {new Date(post.date).toLocaleDateString(isRu ? 'ru-RU' : 'en-US', {
-                                    year: 'numeric',
-                                    month: 'long',
-                                    day: 'numeric'
-                                })}
-                            </div>
-                        </Link>
-                    ))}
-                </div>
-
-                {/* Empty state if no posts */}
-                {blogPosts.length === 0 && (
-                    <div className="text-center py-20">
-                        <p className="text-slate-400 text-lg">
-                            {isRu ? 'Статьи скоро появятся' : 'Articles coming soon'}
-                        </p>
-                    </div>
-                )}
-            </div>
-        </div>
-    )
-}
diff --git a/docs/src/pages/BlogPostPage.tsx b/docs/src/pages/BlogPostPage.tsx
deleted file mode 100644
index f7285db1..00000000
--- a/docs/src/pages/BlogPostPage.tsx
+++ /dev/null
@@ -1,135 +0,0 @@
-import { useParams, Link } from 'react-router-dom'
-import { useState, useEffect } from 'react'
-import { MarkdownContent } from '../lib/markdown'
-import { Loader2, AlertCircle, ArrowLeft } from 'lucide-react'
-import { useTranslation } from 'react-i18next'
-import Navbar from '../components/Navbar'
-
-export default function BlogPostPage() {
-    const { slug } = useParams<{ slug: string }>()
-    const { i18n } = useTranslation()
-    const [content, setContent] = useState<string>('')
-    const [isLoading, setIsLoading] = useState(true)
-    const [error, setError] = useState<string | null>(null)
-
-    useEffect(() => {
-        const loadMarkdown = async () => {
-            setIsLoading(true)
-            setError(null)
-
-            try {
-                // Helper to fetch and validate markdown
-                const fetchMarkdown = async (url: string): Promise<string | null> => {
-                    const response = await fetch(url)
-
-                    if (!response.ok) return null
-
-                    const contentType = response.headers.get('content-type')
-                    if (contentType && contentType.includes('text/html')) {
-                        return null // It's the SPA fallback, not the file
-                    }
-
-                    return response.text()
-                }
-
-                // Build candidate paths based on language
-                const langPrefix = i18n.language === 'ru' ? 'ru-blog' : 'blog'
-                const candidates = [
-                    `/docs/${langPrefix}/${slug}.md`,
-                    `/docs/blog/${slug}.md` // Fallback to English
-                ]
-
-                let text: string | null = null
-                for (const url of candidates) {
-                    text = await fetchMarkdown(url)
-                    if (text) {
-                        break
-                    }
-                }
-
-                if (!text) {
-                    throw new Error('Blog post not found')
-                }
-
-                setContent(text)
-            } catch (err) {
-                console.error('Error loading blog post:', err)
-                setError(err instanceof Error ? err.message : 'An unexpected error occurred')
-            } finally {
-                setIsLoading(false)
-            }
-        }
-
-        if (slug) {
-            loadMarkdown()
-        }
-    }, [slug, i18n.language])
-
-    if (isLoading) {
-        return (
-            <div className="min-h-screen bg-gradient-to-b from-slate-950 via-slate-900 to-slate-950">
-                <Navbar />
-                <div className="flex items-center justify-center min-h-[60vh] pt-20">
-                    <div className="text-center">
-                        <Loader2 className="w-12 h-12 text-blue-500 animate-spin mx-auto mb-4" />
-                        <p className="text-slate-400">Loading blog post...</p>
-                    </div>
-                </div>
-            </div>
-        )
-    }
-
-    if (error) {
-        return (
-            <div className="min-h-screen bg-gradient-to-b from-slate-950 via-slate-900 to-slate-950">
-                <Navbar />
-                <div className="flex items-center justify-center min-h-[60vh] pt-20">
-                    <div className="text-center max-w-md">
-                        <AlertCircle className="w-12 h-12 text-red-500 mx-auto mb-4" />
-                        <h2 className="text-2xl font-bold text-white mb-2">
-                            Failed to Load Post
-                        </h2>
-                        <p className="text-slate-400 mb-4">{error}</p>
-                        <Link
-                            to="/blog"
-                            className="inline-flex items-center text-blue-400 hover:text-blue-300 transition-colors"
-                        >
-                            <ArrowLeft className="w-4 h-4 mr-2" />
-                            Back to Blog
-                        </Link>
-                    </div>
-                </div>
-            </div>
-        )
-    }
-
-    return (
-        <div className="min-h-screen bg-gradient-to-b from-slate-950 via-slate-900 to-slate-950">
-            <Navbar />
-
-            <div className="max-w-4xl mx-auto px-6 pt-32 pb-20">
-                {/* Back to blog */}
-                <Link
-                    to="/blog"
-                    className="inline-flex items-center text-slate-400 hover:text-white transition-colors mb-8"
-                >
-                    <ArrowLeft className="w-4 h-4 mr-2" />
-                    {i18n.language === 'ru' ? 'Назад к блогу' : 'Back to Blog'}
-                </Link>
-
-                {/* Article content */}
-                <article className="prose prose-invert prose-lg max-w-none">
-                    <MarkdownContent
-                        content={content}
-                        options={{
-                            enableToc: false,
-                            enableCodeFocus: true,
-                            enableHtmlBlocks: true,
-                            enableLinkProcessing: true
-                        }}
-                    />
-                </article>
-            </div>
-        </div>
-    )
-}
diff --git a/docs/src/pages/HomePage.tsx b/docs/src/pages/HomePage.tsx
deleted file mode 100644
index 3326e76b..00000000
--- a/docs/src/pages/HomePage.tsx
+++ /dev/null
@@ -1,19 +0,0 @@
-import Navbar from '../components/Navbar'
-import Hero from '../components/Hero'
-import TrustedBy from '../components/TrustedBy'
-import FeatureSwitcher from '../components/FeatureSwitcher'
-import ArchitectureComparison from '../components/ArchitectureComparison'
-import Footer from '../components/Footer'
-
-export default function HomePage() {
-    return (
-        <div className="min-h-screen bg-background text-white">
-            <Navbar />
-            <Hero />
-            <TrustedBy />
-            <FeatureSwitcher />
-            <ArchitectureComparison />
-            <Footer />
-        </div>
-    )
-}
diff --git a/docs/src/routes/DocsRoutes.tsx b/docs/src/routes/DocsRoutes.tsx
deleted file mode 100644
index 17961373..00000000
--- a/docs/src/routes/DocsRoutes.tsx
+++ /dev/null
@@ -1,27 +0,0 @@
-import { Routes, Route } from 'react-router-dom'
-import DocsLayout from '../components/docs/DocsLayout'
-import MarkdownPage from '../components/docs/MarkdownPage'
-import NotFound from '../components/docs/NotFound'
-import { TocProvider } from '../contexts/TocContext'
-
-export default function DocsRoutes() {
-    return (
-        <TocProvider>
-            <Routes>
-                <Route path="/" element={<DocsLayout />}>
-                    {/* Index route - shows introduction/what-is.md */}
-                    <Route index element={<MarkdownPage path="guide/introduction/what-is" />} />
-
-                    {/* Docs routes - paths already include guide/ */}
-                    <Route path=":category/:page" element={<MarkdownPage />} />
-                    <Route path=":category/:subcategory/:page" element={<MarkdownPage />} />
-                    <Route path=":category/:subcategory/:subsubcategory/:page" element={<MarkdownPage />} />
-                    <Route path=":category/:subcategory/:subsubcategory/:section/:page" element={<MarkdownPage />} />
-
-                    {/* 404 for invalid docs paths */}
-                    <Route path="*" element={<NotFound />} />
-                </Route>
-            </Routes>
-        </TocProvider>
-    )
-}
diff --git a/docs/src/types/sidebar.ts b/docs/src/types/sidebar.ts
deleted file mode 100644
index 0908e1bf..00000000
--- a/docs/src/types/sidebar.ts
+++ /dev/null
@@ -1,8 +0,0 @@
-export interface SidebarItem {
-    title: string
-    path?: string
-    icon?: string
-    children?: SidebarItem[]
-}
-
-export type SidebarConfig = SidebarItem[]
diff --git a/docs/src/utils/extractHeadings.ts b/docs/src/utils/extractHeadings.ts
deleted file mode 100644
index 5f173f40..00000000
--- a/docs/src/utils/extractHeadings.ts
+++ /dev/null
@@ -1,34 +0,0 @@
-export interface Heading {
-    id: string
-    text: string
-    level: number
-}
-
-export function extractHeadings(content: string): Heading[] {
-    const headings: Heading[] = []
-    const lines = content.split('\n')
-
-    // Simple regex for ## and ### headings
-    // Ignoring # (h1) as it's usually the page title
-    const headingRegex = /^(#{2,3})\s+(.+)$/
-
-    // Helper to generate ID from text
-    const generateId = (text: string) => {
-        return text
-            .toLowerCase()
-            .replace(/[^\w\s-]/g, '')
-            .replace(/\s+/g, '-')
-    }
-
-    lines.forEach(line => {
-        const match = line.match(headingRegex)
-        if (match) {
-            const level = match[1].length
-            const text = match[2].trim()
-            const id = generateId(text)
-            headings.push({ id, text, level })
-        }
-    })
-
-    return headings
-}
diff --git a/docs/src/utils/github.ts b/docs/src/utils/github.ts
deleted file mode 100644
index e4b5cb33..00000000
--- a/docs/src/utils/github.ts
+++ /dev/null
@@ -1,41 +0,0 @@
-
-interface GithubTag {
-    name: string;
-}
-
-export async function GetLatestRelease(): Promise<string> {
-    try {
-        const response = await fetch('https://api.github.com/repos/easyp-tech/easyp/tags');
-
-        if (!response.ok) {
-            throw new Error(`GitHub API returned status code ${response.status}`);
-        }
-
-        const data = await response.json() as GithubTag[];
-
-        if (data.length === 0) {
-            throw new Error('No tags found for this repository');
-        }
-
-        // Filter out pre-release versions (containing -rc, -alpha, -beta, etc.)
-        // Only return stable releases
-        const stableReleases = data.filter(tag => {
-            const version = tag.name.toLowerCase();
-            return !version.includes('-rc') &&
-                !version.includes('-alpha') &&
-                !version.includes('-beta') &&
-                !version.includes('-pre') &&
-                !version.includes('-dev');
-        });
-
-        if (stableReleases.length === 0) {
-            // If no stable releases found, fall back to the first tag
-            return data[0].name;
-        }
-
-        return stableReleases[0].name;
-    } catch (error) {
-        console.error(error);
-        return 'unknown version';
-    }
-}
diff --git a/docs/src/utils/parseBadGood.ts b/docs/src/utils/parseBadGood.ts
deleted file mode 100644
index 60fe0038..00000000
--- a/docs/src/utils/parseBadGood.ts
+++ /dev/null
@@ -1,51 +0,0 @@
-export function parseBadGoodSections(markdown: string) {
-    // Check if markdown contains both ### Bad and ### Good sections
-    const hasBadSection = /###\s+Bad/i.test(markdown)
-    const hasGoodSection = /###\s+Good/i.test(markdown)
-
-    if (!hasBadSection || !hasGoodSection) {
-        return { hasBadGood: false, badContent: '', goodContent: '', restContent: markdown }
-    }
-
-    // Split by ### Bad
-    const parts = markdown.split(/###\s+Bad/i)
-    if (parts.length < 2) {
-        return { hasBadGood: false, badContent: '', goodContent: '', restContent: markdown }
-    }
-
-    const beforeBad = parts[0]
-    const afterBad = parts[1]
-
-    // Split the afterBad by ### Good
-    const goodParts = afterBad.split(/###\s+Good/i)
-    if (goodParts.length < 2) {
-        return { hasBadGood: false, badContent: '', goodContent: '', restContent: markdown }
-    }
-
-    const badContent = goodParts[0].trim()
-    const goodAndRest = goodParts[1]
-
-    // Find where the Good section ends (next ### heading or end of string)
-    const nextHeadingMatch = goodAndRest.match(/\n###\s+/)
-    let goodContent: string
-    let afterGood: string
-
-    if (nextHeadingMatch) {
-        const splitIndex = nextHeadingMatch.index!
-        goodContent = goodAndRest.substring(0, splitIndex).trim()
-        afterGood = goodAndRest.substring(splitIndex).trim()
-    } else {
-        goodContent = goodAndRest.trim()
-        afterGood = ''
-    }
-
-    // Reconstruct the rest of the content (before Bad + after Good)
-    const restContent = (beforeBad + (afterGood ? '\n\n' + afterGood : '')).trim()
-
-    return {
-        hasBadGood: true,
-        badContent,
-        goodContent,
-        restContent
-    }
-}
diff --git a/docs/src/utils/sidebarUtils.ts b/docs/src/utils/sidebarUtils.ts
deleted file mode 100644
index 1755e7ec..00000000
--- a/docs/src/utils/sidebarUtils.ts
+++ /dev/null
@@ -1,157 +0,0 @@
-import type { SidebarItem, SidebarConfig } from '../types/sidebar'
-import sidebarEn from '../config/sidebar.en.json'
-import sidebarRu from '../config/sidebar.ru.json'
-
-const STORAGE_KEY = 'docs-sidebar-expanded'
-
-/**
- * Загружает конфигурацию sidebar
- */
-export function loadSidebarConfig(): SidebarConfig {
-    // Определяем язык: сначала localStorage, затем i18next (если доступен), fallback 'en'
-    let lang = 'en'
-    try {
-        const stored = localStorage.getItem('language')
-        if (stored) {
-            lang = stored
-        } else if ((window as any).i18next?.language) {
-            lang = (window as any).i18next.language
-        }
-    } catch {
-        // ignore any access errors
-    }
-
-    // Выбор конфигурации по языку с fallback на английский
-    if (lang === 'ru') {
-        return (sidebarRu as SidebarConfig)
-    }
-    return (sidebarEn as SidebarConfig)
-}
-
-/**
- * Находит элемент sidebar по пути
- */
-export function findItemByPath(
-    config: SidebarConfig,
-    path: string
-): SidebarItem | null {
-    for (const item of config) {
-        if (item.path === path) {
-            return item
-        }
-        if (item.children) {
-            const found = findItemByPath(item.children, path)
-            if (found) return found
-        }
-    }
-    return null
-}
-
-/**
- * Получает все родительские пути для заданного пути
- * Используется для автоматического разворачивания секций
- */
-export function getParentPaths(
-    config: SidebarConfig,
-    targetPath: string
-): string[] {
-    const parents: string[] = []
-
-    function findParents(items: SidebarConfig, currentPath: string[] = []): boolean {
-        for (const item of items) {
-            const newPath = item.path ? [...currentPath, item.path] : currentPath
-
-            if (item.path === targetPath) {
-                parents.push(...currentPath)
-                return true
-            }
-
-            if (item.children) {
-                if (findParents(item.children, newPath)) {
-                    if (item.path) {
-                        parents.push(item.path)
-                    }
-                    return true
-                }
-            }
-        }
-        return false
-    }
-
-    findParents(config)
-    return parents
-}
-
-/**
- * Генерирует уникальный ID для элемента sidebar на основе его пути
- */
-export function getItemId(item: SidebarItem, index: number): string {
-    return item.path || `section-${item.title.toLowerCase().replace(/\s+/g, '-')}-${index}`
-}
-
-/**
- * Сохраняет состояние развернутых секций в localStorage
- */
-export function saveExpandedState(sections: Set<string>): void {
-    try {
-        localStorage.setItem(STORAGE_KEY, JSON.stringify(Array.from(sections)))
-    } catch (error) {
-        console.error('Failed to save sidebar state:', error)
-    }
-}
-
-/**
- * Загружает состояние развернутых секций из localStorage
- */
-export function loadExpandedState(): Set<string> {
-    try {
-        const stored = localStorage.getItem(STORAGE_KEY)
-        if (stored) {
-            return new Set(JSON.parse(stored))
-        }
-    } catch (error) {
-        console.error('Failed to load sidebar state:', error)
-    }
-    return new Set()
-}
-
-/**
- * Проверяет, является ли путь активным (точное совпадение или начало текущего пути)
- */
-export function isPathActive(itemPath: string | undefined, currentPath: string): boolean {
-    if (!itemPath) return false
-    return currentPath === itemPath || currentPath.startsWith(itemPath + '/')
-}
-
-/**
- * Returns the previous and next navigation items for the current path
- */
-export function getPrevNext(
-    config: SidebarConfig,
-    currentPath: string
-): { prev: SidebarItem | null; next: SidebarItem | null } {
-    const flatItems: SidebarItem[] = []
-
-    function flatten(items: SidebarConfig) {
-        for (const item of items) {
-            if (item.path) {
-                flatItems.push(item)
-            }
-            if (item.children) {
-                flatten(item.children)
-            }
-        }
-    }
-
-    flatten(config)
-
-    const index = flatItems.findIndex(item => item.path === currentPath)
-    if (index === -1) {
-        return { prev: null, next: null }
-    }
-
-    return {
-        prev: index > 0 ? flatItems[index - 1] : null,
-        next: index < flatItems.length - 1 ? flatItems[index + 1] : null
-    }
-}
diff --git a/docs/src/utils/useMarkdown.ts b/docs/src/utils/useMarkdown.ts
deleted file mode 100644
index eb17f514..00000000
--- a/docs/src/utils/useMarkdown.ts
+++ /dev/null
@@ -1,54 +0,0 @@
-import { useState, useEffect } from 'react'
-
-interface UseMarkdownResult {
-    content: string
-    isLoading: boolean
-    error: string | null
-}
-
-export function useMarkdown(path: string): UseMarkdownResult {
-    const [content, setContent] = useState('')
-    const [isLoading, setIsLoading] = useState(true)
-    const [error, setError] = useState<string | null>(null)
-
-    useEffect(() => {
-        let isMounted = true
-
-        async function loadMarkdown() {
-            try {
-                setIsLoading(true)
-                setError(null)
-
-                // Construct path to MD file in public folder
-                const mdPath = `/docs/${path}.md`
-                const response = await fetch(mdPath)
-
-                if (!response.ok) {
-                    throw new Error(`Failed to load documentation: ${response.statusText}`)
-                }
-
-                const text = await response.text()
-
-                if (isMounted) {
-                    setContent(text)
-                    setIsLoading(false)
-                }
-            } catch (err) {
-                if (isMounted) {
-                    setError(err instanceof Error ? err.message : 'Failed to load documentation')
-                    setIsLoading(false)
-                }
-            }
-        }
-
-        if (path) {
-            loadMarkdown()
-        }
-
-        return () => {
-            isMounted = false
-        }
-    }, [path])
-
-    return { content, isLoading, error }
-}
diff --git a/docs/tailwind.config.js b/docs/tailwind.config.js
deleted file mode 100644
index 45fc27f6..00000000
--- a/docs/tailwind.config.js
+++ /dev/null
@@ -1,41 +0,0 @@
-/** @type {import('tailwindcss').Config} */
-export default {
-    content: [
-        "./index.html",
-        "./src/**/*.{js,ts,jsx,tsx}",
-    ],
-    darkMode: 'class',
-    theme: {
-        extend: {
-            fontFamily: {
-                sans: ['Inter', 'sans-serif'],
-                mono: ['JetBrains Mono', 'monospace'],
-            },
-            colors: {
-                // Modern Palette based on Slate
-                background: '#020617', // Slate 950
-                surface: '#0f172a',    // Slate 900
-                surfaceHighlight: '#1e293b', // Slate 800
-                border: '#334155',     // Slate 700
-                primary: '#3b82f6',    // Blue 500
-                primaryGlow: '#60a5fa', // Blue 400
-                secondary: '#8b5cf6',  // Violet 500
-            },
-            animation: {
-                'float': 'float 6s ease-in-out infinite',
-                'fade-in-up': 'fadeInUp 0.8s ease-out forwards',
-            },
-            keyframes: {
-                float: {
-                    '0%, 100%': { transform: 'translateY(0)' },
-                    '50%': { transform: 'translateY(-20px)' },
-                },
-                fadeInUp: {
-                    '0%': { opacity: '0', transform: 'translateY(20px)' },
-                    '100%': { opacity: '1', transform: 'translateY(0)' },
-                }
-            }
-        }
-    },
-    plugins: [],
-}
diff --git a/docs/test-pagination.ts b/docs/test-pagination.ts
deleted file mode 100644
index 682a5bac..00000000
--- a/docs/test-pagination.ts
+++ /dev/null
@@ -1,9 +0,0 @@
-import { getAdjacentPages } from './src/utils/getAdjacentPages.ts'
-
-const path = 'guide/introduction/what-is'
-const result = getAdjacentPages(path)
-console.log('Result for', path, ':', JSON.stringify(result, null, 2))
-
-const path2 = 'guide/cli/linter/rules/package-same-java-multiple-files'
-const result2 = getAdjacentPages(path2)
-console.log('Result for', path2, ':', JSON.stringify(result2, null, 2))
diff --git a/docs/tsconfig.json b/docs/tsconfig.json
deleted file mode 100644
index 0caac1b3..00000000
--- a/docs/tsconfig.json
+++ /dev/null
@@ -1,28 +0,0 @@
-{
-    "compilerOptions": {
-        "target": "ES2020",
-        "useDefineForClassFields": true,
-        "lib": [
-            "ES2020",
-            "DOM",
-            "DOM.Iterable"
-        ],
-        "module": "ESNext",
-        "skipLibCheck": true,
-        /* Bundler mode */
-        "moduleResolution": "bundler",
-        "allowImportingTsExtensions": true,
-        "isolatedModules": true,
-        "moduleDetection": "force",
-        "noEmit": true,
-        "jsx": "react-jsx",
-        /* Linting */
-        "strict": true,
-        "noUnusedLocals": true,
-        "noUnusedParameters": true,
-        "noFallthroughCasesInSwitch": true
-    },
-    "include": [
-        "src"
-    ]
-}
\ No newline at end of file
diff --git a/docs/tsconfig.tsbuildinfo b/docs/tsconfig.tsbuildinfo
deleted file mode 100644
index be824d87..00000000
--- a/docs/tsconfig.tsbuildinfo
+++ /dev/null
@@ -1 +0,0 @@
-{"root":["./src/app.tsx","./src/main.tsx","./src/components/architecturecomparison.tsx","./src/components/easyplogo.tsx","./src/components/errorboundary.tsx","./src/components/featureswitcher.tsx","./src/components/footer.tsx","./src/components/hero.tsx","./src/components/languageswitcher.tsx","./src/components/mermaid.tsx","./src/components/navbar.tsx","./src/components/registrypreview.tsx","./src/components/trustedby.tsx","./src/components/docs/docsheader.tsx","./src/components/docs/docslayout.tsx","./src/components/docs/docssearch.tsx","./src/components/docs/docssidebar.tsx","./src/components/docs/markdownpage.tsx","./src/components/docs/notfound.tsx","./src/components/docs/sidebaritem.tsx","./src/contexts/toccontext.tsx","./src/i18n/config.ts","./src/lib/markdown/exampleusage.tsx","./src/lib/markdown/demo.tsx","./src/lib/markdown/index.ts","./src/lib/markdown/processor.tsx","./src/lib/markdown/types.ts","./src/lib/markdown/components/codeblock.tsx","./src/lib/markdown/components/customblock.tsx","./src/lib/markdown/components/heading.tsx","./src/lib/markdown/components/markdowncontent.tsx","./src/lib/markdown/components/tableofcontents.tsx","./src/lib/markdown/plugins/codefocus.tsx","./src/lib/markdown/plugins/htmlblocks.tsx","./src/lib/markdown/plugins/links.tsx","./src/lib/markdown/plugins/mermaid.tsx","./src/lib/markdown/plugins/toc.tsx","./src/lib/markdown/utils/frontmatter.ts","./src/lib/markdown/utils/headings.ts","./src/lib/markdown/utils/paths.ts","./src/lib/markdown/utils/prismtheme.ts","./src/lib/search/search.ts","./src/lib/search/types.ts","./src/pages/blogpage.tsx","./src/pages/blogpostpage.tsx","./src/pages/homepage.tsx","./src/routes/docsroutes.tsx","./src/types/sidebar.ts","./src/utils/extractheadings.ts","./src/utils/github.ts","./src/utils/parsebadgood.ts","./src/utils/sidebarutils.ts","./src/utils/usemarkdown.ts"],"version":"5.9.3"}
\ No newline at end of file
diff --git a/docs/vite.config.ts b/docs/vite.config.ts
deleted file mode 100644
index 4905d6f1..00000000
--- a/docs/vite.config.ts
+++ /dev/null
@@ -1,25 +0,0 @@
-import { defineConfig } from 'vite'
-import react from '@vitejs/plugin-react'
-
-// https://vite.dev/config/
-export default defineConfig({
-    plugins: [react()],
-    define: {
-        // Provide Buffer polyfill for gray-matter library
-        global: 'globalThis',
-    },
-    resolve: {
-        alias: {
-            // Use buffer polyfill for browser
-            buffer: 'buffer',
-        },
-    },
-    optimizeDeps: {
-        esbuildOptions: {
-            // Node.js global to browser globalThis
-            define: {
-                global: 'globalThis',
-            },
-        },
-    },
-})
diff --git a/easyp.gen.yaml b/easyp.gen.yaml
new file mode 100644
index 00000000..9e87689e
--- /dev/null
+++ b/easyp.gen.yaml
@@ -0,0 +1,4 @@
+version: v1
+plugins:
+  - name: python
+    out: examples/generated/python
diff --git a/easyp.yaml b/easyp.yaml
index d833f978..98cd1c25 100644
--- a/easyp.yaml
+++ b/easyp.yaml
@@ -1,90 +1,18 @@
-lint:
-
-  use:
-    # Minimal
-    - DIRECTORY_SAME_PACKAGE
-    - PACKAGE_DEFINED
-    - PACKAGE_DIRECTORY_MATCH
-    - PACKAGE_SAME_DIRECTORY
-
-    # Basic
-    - ENUM_FIRST_VALUE_ZERO
-    - ENUM_NO_ALLOW_ALIAS
-    - ENUM_PASCAL_CASE
-    - ENUM_VALUE_UPPER_SNAKE_CASE
-    - FIELD_LOWER_SNAKE_CASE
-    - IMPORT_NO_PUBLIC
-    - IMPORT_NO_WEAK
-    - IMPORT_USED
-    - MESSAGE_PASCAL_CASE
-    - ONEOF_LOWER_SNAKE_CASE
-    - PACKAGE_LOWER_SNAKE_CASE
-    - PACKAGE_SAME_CSHARP_NAMESPACE
-    - PACKAGE_SAME_GO_PACKAGE
-    - PACKAGE_SAME_JAVA_MULTIPLE_FILES
-    - PACKAGE_SAME_JAVA_PACKAGE
-    - PACKAGE_SAME_PHP_NAMESPACE
-    - PACKAGE_SAME_RUBY_PACKAGE
-    - PACKAGE_SAME_SWIFT_PREFIX
-    - RPC_PASCAL_CASE
-    - SERVICE_PASCAL_CASE
-
-    # Default
-    - ENUM_VALUE_PREFIX
-    - ENUM_ZERO_VALUE_SUFFIX
-    - FILE_LOWER_SNAKE_CASE
-    - RPC_REQUEST_RESPONSE_UNIQUE
-    - RPC_REQUEST_STANDARD_NAME
-    - RPC_RESPONSE_STANDARD_NAME
-    - PACKAGE_VERSION_SUFFIX
-    - SERVICE_SUFFIX
-
-    # Comments
-    - COMMENT_ENUM
-    - COMMENT_ENUM_VALUE
-    - COMMENT_FIELD
-    - COMMENT_MESSAGE
-    - COMMENT_ONEOF
-    - COMMENT_RPC
-    - COMMENT_SERVICE
-
-    # Unary RPC
-    - RPC_NO_CLIENT_STREAMING
-    - RPC_NO_SERVER_STREAMING
-
-  enum_zero_value_suffix: NONE
-
-  service_suffix: API
-
-deps:
-  - github.com/googleapis/googleapis
-  - github.com/bufbuild/protoc-gen-validate
-  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-
-generate:
-  inputs:
-    - directory: "api"
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-    - name: grpc-gateway
-      out: .
-      opts:
-        paths: source_relative
-    - name: openapiv2
-      out: .
-      opts:
-        simple_operation_ids: false
-        generate_unbound_methods: false
-    - remote: localhost:8080/protoc-gen-python:v32.1
-      out: .
-      opts:
-        simple_operation_ids: false
-        generate_unbound_methods: false
+version: v1
+linters:
+  default: STANDARD
+  enable: [COMMENTS, UNARY_RPC]
+linters-settings:
+  ENUM_ZERO_VALUE_SUFFIX:
+    suffix: NONE
+  SERVICE_SUFFIX:
+    suffix: API
+issues:
+  exclude-rules:
+    - path: testdata
+    - path: wellknownimports
+    - path: examples/generated
+breaking:
+  baseline: git:main
+  categories: [FILE]
+  ignore: [testdata, wellknownimports, examples/generated]
diff --git a/example.easyp.yaml b/example.easyp.yaml
index 9975f688..1f66a02f 100644
--- a/example.easyp.yaml
+++ b/example.easyp.yaml
@@ -1,52 +1,7 @@
-lint:
-  use:
-    - COMMENT_ENUM
-    - COMMENT_ONEOF
-    - COMMENT_RPC
-    - COMMENT_SERVICE
-    - IMPORT_USED
-deps:
-#  - github.com/googleapis/googleapis
-#  - github.com/googleapis/googleapis@common-protos-1_3_1
-#  - github.com/googleapis/googleapis@27156597fdf4fb77004434d4409154a230dc9a32
-#  - github.com/googleapis/googleapis@eae19435eb84f8f7a78000858432b64455525ee7
-  #
-#  - github.com/bufbuild/protovalidate@v0.3.1
-#  - github.com/grpc-ecosystem/grpc-gateway@v2.19.1
-
+version: v1
+linters:
+  default: STANDARD
+  allow_comment_ignores: true
 breaking:
-  ignore:
-    - some_dir
-  against_git_ref: master
-  use:
-    - FILE
-
-generate:
-  inputs:
-    - directory: "proto"
-    - git_repo:
-        url: "github.com/sipki-tech/currency@v0.1.2"
-  plugins:
-    - name: go
-      out: .
-      opts:
-        paths: source_relative
-    - name: go-grpc
-      out: .
-      opts:
-        paths: source_relative
-        require_unimplemented_servers: false
-    - name: grpc-gateway
-      out: .
-      opts:
-        paths: source_relative
-    - name: openapiv2
-      out: .
-      opts:
-        simple_operation_ids: false
-        generate_unbound_methods: false
-    - name: validate-go
-      out: .
-      opts:
-        paths: source_relative
-
+  baseline: git:main
+  categories: [FILE]
diff --git a/example.protobuf.mod b/example.protobuf.mod
new file mode 100644
index 00000000..af92c767
--- /dev/null
+++ b/example.protobuf.mod
@@ -0,0 +1,6 @@
+// Copy and change the identity for your own project.
+module github.com/acme/contracts
+roots proto
+
+// Add dependencies explicitly with easyp get <source>@<version>.
+// A local development replacement uses: replace <source> => ../local-copy
diff --git a/examples/proto/hello/v1/hello.proto b/examples/proto/hello/v1/hello.proto
new file mode 100644
index 00000000..e174e807
--- /dev/null
+++ b/examples/proto/hello/v1/hello.proto
@@ -0,0 +1,27 @@
+syntax = "proto3";
+
+package hello.v1;
+
+import "google/protobuf/timestamp.proto";
+
+option go_package = "github.com/easyp-tech/easyp/examples/generated/go/hello/v1;hellov1";
+
+// HelloRequest selects the person to greet.
+message HelloRequest {
+  // Name identifies the person.
+  string name = 1;
+}
+
+// HelloResponse returns a greeting and its creation time.
+message HelloResponse {
+  // Greeting contains the response text.
+  string greeting = 1;
+  // CreatedAt records the creation time.
+  google.protobuf.Timestamp created_at = 2;
+}
+
+// HelloAPI provides a simple unary greeting example.
+service HelloAPI {
+  // Hello returns a greeting for one person.
+  rpc Hello(HelloRequest) returns (HelloResponse);
+}
diff --git a/go.mod b/go.mod
index 86ca3ba8..1c458c36 100644
--- a/go.mod
+++ b/go.mod
@@ -3,19 +3,13 @@ module github.com/easyp-tech/easyp
 go 1.26.6
 
 require (
-	github.com/Yakwilik/go-yamlvalidator v0.2.1
+	github.com/Yakwilik/go-yamlvalidator v0.3.1
 	github.com/a8m/envsubst v1.4.3
-	github.com/brianvoe/gofakeit/v6 v6.28.0
 	github.com/bufbuild/protocompile v0.14.1
-	github.com/charmbracelet/bubbletea v1.3.10
-	github.com/charmbracelet/lipgloss v1.1.0
-	github.com/codeclysm/extract/v3 v3.1.1
+	github.com/charmbracelet/x/term v0.2.1
 	github.com/easyp-tech/service/api v1.0.0
 	github.com/go-git/go-git/v5 v5.16.3
-	github.com/google/jsonschema-go v0.4.3
-	github.com/invopop/jsonschema v0.13.0
 	github.com/modelcontextprotocol/go-sdk v1.6.1
-	github.com/otiai10/copy v1.14.1
 	github.com/samber/lo v1.52.0
 	github.com/stretchr/testify v1.11.1
 	github.com/tetratelabs/wazero v1.9.0
@@ -23,72 +17,47 @@ require (
 	github.com/wasilibs/wazero-helpers v0.0.0-20250123031827-cd30c44769bb
 	github.com/yoheimuta/go-protoparser/v4 v4.14.2
 	golang.org/x/mod v0.38.0
+	golang.org/x/sys v0.47.0
 	google.golang.org/grpc v1.83.2
 	google.golang.org/protobuf v1.36.11
 	gopkg.in/yaml.v3 v3.0.1
 )
 
-require (
-	github.com/bahlo/generic-list-go v0.2.0 // indirect
-	github.com/buger/jsonparser v1.1.1 // indirect
-	github.com/mailru/easyjson v0.7.7 // indirect
-	github.com/segmentio/asm v1.2.1 // indirect
-	github.com/segmentio/encoding v0.5.4 // indirect
-	github.com/wk8/go-ordered-map/v2 v2.1.8 // indirect
-	github.com/yosida95/uritemplate/v3 v3.0.2 // indirect
-	golang.org/x/oauth2 v0.36.0 // indirect
-)
-
 require (
 	dario.cat/mergo v1.0.2 // indirect
 	github.com/Microsoft/go-winio v0.6.2 // indirect
 	github.com/ProtonMail/go-crypto v1.3.0 // indirect
-	github.com/aymanbagabas/go-osc52/v2 v2.0.1 // indirect
-	github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc // indirect
-	github.com/charmbracelet/x/ansi v0.10.1 // indirect
-	github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd // indirect
-	github.com/charmbracelet/x/term v0.2.1 // indirect
 	github.com/cloudflare/circl v1.6.1 // indirect
 	github.com/cpuguy83/go-md2man/v2 v2.0.7 // indirect
 	github.com/cyphar/filepath-securejoin v0.6.0 // indirect
 	github.com/davecgh/go-spew v1.1.1 // indirect
+	github.com/dlclark/regexp2 v1.12.0 // indirect
 	github.com/easyp-tech/protoc-gen-easydoc v0.4.0 // indirect
 	github.com/easyp-tech/protoc-gen-mcp v0.5.0 // indirect
 	github.com/emirpasic/gods v1.18.1 // indirect
-	github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f // indirect
 	github.com/go-git/gcfg v1.5.1-0.20230307220236-3a3c6141e376 // indirect
 	github.com/go-git/go-billy/v5 v5.6.2 // indirect
 	github.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8 // indirect
-	github.com/h2non/filetype v1.1.3 // indirect
+	github.com/google/jsonschema-go v0.4.3 // indirect
 	github.com/jbenet/go-context v0.0.0-20150711004518-d14ea06fba99 // indirect
-	github.com/juju/errors v1.0.0 // indirect
 	github.com/kevinburke/ssh_config v1.4.0 // indirect
-	github.com/klauspost/compress v1.18.1 // indirect
 	github.com/klauspost/cpuid/v2 v2.3.0 // indirect
-	github.com/lucasb-eyer/go-colorful v1.2.0 // indirect
-	github.com/mattn/go-isatty v0.0.20 // indirect
-	github.com/mattn/go-localereader v0.0.1 // indirect
-	github.com/mattn/go-runewidth v0.0.16 // indirect
-	github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 // indirect
-	github.com/muesli/cancelreader v0.2.2 // indirect
-	github.com/muesli/termenv v0.16.0 // indirect
-	github.com/otiai10/mint v1.6.3 // indirect
 	github.com/pjbgf/sha1cd v0.5.0 // indirect
 	github.com/pmezard/go-difflib v1.0.0 // indirect
-	github.com/rivo/uniseg v0.4.7 // indirect
 	github.com/russross/blackfriday/v2 v2.1.0 // indirect
+	github.com/santhosh-tekuri/jsonschema/v6 v6.0.3 // indirect
+	github.com/segmentio/asm v1.2.1 // indirect
+	github.com/segmentio/encoding v0.5.4 // indirect
 	github.com/sergi/go-diff v1.4.0 // indirect
 	github.com/skeema/knownhosts v1.3.2 // indirect
-	github.com/stretchr/objx v0.5.3 // indirect
-	github.com/ulikunitz/xz v0.5.15 // indirect
 	github.com/xanzy/ssh-agent v0.3.3 // indirect
-	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
 	github.com/xrash/smetrics v0.0.0-20250705151800-55b8f293f342 // indirect
+	github.com/yosida95/uritemplate/v3 v3.0.2 // indirect
 	golang.org/x/crypto v0.55.0 // indirect
 	golang.org/x/exp v0.0.0-20250408133849-7e4ce0ab07d0 // indirect
 	golang.org/x/net v0.58.0 // indirect
+	golang.org/x/oauth2 v0.36.0 // indirect
 	golang.org/x/sync v0.22.0 // indirect
-	golang.org/x/sys v0.47.0 // indirect
 	golang.org/x/text v0.41.0 // indirect
 	google.golang.org/genproto/googleapis/rpc v0.0.0-20260526163538-3dc84a4a5aaa // indirect
 	gopkg.in/warnings.v0 v0.1.2 // indirect
diff --git a/go.sum b/go.sum
index 81b46a0b..33de6a60 100644
--- a/go.sum
+++ b/go.sum
@@ -5,44 +5,22 @@ github.com/Microsoft/go-winio v0.6.2 h1:F2VQgta7ecxGYO8k3ZZz3RS8fVIXVxONVUPlNERo
 github.com/Microsoft/go-winio v0.6.2/go.mod h1:yd8OoFMLzJbo9gZq8j5qaps8bJ9aShtEA8Ipt1oGCvU=
 github.com/ProtonMail/go-crypto v1.3.0 h1:ILq8+Sf5If5DCpHQp4PbZdS1J7HDFRXz/+xKBiRGFrw=
 github.com/ProtonMail/go-crypto v1.3.0/go.mod h1:9whxjD8Rbs29b4XWbB8irEcE8KHMqaR2e7GWU1R+/PE=
-github.com/Yakwilik/go-yamlvalidator v0.2.1 h1:9j9pj6pXf5KOgxKzoxhxaN2/Ed4ummIoDtOGj69TBK0=
-github.com/Yakwilik/go-yamlvalidator v0.2.1/go.mod h1:/2WJvPxGxWLfbdKaKEPzYkiuFjLuvCrqsMb2NdQSdWI=
+github.com/Yakwilik/go-yamlvalidator v0.3.1 h1:LJJ0Fz3oMIh3/pLkyH9naXhuci9jzSiYzjj+E9Bm8/4=
+github.com/Yakwilik/go-yamlvalidator v0.3.1/go.mod h1:glqKfQ9255T6q3xWDNNq0VFaThdP6yc7vnKPF9Z43Ig=
 github.com/a8m/envsubst v1.4.3 h1:kDF7paGK8QACWYaQo6KtyYBozY2jhQrTuNNuUxQkhJY=
 github.com/a8m/envsubst v1.4.3/go.mod h1:4jjHWQlZoaXPoLQUb7H2qT4iLkZDdmEQiOUogdUmqVU=
 github.com/anmitsu/go-shlex v0.0.0-20200514113438-38f4b401e2be h1:9AeTilPcZAjCFIImctFaOjnTIavg87rW78vTPkQqLI8=
 github.com/anmitsu/go-shlex v0.0.0-20200514113438-38f4b401e2be/go.mod h1:ySMOLuWl6zY27l47sB3qLNK6tF2fkHG55UZxx8oIVo4=
-github.com/arduino/go-paths-helper v1.2.0 h1:qDW93PR5IZUN/jzO4rCtexiwF8P4OIcOmcSgAYLZfY4=
-github.com/arduino/go-paths-helper v1.2.0/go.mod h1:HpxtKph+g238EJHq4geEPv9p+gl3v5YYu35Yb+w31Ck=
 github.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5 h1:0CwZNZbxp69SHPdPJAN/hZIm0C4OItdklCFmMRWYpio=
 github.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5/go.mod h1:wHh0iHkYZB8zMSxRWpUBQtwG5a7fFgvEO+odwuTv2gs=
-github.com/aymanbagabas/go-osc52/v2 v2.0.1 h1:HwpRHbFMcZLEVr42D4p7XBqjyuxQH5SMiErDT4WkJ2k=
-github.com/aymanbagabas/go-osc52/v2 v2.0.1/go.mod h1:uYgXzlJ7ZpABp8OJ+exZzJJhRNQ2ASbcXHWsFqH8hp8=
-github.com/bahlo/generic-list-go v0.2.0 h1:5sz/EEAK+ls5wF+NeqDpk5+iNdMDXrh3z3nPnH1Wvgk=
-github.com/bahlo/generic-list-go v0.2.0/go.mod h1:2KvAjgMlE5NNynlg/5iLrrCCZ2+5xWbdbCW3pNTGyYg=
-github.com/brianvoe/gofakeit/v6 v6.28.0 h1:Xib46XXuQfmlLS2EXRuJpqcw8St6qSZz75OUo0tgAW4=
-github.com/brianvoe/gofakeit/v6 v6.28.0/go.mod h1:Xj58BMSnFqcn/fAQeSK+/PLtC5kSb7FJIq4JyGa8vEs=
 github.com/bufbuild/protocompile v0.14.1 h1:iA73zAf/fyljNjQKwYzUHD6AD4R8KMasmwa/FBatYVw=
 github.com/bufbuild/protocompile v0.14.1/go.mod h1:ppVdAIhbr2H8asPk6k4pY7t9zB1OU5DoEw9xY/FUi1c=
-github.com/buger/jsonparser v1.1.1 h1:2PnMjfWD7wBILjqQbt530v576A/cAbQvEW9gGIpYMUs=
-github.com/buger/jsonparser v1.1.1/go.mod h1:6RYKKt7H4d4+iWqouImQ9R2FZql3VbhNgx27UK13J/0=
 github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
 github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
-github.com/charmbracelet/bubbletea v1.3.10 h1:otUDHWMMzQSB0Pkc87rm691KZ3SWa4KUlvF9nRvCICw=
-github.com/charmbracelet/bubbletea v1.3.10/go.mod h1:ORQfo0fk8U+po9VaNvnV95UPWA1BitP1E0N6xJPlHr4=
-github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc h1:4pZI35227imm7yK2bGPcfpFEmuY1gc2YSTShr4iJBfs=
-github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc/go.mod h1:X4/0JoqgTIPSFcRA/P6INZzIuyqdFY5rm8tb41s9okk=
-github.com/charmbracelet/lipgloss v1.1.0 h1:vYXsiLHVkK7fp74RkV7b2kq9+zDLoEU4MZoFqR/noCY=
-github.com/charmbracelet/lipgloss v1.1.0/go.mod h1:/6Q8FR2o+kj8rz4Dq0zQc3vYf7X+B0binUUBwA0aL30=
-github.com/charmbracelet/x/ansi v0.10.1 h1:rL3Koar5XvX0pHGfovN03f5cxLbCF2YvLeyz7D2jVDQ=
-github.com/charmbracelet/x/ansi v0.10.1/go.mod h1:3RQDQ6lDnROptfpWuUVIUG64bD2g2BgntdxH0Ya5TeE=
-github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd h1:vy0GVL4jeHEwG5YOXDmi86oYw2yuYUGqz6a8sLwg0X8=
-github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd/go.mod h1:xe0nKWGd3eJgtqZRaN9RjMtK7xUYchjzPr7q6kcvCCs=
 github.com/charmbracelet/x/term v0.2.1 h1:AQeHeLZ1OqSXhrAWpYUtZyX1T3zVxfpZuEQMIQaGIAQ=
 github.com/charmbracelet/x/term v0.2.1/go.mod h1:oQ4enTYFV7QN4m0i9mzHrViD7TQKvNEEkHUMCmsxdUg=
 github.com/cloudflare/circl v1.6.1 h1:zqIqSPIndyBh1bjLVVDHMPpVKqp8Su/V+6MeDzzQBQ0=
 github.com/cloudflare/circl v1.6.1/go.mod h1:uddAzsPgqdMAYatqJ0lsjX1oECcQLIlRpzZh3pJrofs=
-github.com/codeclysm/extract/v3 v3.1.1 h1:iHZtdEAwSTqPrd+1n4jfhr1qBhUWtHlMTjT90+fJVXg=
-github.com/codeclysm/extract/v3 v3.1.1/go.mod h1:ZJi80UG2JtfHqJI+lgJSCACttZi++dHxfWuPaMhlOfQ=
 github.com/cpuguy83/go-md2man/v2 v2.0.7 h1:zbFlGlXEAKlwXpmvle3d8Oe3YnkKIK4xSRTd3sHPnBo=
 github.com/cpuguy83/go-md2man/v2 v2.0.7/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
 github.com/cyphar/filepath-securejoin v0.6.0 h1:BtGB77njd6SVO6VztOHfPxKitJvd/VPT+OFBFMOi1Is=
@@ -50,6 +28,8 @@ github.com/cyphar/filepath-securejoin v0.6.0/go.mod h1:A8hd4EnAeyujCJRrICiOWqjS1
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/dlclark/regexp2 v1.12.0 h1:0j4c5qQmnC6XOWNjP3PIXURXN2gWx76rd3KvgdPkCz8=
+github.com/dlclark/regexp2 v1.12.0/go.mod h1:DHkYz0B9wPfa6wondMfaivmHpzrQ3v9q8cnmRbL6yW8=
 github.com/easyp-tech/protoc-gen-easydoc v0.4.0 h1:JJREL3C/+EKf9lzypTAGo6QeUWDtDKVxK1aq8EbRzzc=
 github.com/easyp-tech/protoc-gen-easydoc v0.4.0/go.mod h1:/NhDdfMihhuPWYUy74Hf0VaUtzOfEStv6UHHpPogQBg=
 github.com/easyp-tech/protoc-gen-mcp v0.5.0 h1:1zCrjUwtRAXm2uuN7MCn2qF9yunixgAF9ZtHpay4XiI=
@@ -60,8 +40,6 @@ github.com/elazarl/goproxy v1.7.2 h1:Y2o6urb7Eule09PjlhQRGNsqRfPmYI3KKQLFpCAV3+o
 github.com/elazarl/goproxy v1.7.2/go.mod h1:82vkLNir0ALaW14Rc399OTTjyNREgmdL2cVoIbS6XaE=
 github.com/emirpasic/gods v1.18.1 h1:FXtiHYKDGKCW2KzwZKx0iC0PQmdlorYgdFG9jPXJ1Bc=
 github.com/emirpasic/gods v1.18.1/go.mod h1:8tpGGwCnJ5H4r6BWwaV6OrWmMoPhUl5jm/FMNAnJvWQ=
-github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f h1:Y/CXytFA4m6baUTXGLOoWe4PQhGxaX0KpnayAqC48p4=
-github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f/go.mod h1:vw97MGsxSvLiUE2X8qFplwetxpGLQrlU1Q9AUEIzCaM=
 github.com/gliderlabs/ssh v0.3.8 h1:a4YXD1V7xMF9g5nTkdfnja3Sxy1PVDCj1Zg4Wb8vY6c=
 github.com/gliderlabs/ssh v0.3.8/go.mod h1:xYoytBv1sV0aL3CavoDuJIQNURXkkfPA/wxQ1pL1fAU=
 github.com/go-git/gcfg v1.5.1-0.20230307220236-3a3c6141e376 h1:+zs/tPmkDkHx3U66DAb0lQFJrpS6731Oaa12ikc+DiI=
@@ -88,19 +66,10 @@ github.com/google/jsonschema-go v0.4.3 h1:/DBOLZTfDow7pe2GmaJNhltueGTtDKICi8V8p+
 github.com/google/jsonschema-go v0.4.3/go.mod h1:r5quNTdLOYEz95Ru18zA0ydNbBuYoo9tgaYcxEYhJVE=
 github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
 github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
-github.com/h2non/filetype v1.1.3 h1:FKkx9QbD7HR/zjK1Ia5XiBsq9zdLi5Kf3zGyFTAFkGg=
-github.com/h2non/filetype v1.1.3/go.mod h1:319b3zT68BvV+WRj7cwy856M2ehB3HqNOt6sy1HndBY=
-github.com/invopop/jsonschema v0.13.0 h1:KvpoAJWEjR3uD9Kbm2HWJmqsEaHt8lBUpd0qHcIi21E=
-github.com/invopop/jsonschema v0.13.0/go.mod h1:ffZ5Km5SWWRAIN6wbDXItl95euhFz2uON45H2qjYt+0=
 github.com/jbenet/go-context v0.0.0-20150711004518-d14ea06fba99 h1:BQSFePA1RWJOlocH6Fxy8MmwDt+yVQYULKfN0RoTN8A=
 github.com/jbenet/go-context v0.0.0-20150711004518-d14ea06fba99/go.mod h1:1lJo3i6rXxKeerYnT8Nvf0QmHCRC1n8sfWVwXF2Frvo=
-github.com/josharian/intern v1.0.0/go.mod h1:5DoeVV0s6jJacbCEi61lwdGj/aVlrQvzHFFd8Hwg//Y=
-github.com/juju/errors v1.0.0 h1:yiq7kjCLll1BiaRuNY53MGI0+EQ3rF6GB+wvboZDefM=
-github.com/juju/errors v1.0.0/go.mod h1:B5x9thDqx0wIMH3+aLIMP9HjItInYWObRovoCFM5Qe8=
 github.com/kevinburke/ssh_config v1.4.0 h1:6xxtP5bZ2E4NF5tuQulISpTO2z8XbtH8cg1PWkxoFkQ=
 github.com/kevinburke/ssh_config v1.4.0/go.mod h1:q2RIzfka+BXARoNexmF9gkxEX7DmvbW9P4hIVx2Kg4M=
-github.com/klauspost/compress v1.18.1 h1:bcSGx7UbpBqMChDtsF28Lw6v/G94LPrrbMbdC3JH2co=
-github.com/klauspost/compress v1.18.1/go.mod h1:ZQFFVG+MdnR0P+l6wpXgIL4NTtwiKIdBnrBd8Nrxr+0=
 github.com/klauspost/cpuid/v2 v2.3.0 h1:S4CRMLnYUhGeDFDqkGriYKdfoFlDnMtqTiI/sFzhA9Y=
 github.com/klauspost/cpuid/v2 v2.3.0/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
 github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo=
@@ -110,45 +79,24 @@ github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ=
 github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI=
 github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
 github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
-github.com/lucasb-eyer/go-colorful v1.2.0 h1:1nnpGOrhyZZuNyfu1QjKiUICQ74+3FNCN69Aj6K7nkY=
-github.com/lucasb-eyer/go-colorful v1.2.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0=
-github.com/mailru/easyjson v0.7.7 h1:UGYAvKxe3sBsEDzO8ZeWOSlIQfWFlxbzLZe7hwFURr0=
-github.com/mailru/easyjson v0.7.7/go.mod h1:xzfreul335JAWq5oZzymOObrkdz5UnU4kGfJJLY9Nlc=
-github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
-github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
-github.com/mattn/go-localereader v0.0.1 h1:ygSAOl7ZXTx4RdPYinUpg6W99U8jWvWi9Ye2JC/oIi4=
-github.com/mattn/go-localereader v0.0.1/go.mod h1:8fBrzywKY7BI3czFoHkuzRoWE9C+EiG4R1k4Cjx5p88=
-github.com/mattn/go-runewidth v0.0.16 h1:E5ScNMtiwvlvB5paMFdw9p4kSQzbXFikJ5SQO6TULQc=
-github.com/mattn/go-runewidth v0.0.16/go.mod h1:Jdepj2loyihRzMpdS35Xk/zdY8IAYHsh153qUoGf23w=
 github.com/modelcontextprotocol/go-sdk v1.6.1 h1:0zOSupjKUxPKSocPT1Wtago+mUHU2/uZ4xSOY0FGReU=
 github.com/modelcontextprotocol/go-sdk v1.6.1/go.mod h1:kzm3kzFL1/+AziGOE0nUs3gvPoNxMCvkxokMkuFapXQ=
-github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 h1:ZK8zHtRHOkbHy6Mmr5D264iyp3TiX5OmNcI5cIARiQI=
-github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6/go.mod h1:CJlz5H+gyd6CUWT45Oy4q24RdLyn7Md9Vj2/ldJBSIo=
-github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=
-github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo=
-github.com/muesli/termenv v0.16.0 h1:S5AlUN9dENB57rsbnkPyfdGuWIlkmzJjbFf0Tf5FWUc=
-github.com/muesli/termenv v0.16.0/go.mod h1:ZRfOIKPFDYQoDFF4Olj7/QJbW60Ol/kL1pU3VfY/Cnk=
 github.com/onsi/gomega v1.34.1 h1:EUMJIKUjM8sKjYbtxQI9A4z2o+rruxnzNvpknOXie6k=
 github.com/onsi/gomega v1.34.1/go.mod h1:kU1QgUvBDLXBJq618Xvm2LUX6rSAfRaFRTcdOeDLwwY=
-github.com/otiai10/copy v1.14.1 h1:5/7E6qsUMBaH5AnQ0sSLzzTg1oTECmcCmT6lvF45Na8=
-github.com/otiai10/copy v1.14.1/go.mod h1:oQwrEDDOci3IM8dJF0d8+jnbfPDllW6vUjNc3DoZm9I=
-github.com/otiai10/mint v1.6.3 h1:87qsV/aw1F5as1eH1zS/yqHY85ANKVMgkDrf9rcxbQs=
-github.com/otiai10/mint v1.6.3/go.mod h1:MJm72SBthJjz8qhefc4z1PYEieWmy8Bku7CjcAqyUSM=
 github.com/pjbgf/sha1cd v0.5.0 h1:a+UkboSi1znleCDUNT3M5YxjOnN1fz2FhN48FlwCxs0=
 github.com/pjbgf/sha1cd v0.5.0/go.mod h1:lhpGlyHLpQZoxMv8HcgXvZEhcGs0PG/vsZnEJ7H0iCM=
 github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4=
 github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
-github.com/rivo/uniseg v0.2.0/go.mod h1:J6wj4VEh+S6ZtnVlnTBMWIodfgj8LQOQFoIToxlJtxc=
-github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
-github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
 github.com/rogpeppe/go-internal v1.14.1 h1:UQB4HGPB6osV0SQTLymcB4TgvyWu6ZyliaW0tI/otEQ=
 github.com/rogpeppe/go-internal v1.14.1/go.mod h1:MaRKkUm5W0goXpeCfT7UZI6fk/L7L7so1lCWt35ZSgc=
 github.com/russross/blackfriday/v2 v2.1.0 h1:JIOH55/0cWyOuilr9/qlrm0BSXldqnqwMsf35Ld67mk=
 github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
 github.com/samber/lo v1.52.0 h1:Rvi+3BFHES3A8meP33VPAxiBZX/Aws5RxrschYGjomw=
 github.com/samber/lo v1.52.0/go.mod h1:4+MXEGsJzbKGaUEQFKBq2xtfuznW9oz/WrgyzMzRoM0=
+github.com/santhosh-tekuri/jsonschema/v6 v6.0.3 h1:1EYB5IzjZawrrnELUi78f9fPu57HuXjmddZPjrls/28=
+github.com/santhosh-tekuri/jsonschema/v6 v6.0.3/go.mod h1:JXeL+ps8p7/KNMjDQk3TCwPpBy0wYklyWTfbkIzdIFU=
 github.com/segmentio/asm v1.2.1 h1:DTNbBqs57ioxAD4PrArqftgypG4/qNpXoJx8TVXxPR0=
 github.com/segmentio/asm v1.2.1/go.mod h1:BqMnlJP91P8d+4ibuonYZw9mfnzI9HfxselHZr5aAcs=
 github.com/segmentio/encoding v0.5.4 h1:OW1VRern8Nw6ITAtwSZ7Idrl3MXCFwXHPgqESYfvNt0=
@@ -159,26 +107,18 @@ github.com/sirupsen/logrus v1.7.0/go.mod h1:yWOB1SBYBC5VeMP7gHvWumXLIWorT60ONWic
 github.com/skeema/knownhosts v1.3.2 h1:EDL9mgf4NzwMXCTfaxSD/o/a5fxDw/xL9nkU28JjdBg=
 github.com/skeema/knownhosts v1.3.2/go.mod h1:bEg3iQAuw+jyiw+484wwFJoKSLwcfd7fqRy+N0QTiow=
 github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
-github.com/stretchr/objx v0.5.3 h1:jmXUvGomnU1o3W/V5h2VEradbpJDwGrzugQQvL0POH4=
-github.com/stretchr/objx v0.5.3/go.mod h1:rDQraq+vQZU7Fde9LOZLr8Tax6zZvy4kuNKF+QYS+U0=
 github.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs=
 github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4=
 github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
 github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
 github.com/tetratelabs/wazero v1.9.0 h1:IcZ56OuxrtaEz8UYNRHBrUa9bYeX9oVY93KspZZBf/I=
 github.com/tetratelabs/wazero v1.9.0/go.mod h1:TSbcXCfFP0L2FGkRPxHphadXPjo1T6W+CseNNY7EkjM=
-github.com/ulikunitz/xz v0.5.15 h1:9DNdB5s+SgV3bQ2ApL10xRc35ck0DuIX/isZvIk+ubY=
-github.com/ulikunitz/xz v0.5.15/go.mod h1:nbz6k7qbPmH4IRqmfOplQw/tblSgqTqBwxkY0oWt/14=
 github.com/urfave/cli/v2 v2.27.7 h1:bH59vdhbjLv3LAvIu6gd0usJHgoTTPhCFib8qqOwXYU=
 github.com/urfave/cli/v2 v2.27.7/go.mod h1:CyNAG/xg+iAOg0N4MPGZqVmv2rCoP267496AOXUZjA4=
 github.com/wasilibs/wazero-helpers v0.0.0-20250123031827-cd30c44769bb h1:gQ+ZV4wJke/EBKYciZ2MshEouEHFuinB85dY3f5s1q8=
 github.com/wasilibs/wazero-helpers v0.0.0-20250123031827-cd30c44769bb/go.mod h1:jMeV4Vpbi8osrE/pKUxRZkVaA0EX7NZN0A9/oRzgpgY=
-github.com/wk8/go-ordered-map/v2 v2.1.8 h1:5h/BUHu93oj4gIdvHHHGsScSTMijfx5PeYkE/fJgbpc=
-github.com/wk8/go-ordered-map/v2 v2.1.8/go.mod h1:5nJHM5DyteebpVlHnWMV0rPz6Zp7+xBAnxjb1X5vnTw=
 github.com/xanzy/ssh-agent v0.3.3 h1:+/15pJfg/RsTxqYcX6fHqOXZwwMP+2VyYWJeWM2qQFM=
 github.com/xanzy/ssh-agent v0.3.3/go.mod h1:6dzNDKs0J9rVPHPhaGCukekBHKqfl+L3KghI1Bc68Uw=
-github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e h1:JVG44RsyaB9T2KIHavMF/ppJZNG9ZpyihvCd0w101no=
-github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM=
 github.com/xrash/smetrics v0.0.0-20250705151800-55b8f293f342 h1:FnBeRrxr7OU4VvAzt5X7s6266i6cSVkkFPS0TuXWbIg=
 github.com/xrash/smetrics v0.0.0-20250705151800-55b8f293f342/go.mod h1:Ohn+xnUBiLI6FVj/9LpzZWtj1/D6lUovWYBkxHVV3aM=
 github.com/yoheimuta/go-protoparser/v4 v4.14.2 h1:/P/LlX1CF9NaTWEltGcIZVvNlPbhABuAnBtAWpb3+74=
@@ -216,9 +156,7 @@ golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7w
 golang.org/x/sys v0.0.0-20210124154548-22da62e12c0c/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
 golang.org/x/sys v0.0.0-20210423082822-04245dca01da/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
 golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.0.0-20210809222454-d867a43fc93e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.47.0 h1:o7XGOvZQCADBQQ4Y7VNq2dRWQR7JmOUW8Kxx4ZsNgWs=
 golang.org/x/sys v0.47.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
 golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
diff --git a/internal/adapters/bsr/resolver.go b/internal/adapters/bsr/resolver.go
new file mode 100644
index 00000000..98b251bf
--- /dev/null
+++ b/internal/adapters/bsr/resolver.go
@@ -0,0 +1,59 @@
+// Package bsr supplies explicit Git compatibility snapshots for known Buf modules.
+package bsr
+
+import (
+	"context"
+	"fmt"
+	"log/slog"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/logger"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+// StaticResolver resolves known modules without contacting BSR or guessing repositories.
+// Logger is optional and reports that Git snapshots do not verify BSR pins or digests.
+type StaticResolver struct {
+	Logger logger.Logger
+}
+
+var _ modules.BSRResolver = StaticResolver{}
+
+// These versions are deliberate compatibility snapshots, not BSR-to-Git revision mappings.
+var knownModules = map[string]v1.Requirement{
+	"buf.build/googleapis/googleapis":          {Module: "github.com/googleapis/googleapis", Version: "03a91044136a014466d4293eb1fe91f2b02075d2"},
+	"buf.build/grpc-ecosystem/grpc-gateway":    {Module: "github.com/grpc-ecosystem/grpc-gateway", Version: "v2.31.0+incompatible"},
+	"buf.build/mercari/grpc-federation":        {Module: "github.com/mercari/grpc-federation", Version: "v1.27.0"},
+	"buf.build/envoyproxy/protoc-gen-validate": {Module: "github.com/envoyproxy/protoc-gen-validate", Version: "v1.3.3"},
+	"buf.build/bufbuild/protovalidate":         {Module: "github.com/bufbuild/protovalidate", Version: "v1.2.2"},
+}
+
+// UnsupportedModuleError identifies a BSR module absent from the explicit mapping.
+type UnsupportedModuleError struct {
+	Module string
+}
+
+// Error explains why no Git source was selected.
+func (err *UnsupportedModuleError) Error() string {
+	return fmt.Sprintf("unsupported BSR module: %s; no mapping in the BSR resolver", err.Module)
+}
+
+// Resolve selects a fixed Git requirement and preserves all supplied BSR metadata.
+func (resolver StaticResolver) Resolve(ctx context.Context, dependency v1.BSRDependency) (v1.BSRResolution, error) {
+	if err := ctx.Err(); err != nil {
+		return v1.BSRResolution{}, fmt.Errorf("Err: %w", err)
+	}
+	if err := dependency.Validate(); err != nil {
+		return v1.BSRResolution{}, fmt.Errorf("Validate: %w", err)
+	}
+	git, ok := knownModules[dependency.Module]
+	if !ok {
+		return v1.BSRResolution{}, &UnsupportedModuleError{Module: dependency.Module}
+	}
+	if resolver.Logger != nil {
+		resolver.Logger.Warn(ctx, "using BSR compatibility snapshot; BSR revision equivalence and digest are not verified",
+			slog.String("bsr_module", dependency.Module), slog.String("bsr_reference", dependency.Reference), slog.String("bsr_commit", dependency.Commit),
+			slog.String("bsr_digest", dependency.Digest), slog.String("config", dependency.Config), slog.String("git_module", git.Module), slog.String("git_version", git.Version))
+	}
+	return v1.BSRResolution{Dependency: dependency, Git: git, Resolution: v1.BSRCompatibilitySnapshot}, nil
+}
diff --git a/internal/adapters/bsr/resolver_test.go b/internal/adapters/bsr/resolver_test.go
new file mode 100644
index 00000000..8fc2ab88
--- /dev/null
+++ b/internal/adapters/bsr/resolver_test.go
@@ -0,0 +1,68 @@
+package bsr
+
+import (
+	"context"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestStaticResolver(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name    string
+		module  string
+		git     v1.Requirement
+		wantErr bool
+	}{
+		{name: "googleapis", module: "buf.build/googleapis/googleapis", git: v1.Requirement{Module: "github.com/googleapis/googleapis", Version: "03a91044136a014466d4293eb1fe91f2b02075d2"}},
+		{name: "gateway", module: "buf.build/grpc-ecosystem/grpc-gateway", git: v1.Requirement{Module: "github.com/grpc-ecosystem/grpc-gateway", Version: "v2.31.0+incompatible"}},
+		{name: "federation", module: "buf.build/mercari/grpc-federation", git: v1.Requirement{Module: "github.com/mercari/grpc-federation", Version: "v1.27.0"}},
+		{name: "PGV", module: "buf.build/envoyproxy/protoc-gen-validate", git: v1.Requirement{Module: "github.com/envoyproxy/protoc-gen-validate", Version: "v1.3.3"}},
+		{name: "protovalidate", module: "buf.build/bufbuild/protovalidate", git: v1.Requirement{Module: "github.com/bufbuild/protovalidate", Version: "v1.2.2"}},
+		{name: "unknown module", module: "buf.build/acme/missing", wantErr: true},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			dependency := v1.BSRDependency{Module: tt.module, Reference: "stable", Commit: strings.Repeat("a", 32), Digest: "b5:" + strings.Repeat("a", 128), Config: "proto/buf.yaml"}
+
+			binding, err := (StaticResolver{}).Resolve(t.Context(), dependency)
+
+			if tt.wantErr {
+				var unsupported *UnsupportedModuleError
+				require.ErrorAs(t, err, &unsupported)
+				assert.Equal(t, tt.module, unsupported.Module)
+				assert.Contains(t, err.Error(), "unsupported BSR module: "+tt.module)
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, dependency, binding.Dependency)
+			assert.Equal(t, tt.git, binding.Git)
+			assert.Equal(t, v1.BSRCompatibilitySnapshot, binding.Resolution)
+			require.NoError(t, binding.Validate())
+		})
+	}
+}
+
+func TestStaticResolverCancellation(t *testing.T) {
+	t.Parallel()
+	tests := []struct{ name string }{{name: "cancelled before resolution"}}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			ctx, cancel := context.WithCancel(t.Context())
+			cancel()
+
+			_, err := (StaticResolver{}).Resolve(ctx, v1.BSRDependency{Module: "buf.build/googleapis/googleapis", Config: "buf.yaml"})
+
+			require.ErrorIs(t, err, context.Canceled)
+		})
+	}
+}
diff --git a/internal/adapters/console/argv_test.go b/internal/adapters/console/argv_test.go
new file mode 100644
index 00000000..ef4da8c7
--- /dev/null
+++ b/internal/adapters/console/argv_test.go
@@ -0,0 +1,67 @@
+package console
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"io"
+	"os"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestCommandArgvHelper(t *testing.T) {
+	if os.Getenv("EASYP_ARGV_TEST_HELPER") != "1" {
+		return
+	}
+	var args []string
+	for i, arg := range os.Args {
+		if arg == "--" {
+			args = os.Args[i+1:]
+			break
+		}
+	}
+	data, err := io.ReadAll(os.Stdin)
+	if err != nil {
+		os.Exit(2)
+	}
+	body, err := json.Marshal(struct {
+		Args  []string
+		Stdin string
+	}{args, string(data)})
+	if err != nil {
+		os.Exit(2)
+	}
+	fmt.Print(string(body))
+	os.Exit(0)
+}
+
+func TestRunCmdWithStdinPreservesArgv(t *testing.T) {
+	// The helper uses an environment flag; do not share it with parallel tests.
+	t.Setenv("EASYP_ARGV_TEST_HELPER", "1")
+	executable, err := os.Executable()
+	require.NoError(t, err)
+	args := []string{"argument with spaces", "'quoted'", "", "$HOME", "$(printf should-not-run)", "; echo not-a-command", "*"}
+	for _, tt := range []struct {
+		name string
+		run  func(context.Context, string, io.Reader, string, ...string) (string, error)
+	}{
+		{name: "bash adapter", run: (bash{}).RunCmdWithStdin},
+		{name: "powershell adapter", run: (powershell{}).RunCmdWithStdin},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			out, err := tt.run(t.Context(), t.TempDir(), strings.NewReader("protobuf input\x00"), executable,
+				append([]string{"-test.run=^TestCommandArgvHelper$", "--"}, args...)...)
+			require.NoError(t, err)
+			var got struct {
+				Args  []string
+				Stdin string
+			}
+			require.NoError(t, json.Unmarshal([]byte(out), &got))
+			require.Equal(t, args, got.Args)
+			require.Equal(t, "protobuf input\x00", got.Stdin)
+		})
+	}
+}
diff --git a/internal/adapters/console/bash.go b/internal/adapters/console/bash.go
index 90b2eef7..cd31f7cb 100644
--- a/internal/adapters/console/bash.go
+++ b/internal/adapters/console/bash.go
@@ -41,8 +41,8 @@ func (bash) RunCmdWithStdin(ctx context.Context, dir string, stdin io.Reader, co
 	var stderr bytes.Buffer
 	var stdout bytes.Buffer
 
-	fullCommand := append([]string{command}, commandParams...)
-	cmd := exec.CommandContext(ctx, "bash", "-c", strings.Join(fullCommand, " "))
+	// A command is an executable plus argv, not an implicit shell script.
+	cmd := exec.CommandContext(ctx, command, commandParams...)
 	cmd.Dir = dir
 	cmd.Stdin = stdin
 	cmd.Stderr = &stderr
diff --git a/internal/adapters/console/powershell.go b/internal/adapters/console/powershell.go
index 4ddfb984..5c208f6e 100644
--- a/internal/adapters/console/powershell.go
+++ b/internal/adapters/console/powershell.go
@@ -41,8 +41,8 @@ func (powershell) RunCmdWithStdin(ctx context.Context, dir string, stdin io.Read
 	var stderr bytes.Buffer
 	var stdout bytes.Buffer
 
-	fullCommand := append([]string{command}, commandParams...)
-	cmd := exec.CommandContext(ctx, "powershell", "-NoProfile", "-NonInteractive", "-Command", strings.Join(fullCommand, " "))
+	// A command is an executable plus argv, not an implicit shell script.
+	cmd := exec.CommandContext(ctx, command, commandParams...)
 	cmd.Dir = dir
 	cmd.Stdin = stdin
 	cmd.Stderr = &stderr
diff --git a/internal/adapters/gitmodules/bsr.go b/internal/adapters/gitmodules/bsr.go
new file mode 100644
index 00000000..0fc7826e
--- /dev/null
+++ b/internal/adapters/gitmodules/bsr.go
@@ -0,0 +1,84 @@
+package gitmodules
+
+import (
+	"context"
+	"fmt"
+	"slices"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func (c *Cache) resolveBSRDependencies(ctx context.Context, module v1.Module) (v1.Module, []v1.BSRResolution, error) {
+	if len(module.BSRDependencies) == 0 {
+		return module, nil, nil
+	}
+	if c.bsrResolver == nil {
+		return v1.Module{}, nil, fmt.Errorf("BSR resolver is not configured for %s", module.Name)
+	}
+	module.Requires = slices.Clone(module.Requires)
+	var bindings []v1.BSRResolution
+	resolved := make(map[v1.BSRDependency]v1.BSRResolution)
+	for _, dependency := range module.BSRDependencies {
+		if err := ctx.Err(); err != nil {
+			return v1.Module{}, nil, fmt.Errorf("Err: %w", err)
+		}
+		// The same request can originate in several workspace configs. Resolve it
+		// once, but retain each origin in the parent's lock entry.
+		request := dependency
+		request.Config = ""
+		binding, ok := resolved[request]
+		if ok {
+			binding.Dependency = dependency
+		} else {
+			var err error
+			binding, err = c.bsrResolver.Resolve(ctx, dependency)
+			if err != nil {
+				return v1.Module{}, nil, fmt.Errorf("Resolve: %s: %w", dependency.Config, err)
+			}
+			if binding.Dependency != dependency {
+				return v1.Module{}, nil, fmt.Errorf("BSR resolver changed BSR dependency %s in %s", dependency.Module, dependency.Config)
+			}
+			if err := binding.Validate(); err != nil {
+				return v1.Module{}, nil, fmt.Errorf("Validate: %w", err)
+			}
+			resolved[request] = binding
+		}
+		if !slices.Contains(bindings, binding) {
+			bindings = append(bindings, binding)
+		}
+		if !slices.Contains(module.Requires, binding.Git) {
+			module.Requires = append(module.Requires, binding.Git)
+		}
+	}
+	return module, bindings, nil
+}
+
+func restoreBSRDependencies(module v1.Module, bindings []v1.BSRResolution) (v1.Module, error) {
+	if len(module.BSRDependencies) > 0 && len(bindings) == 0 {
+		return v1.Module{}, fmt.Errorf("%s: protobuf.lock has no BSR bindings; run easyp mod tidy", module.Name)
+	}
+	if len(bindings) != len(module.BSRDependencies) {
+		return v1.Module{}, fmt.Errorf("%s: protobuf.lock BSR metadata does not match the dependency configs; run easyp mod tidy", module.Name)
+	}
+	byDependency := make(map[v1.BSRDependency]v1.Requirement, len(bindings))
+	for _, binding := range bindings {
+		if err := binding.Validate(); err != nil {
+			return v1.Module{}, fmt.Errorf("Validate: %w", err)
+		}
+		if _, ok := byDependency[binding.Dependency]; ok {
+			return v1.Module{}, fmt.Errorf("duplicate BSR binding for %s in %s", binding.Dependency.Module, binding.Dependency.Config)
+		}
+		byDependency[binding.Dependency] = binding.Git
+	}
+	module.Requires = slices.Clone(module.Requires)
+	for _, dependency := range module.BSRDependencies {
+		git, ok := byDependency[dependency]
+		if !ok {
+			return v1.Module{}, fmt.Errorf("%s: protobuf.lock BSR metadata for %s in %s does not match the dependency config; run easyp mod tidy", module.Name, dependency.Module, dependency.Config)
+		}
+		if !slices.Contains(module.Requires, git) {
+			module.Requires = append(module.Requires, git)
+		}
+	}
+	return module, nil
+}
diff --git a/internal/adapters/gitmodules/bsr_test.go b/internal/adapters/gitmodules/bsr_test.go
new file mode 100644
index 00000000..c2d66b0f
--- /dev/null
+++ b/internal/adapters/gitmodules/bsr_test.go
@@ -0,0 +1,254 @@
+package gitmodules
+
+import (
+	"context"
+	"errors"
+	"os"
+	"path/filepath"
+	"slices"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestFetchBSRDependencies(t *testing.T) {
+	t.Parallel()
+	backendErr := errors.New("BSR backend unavailable")
+	tests := []struct {
+		name         string
+		deps         string
+		version      string
+		backendErr   error
+		wrongOrigin  bool
+		unconfigured bool
+		wantCalls    int
+		wantErr      string
+		wantErrIs    error
+	}{
+		{name: "plain Git", deps: "[]", version: "v1.2.3"},
+		{name: "plain Git without BSR backend", deps: "[]", unconfigured: true},
+		{name: "BSR without backend", deps: "[buf.build/googleapis/googleapis]", unconfigured: true, wantErr: "BSR resolver is not configured"},
+		{name: "known BSR", deps: "[buf.build/googleapis/googleapis]", version: "v1.2.3", wantCalls: 1},
+		{name: "deduplicate declarations", deps: "[buf.build/googleapis/googleapis, buf.build/googleapis/googleapis]", version: "v1.2.3", wantCalls: 1},
+		{name: "two BSR modules share one Git source", deps: "[buf.build/googleapis/googleapis, buf.build/acme/common]", version: "v1.2.3", wantCalls: 2},
+		{name: "backend failure", deps: "[buf.build/googleapis/googleapis]", backendErr: backendErr, wantCalls: 1, wantErrIs: backendErr},
+		{name: "unpinned response", deps: "[buf.build/googleapis/googleapis]", wantCalls: 1, wantErr: "unpinned BSR Git target"},
+		{name: "moving response", deps: "[buf.build/googleapis/googleapis]", version: "main", wantCalls: 1, wantErr: "invalid version"},
+		{name: "changed origin", deps: "[buf.build/googleapis/googleapis]", version: "v1.2.3", wrongOrigin: true, wantCalls: 1, wantErr: "changed BSR dependency"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			remote := bsrTestRepository(t, "version: v1\ndeps: "+tt.deps+"\n")
+			backend := &fakeBSRResolver{git: v1.Requirement{Module: "github.com/acme/provider", Version: tt.version}, err: tt.backendErr, wrongOrigin: tt.wrongOrigin}
+			cache := NewWithBSRResolver(t.TempDir(), backend)
+			if tt.unconfigured {
+				cache.bsrResolver = nil
+			}
+
+			fetched, err := cache.Fetch(t.Context(), remote, "v1.0.0")
+
+			assert.Len(t, backend.calls, tt.wantCalls)
+			entries, readErr := os.ReadDir(cache.root)
+			require.NoError(t, readErr)
+			for _, entry := range entries {
+				assert.Equal(t, "objects", entry.Name(), "temporary checkout survived Fetch")
+			}
+			if tt.wantErrIs != nil {
+				require.ErrorIs(t, err, tt.wantErrIs)
+				return
+			}
+			if tt.wantErr != "" {
+				require.ErrorContains(t, err, tt.wantErr)
+				return
+			}
+			require.NoError(t, err)
+			assert.Len(t, fetched.Lock.BSR, tt.wantCalls)
+			if tt.wantCalls == 0 {
+				assert.Empty(t, fetched.Module.Requires)
+				return
+			}
+			assert.Equal(t, []v1.Requirement{backend.git}, fetched.Module.Requires)
+			for i, binding := range fetched.Lock.BSR {
+				assert.Equal(t, backend.calls[i], binding.Dependency)
+				assert.Equal(t, backend.git, binding.Git)
+			}
+			assert.NoError(t, (v1.Lock{Version: 1, Modules: []v1.LockedModule{fetched.Lock}}).Validate())
+		})
+	}
+}
+
+func TestResolveBSRWorkspaceDependencies(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name        string
+		origins     []string
+		wantCalls   int
+		wantOrigins []string
+	}{
+		{name: "two workspace origins share one resolution", origins: []string{"a/buf.yaml", "b/buf.yaml"}, wantCalls: 1, wantOrigins: []string{"a/buf.yaml", "b/buf.yaml"}},
+		{name: "duplicate origin", origins: []string{"a/buf.yaml", "a/buf.yaml"}, wantCalls: 1, wantOrigins: []string{"a/buf.yaml"}},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			backend := &fakeBSRResolver{git: v1.Requirement{Module: "github.com/acme/provider", Version: "v1.2.3"}}
+			cache := NewWithBSRResolver(t.TempDir(), backend)
+			module := v1.Module{Name: "github.com/acme/parent"}
+			for _, origin := range tt.origins {
+				module.BSRDependencies = append(module.BSRDependencies, v1.BSRDependency{Module: "buf.build/googleapis/googleapis", Config: origin})
+			}
+
+			resolved, bindings, err := cache.resolveBSRDependencies(t.Context(), module)
+
+			require.NoError(t, err)
+			assert.Len(t, backend.calls, tt.wantCalls)
+			assert.Equal(t, []v1.Requirement{backend.git}, resolved.Requires)
+			var origins []string
+			for _, binding := range bindings {
+				origins = append(origins, binding.Dependency.Config)
+			}
+			assert.Equal(t, tt.wantOrigins, origins)
+			assert.Nil(t, module.Requires, "resolution must not mutate the input")
+		})
+	}
+}
+
+func TestResolveBSRDependenciesCancellation(t *testing.T) {
+	t.Parallel()
+	tests := []struct{ name string }{{name: "cancelled before backend"}}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			backend := &fakeBSRResolver{git: v1.Requirement{Module: "github.com/acme/provider", Version: "v1.2.3"}}
+			cache := NewWithBSRResolver(t.TempDir(), backend)
+			module := v1.Module{BSRDependencies: []v1.BSRDependency{{Module: "buf.build/googleapis/googleapis", Config: "buf.yaml"}}}
+			ctx, cancel := context.WithCancel(t.Context())
+			cancel()
+
+			_, _, err := cache.resolveBSRDependencies(ctx, module)
+
+			require.ErrorIs(t, err, context.Canceled)
+			assert.Empty(t, backend.calls)
+		})
+	}
+}
+
+func TestFetchMigrationBSRBindings(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name    string
+		version string
+	}{
+		{name: "pinned legacy module", version: "v1.0.0"},
+		{name: "initial legacy resolution"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			remote := bsrTestRepository(t, "version: v1\ndeps: [buf.build/googleapis/googleapis]\n")
+			backend := &fakeBSRResolver{git: v1.Requirement{Module: "github.com/acme/provider", Version: "v1.2.3"}}
+			cache := NewWithBSRResolver(t.TempDir(), backend)
+
+			fetched, err := cache.FetchMigration(t.Context(), remote, tt.version, "")
+
+			require.NoError(t, err)
+			assert.Equal(t, []v1.Requirement{backend.git}, fetched.Module.Requires)
+			require.Len(t, fetched.Lock.BSR, 1)
+			assert.Equal(t, "buf.build/googleapis/googleapis", fetched.Lock.BSR[0].Dependency.Module)
+			assert.Equal(t, backend.git, fetched.Lock.BSR[0].Git)
+			assert.NoError(t, (v1.Lock{Version: 1, Modules: []v1.LockedModule{fetched.Lock}}).Validate())
+		})
+	}
+}
+
+func TestCachedBSRBindings(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name    string
+		change  string
+		wantErr string
+	}{
+		{name: "replay without backend"},
+		{name: "old lock needs regeneration", change: "missing", wantErr: "run easyp mod tidy"},
+		{name: "stale reference", change: "reference", wantErr: "does not match"},
+		{name: "wrong config origin", change: "config", wantErr: "does not match"},
+		{name: "extra origin", change: "extra", wantErr: "does not match"},
+		{name: "invalid recorded target", change: "target", wantErr: "unpinned BSR Git target"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			remote := bsrTestRepository(t, "version: v1\ndeps: [buf.build/googleapis/googleapis:stable]\n")
+			backend := &fakeBSRResolver{git: v1.Requirement{Module: "github.com/acme/provider", Version: "v1.2.3"}}
+			cache := NewWithBSRResolver(t.TempDir(), backend)
+			fetched, err := cache.Fetch(t.Context(), remote, "v1.0.0")
+			require.NoError(t, err)
+			require.NoError(t, cache.Install(t.Context(), v1.Lock{Version: 1, Modules: []v1.LockedModule{fetched.Lock}}))
+			entry := fetched.Lock
+			entry.BSR = slices.Clone(entry.BSR)
+			switch tt.change {
+			case "missing":
+				entry.BSR = nil
+			case "reference":
+				entry.BSR[0].Dependency.Reference = "next"
+			case "config":
+				entry.BSR[0].Dependency.Config = "other/buf.yaml"
+			case "extra":
+				entry.BSR = append(entry.BSR, entry.BSR[0])
+			case "target":
+				entry.BSR[0].Git.Version = ""
+			}
+			backend.err = errors.New("backend must never run during Cached")
+			backend.calls = nil
+
+			_, module, err := cache.Cached(entry)
+
+			assert.Empty(t, backend.calls)
+			if tt.wantErr != "" {
+				require.ErrorContains(t, err, tt.wantErr)
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, []v1.Requirement{backend.git}, module.Requires)
+		})
+	}
+}
+
+type fakeBSRResolver struct {
+	git         v1.Requirement
+	err         error
+	wrongOrigin bool
+	calls       []v1.BSRDependency
+}
+
+func (backend *fakeBSRResolver) Resolve(_ context.Context, dependency v1.BSRDependency) (v1.BSRResolution, error) {
+	backend.calls = append(backend.calls, dependency)
+	if backend.err != nil {
+		return v1.BSRResolution{}, backend.err
+	}
+	if backend.wrongOrigin {
+		dependency.Module = "buf.build/acme/wrong"
+	}
+	return v1.BSRResolution{Dependency: dependency, Git: backend.git, Resolution: v1.BSRCompatibilitySnapshot}, nil
+}
+
+func bsrTestRepository(t *testing.T, config string) string {
+	t.Helper()
+	remote := t.TempDir()
+	require.NoError(t, os.WriteFile(filepath.Join(remote, "buf.yaml"), []byte(config), 0o600))
+	require.NoError(t, os.WriteFile(filepath.Join(remote, "parent.proto"), []byte("syntax = \"proto3\"; message Parent {}\n"), 0o600))
+	runTestGit(t, remote, "init", "-q")
+	runTestGit(t, remote, "add", ".")
+	runTestGit(t, remote, "-c", "user.name=Test", "-c", "user.email=test@example.test", "commit", "-qm", "initial")
+	runTestGit(t, remote, "tag", "v1.0.0")
+	return remote
+}
diff --git a/internal/adapters/gitmodules/cache.go b/internal/adapters/gitmodules/cache.go
new file mode 100644
index 00000000..fe6618df
--- /dev/null
+++ b/internal/adapters/gitmodules/cache.go
@@ -0,0 +1,89 @@
+// Package gitmodules retrieves and verifies Git module contents in the v1 cache.
+package gitmodules
+
+import (
+	"context"
+	"fmt"
+	"path/filepath"
+
+	"github.com/easyp-tech/easyp/internal/adapters/bsr"
+	moduleconfig "github.com/easyp-tech/easyp/internal/adapters/module_config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+// Cache owns Git checkouts, installed contents, and their layout below EASYPPATH.
+type Cache struct {
+	root        string
+	bsrResolver modules.BSRResolver
+}
+
+// New places the v1 Git cache below the supplied EasyP storage directory.
+func New(storageDir string) *Cache {
+	return NewWithBSRResolver(storageDir, bsr.StaticResolver{})
+}
+
+// NewWithBSRResolver supplies the backend used when fetching Buf dependency metadata.
+// Cached and frozen operations replay the lock's bindings without calling this backend.
+func NewWithBSRResolver(storageDir string, resolver modules.BSRResolver) *Cache {
+	return &Cache{root: filepath.Join(storageDir, "v1", "git"), bsrResolver: resolver}
+}
+
+// Cached reads installed metadata without downloading or changing files.
+// Call Install first to verify contents against the lock.
+func (c *Cache) Cached(entry v1.LockedModule) (string, v1.Module, error) {
+	if err := v1.ValidateModuleVersion(entry.Source, entry.Version); err != nil {
+		return "", v1.Module{}, fmt.Errorf("ValidateModuleVersion: %w", err)
+	}
+	directory := v1ModuleCachePath(c.root, entry)
+	module, err := readCachedV1Module(directory, entry.Source)
+	if err != nil {
+		return "", v1.Module{}, fmt.Errorf("readCachedV1Module: %w", err)
+	}
+	if err := moduleconfig.ValidateLegacyMajor(directory, entry.Source, entry.Version); err != nil {
+		return "", v1.Module{}, fmt.Errorf("ValidateLegacyMajor: %w", err)
+	}
+	module, err = restoreBSRDependencies(module, entry.BSR)
+	if err != nil {
+		return "", v1.Module{}, fmt.Errorf("restoreBSRDependencies: %w", err)
+	}
+	return directory, module, nil
+}
+
+// Versions lists semantic versions available for a module, including nested modules.
+func (c *Cache) Versions(ctx context.Context, source string) ([]string, error) {
+	return listV1ModuleTags(ctx, source)
+}
+
+// ValidateSource checks whether a module identity can identify a Git repository.
+func ValidateSource(source string) error {
+	_, err := v1GitModuleCandidates(source)
+	return err
+}
+
+// readCachedV1Module reuses the verified major-layout rules without requesting
+// network metadata or letting an unrelated native module poison cache lookup.
+func readCachedV1Module(directory, source string) (v1.Module, error) {
+	major, err := v1.ModulePathMajor(source)
+	if err != nil {
+		return v1.Module{}, fmt.Errorf("ModulePathMajor: %w", err)
+	}
+	if major == "" {
+		return moduleconfig.ReadGitDependency(directory, source)
+	}
+	candidates, err := v1GitModuleCandidates(source)
+	if err != nil {
+		return v1.Module{}, fmt.Errorf("v1GitModuleCandidates: %w", err)
+	}
+	var firstErr error
+	for _, candidate := range candidates {
+		module, err := moduleconfig.ReadGitDependencyAt(directory, source, candidate.subdir)
+		if err == nil {
+			return module, nil
+		}
+		if firstErr == nil {
+			firstErr = err
+		}
+	}
+	return v1.Module{}, fmt.Errorf("ReadGitDependencyAt: %w", firstErr)
+}
diff --git a/internal/adapters/gitmodules/cache_identity.go b/internal/adapters/gitmodules/cache_identity.go
new file mode 100644
index 00000000..6b17afef
--- /dev/null
+++ b/internal/adapters/gitmodules/cache_identity.go
@@ -0,0 +1,9 @@
+package gitmodules
+
+type cacheIdentity struct {
+	Device            uint64
+	Inode             uint64
+	Links             uint64
+	ChangeSeconds     int64
+	ChangeNanoseconds int64
+}
diff --git a/internal/adapters/gitmodules/cache_identity_darwin.go b/internal/adapters/gitmodules/cache_identity_darwin.go
new file mode 100644
index 00000000..35efb9a7
--- /dev/null
+++ b/internal/adapters/gitmodules/cache_identity_darwin.go
@@ -0,0 +1,22 @@
+//go:build darwin
+
+package gitmodules
+
+import (
+	"os"
+	"syscall"
+)
+
+func cacheFileIdentity(info os.FileInfo) (cacheIdentity, bool) {
+	stat, ok := info.Sys().(*syscall.Stat_t)
+	if !ok {
+		return cacheIdentity{}, false
+	}
+	return cacheIdentity{
+		Device:            uint64(stat.Dev),
+		Inode:             uint64(stat.Ino),
+		Links:             uint64(stat.Nlink),
+		ChangeSeconds:     stat.Ctimespec.Sec,
+		ChangeNanoseconds: stat.Ctimespec.Nsec,
+	}, true
+}
diff --git a/internal/adapters/gitmodules/cache_identity_fallback.go b/internal/adapters/gitmodules/cache_identity_fallback.go
new file mode 100644
index 00000000..7f29b766
--- /dev/null
+++ b/internal/adapters/gitmodules/cache_identity_fallback.go
@@ -0,0 +1,9 @@
+//go:build !darwin && !linux
+
+package gitmodules
+
+import "os"
+
+func cacheFileIdentity(os.FileInfo) (cacheIdentity, bool) {
+	return cacheIdentity{}, false
+}
diff --git a/internal/adapters/gitmodules/cache_identity_linux.go b/internal/adapters/gitmodules/cache_identity_linux.go
new file mode 100644
index 00000000..507b73f2
--- /dev/null
+++ b/internal/adapters/gitmodules/cache_identity_linux.go
@@ -0,0 +1,22 @@
+//go:build linux
+
+package gitmodules
+
+import (
+	"os"
+	"syscall"
+)
+
+func cacheFileIdentity(info os.FileInfo) (cacheIdentity, bool) {
+	stat, ok := info.Sys().(*syscall.Stat_t)
+	if !ok {
+		return cacheIdentity{}, false
+	}
+	return cacheIdentity{
+		Device:            uint64(stat.Dev),
+		Inode:             uint64(stat.Ino),
+		Links:             uint64(stat.Nlink),
+		ChangeSeconds:     int64(stat.Ctim.Sec),
+		ChangeNanoseconds: int64(stat.Ctim.Nsec),
+	}, true
+}
diff --git a/internal/adapters/gitmodules/cache_verification.go b/internal/adapters/gitmodules/cache_verification.go
new file mode 100644
index 00000000..651d92cd
--- /dev/null
+++ b/internal/adapters/gitmodules/cache_verification.go
@@ -0,0 +1,159 @@
+package gitmodules
+
+import (
+	"crypto/sha256"
+	"encoding/base64"
+	"encoding/binary"
+	"encoding/json"
+	"fmt"
+	"io/fs"
+	"os"
+	"path/filepath"
+
+	"golang.org/x/mod/sumdb/dirhash"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+const cacheVerificationVersion = 1
+
+type cacheVerificationStamp struct {
+	Version     int    `json:"version"`
+	Hash        string `json:"hash"`
+	Fingerprint string `json:"fingerprint"`
+}
+
+func verifyInstalledV1Module(installed string, entry v1.LockedModule) error {
+	fingerprint, fast, err := cacheTreeFingerprint(installed)
+	if err != nil {
+		return fmt.Errorf("cacheTreeFingerprint: %w", err)
+	}
+	if fast {
+		stamp, readErr := readCacheVerificationStamp(installed)
+		if readErr == nil && stamp.Version == cacheVerificationVersion && stamp.Hash == entry.Hash && stamp.Fingerprint == fingerprint {
+			return nil
+		}
+	}
+
+	actual, err := dirhash.HashDir(installed, "", dirhash.Hash1)
+	if err != nil {
+		return fmt.Errorf("HashDir: %w", err)
+	}
+	if actual != entry.Hash {
+		return fmt.Errorf("cached %s@%s hash mismatch: got %s, want %s; inspect or quarantine only cache directory %q, then rerun easyp mod download; keep protobuf.lock unchanged", entry.Source, entry.Commit, actual, entry.Hash, installed)
+	}
+
+	if fast {
+		after, afterFast, fingerprintErr := cacheTreeFingerprint(installed)
+		if fingerprintErr != nil {
+			return fmt.Errorf("cacheTreeFingerprint after hash: %w", fingerprintErr)
+		}
+		if !afterFast || after != fingerprint {
+			return fmt.Errorf("cached %s@%s changed while its lock hash was being verified; retry after concurrent cache writes stop", entry.Source, entry.Commit)
+		}
+		_ = writeCacheVerificationStamp(installed, cacheVerificationStamp{
+			Version:     cacheVerificationVersion,
+			Hash:        entry.Hash,
+			Fingerprint: after,
+		})
+	}
+	return nil
+}
+
+func cacheVerificationStampPath(installed string) string {
+	return installed + ".verified.json"
+}
+
+func readCacheVerificationStamp(installed string) (cacheVerificationStamp, error) {
+	raw, err := os.ReadFile(cacheVerificationStampPath(installed))
+	if err != nil {
+		return cacheVerificationStamp{}, err
+	}
+	var stamp cacheVerificationStamp
+	if err := json.Unmarshal(raw, &stamp); err != nil {
+		return cacheVerificationStamp{}, fmt.Errorf("Unmarshal: %w", err)
+	}
+	return stamp, nil
+}
+
+func writeCacheVerificationStamp(installed string, stamp cacheVerificationStamp) error {
+	raw, err := json.Marshal(stamp)
+	if err != nil {
+		return fmt.Errorf("Marshal: %w", err)
+	}
+	path := cacheVerificationStampPath(installed)
+	temp, err := os.CreateTemp(filepath.Dir(path), ".verify-*")
+	if err != nil {
+		return fmt.Errorf("CreateTemp: %w", err)
+	}
+	tempPath := temp.Name()
+	defer func() { _ = os.Remove(tempPath) }()
+	if err := temp.Chmod(0o600); err != nil {
+		_ = temp.Close()
+		return fmt.Errorf("Chmod: %w", err)
+	}
+	if _, err := temp.Write(append(raw, '\n')); err != nil {
+		_ = temp.Close()
+		return fmt.Errorf("Write: %w", err)
+	}
+	if err := temp.Close(); err != nil {
+		return fmt.Errorf("Close: %w", err)
+	}
+	if err := os.Rename(tempPath, path); err != nil {
+		return fmt.Errorf("Rename: %w", err)
+	}
+	return nil
+}
+
+func cacheTreeFingerprint(root string) (string, bool, error) {
+	hash := sha256.New()
+	supported := true
+	err := filepath.WalkDir(root, func(path string, entry fs.DirEntry, walkErr error) error {
+		if walkErr != nil {
+			return walkErr
+		}
+		info, err := entry.Info()
+		if err != nil {
+			return fmt.Errorf("Info: %w", err)
+		}
+		if path != root && !info.IsDir() && !info.Mode().IsRegular() {
+			return fmt.Errorf("unsupported non-regular cached path %q", path)
+		}
+		identity, ok := cacheFileIdentity(info)
+		if !ok {
+			supported = false
+		}
+		relative, err := filepath.Rel(root, path)
+		if err != nil {
+			return fmt.Errorf("Rel: %w", err)
+		}
+		if relative == "." {
+			relative = ""
+		}
+		name := filepath.ToSlash(relative)
+		if err := binary.Write(hash, binary.LittleEndian, uint32(len(name))); err != nil {
+			return err
+		}
+		if _, err := hash.Write([]byte(name)); err != nil {
+			return err
+		}
+		for _, value := range []uint64{
+			uint64(info.Mode()),
+			uint64(info.Size()),
+			identity.Device,
+			identity.Inode,
+			identity.Links,
+			uint64(identity.ChangeSeconds),
+			uint64(identity.ChangeNanoseconds),
+		} {
+			if err := binary.Write(hash, binary.LittleEndian, value); err != nil {
+				return err
+			}
+		}
+		return nil
+	})
+	if err != nil {
+		return "", false, err
+	}
+	return "m1:" + base64.StdEncoding.EncodeToString(hash.Sum(nil)), supported, nil
+}
diff --git a/internal/adapters/gitmodules/cache_verification_test.go b/internal/adapters/gitmodules/cache_verification_test.go
new file mode 100644
index 00000000..5bd7332b
--- /dev/null
+++ b/internal/adapters/gitmodules/cache_verification_test.go
@@ -0,0 +1,52 @@
+package gitmodules
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+	"time"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestCacheVerificationStampInvalidatesOnContentChange(t *testing.T) {
+	t.Parallel()
+
+	root := t.TempDir()
+	name := filepath.Join(root, "api.proto")
+	require.NoError(t, os.WriteFile(name, []byte("same"), 0o644))
+	hash, err := hashV1Files(root, []string{"api.proto"})
+	require.NoError(t, err)
+	entry := v1.LockedModule{Source: "example.test/cache", Version: "v1.0.0", Commit: "1111111111111111111111111111111111111111", Hash: hash}
+
+	require.NoError(t, verifyInstalledV1Module(root, entry))
+	assert.FileExists(t, cacheVerificationStampPath(root))
+
+	info, err := os.Stat(name)
+	require.NoError(t, err)
+	originalModTime := info.ModTime()
+	require.NoError(t, os.WriteFile(name, []byte("evil"), 0o644))
+	require.NoError(t, os.Chtimes(name, time.Now().Add(-time.Hour), originalModTime))
+
+	err = verifyInstalledV1Module(root, entry)
+	require.ErrorContains(t, err, "hash mismatch")
+}
+
+func TestCacheTreeFingerprintStableWithoutChanges(t *testing.T) {
+	t.Parallel()
+
+	root := t.TempDir()
+	require.NoError(t, os.Mkdir(filepath.Join(root, "proto"), 0o755))
+	require.NoError(t, os.WriteFile(filepath.Join(root, "proto", "api.proto"), []byte("content"), 0o644))
+
+	first, supported, err := cacheTreeFingerprint(root)
+	require.NoError(t, err)
+	second, secondSupported, err := cacheTreeFingerprint(root)
+	require.NoError(t, err)
+
+	assert.Equal(t, supported, secondSupported)
+	assert.Equal(t, first, second)
+}
diff --git a/internal/adapters/gitmodules/checkout.go b/internal/adapters/gitmodules/checkout.go
new file mode 100644
index 00000000..2bf8ce39
--- /dev/null
+++ b/internal/adapters/gitmodules/checkout.go
@@ -0,0 +1,117 @@
+package gitmodules
+
+import (
+	"context"
+	"fmt"
+	"os"
+	"strings"
+
+	moduleconfig "github.com/easyp-tech/easyp/internal/adapters/module_config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+// Fetch reads one revision and hashes its tracked contents. Temporary checkouts are removed before returning.
+func (c *Cache) Fetch(ctx context.Context, source, version string) (modules.Fetched, error) {
+	cacheRoot := c.root
+	checkout, err := checkoutV1Module(ctx, source, version, cacheRoot)
+	if err != nil {
+		return modules.Fetched{}, fmt.Errorf("checkoutV1Module: %w", err)
+	}
+	defer func() { _ = os.RemoveAll(checkout.dir) }()
+	if err := moduleconfig.ValidateLegacyMajor(checkout.dir, source, version); err != nil {
+		return modules.Fetched{}, fmt.Errorf("ValidateLegacyMajor: %w", err)
+	}
+	files, err := trackedV1Files(ctx, checkout.dir)
+	if err != nil {
+		return modules.Fetched{}, fmt.Errorf("trackedV1Files: %w", err)
+	}
+	files = selectV1ProtoFiles(files, checkout.module.ProtoFilters)
+	hash, err := hashV1Files(checkout.dir, files)
+	if err != nil {
+		return modules.Fetched{}, fmt.Errorf("hashV1Files: %w", err)
+	}
+	if version == "" {
+		version = checkout.commit
+	}
+	module, bindings, err := c.resolveBSRDependencies(ctx, checkout.module)
+	if err != nil {
+		return modules.Fetched{}, fmt.Errorf("resolveBSRDependencies: %w", err)
+	}
+	return modules.Fetched{Module: module, Lock: v1.LockedModule{
+		Source: source, Version: version, Commit: checkout.commit, Hash: hash, BSR: bindings,
+	}}, nil
+}
+
+type v1ModuleCheckout struct {
+	dir    string
+	module v1.Module
+	commit string
+}
+
+// checkoutV1Module selects a repository revision. The caller owns the returned
+// directory and removes it after reading its metadata and tracked contents.
+func checkoutV1Module(ctx context.Context, source, version, cacheRoot string) (checkout v1ModuleCheckout, err error) {
+	if err := v1.ValidateModuleVersion(source, version); err != nil {
+		return v1ModuleCheckout{}, fmt.Errorf("ValidateModuleVersion: %w", err)
+	}
+	if err := os.MkdirAll(cacheRoot, 0o755); err != nil {
+		return v1ModuleCheckout{}, fmt.Errorf("MkdirAll: %w", err)
+	}
+	if version == "" {
+		dir, module, commit, err := cloneHeadV1GitModule(ctx, source, cacheRoot)
+		if err != nil {
+			return v1ModuleCheckout{}, fmt.Errorf("cloneHeadV1GitModule: %w", err)
+		}
+		return v1ModuleCheckout{dir: dir, module: module, commit: strings.TrimSpace(commit)}, nil
+	}
+
+	var dir string
+	// Ownership transfers to the caller only after checkout and metadata agree.
+	defer func() {
+		if err != nil && dir != "" {
+			_ = os.RemoveAll(dir)
+		}
+	}()
+	if v1.IsCommitRef(version) {
+		dir, err = clonePinnedV1GitModule(ctx, v1.LockedModule{Source: source, Commit: version}, cacheRoot)
+		if err != nil {
+			return v1ModuleCheckout{}, fmt.Errorf("clonePinnedV1GitModule: %w", err)
+		}
+		commit, err := gitV1(ctx, dir, "rev-parse", "HEAD")
+		if err != nil {
+			return v1ModuleCheckout{}, fmt.Errorf("gitV1: %w", err)
+		}
+		module, err := readCachedV1Module(dir, source)
+		if err != nil {
+			return v1ModuleCheckout{}, fmt.Errorf("readCachedV1Module: %w", err)
+		}
+		return v1ModuleCheckout{dir: dir, module: module, commit: strings.TrimSpace(commit)}, nil
+	}
+
+	candidate, err := findV1GitModuleTag(ctx, source, version)
+	if err != nil {
+		return v1ModuleCheckout{}, fmt.Errorf("findV1GitModuleTag: %w", err)
+	}
+	dir, err = os.MkdirTemp(cacheRoot, "git-*")
+	if err != nil {
+		return v1ModuleCheckout{}, fmt.Errorf("MkdirTemp: %w", err)
+	}
+	tag := candidate.tag(strings.TrimSuffix(version, "+incompatible"))
+	if _, err := gitV1(ctx, "", "clone", "--quiet", "--depth=1", "--branch", tag, "--no-checkout", "--", candidate.remote, dir); err != nil {
+		return v1ModuleCheckout{}, fmt.Errorf("gitV1: %w", err)
+	}
+	commit, err := gitV1(ctx, dir, "rev-parse", "--verify", "refs/tags/"+tag+"^{commit}")
+	if err != nil {
+		return v1ModuleCheckout{}, fmt.Errorf("gitV1: %w", err)
+	}
+	commit = strings.TrimSpace(commit)
+	if _, err := gitV1(ctx, dir, "checkout", "--quiet", "--detach", commit); err != nil {
+		return v1ModuleCheckout{}, fmt.Errorf("gitV1: %w", err)
+	}
+	module, err := moduleconfig.ReadGitDependencyAt(dir, source, candidate.subdir)
+	if err != nil {
+		return v1ModuleCheckout{}, fmt.Errorf("ReadGitDependencyAt: %w", err)
+	}
+	return v1ModuleCheckout{dir: dir, module: module, commit: commit}, nil
+}
diff --git a/internal/adapters/gitmodules/checkout_test.go b/internal/adapters/gitmodules/checkout_test.go
new file mode 100644
index 00000000..e8933930
--- /dev/null
+++ b/internal/adapters/gitmodules/checkout_test.go
@@ -0,0 +1,69 @@
+package gitmodules
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestFetchV1ModuleRemovesTemporaryCheckouts(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name       string
+		version    string
+		useCommit  bool
+		invalidMod bool
+		wantErr    string
+	}{
+		{name: "head"},
+		{name: "commit", useCommit: true},
+		{name: "tag", version: "v1.0.0"},
+		{name: "missing tag", version: "v1.1.0", wantErr: "was not found"},
+		{name: "invalid module at head", invalidMod: true, wantErr: "declares module"},
+		{name: "invalid module at commit", invalidMod: true, useCommit: true, wantErr: "declares module"},
+		{name: "invalid module at tag", invalidMod: true, version: "v1.0.0", wantErr: "declares module"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			remote := t.TempDir()
+			moduleName := remote
+			if tt.invalidMod {
+				moduleName = "example.com/other"
+			}
+			require.NoError(t, os.WriteFile(filepath.Join(remote, "protobuf.mod"), []byte("module "+moduleName+"\n"), 0o644))
+			runTestGit(t, remote, "init", "-q")
+			runTestGit(t, remote, "add", ".")
+			runTestGit(t, remote, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+			runTestGit(t, remote, "tag", "v1.0.0")
+			commit := strings.TrimSpace(runTestGit(t, remote, "rev-parse", "HEAD"))
+			version := tt.version
+			if tt.useCommit {
+				version = commit
+			}
+			cache := t.TempDir()
+
+			module, err := (&Cache{root: cache}).Fetch(t.Context(), remote, version)
+
+			if tt.wantErr != "" {
+				require.ErrorContains(t, err, tt.wantErr)
+			} else {
+				require.NoError(t, err)
+				assert.Equal(t, commit, module.Lock.Commit)
+				assert.Equal(t, remote, module.Module.Name)
+				assert.Equal(t, remote, module.Lock.Source)
+			}
+			entries, err := os.ReadDir(cache)
+			require.NoError(t, err)
+			for _, entry := range entries {
+				assert.Equal(t, "objects", entry.Name(), "temporary checkout was not removed")
+			}
+		})
+	}
+}
diff --git a/internal/adapters/gitmodules/diagnostics_test.go b/internal/adapters/gitmodules/diagnostics_test.go
new file mode 100644
index 00000000..b05c575f
--- /dev/null
+++ b/internal/adapters/gitmodules/diagnostics_test.go
@@ -0,0 +1,112 @@
+package gitmodules
+
+import (
+	"context"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+	"time"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func diagnosticRepository(t *testing.T) (string, string) {
+	t.Helper()
+	remote := filepath.Join(t.TempDir(), "repository with spaces")
+	require.NoError(t, os.MkdirAll(remote, 0o755))
+	require.NoError(t, os.WriteFile(filepath.Join(remote, "easyp.yaml"), []byte("generate:\n  inputs:\n    - directory: .\n"), 0o644))
+	require.NoError(t, os.WriteFile(filepath.Join(remote, "api.proto"), []byte("syntax = \"proto3\"; package api; message Item {}\n"), 0o644))
+	runTestGit(t, remote, "init", "-q")
+	runTestGit(t, remote, "add", ".")
+	runTestGit(t, remote, "-c", "user.name=Test", "-c", "user.email=test@example.test", "commit", "-qm", "initial")
+	runTestGit(t, remote, "tag", "v1.0.0")
+	return remote, strings.TrimSpace(runTestGit(t, remote, "rev-parse", "HEAD"))
+}
+
+func TestCacheIntegrityDiagnosticIdentifiesRecoveryPath(t *testing.T) {
+	t.Parallel()
+	remote, commit := diagnosticRepository(t)
+	cache := New(t.TempDir())
+	fetched, err := cache.Fetch(t.Context(), remote, commit)
+	require.NoError(t, err)
+	lock := v1.Lock{Version: 1, Modules: []v1.LockedModule{fetched.Lock}}
+	require.NoError(t, cache.Install(t.Context(), lock))
+	installed, _, err := cache.Cached(fetched.Lock)
+	require.NoError(t, err)
+	name := filepath.Join(installed, "api.proto")
+	require.NoError(t, os.WriteFile(name, []byte("tampered"), 0o644))
+	err = cache.Install(t.Context(), lock)
+	require.ErrorContains(t, err, "hash mismatch")
+	assert.Contains(t, err.Error(), installed)
+	assert.Contains(t, err.Error(), "protobuf.lock unchanged")
+	assert.Contains(t, err.Error(), "easyp mod download")
+	contents, readErr := os.ReadFile(name)
+	require.NoError(t, readErr)
+	assert.Equal(t, "tampered", string(contents), "a diagnostic must not automatically repair evidence")
+}
+
+func TestPinnedFailureDiagnostics(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name    string
+		offline bool
+		want    string
+	}{
+		{name: "reachable_missing_commit", want: "restore access to the pinned revision"},
+		{name: "inaccessible_repository", offline: true, want: "could not fetch locked commit"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			remote, commit := diagnosticRepository(t)
+			if tt.offline {
+				require.NoError(t, os.Rename(remote, remote+"-offline"))
+			} else {
+				commit = strings.Repeat("1", 40)
+			}
+			_, err := New(t.TempDir()).Fetch(t.Context(), remote, commit)
+			require.ErrorContains(t, err, tt.want)
+			assert.Contains(t, err.Error(), remote)
+			assert.Contains(t, err.Error(), commit)
+			if tt.offline {
+				assert.NotContains(t, err.Error(), "locked commit "+commit+" is unavailable")
+			}
+		})
+	}
+}
+
+func TestTagAccessErrorIsNotMissingVersion(t *testing.T) {
+	t.Parallel()
+	remote, _ := diagnosticRepository(t)
+	_, err := New(t.TempDir()).Fetch(t.Context(), remote, "v1.8.0")
+	require.ErrorContains(t, err, "was not found")
+	require.NoError(t, os.Rename(remote, remote+"-offline"))
+	_, err = New(t.TempDir()).Fetch(t.Context(), remote, "v1.0.0")
+	require.ErrorContains(t, err, "could not query Git tags")
+	assert.NotContains(t, err.Error(), "was not found")
+}
+
+func TestGitCancellationKeepsContextCause(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	runTestGit(t, root, "init", "-q")
+	ctx, cancel := context.WithCancel(t.Context())
+	defer cancel()
+	result := make(chan error, 1)
+	go func() {
+		_, err := gitV1(ctx, root, "-c", "alias.wait=!printf ready > started; sleep 0.25", "wait")
+		result <- err
+	}()
+	require.Eventually(t, func() bool { _, err := os.Stat(filepath.Join(root, "started")); return err == nil }, 5*time.Second, time.Millisecond)
+	cancel()
+	select {
+	case err := <-result:
+		require.ErrorIs(t, err, context.Canceled)
+	case <-time.After(5 * time.Second):
+		t.Fatal("cancelled git did not exit")
+	}
+}
diff --git a/internal/adapters/gitmodules/download.go b/internal/adapters/gitmodules/download.go
new file mode 100644
index 00000000..63e2f642
--- /dev/null
+++ b/internal/adapters/gitmodules/download.go
@@ -0,0 +1,158 @@
+package gitmodules
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+
+	moduleconfig "github.com/easyp-tech/easyp/internal/adapters/module_config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	disk "github.com/easyp-tech/easyp/internal/fs/fs"
+)
+
+func v1ModuleCachePath(cacheRoot string, entry v1.LockedModule) string {
+	return filepath.Join(cacheRoot, "modules", v1CacheSourceKey(entry.Source), entry.Commit)
+}
+
+// Install installs each locked Git commit, verifying its content hash
+// before accepting a downloaded or already cached module.
+func (c *Cache) Install(ctx context.Context, lock v1.Lock) error {
+	return c.install(ctx, lock, true)
+}
+
+// VerifyCached verifies already installed entries without downloading or writing.
+// Missing content must be acquired by an explicit mod download first.
+func (c *Cache) VerifyCached(ctx context.Context, lock v1.Lock) error {
+	return c.install(ctx, lock, false)
+}
+
+func (c *Cache) install(ctx context.Context, lock v1.Lock, acquire bool) error {
+	if err := lock.Validate(); err != nil {
+		return fmt.Errorf("Validate: %w", err)
+	}
+	for _, entry := range lock.Modules {
+		if err := ctx.Err(); err != nil {
+			return fmt.Errorf("Err: %w", err)
+		}
+		if err := c.installEntry(ctx, entry, acquire); err != nil {
+			return err
+		}
+	}
+	return nil
+}
+
+func (c *Cache) installEntry(ctx context.Context, entry v1.LockedModule, acquire bool) error {
+	installed := v1ModuleCachePath(c.root, entry)
+	info, err := os.Lstat(installed)
+	if errors.Is(err, os.ErrNotExist) {
+		if !acquire {
+			return fmt.Errorf("policy module %s@%s is not cached; run easyp mod download before validate-config: %w", entry.Source, entry.Commit, err)
+		}
+		if err := os.MkdirAll(filepath.Dir(installed), 0o755); err != nil {
+			return fmt.Errorf("MkdirAll: %w", err)
+		}
+		unlock, lockErr := lockObjectRepository(ctx, installed+".install.lock")
+		if lockErr != nil {
+			return fmt.Errorf("lockObjectRepository: %w", lockErr)
+		}
+		defer unlock()
+
+		// Another process may have completed the same atomic install while this
+		// process waited for the per-snapshot lock. Reuse and verify that result
+		// rather than racing a second rename into the same cache directory.
+		info, err = os.Lstat(installed)
+		if errors.Is(err, os.ErrNotExist) {
+			if err := fetchPinnedV1Module(ctx, entry, c.root, installed); err != nil {
+				return err
+			}
+			info, err = os.Lstat(installed)
+		}
+	}
+	if err != nil {
+		return err
+	}
+	if !info.IsDir() {
+		return fmt.Errorf("%s: cached path %q is not a directory; inspect this path and keep protobuf.lock unchanged", entry.Source, installed)
+	}
+	if err := verifyInstalledV1Module(installed, entry); err != nil {
+		return fmt.Errorf("verify cached %s at %q: %w", entry.Source, installed, err)
+	}
+	if err := moduleconfig.ValidateLegacyMajor(installed, entry.Source, entry.Version); err != nil {
+		return fmt.Errorf("ValidateLegacyMajor: %w", err)
+	}
+	return nil
+}
+
+func fetchPinnedV1Module(ctx context.Context, entry v1.LockedModule, cacheRoot, installed string) error {
+	if err := os.MkdirAll(cacheRoot, 0o755); err != nil {
+		return err
+	}
+	checkout, err := clonePinnedV1GitModule(ctx, entry, cacheRoot)
+	if err != nil {
+		return fmt.Errorf("clonePinnedV1GitModule: %w", err)
+	}
+	defer func() { _ = os.RemoveAll(checkout) }()
+	commit, err := gitV1(ctx, checkout, "rev-parse", "HEAD")
+	if err != nil {
+		return err
+	}
+	if strings.TrimSpace(commit) != entry.Commit {
+		return fmt.Errorf("%s: checked out commit does not match lock", entry.Source)
+	}
+	module, err := readCachedV1Module(checkout, entry.Source)
+	if err != nil {
+		return fmt.Errorf("readCachedV1Module: %w", err)
+	}
+	files, err := trackedV1Files(ctx, checkout)
+	if err != nil {
+		return fmt.Errorf("trackedV1Files: %w", err)
+	}
+	files = selectV1ProtoFiles(files, module.ProtoFilters)
+	actual, err := hashV1Files(checkout, files)
+	if err != nil {
+		return fmt.Errorf("hashV1Files: %w", err)
+	}
+	if actual != entry.Hash {
+		return fmt.Errorf("%s@%s hash mismatch: got %s, want %s; downloaded contents do not match the pinned hash; investigate repository integrity and keep protobuf.lock unchanged", entry.Source, entry.Commit, actual, entry.Hash)
+	}
+	if err := moduleconfig.ValidateLegacyMajor(checkout, entry.Source, entry.Version); err != nil {
+		return fmt.Errorf("ValidateLegacyMajor: %w", err)
+	}
+	parent := filepath.Dir(installed)
+	if err := os.MkdirAll(parent, 0o755); err != nil {
+		return err
+	}
+	stage, err := os.MkdirTemp(parent, "install-*")
+	if err != nil {
+		return err
+	}
+	defer func() { _ = os.RemoveAll(stage) }()
+	if len(module.ProtoFilters) > 0 {
+		// A valid Buf root may become empty after includes/excludes are applied.
+		for _, root := range module.Roots {
+			info, err := os.Lstat(filepath.Join(checkout, root))
+			if err != nil {
+				return fmt.Errorf("Lstat: %w", err)
+			}
+			if !info.IsDir() {
+				return fmt.Errorf("module %s has invalid root %q: not a directory", module.Name, root)
+			}
+			if err := os.MkdirAll(filepath.Join(stage, root), 0o755); err != nil {
+				return fmt.Errorf("MkdirAll: %w", err)
+			}
+		}
+	}
+	for _, name := range files {
+		path := filepath.FromSlash(name)
+		if err := disk.CopyRegularFile(filepath.Join(checkout, path), filepath.Join(stage, path)); err != nil {
+			return fmt.Errorf("CopyRegularFile: %w", err)
+		}
+	}
+	if err := os.Rename(stage, installed); err != nil {
+		return fmt.Errorf("install %s@%s: %w", entry.Source, entry.Commit, err)
+	}
+	return nil
+}
diff --git a/internal/adapters/gitmodules/files.go b/internal/adapters/gitmodules/files.go
new file mode 100644
index 00000000..d23b9c35
--- /dev/null
+++ b/internal/adapters/gitmodules/files.go
@@ -0,0 +1,121 @@
+package gitmodules
+
+import (
+	"context"
+	"fmt"
+	"io"
+	"os"
+	"path/filepath"
+	"strings"
+
+	"golang.org/x/mod/sumdb/dirhash"
+
+	moduleconfig "github.com/easyp-tech/easyp/internal/adapters/module_config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// trackedV1Files selects regular Git files, including those outside import roots.
+// Symlinks and submodules are omitted, matching Go module archive behavior.
+func trackedV1Files(ctx context.Context, checkout string) ([]string, error) {
+	raw, err := gitV1(ctx, checkout, "ls-files", "--stage", "-z")
+	if err != nil {
+		return nil, fmt.Errorf("gitV1: %w", err)
+	}
+	var files []string
+	for _, entry := range strings.Split(raw, "\x00") {
+		if entry == "" {
+			continue
+		}
+		metadata, name, ok := strings.Cut(entry, "\t")
+		fields := strings.Fields(metadata)
+		if !ok || len(fields) != 3 || fields[2] != "0" {
+			return nil, fmt.Errorf("invalid Git index entry %q", entry)
+		}
+		if !filepath.IsLocal(filepath.FromSlash(name)) {
+			return nil, fmt.Errorf("invalid tracked file path %q", name)
+		}
+		switch fields[0] {
+		case "120000", "160000":
+			if fields[0] == "120000" && moduleconfig.IsGitDependencyConfigFile(filepath.Base(name)) {
+				return nil, fmt.Errorf("non-regular dependency config %q in Git index", name)
+			}
+			continue
+		case "100644", "100755":
+		default:
+			return nil, fmt.Errorf("unsupported Git file mode %q for %q", fields[0], name)
+		}
+		if _, err := regularV1File(filepath.Join(checkout, filepath.FromSlash(name))); err != nil {
+			return nil, fmt.Errorf("regularV1File: %w", err)
+		}
+		files = append(files, name)
+	}
+	return files, nil
+}
+
+func selectV1ProtoFiles(files []string, filters []v1.ProtoFileFilter) []string {
+	if len(filters) == 0 {
+		return files
+	}
+	selected := make([]string, 0, len(files))
+	for _, name := range files {
+		if filepath.Ext(name) != ".proto" {
+			selected = append(selected, name)
+			continue
+		}
+		insideRoot, allowed := false, false
+		for _, filter := range filters {
+			if !v1FileWithin(name, filter.Root) {
+				continue
+			}
+			insideRoot = true
+			included := len(filter.Includes) == 0
+			for _, directory := range filter.Includes {
+				included = included || v1FileWithin(name, directory)
+			}
+			for _, directory := range filter.Excludes {
+				if v1FileWithin(name, directory) {
+					included = false
+					break
+				}
+			}
+			if included {
+				allowed = true
+				break
+			}
+		}
+		if !insideRoot || allowed {
+			selected = append(selected, name)
+		}
+	}
+	return selected
+}
+
+func v1FileWithin(name, directory string) bool {
+	directory = filepath.ToSlash(directory)
+	return directory == "." || name == directory || strings.HasPrefix(name, directory+"/")
+}
+
+func hashV1Files(root string, files []string) (string, error) {
+	hash, err := dirhash.Hash1(files, func(name string) (io.ReadCloser, error) {
+		file, err := os.Open(filepath.Join(root, filepath.FromSlash(name)))
+		if err != nil {
+			return nil, fmt.Errorf("Open: %w", err)
+		}
+		return file, nil
+	})
+	if err != nil {
+		return "", fmt.Errorf("Hash1: %w", err)
+	}
+	return hash, nil
+}
+
+func regularV1File(path string) (os.FileInfo, error) {
+	info, err := os.Lstat(path)
+	if err != nil {
+		return nil, fmt.Errorf("Lstat: %w", err)
+	}
+	if !info.Mode().IsRegular() {
+		return nil, fmt.Errorf("unsupported non-regular file %q", path)
+	}
+	return info, nil
+}
diff --git a/internal/adapters/gitmodules/files_test.go b/internal/adapters/gitmodules/files_test.go
new file mode 100644
index 00000000..9d23122d
--- /dev/null
+++ b/internal/adapters/gitmodules/files_test.go
@@ -0,0 +1,119 @@
+package gitmodules
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestTrackedV1Files(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name          string
+		regularName   string
+		linkName      string
+		materialize   bool
+		replaceByLink bool
+		wantErr       string
+	}{
+		{name: "regular_files_and_gitlinks", regularName: "file.proto"},
+		{name: "spaces_tabs_and_newlines_in_names", regularName: "directory name/file\twith\nnewline.proto"},
+		{name: "materialized_git_symlink", regularName: "file.proto", materialize: true},
+		{name: "materialized_config_symlink", regularName: "file.proto", linkName: "buf.yaml", materialize: true, wantErr: "non-regular dependency config"},
+		{name: "materialized_buf_lock_symlink", regularName: "file.proto", linkName: "buf.lock", materialize: true, wantErr: "non-regular dependency config"},
+		{name: "regular_git_file_replaced_by_symlink", regularName: "file.proto", replaceByLink: true, wantErr: "non-regular"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			repository := t.TempDir()
+			file := filepath.Join(repository, tt.regularName)
+			require.NoError(t, os.MkdirAll(filepath.Dir(file), 0o755))
+			require.NoError(t, os.WriteFile(file, []byte("syntax = \"proto3\";\n"), 0o644))
+			linkName := tt.linkName
+			if linkName == "" {
+				linkName = "ignored"
+			}
+			link := filepath.Join(repository, linkName)
+			require.NoError(t, os.Symlink(tt.regularName, link))
+			runTestGit(t, repository, "init", "-q")
+			runTestGit(t, repository, "add", ".")
+			runTestGit(t, repository, "-c", "user.name=Test", "-c", "user.email=test@example.test", "commit", "-qm", "initial")
+			commit := runTestGit(t, repository, "rev-parse", "HEAD")
+			runTestGit(t, repository, "update-index", "--add", "--cacheinfo", "160000", commit[:len(commit)-1], "submodule")
+			if tt.materialize {
+				require.NoError(t, os.Remove(link))
+				require.NoError(t, os.WriteFile(link, []byte(tt.regularName), 0o644))
+			}
+			if tt.replaceByLink {
+				require.NoError(t, os.Remove(file))
+				require.NoError(t, os.Symlink("ignored", file))
+			}
+
+			files, err := trackedV1Files(t.Context(), repository)
+
+			if tt.wantErr != "" {
+				require.ErrorContains(t, err, tt.wantErr)
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, []string{tt.regularName}, files)
+		})
+	}
+}
+
+func TestSelectV1ProtoFiles(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name    string
+		filters []v1.ProtoFileFilter
+		want    []string
+	}{
+		{
+			name: "no_filters",
+			want: []string{"proto/api.proto", "proto/api/public.proto", "proto/api/test/hidden.proto", "proto/apiv2/other.proto", "other/keep.proto", "proto/api/test/README"},
+		},
+		{
+			name:    "includes_keep_paths_and_non_proto_files",
+			filters: []v1.ProtoFileFilter{{Root: "proto", Includes: []string{"proto/api"}, Excludes: []string{"proto/api/test"}}},
+			want:    []string{"proto/api/public.proto", "other/keep.proto", "proto/api/test/README"},
+		},
+		{
+			name:    "exclude_uses_directory_boundary",
+			filters: []v1.ProtoFileFilter{{Root: "proto", Excludes: []string{"proto/api"}}},
+			want:    []string{"proto/api.proto", "proto/apiv2/other.proto", "other/keep.proto", "proto/api/test/README"},
+		},
+		{
+			name: "multiple_modules_share_a_root",
+			filters: []v1.ProtoFileFilter{
+				{Root: "proto", Includes: []string{"proto/api"}, Excludes: []string{"proto/api/test"}},
+				{Root: "proto", Includes: []string{"proto/apiv2"}},
+			},
+			want: []string{"proto/api/public.proto", "proto/apiv2/other.proto", "other/keep.proto", "proto/api/test/README"},
+		},
+		{
+			name:    "unfiltered_overlapping_root_remains_available",
+			filters: []v1.ProtoFileFilter{{Root: "proto", Excludes: []string{"proto/api"}}, {Root: "proto/api"}},
+			want:    []string{"proto/api.proto", "proto/api/public.proto", "proto/api/test/hidden.proto", "proto/apiv2/other.proto", "other/keep.proto", "proto/api/test/README"},
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			files := []string{"proto/api.proto", "proto/api/public.proto", "proto/api/test/hidden.proto", "proto/apiv2/other.proto", "other/keep.proto", "proto/api/test/README"}
+			original := append([]string(nil), files...)
+
+			selected := selectV1ProtoFiles(files, tt.filters)
+
+			assert.Equal(t, tt.want, selected)
+			assert.Equal(t, original, files, "source selection must not change the tracked file list")
+		})
+	}
+}
diff --git a/internal/adapters/gitmodules/fixtures_test.go b/internal/adapters/gitmodules/fixtures_test.go
new file mode 100644
index 00000000..07804483
--- /dev/null
+++ b/internal/adapters/gitmodules/fixtures_test.go
@@ -0,0 +1,16 @@
+package gitmodules
+
+import (
+	"os/exec"
+	"testing"
+)
+
+func runTestGit(t *testing.T, dir string, args ...string) string {
+	t.Helper()
+	cmd := exec.Command("git", append([]string{"-C", dir}, args...)...)
+	out, err := cmd.CombinedOutput()
+	if err != nil {
+		t.Fatalf("git %v: %v: %s", args, err, out)
+	}
+	return string(out)
+}
diff --git a/internal/adapters/gitmodules/git.go b/internal/adapters/gitmodules/git.go
new file mode 100644
index 00000000..513e637b
--- /dev/null
+++ b/internal/adapters/gitmodules/git.go
@@ -0,0 +1,31 @@
+package gitmodules
+
+import (
+	"context"
+	"crypto/sha256"
+	"fmt"
+	"os"
+	"os/exec"
+	"strings"
+)
+
+func gitV1(ctx context.Context, dir string, args ...string) (string, error) {
+	cmd := exec.CommandContext(ctx, "git", args...)
+	cmd.Dir = dir
+	cmd.Env = append(os.Environ(), "GIT_TERMINAL_PROMPT=0")
+	out, err := cmd.CombinedOutput()
+	if err != nil {
+		// CommandContext may return a killed-process error instead of the
+		// cancellation cause. Keep cancellation detectable by callers.
+		if contextErr := ctx.Err(); contextErr != nil {
+			return "", fmt.Errorf("git %s: %w", args[0], contextErr)
+		}
+		return "", fmt.Errorf("git %s: %w: %s", args[0], err, strings.TrimSpace(string(out)))
+	}
+	return string(out), nil
+}
+
+func v1CacheSourceKey(source string) string {
+	hash := sha256.Sum256([]byte(source))
+	return fmt.Sprintf("%x", hash)
+}
diff --git a/internal/adapters/gitmodules/git_source.go b/internal/adapters/gitmodules/git_source.go
new file mode 100644
index 00000000..5bea54eb
--- /dev/null
+++ b/internal/adapters/gitmodules/git_source.go
@@ -0,0 +1,330 @@
+package gitmodules
+
+import (
+	"context"
+	"fmt"
+	"net/url"
+	"os"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	"golang.org/x/mod/semver"
+
+	moduleconfig "github.com/easyp-tech/easyp/internal/adapters/module_config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+type v1GitModuleCandidate struct {
+	remote string
+	subdir string
+}
+
+func (candidate v1GitModuleCandidate) tag(version string) string {
+	if candidate.subdir == "" {
+		return version
+	}
+	return filepath.ToSlash(candidate.subdir) + "/" + version
+}
+
+// v1GitModuleCandidates tries the complete module identity first, then each
+// parent Git URL with the removed suffix as its module directory. The module
+// manifest at that suffix confirms the candidate at the requested revision.
+func v1GitModuleCandidates(source string) ([]v1GitModuleCandidate, error) {
+	major, err := v1.ModulePathMajor(source)
+	if err != nil {
+		return nil, fmt.Errorf("ModulePathMajor: %w", err)
+	}
+	// A slash major suffix identifies the module, not the repository or tag prefix.
+	if strings.HasPrefix(major, "/") && !strings.Contains(source, "://") {
+		source = strings.TrimSuffix(source, major)
+	}
+	if filepath.IsAbs(source) {
+		return localV1GitModuleCandidates(source), nil
+	}
+	if strings.Contains(source, "://") {
+		parsed, err := url.Parse(source)
+		if err != nil || parsed.Host == "" || parsed.RawQuery != "" || parsed.Fragment != "" {
+			return nil, fmt.Errorf("invalid Git module URL %q", source)
+		}
+		if strings.HasPrefix(major, "/") {
+			parsed.Path = strings.TrimSuffix(parsed.Path, major)
+		}
+		parts := strings.Split(strings.Trim(parsed.Path, "/"), "/")
+		if !validV1GitModuleParts(parts) {
+			return nil, fmt.Errorf("invalid Git module URL %q", source)
+		}
+		return pathV1GitModuleCandidates(parts, func(prefix []string) string {
+			candidate := *parsed
+			candidate.Path = "/" + strings.Join(prefix, "/")
+			candidate.RawPath = ""
+			return candidate.String()
+		}, 1), nil
+	}
+	parts := strings.Split(strings.Trim(source, "/"), "/")
+	if len(parts) < 2 || !validV1GitModuleParts(parts) {
+		return nil, fmt.Errorf("invalid Git module identity %q", source)
+	}
+	return pathV1GitModuleCandidates(parts, func(prefix []string) string {
+		return "https://" + strings.Join(prefix, "/")
+	}, 2), nil
+}
+
+func validV1GitModuleParts(parts []string) bool {
+	for _, part := range parts {
+		if part == "" || part == "." || part == ".." {
+			return false
+		}
+	}
+	return len(parts) > 0
+}
+
+func localV1GitModuleCandidates(source string) []v1GitModuleCandidate {
+	clean := filepath.Clean(source)
+	candidates := []v1GitModuleCandidate{{remote: clean}}
+
+	if localGitRoot(clean) {
+		return candidates
+	}
+	// The requested revision may predate removal of the module directory or
+	// replacement of any path component by a file. ReadGitDependencyAt verifies
+	// identity in that revision; a repository candidate alone does not make an
+	// unrelated directory a module.
+	for remote := filepath.Dir(clean); remote != filepath.Dir(remote); remote = filepath.Dir(remote) {
+		if localGitRoot(remote) {
+			return appendLocalV1GitCandidate(candidates, remote, clean)
+		}
+	}
+	return candidates
+}
+
+func localGitRoot(path string) bool {
+	_, err := os.Stat(filepath.Join(path, ".git"))
+	return err == nil
+}
+
+func appendLocalV1GitCandidate(candidates []v1GitModuleCandidate, remote, clean string) []v1GitModuleCandidate {
+	subdir, err := filepath.Rel(remote, clean)
+	if err != nil || !filepath.IsLocal(subdir) {
+		return candidates
+	}
+	return append(candidates, v1GitModuleCandidate{remote: remote, subdir: subdir})
+}
+
+func pathV1GitModuleCandidates(parts []string, remote func([]string) string, minParts int) []v1GitModuleCandidate {
+	var candidates []v1GitModuleCandidate
+	for length := len(parts); length >= minParts; length-- {
+		candidates = append(candidates, v1GitModuleCandidate{
+			remote: remote(parts[:length]),
+			subdir: strings.Join(parts[length:], "/"),
+		})
+	}
+	return candidates
+}
+
+func findV1GitModuleTag(ctx context.Context, source, version string) (v1GitModuleCandidate, error) {
+	candidates, err := v1GitModuleCandidates(source)
+	if err != nil {
+		return v1GitModuleCandidate{}, fmt.Errorf("v1GitModuleCandidates: %w", err)
+	}
+	var firstErr error
+	foundRepository := false
+	for _, candidate := range candidates {
+		if err := ctx.Err(); err != nil {
+			return v1GitModuleCandidate{}, fmt.Errorf("Err: %w", err)
+		}
+		versions, err := listV1CandidateTags(ctx, candidate)
+		if err != nil {
+			if firstErr == nil {
+				firstErr = err
+			}
+			continue
+		}
+		foundRepository = true
+		if slices.Contains(versions, strings.TrimSuffix(version, "+incompatible")) {
+			return candidate, nil
+		}
+	}
+	if !foundRepository && firstErr != nil {
+		return v1GitModuleCandidate{}, fmt.Errorf("could not query Git tags for %s@%s; check repository access and credentials: %w", source, version, firstErr)
+	}
+	return v1GitModuleCandidate{}, fmt.Errorf("git tag %s@%s was not found", source, version)
+}
+
+func listV1ModuleTags(ctx context.Context, source string) ([]string, error) {
+	candidates, err := v1GitModuleCandidates(source)
+	if err != nil {
+		return nil, fmt.Errorf("v1GitModuleCandidates: %w", err)
+	}
+	var firstErr error
+	foundRepository := false
+	for _, candidate := range candidates {
+		if err := ctx.Err(); err != nil {
+			return nil, fmt.Errorf("Err: %w", err)
+		}
+		versions, err := listV1CandidateTags(ctx, candidate)
+		if err != nil {
+			if firstErr == nil {
+				firstErr = err
+			}
+			continue
+		}
+		foundRepository = true
+		pathMajor, err := v1.ModulePathMajor(source)
+		if err != nil {
+			return nil, fmt.Errorf("ModulePathMajor: %w", err)
+		}
+		for i, version := range versions {
+			if pathMajor == "" && semver.Major(version) != "v0" && semver.Major(version) != "v1" && semver.Build(version) == "" {
+				// Enumeration is provisional. Fetch verifies pre-native metadata
+				// before this compatibility marker can enter a published lock.
+				versions[i] = version + "+incompatible"
+			}
+		}
+		versions = slices.DeleteFunc(versions, func(version string) bool {
+			return v1.ValidateModuleVersion(source, version) != nil
+		})
+		if len(versions) > 0 {
+			return versions, nil
+		}
+	}
+	if !foundRepository && firstErr != nil {
+		return nil, fmt.Errorf("git tags for %s: %w", source, firstErr)
+	}
+	return nil, nil
+}
+
+func listV1CandidateTags(ctx context.Context, candidate v1GitModuleCandidate) ([]string, error) {
+	raw, err := gitV1(ctx, "", "ls-remote", "--tags", "--", candidate.remote)
+	if err != nil {
+		return nil, fmt.Errorf("ls-remote %s: %w", candidate.remote, err)
+	}
+	seen := make(map[string]struct{})
+	for _, line := range strings.Split(raw, "\n") {
+		_, ref, ok := strings.Cut(line, "\t")
+		if !ok || !strings.HasPrefix(ref, "refs/tags/") {
+			continue
+		}
+		tag := strings.TrimSuffix(strings.TrimPrefix(ref, "refs/tags/"), "^{}")
+		if candidate.subdir != "" {
+			prefix := filepath.ToSlash(candidate.subdir) + "/"
+			if !strings.HasPrefix(tag, prefix) {
+				continue
+			}
+			tag = strings.TrimPrefix(tag, prefix)
+		}
+		if semver.IsValid(tag) && semver.Build(tag) != "+incompatible" {
+			seen[tag] = struct{}{}
+		}
+	}
+	versions := make([]string, 0, len(seen))
+	for version := range seen {
+		versions = append(versions, version)
+	}
+	slices.Sort(versions)
+	return versions, nil
+}
+
+// cloneHeadV1GitModule finds the repository default branch containing source.
+// The caller owns the returned checkout and must remove it.
+func cloneHeadV1GitModule(ctx context.Context, source, cacheRoot string) (string, v1.Module, string, error) {
+	candidates, err := v1GitModuleCandidates(source)
+	if err != nil {
+		return "", v1.Module{}, "", err
+	}
+	var firstErr, moduleErr error
+	for _, candidate := range candidates {
+		if err := ctx.Err(); err != nil {
+			return "", v1.Module{}, "", err
+		}
+		checkout, err := os.MkdirTemp(cacheRoot, "git-*")
+		if err != nil {
+			return "", v1.Module{}, "", err
+		}
+		module, commit, cloned, err := checkoutHeadV1GitModuleCandidate(ctx, checkout, source, candidate)
+		if err != nil {
+			if firstErr == nil {
+				firstErr = err
+			}
+			if cloned {
+				moduleErr = err
+			}
+			if removeErr := os.RemoveAll(checkout); removeErr != nil {
+				return "", v1.Module{}, "", removeErr
+			}
+			continue
+		}
+		return checkout, module, commit, nil
+	}
+	if moduleErr != nil {
+		return "", v1.Module{}, "", fmt.Errorf("module %s was not found at a Git repository HEAD: %w", source, moduleErr)
+	}
+	if firstErr != nil {
+		return "", v1.Module{}, "", fmt.Errorf("git repository for %s was not found: %w", source, firstErr)
+	}
+	return "", v1.Module{}, "", fmt.Errorf("no Git repository candidate for %s", source)
+}
+
+func checkoutHeadV1GitModuleCandidate(ctx context.Context, checkout, source string, candidate v1GitModuleCandidate) (v1.Module, string, bool, error) {
+	if _, err := gitV1(ctx, "", "clone", "--quiet", "--depth=1", "--no-checkout", "--", candidate.remote, checkout); err != nil {
+		return v1.Module{}, "", false, err
+	}
+	commit, err := gitV1(ctx, checkout, "rev-parse", "HEAD")
+	if err != nil {
+		return v1.Module{}, "", true, err
+	}
+	commit = strings.TrimSpace(commit)
+	if _, err := gitV1(ctx, checkout, "checkout", "--quiet", "--detach", commit); err != nil {
+		return v1.Module{}, "", true, err
+	}
+	module, err := moduleconfig.ReadGitDependencyAt(checkout, source, candidate.subdir)
+	if err != nil {
+		return v1.Module{}, "", true, err
+	}
+	return module, commit, true, nil
+}
+
+// clonePinnedV1GitModule finds a repository containing the locked commit and
+// the requested module. It does not depend on the tag still pointing there.
+func clonePinnedV1GitModule(ctx context.Context, entry v1.LockedModule, cacheRoot string) (string, error) {
+	candidates, err := v1GitModuleCandidates(entry.Source)
+	if err != nil {
+		return "", fmt.Errorf("v1GitModuleCandidates: %w", err)
+	}
+	var firstErr error
+	var moduleErr error
+	for _, candidate := range candidates {
+		if err := ctx.Err(); err != nil {
+			return "", err
+		}
+		checkout, err := os.MkdirTemp(cacheRoot, "git-*")
+		if err != nil {
+			return "", fmt.Errorf("MkdirTemp: %w", err)
+		}
+		cloned, err := checkoutPinnedV1GitModuleCandidate(ctx, checkout, entry, candidate)
+		if err != nil {
+			if cloned {
+				moduleErr = err
+			}
+			if firstErr == nil {
+				firstErr = err
+			}
+			if removeErr := os.RemoveAll(checkout); removeErr != nil {
+				return "", fmt.Errorf("RemoveAll: %w", removeErr)
+			}
+			continue
+		}
+		return checkout, nil
+	}
+	if moduleErr != nil {
+		return "", fmt.Errorf("%s: %w", entry.Source, moduleErr)
+	}
+	if firstErr == nil {
+		return "", fmt.Errorf("%s: no Git repository candidate", entry.Source)
+	}
+	return "", fmt.Errorf("%s: could not fetch locked commit %s; check repository access before changing the lock: %w", entry.Source, entry.Commit, firstErr)
+}
+
+func checkoutPinnedV1GitModuleCandidate(ctx context.Context, checkout string, entry v1.LockedModule, candidate v1GitModuleCandidate) (bool, error) {
+	return checkoutCachedCommit(ctx, checkout, entry, candidate)
+}
diff --git a/internal/adapters/gitmodules/git_source_test.go b/internal/adapters/gitmodules/git_source_test.go
new file mode 100644
index 00000000..08906c29
--- /dev/null
+++ b/internal/adapters/gitmodules/git_source_test.go
@@ -0,0 +1,107 @@
+package gitmodules
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestV1GitModuleCandidates(t *testing.T) {
+	t.Parallel()
+	localRoot := filepath.Join(t.TempDir(), "repo")
+	local := filepath.Join(localRoot, "foo", "bar")
+	require.NoError(t, os.MkdirAll(local, 0o755))
+	require.NoError(t, os.WriteFile(filepath.Join(local, "protobuf.mod"), []byte("module "+filepath.ToSlash(local)+"\n"), 0o644))
+	runTestGit(t, localRoot, "init", "-q")
+	tests := []struct {
+		name       string
+		source     string
+		wantRemote string
+		wantDir    string
+		wantTag    string
+	}{
+		{name: "bare module path", source: "github.com/acme/repo/foo/bar", wantRemote: "https://github.com/acme/repo", wantDir: "foo/bar", wantTag: "foo/bar/v1.2.3"},
+		{name: "HTTPS module path", source: "https://example.com/acme/repo.git/foo", wantRemote: "https://example.com/acme/repo.git", wantDir: "foo", wantTag: "foo/v1.2.3"},
+		{name: "local Git repository", source: local, wantRemote: localRoot, wantDir: filepath.Join("foo", "bar"), wantTag: "foo/bar/v1.2.3"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			candidates, err := v1GitModuleCandidates(tt.source)
+			require.NoError(t, err)
+			require.NotEmpty(t, candidates)
+			var found bool
+			for _, candidate := range candidates {
+				if candidate.remote == tt.wantRemote && candidate.subdir == tt.wantDir && candidate.tag("v1.2.3") == tt.wantTag {
+					found = true
+				}
+			}
+			require.True(t, found)
+		})
+	}
+}
+
+func TestV1GitModuleCandidatesRejectTraversal(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name   string
+		source string
+	}{
+		{name: "bare path", source: "github.com/acme/../repo"},
+		{name: "HTTPS path", source: "https://example.com/acme/../repo"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			_, err := v1GitModuleCandidates(tt.source)
+
+			require.ErrorContains(t, err, "invalid Git module")
+		})
+	}
+}
+
+func TestLocalV1GitModuleCandidatesStopAtNearestWorktree(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name   string
+		exists bool
+		file   string
+	}{
+		{name: "existing directory without live metadata", exists: true},
+		{name: "directory removed in live checkout"},
+		{name: "module directory replaced by a file", file: "foo/bar"},
+		{name: "ancestor directory replaced by a file", file: "foo"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			outer := t.TempDir()
+			runTestGit(t, outer, "init", "-q")
+			repository := filepath.Join(outer, "nested")
+			require.NoError(t, os.MkdirAll(repository, 0o755))
+			runTestGit(t, repository, "init", "-q")
+			source := filepath.Join(repository, "foo", "bar")
+			if tt.exists {
+				require.NoError(t, os.MkdirAll(source, 0o755))
+			}
+			if tt.file != "" {
+				path := filepath.Join(repository, tt.file)
+				require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+				require.NoError(t, os.WriteFile(path, []byte("no longer a directory\n"), 0o644))
+			}
+
+			candidates, err := v1GitModuleCandidates(source)
+
+			require.NoError(t, err)
+			require.Equal(t, []v1GitModuleCandidate{{remote: source}, {remote: repository, subdir: filepath.Join("foo", "bar")}}, candidates)
+		})
+	}
+}
diff --git a/internal/adapters/gitmodules/identity.go b/internal/adapters/gitmodules/identity.go
new file mode 100644
index 00000000..12f030e5
--- /dev/null
+++ b/internal/adapters/gitmodules/identity.go
@@ -0,0 +1,43 @@
+package gitmodules
+
+import (
+	"context"
+	"net/url"
+	"os/exec"
+	"path/filepath"
+	"strings"
+)
+
+// WorkspaceIdentity returns the origin module identity for a repository root, or an empty string.
+func WorkspaceIdentity(ctx context.Context, root string) string {
+	canonicalRoot, err := filepath.EvalSymlinks(root)
+	if err != nil {
+		return ""
+	}
+	root = canonicalRoot
+	repoRoot, err := gitV1(ctx, root, "rev-parse", "--show-toplevel")
+	if err != nil || filepath.Clean(strings.TrimSpace(repoRoot)) != filepath.Clean(root) {
+		return ""
+	}
+	// Read the declared identity, not a transport URL rewritten by insteadOf.
+	cmd := exec.CommandContext(ctx, "git", "-C", root, "config", "--get", "remote.origin.url")
+	raw, err := cmd.Output()
+	if err != nil {
+		return ""
+	}
+	remote := strings.TrimSpace(string(raw))
+	if strings.Contains(remote, "://") {
+		parsed, err := url.Parse(remote)
+		if err != nil || parsed.Host == "" {
+			return ""
+		}
+		return strings.TrimSuffix(parsed.Host+"/"+strings.TrimPrefix(parsed.Path, "/"), ".git")
+	}
+	if _, rest, ok := strings.Cut(remote, "@"); ok {
+		host, path, ok := strings.Cut(rest, ":")
+		if ok && host != "" && path != "" {
+			return strings.TrimSuffix(host+"/"+path, ".git")
+		}
+	}
+	return ""
+}
diff --git a/internal/adapters/gitmodules/identity_test.go b/internal/adapters/gitmodules/identity_test.go
new file mode 100644
index 00000000..29f5dfb0
--- /dev/null
+++ b/internal/adapters/gitmodules/identity_test.go
@@ -0,0 +1,37 @@
+package gitmodules
+
+import (
+	"os"
+	"os/exec"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestWorkspaceIdentityUsesDeclaredOrigin(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct{ name, origin, want string }{
+		{name: "HTTPS credentials", origin: "https://user:secret@example.test/acme/contracts.git", want: "example.test/acme/contracts"},
+		{name: "SSH", origin: "git@example.test:acme/contracts.git", want: "example.test/acme/contracts"},
+		{name: "local origin is not identity", origin: "/local/repository"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			git := func(args ...string) {
+				cmd := exec.CommandContext(t.Context(), "git", append([]string{"-C", root}, args...)...)
+				out, err := cmd.CombinedOutput()
+				require.NoError(t, err, "%s", out)
+			}
+			git("init", "-q")
+			git("remote", "add", "origin", tt.origin)
+			git("config", "url.file:///local/mirror/.insteadOf", "https://user:secret@example.test/")
+			assert.Equal(t, tt.want, WorkspaceIdentity(t.Context(), root))
+			subdir := filepath.Join(root, "nested")
+			require.NoError(t, os.Mkdir(subdir, 0o755))
+			assert.Empty(t, WorkspaceIdentity(t.Context(), subdir), "a nested module must not borrow repository identity")
+		})
+	}
+}
diff --git a/internal/adapters/gitmodules/major_cache_scope_test.go b/internal/adapters/gitmodules/major_cache_scope_test.go
new file mode 100644
index 00000000..a85dfbf4
--- /dev/null
+++ b/internal/adapters/gitmodules/major_cache_scope_test.go
@@ -0,0 +1,39 @@
+package gitmodules
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestMajorCachedModuleDoesNotParseUnrelatedManifest(t *testing.T) {
+	t.Parallel()
+	remote := t.TempDir()
+	source := filepath.ToSlash(filepath.Join(remote, "sub/v2"))
+	require.NoError(t, os.MkdirAll(filepath.Join(remote, "sub/proto"), 0o755))
+	// Another independently versioned module must not affect the selected one.
+	require.NoError(t, os.WriteFile(filepath.Join(remote, "protobuf.mod"), []byte("module "+filepath.ToSlash(remote)+"\nrequire example.com/unrelated v2.0.0\n"), 0o644))
+	require.NoError(t, os.WriteFile(filepath.Join(remote, "sub/protobuf.mod"), []byte("module "+source+"\nroots proto\n"), 0o644))
+	require.NoError(t, os.WriteFile(filepath.Join(remote, "sub/proto/item.proto"), []byte("syntax = \"proto3\"; package sub.v2; message Item {}\n"), 0o644))
+	runTestGit(t, remote, "init", "-q")
+	runTestGit(t, remote, "add", ".")
+	runTestGit(t, remote, "-c", "user.name=Test", "-c", "user.email=test@example.test", "commit", "-qm", "independent modules")
+	runTestGit(t, remote, "tag", "sub/v2.0.0")
+	cache := New(t.TempDir())
+	commit := strings.TrimSpace(runTestGit(t, remote, "rev-parse", "HEAD"))
+	for _, version := range []string{"v2.0.0", commit, ""} {
+		fetched, err := cache.Fetch(t.Context(), source, version)
+		require.NoError(t, err)
+		require.NoError(t, cache.Install(t.Context(), v1.Lock{Version: 1, Modules: []v1.LockedModule{fetched.Lock}}))
+		_, module, err := cache.Cached(fetched.Lock)
+		require.NoError(t, err)
+		assert.Equal(t, source, module.Name)
+		assert.Equal(t, []string{filepath.Join("sub", "proto")}, module.Roots)
+	}
+}
diff --git a/internal/adapters/gitmodules/major_test.go b/internal/adapters/gitmodules/major_test.go
new file mode 100644
index 00000000..0e851712
--- /dev/null
+++ b/internal/adapters/gitmodules/major_test.go
@@ -0,0 +1,162 @@
+package gitmodules
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+	"golang.org/x/mod/sumdb/dirhash"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+func TestMajorGitLayouts(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct{ name, logical, physical, tag string }{
+		{"root", "v2", ".", "v2.0.0"},
+		{"major_subdir", "v2", "v2", "v2.0.0"},
+		{"nested_root", "sub/v2", "sub", "sub/v2.0.0"},
+		{"nested_major_subdir", "sub/v2", "sub/v2", "sub/v2.0.0"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			repo := t.TempDir()
+			source := filepath.ToSlash(filepath.Join(repo, tt.logical))
+			dir := filepath.Join(repo, tt.physical)
+			require.NoError(t, os.MkdirAll(dir, 0o755))
+			require.NoError(t, os.WriteFile(filepath.Join(dir, v1.ModuleFile), []byte("module "+source+"\nroots proto\n"), 0o600))
+			runTestGit(t, repo, "init", "-q")
+			runTestGit(t, repo, "add", ".")
+			runTestGit(t, repo, "-c", "user.name=Test", "-c", "user.email=test@example.com", "commit", "-qm", "module")
+			runTestGit(t, repo, "-c", "user.name=Test", "-c", "user.email=test@example.com", "tag", "-a", tt.tag, "-m", "release")
+			commit := strings.TrimSpace(runTestGit(t, repo, "rev-parse", "HEAD"))
+			cache := New(t.TempDir())
+			for _, version := range []string{"v2.0.0", commit, ""} {
+				fetched, err := cache.Fetch(t.Context(), source, version)
+				require.NoError(t, err)
+				require.Equal(t, source, fetched.Module.Name)
+				require.Equal(t, commit, fetched.Lock.Commit)
+				require.Equal(t, []string{filepath.Join(tt.physical, "proto")}, fetched.Module.Roots)
+				lock := v1.Lock{Version: 1, Modules: []v1.LockedModule{fetched.Lock}}
+				require.NoError(t, cache.Install(t.Context(), lock))
+				_, module, err := cache.Cached(fetched.Lock)
+				require.NoError(t, err)
+				require.Equal(t, fetched.Module, module)
+			}
+			versions, err := cache.Versions(t.Context(), source)
+			require.NoError(t, err)
+			require.Equal(t, []string{"v2.0.0"}, versions)
+		})
+	}
+}
+
+func TestMajorGitWrongPhysicalIdentity(t *testing.T) {
+	t.Parallel()
+	repo := t.TempDir()
+	source := filepath.ToSlash(filepath.Join(repo, "sub/v2"))
+	require.NoError(t, os.MkdirAll(filepath.Join(repo, "elsewhere"), 0o755))
+	require.NoError(t, os.WriteFile(filepath.Join(repo, "elsewhere", v1.ModuleFile), []byte("module "+source+"\n"), 0o600))
+	runTestGit(t, repo, "init", "-q")
+	runTestGit(t, repo, "add", ".")
+	runTestGit(t, repo, "-c", "user.name=Test", "-c", "user.email=test@example.com", "commit", "-qm", "wrong location")
+	runTestGit(t, repo, "tag", "sub/v2.0.0")
+	commit := strings.TrimSpace(runTestGit(t, repo, "rev-parse", "HEAD"))
+	for _, version := range []string{"v2.0.0", commit, ""} {
+		_, err := New(t.TempDir()).Fetch(t.Context(), source, version)
+		require.Error(t, err)
+	}
+}
+
+func TestMajorWarmCacheRequiresNativeIdentity(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct{ name, location string }{
+		{"legacy", ""}, {"wrong_physical_location", "elsewhere"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			cache := New(t.TempDir())
+			entry := v1.LockedModule{Source: "example.com/repo/v2", Version: strings.Repeat("a", 40), Commit: strings.Repeat("a", 40)}
+			installed := v1ModuleCachePath(cache.root, entry)
+			require.NoError(t, os.MkdirAll(installed, 0o755))
+			require.NoError(t, os.WriteFile(filepath.Join(installed, "api.proto"), []byte("syntax = \"proto3\"; package api;"), 0o600))
+			if tt.location != "" {
+				require.NoError(t, os.MkdirAll(filepath.Join(installed, tt.location), 0o755))
+				require.NoError(t, os.WriteFile(filepath.Join(installed, tt.location, v1.ModuleFile), []byte("module "+entry.Source+"\n"), 0o600))
+			}
+			var err error
+			entry.Hash, err = dirhash.HashDir(installed, "", dirhash.Hash1)
+			require.NoError(t, err)
+			_, _, err = cache.Cached(entry)
+			require.Error(t, err)
+		})
+	}
+}
+
+func TestMajorMigrationRejectsUnsuffixedNativeRelease(t *testing.T) {
+	t.Parallel()
+	repo := t.TempDir()
+	require.NoError(t, os.WriteFile(filepath.Join(repo, v1.ModuleFile), []byte("module "+repo+"\n"), 0o600))
+	runTestGit(t, repo, "init", "-q")
+	runTestGit(t, repo, "add", ".")
+	runTestGit(t, repo, "-c", "user.name=Test", "-c", "user.email=test@example.com", "commit", "-qm", "native")
+	runTestGit(t, repo, "tag", "v2.0.0")
+	for _, tt := range []struct{ name, version, diagnostic string }{
+		{"unmarked", "v2.0.0", "update protobuf.mod explicitly"},
+		{"native_incompatible", "v2.0.0+incompatible", "native protobuf.mod"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			_, err := New(t.TempDir()).FetchMigration(t.Context(), repo, tt.version, "")
+			require.ErrorContains(t, err, tt.diagnostic)
+		})
+	}
+}
+
+func TestMajorLegacyRequirementsAtNativeBoundary(t *testing.T) {
+	t.Parallel()
+	legacy, native := t.TempDir(), t.TempDir()
+	require.NoError(t, os.WriteFile(filepath.Join(native, v1.ModuleFile), []byte("module "+native+"\n"), 0o600))
+	require.NoError(t, os.WriteFile(filepath.Join(legacy, "easyp.yaml"), []byte("deps:\n  - "+native+"@v2.0.0\n"), 0o600))
+	for _, repo := range []string{legacy, native} {
+		runTestGit(t, repo, "init", "-q")
+		runTestGit(t, repo, "add", ".")
+		runTestGit(t, repo, "-c", "user.name=Test", "-c", "user.email=test@example.com", "commit", "-qm", "metadata")
+	}
+	runTestGit(t, legacy, "tag", "v1.0.0")
+	runTestGit(t, native, "tag", "v2.0.0")
+	cache := New(t.TempDir())
+	fetched, err := cache.Fetch(t.Context(), legacy, "v1.0.0")
+	require.NoError(t, err)
+	require.Equal(t, []v1.Requirement{{Module: native, Version: "v2.0.0"}}, fetched.Module.Requires)
+	_, err = modules.Resolve(t.Context(), v1.Module{Requires: []v1.Requirement{{Module: legacy, Version: "v1.0.0"}}}, cache, nil)
+	require.ErrorContains(t, err, "update protobuf.mod explicitly")
+}
+
+func TestMajorLegacyMarkerIsNotAGitTag(t *testing.T) {
+	t.Parallel()
+	repo := t.TempDir()
+	require.NoError(t, os.WriteFile(filepath.Join(repo, "api.proto"), []byte("syntax = \"proto3\"; package api;"), 0o600))
+	runTestGit(t, repo, "init", "-q")
+	runTestGit(t, repo, "add", ".")
+	runTestGit(t, repo, "-c", "user.name=Test", "-c", "user.email=test@example.com", "commit", "-qm", "legacy")
+	runTestGit(t, repo, "tag", "v2.0.0")
+	runTestGit(t, repo, "tag", "v2.9.0+incompatible")
+	cache := New(t.TempDir())
+	versions, err := cache.Versions(t.Context(), repo)
+	require.NoError(t, err)
+	require.Equal(t, []string{"v2.0.0+incompatible"}, versions)
+	fetched, err := cache.FetchMigration(t.Context(), repo, "v2.0.0+incompatible", "")
+	require.NoError(t, err)
+	require.Equal(t, "v2.0.0+incompatible", fetched.Lock.Version)
+}
+
+func TestMajorURLCandidatePreservesTransport(t *testing.T) {
+	t.Parallel()
+	candidates, err := v1GitModuleCandidates("ssh://git@example.com:2222/repo%20space/v%32")
+	require.NoError(t, err)
+	require.Equal(t, "ssh://git@example.com:2222/repo%20space", candidates[0].remote)
+	require.Empty(t, candidates[0].subdir)
+	require.Equal(t, "v2.0.0", candidates[0].tag("v2.0.0"))
+}
diff --git a/internal/adapters/gitmodules/migration.go b/internal/adapters/gitmodules/migration.go
new file mode 100644
index 00000000..679336b0
--- /dev/null
+++ b/internal/adapters/gitmodules/migration.go
@@ -0,0 +1,176 @@
+package gitmodules
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"io"
+	"os"
+	"path"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	"golang.org/x/mod/semver"
+	"golang.org/x/mod/sumdb/dirhash"
+
+	moduleconfig "github.com/easyp-tech/easyp/internal/adapters/module_config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+// FetchMigration verifies a legacy installed-tree hash before calculating the
+// v1 tracked-checkout hash. Legacy repositories must preserve their proto source
+// selection and import names. An empty version requires an empty legacyHash and
+// permits initial resolution; native v1 repositories need no legacy comparison.
+func (c *Cache) FetchMigration(ctx context.Context, source, version, legacyHash string) (fetched modules.Fetched, err error) {
+	if (version != "" || legacyHash != "") && !v1.IsCommitRef(version) && !semver.IsValid(version) {
+		return modules.Fetched{}, fmt.Errorf("migration version %q must be a full Git commit or SemVer tag", version)
+	}
+	checkout, err := checkoutV1Module(ctx, source, version, c.root)
+	if err != nil {
+		return modules.Fetched{}, fmt.Errorf("checkoutV1Module: %w", err)
+	}
+	defer func() {
+		removeErr := os.RemoveAll(checkout.dir)
+		if removeErr != nil {
+			fetched = modules.Fetched{}
+			err = errors.Join(err, fmt.Errorf("RemoveAll: %w", removeErr))
+		}
+	}()
+	if err := moduleconfig.ValidateLegacyMajor(checkout.dir, source, version); err != nil {
+		return modules.Fetched{}, fmt.Errorf("ValidateLegacyMajor: %w", err)
+	}
+	files, err := migrationTrackedFiles(ctx, checkout.dir)
+	if err != nil {
+		return modules.Fetched{}, fmt.Errorf("migrationTrackedFiles: %w", err)
+	}
+	if err := validateMigrationLegacyReplacements(checkout.dir, files); err != nil {
+		return modules.Fetched{}, fmt.Errorf("validateMigrationLegacyReplacements: %w", err)
+	}
+	native, err := hasNativeMigrationModule(checkout.dir, files, source)
+	if err != nil {
+		return modules.Fetched{}, fmt.Errorf("hasNativeMigrationModule: %w", err)
+	}
+	if !native || legacyHash != "" {
+		oldHash, err := hashMigrationLegacyFiles(checkout.dir, files)
+		if err != nil {
+			return modules.Fetched{}, fmt.Errorf("hashMigrationLegacyFiles: %w", err)
+		}
+		if legacyHash != "" && oldHash != legacyHash {
+			return modules.Fetched{}, fmt.Errorf("legacy hash mismatch for %s at %s: got %s, want %s", source, checkout.commit, oldHash, legacyHash)
+		}
+		if err := validateMigrationSelection(checkout.dir, files, checkout.module); err != nil {
+			return modules.Fetched{}, fmt.Errorf("validateMigrationSelection: %w", err)
+		}
+	}
+	files = selectV1ProtoFiles(files, checkout.module.ProtoFilters)
+	hash, err := hashV1Files(checkout.dir, files)
+	if err != nil {
+		return modules.Fetched{}, fmt.Errorf("hashV1Files: %w", err)
+	}
+	if version == "" {
+		version = checkout.commit
+	}
+	module, bindings, err := c.resolveBSRDependencies(ctx, checkout.module)
+	if err != nil {
+		return modules.Fetched{}, fmt.Errorf("resolveBSRDependencies: %w", err)
+	}
+	return modules.Fetched{Module: module, Lock: v1.LockedModule{
+		Source: source, Version: version, Commit: checkout.commit, Hash: hash, BSR: bindings,
+	}}, nil
+}
+
+func migrationTrackedFiles(ctx context.Context, checkout string) ([]string, error) {
+	files, err := trackedV1Files(ctx, checkout)
+	if err != nil {
+		return nil, fmt.Errorf("trackedV1Files: %w", err)
+	}
+	// A Git symlink may be checked out as a regular file on systems that do
+	// not support symlinks. Inspect Git modes as well as filesystem modes.
+	raw, err := gitV1(ctx, checkout, "ls-files", "--stage", "-z")
+	if err != nil {
+		return nil, fmt.Errorf("gitV1: %w", err)
+	}
+	for _, entry := range strings.Split(strings.TrimSuffix(raw, "\x00"), "\x00") {
+		if entry == "" {
+			continue
+		}
+		if !strings.HasPrefix(entry, "100644 ") && !strings.HasPrefix(entry, "100755 ") {
+			return nil, fmt.Errorf("unsupported non-regular Git mode in %q", entry)
+		}
+	}
+	return files, nil
+}
+
+// hashMigrationLegacyFiles reproduces the old installer's path rewrite without
+// creating an installed tree. All tracked files participate, including files
+// outside import roots and non-proto files. Directory nodes also participate in
+// collision detection because buildInstallTree created them before hashing.
+func hashMigrationLegacyFiles(checkout string, files []string) (string, error) {
+	directories := make(map[string]bool)
+	for _, name := range files {
+		if !filepath.IsLocal(filepath.FromSlash(name)) || path.Clean(name) != name || strings.Contains(name, "\\") {
+			return "", fmt.Errorf("unsupported tracked path %q", name)
+		}
+		if _, err := regularV1File(filepath.Join(checkout, filepath.FromSlash(name))); err != nil {
+			return "", fmt.Errorf("regularV1File: %w", err)
+		}
+		for directory := path.Dir(name); directory != "."; directory = path.Dir(directory) {
+			directories[directory] = true
+		}
+	}
+	roots, err := readMigrationLegacyRoots(checkout, files)
+	if err != nil {
+		return "", fmt.Errorf("readMigrationLegacyRoots: %w", err)
+	}
+
+	installedDirectories := make(map[string]bool)
+	for directory := range directories {
+		for destination := renameMigrationLegacyFile(directory, roots); destination != "."; destination = path.Dir(destination) {
+			installedDirectories[destination] = true
+		}
+	}
+	originals := make(map[string]string, len(files))
+	names := make([]string, 0, len(files))
+	for _, original := range files {
+		name := renameMigrationLegacyFile(original, roots)
+		if other, exists := originals[name]; exists {
+			return "", fmt.Errorf("legacy file collision at %q between %q and %q", name, other, original)
+		}
+		originals[name] = original
+		names = append(names, name)
+		for directory := path.Dir(name); directory != "."; directory = path.Dir(directory) {
+			installedDirectories[directory] = true
+		}
+	}
+	slices.Sort(names)
+	for _, name := range names {
+		if installedDirectories[name] {
+			return "", fmt.Errorf("legacy directory/file collision at %q from %q", name, originals[name])
+		}
+	}
+	hash, err := dirhash.Hash1(names, func(name string) (io.ReadCloser, error) {
+		file, err := os.Open(filepath.Join(checkout, filepath.FromSlash(originals[name])))
+		if err != nil {
+			return nil, fmt.Errorf("Open: %w", err)
+		}
+		return file, nil
+	})
+	if err != nil {
+		return "", fmt.Errorf("Hash1: %w", err)
+	}
+	return hash, nil
+}
+
+// The old renamer selected the first matching prefix, without sorting,
+// cleaning, or repeatedly stripping roots from the resulting path.
+func renameMigrationLegacyFile(name string, roots []string) string {
+	for _, root := range roots {
+		prefix := root + "/"
+		if strings.HasPrefix(name, prefix) {
+			return strings.TrimPrefix(name, prefix)
+		}
+	}
+	return name
+}
diff --git a/internal/adapters/gitmodules/migration_config.go b/internal/adapters/gitmodules/migration_config.go
new file mode 100644
index 00000000..e6985dfa
--- /dev/null
+++ b/internal/adapters/gitmodules/migration_config.go
@@ -0,0 +1,272 @@
+package gitmodules
+
+import (
+	"bytes"
+	"errors"
+	"fmt"
+	"io"
+	"os"
+	"path"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func readMigrationLegacyRoots(checkout string, files []string) ([]string, error) {
+	tracked := make(map[string]bool, len(files))
+	for _, name := range files {
+		tracked[name] = true
+		if path.Base(name) != v1.ModuleFile {
+			continue
+		}
+		raw, err := os.ReadFile(filepath.Join(checkout, filepath.FromSlash(name)))
+		if err != nil {
+			return nil, fmt.Errorf("ReadFile: %w", err)
+		}
+		if v1.IsModuleManifest(raw) {
+			return nil, fmt.Errorf("cannot reproduce legacy roots with native protobuf.mod %q", name)
+		}
+	}
+	// Legacy ReadFromRepo preferred buf.work.yaml, then buf.yaml, then easyp.yaml.
+	// Malformed higher-priority files are refused rather than silently falling
+	// back to roots whose provenance can no longer be established reliably.
+	for _, name := range []string{"buf.work.yaml", "buf.yaml", "easyp.yaml"} {
+		if !tracked[name] {
+			continue
+		}
+		raw, err := os.ReadFile(filepath.Join(checkout, name))
+		if err != nil {
+			return nil, fmt.Errorf("ReadFile: %w", err)
+		}
+		roots, err := parseMigrationLegacyRoots(name, raw)
+		if err != nil {
+			return nil, fmt.Errorf("parseMigrationLegacyRoots: %s: %w", name, err)
+		}
+		for _, root := range roots {
+			if root == "" || root == "." {
+				continue
+			}
+			if !filepath.IsLocal(filepath.FromSlash(root)) || path.Clean(root) != root || strings.Contains(root, "\\") {
+				return nil, fmt.Errorf("unsupported legacy root %q in %s", root, name)
+			}
+		}
+		return roots, nil
+	}
+	return nil, nil
+}
+
+func parseMigrationLegacyRoots(name string, raw []byte) ([]string, error) {
+	// ParseConfig historically expanded environment variables before parsing.
+	// The environment that produced an existing lock cannot be reconstructed.
+	if bytes.ContainsRune(raw, '$') {
+		return nil, fmt.Errorf("legacy config contains environment placeholders")
+	}
+	decoder := yaml.NewDecoder(bytes.NewReader(raw))
+	var document yaml.Node
+	err := decoder.Decode(&document)
+	if err != nil {
+		return nil, fmt.Errorf("Decode: %w", err)
+	}
+	var extra yaml.Node
+	err = decoder.Decode(&extra)
+	if !errors.Is(err, io.EOF) {
+		return nil, fmt.Errorf("legacy config must contain exactly one YAML document")
+	}
+	if document.Kind != yaml.DocumentNode || len(document.Content) != 1 {
+		return nil, fmt.Errorf("legacy config must contain a mapping")
+	}
+	if err := validateMigrationYAML(&document); err != nil {
+		return nil, fmt.Errorf("validateMigrationYAML: %w", err)
+	}
+	root := document.Content[0]
+	switch name {
+	case "buf.work.yaml":
+		fields, err := migrationMapping(root, "version", "directories")
+		if err != nil {
+			return nil, fmt.Errorf("migrationMapping: %w", err)
+		}
+		if fields["directories"] == nil {
+			return nil, fmt.Errorf("legacy Buf workspace is missing directories")
+		}
+		return migrationStringList(fields["directories"])
+	case "buf.yaml":
+		return migrationBufRoots(root)
+	case "easyp.yaml":
+		return migrationEasyPRoots(root)
+	default:
+		return nil, fmt.Errorf("unsupported legacy config %q", name)
+	}
+}
+
+func migrationBufRoots(root *yaml.Node) ([]string, error) {
+	fields, err := migrationMapping(root, "version", "modules", "name", "deps", "lint", "breaking", "build")
+	if err != nil {
+		return nil, fmt.Errorf("migrationMapping: %w", err)
+	}
+	version, err := migrationString(fields["version"])
+	if err != nil {
+		return nil, fmt.Errorf("migrationString: %w", err)
+	}
+	modules := fields["modules"]
+	if modules == nil {
+		// The old reader used only modules[].path, including for older Buf
+		// versions. In particular it did not strip v1beta1 build.roots.
+		if version == "v1" || version == "v1beta1" {
+			return nil, nil
+		}
+		return nil, fmt.Errorf("legacy Buf config is missing modules")
+	}
+	if version != "v2" || modules.Kind != yaml.SequenceNode || len(modules.Content) == 0 {
+		return nil, fmt.Errorf("legacy Buf modules must be a nonempty v2 list")
+	}
+	roots := make([]string, 0, len(modules.Content))
+	for _, module := range modules.Content {
+		fields, err := migrationMapping(module, "path", "name", "lint", "breaking")
+		if err != nil {
+			return nil, fmt.Errorf("migrationMapping: %w", err)
+		}
+		root, err := migrationString(fields["path"])
+		if err != nil {
+			return nil, fmt.Errorf("migrationString: %w", err)
+		}
+		if root == "" {
+			return nil, fmt.Errorf("legacy Buf module path is empty")
+		}
+		roots = append(roots, root)
+	}
+	return roots, nil
+}
+
+func migrationEasyPRoots(root *yaml.Node) ([]string, error) {
+	fields, err := migrationMapping(root, "deps", "generate", "lint", "breaking")
+	if err != nil {
+		return nil, fmt.Errorf("migrationMapping: %w", err)
+	}
+	if fields["generate"] == nil {
+		return nil, nil
+	}
+	generate, err := migrationMapping(fields["generate"], "inputs", "plugins", "managed")
+	if err != nil {
+		return nil, fmt.Errorf("migrationMapping: %w", err)
+	}
+	inputs := generate["inputs"]
+	if inputs == nil {
+		return nil, nil
+	}
+	if inputs.Kind != yaml.SequenceNode {
+		return nil, fmt.Errorf("legacy generate.inputs must be a list")
+	}
+	roots := make([]string, 0, len(inputs.Content))
+	for _, input := range inputs.Content {
+		fields, err := migrationMapping(input, "directory", "git_repo")
+		if err != nil {
+			return nil, fmt.Errorf("migrationMapping: %w", err)
+		}
+		if len(fields) != 1 {
+			return nil, fmt.Errorf("legacy input must have exactly one source")
+		}
+		if gitRepo := fields["git_repo"]; gitRepo != nil {
+			if _, err := migrationMapping(gitRepo, "url", "sub_directory", "root"); err != nil {
+				return nil, fmt.Errorf("migrationMapping: %w", err)
+			}
+			// The old readEasyp appended the zero directory root for Git inputs.
+			roots = append(roots, "")
+			continue
+		}
+		directory := fields["directory"]
+		if directory.Kind == yaml.ScalarNode {
+			if _, err := migrationString(directory); err != nil {
+				return nil, fmt.Errorf("migrationString: %w", err)
+			}
+			roots = append(roots, ".")
+			continue
+		}
+		fields, err = migrationMapping(directory, "path", "root")
+		if err != nil {
+			return nil, fmt.Errorf("migrationMapping: %w", err)
+		}
+		if field := fields["path"]; field != nil {
+			if _, err := migrationString(field); err != nil {
+				return nil, fmt.Errorf("migrationString: %w", err)
+			}
+		}
+		root := "."
+		if field := fields["root"]; field != nil {
+			root, err = migrationString(field)
+			if err != nil {
+				return nil, fmt.Errorf("migrationString: %w", err)
+			}
+			if root == "" {
+				root = "."
+			}
+		}
+		roots = append(roots, root)
+	}
+	return roots, nil
+}
+
+func validateMigrationYAML(node *yaml.Node) error {
+	if node.Kind == yaml.AliasNode || node.Anchor != "" || node.Tag == "!!null" || node.Tag == "!!merge" {
+		return fmt.Errorf("legacy config contains an alias, anchor, merge, or null value")
+	}
+	if node.Kind == yaml.MappingNode {
+		seen := make(map[string]bool)
+		for i := 0; i < len(node.Content); i += 2 {
+			key := node.Content[i]
+			if key.Kind != yaml.ScalarNode || key.Tag != "!!str" || seen[key.Value] {
+				return fmt.Errorf("legacy config contains a duplicate or non-string key %q", key.Value)
+			}
+			seen[key.Value] = true
+		}
+	}
+	for _, child := range node.Content {
+		if err := validateMigrationYAML(child); err != nil {
+			return fmt.Errorf("validateMigrationYAML: %w", err)
+		}
+	}
+	return nil
+}
+
+func migrationMapping(node *yaml.Node, allowed ...string) (map[string]*yaml.Node, error) {
+	if node == nil || node.Kind != yaml.MappingNode {
+		return nil, fmt.Errorf("legacy config field must be a mapping")
+	}
+	fields := make(map[string]*yaml.Node, len(node.Content)/2)
+	for i := 0; i < len(node.Content); i += 2 {
+		key := node.Content[i].Value
+		if !slices.Contains(allowed, key) {
+			return nil, fmt.Errorf("unsupported legacy config field %q", key)
+		}
+		fields[key] = node.Content[i+1]
+	}
+	return fields, nil
+}
+
+func migrationString(node *yaml.Node) (string, error) {
+	if node == nil || node.Kind != yaml.ScalarNode || node.Tag != "!!str" {
+		return "", fmt.Errorf("legacy config field must be a string")
+	}
+	return node.Value, nil
+}
+
+func migrationStringList(node *yaml.Node) ([]string, error) {
+	if node.Kind != yaml.SequenceNode || len(node.Content) == 0 {
+		return nil, fmt.Errorf("legacy roots must be a nonempty list")
+	}
+	roots := make([]string, 0, len(node.Content))
+	for _, item := range node.Content {
+		root, err := migrationString(item)
+		if err != nil {
+			return nil, fmt.Errorf("migrationString: %w", err)
+		}
+		if root == "" {
+			return nil, fmt.Errorf("legacy root is empty")
+		}
+		roots = append(roots, root)
+	}
+	return roots, nil
+}
diff --git a/internal/adapters/gitmodules/migration_selection.go b/internal/adapters/gitmodules/migration_selection.go
new file mode 100644
index 00000000..2622760a
--- /dev/null
+++ b/internal/adapters/gitmodules/migration_selection.go
@@ -0,0 +1,120 @@
+package gitmodules
+
+import (
+	"bytes"
+	"fmt"
+	"os"
+	"path"
+	"path/filepath"
+	"slices"
+
+	"github.com/easyp-tech/easyp/internal/adapters/modfile"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+// The normal dependency adapter reads legacy requirements but drops local
+// replacements. Refuse them before trusting that adapted dependency graph,
+// including nested declarations whose effect cannot be established safely.
+func validateMigrationLegacyReplacements(checkout string, files []string) error {
+	for _, name := range files {
+		if path.Base(name) != v1.ModuleFile {
+			continue
+		}
+		raw, err := os.ReadFile(filepath.Join(checkout, filepath.FromSlash(name)))
+		if err != nil {
+			return fmt.Errorf("ReadFile: %w", err)
+		}
+		if v1.IsModuleManifest(raw) {
+			continue
+		}
+		manifest, err := modfile.Parse(raw)
+		if err != nil {
+			return fmt.Errorf("Parse: %w", err)
+		}
+		if len(manifest.Replace) > 0 {
+			return fmt.Errorf("dependency legacy manifest %q has local replacements; full lock migration requires manual migration", name)
+		}
+	}
+	return nil
+}
+
+func hasNativeMigrationModule(checkout string, files []string, source string) (bool, error) {
+	for _, name := range files {
+		if path.Base(name) != v1.ModuleFile {
+			continue
+		}
+		raw, err := os.ReadFile(filepath.Join(checkout, filepath.FromSlash(name)))
+		if err != nil {
+			return false, fmt.Errorf("ReadFile: %w", err)
+		}
+		if !v1.IsModuleManifest(raw) {
+			continue
+		}
+		module, err := v1.ParseModule(bytes.NewReader(raw))
+		if err != nil {
+			return false, fmt.Errorf("ParseModule: %w", err)
+		}
+		if module.Name == source {
+			return true, nil
+		}
+	}
+	return false, nil
+}
+
+// validateMigrationSelection checks both default Git generation inputs and the
+// import namespace available to consumers. Equal tree hashes alone do not prove
+// equivalence: v1 roots can omit legacy files or introduce additional aliases.
+func validateMigrationSelection(checkout string, files []string, module v1.Module) error {
+	roots, err := readMigrationLegacyRoots(checkout, files)
+	if err != nil {
+		return fmt.Errorf("readMigrationLegacyRoots: %w", err)
+	}
+	legacy := make(map[string]string)
+	for _, name := range files {
+		if path.Ext(name) == ".proto" {
+			legacy[renameMigrationLegacyFile(name, roots)] = name
+		}
+	}
+	sources, err := modules.ModuleSources(checkout, module)
+	if err != nil {
+		return fmt.Errorf("ModuleSources: %w", err)
+	}
+	selected := make(map[string]string)
+	for _, source := range sources {
+		err := modules.WalkProtoFiles(source.Path, func(file string) error {
+			importName, err := filepath.Rel(source.Path, file)
+			if err != nil {
+				return fmt.Errorf("Rel: %w", err)
+			}
+			physicalName, err := filepath.Rel(checkout, file)
+			if err != nil {
+				return fmt.Errorf("Rel: %w", err)
+			}
+			importName, physicalName = filepath.ToSlash(importName), filepath.ToSlash(physicalName)
+			if previous, exists := selected[importName]; exists && previous != physicalName {
+				return fmt.Errorf("dependency %s source selection collides at %q; manual migration is required", module.Name, importName)
+			}
+			selected[importName] = physicalName
+			return nil
+		})
+		if err != nil {
+			return fmt.Errorf("WalkProtoFiles: %w", err)
+		}
+	}
+	// Stable ordering makes the first actionable mismatch reproducible.
+	names := make([]string, 0, len(legacy)+len(selected))
+	for name := range legacy {
+		names = append(names, name)
+	}
+	for name := range selected {
+		names = append(names, name)
+	}
+	slices.Sort(names)
+	for _, name := range names {
+		if legacy[name] != selected[name] {
+			return fmt.Errorf("dependency %s source selection differs at import %q (legacy file %q, v1 file %q); manual migration is required", module.Name, name, legacy[name], selected[name])
+		}
+	}
+	return nil
+}
diff --git a/internal/adapters/gitmodules/migration_test.go b/internal/adapters/gitmodules/migration_test.go
new file mode 100644
index 00000000..182d5e32
--- /dev/null
+++ b/internal/adapters/gitmodules/migration_test.go
@@ -0,0 +1,430 @@
+package gitmodules
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"golang.org/x/mod/sumdb/dirhash"
+)
+
+func TestFetchMigration(t *testing.T) {
+	t.Parallel()
+
+	config := "generate:\n  inputs:\n    - directory: {path: proto, root: proto}\n"
+	tests := []struct {
+		name      string
+		version   string
+		initial   bool
+		badHash   bool
+		useCommit bool
+	}{
+		{name: "pinned_commit", useCommit: true},
+		{name: "semver", version: "v1.0.0"},
+		{name: "initial_resolution", initial: true},
+		{name: "mismatch_cleans_checkout", version: "v1.0.0", badHash: true},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			files := map[string]string{
+				"easyp.yaml":          config,
+				"proto/example.proto": "syntax = \"proto3\";\n",
+				"proto/README.md":     "retained non-proto content\n",
+				"LICENSE":             "license outside import roots\n",
+			}
+			repository, commit := migrationTestRepository(t, files)
+			runTestGit(t, repository, "tag", "v1.0.0")
+			// Untracked checkout files never participated in the legacy archive.
+			require.NoError(t, os.WriteFile(filepath.Join(repository, "untracked"), []byte("ignored"), 0o600))
+			legacyHash := migrationTestHash(t, map[string]string{
+				"easyp.yaml":    config,
+				"example.proto": files["proto/example.proto"],
+				"README.md":     files["proto/README.md"],
+				"LICENSE":       files["LICENSE"],
+			})
+			if tt.initial {
+				legacyHash = ""
+			}
+			if tt.badHash {
+				legacyHash = migrationTestHash(t, map[string]string{"different": "tree"})
+			}
+			version := tt.version
+			if tt.useCommit {
+				version = commit
+			}
+			cacheDir := t.TempDir()
+			fetched, err := (&Cache{root: cacheDir}).FetchMigration(t.Context(), repository, version, legacyHash)
+			if tt.badHash {
+				require.ErrorContains(t, err, "legacy hash mismatch")
+			} else {
+				require.NoError(t, err)
+				assert.Equal(t, commit, fetched.Lock.Commit)
+				assert.Equal(t, repository, fetched.Lock.Source)
+				assert.Equal(t, repository, fetched.Module.Name)
+				assert.Equal(t, []string{"proto"}, fetched.Module.Roots)
+				assert.Equal(t, migrationTestHash(t, files), fetched.Lock.Hash)
+				assert.NotEqual(t, legacyHash, fetched.Lock.Hash)
+				if version == "" {
+					assert.Equal(t, commit, fetched.Lock.Version)
+				} else {
+					assert.Equal(t, version, fetched.Lock.Version)
+				}
+			}
+			entries, err := os.ReadDir(cacheDir)
+			require.NoError(t, err)
+			for _, entry := range entries {
+				assert.Equal(t, "objects", entry.Name(), "temporary checkout was left behind")
+			}
+		})
+	}
+}
+
+func TestHashMigrationLegacyFiles(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name    string
+		files   map[string]string
+		want    map[string]string
+		wantErr string
+	}{
+		{
+			name:  "ordered_roots_parent_first",
+			files: map[string]string{"buf.work.yaml": "version: v1\ndirectories: [a, a/b]\n", "a/b/message.proto": "message"},
+			want:  map[string]string{"buf.work.yaml": "version: v1\ndirectories: [a, a/b]\n", "b/message.proto": "message"},
+		},
+		{
+			name:  "ordered_roots_child_first",
+			files: map[string]string{"buf.work.yaml": "version: v1\ndirectories: [a/b, a]\n", "a/b/message.proto": "message"},
+			want:  map[string]string{"buf.work.yaml": "version: v1\ndirectories: [a/b, a]\n", "message.proto": "message"},
+		},
+		{
+			name:  "workspace_precedes_buf_module_and_easyp",
+			files: map[string]string{"buf.work.yaml": "version: v1\ndirectories: [workspace]\n", "buf.yaml": "version: v2\nmodules: [{path: module}]\n", "easyp.yaml": "generate:\n  inputs: [{directory: {path: local, root: local}}]\n", "workspace/file.proto": "workspace", "module/README": "module", "local/file.proto": "local"},
+			want:  map[string]string{"buf.work.yaml": "version: v1\ndirectories: [workspace]\n", "buf.yaml": "version: v2\nmodules: [{path: module}]\n", "easyp.yaml": "generate:\n  inputs: [{directory: {path: local, root: local}}]\n", "file.proto": "workspace", "module/README": "module", "local/file.proto": "local"},
+		},
+		{
+			name:  "buf_module_precedes_easyp",
+			files: map[string]string{"buf.yaml": "version: v2\nmodules: [{path: module}]\n", "easyp.yaml": "generate:\n  inputs: [{directory: {path: local, root: local}}]\n", "module/file.proto": "module", "local/file.proto": "local"},
+			want:  map[string]string{"buf.yaml": "version: v2\nmodules: [{path: module}]\n", "easyp.yaml": "generate:\n  inputs: [{directory: {path: local, root: local}}]\n", "file.proto": "module", "local/file.proto": "local"},
+		},
+		{
+			name:  "scalar_directory_does_not_strip_path",
+			files: map[string]string{"easyp.yaml": "generate:\n  inputs: [{directory: proto}]\n", "proto/file.proto": "message"},
+			want:  map[string]string{"easyp.yaml": "generate:\n  inputs: [{directory: proto}]\n", "proto/file.proto": "message"},
+		},
+		{
+			name:  "unconfigured_repository_keeps_all_files",
+			files: map[string]string{"proto/file.proto": "message", "README": "documentation"},
+			want:  map[string]string{"proto/file.proto": "message", "README": "documentation"},
+		},
+		{
+			name:    "file_collision",
+			files:   map[string]string{"buf.work.yaml": "version: v1\ndirectories: [a, b]\n", "a/file.proto": "a", "b/file.proto": "b"},
+			wantErr: "collision",
+		},
+		{
+			name:    "directory_file_collision",
+			files:   map[string]string{"buf.work.yaml": "version: v1\ndirectories: [a, b]\n", "a/nested/value.proto": "a", "b/nested": "b"},
+			wantErr: "collision",
+		},
+		{
+			name:    "retained_empty_directory_collision",
+			files:   map[string]string{"buf.work.yaml": "version: v1\ndirectories: [a, b]\n", "a/file.proto": "a", "b/a": "b"},
+			wantErr: "collision",
+		},
+		{
+			name:    "native_manifest",
+			files:   map[string]string{"protobuf.mod": "module example.com/protos\n", "proto/file.proto": "message"},
+			wantErr: "native protobuf.mod",
+		},
+		{
+			name:    "nested_native_manifest",
+			files:   map[string]string{"nested/protobuf.mod": "module example.com/protos/nested\n", "nested/file.proto": "message"},
+			wantErr: "native protobuf.mod",
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			repository, _ := migrationTestRepository(t, tt.files)
+			files, err := trackedV1Files(t.Context(), repository)
+			require.NoError(t, err)
+			hash, err := hashMigrationLegacyFiles(repository, files)
+			if tt.wantErr != "" {
+				require.ErrorContains(t, err, tt.wantErr)
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, migrationTestHash(t, tt.want), hash)
+		})
+	}
+}
+
+func TestReadMigrationLegacyRootsRejectsAmbiguity(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name     string
+		filename string
+		content  string
+	}{
+		{name: "second_document", filename: "easyp.yaml", content: "generate: {}\n---\ngenerate: {}\n"},
+		{name: "alias", filename: "easyp.yaml", content: "generate:\n  inputs: [{directory: &root proto}, {directory: *root}]\n"},
+		{name: "null_root", filename: "easyp.yaml", content: "generate:\n  inputs: [{directory: {path: proto, root: null}}]\n"},
+		{name: "unknown_root_field", filename: "easyp.yaml", content: "generate:\n  inputs: [{directory: {path: proto, roots: [proto]}}]\n"},
+		{name: "placeholder", filename: "easyp.yaml", content: "generate:\n  inputs: [{directory: {path: proto, root: '${ROOT}'}}]\n"},
+		{name: "duplicate_key", filename: "easyp.yaml", content: "generate: {}\ngenerate: {}\n"},
+		{name: "null_document", filename: "easyp.yaml", content: "null\n"},
+		{name: "input_without_source", filename: "easyp.yaml", content: "generate:\n  inputs: [{}]\n"},
+		{name: "unsafe_root", filename: "buf.work.yaml", content: "version: v1\ndirectories: [../proto]\n"},
+		{name: "buf_null_root", filename: "buf.work.yaml", content: "version: v1\ndirectories: [null]\n"},
+		{name: "buf_missing_directories", filename: "buf.work.yaml", content: "version: v1\ndirectory: proto\n"},
+		{name: "buf_v2_missing_path", filename: "buf.yaml", content: "version: v2\nmodules: [{name: example.com/protos}]\n"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			repository, _ := migrationTestRepository(t, map[string]string{tt.filename: tt.content})
+			_, err := hashMigrationLegacyFiles(repository, []string{tt.filename})
+			require.Error(t, err)
+		})
+	}
+}
+
+func TestFetchMigrationRejectsUnsafeNodes(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name      string
+		submodule bool
+	}{
+		{name: "symlink"},
+		{name: "submodule", submodule: true},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			repository, commit := migrationTestRepository(t, map[string]string{"file.proto": "message"})
+			if tt.submodule {
+				runTestGit(t, repository, "update-index", "--add", "--cacheinfo", "160000,"+commit+",unsafe")
+			} else {
+				require.NoError(t, os.Symlink("file.proto", filepath.Join(repository, "unsafe")))
+				runTestGit(t, repository, "add", "unsafe")
+			}
+			runTestGit(t, repository, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "unsafe")
+			runTestGit(t, repository, "tag", "v1.0.0")
+			cacheDir := t.TempDir()
+			_, err := (&Cache{root: cacheDir}).FetchMigration(t.Context(), repository, "v1.0.0", "h1:untrusted")
+			require.ErrorContains(t, err, "non-regular")
+			entries, err := os.ReadDir(cacheDir)
+			require.NoError(t, err)
+			assert.Empty(t, entries)
+		})
+	}
+}
+
+func TestMigrationTrackedFilesRejectsMaterializedSymlink(t *testing.T) {
+	t.Parallel()
+
+	repository, _ := migrationTestRepository(t, map[string]string{"link": "target.proto"})
+	blob := strings.TrimSpace(runTestGit(t, repository, "rev-parse", "HEAD:link"))
+	// A checkout with core.symlinks=false materializes a Git symlink as a
+	// regular file. The index mode must still prevent legacy verification.
+	runTestGit(t, repository, "update-index", "--cacheinfo", "120000,"+blob+",link")
+	_, err := migrationTrackedFiles(t.Context(), repository)
+	require.ErrorContains(t, err, "non-regular Git mode")
+}
+
+func TestFetchMigrationPinnedCommitIgnoresMovedTag(t *testing.T) {
+	t.Parallel()
+
+	files := map[string]string{"old.proto": "old"}
+	repository, commit := migrationTestRepository(t, files)
+	runTestGit(t, repository, "tag", "v1.0.0")
+	require.NoError(t, os.WriteFile(filepath.Join(repository, "new.proto"), []byte("new"), 0o600))
+	runTestGit(t, repository, "add", ".")
+	runTestGit(t, repository, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "new")
+	runTestGit(t, repository, "tag", "-f", "v1.0.0")
+	cacheDir := t.TempDir()
+	fetched, err := (&Cache{root: cacheDir}).FetchMigration(t.Context(), repository, commit, migrationTestHash(t, files))
+	require.NoError(t, err)
+	assert.Equal(t, commit, fetched.Lock.Commit)
+	assert.Equal(t, migrationTestHash(t, files), fetched.Lock.Hash)
+}
+
+func TestFetchMigrationRejectsUnsupportedVersion(t *testing.T) {
+	t.Parallel()
+
+	cacheDir := t.TempDir()
+	_, err := (&Cache{root: cacheDir}).FetchMigration(t.Context(), "unused", "main", "h1:untrusted")
+	require.ErrorContains(t, err, "full Git commit or SemVer tag")
+	entries, err := os.ReadDir(cacheDir)
+	require.NoError(t, err)
+	assert.Empty(t, entries)
+}
+
+func TestFetchMigrationRejectsLegacyHashWithoutPin(t *testing.T) {
+	t.Parallel()
+
+	cacheDir := t.TempDir()
+	_, err := (&Cache{root: cacheDir}).FetchMigration(t.Context(), "unused", "", "h1:untrusted")
+	require.ErrorContains(t, err, "full Git commit or SemVer tag")
+	entries, err := os.ReadDir(cacheDir)
+	require.NoError(t, err)
+	assert.Empty(t, entries)
+}
+
+func TestFetchMigrationRejectsChangedSourceSelection(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name  string
+		files map[string]string
+	}{
+		{
+			name:  "proto_outside_roots",
+			files: map[string]string{"easyp.yaml": "generate:\n  inputs: [{directory: {path: proto, root: proto}}]\n", "proto/a.proto": "a", "extras/b.proto": "b"},
+		},
+		{
+			name:  "overlapping_roots_add_import_alias",
+			files: map[string]string{"buf.work.yaml": "version: v1\ndirectories: [a, a/b]\n", "a/b/file.proto": "file"},
+		},
+		{
+			name:  "buf_v1beta1_roots_change_import_names",
+			files: map[string]string{"buf.yaml": "version: v1beta1\nbuild: {roots: [proto]}\n", "proto/file.proto": "file"},
+		},
+		{
+			name:  "hidden_directory_is_no_longer_selected",
+			files: map[string]string{"file.proto": "file", ".hidden/extra.proto": "extra"},
+		},
+		{
+			name:  "vendored_directory_is_no_longer_selected",
+			files: map[string]string{"file.proto": "file", "easyp_vendor/extra.proto": "extra"},
+		},
+		{
+			name:  "nested_buf_module_is_no_longer_selected",
+			files: map[string]string{"file.proto": "file", "nested/buf.yaml": "version: v1\n", "nested/extra.proto": "extra"},
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			for _, mode := range []struct {
+				name    string
+				withPin bool
+			}{{name: "initial_resolution"}, {name: "historical_pin", withPin: true}} {
+				t.Run(mode.name, func(t *testing.T) {
+					t.Parallel()
+					repository, commit := migrationTestRepository(t, tt.files)
+					files, err := trackedV1Files(t.Context(), repository)
+					require.NoError(t, err)
+					oldHash, err := hashMigrationLegacyFiles(repository, files)
+					require.NoError(t, err)
+					version := ""
+					if mode.withPin {
+						version = commit
+					} else {
+						oldHash = ""
+					}
+					cacheDir := t.TempDir()
+					_, err = (&Cache{root: cacheDir}).FetchMigration(t.Context(), repository, version, oldHash)
+					require.ErrorContains(t, err, "source selection")
+					require.ErrorContains(t, err, "manual migration")
+					entries, err := os.ReadDir(cacheDir)
+					require.NoError(t, err)
+					for _, entry := range entries {
+						assert.Equal(t, "objects", entry.Name(), "temporary checkout was left behind")
+					}
+				})
+			}
+		})
+	}
+}
+
+func TestFetchMigrationAcceptsNativeInitialResolution(t *testing.T) {
+	t.Parallel()
+
+	repository, _ := migrationTestRepository(t, map[string]string{"proto/file.proto": "file", "extra.proto": "extra"})
+	require.NoError(t, os.WriteFile(filepath.Join(repository, "protobuf.mod"), []byte("module "+repository+"\nroots proto\n"), 0o600))
+	runTestGit(t, repository, "add", ".")
+	runTestGit(t, repository, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "native")
+	cacheDir := t.TempDir()
+	fetched, err := (&Cache{root: cacheDir}).FetchMigration(t.Context(), repository, "", "")
+	require.NoError(t, err)
+	assert.Equal(t, []string{"proto"}, fetched.Module.Roots)
+	entries, err := os.ReadDir(cacheDir)
+	require.NoError(t, err)
+	assert.Empty(t, entries)
+}
+
+func TestFetchMigrationRejectsLegacyDependencyReplacements(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name     string
+		manifest string
+		withPin  bool
+	}{
+		{name: "root_initial", manifest: "protobuf.mod"},
+		{name: "root_pinned", manifest: "protobuf.mod", withPin: true},
+		{name: "nested_initial", manifest: "nested/protobuf.mod"},
+		{name: "nested_pinned", manifest: "nested/protobuf.mod", withPin: true},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			files := map[string]string{
+				"file.proto": "file",
+				tt.manifest:  "direct (\nexample.com/common@v1.0.0\n)\nreplace example.com/common@v1.0.0 => ../common\n",
+			}
+			repository, commit := migrationTestRepository(t, files)
+			var version, oldHash string
+			if tt.withPin {
+				version, oldHash = commit, migrationTestHash(t, files)
+			}
+			cacheDir := t.TempDir()
+			_, err := (&Cache{root: cacheDir}).FetchMigration(t.Context(), repository, version, oldHash)
+			require.ErrorContains(t, err, "local replacements")
+			require.ErrorContains(t, err, tt.manifest)
+			require.ErrorContains(t, err, "manual migration")
+			entries, err := os.ReadDir(cacheDir)
+			require.NoError(t, err)
+			for _, entry := range entries {
+				assert.Equal(t, "objects", entry.Name(), "temporary checkout was left behind")
+			}
+		})
+	}
+}
+
+func migrationTestRepository(t *testing.T, files map[string]string) (string, string) {
+	t.Helper()
+	directory := t.TempDir()
+	migrationTestWriteFiles(t, directory, files)
+	runTestGit(t, directory, "init", "-q")
+	runTestGit(t, directory, "add", ".")
+	runTestGit(t, directory, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+	return directory, strings.TrimSpace(runTestGit(t, directory, "rev-parse", "HEAD"))
+}
+
+func migrationTestHash(t *testing.T, files map[string]string) string {
+	t.Helper()
+	directory := t.TempDir()
+	migrationTestWriteFiles(t, directory, files)
+	hash, err := dirhash.HashDir(directory, "", dirhash.DefaultHash)
+	require.NoError(t, err)
+	return hash
+}
+
+func migrationTestWriteFiles(t *testing.T, directory string, files map[string]string) {
+	t.Helper()
+	for name, content := range files {
+		path := filepath.Join(directory, filepath.FromSlash(name))
+		require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+		require.NoError(t, os.WriteFile(path, []byte(content), 0o644))
+	}
+}
diff --git a/internal/adapters/gitmodules/object_cache.go b/internal/adapters/gitmodules/object_cache.go
new file mode 100644
index 00000000..86b1a98c
--- /dev/null
+++ b/internal/adapters/gitmodules/object_cache.go
@@ -0,0 +1,116 @@
+package gitmodules
+
+import (
+	"context"
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+	"time"
+
+	moduleconfig "github.com/easyp-tech/easyp/internal/adapters/module_config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// checkoutCachedCommit fetches one snapshot into a reusable bare object store.
+// Temporary checkouts borrow only local cached objects; no second network clone
+// is necessary when Fetch is followed by Install or the same commit is reused.
+func checkoutCachedCommit(ctx context.Context, checkout string, entry v1.LockedModule, candidate v1GitModuleCandidate) (bool, error) {
+	root := filepath.Join(filepath.Dir(checkout), "objects")
+	if err := os.MkdirAll(root, 0o700); err != nil {
+		return false, fmt.Errorf("MkdirAll: %w", err)
+	}
+	repository := filepath.Join(root, v1CacheSourceKey(candidate.remote))
+	unlock, err := lockObjectRepository(ctx, repository+".lock")
+	if err != nil {
+		return false, fmt.Errorf("lockObjectRepository: %w", err)
+	}
+	defer unlock()
+	if _, err := os.Stat(filepath.Join(repository, "HEAD")); os.IsNotExist(err) {
+		if _, err := gitV1(ctx, "", "init", "--quiet", "--bare", repository); err != nil {
+			return false, err
+		}
+		if _, err := gitV1(ctx, repository, "config", "gc.auto", "0"); err != nil {
+			return false, err
+		}
+	} else if err != nil {
+		return false, fmt.Errorf("Stat: %w", err)
+	}
+	commit := strings.ToLower(entry.Commit)
+	if _, err := gitV1(ctx, repository, "cat-file", "-e", commit+"^{commit}"); err != nil {
+		// Depth-one fetch works even for a historical commit when the server permits
+		// requesting its object ID. Do not silently replace an unavailable pin by HEAD.
+		_, fetchErr := gitV1(ctx, repository, "-c", "fetch.fsckObjects=true", "fetch", "--quiet", "--no-tags", "--no-write-fetch-head", "--depth=1", "--", candidate.remote, commit)
+		if fetchErr != nil {
+			if ctx.Err() != nil {
+				return false, ctx.Err()
+			}
+			// Some servers only expose advertised refs. Fetch reachable history as a
+			// compatibility fallback, then verify the exact requested commit again.
+			args := []string{"-c", "fetch.fsckObjects=true", "fetch", "--quiet", "--no-tags", "--no-write-fetch-head"}
+			if _, err := os.Stat(filepath.Join(repository, "shallow")); err == nil {
+				args = append(args, "--unshallow")
+			}
+			args = append(args, "--", candidate.remote, "+refs/heads/*:refs/remotes/easyp/*", "+refs/tags/*:refs/tags/*")
+			if _, err := gitV1(ctx, repository, args...); err != nil {
+				return false, fmt.Errorf("fetch pinned commit (shallow: %v; fallback: %w)", fetchErr, err)
+			}
+		}
+	}
+	resolved, err := gitV1(ctx, repository, "rev-parse", "--verify", commit+"^{commit}")
+	if err != nil {
+		return true, fmt.Errorf("locked commit %s is unavailable in the fetched repository history; restore access to the pinned revision rather than replacing it with HEAD: %w", commit, err)
+	}
+	if strings.TrimSpace(resolved) != commit {
+		return true, fmt.Errorf("resolved commit does not match %s", commit)
+	}
+	if _, err := gitV1(ctx, repository, "update-ref", "refs/easyp/"+commit, commit); err != nil {
+		return true, err
+	}
+	if _, err := gitV1(ctx, repository, "update-ref", "refs/heads/easyp-cache", commit); err != nil {
+		return true, err
+	}
+	if _, err := gitV1(ctx, repository, "symbolic-ref", "HEAD", "refs/heads/easyp-cache"); err != nil {
+		return true, err
+	}
+	if _, err := gitV1(ctx, "", "clone", "--quiet", "--shared", "--no-checkout", "--", repository, checkout); err != nil {
+		return true, fmt.Errorf("clone cached objects: %w", err)
+	}
+	if _, err := gitV1(ctx, checkout, "checkout", "--quiet", "--detach", commit); err != nil {
+		return true, err
+	}
+	if _, err := moduleconfig.ReadGitDependencyAt(checkout, entry.Source, candidate.subdir); err != nil {
+		return true, err
+	}
+	return true, nil
+}
+
+// OS locks are released on process exit and shared across concurrent CLI runs.
+func lockObjectRepository(ctx context.Context, path string) (func(), error) {
+	file, err := os.OpenFile(path, os.O_CREATE|os.O_RDWR, 0o600)
+	if err != nil {
+		return nil, err
+	}
+	for {
+		if err := ctx.Err(); err != nil {
+			_ = file.Close()
+			return nil, err
+		}
+		acquired, err := tryObjectLock(file)
+		if err != nil {
+			_ = file.Close()
+			return nil, err
+		}
+		if acquired {
+			return func() { _ = releaseObjectLock(file); _ = file.Close() }, nil
+		}
+		timer := time.NewTimer(50 * time.Millisecond)
+		select {
+		case <-ctx.Done():
+			timer.Stop()
+			_ = file.Close()
+			return nil, ctx.Err()
+		case <-timer.C:
+		}
+	}
+}
diff --git a/internal/adapters/gitmodules/object_cache_test.go b/internal/adapters/gitmodules/object_cache_test.go
new file mode 100644
index 00000000..a7bd9640
--- /dev/null
+++ b/internal/adapters/gitmodules/object_cache_test.go
@@ -0,0 +1,51 @@
+package gitmodules
+
+import (
+	"context"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+	"time"
+
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestPinnedObjectCacheWorksWithoutRemote(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	remote := filepath.Join(root, "remote")
+	require.NoError(t, os.Mkdir(remote, 0o755))
+	require.NoError(t, os.WriteFile(filepath.Join(remote, "protobuf.mod"), []byte("module "+remote+"\n"), 0o644))
+	require.NoError(t, os.WriteFile(filepath.Join(remote, "api.proto"), []byte("syntax = \"proto3\"; package api; message Item {}\n"), 0o644))
+	runTestGit(t, remote, "init", "-q")
+	runTestGit(t, remote, "add", ".")
+	runTestGit(t, remote, "-c", "user.name=Test", "-c", "user.email=test@example.test", "commit", "-qm", "initial")
+	commit := strings.TrimSpace(runTestGit(t, remote, "rev-parse", "HEAD"))
+	cache := New(filepath.Join(root, "cache"))
+	first, err := cache.Fetch(t.Context(), remote, commit)
+	require.NoError(t, err)
+	require.NoError(t, os.Rename(remote, remote+"-offline"))
+	second, err := cache.Fetch(t.Context(), remote, commit)
+	require.NoError(t, err)
+	require.Equal(t, first.Lock, second.Lock)
+	require.NoError(t, cache.Install(t.Context(), v1.Lock{Version: 1, Modules: []v1.LockedModule{first.Lock}}))
+	dir, _, err := cache.Cached(first.Lock)
+	require.NoError(t, err)
+	require.NoError(t, os.WriteFile(filepath.Join(dir, "api.proto"), []byte("tampered"), 0o644))
+	require.ErrorContains(t, cache.Install(t.Context(), v1.Lock{Version: 1, Modules: []v1.LockedModule{first.Lock}}), "hash mismatch")
+}
+
+func TestObjectRepositoryLockHonorsCancellation(t *testing.T) {
+	t.Parallel()
+	path := filepath.Join(t.TempDir(), "lock")
+	unlock, err := lockObjectRepository(t.Context(), path)
+	require.NoError(t, err)
+	defer unlock()
+	ctx, cancel := context.WithTimeout(t.Context(), 30*time.Millisecond)
+	defer cancel()
+	_, err = lockObjectRepository(ctx, path)
+	require.ErrorIs(t, err, context.DeadlineExceeded)
+}
diff --git a/internal/adapters/gitmodules/object_lock_unix.go b/internal/adapters/gitmodules/object_lock_unix.go
new file mode 100644
index 00000000..943159d6
--- /dev/null
+++ b/internal/adapters/gitmodules/object_lock_unix.go
@@ -0,0 +1,19 @@
+//go:build !windows
+
+package gitmodules
+
+import (
+	"errors"
+	"os"
+
+	"golang.org/x/sys/unix"
+)
+
+func tryObjectLock(file *os.File) (bool, error) {
+	err := unix.Flock(int(file.Fd()), unix.LOCK_EX|unix.LOCK_NB)
+	if errors.Is(err, unix.EWOULDBLOCK) || errors.Is(err, unix.EAGAIN) {
+		return false, nil
+	}
+	return err == nil, err
+}
+func releaseObjectLock(file *os.File) error { return unix.Flock(int(file.Fd()), unix.LOCK_UN) }
diff --git a/internal/adapters/gitmodules/object_lock_windows.go b/internal/adapters/gitmodules/object_lock_windows.go
new file mode 100644
index 00000000..efdf5c73
--- /dev/null
+++ b/internal/adapters/gitmodules/object_lock_windows.go
@@ -0,0 +1,19 @@
+package gitmodules
+
+import (
+	"errors"
+	"os"
+
+	"golang.org/x/sys/windows"
+)
+
+func tryObjectLock(file *os.File) (bool, error) {
+	err := windows.LockFileEx(windows.Handle(file.Fd()), windows.LOCKFILE_EXCLUSIVE_LOCK|windows.LOCKFILE_FAIL_IMMEDIATELY, 0, 1, 0, &windows.Overlapped{})
+	if errors.Is(err, windows.ERROR_LOCK_VIOLATION) {
+		return false, nil
+	}
+	return err == nil, err
+}
+func releaseObjectLock(file *os.File) error {
+	return windows.UnlockFileEx(windows.Handle(file.Fd()), 0, 1, 0, &windows.Overlapped{})
+}
diff --git a/internal/adapters/gitmodules/tag.go b/internal/adapters/gitmodules/tag.go
new file mode 100644
index 00000000..bd2bb291
--- /dev/null
+++ b/internal/adapters/gitmodules/tag.go
@@ -0,0 +1,57 @@
+package gitmodules
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// ResolveTag resolves a named Git tag to a commit before get writes a requirement.
+// Semantic version selection continues to use Versions and Fetch.
+func (c *Cache) ResolveTag(ctx context.Context, source, tag string) (string, error) {
+	if _, err := gitV1(ctx, "", "check-ref-format", "refs/tags/"+tag); err != nil {
+		return "", fmt.Errorf("gitV1: %w", err)
+	}
+	candidates, err := v1GitModuleCandidates(source)
+	if err != nil {
+		return "", fmt.Errorf("v1GitModuleCandidates: %w", err)
+	}
+	var firstErr error
+	foundRepository := false
+	for _, candidate := range candidates {
+		if err := ctx.Err(); err != nil {
+			return "", fmt.Errorf("Err: %w", err)
+		}
+		ref := "refs/tags/" + candidate.tag(tag)
+		raw, err := gitV1(ctx, "", "ls-remote", "--tags", "--", candidate.remote, ref, ref+"^{}")
+		if err != nil {
+			if firstErr == nil {
+				firstErr = err
+			}
+			continue
+		}
+		foundRepository = true
+		var commit string
+		for _, line := range strings.Split(raw, "\n") {
+			hash, name, ok := strings.Cut(line, "\t")
+			if !ok || !v1.IsCommitRef(hash) {
+				continue
+			}
+			if name == ref+"^{}" {
+				return hash, nil
+			}
+			if name == ref {
+				commit = hash
+			}
+		}
+		if commit != "" {
+			return commit, nil
+		}
+	}
+	if !foundRepository && firstErr != nil {
+		return "", fmt.Errorf("could not query Git tags for %s@%s; check repository access and credentials: %w", source, tag, firstErr)
+	}
+	return "", fmt.Errorf("git tag %s@%s was not found", source, tag)
+}
diff --git a/internal/adapters/gitmodules/tag_test.go b/internal/adapters/gitmodules/tag_test.go
new file mode 100644
index 00000000..4e49df11
--- /dev/null
+++ b/internal/adapters/gitmodules/tag_test.go
@@ -0,0 +1,92 @@
+package gitmodules
+
+import (
+	"context"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestResolveTag(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name      string
+		tag       string
+		subdir    string
+		annotated bool
+	}{
+		{name: "lightweight_tag", tag: "common-protos-1_3_1"},
+		{name: "annotated_tag", tag: "common-protos-1_3_1", annotated: true},
+		{name: "tag_with_slash", tag: "schemas/stable"},
+		{name: "nested_module_tag", tag: "schemas-release", subdir: "foo"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			remote, commit := diagnosticRepository(t)
+			tag := tt.tag
+			if tt.subdir != "" {
+				tag = tt.subdir + "/" + tag
+			}
+			if tt.annotated {
+				runTestGit(t, remote, "-c", "user.name=Test", "-c", "user.email=test@example.test", "tag", "-am", "release", tag)
+			} else {
+				runTestGit(t, remote, "tag", tag)
+			}
+
+			resolved, err := New(t.TempDir()).ResolveTag(t.Context(), filepath.Join(remote, tt.subdir), tt.tag)
+
+			require.NoError(t, err)
+			assert.Equal(t, commit, resolved)
+		})
+	}
+}
+
+func TestResolveTagErrors(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name    string
+		tag     string
+		offline bool
+		cancel  bool
+		wantErr string
+	}{
+		{name: "missing_tag", tag: "absent", wantErr: "was not found"},
+		{name: "branch_is_not_a_tag", tag: "HEAD", wantErr: "was not found"},
+		{name: "repository_access", tag: "v1.0.0", offline: true, wantErr: "could not query Git tags"},
+		{name: "invalid_tag", tag: "../unsafe", wantErr: "check-ref-format"},
+		{name: "cancelled_context", tag: "v1.0.0", cancel: true},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			remote, _ := diagnosticRepository(t)
+			if tt.offline {
+				require.NoError(t, os.Rename(remote, remote+"-offline"))
+			}
+			ctx, cancel := context.WithCancel(t.Context())
+			defer cancel()
+			if tt.cancel {
+				cancel()
+			}
+
+			commit, err := New(t.TempDir()).ResolveTag(ctx, remote, tt.tag)
+
+			assert.Empty(t, commit)
+			if tt.cancel {
+				require.ErrorIs(t, err, context.Canceled)
+				return
+			}
+			require.ErrorContains(t, err, tt.wantErr)
+			if tt.offline {
+				assert.False(t, strings.Contains(err.Error(), "was not found"))
+			}
+		})
+	}
+}
diff --git a/internal/adapters/go_git/get_dir_walker.go b/internal/adapters/go_git/get_dir_walker.go
index ce65796a..954529d3 100644
--- a/internal/adapters/go_git/get_dir_walker.go
+++ b/internal/adapters/go_git/get_dir_walker.go
@@ -7,7 +7,6 @@ import (
 	"path/filepath"
 
 	gogit "github.com/go-git/go-git/v5"
-	"github.com/go-git/go-git/v5/plumbing"
 
 	"github.com/easyp-tech/easyp/internal/core"
 	"github.com/easyp-tech/easyp/internal/fs/go_git"
@@ -17,7 +16,7 @@ func (g *GoGit) GetDirWalker(workingDir, gitRef, path string) (core.DirWalker, e
 	// Open the repository by searching upward from workingDir, so --root can be
 	// any subdirectory of the git repository (not only the config directory).
 	repository, err := gogit.PlainOpenWithOptions(workingDir, &gogit.PlainOpenOptions{
-		DetectDotGit: true,
+		DetectDotGit: true, EnableDotGitCommonDir: true,
 	})
 	if err != nil {
 		if errors.Is(err, gogit.ErrRepositoryNotExists) {
@@ -46,16 +45,9 @@ func (g *GoGit) GetDirWalker(workingDir, gitRef, path string) (core.DirWalker, e
 	relSlash := filepath.ToSlash(rel)
 	gitPath := pathpkg.Join(relSlash, filepath.ToSlash(path))
 
-	refName := plumbing.ReferenceName(fmt.Sprintf("refs/heads/%s", gitRef))
-
-	refAgainst, err := repository.Reference(refName, false)
-	if err != nil {
-		return nil, &core.GitRefNotFoundError{GitRef: gitRef}
-	}
-
-	commitAgainst, err := repository.CommitObject(refAgainst.Hash())
+	commitAgainst, err := baselineCommit(repository, gitRef)
 	if err != nil {
-		return nil, fmt.Errorf("repository.CommitObject: %w", err)
+		return nil, fmt.Errorf("baselineCommit: %w", err)
 	}
 
 	treeAgainst, err := commitAgainst.Tree()
diff --git a/internal/adapters/go_git/revision.go b/internal/adapters/go_git/revision.go
new file mode 100644
index 00000000..f6a1263b
--- /dev/null
+++ b/internal/adapters/go_git/revision.go
@@ -0,0 +1,34 @@
+package go_git
+
+import (
+	"fmt"
+	"strings"
+
+	gogit "github.com/go-git/go-git/v5"
+	"github.com/go-git/go-git/v5/plumbing"
+	"github.com/go-git/go-git/v5/plumbing/object"
+
+	"github.com/easyp-tech/easyp/internal/core"
+)
+
+// baselineCommit resolves tags and commit revisions as well as branches.
+// Existing bare branch names retain precedence over an identically named tag.
+func baselineCommit(repository *gogit.Repository, ref string) (*object.Commit, error) {
+	if strings.TrimSpace(ref) == "" {
+		return nil, &core.GitRefNotFoundError{GitRef: ref}
+	}
+	revision := ref
+	branch := plumbing.NewBranchReferenceName(ref)
+	if _, err := repository.Reference(branch, true); err == nil {
+		revision = branch.String()
+	}
+	hash, err := repository.ResolveRevision(plumbing.Revision(revision))
+	if err != nil {
+		return nil, fmt.Errorf("ResolveRevision: %w", &core.GitRefNotFoundError{GitRef: ref})
+	}
+	commit, err := repository.CommitObject(*hash)
+	if err != nil {
+		return nil, fmt.Errorf("CommitObject: %w", err)
+	}
+	return commit, nil
+}
diff --git a/internal/adapters/go_git/revision_test.go b/internal/adapters/go_git/revision_test.go
new file mode 100644
index 00000000..fa4684b0
--- /dev/null
+++ b/internal/adapters/go_git/revision_test.go
@@ -0,0 +1,36 @@
+package go_git
+
+import (
+	"os"
+	"os/exec"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestSnapshotSupportsTaggedAndPinnedBaseline(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	require.NoError(t, os.WriteFile(filepath.Join(root, "item.proto"), []byte("old"), 0o644))
+	snapshotGit(t, root, "init", "-q", "-b", "baseline")
+	snapshotGit(t, root, "add", ".")
+	snapshotGit(t, root, "-c", "user.name=Test", "-c", "user.email=test@example.test", "commit", "-qm", "initial")
+	snapshotGit(t, root, "tag", "v1.0.0")
+	snapshotGit(t, root, "-c", "user.name=Test", "-c", "user.email=test@example.test", "tag", "-a", "v1.0.1", "-m", "annotated")
+	cmd := exec.CommandContext(t.Context(), "git", "-C", root, "rev-parse", "HEAD")
+	out, err := cmd.Output()
+	require.NoError(t, err)
+	for _, ref := range []string{"baseline", "v1.0.0", "v1.0.1", strings.TrimSpace(string(out)), "HEAD"} {
+		t.Run(ref, func(t *testing.T) {
+			t.Parallel()
+			snapshot, err := SnapshotRevision(t.Context(), root, ref)
+			require.NoError(t, err)
+			t.Cleanup(func() { require.NoError(t, snapshot.Close()) })
+			raw, err := os.ReadFile(filepath.Join(snapshot.Root, "item.proto"))
+			require.NoError(t, err)
+			require.Equal(t, "old", string(raw))
+		})
+	}
+}
diff --git a/internal/adapters/go_git/snapshot.go b/internal/adapters/go_git/snapshot.go
new file mode 100644
index 00000000..4d553b53
--- /dev/null
+++ b/internal/adapters/go_git/snapshot.go
@@ -0,0 +1,146 @@
+package go_git
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"io"
+	"os"
+	"path"
+	"path/filepath"
+
+	gogit "github.com/go-git/go-git/v5"
+	"github.com/go-git/go-git/v5/plumbing/filemode"
+	"github.com/go-git/go-git/v5/plumbing/object"
+
+	"github.com/easyp-tech/easyp/internal/core"
+)
+
+// Snapshot contains revision-local protobuf sources and dependency metadata.
+// It never checks out or modifies the caller's working tree.
+type Snapshot struct {
+	Root           string
+	RepositoryRoot string
+}
+
+// RepositoryRoot returns the current worktree root without resolving a
+// baseline revision or modifying the checkout.
+func RepositoryRoot(directory string) (string, error) {
+	repository, err := gogit.PlainOpenWithOptions(directory, &gogit.PlainOpenOptions{DetectDotGit: true, EnableDotGitCommonDir: true})
+	if errors.Is(err, gogit.ErrRepositoryNotExists) {
+		return "", core.ErrRepositoryDoesNotExist
+	}
+	if err != nil {
+		return "", fmt.Errorf("PlainOpenWithOptions: %w", err)
+	}
+	worktree, err := repository.Worktree()
+	if err != nil {
+		return "", fmt.Errorf("Worktree: %w", err)
+	}
+	return worktree.Filesystem.Root(), nil
+}
+
+// Close removes the temporary snapshot.
+func (s *Snapshot) Close() error { return os.RemoveAll(s.Root) }
+
+// SnapshotRevision materializes a revision's protobuf inputs, including hidden
+// local replacement directories. Only relevant regular files are materialized.
+func SnapshotRevision(ctx context.Context, directory, ref string) (_ *Snapshot, err error) {
+	repository, err := gogit.PlainOpenWithOptions(directory, &gogit.PlainOpenOptions{DetectDotGit: true, EnableDotGitCommonDir: true})
+	if errors.Is(err, gogit.ErrRepositoryNotExists) {
+		return nil, core.ErrRepositoryDoesNotExist
+	}
+	if err != nil {
+		return nil, fmt.Errorf("PlainOpenWithOptions: %w", err)
+	}
+	wt, err := repository.Worktree()
+	if err != nil {
+		return nil, fmt.Errorf("Worktree: %w", err)
+	}
+	commit, err := baselineCommit(repository, ref)
+	if err != nil {
+		return nil, fmt.Errorf("baselineCommit: %w", err)
+	}
+	tree, err := commit.Tree()
+	if err != nil {
+		return nil, fmt.Errorf("Tree: %w", err)
+	}
+	root, err := os.MkdirTemp("", "easyp-breaking-*")
+	if err != nil {
+		return nil, fmt.Errorf("MkdirTemp: %w", err)
+	}
+	snapshot := &Snapshot{Root: root, RepositoryRoot: wt.Filesystem.Root()}
+	defer func() {
+		if err != nil {
+			_ = snapshot.Close()
+		}
+	}()
+	err = tree.Files().ForEach(func(file *object.File) error {
+		if err := ctx.Err(); err != nil {
+			return err
+		}
+		if !snapshotInput(file.Name) {
+			return nil
+		}
+		relative := filepath.FromSlash(file.Name)
+		if !filepath.IsLocal(relative) {
+			return fmt.Errorf("invalid snapshot path %q", file.Name)
+		}
+		if file.Mode != filemode.Regular && file.Mode != filemode.Executable && file.Mode != filemode.Deprecated {
+			// Additional policy candidates are copied only when regular. An unused
+			// YAML symlink must not break an otherwise unrelated baseline check. If
+			// referenced as a policy, its absence is reported without following it.
+			if snapshotAdditionalPolicy(file.Name) {
+				return nil
+			}
+			return fmt.Errorf("baseline input %q is not a regular file", file.Name)
+		}
+		reader, err := file.Reader()
+		if err != nil {
+			return fmt.Errorf("Reader: %w", err)
+		}
+		raw, readErr := io.ReadAll(reader)
+		closeErr := reader.Close()
+		if readErr != nil {
+			return fmt.Errorf("ReadAll: %w", readErr)
+		}
+		if closeErr != nil {
+			return fmt.Errorf("Close: %w", closeErr)
+		}
+		target := filepath.Join(root, relative)
+		if err := os.MkdirAll(filepath.Dir(target), 0o700); err != nil {
+			return fmt.Errorf("MkdirAll: %w", err)
+		}
+		if err := os.WriteFile(target, raw, 0o600); err != nil {
+			return fmt.Errorf("WriteFile: %w", err)
+		}
+		return nil
+	})
+	if err != nil {
+		return nil, fmt.Errorf("ForEach: %w", err)
+	}
+	return snapshot, nil
+}
+
+func snapshotInput(name string) bool {
+	if extension := path.Ext(name); extension == ".proto" || extension == ".yaml" || extension == ".yml" {
+		return true
+	}
+	switch path.Base(name) {
+	case "protobuf.mod", "protobuf.lock", "easyp.yaml", "buf.yaml", "buf.yml", "buf.work.yaml":
+		return true
+	default:
+		return false
+	}
+}
+
+func snapshotAdditionalPolicy(name string) bool {
+	if path.Ext(name) != ".yaml" && path.Ext(name) != ".yml" {
+		return false
+	}
+	switch path.Base(name) {
+	case "easyp.yaml", "buf.yaml", "buf.yml", "buf.work.yaml":
+		return false
+	}
+	return true
+}
diff --git a/internal/adapters/go_git/snapshot_test.go b/internal/adapters/go_git/snapshot_test.go
new file mode 100644
index 00000000..45f955be
--- /dev/null
+++ b/internal/adapters/go_git/snapshot_test.go
@@ -0,0 +1,48 @@
+package go_git
+
+import (
+	"os"
+	"os/exec"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func snapshotGit(t *testing.T, root string, args ...string) {
+	t.Helper()
+	cmd := exec.CommandContext(t.Context(), "git", args...)
+	cmd.Dir = root
+	out, err := cmd.CombinedOutput()
+	require.NoError(t, err, "%s", out)
+}
+
+func TestSnapshotRevisionUsesCommittedInputs(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	for name, body := range map[string]string{"proto/item.proto": "old proto", "protobuf.mod": "module example.com/root\nroots proto\n", "protobuf.lock": "old lock", ".deps/common.proto": "old dependency", "README.md": "not an input"} {
+		target := filepath.Join(root, name)
+		require.NoError(t, os.MkdirAll(filepath.Dir(target), 0o755))
+		require.NoError(t, os.WriteFile(target, []byte(body), 0o644))
+	}
+	snapshotGit(t, root, "init", "-q", "-b", "baseline")
+	snapshotGit(t, root, "add", ".")
+	snapshotGit(t, root, "-c", "user.name=Test", "-c", "user.email=test@example.test", "commit", "-qm", "baseline")
+	require.NoError(t, os.WriteFile(filepath.Join(root, "proto/item.proto"), []byte("new proto"), 0o644))
+	snapshot, err := SnapshotRevision(t.Context(), root, "baseline")
+	require.NoError(t, err)
+	t.Cleanup(func() { assert.NoError(t, snapshot.Close()) })
+	raw, err := os.ReadFile(filepath.Join(snapshot.Root, "proto/item.proto"))
+	require.NoError(t, err)
+	assert.Equal(t, "old proto", string(raw))
+	raw, err = os.ReadFile(filepath.Join(snapshot.Root, ".deps/common.proto"))
+	require.NoError(t, err)
+	assert.Equal(t, "old dependency", string(raw))
+	assert.NoFileExists(t, filepath.Join(snapshot.Root, "README.md"))
+	raw, err = os.ReadFile(filepath.Join(root, "proto/item.proto"))
+	require.NoError(t, err)
+	assert.Equal(t, "new proto", string(raw))
+	require.NoError(t, snapshot.Close())
+	assert.NoDirExists(t, snapshot.Root)
+}
diff --git a/internal/adapters/lock_file/deps_iter.go b/internal/adapters/lock_file/deps_iter.go
deleted file mode 100644
index 49bb357f..00000000
--- a/internal/adapters/lock_file/deps_iter.go
+++ /dev/null
@@ -1,22 +0,0 @@
-package lockfile
-
-import (
-	"iter"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-func (l *LockFile) DepsIter() iter.Seq[models.LockFileInfo] {
-	return func(yield func(models.LockFileInfo) bool) {
-		for moduleName, fileInfo := range l.cache {
-			lockFileInfo := models.LockFileInfo{
-				Name:    moduleName,
-				Version: fileInfo.version,
-				Hash:    models.ModuleHash(fileInfo.hash),
-			}
-			if !yield(lockFileInfo) {
-				return
-			}
-		}
-	}
-}
diff --git a/internal/adapters/lock_file/is_empty.go b/internal/adapters/lock_file/is_empty.go
deleted file mode 100644
index aa0042fa..00000000
--- a/internal/adapters/lock_file/is_empty.go
+++ /dev/null
@@ -1,6 +0,0 @@
-package lockfile
-
-// IsEmpty check if lock file doesn't have any deps
-func (l *LockFile) IsEmpty() bool {
-	return len(l.cache) == 0
-}
diff --git a/internal/adapters/lock_file/lock_file.go b/internal/adapters/lock_file/lock_file.go
deleted file mode 100644
index ca15d674..00000000
--- a/internal/adapters/lock_file/lock_file.go
+++ /dev/null
@@ -1,57 +0,0 @@
-package lockfile
-
-import (
-	"bufio"
-	"fmt"
-	"strings"
-
-	"github.com/easyp-tech/easyp/internal/core"
-)
-
-const (
-	lockFileName = "easyp.lock"
-)
-
-type fileInfo struct {
-	version string
-	hash    string
-}
-
-type LockFile struct {
-	dirWalker core.DirWalker
-	cache     map[string]fileInfo
-}
-
-func New(dirWalker core.DirWalker) (*LockFile, error) {
-	cache := make(map[string]fileInfo)
-
-	fp, err := dirWalker.Open(lockFileName)
-	if err == nil {
-		defer func() { _ = fp.Close() }()
-
-		fscanner := bufio.NewScanner(fp)
-
-		for fscanner.Scan() {
-			parts := strings.Fields(fscanner.Text())
-			if len(parts) != 3 {
-				continue
-			}
-
-			fileInfo := fileInfo{
-				version: parts[1],
-				hash:    parts[2],
-			}
-			cache[parts[0]] = fileInfo
-		}
-
-		if err := fscanner.Err(); err != nil {
-			return nil, fmt.Errorf("scan %s: %w", lockFileName, err)
-		}
-	}
-
-	lockFile := &LockFile{
-		dirWalker: dirWalker,
-		cache:     cache,
-	}
-	return lockFile, nil
-}
diff --git a/internal/adapters/lock_file/read.go b/internal/adapters/lock_file/read.go
deleted file mode 100644
index de251230..00000000
--- a/internal/adapters/lock_file/read.go
+++ /dev/null
@@ -1,21 +0,0 @@
-package lockfile
-
-import (
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-// Read information about module by its name from lock file
-// github.com/grpc-ecosystem/grpc-gateway v0.0.0-20240502030614-85850831b7bad2b8b60cb09783d8095176f22d98 h1:hRu1vxAH6CVNmz12mpqKue5HVBQP2neoaM/q2DLm0i4=
-func (l *LockFile) Read(moduleName string) (models.LockFileInfo, error) {
-	fileInfo, ok := l.cache[moduleName]
-	if !ok {
-		return models.LockFileInfo{}, models.ErrModuleNotFoundInLockFile
-	}
-
-	lockFileInfo := models.LockFileInfo{
-		Name:    moduleName,
-		Version: fileInfo.version,
-		Hash:    models.ModuleHash(fileInfo.hash),
-	}
-	return lockFileInfo, nil
-}
diff --git a/internal/adapters/lock_file/write.go b/internal/adapters/lock_file/write.go
deleted file mode 100644
index 1dfc8d17..00000000
--- a/internal/adapters/lock_file/write.go
+++ /dev/null
@@ -1,44 +0,0 @@
-package lockfile
-
-import (
-	"fmt"
-	"sort"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-func (l *LockFile) Write(
-	moduleName string, revisionVersion string, installedPackageHash models.ModuleHash,
-) (err error) {
-	fp, err := l.dirWalker.Create(lockFileName)
-	if err != nil {
-		return fmt.Errorf("l.dirWalker.Create: %w", err)
-	}
-	defer func() {
-		if closeErr := fp.Close(); closeErr != nil && err == nil {
-			err = fmt.Errorf("fp.Close: %w", closeErr)
-		}
-	}()
-
-	fileInfo := fileInfo{
-		version: revisionVersion,
-		hash:    string(installedPackageHash),
-	}
-
-	l.cache[moduleName] = fileInfo
-
-	keys := make([]string, 0, len(l.cache))
-	for k := range l.cache {
-		keys = append(keys, k)
-	}
-	sort.Strings(keys)
-
-	for _, k := range keys {
-		r := fmt.Sprintf("%s %s %s\n", k, l.cache[k].version, l.cache[k].hash)
-		if _, err := fp.Write([]byte(r)); err != nil {
-			return fmt.Errorf("fp.Write: %w", err)
-		}
-	}
-
-	return nil
-}
diff --git a/internal/adapters/modfile/modfile.go b/internal/adapters/modfile/modfile.go
new file mode 100644
index 00000000..6ee9a192
--- /dev/null
+++ b/internal/adapters/modfile/modfile.go
@@ -0,0 +1,283 @@
+package modfile
+
+import (
+	"bufio"
+	"bytes"
+	"errors"
+	"fmt"
+	"strings"
+)
+
+const (
+	directiveDirect  = "direct"
+	directiveReplace = "replace"
+	replaceArrow     = "=>"
+)
+
+var (
+	errUnexpectedToken        = errors.New("unexpected token")
+	errUnclosedDirect         = errors.New("unclosed direct block")
+	errUnclosedReplace        = errors.New("unclosed replace block")
+	errDuplicateModule        = errors.New("duplicate module")
+	errDuplicateReplace       = errors.New("duplicate replace")
+	errEmptyDependency        = errors.New("empty dependency")
+	errEmptyReplacePath       = errors.New("empty replace path")
+	errReplaceVersionRequired = errors.New("replace version required")
+	errGarbageOutside         = errors.New("content outside direct block")
+	errMultipleDirect         = errors.New("multiple direct blocks")
+)
+
+// File is the parsed contents of protobuf.mod.
+type File struct {
+	Direct  []string
+	Replace []Replace
+}
+
+// Replace maps a module (name + version) to a local filesystem path.
+type Replace struct {
+	Module Module
+	Path   string
+}
+
+// Module identifies a dependency in a legacy protobuf.mod file.
+type Module struct {
+	Name    string
+	Version string
+}
+
+type replaceKey struct {
+	name    string
+	version string
+}
+
+// Parse parses protobuf.mod contents.
+// An empty file or a file with only comments/blank lines yields an empty File.
+func Parse(data []byte) (File, error) {
+	scanner := bufio.NewScanner(bytes.NewReader(data))
+	var file File
+	seenDirect := make(map[string]struct{})
+	seenReplace := make(map[replaceKey]struct{})
+	inDirect := false
+	inReplace := false
+	sawDirect := false
+	lineNo := 0
+
+	for scanner.Scan() {
+		lineNo++
+		line := strings.TrimSpace(stripComment(scanner.Text()))
+		if line == "" {
+			continue
+		}
+
+		switch {
+		case inDirect:
+			if line == ")" {
+				inDirect = false
+				continue
+			}
+			entry, err := parseDirectEntry(line, lineNo, seenDirect)
+			if err != nil {
+				return File{}, err
+			}
+			file.Direct = append(file.Direct, entry)
+		case inReplace:
+			if line == ")" {
+				inReplace = false
+				continue
+			}
+			rep, err := parseReplaceSpec(line, lineNo, seenReplace)
+			if err != nil {
+				return File{}, err
+			}
+			file.Replace = append(file.Replace, rep)
+		default:
+			opened, err := tryOpenDirect(line, sawDirect, lineNo)
+			if err != nil {
+				return File{}, err
+			}
+			if opened {
+				inDirect = true
+				sawDirect = true
+				continue
+			}
+			if tryOpenBlock(line, directiveReplace) {
+				inReplace = true
+				continue
+			}
+			if isSingleLineReplace(line) {
+				spec := strings.TrimSpace(line[len(directiveReplace):])
+				rep, err := parseReplaceSpec(spec, lineNo, seenReplace)
+				if err != nil {
+					return File{}, err
+				}
+				file.Replace = append(file.Replace, rep)
+				continue
+			}
+			return File{}, fmt.Errorf("%w %q at line %d: %w", errGarbageOutside, line, lineNo, errUnexpectedToken)
+		}
+	}
+
+	err := scanner.Err()
+	if err != nil {
+		return File{}, fmt.Errorf("scan: %w", err)
+	}
+	if inDirect {
+		return File{}, errUnclosedDirect
+	}
+	if inReplace {
+		return File{}, errUnclosedReplace
+	}
+
+	return file, nil
+}
+
+func parseDirectEntry(line string, lineNo int, seen map[string]struct{}) (string, error) {
+	fields := strings.Fields(line)
+	if len(fields) != 1 {
+		return "", fmt.Errorf("%w: want single path[@version], got %q at line %d", errUnexpectedToken, line, lineNo)
+	}
+	entry := fields[0]
+	if entry == "" {
+		return "", fmt.Errorf("%w at line %d", errEmptyDependency, lineNo)
+	}
+
+	name := parseModule(entry).Name
+	if _, ok := seen[name]; ok {
+		return "", fmt.Errorf("%w %q at line %d", errDuplicateModule, name, lineNo)
+	}
+	seen[name] = struct{}{}
+	return entry, nil
+}
+
+func parseReplaceSpec(line string, lineNo int, seen map[replaceKey]struct{}) (Replace, error) {
+	left, right, ok := strings.Cut(line, replaceArrow)
+	if !ok {
+		return Replace{}, fmt.Errorf("%w: want module@version => path, got %q at line %d", errUnexpectedToken, line, lineNo)
+	}
+
+	left = strings.TrimSpace(left)
+	right = strings.TrimSpace(right)
+	if left == "" {
+		return Replace{}, fmt.Errorf("%w at line %d", errEmptyDependency, lineNo)
+	}
+	if right == "" {
+		return Replace{}, fmt.Errorf("%w at line %d", errEmptyReplacePath, lineNo)
+	}
+
+	fields := strings.Fields(left)
+	if len(fields) != 1 {
+		return Replace{}, fmt.Errorf("%w: want single module@version, got %q at line %d", errUnexpectedToken, left, lineNo)
+	}
+
+	module := parseModule(fields[0])
+	if module.Name == "" {
+		return Replace{}, fmt.Errorf("%w at line %d", errEmptyDependency, lineNo)
+	}
+	if module.Version == "" {
+		return Replace{}, fmt.Errorf("%w at line %d", errReplaceVersionRequired, lineNo)
+	}
+
+	key := replaceKey{name: module.Name, version: module.Version}
+	if _, exists := seen[key]; exists {
+		return Replace{}, fmt.Errorf("%w %q at line %d", errDuplicateReplace, fields[0], lineNo)
+	}
+	seen[key] = struct{}{}
+
+	return Replace{Module: module, Path: right}, nil
+}
+
+func tryOpenDirect(line string, sawDirect bool, lineNo int) (bool, error) {
+	if !tryOpenBlock(line, directiveDirect) {
+		return false, nil
+	}
+	if sawDirect {
+		return false, fmt.Errorf("%w at line %d", errMultipleDirect, lineNo)
+	}
+	return true, nil
+}
+
+func tryOpenBlock(line, directive string) bool {
+	if line == directive+" (" || line == directive+"(" {
+		return true
+	}
+	if strings.HasPrefix(line, directive) {
+		rest := strings.TrimSpace(strings.TrimPrefix(line, directive))
+		if rest == "(" {
+			return true
+		}
+	}
+	return false
+}
+
+func isSingleLineReplace(line string) bool {
+	if !strings.HasPrefix(line, directiveReplace) {
+		return false
+	}
+	rest := line[len(directiveReplace):]
+	if rest == "" {
+		return true
+	}
+	return rest[0] == ' ' || rest[0] == '\t'
+}
+
+// Format renders a protobuf.mod file.
+func Format(file File) []byte {
+	var b strings.Builder
+	if len(file.Direct) > 0 || len(file.Replace) == 0 {
+		b.WriteString("direct (\n")
+		for _, dep := range file.Direct {
+			b.WriteString("\t")
+			b.WriteString(dep)
+			b.WriteString("\n")
+		}
+		b.WriteString(")\n")
+	}
+	if len(file.Replace) > 0 {
+		if b.Len() > 0 {
+			b.WriteString("\n")
+		}
+		b.WriteString("replace (\n")
+		for _, rep := range file.Replace {
+			b.WriteString("\t")
+			b.WriteString(formatModule(rep.Module))
+			b.WriteString(" ")
+			b.WriteString(replaceArrow)
+			b.WriteString(" ")
+			b.WriteString(rep.Path)
+			b.WriteString("\n")
+		}
+		b.WriteString(")\n")
+	}
+	return []byte(b.String())
+}
+
+func parseModule(raw string) Module {
+	name, version, _ := strings.Cut(raw, "@")
+	return Module{Name: name, Version: version}
+}
+
+func formatModule(module Module) string {
+	if module.Version == "" {
+		return module.Name
+	}
+	return module.Name + "@" + module.Version
+}
+
+func stripComment(line string) string {
+	hashIdx := strings.Index(line, "#")
+	slashIdx := strings.Index(line, "//")
+
+	cut := -1
+	switch {
+	case hashIdx >= 0 && slashIdx >= 0:
+		cut = min(hashIdx, slashIdx)
+	case hashIdx >= 0:
+		cut = hashIdx
+	case slashIdx >= 0:
+		cut = slashIdx
+	}
+	if cut >= 0 {
+		return line[:cut]
+	}
+	return line
+}
diff --git a/internal/adapters/modfile/modfile_test.go b/internal/adapters/modfile/modfile_test.go
new file mode 100644
index 00000000..21d8ebbe
--- /dev/null
+++ b/internal/adapters/modfile/modfile_test.go
@@ -0,0 +1,307 @@
+package modfile
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestParse(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name    string
+		input   string
+		want    File
+		wantErr error
+	}{
+		{
+			name:  "empty_file",
+			input: "",
+			want:  File{},
+		},
+		{
+			name:  "comments_only",
+			input: "# nothing\n// still nothing\n",
+			want:  File{},
+		},
+		{
+			name: "basic_direct_block",
+			input: `direct (
+	github.com/googleapis/googleapis@common-protos-1_3_1
+	github.com/bufbuild/protoc-gen-validate
+)
+`,
+			want: File{
+				Direct: []string{
+					"github.com/googleapis/googleapis@common-protos-1_3_1",
+					"github.com/bufbuild/protoc-gen-validate",
+				},
+			},
+		},
+		{
+			name: "compact_paren",
+			input: `direct(
+	github.com/foo/bar@v1.0.0
+)
+`,
+			want: File{Direct: []string{"github.com/foo/bar@v1.0.0"}},
+		},
+		{
+			name: "inline_comments",
+			input: `direct (
+	github.com/foo/bar@v1.0.0 # pin
+	github.com/baz/qux // latest
+)
+`,
+			want: File{
+				Direct: []string{
+					"github.com/foo/bar@v1.0.0",
+					"github.com/baz/qux",
+				},
+			},
+		},
+		{
+			name: "empty_direct_block",
+			input: `direct (
+)
+`,
+			want: File{},
+		},
+		{
+			name: "garbage_outside",
+			input: `module example.com/foo
+direct (
+	github.com/foo/bar@v1
+)
+`,
+			wantErr: errGarbageOutside,
+		},
+		{
+			name: "unclosed_block",
+			input: `direct (
+	github.com/foo/bar@v1
+`,
+			wantErr: errUnclosedDirect,
+		},
+		{
+			name: "duplicate_module",
+			input: `direct (
+	github.com/foo/bar@v1
+	github.com/foo/bar@v2
+)
+`,
+			wantErr: errDuplicateModule,
+		},
+		{
+			name: "multiple_fields_on_line",
+			input: `direct (
+	github.com/foo/bar@v1 extra
+)
+`,
+			wantErr: errUnexpectedToken,
+		},
+		{
+			name: "multiple_direct_blocks",
+			input: `direct (
+	github.com/foo/bar@v1
+)
+direct (
+	github.com/baz/qux@v1
+)
+`,
+			wantErr: errMultipleDirect,
+		},
+		{
+			name: "single_line_replace",
+			input: `direct (
+	github.com/acme/weather@v1.2
+)
+replace github.com/acme/weather@v1.2 => /home/project
+`,
+			want: File{
+				Direct: []string{"github.com/acme/weather@v1.2"},
+				Replace: []Replace{
+					{
+						Module: Module{Name: "github.com/acme/weather", Version: "v1.2"},
+						Path:   "/home/project",
+					},
+				},
+			},
+		},
+		{
+			name: "replace_block",
+			input: `direct (
+	github.com/acme/weather@v1.2
+)
+replace (
+	github.com/acme/weather@v1.2 => ../weather
+)
+`,
+			want: File{
+				Direct: []string{"github.com/acme/weather@v1.2"},
+				Replace: []Replace{
+					{
+						Module: Module{Name: "github.com/acme/weather", Version: "v1.2"},
+						Path:   "../weather",
+					},
+				},
+			},
+		},
+		{
+			name: "replace_without_direct",
+			input: `replace github.com/acme/weather@v1.2 => /home/project
+`,
+			want: File{
+				Replace: []Replace{
+					{
+						Module: Module{Name: "github.com/acme/weather", Version: "v1.2"},
+						Path:   "/home/project",
+					},
+				},
+			},
+		},
+		{
+			name: "replace_before_direct",
+			input: `replace github.com/acme/weather@v1.2 => /home/project
+direct (
+	github.com/acme/weather@v1.2
+)
+`,
+			want: File{
+				Direct: []string{"github.com/acme/weather@v1.2"},
+				Replace: []Replace{
+					{
+						Module: Module{Name: "github.com/acme/weather", Version: "v1.2"},
+						Path:   "/home/project",
+					},
+				},
+			},
+		},
+		{
+			name: "replace_inline_comment",
+			input: `replace github.com/acme/weather@v1.2 => /home/project # local checkout
+`,
+			want: File{
+				Replace: []Replace{
+					{
+						Module: Module{Name: "github.com/acme/weather", Version: "v1.2"},
+						Path:   "/home/project",
+					},
+				},
+			},
+		},
+		{
+			name: "replace_compact_arrow",
+			input: `replace github.com/acme/weather@v1.2=>/home/project
+`,
+			want: File{
+				Replace: []Replace{
+					{
+						Module: Module{Name: "github.com/acme/weather", Version: "v1.2"},
+						Path:   "/home/project",
+					},
+				},
+			},
+		},
+		{
+			name: "replace_same_module_different_versions",
+			input: `replace (
+	github.com/acme/weather@v1.2 => /home/weather-v1
+	github.com/acme/weather@v2.0 => /home/weather-v2
+)
+`,
+			want: File{
+				Replace: []Replace{
+					{
+						Module: Module{Name: "github.com/acme/weather", Version: "v1.2"},
+						Path:   "/home/weather-v1",
+					},
+					{
+						Module: Module{Name: "github.com/acme/weather", Version: "v2.0"},
+						Path:   "/home/weather-v2",
+					},
+				},
+			},
+		},
+		{
+			name: "duplicate_replace",
+			input: `replace github.com/acme/weather@v1.2 => /a
+replace github.com/acme/weather@v1.2 => /b
+`,
+			wantErr: errDuplicateReplace,
+		},
+		{
+			name: "replace_version_omitted",
+			input: `replace github.com/acme/weather => /home/project
+`,
+			wantErr: errReplaceVersionRequired,
+		},
+		{
+			name: "replace_empty_path",
+			input: `replace github.com/acme/weather@v1.2 =>
+`,
+			wantErr: errEmptyReplacePath,
+		},
+		{
+			name: "unclosed_replace_block",
+			input: `replace (
+	github.com/acme/weather@v1.2 => /home/project
+`,
+			wantErr: errUnclosedReplace,
+		},
+		{
+			name: "replace_missing_arrow",
+			input: `replace github.com/acme/weather@v1.2 /home/project
+`,
+			wantErr: errUnexpectedToken,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			got, err := Parse([]byte(tt.input))
+			if tt.wantErr != nil {
+				require.ErrorIs(t, err, tt.wantErr)
+				return
+			}
+			require.NoError(t, err)
+			require.Equal(t, tt.want, got)
+		})
+	}
+}
+
+func TestFormat_RoundTrip(t *testing.T) {
+	t.Parallel()
+
+	file := File{
+		Direct: []string{
+			"github.com/googleapis/googleapis@common-protos-1_3_1",
+			"github.com/bufbuild/protoc-gen-validate",
+		},
+	}
+
+	got, err := Parse(Format(file))
+	require.NoError(t, err)
+	require.Equal(t, file, got)
+}
+
+func TestFormat_ReplaceRoundTrip(t *testing.T) {
+	t.Parallel()
+
+	file := File{
+		Direct: []string{"github.com/acme/weather@v1.2"},
+		Replace: []Replace{
+			{
+				Module: Module{Name: "github.com/acme/weather", Version: "v1.2"},
+				Path:   "/home/project",
+			},
+		},
+	}
+
+	got, err := Parse(Format(file))
+	require.NoError(t, err)
+	require.Equal(t, file, got)
+}
diff --git a/internal/adapters/module_config/git_dependency.go b/internal/adapters/module_config/git_dependency.go
new file mode 100644
index 00000000..a28d94d6
--- /dev/null
+++ b/internal/adapters/module_config/git_dependency.go
@@ -0,0 +1,275 @@
+package moduleconfig
+
+import (
+	"bytes"
+	"errors"
+	"fmt"
+	"os"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	"github.com/easyp-tech/easyp/internal/adapters/modfile"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+const dependencyManifestFile = v1.ModuleFile
+
+type gitDependencyMode string
+
+const (
+	gitDependencyManifest     gitDependencyMode = dependencyManifestFile
+	gitDependencyBufWorkspace gitDependencyMode = bufWorkConfigFile
+	gitDependencyBufModule    gitDependencyMode = bufModuleConfigFile
+	gitDependencyLegacyEasyP  gitDependencyMode = legacyEasyPConfigFile
+)
+
+// IsGitDependencyConfigFile reports whether a file can declare dependency roots or requirements.
+func IsGitDependencyConfigFile(name string) bool {
+	return name == dependencyManifestFile || name == bufWorkConfigFile ||
+		name == bufModuleConfigFile || name == bufLockFile || name == legacyEasyPConfigFile
+}
+
+// ReadGitDependency adapts metadata in a checked-out Git repository to
+// the roots and requirements needed by the v1 resolver. Its identity is the
+// source named by the requiring module for pre-v1 repositories.
+func ReadGitDependency(dir, source string) (v1.Module, error) {
+	major, err := v1.ModulePathMajor(source)
+	if err != nil {
+		return v1.Module{}, fmt.Errorf("ModulePathMajor: %w", err)
+	}
+	modes, err := detectGitDependencyModes(dir)
+	if err != nil {
+		return v1.Module{}, fmt.Errorf("detectGitDependencyModes: %w", err)
+	}
+	var rootManifest v1.Module
+	var rootIsV1 bool
+	if slices.Contains(modes, gitDependencyManifest) {
+		rootManifest, rootIsV1, err = readGitDependencyManifest(filepath.Join(dir, dependencyManifestFile), source)
+		if err != nil {
+			return v1.Module{}, fmt.Errorf("readGitDependencyManifest: %w", err)
+		}
+		if rootIsV1 && rootManifest.Name == source {
+			if strings.HasPrefix(major, "/") {
+				return ReadGitDependencyAt(dir, source, "")
+			}
+			return rootManifest, nil
+		}
+	}
+	nested, err := readNestedGitDependencyModule(dir, source)
+	if err != nil {
+		return v1.Module{}, fmt.Errorf("readNestedGitDependencyModule: %w", err)
+	}
+	if nested.found {
+		return nested.module, nil
+	}
+	if nested.hasManifests && len(modes) == 0 {
+		return v1.Module{}, fmt.Errorf("dependency %s is not declared by a nested protobuf.mod in %s", source, dir)
+	}
+	if major != "" {
+		return v1.Module{}, fmt.Errorf("module %s requires a native protobuf.mod declaring its exact identity at an allowed module directory", source)
+	}
+	module := v1.Module{Name: source}
+	var bufRoots, legacyRoots []string
+	var bufFilters []v1.ProtoFileFilter
+	var bsrDependencies []v1.BSRDependency
+	foundBuf := false
+	for _, mode := range modes {
+		path := filepath.Join(dir, string(mode))
+		switch mode {
+		case gitDependencyManifest:
+			if rootIsV1 {
+				return v1.Module{}, fmt.Errorf("%s declares module %s, want %s", path, rootManifest.Name, source)
+			}
+			module.Requires = append(module.Requires, rootManifest.Requires...)
+		case gitDependencyBufWorkspace:
+			metadata, err := readBufDependencyWorkspace(path)
+			if err != nil {
+				return v1.Module{}, fmt.Errorf("readBufDependencyWorkspace: %w", err)
+			}
+			bufRoots = metadata.Roots
+			bufFilters = metadata.ProtoFilters
+			bsrDependencies = metadata.BSRDependencies
+			foundBuf = true
+		case gitDependencyBufModule:
+			if foundBuf {
+				continue
+			}
+			metadata, err := readBufDependencyModule(path)
+			if err != nil {
+				return v1.Module{}, fmt.Errorf("readBufDependencyModule: %w", err)
+			}
+			bufRoots = metadata.Roots
+			bufFilters = metadata.ProtoFilters
+			bsrDependencies = metadata.BSRDependencies
+			foundBuf = true
+		case gitDependencyLegacyEasyP:
+			roots, requires, err := readLegacyEasyPRootsAndRequires(path)
+			if err != nil {
+				return v1.Module{}, fmt.Errorf("readLegacyEasyPRootsAndRequires: %w", err)
+			}
+			legacyRoots = roots
+			module.Requires = append(module.Requires, requires...)
+		default:
+			return v1.Module{}, fmt.Errorf("unsupported dependency config mode %q", mode)
+		}
+	}
+	if foundBuf {
+		module.Roots = bufRoots
+		module.BSRDependencies = bsrDependencies
+		if slices.ContainsFunc(bufFilters, func(filter v1.ProtoFileFilter) bool {
+			return len(filter.Includes) > 0 || len(filter.Excludes) > 0
+		}) {
+			module.ProtoFilters = bufFilters
+		}
+	} else {
+		module.Roots = legacyRoots
+	}
+	if len(module.Roots) == 0 {
+		module.Roots = []string{"."}
+	}
+	for _, root := range module.Roots {
+		if !filepath.IsLocal(root) && root != "." {
+			return v1.Module{}, fmt.Errorf("dependency %s root %q leaves the repository", source, root)
+		}
+	}
+	return module, nil
+}
+
+// detectGitDependencyModes only looks for root-level config files. Parsing and
+// format-specific precedence belong to ReadGitDependency.
+func detectGitDependencyModes(dir string) ([]gitDependencyMode, error) {
+	var modes []gitDependencyMode
+	for _, mode := range []gitDependencyMode{
+		gitDependencyManifest,
+		gitDependencyBufWorkspace,
+		gitDependencyBufModule,
+		gitDependencyLegacyEasyP,
+	} {
+		_, err := os.Lstat(filepath.Join(dir, string(mode)))
+		if errors.Is(err, os.ErrNotExist) {
+			continue
+		}
+		if err != nil {
+			return nil, fmt.Errorf("Lstat: %w", err)
+		}
+		modes = append(modes, mode)
+	}
+	return modes, nil
+}
+
+func readGitDependencyManifest(path, source string) (v1.Module, bool, error) {
+	module := v1.Module{Name: source}
+	manifest, err := readGitDependencyConfig(path)
+	if err != nil {
+		return v1.Module{}, false, fmt.Errorf("readGitDependencyConfig: %w", err)
+	}
+	if v1.IsModuleManifest(manifest) {
+		if name := nativeDependencyName(manifest); name != "" && name != source {
+			return v1.Module{Name: name}, true, nil
+		}
+		parsed, err := v1.ParseModule(bytes.NewReader(manifest))
+		if err != nil {
+			return v1.Module{}, false, fmt.Errorf("ParseModule: %w", err)
+		}
+		return parsed, true, nil
+	}
+	legacy, err := modfile.Parse(manifest)
+	if err != nil {
+		return v1.Module{}, false, fmt.Errorf("Parse: %s: %w", path, err)
+	}
+	for _, raw := range legacy.Direct {
+		requirement, err := parseLegacyV1Requirement(raw)
+		if err != nil {
+			return v1.Module{}, false, fmt.Errorf("parseLegacyV1Requirement: %w", err)
+		}
+		module.Requires = append(module.Requires, requirement)
+	}
+	return module, false, nil
+}
+
+// ReadGitDependencyAt verifies the candidate module directory before adapting repository-relative roots.
+func ReadGitDependencyAt(checkout, source, subdir string) (v1.Module, error) {
+	major, err := v1.ModulePathMajor(source)
+	if err != nil {
+		return v1.Module{}, fmt.Errorf("ModulePathMajor: %w", err)
+	}
+	locations := []string{subdir}
+	if strings.HasPrefix(major, "/") {
+		locations = append(locations, filepath.Join(subdir, strings.TrimPrefix(major, "/")))
+	}
+	var selected *v1.Module
+	var identityErr error
+	for _, location := range locations {
+		manifestPath := filepath.Join(checkout, location, v1.ModuleFile)
+		raw, err := readGitDependencyConfig(manifestPath)
+		if errors.Is(err, os.ErrNotExist) {
+			continue
+		}
+		if err != nil {
+			return v1.Module{}, fmt.Errorf("readGitDependencyConfig: %w", err)
+		}
+		if !v1.IsModuleManifest(raw) {
+			continue
+		}
+		if name := nativeDependencyName(raw); name != "" && name != source {
+			identityErr = fmt.Errorf("%s declares module %s, want %s", manifestPath, name, source)
+			continue
+		}
+		parsed, err := v1.ParseModule(bytes.NewReader(raw))
+		if err != nil {
+			return v1.Module{}, fmt.Errorf("ParseModule: %s: %w", manifestPath, err)
+		}
+		if parsed.Name != source {
+			identityErr = fmt.Errorf("%s declares module %s, want %s", manifestPath, parsed.Name, source)
+			continue
+		}
+		if selected != nil {
+			return v1.Module{}, fmt.Errorf("module %s is declared more than once in %s", source, checkout)
+		}
+		for i, root := range parsed.Roots {
+			parsed.Roots[i] = filepath.Join(location, root)
+		}
+		selected = &parsed
+	}
+	if selected != nil {
+		return *selected, nil
+	}
+	if identityErr != nil {
+		return v1.Module{}, identityErr
+	}
+	// Pre-native metadata is supported only at an unsuffixed repository root.
+	if subdir == "" && major == "" {
+		return ReadGitDependency(checkout, source)
+	}
+	return v1.Module{}, fmt.Errorf("module %s requires a protobuf.mod declaring its exact identity in %v", source, locations)
+}
+
+// A symlink would be omitted from the installed snapshot, so reading it here
+// could give a downloaded module different roots or requirements from its cache.
+func readGitDependencyConfig(path string) ([]byte, error) {
+	info, err := os.Lstat(path)
+	if err != nil {
+		return nil, fmt.Errorf("Lstat: %w", err)
+	}
+	if !info.Mode().IsRegular() {
+		return nil, fmt.Errorf("non-regular dependency config %q", path)
+	}
+	raw, err := os.ReadFile(path)
+	if err != nil {
+		return nil, fmt.Errorf("ReadFile: %w", err)
+	}
+	return raw, nil
+}
+
+// nativeDependencyName only selects metadata. The chosen manifest must still
+// pass ParseModule; unrelated modules have independent requirements and policy.
+func nativeDependencyName(raw []byte) string {
+	for _, line := range strings.Split(strings.TrimPrefix(string(raw), "\ufeff"), "\n") {
+		fields := strings.Fields(line)
+		if len(fields) >= 2 && fields[0] == "module" {
+			return fields[1]
+		}
+	}
+	return ""
+}
diff --git a/internal/adapters/module_config/git_dependency_buf.go b/internal/adapters/module_config/git_dependency_buf.go
new file mode 100644
index 00000000..04d85b70
--- /dev/null
+++ b/internal/adapters/module_config/git_dependency_buf.go
@@ -0,0 +1,204 @@
+package moduleconfig
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+const (
+	bufWorkConfigFile   = "buf.work.yaml"
+	bufModuleConfigFile = "buf.yaml"
+)
+
+type bufDependencyWorkspaceConfig struct {
+	Version     string   `yaml:"version"`
+	Directories []string `yaml:"directories"`
+}
+
+type bufDependencyModule struct {
+	Path     string   `yaml:"path"`
+	Includes []string `yaml:"includes"`
+	Excludes []string `yaml:"excludes"`
+}
+
+type bufDependencyBuild struct {
+	Roots    []string `yaml:"roots"`
+	Excludes []string `yaml:"excludes"`
+}
+
+type bufDependencyConfig struct {
+	Version string                `yaml:"version"`
+	Modules []bufDependencyModule `yaml:"modules"`
+	Build   bufDependencyBuild    `yaml:"build"`
+	Deps    []string              `yaml:"deps"`
+}
+
+type bufDependencyMetadata struct {
+	Roots           []string
+	ProtoFilters    []v1.ProtoFileFilter
+	BSRDependencies []v1.BSRDependency
+}
+
+func readBufDependencyWorkspace(path string) (bufDependencyMetadata, error) {
+	raw, err := readGitDependencyConfig(path)
+	if err != nil {
+		return bufDependencyMetadata{}, fmt.Errorf("readGitDependencyConfig: %w", err)
+	}
+	var workspace bufDependencyWorkspaceConfig
+	err = yaml.Unmarshal(raw, &workspace)
+	if err != nil {
+		return bufDependencyMetadata{}, fmt.Errorf("Unmarshal: %s: %w", path, err)
+	}
+	if workspace.Version != "v1" || len(workspace.Directories) == 0 {
+		return bufDependencyMetadata{}, fmt.Errorf("%s: expected v1 with nonempty directories", path)
+	}
+	var metadata bufDependencyMetadata
+	base := filepath.Dir(path)
+	for _, directory := range workspace.Directories {
+		if !filepath.IsLocal(directory) && directory != "." {
+			return bufDependencyMetadata{}, fmt.Errorf("%s: directory %q leaves the repository", path, directory)
+		}
+		modulePath := filepath.Join(base, directory, bufModuleConfigFile)
+		_, err := os.Lstat(modulePath)
+		if os.IsNotExist(err) {
+			metadata.Roots = append(metadata.Roots, filepath.Clean(directory))
+			metadata.ProtoFilters = append(metadata.ProtoFilters, v1.ProtoFileFilter{Root: filepath.Clean(directory)})
+			continue
+		}
+		if err != nil {
+			return bufDependencyMetadata{}, fmt.Errorf("Lstat: %s: %w", modulePath, err)
+		}
+		module, err := readBufDependencyModule(modulePath)
+		if err != nil {
+			return bufDependencyMetadata{}, fmt.Errorf("readBufDependencyModule: %w", err)
+		}
+		for _, root := range module.Roots {
+			metadata.Roots = append(metadata.Roots, filepath.Join(directory, root))
+		}
+		for _, filter := range module.ProtoFilters {
+			filter.Root = filepath.Join(directory, filter.Root)
+			for i, include := range filter.Includes {
+				filter.Includes[i] = filepath.Join(directory, include)
+			}
+			for i, exclude := range filter.Excludes {
+				filter.Excludes[i] = filepath.Join(directory, exclude)
+			}
+			metadata.ProtoFilters = append(metadata.ProtoFilters, filter)
+		}
+		for _, dependency := range module.BSRDependencies {
+			dependency.Config = filepath.ToSlash(filepath.Join(directory, dependency.Config))
+			if !slices.Contains(metadata.BSRDependencies, dependency) {
+				metadata.BSRDependencies = append(metadata.BSRDependencies, dependency)
+			}
+		}
+	}
+	return metadata, nil
+}
+
+func readBufDependencyModule(path string) (bufDependencyMetadata, error) {
+	raw, err := readGitDependencyConfig(path)
+	if err != nil {
+		return bufDependencyMetadata{}, fmt.Errorf("readGitDependencyConfig: %w", err)
+	}
+	var buf bufDependencyConfig
+	err = yaml.Unmarshal(raw, &buf)
+	if err != nil {
+		return bufDependencyMetadata{}, fmt.Errorf("Unmarshal: %s: %w", path, err)
+	}
+	var metadata bufDependencyMetadata
+	switch buf.Version {
+	case "v2":
+		if len(buf.Modules) == 0 {
+			return bufDependencyMetadata{}, fmt.Errorf("%s v2: missing modules", path)
+		}
+		metadata.Roots = make([]string, 0, len(buf.Modules))
+		for _, item := range buf.Modules {
+			if item.Path == "" {
+				return bufDependencyMetadata{}, fmt.Errorf("%s v2: module path is empty", path)
+			}
+			root := filepath.Clean(item.Path)
+			if !slices.Contains(metadata.Roots, root) {
+				metadata.Roots = append(metadata.Roots, root)
+			}
+			metadata.ProtoFilters = append(metadata.ProtoFilters, v1.ProtoFileFilter{
+				Root: root, Includes: item.Includes, Excludes: item.Excludes,
+			})
+		}
+	case "v1":
+		metadata.Roots = []string{"."}
+		metadata.ProtoFilters = []v1.ProtoFileFilter{{Root: ".", Excludes: buf.Build.Excludes}}
+	case "v1beta1":
+		if len(buf.Build.Roots) > 0 {
+			metadata.Roots = append([]string(nil), buf.Build.Roots...)
+		} else {
+			metadata.Roots = []string{"."}
+		}
+		for i, root := range metadata.Roots {
+			if !filepath.IsLocal(root) {
+				return bufDependencyMetadata{}, fmt.Errorf("%s: root %q leaves the repository", path, root)
+			}
+			metadata.Roots[i] = filepath.Clean(root)
+			var excludes []string
+			for _, exclude := range buf.Build.Excludes {
+				if bufPathWithin(exclude, root) {
+					excludes = append(excludes, exclude)
+				}
+			}
+			metadata.ProtoFilters = append(metadata.ProtoFilters, v1.ProtoFileFilter{Root: filepath.Clean(root), Excludes: excludes})
+		}
+		for _, exclude := range buf.Build.Excludes {
+			if !slices.ContainsFunc(metadata.Roots, func(root string) bool { return bufPathWithin(exclude, root) }) {
+				return bufDependencyMetadata{}, fmt.Errorf("%s: exclude %q is outside build.roots", path, exclude)
+			}
+		}
+	default:
+		return bufDependencyMetadata{}, fmt.Errorf("%s: unsupported version %q", path, buf.Version)
+	}
+	for i := range metadata.ProtoFilters {
+		if err := validateBufProtoFilter(&metadata.ProtoFilters[i]); err != nil {
+			return bufDependencyMetadata{}, fmt.Errorf("validateBufProtoFilter: %s: %w", path, err)
+		}
+	}
+	metadata.BSRDependencies, err = readBufBSRDependencies(path, buf.Deps)
+	if err != nil {
+		return bufDependencyMetadata{}, fmt.Errorf("readBufBSRDependencies: %w", err)
+	}
+	return metadata, nil
+}
+
+func validateBufProtoFilter(filter *v1.ProtoFileFilter) error {
+	if !filepath.IsLocal(filter.Root) {
+		return fmt.Errorf("root %q leaves the repository", filter.Root)
+	}
+	for i, include := range filter.Includes {
+		if !bufPathWithin(include, filter.Root) {
+			return fmt.Errorf("include %q is outside module root %q", include, filter.Root)
+		}
+		filter.Includes[i] = filepath.Clean(include)
+	}
+	for i, exclude := range filter.Excludes {
+		if !bufPathWithin(exclude, filter.Root) {
+			return fmt.Errorf("exclude %q is outside module root %q", exclude, filter.Root)
+		}
+		if len(filter.Includes) > 0 && !slices.ContainsFunc(filter.Includes, func(include string) bool { return bufPathWithin(exclude, include) }) {
+			return fmt.Errorf("exclude %q is outside module includes", exclude)
+		}
+		filter.Excludes[i] = filepath.Clean(exclude)
+	}
+	return nil
+}
+
+func bufPathWithin(path, directory string) bool {
+	if !filepath.IsLocal(path) {
+		return false
+	}
+	path, directory = filepath.Clean(path), filepath.Clean(directory)
+	return directory == "." || path == directory || strings.HasPrefix(path, directory+string(filepath.Separator))
+}
diff --git a/internal/adapters/module_config/git_dependency_buf_lock.go b/internal/adapters/module_config/git_dependency_buf_lock.go
new file mode 100644
index 00000000..9fb54f38
--- /dev/null
+++ b/internal/adapters/module_config/git_dependency_buf_lock.go
@@ -0,0 +1,134 @@
+package moduleconfig
+
+import (
+	"bytes"
+	"errors"
+	"fmt"
+	"io"
+	"os"
+	"path/filepath"
+	"strings"
+
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+const bufLockFile = "buf.lock"
+
+type bufDependencyLock struct {
+	Version string                `yaml:"version"`
+	Deps    []bufLockedDependency `yaml:"deps"`
+}
+
+type bufLockedDependency struct {
+	Name       string `yaml:"name"`
+	Remote     string `yaml:"remote"`
+	Owner      string `yaml:"owner"`
+	Repository string `yaml:"repository"`
+	Commit     string `yaml:"commit"`
+	Digest     string `yaml:"digest"`
+}
+
+func readBufBSRDependencies(configPath string, declarations []string) ([]v1.BSRDependency, error) {
+	var dependencies []v1.BSRDependency
+	declared := make(map[string]string, len(declarations))
+	for _, raw := range declarations {
+		raw = strings.TrimSpace(raw)
+		if raw == "" {
+			return nil, fmt.Errorf("%s: deps entry is empty", configPath)
+		}
+		module, reference, hasReference := strings.Cut(raw, ":")
+		if hasReference && reference == "" {
+			return nil, fmt.Errorf("%s: empty BSR reference for %s", configPath, module)
+		}
+		dependency := v1.BSRDependency{Module: module, Reference: reference, Config: bufModuleConfigFile}
+		if err := dependency.Validate(); err != nil {
+			return nil, fmt.Errorf("Validate: %s: %w", configPath, err)
+		}
+		if previous, ok := declared[module]; ok {
+			if previous != reference {
+				return nil, fmt.Errorf("%s: conflicting BSR references for %s: %q and %q", configPath, module, previous, reference)
+			}
+			continue
+		}
+		declared[module] = reference
+		dependencies = append(dependencies, dependency)
+	}
+	lockPath := filepath.Join(filepath.Dir(configPath), bufLockFile)
+	raw, err := readGitDependencyConfig(lockPath)
+	if errors.Is(err, os.ErrNotExist) {
+		return dependencies, nil
+	}
+	if err != nil {
+		return nil, fmt.Errorf("readGitDependencyConfig: %w", err)
+	}
+	pins, err := parseBufDependencyLock(raw)
+	if err != nil {
+		return nil, fmt.Errorf("parseBufDependencyLock: %s: %w", lockPath, err)
+	}
+	if len(declarations) == 0 && len(pins) > 0 {
+		return nil, fmt.Errorf("%s has dependencies but %s declares none", lockPath, configPath)
+	}
+	byModule := make(map[string]v1.BSRDependency, len(pins))
+	for _, pin := range pins {
+		byModule[pin.Module] = pin
+	}
+	for i, dependency := range dependencies {
+		pin, ok := byModule[dependency.Module]
+		if !ok {
+			return nil, fmt.Errorf("%s: BSR dependency %s is missing from buf.lock", configPath, dependency.Module)
+		}
+		dependency.Commit, dependency.Digest = pin.Commit, pin.Digest
+		if err := dependency.Validate(); err != nil {
+			return nil, fmt.Errorf("Validate: %s: %w", configPath, err)
+		}
+		dependencies[i] = dependency
+	}
+	// buf.lock also contains transitive modules that have no declaration in buf.yaml.
+	for _, pin := range pins {
+		if _, ok := declared[pin.Module]; !ok {
+			dependencies = append(dependencies, pin)
+		}
+	}
+	return dependencies, nil
+}
+
+func parseBufDependencyLock(raw []byte) ([]v1.BSRDependency, error) {
+	var lock bufDependencyLock
+	decoder := yaml.NewDecoder(bytes.NewReader(raw))
+	if err := decoder.Decode(&lock); err != nil {
+		return nil, fmt.Errorf("Decode: %w", err)
+	}
+	var extra any
+	if err := decoder.Decode(&extra); err != io.EOF {
+		if err != nil {
+			return nil, fmt.Errorf("Decode: %w", err)
+		}
+		return nil, fmt.Errorf("buf.lock must contain one YAML document")
+	}
+	if lock.Version != "v1" && lock.Version != "v1beta1" && lock.Version != "v2" {
+		return nil, fmt.Errorf("unsupported buf.lock version %q", lock.Version)
+	}
+	var pins []v1.BSRDependency
+	seen := make(map[string]bool, len(lock.Deps))
+	for _, entry := range lock.Deps {
+		module := entry.Name
+		if lock.Version != "v2" {
+			module = entry.Remote + "/" + entry.Owner + "/" + entry.Repository
+		}
+		if entry.Commit == "" {
+			return nil, fmt.Errorf("missing BSR commit for %s", module)
+		}
+		pin := v1.BSRDependency{Module: module, Commit: entry.Commit, Digest: entry.Digest, Config: bufModuleConfigFile}
+		if err := pin.Validate(); err != nil {
+			return nil, fmt.Errorf("Validate: %w", err)
+		}
+		if seen[module] {
+			return nil, fmt.Errorf("duplicate BSR pin for %s", module)
+		}
+		seen[module] = true
+		pins = append(pins, pin)
+	}
+	return pins, nil
+}
diff --git a/internal/adapters/module_config/git_dependency_buf_lock_test.go b/internal/adapters/module_config/git_dependency_buf_lock_test.go
new file mode 100644
index 00000000..20bc1924
--- /dev/null
+++ b/internal/adapters/module_config/git_dependency_buf_lock_test.go
@@ -0,0 +1,158 @@
+package moduleconfig
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestReadGitDependencyBSRMetadata(t *testing.T) {
+	t.Parallel()
+	commit := strings.Repeat("a", 32)
+	digest := "shake256:" + strings.Repeat("a", 128)
+	tests := []struct {
+		name  string
+		files map[string]string
+		want  []v1.BSRDependency
+	}{
+		{
+			name:  "v1 without lock",
+			files: map[string]string{"buf.yaml": "version: v1\ndeps: [buf.build/googleapis/googleapis:stable]\n"},
+			want:  []v1.BSRDependency{{Module: "buf.build/googleapis/googleapis", Reference: "stable", Config: "buf.yaml"}},
+		},
+		{
+			name:  "duplicate declaration",
+			files: map[string]string{"buf.yaml": "version: v1\ndeps: [buf.build/googleapis/googleapis, buf.build/googleapis/googleapis]\n"},
+			want:  []v1.BSRDependency{{Module: "buf.build/googleapis/googleapis", Config: "buf.yaml"}},
+		},
+		{
+			name: "v1beta1 with lock",
+			files: map[string]string{
+				"buf.yaml": "version: v1beta1\nbuild: {roots: [proto]}\ndeps: [buf.build/googleapis/googleapis:stable]\n",
+				"buf.lock": "version: v1beta1\ndeps:\n  - remote: buf.build\n    owner: googleapis\n    repository: googleapis\n    commit: " + commit + "\n    digest: " + digest + "\n",
+			},
+			want: []v1.BSRDependency{{Module: "buf.build/googleapis/googleapis", Reference: "stable", Commit: commit, Digest: digest, Config: "buf.yaml"}},
+		},
+		{
+			name: "v2 locked transitive dependencies",
+			files: map[string]string{
+				"buf.yaml": "version: v2\nmodules: [{path: proto}]\ndeps: [buf.build/googleapis/googleapis]\n",
+				"buf.lock": "version: v2\ndeps:\n  - name: buf.build/googleapis/googleapis\n    commit: " + commit + "\n  - name: buf.build/bufbuild/protovalidate\n    commit: " + strings.Repeat("b", 32) + "\n",
+			},
+			want: []v1.BSRDependency{
+				{Module: "buf.build/googleapis/googleapis", Commit: commit, Config: "buf.yaml"},
+				{Module: "buf.build/bufbuild/protovalidate", Commit: strings.Repeat("b", 32), Config: "buf.yaml"},
+			},
+		},
+		{
+			name: "workspace preserves both origins",
+			files: map[string]string{
+				"buf.work.yaml":    "version: v1\ndirectories: [proto/a, proto/b]\n",
+				"proto/a/buf.yaml": "version: v1\ndeps: [buf.build/googleapis/googleapis]\n",
+				"proto/a/buf.lock": "version: v1\ndeps: [{remote: buf.build, owner: googleapis, repository: googleapis, commit: " + commit + "}]\n",
+				"proto/b/buf.yaml": "version: v1\ndeps: [buf.build/googleapis/googleapis:stable]\n",
+			},
+			want: []v1.BSRDependency{
+				{Module: "buf.build/googleapis/googleapis", Commit: commit, Config: "proto/a/buf.yaml"},
+				{Module: "buf.build/googleapis/googleapis", Reference: "stable", Config: "proto/b/buf.yaml"},
+			},
+		},
+		{
+			name:  "native manifest takes precedence",
+			files: map[string]string{"protobuf.mod": "module github.com/acme/parent\n", "buf.yaml": "version: v1\ndeps: [invalid]\n", "buf.lock": "broken YAML: ["},
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			for name, contents := range tt.files {
+				path := filepath.Join(root, name)
+				require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+				require.NoError(t, os.WriteFile(path, []byte(contents), 0o600))
+			}
+
+			module, err := ReadGitDependency(root, "github.com/acme/parent")
+
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, module.BSRDependencies)
+			assert.Empty(t, module.Requires)
+		})
+	}
+}
+
+func TestReadBufDependencyRejectsInvalidBSRMetadata(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name    string
+		deps    string
+		lock    string
+		wantErr string
+	}{
+		{name: "invalid identity", deps: "[github.com/googleapis]", wantErr: "invalid BSR module"},
+		{name: "empty reference", deps: "[buf.build/googleapis/googleapis:]", wantErr: "empty BSR reference"},
+		{name: "conflicting declarations", deps: "[buf.build/googleapis/googleapis:stable, buf.build/googleapis/googleapis:next]", wantErr: "conflicting BSR references"},
+		{name: "malformed lock", deps: "[buf.build/googleapis/googleapis]", lock: "version: [", wantErr: "Decode"},
+		{name: "unsupported lock format", deps: "[buf.build/googleapis/googleapis]", lock: "version: v3\n", wantErr: "unsupported buf.lock version"},
+		{name: "missing pin", deps: "[buf.build/googleapis/googleapis]", lock: "version: v2\ndeps: []\n", wantErr: "missing from buf.lock"},
+		{name: "lock without declarations", deps: "[]", lock: "version: v2\ndeps: [{name: buf.build/googleapis/googleapis, commit: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa}]\n", wantErr: "declares none"},
+		{name: "empty commit", deps: "[buf.build/googleapis/googleapis]", lock: "version: v2\ndeps: [{name: buf.build/googleapis/googleapis}]\n", wantErr: "missing BSR commit"},
+		{name: "duplicate lock entries", deps: "[buf.build/googleapis/googleapis]", lock: "version: v2\ndeps: [{name: buf.build/googleapis/googleapis, commit: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa}, {name: buf.build/googleapis/googleapis, commit: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa}]\n", wantErr: "duplicate BSR pin"},
+		{name: "multiple lock documents", deps: "[buf.build/googleapis/googleapis]", lock: "version: v2\ndeps: []\n---\nversion: v2\n", wantErr: "one YAML document"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			path := filepath.Join(root, "buf.yaml")
+			require.NoError(t, os.WriteFile(path, []byte("version: v1\ndeps: "+tt.deps+"\n"), 0o600))
+			if tt.lock != "" {
+				require.NoError(t, os.WriteFile(filepath.Join(root, "buf.lock"), []byte(tt.lock), 0o600))
+			}
+
+			_, err := readBufDependencyModule(path)
+
+			require.ErrorContains(t, err, tt.wantErr)
+		})
+	}
+}
+
+func TestReadBufDependencyRejectsNonRegularLock(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name string
+		link bool
+	}{
+		{name: "symlink", link: true},
+		{name: "directory"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			config := filepath.Join(root, "buf.yaml")
+			require.NoError(t, os.WriteFile(config, []byte("version: v1\n"), 0o600))
+			lockPath := filepath.Join(root, "buf.lock")
+			if tt.link {
+				require.NoError(t, os.WriteFile(filepath.Join(root, "pin.yaml"), []byte("version: v1\ndeps: []\n"), 0o600))
+				require.NoError(t, os.Symlink("pin.yaml", lockPath))
+			} else {
+				require.NoError(t, os.Mkdir(lockPath, 0o755))
+			}
+
+			_, err := readBufDependencyModule(config)
+
+			require.ErrorContains(t, err, "non-regular dependency config")
+			assert.Contains(t, err.Error(), "buf.lock")
+		})
+	}
+}
diff --git a/internal/adapters/module_config/git_dependency_buf_test.go b/internal/adapters/module_config/git_dependency_buf_test.go
new file mode 100644
index 00000000..aef2feaa
--- /dev/null
+++ b/internal/adapters/module_config/git_dependency_buf_test.go
@@ -0,0 +1,40 @@
+package moduleconfig
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestReadBufDependencyModuleRejectsInvalidPaths(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name    string
+		config  string
+		wantErr string
+	}{
+		{name: "root_outside_checkout", config: "version: v2\nmodules:\n  - path: ../outside\n", wantErr: "leaves the repository"},
+		{name: "include_outside_root", config: "version: v2\nmodules:\n  - path: proto\n    includes: [other]\n", wantErr: "outside module root"},
+		{name: "include_with_matching_prefix", config: "version: v2\nmodules:\n  - path: proto\n    includes: [proto2]\n", wantErr: "outside module root"},
+		{name: "exclude_outside_root", config: "version: v2\nmodules:\n  - path: proto\n    excludes: [../outside]\n", wantErr: "outside module root"},
+		{name: "exclude_outside_includes", config: "version: v2\nmodules:\n  - path: proto\n    includes: [proto/api]\n    excludes: [proto/test]\n", wantErr: "outside module includes"},
+		{name: "empty_include", config: "version: v2\nmodules:\n  - path: proto\n    includes: ['']\n", wantErr: "outside module root"},
+		{name: "v1_exclude_outside_checkout", config: "version: v1\nbuild:\n  excludes: [../outside]\n", wantErr: "outside module root"},
+		{name: "v1beta1_exclude_outside_roots", config: "version: v1beta1\nbuild:\n  roots: [proto]\n  excludes: [other]\n", wantErr: "outside build.roots"},
+		{name: "empty_registry_reference", config: "version: v1\ndeps: ['']\n", wantErr: "deps entry is empty"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			path := filepath.Join(t.TempDir(), bufModuleConfigFile)
+			require.NoError(t, os.WriteFile(path, []byte(tt.config), 0o644))
+
+			_, err := readBufDependencyModule(path)
+
+			require.ErrorContains(t, err, tt.wantErr)
+		})
+	}
+}
diff --git a/internal/adapters/module_config/git_dependency_legacy.go b/internal/adapters/module_config/git_dependency_legacy.go
new file mode 100644
index 00000000..c4554bdc
--- /dev/null
+++ b/internal/adapters/module_config/git_dependency_legacy.go
@@ -0,0 +1,114 @@
+package moduleconfig
+
+import (
+	"fmt"
+	"strings"
+
+	"golang.org/x/mod/semver"
+	"gopkg.in/yaml.v3"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+const legacyEasyPConfigFile = v1.PolicyFile
+
+type legacyDependencyGitRepo struct {
+	URL string `yaml:"url"`
+}
+
+type legacyDependencyInput struct {
+	Directory config.InputFilesDir    `yaml:"directory"`
+	GitRepo   legacyDependencyGitRepo `yaml:"git_repo"`
+}
+
+type legacyDependencyGenerate struct {
+	Inputs []legacyDependencyInput `yaml:"inputs"`
+}
+
+// legacyDependencyList rejects null and non-string entries instead of letting
+// YAML decoding silently remove them from the dependency graph.
+type legacyDependencyList []string
+
+func (list *legacyDependencyList) UnmarshalYAML(node *yaml.Node) error {
+	if node.Kind != yaml.SequenceNode {
+		return fmt.Errorf("deps must be a list of module strings")
+	}
+	values := make([]string, 0, len(node.Content))
+	for i, entry := range node.Content {
+		if entry.Kind == yaml.AliasNode {
+			entry = entry.Alias
+		}
+		if entry == nil || entry.Kind != yaml.ScalarNode || entry.Tag != "!!str" {
+			return fmt.Errorf("deps[%d] must be a module string", i)
+		}
+		values = append(values, entry.Value)
+	}
+	*list = values
+	return nil
+}
+
+type legacyDependencyConfig struct {
+	Deps     legacyDependencyList     `yaml:"deps"`
+	Generate legacyDependencyGenerate `yaml:"generate"`
+}
+
+func readLegacyEasyPRootsAndRequires(path string) ([]string, []v1.Requirement, error) {
+	raw, err := readGitDependencyConfig(path)
+	if err != nil {
+		return nil, nil, fmt.Errorf("readGitDependencyConfig: %w", err)
+	}
+	var old legacyDependencyConfig
+	err = yaml.Unmarshal(raw, &old)
+	if err != nil {
+		return nil, nil, fmt.Errorf("Unmarshal: %s: %w", path, err)
+	}
+	var roots []string
+	var requires []v1.Requirement
+	seen := make(map[v1.Requirement]bool)
+	appendRequirement := func(raw string) error {
+		requirement, err := parseLegacyV1Requirement(raw)
+		if err != nil {
+			return err
+		}
+		if !seen[requirement] {
+			requires = append(requires, requirement)
+			seen[requirement] = true
+		}
+		return nil
+	}
+	for i, raw := range old.Deps {
+		if err := appendRequirement(raw); err != nil {
+			return nil, nil, fmt.Errorf("parseLegacyV1Requirement: %s deps[%d]: %w", path, i, err)
+		}
+	}
+	for i, input := range old.Generate.Inputs {
+		if input.Directory.Path != "" || input.Directory.Root != "" {
+			roots = append(roots, input.Directory.Root)
+		}
+		if input.GitRepo.URL != "" {
+			if err := appendRequirement(input.GitRepo.URL); err != nil {
+				return nil, nil, fmt.Errorf("parseLegacyV1Requirement: %s generate.inputs[%d].git_repo.url: %w", path, i, err)
+			}
+		}
+	}
+	return roots, requires, nil
+}
+
+func parseLegacyV1Requirement(raw string) (v1.Requirement, error) {
+	raw = strings.TrimSpace(raw)
+	if raw == "" {
+		return v1.Requirement{}, fmt.Errorf("empty legacy dependency")
+	}
+	source, version := raw, ""
+	if at := strings.LastIndex(raw, "@"); at > strings.LastIndex(raw, "/") {
+		source, version = raw[:at], raw[at+1:]
+		if !semver.IsValid(version) && !v1.IsCommitRef(version) {
+			return v1.Requirement{}, fmt.Errorf("legacy dependency %q needs a SemVer tag or full Git commit", raw)
+		}
+	}
+	if source == "" {
+		return v1.Requirement{}, fmt.Errorf("legacy dependency %q has no Git source", raw)
+	}
+	return v1.Requirement{Module: source, Version: version}, nil
+}
diff --git a/internal/adapters/module_config/git_dependency_nested.go b/internal/adapters/module_config/git_dependency_nested.go
new file mode 100644
index 00000000..a5929234
--- /dev/null
+++ b/internal/adapters/module_config/git_dependency_nested.go
@@ -0,0 +1,85 @@
+package moduleconfig
+
+import (
+	"bytes"
+	"fmt"
+	"io/fs"
+	"path/filepath"
+	"strings"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+type nestedGitDependency struct {
+	module       v1.Module
+	found        bool
+	hasManifests bool
+}
+
+// readNestedGitDependencyModule selects one declared module from a Git
+// checkout. Roots are returned relative to the checkout, as expected by the
+// resolver and the verified module cache.
+func readNestedGitDependencyModule(dir, source string) (nestedGitDependency, error) {
+	var result nestedGitDependency
+	major, err := v1.ModulePathMajor(source)
+	if err != nil {
+		return result, fmt.Errorf("ModulePathMajor: %w", err)
+	}
+	err = filepath.WalkDir(dir, func(path string, entry fs.DirEntry, walkErr error) error {
+		if walkErr != nil {
+			return fmt.Errorf("WalkDir: %w", walkErr)
+		}
+		if entry.IsDir() {
+			if path != dir && (strings.HasPrefix(entry.Name(), ".") || entry.Name() == "easyp_vendor") {
+				return filepath.SkipDir
+			}
+			return nil
+		}
+		if entry.Name() != dependencyManifestFile || filepath.Dir(path) == dir {
+			return nil
+		}
+		raw, err := readGitDependencyConfig(path)
+		if err != nil {
+			return fmt.Errorf("readGitDependencyConfig: %w", err)
+		}
+		if !v1.IsModuleManifest(raw) {
+			return nil
+		}
+		result.hasManifests = true
+		location, err := filepath.Rel(dir, filepath.Dir(path))
+		if err != nil {
+			return fmt.Errorf("Rel: %w", err)
+		}
+		if strings.HasPrefix(major, "/") {
+			// Installed snapshots need the same physical suffix check as fresh
+			// Git candidates. Never accept an arbitrary nested declaration.
+			suffix := "/" + filepath.ToSlash(location)
+			if !strings.HasSuffix(source, suffix) && !strings.HasSuffix(strings.TrimSuffix(source, major), suffix) {
+				return nil
+			}
+		}
+		if name := nativeDependencyName(raw); name != "" && name != source {
+			return nil
+		}
+		module, err := v1.ParseModule(bytes.NewReader(raw))
+		if err != nil {
+			return fmt.Errorf("ParseModule: %s: %w", path, err)
+		}
+		if module.Name != source {
+			return nil
+		}
+		if result.found {
+			return fmt.Errorf("module %s is declared more than once in %s", source, dir)
+		}
+		for i, root := range module.Roots {
+			module.Roots[i] = filepath.Join(location, root)
+		}
+		result.module = module
+		result.found = true
+		return nil
+	})
+	if err != nil {
+		return nestedGitDependency{}, fmt.Errorf("WalkDir: %w", err)
+	}
+	return result, nil
+}
diff --git a/internal/adapters/module_config/git_dependency_test.go b/internal/adapters/module_config/git_dependency_test.go
new file mode 100644
index 00000000..a37a99aa
--- /dev/null
+++ b/internal/adapters/module_config/git_dependency_test.go
@@ -0,0 +1,407 @@
+package moduleconfig
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/stretchr/testify/require"
+)
+
+func TestReadGitDependencyModuleFormats(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name     string
+		files    map[string]string
+		roots    []string
+		requires []v1.Requirement
+	}{
+		{
+			name:  "no dependency metadata",
+			roots: []string{"."},
+		},
+		{
+			name: "buf v2",
+			files: map[string]string{
+				"buf.yaml": "version: v2\nmodules:\n  - path: proto/user\n  - path: proto/common\n",
+			},
+			roots: []string{"proto/user", "proto/common"},
+		},
+		{
+			name: "buf v1 workspace",
+			files: map[string]string{
+				"buf.work.yaml":         "version: v1\ndirectories:\n  - proto/user\n  - proto/common\n",
+				"proto/user/buf.yaml":   "version: v1\n",
+				"proto/common/buf.yaml": "version: v1\n",
+			},
+			roots: []string{"proto/user", "proto/common"},
+		},
+		{
+			name:  "buf v1 single module",
+			files: map[string]string{"buf.yaml": "version: v1\n"},
+			roots: []string{"."},
+		},
+		{
+			name:  "buf v1beta1 roots",
+			files: map[string]string{"buf.yaml": "version: v1beta1\nbuild:\n  roots: [proto, third_party]\n"},
+			roots: []string{"proto", "third_party"},
+		},
+		{
+			name: "legacy easyp and protobuf.mod",
+			files: map[string]string{
+				"easyp.yaml":   "generate:\n  inputs:\n    - directory:\n        path: proto\n        root: proto\n",
+				"protobuf.mod": "direct (\n  example.com/common@v1.2.0\n)\n",
+			},
+			roots:    []string{"proto"},
+			requires: []v1.Requirement{{Module: "example.com/common", Version: "v1.2.0"}},
+		},
+		{
+			name: "legacy git input",
+			files: map[string]string{
+				"easyp.yaml": "generate:\n  inputs:\n    - directory: proto\n    - git_repo:\n        url: example.com/common@v1.1.0\n",
+			},
+			roots:    []string{"."},
+			requires: []v1.Requirement{{Module: "example.com/common", Version: "v1.1.0"}},
+		},
+		{
+			name: "v1 manifest wins",
+			files: map[string]string{
+				"protobuf.mod": "module example.com/dependency\nroots proto\nrequire example.com/common v1.2.0\n",
+				"buf.yaml":     "invalid: [lower priority]",
+				"easyp.yaml":   "generate: [invalid legacy config]",
+			},
+			roots:    []string{"proto"},
+			requires: []v1.Requirement{{Module: "example.com/common", Version: "v1.2.0"}},
+		},
+		{
+			name: "legacy requirements and buf roots are combined",
+			files: map[string]string{
+				"protobuf.mod":  "direct (\n  example.com/common@v1.2.0\n)\n",
+				"buf.work.yaml": "version: v1\ndirectories: [proto/buf]\n",
+				"buf.yaml":      "invalid: [lower priority]",
+				"easyp.yaml":    "generate:\n  inputs:\n    - directory:\n        path: proto/legacy\n        root: proto/legacy\n    - git_repo:\n        url: example.com/other@v1.3.0\n",
+			},
+			roots: []string{"proto/buf"},
+			requires: []v1.Requirement{
+				{Module: "example.com/common", Version: "v1.2.0"},
+				{Module: "example.com/other", Version: "v1.3.0"},
+			},
+		},
+	}
+	for _, tc := range tests {
+		t.Run(tc.name, func(t *testing.T) {
+			t.Parallel()
+			dir := t.TempDir()
+			for name, body := range tc.files {
+				path := filepath.Join(dir, name)
+				if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil {
+					t.Fatal(err)
+				}
+				if err := os.WriteFile(path, []byte(body), 0o644); err != nil {
+					t.Fatal(err)
+				}
+			}
+			module, err := ReadGitDependency(dir, "example.com/dependency")
+			require.NoError(t, err)
+			require.Equal(t, "example.com/dependency", module.Name)
+			require.Equal(t, tc.roots, module.Roots)
+			require.Equal(t, tc.requires, module.Requires)
+		})
+	}
+}
+
+func TestReadGitDependencyRejectsInvalidBufWorkspaceBeforeFallback(t *testing.T) {
+	t.Parallel()
+
+	dir := t.TempDir()
+	require.NoError(t, os.WriteFile(filepath.Join(dir, bufWorkConfigFile), []byte("version: v2\ndirectories: [proto]\n"), 0o644))
+	require.NoError(t, os.WriteFile(filepath.Join(dir, bufModuleConfigFile), []byte("version: v1\n"), 0o644))
+	_, err := ReadGitDependency(dir, "example.com/dependency")
+	require.ErrorContains(t, err, bufWorkConfigFile)
+}
+
+func TestDetectGitDependencyModes(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name  string
+		files []string
+		want  []gitDependencyMode
+	}{
+		{name: "missing files"},
+		{
+			name:  "all formats in stable order",
+			files: []string{legacyEasyPConfigFile, bufModuleConfigFile, dependencyManifestFile, bufWorkConfigFile},
+			want:  []gitDependencyMode{gitDependencyManifest, gitDependencyBufWorkspace, gitDependencyBufModule, gitDependencyLegacyEasyP},
+		},
+		{
+			name:  "nested manifest is not a root mode",
+			files: []string{"nested/" + dependencyManifestFile},
+		},
+	}
+
+	for _, tc := range tests {
+		t.Run(tc.name, func(t *testing.T) {
+			t.Parallel()
+			dir := t.TempDir()
+			for _, name := range tc.files {
+				path := filepath.Join(dir, name)
+				require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+				require.NoError(t, os.WriteFile(path, []byte(""), 0o644))
+			}
+			modes, err := detectGitDependencyModes(dir)
+			require.NoError(t, err)
+			require.Equal(t, tc.want, modes)
+		})
+	}
+}
+
+func TestReadGitDependencyReportsUnreadableSelectedConfig(t *testing.T) {
+	t.Parallel()
+	dir := t.TempDir()
+	require.NoError(t, os.Mkdir(filepath.Join(dir, bufModuleConfigFile), 0o755))
+	_, err := ReadGitDependency(dir, "example.com/dependency")
+	require.ErrorContains(t, err, bufModuleConfigFile)
+}
+
+func TestReadGitDependencySelectsNestedModuleByIdentity(t *testing.T) {
+	t.Parallel()
+	dir := t.TempDir()
+	for name, body := range map[string]string{
+		"protobuf.mod":         "module example.com/repo\nroots rootproto\n",
+		"foo/protobuf.mod":     "module example.com/repo/foo\nroots proto\nrequire example.com/common v1.2.0\n",
+		"bar/protobuf.mod":     "module example.com/repo/bar\nroots proto\n",
+		"foo/proto/foo.proto":  "syntax = \"proto3\";\n",
+		"bar/proto/bar.proto":  "syntax = \"proto3\";\n",
+		"rootproto/root.proto": "syntax = \"proto3\";\n",
+	} {
+		path := filepath.Join(dir, name)
+		require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+		require.NoError(t, os.WriteFile(path, []byte(body), 0o644))
+	}
+
+	module, err := ReadGitDependency(dir, "example.com/repo/foo")
+	require.NoError(t, err)
+	require.Equal(t, "example.com/repo/foo", module.Name)
+	require.Equal(t, []string{"foo/proto"}, module.Roots)
+	require.Equal(t, []v1.Requirement{{Module: "example.com/common", Version: "v1.2.0"}}, module.Requires)
+
+	root, err := ReadGitDependency(dir, "example.com/repo")
+	require.NoError(t, err)
+	require.Equal(t, []string{"rootproto"}, root.Roots)
+}
+
+func TestReadGitDependencyRejectsUnknownNestedModule(t *testing.T) {
+	t.Parallel()
+	dir := t.TempDir()
+	require.NoError(t, os.Mkdir(filepath.Join(dir, "foo"), 0o755))
+	require.NoError(t, os.WriteFile(filepath.Join(dir, "foo", "protobuf.mod"), []byte("module example.com/repo/foo\n"), 0o644))
+	_, err := ReadGitDependency(dir, "example.com/repo/bar")
+	require.ErrorContains(t, err, "example.com/repo/bar")
+}
+
+func TestReadGitDependencyModuleRejectsEscapingRoot(t *testing.T) {
+	t.Parallel()
+
+	dir := t.TempDir()
+	if err := os.WriteFile(filepath.Join(dir, "buf.yaml"), []byte("version: v2\nmodules:\n  - path: ../outside\n"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	if _, err := ReadGitDependency(dir, "example.com/dependency"); err == nil || !strings.Contains(err.Error(), "leaves") {
+		t.Fatalf("expected root traversal error, got %v", err)
+	}
+}
+
+func TestReadGitDependencyBufProtoFilters(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name    string
+		files   map[string]string
+		roots   []string
+		filters []v1.ProtoFileFilter
+	}{
+		{
+			name:    "v2 includes and excludes",
+			files:   map[string]string{"buf.yaml": "version: v2\nmodules:\n  - path: proto\n    includes: [proto/api]\n    excludes: [proto/api/test]\n"},
+			roots:   []string{"proto"},
+			filters: []v1.ProtoFileFilter{{Root: "proto", Includes: []string{"proto/api"}, Excludes: []string{"proto/api/test"}}},
+		},
+		{
+			name:    "v2 shared root is traversed once",
+			files:   map[string]string{"buf.yaml": "version: v2\nmodules:\n  - path: proto\n    includes: [proto/a]\n  - path: proto\n    includes: [proto/b]\n"},
+			roots:   []string{"proto"},
+			filters: []v1.ProtoFileFilter{{Root: "proto", Includes: []string{"proto/a"}}, {Root: "proto", Includes: []string{"proto/b"}}},
+		},
+		{
+			name:    "v1 excludes",
+			files:   map[string]string{"buf.yaml": "version: v1\nbuild:\n  excludes: [test]\n"},
+			roots:   []string{"."},
+			filters: []v1.ProtoFileFilter{{Root: ".", Excludes: []string{"test"}}},
+		},
+		{
+			name:    "v1beta1 excludes belong to their root",
+			files:   map[string]string{"buf.yaml": "version: v1beta1\nbuild:\n  roots: [proto, third_party]\n  excludes: [proto/test]\n"},
+			roots:   []string{"proto", "third_party"},
+			filters: []v1.ProtoFileFilter{{Root: "proto", Excludes: []string{"proto/test"}}, {Root: "third_party"}},
+		},
+		{
+			name: "v1 workspace rebases nested excludes",
+			files: map[string]string{
+				"buf.work.yaml":  "version: v1\ndirectories: [proto]\n",
+				"proto/buf.yaml": "version: v1\nbuild:\n  excludes: [test]\n",
+			},
+			roots:   []string{"proto"},
+			filters: []v1.ProtoFileFilter{{Root: "proto", Excludes: []string{"proto/test"}}},
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			dir := t.TempDir()
+			for name, body := range tt.files {
+				path := filepath.Join(dir, name)
+				require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+				require.NoError(t, os.WriteFile(path, []byte(body), 0o644))
+			}
+
+			module, err := ReadGitDependency(dir, "example.com/dependency")
+
+			require.NoError(t, err)
+			require.Equal(t, tt.roots, module.Roots)
+			require.Equal(t, tt.filters, module.ProtoFilters)
+		})
+	}
+}
+
+func TestParseLegacyV1RequirementWithoutVersion(t *testing.T) {
+	t.Parallel()
+
+	got, err := parseLegacyV1Requirement("github.com/acme/common")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if got.Module != "github.com/acme/common" || got.Version != "" {
+		t.Fatalf("requirement = %#v", got)
+	}
+}
+
+func TestParseLegacyV1RequirementRejectsBranchRef(t *testing.T) {
+	t.Parallel()
+
+	if _, err := parseLegacyV1Requirement("github.com/acme/common@main"); err == nil || !strings.Contains(err.Error(), "SemVer tag or full Git commit") {
+		t.Fatalf("expected branch-ref error, got %v", err)
+	}
+}
+
+func TestParseLegacyV1RequirementByCommit(t *testing.T) {
+	commit := strings.Repeat("a", 40)
+	got, err := parseLegacyV1Requirement("github.com/acme/common@" + commit)
+	require.NoError(t, err)
+	require.Equal(t, v1.Requirement{Module: "github.com/acme/common", Version: commit}, got)
+}
+
+func TestReadGitDependencyBufRegistryMetadataKeepsGitIdentity(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name  string
+		files map[string]string
+		roots []string
+	}{
+		{
+			name: "buf v2",
+			files: map[string]string{
+				"buf.yaml": "version: v2\nmodules:\n  - path: proto\ndeps:\n  - buf.build/googleapis/googleapis\n",
+			},
+			roots: []string{"proto"},
+		},
+		{
+			name: "buf v1",
+			files: map[string]string{
+				"buf.yaml": "version: v1\ndeps:\n  - buf.build/acme/payments:deadbeef\n",
+			},
+			roots: []string{"."},
+		},
+		{
+			name: "buf v1beta1",
+			files: map[string]string{
+				"buf.yaml": "version: v1beta1\nbuild:\n  roots: [proto]\ndeps:\n  - buf.build/acme/common:v1.2.3\n",
+			},
+			roots: []string{"proto"},
+		},
+		{
+			name: "buf v1 workspace with nested registry metadata",
+			files: map[string]string{
+				"buf.work.yaml":    "version: v1\ndirectories: [proto/a, proto/b]\n",
+				"proto/a/buf.yaml": "version: v1\ndeps: [buf.build/acme/a-dep]\n",
+				"proto/b/buf.yaml": "version: v1\ndeps: [buf.build/acme/b-dep:v1.0.0]\n",
+			},
+			roots: []string{"proto/a", "proto/b"},
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			dir := t.TempDir()
+			for name, body := range tt.files {
+				path := filepath.Join(dir, name)
+				require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+				require.NoError(t, os.WriteFile(path, []byte(body), 0o644))
+			}
+
+			module, err := ReadGitDependency(dir, "example.com/dependency")
+
+			require.NoError(t, err)
+			require.Equal(t, "example.com/dependency", module.Name)
+			require.Equal(t, tt.roots, module.Roots)
+			require.Empty(t, module.Requires, "BSR identities must not become Git requirements")
+		})
+	}
+}
+
+func TestReadGitDependencyBufWorkspaceIgnoresUnselectedRootBufMetadata(t *testing.T) {
+	t.Parallel()
+
+	dir := t.TempDir()
+	files := map[string]string{
+		"buf.work.yaml":    "version: v1\ndirectories: [proto/a]\n",
+		"buf.yaml":         "version: v1\ndeps: [buf.build/acme/not-in-workspace]\n",
+		"proto/a/buf.yaml": "version: v1\n",
+		"proto/a/a.proto":  "syntax = \"proto3\";\n",
+	}
+	for name, body := range files {
+		path := filepath.Join(dir, name)
+		require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+		require.NoError(t, os.WriteFile(path, []byte(body), 0o644))
+	}
+
+	module, err := ReadGitDependency(dir, "example.com/dependency")
+
+	require.NoError(t, err)
+	require.Equal(t, []string{"proto/a"}, module.Roots)
+}
+
+func TestReadGitDependencyBufWorkspaceRejectsEscapingDirectoryBeforeMetadataRead(t *testing.T) {
+	t.Parallel()
+
+	root := t.TempDir()
+	outside := filepath.Join(filepath.Dir(root), "outside")
+	require.NoError(t, os.MkdirAll(outside, 0o755))
+	require.NoError(t, os.WriteFile(filepath.Join(outside, bufModuleConfigFile), []byte(
+		"version: v1\ndeps: [buf.build/acme/outside]\n",
+	), 0o644))
+	require.NoError(t, os.WriteFile(filepath.Join(root, bufWorkConfigFile), []byte(
+		"version: v1\ndirectories: [../outside]\n",
+	), 0o644))
+
+	_, err := ReadGitDependency(root, "example.com/dependency")
+
+	require.ErrorContains(t, err, "leaves the repository")
+	require.NotContains(t, err.Error(), "buf.build/acme/outside")
+}
diff --git a/internal/adapters/module_config/legacy_deps_test.go b/internal/adapters/module_config/legacy_deps_test.go
new file mode 100644
index 00000000..d26c5901
--- /dev/null
+++ b/internal/adapters/module_config/legacy_deps_test.go
@@ -0,0 +1,67 @@
+package moduleconfig
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestLegacyDepsAndGitInputsAreCombined(t *testing.T) {
+	t.Parallel()
+	sha := strings.Repeat("a", 40)
+	tests := []struct {
+		name, yaml string
+		want       []v1.Requirement
+	}{
+		{name: "deps only", yaml: "deps: [example.com/common@v1.2.0]\n", want: []v1.Requirement{{Module: "example.com/common", Version: "v1.2.0"}}},
+		{name: "unversioned", yaml: "deps: [example.com/common]\n", want: []v1.Requirement{{Module: "example.com/common"}}},
+		{name: "commit pin", yaml: "deps: [example.com/common@" + sha + "]\n", want: []v1.Requirement{{Module: "example.com/common", Version: sha}}},
+		{name: "duplicates and distinct minima", yaml: "deps: [example.com/common@v1.2.0, example.com/common@v1.2.0]\ngenerate:\n  inputs:\n    - git_repo: {url: example.com/common@v1.2.0}\n    - git_repo: {url: example.com/common@v1.3.0}\n    - git_repo: {url: example.com/other@v1.0.0}\n", want: []v1.Requirement{{Module: "example.com/common", Version: "v1.2.0"}, {Module: "example.com/common", Version: "v1.3.0"}, {Module: "example.com/other", Version: "v1.0.0"}}},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			dir := t.TempDir()
+			require.NoError(t, os.WriteFile(filepath.Join(dir, "easyp.yaml"), []byte(tt.yaml), 0o644))
+			module, err := ReadGitDependency(dir, "example.com/dependency")
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, module.Requires)
+			assert.Equal(t, []string{"."}, module.Roots)
+		})
+	}
+}
+
+func TestInvalidLegacyDepsAreNotSilentlyDropped(t *testing.T) {
+	t.Parallel()
+	tests := []struct{ name, yaml, want string }{
+		{name: "empty", yaml: "deps: ['']\n", want: "deps[0]"},
+		{name: "null", yaml: "deps: [null]\n", want: "deps[0]"},
+		{name: "unsupported branch", yaml: "deps: [example.com/common@main]\n", want: "SemVer tag or full Git commit"},
+		{name: "invalid YAML shape", yaml: "deps: {url: example.com/common}\n", want: "Unmarshal"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			dir := t.TempDir()
+			require.NoError(t, os.WriteFile(filepath.Join(dir, "easyp.yaml"), []byte(tt.yaml), 0o644))
+			_, err := ReadGitDependency(dir, "example.com/dependency")
+			require.ErrorContains(t, err, tt.want)
+		})
+	}
+}
+
+func TestNativeManifestTakesPrecedenceOverLegacyDeps(t *testing.T) {
+	t.Parallel()
+	dir := t.TempDir()
+	require.NoError(t, os.WriteFile(filepath.Join(dir, "protobuf.mod"), []byte("module example.com/dependency\nrequire example.com/current v1.0.0\n"), 0o644))
+	require.NoError(t, os.WriteFile(filepath.Join(dir, "easyp.yaml"), []byte("deps: {invalid: legacy}\n"), 0o644))
+	module, err := ReadGitDependency(dir, "example.com/dependency")
+	require.NoError(t, err)
+	assert.Equal(t, []v1.Requirement{{Module: "example.com/current", Version: "v1.0.0"}}, module.Requires)
+}
diff --git a/internal/adapters/module_config/legacy_major.go b/internal/adapters/module_config/legacy_major.go
new file mode 100644
index 00000000..d3e0a683
--- /dev/null
+++ b/internal/adapters/module_config/legacy_major.go
@@ -0,0 +1,38 @@
+package moduleconfig
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+
+	"golang.org/x/mod/semver"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// ValidateLegacyMajor verifies that +incompatible describes pre-native metadata.
+// The suffix is a compatibility marker, never permission to bypass a native
+// protobuf.mod identity. Call it on the exact verified revision, including caches.
+func ValidateLegacyMajor(dir, source, version string) error {
+	if semver.Build(version) != "+incompatible" {
+		return nil
+	}
+	if err := v1.ValidateModuleVersion(source, version); err != nil {
+		return fmt.Errorf("ValidateModuleVersion: %w", err)
+	}
+	raw, err := os.ReadFile(filepath.Join(dir, v1.ModuleFile))
+	if err != nil && !os.IsNotExist(err) {
+		return fmt.Errorf("ReadFile: %w", err)
+	}
+	if err == nil && v1.IsModuleManifest(raw) {
+		return fmt.Errorf("%s@%s: +incompatible is only valid before a native protobuf.mod exists; use the published matching /vN module identity", source, version)
+	}
+	nested, err := readNestedGitDependencyModule(dir, source)
+	if err != nil {
+		return fmt.Errorf("readNestedGitDependencyModule: %w", err)
+	}
+	if nested.found {
+		return fmt.Errorf("%s@%s: +incompatible cannot bypass a native nested protobuf.mod", source, version)
+	}
+	return nil
+}
diff --git a/internal/adapters/module_config/module_config.go b/internal/adapters/module_config/module_config.go
deleted file mode 100644
index 6cf4d6f8..00000000
--- a/internal/adapters/module_config/module_config.go
+++ /dev/null
@@ -1,14 +0,0 @@
-package moduleconfig
-
-import "github.com/easyp-tech/easyp/internal/logger"
-
-type (
-	// ModuleConfig implement module config logic such as buf dirs config etc
-	ModuleConfig struct {
-		logger logger.Logger
-	}
-)
-
-func New(logger logger.Logger) *ModuleConfig {
-	return &ModuleConfig{logger: logger}
-}
diff --git a/internal/adapters/module_config/policy_directory.go b/internal/adapters/module_config/policy_directory.go
new file mode 100644
index 00000000..7a6ae183
--- /dev/null
+++ b/internal/adapters/module_config/policy_directory.go
@@ -0,0 +1,60 @@
+package moduleconfig
+
+import (
+	"bytes"
+	"fmt"
+	"io/fs"
+	"os"
+	"path/filepath"
+	"strings"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// DependencyManifestDirectory finds the actual directory of an already verified
+// module. Proto import roots cannot locate policies outside those roots. It
+// selects by declared identity before parsing, so unrelated manifests stay lazy.
+func DependencyManifestDirectory(repositoryRoot, identity string) (string, error) {
+	var matches []string
+	err := filepath.WalkDir(repositoryRoot, func(path string, entry fs.DirEntry, walkErr error) error {
+		if walkErr != nil {
+			return walkErr
+		}
+		if entry.IsDir() {
+			if path != repositoryRoot && (strings.HasPrefix(entry.Name(), ".") || entry.Name() == "easyp_vendor" || entry.Name() == "node_modules") {
+				return filepath.SkipDir
+			}
+			return nil
+		}
+		if entry.Name() != v1.ModuleFile {
+			return nil
+		}
+		raw, err := os.ReadFile(path)
+		if err != nil {
+			return fmt.Errorf("ReadFile: %w", err)
+		}
+		if nativeDependencyName(raw) != identity {
+			return nil
+		}
+		module, err := v1.ParseModule(bytes.NewReader(raw))
+		if err != nil {
+			return fmt.Errorf("ParseModule: %s: %w", path, err)
+		}
+		if module.Name == identity {
+			matches = append(matches, filepath.Dir(path))
+		}
+		return nil
+	})
+	if err != nil {
+		return "", fmt.Errorf("WalkDir: %w", err)
+	}
+	if len(matches) > 1 {
+		return "", fmt.Errorf("module %s is declared more than once in %s", identity, repositoryRoot)
+	}
+	if len(matches) == 1 {
+		return matches[0], nil
+	}
+	// Pre-native Git metadata has no module manifest; its policy root is the
+	// verified checkout, not one of the adapted proto import roots.
+	return repositoryRoot, nil
+}
diff --git a/internal/adapters/module_config/read_buf_work.go b/internal/adapters/module_config/read_buf_work.go
deleted file mode 100644
index a8bc5e27..00000000
--- a/internal/adapters/module_config/read_buf_work.go
+++ /dev/null
@@ -1,80 +0,0 @@
-package moduleconfig
-
-import (
-	"context"
-	"fmt"
-	"strings"
-
-	"gopkg.in/yaml.v3"
-
-	"github.com/easyp-tech/easyp/internal/adapters/repository"
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-type bufV1Config struct {
-	Directories []string `yaml:"directories"`
-}
-
-type bufV2Config struct {
-	Modules []struct {
-		Path string `yaml:"path"`
-		Name string `yaml:"name"`
-		Lint struct {
-			IgnoreOnly struct {
-				PACKAGEVERSIONSUFFIX []string `yaml:"PACKAGE_VERSION_SUFFIX"`
-			} `yaml:"ignore_only"`
-		} `yaml:"lint"`
-	} `yaml:"modules"`
-}
-
-const (
-	bufV1ConfigFile = "buf.work.yaml"
-	bufV2ConfigFile = "buf.yaml"
-)
-
-func readBufWork(ctx context.Context, repo repository.Repo, revision models.Revision) (models.ModuleConfig, error) {
-	bufV1, err := readBufV1(ctx, repo, revision)
-	if err == nil {
-		return bufV1, nil
-	}
-
-	bufV2, err := readBufV2(ctx, repo, revision)
-	return bufV2, err
-}
-
-func readBufV1(ctx context.Context, repo repository.Repo, revision models.Revision) (models.ModuleConfig, error) {
-	content, err := repo.ReadFile(ctx, revision, bufV1ConfigFile)
-	if err != nil {
-		return models.ModuleConfig{}, fmt.Errorf("repo.ReadFile: %w", err)
-	}
-
-	buf := bufV1Config{}
-	if err := yaml.NewDecoder(strings.NewReader(content)).Decode(&buf); err != nil {
-		return models.ModuleConfig{}, fmt.Errorf("yaml.NewDecoder: %w", err)
-	}
-
-	return models.ModuleConfig{
-		Directories: buf.Directories,
-	}, nil
-}
-
-func readBufV2(ctx context.Context, repo repository.Repo, revision models.Revision) (models.ModuleConfig, error) {
-	content, err := repo.ReadFile(ctx, revision, bufV2ConfigFile)
-	if err != nil {
-		return models.ModuleConfig{}, fmt.Errorf("repo.ReadFile: %w", err)
-	}
-
-	buf := bufV2Config{}
-	if err := yaml.NewDecoder(strings.NewReader(content)).Decode(&buf); err != nil {
-		return models.ModuleConfig{}, fmt.Errorf("yaml.NewDecoder: %w", err)
-	}
-
-	dirs := make([]string, 0, len(buf.Modules))
-	for _, module := range buf.Modules {
-		dirs = append(dirs, module.Path)
-	}
-
-	return models.ModuleConfig{
-		Directories: dirs,
-	}, nil
-}
diff --git a/internal/adapters/module_config/read_easyp.go b/internal/adapters/module_config/read_easyp.go
deleted file mode 100644
index 164f4053..00000000
--- a/internal/adapters/module_config/read_easyp.go
+++ /dev/null
@@ -1,39 +0,0 @@
-package moduleconfig
-
-import (
-	"context"
-	"fmt"
-
-	"github.com/easyp-tech/easyp/internal/adapters/repository"
-	"github.com/easyp-tech/easyp/internal/config"
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-// readEasyp read easyp's config from repository
-func readEasyp(ctx context.Context, repo repository.Repo, revision models.Revision) (models.ModuleConfig, error) {
-	content, err := repo.ReadFile(ctx, revision, config.DefaultFileName)
-	if err != nil {
-		return models.ModuleConfig{}, fmt.Errorf("repo.ReadFile: %w", err)
-	}
-
-	easyp, err := config.ParseConfig([]byte(content))
-	if err != nil {
-		return models.ModuleConfig{}, fmt.Errorf("config.ParseConfig: %w", err)
-	}
-
-	modules := make([]models.Module, 0, len(easyp.Deps))
-	for _, dep := range easyp.Deps {
-		module := models.NewModule(dep)
-		modules = append(modules, module)
-	}
-
-	dirs := make([]string, 0, len(easyp.Generate.Inputs))
-	for _, input := range easyp.Generate.Inputs {
-		dirs = append(dirs, input.InputFilesDir.Root)
-	}
-
-	return models.ModuleConfig{
-		Dependencies: modules,
-		Directories:  dirs,
-	}, nil
-}
diff --git a/internal/adapters/module_config/read_from_repo.go b/internal/adapters/module_config/read_from_repo.go
deleted file mode 100644
index 2b4d5aa8..00000000
--- a/internal/adapters/module_config/read_from_repo.go
+++ /dev/null
@@ -1,40 +0,0 @@
-package moduleconfig
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"log/slog"
-
-	"github.com/easyp-tech/easyp/internal/adapters/repository"
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-// Read and return module's config from repository
-func (c *ModuleConfig) ReadFromRepo(
-	ctx context.Context, repo repository.Repo, revision models.Revision,
-) (models.ModuleConfig, error) {
-	// buf
-	c.logger.Debug(ctx, "reading buf config from repo", slog.String("revision", revision.Version))
-
-	buf, err := readBufWork(ctx, repo, revision)
-	if err == nil {
-		return buf, nil
-	}
-	if !errors.Is(err, models.ErrFileNotFound) {
-		return models.ModuleConfig{}, fmt.Errorf("readBufWork: %w", err)
-	}
-
-	// easyp
-	c.logger.Debug(ctx, "reading easyp config from repo", slog.String("revision", revision.Version))
-
-	easyp, err := readEasyp(ctx, repo, revision)
-	if err == nil {
-		return easyp, nil
-	}
-	if !errors.Is(err, models.ErrFileNotFound) {
-		return models.ModuleConfig{}, fmt.Errorf("readEasyp: %w", err)
-	}
-
-	return models.ModuleConfig{}, nil
-}
diff --git a/internal/adapters/plugin/builtin_impl.go b/internal/adapters/plugin/builtin_impl.go
index 5821cb73..ed09aeb5 100644
--- a/internal/adapters/plugin/builtin_impl.go
+++ b/internal/adapters/plugin/builtin_impl.go
@@ -4,6 +4,7 @@ import (
 	"bytes"
 	"context"
 	"crypto/rand"
+	"errors"
 	"fmt"
 	"io"
 	"log/slog"
@@ -92,7 +93,7 @@ func (e *BuiltinPluginExecutor) Execute(ctx context.Context, plugin Info, reques
 }
 
 // runWasmPlugin runs WASM module with custom stdin/stdout
-func (e *BuiltinPluginExecutor) runWasmPlugin(ctx context.Context, pluginName string, stdin io.Reader) ([]byte, error) {
+func (e *BuiltinPluginExecutor) runWasmPlugin(ctx context.Context, pluginName string, stdin io.Reader) (output []byte, runErr error) {
 	// Get WASM module and arguments for the plugin
 	wasmBin, args, err := getWasmModule(pluginName)
 	if err != nil {
@@ -105,8 +106,13 @@ func (e *BuiltinPluginExecutor) runWasmPlugin(ctx context.Context, pluginName st
 	// Create wazero runtime
 	rt := wazero.NewRuntimeWithConfig(ctx, wazero.NewRuntimeConfig().WithCoreFeatures(api.CoreFeaturesV2|experimental.CoreFeaturesThreads))
 
-	// Close runtime at the end
-	defer rt.Close(ctx)
+	// A failed runtime close must not turn into successful generated output.
+	defer func() {
+		if err := rt.Close(ctx); err != nil {
+			output = nil
+			runErr = errors.Join(runErr, fmt.Errorf("Close: %w", err))
+		}
+	}()
 
 	// Instantiate WASI
 	wasi_snapshot_preview1.MustInstantiate(ctx, rt)
diff --git a/internal/adapters/plugin/command.go b/internal/adapters/plugin/command.go
index 2b5f1be2..64e5300b 100644
--- a/internal/adapters/plugin/command.go
+++ b/internal/adapters/plugin/command.go
@@ -69,7 +69,11 @@ func (e *CommandPluginExecutor) Execute(ctx context.Context, plugin Info, reques
 		commandParams = commandParts[1:]
 	}
 
-	stdout, err := e.console.RunCmdWithStdin(ctx, ".", stdIn, command, commandParams...)
+	workDir := plugin.WorkDir
+	if workDir == "" {
+		workDir = "."
+	}
+	stdout, err := e.console.RunCmdWithStdin(ctx, workDir, stdIn, command, commandParams...)
 	if err != nil {
 		return nil, fmt.Errorf("run command %s: %w", strings.Join(commandParts, " "), err)
 	}
diff --git a/internal/adapters/plugin/local.go b/internal/adapters/plugin/local.go
index 6635ad13..fef82db6 100644
--- a/internal/adapters/plugin/local.go
+++ b/internal/adapters/plugin/local.go
@@ -6,6 +6,8 @@ import (
 	"fmt"
 	"log/slog"
 	"os/exec"
+	"path/filepath"
+	"strings"
 
 	"google.golang.org/protobuf/proto"
 	"google.golang.org/protobuf/types/pluginpb"
@@ -14,28 +16,27 @@ import (
 	"github.com/easyp-tech/easyp/internal/logger"
 )
 
+// Info describes a plugin invocation and its execution directory.
 type Info struct {
 	Source  string
+	WorkDir string
 	Command []string
 	Options map[string][]string
 }
 
-// LocalPluginExecutor executes plugins locally via terminal
+// LocalPluginExecutor invokes local plugin executables.
 type LocalPluginExecutor struct {
-	console console.Console
-	logger  logger.Logger
+	logger logger.Logger
 }
 
+// GetName identifies the local executor.
 func (e *LocalPluginExecutor) GetName() string {
 	return "LocalPluginExecutor from PATH"
 }
 
 // NewLocalPluginExecutor creates a new LocalPluginExecutor
-func NewLocalPluginExecutor(console console.Console, logger logger.Logger) *LocalPluginExecutor {
-	return &LocalPluginExecutor{
-		console: console,
-		logger:  logger,
-	}
+func NewLocalPluginExecutor(logger logger.Logger) *LocalPluginExecutor {
+	return &LocalPluginExecutor{logger: logger}
 }
 
 // isPluginInPath checks if the plugin is available in PATH
@@ -44,7 +45,7 @@ func (e *LocalPluginExecutor) isPluginInPath(source string) (string, bool) {
 	return command, err == nil
 }
 
-// Execute executes a local plugin via terminal
+// Execute runs a plugin in its working directory and decodes the response.
 func (e *LocalPluginExecutor) Execute(ctx context.Context, plugin Info, request *pluginpb.CodeGeneratorRequest) (*pluginpb.CodeGeneratorResponse, error) {
 	e.logger.Debug(ctx, "executing local plugin",
 		slog.String("plugin", plugin.Source),
@@ -60,21 +61,34 @@ func (e *LocalPluginExecutor) Execute(ctx context.Context, plugin Info, request
 		return nil, fmt.Errorf("proto.Marshal request: %w", err)
 	}
 
-	stdIn := bytes.NewReader(reqData)
-
-	command, err := e.determineCommand(plugin.Source)
+	workDir, err := filepath.Abs(plugin.WorkDir)
+	if err != nil {
+		return nil, fmt.Errorf("Abs: %w", err)
+	}
+	source := plugin.Source
+	if !filepath.IsAbs(source) && strings.ContainsAny(source, `/\`) {
+		source = filepath.Join(workDir, source)
+	}
+	command, err := e.determineCommand(source)
 	if err != nil {
 		return nil, fmt.Errorf("determineCommand: %w", err)
 	}
 
-	stdout, err := e.console.RunCmdWithStdin(ctx, ".", stdIn, command)
-	if err != nil {
-		return nil, fmt.Errorf("run local plugin %s: %w", plugin.Source, err)
+	// Pass the executable directly so paths are never interpreted as shell syntax.
+	cmd := exec.CommandContext(ctx, command)
+	cmd.Dir = workDir
+	cmd.Stdin = bytes.NewReader(reqData)
+	var stdout, stderr bytes.Buffer
+	cmd.Stdout = &stdout
+	cmd.Stderr = &stderr
+	if err := cmd.Run(); err != nil {
+		runErr := &console.RunError{Command: command, Dir: workDir, Err: err, Stderr: stderr.String()}
+		return nil, fmt.Errorf("run local plugin %s: %w", plugin.Source, runErr)
 	}
 
 	// Parse response from plugin
 	var resp pluginpb.CodeGeneratorResponse
-	if err := proto.Unmarshal([]byte(stdout), &resp); err != nil {
+	if err := proto.Unmarshal(stdout.Bytes(), &resp); err != nil {
 		return nil, fmt.Errorf("proto.Unmarshal response from plugin %s: %w", plugin.Source, err)
 	}
 
diff --git a/internal/adapters/plugin/local_test.go b/internal/adapters/plugin/local_test.go
new file mode 100644
index 00000000..e1394702
--- /dev/null
+++ b/internal/adapters/plugin/local_test.go
@@ -0,0 +1,67 @@
+package plugin
+
+import (
+	"context"
+	"os"
+	"os/exec"
+	"path/filepath"
+	"runtime"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"google.golang.org/protobuf/types/pluginpb"
+
+	"github.com/easyp-tech/easyp/internal/adapters/console"
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestLocalPluginExecutionFailure(t *testing.T) {
+	t.Parallel()
+	if runtime.GOOS == "windows" {
+		t.Skip("fixture executable uses a POSIX shell")
+	}
+	tests := []struct {
+		name     string
+		script   string
+		canceled bool
+		exitCode int
+		stderr   string
+	}{
+		{name: "nonzero exit retains diagnostics", script: "echo plugin-failed >&2\nexit 7\n", exitCode: 7, stderr: "plugin-failed\n"},
+		{name: "canceled context does not run plugin", script: "touch ran\n", canceled: true},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			path := filepath.Join(root, "test-plugin")
+			require.NoError(t, os.WriteFile(path, []byte("#!/bin/sh\n"+tt.script), 0o755))
+			ctx, cancel := context.WithCancel(t.Context())
+			t.Cleanup(cancel)
+			if tt.canceled {
+				cancel()
+			}
+			executor := NewLocalPluginExecutor(logger.NewNop())
+
+			response, err := executor.Execute(ctx, Info{Source: "./test-plugin", WorkDir: root}, &pluginpb.CodeGeneratorRequest{})
+
+			require.Error(t, err)
+			assert.Nil(t, response)
+			var runErr *console.RunError
+			require.ErrorAs(t, err, &runErr)
+			assert.Equal(t, path, runErr.Command)
+			assert.Equal(t, root, runErr.Dir)
+			assert.Equal(t, tt.stderr, runErr.Stderr)
+			if tt.canceled {
+				assert.ErrorIs(t, runErr.Err, context.Canceled)
+				assert.NoFileExists(t, filepath.Join(root, "ran"))
+				return
+			}
+			var exitErr *exec.ExitError
+			require.ErrorAs(t, runErr.Err, &exitErr)
+			assert.Equal(t, tt.exitCode, exitErr.ExitCode())
+		})
+	}
+}
diff --git a/internal/adapters/prompter/interactive.go b/internal/adapters/prompter/interactive.go
index fea785e5..f4cba271 100644
--- a/internal/adapters/prompter/interactive.go
+++ b/internal/adapters/prompter/interactive.go
@@ -3,319 +3,213 @@ package prompter
 import (
 	"context"
 	"fmt"
+	"io"
+	"os"
+	"strconv"
 	"strings"
-
-	tea "github.com/charmbracelet/bubbletea"
-	"github.com/charmbracelet/lipgloss"
 )
 
-// InteractivePrompter provides interactive prompts via bubbletea.
-type InteractivePrompter struct{}
+// InteractivePrompter provides deterministic line-oriented terminal prompts.
+// It deliberately avoids terminal capability/background queries so invoking an
+// EasyP command never writes OSC/CSI probes before the command itself runs.
+type InteractivePrompter struct {
+	In  io.Reader
+	Out io.Writer
+}
 
 var _ Prompter = InteractivePrompter{}
 
-// Styles
-var (
-	questionStyle = lipgloss.NewStyle().Bold(true).Foreground(lipgloss.Color("6"))
-	cursorStyle   = lipgloss.NewStyle().Foreground(lipgloss.Color("2"))
-	checkedStyle  = lipgloss.NewStyle().Foreground(lipgloss.Color("2"))
-	helpStyle     = lipgloss.NewStyle().Foreground(lipgloss.Color("8"))
-)
-
-// --- Confirm ---
-
-type confirmModel struct {
-	question     string
-	defaultValue bool
-	value        bool
-	done         bool
-	cancelled    bool
+func (p InteractivePrompter) input() io.Reader {
+	if p.In != nil {
+		return p.In
+	}
+	return os.Stdin
 }
 
-func (m confirmModel) Init() tea.Cmd { return nil }
-
-func (m confirmModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
-	if msg, ok := msg.(tea.KeyMsg); ok {
-		switch msg.String() {
-		case "y", "Y":
-			m.value = true
-			m.done = true
-			return m, tea.Quit
-		case "n", "N":
-			m.value = false
-			m.done = true
-			return m, tea.Quit
-		case "enter":
-			m.value = m.defaultValue
-			m.done = true
-			return m, tea.Quit
-		case "ctrl+c", "q":
-			m.cancelled = true
-			return m, tea.Quit
-		}
+func (p InteractivePrompter) output() io.Writer {
+	if p.Out != nil {
+		return p.Out
 	}
-	return m, nil
+	return os.Stdout
 }
 
-func (m confirmModel) View() string {
-	if m.done {
-		result := "No"
-		if m.value {
-			result = "Yes"
-		}
-		return fmt.Sprintf("%s %s\n", questionStyle.Render(m.question), result)
-	}
+func (p InteractivePrompter) Confirm(ctx context.Context, message string, defaultValue bool) (bool, error) {
 	hint := "[y/N]"
-	if m.defaultValue {
+	if defaultValue {
 		hint = "[Y/n]"
 	}
-	return fmt.Sprintf("%s %s ", questionStyle.Render(m.question), helpStyle.Render(hint))
-}
-
-func (InteractivePrompter) Confirm(_ context.Context, message string, defaultValue bool) (bool, error) {
-	m := confirmModel{question: message, defaultValue: defaultValue}
-	result, err := tea.NewProgram(m).Run()
-	if err != nil {
-		return defaultValue, fmt.Errorf("bubbletea: %w", err)
-	}
-	cm := result.(confirmModel)
-	if cm.cancelled {
-		return defaultValue, context.Canceled
-	}
-	return cm.value, nil
-}
-
-// --- Select ---
-
-type selectModel struct {
-	question string
-	options  []string
-	cursor   int
-	done     bool
-	cancelled bool
-}
-
-func (m selectModel) Init() tea.Cmd { return nil }
-
-func (m selectModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
-	if msg, ok := msg.(tea.KeyMsg); ok {
-		switch msg.String() {
-		case "up", "k":
-			if m.cursor > 0 {
-				m.cursor--
-			}
-		case "down", "j":
-			if m.cursor < len(m.options)-1 {
-				m.cursor++
-			}
-		case "enter":
-			m.done = true
-			return m, tea.Quit
-		case "ctrl+c", "q":
-			m.cancelled = true
-			return m, tea.Quit
+	for {
+		if err := ctx.Err(); err != nil {
+			return defaultValue, err
 		}
-	}
-	return m, nil
-}
-
-func (m selectModel) View() string {
-	if m.done {
-		return fmt.Sprintf("%s %s\n", questionStyle.Render(m.question), m.options[m.cursor])
-	}
-	var b strings.Builder
-	b.WriteString(questionStyle.Render(m.question) + "\n")
-	for i, opt := range m.options {
-		cursor := "  "
-		if i == m.cursor {
-			cursor = cursorStyle.Render("> ")
+		if _, err := fmt.Fprintf(p.output(), "%s %s: ", message, hint); err != nil {
+			return defaultValue, fmt.Errorf("write prompt: %w", err)
+		}
+		line, err := readPromptLine(p.input())
+		if err != nil {
+			return defaultValue, fmt.Errorf("read prompt: %w", err)
+		}
+		switch strings.ToLower(strings.TrimSpace(line)) {
+		case "":
+			return defaultValue, nil
+		case "y", "yes":
+			return true, nil
+		case "n", "no":
+			return false, nil
+		case "q":
+			return defaultValue, context.Canceled
+		default:
+			if _, err := fmt.Fprintln(p.output(), "Please answer yes or no."); err != nil {
+				return defaultValue, fmt.Errorf("write prompt: %w", err)
+			}
 		}
-		b.WriteString(fmt.Sprintf("%s%s\n", cursor, opt))
 	}
-	b.WriteString(helpStyle.Render("↑/↓ navigate • enter select • q quit"))
-	return b.String()
 }
 
-func (InteractivePrompter) Select(_ context.Context, message string, options []string, defaultIndex int) (int, error) {
-	m := selectModel{question: message, options: options, cursor: defaultIndex}
-	result, err := tea.NewProgram(m).Run()
-	if err != nil {
-		return defaultIndex, fmt.Errorf("bubbletea: %w", err)
+func (p InteractivePrompter) Select(ctx context.Context, message string, options []string, defaultIndex int) (int, error) {
+	if len(options) == 0 {
+		return 0, fmt.Errorf("select requires at least one option")
 	}
-	sm := result.(selectModel)
-	if sm.cancelled {
-		return defaultIndex, context.Canceled
+	if defaultIndex < 0 || defaultIndex >= len(options) {
+		return 0, fmt.Errorf("default selection %d is outside 0..%d", defaultIndex, len(options)-1)
 	}
-	return sm.cursor, nil
-}
-
-// --- MultiSelect ---
-
-type multiSelectModel struct {
-	question  string
-	options   []string
-	cursor    int
-	selected  map[int]bool
-	done      bool
-	cancelled bool
-}
-
-func (m multiSelectModel) Init() tea.Cmd { return nil }
-
-func (m multiSelectModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
-	if msg, ok := msg.(tea.KeyMsg); ok {
-		switch msg.String() {
-		case "up", "k":
-			if m.cursor > 0 {
-				m.cursor--
-			}
-		case "down", "j":
-			if m.cursor < len(m.options)-1 {
-				m.cursor++
-			}
-		case " ":
-			m.selected[m.cursor] = !m.selected[m.cursor]
-		case "a":
-			allSelected := true
-			for i := range m.options {
-				if !m.selected[i] {
-					allSelected = false
-					break
-				}
-			}
-			for i := range m.options {
-				m.selected[i] = !allSelected
+	for {
+		if err := ctx.Err(); err != nil {
+			return defaultIndex, err
+		}
+		if _, err := fmt.Fprintln(p.output(), message); err != nil {
+			return defaultIndex, fmt.Errorf("write prompt: %w", err)
+		}
+		for i, option := range options {
+			if _, err := fmt.Fprintf(p.output(), "  %d) %s\n", i+1, option); err != nil {
+				return defaultIndex, fmt.Errorf("write prompt: %w", err)
 			}
-		case "enter":
-			m.done = true
-			return m, tea.Quit
-		case "ctrl+c", "q":
-			m.cancelled = true
-			return m, tea.Quit
+		}
+		if _, err := fmt.Fprintf(p.output(), "Selection [%d]: ", defaultIndex+1); err != nil {
+			return defaultIndex, fmt.Errorf("write prompt: %w", err)
+		}
+		line, err := readPromptLine(p.input())
+		if err != nil {
+			return defaultIndex, fmt.Errorf("read prompt: %w", err)
+		}
+		value := strings.TrimSpace(line)
+		if value == "" {
+			return defaultIndex, nil
+		}
+		if strings.EqualFold(value, "q") {
+			return defaultIndex, context.Canceled
+		}
+		index, err := strconv.Atoi(value)
+		if err == nil && index >= 1 && index <= len(options) {
+			return index - 1, nil
+		}
+		if _, err := fmt.Fprintln(p.output(), "Enter one of the listed numbers."); err != nil {
+			return defaultIndex, fmt.Errorf("write prompt: %w", err)
 		}
 	}
-	return m, nil
 }
 
-func (m multiSelectModel) View() string {
-	if m.done {
-		var selected []string
-		for i, opt := range m.options {
-			if m.selected[i] {
-				selected = append(selected, opt)
-			}
-		}
-		return fmt.Sprintf("%s %s\n", questionStyle.Render(m.question), strings.Join(selected, ", "))
+func (p InteractivePrompter) MultiSelect(ctx context.Context, message string, options []string, defaults []bool) ([]int, error) {
+	if len(defaults) > len(options) {
+		return nil, fmt.Errorf("default selections exceed available options")
 	}
-	var b strings.Builder
-	b.WriteString(questionStyle.Render(m.question) + "\n")
-	for i, opt := range m.options {
-		cursor := "  "
-		if i == m.cursor {
-			cursor = cursorStyle.Render("> ")
+	if err := ctx.Err(); err != nil {
+		return selectedDefaults(defaults), err
+	}
+	if _, err := fmt.Fprintln(p.output(), message); err != nil {
+		return nil, fmt.Errorf("write prompt: %w", err)
+	}
+	for i, option := range options {
+		selected := " "
+		if i < len(defaults) && defaults[i] {
+			selected = "x"
 		}
-		check := "[ ] "
-		if m.selected[i] {
-			check = checkedStyle.Render("[x] ")
+		if _, err := fmt.Fprintf(p.output(), "  %d) [%s] %s\n", i+1, selected, option); err != nil {
+			return nil, fmt.Errorf("write prompt: %w", err)
 		}
-		b.WriteString(fmt.Sprintf("%s%s%s\n", cursor, check, opt))
 	}
-	b.WriteString(helpStyle.Render("↑/↓ navigate • space toggle • a all • enter confirm • q quit"))
-	return b.String()
-}
-
-func (InteractivePrompter) MultiSelect(_ context.Context, message string, options []string, defaults []bool) ([]int, error) {
-	selected := make(map[int]bool)
-	for i, d := range defaults {
-		selected[i] = d
+	if _, err := fmt.Fprint(p.output(), "Selections (comma separated; Enter keeps defaults): "); err != nil {
+		return nil, fmt.Errorf("write prompt: %w", err)
 	}
-	m := multiSelectModel{question: message, options: options, selected: selected}
-	result, err := tea.NewProgram(m).Run()
+	line, err := readPromptLine(p.input())
 	if err != nil {
-		var indices []int
-		for i, d := range defaults {
-			if d {
-				indices = append(indices, i)
-			}
-		}
-		return indices, fmt.Errorf("bubbletea: %w", err)
+		return selectedDefaults(defaults), fmt.Errorf("read prompt: %w", err)
 	}
-	msm := result.(multiSelectModel)
-	if msm.cancelled {
-		var indices []int
-		for i, d := range defaults {
-			if d {
-				indices = append(indices, i)
-			}
-		}
-		return indices, context.Canceled
+	value := strings.TrimSpace(line)
+	if value == "" {
+		return selectedDefaults(defaults), nil
 	}
-	var indices []int
-	for i := range options {
-		if msm.selected[i] {
-			indices = append(indices, i)
-		}
+	if strings.EqualFold(value, "q") {
+		return selectedDefaults(defaults), context.Canceled
 	}
-	return indices, nil
-}
-
-// --- Input ---
-
-type inputModel struct {
-	question     string
-	defaultValue string
-	value        string
-	done         bool
-	cancelled    bool
-}
-
-func (m inputModel) Init() tea.Cmd { return nil }
-
-func (m inputModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
-	if msg, ok := msg.(tea.KeyMsg); ok {
-		switch msg.String() {
-		case "enter":
-			if m.value == "" {
-				m.value = m.defaultValue
-			}
-			m.done = true
-			return m, tea.Quit
-		case "ctrl+c":
-			m.cancelled = true
-			return m, tea.Quit
-		case "backspace":
-			if len(m.value) > 0 {
-				m.value = m.value[:len(m.value)-1]
-			}
-		default:
-			if len(msg.String()) == 1 {
-				m.value += msg.String()
-			}
+	seen := make(map[int]bool)
+	var result []int
+	for _, item := range strings.FieldsFunc(value, func(r rune) bool { return r == ',' || r == ' ' || r == '\t' }) {
+		index, err := strconv.Atoi(item)
+		if err != nil || index < 1 || index > len(options) {
+			return selectedDefaults(defaults), fmt.Errorf("selection %q is not one of 1..%d", item, len(options))
+		}
+		index--
+		if !seen[index] {
+			seen[index] = true
+			result = append(result, index)
 		}
 	}
-	return m, nil
+	return result, nil
 }
 
-func (m inputModel) View() string {
-	if m.done {
-		return fmt.Sprintf("%s %s\n", questionStyle.Render(m.question), m.value)
+func (p InteractivePrompter) Input(ctx context.Context, message string, defaultValue string) (string, error) {
+	if err := ctx.Err(); err != nil {
+		return defaultValue, err
 	}
-	defaultHint := ""
-	if m.defaultValue != "" {
-		defaultHint = helpStyle.Render(fmt.Sprintf(" (%s)", m.defaultValue))
+	suffix := ": "
+	if defaultValue != "" {
+		suffix = fmt.Sprintf(" [%s]: ", defaultValue)
 	}
-	return fmt.Sprintf("%s%s %s", questionStyle.Render(m.question), defaultHint, m.value)
+	if _, err := fmt.Fprint(p.output(), message+suffix); err != nil {
+		return defaultValue, fmt.Errorf("write prompt: %w", err)
+	}
+	line, err := readPromptLine(p.input())
+	if err != nil {
+		return defaultValue, fmt.Errorf("read prompt: %w", err)
+	}
+	value := strings.TrimSpace(line)
+	if value == "" {
+		return defaultValue, nil
+	}
+	return value, nil
 }
 
-func (InteractivePrompter) Input(_ context.Context, message string, defaultValue string) (string, error) {
-	m := inputModel{question: message, defaultValue: defaultValue}
-	result, err := tea.NewProgram(m).Run()
-	if err != nil {
-		return defaultValue, fmt.Errorf("bubbletea: %w", err)
+func selectedDefaults(defaults []bool) []int {
+	var result []int
+	for i, selected := range defaults {
+		if selected {
+			result = append(result, i)
+		}
 	}
-	im := result.(inputModel)
-	if im.cancelled {
-		return defaultValue, context.Canceled
+	return result
+}
+
+// readPromptLine reads exactly through one newline without buffering bytes from
+// the next answer. That matters when several prompts share a pipe or TTY.
+func readPromptLine(reader io.Reader) (string, error) {
+	var result strings.Builder
+	var one [1]byte
+	for {
+		n, err := reader.Read(one[:])
+		if n == 1 {
+			switch one[0] {
+			case '\n':
+				return strings.TrimSuffix(result.String(), "\r"), nil
+			default:
+				result.WriteByte(one[0])
+			}
+		}
+		if err != nil {
+			if err == io.EOF && result.Len() > 0 {
+				return strings.TrimSuffix(result.String(), "\r"), nil
+			}
+			return "", err
+		}
 	}
-	return im.value, nil
 }
diff --git a/internal/adapters/prompter/interactive_test.go b/internal/adapters/prompter/interactive_test.go
new file mode 100644
index 00000000..aa9aca85
--- /dev/null
+++ b/internal/adapters/prompter/interactive_test.go
@@ -0,0 +1,52 @@
+package prompter
+
+import (
+	"bytes"
+	"context"
+	"io"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestInteractivePrompterLineInput(t *testing.T) {
+	t.Parallel()
+
+	var out bytes.Buffer
+	prompt := InteractivePrompter{In: strings.NewReader("maybe\nyes\ncustom\n"), Out: &out}
+
+	confirmed, err := prompt.Confirm(t.Context(), "Continue?", false)
+	require.NoError(t, err)
+	assert.True(t, confirmed)
+	value, err := prompt.Input(t.Context(), "Module", "fallback")
+	require.NoError(t, err)
+	assert.Equal(t, "custom", value)
+	assert.Contains(t, out.String(), "Please answer yes or no.")
+	assert.NotContains(t, out.String(), "\x1b")
+}
+
+func TestInteractivePrompterCancellationAndEOF(t *testing.T) {
+	t.Parallel()
+
+	_, err := (InteractivePrompter{In: strings.NewReader("q\n"), Out: &bytes.Buffer{}}).Confirm(t.Context(), "Continue?", true)
+	require.ErrorIs(t, err, context.Canceled)
+
+	_, err = (InteractivePrompter{In: strings.NewReader(""), Out: &bytes.Buffer{}}).Input(t.Context(), "Module", "")
+	require.ErrorIs(t, err, io.EOF)
+}
+
+func TestInteractivePrompterSelections(t *testing.T) {
+	t.Parallel()
+
+	var out bytes.Buffer
+	prompt := InteractivePrompter{In: strings.NewReader("2\n1,3\n"), Out: &out}
+	selected, err := prompt.Select(t.Context(), "Pick", []string{"one", "two", "three"}, 0)
+	require.NoError(t, err)
+	assert.Equal(t, 1, selected)
+	multi, err := prompt.MultiSelect(t.Context(), "Pick many", []string{"one", "two", "three"}, nil)
+	require.NoError(t, err)
+	assert.Equal(t, []int{0, 2}, multi)
+	assert.NotContains(t, out.String(), "\x1b")
+}
diff --git a/internal/adapters/repository/git/archive.go b/internal/adapters/repository/git/archive.go
deleted file mode 100644
index 3898082a..00000000
--- a/internal/adapters/repository/git/archive.go
+++ /dev/null
@@ -1,22 +0,0 @@
-package git
-
-import (
-	"context"
-	"fmt"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-func (r *gitRepo) Archive(
-	ctx context.Context, revision models.Revision, archiveFilePath string,
-) error {
-	params := []string{
-		"archive", "--format=zip", revision.CommitHash, "-o", archiveFilePath, "*.proto",
-	}
-
-	if _, err := r.console.RunCmd(ctx, r.cacheDir, "git", params...); err != nil {
-		return fmt.Errorf("utils.RunCmd: %w", err)
-	}
-
-	return nil
-}
diff --git a/internal/adapters/repository/git/fetch.go b/internal/adapters/repository/git/fetch.go
deleted file mode 100644
index 75a47139..00000000
--- a/internal/adapters/repository/git/fetch.go
+++ /dev/null
@@ -1,16 +0,0 @@
-package git
-
-import (
-	"context"
-	"fmt"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-func (r *gitRepo) Fetch(ctx context.Context, revision models.Revision) error {
-	if err := r.fetchCommit(ctx, revision.CommitHash); err != nil {
-		return fmt.Errorf("r.fetchCommit: %w", err)
-	}
-
-	return nil
-}
diff --git a/internal/adapters/repository/git/get_files.go b/internal/adapters/repository/git/get_files.go
deleted file mode 100644
index 4e4fd093..00000000
--- a/internal/adapters/repository/git/get_files.go
+++ /dev/null
@@ -1,35 +0,0 @@
-package git
-
-import (
-	"context"
-	"fmt"
-	"strings"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-func (r *gitRepo) GetFiles(ctx context.Context, revision models.Revision, dirs ...string) ([]string, error) {
-	params := []string{
-		"ls-tree", "-r", revision.CommitHash,
-	}
-	params = append(params, dirs...)
-	res, err := r.console.RunCmd(ctx, r.cacheDir, "git", params...)
-	if err != nil {
-		return nil, fmt.Errorf("utils.RunCmd: %w", err)
-	}
-
-	stats := strings.Split(res, "\n")
-
-	files := make([]string, 0, len(stats))
-	for _, stat := range stats {
-		stat := stat
-		s := strings.Fields(stat)
-		if len(s) != 4 {
-			// TODO: write debug log that len is wrong
-			continue
-		}
-		files = append(files, s[3])
-	}
-
-	return files, nil
-}
diff --git a/internal/adapters/repository/git/git.go b/internal/adapters/repository/git/git.go
deleted file mode 100644
index 7037d157..00000000
--- a/internal/adapters/repository/git/git.go
+++ /dev/null
@@ -1,205 +0,0 @@
-package git
-
-import (
-	"context"
-	"fmt"
-	"io"
-	"os"
-	"path/filepath"
-	"strings"
-
-	"github.com/easyp-tech/easyp/internal/adapters/repository"
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-var _ repository.Repo = (*gitRepo)(nil)
-
-// gitRepo implements repository.Repo interface
-type gitRepo struct {
-	// remoteURL full repository remoteURL address with schema
-	remoteURL string
-	// cacheDir local cache directory for store repository
-	cacheDir string
-	// console for call external commands
-	console Console
-}
-
-const (
-	// for omitted package version. HEAD is git key word.
-	gitLatestVersionRef = "HEAD"
-	// tag prefix on output of ls-remote command
-	gitRefsTagPrefix = "refs/tags/"
-	// branch name prefix in output of ls-remote commanf
-	gitRefsBranchPrefix = "refs/heads/"
-)
-
-// Some links from go mod:
-// cmd/go/internal/modfetch/codehost/git.go:65 - create work dir
-// cmd/go/internal/modfetch/codehost/git.go:137 - git's struct
-
-// Console temporary interface for console commands, must be replaced from core.Console.
-type Console interface {
-	RunCmd(ctx context.Context, dir string, command string, commandParams ...string) (string, error)
-	RunCmdWithStdin(ctx context.Context, dir string, stdin io.Reader, command string, commandParams ...string) (string, error)
-}
-
-// New returns gitRepo instance
-// remote: full remoteURL address without schema
-func New(ctx context.Context, remote string, cacheDir string, console Console) (repository.Repo, error) {
-	r := &gitRepo{
-		remoteURL: getRemote(remote),
-		cacheDir:  cacheDir,
-		console:   console,
-	}
-
-	if _, err := os.Stat(filepath.Join(r.cacheDir, "objects")); err == nil {
-		// repo is already exists
-		return r, nil
-	}
-
-	if _, err := r.console.RunCmd(ctx, r.cacheDir, "git", "init", "--bare"); err != nil {
-		return nil, fmt.Errorf("adapters.RunCmd (init): %w", err)
-	}
-
-	_, err := r.console.RunCmd(ctx, r.cacheDir, "git", "remote", "add", "origin", r.remoteURL)
-	if err != nil {
-		return nil, fmt.Errorf("adapters.RunCmd (add origin): %w", err)
-	}
-
-	return r, nil
-}
-
-func getRemote(name string) string {
-	return "https://" + name
-}
-
-// getCommitDatetime returns datetime of commit
-// NOTE: the commit has to be fetched!
-func (r *gitRepo) getCommitDatetime(ctx context.Context, commitHash string) (string, error) {
-	var lines []string
-
-	commitDatetime, err := r.console.RunCmd(
-		ctx,
-		r.cacheDir,
-		"git",
-		"log", "-1",
-		"--pretty=%ad", "--date=format:%Y%m%d%H%M%S",
-		commitHash,
-	)
-	if err != nil {
-		return "", fmt.Errorf("r.console.RunCmd: %w", err)
-	}
-
-	// got commit hash from result
-	lines = strings.Split(commitDatetime, "\n")
-	if len(lines) == 0 {
-		return "", fmt.Errorf("invalid lines of git log: %s", commitDatetime)
-	}
-	parts := strings.Fields(lines[0])
-	if len(parts) != 1 {
-		return "", fmt.Errorf("invalid parts of git log: %s", commitDatetime)
-	}
-
-	return parts[0], nil
-}
-
-func (r *gitRepo) fetchCommit(ctx context.Context, commitHash string) error {
-	_, err := r.console.RunCmd(
-		ctx, r.cacheDir, "git", "fetch", "-f", "origin", "--depth=1", commitHash,
-	)
-	if err != nil {
-		return fmt.Errorf("r.console.RunCmd: %w", err)
-	}
-
-	return nil
-}
-
-func (r *gitRepo) lsRemote(ctx context.Context, args ...string) ([]string, error) {
-	res, err := r.console.RunCmd(
-		ctx,
-		r.cacheDir,
-		"git",
-		append([]string{"ls-remote", "origin"}, args...)...,
-	)
-
-	if err != nil {
-		return nil, fmt.Errorf("r.console.RunCmd: %w", err)
-	}
-
-	return strings.Split(res, "\n"), nil
-}
-
-// return empty string if git tag was not found
-func (r *gitRepo) getTagByCommit(ctx context.Context, commitHash string) (string, error) {
-	res, err := r.lsRemote(ctx)
-	if err != nil {
-		return "", fmt.Errorf("r.lsRemote: %w", err)
-	}
-
-	gitTag := ""
-
-	for _, lsOut := range res {
-		rev := strings.Fields(lsOut)
-
-		if len(rev) != 2 {
-			continue
-		}
-
-		if rev[0] == commitHash && strings.HasPrefix(rev[1], gitRefsTagPrefix) {
-			gitTag = strings.TrimPrefix(rev[1], gitRefsTagPrefix)
-			break
-		}
-	}
-
-	return gitTag, nil
-}
-
-// look for hash of commit by passed git tag
-func (r *gitRepo) getCommitByTag(ctx context.Context, gitTag string) (string, error) {
-	res, err := r.lsRemote(ctx, gitTag)
-	if err != nil {
-		return "", models.ErrVersionNotFound
-	}
-
-	commitHash := ""
-
-	for _, lsOut := range res {
-		rev := strings.Fields(lsOut)
-		if len(rev) != 2 {
-			continue
-		}
-
-		if strings.HasPrefix(rev[1], gitRefsTagPrefix) &&
-			strings.TrimPrefix(rev[1], gitRefsTagPrefix) == gitTag {
-			commitHash = rev[0]
-			break
-		}
-	}
-
-	return commitHash, nil
-}
-
-// look for hash of commit by passed git tag
-func (r *gitRepo) getCommitByBranchName(ctx context.Context, branchName string) (string, error) {
-	res, err := r.lsRemote(ctx, branchName)
-	if err != nil {
-		return "", models.ErrVersionNotFound
-	}
-
-	commitHash := ""
-
-	for _, lsOut := range res {
-		rev := strings.Fields(lsOut)
-		if len(rev) != 2 {
-			continue
-		}
-
-		if strings.HasPrefix(rev[1], gitRefsBranchPrefix) &&
-			strings.TrimPrefix(rev[1], gitRefsBranchPrefix) == branchName {
-			commitHash = rev[0]
-			break
-		}
-	}
-
-	return commitHash, nil
-}
diff --git a/internal/adapters/repository/git/read_file.go b/internal/adapters/repository/git/read_file.go
deleted file mode 100644
index 46a06a07..00000000
--- a/internal/adapters/repository/git/read_file.go
+++ /dev/null
@@ -1,22 +0,0 @@
-package git
-
-import (
-	"context"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-func (r *gitRepo) ReadFile(ctx context.Context, revision models.Revision, fileName string) (string, error) {
-	// g cat-file -p 8074ae2f42417345ef103d83fb62e4245010715d:buf.work.yaml
-	fileRequest := revision.CommitHash + ":" + fileName
-	content, err := r.console.RunCmd(
-		ctx, r.cacheDir, "git", "cat-file", "-p", fileRequest,
-	)
-	if err != nil {
-		// It's too dificult to parse stderr from git
-		// so decided that there is no file in that case
-		return "", models.ErrFileNotFound
-	}
-
-	return content, nil
-}
diff --git a/internal/adapters/repository/git/read_revision.go b/internal/adapters/repository/git/read_revision.go
deleted file mode 100644
index d2029fb0..00000000
--- a/internal/adapters/repository/git/read_revision.go
+++ /dev/null
@@ -1,224 +0,0 @@
-package git
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"strings"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-type revisionParts struct {
-	CommitHash string
-	Version    string
-}
-
-// ReadRevision read actual revision from remote repository
-// Cases:
-//  1. requestedVersion is git tag: just get commit with this tag
-//  2. requestedVersion is omitted: get the latest commit, try to read its tag
-//     if tag does not exist generate version
-//  3. requestedVersion is generated: get commit from its version
-func (r *gitRepo) ReadRevision(ctx context.Context, requestedVersion models.RequestedVersion) (models.Revision, error) {
-	var revParts revisionParts
-	var err error
-
-	switch {
-	case requestedVersion.IsGenerated():
-		revParts, err = r.readRevisionByGeneratedVersion(ctx, requestedVersion)
-		if err != nil {
-			return models.Revision{}, fmt.Errorf("r.readRevisionByGeneratedVersion: %w", err)
-		}
-	case requestedVersion.IsOmitted():
-		revParts, err = r.readRevisionForLatestCommit(ctx)
-		if err != nil {
-			return models.Revision{}, fmt.Errorf("r.readRevisionForLatestCommit: %w", err)
-		}
-	default:
-		// in other case use readRevisionByGitTagVersion
-		revParts, err = r.readRevisionByVersion(ctx, requestedVersion)
-		if err != nil {
-			return models.Revision{}, fmt.Errorf("r.readRevisionByGitTagVersion: %w", err)
-		}
-	}
-
-	if revParts.CommitHash == "" {
-		return models.Revision{}, models.ErrVersionNotFound
-	}
-
-	revision := models.Revision{
-		CommitHash: revParts.CommitHash,
-		Version:    revParts.Version,
-	}
-
-	return revision, nil
-}
-
-// readRevisionByVersion read revision by passed version
-// order of resolving:
-// 1. try to read as git tag
-// 2. try to read as commit's hash
-// 3. return not found error
-func (r *gitRepo) readRevisionByVersion(
-	ctx context.Context, requestedVersion models.RequestedVersion,
-) (revisionParts, error) {
-	revParts, err := r.readRevisionByGitTagVersion(ctx, requestedVersion)
-	if err == nil {
-		return revParts, nil
-	}
-
-	if !errors.Is(err, models.ErrVersionNotFound) {
-		return revisionParts{}, fmt.Errorf("r.readRevisionByGitTagVersion: %w", err)
-	}
-
-	revParts, err = r.readRevisionByBranchName(ctx, requestedVersion)
-	if err == nil {
-		return revParts, nil
-	}
-
-	if !errors.Is(err, models.ErrVersionNotFound) {
-		return revisionParts{}, fmt.Errorf("r.readRevisionByBranchName: %w", err)
-	}
-
-	revParts, err = r.readRevisionByCommitHash(ctx, string(requestedVersion))
-	if err != nil {
-		return revisionParts{}, fmt.Errorf("r.readRevisionByCommitHash: %w", err)
-	}
-
-	return revParts, nil
-}
-
-// readRevisionByGitTagVersion read revision by passed git tag
-// tag has to be on the remote repository
-func (r *gitRepo) readRevisionByGitTagVersion(
-	ctx context.Context, requestedVersion models.RequestedVersion,
-) (revisionParts, error) {
-	gitTagVersion := string(requestedVersion)
-
-	commitHash, err := r.getCommitByTag(ctx, gitTagVersion)
-	if err != nil {
-		return revisionParts{}, fmt.Errorf("r.getCommitByTag: %w", err)
-	}
-
-	if commitHash == "" {
-		return revisionParts{}, models.ErrVersionNotFound
-	}
-
-	parts := revisionParts{
-		CommitHash: commitHash,
-		Version:    gitTagVersion,
-	}
-
-	return parts, nil
-}
-
-// readRevisionByBranchName read revision by passed ranch name
-// branch has to be on the remote repository
-func (r *gitRepo) readRevisionByBranchName(
-	ctx context.Context, requestedVersion models.RequestedVersion,
-) (revisionParts, error) {
-	branchName := string(requestedVersion)
-
-	commitHash, err := r.getCommitByBranchName(ctx, branchName)
-	if err != nil {
-		return revisionParts{}, fmt.Errorf("r.getCommitByBranchName: %w", err)
-	}
-
-	if commitHash == "" {
-		return revisionParts{}, models.ErrVersionNotFound
-	}
-
-	return r.readRevisionByCommitHash(ctx, commitHash)
-}
-
-// readRevisionByCommitHash read revision by passed hash of commit
-func (r *gitRepo) readRevisionByCommitHash(
-	ctx context.Context, commitHash string,
-) (revisionParts, error) {
-	// try to fetch commit
-	if err := r.fetchCommit(ctx, commitHash); err != nil {
-		return revisionParts{}, fmt.Errorf("r.fetchCommit: %w", models.ErrVersionNotFound)
-	}
-
-	gitTag, err := r.getTagByCommit(ctx, commitHash)
-	if err != nil {
-		return revisionParts{}, fmt.Errorf("r.getTagByCommit: %w", err)
-	}
-
-	if gitTag != "" {
-		return revisionParts{
-			CommitHash: commitHash,
-			Version:    gitTag,
-		}, nil
-	}
-
-	// didn't find tag for this commit, so generate version
-
-	commitDatetime, err := r.getCommitDatetime(ctx, commitHash)
-	if err != nil {
-		return revisionParts{}, fmt.Errorf("r.getCommitDatetime: %w", err)
-	}
-
-	generatedVersion := models.GeneratedVersionParts{
-		Datetime:   commitDatetime,
-		CommitHash: commitHash,
-	}
-
-	revParts := revisionParts{
-		CommitHash: commitHash,
-		Version:    generatedVersion.GetVersionString(),
-	}
-	return revParts, nil
-}
-
-// readRevisionForLatestCommit read the latest commit
-// if tag for this commit exists use its as revision's version
-// otherwise generate version
-func (r *gitRepo) readRevisionForLatestCommit(
-	ctx context.Context,
-) (revisionParts, error) {
-	lines, err := r.lsRemote(ctx, gitLatestVersionRef)
-	if err != nil {
-		return revisionParts{}, models.ErrVersionNotFound
-	}
-
-	// got commit hash from result
-	if len(lines) == 0 {
-		return revisionParts{}, fmt.Errorf("invalid lines of git info: %s", lines)
-	}
-	parts := strings.Fields(lines[0])
-	if len(parts) != 2 {
-		return revisionParts{}, fmt.Errorf("invalid parts of git info: %s", lines)
-	}
-
-	headCommitHash := parts[0]
-
-	revParts, err := r.readRevisionByCommitHash(ctx, headCommitHash)
-	if err != nil {
-		return revisionParts{}, fmt.Errorf("r.readRevisionByCommitHash: %w", err)
-	}
-
-	return revParts, nil
-}
-
-// readRevisionByGeneratedVersion check if commit in generated version exists
-func (r *gitRepo) readRevisionByGeneratedVersion(
-	ctx context.Context, requestedVersion models.RequestedVersion,
-) (revisionParts, error) {
-	generatedParts, err := requestedVersion.GetParts()
-	if err != nil {
-		return revisionParts{}, fmt.Errorf("requestedVersion.GetParts: %w", err)
-	}
-
-	// fetch by passed commit hash
-	if err := r.fetchCommit(ctx, generatedParts.CommitHash); err != nil {
-		return revisionParts{}, fmt.Errorf("r.fetchCommit: %w", err)
-	}
-
-	parts := revisionParts{
-		CommitHash: generatedParts.CommitHash,
-		Version:    string(requestedVersion),
-	}
-	return parts, nil
-}
diff --git a/internal/adapters/repository/repository.go b/internal/adapters/repository/repository.go
deleted file mode 100644
index 69d59c47..00000000
--- a/internal/adapters/repository/repository.go
+++ /dev/null
@@ -1,27 +0,0 @@
-package repository
-
-import (
-	"context"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-type Repo interface {
-	// GetFiles returns list of all files in repository
-	GetFiles(ctx context.Context, revision models.Revision, dirs ...string) ([]string, error)
-
-	// ReadFile returns file's content from repository
-	ReadFile(ctx context.Context, revision models.Revision, fileName string) (string, error)
-
-	// Archive passed storage to archive and return full path to archive
-	Archive(
-		ctx context.Context, revision models.Revision, archiveFilePath string,
-	) error
-
-	// ReadRevision reads commit's revision by passed version
-	// or return the latest commit if version is empty
-	ReadRevision(ctx context.Context, requestedVersion models.RequestedVersion) (models.Revision, error)
-
-	// Fetch from remote repository specified version
-	Fetch(ctx context.Context, revision models.Revision) error
-}
diff --git a/internal/adapters/storage/cache_download.go b/internal/adapters/storage/cache_download.go
deleted file mode 100644
index 93411697..00000000
--- a/internal/adapters/storage/cache_download.go
+++ /dev/null
@@ -1,18 +0,0 @@
-package storage
-
-import (
-	"fmt"
-	"os"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-// CacheDownload create path to downloaded cache.
-// Like $GOPATH/pkg/mod/cache/download
-func (s *Storage) CreateCacheDownloadDir(cacheDownloadPaths models.CacheDownloadPaths) error {
-	if err := os.MkdirAll(cacheDownloadPaths.CacheDownloadDir, dirPerm); err != nil {
-		return fmt.Errorf("os.MkdirAll: %w", err)
-	}
-
-	return nil
-}
diff --git a/internal/adapters/storage/create_cache_repository_dir.go b/internal/adapters/storage/create_cache_repository_dir.go
deleted file mode 100644
index d994be68..00000000
--- a/internal/adapters/storage/create_cache_repository_dir.go
+++ /dev/null
@@ -1,21 +0,0 @@
-package storage
-
-import (
-	"crypto/sha256"
-	"fmt"
-	"os"
-	"path/filepath"
-)
-
-// CacheDir create and return path to cache dir.
-// cache dir contains repository cache for repository with proto files.
-// cmd/go/internal/modfetch/codehost/codehost.go: 228 - create workdir
-func (s *Storage) CreateCacheRepositoryDir(name string) (string, error) {
-	cacheDir := filepath.Join(s.rootDir, cacheDir, fmt.Sprintf("%x", sha256.Sum256([]byte(name))))
-
-	if err := os.MkdirAll(cacheDir, dirPerm); err != nil {
-		return "", fmt.Errorf("os.MkdirAll: %w", err)
-	}
-
-	return cacheDir, nil
-}
diff --git a/internal/adapters/storage/get_cache_download_paths.go b/internal/adapters/storage/get_cache_download_paths.go
deleted file mode 100644
index 16d0fd6e..00000000
--- a/internal/adapters/storage/get_cache_download_paths.go
+++ /dev/null
@@ -1,23 +0,0 @@
-package storage
-
-import (
-	"path/filepath"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-// GetDownloadArchivePath returns full path to download archive (include extension)
-func (s *Storage) GetCacheDownloadPaths(moduleName, version string) models.CacheDownloadPaths {
-	cacheDownloadDir := filepath.Join(s.rootDir, cacheDir, cacheDownloadDir, moduleName)
-
-	fileName := sanitizePath(version)
-
-	archiveFile := filepath.Join(cacheDownloadDir, fileName) + ".zip"
-	moduleInfoFile := filepath.Join(cacheDownloadDir, fileName) + ".info"
-
-	return models.CacheDownloadPaths{
-		CacheDownloadDir: cacheDownloadDir,
-		ArchiveFile:      archiveFile,
-		ModuleInfoFile:   moduleInfoFile,
-	}
-}
diff --git a/internal/adapters/storage/get_cache_download_paths_test.go b/internal/adapters/storage/get_cache_download_paths_test.go
deleted file mode 100644
index 7ac5b777..00000000
--- a/internal/adapters/storage/get_cache_download_paths_test.go
+++ /dev/null
@@ -1,21 +0,0 @@
-package storage
-
-import (
-	"path/filepath"
-)
-
-func (s *storageSuite) Test_GetCacheDownloadPaths() {
-	module := getFakeModule()
-	revision := getFakeRevision()
-
-	// ref values
-	expectedCacheDownloadDir := filepath.Join(s.rootDir, cacheDir, cacheDownloadDir, module.Name)
-	expectedArchiveFile := filepath.Join(expectedCacheDownloadDir, revision.Version) + ".zip"
-	expectedModuleInfoFile := filepath.Join(expectedCacheDownloadDir, revision.Version) + ".info"
-
-	res := s.storage.GetCacheDownloadPaths(module.Name, revision.Version)
-
-	s.Equal(expectedCacheDownloadDir, res.CacheDownloadDir)
-	s.Equal(expectedArchiveFile, res.ArchiveFile)
-	s.Equal(expectedModuleInfoFile, res.ModuleInfoFile)
-}
diff --git a/internal/adapters/storage/get_install_dir.go b/internal/adapters/storage/get_install_dir.go
deleted file mode 100644
index 2753b4dc..00000000
--- a/internal/adapters/storage/get_install_dir.go
+++ /dev/null
@@ -1,13 +0,0 @@
-package storage
-
-import (
-	"path/filepath"
-)
-
-// getInstallDir returns dir to install package
-// rootDir + installedDir + module full remote path + module's version
-// eg: ~/.EASYP/mod/github.com/google/googleapis/v1.2.3
-func (s *Storage) GetInstallDir(moduleName string, version string) string {
-	version = sanitizePath(version)
-	return filepath.Join(s.rootDir, installedDir, moduleName, version)
-}
diff --git a/internal/adapters/storage/get_install_dir_test.go b/internal/adapters/storage/get_install_dir_test.go
deleted file mode 100644
index a41ab7ba..00000000
--- a/internal/adapters/storage/get_install_dir_test.go
+++ /dev/null
@@ -1,15 +0,0 @@
-package storage
-
-import (
-	"path/filepath"
-)
-
-func (s *storageSuite) Test_GetInstallDir() {
-	moduleName := getFakeModule().Name
-	version := getFakeRevision().Version
-
-	expectedResult := filepath.Join(s.rootDir, installedDir, moduleName, version)
-
-	res := s.storage.GetInstallDir(moduleName, version)
-	s.Equal(expectedResult, res)
-}
diff --git a/internal/adapters/storage/get_installed_module_hash.go b/internal/adapters/storage/get_installed_module_hash.go
deleted file mode 100644
index 6bf34dc6..00000000
--- a/internal/adapters/storage/get_installed_module_hash.go
+++ /dev/null
@@ -1,24 +0,0 @@
-package storage
-
-import (
-	"fmt"
-	"os"
-
-	"golang.org/x/mod/sumdb/dirhash"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-func (s *Storage) GetInstalledModuleHash(moduleName string, revisionVersion string) (models.ModuleHash, error) {
-	installedDirPath := s.GetInstallDir(moduleName, revisionVersion)
-	installedPackageHash, err := dirhash.HashDir(installedDirPath, "", dirhash.DefaultHash)
-	if err != nil {
-		if os.IsNotExist(err) {
-			return "", models.ErrModuleNotInstalled
-		}
-
-		return "", fmt.Errorf("dirhash.HashDir: %w", err)
-	}
-
-	return models.ModuleHash(installedPackageHash), nil
-}
diff --git a/internal/adapters/storage/install.go b/internal/adapters/storage/install.go
deleted file mode 100644
index b35ebe2f..00000000
--- a/internal/adapters/storage/install.go
+++ /dev/null
@@ -1,231 +0,0 @@
-package storage
-
-import (
-	"context"
-	"fmt"
-	"io"
-	"log/slog"
-	"os"
-	"path/filepath"
-	"strings"
-
-	"github.com/codeclysm/extract/v3"
-	"golang.org/x/mod/sumdb/dirhash"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-func (s *Storage) Install(
-	ctx context.Context,
-	cacheDownloadPaths models.CacheDownloadPaths,
-	module models.Module,
-	revision models.Revision,
-	moduleConfig models.ModuleConfig,
-) (models.ModuleHash, error) {
-	s.logger.Info(
-		ctx,
-		"Install package",
-		slog.String("package", module.Name),
-		slog.String("version", revision.Version),
-		slog.String("commit", revision.CommitHash),
-	)
-
-	version := sanitizePath(revision.Version)
-	installedDirPath := s.GetInstallDir(module.Name, version)
-
-	fp, err := os.Open(cacheDownloadPaths.ArchiveFile)
-	if err != nil {
-		return "", fmt.Errorf("os.Open: %w", err)
-	}
-	defer func() { _ = fp.Close() }()
-
-	tempExtractDir, err := os.MkdirTemp("", "easyp-extract-*")
-	if err != nil {
-		return "", fmt.Errorf("os.MkdirTemp extract: %w", err)
-	}
-	defer os.RemoveAll(tempExtractDir)
-
-	s.logger.Debug(ctx, "Extracting archive to temp dir", slog.String("tempExtractDir", tempExtractDir))
-
-	if err := extract.Archive(ctx, fp, tempExtractDir, nil); err != nil {
-		return "", fmt.Errorf("extract.Archive: %w", err)
-	}
-
-	parentDir := filepath.Dir(installedDirPath)
-	if err := os.MkdirAll(parentDir, dirPerm); err != nil {
-		return "", fmt.Errorf("os.MkdirAll parent: %w", err)
-	}
-
-	tempInstallDir, err := os.MkdirTemp(parentDir, "easyp-install-*")
-	if err != nil {
-		return "", fmt.Errorf("os.MkdirTemp install: %w", err)
-	}
-	defer os.RemoveAll(tempInstallDir)
-
-	if err := os.Chmod(tempInstallDir, dirPerm); err != nil {
-		return "", fmt.Errorf("os.Chmod tempInstallDir: %w", err)
-	}
-
-	renamer := getRenamer(moduleConfig)
-
-	if err := buildInstallTree(tempExtractDir, tempInstallDir, renamer); err != nil {
-		return "", fmt.Errorf("buildInstallTree: %w", err)
-	}
-
-	installedPackageHash, err := dirhash.HashDir(tempInstallDir, "", dirhash.DefaultHash)
-	if err != nil {
-		return "", fmt.Errorf("dirhash.HashDir: %w", err)
-	}
-
-	var backupPath string
-	if _, err := os.Stat(installedDirPath); err != nil {
-		if !os.IsNotExist(err) {
-			return "", fmt.Errorf("os.Stat installed dir: %w", err)
-		}
-	} else {
-		backupPath, err = os.MkdirTemp(parentDir, "easyp-backup-*")
-		if err != nil {
-			return "", fmt.Errorf("os.MkdirTemp backup: %w", err)
-		}
-		if err := os.RemoveAll(backupPath); err != nil {
-			return "", fmt.Errorf("os.RemoveAll backup: %w", err)
-		}
-		if err := os.Rename(installedDirPath, backupPath); err != nil {
-			return "", fmt.Errorf("os.Rename backup: %w", err)
-		}
-	}
-
-	if err := os.Rename(tempInstallDir, installedDirPath); err != nil {
-		if backupPath != "" {
-			_ = os.Rename(backupPath, installedDirPath)
-		}
-		return "", fmt.Errorf("os.Rename: %w", err)
-	}
-
-	if backupPath != "" {
-		_ = os.RemoveAll(backupPath)
-	}
-
-	return models.ModuleHash(installedPackageHash), nil
-}
-
-func buildInstallTree(srcDir, dstDir string, renamer func(string) string) error {
-	return filepath.Walk(srcDir, func(srcPath string, info os.FileInfo, err error) error {
-		if err != nil {
-			return err
-		}
-
-		relPath, err := filepath.Rel(srcDir, srcPath)
-		if err != nil {
-			return fmt.Errorf("filepath.Rel: %w", err)
-		}
-
-		if relPath == "." {
-			return nil
-		}
-
-		relPath = filepath.ToSlash(relPath)
-
-		rewrittenRel := renamer(relPath)
-		if rewrittenRel == "" {
-			if info.IsDir() {
-				return filepath.SkipDir
-			}
-			return nil
-		}
-
-		dstPath := filepath.Join(dstDir, filepath.FromSlash(rewrittenRel))
-
-		if info.IsDir() {
-			return os.MkdirAll(dstPath, info.Mode().Perm()|0700)
-		}
-
-		if info.Mode()&os.ModeSymlink != 0 {
-			return rewriteSymlink(srcPath, srcDir, dstPath, dstDir, renamer)
-		}
-
-		return copyFile(srcPath, dstPath, info.Mode())
-	})
-}
-
-func rewriteSymlink(srcPath, srcDir, dstPath, dstDir string, renamer func(string) string) error {
-	target, err := os.Readlink(srcPath)
-	if err != nil {
-		return fmt.Errorf("os.Readlink %s: %w", srcPath, err)
-	}
-
-	if filepath.IsAbs(target) {
-		return fmt.Errorf("absolute symlink target not allowed: %s -> %s", srcPath, target)
-	}
-
-	linkDir := filepath.Dir(srcPath)
-	resolvedTarget := filepath.Join(linkDir, target)
-	resolvedTarget, err = filepath.Abs(resolvedTarget)
-	if err != nil {
-		return fmt.Errorf("filepath.Abs: %w", err)
-	}
-
-	relFromSrcDir, err := filepath.Rel(srcDir, resolvedTarget)
-	if err != nil {
-		return fmt.Errorf("filepath.Rel resolved: %w", err)
-	}
-
-	clean := relFromSrcDir == ".." || strings.HasPrefix(relFromSrcDir, ".."+string(os.PathSeparator))
-	if clean {
-		return fmt.Errorf("symlink target escapes source tree: %s -> %s", srcPath, target)
-	}
-
-	relFromSrcDir = filepath.ToSlash(relFromSrcDir)
-	rewrittenTarget := renamer(relFromSrcDir)
-	if rewrittenTarget == "" {
-		return nil
-	}
-
-	dstLinkDir := filepath.Dir(dstPath)
-	if err := os.MkdirAll(dstLinkDir, dirPerm); err != nil {
-		return fmt.Errorf("os.MkdirAll symlink parent: %w", err)
-	}
-	newTarget, err := filepath.Rel(dstLinkDir, filepath.Join(dstDir, filepath.FromSlash(rewrittenTarget)))
-	if err != nil {
-		return fmt.Errorf("filepath.Rel new target: %w", err)
-	}
-
-	return os.Symlink(newTarget, dstPath)
-}
-
-func copyFile(srcPath, dstPath string, mode os.FileMode) error {
-	if err := os.MkdirAll(filepath.Dir(dstPath), dirPerm); err != nil {
-		return fmt.Errorf("os.MkdirAll: %w", err)
-	}
-
-	src, err := os.Open(srcPath)
-	if err != nil {
-		return fmt.Errorf("os.Open src: %w", err)
-	}
-	defer src.Close()
-
-	dst, err := os.OpenFile(dstPath, os.O_CREATE|os.O_WRONLY|os.O_TRUNC, mode)
-	if err != nil {
-		return fmt.Errorf("os.OpenFile dst: %w", err)
-	}
-	defer dst.Close()
-
-	if _, err := io.Copy(dst, src); err != nil {
-		return fmt.Errorf("io.Copy: %w", err)
-	}
-
-	return nil
-}
-
-func getRenamer(moduleConfig models.ModuleConfig) func(string) string {
-	return func(file string) string {
-		for _, dir := range moduleConfig.Directories {
-			dir := dir + "/"
-
-			if strings.HasPrefix(file, dir) {
-				return strings.TrimPrefix(file, dir)
-			}
-		}
-		return file
-	}
-}
diff --git a/internal/adapters/storage/install_test.go b/internal/adapters/storage/install_test.go
deleted file mode 100644
index 1bd514ec..00000000
--- a/internal/adapters/storage/install_test.go
+++ /dev/null
@@ -1,217 +0,0 @@
-package storage
-
-import (
-	"os"
-	"path/filepath"
-	"runtime"
-	"strings"
-	"testing"
-
-	"github.com/stretchr/testify/require"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-func TestGetRenamer(t *testing.T) {
-	tests := map[string]struct {
-		moduleConfig   models.ModuleConfig
-		passedFile     string
-		expectedResult string
-	}{
-		"directories are empty": {
-			moduleConfig: models.ModuleConfig{
-				Directories: nil,
-			},
-			passedFile:     "proto/file.proto",
-			expectedResult: "proto/file.proto",
-		},
-		"directories contain one dir": {
-			moduleConfig: models.ModuleConfig{
-				Directories: []string{"proto/protovalidate"},
-			},
-			passedFile:     "proto/protovalidate/buf/validate/validate.proto",
-			expectedResult: "buf/validate/validate.proto",
-		},
-		"directories contain several dirs": {
-			moduleConfig: models.ModuleConfig{
-				Directories: []string{"proto/protovalidate", "proto/protovalidate-testing"},
-			},
-			passedFile:     "proto/protovalidate/buf/validate/validate.proto",
-			expectedResult: "buf/validate/validate.proto",
-		},
-	}
-
-	for name, tc := range tests {
-		name, tc := name, tc
-		t.Run(name, func(t *testing.T) {
-			renamer := getRenamer(tc.moduleConfig)
-			result := renamer(tc.passedFile)
-			require.Equal(t, tc.expectedResult, result)
-		})
-	}
-}
-
-func TestBuildInstallTree_RegularFiles(t *testing.T) {
-	srcDir := t.TempDir()
-	dstDir := t.TempDir()
-
-	renamer := getRenamer(models.ModuleConfig{
-		Directories: []string{"proto"},
-	})
-
-	filePath := filepath.Join(srcDir, "proto", "grpc", "federation", "federation.proto")
-	require.NoError(t, os.MkdirAll(filepath.Dir(filePath), 0755))
-	require.NoError(t, os.WriteFile(filePath, []byte("syntax = \"proto3\";"), 0644))
-
-	err := buildInstallTree(srcDir, dstDir, renamer)
-	require.NoError(t, err)
-
-	data, err := os.ReadFile(filepath.Join(dstDir, "grpc", "federation", "federation.proto"))
-	require.NoError(t, err)
-	require.Equal(t, "syntax = \"proto3\";", string(data))
-}
-
-func TestBuildInstallTree_SymlinkRewritten(t *testing.T) {
-	srcDir := t.TempDir()
-	dstDir := t.TempDir()
-
-	renamer := getRenamer(models.ModuleConfig{
-		Directories: []string{"proto"},
-	})
-
-	targetRelFromSrc := filepath.Join("proto", "grpc", "federation", "federation.proto")
-	targetPath := filepath.Join(srcDir, targetRelFromSrc)
-	require.NoError(t, os.MkdirAll(filepath.Dir(targetPath), 0755))
-	require.NoError(t, os.WriteFile(targetPath, []byte("syntax = \"proto3\";"), 0644))
-
-	linkDir := filepath.Join(srcDir, "compiler", "testdata")
-	require.NoError(t, os.MkdirAll(linkDir, 0755))
-
-	linkPath := filepath.Join(linkDir, "federation.proto")
-	require.NoError(t, os.Symlink("../../proto/grpc/federation/federation.proto", linkPath))
-
-	err := buildInstallTree(srcDir, dstDir, renamer)
-	require.NoError(t, err)
-
-	linkDst := filepath.Join(dstDir, "compiler", "testdata", "federation.proto")
-	info, err := os.Lstat(linkDst)
-	require.NoError(t, err)
-	require.True(t, info.Mode()&os.ModeSymlink != 0, "expected symlink")
-
-	resolved, err := filepath.EvalSymlinks(linkDst)
-	require.NoError(t, err)
-
-	targetInDst := filepath.Join(dstDir, "grpc", "federation", "federation.proto")
-	resolvedTarget, err := filepath.EvalSymlinks(targetInDst)
-	require.NoError(t, err)
-	resolvedLink, err := filepath.EvalSymlinks(resolved)
-	require.NoError(t, err)
-	require.Equal(t, resolvedTarget, resolvedLink)
-}
-
-func TestBuildInstallTree_SymlinkOutsideRewrittenDir(t *testing.T) {
-	srcDir := t.TempDir()
-	dstDir := t.TempDir()
-
-	renamer := getRenamer(models.ModuleConfig{
-		Directories: []string{"proto"},
-	})
-
-	targetPath := filepath.Join(srcDir, "other", "file.txt")
-	require.NoError(t, os.MkdirAll(filepath.Dir(targetPath), 0755))
-	require.NoError(t, os.WriteFile(targetPath, []byte("hello"), 0644))
-
-	linkPath := filepath.Join(srcDir, "link.txt")
-	require.NoError(t, os.Symlink("other/file.txt", linkPath))
-
-	err := buildInstallTree(srcDir, dstDir, renamer)
-	require.NoError(t, err)
-
-	linkDst := filepath.Join(dstDir, "link.txt")
-	info, err := os.Lstat(linkDst)
-	require.NoError(t, err)
-	require.True(t, info.Mode()&os.ModeSymlink != 0)
-
-	resolved, err := filepath.EvalSymlinks(linkDst)
-	require.NoError(t, err)
-	targetInDst := filepath.Join(dstDir, "other", "file.txt")
-	resolvedTarget, err := filepath.EvalSymlinks(targetInDst)
-	require.NoError(t, err)
-	resolvedLink, err := filepath.EvalSymlinks(resolved)
-	require.NoError(t, err)
-	require.Equal(t, resolvedTarget, resolvedLink)
-}
-
-func TestBuildInstallTree_GrpcFederationLayout(t *testing.T) {
-	srcDir := t.TempDir()
-	dstDir := t.TempDir()
-
-	renamer := getRenamer(models.ModuleConfig{
-		Directories: []string{"proto"},
-	})
-
-	protoFile := filepath.Join(srcDir, "proto", "grpc", "federation", "federation.proto")
-	require.NoError(t, os.MkdirAll(filepath.Dir(protoFile), 0755))
-	require.NoError(t, os.WriteFile(protoFile, []byte("syntax = \"proto3\";"), 0644))
-
-	testdataDir := filepath.Join(srcDir, "compiler", "testdata")
-	require.NoError(t, os.MkdirAll(testdataDir, 0755))
-	require.NoError(t, os.Symlink("../../proto/grpc/federation/federation.proto", filepath.Join(testdataDir, "federation.proto")))
-
-	err := buildInstallTree(srcDir, dstDir, renamer)
-	require.NoError(t, err)
-
-	linkTarget, err := os.Readlink(filepath.Join(dstDir, "compiler", "testdata", "federation.proto"))
-	require.NoError(t, err)
-	require.NotEmpty(t, linkTarget)
-
-	_, err = os.Stat(filepath.Join(dstDir, "grpc", "federation", "federation.proto"))
-	require.NoError(t, err)
-
-	linkDst := filepath.Join(dstDir, "compiler", "testdata", "federation.proto")
-	resolved, err := filepath.EvalSymlinks(linkDst)
-	require.NoError(t, err)
-	data, err := os.ReadFile(resolved)
-	require.NoError(t, err)
-	require.Equal(t, "syntax = \"proto3\";", string(data))
-}
-
-func TestBuildInstallTree_AbsoluteSymlinkRejected(t *testing.T) {
-	srcDir := t.TempDir()
-	dstDir := t.TempDir()
-
-	renamer := getRenamer(models.ModuleConfig{
-		Directories: []string{"proto"},
-	})
-
-	absTarget := "/etc/passwd"
-	if runtime.GOOS == "windows" {
-		absTarget = `C:\Windows\System32\drivers\etc\hosts`
-	}
-
-	require.NoError(t, os.MkdirAll(filepath.Join(srcDir, "proto"), 0755))
-	require.NoError(t, os.WriteFile(filepath.Join(srcDir, "proto", "file.proto"), []byte("data"), 0644))
-	require.NoError(t, os.Symlink(absTarget, filepath.Join(srcDir, "proto", "bad.proto")))
-
-	err := buildInstallTree(srcDir, dstDir, renamer)
-	require.Error(t, err)
-	require.Contains(t, err.Error(), "absolute symlink target not allowed")
-}
-
-func TestBuildInstallTree_EscapingSymlinkRejected(t *testing.T) {
-	srcDir := t.TempDir()
-	dstDir := t.TempDir()
-
-	renamer := getRenamer(models.ModuleConfig{
-		Directories: []string{"proto"},
-	})
-
-	require.NoError(t, os.MkdirAll(filepath.Join(srcDir, "proto"), 0755))
-	require.NoError(t, os.WriteFile(filepath.Join(srcDir, "proto", "file.proto"), []byte("data"), 0644))
-	require.NoError(t, os.Symlink("../../../etc/passwd", filepath.Join(srcDir, "proto", "escape.proto")))
-
-	err := buildInstallTree(srcDir, dstDir, renamer)
-	require.Error(t, err)
-	require.True(t, strings.Contains(err.Error(), "symlink target escapes source tree") ||
-		strings.Contains(err.Error(), "absolute symlink"))
-}
diff --git a/internal/adapters/storage/mocks/LockFile.go b/internal/adapters/storage/mocks/LockFile.go
deleted file mode 100644
index 0842d439..00000000
--- a/internal/adapters/storage/mocks/LockFile.go
+++ /dev/null
@@ -1,91 +0,0 @@
-// Code generated by mockery. DO NOT EDIT.
-
-package mocks
-
-import (
-	models "github.com/easyp-tech/easyp/internal/core/models"
-	mock "github.com/stretchr/testify/mock"
-)
-
-// LockFile is an autogenerated mock type for the LockFile type
-type LockFile struct {
-	mock.Mock
-}
-
-type LockFile_Expecter struct {
-	mock *mock.Mock
-}
-
-func (_m *LockFile) EXPECT() *LockFile_Expecter {
-	return &LockFile_Expecter{mock: &_m.Mock}
-}
-
-// Read provides a mock function with given fields: moduleName
-func (_m *LockFile) Read(moduleName string) (models.LockFileInfo, error) {
-	ret := _m.Called(moduleName)
-
-	if len(ret) == 0 {
-		panic("no return value specified for Read")
-	}
-
-	var r0 models.LockFileInfo
-	var r1 error
-	if rf, ok := ret.Get(0).(func(string) (models.LockFileInfo, error)); ok {
-		return rf(moduleName)
-	}
-	if rf, ok := ret.Get(0).(func(string) models.LockFileInfo); ok {
-		r0 = rf(moduleName)
-	} else {
-		r0 = ret.Get(0).(models.LockFileInfo)
-	}
-
-	if rf, ok := ret.Get(1).(func(string) error); ok {
-		r1 = rf(moduleName)
-	} else {
-		r1 = ret.Error(1)
-	}
-
-	return r0, r1
-}
-
-// LockFile_Read_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'Read'
-type LockFile_Read_Call struct {
-	*mock.Call
-}
-
-// Read is a helper method to define mock.On call
-//   - moduleName string
-func (_e *LockFile_Expecter) Read(moduleName interface{}) *LockFile_Read_Call {
-	return &LockFile_Read_Call{Call: _e.mock.On("Read", moduleName)}
-}
-
-func (_c *LockFile_Read_Call) Run(run func(moduleName string)) *LockFile_Read_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(string))
-	})
-	return _c
-}
-
-func (_c *LockFile_Read_Call) Return(_a0 models.LockFileInfo, _a1 error) *LockFile_Read_Call {
-	_c.Call.Return(_a0, _a1)
-	return _c
-}
-
-func (_c *LockFile_Read_Call) RunAndReturn(run func(string) (models.LockFileInfo, error)) *LockFile_Read_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// NewLockFile creates a new instance of LockFile. It also registers a testing interface on the mock and a cleanup function to assert the mocks expectations.
-// The first argument is typically a *testing.T value.
-func NewLockFile(t interface {
-	mock.TestingT
-	Cleanup(func())
-}) *LockFile {
-	mock := &LockFile{}
-	mock.Mock.Test(t)
-
-	t.Cleanup(func() { mock.AssertExpectations(t) })
-
-	return mock
-}
diff --git a/internal/adapters/storage/read_installed_module_info.go b/internal/adapters/storage/read_installed_module_info.go
deleted file mode 100644
index 5b355f58..00000000
--- a/internal/adapters/storage/read_installed_module_info.go
+++ /dev/null
@@ -1,30 +0,0 @@
-package storage
-
-import (
-	"encoding/json"
-	"errors"
-	"fmt"
-	"os"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-func (s *Storage) ReadInstalledModuleInfo(
-	cacheDownloadPaths models.CacheDownloadPaths,
-) (models.InstalledModuleInfo, error) {
-	rawData, err := os.ReadFile(cacheDownloadPaths.ModuleInfoFile)
-	if err != nil {
-		if errors.Is(err, os.ErrNotExist) {
-			return models.InstalledModuleInfo{}, models.ErrModuleInfoFileNotFound
-		}
-
-		return models.InstalledModuleInfo{}, fmt.Errorf("os.ReadFile: %w", err)
-	}
-
-	installedModuleInfo := models.InstalledModuleInfo{}
-	if err := json.Unmarshal(rawData, &installedModuleInfo); err != nil {
-		return models.InstalledModuleInfo{}, fmt.Errorf("json.Unmarshal: %w", err)
-	}
-
-	return installedModuleInfo, nil
-}
diff --git a/internal/adapters/storage/sanitize.go b/internal/adapters/storage/sanitize.go
deleted file mode 100644
index 3ce2da8a..00000000
--- a/internal/adapters/storage/sanitize.go
+++ /dev/null
@@ -1,7 +0,0 @@
-package storage
-
-import "strings"
-
-func sanitizePath(source string) string {
-	return strings.ReplaceAll(source, "/", "-")
-}
diff --git a/internal/adapters/storage/storage.go b/internal/adapters/storage/storage.go
deleted file mode 100644
index 1bca0237..00000000
--- a/internal/adapters/storage/storage.go
+++ /dev/null
@@ -1,42 +0,0 @@
-package storage
-
-import (
-	"github.com/easyp-tech/easyp/internal/core/models"
-	"github.com/easyp-tech/easyp/internal/logger"
-)
-
-const (
-	// root cache dir
-	cacheDir = "cache"
-	// dir for downloaded (check sum, archive)
-	cacheDownloadDir = "download"
-	// dir for installed packages
-	installedDir = "mod"
-)
-
-type (
-	// LockFile should implement adapter for lock file workflow
-	LockFile interface {
-		Read(moduleName string) (models.LockFileInfo, error)
-	}
-
-	// Storage implements workflows with directories
-	Storage struct {
-		rootDir  string
-		lockFile LockFile
-		logger   logger.Logger
-	}
-)
-
-func New(rootDir string, lockFile LockFile, logger logger.Logger) *Storage {
-	return &Storage{
-		rootDir:  rootDir,
-		lockFile: lockFile,
-		logger:   logger,
-	}
-}
-
-const (
-	dirPerm      = 0755
-	infoFilePerm = 0644
-)
diff --git a/internal/adapters/storage/storage_test.go b/internal/adapters/storage/storage_test.go
deleted file mode 100644
index 23d777bb..00000000
--- a/internal/adapters/storage/storage_test.go
+++ /dev/null
@@ -1,48 +0,0 @@
-package storage
-
-import (
-	"path"
-	"testing"
-
-	"github.com/brianvoe/gofakeit/v6"
-	"github.com/stretchr/testify/suite"
-
-	"github.com/easyp-tech/easyp/internal/adapters/storage/mocks"
-	"github.com/easyp-tech/easyp/internal/core/models"
-	"github.com/easyp-tech/easyp/internal/logger"
-)
-
-type storageSuite struct {
-	suite.Suite
-
-	rootDir  string
-	lockFile *mocks.LockFile
-	storage  *Storage
-}
-
-func getFakeModule() models.Module {
-	name := path.Join(gofakeit.DomainName(), gofakeit.Word(), gofakeit.Word())
-
-	return models.Module{
-		Name:    name,
-		Version: models.RequestedVersion(gofakeit.Word()),
-	}
-}
-
-func getFakeRevision() models.Revision {
-	return models.Revision{
-		CommitHash: gofakeit.UUID(),
-		Version:    gofakeit.Word(),
-	}
-}
-
-func (s *storageSuite) SetupTest() {
-	s.rootDir = "/" + path.Join(gofakeit.Word(), gofakeit.Word())
-	s.lockFile = mocks.NewLockFile(s.T())
-
-	s.storage = New(s.rootDir, s.lockFile, logger.NewNop())
-}
-
-func TestRunSuite(t *testing.T) {
-	suite.Run(t, new(storageSuite))
-}
diff --git a/internal/adapters/storage/write_installed_module_info.go b/internal/adapters/storage/write_installed_module_info.go
deleted file mode 100644
index 5a520a57..00000000
--- a/internal/adapters/storage/write_installed_module_info.go
+++ /dev/null
@@ -1,24 +0,0 @@
-package storage
-
-import (
-	"encoding/json"
-	"fmt"
-	"os"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-func (s *Storage) WriteInstalledModuleInfo(
-	cacheDownloadPaths models.CacheDownloadPaths, installedModuleInfo models.InstalledModuleInfo,
-) error {
-	rawData, err := json.Marshal(&installedModuleInfo)
-	if err != nil {
-		return fmt.Errorf("json.Marshal: %w", err)
-	}
-
-	if err := os.WriteFile(cacheDownloadPaths.ModuleInfoFile, rawData, infoFilePerm); err != nil {
-		return fmt.Errorf("os.WriteFile: %w", err)
-	}
-
-	return nil
-}
diff --git a/internal/api/breaking_baseline_test.go b/internal/api/breaking_baseline_test.go
new file mode 100644
index 00000000..52cf4dea
--- /dev/null
+++ b/internal/api/breaking_baseline_test.go
@@ -0,0 +1,57 @@
+package api
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestBreakingBaselinePrecedence(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name, baseline string
+		args           []string
+		want           string
+		wantErr        bool
+	}{
+		{name: "policy before default", baseline: "git:release", want: "release"},
+		{name: "explicit before policy", baseline: "git:release", args: []string{"--against", "main"}, want: "main"},
+		{name: "explicit value equals default", baseline: "git:release", args: []string{"--against", "master"}, want: "master"},
+		{name: "default without policy", want: "master"},
+		{name: "explicit without policy", args: []string{"--against", "main"}, want: "main"},
+		{name: "empty explicit rejected", baseline: "git:release", args: []string{"--against", ""}, wantErr: true},
+		{name: "whitespace explicit rejected", baseline: "git:release", args: []string{"--against", "   "}, wantErr: true},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			policy := v1.Policy{Breaking: v1.BreakingPolicy{Baseline: tt.baseline}}
+			// urfave uses a process-global help flag; these independent parsers do not need it.
+			app := &cli.App{
+				HideHelp:    true,
+				HideVersion: true,
+				Flags:       []cli.Flag{&cli.StringFlag{Name: flagAgainstBranchName.Name, Value: flagAgainstBranchName.Value}},
+				Action: func(ctx *cli.Context) error {
+					cfg, err := resolveV1BreakingConfig(ctx, policy)
+					if err != nil {
+						return err
+					}
+					assert.Equal(t, tt.want, cfg.AgainstGitRef)
+					return nil
+				},
+			}
+			err := app.Run(append([]string{"test"}, tt.args...))
+			if tt.wantErr {
+				require.ErrorContains(t, err, "--against")
+			} else {
+				require.NoError(t, err)
+			}
+		})
+	}
+	assert.False(t, flagAgainstBranchName.Required)
+	assert.False(t, flagAgainstBranchName.HasBeenSet)
+}
diff --git a/internal/api/breaking_check.go b/internal/api/breaking_check.go
index 584956b2..6676480a 100644
--- a/internal/api/breaking_check.go
+++ b/internal/api/breaking_check.go
@@ -8,10 +8,8 @@ import (
 
 	"github.com/urfave/cli/v2"
 
-	"github.com/easyp-tech/easyp/internal/config"
 	"github.com/easyp-tech/easyp/internal/core"
 	"github.com/easyp-tech/easyp/internal/flags"
-	"github.com/easyp-tech/easyp/internal/fs/fs"
 	"github.com/easyp-tech/easyp/internal/logger"
 )
 
@@ -24,8 +22,8 @@ var (
 	flagAgainstBranchName = &cli.StringFlag{
 		Name:       "against",
 		Usage:      "set branch to compare with",
-		Required:   true,
-		HasBeenSet: true,
+		Required:   false,
+		HasBeenSet: false,
 		Value:      "master",
 	}
 
@@ -56,6 +54,7 @@ func (b BreakingCheck) Command() *cli.Command {
 		OnUsageError: nil,
 		Subcommands:  nil,
 		Flags: []cli.Flag{
+			flags.Frozen(),
 			flagLintDirectoryPath,
 			flagAgainstBranchName,
 			flagBreakingCheckRoot,
@@ -101,27 +100,9 @@ func (b BreakingCheck) action(ctx *cli.Context, log logger.Logger) error {
 		return fmt.Errorf("resolveRoots: %w", err)
 	}
 
-	cfg, err := config.New(ctx.Context, configPath)
-	if err != nil {
-		return fmt.Errorf("config.New: %w", err)
-	}
-
-	path := ctx.String(flagLintDirectoryPath.Name)
-	against := ctx.String(flagAgainstBranchName.Name)
-	if cfg.BreakingCheck.AgainstGitRef == "" {
-		cfg.BreakingCheck.AgainstGitRef = against
-	}
-
-	// Walker for Core (lockfile etc) - strictly based on project root
-	projectWalker := fs.NewFSWalker(projectRoot, ".")
-	app, err := buildCore(ctx.Context, log, *cfg, projectWalker)
-	if err != nil {
-		return fmt.Errorf("buildCore: %w", err)
-	}
-
-	issues, err := app.BreakingCheck(ctx.Context, projectRoot, breakingCheckRoot, path)
+	issues, err := b.checkV1Policies(ctx, log, configPath, projectRoot, breakingCheckRoot)
 	if err != nil {
-		return fmt.Errorf("app.BreakingCheck: %w", err)
+		return fmt.Errorf("checkV1Policies: %w", err)
 	}
 
 	if len(issues) == 0 {
diff --git a/internal/api/breaking_ignore.go b/internal/api/breaking_ignore.go
new file mode 100644
index 00000000..b1a311b4
--- /dev/null
+++ b/internal/api/breaking_ignore.go
@@ -0,0 +1,22 @@
+package api
+
+import (
+	"fmt"
+	"path/filepath"
+)
+
+// breakingIgnorePaths binds ignores to their owning policy, not the Git root.
+func breakingIgnorePaths(repositoryRoot, policyRoot string, ignores []string) ([]string, error) {
+	result := make([]string, 0, len(ignores))
+	for _, ignored := range ignores {
+		if ignored == "" || !filepath.IsLocal(ignored) {
+			return nil, fmt.Errorf("breaking.ignore requires a nonempty policy-relative path: %q", ignored)
+		}
+		rel, err := filepath.Rel(repositoryRoot, filepath.Join(policyRoot, ignored))
+		if err != nil || !filepath.IsLocal(rel) {
+			return nil, fmt.Errorf("breaking.ignore path leaves the repository: %q", ignored)
+		}
+		result = append(result, filepath.ToSlash(rel))
+	}
+	return result, nil
+}
diff --git a/internal/api/breaking_ignore_test.go b/internal/api/breaking_ignore_test.go
new file mode 100644
index 00000000..13e70b65
--- /dev/null
+++ b/internal/api/breaking_ignore_test.go
@@ -0,0 +1,20 @@
+package api
+
+import (
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestBreakingIgnorePathsArePolicyRelative(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	got, err := breakingIgnorePaths(root, filepath.Join(root, "api"), []string{"generated", "legacy/old.proto"})
+	require.NoError(t, err)
+	require.Equal(t, []string{"api/generated", "api/legacy/old.proto"}, got)
+	for _, bad := range []string{"", "../other", root} {
+		_, err := breakingIgnorePaths(root, filepath.Join(root, "api"), []string{bad})
+		require.Error(t, err)
+	}
+}
diff --git a/internal/api/breaking_scope.go b/internal/api/breaking_scope.go
new file mode 100644
index 00000000..f6d28f2d
--- /dev/null
+++ b/internal/api/breaking_scope.go
@@ -0,0 +1,274 @@
+package api
+
+import (
+	"context"
+	"fmt"
+	"io"
+	"io/fs"
+	"os"
+	"path/filepath"
+
+	gitadapter "github.com/easyp-tech/easyp/internal/adapters/go_git"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/core"
+	"github.com/easyp-tech/easyp/internal/core/path_helpers"
+	disk "github.com/easyp-tech/easyp/internal/fs/fs"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+type breakingScope struct{ files []string }
+
+// discoverBreakingScopes assigns files to the nearest module in this revision.
+// Repository-relative paths make findings independent of --root and import roots.
+// root is the scanned tree; repositoryRoot identifies absolute replacement paths.
+func discoverBreakingScopes(replacements *policyReplacementSources, scanRelative string) (map[string]breakingScope, error) {
+	root := replacements.projectRoot
+	scopes := make(map[string]breakingScope)
+	scan := filepath.Join(root, scanRelative)
+	if _, err := os.Stat(scan); os.IsNotExist(err) {
+		return scopes, nil
+	} else if err != nil {
+		return nil, fmt.Errorf("Stat: %w", err)
+	}
+	manifests := make(map[string]v1.Module)
+	err := filepath.WalkDir(scan, func(path string, entry fs.DirEntry, walkErr error) error {
+		if walkErr != nil {
+			return walkErr
+		}
+		if policySourceExcluded(root, path) {
+			if entry.IsDir() {
+				return filepath.SkipDir
+			}
+			return nil
+		}
+		if entry.IsDir() || filepath.Ext(path) != ".proto" {
+			return nil
+		}
+		unselectedReplacement, err := replacements.isUnselectedReplacementSource(scan, path)
+		if err != nil {
+			return fmt.Errorf("isUnselectedReplacementSource: %w", err)
+		}
+		if unselectedReplacement {
+			return nil
+		}
+		directory, err := findV1PolicyModuleDir(root, filepath.Dir(path))
+		if err != nil {
+			return err
+		}
+		key := "."
+		if directory != "" {
+			module, known := manifests[directory]
+			if !known {
+				_, module, err = modules.ReadManifest(directory)
+				if err != nil {
+					return err
+				}
+				manifests[directory] = module
+			}
+			owned := false
+			for _, sourceRoot := range module.Roots {
+				if path_helpers.IsTargetPath(filepath.Join(directory, sourceRoot), path) {
+					owned = true
+					break
+				}
+			}
+			if !owned {
+				return nil
+			}
+			key, err = filepath.Rel(root, directory)
+			if err != nil {
+				return err
+			}
+		}
+		relative, err := filepath.Rel(root, path)
+		if err != nil {
+			return err
+		}
+		scope := scopes[key]
+		scope.files = append(scope.files, filepath.ToSlash(relative))
+		scopes[key] = scope
+		return nil
+	})
+	if err != nil {
+		return nil, fmt.Errorf("WalkDir: %w", err)
+	}
+	return scopes, nil
+}
+
+// scopedBreakingWalker exposes target files by repository path, but does not
+// let import lookup accidentally read another module from the repository root.
+type scopedBreakingWalker struct {
+	core.FS
+	root    string
+	files   []string
+	allowed map[string]bool
+}
+
+func newBreakingWalker(root string, files []string) *scopedBreakingWalker {
+	allowed := make(map[string]bool, len(files))
+	for _, file := range files {
+		allowed[filepath.ToSlash(file)] = true
+	}
+	return &scopedBreakingWalker{FS: disk.NewFSWalker(root, "."), root: root, files: files, allowed: allowed}
+}
+
+func (w *scopedBreakingWalker) RootPath() string { return w.root }
+func (w *scopedBreakingWalker) Open(name string) (io.ReadCloser, error) {
+	if !w.allowed[filepath.ToSlash(name)] {
+		return nil, &os.PathError{Op: "open", Path: name, Err: os.ErrNotExist}
+	}
+	return w.FS.Open(name)
+}
+func (w *scopedBreakingWalker) WalkDir(visit func(string, error) error) error {
+	for _, file := range w.files {
+		if err := visit(file, nil); err != nil {
+			return err
+		}
+	}
+	return nil
+}
+
+func breakingImportRoots(ctx context.Context, cache modules.Cache, root, moduleRelative string, files []string, snapshot *gitadapter.Snapshot) (modules.SourceRoots, error) {
+	return breakingImportRootsMode(ctx, cache, root, moduleRelative, files, snapshot, false)
+}
+
+func breakingImportRootsMode(ctx context.Context, cache modules.Cache, root, moduleRelative string, files []string, snapshot *gitadapter.Snapshot, frozen bool) (modules.SourceRoots, error) {
+	directory := filepath.Join(root, moduleRelative)
+	if len(files) == 0 {
+		// A deleted module has no graph in this revision, but an explicit empty
+		// module still requires its own lock and replacement validation.
+		if !frozen {
+			return nil, nil
+		}
+		if _, err := os.Stat(filepath.Join(directory, v1.ModuleFile)); os.IsNotExist(err) {
+			return nil, nil
+		}
+	}
+	if frozen {
+		return policyImportRoots(ctx, cache, directory, true)
+	}
+	if _, err := os.Stat(filepath.Join(directory, v1.ModuleFile)); os.IsNotExist(err) {
+		return modules.SourceRoots{{Path: directory}}, nil
+	} else if err != nil {
+		return nil, fmt.Errorf("Stat: %w", err)
+	}
+	if snapshot == nil {
+		return ensureV1PolicyImportRoots(ctx, cache, directory)
+	}
+	_, module, err := modules.ReadManifest(directory)
+	if err != nil {
+		return nil, fmt.Errorf("ReadManifest: %w", err)
+	}
+	own, err := modules.ModuleSources(directory, module)
+	if err != nil {
+		return nil, fmt.Errorf("ModuleSources: %w", err)
+	}
+	var dependencies modules.SourceRoots
+	if len(module.Replaces) > 0 {
+		graph, err := modules.EnsureEffectiveGraph(ctx, directory, module, cache, func(target string) (string, error) {
+			return snapshotReplacementPath(snapshot, directory, target)
+		})
+		if err != nil {
+			return nil, fmt.Errorf("EnsureEffectiveGraph: %w", err)
+		}
+		dependencies = graph.Sources
+	} else {
+		dependencies, err = modules.EnsureSources(ctx, directory, module, cache)
+		if err != nil {
+			return nil, fmt.Errorf("EnsureSources: %w", err)
+		}
+	}
+
+	allSources := append(own, dependencies...)
+	if err := modules.CheckSourceCollisions(allSources); err != nil {
+		return nil, fmt.Errorf("CheckSourceCollisions: %w", err)
+	}
+	return allSources, nil
+}
+
+// Local replacements inside the repository are read from the baseline snapshot.
+// External working directories have no historical identity and cannot safely
+// stand in for a dependency at the baseline revision.
+func snapshotReplacementPath(snapshot *gitadapter.Snapshot, directory, target string) (string, error) {
+	resolved := modules.ResolveReplacementPath(directory, target)
+	if filepath.IsAbs(target) {
+		relative, err := baselineRepositoryRelative(snapshot.RepositoryRoot, target)
+		if err != nil || !filepath.IsLocal(relative) {
+			return "", fmt.Errorf("baseline replacement points outside the Git repository: %q; use a locked dependency for a reproducible baseline", target)
+		}
+		resolved = filepath.Join(snapshot.Root, relative)
+	}
+	relative, err := filepath.Rel(snapshot.Root, resolved)
+	if err != nil || !filepath.IsLocal(relative) {
+		return "", fmt.Errorf("baseline replacement leaves the Git snapshot: %q", target)
+	}
+	// Do not follow a snapshot symlink into present-day working files.
+	canonical, err := filepath.EvalSymlinks(resolved)
+	if err != nil {
+		return "", fmt.Errorf("EvalSymlinks: %w", err)
+	}
+	snapshotRoot, err := filepath.EvalSymlinks(snapshot.Root)
+	if err != nil {
+		return "", fmt.Errorf("EvalSymlinks: %w", err)
+	}
+	relative, err = filepath.Rel(snapshotRoot, canonical)
+	if err != nil || !filepath.IsLocal(relative) {
+		return "", fmt.Errorf("baseline replacement leaves the Git snapshot: %q", target)
+	}
+	return resolved, nil
+}
+
+// baselineRepositoryRelative accepts filesystem aliases such as macOS /tmp,
+// including paths deleted from the current tree but present at the baseline.
+func baselineRepositoryRelative(root, target string) (string, error) {
+	realRoot, err := filepath.EvalSymlinks(root)
+	if err != nil {
+		return "", fmt.Errorf("EvalSymlinks: %w", err)
+	}
+	resolved, err := canonicalPolicyPath(target)
+	if err != nil {
+		return "", fmt.Errorf("canonicalPolicyPath: %w", err)
+	}
+	return filepath.Rel(realRoot, resolved)
+}
+
+// canonicalPolicyPath resolves aliases before retaining a deleted path suffix.
+// A dangling alias still identifies its historical target in the Git snapshot.
+func canonicalPolicyPath(target string) (string, error) {
+	ancestor, err := filepath.Abs(target)
+	if err != nil {
+		return "", fmt.Errorf("Abs: %w", err)
+	}
+	suffix := ""
+	links := 0
+	for {
+		resolved, err := filepath.EvalSymlinks(ancestor)
+		if err == nil {
+			return filepath.Join(resolved, suffix), nil
+		}
+		if !os.IsNotExist(err) || filepath.Dir(ancestor) == ancestor {
+			return "", fmt.Errorf("EvalSymlinks: %w", err)
+		}
+		info, statErr := os.Lstat(ancestor)
+		if statErr != nil && !os.IsNotExist(statErr) {
+			return "", fmt.Errorf("Lstat: %w", statErr)
+		}
+		if statErr == nil && info.Mode()&os.ModeSymlink != 0 {
+			link, err := os.Readlink(ancestor)
+			if err != nil {
+				return "", fmt.Errorf("Readlink: %w", err)
+			}
+			links++
+			if links > 255 {
+				return "", fmt.Errorf("too many symlinks in %s", target)
+			}
+			if !filepath.IsAbs(link) {
+				link = filepath.Join(filepath.Dir(ancestor), link)
+			}
+			ancestor = link
+			continue
+		}
+		suffix = filepath.Join(filepath.Base(ancestor), suffix)
+		ancestor = filepath.Dir(ancestor)
+	}
+}
diff --git a/internal/api/breaking_scope_test.go b/internal/api/breaking_scope_test.go
new file mode 100644
index 00000000..f81d7b13
--- /dev/null
+++ b/internal/api/breaking_scope_test.go
@@ -0,0 +1,140 @@
+package api
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/adapters/gitmodules"
+	gitadapter "github.com/easyp-tech/easyp/internal/adapters/go_git"
+)
+
+func TestBreakingOverlayUsesSnapshotTransitively(t *testing.T) {
+	t.Parallel()
+	current, baseline := t.TempDir(), t.TempDir()
+	writeV1GenerateFixture(t, current, "b/protobuf.mod", "module example.com/wrong\n")
+	writeV1GenerateFixture(t, baseline, "protobuf.mod", "module example.com/app\nroots proto\nrequire example.com/A\nreplace example.com/A => a\nreplace example.com/B => "+filepath.Join(current, "b")+"\n")
+	writeV1GenerateFixture(t, baseline, "proto/app.proto", "syntax = \"proto3\";\n")
+	writeV1GenerateFixture(t, baseline, "a/protobuf.mod", "module example.com/A\nrequire example.com/B\nreplace example.com/B => nonexistent\n")
+	writeV1GenerateFixture(t, baseline, "b/protobuf.mod", "module example.com/B\n")
+	snapshot := &gitadapter.Snapshot{Root: baseline, RepositoryRoot: current}
+	roots, err := breakingImportRoots(t.Context(), gitmodules.New(t.TempDir()), baseline, ".", []string{"proto/app.proto"}, snapshot)
+	require.NoError(t, err)
+	assert.Equal(t, []string{filepath.Join(baseline, "proto"), filepath.Join(baseline, "a"), filepath.Join(baseline, "b")}, roots.Paths())
+}
+
+func TestBreakingScopesRespectModuleRoots(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name   string
+		path   string
+		scopes map[string]breakingScope
+	}{
+		{
+			name: "only module roots", path: ".",
+			scopes: map[string]breakingScope{
+				".":     {files: []string{"proto/owned.proto"}},
+				"child": {files: []string{"child/schema/child.proto"}},
+			},
+		},
+		{name: "missing source path", path: "absent", scopes: map[string]breakingScope{}},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			for name, body := range map[string]string{
+				"protobuf.mod":                 "module example.com/root\nroots proto\n",
+				"proto/owned.proto":            "syntax = \"proto3\";",
+				"other.proto":                  "not a selected input",
+				"child/protobuf.mod":           "module example.com/child\nroots schema\n",
+				"child/schema/child.proto":     "syntax = \"proto3\";",
+				"child/outside.proto":          "not a selected input",
+				"easyp_vendor/dep.proto":       "not checked",
+				"child/easyp_vendor/dep.proto": "not checked",
+				".deps/external.proto":         "not checked",
+			} {
+				writeV1GenerateFixture(t, root, name, body)
+			}
+
+			replacements := newPolicyReplacementSources(t.Context(), root, root, nil, false)
+			scopes, err := discoverBreakingScopes(replacements, tt.path)
+
+			require.NoError(t, err)
+			assert.Equal(t, tt.scopes, scopes)
+		})
+	}
+}
+
+func TestBaselineRepositoryAliases(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	repo := filepath.Join(root, "repo")
+	require.NoError(t, os.Mkdir(repo, 0o755))
+	alias := filepath.Join(root, "alias")
+	require.NoError(t, os.Symlink(repo, alias))
+	got, err := baselineRepositoryRelative(repo, filepath.Join(alias, "deleted", "dep"))
+	require.NoError(t, err)
+	assert.Equal(t, filepath.Join("deleted", "dep"), got)
+}
+
+func TestBaselineRepositoryInternalAliases(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, "module/api/item.proto", "syntax = \"proto3\";\n")
+	require.NoError(t, os.Symlink("module", filepath.Join(root, "alias")))
+	tests := []struct {
+		name string
+		path string
+		want string
+	}{
+		{name: "module", path: "alias", want: "module"},
+		{name: "subdirectory", path: "alias/api", want: "module/api"},
+		{name: "file", path: "alias/api/item.proto", want: "module/api/item.proto"},
+		{name: "deleted file", path: "alias/api/deleted.proto", want: "module/api/deleted.proto"},
+		{name: "deleted subtree", path: "alias/deleted/item.proto", want: "module/deleted/item.proto"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			got, err := baselineRepositoryRelative(root, filepath.Join(root, tt.path))
+			require.NoError(t, err)
+			assert.Equal(t, filepath.FromSlash(tt.want), got)
+		})
+	}
+}
+
+func TestBaselineRepositoryAliasEscape(t *testing.T) {
+	t.Parallel()
+	root, outside := t.TempDir(), t.TempDir()
+	require.NoError(t, os.Symlink(outside, filepath.Join(root, "alias")))
+	got, err := baselineRepositoryRelative(root, filepath.Join(root, "alias/deleted.proto"))
+	require.NoError(t, err)
+	assert.False(t, filepath.IsLocal(got), got)
+}
+
+func TestBaselineRepositoryDeletedAliasTarget(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	require.NoError(t, os.Symlink("deleted/module", filepath.Join(root, "alias")))
+	got, err := baselineRepositoryRelative(root, filepath.Join(root, "alias/api/item.proto"))
+	require.NoError(t, err)
+	assert.Equal(t, filepath.Join("deleted", "module", "api", "item.proto"), got)
+}
+
+func TestBreakingWalkerDoesNotLeakUnselectedRepositoryFiles(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, "selected/item.proto", "selected")
+	writeV1GenerateFixture(t, root, "other.proto", "unselected")
+	walker := newBreakingWalker(root, []string{"selected/item.proto"})
+	_, err := walker.Open("other.proto")
+	require.ErrorIs(t, err, os.ErrNotExist)
+	f, err := walker.Open("selected/item.proto")
+	require.NoError(t, err)
+	require.NoError(t, f.Close())
+}
diff --git a/internal/api/breaking_unstable_test.go b/internal/api/breaking_unstable_test.go
new file mode 100644
index 00000000..1e21e0b8
--- /dev/null
+++ b/internal/api/breaking_unstable_test.go
@@ -0,0 +1,132 @@
+package api
+
+import (
+	"flag"
+	"fmt"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/core"
+	"github.com/easyp-tech/easyp/internal/fs/fs"
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestBreakingIgnoreUnstableConfigReachesCore(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name                     string
+		legacy, ignore, explicit bool
+		wantCount                int
+	}{
+		{name: "v1_enabled", ignore: true, wantCount: 1},
+		{name: "v1_disabled", wantCount: 2},
+		{name: "legacy_enabled", legacy: true, ignore: true, wantCount: 1},
+		{name: "legacy_disabled", legacy: true, wantCount: 2},
+		{name: "explicit_baseline_preserves_options", ignore: true, explicit: true, wantCount: 1},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			cfg := config.BreakingCheck{IgnoreUnstable: tt.ignore, AgainstGitRef: "release", Use: []string{core.BreakingCheckFilesCheck}}
+			if !tt.legacy {
+				policy, err := v1.ParsePolicy(strings.NewReader(fmt.Sprintf("version: v1\nbreaking:\n  baseline: git:release\n  categories: [FILE]\n  ignore_unstable: %t\n", tt.ignore)))
+				require.NoError(t, err)
+				set := flag.NewFlagSet("test", flag.ContinueOnError)
+				set.String(flagAgainstBranchName.Name, "master", "")
+				if tt.explicit {
+					require.NoError(t, set.Set(flagAgainstBranchName.Name, "override"))
+				}
+				cfg, err = resolveV1BreakingConfig(cli.NewContext(&cli.App{}, set, nil), policy)
+				require.NoError(t, err)
+				assert.Equal(t, tt.ignore, cfg.IgnoreUnstable)
+				if tt.explicit {
+					assert.Equal(t, "override", cfg.AgainstGitRef)
+				} else {
+					assert.Equal(t, "release", cfg.AgainstGitRef)
+				}
+			}
+			baseline, current := t.TempDir(), t.TempDir()
+			for _, pkg := range []string{"stable.v1", "unstable.v1beta1"} {
+				content := "syntax = \"proto3\"; package " + pkg + "; message Item {}"
+				writeV1GenerateFixture(t, baseline, pkg+"_old.proto", content)
+				writeV1GenerateFixture(t, current, pkg+"_new.proto", content)
+			}
+			app, err := buildCore(logger.NewNop(), config.Config{BreakingCheck: cfg}, nil)
+			require.NoError(t, err)
+			issues, err := app.CompareBreaking(t.Context(), fs.NewFSWalker(current, "."), fs.NewFSWalker(baseline, "."), nil)
+			require.NoError(t, err)
+			expected := tt.wantCount
+			if !tt.legacy {
+				expected *= 2
+			}
+			assert.Len(t, issues, expected)
+			moved, deleted := 0, 0
+			for _, issue := range issues {
+				if strings.Contains(issue.Message, "was moved") {
+					moved++
+				} else {
+					assert.Equal(t, "FILE_NO_DELETE", issue.RuleName)
+					deleted++
+				}
+				if tt.ignore {
+					assert.NotContains(t, issue.Path, "unstable")
+				}
+			}
+			assert.Equal(t, tt.wantCount, moved)
+			if !tt.legacy {
+				assert.Equal(t, tt.wantCount, deleted)
+			} else {
+				assert.Zero(t, deleted)
+			}
+		})
+	}
+}
+
+func TestBreakingV1IgnoreUnstableModuleSnapshot(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct {
+		name      string
+		ignore    bool
+		wantCount int
+	}{
+		{name: "enabled", ignore: true, wantCount: 2},
+		{name: "disabled", wantCount: 4},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeV1GenerateFixture(t, root, "easyp.yaml", fmt.Sprintf("version: v1\nbreaking:\n  baseline: git:baseline\n  categories: [FILE]\n  ignore_unstable: %t\n", tt.ignore))
+			writeV1GenerateFixture(t, root, "protobuf.mod", "module example.com/test\nroots proto\n")
+			for _, pkg := range []string{"stable.v1", "unstable.v1beta1"} {
+				writeV1GenerateFixture(t, root, "proto/"+pkg+"_old.proto", "syntax = \"proto3\"; package "+pkg+"; message Item { string id = 1; }")
+			}
+			runTestGit(t, root, "init", "-q")
+			runTestGit(t, root, "add", ".")
+			runTestGit(t, root, "-c", "user.name=EasyP test", "-c", "user.email=test@example.test", "commit", "-qm", "baseline fixture")
+			runTestGit(t, root, "branch", "baseline")
+			for _, pkg := range []string{"stable.v1", "unstable.v1beta1"} {
+				writeV1GenerateFixture(t, root, "proto/"+pkg+"_old.proto", "syntax = \"proto3\"; package "+pkg+";")
+				writeV1GenerateFixture(t, root, "proto/"+pkg+"_new.proto", "syntax = \"proto3\"; package "+pkg+"; message Item {}")
+			}
+			set := flag.NewFlagSet("test", flag.ContinueOnError)
+			set.String(flagLintDirectoryPath.Name, ".", "")
+			ctx := cli.NewContext(&cli.App{}, set, nil)
+			ctx.Context = t.Context()
+			issues, err := (BreakingCheck{}).checkV1Policies(ctx, logger.NewNop(), filepath.Join(root, "easyp.yaml"), root, filepath.Join(root, "proto"))
+			require.NoError(t, err)
+			assert.Len(t, issues, tt.wantCount, "%+v", issues)
+			if tt.ignore {
+				for _, issue := range issues {
+					assert.Equal(t, "proto/stable.v1_old.proto", issue.Path)
+				}
+			}
+		})
+	}
+}
diff --git a/internal/api/breaking_v1.go b/internal/api/breaking_v1.go
new file mode 100644
index 00000000..19c1f27f
--- /dev/null
+++ b/internal/api/breaking_v1.go
@@ -0,0 +1,495 @@
+package api
+
+import (
+	"context"
+	"fmt"
+	"io/fs"
+	"maps"
+	"os"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	"github.com/urfave/cli/v2"
+
+	gitadapter "github.com/easyp-tech/easyp/internal/adapters/go_git"
+	"github.com/easyp-tech/easyp/internal/config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/core"
+	"github.com/easyp-tech/easyp/internal/flags"
+	"github.com/easyp-tech/easyp/internal/logger"
+	"github.com/easyp-tech/easyp/internal/modules"
+	policyresolver "github.com/easyp-tech/easyp/internal/policy"
+)
+
+// checkV1Policies compares each module in an independent dependency context.
+// Policies are selected from the current project; each baseline has its own
+// sources, manifests and locks, without checking out the caller's worktree.
+func (b BreakingCheck) checkV1Policies(ctx *cli.Context, log logger.Logger, configPath, projectRoot, scanRoot string) ([]core.IssueInfo, error) {
+	projectRoot, err := canonicalPolicyPath(projectRoot)
+	if err != nil {
+		return nil, fmt.Errorf("canonicalPolicyPath: %w", err)
+	}
+	configPath, err = canonicalPolicyPath(configPath)
+	if err != nil {
+		return nil, fmt.Errorf("canonicalPolicyPath: %w", err)
+	}
+	_, _, err = readV1PolicyFile(configPath)
+	if err != nil {
+		return nil, fmt.Errorf("readV1PolicyFile: %w", err)
+	}
+	repositoryRoot, err := gitadapter.RepositoryRoot(scanRoot)
+	if err != nil {
+		return nil, fmt.Errorf("RepositoryRoot: %w", err)
+	}
+	repositoryRoot, err = canonicalPolicyPath(repositoryRoot)
+	if err != nil {
+		return nil, fmt.Errorf("canonicalPolicyPath: %w", err)
+	}
+	scanPath := filepath.Join(scanRoot, ctx.String(flagLintDirectoryPath.Name))
+	relative, err := baselineRepositoryRelative(repositoryRoot, scanPath)
+	if err != nil || !filepath.IsLocal(relative) {
+		return nil, fmt.Errorf("%w: %s", core.ErrRootOutsideProject, scanPath)
+	}
+	scanPath = filepath.Join(repositoryRoot, relative)
+	cache, err := moduleCache(ctx)
+	if err != nil {
+		return nil, fmt.Errorf("moduleCache: %w", err)
+	}
+	replacements := newPolicyReplacementSources(ctx.Context, projectRoot, projectRoot, func() (modules.Cache, error) { return cache, nil }, flags.IsFrozen(ctx))
+	sources, err := discoverV1BreakingPolicySources(replacements, scanPath, projectRoot, configPath)
+	if err != nil {
+		return nil, fmt.Errorf("discoverV1BreakingPolicySources: %w", err)
+	}
+	currentReplacements := newPolicyReplacementSources(ctx.Context, repositoryRoot, repositoryRoot, func() (modules.Cache, error) { return cache, nil }, flags.IsFrozen(ctx))
+	snapshots := make(map[string]*gitadapter.Snapshot)
+	defer func() {
+		for _, snapshot := range snapshots {
+			_ = snapshot.Close()
+		}
+	}()
+	var issues []core.IssueInfo
+	seen := make(map[breakingIssueKey]bool)
+	for _, source := range sources {
+		policy, _, err := resolveV1BreakingPolicy(filepath.Dir(source), projectRoot, configPath)
+		if err != nil {
+			return nil, fmt.Errorf("resolveV1BreakingPolicy: %w", err)
+		}
+		if policy.Breaking.Extends != "" {
+			resolved, err := b.checkV1ExtendedBreakingSource(ctx, log, configPath, projectRoot, scanRoot, scanPath, source, policy, cache, snapshots, seen)
+			if err != nil {
+				return nil, fmt.Errorf("checkV1ExtendedBreakingSource: %w", err)
+			}
+			issues = append(issues, resolved...)
+			continue
+		}
+		cfg, err := resolveV1BreakingConfig(ctx, policy)
+		if err != nil {
+			return nil, fmt.Errorf("resolveV1BreakingConfig: %w", err)
+		}
+		snapshot := snapshots[cfg.AgainstGitRef]
+		if snapshot == nil {
+			snapshot, err = gitadapter.SnapshotRevision(ctx.Context, scanRoot, cfg.AgainstGitRef)
+			if err != nil {
+				return nil, fmt.Errorf("SnapshotRevision: %w", err)
+			}
+			snapshots[cfg.AgainstGitRef] = snapshot
+		}
+		ignorePaths, err := breakingIgnorePaths(repositoryRoot, filepath.Dir(source), cfg.Ignore)
+		if err != nil {
+			return nil, fmt.Errorf("breakingIgnorePaths: %w", err)
+		}
+		current, err := selectedPolicyScopes(currentReplacements, relative, flags.IsFrozen(ctx))
+		if err != nil {
+			return nil, fmt.Errorf("discoverBreakingScopes current: %w", err)
+		}
+		baselineReplacements := newPolicyReplacementSources(ctx.Context, snapshot.Root, snapshot.RepositoryRoot, func() (modules.Cache, error) { return cache, nil }, flags.IsFrozen(ctx))
+		baseline, err := selectedPolicyScopes(baselineReplacements, relative, flags.IsFrozen(ctx))
+		if err != nil {
+			return nil, fmt.Errorf("discoverBreakingScopes baseline: %w", err)
+		}
+		keys := make(map[string]bool)
+		for key := range current {
+			keys[key] = true
+		}
+		for key := range baseline {
+			keys[key] = true
+		}
+		for _, module := range slices.Sorted(maps.Keys(keys)) {
+			currentFiles, baselineFiles := current[module].files, baseline[module].files
+			// Keep the whole selected module in each comparison so FILE moves and
+			// package members spanning policy subtrees remain comparable.
+			ownFiles := append(append([]string(nil), currentFiles...), baselineFiles...)
+			relevant, err := breakingScopeUsesPolicy(repositoryRoot, ownFiles, projectRoot, configPath, source)
+			if err != nil {
+				return nil, err
+			}
+			if flags.IsFrozen(ctx) && len(ownFiles) == 0 {
+				_, owner, err := resolveV1BreakingPolicy(filepath.Join(repositoryRoot, module), projectRoot, configPath)
+				if err != nil {
+					return nil, fmt.Errorf("resolveV1BreakingPolicy: %w", err)
+				}
+				relevant = owner == source
+			}
+			if !relevant {
+				continue
+			}
+			currentImports, err := breakingImportRootsMode(ctx.Context, cache, repositoryRoot, module, currentFiles, nil, flags.IsFrozen(ctx))
+			if err != nil {
+				return nil, fmt.Errorf("current module %s: %w", module, err)
+			}
+			baselineImports, err := breakingImportRootsMode(ctx.Context, cache, snapshot.Root, module, baselineFiles, snapshot, flags.IsFrozen(ctx))
+			if err != nil {
+				return nil, fmt.Errorf("baseline %s module %s: %w", cfg.AgainstGitRef, module, err)
+			}
+			app := core.New(core.Options{Logger: log, ImportRoots: currentImports.Paths(), ImportFileAllowed: currentImports.FileAllowed(), BreakingCheckConfig: core.BreakingCheckConfig{
+				IgnoreDirs: append(append([]string(nil), ignorePaths...), defaultVendorDir), AgainstGitRef: cfg.AgainstGitRef,
+				FilesCheck:     slices.Contains(cfg.Use, core.BreakingCheckFilesCheck),
+				Categories:     cfg.Categories,
+				IgnoreUnstable: cfg.IgnoreUnstable,
+			}})
+			found, err := app.CompareBreakingWithImports(ctx.Context, newBreakingWalker(repositoryRoot, currentFiles), newBreakingWalker(snapshot.Root, baselineFiles), baselineImports.Paths(), baselineImports.FileAllowed())
+			if err != nil {
+				return nil, fmt.Errorf("CompareBreaking module %s against %s: %w", module, cfg.AgainstGitRef, err)
+			}
+			for _, issue := range found {
+				owned := slices.Contains(ownFiles, filepath.ToSlash(issue.Path))
+				if owned {
+					directory := filepath.Dir(filepath.Join(repositoryRoot, issue.Path))
+					_, owner, err := resolveV1BreakingPolicy(directory, projectRoot, configPath)
+					if err != nil {
+						return nil, fmt.Errorf("resolveV1BreakingPolicy: %w", err)
+					}
+					if owner != source {
+						continue
+					}
+				} else {
+					// Dependency findings belong to the effective policy of the checked
+					// files, not an unrelated ancestor policy at the module directory.
+					issue.Path = filepath.ToSlash(filepath.Join(module, issue.Path))
+				}
+				key := breakingIssueKey{path: issue.Path, rule: issue.RuleName, message: issue.Message, line: issue.Position.Line, column: issue.Position.Column}
+				if !seen[key] {
+					issues = append(issues, issue)
+					seen[key] = true
+				}
+			}
+		}
+	}
+	return issues, nil
+}
+
+func breakingScopeUsesPolicy(repositoryRoot string, files []string, projectRoot, configPath, source string) (bool, error) {
+	directories := make([]string, 0, len(files))
+	for _, file := range files {
+		directories = append(directories, filepath.Dir(filepath.Join(repositoryRoot, file)))
+	}
+	for _, directory := range directories {
+		_, owner, err := resolveV1BreakingPolicy(directory, projectRoot, configPath)
+		if err != nil {
+			return false, fmt.Errorf("resolveV1BreakingPolicy: %w", err)
+		}
+		if owner == source {
+			return true, nil
+		}
+	}
+	return false, nil
+}
+
+func discoverV1BreakingPolicySources(replacements *policyReplacementSources, scanPath, projectRoot, configPath string) ([]string, error) {
+	sources := map[string]struct{}{}
+	policyDirectory := scanPath
+	info, statErr := os.Stat(scanPath)
+	missing := os.IsNotExist(statErr)
+	if statErr != nil && !missing {
+		return nil, fmt.Errorf("Stat: %w", statErr)
+	}
+	if missing || !info.IsDir() {
+		policyDirectory = filepath.Dir(scanPath)
+	}
+	_, owner, err := resolveV1BreakingPolicy(policyDirectory, projectRoot, configPath)
+	if err != nil {
+		return nil, err
+	}
+	sources[owner] = struct{}{}
+	if missing {
+		return []string{owner}, nil
+	}
+	err = filepath.WalkDir(scanPath, func(path string, entry fs.DirEntry, walkErr error) error {
+		if walkErr != nil {
+			return walkErr
+		}
+		if policySourceExcluded(projectRoot, path) {
+			if entry.IsDir() {
+				return filepath.SkipDir
+			}
+			return nil
+		}
+		if entry.IsDir() || entry.Name() != v1.PolicyFile || path == configPath {
+			return nil
+		}
+		unselectedReplacement, err := replacements.isUnselectedReplacementSource(scanPath, path)
+		if err != nil {
+			return fmt.Errorf("isUnselectedReplacementSource: %w", err)
+		}
+		if unselectedReplacement {
+			return nil
+		}
+		_, source, err := resolveV1BreakingPolicy(filepath.Dir(path), projectRoot, configPath)
+		if err != nil {
+			return err
+		}
+		sources[source] = struct{}{}
+		return nil
+	})
+	if err != nil {
+		return nil, fmt.Errorf("WalkDir: %w", err)
+	}
+	result := make([]string, 0, len(sources))
+	for source := range sources {
+		result = append(result, source)
+	}
+	slices.Sort(result)
+	return result, nil
+}
+
+func resolveV1BreakingPolicy(directory, projectRoot, configPath string) (v1.Policy, string, error) {
+	for _, dir := range ancestorDirs(directory, projectRoot) {
+		path := v1PolicyPath(dir, projectRoot, configPath)
+		file, found, err := readV1PolicyFile(path)
+		if err != nil {
+			return v1.Policy{}, "", fmt.Errorf("readV1PolicyFile: %w", err)
+		}
+		if found && (file.has("breaking") || dir == projectRoot) {
+			return file.policy, path, nil
+		}
+	}
+	return v1.Policy{}, "", fmt.Errorf("no easyp.yaml policy for %s", directory)
+}
+
+// resolveV1BreakingConfig distinguishes an explicit flag from its default value.
+func resolveV1BreakingConfig(ctx *cli.Context, policy v1.Policy) (config.BreakingCheck, error) {
+	against := ctx.String(flagAgainstBranchName.Name)
+	explicit := ctx.IsSet(flagAgainstBranchName.Name)
+	if explicit && strings.TrimSpace(against) == "" {
+		return config.BreakingCheck{}, fmt.Errorf("--against must not be empty")
+	}
+	cfg, err := policy.BreakingConfig(against)
+	if err != nil {
+		return config.BreakingCheck{}, fmt.Errorf("BreakingConfig: %w", err)
+	}
+	if explicit {
+		cfg.AgainstGitRef = against
+	}
+	return cfg, nil
+}
+
+// checkV1ExtendedBreakingSource resolves a shared breaking policy separately
+// for every checked module. This is required because nested consumers can have
+// different verified graphs and local replacements for the same module name.
+func (b BreakingCheck) checkV1ExtendedBreakingSource(
+	ctx *cli.Context, log logger.Logger,
+	configPath, projectRoot, scanRoot, scanPath, source string,
+	policy v1.Policy, cache modules.Cache,
+	snapshots map[string]*gitadapter.Snapshot, seen map[breakingIssueKey]bool,
+) ([]core.IssueInfo, error) {
+	repositoryRoot, err := gitadapter.RepositoryRoot(scanRoot)
+	if err != nil {
+		return nil, fmt.Errorf("RepositoryRoot: %w", err)
+	}
+	repositoryRoot, err = canonicalPolicyPath(repositoryRoot)
+	if err != nil {
+		return nil, fmt.Errorf("canonicalPolicyPath: %w", err)
+	}
+	relative, err := baselineRepositoryRelative(repositoryRoot, scanPath)
+	if err != nil || !filepath.IsLocal(relative) {
+		return nil, fmt.Errorf("%w: %s", core.ErrRootOutsideProject, scanPath)
+	}
+	replacements := newPolicyReplacementSources(ctx.Context, repositoryRoot, repositoryRoot, func() (modules.Cache, error) { return cache, nil }, flags.IsFrozen(ctx))
+	current, err := selectedPolicyScopes(replacements, relative, flags.IsFrozen(ctx))
+	if err != nil {
+		return nil, fmt.Errorf("selectedPolicyScopes: %w", err)
+	}
+	// Retain a native module after deletion of its last proto file, even in
+	// normal mode. Frozen's additional empty-scope checks remain mandatory.
+	if !flags.IsFrozen(ctx) {
+		expanded, expandErr := selectedPolicyScopes(replacements, relative, true)
+		if expandErr == nil {
+			current = expanded
+		}
+	}
+	policyFile, found, err := readV1PolicyFile(source)
+	if err != nil {
+		return nil, err
+	}
+	if !found {
+		return nil, fmt.Errorf("policy source %s disappeared", source)
+	}
+
+	type candidate struct {
+		module     string
+		historical *gitadapter.Snapshot
+	}
+	var queue []candidate
+	queued := make(map[string]bool)
+	enqueue := func(scopes map[string]breakingScope, historical *gitadapter.Snapshot) error {
+		for _, module := range slices.Sorted(maps.Keys(scopes)) {
+			if queued[module] {
+				continue
+			}
+			relevant, err := breakingScopeUsesPolicy(repositoryRoot, scopes[module].files, projectRoot, configPath, source)
+			if err != nil {
+				return err
+			}
+			if len(scopes[module].files) == 0 {
+				_, owner, err := resolveV1BreakingPolicy(filepath.Join(repositoryRoot, module), projectRoot, configPath)
+				if err != nil {
+					return err
+				}
+				relevant = owner == source
+			}
+			if relevant {
+				queued[module] = true
+				queue = append(queue, candidate{module: module, historical: historical})
+			}
+		}
+		return nil
+	}
+	if err := enqueue(current, nil); err != nil {
+		return nil, err
+	}
+	baselineScopes := make(map[string]map[string]breakingScope)
+	loadBaseline := func(ref string) (*gitadapter.Snapshot, map[string]breakingScope, error) {
+		snapshot := snapshots[ref]
+		if snapshot == nil {
+			var err error
+			snapshot, err = gitadapter.SnapshotRevision(ctx.Context, scanRoot, ref)
+			if err != nil {
+				return nil, nil, fmt.Errorf("SnapshotRevision: %w", err)
+			}
+			snapshots[ref] = snapshot
+		}
+		scopes, known := baselineScopes[ref]
+		if !known {
+			var err error
+			baselineReplacements := newPolicyReplacementSources(ctx.Context, snapshot.Root, snapshot.RepositoryRoot, func() (modules.Cache, error) { return cache, nil }, flags.IsFrozen(ctx))
+			scopes, err = selectedPolicyScopes(baselineReplacements, relative, flags.IsFrozen(ctx))
+			if err != nil {
+				return nil, nil, fmt.Errorf("selectedPolicyScopes: %w", err)
+			}
+			baselineScopes[ref] = scopes
+		}
+		return snapshot, scopes, nil
+	}
+	resolver := policyresolver.NewResolver(repositoryRoot, func(graphCtx context.Context, dir string) (modules.PolicyGraph, error) {
+		for _, snapshot := range snapshots {
+			relative, err := filepath.Rel(snapshot.Root, dir)
+			if err == nil && filepath.IsLocal(relative) {
+				return modules.ResolvePolicyGraphAt(graphCtx, dir, cache, flags.IsFrozen(ctx), func(target string) (string, error) { return snapshotReplacementPath(snapshot, dir, target) })
+			}
+		}
+		return modules.ResolvePolicyGraph(graphCtx, dir, cache, flags.IsFrozen(ctx))
+	})
+	if len(queue) == 0 {
+		// A wholly deleted scope has no current module from which to load a remote
+		// policy. An explicit baseline, or a resolvable local policy, supplies the
+		// historical graph. Never silently succeed without comparing the deletion.
+		var cfg config.BreakingCheck
+		if ctx.IsSet(flagAgainstBranchName.Name) {
+			unresolved := policy
+			unresolved.Breaking.Extends = ""
+			cfg, err = resolveV1BreakingConfig(ctx, unresolved)
+		} else {
+			moduleDir, findErr := findV1PolicyModuleDir(projectRoot, filepath.Dir(source))
+			if findErr != nil {
+				return nil, findErr
+			}
+			resolved, resolveErr := resolver.ResolveBreaking(ctx.Context, policyresolver.BreakingInput{PolicyPath: source, Policy: policy, Presence: policyFile.presence, ModuleDir: moduleDir})
+			if resolveErr != nil {
+				return nil, fmt.Errorf("deleted or empty scope needs --against to locate its historical policy graph: %w", resolveErr)
+			}
+			cfg, err = resolveV1BreakingConfig(ctx, resolved.Policy)
+		}
+		if err != nil {
+			return nil, err
+		}
+		snapshot, baseline, err := loadBaseline(cfg.AgainstGitRef)
+		if err != nil {
+			return nil, err
+		}
+		if err := enqueue(baseline, snapshot); err != nil {
+			return nil, err
+		}
+	}
+	var result []core.IssueInfo
+	for len(queue) > 0 {
+		item := queue[0]
+		queue = queue[1:]
+		module := item.module
+		moduleDir := policyDirectoryForReference(repositoryRoot, module)
+		if moduleDir == "" && item.historical != nil {
+			moduleDir = policyDirectoryForReference(item.historical.Root, module)
+		}
+		resolved, err := resolver.ResolveBreaking(ctx.Context, policyresolver.BreakingInput{PolicyPath: source, Policy: policy, Presence: policyFile.presence, ModuleDir: moduleDir})
+		if err != nil {
+			return nil, fmt.Errorf("resolve policy for consuming module %s: %w", module, err)
+		}
+		cfg, err := resolveV1BreakingConfig(ctx, resolved.Policy)
+		if err != nil {
+			return nil, fmt.Errorf("resolveV1BreakingConfig: %w", err)
+		}
+		snapshot, baseline, err := loadBaseline(cfg.AgainstGitRef)
+		if err != nil {
+			return nil, err
+		}
+		if err := enqueue(baseline, snapshot); err != nil {
+			return nil, err
+		}
+		currentFiles, baselineFiles := current[module].files, baseline[module].files
+		ownFiles := append(append([]string(nil), currentFiles...), baselineFiles...)
+		ignorePaths, err := breakingIgnorePaths(repositoryRoot, filepath.Dir(source), cfg.Ignore)
+		if err != nil {
+			return nil, fmt.Errorf("breakingIgnorePaths: %w", err)
+		}
+		currentImports, err := breakingImportRootsMode(ctx.Context, cache, repositoryRoot, module, currentFiles, nil, flags.IsFrozen(ctx))
+		if err != nil {
+			return nil, fmt.Errorf("current module %s: %w", module, err)
+		}
+		baselineImports, err := breakingImportRootsMode(ctx.Context, cache, snapshot.Root, module, baselineFiles, snapshot, flags.IsFrozen(ctx))
+		if err != nil {
+			return nil, fmt.Errorf("baseline %s module %s: %w", cfg.AgainstGitRef, module, err)
+		}
+		app := core.New(core.Options{Logger: log, ImportRoots: currentImports.Paths(), ImportFileAllowed: currentImports.FileAllowed(), BreakingCheckConfig: core.BreakingCheckConfig{
+			IgnoreDirs: append(append([]string(nil), ignorePaths...), defaultVendorDir), AgainstGitRef: cfg.AgainstGitRef,
+			FilesCheck: slices.Contains(cfg.Use, core.BreakingCheckFilesCheck), Categories: cfg.Categories, IgnoreUnstable: cfg.IgnoreUnstable,
+		}})
+		findings, err := app.CompareBreakingWithImports(ctx.Context, newBreakingWalker(repositoryRoot, currentFiles), newBreakingWalker(snapshot.Root, baselineFiles), baselineImports.Paths(), baselineImports.FileAllowed())
+		if err != nil {
+			return nil, fmt.Errorf("CompareBreaking module %s against %s: %w", module, cfg.AgainstGitRef, err)
+		}
+		for _, issue := range findings {
+			if slices.Contains(ownFiles, filepath.ToSlash(issue.Path)) {
+				_, owner, err := resolveV1BreakingPolicy(filepath.Dir(filepath.Join(repositoryRoot, issue.Path)), projectRoot, configPath)
+				if err != nil {
+					return nil, err
+				}
+				if owner != source {
+					continue
+				}
+			} else {
+				issue.Path = filepath.ToSlash(filepath.Join(module, issue.Path))
+			}
+			key := breakingIssueKey{path: issue.Path, rule: issue.RuleName, message: issue.Message, line: issue.Position.Line, column: issue.Position.Column}
+			if !seen[key] {
+				result = append(result, issue)
+				seen[key] = true
+			}
+		}
+	}
+	return result, nil
+}
+
+type breakingIssueKey struct {
+	path, rule, message string
+	line, column        int
+}
diff --git a/internal/api/breaking_v1_file_test.go b/internal/api/breaking_v1_file_test.go
new file mode 100644
index 00000000..c9ac6f87
--- /dev/null
+++ b/internal/api/breaking_v1_file_test.go
@@ -0,0 +1,84 @@
+package api
+
+import (
+	"flag"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestBreakingV1FileCategoryReachesChecker(t *testing.T) {
+	// buildCore configures process-wide comment-ignore state.
+	// Keep CLI scenarios sequential rather than sharing that state in parallel.
+	const header = "syntax = \"proto3\";\npackage example.v1;\n"
+	const declarations = `message Item {
+  string id = 1;
+  oneof value {
+    string text = 2;
+  }
+}
+enum State {
+  STATE_UNSPECIFIED = 0;
+}
+service ItemService {
+  rpc Get(Item) returns (Item);
+}
+`
+	tests := []struct {
+		name       string
+		categories string
+		removeID   bool
+		wantMoved  int
+		wantDelete int
+	}{
+		{name: "default detects moves", wantMoved: 4},
+		{name: "FILE detects moves", categories: "  categories: [FILE]\n", wantMoved: 4},
+		{name: "FILE preserves field checks", categories: "  categories: [FILE]\n", removeID: true, wantMoved: 4, wantDelete: 1},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			root := t.TempDir()
+			configPath := filepath.Join(root, "easyp.yaml")
+			writeV1GenerateFixture(t, root, "easyp.yaml", "version: v1\nbreaking:\n  baseline: git:baseline\n"+tt.categories)
+			writeV1GenerateFixture(t, root, "old.proto", header+declarations)
+			runTestGit(t, root, "init", "-q")
+			runTestGit(t, root, "add", ".")
+			runTestGit(t, root, "-c", "user.name=EasyP test", "-c", "user.email=test@example.test", "commit", "-qm", "baseline")
+			runTestGit(t, root, "branch", "baseline")
+			current := declarations
+			if tt.removeID {
+				current = strings.ReplaceAll(current, "  string id = 1;\n", "")
+			}
+			writeV1GenerateFixture(t, root, "old.proto", header)
+			writeV1GenerateFixture(t, root, "new.proto", header+current)
+			set := flag.NewFlagSet("test", flag.ContinueOnError)
+			set.String(flagLintDirectoryPath.Name, ".", "")
+			ctx := cli.NewContext(&cli.App{}, set, nil)
+			ctx.Context = t.Context()
+
+			issues, err := (BreakingCheck{}).checkV1Policies(ctx, logger.NewNop(), configPath, root, root)
+
+			require.NoError(t, err)
+			moved, deleted := 0, 0
+			for _, issue := range issues {
+				if strings.Contains(issue.Message, "was moved") {
+					moved++
+					assert.Contains(t, issue.Message, "old.proto")
+					assert.Contains(t, issue.Message, "new.proto")
+				}
+				if strings.Contains(issue.Message, "was deleted") {
+					deleted++
+				}
+			}
+			assert.Equal(t, tt.wantMoved, moved, "%+v", issues)
+			assert.Equal(t, tt.wantDelete, deleted, "%+v", issues)
+			assert.Len(t, issues, tt.wantMoved+tt.wantDelete)
+		})
+	}
+}
diff --git a/internal/api/breaking_v1_only_test.go b/internal/api/breaking_v1_only_test.go
new file mode 100644
index 00000000..3cae6092
--- /dev/null
+++ b/internal/api/breaking_v1_only_test.go
@@ -0,0 +1,28 @@
+package api
+
+import (
+	"flag"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/flags"
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestBreakingRejectsLegacyConfig(t *testing.T) {
+	t.Parallel()
+
+	configPath := filepath.Join(t.TempDir(), "easyp.yaml")
+	require.NoError(t, os.WriteFile(configPath, []byte("breaking_check:\n  against_git_ref: main\n"), 0o644))
+	set := flag.NewFlagSet("test", flag.ContinueOnError)
+	set.String(flags.Config.Name, configPath, "")
+	require.NoError(t, set.Set(flags.Config.Name, configPath))
+	ctx := cli.NewContext(&cli.App{Metadata: map[string]any{}}, set, nil)
+	ctx.Context = t.Context()
+	err := (BreakingCheck{}).action(ctx, logger.NewNop())
+	require.ErrorContains(t, err, "ParsePolicy")
+}
diff --git a/internal/api/breaking_v1_test.go b/internal/api/breaking_v1_test.go
new file mode 100644
index 00000000..ba953132
--- /dev/null
+++ b/internal/api/breaking_v1_test.go
@@ -0,0 +1,58 @@
+package api
+
+import (
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestResolveV1BreakingPolicyInheritsWholeSection(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name         string
+		childPolicy  string
+		wantSource   string
+		wantBaseline string
+		wantIgnore   []string
+	}{
+		{
+			name:         "inherit_missing_section",
+			childPolicy:  "version: v1\nlinters:\n  default: MINIMAL\n",
+			wantSource:   "easyp.yaml",
+			wantBaseline: "git:main",
+			wantIgnore:   []string{"generated"},
+		},
+		{
+			name:        "explicit_empty_section",
+			childPolicy: "version: v1\nbreaking: {}\n",
+			wantSource:  "nested/easyp.yaml",
+		},
+		{
+			name:         "replace_whole_section",
+			childPolicy:  "version: v1\nbreaking:\n  baseline: git:release\n",
+			wantSource:   "nested/easyp.yaml",
+			wantBaseline: "git:release",
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			child := filepath.Join(root, "nested")
+			writeV1GenerateFixture(t, root, "easyp.yaml", "version: v1\nbreaking:\n  baseline: git:main\n  ignore: [generated]\n")
+			writeV1GenerateFixture(t, child, "easyp.yaml", tt.childPolicy)
+
+			policy, source, err := resolveV1BreakingPolicy(child, root, filepath.Join(root, "easyp.yaml"))
+
+			require.NoError(t, err)
+			assert.Equal(t, filepath.Join(root, tt.wantSource), source)
+			assert.Equal(t, tt.wantBaseline, policy.Breaking.Baseline)
+			assert.Equal(t, tt.wantIgnore, policy.Breaking.Ignore)
+		})
+	}
+}
diff --git a/internal/api/completion.go b/internal/api/completion.go
index 3ba2ed1c..7f15bf3e 100644
--- a/internal/api/completion.go
+++ b/internal/api/completion.go
@@ -6,7 +6,7 @@ import (
 	"github.com/urfave/cli/v2"
 )
 
-var _ Handler = (*Mod)(nil)
+var _ Handler = (*Completion)(nil)
 
 type Completion struct{}
 
diff --git a/internal/api/frozen_scopes.go b/internal/api/frozen_scopes.go
new file mode 100644
index 00000000..5bf69511
--- /dev/null
+++ b/internal/api/frozen_scopes.go
@@ -0,0 +1,75 @@
+package api
+
+import (
+	"fmt"
+	"io/fs"
+	"os"
+	"path/filepath"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// selectedPolicyScopes retains explicit empty modules in frozen mode, so
+// deleting the last source cannot bypass validation of the current graph.
+func selectedPolicyScopes(replacements *policyReplacementSources, relative string, frozen bool) (map[string]breakingScope, error) {
+	root := replacements.projectRoot
+	scopes, err := discoverBreakingScopes(replacements, relative)
+	if err != nil || !frozen {
+		return scopes, err
+	}
+	scan := filepath.Join(root, relative)
+	info, err := os.Stat(scan)
+	if os.IsNotExist(err) {
+		return scopes, nil
+	}
+	if err != nil {
+		return nil, fmt.Errorf("Stat: %w", err)
+	}
+	directory := scan
+	if !info.IsDir() {
+		directory = filepath.Dir(scan)
+	}
+	nearest, err := findV1PolicyModuleDir(root, directory)
+	if err != nil {
+		return nil, fmt.Errorf("findV1PolicyModuleDir: %w", err)
+	}
+	add := func(directory string) error {
+		key, err := filepath.Rel(root, directory)
+		if err != nil {
+			return fmt.Errorf("Rel: %w", err)
+		}
+		if _, exists := scopes[key]; !exists {
+			scopes[key] = breakingScope{}
+		}
+		return nil
+	}
+	if nearest != "" {
+		if err := add(nearest); err != nil {
+			return nil, err
+		}
+	}
+	if info.IsDir() {
+		err := filepath.WalkDir(scan, func(path string, entry fs.DirEntry, walkErr error) error {
+			if walkErr != nil {
+				return walkErr
+			}
+			if policySourceExcluded(root, path) {
+				if entry.IsDir() {
+					return filepath.SkipDir
+				}
+				return nil
+			}
+			if !entry.IsDir() && entry.Name() == v1.ModuleFile {
+				return add(filepath.Dir(path))
+			}
+			return nil
+		})
+		if err != nil {
+			return nil, fmt.Errorf("WalkDir: %w", err)
+		}
+	}
+	if nearest == "" && len(scopes) == 0 {
+		return nil, fmt.Errorf("frozen policy check requires protobuf.mod for %s", scan)
+	}
+	return scopes, nil
+}
diff --git a/internal/api/frozen_test.go b/internal/api/frozen_test.go
new file mode 100644
index 00000000..102a0337
--- /dev/null
+++ b/internal/api/frozen_test.go
@@ -0,0 +1,75 @@
+package api
+
+import (
+	"flag"
+	"github.com/easyp-tech/easyp/internal/logger"
+	"io"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+)
+
+func TestFrozenMutationCommandsRefuseBeforeAccess(t *testing.T) {
+	// Command constructors still contain shared legacy flags; keep parsers sequential.
+	for _, args := range [][]string{
+		{"get", "--frozen", "example.com/missing@v1.0.0"},
+		{"mod", "--frozen", "update"},
+		{"mod", "update", "--frozen"},
+		{"mod", "tidy", "--frozen"},
+		{"init", "--frozen", "--dir", "/must-not-be-created"},
+		{"migrate", "--frozen", "--write"},
+	} {
+		t.Run(args[0]+"/"+args[1], func(t *testing.T) {
+			app := &cli.App{Writer: io.Discard, ErrWriter: io.Discard, Commands: []*cli.Command{
+				(Get{}).Command(), (Mod{}).Command(), (Init{}).Command(), (Migrate{}).Command(),
+			}}
+			err := app.RunContext(t.Context(), append([]string{"easyp"}, args...))
+			require.ErrorContains(t, err, "not allowed in frozen mode")
+		})
+	}
+}
+
+func TestFrozenBreakingValidatesEmptyExplicitModule(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, "protobuf.mod", "module example.com/empty\n")
+	_, err := breakingImportRootsMode(t.Context(), nil, root, ".", nil, nil, true)
+	require.ErrorContains(t, err, "protobuf.lock")
+	writeV1GenerateFixture(t, root, "protobuf.lock", "version: 1\nmodules: []\n")
+	_, err = breakingImportRootsMode(t.Context(), nil, root, ".", nil, nil, true)
+	require.NoError(t, err)
+}
+
+func TestFrozenLintValidatesEmptyDescendantModule(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, "protobuf.mod", "module example.com/root\n")
+	writeV1GenerateFixture(t, root, "protobuf.lock", "version: 1\nmodules: []\n")
+	writeV1GenerateFixture(t, root, "easyp.yaml", "version: v1\nlinters:\n  default: MINIMAL\n")
+	writeV1GenerateFixture(t, root, "child/protobuf.mod", "module example.com/child\n")
+	set := flag.NewFlagSet("test", flag.ContinueOnError)
+	set.Bool("frozen", true, "")
+	set.String("path", ".", "")
+	ctx := cli.NewContext(&cli.App{}, set, nil)
+	ctx.Context = t.Context()
+	err := (Lint{}).actionV1(ctx, logger.NewNop(), filepath.Join(root, "easyp.yaml"), root, root)
+	require.ErrorContains(t, err, "protobuf.lock")
+	require.ErrorContains(t, err, "child")
+}
+
+func TestFrozenLintExcludedSourcesStillRequireManifest(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, "easyp.yaml", "version: v1\nissues:\n  exclude-rules: [{}]\n")
+	writeV1GenerateFixture(t, root, "api.proto", "syntax = \"proto3\";\n")
+	set := flag.NewFlagSet("test", flag.ContinueOnError)
+	set.Bool("frozen", true, "")
+	set.String("path", ".", "")
+	ctx := cli.NewContext(&cli.App{}, set, nil)
+	ctx.Context = t.Context()
+	err := (Lint{}).actionV1(ctx, logger.NewNop(), filepath.Join(root, "easyp.yaml"), root, root)
+	require.ErrorContains(t, err, "protobuf.mod")
+	require.ErrorContains(t, err, "frozen")
+}
diff --git a/internal/api/generate.go b/internal/api/generate.go
index 2fcc6fbd..0d375e85 100644
--- a/internal/api/generate.go
+++ b/internal/api/generate.go
@@ -1,17 +1,13 @@
 package api
 
 import (
-	"errors"
 	"fmt"
 	"os"
-	"path/filepath"
 
 	"github.com/urfave/cli/v2"
 
-	"github.com/easyp-tech/easyp/internal/config"
-	"github.com/easyp-tech/easyp/internal/core"
 	"github.com/easyp-tech/easyp/internal/flags"
-	"github.com/easyp-tech/easyp/internal/fs/fs"
+	"github.com/easyp-tech/easyp/internal/generation"
 )
 
 var _ Handler = (*Generate)(nil)
@@ -20,36 +16,28 @@ var _ Handler = (*Generate)(nil)
 type Generate struct{}
 
 var (
-	flagGenerateDirectoryPath = &cli.StringFlag{
-		Name:       "path",
-		Usage:      "set path to directory with proto files",
-		Required:   true,
-		HasBeenSet: true,
-		Value:      ".",
-		Aliases:    []string{"p"},
-		EnvVars:    []string{"EASYP_ROOT_GENERATE_PATH"},
-	}
-
-	flagGenerateRoot = &cli.StringFlag{
-		Name:       "root",
-		Usage:      "set root directory for file search (default: current working directory)",
-		Required:   false,
-		HasBeenSet: false,
-		Value:      "",
-		Aliases:    []string{"r"},
-	}
-
 	flagGenerateDescriptorSetOut = &cli.StringFlag{
 		Name:     "descriptor_set_out",
 		Usage:    "output path for the binary FileDescriptorSet",
 		Required: false,
 	}
 
+	flagGenerateDescriptorSetOutDir = &cli.StringFlag{
+		Name:  "descriptor_set_out_dir",
+		Usage: "output directory for one binary FileDescriptorSet per project and module (exclusive with descriptor_set_out)",
+	}
+
+	flagGenerateAll            = &cli.BoolFlag{Name: "all", Usage: "explicitly select all generation projects below the working directory"}
+	flagGenerateWorkspace      = &cli.StringFlag{Name: "workspace", Usage: "explicit workspace root for repository-relative module paths"}
 	flagGenerateIncludeImports = &cli.BoolFlag{
 		Name:     "include_imports",
 		Usage:    "include all transitive dependencies in the FileDescriptorSet",
 		Required: false,
 	}
+	flagGenerateProject = &cli.StringSliceFlag{
+		Name:  "project",
+		Usage: "select a consumer project directory (repeatable)",
+	}
 )
 
 // Command implements Handler.
@@ -62,10 +50,13 @@ func (g Generate) Command() *cli.Command {
 		Description: "generate code from proto files",
 		Action:      g.Action,
 		Flags: []cli.Flag{
-			flagGenerateDirectoryPath,
-			flagGenerateRoot,
+			flags.Frozen(),
 			flagGenerateDescriptorSetOut,
+			flagGenerateDescriptorSetOutDir,
 			flagGenerateIncludeImports,
+			flagGenerateProject,
+			flagGenerateAll,
+			flagGenerateWorkspace,
 		},
 		HelpName: "help",
 	}
@@ -73,73 +64,20 @@ func (g Generate) Command() *cli.Command {
 
 // Action implements Handler.
 func (g Generate) Action(ctx *cli.Context) error {
-	log := getLogger(ctx)
-
-	configPath, projectRoot, generateRoot, err := resolveRoots(ctx, flagGenerateRoot.Name)
-	if err != nil {
-		return err
-	}
-
-	cfg, err := config.New(ctx.Context, configPath)
-	if err != nil {
-		return fmt.Errorf("config.New: %w", err)
-	}
-
-	// Walker for Core (lockfile etc) - strictly based on project root
-	projectWalker := fs.NewFSWalker(projectRoot, ".")
-	app, err := buildCore(ctx.Context, log, *cfg, projectWalker)
-	if err != nil {
-		return fmt.Errorf("buildCore: %w", err)
-	}
-
-	dir := ctx.String(flagGenerateDirectoryPath.Name)
-	descriptorSetOut := ctx.String(flagGenerateDescriptorSetOut.Name)
-	includeImports := ctx.Bool(flagGenerateIncludeImports.Name)
-
-	if err := app.Generate(ctx.Context, generateRoot, dir, descriptorSetOut, includeImports); err != nil {
-		if errors.Is(err, core.ErrEmptyInputFiles) {
-			log.Warn(ctx.Context, "empty input files!")
-			return nil
-		}
-		return fmt.Errorf("generator.Generate: %w", err)
+	if ctx.String(flagGenerateDescriptorSetOut.Name) != "" && ctx.String(flagGenerateDescriptorSetOutDir.Name) != "" {
+		return fmt.Errorf("--descriptor_set_out and --descriptor_set_out_dir are mutually exclusive")
 	}
-
-	return nil
-}
-
-// resolveRoots computes configPath (absolute), projectRoot (dir of config), and operation root based on provided root flag.
-func resolveRoots(ctx *cli.Context, rootFlagName string) (string, string, string, error) {
-	workingDir, err := os.Getwd()
+	root, err := os.Getwd()
 	if err != nil {
-		return "", "", "", fmt.Errorf("os.Getwd: %w", err)
+		return fmt.Errorf("Getwd: %w", err)
 	}
-
-	root := ctx.String(rootFlagName)
-	configPath := ctx.String(flags.Config.Name)
-
-	// 1. Determine Project Root (for config and lockfile)
-	if !filepath.IsAbs(configPath) {
-		configPath = filepath.Join(workingDir, configPath)
-	}
-	projectRoot := filepath.Dir(configPath)
-
-	// 2. Determine operation root (where to search for files)
-	var opRoot string
-	if root != "" {
-		if filepath.IsAbs(root) {
-			opRoot = root
-		} else {
-			opRoot = filepath.Join(workingDir, root)
-		}
-	} else {
-		opRoot = projectRoot
-	}
-
-	// Normalize to absolute path
-	opRoot, err = filepath.Abs(opRoot)
+	cache, err := moduleCache(ctx)
 	if err != nil {
-		return "", "", "", fmt.Errorf("filepath.Abs(opRoot): %w", err)
+		return fmt.Errorf("moduleCache: %w", err)
 	}
-
-	return configPath, projectRoot, opRoot, nil
+	return generation.Run(ctx.Context, getLogger(ctx), cache, generation.Request{
+		Frozen: flags.IsFrozen(ctx), WorkDir: root, Projects: ctx.StringSlice(flagGenerateProject.Name), AllProjects: ctx.Bool(flagGenerateAll.Name), WorkspaceRoot: ctx.String(flagGenerateWorkspace.Name),
+		DescriptorSetOut:    ctx.String(flagGenerateDescriptorSetOut.Name),
+		DescriptorSetOutDir: ctx.String(flagGenerateDescriptorSetOutDir.Name), IncludeImports: ctx.Bool(flagGenerateIncludeImports.Name),
+	})
 }
diff --git a/internal/api/generate_action_test.go b/internal/api/generate_action_test.go
new file mode 100644
index 00000000..10e26ba6
--- /dev/null
+++ b/internal/api/generate_action_test.go
@@ -0,0 +1,22 @@
+package api
+
+import (
+	"flag"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+)
+
+func TestGenerateRequiresV1Config(t *testing.T) {
+	root := t.TempDir()
+	t.Chdir(root)
+	require.NoError(t, os.WriteFile(filepath.Join(root, "easyp.yaml"), []byte("generate:\n  inputs: []\n"), 0o644))
+
+	ctx := cli.NewContext(&cli.App{Metadata: map[string]any{}}, flag.NewFlagSet("test", flag.ContinueOnError), nil)
+	ctx.Context = t.Context()
+	err := (Generate{}).Action(ctx)
+	require.ErrorContains(t, err, "easyp migrate")
+}
diff --git a/internal/api/generate_descriptor_flags_test.go b/internal/api/generate_descriptor_flags_test.go
new file mode 100644
index 00000000..f5102ad8
--- /dev/null
+++ b/internal/api/generate_descriptor_flags_test.go
@@ -0,0 +1,15 @@
+package api
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+)
+
+func TestGenerateRejectsConflictingDescriptorOutputFlags(t *testing.T) {
+	t.Parallel()
+	app := &cli.App{Commands: []*cli.Command{(Generate{}).Command()}}
+	err := app.RunContext(t.Context(), []string{"easyp", "generate", "--descriptor_set_out", "all.pb", "--descriptor_set_out_dir", "sets"})
+	require.ErrorContains(t, err, "mutually exclusive")
+}
diff --git a/internal/api/get_v1.go b/internal/api/get_v1.go
new file mode 100644
index 00000000..5a79c7ea
--- /dev/null
+++ b/internal/api/get_v1.go
@@ -0,0 +1,101 @@
+package api
+
+import (
+	"errors"
+	"fmt"
+	"strings"
+
+	"github.com/urfave/cli/v2"
+	"golang.org/x/mod/semver"
+
+	"github.com/easyp-tech/easyp/internal/adapters/gitmodules"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/flags"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+// Get adds a direct module requirement and resolves its dependency graph.
+type Get struct{}
+
+var _ Handler = Get{}
+
+func (g Get) Command() *cli.Command {
+	return &cli.Command{
+		Name:      "get",
+		Flags:     []cli.Flag{flags.Frozen()},
+		Usage:     "add a Git module and its transitive dependencies",
+		ArgsUsage: "<module>[@version|@tag|@commit]",
+		Action:    g.Action,
+	}
+}
+
+func (g Get) Action(ctx *cli.Context) error {
+	if flags.IsFrozen(ctx) {
+		return fmt.Errorf("get is not allowed in frozen mode")
+	}
+	if ctx.NArg() != 1 {
+		return errors.New("get expects one module: easyp get <module>[@version|@tag|@commit]")
+	}
+	requirement, err := parseV1GetRequirement(ctx.Args().First())
+	if err != nil {
+		return fmt.Errorf("parseV1GetRequirement: %w", err)
+	}
+	root, err := moduleWorkingDir()
+	if err != nil {
+		return fmt.Errorf("moduleWorkingDir: %w", err)
+	}
+	cache, err := moduleCache(ctx)
+	if err != nil {
+		return fmt.Errorf("moduleCache: %w", err)
+	}
+	if requirement.Version != "" && !semver.IsValid(requirement.Version) && !v1.IsCommitRef(requirement.Version) {
+		_, module, err := modules.ReadManifest(root)
+		if err != nil {
+			return fmt.Errorf("ReadManifest: %w", err)
+		}
+		if module.Name == requirement.Module {
+			return fmt.Errorf("module %s cannot require itself", module.Name)
+		}
+		commit, err := cache.ResolveTag(ctx.Context, requirement.Module, requirement.Version)
+		if err != nil {
+			return fmt.Errorf("ResolveTag: %w", err)
+		}
+		requirement.Version = commit
+	}
+	return modules.Get(ctx.Context, root, requirement, cache)
+}
+
+func parseV1GetRequirement(spec string) (v1.Requirement, error) {
+	version := ""
+	source := spec
+	// The @ in an SSH URL's authority is not a version separator.
+	authorityEnd := -1
+	if scheme := strings.Index(spec, "://"); scheme >= 0 {
+		if slash := strings.Index(spec[scheme+3:], "/"); slash >= 0 {
+			authorityEnd = scheme + 3 + slash
+		} else {
+			authorityEnd = len(spec)
+		}
+	}
+	if at := strings.LastIndex(spec, "@"); at > authorityEnd {
+		source, version = spec[:at], spec[at+1:]
+		if version == "" || strings.ContainsAny(version, " \t\r\n") {
+			return v1.Requirement{}, fmt.Errorf("get %q: expected a version, Git tag or full Git commit after @", spec)
+		}
+	}
+	if strings.ContainsAny(source, " \t\r\n") {
+		return v1.Requirement{}, fmt.Errorf("get %q: invalid module identity", spec)
+	}
+	if err := gitmodules.ValidateSource(source); err != nil {
+		return v1.Requirement{}, fmt.Errorf("get %q: %w", spec, err)
+	}
+	major, err := v1.ModulePathMajor(source)
+	if err != nil {
+		return v1.Requirement{}, fmt.Errorf("ModulePathMajor: %w", err)
+	}
+	if major == "" && semver.IsValid(version) && semver.Major(version) != "v0" && semver.Major(version) != "v1" && semver.Build(version) == "" {
+		// Fetch still verifies that this revision has no native protobuf.mod.
+		version += "+incompatible"
+	}
+	return v1.Requirement{Module: source, Version: version}, nil
+}
diff --git a/internal/api/get_v1_test.go b/internal/api/get_v1_test.go
new file mode 100644
index 00000000..5988fa91
--- /dev/null
+++ b/internal/api/get_v1_test.go
@@ -0,0 +1,194 @@
+package api
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+func TestGetAddsDirectAndTransitiveRequirements(t *testing.T) {
+	repository := filepath.Join(t.TempDir(), "contracts")
+	foo := filepath.Join(repository, "foo")
+	bar := filepath.Join(repository, "bar")
+	baz := filepath.Join(repository, "baz")
+	for name, body := range map[string]string{
+		"foo/protobuf.mod":    fmt.Sprintf("module %s\nroots proto\nrequire %s\n", foo, bar),
+		"foo/proto/foo.proto": "syntax = \"proto3\";\npackage foo.v1;\nimport \"bar.proto\";\nmessage Foo { bar.v1.Bar bar = 1; }\n",
+		"bar/protobuf.mod":    fmt.Sprintf("module %s\nroots proto\nrequire %s\n", bar, baz),
+		"bar/proto/bar.proto": "syntax = \"proto3\";\npackage bar.v1;\nimport \"baz.proto\";\nmessage Bar { baz.v1.Baz baz = 1; }\n",
+		"baz/protobuf.mod":    fmt.Sprintf("module %s\nroots proto\n", baz),
+		"baz/proto/baz.proto": "syntax = \"proto3\";\npackage baz.v1;\nmessage Baz {}\n",
+	} {
+		path := filepath.Join(repository, name)
+		require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+		require.NoError(t, os.WriteFile(path, []byte(body), 0o644))
+	}
+	runTestGit(t, repository, "init", "-q")
+	runTestGit(t, repository, "add", ".")
+	runTestGit(t, repository, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+
+	root := t.TempDir()
+	require.NoError(t, os.MkdirAll(filepath.Join(root, "proto"), 0o755))
+	require.NoError(t, os.WriteFile(filepath.Join(root, "protobuf.mod"), []byte("module example.com/app\nroots proto\n"), 0o644))
+	require.NoError(t, os.WriteFile(filepath.Join(root, "proto", "app.proto"), []byte("syntax = \"proto3\";\nimport \"foo.proto\";\n"), 0o644))
+	t.Setenv("EASYPPATH", filepath.Join(t.TempDir(), "cache"))
+	t.Chdir(root)
+	app := &cli.App{Commands: []*cli.Command{(Get{}).Command(), (Mod{}).Command()}, Metadata: map[string]any{}}
+	args := []string{"easyp", "get", foo}
+	require.NoError(t, app.Run(args))
+
+	manifest, err := os.ReadFile(filepath.Join(root, "protobuf.mod"))
+	require.NoError(t, err)
+	require.Contains(t, string(manifest), "require "+foo+"\n")
+	require.NotContains(t, string(manifest), "require "+foo+" // indirect")
+	lock, err := modules.ReadLock(filepath.Join(root, "protobuf.lock"))
+	require.NoError(t, err)
+	require.Len(t, lock.Modules, 3)
+	for _, entry := range lock.Modules {
+		require.True(t, entry.Source == foo || entry.Source == bar || entry.Source == baz)
+		require.Equal(t, entry.Commit, entry.Version)
+		require.True(t, strings.HasPrefix(entry.Hash, "h1:"))
+		if entry.Source == bar || entry.Source == baz {
+			require.Contains(t, string(manifest), "require "+entry.Source+" // indirect\n")
+		}
+	}
+
+	require.NoError(t, app.Run(args))
+	again, err := os.ReadFile(filepath.Join(root, "protobuf.mod"))
+	require.NoError(t, err)
+	require.Equal(t, string(manifest), string(again))
+	require.NoError(t, app.Run([]string{"easyp", "mod", "tidy"}))
+	afterTidy, err := os.ReadFile(filepath.Join(root, "protobuf.mod"))
+	require.NoError(t, err)
+	require.Equal(t, string(manifest), string(afterTidy))
+}
+
+func TestParseV1GetRequirement(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name    string
+		input   string
+		module  string
+		version string
+		wantErr string
+	}{
+		{name: "nested URL", input: "https://github.com/acme/repo.git/foo", module: "https://github.com/acme/repo.git/foo"},
+		{name: "tag", input: "github.com/acme/repo/foo@v1.2.3", module: "github.com/acme/repo/foo", version: "v1.2.3"},
+		{name: "commit", input: "github.com/acme/repo@" + strings.Repeat("a", 40), module: "github.com/acme/repo", version: strings.Repeat("a", 40)},
+		{name: "named tag", input: "github.com/acme/repo@common-protos-1_3_1", module: "github.com/acme/repo", version: "common-protos-1_3_1"},
+		{name: "tag with slash", input: "github.com/acme/repo@schemas/stable", module: "github.com/acme/repo", version: "schemas/stable"},
+		{name: "SSH authority", input: "ssh://git@example.com/acme/repo", module: "ssh://git@example.com/acme/repo"},
+		{name: "SSH authority and tag", input: "ssh://git@example.com/acme/repo@schemas/stable", module: "ssh://git@example.com/acme/repo", version: "schemas/stable"},
+		{name: "legacy major query", input: "github.com/acme/repo@v2.26.1", module: "github.com/acme/repo", version: "v2.26.1+incompatible"},
+		{name: "native major query", input: "github.com/acme/repo/v2@v2.26.1", module: "github.com/acme/repo/v2", version: "v2.26.1"},
+		{name: "empty version", input: "github.com/acme/repo@", wantErr: "expected a version"},
+		{name: "invalid module", input: "github.com/acme/../repo", wantErr: "invalid Git module identity"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			got, err := parseV1GetRequirement(tt.input)
+			if tt.wantErr != "" {
+				require.ErrorContains(t, err, tt.wantErr)
+				return
+			}
+			require.NoError(t, err)
+			require.Equal(t, tt.module, got.Module)
+			require.Equal(t, tt.version, got.Version)
+		})
+	}
+}
+
+func TestGetPromotesIndirectAndPinsExplicitCommit(t *testing.T) {
+	dependency := filepath.Join(t.TempDir(), "dependency")
+	require.NoError(t, os.MkdirAll(dependency, 0o755))
+	require.NoError(t, os.WriteFile(filepath.Join(dependency, "protobuf.mod"), []byte("module "+dependency+"\n"), 0o644))
+	require.NoError(t, os.WriteFile(filepath.Join(dependency, "dep.proto"), []byte("syntax = \"proto3\";\nmessage Dep {}\n"), 0o644))
+	runTestGit(t, dependency, "init", "-q")
+	runTestGit(t, dependency, "add", ".")
+	runTestGit(t, dependency, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+	first := strings.TrimSpace(runTestGit(t, dependency, "rev-parse", "HEAD"))
+	require.NoError(t, os.WriteFile(filepath.Join(dependency, "dep.proto"), []byte("syntax = \"proto3\";\nmessage Dep { string id = 1; }\n"), 0o644))
+	runTestGit(t, dependency, "add", ".")
+	runTestGit(t, dependency, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "update")
+	latest := strings.TrimSpace(runTestGit(t, dependency, "rev-parse", "HEAD"))
+
+	root := t.TempDir()
+	manifest := fmt.Sprintf("module example.com/app\nrequire (\n  %s %s // indirect\n)\n", dependency, first)
+	require.NoError(t, os.WriteFile(filepath.Join(root, "protobuf.mod"), []byte(manifest), 0o644))
+	t.Setenv("EASYPPATH", filepath.Join(t.TempDir(), "cache"))
+	t.Chdir(root)
+	app := &cli.App{Commands: []*cli.Command{(Get{}).Command()}, Metadata: map[string]any{}}
+	require.NoError(t, app.Run([]string{"easyp", "get", dependency + "@" + latest}))
+	updated, err := os.ReadFile(filepath.Join(root, "protobuf.mod"))
+	require.NoError(t, err)
+	require.Contains(t, string(updated), dependency+" "+latest+"\n")
+	require.NotContains(t, string(updated), "// indirect")
+	lock, err := modules.ReadLock(filepath.Join(root, "protobuf.lock"))
+	require.NoError(t, err)
+	require.Len(t, lock.Modules, 1)
+	require.Equal(t, latest, lock.Modules[0].Commit)
+}
+
+func TestGetRejectsBadArgumentWithoutChangingManifest(t *testing.T) {
+	// The CLI finds protobuf.mod through the process working directory.
+	tests := []struct {
+		name    string
+		input   string
+		wantErr string
+	}{
+		{name: "empty_tag", input: "github.com/acme/repo@", wantErr: "expected a version"},
+		{name: "invalid_identity", input: "github.com/acme/../repo", wantErr: "invalid Git module identity"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			root := t.TempDir()
+			manifest := []byte("module example.com/app\n")
+			require.NoError(t, os.WriteFile(filepath.Join(root, "protobuf.mod"), manifest, 0o644))
+			t.Chdir(root)
+			app := &cli.App{Commands: []*cli.Command{(Get{}).Command()}, Metadata: map[string]any{}}
+
+			err := app.Run([]string{"easyp", "get", tt.input})
+
+			require.ErrorContains(t, err, tt.wantErr)
+			current, err := os.ReadFile(filepath.Join(root, "protobuf.mod"))
+			require.NoError(t, err)
+			require.Equal(t, manifest, current)
+			_, err = os.Stat(filepath.Join(root, "protobuf.lock"))
+			require.ErrorIs(t, err, os.ErrNotExist)
+		})
+	}
+}
+
+func TestGetResolutionFailureLeavesManifestAndLockUnchanged(t *testing.T) {
+	dependency := filepath.Join(t.TempDir(), "dependency")
+	require.NoError(t, os.MkdirAll(dependency, 0o755))
+	require.NoError(t, os.WriteFile(filepath.Join(dependency, "protobuf.mod"), []byte("module "+dependency+"\n"), 0o644))
+	require.NoError(t, os.WriteFile(filepath.Join(dependency, "dep.proto"), []byte("syntax = \"proto3\";\nmessage Dep {}\n"), 0o644))
+	runTestGit(t, dependency, "init", "-q")
+	runTestGit(t, dependency, "add", ".")
+	runTestGit(t, dependency, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+
+	root := t.TempDir()
+	manifest := []byte("module example.com/app\n")
+	require.NoError(t, os.WriteFile(filepath.Join(root, "protobuf.mod"), manifest, 0o644))
+	require.NoError(t, os.WriteFile(filepath.Join(root, "app.proto"), []byte("syntax = \"proto3\";\nimport \"missing.proto\";\n"), 0o644))
+	t.Setenv("EASYPPATH", filepath.Join(t.TempDir(), "cache"))
+	t.Chdir(root)
+	app := &cli.App{Commands: []*cli.Command{(Get{}).Command()}, Metadata: map[string]any{}}
+	require.ErrorContains(t, app.Run([]string{"easyp", "get", dependency}), "cannot resolve imports")
+	current, err := os.ReadFile(filepath.Join(root, "protobuf.mod"))
+	require.NoError(t, err)
+	require.Equal(t, manifest, current)
+	_, err = os.Stat(filepath.Join(root, "protobuf.lock"))
+	require.ErrorIs(t, err, os.ErrNotExist)
+}
diff --git a/internal/api/init.go b/internal/api/init.go
index c831e528..511515b2 100644
--- a/internal/api/init.go
+++ b/internal/api/init.go
@@ -2,14 +2,13 @@ package api
 
 import (
 	"fmt"
+	"os"
+	"path/filepath"
 
 	"github.com/urfave/cli/v2"
 
 	"github.com/easyp-tech/easyp/internal/adapters/prompter"
-	"github.com/easyp-tech/easyp/internal/config"
-	"github.com/easyp-tech/easyp/internal/core"
-	"github.com/easyp-tech/easyp/internal/fs/fs"
-	"github.com/easyp-tech/easyp/internal/rules"
+	"github.com/easyp-tech/easyp/internal/flags"
 )
 
 var _ Handler = (*Init)(nil)
@@ -19,13 +18,15 @@ type Init struct{}
 
 var (
 	flagInitDirectoryPath = &cli.StringFlag{
-		Name:       "dir",
-		Usage:      "directory path to initialize",
-		Required:   true,
-		HasBeenSet: true,
-		Value:      ".",
-		Aliases:    []string{"d"},
-		EnvVars:    []string{"EASYP_INIT_DIR"},
+		Name:    "dir",
+		Usage:   "directory path to initialize",
+		Value:   ".",
+		Aliases: []string{"d"},
+		EnvVars: []string{"EASYP_INIT_DIR"},
+	}
+	flagInitModule = &cli.StringFlag{
+		Name:  "module",
+		Usage: "canonical protobuf module identity for a new v1 project",
 	}
 )
 
@@ -34,58 +35,34 @@ func (i Init) Command() *cli.Command {
 	return &cli.Command{
 		Name:        "init",
 		Aliases:     []string{"i"},
-		Usage:       "initialize configuration",
-		UsageText:   "initialize configuration",
-		Description: "initialize configuration",
+		Usage:       "initialize native v1 project configuration",
+		UsageText:   "easyp init [--dir DIR] [--module MODULE]",
+		Description: "Create protobuf.mod, easyp.yaml, and easyp.gen.yaml without overwriting files unless confirmed.",
 		Action:      i.Action,
 		Flags: []cli.Flag{
+			flags.Frozen(),
 			flagInitDirectoryPath,
+			flagInitModule,
 		},
 	}
 }
 
 // Action implements Handler.
 func (i Init) Action(ctx *cli.Context) error {
-	log := getLogger(ctx)
-
-	rootPath := ctx.String(flagInitDirectoryPath.Name)
-	dirFS := fs.NewFSWalker(rootPath, ".")
-
-	cfg := &config.Config{}
-
-	app, err := buildCore(ctx.Context, log, *cfg, dirFS)
-	if err != nil {
-		return fmt.Errorf("buildCore: %w", err)
-	}
-
-	opts := core.InitOptions{
-		TemplateData: defaultTemplateData(),
-		Prompter:     prompter.InteractivePrompter{},
+	if flags.IsFrozen(ctx) {
+		return fmt.Errorf("init is not allowed in frozen mode")
 	}
-
-	err = app.Initialize(ctx.Context, dirFS, opts)
+	rootAbs, err := filepath.Abs(ctx.String(flagInitDirectoryPath.Name))
 	if err != nil {
-		return fmt.Errorf("app.Initialize: %w", err)
+		return fmt.Errorf("Abs: %w", err)
 	}
-
-	return nil
-}
-
-// defaultTemplateData builds InitTemplateData from all available rule groups.
-func defaultTemplateData() core.InitTemplateData {
-	groups := rules.AllGroups()
-	lintGroups := make([]core.LintGroup, len(groups))
-	for i, g := range groups {
-		lintGroups[i] = core.LintGroup{
-			Name:  g.Name,
-			Rules: g.Rules,
-		}
+	if err := os.MkdirAll(rootAbs, 0o755); err != nil {
+		return fmt.Errorf("MkdirAll: %w", err)
 	}
-
-	return core.InitTemplateData{
-		LintGroups:          lintGroups,
-		EnumZeroValueSuffix: "_NONE",
-		ServiceSuffix:       "API",
-		AgainstGitRef:       "master",
+	reader, writer := migrationIO(ctx)
+	prompt := terminalInitializationPrompter{terminal: migrationHasTerminal(reader, writer), prompt: prompter.InteractivePrompter{}}
+	if err := initializeV1(ctx.Context, rootAbs, ctx.String(flagInitModule.Name), prompt); err != nil {
+		return fmt.Errorf("initializeV1: %w", err)
 	}
+	return nil
 }
diff --git a/internal/api/init_prompt.go b/internal/api/init_prompt.go
new file mode 100644
index 00000000..92f9b56a
--- /dev/null
+++ b/internal/api/init_prompt.go
@@ -0,0 +1,27 @@
+package api
+
+import (
+	"context"
+	"fmt"
+)
+
+// terminalInitializationPrompter never opens a controlling terminal behind
+// redirected CLI streams. Explicit identities still work without a terminal.
+type terminalInitializationPrompter struct {
+	terminal bool
+	prompt   initializationPrompter
+}
+
+func (p terminalInitializationPrompter) Input(ctx context.Context, message, fallback string) (string, error) {
+	if !p.terminal {
+		return "", fmt.Errorf("module identity is required in noninteractive mode; pass --module")
+	}
+	return p.prompt.Input(ctx, message, fallback)
+}
+
+func (p terminalInitializationPrompter) Confirm(ctx context.Context, message string, fallback bool) (bool, error) {
+	if !p.terminal {
+		return false, fmt.Errorf("cannot confirm %q without terminal input and output; existing files were not changed", message)
+	}
+	return p.prompt.Confirm(ctx, message, fallback)
+}
diff --git a/internal/api/init_prompt_test.go b/internal/api/init_prompt_test.go
new file mode 100644
index 00000000..7b7d4524
--- /dev/null
+++ b/internal/api/init_prompt_test.go
@@ -0,0 +1,27 @@
+package api
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestInitDoesNotPromptWithoutTerminal(t *testing.T) {
+	t.Parallel()
+	p := terminalInitializationPrompter{}
+	_, err := p.Input(t.Context(), "module", "")
+	require.ErrorContains(t, err, "noninteractive mode; pass --module")
+	confirmed, err := p.Confirm(t.Context(), "overwrite", true)
+	require.ErrorContains(t, err, "without terminal input and output")
+	assert.False(t, confirmed)
+}
+
+func TestInitRejectsInjectedIdentityBeforeFiles(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	err := initializeV1(t.Context(), root, "example.com/app\nrequire example.com/other", &initPrompter{})
+	require.ErrorContains(t, err, "expected one module identity")
+	assert.NoFileExists(t, root+"/protobuf.mod")
+	assert.NoFileExists(t, root+"/easyp.yaml")
+}
diff --git a/internal/api/init_v1.go b/internal/api/init_v1.go
new file mode 100644
index 00000000..c8c648e1
--- /dev/null
+++ b/internal/api/init_v1.go
@@ -0,0 +1,125 @@
+package api
+
+import (
+	"bytes"
+	"context"
+	"errors"
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+
+	"github.com/easyp-tech/easyp/internal/adapters/gitmodules"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	disk "github.com/easyp-tech/easyp/internal/fs/fs"
+)
+
+type initializationPrompter interface {
+	Input(context.Context, string, string) (string, error)
+	Confirm(context.Context, string, bool) (bool, error)
+}
+
+type initialConfigFile struct {
+	name     string
+	contents []byte
+}
+
+// initializeV1 writes the three independent v1 files. All overwrite choices
+// are collected before changing any file, so declining one cannot truncate it.
+func initializeV1(ctx context.Context, root, identity string, prompt initializationPrompter) error {
+	if err := checkV1Initialization(root); err != nil {
+		return fmt.Errorf("checkV1Initialization: %w", err)
+	}
+	identity, err := initialModuleIdentity(ctx, root, identity, prompt)
+	if err != nil {
+		return fmt.Errorf("initialModuleIdentity: %w", err)
+	}
+	if len(strings.Fields(identity)) != 1 || strings.ContainsAny(identity, "\r\n") {
+		return fmt.Errorf("expected one module identity, without whitespace or newlines")
+	}
+	manifest := []byte("module " + identity + "\n")
+	if _, err := v1.ParseModule(bytes.NewReader(manifest)); err != nil {
+		return fmt.Errorf("ParseModule: %w", err)
+	}
+	files := []initialConfigFile{
+		{name: v1.ModuleFile, contents: manifest},
+		{name: v1.PolicyFile, contents: []byte("version: v1\nlinters:\n  default: STANDARD\nbreaking:\n  baseline: git:main\n")},
+		{name: v1.GenerateFile, contents: []byte("version: v1\nplugins: []\n")},
+	}
+	selected, err := confirmInitialConfigFiles(ctx, root, files, prompt)
+	if err != nil {
+		return fmt.Errorf("confirmInitialConfigFiles: %w", err)
+	}
+	for _, file := range selected {
+		if err := disk.WriteAtomicFile(filepath.Join(root, file.name), file.contents, 0o644); err != nil {
+			return fmt.Errorf("WriteAtomicFile: %w", err)
+		}
+	}
+	return nil
+}
+
+func checkV1Initialization(root string) error {
+	for _, name := range []string{"buf.yaml", "buf.yml"} {
+		_, err := os.Stat(filepath.Join(root, name))
+		if errors.Is(err, os.ErrNotExist) {
+			continue
+		}
+		if err != nil {
+			return fmt.Errorf("Stat: %w", err)
+		}
+		return fmt.Errorf("%s exists: Buf dependency migration needs explicit Git module mappings and is not available yet", name)
+	}
+	return nil
+}
+
+func initialModuleIdentity(ctx context.Context, root, identity string, prompt initializationPrompter) (string, error) {
+	if identity != "" {
+		return identity, nil
+	}
+	raw, found, err := readOptionalFile(filepath.Join(root, v1.ModuleFile))
+	if err != nil {
+		return "", fmt.Errorf("readOptionalFile: %w", err)
+	}
+	if found {
+		module, err := v1.ParseModule(bytes.NewReader(raw))
+		if err != nil {
+			return "", fmt.Errorf("ParseModule: %w", err)
+		}
+		return module.Name, nil
+	}
+	if identity := gitmodules.WorkspaceIdentity(ctx, root); identity != "" {
+		return identity, nil
+	}
+	value, err := prompt.Input(ctx, "Protobuf module identity (for example github.com/acme/service)", "")
+	if err != nil {
+		return "", fmt.Errorf("module identity is required; pass --module: %w", err)
+	}
+	return strings.TrimSpace(value), nil
+}
+
+func confirmInitialConfigFiles(ctx context.Context, root string, files []initialConfigFile, prompt initializationPrompter) ([]initialConfigFile, error) {
+	var selected []initialConfigFile
+	for _, file := range files {
+		path := filepath.Join(root, file.name)
+		current, found, err := readOptionalFile(path)
+		if err != nil {
+			return nil, fmt.Errorf("readOptionalFile: %w", err)
+		}
+		if !found {
+			selected = append(selected, file)
+			continue
+		}
+		if bytes.Equal(current, file.contents) {
+			continue
+		}
+		overwrite, err := prompt.Confirm(ctx, file.name+" already exists. Overwrite?", false)
+		if err != nil {
+			return nil, fmt.Errorf("Confirm: %w", err)
+		}
+		if !overwrite {
+			continue
+		}
+		selected = append(selected, file)
+	}
+	return selected, nil
+}
diff --git a/internal/api/init_v1_test.go b/internal/api/init_v1_test.go
new file mode 100644
index 00000000..c1869545
--- /dev/null
+++ b/internal/api/init_v1_test.go
@@ -0,0 +1,202 @@
+package api
+
+import (
+	"context"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/adapters/prompter"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestInitializeV1WritesSelectedConfigs(t *testing.T) {
+	t.Parallel()
+
+	const (
+		module          = "module example.com/service\n"
+		policy          = "version: v1\nlinters:\n  default: STANDARD\nbreaking:\n  baseline: git:main\n"
+		generator       = "version: v1\nplugins: []\n"
+		customPolicy    = "version: v1\nlinters:\n  default: MINIMAL\n"
+		customGenerator = "version: v1\nplugins:\n  - name: go\n    out: gen\n"
+	)
+	tests := []struct {
+		name                  string
+		existing              map[string]string
+		overwrite             bool
+		expectedPolicy        string
+		expectedGenerator     string
+		expectedConfirmations int
+	}{
+		{
+			name:              "create defaults without prompting",
+			expectedPolicy:    policy,
+			expectedGenerator: generator,
+		},
+		{
+			name:              "identical files need no confirmation",
+			existing:          map[string]string{v1.ModuleFile: module, v1.PolicyFile: policy, v1.GenerateFile: generator},
+			expectedPolicy:    policy,
+			expectedGenerator: generator,
+		},
+		{
+			name:                  "declined files keep their contents",
+			existing:              map[string]string{v1.PolicyFile: customPolicy, v1.GenerateFile: customGenerator},
+			expectedPolicy:        customPolicy,
+			expectedGenerator:     customGenerator,
+			expectedConfirmations: 2,
+		},
+		{
+			name:                  "confirmed files are replaced",
+			existing:              map[string]string{v1.PolicyFile: customPolicy, v1.GenerateFile: customGenerator},
+			overwrite:             true,
+			expectedPolicy:        policy,
+			expectedGenerator:     generator,
+			expectedConfirmations: 2,
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			for name, contents := range tt.existing {
+				require.NoError(t, os.WriteFile(filepath.Join(root, name), []byte(contents), 0o600))
+			}
+			prompt := &initPrompter{overwrite: tt.overwrite}
+
+			err := initializeV1(context.Background(), root, "example.com/service", prompt)
+
+			require.NoError(t, err)
+			assert.Equal(t, tt.expectedConfirmations, prompt.confirmations)
+			for name, contents := range map[string]string{
+				v1.ModuleFile: module, v1.PolicyFile: tt.expectedPolicy, v1.GenerateFile: tt.expectedGenerator,
+			} {
+				path := filepath.Join(root, name)
+				written, err := os.ReadFile(path)
+				require.NoError(t, err)
+				assert.Equal(t, contents, string(written), name)
+				info, err := os.Stat(path)
+				require.NoError(t, err)
+				wantMode := os.FileMode(0o644)
+				if _, existed := tt.existing[name]; existed {
+					wantMode = 0o600
+				}
+				assert.Equal(t, wantMode, info.Mode().Perm(), name)
+				issues, err := v1.ValidateFile(path)
+				require.NoError(t, err)
+				assert.Empty(t, issues, name)
+			}
+		})
+	}
+}
+
+func TestInitializeV1RejectsBeforeWriting(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name            string
+		identity        string
+		existing        map[string]string
+		expectedMessage string
+	}{
+		{
+			name:            "invalid identity",
+			identity:        "invalid identity",
+			expectedMessage: "expected one module identity",
+		},
+		{
+			name:            "buf yaml requires explicit migration",
+			identity:        "example.com/service",
+			existing:        map[string]string{"buf.yaml": "version: v2\n"},
+			expectedMessage: "buf.yaml exists",
+		},
+		{
+			name:            "buf yml requires explicit migration",
+			identity:        "example.com/service",
+			existing:        map[string]string{"buf.yml": "version: v1\n"},
+			expectedMessage: "buf.yml exists",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			for name, contents := range tt.existing {
+				require.NoError(t, os.WriteFile(filepath.Join(root, name), []byte(contents), 0o600))
+			}
+			prompt := &initPrompter{}
+
+			err := initializeV1(context.Background(), root, tt.identity, prompt)
+
+			require.ErrorContains(t, err, tt.expectedMessage)
+			assert.Zero(t, prompt.confirmations)
+			files, err := os.ReadDir(root)
+			require.NoError(t, err)
+			assert.Len(t, files, len(tt.existing))
+			for name, contents := range tt.existing {
+				written, err := os.ReadFile(filepath.Join(root, name))
+				require.NoError(t, err)
+				assert.Equal(t, contents, string(written))
+			}
+		})
+	}
+}
+
+func TestInitializeV1PromptErrorKeepsFiles(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name        string
+		existing    string
+		promptError error
+	}{
+		{name: "cancel policy overwrite", existing: v1.PolicyFile, promptError: context.Canceled},
+		{name: "cancel generator overwrite", existing: v1.GenerateFile, promptError: context.Canceled},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			path := filepath.Join(root, tt.existing)
+			require.NoError(t, os.WriteFile(path, []byte("keep this file\n"), 0o600))
+			prompt := &initPrompter{confirmErr: tt.promptError}
+
+			err := initializeV1(context.Background(), root, "example.com/service", prompt)
+
+			require.ErrorIs(t, err, tt.promptError)
+			assert.Equal(t, 1, prompt.confirmations)
+			files, err := os.ReadDir(root)
+			require.NoError(t, err)
+			require.Len(t, files, 1)
+			assert.Equal(t, tt.existing, files[0].Name())
+			written, err := os.ReadFile(path)
+			require.NoError(t, err)
+			assert.Equal(t, "keep this file\n", string(written))
+		})
+	}
+}
+
+// Explicit identities avoid interactive input; only overwrite prompts are used.
+type initPrompter struct {
+	prompter.Prompter
+	overwrite     bool
+	confirmErr    error
+	confirmations int
+}
+
+func (p *initPrompter) Confirm(context.Context, string, bool) (bool, error) {
+	p.confirmations++
+	return p.overwrite, p.confirmErr
+}
diff --git a/internal/api/lint.go b/internal/api/lint.go
index 0cbacebd..ef13c2b7 100644
--- a/internal/api/lint.go
+++ b/internal/api/lint.go
@@ -11,10 +11,8 @@ import (
 
 	"github.com/urfave/cli/v2"
 
-	"github.com/easyp-tech/easyp/internal/config"
 	"github.com/easyp-tech/easyp/internal/core"
 	"github.com/easyp-tech/easyp/internal/flags"
-	"github.com/easyp-tech/easyp/internal/fs/fs"
 	"github.com/easyp-tech/easyp/internal/logger"
 )
 
@@ -63,6 +61,7 @@ func (l Lint) Command() *cli.Command {
 		OnUsageError: nil,
 		Subcommands:  nil,
 		Flags: []cli.Flag{
+			flags.Frozen(),
 			flagLintDirectoryPath,
 			flagLintRoot,
 		},
@@ -102,42 +101,7 @@ func (l Lint) action(ctx *cli.Context, log logger.Logger) error {
 	if err != nil {
 		return err
 	}
-
-	cfg, err := config.New(ctx.Context, configPath)
-	if err != nil {
-		return fmt.Errorf("config.New: %w", err)
-	}
-
-	// Walker for Core (lockfile etc) - strictly based on project root
-	projectWalker := fs.NewFSWalker(projectRoot, ".")
-	app, err := buildCore(ctx.Context, log, *cfg, projectWalker)
-	if err != nil {
-		return fmt.Errorf("buildCore: %w", err)
-	}
-
-	path := ctx.String(flagLintDirectoryPath.Name)
-
-	// Walker for Linting - based on requested root and path
-	lintWalker := fs.NewFSWalker(lintRoot, path)
-	issues, err := app.Lint(ctx.Context, lintWalker)
-	if err != nil {
-		return fmt.Errorf("c.Lint: %w", err)
-	}
-
-	if len(issues) == 0 {
-		return nil
-	}
-
-	format := flags.GetFormat(ctx, flags.TextFormat)
-	if err := printIssues(
-		format,
-		os.Stdout,
-		issues,
-	); err != nil {
-		return fmt.Errorf("printLintErrors: %w", err)
-	}
-
-	return ErrHasLintIssue
+	return l.actionV1(ctx, log, configPath, projectRoot, lintRoot)
 }
 
 func printIssues(format string, w io.Writer, issues []core.IssueInfo) error {
diff --git a/internal/api/lint_batch.go b/internal/api/lint_batch.go
new file mode 100644
index 00000000..5931de87
--- /dev/null
+++ b/internal/api/lint_batch.go
@@ -0,0 +1,23 @@
+package api
+
+import "github.com/easyp-tech/easyp/internal/fs/fs"
+
+// selectedLintWalker enumerates only checked files while retaining full root
+// access for imports and RootPath for module-relative naming rules.
+type selectedLintWalker struct {
+	*fs.FSWalker
+	files []string
+}
+
+func newSelectedLintWalker(root string, files []string) *selectedLintWalker {
+	return &selectedLintWalker{FSWalker: fs.NewFSWalker(root, "."), files: files}
+}
+
+func (w *selectedLintWalker) WalkDir(callback func(string, error) error) error {
+	for _, file := range w.files {
+		if err := callback(file, nil); err != nil {
+			return err
+		}
+	}
+	return nil
+}
diff --git a/internal/api/lint_package_directory_prefix_test.go b/internal/api/lint_package_directory_prefix_test.go
new file mode 100644
index 00000000..f714d237
--- /dev/null
+++ b/internal/api/lint_package_directory_prefix_test.go
@@ -0,0 +1,27 @@
+package api
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+)
+
+func TestV1PackageDirectoryPrefix(t *testing.T) {
+	t.Parallel()
+
+	for _, tt := range []struct {
+		identity string
+		want     string
+	}{
+		{identity: "example.test/rfc/user", want: "user"},
+		{identity: "example.test/rfc/user/v2", want: "user"},
+		{identity: "https://example.test/acme/order", want: "order"},
+		{identity: "", want: ""},
+	} {
+		tt := tt
+		t.Run(tt.identity, func(t *testing.T) {
+			t.Parallel()
+			assert.Equal(t, tt.want, v1PackageDirectoryPrefix(tt.identity))
+		})
+	}
+}
diff --git a/internal/api/lint_v1.go b/internal/api/lint_v1.go
new file mode 100644
index 00000000..b096f11d
--- /dev/null
+++ b/internal/api/lint_v1.go
@@ -0,0 +1,308 @@
+package api
+
+import (
+	"bytes"
+	"context"
+	"fmt"
+	iofs "io/fs"
+	"os"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/core"
+	"github.com/easyp-tech/easyp/internal/flags"
+	"github.com/easyp-tech/easyp/internal/logger"
+	"github.com/easyp-tech/easyp/internal/modules"
+	policyresolver "github.com/easyp-tech/easyp/internal/policy"
+	"github.com/easyp-tech/easyp/internal/rules"
+	"github.com/easyp-tech/easyp/internal/workspace"
+)
+
+func (l Lint) actionV1(ctx *cli.Context, log logger.Logger, configPath, projectRoot, lintRoot string) error {
+	raw, err := os.ReadFile(configPath)
+	if err != nil {
+		return fmt.Errorf("ReadFile: %w", err)
+	}
+	_, err = v1.ParsePolicy(bytes.NewReader(raw))
+	if err != nil {
+		return fmt.Errorf("ParsePolicy: %w", err)
+	}
+	searchDir := filepath.Join(lintRoot, ctx.String(flagLintDirectoryPath.Name))
+	var files []string
+	err = filepath.WalkDir(searchDir, func(path string, entry iofs.DirEntry, walkErr error) error {
+		if walkErr != nil {
+			return walkErr
+		}
+		if policySourceExcluded(projectRoot, path) {
+			if entry.IsDir() {
+				return filepath.SkipDir
+			}
+			return nil
+		}
+		if !entry.IsDir() && filepath.Ext(path) == ".proto" {
+			files = append(files, path)
+		}
+		return nil
+	})
+	if err != nil {
+		return fmt.Errorf("WalkDir: %w", err)
+	}
+	var cache modules.Cache
+	replacements := newPolicyReplacementSources(ctx.Context, projectRoot, projectRoot, func() (modules.Cache, error) {
+		if cache == nil {
+			var err error
+			cache, err = moduleCache(ctx)
+			if err != nil {
+				return nil, fmt.Errorf("moduleCache: %w", err)
+			}
+		}
+		return cache, nil
+	}, flags.IsFrozen(ctx))
+	if flags.IsFrozen(ctx) {
+		relative, err := filepath.Rel(projectRoot, searchDir)
+		if err != nil {
+			return fmt.Errorf("Rel: %w", err)
+		}
+		selected, err := selectedPolicyScopes(replacements, relative, true)
+		if err != nil {
+			return fmt.Errorf("selectedPolicyScopes: %w", err)
+		}
+		cache, err = moduleCache(ctx)
+		if err != nil {
+			return fmt.Errorf("moduleCache: %w", err)
+		}
+		for directory := range selected {
+			if _, err := modules.EnsureFrozenSources(ctx.Context, filepath.Join(projectRoot, directory), cache); err != nil {
+				return err
+			}
+		}
+	}
+	apps := map[v1LintAppKey]*core.Core{}
+	batchFiles := make(map[v1LintAppKey][]string)
+	var batchOrder []v1LintAppKey
+	excludedByPath := make(map[string][]string)
+	moduleRoots := map[string]modules.SourceRoots{}
+	policyBoundary, err := workspace.Boundary(projectRoot)
+	if err != nil {
+		return fmt.Errorf("Boundary: %w", err)
+	}
+	resolver := policyresolver.NewResolver(policyBoundary, func(graphCtx context.Context, moduleDir string) (modules.PolicyGraph, error) {
+		if cache == nil {
+			var cacheErr error
+			cache, cacheErr = moduleCache(ctx)
+			if cacheErr != nil {
+				return nil, fmt.Errorf("moduleCache: %w", cacheErr)
+			}
+		}
+		return modules.ResolvePolicyGraph(graphCtx, moduleDir, cache, flags.IsFrozen(ctx))
+	})
+	var issues []core.IssueInfo
+	for _, file := range files {
+		unselectedReplacement, err := replacements.isUnselectedReplacementSource(searchDir, file)
+		if err != nil {
+			return fmt.Errorf("isUnselectedReplacementSource: %w", err)
+		}
+		if unselectedReplacement {
+			continue
+		}
+		moduleDir, err := findV1PolicyModuleDir(projectRoot, filepath.Dir(file))
+		if err != nil {
+			return fmt.Errorf("findV1PolicyModuleDir: %w", err)
+		}
+		policy, policyKey, lintersPresence, settingsPresence, err := resolveV1LintPolicyDetailed(filepath.Dir(file), projectRoot, configPath)
+		if err != nil {
+			return fmt.Errorf("resolveV1LintPolicy: %w", err)
+		}
+		var issuePath string
+		if policyKey.issues != "" {
+			issuePath, err = filepath.Rel(filepath.Dir(policyKey.issues), file)
+			if err != nil {
+				return fmt.Errorf("Rel: %w", err)
+			}
+		}
+		excludedLinters, excludeFile, err := policy.Issues.ExclusionsForPath(filepath.ToSlash(issuePath))
+		if err != nil {
+			return fmt.Errorf("ExclusionsForPath: %w", err)
+		}
+		if excludeFile {
+			continue
+		}
+		if flags.IsFrozen(ctx) && moduleDir == "" {
+			return fmt.Errorf("frozen lint requires protobuf.mod for %s", file)
+		}
+		appKey := v1LintAppKey{policy: policyKey, moduleDir: moduleDir}
+		if _, ok := apps[appKey]; !ok {
+			resolved, err := resolver.ResolveLint(ctx.Context, policyresolver.LintInput{
+				PolicyPath:     policyKey.linters,
+				Policy:         policy,
+				Presence:       lintersPresence,
+				SettingsPath:   policyKey.settings,
+				Settings:       policy.LinterSettings,
+				SettingsSource: settingsPresence,
+				ModuleDir:      moduleDir,
+			})
+			if err != nil {
+				return fmt.Errorf("resolve policy for consuming file %s: %w", file, err)
+			}
+			lintConfig, err := resolved.Policy.LintConfig()
+			if err != nil {
+				return fmt.Errorf("LintConfig: %w", err)
+			}
+			if moduleDir != "" {
+				_, module, moduleErr := modules.ReadManifest(moduleDir)
+				if moduleErr != nil {
+					return fmt.Errorf("ReadManifest: %w", moduleErr)
+				}
+				lintConfig.PackageDirectoryPrefix = v1PackageDirectoryPrefix(module.Name)
+			}
+			var importRoots modules.SourceRoots
+			if moduleDir != "" {
+				roots, known := moduleRoots[moduleDir]
+				if !known {
+					if cache == nil {
+						cache, err = moduleCache(ctx)
+						if err != nil {
+							return fmt.Errorf("moduleCache: %w", err)
+						}
+					}
+					roots, err = policyImportRoots(ctx.Context, cache, moduleDir, flags.IsFrozen(ctx))
+					if err != nil {
+						return fmt.Errorf("ensureV1PolicyImportRoots: %w", err)
+					}
+					moduleRoots[moduleDir] = roots
+				}
+				importRoots = roots
+			}
+			app, err := buildCore(log, config.Config{Lint: lintConfig}, importRoots)
+			if err != nil {
+				return fmt.Errorf("buildCore: %w", err)
+			}
+			apps[appKey] = app
+			batchOrder = append(batchOrder, appKey)
+		}
+		rel, err := filepath.Rel(lintRoot, file)
+		if err != nil {
+			return fmt.Errorf("Rel: %w", err)
+		}
+		rel = filepath.ToSlash(rel)
+		batchFiles[appKey] = append(batchFiles[appKey], rel)
+		excludedByPath[rel] = excludedLinters
+	}
+	// Keep stateful rules within one effective policy/module, but avoid starting
+	// a separate lint run for every file. Named path exclusions remain per file.
+	for _, key := range batchOrder {
+		fileIssues, err := apps[key].Lint(ctx.Context, newSelectedLintWalker(lintRoot, batchFiles[key]))
+		if err != nil {
+			return fmt.Errorf("Lint: %w", err)
+		}
+		for _, issue := range fileIssues {
+			if v1IssueRuleExcluded(issue.RuleName, excludedByPath[filepath.ToSlash(issue.Path)]) {
+				continue
+			}
+			if issue.RuleName == "PACKAGE_DIRECTORY_MATCH" && issue.SourceName != "" {
+				issue.Path = filepath.ToSlash(issue.SourceName)
+			}
+			issues = append(issues, issue)
+		}
+	}
+	// Grouping must not reorder user-facing diagnostics between policy subtrees.
+	slices.SortStableFunc(issues, func(a, b core.IssueInfo) int {
+		return strings.Compare(filepath.ToSlash(a.Path), filepath.ToSlash(b.Path))
+	})
+	if len(issues) == 0 {
+		return nil
+	}
+	if err := printIssues(flags.GetFormat(ctx, flags.TextFormat), os.Stdout, issues); err != nil {
+		return fmt.Errorf("printIssues: %w", err)
+	}
+	return ErrHasLintIssue
+}
+
+type v1LintPolicySources struct {
+	linters  string
+	settings string
+	issues   string
+}
+
+type v1LintAppKey struct {
+	policy    v1LintPolicySources
+	moduleDir string
+}
+
+func v1PackageDirectoryPrefix(identity string) string {
+	logical := filepath.ToSlash(strings.TrimSuffix(identity, "/"))
+	if major, err := v1.ModulePathMajor(identity); err == nil && major != "" {
+		logical = strings.TrimSuffix(logical, major)
+	}
+	logical = strings.TrimSuffix(logical, "/")
+	if logical == "" {
+		return ""
+	}
+	base := filepath.Base(logical)
+	return strings.TrimSuffix(base, ".git")
+}
+
+func v1IssueRuleExcluded(name string, selections []string) bool {
+	if len(selections) == 0 {
+		return false
+	}
+	if slices.Contains(selections, name) {
+		return true
+	}
+	for _, group := range rules.AllGroups() {
+		if slices.Contains(selections, group.Key) && slices.Contains(group.Rules, name) {
+			return true
+		}
+	}
+	return false
+}
+
+func resolveV1LintPolicy(directory, projectRoot, configPath string) (v1.Policy, v1LintPolicySources, error) {
+	policy, sources, _, _, err := resolveV1LintPolicyDetailed(directory, projectRoot, configPath)
+	return policy, sources, err
+}
+
+func resolveV1LintPolicyDetailed(directory, projectRoot, configPath string) (v1.Policy, v1LintPolicySources, v1.PolicyPresence, v1.PolicyPresence, error) {
+	var result v1.Policy
+	var sources v1LintPolicySources
+	lintersPresence := v1.NewPolicyPresence()
+	settingsPresence := v1.NewPolicyPresence()
+	var foundFile bool
+	for _, dir := range ancestorDirs(directory, projectRoot) {
+		path := v1PolicyPath(dir, projectRoot, configPath)
+		file, found, err := readV1PolicyFile(path)
+		if err != nil {
+			return v1.Policy{}, v1LintPolicySources{}, v1.PolicyPresence{}, v1.PolicyPresence{}, fmt.Errorf("readV1PolicyFile: %w", err)
+		}
+		if !found {
+			continue
+		}
+		foundFile = true
+		if file.has("linters") && sources.linters == "" {
+			result.Linters = file.policy.Linters
+			sources.linters = path
+			lintersPresence = file.presence
+		}
+		if file.has("linters-settings") && sources.settings == "" {
+			result.LinterSettings = file.policy.LinterSettings
+			sources.settings = path
+			settingsPresence = file.presence
+		}
+		if file.has("issues") && sources.issues == "" {
+			result.Issues = file.policy.Issues
+			sources.issues = path
+		}
+	}
+	if !foundFile {
+		return v1.Policy{}, v1LintPolicySources{}, v1.PolicyPresence{}, v1.PolicyPresence{}, fmt.Errorf("no easyp.yaml policy for %s", directory)
+	}
+	if result.Linters.Default == "" {
+		result.Linters.Default = "STANDARD"
+	}
+	return result, sources, lintersPresence, settingsPresence, nil
+}
diff --git a/internal/api/lint_v1_exclusions_test.go b/internal/api/lint_v1_exclusions_test.go
new file mode 100644
index 00000000..32835ebf
--- /dev/null
+++ b/internal/api/lint_v1_exclusions_test.go
@@ -0,0 +1,96 @@
+package api
+
+import (
+	"flag"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestLintV1PathExclusions(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name, rootPolicy, childPolicy, file, proto, lintRoot string
+		wantIssue                                            bool
+	}{
+		{name: "inherited_issue_source", rootPolicy: "issues:\n  exclude-rules:\n    - path: nested/api/**\n", childPolicy: "linters:\n  default: MINIMAL\n", file: "nested/api/bad.proto", proto: "invalid proto", lintRoot: "nested"},
+		{name: "child_issue_source", childPolicy: "issues:\n  exclude-rules:\n    - path: api/**\n", file: "nested/api/bad.proto", proto: "invalid proto", lintRoot: "nested/api"},
+		{name: "literal_directory", rootPolicy: "issues:\n  exclude-rules:\n    - path: nested/api\n", file: "nested/api/deep/bad.proto", proto: "invalid proto", lintRoot: "nested"},
+		{name: "named_rule", rootPolicy: "issues:\n  exclude-rules:\n    - path: nested/api/**\n      linters: [PACKAGE_DEFINED]\n", file: "nested/api/file.proto", proto: "syntax = \"proto3\";", lintRoot: "nested/api"},
+		{name: "named_group", rootPolicy: "issues:\n  exclude-rules:\n    - path: nested/api/**\n      linters: [MINIMAL]\n", file: "nested/api/file.proto", proto: "syntax = \"proto3\";", lintRoot: "nested/api"},
+		{name: "other_rule_still_checked", rootPolicy: "issues:\n  exclude-rules:\n    - path: nested/api/**\n      linters: [FILE_LOWER_SNAKE_CASE]\n", file: "nested/api/file.proto", proto: "syntax = \"proto3\";", lintRoot: "nested/api", wantIssue: true},
+		{name: "different_path_still_checked", rootPolicy: "issues:\n  exclude-rules:\n    - path: other/**\n", file: "nested/api/file.proto", proto: "syntax = \"proto3\";", lintRoot: "nested/api", wantIssue: true},
+		{name: "child_clears_exclusion", rootPolicy: "issues:\n  exclude-rules:\n    - path: nested/api/**\n", childPolicy: "issues: {}\n", file: "nested/api/file.proto", proto: "syntax = \"proto3\";", lintRoot: "nested/api", wantIssue: true},
+		{name: "pathless_all", rootPolicy: "issues:\n  exclude-rules:\n    - {}\n", file: "nested/api/file.proto", proto: "invalid proto", lintRoot: "nested"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeV1GenerateFixture(t, root, "selected.yaml", "version: v1\nlinters:\n  default: MINIMAL\n"+tt.rootPolicy)
+			if tt.childPolicy != "" {
+				writeV1GenerateFixture(t, root, "nested/easyp.yaml", "version: v1\n"+tt.childPolicy)
+			}
+			writeV1GenerateFixture(t, root, tt.file, tt.proto)
+			ctx := cli.NewContext(&cli.App{}, flag.NewFlagSet("test", flag.ContinueOnError), nil)
+			ctx.Context = t.Context()
+			err := (Lint{}).actionV1(ctx, logger.NewNop(), filepath.Join(root, "selected.yaml"), root, filepath.Join(root, tt.lintRoot))
+			if tt.wantIssue {
+				require.ErrorIs(t, err, ErrHasLintIssue)
+			} else {
+				require.NoError(t, err)
+			}
+		})
+	}
+}
+
+func TestLintV1ExclusionBeforeDependencies(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, "easyp.yaml", "version: v1\nlinters:\n  default: MINIMAL\nissues:\n  exclude-rules:\n    - path: module/proto/**\n")
+	writeV1GenerateFixture(t, root, "module/protobuf.mod", "invalid manifest")
+	writeV1GenerateFixture(t, root, "module/proto/bad.proto", "invalid proto")
+	ctx := cli.NewContext(&cli.App{}, flag.NewFlagSet("test", flag.ContinueOnError), nil)
+	ctx.Context = t.Context()
+	err := (Lint{}).actionV1(ctx, logger.NewNop(), filepath.Join(root, "easyp.yaml"), root, root)
+	require.NoError(t, err)
+}
+
+func TestLintV1ExcludedFileRemainsImportable(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, "easyp.yaml", "version: v1\nlinters:\n  default: MINIMAL\nissues:\n  exclude-rules:\n    - path: dep.proto\n")
+	writeV1GenerateFixture(t, root, "dep.proto", "syntax = \"proto3\"; message Dep {}")
+	writeV1GenerateFixture(t, root, "api/use.proto", "syntax = \"proto3\"; package api; import \"dep.proto\"; message Use { Dep value = 1; }")
+	ctx := cli.NewContext(&cli.App{}, flag.NewFlagSet("test", flag.ContinueOnError), nil)
+	ctx.Context = t.Context()
+	err := (Lint{}).actionV1(ctx, logger.NewNop(), filepath.Join(root, "easyp.yaml"), root, root)
+	require.NoError(t, err)
+}
+
+func TestLintV1NamedExclusionPreservesOtherRuleState(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, "easyp.yaml", "version: v1\nlinters:\n  default: MINIMAL\n  disable: [PACKAGE_DIRECTORY_MATCH]\nissues:\n  exclude-rules:\n    - path: a.proto\n      linters: [FILE_LOWER_SNAKE_CASE]\n")
+	writeV1GenerateFixture(t, root, "a.proto", "syntax = \"proto3\"; package first;")
+	writeV1GenerateFixture(t, root, "b.proto", "syntax = \"proto3\"; package second;")
+	ctx := cli.NewContext(&cli.App{}, flag.NewFlagSet("test", flag.ContinueOnError), nil)
+	ctx.Context = t.Context()
+	err := (Lint{}).actionV1(ctx, logger.NewNop(), filepath.Join(root, "easyp.yaml"), root, root)
+	require.ErrorIs(t, err, ErrHasLintIssue)
+}
+
+func TestLintV1ExclusionsDoNotValidateUnsupportedPolicies(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, "easyp.yaml", "version: v1\nlinters:\n  extends: unavailable\nissues:\n  exclude-rules:\n    - {}\n")
+	writeV1GenerateFixture(t, root, "item.proto", "invalid proto")
+	ctx := cli.NewContext(&cli.App{}, flag.NewFlagSet("test", flag.ContinueOnError), nil)
+	ctx.Context = t.Context()
+	err := (Lint{}).actionV1(ctx, logger.NewNop(), filepath.Join(root, "easyp.yaml"), root, root)
+	require.ErrorContains(t, err, "linters.extends")
+}
diff --git a/internal/api/lint_v1_test.go b/internal/api/lint_v1_test.go
new file mode 100644
index 00000000..4df1da37
--- /dev/null
+++ b/internal/api/lint_v1_test.go
@@ -0,0 +1,77 @@
+package api
+
+import (
+	"flag"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestLintV1RejectsLegacyConfig(t *testing.T) {
+	t.Parallel()
+
+	root := t.TempDir()
+	configPath := filepath.Join(root, "easyp.yaml")
+	err := os.WriteFile(configPath, []byte("lint:\n  use: [FILE_LOWER_SNAKE_CASE]\n"), 0o644)
+	require.NoError(t, err)
+	err = os.WriteFile(filepath.Join(root, "file.proto"), []byte("syntax = \"proto3\";\npackage example;\n"), 0o644)
+	require.NoError(t, err)
+	ctx := cli.NewContext(&cli.App{}, flag.NewFlagSet("test", flag.ContinueOnError), nil)
+	ctx.Context = t.Context()
+
+	err = (Lint{}).actionV1(ctx, logger.NewNop(), configPath, root, root)
+	require.Error(t, err)
+}
+
+func TestLintV1UsesSelectedConfigFile(t *testing.T) {
+	t.Parallel()
+
+	for _, tc := range []struct {
+		name   string
+		header string
+	}{
+		{name: "explicit version", header: "version: v1\n"},
+		{name: "default version"},
+	} {
+		t.Run(tc.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			configPath := filepath.Join(root, "strict.yaml")
+			err := os.WriteFile(configPath, []byte(tc.header+"issues:\n  exclude-rules:\n    - {}\n"), 0o644)
+			require.NoError(t, err)
+			// An unrelated default config must not override the explicitly selected one.
+			err = os.WriteFile(filepath.Join(root, "easyp.yaml"), []byte("lint:\n  use: [FILE_LOWER_SNAKE_CASE]\n"), 0o644)
+			require.NoError(t, err)
+			err = os.WriteFile(filepath.Join(root, "file.proto"), []byte("syntax = \"proto3\";\npackage example;\n"), 0o644)
+			require.NoError(t, err)
+			ctx := cli.NewContext(&cli.App{}, flag.NewFlagSet("test", flag.ContinueOnError), nil)
+			ctx.Context = t.Context()
+
+			err = (Lint{}).actionV1(ctx, logger.NewNop(), configPath, root, root)
+			require.NoError(t, err)
+		})
+	}
+}
+
+func TestLintV1ResolvesLocalDependencyImport(t *testing.T) {
+	root := t.TempDir()
+	dep := t.TempDir()
+	replacement, err := filepath.Rel(root, dep)
+	require.NoError(t, err)
+	writeV1GenerateFixture(t, root, "easyp.yaml", "version: v1\nlinters:\n  default: MINIMAL\n")
+	writeV1GenerateFixture(t, root, "protobuf.mod", "module example.com/root\nroots proto\nrequire example.com/dep v1.0.0\nreplace example.com/dep => "+replacement+"\n")
+	writeV1GenerateFixture(t, root, "proto/root/v1/root.proto", "syntax = \"proto3\"; package root.v1; import \"dep/v1/dep.proto\"; message Root { dep.v1.Dep value = 1; }\n")
+	writeV1GenerateFixture(t, dep, "protobuf.mod", "module example.com/dep\nroots src\n")
+	writeV1GenerateFixture(t, dep, "src/dep/v1/dep.proto", "syntax = \"proto3\"; package dep.v1; message Dep {}\n")
+	ctx := cli.NewContext(&cli.App{}, flag.NewFlagSet("test", flag.ContinueOnError), nil)
+	ctx.Context = t.Context()
+
+	err = (Lint{}).actionV1(ctx, logger.NewNop(), filepath.Join(root, "easyp.yaml"), root, filepath.Join(root, "proto"))
+	require.NoError(t, err)
+}
diff --git a/internal/api/ls_files.go b/internal/api/ls_files.go
deleted file mode 100644
index a3c1b0d8..00000000
--- a/internal/api/ls_files.go
+++ /dev/null
@@ -1,126 +0,0 @@
-package api
-
-import (
-	"encoding/json"
-	"fmt"
-	"os"
-	"text/tabwriter"
-
-	"github.com/urfave/cli/v2"
-
-	"github.com/easyp-tech/easyp/internal/config"
-	"github.com/easyp-tech/easyp/internal/core"
-	"github.com/easyp-tech/easyp/internal/flags"
-	"github.com/easyp-tech/easyp/internal/fs/fs"
-)
-
-type LsFiles struct{}
-
-var (
-	flagLsFilesIncludeImports = &cli.BoolFlag{
-		Name:    "include-imports",
-		Usage:   "include transitive imports (like buf --include-imports)",
-		Value:   true,
-		Aliases: []string{"I"},
-	}
-)
-
-func (l LsFiles) Command() *cli.Command {
-	return &cli.Command{
-		Name:        "ls-files",
-		Usage:       "list .proto files taking into account inputs and imports",
-		UsageText:   "ls-files [--include-imports]",
-		Description: "analog of 'buf ls-files --include-imports' for easyp",
-		Action:      l.Action,
-		Flags: []cli.Flag{
-			flagLsFilesIncludeImports,
-		},
-		Aliases: []string{"ls"},
-	}
-}
-
-func (l LsFiles) Action(ctx *cli.Context) error {
-	log := getLogger(ctx)
-
-	// Resolve config path, project root and operation root (search root).
-	// Pass empty string for rootFlagName because this command doesn't declare its own --root flag.
-	configPath, projectRoot, opRoot, err := resolveRoots(ctx, "")
-	if err != nil {
-		return err
-	}
-
-	cfg, err := config.New(ctx.Context, configPath)
-	if err != nil {
-		return fmt.Errorf("config.New: %w", err)
-	}
-
-	// Walker for Core (lockfile etc) - strictly based on project root
-	dirWalker := fs.NewFSWalker(projectRoot, ".")
-	app, err := buildCore(ctx.Context, log, *cfg, dirWalker)
-	if err != nil {
-		return fmt.Errorf("buildCore: %w", err)
-	}
-
-	opts := core.ListFilesOptions{
-		IncludeImports: ctx.Bool(flagLsFilesIncludeImports.Name),
-	}
-
-	// Use operation root for listing files (allows future --root support)
-	res, err := app.ListFiles(ctx.Context, opRoot, opts)
-	if err != nil {
-		return fmt.Errorf("app.ListFiles: %w", err)
-	}
-
-	format := flags.GetFormat(ctx, flags.JSONFormat)
-	switch format {
-	case flags.JSONFormat:
-		enc := json.NewEncoder(os.Stdout)
-		enc.SetIndent("", "  ")
-		if err := enc.Encode(res); err != nil {
-			return fmt.Errorf("json.Encode: %w", err)
-		}
-	case flags.TextFormat:
-		if err := printLsFilesText(res); err != nil {
-			return fmt.Errorf("printLsFilesText: %w", err)
-		}
-	default:
-		return fmt.Errorf("unsupported format: %s", format)
-	}
-	return nil
-}
-
-func printLsFilesText(res core.LsFilesResult) error {
-	w := tabwriter.NewWriter(os.Stdout, 0, 4, 2, ' ', 0)
-
-	fmt.Fprintln(w, "ROOTS:")
-	fmt.Fprintln(w, "  #\tSOURCE\tPATH")
-	for i, r := range res.Roots {
-		fmt.Fprintf(w, "  %d\t%s\t%s\n", i+1, r.Source, r.Path)
-	}
-
-	fmt.Fprintln(w, "\nFILES:")
-	for i, f := range res.Files {
-		fmt.Fprintf(w, "  #%d\n", i+1)
-		fmt.Fprintf(w, "    SOURCE:\t%s\n", f.Source)
-		fmt.Fprintf(w, "    IMPORT:\t%s\n", f.ImportPath)
-		fmt.Fprintf(w, "    ABS:\t%s\n", f.AbsPath)
-		fmt.Fprintf(w, "    ROOT:\t%s\n", f.Root)
-		if i < len(res.Files)-1 {
-			fmt.Fprintln(w, "  ---")
-		}
-	}
-
-	if len(res.Errors) > 0 {
-		fmt.Fprintln(w, "\nERRORS:")
-		for i, e := range res.Errors {
-			fmt.Fprintf(w, "  #%d\n", i+1)
-			fmt.Fprintf(w, "    CODE:\t%s\n", e.Code)
-			fmt.Fprintf(w, "    MSG:\t%s\n", e.Message)
-			if i < len(res.Errors)-1 {
-				fmt.Fprintln(w, "  ---")
-			}
-		}
-	}
-
-	return w.Flush()
-}
diff --git a/internal/api/ls_files_filters_test.go b/internal/api/ls_files_filters_test.go
new file mode 100644
index 00000000..7c9f03a9
--- /dev/null
+++ b/internal/api/ls_files_filters_test.go
@@ -0,0 +1,80 @@
+package api
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+func TestListV1FilesRejectsExcludedAlias(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct{ name, alias, target, imported string }{
+		{name: "directory_alias", alias: "alias", target: "dep/excluded", imported: "alias/b.proto"},
+		{name: "file_alias", alias: "alias.proto", target: "dep/excluded/b.proto", imported: "alias.proto"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeV1GenerateFixture(t, root, "protobuf.mod", "module example.test/app\nroots .\nrequire example.test/dep\nreplace example.test/dep => ./dep\n")
+			writeV1GenerateFixture(t, root, "dep/buf.yaml", "version: v1\nbuild:\n  excludes: [excluded]\n")
+			writeV1GenerateFixture(t, root, "dep/excluded/b.proto", "syntax = \"proto3\"; message B {}\n")
+			writeV1GenerateFixture(t, root, "client.proto", "syntax = \"proto3\"; import \""+tt.imported+"\"; message Client {}\n")
+			require.NoError(t, os.Symlink(filepath.Join(root, tt.target), filepath.Join(root, tt.alias)))
+			_, module, err := modules.ReadManifest(root)
+			require.NoError(t, err)
+			listed, err := listV1Files(t.Context(), root, module, true, nil)
+			require.NoError(t, err)
+			require.Len(t, listed.Errors, 1)
+			assert.Equal(t, "import_not_found", listed.Errors[0].Code)
+			assert.Contains(t, listed.Errors[0].Message, tt.imported)
+			require.Len(t, listed.Files, 1)
+			assert.Equal(t, "client.proto", listed.Files[0].ImportPath)
+		})
+	}
+}
+
+func TestListV1FilesRejectsLexicallyExcludedAlias(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct {
+		name, alias, imported string
+		directory, outside    bool
+	}{
+		{name: "file_alias", alias: "excluded/alias.proto", imported: "excluded/alias.proto"},
+		{name: "directory_alias", alias: "excluded/alias", imported: "excluded/alias/model.proto", directory: true},
+		{name: "file_alias_outside_roots", alias: "excluded/alias.proto", imported: "excluded/alias.proto", outside: true},
+		{name: "directory_alias_outside_roots", alias: "excluded/alias", imported: "excluded/alias/model.proto", directory: true, outside: true},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeV1GenerateFixture(t, root, "protobuf.mod", "module example.test/app\nroots api\nrequire example.test/dep\nreplace example.test/dep => ./dep\n")
+			writeV1GenerateFixture(t, root, "dep/buf.yaml", "version: v1\nbuild:\n  excludes: [excluded]\n")
+			writeV1GenerateFixture(t, root, "api/client.proto", "syntax = \"proto3\"; import \""+tt.imported+"\"; message Client {}\n")
+			target := filepath.Join(root, "dep/selected")
+			if tt.outside {
+				target = t.TempDir()
+			}
+			writeV1GenerateFixture(t, target, "model.proto", "syntax = \"proto3\"; message Model {}\n")
+			if !tt.directory {
+				target = filepath.Join(target, "model.proto")
+			}
+			alias := filepath.Join(root, "dep", tt.alias)
+			require.NoError(t, os.MkdirAll(filepath.Dir(alias), 0o755))
+			require.NoError(t, os.Symlink(target, alias))
+			_, module, err := modules.ReadManifest(root)
+			require.NoError(t, err)
+			listed, err := listV1Files(t.Context(), root, module, true, nil)
+			require.NoError(t, err)
+			require.Len(t, listed.Errors, 1)
+			assert.Equal(t, "import_not_found", listed.Errors[0].Code)
+			assert.Contains(t, listed.Errors[0].Message, tt.imported)
+			require.Len(t, listed.Files, 1)
+			assert.Equal(t, "client.proto", listed.Files[0].ImportPath)
+		})
+	}
+}
diff --git a/internal/api/ls_files_v1.go b/internal/api/ls_files_v1.go
new file mode 100644
index 00000000..9be4dbb5
--- /dev/null
+++ b/internal/api/ls_files_v1.go
@@ -0,0 +1,261 @@
+package api
+
+import (
+	"context"
+	"encoding/json"
+	"errors"
+	"fmt"
+	"io"
+	"os"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	"github.com/urfave/cli/v2"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/flags"
+	"github.com/easyp-tech/easyp/internal/modules"
+	"github.com/easyp-tech/easyp/wellknownimports"
+)
+
+const wellKnownV1Root = "/wellknownimports"
+
+// LsFiles lists module sources and reachable transitive imports.
+type LsFiles struct{}
+
+var _ Handler = (*LsFiles)(nil)
+
+var flagLsFilesIncludeImports = &cli.BoolFlag{
+	Name:    "include-imports",
+	Aliases: []string{"I"},
+	Usage:   "include reachable imports from dependencies and well-known protos",
+	Value:   true,
+}
+
+type v1ListedFile struct {
+	AbsPath    string `json:"abs_path"`
+	ImportPath string `json:"import_path"`
+	Source     string `json:"source"`
+	Root       string `json:"root"`
+}
+
+type v1ListedRoot struct {
+	Path   string `json:"path"`
+	Source string `json:"source"`
+}
+
+type v1ListError struct {
+	Code    string `json:"code"`
+	Message string `json:"message"`
+}
+
+type v1ListResult struct {
+	Files  []v1ListedFile `json:"files"`
+	Roots  []v1ListedRoot `json:"roots"`
+	Errors []v1ListError  `json:"errors,omitempty"`
+}
+
+// Command implements Handler.
+func (l LsFiles) Command() *cli.Command {
+	return &cli.Command{
+		Name:    "ls-files",
+		Aliases: []string{"ls"},
+		Usage:   "list v1 module proto files and reachable imports",
+		Action:  l.Action,
+		Flags:   []cli.Flag{flags.Frozen(), flagLsFilesIncludeImports, flags.Format},
+	}
+}
+
+// Action implements Handler.
+func (l LsFiles) Action(ctx *cli.Context) error {
+	root, err := os.Getwd()
+	if err != nil {
+		return fmt.Errorf("Getwd: %w", err)
+	}
+	if _, statErr := os.Stat(filepath.Join(root, v1.ModuleFile)); errors.Is(statErr, os.ErrNotExist) {
+		raw, readErr := os.ReadFile(filepath.Join(root, v1.PolicyFile))
+		if readErr == nil && v1.LegacyPolicy(raw) {
+			return v1.ErrLegacyConfiguration
+		}
+	}
+	module, err := modules.ReadModuleOrDefault(root)
+	if err != nil {
+		return fmt.Errorf("ReadModuleOrDefault: %w", err)
+	}
+	includeImports := ctx.Bool(flagLsFilesIncludeImports.Name)
+	var cache modules.Cache
+	if flags.IsFrozen(ctx) || includeImports && (len(modules.RemoteRequirements(module)) > 0 || len(module.Replaces) > 0) {
+		cache, err = moduleCache(ctx)
+		if err != nil {
+			return fmt.Errorf("moduleCache: %w", err)
+		}
+	}
+	if flags.IsFrozen(ctx) {
+		if _, err := modules.EnsureFrozenSources(ctx.Context, root, cache); err != nil {
+			return err
+		}
+	}
+	listed, err := listV1Files(ctx.Context, root, module, includeImports, cache)
+	if err != nil {
+		return fmt.Errorf("listV1Files: %w", err)
+	}
+	format := flags.GetFormat(ctx, flags.JSONFormat)
+	output := ctx.App.Writer
+	if output == nil {
+		output = os.Stdout
+	}
+	switch format {
+	case flags.JSONFormat:
+		encoder := json.NewEncoder(output)
+		encoder.SetIndent("", "  ")
+		if err := encoder.Encode(listed); err != nil {
+			return fmt.Errorf("Encode: %w", err)
+		}
+	case flags.TextFormat:
+		diagnostics := ctx.App.ErrWriter
+		if diagnostics == nil {
+			diagnostics = os.Stderr
+		}
+		if err := printV1ListedFiles(output, diagnostics, listed); err != nil {
+			return fmt.Errorf("printV1ListedFiles: %w", err)
+		}
+	default:
+		return fmt.Errorf("unsupported format: %s", format)
+	}
+	if len(listed.Errors) > 0 {
+		return cli.Exit(fmt.Sprintf("ls-files found %d errors", len(listed.Errors)), 1)
+	}
+	return nil
+}
+
+func listV1Files(ctx context.Context, moduleDir string, module v1.Module, includeImports bool, cache modules.Cache) (v1ListResult, error) {
+	result := v1ListResult{Files: []v1ListedFile{}, Roots: []v1ListedRoot{}}
+	index := make(map[string]v1ListedFile)
+	roots, err := modules.ModuleSources(moduleDir, module)
+	if err != nil {
+		return v1ListResult{}, fmt.Errorf("ModuleSources: %w", err)
+	}
+	var dependencies modules.SourceRoots
+	if includeImports {
+		dependencies, err = modules.EnsureSources(ctx, moduleDir, module, cache)
+		if err != nil {
+			return v1ListResult{}, fmt.Errorf("EnsureSources: %w", err)
+		}
+	}
+	allowed := append(append(modules.SourceRoots(nil), roots...), dependencies...).FileAllowed()
+	for _, root := range roots {
+		result.Roots = append(result.Roots, v1ListedRoot{Path: filepath.ToSlash(root.Path), Source: "workspace"})
+		if err := indexV1ProtoRoot(root, "workspace", allowed, index, &result.Files); err != nil {
+			return v1ListResult{}, fmt.Errorf("indexV1ProtoRoot: %w", err)
+		}
+	}
+	if includeImports {
+		for _, dependency := range dependencies {
+			result.Roots = append(result.Roots, v1ListedRoot{Path: filepath.ToSlash(dependency.Path), Source: "dependency"})
+			if err := indexV1ProtoRoot(dependency, "dependency", allowed, index, nil); err != nil {
+				return v1ListResult{}, fmt.Errorf("indexV1ProtoRoot: %w", err)
+			}
+		}
+		collectV1ListedImports(index, &result)
+	}
+	slices.SortFunc(result.Roots, func(a, b v1ListedRoot) int { return strings.Compare(a.Path, b.Path) })
+	slices.SortFunc(result.Files, func(a, b v1ListedFile) int { return strings.Compare(a.ImportPath, b.ImportPath) })
+	return result, nil
+}
+
+func indexV1ProtoRoot(root modules.SourceRoot, source string, allowed func(string) bool, index map[string]v1ListedFile, selected *[]v1ListedFile) error {
+	return root.Walk(func(path string) error {
+		if allowed != nil && !allowed(path) {
+			return nil
+		}
+		importPath, err := filepath.Rel(root.Path, path)
+		if err != nil {
+			return fmt.Errorf("Rel: %w", err)
+		}
+		importPath = filepath.ToSlash(importPath)
+		file := v1ListedFile{AbsPath: filepath.ToSlash(path), ImportPath: importPath, Source: source, Root: filepath.ToSlash(root.Path)}
+		if previous, exists := index[importPath]; exists && previous.AbsPath != file.AbsPath {
+			return fmt.Errorf("duplicate import path %q: %s and %s", importPath, previous.AbsPath, file.AbsPath)
+		}
+		index[importPath] = file
+		if selected != nil {
+			*selected = append(*selected, file)
+		}
+		return nil
+	})
+}
+
+func collectV1ListedImports(index map[string]v1ListedFile, result *v1ListResult) {
+	queue := append([]v1ListedFile(nil), result.Files...)
+	seen := make(map[string]bool, len(queue))
+	for _, file := range queue {
+		seen[file.ImportPath] = true
+	}
+	for len(queue) > 0 {
+		file := queue[0]
+		queue = queue[1:]
+		imports, err := readV1ListedImports(file)
+		if err != nil {
+			result.Errors = append(result.Errors, v1ListError{Code: "parse_error", Message: fmt.Sprintf("%s: %v", file.ImportPath, err)})
+			continue
+		}
+		for _, importPath := range imports {
+			resolved, issue := resolveV1ListedImport(file.ImportPath, importPath, index)
+			if issue != nil {
+				result.Errors = append(result.Errors, *issue)
+				continue
+			}
+			if seen[importPath] {
+				continue
+			}
+			seen[importPath] = true
+			result.Files = append(result.Files, resolved)
+			queue = append(queue, resolved)
+		}
+	}
+}
+
+func resolveV1ListedImport(owner, importPath string, index map[string]v1ListedFile) (v1ListedFile, *v1ListError) {
+	if !modules.ValidProtoImportPath(importPath) {
+		return v1ListedFile{}, &v1ListError{Code: "invalid_import", Message: fmt.Sprintf("%s imports %q", owner, importPath)}
+	}
+	if file, found := index[importPath]; found {
+		return file, nil
+	}
+	_, err := wellknownimports.Content.ReadFile(importPath)
+	if errors.Is(err, os.ErrNotExist) {
+		return v1ListedFile{}, &v1ListError{Code: "import_not_found", Message: fmt.Sprintf("%s imports %q", owner, importPath)}
+	}
+	if err != nil {
+		return v1ListedFile{}, &v1ListError{Code: "open_error", Message: fmt.Sprintf("%s imports %q: %v", owner, importPath, err)}
+	}
+	file := v1ListedFile{AbsPath: wellKnownV1Root + "/" + importPath, ImportPath: importPath, Source: "wellknown", Root: wellKnownV1Root}
+	index[importPath] = file
+	return file, nil
+}
+
+func readV1ListedImports(file v1ListedFile) ([]string, error) {
+	if file.Source != "wellknown" {
+		return modules.ReadProtoImports(filepath.FromSlash(file.AbsPath))
+	}
+	raw, err := wellknownimports.Content.ReadFile(file.ImportPath)
+	if err != nil {
+		return nil, fmt.Errorf("ReadFile: %w", err)
+	}
+	return modules.ParseProtoImports(file.ImportPath, raw)
+}
+
+func printV1ListedFiles(output, diagnostics io.Writer, result v1ListResult) error {
+	for _, file := range result.Files {
+		if _, err := fmt.Fprintf(output, "%s\t%s\t%s\n", file.ImportPath, file.Source, file.AbsPath); err != nil {
+			return fmt.Errorf("Fprintf: %w", err)
+		}
+	}
+	for _, issue := range result.Errors {
+		if _, err := fmt.Fprintf(diagnostics, "%s: %s\n", issue.Code, issue.Message); err != nil {
+			return fmt.Errorf("Fprintf: %w", err)
+		}
+	}
+	return nil
+}
diff --git a/internal/api/ls_files_v1_errors_test.go b/internal/api/ls_files_v1_errors_test.go
new file mode 100644
index 00000000..f2cf8cdf
--- /dev/null
+++ b/internal/api/ls_files_v1_errors_test.go
@@ -0,0 +1,112 @@
+package api
+
+import (
+	"bytes"
+	"encoding/json"
+	"flag"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/flags"
+)
+
+// Action reads the process cwd, so these CLI cases must run sequentially.
+func TestLsFilesActionReportsErrorsBeforeFailing(t *testing.T) {
+	tests := []struct {
+		name           string
+		format         string
+		includeImports bool
+		broken         bool
+	}{
+		{name: "json_errors", format: flags.JSONFormat, includeImports: true, broken: true},
+		{name: "text_errors", format: flags.TextFormat, includeImports: true, broken: true},
+		{name: "json_success", format: flags.JSONFormat, includeImports: true},
+		{name: "text_success", format: flags.TextFormat, includeImports: true},
+		{name: "local_only_ignores_import_errors", format: flags.JSONFormat, broken: true},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			root := t.TempDir()
+			writeV1GenerateFixture(t, root, "protobuf.mod", "module example.com/app\n")
+			writeV1GenerateFixture(t, root, "valid.proto", `syntax = "proto3"; import "google/protobuf/timestamp.proto";`)
+			if tt.broken {
+				writeV1GenerateFixture(t, root, "missing.proto", `syntax = "proto3"; import "absent.proto"; import "google/protobuf/not_real.proto";`)
+				writeV1GenerateFixture(t, root, "syntax.proto", `syntax = "proto3"; message Broken {`)
+				writeV1GenerateFixture(t, root, "traversal.proto", `syntax = "proto3"; import "nested/../valid.proto";`)
+			}
+			t.Chdir(root)
+			var output, diagnostics bytes.Buffer
+			app := cli.NewApp()
+			app.Writer, app.ErrWriter = &output, &diagnostics
+			set := flag.NewFlagSet("ls-files", flag.ContinueOnError)
+			set.Bool(flagLsFilesIncludeImports.Name, tt.includeImports, "")
+			set.String(flags.Format.Name, flags.JSONFormat, "")
+			require.NoError(t, set.Set(flags.Format.Name, tt.format))
+			ctx := cli.NewContext(app, set, nil)
+			ctx.Context = t.Context()
+
+			err := (LsFiles{}).Action(ctx)
+
+			wantErrors := tt.broken && tt.includeImports
+			if wantErrors {
+				var exitErr cli.ExitCoder
+				require.ErrorAs(t, err, &exitErr)
+				assert.Equal(t, 1, exitErr.ExitCode())
+			} else {
+				assert.NoError(t, err)
+			}
+			if tt.format == flags.TextFormat {
+				assert.Contains(t, output.String(), "valid.proto\tworkspace\t")
+				assert.Contains(t, output.String(), "google/protobuf/timestamp.proto\twellknown\t")
+				if wantErrors {
+					assert.Contains(t, diagnostics.String(), "import_not_found: missing.proto imports \"absent.proto\"")
+					assert.Contains(t, diagnostics.String(), "google/protobuf/not_real.proto")
+					assert.Contains(t, diagnostics.String(), "parse_error: syntax.proto")
+					assert.Contains(t, diagnostics.String(), "invalid_import: traversal.proto")
+				} else {
+					assert.Empty(t, diagnostics.String())
+				}
+				return
+			}
+			var result v1ListResult
+			require.NoError(t, json.Unmarshal(output.Bytes(), &result))
+			assert.NotEmpty(t, result.Roots)
+			var paths []string
+			for _, file := range result.Files {
+				paths = append(paths, file.ImportPath)
+			}
+			assert.Contains(t, paths, "valid.proto")
+			if tt.includeImports {
+				assert.Contains(t, paths, "google/protobuf/timestamp.proto")
+			} else {
+				assert.NotContains(t, paths, "google/protobuf/timestamp.proto")
+			}
+			if wantErrors {
+				assert.Len(t, result.Errors, 4)
+				assert.Contains(t, result.Errors, v1ListError{Code: "import_not_found", Message: `missing.proto imports "absent.proto"`})
+				assert.Contains(t, result.Errors, v1ListError{Code: "import_not_found", Message: `missing.proto imports "google/protobuf/not_real.proto"`})
+				assert.Contains(t, result.Errors, v1ListError{Code: "invalid_import", Message: `traversal.proto imports "nested/../valid.proto"`})
+			} else {
+				assert.Empty(t, result.Errors)
+			}
+			assert.Empty(t, diagnostics.String())
+		})
+	}
+}
+
+func TestListV1FilesRejectsInvalidAlreadyListedImport(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, "main.proto", `syntax = "proto3"; import "invalid:name.proto";`)
+	writeV1GenerateFixture(t, root, "invalid:name.proto", `syntax = "proto3";`)
+	module := v1.Module{Name: "example.com/app", Roots: []string{"."}}
+
+	result, err := listV1Files(t.Context(), root, module, true, nil)
+
+	require.NoError(t, err)
+	assert.Equal(t, []v1ListError{{Code: "invalid_import", Message: `main.proto imports "invalid:name.proto"`}}, result.Errors)
+}
diff --git a/internal/api/ls_files_v1_test.go b/internal/api/ls_files_v1_test.go
new file mode 100644
index 00000000..6c0d23cb
--- /dev/null
+++ b/internal/api/ls_files_v1_test.go
@@ -0,0 +1,135 @@
+package api
+
+import (
+	"flag"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestListV1Files(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name           string
+		includeImports bool
+		requires       []v1.Requirement
+		wantImports    []string
+		wantSources    []string
+	}{
+		{
+			name: "reachable well-known import", includeImports: true,
+			wantImports: []string{"event.proto", "google/protobuf/timestamp.proto"},
+			wantSources: []string{"workspace", "wellknown"},
+		},
+		{
+			name: "local-only ignores missing lock", requires: []v1.Requirement{{Module: "example.com/missing", Version: "v1.0.0"}},
+			wantImports: []string{"event.proto"}, wantSources: []string{"workspace"},
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeV1GenerateFixture(t, root, "event.proto", `syntax = "proto3"; package example.v1; import "google/protobuf/timestamp.proto"; message Event { google.protobuf.Timestamp time = 1; }`)
+			module := v1.Module{Name: "example.com/root", Roots: []string{"."}, Requires: tt.requires}
+
+			listed, err := listV1Files(t.Context(), root, module, tt.includeImports, nil)
+
+			require.NoError(t, err)
+			assert.Empty(t, listed.Errors)
+			var imports, sources []string
+			for _, file := range listed.Files {
+				imports = append(imports, file.ImportPath)
+				sources = append(sources, file.Source)
+			}
+			assert.Equal(t, tt.wantImports, imports)
+			assert.Equal(t, tt.wantSources, sources)
+		})
+	}
+}
+
+func TestListV1FilesRejectsDuplicateDependencyImports(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name       string
+		importPath string
+	}{
+		{name: "root_import", importPath: "event.proto"},
+		{name: "nested_import", importPath: "events/v1/event.proto"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			dependency := t.TempDir()
+			replacement, err := filepath.Rel(root, dependency)
+			require.NoError(t, err)
+			writeV1GenerateFixture(t, root, tt.importPath, "syntax = \"proto3\";\n")
+			writeV1GenerateFixture(t, dependency, "protobuf.mod", "module example.com/dep\n")
+			writeV1GenerateFixture(t, dependency, tt.importPath, "syntax = \"proto3\";\n")
+			module := v1.Module{
+				Name: "example.com/root", Roots: []string{"."},
+				Requires: []v1.Requirement{{Module: "example.com/dep", Version: "v1.0.0"}},
+				Replaces: []v1.Replacement{{Module: "example.com/dep", Target: replacement}},
+			}
+
+			_, err = listV1Files(t.Context(), root, module, true, nil)
+
+			require.ErrorContains(t, err, "duplicate import path")
+			require.ErrorContains(t, err, tt.importPath)
+		})
+	}
+}
+
+// The CLI owns process flags, environment, and cwd, so these cases are sequential.
+func TestLsFilesLocalOnlyWithoutCacheEnvironment(t *testing.T) {
+	tests := []struct {
+		name           string
+		manifest       string
+		policy         string
+		includeImports bool
+		wantLegacy     bool
+	}{
+		{name: "local module", manifest: "module example.com/root\n"},
+		{name: "uninstalled dependency", manifest: "module example.com/root\nrequire example.com/missing v1.0.0\n"},
+		{name: "without protobuf.mod", includeImports: true},
+		{name: "legacy project", policy: "deps: []\nlint:\n  use: [DEFAULT]\n", includeImports: true, wantLegacy: true},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			root := t.TempDir()
+			if tt.manifest != "" {
+				writeV1GenerateFixture(t, root, "protobuf.mod", tt.manifest)
+			}
+			if tt.policy != "" {
+				writeV1GenerateFixture(t, root, "easyp.yaml", tt.policy)
+			}
+			writeV1GenerateFixture(t, root, "event.proto", "syntax = \"proto3\";\n")
+			t.Chdir(root)
+			t.Setenv("HOME", "")
+			t.Setenv("EASYPPATH", "")
+			flags := flag.NewFlagSet("ls-files", flag.ContinueOnError)
+			flags.Bool(flagLsFilesIncludeImports.Name, tt.includeImports, "")
+			ctx := cli.NewContext(cli.NewApp(), flags, nil)
+			ctx.Context = t.Context()
+
+			err := (LsFiles{}).Action(ctx)
+
+			if tt.wantLegacy {
+				require.ErrorIs(t, err, v1.ErrLegacyConfiguration)
+				return
+			}
+			require.NoError(t, err)
+		})
+	}
+}
diff --git a/internal/api/migrate.go b/internal/api/migrate.go
new file mode 100644
index 00000000..9992306d
--- /dev/null
+++ b/internal/api/migrate.go
@@ -0,0 +1,128 @@
+package api
+
+import (
+	"fmt"
+	"io"
+	"os"
+	"strings"
+
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/flags"
+	"github.com/easyp-tech/easyp/internal/migration"
+)
+
+// Migrate provides an explicit, preview-first v0 to v1 migration command.
+type Migrate struct{}
+
+var _ Handler = Migrate{}
+
+// Command implements Handler.
+func (m Migrate) Command() *cli.Command {
+	return &cli.Command{
+		Name:        "migrate",
+		Usage:       "migrate EasyP v0 to v1 with a terminal wizard or explicit flags",
+		Description: "Prepares actual v1 files without executing plugins. Flag-only dependency verification requires --resolve-lock; the wizard asks for permission instead. Legacy easyp.lock is retained. Existing native outputs are never overwritten. Without --module, a terminal starts the wizard; --module preserves the noninteractive preview. Use --interactive to request the wizard explicitly or --interactive=false to disable it.",
+		Flags: []cli.Flag{
+			flags.Frozen(),
+			&cli.StringFlag{Name: "dir", Value: ".", Usage: "directory containing legacy easyp.yaml"},
+			&cli.StringFlag{Name: "module", Usage: "canonical identity for the local protobuf module"},
+			&cli.BoolFlag{Name: "interactive", DefaultText: "automatic on a terminal without --module", Usage: "use the terminal wizard; --interactive=false disables automatic prompting"},
+			&cli.BoolFlag{Name: "write", Usage: "apply the validated candidates with historical backups"},
+			&cli.BoolFlag{Name: "resolve-lock", Usage: "explicitly allow dependency resolution/integrity verification and cache writes, including during preview"},
+		},
+		Action: m.Action,
+	}
+}
+
+// Action previews the entire plan before any explicitly requested application.
+func (Migrate) Action(ctx *cli.Context) error {
+	if flags.IsFrozen(ctx) {
+		return fmt.Errorf("migrate is not allowed in frozen mode")
+	}
+	if ctx.NArg() != 0 {
+		return fmt.Errorf("migrate accepts flags only: --dir <root> --module <identity> [--interactive] [--resolve-lock] [--write]")
+	}
+	reader, writer := migrationIO(ctx)
+	interactive, err := migrationInteractiveMode(ctx.IsSet("module"), ctx.IsSet("interactive"), ctx.Bool("interactive"), migrationHasTerminal(reader, writer))
+	if err != nil {
+		return err
+	}
+	options := migration.Options{Dir: ctx.String("dir"), Module: ctx.String("module"), ResolveLock: ctx.Bool("resolve-lock")}
+	if interactive {
+		wizard := migrationWizard{
+			prompt: newMigrationPrompt(reader, writer), writer: writer,
+			repository: func() (migration.Repository, error) { return migrationRepository(ctx) },
+		}
+		return wizard.run(ctx.Context, options, ctx.IsSet("dir"), ctx.IsSet("module"))
+	}
+	if strings.TrimSpace(options.Module) == "" {
+		return fmt.Errorf("--module is required in noninteractive mode; use --interactive in a terminal for guided migration")
+	}
+	if options.ResolveLock {
+		options.Repository, err = migrationRepository(ctx)
+		if err != nil {
+			return fmt.Errorf("migrationRepository: %w", err)
+		}
+	}
+	plan, err := migration.Build(ctx.Context, options)
+	if err != nil {
+		return fmt.Errorf("Build: %w", err)
+	}
+	if err := printMigrationPlan(writer, plan); err != nil {
+		return err
+	}
+	if !ctx.Bool("write") {
+		if _, err := io.WriteString(writer, "\nPreview only. Use --write to apply these candidates.\n"); err != nil {
+			return fmt.Errorf("WriteString: %w", err)
+		}
+		return nil
+	}
+	if err := plan.Apply(); err != nil {
+		return fmt.Errorf("Apply: %w", err)
+	}
+	if !plan.AlreadyV1() {
+		if _, err := io.WriteString(writer, "\nMigration applied. Legacy backups were preserved.\n"); err != nil {
+			return fmt.Errorf("WriteString: %w", err)
+		}
+	}
+	return nil
+}
+
+func migrationIO(ctx *cli.Context) (io.Reader, io.Writer) {
+	reader := ctx.App.Reader
+	if reader == nil {
+		reader = os.Stdin
+	}
+	writer := ctx.App.Writer
+	if writer == nil {
+		writer = os.Stdout
+	}
+	return reader, writer
+}
+
+func migrationRepository(ctx *cli.Context) (migration.Repository, error) {
+	cache, err := moduleCache(ctx)
+	if err != nil {
+		return nil, fmt.Errorf("moduleCache: %w", err)
+	}
+	return cache, nil
+}
+
+func printMigrationPlan(writer io.Writer, plan *migration.Plan) error {
+	for _, warning := range plan.Warnings() {
+		if _, err := fmt.Fprintf(writer, "Warning: %s\n", warning); err != nil {
+			return fmt.Errorf("Fprintf: %w", err)
+		}
+	}
+	for _, output := range plan.Outputs() {
+		status := "candidate"
+		if output.Unchanged {
+			status = "unchanged"
+		}
+		if _, err := fmt.Fprintf(writer, "\n--- %s (%s, mode %04o) ---\n%s\n", output.Name, status, output.Mode.Perm(), output.Content); err != nil {
+			return fmt.Errorf("Fprintf: %w", err)
+		}
+	}
+	return nil
+}
diff --git a/internal/api/migrate_interactive.go b/internal/api/migrate_interactive.go
new file mode 100644
index 00000000..f4bbfce0
--- /dev/null
+++ b/internal/api/migrate_interactive.go
@@ -0,0 +1,196 @@
+package api
+
+import (
+	"bytes"
+	"context"
+	"fmt"
+	"io"
+	"os"
+	"path/filepath"
+	"strings"
+	"unicode"
+
+	"github.com/easyp-tech/easyp/internal/adapters/gitmodules"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/migration"
+)
+
+type migrationWizard struct {
+	prompt     *migrationPrompt
+	writer     io.Writer
+	repository func() (migration.Repository, error)
+}
+
+func (w migrationWizard) run(ctx context.Context, options migration.Options, directorySet, moduleSet bool) error {
+	if _, err := io.WriteString(w.writer, "EasyP v0 to v1 migration wizard\nNo plugins will run. Dependency access and file writes require separate confirmations.\n"); err != nil {
+		return fmt.Errorf("WriteString: %w", err)
+	}
+	directory, err := w.directory(ctx, options.Dir, directorySet)
+	if err != nil {
+		return fmt.Errorf("directory: %w", err)
+	}
+	identity, err := w.identity(ctx, directory, options.Module, moduleSet)
+	if err != nil {
+		return fmt.Errorf("identity: %w", err)
+	}
+	if _, err := fmt.Fprintf(w.writer, "\nProject: %q\nModule: %q\n\nMigration preview (no dependency access):\n", directory, identity); err != nil {
+		return fmt.Errorf("Fprintf: %w", err)
+	}
+	// Flags may prefill the form, but never bypass consent in the wizard.
+	options = migration.Options{Dir: directory, Module: identity}
+	plan, err := migration.Build(ctx, options)
+	if err != nil {
+		return fmt.Errorf("Build: %w", err)
+	}
+	if err := printMigrationPlan(w.writer, plan); err != nil {
+		return err
+	}
+	if plan.AlreadyV1() {
+		return nil
+	}
+	if plan.NeedsLockResolution() {
+		allowed, err := w.prompt.confirm(ctx, "Allow dependency resolution and cache writes (may access the network)?")
+		if err != nil {
+			return fmt.Errorf("confirm: %w", err)
+		}
+		if !allowed {
+			return w.cancelled("Dependencies were not resolved.")
+		}
+		if err := plan.CheckUnchanged(); err != nil {
+			return fmt.Errorf("CheckUnchanged: %w", err)
+		}
+		originalPlan := plan
+		options.Repository, err = w.repository()
+		if err != nil {
+			return fmt.Errorf("repository: %w", err)
+		}
+		options.ResolveLock = true
+		plan, err = migration.Build(ctx, options)
+		if err != nil {
+			return fmt.Errorf("Build: %w", err)
+		}
+		if err := originalPlan.CheckUnchanged(); err != nil {
+			return fmt.Errorf("CheckUnchanged: %w", err)
+		}
+		if _, err := io.WriteString(w.writer, "\nVerified migration preview:\n"); err != nil {
+			return fmt.Errorf("WriteString: %w", err)
+		}
+		if err := printMigrationPlan(w.writer, plan); err != nil {
+			return err
+		}
+		if plan.AlreadyV1() {
+			return nil
+		}
+	}
+	allowed, err := w.prompt.confirm(ctx, "Apply these changes and create legacy backups?")
+	if err != nil {
+		return fmt.Errorf("confirm: %w", err)
+	}
+	if !allowed {
+		return w.cancelled("Any explicitly authorized dependency cache entries are retained.")
+	}
+	if err := ctx.Err(); err != nil {
+		return err
+	}
+	// Apply exactly the plan that was shown; it rechecks observed input state.
+	if err := plan.Apply(); err != nil {
+		return fmt.Errorf("Apply: %w", err)
+	}
+	if _, err := io.WriteString(w.writer, "\nMigration applied. Legacy backups were preserved.\n"); err != nil {
+		return fmt.Errorf("WriteString: %w", err)
+	}
+	return nil
+}
+
+func (w migrationWizard) directory(ctx context.Context, value string, explicit bool) (string, error) {
+	for {
+		if !explicit {
+			entered, err := w.prompt.input(ctx, "Migration directory", value)
+			if err != nil {
+				return "", err
+			}
+			value = entered
+		}
+		root, err := migrationDirectory(value)
+		if err == nil || explicit {
+			return root, err
+		}
+		if _, err := fmt.Fprintf(w.writer, "Invalid directory: %v\n", err); err != nil {
+			return "", fmt.Errorf("Fprintf: %w", err)
+		}
+	}
+}
+
+func migrationDirectory(value string) (string, error) {
+	root, err := filepath.Abs(value)
+	if err != nil {
+		return "", fmt.Errorf("Abs: %w", err)
+	}
+	info, err := os.Stat(root)
+	if err != nil {
+		return "", fmt.Errorf("Stat: %w", err)
+	}
+	if !info.IsDir() {
+		return "", fmt.Errorf("%q is not a directory", root)
+	}
+	info, err = os.Lstat(filepath.Join(root, v1.PolicyFile))
+	if err != nil {
+		return "", fmt.Errorf("Lstat: %w", err)
+	}
+	if !info.Mode().IsRegular() {
+		return "", fmt.Errorf("easyp.yaml must be a regular file")
+	}
+	return root, nil
+}
+
+func (w migrationWizard) identity(ctx context.Context, root, value string, explicit bool) (string, error) {
+	fallback := value
+	if !explicit && fallback == "" {
+		fallback = migrationSuggestedIdentity(ctx, root)
+	}
+	for {
+		if !explicit {
+			entered, err := w.prompt.input(ctx, "Module identity (for example github.com/acme/contracts)", fallback)
+			if err != nil {
+				return "", err
+			}
+			value = entered
+		}
+		err := migration.ValidateModuleIdentity(value)
+		if err == nil || explicit {
+			return value, err
+		}
+		if _, err := fmt.Fprintf(w.writer, "Invalid module identity: %v\n", err); err != nil {
+			return "", fmt.Errorf("Fprintf: %w", err)
+		}
+	}
+}
+
+func migrationSuggestedIdentity(ctx context.Context, root string) string {
+	var identity string
+	raw, err := os.ReadFile(filepath.Join(root, v1.ModuleFile))
+	if err == nil {
+		module, err := v1.ParseModule(bytes.NewReader(raw))
+		if err == nil {
+			identity = module.Name
+		}
+	}
+	if identity == "" {
+		// Reads local Git configuration only; credentials are removed by the helper.
+		canonical, err := filepath.EvalSymlinks(root)
+		if err == nil {
+			identity = gitmodules.WorkspaceIdentity(ctx, canonical)
+		}
+	}
+	if migration.ValidateModuleIdentity(identity) != nil || strings.IndexFunc(identity, unicode.IsControl) >= 0 {
+		return ""
+	}
+	return identity
+}
+
+func (w migrationWizard) cancelled(detail string) error {
+	if _, err := fmt.Fprintf(w.writer, "\nMigration cancelled. Project files were not changed. %s\n", detail); err != nil {
+		return fmt.Errorf("Fprintf: %w", err)
+	}
+	return nil
+}
diff --git a/internal/api/migrate_interactive_test.go b/internal/api/migrate_interactive_test.go
new file mode 100644
index 00000000..d0419e28
--- /dev/null
+++ b/internal/api/migrate_interactive_test.go
@@ -0,0 +1,339 @@
+package api
+
+import (
+	"bytes"
+	"context"
+	"errors"
+	"io"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/migration"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+func TestMigrationInteractiveMode(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name                                       string
+		module, flagSet, requested, terminal, want bool
+		wantError                                  bool
+	}{
+		{name: "plain terminal starts wizard", terminal: true, want: true},
+		{name: "module preserves terminal preview", module: true, terminal: true},
+		{name: "pipe is never interactive"},
+		{name: "explicit module in pipe", module: true},
+		{name: "explicit wizard with module", module: true, flagSet: true, requested: true, terminal: true, want: true},
+		{name: "explicit wizard without module", flagSet: true, requested: true, terminal: true, want: true},
+		{name: "wizard refuses pipe", flagSet: true, requested: true, wantError: true},
+		{name: "wizard refuses redirected output even with module", module: true, flagSet: true, requested: true, wantError: true},
+		{name: "explicit false disables wizard", flagSet: true, terminal: true},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			got, err := migrationInteractiveMode(tt.module, tt.flagSet, tt.requested, tt.terminal)
+			if tt.wantError {
+				require.ErrorContains(t, err, "requires terminal input and output")
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, got)
+		})
+	}
+}
+
+func TestMigrationPromptConfirmation(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name, input string
+		want        bool
+		wantError   error
+		invalid     bool
+	}{
+		{name: "yes", input: "yes\n", want: true},
+		{name: "uppercase yes and CRLF", input: "Y\r\n", want: true},
+		{name: "no", input: "no\n"},
+		{name: "Enter defaults to no", input: "\n"},
+		{name: "bad answer must be corrected", input: "maybe\nyes\n", want: true, invalid: true},
+		{name: "EOF does not accept default", wantError: io.EOF},
+		{name: "unterminated yes is not consent", input: "yes", wantError: io.EOF},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			var out bytes.Buffer
+			got, err := newMigrationPrompt(strings.NewReader(tt.input), &out).confirm(t.Context(), "Apply?")
+			if tt.wantError != nil {
+				require.ErrorIs(t, err, tt.wantError)
+				assert.False(t, got)
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, got)
+			assert.Contains(t, out.String(), "[y/N]")
+			assert.Equal(t, tt.invalid, strings.Contains(out.String(), "Please answer yes or no"))
+		})
+	}
+}
+
+func TestMigrationWizardAppliesOnlyReviewedConsent(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name, input string
+		apply       bool
+		wantError   bool
+	}{
+		{name: "explicit yes", input: "yes\n", apply: true},
+		{name: "explicit no", input: "no\n"},
+		{name: "empty answer", input: "\n"},
+		{name: "EOF", wantError: true},
+		{name: "incomplete yes", input: "yes", wantError: true},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			original := []byte("lint:\n  use: [MINIMAL]\n")
+			path := filepath.Join(root, v1.PolicyFile)
+			require.NoError(t, os.WriteFile(path, original, 0o640))
+			var out bytes.Buffer
+			wizard := migrationWizard{
+				prompt: newMigrationPrompt(strings.NewReader(tt.input), &out), writer: &out,
+				repository: func() (migration.Repository, error) { t.Fatal("unneeded dependency access"); return nil, nil },
+			}
+			err := wizard.run(t.Context(), migration.Options{Dir: root, Module: "example.com/app", ResolveLock: true}, true, true)
+			if tt.wantError {
+				require.ErrorIs(t, err, io.EOF)
+			} else {
+				require.NoError(t, err)
+			}
+			assert.Contains(t, out.String(), "easyp.gen.yaml (candidate")
+			assert.Contains(t, out.String(), "Apply these changes")
+			assert.NotContains(t, out.String(), "Allow dependency")
+			after, err := os.ReadFile(path)
+			require.NoError(t, err)
+			if !tt.apply {
+				assert.Equal(t, original, after)
+				assert.NoFileExists(t, path+".v0.bak")
+				assert.NoFileExists(t, filepath.Join(root, v1.ModuleFile))
+				return
+			}
+			assert.NotEqual(t, original, after)
+			backup, err := os.ReadFile(path + ".v0.bak")
+			require.NoError(t, err)
+			assert.Equal(t, original, backup)
+			out.Reset()
+			wizard.prompt = newMigrationPrompt(strings.NewReader(""), &out)
+			require.NoError(t, wizard.run(t.Context(), migration.Options{Dir: root, Module: "example.com/app"}, true, true))
+			assert.Contains(t, out.String(), "Already v1")
+			assert.NotContains(t, out.String(), "Apply these changes")
+		})
+	}
+}
+
+type interactiveMigrationRepository struct {
+	calls int
+	err   error
+}
+
+func (r *interactiveMigrationRepository) FetchMigration(_ context.Context, source, version, _ string) (modules.Fetched, error) {
+	r.calls++
+	return modules.Fetched{Module: v1.Module{Name: source, Roots: []string{"."}}, Lock: v1.LockedModule{
+		Source: source, Version: version, Commit: strings.Repeat("a", 40), Hash: "h1:" + strings.Repeat("A", 43) + "=",
+	}}, r.err
+}
+
+func TestMigrationWizardSeparatesDependencyAndWriteConsent(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name, answers     string
+		access, apply     bool
+		resolutionFailure bool
+	}{
+		{name: "decline access", answers: "no\n"},
+		{name: "empty access confirmation", answers: "\n"},
+		{name: "access is not write consent", answers: "yes\nno\n", access: true},
+		{name: "both permissions", answers: "yes\nyes\n", access: true, apply: true},
+		{name: "verification failure never asks to apply", answers: "yes\nyes\n", access: true, resolutionFailure: true},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			original := []byte("lint: {}\ndeps: [github.com/acme/dep@v1.0.0]\n")
+			require.NoError(t, os.WriteFile(filepath.Join(root, v1.PolicyFile), original, 0o644))
+			repo := &interactiveMigrationRepository{}
+			failure := errors.New("legacy integrity mismatch")
+			if tt.resolutionFailure {
+				repo.err = failure
+			}
+			opened := 0
+			var out bytes.Buffer
+			wizard := migrationWizard{
+				prompt: newMigrationPrompt(strings.NewReader(tt.answers), &out), writer: &out,
+				repository: func() (migration.Repository, error) { opened++; return repo, nil },
+			}
+			err := wizard.run(t.Context(), migration.Options{Dir: root, Module: "example.com/app", ResolveLock: true}, true, true)
+			if tt.resolutionFailure {
+				require.ErrorIs(t, err, failure)
+				assert.NotContains(t, out.String(), "Apply these changes")
+			} else {
+				require.NoError(t, err)
+			}
+			assert.Equal(t, tt.access, opened != 0)
+			assert.Equal(t, tt.access, repo.calls != 0)
+			if !tt.apply {
+				after, err := os.ReadFile(filepath.Join(root, v1.PolicyFile))
+				require.NoError(t, err)
+				assert.Equal(t, original, after)
+				assert.NoFileExists(t, filepath.Join(root, v1.LockFile))
+				return
+			}
+			assert.FileExists(t, filepath.Join(root, v1.LockFile))
+			assert.Less(t, strings.Index(out.String(), "Verified migration preview:"), strings.Index(out.String(), "Apply these changes"))
+		})
+	}
+}
+
+func TestMigrationWizardInputCorrection(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	require.NoError(t, os.WriteFile(filepath.Join(root, v1.PolicyFile), []byte("lint: {}\n"), 0o644))
+	var out bytes.Buffer
+	wizard := migrationWizard{
+		prompt: newMigrationPrompt(strings.NewReader(filepath.Join(root, "missing")+"\n"+root+"\nbad identity\nexample.com/app\nyes\n"), &out), writer: &out,
+	}
+	require.NoError(t, wizard.run(t.Context(), migration.Options{Dir: root}, false, false))
+	assert.Contains(t, out.String(), "Invalid directory")
+	assert.Contains(t, out.String(), "Invalid module identity")
+	assert.FileExists(t, filepath.Join(root, v1.ModuleFile))
+}
+
+func TestMigrateFlagModeNeverPromptsOnPipes(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct {
+		name      string
+		args      []string
+		wantError string
+	}{
+		{name: "missing module", wantError: "--module is required"},
+		{name: "forced interactive", args: []string{"--interactive"}, wantError: "requires terminal"},
+		{name: "explicit false", args: []string{"--interactive=false"}, wantError: "--module is required"},
+		{name: "flag preview", args: []string{"--module", "example.com/app"}},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			require.NoError(t, os.WriteFile(filepath.Join(root, v1.PolicyFile), []byte("lint: {}\n"), 0o644))
+			var out bytes.Buffer
+			// The CLI library shares its default help flag; do not share it across isolated app tests.
+			command := (Migrate{}).Command()
+			command.HideHelp = true
+			app := &cli.App{HideHelp: true, HideHelpCommand: true, Commands: []*cli.Command{command}, Reader: strings.NewReader("yes\nyes\n"), Writer: &out, ErrWriter: &out}
+			args := append([]string{"easyp", "migrate", "--dir", root}, tt.args...)
+			err := app.RunContext(t.Context(), args)
+			if tt.wantError != "" {
+				require.ErrorContains(t, err, tt.wantError)
+			} else {
+				require.NoError(t, err)
+				assert.Contains(t, out.String(), "Preview only")
+			}
+			assert.NotContains(t, out.String(), "[y/N]")
+			assert.NoFileExists(t, filepath.Join(root, v1.ModuleFile))
+		})
+	}
+}
+
+type migrationTestWriter func([]byte) (int, error)
+
+func (f migrationTestWriter) Write(p []byte) (int, error) { return f(p) }
+
+func TestMigrationWizardRejectsSourceChangeDuringConfirmation(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	path := filepath.Join(root, v1.PolicyFile)
+	require.NoError(t, os.WriteFile(path, []byte("lint: {}\n"), 0o644))
+	changed := []byte("lint: {}\n# user's concurrent edit\n")
+	var out bytes.Buffer
+	writer := migrationTestWriter(func(p []byte) (int, error) {
+		if bytes.Contains(p, []byte("Apply these changes")) {
+			require.NoError(t, os.WriteFile(path, changed, 0o644))
+		}
+		return out.Write(p)
+	})
+	wizard := migrationWizard{prompt: newMigrationPrompt(strings.NewReader("yes\n"), writer), writer: writer}
+	err := wizard.run(t.Context(), migration.Options{Dir: root, Module: "example.com/app"}, true, true)
+	require.ErrorContains(t, err, "changed")
+	after, err := os.ReadFile(path)
+	require.NoError(t, err)
+	assert.Equal(t, changed, after)
+	assert.NoFileExists(t, path+".v0.bak")
+	assert.NoFileExists(t, filepath.Join(root, v1.ModuleFile))
+}
+
+func TestMigrationPromptFailuresAreNotConsent(t *testing.T) {
+	t.Parallel()
+	t.Run("cancelled context", func(t *testing.T) {
+		t.Parallel()
+		ctx, cancel := context.WithCancel(t.Context())
+		cancel()
+		var out bytes.Buffer
+		ok, err := newMigrationPrompt(strings.NewReader("yes\n"), &out).confirm(ctx, "Apply?")
+		require.ErrorIs(t, err, context.Canceled)
+		assert.False(t, ok)
+		assert.Empty(t, out.String())
+	})
+	t.Run("output unavailable", func(t *testing.T) {
+		t.Parallel()
+		failed := errors.New("output unavailable")
+		writer := migrationTestWriter(func([]byte) (int, error) { return 0, failed })
+		ok, err := newMigrationPrompt(strings.NewReader("yes\n"), writer).confirm(t.Context(), "Apply?")
+		require.ErrorIs(t, err, failed)
+		assert.False(t, ok)
+	})
+	t.Run("oversized input", func(t *testing.T) {
+		t.Parallel()
+		ok, err := newMigrationPrompt(strings.NewReader(strings.Repeat("y", 32*1024)+"\n"), io.Discard).confirm(t.Context(), "Apply?")
+		require.Error(t, err)
+		assert.False(t, ok)
+	})
+}
+
+func TestMigrationSuggestedIdentityIsLocalAndCredentialFree(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	runTestGit(t, root, "init", "-q")
+	runTestGit(t, root, "remote", "add", "origin", "https://test-user:do-not-show@example.test/acme/contracts.git?token=hidden")
+	assert.Equal(t, "example.test/acme/contracts", migrationSuggestedIdentity(t.Context(), root))
+	require.NoError(t, os.WriteFile(filepath.Join(root, v1.ModuleFile), []byte("module example.test/native\n"), 0o644))
+	assert.Equal(t, "example.test/native", migrationSuggestedIdentity(t.Context(), root))
+}
+
+func TestMigrationWizardDoesNotResolveChangedDependencies(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	path := filepath.Join(root, v1.PolicyFile)
+	require.NoError(t, os.WriteFile(path, []byte("lint: {}\ndeps: [github.com/acme/dep@v1.0.0]\n"), 0o644))
+	var out bytes.Buffer
+	writer := migrationTestWriter(func(p []byte) (int, error) {
+		if bytes.Contains(p, []byte("Allow dependency resolution")) {
+			require.NoError(t, os.WriteFile(path, []byte("lint: {}\ndeps: [github.com/acme/different@v1.0.0]\n"), 0o644))
+		}
+		return out.Write(p)
+	})
+	wizard := migrationWizard{
+		prompt: newMigrationPrompt(strings.NewReader("yes\nyes\n"), writer), writer: writer,
+		repository: func() (migration.Repository, error) { t.Fatal("unreviewed dependencies accessed"); return nil, nil },
+	}
+	err := wizard.run(t.Context(), migration.Options{Dir: root, Module: "example.com/app"}, true, true)
+	require.ErrorContains(t, err, "changed")
+	assert.NoFileExists(t, filepath.Join(root, v1.ModuleFile))
+}
diff --git a/internal/api/migrate_prompt.go b/internal/api/migrate_prompt.go
new file mode 100644
index 00000000..86eb4a5f
--- /dev/null
+++ b/internal/api/migrate_prompt.go
@@ -0,0 +1,88 @@
+package api
+
+import (
+	"bufio"
+	"context"
+	"fmt"
+	"io"
+	"strings"
+	"unicode"
+
+	"github.com/charmbracelet/x/term"
+)
+
+// migrationPrompt keeps normal terminal line editing and needs no raw mode or
+// alternate screen. It never opens /dev/tty to bypass redirected application IO.
+type migrationPrompt struct {
+	reader *bufio.Reader
+	writer io.Writer
+}
+
+func newMigrationPrompt(reader io.Reader, writer io.Writer) *migrationPrompt {
+	return &migrationPrompt{reader: bufio.NewReaderSize(reader, 16*1024), writer: writer}
+}
+
+func migrationHasTerminal(reader io.Reader, writer io.Writer) bool {
+	type descriptor interface{ Fd() uintptr }
+	input, inputOK := reader.(descriptor)
+	output, outputOK := writer.(descriptor)
+	return inputOK && outputOK && term.IsTerminal(input.Fd()) && term.IsTerminal(output.Fd())
+}
+
+func migrationInteractiveMode(moduleSet, flagSet, requested, terminal bool) (bool, error) {
+	if flagSet {
+		if requested && !terminal {
+			return false, fmt.Errorf("--interactive requires terminal input and output; use --module with explicit --write/--resolve-lock flags for scripts")
+		}
+		return requested, nil
+	}
+	return !moduleSet && terminal, nil
+}
+
+func (p *migrationPrompt) input(ctx context.Context, message, fallback string) (string, error) {
+	if err := ctx.Err(); err != nil {
+		return "", err
+	}
+	label := message
+	if fallback != "" {
+		label += " [" + fallback + "]"
+	}
+	if _, err := fmt.Fprintf(p.writer, "%s: ", label); err != nil {
+		return "", fmt.Errorf("Fprintf: %w", err)
+	}
+	line, err := p.reader.ReadSlice('\n')
+	if err != nil {
+		// Even an unterminated "yes" is not consent. EOF never accepts defaults.
+		return "", fmt.Errorf("migration input cancelled or incomplete: %w", err)
+	}
+	if err := ctx.Err(); err != nil {
+		return "", err
+	}
+	value := strings.TrimSpace(string(line))
+	if strings.IndexFunc(value, unicode.IsControl) >= 0 {
+		return "", fmt.Errorf("migration input must not contain control characters")
+	}
+	if value == "" {
+		value = fallback
+	}
+	return value, nil
+}
+
+func (p *migrationPrompt) confirm(ctx context.Context, question string) (bool, error) {
+	for {
+		value, err := p.input(ctx, question+" [y/N]", "")
+		if err != nil {
+			return false, err
+		}
+		switch strings.ToLower(value) {
+		case "y", "yes":
+			return true, nil
+		case "", "n", "no":
+			return false, nil
+		default:
+			if _, err := io.WriteString(p.writer, "Please answer yes or no; Enter means no.\n"); err != nil {
+				return false, fmt.Errorf("WriteString: %w", err)
+			}
+		}
+	}
+}
diff --git a/internal/api/mod.go b/internal/api/mod.go
index 207ff470..5b659f65 100644
--- a/internal/api/mod.go
+++ b/internal/api/mod.go
@@ -1,17 +1,8 @@
 package api
 
 import (
-	"errors"
-	"fmt"
-	"os"
-
-	"github.com/urfave/cli/v2"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
 	"github.com/easyp-tech/easyp/internal/flags"
-	"github.com/easyp-tech/easyp/internal/fs/fs"
-
-	"github.com/easyp-tech/easyp/internal/config"
+	"github.com/urfave/cli/v2"
 )
 
 var _ Handler = (*Mod)(nil)
@@ -21,6 +12,7 @@ type Mod struct{}
 
 func (m Mod) Command() *cli.Command {
 	downloadCmd := &cli.Command{
+		Flags:       []cli.Flag{flags.Frozen()},
 		Name:        "download",
 		Usage:       "download modules to local cache",
 		UsageText:   "download modules to local cache",
@@ -28,20 +20,25 @@ func (m Mod) Command() *cli.Command {
 		Action:      m.Download,
 	}
 	updateCmd := &cli.Command{
+		Flags:       []cli.Flag{flags.Frozen()},
 		Name:        "update",
-		Usage:       "update modules version using version from config",
-		UsageText:   "update modules version using version from config",
-		Description: "update modules version using version from config",
+		Usage:       "refresh requirements within their current major versions and rewrite protobuf.mod/protobuf.lock",
+		UsageText:   "refresh requirements within their current major versions and rewrite protobuf.mod/protobuf.lock",
+		Description: "refresh requirements within their current major versions and rewrite protobuf.mod/protobuf.lock",
 		Action:      m.Update,
 	}
+	tidyCmd := &cli.Command{
+		Flags:  []cli.Flag{flags.Frozen()},
+		Name:   "tidy",
+		Usage:  "resolve protobuf.mod and write protobuf.lock",
+		Action: m.Tidy,
+	}
 	vendorCmd := &cli.Command{
-		Name:        "vendor",
-		Usage:       "copy proto files from deps to vendor dir",
-		UsageText:   "copy proto files from deps to vendor dir",
-		Description: "copy proto files from deps to vendor dir",
-		Action:      m.Vendor,
+		Flags:  []cli.Flag{flags.Frozen()},
+		Name:   "vendor",
+		Usage:  "copy locked protobuf imports into easyp_vendor",
+		Action: m.Vendor,
 	}
-
 	return &cli.Command{
 		Name:                   "mod",
 		Aliases:                []string{"m"},
@@ -55,8 +52,8 @@ func (m Mod) Command() *cli.Command {
 		After:                  nil,
 		Action:                 nil,
 		OnUsageError:           nil,
-		Subcommands:            []*cli.Command{downloadCmd, updateCmd, vendorCmd},
-		Flags:                  []cli.Flag{},
+		Subcommands:            []*cli.Command{downloadCmd, updateCmd, tidyCmd, vendorCmd},
+		Flags:                  []cli.Flag{flags.Frozen()},
 		SkipFlagParsing:        false,
 		HideHelp:               false,
 		HideHelpCommand:        false,
@@ -66,104 +63,3 @@ func (m Mod) Command() *cli.Command {
 		CustomHelpTemplate:     "",
 	}
 }
-
-func (m Mod) Download(ctx *cli.Context) error {
-	log := getLogger(ctx)
-
-	workingDir, err := os.Getwd()
-	if err != nil {
-		return fmt.Errorf("os.Getwd: %w", err)
-	}
-	dirWalker := fs.NewFSWalker(workingDir, ".")
-
-	cfg, err := config.New(ctx.Context, ctx.String(flags.Config.Name))
-	if err != nil {
-		return fmt.Errorf("config.New: %w", err)
-	}
-
-	app, err := buildCore(ctx.Context, log, *cfg, dirWalker)
-	if err != nil {
-		return fmt.Errorf("buildCore: %w", err)
-	}
-
-	if err := app.Download(ctx.Context); err != nil {
-		if errors.Is(err, models.ErrVersionNotFound) {
-			os.Exit(1)
-		}
-
-		return fmt.Errorf("cmd.Download: %w", err)
-	}
-	return nil
-}
-
-func (m Mod) Update(ctx *cli.Context) error {
-	log := getLogger(ctx)
-
-	workingDir, err := os.Getwd()
-	if err != nil {
-		return fmt.Errorf("os.Getwd: %w", err)
-	}
-	dirWalker := fs.NewFSWalker(workingDir, ".")
-
-	cfg, err := config.New(ctx.Context, ctx.String(flags.Config.Name))
-	if err != nil {
-		return fmt.Errorf("config.New: %w", err)
-	}
-
-	app, err := buildCore(ctx.Context, log, *cfg, dirWalker)
-	if err != nil {
-		return fmt.Errorf("buildCore: %w", err)
-	}
-
-	if err := app.Update(ctx.Context); err != nil {
-		if errors.Is(err, models.ErrVersionNotFound) {
-			os.Exit(1)
-		}
-
-		return fmt.Errorf("cmd.Download: %w", err)
-	}
-	return nil
-}
-
-func (m Mod) Vendor(ctx *cli.Context) error {
-	log := getLogger(ctx)
-
-	workingDir, err := os.Getwd()
-	if err != nil {
-		return fmt.Errorf("os.Getwd: %w", err)
-	}
-	dirWalker := fs.NewFSWalker(workingDir, ".")
-
-	cfg, err := config.New(ctx.Context, ctx.String(flags.Config.Name))
-	if err != nil {
-		return fmt.Errorf("config.New: %w", err)
-	}
-
-	app, err := buildCore(ctx.Context, log, *cfg, dirWalker)
-	if err != nil {
-		return fmt.Errorf("buildCore: %w", err)
-	}
-
-	if err := app.Vendor(ctx.Context); err != nil {
-		if errors.Is(err, models.ErrVersionNotFound) {
-			os.Exit(1)
-		}
-
-		return fmt.Errorf("cmd.Download: %w", err)
-	}
-	return nil
-}
-
-func getDepsFromGenerateDeps(cfg config.Generate) []string {
-	res := make([]string, 0, len(cfg.Inputs))
-	for _, input := range cfg.Inputs {
-		url := input.GitRepo.URL
-		if url == "" {
-			continue
-		}
-
-		res = append(res, url)
-	}
-
-	return res
-}
diff --git a/internal/api/mod_v1.go b/internal/api/mod_v1.go
new file mode 100644
index 00000000..f6a4a4cb
--- /dev/null
+++ b/internal/api/mod_v1.go
@@ -0,0 +1,43 @@
+package api
+
+import (
+	"fmt"
+
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/flags"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+// Tidy executes the v1 module operation from the current directory.
+func (m Mod) Tidy(ctx *cli.Context) error {
+	if flags.IsFrozen(ctx) {
+		return fmt.Errorf("mod tidy is not allowed in frozen mode")
+	}
+	root, err := moduleWorkingDir()
+	if err != nil {
+		return fmt.Errorf("moduleWorkingDir: %w", err)
+	}
+	cache, err := moduleCache(ctx)
+	if err != nil {
+		return fmt.Errorf("moduleCache: %w", err)
+	}
+	return modules.Tidy(ctx.Context, root, cache)
+}
+
+// Download executes the v1 module operation from the current directory.
+func (m Mod) Download(ctx *cli.Context) error {
+	root, err := moduleWorkingDir()
+	if err != nil {
+		return fmt.Errorf("moduleWorkingDir: %w", err)
+	}
+	cache, err := moduleCache(ctx)
+	if err != nil {
+		return fmt.Errorf("moduleCache: %w", err)
+	}
+	if flags.IsFrozen(ctx) {
+		_, err := modules.EnsureFrozenSources(ctx.Context, root, cache)
+		return err
+	}
+	return modules.Download(ctx.Context, root, cache)
+}
diff --git a/internal/api/mod_v1_cache.go b/internal/api/mod_v1_cache.go
new file mode 100644
index 00000000..9878fc22
--- /dev/null
+++ b/internal/api/mod_v1_cache.go
@@ -0,0 +1,18 @@
+package api
+
+import (
+	"fmt"
+
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/adapters/bsr"
+	"github.com/easyp-tech/easyp/internal/adapters/gitmodules"
+)
+
+func moduleCache(ctx *cli.Context) (*gitmodules.Cache, error) {
+	root, err := getEasypPath(getLogger(ctx))
+	if err != nil {
+		return nil, fmt.Errorf("getEasypPath: %w", err)
+	}
+	return gitmodules.NewWithBSRResolver(root, bsr.StaticResolver{Logger: getLogger(ctx)}), nil
+}
diff --git a/internal/api/mod_v1_lock_test.go b/internal/api/mod_v1_lock_test.go
new file mode 100644
index 00000000..f011856a
--- /dev/null
+++ b/internal/api/mod_v1_lock_test.go
@@ -0,0 +1,816 @@
+package api
+
+import (
+	"context"
+	"flag"
+	"fmt"
+	"io"
+	"os"
+	"os/exec"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+	"golang.org/x/mod/sumdb/dirhash"
+	"gopkg.in/yaml.v3"
+
+	"github.com/easyp-tech/easyp/internal/adapters/gitmodules"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+func TestBuildV1LockPinsGitCommitAndGoStyleH1(t *testing.T) {
+	remote := filepath.Join(t.TempDir(), "dependency")
+	if err := os.MkdirAll(filepath.Join(remote, "dep", "v1"), 0o755); err != nil {
+		t.Fatal(err)
+	}
+	manifest := fmt.Sprintf("module %s\n", remote)
+	proto := "syntax = \"proto3\";\npackage dep.v1;\nmessage Item { string id = 1; }\n"
+	for name, content := range map[string]string{
+		"protobuf.mod":     manifest,
+		"dep/v1/dep.proto": proto,
+	} {
+		if err := os.WriteFile(filepath.Join(remote, name), []byte(content), 0o644); err != nil {
+			t.Fatal(err)
+		}
+	}
+	runTestGit(t, remote, "init", "-q")
+	runTestGit(t, remote, "add", ".")
+	runTestGit(t, remote, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+	runTestGit(t, remote, "tag", "v1.0.0")
+	commit := strings.TrimSpace(runTestGit(t, remote, "rev-parse", "HEAD"))
+
+	wantHash, err := dirhash.Hash1([]string{"dep/v1/dep.proto", "protobuf.mod"}, func(name string) (io.ReadCloser, error) {
+		return os.Open(filepath.Join(remote, filepath.FromSlash(name)))
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+	module := v1.Module{
+		Name:     "example.com/root",
+		Roots:    []string{"."},
+		Requires: []v1.Requirement{{Module: remote, Version: "v1.0.0"}},
+	}
+	lock, err := modules.Resolve(context.Background(), module, gitmodules.New(filepath.Join(t.TempDir(), "cache")), nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if lock.Version != 1 || len(lock.Modules) != 1 {
+		t.Fatalf("unexpected lock: %#v", lock)
+	}
+	entry := lock.Modules[0]
+	if entry.Source != remote || entry.Version != "v1.0.0" || entry.Commit != commit || entry.Hash != wantHash {
+		t.Fatalf("lock entry = %#v; want source=%q version=v1.0.0 commit=%q hash=%q", entry, remote, commit, wantHash)
+	}
+}
+
+func TestBuildV1LockSelectsModulesFromOneGitRepository(t *testing.T) {
+	repository := filepath.Join(t.TempDir(), "monorepo")
+	foo := filepath.Join(repository, "foo")
+	bar := filepath.Join(repository, "bar")
+	for name, content := range map[string]string{
+		"foo/protobuf.mod":    fmt.Sprintf("module %s\nroots proto\n", foo),
+		"foo/proto/foo.proto": "syntax = \"proto3\";\nmessage Foo {}\n",
+		"bar/protobuf.mod":    fmt.Sprintf("module %s\nroots proto\n", bar),
+		"bar/proto/bar.proto": "syntax = \"proto3\";\nmessage Bar {}\n",
+	} {
+		path := filepath.Join(repository, name)
+		if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil {
+			t.Fatal(err)
+		}
+		if err := os.WriteFile(path, []byte(content), 0o644); err != nil {
+			t.Fatal(err)
+		}
+	}
+	runTestGit(t, repository, "init", "-q")
+	runTestGit(t, repository, "add", ".")
+	runTestGit(t, repository, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+	for _, tag := range []string{"foo/v1.0.0", "foo/v1.1.0", "bar/v1.0.0"} {
+		runTestGit(t, repository, "tag", tag)
+	}
+	module := v1.Module{Requires: []v1.Requirement{
+		{Module: foo, Version: "v1.0.0"},
+		{Module: bar, Version: "v1.0.0"},
+	}}
+	cache := t.TempDir()
+	lock, err := modules.Resolve(context.Background(), module, gitmodules.New(cache), nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if len(lock.Modules) != 2 || lock.Modules[0].Source != bar || lock.Modules[1].Source != foo {
+		t.Fatalf("unexpected multi-module lock: %#v", lock)
+	}
+	if err := gitmodules.New(cache).Install(context.Background(), lock); err != nil {
+		t.Fatal(err)
+	}
+	roots, err := modules.CachedSources(lock, gitmodules.New(cache))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if len(roots) != 2 || roots[0].Module != bar || roots[1].Module != foo {
+		t.Fatalf("unexpected multi-module roots: %#v", roots)
+	}
+	for _, root := range roots {
+		name := filepath.Base(filepath.Dir(root.Path))
+		if _, err := os.Stat(filepath.Join(root.Path, name+".proto")); err != nil {
+			t.Fatal(err)
+		}
+	}
+	versions, err := gitmodules.New(cache).Versions(t.Context(), foo)
+	require.NoError(t, err)
+	assert.Equal(t, []string{"v1.0.0", "v1.1.0"}, versions)
+}
+
+func TestBuildV1LockSelectsUntaggedModulesByCommit(t *testing.T) {
+	repository := filepath.Join(t.TempDir(), "monorepo")
+	foo := filepath.Join(repository, "foo")
+	bar := filepath.Join(repository, "bar")
+	for name, content := range map[string]string{
+		"foo/protobuf.mod":    fmt.Sprintf("module %s\nroots proto\n", foo),
+		"foo/proto/foo.proto": "syntax = \"proto3\";\nmessage Foo {}\n",
+		"bar/protobuf.mod":    fmt.Sprintf("module %s\nroots proto\n", bar),
+		"bar/proto/bar.proto": "syntax = \"proto3\";\nmessage Bar {}\n",
+	} {
+		path := filepath.Join(repository, name)
+		if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil {
+			t.Fatal(err)
+		}
+		if err := os.WriteFile(path, []byte(content), 0o644); err != nil {
+			t.Fatal(err)
+		}
+	}
+	runTestGit(t, repository, "init", "-q")
+	runTestGit(t, repository, "add", ".")
+	runTestGit(t, repository, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+	commit := strings.TrimSpace(runTestGit(t, repository, "rev-parse", "HEAD"))
+	module := v1.Module{Requires: []v1.Requirement{
+		{Module: foo, Version: commit},
+		{Module: bar, Version: commit},
+	}}
+	cache := t.TempDir()
+	lock, err := modules.Resolve(context.Background(), module, gitmodules.New(cache), nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if err := lock.Validate(); err != nil {
+		t.Fatal(err)
+	}
+	if len(lock.Modules) != 2 {
+		t.Fatalf("lock has %d modules, want two", len(lock.Modules))
+	}
+	for _, entry := range lock.Modules {
+		if entry.Commit != commit || entry.Version != commit {
+			t.Fatalf("unexpected pinned module: %#v", entry)
+		}
+	}
+	if err := modules.ValidateRequirements(module.Requires, lock); err != nil {
+		t.Fatal(err)
+	}
+	if err := gitmodules.New(cache).Install(context.Background(), lock); err != nil {
+		t.Fatal(err)
+	}
+	roots, err := modules.CachedSources(lock, gitmodules.New(cache))
+	if err != nil || len(roots) != 2 {
+		t.Fatalf("roots: %#v, %v", roots, err)
+	}
+}
+
+func TestTidyV1ResolvesUntaggedModulesWithoutVersionsAndKeepsLock(t *testing.T) {
+	repository := filepath.Join(t.TempDir(), "monorepo")
+	foo := filepath.Join(repository, "foo")
+	bar := filepath.Join(repository, "bar")
+	for name, content := range map[string]string{
+		"foo/protobuf.mod":    fmt.Sprintf("module %s\nroots proto\n", foo),
+		"foo/proto/foo.proto": "syntax = \"proto3\";\npackage foo.v1;\nmessage Foo {}\n",
+		"bar/protobuf.mod":    fmt.Sprintf("module %s\nroots proto\n", bar),
+		"bar/proto/bar.proto": "syntax = \"proto3\";\npackage bar.v1;\nmessage Bar {}\n",
+	} {
+		path := filepath.Join(repository, name)
+		if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil {
+			t.Fatal(err)
+		}
+		if err := os.WriteFile(path, []byte(content), 0o644); err != nil {
+			t.Fatal(err)
+		}
+	}
+	runTestGit(t, repository, "init", "-q")
+	runTestGit(t, repository, "add", ".")
+	runTestGit(t, repository, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+	initial := strings.TrimSpace(runTestGit(t, repository, "rev-parse", "HEAD"))
+	root := t.TempDir()
+	manifest := fmt.Sprintf("module example.com/app\nrequire (\n  %s\n  %s\n)\n", foo, bar)
+	if err := os.WriteFile(filepath.Join(root, "protobuf.mod"), []byte(manifest), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	appProto := "syntax = \"proto3\";\npackage app.v1;\nimport \"foo.proto\";\nimport \"bar.proto\";\nmessage App { foo.v1.Foo foo = 1; bar.v1.Bar bar = 2; }\n"
+	if err := os.WriteFile(filepath.Join(root, "app.proto"), []byte(appProto), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	t.Setenv("EASYPPATH", t.TempDir())
+	oldDir, err := os.Getwd()
+	if err != nil {
+		t.Fatal(err)
+	}
+	if err := os.Chdir(root); err != nil {
+		t.Fatal(err)
+	}
+	t.Cleanup(func() { _ = os.Chdir(oldDir) })
+	cliCtx := &cli.Context{Context: context.Background(), App: &cli.App{Metadata: map[string]any{}}}
+	readLock := func() v1.Lock {
+		t.Helper()
+		lock, err := modules.ReadLock(filepath.Join(root, "protobuf.lock"))
+		if err != nil {
+			t.Fatal(err)
+		}
+		return lock
+	}
+	if err := (Mod{}).Tidy(cliCtx); err != nil {
+		t.Fatal(err)
+	}
+	lock := readLock()
+	if len(lock.Modules) != 2 {
+		t.Fatalf("want two modules, got %#v", lock)
+	}
+	for _, entry := range lock.Modules {
+		if entry.Version != initial || entry.Commit != initial {
+			t.Fatalf("unexpected auto-resolved module: %#v", entry)
+		}
+	}
+	if err := os.WriteFile(filepath.Join(foo, "proto", "foo.proto"), []byte("syntax = \"proto3\";\npackage foo.v1;\nmessage Foo { string id = 1; }\n"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	runTestGit(t, repository, "add", ".")
+	runTestGit(t, repository, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "foo update")
+	updated := strings.TrimSpace(runTestGit(t, repository, "rev-parse", "HEAD"))
+	if err := (Mod{}).Tidy(cliCtx); err != nil {
+		t.Fatal(err)
+	}
+	for _, entry := range readLock().Modules {
+		if entry.Commit != initial {
+			t.Fatalf("tidy changed a pinned dependency: %#v", entry)
+		}
+	}
+	if err := (Mod{}).Update(cliCtx); err != nil {
+		t.Fatal(err)
+	}
+	for _, entry := range readLock().Modules {
+		if entry.Commit != updated || entry.Version != updated {
+			t.Fatalf("update did not refresh an unversioned dependency: %#v", entry)
+		}
+	}
+}
+
+func TestDownloadV1LockKeepsCommitAfterTagMoves(t *testing.T) {
+	remote := filepath.Join(t.TempDir(), "dependency")
+	if err := os.MkdirAll(remote, 0o755); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(filepath.Join(remote, "protobuf.mod"), []byte(fmt.Sprintf("module %s\n", remote)), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	proto := filepath.Join(remote, "dep.proto")
+	oldContent := []byte("syntax = \"proto3\";\nmessage Old {}\n")
+	if err := os.WriteFile(proto, oldContent, 0o644); err != nil {
+		t.Fatal(err)
+	}
+	runTestGit(t, remote, "init", "-q")
+	runTestGit(t, remote, "add", ".")
+	runTestGit(t, remote, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "old")
+	runTestGit(t, remote, "tag", "v1.0.0")
+	cacheRoot := filepath.Join(t.TempDir(), "cache")
+	module := v1.Module{Name: "example.com/root", Requires: []v1.Requirement{{Module: remote, Version: "v1.0.0"}}}
+	lock, err := modules.Resolve(context.Background(), module, gitmodules.New(cacheRoot), nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(proto, []byte("syntax = \"proto3\";\nmessage New {}\n"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	runTestGit(t, remote, "add", ".")
+	runTestGit(t, remote, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "new")
+	runTestGit(t, remote, "tag", "-f", "v1.0.0")
+	if err := gitmodules.New(cacheRoot).Install(context.Background(), lock); err != nil {
+		t.Fatal(err)
+	}
+	installed, err := os.ReadFile(filepath.Join(cachedTestDir(t, gitmodules.New(cacheRoot), lock.Modules[0]), "dep.proto"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if string(installed) != string(oldContent) {
+		t.Fatalf("download followed moved tag instead of locked commit: %s", installed)
+	}
+}
+
+func TestTidyV1WritesLockedGitDependency(t *testing.T) {
+	// The command uses the process working directory and EASYPPATH.
+	tests := []struct {
+		name    string
+		version string
+	}{
+		{name: "tagged requirement", version: "v1.0.0"},
+		{name: "versionless requirement"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			remote := t.TempDir()
+			require.NoError(t, os.WriteFile(filepath.Join(remote, v1.ModuleFile), []byte("module "+remote+"\n"), 0o644))
+			require.NoError(t, os.WriteFile(filepath.Join(remote, "dep.proto"), []byte("syntax = \"proto3\";\npackage dep.v1;\nmessage Item { string id = 1; }\n"), 0o644))
+			runTestGit(t, remote, "init", "-q")
+			runTestGit(t, remote, "add", ".")
+			runTestGit(t, remote, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+			runTestGit(t, remote, "tag", "v1.0.0")
+			commit := strings.TrimSpace(runTestGit(t, remote, "rev-parse", "HEAD"))
+			wantHash, err := dirhash.Hash1([]string{"dep.proto", v1.ModuleFile}, func(name string) (io.ReadCloser, error) {
+				return os.Open(filepath.Join(remote, name))
+			})
+			require.NoError(t, err)
+			root := t.TempDir()
+			manifest := fmt.Sprintf("module example.com/root\nrequire %s %s\n", remote, tt.version)
+			require.NoError(t, os.WriteFile(filepath.Join(root, v1.ModuleFile), []byte(manifest), 0o644))
+			cacheBase := t.TempDir()
+			t.Setenv("EASYPPATH", cacheBase)
+			t.Chdir(root)
+			cliCtx := cli.NewContext(&cli.App{Metadata: map[string]any{}}, flag.NewFlagSet("test", flag.ContinueOnError), nil)
+
+			err = (Mod{}).Tidy(cliCtx)
+
+			require.NoError(t, err)
+			lock, err := modules.ReadLock(filepath.Join(root, v1.LockFile))
+			require.NoError(t, err)
+			require.Len(t, lock.Modules, 1)
+			assert.Equal(t, 1, lock.Version)
+			wantVersion := tt.version
+			if wantVersion == "" {
+				wantVersion = commit
+			}
+			assert.Equal(t, v1.LockedModule{Source: remote, Version: wantVersion, Commit: commit, Hash: wantHash}, lock.Modules[0])
+			require.NoError(t, (Mod{}).Download(cliCtx))
+			cache := cacheBase
+			assert.FileExists(t, filepath.Join(cachedTestDir(t, gitmodules.New(cache), lock.Modules[0]), "dep.proto"))
+			module, err := v1.ParseModule(strings.NewReader(manifest))
+			require.NoError(t, err)
+			sources, err := modules.EnsureLockedSources(context.Background(), root, module, gitmodules.New(cache))
+			require.NoError(t, err)
+			roots := sources.Paths()
+			require.Len(t, roots, 1)
+			assert.FileExists(t, filepath.Join(roots[0], "dep.proto"))
+		})
+	}
+}
+
+func TestDownloadV1LockPinsCommitAndChecksCachedH1(t *testing.T) {
+	remote := filepath.Join(t.TempDir(), "dependency")
+	if err := os.MkdirAll(remote, 0o755); err != nil {
+		t.Fatal(err)
+	}
+	for name, content := range map[string]string{
+		"protobuf.mod": fmt.Sprintf("module %s\n", remote),
+		"dep.proto":    "syntax = \"proto3\";\npackage dep.v1;\nmessage Item { string id = 1; }\n",
+	} {
+		if err := os.WriteFile(filepath.Join(remote, name), []byte(content), 0o644); err != nil {
+			t.Fatal(err)
+		}
+	}
+	runTestGit(t, remote, "init", "-q")
+	runTestGit(t, remote, "add", ".")
+	runTestGit(t, remote, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+	runTestGit(t, remote, "tag", "v1.0.0")
+	cacheRoot := filepath.Join(t.TempDir(), "cache")
+	lock, err := modules.Resolve(context.Background(), v1.Module{Requires: []v1.Requirement{{Module: remote, Version: "v1.0.0"}}}, gitmodules.New(cacheRoot), nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if err := gitmodules.New(cacheRoot).Install(context.Background(), lock); err != nil {
+		t.Fatal(err)
+	}
+	installed := cachedTestDir(t, gitmodules.New(cacheRoot), lock.Modules[0])
+	if _, err := os.Stat(filepath.Join(installed, "dep.proto")); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(filepath.Join(installed, "dep.proto"), []byte("tampered"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	if err := gitmodules.New(cacheRoot).Install(context.Background(), lock); err == nil || !strings.Contains(err.Error(), "hash mismatch") {
+		t.Fatalf("expected cached hash mismatch, got %v", err)
+	}
+}
+
+func TestDownloadV1LockRejectsUnsafeCommit(t *testing.T) {
+	lock := v1.Lock{Version: 1, Modules: []v1.LockedModule{{
+		Source: "example.com/dependency", Version: "v1.0.0",
+		Commit: "../../outside", Hash: "h1:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=",
+	}}}
+	if err := gitmodules.New(t.TempDir()).Install(context.Background(), lock); err == nil || !strings.Contains(err.Error(), "invalid commit") {
+		t.Fatalf("expected invalid commit error, got %v", err)
+	}
+}
+
+func TestGenerateV1UsesLockedGitDependency(t *testing.T) {
+	// EASYPPATH is process-wide, so each case runs with its own environment in sequence.
+	tests := []struct {
+		name           string
+		dependencyRoot string
+	}{
+		{name: "repository root", dependencyRoot: "."},
+		{name: "configured proto root", dependencyRoot: "proto"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			remote := t.TempDir()
+			require.NoError(t, os.MkdirAll(filepath.Join(remote, tt.dependencyRoot), 0o755))
+			dependencyManifest := fmt.Sprintf("module %s\nroots %s\n", remote, tt.dependencyRoot)
+			require.NoError(t, os.WriteFile(filepath.Join(remote, v1.ModuleFile), []byte(dependencyManifest), 0o644))
+			require.NoError(t, os.WriteFile(filepath.Join(remote, tt.dependencyRoot, "dep.proto"), []byte("syntax = \"proto3\";\npackage dep.v1;\nmessage Item { string id = 1; }\n"), 0o644))
+			runTestGit(t, remote, "init", "-q")
+			runTestGit(t, remote, "add", ".")
+			runTestGit(t, remote, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+			runTestGit(t, remote, "tag", "v1.0.0")
+			root := t.TempDir()
+			manifest := fmt.Sprintf("module example.com/root\nrequire %s v1.0.0\n", remote)
+			require.NoError(t, os.WriteFile(filepath.Join(root, v1.ModuleFile), []byte(manifest), 0o644))
+			require.NoError(t, os.WriteFile(filepath.Join(root, "user.proto"), []byte("syntax = \"proto3\";\npackage user.v1;\nimport \"dep.proto\";\nmessage User { dep.v1.Item item = 1; }\n"), 0o644))
+			module, err := v1.ParseModule(strings.NewReader(manifest))
+			require.NoError(t, err)
+			cacheBase := t.TempDir()
+			t.Setenv("EASYPPATH", cacheBase)
+			lock, err := modules.Resolve(context.Background(), module, gitmodules.New(cacheBase), nil)
+			require.NoError(t, err)
+			raw, err := yaml.Marshal(lock)
+			require.NoError(t, err)
+			require.NoError(t, os.WriteFile(filepath.Join(root, v1.LockFile), raw, 0o644))
+			err = os.WriteFile(filepath.Join(root, v1.GenerateFile), []byte("version: v1\nplugins:\n  - name: python\n    out: ./gen/python\n"), 0o600)
+			require.NoError(t, err)
+			cliCtx := cli.NewContext(&cli.App{Metadata: map[string]any{}}, flag.NewFlagSet("test", flag.ContinueOnError), nil)
+
+			t.Chdir(root)
+			err = (Generate{}).Action(cliCtx)
+
+			require.NoError(t, err)
+			assert.FileExists(t, filepath.Join(root, "gen", "python", "user_pb2.py"))
+		})
+	}
+}
+
+func TestTidyV1RejectsUnresolvedImportWithRequirement(t *testing.T) {
+	remote := filepath.Join(t.TempDir(), "dependency")
+	if err := os.MkdirAll(remote, 0o755); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(filepath.Join(remote, "protobuf.mod"), []byte(fmt.Sprintf("module %s\n", remote)), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(filepath.Join(remote, "dep.proto"), []byte("syntax = \"proto3\";\n"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	runTestGit(t, remote, "init", "-q")
+	runTestGit(t, remote, "add", ".")
+	runTestGit(t, remote, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+	runTestGit(t, remote, "tag", "v1.0.0")
+	root := t.TempDir()
+	manifest := fmt.Sprintf("module example.com/root\nrequire %s v1.0.0\n", remote)
+	if err := os.WriteFile(filepath.Join(root, "protobuf.mod"), []byte(manifest), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(filepath.Join(root, "user.proto"), []byte("syntax = \"proto3\";\nimport \"missing.proto\";\n"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	t.Setenv("EASYPPATH", filepath.Join(t.TempDir(), "cache"))
+	oldDir, err := os.Getwd()
+	if err != nil {
+		t.Fatal(err)
+	}
+	if err := os.Chdir(root); err != nil {
+		t.Fatal(err)
+	}
+	t.Cleanup(func() { _ = os.Chdir(oldDir) })
+	cliCtx := &cli.Context{Context: context.Background(), App: &cli.App{Metadata: map[string]any{}}}
+	if err := (Mod{}).Tidy(cliCtx); err == nil || !strings.Contains(err.Error(), "missing.proto") {
+		t.Fatalf("expected missing import error, got %v", err)
+	}
+	if _, err := os.Stat(filepath.Join(root, "protobuf.lock")); !os.IsNotExist(err) {
+		t.Fatalf("tidy wrote an invalid lockfile: %v", err)
+	}
+}
+
+func TestUpdateV1SelectsLatestCompatibleTag(t *testing.T) {
+	remote := filepath.Join(t.TempDir(), "dependency")
+	if err := os.MkdirAll(remote, 0o755); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(filepath.Join(remote, "protobuf.mod"), []byte(fmt.Sprintf("module %s\n", remote)), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	protoPath := filepath.Join(remote, "dep.proto")
+	if err := os.WriteFile(protoPath, []byte("syntax = \"proto3\";\npackage dep.v1;\nmessage Item { string id = 1; }\n"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	runTestGit(t, remote, "init", "-q")
+	runTestGit(t, remote, "add", ".")
+	runTestGit(t, remote, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "v1.0")
+	runTestGit(t, remote, "tag", "v1.0.0")
+	if err := os.WriteFile(protoPath, []byte("syntax = \"proto3\";\npackage dep.v1;\nmessage Item { string id = 1; string name = 2; }\n"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	runTestGit(t, remote, "add", ".")
+	runTestGit(t, remote, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "v1.1")
+	runTestGit(t, remote, "tag", "v1.1.0")
+	wantCommit := strings.TrimSpace(runTestGit(t, remote, "rev-parse", "HEAD"))
+	if err := os.WriteFile(protoPath, []byte("syntax = \"proto3\";\npackage dep.v2;\nmessage Item {}\n"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	runTestGit(t, remote, "add", ".")
+	runTestGit(t, remote, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "v2")
+	runTestGit(t, remote, "tag", "v2.0.0")
+
+	root := t.TempDir()
+	manifest := fmt.Sprintf("module example.com/root\nrequire %s v1.0.0\n", remote)
+	if err := os.WriteFile(filepath.Join(root, "protobuf.mod"), []byte(manifest), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(filepath.Join(root, "user.proto"), []byte("syntax = \"proto3\";\nimport \"dep.proto\";\n"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	t.Setenv("EASYPPATH", filepath.Join(t.TempDir(), "cache"))
+	oldDir, err := os.Getwd()
+	if err != nil {
+		t.Fatal(err)
+	}
+	if err := os.Chdir(root); err != nil {
+		t.Fatal(err)
+	}
+	t.Cleanup(func() { _ = os.Chdir(oldDir) })
+	cliCtx := &cli.Context{Context: context.Background(), App: &cli.App{Metadata: map[string]any{}}}
+	if err := (Mod{}).Update(cliCtx); err != nil {
+		t.Fatal(err)
+	}
+	updated, err := os.ReadFile(filepath.Join(root, "protobuf.mod"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if !strings.Contains(string(updated), remote+" v1.1.0") || strings.Contains(string(updated), "v2.0.0") {
+		t.Fatalf("unexpected updated manifest: %s", updated)
+	}
+	lockRaw, err := os.ReadFile(filepath.Join(root, "protobuf.lock"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	var lock v1.Lock
+	if err := yaml.Unmarshal(lockRaw, &lock); err != nil {
+		t.Fatal(err)
+	}
+	if len(lock.Modules) != 1 || lock.Modules[0].Version != "v1.1.0" || lock.Modules[0].Commit != wantCommit {
+		t.Fatalf("unexpected updated lock: %#v", lock)
+	}
+}
+
+func TestBuildV1LockSelectsTransitiveMinimum(t *testing.T) {
+	root := t.TempDir()
+	common := filepath.Join(root, "common")
+	weather := filepath.Join(root, "weather")
+	for _, dir := range []string{common, weather} {
+		if err := os.MkdirAll(dir, 0o755); err != nil {
+			t.Fatal(err)
+		}
+		runTestGit(t, dir, "init", "-q")
+	}
+	if err := os.WriteFile(filepath.Join(common, "protobuf.mod"), []byte(fmt.Sprintf("module %s\n", common)), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(filepath.Join(common, "common.proto"), []byte("syntax = \"proto3\";\n"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	runTestGit(t, common, "add", ".")
+	runTestGit(t, common, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "common 1.0")
+	runTestGit(t, common, "tag", "v1.0.0")
+	if err := os.WriteFile(filepath.Join(common, "common.proto"), []byte("syntax = \"proto3\";\npackage common.v1;\n"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	runTestGit(t, common, "add", ".")
+	runTestGit(t, common, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "common 1.1")
+	runTestGit(t, common, "tag", "v1.1.0")
+	if err := os.WriteFile(filepath.Join(weather, "protobuf.mod"), []byte(fmt.Sprintf("module %s\nrequire %s v1.1.0\n", weather, common)), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	runTestGit(t, weather, "add", ".")
+	runTestGit(t, weather, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "weather")
+	runTestGit(t, weather, "tag", "v1.0.0")
+	module := v1.Module{Name: "example.com/root", Roots: []string{"."}, Requires: []v1.Requirement{
+		{Module: common, Version: "v1.0.0"}, {Module: weather, Version: "v1.0.0"},
+	}}
+	lock, err := modules.Resolve(context.Background(), module, gitmodules.New(filepath.Join(t.TempDir(), "cache")), nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if len(lock.Modules) != 2 {
+		t.Fatalf("lock modules = %#v", lock.Modules)
+	}
+	for _, entry := range lock.Modules {
+		if entry.Source == common && entry.Version != "v1.1.0" {
+			t.Fatalf("common version = %s", entry.Version)
+		}
+	}
+}
+
+func TestDownloadV1RejectsStaleDirectRequirement(t *testing.T) {
+	remote := filepath.Join(t.TempDir(), "dependency")
+	if err := os.MkdirAll(remote, 0o755); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(filepath.Join(remote, "protobuf.mod"), []byte(fmt.Sprintf("module %s\n", remote)), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	runTestGit(t, remote, "init", "-q")
+	runTestGit(t, remote, "add", ".")
+	runTestGit(t, remote, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+	runTestGit(t, remote, "tag", "v1.0.0")
+	root := t.TempDir()
+	module := v1.Module{Name: "example.com/root", Roots: []string{"."}, Requires: []v1.Requirement{{Module: remote, Version: "v1.0.0"}}}
+	cacheBase := filepath.Join(t.TempDir(), "cache")
+	lock, err := modules.Resolve(context.Background(), module, gitmodules.New(cacheBase), nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	raw, err := yaml.Marshal(lock)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(filepath.Join(root, "protobuf.lock"), raw, 0o644); err != nil {
+		t.Fatal(err)
+	}
+	manifest := fmt.Sprintf("module example.com/root\nrequire %s v1.1.0\n", remote)
+	if err := os.WriteFile(filepath.Join(root, "protobuf.mod"), []byte(manifest), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	t.Setenv("EASYPPATH", cacheBase)
+	oldDir, err := os.Getwd()
+	if err != nil {
+		t.Fatal(err)
+	}
+	if err := os.Chdir(root); err != nil {
+		t.Fatal(err)
+	}
+	t.Cleanup(func() { _ = os.Chdir(oldDir) })
+	cliCtx := &cli.Context{Context: context.Background(), App: &cli.App{Metadata: map[string]any{}}}
+	if err := (Mod{}).Download(cliCtx); err == nil || !strings.Contains(err.Error(), "does not satisfy") {
+		t.Fatalf("expected stale lock error, got %v", err)
+	}
+}
+
+func TestTidyV1RecordsTransitiveRequirementAsIndirect(t *testing.T) {
+	deps := t.TempDir()
+	common := filepath.Join(deps, "common")
+	weather := filepath.Join(deps, "weather")
+	for _, dir := range []string{common, weather} {
+		if err := os.MkdirAll(dir, 0o755); err != nil {
+			t.Fatal(err)
+		}
+		runTestGit(t, dir, "init", "-q")
+	}
+	for path, body := range map[string]string{
+		filepath.Join(common, "protobuf.mod"):   fmt.Sprintf("module %s\n", common),
+		filepath.Join(common, "common.proto"):   "syntax = \"proto3\";\npackage common.v1;\nmessage Common {}\n",
+		filepath.Join(weather, "protobuf.mod"):  fmt.Sprintf("module %s\nrequire %s v1.0.0\n", weather, common),
+		filepath.Join(weather, "weather.proto"): "syntax = \"proto3\";\npackage weather.v1;\nimport \"common.proto\";\nmessage Weather { common.v1.Common common = 1; }\n",
+	} {
+		if err := os.WriteFile(path, []byte(body), 0o644); err != nil {
+			t.Fatal(err)
+		}
+	}
+	for _, dir := range []string{common, weather} {
+		runTestGit(t, dir, "add", ".")
+		runTestGit(t, dir, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+		runTestGit(t, dir, "tag", "v1.0.0")
+	}
+	root := t.TempDir()
+	manifest := fmt.Sprintf("module example.com/root\nrequire %s v1.0.0\n", weather)
+	if err := os.WriteFile(filepath.Join(root, "protobuf.mod"), []byte(manifest), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(filepath.Join(root, "user.proto"), []byte("syntax = \"proto3\";\nimport \"weather.proto\";\n"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	t.Setenv("EASYPPATH", filepath.Join(t.TempDir(), "cache"))
+	oldDir, err := os.Getwd()
+	if err != nil {
+		t.Fatal(err)
+	}
+	if err := os.Chdir(root); err != nil {
+		t.Fatal(err)
+	}
+	t.Cleanup(func() { _ = os.Chdir(oldDir) })
+	ctx := &cli.Context{Context: context.Background(), App: &cli.App{Metadata: map[string]any{}}}
+	if err := (Mod{}).Tidy(ctx); err != nil {
+		t.Fatal(err)
+	}
+	raw, err := os.ReadFile(filepath.Join(root, "protobuf.mod"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	want := common + " v1.0.0 // indirect"
+	if !strings.Contains(string(raw), want) {
+		t.Fatalf("missing transitive requirement %q in:\n%s", want, raw)
+	}
+	if err := (Mod{}).Tidy(ctx); err != nil {
+		t.Fatal(err)
+	}
+	again, err := os.ReadFile(filepath.Join(root, "protobuf.mod"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if string(raw) != string(again) {
+		t.Fatalf("tidy changed an already tidy manifest:\n%s\n---\n%s", raw, again)
+	}
+}
+
+func TestTidyV1MixedBufAndLegacyEasyPDependencies(t *testing.T) {
+	base := t.TempDir()
+	common := filepath.Join(base, "common")
+	legacy := filepath.Join(base, "legacy")
+	buf := filepath.Join(base, "buf")
+	for _, dir := range []string{common, legacy, buf} {
+		if err := os.MkdirAll(dir, 0o755); err != nil {
+			t.Fatal(err)
+		}
+		runTestGit(t, dir, "init", "-q")
+	}
+	files := map[string]string{
+		filepath.Join(common, "protobuf.mod"):           fmt.Sprintf("module %s\n", common),
+		filepath.Join(common, "common.proto"):           "syntax = \"proto3\";\npackage common.v1;\nmessage Common {}\n",
+		filepath.Join(legacy, "protobuf.mod"):           fmt.Sprintf("direct (\n  %s@v1.0.0\n)\n", common),
+		filepath.Join(legacy, "easyp.yaml"):             "generate:\n  inputs:\n    - directory:\n        path: proto\n        root: proto\n",
+		filepath.Join(legacy, "proto", "weather.proto"): "syntax = \"proto3\";\nimport \"common.proto\";\nmessage Weather {}\n",
+		filepath.Join(buf, "buf.yaml"):                  "version: v2\nmodules:\n  - path: schemas\n",
+		filepath.Join(buf, "schemas", "buf.proto"):      "syntax = \"proto3\";\nmessage BufItem {}\n",
+	}
+	for path, body := range files {
+		if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil {
+			t.Fatal(err)
+		}
+		if err := os.WriteFile(path, []byte(body), 0o644); err != nil {
+			t.Fatal(err)
+		}
+	}
+	for _, dir := range []string{common, legacy, buf} {
+		runTestGit(t, dir, "add", ".")
+		runTestGit(t, dir, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+		runTestGit(t, dir, "tag", "v1.0.0")
+	}
+	root := t.TempDir()
+	manifest := fmt.Sprintf("module example.com/root\nrequire (\n  %s v1.0.0\n  %s v1.0.0\n)\n", legacy, buf)
+	if err := os.WriteFile(filepath.Join(root, "protobuf.mod"), []byte(manifest), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(filepath.Join(root, "app.proto"), []byte("syntax = \"proto3\";\nimport \"weather.proto\";\nimport \"buf.proto\";\n"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	cacheBase := filepath.Join(t.TempDir(), "cache")
+	t.Setenv("EASYPPATH", cacheBase)
+	oldDir, err := os.Getwd()
+	if err != nil {
+		t.Fatal(err)
+	}
+	if err := os.Chdir(root); err != nil {
+		t.Fatal(err)
+	}
+	t.Cleanup(func() { _ = os.Chdir(oldDir) })
+	ctx := &cli.Context{Context: context.Background(), App: &cli.App{Metadata: map[string]any{}}}
+	if err := (Mod{}).Tidy(ctx); err != nil {
+		t.Fatal(err)
+	}
+	lock, err := modules.ReadLock(filepath.Join(root, "protobuf.lock"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if len(lock.Modules) != 3 {
+		t.Fatalf("lock should contain Buf, legacy EasyP, and transitive module: %#v", lock.Modules)
+	}
+	updated, err := os.ReadFile(filepath.Join(root, "protobuf.mod"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if !strings.Contains(string(updated), common+" v1.0.0 // indirect") {
+		t.Fatalf("transitive old EasyP dependency missing from manifest: %s", updated)
+	}
+	roots, err := modules.CachedSources(lock, gitmodules.New(cacheBase))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if len(roots) != 3 {
+		t.Fatalf("dependency roots = %v", roots)
+	}
+}
+
+func runTestGit(t *testing.T, dir string, args ...string) string {
+	t.Helper()
+	cmd := exec.Command("git", append([]string{"-C", dir}, args...)...)
+	out, err := cmd.CombinedOutput()
+	if err != nil {
+		t.Fatalf("git %v: %v: %s", args, err, out)
+	}
+	return string(out)
+}
diff --git a/internal/api/mod_v1_only_test.go b/internal/api/mod_v1_only_test.go
new file mode 100644
index 00000000..6a84586a
--- /dev/null
+++ b/internal/api/mod_v1_only_test.go
@@ -0,0 +1,31 @@
+package api
+
+import (
+	"flag"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+)
+
+func TestModCommandsRejectLegacyManifest(t *testing.T) {
+	for _, tc := range []struct {
+		name string
+		run  func(Mod, *cli.Context) error
+	}{
+		{name: "download", run: Mod.Download},
+		{name: "update", run: Mod.Update},
+	} {
+		t.Run(tc.name, func(t *testing.T) {
+			root := t.TempDir()
+			t.Chdir(root)
+			require.NoError(t, os.WriteFile(filepath.Join(root, "protobuf.mod"), []byte("direct (\n)\n"), 0o644))
+			ctx := cli.NewContext(&cli.App{Metadata: map[string]any{}}, flag.NewFlagSet("test", flag.ContinueOnError), nil)
+			ctx.Context = t.Context()
+			err := tc.run(Mod{}, ctx)
+			require.ErrorContains(t, err, "ParseModule")
+		})
+	}
+}
diff --git a/internal/api/mod_v1_update.go b/internal/api/mod_v1_update.go
new file mode 100644
index 00000000..8a57c35b
--- /dev/null
+++ b/internal/api/mod_v1_update.go
@@ -0,0 +1,26 @@
+package api
+
+import (
+	"fmt"
+
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/flags"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+// Update executes the v1 module operation from the current directory.
+func (m Mod) Update(ctx *cli.Context) error {
+	if flags.IsFrozen(ctx) {
+		return fmt.Errorf("mod update is not allowed in frozen mode")
+	}
+	root, err := moduleWorkingDir()
+	if err != nil {
+		return fmt.Errorf("moduleWorkingDir: %w", err)
+	}
+	cache, err := moduleCache(ctx)
+	if err != nil {
+		return fmt.Errorf("moduleCache: %w", err)
+	}
+	return modules.Update(ctx.Context, root, cache)
+}
diff --git a/internal/api/mod_v1_vendor.go b/internal/api/mod_v1_vendor.go
new file mode 100644
index 00000000..5d97401a
--- /dev/null
+++ b/internal/api/mod_v1_vendor.go
@@ -0,0 +1,28 @@
+package api
+
+import (
+	"fmt"
+
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/flags"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+// Vendor executes the v1 module operation from the current directory.
+func (m Mod) Vendor(ctx *cli.Context) error {
+	root, err := moduleWorkingDir()
+	if err != nil {
+		return fmt.Errorf("moduleWorkingDir: %w", err)
+	}
+	cache, err := moduleCache(ctx)
+	if err != nil {
+		return fmt.Errorf("moduleCache: %w", err)
+	}
+	if flags.IsFrozen(ctx) {
+		if _, err := modules.EnsureFrozenSources(ctx.Context, root, cache); err != nil {
+			return err
+		}
+	}
+	return modules.Vendor(ctx.Context, root, cache)
+}
diff --git a/internal/api/module_root.go b/internal/api/module_root.go
new file mode 100644
index 00000000..b9edeb71
--- /dev/null
+++ b/internal/api/module_root.go
@@ -0,0 +1,28 @@
+package api
+
+import (
+	"fmt"
+	"os"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/workspace"
+)
+
+func moduleWorkingDir() (string, error) {
+	cwd, err := os.Getwd()
+	if err != nil {
+		return "", fmt.Errorf("Getwd: %w", err)
+	}
+	root, err := workspace.Module(cwd)
+	if err != nil {
+		policy, lookupErr := workspace.Policy(cwd)
+		if lookupErr == nil {
+			raw, readErr := os.ReadFile(policy)
+			if readErr == nil && v1.LegacyPolicy(raw) {
+				return "", v1.ErrLegacyConfiguration
+			}
+		}
+		return "", fmt.Errorf("Module: %w", err)
+	}
+	return root, nil
+}
diff --git a/internal/api/optional_file.go b/internal/api/optional_file.go
new file mode 100644
index 00000000..e30a2318
--- /dev/null
+++ b/internal/api/optional_file.go
@@ -0,0 +1,18 @@
+package api
+
+import (
+	"errors"
+	"fmt"
+	"os"
+)
+
+func readOptionalFile(path string) ([]byte, bool, error) {
+	raw, err := os.ReadFile(path)
+	if errors.Is(err, os.ErrNotExist) {
+		return nil, false, nil
+	}
+	if err != nil {
+		return nil, false, fmt.Errorf("ReadFile: %w", err)
+	}
+	return raw, true, nil
+}
diff --git a/internal/api/policy_imports.go b/internal/api/policy_imports.go
new file mode 100644
index 00000000..54ab3546
--- /dev/null
+++ b/internal/api/policy_imports.go
@@ -0,0 +1,240 @@
+package api
+
+import (
+	"bytes"
+	"context"
+	"errors"
+	"fmt"
+	"os"
+	"path/filepath"
+
+	gitadapter "github.com/easyp-tech/easyp/internal/adapters/go_git"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/core/path_helpers"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+// findV1PolicyModuleDir finds the nearest module containing the scanned files.
+// A policy can also be used without a module manifest.
+func findV1PolicyModuleDir(projectRoot, scanDir string) (string, error) {
+	for _, dir := range ancestorDirs(scanDir, projectRoot) {
+		_, err := os.Stat(filepath.Join(dir, v1.ModuleFile))
+		if errors.Is(err, os.ErrNotExist) {
+			continue
+		}
+		if err != nil {
+			return "", fmt.Errorf("Stat: %w", err)
+		}
+		return dir, nil
+	}
+	return "", nil
+}
+
+type policyReplacementSources struct {
+	ctx                         context.Context
+	projectRoot, repositoryRoot string
+	cache                       func() (modules.Cache, error)
+	frozen                      bool
+	manifests                   map[string]v1.Module
+	targets                     map[string][]string
+}
+
+func newPolicyReplacementSources(ctx context.Context, projectRoot, repositoryRoot string, cache func() (modules.Cache, error), frozen bool) *policyReplacementSources {
+	return &policyReplacementSources{
+		ctx: ctx, projectRoot: projectRoot, repositoryRoot: repositoryRoot, cache: cache, frozen: frozen,
+		manifests: make(map[string]v1.Module), targets: make(map[string][]string),
+	}
+}
+
+func (s *policyReplacementSources) isUnselectedReplacementSource(scanPath, sourcePath string) (bool, error) {
+	directories := ancestorDirs(filepath.Dir(sourcePath), s.projectRoot)
+	// Read consuming manifests before replacement metadata, which may use a
+	// legacy format or declare additional nested modules.
+	for i := len(directories) - 1; i >= 0; i-- {
+		ancestor := directories[i]
+		targets, err := s.replacementTargets(ancestor, scanPath, sourcePath)
+		if err != nil {
+			return false, fmt.Errorf("replacementTargets: %w", err)
+		}
+		for _, target := range targets {
+			containsSource, err := policyPathContains(target, sourcePath)
+			if err != nil {
+				return false, fmt.Errorf("policyPathContains: %w", err)
+			}
+			if !containsSource {
+				continue
+			}
+			selected, err := policyPathContains(target, scanPath)
+			if err != nil {
+				return false, fmt.Errorf("policyPathContains: %w", err)
+			}
+			if !selected {
+				return true, nil
+			}
+		}
+	}
+	return false, nil
+}
+
+// Resolve each consuming graph once per discovery pass. Only reached main-module
+// replacements own import-only trees; unused directives never open their targets.
+func (s *policyReplacementSources) replacementTargets(directory, scanPath, sourcePath string) ([]string, error) {
+	if targets, known := s.targets[directory]; known {
+		return targets, nil
+	}
+	module, err := s.replacementManifest(directory)
+	if err != nil {
+		return nil, fmt.Errorf("replacementManifest: %w", err)
+	}
+	if len(module.Replaces) == 0 {
+		s.targets[directory] = nil
+		return nil, nil
+	}
+	// An explicitly selected replacement or independent module does not use an
+	// unrelated ancestor's graph. Declarations only identify possible ownership;
+	// the effective graph below decides whether a candidate is actually reached.
+	candidate := false
+	for _, replacement := range module.Replaces {
+		target := modules.ResolveReplacementPath(directory, replacement.Target)
+		if filepath.IsAbs(replacement.Target) && s.projectRoot != s.repositoryRoot {
+			relative, err := baselineRepositoryRelative(s.repositoryRoot, target)
+			if err != nil {
+				return nil, fmt.Errorf("baselineRepositoryRelative: %w", err)
+			}
+			if !filepath.IsLocal(relative) {
+				continue
+			}
+			target = filepath.Join(s.projectRoot, relative)
+		}
+		containsSource, err := policyPathContains(target, sourcePath)
+		if err != nil {
+			return nil, fmt.Errorf("policyPathContains: %w", err)
+		}
+		if !containsSource {
+			continue
+		}
+		selected, err := policyPathContains(target, scanPath)
+		if err != nil {
+			return nil, fmt.Errorf("policyPathContains: %w", err)
+		}
+		if !selected {
+			candidate = true
+			break
+		}
+	}
+	if !candidate {
+		return nil, nil
+	}
+	if s.frozen {
+		return nil, fmt.Errorf("frozen mode rejects replace directives in protobuf.mod; remove replace before using --frozen")
+	}
+	var cache modules.Cache
+	if s.cache != nil {
+		cache, err = s.cache()
+		if err != nil {
+			return nil, fmt.Errorf("cache: %w", err)
+		}
+	}
+	var localPath func(string) (string, error)
+	if s.projectRoot != s.repositoryRoot {
+		snapshot := &gitadapter.Snapshot{Root: s.projectRoot, RepositoryRoot: s.repositoryRoot}
+		localPath = func(target string) (string, error) {
+			return snapshotReplacementPath(snapshot, directory, target)
+		}
+	}
+	graph, err := modules.EnsureEffectiveGraph(s.ctx, directory, module, cache, localPath)
+	if err != nil {
+		return nil, fmt.Errorf("EnsureEffectiveGraph: %w", err)
+	}
+	var targets []string
+	for _, replacement := range module.Replaces {
+		if dependency, reached := graph.Modules[replacement.Module]; reached {
+			targets = append(targets, dependency.Directory)
+		}
+	}
+	s.targets[directory] = targets
+	return targets, nil
+}
+
+func (s *policyReplacementSources) replacementManifest(directory string) (v1.Module, error) {
+	if module, known := s.manifests[directory]; known {
+		return module, nil
+	}
+	raw, err := os.ReadFile(filepath.Join(directory, v1.ModuleFile))
+	if err != nil && !errors.Is(err, os.ErrNotExist) {
+		return v1.Module{}, fmt.Errorf("ReadFile: %w", err)
+	}
+	var module v1.Module
+	if v1.IsModuleManifest(raw) {
+		module, err = v1.ParseModule(bytes.NewReader(raw))
+		if err != nil {
+			return v1.Module{}, fmt.Errorf("ParseModule: %w", err)
+		}
+	}
+	s.manifests[directory] = module
+	return module, nil
+}
+
+func policyPathContains(directory, path string) (bool, error) {
+	directoryAbs, err := filepath.Abs(directory)
+	if err != nil {
+		return false, fmt.Errorf("Abs: %w", err)
+	}
+	pathAbs, err := filepath.Abs(path)
+	if err != nil {
+		return false, fmt.Errorf("Abs: %w", err)
+	}
+	info, err := os.Stat(directoryAbs)
+	if errors.Is(err, os.ErrNotExist) {
+		return false, nil
+	}
+	if err != nil {
+		return false, fmt.Errorf("Stat: %w", err)
+	}
+	if !info.IsDir() {
+		return false, nil
+	}
+	directoryAbs, err = filepath.EvalSymlinks(directoryAbs)
+	if err != nil {
+		return false, fmt.Errorf("EvalSymlinks: %w", err)
+	}
+	pathAbs, err = canonicalPolicyPath(pathAbs)
+	if err != nil {
+		return false, fmt.Errorf("canonicalPolicyPath: %w", err)
+	}
+	return path_helpers.IsTargetPath(directoryAbs, pathAbs), nil
+}
+
+func ensureV1PolicyImportRoots(ctx context.Context, cache modules.Cache, moduleDir string) (modules.SourceRoots, error) {
+	return policyImportRoots(ctx, cache, moduleDir, false)
+}
+
+func policyImportRoots(ctx context.Context, cache modules.Cache, moduleDir string, frozen bool) (modules.SourceRoots, error) {
+	var dependencies modules.SourceRoots
+	var err error
+	if frozen {
+		dependencies, err = modules.EnsureFrozenSources(ctx, moduleDir, cache)
+		if err != nil {
+			return nil, fmt.Errorf("EnsureFrozenSources: %w", err)
+		}
+	}
+	_, module, err := modules.ReadManifest(moduleDir)
+	if err != nil {
+		return nil, fmt.Errorf("ReadManifest: %w", err)
+	}
+	roots, err := modules.ModuleSources(moduleDir, module)
+	if err != nil {
+		return nil, fmt.Errorf("ModuleSources: %w", err)
+	}
+	if !frozen {
+		dependencies, err = modules.EnsureSources(ctx, moduleDir, module, cache)
+		if err != nil {
+			return nil, fmt.Errorf("EnsureSources: %w", err)
+		}
+	}
+	allSources := append(roots, dependencies...)
+	if err := modules.CheckSourceCollisions(allSources); err != nil {
+		return nil, fmt.Errorf("CheckSourceCollisions: %w", err)
+	}
+	return allSources, nil
+}
diff --git a/internal/api/policy_imports_test.go b/internal/api/policy_imports_test.go
new file mode 100644
index 00000000..4876499c
--- /dev/null
+++ b/internal/api/policy_imports_test.go
@@ -0,0 +1,286 @@
+package api
+
+import (
+	"context"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+func TestPolicyImportRoots(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name           string
+		sourceRoot     string
+		dependencyRoot string
+	}{
+		{name: "separate source roots", sourceRoot: "proto", dependencyRoot: "src"},
+		{name: "module directory roots", sourceRoot: ".", dependencyRoot: "."},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root, dependency := t.TempDir(), t.TempDir()
+			replacement, err := filepath.Rel(root, dependency)
+			require.NoError(t, err)
+			writeV1GenerateFixture(t, root, "protobuf.mod", "module example.com/root\nroots "+tt.sourceRoot+"\nrequire example.com/dep v1.0.0\nreplace example.com/dep => "+replacement+"\n")
+			writeV1GenerateFixture(t, root, filepath.Join(tt.sourceRoot, "root.proto"), `syntax = "proto3";`)
+			writeV1GenerateFixture(t, dependency, "protobuf.mod", "module example.com/dep\nroots "+tt.dependencyRoot+"\n")
+			writeV1GenerateFixture(t, dependency, filepath.Join(tt.dependencyRoot, "dep.proto"), `syntax = "proto3";`)
+
+			roots, err := ensureV1PolicyImportRoots(t.Context(), nil, root)
+
+			require.NoError(t, err)
+			assert.Equal(t, []string{filepath.Join(root, tt.sourceRoot), filepath.Join(dependency, tt.dependencyRoot)}, roots.Paths())
+		})
+	}
+}
+
+func TestReplacementOwnershipThroughLockedDependencyIsCached(t *testing.T) {
+	t.Parallel()
+	root, remote := t.TempDir(), t.TempDir()
+	writeV1GenerateFixture(t, root, "protobuf.mod", "module example.com/client\nrequire example.com/remote v1.0.0\nreplace example.com/dep => ./fork\n")
+	writeV1GenerateFixture(t, root, "fork/protobuf.mod", "module example.com/dep\n")
+	writeV1GenerateFixture(t, root, "fork/first.proto", "syntax = \"proto3\";\n")
+	writeV1GenerateFixture(t, root, "fork/second.proto", "syntax = \"proto3\";\n")
+	writeV1GenerateFixture(t, remote, "protobuf.mod", "module example.com/remote\nrequire example.com/dep\n")
+	pin := v1.LockedModule{Source: "example.com/remote", Version: "v1.0.0", Commit: strings.Repeat("a", 40), Hash: "h1:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="}
+	lock, err := yaml.Marshal(v1.Lock{Version: 1, Modules: []v1.LockedModule{pin}})
+	require.NoError(t, err)
+	writeV1GenerateFixture(t, root, "protobuf.lock", string(lock))
+	_, module, err := modules.ReadManifest(remote)
+	require.NoError(t, err)
+	cache := &policyOwnershipCache{directory: remote, module: module}
+	replacements := newPolicyReplacementSources(t.Context(), root, root, func() (modules.Cache, error) { return cache, nil }, false)
+	for _, path := range []string{"fork/first.proto", "fork/second.proto"} {
+		excluded, err := replacements.isUnselectedReplacementSource(root, filepath.Join(root, path))
+		require.NoError(t, err)
+		assert.True(t, excluded, path)
+	}
+	assert.Equal(t, 1, cache.installs, "one verified graph supplies ownership for both files")
+	unchanged, err := os.ReadFile(filepath.Join(root, "protobuf.lock"))
+	require.NoError(t, err)
+	assert.Equal(t, lock, unchanged)
+}
+
+type policyOwnershipCache struct {
+	directory string
+	module    v1.Module
+	installs  int
+}
+
+func (c *policyOwnershipCache) Install(context.Context, v1.Lock) error {
+	c.installs++
+	return nil
+}
+
+func (c *policyOwnershipCache) Cached(v1.LockedModule) (string, v1.Module, error) {
+	return c.directory, c.module, nil
+}
+
+func TestFrozenReplacementOwnershipRejectsBeforeAcquisition(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, "protobuf.mod", "module example.com/client\nroots api\nreplace example.com/unused => ./api\n")
+	writeV1GenerateFixture(t, root, "api/item.proto", "syntax = \"proto3\";\n")
+	replacements := newPolicyReplacementSources(t.Context(), root, root, func() (modules.Cache, error) {
+		t.Fatal("frozen replacement rejection acquired a cache")
+		return nil, nil
+	}, true)
+	excluded, err := replacements.isUnselectedReplacementSource(root, filepath.Join(root, "api/item.proto"))
+	require.ErrorContains(t, err, "frozen mode rejects replace")
+	assert.False(t, excluded)
+}
+
+func TestFindPolicyModule(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name          string
+		manifest      string
+		wantDirectory string
+	}{
+		{name: "no module"},
+		{name: "repository module", manifest: "protobuf.mod", wantDirectory: "."},
+		{name: "nearest module", manifest: "api/protobuf.mod", wantDirectory: "api"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			if tt.manifest != "" {
+				writeV1GenerateFixture(t, root, tt.manifest, "module example.com/root\n")
+			}
+			want := ""
+			if tt.wantDirectory != "" {
+				want = filepath.Join(root, tt.wantDirectory)
+			}
+
+			moduleDir, err := findV1PolicyModuleDir(root, filepath.Join(root, "api", "proto"))
+
+			require.NoError(t, err)
+			assert.Equal(t, want, moduleDir)
+		})
+	}
+}
+
+func TestUnselectedReplacementSources(t *testing.T) {
+	t.Parallel()
+	const consumer = "module example.com/client\nrequire example.com/dep\nreplace example.com/dep => ./fork\n"
+	tests := []struct {
+		name          string
+		scanPath      string
+		sourcePath    string
+		files         map[string]string
+		wantExcluded  bool
+		errorContains string
+	}{
+		{
+			name: "replacement without manifest", scanPath: ".", sourcePath: "fork/api/item.proto",
+			files: map[string]string{"protobuf.mod": consumer}, wantExcluded: true,
+		},
+		{
+			name: "legacy replacement manifest", scanPath: ".", sourcePath: "fork/item.proto",
+			files: map[string]string{"protobuf.mod": consumer, "fork/protobuf.mod": "direct (\n)\n"}, wantExcluded: true,
+		},
+		{
+			name: "nested native replacement module", scanPath: ".", sourcePath: "fork/nested/item.proto",
+			files: map[string]string{
+				"protobuf.mod":             consumer,
+				"fork/protobuf.mod":        "module example.com/dep\n",
+				"fork/nested/protobuf.mod": "module example.com/nested\n",
+			}, wantExcluded: true,
+		},
+		{
+			name: "explicit replacement directory", scanPath: "fork", sourcePath: "fork/api/item.proto",
+			files: map[string]string{"protobuf.mod": consumer},
+		},
+		{
+			name: "explicit replacement file", scanPath: "fork/api/item.proto", sourcePath: "fork/api/item.proto",
+			files: map[string]string{"protobuf.mod": consumer},
+		},
+		{
+			name: "explicit replacement subtree", scanPath: "fork/api", sourcePath: "fork/api/item.proto",
+			files: map[string]string{"protobuf.mod": consumer},
+		},
+		{
+			name: "similar sibling directory", scanPath: ".", sourcePath: "fork-other/item.proto",
+			files: map[string]string{"protobuf.mod": "module example.com/client\nreplace example.com/unused => ./fork\n"},
+		},
+		{
+			name: "independent workspace module", scanPath: ".", sourcePath: "other/item.proto",
+			files: map[string]string{"protobuf.mod": "module example.com/client\nreplace example.com/unused => ./fork\n", "other/protobuf.mod": "module example.com/other\n"},
+		},
+		{
+			name: "selected independent module does not resolve parent graph", scanPath: "other", sourcePath: "other/item.proto",
+			files: map[string]string{
+				"protobuf.mod":       "module example.com/client\nrequire example.com/missing\nreplace example.com/missing => ./absent\n",
+				"other/protobuf.mod": "module example.com/other\n",
+			},
+		},
+		{
+			name: "explicit replacement ignores unrelated parent graph", scanPath: "fork", sourcePath: "fork/item.proto",
+			files: map[string]string{
+				"protobuf.mod":      "module example.com/client\nrequire example.com/missing\nreplace example.com/missing => ./absent\nreplace example.com/dep => ./fork\n",
+				"fork/protobuf.mod": "module example.com/dep\n",
+			},
+		},
+		{
+			name: "selected replacement has its own replacement", scanPath: "fork", sourcePath: "fork/nested/item.proto",
+			files: map[string]string{
+				"protobuf.mod":      "module example.com/client\nreplace example.com/dep => ./fork\n",
+				"fork/protobuf.mod": "module example.com/dep\nrequire example.com/nested\nreplace example.com/nested => ./nested\n",
+			},
+			wantExcluded: true,
+		},
+		{
+			name: "unused replacement overlaps consumer sources", scanPath: ".", sourcePath: "api/item.proto",
+			files: map[string]string{"protobuf.mod": "module example.com/client\nroots api\nreplace example.com/unused => ./api\n"},
+		},
+		{
+			name: "unused replacement metadata is not opened", scanPath: ".", sourcePath: "fork/item.proto",
+			files: map[string]string{
+				"protobuf.mod":      "module example.com/client\nreplace example.com/unused => ./fork\n",
+				"fork/protobuf.mod": "legacy metadata\n",
+			},
+		},
+		{
+			name: "transitively required replacement", scanPath: ".", sourcePath: "nested/item.proto",
+			files: map[string]string{
+				"protobuf.mod":      consumer + "replace example.com/nested => ./nested\n",
+				"fork/protobuf.mod": "module example.com/dep\nrequire example.com/nested\n",
+			},
+			wantExcluded: true,
+		},
+		{
+			name: "no consuming module", scanPath: ".", sourcePath: "fork/item.proto",
+		},
+		{
+			name: "invalid consuming manifest", scanPath: ".", sourcePath: "api/item.proto",
+			files: map[string]string{"protobuf.mod": "module example.com/client\nroots ../outside\n"}, errorContains: "ParseModule",
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			for path, content := range tt.files {
+				writeV1GenerateFixture(t, root, path, content)
+			}
+			writeV1GenerateFixture(t, root, tt.sourcePath, "syntax = \"proto3\";\n")
+
+			replacements := newPolicyReplacementSources(t.Context(), root, root, nil, false)
+			excluded, err := replacements.isUnselectedReplacementSource(filepath.Join(root, tt.scanPath), filepath.Join(root, tt.sourcePath))
+
+			if tt.errorContains != "" {
+				require.ErrorContains(t, err, tt.errorContains)
+				assert.False(t, excluded)
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, tt.wantExcluded, excluded)
+		})
+	}
+}
+
+func TestPolicyPathContains(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name      string
+		directory string
+		path      string
+		want      bool
+	}{
+		{name: "exact directory", directory: "fork", path: "fork", want: true},
+		{name: "source file", directory: "fork", path: "fork/item.proto", want: true},
+		{name: "file is not a directory", directory: "fork/item.proto", path: "fork/item.proto"},
+		{name: "similar sibling", directory: "fork", path: "fork-other/item.proto"},
+		{name: "aliased directory", directory: "alias", path: "fork/item.proto", want: true},
+		{name: "aliased source", directory: "fork", path: "alias/item.proto", want: true},
+		{name: "missing aliased source", directory: "fork", path: "alias/deleted/item.proto", want: true},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeV1GenerateFixture(t, root, "fork/item.proto", "syntax = \"proto3\";\n")
+			require.NoError(t, os.Symlink(filepath.Join(root, "fork"), filepath.Join(root, "alias")))
+
+			contains, err := policyPathContains(filepath.Join(root, tt.directory), filepath.Join(root, tt.path))
+
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, contains)
+		})
+	}
+}
diff --git a/internal/api/policy_sources.go b/internal/api/policy_sources.go
new file mode 100644
index 00000000..c0db76d8
--- /dev/null
+++ b/internal/api/policy_sources.go
@@ -0,0 +1,23 @@
+package api
+
+import (
+	"path/filepath"
+	"strings"
+
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+// policySourceExcluded distinguishes checked sources from storage and Git metadata.
+// Exclusion happens before configuration discovery; imports remain independently resolved.
+func policySourceExcluded(root, path string) bool {
+	relative, err := filepath.Rel(root, path)
+	if err != nil || !filepath.IsLocal(relative) {
+		return false
+	}
+	for _, part := range strings.Split(filepath.ToSlash(relative), "/") {
+		if part != "." && (part == modules.VendorDir || strings.HasPrefix(part, ".")) {
+			return true
+		}
+	}
+	return false
+}
diff --git a/internal/api/policy_sources_test.go b/internal/api/policy_sources_test.go
new file mode 100644
index 00000000..ee1497e1
--- /dev/null
+++ b/internal/api/policy_sources_test.go
@@ -0,0 +1,38 @@
+package api
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestPolicySourceExclusions(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	tests := []struct {
+		name, path string
+		excluded   bool
+	}{
+		{"vendor root", "easyp_vendor", true}, {"nested vendor", "module/easyp_vendor/item.proto", true},
+		{"similar name", "easyp_vendor_backup/item.proto", false}, {"hidden storage", ".cache/mod/item.proto", true},
+		{"normal source", "proto/item.proto", false}, {"root", ".", false},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			assert.Equal(t, tt.excluded, policySourceExcluded(root, filepath.Join(root, tt.path)))
+		})
+	}
+}
+
+func TestCLIDoesNotPublishRemovedDocumentation(t *testing.T) {
+	t.Parallel()
+	_, err := os.Stat(filepath.Join("..", "..", ".github", "workflows", "docs.yml"))
+	require.ErrorIs(t, err, os.ErrNotExist)
+	raw, err := os.ReadFile(filepath.Join("..", "..", ".github", "workflows", "release.yml"))
+	require.NoError(t, err)
+	assert.NotContains(t, string(raw), "cd docs")
+}
diff --git a/internal/api/policy_v1.go b/internal/api/policy_v1.go
new file mode 100644
index 00000000..4702c10c
--- /dev/null
+++ b/internal/api/policy_v1.go
@@ -0,0 +1,64 @@
+package api
+
+import (
+	"bytes"
+	"fmt"
+	"os"
+	"path/filepath"
+
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+type v1PolicyFile struct {
+	policy   v1.Policy
+	sections map[string]yaml.Node
+	presence v1.PolicyPresence
+}
+
+func readV1PolicyFile(path string) (v1PolicyFile, bool, error) {
+	raw, found, err := readOptionalFile(path)
+	if err != nil {
+		return v1PolicyFile{}, false, fmt.Errorf("readOptionalFile: %w", err)
+	}
+	if !found {
+		return v1PolicyFile{}, false, nil
+	}
+	policy, err := v1.ParsePolicy(bytes.NewReader(raw))
+	if err != nil {
+		return v1PolicyFile{}, true, fmt.Errorf("ParsePolicy: %w", &os.PathError{Op: "parse", Path: path, Err: err})
+	}
+	var sections map[string]yaml.Node
+	if err := yaml.Unmarshal(raw, &sections); err != nil {
+		return v1PolicyFile{}, true, fmt.Errorf("Unmarshal: %w", err)
+	}
+	presence, err := v1.ParsePolicyPresence(raw)
+	if err != nil {
+		return v1PolicyFile{}, true, fmt.Errorf("ParsePolicyPresence: %w", err)
+	}
+	return v1PolicyFile{policy: policy, sections: sections, presence: presence}, true, nil
+}
+
+func (file v1PolicyFile) has(section string) bool {
+	_, exists := file.sections[section]
+	return exists
+}
+
+func v1PolicyPath(directory, projectRoot, configPath string) string {
+	if directory == projectRoot {
+		return configPath
+	}
+	return filepath.Join(directory, v1.PolicyFile)
+}
+
+// ancestorDirs includes start and stops at root or the filesystem root.
+func ancestorDirs(start, root string) []string {
+	var directories []string
+	for directory := start; ; directory = filepath.Dir(directory) {
+		directories = append(directories, directory)
+		if directory == root || directory == filepath.Dir(directory) {
+			return directories
+		}
+	}
+}
diff --git a/internal/api/policy_v1_test.go b/internal/api/policy_v1_test.go
new file mode 100644
index 00000000..7e0a4ef5
--- /dev/null
+++ b/internal/api/policy_v1_test.go
@@ -0,0 +1,56 @@
+package api
+
+import (
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestResolveV1LintPolicyInheritsSectionsIndependently(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name          string
+		childPolicy   string
+		wantDefault   string
+		wantRuleCount int
+		wantSources   v1LintPolicySources
+	}{
+		{
+			name:          "replace_linters_inherit_issues",
+			childPolicy:   "version: v1\nlinters:\n  default: MINIMAL\n",
+			wantDefault:   "MINIMAL",
+			wantRuleCount: 1,
+			wantSources:   v1LintPolicySources{linters: "nested/easyp.yaml", issues: "custom.yaml"},
+		},
+		{
+			name:          "inherit_linters_clear_issues",
+			childPolicy:   "version: v1\nissues: {}\n",
+			wantDefault:   "STANDARD",
+			wantRuleCount: 0,
+			wantSources:   v1LintPolicySources{linters: "custom.yaml", issues: "nested/easyp.yaml"},
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			child := filepath.Join(root, "nested")
+			writeV1GenerateFixture(t, root, "custom.yaml", "version: v1\nlinters:\n  default: STANDARD\nissues:\n  exclude-rules:\n    - path: generated\n")
+			writeV1GenerateFixture(t, child, "easyp.yaml", tt.childPolicy)
+
+			policy, sources, err := resolveV1LintPolicy(child, root, filepath.Join(root, "custom.yaml"))
+
+			require.NoError(t, err)
+			assert.Equal(t, tt.wantDefault, policy.Linters.Default)
+			assert.Len(t, policy.Issues.ExcludeRules, tt.wantRuleCount)
+			assert.Equal(t, filepath.Join(root, tt.wantSources.linters), sources.linters)
+			assert.Equal(t, filepath.Join(root, tt.wantSources.issues), sources.issues)
+			assert.Empty(t, sources.settings)
+		})
+	}
+}
diff --git a/internal/api/policy_validate.go b/internal/api/policy_validate.go
new file mode 100644
index 00000000..f33e71e2
--- /dev/null
+++ b/internal/api/policy_validate.go
@@ -0,0 +1,150 @@
+package api
+
+import (
+	"context"
+	"fmt"
+	"maps"
+	"os"
+	"path/filepath"
+	"slices"
+
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/adapters/gitmodules"
+	"github.com/easyp-tech/easyp/internal/config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/flags"
+	"github.com/easyp-tech/easyp/internal/modules"
+	policyresolver "github.com/easyp-tech/easyp/internal/policy"
+	"github.com/easyp-tech/easyp/internal/workspace"
+)
+
+type policyReadCache struct{ *gitmodules.Cache }
+
+// Expose only cached verification during discovery, without the repository's
+// version resolver promoted through policyReadCache's embedded Git cache.
+type policyDiscoveryCache struct{ modules.Cache }
+
+func (c policyReadCache) Install(ctx context.Context, lock v1.Lock) error {
+	return c.VerifyCached(ctx, lock)
+}
+
+func policyReferenceValidator(ctx *cli.Context) func(string) ([]config.ValidationIssue, error) {
+	return func(path string) ([]config.ValidationIssue, error) {
+		switch filepath.Base(path) {
+		case v1.GenerateFile, v1.ModuleFile, v1.LockFile:
+			return nil, nil
+		}
+		file, found, err := readV1PolicyFile(path)
+		if err != nil {
+			return nil, err
+		}
+		if !found || (file.policy.Linters.Extends == "" && file.policy.Breaking.Extends == "") {
+			return nil, nil
+		}
+		boundary, err := workspace.Boundary(filepath.Dir(path))
+		if err != nil {
+			return nil, err
+		}
+		moduleDir, err := findV1PolicyModuleDir(boundary, filepath.Dir(path))
+		if err != nil {
+			return nil, err
+		}
+		resolver := policyresolver.NewResolver(boundary, func(graphCtx context.Context, dir string) (modules.PolicyGraph, error) {
+			cache, err := moduleCache(ctx)
+			if err != nil {
+				return nil, err
+			}
+			return modules.ResolvePolicyGraph(graphCtx, dir, policyReadCache{cache}, flags.IsFrozen(ctx))
+		})
+		var issues []config.ValidationIssue
+		add := func(section string, err error) {
+			if err == nil {
+				return
+			}
+			issue := config.ValidationIssue{Code: "policy_extends", Message: fmt.Sprintf("%s.extends: %v", section, err), Severity: config.SeverityError}
+			if node, ok := file.sections[section]; ok {
+				issue.Line, issue.Column = node.Line, node.Column
+				for i := 0; i+1 < len(node.Content); i += 2 {
+					if node.Content[i].Value == "extends" {
+						issue.Line, issue.Column = node.Content[i+1].Line, node.Content[i+1].Column
+						break
+					}
+				}
+			}
+			issues = append(issues, issue)
+		}
+		contexts := []string{moduleDir}
+		if moduleDir == "" {
+			relative, err := filepath.Rel(boundary, filepath.Dir(path))
+			if err != nil {
+				return nil, err
+			}
+			replacements := newPolicyReplacementSources(ctx.Context, boundary, boundary, func() (modules.Cache, error) {
+				cache, err := moduleCache(ctx)
+				if err != nil {
+					return nil, fmt.Errorf("moduleCache: %w", err)
+				}
+				return policyDiscoveryCache{policyReadCache{cache}}, nil
+			}, flags.IsFrozen(ctx))
+			scopes, scanErr := selectedPolicyScopes(replacements, relative, true)
+			if scanErr == nil {
+				var modules []string
+				for _, name := range slices.Sorted(maps.Keys(scopes)) {
+					if directory := policyDirectoryForReference(boundary, name); directory != "" {
+						modules = append(modules, directory)
+					}
+				}
+				if len(modules) > 0 {
+					contexts = modules
+				}
+			}
+		}
+		for _, consumer := range contexts {
+			lintApplies, breakingApplies := true, true
+			if moduleDir == "" && consumer != "" {
+				_, sources, _, _, err := resolveV1LintPolicyDetailed(consumer, filepath.Dir(path), path)
+				if err != nil {
+					return nil, err
+				}
+				lintApplies = sources.linters == path
+				_, owner, err := resolveV1BreakingPolicy(consumer, filepath.Dir(path), path)
+				if err != nil {
+					return nil, err
+				}
+				breakingApplies = owner == path
+			}
+			if lintApplies && file.policy.Linters.Extends != "" {
+				result, err := resolver.ResolveLint(ctx.Context, policyresolver.LintInput{PolicyPath: path, Policy: file.policy, Presence: file.presence, SettingsPath: path, Settings: file.policy.LinterSettings, SettingsSource: file.presence, ModuleDir: consumer})
+				if err == nil {
+					_, err = result.Policy.LintConfig()
+				}
+				if err != nil && consumer != "" {
+					err = fmt.Errorf("consumer %s: %w", consumer, err)
+				}
+				add("linters", err)
+			}
+			if breakingApplies && file.policy.Breaking.Extends != "" {
+				result, err := resolver.ResolveBreaking(ctx.Context, policyresolver.BreakingInput{PolicyPath: path, Policy: file.policy, Presence: file.presence, ModuleDir: consumer})
+				if err == nil {
+					_, err = result.Policy.BreakingConfig("")
+				}
+				if err != nil && consumer != "" {
+					err = fmt.Errorf("consumer %s: %w", consumer, err)
+				}
+				add("breaking", err)
+			}
+		}
+		return issues, nil
+	}
+}
+
+// policyDirectoryForReference keeps discovery of absent/deleted source scopes
+// separate from dependency resolution. Only real manifests supply a graph.
+func policyDirectoryForReference(root, relative string) string {
+	directory := filepath.Join(root, relative)
+	if info, err := os.Stat(filepath.Join(directory, v1.ModuleFile)); err == nil && info.Mode().IsRegular() {
+		return directory
+	}
+	return ""
+}
diff --git a/internal/api/roots.go b/internal/api/roots.go
new file mode 100644
index 00000000..a69b61d1
--- /dev/null
+++ b/internal/api/roots.go
@@ -0,0 +1,55 @@
+package api
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/flags"
+	"github.com/easyp-tech/easyp/internal/workspace"
+)
+
+// resolveRoots computes configPath, projectRoot, and the operation root.
+func resolveRoots(ctx *cli.Context, rootFlagName string) (string, string, string, error) {
+	workingDir, err := os.Getwd()
+	if err != nil {
+		return "", "", "", fmt.Errorf("Getwd: %w", err)
+	}
+
+	root := ctx.String(rootFlagName)
+	configPath := ctx.String(flags.Config.Name)
+	if !ctx.IsSet(flags.Config.Name) {
+		lookupDir := workingDir
+		if root != "" {
+			lookupDir = root
+			if !filepath.IsAbs(lookupDir) {
+				lookupDir = filepath.Join(workingDir, lookupDir)
+			}
+		}
+		configPath, err = workspace.Policy(lookupDir)
+		if err != nil {
+			return "", "", "", fmt.Errorf("Policy: %w", err)
+		}
+	}
+	if !filepath.IsAbs(configPath) {
+		configPath = filepath.Join(workingDir, configPath)
+	}
+	projectRoot := filepath.Dir(configPath)
+
+	opRoot := projectRoot
+	if root != "" {
+		opRoot = root
+		if !filepath.IsAbs(root) {
+			opRoot = filepath.Join(workingDir, root)
+		}
+	}
+
+	opRoot, err = filepath.Abs(opRoot)
+	if err != nil {
+		return "", "", "", fmt.Errorf("Abs: %w", err)
+	}
+
+	return configPath, projectRoot, opRoot, nil
+}
diff --git a/internal/api/runtime.go b/internal/api/runtime.go
new file mode 100644
index 00000000..c7e92d55
--- /dev/null
+++ b/internal/api/runtime.go
@@ -0,0 +1,87 @@
+package api
+
+import (
+	"context"
+	"fmt"
+	"log/slog"
+	"os"
+	"path/filepath"
+	"slices"
+
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/adapters/go_git"
+	"github.com/easyp-tech/easyp/internal/config"
+	"github.com/easyp-tech/easyp/internal/core"
+	"github.com/easyp-tech/easyp/internal/logger"
+	"github.com/easyp-tech/easyp/internal/modules"
+	"github.com/easyp-tech/easyp/internal/rules"
+)
+
+// getLogger extracts the logger.Logger from CLI context metadata.
+// Falls back to a no-op logger if not found.
+func getLogger(ctx *cli.Context) logger.Logger {
+	if l, ok := ctx.App.Metadata["logger"].(logger.Logger); ok {
+		return l
+	}
+	return logger.NewNop()
+}
+
+const (
+	envEasypPath     = "EASYPPATH"
+	defaultEasypPath = ".easyp"
+	defaultVendorDir = "easyp_vendor"
+)
+
+func errExit(log logger.Logger, code int, msg string, attrs ...slog.Attr) {
+	log.Error(context.Background(), msg, attrs...)
+	os.Exit(code)
+}
+
+// getEasypPath return path for cache, modules storage
+func getEasypPath(log logger.Logger) (string, error) {
+	easypPath := os.Getenv(envEasypPath)
+	if easypPath == "" {
+		userHomeDir, err := os.UserHomeDir()
+		if err != nil {
+			return "", fmt.Errorf("UserHomeDir: %w", err)
+		}
+		easypPath = filepath.Join(userHomeDir, defaultEasypPath)
+	}
+
+	easypPath, err := filepath.Abs(easypPath)
+	if err != nil {
+		return "", fmt.Errorf("Abs: %w", err)
+	}
+
+	log.Debug(context.Background(), "Use storage", slog.String("path", easypPath))
+
+	return easypPath, nil
+}
+
+func buildCore(log logger.Logger, cfg config.Config, importRoots modules.SourceRoots) (*core.Core, error) {
+
+	lintRules, ignoreOnly, err := rules.New(cfg.Lint)
+	if err != nil {
+		return nil, fmt.Errorf("New: %w", err)
+	}
+
+	return core.New(core.Options{
+		Rules:                   lintRules,
+		Ignore:                  append(append([]string(nil), cfg.Lint.Ignore...), defaultVendorDir),
+		IgnoreOnly:              ignoreOnly,
+		AllowCommentIgnores:     cfg.Lint.AllowCommentIgnores,
+		KnownLintRules:          rules.AllRuleNames(),
+		Logger:                  log,
+		ImportRoots:             importRoots.Paths(),
+		ImportFileAllowed:       importRoots.FileAllowed(),
+		CurrentProjectGitWalker: go_git.New(),
+		BreakingCheckConfig: core.BreakingCheckConfig{
+			IgnoreDirs:     append(append([]string(nil), cfg.BreakingCheck.Ignore...), defaultVendorDir),
+			AgainstGitRef:  cfg.BreakingCheck.AgainstGitRef,
+			FilesCheck:     slices.Contains(cfg.BreakingCheck.Use, core.BreakingCheckFilesCheck),
+			Categories:     cfg.BreakingCheck.Categories,
+			IgnoreUnstable: cfg.BreakingCheck.IgnoreUnstable,
+		},
+	}), nil
+}
diff --git a/internal/api/schema_gen.go b/internal/api/schema_gen.go
index b91b847e..1ffb10d8 100644
--- a/internal/api/schema_gen.go
+++ b/internal/api/schema_gen.go
@@ -8,49 +8,31 @@ import (
 	"github.com/easyp-tech/easyp/internal/schemagen"
 )
 
-var _ Handler = (*SchemaGen)(nil)
-
+// SchemaGen writes JSON Schemas for the v1 YAML documents.
 type SchemaGen struct{}
 
-var (
-	flagSchemaGenOutVersioned = &cli.StringFlag{
-		Name:       "out-versioned",
-		Usage:      "path to versioned schema file",
-		Required:   false,
-		HasBeenSet: true,
-		Value:      schemagen.DefaultVersionedOut,
-	}
+var _ Handler = (*SchemaGen)(nil)
 
-	flagSchemaGenOutLatest = &cli.StringFlag{
-		Name:       "out-latest",
-		Usage:      "path to latest schema alias file",
-		Required:   false,
-		HasBeenSet: true,
-		Value:      schemagen.DefaultLatestOut,
-	}
-)
+var flagSchemaGenOutDir = &cli.StringFlag{
+	Name:  "out-dir",
+	Usage: "directory for generated v1 JSON Schemas",
+	Value: schemagen.DefaultOutDir,
+}
 
+// Command implements Handler.
 func (s SchemaGen) Command() *cli.Command {
 	return &cli.Command{
-		Name:        "schema-gen",
-		Usage:       "generate easyp config JSON Schema artifacts",
-		UsageText:   "schema-gen [--out-versioned path] [--out-latest path]",
-		Description: "generate versioned and latest easyp config JSON Schema artifacts",
-		Action:      s.Action,
-		Flags: []cli.Flag{
-			flagSchemaGenOutVersioned,
-			flagSchemaGenOutLatest,
-		},
+		Name:   "schema-gen",
+		Usage:  "generate JSON Schemas for v1 YAML files",
+		Action: s.Action,
+		Flags:  []cli.Flag{flagSchemaGenOutDir},
 	}
 }
 
+// Action implements Handler.
 func (s SchemaGen) Action(ctx *cli.Context) error {
-	if err := schemagen.Run(schemagen.Options{
-		VersionedOut: ctx.String(flagSchemaGenOutVersioned.Name),
-		LatestOut:    ctx.String(flagSchemaGenOutLatest.Name),
-	}); err != nil {
-		return fmt.Errorf("schemagen.Run: %w", err)
+	if err := schemagen.Run(schemagen.Options{OutDir: ctx.String(flagSchemaGenOutDir.Name)}); err != nil {
+		return fmt.Errorf("Run: %w", err)
 	}
-
 	return nil
 }
diff --git a/internal/api/temporaly_helper.go b/internal/api/temporaly_helper.go
deleted file mode 100644
index 2fb47000..00000000
--- a/internal/api/temporaly_helper.go
+++ /dev/null
@@ -1,216 +0,0 @@
-package api
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"log/slog"
-	"os"
-	"path/filepath"
-	"slices"
-	"strings"
-
-	"github.com/samber/lo"
-	"github.com/urfave/cli/v2"
-
-	"github.com/easyp-tech/easyp/internal/adapters/console"
-	"github.com/easyp-tech/easyp/internal/adapters/go_git"
-	lockfile "github.com/easyp-tech/easyp/internal/adapters/lock_file"
-	moduleconfig "github.com/easyp-tech/easyp/internal/adapters/module_config"
-	"github.com/easyp-tech/easyp/internal/adapters/storage"
-	"github.com/easyp-tech/easyp/internal/config"
-	"github.com/easyp-tech/easyp/internal/core"
-	"github.com/easyp-tech/easyp/internal/logger"
-	"github.com/easyp-tech/easyp/internal/rules"
-)
-
-// getLogger extracts the logger.Logger from CLI context metadata.
-// Falls back to a no-op logger if not found.
-func getLogger(ctx *cli.Context) logger.Logger {
-	if l, ok := ctx.App.Metadata["logger"].(logger.Logger); ok {
-		return l
-	}
-	return logger.NewNop()
-}
-
-var (
-	ErrPathNotAbsolute = errors.New("path is not absolute")
-)
-
-const (
-	envEasypPath     = "EASYPPATH"
-	defaultEasypPath = ".easyp"
-	defaultVendorDir = "easyp_vendor"
-)
-
-func errExit(log logger.Logger, code int, msg string, attrs ...slog.Attr) {
-	log.Error(context.Background(), msg, attrs...)
-	os.Exit(code)
-}
-
-// getEasypPath return path for cache, modules storage
-func getEasypPath(log logger.Logger) (string, error) {
-	easypPath := os.Getenv(envEasypPath)
-	if easypPath == "" {
-		userHomeDir, err := os.UserHomeDir()
-		if err != nil {
-			return "", fmt.Errorf("os.UserHomeDir: %w", err)
-		}
-		easypPath = filepath.Join(userHomeDir, defaultEasypPath)
-	}
-
-	easypPath, err := filepath.Abs(easypPath)
-	if err != nil {
-		return "", ErrPathNotAbsolute
-	}
-
-	log.Debug(context.Background(), "Use storage", slog.String("path", easypPath))
-
-	return easypPath, nil
-}
-
-func buildCore(_ context.Context, log logger.Logger, cfg config.Config, dirWalker core.DirWalker) (*core.Core, error) {
-	vendorPath := defaultVendorDir // TODO: read from config
-
-	// Centralized: set once for all commands (lint, breaking, generate, mod).
-	core.SetAllowCommentIgnores(cfg.Lint.AllowCommentIgnores)
-
-	lintRules, ignoreOnly, err := rules.New(cfg.Lint)
-	if err != nil {
-		return nil, fmt.Errorf("cfg.BuildLinterRules: %w", err)
-	}
-
-	lockFile, err := lockfile.New(dirWalker)
-	if err != nil {
-		return nil, fmt.Errorf("lockfile.New: %w", err)
-	}
-
-	easypPath, err := getEasypPath(log)
-	if err != nil {
-		return nil, fmt.Errorf("getEasypPath: %w", err)
-	}
-
-	store := storage.New(easypPath, lockFile, log)
-
-	moduleCfg := moduleconfig.New(log)
-
-	currentProjectGitWalker := go_git.New()
-
-	// always ignore vendor dir for linter and breakinf check
-	linterIgnoreDirs := append(cfg.Lint.Ignore, vendorPath)
-	breakingCheckIgnoreDirs := append(cfg.BreakingCheck.Ignore, vendorPath)
-
-	filesCheck := slices.Contains(cfg.BreakingCheck.Use, core.BreakingCheckFilesCheck)
-
-	breakingCheckConfig := core.BreakingCheckConfig{
-		IgnoreDirs:    breakingCheckIgnoreDirs,
-		AgainstGitRef: cfg.BreakingCheck.AgainstGitRef,
-		FilesCheck:    filesCheck,
-	}
-
-	// Convert managed mode configuration
-	managedMode := convertManagedModeConfig(cfg.Generate.Managed)
-
-	// collect all deps: from deps, from generate sections
-	deps := append([]string{}, cfg.Deps...)
-	deps = append(deps, getDepsFromGenerateDeps(cfg.Generate)...)
-	deps = lo.Uniq(deps)
-
-	app := core.New(
-		lintRules,
-		linterIgnoreDirs,
-		deps,
-		ignoreOnly,
-		log,
-		lo.Map(cfg.Generate.Plugins, func(p config.Plugin, _ int) core.Plugin {
-			return core.Plugin{
-				Source: core.PluginSource{
-					Name:    p.Name,
-					Remote:  p.Remote,
-					Path:    p.Path,
-					Command: p.Command,
-				},
-				Out:         p.Out,
-				Options:     p.Opts,
-				WithImports: p.WithImports,
-			}
-		}),
-		core.Inputs{
-			InputGitRepos: lo.Filter(lo.Map(cfg.Generate.Inputs, func(i config.Input, _ int) core.InputGitRepo {
-				return core.InputGitRepo{
-					URL:          i.GitRepo.URL,
-					SubDirectory: i.GitRepo.SubDirectory,
-					Root:         i.GitRepo.Root,
-				}
-			}), func(i core.InputGitRepo, _ int) bool {
-				return i.URL != ""
-			}),
-			InputFilesDir: lo.Filter(lo.Map(cfg.Generate.Inputs, func(i config.Input, _ int) core.InputFilesDir {
-				return core.InputFilesDir{
-					Path: i.InputFilesDir.Path,
-					Root: i.InputFilesDir.Root,
-				}
-			}), func(i core.InputFilesDir, _ int) bool {
-				return i.Path != "" && IsExistingDir(i.Root)
-			}),
-		},
-		console.New(),
-		store,
-		moduleCfg,
-		lockFile,
-		currentProjectGitWalker,
-		breakingCheckConfig,
-		managedMode,
-		vendorPath, // vendorDir
-	)
-
-	return app, nil
-}
-
-// convertManagedModeConfig converts config.ManagedMode to core.ManagedModeConfig.
-func convertManagedModeConfig(cfg config.ManagedMode) core.ManagedModeConfig {
-	return core.ManagedModeConfig{
-		Enabled: cfg.Enabled,
-		Disable: lo.Map(cfg.Disable, func(r config.ManagedDisableRule, _ int) core.ManagedDisableRule {
-			return core.ManagedDisableRule{
-				Module:      r.Module,
-				Package:     r.Package,
-				Path:        r.Path,
-				FileOption:  core.FileOptionType(r.FileOption),
-				FieldOption: core.FieldOptionType(r.FieldOption),
-				Field:       r.Field,
-			}
-		}),
-		Override: lo.Map(cfg.Override, func(r config.ManagedOverrideRule, _ int) core.ManagedOverrideRule {
-			return core.ManagedOverrideRule{
-				FileOption:  core.FileOptionType(r.FileOption),
-				FieldOption: core.FieldOptionType(r.FieldOption),
-				Value:       r.Value,
-				Module:      r.Module,
-				Package:     r.Package,
-				Path:        r.Path,
-				Field:       r.Field,
-			}
-		}),
-	}
-}
-
-func IsExistingDir(path string) bool {
-	if path == "" || strings.ContainsRune(path, '\x00') {
-		return false
-	}
-
-	// Очистим путь от лишнего (типа "./../")
-	cleanPath := filepath.Clean(path)
-
-	info, err := os.Stat(cleanPath)
-	if err != nil {
-		return false
-	}
-
-	if !info.IsDir() {
-		return false
-	}
-
-	return true
-}
diff --git a/internal/api/v1_fixtures_test.go b/internal/api/v1_fixtures_test.go
new file mode 100644
index 00000000..525d7b8f
--- /dev/null
+++ b/internal/api/v1_fixtures_test.go
@@ -0,0 +1,28 @@
+package api
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+func writeV1GenerateFixture(t *testing.T, root, name, content string) {
+	t.Helper()
+	path := filepath.Join(root, name)
+	err := os.MkdirAll(filepath.Dir(path), 0o755)
+	require.NoError(t, err)
+	err = os.WriteFile(path, []byte(content), 0o644)
+	require.NoError(t, err)
+}
+
+func cachedTestDir(t *testing.T, cache modules.Cache, entry v1.LockedModule) string {
+	t.Helper()
+	directory, _, err := cache.Cached(entry)
+	require.NoError(t, err)
+	return directory
+}
diff --git a/internal/api/validate.go b/internal/api/validate.go
index dc786e53..43ccf74b 100644
--- a/internal/api/validate.go
+++ b/internal/api/validate.go
@@ -3,6 +3,7 @@ package api
 import (
 	"encoding/json"
 	"fmt"
+	"io"
 	"os"
 	"path/filepath"
 	"text/tabwriter"
@@ -10,20 +11,24 @@ import (
 	"github.com/urfave/cli/v2"
 
 	"github.com/easyp-tech/easyp/internal/config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
 	"github.com/easyp-tech/easyp/internal/flags"
 )
 
+// Validate handles recursive configuration validation.
 type Validate struct{}
 
+// Command implements Handler.
 func (v Validate) Command() *cli.Command {
 	return &cli.Command{
 		Name:        "validate-config",
 		Aliases:     []string{"validate"},
-		Usage:       "validate easyp config file",
-		Description: "validate easyp.yaml for syntax and required fields",
-		UsageText:   "validate-config [--config path] [--format json|text]",
+		Usage:       "validate EasyP configuration files",
+		Description: "recursively validate v1 EasyP files in the current directory or a selected path",
+		UsageText:   "validate-config [--config file-or-directory] [--format json|text]",
 		Flags: []cli.Flag{
 			flags.Config,
+			flags.Format,
 		},
 		Action: v.Action,
 	}
@@ -35,86 +40,105 @@ type validateResult struct {
 	Warnings []config.ValidationIssue `json:"warnings,omitempty"`
 }
 
+// Action implements Handler.
 func (v Validate) Action(ctx *cli.Context) error {
-	configPath := ctx.String(flags.Config.Name)
+	configPath := validationTarget(ctx)
 	if !filepath.IsAbs(configPath) {
 		wd, err := os.Getwd()
 		if err != nil {
-			return fmt.Errorf("os.Getwd: %w", err)
+			return fmt.Errorf("Getwd: %w", err)
 		}
 		configPath = filepath.Join(wd, configPath)
 	}
 
-	if _, err := os.Stat(configPath); err != nil {
-		return fmt.Errorf("config not found: %w", err)
-	}
-
-	issues, err := config.ValidateFile(configPath)
+	issues, err := v1.ValidatePathWith(configPath, policyReferenceValidator(ctx))
 	if err != nil {
-		return fmt.Errorf("validate config: %w", err)
+		return fmt.Errorf("ValidatePath: %w", err)
 	}
 
-	// Separate errors from warnings - only errors cause validation failure
-	var errors, warnings []config.ValidationIssue
+	var report validateResult
 	for _, issue := range issues {
 		if issue.Severity == config.SeverityError {
-			errors = append(errors, issue)
-		} else {
-			warnings = append(warnings, issue)
+			report.Errors = append(report.Errors, issue)
+			continue
 		}
+		report.Warnings = append(report.Warnings, issue)
 	}
+	report.Valid = len(report.Errors) == 0
 
-	result := validateResult{
-		Valid:    !config.HasErrors(issues),
-		Errors:   errors,
-		Warnings: warnings,
+	output := ctx.App.Writer
+	if output == nil {
+		output = os.Stdout
 	}
-
 	format := flags.GetFormat(ctx, flags.JSONFormat)
 	switch format {
 	case flags.JSONFormat:
-		enc := json.NewEncoder(os.Stdout)
+		enc := json.NewEncoder(output)
 		enc.SetIndent("", "  ")
-		if err := enc.Encode(result); err != nil {
-			return fmt.Errorf("json.Encode: %w", err)
+		if err := enc.Encode(report); err != nil {
+			return fmt.Errorf("Encode: %w", err)
 		}
 	case flags.TextFormat:
-		printValidateText(result)
+		if err := writeValidationText(output, report); err != nil {
+			return fmt.Errorf("writeValidationText: %w", err)
+		}
 	default:
 		return fmt.Errorf("unsupported format: %s", format)
 	}
 
-	if result.Valid {
-		return nil
+	if !report.Valid {
+		return ErrHasValidateIssue
 	}
+	return nil
+}
 
-	return ErrHasValidateIssue
+func validationTarget(ctx *cli.Context) string {
+	for _, scope := range ctx.Lineage() {
+		if scope.IsSet(flags.Config.Name) {
+			return scope.String(flags.Config.Name)
+		}
+	}
+	return "."
 }
 
-func printValidateText(res validateResult) {
-	if res.Valid {
-		fmt.Println("VALID: true")
-	} else {
-		fmt.Println("VALID: false")
+func writeValidationText(output io.Writer, report validateResult) error {
+	if _, err := fmt.Fprintf(output, "VALID: %t\n", report.Valid); err != nil {
+		return fmt.Errorf("Fprintf: %w", err)
 	}
 
-	w := tabwriter.NewWriter(os.Stdout, 0, 4, 2, ' ', 0)
+	w := tabwriter.NewWriter(output, 0, 4, 2, ' ', 0)
 
-	if len(res.Errors) > 0 {
-		fmt.Fprintln(w, "ERRORS:")
-		fmt.Fprintln(w, "  #\tCODE\tMESSAGE")
-		for i, e := range res.Errors {
-			fmt.Fprintf(w, "  %d\t%s\t%s\n", i+1, e.Code, e.Message)
+	if len(report.Errors) > 0 {
+		if _, err := fmt.Fprintln(w, "ERRORS:\n  #\tFILE\tLOCATION\tCODE\tMESSAGE"); err != nil {
+			return fmt.Errorf("Fprintln: %w", err)
+		}
+		for i, issue := range report.Errors {
+			if _, err := fmt.Fprintf(w, "  %d\t%s\t%s\t%s\t%s\n", i+1, issue.File, validationLocation(issue), issue.Code, issue.Message); err != nil {
+				return fmt.Errorf("Fprintf: %w", err)
+			}
 		}
 	}
 
-	if len(res.Warnings) > 0 {
-		fmt.Fprintln(w, "WARNINGS:")
-		fmt.Fprintln(w, "  #\tCODE\tMESSAGE")
-		for i, e := range res.Warnings {
-			fmt.Fprintf(w, "  %d\t%s\t%s\n", i+1, e.Code, e.Message)
+	if len(report.Warnings) > 0 {
+		if _, err := fmt.Fprintln(w, "WARNINGS:\n  #\tFILE\tLOCATION\tCODE\tMESSAGE"); err != nil {
+			return fmt.Errorf("Fprintln: %w", err)
+		}
+		for i, issue := range report.Warnings {
+			if _, err := fmt.Fprintf(w, "  %d\t%s\t%s\t%s\t%s\n", i+1, issue.File, validationLocation(issue), issue.Code, issue.Message); err != nil {
+				return fmt.Errorf("Fprintf: %w", err)
+			}
 		}
 	}
 
-	_ = w.Flush()
+	if err := w.Flush(); err != nil {
+		return fmt.Errorf("Flush: %w", err)
+	}
+	return nil
+}
+
+func validationLocation(issue config.ValidationIssue) string {
+	if issue.Line == 0 {
+		return "-"
+	}
+	return fmt.Sprintf("%d:%d", issue.Line, issue.Column)
 }
diff --git a/internal/api/validate_test.go b/internal/api/validate_test.go
new file mode 100644
index 00000000..5291ca35
--- /dev/null
+++ b/internal/api/validate_test.go
@@ -0,0 +1,255 @@
+package api
+
+import (
+	"bytes"
+	"encoding/json"
+	"flag"
+	"io"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	"github.com/easyp-tech/easyp/internal/flags"
+)
+
+func TestValidateActionPreservesOutputErrors(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name   string
+		format string
+	}{
+		{name: "text output", format: flags.TextFormat},
+		{name: "json output", format: flags.JSONFormat},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			path := filepath.Join(root, "easyp.yaml")
+			require.NoError(t, os.WriteFile(path, []byte("version: v1\n"), 0o600))
+			output, err := os.CreateTemp(root, "output-*")
+			require.NoError(t, err)
+			require.NoError(t, output.Close())
+			ctx := validationContext(t, path, tt.format, output)
+
+			err = (Validate{}).Action(ctx)
+
+			require.ErrorIs(t, err, os.ErrClosed)
+			var pathErr *os.PathError
+			require.ErrorAs(t, err, &pathErr)
+			assert.Equal(t, output.Name(), pathErr.Path)
+		})
+	}
+}
+
+func TestValidateActionWritesText(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name            string
+		contents        string
+		expectedError   error
+		expectedHeading string
+		expectedMessage string
+	}{
+		{
+			name:            "valid policy",
+			contents:        "version: v1\n",
+			expectedHeading: "VALID: true\n",
+		},
+		{
+			name:            "invalid policy",
+			contents:        "linters:\n  unknown: true\n",
+			expectedError:   ErrHasValidateIssue,
+			expectedHeading: "VALID: false\nERRORS:\n",
+			expectedMessage: "yaml_validation",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			path := filepath.Join(t.TempDir(), "easyp.yaml")
+			require.NoError(t, os.WriteFile(path, []byte(tt.contents), 0o600))
+			var output bytes.Buffer
+			ctx := validationContext(t, path, flags.TextFormat, &output)
+
+			err := (Validate{}).Action(ctx)
+
+			require.ErrorIs(t, err, tt.expectedError)
+			assert.True(t, bytes.HasPrefix(output.Bytes(), []byte(tt.expectedHeading)), output.String())
+			if tt.expectedMessage != "" {
+				assert.Contains(t, output.String(), "easyp.yaml")
+				assert.Contains(t, output.String(), "2:3")
+				assert.Contains(t, output.String(), tt.expectedMessage)
+				return
+			}
+			assert.Equal(t, tt.expectedHeading, output.String())
+		})
+	}
+}
+
+func TestValidateActionWritesJSON(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name          string
+		contents      string
+		expectedError error
+		expectedValid bool
+	}{
+		{name: "valid policy", contents: "version: v1\n", expectedValid: true},
+		{name: "invalid policy", contents: "linters:\n  unknown: true\n", expectedError: ErrHasValidateIssue},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			path := filepath.Join(t.TempDir(), "easyp.yaml")
+			require.NoError(t, os.WriteFile(path, []byte(tt.contents), 0o600))
+			var output bytes.Buffer
+			ctx := validationContext(t, path, flags.JSONFormat, &output)
+
+			err := (Validate{}).Action(ctx)
+
+			require.ErrorIs(t, err, tt.expectedError)
+			var report validateResult
+			require.NoError(t, json.Unmarshal(output.Bytes(), &report))
+			assert.Equal(t, tt.expectedValid, report.Valid)
+			assert.Empty(t, report.Warnings)
+			if tt.expectedValid {
+				assert.Empty(t, report.Errors)
+				return
+			}
+			require.Len(t, report.Errors, 1)
+			assert.Equal(t, "easyp.yaml", report.Errors[0].File)
+			assert.Equal(t, "yaml_validation", report.Errors[0].Code)
+			assert.Equal(t, config.SeverityError, report.Errors[0].Severity)
+			assert.Equal(t, 2, report.Errors[0].Line)
+			assert.Equal(t, 3, report.Errors[0].Column)
+		})
+	}
+}
+
+func TestWriteValidationText(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name     string
+		report   validateResult
+		expected string
+	}{
+		{
+			name: "warnings preserve a valid result",
+			report: validateResult{
+				Valid: true,
+				Warnings: []config.ValidationIssue{
+					{File: "easyp.yaml", Code: "warning", Message: "first warning"},
+					{File: "nested/easyp.yaml", Line: 3, Column: 2, Code: "warning", Message: "second warning"},
+				},
+			},
+			expected: "VALID: true\nWARNINGS:\n# FILE LOCATION CODE MESSAGE\n1 easyp.yaml - warning first warning\n2 nested/easyp.yaml 3:2 warning second warning",
+		},
+		{
+			name: "errors precede separately numbered warnings",
+			report: validateResult{
+				Errors: []config.ValidationIssue{
+					{File: "easyp.yaml", Line: 2, Column: 3, Code: "invalid", Message: "invalid field"},
+				},
+				Warnings: []config.ValidationIssue{
+					{File: "easyp.gen.yaml", Code: "warning", Message: "check field"},
+				},
+			},
+			expected: "VALID: false\nERRORS:\n# FILE LOCATION CODE MESSAGE\n1 easyp.yaml 2:3 invalid invalid field\nWARNINGS:\n# FILE LOCATION CODE MESSAGE\n1 easyp.gen.yaml - warning check field",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			var output bytes.Buffer
+
+			err := writeValidationText(&output, tt.report)
+
+			require.NoError(t, err)
+			lines := strings.Split(strings.TrimSpace(output.String()), "\n")
+			for i, line := range lines {
+				lines[i] = strings.Join(strings.Fields(line), " ")
+			}
+			assert.Equal(t, tt.expected, strings.Join(lines, "\n"))
+		})
+	}
+}
+
+func TestWriteValidationTextPreservesOutputErrors(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name      string
+		byteLimit int
+		operation string
+	}{
+		{name: "status line", operation: "Fprintf:"},
+		{name: "section heading", byteLimit: len("VALID: false\n"), operation: "Fprintln:"},
+		{name: "buffered rows", byteLimit: len("VALID: false\nERRORS:\n"), operation: "Flush:"},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			output := &limitedValidationWriter{remaining: tt.byteLimit}
+			report := validateResult{
+				Errors: []config.ValidationIssue{{File: "easyp.yaml", Code: "invalid", Message: "invalid field"}},
+			}
+
+			err := writeValidationText(output, report)
+
+			require.ErrorIs(t, err, io.ErrClosedPipe)
+			assert.ErrorContains(t, err, tt.operation)
+		})
+	}
+}
+
+type limitedValidationWriter struct {
+	remaining int
+}
+
+func (w *limitedValidationWriter) Write(p []byte) (int, error) {
+	n := min(len(p), w.remaining)
+	w.remaining -= n
+	if n < len(p) {
+		return n, io.ErrClosedPipe
+	}
+	return n, nil
+}
+
+func validationContext(t *testing.T, path, format string, output io.Writer) *cli.Context {
+	t.Helper()
+
+	set := flag.NewFlagSet("validate-config", flag.ContinueOnError)
+	set.String(flags.Config.Name, "", "")
+	set.String(flags.Format.Name, "", "")
+	require.NoError(t, set.Set(flags.Config.Name, path))
+	require.NoError(t, set.Set(flags.Format.Name, format))
+	ctx := cli.NewContext(&cli.App{Writer: output}, set, nil)
+	ctx.Context = t.Context()
+	return ctx
+}
diff --git a/internal/config/breaking_check.go b/internal/config/breaking_check.go
index 13bc3fb2..d8d66c28 100644
--- a/internal/config/breaking_check.go
+++ b/internal/config/breaking_check.go
@@ -4,6 +4,8 @@ package config
 type BreakingCheck struct {
 	Ignore []string `json:"ignore,omitempty" yaml:"ignore,omitempty"`
 	// git ref to compare with
-	AgainstGitRef string   `json:"against_git_ref,omitempty" yaml:"against_git_ref,omitempty"`
-	Use           []string `json:"use,omitempty" yaml:"use,omitempty"`
+	AgainstGitRef  string   `json:"against_git_ref,omitempty" yaml:"against_git_ref,omitempty"`
+	Use            []string `json:"use,omitempty" yaml:"use,omitempty"`
+	Categories     []string `json:"categories,omitempty" yaml:"categories,omitempty"`
+	IgnoreUnstable bool     `json:"ignore_unstable,omitempty" yaml:"ignore_unstable,omitempty"`
 }
diff --git a/internal/config/breaking_profiles.go b/internal/config/breaking_profiles.go
new file mode 100644
index 00000000..976d4e65
--- /dev/null
+++ b/internal/config/breaking_profiles.go
@@ -0,0 +1,107 @@
+package config
+
+import (
+	"fmt"
+	"slices"
+)
+
+// BreakingProfile describes one selectable producer-side compatibility profile.
+type BreakingProfile struct {
+	Name        string
+	Description string
+	Rules       []string
+}
+
+var breakingProfiles = []BreakingProfile{
+	{
+		Name:        "FILE",
+		Description: "Generated source compatibility, including declaration file identity and moves.",
+		Rules: []string{
+			"MESSAGE_SAME_MESSAGE_SET_WIRE_FORMAT", "EXTENSION_SAME_NUMBER", "EXTENSION_SAME_EXTENDEE", "EXTENSION_MOVED", "FILE_SAME_PHP_CLASS_PREFIX",
+			"FILE_NO_DELETE", "MESSAGE_MOVED", "ENUM_MOVED", "SERVICE_MOVED", "ONEOF_MOVED", "FILE_SAME_PACKAGE", "FILE_SAME_SYNTAX", "FILE_SAME_GO_PACKAGE", "FILE_SAME_JAVA_PACKAGE",
+			"FILE_SAME_JAVA_OUTER_CLASSNAME", "FILE_SAME_JAVA_MULTIPLE_FILES", "FILE_SAME_JAVA_STRING_CHECK_UTF8",
+			"FILE_SAME_CSHARP_NAMESPACE", "FILE_SAME_OBJC_CLASS_PREFIX", "FILE_SAME_OPTIMIZE_FOR", "FILE_SAME_PHP_NAMESPACE",
+			"FILE_SAME_PHP_METADATA_NAMESPACE", "FILE_SAME_RUBY_PACKAGE", "FILE_SAME_SWIFT_PREFIX", "FILE_SAME_CC_ENABLE_ARENAS",
+			"FILE_SAME_CC_GENERIC_SERVICES", "FILE_SAME_JAVA_GENERIC_SERVICES", "FILE_SAME_PY_GENERIC_SERVICES",
+			"PACKAGE_NO_DELETE", "MESSAGE_NO_DELETE", "ENUM_NO_DELETE", "SERVICE_NO_DELETE", "RPC_NO_DELETE", "ONEOF_NO_DELETE",
+			"FIELD_NO_DELETE", "FIELD_SAME_NAME", "FIELD_SAME_TYPE", "FIELD_SAME_CARDINALITY", "FIELD_SAME_JSON_NAME",
+			"FIELD_SAME_ONEOF", "FIELD_SAME_DEFAULT", "FIELD_SAME_JSTYPE", "FIELD_SAME_CPP_STRING_TYPE",
+			"FIELD_SAME_JAVA_UTF8_VALIDATION", "FIELD_SAME_UTF8_VALIDATION", "MESSAGE_NO_REMOVE_STANDARD_DESCRIPTOR_ACCESSOR",
+			"MESSAGE_SAME_JSON_FORMAT", "ENUM_SAME_JSON_FORMAT", "ENUM_SAME_TYPE", "ENUM_VALUE_NO_DELETE", "ENUM_VALUE_SAME_NAME",
+			"EXTENSION_NO_DELETE", "EXTENSION_MESSAGE_NO_DELETE", "RESERVED_MESSAGE_NO_DELETE", "RESERVED_ENUM_NO_DELETE",
+			"MESSAGE_SAME_REQUIRED_FIELDS", "RPC_SAME_REQUEST_TYPE", "RPC_SAME_RESPONSE_TYPE", "RPC_SAME_CLIENT_STREAMING",
+			"RPC_SAME_SERVER_STREAMING", "RPC_SAME_IDEMPOTENCY_LEVEL",
+		},
+	},
+	{
+		Name:        "PACKAGE",
+		Description: "Generated source compatibility by protobuf package; declarations may move between files in that package.",
+		Rules: []string{
+			"MESSAGE_SAME_MESSAGE_SET_WIRE_FORMAT", "EXTENSION_SAME_NUMBER", "EXTENSION_SAME_EXTENDEE", "FILE_SAME_PHP_CLASS_PREFIX",
+			"FILE_SAME_PACKAGE", "FILE_SAME_SYNTAX", "FILE_SAME_GO_PACKAGE", "FILE_SAME_JAVA_PACKAGE", "FILE_SAME_JAVA_OUTER_CLASSNAME",
+			"FILE_SAME_JAVA_MULTIPLE_FILES", "FILE_SAME_JAVA_STRING_CHECK_UTF8", "FILE_SAME_CSHARP_NAMESPACE", "FILE_SAME_OBJC_CLASS_PREFIX",
+			"FILE_SAME_OPTIMIZE_FOR", "FILE_SAME_PHP_NAMESPACE", "FILE_SAME_PHP_METADATA_NAMESPACE", "FILE_SAME_RUBY_PACKAGE",
+			"FILE_SAME_SWIFT_PREFIX", "FILE_SAME_CC_ENABLE_ARENAS", "FILE_SAME_CC_GENERIC_SERVICES", "FILE_SAME_JAVA_GENERIC_SERVICES",
+			"FILE_SAME_PY_GENERIC_SERVICES", "PACKAGE_NO_DELETE", "MESSAGE_NO_DELETE", "ENUM_NO_DELETE", "SERVICE_NO_DELETE", "RPC_NO_DELETE",
+			"ONEOF_NO_DELETE", "FIELD_NO_DELETE", "FIELD_SAME_NAME", "FIELD_SAME_TYPE", "FIELD_SAME_CARDINALITY", "FIELD_SAME_JSON_NAME",
+			"FIELD_SAME_ONEOF", "FIELD_SAME_DEFAULT", "FIELD_SAME_JSTYPE", "FIELD_SAME_CPP_STRING_TYPE", "FIELD_SAME_JAVA_UTF8_VALIDATION",
+			"FIELD_SAME_UTF8_VALIDATION", "MESSAGE_NO_REMOVE_STANDARD_DESCRIPTOR_ACCESSOR", "MESSAGE_SAME_JSON_FORMAT", "ENUM_SAME_JSON_FORMAT",
+			"ENUM_SAME_TYPE", "ENUM_VALUE_NO_DELETE", "ENUM_VALUE_SAME_NAME", "EXTENSION_NO_DELETE", "EXTENSION_MESSAGE_NO_DELETE",
+			"RESERVED_MESSAGE_NO_DELETE", "RESERVED_ENUM_NO_DELETE", "MESSAGE_SAME_REQUIRED_FIELDS", "RPC_SAME_REQUEST_TYPE",
+			"RPC_SAME_RESPONSE_TYPE", "RPC_SAME_CLIENT_STREAMING", "RPC_SAME_SERVER_STREAMING", "RPC_SAME_IDEMPOTENCY_LEVEL",
+		},
+	},
+	{
+		Name:        "WIRE_JSON",
+		Description: "Binary and protobuf JSON compatibility, including reserved field and enum names.",
+		Rules: []string{
+			"SERVICE_NO_DELETE", "MESSAGE_SAME_MESSAGE_SET_WIRE_FORMAT", "EXTENSION_SAME_NUMBER", "EXTENSION_SAME_EXTENDEE",
+			"FILE_SAME_PACKAGE", "FIELD_NO_DELETE_UNLESS_NAME_RESERVED", "FIELD_NO_DELETE_UNLESS_NUMBER_RESERVED", "FIELD_SAME_NAME",
+			"FIELD_SAME_JSON_NAME", "FIELD_WIRE_JSON_COMPATIBLE_TYPE", "FIELD_WIRE_JSON_COMPATIBLE_CARDINALITY", "FIELD_SAME_ONEOF",
+			"FIELD_SAME_DEFAULT", "ENUM_VALUE_NO_DELETE_UNLESS_NAME_RESERVED", "ENUM_VALUE_NO_DELETE_UNLESS_NUMBER_RESERVED",
+			"ENUM_VALUE_SAME_NAME", "MESSAGE_SAME_REQUIRED_FIELDS", "MESSAGE_SAME_JSON_FORMAT", "ENUM_SAME_JSON_FORMAT",
+			"RESERVED_MESSAGE_NO_DELETE", "RESERVED_ENUM_NO_DELETE", "RPC_NO_DELETE", "RPC_SAME_REQUEST_TYPE", "RPC_SAME_RESPONSE_TYPE",
+			"RPC_SAME_CLIENT_STREAMING", "RPC_SAME_SERVER_STREAMING", "RPC_SAME_IDEMPOTENCY_LEVEL",
+		},
+	},
+	{
+		Name:        "WIRE",
+		Description: "Binary protobuf compatibility, including reserved field and enum numbers.",
+		Rules: []string{
+			"SERVICE_NO_DELETE", "MESSAGE_SAME_MESSAGE_SET_WIRE_FORMAT", "EXTENSION_SAME_NUMBER", "EXTENSION_SAME_EXTENDEE",
+			"FILE_SAME_PACKAGE", "FIELD_NO_DELETE_UNLESS_NUMBER_RESERVED", "FIELD_WIRE_COMPATIBLE_TYPE", "FIELD_WIRE_COMPATIBLE_CARDINALITY",
+			"FIELD_SAME_ONEOF", "FIELD_SAME_DEFAULT", "ENUM_VALUE_NO_DELETE_UNLESS_NUMBER_RESERVED", "MESSAGE_SAME_REQUIRED_FIELDS",
+			"RESERVED_MESSAGE_NO_DELETE", "RESERVED_ENUM_NO_DELETE", "RPC_NO_DELETE", "RPC_SAME_REQUEST_TYPE", "RPC_SAME_RESPONSE_TYPE",
+			"RPC_SAME_CLIENT_STREAMING", "RPC_SAME_SERVER_STREAMING", "RPC_SAME_IDEMPOTENCY_LEVEL",
+		},
+	},
+}
+
+// BreakingProfiles returns the supported breaking profiles and their exact rule names.
+func BreakingProfiles() []BreakingProfile {
+	result := make([]BreakingProfile, len(breakingProfiles))
+	for i, profile := range breakingProfiles {
+		result[i] = profile
+		result[i].Rules = slices.Clone(profile.Rules)
+	}
+	return result
+}
+
+// ValidateBreakingCategories rejects profile names outside the shared catalog.
+func ValidateBreakingCategories(categories []string) error {
+	for _, category := range categories {
+		if !slices.ContainsFunc(breakingProfiles, func(profile BreakingProfile) bool { return profile.Name == category }) {
+			return fmt.Errorf("breaking.categories: unknown profile %q; supported: FILE, PACKAGE, WIRE_JSON, WIRE", category)
+		}
+	}
+	return nil
+}
+
+// BreakingProfileNames returns the catalog names in strictness order.
+func BreakingProfileNames() []string {
+	result := make([]string, len(breakingProfiles))
+	for i, profile := range breakingProfiles {
+		result[i] = profile.Name
+	}
+	return result
+}
diff --git a/internal/config/config.go b/internal/config/config.go
index cd983510..ede7b029 100644
--- a/internal/config/config.go
+++ b/internal/config/config.go
@@ -1,13 +1,9 @@
 package config
 
 import (
-	"context"
 	"errors"
 	"fmt"
-	"io"
-	"os"
 
-	"github.com/a8m/envsubst"
 	"gopkg.in/yaml.v3"
 )
 
@@ -143,19 +139,6 @@ type Generate struct {
 // Input source for generating code.
 type Input struct {
 	InputFilesDir InputFilesDir `yaml:"directory"`
-	GitRepo       InputGitRepo  `yaml:"git_repo"`
-}
-
-// InputGitRepo is the configuration of the git repository.
-type InputGitRepo struct {
-	URL          string `yaml:"url"`
-	SubDirectory string `yaml:"sub_directory"`
-	Root         string `yaml:"root"`
-}
-
-// InputDirectory is the configuration of the directory.
-type InputDirectory struct {
-	Path string `yaml:"path"`
 }
 
 // InputFilesDir is the configuration of the directory with additional functionality.
@@ -169,9 +152,6 @@ type Config struct {
 	// LintConfig is the lint configuration.
 	Lint LintConfig `json:"lint,omitempty" yaml:"lint,omitempty"`
 
-	// Deps is the dependencies repositories
-	Deps []string `json:"deps,omitempty" yaml:"deps,omitempty"`
-
 	// Generate is the generate configuration.
 	Generate Generate `json:"generate,omitempty" yaml:"generate,omitempty"`
 
@@ -179,56 +159,6 @@ type Config struct {
 	BreakingCheck BreakingCheck `json:"breaking,omitempty" yaml:"breaking,omitempty"`
 }
 
-var errFileNotFound = errors.New("config file not found")
-
-// New creates a new configuration from the file.
-func New(_ context.Context, filepath string) (*Config, error) {
-	cfgFile, err := os.Open(filepath)
-	if err != nil {
-		if os.IsNotExist(err) {
-			return nil, errFileNotFound
-		}
-
-		return nil, fmt.Errorf("os.Open: %w", err)
-	}
-
-	defer func() {
-		_ = cfgFile.Close()
-	}()
-
-	buf, err := io.ReadAll(cfgFile)
-	if err != nil {
-		return nil, fmt.Errorf("io.ReadAll: %w", err)
-	}
-
-	return ParseConfig(buf)
-}
-
-// ParseConfig parses configuration from bytes with environment variable expansion.
-// Supports escaping via $$ (e.g., $$var becomes $var, $${VAR} becomes ${VAR})
-// This is the unified function for parsing easyp.yaml used throughout the codebase.
-func ParseConfig(buf []byte) (*Config, error) {
-	// Expand environment variables in the config file
-	expanded, err := envsubst.String(string(buf))
-	if err != nil {
-		return nil, fmt.Errorf("envsubst.String: %w", err)
-	}
-	buf = []byte(expanded)
-
-	cfg := &Config{}
-	err = yaml.Unmarshal(buf, &cfg)
-	if err != nil {
-		return nil, fmt.Errorf("yaml.Unmarshal: %w", err)
-	}
-
-	err = cfg.Validate()
-	if err != nil {
-		return nil, fmt.Errorf("config validation: %w", err)
-	}
-
-	return cfg, nil
-}
-
 func (d *InputFilesDir) UnmarshalYAML(value *yaml.Node) error {
 	switch value.Kind {
 	case yaml.ScalarNode:
@@ -256,46 +186,6 @@ func (d *InputFilesDir) UnmarshalYAML(value *yaml.Node) error {
 	return nil
 }
 
-// Validate validates the configuration.
-func (c *Config) Validate() error {
-	if c == nil {
-		return errors.New("config is nil")
-	}
-
-	// Validate plugins
-	for _, plugin := range c.Generate.Plugins {
-		// Only one source allowed.
-		var sourceCount int
-		if plugin.Name != "" {
-			sourceCount++
-		}
-		if plugin.Remote != "" {
-			sourceCount++
-		}
-		if plugin.Path != "" {
-			sourceCount++
-		}
-		if len(plugin.Command) > 0 {
-			sourceCount++
-		}
-
-		if sourceCount > 1 {
-			return fmt.Errorf("plugin has multiple sources (name, remote, path, or command)")
-		}
-
-		if sourceCount == 0 {
-			return fmt.Errorf("plugin must have one source: name, remote, path, or command")
-		}
-	}
-
-	// Validate managed mode
-	if err := c.Generate.Managed.Validate(); err != nil {
-		return fmt.Errorf("managed mode validation: %w", err)
-	}
-
-	return nil
-}
-
 // Validate validates the managed mode configuration.
 func (m *ManagedMode) Validate() error {
 	// Validate disable rules
diff --git a/internal/config/config_test.go b/internal/config/config_test.go
deleted file mode 100644
index 5e37f720..00000000
--- a/internal/config/config_test.go
+++ /dev/null
@@ -1,234 +0,0 @@
-package config
-
-import (
-	"os"
-	"testing"
-
-	"github.com/stretchr/testify/require"
-)
-
-func requireSingleOptValue(t *testing.T, opts PluginOpts, key, expected string) {
-	t.Helper()
-	require.Contains(t, opts, key)
-	require.Equal(t, []string{expected}, opts[key])
-}
-
-func TestParseConfig_EnvironmentVariables(t *testing.T) {
-	tests := []struct {
-		name           string
-		configContent  string
-		envVars        map[string]string
-		expectedDeps   []string
-		expectedOutput string
-		expectedModule string
-		checkFunc      func(t *testing.T, cfg *Config)
-	}{
-		{
-			name: "simple environment variable expansion",
-			configContent: `lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-deps:
-  - ${DEP_GOOGLEAPIS}
-  - ${DEP_GNOSTIC}
-generate:
-  inputs:
-    - directory: ${INPUT_DIR}
-  plugins:
-    - name: go
-      out: ${OUTPUT_DIR}
-      opts:
-        module: ${MODULE_NAME}
-`,
-			envVars: map[string]string{
-				"DEP_GOOGLEAPIS": "github.com/googleapis/googleapis@common-protos-1_3_1",
-				"DEP_GNOSTIC":    "github.com/google/gnostic@v0.7.0",
-				"INPUT_DIR":      "eco_contract",
-				"OUTPUT_DIR":     "./gen/go",
-				"MODULE_NAME":    "github.com/example/ec-code/gen/go",
-			},
-			expectedDeps: []string{
-				"github.com/googleapis/googleapis@common-protos-1_3_1",
-				"github.com/google/gnostic@v0.7.0",
-			},
-			expectedOutput: "./gen/go",
-			expectedModule: "github.com/example/ec-code/gen/go",
-			checkFunc: func(t *testing.T, cfg *Config) {
-				require.Greater(t, len(cfg.Generate.Inputs), 0)
-				require.Equal(t, "eco_contract", cfg.Generate.Inputs[0].InputFilesDir.Path)
-			},
-		},
-		{
-			name: "escape with double dollar sign",
-			configContent: `lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-deps: []
-generate:
-  inputs:
-    - directory: eco_contract
-  plugins:
-    - name: go
-      out: ./gen/go
-      opts:
-        # Test escape: $$100 should become $100
-        description: "This costs $$100 dollars"
-        # Test escape: $${TEMP} should become ${TEMP}
-        path: "${BASE_DIR}/$${TEMP}/file"
-        # Test escape: $$ should become $
-        literal: "$$"
-`,
-			envVars: map[string]string{
-				"BASE_DIR": "/tmp",
-			},
-			checkFunc: func(t *testing.T, cfg *Config) {
-				// Проверяем, что опции содержат экранированные значения
-				require.Greater(t, len(cfg.Generate.Plugins), 0)
-				opts := cfg.Generate.Plugins[0].Opts
-				requireSingleOptValue(t, opts, "description", "This costs $100 dollars")
-				requireSingleOptValue(t, opts, "path", "/tmp/${TEMP}/file")
-				requireSingleOptValue(t, opts, "literal", "$")
-			},
-		},
-		{
-			name: "mixed expansion and escape",
-			configContent: `lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-deps:
-  - ${DEP_URL}
-generate:
-  inputs:
-    - directory: ${INPUT_DIR}
-  plugins:
-    - name: go
-      out: ${OUTPUT_DIR}
-      opts:
-        module: ${MODULE_NAME}
-        # Mixed: expand ${OUTPUT_DIR} but escape $${TEMP}
-        mixed: "${OUTPUT_DIR}/$${TEMP}/generated"
-`,
-			envVars: map[string]string{
-				"DEP_URL":     "github.com/googleapis/googleapis@common-protos-1_3_1",
-				"INPUT_DIR":   "proto",
-				"OUTPUT_DIR":  "./gen/go",
-				"MODULE_NAME": "github.com/example/project",
-			},
-			checkFunc: func(t *testing.T, cfg *Config) {
-				require.Greater(t, len(cfg.Generate.Plugins), 0)
-				require.Greater(t, len(cfg.Generate.Inputs), 0)
-				require.Greater(t, len(cfg.Deps), 0)
-
-				require.Equal(t, "github.com/googleapis/googleapis@common-protos-1_3_1", cfg.Deps[0])
-				require.Equal(t, "proto", cfg.Generate.Inputs[0].InputFilesDir.Path)
-				require.Equal(t, "./gen/go", cfg.Generate.Plugins[0].Out)
-				requireSingleOptValue(t, cfg.Generate.Plugins[0].Opts, "module", "github.com/example/project")
-				// Проверяем смешанное использование
-				requireSingleOptValue(t, cfg.Generate.Plugins[0].Opts, "mixed", "./gen/go/${TEMP}/generated")
-			},
-		},
-		{
-			name: "unset variable becomes empty",
-			configContent: `lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-deps: []
-generate:
-  inputs:
-    - directory: ${UNSET_VAR}
-  plugins:
-    - name: go
-      out: ./gen/go
-`,
-			envVars: map[string]string{},
-			checkFunc: func(t *testing.T, cfg *Config) {
-				// Неустановленная переменная должна стать пустой строкой
-				require.Greater(t, len(cfg.Generate.Inputs), 0)
-				require.Equal(t, "", cfg.Generate.Inputs[0].InputFilesDir.Path)
-			},
-		},
-		{
-			name: "default values with :- syntax",
-			configContent: `lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-deps: []
-generate:
-  inputs:
-    - directory: ${UNSET_VAR:-default_dir}
-  plugins:
-    - name: go
-      out: ${OUTPUT_DIR:-./gen/go}
-      opts:
-        module: ${MODULE_NAME:-github.com/example/project}
-        timeout: ${TIMEOUT:-30}
-`,
-			envVars: map[string]string{},
-			checkFunc: func(t *testing.T, cfg *Config) {
-				require.Greater(t, len(cfg.Generate.Inputs), 0)
-				require.Equal(t, "default_dir", cfg.Generate.Inputs[0].InputFilesDir.Path)
-				require.Greater(t, len(cfg.Generate.Plugins), 0)
-				require.Equal(t, "./gen/go", cfg.Generate.Plugins[0].Out)
-				require.Greater(t, len(cfg.Generate.Plugins[0].Opts), 0)
-				requireSingleOptValue(t, cfg.Generate.Plugins[0].Opts, "module", "github.com/example/project")
-				requireSingleOptValue(t, cfg.Generate.Plugins[0].Opts, "timeout", "30")
-			},
-		},
-		{
-			name: "default values with set variable",
-			configContent: `lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-deps: []
-generate:
-  inputs:
-    - directory: ${SET_VAR:-default_dir}
-  plugins:
-    - name: go
-      out: ${OUTPUT_DIR:-./gen/go}
-`,
-			envVars: map[string]string{
-				"SET_VAR":    "custom_dir",
-				"OUTPUT_DIR": "./custom/output",
-			},
-			checkFunc: func(t *testing.T, cfg *Config) {
-				require.Greater(t, len(cfg.Generate.Inputs), 0)
-				// Установленная переменная должна использоваться вместо default
-				require.Equal(t, "custom_dir", cfg.Generate.Inputs[0].InputFilesDir.Path)
-				require.Greater(t, len(cfg.Generate.Plugins), 0)
-				require.Equal(t, "./custom/output", cfg.Generate.Plugins[0].Out)
-			},
-		},
-	}
-
-	for _, tt := range tests {
-		t.Run(tt.name, func(t *testing.T) {
-			// Устанавливаем переменные окружения
-			for key, value := range tt.envVars {
-				os.Setenv(key, value)
-				defer os.Unsetenv(key)
-			}
-
-			// Парсим конфигурацию напрямую через ParseConfig
-			cfg, err := ParseConfig([]byte(tt.configContent))
-			require.NoError(t, err)
-
-			// Проверяем ожидаемые значения
-			if len(tt.expectedDeps) > 0 {
-				require.Equal(t, tt.expectedDeps, cfg.Deps)
-			}
-			if tt.expectedOutput != "" {
-				require.Greater(t, len(cfg.Generate.Plugins), 0)
-				require.Equal(t, tt.expectedOutput, cfg.Generate.Plugins[0].Out)
-			}
-			if tt.expectedModule != "" {
-				require.Greater(t, len(cfg.Generate.Plugins), 0)
-				require.Greater(t, len(cfg.Generate.Plugins[0].Opts), 0)
-				requireSingleOptValue(t, cfg.Generate.Plugins[0].Opts, "module", tt.expectedModule)
-			}
-			if tt.checkFunc != nil {
-				tt.checkFunc(t, cfg)
-			}
-		})
-	}
-}
diff --git a/internal/config/default.go b/internal/config/default.go
deleted file mode 100644
index 32d3bfad..00000000
--- a/internal/config/default.go
+++ /dev/null
@@ -1,6 +0,0 @@
-package config
-
-// Default configurations.
-const (
-	DefaultFileName = "easyp.yaml"
-)
diff --git a/internal/config/lint.go b/internal/config/lint.go
index 2a968862..f6bf5c65 100644
--- a/internal/config/lint.go
+++ b/internal/config/lint.go
@@ -2,11 +2,12 @@ package config
 
 // LintConfig contains linter configuration.
 type LintConfig struct {
-	Use                 []string            `json:"use,omitempty" yaml:"use,omitempty" env:"USE"`                                                          // Use rules for linter.
-	EnumZeroValueSuffix string              `json:"enum_zero_value_suffix,omitempty" yaml:"enum_zero_value_suffix,omitempty" env:"ENUM_ZERO_VALUE_SUFFIX"` // Enum zero value suffix.
-	ServiceSuffix       string              `json:"service_suffix,omitempty" yaml:"service_suffix,omitempty" env:"SERVICE_SUFFIX"`                         // Service suffix.
-	Ignore              []string            `json:"ignore,omitempty" yaml:"ignore,omitempty" env:"IGNORE"`                                                 // Ignore dirs with proto file.
-	Except              []string            `json:"except,omitempty" yaml:"except,omitempty" env:"EXCEPT"`                                                 // Except linter rules.
-	AllowCommentIgnores bool                `json:"allow_comment_ignores,omitempty" yaml:"allow_comment_ignores,omitempty" env:"ALLOW_COMMENT_IGNORES"`    // Allow comment ignore.
-	IgnoreOnly          map[string][]string `json:"ignore_only,omitempty" yaml:"ignore_only,omitempty" env:"IGNORE_ONLY"`
+	PackageDirectoryPrefix string              `json:"-" yaml:"-"`
+	Use                    []string            `json:"use,omitempty" yaml:"use,omitempty" env:"USE"`                                                          // Use rules for linter.
+	EnumZeroValueSuffix    string              `json:"enum_zero_value_suffix,omitempty" yaml:"enum_zero_value_suffix,omitempty" env:"ENUM_ZERO_VALUE_SUFFIX"` // Enum zero value suffix.
+	ServiceSuffix          string              `json:"service_suffix,omitempty" yaml:"service_suffix,omitempty" env:"SERVICE_SUFFIX"`                         // Service suffix.
+	Ignore                 []string            `json:"ignore,omitempty" yaml:"ignore,omitempty" env:"IGNORE"`                                                 // Ignore dirs with proto file.
+	Except                 []string            `json:"except,omitempty" yaml:"except,omitempty" env:"EXCEPT"`                                                 // Except linter rules.
+	AllowCommentIgnores    bool                `json:"allow_comment_ignores,omitempty" yaml:"allow_comment_ignores,omitempty" env:"ALLOW_COMMENT_IGNORES"`    // Allow comment ignore.
+	IgnoreOnly             map[string][]string `json:"ignore_only,omitempty" yaml:"ignore_only,omitempty" env:"IGNORE_ONLY"`
 }
diff --git a/internal/config/managed_mode_test.go b/internal/config/managed_mode_test.go
deleted file mode 100644
index 87d042d5..00000000
--- a/internal/config/managed_mode_test.go
+++ /dev/null
@@ -1,41 +0,0 @@
-package config
-
-import (
-	"testing"
-
-	"github.com/stretchr/testify/require"
-)
-
-func TestParseConfig_ManagedModePackageSelectors(t *testing.T) {
-	content := `lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-generate:
-  inputs:
-    - directory: proto
-  plugins:
-    - name: go
-      out: .
-  managed:
-    enabled: true
-    disable:
-      - package: acme.weather.v1
-        file_option: java_package_prefix
-    override:
-      - file_option: go_package_prefix
-        package: acme.weather.v1
-        value: github.com/acme/gen/go
-`
-
-	cfg, err := ParseConfig([]byte(content))
-	require.NoError(t, err)
-
-	require.Len(t, cfg.Generate.Managed.Disable, 1)
-	require.Equal(t, "acme.weather.v1", cfg.Generate.Managed.Disable[0].Package)
-	require.Equal(t, "java_package_prefix", cfg.Generate.Managed.Disable[0].FileOption)
-
-	require.Len(t, cfg.Generate.Managed.Override, 1)
-	require.Equal(t, "acme.weather.v1", cfg.Generate.Managed.Override[0].Package)
-	require.Equal(t, "go_package_prefix", cfg.Generate.Managed.Override[0].FileOption)
-	require.Equal(t, "github.com/acme/gen/go", cfg.Generate.Managed.Override[0].Value)
-}
diff --git a/internal/config/v1/breaking_categories_test.go b/internal/config/v1/breaking_categories_test.go
new file mode 100644
index 00000000..9d43c435
--- /dev/null
+++ b/internal/config/v1/breaking_categories_test.go
@@ -0,0 +1,60 @@
+package v1
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/config"
+)
+
+func TestBreakingCategoriesValidation(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name       string
+		categories string
+		wantUse    []string
+		wantError  bool
+	}{
+		{name: "omitted", wantUse: []string{"FILE"}},
+		{name: "empty", categories: "  categories: []\n", wantUse: []string{"FILE"}},
+		{name: "FILE", categories: "  categories: [FILE]\n", wantUse: []string{"FILE"}},
+		{name: "duplicate FILE", categories: "  categories: [FILE, FILE]\n", wantUse: []string{"FILE", "FILE"}},
+		{name: "PACKAGE", categories: "  categories: [PACKAGE]\n", wantUse: []string{"PACKAGE"}},
+		{name: "WIRE_JSON", categories: "  categories: [WIRE_JSON]\n", wantUse: []string{"WIRE_JSON"}},
+		{name: "WIRE", categories: "  categories: [WIRE]\n", wantUse: []string{"WIRE"}},
+		{name: "mixed profiles", categories: "  categories: [WIRE, WIRE_JSON, PACKAGE, FILE]\n", wantUse: []string{"WIRE", "WIRE_JSON", "PACKAGE", "FILE"}},
+		{name: "unknown", categories: "  categories: [UNKNOWN]\n", wantError: true},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			raw := "version: v1\nbreaking:\n  baseline: git:main\n" + tt.categories
+			assert.Equal(t, tt.wantError, config.HasErrors(ValidatePolicyYAML([]byte(raw))))
+			path := filepath.Join(t.TempDir(), PolicyFile)
+			require.NoError(t, os.WriteFile(path, []byte(raw), 0o644))
+			issues, err := ValidateFile(path)
+			require.NoError(t, err)
+			assert.Equal(t, tt.wantError, config.HasErrors(issues))
+
+			policy, err := ParsePolicy(strings.NewReader(raw))
+			if tt.wantError {
+				require.ErrorContains(t, err, "breaking.categories")
+				return
+			}
+			require.NoError(t, err)
+			cfg, err := policy.BreakingConfig("fallback")
+			require.NoError(t, err)
+			assert.Equal(t, tt.wantUse, cfg.Use)
+			assert.Equal(t, "main", cfg.AgainstGitRef)
+			if len(policy.Breaking.Categories) > 0 {
+				cfg.Use[0] = "changed"
+				assert.Equal(t, tt.wantUse[0], policy.Breaking.Categories[0])
+			}
+		})
+	}
+}
diff --git a/internal/config/v1/breaking_default_test.go b/internal/config/v1/breaking_default_test.go
new file mode 100644
index 00000000..5724d79d
--- /dev/null
+++ b/internal/config/v1/breaking_default_test.go
@@ -0,0 +1,34 @@
+package v1
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestBreakingConfigDefaultsToFileProfile(t *testing.T) {
+	t.Parallel()
+
+	for _, raw := range []string{
+		`version: v1
+breaking:
+  baseline: git:main
+`,
+		`version: v1
+breaking:
+  baseline: git:main
+  categories: []
+`,
+	} {
+		policy, err := ParsePolicy(strings.NewReader(raw))
+		require.NoError(t, err)
+
+		cfg, err := policy.BreakingConfig("master")
+		require.NoError(t, err)
+
+		assert.Equal(t, []string{"FILE"}, cfg.Categories)
+		assert.Equal(t, []string{"FILE"}, cfg.Use)
+	}
+}
diff --git a/internal/config/v1/bsr.go b/internal/config/v1/bsr.go
new file mode 100644
index 00000000..c6f6b97d
--- /dev/null
+++ b/internal/config/v1/bsr.go
@@ -0,0 +1,85 @@
+package v1
+
+import (
+	"fmt"
+	"path"
+	"path/filepath"
+	"regexp"
+	"strings"
+
+	"golang.org/x/mod/semver"
+)
+
+const (
+	bsrModulePattern = `^[^/:\s]+/[^/:\s]+/[^/:\s]+$`
+	bsrDigestPattern = `^[^:\s]+:[0-9a-fA-F]+$`
+
+	// BSRCompatibilitySnapshot identifies a Git snapshot without verified BSR revision equivalence.
+	BSRCompatibilitySnapshot = "compatibility_snapshot"
+	// BSRExactRevision identifies a Git source proven to match the requested BSR revision.
+	BSRExactRevision = "exact"
+)
+
+var (
+	bsrModuleRE = regexp.MustCompile(bsrModulePattern)
+	bsrDigestRE = regexp.MustCompile(bsrDigestPattern)
+)
+
+// BSRDependency preserves a Buf request and its optional lock pin, relative to the Git checkout.
+type BSRDependency struct {
+	Module    string `yaml:"module"`
+	Reference string `yaml:"reference,omitempty"`
+	Commit    string `yaml:"commit,omitempty"`
+	Digest    string `yaml:"digest,omitempty"`
+	Config    string `yaml:"config"`
+}
+
+// BSRResolution records the Git requirement chosen for a BSR dependency.
+type BSRResolution struct {
+	Dependency BSRDependency `yaml:"dependency"`
+	Git        Requirement   `yaml:"git"`
+	Resolution string        `yaml:"resolution"`
+}
+
+// Validate checks the preserved metadata, without verifying BSR content or contacting a registry.
+func (dependency BSRDependency) Validate() error {
+	if !bsrModuleRE.MatchString(dependency.Module) {
+		return fmt.Errorf("invalid BSR module %q", dependency.Module)
+	}
+	if strings.ContainsAny(dependency.Reference, ": \t\r\n") {
+		return fmt.Errorf("invalid BSR reference %q", dependency.Reference)
+	}
+	if dependency.Commit != "" && (len(dependency.Commit) != 32 || !isHex(dependency.Commit)) {
+		return fmt.Errorf("invalid BSR commit %q", dependency.Commit)
+	}
+	if len(dependency.Reference) == 32 && isHex(dependency.Reference) && dependency.Commit != "" && !strings.EqualFold(dependency.Reference, dependency.Commit) {
+		return fmt.Errorf("conflicting BSR commit for %s: requested %s, locked %s", dependency.Module, dependency.Reference, dependency.Commit)
+	}
+	if dependency.Digest != "" && !bsrDigestRE.MatchString(dependency.Digest) {
+		return fmt.Errorf("invalid BSR digest %q", dependency.Digest)
+	}
+	if !filepath.IsLocal(filepath.FromSlash(dependency.Config)) || path.Clean(dependency.Config) != dependency.Config || strings.Contains(dependency.Config, "\\") {
+		return fmt.Errorf("invalid BSR config path %q", dependency.Config)
+	}
+	return nil
+}
+
+// Validate requires an explicit, pinned Git target and a declared resolution policy.
+func (binding BSRResolution) Validate() error {
+	if err := binding.Dependency.Validate(); err != nil {
+		return fmt.Errorf("Validate: %w", err)
+	}
+	if binding.Git.Module == "" || binding.Git.Version == "" {
+		return fmt.Errorf("unpinned BSR Git target for %s", binding.Dependency.Module)
+	}
+	if err := ValidateModuleVersion(binding.Git.Module, binding.Git.Version); err != nil {
+		return fmt.Errorf("ValidateModuleVersion: %w", err)
+	}
+	if !semver.IsValid(binding.Git.Version) && !IsCommitRef(binding.Git.Version) {
+		return fmt.Errorf("invalid version %q for BSR Git target %s", binding.Git.Version, binding.Git.Module)
+	}
+	if binding.Resolution != BSRCompatibilitySnapshot && binding.Resolution != BSRExactRevision {
+		return fmt.Errorf("invalid BSR resolution %q for %s", binding.Resolution, binding.Dependency.Module)
+	}
+	return nil
+}
diff --git a/internal/config/v1/bsr_test.go b/internal/config/v1/bsr_test.go
new file mode 100644
index 00000000..744751e6
--- /dev/null
+++ b/internal/config/v1/bsr_test.go
@@ -0,0 +1,78 @@
+package v1
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestBSRDependencyValidate(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name       string
+		dependency BSRDependency
+		wantErr    string
+	}{
+		{name: "unversioned module", dependency: BSRDependency{Module: "buf.build/googleapis/googleapis", Config: "buf.yaml"}},
+		{name: "label and locked pin", dependency: BSRDependency{Module: "buf.build/googleapis/googleapis", Reference: "stable", Commit: strings.Repeat("a", 32), Digest: "shake256:" + strings.Repeat("a", 128), Config: "proto/buf.yaml"}},
+		{name: "empty module", dependency: BSRDependency{Config: "buf.yaml"}, wantErr: "invalid BSR module"},
+		{name: "reference in identity", dependency: BSRDependency{Module: "buf.build/googleapis/googleapis:stable", Config: "buf.yaml"}, wantErr: "invalid BSR module"},
+		{name: "invalid reference", dependency: BSRDependency{Module: "buf.build/googleapis/googleapis", Reference: "two words", Config: "buf.yaml"}, wantErr: "invalid BSR reference"},
+		{name: "Git commit is not BSR commit", dependency: BSRDependency{Module: "buf.build/googleapis/googleapis", Commit: strings.Repeat("a", 40), Config: "buf.yaml"}, wantErr: "invalid BSR commit"},
+		{name: "conflicting commit", dependency: BSRDependency{Module: "buf.build/googleapis/googleapis", Reference: strings.Repeat("a", 32), Commit: strings.Repeat("b", 32), Config: "buf.yaml"}, wantErr: "conflicting BSR commit"},
+		{name: "invalid digest", dependency: BSRDependency{Module: "buf.build/googleapis/googleapis", Digest: "b5:not-hex", Config: "buf.yaml"}, wantErr: "invalid BSR digest"},
+		{name: "missing origin", dependency: BSRDependency{Module: "buf.build/googleapis/googleapis"}, wantErr: "invalid BSR config path"},
+		{name: "origin outside module", dependency: BSRDependency{Module: "buf.build/googleapis/googleapis", Config: "../buf.yaml"}, wantErr: "invalid BSR config path"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			err := tt.dependency.Validate()
+
+			if tt.wantErr != "" {
+				require.ErrorContains(t, err, tt.wantErr)
+				return
+			}
+			require.NoError(t, err)
+		})
+	}
+}
+
+func TestLockBSRBindings(t *testing.T) {
+	t.Parallel()
+	binding := "      - dependency: {module: buf.build/googleapis/googleapis, config: buf.yaml}\n        git: {module: github.com/googleapis/googleapis, version: v1.0.0}\n        resolution: compatibility_snapshot\n"
+	tests := []struct {
+		name    string
+		binding string
+		wantErr string
+	}{
+		{name: "compatibility snapshot", binding: binding},
+		{name: "duplicate origin", binding: binding + binding, wantErr: "duplicate BSR binding"},
+		{name: "missing Git version", binding: strings.Replace(binding, ", version: v1.0.0", "", 1), wantErr: "unpinned BSR Git target"},
+		{name: "unknown policy", binding: strings.Replace(binding, "compatibility_snapshot", "implicit_latest", 1), wantErr: "invalid BSR resolution"},
+		{name: "invalid target version", binding: strings.Replace(binding, "version: v1.0.0", "version: main", 1), wantErr: "invalid version"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			raw := "version: 1\nmodules:\n  - source: github.com/acme/parent\n    version: v1.0.0\n    commit: " + strings.Repeat("a", 40) + "\n    hash: h1:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=\n    bsr:\n" + tt.binding
+
+			lock, err := ParseLock(strings.NewReader(raw))
+
+			if tt.wantErr != "" {
+				require.ErrorContains(t, err, tt.wantErr)
+				return
+			}
+			require.NoError(t, err)
+			require.Len(t, lock.Modules, 1)
+			require.Len(t, lock.Modules[0].BSR, 1)
+			assert.Equal(t, "buf.build/googleapis/googleapis", lock.Modules[0].BSR[0].Dependency.Module)
+			assert.Equal(t, Requirement{Module: "github.com/googleapis/googleapis", Version: "v1.0.0"}, lock.Modules[0].BSR[0].Git)
+		})
+	}
+}
diff --git a/internal/config/v1/environment.go b/internal/config/v1/environment.go
new file mode 100644
index 00000000..47368935
--- /dev/null
+++ b/internal/config/v1/environment.go
@@ -0,0 +1,168 @@
+package v1
+
+import (
+	"bytes"
+	"fmt"
+	"io"
+
+	"github.com/a8m/envsubst"
+)
+
+func expandConfigYAML(r io.Reader) ([]byte, error) {
+	raw, err := io.ReadAll(r)
+	if err != nil {
+		return nil, fmt.Errorf("ReadAll: %w", err)
+	}
+	return expandConfigBytes(raw)
+}
+
+func expandConfigBytes(raw []byte) ([]byte, error) {
+	// Keep YAML comments out of envsubst while preserving the original source.
+	// Values in quoted strings and block scalars still undergo substitution.
+	expanded := make([]byte, 0, len(raw))
+	segmentStart := 0
+	var quote byte
+	var blockIndent, headerIndent int
+	inBlock := false
+	for lineStart := 0; lineStart < len(raw); {
+		lineEnd := len(raw)
+		if newline := bytes.IndexByte(raw[lineStart:], '\n'); newline >= 0 {
+			lineEnd = lineStart + newline
+		}
+		nextLine := lineEnd
+		if nextLine < len(raw) {
+			nextLine++
+		}
+		line := raw[lineStart:lineEnd]
+		indent := leadingSpaces(line)
+		trimmed := bytes.TrimSpace(line)
+		if inBlock {
+			switch {
+			case len(trimmed) == 0:
+				lineStart = nextLine
+				continue
+			case blockIndent == 0 && indent > headerIndent:
+				blockIndent = indent
+				lineStart = nextLine
+				continue
+			case blockIndent > 0 && indent >= blockIndent:
+				lineStart = nextLine
+				continue
+			case trimmed[0] != '#':
+				inBlock = false
+			}
+		}
+
+		comment := yamlCommentStart(line, &quote)
+		code := line
+		if comment >= 0 {
+			code = line[:comment]
+			part, err := envsubst.Bytes(raw[segmentStart : lineStart+comment])
+			if err != nil {
+				return nil, fmt.Errorf("envsubst.Bytes: %w", err)
+			}
+			expanded = append(expanded, part...)
+			expanded = append(expanded, raw[lineStart+comment:nextLine]...)
+			segmentStart = nextLine
+		}
+		if quote == 0 {
+			if explicitIndent, ok := blockScalarHeader(code); ok {
+				inBlock = true
+				headerIndent = indent
+				blockIndent = 0
+				if explicitIndent > 0 {
+					blockIndent = headerIndent + explicitIndent
+				}
+			}
+		}
+		lineStart = nextLine
+	}
+	part, err := envsubst.Bytes(raw[segmentStart:])
+	if err != nil {
+		return nil, fmt.Errorf("envsubst.Bytes: %w", err)
+	}
+	expanded = append(expanded, part...)
+	return expanded, nil
+}
+
+func yamlCommentStart(line []byte, quote *byte) int {
+	for i := 0; i < len(line); i++ {
+		switch *quote {
+		case '\'':
+			if line[i] == '\'' {
+				if i+1 < len(line) && line[i+1] == '\'' {
+					i++
+				} else {
+					*quote = 0
+				}
+			}
+		case '"':
+			switch line[i] {
+			case '\\':
+				i++
+			case '"':
+				*quote = 0
+			}
+		default:
+			switch line[i] {
+			case '\'', '"':
+				if yamlQuoteStarts(line[:i]) {
+					*quote = line[i]
+				}
+			case '#':
+				if i == 0 || line[i-1] == ' ' || line[i-1] == '\t' {
+					return i
+				}
+			}
+		}
+	}
+	return -1
+}
+
+func yamlQuoteStarts(prefix []byte) bool {
+	prefix = bytes.TrimRight(prefix, " \t")
+	if len(prefix) == 0 {
+		return true
+	}
+	switch prefix[len(prefix)-1] {
+	case ':', '-', '[', '{', ',':
+		return true
+	default:
+		return false
+	}
+}
+
+func blockScalarHeader(code []byte) (int, bool) {
+	code = bytes.TrimSpace(code)
+	separator := bytes.LastIndexByte(code, ':')
+	if separator < 0 && len(code) > 1 && code[0] == '-' && (code[1] == ' ' || code[1] == '\t') {
+		separator = 0
+	}
+	if separator < 0 {
+		return 0, false
+	}
+	value := bytes.TrimSpace(code[separator+1:])
+	if len(value) == 0 || (value[0] != '|' && value[0] != '>') {
+		return 0, false
+	}
+	indent := 0
+	for _, indicator := range value[1:] {
+		switch {
+		case indicator == '+' || indicator == '-':
+		case indicator >= '1' && indicator <= '9' && indent == 0:
+			indent = int(indicator - '0')
+		default:
+			return 0, false
+		}
+	}
+	return indent, true
+}
+
+func leadingSpaces(line []byte) int {
+	for i, b := range line {
+		if b != ' ' {
+			return i
+		}
+	}
+	return len(line)
+}
diff --git a/internal/config/v1/environment_test.go b/internal/config/v1/environment_test.go
new file mode 100644
index 00000000..8739c692
--- /dev/null
+++ b/internal/config/v1/environment_test.go
@@ -0,0 +1,317 @@
+package v1
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/config"
+)
+
+func TestParseGenerateEnvironmentVariables(t *testing.T) {
+	// Environment changes affect the whole process, so these cases cannot run in parallel.
+	tests := []struct {
+		name       string
+		config     string
+		variable   string
+		value      string
+		wantOut    string
+		wantOption string
+		wantError  string
+	}{
+		{
+			name:     "expands a set variable",
+			config:   "plugins:\n  - name: go\n    out: ${EASYP_TEST_OUTPUT}\n",
+			variable: "EASYP_TEST_OUTPUT",
+			value:    "gen/go",
+			wantOut:  "gen/go",
+		},
+		{
+			name:     "uses a default for an empty variable",
+			config:   "plugins:\n  - name: go\n    out: ${EASYP_TEST_OUTPUT:-gen/default}\n",
+			variable: "EASYP_TEST_OUTPUT",
+			value:    "",
+			wantOut:  "gen/default",
+		},
+		{
+			name:       "keeps escaped variables literal",
+			config:     "plugins:\n  - name: go\n    out: gen\n    opts:\n      suffix: $${EASYP_TEST_OUTPUT}\n",
+			variable:   "EASYP_TEST_OUTPUT",
+			value:      "expanded",
+			wantOut:    "gen",
+			wantOption: "${EASYP_TEST_OUTPUT}",
+		},
+		{
+			name:      "rejects malformed substitution",
+			config:    "plugins:\n  - name: go\n    out: ${EASYP_TEST_OUTPUT\n",
+			wantError: "envsubst",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			if tt.variable != "" {
+				t.Setenv(tt.variable, tt.value)
+			}
+
+			got, err := ParseGenerate(strings.NewReader(tt.config))
+
+			if tt.wantError != "" {
+				require.ErrorContains(t, err, tt.wantError)
+				return
+			}
+			require.NoError(t, err)
+			require.Len(t, got.Plugins, 1)
+			assert.Equal(t, tt.wantOut, got.Plugins[0].Out)
+			if tt.wantOption != "" {
+				assert.Equal(t, []string{tt.wantOption}, got.Plugins[0].Opts["suffix"])
+			}
+		})
+	}
+}
+
+func TestParsePolicyEnvironmentVariables(t *testing.T) {
+	// Environment changes affect the whole process, so these cases cannot run in parallel.
+	tests := []struct {
+		name       string
+		config     string
+		variable   string
+		value      string
+		wantPreset string
+	}{
+		{
+			name:       "expands the linter preset",
+			config:     "linters:\n  default: ${EASYP_TEST_PRESET}\n",
+			variable:   "EASYP_TEST_PRESET",
+			value:      "MINIMAL",
+			wantPreset: "MINIMAL",
+		},
+		{
+			name:       "uses the default preset when empty",
+			config:     "linters:\n  default: ${EASYP_TEST_PRESET:-BASIC}\n",
+			variable:   "EASYP_TEST_PRESET",
+			value:      "",
+			wantPreset: "BASIC",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Setenv(tt.variable, tt.value)
+
+			got, err := ParsePolicy(strings.NewReader(tt.config))
+
+			require.NoError(t, err)
+			assert.Equal(t, tt.wantPreset, got.Linters.Default)
+		})
+	}
+}
+
+func TestValidateFileExpandsEnvironmentVariables(t *testing.T) {
+	// Environment changes affect the whole process, so these cases cannot run in parallel.
+	tests := []struct {
+		name     string
+		filename string
+		config   string
+		variable string
+		value    string
+		wantCode string
+	}{
+		{
+			name:     "generator uses expanded plugin output",
+			filename: GenerateFile,
+			config:   "plugins:\n  - name: go\n    out: ${EASYP_TEST_OUTPUT}\n",
+			variable: "EASYP_TEST_OUTPUT",
+			value:    "gen/go",
+		},
+		{
+			name:     "policy validates expanded preset",
+			filename: PolicyFile,
+			config:   "linters:\n  default: ${EASYP_TEST_PRESET}\n",
+			variable: "EASYP_TEST_PRESET",
+			value:    "MINIMAL",
+		},
+		{
+			name:     "invalid expanded preset is reported",
+			filename: PolicyFile,
+			config:   "linters:\n  default: ${EASYP_TEST_PRESET}\n",
+			variable: "EASYP_TEST_PRESET",
+			value:    "INVALID",
+			wantCode: "yaml_validation",
+		},
+		{
+			name:     "malformed substitution is reported",
+			filename: GenerateFile,
+			config:   "plugins:\n  - name: go\n    out: ${EASYP_TEST_OUTPUT\n",
+			variable: "EASYP_TEST_OUTPUT",
+			value:    "gen/go",
+			wantCode: "v1_validation",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Setenv(tt.variable, tt.value)
+			path := filepath.Join(t.TempDir(), tt.filename)
+			require.NoError(t, os.WriteFile(path, []byte(tt.config), 0o644))
+
+			issues, err := ValidateFile(path)
+
+			require.NoError(t, err)
+			if tt.wantCode == "" {
+				assert.Empty(t, issues)
+				return
+			}
+			require.True(t, config.HasErrors(issues))
+			assert.Equal(t, tt.wantCode, issues[0].Code)
+		})
+	}
+}
+
+func TestParseGenerateEnvironmentComments(t *testing.T) {
+	// Environment changes affect the whole process, so these cases cannot run in parallel.
+	tests := []struct {
+		name       string
+		config     string
+		wantOut    string
+		wantOption string
+		wantError  string
+	}{
+		{
+			name: "full-line and trailing comments are ignored",
+			config: `# ${BROKEN
+plugins:
+  - name: go # ${BROKEN
+    out: ${EASYP_TEST_OUTPUT} # ${BROKEN
+`,
+			wantOut: "gen/go",
+		},
+		{
+			name: "quoted hash remains part of a value",
+			config: `plugins:
+  - name: go
+    out: gen
+    opts:
+      suffix: "prefix #${EASYP_TEST_OUTPUT}" # ${BROKEN
+`,
+			wantOut:    "gen",
+			wantOption: "prefix #gen/go",
+		},
+		{
+			name: "plain apostrophe does not hide a trailing comment",
+			config: `plugins:
+  - name: go
+    out: gen
+    opts:
+      suffix: it's okay # ${BROKEN
+`,
+			wantOut:    "gen",
+			wantOption: "it's okay",
+		},
+		{
+			name: "multiline quoted value is not a block scalar",
+			config: `plugins:
+  - name: go
+    out: gen
+    opts:
+      suffix: "start: |
+        # ${EASYP_TEST_OUTPUT}"
+      other: okay # ${BROKEN
+`,
+			wantOut:    "gen",
+			wantOption: "start: | # gen/go",
+		},
+		{
+			name: "plain hash without preceding space remains part of a value",
+			config: `plugins:
+  - name: go
+    out: gen/#${EASYP_TEST_OUTPUT} # ${BROKEN
+`,
+			wantOut: "gen/#gen/go",
+		},
+		{
+			name: "hash in a block scalar remains part of a value",
+			config: `plugins:
+  - name: go
+    out: gen
+    opts:
+      suffix: | # ${BROKEN
+        # ${EASYP_TEST_OUTPUT}
+`,
+			wantOut:    "gen",
+			wantOption: "# gen/go\n",
+		},
+		{
+			name: "malformed substitution in a block scalar still fails",
+			config: `plugins:
+  - name: go
+    out: gen
+    opts:
+      suffix: |
+        # ${BROKEN
+`,
+			wantError: "envsubst",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Setenv("EASYP_TEST_OUTPUT", "gen/go")
+
+			got, err := ParseGenerate(strings.NewReader(tt.config))
+
+			if tt.wantError != "" {
+				require.ErrorContains(t, err, tt.wantError)
+				return
+			}
+			require.NoError(t, err)
+			require.Len(t, got.Plugins, 1)
+			assert.Equal(t, tt.wantOut, got.Plugins[0].Out)
+			if tt.wantOption != "" {
+				assert.Equal(t, []string{tt.wantOption}, got.Plugins[0].Opts["suffix"])
+			}
+		})
+	}
+}
+
+func TestValidateFileIgnoresCommentSubstitutions(t *testing.T) {
+	// Environment changes affect the whole process, so these cases cannot run in parallel.
+	tests := []struct {
+		name     string
+		filename string
+		config   string
+	}{
+		{
+			name:     "policy",
+			filename: PolicyFile,
+			config:   "# ${BROKEN\nlinters:\n  default: MINIMAL # ${BROKEN\n",
+		},
+		{
+			name:     "generator",
+			filename: GenerateFile,
+			config:   "# ${BROKEN\nplugins:\n  - name: go\n    out: ${EASYP_TEST_OUTPUT} # ${BROKEN\n",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Setenv("EASYP_TEST_OUTPUT", "gen/go")
+			path := filepath.Join(t.TempDir(), tt.filename)
+			require.NoError(t, os.WriteFile(path, []byte(tt.config), 0o644))
+
+			issues, err := ValidateFile(path)
+
+			require.NoError(t, err)
+			assert.Empty(t, issues)
+		})
+	}
+}
diff --git a/internal/config/v1/files.go b/internal/config/v1/files.go
new file mode 100644
index 00000000..6eec1fba
--- /dev/null
+++ b/internal/config/v1/files.go
@@ -0,0 +1,9 @@
+package v1
+
+// Standard v1 configuration filenames shared by readers and commands.
+const (
+	ModuleFile   = "protobuf.mod"
+	LockFile     = "protobuf.lock"
+	PolicyFile   = "easyp.yaml"
+	GenerateFile = "easyp.gen.yaml"
+)
diff --git a/internal/config/v1/generate.go b/internal/config/v1/generate.go
new file mode 100644
index 00000000..d1142cb1
--- /dev/null
+++ b/internal/config/v1/generate.go
@@ -0,0 +1,76 @@
+package v1
+
+import (
+	"bytes"
+	"fmt"
+	"io"
+
+	"gopkg.in/yaml.v3"
+
+	"github.com/easyp-tech/easyp/internal/config"
+)
+
+// Generate is the consumer-side v1 file. Producer policy and legacy inputs
+// remain outside this file; managed descriptor options retain their v0 shape.
+type Generate struct {
+	Version                  string          `yaml:"version"`
+	InheritedGoPackagePrefix bool            `yaml:"-"`
+	Generate                 GenerateTargets `yaml:"generate"`
+	Plugins                  []Plugin        `yaml:"plugins"`
+	Options                  GenerateOptions `yaml:"options"`
+}
+
+// GenerateTargets selects modules and their managed descriptor options.
+type GenerateTargets struct {
+	Modules  []string           `yaml:"modules"`
+	Packages []string           `yaml:"packages"`
+	Managed  config.ManagedMode `yaml:"managed"`
+}
+
+// GenerateOptions contains language-specific generation settings.
+type GenerateOptions struct {
+	Go GoOptions `yaml:"go"`
+}
+
+// GoOptions controls the Go package prefix. A nil prefix allows inheritance.
+type GoOptions struct {
+	PackagePrefix *string `yaml:"package_prefix"`
+}
+
+// ParseGenerate reads and validates a v1 generation configuration.
+func ParseGenerate(r io.Reader) (Generate, error) {
+	raw, err := expandConfigYAML(r)
+	if err != nil {
+		return Generate{}, fmt.Errorf("expandConfigYAML: %w", err)
+	}
+	var result Generate
+	decoder := yaml.NewDecoder(bytes.NewReader(raw))
+	decoder.KnownFields(true)
+	if err := decoder.Decode(&result); err != nil {
+		return Generate{}, fmt.Errorf("decode easyp.gen.yaml: %w", err)
+	}
+	if err := requireSingleYAMLDocument(decoder, GenerateFile); err != nil {
+		return Generate{}, err
+	}
+	if result.Version == "" {
+		result.Version = "v1"
+	}
+	if result.Version != "v1" {
+		return Generate{}, fmt.Errorf("easyp.gen.yaml version must be v1")
+	}
+	if err := ValidatePackageSelectors(result.Generate.Packages); err != nil {
+		return Generate{}, err
+	}
+	if err := result.Generate.Managed.Validate(); err != nil {
+		return Generate{}, fmt.Errorf("generate.managed: %w", err)
+	}
+	for i, plugin := range result.Plugins {
+		if err := plugin.Validate(); err != nil {
+			return Generate{}, fmt.Errorf("plugins[%d]: %w", i, err)
+		}
+	}
+	if err := yamlValidationError(GenerateFile, validateExpandedV1YAML(raw, generateSchema)); err != nil {
+		return Generate{}, err
+	}
+	return result, nil
+}
diff --git a/internal/config/v1/generate_test.go b/internal/config/v1/generate_test.go
new file mode 100644
index 00000000..90079e7f
--- /dev/null
+++ b/internal/config/v1/generate_test.go
@@ -0,0 +1,74 @@
+package v1
+
+import (
+	"strings"
+	"testing"
+)
+
+func TestParseGenerate(t *testing.T) {
+	got, err := ParseGenerate(strings.NewReader(`version: v1
+generate:
+  modules: [proto/user]
+plugins:
+  - name: go
+    out: ./gen/go
+    opts:
+      paths: source_relative
+options:
+  go:
+    package_prefix: github.com/acme/gen/go
+`))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if got.Generate.Modules[0] != "proto/user" || got.Plugins[0].Name != "go" || got.Options.Go.PackagePrefix == nil || *got.Options.Go.PackagePrefix != "github.com/acme/gen/go" {
+		t.Fatalf("unexpected generator: %#v", got)
+	}
+}
+
+func TestParseGenerateRejectsLegacyInputs(t *testing.T) {
+	_, err := ParseGenerate(strings.NewReader("version: v1\ngenerate:\n  inputs: []\nplugins:\n  - name: python\n    out: ./gen\n"))
+	if err == nil {
+		t.Fatal("v1 must not accept generate.inputs")
+	}
+}
+
+func TestParseGenerateRejectsInvalidManagedRule(t *testing.T) {
+	_, err := ParseGenerate(strings.NewReader("version: v1\ngenerate:\n  managed:\n    enabled: true\n    override:\n      - file_option: go_package_prefix\n"))
+	if err == nil {
+		t.Fatal("managed override without a value was accepted")
+	}
+}
+
+func TestParseGenerateListOptions(t *testing.T) {
+	got, err := ParseGenerate(strings.NewReader("version: v1\nplugins:\n  - name: go\n    out: ./gen\n    opts: [paths=source_relative]\n"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if got.Plugins[0].Opts["paths"][0] != "source_relative" {
+		t.Fatalf("unexpected opts: %#v", got.Plugins[0].Opts)
+	}
+}
+
+func TestParseGenerateDefaultsVersion(t *testing.T) {
+	got, err := ParseGenerate(strings.NewReader("plugins:\n  - name: python\n    out: ./gen\n"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if got.Version != "v1" {
+		t.Fatalf("version = %q", got.Version)
+	}
+}
+
+func TestRemotePluginRequiresPinnedVersion(t *testing.T) {
+	if _, err := ParseGenerate(strings.NewReader("version: v1\nplugins:\n  - remote: localhost:8080/python\n    out: gen\n")); err == nil {
+		t.Fatal("unpinned remote plugin was accepted")
+	}
+	got, err := ParseGenerate(strings.NewReader("version: v1\nplugins:\n  - remote: localhost:8080/python\n    version: v1.2.3\n    out: gen\n"))
+	if err != nil || got.Plugins[0].Version != "v1.2.3" {
+		t.Fatalf("pinned remote plugin rejected: %v, %#v", err, got)
+	}
+	if _, err := ParseGenerate(strings.NewReader("version: v1\nplugins:\n  - name: python\n    version: v1.2.3\n    out: gen\n")); err == nil {
+		t.Fatal("unverifiable local plugin version was accepted")
+	}
+}
diff --git a/internal/config/v1/issue_path_matcher.go b/internal/config/v1/issue_path_matcher.go
new file mode 100644
index 00000000..6772a859
--- /dev/null
+++ b/internal/config/v1/issue_path_matcher.go
@@ -0,0 +1,111 @@
+package v1
+
+import (
+	"fmt"
+	"io/fs"
+	"path"
+	"strings"
+	"unicode/utf8"
+)
+
+// issuePathMatcher is deliberately limited to issues.exclude-rules.path.
+// Other config paths retain their existing semantics.
+type issuePathMatcher struct {
+	pattern  string
+	segments []string
+	literal  bool
+}
+
+func newIssuePathMatcher(pattern string) (issuePathMatcher, error) {
+	if !utf8.ValidString(pattern) || strings.ContainsAny(pattern, "\\:\x00") || strings.HasPrefix(pattern, "/") {
+		return issuePathMatcher{}, fmt.Errorf("expected a portable relative path pattern: %q", pattern)
+	}
+	if strings.Contains(pattern, "//") {
+		return issuePathMatcher{}, fmt.Errorf("empty path segment in %q", pattern)
+	}
+	pattern = strings.TrimPrefix(pattern, "./")
+	pattern = strings.TrimSuffix(pattern, "/")
+	if pattern == "." || pattern == "" {
+		pattern = "**"
+	}
+	segments := strings.Split(pattern, "/")
+	for _, segment := range segments {
+		if segment == "" || segment == "." || segment == ".." {
+			return issuePathMatcher{}, fmt.Errorf("empty, dot, or traversing path segment in %q", pattern)
+		}
+		if segment == "**" {
+			continue
+		}
+		if strings.Contains(segment, "**") {
+			return issuePathMatcher{}, fmt.Errorf("** must be a complete path segment in %q", pattern)
+		}
+		_, err := path.Match(segment, "")
+		if err != nil {
+			return issuePathMatcher{}, fmt.Errorf("Match: %w", err)
+		}
+	}
+	return issuePathMatcher{pattern: pattern, segments: segments, literal: !strings.ContainsAny(pattern, "*?[")}, nil
+}
+
+func (m issuePathMatcher) matches(relativePath string) bool {
+	if !fs.ValidPath(relativePath) || strings.ContainsAny(relativePath, "\\:\x00") {
+		return false
+	}
+	if m.literal {
+		return relativePath == m.pattern || (!strings.HasSuffix(m.pattern, ".proto") && strings.HasPrefix(relativePath, m.pattern+"/"))
+	}
+	// Match complete segments. Dynamic programming bounds the work even when
+	// several globstars can consume the same directories.
+	segments := strings.Split(relativePath, "/")
+	matched := make([]bool, len(segments)+1)
+	matched[0] = true
+	for _, pattern := range m.segments {
+		next := make([]bool, len(matched))
+		if pattern == "**" {
+			next[0] = matched[0]
+			for i := range segments {
+				next[i+1] = matched[i+1] || next[i]
+			}
+		} else {
+			for i, segment := range segments {
+				// Syntax was validated at construction.
+				ok, _ := path.Match(pattern, segment)
+				next[i+1] = matched[i] && ok
+			}
+		}
+		matched = next
+	}
+	return matched[len(segments)]
+}
+
+func (p IssuePolicy) validatePaths() error {
+	for i, rule := range p.ExcludeRules {
+		_, err := newIssuePathMatcher(rule.Path)
+		if err != nil {
+			return fmt.Errorf("issues.exclude-rules[%d].path: %w", i, err)
+		}
+	}
+	return nil
+}
+
+// ExclusionsForPath selects exclusions for a slash-separated path relative to
+// the policy file supplying the effective issues section. An empty linter list
+// suppresses the whole file; pathless rules apply to every file in the policy.
+func (p IssuePolicy) ExclusionsForPath(relativePath string) ([]string, bool, error) {
+	var linters []string
+	var all bool
+	for i, rule := range p.ExcludeRules {
+		matcher, err := newIssuePathMatcher(rule.Path)
+		if err != nil {
+			return nil, false, fmt.Errorf("issues.exclude-rules[%d].path: %w", i, err)
+		}
+		if rule.Path != "" && !matcher.matches(relativePath) {
+			continue
+		}
+		if len(rule.Linters) == 0 {
+			all = true
+		}
+		linters = append(linters, rule.Linters...)
+	}
+	return linters, all, nil
+}
diff --git a/internal/config/v1/issue_path_matcher_test.go b/internal/config/v1/issue_path_matcher_test.go
new file mode 100644
index 00000000..ded21c50
--- /dev/null
+++ b/internal/config/v1/issue_path_matcher_test.go
@@ -0,0 +1,103 @@
+package v1
+
+import (
+	"fmt"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestIssuePathMatcher(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name, pattern, file string
+		want                bool
+	}{
+		{name: "directory", pattern: "generated", file: "generated/nested/a.proto", want: true},
+		{name: "directory_boundary", pattern: "generated", file: "generated_other/a.proto"},
+		{name: "literal_file", pattern: "generated/a.proto", file: "generated/a.proto", want: true},
+		{name: "file_boundary", pattern: "generated/a.proto", file: "generated/a.proto/b.proto"},
+		{name: "star", pattern: "generated/*.proto", file: "generated/a.proto", want: true},
+		{name: "star_no_separator", pattern: "generated/*.proto", file: "generated/nested/a.proto"},
+		{name: "question", pattern: "a?.proto", file: "ab.proto", want: true},
+		{name: "question_one_character", pattern: "a?.proto", file: "abc.proto"},
+		{name: "class", pattern: "[a-c].proto", file: "b.proto", want: true},
+		{name: "negated_class", pattern: "[^a-c].proto", file: "d.proto", want: true},
+		{name: "globstar_zero", pattern: "api/**/a.proto", file: "api/a.proto", want: true},
+		{name: "globstar_many", pattern: "api/**/a.proto", file: "api/x/y/a.proto", want: true},
+		{name: "globstar_suffix", pattern: "api/**", file: "api/x/y/a.proto", want: true},
+		{name: "globstar_prefix", pattern: "**/*.proto", file: "a.proto", want: true},
+		{name: "multiple_globstars", pattern: "**/x/**/a.proto", file: "one/x/two/three/a.proto", want: true},
+		{name: "anchored", pattern: "api/**", file: "other/api/a.proto"},
+		{name: "normalized_directory", pattern: "./generated/", file: "generated/a.proto", want: true},
+		{name: "outside_source", pattern: "**", file: "../a.proto"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			matcher, err := newIssuePathMatcher(tt.pattern)
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, matcher.matches(tt.file))
+		})
+	}
+}
+
+func TestIssuePathValidation(t *testing.T) {
+	t.Parallel()
+	tests := []struct{ name, pattern string }{
+		{name: "absolute", pattern: "/tmp/*.proto"},
+		{name: "windows_absolute", pattern: `C:\temp\*.proto`},
+		{name: "windows_drive", pattern: "C:temp/*.proto"},
+		{name: "backslash", pattern: `api\*.proto`},
+		{name: "parent", pattern: "../*.proto"},
+		{name: "internal_parent", pattern: "api/../*.proto"},
+		{name: "glob_parent", pattern: "**/../*.proto"},
+		{name: "class", pattern: "api/[abc.proto"},
+		{name: "empty_class", pattern: "api/[].proto"},
+		{name: "partial_globstar", pattern: "api/a**/*.proto"},
+		{name: "triple_star", pattern: "api/***/*.proto"},
+		{name: "empty_segment", pattern: "api//*.proto"},
+		{name: "empty_root_segment", pattern: ".//"},
+		{name: "nul", pattern: "api/\x00.proto"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			_, err := ParsePolicy(strings.NewReader(fmt.Sprintf("version: v1\nissues:\n  exclude-rules:\n    - path: %q\n", tt.pattern)))
+			require.ErrorContains(t, err, "issues.exclude-rules[0].path")
+			_, err = (Policy{Issues: IssuePolicy{ExcludeRules: []IssueExcludeRule{{Path: tt.pattern}}}}).LintConfig()
+			require.ErrorContains(t, err, "issues.exclude-rules[0].path")
+		})
+	}
+}
+
+func TestIssueExclusionsForPath(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name        string
+		rules       []IssueExcludeRule
+		wantLinters []string
+		wantAll     bool
+	}{
+		{name: "omitted_linters", rules: []IssueExcludeRule{{Path: "api/**"}}, wantAll: true},
+		{name: "empty_linters", rules: []IssueExcludeRule{{Path: "api/**", Linters: []string{}}}, wantAll: true},
+		{name: "pathless_all", rules: []IssueExcludeRule{{}}, wantAll: true},
+		{name: "named_rules_and_groups", rules: []IssueExcludeRule{{Path: "api/**", Linters: []string{"MINIMAL", "FILE_LOWER_SNAKE_CASE"}}}, wantLinters: []string{"MINIMAL", "FILE_LOWER_SNAKE_CASE"}},
+		{name: "unmatched", rules: []IssueExcludeRule{{Path: "other/**"}}},
+		{name: "pathless_named", rules: []IssueExcludeRule{{Linters: []string{"BASIC"}}}, wantLinters: []string{"BASIC"}},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			policy := Policy{Issues: IssuePolicy{ExcludeRules: tt.rules}}
+			_, err := policy.LintConfig()
+			require.NoError(t, err)
+			linters, all, err := policy.Issues.ExclusionsForPath("api/a.proto")
+			require.NoError(t, err)
+			assert.Equal(t, tt.wantLinters, linters)
+			assert.Equal(t, tt.wantAll, all)
+		})
+	}
+}
diff --git a/internal/config/v1/legacy_detection.go b/internal/config/v1/legacy_detection.go
new file mode 100644
index 00000000..6c059f94
--- /dev/null
+++ b/internal/config/v1/legacy_detection.go
@@ -0,0 +1,46 @@
+package v1
+
+import (
+	"errors"
+	"fmt"
+	"io"
+
+	"gopkg.in/yaml.v3"
+)
+
+// ErrLegacyConfiguration gives a consistent, non-writing migration entry point.
+var ErrLegacyConfiguration = errors.New("legacy EasyP configuration detected; run easyp migrate --module <identity> to preview conversion to v1")
+
+// LegacyPolicy identifies unversioned v0 documents without expanding values.
+func LegacyPolicy(raw []byte) bool {
+	var document yaml.Node
+	err := yaml.Unmarshal(raw, &document)
+	if err != nil || len(document.Content) != 1 || document.Content[0].Kind != yaml.MappingNode {
+		return false
+	}
+	mapping := document.Content[0]
+	legacy := false
+	for i := 0; i+1 < len(mapping.Content); i += 2 {
+		key, value := mapping.Content[i], mapping.Content[i+1]
+		if key.Value == "version" && value.Value == "v1" {
+			return false
+		}
+		switch key.Value {
+		case "lint", "deps", "generate", "breaking_check":
+			legacy = true
+		}
+	}
+	return legacy
+}
+
+func requireSingleYAMLDocument(decoder *yaml.Decoder, name string) error {
+	var extra any
+	err := decoder.Decode(&extra)
+	if errors.Is(err, io.EOF) {
+		return nil
+	}
+	if err != nil {
+		return fmt.Errorf("Decode: %w", err)
+	}
+	return fmt.Errorf("%s must contain one YAML document", name)
+}
diff --git a/internal/config/v1/lint_selection.go b/internal/config/v1/lint_selection.go
new file mode 100644
index 00000000..34ea7a75
--- /dev/null
+++ b/internal/config/v1/lint_selection.go
@@ -0,0 +1,31 @@
+package v1
+
+import (
+	"errors"
+	"fmt"
+
+	"github.com/easyp-tech/easyp/internal/rules"
+)
+
+func (p Policy) validateLintSelections() error {
+	var issues []error
+	for _, selection := range []struct {
+		path  string
+		names []string
+	}{
+		{path: "linters.enable", names: p.Linters.Enable},
+		{path: "linters.disable", names: p.Linters.Disable},
+	} {
+		err := rules.ValidateNames(selection.names)
+		if err != nil {
+			issues = append(issues, fmt.Errorf("%s: %w", selection.path, err))
+		}
+	}
+	for i, exclusion := range p.Issues.ExcludeRules {
+		err := rules.ValidateNames(exclusion.Linters)
+		if err != nil {
+			issues = append(issues, fmt.Errorf("issues.exclude-rules[%d].linters: %w", i, err))
+		}
+	}
+	return errors.Join(issues...)
+}
diff --git a/internal/config/v1/lint_selection_test.go b/internal/config/v1/lint_selection_test.go
new file mode 100644
index 00000000..9e5ecb0d
--- /dev/null
+++ b/internal/config/v1/lint_selection_test.go
@@ -0,0 +1,77 @@
+package v1
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	"github.com/easyp-tech/easyp/internal/rules"
+)
+
+func TestLintSelectionValidationCollectsAllLocations(t *testing.T) {
+	t.Parallel()
+	const raw = "version: v1\nlinters:\n  enable: [NO_SUCH_RULE, PACKAGE_NO_IMPORT_CYCLE]\n  disable: [NOT_A_RULE]\nissues:\n  exclude-rules:\n    - linters: [UNKNOWN_EXCLUSION]\n"
+	issues := ValidatePolicyYAML([]byte(raw))
+	require.Len(t, issues, 4)
+	for _, issue := range issues {
+		assert.Equal(t, config.SeverityError, issue.Severity)
+		assert.Positive(t, issue.Line)
+		assert.Positive(t, issue.Column)
+	}
+	path := filepath.Join(t.TempDir(), PolicyFile)
+	require.NoError(t, os.WriteFile(path, []byte(raw), 0o644))
+	fileIssues, err := ValidateFile(path)
+	require.NoError(t, err)
+	assert.Equal(t, issues, fileIssues)
+	_, err = ParsePolicy(strings.NewReader(raw))
+	for _, name := range []string{"NO_SUCH_RULE", "PACKAGE_NO_IMPORT_CYCLE", "NOT_A_RULE", "UNKNOWN_EXCLUSION"} {
+		require.ErrorContains(t, err, name)
+	}
+}
+
+func TestLintSelectionValidationMatchesRuntimeCatalog(t *testing.T) {
+	t.Parallel()
+	tests := []struct{ name, key string }{{name: "enabled", key: "enable"}, {name: "disabled", key: "disable"}}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			for _, name := range rules.AllLintUseValues() {
+				raw := "version: v1\nlinters:\n  " + tt.key + ": [" + name + "]\n"
+				assert.Empty(t, ValidatePolicyYAML([]byte(raw)), name)
+				policy, err := ParsePolicy(strings.NewReader(raw))
+				require.NoError(t, err, name)
+				cfg, err := policy.LintConfig()
+				require.NoError(t, err, name)
+				_, _, err = rules.New(cfg)
+				require.NoError(t, err, name)
+			}
+		})
+	}
+	data, err := SchemaJSON("easyp")
+	require.NoError(t, err)
+	assert.NotContains(t, string(data), "PACKAGE_NO_IMPORT_CYCLE")
+}
+
+func TestProgrammaticLintPolicyRejectsInvalidNames(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name   string
+		policy Policy
+	}{
+		{name: "enable", policy: Policy{Linters: LinterPolicy{Enable: []string{"NO_SUCH_RULE"}}}},
+		{name: "disable", policy: Policy{Linters: LinterPolicy{Disable: []string{"NO_SUCH_RULE"}}}},
+		{name: "exclusion", policy: Policy{Issues: IssuePolicy{ExcludeRules: []IssueExcludeRule{{Linters: []string{"NO_SUCH_RULE"}}}}}},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			_, err := tt.policy.LintConfig()
+			require.ErrorContains(t, err, "NO_SUCH_RULE")
+		})
+	}
+}
diff --git a/internal/config/v1/lock.go b/internal/config/v1/lock.go
new file mode 100644
index 00000000..a5eba872
--- /dev/null
+++ b/internal/config/v1/lock.go
@@ -0,0 +1,106 @@
+package v1
+
+import (
+	"encoding/base64"
+	"encoding/hex"
+	"fmt"
+	"io"
+	"strings"
+
+	"golang.org/x/mod/semver"
+	"gopkg.in/yaml.v3"
+)
+
+// Lock is the v1 protobuf.lock document for one protobuf module.
+type Lock struct {
+	Version int            `yaml:"version"`
+	Modules []LockedModule `yaml:"modules"`
+}
+
+// LockedModule identifies one exact Git dependency in protobuf.lock.
+type LockedModule struct {
+	Source  string          `yaml:"source"`
+	Version string          `yaml:"version"`
+	Commit  string          `yaml:"commit"`
+	Hash    string          `yaml:"hash"`
+	BSR     []BSRResolution `yaml:"bsr,omitempty"`
+}
+
+// ParseLock reads and validates a v1 protobuf.lock document.
+func ParseLock(reader io.Reader) (Lock, error) {
+	var lock Lock
+	decoder := yaml.NewDecoder(reader)
+	decoder.KnownFields(true)
+	if err := decoder.Decode(&lock); err != nil {
+		return Lock{}, fmt.Errorf("Decode: %w", err)
+	}
+	var extra any
+	if err := decoder.Decode(&extra); err != io.EOF {
+		if err != nil {
+			return Lock{}, fmt.Errorf("Decode: %w", err)
+		}
+		return Lock{}, fmt.Errorf("protobuf.lock must contain one YAML document")
+	}
+	if err := lock.Validate(); err != nil {
+		return Lock{}, fmt.Errorf("Validate: %w", err)
+	}
+	return lock, nil
+}
+
+// Validate checks the version and integrity fields before a lock is used.
+func (lock Lock) Validate() error {
+	if lock.Version != 1 {
+		return fmt.Errorf("unsupported protobuf.lock version %d", lock.Version)
+	}
+	seen := make(map[string]struct{}, len(lock.Modules))
+	for _, entry := range lock.Modules {
+		if entry.Source == "" || entry.Commit == "" || entry.Hash == "" {
+			return fmt.Errorf("incomplete lock entry for %q", entry.Source)
+		}
+		if _, exists := seen[entry.Source]; exists {
+			return fmt.Errorf("duplicate locked module %s", entry.Source)
+		}
+		seen[entry.Source] = struct{}{}
+		if err := ValidateModuleVersion(entry.Source, entry.Version); err != nil {
+			return fmt.Errorf("ValidateModuleVersion: %w", err)
+		}
+		if !semver.IsValid(entry.Version) && !IsCommitRef(entry.Version) {
+			return fmt.Errorf("%s: invalid locked version %q", entry.Source, entry.Version)
+		}
+		if !IsCommitRef(entry.Commit) {
+			return fmt.Errorf("%s: invalid commit %q", entry.Source, entry.Commit)
+		}
+		if IsCommitRef(entry.Version) && !strings.EqualFold(entry.Version, entry.Commit) {
+			return fmt.Errorf("%s: pinned version %q differs from commit %q", entry.Source, entry.Version, entry.Commit)
+		}
+		if !strings.HasPrefix(entry.Hash, "h1:") {
+			return fmt.Errorf("%s: invalid content hash %q", entry.Source, entry.Hash)
+		}
+		digest, err := base64.StdEncoding.DecodeString(strings.TrimPrefix(entry.Hash, "h1:"))
+		if err != nil || len(digest) != 32 {
+			return fmt.Errorf("%s: invalid content hash %q", entry.Source, entry.Hash)
+		}
+		origins := make(map[string]bool, len(entry.BSR))
+		for _, binding := range entry.BSR {
+			if err := binding.Validate(); err != nil {
+				return fmt.Errorf("Validate: %s: %w", entry.Source, err)
+			}
+			origin := binding.Dependency.Config + ":" + binding.Dependency.Module
+			if origins[origin] {
+				return fmt.Errorf("duplicate BSR binding for %s in %s", binding.Dependency.Module, binding.Dependency.Config)
+			}
+			origins[origin] = true
+		}
+	}
+	return nil
+}
+
+func isHex(value string) bool {
+	_, err := hex.DecodeString(value)
+	return err == nil
+}
+
+// IsCommitRef reports whether value is an unambiguous full Git commit hash.
+func IsCommitRef(value string) bool {
+	return (len(value) == 40 || len(value) == 64) && isHex(value)
+}
diff --git a/internal/config/v1/lock_test.go b/internal/config/v1/lock_test.go
new file mode 100644
index 00000000..d807fa6a
--- /dev/null
+++ b/internal/config/v1/lock_test.go
@@ -0,0 +1,21 @@
+package v1
+
+import (
+	"strings"
+	"testing"
+)
+
+func TestLockRejectsCommitVersionThatDiffersFromPinnedCommit(t *testing.T) {
+	commit := strings.Repeat("a", 40)
+	lock := Lock{Version: 1, Modules: []LockedModule{{
+		Source: "example.com/foo", Version: commit, Commit: commit,
+		Hash: "h1:" + strings.Repeat("A", 43) + "=",
+	}}}
+	if err := lock.Validate(); err != nil {
+		t.Fatal(err)
+	}
+	lock.Modules[0].Commit = strings.Repeat("b", 40)
+	if err := lock.Validate(); err == nil || !strings.Contains(err.Error(), "differs from commit") {
+		t.Fatalf("expected mismatched pinned commit error, got %v", err)
+	}
+}
diff --git a/internal/config/v1/major.go b/internal/config/v1/major.go
new file mode 100644
index 00000000..13c0f303
--- /dev/null
+++ b/internal/config/v1/major.go
@@ -0,0 +1,54 @@
+package v1
+
+import (
+	"fmt"
+	"net/url"
+	"path/filepath"
+	"strings"
+
+	"golang.org/x/mod/module"
+	"golang.org/x/mod/semver"
+)
+
+// ModulePathMajor extracts the Go major suffix from a logical module identity.
+// Transport spelling is preserved: URLs and absolute fixture paths need not be
+// valid Go import paths. Only their logical path participates in this check.
+func ModulePathMajor(source string) (string, error) {
+	logical := filepath.ToSlash(source)
+	if strings.Contains(source, "://") {
+		parsed, err := url.Parse(source)
+		if err != nil {
+			return "", fmt.Errorf("Parse: %w", err)
+		}
+		logical = parsed.Host + parsed.Path
+	}
+	_, major, ok := module.SplitPathVersion(logical)
+	if !ok {
+		return "", fmt.Errorf("module %q has an invalid major version suffix; use an unsuffixed path for v0/v1 or /vN for v2 and later (no leading zeros)", source)
+	}
+	return major, nil
+}
+
+// ValidateModuleVersion checks semantic import versioning without converting
+// identities or versions. Empty versions and full commit pins still check paths.
+func ValidateModuleVersion(source, version string) error {
+	major, err := ModulePathMajor(source)
+	if err != nil {
+		return fmt.Errorf("ModulePathMajor: %w", err)
+	}
+	if semver.Build(version) == "+incompatible" {
+		if major != "" || semver.Major(version) == "v0" || semver.Major(version) == "v1" {
+			return fmt.Errorf("%s@%s: +incompatible requires an unsuffixed v2-or-later legacy module", source, version)
+		}
+		// Metadata provenance is verified on the exact fetched/cached revision.
+		// Structural parsing cannot determine whether a native manifest exists.
+		return nil
+	}
+	if !semver.IsValid(version) {
+		return nil
+	}
+	if err := module.CheckPathMajor(version, major); err != nil {
+		return fmt.Errorf("module %s@%s: %w; select a published /%s module for v2 or later, or an unsuffixed v0/v1 version; update protobuf.mod explicitly (migration never renames sources or versions)", source, version, err, semver.Major(version))
+	}
+	return nil
+}
diff --git a/internal/config/v1/major_test.go b/internal/config/v1/major_test.go
new file mode 100644
index 00000000..5d726ab3
--- /dev/null
+++ b/internal/config/v1/major_test.go
@@ -0,0 +1,64 @@
+package v1
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestMajorManifest(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct {
+		name, source, version string
+		valid                 bool
+	}{
+		{"v0", "example.com/repo", "v0.9.0", true},
+		{"v1", "example.com/repo", "v1.9.0", true},
+		{"v2", "example.com/repo/v2", "v2.0.0", true},
+		{"local", "/tmp/repo/v2", "v2.1.0", true},
+		{"url", "ssh://git@example.com:2222/repo/v2", "v2.0.0", true},
+		{"numeric_subdir", "example.com/repo/2024", "v1.0.0", true},
+		{"v_word", "example.com/repo/v2beta", "v1.0.0", true},
+		{"versionless", "example.com/repo/v2", "", true},
+		{"sha", "example.com/repo/v2", strings.Repeat("a", 40), true},
+		{"missing_suffix", "example.com/repo", "v2.0.0", false},
+		{"wrong_major", "example.com/repo/v2", "v3.0.0", false},
+		{"v0_suffix", "example.com/repo/v0", "", false},
+		{"v1_suffix", "example.com/repo/v1", "", false},
+		{"leading_zero", "example.com/repo/v01", "", false},
+		{"decimal_suffix", "example.com/repo/v2.0", "", false},
+		{"incompatible_v1", "example.com/repo", "v1.0.0+incompatible", false},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			_, err := ParseModule(strings.NewReader("module example.com/app\nrequire " + tt.source + " " + tt.version + "\n"))
+			if tt.valid {
+				require.NoError(t, err)
+			} else {
+				require.Error(t, err)
+			}
+		})
+	}
+	for _, source := range []string{"example.com/repo/v0", "example.com/repo/v1", "example.com/repo/v01"} {
+		_, err := ParseModule(strings.NewReader("module " + source + "\n"))
+		require.Error(t, err)
+		_, err = ParseModule(strings.NewReader("module example.com/app\nreplace " + source + " => ./local\n"))
+		require.Error(t, err)
+	}
+}
+
+func TestMajorLock(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct{ name, source, version string }{
+		{"missing_suffix", "example.com/repo", "v2.0.0"},
+		{"wrong_major", "example.com/repo/v2", "v1.0.0"},
+		{"invalid_suffix", "example.com/repo/v01", strings.Repeat("a", 40)},
+		{"incompatible_suffixed", "example.com/repo/v2", "v2.0.0+incompatible"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			require.Error(t, (Lock{Version: 1, Modules: []LockedModule{{Source: tt.source, Version: tt.version, Commit: strings.Repeat("a", 40), Hash: "h1:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="}}}).Validate())
+		})
+	}
+}
diff --git a/internal/config/v1/managed_validation_test.go b/internal/config/v1/managed_validation_test.go
new file mode 100644
index 00000000..6620f191
--- /dev/null
+++ b/internal/config/v1/managed_validation_test.go
@@ -0,0 +1,189 @@
+package v1
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"google.golang.org/protobuf/proto"
+	"google.golang.org/protobuf/types/descriptorpb"
+	"gopkg.in/yaml.v3"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	"github.com/easyp-tech/easyp/internal/core"
+)
+
+func TestManagedValidationRejectsInvalidRules(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name string
+		rule string
+		path string
+	}{
+		{name: "unknown_file_override", rule: "override: [{file_option: bogus_option, value: example.com/gen}]", path: "override[0].file_option"},
+		{name: "unknown_field_override", rule: "override: [{field_option: json_name, value: name}]", path: "override[0].field_option"},
+		{name: "unknown_file_disable", rule: "disable: [{file_option: bogus_option}]", path: "disable[0].file_option"},
+		{name: "unknown_field_disable", rule: "disable: [{field_option: json_name}]", path: "disable[0].field_option"},
+		{name: "boolean_as_string", rule: "override: [{file_option: java_multiple_files, value: 'true'}]", path: "override[0].value"},
+		{name: "utf8_as_string", rule: "override: [{file_option: java_string_check_utf8, value: 'false'}]", path: "override[0].value"},
+		{name: "arenas_as_number", rule: "override: [{file_option: cc_enable_arenas, value: 1}]", path: "override[0].value"},
+		{name: "string_as_boolean", rule: "override: [{file_option: go_package_prefix, value: false}]", path: "override[0].value"},
+		{name: "string_as_number", rule: "override: [{file_option: java_package, value: 17}]", path: "override[0].value"},
+		{name: "string_as_map", rule: "override: [{file_option: ruby_package, value: {suffix: Foo}}]", path: "override[0].value"},
+		{name: "string_as_list", rule: "override: [{file_option: swift_prefix, value: [Foo]}]", path: "override[0].value"},
+		{name: "invalid_optimize_for", rule: "override: [{file_option: optimize_for, value: FAST}]", path: "override[0].value"},
+		{name: "lowercase_optimize_for", rule: "override: [{file_option: optimize_for, value: speed}]", path: "override[0].value"},
+		{name: "numeric_optimize_for", rule: "override: [{file_option: optimize_for, value: 1}]", path: "override[0].value"},
+		{name: "invalid_jstype", rule: "override: [{field_option: jstype, value: STRING}]", path: "override[0].value"},
+		{name: "boolean_jstype", rule: "override: [{field_option: jstype, value: true}]", path: "override[0].value"},
+		{name: "null_value", rule: "override: [{file_option: go_package, value: null}]", path: "override[0].value"},
+		{name: "missing_value", rule: "override: [{file_option: go_package}]", path: "override[0].value"},
+		{name: "both_override_options", rule: "override: [{file_option: go_package, field_option: jstype, value: JS_STRING}]", path: "override[0]"},
+		{name: "neither_override_option", rule: "override: [{module: example.com/api, value: value}]", path: "override[0]"},
+		{name: "both_disable_options", rule: "disable: [{file_option: go_package, field_option: jstype}]", path: "disable[0]"},
+		{name: "empty_disable", rule: "disable: [{}]", path: "disable[0]"},
+		{name: "blank_disable_selector", rule: "disable: [{module: ''}]", path: "disable[0]"},
+		{name: "field_without_option_disable", rule: "disable: [{field: acme.v1.Message.id}]", path: "disable[0]"},
+		{name: "file_option_with_field_disable", rule: "disable: [{file_option: go_package, field: acme.v1.Message.id}]", path: "disable[0]"},
+		{name: "file_option_with_field_override", rule: "override: [{file_option: go_package, field: acme.v1.Message.id, value: gen}]", path: "override[0]"},
+		{name: "selector_wrong_type", rule: "override: [{file_option: go_package, module: true, value: gen}]", path: "override[0].module"},
+		{name: "selector_unknown_key", rule: "disable: [{file_option: go_package, modules: [example.com/api]}]", path: "disable[0].modules"},
+	}
+	for _, tt := range tests {
+		for _, enabled := range []bool{true, false} {
+			t.Run(fmt.Sprintf("%s/enabled_%t", tt.name, enabled), func(t *testing.T) {
+				t.Parallel()
+				raw := fmt.Sprintf("generate:\n  managed:\n    enabled: %t\n    %s\nplugins:\n  - command: [must-not-run]\n    out: gen\n", enabled, tt.rule)
+				issues := ValidateGenerateYAML([]byte(raw))
+				require.True(t, config.HasErrors(issues), "%+v", issues)
+				assert.Contains(t, issues[0].Message, "generate.managed."+tt.path)
+				assert.Equal(t, 4, issues[0].Line)
+				assert.Positive(t, issues[0].Column)
+
+				got, err := ParseGenerate(strings.NewReader(raw))
+				require.Error(t, err)
+				assert.Equal(t, Generate{}, got, "invalid configuration must not escape to generation")
+				path := filepath.Join(t.TempDir(), GenerateFile)
+				require.NoError(t, os.WriteFile(path, []byte(raw), 0o600))
+				fileIssues, err := ValidateFile(path)
+				require.NoError(t, err)
+				assert.Equal(t, issues, fileIssues)
+			})
+		}
+	}
+}
+
+func TestManagedValidationAcceptsSupportedRules(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name  string
+		field string
+		value string
+	}{
+		{name: "go_package", value: "'example.com/api;apiv1'"},
+		{name: "go_package_prefix", value: "'example.com/{{file_path_without:proto/}}'"},
+		{name: "go_package_prefix", value: "'example.com/{{file_path}}'"},
+		{name: "go_package_prefix", value: "'example.com/{{file_path_spec}}'"},
+		{name: "go_package_prefix", value: "'example.com/{{file_dir}}'"},
+		{name: "go_package_prefix", value: "'example.com/{{file_dir_without:proto/}}'"},
+		{name: "java_package", value: "com.acme"},
+		{name: "java_package_prefix", value: "com"},
+		{name: "java_package_suffix", value: "api"},
+		{name: "java_multiple_files", value: "false"},
+		{name: "java_outer_classname", value: "API"},
+		{name: "java_string_check_utf8", value: "true"},
+		{name: "csharp_namespace", value: "Acme.API"},
+		{name: "csharp_namespace_prefix", value: "Acme"},
+		{name: "ruby_package", value: "Acme::API"},
+		{name: "ruby_package_suffix", value: "API"},
+		{name: "php_namespace", value: "'Acme\\API'"},
+		{name: "php_metadata_namespace", value: "Metadata"},
+		{name: "php_metadata_namespace_suffix", value: "Metadata"},
+		{name: "objc_class_prefix", value: "ACM"},
+		{name: "swift_prefix", value: "''"},
+		{name: "cc_enable_arenas", value: "false"},
+		{name: "optimize_for", value: "SPEED"},
+		{name: "optimize_for", value: "CODE_SIZE"},
+		{name: "optimize_for", value: "LITE_RUNTIME"},
+		{name: "jstype", field: "field_option", value: "JS_NORMAL"},
+		{name: "jstype", field: "field_option", value: "JS_STRING"},
+		{name: "jstype", field: "field_option", value: "JS_NUMBER"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name+"/"+tt.value, func(t *testing.T) {
+			t.Parallel()
+			field := tt.field
+			if field == "" {
+				field = "file_option"
+			}
+			raw := fmt.Sprintf("generate:\n  managed:\n    enabled: false\n    disable:\n      - %s: %s\n      - module: example.com/api\n      - package: acme.v1\n      - path: proto/\n      - field_option: jstype\n        field: acme.v1.Message.id\n    override:\n      - %s: %s\n        value: %s\n        module: example.com/api\n        package: acme.v1\n        path: proto/\n", field, tt.name, field, tt.name, tt.value)
+			assert.Empty(t, ValidateGenerateYAML([]byte(raw)))
+			got, err := ParseGenerate(strings.NewReader(raw))
+			require.NoError(t, err)
+			assert.Nil(t, got.Options.Go.PackagePrefix, "omitted Go prefix must still allow inheritance")
+			assert.False(t, got.Generate.Managed.Enabled)
+			require.Len(t, got.Generate.Managed.Override, 1)
+			assert.Equal(t, "example.com/api", got.Generate.Managed.Override[0].Module)
+		})
+	}
+}
+
+func TestManagedValidationPreservesSelectorAndInheritanceValues(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name string
+		raw  string
+	}{
+		{name: "no_selectors", raw: "generate:\n  managed:\n    override: [{file_option: go_package, value: gen}]\n"},
+		{name: "empty_optional_selectors", raw: "generate:\n  managed:\n    disable: [{file_option: go_package, field: '', module: ''}]\n    override: [{file_option: go_package, value: '', field: '', path: ''}]\n"},
+		{name: "field_with_context", raw: "generate:\n  managed:\n    override: [{field_option: jstype, value: JS_STRING, field: acme.v1.Message.id, module: example.com/api, package: acme.v1, path: proto/api.proto}]\n"},
+		{name: "selectors_retain_existing_matching", raw: "generate:\n  managed:\n    override: [{file_option: go_package, value: gen, module: 'some/module', package: 'acme.*', path: 'api/**'}]\n"},
+		{name: "empty_override_list", raw: "generate:\n  managed:\n    override: []\n"},
+		{name: "explicit_empty_prefix", raw: "options:\n  go:\n    package_prefix: ''\n"},
+		{name: "explicit_prefix", raw: "options:\n  go:\n    package_prefix: example.com/gen\n"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			assert.Empty(t, ValidateGenerateYAML([]byte(tt.raw)))
+			got, err := ParseGenerate(strings.NewReader(tt.raw))
+			require.NoError(t, err)
+			var want Generate
+			require.NoError(t, yaml.Unmarshal([]byte(tt.raw), &want))
+			assert.Equal(t, want.Generate, got.Generate)
+			assert.Equal(t, want.Options, got.Options)
+		})
+	}
+}
+
+func TestManagedValidationRejectsBeforeDescriptorApplication(t *testing.T) {
+	t.Parallel()
+	tests := []struct{ name, rule string }{
+		{name: "unknown_option", rule: "file_option: bogus_option, value: ignored"},
+		{name: "wrong_value_type", rule: "file_option: java_multiple_files, value: 'false'"},
+		{name: "invalid_enum", rule: "field_option: jstype, value: INVALID"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			fd := &descriptorpb.FileDescriptorProto{Name: proto.String("api.proto"), Package: proto.String("acme.v1")}
+			before := proto.Clone(fd)
+			raw := "generate:\n  managed:\n    enabled: true\n    override: [{" + tt.rule + "}]\n"
+			got, err := ParseGenerate(strings.NewReader(raw))
+			if err == nil {
+				// Follow the runtime boundary: application is only reachable after parsing succeeds.
+				managed := core.ManagedModeConfig{Enabled: got.Generate.Managed.Enabled}
+				for _, rule := range got.Generate.Managed.Override {
+					managed.Override = append(managed.Override, core.ManagedOverrideRule{FileOption: core.FileOptionType(rule.FileOption), FieldOption: core.FieldOptionType(rule.FieldOption), Value: rule.Value})
+				}
+				require.NoError(t, core.ApplyManagedMode([]*descriptorpb.FileDescriptorProto{fd}, managed, nil))
+			}
+			require.Error(t, err)
+			assert.True(t, proto.Equal(before, fd), "invalid rules must be rejected before managed defaults mutate descriptors")
+		})
+	}
+}
diff --git a/internal/config/v1/module.go b/internal/config/v1/module.go
new file mode 100644
index 00000000..cb038e3d
--- /dev/null
+++ b/internal/config/v1/module.go
@@ -0,0 +1,259 @@
+package v1
+
+import (
+	"bufio"
+	"bytes"
+	"fmt"
+	"io"
+	"path/filepath"
+	"strings"
+	"unicode"
+)
+
+// Module describes the module identity and source roots in protobuf.mod.
+type Module struct {
+	Name     string
+	Roots    []string
+	Requires []Requirement
+	Replaces []Replacement
+	// ProtoFilters carries Buf source selection relative to the dependency directory.
+	// Native protobuf.mod files leave it empty.
+	ProtoFilters []ProtoFileFilter
+	// BSRDependencies retains Buf metadata until a backend chooses Git requirements.
+	// Native protobuf.mod files leave it empty.
+	BSRDependencies []BSRDependency
+}
+
+// ProtoFileFilter selects proto files below a root without changing import names.
+// Includes and excludes use the same base directory as Root.
+type ProtoFileFilter struct {
+	Root     string
+	Includes []string
+	Excludes []string
+}
+
+// Requirement names a dependency and its optional version or commit.
+type Requirement struct {
+	Module  string
+	Version string
+}
+
+// Replacement redirects a dependency to a local module directory.
+type Replacement struct {
+	Module string
+	Target string
+}
+
+// IsModuleManifest reports whether protobuf.mod uses the v1 module syntax.
+func IsModuleManifest(raw []byte) bool {
+	for _, line := range strings.Split(strings.TrimPrefix(string(raw), "\ufeff"), "\n") {
+		fields := strings.Fields(stripModuleComment(line))
+		if len(fields) == 0 {
+			continue
+		}
+		if fields[0] == "module" {
+			return true
+		}
+		break
+	}
+	_, err := ParseModule(bytes.NewReader(raw))
+	return err == nil
+}
+
+// ParseModule reads the v1 module identity, roots and dependency directives.
+// Block entries must occupy separate lines from the opening and closing parentheses.
+func ParseModule(r io.Reader) (Module, error) {
+	var result Module
+	scanner := bufio.NewScanner(r)
+	block := ""
+	blockLine := 0
+	requires := make(map[string]int)
+	replaces := make(map[string]int)
+	line := 0
+	for scanner.Scan() {
+		line++
+		text := scanner.Text()
+		if line == 1 {
+			text = strings.TrimPrefix(text, "\ufeff")
+		}
+		text = strings.TrimSpace(stripModuleComment(text))
+		if text == "" {
+			continue
+		}
+		if text == ")" {
+			if block == "" {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: unmatched closing parenthesis", line)
+			}
+			block = ""
+			continue
+		}
+		fields := strings.Fields(text)
+		opensBlock := text == "(" || text == "roots(" || text == "require(" || text == "replace(" ||
+			(len(fields) == 2 && fields[1] == "(")
+		if opensBlock {
+			if block != "" {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: nested block (opened at line %d)", line, blockLine)
+			}
+			block = strings.TrimSpace(strings.TrimSuffix(text, "("))
+			if block == "direct" || block == "indirect" {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: legacy %s block; run easyp migrate --module <identity> to preview conversion", line, block)
+			}
+			if block != "roots" && block != "require" && block != "replace" {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: unknown block %q", line, block)
+			}
+			blockLine = line
+			continue
+		}
+
+		directive := block
+		if block == "" {
+			directive = fields[0]
+			fields = fields[1:]
+		}
+		if len(fields) > 0 && strings.HasPrefix(fields[0], "(") {
+			if block != "" {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: nested block (opened at line %d)", line, blockLine)
+			}
+			// Requirement metadata editing relies on block entries occupying separate lines.
+			return Module{}, fmt.Errorf("protobuf.mod:%d: inline blocks are not supported; put entries on separate lines", line)
+		}
+		for i, field := range fields {
+			if directive == "replace" && i == 1 && field == "=>" {
+				continue
+			}
+			if !validModuleToken(field) {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: invalid token %q", line, field)
+			}
+		}
+		switch directive {
+		case "module":
+			if result.Name != "" || len(fields) != 1 {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: expected one module identity", line)
+			}
+			if err := validateManifestModuleIdentity(fields[0], "module"); err != nil {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: %w", line, err)
+			}
+			if err := ValidateModuleVersion(fields[0], ""); err != nil {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: %w", line, err)
+			}
+			result.Name = fields[0]
+		case "roots":
+			if len(fields) == 0 {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: roots expects at least one path", line)
+			}
+			for _, root := range fields {
+				clean := filepath.Clean(root)
+				if filepath.IsAbs(root) || clean == ".." || strings.HasPrefix(clean, ".."+string(filepath.Separator)) {
+					return Module{}, fmt.Errorf("protobuf.mod:%d: root %q leaves the module", line, root)
+				}
+				result.Roots = append(result.Roots, clean)
+			}
+		case "require":
+			if len(fields) < 1 || len(fields) > 2 {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: require expects module and optional version", line)
+			}
+			if err := validateManifestModuleIdentity(fields[0], "require"); err != nil {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: %w", line, err)
+			}
+			if len(fields) == 2 && strings.ContainsAny(fields[1], "()") {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: invalid version token %q", line, fields[1])
+			}
+			if firstLine, ok := requires[fields[0]]; ok {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: duplicate require source %q (first declared at line %d)", line, fields[0], firstLine)
+			}
+			requires[fields[0]] = line
+			requirement := Requirement{Module: fields[0]}
+			if len(fields) == 2 {
+				requirement.Version = fields[1]
+			}
+			if err := ValidateModuleVersion(requirement.Module, requirement.Version); err != nil {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: %w", line, err)
+			}
+			result.Requires = append(result.Requires, requirement)
+		case "replace":
+			if len(fields) != 3 || fields[1] != "=>" {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: replace expects module => target", line)
+			}
+			if err := validateManifestModuleIdentity(fields[0], "replace"); err != nil {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: %w", line, err)
+			}
+			if firstLine, ok := replaces[fields[0]]; ok {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: duplicate replace source %q (first declared at line %d)", line, fields[0], firstLine)
+			}
+			if err := ValidateModuleVersion(fields[0], ""); err != nil {
+				return Module{}, fmt.Errorf("protobuf.mod:%d: %w", line, err)
+			}
+			replaces[fields[0]] = line
+			result.Replaces = append(result.Replaces, Replacement{Module: fields[0], Target: fields[2]})
+		default:
+			return Module{}, fmt.Errorf("protobuf.mod:%d: unknown directive %q", line, directive)
+		}
+	}
+	if err := scanner.Err(); err != nil {
+		return Module{}, fmt.Errorf("Err: %w", err)
+	}
+	if block != "" {
+		return Module{}, fmt.Errorf("protobuf.mod:%d: unclosed %s block", blockLine, block)
+	}
+	if result.Name == "" {
+		if line == 0 {
+			line = 1
+		}
+		return Module{}, fmt.Errorf("protobuf.mod:%d: missing module directive", line)
+	}
+	if len(result.Roots) == 0 {
+		result.Roots = []string{"."}
+	}
+	return result, nil
+}
+
+func validateManifestModuleIdentity(identity, directive string) error {
+	authorityEnd := -1
+	if scheme := strings.Index(identity, "://"); scheme >= 0 {
+		if slash := strings.Index(identity[scheme+3:], "/"); slash >= 0 {
+			authorityEnd = scheme + 3 + slash
+		} else {
+			authorityEnd = len(identity)
+		}
+	}
+	if at := strings.LastIndex(identity, "@"); at > authorityEnd {
+		base := identity[:at]
+		suffix := identity[at+1:]
+		if suffix == "" {
+			return fmt.Errorf("%s module identity %q must not end with @", directive, identity)
+		}
+		switch directive {
+		case "require":
+			return fmt.Errorf("require module identity %q must not embed version %q; use require %s %s", identity, suffix, base, suffix)
+		case "replace":
+			return fmt.Errorf("replace module identity %q must not embed version %q; use replace %s => <local-path>", identity, suffix, base)
+		default:
+			return fmt.Errorf("%s module identity %q must not embed version %q", directive, identity, suffix)
+		}
+	}
+	return nil
+}
+
+func stripModuleComment(line string) string {
+	tokenStart := true
+	for i, char := range line {
+		if tokenStart && (char == '#' || strings.HasPrefix(line[i:], "//")) {
+			return line[:i]
+		}
+		tokenStart = unicode.IsSpace(char)
+	}
+	return line
+}
+
+func validModuleToken(token string) bool {
+	if token == "=>" || strings.HasPrefix(token, "(") || strings.HasPrefix(token, ")") || strings.ContainsAny(token, "\"`") {
+		return false
+	}
+	// Parentheses within URL and path tokens are literal characters.
+	for _, char := range token {
+		if unicode.IsControl(char) || char == '\ufeff' {
+			return false
+		}
+	}
+	return true
+}
diff --git a/internal/config/v1/module_edge_cases_test.go b/internal/config/v1/module_edge_cases_test.go
new file mode 100644
index 00000000..7fbd9931
--- /dev/null
+++ b/internal/config/v1/module_edge_cases_test.go
@@ -0,0 +1,375 @@
+package v1
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestParseModuleEdgeCases(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name string
+		raw  string
+		want Module
+	}{
+		{
+			name: "initial_utf8_bom",
+			raw:  "\ufeffmodule example.com/app\n",
+			want: Module{Name: "example.com/app", Roots: []string{"."}},
+		},
+		{
+			name: "bom_comments_and_crlf",
+			raw:  "\ufeff# heading\r\n\r\nmodule example.com/app # identity\r\nroots proto\r\n",
+			want: Module{Name: "example.com/app", Roots: []string{"proto"}},
+		},
+		{
+			name: "hash_comments_at_token_start",
+			raw: "# heading\nmodule example.com/app # identity\nroots ( # roots\n" +
+				" proto # directory\n) # end\nrequire ( # dependencies\n" +
+				" example.com/x # versionless\n example.com/y v1.2.0\t# pinned\n)\n" +
+				"replace ( # local\n example.com/x => ../x # target\n) # end\n#",
+			want: Module{
+				Name:     "example.com/app",
+				Roots:    []string{"proto"},
+				Requires: []Requirement{{Module: "example.com/x"}, {Module: "example.com/y", Version: "v1.2.0"}},
+				Replaces: []Replacement{{Module: "example.com/x", Target: "../x"}},
+			},
+		},
+		{
+			name: "unicode_whitespace_before_comments",
+			raw:  "\u00a0# heading\nmodule example.com/app\u2003// identity\nrequire example.com/x\u00a0# dependency\n",
+			want: Module{Name: "example.com/app", Roots: []string{"."}, Requires: []Requirement{{Module: "example.com/x"}}},
+		},
+		{
+			name: "hash_and_slashes_inside_url_tokens",
+			raw: "module https://example.com/app.git#identity\n" +
+				"require https://example.com/x.git?path=a//b#fragment v1.2.0 # comment\n" +
+				"require ssh://git@example.com:2222/y.git // comment\n",
+			want: Module{
+				Name:  "https://example.com/app.git#identity",
+				Roots: []string{"."},
+				Requires: []Requirement{
+					{Module: "https://example.com/x.git?path=a//b#fragment", Version: "v1.2.0"},
+					{Module: "ssh://git@example.com:2222/y.git"},
+				},
+			},
+		},
+		{
+			name: "url_parentheses_are_not_blocks",
+			raw: "module https://example.com/app(\n" +
+				"require https://example.com/x)\n" +
+				"replace https://example.com/x) => ./local(\n",
+			want: Module{
+				Name:     "https://example.com/app(",
+				Roots:    []string{"."},
+				Requires: []Requirement{{Module: "https://example.com/x)"}},
+				Replaces: []Replacement{{Module: "https://example.com/x)", Target: "./local("}},
+			},
+		},
+		{
+			name: "versionless_sha_and_major_versions_are_unchanged",
+			raw: "module example.com/app\nrequire example.com/unversioned\nrequire(\n" +
+				" example.com/sha1 0123456789abcdef0123456789abcdef01234567\n" +
+				" example.com/sha256 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef\n" +
+				" example.com/repo/v2 v2.2.0\n example.com/plain v1.3.4\n)\n",
+			want: Module{
+				Name:  "example.com/app",
+				Roots: []string{"."},
+				Requires: []Requirement{
+					{Module: "example.com/unversioned"},
+					{Module: "example.com/sha1", Version: "0123456789abcdef0123456789abcdef01234567"},
+					{Module: "example.com/sha256", Version: "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"},
+					{Module: "example.com/repo/v2", Version: "v2.2.0"},
+					{Module: "example.com/plain", Version: "v1.3.4"},
+				},
+			},
+		},
+		{
+			name: "relative_and_absolute_replacement_targets",
+			raw: "module example.com/app\nreplace example.com/x => ../x\nreplace(\n" +
+				" example.com/y => /opt/protos/y\n example.com/z => local(z)#copy\n)\n",
+			want: Module{
+				Name:  "example.com/app",
+				Roots: []string{"."},
+				Replaces: []Replacement{
+					{Module: "example.com/x", Target: "../x"},
+					{Module: "example.com/y", Target: "/opt/protos/y"},
+					{Module: "example.com/z", Target: "local(z)#copy"},
+				},
+			},
+		},
+		{
+			name: "empty_blocks_and_compact_openers",
+			raw:  "module example.com/app\nroots(\n)\nrequire (\n)\nreplace(\n)\n",
+			want: Module{Name: "example.com/app", Roots: []string{"."}},
+		},
+		{
+			name: "sources_are_distinct_from_versions_and_targets",
+			raw: "module example.com/app\nrequire example.com/x v1.2.0\nrequire example.com/y v1.2.0\n" +
+				"replace example.com/x => ./shared\nreplace example.com/y => ./shared\n",
+			want: Module{
+				Name:     "example.com/app",
+				Roots:    []string{"."},
+				Requires: []Requirement{{Module: "example.com/x", Version: "v1.2.0"}, {Module: "example.com/y", Version: "v1.2.0"}},
+				Replaces: []Replacement{{Module: "example.com/x", Target: "./shared"}, {Module: "example.com/y", Target: "./shared"}},
+			},
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			got, err := ParseModule(strings.NewReader(tt.raw))
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, got)
+			assert.True(t, IsModuleManifest([]byte(tt.raw)))
+		})
+	}
+}
+
+func TestParseModuleRejectsMalformedDirectives(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name string
+		raw  string
+	}{
+		{name: "same_line_require_block", raw: "require (example.com/x v1.2.0)"},
+		{name: "spaced_same_line_require_block", raw: "require ( example.com/x v1.2.0 )"},
+		{name: "versionless_same_line_require_block", raw: "require (example.com/x)"},
+		{name: "compact_same_line_require_block", raw: "require(example.com/x v1.2.0)"},
+		{name: "same_line_roots_block", raw: "roots (proto)"},
+		{name: "same_line_replace_block", raw: "replace (example.com/x => ./local)"},
+		{name: "module_parenthesis", raw: "module (example.com/app)"},
+		{name: "module_arrow_token", raw: "module =>"},
+		{name: "module_quoted_identity", raw: "module \"example.com/app\""},
+		{name: "missing_module", raw: "module"},
+		{name: "extra_module_token", raw: "module example.com/app extra"},
+		{name: "missing_roots", raw: "roots # missing path"},
+		{name: "missing_requirement", raw: "require # missing source"},
+		{name: "extra_requirement_token", raw: "require example.com/x v1.2.0 extra"},
+		{name: "require_arrow_source", raw: "require => v1.2.0"},
+		{name: "require_arrow_version", raw: "require example.com/x =>"},
+		{name: "require_closing_parenthesis", raw: "require example.com/x )"},
+		{name: "require_closing_version", raw: "require example.com/x v1.2.0)"},
+		{name: "missing_replace_target", raw: "replace example.com/x =>"},
+		{name: "malformed_replace_arrow", raw: "replace example.com/x -> ./local"},
+		{name: "replace_arrow_source", raw: "replace => => ./local"},
+		{name: "replace_arrow_target", raw: "replace example.com/x => =>"},
+		{name: "replace_parenthesis_target", raw: "replace example.com/x => )"},
+		{name: "extra_replace_token", raw: "replace example.com/x => ./local extra"},
+		{name: "roots_arrow_token", raw: "roots =>"},
+		{name: "roots_parenthesis_token", raw: "roots proto )"},
+		{name: "block_opener_extra_token", raw: "require extra ("},
+		{name: "unknown_block", raw: "unknown ("},
+		{name: "unknown_directive", raw: "unknown example.com/x"},
+		{name: "embedded_bom", raw: "require \ufeffexample.com/x"},
+		{name: "nul_in_requirement", raw: "require example.com/\x00x"},
+		{name: "quoted_requirement", raw: "require \"example.com/x\""},
+		{name: "backtick_requirement", raw: "require `example.com/x`"},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			prefix := "module example.com/app\n"
+			if strings.Fields(tt.raw)[0] == "module" {
+				prefix = "\n"
+			}
+			got, err := ParseModule(strings.NewReader(prefix + tt.raw + "\n"))
+			require.ErrorContains(t, err, "protobuf.mod:2:")
+			assert.Equal(t, Module{}, got)
+			assert.Equal(t, 1, strings.Count(err.Error(), "protobuf.mod:"))
+		})
+	}
+}
+
+func TestParseModuleRejectsMalformedIdentity(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name string
+		raw  string
+	}{
+		{name: "arrow", raw: "module =>"},
+		{name: "closing_parenthesis", raw: "module )"},
+		{name: "quoted_identity", raw: "module \"example.com/app\""},
+		{name: "repeated_bom", raw: "\ufeff\ufeffmodule example.com/app"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			got, err := ParseModule(strings.NewReader(tt.raw))
+			require.ErrorContains(t, err, "protobuf.mod:1:")
+			assert.Equal(t, Module{}, got)
+			assert.Equal(t, 1, strings.Count(err.Error(), "protobuf.mod:"))
+		})
+	}
+}
+
+func TestParseModuleBlockLocations(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name    string
+		raw     string
+		wantErr []string
+	}{
+		{
+			name:    "unmatched_closing_parenthesis",
+			raw:     "module example.com/app\n\n)\n",
+			wantErr: []string{"protobuf.mod:3:", "unmatched closing parenthesis"},
+		},
+		{
+			name:    "unclosed_require_block",
+			raw:     "module example.com/app\nrequire (\n example.com/x\n",
+			wantErr: []string{"protobuf.mod:2:", "unclosed require block"},
+		},
+		{
+			name:    "unclosed_roots_block_after_comments",
+			raw:     "\ufeff# heading\nmodule example.com/app\n\nroots( # paths\n proto\n",
+			wantErr: []string{"protobuf.mod:4:", "unclosed roots block"},
+		},
+		{
+			name:    "unclosed_replace_block",
+			raw:     "module example.com/app\nreplace (\n example.com/x => ./local\n",
+			wantErr: []string{"protobuf.mod:2:", "unclosed replace block"},
+		},
+		{
+			name:    "nested_named_block",
+			raw:     "module example.com/app\nrequire (\n\nreplace (\n)\n)\n",
+			wantErr: []string{"protobuf.mod:4:", "nested block", "opened at line 2"},
+		},
+		{
+			name:    "nested_anonymous_block",
+			raw:     "module example.com/app\nroots (\n (\n )\n)\n",
+			wantErr: []string{"protobuf.mod:3:", "nested block", "opened at line 2"},
+		},
+		{
+			name:    "closing_parenthesis_with_extra_tokens",
+			raw:     "module example.com/app\nroots (\n ) extra\n",
+			wantErr: []string{"protobuf.mod:3:"},
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			got, err := ParseModule(strings.NewReader(tt.raw))
+			require.Error(t, err)
+			for _, message := range tt.wantErr {
+				assert.Contains(t, err.Error(), message)
+			}
+			assert.Equal(t, Module{}, got)
+			assert.Equal(t, 1, strings.Count(err.Error(), "protobuf.mod:"))
+		})
+	}
+}
+
+func TestParseModuleDuplicateSourceLocations(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name      string
+		raw       string
+		directive string
+		firstLine string
+		lastLine  string
+	}{
+		{
+			name: "require_repeated_inline", directive: "require",
+			raw:       "require example.com/x v1.2.0\nrequire example.com/x v1.2.0\n",
+			firstLine: "first declared at line 2", lastLine: "protobuf.mod:3:",
+		},
+		{
+			name: "require_conflicting_versions_in_block", directive: "require",
+			raw:       "require (\n example.com/x v1.2.0\n example.com/x v2.0.0\n)\n",
+			firstLine: "first declared at line 3", lastLine: "protobuf.mod:4:",
+		},
+		{
+			name: "require_versionless_then_block", directive: "require",
+			raw:       "require example.com/x\nrequire (\n example.com/x v1.2.0\n)\n",
+			firstLine: "first declared at line 2", lastLine: "protobuf.mod:4:",
+		},
+		{
+			name: "require_across_blocks", directive: "require",
+			raw:       "require (\n example.com/x\n)\nrequire (\n example.com/x\n)\n",
+			firstLine: "first declared at line 3", lastLine: "protobuf.mod:6:",
+		},
+		{
+			name: "replace_repeated_inline", directive: "replace",
+			raw:       "replace example.com/x => ./local\nreplace example.com/x => ./local\n",
+			firstLine: "first declared at line 2", lastLine: "protobuf.mod:3:",
+		},
+		{
+			name: "replace_conflicting_targets_in_block", directive: "replace",
+			raw:       "replace (\n example.com/x => ./first\n example.com/x => ./second\n)\n",
+			firstLine: "first declared at line 3", lastLine: "protobuf.mod:4:",
+		},
+		{
+			name: "replace_block_then_inline", directive: "replace",
+			raw:       "replace (\n example.com/x => ./first\n)\nreplace example.com/x => /opt/second\n",
+			firstLine: "first declared at line 3", lastLine: "protobuf.mod:5:",
+		},
+		{
+			name: "replace_across_blocks", directive: "replace",
+			raw:       "replace (\n example.com/x => ./local\n)\nreplace (\n example.com/x => ./local\n)\n",
+			firstLine: "first declared at line 3", lastLine: "protobuf.mod:6:",
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			got, err := ParseModule(strings.NewReader("module example.com/app\n" + tt.raw))
+			require.ErrorContains(t, err, "duplicate "+tt.directive)
+			assert.Contains(t, err.Error(), "example.com/x")
+			assert.Contains(t, err.Error(), tt.firstLine)
+			assert.Contains(t, err.Error(), tt.lastLine)
+			assert.Equal(t, Module{}, got)
+			assert.Equal(t, 1, strings.Count(err.Error(), "protobuf.mod:"))
+		})
+	}
+}
+
+func TestIsModuleManifestEdgeCases(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name string
+		raw  string
+		want bool
+	}{
+		{
+			name: "bom_and_hash_comments_preserve_v1_parse_errors",
+			raw:  "\ufeff# heading\nmodule example.com/app\nunknown directive\n",
+			want: true,
+		},
+		{
+			name: "valid_block_before_module_with_bom",
+			raw:  "\ufeffrequire ( # dependencies\n example.com/x\n)\nmodule example.com/app\n",
+			want: true,
+		},
+		{
+			name: "legacy_with_bom_and_hash_comment",
+			raw:  "\ufeff# heading\ndirect (\n example.com/x@v1.2.0\n)\n",
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			assert.Equal(t, tt.want, IsModuleManifest([]byte(tt.raw)))
+		})
+	}
+}
diff --git a/internal/config/v1/module_identity_syntax_test.go b/internal/config/v1/module_identity_syntax_test.go
new file mode 100644
index 00000000..fdc5da4d
--- /dev/null
+++ b/internal/config/v1/module_identity_syntax_test.go
@@ -0,0 +1,69 @@
+package v1
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestParseModuleRejectsEmbeddedVersionsInIdentities(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name string
+		raw  string
+		want string
+	}{
+		{
+			name: "module",
+			raw:  "module example.test/root@v1.0.0\n",
+			want: "module module identity \"example.test/root@v1.0.0\" must not embed version \"v1.0.0\"",
+		},
+		{
+			name: "require",
+			raw:  "module example.test/root\nrequire example.test/dep@v1.0.0\n",
+			want: "use require example.test/dep v1.0.0",
+		},
+		{
+			name: "replace",
+			raw:  "module example.test/root\nrequire example.test/dep v1.0.0\nreplace example.test/dep@v1.0.0 => ./dep\n",
+			want: "use replace example.test/dep => <local-path>",
+		},
+		{
+			name: "empty suffix",
+			raw:  "module example.test/root\nrequire example.test/dep@\n",
+			want: "must not end with @",
+		},
+		{
+			name: "URL path tag",
+			raw:  "module example.test/root\nrequire ssh://git@example.test/acme/dep@v1.0.0\n",
+			want: "use require ssh://git@example.test/acme/dep v1.0.0",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			_, err := ParseModule(strings.NewReader(tt.raw))
+
+			require.Error(t, err)
+			assert.Contains(t, err.Error(), tt.want)
+		})
+	}
+}
+
+func TestParseModuleAllowsAtInURLAuthority(t *testing.T) {
+	t.Parallel()
+
+	module, err := ParseModule(strings.NewReader("module example.test/root\nrequire ssh://git@example.test/acme/dep v1.0.0\nreplace ssh://git@example.test/acme/dep => ./dep\n"))
+
+	require.NoError(t, err)
+	require.Len(t, module.Requires, 1)
+	assert.Equal(t, "ssh://git@example.test/acme/dep", module.Requires[0].Module)
+	require.Len(t, module.Replaces, 1)
+	assert.Equal(t, "ssh://git@example.test/acme/dep", module.Replaces[0].Module)
+}
diff --git a/internal/config/v1/module_missing_identity_test.go b/internal/config/v1/module_missing_identity_test.go
new file mode 100644
index 00000000..7a165b03
--- /dev/null
+++ b/internal/config/v1/module_missing_identity_test.go
@@ -0,0 +1,32 @@
+package v1
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestParseModuleMissingIdentityHasLine(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name string
+		raw  string
+		want string
+	}{
+		{name: "empty", raw: "", want: "protobuf.mod:1: missing module directive"},
+		{name: "roots block", raw: "roots (\n  proto\n)\n", want: "protobuf.mod:3: missing module directive"},
+		{name: "comments", raw: "# first\n// second\n", want: "protobuf.mod:2: missing module directive"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			_, err := ParseModule(strings.NewReader(tt.raw))
+
+			require.EqualError(t, err, tt.want)
+		})
+	}
+}
diff --git a/internal/config/v1/module_roots_boundary_test.go b/internal/config/v1/module_roots_boundary_test.go
new file mode 100644
index 00000000..03b412c4
--- /dev/null
+++ b/internal/config/v1/module_roots_boundary_test.go
@@ -0,0 +1,34 @@
+package v1
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestParseModuleRejectsNormalizedRootEscapes(t *testing.T) {
+	t.Parallel()
+
+	for _, root := range []string{"..", "foo/../..", "foo/../../bar"} {
+		root := root
+		t.Run(root, func(t *testing.T) {
+			t.Parallel()
+
+			_, err := ParseModule(strings.NewReader("module example.test/root\nroots " + root + "\n"))
+
+			require.ErrorContains(t, err, "leaves the module")
+			assert.Contains(t, err.Error(), root)
+		})
+	}
+}
+
+func TestParseModuleStoresCleanLocalRoots(t *testing.T) {
+	t.Parallel()
+
+	module, err := ParseModule(strings.NewReader("module example.test/root\nroots foo/../bar\n"))
+
+	require.NoError(t, err)
+	assert.Equal(t, []string{"bar"}, module.Roots)
+}
diff --git a/internal/config/v1/module_test.go b/internal/config/v1/module_test.go
new file mode 100644
index 00000000..8be8261c
--- /dev/null
+++ b/internal/config/v1/module_test.go
@@ -0,0 +1,114 @@
+package v1
+
+import (
+	"reflect"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestIsModuleManifestAcceptsParsedSyntax(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name string
+		raw  string
+	}{
+		{name: "spaces", raw: "module github.com/acme/user\n"},
+		{name: "tab", raw: "module\tgithub.com/acme/user\n"},
+		{name: "unicode whitespace", raw: "module\u00a0github.com/acme/user\n"},
+		{name: "comments", raw: "// comment\n\n\tmodule\tgithub.com/acme/user // comment\n"},
+		{name: "roots before module", raw: "roots api\nmodule github.com/acme/user\n"},
+		{name: "require block before module", raw: "require (\n github.com/acme/common v1.0.0\n)\nmodule github.com/acme/user\n"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			_, err := ParseModule(strings.NewReader(tt.raw))
+			require.NoError(t, err)
+			assert.True(t, IsModuleManifest([]byte(tt.raw)))
+		})
+	}
+}
+
+func TestIsModuleManifestKeepsLegacySyntax(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name string
+		raw  string
+	}{
+		{name: "empty", raw: "\n// comment\n"},
+		{name: "direct", raw: "direct (\n github.com/acme/common@v1.0.0\n)\n"},
+		{name: "module dependency", raw: "direct (\n module\n)\n"},
+		{name: "malformed direct", raw: "direct (\n module github.com/acme/user\n)\n"},
+		{name: "replace", raw: "replace module@v1.0.0 => ./local\n"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			assert.False(t, IsModuleManifest([]byte(tt.raw)))
+		})
+	}
+}
+
+func TestIsModuleManifestPreservesV1ParseErrors(t *testing.T) {
+	t.Parallel()
+
+	raw := "module github.com/acme/user\nunknown directive\n"
+	assert.True(t, IsModuleManifest([]byte(raw)))
+	_, err := ParseModule(strings.NewReader(raw))
+	require.ErrorContains(t, err, "unknown directive")
+}
+
+func TestParseModuleRoots(t *testing.T) {
+	got, err := ParseModule(strings.NewReader(`// schema module
+module github.com/acme/user
+roots (
+  api
+  shared // comment
+)
+`))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if got.Name != "github.com/acme/user" || !reflect.DeepEqual(got.Roots, []string{"api", "shared"}) {
+		t.Fatalf("unexpected module: %#v", got)
+	}
+}
+
+func TestParseModuleDefaultRoot(t *testing.T) {
+	got, err := ParseModule(strings.NewReader("module github.com/acme/user\n"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if !reflect.DeepEqual(got.Roots, []string{"."}) {
+		t.Fatalf("roots = %v", got.Roots)
+	}
+}
+
+func TestParseModuleUnversionedRequirements(t *testing.T) {
+	got, err := ParseModule(strings.NewReader("module example.com/app\nrequire example.com/repo/foo\nrequire (\n  example.com/repo/bar\n)\n"))
+	require.NoError(t, err)
+	require.Equal(t, []Requirement{{Module: "example.com/repo/foo"}, {Module: "example.com/repo/bar"}}, got.Requires)
+}
+
+func TestParseModuleRejectsUnknownDirective(t *testing.T) {
+	if _, err := ParseModule(strings.NewReader("module github.com/acme/user\nplugin go\n")); err == nil {
+		t.Fatal("expected unknown directive error")
+	}
+}
+
+func TestParseModuleHTTPSIdentity(t *testing.T) {
+	got, err := ParseModule(strings.NewReader("module https://example.com/acme/user.git\nrequire https://example.com/acme/common.git v1.2.3 // indirect\n"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if got.Name != "https://example.com/acme/user.git" || len(got.Requires) != 1 || got.Requires[0].Module != "https://example.com/acme/common.git" {
+		t.Fatalf("unexpected module: %#v", got)
+	}
+}
diff --git a/internal/config/v1/packages.go b/internal/config/v1/packages.go
new file mode 100644
index 00000000..74722ad9
--- /dev/null
+++ b/internal/config/v1/packages.go
@@ -0,0 +1,22 @@
+package v1
+
+import (
+	"fmt"
+	"regexp"
+)
+
+// PackageSelectorPattern is the grammar of an exact protobuf package name.
+// Selectors are not file paths, glob patterns or package-name prefixes.
+const PackageSelectorPattern = `^[A-Za-z_][A-Za-z0-9_]*(\.[A-Za-z_][A-Za-z0-9_]*)*$`
+
+var packageSelector = regexp.MustCompile(PackageSelectorPattern)
+
+// ValidatePackageSelectors checks package selection without inspecting sources.
+func ValidatePackageSelectors(packages []string) error {
+	for index, name := range packages {
+		if !packageSelector.MatchString(name) {
+			return fmt.Errorf("generate.packages[%d]: %q is not an exact protobuf package name", index, name)
+		}
+	}
+	return nil
+}
diff --git a/internal/config/v1/packages_test.go b/internal/config/v1/packages_test.go
new file mode 100644
index 00000000..9e2e92fc
--- /dev/null
+++ b/internal/config/v1/packages_test.go
@@ -0,0 +1,32 @@
+package v1
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestPackageSelectorValidation(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct {
+		name  string
+		valid bool
+	}{
+		{name: "demo.v1", valid: true}, {name: "_demo.Type1", valid: true}, {name: "single", valid: true},
+		{name: "demo.*"}, {name: "demo/one"}, {name: ".demo"}, {name: "demo..v1"}, {name: "demo-v1"}, {name: "demo.1"}, {name: ""}, {name: "demo."},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			raw := "version: v1\ngenerate:\n  packages: [\"" + tt.name + "\"]\n"
+			_, err := ParseGenerate(strings.NewReader(raw))
+			assert.Equal(t, tt.valid, err == nil)
+			if !tt.valid {
+				require.ErrorContains(t, err, "generate.packages")
+			}
+		})
+	}
+	require.NoError(t, ValidatePackageSelectors(nil))
+	require.NoError(t, ValidatePackageSelectors([]string{"demo.v1", "demo.v1"}))
+}
diff --git a/internal/config/v1/plugin.go b/internal/config/v1/plugin.go
new file mode 100644
index 00000000..42959e59
--- /dev/null
+++ b/internal/config/v1/plugin.go
@@ -0,0 +1,65 @@
+package v1
+
+import (
+	"errors"
+	"fmt"
+	"strings"
+
+	"golang.org/x/mod/semver"
+)
+
+// Plugin selects a local, bundled, or remote generator and its output options.
+type Plugin struct {
+	Name        string        `yaml:"name"`
+	Path        string        `yaml:"path"`
+	Command     []string      `yaml:"command"`
+	Remote      string        `yaml:"remote"`
+	Version     string        `yaml:"version"`
+	Out         string        `yaml:"out"`
+	Opts        PluginOptions `yaml:"opts"`
+	WithImports bool          `yaml:"with_imports"`
+}
+
+// Validate checks the plugin source and reproducibility requirements.
+func (p Plugin) Validate() error {
+	sources := 0
+	if p.Name != "" {
+		sources++
+	}
+	if p.Path != "" {
+		sources++
+	}
+	if p.Command != nil {
+		sources++
+	}
+	if p.Remote != "" {
+		sources++
+	}
+	if sources != 1 {
+		return errors.New("exactly one of name, path, command or remote is required")
+	}
+	if p.Command != nil && (len(p.Command) == 0 || strings.TrimSpace(p.Command[0]) == "") {
+		return errors.New("command executable is required")
+	}
+	if p.Out == "" {
+		return errors.New("out is required")
+	}
+	if strings.Contains(p.Version, ":latest") {
+		return errors.New("latest version is not reproducible")
+	}
+	if p.Remote == "" {
+		if p.Version != "" {
+			return errors.New("local and bundled plugin versions are selected by the executable; version cannot be verified")
+		}
+		return nil
+	}
+	lastSegment := p.Remote[strings.LastIndex(p.Remote, "/")+1:]
+	if colon := strings.LastIndexByte(lastSegment, ':'); colon >= 0 {
+		name, embedded := p.Remote[:strings.LastIndexByte(p.Remote, ':')], lastSegment[colon+1:]
+		return fmt.Errorf("specify the remote plugin version only in version: split remote into remote: %q and version: %q", name, embedded)
+	}
+	if !semver.IsValid(p.Version) {
+		return errors.New("remote plugin requires a pinned semantic version")
+	}
+	return nil
+}
diff --git a/internal/config/v1/plugin_diagnostic_test.go b/internal/config/v1/plugin_diagnostic_test.go
new file mode 100644
index 00000000..d8118217
--- /dev/null
+++ b/internal/config/v1/plugin_diagnostic_test.go
@@ -0,0 +1,23 @@
+package v1
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestEmbeddedRemoteVersionDiagnostic(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct{ name, remote, version string }{
+		{name: "legacy URI", remote: "registry.example.test/go:v1.2.3"},
+		{name: "legacy URI with port", remote: "localhost:8080/go:v1.2.3"},
+		{name: "conflicting versions", remote: "registry.example.test/go:v1.2.3", version: "v2.0.0"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			err := (Plugin{Remote: tt.remote, Version: tt.version, Out: "gen"}).Validate()
+			require.ErrorContains(t, err, "specify the remote plugin version only in version")
+			require.ErrorContains(t, err, `version: "v1.2.3"`)
+		})
+	}
+}
diff --git a/internal/config/v1/plugin_options.go b/internal/config/v1/plugin_options.go
new file mode 100644
index 00000000..e8479acc
--- /dev/null
+++ b/internal/config/v1/plugin_options.go
@@ -0,0 +1,42 @@
+package v1
+
+import (
+	"fmt"
+	"strings"
+
+	"gopkg.in/yaml.v3"
+
+	"github.com/easyp-tech/easyp/internal/config"
+)
+
+// PluginOptions preserves repeated values for each plugin flag.
+type PluginOptions map[string][]string
+
+// UnmarshalYAML accepts an options mapping or a sequence of flag strings.
+func (o *PluginOptions) UnmarshalYAML(node *yaml.Node) error {
+	switch node.Kind {
+	case yaml.MappingNode:
+		var mapped config.PluginOpts
+		if err := mapped.UnmarshalYAML(node); err != nil {
+			return fmt.Errorf("UnmarshalYAML: %w", err)
+		}
+		*o = PluginOptions(mapped)
+		return nil
+	case yaml.SequenceNode:
+		result := make(PluginOptions)
+		for i, item := range node.Content {
+			if item.Kind != yaml.ScalarNode {
+				return fmt.Errorf("opts[%d] must be a flag string", i)
+			}
+			key, value, _ := strings.Cut(item.Value, "=")
+			if key == "" {
+				return fmt.Errorf("opts[%d] has an empty flag name", i)
+			}
+			result[key] = append(result[key], value)
+		}
+		*o = result
+		return nil
+	default:
+		return fmt.Errorf("plugin opts must be a mapping or string list")
+	}
+}
diff --git a/internal/config/v1/plugin_options_test.go b/internal/config/v1/plugin_options_test.go
new file mode 100644
index 00000000..606f6eb4
--- /dev/null
+++ b/internal/config/v1/plugin_options_test.go
@@ -0,0 +1,71 @@
+package v1
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"gopkg.in/yaml.v3"
+)
+
+func TestPluginOptionsUnmarshalYAML(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name            string
+		contents        string
+		expected        PluginOptions
+		expectedMessage string
+	}{
+		{
+			name:     "mapping preserves repeated values",
+			contents: "paths: source_relative\nfeatures: [one, two]\n",
+			expected: PluginOptions{"paths": {"source_relative"}, "features": {"one", "two"}},
+		},
+		{
+			name:     "flag list preserves repetitions and equals in values",
+			contents: "[feature=one, feature=two, debug, expression=a=b]",
+			expected: PluginOptions{"feature": {"one", "two"}, "debug": {""}, "expression": {"a=b"}},
+		},
+		{name: "empty mapping", contents: "{}", expected: PluginOptions{}},
+		{name: "empty list", contents: "[]", expected: PluginOptions{}},
+		{
+			name:            "non-scalar item",
+			contents:        "[ok=value, [nested]]",
+			expectedMessage: "opts[1] must be a flag string",
+		},
+		{
+			name:            "empty flag name",
+			contents:        "[ok=value, '=bad']",
+			expectedMessage: "opts[1] has an empty flag name",
+		},
+		{
+			name:            "nested mapping value",
+			contents:        "option: {nested: value}",
+			expectedMessage: `opts["option"] must be scalar or sequence`,
+		},
+		{
+			name:            "scalar options",
+			contents:        "invalid",
+			expectedMessage: "plugin opts must be a mapping or string list",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			var options PluginOptions
+
+			err := yaml.Unmarshal([]byte(tt.contents), &options)
+
+			if tt.expectedMessage != "" {
+				require.ErrorContains(t, err, tt.expectedMessage)
+				assert.Nil(t, options, "invalid options must not leave a partially decoded map")
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, tt.expected, options)
+		})
+	}
+}
diff --git a/internal/config/v1/plugin_schema_parity_test.go b/internal/config/v1/plugin_schema_parity_test.go
new file mode 100644
index 00000000..b04088e0
--- /dev/null
+++ b/internal/config/v1/plugin_schema_parity_test.go
@@ -0,0 +1,60 @@
+package v1
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/config"
+)
+
+func TestGenerateSchemaPluginVersionParity(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name      string
+		raw       string
+		wantError bool
+	}{
+		{
+			name:      "local name rejects version structurally",
+			raw:       "version: v1\nplugins:\n  - name: go\n    version: v1.2.3\n    out: gen\n",
+			wantError: true,
+		},
+		{
+			name:      "path rejects version structurally",
+			raw:       "version: v1\nplugins:\n  - path: ./protoc-gen-x\n    version: v1.2.3\n    out: gen\n",
+			wantError: true,
+		},
+		{
+			name:      "command rejects version structurally",
+			raw:       "version: v1\nplugins:\n  - command: [sh, ./plugin.sh]\n    version: v1.2.3\n    out: gen\n",
+			wantError: true,
+		},
+		{
+			name:      "remote requires version structurally",
+			raw:       "version: v1\nplugins:\n  - remote: plugins.example.test/protobuf/go\n    out: gen\n",
+			wantError: true,
+		},
+		{
+			name: "remote with version is structurally valid",
+			raw:  "version: v1\nplugins:\n  - remote: plugins.example.test/protobuf/go\n    version: v1.2.3\n    out: gen\n",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			issues := ValidateGenerateYAML([]byte(tt.raw))
+
+			if tt.wantError {
+				require.True(t, config.HasErrors(issues), "%+v", issues)
+				return
+			}
+			assert.False(t, config.HasErrors(issues), "%+v", issues)
+		})
+	}
+}
diff --git a/internal/config/v1/plugin_test.go b/internal/config/v1/plugin_test.go
new file mode 100644
index 00000000..bee09cbf
--- /dev/null
+++ b/internal/config/v1/plugin_test.go
@@ -0,0 +1,114 @@
+package v1
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestPluginValidate(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name            string
+		plugin          Plugin
+		expectedMessage string
+	}{
+		{
+			name:   "bundled plugin",
+			plugin: Plugin{Name: "go", Out: "gen"},
+		},
+		{
+			name:   "pinned remote plugin with server port",
+			plugin: Plugin{Remote: "localhost:8080/go", Version: "v1.2.3", Out: "gen"},
+		},
+		{
+			name:   "binary path",
+			plugin: Plugin{Path: "./tools/protoc-gen-custom", Out: "gen"},
+		},
+		{
+			name:   "custom command",
+			plugin: Plugin{Command: []string{"sh", "./tools/run-plugin"}, Out: "gen"},
+		},
+		{
+			name:            "no source",
+			plugin:          Plugin{Out: "gen"},
+			expectedMessage: "exactly one of name, path, command or remote is required",
+		},
+		{
+			name:            "both sources",
+			plugin:          Plugin{Name: "go", Remote: "example.com/go", Out: "gen"},
+			expectedMessage: "exactly one of name, path, command or remote is required",
+		},
+		{
+			name:            "name and path",
+			plugin:          Plugin{Name: "go", Path: "./tools/protoc-gen-custom", Out: "gen"},
+			expectedMessage: "exactly one of name, path, command or remote is required",
+		},
+		{
+			name:            "empty command",
+			plugin:          Plugin{Command: []string{}, Out: "gen"},
+			expectedMessage: "command executable is required",
+		},
+		{
+			name:            "name and empty command",
+			plugin:          Plugin{Name: "go", Command: []string{}, Out: "gen"},
+			expectedMessage: "exactly one of name, path, command or remote is required",
+		},
+		{
+			name:            "empty command executable",
+			plugin:          Plugin{Command: []string{"", "./tools/run-plugin"}, Out: "gen"},
+			expectedMessage: "command executable is required",
+		},
+		{
+			name:            "missing output directory",
+			plugin:          Plugin{Name: "go"},
+			expectedMessage: "out is required",
+		},
+		{
+			name:            "moving latest version",
+			plugin:          Plugin{Remote: "example.com/go", Version: "go:latest", Out: "gen"},
+			expectedMessage: "latest version is not reproducible",
+		},
+		{
+			name:            "unverifiable local version",
+			plugin:          Plugin{Name: "go", Version: "v1.2.3", Out: "gen"},
+			expectedMessage: "version cannot be verified",
+		},
+		{
+			name:            "unverifiable binary path version",
+			plugin:          Plugin{Path: "./tools/protoc-gen-custom", Version: "v1.2.3", Out: "gen"},
+			expectedMessage: "version cannot be verified",
+		},
+		{
+			name:            "unverifiable custom command version",
+			plugin:          Plugin{Command: []string{"sh", "./tools/run-plugin"}, Version: "v1.2.3", Out: "gen"},
+			expectedMessage: "version cannot be verified",
+		},
+		{
+			name:            "unpinned remote plugin",
+			plugin:          Plugin{Remote: "example.com/go", Out: "gen"},
+			expectedMessage: "remote plugin requires a pinned semantic version",
+		},
+		{
+			name:            "version embedded in remote name",
+			plugin:          Plugin{Remote: "example.com/go:v1.2.3", Version: "v1.2.3", Out: "gen"},
+			expectedMessage: "specify the remote plugin version only in version",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			err := tt.plugin.Validate()
+
+			if tt.expectedMessage != "" {
+				require.ErrorContains(t, err, tt.expectedMessage)
+				return
+			}
+			require.NoError(t, err)
+		})
+	}
+}
diff --git a/internal/config/v1/policy.go b/internal/config/v1/policy.go
new file mode 100644
index 00000000..c515dcb0
--- /dev/null
+++ b/internal/config/v1/policy.go
@@ -0,0 +1,173 @@
+package v1
+
+import (
+	"bytes"
+	"fmt"
+	"io"
+	"strings"
+
+	"gopkg.in/yaml.v3"
+
+	"github.com/easyp-tech/easyp/internal/config"
+)
+
+// Policy is the producer-side v1 easyp.yaml configuration.
+type Policy struct {
+	Version        string                       `yaml:"version"`
+	Linters        LinterPolicy                 `yaml:"linters"`
+	LinterSettings map[string]map[string]string `yaml:"linters-settings"`
+	Issues         IssuePolicy                  `yaml:"issues"`
+	Breaking       BreakingPolicy               `yaml:"breaking"`
+}
+
+// LinterPolicy selects the default preset and individual linter rules.
+type LinterPolicy struct {
+	Default             string   `yaml:"default"`
+	Enable              []string `yaml:"enable"`
+	Disable             []string `yaml:"disable"`
+	Extends             string   `yaml:"extends"`
+	AllowCommentIgnores *bool    `yaml:"allow_comment_ignores"`
+}
+
+// IssuePolicy controls suppression of lint findings.
+type IssuePolicy struct {
+	ExcludeRules []IssueExcludeRule `yaml:"exclude-rules"`
+}
+
+// IssueExcludeRule selects the linters and paths to exclude from reporting.
+type IssueExcludeRule struct {
+	Path    string   `yaml:"path"`
+	Linters []string `yaml:"linters"`
+}
+
+// BreakingPolicy selects a baseline and compatibility checks.
+type BreakingPolicy struct {
+	Baseline       string   `yaml:"baseline"`
+	Categories     []string `yaml:"categories"`
+	IgnoreUnstable bool     `yaml:"ignore_unstable"`
+	Extends        string   `yaml:"extends"`
+	Ignore         []string `yaml:"ignore"`
+}
+
+// ParsePolicy reads and validates a consumer-owned v1 lint and breaking policy.
+// Environment placeholders are expanded before validation.
+func ParsePolicy(r io.Reader) (Policy, error) {
+	raw, err := expandConfigYAML(r)
+	if err != nil {
+		return Policy{}, fmt.Errorf("expandConfigYAML: %w", err)
+	}
+	return parsePolicyBytes(raw)
+}
+
+// ParsePolicyLiteral reads and validates a v1 policy without expanding
+// environment placeholders. Dependency-owned shared policies use this form so
+// their contents cannot read values from the consumer process environment.
+func ParsePolicyLiteral(r io.Reader) (Policy, error) {
+	raw, err := io.ReadAll(r)
+	if err != nil {
+		return Policy{}, fmt.Errorf("ReadAll: %w", err)
+	}
+	return parsePolicyBytes(raw)
+}
+
+func parsePolicyBytes(raw []byte) (Policy, error) {
+	if LegacyPolicy(raw) {
+		return Policy{}, ErrLegacyConfiguration
+	}
+	var result Policy
+	decoder := yaml.NewDecoder(bytes.NewReader(raw))
+	decoder.KnownFields(true)
+	if err := decoder.Decode(&result); err != nil {
+		return Policy{}, fmt.Errorf("decode easyp.yaml: %w", err)
+	}
+	if err := requireSingleYAMLDocument(decoder, PolicyFile); err != nil {
+		return Policy{}, err
+	}
+	if result.Version == "" {
+		result.Version = "v1"
+	}
+	if result.Linters.Default == "" {
+		result.Linters.Default = "STANDARD"
+	}
+	if err := result.validateSemantics(); err != nil {
+		return Policy{}, err
+	}
+	if err := yamlValidationError(PolicyFile, validateExpandedV1YAML(raw, policySchema)); err != nil {
+		return Policy{}, err
+	}
+	return result, nil
+}
+
+// LintConfig translates the policy into the lint engine configuration.
+func (p Policy) LintConfig() (config.LintConfig, error) {
+	if p.Linters.Extends != "" {
+		return config.LintConfig{}, fmt.Errorf("linters.extends %q was not resolved", p.Linters.Extends)
+	}
+	if err := p.validateSemantics(); err != nil {
+		return config.LintConfig{}, err
+	}
+	use := []string{"MINIMAL"}
+	switch p.Linters.Default {
+	case "BASIC":
+		use = append(use, "BASIC")
+	case "STANDARD":
+		use = append(use, "BASIC", "DEFAULT")
+	case "COMMENTS":
+		use = append(use, "BASIC", "DEFAULT", "COMMENTS")
+	}
+	use = append(use, p.Linters.Enable...)
+	cfg := config.LintConfig{Use: use, Except: append([]string(nil), p.Linters.Disable...), AllowCommentIgnores: true}
+	if p.Linters.AllowCommentIgnores != nil {
+		cfg.AllowCommentIgnores = *p.Linters.AllowCommentIgnores
+	}
+	for _, rule := range p.Issues.ExcludeRules {
+		if rule.Path == "" {
+			cfg.Except = append(cfg.Except, rule.Linters...)
+		}
+	}
+	for rule, settings := range p.LinterSettings {
+		switch rule {
+		case "ENUM_ZERO_VALUE_SUFFIX":
+			cfg.EnumZeroValueSuffix = settings["suffix"]
+		case "SERVICE_SUFFIX":
+			cfg.ServiceSuffix = settings["suffix"]
+		}
+	}
+	return cfg, nil
+}
+
+// ExcludesAllIssues reports whether a pathless exclusion suppresses every
+// linter for all files covered by this policy.
+func (p Policy) ExcludesAllIssues() bool {
+	for _, rule := range p.Issues.ExcludeRules {
+		if rule.Path == "" && len(rule.Linters) == 0 {
+			return true
+		}
+	}
+	return false
+}
+
+// BreakingConfig maps the v1 baseline and selected compatibility profiles onto the checker.
+func (p Policy) BreakingConfig(fallbackRef string) (config.BreakingCheck, error) {
+	if p.Breaking.Extends != "" {
+		return config.BreakingCheck{}, fmt.Errorf("breaking.extends %q was not resolved", p.Breaking.Extends)
+	}
+	if err := p.validateSemantics(); err != nil {
+		return config.BreakingCheck{}, err
+	}
+	baseline := strings.TrimPrefix(p.Breaking.Baseline, "git:")
+	if baseline == "" {
+		baseline = fallbackRef
+	}
+	categories := append([]string(nil), p.Breaking.Categories...)
+	if len(categories) == 0 {
+		categories = []string{"FILE"}
+	}
+	return config.BreakingCheck{
+		AgainstGitRef:  baseline,
+		Ignore:         p.Breaking.Ignore,
+		Use:            append([]string(nil), categories...),
+		Categories:     categories,
+		IgnoreUnstable: p.Breaking.IgnoreUnstable,
+	}, nil
+}
diff --git a/internal/config/v1/policy_merge.go b/internal/config/v1/policy_merge.go
new file mode 100644
index 00000000..3bd1b586
--- /dev/null
+++ b/internal/config/v1/policy_merge.go
@@ -0,0 +1,210 @@
+package v1
+
+import (
+	"maps"
+	"slices"
+
+	"github.com/easyp-tech/easyp/internal/rules"
+)
+
+// DefaultLinterPreset is the preset a policy file uses when its linters section
+// does not select one.
+const DefaultLinterPreset = "STANDARD"
+
+// linterFields and breakingFields name the mergeable fields of a section.
+const (
+	lintersFieldDefault  = "default"
+	lintersFieldComments = "allow_comment_ignores"
+
+	breakingFieldBaseline = "baseline"
+	breakingFieldCategory = "categories"
+	breakingFieldUnstable = "ignore_unstable"
+	breakingFieldIgnore   = "ignore"
+)
+
+// BaseLinterSection turns the linters section of a base policy into a decided
+// section: every field carries a value, so a local section above it only has to
+// state its own adjustments. An absent preset and an absent comment setting take
+// the same defaults a standalone policy file would use.
+func BaseLinterSection(policy LinterPolicy, presence PolicyPresence) LinterPolicy {
+	base := LinterPolicy{
+		Default: DefaultLinterPreset,
+		Enable:  slices.Clone(policy.Enable),
+		Disable: slices.Clone(policy.Disable),
+	}
+	if presence.Field(PolicySectionLinters, lintersFieldDefault) {
+		base.Default = policy.Default
+	}
+	base.AllowCommentIgnores = boolPointer(policy.AllowCommentIgnores, true)
+	return base
+}
+
+// MergeLinterSection applies a resolved base section under the local section.
+// Without a base the local section is returned unchanged, which keeps the
+// whole-section cascade identical for policies that do not extend anything.
+func MergeLinterSection(base, local LinterPolicy, presence PolicyPresence, hasBase bool) LinterPolicy {
+	if !hasBase {
+		return local
+	}
+	merged := LinterPolicy{Default: base.Default}
+	if presence.Field(PolicySectionLinters, lintersFieldDefault) {
+		merged.Default = local.Default
+	}
+	selections := newLinterSelections()
+	selections.addLayer(base.Enable, base.Disable)
+	selections.addLayer(local.Enable, local.Disable)
+	merged.Enable, merged.Disable = selections.resolve()
+	if presence.Field(PolicySectionLinters, lintersFieldComments) {
+		merged.AllowCommentIgnores = boolPointer(local.AllowCommentIgnores, false)
+	} else {
+		merged.AllowCommentIgnores = boolPointer(base.AllowCommentIgnores, true)
+	}
+	return merged
+}
+
+// boolPointer copies a presence-aware boolean setting, falling back to the
+// value an absent setting means for that layer.
+func boolPointer(value *bool, fallback bool) *bool {
+	resolved := fallback
+	if value != nil {
+		resolved = *value
+	}
+	return &resolved
+}
+
+// MergeLinterSettings merges base settings under the local settings section.
+// Local values win per rule and key; a present but empty local section clears
+// everything the base provided.
+func MergeLinterSettings(base, local map[string]map[string]string, presence PolicyPresence, hasBase bool) map[string]map[string]string {
+	if !hasBase {
+		return local
+	}
+	merged := make(map[string]map[string]string, len(base)+len(local))
+	if !presence.Has(PolicySectionLinterSettings) {
+		for rule, values := range base {
+			merged[rule] = maps.Clone(values)
+		}
+		return merged
+	}
+	if len(local) == 0 {
+		return merged
+	}
+	for rule, values := range base {
+		merged[rule] = maps.Clone(values)
+	}
+	for rule, values := range local {
+		if len(values) == 0 {
+			merged[rule] = maps.Clone(values)
+			continue
+		}
+		if merged[rule] == nil {
+			merged[rule] = make(map[string]string)
+		}
+		maps.Copy(merged[rule], values)
+	}
+	return merged
+}
+
+// BaseBreakingSection turns the breaking section of a base policy into a
+// decided section. The values are applied at the consuming policy location, so
+// a baseline or ignore path taken from a base is interpreted by the consumer.
+func BaseBreakingSection(policy BreakingPolicy, presence PolicyPresence) BreakingPolicy {
+	return BreakingPolicy{
+		Baseline:       policy.Baseline,
+		Categories:     slices.Clone(policy.Categories),
+		IgnoreUnstable: policy.IgnoreUnstable,
+		Ignore:         slices.Clone(policy.Ignore),
+	}
+}
+
+// MergeBreakingSection applies a resolved base section under the local section.
+// A local value overrides the base only when the source actually wrote it, so an
+// explicit false, an empty category list and an empty ignore list survive.
+func MergeBreakingSection(base, local BreakingPolicy, presence PolicyPresence, hasBase bool) BreakingPolicy {
+	if !hasBase {
+		return local
+	}
+	merged := BreakingPolicy{
+		Baseline:       base.Baseline,
+		Categories:     slices.Clone(base.Categories),
+		IgnoreUnstable: base.IgnoreUnstable,
+		Ignore:         slices.Clone(base.Ignore),
+	}
+	if presence.Field(PolicySectionBreaking, breakingFieldBaseline) {
+		merged.Baseline = local.Baseline
+	}
+	if presence.Field(PolicySectionBreaking, breakingFieldCategory) {
+		merged.Categories = slices.Clone(local.Categories)
+	}
+	if presence.Field(PolicySectionBreaking, breakingFieldUnstable) {
+		merged.IgnoreUnstable = local.IgnoreUnstable
+	}
+	if presence.Field(PolicySectionBreaking, breakingFieldIgnore) {
+		merged.Ignore = slices.Clone(local.Ignore)
+	}
+	return merged
+}
+
+// linterSelections accumulates effective enable and disable selections while
+// walking the chain from the deepest base to the local policy.
+type linterSelections struct {
+	enabled  map[string]bool
+	disabled map[string]bool
+}
+
+func newLinterSelections() *linterSelections {
+	return &linterSelections{enabled: make(map[string]bool), disabled: make(map[string]bool)}
+}
+
+// addLayer applies one policy layer. Groups expand to their rules so a local
+// enable re-enables a single rule that a base group disabled, and a disable
+// written in the same layer wins over an enable.
+func (s *linterSelections) addLayer(enable, disable []string) {
+	for _, selection := range expandLinterSelections(enable) {
+		delete(s.disabled, selection)
+		s.enabled[selection] = true
+	}
+	for _, selection := range expandLinterSelections(disable) {
+		delete(s.enabled, selection)
+		s.disabled[selection] = true
+	}
+}
+
+// resolve returns the enabled and disabled selections in stable lexical order, so
+// the engine expands the same rules once and never reports a rule twice.
+func (s *linterSelections) resolve() (enabled, disabled []string) {
+	for selection := range s.enabled {
+		enabled = append(enabled, selection)
+	}
+	for selection := range s.disabled {
+		disabled = append(disabled, selection)
+	}
+	slices.Sort(enabled)
+	slices.Sort(disabled)
+	return enabled, disabled
+}
+
+// expandLinterSelections replaces group keys with their rules and removes
+// duplicates while preserving the written order.
+func expandLinterSelections(selections []string) []string {
+	groups := rules.AllGroups()
+	var expanded []string
+	seen := make(map[string]bool, len(selections))
+	for _, selection := range selections {
+		names := []string{selection}
+		for _, group := range groups {
+			if group.Key == selection {
+				names = group.Rules
+				break
+			}
+		}
+		for _, name := range names {
+			if seen[name] {
+				continue
+			}
+			seen[name] = true
+			expanded = append(expanded, name)
+		}
+	}
+	return expanded
+}
diff --git a/internal/config/v1/policy_merge_test.go b/internal/config/v1/policy_merge_test.go
new file mode 100644
index 00000000..0cdf612f
--- /dev/null
+++ b/internal/config/v1/policy_merge_test.go
@@ -0,0 +1,260 @@
+package v1
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func presenceOf(t *testing.T, raw string) PolicyPresence {
+	t.Helper()
+	presence, err := ParsePolicyPresence([]byte(raw))
+	require.NoError(t, err)
+	return presence
+}
+
+func boolValue(t *testing.T, value *bool) bool {
+	t.Helper()
+	require.NotNil(t, value)
+	return *value
+}
+
+func TestParsePolicyPresence(t *testing.T) {
+	t.Parallel()
+
+	presence := presenceOf(t, "version: v1\nlinters:\n  enable: [FIELD_LOWER_SNAKE_CASE]\n  allow_comment_ignores: false\nlinters-settings:\n  SERVICE_SUFFIX:\n    suffix: Api\nbreaking:\n  categories: []\n  ignore_unstable: false\n")
+	assert.True(t, presence.Has(PolicySectionLinters))
+	assert.True(t, presence.Has(PolicySectionLinterSettings))
+	assert.False(t, presence.Has(PolicySectionIssues))
+	assert.False(t, presence.Has(PolicySectionBreaking+" "))
+	assert.True(t, presence.Field(PolicySectionLinters, "enable"))
+	assert.False(t, presence.Field(PolicySectionLinters, "default"))
+	assert.False(t, presence.Field(PolicySectionLinters, "disable"))
+	assert.True(t, presence.Field(PolicySectionLinters, "allow_comment_ignores"))
+	assert.True(t, presence.Field(PolicySectionLinterSettings, "SERVICE_SUFFIX"))
+	assert.True(t, presence.Field(PolicySectionBreaking, "categories"))
+	assert.True(t, presence.Field(PolicySectionBreaking, "ignore_unstable"))
+	assert.False(t, presence.Field(PolicySectionBreaking, "baseline"))
+
+	empty := presenceOf(t, "linters: {}\nlinters-settings: {}\n")
+	assert.True(t, empty.Has(PolicySectionLinters))
+	assert.Empty(t, empty.Fields[PolicySectionLinters])
+	assert.True(t, empty.Has(PolicySectionLinterSettings))
+
+	scalar, err := ParsePolicyPresence([]byte(""))
+	require.NoError(t, err)
+	assert.False(t, scalar.Has(PolicySectionLinters))
+}
+
+func TestParsePolicyPresenceRejectsNonMappingDocument(t *testing.T) {
+	t.Parallel()
+
+	presence, err := ParsePolicyPresence([]byte("- one\n- two\n"))
+	require.NoError(t, err)
+	assert.False(t, presence.Has(PolicySectionLinters))
+}
+
+func TestMergeLinterSectionWithoutBaseKeepsLocalSection(t *testing.T) {
+	t.Parallel()
+
+	local := LinterPolicy{Default: "MINIMAL", Enable: []string{"FIELD_LOWER_SNAKE_CASE"}}
+	presence := presenceOf(t, "linters:\n  default: MINIMAL\n  enable: [FIELD_LOWER_SNAKE_CASE]\n")
+	merged := MergeLinterSection(LinterPolicy{}, local, presence, false)
+	assert.Equal(t, local, merged)
+}
+
+func TestMergeLinterSectionBaseDefaultAndLocalOverride(t *testing.T) {
+	t.Parallel()
+
+	base := BaseLinterSection(LinterPolicy{Default: "STANDARD"}, presenceOf(t, "linters:\n  default: STANDARD\n"))
+	assert.Equal(t, "STANDARD", base.Default)
+	assert.True(t, boolValue(t, base.AllowCommentIgnores))
+
+	// An absent preset in the base is decided once, then overridden locally.
+	base = BaseLinterSection(mustPolicy(t, "linters:\n  enable: [ENUM_VALUE_PREFIX]\n").Linters, presenceOf(t, "linters:\n  enable: [ENUM_VALUE_PREFIX]\n"))
+	assert.Equal(t, DefaultLinterPreset, base.Default)
+
+	local := presenceOf(t, "linters:\n  default: MINIMAL\n")
+	merged := MergeLinterSection(base, LinterPolicy{Default: "MINIMAL"}, local, true)
+	assert.Equal(t, "MINIMAL", merged.Default)
+	assert.Equal(t, []string{"ENUM_VALUE_PREFIX"}, merged.Enable)
+	assert.Empty(t, merged.Disable)
+	assert.Empty(t, merged.Extends)
+}
+
+func TestMergeLinterSectionEmptyLocalDefaultIsKept(t *testing.T) {
+	t.Parallel()
+
+	base := BaseLinterSection(LinterPolicy{Default: "STANDARD"}, presenceOf(t, "linters:\n  default: STANDARD\n"))
+	presence := presenceOf(t, "linters:\n  default: ''\n")
+	merged := MergeLinterSection(base, LinterPolicy{Default: ""}, presence, true)
+	assert.Equal(t, "", merged.Default)
+}
+
+func TestMergeLinterSectionSelectionPrecedence(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name            string
+		base            string
+		local           string
+		wantEnable      []string
+		wantDisable     []string
+		wantAllowIgnore bool
+	}{
+		{
+			name:            "base disable retained",
+			base:            "linters:\n  default: MINIMAL\n  enable: [FIELD_LOWER_SNAKE_CASE]\n  disable: [FIELD_LOWER_SNAKE_CASE]\n",
+			local:           "linters:\n  extends: ./base.yaml\n",
+			wantEnable:      nil,
+			wantDisable:     []string{"FIELD_LOWER_SNAKE_CASE"},
+			wantAllowIgnore: true,
+		},
+		{
+			name:            "local enable re-enables base disable",
+			base:            "linters:\n  default: MINIMAL\n  disable: [FIELD_LOWER_SNAKE_CASE]\n",
+			local:           "linters:\n  extends: ./base.yaml\n  enable: [FIELD_LOWER_SNAKE_CASE]\n",
+			wantEnable:      []string{"FIELD_LOWER_SNAKE_CASE"},
+			wantDisable:     nil,
+			wantAllowIgnore: true,
+		},
+		{
+			name:            "local disable wins in the same layer",
+			base:            "linters:\n  default: MINIMAL\n  enable: [FIELD_LOWER_SNAKE_CASE]\n",
+			local:           "linters:\n  extends: ./base.yaml\n  enable: [FIELD_LOWER_SNAKE_CASE]\n  disable: [FIELD_LOWER_SNAKE_CASE]\n",
+			wantEnable:      nil,
+			wantDisable:     []string{"FIELD_LOWER_SNAKE_CASE"},
+			wantAllowIgnore: true,
+		},
+		{
+			name:            "explicit false keeps base true out",
+			base:            "linters:\n  default: MINIMAL\n  allow_comment_ignores: true\n",
+			local:           "linters:\n  extends: ./base.yaml\n  allow_comment_ignores: false\n",
+			wantAllowIgnore: false,
+		},
+		{
+			name:            "base false is inherited when local is silent",
+			base:            "linters:\n  default: MINIMAL\n  allow_comment_ignores: false\n",
+			local:           "linters:\n  extends: ./base.yaml\n",
+			wantAllowIgnore: false,
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			base := BaseLinterSection(mustPolicy(t, tt.base).Linters, presenceOf(t, tt.base))
+			localPolicy := mustPolicy(t, tt.local)
+			merged := MergeLinterSection(base, localPolicy.Linters, presenceOf(t, tt.local), true)
+			assert.Equal(t, tt.wantEnable, merged.Enable)
+			assert.Equal(t, tt.wantDisable, merged.Disable)
+			assert.Equal(t, tt.wantAllowIgnore, boolValue(t, merged.AllowCommentIgnores))
+		})
+	}
+}
+
+func TestMergeLinterSectionBaseGroupDisableExpandsEveryRule(t *testing.T) {
+	t.Parallel()
+
+	base := BaseLinterSection(LinterPolicy{Disable: []string{"COMMENTS"}}, presenceOf(t, "linters:\n  disable: [COMMENTS]\n"))
+	merged := MergeLinterSection(base, LinterPolicy{}, presenceOf(t, "linters:\n  extends: ./base.yaml\n"), true)
+	assert.Empty(t, merged.Enable)
+	assert.Len(t, merged.Disable, 7)
+	assert.Contains(t, merged.Disable, "COMMENT_MESSAGE")
+
+	base = BaseLinterSection(LinterPolicy{Disable: []string{"BASIC"}}, presenceOf(t, "linters:\n  disable: [BASIC]\n"))
+	local := presenceOf(t, "linters:\n  extends: ./base.yaml\n  enable: [FIELD_LOWER_SNAKE_CASE]\n")
+	merged = MergeLinterSection(base, LinterPolicy{Enable: []string{"FIELD_LOWER_SNAKE_CASE"}}, local, true)
+	assert.Contains(t, merged.Enable, "FIELD_LOWER_SNAKE_CASE")
+	assert.NotContains(t, merged.Disable, "FIELD_LOWER_SNAKE_CASE")
+	assert.Len(t, merged.Disable, 19)
+}
+
+func TestMergeLinterSectionDedupsRepeatedSelections(t *testing.T) {
+	t.Parallel()
+
+	base := BaseLinterSection(LinterPolicy{Enable: []string{"FIELD_LOWER_SNAKE_CASE", "FIELD_LOWER_SNAKE_CASE"}}, presenceOf(t, "linters:\n  enable: [FIELD_LOWER_SNAKE_CASE, FIELD_LOWER_SNAKE_CASE]\n"))
+	local := presenceOf(t, "linters:\n  extends: ./base.yaml\n  enable: [FIELD_LOWER_SNAKE_CASE, BASIC]\n")
+	merged := MergeLinterSection(base, LinterPolicy{Enable: []string{"FIELD_LOWER_SNAKE_CASE", "BASIC"}}, local, true)
+	assert.Len(t, merged.Enable, 20)
+	assert.Contains(t, merged.Enable, "FIELD_LOWER_SNAKE_CASE")
+}
+
+func TestMergeLinterSettings(t *testing.T) {
+	t.Parallel()
+
+	base := map[string]map[string]string{
+		"ENUM_ZERO_VALUE_SUFFIX": {"suffix": "NONE"},
+		"SERVICE_SUFFIX":         {"suffix": "Base"},
+	}
+
+	t.Run("local wins per rule", func(t *testing.T) {
+		t.Parallel()
+		local := map[string]map[string]string{"SERVICE_SUFFIX": {"suffix": "Api"}}
+		merged := MergeLinterSettings(base, local, presenceOf(t, "linters-settings:\n  SERVICE_SUFFIX:\n    suffix: Api\n"), true)
+		assert.Equal(t, "NONE", merged["ENUM_ZERO_VALUE_SUFFIX"]["suffix"])
+		assert.Equal(t, "Api", merged["SERVICE_SUFFIX"]["suffix"])
+		merged["SERVICE_SUFFIX"]["suffix"] = "changed"
+		assert.Equal(t, "Base", base["SERVICE_SUFFIX"]["suffix"], "base settings must not be mutated")
+	})
+
+	t.Run("explicit empty section clears", func(t *testing.T) {
+		t.Parallel()
+		merged := MergeLinterSettings(base, nil, presenceOf(t, "linters-settings: {}\n"), true)
+		assert.Empty(t, merged)
+	})
+
+	t.Run("empty rule clears that rule only", func(t *testing.T) {
+		t.Parallel()
+		local := map[string]map[string]string{"SERVICE_SUFFIX": {}}
+		merged := MergeLinterSettings(base, local, presenceOf(t, "linters-settings:\n  SERVICE_SUFFIX: {}\n"), true)
+		assert.Empty(t, merged["SERVICE_SUFFIX"])
+		assert.Equal(t, "NONE", merged["ENUM_ZERO_VALUE_SUFFIX"]["suffix"])
+	})
+
+	t.Run("absent local section inherits base", func(t *testing.T) {
+		t.Parallel()
+		merged := MergeLinterSettings(base, nil, presenceOf(t, "linters:\n  default: MINIMAL\n"), true)
+		assert.Equal(t, base, merged)
+	})
+
+	t.Run("without base the local section is used", func(t *testing.T) {
+		t.Parallel()
+		local := map[string]map[string]string{"SERVICE_SUFFIX": {"suffix": "Api"}}
+		assert.Equal(t, local, MergeLinterSettings(base, local, presenceOf(t, "linters-settings: {}\n"), false))
+	})
+}
+
+func TestMergeBreakingSectionOnlyOverridesPresentValues(t *testing.T) {
+	t.Parallel()
+
+	baseSource := "breaking:\n  baseline: git:base\n  categories: [FILE]\n  ignore_unstable: true\n  ignore: [skip]\n"
+	base := BaseBreakingSection(mustPolicy(t, baseSource).Breaking, presenceOf(t, baseSource))
+	assert.Equal(t, BreakingPolicy{Baseline: "git:base", Categories: []string{"FILE"}, IgnoreUnstable: true, Ignore: []string{"skip"}}, base)
+
+	local := "breaking:\n  extends: ./base.yaml\n"
+	merged := MergeBreakingSection(base, BreakingPolicy{}, presenceOf(t, local), true)
+	assert.Equal(t, base, merged)
+
+	local = "breaking:\n  extends: ./base.yaml\n  categories: []\n  ignore_unstable: false\n  ignore: []\n"
+	merged = MergeBreakingSection(base, mustPolicy(t, local).Breaking, presenceOf(t, local), true)
+	assert.Equal(t, "git:base", merged.Baseline)
+	assert.Empty(t, merged.Categories)
+	assert.False(t, merged.IgnoreUnstable)
+	assert.Empty(t, merged.Ignore)
+
+	local = "breaking:\n  extends: ./base.yaml\n  baseline: ''\n"
+	merged = MergeBreakingSection(base, mustPolicy(t, local).Breaking, presenceOf(t, local), true)
+	assert.Empty(t, merged.Baseline)
+
+	localPolicy := BreakingPolicy{Baseline: "git:local", Extends: "./base.yaml"}
+	assert.Equal(t, localPolicy, MergeBreakingSection(base, localPolicy, presenceOf(t, "breaking:\n  extends: ./base.yaml\n"), false))
+}
+
+func mustPolicy(t *testing.T, raw string) Policy {
+	t.Helper()
+	policy, err := ParsePolicy(strings.NewReader(raw))
+	require.NoError(t, err)
+	return policy
+}
diff --git a/internal/config/v1/policy_presence.go b/internal/config/v1/policy_presence.go
new file mode 100644
index 00000000..f6d37cf5
--- /dev/null
+++ b/internal/config/v1/policy_presence.go
@@ -0,0 +1,71 @@
+package v1
+
+import (
+	"fmt"
+
+	"gopkg.in/yaml.v3"
+)
+
+// PolicySection is a section name that participates in section-scoped cascading.
+const (
+	PolicySectionLinters        = "linters"
+	PolicySectionLinterSettings = "linters-settings"
+	PolicySectionIssues         = "issues"
+	PolicySectionBreaking       = "breaking"
+)
+
+// PolicyPresence records which sections and section fields a policy file
+// actually wrote. ParsePolicy fills parsed defaults such as the STANDARD preset,
+// so merging can only distinguish an explicit local choice from an inserted
+// default through the source text.
+type PolicyPresence struct {
+	Sections map[string]bool
+	Fields   map[string]map[string]bool
+}
+
+// NewPolicyPresence returns an empty presence record.
+func NewPolicyPresence() PolicyPresence {
+	return PolicyPresence{Sections: make(map[string]bool), Fields: make(map[string]map[string]bool)}
+}
+
+// ParsePolicyPresence reports the sections and fields written by a policy file.
+// It is used for local policies and for every loaded base policy, and never
+// parses values, so a malformed base still fails in ParsePolicy.
+func ParsePolicyPresence(raw []byte) (PolicyPresence, error) {
+	presence := NewPolicyPresence()
+	// Decode mappings instead of walking raw nodes: yaml.v3 applies aliases and
+	// merge-key precedence, including fields supplied through <<.
+	var document yaml.Node
+	if err := yaml.Unmarshal(raw, &document); err != nil {
+		return presence, fmt.Errorf("Unmarshal: %w", err)
+	}
+	if document.Kind != yaml.DocumentNode || len(document.Content) == 0 || document.Content[0].Kind != yaml.MappingNode {
+		return presence, nil
+	}
+	var sections map[string]yaml.Node
+	if err := document.Content[0].Decode(&sections); err != nil {
+		return presence, fmt.Errorf("Unmarshal: %w", err)
+	}
+	for name, section := range sections {
+		presence.Sections[name] = true
+		if section.Kind != yaml.MappingNode && section.Kind != yaml.AliasNode {
+			continue
+		}
+		var fields map[string]yaml.Node
+		if err := section.Decode(&fields); err != nil {
+			return presence, fmt.Errorf("policy section %s: %w", name, err)
+		}
+		present := make(map[string]bool, len(fields))
+		for field := range fields {
+			present[field] = true
+		}
+		presence.Fields[name] = present
+	}
+	return presence, nil
+}
+
+// Has reports whether the section itself is present in the source.
+func (p PolicyPresence) Has(section string) bool { return p.Sections[section] }
+
+// Field reports whether a field of a section is present in the source.
+func (p PolicyPresence) Field(section, field string) bool { return p.Fields[section][field] }
diff --git a/internal/config/v1/policy_reference.go b/internal/config/v1/policy_reference.go
new file mode 100644
index 00000000..b862755e
--- /dev/null
+++ b/internal/config/v1/policy_reference.go
@@ -0,0 +1,177 @@
+package v1
+
+import (
+	"fmt"
+	"path"
+	"strings"
+)
+
+// PolicyReference is a parsed section-level extends value. Parsing is purely
+// syntactic: it never touches Git, the module cache or the filesystem, so the
+// parser and the published schema can accept the contract without performing
+// any resolution.
+type PolicyReference struct {
+	// Raw is the trimmed reference exactly as written by the policy author.
+	Raw string
+	// Local marks ./ and ../ references resolved against the referring file.
+	Local bool
+	// Path is the local policy file or directory as written, for example
+	// ./base.yaml, ../policies or ..
+	Path string
+	// Module is the declared module identity of a remote reference.
+	Module string
+	// Relative is the explicit # fragment of a remote reference. The RFC form
+	// without a fragment is split by the resolver against known identities.
+	Relative string
+	// Fragment marks a reference written with an explicit # fragment.
+	Fragment bool
+}
+
+// Empty reports whether no base policy is requested.
+func (r PolicyReference) Empty() bool { return r.Raw == "" }
+
+// String returns the reference as written.
+func (r PolicyReference) String() string { return r.Raw }
+
+// ParsePolicyReference validates a policy extends reference without resolving
+// it. Accepted forms are:
+//
+//	./base.yaml, ../policies           local, relative to the referring policy
+//	<module>                          exact module identity, its easyp.yaml
+//	<module>#base.yaml|<module>#dir   explicit remote policy file or directory
+//	<module>/dir                      RFC form: longest known module prefix
+//
+// Versions are rejected: a dependency version is declared exactly once, in
+// protobuf.mod and protobuf.lock, and never repeated in a policy reference.
+func ParsePolicyReference(raw string) (PolicyReference, error) {
+	reference := PolicyReference{Raw: strings.TrimSpace(raw)}
+	if reference.Raw == "" {
+		return PolicyReference{}, nil
+	}
+	if err := portablePolicyText(reference.Raw); err != nil {
+		return PolicyReference{}, err
+	}
+	if strings.Contains(reference.Raw, "@") {
+		return PolicyReference{}, fmt.Errorf("policy extends %q must not repeat a version; declare it once in protobuf.mod and protobuf.lock", reference.Raw)
+	}
+	if isLocalPolicyReference(reference.Raw) {
+		return parseLocalPolicyReference(reference)
+	}
+	return parseRemotePolicyReference(reference)
+}
+
+func isLocalPolicyReference(raw string) bool {
+	return raw == "." || raw == ".." ||
+		strings.HasPrefix(raw, "./") || strings.HasPrefix(raw, "../")
+}
+
+// parseLocalPolicyReference accepts a policy file or directory relative to the
+// referring policy file. "." and ".." are directories, so a directory policy can
+// extend the easyp.yaml of its own or an ancestor directory; the resolver keeps
+// the result inside the referring container and detects self-reference.
+func parseLocalPolicyReference(reference PolicyReference) (PolicyReference, error) {
+	reference.Local = true
+	reference.Path = path.Clean(reference.Raw)
+	return reference, nil
+}
+
+func parseRemotePolicyReference(reference PolicyReference) (PolicyReference, error) {
+	module, relative, fragment, err := splitRemotePolicyReference(reference.Raw)
+	if err != nil {
+		return PolicyReference{}, err
+	}
+	reference.Module = module
+	reference.Relative = relative
+	reference.Fragment = fragment
+	return reference, nil
+}
+
+func splitRemotePolicyReference(raw string) (module, relative string, fragment bool, err error) {
+	if strings.Contains(raw, "#") {
+		module, relative, _ = strings.Cut(raw, "#")
+		fragment = true
+		if strings.Contains(relative, "#") {
+			return "", "", false, fmt.Errorf("policy extends %q has more than one # fragment", raw)
+		}
+		if relative != "" {
+			if err := validateRemotePolicyPath(raw, relative); err != nil {
+				return "", "", false, err
+			}
+		}
+	} else {
+		module = raw
+	}
+	module = strings.TrimSuffix(module, "/")
+	if err := validateModuleIdentity(raw, module); err != nil {
+		return "", "", false, err
+	}
+	return module, relative, fragment, nil
+}
+
+// validateModuleIdentity checks the shape of a remote module identity. A
+// transport spelling is accepted only because a declared module identity may
+// itself be a URL; no reference is ever fetched, so resolution is limited to
+// identities already verified by the consumer graph.
+func validateModuleIdentity(raw, module string) error {
+	if module == "" {
+		return fmt.Errorf("policy extends %q has no module identity", raw)
+	}
+	logical := module
+	if scheme, rest, ok := strings.Cut(module, "://"); ok {
+		if scheme == "" || strings.ContainsAny(scheme, "/ \t") {
+			return fmt.Errorf("policy extends %q has an invalid module identity", raw)
+		}
+		if rest == "" {
+			return fmt.Errorf("policy extends %q has an invalid module identity", raw)
+		}
+		logical = rest
+	}
+	logical = strings.Trim(logical, "/")
+	if !strings.Contains(logical, "/") {
+		return fmt.Errorf("policy extends %q must name a module identity such as github.com/acme/proto-policy, or a module declared in protobuf.mod", raw)
+	}
+	for _, element := range strings.Split(logical, "/") {
+		if element == "" || element == "." || element == ".." {
+			return fmt.Errorf("policy extends %q has an invalid module identity", raw)
+		}
+		if strings.ContainsAny(element, " \t") {
+			return fmt.Errorf("policy extends %q has an invalid module identity", raw)
+		}
+	}
+	return nil
+}
+
+// validateRemotePolicyPath keeps a module-relative policy path portable: it is
+// resolved inside a verified module and must not reach outside it.
+func validateRemotePolicyPath(raw, relative string) error {
+	if strings.HasPrefix(relative, "/") || strings.HasPrefix(relative, "\\") {
+		return fmt.Errorf("policy extends %q must use a module-relative policy path", raw)
+	}
+	if len(relative) > 1 && relative[1] == ':' {
+		return fmt.Errorf("policy extends %q must use a module-relative policy path", raw)
+	}
+	if err := portablePolicyText(relative); err != nil {
+		return err
+	}
+	for _, element := range strings.Split(relative, "/") {
+		if element == "" {
+			return fmt.Errorf("policy extends %q must use a portable module-relative policy path", raw)
+		}
+		if element == ".." {
+			return fmt.Errorf("policy extends %q must not leave its module with .. segments", raw)
+		}
+	}
+	if path.Clean(relative) == "." {
+		return fmt.Errorf("policy extends %q selects no policy", raw)
+	}
+	return nil
+}
+
+// portablePolicyText rejects characters that would not survive a checked-in
+// portable policy path or module identity.
+func portablePolicyText(raw string) error {
+	if strings.ContainsAny(raw, "\x00\r\n\\") {
+		return fmt.Errorf("policy extends %q contains unsupported characters", raw)
+	}
+	return nil
+}
diff --git a/internal/config/v1/policy_reference_test.go b/internal/config/v1/policy_reference_test.go
new file mode 100644
index 00000000..4ed5eab3
--- /dev/null
+++ b/internal/config/v1/policy_reference_test.go
@@ -0,0 +1,73 @@
+package v1
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestParsePolicyReference(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name string
+		raw  string
+		want PolicyReference
+		err  string
+	}{
+		{name: "empty", raw: "", want: PolicyReference{}},
+		{name: "whitespace", raw: "  \t\n", want: PolicyReference{}},
+		{name: "local file", raw: "./base.yaml", want: PolicyReference{Raw: "./base.yaml", Local: true, Path: "base.yaml"}},
+		{name: "local hidden directory", raw: "./.policies/base.yaml", want: PolicyReference{Raw: "./.policies/base.yaml", Local: true, Path: ".policies/base.yaml"}},
+		{name: "local directory", raw: "../policies/", want: PolicyReference{Raw: "../policies/", Local: true, Path: "../policies"}},
+		{name: "local parent", raw: "..", want: PolicyReference{Raw: "..", Local: true, Path: ".."}},
+		{name: "exact module", raw: "github.com/acme/proto-policy", want: PolicyReference{Raw: "github.com/acme/proto-policy", Module: "github.com/acme/proto-policy"}},
+		{name: "major module", raw: "github.com/acme/proto-policy/v2", want: PolicyReference{Raw: "github.com/acme/proto-policy/v2", Module: "github.com/acme/proto-policy/v2"}},
+		{name: "fragment file", raw: "github.com/acme/proto-policy#base.yaml", want: PolicyReference{Raw: "github.com/acme/proto-policy#base.yaml", Module: "github.com/acme/proto-policy", Relative: "base.yaml", Fragment: true}},
+		{name: "fragment directory", raw: "github.com/acme/proto-policy#lint/base", want: PolicyReference{Raw: "github.com/acme/proto-policy#lint/base", Module: "github.com/acme/proto-policy", Relative: "lint/base", Fragment: true}},
+		{name: "major fragment", raw: "github.com/acme/proto-policy/v2#base.yaml", want: PolicyReference{Raw: "github.com/acme/proto-policy/v2#base.yaml", Module: "github.com/acme/proto-policy/v2", Relative: "base.yaml", Fragment: true}},
+		{name: "rfc unfragmented", raw: "github.com/acme/proto-policy/lint-base", want: PolicyReference{Raw: "github.com/acme/proto-policy/lint-base", Module: "github.com/acme/proto-policy/lint-base"}},
+		{name: "url module identity", raw: "https://example.test/acme/policies#base.yaml", want: PolicyReference{Raw: "https://example.test/acme/policies#base.yaml", Module: "https://example.test/acme/policies", Relative: "base.yaml", Fragment: true}},
+		{name: "trailing module slash", raw: "github.com/acme/proto-policy/", want: PolicyReference{Raw: "github.com/acme/proto-policy/", Module: "github.com/acme/proto-policy"}},
+		{name: "version is rejected", raw: "github.com/acme/proto-policy@v1.2.3", err: "must not repeat a version"},
+		{name: "commit is rejected", raw: "github.com/acme/proto-policy#base.yaml@v1", err: "must not repeat a version"},
+		{name: "absolute Git identity", raw: "/opt/policies/base.yaml", want: PolicyReference{Raw: "/opt/policies/base.yaml", Module: "/opt/policies/base.yaml"}},
+		{name: "parent keyword", raw: "parent", err: "must name a module identity"},
+		{name: "single element", raw: "policies", err: "must name a module identity"},
+		{name: "parent segments", raw: "github.com/acme/../policies", err: "invalid module identity"},
+		{name: "empty module", raw: "#base.yaml", err: "has no module identity"},
+		{name: "repeated fragment", raw: "github.com/acme/policies#a#b", err: "more than one # fragment"},
+		{name: "escaping fragment", raw: "github.com/acme/policies#../base.yaml", err: "must not leave its module"},
+		{name: "absolute fragment", raw: "github.com/acme/policies#/base.yaml", err: "module-relative policy path"},
+		{name: "fragment empty segment", raw: "github.com/acme/policies#lint//base.yaml", err: "portable module-relative policy path"},
+		{name: "backslash", raw: `.policies\base.yaml`, err: "unsupported characters"},
+		{name: "newline", raw: "github.com/acme/poli\ncies", err: "unsupported characters"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			got, err := ParsePolicyReference(tt.raw)
+			if tt.err != "" {
+				require.ErrorContains(t, err, tt.err)
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, got)
+		})
+	}
+}
+
+func TestPolicyReferenceEmptyAndString(t *testing.T) {
+	t.Parallel()
+
+	empty, err := ParsePolicyReference("")
+	require.NoError(t, err)
+	assert.True(t, empty.Empty())
+	assert.Empty(t, empty.String())
+
+	reference, err := ParsePolicyReference(" ./base.yaml ")
+	require.NoError(t, err)
+	assert.False(t, reference.Empty())
+	assert.Equal(t, "./base.yaml", reference.String())
+}
diff --git a/internal/config/v1/policy_semantics.go b/internal/config/v1/policy_semantics.go
new file mode 100644
index 00000000..8fc3766e
--- /dev/null
+++ b/internal/config/v1/policy_semantics.go
@@ -0,0 +1,65 @@
+package v1
+
+import (
+	"fmt"
+	"slices"
+	"strings"
+
+	"github.com/easyp-tech/easyp/internal/config"
+)
+
+// validateSemantics checks the entire policy even when the caller only uses
+// lint or breaking settings. It also covers policies assembled without YAML.
+func (p Policy) validateSemantics() error {
+	if p.Version != "" && p.Version != "v1" {
+		return fmt.Errorf("easyp.yaml version must be v1")
+	}
+	switch p.Linters.Default {
+	case "", "MINIMAL", "BASIC", "STANDARD", "COMMENTS":
+	default:
+		return fmt.Errorf("unknown v1 linter preset %q", p.Linters.Default)
+	}
+	if err := p.validateLintSelections(); err != nil {
+		return fmt.Errorf("validateLintSelections: %w", err)
+	}
+	if err := p.Issues.validatePaths(); err != nil {
+		return fmt.Errorf("validatePaths: %w", err)
+	}
+	if _, err := ParsePolicyReference(p.Linters.Extends); err != nil {
+		return fmt.Errorf("linters.extends: %w", err)
+	}
+	if _, err := ParsePolicyReference(p.Breaking.Extends); err != nil {
+		return fmt.Errorf("breaking.extends: %w", err)
+	}
+	if err := config.ValidateBreakingCategories(p.Breaking.Categories); err != nil {
+		return err
+	}
+	baseline := p.Breaking.Baseline
+	if baseline != "" && (!strings.HasPrefix(baseline, "git:") || len(baseline) == len("git:") || strings.ContainsAny(baseline, "\r\n")) {
+		return fmt.Errorf("breaking.baseline must be empty or git:<ref>")
+	}
+	// Sort map keys so multiple invalid settings produce a deterministic error.
+	rules := make([]string, 0, len(p.LinterSettings))
+	for rule := range p.LinterSettings {
+		rules = append(rules, rule)
+	}
+	slices.Sort(rules)
+	for _, rule := range rules {
+		switch rule {
+		case "ENUM_ZERO_VALUE_SUFFIX", "SERVICE_SUFFIX":
+		default:
+			return fmt.Errorf("unsupported linters-settings rule %q", rule)
+		}
+		fields := make([]string, 0, len(p.LinterSettings[rule]))
+		for field := range p.LinterSettings[rule] {
+			fields = append(fields, field)
+		}
+		slices.Sort(fields)
+		for _, field := range fields {
+			if field != "suffix" {
+				return fmt.Errorf("linters-settings.%s: unsupported setting %q", rule, field)
+			}
+		}
+	}
+	return nil
+}
diff --git a/internal/config/v1/policy_semantics_test.go b/internal/config/v1/policy_semantics_test.go
new file mode 100644
index 00000000..e86a1dc0
--- /dev/null
+++ b/internal/config/v1/policy_semantics_test.go
@@ -0,0 +1,140 @@
+package v1
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/config"
+)
+
+func TestPolicySemanticValidationParity(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name string
+		raw  string
+		path string
+	}{
+		{name: "unprefixed_baseline", raw: "breaking:\n  baseline: main\n", path: "breaking.baseline"},
+		{name: "empty_git_ref", raw: "breaking:\n  baseline: 'git:'\n", path: "breaking.baseline"},
+		{name: "trailing_newline_ref", raw: "breaking:\n  baseline: \"git:main\\n\"\n", path: "breaking.baseline"},
+		{name: "multiline_ref", raw: "breaking:\n  baseline: \"git:main\\nrelease\"\n", path: "breaking.baseline"},
+		{name: "carriage_return_ref", raw: "breaking:\n  baseline: \"git:main\\r\"\n", path: "breaking.baseline"},
+		{name: "unsupported_baseline", raw: "breaking:\n  baseline: image:baseline.bin\n", path: "breaking.baseline"},
+		{name: "unknown_breaking_category", raw: "breaking:\n  categories: [UNKNOWN]\n", path: "breaking.categories"},
+		{name: "linter_extends", raw: "linters:\n  extends: policy.yaml\n", path: "linters.extends"},
+		{name: "breaking_extends", raw: "breaking:\n  extends: policy.yaml\n", path: "breaking.extends"},
+		{name: "unsupported_setting_rule", raw: "linters-settings:\n  UNKNOWN:\n    suffix: Foo\n", path: `["linters-settings"].UNKNOWN`},
+		{name: "unsupported_setting_field", raw: "linters-settings:\n  SERVICE_SUFFIX:\n    bogus: Foo\n", path: `["linters-settings"].SERVICE_SUFFIX.bogus`},
+		{name: "unsupported_enum_setting_field", raw: "linters-settings:\n  ENUM_ZERO_VALUE_SUFFIX:\n    suffix: UNSPECIFIED\n    bogus: true\n", path: `["linters-settings"].ENUM_ZERO_VALUE_SUFFIX.bogus`},
+		{name: "setting_wrong_type", raw: "linters-settings:\n  SERVICE_SUFFIX:\n    suffix: true\n", path: `["linters-settings"].SERVICE_SUFFIX.suffix`},
+		{name: "numeric_baseline", raw: "breaking:\n  baseline: 123\n", path: "breaking.baseline"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			issues := ValidatePolicyYAML([]byte(tt.raw))
+			require.True(t, config.HasErrors(issues), "%+v", issues)
+			assert.Contains(t, issues[0].Message, tt.path)
+			assert.Positive(t, issues[0].Line)
+			assert.Positive(t, issues[0].Column)
+			got, err := ParsePolicy(strings.NewReader(tt.raw))
+			require.Error(t, err, "every policy section must be validated before any consumer runs")
+			assert.Equal(t, Policy{}, got)
+			path := filepath.Join(t.TempDir(), PolicyFile)
+			require.NoError(t, os.WriteFile(path, []byte(tt.raw), 0o600))
+			fileIssues, err := ValidateFile(path)
+			require.NoError(t, err)
+			assert.Equal(t, issues, fileIssues)
+		})
+	}
+}
+
+func TestPolicySemanticValidationAcceptsEmptyAndGitBaselines(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name string
+		raw  string
+		want string
+	}{
+		{name: "omitted", raw: "version: v1\n", want: "fallback"},
+		{name: "empty", raw: "breaking:\n  baseline: ''\n", want: "fallback"},
+		{name: "git_ref", raw: "breaking:\n  baseline: git:release/v1\n", want: "release/v1"},
+		{name: "empty_reserved_and_settings", raw: "linters:\n  extends: ''\nbreaking:\n  extends: ''\nlinters-settings:\n  SERVICE_SUFFIX: {}\n  ENUM_ZERO_VALUE_SUFFIX:\n    suffix: ''\n", want: "fallback"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			assert.Empty(t, ValidatePolicyYAML([]byte(tt.raw)))
+			policy, err := ParsePolicy(strings.NewReader(tt.raw))
+			require.NoError(t, err)
+			_, err = policy.LintConfig()
+			require.NoError(t, err)
+			cfg, err := policy.BreakingConfig("fallback")
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, cfg.AgainstGitRef)
+		})
+	}
+}
+
+func TestPolicyConsumersValidateUnrelatedSections(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name   string
+		policy Policy
+		want   string
+	}{
+		{name: "baseline", policy: Policy{Breaking: BreakingPolicy{Baseline: "main"}}, want: "breaking.baseline"},
+		{name: "invalid_breaking_extends", policy: Policy{Breaking: BreakingPolicy{Extends: "parent.yaml"}}, want: "breaking.extends"},
+		{name: "invalid_linter_extends", policy: Policy{Linters: LinterPolicy{Extends: "parent.yaml"}}, want: "linters.extends"},
+		{name: "category", policy: Policy{Breaking: BreakingPolicy{Categories: []string{"UNKNOWN"}}}, want: "breaking.categories: unknown profile"},
+		{name: "setting_rule", policy: Policy{LinterSettings: map[string]map[string]string{"UNKNOWN": {"suffix": "Foo"}}}, want: "unsupported linters-settings rule"},
+		{name: "setting_field", policy: Policy{LinterSettings: map[string]map[string]string{"SERVICE_SUFFIX": {"bogus": "Foo"}}}, want: "bogus"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			_, err := tt.policy.LintConfig()
+			require.ErrorContains(t, err, tt.want)
+			_, err = tt.policy.BreakingConfig("fallback")
+			require.ErrorContains(t, err, tt.want)
+		})
+	}
+}
+
+func TestPolicyConsumersRequireOwnExtendsResolution(t *testing.T) {
+	t.Parallel()
+
+	lintPolicy := Policy{Linters: LinterPolicy{Extends: "../base.yaml"}}
+	_, err := lintPolicy.LintConfig()
+	require.ErrorContains(t, err, "was not resolved")
+	_, err = lintPolicy.BreakingConfig("fallback")
+	require.NoError(t, err)
+
+	breakingPolicy := Policy{Breaking: BreakingPolicy{Extends: "../base.yaml"}}
+	_, err = breakingPolicy.BreakingConfig("fallback")
+	require.ErrorContains(t, err, "was not resolved")
+	_, err = breakingPolicy.LintConfig()
+	require.NoError(t, err)
+}
+
+func TestPolicyValidationAcceptsPinnedExtendsWithoutNetwork(t *testing.T) {
+	t.Parallel()
+
+	raw := "version: v1\nlinters:\n  extends: github.com/acme/policies#lint/base.yaml\nbreaking:\n  extends: ../base.yaml\n"
+	assert.Empty(t, ValidatePolicyYAML([]byte(raw)))
+	policy, err := ParsePolicy(strings.NewReader(raw))
+	require.NoError(t, err)
+	require.Equal(t, "github.com/acme/policies#lint/base.yaml", policy.Linters.Extends)
+	require.Equal(t, "../base.yaml", policy.Breaking.Extends)
+
+	path := filepath.Join(t.TempDir(), PolicyFile)
+	require.NoError(t, os.WriteFile(path, []byte(raw), 0o600))
+	issues, err := ValidateFile(path)
+	require.NoError(t, err)
+	assert.Empty(t, issues)
+}
diff --git a/internal/config/v1/policy_test.go b/internal/config/v1/policy_test.go
new file mode 100644
index 00000000..060d8d23
--- /dev/null
+++ b/internal/config/v1/policy_test.go
@@ -0,0 +1,81 @@
+package v1
+
+import (
+	"strings"
+	"testing"
+)
+
+func TestParsePolicy(t *testing.T) {
+	policy, err := ParsePolicy(strings.NewReader(`version: v1
+linters:
+  default: MINIMAL
+  enable: [FILE_LOWER_SNAKE_CASE]
+  disable: [PACKAGE_DIRECTORY_MATCH]
+`))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if policy.Linters.Default != "MINIMAL" || policy.Linters.Enable[0] != "FILE_LOWER_SNAKE_CASE" {
+		t.Fatalf("unexpected policy: %#v", policy)
+	}
+}
+
+func TestParsePolicyRejectsLegacyLint(t *testing.T) {
+	if _, err := ParsePolicy(strings.NewReader("version: v1\nlint:\n  use: [DEFAULT]\n")); err == nil {
+		t.Fatal("v1 policy accepted legacy lint key")
+	}
+}
+
+func TestPathlessIssueExclusion(t *testing.T) {
+	policy, err := ParsePolicy(strings.NewReader(`version: v1
+issues:
+  exclude-rules:
+    - linters: [FILE_LOWER_SNAKE_CASE]
+`))
+	if err != nil {
+		t.Fatal(err)
+	}
+	cfg, err := policy.LintConfig()
+	if err != nil {
+		t.Fatal(err)
+	}
+	if len(cfg.Except) != 1 || cfg.Except[0] != "FILE_LOWER_SNAKE_CASE" || policy.ExcludesAllIssues() {
+		t.Fatalf("unexpected exclusion: %#v", cfg.Except)
+	}
+	all, err := ParsePolicy(strings.NewReader("version: v1\nissues:\n  exclude-rules:\n    - {}\n"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if !all.ExcludesAllIssues() {
+		t.Fatal("pathless empty rule did not suppress all issues")
+	}
+	withPath, err := ParsePolicy(strings.NewReader("version: v1\nissues:\n  exclude-rules:\n    - path: 'legacy/**'\n"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if _, err := withPath.LintConfig(); err != nil {
+		t.Fatal(err)
+	}
+	_, allPaths, err := withPath.Issues.ExclusionsForPath("legacy/item.proto")
+	if err != nil || !allPaths {
+		t.Fatalf("path exclusion did not match: %v, %v", allPaths, err)
+	}
+}
+
+func TestBreakingConfigUsesV1Baseline(t *testing.T) {
+	policy, err := ParsePolicy(strings.NewReader("version: v1\nbreaking:\n  baseline: git:main\n  ignore: [generated]\n"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	legacy, err := policy.BreakingConfig("master")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if legacy.AgainstGitRef != "main" || len(legacy.Ignore) != 1 || legacy.Ignore[0] != "generated" {
+		t.Fatalf("unexpected breaking config: %#v", legacy)
+	}
+	policy.Breaking.Categories = []string{"UNKNOWN"}
+	if _, err := policy.BreakingConfig("master"); err == nil {
+		t.Fatal("category selection was silently accepted")
+	}
+}
diff --git a/internal/config/v1/schema.go b/internal/config/v1/schema.go
new file mode 100644
index 00000000..c98f163d
--- /dev/null
+++ b/internal/config/v1/schema.go
@@ -0,0 +1,253 @@
+package v1
+
+import (
+	"encoding/json"
+	"fmt"
+	"reflect"
+	"strings"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	"github.com/easyp-tech/easyp/internal/core"
+	"github.com/easyp-tech/easyp/internal/rules"
+)
+
+type schema struct {
+	Schema               string             `json:"$schema,omitempty"`
+	Title                string             `json:"title,omitempty"`
+	Description          string             `json:"description,omitempty"`
+	Type                 string             `json:"type,omitempty"`
+	Properties           map[string]*schema `json:"properties,omitempty"`
+	AdditionalProperties any                `json:"additionalProperties,omitempty"`
+	Items                *schema            `json:"items,omitempty"`
+	OneOf                []*schema          `json:"oneOf,omitempty"`
+	AnyOf                []*schema          `json:"anyOf,omitempty"`
+	AllOf                []*schema          `json:"allOf,omitempty"`
+	If                   *schema            `json:"if,omitempty"`
+	Then                 *schema            `json:"then,omitempty"`
+	Not                  *schema            `json:"not,omitempty"`
+	Required             []string           `json:"required,omitempty"`
+	Enum                 []string           `json:"enum,omitempty"`
+	Const                any                `json:"const,omitempty"`
+	Pattern              string             `json:"pattern,omitempty"`
+	MinLength            int                `json:"minLength,omitempty"`
+	MaxItems             *int               `json:"maxItems,omitempty"`
+}
+
+// policyExtendsPattern accepts a local ./ or ../ policy path, an exact declared
+// module identity with an optional # policy fragment, and the RFC form that
+// appends a relative policy path to a declared module identity. Whitespace, a
+// repeated version and repeated fragments are rejected structurally; the CLI
+// additionally resolves the identity against the consumer module graph.
+const policyExtendsPattern = `^(|\.\.?|\.\.?/[^\r\n\\@]+|[^\s@#]+/[^\s@#]*(#[^\s@#]*)?)$`
+
+// policyExtendsDescription documents the delivery contract shared by both
+// sections. Only linters and linters-settings inherit from a lint base, and only
+// the breaking section inherits from a breaking base; issues.exclude-rules is
+// never inherited.
+const policyExtendsDescription = "Base policy for this section only, applied before local adjustments. " +
+	"Use ./ or ../ for a policy file or directory relative to this file, or a module identity already declared in protobuf.mod and locked in protobuf.lock, optionally with #<policy-file-or-directory>. " +
+	"A module reference without # loads that module's easyp.yaml. Versions are not repeated here and no new module or revision is acquired. " +
+	"Remote policies are read from the verified module contents of the consuming module; a base's own relative references stay inside its module. " +
+	"Only the referenced section and linters-settings are inherited: issues.exclude-rules, generation settings and the other section are not. " +
+	"Base breaking.ignore paths and the baseline are applied at this file's location, not in the module cache."
+
+// SchemaJSON returns the JSON Schema used to validate a v1 YAML file.
+// schema-gen writes these same bytes to disk.
+func SchemaJSON(name string) ([]byte, error) {
+	document, ok := documents()[name]
+	if !ok {
+		return nil, fmt.Errorf("unknown v1 schema %q", name)
+	}
+	data, err := json.MarshalIndent(document, "", "  ")
+	if err != nil {
+		return nil, fmt.Errorf("MarshalIndent: %w", err)
+	}
+	return append(data, '\n'), nil
+}
+
+func documents() map[string]*schema {
+	policy := fromType(reflect.TypeFor[Policy]())
+	policy.Properties["version"] = &schema{Type: "string", Const: "v1"}
+	for _, field := range []string{"enable", "disable"} {
+		policy.Properties["linters"].Properties[field].Items.Enum = rules.AllLintUseValues()
+	}
+	policy.Properties["issues"].Properties["exclude-rules"].Items.Properties["linters"].Items.Enum = rules.AllLintUseValues()
+	policy.Properties["linters"].Properties["default"] = &schema{Type: "string", Enum: []string{"MINIMAL", "BASIC", "STANDARD", "COMMENTS"}}
+	policy.Properties["linters-settings"] = &schema{
+		Type: "object",
+		Properties: map[string]*schema{
+			"ENUM_ZERO_VALUE_SUFFIX": suffixSettings(),
+			"SERVICE_SUFFIX":         suffixSettings(),
+		},
+		AdditionalProperties: false,
+	}
+	policy.Properties["breaking"].Properties["baseline"].Pattern = "^(git:.+)?$"
+	policy.Properties["breaking"].Properties["categories"].Items.Enum = config.BreakingProfileNames()
+	policy.Properties["breaking"].Properties["categories"].Description = "Selects FILE, PACKAGE, WIRE_JSON, and/or WIRE compatibility profiles. Multiple profiles apply their union; omitted or empty defaults to FILE."
+
+	for _, section := range []string{"linters", "breaking"} {
+		extends := policy.Properties[section].Properties["extends"]
+		extends.Const = nil
+		extends.Pattern = policyExtendsPattern
+		extends.Description = policyExtendsDescription
+	}
+	policy.Properties["issues"].Properties["exclude-rules"].Items.Properties["path"].Description = "Relative to the policy providing this issues section. Supports *, ?, character classes and ** directory segments; a literal directory includes its subtree."
+	policy.Properties["breaking"].Properties["ignore_unstable"].Description = "Ignore declarations in packages with unstable version suffixes; stable package checks remain enabled."
+
+	generate := fromType(reflect.TypeFor[Generate]())
+	generate.Properties["version"] = &schema{Type: "string", Const: "v1"}
+	generate.Properties["generate"].Properties["packages"].Description = "Exact protobuf packages among selected modules. Empty means all source files. Imports remain available for compilation; with_imports separately controls dependency generation."
+	generate.Properties["generate"].Properties["packages"].Items.Pattern = PackageSelectorPattern
+	generate.Properties["options"].Properties["go"].Properties["package_prefix"].Description = "Sets go_package without enabling managed defaults for other languages; full managed mode requires generate.managed.enabled."
+	plugin := generate.Properties["plugins"].Items
+	plugin.Required = []string{"out"}
+	plugin.Properties["with_imports"].Description = "Generate code for transitive imports with this plugin only; defaults to false. Independent from descriptor --include_imports."
+	policy.Properties["linters"].Properties["allow_comment_ignores"].Description = "Enable scoped easyp:disable, nolint and buf:lint:ignore comments; defaults to true. State is local to each effective lint policy."
+	plugin.OneOf = []*schema{
+		{Required: []string{"name"}},
+		{Required: []string{"path"}},
+		{Required: []string{"command"}},
+		{Required: []string{"remote"}},
+	}
+	plugin.AllOf = append(plugin.AllOf,
+		&schema{
+			If:   &schema{Required: []string{"remote"}},
+			Then: &schema{Required: []string{"version"}},
+		},
+		&schema{
+			If:   &schema{Not: &schema{Required: []string{"remote"}}},
+			Then: &schema{Not: &schema{Required: []string{"version"}}},
+		},
+	)
+	plugin.Properties["opts"] = &schema{OneOf: []*schema{
+		{Type: "array", Items: &schema{Type: "string"}},
+		{Type: "object", AdditionalProperties: &schema{OneOf: []*schema{
+			{Type: "string"}, {Type: "number"}, {Type: "boolean"},
+			{Type: "array", Items: &schema{OneOf: []*schema{{Type: "string"}, {Type: "number"}, {Type: "boolean"}}}},
+		}}},
+	}}
+	managed := generate.Properties["generate"].Properties["managed"]
+	disable := managed.Properties["disable"].Items
+	disable.AnyOf = requiredAnyOf("module", "package", "path", "file_option", "field_option", "field")
+	for _, selector := range disable.AnyOf {
+		selector.Properties = map[string]*schema{selector.Required[0]: {MinLength: 1}}
+	}
+	disable.Not = &schema{Required: []string{"file_option", "field_option"}}
+	override := managed.Properties["override"].Items
+	override.OneOf = requiredAnyOf("file_option", "field_option")
+	override.Required = []string{"value"}
+	for _, rule := range []*schema{disable, override} {
+		rule.AllOf = append(rule.AllOf, &schema{
+			If:   &schema{Required: []string{"field"}, Properties: map[string]*schema{"field": {MinLength: 1}}},
+			Then: &schema{Required: []string{"field_option"}},
+		})
+	}
+	for _, options := range []struct {
+		field    string
+		metadata []core.ManagedOptionMetadata
+	}{
+		{field: "file_option", metadata: core.ManagedFileOptionMetadata()},
+		{field: "field_option", metadata: core.ManagedFieldOptionMetadata()},
+	} {
+		for _, option := range options.metadata {
+			disable.Properties[options.field].Enum = append(disable.Properties[options.field].Enum, option.Name)
+			override.Properties[options.field].Enum = append(override.Properties[options.field].Enum, option.Name)
+			override.AllOf = append(override.AllOf, &schema{
+				If: &schema{Required: []string{options.field}, Properties: map[string]*schema{
+					options.field: {Const: option.Name},
+				}},
+				Then: &schema{Properties: map[string]*schema{
+					"value": {Type: option.ValueType, Enum: option.Enum},
+				}},
+			})
+		}
+	}
+
+	lock := fromType(reflect.TypeFor[Lock]())
+	lock.Required = []string{"version"}
+	lock.Properties["version"] = &schema{Type: "integer", Const: 1}
+	entry := lock.Properties["modules"].Items
+	entry.Required = []string{"source", "version", "commit", "hash"}
+	entry.Properties["source"].MinLength = 1
+	entry.Properties["version"].Pattern = `^(v[0-9]+\.[0-9]+\.[0-9]+([+-][0-9A-Za-z.-]+)?|[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$`
+	entry.Properties["commit"].Pattern = `^([0-9a-fA-F]{40}|[0-9a-fA-F]{64})$`
+	entry.Properties["hash"].Pattern = `^h1:[A-Za-z0-9+/]{43}=$`
+	entry.Properties["bsr"].Description = "BSR requests and their pinned Git targets, recorded on the requiring Git module. Frozen commands replay these bindings without consulting a resolver. compatibility_snapshot does not guarantee BSR revision equivalence or verify the BSR digest."
+	binding := entry.Properties["bsr"].Items
+	binding.Required = []string{"dependency", "git", "resolution"}
+	binding.Properties["resolution"].Enum = []string{BSRCompatibilitySnapshot, BSRExactRevision}
+	dependency := binding.Properties["dependency"]
+	dependency.Required = []string{"module", "config"}
+	dependency.Properties["module"].Pattern = bsrModulePattern
+	dependency.Properties["reference"].Pattern = `^[^:\s]*$`
+	dependency.Properties["commit"].Pattern = `^[0-9a-fA-F]{32}$`
+	dependency.Properties["digest"].Pattern = bsrDigestPattern
+	dependency.Properties["config"].MinLength = 1
+	dependency.Properties["config"].Description = "Declaring buf.yaml path relative to the verified Git checkout."
+	git := binding.Properties["git"]
+	git.Required = []string{"module", "version"}
+	git.Properties["module"].MinLength = 1
+	git.Properties["version"].Pattern = entry.Properties["version"].Pattern
+
+	return map[string]*schema{
+		"easyp":         document("easyp.yaml v1", policy),
+		"easyp.gen":     document("easyp.gen.yaml v1", generate),
+		"protobuf.lock": document("protobuf.lock v1", lock),
+	}
+}
+
+func requiredAnyOf(fields ...string) []*schema {
+	conditions := make([]*schema, 0, len(fields))
+	for _, field := range fields {
+		conditions = append(conditions, &schema{Required: []string{field}})
+	}
+	return conditions
+}
+
+func suffixSettings() *schema {
+	return &schema{Type: "object", Properties: map[string]*schema{"suffix": {Type: "string"}}, AdditionalProperties: false}
+}
+
+func document(title string, body *schema) *schema {
+	body.Schema = "https://json-schema.org/draft/2020-12/schema"
+	body.Title = title
+	body.Description = "Structural v1 YAML schema. EasyP CLI validation applies additional semantic checks."
+	return body
+}
+
+func fromType(typ reflect.Type) *schema {
+	for typ.Kind() == reflect.Pointer {
+		typ = typ.Elem()
+	}
+	switch typ.Kind() {
+	case reflect.Struct:
+		result := &schema{Type: "object", Properties: make(map[string]*schema), AdditionalProperties: false}
+		for i := 0; i < typ.NumField(); i++ {
+			field := typ.Field(i)
+			name := strings.Split(field.Tag.Get("yaml"), ",")[0]
+			if name == "-" || !field.IsExported() {
+				continue
+			}
+			if name == "" {
+				name = strings.ToLower(field.Name)
+			}
+			result.Properties[name] = fromType(field.Type)
+		}
+		return result
+	case reflect.Slice, reflect.Array:
+		return &schema{Type: "array", Items: fromType(typ.Elem())}
+	case reflect.Map:
+		return &schema{Type: "object", AdditionalProperties: fromType(typ.Elem())}
+	case reflect.String:
+		return &schema{Type: "string"}
+	case reflect.Bool:
+		return &schema{Type: "boolean"}
+	case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64,
+		reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64:
+		return &schema{Type: "integer"}
+	case reflect.Float32, reflect.Float64:
+		return &schema{Type: "number"}
+	default:
+		return &schema{}
+	}
+}
diff --git a/internal/config/v1/semantic_validation.go b/internal/config/v1/semantic_validation.go
new file mode 100644
index 00000000..cd56b11d
--- /dev/null
+++ b/internal/config/v1/semantic_validation.go
@@ -0,0 +1,25 @@
+package v1
+
+import (
+	"errors"
+	"fmt"
+
+	"github.com/easyp-tech/easyp/internal/config"
+)
+
+// yamlValidationError keeps the same schema checks at the parsing boundary,
+// including value types which yaml.v3 can otherwise coerce into Go strings.
+func yamlValidationError(name string, issues []config.ValidationIssue) error {
+	var errs []error
+	for _, issue := range issues {
+		if issue.Severity != config.SeverityError {
+			continue
+		}
+		if issue.Line > 0 {
+			errs = append(errs, fmt.Errorf("%s:%d:%d: %s", name, issue.Line, issue.Column, issue.Message))
+		} else {
+			errs = append(errs, fmt.Errorf("%s: %s", name, issue.Message))
+		}
+	}
+	return errors.Join(errs...)
+}
diff --git a/internal/config/v1/semantic_validation_test.go b/internal/config/v1/semantic_validation_test.go
new file mode 100644
index 00000000..aad4b139
--- /dev/null
+++ b/internal/config/v1/semantic_validation_test.go
@@ -0,0 +1,125 @@
+package v1
+
+import (
+	"bytes"
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"gopkg.in/yaml.v3"
+
+	"github.com/easyp-tech/easyp/internal/config"
+)
+
+func TestSemanticValidationExpandsEnvironmentOnce(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name string
+		file string
+		raw  string
+		bad  bool
+	}{
+		{name: "escaped_policy_setting", file: PolicyFile, raw: "linters-settings:\n  SERVICE_SUFFIX:\n    suffix: '$${R17_SUFFIX:-Service}'\n"},
+		{name: "escaped_incomplete_expression", file: PolicyFile, raw: "linters-settings:\n  SERVICE_SUFFIX:\n    suffix: '$${R17_SUFFIX'\n"},
+		{name: "escaped_baseline_ref", file: PolicyFile, raw: "breaking:\n  baseline: 'git:$${R17_REF:-main}'\n"},
+		{name: "escaped_baseline_cannot_become_valid", file: PolicyFile, raw: "breaking:\n  baseline: '$${R17_BASELINE:-git:main}'\n", bad: true},
+		{name: "escaped_managed_value", file: GenerateFile, raw: "generate:\n  managed:\n    override: [{file_option: go_package_prefix, value: '$${R17_PREFIX:-gen}/{{file_dir}}'}]\n"},
+		{name: "escaped_plugin_option", file: GenerateFile, raw: "plugins:\n  - name: go\n    out: '$${R17_OUT:-gen}'\n    opts: {suffix: '$${R17_SUFFIX'}\n"},
+		{name: "escaped_option_cannot_become_valid", file: GenerateFile, raw: "generate:\n  managed:\n    override: [{file_option: '$${R17_OPTION:-go_package}', value: gen}]\n", bad: true},
+		{name: "escaped_enum_cannot_become_valid", file: GenerateFile, raw: "generate:\n  managed:\n    override: [{file_option: optimize_for, value: '$${R17_ENUM:-SPEED}'}]\n", bad: true},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			raw := []byte(tt.raw)
+			before := bytes.Clone(raw)
+			var issues []config.ValidationIssue
+			if tt.file == PolicyFile {
+				issues = ValidatePolicyYAML(raw)
+				got, err := ParsePolicy(bytes.NewReader(raw))
+				if tt.bad {
+					require.Error(t, err)
+				} else {
+					require.NoError(t, err)
+					var want Policy
+					require.NoError(t, yaml.Unmarshal([]byte(strings.ReplaceAll(tt.raw, "$$", "$")), &want))
+					assert.Equal(t, want.LinterSettings, got.LinterSettings)
+					assert.Equal(t, want.Breaking, got.Breaking)
+				}
+			} else {
+				issues = ValidateGenerateYAML(raw)
+				got, err := ParseGenerate(bytes.NewReader(raw))
+				if tt.bad {
+					require.Error(t, err)
+				} else {
+					require.NoError(t, err)
+					var want Generate
+					require.NoError(t, yaml.Unmarshal([]byte(strings.ReplaceAll(tt.raw, "$$", "$")), &want))
+					assert.Equal(t, want.Generate, got.Generate)
+					assert.Equal(t, want.Plugins, got.Plugins)
+				}
+			}
+			assert.Equal(t, tt.bad, config.HasErrors(issues), "%+v", issues)
+			assert.Equal(t, before, raw, "validation must not mutate the source")
+			path := filepath.Join(t.TempDir(), tt.file)
+			require.NoError(t, os.WriteFile(path, raw, 0o600))
+			fileIssues, err := ValidateFile(path)
+			require.NoError(t, err)
+			assert.Equal(t, tt.bad, config.HasErrors(fileIssues), "%+v", fileIssues)
+		})
+	}
+}
+
+func TestSemanticValidationPreservesRawPlaceholdersOnDecode(t *testing.T) {
+	t.Parallel()
+	const raw = "generate:\n  managed:\n    override: [{file_option: go_package_prefix, value: '${R17_PREFIX}/{{file_dir}}'}]\noptions:\n  go:\n    package_prefix: '${R17_PREFIX}'\n"
+	var got Generate
+	require.NoError(t, yaml.Unmarshal([]byte(raw), &got))
+	assert.Equal(t, "${R17_PREFIX}/{{file_dir}}", got.Generate.Managed.Override[0].Value)
+	require.NotNil(t, got.Options.Go.PackagePrefix)
+	assert.Equal(t, "${R17_PREFIX}", *got.Options.Go.PackagePrefix)
+}
+
+func TestSemanticValidationSourceCoordinates(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name   string
+		raw    string
+		line   int
+		column int
+		path   string
+	}{
+		{
+			name: "unknown_option",
+			raw:  "# managed policy\ngenerate:\n  managed:\n    override:\n      - file_option: bogus_option\n        value: gen\n",
+			line: 5, column: 22, path: "generate.managed.override[0].file_option",
+		},
+		{
+			name: "wrong_value_type",
+			raw:  "# managed policy\ngenerate:\n  managed:\n    override:\n      - file_option: java_multiple_files\n        value: 'false'\n",
+			line: 6, column: 16, path: "generate.managed.override[0].value",
+		},
+		{
+			name: "invalid_enum",
+			raw:  "# managed policy\ngenerate:\n  managed:\n    override:\n      - field_option: jstype\n        value: INVALID\n",
+			line: 6, column: 16, path: "generate.managed.override[0].value",
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			issues := ValidateGenerateYAML([]byte(tt.raw))
+			require.Len(t, issues, 1, "%+v", issues)
+			assert.Equal(t, tt.line, issues[0].Line)
+			assert.Equal(t, tt.column, issues[0].Column)
+			assert.Contains(t, issues[0].Message, tt.path)
+			_, err := ParseGenerate(strings.NewReader(tt.raw))
+			require.ErrorContains(t, err, issues[0].Message)
+			require.ErrorContains(t, err, fmt.Sprintf("%s:%d:%d:", GenerateFile, tt.line, tt.column))
+		})
+	}
+}
diff --git a/internal/config/v1/validate.go b/internal/config/v1/validate.go
new file mode 100644
index 00000000..863fbde7
--- /dev/null
+++ b/internal/config/v1/validate.go
@@ -0,0 +1,112 @@
+package v1
+
+import (
+	"bytes"
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+
+	"github.com/easyp-tech/easyp/internal/config"
+)
+
+// ValidateFile checks the structure and semantics of one configuration file.
+func ValidateFile(path string) ([]config.ValidationIssue, error) {
+	raw, err := os.ReadFile(path)
+	if err != nil {
+		return nil, fmt.Errorf("ReadFile: %w", err)
+	}
+	name := filepath.Base(path)
+	switch name {
+	case GenerateFile:
+		return validateGenerate(raw), nil
+	case ModuleFile:
+		var module Module
+		module, err = ParseModule(bytes.NewReader(raw))
+		if err == nil {
+			err = validateReplacementDirectories(filepath.Dir(path), module)
+		}
+	case LockFile:
+		_, err = ParseLock(bytes.NewReader(raw))
+	default:
+		return validatePolicy(raw, name), nil
+	}
+	if err != nil {
+		return []config.ValidationIssue{validationError(name, err)}, nil
+	}
+	return nil, nil
+}
+
+func validateGenerate(raw []byte) []config.ValidationIssue {
+	issues := ValidateGenerateYAML(raw)
+	if config.HasErrors(issues) {
+		// The schema correctly requires a separate version for remote plugins,
+		// but an embedded legacy-style :version has a more actionable semantic
+		// diagnostic than the generic missing-property error.
+		if _, err := ParseGenerate(bytes.NewReader(raw)); err != nil &&
+			strings.Contains(err.Error(), "split remote into remote:") {
+			return []config.ValidationIssue{validationError(GenerateFile, err)}
+		}
+		return issues
+	}
+	if _, err := ParseGenerate(bytes.NewReader(raw)); err != nil {
+		return append(issues, validationError(GenerateFile, err))
+	}
+	return issues
+}
+
+func validatePolicy(raw []byte, name string) []config.ValidationIssue {
+	if LegacyPolicy(raw) {
+		return []config.ValidationIssue{{Code: "yaml_validation", Message: ErrLegacyConfiguration.Error(), Severity: config.SeverityError, Line: 1, Column: 1}}
+	}
+	issues := ValidatePolicyYAML(raw)
+	if config.HasErrors(issues) {
+		return issues
+	}
+	policy, err := ParsePolicy(bytes.NewReader(raw))
+	if err != nil {
+		return append(issues, validationError(name, err))
+	}
+	if policy.Linters.Extends == "" {
+		if _, err := policy.LintConfig(); err != nil {
+			return append(issues, validationError(name, err))
+		}
+	}
+	if policy.Breaking.Extends == "" {
+		if _, err := policy.BreakingConfig(""); err != nil {
+			return append(issues, validationError(name, err))
+		}
+	}
+	return issues
+}
+
+func validationError(name string, err error) config.ValidationIssue {
+	return config.ValidationIssue{
+		Code: "v1_validation", Message: validationMessage(name, err), Severity: config.SeverityError,
+	}
+}
+
+func validationMessage(name string, err error) string {
+	message := err.Error()
+	if strings.HasPrefix(message, name+":") {
+		return message
+	}
+	return fmt.Sprintf("%s: %s", name, message)
+}
+
+func validateReplacementDirectories(directory string, module Module) error {
+	for _, replacement := range module.Replaces {
+		target := replacement.Target
+		if !filepath.IsAbs(target) {
+			target = filepath.Join(directory, target)
+		}
+		info, err := os.Stat(target)
+		if err != nil {
+			return fmt.Errorf("replace %s => %s: %w", replacement.Module, replacement.Target, err)
+		}
+		if !info.IsDir() {
+			return fmt.Errorf("replace %s => %s: target is not a directory", replacement.Module, replacement.Target)
+		}
+	}
+	return nil
+}
diff --git a/internal/config/v1/validate_path.go b/internal/config/v1/validate_path.go
new file mode 100644
index 00000000..c3abc6e8
--- /dev/null
+++ b/internal/config/v1/validate_path.go
@@ -0,0 +1,95 @@
+package v1
+
+import (
+	"fmt"
+	"io/fs"
+	"os"
+	"path/filepath"
+
+	"github.com/easyp-tech/easyp/internal/config"
+)
+
+// ValidatePath accepts a single file or discovers all EasyP config files
+// below a directory. WalkDir provides a stable, lexical reporting order.
+func ValidatePath(path string) ([]config.ValidationIssue, error) {
+	return ValidatePathWith(path, nil)
+}
+
+// ValidatePathWith adds context-aware checks after syntax validation succeeds.
+// The callback receives a file path and returns issues; this package never
+// performs dependency resolution itself.
+func ValidatePathWith(path string, extra func(string) ([]config.ValidationIssue, error)) ([]config.ValidationIssue, error) {
+	info, err := os.Stat(path)
+	if err != nil {
+		return nil, fmt.Errorf("Stat: %w", err)
+	}
+	if !info.IsDir() {
+		return validateNamedFileWith(path, filepath.Base(path), extra)
+	}
+
+	files, err := findConfigFiles(path)
+	if err != nil {
+		return nil, fmt.Errorf("findConfigFiles: %w", err)
+	}
+	var issues []config.ValidationIssue
+	for _, file := range files {
+		relative, err := filepath.Rel(path, file)
+		if err != nil {
+			return nil, fmt.Errorf("Rel: %w", err)
+		}
+		fileIssues, err := validateNamedFileWith(file, filepath.ToSlash(relative), extra)
+		if err != nil {
+			return nil, fmt.Errorf("validateNamedFile: %w", err)
+		}
+		issues = append(issues, fileIssues...)
+	}
+	return issues, nil
+}
+
+func findConfigFiles(root string) ([]string, error) {
+	var files []string
+	err := filepath.WalkDir(root, func(file string, entry fs.DirEntry, walkErr error) error {
+		if walkErr != nil {
+			return walkErr
+		}
+		if entry.IsDir() || !isEasyPConfigFile(entry.Name()) {
+			return nil
+		}
+		files = append(files, file)
+		return nil
+	})
+	if err != nil {
+		return nil, fmt.Errorf("WalkDir: %w", err)
+	}
+	if len(files) == 0 {
+		return nil, fmt.Errorf("no configuration files found under %s", root)
+	}
+	return files, nil
+}
+
+func isEasyPConfigFile(name string) bool {
+	switch name {
+	case PolicyFile, GenerateFile, ModuleFile, LockFile:
+		return true
+	default:
+		return false
+	}
+}
+
+func validateNamedFileWith(path, name string, extra func(string) ([]config.ValidationIssue, error)) ([]config.ValidationIssue, error) {
+	issues, err := ValidateFile(path)
+	if err != nil {
+		return nil, fmt.Errorf("ValidateFile: %w", err)
+	}
+	if extra != nil && !config.HasErrors(issues) {
+		additional, err := extra(path)
+		if err != nil {
+			return nil, fmt.Errorf("validate policy references: %w", err)
+		}
+		issues = append(issues, additional...)
+	}
+	for i := range issues {
+		issues[i].File = name
+	}
+	return issues, nil
+}
diff --git a/internal/config/v1/validate_path_test.go b/internal/config/v1/validate_path_test.go
new file mode 100644
index 00000000..05e3d8de
--- /dev/null
+++ b/internal/config/v1/validate_path_test.go
@@ -0,0 +1,144 @@
+package v1
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestValidatePathSelectsConfigFiles(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name          string
+		files         map[string]string
+		selectedPath  string
+		expectedFiles []string
+	}{
+		{
+			name: "all nested configs in lexical order",
+			files: map[string]string{
+				"easyp.yaml":             "linters:\n  unknown: true\n",
+				"api/easyp.gen.yaml":     "plugins:\n  - name: go\n    out: gen\n    unknown: true\n",
+				"api/deep/protobuf.lock": "version: 2\nmodules: []\n",
+				"api/deep/protobuf.mod":  "roots (\n  proto\n)\n",
+				"api/deep/other.yaml":    "anything: true\n",
+			},
+			selectedPath:  ".",
+			expectedFiles: []string{"api/deep/protobuf.lock", "api/deep/protobuf.mod", "api/easyp.gen.yaml", "easyp.yaml"},
+		},
+		{
+			name: "explicit file excludes other configs",
+			files: map[string]string{
+				"easyp.yaml":            "version: v1\n",
+				"nested/easyp.gen.yaml": "plugins:\n  - invalid: true\n",
+			},
+			selectedPath: "easyp.yaml",
+		},
+		{
+			name: "explicit nested file uses its basename",
+			files: map[string]string{
+				"nested/easyp.yaml": "linters:\n  unknown: true\n",
+			},
+			selectedPath:  "nested/easyp.yaml",
+			expectedFiles: []string{"easyp.yaml"},
+		},
+		{
+			name: "selected directory bounds the search",
+			files: map[string]string{
+				"easyp.yaml":          "linters:\n  unknown: true\n",
+				"nested/protobuf.mod": "module example.com/service\n",
+			},
+			selectedPath: "nested",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			for name, contents := range tt.files {
+				writeValidationFixture(t, root, name, contents)
+			}
+
+			issues, err := ValidatePath(filepath.Join(root, tt.selectedPath))
+
+			require.NoError(t, err)
+			var issueFiles []string
+			for _, issue := range issues {
+				issueFiles = append(issueFiles, issue.File)
+			}
+			assert.Equal(t, tt.expectedFiles, issueFiles)
+		})
+	}
+}
+
+func TestValidatePathRejectsDirectoryWithoutConfigs(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name  string
+		files map[string]string
+	}{
+		{name: "empty directory"},
+		{name: "unrelated yaml only", files: map[string]string{"other.yaml": "anything: true\n"}},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			for name, contents := range tt.files {
+				writeValidationFixture(t, root, name, contents)
+			}
+
+			issues, err := ValidatePath(root)
+
+			require.ErrorContains(t, err, "no configuration files")
+			assert.Contains(t, err.Error(), root)
+			assert.Nil(t, issues)
+		})
+	}
+}
+
+func TestValidatePathPreservesFilesystemError(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name         string
+		selectedPath string
+	}{
+		{name: "missing file", selectedPath: "easyp.yaml"},
+		{name: "missing directory", selectedPath: "nested"},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			path := filepath.Join(t.TempDir(), tt.selectedPath)
+
+			issues, err := ValidatePath(path)
+
+			require.ErrorIs(t, err, os.ErrNotExist)
+			assert.Nil(t, issues)
+			var pathErr *os.PathError
+			require.ErrorAs(t, err, &pathErr)
+			assert.Equal(t, path, pathErr.Path)
+		})
+	}
+}
+
+func writeValidationFixture(t *testing.T, root, name, content string) {
+	t.Helper()
+	path := filepath.Join(root, name)
+	require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+	require.NoError(t, os.WriteFile(path, []byte(content), 0o644))
+}
diff --git a/internal/config/v1/validate_remote_diagnostic_test.go b/internal/config/v1/validate_remote_diagnostic_test.go
new file mode 100644
index 00000000..c7306425
--- /dev/null
+++ b/internal/config/v1/validate_remote_diagnostic_test.go
@@ -0,0 +1,29 @@
+package v1
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/config"
+)
+
+func TestValidateFilePrefersEmbeddedRemoteVersionDiagnostic(t *testing.T) {
+	t.Parallel()
+
+	path := filepath.Join(t.TempDir(), GenerateFile)
+	require.NoError(t, os.WriteFile(path, []byte("version: v1\nplugins:\n  - remote: localhost:8080/go:v1.2.3\n    out: gen\n"), 0o644))
+
+	issues, err := ValidateFile(path)
+
+	require.NoError(t, err)
+	require.Len(t, issues, 1)
+	assert.Equal(t, "v1_validation", issues[0].Code)
+	assert.Equal(t, config.SeverityError, issues[0].Severity)
+	assert.Contains(t, issues[0].Message, "split remote into remote:")
+	assert.Contains(t, issues[0].Message, `remote: "localhost:8080/go"`)
+	assert.Contains(t, issues[0].Message, `version: "v1.2.3"`)
+}
diff --git a/internal/config/v1/validate_test.go b/internal/config/v1/validate_test.go
new file mode 100644
index 00000000..ecb8076e
--- /dev/null
+++ b/internal/config/v1/validate_test.go
@@ -0,0 +1,342 @@
+package v1
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/config"
+)
+
+func TestValidateFileAcceptsValidConfig(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name     string
+		filename string
+		contents string
+	}{
+		{
+			name:     "versionless policy",
+			filename: PolicyFile,
+			contents: "linters:\n  default: MINIMAL\nbreaking:\n  baseline: git:main\n",
+		},
+		{
+			name:     "custom policy filename",
+			filename: "project.yaml",
+			contents: "version: v1\nlinters:\n  default: MINIMAL\n",
+		},
+		{
+			name:     "policy settings and pathless exclusions",
+			filename: PolicyFile,
+			contents: `version: v1
+linters:
+  default: STANDARD
+  enable: [ENUM_ZERO_VALUE_SUFFIX]
+linters-settings:
+  ENUM_ZERO_VALUE_SUFFIX:
+    suffix: UNSPECIFIED
+issues:
+  exclude-rules:
+    - linters: [SERVICE_SUFFIX]
+breaking:
+  baseline: git:main
+  ignore: [generated]
+`,
+		},
+		{
+			name:     "managed rules and both plugin option formats",
+			filename: GenerateFile,
+			contents: `version: v1
+generate:
+  managed:
+    enabled: true
+    disable:
+      - field_option: jstype
+        field: example.v1.Message.id
+    override:
+      - file_option: go_package_prefix
+        value: example.com/gen
+plugins:
+  - name: python
+    out: gen/python
+    opts:
+      foo: bar
+      paths: [source_relative]
+  - name: go
+    out: gen/go
+    opts: [paths=source_relative]
+`,
+		},
+		{
+			name:     "module manifest",
+			filename: ModuleFile,
+			contents: "module example.com/service\nroots (\n  proto\n)\n",
+		},
+		{
+			name:     "plugin binary path",
+			filename: GenerateFile,
+			contents: "version: v1\nplugins:\n  - path: ./tools/protoc-gen-custom\n    out: gen\n",
+		},
+		{
+			name:     "custom plugin command",
+			filename: GenerateFile,
+			contents: "version: v1\nplugins:\n  - command: [sh, ./tools/run-plugin]\n    out: gen\n",
+		},
+		{
+			name:     "empty dependency graph",
+			filename: LockFile,
+			contents: "version: 1\nmodules: []\n",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			path := filepath.Join(t.TempDir(), tt.filename)
+			require.NoError(t, os.WriteFile(path, []byte(tt.contents), 0o644))
+
+			issues, err := ValidateFile(path)
+
+			require.NoError(t, err)
+			assert.Empty(t, issues)
+		})
+	}
+}
+
+func TestValidateFileReportsLocatedYAMLIssues(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name          string
+		filename      string
+		contents      string
+		expectedCount int
+	}{
+		{
+			name:          "legacy policy",
+			filename:      PolicyFile,
+			contents:      "lint:\n  use: [MINIMAL]\n",
+			expectedCount: 1,
+		},
+		{
+			name:     "multiple policy issues",
+			filename: PolicyFile,
+			contents: `linters:
+  enable: INVALID
+issues:
+  exclude-rules:
+    - linters: [ENUM_VALUE_PREFIX]
+      extra: true
+breaking:
+  ignore: wrong
+`,
+			expectedCount: 3,
+		},
+		{
+			name:     "multiple generator issues",
+			filename: GenerateFile,
+			contents: `plugins:
+  - name: python
+    out: gen
+    opts: 17
+  - name: go
+    out: gen/go
+    unknown: true
+`,
+			expectedCount: 2,
+		},
+		{
+			name:          "nested plugin option issue",
+			filename:      GenerateFile,
+			contents:      "plugins:\n  - name: python\n    out: gen\n    opts:\n      invalid:\n        nested: value\n",
+			expectedCount: 1,
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			path := filepath.Join(t.TempDir(), tt.filename)
+			require.NoError(t, os.WriteFile(path, []byte(tt.contents), 0o644))
+
+			issues, err := ValidateFile(path)
+
+			require.NoError(t, err)
+			require.Len(t, issues, tt.expectedCount)
+			for _, issue := range issues {
+				assert.Equal(t, "yaml_validation", issue.Code)
+				assert.Equal(t, config.SeverityError, issue.Severity)
+				assert.Positive(t, issue.Line)
+				assert.Positive(t, issue.Column)
+			}
+		})
+	}
+}
+
+func TestValidateFileUsesGeneratedSchema(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name     string
+		filename string
+		contents string
+		path     string
+	}{
+		{
+			name:     "unknown linter setting",
+			filename: PolicyFile,
+			contents: "linters-settings:\n  UNKNOWN:\n    suffix: BAD\n",
+			path:     `["linters-settings"].UNKNOWN`,
+		},
+		{
+			name:     "invalid baseline",
+			filename: PolicyFile,
+			contents: "breaking:\n  baseline: main\n",
+			path:     "breaking.baseline",
+		},
+		{
+			name:     "plugin without identity",
+			filename: GenerateFile,
+			contents: "plugins:\n  - out: gen\n",
+			path:     "plugins[0]",
+		},
+		{
+			name:     "managed override without value",
+			filename: GenerateFile,
+			contents: "generate:\n  managed:\n    override:\n      - file_option: go_package_prefix\n",
+			path:     "generate.managed.override[0].value",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			path := filepath.Join(t.TempDir(), tt.filename)
+			require.NoError(t, os.WriteFile(path, []byte(tt.contents), 0o644))
+
+			issues, err := ValidateFile(path)
+
+			require.NoError(t, err)
+			require.NotEmpty(t, issues)
+			assert.Equal(t, "yaml_validation", issues[0].Code)
+			assert.Contains(t, issues[0].Message, tt.path)
+			assert.Positive(t, issues[0].Line)
+			assert.Positive(t, issues[0].Column)
+		})
+	}
+}
+
+func TestValidateFileReportsSemanticIssues(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name            string
+		filename        string
+		contents        string
+		expectedMessage string
+	}{
+		{
+			name:            "unsupported lock version",
+			filename:        LockFile,
+			contents:        "version: 2\nmodules: []\n",
+			expectedMessage: "unsupported protobuf.lock version 2",
+		},
+		{
+			name:            "incomplete locked module",
+			filename:        LockFile,
+			contents:        "version: 1\nmodules:\n  - source: example.com/dep\n    version: v1.0.0\n",
+			expectedMessage: "incomplete lock entry",
+		},
+		{
+			name:            "invalid content hash",
+			filename:        LockFile,
+			contents:        "version: 1\nmodules:\n  - source: example.com/dep\n    version: v1.0.0\n    commit: 0000000000000000000000000000000000000000\n    hash: h1:bad\n",
+			expectedMessage: "invalid content hash",
+		},
+		{
+			name:            "unknown lock field",
+			filename:        LockFile,
+			contents:        "version: 1\nmodules: []\nunknown: true\n",
+			expectedMessage: "field unknown not found",
+		},
+		{
+			name:            "missing module identity",
+			filename:        ModuleFile,
+			contents:        "roots (\n  proto\n)\n",
+			expectedMessage: "missing module directive",
+		},
+		{
+			name:            "invalid linter inheritance reference",
+			filename:        PolicyFile,
+			contents:        "linters:\n  extends: shared.yaml\n",
+			expectedMessage: "linters.extends",
+		},
+		{
+			name:            "unpinned remote plugin",
+			filename:        GenerateFile,
+			contents:        "plugins:\n  - remote: example.com/go\n    out: gen\n",
+			expectedMessage: "required property \"version\" is missing",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			path := filepath.Join(t.TempDir(), tt.filename)
+			require.NoError(t, os.WriteFile(path, []byte(tt.contents), 0o644))
+
+			issues, err := ValidateFile(path)
+
+			require.NoError(t, err)
+			require.Len(t, issues, 1)
+			if tt.name == "invalid linter inheritance reference" || tt.name == "unpinned remote plugin" {
+				assert.Equal(t, "yaml_validation", issues[0].Code)
+				assert.Positive(t, issues[0].Line)
+			} else {
+				assert.Equal(t, "v1_validation", issues[0].Code)
+			}
+			assert.Equal(t, config.SeverityError, issues[0].Severity)
+			assert.Contains(t, issues[0].Message, tt.expectedMessage)
+		})
+	}
+}
+
+func TestValidateFileReadError(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name     string
+		filename string
+	}{
+		{name: "missing policy", filename: PolicyFile},
+		{name: "missing generator", filename: GenerateFile},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			path := filepath.Join(t.TempDir(), tt.filename)
+
+			issues, err := ValidateFile(path)
+
+			require.ErrorIs(t, err, os.ErrNotExist)
+			assert.Nil(t, issues)
+			var pathErr *os.PathError
+			require.ErrorAs(t, err, &pathErr)
+			assert.Equal(t, path, pathErr.Path)
+		})
+	}
+}
diff --git a/internal/config/v1/validate_yaml.go b/internal/config/v1/validate_yaml.go
new file mode 100644
index 00000000..dfd1a628
--- /dev/null
+++ b/internal/config/v1/validate_yaml.go
@@ -0,0 +1,161 @@
+package v1
+
+import (
+	"fmt"
+	"strings"
+	"sync"
+
+	yamlvalidator "github.com/Yakwilik/go-yamlvalidator"
+	"gopkg.in/yaml.v3"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	"github.com/easyp-tech/easyp/internal/rules"
+)
+
+var (
+	policySchema = sync.OnceValues(func() (*yamlvalidator.FieldSchema, error) {
+		return compileSchema("easyp")
+	})
+	generateSchema = sync.OnceValues(func() (*yamlvalidator.FieldSchema, error) {
+		return compileSchema("easyp.gen")
+	})
+)
+
+// ValidatePolicyYAML reports JSON Schema violations with YAML source coordinates.
+func ValidatePolicyYAML(raw []byte) []config.ValidationIssue {
+	return validateV1YAML(raw, policySchema)
+}
+
+// ValidateGenerateYAML reports JSON Schema violations with YAML source coordinates.
+func ValidateGenerateYAML(raw []byte) []config.ValidationIssue {
+	return validateV1YAML(raw, generateSchema)
+}
+
+func compileSchema(name string) (*yamlvalidator.FieldSchema, error) {
+	raw, err := SchemaJSON(name)
+	if err != nil {
+		return nil, fmt.Errorf("SchemaJSON: %w", err)
+	}
+	schema, err := yamlvalidator.CompileJSONSchema(raw)
+	if err != nil {
+		return nil, fmt.Errorf("CompileJSONSchema: %w", err)
+	}
+	return schema, nil
+}
+
+func validateV1YAML(raw []byte, loadSchema func() (*yamlvalidator.FieldSchema, error)) []config.ValidationIssue {
+	expanded, err := expandConfigBytes(raw)
+	if err != nil {
+		return []config.ValidationIssue{{Code: "v1_validation", Message: err.Error(), Severity: config.SeverityError}}
+	}
+	return validateExpandedV1YAML(expanded, loadSchema)
+}
+
+// validateExpandedV1YAML also serves parsing, which has already substituted the
+// environment. Expanding again here would interpret escaped $$ expressions.
+func validateExpandedV1YAML(expanded []byte, loadSchema func() (*yamlvalidator.FieldSchema, error)) []config.ValidationIssue {
+	schema, err := loadSchema()
+	if err != nil {
+		return []config.ValidationIssue{{Code: "v1_validation", Message: err.Error(), Severity: config.SeverityError}}
+	}
+	result := yamlvalidator.NewValidator(schema).ValidateWithOptions(expanded, yamlvalidator.ValidationContext{
+		StrictKeys:  true,
+		StrictTypes: true,
+	})
+	result.SortByPosition()
+	allIssues := result.Collector.All()
+	values := scalarValuesByPosition(expanded)
+	compositePaths := make(map[string]string)
+	for _, issue := range allIssues {
+		if issue.Code == "oneOf" || issue.Code == "anyOf" {
+			compositePaths[issue.Path] = issue.SchemaPath
+		}
+	}
+	issues := make([]config.ValidationIssue, 0, len(allIssues))
+	for _, issue := range allIssues {
+		if issue.Code == "group" || issue.Code == "allOf" {
+			// The schema engine can emit a summary together with precise child
+			// errors. Keep the actionable diagnostics, not the duplicate summary.
+			detailed := false
+			for _, child := range allIssues {
+				if child.Code != "group" && child.Level == issue.Level &&
+					(child.Path == issue.Path || strings.HasPrefix(child.Path, issue.Path+".") || strings.HasPrefix(child.Path, issue.Path+"[")) &&
+					strings.HasPrefix(child.SchemaPath, issue.SchemaPath+"/") {
+					detailed = true
+					break
+				}
+			}
+			if detailed {
+				continue
+			}
+		}
+		if parentPath, ok := compositePaths[issue.Path]; ok && strings.HasPrefix(issue.SchemaPath, parentPath+"/") {
+			continue
+		}
+		if issue.Code == "oneOf" || issue.Code == "anyOf" {
+			// A nested alternative already points to the offending YAML value.
+			nested := false
+			for path := range compositePaths {
+				if strings.HasPrefix(path, issue.Path+".") || strings.HasPrefix(path, issue.Path+"[") {
+					nested = true
+					break
+				}
+			}
+			if nested {
+				continue
+			}
+		}
+		severity := config.SeverityWarn
+		if issue.Level == yamlvalidator.LevelError {
+			severity = config.SeverityError
+		}
+		message := issue.Message
+		if issue.Code == "enum" && isLintRuleValuePath(issue.Path) {
+			if value, ok := values[[2]int{issue.Line, issue.Column}]; ok {
+				if err := rules.ValidateNames([]string{value}); err != nil {
+					message = err.Error()
+				}
+			}
+		}
+		if issue.Expected != "" {
+			message += fmt.Sprintf(" (expected %s)", issue.Expected)
+		}
+		if issue.Got != "" {
+			message += fmt.Sprintf(" (got %s)", issue.Got)
+		}
+		if issue.Path != "" {
+			message += fmt.Sprintf(" (path: %s)", issue.Path)
+		}
+		issues = append(issues, config.ValidationIssue{
+			Code: "yaml_validation", Message: message,
+			Line: issue.Line, Column: issue.Column, Severity: severity,
+		})
+	}
+	return issues
+}
+
+func isLintRuleValuePath(path string) bool {
+	return strings.HasPrefix(path, "linters.enable[") || strings.HasPrefix(path, "linters.disable[") ||
+		(strings.HasPrefix(path, "issues[\"exclude-rules\"][") && strings.Contains(path, "].linters["))
+}
+
+// scalarValuesByPosition supplements schema errors which omit the rejected
+// value. Syntax errors are already reported by the schema validator.
+func scalarValuesByPosition(raw []byte) map[[2]int]string {
+	values := make(map[[2]int]string)
+	var root yaml.Node
+	if err := yaml.Unmarshal(raw, &root); err != nil {
+		return values
+	}
+	var visit func(*yaml.Node)
+	visit = func(node *yaml.Node) {
+		if node.Kind == yaml.ScalarNode {
+			values[[2]int{node.Line, node.Column}] = node.Value
+		}
+		for _, child := range node.Content {
+			visit(child)
+		}
+	}
+	visit(&root)
+	return values
+}
diff --git a/internal/config/validate_raw.go b/internal/config/validate_raw.go
deleted file mode 100644
index b4fe1989..00000000
--- a/internal/config/validate_raw.go
+++ /dev/null
@@ -1,254 +0,0 @@
-package config
-
-import (
-	"fmt"
-	"os"
-
-	v "github.com/Yakwilik/go-yamlvalidator"
-	"github.com/a8m/envsubst"
-)
-
-// Severity levels for validation issues.
-const (
-	SeverityError = "error"
-	SeverityWarn  = "warn"
-)
-
-// ValidationIssue describes a single validation problem with the config.
-type ValidationIssue struct {
-	Code     string `json:"code" yaml:"code"`
-	Message  string `json:"message" yaml:"message"`
-	Line     int    `json:"line,omitempty" yaml:"line,omitempty"`
-	Column   int    `json:"column,omitempty" yaml:"column,omitempty"`
-	Severity string `json:"severity,omitempty" yaml:"severity,omitempty"` // SeverityError or SeverityWarn
-}
-
-// ValidateRaw validates config bytes using go-yamlvalidator schema.
-// Env vars are expanded before validation. Unknown keys produce warnings; type/structure errors produce errors.
-func ValidateRaw(buf []byte) ([]ValidationIssue, error) {
-	issues := make([]ValidationIssue, 0)
-
-	expanded, err := envsubst.String(string(buf))
-	if err != nil {
-		issues = append(issues, newIssue("envsubst_error", err.Error(), SeverityError))
-		return issues, nil
-	}
-	buf = []byte(expanded)
-
-	validator := v.NewValidator(buildSchema())
-	ctx := v.ValidationContext{
-		StrictKeys:     true,
-		YAML11Booleans: true,
-	}
-	result := validator.ValidateWithOptions(buf, ctx)
-
-	for _, e := range result.Collector.All() {
-		severity := SeverityWarn
-		if e.Level == v.LevelError {
-			severity = SeverityError
-		}
-
-		msg := e.Message
-		if e.Expected != "" && e.Got != "" {
-			msg = fmt.Sprintf("%s (expected %s, got %s)", e.Message, e.Expected, e.Got)
-		} else if e.Expected != "" {
-			msg = fmt.Sprintf("%s (expected %s)", e.Message, e.Expected)
-		} else if e.Got != "" {
-			msg = fmt.Sprintf("%s (got %s)", e.Message, e.Got)
-		}
-		if e.Path != "" {
-			msg = fmt.Sprintf("%s (path: %s)", msg, e.Path)
-		}
-
-		issues = append(issues, ValidationIssue{
-			Code:     "yaml_validation",
-			Message:  msg,
-			Line:     e.Line,
-			Column:   e.Column,
-			Severity: severity,
-		})
-	}
-
-	return issues, nil
-}
-
-// ValidateFile validates config file on disk.
-func ValidateFile(path string) ([]ValidationIssue, error) {
-	buf, err := os.ReadFile(path)
-	if err != nil {
-		return nil, fmt.Errorf("os.ReadFile: %w", err)
-	}
-	return ValidateRaw(buf)
-}
-
-// buildSchema builds the YAML validation schema matching easyp.yaml structure.
-func buildSchema() *v.FieldSchema {
-	stringSeq := &v.FieldSchema{Type: v.TypeSequence, ItemSchema: &v.FieldSchema{Type: v.TypeString}}
-	pluginOptsSchema := &v.FieldSchema{
-		Type:                 v.TypeMap,
-		AdditionalProperties: &v.FieldSchema{Type: v.TypeAny},
-		Validators:           []v.ValueValidator{pluginOptsValidator{}},
-	}
-
-	lintSchema := &v.FieldSchema{
-		Type: v.TypeMap,
-		AllowedKeys: map[string]*v.FieldSchema{
-			"use":                    stringSeq,
-			"enum_zero_value_suffix": {Type: v.TypeString},
-			"service_suffix":         {Type: v.TypeString},
-			"ignore":                 stringSeq,
-			"except":                 stringSeq,
-			"allow_comment_ignores":  {Type: v.TypeBool},
-			"ignore_only": {
-				Type:                 v.TypeMap,
-				AdditionalProperties: stringSeq,
-			},
-		},
-		UnknownKeyPolicy: v.UnknownKeyWarn,
-	}
-
-	depsSchema := &v.FieldSchema{Type: v.TypeSequence, ItemSchema: &v.FieldSchema{Type: v.TypeString}, Nullable: true}
-
-	inputDirSchema := &v.FieldSchema{
-		Type: v.TypeAny, // string or map
-		AllowedKeys: map[string]*v.FieldSchema{
-			"path": {Type: v.TypeString},
-			"root": {Type: v.TypeString},
-		},
-		UnknownKeyPolicy: v.UnknownKeyIgnore,
-		Validators:       []v.ValueValidator{directoryValidator{}},
-	}
-
-	inputGitSchema := &v.FieldSchema{
-		Type: v.TypeMap,
-		AllowedKeys: map[string]*v.FieldSchema{
-			"url":           {Type: v.TypeString, Required: true},
-			"sub_directory": {Type: v.TypeString},
-			"root":          {Type: v.TypeString},
-		},
-		UnknownKeyPolicy: v.UnknownKeyWarn,
-	}
-
-	inputSchema := &v.FieldSchema{
-		Type: v.TypeMap,
-		AllowedKeys: map[string]*v.FieldSchema{
-			"directory": inputDirSchema,
-			"git_repo":  inputGitSchema,
-		},
-		AnyOf:             [][]string{{"directory"}, {"git_repo"}},
-		MutuallyExclusive: []string{"directory", "git_repo"},
-		UnknownKeyPolicy:  v.UnknownKeyWarn,
-	}
-
-	pluginSchema := &v.FieldSchema{
-		Type: v.TypeMap,
-		AllowedKeys: map[string]*v.FieldSchema{
-			"name":         {Type: v.TypeString},
-			"remote":       {Type: v.TypeString},
-			"path":         {Type: v.TypeString},
-			"command":      {Type: v.TypeSequence, ItemSchema: &v.FieldSchema{Type: v.TypeString}},
-			"out":          {Type: v.TypeString},
-			"opts":         pluginOptsSchema,
-			"with_imports": {Type: v.TypeBool},
-		},
-		AnyOf:             [][]string{{"name"}, {"remote"}, {"path"}, {"command"}},
-		MutuallyExclusive: []string{"name", "remote", "path", "command"},
-		UnknownKeyPolicy:  v.UnknownKeyWarn,
-		Validators:        []v.ValueValidator{pluginSourceValidator{}},
-	}
-
-	managedDisableSchema := &v.FieldSchema{
-		Type: v.TypeMap,
-		AllowedKeys: map[string]*v.FieldSchema{
-			"module":       {Type: v.TypeString},
-			"package":      {Type: v.TypeString},
-			"path":         {Type: v.TypeString},
-			"file_option":  {Type: v.TypeString},
-			"field_option": {Type: v.TypeString},
-			"field":        {Type: v.TypeString},
-		},
-		AnyOf:             [][]string{{"module"}, {"package"}, {"path"}, {"file_option"}, {"field_option"}, {"field"}},
-		MutuallyExclusive: []string{"file_option", "field_option"},
-		UnknownKeyPolicy:  v.UnknownKeyWarn,
-		Validators:        []v.ValueValidator{managedDisableValidator{}},
-	}
-
-	managedOverrideSchema := &v.FieldSchema{
-		Type: v.TypeMap,
-		AllowedKeys: map[string]*v.FieldSchema{
-			"file_option":  {Type: v.TypeString},
-			"field_option": {Type: v.TypeString},
-			"value":        {Type: v.TypeAny, Required: true},
-			"module":       {Type: v.TypeString},
-			"package":      {Type: v.TypeString},
-			"path":         {Type: v.TypeString},
-			"field":        {Type: v.TypeString},
-		},
-		AnyOf:             [][]string{{"file_option"}, {"field_option"}},
-		MutuallyExclusive: []string{"file_option", "field_option"},
-		UnknownKeyPolicy:  v.UnknownKeyWarn,
-		Validators:        []v.ValueValidator{managedOverrideValidator{}},
-	}
-
-	managedSchema := &v.FieldSchema{
-		Type: v.TypeMap,
-		AllowedKeys: map[string]*v.FieldSchema{
-			"enabled":  {Type: v.TypeBool},
-			"disable":  {Type: v.TypeSequence, ItemSchema: managedDisableSchema},
-			"override": {Type: v.TypeSequence, ItemSchema: managedOverrideSchema},
-		},
-		UnknownKeyPolicy: v.UnknownKeyWarn,
-	}
-
-	generateSchema := &v.FieldSchema{
-		Type: v.TypeMap,
-		AllowedKeys: map[string]*v.FieldSchema{
-			"inputs":  {Type: v.TypeSequence, ItemSchema: inputSchema, Required: true, MinItems: v.Ptr(1)},
-			"plugins": {Type: v.TypeSequence, ItemSchema: pluginSchema, Required: true, MinItems: v.Ptr(1)},
-			"managed": managedSchema,
-		},
-		UnknownKeyPolicy: v.UnknownKeyWarn,
-	}
-
-	breakingSchema := &v.FieldSchema{
-		Type: v.TypeMap,
-		AllowedKeys: map[string]*v.FieldSchema{
-			"ignore":          stringSeq,
-			"against_git_ref": {Type: v.TypeString},
-		},
-		UnknownKeyPolicy: v.UnknownKeyWarn,
-	}
-
-	return &v.FieldSchema{
-		Type: v.TypeMap,
-		AllowedKeys: map[string]*v.FieldSchema{
-			"lint":     lintSchema,
-			"deps":     depsSchema,
-			"generate": generateSchema,
-			"breaking": breakingSchema,
-			"version":  {Type: v.TypeString},
-		},
-		Required:         true,
-		UnknownKeyPolicy: v.UnknownKeyWarn,
-	}
-}
-
-// newIssue constructs ValidationIssue with a severity.
-func newIssue(code, msg, severity string) ValidationIssue {
-	return ValidationIssue{
-		Code:     code,
-		Message:  msg,
-		Severity: severity,
-	}
-}
-
-// HasErrors returns true if any issue has severity SeverityError.
-// Warnings alone do not constitute a validation failure.
-func HasErrors(issues []ValidationIssue) bool {
-	for _, issue := range issues {
-		if issue.Severity == SeverityError {
-			return true
-		}
-	}
-	return false
-}
diff --git a/internal/config/validate_raw_test.go b/internal/config/validate_raw_test.go
deleted file mode 100644
index 56a3ae32..00000000
--- a/internal/config/validate_raw_test.go
+++ /dev/null
@@ -1,293 +0,0 @@
-package config
-
-import (
-	"strings"
-	"testing"
-
-	"github.com/stretchr/testify/require"
-)
-
-func TestValidateRaw_PluginOptsSupportsScalarAndSequence(t *testing.T) {
-	content := `version: v1alpha
-lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-generate:
-  inputs:
-    - directory: proto
-  plugins:
-    - name: go
-      out: .
-      opts:
-        env: node
-        require_unimplemented_servers: false
-        timeout: 30
-        outputServices:
-          - grpc-js
-          - generic-definitions
-        flags:
-          - false
-          - 30
-`
-
-	issues, err := ValidateRaw([]byte(content))
-	require.NoError(t, err)
-	require.False(t, HasErrors(issues))
-}
-
-func TestValidateRaw_PluginOptsRejectsNestedValues(t *testing.T) {
-	content := `version: v1alpha
-lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-generate:
-  inputs:
-    - directory: proto
-  plugins:
-    - name: go
-      out: .
-      opts:
-        outputServices:
-          - grpc-js
-          - nested:
-              key: value
-`
-
-	issues, err := ValidateRaw([]byte(content))
-	require.NoError(t, err)
-	require.True(t, HasErrors(issues))
-
-	found := false
-	for _, issue := range issues {
-		if issue.Severity != SeverityError {
-			continue
-		}
-		if issue.Message == "" {
-			continue
-		}
-		if containsAny(issue.Message, "opts array item must be a scalar value", "opts value must be a scalar or sequence of scalars") {
-			found = true
-			break
-		}
-	}
-	require.True(t, found, "expected plugin opts validation error, got issues: %#v", issues)
-	assertNoEmptyExpectedGotArtifact(t, issues)
-}
-
-func containsAny(s string, candidates ...string) bool {
-	for _, candidate := range candidates {
-		if candidate != "" && strings.Contains(s, candidate) {
-			return true
-		}
-	}
-	return false
-}
-
-func issuesBySeverityAndPath(issues []ValidationIssue, severity string, path string) []ValidationIssue {
-	out := make([]ValidationIssue, 0)
-	pathMarker := "(path: " + path + ")"
-	for _, issue := range issues {
-		if issue.Severity == severity && strings.Contains(issue.Message, pathMarker) {
-			out = append(out, issue)
-		}
-	}
-	return out
-}
-
-func assertNoEmptyExpectedGotArtifact(t *testing.T, issues []ValidationIssue) {
-	t.Helper()
-	for _, issue := range issues {
-		require.NotContains(t, issue.Message, "expected , got", "unexpected malformed message: %q", issue.Message)
-	}
-}
-
-func TestValidateRaw_PluginOptsRejectsNestedMapValue(t *testing.T) {
-	content := `version: v1alpha
-lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-generate:
-  inputs:
-    - directory: proto
-  plugins:
-    - command:
-        - go
-        - run
-      out: .
-      opts:
-        l:
-          L:
-`
-
-	issues, err := ValidateRaw([]byte(content))
-	require.NoError(t, err)
-	require.True(t, HasErrors(issues))
-	assertNoEmptyExpectedGotArtifact(t, issues)
-
-	var hasTypedError bool
-	var hasNestedUnknown bool
-	for _, issue := range issues {
-		if issue.Severity == SeverityError &&
-			strings.Contains(issue.Message, "opts value must be a scalar or sequence of scalars") &&
-			strings.Contains(issue.Message, "expected scalar or sequence of scalars, got MappingNode") &&
-			strings.Contains(issue.Message, "generate.plugins[0].opts.l") {
-			hasTypedError = true
-		}
-
-		if issue.Severity == SeverityError &&
-			strings.Contains(issue.Message, `unknown key "L"`) &&
-			strings.Contains(issue.Message, "generate.plugins[0].opts.l.L") {
-			hasNestedUnknown = true
-		}
-	}
-
-	require.True(t, hasTypedError, "expected typed opts error with MappingNode, got issues: %#v", issues)
-	require.True(t, hasNestedUnknown, "expected nested unknown key error for opts.l.L, got issues: %#v", issues)
-}
-
-func TestValidateRaw_BreakingSchemaValidKeys(t *testing.T) {
-	content := `lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-breaking:
-  ignore:
-    - proto/legacy
-  against_git_ref: main
-`
-
-	issues, err := ValidateRaw([]byte(content))
-	require.NoError(t, err)
-	require.False(t, HasErrors(issues), "valid breaking section should not produce errors, got: %v", issues)
-}
-
-func TestValidateRaw_BreakingSchemaUnknownKey(t *testing.T) {
-	content := `lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-breaking:
-  ignore:
-    - proto/legacy
-  unknown_field: true
-`
-
-	issues, err := ValidateRaw([]byte(content))
-	require.NoError(t, err)
-
-	// Should produce at least one warning for the unknown key.
-	var hasWarning bool
-	for _, issue := range issues {
-		if issue.Severity == SeverityWarn && strings.Contains(issue.Message, "unknown_field") {
-			hasWarning = true
-			break
-		}
-	}
-	require.True(t, hasWarning, "expected warning for unknown key 'unknown_field' in breaking section, got: %v", issues)
-}
-
-func TestValidateRaw_ManagedModePackageSelectors(t *testing.T) {
-	content := `lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-generate:
-  inputs:
-    - directory: proto
-  plugins:
-    - name: go
-      out: .
-  managed:
-    enabled: true
-    disable:
-      - package: acme.weather.v1
-        file_option: java_package_prefix
-    override:
-      - file_option: go_package_prefix
-        package: acme.weather.v1
-        value: github.com/acme/gen/go
-`
-
-	issues, err := ValidateRaw([]byte(content))
-	require.NoError(t, err)
-	require.False(t, HasErrors(issues), "package selector in managed mode should be valid, got: %v", issues)
-}
-
-func TestValidateRaw_DirectoryUnknownKey_NoDuplicate(t *testing.T) {
-	content := `version: v1alpha
-lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-generate:
-  inputs:
-    - directory:
-        path: api
-        pal: value
-  plugins:
-    - name: go
-      out: .
-`
-
-	issues, err := ValidateRaw([]byte(content))
-	require.NoError(t, err)
-	require.False(t, HasErrors(issues), "directory unknown key should be warning-only, got: %#v", issues)
-	assertNoEmptyExpectedGotArtifact(t, issues)
-
-	warningsAtPath := issuesBySeverityAndPath(issues, SeverityWarn, "generate.inputs[0].directory.pal")
-
-	require.Len(t, warningsAtPath, 1, "expected a single warning for directory unknown key, got: %#v", issues)
-	require.Contains(t, warningsAtPath[0].Message, "unknown field under directory")
-	require.NotContains(t, warningsAtPath[0].Message, `unknown key "pal"`)
-}
-
-func TestValidateRaw_GitRepoOut_IsUnknownKey(t *testing.T) {
-	content := `version: v1alpha
-lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-generate:
-  inputs:
-    - git_repo:
-        url: github.com/acme/common@v1.0.0
-        out: gen
-  plugins:
-    - name: go
-      out: .
-`
-
-	issues, err := ValidateRaw([]byte(content))
-	require.NoError(t, err)
-	require.False(t, HasErrors(issues), "git_repo.out should be treated as unknown warning only, got: %#v", issues)
-	assertNoEmptyExpectedGotArtifact(t, issues)
-
-	warningsAtPath := issuesBySeverityAndPath(issues, SeverityWarn, "generate.inputs[0].git_repo.out")
-
-	require.Len(t, warningsAtPath, 1, "expected one unknown warning for git_repo.out, got: %#v", issues)
-	require.Contains(t, warningsAtPath[0].Message, `unknown key "out"`)
-	require.Contains(t, warningsAtPath[0].Message, "(got ")
-	require.NotContains(t, warningsAtPath[0].Message, "unknown field under directory")
-}
-
-func TestValidateRaw_MessageFormatting_GotOnly(t *testing.T) {
-	content := `lint:
-  use:
-    - DIRECTORY_SAME_PACKAGE
-breaking:
-  ignore:
-    - proto/legacy
-  unknown_field: true
-`
-
-	issues, err := ValidateRaw([]byte(content))
-	require.NoError(t, err)
-	assertNoEmptyExpectedGotArtifact(t, issues)
-
-	var gotOnlyMessage string
-	for _, issue := range issues {
-		if issue.Severity == SeverityWarn && strings.Contains(issue.Message, `unknown key "unknown_field"`) {
-			gotOnlyMessage = issue.Message
-			break
-		}
-	}
-
-	require.NotEmpty(t, gotOnlyMessage, "expected warning for unknown_field, got issues: %#v", issues)
-	require.Contains(t, gotOnlyMessage, "(got ")
-	require.NotContains(t, gotOnlyMessage, "(expected ")
-}
diff --git a/internal/config/validation_issue.go b/internal/config/validation_issue.go
new file mode 100644
index 00000000..59df349c
--- /dev/null
+++ b/internal/config/validation_issue.go
@@ -0,0 +1,25 @@
+package config
+
+const (
+	SeverityError = "error"
+	SeverityWarn  = "warn"
+)
+
+// ValidationIssue describes a problem with a v1 configuration file.
+type ValidationIssue struct {
+	File     string `json:"file,omitempty" yaml:"file,omitempty"`
+	Code     string `json:"code" yaml:"code"`
+	Message  string `json:"message" yaml:"message"`
+	Line     int    `json:"line,omitempty" yaml:"line,omitempty"`
+	Column   int    `json:"column,omitempty" yaml:"column,omitempty"`
+	Severity string `json:"severity,omitempty" yaml:"severity,omitempty"`
+}
+
+func HasErrors(issues []ValidationIssue) bool {
+	for _, issue := range issues {
+		if issue.Severity == SeverityError {
+			return true
+		}
+	}
+	return false
+}
diff --git a/internal/config/yaml_validators.go b/internal/config/yaml_validators.go
deleted file mode 100644
index c9acf0dc..00000000
--- a/internal/config/yaml_validators.go
+++ /dev/null
@@ -1,269 +0,0 @@
-package config
-
-import (
-	"fmt"
-
-	v "github.com/Yakwilik/go-yamlvalidator"
-	"gopkg.in/yaml.v3"
-)
-
-func yamlKindName(kind yaml.Kind) string {
-	switch kind {
-	case yaml.ScalarNode:
-		return "ScalarNode"
-	case yaml.SequenceNode:
-		return "SequenceNode"
-	case yaml.MappingNode:
-		return "MappingNode"
-	case yaml.AliasNode:
-		return "AliasNode"
-	default:
-		return fmt.Sprintf("%d", kind)
-	}
-}
-
-// directoryValidator allows directory to be either a string or a map with required path and optional root.
-type directoryValidator struct{}
-
-func (directoryValidator) Validate(node *yaml.Node, path string, ctx *v.ValidationContext) {
-	switch node.Kind {
-	case yaml.ScalarNode:
-		// Only string scalars are allowed for the shorthand form.
-		if node.Tag == "!!null" || node.Tag == "!!bool" || node.Tag == "!!int" || node.Tag == "!!float" {
-			ctx.AddError(v.ValidationError{
-				Level:   v.LevelError,
-				Path:    path,
-				Line:    node.Line,
-				Column:  node.Column,
-				Message: "directory must be a string or mapping",
-				Got:     node.Tag,
-			})
-		}
-	case yaml.MappingNode:
-		requiredPath := false
-		for i := 0; i < len(node.Content); i += 2 {
-			keyNode := node.Content[i]
-			valNode := node.Content[i+1]
-			switch keyNode.Value {
-			case "path":
-				requiredPath = true
-				if valNode.Kind != yaml.ScalarNode {
-					ctx.AddError(v.ValidationError{
-						Level:   v.LevelError,
-						Path:    path + ".path",
-						Line:    valNode.Line,
-						Column:  valNode.Column,
-						Message: "path must be a string",
-					})
-				}
-			case "root":
-				if valNode.Kind != yaml.ScalarNode {
-					ctx.AddError(v.ValidationError{
-						Level:   v.LevelError,
-						Path:    path + ".root",
-						Line:    valNode.Line,
-						Column:  valNode.Column,
-						Message: "root must be a string",
-					})
-				}
-			default:
-				ctx.AddError(v.ValidationError{
-					Level:   v.LevelWarning,
-					Path:    path + "." + keyNode.Value,
-					Line:    keyNode.Line,
-					Column:  keyNode.Column,
-					Message: "unknown field under directory",
-					Got:     keyNode.Value,
-				})
-			}
-		}
-		if !requiredPath {
-			ctx.AddError(v.ValidationError{
-				Level:   v.LevelError,
-				Path:    path + ".path",
-				Line:    node.Line,
-				Column:  node.Column,
-				Message: "directory.path is required",
-			})
-		}
-	default:
-		ctx.AddError(v.ValidationError{
-			Level:   v.LevelError,
-			Path:    path,
-			Line:    node.Line,
-			Column:  node.Column,
-			Message: "directory must be string or mapping",
-			Got:     yamlKindName(node.Kind),
-		})
-	}
-}
-
-// pluginSourceValidator ensures exactly one plugin source field is set.
-type pluginSourceValidator struct{}
-
-func (pluginSourceValidator) Validate(node *yaml.Node, path string, ctx *v.ValidationContext) {
-	if node.Kind != yaml.MappingNode {
-		return
-	}
-	has := func(k string) bool {
-		for i := 0; i < len(node.Content); i += 2 {
-			if node.Content[i].Value == k {
-				return true
-			}
-		}
-		return false
-	}
-	var count int
-	for _, k := range []string{"name", "remote", "path", "command"} {
-		if has(k) {
-			count++
-		}
-	}
-	if count == 0 {
-		ctx.AddError(v.ValidationError{
-			Level:   v.LevelError,
-			Path:    path,
-			Line:    node.Line,
-			Column:  node.Column,
-			Message: "plugins item must have one of name/remote/path/command",
-		})
-	} else if count > 1 {
-		ctx.AddError(v.ValidationError{
-			Level:   v.LevelError,
-			Path:    path,
-			Line:    node.Line,
-			Column:  node.Column,
-			Message: "plugins item must not set multiple sources (name/remote/path/command)",
-		})
-	}
-}
-
-// pluginOptsValidator allows plugin opts values to be either scalar or sequence of scalars.
-type pluginOptsValidator struct{}
-
-func (pluginOptsValidator) Validate(node *yaml.Node, path string, ctx *v.ValidationContext) {
-	if node.Kind != yaml.MappingNode {
-		return
-	}
-
-	for i := 0; i < len(node.Content); i += 2 {
-		keyNode := node.Content[i]
-		valNode := node.Content[i+1]
-		optsPath := path + "." + keyNode.Value
-
-		switch valNode.Kind {
-		case yaml.ScalarNode:
-			continue
-		case yaml.SequenceNode:
-			for idx, item := range valNode.Content {
-				if item.Kind != yaml.ScalarNode {
-					ctx.AddError(v.ValidationError{
-						Level:   v.LevelError,
-						Path:    fmt.Sprintf("%s[%d]", optsPath, idx),
-						Line:    item.Line,
-						Column:  item.Column,
-						Message: "opts array item must be a scalar value",
-					})
-				}
-			}
-		default:
-			ctx.AddError(v.ValidationError{
-				Level:    v.LevelError,
-				Path:     optsPath,
-				Line:     valNode.Line,
-				Column:   valNode.Column,
-				Message:  "opts value must be a scalar or sequence of scalars",
-				Expected: "scalar or sequence of scalars",
-				Got:      yamlKindName(valNode.Kind),
-			})
-		}
-	}
-}
-
-// managedDisableValidator validates generate.managed.disable entries.
-type managedDisableValidator struct{}
-
-func (managedDisableValidator) Validate(node *yaml.Node, path string, ctx *v.ValidationContext) {
-	if node.Kind != yaml.MappingNode {
-		return
-	}
-	has := func(k string) bool {
-		for i := 0; i < len(node.Content); i += 2 {
-			if node.Content[i].Value == k {
-				return true
-			}
-		}
-		return false
-	}
-	if !(has("module") || has("package") || has("path") || has("file_option") || has("field_option") || has("field")) {
-		ctx.AddError(v.ValidationError{
-			Level:   v.LevelError,
-			Path:    path,
-			Line:    node.Line,
-			Column:  node.Column,
-			Message: "managed.disable entry must set at least one of module/package/path/file_option/field_option/field",
-		})
-	}
-	if has("file_option") && has("field_option") {
-		ctx.AddError(v.ValidationError{
-			Level:   v.LevelError,
-			Path:    path,
-			Line:    node.Line,
-			Column:  node.Column,
-			Message: "managed.disable: file_option and field_option cannot both be set",
-		})
-	}
-	if has("field") && !has("field_option") {
-		ctx.AddError(v.ValidationError{
-			Level:   v.LevelError,
-			Path:    path,
-			Line:    node.Line,
-			Column:  node.Column,
-			Message: "managed.disable.field requires field_option",
-		})
-	}
-}
-
-// managedOverrideValidator validates generate.managed.override entries.
-type managedOverrideValidator struct{}
-
-func (managedOverrideValidator) Validate(node *yaml.Node, path string, ctx *v.ValidationContext) {
-	if node.Kind != yaml.MappingNode {
-		return
-	}
-	has := func(k string) bool {
-		for i := 0; i < len(node.Content); i += 2 {
-			if node.Content[i].Value == k {
-				return true
-			}
-		}
-		return false
-	}
-	if !has("file_option") && !has("field_option") {
-		ctx.AddError(v.ValidationError{
-			Level:   v.LevelError,
-			Path:    path,
-			Line:    node.Line,
-			Column:  node.Column,
-			Message: "managed.override requires either file_option or field_option",
-		})
-	}
-	if has("file_option") && has("field_option") {
-		ctx.AddError(v.ValidationError{
-			Level:   v.LevelError,
-			Path:    path,
-			Line:    node.Line,
-			Column:  node.Column,
-			Message: "managed.override cannot set both file_option and field_option",
-		})
-	}
-	if has("field") && !has("field_option") {
-		ctx.AddError(v.ValidationError{
-			Level:   v.LevelError,
-			Path:    path,
-			Line:    node.Line,
-			Column:  node.Column,
-			Message: "managed.override.field can only be used with field_option",
-		})
-	}
-}
diff --git a/internal/core/breaking_check.go b/internal/core/breaking_check.go
index 061d037f..1b802538 100644
--- a/internal/core/breaking_check.go
+++ b/internal/core/breaking_check.go
@@ -4,7 +4,9 @@ import (
 	"context"
 	"fmt"
 	"log/slog"
+	"maps"
 	"path/filepath"
+	"slices"
 
 	"github.com/yoheimuta/go-protoparser/v4/interpret/unordered"
 	"github.com/yoheimuta/go-protoparser/v4/parser"
@@ -26,6 +28,10 @@ type BreakingCheckConfig struct {
 	IgnoreDirs []string
 
 	FilesCheck bool
+	// Categories selects descriptor-backed compatibility profiles. Empty keeps legacy behavior.
+	Categories []string
+	// IgnoreUnstable skips packages whose final component is an unstable version.
+	IgnoreUnstable bool
 }
 
 func (c *Core) BreakingCheck(ctx context.Context, projectRoot, workingDir, path string) ([]IssueInfo, error) {
@@ -36,49 +42,54 @@ func (c *Core) BreakingCheck(ctx context.Context, projectRoot, workingDir, path
 		slog.String("path", path),
 	)
 
-	if err := c.Download(ctx); err != nil {
-		return nil, fmt.Errorf("c.Download: %w", err)
-	}
-
-	// read current state
-	fsWalker := fs.NewFSWalker(workingDir, path)
-	currentProtoFiles, err := c.readProtoFiles(ctx, fsWalker)
+	current := fs.NewFSWalker(workingDir, path)
+	against, err := c.currentProjectGitWalker.GetDirWalker(workingDir, c.breakingCheckConfig.AgainstGitRef, path)
 	if err != nil {
-		return nil, fmt.Errorf("c.readCurrentProtoFiles: %w", err)
+		return nil, fmt.Errorf("GetDirWalker: %w", err)
 	}
+	return c.CompareBreaking(ctx, current, against, c.importRoots)
+}
 
-	// read from ref branch
-	againstFSWalker, err := c.currentProjectGitWalker.GetDirWalker(
-		workingDir, c.breakingCheckConfig.AgainstGitRef, path,
-	)
+// CompareBreaking compares explicitly scoped inputs with revision-specific imports.
+// Neither filesystem can fall back to the other revision's dependency roots.
+func (c *Core) CompareBreaking(ctx context.Context, current, against DirWalker, againstImportRoots []string) ([]IssueInfo, error) {
+	return c.CompareBreakingWithImports(ctx, current, against, againstImportRoots, nil)
+}
+
+// CompareBreakingWithImports keeps source filters isolated between the two revisions.
+func (c *Core) CompareBreakingWithImports(ctx context.Context, current, against DirWalker, againstImportRoots []string, againstFileAllowed func(string) bool) ([]IssueInfo, error) {
+	baseline := *c
+	baseline.importRoots = againstImportRoots
+	baseline.importFileAllowed = againstFileAllowed
+	if len(c.breakingCheckConfig.Categories) > 0 {
+		profiles, err := selectedBreakingProfiles(c.breakingCheckConfig.Categories)
+		if err != nil {
+			return nil, err
+		}
+		return c.compareBreakingProfiles(ctx, current, against, &baseline, profiles)
+	}
+	currentFiles, err := c.readProtoFiles(ctx, current)
 	if err != nil {
-		return nil, fmt.Errorf("c.currentProjectGitWalker.GetDirWalker: %w", err)
+		return nil, fmt.Errorf("readProtoFiles current: %w", err)
 	}
-	againstProtoFiles, err := c.readProtoFiles(ctx, againstFSWalker)
+	againstFiles, err := baseline.readProtoFiles(ctx, against)
 	if err != nil {
-		return nil, fmt.Errorf("c.readAgainstProtoFiles: %w", err)
+		return nil, fmt.Errorf("readProtoFiles baseline: %w", err)
 	}
-
-	// ---
-
-	currentProtoData, err := collect(currentProtoFiles)
+	currentData, err := collect(currentFiles)
 	if err != nil {
-		return nil, fmt.Errorf("collect(current): %w", err)
+		return nil, fmt.Errorf("collect: %w", err)
 	}
-
-	againstProtoData, err := collect(againstProtoFiles)
+	againstData, err := collect(againstFiles)
 	if err != nil {
-		return nil, fmt.Errorf("collect(against): %w", err)
+		return nil, fmt.Errorf("collect: %w", err)
 	}
-
-	breakingChecker := &BreakingChecker{
-		against: againstProtoData,
-		current: currentProtoData,
-
-		filesCheck: c.breakingCheckConfig.FilesCheck,
+	if c.breakingCheckConfig.IgnoreUnstable {
+		excludeUnstablePackages(currentData)
+		excludeUnstablePackages(againstData)
 	}
-
-	return breakingChecker.Check()
+	checker := &BreakingChecker{against: againstData, current: currentData, filesCheck: c.breakingCheckConfig.FilesCheck}
+	return checker.Check()
 }
 
 func (c *Core) readProtoFiles(ctx context.Context, fsWalker DirWalker) ([]ProtoInfo, error) {
@@ -113,28 +124,27 @@ func (c *Core) readProtoFiles(ctx context.Context, fsWalker DirWalker) ([]ProtoI
 
 func collect(protoInfos []ProtoInfo) (ProtoData, error) {
 	protoData := make(ProtoData)
-	collectedProtoFiles := make(map[string]struct{})
-
-	for _, protoInfo := range protoInfos {
-		protoFilePath := protoInfo.Path
-		pkgName := GetPackageName(protoInfo.Info)
-
-		if _, ok := collectedProtoFiles[protoFilePath]; !ok {
-			collectProtoFileInfo(protoData, protoInfo.Info, pkgName, protoFilePath)
-			collectedProtoFiles[protoFilePath] = struct{}{}
-		}
-
-		// collects from imports
-		for importPath, protoFile := range protoInfo.ProtoFilesFromImport {
-			protoFilePath := string(importPath)
-			if _, ok := collectedProtoFiles[protoFilePath]; ok {
+	collectedImports := make(map[string]bool)
+	// Dependencies establish the imported context first. Explicit target paths
+	// then take precedence over import aliases, regardless of traversal order.
+	for _, info := range protoInfos {
+		for _, importPath := range slices.Sorted(maps.Keys(info.ProtoFilesFromImport)) {
+			name := string(importPath)
+			if collectedImports[name] {
 				continue
 			}
-
-			pkgName := GetPackageName(protoFile)
-			collectProtoFileInfo(protoData, protoFile, pkgName, protoFilePath)
-			collectedProtoFiles[protoFilePath] = struct{}{}
+			imported := info.ProtoFilesFromImport[importPath]
+			collectProtoFileInfo(protoData, imported, GetPackageName(imported), name)
+			collectedImports[name] = true
+		}
+	}
+	collectedTargets := make(map[string]bool)
+	for _, info := range protoInfos {
+		if collectedTargets[info.Path] {
+			continue
 		}
+		collectProtoFileInfo(protoData, info.Info, GetPackageName(info.Info), info.Path)
+		collectedTargets[info.Path] = true
 	}
 
 	return protoData, nil
diff --git a/internal/core/breaking_git_import_test.go b/internal/core/breaking_git_import_test.go
new file mode 100644
index 00000000..fd61ecfe
--- /dev/null
+++ b/internal/core/breaking_git_import_test.go
@@ -0,0 +1,61 @@
+package core_test
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+	"time"
+
+	"github.com/go-git/go-git/v5"
+	"github.com/go-git/go-git/v5/plumbing"
+	"github.com/go-git/go-git/v5/plumbing/object"
+	"github.com/stretchr/testify/require"
+
+	gitadapter "github.com/easyp-tech/easyp/internal/adapters/go_git"
+	"github.com/easyp-tech/easyp/internal/core"
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestBreakingCheckResolvesWellKnownImportFromGitBaseline(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name       string
+		importName string
+		fieldType  string
+	}{
+		{name: "timestamp", importName: "google/protobuf/timestamp.proto", fieldType: "google.protobuf.Timestamp"},
+		{name: "duration", importName: "google/protobuf/duration.proto", fieldType: "google.protobuf.Duration"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			path := filepath.Join(root, "proto", "event.proto")
+			require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+			contents := "syntax = \"proto3\";\npackage event.v1;\nimport \"" + tt.importName + "\";\nmessage Event { " + tt.fieldType + " created_at = 1; }\n"
+			require.NoError(t, os.WriteFile(path, []byte(contents), 0o644))
+			repository, err := git.PlainInit(root, false)
+			require.NoError(t, err)
+			worktree, err := repository.Worktree()
+			require.NoError(t, err)
+			_, err = worktree.Add("proto/event.proto")
+			require.NoError(t, err)
+			commit, err := worktree.Commit("baseline", &git.CommitOptions{Author: &object.Signature{Name: "EasyP Test", Email: "test@example.com", When: time.Now()}})
+			require.NoError(t, err)
+			require.NoError(t, repository.Storer.SetReference(plumbing.NewHashReference(plumbing.NewBranchReferenceName("main"), commit)))
+			checker := core.New(core.Options{
+				Logger:                  logger.NewNop(),
+				CurrentProjectGitWalker: gitadapter.New(),
+				BreakingCheckConfig:     core.BreakingCheckConfig{AgainstGitRef: "main"},
+			})
+
+			issues, err := checker.BreakingCheck(t.Context(), root, filepath.Join(root, "proto"), ".")
+
+			require.NoError(t, err)
+			require.Empty(t, issues)
+		})
+	}
+}
diff --git a/internal/core/breaking_profiles.go b/internal/core/breaking_profiles.go
new file mode 100644
index 00000000..3ad9b254
--- /dev/null
+++ b/internal/core/breaking_profiles.go
@@ -0,0 +1,1175 @@
+package core
+
+import (
+	"context"
+	"fmt"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	"github.com/bufbuild/protocompile"
+	"github.com/bufbuild/protocompile/linker"
+	"github.com/bufbuild/protocompile/protoutil"
+	"github.com/bufbuild/protocompile/wellknownimports"
+	"github.com/yoheimuta/go-protoparser/v4/parser/meta"
+	"google.golang.org/protobuf/reflect/protoreflect"
+	"google.golang.org/protobuf/types/descriptorpb"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	"github.com/easyp-tech/easyp/internal/core/path_helpers"
+)
+
+type breakingGraph struct {
+	files    map[string]protoreflect.FileDescriptor
+	targets  map[string]bool
+	paths    map[string]string
+	messages map[protoreflect.FullName]protoreflect.MessageDescriptor
+	enums    map[protoreflect.FullName]protoreflect.EnumDescriptor
+	services map[protoreflect.FullName]protoreflect.ServiceDescriptor
+	methods  map[protoreflect.FullName]protoreflect.MethodDescriptor
+	ext      map[protoreflect.FullName]protoreflect.FieldDescriptor
+}
+
+type breakingProfiles struct {
+	file, source, wireJSON, wire bool
+}
+
+func selectedBreakingProfiles(categories []string) (breakingProfiles, error) {
+	if err := config.ValidateBreakingCategories(categories); err != nil {
+		return breakingProfiles{}, err
+	}
+	selected := breakingProfiles{}
+	for _, category := range categories {
+		switch category {
+		case "FILE":
+			selected.file, selected.source, selected.wireJSON, selected.wire = true, true, true, true
+		case "PACKAGE":
+			selected.source, selected.wireJSON, selected.wire = true, true, true
+		case "WIRE_JSON":
+			selected.wireJSON, selected.wire = true, true
+		case "WIRE":
+			selected.wire = true
+		}
+	}
+	return selected, nil
+}
+
+func (c *Core) compareBreakingProfiles(
+	ctx context.Context, current, against DirWalker, baseline *Core, profiles breakingProfiles,
+) ([]IssueInfo, error) {
+	currentGraph, err := c.compileBreakingGraph(ctx, current)
+	if err != nil {
+		return nil, fmt.Errorf("compile current descriptors: %w", err)
+	}
+	againstGraph, err := baseline.compileBreakingGraph(ctx, against)
+	if err != nil {
+		return nil, fmt.Errorf("compile baseline descriptors: %w", err)
+	}
+	if c.breakingCheckConfig.IgnoreUnstable {
+		filterUnstableBreakingGraph(currentGraph)
+		filterUnstableBreakingGraph(againstGraph)
+	}
+	return compareBreakingGraphs(againstGraph, currentGraph, profiles), nil
+}
+
+func (c *Core) compileBreakingGraph(ctx context.Context, walker DirWalker) (*breakingGraph, error) {
+	importRoots, ignoreDirs := c.importRoots, c.breakingCheckConfig.IgnoreDirs
+	rooted, ok := walker.(interface{ RootPath() string })
+	if !ok {
+		return nil, fmt.Errorf("breaking source does not expose its root path")
+	}
+	root := rooted.RootPath()
+	targets := make([]string, 0)
+	targetPaths := make(map[string]string)
+	physical := make(map[string]bool)
+	err := walker.WalkDir(func(path string, walkErr error) error {
+		if walkErr != nil {
+			return walkErr
+		}
+		if filepath.Ext(path) != ".proto" || path_helpers.IsIgnoredPath(path, ignoreDirs) {
+			return nil
+		}
+		canonicalPath, err := canonicalBreakingPath(root, path, importRoots)
+		if err != nil {
+			return err
+		}
+		physicalPath := filepath.Join(root, filepath.FromSlash(path))
+		resolvedPath, err := filepath.EvalSymlinks(physicalPath)
+		if err == nil {
+			physicalPath = resolvedPath
+		}
+		physicalPath = filepath.Clean(physicalPath)
+		if physical[physicalPath] {
+			return nil
+		}
+		physical[physicalPath] = true
+		targets = append(targets, canonicalPath)
+		targetPaths[canonicalPath] = filepath.ToSlash(path)
+		return nil
+	})
+	if err != nil {
+		return nil, fmt.Errorf("WalkDir: %w", err)
+	}
+	slices.Sort(targets)
+	if len(targets) == 0 {
+		return newBreakingGraph(), nil
+	}
+	imports := uniquePhysicalRoots(importRoots)
+	if len(imports) == 0 {
+		imports = []string{root}
+	}
+	compiler := protocompile.Compiler{
+		Resolver:       wellknownimports.WithStandardImports(&protocompile.SourceResolver{ImportPaths: imports, Accessor: c.openSourceFile}),
+		SourceInfoMode: protocompile.SourceInfoStandard,
+	}
+	compiled, err := compiler.Compile(ctx, targets...)
+	if err != nil {
+		return nil, fmt.Errorf("Compile: %w", err)
+	}
+	return buildBreakingGraph(compiled, targetPaths), nil
+}
+
+func canonicalBreakingPath(root, path string, importRoots []string) (string, error) {
+	physicalPath := filepath.Join(root, filepath.FromSlash(path))
+	for _, importRoot := range importRoots {
+		relative, err := filepath.Rel(importRoot, physicalPath)
+		if err == nil && filepath.IsLocal(relative) {
+			return filepath.ToSlash(relative), nil
+		}
+	}
+	return filepath.ToSlash(path), nil
+}
+
+func uniquePhysicalRoots(roots []string) []string {
+	result := make([]string, 0, len(roots))
+	seen := make(map[string]bool)
+	for _, root := range roots {
+		resolved, err := filepath.EvalSymlinks(root)
+		if err == nil {
+			root = resolved
+		}
+		root = filepath.Clean(root)
+		if !seen[root] {
+			seen[root] = true
+			result = append(result, root)
+		}
+	}
+	return result
+}
+
+func newBreakingGraph() *breakingGraph {
+	return &breakingGraph{
+		files: make(map[string]protoreflect.FileDescriptor), targets: make(map[string]bool), paths: make(map[string]string),
+		messages: make(map[protoreflect.FullName]protoreflect.MessageDescriptor),
+		enums:    make(map[protoreflect.FullName]protoreflect.EnumDescriptor),
+		services: make(map[protoreflect.FullName]protoreflect.ServiceDescriptor),
+		methods:  make(map[protoreflect.FullName]protoreflect.MethodDescriptor),
+		ext:      make(map[protoreflect.FullName]protoreflect.FieldDescriptor),
+	}
+}
+
+func buildBreakingGraph(files linker.Files, targetPaths map[string]string) *breakingGraph {
+	graph := newBreakingGraph()
+	for name := range targetPaths {
+		graph.targets[name] = true
+	}
+	seen := make(map[protoreflect.FileDescriptor]bool)
+	var visit func(protoreflect.FileDescriptor)
+	visit = func(file protoreflect.FileDescriptor) {
+		if seen[file] {
+			return
+		}
+		seen[file] = true
+		graph.files[string(file.Path())] = file
+		if path, ok := targetPaths[string(file.Path())]; ok {
+			graph.paths[string(file.Path())] = path
+		} else {
+			graph.paths[string(file.Path())] = filepath.ToSlash(file.Path())
+		}
+		for i := range file.Imports().Len() {
+			visit(file.Imports().Get(i))
+		}
+		for i := range file.Messages().Len() {
+			addBreakingMessage(graph, file.Messages().Get(i))
+		}
+		for i := range file.Enums().Len() {
+			graph.enums[file.Enums().Get(i).FullName()] = file.Enums().Get(i)
+		}
+		for i := range file.Services().Len() {
+			service := file.Services().Get(i)
+			graph.services[service.FullName()] = service
+			for j := range service.Methods().Len() {
+				method := service.Methods().Get(j)
+				graph.methods[method.FullName()] = method
+			}
+		}
+		for i := range file.Extensions().Len() {
+			graph.ext[file.Extensions().Get(i).FullName()] = file.Extensions().Get(i)
+		}
+	}
+	for _, file := range files {
+		visit(file)
+	}
+	return graph
+}
+
+func addBreakingMessage(graph *breakingGraph, message protoreflect.MessageDescriptor) {
+	graph.messages[message.FullName()] = message
+	for i := range message.Extensions().Len() {
+		extension := message.Extensions().Get(i)
+		graph.ext[extension.FullName()] = extension
+	}
+	for i := range message.Enums().Len() {
+		enum := message.Enums().Get(i)
+		graph.enums[enum.FullName()] = enum
+	}
+	for i := range message.Messages().Len() {
+		addBreakingMessage(graph, message.Messages().Get(i))
+	}
+}
+
+func filterUnstableBreakingGraph(graph *breakingGraph) {
+	unstable := func(d protoreflect.Descriptor) bool { return isUnstablePackage(PackageName(d.ParentFile().Package())) }
+	for name, d := range graph.messages {
+		if unstable(d) {
+			delete(graph.messages, name)
+		}
+	}
+	for name, d := range graph.enums {
+		if unstable(d) {
+			delete(graph.enums, name)
+		}
+	}
+	for name, d := range graph.services {
+		if unstable(d) {
+			delete(graph.services, name)
+		}
+	}
+	for name, d := range graph.methods {
+		if unstable(d) {
+			delete(graph.methods, name)
+		}
+	}
+	for name, d := range graph.ext {
+		if unstable(d) {
+			delete(graph.ext, name)
+		}
+	}
+	for name, d := range graph.files {
+		if isUnstablePackage(PackageName(d.Package())) {
+			delete(graph.files, name)
+			delete(graph.paths, name)
+		}
+	}
+}
+
+func compareBreakingGraphs(against, current *breakingGraph, profile breakingProfiles) []IssueInfo {
+	var issues []IssueInfo
+	appendIssue := func(descriptor protoreflect.Descriptor, rule, message string) {
+		if descriptor == nil {
+			return
+		}
+		file := descriptor.ParentFile()
+		location := file.SourceLocations().ByDescriptor(descriptor)
+		path := against.paths[string(file.Path())]
+		if current.files[string(file.Path())] == file {
+			path = current.paths[string(file.Path())]
+		}
+		if path == "" {
+			path = filepath.ToSlash(file.Path())
+		}
+		issues = append(issues, IssueInfo{
+			Path: path,
+			Issue: Issue{RuleName: rule, Message: message, Position: meta.Position{
+				Filename: path, Line: location.StartLine + 1, Column: location.StartColumn + 1,
+			}},
+		})
+	}
+
+	if profile.file {
+		for name, oldFile := range against.files {
+			if _, ok := current.files[name]; !ok && isTargetBreakingFile(against, name) {
+				appendIssue(oldFile, "FILE_NO_DELETE", fmt.Sprintf("File %q was deleted.", name))
+			}
+		}
+	}
+	compareBreakingPackages(against, current, profile, appendIssue)
+	compareBreakingMessages(against, current, profile, appendIssue)
+	compareBreakingEnums(against, current, profile, appendIssue)
+	compareBreakingServices(against, current, profile, appendIssue)
+	compareBreakingExtensions(against, current, profile, appendIssue)
+	compareBreakingFileOptions(against, current, profile, appendIssue)
+	return deduplicateBreakingIssues(issues)
+}
+
+func isTargetBreakingFile(graph *breakingGraph, name string) bool {
+	_, isTarget := graph.targets[name]
+	return isTarget
+}
+
+func compareBreakingPackages(against, current *breakingGraph, profile breakingProfiles, report func(protoreflect.Descriptor, string, string)) {
+	if !profile.source {
+		return
+	}
+	packages := make(map[protoreflect.FullName]bool)
+	for _, file := range against.files {
+		if file.Package() != "" {
+			packages[file.Package()] = true
+		}
+	}
+	for pkg := range packages {
+		if !hasPackage(current, pkg) {
+			var source protoreflect.Descriptor
+			for _, file := range against.files {
+				if file.Package() == pkg {
+					if source == nil || file.Path() < source.ParentFile().Path() {
+						source = file
+					}
+				}
+			}
+			report(source, "PACKAGE_NO_DELETE", fmt.Sprintf("Package %q was deleted.", pkg))
+		}
+	}
+}
+
+func hasPackage(graph *breakingGraph, pkg protoreflect.FullName) bool {
+	for _, file := range graph.files {
+		if file.Package() == pkg {
+			return true
+		}
+	}
+	return false
+}
+
+func compareBreakingMessages(against, current *breakingGraph, profile breakingProfiles, report func(protoreflect.Descriptor, string, string)) {
+	for name, oldMessage := range against.messages {
+		newMessage := current.messages[name]
+		if newMessage == nil {
+			if profile.source && !oldMessage.IsMapEntry() {
+				report(oldMessage, "MESSAGE_NO_DELETE", fmt.Sprintf("Message %q was deleted.", name))
+			}
+			continue
+		}
+		if profile.file && oldMessage.ParentFile().Path() != newMessage.ParentFile().Path() {
+			report(oldMessage, "MESSAGE_MOVED", fmt.Sprintf("Message %q was moved from %q to %q.", name, against.paths[oldMessage.ParentFile().Path()], current.paths[newMessage.ParentFile().Path()]))
+		}
+		compareMessageReserved(oldMessage, newMessage, report)
+		compareExtensionRanges(oldMessage, newMessage, profile, report)
+		compareRequiredFields(oldMessage, newMessage, report)
+		compareMessageOptions(oldMessage, newMessage, profile, report)
+		if jsonProfileEnabled(profile) && !sameJSONFormat(oldMessage, newMessage) {
+			report(oldMessage, "MESSAGE_SAME_JSON_FORMAT", fmt.Sprintf("Message %q changed JSON format support.", name))
+		}
+		compareBreakingFields(oldMessage, newMessage, profile, report)
+		compareOneofs(oldMessage, newMessage, profile, report)
+	}
+}
+
+func compareBreakingFields(oldMessage, newMessage protoreflect.MessageDescriptor, profile breakingProfiles, report func(protoreflect.Descriptor, string, string)) {
+	for i := range oldMessage.Fields().Len() {
+		oldField := oldMessage.Fields().Get(i)
+		newField := newMessage.Fields().ByNumber(oldField.Number())
+		if newField == nil {
+			if profile.source {
+				report(oldField, "FIELD_NO_DELETE", fmt.Sprintf("Field %q (%d) on %q was deleted.", oldField.Name(), oldField.Number(), oldMessage.FullName()))
+			} else if profile.wire || profile.wireJSON {
+				if !newMessage.ReservedRanges().Has(oldField.Number()) {
+					report(oldField, "FIELD_NO_DELETE_UNLESS_NUMBER_RESERVED", fmt.Sprintf("Deleted field %q number %d on %q must be reserved.", oldField.Name(), oldField.Number(), oldMessage.FullName()))
+				}
+				if profile.wireJSON && !newMessage.ReservedNames().Has(oldField.Name()) {
+					report(oldField, "FIELD_NO_DELETE_UNLESS_NAME_RESERVED", fmt.Sprintf("Deleted field %q on %q must have its name reserved for JSON compatibility.", oldField.Name(), oldMessage.FullName()))
+				}
+			}
+			continue
+		}
+		compareField(oldField, newField, profile, report)
+	}
+}
+
+func compareField(oldField, newField protoreflect.FieldDescriptor, profile breakingProfiles, report func(protoreflect.Descriptor, string, string)) {
+	fieldName := fmt.Sprintf("Field %q (%d)", oldField.Name(), oldField.Number())
+	if profile.source {
+		if oldField.Name() != newField.Name() {
+			report(oldField, "FIELD_SAME_NAME", fmt.Sprintf("%s on %q changed name to %q.", fieldName, oldField.ContainingMessage().FullName(), newField.Name()))
+		}
+		if oldField.Kind() != newField.Kind() || !sameResolvedType(oldField, newField) {
+			report(oldField, "FIELD_SAME_TYPE", fmt.Sprintf("%s on %q changed type from %s to %s.", fieldName, oldField.ContainingMessage().FullName(), fieldTypeName(oldField), fieldTypeName(newField)))
+		}
+		if fieldCardinality(oldField) != fieldCardinality(newField) {
+			report(oldField, "FIELD_SAME_CARDINALITY", fmt.Sprintf("%s on %q changed cardinality from %s to %s.", fieldName, oldField.ContainingMessage().FullName(), fieldCardinality(oldField), fieldCardinality(newField)))
+		}
+		if oldField.Name() == newField.Name() && oldField.JSONName() != newField.JSONName() {
+			report(oldField, "FIELD_SAME_JSON_NAME", fmt.Sprintf("%s changed JSON name from %q to %q.", fieldName, oldField.JSONName(), newField.JSONName()))
+		}
+		if generatedOneof(oldField) != generatedOneof(newField) {
+			report(oldField, "FIELD_SAME_ONEOF", fmt.Sprintf("%s changed real oneof membership.", fieldName))
+		}
+		compareFieldCodegenOptions(oldField, newField, report)
+	} else if profile.wireJSON || profile.wire {
+		if profile.wireJSON && oldField.Name() != newField.Name() {
+			report(oldField, "FIELD_SAME_NAME", fmt.Sprintf("%s changed name from %q to %q.", fieldName, oldField.Name(), newField.Name()))
+		}
+		if profile.wireJSON && oldField.Name() == newField.Name() && oldField.JSONName() != newField.JSONName() {
+			report(oldField, "FIELD_SAME_JSON_NAME", fmt.Sprintf("%s changed JSON name from %q to %q.", fieldName, oldField.JSONName(), newField.JSONName()))
+		}
+		if !wireFieldTypesCompatible(oldField, newField, profile.wireJSON) {
+			rule := "FIELD_WIRE_COMPATIBLE_TYPE"
+			if profile.wireJSON {
+				rule = "FIELD_WIRE_JSON_COMPATIBLE_TYPE"
+			}
+			report(oldField, rule, fmt.Sprintf("%s on %q changed incompatibly from %s to %s.", fieldName, oldField.ContainingMessage().FullName(), fieldTypeName(oldField), fieldTypeName(newField)))
+		}
+		oldCardinality, newCardinality := fieldCardinality(oldField), fieldCardinality(newField)
+		if oldCardinality != newCardinality && !wireCompatibleCardinality(oldField, newField, profile.wireJSON) {
+			rule := "FIELD_WIRE_COMPATIBLE_CARDINALITY"
+			if profile.wireJSON {
+				rule = "FIELD_WIRE_JSON_COMPATIBLE_CARDINALITY"
+			}
+			report(oldField, rule, fmt.Sprintf("%s on %q changed cardinality from %s to %s.", fieldName, oldField.ContainingMessage().FullName(), oldCardinality, newCardinality))
+		}
+		if generatedOneof(oldField) != generatedOneof(newField) {
+			report(oldField, "FIELD_SAME_ONEOF", fmt.Sprintf("%s changed real oneof membership.", fieldName))
+		}
+	}
+	if !sameFieldDefault(oldField, newField) {
+		report(oldField, "FIELD_SAME_DEFAULT", fmt.Sprintf("%s default changed.", fieldName))
+	}
+}
+
+func wireFieldTypesCompatible(oldField, newField protoreflect.FieldDescriptor, json bool) bool {
+	return wireCompatibleType(oldField, newField, json, make(map[typePair]bool))
+}
+
+func sameResolvedType(oldField, newField protoreflect.FieldDescriptor) bool {
+	if oldField.Kind() != newField.Kind() {
+		return false
+	}
+	switch oldField.Kind() {
+	case protoreflect.MessageKind, protoreflect.GroupKind:
+		return oldField.Message().FullName() == newField.Message().FullName()
+	case protoreflect.EnumKind:
+		return oldField.Enum().FullName() == newField.Enum().FullName()
+	default:
+		return true
+	}
+}
+
+func fieldTypeName(field protoreflect.FieldDescriptor) string {
+	switch field.Kind() {
+	case protoreflect.MessageKind, protoreflect.GroupKind:
+		return string(field.Message().FullName())
+	case protoreflect.EnumKind:
+		return string(field.Enum().FullName())
+	default:
+		return field.Kind().String()
+	}
+}
+
+func fieldCardinality(field protoreflect.FieldDescriptor) string {
+	if field.IsMap() {
+		return "map"
+	}
+	switch field.Cardinality() {
+	case protoreflect.Required:
+		return "required"
+	case protoreflect.Repeated:
+		return "repeated"
+	}
+	if field.HasPresence() {
+		return "optional_explicit"
+	}
+	return "optional_implicit"
+}
+
+func generatedOneof(field protoreflect.FieldDescriptor) protoreflect.FullName {
+	oneof := field.ContainingOneof()
+	if oneof == nil || oneof.IsSynthetic() {
+		return ""
+	}
+	return oneof.FullName()
+}
+
+type typePair struct {
+	oldName protoreflect.FullName
+	newName protoreflect.FullName
+}
+
+func wireCompatibleType(oldField, newField protoreflect.FieldDescriptor, json bool, seen map[typePair]bool) bool {
+	oldKind, newKind := oldField.Kind(), newField.Kind()
+	if oldKind == newKind {
+		switch oldKind {
+		case protoreflect.EnumKind:
+			if oldField.Enum().FullName() == newField.Enum().FullName() {
+				return true
+			}
+			return compatibleEnumType(oldField.Enum(), newField.Enum())
+		case protoreflect.MessageKind, protoreflect.GroupKind:
+			if oldField.Message().FullName() == newField.Message().FullName() {
+				return true
+			}
+			return wireCompatibleMessages(oldField.Message(), newField.Message(), json, seen)
+		default:
+			return true
+		}
+	}
+	if oldKind == protoreflect.StringKind && newKind == protoreflect.BytesKind {
+		return !json
+	}
+	if json {
+		return sameScalarFamily(oldKind, newKind, []protoreflect.Kind{protoreflect.Int32Kind, protoreflect.Uint32Kind}) ||
+			sameScalarFamily(oldKind, newKind, []protoreflect.Kind{protoreflect.Int64Kind, protoreflect.Uint64Kind}) ||
+			sameScalarFamily(oldKind, newKind, []protoreflect.Kind{protoreflect.Fixed32Kind, protoreflect.Sfixed32Kind}) ||
+			sameScalarFamily(oldKind, newKind, []protoreflect.Kind{protoreflect.Fixed64Kind, protoreflect.Sfixed64Kind})
+	}
+	return sameScalarFamily(oldKind, newKind, []protoreflect.Kind{protoreflect.Int32Kind, protoreflect.Uint32Kind, protoreflect.Int64Kind, protoreflect.Uint64Kind, protoreflect.BoolKind}) ||
+		sameScalarFamily(oldKind, newKind, []protoreflect.Kind{protoreflect.Sint32Kind, protoreflect.Sint64Kind}) ||
+		sameScalarFamily(oldKind, newKind, []protoreflect.Kind{protoreflect.Fixed32Kind, protoreflect.Sfixed32Kind}) ||
+		sameScalarFamily(oldKind, newKind, []protoreflect.Kind{protoreflect.Fixed64Kind, protoreflect.Sfixed64Kind})
+}
+
+func sameScalarFamily(oldKind, newKind protoreflect.Kind, kinds []protoreflect.Kind) bool {
+	return slices.Contains(kinds, oldKind) && slices.Contains(kinds, newKind)
+}
+
+func compatibleEnumType(oldEnum, newEnum protoreflect.EnumDescriptor) bool {
+	if oldEnum.Name() != newEnum.Name() {
+		return false
+	}
+	newPairs := enumPairs(newEnum)
+	for pair := range enumPairs(oldEnum) {
+		if !newPairs[pair] {
+			return false
+		}
+	}
+	return true
+}
+
+type enumPair struct {
+	name   protoreflect.Name
+	number protoreflect.EnumNumber
+}
+
+func enumPairs(enum protoreflect.EnumDescriptor) map[enumPair]bool {
+	pairs := make(map[enumPair]bool)
+	for i := range enum.Values().Len() {
+		value := enum.Values().Get(i)
+		pairs[enumPair{name: value.Name(), number: value.Number()}] = true
+	}
+	return pairs
+}
+
+func wireCompatibleMessages(oldMessage, newMessage protoreflect.MessageDescriptor, json bool, seen map[typePair]bool) bool {
+	pair := typePair{oldName: oldMessage.FullName(), newName: newMessage.FullName()}
+	if seen[pair] {
+		return true
+	}
+	seen[pair] = true
+	if !rangesPreserved(oldMessage.ReservedRanges(), newMessage.ReservedRanges()) {
+		return false
+	}
+	for i := range oldMessage.ReservedNames().Len() {
+		if !newMessage.ReservedNames().Has(oldMessage.ReservedNames().Get(i)) {
+			return false
+		}
+	}
+	if oldMessage.Options().(*descriptorpb.MessageOptions).GetMessageSetWireFormat() != newMessage.Options().(*descriptorpb.MessageOptions).GetMessageSetWireFormat() {
+		return false
+	}
+	if json && !sameJSONFormat(oldMessage, newMessage) {
+		return false
+	}
+	for i := range newMessage.Fields().Len() {
+		next := newMessage.Fields().Get(i)
+		old := oldMessage.Fields().ByNumber(next.Number())
+		if next.Cardinality() == protoreflect.Required && (old == nil || old.Cardinality() != protoreflect.Required) {
+			return false
+		}
+	}
+	for i := range oldMessage.Fields().Len() {
+		old := oldMessage.Fields().Get(i)
+		next := newMessage.Fields().ByNumber(old.Number())
+		if next == nil {
+			if old.Cardinality() == protoreflect.Required || !newMessage.ReservedRanges().Has(old.Number()) {
+				return false
+			}
+			if json && !newMessage.ReservedNames().Has(old.Name()) {
+				return false
+			}
+			continue
+		}
+		if !wireCompatibleType(old, next, json, seen) || !wireCompatibleCardinality(old, next, json) || !sameFieldDefault(old, next) {
+			return false
+		}
+		if json && (old.Name() != next.Name() || old.JSONName() != next.JSONName()) {
+			return false
+		}
+		oldOne, newOne := old.ContainingOneof(), next.ContainingOneof()
+		oldReal, newReal := oldOne != nil && !oldOne.IsSynthetic(), newOne != nil && !newOne.IsSynthetic()
+		if oldReal != newReal || (oldReal && oldOne.Name() != newOne.Name()) {
+			return false
+		}
+	}
+	return true
+}
+
+func wireCompatibleCardinality(oldField, newField protoreflect.FieldDescriptor, json bool) bool {
+	oldCardinality, newCardinality := fieldCardinality(oldField), fieldCardinality(newField)
+	if oldCardinality == newCardinality || optionalPresenceCardinality(oldCardinality, newCardinality) {
+		return true
+	}
+	if oldCardinality == "required" || newCardinality == "required" {
+		return false
+	}
+	if !json && ((oldCardinality == "map" && newCardinality == "repeated") || (oldCardinality == "repeated" && newCardinality == "map")) {
+		if oldField.Kind() != protoreflect.MessageKind || newField.Kind() != protoreflect.MessageKind {
+			return false
+		}
+		return wireCompatibleMessages(oldField.Message(), newField.Message(), false, make(map[typePair]bool))
+	}
+	return false
+}
+
+func optionalPresenceCardinality(oldCardinality, newCardinality string) bool {
+	return strings.HasPrefix(oldCardinality, "optional_") && strings.HasPrefix(newCardinality, "optional_")
+}
+
+func compareBreakingEnums(against, current *breakingGraph, profile breakingProfiles, report func(protoreflect.Descriptor, string, string)) {
+	for name, oldEnum := range against.enums {
+		newEnum := current.enums[name]
+		if newEnum == nil {
+			if profile.source {
+				report(oldEnum, "ENUM_NO_DELETE", fmt.Sprintf("Enum %q was deleted.", name))
+			}
+			continue
+		}
+		if profile.file && oldEnum.ParentFile().Path() != newEnum.ParentFile().Path() {
+			report(oldEnum, "ENUM_MOVED", fmt.Sprintf("Enum %q was moved from %q to %q.", name, against.paths[oldEnum.ParentFile().Path()], current.paths[newEnum.ParentFile().Path()]))
+		}
+		compareEnumReserved(oldEnum, newEnum, report)
+		if profile.source && oldEnum.IsClosed() != newEnum.IsClosed() {
+			report(oldEnum, "ENUM_SAME_TYPE", fmt.Sprintf("Enum %q changed between open and closed semantics.", name))
+		}
+		if jsonProfileEnabled(profile) && !sameJSONFormat(oldEnum, newEnum) {
+			rule := "ENUM_SAME_JSON_FORMAT"
+			report(oldEnum, rule, fmt.Sprintf("Enum %q changed JSON format support.", name))
+		}
+		oldValues := enumPairs(oldEnum)
+		newValues := enumPairs(newEnum)
+		for oldPair := range oldValues {
+			if newValues[oldPair] {
+				continue
+			}
+			matchingNumber := enumValueAtNumber(newEnum, oldPair.number)
+			if matchingNumber != nil && matchingNumber.Name() != oldPair.name && profile.source || matchingNumber != nil && matchingNumber.Name() != oldPair.name && profile.wireJSON {
+				report(oldEnum, "ENUM_VALUE_SAME_NAME", fmt.Sprintf("Enum value %q at number %d in %q changed name to %q.", oldPair.name, oldPair.number, name, matchingNumber.Name()))
+				continue
+			}
+			if profile.source {
+				report(oldEnum, "ENUM_VALUE_NO_DELETE", fmt.Sprintf("Enum value %q = %d in %q was deleted.", oldPair.name, oldPair.number, name))
+			} else if profile.wire || profile.wireJSON {
+				if matchingNumber == nil && !newEnum.ReservedRanges().Has(oldPair.number) {
+					report(oldEnum, "ENUM_VALUE_NO_DELETE_UNLESS_NUMBER_RESERVED", fmt.Sprintf("Deleted enum number %d in %q must be reserved.", oldPair.number, name))
+				}
+				if profile.wireJSON && !newEnum.ReservedNames().Has(oldPair.name) {
+					report(oldEnum, "ENUM_VALUE_NO_DELETE_UNLESS_NAME_RESERVED", fmt.Sprintf("Deleted enum name %q in %q must be reserved for JSON compatibility.", oldPair.name, name))
+				}
+			}
+		}
+	}
+}
+
+func enumValueAtNumber(enum protoreflect.EnumDescriptor, number protoreflect.EnumNumber) protoreflect.EnumValueDescriptor {
+	for i := range enum.Values().Len() {
+		value := enum.Values().Get(i)
+		if value.Number() == number {
+			return value
+		}
+	}
+	return nil
+}
+
+func compareBreakingServices(against, current *breakingGraph, profile breakingProfiles, report func(protoreflect.Descriptor, string, string)) {
+	for name, oldService := range against.services {
+		newService := current.services[name]
+		if newService == nil {
+			report(oldService, "SERVICE_NO_DELETE", fmt.Sprintf("Service %q was deleted.", name))
+			continue
+		}
+		if profile.file && oldService.ParentFile().Path() != newService.ParentFile().Path() {
+			report(oldService, "SERVICE_MOVED", fmt.Sprintf("Service %q was moved from %q to %q.", name, against.paths[oldService.ParentFile().Path()], current.paths[newService.ParentFile().Path()]))
+		}
+		for i := range oldService.Methods().Len() {
+			oldMethod := oldService.Methods().Get(i)
+			newMethod := newService.Methods().ByName(oldMethod.Name())
+			if newMethod == nil {
+				report(oldMethod, "RPC_NO_DELETE", fmt.Sprintf("RPC %q on service %q was deleted.", oldMethod.Name(), name))
+				continue
+			}
+			if oldMethod.Input().FullName() != newMethod.Input().FullName() {
+				report(oldMethod, "RPC_SAME_REQUEST_TYPE", fmt.Sprintf("RPC %q request type changed from %q to %q.", oldMethod.Name(), oldMethod.Input().FullName(), newMethod.Input().FullName()))
+			}
+			if oldMethod.Output().FullName() != newMethod.Output().FullName() {
+				report(oldMethod, "RPC_SAME_RESPONSE_TYPE", fmt.Sprintf("RPC %q response type changed from %q to %q.", oldMethod.Name(), oldMethod.Output().FullName(), newMethod.Output().FullName()))
+			}
+			if oldMethod.IsStreamingClient() != newMethod.IsStreamingClient() {
+				report(oldMethod, "RPC_SAME_CLIENT_STREAMING", fmt.Sprintf("RPC %q changed client streaming behavior.", oldMethod.Name()))
+			}
+			if oldMethod.IsStreamingServer() != newMethod.IsStreamingServer() {
+				report(oldMethod, "RPC_SAME_SERVER_STREAMING", fmt.Sprintf("RPC %q changed server streaming behavior.", oldMethod.Name()))
+			}
+			oldOptions := oldMethod.Options().(*descriptorpb.MethodOptions)
+			newOptions := newMethod.Options().(*descriptorpb.MethodOptions)
+			if oldOptions.GetIdempotencyLevel() != newOptions.GetIdempotencyLevel() {
+				report(oldMethod, "RPC_SAME_IDEMPOTENCY_LEVEL", fmt.Sprintf("RPC %q changed idempotency level.", oldMethod.Name()))
+			}
+		}
+	}
+}
+
+func compareBreakingExtensions(against, current *breakingGraph, profile breakingProfiles, report func(protoreflect.Descriptor, string, string)) {
+	for name, old := range against.ext {
+		next := current.ext[name]
+		if next == nil {
+			if profile.source {
+				report(old, "EXTENSION_NO_DELETE", fmt.Sprintf("Extension %q was deleted.", name))
+			}
+			continue
+		}
+		if old.Number() != next.Number() {
+			report(old, "EXTENSION_SAME_NUMBER", fmt.Sprintf("Extension %q changed number from %d to %d.", name, old.Number(), next.Number()))
+		}
+		if old.ContainingMessage().FullName() != next.ContainingMessage().FullName() {
+			report(old, "EXTENSION_SAME_EXTENDEE", fmt.Sprintf("Extension %q changed the extended message.", name))
+		}
+		if profile.file && old.ParentFile().Path() != next.ParentFile().Path() {
+			report(old, "EXTENSION_MOVED", fmt.Sprintf("Extension %q was moved between files.", name))
+		}
+		compareField(old, next, profile, report)
+	}
+}
+
+func compareBreakingFileOptions(against, current *breakingGraph, profile breakingProfiles, report func(protoreflect.Descriptor, string, string)) {
+	seen := make(map[[2]string]bool)
+	pair := func(oldFile, newFile protoreflect.FileDescriptor) {
+		key := [2]string{oldFile.Path(), newFile.Path()}
+		if seen[key] {
+			return
+		}
+		seen[key] = true
+		compareBreakingFilePair(oldFile, newFile, profile, report)
+	}
+	for name, old := range against.files {
+		if next := current.files[name]; next != nil {
+			pair(old, next)
+		}
+	}
+	if !profile.source {
+		return
+	}
+	for name, old := range against.messages {
+		if next := current.messages[name]; next != nil {
+			pair(old.ParentFile(), next.ParentFile())
+		}
+	}
+	for name, old := range against.enums {
+		if next := current.enums[name]; next != nil {
+			pair(old.ParentFile(), next.ParentFile())
+		}
+	}
+	for name, old := range against.services {
+		if next := current.services[name]; next != nil {
+			pair(old.ParentFile(), next.ParentFile())
+		}
+	}
+	for name, old := range against.ext {
+		if next := current.ext[name]; next != nil {
+			pair(old.ParentFile(), next.ParentFile())
+		}
+	}
+}
+
+func compareBreakingFilePair(oldFile, newFile protoreflect.FileDescriptor, profile breakingProfiles, report func(protoreflect.Descriptor, string, string)) {
+	name := oldFile.Path()
+	if oldFile.Package() != newFile.Package() {
+		report(oldFile, "FILE_SAME_PACKAGE", fmt.Sprintf("File %q changed package from %q to %q.", name, oldFile.Package(), newFile.Package()))
+	}
+	if !profile.source {
+		return
+	}
+	oldOptions := oldFile.Options().(*descriptorpb.FileOptions)
+	newOptions := newFile.Options().(*descriptorpb.FileOptions)
+	compareOption(oldFile, oldOptions.GetGoPackage(), newOptions.GetGoPackage(), "FILE_SAME_GO_PACKAGE", "go_package", report)
+	compareOption(oldFile, oldOptions.GetJavaPackage(), newOptions.GetJavaPackage(), "FILE_SAME_JAVA_PACKAGE", "java_package", report)
+	compareOption(oldFile, oldOptions.GetJavaOuterClassname(), newOptions.GetJavaOuterClassname(), "FILE_SAME_JAVA_OUTER_CLASSNAME", "java_outer_classname", report)
+	compareOption(oldFile, oldOptions.GetJavaMultipleFiles(), newOptions.GetJavaMultipleFiles(), "FILE_SAME_JAVA_MULTIPLE_FILES", "java_multiple_files", report)
+	compareOption(oldFile, oldOptions.GetJavaStringCheckUtf8(), newOptions.GetJavaStringCheckUtf8(), "FILE_SAME_JAVA_STRING_CHECK_UTF8", "java_string_check_utf8", report)
+	compareOption(oldFile, oldOptions.GetCsharpNamespace(), newOptions.GetCsharpNamespace(), "FILE_SAME_CSHARP_NAMESPACE", "csharp_namespace", report)
+	compareOption(oldFile, oldOptions.GetObjcClassPrefix(), newOptions.GetObjcClassPrefix(), "FILE_SAME_OBJC_CLASS_PREFIX", "objc_class_prefix", report)
+	compareOption(oldFile, oldOptions.GetOptimizeFor(), newOptions.GetOptimizeFor(), "FILE_SAME_OPTIMIZE_FOR", "optimize_for", report)
+	compareOption(oldFile, oldOptions.GetPhpNamespace(), newOptions.GetPhpNamespace(), "FILE_SAME_PHP_NAMESPACE", "php_namespace", report)
+	compareOption(oldFile, oldOptions.GetPhpClassPrefix(), newOptions.GetPhpClassPrefix(), "FILE_SAME_PHP_CLASS_PREFIX", "php_class_prefix", report)
+	compareOption(oldFile, oldOptions.GetPhpMetadataNamespace(), newOptions.GetPhpMetadataNamespace(), "FILE_SAME_PHP_METADATA_NAMESPACE", "php_metadata_namespace", report)
+	compareOption(oldFile, oldOptions.GetRubyPackage(), newOptions.GetRubyPackage(), "FILE_SAME_RUBY_PACKAGE", "ruby_package", report)
+	compareOption(oldFile, oldOptions.GetSwiftPrefix(), newOptions.GetSwiftPrefix(), "FILE_SAME_SWIFT_PREFIX", "swift_prefix", report)
+	compareOption(oldFile, oldOptions.GetCcEnableArenas(), newOptions.GetCcEnableArenas(), "FILE_SAME_CC_ENABLE_ARENAS", "cc_enable_arenas", report)
+	compareOption(oldFile, oldOptions.GetCcGenericServices(), newOptions.GetCcGenericServices(), "FILE_SAME_CC_GENERIC_SERVICES", "cc_generic_services", report)
+	compareOption(oldFile, oldOptions.GetJavaGenericServices(), newOptions.GetJavaGenericServices(), "FILE_SAME_JAVA_GENERIC_SERVICES", "java_generic_services", report)
+	compareOption(oldFile, oldOptions.GetPyGenericServices(), newOptions.GetPyGenericServices(), "FILE_SAME_PY_GENERIC_SERVICES", "py_generic_services", report)
+	if oldFile.Syntax() != newFile.Syntax() {
+		report(oldFile, "FILE_SAME_SYNTAX", fmt.Sprintf("File %q changed syntax from %s to %s.", name, oldFile.Syntax(), newFile.Syntax()))
+	}
+	oldProto := protoutil.ProtoFromFileDescriptor(oldFile)
+	newProto := protoutil.ProtoFromFileDescriptor(newFile)
+	if oldProto.GetEdition() != newProto.GetEdition() {
+		report(oldFile, "FILE_SAME_SYNTAX", fmt.Sprintf("File %q changed edition from %s to %s.", name, oldProto.GetEdition(), newProto.GetEdition()))
+	}
+}
+
+func compareOption[T comparable](descriptor protoreflect.Descriptor, oldValue, newValue T, rule, option string, report func(protoreflect.Descriptor, string, string)) {
+	if oldValue != newValue {
+		report(descriptor, rule, fmt.Sprintf("File option %s changed.", option))
+	}
+}
+
+func compareFieldCodegenOptions(oldField, newField protoreflect.FieldDescriptor, report func(protoreflect.Descriptor, string, string)) {
+	oldOptions := oldField.Options().(*descriptorpb.FieldOptions)
+	newOptions := newField.Options().(*descriptorpb.FieldOptions)
+	if oldOptions.GetJstype() != newOptions.GetJstype() {
+		report(oldField, "FIELD_SAME_JSTYPE", fmt.Sprintf("Field %q changed jstype option.", oldField.FullName()))
+	}
+	if effectiveCPPString(oldField) != effectiveCPPString(newField) {
+		report(oldField, "FIELD_SAME_CPP_STRING_TYPE", fmt.Sprintf("Field %q changed C++ string type option.", oldField.FullName()))
+	}
+	if oldField.Kind() == protoreflect.StringKind && newField.Kind() == protoreflect.StringKind && effectiveUTF8(oldField) != effectiveUTF8(newField) {
+		report(oldField, "FIELD_SAME_UTF8_VALIDATION", fmt.Sprintf("Field %q changed UTF-8 validation behavior.", oldField.FullName()))
+	}
+	if oldField.Kind() == protoreflect.StringKind && newField.Kind() == protoreflect.StringKind && effectiveJavaUTF8(oldField) != effectiveJavaUTF8(newField) {
+		report(oldField, "FIELD_SAME_JAVA_UTF8_VALIDATION", fmt.Sprintf("Field %q changed Java UTF-8 validation behavior.", oldField.FullName()))
+	}
+}
+
+func effectiveUTF8(field protoreflect.FieldDescriptor) descriptorpb.FeatureSet_Utf8Validation {
+	for current := protoreflect.Descriptor(field); current != nil; current = current.Parent() {
+		features := descriptorFeatures(current)
+		if features != nil && features.Utf8Validation != nil {
+			return features.GetUtf8Validation()
+		}
+	}
+	if field.Syntax() == protoreflect.Proto3 || field.Syntax() == protoreflect.Editions {
+		return descriptorpb.FeatureSet_VERIFY
+	}
+	return descriptorpb.FeatureSet_NONE
+}
+
+func effectiveJavaUTF8(field protoreflect.FieldDescriptor) bool {
+	if value, ok := languageFeature(field, "pb.java", "utf8_validation"); ok {
+		if value == "VERIFY" {
+			return true
+		}
+		if value == "NONE" {
+			return false
+		}
+	}
+	return effectiveUTF8(field) == descriptorpb.FeatureSet_VERIFY || field.ParentFile().Options().(*descriptorpb.FileOptions).GetJavaStringCheckUtf8()
+}
+
+func fieldFeatures(field protoreflect.FieldDescriptor) *descriptorpb.FeatureSet {
+	return field.Options().(*descriptorpb.FieldOptions).GetFeatures()
+}
+
+func compareMessageOptions(oldMessage, newMessage protoreflect.MessageDescriptor, profile breakingProfiles, report func(protoreflect.Descriptor, string, string)) {
+	if oldMessage.Options().(*descriptorpb.MessageOptions).GetMessageSetWireFormat() != newMessage.Options().(*descriptorpb.MessageOptions).GetMessageSetWireFormat() {
+		report(oldMessage, "MESSAGE_SAME_MESSAGE_SET_WIRE_FORMAT", fmt.Sprintf("Message %q changed message-set encoding.", oldMessage.FullName()))
+	}
+	if !profile.source {
+		return
+	}
+	oldOptions := oldMessage.Options().(*descriptorpb.MessageOptions)
+	newOptions := newMessage.Options().(*descriptorpb.MessageOptions)
+	if !oldOptions.GetNoStandardDescriptorAccessor() && newOptions.GetNoStandardDescriptorAccessor() {
+		report(oldMessage, "MESSAGE_NO_REMOVE_STANDARD_DESCRIPTOR_ACCESSOR", fmt.Sprintf("Message %q disabled standard descriptor accessors.", oldMessage.FullName()))
+	}
+}
+
+func compareOneofs(oldMessage, newMessage protoreflect.MessageDescriptor, profile breakingProfiles, report func(protoreflect.Descriptor, string, string)) {
+	if !profile.source {
+		return
+	}
+	for i := range oldMessage.Oneofs().Len() {
+		oldOneof := oldMessage.Oneofs().Get(i)
+		if oldOneof.IsSynthetic() {
+			continue
+		}
+		newOneof := newMessage.Oneofs().ByName(oldOneof.Name())
+		if newOneof == nil || newOneof.IsSynthetic() {
+			report(oldOneof, "ONEOF_NO_DELETE", fmt.Sprintf("Oneof %q on %q was deleted.", oldOneof.Name(), oldMessage.FullName()))
+			continue
+		}
+		if profile.file && oldOneof.ParentFile().Path() != newOneof.ParentFile().Path() {
+			report(oldOneof, "ONEOF_MOVED", fmt.Sprintf("Oneof %q on %q was moved from %q to %q.", oldOneof.Name(), oldMessage.FullName(), oldOneof.ParentFile().Path(), newOneof.ParentFile().Path()))
+		}
+	}
+}
+
+func compareRequiredFields(oldMessage, newMessage protoreflect.MessageDescriptor, report func(protoreflect.Descriptor, string, string)) {
+	oldRequired, newRequired := oldMessage.RequiredNumbers(), newMessage.RequiredNumbers()
+	for i := range oldRequired.Len() {
+		number := oldRequired.Get(i)
+		if !newRequired.Has(number) {
+			report(oldMessage, "MESSAGE_SAME_REQUIRED_FIELDS", fmt.Sprintf("Message %q removed required field number %d.", oldMessage.FullName(), number))
+		}
+	}
+	for i := range newRequired.Len() {
+		number := newRequired.Get(i)
+		if !oldRequired.Has(number) {
+			field := newMessage.Fields().ByNumber(number)
+			report(field, "MESSAGE_SAME_REQUIRED_FIELDS", fmt.Sprintf("Message %q added required field number %d.", oldMessage.FullName(), number))
+		}
+	}
+}
+
+func compareMessageReserved(oldMessage, newMessage protoreflect.MessageDescriptor, report func(protoreflect.Descriptor, string, string)) {
+	for i := range oldMessage.ReservedNames().Len() {
+		name := oldMessage.ReservedNames().Get(i)
+		if !newMessage.ReservedNames().Has(name) {
+			report(oldMessage, "RESERVED_MESSAGE_NO_DELETE", fmt.Sprintf("Message %q released reserved field name %q.", oldMessage.FullName(), name))
+		}
+	}
+	if !rangesPreserved(oldMessage.ReservedRanges(), newMessage.ReservedRanges()) {
+		report(oldMessage, "RESERVED_MESSAGE_NO_DELETE", fmt.Sprintf("Message %q released a reserved field number range.", oldMessage.FullName()))
+	}
+}
+
+func compareEnumReserved(oldEnum, newEnum protoreflect.EnumDescriptor, report func(protoreflect.Descriptor, string, string)) {
+	for i := range oldEnum.ReservedNames().Len() {
+		name := oldEnum.ReservedNames().Get(i)
+		if !newEnum.ReservedNames().Has(name) {
+			report(oldEnum, "RESERVED_ENUM_NO_DELETE", fmt.Sprintf("Enum %q released reserved value name %q.", oldEnum.FullName(), name))
+		}
+	}
+	if !enumRangesPreserved(oldEnum.ReservedRanges(), newEnum.ReservedRanges()) {
+		report(oldEnum, "RESERVED_ENUM_NO_DELETE", fmt.Sprintf("Enum %q released a reserved number range.", oldEnum.FullName()))
+	}
+}
+
+func compareExtensionRanges(oldMessage, newMessage protoreflect.MessageDescriptor, profile breakingProfiles, report func(protoreflect.Descriptor, string, string)) {
+	if !profile.source {
+		return
+	}
+	if !rangesPreserved(oldMessage.ExtensionRanges(), newMessage.ExtensionRanges()) {
+		report(oldMessage, "EXTENSION_MESSAGE_NO_DELETE", fmt.Sprintf("Message %q removed or narrowed an extension range.", oldMessage.FullName()))
+	}
+}
+
+func rangesPreserved(oldRanges, newRanges protoreflect.FieldRanges) bool {
+	oldIntervals := make([][2]int64, oldRanges.Len())
+	newIntervals := make([][2]int64, newRanges.Len())
+	for i := range oldIntervals {
+		r := oldRanges.Get(i)
+		oldIntervals[i] = [2]int64{int64(r[0]), int64(r[1])}
+	}
+	for i := range newIntervals {
+		r := newRanges.Get(i)
+		newIntervals[i] = [2]int64{int64(r[0]), int64(r[1])}
+	}
+	return intervalsPreserved(oldIntervals, newIntervals)
+}
+
+func enumRangesPreserved(oldRanges, newRanges protoreflect.EnumRanges) bool {
+	oldIntervals := make([][2]int64, oldRanges.Len())
+	newIntervals := make([][2]int64, newRanges.Len())
+	for i := range oldIntervals {
+		r := oldRanges.Get(i)
+		oldIntervals[i] = [2]int64{int64(r[0]), int64(r[1]) + 1}
+	}
+	for i := range newIntervals {
+		r := newRanges.Get(i)
+		newIntervals[i] = [2]int64{int64(r[0]), int64(r[1]) + 1}
+	}
+	return intervalsPreserved(oldIntervals, newIntervals)
+}
+
+func jsonProfileEnabled(profile breakingProfiles) bool {
+	return profile.source || profile.wireJSON
+}
+
+func sameJSONFormat(oldDescriptor, newDescriptor protoreflect.Descriptor) bool {
+	return effectiveJSONFormat(oldDescriptor) != descriptorpb.FeatureSet_ALLOW || effectiveJSONFormat(newDescriptor) == descriptorpb.FeatureSet_ALLOW
+}
+
+func effectiveJSONFormat(descriptor protoreflect.Descriptor) descriptorpb.FeatureSet_JsonFormat {
+	for current := descriptor; current != nil; current = current.Parent() {
+		var features *descriptorpb.FeatureSet
+		switch typed := current.(type) {
+		case protoreflect.FileDescriptor:
+			features = typed.Options().(*descriptorpb.FileOptions).GetFeatures()
+		case protoreflect.MessageDescriptor:
+			features = typed.Options().(*descriptorpb.MessageOptions).GetFeatures()
+		case protoreflect.EnumDescriptor:
+			features = typed.Options().(*descriptorpb.EnumOptions).GetFeatures()
+		}
+		if features != nil && features.JsonFormat != nil {
+			return features.GetJsonFormat()
+		}
+		if file, ok := current.(protoreflect.FileDescriptor); ok {
+			if file.Syntax() == protoreflect.Proto3 || file.Syntax() == protoreflect.Editions {
+				return descriptorpb.FeatureSet_ALLOW
+			}
+			return descriptorpb.FeatureSet_LEGACY_BEST_EFFORT
+		}
+	}
+	return descriptorpb.FeatureSet_JSON_FORMAT_UNKNOWN
+}
+
+func deduplicateBreakingIssues(issues []IssueInfo) []IssueInfo {
+	seen := make(map[string]bool, len(issues))
+	result := make([]IssueInfo, 0, len(issues))
+	for _, issue := range issues {
+		key := fmt.Sprintf("%s\x00%s\x00%s\x00%d\x00%d", issue.Path, issue.RuleName, issue.Message, issue.Position.Line, issue.Position.Column)
+		if !seen[key] {
+			seen[key] = true
+			result = append(result, issue)
+		}
+	}
+	slices.SortFunc(result, func(left, right IssueInfo) int {
+		if order := strings.Compare(left.Path, right.Path); order != 0 {
+			return order
+		}
+		if left.Position.Line != right.Position.Line {
+			return left.Position.Line - right.Position.Line
+		}
+		if left.Position.Column != right.Position.Column {
+			return left.Position.Column - right.Position.Column
+		}
+		if order := strings.Compare(left.RuleName, right.RuleName); order != 0 {
+			return order
+		}
+		return strings.Compare(left.Message, right.Message)
+	})
+	return result
+}
+
+// intervalsPreserved checks interval coverage, not individual field numbers.
+// int64 half-open endpoints also represent an enum's inclusive MaxInt32 safely.
+func intervalsPreserved(oldRanges, newRanges [][2]int64) bool {
+	slices.SortFunc(newRanges, func(a, b [2]int64) int {
+		if a[0] < b[0] {
+			return -1
+		}
+		if a[0] > b[0] {
+			return 1
+		}
+		return 0
+	})
+	for _, old := range oldRanges {
+		end := old[0]
+		for _, next := range newRanges {
+			if next[1] <= end {
+				continue
+			}
+			if next[0] > end {
+				break
+			}
+			end = next[1]
+			if end >= old[1] {
+				break
+			}
+		}
+		if end < old[1] {
+			return false
+		}
+	}
+	return true
+}
+
+func sameFieldDefault(oldField, newField protoreflect.FieldDescriptor) bool {
+	if !oldField.HasDefault() && !newField.HasDefault() {
+		if oldField.Kind() == protoreflect.EnumKind && newField.Kind() == protoreflect.EnumKind {
+			if oldField.Cardinality() == protoreflect.Repeated || newField.Cardinality() == protoreflect.Repeated {
+				return true
+			}
+			// Linked descriptors expose DefaultEnumValue only for an explicit
+			// option. The implicit enum default is its first declared value.
+			return oldField.Enum().Values().Get(0).Number() == newField.Enum().Values().Get(0).Number()
+		}
+		return true
+	}
+	normalize := func(field protoreflect.FieldDescriptor) string {
+		value := field.Default()
+		switch field.Kind() {
+		case protoreflect.BytesKind:
+			return string(value.Bytes())
+		case protoreflect.StringKind:
+			return value.String()
+		case protoreflect.BoolKind:
+			if value.Bool() {
+				return "1"
+			}
+			return "0"
+		default:
+			return fmt.Sprint(value.Interface())
+		}
+	}
+	return normalize(oldField) == normalize(newField)
+}
+
+func descriptorFeatures(d protoreflect.Descriptor) *descriptorpb.FeatureSet {
+	switch d := d.(type) {
+	case protoreflect.FieldDescriptor:
+		return fieldFeatures(d)
+	case protoreflect.MessageDescriptor:
+		return d.Options().(*descriptorpb.MessageOptions).GetFeatures()
+	case protoreflect.EnumDescriptor:
+		return d.Options().(*descriptorpb.EnumOptions).GetFeatures()
+	case protoreflect.FileDescriptor:
+		return d.Options().(*descriptorpb.FileOptions).GetFeatures()
+	default:
+		return nil
+	}
+}
+
+func languageFeature(d protoreflect.Descriptor, extension, name string) (string, bool) {
+	for current := d; current != nil; current = current.Parent() {
+		features := descriptorFeatures(current)
+		if features == nil {
+			continue
+		}
+		var value string
+		found := false
+		features.ProtoReflect().Range(func(field protoreflect.FieldDescriptor, v protoreflect.Value) bool {
+			if string(field.FullName()) != extension || field.Kind() != protoreflect.MessageKind {
+				return true
+			}
+			message := v.Message()
+			member := message.Descriptor().Fields().ByName(protoreflect.Name(name))
+			if member == nil || !message.Has(member) || member.Kind() != protoreflect.EnumKind {
+				return true
+			}
+			enum := member.Enum().Values().ByNumber(message.Get(member).Enum())
+			if enum != nil {
+				value = string(enum.Name())
+				found = true
+			}
+			return !found
+		})
+		if found {
+			return value, true
+		}
+	}
+	return "", false
+}
+
+func effectiveCPPString(field protoreflect.FieldDescriptor) string {
+	if value, ok := languageFeature(field, "pb.cpp", "string_type"); ok {
+		return value
+	}
+	options := field.Options().(*descriptorpb.FieldOptions)
+	switch options.GetCtype() {
+	case descriptorpb.FieldOptions_CORD:
+		return "CORD"
+	case descriptorpb.FieldOptions_STRING_PIECE:
+		return "VIEW"
+	default:
+		return "STRING"
+	}
+}
diff --git a/internal/core/breaking_profiles_catalog_parent_test.go b/internal/core/breaking_profiles_catalog_parent_test.go
new file mode 100644
index 00000000..56331e07
--- /dev/null
+++ b/internal/core/breaking_profiles_catalog_parent_test.go
@@ -0,0 +1,75 @@
+package core
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	disk "github.com/easyp-tech/easyp/internal/fs/fs"
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestBreakingProfilesParentCatalogDescribesActualFindings(t *testing.T) {
+	t.Parallel()
+	for _, profile := range config.BreakingProfiles() {
+		t.Run(profile.Name, func(t *testing.T) {
+			t.Parallel()
+			before, after := t.TempDir(), t.TempDir()
+			text := "syntax = \"proto3\"; package sample.v1; message Item { oneof choice { string id = 1; } } enum State { ZERO = 0; } service API { rpc Get(Item) returns(Item); }"
+			require.NoError(t, os.WriteFile(filepath.Join(before, "old.proto"), []byte(text), 0o600))
+			require.NoError(t, os.WriteFile(filepath.Join(after, "new.proto"), []byte(text), 0o600))
+			app := New(Options{Logger: logger.NewNop(), BreakingCheckConfig: BreakingCheckConfig{Categories: []string{profile.Name}}})
+			findings, err := app.CompareBreaking(t.Context(), disk.NewFSWalker(after, "."), disk.NewFSWalker(before, "."), nil)
+			require.NoError(t, err)
+			for _, issue := range findings {
+				assert.Contains(t, profile.Rules, issue.RuleName, "emitted rule missing from profile catalog")
+			}
+			require.NoError(t, os.WriteFile(filepath.Join(after, "new.proto"), []byte("syntax = \"proto3\"; package sample.v1; message Item {}"), 0o600))
+			findings, err = app.CompareBreaking(t.Context(), disk.NewFSWalker(after, "."), disk.NewFSWalker(before, "."), nil)
+			require.NoError(t, err)
+			require.NotEmpty(t, findings)
+			for _, issue := range findings {
+				assert.Contains(t, profile.Rules, issue.RuleName, "emitted rule missing from profile catalog")
+			}
+		})
+	}
+}
+
+func TestBreakingProfilesParentCatalogOwnsReturnedSlices(t *testing.T) {
+	t.Parallel()
+	before := config.BreakingProfiles()
+	modified := config.BreakingProfiles()
+	for i := range modified {
+		modified[i].Name = "modified"
+		for j := range modified[i].Rules {
+			modified[i].Rules[j] = "modified"
+		}
+	}
+	assert.Equal(t, before, config.BreakingProfiles())
+}
+
+func TestBreakingProfilesParentMovedFileOptions(t *testing.T) {
+	t.Parallel()
+	for _, profile := range []string{"FILE", "PACKAGE", "WIRE_JSON", "WIRE"} {
+		t.Run(profile, func(t *testing.T) {
+			t.Parallel()
+			before, after := t.TempDir(), t.TempDir()
+			require.NoError(t, os.WriteFile(filepath.Join(before, "old.proto"), []byte("syntax = \"proto3\"; package api.v1; option go_package = \"example.test/before\"; message Item {}"), 0o600))
+			require.NoError(t, os.WriteFile(filepath.Join(after, "new.proto"), []byte("syntax = \"proto3\"; package api.v1; option go_package = \"example.test/after\"; message Item {}"), 0o600))
+			app := New(Options{Logger: logger.NewNop(), BreakingCheckConfig: BreakingCheckConfig{Categories: []string{profile}}})
+			findings, err := app.CompareBreaking(t.Context(), disk.NewFSWalker(after, "."), disk.NewFSWalker(before, "."), nil)
+			require.NoError(t, err)
+			found := false
+			for _, issue := range findings {
+				if issue.RuleName == "FILE_SAME_GO_PACKAGE" {
+					found = true
+				}
+			}
+			assert.Equal(t, profile == "FILE" || profile == "PACKAGE", found, "moving declarations must not conceal changed generated Go package")
+		})
+	}
+}
diff --git a/internal/core/breaking_profiles_test.go b/internal/core/breaking_profiles_test.go
new file mode 100644
index 00000000..1da26818
--- /dev/null
+++ b/internal/core/breaking_profiles_test.go
@@ -0,0 +1,212 @@
+package core
+
+import (
+	"os"
+	"path/filepath"
+	"slices"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/fs/fs"
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestCompareBreakingProfiles_FieldAndWireMatrix(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name       string
+		categories []string
+		baseline   string
+		current    string
+		wantRules  []string
+	}{
+		{
+			name:       "implicit_enum_default_changes",
+			baseline:   `syntax = "proto2"; package sample.v1; enum State { ZERO = 0; ONE = 1; } message Item { optional State state = 1; }`,
+			current:    `syntax = "proto2"; package sample.v1; enum State { ONE = 1; ZERO = 0; } message Item { optional State state = 1; }`,
+			categories: []string{"WIRE"}, wantRules: []string{"FIELD_SAME_DEFAULT"},
+		},
+		{
+			name:       "implicit_enum_default_unchanged",
+			baseline:   `syntax = "proto2"; package sample.v1; enum State { ZERO = 0; ONE = 1; } message Item { optional State state = 1; }`,
+			current:    `syntax = "proto2"; package sample.v1; enum State { ZERO = 0; ONE = 1; TWO = 2; } message Item { optional State state = 1; }`,
+			categories: []string{"WIRE"},
+		},
+		{
+			name:       "field_rename_is_source_and_json_breaking",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { string before = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { string after = 1; }`,
+			categories: []string{"FILE"}, wantRules: []string{"FIELD_SAME_NAME"},
+		},
+		{
+			name:       "field_rename_is_json_breaking",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { string before = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { string after = 1; }`,
+			categories: []string{"WIRE_JSON"}, wantRules: []string{"FIELD_SAME_NAME"},
+		},
+		{
+			name:       "field_rename_is_not_binary_breaking",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { string before = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { string after = 1; }`,
+			categories: []string{"WIRE"},
+		},
+		{
+			name:       "json_name_change_is_json_breaking",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { string value = 1 [json_name = "before"]; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { string value = 1 [json_name = "after"]; }`,
+			categories: []string{"WIRE_JSON"}, wantRules: []string{"FIELD_SAME_JSON_NAME"},
+		},
+		{
+			name:       "int32_uint32_is_compatible_in_both_wire_profiles",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { int32 value = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { uint32 value = 1; }`,
+			categories: []string{"WIRE"},
+		},
+		{
+			name:       "int32_sint32_is_wire_incompatible",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { int32 value = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { sint32 value = 1; }`,
+			categories: []string{"WIRE"}, wantRules: []string{"FIELD_WIRE_COMPATIBLE_TYPE"},
+		},
+		{
+			name:       "int32_uint32_is_json_compatible",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { int32 value = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { uint32 value = 1; }`,
+			categories: []string{"WIRE_JSON"},
+		},
+		{
+			name:       "int32_sint32_is_json_incompatible",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { int32 value = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { sint32 value = 1; }`,
+			categories: []string{"WIRE_JSON"}, wantRules: []string{"FIELD_WIRE_JSON_COMPATIBLE_TYPE"},
+		},
+		{
+			name:       "string_to_bytes_is_binary_compatible",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { string value = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { bytes value = 1; }`,
+			categories: []string{"WIRE"},
+		},
+		{
+			name:       "bytes_to_string_is_binary_incompatible",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { bytes value = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { string value = 1; }`,
+			categories: []string{"WIRE"}, wantRules: []string{"FIELD_WIRE_COMPATIBLE_TYPE"},
+		},
+		{
+			name:       "implicit_explicit_optional_is_source_only",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { string value = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { optional string value = 1; }`,
+			categories: []string{"PACKAGE"}, wantRules: []string{"FIELD_SAME_CARDINALITY"},
+		},
+		{
+			name:       "implicit_explicit_optional_is_wire_compatible",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { string value = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { optional string value = 1; }`,
+			categories: []string{"WIRE"},
+		},
+		{
+			name:       "real_oneof_membership_is_binary_breaking",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { string value = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { oneof choice { string value = 1; } }`,
+			categories: []string{"WIRE"}, wantRules: []string{"FIELD_SAME_ONEOF"},
+		},
+		{
+			name:     "deleting_field_requires_number_reservation_for_wire",
+			baseline: `syntax = "proto3"; package sample.v1; message Item { string value = 1; }`,
+			current:  `syntax = "proto3"; package sample.v1; message Item {}`, categories: []string{"WIRE"},
+			wantRules: []string{"FIELD_NO_DELETE_UNLESS_NUMBER_RESERVED"},
+		},
+		{
+			name:       "wire_json_also_requires_deleted_field_name_reservation",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { string value = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { reserved 1; }`,
+			categories: []string{"WIRE_JSON"}, wantRules: []string{"FIELD_NO_DELETE_UNLESS_NAME_RESERVED"},
+		},
+		{
+			name:       "wire_json_accepts_deleted_field_when_name_and_number_are_reserved",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { string value = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { reserved 1; reserved "value"; }`,
+			categories: []string{"WIRE_JSON"},
+		},
+		{
+			name:       "wire_accepts_repeated_to_map_with_matching_value_type",
+			baseline:   `syntax = "proto3"; package sample.v1; message Entry { int32 key = 1; int32 value = 2; } message Item { repeated Entry value = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { map<int32, int32> value = 1; }`,
+			categories: []string{"WIRE"},
+		},
+		{
+			name:       "wire_json_rejects_repeated_to_map",
+			baseline:   `syntax = "proto3"; package sample.v1; message Entry { int32 key = 1; int32 value = 2; } message Item { repeated Entry value = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { map<int32, int32> value = 1; }`,
+			categories: []string{"WIRE_JSON"}, wantRules: []string{"FIELD_WIRE_JSON_COMPATIBLE_CARDINALITY"},
+		},
+		{
+			name:       "default_change_breaks_wire",
+			baseline:   `syntax = "proto2"; package sample.v1; message Item { optional int32 value = 1 [default = 2]; }`,
+			current:    `syntax = "proto2"; package sample.v1; message Item { optional int32 value = 1 [default = 3]; }`,
+			categories: []string{"WIRE"}, wantRules: []string{"FIELD_SAME_DEFAULT"},
+		},
+		{
+			name:       "new_required_field_breaks_wire",
+			baseline:   `syntax = "proto2"; package sample.v1; message Item { optional int32 value = 1; }`,
+			current:    `syntax = "proto2"; package sample.v1; message Item { optional int32 value = 1; required int32 added = 2; }`,
+			categories: []string{"WIRE"}, wantRules: []string{"MESSAGE_SAME_REQUIRED_FIELDS"},
+		},
+		{
+			name:       "package_change_is_binary_breaking",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { string value = 1; }`,
+			current:    `syntax = "proto3"; package sample.v2; message Item { string value = 1; }`,
+			categories: []string{"WIRE"}, wantRules: []string{"FILE_SAME_PACKAGE"},
+		},
+		{
+			name:       "moving_message_within_package_passes_package_profile",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { string value = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { string value = 1; }`,
+			categories: []string{"PACKAGE"},
+		},
+		{
+			name:       "file_option_change_is_source_breaking",
+			baseline:   `syntax = "proto3"; package sample.v1; option go_package = "example.com/old"; message Item { string value = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; option go_package = "example.com/new"; message Item { string value = 1; }`,
+			categories: []string{"FILE"}, wantRules: []string{"FILE_SAME_GO_PACKAGE"},
+		},
+		{
+			name:       "mixed_profiles_report_each_issue_once",
+			baseline:   `syntax = "proto3"; package sample.v1; message Item { int32 before = 1; }`,
+			current:    `syntax = "proto3"; package sample.v1; message Item { uint32 after = 1; }`,
+			categories: []string{"WIRE", "WIRE_JSON", "PACKAGE", "FILE"},
+			wantRules:  []string{"FIELD_SAME_NAME", "FIELD_SAME_TYPE"},
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			baseline := writeProfileProto(t, "baseline", tt.baseline)
+			current := writeProfileProto(t, "current", tt.current)
+			app := New(Options{Logger: logger.NewNop(), BreakingCheckConfig: BreakingCheckConfig{Categories: tt.categories}})
+
+			issues, err := app.CompareBreaking(t.Context(), fs.NewFSWalker(current, "."), fs.NewFSWalker(baseline, "."), nil)
+
+			require.NoError(t, err)
+			gotRules := make([]string, len(issues))
+			for i, issue := range issues {
+				gotRules[i] = issue.RuleName
+				require.NotEmpty(t, issue.Path)
+				require.Positive(t, issue.Position.Line)
+			}
+			require.ElementsMatch(t, tt.wantRules, gotRules, "%+v", issues)
+			require.Len(t, gotRules, len(slices.Compact(slices.Clone(gotRules))), "duplicate diagnostics: %+v", issues)
+		})
+	}
+}
+
+func writeProfileProto(t *testing.T, name, contents string) string {
+	t.Helper()
+	root := filepath.Join(t.TempDir(), name)
+	require.NoError(t, os.MkdirAll(root, 0o755))
+	require.NoError(t, os.WriteFile(filepath.Join(root, "schema.proto"), []byte(contents), 0o600))
+	return root
+}
diff --git a/internal/core/breaking_target_paths_test.go b/internal/core/breaking_target_paths_test.go
new file mode 100644
index 00000000..ad887a4c
--- /dev/null
+++ b/internal/core/breaking_target_paths_test.go
@@ -0,0 +1,31 @@
+package core
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"github.com/yoheimuta/go-protoparser/v4/interpret/unordered"
+)
+
+func TestBreakingTargetPathsTakePrecedenceOverImportAliases(t *testing.T) {
+	t.Parallel()
+	item, err := readProtoFile(strings.NewReader("syntax = \"proto3\"; package demo; message Item {}"))
+	require.NoError(t, err)
+	use, err := readProtoFile(strings.NewReader("syntax = \"proto3\"; package demo; import \"item.proto\"; message Use { Item item = 1; }"))
+	require.NoError(t, err)
+	own := ProtoInfo{Path: "module/proto/item.proto", Info: item}
+	importer := ProtoInfo{Path: "module/proto/use.proto", Info: use, ProtoFilesFromImport: map[ImportPath]*unordered.Proto{"item.proto": item}}
+	for _, tt := range []struct {
+		name  string
+		files []ProtoInfo
+	}{{"target first", []ProtoInfo{own, importer}}, {"target last", []ProtoInfo{importer, own}}} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			data, err := collect(tt.files)
+			require.NoError(t, err)
+			assert.Equal(t, "module/proto/item.proto", data[PackageName("demo")].Messages["Item"].ProtoFilePath)
+		})
+	}
+}
diff --git a/internal/core/check_lint_ignore.go b/internal/core/check_lint_ignore.go
deleted file mode 100644
index 9a8bc959..00000000
--- a/internal/core/check_lint_ignore.go
+++ /dev/null
@@ -1 +0,0 @@
-package core
diff --git a/internal/core/comment_suppressions.go b/internal/core/comment_suppressions.go
new file mode 100644
index 00000000..c9b40a7b
--- /dev/null
+++ b/internal/core/comment_suppressions.go
@@ -0,0 +1,228 @@
+package core
+
+import (
+	"fmt"
+	"reflect"
+	"slices"
+	"strings"
+
+	"github.com/yoheimuta/go-protoparser/v4/parser"
+	"github.com/yoheimuta/go-protoparser/v4/parser/meta"
+)
+
+type suppressionRange struct {
+	rule        string
+	first, last int
+}
+type suppressionRanges []suppressionRange
+
+func (ranges suppressionRanges) contains(rule string, line int) bool {
+	for _, r := range ranges {
+		if r.rule == rule && line >= r.first && line <= r.last {
+			return true
+		}
+	}
+	return false
+}
+
+type directiveComment struct {
+	comment     *parser.Comment
+	first, last int
+}
+
+type parsedDirective struct {
+	action  string
+	rules   []string
+	comment directiveComment
+}
+
+// commentSuppressions uses parser comments, not textual substring matching, so
+// marker-like text inside strings is never interpreted as a directive.
+func (c *Core) commentSuppressions(info ProtoInfo) (suppressionRanges, error) {
+	comments := collectDirectiveComments(info.Info)
+	known := make(map[string]bool)
+	for _, name := range c.knownLintRules {
+		known[name] = true
+	}
+	if len(known) == 0 {
+		for _, rule := range c.rules {
+			known[GetRuleName(rule)] = true
+		}
+	}
+	var parsed []parsedDirective
+	for _, comment := range comments {
+		for _, text := range comment.comment.Lines() {
+			text = strings.TrimSpace(strings.TrimPrefix(strings.TrimSpace(text), "*"))
+			action, rest, recognized := parseDirectivePrefix(text)
+			if !recognized {
+				continue
+			}
+			names := strings.FieldsFunc(rest, func(r rune) bool { return r == ',' || r == ' ' || r == '\t' })
+			if action == "" || len(names) == 0 {
+				return nil, fmt.Errorf("%s:%d:%d: malformed lint directive %q", info.Path, comment.comment.Meta.Pos.Line, comment.comment.Meta.Pos.Column, text)
+			}
+			names = compactDirectiveNames(names)
+			for _, name := range names {
+				if !known[name] {
+					return nil, fmt.Errorf("%s:%d:%d: unknown or unsupported lint rule %q in comment directive", info.Path, comment.comment.Meta.Pos.Line, comment.comment.Meta.Pos.Column, name)
+				}
+			}
+			parsed = append(parsed, parsedDirective{action: action, rules: names, comment: comment})
+		}
+	}
+	var ranges suppressionRanges
+	pending := make(map[string][]int)
+	paired := make(map[string]bool)
+	for index, directive := range parsed {
+		if directive.action == "legacy" {
+			continue
+		}
+		for _, name := range directive.rules {
+			if directive.action == "disable" {
+				pending[name] = append(pending[name], index)
+				continue
+			}
+			stack := pending[name]
+			if len(stack) == 0 {
+				return nil, fmt.Errorf("%s:%d: easyp:enable %s has no preceding disable", info.Path, directive.comment.comment.Meta.Pos.Line, name)
+			}
+			begin := stack[len(stack)-1]
+			pending[name] = stack[:len(stack)-1]
+			start := parsed[begin].comment.comment.Meta.Pos.Line
+			ranges = append(ranges, suppressionRange{name, start, directive.comment.comment.Meta.Pos.Line - 1})
+			paired[fmt.Sprintf("%d:%s", begin, name)] = true
+		}
+	}
+	for index, directive := range parsed {
+		if directive.action == "enable" {
+			continue
+		}
+		for _, name := range directive.rules {
+			if paired[fmt.Sprintf("%d:%s", index, name)] {
+				continue
+			}
+			if directive.comment.first <= 0 {
+				return nil, fmt.Errorf("%s:%d: suppression %s must annotate a declaration or have a matching easyp:enable", info.Path, directive.comment.comment.Meta.Pos.Line, name)
+			}
+			ranges = append(ranges, suppressionRange{name, directive.comment.first, directive.comment.last})
+		}
+	}
+	return ranges, nil
+}
+
+func compactDirectiveNames(names []string) []string {
+	var result []string
+	for _, name := range names {
+		if !slices.Contains(result, name) {
+			result = append(result, name)
+		}
+	}
+	return result
+}
+
+func parseDirectivePrefix(text string) (string, string, bool) {
+	for _, prefix := range []struct{ text, action string }{{"easyp:disable", "disable"}, {"easyp:enable", "enable"}, {"nolint:", "legacy"}, {"buf:lint:ignore", "legacy"}} {
+		if !strings.HasPrefix(text, prefix.text) {
+			continue
+		}
+		rest := strings.TrimPrefix(text, prefix.text)
+		if !strings.HasSuffix(prefix.text, ":") && rest != "" && rest[0] != ' ' && rest[0] != '\t' {
+			return "", "", true
+		}
+		rest, _, _ = strings.Cut(rest, " -- ")
+		rest, _, _ = strings.Cut(rest, " // ")
+		return prefix.action, strings.TrimSpace(rest), true
+	}
+	if strings.HasPrefix(text, "easyp:") {
+		return "", "", true
+	}
+	return "", "", false
+}
+
+// collectDirectiveComments reads declaration metadata generically across the
+// parser's ordered and unordered node types, including inline comments.
+func collectDirectiveComments(root any) []directiveComment {
+	found := make(map[*parser.Comment]directiveComment)
+	seen := make(map[uintptr]bool)
+	var visit func(reflect.Value)
+	visit = func(value reflect.Value) {
+		if !value.IsValid() {
+			return
+		}
+		if value.Kind() == reflect.Interface {
+			if !value.IsNil() {
+				visit(value.Elem())
+			}
+			return
+		}
+		if value.Kind() == reflect.Pointer {
+			if value.IsNil() {
+				return
+			}
+			if comment, ok := value.Interface().(*parser.Comment); ok {
+				if _, exists := found[comment]; !exists {
+					found[comment] = directiveComment{comment: comment}
+				}
+				return
+			}
+			pointer := value.Pointer()
+			if seen[pointer] {
+				return
+			}
+			seen[pointer] = true
+			visit(value.Elem())
+			return
+		}
+		switch value.Kind() {
+		case reflect.Struct:
+			var location meta.Meta
+			field := value.FieldByName("Meta")
+			if field.IsValid() && field.CanInterface() {
+				location, _ = field.Interface().(meta.Meta)
+			}
+			if location.Pos.Line > 0 {
+				last := max(location.Pos.Line, location.LastPos.Line)
+				for _, name := range []string{"Comments", "InlineComment", "InlineCommentBehindLeftCurly"} {
+					field := value.FieldByName(name)
+					if !field.IsValid() || !field.CanInterface() {
+						continue
+					}
+					var attached []*parser.Comment
+					switch comments := field.Interface().(type) {
+					case []*parser.Comment:
+						attached = comments
+					case *parser.Comment:
+						if comments != nil {
+							attached = []*parser.Comment{comments}
+						}
+					}
+					for _, comment := range attached {
+						found[comment] = directiveComment{comment, location.Pos.Line, last}
+					}
+				}
+			}
+			for i := 0; i < value.NumField(); i++ {
+				field := value.Field(i)
+				if field.CanInterface() {
+					visit(field)
+				}
+			}
+		case reflect.Slice, reflect.Array:
+			for i := 0; i < value.Len(); i++ {
+				visit(value.Index(i))
+			}
+		}
+	}
+	visit(reflect.ValueOf(root))
+	result := make([]directiveComment, 0, len(found))
+	for _, comment := range found {
+		result = append(result, comment)
+	}
+	slices.SortFunc(result, func(a, b directiveComment) int {
+		if a.comment.Meta.Pos.Line != b.comment.Meta.Pos.Line {
+			return a.comment.Meta.Pos.Line - b.comment.Meta.Pos.Line
+		}
+		return a.comment.Meta.Pos.Column - b.comment.Meta.Pos.Column
+	})
+	return result
+}
diff --git a/internal/core/comment_suppressions_test.go b/internal/core/comment_suppressions_test.go
new file mode 100644
index 00000000..338ee64a
--- /dev/null
+++ b/internal/core/comment_suppressions_test.go
@@ -0,0 +1,44 @@
+package core_test
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/core"
+	disk "github.com/easyp-tech/easyp/internal/fs/fs"
+	"github.com/easyp-tech/easyp/internal/logger"
+	"github.com/easyp-tech/easyp/internal/rules"
+)
+
+func TestCommentSuppressionPoliciesAreIndependent(t *testing.T) {
+	t.Parallel()
+	for _, tc := range []struct {
+		name  string
+		allow bool
+		want  int
+	}{{"enabled", true, 1}, {"disabled", false, 2}} {
+		t.Run(tc.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			raw := "syntax = \"proto3\"; package example;\n// easyp:disable MESSAGE_PASCAL_CASE\nmessage ignored_name {}\nmessage visible_name {}\n"
+			require.NoError(t, os.WriteFile(filepath.Join(root, "test.proto"), []byte(raw), 0o644))
+			app := core.New(core.Options{Logger: logger.NewNop(), Rules: []core.Rule{&rules.MessagePascalCase{}}, AllowCommentIgnores: tc.allow, KnownLintRules: rules.AllRuleNames()})
+			got, err := app.Lint(t.Context(), disk.NewFSWalker(root, "test.proto"))
+			require.NoError(t, err)
+			require.Len(t, got, tc.want)
+		})
+	}
+}
+
+func TestCommentDirectiveNamesAreExact(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	raw := "syntax = \"proto3\"; package example;\n// nolint:MESSAGE_PASCAL_CASE_typo\nmessage ignored_name {}\n"
+	require.NoError(t, os.WriteFile(filepath.Join(root, "test.proto"), []byte(raw), 0o644))
+	app := core.New(core.Options{Logger: logger.NewNop(), Rules: []core.Rule{&rules.MessagePascalCase{}}, AllowCommentIgnores: true, KnownLintRules: rules.AllRuleNames()})
+	_, err := app.Lint(t.Context(), disk.NewFSWalker(root, "test.proto"))
+	require.ErrorContains(t, err, "MESSAGE_PASCAL_CASE_typo")
+}
diff --git a/internal/core/core.go b/internal/core/core.go
index 677e1908..10ab85ec 100644
--- a/internal/core/core.go
+++ b/internal/core/core.go
@@ -3,6 +3,8 @@ package core
 
 import (
 	"errors"
+	"maps"
+	"slices"
 
 	"github.com/easyp-tech/easyp/internal/adapters/console"
 	"github.com/easyp-tech/easyp/internal/adapters/plugin"
@@ -11,19 +13,20 @@ import (
 
 // Core provide to business logic of EasyP.
 type Core struct {
-	rules        []Rule
-	ignore       []string
-	deps         []string
-	ignoreOnly   map[string][]string
-	logger       logger.Logger
-	plugins      []Plugin
-	inputs       Inputs
-	console      console.Console
-	storage      Storage
-	moduleConfig ModuleConfig
-	lockFile     LockFile
-	managedMode  ManagedModeConfig
-	vendorDir    string
+	rules                 []Rule
+	ignore                []string
+	ignoreOnly            map[string][]string
+	allowCommentIgnores   bool
+	knownLintRules        []string
+	logger                logger.Logger
+	plugins               []Plugin
+	pluginWorkDir         string
+	inputs                Inputs
+	importRoots           []string
+	importFileAllowed     func(string) bool
+	fileModules           map[string]string
+	managedMode           ManagedModeConfig
+	goPackageOutputPrefix string
 
 	breakingCheckConfig     BreakingCheckConfig
 	currentProjectGitWalker CurrentProjectGitWalker
@@ -40,42 +43,53 @@ var (
 	ErrEmptyInputFiles        = errors.New("empty input files")
 )
 
-func New(
-	rules []Rule,
-	ignore []string,
-	deps []string,
-	ignoreOnly map[string][]string,
-	logger logger.Logger,
-	plugins []Plugin,
-	inputs Inputs,
-	console console.Console,
-	storage Storage,
-	moduleConfig ModuleConfig,
-	lockFile LockFile,
-	currentProjectGitWalker CurrentProjectGitWalker,
-	breakingCheckConfig BreakingCheckConfig,
-	managedMode ManagedModeConfig,
-	vendorDir string,
-) *Core {
+// Options configures the lint, breaking, and generation engines.
+type Options struct {
+	Rules               []Rule
+	Ignore              []string
+	IgnoreOnly          map[string][]string
+	AllowCommentIgnores bool
+	KnownLintRules      []string
+	Logger              logger.Logger
+	Plugins             []Plugin
+	PluginWorkDir       string
+	Inputs              Inputs
+	ImportRoots         []string
+	// ImportFileAllowed restricts physical imports and module inputs to the
+	// files selected by dependency metadata. Nil permits every file.
+	ImportFileAllowed       func(string) bool
+	FileModules             map[string]string
+	CurrentProjectGitWalker CurrentProjectGitWalker
+	BreakingCheckConfig     BreakingCheckConfig
+	ManagedModeConfig       ManagedModeConfig
+	// GoPackageOutputPrefix places source-relative Go output under its effective
+	// go_package, relative to this import prefix. Path markers use their stable parent.
+	GoPackageOutputPrefix string
+}
+
+// New creates a Core with the configured engines.
+func New(options Options) *Core {
+	terminal := console.New()
 	return &Core{
-		rules:                   rules,
-		ignore:                  ignore,
-		deps:                    deps,
-		ignoreOnly:              ignoreOnly,
-		logger:                  logger,
-		plugins:                 plugins,
-		inputs:                  inputs,
-		console:                 console,
-		storage:                 storage,
-		moduleConfig:            moduleConfig,
-		lockFile:                lockFile,
-		currentProjectGitWalker: currentProjectGitWalker,
-		breakingCheckConfig:     breakingCheckConfig,
-		managedMode:             managedMode,
-		localExecutor:           plugin.NewLocalPluginExecutor(console, logger),
-		remoteExecutor:          plugin.NewRemotePluginExecutor(logger),
-		builtinExecutor:         plugin.NewBuiltinPluginExecutor(logger),
-		commandExecutor:         plugin.NewCommandPluginExecutor(console, logger),
-		vendorDir:               vendorDir,
+		rules:                   options.Rules,
+		ignore:                  options.Ignore,
+		ignoreOnly:              options.IgnoreOnly,
+		allowCommentIgnores:     options.AllowCommentIgnores,
+		knownLintRules:          slices.Clone(options.KnownLintRules),
+		logger:                  options.Logger,
+		plugins:                 options.Plugins,
+		pluginWorkDir:           options.PluginWorkDir,
+		inputs:                  options.Inputs,
+		importRoots:             slices.Clone(options.ImportRoots),
+		importFileAllowed:       options.ImportFileAllowed,
+		fileModules:             maps.Clone(options.FileModules),
+		currentProjectGitWalker: options.CurrentProjectGitWalker,
+		breakingCheckConfig:     options.BreakingCheckConfig,
+		managedMode:             options.ManagedModeConfig,
+		goPackageOutputPrefix:   options.GoPackageOutputPrefix,
+		localExecutor:           plugin.NewLocalPluginExecutor(options.Logger),
+		remoteExecutor:          plugin.NewRemotePluginExecutor(options.Logger),
+		builtinExecutor:         plugin.NewBuiltinPluginExecutor(options.Logger),
+		commandExecutor:         plugin.NewCommandPluginExecutor(terminal, options.Logger),
 	}
 }
diff --git a/internal/core/dom.go b/internal/core/dom.go
index 2f3531fc..a9f11d8d 100644
--- a/internal/core/dom.go
+++ b/internal/core/dom.go
@@ -1,7 +1,6 @@
 package core
 
 import (
-	"context"
 	"fmt"
 	"reflect"
 	"strings"
@@ -10,8 +9,6 @@ import (
 	"github.com/yoheimuta/go-protoparser/v4/interpret/unordered"
 	"github.com/yoheimuta/go-protoparser/v4/parser"
 	"github.com/yoheimuta/go-protoparser/v4/parser/meta"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
 )
 
 type (
@@ -50,7 +47,9 @@ type (
 
 	// ProtoInfo is the information of a proto file.
 	ProtoInfo struct {
-		Path                 string
+		Path string
+		// ImportPath is relative to a declared source root, independently of the scan root.
+		ImportPath           string
 		Info                 *unordered.Proto
 		ProtoFilesFromImport map[ImportPath]*unordered.Proto
 	}
@@ -106,26 +105,6 @@ type (
 	ProtoData map[PackageName]*Collection
 )
 
-type Repo interface {
-	// GetFiles returns list of all files in repository
-	GetFiles(ctx context.Context, revision models.Revision, dirs ...string) ([]string, error)
-
-	// ReadFile returns file's content from repository
-	ReadFile(ctx context.Context, revision models.Revision, fileName string) (string, error)
-
-	// Archive passed storage to archive and return full path to archive
-	Archive(
-		ctx context.Context, revision models.Revision, cacheDownloadPaths models.CacheDownloadPaths,
-	) error
-
-	// ReadRevision reads commit's revision by passed version
-	// or return the latest commit if version is empty
-	ReadRevision(ctx context.Context, requestedVersion models.RequestedVersion) (models.Revision, error)
-
-	// Fetch from remote repository specified version
-	Fetch(ctx context.Context, revision models.Revision) error
-}
-
 func GetPackageName(protoFile *unordered.Proto) PackageName {
 	if len(protoFile.ProtoBody.Packages) == 0 {
 		return ""
@@ -134,15 +113,10 @@ func GetPackageName(protoFile *unordered.Proto) PackageName {
 	return PackageName(protoFile.ProtoBody.Packages[0].Name)
 }
 
-// AppendIssue check if lint error is ignored -> add new error to slice
-// otherwise ignore appending
+// AppendIssue records a rule finding. The lint engine applies per-file suppressions.
 func AppendIssue(
 	issues []Issue, lintRule Rule, pos meta.Position, sourceName string, comments []*parser.Comment,
 ) []Issue {
-	if CheckIsIgnored(comments, GetRuleName(lintRule)) {
-		return issues
-	}
-
 	return append(issues, buildError(lintRule, pos, sourceName))
 }
 
@@ -215,12 +189,6 @@ type (
 		Options     map[string][]string
 		WithImports bool
 	}
-	// InputGitRepo is the configuration of the git repository.
-	InputGitRepo struct {
-		URL          string
-		SubDirectory string
-		Root         string
-	}
 	// InputFilesDir is the configuration of the directory with additional functionality.
 	InputFilesDir struct {
 		Path string
@@ -229,18 +197,5 @@ type (
 	// Inputs is the source for generating code.
 	Inputs struct {
 		InputFilesDir []InputFilesDir
-		InputGitRepos []InputGitRepo
-	}
-	// Config is the configuration for EasyP generate.
-	Config struct {
-		Deps    []string
-		Plugins []Plugin
-		Inputs  Inputs
-	}
-	// Query is a query for making sh command.
-	Query struct {
-		Imports []string
-		Plugins []Plugin
-		Files   []string
 	}
 )
diff --git a/internal/core/download.go b/internal/core/download.go
deleted file mode 100644
index 306a8400..00000000
--- a/internal/core/download.go
+++ /dev/null
@@ -1,59 +0,0 @@
-package core
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"log/slog"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-// Download all packages from config
-// dependencies slice of strings format: origin@version: github.com/company/repository@v1.2.3
-// if version is absent use the latest commit
-func (c *Core) Download(ctx context.Context) error {
-	if c.lockFile.IsEmpty() {
-		// if lock file is empty or doesn't exist install versions
-		// from easyp.yaml config and create lock file
-		c.logger.Debug(ctx, "Lock file is empty")
-		return c.Update(ctx)
-	}
-
-	c.logger.Debug(ctx, "Lock file is not empty. Install deps from it")
-
-	// install from lock file at first
-	for lockFileInfo := range c.lockFile.DepsIter() {
-		module := models.NewModuleFromLockFileInfo(lockFileInfo)
-		log := c.logger.With(slog.String("module", module.Name), slog.String("version", string(module.Version)))
-
-		log.Debug(ctx, "downloading module from lockfile")
-		if err := c.Get(ctx, module); err != nil {
-			return fmt.Errorf("c.Get: %w", err)
-		}
-	}
-
-	c.logger.Debug(ctx, "installing remaining dependencies not in lock file")
-
-	// install from remote generator sections
-	for _, dependency := range c.deps {
-		module := models.NewModule(dependency)
-		log := c.logger.With(slog.String("module", module.Name), slog.String("version", string(module.Version)))
-
-		_, err := c.lockFile.Read(module.Name)
-		if err == nil {
-			log.Debug(ctx, "already in lock file")
-			continue
-		}
-		if !errors.Is(err, models.ErrModuleNotFoundInLockFile) {
-			return fmt.Errorf("c.lockFile.Read: %w", err)
-		}
-
-		log.Debug(ctx, "downloading module from deps")
-		if err := c.Get(ctx, module); err != nil {
-			return fmt.Errorf("c.Get: %w", err)
-		}
-	}
-
-	return nil
-}
diff --git a/internal/core/generate.go b/internal/core/generate.go
index 941568ac..fb976f73 100644
--- a/internal/core/generate.go
+++ b/internal/core/generate.go
@@ -4,15 +4,17 @@ import (
 	"bytes"
 	"context"
 	"fmt"
+	stdfs "io/fs"
 	"log/slog"
+	"maps"
 	"os"
 	"os/exec"
 	"path/filepath"
-	"regexp"
 	"slices"
 	"strings"
 
 	"github.com/bufbuild/protocompile"
+	"github.com/bufbuild/protocompile/linker"
 	"github.com/bufbuild/protocompile/protoutil"
 	"github.com/bufbuild/protocompile/wellknownimports"
 	"google.golang.org/protobuf/proto"
@@ -21,90 +23,70 @@ import (
 	"google.golang.org/protobuf/types/pluginpb"
 
 	pluginexecutor "github.com/easyp-tech/easyp/internal/adapters/plugin"
-	"github.com/easyp-tech/easyp/internal/core/models"
+	"github.com/easyp-tech/easyp/internal/core/path_helpers"
 	"github.com/easyp-tech/easyp/internal/fs/fs"
 	"github.com/easyp-tech/easyp/internal/version"
 )
 
-// Generate generates files.
-func (c *Core) Generate(ctx context.Context, root, directory, descriptorSetOut string, includeImports bool) error {
-	c.logger.Info(ctx, "starting code generation", slog.String("directory", directory))
-
-	if err := c.Download(ctx); err != nil {
-		return fmt.Errorf("c.Download: %w", err)
-	}
+// GenerationPlan holds a compiled graph with managed options already applied.
+// Preparing a plan does not execute plugins or write generated output.
+type GenerationPlan struct {
+	core            *Core
+	root            string
+	files           []string
+	descriptors     []*descriptorpb.FileDescriptorProto
+	dependencyFiles []string
+}
 
-	// TODO: call download before
-	q := Query{
-		Imports: []string{},
-		Plugins: c.plugins,
+// Generate prepares a module, optionally exports its descriptors, and runs plugins.
+func (c *Core) Generate(ctx context.Context, root, descriptorSetOut string, includeImports bool) error {
+	plan, err := c.PrepareGeneration(ctx, root)
+	if err != nil {
+		return fmt.Errorf("PrepareGeneration: %w", err)
 	}
-
-	for lockFileInfo := range c.lockFile.DepsIter() {
-		modulePath, err := c.modulePath(models.NewModule(lockFileInfo.Name))
+	if descriptorSetOut != "" {
+		data, err := proto.MarshalOptions{Deterministic: true}.Marshal(plan.DescriptorSet(includeImports))
 		if err != nil {
-			return fmt.Errorf("modulePath: %w", err)
+			return fmt.Errorf("Marshal: %w", err)
 		}
-
-		q.Imports = append(q.Imports, modulePath)
-	}
-
-	for _, repo := range c.inputs.InputGitRepos {
-		gitGenerateCb := func(modulePaths string) func(path string, err error) error {
-			return func(path string, err error) error {
-				switch {
-				case err != nil:
-					return err
-				case ctx.Err() != nil:
-					return ctx.Err()
-				case filepath.Ext(path) != ".proto":
-					return nil
-				}
-
-				addedFile := stripPrefix(path, repo.Root)
-
-				q.Files = append(q.Files, addedFile)
-				if !slices.Contains(q.Imports, modulePaths) {
-					q.Imports = append(q.Imports, modulePaths)
-				}
-				if repo.Root != "" {
-					q.Imports = append(q.Imports, filepath.Join(modulePaths, repo.Root))
-				}
-
-				return nil
-			}
+		if err := os.WriteFile(descriptorSetOut, data, 0o644); err != nil {
+			return fmt.Errorf("WriteFile: %w", err)
 		}
+	}
+	return plan.Execute(ctx)
+}
 
-		module := models.NewModule(repo.URL)
+// PrepareGeneration compiles and transforms a module without invoking plugins.
+func (c *Core) PrepareGeneration(ctx context.Context, root string) (*GenerationPlan, error) {
+	return c.prepareGeneration(ctx, root, nil)
+}
 
-		modulePaths, err := c.modulePath(module)
-		if err != nil {
-			return fmt.Errorf("modulePath: %w", err)
-		}
+// PrepareGenerationFiles compiles only explicitly selected module source files
+// and their complete import closure. Names are relative to module import roots.
+// An empty selection is not the same as an implicit all-files selection.
+func (c *Core) PrepareGenerationFiles(ctx context.Context, root string, files []string) (*GenerationPlan, error) {
+	if len(files) == 0 {
+		return nil, ErrEmptyInputFiles
+	}
+	return c.prepareGeneration(ctx, root, files)
+}
 
-		fsWalker := fs.NewFSWalker(modulePaths, repo.SubDirectory)
-		err = fsWalker.WalkDir(gitGenerateCb(modulePaths))
-		if err != nil {
-			return fmt.Errorf("fsWalker.WalkDir: %w", err)
-		}
+func (c *Core) prepareGeneration(ctx context.Context, root string, selected []string) (*GenerationPlan, error) {
+	c.logger.Info(ctx, "preparing code generation", slog.String("root", root))
+	imports := append([]string{}, c.importRoots...)
+	var files []string
+	selection := make(map[string]bool, len(selected))
+	for _, name := range selected {
+		selection[name] = true
 	}
+	found := make(map[string]bool)
 
 	for _, inputFilesDir := range c.inputs.InputFilesDir {
 		searchPath := filepath.Join(inputFilesDir.Root, inputFilesDir.Path)
-		// Skip if inputFilesDir.Root and directory don't overlap
-		if directory != "." && !pathsOverlap(directory, searchPath) {
-			c.logger.Debug(ctx, "skipping inputFilesDir",
-				slog.String("directory", directory),
-				slog.String("searchPath", searchPath),
-				slog.String("reason", "paths don't overlap"),
-			)
-			continue
-		}
-
 		fsWalker := fs.NewFSWalker(root, searchPath)
 		importRoot := filepath.Join(root, inputFilesDir.Root)
-		if !slices.Contains(q.Imports, importRoot) {
-			q.Imports = append(q.Imports, importRoot)
+		if !slices.Contains(imports, importRoot) {
+			imports = append(imports, importRoot)
 		}
 
 		err := fsWalker.WalkDir(func(walkPath string, err error) error {
@@ -113,166 +95,116 @@ func (c *Core) Generate(ctx context.Context, root, directory, descriptorSetOut s
 				return err
 			case ctx.Err() != nil:
 				return ctx.Err()
+			case path_helpers.ShouldSkipV1SourceDir(importRoot, filepath.Join(root, walkPath)):
+				return stdfs.SkipDir
 			case filepath.Ext(walkPath) != ".proto":
 				return nil
-			case c.shouldIgnoreGenerate(ctx, walkPath, []string{directory}):
-				c.logger.Debug(ctx, "ignore", slog.String("walkPath", walkPath), slog.String("directory", directory))
+			}
+			if c.importFileAllowed != nil && !c.importFileAllowed(filepath.Join(root, walkPath)) {
 				return nil
 			}
 
 			// Convert to relative path matching proto import format
 			addedFile := stripPrefix(walkPath, inputFilesDir.Root)
-			q.Files = append(q.Files, addedFile)
+			if selected != nil && !selection[addedFile] {
+				return nil
+			}
+			if !found[addedFile] {
+				files = append(files, addedFile)
+				found[addedFile] = true
+			}
 
 			return nil
 		})
 		if err != nil {
-			return fmt.Errorf("fsWalker.WalkDir: %w", err)
+			return nil, fmt.Errorf("WalkDir: %w", err)
 		}
 	}
 
-	c.logger.Debug(ctx, "resolved imports and files", slog.Any("imports", q.Imports), slog.Any("files", q.Files))
+	for _, name := range selected {
+		if !found[name] {
+			return nil, fmt.Errorf("selected source %q is outside the module inputs", name)
+		}
+	}
+	c.logger.Debug(ctx, "resolved imports and files", slog.Any("imports", imports), slog.Any("files", files))
 
-	if len(q.Files) == 0 {
-		return ErrEmptyInputFiles
+	if len(files) == 0 {
+		return nil, ErrEmptyInputFiles
 	}
 
-	slices.Reverse(q.Imports) // local first, dependencies last
+	// Search local roots before dependency roots.
+	slices.Reverse(imports)
 
 	compiler := protocompile.Compiler{
-		Resolver: protocompile.CompositeResolver{
-			wellknownimports.WithStandardImports(
-				&protocompile.SourceResolver{
-					ImportPaths: q.Imports,
-				},
-			),
-		},
+		Resolver:       wellknownimports.WithStandardImports(&protocompile.SourceResolver{ImportPaths: imports, Accessor: c.openSourceFile}),
 		SourceInfoMode: protocompile.SourceInfoStandard,
 	}
 
-	res, err := compiler.Compile(ctx, q.Files...)
+	compiled, err := compiler.Compile(ctx, files...)
 	if err != nil {
-		return fmt.Errorf("compiler.Compile: %w", err)
-	}
-
-	// Use slice to preserve correct order
-	var fileDescriptors []*descriptorpb.FileDescriptorProto
-	processedFiles := make(map[string]bool)
-	dependencyFiles := make([]string, 0)
-
-	// Recursive function to add file and its dependencies in correct order
-	var addFileWithDeps func(protoreflect.FileDescriptor) error
-	addFileWithDeps = func(file protoreflect.FileDescriptor) error {
-		fileName := file.Path()
-		// If already processed - skip
-		if processedFiles[fileName] {
-			return nil
-		}
-
-		// IMPORTANT: first recursively add all dependencies
-		for i := range file.Imports().Len() {
-			dep := file.Imports().Get(i)
-
-			if err := addFileWithDeps(dep); err != nil {
-				// Ignore errors for optional dependencies
-				c.logger.Warn(ctx, "could not compile dependency",
-					slog.String("dependency", dep.Path()),
-					slog.Any("error", err))
-			}
-		}
-
-		descriptor := protoutil.ProtoFromFileDescriptor(file)
-
-		// Only after dependencies add the file itself (if not already added)
-		if !processedFiles[fileName] {
-			fileDescriptors = append(fileDescriptors, descriptor)
-			processedFiles[fileName] = true
-			dependencyFiles = append(dependencyFiles, fileName)
-		}
-
-		return nil
+		return nil, fmt.Errorf("Compile: %w", err)
 	}
 
-	// Process all files and their dependencies
-	for _, file := range res {
-		reflectFd := file.(protoreflect.FileDescriptor)
-		descriptor := protoutil.ProtoFromFileDescriptor(file)
+	fileDescriptors, dependencyFiles := collectFileDescriptors(compiled)
 
-		// First add all dependencies of this file
-		for i := range reflectFd.Imports().Len() {
-			dep := reflectFd.Imports().Get(i)
-
-			if err := addFileWithDeps(dep); err != nil {
-				c.logger.Warn(ctx, "could not compile dependency",
-					slog.String("dependency", dep.Path()),
-					slog.Any("error", err))
-			}
-		}
-
-		// Then add the file itself (if not already added)
-		fileName := descriptor.GetName()
-		if !processedFiles[fileName] {
-			fileDescriptors = append(fileDescriptors, descriptor)
-			processedFiles[fileName] = true
-		}
-	}
-
-	// Log file order for debugging
 	fileNames := make([]string, len(fileDescriptors))
 	for i, fd := range fileDescriptors {
 		fileNames[i] = fd.GetName()
 	}
 	c.logger.Debug(ctx, "resolved file descriptor order", slog.Int("file_count", len(fileDescriptors)), slog.Any("files", fileNames))
 
-	// Build file to module mapping for managed mode
-	fileToModule := c.buildFileToModuleMap(ctx, q.Files)
-
-	// Apply managed mode to file descriptors
-	if c.managedMode.Enabled {
+	if c.managedMode.Enabled || c.managedMode.GoPackageOnly {
 		c.logger.Debug(ctx, "applying managed mode to file descriptors")
+		fileToModule := c.buildFileToModuleMap(files)
 		if err := ApplyManagedMode(fileDescriptors, c.managedMode, fileToModule); err != nil {
-			return fmt.Errorf("ApplyManagedMode: %w", err)
+			return nil, fmt.Errorf("ApplyManagedMode: %w", err)
 		}
 	}
 
-	if descriptorSetOut != "" {
-		var descriptorsToSave []*descriptorpb.FileDescriptorProto
-		if includeImports {
-			descriptorsToSave = fileDescriptors
-		} else {
-			// Filter out imports, keep only target files
-			targetFiles := make(map[string]bool)
-			for _, f := range q.Files {
-				targetFiles[f] = true
-			}
-			for _, fd := range fileDescriptors {
-				if targetFiles[fd.GetName()] {
-					descriptorsToSave = append(descriptorsToSave, fd)
-				}
-			}
-		}
+	return &GenerationPlan{core: c, root: root, files: files,
+		descriptors: fileDescriptors, dependencyFiles: dependencyFiles}, nil
+}
 
-		descriptorSet := &descriptorpb.FileDescriptorSet{
-			File: descriptorsToSave,
+// DescriptorSet returns an independent copy of the prepared descriptors.
+func (p *GenerationPlan) DescriptorSet(includeImports bool) *descriptorpb.FileDescriptorSet {
+	set := &descriptorpb.FileDescriptorSet{}
+	targets := make(map[string]bool, len(p.files))
+	if !includeImports {
+		for _, file := range p.files {
+			targets[file] = true
 		}
-
-		data, err := proto.MarshalOptions{Deterministic: true}.Marshal(descriptorSet)
-		if err != nil {
-			return fmt.Errorf("proto.Marshal: %w", err)
+	}
+	for _, file := range p.descriptors {
+		if includeImports || targets[file.GetName()] {
+			set.File = append(set.File, proto.Clone(file).(*descriptorpb.FileDescriptorProto))
 		}
+	}
+	return set
+}
 
-		if err := os.WriteFile(descriptorSetOut, data, 0644); err != nil {
-			return fmt.Errorf("os.WriteFile: %w", err)
-		}
+// Execute invokes plugins using the prepared graph, without compiling it again.
+func (p *GenerationPlan) Execute(ctx context.Context) error {
+	bucket := NewGenerateBucket()
+	if err := p.ExecuteInto(ctx, bucket); err != nil {
+		return err
 	}
+	return bucket.DumpToFs(ctx)
+}
 
-	filesToWrite := NewGenerateBucket()
+// ExecuteInto stages plugin results in a shared bucket, rejecting conflicting outputs.
+func (p *GenerationPlan) ExecuteInto(ctx context.Context, filesToWrite *GenerateBucket) error {
+	c, root := p.core, p.root
+	files, fileDescriptors, dependencyFiles := p.files, p.descriptors, p.dependencyFiles
 
 	for _, plugin := range c.plugins {
-		filesToGenerate := q.Files
+		filesToGenerate := slices.Clone(files)
 
 		if plugin.WithImports {
-			filesToGenerate = append(filesToGenerate, dependencyFiles...)
+			for _, dependency := range dependencyFiles {
+				if !slices.Contains(filesToGenerate, dependency) {
+					filesToGenerate = append(filesToGenerate, dependency)
+				}
+			}
 		}
 
 		req := &pluginpb.CodeGeneratorRequest{
@@ -281,6 +213,9 @@ func (c *Core) Generate(ctx context.Context, root, directory, descriptorSetOut s
 			CompilerVersion: version.CompilerVersion(),
 		}
 
+		// Executors receive independent requests; prepared descriptors stay immutable.
+		req = proto.Clone(req).(*pluginpb.CodeGeneratorRequest)
+
 		executor := c.getExecutor(plugin)
 
 		source := plugin.Source.Name
@@ -294,6 +229,7 @@ func (c *Core) Generate(ctx context.Context, root, directory, descriptorSetOut s
 
 		resp, err := executor.Execute(ctx, pluginexecutor.Info{
 			Source:  source,
+			WorkDir: c.pluginWorkDir,
 			Command: plugin.Source.Command,
 			Options: plugin.Options,
 		}, req)
@@ -301,47 +237,90 @@ func (c *Core) Generate(ctx context.Context, root, directory, descriptorSetOut s
 			return fmt.Errorf("execute plugin %s: %w, executor: %s", source, err, executor.GetName())
 		}
 
-		// Check for plugin errors
 		if resp.Error != nil {
 			return fmt.Errorf("plugin %s error: %s, executor: %s", plugin.Source, *resp.Error, executor.GetName())
 		}
 
-		// Output information about generated files (for debugging)
+		outputDir := root
+		if plugin.Out != "" {
+			outputDir = filepath.Join(root, plugin.Out)
+		}
+		var goOutputDirs map[string]string
+		paths := plugin.Options["paths"]
+		if c.goPackageOutputPrefix != "" && len(paths) > 0 && paths[len(paths)-1] == "source_relative" {
+			goOutputDirs = goPackageOutputDirs(c.goPackageOutputPrefix, filesToGenerate, fileDescriptors, plugin.Options)
+		}
 		for _, file := range resp.File {
-			// Determine base directory for output files considering plugin.Out
-			var baseDir string
-			if plugin.Out != "" {
-				baseDir = filepath.Join(root, plugin.Out)
-			} else {
-				baseDir = root
+			originalName := file.GetName()
+			if !filepath.IsLocal(filepath.FromSlash(originalName)) {
+				return fmt.Errorf("plugin returned invalid output path %q", originalName)
+			}
+			outputName := originalName
+			if file.GetInsertionPoint() == "" {
+				outputName = goPackageOutputPath(file, goOutputDirs)
+			}
+			if !filepath.IsLocal(filepath.FromSlash(outputName)) {
+				return fmt.Errorf("plugin returned invalid output path %q", outputName)
+			}
+			path := filepath.Join(outputDir, filepath.FromSlash(outputName))
+			originalPath := filepath.Join(outputDir, filepath.FromSlash(originalName))
+			if file.GetInsertionPoint() != "" {
+				path, err = filesToWrite.insertionOutputPath(originalPath)
+				if err != nil {
+					return fmt.Errorf("insertionOutputPath: %w", err)
+				}
 			}
-
-			p := filepath.Join(baseDir, file.GetName())
 
 			c.logger.Debug(ctx, "generated file",
 				slog.String("plugin", source),
-				slog.String("file", file.GetName()),
+				slog.String("file", outputName),
 				slog.String("plugin_out", plugin.Out),
-				slog.String("full_path", p),
+				slog.String("full_path", path),
 			)
 
-			// Write file to bucket with insertion point support
-			if err := addFileWithInsertionPoint(ctx, p, file, filesToWrite); err != nil {
+			if err := addFileWithInsertionPoint(ctx, path, file, filesToWrite); err != nil {
 				return fmt.Errorf("addFileWithInsertionPoint: %w", err)
 			}
+			if file.GetInsertionPoint() == "" {
+				filesToWrite.recordOutputPath(originalPath, path)
+			}
 		}
 	}
 
-	err = filesToWrite.DumpToFs(ctx)
-	if err != nil {
-		return fmt.Errorf("filesToWrite.DumpToFs: %w", err)
-	}
-
 	c.logger.Info(ctx, "code generation completed")
 
 	return nil
 }
 
+// collectFileDescriptors orders each descriptor after its imports, preserving
+// the compiler's target order and recording files first reached as dependencies.
+func collectFileDescriptors(files linker.Files) ([]*descriptorpb.FileDescriptorProto, []string) {
+	var descriptors []*descriptorpb.FileDescriptorProto
+	var dependencies []string
+	processed := make(map[string]bool)
+
+	var visit func(protoreflect.FileDescriptor, bool)
+	visit = func(file protoreflect.FileDescriptor, dependency bool) {
+		name := file.Path()
+		if processed[name] {
+			return
+		}
+		for i := range file.Imports().Len() {
+			visit(file.Imports().Get(i), true)
+		}
+		descriptors = append(descriptors, protoutil.ProtoFromFileDescriptor(file))
+		processed[name] = true
+		if dependency {
+			dependencies = append(dependencies, name)
+		}
+	}
+
+	for _, file := range files {
+		visit(file, false)
+	}
+	return descriptors, dependencies
+}
+
 // addFileWithInsertionPoint add file to bucket with insertion point support
 // inspired by https://github.com/bufbuild/buf/blob/v1.60.0/private/bufpkg/bufprotoplugin/response_writer.go#L75
 func addFileWithInsertionPoint(
@@ -377,79 +356,13 @@ func addFileWithInsertionPoint(
 		return nil
 	}
 
+	if previous, ok := bucket.GetFile(ctx, filePath); ok && !bytes.Equal(previous.Data(), fileContent) {
+		return fmt.Errorf("conflicting generated output %q; choose distinct plugin out paths and matching go_package values", filePath)
+	}
 	bucket.PutFile(ctx, filePath, fileContent)
 	return nil
 }
 
-// pathsOverlap checks if two paths overlap (one is within another or they are equal).
-// It is recommended to pass absolute paths.
-func pathsOverlap(a, b string) bool {
-	na := filepath.Clean(a)
-	nb := filepath.Clean(b)
-
-	// Full match is always overlap
-	if na == nb {
-		return true
-	}
-
-	// Add separator at the end to distinguish "/foo/bar" from "/foo/bark"
-	naSlash := na + string(filepath.Separator)
-	nbSlash := nb + string(filepath.Separator)
-
-	// na is parent of nb
-	if strings.HasPrefix(nbSlash, naSlash) {
-		return true
-	}
-
-	// nb is parent of na
-	if strings.HasPrefix(naSlash, nbSlash) {
-		return true
-	}
-
-	return false
-}
-
-func (c *Core) shouldIgnoreGenerate(ctx context.Context, path string, dirs []string) bool {
-	path = filepath.Clean(path)
-	if len(dirs) == 0 {
-		return true
-	}
-
-	for _, dir := range dirs {
-		dir = filepath.Clean(dir)
-
-		// Special case: if dir is ".", match everything
-		if dir == "." {
-			c.logger.Debug(ctx, "shouldIgnore: dir is '.', matching all paths", slog.String("path", path))
-			return false // Don't ignore - match everything
-		}
-
-		// Check if path starts with dir (prefix matching)
-		if strings.HasPrefix(path, dir+"/") || path == dir {
-			c.logger.Debug(ctx, "shouldIgnore: path starts with dir", slog.String("path", path), slog.String("dir", dir))
-			return false // Don't ignore - path is within directory
-		}
-
-		// Check regex pattern (for wildcard patterns)
-		// QuoteMeta escapes all special chars (including *), then we convert \* back to .* for wildcard matching
-		pattern := regexp.QuoteMeta(dir)
-		pattern = strings.ReplaceAll(pattern, "\\*", ".*")
-		regexPattern := "^" + pattern
-
-		matched, err := regexp.MatchString(regexPattern, path)
-		if err != nil {
-			c.logger.Warn(ctx, "shouldIgnore: regex match error", slog.String("path", path), slog.String("dir", dir), slog.String("regex", regexPattern), slog.Any("error", err))
-			continue
-		}
-		if matched {
-			c.logger.Debug(ctx, "shouldIgnore: path matches regex pattern", slog.String("path", path), slog.String("dir", dir), slog.String("regex", regexPattern))
-			return false // Don't ignore - path matches pattern
-		}
-	}
-
-	return true
-}
-
 // stripPrefix removes prefix from path and normalizes to forward slashes.
 func stripPrefix(path, prefix string) string {
 	normalizedPath := filepath.ToSlash(path)
@@ -460,26 +373,6 @@ func stripPrefix(path, prefix string) string {
 	return strings.TrimPrefix(normalizedPath, normalizedPrefix+"/")
 }
 
-// For debuging
-func runCmd(ctx context.Context, dir string, command string, stdIn *bytes.Buffer, commandParams ...string) (string, error) {
-	var stderr bytes.Buffer
-	var stdout bytes.Buffer
-
-	fullCommand := append([]string{command}, commandParams...)
-	cmd := exec.CommandContext(ctx, "bash", "-c", strings.Join(fullCommand, " "))
-	cmd.Dir = dir
-	cmd.Stdin = stdIn
-	cmd.Stderr = &stderr
-	cmd.Stdout = &stdout
-
-	err := cmd.Run()
-	if err != nil {
-		return "", fmt.Errorf("%s", stderr.String())
-	}
-
-	return stdout.String(), nil
-}
-
 // isPluginInPath checks if the plugin is available in PATH
 func (c *Core) isPluginInPath(pluginName string) bool {
 	pluginCmd := fmt.Sprintf("protoc-gen-%s", pluginName)
@@ -507,80 +400,12 @@ func (c *Core) getExecutor(plugin Plugin) pluginexecutor.Executor {
 	return c.localExecutor
 }
 
-// buildFileToModuleMap creates a mapping from file paths to their module names.
-// This is used by managed mode to apply module-specific rules.
-//
-// The mapping works by scanning installed dependency directories and mapping
-// relative proto file paths to their source module. For example:
-//   - Module "github.com/googleapis/googleapis" installed at ~/.easyp/mod/github.com/googleapis/googleapis/v1/
-//   - Contains file: google/api/annotations.proto
-//   - Mapping: "google/api/annotations.proto" → "github.com/googleapis/googleapis"
-func (c *Core) buildFileToModuleMap(ctx context.Context, files []string) map[string]string {
-	fileToModule := make(map[string]string)
-
-	// Map main files - they belong to the local project (empty module)
+// buildFileToModuleMap maps generated files to their v1 module identities.
+func (c *Core) buildFileToModuleMap(files []string) map[string]string {
+	fileToModule := make(map[string]string, len(files)+len(c.fileModules))
 	for _, file := range files {
 		fileToModule[file] = ""
 	}
-
-	// Build mapping from dependency install directories
-	// For each dependency, scan its install dir and map relative paths to module name
-	for _, dep := range c.deps {
-		module := models.NewModule(dep)
-		c.mapModuleFiles(ctx, module.Name, fileToModule)
-	}
-
-	// Also map files from git repo inputs
-	for _, repo := range c.inputs.InputGitRepos {
-		module := models.NewModule(repo.URL)
-		c.mapModuleFiles(ctx, module.Name, fileToModule)
-	}
-
+	maps.Copy(fileToModule, c.fileModules)
 	return fileToModule
 }
-
-// mapModuleFiles scans a module's install directory and adds proto file mappings.
-func (c *Core) mapModuleFiles(ctx context.Context, moduleName string, fileToModule map[string]string) {
-	// Get module version from lock file
-	lockInfo, err := c.lockFile.Read(moduleName)
-	if err != nil {
-		// Module not installed or not in lock file - skip
-		return
-	}
-
-	// Get install directory
-	installDir := c.storage.GetInstallDir(moduleName, lockInfo.Version)
-
-	// Walk the install directory and map all .proto files
-	err = filepath.WalkDir(installDir, func(filePath string, d os.DirEntry, err error) error {
-		if err != nil {
-			return nil // Skip errors
-		}
-
-		if d.IsDir() || filepath.Ext(filePath) != ".proto" {
-			return nil
-		}
-
-		// Get relative path from install dir (this is the import path)
-		relPath, err := filepath.Rel(installDir, filePath)
-		if err != nil {
-			return nil
-		}
-
-		// Normalize to forward slashes (proto import paths use forward slashes)
-		relPath = filepath.ToSlash(relPath)
-
-		// Map this file to its module
-		fileToModule[relPath] = moduleName
-
-		return nil
-	})
-
-	if err != nil {
-		// Log error but don't fail - managed mode can work without module mapping
-		c.logger.Warn(ctx, "failed to scan module directory",
-			slog.String("module", moduleName),
-			slog.String("installDir", installDir),
-			slog.Any("error", err))
-	}
-}
diff --git a/internal/core/generate_bucket.go b/internal/core/generate_bucket.go
index deedc208..5383e918 100644
--- a/internal/core/generate_bucket.go
+++ b/internal/core/generate_bucket.go
@@ -3,8 +3,12 @@ package core
 import (
 	"context"
 	"fmt"
+	"go/parser"
+	"go/token"
 	"os"
 	"path/filepath"
+	"slices"
+	"strings"
 	"sync"
 )
 
@@ -25,12 +29,14 @@ func (i *ImmutableData) Data() []byte {
 // It provides methods for adding, retrieving, and removing files.
 type GenerateBucket struct {
 	filesToWrite map[string]*ImmutableData
+	outputPaths  map[string][]string
 	lock         sync.RWMutex
 }
 
 func NewGenerateBucket() *GenerateBucket {
 	return &GenerateBucket{
 		filesToWrite: make(map[string]*ImmutableData),
+		outputPaths:  make(map[string][]string),
 	}
 }
 
@@ -48,16 +54,56 @@ func (b *GenerateBucket) GetFile(_ context.Context, path string) (*ImmutableData
 	return file, ok
 }
 
-func (b *GenerateBucket) RemoveFile(_ context.Context, path string) {
+// recordOutputPath retains response filenames in their output directory across
+// plugins and plans. Several producers may share a filename but relocate it to
+// distinct packages, so that filename becomes ambiguous for later insertions.
+func (b *GenerateBucket) recordOutputPath(originalPath, outputPath string) {
 	b.lock.Lock()
 	defer b.lock.Unlock()
-	delete(b.filesToWrite, path)
+
+	if !slices.Contains(b.outputPaths[originalPath], outputPath) {
+		b.outputPaths[originalPath] = append(b.outputPaths[originalPath], outputPath)
+	}
+}
+
+func (b *GenerateBucket) insertionOutputPath(originalPath string) (string, error) {
+	b.lock.RLock()
+	defer b.lock.RUnlock()
+
+	paths := b.outputPaths[originalPath]
+	switch len(paths) {
+	case 0:
+		return originalPath, nil
+	case 1:
+		return paths[0], nil
+	default:
+		return "", fmt.Errorf("ambiguous insertion target %q maps to multiple generated output paths %q", originalPath, paths)
+	}
 }
 
 func (b *GenerateBucket) DumpToFs(_ context.Context) error {
 	b.lock.Lock()
 	defer b.lock.Unlock()
 
+	// Validate the complete generated Go layout before writing any file.
+	packages := make(map[string]string)
+	for path, file := range b.filesToWrite {
+		if !strings.HasSuffix(path, ".go") {
+			continue
+		}
+		parsed, err := parser.ParseFile(token.NewFileSet(), path, file.Data(), parser.PackageClauseOnly)
+		if err != nil {
+			return fmt.Errorf("invalid generated Go package in %s: %w", path, err)
+		}
+		key := filepath.Dir(path)
+		if strings.HasSuffix(path, "_test.go") && strings.HasSuffix(parsed.Name.Name, "_test") {
+			continue
+		}
+		if previous, ok := packages[key]; ok && previous != parsed.Name.Name {
+			return fmt.Errorf("conflicting Go packages %q and %q in %s; use distinct out directories and matching go_package import paths", previous, parsed.Name.Name, key)
+		}
+		packages[key] = parsed.Name.Name
+	}
 	// TODO: Есть возможность писать файлы асинхронно (MkdirAll до)
 	for path, file := range b.filesToWrite {
 		dir := filepath.Dir(path)
diff --git a/internal/core/generate_compiler_version_test.go b/internal/core/generate_compiler_version_test.go
index ef7aa3d7..cdd4f3e0 100644
--- a/internal/core/generate_compiler_version_test.go
+++ b/internal/core/generate_compiler_version_test.go
@@ -2,39 +2,18 @@ package core
 
 import (
 	"context"
-	"errors"
-	"iter"
 	"os"
 	"os/exec"
 	"path/filepath"
 	"strings"
 	"testing"
 
-	"github.com/easyp-tech/easyp/internal/adapters/console"
-	pluginexecutor "github.com/easyp-tech/easyp/internal/adapters/plugin"
-	"github.com/easyp-tech/easyp/internal/core/models"
-	"github.com/easyp-tech/easyp/internal/logger"
 	"google.golang.org/protobuf/proto"
 	"google.golang.org/protobuf/types/pluginpb"
-)
-
-type emptyLockFile struct{}
-
-func (emptyLockFile) Read(moduleName string) (models.LockFileInfo, error) {
-	return models.LockFileInfo{}, errors.New("lock file info not found")
-}
-
-func (emptyLockFile) Write(moduleName string, revisionVersion string, installedPackageHash models.ModuleHash) error {
-	return nil
-}
-
-func (emptyLockFile) IsEmpty() bool {
-	return true
-}
 
-func (emptyLockFile) DepsIter() iter.Seq[models.LockFileInfo] {
-	return func(yield func(models.LockFileInfo) bool) {}
-}
+	pluginexecutor "github.com/easyp-tech/easyp/internal/adapters/plugin"
+	"github.com/easyp-tech/easyp/internal/logger"
+)
 
 type captureExecutor struct {
 	requests []*pluginpb.CodeGeneratorRequest
@@ -66,7 +45,7 @@ func TestGenerateSetsCompilerVersionInRequest(t *testing.T) {
 		executor,
 	)
 
-	if err := app.Generate(context.Background(), root, ".", "", false); err != nil {
+	if err := app.Generate(context.Background(), root, "", false); err != nil {
 		t.Fatalf("Generate() error = %v", err)
 	}
 
@@ -121,10 +100,10 @@ func TestGenerateGoHeaderUsesCompilerVersion(t *testing.T) {
 		})
 	}
 
-	localExecutor := pluginexecutor.NewLocalPluginExecutor(console.New(), logger.NewNop())
+	localExecutor := pluginexecutor.NewLocalPluginExecutor(logger.NewNop())
 	app := testCoreWithPlugins(plugins, localExecutor)
 
-	if err := app.Generate(context.Background(), root, ".", "", false); err != nil {
+	if err := app.Generate(context.Background(), root, "", false); err != nil {
 		t.Fatalf("Generate() error = %v", err)
 	}
 
@@ -164,7 +143,6 @@ func testCoreWithPlugins(plugins []Plugin, localExecutor pluginexecutor.Executor
 				},
 			},
 		},
-		lockFile:        emptyLockFile{},
 		localExecutor:   localExecutor,
 		remoteExecutor:  localExecutor,
 		builtinExecutor: localExecutor,
diff --git a/internal/core/generate_descriptors_test.go b/internal/core/generate_descriptors_test.go
new file mode 100644
index 00000000..bfa27212
--- /dev/null
+++ b/internal/core/generate_descriptors_test.go
@@ -0,0 +1,178 @@
+package core
+
+import (
+	"context"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"google.golang.org/protobuf/proto"
+	"google.golang.org/protobuf/types/descriptorpb"
+)
+
+func TestGenerateDescriptors(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name           string
+		files          map[string]string
+		withImports    []bool
+		includeImports bool
+		wantOrder      []string
+		wantGenerated  [][]string
+		wantSaved      []string
+	}{
+		{
+			name: "shared_transitive_dependencies",
+			files: map[string]string{
+				"shared.proto":     `syntax = "proto3"; message Shared {}`,
+				"middle.proto":     `syntax = "proto3"; import "shared.proto"; message Middle { Shared shared = 1; }`,
+				"api/first.proto":  `syntax = "proto3"; import "shared.proto"; message First { Shared shared = 1; }`,
+				"api/second.proto": `syntax = "proto3"; import "middle.proto"; message Second { Middle middle = 1; }`,
+			},
+			withImports: []bool{true, false},
+			wantOrder:   []string{"shared.proto", "api/first.proto", "middle.proto", "api/second.proto"},
+			wantGenerated: [][]string{
+				{"api/first.proto", "api/second.proto", "shared.proto", "middle.proto"},
+				{"api/first.proto", "api/second.proto"},
+			},
+			wantSaved: []string{"api/first.proto", "api/second.proto"},
+		},
+		{
+			name: "descriptor_includes_imports",
+			files: map[string]string{
+				"shared.proto":   `syntax = "proto3"; message Shared {}`,
+				"api/item.proto": `syntax = "proto3"; import "shared.proto"; message Item { Shared shared = 1; }`,
+			},
+			withImports:    []bool{false, true},
+			includeImports: true,
+			wantOrder:      []string{"shared.proto", "api/item.proto"},
+			wantGenerated:  [][]string{{"api/item.proto"}, {"api/item.proto", "shared.proto"}},
+			wantSaved:      []string{"shared.proto", "api/item.proto"},
+		},
+		{
+			name:           "target_without_imports",
+			files:          map[string]string{"api/item.proto": `syntax = "proto3"; message Item {}`},
+			withImports:    []bool{true},
+			includeImports: true,
+			wantOrder:      []string{"api/item.proto"},
+			wantGenerated:  [][]string{{"api/item.proto"}},
+			wantSaved:      []string{"api/item.proto"},
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			writeGenerationSources(t, root, tt.files)
+			plugins := make([]Plugin, len(tt.withImports))
+			for i, withImports := range tt.withImports {
+				plugins[i] = Plugin{Source: PluginSource{Name: "custom-plugin"}, WithImports: withImports}
+			}
+			executor := &captureExecutor{}
+			app := testCoreWithPlugins(plugins, executor)
+			descriptorPath := filepath.Join(root, "descriptors.pb")
+
+			err := app.Generate(t.Context(), root, descriptorPath, tt.includeImports)
+
+			require.NoError(t, err)
+			require.Len(t, executor.requests, len(tt.wantGenerated))
+			for i, request := range executor.requests {
+				assert.Equal(t, tt.wantOrder, descriptorNames(request.GetProtoFile()))
+				assert.Equal(t, tt.wantGenerated[i], request.GetFileToGenerate())
+			}
+			raw, err := os.ReadFile(descriptorPath)
+			require.NoError(t, err)
+			var saved descriptorpb.FileDescriptorSet
+			require.NoError(t, proto.Unmarshal(raw, &saved))
+			assert.Equal(t, tt.wantSaved, descriptorNames(saved.GetFile()))
+		})
+	}
+}
+
+func TestGenerateStopsBeforePlugins(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name           string
+		files          map[string]string
+		canceled       bool
+		descriptorPath string
+		wantErr        error
+		wantMessage    string
+	}{
+		{
+			name:           "canceled_context",
+			files:          map[string]string{"api/item.proto": `syntax = "proto3"; message Item {}`},
+			canceled:       true,
+			descriptorPath: "descriptors.pb",
+			wantErr:        context.Canceled,
+		},
+		{name: "empty_sources", descriptorPath: "descriptors.pb", wantErr: ErrEmptyInputFiles},
+		{
+			name:           "invalid_source",
+			files:          map[string]string{"api/item.proto": `syntax = "proto3"; message {}`},
+			descriptorPath: "descriptors.pb",
+			wantMessage:    "syntax error",
+		},
+		{
+			name:           "descriptor_write_failure",
+			files:          map[string]string{"api/item.proto": `syntax = "proto3"; message Item {}`},
+			descriptorPath: "missing/descriptors.pb",
+			wantErr:        os.ErrNotExist,
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			writeGenerationSources(t, root, tt.files)
+			executor := &captureExecutor{}
+			app := testCoreWithPlugins([]Plugin{{Source: PluginSource{Name: "custom-plugin"}}}, executor)
+			ctx, cancel := context.WithCancel(t.Context())
+			defer cancel()
+			if tt.canceled {
+				cancel()
+			}
+			descriptorPath := filepath.Join(root, tt.descriptorPath)
+
+			err := app.Generate(ctx, root, descriptorPath, false)
+
+			if tt.wantErr != nil {
+				require.ErrorIs(t, err, tt.wantErr)
+			} else {
+				require.ErrorContains(t, err, tt.wantMessage)
+			}
+			assert.Empty(t, executor.requests)
+			_, err = os.Stat(descriptorPath)
+			assert.ErrorIs(t, err, os.ErrNotExist)
+		})
+	}
+}
+
+func writeGenerationSources(t *testing.T, root string, files map[string]string) {
+	t.Helper()
+
+	require.NoError(t, os.MkdirAll(filepath.Join(root, "api"), 0o755))
+	for name, content := range files {
+		path := filepath.Join(root, name)
+		require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+		require.NoError(t, os.WriteFile(path, []byte(content), 0o644))
+	}
+}
+
+func descriptorNames(files []*descriptorpb.FileDescriptorProto) []string {
+	var names []string
+	for _, file := range files {
+		names = append(names, file.GetName())
+	}
+	return names
+}
diff --git a/internal/core/generate_go_output_test.go b/internal/core/generate_go_output_test.go
new file mode 100644
index 00000000..99a32a2f
--- /dev/null
+++ b/internal/core/generate_go_output_test.go
@@ -0,0 +1,212 @@
+package core
+
+import (
+	"context"
+	"fmt"
+	"path/filepath"
+	"sync"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"google.golang.org/protobuf/proto"
+	"google.golang.org/protobuf/types/descriptorpb"
+	"google.golang.org/protobuf/types/pluginpb"
+
+	pluginexecutor "github.com/easyp-tech/easyp/internal/adapters/plugin"
+)
+
+type goOutputExecutor struct {
+	responses map[string]*pluginpb.CodeGeneratorResponse
+}
+
+func (e *goOutputExecutor) Execute(_ context.Context, info pluginexecutor.Info, _ *pluginpb.CodeGeneratorRequest) (*pluginpb.CodeGeneratorResponse, error) {
+	return proto.Clone(e.responses[info.Source]).(*pluginpb.CodeGeneratorResponse), nil
+}
+
+func (e *goOutputExecutor) GetName() string {
+	return "goOutputExecutor"
+}
+
+func TestExecuteIntoInsertionUsesProducerOutputPath(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name          string
+		insertionName string
+		insertionOut  string
+		options       map[string][]string
+		separatePlans bool
+		duplicate     bool
+		ambiguous     bool
+		wantError     string
+	}{
+		{name: "insertion without paths option", insertionName: "api/user_grpc.pb.go", insertionOut: "gen"},
+		{name: "overlapping grpc basename", insertionName: "api/user_grpc.pb.go", insertionOut: "gen", options: map[string][]string{"paths": {"source_relative"}}},
+		{name: "different insertion mapping", insertionName: "api/user_grpc.pb.go", insertionOut: "gen", options: map[string][]string{"paths": {"source_relative"}, "Mapi/user.proto": {"example.test/generated/other"}}},
+		{name: "shared bucket across plans", insertionName: "api/user_grpc.pb.go", insertionOut: "gen", separatePlans: true},
+		{name: "already relocated insertion name", insertionName: "user/v1/user_grpc.pb.go", insertionOut: "gen"},
+		{name: "equivalent output directories", insertionName: "api/user_grpc.pb.go", insertionOut: "./gen"},
+		{name: "duplicate producer is unambiguous", insertionName: "api/user_grpc.pb.go", insertionOut: "gen", duplicate: true},
+		{name: "other output directory has no producer", insertionName: "api/user_grpc.pb.go", insertionOut: "other", wantError: "file not found (bucket)"},
+		{name: "ambiguous original name is rejected", insertionName: "api/user_grpc.pb.go", insertionOut: "gen", ambiguous: true, wantError: "ambiguous insertion target"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			producer := &pluginpb.CodeGeneratorResponse_File{
+				Name:    proto.String("api/user_grpc.pb.go"),
+				Content: proto.String("// Code generated by custom. DO NOT EDIT.\n// source: api/user.proto\n\npackage userv1\n// @@protoc_insertion_point(example)\n"),
+			}
+			executor := &goOutputExecutor{responses: map[string]*pluginpb.CodeGeneratorResponse{
+				"producer": {File: []*pluginpb.CodeGeneratorResponse_File{producer}},
+				"insert": {File: []*pluginpb.CodeGeneratorResponse_File{{
+					Name: proto.String(tt.insertionName), InsertionPoint: proto.String("example"), Content: proto.String("const Inserted = 1\n"),
+				}}},
+			}}
+			plugins := []Plugin{{Source: PluginSource{Name: "producer"}, Out: "gen", Options: map[string][]string{"paths": {"source_relative"}}}}
+			if tt.duplicate || tt.ambiguous {
+				second := proto.Clone(producer).(*pluginpb.CodeGeneratorResponse_File)
+				if tt.ambiguous {
+					second.Content = proto.String("// Code generated by custom. DO NOT EDIT.\n// source: api/user_grpc.proto\n\npackage typesv1\n// @@protoc_insertion_point(example)\n")
+				}
+				executor.responses["second"] = &pluginpb.CodeGeneratorResponse{File: []*pluginpb.CodeGeneratorResponse_File{second}}
+				plugins = append(plugins, Plugin{Source: PluginSource{Name: "second"}, Out: "gen", Options: map[string][]string{"paths": {"source_relative"}}})
+			}
+			insertion := Plugin{Source: PluginSource{Name: "insert"}, Out: tt.insertionOut, Options: tt.options}
+			if !tt.separatePlans {
+				plugins = append(plugins, insertion)
+			}
+			app := testCoreWithPlugins(plugins, executor)
+			app.goPackageOutputPrefix = "example.test/generated"
+			plan := &GenerationPlan{core: app, root: root,
+				files: []string{"api/user.proto", "api/user_grpc.proto"},
+				descriptors: []*descriptorpb.FileDescriptorProto{
+					{Name: proto.String("api/user.proto"), Options: &descriptorpb.FileOptions{GoPackage: proto.String("example.test/generated/user/v1;userv1")}},
+					{Name: proto.String("api/user_grpc.proto"), Options: &descriptorpb.FileOptions{GoPackage: proto.String("example.test/generated/types/v1;typesv1")}},
+				},
+			}
+			bucket := NewGenerateBucket()
+
+			err := plan.ExecuteInto(t.Context(), bucket)
+			if tt.separatePlans {
+				require.NoError(t, err)
+				insertionPlan := &GenerationPlan{core: testCoreWithPlugins([]Plugin{insertion}, executor), root: root,
+					files: plan.files, descriptors: plan.descriptors,
+				}
+				err = insertionPlan.ExecuteInto(t.Context(), bucket)
+			}
+
+			if tt.wantError != "" {
+				require.ErrorContains(t, err, tt.wantError)
+				return
+			}
+			require.NoError(t, err)
+			file, ok := bucket.GetFile(t.Context(), filepath.Join(root, "gen/user/v1/user_grpc.pb.go"))
+			require.True(t, ok)
+			assert.Contains(t, string(file.Data()), "const Inserted = 1\n// @@protoc_insertion_point(example)")
+			_, ok = bucket.GetFile(t.Context(), filepath.Join(root, "gen/types/v1/user_grpc.pb.go"))
+			assert.False(t, ok)
+		})
+	}
+}
+
+func TestExecuteIntoGoImportMappingControlsOutputDirectory(t *testing.T) {
+	t.Parallel()
+
+	const prefix = "example.test/generated"
+	tests := []struct {
+		name    string
+		prefix  string
+		output  string
+		options map[string][]string
+		want    string
+	}{
+		{name: "mapping overrides descriptor", options: map[string][]string{"paths": {"source_relative"}, "Mapi/models.proto": {prefix + "/custom"}}, want: "custom/models.pb.go"},
+		{name: "mapping package alias is not a directory", options: map[string][]string{"paths": {"source_relative"}, "Mapi/models.proto": {prefix + "/custom;alias"}}, want: "custom/models.pb.go"},
+		{name: "last nonempty mapping wins", options: map[string][]string{"paths": {"source_relative"}, "Mapi/models.proto": {prefix + "/old", prefix + "/custom"}}, want: "custom/models.pb.go"},
+		{name: "empty mapping keeps earlier import", options: map[string][]string{"paths": {"source_relative"}, "Mapi/models.proto": {prefix + "/custom", ""}}, want: "custom/models.pb.go"},
+		{name: "alias only mapping keeps descriptor import", options: map[string][]string{"paths": {"source_relative"}, "Mapi/models.proto": {";alias"}}, want: "common/v1/models.pb.go"},
+		{name: "alias only mapping keeps earlier import", options: map[string][]string{"paths": {"source_relative"}, "Mapi/models.proto": {prefix + "/custom", ";alias"}}, want: "custom/models.pb.go"},
+		{name: "empty mapping keeps descriptor import", options: map[string][]string{"paths": {"source_relative"}, "Mapi/models.proto": {""}}, want: "common/v1/models.pb.go"},
+		{name: "outside prefix keeps plugin path", options: map[string][]string{"paths": {"source_relative"}, "Mapi/models.proto": {"example.test/other/custom"}}, want: "api/models.pb.go"},
+		{name: "SDK root mapping", options: map[string][]string{"paths": {"source_relative"}, "Mapi/models.proto": {prefix + ";sdk"}}, want: "models.pb.go"},
+		{name: "marker uses effective mapping", prefix: prefix + "/{{file_path}}", options: map[string][]string{"paths": {"source_relative"}, "Mapi/models.proto": {prefix + "/custom"}}, want: "custom/models.pb.go"},
+		{name: "last paths option is source relative", options: map[string][]string{"paths": {"import", "source_relative"}, "Mapi/models.proto": {prefix + "/custom"}}, want: "custom/models.pb.go"},
+		{name: "last paths option is import", output: prefix + "/custom/models.pb.go", options: map[string][]string{"paths": {"source_relative", "import"}, "Mapi/models.proto": {prefix + "/custom"}}, want: prefix + "/custom/models.pb.go"},
+		{name: "default import mode remains plugin controlled", output: prefix + "/custom/models.pb.go", options: map[string][]string{"Mapi/models.proto": {prefix + "/custom"}}, want: prefix + "/custom/models.pb.go"},
+		{name: "module mode remains plugin controlled", output: "custom/models.pb.go", options: map[string][]string{"paths": {"import"}, "module": {prefix}, "Mapi/models.proto": {prefix + "/custom"}}, want: "custom/models.pb.go"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			output := tt.output
+			if output == "" {
+				output = "api/models.pb.go"
+			}
+			executor := &goOutputExecutor{responses: map[string]*pluginpb.CodeGeneratorResponse{
+				"go-output": {File: []*pluginpb.CodeGeneratorResponse_File{{
+					Name: proto.String(output), Content: proto.String("// Code generated by custom. DO NOT EDIT.\n// source: api/models.proto\n\npackage commonv1\n"),
+				}}},
+			}}
+			app := testCoreWithPlugins([]Plugin{{Source: PluginSource{Name: "go-output"}, Out: "gen", Options: tt.options}}, executor)
+			app.goPackageOutputPrefix = tt.prefix
+			if app.goPackageOutputPrefix == "" {
+				app.goPackageOutputPrefix = prefix
+			}
+			descriptor := &descriptorpb.FileDescriptorProto{
+				Name: proto.String("api/models.proto"), Options: &descriptorpb.FileOptions{GoPackage: proto.String(prefix + "/common/v1;commonv1")},
+			}
+			plan := &GenerationPlan{core: app, root: root, files: []string{"api/models.proto"}, descriptors: []*descriptorpb.FileDescriptorProto{descriptor}}
+			bucket := NewGenerateBucket()
+
+			err := plan.ExecuteInto(t.Context(), bucket)
+
+			require.NoError(t, err)
+			_, ok := bucket.GetFile(t.Context(), filepath.Join(root, "gen", filepath.FromSlash(tt.want)))
+			assert.True(t, ok, "expected generated file at %s", tt.want)
+			assert.Equal(t, prefix+"/common/v1;commonv1", descriptor.GetOptions().GetGoPackage(), "plugin mappings must not mutate prepared descriptors")
+		})
+	}
+}
+
+func TestExecuteIntoConcurrentGoOutputMappings(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	bucket := NewGenerateBucket()
+	responses := map[string]*pluginpb.CodeGeneratorResponse{
+		"producer": {File: []*pluginpb.CodeGeneratorResponse_File{{
+			Name: proto.String("api/models.pb.go"), Content: proto.String("// source: api/models.proto\npackage commonv1\n// @@protoc_insertion_point(example)\n"),
+		}}},
+		"insert": {File: []*pluginpb.CodeGeneratorResponse_File{{
+			Name: proto.String("api/models.pb.go"), InsertionPoint: proto.String("example"), Content: proto.String("const Inserted = 1\n"),
+		}}},
+	}
+	var group sync.WaitGroup
+	for i := range 16 {
+		group.Go(func() {
+			out := fmt.Sprintf("gen/client%d", i)
+			executor := &goOutputExecutor{responses: responses}
+			app := testCoreWithPlugins([]Plugin{
+				{Source: PluginSource{Name: "producer"}, Out: out, Options: map[string][]string{"paths": {"source_relative"}}},
+				{Source: PluginSource{Name: "insert"}, Out: out},
+			}, executor)
+			app.goPackageOutputPrefix = "example.test/generated"
+			plan := &GenerationPlan{core: app, root: root, files: []string{"api/models.proto"},
+				descriptors: []*descriptorpb.FileDescriptorProto{{Name: proto.String("api/models.proto"), Options: &descriptorpb.FileOptions{GoPackage: proto.String("example.test/generated/common/v1;commonv1")}}},
+			}
+
+			assert.NoError(t, plan.ExecuteInto(t.Context(), bucket))
+		})
+	}
+	group.Wait()
+	for i := range 16 {
+		file, ok := bucket.GetFile(t.Context(), filepath.Join(root, fmt.Sprintf("gen/client%d/common/v1/models.pb.go", i)))
+		require.True(t, ok)
+		assert.Contains(t, string(file.Data()), "const Inserted = 1\n// @@protoc_insertion_point(example)")
+	}
+}
diff --git a/internal/core/generate_managed_mode_test.go b/internal/core/generate_managed_mode_test.go
index 11ec3b48..57b3e281 100644
--- a/internal/core/generate_managed_mode_test.go
+++ b/internal/core/generate_managed_mode_test.go
@@ -1,103 +1,76 @@
 package core
 
 import (
-	"context"
 	"os"
 	"path/filepath"
 	"testing"
 
-	"github.com/easyp-tech/easyp/internal/core/models"
-	"github.com/easyp-tech/easyp/internal/logger"
+	"github.com/stretchr/testify/assert"
 	"github.com/stretchr/testify/require"
 	"google.golang.org/protobuf/types/descriptorpb"
+
+	"github.com/easyp-tech/easyp/internal/logger"
 )
 
-func TestGenerateManagedModeAppliesToGitRepoInputs(t *testing.T) {
+func TestGenerateV1ManagedModeAppliesToModuleFiles(t *testing.T) {
 	t.Parallel()
-
-	workspaceRoot := t.TempDir()
-	gitRepoRoot := t.TempDir()
-	writeProtoWithoutGoPackage(t, gitRepoRoot, "pinger/v1/service.proto")
-
-	executor := &captureExecutor{}
-
-	moduleName := "http://gitlab.com/foo/contracts"
-	moduleVersion := "v0.0.1"
-	lockInfo := models.LockFileInfo{
-		Name:    moduleName,
-		Version: moduleVersion,
+	tests := []struct {
+		name        string
+		module      string
+		wantPackage string
+	}{
+		{name: "matching module", module: "example.com/contracts", wantPackage: "pinger-service/internal/grpc/gen/pinger/v1;pingerv1"},
+		{name: "different module", module: "example.com/other"},
 	}
-
-	storage := &StorageMock{}
-	lockFile := &LockFileMock{}
-
-	lockFile.EXPECT().IsEmpty().Return(false).Once()
-	lockFile.EXPECT().DepsIter().Return(func(yield func(models.LockFileInfo) bool) {}).Twice()
-	lockFile.EXPECT().Read(moduleName).Return(lockInfo, nil).Twice()
-	storage.EXPECT().GetInstallDir(moduleName, moduleVersion).Return(gitRepoRoot).Twice()
-
-	app := &Core{
-		logger: logger.NewNop(),
-		plugins: []Plugin{
-			{
-				Source: PluginSource{Name: "custom-plugin"},
-				Out:    ".",
-			},
-		},
-		inputs: Inputs{
-			InputGitRepos: []InputGitRepo{
-				{
-					URL:          moduleName + "@" + moduleVersion,
-					SubDirectory: "pinger/v1",
-				},
-			},
-		},
-		storage:         storage,
-		lockFile:        lockFile,
-		managedMode:     ManagedModeConfig{Enabled: true, Override: []ManagedOverrideRule{{FileOption: FileOptionGoPackagePrefix, Value: "pinger-service/internal/grpc/gen"}}},
-		localExecutor:   executor,
-		remoteExecutor:  executor,
-		builtinExecutor: executor,
-		commandExecutor: executor,
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeProtoWithoutGoPackage(t, root, "pinger/v1/service.proto")
+			executor := &captureExecutor{}
+			identities := map[string]string{"pinger/v1/service.proto": tt.module}
+			app := New(Options{
+				Logger:            logger.NewNop(),
+				Plugins:           []Plugin{{Source: PluginSource{Name: "custom-plugin"}, Out: "."}},
+				Inputs:            Inputs{InputFilesDir: []InputFilesDir{{Path: "pinger", Root: "."}}},
+				FileModules:       identities,
+				ManagedModeConfig: ManagedModeConfig{Enabled: true, Override: []ManagedOverrideRule{{Module: "example.com/contracts", FileOption: FileOptionGoPackagePrefix, Value: "pinger-service/internal/grpc/gen"}}},
+			})
+			app.localExecutor = executor
+			identities["pinger/v1/service.proto"] = "changed after construction"
+
+			err := app.Generate(t.Context(), root, "", false)
+
+			require.NoError(t, err)
+			require.Len(t, executor.requests, 1)
+			request := executor.requests[0]
+			assert.Equal(t, []string{"pinger/v1/service.proto"}, request.GetFileToGenerate())
+			target := findFileDescriptor(t, request.GetProtoFile(), "pinger/v1/service.proto")
+			assert.Equal(t, tt.wantPackage, target.GetOptions().GetGoPackage())
+		})
 	}
-
-	err := app.Generate(context.Background(), workspaceRoot, ".", "", false)
-	require.NoError(t, err)
-	require.Len(t, executor.requests, 1)
-
-	req := executor.requests[0]
-	require.Equal(t, []string{"pinger/v1/service.proto"}, req.GetFileToGenerate())
-
-	target := findFileDescriptor(t, req.GetProtoFile(), "pinger/v1/service.proto")
-	require.Equal(t, "pinger-service/internal/grpc/gen/pinger/v1;pingerv1", target.GetOptions().GetGoPackage())
 }
 
-func writeProtoWithoutGoPackage(t *testing.T, root string, relPath string) {
+func writeProtoWithoutGoPackage(t *testing.T, root, relPath string) {
 	t.Helper()
-
 	fullPath := filepath.Join(root, relPath)
-	err := os.MkdirAll(filepath.Dir(fullPath), 0755)
-	require.NoError(t, err)
-
+	require.NoError(t, os.MkdirAll(filepath.Dir(fullPath), 0o755))
 	protoContent := `syntax = "proto3";
 package pinger.v1;
 
 message PingRequest {}
 `
-
-	err = os.WriteFile(fullPath, []byte(protoContent), 0644)
-	require.NoError(t, err)
+	require.NoError(t, os.WriteFile(fullPath, []byte(protoContent), 0o644))
 }
 
 func findFileDescriptor(t *testing.T, files []*descriptorpb.FileDescriptorProto, name string) *descriptorpb.FileDescriptorProto {
 	t.Helper()
-
 	for _, file := range files {
 		if file.GetName() == name {
 			return file
 		}
 	}
-
 	t.Fatalf("file descriptor %q not found", name)
 	return nil
 }
diff --git a/internal/core/generate_selection_test.go b/internal/core/generate_selection_test.go
new file mode 100644
index 00000000..75e06815
--- /dev/null
+++ b/internal/core/generate_selection_test.go
@@ -0,0 +1,41 @@
+package core
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestPrepareGenerationFilesKeepsClosureAndPluginSelections(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeGenerationSources(t, root, map[string]string{
+		"shared.proto":     "syntax=\"proto3\"; package shared; message Shared {}",
+		"api/first.proto":  "syntax=\"proto3\"; package api; import \"shared.proto\"; message First { shared.Shared item=1; }",
+		"api/second.proto": "syntax=\"proto3\"; package api; message Second {}",
+		"unrelated.proto":  "package unrelated; message {",
+	})
+	executor := &captureExecutor{}
+	app := New(Options{Logger: logger.NewNop(), Inputs: Inputs{InputFilesDir: []InputFilesDir{{Root: ".", Path: "."}}}, Plugins: []Plugin{
+		{Source: PluginSource{Name: "custom-plugin"}, WithImports: true},
+		{Source: PluginSource{Name: "custom-plugin"}},
+	}})
+	app.localExecutor = executor
+	plan, err := app.PrepareGenerationFiles(t.Context(), root, []string{"api/first.proto", "api/second.proto"})
+	require.NoError(t, err)
+	assert.Equal(t, []string{"shared.proto", "api/first.proto", "api/second.proto"}, descriptorNames(plan.DescriptorSet(true).File))
+	assert.Equal(t, []string{"api/first.proto", "api/second.proto"}, descriptorNames(plan.DescriptorSet(false).File))
+	require.NoError(t, plan.Execute(t.Context()))
+	require.Len(t, executor.requests, 2)
+	assert.ElementsMatch(t, []string{"api/first.proto", "api/second.proto", "shared.proto"}, executor.requests[0].FileToGenerate)
+	assert.Equal(t, []string{"api/first.proto", "api/second.proto"}, executor.requests[1].FileToGenerate)
+	_, err = app.PrepareGenerationFiles(t.Context(), root, []string{"absent.proto"})
+	require.ErrorContains(t, err, "outside the module inputs")
+	_, err = app.PrepareGenerationFiles(t.Context(), root, nil)
+	require.ErrorIs(t, err, ErrEmptyInputFiles)
+	_, err = app.PrepareGeneration(t.Context(), root)
+	require.Error(t, err)
+}
diff --git a/internal/core/generate_v1_roots_test.go b/internal/core/generate_v1_roots_test.go
new file mode 100644
index 00000000..6c2cea91
--- /dev/null
+++ b/internal/core/generate_v1_roots_test.go
@@ -0,0 +1,45 @@
+package core
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestGenerateV1IncludesDeclaredSourceRootWithModuleConfig(t *testing.T) {
+	t.Parallel()
+
+	for _, tc := range []struct {
+		name   string
+		config string
+	}{
+		{name: "buf module", config: "buf.yaml"},
+		{name: "buf workspace", config: "buf.work.yaml"},
+		{name: "easyp module", config: "protobuf.mod"},
+	} {
+		t.Run(tc.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			sourceRoot := filepath.Join(root, "proto")
+			writeTestProto(t, sourceRoot, "item.proto")
+			err := os.WriteFile(filepath.Join(sourceRoot, tc.config), nil, 0o644)
+			require.NoError(t, err)
+
+			writeTestProto(t, sourceRoot, "nested/ignored.proto")
+			err = os.WriteFile(filepath.Join(sourceRoot, "nested", "buf.yaml"), nil, 0o644)
+			require.NoError(t, err)
+
+			executor := &captureExecutor{}
+			app := testCoreWithPlugins([]Plugin{{Source: PluginSource{Name: "custom-plugin"}}}, executor)
+			app.inputs.InputFilesDir = []InputFilesDir{{Root: "proto", Path: "."}}
+
+			err = app.Generate(t.Context(), root, "", false)
+			require.NoError(t, err)
+			require.Len(t, executor.requests, 1)
+			require.Equal(t, []string{"item.proto"}, executor.requests[0].GetFileToGenerate())
+		})
+	}
+}
diff --git a/internal/core/get.go b/internal/core/get.go
deleted file mode 100644
index 2ba7bd36..00000000
--- a/internal/core/get.go
+++ /dev/null
@@ -1,153 +0,0 @@
-package core
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"log/slog"
-
-	"github.com/easyp-tech/easyp/internal/adapters/repository/git"
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-// Get download package.
-func (c *Core) Get(ctx context.Context, requestedModule models.Module) error {
-	log := c.logger.With(slog.String("module", requestedModule.Name), slog.String("version", string(requestedModule.Version)))
-	cacheDownloadPaths := c.storage.GetCacheDownloadPaths(requestedModule.Name, string(requestedModule.Version))
-
-	var installedModuleInfo models.InstalledModuleInfo
-	var err error
-	needToInstall := false
-
-	installedModuleInfo, err = c.storage.ReadInstalledModuleInfo(cacheDownloadPaths)
-	if err != nil {
-		if !errors.Is(err, models.ErrModuleInfoFileNotFound) {
-			return fmt.Errorf("c.storage.ReadInstalledModuleInfo: %w", err)
-		}
-
-		needToInstall = true
-	}
-
-	if !needToInstall {
-		if err := c.checkInstalledPackage(ctx, requestedModule, installedModuleInfo); err != nil {
-			return fmt.Errorf("c.checkInstalledPackage: %w", err)
-		}
-
-		log.Debug(ctx, "module already installed")
-	} else {
-		installedModuleInfo, err = c.get(ctx, requestedModule)
-		if err != nil {
-			return fmt.Errorf("c.get: %w", err)
-		}
-	}
-
-	if err := c.lockFile.Write(
-		requestedModule.Name, installedModuleInfo.RevisionVersion, installedModuleInfo.Hash,
-	); err != nil {
-		return fmt.Errorf("c.lockFile.Write: %w", err)
-	}
-
-	return nil
-}
-
-func (c *Core) get(ctx context.Context, requestedModule models.Module) (models.InstalledModuleInfo, error) {
-	cacheRepositoryDir, err := c.storage.CreateCacheRepositoryDir(requestedModule.Name)
-	if err != nil {
-		return models.InstalledModuleInfo{}, fmt.Errorf("c.storage.CreateCacheRepositoryDir: %w", err)
-	}
-	// TODO: use factory (git, svn etc)
-	repo, err := git.New(ctx, requestedModule.Name, cacheRepositoryDir, c.console)
-	if err != nil {
-		return models.InstalledModuleInfo{}, fmt.Errorf("git.New: %w", err)
-	}
-
-	revision, err := repo.ReadRevision(ctx, requestedModule.Version)
-	if err != nil {
-		return models.InstalledModuleInfo{}, fmt.Errorf("repository.ReadRevision: %w", err)
-	}
-
-	cacheDownloadPaths := c.storage.GetCacheDownloadPaths(requestedModule.Name, revision.Version)
-
-	if err := c.storage.CreateCacheDownloadDir(cacheDownloadPaths); err != nil {
-		return models.InstalledModuleInfo{}, fmt.Errorf("c.storage.CreateCacheDownloadDir: %w", err)
-	}
-
-	if err := repo.Fetch(ctx, revision); err != nil {
-		return models.InstalledModuleInfo{}, fmt.Errorf("repository.Fetch: %w", err)
-	}
-
-	moduleConfig, err := c.moduleConfig.ReadFromRepo(ctx, repo, revision)
-	if err != nil {
-		return models.InstalledModuleInfo{}, fmt.Errorf("c.moduleConfig.Read: %w", err)
-	}
-
-	log := c.logger.With(slog.String("module", requestedModule.Name), slog.String("version", string(requestedModule.Version)))
-
-	for _, indirectDep := range moduleConfig.Dependencies {
-		if err := c.Get(ctx, indirectDep); err != nil {
-			if errors.Is(err, models.ErrVersionNotFound) {
-				log.Error(ctx, "indirect dependency version not found", slog.Any("dependency", indirectDep))
-				return models.InstalledModuleInfo{}, models.ErrVersionNotFound
-			}
-
-			return models.InstalledModuleInfo{}, fmt.Errorf("c.Get: %w", err)
-		}
-	}
-
-	// check package deps (that was read from repo)
-	// compare versions
-
-	if err := repo.Archive(ctx, revision, cacheDownloadPaths.ArchiveFile); err != nil {
-		return models.InstalledModuleInfo{}, fmt.Errorf("repository.Archive: %w", err)
-	}
-
-	moduleHash, err := c.storage.Install(ctx, cacheDownloadPaths, requestedModule, revision, moduleConfig)
-	if err != nil {
-		return models.InstalledModuleInfo{}, fmt.Errorf("c.storage.Install: %w", err)
-	}
-
-	log.Debug(ctx, "module installed",
-		slog.String("hash", string(moduleHash)),
-	)
-
-	installedModuleInfo := models.InstalledModuleInfo{
-		ModuleName:      requestedModule.Name,
-		Hash:            moduleHash,
-		RevisionVersion: revision.Version,
-	}
-	if err := c.storage.WriteInstalledModuleInfo(cacheDownloadPaths, installedModuleInfo); err != nil {
-		return models.InstalledModuleInfo{}, fmt.Errorf("c.storage.WriteInstalledModuleInfo: %w", err)
-	}
-
-	return installedModuleInfo, nil
-}
-
-// checkInstalledPackage checked if installed version is valid
-func (c *Core) checkInstalledPackage(
-	ctx context.Context, requestedModule models.Module, installedModuleInfo models.InstalledModuleInfo,
-) error {
-	lockFileInfo, err := c.lockFile.Read(requestedModule.Name)
-	if err != nil {
-		if errors.Is(err, models.ErrModuleNotFoundInLockFile) {
-			// not in lock file have no to compare with
-			return nil
-		}
-
-		return fmt.Errorf("c.lockFile.Read: %w", err)
-	}
-
-	if lockFileInfo.Version == string(requestedModule.Version) {
-		c.logger.Debug(ctx, "version matched, checking hash",
-			slog.String("module", requestedModule.Name),
-			slog.String("version", string(requestedModule.Version)),
-		)
-
-		if lockFileInfo.Hash != installedModuleInfo.Hash {
-			return models.ErrHashDependencyMismatch
-		}
-	}
-
-	// TODO: calc hash
-
-	return nil
-}
diff --git a/internal/core/go_package_output.go b/internal/core/go_package_output.go
new file mode 100644
index 00000000..0c65488f
--- /dev/null
+++ b/internal/core/go_package_output.go
@@ -0,0 +1,194 @@
+package core
+
+import (
+	"path/filepath"
+	"strings"
+
+	"google.golang.org/protobuf/types/descriptorpb"
+	"google.golang.org/protobuf/types/pluginpb"
+)
+
+// goPackageOutputDirs uses the final descriptor options and the plugin's import
+// mappings. Packages outside the prefix keep their plugin paths.
+func goPackageOutputDirs(prefix string, files []string, descriptors []*descriptorpb.FileDescriptorProto, options map[string][]string) map[string]string {
+	if template, _, marker := strings.Cut(prefix, "{{"); marker {
+		separator := strings.LastIndex(template, "/")
+		if separator < 0 {
+			return nil
+		}
+		prefix = template[:separator]
+	}
+	prefix = strings.TrimRight(prefix, "/")
+	if prefix == "" {
+		return nil
+	}
+	targets := make(map[string]bool, len(files))
+	for _, file := range files {
+		targets[file] = true
+	}
+	directories := make(map[string]string)
+	for _, descriptor := range descriptors {
+		if !targets[descriptor.GetName()] {
+			continue
+		}
+		importPath, _, _ := strings.Cut(descriptor.GetOptions().GetGoPackage(), ";")
+		// protogen keeps the last nonempty M import path. Alias-only and empty
+		// mappings leave a previous mapping or the descriptor import in place.
+		for _, mapping := range options["M"+descriptor.GetName()] {
+			if mappedImport, _, _ := strings.Cut(mapping, ";"); mappedImport != "" {
+				importPath = mappedImport
+			}
+		}
+		if importPath == prefix {
+			directories[descriptor.GetName()] = "."
+			continue
+		}
+		if directory, ok := strings.CutPrefix(importPath, prefix+"/"); ok {
+			directories[descriptor.GetName()] = directory
+		}
+	}
+	return directories
+}
+
+func goPackageOutputPath(file *pluginpb.CodeGeneratorResponse_File, directories map[string]string) string {
+	name := file.GetName()
+	if len(directories) == 0 || !strings.HasSuffix(name, ".go") {
+		return name
+	}
+	// Go and Go gRPC headers disambiguate user_grpc.proto from the gRPC
+	// companion of user.proto. Plugins without that header use the longest basename.
+	declaredSource := goPackageOutputSource(file.GetContent())
+	outputDir := filepath.ToSlash(filepath.Dir(name))
+	outputBase := filepath.Base(name)
+	longestBase := ""
+	output := name
+	for source, directory := range directories {
+		if declaredSource != "" && source != declaredSource {
+			continue
+		}
+		if outputDir != filepath.ToSlash(filepath.Dir(source)) {
+			continue
+		}
+		base := strings.TrimSuffix(filepath.Base(source), ".proto")
+		if !strings.HasPrefix(outputBase, base+".") && !strings.HasPrefix(outputBase, base+"_") {
+			continue
+		}
+		if len(base) > len(longestBase) {
+			longestBase = base
+			output = filepath.ToSlash(filepath.Join(directory, outputBase))
+		}
+	}
+	return output
+}
+
+func goPackageOutputSource(content string) string {
+	// Go plugins copy proto comments that may themselves contain a generated
+	// marker. Prefer their versioned header before falling back to older headers.
+	if source, ok := goPackageOutputProtocSource(content); ok {
+		return source
+	}
+
+	var sourceOnly string
+	generatedHeader := false
+	for line := range strings.Lines(content) {
+		line = strings.TrimSpace(line)
+		if strings.HasPrefix(line, "package ") {
+			break
+		}
+		if strings.HasPrefix(line, "// Code generated ") && strings.HasSuffix(line, " DO NOT EDIT.") {
+			generatedHeader = true
+			continue
+		}
+		// The generator header is one comment block. Detached source or package
+		// comments may contain source lines before and after this block.
+		if generatedHeader && !strings.HasPrefix(line, "//") {
+			break
+		}
+		if source, ok := strings.CutPrefix(line, "// source: "); ok {
+			if generatedHeader {
+				return strings.TrimSpace(source)
+			}
+			if sourceOnly == "" {
+				sourceOnly = strings.TrimSpace(source)
+			}
+		}
+	}
+	if generatedHeader {
+		return ""
+	}
+	// Retain source-only headers used by plugins without a generated marker.
+	return sourceOnly
+}
+
+func goPackageOutputProtocSource(content string) (string, bool) {
+	type header struct {
+		generator string
+		comments  []string
+	}
+	var headers []header
+	currentHeader := -1
+	for line := range strings.Lines(content) {
+		line = strings.TrimSpace(line)
+		if strings.HasPrefix(line, "package ") {
+			break
+		}
+		var generator string
+		switch line {
+		case "// Code generated by protoc-gen-go. DO NOT EDIT.":
+			generator = "protoc-gen-go"
+		case "// Code generated by protoc-gen-go-grpc. DO NOT EDIT.":
+			generator = "protoc-gen-go-grpc"
+		}
+		if generator != "" {
+			headers = append(headers, header{generator: generator})
+			currentHeader = len(headers) - 1
+			continue
+		}
+		if currentHeader < 0 {
+			continue
+		}
+		// End at the first block boundary even when the header has no source.
+		// Package comments following it belong to the proto author.
+		if !strings.HasPrefix(line, "//") {
+			currentHeader = -1
+			continue
+		}
+		headers[currentHeader].comments = append(headers[currentHeader].comments, line)
+	}
+
+	var fallbackSource string
+	for i, header := range headers {
+		var source string
+		for _, line := range header.comments {
+			if declaredSource, ok := strings.CutPrefix(line, "// source: "); ok {
+				source = strings.TrimSpace(declaredSource)
+				break
+			}
+		}
+		if i == 0 {
+			fallbackSource = source
+		}
+		// Both pinned Go generators put the versions label, generator version,
+		// and protoc version immediately after their marker. A copied marker
+		// alone does not have this structure. Prefer the first complete header
+		// so later package comments cannot replace its source.
+		if len(header.comments) >= 3 && header.comments[0] == "// versions:" &&
+			goPackageOutputVersionRow(header.comments[1], header.generator) &&
+			goPackageOutputVersionRow(header.comments[2], "protoc") {
+			return source, true
+		}
+	}
+	return fallbackSource, len(headers) > 0
+}
+
+func goPackageOutputVersionRow(line, generator string) bool {
+	fields := strings.Fields(strings.TrimPrefix(line, "//"))
+	if len(fields) > 0 && fields[0] == "-" {
+		fields = fields[1:]
+	}
+	if len(fields) != 2 || fields[0] != generator {
+		return false
+	}
+	version := fields[1]
+	return version == "(unknown)" || len(version) > 1 && version[0] == 'v' && version[1] >= '0' && version[1] <= '9'
+}
diff --git a/internal/core/go_package_output_test.go b/internal/core/go_package_output_test.go
new file mode 100644
index 00000000..332c46e1
--- /dev/null
+++ b/internal/core/go_package_output_test.go
@@ -0,0 +1,189 @@
+package core
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"google.golang.org/protobuf/proto"
+	"google.golang.org/protobuf/types/descriptorpb"
+	"google.golang.org/protobuf/types/pluginpb"
+)
+
+func TestGoPackageOutputPath(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name    string
+		output  string
+		content string
+		want    string
+	}{
+		{name: "source relative collision", output: "v1/user.pb.go", want: "user/v1/user.pb.go"},
+		{name: "grpc companion", output: "v1/user_grpc.pb.go", content: "// source: v1/user.proto\npackage userv1\n", want: "user/v1/user_grpc.pb.go"},
+		{name: "already package relative", output: "order/v1/order.pb.go", want: "order/v1/order.pb.go"},
+		{name: "non go output", output: "v1/user_pb2.py", want: "v1/user_pb2.py"},
+		{name: "disabled option keeps effective directory", output: "api/models.pb.go", want: "api/models.pb.go"},
+		{name: "marker directory follows effective import", output: "api/marker.pb.go", want: "api/marker/marker.pb.go"},
+		{name: "longer proto basename", output: "v1/user_types.pb.go", want: "types/v1/user_types.pb.go"},
+		{name: "import relative plugin output", output: "example.test/generated/user/v1/user.pb.go", want: "example.test/generated/user/v1/user.pb.go"},
+		{name: "unknown source header", output: "v1/user.pb.go", content: "// source: dependency.proto\npackage dep\n", want: "v1/user.pb.go"},
+		{name: "proto shares the grpc suffix", output: "v1/user_grpc.pb.go", content: "// source: v1/user_grpc.proto\npackage typesv1\n", want: "types/v1/user_grpc.pb.go"},
+		{name: "body comments are not a source header", output: "v1/user.pb.go", content: "package userv1\n// source: dependency.proto\n", want: "user/v1/user.pb.go"},
+		{
+			name: "copied leading source URL", output: "v1/user.pb.go",
+			content: "// source: https://example.test/original\n\n// Code generated by protoc-gen-go. DO NOT EDIT.\n// versions:\n// protoc-gen-go v1.36.11\n// source: v1/user.proto\n\npackage userv1\n",
+			want:    "user/v1/user.pb.go",
+		},
+		{
+			name: "copied leading source names another target", output: "v1/user.pb.go",
+			content: "// source: order/v1/order.proto\n\n// Code generated by protoc-gen-go. DO NOT EDIT.\n// source: v1/user.proto\n\npackage userv1\n",
+			want:    "user/v1/user.pb.go",
+		},
+		{
+			name: "copied package source follows generator header", output: "v1/user_grpc.pb.go",
+			content: "// Code generated by protoc-gen-go-grpc. DO NOT EDIT.\n// source: v1/user.proto\n\n// source: v1/user_grpc.proto\npackage userv1\n",
+			want:    "user/v1/user_grpc.pb.go",
+		},
+		{
+			name: "copied leading source overlaps the grpc basename", output: "v1/user_grpc.pb.go",
+			content: "// source: v1/user_grpc.proto\n\n// Code generated by protoc-gen-go-grpc. DO NOT EDIT.\n// source: v1/user.proto\n\npackage userv1\n",
+			want:    "user/v1/user_grpc.pb.go",
+		},
+		{
+			name: "generator header without source ignores copied package source", output: "v1/user.pb.go",
+			content: "// Code generated by custom. DO NOT EDIT.\n\n// source: dependency.proto\npackage userv1\n",
+			want:    "user/v1/user.pb.go",
+		},
+		{
+			name: "copied unrelated generated marker before Go header", output: "v1/user.pb.go",
+			content: "// Code generated by another schema tool. DO NOT EDIT.\n// source: upstream.json\n\n// Code generated by protoc-gen-go. DO NOT EDIT.\n// source: v1/user.proto\n\n// Code generated by package comment tool. DO NOT EDIT.\n// source: order/v1/order.proto\npackage userv1\n",
+			want:    "user/v1/user.pb.go",
+		},
+		{
+			name: "copied unrelated generated marker before grpc header", output: "v1/user_grpc.pb.go",
+			content: "// Code generated by another schema tool. DO NOT EDIT.\n// source: v1/user_grpc.proto\n\n// Code generated by protoc-gen-go-grpc. DO NOT EDIT.\n// source: v1/user.proto\n\n// source: v1/user_grpc.proto\npackage userv1\n",
+			want:    "user/v1/user_grpc.pb.go",
+		},
+		{
+			name: "known header without source ignores copied generated markers", output: "v1/user.pb.go",
+			content: "// Code generated by another schema tool. DO NOT EDIT.\n// source: upstream.json\n\n// Code generated by protoc-gen-go. DO NOT EDIT.\n// v1/user.proto is a deprecated file.\n\n// Code generated by package comment tool. DO NOT EDIT.\n// source: dependency.proto\npackage userv1\n",
+			want:    "user/v1/user.pb.go",
+		},
+		{
+			name: "custom marked header keeps source disambiguation", output: "v1/user_grpc.pb.go",
+			content: "// Code generated by custom. DO NOT EDIT.\n// source: v1/user.proto\n\n// source: v1/user_grpc.proto\npackage userv1\n",
+			want:    "user/v1/user_grpc.pb.go",
+		},
+		{
+			name: "versioned Go header follows copied exact marker", output: "v1/user.pb.go",
+			content: "// Code generated by protoc-gen-go. DO NOT EDIT.\n// source: upstream.json\n\n// Code generated by protoc-gen-go. DO NOT EDIT.\n// versions:\n// protoc-gen-go v1.36.11\n// protoc v0.14.1-easyp\n// source: v1/user.proto\n\n// source: order/v1/order.proto\npackage userv1\n",
+			want:    "user/v1/user.pb.go",
+		},
+		{
+			name: "versioned grpc header follows copied exact marker naming another descriptor", output: "v1/user_grpc.pb.go",
+			content: "// Code generated by protoc-gen-go-grpc. DO NOT EDIT.\n// source: v1/user_grpc.proto\n\n// Code generated by protoc-gen-go-grpc. DO NOT EDIT.\n// versions:\n// - protoc-gen-go-grpc v1.5.1\n// - protoc v0.14.1-easyp\n// source: v1/user.proto\n\n// Code generated by protoc-gen-go-grpc. DO NOT EDIT.\n// source: v1/user_grpc.proto\npackage userv1\n",
+			want:    "user/v1/user_grpc.pb.go",
+		},
+		{
+			name: "versioned header requires compiler version row", output: "v1/user.pb.go",
+			content: "// Code generated by protoc-gen-go. DO NOT EDIT.\n// versions:\n// protoc-gen-go v1.36.11\n// source: upstream.json\n\n// Code generated by protoc-gen-go. DO NOT EDIT.\n// versions:\n// protoc-gen-go v1.36.11\n// protoc v0.14.1-easyp\n// source: v1/user.proto\n\npackage userv1\n",
+			want:    "user/v1/user.pb.go",
+		},
+		{
+			name: "versioned header requires matching generator version row", output: "v1/user.pb.go",
+			content: "// Code generated by protoc-gen-go. DO NOT EDIT.\n// versions:\n// protoc-gen-go-grpc v1.5.1\n// protoc v0.14.1-easyp\n// source: upstream.json\n\n// Code generated by protoc-gen-go. DO NOT EDIT.\n// versions:\n// protoc-gen-go v1.36.11\n// protoc v0.14.1-easyp\n// source: v1/user.proto\n\npackage userv1\n",
+			want:    "user/v1/user.pb.go",
+		},
+		{
+			name: "versioned deprecated header ignores copied exact marker sources", output: "v1/user.pb.go",
+			content: "// Code generated by protoc-gen-go. DO NOT EDIT.\n// source: upstream.json\n\n// Code generated by protoc-gen-go. DO NOT EDIT.\n// versions:\n// protoc-gen-go v1.36.11\n// protoc (unknown)\n// v1/user.proto is a deprecated file.\n\n// source: dependency.proto\npackage userv1\n",
+			want:    "user/v1/user.pb.go",
+		},
+		{
+			name: "unversioned known header keeps old plugin compatibility", output: "v1/user_grpc.pb.go",
+			content: "// Code generated by protoc-gen-go-grpc. DO NOT EDIT.\n// source: v1/user.proto\n\n// source: v1/user_grpc.proto\npackage userv1\n",
+			want:    "user/v1/user_grpc.pb.go",
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			directories := map[string]string{
+				"v1/user.proto": "user/v1", "order/v1/order.proto": "order/v1",
+				"api/models.proto": "api", "api/marker.proto": "api/marker",
+				"v1/user_types.proto": "types/v1", "v1/user_grpc.proto": "types/v1",
+			}
+			file := &pluginpb.CodeGeneratorResponse_File{Name: proto.String(tt.output), Content: proto.String(tt.content)}
+
+			assert.Equal(t, tt.want, goPackageOutputPath(file, directories))
+		})
+	}
+}
+
+func TestGoPackageOutputDirs(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name     string
+		prefix   string
+		packages map[string]string
+		files    []string
+		want     map[string]string
+	}{
+		{
+			name: "effective package alias is not part of the directory", prefix: "example.test/generated",
+			packages: map[string]string{"api/models.proto": "example.test/generated/custom;custom"},
+			files:    []string{"api/models.proto"}, want: map[string]string{"api/models.proto": "custom"},
+		},
+		{
+			name: "only plugin targets are mapped", prefix: "example.test/generated",
+			packages: map[string]string{"api/models.proto": "example.test/generated/api", "dep.proto": "example.test/generated/dependency"},
+			files:    []string{"api/models.proto"}, want: map[string]string{"api/models.proto": "api"},
+		},
+		{
+			name: "external package keeps its plugin location", prefix: "example.test/generated",
+			packages: map[string]string{"dep.proto": "example.test/other/dep"},
+			files:    []string{"dep.proto"}, want: map[string]string{},
+		},
+		{
+			name: "import prefix boundary", prefix: "example.test/gen",
+			packages: map[string]string{"dep.proto": "example.test/generated/dep"},
+			files:    []string{"dep.proto"}, want: map[string]string{},
+		},
+		{
+			name: "SDK root package", prefix: "example.test/generated",
+			packages: map[string]string{"root.proto": "example.test/generated;root"},
+			files:    []string{"root.proto"}, want: map[string]string{"root.proto": "."},
+		},
+		{
+			name: "marker uses stable parent", prefix: "example.test/generated/{{file_path}}",
+			packages: map[string]string{"api/models.proto": "example.test/generated/api/models"},
+			files:    []string{"api/models.proto"}, want: map[string]string{"api/models.proto": "api/models"},
+		},
+		{
+			name: "marker can share a segment with literal text", prefix: "example.test/generated/prefix_{{file_dir}}",
+			packages: map[string]string{"api/models.proto": "example.test/generated/prefix_api"},
+			files:    []string{"api/models.proto"}, want: map[string]string{"api/models.proto": "prefix_api"},
+		},
+		{name: "empty prefix"},
+		{name: "marker without a stable parent", prefix: "{{file_path}}"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			var descriptors []*descriptorpb.FileDescriptorProto
+			for file, goPackage := range tt.packages {
+				descriptors = append(descriptors, &descriptorpb.FileDescriptorProto{
+					Name: proto.String(file), Options: &descriptorpb.FileOptions{GoPackage: proto.String(goPackage)},
+				})
+			}
+
+			directories := goPackageOutputDirs(tt.prefix, tt.files, descriptors, nil)
+
+			assert.Equal(t, tt.want, directories)
+		})
+	}
+}
diff --git a/internal/core/init.go b/internal/core/init.go
deleted file mode 100644
index 393f5da9..00000000
--- a/internal/core/init.go
+++ /dev/null
@@ -1,247 +0,0 @@
-package core
-
-import (
-	"bytes"
-	"context"
-	"fmt"
-
-	"gopkg.in/yaml.v3"
-
-	"github.com/easyp-tech/easyp/internal/config"
-)
-
-type (
-	// BUFConfig is the configuration for the buf tool.
-	BUFConfig struct {
-		Version  string   `yaml:"version"`
-		Deps     []string `yaml:"deps"`
-		Build    Build    `yaml:"build"`
-		Lint     Lint     `yaml:"lint"`
-		Breaking Breaking `yaml:"breaking"`
-	}
-
-	// Build is the configuration for the build section of the buf tool.
-	Build struct {
-		Excludes []string `yaml:"excludes"`
-	}
-
-	// Lint is the configuration for the lint section of the buf tool.
-	Lint struct {
-		Use                                  []string            `yaml:"use"`
-		Except                               []string            `yaml:"except"`
-		Ignore                               []string            `yaml:"ignore"`
-		IgnoreOnly                           map[string][]string `yaml:"ignore_only"`
-		AllowCommentIgnores                  bool                `yaml:"allow_comment_ignores"`
-		EnumZeroValueSuffix                  string              `yaml:"enum_zero_value_suffix"`
-		RPCAllowSameRequestResponse          bool                `yaml:"rpc_allow_same_request_response"`
-		RPCAllowGoogleProtobufEmptyRequests  bool                `yaml:"rpc_allow_google_protobuf_empty_requests"`
-		RPCAllowGoogleProtobufEmptyResponses bool                `yaml:"rpc_allow_google_protobuf_empty_responses"`
-		ServiceSuffix                        string              `yaml:"service_suffix"`
-	}
-
-	// Breaking is the configuration for the breaking section of the buf tool.
-	Breaking struct {
-		Use                    []string            `yaml:"use"`
-		Except                 []string            `yaml:"except"`
-		Ignore                 []string            `yaml:"ignore"`
-		IgnoreOnly             map[string][]string `yaml:"ignore_only"`
-		IgnoreUnstablePackages bool                `yaml:"ignore_unstable_packages"`
-	}
-
-	// Migrate contains original configuration for the migration.
-	Migrate struct {
-		BUF *BUFConfig
-		//Protoool *ProtooolConfig TODO
-	}
-)
-
-// InitOptions contains options for the Initialize command.
-type InitOptions struct {
-	TemplateData InitTemplateData
-	Prompter     Prompter
-}
-
-// Prompter provides an interface for interactive user interaction.
-type Prompter interface {
-	// Confirm asks a yes/no question. Returns true if the user answered "yes".
-	Confirm(ctx context.Context, message string, defaultValue bool) (bool, error)
-}
-
-// Initialize initializes the EasyP configuration.
-func (c *Core) Initialize(ctx context.Context, disk DirWalker, opts InitOptions) (err error) {
-	cfg := configFromTemplateData(opts.TemplateData)
-
-	// Check for buf config only in root directory (not recursive).
-	var migrated bool
-	for _, bufConfigName := range []string{"buf.yml", "buf.yaml"} {
-		if !disk.Exists(bufConfigName) {
-			continue
-		}
-
-		migrate, promptErr := opts.Prompter.Confirm(ctx, "Found "+bufConfigName+". Migrate configuration?", true)
-		if promptErr != nil {
-			return fmt.Errorf("prompter.Confirm: %w", promptErr)
-		}
-		if !migrate {
-			continue
-		}
-
-		migrated = true
-		if migrateErr := c.migrateFromBUF(ctx, disk, bufConfigName, cfg); migrateErr != nil {
-			return fmt.Errorf("migrateFromBUF: %w", migrateErr)
-		}
-
-		break
-	}
-
-	if !migrated {
-		filename := "easyp.yaml"
-
-		// Check for existing config (overwrite protection).
-		if disk.Exists(filename) {
-			overwrite, promptErr := opts.Prompter.Confirm(ctx, filename+" already exists. Overwrite?", false)
-			if promptErr != nil {
-				return fmt.Errorf("prompter.Confirm: %w", promptErr)
-			}
-			if !overwrite {
-				return nil
-			}
-		}
-
-		res, createErr := disk.Create(filename)
-		if createErr != nil {
-			return fmt.Errorf("disk.Create: %w", createErr)
-		}
-		defer func() {
-			if closeErr := res.Close(); closeErr != nil && err == nil {
-				err = fmt.Errorf("res.Close: %w", closeErr)
-			}
-		}()
-
-		// Render to buffer and validate before writing to disk.
-		var buf bytes.Buffer
-		if renderErr := renderInitConfig(&buf, opts.TemplateData); renderErr != nil {
-			return fmt.Errorf("renderInitConfig: %w", renderErr)
-		}
-
-		if issues, valErr := config.ValidateRaw(buf.Bytes()); valErr != nil {
-			return fmt.Errorf("config.ValidateRaw: %w", valErr)
-		} else if config.HasErrors(issues) {
-			return fmt.Errorf("generated config has validation errors: %v", issues)
-		}
-
-		if _, writeErr := res.Write(buf.Bytes()); writeErr != nil {
-			return fmt.Errorf("res.Write: %w", writeErr)
-		}
-	}
-
-	return nil
-}
-
-// configFromTemplateData creates a config.Config from template data (used for buf migration).
-func configFromTemplateData(data InitTemplateData) config.Config {
-	var allRules []string
-	for _, g := range data.LintGroups {
-		allRules = append(allRules, g.Rules...)
-	}
-
-	return config.Config{
-		Lint: config.LintConfig{
-			Use:                 allRules,
-			AllowCommentIgnores: false,
-			EnumZeroValueSuffix: data.EnumZeroValueSuffix,
-			ServiceSuffix:       data.ServiceSuffix,
-		},
-		BreakingCheck: config.BreakingCheck{
-			AgainstGitRef: data.AgainstGitRef,
-		},
-	}
-}
-
-func (c *Core) migrateFromBUF(ctx context.Context, disk FS, path string, defaultConfiguration config.Config) (err error) {
-	f, err := disk.Open(path)
-	if err != nil {
-		return fmt.Errorf("disk.Open: %w", err)
-	}
-	defer func() {
-		closeErr := f.Close()
-		if closeErr != nil {
-			err = fmt.Errorf("disk.Close: %w: original error: %w", closeErr, err)
-		}
-	}()
-
-	b := BUFConfig{}
-
-	err = yaml.NewDecoder(f).Decode(&b)
-	if err != nil {
-		return fmt.Errorf("yaml.NewDecoder.Decode: %w", err)
-	}
-
-	// Log unsupported fields.
-	if len(b.Build.Excludes) > 0 {
-		c.logger.Warn(ctx, "buf build.excludes is not supported in easyp, skipping")
-	}
-	if len(b.Breaking.Use) > 0 {
-		c.logger.Warn(ctx, "buf breaking.use granular rules not yet supported, using default breaking check")
-	}
-
-	migratedCfg := buildCfgFromBUF(defaultConfiguration, b)
-
-	// Encode to buffer and validate before writing to disk.
-	var buf bytes.Buffer
-	err = yaml.NewEncoder(&buf).Encode(migratedCfg)
-	if err != nil {
-		return fmt.Errorf("yaml.NewEncoder.Encode: %w", err)
-	}
-
-	if issues, valErr := config.ValidateRaw(buf.Bytes()); valErr != nil {
-		return fmt.Errorf("config.ValidateRaw: %w", valErr)
-	} else if config.HasErrors(issues) {
-		return fmt.Errorf("migrated config has validation errors: %v", issues)
-	}
-
-	res, err := disk.Create("easyp.yaml")
-	if err != nil {
-		return fmt.Errorf("disk.Create: %w", err)
-	}
-	defer func() {
-		if closeErr := res.Close(); closeErr != nil && err == nil {
-			err = fmt.Errorf("res.Close: %w", closeErr)
-		}
-	}()
-
-	if _, writeErr := res.Write(buf.Bytes()); writeErr != nil {
-		return fmt.Errorf("res.Write: %w", writeErr)
-	}
-
-	return nil
-}
-
-func buildCfgFromBUF(cfg config.Config, bufConfig BUFConfig) config.Config {
-	result := config.Config{
-		Deps: bufConfig.Deps,
-		Lint: config.LintConfig{
-			Use:                 bufConfig.Lint.Use,
-			Except:              bufConfig.Lint.Except,
-			Ignore:              bufConfig.Lint.Ignore,
-			IgnoreOnly:          bufConfig.Lint.IgnoreOnly,
-			AllowCommentIgnores: bufConfig.Lint.AllowCommentIgnores,
-			EnumZeroValueSuffix: bufConfig.Lint.EnumZeroValueSuffix,
-			ServiceSuffix:       bufConfig.Lint.ServiceSuffix,
-		},
-		BreakingCheck: config.BreakingCheck{
-			AgainstGitRef: cfg.BreakingCheck.AgainstGitRef,
-			Ignore:        bufConfig.Breaking.Ignore,
-		},
-	}
-
-	// Use defaults from the base config when buf config has empty values.
-	if result.Lint.EnumZeroValueSuffix == "" {
-		result.Lint.EnumZeroValueSuffix = cfg.Lint.EnumZeroValueSuffix
-	}
-	if result.Lint.ServiceSuffix == "" {
-		result.Lint.ServiceSuffix = cfg.Lint.ServiceSuffix
-	}
-
-	return result
-}
diff --git a/internal/core/init_template.go b/internal/core/init_template.go
deleted file mode 100644
index b72ab804..00000000
--- a/internal/core/init_template.go
+++ /dev/null
@@ -1,35 +0,0 @@
-package core
-
-import (
-	_ "embed"
-	"fmt"
-	"io"
-	"text/template"
-)
-
-//go:embed templates/easyp.yaml.tmpl
-var initTemplate string
-
-// InitTemplateData contains data for rendering the easyp.yaml template.
-type InitTemplateData struct {
-	LintGroups          []LintGroup
-	EnumZeroValueSuffix string
-	ServiceSuffix       string
-	AgainstGitRef       string
-}
-
-// LintGroup is a group of lint rules with a name and a list of rules.
-type LintGroup struct {
-	Name  string   // "Minimal", "Basic", "Default", "Comments", "Unary RPC"
-	Rules []string // ["DIRECTORY_SAME_PACKAGE", "PACKAGE_DEFINED", ...]
-}
-
-// renderInitConfig renders the easyp.yaml template to the given writer.
-func renderInitConfig(w io.Writer, data InitTemplateData) error {
-	tmpl, err := template.New("easyp.yaml").Parse(initTemplate)
-	if err != nil {
-		return fmt.Errorf("template.Parse: %w", err)
-	}
-
-	return tmpl.Execute(w, data)
-}
diff --git a/internal/core/init_template_test.go b/internal/core/init_template_test.go
deleted file mode 100644
index c67f17be..00000000
--- a/internal/core/init_template_test.go
+++ /dev/null
@@ -1,96 +0,0 @@
-package core
-
-import (
-	"bytes"
-	"strings"
-	"testing"
-
-	"github.com/stretchr/testify/require"
-)
-
-func TestRenderInitConfig(t *testing.T) {
-	data := InitTemplateData{
-		LintGroups: []LintGroup{
-			{
-				Name:  "Minimal",
-				Rules: []string{"DIRECTORY_SAME_PACKAGE", "PACKAGE_DEFINED"},
-			},
-			{
-				Name:  "Basic",
-				Rules: []string{"ENUM_FIRST_VALUE_ZERO", "FIELD_LOWER_SNAKE_CASE"},
-			},
-		},
-		EnumZeroValueSuffix: "_NONE",
-		ServiceSuffix:       "API",
-		AgainstGitRef:       "master",
-	}
-
-	var buf bytes.Buffer
-	err := renderInitConfig(&buf, data)
-	require.NoError(t, err)
-
-	output := buf.String()
-
-	t.Run("contains group comments", func(t *testing.T) {
-		require.Contains(t, output, "# Minimal")
-		require.Contains(t, output, "# Basic")
-	})
-
-	t.Run("contains all rules", func(t *testing.T) {
-		require.Contains(t, output, "- DIRECTORY_SAME_PACKAGE")
-		require.Contains(t, output, "- PACKAGE_DEFINED")
-		require.Contains(t, output, "- ENUM_FIRST_VALUE_ZERO")
-		require.Contains(t, output, "- FIELD_LOWER_SNAKE_CASE")
-	})
-
-	t.Run("contains enum_zero_value_suffix", func(t *testing.T) {
-		require.Contains(t, output, "enum_zero_value_suffix: _NONE")
-	})
-
-	t.Run("contains service_suffix", func(t *testing.T) {
-		require.Contains(t, output, "service_suffix: API")
-	})
-
-	t.Run("contains breaking section", func(t *testing.T) {
-		require.Contains(t, output, "against_git_ref: master")
-	})
-
-	t.Run("contains documentation link", func(t *testing.T) {
-		require.Contains(t, output, "https://easyp.tech")
-	})
-
-	t.Run("is valid yaml structure", func(t *testing.T) {
-		// Verify basic YAML structure by checking indentation
-		lines := strings.Split(output, "\n")
-		foundLint := false
-		foundBreaking := false
-		for _, line := range lines {
-			if strings.TrimSpace(line) == "lint:" {
-				foundLint = true
-			}
-			if strings.TrimSpace(line) == "breaking:" {
-				foundBreaking = true
-			}
-		}
-		require.True(t, foundLint, "should contain lint: section")
-		require.True(t, foundBreaking, "should contain breaking: section")
-	})
-}
-
-func TestRenderInitConfig_EmptyGroups(t *testing.T) {
-	data := InitTemplateData{
-		LintGroups:          nil,
-		EnumZeroValueSuffix: "_UNSPECIFIED",
-		ServiceSuffix:       "Service",
-		AgainstGitRef:       "develop",
-	}
-
-	var buf bytes.Buffer
-	err := renderInitConfig(&buf, data)
-	require.NoError(t, err)
-
-	output := buf.String()
-	require.Contains(t, output, "enum_zero_value_suffix: _UNSPECIFIED")
-	require.Contains(t, output, "service_suffix: Service")
-	require.Contains(t, output, "against_git_ref: develop")
-}
diff --git a/internal/core/lint.go b/internal/core/lint.go
index b949266a..29f593a8 100644
--- a/internal/core/lint.go
+++ b/internal/core/lint.go
@@ -17,10 +17,6 @@ import (
 func (c *Core) Lint(ctx context.Context, fsWalker DirWalker) ([]IssueInfo, error) {
 	c.logger.Info(ctx, "starting lint")
 
-	if err := c.Download(ctx); err != nil {
-		return nil, fmt.Errorf("c.Download: %w", err)
-	}
-
 	var res []IssueInfo
 
 	err := fsWalker.WalkDir(func(path string, err error) error {
@@ -40,6 +36,10 @@ func (c *Core) Lint(ctx context.Context, fsWalker DirWalker) ([]IssueInfo, error
 			return fmt.Errorf("c.protoInfoRead: %w", err)
 		}
 
+		suppressions, err := c.commentSuppressions(protoInfo)
+		if err != nil {
+			return fmt.Errorf("commentSuppressions: %w", err)
+		}
 		for i := range c.rules {
 			if ctx.Err() != nil {
 				return ctx.Err()
@@ -55,6 +55,9 @@ func (c *Core) Lint(ctx context.Context, fsWalker DirWalker) ([]IssueInfo, error
 			}
 
 			for _, result := range results {
+				if c.allowCommentIgnores && suppressions.contains(result.RuleName, result.Position.Line) {
+					continue
+				}
 				res = append(res, IssueInfo{
 					Issue: result,
 					Path:  path,
@@ -101,40 +104,21 @@ func (c *Core) close(ctx context.Context, f io.Closer, path string) {
 	}
 }
 
-const (
-	// for backward compatibility with buf
-	bufLintIgnorePrefix = "buf:lint:ignore "
-	lintIgnorePrefix    = "nolint:"
-)
-
-// NOTE: Try to not use global var
-var allowCommentIgnores = true
-
-// CheckIsIgnored check if passed breakingCheckRuleName has to be ignored due to ignore command in comments
+// CheckIsIgnored recognizes exact rule tokens in declaration comments.
+// Per-policy enablement and block scopes belong to commentSuppressions.
 func CheckIsIgnored(comments []*parser.Comment, ruleName string) bool {
-	if !allowCommentIgnores {
-		return false
-	}
-
-	if len(comments) == 0 {
-		return false
-	}
-
-	bufIgnore := bufLintIgnorePrefix + ruleName
-	easypIgnore := lintIgnorePrefix + ruleName
-
 	for _, comment := range comments {
-		if strings.Contains(comment.Raw, bufIgnore) {
-			return true
-		}
-		if strings.Contains(comment.Raw, easypIgnore) {
-			return true
+		for _, line := range comment.Lines() {
+			action, rest, ok := parseDirectivePrefix(strings.TrimSpace(line))
+			if !ok || action == "enable" {
+				continue
+			}
+			for _, name := range strings.FieldsFunc(rest, func(r rune) bool { return r == ',' || r == ' ' || r == '\t' }) {
+				if name == ruleName {
+					return true
+				}
+			}
 		}
 	}
-
 	return false
 }
-
-func SetAllowCommentIgnores(val bool) {
-	allowCommentIgnores = val
-}
diff --git a/internal/core/lockfile_mock_test.go b/internal/core/lockfile_mock_test.go
deleted file mode 100644
index d438d18f..00000000
--- a/internal/core/lockfile_mock_test.go
+++ /dev/null
@@ -1,233 +0,0 @@
-// Code generated by mockery. DO NOT EDIT.
-
-package core
-
-import (
-	iter "iter"
-
-	models "github.com/easyp-tech/easyp/internal/core/models"
-	mock "github.com/stretchr/testify/mock"
-)
-
-// LockFileMock is an autogenerated mock type for the LockFile type
-type LockFileMock struct {
-	mock.Mock
-}
-
-type LockFileMock_Expecter struct {
-	mock *mock.Mock
-}
-
-func (_m *LockFileMock) EXPECT() *LockFileMock_Expecter {
-	return &LockFileMock_Expecter{mock: &_m.Mock}
-}
-
-// DepsIter provides a mock function with no fields
-func (_m *LockFileMock) DepsIter() iter.Seq[models.LockFileInfo] {
-	ret := _m.Called()
-
-	if len(ret) == 0 {
-		panic("no return value specified for DepsIter")
-	}
-
-	var r0 iter.Seq[models.LockFileInfo]
-	if rf, ok := ret.Get(0).(func() iter.Seq[models.LockFileInfo]); ok {
-		r0 = rf()
-	} else {
-		if ret.Get(0) != nil {
-			r0 = ret.Get(0).(iter.Seq[models.LockFileInfo])
-		}
-	}
-
-	return r0
-}
-
-// LockFileMock_DepsIter_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'DepsIter'
-type LockFileMock_DepsIter_Call struct {
-	*mock.Call
-}
-
-// DepsIter is a helper method to define mock.On call
-func (_e *LockFileMock_Expecter) DepsIter() *LockFileMock_DepsIter_Call {
-	return &LockFileMock_DepsIter_Call{Call: _e.mock.On("DepsIter")}
-}
-
-func (_c *LockFileMock_DepsIter_Call) Run(run func()) *LockFileMock_DepsIter_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run()
-	})
-	return _c
-}
-
-func (_c *LockFileMock_DepsIter_Call) Return(_a0 iter.Seq[models.LockFileInfo]) *LockFileMock_DepsIter_Call {
-	_c.Call.Return(_a0)
-	return _c
-}
-
-func (_c *LockFileMock_DepsIter_Call) RunAndReturn(run func() iter.Seq[models.LockFileInfo]) *LockFileMock_DepsIter_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// IsEmpty provides a mock function with no fields
-func (_m *LockFileMock) IsEmpty() bool {
-	ret := _m.Called()
-
-	if len(ret) == 0 {
-		panic("no return value specified for IsEmpty")
-	}
-
-	var r0 bool
-	if rf, ok := ret.Get(0).(func() bool); ok {
-		r0 = rf()
-	} else {
-		r0 = ret.Get(0).(bool)
-	}
-
-	return r0
-}
-
-// LockFileMock_IsEmpty_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'IsEmpty'
-type LockFileMock_IsEmpty_Call struct {
-	*mock.Call
-}
-
-// IsEmpty is a helper method to define mock.On call
-func (_e *LockFileMock_Expecter) IsEmpty() *LockFileMock_IsEmpty_Call {
-	return &LockFileMock_IsEmpty_Call{Call: _e.mock.On("IsEmpty")}
-}
-
-func (_c *LockFileMock_IsEmpty_Call) Run(run func()) *LockFileMock_IsEmpty_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run()
-	})
-	return _c
-}
-
-func (_c *LockFileMock_IsEmpty_Call) Return(_a0 bool) *LockFileMock_IsEmpty_Call {
-	_c.Call.Return(_a0)
-	return _c
-}
-
-func (_c *LockFileMock_IsEmpty_Call) RunAndReturn(run func() bool) *LockFileMock_IsEmpty_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// Read provides a mock function with given fields: moduleName
-func (_m *LockFileMock) Read(moduleName string) (models.LockFileInfo, error) {
-	ret := _m.Called(moduleName)
-
-	if len(ret) == 0 {
-		panic("no return value specified for Read")
-	}
-
-	var r0 models.LockFileInfo
-	var r1 error
-	if rf, ok := ret.Get(0).(func(string) (models.LockFileInfo, error)); ok {
-		return rf(moduleName)
-	}
-	if rf, ok := ret.Get(0).(func(string) models.LockFileInfo); ok {
-		r0 = rf(moduleName)
-	} else {
-		r0 = ret.Get(0).(models.LockFileInfo)
-	}
-
-	if rf, ok := ret.Get(1).(func(string) error); ok {
-		r1 = rf(moduleName)
-	} else {
-		r1 = ret.Error(1)
-	}
-
-	return r0, r1
-}
-
-// LockFileMock_Read_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'Read'
-type LockFileMock_Read_Call struct {
-	*mock.Call
-}
-
-// Read is a helper method to define mock.On call
-//   - moduleName string
-func (_e *LockFileMock_Expecter) Read(moduleName interface{}) *LockFileMock_Read_Call {
-	return &LockFileMock_Read_Call{Call: _e.mock.On("Read", moduleName)}
-}
-
-func (_c *LockFileMock_Read_Call) Run(run func(moduleName string)) *LockFileMock_Read_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(string))
-	})
-	return _c
-}
-
-func (_c *LockFileMock_Read_Call) Return(_a0 models.LockFileInfo, _a1 error) *LockFileMock_Read_Call {
-	_c.Call.Return(_a0, _a1)
-	return _c
-}
-
-func (_c *LockFileMock_Read_Call) RunAndReturn(run func(string) (models.LockFileInfo, error)) *LockFileMock_Read_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// Write provides a mock function with given fields: moduleName, revisionVersion, installedPackageHash
-func (_m *LockFileMock) Write(moduleName string, revisionVersion string, installedPackageHash models.ModuleHash) error {
-	ret := _m.Called(moduleName, revisionVersion, installedPackageHash)
-
-	if len(ret) == 0 {
-		panic("no return value specified for Write")
-	}
-
-	var r0 error
-	if rf, ok := ret.Get(0).(func(string, string, models.ModuleHash) error); ok {
-		r0 = rf(moduleName, revisionVersion, installedPackageHash)
-	} else {
-		r0 = ret.Error(0)
-	}
-
-	return r0
-}
-
-// LockFileMock_Write_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'Write'
-type LockFileMock_Write_Call struct {
-	*mock.Call
-}
-
-// Write is a helper method to define mock.On call
-//   - moduleName string
-//   - revisionVersion string
-//   - installedPackageHash models.ModuleHash
-func (_e *LockFileMock_Expecter) Write(moduleName interface{}, revisionVersion interface{}, installedPackageHash interface{}) *LockFileMock_Write_Call {
-	return &LockFileMock_Write_Call{Call: _e.mock.On("Write", moduleName, revisionVersion, installedPackageHash)}
-}
-
-func (_c *LockFileMock_Write_Call) Run(run func(moduleName string, revisionVersion string, installedPackageHash models.ModuleHash)) *LockFileMock_Write_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(string), args[1].(string), args[2].(models.ModuleHash))
-	})
-	return _c
-}
-
-func (_c *LockFileMock_Write_Call) Return(_a0 error) *LockFileMock_Write_Call {
-	_c.Call.Return(_a0)
-	return _c
-}
-
-func (_c *LockFileMock_Write_Call) RunAndReturn(run func(string, string, models.ModuleHash) error) *LockFileMock_Write_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// NewLockFileMock creates a new instance of LockFileMock. It also registers a testing interface on the mock and a cleanup function to assert the mocks expectations.
-// The first argument is typically a *testing.T value.
-func NewLockFileMock(t interface {
-	mock.TestingT
-	Cleanup(func())
-}) *LockFileMock {
-	mock := &LockFileMock{}
-	mock.Mock.Test(t)
-
-	t.Cleanup(func() { mock.AssertExpectations(t) })
-
-	return mock
-}
diff --git a/internal/core/ls_files.go b/internal/core/ls_files.go
deleted file mode 100644
index fd876e96..00000000
--- a/internal/core/ls_files.go
+++ /dev/null
@@ -1,377 +0,0 @@
-package core
-
-import (
-	"context"
-	"os"
-	"path/filepath"
-	"sort"
-	"strings"
-
-	"github.com/yoheimuta/go-protoparser/v4/interpret/unordered"
-
-	"github.com/easyp-tech/easyp/wellknownimports"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-	"github.com/easyp-tech/easyp/internal/fs/fs"
-)
-
-// FileSource represents the origin of a proto file or search root
-type FileSource string
-
-const (
-	FileSourceWorkspace  FileSource = "workspace"
-	FileSourceDependency FileSource = "dependency"
-	FileSourceGitRepo    FileSource = "git_repo"
-	FileSourceWellKnown  FileSource = "wellknown"
-
-	wellKnownBase = "/wellknownimports"
-)
-
-// ListFilesOptions controls behaviour of ListFiles
-type ListFilesOptions struct {
-	// IncludeImports when true returns transitive imports for discovered .proto files
-	IncludeImports bool
-}
-
-// FileInfo represents a discovered proto file
-type FileInfo struct {
-	AbsPath    string     `json:"abs_path"`
-	ImportPath string     `json:"import_path"`
-	Source     FileSource `json:"source"`
-	Root       string     `json:"root"`
-}
-
-// RootInfo represents a search root
-type RootInfo struct {
-	Path   string     `json:"path"`
-	Source FileSource `json:"source"`
-}
-
-// ErrorInfo contains error information
-type ErrorInfo struct {
-	Code    string `json:"code"`
-	Message string `json:"message"`
-}
-
-// LsFilesResult is the output for ls-files command
-type LsFilesResult struct {
-	Files  []FileInfo  `json:"files"`
-	Roots  []RootInfo  `json:"roots"`
-	Errors []ErrorInfo `json:"errors,omitempty"`
-}
-
-type lsContext struct {
-	searchRoots []RootInfo
-	rootSource  map[string]FileSource
-	seenFiles   map[string]struct{}
-	fileRoot    map[string]string
-	files       []FileInfo
-	errors      []ErrorInfo
-}
-
-func newLsContext() *lsContext {
-	return &lsContext{
-		searchRoots: make([]RootInfo, 0),
-		rootSource:  make(map[string]FileSource),
-		seenFiles:   make(map[string]struct{}),
-		fileRoot:    make(map[string]string),
-		files:       make([]FileInfo, 0),
-		errors:      make([]ErrorInfo, 0),
-	}
-}
-
-// ListFiles returns .proto files information
-func (c *Core) ListFiles(ctx context.Context, workingRoot string, opts ListFilesOptions) (LsFilesResult, error) {
-	state := newLsContext()
-
-	c.collectRoots(workingRoot, state)
-	c.scanWorkspaceFiles(ctx, workingRoot, state)
-	if opts.IncludeImports {
-		c.collectImports(ctx, state)
-	}
-
-	return LsFilesResult{
-		Files:  state.sortedFiles(),
-		Roots:  state.sortedRoots(),
-		Errors: state.errors,
-	}, nil
-}
-
-// Helpers reused from previous implementation but cleaned up
-
-func normalizeImportPath(importPath string) string {
-	normalized := strings.Trim(importPath, " \t\r\n\"")
-	normalized = strings.ReplaceAll(normalized, "\\", "/")
-	normalized = strings.TrimPrefix(normalized, "./")
-	normalized = strings.TrimSuffix(normalized, "/")
-	normalized = filepath.ToSlash(filepath.Clean(normalized))
-	return normalized
-}
-
-func normalizeAbsPath(path string) string {
-	cleaned := filepath.Clean(path)
-	if !filepath.IsAbs(cleaned) {
-		abs, err := filepath.Abs(cleaned)
-		if err == nil {
-			cleaned = abs
-		}
-	}
-	return filepath.ToSlash(cleaned)
-}
-
-// Helpers to keep ListFiles readable
-
-func (c *Core) collectRoots(workingRoot string, state *lsContext) {
-	// Well-known imports virtual root
-	state.addRoot(wellKnownBase, FileSourceWellKnown)
-
-	for _, inputFilesDir := range c.inputs.InputFilesDir {
-		root := inputFilesDir.Root
-		if !filepath.IsAbs(root) {
-			root = filepath.Join(workingRoot, root)
-		}
-		state.addRoot(root, FileSourceWorkspace)
-	}
-
-	for lockInfo := range c.lockFile.DepsIter() {
-		modulePath := c.storage.GetInstallDir(lockInfo.Name, lockInfo.Version)
-		state.addRoot(modulePath, FileSourceDependency)
-	}
-
-	for _, repo := range c.inputs.InputGitRepos {
-		module := models.NewModule(repo.URL)
-		modulePath, err := c.modulePath(module)
-		if err != nil {
-			state.errors = append(state.errors, ErrorInfo{
-				Code:    "git_repo_path_error",
-				Message: "failed to get path for git repo " + repo.URL + ": " + err.Error(),
-			})
-			continue
-		}
-
-		root := modulePath
-		if repo.Root != "" {
-			root = filepath.Join(modulePath, repo.Root)
-		}
-		state.addRoot(root, FileSourceGitRepo)
-	}
-}
-
-func (c *Core) scanWorkspaceFiles(ctx context.Context, workingRoot string, state *lsContext) {
-	for _, inputFilesDir := range c.inputs.InputFilesDir {
-		root := inputFilesDir.Root
-		if !filepath.IsAbs(root) {
-			root = filepath.Join(workingRoot, root)
-		}
-		root = normalizeAbsPath(root)
-
-		walker := fs.NewFSWalker(root, inputFilesDir.Path)
-		walker.WalkDir(func(path string, err error) error {
-			if err != nil {
-				state.errors = append(state.errors, ErrorInfo{
-					Code:    "workspace_walk_error",
-					Message: err.Error(),
-				})
-				return nil
-			}
-			if ctx.Err() != nil || filepath.Ext(path) != ".proto" {
-				return nil
-			}
-			absPath := filepath.Join(root, path)
-			state.addFile(absPath, path, FileSourceWorkspace, root)
-			return nil
-		})
-	}
-}
-
-func (c *Core) collectImports(ctx context.Context, state *lsContext) {
-	queue := make([]string, 0, len(state.files))
-	for _, f := range state.files {
-		queue = append(queue, f.AbsPath)
-	}
-
-	visited := make(map[string]struct{}, len(queue))
-	for _, q := range queue {
-		visited[q] = struct{}{}
-	}
-
-	head := 0
-	for head < len(queue) {
-		currentAbs := queue[head]
-		head++
-
-		if ctx.Err() != nil {
-			return
-		}
-
-		proto, ok := c.readProtoForPath(ctx, currentAbs, state)
-		if !ok {
-			continue
-		}
-
-		c.processImports(proto, currentAbs, &queue, state, visited)
-	}
-}
-
-func (c *Core) processImports(
-	proto *unordered.Proto,
-	currentAbs string,
-	queue *[]string,
-	state *lsContext,
-	visited map[string]struct{},
-) {
-	for _, imp := range proto.ProtoBody.Imports {
-		impPath := strings.Trim(imp.Location, "\"")
-
-		if abs, src, root, ok := state.resolveImport(currentAbs, impPath); ok {
-			if _, seen := visited[abs]; !seen {
-				visited[abs] = struct{}{}
-				*queue = append(*queue, abs)
-				state.addFile(abs, impPath, src, root)
-			}
-		} else {
-			state.errors = append(state.errors, ErrorInfo{
-				Code:    "import_not_found",
-				Message: "cannot resolve import " + impPath + " from " + currentAbs,
-			})
-		}
-	}
-}
-
-func (c *Core) readProtoForPath(ctx context.Context, absPath string, state *lsContext) (*unordered.Proto, bool) {
-	source := state.sourceForAbs(absPath)
-
-	if source == FileSourceWellKnown {
-		rel, err := filepath.Rel(state.fileRoot[absPath], absPath)
-		if err != nil {
-			state.errors = append(state.errors, ErrorInfo{
-				Code:    "open_error",
-				Message: err.Error(),
-			})
-			return nil, false
-		}
-
-		r, err := wellknownimports.Content.Open(rel)
-		if err != nil {
-			state.errors = append(state.errors, ErrorInfo{
-				Code:    "open_error",
-				Message: err.Error(),
-			})
-			return nil, false
-		}
-		defer r.Close()
-
-		proto, err := readProtoFile(r)
-		if err != nil {
-			state.errors = append(state.errors, ErrorInfo{
-				Code:    "parse_error",
-				Message: err.Error(),
-			})
-			return nil, false
-		}
-		return proto, true
-	}
-
-	f, err := os.Open(absPath)
-	if err != nil {
-		state.errors = append(state.errors, ErrorInfo{
-			Code:    "open_error",
-			Message: err.Error(),
-		})
-		return nil, false
-	}
-	defer c.close(ctx, f, absPath)
-
-	proto, err := readProtoFile(f)
-	if err != nil {
-		state.errors = append(state.errors, ErrorInfo{
-			Code:    "parse_error",
-			Message: err.Error(),
-		})
-		return nil, false
-	}
-	return proto, true
-}
-
-func (s *lsContext) resolveImport(currentAbs, importPath string) (string, FileSource, string, bool) {
-	currentRoot := s.fileRoot[currentAbs]
-	if currentRoot != "" {
-		candidate := filepath.Join(currentRoot, importPath)
-		if _, err := os.Stat(candidate); err == nil {
-			candidate = normalizeAbsPath(candidate)
-			if source, ok := s.rootSource[currentRoot]; ok {
-				return candidate, source, currentRoot, true
-			}
-			return candidate, "", currentRoot, true
-		}
-	}
-
-	// Direct well-known lookup before FS roots
-	if f, err := wellknownimports.Content.Open(importPath); err == nil {
-		_ = f.Close()
-		candidate := filepath.Join(wellKnownBase, importPath)
-		return normalizeAbsPath(candidate), FileSourceWellKnown, wellKnownBase, true
-	}
-
-	for _, r := range s.searchRoots {
-		candidate := filepath.Join(r.Path, importPath)
-		if _, err := os.Stat(candidate); err == nil {
-			candidate = normalizeAbsPath(candidate)
-			return candidate, r.Source, r.Path, true
-		}
-	}
-
-	return "", "", "", false
-}
-
-func (s *lsContext) addRoot(path string, source FileSource) {
-	normalized := normalizeAbsPath(path)
-	if _, ok := s.rootSource[normalized]; ok {
-		return
-	}
-	s.rootSource[normalized] = source
-	s.searchRoots = append(s.searchRoots, RootInfo{Path: normalized, Source: source})
-}
-
-func (s *lsContext) addFile(absPath, importPath string, source FileSource, root string) {
-	absPath = normalizeAbsPath(absPath)
-	if _, ok := s.seenFiles[absPath]; ok {
-		return
-	}
-	s.seenFiles[absPath] = struct{}{}
-	root = normalizeAbsPath(root)
-	s.fileRoot[absPath] = root
-	s.files = append(s.files, FileInfo{
-		AbsPath:    absPath,
-		ImportPath: normalizeImportPath(importPath),
-		Source:     source,
-		Root:       root,
-	})
-}
-
-func (s *lsContext) sortedRoots() []RootInfo {
-	roots := make([]RootInfo, len(s.searchRoots))
-	copy(roots, s.searchRoots)
-	sort.Slice(roots, func(i, j int) bool {
-		return roots[i].Path < roots[j].Path
-	})
-	return roots
-}
-
-func (s *lsContext) sortedFiles() []FileInfo {
-	files := make([]FileInfo, len(s.files))
-	copy(files, s.files)
-	sort.Slice(files, func(i, j int) bool {
-		return files[i].ImportPath < files[j].ImportPath
-	})
-	return files
-}
-
-func (s *lsContext) sourceForAbs(absPath string) FileSource {
-	absPath = normalizeAbsPath(absPath)
-	root := s.fileRoot[absPath]
-	if src, ok := s.rootSource[root]; ok {
-		return src
-	}
-	return ""
-}
diff --git a/internal/core/managed_mode.go b/internal/core/managed_mode.go
index c89c1ddf..a7187207 100644
--- a/internal/core/managed_mode.go
+++ b/internal/core/managed_mode.go
@@ -105,6 +105,10 @@ type ManagedOverrideRule struct {
 	FieldOption FieldOptionType
 	// Value is the value to set for the option.
 	Value any
+	// PackagePath makes go_package_prefix derive its import path from the
+	// protobuf package hierarchy. It is used only by options.go.package_prefix;
+	// regular managed overrides retain buf-compatible file-directory semantics.
+	PackagePath bool
 	// Module applies this override only to files in the specified module.
 	Module string
 	// Package applies this override only to files in the specified protobuf package.
@@ -119,6 +123,8 @@ type ManagedOverrideRule struct {
 type ManagedModeConfig struct {
 	// Enabled activates managed mode.
 	Enabled bool
+	// GoPackageOnly applies Go overrides without activating other language options.
+	GoPackageOnly bool
 	// Disable contains rules to disable managed mode for specific conditions.
 	Disable []ManagedDisableRule
 	// Override contains rules to override file and field options.
@@ -149,18 +155,6 @@ func (c *ManagedModeConfig) IsFieldOptionDisabled(filePath, module, protoPackage
 	return false
 }
 
-// GetFileOptionOverride returns the override value for a file option, or nil if not overridden.
-// If multiple overrides match, the last matching rule wins (buf behavior).
-func (c *ManagedModeConfig) GetFileOptionOverride(filePath, module, protoPackage string, option FileOptionType) any {
-	var result any
-	for _, rule := range c.Override {
-		if rule.FileOption == option && rule.matchesFileContext(filePath, module, protoPackage) {
-			result = rule.Value
-		}
-	}
-	return result
-}
-
 // GetFieldOptionOverride returns the override value for a field option, or nil if not overridden.
 // If multiple overrides match, the last matching rule wins (buf behavior).
 func (c *ManagedModeConfig) GetFieldOptionOverride(filePath, module, protoPackage string, option FieldOptionType, fieldName string) any {
@@ -339,76 +333,11 @@ var fileOptionHandlers = []FileOptionHandler{
 		HasDefault:    false,
 		AffectsOption: FileOptionGoPackage,
 		Apply: func(fd *descriptorpb.FileDescriptorProto, value any, pkg, filePath string) {
-			if prefix, ok := value.(string); ok {
-				// go_package_prefix sets go_package to <prefix>/<file_directory>;<package_name>
-				//
-				// Example: file "api/task/service.proto" with proto package "task.v1"
-				//   generates: go_package = "prefix/api/task;taskv1"
-				//   path: "prefix/api/task" (physical file directory)
-				//   package name: "taskv1" (last 2 segments of proto package combined)
-
-				// If the value contains {{file_path}} or {{file_path_spec}}, use file path instead
-				if strings.Contains(prefix, "{{file_path}}") || strings.Contains(prefix, "{{file_path_spec}}") {
-					// Marker for generating paths based on file path
-					// Uses the file path directly, removing .proto extension
-					// {{file_path_spec}} is an alias for {{file_path}} - kept for backward compatibility
-					pathWithoutExt := normalizePath(strings.TrimSuffix(filePath, ".proto"))
-					replaced := strings.ReplaceAll(prefix, "{{file_path}}", pathWithoutExt)
-					replaced = strings.ReplaceAll(replaced, "{{file_path_spec}}", pathWithoutExt)
-					fd.Options.GoPackage = proto.String(replaced)
-				} else if strings.Contains(prefix, "{{file_dir}}") {
-					// Marker for using only the directory path, without filename
-					// Example: internal/cms/as_service.proto -> internal/cms
-					dir := normalizePath(filepath.Dir(filePath))
-					replaced := strings.ReplaceAll(prefix, "{{file_dir}}", dir)
-					fd.Options.GoPackage = proto.String(replaced)
-				} else if strings.Contains(prefix, "{{file_dir_without:") {
-					// Marker for using directory path with prefix removal: {{file_dir_without:prefix/}}
-					// Example: {{file_dir_without:internal/}} for internal/cms/as_service.proto -> cms
-					dir := filepath.Dir(filePath)
-					base := strings.TrimSuffix(filepath.Base(filePath), ".proto")
-					// Remove common suffixes like _service, _grpc to get base name
-					baseName := base
-					if strings.HasSuffix(baseName, "_service") {
-						baseName = strings.TrimSuffix(baseName, "_service")
-					} else if strings.HasSuffix(baseName, "_grpc") {
-						baseName = strings.TrimSuffix(baseName, "_grpc")
-					}
-					// Use directory + base name for path
-					pathWithBase := normalizePath(filepath.Join(dir, baseName))
-					replaced := replacePathMarkers(prefix, "{{file_dir_without:", pathWithBase)
-					fd.Options.GoPackage = proto.String(replaced)
-				} else if strings.Contains(prefix, "{{file_path_without:") {
-					// Marker for generating paths with prefix removal: {{file_path_without:prefix/}}
-					// Example: {{file_path_without:internal/}} removes "internal/" from the beginning
-					pathWithoutExt := normalizePath(strings.TrimSuffix(filePath, ".proto"))
-					replaced := replacePathMarkers(prefix, "{{file_path_without:", pathWithoutExt)
-					fd.Options.GoPackage = proto.String(replaced)
-				} else {
-					// With paths=source_relative:
-					// - Import path comes from physical file directory
-					// - Package name derived from proto package:
-					//   * 1 segment ("common"): omit explicit name, let protoc-gen-go derive from import path
-					//   * 2+ segments ("task.v1", "acme.api.v2"): combine last 2 -> "taskv1", "apiv2"
-
-					fileDir := normalizePath(filepath.Dir(filePath))
-					segments := strings.Split(pkg, ".")
-					var goPackage string
-
-					if len(segments) == 1 {
-						// Single segment: omit explicit package name
-						// protoc-gen-go will derive it from path.Base(importPath)
-						goPackage = prefix + "/" + fileDir
-					} else {
-						// Multiple segments: combine last 2
-						packageNameBase := segments[len(segments)-2] + segments[len(segments)-1]
-						cleanPkg := cleanPackageName(packageNameBase)
-						goPackage = prefix + "/" + fileDir + ";" + cleanPkg
-					}
-
-					fd.Options.GoPackage = proto.String(goPackage)
-				}
+			prefix, ok := value.(string)
+			if !ok {
+				return
 			}
+			applyGoPackagePrefix(fd, prefix, pkg, filePath, false)
 		},
 	},
 
@@ -679,7 +608,7 @@ func ApplyManagedMode(
 	config ManagedModeConfig,
 	fileToModule map[string]string,
 ) error {
-	if !config.Enabled {
+	if !config.Enabled && !config.GoPackageOnly {
 		return nil
 	}
 
@@ -691,6 +620,7 @@ func ApplyManagedMode(
 		// Managed mode applies to all files. Module/path selectors are used only
 		// to narrow disable/override rules, matching buf's managed mode behavior.
 
+		hadOptions := fd.Options != nil
 		// Ensure Options is initialized
 		if fd.Options == nil {
 			fd.Options = &descriptorpb.FileOptions{}
@@ -700,7 +630,12 @@ func ApplyManagedMode(
 		applyFileOptions(fd, config, filePath, module, pkg)
 
 		// Apply field options to all messages
-		applyFieldOptionsToMessages(fd.GetMessageType(), config, filePath, module, pkg, pkg)
+		if config.Enabled {
+			applyFieldOptionsToMessages(fd.GetMessageType(), config, filePath, module, pkg, pkg)
+		}
+		if !hadOptions && proto.Size(fd.Options) == 0 {
+			fd.Options = nil
+		}
 	}
 
 	return nil
@@ -725,6 +660,9 @@ func applyFileOptions(
 	// This matches buf's behavior: "If multiple overrides for the same option apply
 	// to a file or field, the last rule takes effect."
 	for _, override := range config.Override {
+		if !config.Enabled && override.FileOption != FileOptionGoPackage && override.FileOption != FileOptionGoPackagePrefix {
+			continue
+		}
 		if override.FileOption == "" {
 			continue
 		}
@@ -751,8 +689,21 @@ func applyFileOptions(
 			continue
 		}
 
-		// Apply the override
-		handler.Apply(fd, override.Value, pkg, filePath)
+		if handler.AffectsOption != "" && config.IsFileOptionDisabled(filePath, module, pkg, handler.AffectsOption) {
+			continue
+		}
+
+		// options.go.package_prefix follows the RFC package hierarchy while
+		// explicit managed overrides keep buf-compatible file-directory semantics.
+		if override.FileOption == FileOptionGoPackagePrefix && override.PackagePath {
+			prefix, ok := override.Value.(string)
+			if !ok {
+				continue
+			}
+			applyGoPackagePrefix(fd, prefix, pkg, filePath, true)
+		} else {
+			handler.Apply(fd, override.Value, pkg, filePath)
+		}
 		appliedOptions[override.FileOption] = true
 
 		// If this handler affects another option (e.g., go_package_prefix affects go_package),
@@ -762,6 +713,10 @@ func applyFileOptions(
 		}
 	}
 
+	if !config.Enabled {
+		return
+	}
+
 	// Second pass: apply defaults for options that have defaults and weren't overridden
 	// According to buf documentation, only certain options have defaults
 	for i := range fileOptionHandlers {
@@ -800,6 +755,54 @@ func applyFileOptions(
 	}
 }
 
+func applyGoPackagePrefix(
+	fd *descriptorpb.FileDescriptorProto,
+	prefix, pkg, filePath string,
+	packagePath bool,
+) {
+	// Marker forms keep their historical file-path semantics.
+	if strings.Contains(prefix, "{{file_path}}") || strings.Contains(prefix, "{{file_path_spec}}") {
+		pathWithoutExt := normalizePath(strings.TrimSuffix(filePath, ".proto"))
+		replaced := strings.ReplaceAll(prefix, "{{file_path}}", pathWithoutExt)
+		replaced = strings.ReplaceAll(replaced, "{{file_path_spec}}", pathWithoutExt)
+		fd.Options.GoPackage = proto.String(replaced)
+		return
+	}
+	if strings.Contains(prefix, "{{file_dir}}") {
+		dir := normalizePath(filepath.Dir(filePath))
+		fd.Options.GoPackage = proto.String(strings.ReplaceAll(prefix, "{{file_dir}}", dir))
+		return
+	}
+	if strings.Contains(prefix, "{{file_dir_without:") {
+		dir := filepath.Dir(filePath)
+		base := strings.TrimSuffix(filepath.Base(filePath), ".proto")
+		baseName := strings.TrimSuffix(strings.TrimSuffix(base, "_service"), "_grpc")
+		pathWithBase := normalizePath(filepath.Join(dir, baseName))
+		fd.Options.GoPackage = proto.String(replacePathMarkers(prefix, "{{file_dir_without:", pathWithBase))
+		return
+	}
+	if strings.Contains(prefix, "{{file_path_without:") {
+		pathWithoutExt := normalizePath(strings.TrimSuffix(filePath, ".proto"))
+		fd.Options.GoPackage = proto.String(replacePathMarkers(prefix, "{{file_path_without:", pathWithoutExt))
+		return
+	}
+
+	fileDir := normalizePath(filepath.Dir(filePath))
+	segments := strings.Split(pkg, ".")
+	importPath := fileDir
+	if packagePath && len(segments) > 1 {
+		importPath = normalizePath(strings.ReplaceAll(pkg, ".", "/"))
+	}
+	var goPackage string
+	if len(segments) == 1 {
+		goPackage = prefix + "/" + importPath
+	} else {
+		packageNameBase := segments[len(segments)-2] + segments[len(segments)-1]
+		goPackage = prefix + "/" + importPath + ";" + cleanPackageName(packageNameBase)
+	}
+	fd.Options.GoPackage = proto.String(goPackage)
+}
+
 // applyFieldOptionsToMessages recursively applies field options to all messages.
 func applyFieldOptionsToMessages(
 	messages []*descriptorpb.DescriptorProto,
diff --git a/internal/core/managed_mode_go_only_test.go b/internal/core/managed_mode_go_only_test.go
new file mode 100644
index 00000000..8d5fafa2
--- /dev/null
+++ b/internal/core/managed_mode_go_only_test.go
@@ -0,0 +1,49 @@
+package core
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"google.golang.org/protobuf/proto"
+	"google.golang.org/protobuf/types/descriptorpb"
+)
+
+func TestGoPackageOnlyPreservesOtherOptions(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name             string
+		enabled, disable bool
+	}{
+		{name: "point option"}, {name: "explicit managed mode", enabled: true}, {name: "Go option disabled", disable: true},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			file := &descriptorpb.FileDescriptorProto{Name: proto.String("demo/v1/item.proto"), Package: proto.String("demo.v1"), Options: &descriptorpb.FileOptions{
+				GoPackage: proto.String("example.com/original;demov1"), JavaPackage: proto.String("original.java"), JavaMultipleFiles: proto.Bool(false), CcEnableArenas: proto.Bool(false),
+			}, MessageType: []*descriptorpb.DescriptorProto{{Name: proto.String("Item"), Field: []*descriptorpb.FieldDescriptorProto{{Name: proto.String("value"), Number: proto.Int32(1), Type: descriptorpb.FieldDescriptorProto_TYPE_INT64.Enum(), Options: &descriptorpb.FieldOptions{Jstype: descriptorpb.FieldOptions_JS_NUMBER.Enum()}}}}}}
+			before := proto.Clone(file).(*descriptorpb.FileDescriptorProto)
+			cfg := ManagedModeConfig{Enabled: tt.enabled, GoPackageOnly: !tt.enabled, Override: []ManagedOverrideRule{
+				{FileOption: FileOptionGoPackagePrefix, Value: "example.com/new"}, {FileOption: FileOptionJavaPackage, Value: "explicit.java"}, {FieldOption: FieldOptionJsType, Value: "JS_STRING"},
+			}}
+			if tt.disable {
+				cfg.Disable = []ManagedDisableRule{{FileOption: FileOptionGoPackage}}
+			}
+			require.NoError(t, ApplyManagedMode([]*descriptorpb.FileDescriptorProto{file}, cfg, nil))
+			if tt.disable {
+				assert.True(t, proto.Equal(before, file))
+				return
+			}
+			assert.Equal(t, "example.com/new/demo/v1;demov1", file.GetOptions().GetGoPackage())
+			if tt.enabled {
+				assert.Equal(t, "explicit.java", file.GetOptions().GetJavaPackage())
+				assert.True(t, file.GetOptions().GetJavaMultipleFiles())
+				assert.Equal(t, descriptorpb.FieldOptions_JS_STRING, file.MessageType[0].Field[0].GetOptions().GetJstype())
+				return
+			}
+			file.Options.GoPackage = before.Options.GoPackage
+			assert.True(t, proto.Equal(before, file), "non-Go options changed")
+		})
+	}
+}
diff --git a/internal/core/managed_mode_test.go b/internal/core/managed_mode_test.go
index 4250bb6d..52992d97 100644
--- a/internal/core/managed_mode_test.go
+++ b/internal/core/managed_mode_test.go
@@ -56,6 +56,7 @@ func TestApplyManagedMode_GoPackagePrefix(t *testing.T) {
 		fileName     string
 		protoPackage string
 		goPackage    string
+		packagePath  bool
 	}{
 		{
 			name:         "two_dots_in_package",
@@ -69,6 +70,13 @@ func TestApplyManagedMode_GoPackagePrefix(t *testing.T) {
 			protoPackage: "task.v1",
 			goPackage:    "github.com/acme/weather/gen/go/task/v1;taskv1",
 		},
+		{
+			name:         "module_relative_source_directory",
+			fileName:     "v1/user.proto",
+			protoPackage: "user.v1",
+			goPackage:    "github.com/acme/weather/gen/go/user/v1;userv1",
+			packagePath:  true,
+		},
 		{
 			name:         "no_dots_in_package",
 			fileName:     "common/v1/common.proto",
@@ -89,8 +97,9 @@ func TestApplyManagedMode_GoPackagePrefix(t *testing.T) {
 				Enabled: true,
 				Override: []ManagedOverrideRule{
 					{
-						FileOption: FileOptionGoPackagePrefix,
-						Value:      "github.com/acme/weather/gen/go",
+						FileOption:  FileOptionGoPackagePrefix,
+						Value:       "github.com/acme/weather/gen/go",
+						PackagePath: tt.packagePath,
 					},
 				},
 			}
diff --git a/internal/core/managed_option_metadata.go b/internal/core/managed_option_metadata.go
new file mode 100644
index 00000000..6fef0efe
--- /dev/null
+++ b/internal/core/managed_option_metadata.go
@@ -0,0 +1,52 @@
+package core
+
+import (
+	"google.golang.org/protobuf/reflect/protoreflect"
+	"google.golang.org/protobuf/types/descriptorpb"
+)
+
+// ManagedOptionMetadata describes the configuration values accepted by a managed handler.
+type ManagedOptionMetadata struct {
+	Name      string
+	ValueType string
+	Enum      []string
+}
+
+// ManagedFileOptionMetadata returns fresh metadata for the registered file handlers.
+// Prefix/suffix handlers accept the same value type as the option they affect.
+func ManagedFileOptionMetadata() []ManagedOptionMetadata {
+	fields := (&descriptorpb.FileOptions{}).ProtoReflect().Descriptor().Fields()
+	options := make([]ManagedOptionMetadata, 0, len(fileOptionHandlers))
+	for _, handler := range fileOptionHandlers {
+		option := handler.Option
+		if handler.AffectsOption != "" {
+			option = handler.AffectsOption
+		}
+		options = append(options, managedOptionMetadata(string(handler.Option), fields.ByName(protoreflect.Name(option))))
+	}
+	return options
+}
+
+// ManagedFieldOptionMetadata returns fresh metadata for the registered field handlers.
+func ManagedFieldOptionMetadata() []ManagedOptionMetadata {
+	fields := (&descriptorpb.FieldOptions{}).ProtoReflect().Descriptor().Fields()
+	options := make([]ManagedOptionMetadata, 0, len(fieldOptionHandlers))
+	for _, handler := range fieldOptionHandlers {
+		options = append(options, managedOptionMetadata(string(handler.Option), fields.ByName(protoreflect.Name(handler.Option))))
+	}
+	return options
+}
+
+func managedOptionMetadata(name string, field protoreflect.FieldDescriptor) ManagedOptionMetadata {
+	metadata := ManagedOptionMetadata{Name: name, ValueType: "string"}
+	switch field.Kind() {
+	case protoreflect.BoolKind:
+		metadata.ValueType = "boolean"
+	case protoreflect.EnumKind:
+		values := field.Enum().Values()
+		for i := 0; i < values.Len(); i++ {
+			metadata.Enum = append(metadata.Enum, string(values.Get(i).Name()))
+		}
+	}
+	return metadata
+}
diff --git a/internal/core/managed_option_metadata_test.go b/internal/core/managed_option_metadata_test.go
new file mode 100644
index 00000000..e859c658
--- /dev/null
+++ b/internal/core/managed_option_metadata_test.go
@@ -0,0 +1,101 @@
+package core
+
+import (
+	"fmt"
+	"slices"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"google.golang.org/protobuf/proto"
+	"google.golang.org/protobuf/types/descriptorpb"
+)
+
+func TestManagedOptionMetadataMatchesHandlers(t *testing.T) {
+	t.Parallel()
+	fileOptions := ManagedFileOptionMetadata()
+	fieldOptions := ManagedFieldOptionMetadata()
+	require.Len(t, fileOptions, len(fileOptionHandlers))
+	require.Len(t, fieldOptions, len(fieldOptionHandlers))
+	tests := []struct {
+		name     string
+		metadata ManagedOptionMetadata
+		apply    func(any) bool
+	}{}
+	for i, handler := range fileOptionHandlers {
+		tests = append(tests, struct {
+			name     string
+			metadata ManagedOptionMetadata
+			apply    func(any) bool
+		}{
+			name: string(handler.Option), metadata: fileOptions[i],
+			apply: func(value any) bool {
+				fd := &descriptorpb.FileDescriptorProto{Name: proto.String("api/v1/service.proto"), Options: &descriptorpb.FileOptions{}}
+				before := proto.Clone(fd)
+				handler.Apply(fd, value, "acme.v1", fd.GetName())
+				return !proto.Equal(before, fd)
+			},
+		})
+	}
+	for i, handler := range fieldOptionHandlers {
+		tests = append(tests, struct {
+			name     string
+			metadata ManagedOptionMetadata
+			apply    func(any) bool
+		}{
+			name: string(handler.Option), metadata: fieldOptions[i],
+			apply: func(value any) bool {
+				field := &descriptorpb.FieldDescriptorProto{Type: descriptorpb.FieldDescriptorProto_TYPE_INT64.Enum(), Options: &descriptorpb.FieldOptions{}}
+				before := proto.Clone(field)
+				handler.Apply(field, value)
+				return !proto.Equal(before, field)
+			},
+		})
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			assert.Equal(t, tt.name, tt.metadata.Name)
+			require.Contains(t, []string{"string", "boolean"}, tt.metadata.ValueType)
+			values := []any{nil, true, false, 0, 1, "", "value", "true", "SPEED", "CODE_SIZE", "LITE_RUNTIME", "JS_NORMAL", "JS_STRING", "JS_NUMBER", "invalid", []string{"value"}, map[string]string{"value": "value"}}
+			for _, value := range tt.metadata.Enum {
+				values = append(values, value)
+			}
+			for _, value := range values {
+				accepted := false
+				switch value := value.(type) {
+				case string:
+					accepted = tt.metadata.ValueType == "string" && (len(tt.metadata.Enum) == 0 || slices.Contains(tt.metadata.Enum, value))
+				case bool:
+					accepted = tt.metadata.ValueType == "boolean"
+				}
+				assert.Equal(t, accepted, tt.apply(value), fmt.Sprintf("metadata/handler mismatch for %T(%v)", value, value))
+			}
+		})
+	}
+}
+
+func TestManagedOptionMetadataDoesNotExposeSharedState(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name string
+		load func() []ManagedOptionMetadata
+	}{
+		{name: "file", load: ManagedFileOptionMetadata},
+		{name: "field", load: ManagedFieldOptionMetadata},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			before := tt.load()
+			changed := tt.load()
+			for i := range changed {
+				changed[i].Name = "changed"
+				for j := range changed[i].Enum {
+					changed[i].Enum[j] = "changed"
+				}
+			}
+			assert.Equal(t, before, tt.load())
+		})
+	}
+}
diff --git a/internal/core/mocks/Console.go b/internal/core/mocks/Console.go
deleted file mode 100644
index a1036794..00000000
--- a/internal/core/mocks/Console.go
+++ /dev/null
@@ -1,109 +0,0 @@
-// Code generated by mockery. DO NOT EDIT.
-
-package mocks
-
-import (
-	context "context"
-
-	mock "github.com/stretchr/testify/mock"
-)
-
-// Console is an autogenerated mock type for the Console type
-type Console struct {
-	mock.Mock
-}
-
-type Console_Expecter struct {
-	mock *mock.Mock
-}
-
-func (_m *Console) EXPECT() *Console_Expecter {
-	return &Console_Expecter{mock: &_m.Mock}
-}
-
-// RunCmd provides a mock function with given fields: ctx, dir, command, commandParams
-func (_m *Console) RunCmd(ctx context.Context, dir string, command string, commandParams ...string) (string, error) {
-	_va := make([]interface{}, len(commandParams))
-	for _i := range commandParams {
-		_va[_i] = commandParams[_i]
-	}
-	var _ca []interface{}
-	_ca = append(_ca, ctx, dir, command)
-	_ca = append(_ca, _va...)
-	ret := _m.Called(_ca...)
-
-	if len(ret) == 0 {
-		panic("no return value specified for RunCmd")
-	}
-
-	var r0 string
-	var r1 error
-	if rf, ok := ret.Get(0).(func(context.Context, string, string, ...string) (string, error)); ok {
-		return rf(ctx, dir, command, commandParams...)
-	}
-	if rf, ok := ret.Get(0).(func(context.Context, string, string, ...string) string); ok {
-		r0 = rf(ctx, dir, command, commandParams...)
-	} else {
-		r0 = ret.Get(0).(string)
-	}
-
-	if rf, ok := ret.Get(1).(func(context.Context, string, string, ...string) error); ok {
-		r1 = rf(ctx, dir, command, commandParams...)
-	} else {
-		r1 = ret.Error(1)
-	}
-
-	return r0, r1
-}
-
-// Console_RunCmd_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'RunCmd'
-type Console_RunCmd_Call struct {
-	*mock.Call
-}
-
-// RunCmd is a helper method to define mock.On call
-//   - ctx context.Context
-//   - dir string
-//   - command string
-//   - commandParams ...string
-func (_e *Console_Expecter) RunCmd(ctx interface{}, dir interface{}, command interface{}, commandParams ...interface{}) *Console_RunCmd_Call {
-	return &Console_RunCmd_Call{Call: _e.mock.On("RunCmd",
-		append([]interface{}{ctx, dir, command}, commandParams...)...)}
-}
-
-func (_c *Console_RunCmd_Call) Run(run func(ctx context.Context, dir string, command string, commandParams ...string)) *Console_RunCmd_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		variadicArgs := make([]string, len(args)-3)
-		for i, a := range args[3:] {
-			if a != nil {
-				variadicArgs[i] = a.(string)
-			}
-		}
-		run(args[0].(context.Context), args[1].(string), args[2].(string), variadicArgs...)
-	})
-	return _c
-}
-
-func (_c *Console_RunCmd_Call) Return(_a0 string, _a1 error) *Console_RunCmd_Call {
-	_c.Call.Return(_a0, _a1)
-	return _c
-}
-
-func (_c *Console_RunCmd_Call) RunAndReturn(run func(context.Context, string, string, ...string) (string, error)) *Console_RunCmd_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// NewConsole creates a new instance of Console. It also registers a testing interface on the mock and a cleanup function to assert the mocks expectations.
-// The first argument is typically a *testing.T value.
-func NewConsole(t interface {
-	mock.TestingT
-	Cleanup(func())
-}) *Console {
-	mock := &Console{}
-	mock.Mock.Test(t)
-
-	t.Cleanup(func() { mock.AssertExpectations(t) })
-
-	return mock
-}
diff --git a/internal/core/mocks/CurrentProjectGitWalker.go b/internal/core/mocks/CurrentProjectGitWalker.go
deleted file mode 100644
index 7e0292fb..00000000
--- a/internal/core/mocks/CurrentProjectGitWalker.go
+++ /dev/null
@@ -1,95 +0,0 @@
-// Code generated by mockery. DO NOT EDIT.
-
-package mocks
-
-import (
-	core "github.com/easyp-tech/easyp/internal/core"
-	mock "github.com/stretchr/testify/mock"
-)
-
-// CurrentProjectGitWalker is an autogenerated mock type for the CurrentProjectGitWalker type
-type CurrentProjectGitWalker struct {
-	mock.Mock
-}
-
-type CurrentProjectGitWalker_Expecter struct {
-	mock *mock.Mock
-}
-
-func (_m *CurrentProjectGitWalker) EXPECT() *CurrentProjectGitWalker_Expecter {
-	return &CurrentProjectGitWalker_Expecter{mock: &_m.Mock}
-}
-
-// GetDirWalker provides a mock function with given fields: workingDir, gitRef, path
-func (_m *CurrentProjectGitWalker) GetDirWalker(workingDir string, gitRef string, path string) (core.DirWalker, error) {
-	ret := _m.Called(workingDir, gitRef, path)
-
-	if len(ret) == 0 {
-		panic("no return value specified for GetDirWalker")
-	}
-
-	var r0 core.DirWalker
-	var r1 error
-	if rf, ok := ret.Get(0).(func(string, string, string) (core.DirWalker, error)); ok {
-		return rf(workingDir, gitRef, path)
-	}
-	if rf, ok := ret.Get(0).(func(string, string, string) core.DirWalker); ok {
-		r0 = rf(workingDir, gitRef, path)
-	} else {
-		if ret.Get(0) != nil {
-			r0 = ret.Get(0).(core.DirWalker)
-		}
-	}
-
-	if rf, ok := ret.Get(1).(func(string, string, string) error); ok {
-		r1 = rf(workingDir, gitRef, path)
-	} else {
-		r1 = ret.Error(1)
-	}
-
-	return r0, r1
-}
-
-// CurrentProjectGitWalker_GetDirWalker_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'GetDirWalker'
-type CurrentProjectGitWalker_GetDirWalker_Call struct {
-	*mock.Call
-}
-
-// GetDirWalker is a helper method to define mock.On call
-//   - workingDir string
-//   - gitRef string
-//   - path string
-func (_e *CurrentProjectGitWalker_Expecter) GetDirWalker(workingDir interface{}, gitRef interface{}, path interface{}) *CurrentProjectGitWalker_GetDirWalker_Call {
-	return &CurrentProjectGitWalker_GetDirWalker_Call{Call: _e.mock.On("GetDirWalker", workingDir, gitRef, path)}
-}
-
-func (_c *CurrentProjectGitWalker_GetDirWalker_Call) Run(run func(workingDir string, gitRef string, path string)) *CurrentProjectGitWalker_GetDirWalker_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(string), args[1].(string), args[2].(string))
-	})
-	return _c
-}
-
-func (_c *CurrentProjectGitWalker_GetDirWalker_Call) Return(_a0 core.DirWalker, _a1 error) *CurrentProjectGitWalker_GetDirWalker_Call {
-	_c.Call.Return(_a0, _a1)
-	return _c
-}
-
-func (_c *CurrentProjectGitWalker_GetDirWalker_Call) RunAndReturn(run func(string, string, string) (core.DirWalker, error)) *CurrentProjectGitWalker_GetDirWalker_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// NewCurrentProjectGitWalker creates a new instance of CurrentProjectGitWalker. It also registers a testing interface on the mock and a cleanup function to assert the mocks expectations.
-// The first argument is typically a *testing.T value.
-func NewCurrentProjectGitWalker(t interface {
-	mock.TestingT
-	Cleanup(func())
-}) *CurrentProjectGitWalker {
-	mock := &CurrentProjectGitWalker{}
-	mock.Mock.Test(t)
-
-	t.Cleanup(func() { mock.AssertExpectations(t) })
-
-	return mock
-}
diff --git a/internal/core/mocks/LockFile.go b/internal/core/mocks/LockFile.go
deleted file mode 100644
index 85720a72..00000000
--- a/internal/core/mocks/LockFile.go
+++ /dev/null
@@ -1,233 +0,0 @@
-// Code generated by mockery. DO NOT EDIT.
-
-package mocks
-
-import (
-	iter "iter"
-
-	models "github.com/easyp-tech/easyp/internal/core/models"
-	mock "github.com/stretchr/testify/mock"
-)
-
-// LockFile is an autogenerated mock type for the LockFile type
-type LockFile struct {
-	mock.Mock
-}
-
-type LockFile_Expecter struct {
-	mock *mock.Mock
-}
-
-func (_m *LockFile) EXPECT() *LockFile_Expecter {
-	return &LockFile_Expecter{mock: &_m.Mock}
-}
-
-// DepsIter provides a mock function with given fields:
-func (_m *LockFile) DepsIter() iter.Seq[models.LockFileInfo] {
-	ret := _m.Called()
-
-	if len(ret) == 0 {
-		panic("no return value specified for DepsIter")
-	}
-
-	var r0 iter.Seq[models.LockFileInfo]
-	if rf, ok := ret.Get(0).(func() iter.Seq[models.LockFileInfo]); ok {
-		r0 = rf()
-	} else {
-		if ret.Get(0) != nil {
-			r0 = ret.Get(0).(iter.Seq[models.LockFileInfo])
-		}
-	}
-
-	return r0
-}
-
-// LockFile_DepsIter_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'DepsIter'
-type LockFile_DepsIter_Call struct {
-	*mock.Call
-}
-
-// DepsIter is a helper method to define mock.On call
-func (_e *LockFile_Expecter) DepsIter() *LockFile_DepsIter_Call {
-	return &LockFile_DepsIter_Call{Call: _e.mock.On("DepsIter")}
-}
-
-func (_c *LockFile_DepsIter_Call) Run(run func()) *LockFile_DepsIter_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run()
-	})
-	return _c
-}
-
-func (_c *LockFile_DepsIter_Call) Return(_a0 iter.Seq[models.LockFileInfo]) *LockFile_DepsIter_Call {
-	_c.Call.Return(_a0)
-	return _c
-}
-
-func (_c *LockFile_DepsIter_Call) RunAndReturn(run func() iter.Seq[models.LockFileInfo]) *LockFile_DepsIter_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// IsEmpty provides a mock function with given fields:
-func (_m *LockFile) IsEmpty() bool {
-	ret := _m.Called()
-
-	if len(ret) == 0 {
-		panic("no return value specified for IsEmpty")
-	}
-
-	var r0 bool
-	if rf, ok := ret.Get(0).(func() bool); ok {
-		r0 = rf()
-	} else {
-		r0 = ret.Get(0).(bool)
-	}
-
-	return r0
-}
-
-// LockFile_IsEmpty_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'IsEmpty'
-type LockFile_IsEmpty_Call struct {
-	*mock.Call
-}
-
-// IsEmpty is a helper method to define mock.On call
-func (_e *LockFile_Expecter) IsEmpty() *LockFile_IsEmpty_Call {
-	return &LockFile_IsEmpty_Call{Call: _e.mock.On("IsEmpty")}
-}
-
-func (_c *LockFile_IsEmpty_Call) Run(run func()) *LockFile_IsEmpty_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run()
-	})
-	return _c
-}
-
-func (_c *LockFile_IsEmpty_Call) Return(_a0 bool) *LockFile_IsEmpty_Call {
-	_c.Call.Return(_a0)
-	return _c
-}
-
-func (_c *LockFile_IsEmpty_Call) RunAndReturn(run func() bool) *LockFile_IsEmpty_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// Read provides a mock function with given fields: moduleName
-func (_m *LockFile) Read(moduleName string) (models.LockFileInfo, error) {
-	ret := _m.Called(moduleName)
-
-	if len(ret) == 0 {
-		panic("no return value specified for Read")
-	}
-
-	var r0 models.LockFileInfo
-	var r1 error
-	if rf, ok := ret.Get(0).(func(string) (models.LockFileInfo, error)); ok {
-		return rf(moduleName)
-	}
-	if rf, ok := ret.Get(0).(func(string) models.LockFileInfo); ok {
-		r0 = rf(moduleName)
-	} else {
-		r0 = ret.Get(0).(models.LockFileInfo)
-	}
-
-	if rf, ok := ret.Get(1).(func(string) error); ok {
-		r1 = rf(moduleName)
-	} else {
-		r1 = ret.Error(1)
-	}
-
-	return r0, r1
-}
-
-// LockFile_Read_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'Read'
-type LockFile_Read_Call struct {
-	*mock.Call
-}
-
-// Read is a helper method to define mock.On call
-//   - moduleName string
-func (_e *LockFile_Expecter) Read(moduleName interface{}) *LockFile_Read_Call {
-	return &LockFile_Read_Call{Call: _e.mock.On("Read", moduleName)}
-}
-
-func (_c *LockFile_Read_Call) Run(run func(moduleName string)) *LockFile_Read_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(string))
-	})
-	return _c
-}
-
-func (_c *LockFile_Read_Call) Return(_a0 models.LockFileInfo, _a1 error) *LockFile_Read_Call {
-	_c.Call.Return(_a0, _a1)
-	return _c
-}
-
-func (_c *LockFile_Read_Call) RunAndReturn(run func(string) (models.LockFileInfo, error)) *LockFile_Read_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// Write provides a mock function with given fields: moduleName, revisionVersion, installedPackageHash
-func (_m *LockFile) Write(moduleName string, revisionVersion string, installedPackageHash models.ModuleHash) error {
-	ret := _m.Called(moduleName, revisionVersion, installedPackageHash)
-
-	if len(ret) == 0 {
-		panic("no return value specified for Write")
-	}
-
-	var r0 error
-	if rf, ok := ret.Get(0).(func(string, string, models.ModuleHash) error); ok {
-		r0 = rf(moduleName, revisionVersion, installedPackageHash)
-	} else {
-		r0 = ret.Error(0)
-	}
-
-	return r0
-}
-
-// LockFile_Write_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'Write'
-type LockFile_Write_Call struct {
-	*mock.Call
-}
-
-// Write is a helper method to define mock.On call
-//   - moduleName string
-//   - revisionVersion string
-//   - installedPackageHash models.ModuleHash
-func (_e *LockFile_Expecter) Write(moduleName interface{}, revisionVersion interface{}, installedPackageHash interface{}) *LockFile_Write_Call {
-	return &LockFile_Write_Call{Call: _e.mock.On("Write", moduleName, revisionVersion, installedPackageHash)}
-}
-
-func (_c *LockFile_Write_Call) Run(run func(moduleName string, revisionVersion string, installedPackageHash models.ModuleHash)) *LockFile_Write_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(string), args[1].(string), args[2].(models.ModuleHash))
-	})
-	return _c
-}
-
-func (_c *LockFile_Write_Call) Return(_a0 error) *LockFile_Write_Call {
-	_c.Call.Return(_a0)
-	return _c
-}
-
-func (_c *LockFile_Write_Call) RunAndReturn(run func(string, string, models.ModuleHash) error) *LockFile_Write_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// NewLockFile creates a new instance of LockFile. It also registers a testing interface on the mock and a cleanup function to assert the mocks expectations.
-// The first argument is typically a *testing.T value.
-func NewLockFile(t interface {
-	mock.TestingT
-	Cleanup(func())
-}) *LockFile {
-	mock := &LockFile{}
-	mock.Mock.Test(t)
-
-	t.Cleanup(func() { mock.AssertExpectations(t) })
-
-	return mock
-}
diff --git a/internal/core/mocks/ModuleConfig.go b/internal/core/mocks/ModuleConfig.go
deleted file mode 100644
index 5e8d561c..00000000
--- a/internal/core/mocks/ModuleConfig.go
+++ /dev/null
@@ -1,98 +0,0 @@
-// Code generated by mockery. DO NOT EDIT.
-
-package mocks
-
-import (
-	context "context"
-
-	mock "github.com/stretchr/testify/mock"
-
-	models "github.com/easyp-tech/easyp/internal/core/models"
-
-	repository "github.com/easyp-tech/easyp/internal/adapters/repository"
-)
-
-// ModuleConfig is an autogenerated mock type for the ModuleConfig type
-type ModuleConfig struct {
-	mock.Mock
-}
-
-type ModuleConfig_Expecter struct {
-	mock *mock.Mock
-}
-
-func (_m *ModuleConfig) EXPECT() *ModuleConfig_Expecter {
-	return &ModuleConfig_Expecter{mock: &_m.Mock}
-}
-
-// ReadFromRepo provides a mock function with given fields: ctx, repo, revision
-func (_m *ModuleConfig) ReadFromRepo(ctx context.Context, repo repository.Repo, revision models.Revision) (models.ModuleConfig, error) {
-	ret := _m.Called(ctx, repo, revision)
-
-	if len(ret) == 0 {
-		panic("no return value specified for ReadFromRepo")
-	}
-
-	var r0 models.ModuleConfig
-	var r1 error
-	if rf, ok := ret.Get(0).(func(context.Context, repository.Repo, models.Revision) (models.ModuleConfig, error)); ok {
-		return rf(ctx, repo, revision)
-	}
-	if rf, ok := ret.Get(0).(func(context.Context, repository.Repo, models.Revision) models.ModuleConfig); ok {
-		r0 = rf(ctx, repo, revision)
-	} else {
-		r0 = ret.Get(0).(models.ModuleConfig)
-	}
-
-	if rf, ok := ret.Get(1).(func(context.Context, repository.Repo, models.Revision) error); ok {
-		r1 = rf(ctx, repo, revision)
-	} else {
-		r1 = ret.Error(1)
-	}
-
-	return r0, r1
-}
-
-// ModuleConfig_ReadFromRepo_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'ReadFromRepo'
-type ModuleConfig_ReadFromRepo_Call struct {
-	*mock.Call
-}
-
-// ReadFromRepo is a helper method to define mock.On call
-//   - ctx context.Context
-//   - repo repository.Repo
-//   - revision models.Revision
-func (_e *ModuleConfig_Expecter) ReadFromRepo(ctx interface{}, repo interface{}, revision interface{}) *ModuleConfig_ReadFromRepo_Call {
-	return &ModuleConfig_ReadFromRepo_Call{Call: _e.mock.On("ReadFromRepo", ctx, repo, revision)}
-}
-
-func (_c *ModuleConfig_ReadFromRepo_Call) Run(run func(ctx context.Context, repo repository.Repo, revision models.Revision)) *ModuleConfig_ReadFromRepo_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(context.Context), args[1].(repository.Repo), args[2].(models.Revision))
-	})
-	return _c
-}
-
-func (_c *ModuleConfig_ReadFromRepo_Call) Return(_a0 models.ModuleConfig, _a1 error) *ModuleConfig_ReadFromRepo_Call {
-	_c.Call.Return(_a0, _a1)
-	return _c
-}
-
-func (_c *ModuleConfig_ReadFromRepo_Call) RunAndReturn(run func(context.Context, repository.Repo, models.Revision) (models.ModuleConfig, error)) *ModuleConfig_ReadFromRepo_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// NewModuleConfig creates a new instance of ModuleConfig. It also registers a testing interface on the mock and a cleanup function to assert the mocks expectations.
-// The first argument is typically a *testing.T value.
-func NewModuleConfig(t interface {
-	mock.TestingT
-	Cleanup(func())
-}) *ModuleConfig {
-	mock := &ModuleConfig{}
-	mock.Mock.Test(t)
-
-	t.Cleanup(func() { mock.AssertExpectations(t) })
-
-	return mock
-}
diff --git a/internal/core/mocks/Rule.go b/internal/core/mocks/Rule.go
deleted file mode 100644
index f48b3c5a..00000000
--- a/internal/core/mocks/Rule.go
+++ /dev/null
@@ -1,138 +0,0 @@
-// Code generated by mockery. DO NOT EDIT.
-
-package mocks
-
-import (
-	core "github.com/easyp-tech/easyp/internal/core"
-	mock "github.com/stretchr/testify/mock"
-)
-
-// Rule is an autogenerated mock type for the Rule type
-type Rule struct {
-	mock.Mock
-}
-
-type Rule_Expecter struct {
-	mock *mock.Mock
-}
-
-func (_m *Rule) EXPECT() *Rule_Expecter {
-	return &Rule_Expecter{mock: &_m.Mock}
-}
-
-// Message provides a mock function with given fields:
-func (_m *Rule) Message() string {
-	ret := _m.Called()
-
-	if len(ret) == 0 {
-		panic("no return value specified for Message")
-	}
-
-	var r0 string
-	if rf, ok := ret.Get(0).(func() string); ok {
-		r0 = rf()
-	} else {
-		r0 = ret.Get(0).(string)
-	}
-
-	return r0
-}
-
-// Rule_Message_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'Message'
-type Rule_Message_Call struct {
-	*mock.Call
-}
-
-// Message is a helper method to define mock.On call
-func (_e *Rule_Expecter) Message() *Rule_Message_Call {
-	return &Rule_Message_Call{Call: _e.mock.On("Message")}
-}
-
-func (_c *Rule_Message_Call) Run(run func()) *Rule_Message_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run()
-	})
-	return _c
-}
-
-func (_c *Rule_Message_Call) Return(_a0 string) *Rule_Message_Call {
-	_c.Call.Return(_a0)
-	return _c
-}
-
-func (_c *Rule_Message_Call) RunAndReturn(run func() string) *Rule_Message_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// Validate provides a mock function with given fields: _a0
-func (_m *Rule) Validate(_a0 core.ProtoInfo) ([]core.Issue, error) {
-	ret := _m.Called(_a0)
-
-	if len(ret) == 0 {
-		panic("no return value specified for Validate")
-	}
-
-	var r0 []core.Issue
-	var r1 error
-	if rf, ok := ret.Get(0).(func(core.ProtoInfo) ([]core.Issue, error)); ok {
-		return rf(_a0)
-	}
-	if rf, ok := ret.Get(0).(func(core.ProtoInfo) []core.Issue); ok {
-		r0 = rf(_a0)
-	} else {
-		if ret.Get(0) != nil {
-			r0 = ret.Get(0).([]core.Issue)
-		}
-	}
-
-	if rf, ok := ret.Get(1).(func(core.ProtoInfo) error); ok {
-		r1 = rf(_a0)
-	} else {
-		r1 = ret.Error(1)
-	}
-
-	return r0, r1
-}
-
-// Rule_Validate_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'Validate'
-type Rule_Validate_Call struct {
-	*mock.Call
-}
-
-// Validate is a helper method to define mock.On call
-//   - _a0 core.ProtoInfo
-func (_e *Rule_Expecter) Validate(_a0 interface{}) *Rule_Validate_Call {
-	return &Rule_Validate_Call{Call: _e.mock.On("Validate", _a0)}
-}
-
-func (_c *Rule_Validate_Call) Run(run func(_a0 core.ProtoInfo)) *Rule_Validate_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(core.ProtoInfo))
-	})
-	return _c
-}
-
-func (_c *Rule_Validate_Call) Return(_a0 []core.Issue, _a1 error) *Rule_Validate_Call {
-	_c.Call.Return(_a0, _a1)
-	return _c
-}
-
-func (_c *Rule_Validate_Call) RunAndReturn(run func(core.ProtoInfo) ([]core.Issue, error)) *Rule_Validate_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// NewRule creates a new instance of Rule. It also registers a testing interface on the mock and a cleanup function to assert the mocks expectations.
-// The first argument is typically a *testing.T value.
-func NewRule(t interface {
-	mock.TestingT
-	Cleanup(func())
-}) *Rule {
-	mock := &Rule{}
-	mock.Mock.Test(t)
-
-	t.Cleanup(func() { mock.AssertExpectations(t) })
-
-	return mock
-}
diff --git a/internal/core/mocks/Storage.go b/internal/core/mocks/Storage.go
deleted file mode 100644
index dd54071b..00000000
--- a/internal/core/mocks/Storage.go
+++ /dev/null
@@ -1,406 +0,0 @@
-// Code generated by mockery. DO NOT EDIT.
-
-package mocks
-
-import (
-	"context"
-
-	models "github.com/easyp-tech/easyp/internal/core/models"
-	mock "github.com/stretchr/testify/mock"
-)
-
-// Storage is an autogenerated mock type for the Storage type
-type Storage struct {
-	mock.Mock
-}
-
-type Storage_Expecter struct {
-	mock *mock.Mock
-}
-
-func (_m *Storage) EXPECT() *Storage_Expecter {
-	return &Storage_Expecter{mock: &_m.Mock}
-}
-
-// CreateCacheDownloadDir provides a mock function with given fields: _a0
-func (_m *Storage) CreateCacheDownloadDir(_a0 models.CacheDownloadPaths) error {
-	ret := _m.Called(_a0)
-
-	if len(ret) == 0 {
-		panic("no return value specified for CreateCacheDownloadDir")
-	}
-
-	var r0 error
-	if rf, ok := ret.Get(0).(func(models.CacheDownloadPaths) error); ok {
-		r0 = rf(_a0)
-	} else {
-		r0 = ret.Error(0)
-	}
-
-	return r0
-}
-
-// Storage_CreateCacheDownloadDir_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'CreateCacheDownloadDir'
-type Storage_CreateCacheDownloadDir_Call struct {
-	*mock.Call
-}
-
-// CreateCacheDownloadDir is a helper method to define mock.On call
-//   - _a0 models.CacheDownloadPaths
-func (_e *Storage_Expecter) CreateCacheDownloadDir(_a0 interface{}) *Storage_CreateCacheDownloadDir_Call {
-	return &Storage_CreateCacheDownloadDir_Call{Call: _e.mock.On("CreateCacheDownloadDir", _a0)}
-}
-
-func (_c *Storage_CreateCacheDownloadDir_Call) Run(run func(_a0 models.CacheDownloadPaths)) *Storage_CreateCacheDownloadDir_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(models.CacheDownloadPaths))
-	})
-	return _c
-}
-
-func (_c *Storage_CreateCacheDownloadDir_Call) Return(_a0 error) *Storage_CreateCacheDownloadDir_Call {
-	_c.Call.Return(_a0)
-	return _c
-}
-
-func (_c *Storage_CreateCacheDownloadDir_Call) RunAndReturn(run func(models.CacheDownloadPaths) error) *Storage_CreateCacheDownloadDir_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// CreateCacheRepositoryDir provides a mock function with given fields: name
-func (_m *Storage) CreateCacheRepositoryDir(name string) (string, error) {
-	ret := _m.Called(name)
-
-	if len(ret) == 0 {
-		panic("no return value specified for CreateCacheRepositoryDir")
-	}
-
-	var r0 string
-	var r1 error
-	if rf, ok := ret.Get(0).(func(string) (string, error)); ok {
-		return rf(name)
-	}
-	if rf, ok := ret.Get(0).(func(string) string); ok {
-		r0 = rf(name)
-	} else {
-		r0 = ret.Get(0).(string)
-	}
-
-	if rf, ok := ret.Get(1).(func(string) error); ok {
-		r1 = rf(name)
-	} else {
-		r1 = ret.Error(1)
-	}
-
-	return r0, r1
-}
-
-// Storage_CreateCacheRepositoryDir_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'CreateCacheRepositoryDir'
-type Storage_CreateCacheRepositoryDir_Call struct {
-	*mock.Call
-}
-
-// CreateCacheRepositoryDir is a helper method to define mock.On call
-//   - name string
-func (_e *Storage_Expecter) CreateCacheRepositoryDir(name interface{}) *Storage_CreateCacheRepositoryDir_Call {
-	return &Storage_CreateCacheRepositoryDir_Call{Call: _e.mock.On("CreateCacheRepositoryDir", name)}
-}
-
-func (_c *Storage_CreateCacheRepositoryDir_Call) Run(run func(name string)) *Storage_CreateCacheRepositoryDir_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(string))
-	})
-	return _c
-}
-
-func (_c *Storage_CreateCacheRepositoryDir_Call) Return(_a0 string, _a1 error) *Storage_CreateCacheRepositoryDir_Call {
-	_c.Call.Return(_a0, _a1)
-	return _c
-}
-
-func (_c *Storage_CreateCacheRepositoryDir_Call) RunAndReturn(run func(string) (string, error)) *Storage_CreateCacheRepositoryDir_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// GetCacheDownloadPaths provides a mock function with given fields: module, revision
-func (_m *Storage) GetCacheDownloadPaths(module models.Module, revision models.Revision) models.CacheDownloadPaths {
-	ret := _m.Called(module, revision)
-
-	if len(ret) == 0 {
-		panic("no return value specified for GetCacheDownloadPaths")
-	}
-
-	var r0 models.CacheDownloadPaths
-	if rf, ok := ret.Get(0).(func(models.Module, models.Revision) models.CacheDownloadPaths); ok {
-		r0 = rf(module, revision)
-	} else {
-		r0 = ret.Get(0).(models.CacheDownloadPaths)
-	}
-
-	return r0
-}
-
-// Storage_GetCacheDownloadPaths_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'GetCacheDownloadPaths'
-type Storage_GetCacheDownloadPaths_Call struct {
-	*mock.Call
-}
-
-// GetCacheDownloadPaths is a helper method to define mock.On call
-//   - module models.Module
-//   - revision models.Revision
-func (_e *Storage_Expecter) GetCacheDownloadPaths(module interface{}, revision interface{}) *Storage_GetCacheDownloadPaths_Call {
-	return &Storage_GetCacheDownloadPaths_Call{Call: _e.mock.On("GetCacheDownloadPaths", module, revision)}
-}
-
-func (_c *Storage_GetCacheDownloadPaths_Call) Run(run func(module models.Module, revision models.Revision)) *Storage_GetCacheDownloadPaths_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(models.Module), args[1].(models.Revision))
-	})
-	return _c
-}
-
-func (_c *Storage_GetCacheDownloadPaths_Call) Return(_a0 models.CacheDownloadPaths) *Storage_GetCacheDownloadPaths_Call {
-	_c.Call.Return(_a0)
-	return _c
-}
-
-func (_c *Storage_GetCacheDownloadPaths_Call) RunAndReturn(run func(models.Module, models.Revision) models.CacheDownloadPaths) *Storage_GetCacheDownloadPaths_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// GetInstallDir provides a mock function with given fields: moduleName, revisionVersion
-func (_m *Storage) GetInstallDir(moduleName string, revisionVersion string) string {
-	ret := _m.Called(moduleName, revisionVersion)
-
-	if len(ret) == 0 {
-		panic("no return value specified for GetInstallDir")
-	}
-
-	var r0 string
-	if rf, ok := ret.Get(0).(func(string, string) string); ok {
-		r0 = rf(moduleName, revisionVersion)
-	} else {
-		r0 = ret.Get(0).(string)
-	}
-
-	return r0
-}
-
-// Storage_GetInstallDir_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'GetInstallDir'
-type Storage_GetInstallDir_Call struct {
-	*mock.Call
-}
-
-// GetInstallDir is a helper method to define mock.On call
-//   - moduleName string
-//   - revisionVersion string
-func (_e *Storage_Expecter) GetInstallDir(moduleName interface{}, revisionVersion interface{}) *Storage_GetInstallDir_Call {
-	return &Storage_GetInstallDir_Call{Call: _e.mock.On("GetInstallDir", moduleName, revisionVersion)}
-}
-
-func (_c *Storage_GetInstallDir_Call) Run(run func(moduleName string, revisionVersion string)) *Storage_GetInstallDir_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(string), args[1].(string))
-	})
-	return _c
-}
-
-func (_c *Storage_GetInstallDir_Call) Return(_a0 string) *Storage_GetInstallDir_Call {
-	_c.Call.Return(_a0)
-	return _c
-}
-
-func (_c *Storage_GetInstallDir_Call) RunAndReturn(run func(string, string) string) *Storage_GetInstallDir_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// GetInstalledModuleHash provides a mock function with given fields: moduleName, revisionVersion
-func (_m *Storage) GetInstalledModuleHash(moduleName string, revisionVersion string) (models.ModuleHash, error) {
-	ret := _m.Called(moduleName, revisionVersion)
-
-	if len(ret) == 0 {
-		panic("no return value specified for GetInstalledModuleHash")
-	}
-
-	var r0 models.ModuleHash
-	var r1 error
-	if rf, ok := ret.Get(0).(func(string, string) (models.ModuleHash, error)); ok {
-		return rf(moduleName, revisionVersion)
-	}
-	if rf, ok := ret.Get(0).(func(string, string) models.ModuleHash); ok {
-		r0 = rf(moduleName, revisionVersion)
-	} else {
-		r0 = ret.Get(0).(models.ModuleHash)
-	}
-
-	if rf, ok := ret.Get(1).(func(string, string) error); ok {
-		r1 = rf(moduleName, revisionVersion)
-	} else {
-		r1 = ret.Error(1)
-	}
-
-	return r0, r1
-}
-
-// Storage_GetInstalledModuleHash_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'GetInstalledModuleHash'
-type Storage_GetInstalledModuleHash_Call struct {
-	*mock.Call
-}
-
-// GetInstalledModuleHash is a helper method to define mock.On call
-//   - moduleName string
-//   - revisionVersion string
-func (_e *Storage_Expecter) GetInstalledModuleHash(moduleName interface{}, revisionVersion interface{}) *Storage_GetInstalledModuleHash_Call {
-	return &Storage_GetInstalledModuleHash_Call{Call: _e.mock.On("GetInstalledModuleHash", moduleName, revisionVersion)}
-}
-
-func (_c *Storage_GetInstalledModuleHash_Call) Run(run func(moduleName string, revisionVersion string)) *Storage_GetInstalledModuleHash_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(string), args[1].(string))
-	})
-	return _c
-}
-
-func (_c *Storage_GetInstalledModuleHash_Call) Return(_a0 models.ModuleHash, _a1 error) *Storage_GetInstalledModuleHash_Call {
-	_c.Call.Return(_a0, _a1)
-	return _c
-}
-
-func (_c *Storage_GetInstalledModuleHash_Call) RunAndReturn(run func(string, string) (models.ModuleHash, error)) *Storage_GetInstalledModuleHash_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// Install provides a mock function with given fields: ctx, cacheDownloadPaths, module, revision, moduleConfig
-func (_m *Storage) Install(ctx context.Context, cacheDownloadPaths models.CacheDownloadPaths, module models.Module, revision models.Revision, moduleConfig models.ModuleConfig) (models.ModuleHash, error) {
-	ret := _m.Called(ctx, cacheDownloadPaths, module, revision, moduleConfig)
-
-	if len(ret) == 0 {
-		panic("no return value specified for Install")
-	}
-
-	var r0 models.ModuleHash
-	var r1 error
-	if rf, ok := ret.Get(0).(func(context.Context, models.CacheDownloadPaths, models.Module, models.Revision, models.ModuleConfig) (models.ModuleHash, error)); ok {
-		return rf(ctx, cacheDownloadPaths, module, revision, moduleConfig)
-	}
-	if rf, ok := ret.Get(0).(func(context.Context, models.CacheDownloadPaths, models.Module, models.Revision, models.ModuleConfig) models.ModuleHash); ok {
-		r0 = rf(ctx, cacheDownloadPaths, module, revision, moduleConfig)
-	} else {
-		r0 = ret.Get(0).(models.ModuleHash)
-	}
-
-	if rf, ok := ret.Get(1).(func(context.Context, models.CacheDownloadPaths, models.Module, models.Revision, models.ModuleConfig) error); ok {
-		r1 = rf(ctx, cacheDownloadPaths, module, revision, moduleConfig)
-	} else {
-		r1 = ret.Error(1)
-	}
-
-	return r0, r1
-}
-
-// Storage_Install_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'Install'
-type Storage_Install_Call struct {
-	*mock.Call
-}
-
-// Install is a helper method to define mock.On call
-//   - ctx context.Context
-//   - cacheDownloadPaths models.CacheDownloadPaths
-//   - module models.Module
-//   - revision models.Revision
-//   - moduleConfig models.ModuleConfig
-func (_e *Storage_Expecter) Install(ctx interface{}, cacheDownloadPaths interface{}, module interface{}, revision interface{}, moduleConfig interface{}) *Storage_Install_Call {
-	return &Storage_Install_Call{Call: _e.mock.On("Install", ctx, cacheDownloadPaths, module, revision, moduleConfig)}
-}
-
-func (_c *Storage_Install_Call) Run(run func(ctx context.Context, cacheDownloadPaths models.CacheDownloadPaths, module models.Module, revision models.Revision, moduleConfig models.ModuleConfig)) *Storage_Install_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(context.Context), args[1].(models.CacheDownloadPaths), args[2].(models.Module), args[3].(models.Revision), args[4].(models.ModuleConfig))
-	})
-	return _c
-}
-
-func (_c *Storage_Install_Call) Return(_a0 models.ModuleHash, _a1 error) *Storage_Install_Call {
-	_c.Call.Return(_a0, _a1)
-	return _c
-}
-
-func (_c *Storage_Install_Call) RunAndReturn(run func(context.Context, models.CacheDownloadPaths, models.Module, models.Revision, models.ModuleConfig) (models.ModuleHash, error)) *Storage_Install_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// IsModuleInstalled provides a mock function with given fields: module
-func (_m *Storage) IsModuleInstalled(module models.Module) (bool, error) {
-	ret := _m.Called(module)
-
-	if len(ret) == 0 {
-		panic("no return value specified for IsModuleInstalled")
-	}
-
-	var r0 bool
-	var r1 error
-	if rf, ok := ret.Get(0).(func(models.Module) (bool, error)); ok {
-		return rf(module)
-	}
-	if rf, ok := ret.Get(0).(func(models.Module) bool); ok {
-		r0 = rf(module)
-	} else {
-		r0 = ret.Get(0).(bool)
-	}
-
-	if rf, ok := ret.Get(1).(func(models.Module) error); ok {
-		r1 = rf(module)
-	} else {
-		r1 = ret.Error(1)
-	}
-
-	return r0, r1
-}
-
-// Storage_IsModuleInstalled_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'IsModuleInstalled'
-type Storage_IsModuleInstalled_Call struct {
-	*mock.Call
-}
-
-// IsModuleInstalled is a helper method to define mock.On call
-//   - module models.Module
-func (_e *Storage_Expecter) IsModuleInstalled(module interface{}) *Storage_IsModuleInstalled_Call {
-	return &Storage_IsModuleInstalled_Call{Call: _e.mock.On("IsModuleInstalled", module)}
-}
-
-func (_c *Storage_IsModuleInstalled_Call) Run(run func(module models.Module)) *Storage_IsModuleInstalled_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(models.Module))
-	})
-	return _c
-}
-
-func (_c *Storage_IsModuleInstalled_Call) Return(_a0 bool, _a1 error) *Storage_IsModuleInstalled_Call {
-	_c.Call.Return(_a0, _a1)
-	return _c
-}
-
-func (_c *Storage_IsModuleInstalled_Call) RunAndReturn(run func(models.Module) (bool, error)) *Storage_IsModuleInstalled_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// NewStorage creates a new instance of Storage. It also registers a testing interface on the mock and a cleanup function to assert the mocks expectations.
-// The first argument is typically a *testing.T value.
-func NewStorage(t interface {
-	mock.TestingT
-	Cleanup(func())
-}) *Storage {
-	mock := &Storage{}
-	mock.Mock.Test(t)
-
-	t.Cleanup(func() { mock.AssertExpectations(t) })
-
-	return mock
-}
diff --git a/internal/core/mod.go b/internal/core/mod.go
deleted file mode 100644
index 9e62730b..00000000
--- a/internal/core/mod.go
+++ /dev/null
@@ -1,68 +0,0 @@
-package core
-
-//go:generate mockery --name Storage --dir . --output . --outpkg core --filename storage_mock_test.go --structname StorageMock --inpackage --testonly
-//go:generate mockery --name LockFile --dir . --output . --outpkg core --filename lockfile_mock_test.go --structname LockFileMock --inpackage --testonly
-
-import (
-	"context"
-	"iter"
-
-	"github.com/easyp-tech/easyp/internal/adapters/repository"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-type (
-	// Storage should implement workflow with storage adapter
-	Storage interface {
-		CreateCacheRepositoryDir(name string) (string, error)
-		CreateCacheDownloadDir(models.CacheDownloadPaths) error
-		GetCacheDownloadPaths(moduleName, version string) models.CacheDownloadPaths
-		Install(
-			ctx context.Context,
-			cacheDownloadPaths models.CacheDownloadPaths,
-			module models.Module,
-			revision models.Revision,
-			moduleConfig models.ModuleConfig,
-		) (models.ModuleHash, error)
-		GetInstalledModuleHash(moduleName string, revisionVersion string) (models.ModuleHash, error)
-		GetInstallDir(moduleName string, revisionVersion string) string
-
-		ReadInstalledModuleInfo(
-			cacheDownloadPaths models.CacheDownloadPaths,
-		) (models.InstalledModuleInfo, error)
-		WriteInstalledModuleInfo(
-			cacheDownloadPaths models.CacheDownloadPaths, installedModuleInfo models.InstalledModuleInfo,
-		) error
-	}
-
-	// ModuleConfig should implement adapter for reading module configs
-	ModuleConfig interface {
-		ReadFromRepo(ctx context.Context, repo repository.Repo, revision models.Revision) (models.ModuleConfig, error)
-	}
-
-	// LockFile should implement adapter for lock file workflow
-	LockFile interface {
-		Read(moduleName string) (models.LockFileInfo, error)
-		Write(
-			moduleName string, revisionVersion string, installedPackageHash models.ModuleHash,
-		) error
-		IsEmpty() bool
-		DepsIter() iter.Seq[models.LockFileInfo]
-	}
-
-	// Mod implement package manager's commands
-	//Mod struct {
-	//	storage      Storage
-	//	moduleConfig ModuleConfig
-	//	lockFile     LockFile
-	//}
-)
-
-//func New(storage Storage, moduleConfig ModuleConfig, lockFile LockFile) *Mod {
-//	return &Mod{
-//		storage:      storage,
-//		moduleConfig: moduleConfig,
-//		lockFile:     lockFile,
-//	}
-//}
diff --git a/internal/core/models/cache_download_paths.go b/internal/core/models/cache_download_paths.go
deleted file mode 100644
index 0b0b69ae..00000000
--- a/internal/core/models/cache_download_paths.go
+++ /dev/null
@@ -1,16 +0,0 @@
-package models
-
-// CacheDownloadPaths collects cache download paths to:
-// * archive
-// * file with archive hash
-// * info about downloaded module
-type CacheDownloadPaths struct {
-	// CacheDownload path to dir with downloaded cache
-	CacheDownloadDir string
-
-	// ArchiveFile full path to downloaded archive of module
-	ArchiveFile string
-
-	// ModuleInfoFile full path to file with info about downloaded module
-	ModuleInfoFile string
-}
diff --git a/internal/core/models/errors.go b/internal/core/models/errors.go
deleted file mode 100644
index c8346454..00000000
--- a/internal/core/models/errors.go
+++ /dev/null
@@ -1,13 +0,0 @@
-package models
-
-import (
-	"errors"
-)
-
-var (
-	ErrVersionNotFound        = errors.New("version not found")
-	ErrFileNotFound           = errors.New("file not found")
-	ErrModuleNotInstalled     = errors.New("module not installed")
-	ErrModuleInfoFileNotFound = errors.New("module info file not found")
-	ErrHashDependencyMismatch = errors.New("hash dependency mismatch")
-)
diff --git a/internal/core/models/lock_file_info.go b/internal/core/models/lock_file_info.go
deleted file mode 100644
index b6cc9b9e..00000000
--- a/internal/core/models/lock_file_info.go
+++ /dev/null
@@ -1,16 +0,0 @@
-package models
-
-import (
-	"errors"
-)
-
-// LockFileInfo contains information about module from lock file
-type LockFileInfo struct {
-	Name    string
-	Version string
-	Hash    ModuleHash
-}
-
-var (
-	ErrModuleNotFoundInLockFile = errors.New("module not found in lock file")
-)
diff --git a/internal/core/models/module.go b/internal/core/models/module.go
deleted file mode 100644
index 1238e6e2..00000000
--- a/internal/core/models/module.go
+++ /dev/null
@@ -1,108 +0,0 @@
-package models
-
-import (
-	"errors"
-	"strings"
-)
-
-const (
-	// If version was omitted
-	Omitted RequestedVersion = ""
-
-	// generated version prefix
-	generatedVersionPrefix = "v0.0.0"
-	// generated version looks like: v0.0.0-20240222234643-814bf88cf225
-	// prefix + datetime + commit
-	generatedVersionPartsCount = 3
-	generatedVersionSep        = "-"
-)
-
-type (
-	// ModuleHash alias for module's hash
-	// used in lock file for verification
-	ModuleHash string
-
-	// RequestedVersion for installing
-	RequestedVersion string
-)
-
-var (
-	ErrRequestedVersionNotGenerated = errors.New("requested version is not generated")
-)
-
-// Module contain requested dependency name and its version
-type Module struct {
-	Name    string           // Full path on remote repository
-	Version RequestedVersion // Version obtained from config (Omitted if version was omitted)
-}
-
-// InstalledModuleInfo contain info about installed module (dep) in system (near the zip archive)
-type InstalledModuleInfo struct {
-	ModuleName      string
-	Hash            ModuleHash
-	RevisionVersion string
-}
-
-type GeneratedVersionParts struct {
-	Datetime   string
-	CommitHash string
-}
-
-// NewModule create Module struct from raw dependency string: remote@version
-// dependency string format: origin@version: github.com/company/repository@v1.2.3
-func NewModule(dependency string) Module {
-	parts := strings.Split(dependency, "@")
-	name := parts[0]
-	version := Omitted // by default set version as Omitted
-	if len(parts) > 1 {
-		version = RequestedVersion(parts[1])
-	}
-	return Module{
-		Name:    name,
-		Version: version,
-	}
-}
-
-// NewModuleFromLockFileInfo create Module struct from LockFileInfo struct
-func NewModuleFromLockFileInfo(lockFileInfo LockFileInfo) Module {
-	return Module{
-		Name:    lockFileInfo.Name,
-		Version: RequestedVersion(lockFileInfo.Version),
-	}
-}
-
-// GetParts return parts of GeneratedVersion
-// if RequestedVersion is not generated return error
-func (v RequestedVersion) GetParts() (GeneratedVersionParts, error) {
-	parts := strings.Split(string(v), generatedVersionSep)
-	if len(parts) != generatedVersionPartsCount {
-		return GeneratedVersionParts{}, ErrRequestedVersionNotGenerated
-	}
-
-	if parts[0] != generatedVersionPrefix {
-		return GeneratedVersionParts{}, ErrRequestedVersionNotGenerated
-	}
-
-	ver := GeneratedVersionParts{
-		Datetime:   parts[1],
-		CommitHash: parts[2],
-	}
-	return ver, nil
-}
-
-// IsGenerated check if requested was generated and it's not a commit's tag
-// like v0.0.0-20240222234643-814bf88cf225 in go mod
-func (v RequestedVersion) IsGenerated() bool {
-	_, err := v.GetParts()
-
-	return err == nil
-}
-
-// IsOmitted check if requested version is omitted
-func (v RequestedVersion) IsOmitted() bool {
-	return v == Omitted
-}
-
-func (g GeneratedVersionParts) GetVersionString() string {
-	return generatedVersionPrefix + generatedVersionSep + g.Datetime + generatedVersionSep + g.CommitHash
-}
diff --git a/internal/core/models/module_config.go b/internal/core/models/module_config.go
deleted file mode 100644
index 7eaed430..00000000
--- a/internal/core/models/module_config.go
+++ /dev/null
@@ -1,11 +0,0 @@
-package models
-
-// ModuleConfig contains module config such as dirs from buf.work.yaml
-type ModuleConfig struct {
-	// Directories contains dirs with proto files (buf.work.yaml)
-	Directories []string
-
-	// Dependencies contains list of required dependencies in repository
-	// it could be from easyp.yaml or from buf
-	Dependencies []Module
-}
diff --git a/internal/core/models/module_test.go b/internal/core/models/module_test.go
deleted file mode 100644
index ef00e2a6..00000000
--- a/internal/core/models/module_test.go
+++ /dev/null
@@ -1,180 +0,0 @@
-package models
-
-import (
-	"testing"
-
-	"github.com/stretchr/testify/require"
-)
-
-func Test_NewModule(t *testing.T) {
-	tests := map[string]struct {
-		dependency     string
-		expectedResult Module
-	}{
-		"with version": {
-			dependency: "github.com/company/repository@v1.2.3",
-			expectedResult: Module{
-				Name:    "github.com/company/repository",
-				Version: "v1.2.3",
-			},
-		},
-		"without version": {
-			dependency: "github.com/company/repository",
-			expectedResult: Module{
-				Name:    "github.com/company/repository",
-				Version: Omitted,
-			},
-		},
-	}
-
-	for name, tc := range tests {
-		name, tc := name, tc
-		t.Run(name, func(t *testing.T) {
-			result := NewModule(tc.dependency)
-			require.Equal(t, tc.expectedResult, result)
-		})
-	}
-}
-
-func Test_RequestedVersion_GetParts(t *testing.T) {
-	tests := map[string]struct {
-		requestedVersion RequestedVersion
-		expectedResult   GeneratedVersionParts
-		expectedError    bool
-	}{
-		"not generated, simple tag": {
-			requestedVersion: RequestedVersion("v1.2.3"),
-			expectedResult:   GeneratedVersionParts{},
-			expectedError:    true,
-		},
-		"not generated, tag with no `v` prefix": {
-			requestedVersion: RequestedVersion("some_tag"),
-			expectedResult:   GeneratedVersionParts{},
-			expectedError:    true,
-		},
-		"not generated, with `-`": {
-			requestedVersion: RequestedVersion("v1.2.3-rc"),
-			expectedResult:   GeneratedVersionParts{},
-			expectedError:    true,
-		},
-		"not generated, with several `-`": {
-			requestedVersion: RequestedVersion("v1.2.3-rc-111222"),
-			expectedResult:   GeneratedVersionParts{},
-			expectedError:    true,
-		},
-		"Use Omitted": {
-			requestedVersion: Omitted,
-			expectedResult:   GeneratedVersionParts{},
-			expectedError:    true,
-		},
-		"generated": {
-			requestedVersion: "v0.0.0-20240222234643-814bf88cf225",
-			expectedResult:   GeneratedVersionParts{Datetime: "20240222234643", CommitHash: "814bf88cf225"},
-			expectedError:    false,
-		},
-	}
-
-	for name, tc := range tests {
-		name, tc := name, tc
-		t.Run(name, func(t *testing.T) {
-			result, err := tc.requestedVersion.GetParts()
-
-			require.Equal(t, tc.expectedResult, result)
-
-			if tc.expectedError {
-				require.ErrorIs(t, err, ErrRequestedVersionNotGenerated)
-				return
-			}
-
-			require.NoError(t, err)
-		})
-	}
-}
-
-func Test_RequestedVersion_IsGenerated(t *testing.T) {
-	tests := map[string]struct {
-		requestedVersion RequestedVersion
-		expectedResult   bool
-	}{
-		"not generated, simple tag": {
-			requestedVersion: RequestedVersion("v1.2.3"),
-			expectedResult:   false,
-		},
-		"not generated, tag with no `v` prefix": {
-			requestedVersion: RequestedVersion("some_tag"),
-			expectedResult:   false,
-		},
-		"not generated, with `-`": {
-			requestedVersion: RequestedVersion("v1.2.3-rc"),
-			expectedResult:   false,
-		},
-		"not generated, with several `-`": {
-			requestedVersion: RequestedVersion("v1.2.3-rc-111222"),
-			expectedResult:   false,
-		},
-		"Use Omitted": {
-			requestedVersion: Omitted,
-			expectedResult:   false,
-		},
-		"generated": {
-			requestedVersion: "v0.0.0-20240222234643-814bf88cf225",
-			expectedResult:   true,
-		},
-	}
-
-	for name, tc := range tests {
-		name, tc := name, tc
-		t.Run(name, func(t *testing.T) {
-			result := tc.requestedVersion.IsGenerated()
-			require.Equal(t, tc.expectedResult, result)
-		})
-	}
-}
-
-func Test_RequestedVersion_IsOmitted(t *testing.T) {
-	tests := map[string]struct {
-		requestedVersion RequestedVersion
-		expectedResult   bool
-	}{
-		"not omitted": {
-			requestedVersion: RequestedVersion("v1.2.3"),
-			expectedResult:   false,
-		},
-		"omitted": {
-			requestedVersion: Omitted,
-			expectedResult:   true,
-		},
-	}
-
-	for name, tc := range tests {
-		name, tc := name, tc
-		t.Run(name, func(t *testing.T) {
-			result := tc.requestedVersion.IsOmitted()
-			require.Equal(t, tc.expectedResult, result)
-		})
-	}
-}
-
-func Test_GeneratedVersionParts_GetVersionString(t *testing.T) {
-	tests := map[string]struct {
-		parts          GeneratedVersionParts
-		expectedResult string
-	}{
-		"case 1": {
-			parts:          GeneratedVersionParts{Datetime: "20240222234643", CommitHash: "814bf88cf225"},
-			expectedResult: "v0.0.0-20240222234643-814bf88cf225",
-		},
-		"case 2": {
-			parts:          GeneratedVersionParts{Datetime: "20230212224650", CommitHash: "914af88cf235"},
-			expectedResult: "v0.0.0-20230212224650-914af88cf235",
-		},
-	}
-
-	for name, tc := range tests {
-		name, tc := name, tc
-		t.Run(name, func(t *testing.T) {
-			result := tc.parts.GetVersionString()
-			require.Equal(t, tc.expectedResult, result)
-		})
-	}
-}
diff --git a/internal/core/models/revision.go b/internal/core/models/revision.go
deleted file mode 100644
index d0052ebe..00000000
--- a/internal/core/models/revision.go
+++ /dev/null
@@ -1,8 +0,0 @@
-package models
-
-// Revision collects references to module's commit
-// Revision is actual module information from repository
-type Revision struct {
-	CommitHash string // commit's hash
-	Version    string // commit's tag or generated version
-}
diff --git a/internal/core/module_path.go b/internal/core/module_path.go
deleted file mode 100644
index bc6d2207..00000000
--- a/internal/core/module_path.go
+++ /dev/null
@@ -1,24 +0,0 @@
-package core
-
-import (
-	"fmt"
-	"os"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-// modulePath resolves install path for a module using lock file information.
-// It ensures the path exists to surface missing installs early.
-func (c *Core) modulePath(module models.Module) (string, error) {
-	lockInfo, err := c.lockFile.Read(module.Name)
-	if err != nil {
-		return "", fmt.Errorf("lockFile.Read: %w", err)
-	}
-
-	modulePath := c.storage.GetInstallDir(lockInfo.Name, lockInfo.Version)
-	if _, err := os.Stat(modulePath); err != nil {
-		return "", fmt.Errorf("os.Stat: %w", err)
-	}
-
-	return modulePath, nil
-}
diff --git a/internal/core/path_helpers/is_target_path.go b/internal/core/path_helpers/is_target_path.go
index 6da567b5..3f9ac084 100644
--- a/internal/core/path_helpers/is_target_path.go
+++ b/internal/core/path_helpers/is_target_path.go
@@ -1,9 +1,7 @@
 package path_helpers
 
 import (
-	"os"
 	"path/filepath"
-	"strings"
 )
 
 // IsTargetPath check if passed filePath is target
@@ -21,14 +19,12 @@ func IsTargetPath(targetPath, filePath string) bool {
 }
 
 func IsIgnoredPath(path string, ignore []string) bool {
-	up := ".." + string(os.PathSeparator)
-
 	for _, ignorePath := range ignore {
 		rel, err := filepath.Rel(ignorePath, path)
 		if err != nil {
 			continue
 		}
-		if strings.HasPrefix(rel, up) && rel != ".." {
+		if !filepath.IsLocal(rel) {
 			continue
 		}
 		return true
diff --git a/internal/core/path_helpers/v1_source.go b/internal/core/path_helpers/v1_source.go
new file mode 100644
index 00000000..c1888f6f
--- /dev/null
+++ b/internal/core/path_helpers/v1_source.go
@@ -0,0 +1,31 @@
+package path_helpers
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+)
+
+// ShouldSkipV1SourceDir reports whether a directory under a v1 module root
+// belongs to a nested module or to hidden local state rather than its sources.
+func ShouldSkipV1SourceDir(root, path string) bool {
+	if filepath.Clean(path) == filepath.Clean(root) {
+		return false
+	}
+	info, err := os.Stat(path)
+	if err != nil || !info.IsDir() {
+		return false
+	}
+	if strings.HasPrefix(filepath.Base(path), ".") {
+		return true
+	}
+	if filepath.Base(path) == "easyp_vendor" {
+		return true
+	}
+	for _, name := range []string{"protobuf.mod", "buf.work.yaml", "buf.yaml"} {
+		if _, err := os.Stat(filepath.Join(path, name)); err == nil {
+			return true
+		}
+	}
+	return false
+}
diff --git a/internal/core/path_helpers/v1_source_test.go b/internal/core/path_helpers/v1_source_test.go
new file mode 100644
index 00000000..d2e3acf8
--- /dev/null
+++ b/internal/core/path_helpers/v1_source_test.go
@@ -0,0 +1,42 @@
+package path_helpers
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+)
+
+func TestShouldSkipV1SourceDir(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	for _, name := range []string{".cache", "buf-module", "legacy-module", "regular", "easyp_vendor"} {
+		if err := os.MkdirAll(filepath.Join(root, name), 0o755); err != nil {
+			t.Fatal(err)
+		}
+	}
+	for path, content := range map[string]string{
+		filepath.Join(root, "buf-module", "buf.yaml"):        "version: v2\n",
+		filepath.Join(root, "legacy-module", "protobuf.mod"): "direct (\n)\n",
+	} {
+		if err := os.WriteFile(path, []byte(content), 0o644); err != nil {
+			t.Fatal(err)
+		}
+	}
+	for _, tc := range []struct {
+		name string
+		skip bool
+	}{
+		{".", false},
+		{".cache", true},
+		{"buf-module", true},
+		{"legacy-module", true},
+		{"easyp_vendor", true},
+		{"regular", false},
+	} {
+		t.Run(tc.name, func(t *testing.T) {
+			if got := ShouldSkipV1SourceDir(root, filepath.Join(root, tc.name)); got != tc.skip {
+				t.Fatalf("skip = %t, want %t", got, tc.skip)
+			}
+		})
+	}
+}
diff --git a/internal/core/proto_info_read.go b/internal/core/proto_info_read.go
index 217f3d71..8d38f948 100644
--- a/internal/core/proto_info_read.go
+++ b/internal/core/proto_info_read.go
@@ -2,6 +2,7 @@ package core
 
 import (
 	"context"
+	"errors"
 	"fmt"
 	"io"
 	"os"
@@ -10,14 +11,13 @@ import (
 	"github.com/yoheimuta/go-protoparser/v4"
 	"github.com/yoheimuta/go-protoparser/v4/interpret/unordered"
 
-	"github.com/easyp-tech/easyp/internal/core/models"
 	"github.com/easyp-tech/easyp/wellknownimports"
 )
 
 func (c *Core) protoInfoRead(ctx context.Context, fs FS, path string) (ProtoInfo, error) {
 	f, err := fs.Open(path)
 	if err != nil {
-		return ProtoInfo{}, fmt.Errorf("fs.Open: %w", err)
+		return ProtoInfo{}, fmt.Errorf("Open: %w", err)
 	}
 	defer c.close(ctx, f, path)
 
@@ -36,18 +36,19 @@ func (c *Core) protoInfoRead(ctx context.Context, fs FS, path string) (ProtoInfo
 		Info:                 protoFile,
 		ProtoFilesFromImport: protoFilesFromImport,
 	}
+	protoInfo.ImportPath = c.sourceImportPath(fs, path)
 	return protoInfo, nil
 }
 
 func readProtoFile(f io.Reader) (*unordered.Proto, error) {
 	got, err := protoparser.Parse(f)
 	if err != nil {
-		return nil, fmt.Errorf("protoparser.Parse: %w", err)
+		return nil, fmt.Errorf("Parse: %w", err)
 	}
 
 	proto, err := unordered.InterpretProto(got)
 	if err != nil {
-		return nil, fmt.Errorf("unordered.InterpretProto: %w", err)
+		return nil, fmt.Errorf("InterpretProto: %w", err)
 	}
 
 	return proto, nil
@@ -73,63 +74,81 @@ func (c *Core) readFilesFromImport(
 }
 
 func (c *Core) readFileFromImport(ctx context.Context, disk FS, importName string) (*unordered.Proto, error) {
-	// first try to read it locally
-	f, err := disk.Open(importName)
-	if err == nil {
-		// locally import
-		defer c.close(ctx, f, importName)
-
-		proto, err := readProtoFile(f)
-		if err != nil {
-			return nil, fmt.Errorf("readProtoFile: %w, path: %s", err, importName)
-		}
-		return proto, nil
+	f, err := c.openImportFile(disk, importName)
+	if err != nil {
+		return nil, fmt.Errorf("openImportFile: %w", err)
 	}
+	defer c.close(ctx, f, importName)
 
-	for _, dep := range c.deps {
-		module := models.NewModule(dep)
-
-		lockFileInfo, err := c.lockFile.Read(module.Name)
-		if err != nil {
-			return nil, fmt.Errorf("lockFile.Read: %w", err)
-		}
+	proto, err := readProtoFile(f)
+	if err != nil {
+		return nil, fmt.Errorf("readProtoFile: %w", &os.PathError{Op: "parse", Path: importName, Err: err})
+	}
+	return proto, nil
+}
 
-		modulePath := c.storage.GetInstallDir(lockFileInfo.Name, lockFileInfo.Version)
+func (c *Core) openImportFile(disk FS, importName string) (io.ReadCloser, error) {
+	if !filepath.IsLocal(importName) {
+		return nil, fmt.Errorf("invalid import path %q", importName)
+	}
+	var f io.ReadCloser
+	var err error
+	allowed := true
+	if rooted, ok := disk.(interface{ RootPath() string }); ok && c.importFileAllowed != nil {
+		allowed = c.importFileAllowed(filepath.Join(rooted.RootPath(), importName))
+	}
+	if allowed {
+		f, err = disk.Open(importName)
+	} else {
+		err = os.ErrNotExist
+	}
+	switch {
+	case errors.Is(err, os.ErrNotExist):
+		// Search dependency roots when the current filesystem has no matching file.
+	case err != nil:
+		return nil, fmt.Errorf("Open: %w", err)
+	default:
+		return f, nil
+	}
 
-		fullPath := filepath.Join(modulePath, importName)
-		f, err = os.Open(fullPath)
+	for _, root := range c.importRoots {
+		fullPath := filepath.Join(root, importName)
+		f, err := c.openSourceFile(fullPath)
 		if err != nil {
-			if os.IsNotExist(err) {
+			if errors.Is(err, os.ErrNotExist) {
 				continue
 			}
-
-			return nil, fmt.Errorf("os.Open: %w", err)
-		}
-		defer c.close(ctx, f, fullPath)
-
-		proto, err := readProtoFile(f)
-		if err != nil {
-			return nil, fmt.Errorf("readProtoFile: %w, path: %s", err, importName)
+			return nil, fmt.Errorf("Open: %w", err)
 		}
-
-		return proto, nil
+		return f, nil
 	}
 
 	f, err = wellknownimports.Content.Open(importName)
 	if err != nil {
-		if os.IsNotExist(err) {
-			//return nil, ErrOpenImportFile
+		if errors.Is(err, os.ErrNotExist) {
 			return nil, &OpenImportFileError{FileName: importName}
 		}
-
-		return nil, fmt.Errorf("os.Open: %w", err)
+		return nil, fmt.Errorf("Open: %w", err)
 	}
-	defer c.close(ctx, f, importName)
+	return f, nil
+}
 
-	proto, err := readProtoFile(f)
-	if err != nil {
-		return nil, fmt.Errorf("readProtoFile: %w, path: %s", err, importName)
+// sourceImportPath separates the import identity from the user-facing scan path.
+func (c *Core) sourceImportPath(disk FS, name string) string {
+	rooted, ok := disk.(interface{ RootPath() string })
+	if !ok {
+		return ""
 	}
-
-	return proto, nil
+	full := filepath.Join(rooted.RootPath(), filepath.FromSlash(name))
+	var best string
+	for _, root := range c.importRoots {
+		relative, err := filepath.Rel(root, full)
+		if err != nil || !filepath.IsLocal(relative) {
+			continue
+		}
+		if best == "" || len(relative) < len(best) {
+			best = relative
+		}
+	}
+	return filepath.ToSlash(best)
 }
diff --git a/internal/core/proto_info_read_test.go b/internal/core/proto_info_read_test.go
new file mode 100644
index 00000000..bbaedd4a
--- /dev/null
+++ b/internal/core/proto_info_read_test.go
@@ -0,0 +1,162 @@
+package core
+
+import (
+	"errors"
+	"fmt"
+	"io"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/fs/fs"
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestReadFileFromImportSearchOrder(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name          string
+		localPackage  string
+		firstPackage  string
+		secondPackage string
+		wantPackage   PackageName
+	}{
+		{name: "local_before_dependencies", localPackage: "local", firstPackage: "first", secondPackage: "second", wantPackage: "local"},
+		{name: "first_dependency_root", firstPackage: "first", secondPackage: "second", wantPackage: "first"},
+		{name: "skip_missing_dependency_root", secondPackage: "second", wantPackage: "second"},
+		{name: "well_known_imports_last", wantPackage: "google.protobuf"},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			project, first, second := t.TempDir(), t.TempDir(), t.TempDir()
+			const importName = "google/protobuf/empty.proto"
+			for root, pkg := range map[string]string{project: tt.localPackage, first: tt.firstPackage, second: tt.secondPackage} {
+				if pkg == "" {
+					continue
+				}
+				content := fmt.Sprintf("syntax = \"proto3\"; package %s; message Empty {}", pkg)
+				writeImportSource(t, root, importName, content)
+			}
+			app := &Core{logger: logger.NewNop(), importRoots: []string{first, second}}
+
+			file, err := app.readFileFromImport(t.Context(), fs.NewFSWalker(project, "."), importName)
+
+			require.NoError(t, err)
+			assert.Equal(t, tt.wantPackage, GetPackageName(file))
+		})
+	}
+}
+
+func TestReadFileFromImportClosesOpenedFile(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name        string
+		content     string
+		wantMessage string
+	}{
+		{name: "valid_proto", content: `syntax = "proto3"; message Item {}`},
+		{name: "invalid_proto", content: "invalid proto", wantMessage: "parse item.proto"},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			path := writeImportSource(t, t.TempDir(), "item.proto", tt.content)
+			file, err := os.Open(path)
+			require.NoError(t, err)
+			t.Cleanup(func() {
+				err := file.Close()
+				if !errors.Is(err, os.ErrClosed) {
+					assert.NoError(t, err)
+				}
+			})
+			disk := &mockImportFS{file: file}
+			app := &Core{logger: logger.NewNop()}
+
+			_, err = app.readFileFromImport(t.Context(), disk, "item.proto")
+
+			if tt.wantMessage != "" {
+				assert.ErrorContains(t, err, tt.wantMessage)
+			} else {
+				assert.NoError(t, err)
+			}
+			_, err = file.Read(make([]byte, 1))
+			assert.ErrorIs(t, err, os.ErrClosed)
+		})
+	}
+}
+
+func TestReadFileFromImportPreservesErrors(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name        string
+		importName  string
+		openErr     error
+		wantErr     error
+		wantMissing bool
+		wantMessage string
+	}{
+		{
+			name:       "permission_error_prevents_fallback",
+			importName: "google/protobuf/empty.proto",
+			openErr:    fmt.Errorf("denied: %w", os.ErrPermission),
+			wantErr:    os.ErrPermission,
+		},
+		{name: "missing_import", importName: "missing.proto", openErr: os.ErrNotExist, wantMissing: true},
+		{name: "path_leaves_root", importName: "../item.proto", openErr: os.ErrPermission, wantMessage: "invalid import path"},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			app := &Core{logger: logger.NewNop()}
+			disk := &mockImportFS{err: tt.openErr}
+
+			_, err := app.readFileFromImport(t.Context(), disk, tt.importName)
+
+			switch {
+			case tt.wantErr != nil:
+				require.ErrorIs(t, err, tt.wantErr)
+			case tt.wantMissing:
+				var missing *OpenImportFileError
+				require.ErrorAs(t, err, &missing)
+				assert.Equal(t, tt.importName, missing.FileName)
+			default:
+				require.ErrorContains(t, err, tt.wantMessage)
+			}
+		})
+	}
+}
+
+func writeImportSource(t *testing.T, root, name, content string) string {
+	t.Helper()
+
+	path := filepath.Join(root, name)
+	require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+	require.NoError(t, os.WriteFile(path, []byte(content), 0o644))
+	return path
+}
+
+type mockImportFS struct {
+	FS
+	file io.ReadCloser
+	err  error
+}
+
+func (f *mockImportFS) Open(string) (io.ReadCloser, error) {
+	return f.file, f.err
+}
diff --git a/internal/core/proto_info_v1_test.go b/internal/core/proto_info_v1_test.go
new file mode 100644
index 00000000..3da01604
--- /dev/null
+++ b/internal/core/proto_info_v1_test.go
@@ -0,0 +1,41 @@
+package core
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/fs/fs"
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestReadFileFromImportUsesV1Roots(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name       string
+		importPath string
+	}{
+		{name: "root import", importPath: "dep.proto"},
+		{name: "nested import", importPath: "dep/v1/dep.proto"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			project, dependency := t.TempDir(), t.TempDir()
+			path := filepath.Join(dependency, tt.importPath)
+			require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+			require.NoError(t, os.WriteFile(path, []byte("syntax = \"proto3\"; package dep.v1; message Dep {}\n"), 0o644))
+			roots := []string{dependency}
+			app := New(Options{Logger: logger.NewNop(), ImportRoots: roots})
+			roots[0] = t.TempDir()
+
+			parsed, err := app.readFileFromImport(t.Context(), fs.NewFSWalker(project, "."), tt.importPath)
+
+			require.NoError(t, err)
+			require.NotNil(t, parsed)
+		})
+	}
+}
diff --git a/internal/core/source_accessor.go b/internal/core/source_accessor.go
new file mode 100644
index 00000000..12e04f79
--- /dev/null
+++ b/internal/core/source_accessor.go
@@ -0,0 +1,14 @@
+package core
+
+import (
+	"io"
+	"os"
+)
+
+// openSourceFile is shared by descriptor compilation and syntax-based import lookup.
+func (c *Core) openSourceFile(path string) (io.ReadCloser, error) {
+	if c.importFileAllowed != nil && !c.importFileAllowed(path) {
+		return nil, &os.PathError{Op: "open", Path: path, Err: os.ErrNotExist}
+	}
+	return os.Open(path)
+}
diff --git a/internal/core/source_import_path_test.go b/internal/core/source_import_path_test.go
new file mode 100644
index 00000000..98d18b24
--- /dev/null
+++ b/internal/core/source_import_path_test.go
@@ -0,0 +1,26 @@
+package core
+
+import (
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+
+	disk "github.com/easyp-tech/easyp/internal/fs/fs"
+)
+
+func TestSourceImportPathDoesNotDependOnScanRoot(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	for _, tt := range []struct{ name, scanRoot, path string }{
+		{name: "repository", scanRoot: root, path: "proto/foo/v1/item.proto"},
+		{name: "source root", scanRoot: filepath.Join(root, "proto"), path: "foo/v1/item.proto"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			engine := &Core{importRoots: []string{root, filepath.Join(root, "proto"), filepath.Join(root, "dependency")}}
+			got := engine.sourceImportPath(disk.NewFSWalker(tt.scanRoot, "."), tt.path)
+			require.Equal(t, "foo/v1/item.proto", got)
+		})
+	}
+}
diff --git a/internal/core/storage_mock_test.go b/internal/core/storage_mock_test.go
deleted file mode 100644
index 56e28e9d..00000000
--- a/internal/core/storage_mock_test.go
+++ /dev/null
@@ -1,453 +0,0 @@
-// Code generated by mockery. DO NOT EDIT.
-
-package core
-
-import (
-	context "context"
-
-	models "github.com/easyp-tech/easyp/internal/core/models"
-	mock "github.com/stretchr/testify/mock"
-)
-
-// StorageMock is an autogenerated mock type for the Storage type
-type StorageMock struct {
-	mock.Mock
-}
-
-type StorageMock_Expecter struct {
-	mock *mock.Mock
-}
-
-func (_m *StorageMock) EXPECT() *StorageMock_Expecter {
-	return &StorageMock_Expecter{mock: &_m.Mock}
-}
-
-// CreateCacheDownloadDir provides a mock function with given fields: _a0
-func (_m *StorageMock) CreateCacheDownloadDir(_a0 models.CacheDownloadPaths) error {
-	ret := _m.Called(_a0)
-
-	if len(ret) == 0 {
-		panic("no return value specified for CreateCacheDownloadDir")
-	}
-
-	var r0 error
-	if rf, ok := ret.Get(0).(func(models.CacheDownloadPaths) error); ok {
-		r0 = rf(_a0)
-	} else {
-		r0 = ret.Error(0)
-	}
-
-	return r0
-}
-
-// StorageMock_CreateCacheDownloadDir_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'CreateCacheDownloadDir'
-type StorageMock_CreateCacheDownloadDir_Call struct {
-	*mock.Call
-}
-
-// CreateCacheDownloadDir is a helper method to define mock.On call
-//   - _a0 models.CacheDownloadPaths
-func (_e *StorageMock_Expecter) CreateCacheDownloadDir(_a0 interface{}) *StorageMock_CreateCacheDownloadDir_Call {
-	return &StorageMock_CreateCacheDownloadDir_Call{Call: _e.mock.On("CreateCacheDownloadDir", _a0)}
-}
-
-func (_c *StorageMock_CreateCacheDownloadDir_Call) Run(run func(_a0 models.CacheDownloadPaths)) *StorageMock_CreateCacheDownloadDir_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(models.CacheDownloadPaths))
-	})
-	return _c
-}
-
-func (_c *StorageMock_CreateCacheDownloadDir_Call) Return(_a0 error) *StorageMock_CreateCacheDownloadDir_Call {
-	_c.Call.Return(_a0)
-	return _c
-}
-
-func (_c *StorageMock_CreateCacheDownloadDir_Call) RunAndReturn(run func(models.CacheDownloadPaths) error) *StorageMock_CreateCacheDownloadDir_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// CreateCacheRepositoryDir provides a mock function with given fields: name
-func (_m *StorageMock) CreateCacheRepositoryDir(name string) (string, error) {
-	ret := _m.Called(name)
-
-	if len(ret) == 0 {
-		panic("no return value specified for CreateCacheRepositoryDir")
-	}
-
-	var r0 string
-	var r1 error
-	if rf, ok := ret.Get(0).(func(string) (string, error)); ok {
-		return rf(name)
-	}
-	if rf, ok := ret.Get(0).(func(string) string); ok {
-		r0 = rf(name)
-	} else {
-		r0 = ret.Get(0).(string)
-	}
-
-	if rf, ok := ret.Get(1).(func(string) error); ok {
-		r1 = rf(name)
-	} else {
-		r1 = ret.Error(1)
-	}
-
-	return r0, r1
-}
-
-// StorageMock_CreateCacheRepositoryDir_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'CreateCacheRepositoryDir'
-type StorageMock_CreateCacheRepositoryDir_Call struct {
-	*mock.Call
-}
-
-// CreateCacheRepositoryDir is a helper method to define mock.On call
-//   - name string
-func (_e *StorageMock_Expecter) CreateCacheRepositoryDir(name interface{}) *StorageMock_CreateCacheRepositoryDir_Call {
-	return &StorageMock_CreateCacheRepositoryDir_Call{Call: _e.mock.On("CreateCacheRepositoryDir", name)}
-}
-
-func (_c *StorageMock_CreateCacheRepositoryDir_Call) Run(run func(name string)) *StorageMock_CreateCacheRepositoryDir_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(string))
-	})
-	return _c
-}
-
-func (_c *StorageMock_CreateCacheRepositoryDir_Call) Return(_a0 string, _a1 error) *StorageMock_CreateCacheRepositoryDir_Call {
-	_c.Call.Return(_a0, _a1)
-	return _c
-}
-
-func (_c *StorageMock_CreateCacheRepositoryDir_Call) RunAndReturn(run func(string) (string, error)) *StorageMock_CreateCacheRepositoryDir_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// GetCacheDownloadPaths provides a mock function with given fields: moduleName, version
-func (_m *StorageMock) GetCacheDownloadPaths(moduleName string, version string) models.CacheDownloadPaths {
-	ret := _m.Called(moduleName, version)
-
-	if len(ret) == 0 {
-		panic("no return value specified for GetCacheDownloadPaths")
-	}
-
-	var r0 models.CacheDownloadPaths
-	if rf, ok := ret.Get(0).(func(string, string) models.CacheDownloadPaths); ok {
-		r0 = rf(moduleName, version)
-	} else {
-		r0 = ret.Get(0).(models.CacheDownloadPaths)
-	}
-
-	return r0
-}
-
-// StorageMock_GetCacheDownloadPaths_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'GetCacheDownloadPaths'
-type StorageMock_GetCacheDownloadPaths_Call struct {
-	*mock.Call
-}
-
-// GetCacheDownloadPaths is a helper method to define mock.On call
-//   - moduleName string
-//   - version string
-func (_e *StorageMock_Expecter) GetCacheDownloadPaths(moduleName interface{}, version interface{}) *StorageMock_GetCacheDownloadPaths_Call {
-	return &StorageMock_GetCacheDownloadPaths_Call{Call: _e.mock.On("GetCacheDownloadPaths", moduleName, version)}
-}
-
-func (_c *StorageMock_GetCacheDownloadPaths_Call) Run(run func(moduleName string, version string)) *StorageMock_GetCacheDownloadPaths_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(string), args[1].(string))
-	})
-	return _c
-}
-
-func (_c *StorageMock_GetCacheDownloadPaths_Call) Return(_a0 models.CacheDownloadPaths) *StorageMock_GetCacheDownloadPaths_Call {
-	_c.Call.Return(_a0)
-	return _c
-}
-
-func (_c *StorageMock_GetCacheDownloadPaths_Call) RunAndReturn(run func(string, string) models.CacheDownloadPaths) *StorageMock_GetCacheDownloadPaths_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// GetInstallDir provides a mock function with given fields: moduleName, revisionVersion
-func (_m *StorageMock) GetInstallDir(moduleName string, revisionVersion string) string {
-	ret := _m.Called(moduleName, revisionVersion)
-
-	if len(ret) == 0 {
-		panic("no return value specified for GetInstallDir")
-	}
-
-	var r0 string
-	if rf, ok := ret.Get(0).(func(string, string) string); ok {
-		r0 = rf(moduleName, revisionVersion)
-	} else {
-		r0 = ret.Get(0).(string)
-	}
-
-	return r0
-}
-
-// StorageMock_GetInstallDir_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'GetInstallDir'
-type StorageMock_GetInstallDir_Call struct {
-	*mock.Call
-}
-
-// GetInstallDir is a helper method to define mock.On call
-//   - moduleName string
-//   - revisionVersion string
-func (_e *StorageMock_Expecter) GetInstallDir(moduleName interface{}, revisionVersion interface{}) *StorageMock_GetInstallDir_Call {
-	return &StorageMock_GetInstallDir_Call{Call: _e.mock.On("GetInstallDir", moduleName, revisionVersion)}
-}
-
-func (_c *StorageMock_GetInstallDir_Call) Run(run func(moduleName string, revisionVersion string)) *StorageMock_GetInstallDir_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(string), args[1].(string))
-	})
-	return _c
-}
-
-func (_c *StorageMock_GetInstallDir_Call) Return(_a0 string) *StorageMock_GetInstallDir_Call {
-	_c.Call.Return(_a0)
-	return _c
-}
-
-func (_c *StorageMock_GetInstallDir_Call) RunAndReturn(run func(string, string) string) *StorageMock_GetInstallDir_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// GetInstalledModuleHash provides a mock function with given fields: moduleName, revisionVersion
-func (_m *StorageMock) GetInstalledModuleHash(moduleName string, revisionVersion string) (models.ModuleHash, error) {
-	ret := _m.Called(moduleName, revisionVersion)
-
-	if len(ret) == 0 {
-		panic("no return value specified for GetInstalledModuleHash")
-	}
-
-	var r0 models.ModuleHash
-	var r1 error
-	if rf, ok := ret.Get(0).(func(string, string) (models.ModuleHash, error)); ok {
-		return rf(moduleName, revisionVersion)
-	}
-	if rf, ok := ret.Get(0).(func(string, string) models.ModuleHash); ok {
-		r0 = rf(moduleName, revisionVersion)
-	} else {
-		r0 = ret.Get(0).(models.ModuleHash)
-	}
-
-	if rf, ok := ret.Get(1).(func(string, string) error); ok {
-		r1 = rf(moduleName, revisionVersion)
-	} else {
-		r1 = ret.Error(1)
-	}
-
-	return r0, r1
-}
-
-// StorageMock_GetInstalledModuleHash_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'GetInstalledModuleHash'
-type StorageMock_GetInstalledModuleHash_Call struct {
-	*mock.Call
-}
-
-// GetInstalledModuleHash is a helper method to define mock.On call
-//   - moduleName string
-//   - revisionVersion string
-func (_e *StorageMock_Expecter) GetInstalledModuleHash(moduleName interface{}, revisionVersion interface{}) *StorageMock_GetInstalledModuleHash_Call {
-	return &StorageMock_GetInstalledModuleHash_Call{Call: _e.mock.On("GetInstalledModuleHash", moduleName, revisionVersion)}
-}
-
-func (_c *StorageMock_GetInstalledModuleHash_Call) Run(run func(moduleName string, revisionVersion string)) *StorageMock_GetInstalledModuleHash_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(string), args[1].(string))
-	})
-	return _c
-}
-
-func (_c *StorageMock_GetInstalledModuleHash_Call) Return(_a0 models.ModuleHash, _a1 error) *StorageMock_GetInstalledModuleHash_Call {
-	_c.Call.Return(_a0, _a1)
-	return _c
-}
-
-func (_c *StorageMock_GetInstalledModuleHash_Call) RunAndReturn(run func(string, string) (models.ModuleHash, error)) *StorageMock_GetInstalledModuleHash_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// Install provides a mock function with given fields: ctx, cacheDownloadPaths, module, revision, moduleConfig
-func (_m *StorageMock) Install(ctx context.Context, cacheDownloadPaths models.CacheDownloadPaths, module models.Module, revision models.Revision, moduleConfig models.ModuleConfig) (models.ModuleHash, error) {
-	ret := _m.Called(ctx, cacheDownloadPaths, module, revision, moduleConfig)
-
-	if len(ret) == 0 {
-		panic("no return value specified for Install")
-	}
-
-	var r0 models.ModuleHash
-	var r1 error
-	if rf, ok := ret.Get(0).(func(context.Context, models.CacheDownloadPaths, models.Module, models.Revision, models.ModuleConfig) (models.ModuleHash, error)); ok {
-		return rf(ctx, cacheDownloadPaths, module, revision, moduleConfig)
-	}
-	if rf, ok := ret.Get(0).(func(context.Context, models.CacheDownloadPaths, models.Module, models.Revision, models.ModuleConfig) models.ModuleHash); ok {
-		r0 = rf(ctx, cacheDownloadPaths, module, revision, moduleConfig)
-	} else {
-		r0 = ret.Get(0).(models.ModuleHash)
-	}
-
-	if rf, ok := ret.Get(1).(func(context.Context, models.CacheDownloadPaths, models.Module, models.Revision, models.ModuleConfig) error); ok {
-		r1 = rf(ctx, cacheDownloadPaths, module, revision, moduleConfig)
-	} else {
-		r1 = ret.Error(1)
-	}
-
-	return r0, r1
-}
-
-// StorageMock_Install_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'Install'
-type StorageMock_Install_Call struct {
-	*mock.Call
-}
-
-// Install is a helper method to define mock.On call
-//   - ctx context.Context
-//   - cacheDownloadPaths models.CacheDownloadPaths
-//   - module models.Module
-//   - revision models.Revision
-//   - moduleConfig models.ModuleConfig
-func (_e *StorageMock_Expecter) Install(ctx interface{}, cacheDownloadPaths interface{}, module interface{}, revision interface{}, moduleConfig interface{}) *StorageMock_Install_Call {
-	return &StorageMock_Install_Call{Call: _e.mock.On("Install", ctx, cacheDownloadPaths, module, revision, moduleConfig)}
-}
-
-func (_c *StorageMock_Install_Call) Run(run func(ctx context.Context, cacheDownloadPaths models.CacheDownloadPaths, module models.Module, revision models.Revision, moduleConfig models.ModuleConfig)) *StorageMock_Install_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(context.Context), args[1].(models.CacheDownloadPaths), args[2].(models.Module), args[3].(models.Revision), args[4].(models.ModuleConfig))
-	})
-	return _c
-}
-
-func (_c *StorageMock_Install_Call) Return(_a0 models.ModuleHash, _a1 error) *StorageMock_Install_Call {
-	_c.Call.Return(_a0, _a1)
-	return _c
-}
-
-func (_c *StorageMock_Install_Call) RunAndReturn(run func(context.Context, models.CacheDownloadPaths, models.Module, models.Revision, models.ModuleConfig) (models.ModuleHash, error)) *StorageMock_Install_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// ReadInstalledModuleInfo provides a mock function with given fields: cacheDownloadPaths
-func (_m *StorageMock) ReadInstalledModuleInfo(cacheDownloadPaths models.CacheDownloadPaths) (models.InstalledModuleInfo, error) {
-	ret := _m.Called(cacheDownloadPaths)
-
-	if len(ret) == 0 {
-		panic("no return value specified for ReadInstalledModuleInfo")
-	}
-
-	var r0 models.InstalledModuleInfo
-	var r1 error
-	if rf, ok := ret.Get(0).(func(models.CacheDownloadPaths) (models.InstalledModuleInfo, error)); ok {
-		return rf(cacheDownloadPaths)
-	}
-	if rf, ok := ret.Get(0).(func(models.CacheDownloadPaths) models.InstalledModuleInfo); ok {
-		r0 = rf(cacheDownloadPaths)
-	} else {
-		r0 = ret.Get(0).(models.InstalledModuleInfo)
-	}
-
-	if rf, ok := ret.Get(1).(func(models.CacheDownloadPaths) error); ok {
-		r1 = rf(cacheDownloadPaths)
-	} else {
-		r1 = ret.Error(1)
-	}
-
-	return r0, r1
-}
-
-// StorageMock_ReadInstalledModuleInfo_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'ReadInstalledModuleInfo'
-type StorageMock_ReadInstalledModuleInfo_Call struct {
-	*mock.Call
-}
-
-// ReadInstalledModuleInfo is a helper method to define mock.On call
-//   - cacheDownloadPaths models.CacheDownloadPaths
-func (_e *StorageMock_Expecter) ReadInstalledModuleInfo(cacheDownloadPaths interface{}) *StorageMock_ReadInstalledModuleInfo_Call {
-	return &StorageMock_ReadInstalledModuleInfo_Call{Call: _e.mock.On("ReadInstalledModuleInfo", cacheDownloadPaths)}
-}
-
-func (_c *StorageMock_ReadInstalledModuleInfo_Call) Run(run func(cacheDownloadPaths models.CacheDownloadPaths)) *StorageMock_ReadInstalledModuleInfo_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(models.CacheDownloadPaths))
-	})
-	return _c
-}
-
-func (_c *StorageMock_ReadInstalledModuleInfo_Call) Return(_a0 models.InstalledModuleInfo, _a1 error) *StorageMock_ReadInstalledModuleInfo_Call {
-	_c.Call.Return(_a0, _a1)
-	return _c
-}
-
-func (_c *StorageMock_ReadInstalledModuleInfo_Call) RunAndReturn(run func(models.CacheDownloadPaths) (models.InstalledModuleInfo, error)) *StorageMock_ReadInstalledModuleInfo_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// WriteInstalledModuleInfo provides a mock function with given fields: cacheDownloadPaths, installedModuleInfo
-func (_m *StorageMock) WriteInstalledModuleInfo(cacheDownloadPaths models.CacheDownloadPaths, installedModuleInfo models.InstalledModuleInfo) error {
-	ret := _m.Called(cacheDownloadPaths, installedModuleInfo)
-
-	if len(ret) == 0 {
-		panic("no return value specified for WriteInstalledModuleInfo")
-	}
-
-	var r0 error
-	if rf, ok := ret.Get(0).(func(models.CacheDownloadPaths, models.InstalledModuleInfo) error); ok {
-		r0 = rf(cacheDownloadPaths, installedModuleInfo)
-	} else {
-		r0 = ret.Error(0)
-	}
-
-	return r0
-}
-
-// StorageMock_WriteInstalledModuleInfo_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'WriteInstalledModuleInfo'
-type StorageMock_WriteInstalledModuleInfo_Call struct {
-	*mock.Call
-}
-
-// WriteInstalledModuleInfo is a helper method to define mock.On call
-//   - cacheDownloadPaths models.CacheDownloadPaths
-//   - installedModuleInfo models.InstalledModuleInfo
-func (_e *StorageMock_Expecter) WriteInstalledModuleInfo(cacheDownloadPaths interface{}, installedModuleInfo interface{}) *StorageMock_WriteInstalledModuleInfo_Call {
-	return &StorageMock_WriteInstalledModuleInfo_Call{Call: _e.mock.On("WriteInstalledModuleInfo", cacheDownloadPaths, installedModuleInfo)}
-}
-
-func (_c *StorageMock_WriteInstalledModuleInfo_Call) Run(run func(cacheDownloadPaths models.CacheDownloadPaths, installedModuleInfo models.InstalledModuleInfo)) *StorageMock_WriteInstalledModuleInfo_Call {
-	_c.Call.Run(func(args mock.Arguments) {
-		run(args[0].(models.CacheDownloadPaths), args[1].(models.InstalledModuleInfo))
-	})
-	return _c
-}
-
-func (_c *StorageMock_WriteInstalledModuleInfo_Call) Return(_a0 error) *StorageMock_WriteInstalledModuleInfo_Call {
-	_c.Call.Return(_a0)
-	return _c
-}
-
-func (_c *StorageMock_WriteInstalledModuleInfo_Call) RunAndReturn(run func(models.CacheDownloadPaths, models.InstalledModuleInfo) error) *StorageMock_WriteInstalledModuleInfo_Call {
-	_c.Call.Return(run)
-	return _c
-}
-
-// NewStorageMock creates a new instance of StorageMock. It also registers a testing interface on the mock and a cleanup function to assert the mocks expectations.
-// The first argument is typically a *testing.T value.
-func NewStorageMock(t interface {
-	mock.TestingT
-	Cleanup(func())
-}) *StorageMock {
-	mock := &StorageMock{}
-	mock.Mock.Test(t)
-
-	t.Cleanup(func() { mock.AssertExpectations(t) })
-
-	return mock
-}
diff --git a/internal/core/templates/easyp.yaml.tmpl b/internal/core/templates/easyp.yaml.tmpl
deleted file mode 100644
index f063c1b6..00000000
--- a/internal/core/templates/easyp.yaml.tmpl
+++ /dev/null
@@ -1,21 +0,0 @@
-# EasyP configuration file.
-# Documentation: https://easyp.tech/docs/guide/introduction/what-is
-
-lint:
-  use:
-{{- range .LintGroups }}
-    # {{ .Name }}
-  {{- range .Rules }}
-    - {{ . }}
-  {{- end }}
-{{ end }}
-  # Suffix for the zero value of enums (e.g. MY_ENUM_UNSPECIFIED, MY_ENUM_NONE).
-  enum_zero_value_suffix: {{ .EnumZeroValueSuffix }}
-
-  # Suffix that all services must have (e.g. UserAPI, OrderAPI).
-  service_suffix: {{ .ServiceSuffix }}
-
-# Breaking change detection settings.
-breaking:
-  # Git ref (branch, tag, commit) to compare against.
-  against_git_ref: {{ .AgainstGitRef }}
diff --git a/internal/core/unstable_package_matcher.go b/internal/core/unstable_package_matcher.go
new file mode 100644
index 00000000..6a51168e
--- /dev/null
+++ b/internal/core/unstable_package_matcher.go
@@ -0,0 +1,24 @@
+package core
+
+import (
+	"regexp"
+	"strings"
+)
+
+// Match the unstable forms documented by PACKAGE_VERSION_SUFFIX, with positive
+// version numbers and optional positive alpha/beta sequence numbers.
+var unstablePackageVersion = regexp.MustCompile(`^v[1-9][0-9]*(test.*|(alpha|beta)([1-9][0-9]*)?|p[1-9][0-9]*(alpha|beta)([1-9][0-9]*)?)$`)
+
+func isUnstablePackage(name PackageName) bool {
+	component := string(name)
+	component = component[strings.LastIndexByte(component, '.')+1:]
+	return unstablePackageVersion.MatchString(component)
+}
+
+func excludeUnstablePackages(data ProtoData) {
+	for name := range data {
+		if isUnstablePackage(name) {
+			delete(data, name)
+		}
+	}
+}
diff --git a/internal/core/unstable_package_matcher_test.go b/internal/core/unstable_package_matcher_test.go
new file mode 100644
index 00000000..17338240
--- /dev/null
+++ b/internal/core/unstable_package_matcher_test.go
@@ -0,0 +1,151 @@
+package core
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/fs/fs"
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestUnstablePackageMatcher(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name, pkg string
+		want      bool
+	}{
+		{name: "test", pkg: "foo.v1test", want: true},
+		{name: "test_suffix", pkg: "foo.v12testFeature", want: true},
+		{name: "alpha", pkg: "foo.v2alpha", want: true},
+		{name: "alpha_number", pkg: "foo.v2alpha3", want: true},
+		{name: "beta", pkg: "foo.v3beta", want: true},
+		{name: "beta_number", pkg: "foo.v3beta12", want: true},
+		{name: "point_alpha", pkg: "foo.v2p3alpha4", want: true},
+		{name: "point_beta", pkg: "v2p3beta", want: true},
+		{name: "stable", pkg: "foo.v1"},
+		{name: "not_last", pkg: "foo.v1alpha1.service"},
+		{name: "test_not_last", pkg: "v1test.foo"},
+		{name: "component_prefix", pkg: "foo.prefixv1alpha1"},
+		{name: "component_suffix", pkg: "foo.v1alpha1suffix"},
+		{name: "zero_version", pkg: "foo.v0alpha1"},
+		{name: "zero_point", pkg: "foo.v1p0beta1"},
+		{name: "zero_prerelease", pkg: "foo.v1beta0"},
+		{name: "missing_version", pkg: "foo.valpha1"},
+		{name: "stable_point", pkg: "foo.v1p2"},
+		{name: "empty", pkg: ""},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			assert.Equal(t, tt.want, isUnstablePackage(PackageName(tt.pkg)))
+		})
+	}
+}
+
+func TestCompareBreakingIgnoreUnstable(t *testing.T) {
+	t.Parallel()
+	const declarations = `message Item { string id = 1; oneof value { string text = 2; } }
+enum State { STATE_UNSPECIFIED = 0; }
+service ItemService { rpc Get(Item) returns (Item); }`
+	tests := []struct {
+		name, baselinePackage, currentPackage, currentFile, currentBody string
+		ignore, files                                                   bool
+		wantCount                                                       int
+	}{
+		{name: "unstable_enabled", baselinePackage: "example.v1beta1", currentPackage: "example.v1beta1", ignore: true},
+		{name: "unstable_disabled", baselinePackage: "example.v1beta1", currentPackage: "example.v1beta1", wantCount: 4},
+		{name: "stable_enabled", baselinePackage: "example.v1", currentPackage: "example.v1", ignore: true, wantCount: 4},
+		{name: "baseline_unstable_current_stable", baselinePackage: "example.v1beta1", currentPackage: "example.v1", ignore: true},
+		{name: "baseline_stable_current_unstable", baselinePackage: "example.v1", currentPackage: "example.v1beta1", currentBody: declarations, ignore: true, wantCount: 4},
+		{name: "stable_file_moves", baselinePackage: "example.v1", currentPackage: "example.v1", currentFile: "new.proto", currentBody: declarations, ignore: true, files: true, wantCount: 4},
+		{name: "unstable_file_moves", baselinePackage: "example.v1alpha", currentPackage: "example.v1alpha", currentFile: "new.proto", currentBody: declarations, ignore: true, files: true},
+		{name: "unstable_not_last", baselinePackage: "example.v1beta1.service", currentPackage: "example.v1beta1.service", ignore: true, wantCount: 4},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			baseline, current := t.TempDir(), t.TempDir()
+			writeUnstableProto(t, baseline, "old.proto", "syntax = \"proto3\"; package "+tt.baselinePackage+"; "+declarations)
+			currentFile := tt.currentFile
+			if currentFile == "" {
+				currentFile = "old.proto"
+			}
+			writeUnstableProto(t, current, currentFile, "syntax = \"proto3\"; package "+tt.currentPackage+"; "+tt.currentBody)
+			app := New(Options{Logger: logger.NewNop(), BreakingCheckConfig: BreakingCheckConfig{IgnoreUnstable: tt.ignore, FilesCheck: tt.files}})
+			issues, err := app.CompareBreaking(t.Context(), fs.NewFSWalker(current, "."), fs.NewFSWalker(baseline, "."), nil)
+			require.NoError(t, err)
+			assert.Len(t, issues, tt.wantCount, "%+v", issues)
+		})
+	}
+}
+
+func TestIgnoreUnstablePreservesStableReferencesAndDependencyBaselines(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name, dependencyPackage string
+		wantCount               int
+	}{
+		{name: "unstable_dependency", dependencyPackage: "dep.v1beta1", wantCount: 4},
+		{name: "stable_dependency", dependencyPackage: "dep.v1", wantCount: 5},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			baseline, current, baselineDeps, currentDeps := t.TempDir(), t.TempDir(), t.TempDir(), t.TempDir()
+			writeUnstableProto(t, baselineDeps, "dep.proto", "syntax = \"proto3\"; package "+tt.dependencyPackage+"; message Item { string id = 1; }")
+			writeUnstableProto(t, currentDeps, "dep.proto", "syntax = \"proto3\"; package "+tt.dependencyPackage+"; message Item {} message Other {}")
+			writeUnstableProto(t, baselineDeps, "removed.proto", "syntax = \"proto3\"; package old.v1beta1;")
+			writeUnstableProto(t, baseline, "use.proto", "syntax = \"proto3\"; package stable.v1; import \"dep.proto\"; import \"removed.proto\"; message Use { "+tt.dependencyPackage+".Item item = 1; } service API { rpc Get("+tt.dependencyPackage+".Item) returns ("+tt.dependencyPackage+".Item); }")
+			writeUnstableProto(t, current, "use.proto", "syntax = \"proto3\"; package stable.v1; import \"dep.proto\"; message Use { "+tt.dependencyPackage+".Other item = 1; } service API { rpc Get("+tt.dependencyPackage+".Other) returns ("+tt.dependencyPackage+".Other); }")
+			app := New(Options{Logger: logger.NewNop(), ImportRoots: []string{currentDeps}, BreakingCheckConfig: BreakingCheckConfig{IgnoreUnstable: true}})
+			issues, err := app.CompareBreaking(t.Context(), fs.NewFSWalker(current, "."), fs.NewFSWalker(baseline, "."), []string{baselineDeps})
+			require.NoError(t, err)
+			assert.Len(t, issues, tt.wantCount, "%+v", issues)
+			stableCount := 0
+			for _, issue := range issues {
+				if issue.Path == "use.proto" {
+					stableCount++
+				}
+			}
+			assert.Equal(t, 4, stableCount)
+		})
+	}
+}
+
+func writeUnstableProto(t *testing.T, root, name, content string) {
+	t.Helper()
+	require.NoError(t, os.WriteFile(filepath.Join(root, name), []byte(content), 0o600))
+}
+
+func TestLegacyBreakingCheckIgnoreUnstable(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct {
+		name      string
+		ignore    bool
+		wantCount int
+	}{
+		{name: "enabled", ignore: true},
+		{name: "disabled", wantCount: 1},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			baseline, current := t.TempDir(), t.TempDir()
+			writeUnstableProto(t, baseline, "item.proto", "syntax = \"proto3\"; package example.v1test; message Item {}")
+			writeUnstableProto(t, current, "item.proto", "syntax = \"proto3\"; package example.v1test;")
+			app := New(Options{Logger: logger.NewNop(), BreakingCheckConfig: BreakingCheckConfig{IgnoreUnstable: tt.ignore}, CurrentProjectGitWalker: unstableBaselineWalker{DirWalker: fs.NewFSWalker(baseline, ".")}})
+			issues, err := app.BreakingCheck(t.Context(), current, current, ".")
+			require.NoError(t, err)
+			assert.Len(t, issues, tt.wantCount)
+		})
+	}
+}
+
+type unstableBaselineWalker struct{ DirWalker }
+
+func (w unstableBaselineWalker) GetDirWalker(_, _, _ string) (DirWalker, error) {
+	return w.DirWalker, nil
+}
diff --git a/internal/core/update.go b/internal/core/update.go
deleted file mode 100644
index 65bb75ab..00000000
--- a/internal/core/update.go
+++ /dev/null
@@ -1,37 +0,0 @@
-package core
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"log/slog"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-// Update all packages from config
-// dependencies slice of strings format: origin@version: github.com/company/repository@v1.2.3
-// if version is absent use the latest commit
-func (c *Core) Update(ctx context.Context) error {
-	c.logger.Info(ctx, "updating dependencies", slog.Int("count", len(c.deps)))
-
-	for _, dependency := range c.deps {
-		module := models.NewModule(dependency)
-		log := c.logger.With(slog.String("module", module.Name), slog.String("version", string(module.Version)))
-
-		log.Debug(ctx, "updating dependency")
-
-		if err := c.Get(ctx, module); err != nil {
-			if errors.Is(err, models.ErrVersionNotFound) {
-				log.Error(ctx, "version not found")
-				return models.ErrVersionNotFound
-			}
-
-			return fmt.Errorf("c.Get: %w", err)
-		}
-	}
-
-	c.logger.Info(ctx, "update completed")
-
-	return nil
-}
diff --git a/internal/core/vendor.go b/internal/core/vendor.go
deleted file mode 100644
index 1be03e55..00000000
--- a/internal/core/vendor.go
+++ /dev/null
@@ -1,30 +0,0 @@
-package core
-
-import (
-	"context"
-	"fmt"
-
-	cp "github.com/otiai10/copy"
-
-	"github.com/easyp-tech/easyp/internal/core/models"
-)
-
-// Vendor copy all proto files from deps to local dir
-func (c *Core) Vendor(ctx context.Context) error {
-	if err := c.Download(ctx); err != nil {
-		return fmt.Errorf("c.Download: %w", err)
-	}
-
-	for lockFileInfo := range c.lockFile.DepsIter() {
-		depPath, err := c.modulePath(models.NewModule(lockFileInfo.Name))
-		if err != nil {
-			return fmt.Errorf("modulePath: %w", err)
-		}
-
-		if err := cp.Copy(depPath, c.vendorDir); err != nil {
-			return fmt.Errorf("c.Copy: %w", err)
-		}
-	}
-
-	return nil
-}
diff --git a/internal/flags/flags.go b/internal/flags/flags.go
index 163b925b..351c7837 100644
--- a/internal/flags/flags.go
+++ b/internal/flags/flags.go
@@ -1,14 +1,13 @@
 package flags
 
-import "github.com/urfave/cli/v2"
+import (
+	"github.com/urfave/cli/v2"
 
-const (
-	globalCategory = "global"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
 )
 
 const (
-	// Max file size is 1mb.
-	defaultConfigFilePath = "easyp.yaml"
+	globalCategory = "global"
 )
 
 // Flags.
@@ -17,12 +16,8 @@ var (
 		Name:        "cfg",
 		Category:    globalCategory,
 		DefaultText: "specify the path to the configuration file",
-		FilePath:    "",
 		Usage:       "Specify the absolute or relative path to the configuration file for setting up the application.",
-		Required:    true,
-		Hidden:      false,
-		HasBeenSet:  true,
-		Value:       defaultConfigFilePath,
+		Value:       v1.PolicyFile,
 		Aliases:     []string{"config"},
 		EnvVars:     []string{"EASYP_CFG"},
 		TakesFile:   true,
diff --git a/internal/flags/format.go b/internal/flags/format.go
index 39226759..b07aded2 100644
--- a/internal/flags/format.go
+++ b/internal/flags/format.go
@@ -14,8 +14,19 @@ const (
 // --format flag when it is explicitly set, otherwise falling back to the
 // command-specific default.
 func GetFormat(ctx *cli.Context, defaultFormat string) string {
-	if ctx.IsSet(Format.Name) {
-		return ctx.String(Format.Name)
+	for _, scope := range ctx.Lineage() {
+		// Inspect the flag set at each level: a command-local default must not
+		// hide an explicitly selected format on the parent application.
+		explicit := false
+		for _, name := range scope.LocalFlagNames() {
+			if name == Format.Name || name == "f" {
+				explicit = true
+				break
+			}
+		}
+		if explicit && scope.IsSet(Format.Name) {
+			return scope.String(Format.Name)
+		}
 	}
 	return defaultFormat
 }
diff --git a/internal/flags/format_test.go b/internal/flags/format_test.go
new file mode 100644
index 00000000..6959a54d
--- /dev/null
+++ b/internal/flags/format_test.go
@@ -0,0 +1,39 @@
+package flags
+
+import (
+	"flag"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+)
+
+func TestGetFormatRespectsExplicitScope(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct {
+		name                string
+		global, local, want string
+	}{
+		{name: "command default", want: "json"},
+		{name: "explicit global text", global: "text", want: "text"},
+		{name: "local overrides global", global: "text", local: "json", want: "json"},
+		{name: "explicit local text", local: "text", want: "text"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			global := flag.NewFlagSet("global", flag.ContinueOnError)
+			global.String("format", "text", "")
+			local := flag.NewFlagSet("command", flag.ContinueOnError)
+			local.String("format", "text", "")
+			if tt.global != "" {
+				require.NoError(t, global.Set("format", tt.global))
+			}
+			if tt.local != "" {
+				require.NoError(t, local.Set("format", tt.local))
+			}
+			parent := cli.NewContext(&cli.App{}, global, nil)
+			child := cli.NewContext(parent.App, local, parent)
+			require.Equal(t, tt.want, GetFormat(child, "json"))
+		})
+	}
+}
diff --git a/internal/flags/frozen.go b/internal/flags/frozen.go
new file mode 100644
index 00000000..74212d04
--- /dev/null
+++ b/internal/flags/frozen.go
@@ -0,0 +1,19 @@
+package flags
+
+import "github.com/urfave/cli/v2"
+
+// Frozen returns a fresh flag for each command and the global scope.
+func Frozen() *cli.BoolFlag {
+	return &cli.BoolFlag{Name: "frozen", Usage: "require the existing manifest and lock without dependency resolution or file updates (explicit; never inferred from CI)"}
+}
+
+// IsFrozen preserves any true value in the command lineage, including a global
+// flag shadowed by a command-local default or an explicit false value.
+func IsFrozen(ctx *cli.Context) bool {
+	for _, scope := range ctx.Lineage() {
+		if scope.Bool("frozen") {
+			return true
+		}
+	}
+	return false
+}
diff --git a/internal/flags/frozen_test.go b/internal/flags/frozen_test.go
new file mode 100644
index 00000000..326f06b4
--- /dev/null
+++ b/internal/flags/frozen_test.go
@@ -0,0 +1,41 @@
+package flags
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/require"
+	"github.com/urfave/cli/v2"
+)
+
+func TestFrozenPreservesTrueAcrossLineage(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct {
+		name string
+		args []string
+		want bool
+	}{
+		{name: "default", args: []string{"mod", "download"}},
+		{name: "global", args: []string{"--frozen", "mod", "download"}, want: true},
+		{name: "parent", args: []string{"mod", "--frozen", "download"}, want: true},
+		{name: "leaf", args: []string{"mod", "download", "--frozen"}, want: true},
+		{name: "global true local false", args: []string{"--frozen", "mod", "--frozen=false", "download", "--frozen=false"}, want: true},
+		{name: "parent true leaf false", args: []string{"mod", "--frozen", "download", "--frozen=false"}, want: true},
+		{name: "all false", args: []string{"--frozen=false", "mod", "download", "--frozen=false"}},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			called := false
+			app := &cli.App{HideHelp: true, HideVersion: true, Flags: []cli.Flag{Frozen()}, Commands: []*cli.Command{{
+				Name: "mod", HideHelp: true, Flags: []cli.Flag{Frozen()}, Subcommands: []*cli.Command{{
+					Name: "download", HideHelp: true, Flags: []cli.Flag{Frozen()}, Action: func(ctx *cli.Context) error {
+						called = true
+						require.Equal(t, tt.want, IsFrozen(ctx))
+						return nil
+					},
+				}},
+			}}}
+			require.NoError(t, app.RunContext(t.Context(), append([]string{"easyp"}, tt.args...)))
+			require.True(t, called)
+		})
+	}
+}
diff --git a/internal/fs/fs/adapter.go b/internal/fs/fs/adapter.go
index a1a6fad3..e9d75c7b 100644
--- a/internal/fs/fs/adapter.go
+++ b/internal/fs/fs/adapter.go
@@ -31,3 +31,6 @@ func (a *FSAdapter) Remove(name string) error {
 	path := filepath.Join(a.rootDir, name)
 	return os.Remove(path)
 }
+
+// RootPath returns the filesystem root used to resolve diagnostic paths.
+func (a *FSAdapter) RootPath() string { return a.rootDir }
diff --git a/internal/fs/fs/atomic_file.go b/internal/fs/fs/atomic_file.go
new file mode 100644
index 00000000..ea394112
--- /dev/null
+++ b/internal/fs/fs/atomic_file.go
@@ -0,0 +1,49 @@
+package fs
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+)
+
+// WriteAtomicFile durably replaces path after syncing the complete temporary file.
+// Existing regular-file permissions are preserved; mode is used only for new files.
+func WriteAtomicFile(path string, raw []byte, mode os.FileMode) error {
+	parent := filepath.Dir(path)
+	finalMode := mode
+	if info, err := os.Lstat(path); err == nil {
+		if info.Mode().IsRegular() {
+			finalMode = info.Mode().Perm()
+		}
+	} else if !os.IsNotExist(err) {
+		return fmt.Errorf("Lstat: %w", err)
+	}
+
+	tmp, err := os.CreateTemp(parent, "."+filepath.Base(path)+"-*")
+	if err != nil {
+		return fmt.Errorf("CreateTemp: %w", err)
+	}
+	defer func() { _ = os.Remove(tmp.Name()) }()
+	if err := tmp.Chmod(finalMode); err != nil {
+		_ = tmp.Close()
+		return fmt.Errorf("Chmod: %w", err)
+	}
+	if _, err := tmp.Write(raw); err != nil {
+		_ = tmp.Close()
+		return fmt.Errorf("Write: %w", err)
+	}
+	if err := tmp.Sync(); err != nil {
+		_ = tmp.Close()
+		return fmt.Errorf("Sync: %w", err)
+	}
+	if err := tmp.Close(); err != nil {
+		return fmt.Errorf("Close: %w", err)
+	}
+	if err := os.Rename(tmp.Name(), path); err != nil {
+		return fmt.Errorf("Rename: %w", err)
+	}
+	if err := syncDirectory(parent); err != nil {
+		return fmt.Errorf("sync parent directory: %w", err)
+	}
+	return nil
+}
diff --git a/internal/fs/fs/atomic_file_sync_unix.go b/internal/fs/fs/atomic_file_sync_unix.go
new file mode 100644
index 00000000..7cc6c9fa
--- /dev/null
+++ b/internal/fs/fs/atomic_file_sync_unix.go
@@ -0,0 +1,18 @@
+//go:build !windows
+
+package fs
+
+import (
+	"errors"
+	"os"
+)
+
+func syncDirectory(path string) error {
+	dir, err := os.Open(path)
+	if err != nil {
+		return err
+	}
+	syncErr := dir.Sync()
+	closeErr := dir.Close()
+	return errors.Join(syncErr, closeErr)
+}
diff --git a/internal/fs/fs/atomic_file_sync_windows.go b/internal/fs/fs/atomic_file_sync_windows.go
new file mode 100644
index 00000000..a4a72325
--- /dev/null
+++ b/internal/fs/fs/atomic_file_sync_windows.go
@@ -0,0 +1,7 @@
+//go:build windows
+
+package fs
+
+// Windows does not expose POSIX directory fsync through os.File.Sync.
+// The atomic rename remains the durability boundary supported by this helper.
+func syncDirectory(string) error { return nil }
diff --git a/internal/fs/fs/atomic_file_test.go b/internal/fs/fs/atomic_file_test.go
new file mode 100644
index 00000000..ec102c9d
--- /dev/null
+++ b/internal/fs/fs/atomic_file_test.go
@@ -0,0 +1,31 @@
+package fs
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestWriteAtomicFilePermissionsAndReplacement(t *testing.T) {
+	t.Parallel()
+
+	root := t.TempDir()
+	path := filepath.Join(root, "protobuf.mod")
+
+	require.NoError(t, WriteAtomicFile(path, []byte("first"), 0o644))
+	info, err := os.Stat(path)
+	require.NoError(t, err)
+	assert.Equal(t, os.FileMode(0o644), info.Mode().Perm())
+
+	require.NoError(t, os.Chmod(path, 0o640))
+	require.NoError(t, WriteAtomicFile(path, []byte("second"), 0o644))
+	info, err = os.Stat(path)
+	require.NoError(t, err)
+	assert.Equal(t, os.FileMode(0o640), info.Mode().Perm())
+	raw, err := os.ReadFile(path)
+	require.NoError(t, err)
+	assert.Equal(t, "second", string(raw))
+}
diff --git a/internal/fs/fs/copy.go b/internal/fs/fs/copy.go
new file mode 100644
index 00000000..122939e8
--- /dev/null
+++ b/internal/fs/fs/copy.go
@@ -0,0 +1,52 @@
+package fs
+
+import (
+	"fmt"
+	"io"
+	"os"
+	"path/filepath"
+)
+
+func regularFile(path string) (os.FileInfo, error) {
+	info, err := os.Lstat(path)
+	if err != nil {
+		return nil, fmt.Errorf("Lstat: %w", err)
+	}
+	if !info.Mode().IsRegular() {
+		return nil, fmt.Errorf("unsupported non-regular file %q", path)
+	}
+	return info, nil
+}
+
+// CopyRegularFile exclusively creates destination from a regular source file, preserving its permissions.
+func CopyRegularFile(source, destination string) error {
+	info, err := regularFile(source)
+	if err != nil {
+		return fmt.Errorf("regularFile: %w", err)
+	}
+	if err := os.MkdirAll(filepath.Dir(destination), 0o755); err != nil {
+		return fmt.Errorf("MkdirAll: %w", err)
+	}
+	in, err := os.Open(source)
+	if err != nil {
+		return fmt.Errorf("Open: %w", err)
+	}
+	out, err := os.OpenFile(destination, os.O_CREATE|os.O_EXCL|os.O_WRONLY, info.Mode().Perm())
+	if err != nil {
+		_ = in.Close()
+		return fmt.Errorf("OpenFile: %w", err)
+	}
+	_, copyErr := io.Copy(out, in)
+	closeOutErr := out.Close()
+	closeInErr := in.Close()
+	if copyErr != nil {
+		return fmt.Errorf("Copy: %w", copyErr)
+	}
+	if closeOutErr != nil {
+		return fmt.Errorf("Close: %w", closeOutErr)
+	}
+	if closeInErr != nil {
+		return fmt.Errorf("Close: %w", closeInErr)
+	}
+	return nil
+}
diff --git a/internal/fs/go_git/adapter.go b/internal/fs/go_git/adapter.go
index f1150771..4d784e3f 100644
--- a/internal/fs/go_git/adapter.go
+++ b/internal/fs/go_git/adapter.go
@@ -4,6 +4,7 @@ import (
 	"errors"
 	"fmt"
 	"io"
+	"io/fs"
 	"path"
 	"path/filepath"
 	"strings"
@@ -28,11 +29,17 @@ func (a *GitTreeDiskAdapter) Open(name string) (io.ReadCloser, error) {
 		if err == nil {
 			return gitFile.Reader()
 		}
+		if !errors.Is(err, object.ErrFileNotFound) {
+			return nil, err
+		}
 	}
 
 	// Fall back to unrooted lookup (e.g., caller already passed a fully-qualified path)
 	gitFile, err := a.File(name)
 	if err != nil {
+		if errors.Is(err, object.ErrFileNotFound) {
+			return nil, &fs.PathError{Op: "open", Path: name, Err: fs.ErrNotExist}
+		}
 		return nil, err
 	}
 
diff --git a/internal/fs/go_git/adapter_test.go b/internal/fs/go_git/adapter_test.go
new file mode 100644
index 00000000..6fe4bf5d
--- /dev/null
+++ b/internal/fs/go_git/adapter_test.go
@@ -0,0 +1,68 @@
+package go_git
+
+import (
+	"io"
+	"io/fs"
+	"os"
+	"path/filepath"
+	"testing"
+	"time"
+
+	"github.com/go-git/go-git/v5"
+	"github.com/go-git/go-git/v5/plumbing/object"
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestGitTreeDiskAdapterOpen(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name    string
+		root    string
+		path    string
+		want    string
+		wantErr error
+	}{
+		{name: "rooted file", root: "proto", path: "item.proto", want: "syntax = \"proto3\";\n"},
+		{name: "missing file", root: "proto", path: "google/protobuf/timestamp.proto", wantErr: fs.ErrNotExist},
+		{name: "missing root directory", root: "missing", path: "item.proto", wantErr: fs.ErrNotExist},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			path := filepath.Join(root, "proto", "item.proto")
+			require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+			require.NoError(t, os.WriteFile(path, []byte("syntax = \"proto3\";\n"), 0o644))
+			repo, err := git.PlainInit(root, false)
+			require.NoError(t, err)
+			worktree, err := repo.Worktree()
+			require.NoError(t, err)
+			_, err = worktree.Add("proto/item.proto")
+			require.NoError(t, err)
+			commit, err := worktree.Commit("initial", &git.CommitOptions{Author: &object.Signature{Name: "EasyP Test", Email: "test@example.com", When: time.Now()}})
+			require.NoError(t, err)
+			commitObject, err := repo.CommitObject(commit)
+			require.NoError(t, err)
+			tree, err := commitObject.Tree()
+			require.NoError(t, err)
+			adapter := &GitTreeDiskAdapter{Tree: tree, root: tt.root}
+
+			reader, err := adapter.Open(tt.path)
+
+			if tt.wantErr != nil {
+				require.ErrorIs(t, err, tt.wantErr)
+				assert.Nil(t, reader)
+				return
+			}
+			require.NoError(t, err)
+			t.Cleanup(func() { require.NoError(t, reader.Close()) })
+			content, err := io.ReadAll(reader)
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, string(content))
+		})
+	}
+}
diff --git a/internal/generation/config.go b/internal/generation/config.go
new file mode 100644
index 00000000..c1747004
--- /dev/null
+++ b/internal/generation/config.go
@@ -0,0 +1,67 @@
+package generation
+
+import (
+	"fmt"
+	"path/filepath"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/core"
+)
+
+func prepareV1GeneratorConfig(configPath, moduleDir string, gen v1.Generate, module v1.Module) (core.Options, error) {
+	cfg := core.Options{}
+	for _, root := range module.Roots {
+		cfg.Inputs.InputFilesDir = append(cfg.Inputs.InputFilesDir, core.InputFilesDir{Root: root, Path: "."})
+	}
+	for _, plugin := range gen.Plugins {
+		remote := plugin.Remote
+		if remote != "" {
+			remote += ":" + plugin.Version
+		}
+		outAbs := filepath.Join(filepath.Dir(configPath), plugin.Out)
+		outRel, err := filepath.Rel(moduleDir, outAbs)
+		if err != nil {
+			return core.Options{}, fmt.Errorf("Rel: %w", err)
+		}
+		cfg.Plugins = append(cfg.Plugins, core.Plugin{
+			Source: core.PluginSource{Name: plugin.Name, Path: plugin.Path, Command: plugin.Command, Remote: remote},
+			Out:    outRel, Options: plugin.Opts, WithImports: plugin.WithImports,
+		})
+	}
+	cfg.ManagedModeConfig = convertManagedModeConfig(gen.Generate.Managed)
+	if prefix := gen.Options.Go.PackagePrefix; prefix != nil && *prefix != "" {
+		cfg.GoPackageOutputPrefix = *prefix
+		cfg.ManagedModeConfig.GoPackageOnly = !cfg.ManagedModeConfig.Enabled
+		rule := core.ManagedOverrideRule{FileOption: "go_package_prefix", Value: *prefix, PackagePath: true}
+		if gen.InheritedGoPackagePrefix {
+			cfg.ManagedModeConfig.Override = append([]core.ManagedOverrideRule{rule}, cfg.ManagedModeConfig.Override...)
+		} else {
+			cfg.ManagedModeConfig.Override = append(cfg.ManagedModeConfig.Override, rule)
+		}
+	}
+	return cfg, nil
+}
+
+func convertManagedModeConfig(cfg config.ManagedMode) core.ManagedModeConfig {
+	managed := core.ManagedModeConfig{Enabled: cfg.Enabled}
+	if cfg.Disable != nil {
+		managed.Disable = make([]core.ManagedDisableRule, 0, len(cfg.Disable))
+	}
+	for _, rule := range cfg.Disable {
+		managed.Disable = append(managed.Disable, core.ManagedDisableRule{
+			Module: rule.Module, Package: rule.Package, Path: rule.Path,
+			FileOption: core.FileOptionType(rule.FileOption), FieldOption: core.FieldOptionType(rule.FieldOption), Field: rule.Field,
+		})
+	}
+	if cfg.Override != nil {
+		managed.Override = make([]core.ManagedOverrideRule, 0, len(cfg.Override))
+	}
+	for _, rule := range cfg.Override {
+		managed.Override = append(managed.Override, core.ManagedOverrideRule{
+			FileOption: core.FileOptionType(rule.FileOption), FieldOption: core.FieldOptionType(rule.FieldOption), Value: rule.Value,
+			Module: rule.Module, Package: rule.Package, Path: rule.Path, Field: rule.Field,
+		})
+	}
+	return managed
+}
diff --git a/internal/generation/config_test.go b/internal/generation/config_test.go
new file mode 100644
index 00000000..3d6e4db2
--- /dev/null
+++ b/internal/generation/config_test.go
@@ -0,0 +1,156 @@
+package generation
+
+import (
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/core"
+)
+
+func TestPrepareV1GeneratorConfigPreservesPluginSource(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name   string
+		plugin v1.Plugin
+		want   core.PluginSource
+	}{
+		{
+			name:   "named plugin",
+			plugin: v1.Plugin{Name: "go", Out: "gen"},
+			want:   core.PluginSource{Name: "go"},
+		},
+		{
+			name:   "binary path",
+			plugin: v1.Plugin{Path: "./tools/protoc-gen-custom", Out: "gen"},
+			want:   core.PluginSource{Path: "./tools/protoc-gen-custom"},
+		},
+		{
+			name:   "custom command",
+			plugin: v1.Plugin{Command: []string{"sh", "./tools/run-plugin"}, Out: "gen"},
+			want:   core.PluginSource{Command: []string{"sh", "./tools/run-plugin"}},
+		},
+		{
+			name:   "remote plugin",
+			plugin: v1.Plugin{Remote: "example.com/protoc-gen-custom", Version: "v1.2.3", Out: "gen"},
+			want:   core.PluginSource{Remote: "example.com/protoc-gen-custom:v1.2.3"},
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			module := v1.Module{Name: "example.com/module", Roots: []string{"."}}
+			gen := v1.Generate{Plugins: []v1.Plugin{tt.plugin}}
+
+			cfg, err := prepareV1GeneratorConfig(filepath.Join(root, v1.GenerateFile), root, gen, module)
+
+			require.NoError(t, err)
+			require.Len(t, cfg.Plugins, 1)
+			assert.Equal(t, tt.want, cfg.Plugins[0].Source)
+		})
+	}
+}
+
+func TestPrepareV1GeneratorConfigKeepsManagedOverridesIndependent(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name     string
+		capacity int
+	}{
+		{name: "append_reuses_capacity", capacity: 4},
+		{name: "append_allocates", capacity: 1},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			overrides := make([]config.ManagedOverrideRule, 1, tt.capacity)
+			overrides[0] = config.ManagedOverrideRule{FileOption: "go_package_prefix", Value: "example.com/base"}
+			gen := v1.Generate{}
+			gen.Generate.Managed.Override = overrides
+			firstPrefix, secondPrefix := "example.com/first", "example.com/second"
+			gen.Options.Go.PackagePrefix = &firstPrefix
+			module := v1.Module{Name: "example.com/module", Roots: []string{"."}}
+
+			first, err := prepareV1GeneratorConfig(filepath.Join(root, v1.GenerateFile), root, gen, module)
+			require.NoError(t, err)
+			gen.Options.Go.PackagePrefix = &secondPrefix
+			second, err := prepareV1GeneratorConfig(filepath.Join(root, v1.GenerateFile), root, gen, module)
+			require.NoError(t, err)
+
+			require.Len(t, first.ManagedModeConfig.Override, 2)
+			require.Len(t, second.ManagedModeConfig.Override, 2)
+			assert.Equal(t, firstPrefix, first.ManagedModeConfig.Override[1].Value)
+			assert.Equal(t, secondPrefix, second.ManagedModeConfig.Override[1].Value)
+			assert.Equal(t, []config.ManagedOverrideRule{{FileOption: "go_package_prefix", Value: "example.com/base"}}, gen.Generate.Managed.Override)
+		})
+	}
+}
+
+func TestPrepareV1GeneratorConfigPreservesManagedPriority(t *testing.T) {
+	t.Parallel()
+
+	prefix := "example.com/options"
+	managedRule := config.ManagedOverrideRule{FileOption: "go_package_prefix", Value: "example.com/managed"}
+	optionRule := core.ManagedOverrideRule{FileOption: "go_package_prefix", Value: prefix, PackagePath: true}
+	tests := []struct {
+		name          string
+		prefix        string
+		inherited     bool
+		overrides     []config.ManagedOverrideRule
+		wantOverrides []core.ManagedOverrideRule
+	}{
+		{
+			name:          "explicit_option_overrides_managed_rule",
+			prefix:        prefix,
+			overrides:     []config.ManagedOverrideRule{managedRule},
+			wantOverrides: []core.ManagedOverrideRule{{FileOption: "go_package_prefix", Value: "example.com/managed"}, optionRule},
+		},
+		{
+			name:          "inherited_option_precedes_managed_rule",
+			prefix:        prefix,
+			inherited:     true,
+			overrides:     []config.ManagedOverrideRule{managedRule},
+			wantOverrides: []core.ManagedOverrideRule{optionRule, {FileOption: "go_package_prefix", Value: "example.com/managed"}},
+		},
+		{
+			name: "omitted_overrides_remain_nil",
+		},
+		{
+			name:          "explicit_empty_overrides_remain_empty",
+			overrides:     []config.ManagedOverrideRule{},
+			wantOverrides: []core.ManagedOverrideRule{},
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			gen := v1.Generate{InheritedGoPackagePrefix: tt.inherited}
+			if tt.prefix != "" {
+				prefix := tt.prefix
+				gen.Options.Go.PackagePrefix = &prefix
+			}
+			gen.Generate.Managed.Override = tt.overrides
+			module := v1.Module{Name: "example.com/module", Roots: []string{"."}}
+
+			cfg, err := prepareV1GeneratorConfig(filepath.Join(root, v1.GenerateFile), root, gen, module)
+
+			require.NoError(t, err)
+			assert.Equal(t, tt.wantOverrides, cfg.ManagedModeConfig.Override)
+		})
+	}
+}
diff --git a/internal/generation/descriptor_conflict.go b/internal/generation/descriptor_conflict.go
new file mode 100644
index 00000000..86562cea
--- /dev/null
+++ b/internal/generation/descriptor_conflict.go
@@ -0,0 +1,151 @@
+package generation
+
+import (
+	"bytes"
+	"fmt"
+	"path/filepath"
+	"slices"
+
+	"google.golang.org/protobuf/reflect/protoreflect"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+func (target preparedDescriptorTarget) origin(file string) string {
+	owner, ok := target.owners[file]
+	if !ok {
+		return target.label + ", compiler-provided import"
+	}
+	version := target.versions[owner]
+	if version == "" {
+		version = "version unavailable (local source or unpinned metadata)"
+	}
+	return fmt.Sprintf("%s, source module %q, %s", target.label, owner, version)
+}
+
+// Version metadata enriches diagnostics only. Unused or missing locks must not
+// prevent export of a graph already resolved and checked by the module layer.
+func descriptorVersions(request Request, selected v1GenerationModule) map[string]string {
+	versions := make(map[string]string)
+	scope := selected.resolutionDir
+	if scope == "" {
+		scope = selected.directory
+	}
+	if scope == selected.directory {
+		versions[selected.module.Name] = "workspace " + relativeDescriptorPath(request.WorkDir, selected.directory)
+	}
+	scopes := []string{scope}
+	for _, directory := range scopes {
+		lock, err := modules.ReadLock(filepath.Join(directory, v1.LockFile))
+		if err == nil {
+			for _, entry := range lock.Modules {
+				versions[entry.Source] = fmt.Sprintf("version %s, commit %s", entry.Version, entry.Commit)
+			}
+		}
+	}
+	for _, directory := range scopes {
+		module, err := modules.ReadModuleOrDefault(directory)
+		if err != nil {
+			continue
+		}
+		for _, replacement := range module.Replaces {
+			versions[replacement.Module] = fmt.Sprintf("local replacement %q from %q", replacement.Target, relativeDescriptorPath(request.WorkDir, directory))
+		}
+	}
+	return versions
+}
+
+// descriptorDifference reports a differing field, not just the proto filename.
+func descriptorDifference(a, b protoreflect.Message, prefix string) string {
+	fields := make(map[protoreflect.FieldNumber]protoreflect.FieldDescriptor)
+	collect := func(fd protoreflect.FieldDescriptor, _ protoreflect.Value) bool {
+		fields[fd.Number()] = fd
+		return true
+	}
+	a.Range(collect)
+	b.Range(collect)
+	numbers := make([]int, 0, len(fields))
+	for number := range fields {
+		numbers = append(numbers, int(number))
+	}
+	slices.Sort(numbers)
+	for _, number := range numbers {
+		fd := fields[protoreflect.FieldNumber(number)]
+		field := string(fd.Name())
+		if prefix != "" {
+			field = prefix + "." + field
+		}
+		x, y := a.Get(fd), b.Get(fd)
+		if a.Has(fd) != b.Has(fd) {
+			return fmt.Sprintf("%s: presence differs (%t versus %t)", field, a.Has(fd), b.Has(fd))
+		}
+		switch {
+		case fd.IsList():
+			left, right := x.List(), y.List()
+			if left.Len() != right.Len() {
+				return fmt.Sprintf("%s: length %d versus %d", field, left.Len(), right.Len())
+			}
+			for i := range left.Len() {
+				if diff := descriptorValueDifference(left.Get(i), right.Get(i), fd, fmt.Sprintf("%s[%d]", field, i)); diff != "" {
+					return diff
+				}
+			}
+		case fd.IsMap():
+			left, right := x.Map(), y.Map()
+			keys := make(map[string]protoreflect.MapKey)
+			collectKey := func(key protoreflect.MapKey, _ protoreflect.Value) bool {
+				keys[key.String()] = key
+				return true
+			}
+			left.Range(collectKey)
+			right.Range(collectKey)
+			names := make([]string, 0, len(keys))
+			for name := range keys {
+				names = append(names, name)
+			}
+			slices.Sort(names)
+			for _, name := range names {
+				key := keys[name]
+				entry := fmt.Sprintf("%s[%q]", field, name)
+				if left.Has(key) != right.Has(key) {
+					return entry + ": presence differs"
+				}
+				if diff := descriptorValueDifference(left.Get(key), right.Get(key), fd.MapValue(), entry); diff != "" {
+					return diff
+				}
+			}
+		default:
+			if diff := descriptorValueDifference(x, y, fd, field); diff != "" {
+				return diff
+			}
+		}
+	}
+	if !bytes.Equal(a.GetUnknown(), b.GetUnknown()) {
+		return prefix + ": unknown or extension fields differ"
+	}
+	return ""
+}
+
+func descriptorValueDifference(a, b protoreflect.Value, fd protoreflect.FieldDescriptor, path string) string {
+	switch fd.Kind() {
+	case protoreflect.MessageKind, protoreflect.GroupKind:
+		return descriptorDifference(a.Message(), b.Message(), path)
+	case protoreflect.BytesKind:
+		if !bytes.Equal(a.Bytes(), b.Bytes()) {
+			return path + ": bytes differ"
+		}
+	default:
+		if a.Interface() != b.Interface() {
+			left, right := a.String(), b.String()
+			if len(left) > 120 {
+				left = left[:120] + "..."
+			}
+			if len(right) > 120 {
+				right = right[:120] + "..."
+			}
+			return fmt.Sprintf("%s: %q versus %q", path, left, right)
+		}
+	}
+	return ""
+}
diff --git a/internal/generation/descriptor_export_test.go b/internal/generation/descriptor_export_test.go
new file mode 100644
index 00000000..70aa4c39
--- /dev/null
+++ b/internal/generation/descriptor_export_test.go
@@ -0,0 +1,182 @@
+package generation
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"runtime"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"google.golang.org/protobuf/reflect/protodesc"
+
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestDescriptorPreflightDoesNotRunPlugins(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name       string
+		second     string
+		secondFile string
+		outDir     bool
+		wantError  string
+	}{
+		{name: "different file definitions without imports", second: "syntax = \"proto3\"; package other; message Item {}", secondFile: "item.proto", wantError: "conflicting descriptor"},
+		{name: "same symbol in different files", second: "syntax = \"proto3\"; package item; message Item {}", secondFile: "other.proto", wantError: "name conflict"},
+		{name: "later compilation failure", second: "not a protobuf file", secondFile: "other.proto", wantError: "Compile"},
+		{name: "later compilation failure in directory mode", second: "not a protobuf file", secondFile: "other.proto", outDir: true, wantError: "Compile"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeDescriptorMarker(t, root)
+			writeV1GenerateFixture(t, root, "easyp.gen.yaml", "version: v1\ngenerate:\n  modules: [a, b]\n"+descriptorMarkerConfig)
+			for _, name := range []string{"a", "b"} {
+				writeV1GenerateFixture(t, root, name+"/protobuf.mod", "module example.com/"+name+"\n")
+			}
+			writeV1GenerateFixture(t, root, "a/item.proto", "syntax = \"proto3\"; package item; message Item {}")
+			writeV1GenerateFixture(t, root, "b/"+tt.secondFile, tt.second)
+			out := filepath.Join(root, "all.pb")
+			require.NoError(t, os.WriteFile(out, []byte("previous output"), 0o600))
+			request := Request{WorkDir: root, DescriptorSetOut: out}
+			if tt.outDir {
+				request.DescriptorSetOut, request.DescriptorSetOutDir = "", filepath.Join(root, "descriptors")
+			}
+
+			err := Run(t.Context(), logger.NewNop(), nil, request)
+
+			require.ErrorContains(t, err, tt.wantError)
+			assert.NoFileExists(t, filepath.Join(root, "plugin-ran.txt"))
+			assert.NoDirExists(t, filepath.Join(root, "descriptors"))
+			previous, err := os.ReadFile(out)
+			require.NoError(t, err)
+			assert.Equal(t, "previous output", string(previous))
+		})
+	}
+}
+
+func TestDescriptorDirectoryIsolatesDependenciesAndConsumers(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name    string
+		include bool
+	}{
+		{name: "targets only"}, {name: "complete graph", include: true},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeDescriptorMarker(t, root)
+			for _, project := range []string{"backend", "frontend"} {
+				writeV1GenerateFixture(t, root, project+"/easyp.gen.yaml", "version: v1\ngenerate:\n  modules: [proto/user, proto/order]\noptions:\n  go:\n    package_prefix: example.com/"+project+"/gen\n"+descriptorMarkerConfig)
+			}
+			for i, module := range []string{"user", "order"} {
+				version := fmt.Sprintf("v1.%d.0", i)
+				writeV1GenerateFixture(t, root, "proto/"+module+"/protobuf.mod", "module example.com/"+module+"\nrequire example.com/common "+version+"\nreplace example.com/common => ../../common-"+version+"\n")
+				writeV1GenerateFixture(t, root, "proto/"+module+"/"+module+".proto", "syntax = \"proto3\"; package "+module+"; import \"money.proto\"; message Item { common.Money money = 1; }")
+				writeV1GenerateFixture(t, root, "common-"+version+"/protobuf.mod", "module example.com/common\n")
+				writeV1GenerateFixture(t, root, "common-"+version+"/money.proto", "syntax = \"proto3\"; package common; import \"google/protobuf/timestamp.proto\"; message Money { google.protobuf.Timestamp time = 1; string currency"+fmt.Sprint(i)+" = 2; }")
+			}
+			outDir := filepath.Join(root, "descriptors")
+			request := Request{AllProjects: true, WorkDir: root, DescriptorSetOutDir: "descriptors", IncludeImports: tt.include}
+
+			require.NoError(t, Run(t.Context(), logger.NewNop(), nil, request))
+
+			first := descriptorTree(t, outDir)
+			require.Len(t, first, 4)
+			for _, project := range []string{"backend", "frontend"} {
+				for i, module := range []string{"user", "order"} {
+					matches, err := filepath.Glob(filepath.Join(outDir, project, module+"-*.pb"))
+					require.NoError(t, err)
+					require.Len(t, matches, 1)
+					set := readDescriptorSet(t, matches[0])
+					want := []string{module + ".proto"}
+					if tt.include {
+						want = append(want, "money.proto", "google/protobuf/timestamp.proto")
+						_, err := protodesc.NewFiles(set)
+						require.NoError(t, err)
+					}
+					assert.ElementsMatch(t, want, descriptorNames(set))
+					for _, file := range set.File {
+						if file.GetName() == module+".proto" {
+							assert.Contains(t, file.GetOptions().GetGoPackage(), "example.com/"+project+"/gen")
+						}
+						if file.GetName() == "money.proto" {
+							assert.Equal(t, "currency"+fmt.Sprint(i), file.MessageType[0].Field[1].GetName())
+						}
+					}
+				}
+			}
+			for _, project := range []string{"backend", "frontend"} {
+				path := filepath.Join(root, project, "easyp.gen.yaml")
+				raw, err := os.ReadFile(path)
+				require.NoError(t, err)
+				require.NoError(t, os.WriteFile(path, []byte(strings.ReplaceAll(string(raw), "[proto/user, proto/order]", "[proto/order, proto/user]")), 0o644))
+			}
+			require.NoError(t, Run(t.Context(), logger.NewNop(), nil, request))
+			assert.Equal(t, first, descriptorTree(t, outDir))
+			calls, err := os.ReadFile(filepath.Join(root, "plugin-ran.txt"))
+			require.NoError(t, err)
+			assert.Equal(t, "xxxxxxxx", string(calls))
+		})
+	}
+}
+
+func TestDescriptorConflictExplainsConsumerOptions(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeDescriptorMarker(t, root)
+	writeV1GenerateFixture(t, root, "proto/protobuf.mod", "module example.com/item\n")
+	writeV1GenerateFixture(t, root, "proto/item.proto", "syntax = \"proto3\"; package item; message Item {}")
+	for _, project := range []string{"backend", "frontend"} {
+		writeV1GenerateFixture(t, root, project+"/easyp.gen.yaml", "version: v1\ngenerate:\n  modules: [proto]\noptions:\n  go:\n    package_prefix: example.com/"+project+"\n"+descriptorMarkerConfig)
+	}
+	err := Run(t.Context(), logger.NewNop(), nil, Request{AllProjects: true, WorkDir: root, DescriptorSetOut: "all.pb"})
+	for _, want := range []string{"conflicting descriptor", "item.proto", "backend", "frontend", "example.com/item", "options.go_package", "descriptor_set_out_dir"} {
+		require.ErrorContains(t, err, want)
+	}
+	assert.NoFileExists(t, filepath.Join(root, "plugin-ran.txt"))
+	assert.NoFileExists(t, filepath.Join(root, "all.pb"))
+	require.NoError(t, Run(t.Context(), logger.NewNop(), nil, Request{WorkDir: root, Project: "backend", DescriptorSetOut: "all.pb"}))
+	assert.Contains(t, readDescriptorSet(t, filepath.Join(root, "all.pb")).File[0].GetOptions().GetGoPackage(), "example.com/backend")
+}
+
+const descriptorMarkerConfig = "plugins:\n  - command: [sh, ./marker.sh]\n    out: gen\n"
+
+func writeDescriptorMarker(t *testing.T, root string) {
+	t.Helper()
+	if runtime.GOOS == "windows" {
+		t.Skip("fixture plugin uses a POSIX shell")
+	}
+	writeV1GenerateFixture(t, root, "marker.sh", "#!/bin/sh\ncat >/dev/null\nprintf x >> plugin-ran.txt\n")
+}
+
+func descriptorTree(t *testing.T, root string) map[string]string {
+	t.Helper()
+	files := make(map[string]string)
+	err := filepath.WalkDir(root, func(path string, entry os.DirEntry, walkErr error) error {
+		if walkErr != nil {
+			return walkErr
+		}
+		if entry.IsDir() {
+			return nil
+		}
+		raw, err := os.ReadFile(path)
+		if err != nil {
+			return err
+		}
+		relative, err := filepath.Rel(root, path)
+		if err != nil {
+			return err
+		}
+		files[filepath.ToSlash(relative)] = string(raw)
+		return nil
+	})
+	require.NoError(t, err)
+	return files
+}
diff --git a/internal/generation/descriptor_output.go b/internal/generation/descriptor_output.go
new file mode 100644
index 00000000..2d03ddf8
--- /dev/null
+++ b/internal/generation/descriptor_output.go
@@ -0,0 +1,175 @@
+package generation
+
+import (
+	"crypto/sha256"
+	"fmt"
+	"os"
+	"path"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	"google.golang.org/protobuf/proto"
+	"google.golang.org/protobuf/types/descriptorpb"
+
+	"github.com/easyp-tech/easyp/internal/fs/fs"
+)
+
+type descriptorOutput struct {
+	path string
+	raw  []byte
+	mode os.FileMode
+}
+
+func planDescriptorOutputs(request Request, targets []preparedDescriptorTarget) ([]descriptorOutput, error) {
+	var outputs []descriptorOutput
+	if request.DescriptorSetOut != "" {
+		set, err := combineDescriptorTargets(targets, request.IncludeImports)
+		if err != nil {
+			return nil, err
+		}
+		output, err := prepareDescriptorOutput(request.DescriptorSetOut, set)
+		if err != nil {
+			return nil, err
+		}
+		return []descriptorOutput{output}, nil
+	}
+	paths := make(map[string]string)
+	for _, target := range targets {
+		outputPath := descriptorTargetPath(request, target)
+		// Resolve existing ancestor symlinks before checking aliases: two projects
+		// can otherwise overwrite one export through different directory paths.
+		canonical, err := canonicalDescriptorOutputPath(outputPath)
+		if err != nil {
+			return nil, fmt.Errorf("canonicalDescriptorOutputPath: %w", err)
+		}
+		// Reject case aliases consistently, including on case-sensitive hosts.
+		key := strings.ToLower(canonical)
+		if previous, ok := paths[key]; ok {
+			return nil, fmt.Errorf("descriptor output collision at %q between %s and %s", outputPath, previous, target.label)
+		}
+		paths[key] = target.label
+		output, err := prepareDescriptorOutput(outputPath, target.plan.DescriptorSet(request.IncludeImports))
+		if err != nil {
+			return nil, err
+		}
+		outputs = append(outputs, output)
+	}
+	for key := range paths {
+		for parent := filepath.Dir(key); parent != filepath.Dir(parent); parent = filepath.Dir(parent) {
+			if _, exists := paths[parent]; exists {
+				return nil, fmt.Errorf("descriptor output path %q is also a parent directory of %q", parent, key)
+			}
+		}
+	}
+	slices.SortFunc(outputs, func(a, b descriptorOutput) int { return strings.Compare(a.path, b.path) })
+	return outputs, nil
+}
+
+func descriptorTargetPath(request Request, target preparedDescriptorTarget) string {
+	project := relativeDescriptorPath(request.WorkDir, filepath.Dir(target.target.configPath))
+	if !filepath.IsLocal(filepath.FromSlash(project)) {
+		project = filepath.Join("_external", descriptorFileStem(filepath.Base(filepath.Dir(target.target.configPath)), project))
+	}
+	identity := target.selected.module.Name
+	name := path.Base(identity)
+	if identity == "" {
+		directory := relativeDescriptorPath(request.WorkDir, target.selected.directory)
+		identity, name = "local:"+directory, path.Base(directory)
+		if name == "." {
+			name = "root"
+		}
+	}
+	return filepath.Join(request.DescriptorSetOutDir, filepath.FromSlash(project), descriptorFileStem(name, identity)+".pb")
+}
+
+// The identity suffix makes names stable even when another selected module has
+// the same basename. It does not depend on module order, versions or cache paths.
+func descriptorFileStem(name, identity string) string {
+	slug := strings.Map(func(r rune) rune {
+		if r >= 'a' && r <= 'z' || r >= '0' && r <= '9' || r == '-' || r == '_' || r == '.' {
+			return r
+		}
+		return '-'
+	}, strings.ToLower(name))
+	slug = strings.Trim(slug, "-.")
+	if len(slug) > 48 {
+		slug = slug[:48]
+	}
+	if slug == "" {
+		slug = "module"
+	}
+	digest := sha256.Sum256([]byte(identity))
+	return fmt.Sprintf("%s-%x", slug, digest[:6])
+}
+
+func prepareDescriptorOutput(path string, set *descriptorpb.FileDescriptorSet) (descriptorOutput, error) {
+	raw, err := proto.MarshalOptions{Deterministic: true}.Marshal(set)
+	if err != nil {
+		return descriptorOutput{}, fmt.Errorf("Marshal: %w", err)
+	}
+	mode := os.FileMode(0o644)
+	info, err := os.Lstat(path)
+	if err == nil {
+		if !info.Mode().IsRegular() {
+			return descriptorOutput{}, fmt.Errorf("descriptor output %q is not a regular file", path)
+		}
+		mode = info.Mode().Perm()
+	} else if !os.IsNotExist(err) {
+		return descriptorOutput{}, fmt.Errorf("Lstat: %w", err)
+	}
+	if _, err := canonicalDescriptorOutputPath(path); err != nil {
+		return descriptorOutput{}, fmt.Errorf("canonicalDescriptorOutputPath: %w", err)
+	}
+	for dir := filepath.Dir(path); ; dir = filepath.Dir(dir) {
+		info, err := os.Stat(dir)
+		if err == nil {
+			if !info.IsDir() {
+				return descriptorOutput{}, fmt.Errorf("descriptor output parent %q is not a directory", dir)
+			}
+			break
+		}
+		if !os.IsNotExist(err) || filepath.Dir(dir) == dir {
+			return descriptorOutput{}, fmt.Errorf("Stat: %w", err)
+		}
+	}
+	return descriptorOutput{path: path, raw: raw, mode: mode}, nil
+}
+
+func (output descriptorOutput) write() error {
+	if err := os.MkdirAll(filepath.Dir(output.path), 0o755); err != nil {
+		return fmt.Errorf("MkdirAll: %w", err)
+	}
+	if err := fs.WriteAtomicFile(output.path, output.raw, output.mode); err != nil {
+		return fmt.Errorf("WriteAtomicFile: %w", err)
+	}
+	return nil
+}
+
+// canonicalDescriptorOutputPath resolves the existing part of an output path.
+// Missing descendants are appended without creating directories during preflight.
+func canonicalDescriptorOutputPath(outputPath string) (string, error) {
+	directory := filepath.Dir(outputPath)
+	var missing []string
+	for {
+		resolved, err := filepath.EvalSymlinks(directory)
+		if err == nil {
+			for i := len(missing) - 1; i >= 0; i-- {
+				resolved = filepath.Join(resolved, missing[i])
+			}
+			return filepath.Join(resolved, filepath.Base(outputPath)), nil
+		}
+		if !os.IsNotExist(err) || directory == filepath.Dir(directory) {
+			return "", fmt.Errorf("EvalSymlinks: %w", err)
+		}
+		// An existing symlink with an unresolved target is not a missing
+		// directory that MkdirAll can safely create later.
+		if _, statErr := os.Lstat(directory); statErr == nil {
+			return "", fmt.Errorf("EvalSymlinks: %w", err)
+		} else if !os.IsNotExist(statErr) {
+			return "", fmt.Errorf("Lstat: %w", statErr)
+		}
+		missing = append(missing, filepath.Base(directory))
+		directory = filepath.Dir(directory)
+	}
+}
diff --git a/internal/generation/descriptor_output_test.go b/internal/generation/descriptor_output_test.go
new file mode 100644
index 00000000..93461633
--- /dev/null
+++ b/internal/generation/descriptor_output_test.go
@@ -0,0 +1,87 @@
+package generation
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestDescriptorOutputRejectsDirectoryAliases(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeDescriptorMarker(t, root)
+	writeV1GenerateFixture(t, root, "proto/protobuf.mod", "module example.com/item\n")
+	writeV1GenerateFixture(t, root, "proto/item.proto", "syntax = \"proto3\"; package item; message Item {}")
+	for _, project := range []string{"backend", "frontend"} {
+		writeV1GenerateFixture(t, root, project+"/easyp.gen.yaml", "generate:\n  modules: [proto]\noptions:\n  go:\n    package_prefix: example.com/"+project+"\n"+descriptorMarkerConfig)
+	}
+	out := filepath.Join(root, "sets")
+	require.NoError(t, os.MkdirAll(filepath.Join(out, "backend"), 0o755))
+	require.NoError(t, os.Symlink("backend", filepath.Join(out, "frontend")))
+
+	err := Run(t.Context(), logger.NewNop(), nil, Request{AllProjects: true, WorkDir: root, DescriptorSetOutDir: out})
+
+	require.ErrorContains(t, err, "output collision")
+	assert.NoFileExists(t, filepath.Join(root, "plugin-ran.txt"))
+	entries, err := os.ReadDir(filepath.Join(out, "backend"))
+	require.NoError(t, err)
+	assert.Empty(t, entries)
+}
+
+func TestDescriptorOutputPreservesExistingMode(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name  string
+		split bool
+	}{
+		{name: "combined"},
+		{name: "split", split: true},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeV1GenerateFixture(t, root, "protobuf.mod", "module example.com/item\n")
+			writeV1GenerateFixture(t, root, "item.proto", "syntax = \"proto3\"; package item; message Item {}")
+			writeV1GenerateFixture(t, root, "easyp.gen.yaml", "version: v1\n")
+			request := Request{WorkDir: root, DescriptorSetOut: "nested/all.pb"}
+			if tt.split {
+				request.DescriptorSetOut, request.DescriptorSetOutDir = "", "nested/sets"
+			}
+			require.NoError(t, Run(t.Context(), logger.NewNop(), nil, request))
+			tree := descriptorTree(t, filepath.Join(root, "nested"))
+			require.Len(t, tree, 1)
+			var output string
+			for name := range tree {
+				output = filepath.Join(root, "nested", filepath.FromSlash(name))
+			}
+			require.NoError(t, os.Chmod(output, 0o600))
+			require.NoError(t, Run(t.Context(), logger.NewNop(), nil, request))
+			info, err := os.Stat(output)
+			require.NoError(t, err)
+			assert.Equal(t, os.FileMode(0o600), info.Mode().Perm())
+			assert.Equal(t, tree, descriptorTree(t, filepath.Join(root, "nested")))
+		})
+	}
+}
+
+func TestDescriptorOutputRejectsDanglingAncestor(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeDescriptorMarker(t, root)
+	writeV1GenerateFixture(t, root, "protobuf.mod", "module example.com/item\n")
+	writeV1GenerateFixture(t, root, "item.proto", "syntax = \"proto3\"; package item; message Item {}")
+	writeV1GenerateFixture(t, root, "easyp.gen.yaml", descriptorMarkerConfig)
+	require.NoError(t, os.Symlink("missing-directory", filepath.Join(root, "out")))
+
+	err := Run(t.Context(), logger.NewNop(), nil, Request{WorkDir: root, DescriptorSetOut: "out/nested/all.pb"})
+
+	require.ErrorContains(t, err, "EvalSymlinks")
+	assert.NoFileExists(t, filepath.Join(root, "plugin-ran.txt"))
+	assert.NoDirExists(t, filepath.Join(root, "missing-directory"))
+}
diff --git a/internal/generation/descriptor_safety_test.go b/internal/generation/descriptor_safety_test.go
new file mode 100644
index 00000000..0701aa74
--- /dev/null
+++ b/internal/generation/descriptor_safety_test.go
@@ -0,0 +1,97 @@
+package generation
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestDescriptorOutputFlagsAreExclusive(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	err := Run(t.Context(), logger.NewNop(), nil, Request{WorkDir: root, DescriptorSetOut: "all.pb", DescriptorSetOutDir: "sets"})
+	require.ErrorContains(t, err, "mutually exclusive")
+	files, err := os.ReadDir(root)
+	require.NoError(t, err)
+	assert.Empty(t, files)
+}
+
+func TestDescriptorOutputPreflight(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name            string
+		parentFile      bool
+		sameIdentity    bool
+		duplicateTarget bool
+	}{
+		{name: "parent is a file", parentFile: true},
+		{name: "different sources claim one identity", sameIdentity: true},
+		{name: "duplicate selection runs once", duplicateTarget: true},
+		{name: "same basename different identities"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeDescriptorMarker(t, root)
+			modules := "[a, b]"
+			if tt.duplicateTarget {
+				modules = "[a, a]"
+			}
+			writeV1GenerateFixture(t, root, "easyp.gen.yaml", "version: v1\ngenerate:\n  modules: "+modules+"\n"+descriptorMarkerConfig)
+			for _, module := range []string{"a", "b"} {
+				identity := module + ".example.com/same"
+				if tt.sameIdentity {
+					identity = "example.com/same"
+				}
+				writeV1GenerateFixture(t, root, module+"/protobuf.mod", "module "+identity+"\n")
+				writeV1GenerateFixture(t, root, module+"/item.proto", "syntax = \"proto3\"; package "+module+"; message Item {}")
+			}
+			outDir := filepath.Join(root, "sets")
+			if tt.parentFile {
+				require.NoError(t, os.WriteFile(outDir, []byte("keep"), 0o600))
+			}
+			err := Run(t.Context(), logger.NewNop(), nil, Request{WorkDir: root, DescriptorSetOutDir: outDir})
+			if tt.parentFile || tt.sameIdentity {
+				require.Error(t, err)
+				assert.NoFileExists(t, filepath.Join(root, "plugin-ran.txt"))
+				if tt.sameIdentity {
+					assert.Contains(t, err.Error(), "output collision")
+				}
+				return
+			}
+			require.NoError(t, err)
+			want := 2
+			if tt.duplicateTarget {
+				want = 1
+			}
+			assert.Len(t, descriptorTree(t, outDir), want)
+			calls, err := os.ReadFile(filepath.Join(root, "plugin-ran.txt"))
+			require.NoError(t, err)
+			assert.Len(t, calls, want)
+		})
+	}
+}
+
+func TestDescriptorExportUsesPreparedGraph(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeDescriptorMarker(t, root)
+	writeV1GenerateFixture(t, root, "marker.sh", "#!/bin/sh\ncat >/dev/null\nprintf x >> plugin-ran.txt\nprintf invalid > b/item.proto\n")
+	writeV1GenerateFixture(t, root, "easyp.gen.yaml", "version: v1\ngenerate:\n  modules: [a, b]\n"+descriptorMarkerConfig)
+	for _, module := range []string{"a", "b"} {
+		writeV1GenerateFixture(t, root, module+"/protobuf.mod", "module example.com/"+module+"\n")
+		writeV1GenerateFixture(t, root, module+"/item.proto", "syntax = \"proto3\"; package "+module+"; message Item {}")
+	}
+	outDir := filepath.Join(root, "sets")
+	require.NoError(t, Run(t.Context(), logger.NewNop(), nil, Request{WorkDir: root, DescriptorSetOutDir: outDir, IncludeImports: true}))
+	assert.Len(t, descriptorTree(t, outDir), 2)
+	calls, err := os.ReadFile(filepath.Join(root, "plugin-ran.txt"))
+	require.NoError(t, err)
+	assert.Equal(t, "xx", string(calls))
+}
diff --git a/internal/generation/descriptor_set.go b/internal/generation/descriptor_set.go
new file mode 100644
index 00000000..f28d4e03
--- /dev/null
+++ b/internal/generation/descriptor_set.go
@@ -0,0 +1,202 @@
+package generation
+
+import (
+	"context"
+	"fmt"
+	"log/slog"
+	"maps"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	"google.golang.org/protobuf/proto"
+	"google.golang.org/protobuf/reflect/protodesc"
+	"google.golang.org/protobuf/types/descriptorpb"
+
+	"github.com/easyp-tech/easyp/internal/core"
+	"github.com/easyp-tech/easyp/internal/logger"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+type preparedDescriptorTarget struct {
+	target   generationTarget
+	selected v1GenerationModule
+	plan     *core.GenerationPlan
+	full     *descriptorpb.FileDescriptorSet
+	owners   map[string]string
+	versions map[string]string
+	label    string
+}
+
+// generateV1DescriptorSet validates every requested graph before executing any
+// plugin. Export uses those same prepared graphs, never a second compilation.
+func generateV1DescriptorSet(ctx context.Context, log logger.Logger, cache modules.Cache, request Request, targets []generationTarget) error {
+	prepared, err := prepareDescriptorTargets(ctx, log, cache, request, targets)
+	if err != nil {
+		return fmt.Errorf("prepareDescriptorTargets: %w", err)
+	}
+	outputs, err := planDescriptorOutputs(request, prepared)
+	if err != nil {
+		return fmt.Errorf("planDescriptorOutputs: %w", err)
+	}
+	if err := executePreparedTargets(ctx, prepared); err != nil {
+		return err
+	}
+	for _, output := range outputs {
+		if err := ctx.Err(); err != nil {
+			return err
+		}
+		if err := output.write(); err != nil {
+			return fmt.Errorf("write %s: %w", output.path, err)
+		}
+		log.Info(ctx, "descriptor set written", slog.String("path", output.path))
+	}
+	return nil
+}
+
+func prepareDescriptorTargets(ctx context.Context, log logger.Logger, cache modules.Cache, request Request, targets []generationTarget) ([]preparedDescriptorTarget, error) {
+	prepared := make([]preparedDescriptorTarget, 0, len(targets))
+	seen := make(map[string]bool)
+	requested := make(map[string][]string)
+	matched := make(map[string]map[string]bool)
+	for _, target := range targets {
+		if len(target.config.Generate.Packages) > 0 {
+			requested[target.configPath] = target.config.Generate.Packages
+			matched[target.configPath] = make(map[string]bool)
+		}
+	}
+	for _, target := range targets {
+		if err := ctx.Err(); err != nil {
+			return nil, err
+		}
+		selected, err := resolveV1GenerationModule(ctx, cache, request.WorkspaceRoot, filepath.Dir(target.configPath), target.module, request.Frozen)
+		if err != nil {
+			return nil, fmt.Errorf("resolveV1GenerationModule for %s: %w", target.configPath, err)
+		}
+		// Options-only selections still validate their graph in frozen mode, but
+		// have no generation work unless descriptor export was requested.
+		if len(target.config.Plugins) == 0 && len(target.config.Generate.Packages) == 0 && request.DescriptorSetOut == "" && request.DescriptorSetOutDir == "" {
+			continue
+		}
+		key := filepath.Clean(target.configPath) + "\x00" + filepath.Clean(selected.directory)
+		if seen[key] {
+			continue
+		}
+		seen[key] = true
+		var files []string
+		if len(target.config.Generate.Packages) > 0 {
+			var matches map[string]bool
+			files, matches, err = selectedPackageFiles(ctx, selected, target.config.Generate.Packages)
+			if err != nil {
+				return nil, fmt.Errorf("package selection in %s: %w", target.configPath, err)
+			}
+			maps.Copy(matched[target.configPath], matches)
+			if len(files) == 0 {
+				continue
+			}
+		}
+		label := fmt.Sprintf("project %q, module %q (%s)", relativeDescriptorPath(request.WorkDir, filepath.Dir(target.configPath)), selected.module.Name, relativeDescriptorPath(request.WorkDir, selected.directory))
+		app, err := prepareV1ModuleCore(log, request, target.configPath, selected.directory, target.config, selected.module, selected.dependencies)
+		if err != nil {
+			return nil, fmt.Errorf("prepareV1ModuleCore for %s: %w", label, err)
+		}
+		var plan *core.GenerationPlan
+		if files != nil {
+			plan, err = app.PrepareGenerationFiles(ctx, selected.directory, files)
+		} else {
+			plan, err = app.PrepareGeneration(ctx, selected.directory)
+		}
+		if err != nil {
+			return nil, fmt.Errorf("PrepareGeneration for %s: %w", label, err)
+		}
+		full := plan.DescriptorSet(true)
+		if _, err := protodesc.NewFiles(full); err != nil {
+			return nil, fmt.Errorf("validate descriptor set for %s: %w", label, err)
+		}
+		roots, err := modules.ModuleSources(selected.directory, selected.module)
+		if err != nil {
+			return nil, fmt.Errorf("ModuleSources: %w", err)
+		}
+		roots = append(roots, selected.dependencies...)
+		owners, err := roots.FileModules()
+		if err != nil {
+			return nil, fmt.Errorf("FileModules: %w", err)
+		}
+		versions := descriptorVersions(request, selected)
+		prepared = append(prepared, preparedDescriptorTarget{target: target, selected: selected, plan: plan, full: full, owners: owners, versions: versions, label: label})
+	}
+	for _, path := range slices.Sorted(maps.Keys(requested)) {
+		var unknown []string
+		for _, name := range requested[path] {
+			if !matched[path][name] && !slices.Contains(unknown, name) {
+				unknown = append(unknown, name)
+			}
+		}
+		if len(unknown) > 0 {
+			return nil, fmt.Errorf("%s: generate.packages did not match any selected module source files: %s", path, strings.Join(unknown, ", "))
+		}
+	}
+	return prepared, nil
+}
+
+func combineDescriptorTargets(targets []preparedDescriptorTarget, includeImports bool) (*descriptorpb.FileDescriptorSet, error) {
+	combined := &descriptorpb.FileDescriptorSet{}
+	files := make(map[string]*descriptorpb.FileDescriptorProto)
+	origins := make(map[string]int)
+	selectedFiles := make(map[string]bool)
+	var labels []string
+	for index, target := range targets {
+		labels = append(labels, target.label)
+		for _, file := range target.plan.DescriptorSet(false).File {
+			selectedFiles[file.GetName()] = true
+		}
+		for _, file := range target.full.File {
+			name := file.GetName()
+			if previous, ok := files[name]; ok {
+				if !proto.Equal(previous, file) {
+					return nil, fmt.Errorf("conflicting descriptor %q: %s; first: %s; second: %s; select a compatible --project or use --descriptor_set_out_dir for independent graphs", name, descriptorDifference(previous.ProtoReflect(), file.ProtoReflect(), ""), targets[origins[name]].origin(name), target.origin(name))
+				}
+				continue
+			}
+			files[name], origins[name] = file, index
+			combined.File = append(combined.File, file)
+		}
+	}
+	if _, err := protodesc.NewFiles(combined); err != nil {
+		return nil, fmt.Errorf("validate combined descriptor set for [%s]: %w", strings.Join(labels, "; "), err)
+	}
+	if includeImports {
+		return combined, nil
+	}
+	output := &descriptorpb.FileDescriptorSet{}
+	for _, file := range combined.File {
+		if selectedFiles[file.GetName()] {
+			output.File = append(output.File, file)
+		}
+	}
+	return output, nil
+}
+
+func relativeDescriptorPath(root, path string) string {
+	relative, err := filepath.Rel(root, path)
+	if err != nil {
+		return filepath.ToSlash(path)
+	}
+	return filepath.ToSlash(relative)
+}
+
+func executePreparedTargets(ctx context.Context, prepared []preparedDescriptorTarget) error {
+	bucket := core.NewGenerateBucket()
+	for _, target := range prepared {
+		if err := ctx.Err(); err != nil {
+			return err
+		}
+		if err := target.plan.ExecuteInto(ctx, bucket); err != nil {
+			return fmt.Errorf("ExecuteInto for %s: %w", target.label, err)
+		}
+	}
+	if err := bucket.DumpToFs(ctx); err != nil {
+		return fmt.Errorf("DumpToFs: %w", err)
+	}
+	return nil
+}
diff --git a/internal/generation/descriptor_set_test.go b/internal/generation/descriptor_set_test.go
new file mode 100644
index 00000000..45f529f3
--- /dev/null
+++ b/internal/generation/descriptor_set_test.go
@@ -0,0 +1,120 @@
+package generation
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+	"google.golang.org/protobuf/proto"
+	"google.golang.org/protobuf/reflect/protodesc"
+	"google.golang.org/protobuf/types/descriptorpb"
+
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestRunDescriptorSetSkipsOptionsOnlyParentAcrossModules(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	files := map[string]string{
+		"easyp.gen.yaml":            "version: v1\noptions:\n  go:\n    package_prefix: example.com/gen\n",
+		"backend/easyp.gen.yaml":    "version: v1\ngenerate:\n  modules: [proto/orders, proto/users]\n",
+		"proto/orders/protobuf.mod": "module example.com/orders\n",
+		"proto/orders/orders.proto": "syntax = \"proto3\"; package orders.v1; message Order {}\n",
+		"proto/users/protobuf.mod":  "module example.com/users\n",
+		"legacy/orphan.proto":       "syntax = \"proto3\"; package legacy; message Orphan {}\n",
+		"proto/users/users.proto":   "syntax = \"proto3\"; package users.v1; message User {}\n",
+	}
+	for path, content := range files {
+		writeV1GenerateFixture(t, root, path, content)
+	}
+	out := filepath.Join(root, "all.pb")
+
+	require.NoError(t, Run(t.Context(), logger.NewNop(), nil, Request{AllProjects: true, WorkDir: root, DescriptorSetOut: out}))
+
+	set := readDescriptorSet(t, out)
+	require.ElementsMatch(t, []string{"orders.proto", "users.proto"}, descriptorNames(set))
+}
+
+func TestRunDescriptorSetRejectsCombinedSymbolConflict(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	files := map[string]string{
+		"easyp.gen.yaml":  "version: v1\ngenerate:\n  modules: [m1, m2]\n",
+		"m1/protobuf.mod": "module example.com/m1\n",
+		"m2/protobuf.mod": "module example.com/m2\n",
+		"m1/first.proto":  "syntax = \"proto3\"; package acme.v1; message Item { string first = 1; }",
+		"m2/second.proto": "syntax = \"proto3\"; package acme.v1; message Item { string second = 1; }",
+	}
+	for path, content := range files {
+		writeV1GenerateFixture(t, root, path, content)
+	}
+	out := filepath.Join(root, "all.pb")
+	previous := []byte("previous descriptor output")
+	require.NoError(t, os.WriteFile(out, previous, 0o600))
+	err := Run(t.Context(), logger.NewNop(), nil, Request{WorkDir: root, DescriptorSetOut: out, IncludeImports: true})
+
+	require.ErrorContains(t, err, "name conflict")
+	actual, readErr := os.ReadFile(out)
+	require.NoError(t, readErr)
+	require.Equal(t, previous, actual)
+}
+
+func TestRunDescriptorSetSharedImports(t *testing.T) {
+	t.Parallel()
+	for _, include := range []bool{false, true} {
+		include := include
+		t.Run(fmt.Sprintf("include_imports_%t", include), func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			files := map[string]string{
+				"easyp.gen.yaml":      "version: v1\ngenerate:\n  modules: [m1, m2]\n",
+				"shared/protobuf.mod": "module example.com/shared\n",
+				"shared/common.proto": "syntax = \"proto3\"; package shared; import \"google/protobuf/timestamp.proto\"; message Common { google.protobuf.Timestamp created = 1; }\n",
+			}
+			for _, module := range []string{"m1", "m2"} {
+				files[module+"/protobuf.mod"] = "module example.com/" + module + "\nrequire example.com/shared v1.0.0\nreplace example.com/shared => ../shared\n"
+				files[module+"/"+module+".proto"] = "syntax = \"proto3\"; package " + module + "; import \"common.proto\"; message Item { shared.Common common = 1; }\n"
+			}
+			for path, content := range files {
+				writeV1GenerateFixture(t, root, path, content)
+			}
+			out := filepath.Join(root, "all.pb")
+			request := Request{WorkDir: root, DescriptorSetOut: out, IncludeImports: include}
+
+			require.NoError(t, Run(t.Context(), logger.NewNop(), nil, request))
+			first, err := os.ReadFile(out)
+			require.NoError(t, err)
+			set := readDescriptorSet(t, out)
+			want := []string{"m1.proto", "m2.proto"}
+			if include {
+				want = append(want, "common.proto", "google/protobuf/timestamp.proto")
+				_, err := protodesc.NewFiles(set)
+				require.NoError(t, err)
+			}
+			require.ElementsMatch(t, want, descriptorNames(set))
+
+			require.NoError(t, Run(t.Context(), logger.NewNop(), nil, request))
+			second, err := os.ReadFile(out)
+			require.NoError(t, err)
+			require.Equal(t, first, second)
+		})
+	}
+}
+
+func readDescriptorSet(t *testing.T, path string) *descriptorpb.FileDescriptorSet {
+	t.Helper()
+	raw, err := os.ReadFile(path)
+	require.NoError(t, err)
+	set := new(descriptorpb.FileDescriptorSet)
+	require.NoError(t, proto.Unmarshal(raw, set))
+	return set
+}
+func descriptorNames(set *descriptorpb.FileDescriptorSet) []string {
+	names := make([]string, 0, len(set.File))
+	for _, file := range set.File {
+		names = append(names, file.GetName())
+	}
+	return names
+}
diff --git a/internal/generation/discovery.go b/internal/generation/discovery.go
new file mode 100644
index 00000000..539e8dd5
--- /dev/null
+++ b/internal/generation/discovery.go
@@ -0,0 +1,70 @@
+package generation
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"slices"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/workspace"
+)
+
+func selectGenerateConfigs(request Request) ([]string, error) {
+	projects := slices.Clone(request.Projects)
+	if request.Project != "" {
+		projects = append(projects, request.Project)
+	}
+	if request.AllProjects && len(projects) != 0 {
+		return nil, fmt.Errorf("--all and --project are mutually exclusive")
+	}
+	if request.AllProjects {
+		return discoverV1GenerateConfigs(request.WorkDir, "")
+	}
+	if len(projects) > 0 {
+		var configs []string
+		for _, project := range projects {
+			if project == "" {
+				return nil, fmt.Errorf("--project must not be empty")
+			}
+			paths, err := discoverV1GenerateConfigs(request.WorkDir, project)
+			if err != nil {
+				return nil, err
+			}
+			for _, path := range paths {
+				if !slices.Contains(configs, path) {
+					configs = append(configs, path)
+				}
+			}
+		}
+		return configs, nil
+	}
+	path, err := workspace.FindUp(request.WorkDir, request.WorkspaceRoot, "easyp.gen.yaml")
+	if err != nil {
+		return nil, err
+	}
+	if path == "" {
+		legacy, lookupErr := workspace.FindUp(request.WorkDir, request.WorkspaceRoot, v1.PolicyFile)
+		if lookupErr != nil {
+			return nil, lookupErr
+		}
+		if legacy != "" {
+			raw, readErr := os.ReadFile(legacy)
+			if readErr != nil {
+				return nil, readErr
+			}
+			if v1.LegacyPolicy(raw) {
+				return nil, v1.ErrLegacyConfiguration
+			}
+		}
+		return nil, fmt.Errorf("no selected easyp.gen.yaml; choose --project <directory> (repeatable), or --all for recursive generation")
+	}
+	info, err := os.Lstat(path)
+	if err != nil {
+		return nil, err
+	}
+	if info.Mode()&os.ModeSymlink != 0 {
+		return nil, fmt.Errorf("automatic generation selection does not follow symlink config %s; select its project explicitly", path)
+	}
+	return []string{filepath.Clean(path)}, nil
+}
diff --git a/internal/generation/fixtures_test.go b/internal/generation/fixtures_test.go
new file mode 100644
index 00000000..9027a577
--- /dev/null
+++ b/internal/generation/fixtures_test.go
@@ -0,0 +1,29 @@
+package generation
+
+import (
+	"os"
+	"os/exec"
+	"path/filepath"
+	"testing"
+
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func runTestGit(t *testing.T, dir string, args ...string) string {
+	t.Helper()
+	cmd := exec.Command("git", append([]string{"-C", dir}, args...)...)
+	out, err := cmd.CombinedOutput()
+	if err != nil {
+		t.Fatalf("git %v: %v: %s", args, err, out)
+	}
+	return string(out)
+}
+func writeTestLock(root string, lock v1.Lock) error {
+	raw, err := yaml.Marshal(lock)
+	if err != nil {
+		return err
+	}
+	return os.WriteFile(filepath.Join(root, v1.LockFile), raw, 0o600)
+}
diff --git a/internal/generation/frozen.go b/internal/generation/frozen.go
new file mode 100644
index 00000000..a5882bc6
--- /dev/null
+++ b/internal/generation/frozen.go
@@ -0,0 +1,69 @@
+package generation
+
+import (
+	"context"
+	"fmt"
+	"path/filepath"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+func readFrozenGenerationModule(ctx context.Context, cache modules.Cache, directory string) (v1GenerationModule, error) {
+	dependencies, err := modules.EnsureFrozenSources(ctx, directory, cache)
+	if err != nil {
+		return v1GenerationModule{}, fmt.Errorf("EnsureFrozenSources: %w", err)
+	}
+	_, module, err := modules.ReadManifest(directory)
+	if err != nil {
+		return v1GenerationModule{}, fmt.Errorf("ReadManifest: %w", err)
+	}
+	return v1GenerationModule{directory: directory, resolutionDir: directory, module: module, dependencies: dependencies}, nil
+}
+
+func resolveFrozenGenerationModule(ctx context.Context, cache modules.Cache, repoRoot, configDir string, selection v1ModuleSelection) (v1GenerationModule, error) {
+	if selection.directory != "" {
+		return readFrozenGenerationModule(ctx, cache, selection.directory)
+	}
+	consumerDir, err := generatorV1ModuleDir(repoRoot, configDir)
+	if err != nil {
+		return v1GenerationModule{}, fmt.Errorf("generatorV1ModuleDir: %w", err)
+	}
+	consumer, err := readFrozenGenerationModule(ctx, cache, consumerDir)
+	if err != nil {
+		return v1GenerationModule{}, err
+	}
+	if consumer.module.Name == selection.source {
+		return consumer, nil
+	}
+	lock, err := modules.ReadLock(filepath.Join(consumerDir, v1.LockFile))
+	if err != nil {
+		return v1GenerationModule{}, fmt.Errorf("ReadLock: %w", err)
+	}
+	// A dependency is validated against the consumer graph. Its checkout need
+	// not contain a lock and dependency-owned replacement directives are ignored.
+	for _, entry := range lock.Modules {
+		if entry.Source != selection.source {
+			continue
+		}
+		directory, module, err := cache.Cached(entry)
+		if err != nil {
+			return v1GenerationModule{}, fmt.Errorf("Cached: %w", err)
+		}
+		var others modules.SourceRoots
+		for _, root := range consumer.dependencies {
+			if root.Module != selection.source {
+				others = append(others, root)
+			}
+		}
+		return v1GenerationModule{directory: directory, resolutionDir: consumerDir, module: module, dependencies: others}, nil
+	}
+	localDir, err := findV1LocalModuleByName(repoRoot, selection.source)
+	if err != nil {
+		return v1GenerationModule{}, fmt.Errorf("findV1LocalModuleByName: %w", err)
+	}
+	if localDir != "" {
+		return readFrozenGenerationModule(ctx, cache, localDir)
+	}
+	return v1GenerationModule{}, fmt.Errorf("frozen module %q is not selected in %s", selection.source, filepath.Join(consumerDir, v1.LockFile))
+}
diff --git a/internal/generation/frozen_test.go b/internal/generation/frozen_test.go
new file mode 100644
index 00000000..1d15b116
--- /dev/null
+++ b/internal/generation/frozen_test.go
@@ -0,0 +1,51 @@
+package generation
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/easyp-tech/easyp/internal/logger"
+	"github.com/stretchr/testify/require"
+)
+
+func TestFrozenGenerationPreflightsAllSelectedProjects(t *testing.T) {
+	t.Parallel()
+	for _, failure := range []string{"missing lock", "unused replace"} {
+		t.Run(failure, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			for _, name := range []string{"a", "b"} {
+				dir := filepath.Join(root, name)
+				writeV1GenerateFixture(t, dir, "protobuf.mod", "module example.com/"+name+"\nroots proto\n")
+				writeV1GenerateFixture(t, dir, "protobuf.lock", "version: 1\nmodules: []\n")
+				writeV1GenerateFixture(t, dir, "proto/"+name+".proto", "syntax = \"proto3\"; package "+name+".v1; message Item {}")
+				writeV1GenerateFixture(t, dir, "easyp.gen.yaml", "version: v1\nplugins:\n  - command: [sh, -c, 'touch marker; cat >/dev/null']\n    out: gen\n")
+			}
+			if failure == "missing lock" {
+				require.NoError(t, os.Remove(filepath.Join(root, "b", "protobuf.lock")))
+			} else {
+				writeV1GenerateFixture(t, filepath.Join(root, "b"), "protobuf.mod", "module example.com/b\nroots proto\nreplace example.com/unused => ../nonexistent\n")
+			}
+			err := Run(t.Context(), logger.NewNop(), nil, Request{WorkDir: root, WorkspaceRoot: root, AllProjects: true, Frozen: true})
+			require.ErrorContains(t, err, "frozen")
+			require.NoFileExists(t, filepath.Join(root, "marker"))
+			err = Run(t.Context(), logger.NewNop(), nil, Request{WorkDir: root, WorkspaceRoot: root, Projects: []string{"a"}, Frozen: true, DescriptorSetOut: "a.pb"})
+			require.NoError(t, err)
+			require.FileExists(t, filepath.Join(root, "marker"))
+			require.FileExists(t, filepath.Join(root, "a.pb"))
+		})
+	}
+}
+
+func TestFrozenGenerationWithoutPluginsValidatesEmptyModule(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, "protobuf.mod", "module example.com/empty\n")
+	writeV1GenerateFixture(t, root, "easyp.gen.yaml", "version: v1\n")
+	request := Request{WorkDir: root, WorkspaceRoot: root, Frozen: true}
+	err := Run(t.Context(), logger.NewNop(), nil, request)
+	require.ErrorContains(t, err, "protobuf.lock")
+	writeV1GenerateFixture(t, root, "protobuf.lock", "version: 1\nmodules: []\n")
+	require.NoError(t, Run(t.Context(), logger.NewNop(), nil, request))
+}
diff --git a/internal/generation/generate.go b/internal/generation/generate.go
new file mode 100644
index 00000000..b3ea9e9e
--- /dev/null
+++ b/internal/generation/generate.go
@@ -0,0 +1,279 @@
+package generation
+
+import (
+	"bytes"
+	"context"
+	"fmt"
+	"io/fs"
+	"os"
+	"path/filepath"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/core/path_helpers"
+	"github.com/easyp-tech/easyp/internal/logger"
+	"github.com/easyp-tech/easyp/internal/modules"
+	"github.com/easyp-tech/easyp/internal/workspace"
+)
+
+// Request contains the inputs of one generation run.
+type Request struct {
+	Frozen              bool
+	WorkDir             string
+	Project             string
+	Projects            []string
+	AllProjects         bool
+	WorkspaceRoot       string
+	DescriptorSetOut    string
+	DescriptorSetOutDir string
+	IncludeImports      bool
+}
+
+type generationTarget struct {
+	configPath string
+	config     v1.Generate
+	module     v1ModuleSelection
+}
+
+// Run discovers generator files, prepares selected modules, and executes each generation.
+// Missing locked dependencies are installed in the supplied cache.
+func Run(ctx context.Context, log logger.Logger, cache modules.Cache, request Request) error {
+	if request.DescriptorSetOut != "" && request.DescriptorSetOutDir != "" {
+		return fmt.Errorf("--descriptor_set_out and --descriptor_set_out_dir are mutually exclusive")
+	}
+	exportDescriptors := request.DescriptorSetOut != "" || request.DescriptorSetOutDir != ""
+	workDir, err := filepath.Abs(request.WorkDir)
+	if err != nil {
+		return fmt.Errorf("Abs: %w", err)
+	}
+	request.WorkDir = workDir
+	if request.WorkspaceRoot == "" {
+		request.WorkspaceRoot, err = workspace.Boundary(workDir)
+	} else {
+		if !filepath.IsAbs(request.WorkspaceRoot) {
+			request.WorkspaceRoot = filepath.Join(workDir, request.WorkspaceRoot)
+		}
+		request.WorkspaceRoot, err = filepath.Abs(request.WorkspaceRoot)
+	}
+	if err != nil {
+		return fmt.Errorf("Boundary: %w", err)
+	}
+	workspaceRel, err := filepath.Rel(request.WorkspaceRoot, workDir)
+	if err != nil || !filepath.IsLocal(workspaceRel) {
+		return fmt.Errorf("working directory must be inside --workspace")
+	}
+	if request.DescriptorSetOut != "" && !filepath.IsAbs(request.DescriptorSetOut) {
+		request.DescriptorSetOut = filepath.Join(workDir, request.DescriptorSetOut)
+	}
+	if request.DescriptorSetOutDir != "" && !filepath.IsAbs(request.DescriptorSetOutDir) {
+		request.DescriptorSetOutDir = filepath.Join(workDir, request.DescriptorSetOutDir)
+	}
+	configs, err := selectGenerateConfigs(request)
+	if err != nil {
+		return fmt.Errorf("discoverV1GenerateConfigs: %w", err)
+	}
+	if len(configs) == 0 {
+		return fmt.Errorf("no easyp.gen.yaml found in %s", workDir)
+	}
+
+	var descriptorTargets []generationTarget
+	for _, configPath := range configs {
+		gen, err := readV1GenerateConfig(configPath)
+		if err != nil {
+			return fmt.Errorf("readV1GenerateConfig: %w", err)
+		}
+		if err := inheritV1GenerateOptions(request.WorkspaceRoot, configPath, &gen); err != nil {
+			return fmt.Errorf("inheritV1GenerateOptions: %w", err)
+		}
+		if len(gen.Plugins) == 0 && len(gen.Generate.Packages) == 0 && !exportDescriptors && !request.Frozen {
+			continue
+		}
+		modules, err := selectV1Modules(request.WorkspaceRoot, filepath.Dir(configPath), gen.Generate.Modules)
+		if err != nil {
+			return fmt.Errorf("%s: %w", configPath, err)
+		}
+		if err := v1.ValidatePackageSelectors(gen.Generate.Packages); err != nil {
+			return fmt.Errorf("%s: %w", configPath, err)
+		}
+		for _, module := range modules {
+			descriptorTargets = append(descriptorTargets, generationTarget{configPath: configPath, config: gen, module: module})
+		}
+	}
+	if request.AllProjects {
+		selected := descriptorTargets[:0]
+		for _, target := range descriptorTargets {
+			if len(target.config.Plugins) == 0 && len(target.config.Generate.Modules) == 0 {
+				inherited, err := isOptionsOnlyParent(target.configPath, target.config, configs)
+				if err != nil {
+					return fmt.Errorf("isOptionsOnlyParent: %w", err)
+				}
+				if inherited {
+					continue
+				}
+			}
+			selected = append(selected, target)
+		}
+		descriptorTargets = selected
+	}
+	if request.Frozen {
+		checked := make(map[string]bool)
+		for _, target := range descriptorTargets {
+			// An explicit native directory owns its lock. A consumer-only
+			// generator directory need not invent another protobuf module.
+			consumer := target.module.directory
+			if consumer == "" {
+				consumer, err = generatorV1ModuleDir(request.WorkspaceRoot, filepath.Dir(target.configPath))
+				if err != nil {
+					return fmt.Errorf("generatorV1ModuleDir: %w", err)
+				}
+			}
+			if checked[consumer] {
+				continue
+			}
+			if _, err := modules.EnsureFrozenSources(ctx, consumer, cache); err != nil {
+				return fmt.Errorf("frozen project %s: %w", target.configPath, err)
+			}
+			checked[consumer] = true
+		}
+	}
+	if len(descriptorTargets) == 0 && exportDescriptors {
+		return fmt.Errorf("descriptor set has no selected modules")
+	}
+	if !exportDescriptors {
+		if len(descriptorTargets) == 0 {
+			if err := emptyGenerationSelectionError(request, configs); err != nil {
+				return err
+			}
+			return nil
+		}
+		prepared, err := prepareDescriptorTargets(ctx, log, cache, request, descriptorTargets)
+		if err != nil {
+			return fmt.Errorf("prepareDescriptorTargets: %w", err)
+		}
+		return executePreparedTargets(ctx, prepared)
+	}
+	if err := generateV1DescriptorSet(ctx, log, cache, request, descriptorTargets); err != nil {
+		return fmt.Errorf("generateV1DescriptorSet: %w", err)
+	}
+	return nil
+}
+
+func emptyGenerationSelectionError(request Request, selected []string) error {
+	if request.AllProjects || request.Project != "" || len(request.Projects) > 0 {
+		return nil
+	}
+	discovered, err := discoverV1GenerateConfigs(request.WorkDir, "")
+	if err != nil {
+		return fmt.Errorf("discoverV1GenerateConfigs: %w", err)
+	}
+	selectedPaths := make(map[string]bool, len(selected))
+	for _, path := range selected {
+		selectedPaths[filepath.Clean(path)] = true
+	}
+	additional := 0
+	for _, path := range discovered {
+		if !selectedPaths[filepath.Clean(path)] {
+			additional++
+		}
+	}
+	if additional == 0 {
+		return nil
+	}
+	return fmt.Errorf("selected easyp.gen.yaml has no executable generation targets; found %d additional easyp.gen.yaml below %s; use --all for recursive generation or --project <directory> to select a project explicitly", additional, request.WorkDir)
+}
+
+// isOptionsOnlyParent reports whether a config has child generators but no
+// declared module of its own. Explicit options-only ancestors do not acquire
+// ownership of incidental proto files elsewhere in the repository.
+func isOptionsOnlyParent(configPath string, gen v1.Generate, configs []string) (bool, error) {
+	dir := filepath.Dir(configPath)
+	childDirs := make(map[string]bool)
+	for _, other := range configs {
+		if other == configPath {
+			continue
+		}
+		childDir := filepath.Dir(other)
+		rel, err := filepath.Rel(dir, childDir)
+		if err != nil {
+			return false, err
+		}
+		if filepath.IsLocal(rel) {
+			childDirs[childDir] = true
+		}
+	}
+	if len(childDirs) == 0 {
+		return false, nil
+	}
+	if _, err := os.Stat(filepath.Join(dir, v1.ModuleFile)); err == nil {
+		return false, nil
+	} else if !os.IsNotExist(err) {
+		return false, err
+	}
+
+	// A thin options-only ancestor is not an implicit module. Unrelated proto
+	// files (for example a legacy tree) must not make it a generation target.
+	if gen.Options.Go.PackagePrefix != nil && !gen.InheritedGoPackagePrefix &&
+		!gen.Generate.Managed.Enabled && len(gen.Generate.Managed.Override) == 0 && len(gen.Generate.Managed.Disable) == 0 {
+		return true, nil
+	}
+
+	hasOwnProto := false
+	err := filepath.WalkDir(dir, func(path string, entry fs.DirEntry, walkErr error) error {
+		if walkErr != nil {
+			return walkErr
+		}
+		if entry.IsDir() {
+			if childDirs[path] || path_helpers.ShouldSkipV1SourceDir(dir, path) {
+				return filepath.SkipDir
+			}
+			return nil
+		}
+		if filepath.Ext(path) == ".proto" {
+			hasOwnProto = true
+			return filepath.SkipAll
+		}
+		return nil
+	})
+	return !hasOwnProto, err
+}
+
+func discoverV1GenerateConfigs(root, project string) ([]string, error) {
+	if project != "" {
+		if !filepath.IsAbs(project) {
+			project = filepath.Join(root, project)
+		}
+		path := filepath.Join(project, v1.GenerateFile)
+		if _, err := os.Stat(path); err != nil {
+			return nil, fmt.Errorf("find project generator %s: %w", path, err)
+		}
+		return []string{path}, nil
+	}
+	var paths []string
+	err := filepath.WalkDir(root, func(path string, entry fs.DirEntry, walkErr error) error {
+		if walkErr != nil {
+			return walkErr
+		}
+		if entry.IsDir() {
+			if workspace.SkipDirectory(root, path) {
+				return filepath.SkipDir
+			}
+			return nil
+		}
+		if entry.Name() == v1.GenerateFile {
+			paths = append(paths, path)
+		}
+		return nil
+	})
+	return paths, err
+}
+
+func readV1GenerateConfig(path string) (v1.Generate, error) {
+	raw, err := os.ReadFile(path)
+	if err != nil {
+		return v1.Generate{}, fmt.Errorf("ReadFile: %w", err)
+	}
+	gen, err := v1.ParseGenerate(bytes.NewReader(raw))
+	if err != nil {
+		return v1.Generate{}, fmt.Errorf("%s: %w", path, err)
+	}
+	return gen, nil
+}
diff --git a/internal/generation/inherit.go b/internal/generation/inherit.go
new file mode 100644
index 00000000..84bb950e
--- /dev/null
+++ b/internal/generation/inherit.go
@@ -0,0 +1,67 @@
+package generation
+
+import (
+	"bytes"
+	"errors"
+	"fmt"
+	"os"
+	"path/filepath"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// inheritV1GenerateOptions reads only options from ancestor generator files.
+// The nearest explicit value wins; generate and plugins belong to the consumer.
+func inheritV1GenerateOptions(repoRoot, configPath string, gen *v1.Generate) error {
+	configDir := filepath.Dir(configPath)
+	rel, err := filepath.Rel(repoRoot, configDir)
+	if err != nil {
+		return fmt.Errorf("Rel: %w", err)
+	}
+	if !filepath.IsLocal(rel) {
+		return fmt.Errorf("generator %s is outside repository %s", configPath, repoRoot)
+	}
+	if configDir == repoRoot {
+		return nil
+	}
+	for _, dir := range ancestorDirs(configDir, repoRoot)[1:] {
+		parentPath := filepath.Join(dir, v1.GenerateFile)
+		raw, found, err := readOptionalFile(parentPath)
+		if err != nil {
+			return fmt.Errorf("%s: %w", parentPath, err)
+		}
+		if !found {
+			continue
+		}
+		parent, err := v1.ParseGenerate(bytes.NewReader(raw))
+		if err != nil {
+			return fmt.Errorf("%s: %w", parentPath, err)
+		}
+		if gen.Options.Go.PackagePrefix == nil && parent.Options.Go.PackagePrefix != nil {
+			gen.Options.Go.PackagePrefix = parent.Options.Go.PackagePrefix
+			gen.InheritedGoPackagePrefix = true
+		}
+	}
+	return nil
+}
+
+func readOptionalFile(path string) ([]byte, bool, error) {
+	raw, err := os.ReadFile(path)
+	if errors.Is(err, os.ErrNotExist) {
+		return nil, false, nil
+	}
+	if err != nil {
+		return nil, false, fmt.Errorf("ReadFile: %w", err)
+	}
+	return raw, true, nil
+}
+
+func ancestorDirs(start, root string) []string {
+	var directories []string
+	for directory := start; ; directory = filepath.Dir(directory) {
+		directories = append(directories, directory)
+		if directory == root || directory == filepath.Dir(directory) {
+			return directories
+		}
+	}
+}
diff --git a/internal/generation/local_overlay_test.go b/internal/generation/local_overlay_test.go
new file mode 100644
index 00000000..333524ae
--- /dev/null
+++ b/internal/generation/local_overlay_test.go
@@ -0,0 +1,26 @@
+package generation
+
+import (
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/adapters/gitmodules"
+)
+
+func TestSelectedModuleUsesMainOverlay(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, "protobuf.mod", "module example.com/app\nroots proto\nrequire example.com/A\nreplace example.com/A => a\nreplace example.com/B => b\nreplace example.com/unused => missing\n")
+	writeV1GenerateFixture(t, root, "a/protobuf.mod", "module example.com/A\nrequire example.com/B\nreplace example.com/B => missing\n")
+	writeV1GenerateFixture(t, root, "b/protobuf.mod", "module example.com/B\n")
+	cache := gitmodules.New(t.TempDir())
+	selected, err := resolveV1GenerationModule(t.Context(), cache, root, root, v1ModuleSelection{source: "example.com/A"}, false)
+	require.NoError(t, err)
+	assert.Equal(t, root, selected.resolutionDir)
+	assert.Equal(t, []string{filepath.Join(root, "b")}, selected.dependencies.Paths())
+	_, err = resolveV1GenerationModule(t.Context(), cache, root, root, v1ModuleSelection{source: "example.com/unused"}, false)
+	require.ErrorContains(t, err, "not selected")
+}
diff --git a/internal/generation/managed_test.go b/internal/generation/managed_test.go
new file mode 100644
index 00000000..86ee0da9
--- /dev/null
+++ b/internal/generation/managed_test.go
@@ -0,0 +1,109 @@
+package generation
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"google.golang.org/protobuf/proto"
+	"google.golang.org/protobuf/types/descriptorpb"
+
+	"github.com/easyp-tech/easyp/internal/adapters/gitmodules"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/logger"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+func TestGenerateV1ManagedRulesMatchModuleIdentities(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name   string
+		remote bool
+	}{
+		{name: "local_replacement"},
+		{name: "locked_dependency", remote: true},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			dependency := t.TempDir()
+			cacheBase := t.TempDir()
+			cache := gitmodules.New(cacheBase)
+			source := "example.com/dep"
+			if tt.remote {
+				source = dependency
+			}
+			writeV1GenerateFixture(t, dependency, "protobuf.mod", "module "+source+"\nroots proto\n")
+			writeV1GenerateFixture(t, dependency, "proto/dep/v1/dep.proto", "syntax = \"proto3\"; package dep.v1; option go_package = \"example.com/original/dep/v1;depv1\"; message Dep {}\n")
+			manifest := fmt.Sprintf("module example.com/root\nroots proto\nrequire %s v1.0.0\n", source)
+			if tt.remote {
+				runTestGit(t, dependency, "init", "-q")
+				runTestGit(t, dependency, "add", ".")
+				runTestGit(t, dependency, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+				runTestGit(t, dependency, "tag", "v1.0.0")
+				module, err := v1.ParseModule(strings.NewReader(manifest))
+				require.NoError(t, err)
+				lock, err := modules.Resolve(t.Context(), module, gitmodules.New(cacheBase), nil)
+				require.NoError(t, err)
+				require.NoError(t, writeTestLock(root, lock))
+			} else {
+				replacement, err := filepath.Rel(root, dependency)
+				require.NoError(t, err)
+				manifest += fmt.Sprintf("replace %s => %s\n", source, replacement)
+			}
+			writeV1GenerateFixture(t, root, "protobuf.mod", manifest)
+			writeV1GenerateFixture(t, root, "proto/root/v1/root.proto", "syntax = \"proto3\"; package root.v1; import \"dep/v1/dep.proto\"; message Root { dep.v1.Dep value = 1; }\n")
+			gen, err := v1.ParseGenerate(strings.NewReader(fmt.Sprintf(`version: v1
+generate:
+  managed:
+    enabled: true
+    disable:
+      - module: %s
+    override:
+      - file_option: go_package_prefix
+        value: example.com/global
+      - module: example.com/root
+        file_option: go_package_prefix
+        value: example.com/current
+`, source)))
+			require.NoError(t, err)
+			descriptors := generateV1Descriptors(t, root, func(request Request) error {
+				return generateSelectedV1Module(t.Context(), logger.NewNop(), cache, request, filepath.Join(root, "easyp.gen.yaml"), root, v1ModuleSelection{directory: root}, gen)
+			})
+			require.Contains(t, descriptors, "dep/v1/dep.proto")
+			require.Contains(t, descriptors, "root/v1/root.proto")
+			assert.Equal(t, "example.com/original/dep/v1;depv1", descriptors["dep/v1/dep.proto"].GetOptions().GetGoPackage())
+			assert.Equal(t, "example.com/current/root/v1;rootv1", descriptors["root/v1/root.proto"].GetOptions().GetGoPackage())
+		})
+	}
+}
+
+func writeV1GenerateFixture(t *testing.T, root, name, content string) {
+	t.Helper()
+	path := filepath.Join(root, name)
+	err := os.MkdirAll(filepath.Dir(path), 0o755)
+	require.NoError(t, err)
+	err = os.WriteFile(path, []byte(content), 0o644)
+	require.NoError(t, err)
+}
+
+func generateV1Descriptors(t *testing.T, root string, generate func(Request) error) map[string]*descriptorpb.FileDescriptorProto {
+	t.Helper()
+	output := filepath.Join(root, "descriptors.pb")
+	require.NoError(t, generate(Request{DescriptorSetOut: output, IncludeImports: true}))
+	data, err := os.ReadFile(output)
+	require.NoError(t, err)
+	var set descriptorpb.FileDescriptorSet
+	require.NoError(t, proto.Unmarshal(data, &set))
+	files := make(map[string]*descriptorpb.FileDescriptorProto, len(set.File))
+	for _, file := range set.File {
+		files[file.GetName()] = file
+	}
+	return files
+}
diff --git a/internal/generation/module.go b/internal/generation/module.go
new file mode 100644
index 00000000..54bb820e
--- /dev/null
+++ b/internal/generation/module.go
@@ -0,0 +1,50 @@
+package generation
+
+import (
+	"context"
+	"fmt"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/core"
+	"github.com/easyp-tech/easyp/internal/logger"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+func generateV1ModuleWithRoots(ctx context.Context, log logger.Logger, request Request, configPath, moduleDir string, gen v1.Generate, module v1.Module, importRoots modules.SourceRoots) error {
+	app, err := prepareV1ModuleCore(log, request, configPath, moduleDir, gen, module, importRoots)
+	if err != nil {
+		return fmt.Errorf("prepareV1ModuleCore: %w", err)
+	}
+	if err := app.Generate(ctx, moduleDir, request.DescriptorSetOut, request.IncludeImports); err != nil {
+		return fmt.Errorf("Generate: %w", err)
+	}
+	return nil
+}
+
+func prepareV1ModuleCore(log logger.Logger, request Request, configPath, moduleDir string, gen v1.Generate, module v1.Module, importRoots modules.SourceRoots) (*core.Core, error) {
+	sources, err := modules.ModuleSources(moduleDir, module)
+	if err != nil {
+		return nil, fmt.Errorf("ModuleSources: %w", err)
+	}
+	allSources := append(append(modules.SourceRoots(nil), sources...), importRoots...)
+	if err := modules.CheckSourceCollisions(allSources); err != nil {
+		return nil, fmt.Errorf("CheckSourceCollisions: %w", err)
+	}
+	options, err := prepareV1GeneratorConfig(configPath, moduleDir, gen, module)
+	if err != nil {
+		return nil, fmt.Errorf("prepareV1GeneratorConfig: %w", err)
+	}
+	options.Logger = log
+	options.PluginWorkDir = request.WorkDir
+	options.ImportRoots = importRoots.Paths()
+	options.ImportFileAllowed = allSources.FileAllowed()
+	if options.ManagedModeConfig.Enabled || options.ManagedModeConfig.GoPackageOnly {
+		roots := append(modules.SourceRoots(nil), importRoots...)
+		roots = append(roots, sources...)
+		options.FileModules, err = roots.FileModules()
+		if err != nil {
+			return nil, fmt.Errorf("FileModules: %w", err)
+		}
+	}
+	return core.New(options), nil
+}
diff --git a/internal/generation/packages.go b/internal/generation/packages.go
new file mode 100644
index 00000000..42b69af9
--- /dev/null
+++ b/internal/generation/packages.go
@@ -0,0 +1,112 @@
+package generation
+
+import (
+	"bytes"
+	"context"
+	"fmt"
+	"os"
+	"path/filepath"
+	"slices"
+	"strings"
+	"text/scanner"
+
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+// selectedPackageFiles reads package declarations without compiling unrelated
+// files. Malformed selected files and required imports are rejected by the real
+// compiler later; an unrelated broken declaration is not a generation target.
+func selectedPackageFiles(ctx context.Context, selected v1GenerationModule, packages []string) ([]string, map[string]bool, error) {
+	roots, err := modules.ModuleSources(selected.directory, selected.module)
+	if err != nil {
+		return nil, nil, fmt.Errorf("ModuleSources: %w", err)
+	}
+	requested := make(map[string]bool, len(packages))
+	for _, name := range packages {
+		requested[name] = true
+	}
+	matched := make(map[string]bool)
+	seen := make(map[string]bool)
+	var files []string
+	for _, root := range roots {
+		err := root.Walk(func(path string) error {
+			if err := ctx.Err(); err != nil {
+				return fmt.Errorf("Err: %w", err)
+			}
+			raw, err := os.ReadFile(path)
+			if err != nil {
+				return fmt.Errorf("ReadFile: %w", err)
+			}
+			name := sourcePackage(raw)
+			if !requested[name] {
+				return nil
+			}
+			relative, err := filepath.Rel(root.Path, path)
+			if err != nil {
+				return fmt.Errorf("Rel: %w", err)
+			}
+			relative = filepath.ToSlash(relative)
+			matched[name] = true
+			if !seen[relative] {
+				seen[relative] = true
+				files = append(files, relative)
+			}
+			return nil
+		})
+		if err != nil {
+			return nil, nil, fmt.Errorf("WalkProtoFiles: %w", err)
+		}
+	}
+	slices.Sort(files)
+	return files, matched, nil
+}
+
+// sourcePackage lexes only top-level package declarations. Scanner tokens keep
+// strings and comments opaque, so an option containing "package" cannot select
+// a file. It intentionally does not validate unrelated message definitions.
+func sourcePackage(raw []byte) string {
+	var lex scanner.Scanner
+	lex.Init(bytes.NewReader(raw))
+	lex.Mode = scanner.ScanIdents | scanner.ScanStrings | scanner.ScanChars | scanner.ScanComments | scanner.SkipComments
+	lex.Error = func(*scanner.Scanner, string) {}
+	depth := 0
+	start := true
+	for token := lex.Scan(); token != scanner.EOF; token = lex.Scan() {
+		if depth == 0 && start && token == scanner.Ident && lex.TokenText() == "package" {
+			var parts []string
+			for {
+				if lex.Scan() != scanner.Ident {
+					return ""
+				}
+				parts = append(parts, lex.TokenText())
+				switch lex.Scan() {
+				case ';':
+					return strings.Join(parts, ".")
+				case '.':
+					continue
+				default:
+					return ""
+				}
+			}
+		}
+		switch token {
+		case '{', '(', '[':
+			depth++
+			start = false
+		case '}', ')', ']':
+			if depth > 0 {
+				depth--
+			}
+			start = depth == 0
+		case ';':
+			if depth == 0 {
+				start = true
+			}
+		default:
+			if depth == 0 {
+				start = false
+			}
+		}
+	}
+	return ""
+}
diff --git a/internal/generation/packages_test.go b/internal/generation/packages_test.go
new file mode 100644
index 00000000..7a36ff58
--- /dev/null
+++ b/internal/generation/packages_test.go
@@ -0,0 +1,39 @@
+package generation
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestSourcePackageReadsOnlyDeclaration(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct{ name, source, want string }{
+		{name: "simple", source: "syntax = \"proto3\"; package demo.v1; message M {}", want: "demo.v1"},
+		{name: "comments", source: "/*package fake;*/ syntax='proto3'; //package wrong;\npackage demo /*comment*/ . v1 ;", want: "demo.v1"},
+		{name: "string option", source: "syntax=\"proto3\"; option java_package=\"package wrong;\"; package demo.v1;", want: "demo.v1"},
+		{name: "field name", source: "message M { string package = 1; }"},
+		{name: "late declaration", source: "message M {} package demo.v1;", want: "demo.v1"},
+		{name: "broken unselected body", source: "package other.v1; message {", want: "other.v1"},
+		{name: "malformed package", source: "package demo..v1;"},
+		{name: "empty", source: ""},
+		{name: "byte order mark", source: "\ufeffpackage demo.v1;", want: "demo.v1"},
+	} {
+		t.Run(tt.name, func(t *testing.T) { t.Parallel(); assert.Equal(t, tt.want, sourcePackage([]byte(tt.source))) })
+	}
+}
+
+func TestSelectedPackageFilesRespectsBufSelection(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, "proto/selected/a.proto", "syntax = \"proto3\"; package selected.v1; message A {}")
+	writeV1GenerateFixture(t, root, "proto/excluded/b.proto", "syntax = \"proto3\"; package excluded.v1; message B {}")
+	selected := v1GenerationModule{directory: root, module: v1.Module{Name: "example.test/dep", Roots: []string{"proto"}, ProtoFilters: []v1.ProtoFileFilter{{Root: "proto", Excludes: []string{"proto/excluded"}}}}}
+	files, matched, err := selectedPackageFiles(t.Context(), selected, []string{"selected.v1", "excluded.v1"})
+	require.NoError(t, err)
+	assert.Equal(t, []string{"selected/a.proto"}, files)
+	assert.Equal(t, map[string]bool{"selected.v1": true}, matched)
+}
diff --git a/internal/generation/remote_test.go b/internal/generation/remote_test.go
new file mode 100644
index 00000000..d98e2823
--- /dev/null
+++ b/internal/generation/remote_test.go
@@ -0,0 +1,79 @@
+package generation
+
+import (
+	"context"
+	"fmt"
+	"net"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	pluginv1 "github.com/easyp-tech/service/api/easyp/generator/v1"
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"google.golang.org/grpc"
+	"google.golang.org/protobuf/proto"
+	"google.golang.org/protobuf/types/pluginpb"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+type testV1RemotePlugin struct {
+	pluginv1.UnimplementedGeneratorAPIServer
+	called chan string
+}
+
+func (s *testV1RemotePlugin) GenerateCode(_ context.Context, request *pluginv1.GenerateCodeRequest) (*pluginv1.GenerateCodeResponse, error) {
+	select {
+	case s.called <- request.GetPluginName():
+	default:
+		return nil, fmt.Errorf("unexpected repeated GenerateCode call for %q", request.GetPluginName())
+	}
+	return &pluginv1.GenerateCodeResponse{CodeGeneratorResponse: &pluginpb.CodeGeneratorResponse{
+		File: []*pluginpb.CodeGeneratorResponse_File{{Name: proto.String("remote.txt"), Content: proto.String("ok")}},
+	}}, nil
+}
+
+func TestGenerateV1SendsPinnedRemotePluginVersion(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name        string
+		version     string
+		wantRequest string
+	}{
+		{name: "release", version: "v1.2.3", wantRequest: "python:v1.2.3"},
+		{name: "prerelease", version: "v2.0.0-rc.1", wantRequest: "python:v2.0.0-rc.1"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			listener, err := net.Listen("tcp", "127.0.0.1:0")
+			require.NoError(t, err)
+			server := grpc.NewServer()
+			remote := &testV1RemotePlugin{called: make(chan string, 1)}
+			pluginv1.RegisterGeneratorAPIServer(server, remote)
+			serveErr := make(chan error, 1)
+			go func() { serveErr <- server.Serve(listener) }()
+			t.Cleanup(func() {
+				server.Stop()
+				assert.NoError(t, <-serveErr)
+			})
+
+			root := t.TempDir()
+			writeV1GenerateFixture(t, root, "item.proto", "syntax = \"proto3\";\npackage item.v1;\nmessage Item {}\n")
+			configText := fmt.Sprintf("version: v1\nplugins:\n  - remote: http://%s/python\n    version: %s\n    out: gen\n", listener.Addr(), tt.version)
+			gen, err := v1.ParseGenerate(strings.NewReader(configText))
+			require.NoError(t, err)
+			module := v1.Module{Name: "example.com/root", Roots: []string{"."}}
+
+			err = generateV1ModuleWithRoots(t.Context(), logger.NewNop(), Request{}, filepath.Join(root, "easyp.gen.yaml"), root, gen, module, nil)
+
+			require.NoError(t, err)
+			require.Len(t, remote.called, 1)
+			assert.Equal(t, tt.wantRequest, <-remote.called)
+			assert.FileExists(t, filepath.Join(root, "gen", "remote.txt"))
+		})
+	}
+}
diff --git a/internal/generation/run_test.go b/internal/generation/run_test.go
new file mode 100644
index 00000000..d53bf376
--- /dev/null
+++ b/internal/generation/run_test.go
@@ -0,0 +1,275 @@
+package generation
+
+import (
+	"os"
+	"path/filepath"
+	"runtime"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"google.golang.org/protobuf/proto"
+	"google.golang.org/protobuf/types/descriptorpb"
+
+	"github.com/easyp-tech/easyp/internal/logger"
+)
+
+func TestRunUsesExplicitWorkingDirectory(t *testing.T) {
+	t.Parallel()
+	if runtime.GOOS == "windows" {
+		t.Skip("fixture executable uses a POSIX shell")
+	}
+	tests := []struct {
+		name            string
+		absoluteOutput  bool
+		relativeWorkDir bool
+		directory       string
+	}{
+		{name: "relative descriptor output"},
+		{name: "absolute descriptor output", absoluteOutput: true},
+		{name: "working directory with spaces", directory: "project with spaces"},
+		{name: "relative working directory", relativeWorkDir: true},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := filepath.Join(t.TempDir(), tt.directory)
+			workDir := root
+			if tt.relativeWorkDir {
+				cwd, err := os.Getwd()
+				require.NoError(t, err)
+				workDir, err = filepath.Rel(cwd, root)
+				require.NoError(t, err)
+			}
+			writeV1GenerateFixture(t, root, "protobuf.mod", "module example.com/app\nroots proto\n")
+			writeV1GenerateFixture(t, root, "proto/item.proto", "syntax = \"proto3\"; package item.v1; message Item {}")
+			writeV1GenerateFixture(t, root, "easyp.gen.yaml", "version: v1\nplugins:\n  - name: ./tools/test-plugin\n    out: gen\n")
+			script := filepath.Join(root, "tools", "test-plugin")
+			require.NoError(t, os.MkdirAll(filepath.Dir(script), 0o755))
+			require.NoError(t, os.WriteFile(script, []byte("#!/bin/sh\ncat >/dev/null\npwd > plugin-workdir.txt\n"), 0o755))
+			output := "descriptor.pb"
+			if tt.absoluteOutput {
+				output = filepath.Join(root, output)
+			}
+
+			err := Run(t.Context(), logger.NewNop(), nil, Request{WorkDir: workDir, DescriptorSetOut: output})
+
+			require.NoError(t, err)
+			if !filepath.IsAbs(output) {
+				output = filepath.Join(root, output)
+			}
+			raw, err := os.ReadFile(output)
+			require.NoError(t, err)
+			var descriptors descriptorpb.FileDescriptorSet
+			require.NoError(t, proto.Unmarshal(raw, &descriptors))
+			require.Len(t, descriptors.File, 1)
+			assert.Equal(t, "item.proto", descriptors.File[0].GetName())
+			workingDirectory, err := os.ReadFile(filepath.Join(root, "plugin-workdir.txt"))
+			require.NoError(t, err)
+			resolvedRoot, err := filepath.EvalSymlinks(root)
+			require.NoError(t, err)
+			resolvedWorkDir, err := filepath.EvalSymlinks(strings.TrimSpace(string(workingDirectory)))
+			require.NoError(t, err)
+			assert.Equal(t, resolvedRoot, resolvedWorkDir)
+		})
+	}
+}
+
+func TestRunUsesExplicitPluginSources(t *testing.T) {
+	t.Parallel()
+	if runtime.GOOS == "windows" {
+		t.Skip("fixture executable uses a POSIX shell")
+	}
+
+	tests := []struct {
+		name         string
+		pluginSource string
+	}{
+		{name: "binary path", pluginSource: "path: ./tools/test-plugin"},
+		{name: "custom command", pluginSource: "command: [sh, ./tools/test-plugin]"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			writeV1GenerateFixture(t, root, "protobuf.mod", "module example.com/app\nroots proto\n")
+			writeV1GenerateFixture(t, root, "proto/item.proto", "syntax = \"proto3\"; package item.v1; message Item {}")
+			writeV1GenerateFixture(t, root, "easyp.gen.yaml", "version: v1\nplugins:\n  - "+tt.pluginSource+"\n    out: gen\n")
+			script := filepath.Join(root, "tools", "test-plugin")
+			require.NoError(t, os.MkdirAll(filepath.Dir(script), 0o755))
+			require.NoError(t, os.WriteFile(script, []byte("#!/bin/sh\ncat >/dev/null\nprintf called > plugin-called.txt\n"), 0o755))
+
+			err := Run(t.Context(), logger.NewNop(), nil, Request{WorkDir: root})
+
+			require.NoError(t, err)
+			called, err := os.ReadFile(filepath.Join(root, "plugin-called.txt"))
+			require.NoError(t, err)
+			assert.Equal(t, "called", string(called))
+		})
+	}
+}
+
+func TestRunWithoutManifest(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name      string
+		configDir string
+	}{
+		{name: "root generator"},
+		{name: "nested generator", configDir: "app"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeV1GenerateFixture(t, root, filepath.Join(tt.configDir, "easyp.gen.yaml"), "version: v1\nplugins:\n  - name: python\n    out: gen/python\n")
+			writeV1GenerateFixture(t, root, filepath.Join(tt.configDir, "proto/item.proto"), "syntax = \"proto3\"; package item.v1; message Item {}\n")
+			output := filepath.Join(root, "descriptor.pb")
+
+			err := Run(t.Context(), logger.NewNop(), nil, Request{AllProjects: true, WorkDir: root, DescriptorSetOut: output})
+
+			require.NoError(t, err)
+			raw, err := os.ReadFile(output)
+			require.NoError(t, err)
+			var descriptors descriptorpb.FileDescriptorSet
+			require.NoError(t, proto.Unmarshal(raw, &descriptors))
+			require.Len(t, descriptors.File, 1)
+			assert.Equal(t, "proto/item.proto", descriptors.File[0].GetName())
+		})
+	}
+}
+
+func TestRunCombinesMultipleDescriptorTargets(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name      string
+		files     map[string]string
+		wantFiles []string
+	}{
+		{
+			name:      "two modules in one generator",
+			wantFiles: []string{"m1.proto", "m2.proto"},
+			files: map[string]string{
+				"easyp.gen.yaml":    "version: v1\ngenerate:\n  modules: [m1, m2]\n",
+				"m1/protobuf.mod":   "module example.com/m1\nroots proto\n",
+				"m1/proto/m1.proto": "syntax = \"proto3\"; package m1.v1; message M1 {}\n",
+				"m2/protobuf.mod":   "module example.com/m2\nroots proto\n",
+				"m2/proto/m2.proto": "syntax = \"proto3\"; package m2.v1; message M2 {}\n",
+			},
+		},
+		{
+			name:      "two generator files",
+			wantFiles: []string{"root.proto", "child.proto"},
+			files: map[string]string{
+				"easyp.gen.yaml":          "version: v1\nplugins:\n  - name: python\n    out: gen/python\n",
+				"protobuf.mod":            "module example.com/root\nroots proto\n",
+				"proto/root.proto":        "syntax = \"proto3\"; package root.v1; message Root {}\n",
+				"child/easyp.gen.yaml":    "version: v1\nplugins:\n  - name: python\n    out: gen/python\n",
+				"child/protobuf.mod":      "module example.com/child\nroots proto\n",
+				"child/proto/child.proto": "syntax = \"proto3\"; package child.v1; message Child {}\n",
+			},
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			for path, contents := range tt.files {
+				writeV1GenerateFixture(t, root, path, contents)
+			}
+			output := filepath.Join(root, "all.pb")
+			require.NoError(t, os.WriteFile(output, []byte("existing descriptor"), 0o644))
+
+			err := Run(t.Context(), logger.NewNop(), nil, Request{AllProjects: true, WorkDir: root, DescriptorSetOut: output})
+
+			require.NoError(t, err)
+			contents, readErr := os.ReadFile(output)
+			require.NoError(t, readErr)
+			var descriptors descriptorpb.FileDescriptorSet
+			require.NoError(t, proto.Unmarshal(contents, &descriptors))
+			names := make([]string, 0, len(descriptors.File))
+			for _, file := range descriptors.File {
+				names = append(names, file.GetName())
+			}
+			assert.ElementsMatch(t, tt.wantFiles, names)
+		})
+	}
+}
+
+func TestRunWritesDescriptorWithoutPlugins(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name      string
+		files     map[string]string
+		wantProto string
+	}{
+		{
+			name: "sole generator has no plugins",
+			files: map[string]string{
+				"easyp.gen.yaml":  "version: v1\n",
+				"protobuf.mod":    "module example.com/app\nroots proto\n",
+				"proto/app.proto": "syntax = \"proto3\"; package app.v1; message App {}\n",
+			},
+			wantProto: "app.proto",
+		},
+		{
+			name: "parent options file does not become a descriptor target",
+			files: map[string]string{
+				"easyp.gen.yaml":          "version: v1\noptions:\n  go:\n    package_prefix: example.com/gen\n",
+				"child/easyp.gen.yaml":    "version: v1\nplugins:\n  - name: python\n    out: gen/python\n",
+				"child/protobuf.mod":      "module example.com/child\nroots proto\n",
+				"child/proto/child.proto": "syntax = \"proto3\"; package child.v1; message Child {}\n",
+			},
+			wantProto: "child.proto",
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			for path, contents := range tt.files {
+				writeV1GenerateFixture(t, root, path, contents)
+			}
+			output := filepath.Join(root, "all.pb")
+
+			err := Run(t.Context(), logger.NewNop(), nil, Request{AllProjects: true, WorkDir: root, DescriptorSetOut: output})
+
+			require.NoError(t, err)
+			contents, err := os.ReadFile(output)
+			require.NoError(t, err)
+			var descriptors descriptorpb.FileDescriptorSet
+			require.NoError(t, proto.Unmarshal(contents, &descriptors))
+			require.Len(t, descriptors.File, 1)
+			assert.Equal(t, tt.wantProto, descriptors.File[0].GetName())
+		})
+	}
+}
+
+func TestRunExplainsUnselectedChildGenerators(t *testing.T) {
+	t.Parallel()
+
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, "easyp.gen.yaml", "version: v1\noptions:\n  go:\n    package_prefix: example.com/gen\n")
+	writeV1GenerateFixture(t, root, "child/easyp.gen.yaml", "version: v1\n")
+	writeV1GenerateFixture(t, root, "child/protobuf.mod", "module example.com/child\nroots proto\n")
+	writeV1GenerateFixture(t, root, "child/proto/child.proto", "syntax = \"proto3\"; package child.v1; message Child {}\n")
+
+	err := Run(t.Context(), logger.NewNop(), nil, Request{WorkDir: root})
+
+	require.ErrorContains(t, err, "no executable generation targets")
+	require.ErrorContains(t, err, "found 1 additional easyp.gen.yaml")
+	require.ErrorContains(t, err, "--all")
+	require.ErrorContains(t, err, "--project")
+}
diff --git a/internal/generation/selected_test.go b/internal/generation/selected_test.go
new file mode 100644
index 00000000..d55888d0
--- /dev/null
+++ b/internal/generation/selected_test.go
@@ -0,0 +1,218 @@
+package generation
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/adapters/gitmodules"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/logger"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+func TestGenerateSelectedV1ModuleReadsDependencyMetadata(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name   string
+		files  map[string]string
+		locked bool
+	}{
+		{
+			name:  "buf_v2_replacement",
+			files: map[string]string{"buf.yaml": "version: v2\nmodules:\n  - path: proto\n"},
+		},
+		{
+			name:   "buf_v2_locked",
+			files:  map[string]string{"buf.yaml": "version: v2\nmodules:\n  - path: proto\n"},
+			locked: true,
+		},
+		{
+			name:  "buf_workspace_replacement",
+			files: map[string]string{"buf.work.yaml": "version: v1\ndirectories: [proto]\n"},
+		},
+		{
+			name:   "buf_workspace_locked",
+			files:  map[string]string{"buf.work.yaml": "version: v1\ndirectories: [proto]\n"},
+			locked: true,
+		},
+		{
+			name: "legacy_easyp_replacement",
+			files: map[string]string{
+				"easyp.yaml":   "generate:\n  inputs:\n    - directory:\n        path: proto\n        root: proto\n",
+				"protobuf.mod": "direct (\n)\n",
+			},
+		},
+		{
+			name: "legacy_easyp_locked",
+			files: map[string]string{
+				"easyp.yaml":   "generate:\n  inputs:\n    - directory:\n        path: proto\n        root: proto\n",
+				"protobuf.mod": "direct (\n)\n",
+			},
+			locked: true,
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			dependency := filepath.Join(root, "dependency")
+			cacheBase := t.TempDir()
+			cache := gitmodules.New(cacheBase)
+			source := "example.com/dep"
+			if tt.locked {
+				source = dependency
+			}
+			for path, content := range tt.files {
+				writeV1GenerateFixture(t, dependency, path, content)
+			}
+			writeV1GenerateFixture(t, dependency, "proto/dep/v1/dep.proto", "syntax = \"proto3\"; package dep.v1; message Dep {}\n")
+			manifest := fmt.Sprintf("module example.com/root\nrequire %s v1.0.0\n", source)
+			if tt.locked {
+				runTestGit(t, dependency, "init", "-q")
+				runTestGit(t, dependency, "add", ".")
+				runTestGit(t, dependency, "-c", "user.name=EasyP Test", "-c", "user.email=test@example.com", "commit", "-qm", "initial")
+				runTestGit(t, dependency, "tag", "v1.0.0")
+				module, err := v1.ParseModule(strings.NewReader(manifest))
+				require.NoError(t, err)
+				lock, err := modules.Resolve(t.Context(), module, gitmodules.New(cacheBase), nil)
+				require.NoError(t, err)
+				require.NoError(t, writeTestLock(root, lock))
+			} else {
+				manifest += "replace example.com/dep => ./dependency\n"
+			}
+			writeV1GenerateFixture(t, root, "protobuf.mod", manifest)
+			gen, err := v1.ParseGenerate(strings.NewReader(fmt.Sprintf(`version: v1
+generate:
+  modules: [%s]
+  managed:
+    enabled: true
+    override:
+      - module: %s
+        file_option: go_package_prefix
+        value: example.com/selected
+`, source, source)))
+			require.NoError(t, err)
+
+			descriptors := generateV1Descriptors(t, root, func(request Request) error {
+				return generateSelectedV1Module(t.Context(), logger.NewNop(), cache, request, filepath.Join(root, "easyp.gen.yaml"), root, v1ModuleSelection{source: source}, gen)
+			})
+
+			require.Contains(t, descriptors, "dep/v1/dep.proto")
+			assert.Len(t, descriptors, 1)
+			assert.Equal(t, "example.com/selected/dep/v1;depv1", descriptors["dep/v1/dep.proto"].GetOptions().GetGoPackage())
+		})
+	}
+}
+
+func TestSelectV1ModulesPrefersGeneratorSiblingThenRepositoryRoot(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name          string
+		manifests     map[string]string
+		wantDirectory string
+	}{
+		{
+			name: "sibling_manifest",
+			manifests: map[string]string{
+				"protobuf.mod":              "module example.com/root\n",
+				"projects/protobuf.mod":     "module example.com/intermediate\n",
+				"projects/app/protobuf.mod": "module example.com/app\n",
+			},
+			wantDirectory: "projects/app",
+		},
+		{
+			name: "nearest_intermediate_manifest",
+			manifests: map[string]string{
+				"protobuf.mod":          "module example.com/root\n",
+				"projects/protobuf.mod": "module example.com/intermediate\n",
+			},
+			wantDirectory: "projects",
+		},
+		{
+			name:          "intermediate_without_root_manifest",
+			manifests:     map[string]string{"projects/protobuf.mod": "module example.com/intermediate\n"},
+			wantDirectory: "projects",
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			configDir := filepath.Join(root, "projects", "app")
+			for path, content := range tt.manifests {
+				writeV1GenerateFixture(t, root, path, content)
+			}
+
+			modules, err := selectV1Modules(root, configDir, nil)
+
+			require.NoError(t, err)
+			assert.Equal(t, []v1ModuleSelection{{directory: filepath.Join(root, tt.wantDirectory)}}, modules)
+		})
+	}
+}
+
+func TestGenerateSelectedV1ModuleUsesGeneratorSiblingRequirements(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name            string
+		rootManifest    string
+		siblingManifest string
+	}{
+		{
+			name:            "sibling_replacement_over_root_replacement",
+			rootManifest:    "module example.com/root\nrequire example.com/dep v1.0.0\nreplace example.com/dep => ./missing\n",
+			siblingManifest: "module example.com/app\nrequire example.com/dep v1.0.0\nreplace example.com/dep => ./dependency\n",
+		},
+		{
+			name:            "sibling_dependency_absent_from_root",
+			rootManifest:    "module example.com/root\n",
+			siblingManifest: "module example.com/app\nrequire example.com/dep v1.0.0\nreplace example.com/dep => ./dependency\n",
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			cache := gitmodules.New(t.TempDir())
+			configDir := filepath.Join(root, "app")
+			dependency := filepath.Join(configDir, "dependency")
+			writeV1GenerateFixture(t, root, "protobuf.mod", tt.rootManifest)
+			writeV1GenerateFixture(t, configDir, "protobuf.mod", tt.siblingManifest)
+			writeV1GenerateFixture(t, dependency, "buf.yaml", "version: v2\nmodules:\n  - path: proto\n")
+			writeV1GenerateFixture(t, dependency, "proto/dep/v1/dep.proto", "syntax = \"proto3\"; package dep.v1; message Dep {}\n")
+			gen, err := v1.ParseGenerate(strings.NewReader("version: v1\ngenerate:\n  modules: [example.com/dep]\n"))
+			require.NoError(t, err)
+
+			descriptors := generateV1Descriptors(t, root, func(request Request) error {
+				return generateSelectedV1Module(t.Context(), logger.NewNop(), cache, request, filepath.Join(configDir, "easyp.gen.yaml"), root, v1ModuleSelection{source: "example.com/dep"}, gen)
+			})
+
+			assert.Contains(t, descriptors, "dep/v1/dep.proto")
+		})
+	}
+}
+
+func TestSelectV1ModulesExplainsMissingLocalModule(t *testing.T) {
+	t.Parallel()
+
+	root := t.TempDir()
+	configDir := filepath.Join(root, "backend")
+	require.NoError(t, os.MkdirAll(configDir, 0o755))
+
+	_, err := selectV1Modules(root, configDir, []string{"."})
+
+	require.ErrorContains(t, err, "generate.modules entry \".\" is a local path")
+	require.ErrorContains(t, err, "protobuf.mod")
+	require.ErrorContains(t, err, "omit generate.modules")
+}
diff --git a/internal/generation/selection.go b/internal/generation/selection.go
new file mode 100644
index 00000000..0027e858
--- /dev/null
+++ b/internal/generation/selection.go
@@ -0,0 +1,231 @@
+package generation
+
+import (
+	"bytes"
+	"context"
+	"errors"
+	"fmt"
+	"io/fs"
+	"os"
+	"path/filepath"
+	"strings"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/logger"
+	"github.com/easyp-tech/easyp/internal/modules"
+	"github.com/easyp-tech/easyp/internal/workspace"
+)
+
+// v1ModuleSelection distinguishes workspace directories from module identities.
+// Absolute module identities can refer to a local Git repository.
+type v1ModuleSelection struct {
+	directory string
+	source    string
+}
+
+func selectV1Modules(repoRoot, configDir string, names []string) ([]v1ModuleSelection, error) {
+	if len(names) == 0 {
+		dir, err := generatorV1ModuleDir(repoRoot, configDir)
+		if err != nil {
+			return nil, fmt.Errorf("generatorV1ModuleDir: %w", err)
+		}
+		return []v1ModuleSelection{{directory: dir}}, nil
+	}
+	result := make([]v1ModuleSelection, 0, len(names))
+	for _, name := range names {
+		if filepath.IsAbs(name) {
+			result = append(result, v1ModuleSelection{source: name})
+			continue
+		}
+		path := filepath.Clean(filepath.Join(repoRoot, name))
+		rel, err := filepath.Rel(repoRoot, path)
+		if err != nil {
+			return nil, fmt.Errorf("Rel: %w", err)
+		}
+		if !filepath.IsLocal(rel) {
+			return nil, fmt.Errorf("module path %q leaves repository", name)
+		}
+		_, err = os.Stat(filepath.Join(path, v1.ModuleFile))
+		if errors.Is(err, os.ErrNotExist) {
+			if name == "." || name == ".." || strings.HasPrefix(name, "./") || strings.HasPrefix(name, "../") {
+				return nil, fmt.Errorf("generate.modules entry %q is a local path, but %s has no %s; point to a workspace module directory containing %s, use its module identity, or omit generate.modules to select the module containing this generator", name, path, v1.ModuleFile, v1.ModuleFile)
+			}
+			result = append(result, v1ModuleSelection{source: name})
+			continue
+		}
+		if err != nil {
+			return nil, fmt.Errorf("Stat: %w", err)
+		}
+		result = append(result, v1ModuleSelection{directory: path})
+	}
+	return result, nil
+}
+
+func generatorV1ModuleDir(repoRoot, configDir string) (string, error) {
+	// Explicit projects outside the workspace keep their own local context.
+	relative, err := filepath.Rel(repoRoot, configDir)
+	if err != nil {
+		return "", err
+	}
+	if !filepath.IsLocal(relative) {
+		return configDir, nil
+	}
+	path, err := workspace.FindUp(configDir, repoRoot, v1.ModuleFile)
+	if err != nil {
+		return "", err
+	}
+	if path != "" {
+		return filepath.Dir(path), nil
+	}
+	return configDir, nil
+}
+
+type v1GenerationModule struct {
+	resolutionDir string
+	directory     string
+	module        v1.Module
+	dependencies  modules.SourceRoots
+}
+
+func generateSelectedV1Module(ctx context.Context, log logger.Logger, cache modules.Cache, request Request, configPath, repoRoot string, selection v1ModuleSelection, gen v1.Generate) error {
+	selected, err := resolveV1GenerationModule(ctx, cache, repoRoot, filepath.Dir(configPath), selection, request.Frozen)
+	if err != nil {
+		return fmt.Errorf("resolveV1GenerationModule: %w", err)
+	}
+	return generateV1ModuleWithRoots(ctx, log, request, configPath, selected.directory, gen, selected.module, selected.dependencies)
+}
+
+func resolveV1GenerationModule(ctx context.Context, cache modules.Cache, repoRoot, configDir string, selection v1ModuleSelection, frozen bool) (v1GenerationModule, error) {
+	if frozen {
+		return resolveFrozenGenerationModule(ctx, cache, repoRoot, configDir, selection)
+	}
+	if selection.directory != "" {
+		return readV1GenerationModule(ctx, cache, selection.directory)
+	}
+	localDir, err := findV1LocalModuleByName(repoRoot, selection.source)
+	if err != nil {
+		return v1GenerationModule{}, fmt.Errorf("findV1LocalModuleByName: %w", err)
+	}
+	consumerDir, err := generatorV1ModuleDir(repoRoot, configDir)
+	if err != nil {
+		return v1GenerationModule{}, fmt.Errorf("generatorV1ModuleDir: %w", err)
+	}
+	_, consumer, err := modules.ReadManifest(consumerDir)
+	if err != nil {
+		if localDir != "" {
+			return readV1GenerationModule(ctx, cache, localDir)
+		}
+		return v1GenerationModule{}, fmt.Errorf("ReadManifest: %w", err)
+	}
+	if consumer.Name == selection.source {
+		return readV1GenerationModule(ctx, cache, consumerDir)
+	}
+
+	if len(consumer.Replaces) > 0 {
+		graph, err := modules.EnsureEffectiveGraph(ctx, consumerDir, consumer, cache, nil)
+		if err != nil {
+			return v1GenerationModule{}, fmt.Errorf("EnsureEffectiveGraph: %w", err)
+		}
+		if selected, ok := graph.Modules[selection.source]; ok {
+			var others modules.SourceRoots
+			for _, root := range graph.Sources {
+				if root.Module != selection.source {
+					others = append(others, root)
+				}
+			}
+			return v1GenerationModule{directory: selected.Directory, resolutionDir: consumerDir, module: selected.Module, dependencies: others}, nil
+		}
+		for _, replacement := range consumer.Replaces {
+			if replacement.Module == selection.source {
+				return v1GenerationModule{}, fmt.Errorf("module %q is not selected in the effective graph", selection.source)
+			}
+		}
+		if localDir == "" {
+			return v1GenerationModule{}, fmt.Errorf("module %q is not selected in the effective graph", selection.source)
+		}
+	}
+	if localDir != "" {
+		return readV1GenerationModule(ctx, cache, localDir)
+	}
+
+	var moduleDir string
+	var module v1.Module
+	var dependencyRoots modules.SourceRoots
+	dependencyRoots, err = modules.EnsureLockedSources(ctx, consumerDir, consumer, cache)
+	if err != nil {
+		return v1GenerationModule{}, fmt.Errorf("EnsureLockedSources: %w", err)
+	}
+	lock, err := modules.ReadLock(filepath.Join(consumerDir, v1.LockFile))
+	if err != nil {
+		return v1GenerationModule{}, fmt.Errorf("ReadLock: %w", err)
+	}
+	for _, entry := range lock.Modules {
+		if entry.Source == selection.source {
+			moduleDir, module, err = cache.Cached(entry)
+			if err != nil {
+				return v1GenerationModule{}, fmt.Errorf("Cached: %w", err)
+			}
+			break
+		}
+	}
+	if moduleDir == "" {
+		return v1GenerationModule{}, fmt.Errorf("module %q is not selected in %s", selection.source, filepath.Join(consumerDir, v1.LockFile))
+	}
+
+	otherRoots := make(modules.SourceRoots, 0, len(dependencyRoots))
+	for _, root := range dependencyRoots {
+		if root.Module != selection.source {
+			otherRoots = append(otherRoots, root)
+		}
+	}
+	return v1GenerationModule{directory: moduleDir, resolutionDir: consumerDir, module: module, dependencies: otherRoots}, nil
+}
+
+func readV1GenerationModule(ctx context.Context, cache modules.Cache, directory string) (v1GenerationModule, error) {
+	module, err := modules.ReadModuleOrDefault(directory)
+	if err != nil {
+		return v1GenerationModule{}, fmt.Errorf("ReadModuleOrDefault: %w", err)
+	}
+	dependencies, err := modules.EnsureSources(ctx, directory, module, cache)
+	if err != nil {
+		return v1GenerationModule{}, fmt.Errorf("EnsureSources: %w", err)
+	}
+	return v1GenerationModule{directory: directory, resolutionDir: directory, module: module, dependencies: dependencies}, nil
+}
+
+func findV1LocalModuleByName(repoRoot, name string) (string, error) {
+	var found string
+	err := filepath.WalkDir(repoRoot, func(path string, entry fs.DirEntry, walkErr error) error {
+		if walkErr != nil {
+			return walkErr
+		}
+		if entry.IsDir() {
+			if workspace.SkipDirectory(repoRoot, path) {
+				return filepath.SkipDir
+			}
+			return nil
+		}
+		if entry.Name() != v1.ModuleFile {
+			return nil
+		}
+		manifest, err := os.ReadFile(path)
+		if err != nil {
+			return fmt.Errorf("ReadFile: %w", err)
+		}
+		if !v1.IsModuleManifest(manifest) {
+			return nil
+		}
+		module, parseErr := v1.ParseModule(bytes.NewReader(manifest))
+		if parseErr != nil {
+			return fmt.Errorf("%s: %w", path, parseErr)
+		}
+		if module.Name == name {
+			if found != "" {
+				return fmt.Errorf("module identity %q is declared in both %s and %s", name, found, filepath.Dir(path))
+			}
+			found = filepath.Dir(path)
+		}
+		return nil
+	})
+	return found, err
+}
diff --git a/internal/migration/apply.go b/internal/migration/apply.go
new file mode 100644
index 00000000..23e5c678
--- /dev/null
+++ b/internal/migration/apply.go
@@ -0,0 +1,474 @@
+package migration
+
+import (
+	"crypto/rand"
+	"crypto/sha256"
+	"errors"
+	"fmt"
+	"io"
+	"maps"
+	"os"
+	"path/filepath"
+	"slices"
+	"strings"
+)
+
+type snapshot struct {
+	name   string
+	data   []byte
+	mode   os.FileMode
+	exists bool
+	info   os.FileInfo
+}
+
+type fileChange struct {
+	name    string
+	content []byte
+	mode    os.FileMode
+}
+
+// transaction stages every output and rollback copy before modifying destinations.
+// Ordinary write failures restore the previous contents and modes. This is not a
+// crash-atomic multi-file commit: process termination or machine failure can leave
+// a partially applied migration. Rechecks detect changes visible before a write,
+// but cannot exclude noncooperating writers between the final check and rename.
+// Root-relative operations contain writes even if a path is concurrently moved.
+type transaction struct {
+	root          string
+	expected      map[string]snapshot
+	changes       []fileChange
+	requestedRoot string
+	rootInfo      os.FileInfo
+	beforeApply   func() error
+	rename        func(*os.Root, string, string) error
+	link          func(*os.Root, string, string) error
+	stage         func(*os.Root, string, []byte, os.FileMode) error
+}
+
+type stagedChange struct {
+	change    fileChange
+	output    string
+	rollback  string
+	installed snapshot
+}
+
+func newTransaction(root string) (*transaction, error) {
+	abs, err := filepath.Abs(root)
+	if err != nil {
+		return nil, fmt.Errorf("Abs: %w", err)
+	}
+	info, err := os.Lstat(abs)
+	if err != nil {
+		return nil, fmt.Errorf("Lstat: %w", err)
+	}
+	if !info.IsDir() || info.Mode()&os.ModeSymlink != 0 {
+		return nil, fmt.Errorf("migration root %q must be a directory, not a symlink", abs)
+	}
+	canonical, err := filepath.EvalSymlinks(abs)
+	if err != nil {
+		return nil, fmt.Errorf("EvalSymlinks: %w", err)
+	}
+	tx := &transaction{
+		root:          canonical,
+		requestedRoot: abs,
+		rootInfo:      info,
+		expected:      make(map[string]snapshot),
+		rename:        func(root *os.Root, oldName, newName string) error { return root.Rename(oldName, newName) },
+		link:          func(root *os.Root, oldName, newName string) error { return root.Link(oldName, newName) },
+		stage:         stageFile,
+	}
+	err = tx.checkRoot()
+	if err != nil {
+		return nil, fmt.Errorf("checkRoot: %w", err)
+	}
+	return tx, nil
+}
+
+func (t *transaction) checkRoot() error {
+	info, err := os.Lstat(t.requestedRoot)
+	if err != nil {
+		return fmt.Errorf("Lstat: %w", err)
+	}
+	if !info.IsDir() || !os.SameFile(t.rootInfo, info) || t.rootInfo.Mode() != info.Mode() {
+		return fmt.Errorf("migration root %q changed since planning", t.requestedRoot)
+	}
+	canonical, err := filepath.EvalSymlinks(t.requestedRoot)
+	if err != nil {
+		return fmt.Errorf("EvalSymlinks: %w", err)
+	}
+	if canonical != t.root {
+		return fmt.Errorf("migration root %q resolves differently since planning", t.requestedRoot)
+	}
+	info, err = os.Lstat(t.root)
+	if err != nil {
+		return fmt.Errorf("Lstat: %w", err)
+	}
+	if !info.IsDir() || !os.SameFile(t.rootInfo, info) {
+		return fmt.Errorf("migration root %q changed since planning", t.root)
+	}
+	return nil
+}
+
+func (t *transaction) openRoot() (_ *os.Root, resultErr error) {
+	err := t.checkRoot()
+	if err != nil {
+		return nil, fmt.Errorf("checkRoot: %w", err)
+	}
+	root, err := os.OpenRoot(t.root)
+	if err != nil {
+		return nil, fmt.Errorf("OpenRoot: %w", err)
+	}
+	defer func() {
+		if resultErr != nil {
+			resultErr = errors.Join(resultErr, closeRoot(root))
+		}
+	}()
+	info, err := root.Stat(".")
+	if err != nil {
+		return nil, fmt.Errorf("Stat: %w", err)
+	}
+	if !os.SameFile(t.rootInfo, info) {
+		return nil, fmt.Errorf("migration root %q changed while opening", t.root)
+	}
+	return root, nil
+}
+
+func (t *transaction) capture(name string) (_ snapshot, resultErr error) {
+	root, err := t.openRoot()
+	if err != nil {
+		return snapshot{}, fmt.Errorf("openRoot: %w", err)
+	}
+	defer func() { resultErr = errors.Join(resultErr, closeRoot(root)) }()
+	current, err := readSnapshot(root, name)
+	if err != nil {
+		return snapshot{}, fmt.Errorf("readSnapshot: %w", err)
+	}
+	if previous, ok := t.expected[name]; ok {
+		if !sameSnapshot(previous, current) {
+			return snapshot{}, fmt.Errorf("file %q changed since planning", name)
+		}
+		return previous, nil
+	}
+	t.expected[name] = current
+	return current, nil
+}
+
+func readSnapshot(root *os.Root, name string) (_ snapshot, resultErr error) {
+	err := checkRelativeName(name)
+	if err != nil {
+		return snapshot{}, fmt.Errorf("checkRelativeName: %w", err)
+	}
+	err = checkParents(root, name)
+	if err != nil {
+		return snapshot{}, fmt.Errorf("checkParents: %w", err)
+	}
+	info, err := root.Lstat(name)
+	if errors.Is(err, os.ErrNotExist) {
+		return snapshot{name: name}, nil
+	}
+	if err != nil {
+		return snapshot{}, fmt.Errorf("Lstat: %w", err)
+	}
+	if !info.Mode().IsRegular() {
+		return snapshot{}, fmt.Errorf("file %q must be a regular file, not a symlink or directory", name)
+	}
+	file, err := root.Open(name)
+	if err != nil {
+		return snapshot{}, fmt.Errorf("Open: %w", err)
+	}
+	defer func() {
+		err := file.Close()
+		if err != nil {
+			resultErr = errors.Join(resultErr, fmt.Errorf("Close: %w", err))
+		}
+	}()
+	opened, err := file.Stat()
+	if err != nil {
+		return snapshot{}, fmt.Errorf("Stat: %w", err)
+	}
+	if !sameFileState(info, opened) {
+		return snapshot{}, fmt.Errorf("file %q changed while opening", name)
+	}
+	data, err := io.ReadAll(file)
+	if err != nil {
+		return snapshot{}, fmt.Errorf("ReadAll: %w", err)
+	}
+	after, err := root.Lstat(name)
+	if err != nil {
+		return snapshot{}, fmt.Errorf("Lstat: %w", err)
+	}
+	if !sameFileState(info, after) || int64(len(data)) != after.Size() {
+		return snapshot{}, fmt.Errorf("file %q changed while reading", name)
+	}
+	err = checkParents(root, name)
+	if err != nil {
+		return snapshot{}, fmt.Errorf("checkParents: %w", err)
+	}
+	return snapshot{name: name, data: data, mode: info.Mode(), exists: true, info: info}, nil
+}
+
+func sameFileState(before, after os.FileInfo) bool {
+	return os.SameFile(before, after) && before.Mode() == after.Mode() &&
+		before.Size() == after.Size() && before.ModTime().Equal(after.ModTime())
+}
+
+func sameSnapshot(before, after snapshot) bool {
+	if before.exists != after.exists {
+		return false
+	}
+	return !before.exists || (os.SameFile(before.info, after.info) && before.mode == after.mode &&
+		sha256.Sum256(before.data) == sha256.Sum256(after.data))
+}
+
+func checkRelativeName(name string) error {
+	if !filepath.IsLocal(name) || name == "." || filepath.Clean(name) != name || strings.Contains(name, "\\") {
+		return fmt.Errorf("unsafe relative file name %q", name)
+	}
+	return nil
+}
+
+func checkParents(root *os.Root, name string) error {
+	parent := filepath.Dir(name)
+	if parent == "." {
+		return nil
+	}
+	current := ""
+	for _, component := range strings.Split(parent, string(filepath.Separator)) {
+		current = filepath.Join(current, component)
+		info, err := root.Lstat(current)
+		if err != nil {
+			return fmt.Errorf("Lstat: %w", err)
+		}
+		if !info.IsDir() || info.Mode()&os.ModeSymlink != 0 {
+			return fmt.Errorf("parent %q must be a directory, not a symlink", current)
+		}
+	}
+	return nil
+}
+
+func (t *transaction) verify(root *os.Root) error {
+	err := t.checkRoot()
+	if err != nil {
+		return fmt.Errorf("checkRoot: %w", err)
+	}
+	for _, name := range slices.Sorted(maps.Keys(t.expected)) {
+		err = recheckSnapshot(root, t.expected[name])
+		if err != nil {
+			return fmt.Errorf("recheckSnapshot: %w", err)
+		}
+	}
+	return nil
+}
+
+func recheckSnapshot(root *os.Root, expected snapshot) error {
+	current, err := readSnapshot(root, expected.name)
+	if err != nil {
+		return fmt.Errorf("readSnapshot: %w", err)
+	}
+	if !sameSnapshot(expected, current) {
+		return fmt.Errorf("file %q changed since planning", expected.name)
+	}
+	return nil
+}
+
+func (t *transaction) apply() (resultErr error) {
+	root, err := t.openRoot()
+	if err != nil {
+		return fmt.Errorf("openRoot: %w", err)
+	}
+	defer func() { resultErr = errors.Join(resultErr, closeRoot(root)) }()
+	err = t.validateChanges()
+	if err != nil {
+		return fmt.Errorf("validateChanges: %w", err)
+	}
+	err = t.verify(root)
+	if err != nil {
+		return fmt.Errorf("verify: %w", err)
+	}
+	if len(t.changes) == 0 {
+		return nil
+	}
+	temporary := ".easyp-migrate-" + rand.Text()
+	err = root.Mkdir(temporary, 0o700)
+	if err != nil {
+		return fmt.Errorf("Mkdir: %w", err)
+	}
+	keepTemporary := false
+	defer func() {
+		if keepTemporary {
+			return
+		}
+		err := root.RemoveAll(temporary)
+		if err != nil {
+			resultErr = errors.Join(resultErr, fmt.Errorf("RemoveAll: %w", err))
+		}
+	}()
+	staged, err := t.stageChanges(root, temporary)
+	if err != nil {
+		return fmt.Errorf("stageChanges: %w", err)
+	}
+	if t.beforeApply != nil {
+		err = t.beforeApply()
+		if err != nil {
+			return fmt.Errorf("beforeApply: %w", err)
+		}
+	}
+	// Recheck every source and destination after potentially slow staging, before
+	// making any externally visible change.
+	err = t.verify(root)
+	if err != nil {
+		return fmt.Errorf("verify: %w", err)
+	}
+	for index, item := range staged {
+		err = t.install(root, item)
+		if err == nil {
+			continue
+		}
+		rollbackErr := t.rollback(root, staged[:index])
+		if rollbackErr != nil {
+			// Keep recovery copies if the filesystem also refuses rollback.
+			keepTemporary = true
+			rollbackErr = fmt.Errorf("rollback: %w; recovery copies remain in %q", rollbackErr, filepath.Join(t.root, temporary))
+		}
+		return errors.Join(fmt.Errorf("install: %w", err), rollbackErr)
+	}
+	return nil
+}
+
+func (t *transaction) validateChanges() error {
+	seen := make(map[string]bool)
+	for _, change := range t.changes {
+		err := checkRelativeName(change.name)
+		if err != nil {
+			return fmt.Errorf("checkRelativeName: %w", err)
+		}
+		if filepath.Dir(change.name) != "." {
+			return fmt.Errorf("destination %q must be directly inside the migration root", change.name)
+		}
+		if _, ok := t.expected[change.name]; !ok {
+			return fmt.Errorf("destination %q was not captured during planning", change.name)
+		}
+		if seen[change.name] {
+			return fmt.Errorf("duplicate destination %q", change.name)
+		}
+		seen[change.name] = true
+		if !change.mode.IsRegular() {
+			return fmt.Errorf("destination %q has a nonregular file mode", change.name)
+		}
+	}
+	return nil
+}
+
+func (t *transaction) stageChanges(root *os.Root, temporary string) ([]stagedChange, error) {
+	staged := make([]stagedChange, 0, len(t.changes))
+	for index, change := range t.changes {
+		item := stagedChange{
+			change:   change,
+			output:   filepath.Join(temporary, fmt.Sprintf("output-%d", index)),
+			rollback: filepath.Join(temporary, fmt.Sprintf("original-%d", index)),
+		}
+		err := t.stage(root, item.output, change.content, change.mode)
+		if err != nil {
+			return nil, fmt.Errorf("stage: %w", err)
+		}
+		info, err := root.Lstat(item.output)
+		if err != nil {
+			return nil, fmt.Errorf("Lstat: %w", err)
+		}
+		item.installed = snapshot{name: change.name, data: change.content, mode: change.mode, exists: true, info: info}
+		before := t.expected[change.name]
+		if before.exists {
+			err = t.stage(root, item.rollback, before.data, before.mode)
+			if err != nil {
+				return nil, fmt.Errorf("stage: %w", err)
+			}
+		}
+		staged = append(staged, item)
+	}
+	return staged, nil
+}
+
+func (t *transaction) install(root *os.Root, item stagedChange) error {
+	err := t.checkRoot()
+	if err != nil {
+		return fmt.Errorf("checkRoot: %w", err)
+	}
+	before := t.expected[item.change.name]
+	err = recheckSnapshot(root, before)
+	if err != nil {
+		return fmt.Errorf("recheckSnapshot: %w", err)
+	}
+	if before.exists {
+		err = t.rename(root, item.output, item.change.name)
+		if err != nil {
+			return fmt.Errorf("rename: %w", err)
+		}
+		return nil
+	}
+	// Link atomically refuses an existing destination, including dangling links.
+	// The staging link is removed with the temporary directory after completion.
+	err = t.link(root, item.output, item.change.name)
+	if err != nil {
+		return fmt.Errorf("link: %w", err)
+	}
+	return nil
+}
+
+func (t *transaction) rollback(root *os.Root, applied []stagedChange) error {
+	var failures []error
+	for index := len(applied) - 1; index >= 0; index-- {
+		item := applied[index]
+		err := recheckSnapshot(root, item.installed)
+		if err != nil {
+			failures = append(failures, fmt.Errorf("recheckSnapshot: %w", err))
+			continue
+		}
+		if t.expected[item.change.name].exists {
+			err = t.rename(root, item.rollback, item.change.name)
+			if err != nil {
+				failures = append(failures, fmt.Errorf("rename: %w", err))
+			}
+			continue
+		}
+		err = root.Remove(item.change.name)
+		if err != nil {
+			failures = append(failures, fmt.Errorf("Remove: %w", err))
+		}
+	}
+	return errors.Join(failures...)
+}
+
+func stageFile(root *os.Root, name string, data []byte, mode os.FileMode) (resultErr error) {
+	file, err := root.OpenFile(name, os.O_WRONLY|os.O_CREATE|os.O_EXCL, 0o600)
+	if err != nil {
+		return fmt.Errorf("OpenFile: %w", err)
+	}
+	defer func() {
+		err := file.Close()
+		if err != nil {
+			resultErr = errors.Join(resultErr, fmt.Errorf("Close: %w", err))
+		}
+	}()
+	_, err = file.Write(data)
+	if err != nil {
+		return fmt.Errorf("Write: %w", err)
+	}
+	// Chmod restores exact permissions independently of the process umask.
+	err = file.Chmod(mode)
+	if err != nil {
+		return fmt.Errorf("Chmod: %w", err)
+	}
+	err = file.Sync()
+	if err != nil {
+		return fmt.Errorf("Sync: %w", err)
+	}
+	return nil
+}
+
+func closeRoot(root *os.Root) error {
+	err := root.Close()
+	if err != nil {
+		return fmt.Errorf("Close: %w", err)
+	}
+	return nil
+}
diff --git a/internal/migration/apply_test.go b/internal/migration/apply_test.go
new file mode 100644
index 00000000..33ba2b79
--- /dev/null
+++ b/internal/migration/apply_test.go
@@ -0,0 +1,524 @@
+package migration
+
+import (
+	"errors"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func Test_transaction_apply(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name string
+		mode os.FileMode
+	}{
+		{name: "private", mode: 0o600},
+		{name: "group_readable", mode: 0o640},
+		{name: "read_only", mode: 0o444},
+		{name: "executable", mode: 0o751},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeTransactionFile(t, root, "easyp.yaml", "original", tt.mode)
+			writeTransactionFile(t, root, "untouched.bak", "older backup", 0o600)
+			tx, err := newTransaction(root)
+			require.NoError(t, err)
+			for _, name := range []string{"easyp.yaml", "easyp.yaml.bak", "easyp.gen.yaml", "untouched.bak"} {
+				_, err = tx.capture(name)
+				require.NoError(t, err)
+			}
+			tx.changes = []fileChange{
+				{name: "easyp.yaml.bak", content: []byte("original"), mode: tt.mode},
+				{name: "easyp.gen.yaml", content: []byte("generated"), mode: tt.mode},
+				{name: "easyp.yaml", content: []byte("migrated"), mode: tt.mode},
+			}
+
+			require.NoError(t, tx.apply())
+			assertTransactionFile(t, root, "easyp.yaml", "migrated", tt.mode)
+			assertTransactionFile(t, root, "easyp.yaml.bak", "original", tt.mode)
+			assertTransactionFile(t, root, "easyp.gen.yaml", "generated", tt.mode)
+			assertTransactionFile(t, root, "untouched.bak", "older backup", 0o600)
+			assertNoTransactionTemporary(t, root)
+		})
+	}
+}
+
+func Test_transaction_rejectsChangesBeforeWriting(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name   string
+		mutate func(*testing.T, string)
+	}{
+		{
+			name: "source_content",
+			mutate: func(t *testing.T, root string) {
+				writeTransactionFile(t, root, "input.proto", "changed proto", 0o644)
+			},
+		},
+		{
+			name: "source_mode",
+			mutate: func(t *testing.T, root string) {
+				require.NoError(t, os.Chmod(filepath.Join(root, "input.proto"), 0o600))
+			},
+		},
+		{
+			name: "source_inode",
+			mutate: func(t *testing.T, root string) {
+				writeTransactionFile(t, root, "replacement", "proto", 0o644)
+				require.NoError(t, os.Rename(filepath.Join(root, "replacement"), filepath.Join(root, "input.proto")))
+			},
+		},
+		{
+			name: "destination_appeared",
+			mutate: func(t *testing.T, root string) {
+				writeTransactionFile(t, root, "easyp.gen.yaml", "someone else's output", 0o644)
+			},
+		},
+		{
+			name: "destination_symlink",
+			mutate: func(t *testing.T, root string) {
+				require.NoError(t, os.Symlink("input.proto", filepath.Join(root, "easyp.gen.yaml")))
+			},
+		},
+		{
+			name: "replacement_content",
+			mutate: func(t *testing.T, root string) {
+				writeTransactionFile(t, root, "easyp.yaml", "edited original", 0o640)
+			},
+		},
+		{
+			name: "replacement_mode",
+			mutate: func(t *testing.T, root string) {
+				require.NoError(t, os.Chmod(filepath.Join(root, "easyp.yaml"), 0o600))
+			},
+		},
+		{
+			name: "backup_appeared",
+			mutate: func(t *testing.T, root string) {
+				writeTransactionFile(t, root, "easyp.yaml.bak", "unrelated backup", 0o600)
+			},
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeTransactionFile(t, root, "easyp.yaml", "original", 0o640)
+			writeTransactionFile(t, root, "input.proto", "proto", 0o644)
+			tx, err := newTransaction(root)
+			require.NoError(t, err)
+			for _, name := range []string{"input.proto", "easyp.yaml", "easyp.yaml.bak", "easyp.gen.yaml"} {
+				_, err = tx.capture(name)
+				require.NoError(t, err)
+			}
+			tx.changes = []fileChange{
+				{name: "easyp.yaml.bak", content: []byte("original"), mode: 0o640},
+				{name: "easyp.gen.yaml", content: []byte("generated"), mode: 0o644},
+				{name: "easyp.yaml", content: []byte("migrated"), mode: 0o640},
+			}
+			tt.mutate(t, root)
+			before, err := os.ReadFile(filepath.Join(root, "easyp.yaml"))
+			require.NoError(t, err)
+
+			require.Error(t, tx.apply())
+			after, err := os.ReadFile(filepath.Join(root, "easyp.yaml"))
+			require.NoError(t, err)
+			assert.Equal(t, before, after)
+			if tt.name == "backup_appeared" {
+				assertTransactionFile(t, root, "easyp.yaml.bak", "unrelated backup", 0o600)
+			} else {
+				_, err = os.Lstat(filepath.Join(root, "easyp.yaml.bak"))
+				require.ErrorIs(t, err, os.ErrNotExist)
+			}
+			assertNoTransactionTemporary(t, root)
+		})
+	}
+}
+
+func Test_transaction_rollsBackFailures(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name  string
+		setup func(*transaction, error)
+	}{
+		{
+			name: "staging",
+			setup: func(tx *transaction, failure error) {
+				count := 0
+				tx.stage = func(root *os.Root, name string, data []byte, mode os.FileMode) error {
+					count++
+					if count == 2 {
+						return failure
+					}
+					return stageFile(root, name, data, mode)
+				}
+			},
+		},
+		{
+			name: "second_replacement",
+			setup: func(tx *transaction, failure error) {
+				tx.rename = func(root *os.Root, oldName, newName string) error {
+					if newName == "second.yaml" {
+						return failure
+					}
+					return root.Rename(oldName, newName)
+				}
+			},
+		},
+		{
+			name: "new_destination",
+			setup: func(tx *transaction, failure error) {
+				tx.link = func(root *os.Root, oldName, newName string) error {
+					if newName == "generated.yaml" {
+						return failure
+					}
+					return root.Link(oldName, newName)
+				}
+			},
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeTransactionFile(t, root, "first.yaml", "first", 0o640)
+			writeTransactionFile(t, root, "second.yaml", "second", 0o600)
+			writeTransactionFile(t, root, "existing.bak", "preserved", 0o444)
+			tx, err := newTransaction(root)
+			require.NoError(t, err)
+			for _, name := range []string{"first.yaml", "second.yaml", "first.yaml.bak", "generated.yaml", "existing.bak"} {
+				_, err = tx.capture(name)
+				require.NoError(t, err)
+			}
+			tx.changes = []fileChange{
+				{name: "first.yaml.bak", content: []byte("first"), mode: 0o640},
+				{name: "first.yaml", content: []byte("new first"), mode: 0o640},
+				{name: "second.yaml", content: []byte("new second"), mode: 0o600},
+				{name: "generated.yaml", content: []byte("generated"), mode: 0o644},
+			}
+			failure := errors.New("injected filesystem failure")
+			tt.setup(tx, failure)
+
+			require.ErrorIs(t, tx.apply(), failure)
+			assertTransactionFile(t, root, "first.yaml", "first", 0o640)
+			assertTransactionFile(t, root, "second.yaml", "second", 0o600)
+			assertTransactionFile(t, root, "existing.bak", "preserved", 0o444)
+			for _, name := range []string{"first.yaml.bak", "generated.yaml"} {
+				_, err = os.Lstat(filepath.Join(root, name))
+				require.ErrorIs(t, err, os.ErrNotExist)
+			}
+			assertNoTransactionTemporary(t, root)
+		})
+	}
+}
+
+func Test_transaction_captureRejectsUnsafeFiles(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name     string
+		filename string
+		setup    func(*testing.T, string)
+	}{
+		{name: "escape", filename: "../outside"},
+		{name: "absolute", filename: "/outside"},
+		{name: "directory", filename: "."},
+		{
+			name: "symlink", filename: "source.yaml",
+			setup: func(t *testing.T, root string) {
+				require.NoError(t, os.Symlink("missing", filepath.Join(root, "source.yaml")))
+			},
+		},
+		{
+			name: "directory_file", filename: "source.yaml",
+			setup: func(t *testing.T, root string) {
+				require.NoError(t, os.Mkdir(filepath.Join(root, "source.yaml"), 0o755))
+			},
+		},
+		{
+			name: "symlink_parent", filename: "proto/source.proto",
+			setup: func(t *testing.T, root string) {
+				require.NoError(t, os.Mkdir(filepath.Join(root, "real"), 0o755))
+				writeTransactionFile(t, root, "real/source.proto", "proto", 0o644)
+				require.NoError(t, os.Symlink("real", filepath.Join(root, "proto")))
+			},
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			if tt.setup != nil {
+				tt.setup(t, root)
+			}
+			tx, err := newTransaction(root)
+			require.NoError(t, err)
+			_, err = tx.capture(tt.filename)
+			require.Error(t, err)
+		})
+	}
+}
+
+func Test_transaction_rejectsReplacedRoot(t *testing.T) {
+	t.Parallel()
+
+	parent := t.TempDir()
+	root := filepath.Join(parent, "root")
+	require.NoError(t, os.Mkdir(root, 0o755))
+	writeTransactionFile(t, root, "easyp.yaml", "original", 0o600)
+	tx, err := newTransaction(root)
+	require.NoError(t, err)
+	_, err = tx.capture("easyp.yaml")
+	require.NoError(t, err)
+	tx.changes = []fileChange{{name: "easyp.yaml", content: []byte("migrated"), mode: 0o600}}
+	require.NoError(t, os.Rename(root, filepath.Join(parent, "old")))
+	require.NoError(t, os.Mkdir(root, 0o755))
+	writeTransactionFile(t, root, "easyp.yaml", "other project", 0o600)
+
+	require.Error(t, tx.apply())
+	assertTransactionFile(t, root, "easyp.yaml", "other project", 0o600)
+	assertTransactionFile(t, filepath.Join(parent, "old"), "easyp.yaml", "original", 0o600)
+	assertNoTransactionTemporary(t, root)
+}
+
+func Test_newTransaction_rejectsSymlinkRoot(t *testing.T) {
+	t.Parallel()
+	parent := t.TempDir()
+	root := filepath.Join(parent, "root")
+	require.NoError(t, os.Mkdir(root, 0o755))
+	link := filepath.Join(parent, "link")
+	require.NoError(t, os.Symlink(root, link))
+	_, err := newTransaction(link)
+	require.Error(t, err)
+}
+
+func Test_transaction_rechecksAfterStaging(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeTransactionFile(t, root, "input.proto", "original proto", 0o644)
+	tx, err := newTransaction(root)
+	require.NoError(t, err)
+	for _, name := range []string{"input.proto", "easyp.yaml"} {
+		_, err = tx.capture(name)
+		require.NoError(t, err)
+	}
+	tx.changes = []fileChange{{name: "easyp.yaml", content: []byte("migrated"), mode: 0o644}}
+	tx.stage = func(handle *os.Root, name string, data []byte, mode os.FileMode) error {
+		writeTransactionFile(t, root, "input.proto", "edited proto", 0o644)
+		return stageFile(handle, name, data, mode)
+	}
+
+	require.ErrorContains(t, tx.apply(), "changed since planning")
+	_, err = os.Lstat(filepath.Join(root, "easyp.yaml"))
+	require.ErrorIs(t, err, os.ErrNotExist)
+	assertNoTransactionTemporary(t, root)
+}
+
+func Test_transaction_beforeApplyRejectsAfterStaging(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeTransactionFile(t, root, "easyp.yaml", "original", 0o640)
+	tx, err := newTransaction(root)
+	require.NoError(t, err)
+	for _, name := range []string{"easyp.yaml", "easyp.gen.yaml"} {
+		_, err = tx.capture(name)
+		require.NoError(t, err)
+	}
+	tx.changes = []fileChange{
+		{name: "easyp.yaml", content: []byte("migrated"), mode: 0o640},
+		{name: "easyp.gen.yaml", content: []byte("generated"), mode: 0o644},
+	}
+	failure := errors.New("source inventory changed")
+	called := false
+	tx.beforeApply = func() error {
+		called = true
+		entries, readErr := os.ReadDir(root)
+		require.NoError(t, readErr)
+		var stageDirectory string
+		for _, entry := range entries {
+			if strings.HasPrefix(entry.Name(), ".easyp-migrate-") {
+				stageDirectory = entry.Name()
+			}
+		}
+		require.NotEmpty(t, stageDirectory)
+		assertTransactionFile(t, root, filepath.Join(stageDirectory, "output-0"), "migrated", 0o640)
+		assertTransactionFile(t, root, filepath.Join(stageDirectory, "original-0"), "original", 0o640)
+		assertTransactionFile(t, root, filepath.Join(stageDirectory, "output-1"), "generated", 0o644)
+		return failure
+	}
+
+	require.ErrorIs(t, tx.apply(), failure)
+	assert.True(t, called)
+	assertTransactionFile(t, root, "easyp.yaml", "original", 0o640)
+	_, err = os.Lstat(filepath.Join(root, "easyp.gen.yaml"))
+	require.ErrorIs(t, err, os.ErrNotExist)
+	assertNoTransactionTemporary(t, root)
+}
+
+func Test_transaction_neverOverwritesLateDestination(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeTransactionFile(t, root, "easyp.yaml", "original", 0o640)
+	tx, err := newTransaction(root)
+	require.NoError(t, err)
+	for _, name := range []string{"easyp.yaml", "easyp.gen.yaml"} {
+		_, err = tx.capture(name)
+		require.NoError(t, err)
+	}
+	tx.changes = []fileChange{
+		{name: "easyp.yaml", content: []byte("migrated"), mode: 0o640},
+		{name: "easyp.gen.yaml", content: []byte("generated"), mode: 0o644},
+	}
+	tx.link = func(handle *os.Root, oldName, newName string) error {
+		writeTransactionFile(t, root, newName, "concurrent output", 0o600)
+		return handle.Link(oldName, newName)
+	}
+
+	require.ErrorIs(t, tx.apply(), os.ErrExist)
+	assertTransactionFile(t, root, "easyp.yaml", "original", 0o640)
+	assertTransactionFile(t, root, "easyp.gen.yaml", "concurrent output", 0o600)
+	assertNoTransactionTemporary(t, root)
+}
+
+func Test_transaction_preservesRecoveryCopiesWhenRollbackFails(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeTransactionFile(t, root, "easyp.yaml", "original", 0o640)
+	tx, err := newTransaction(root)
+	require.NoError(t, err)
+	for _, name := range []string{"easyp.yaml", "easyp.gen.yaml"} {
+		_, err = tx.capture(name)
+		require.NoError(t, err)
+	}
+	tx.changes = []fileChange{
+		{name: "easyp.yaml", content: []byte("migrated"), mode: 0o640},
+		{name: "easyp.gen.yaml", content: []byte("generated"), mode: 0o644},
+	}
+	applyFailure := errors.New("install failure")
+	rollbackFailure := errors.New("rollback failure")
+	tx.link = func(_ *os.Root, _, _ string) error { return applyFailure }
+	tx.rename = func(handle *os.Root, oldName, newName string) error {
+		if strings.Contains(oldName, "original-") {
+			return rollbackFailure
+		}
+		return handle.Rename(oldName, newName)
+	}
+
+	err = tx.apply()
+	require.ErrorIs(t, err, applyFailure)
+	require.ErrorIs(t, err, rollbackFailure)
+	require.ErrorContains(t, err, "recovery copies remain")
+	entries, err := os.ReadDir(root)
+	require.NoError(t, err)
+	var recoveryDirectory string
+	for _, entry := range entries {
+		if strings.HasPrefix(entry.Name(), ".easyp-migrate-") {
+			recoveryDirectory = entry.Name()
+		}
+	}
+	require.NotEmpty(t, recoveryDirectory)
+	assertTransactionFile(t, root, filepath.Join(recoveryDirectory, "original-0"), "original", 0o640)
+}
+
+func Test_transaction_validatesPlannedDestinations(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name    string
+		changes []fileChange
+	}{
+		{name: "uncaptured", changes: []fileChange{{name: "other.yaml", mode: 0o644}}},
+		{name: "duplicate", changes: []fileChange{{name: "easyp.yaml", mode: 0o644}, {name: "easyp.yaml", mode: 0o644}}},
+		{name: "escape", changes: []fileChange{{name: "../easyp.yaml", mode: 0o644}}},
+		{name: "nonregular_mode", changes: []fileChange{{name: "easyp.yaml", mode: os.ModeSymlink | 0o644}}},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			tx, err := newTransaction(root)
+			require.NoError(t, err)
+			_, err = tx.capture("easyp.yaml")
+			require.NoError(t, err)
+			tx.changes = tt.changes
+
+			require.Error(t, tx.apply())
+			entries, err := os.ReadDir(root)
+			require.NoError(t, err)
+			assert.Empty(t, entries)
+		})
+	}
+}
+
+func Test_transaction_canonicalizesParentAlias(t *testing.T) {
+	t.Parallel()
+	parent := t.TempDir()
+	realParent := filepath.Join(parent, "real")
+	require.NoError(t, os.Mkdir(realParent, 0o755))
+	root := filepath.Join(realParent, "root")
+	require.NoError(t, os.Mkdir(root, 0o755))
+	alias := filepath.Join(parent, "alias")
+	require.NoError(t, os.Symlink(realParent, alias))
+	tx, err := newTransaction(filepath.Join(alias, "root"))
+	require.NoError(t, err)
+	_, err = tx.capture("easyp.yaml")
+	require.NoError(t, err)
+	tx.changes = []fileChange{{name: "easyp.yaml", content: []byte("migrated"), mode: 0o644}}
+
+	require.NoError(t, tx.apply())
+	assertTransactionFile(t, root, "easyp.yaml", "migrated", 0o644)
+	assertNoTransactionTemporary(t, root)
+}
+
+func Test_transaction_capturesNestedSource(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	require.NoError(t, os.Mkdir(filepath.Join(root, "proto"), 0o755))
+	writeTransactionFile(t, root, "proto/source.proto", "proto", 0o644)
+	tx, err := newTransaction(root)
+	require.NoError(t, err)
+	initial, err := tx.capture("proto/source.proto")
+	require.NoError(t, err)
+	assert.Equal(t, "proto", string(initial.data))
+	require.NoError(t, tx.apply())
+	writeTransactionFile(t, root, "proto/source.proto", "edited proto", 0o644)
+	_, err = tx.capture("proto/source.proto")
+	require.ErrorContains(t, err, "changed since planning")
+	assertNoTransactionTemporary(t, root)
+}
+
+func writeTransactionFile(t *testing.T, root, name, content string, mode os.FileMode) {
+	t.Helper()
+	path := filepath.Join(root, name)
+	require.NoError(t, os.WriteFile(path, []byte(content), mode))
+	require.NoError(t, os.Chmod(path, mode))
+}
+
+func assertTransactionFile(t *testing.T, root, name, content string, mode os.FileMode) {
+	t.Helper()
+	path := filepath.Join(root, name)
+	data, err := os.ReadFile(path)
+	require.NoError(t, err)
+	assert.Equal(t, content, string(data))
+	info, err := os.Stat(path)
+	require.NoError(t, err)
+	assert.Equal(t, mode, info.Mode())
+}
+
+func assertNoTransactionTemporary(t *testing.T, root string) {
+	t.Helper()
+	entries, err := os.ReadDir(root)
+	require.NoError(t, err)
+	for _, entry := range entries {
+		assert.False(t, strings.HasPrefix(entry.Name(), ".easyp-migrate-"), "leftover: %s", entry.Name())
+	}
+}
diff --git a/internal/migration/convert.go b/internal/migration/convert.go
new file mode 100644
index 00000000..a59210ec
--- /dev/null
+++ b/internal/migration/convert.go
@@ -0,0 +1,262 @@
+package migration
+
+import (
+	"fmt"
+	"path"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	"golang.org/x/mod/semver"
+	"gopkg.in/yaml.v3"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/rules"
+)
+
+type policyOutput struct {
+	Version  string                       `yaml:"version"`
+	Linters  linterOutput                 `yaml:"linters"`
+	Settings map[string]map[string]string `yaml:"linters-settings"`
+	Issues   issueOutput                  `yaml:"issues"`
+	Breaking breakingOutput               `yaml:"breaking"`
+}
+
+type linterOutput struct {
+	Default             string   `yaml:"default"`
+	Enable              []string `yaml:"enable,omitempty"`
+	Disable             []string `yaml:"disable,omitempty"`
+	AllowCommentIgnores bool     `yaml:"allow_comment_ignores"`
+}
+
+type issueOutput struct {
+	ExcludeRules []exclusionOutput `yaml:"exclude-rules,omitempty"`
+}
+type exclusionOutput struct {
+	Path    string   `yaml:"path"`
+	Linters []string `yaml:"linters,omitempty"`
+}
+type breakingOutput struct {
+	Baseline   string   `yaml:"baseline,omitempty"`
+	Categories []string `yaml:"categories,omitempty"`
+	Ignore     []string `yaml:"ignore,omitempty"`
+}
+
+type generateOutput struct {
+	Version  string             `yaml:"version"`
+	Generate targetsOutput      `yaml:"generate"`
+	Plugins  []pluginOutput     `yaml:"plugins"`
+	Options  v1.GenerateOptions `yaml:"options"`
+}
+type targetsOutput struct {
+	Modules []string           `yaml:"modules,omitempty"`
+	Managed config.ManagedMode `yaml:"managed,omitempty"`
+}
+type pluginOutput struct {
+	Name        string            `yaml:"name,omitempty"`
+	Path        string            `yaml:"path,omitempty"`
+	Command     []string          `yaml:"command,omitempty"`
+	Remote      string            `yaml:"remote,omitempty"`
+	Version     string            `yaml:"version,omitempty"`
+	Out         string            `yaml:"out"`
+	Opts        config.PluginOpts `yaml:"opts,omitempty"`
+	WithImports bool              `yaml:"with_imports,omitempty"`
+}
+
+func convertPolicy(cfg legacyConfig) ([]byte, error) {
+	use, err := expandRules(cfg.Lint.Use)
+	if err != nil {
+		return nil, fmt.Errorf("expandRules: %w", err)
+	}
+	except, err := expandRules(cfg.Lint.Except)
+	if err != nil {
+		return nil, fmt.Errorf("expandRules: %w", err)
+	}
+	effective := slices.DeleteFunc(use, func(name string) bool { return slices.Contains(except, name) })
+	minimal, err := expandRules([]string{"MINIMAL"})
+	if err != nil {
+		return nil, fmt.Errorf("expandRules: %w", err)
+	}
+	output := policyOutput{Version: "v1", Linters: linterOutput{
+		Default: "MINIMAL", Enable: effective, AllowCommentIgnores: cfg.Lint.AllowCommentIgnores,
+	}}
+	for _, rule := range minimal {
+		if !slices.Contains(effective, rule) {
+			output.Linters.Disable = append(output.Linters.Disable, rule)
+		}
+	}
+	output.Settings = make(map[string]map[string]string)
+	if cfg.Lint.EnumZeroValueSuffix != "" {
+		output.Settings["ENUM_ZERO_VALUE_SUFFIX"] = map[string]string{"suffix": cfg.Lint.EnumZeroValueSuffix}
+	}
+	if cfg.Lint.ServiceSuffix != "" {
+		output.Settings["SERVICE_SUFFIX"] = map[string]string{"suffix": cfg.Lint.ServiceSuffix}
+	}
+	for _, ignore := range cfg.Lint.Ignore {
+		paths, err := literalExclusionPaths(ignore)
+		if err != nil {
+			return nil, fmt.Errorf("literalExclusionPaths: %w", err)
+		}
+		for _, pattern := range paths {
+			output.Issues.ExcludeRules = append(output.Issues.ExcludeRules, exclusionOutput{Path: pattern})
+		}
+	}
+	keys := make([]string, 0, len(cfg.Lint.IgnoreOnly))
+	for key := range cfg.Lint.IgnoreOnly {
+		keys = append(keys, key)
+	}
+	slices.Sort(keys)
+	ignored := make(map[string][]string)
+	for _, key := range keys {
+		names, err := expandRules([]string{key})
+		if err != nil {
+			return nil, fmt.Errorf("expandRules: %w", err)
+		}
+		paths := cfg.Lint.IgnoreOnly[key]
+		for _, name := range names {
+			if previous, ok := ignored[name]; ok && !slices.Equal(previous, paths) {
+				return nil, fmt.Errorf("lint.ignore_only overlaps for %s with different paths; make the legacy selection unambiguous before migration", name)
+			}
+			ignored[name] = paths
+		}
+		for _, ignore := range paths {
+			patterns, err := prefixExclusionPaths(ignore)
+			if err != nil {
+				return nil, fmt.Errorf("prefixExclusionPaths: %w", err)
+			}
+			for _, pattern := range patterns {
+				output.Issues.ExcludeRules = append(output.Issues.ExcludeRules, exclusionOutput{Path: pattern, Linters: names})
+			}
+		}
+	}
+	output.Breaking = breakingOutput{Categories: cfg.Breaking.Use, Ignore: cfg.Breaking.Ignore}
+	for _, category := range cfg.Breaking.Use {
+		if category != "FILE" {
+			return nil, fmt.Errorf("unsupported legacy breaking.use %q; migrate breaking policy manually", category)
+		}
+	}
+	for _, ignore := range cfg.Breaking.Ignore {
+		if err := literalPolicyPath(ignore); err != nil {
+			return nil, fmt.Errorf("literalPolicyPath: %w", err)
+		}
+	}
+	if cfg.Breaking.AgainstGitRef != "" {
+		output.Breaking.Baseline = "git:" + cfg.Breaking.AgainstGitRef
+	}
+	raw, err := yaml.Marshal(output)
+	if err != nil {
+		return nil, fmt.Errorf("Marshal: %w", err)
+	}
+	return raw, nil
+}
+
+func expandRules(selection []string) ([]string, error) {
+	for _, name := range selection {
+		if strings.Contains(name, "$") {
+			return nil, fmt.Errorf("rule placeholder %q prevents safe lint-set analysis; migrate manually", name)
+		}
+	}
+	if err := rules.ValidateNames(selection); err != nil {
+		return nil, fmt.Errorf("ValidateNames: %w", err)
+	}
+	groups := make(map[string][]string)
+	for _, group := range rules.AllGroups() {
+		groups[group.Key] = group.Rules
+	}
+	var result []string
+	for _, name := range selection {
+		names, ok := groups[name]
+		if !ok {
+			names = []string{name}
+		}
+		for _, rule := range names {
+			if !slices.Contains(result, rule) {
+				result = append(result, rule)
+			}
+		}
+	}
+	return result, nil
+}
+
+func literalPolicyPath(value string) error {
+	if strings.Contains(value, "$") {
+		return fmt.Errorf("exclusion path placeholder %q prevents safe literal/glob analysis; migrate manually", value)
+	}
+	if path.IsAbs(value) || strings.ContainsAny(value, "\\:\x00") {
+		return fmt.Errorf("exclusion path %q must be relative to easyp.yaml; migrate this path manually", value)
+	}
+	for _, segment := range strings.Split(value, "/") {
+		if segment == ".." {
+			return fmt.Errorf("exclusion path %q leaves the policy directory; manual migration required", value)
+		}
+	}
+	return nil
+}
+
+func escapeGlobLiteral(value string) string {
+	return strings.NewReplacer("*", "[*]", "?", "[?]", "[", "[[]").Replace(value)
+}
+
+func literalExclusionPaths(value string) ([]string, error) {
+	if err := literalPolicyPath(value); err != nil {
+		return nil, fmt.Errorf("literalPolicyPath: %w", err)
+	}
+	value = filepath.ToSlash(filepath.Clean(value))
+	if value == "." {
+		return []string{"**"}, nil
+	}
+	escaped := escapeGlobLiteral(value)
+	if escaped != value || strings.HasSuffix(value, ".proto") {
+		return []string{escaped, escaped + "/**"}, nil
+	}
+	return []string{value}, nil
+}
+
+func prefixExclusionPaths(value string) ([]string, error) {
+	if err := literalPolicyPath(value); err != nil {
+		return nil, fmt.Errorf("literalPolicyPath: %w", err)
+	}
+	if value == "" {
+		return []string{"**"}, nil
+	}
+	if strings.TrimSuffix(value, "/") != filepath.ToSlash(filepath.Clean(value)) {
+		return nil, fmt.Errorf("ignore_only raw prefix %q has noncanonical path segments; manual migration required", value)
+	}
+	// v0 used strings.HasPrefix, not directory boundaries or glob matching.
+	// The second pattern covers descendants; the first covers the prefix's own
+	// segment. Escaping preserves metacharacters as literal filename bytes.
+	prefix := escapeGlobLiteral(value) + "*"
+	return []string{prefix, prefix + "/**"}, nil
+}
+
+func convertGenerate(cfg legacyConfig, selected []string) ([]byte, error) {
+	// Empty explicitly disables v1 inheritance of a parent's Go package prefix.
+	emptyPrefix := ""
+	output := generateOutput{
+		Version: "v1", Generate: targetsOutput{Modules: selected, Managed: cfg.Generate.Managed},
+		Plugins: []pluginOutput{}, Options: v1.GenerateOptions{Go: v1.GoOptions{PackagePrefix: &emptyPrefix}},
+	}
+	for i, plugin := range cfg.Generate.Plugins {
+		converted := pluginOutput{Name: plugin.Name, Path: plugin.Path, Command: plugin.Command,
+			Remote: plugin.Remote, Out: plugin.Out, Opts: plugin.Opts, WithImports: plugin.WithImports}
+		if plugin.Remote != "" {
+			colon := strings.LastIndexByte(plugin.Remote, ':')
+			if colon <= strings.LastIndexByte(plugin.Remote, '/') || !semver.IsValid(plugin.Remote[colon+1:]) {
+				return nil, fmt.Errorf("generate.plugins[%d].remote needs a pinned semantic version (remote:version); a placeholder hiding the version requires manual migration", i)
+			}
+			converted.Remote, converted.Version = plugin.Remote[:colon], plugin.Remote[colon+1:]
+		}
+		candidate := v1.Plugin{Name: converted.Name, Path: converted.Path, Command: converted.Command,
+			Remote: converted.Remote, Version: converted.Version, Out: converted.Out, Opts: v1.PluginOptions(converted.Opts), WithImports: converted.WithImports}
+		if err := candidate.Validate(); err != nil {
+			return nil, fmt.Errorf("Validate: %w", err)
+		}
+		output.Plugins = append(output.Plugins, converted)
+	}
+	raw, err := yaml.Marshal(output)
+	if err != nil {
+		return nil, fmt.Errorf("Marshal: %w", err)
+	}
+	return raw, nil
+}
diff --git a/internal/migration/empty_lock_test.go b/internal/migration/empty_lock_test.go
new file mode 100644
index 00000000..b112cde2
--- /dev/null
+++ b/internal/migration/empty_lock_test.go
@@ -0,0 +1,24 @@
+package migration
+
+import (
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+func TestEmptyHistoricalLockGetsNativeLock(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeFixture(t, root, "easyp.yaml", "lint: {}\n")
+	writeFixture(t, root, "easyp.lock", "")
+	plan, err := Build(t.Context(), Options{Dir: root, Module: "example.com/app"})
+	require.NoError(t, err)
+	require.NoError(t, plan.Apply())
+	lock, err := modules.ReadLock(filepath.Join(root, "protobuf.lock"))
+	require.NoError(t, err)
+	require.Equal(t, 1, lock.Version)
+	require.Empty(t, lock.Modules)
+}
diff --git a/internal/migration/legacy.go b/internal/migration/legacy.go
new file mode 100644
index 00000000..4a14a03c
--- /dev/null
+++ b/internal/migration/legacy.go
@@ -0,0 +1,288 @@
+package migration
+
+import (
+	"bytes"
+	"fmt"
+	"io"
+	"reflect"
+	"strings"
+
+	"gopkg.in/yaml.v3"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// These types intentionally describe v0, rather than the runtime config, whose
+// legacy fields may be removed independently of the explicit migration tool.
+type legacyConfig struct {
+	Version  string            `yaml:"version"`
+	Lint     config.LintConfig `yaml:"lint"`
+	Deps     []string          `yaml:"deps"`
+	Generate legacyGenerate    `yaml:"generate"`
+	Breaking legacyBreaking    `yaml:"breaking"`
+}
+
+type legacyBreaking struct {
+	Ignore        []string `yaml:"ignore"`
+	AgainstGitRef string   `yaml:"against_git_ref"`
+	Use           []string `yaml:"use"`
+}
+
+type legacyGenerate struct {
+	Inputs  []legacyInput      `yaml:"inputs"`
+	Plugins []config.Plugin    `yaml:"plugins"`
+	Managed config.ManagedMode `yaml:"managed"`
+}
+
+type legacyInput struct {
+	Directory *legacyDirectory `yaml:"directory"`
+	GitRepo   *legacyGit       `yaml:"git_repo"`
+}
+
+type legacyDirectory struct {
+	Path string `yaml:"path"`
+	Root string `yaml:"root"`
+}
+
+type legacyGit struct {
+	URL          string `yaml:"url"`
+	SubDirectory string `yaml:"sub_directory"`
+	Root         string `yaml:"root"`
+}
+
+func (d *legacyDirectory) UnmarshalYAML(node *yaml.Node) error {
+	if node.Kind == yaml.ScalarNode {
+		*d = legacyDirectory{Path: node.Value, Root: "."}
+		return nil
+	}
+	type rawDirectory legacyDirectory
+	var raw rawDirectory
+	if err := node.Decode(&raw); err != nil {
+		return fmt.Errorf("Decode: %w", err)
+	}
+	*d = legacyDirectory(raw)
+	if d.Root == "" {
+		d.Root = "."
+	}
+	return nil
+}
+
+func parseLegacy(raw []byte) (legacyConfig, []string, error) {
+	var cfg legacyConfig
+	warnings, err := decodeLegacy(raw, &cfg)
+	if err != nil {
+		return legacyConfig{}, nil, fmt.Errorf("decodeLegacy: %w", err)
+	}
+	if cfg.Version != "" {
+		warnings = append(warnings, fmt.Sprintf("legacy version %q is compatibility metadata and is omitted from v1 files", cfg.Version))
+	}
+	if err := cfg.Generate.Managed.Validate(); err != nil {
+		return legacyConfig{}, nil, fmt.Errorf("Validate: %w", err)
+	}
+	for i, input := range cfg.Generate.Inputs {
+		if (input.Directory == nil) == (input.GitRepo == nil) {
+			return legacyConfig{}, nil, fmt.Errorf("generate.inputs[%d] must select exactly one directory or git_repo", i)
+		}
+	}
+	return cfg, warnings, nil
+}
+
+// decodeLegacy validates values that v0 actually consumed before custom
+// UnmarshalYAML methods can coerce them. Unknown legacy keys are preserved only
+// in the byte-identical backup: v0 ignored them as well, so migration reports a
+// warning rather than inventing v1 semantics for them.
+func decodeLegacy(raw []byte, out any) ([]string, error) {
+	node, err := document(raw)
+	if err != nil {
+		return nil, fmt.Errorf("document: %w", err)
+	}
+	var warnings []string
+	if err := typedNode(node, reflect.TypeOf(out).Elem(), "config", &warnings); err != nil {
+		return nil, fmt.Errorf("typedNode: %w", err)
+	}
+	if err := node.Decode(out); err != nil {
+		return nil, fmt.Errorf("Decode: %w", err)
+	}
+	return warnings, nil
+}
+
+func decodeStrict(raw []byte, out any) error {
+	node, err := document(raw)
+	if err != nil {
+		return fmt.Errorf("document: %w", err)
+	}
+	var warnings []string
+	if err := typedNode(node, reflect.TypeOf(out).Elem(), "config", &warnings); err != nil {
+		return fmt.Errorf("typedNode: %w", err)
+	}
+	if len(warnings) > 0 {
+		return fmt.Errorf("%s", warnings[0])
+	}
+	if err := node.Decode(out); err != nil {
+		return fmt.Errorf("Decode: %w", err)
+	}
+	return nil
+}
+
+func document(raw []byte) (*yaml.Node, error) {
+	decoder := yaml.NewDecoder(bytes.NewReader(raw))
+	var root yaml.Node
+	if err := decoder.Decode(&root); err != nil {
+		if err == io.EOF {
+			return nil, fmt.Errorf("empty YAML input")
+		}
+		return nil, fmt.Errorf("Decode: %w", err)
+	}
+	var extra yaml.Node
+	if err := decoder.Decode(&extra); err != io.EOF {
+		return nil, fmt.Errorf("expected exactly one YAML document")
+	}
+	if len(root.Content) != 1 {
+		return nil, fmt.Errorf("empty YAML input")
+	}
+	if root.Content[0].Tag == "!!null" {
+		return nil, fmt.Errorf("null YAML value at line %d", root.Content[0].Line)
+	}
+	if err := unambiguousNode(root.Content[0]); err != nil {
+		return nil, fmt.Errorf("unambiguousNode: %w", err)
+	}
+	if root.Content[0].Kind != yaml.MappingNode {
+		return nil, fmt.Errorf("expected a YAML mapping")
+	}
+	return root.Content[0], nil
+}
+
+func unambiguousNode(node *yaml.Node) error {
+	if node.Kind == yaml.AliasNode || node.Anchor != "" {
+		return fmt.Errorf("YAML aliases and anchors require manual migration (line %d)", node.Line)
+	}
+	switch node.Tag {
+	case "!!map", "!!seq", "!!str", "!!int", "!!float", "!!bool", "!!null":
+	default:
+		return fmt.Errorf("unsupported YAML tag %q at line %d", node.Tag, node.Line)
+	}
+	if node.Kind == yaml.MappingNode {
+		seen := make(map[string]bool)
+		for i := 0; i < len(node.Content); i += 2 {
+			key := node.Content[i]
+			if key.Kind != yaml.ScalarNode || key.Tag != "!!str" || key.Value == "<<" {
+				return fmt.Errorf("mapping keys must be strings; YAML merges are not supported (line %d)", key.Line)
+			}
+			if seen[key.Value] {
+				return fmt.Errorf("duplicate YAML key %q at line %d", key.Value, key.Line)
+			}
+			seen[key.Value] = true
+		}
+	}
+	for _, child := range node.Content {
+		if err := unambiguousNode(child); err != nil {
+			return err
+		}
+	}
+	return nil
+}
+
+func typedNode(node *yaml.Node, typ reflect.Type, path string, warnings *[]string) error {
+	for typ.Kind() == reflect.Pointer {
+		typ = typ.Elem()
+	}
+	if node.Tag == "!!null" {
+		if path == "config.deps" && typ.Kind() == reflect.Slice {
+			*warnings = append(*warnings, "legacy deps: null is treated as an empty dependency list")
+			return nil
+		}
+		return fmt.Errorf("null YAML value at line %d", node.Line)
+	}
+	if typ == reflect.TypeFor[legacyDirectory]() && node.Kind == yaml.ScalarNode && node.Tag == "!!str" {
+		return nil
+	}
+	if typ == reflect.TypeFor[config.PluginOpts]() || typ == reflect.TypeFor[v1.PluginOptions]() {
+		if typ == reflect.TypeFor[v1.PluginOptions]() && node.Kind == yaml.SequenceNode {
+			for _, item := range node.Content {
+				if item.Kind != yaml.ScalarNode || item.Tag != "!!str" {
+					return fmt.Errorf("%s must contain option strings", path)
+				}
+			}
+			return nil
+		}
+		if node.Kind != yaml.MappingNode {
+			return fmt.Errorf("%s must be an options mapping", path)
+		}
+		for i := 1; i < len(node.Content); i += 2 {
+			value := node.Content[i]
+			if value.Kind == yaml.SequenceNode {
+				for _, child := range value.Content {
+					if child.Kind != yaml.ScalarNode {
+						return fmt.Errorf("%s option values must be scalars", path)
+					}
+				}
+			} else if value.Kind != yaml.ScalarNode {
+				return fmt.Errorf("%s option values must be scalars or lists", path)
+			}
+		}
+		return nil
+	}
+	switch typ.Kind() {
+	case reflect.Struct:
+		if node.Kind != yaml.MappingNode {
+			return fmt.Errorf("%s must be a mapping", path)
+		}
+		fields := make(map[string]reflect.Type)
+		for i := 0; i < typ.NumField(); i++ {
+			field := typ.Field(i)
+			key := strings.Split(field.Tag.Get("yaml"), ",")[0]
+			if key != "-" && field.IsExported() {
+				fields[key] = field.Type
+			}
+		}
+		for i := 0; i < len(node.Content); i += 2 {
+			key := node.Content[i].Value
+			field, ok := fields[key]
+			if !ok {
+				*warnings = append(*warnings, fmt.Sprintf("legacy key %s.%s at line %d was ignored by v0 and is omitted from v1 files", path, key, node.Content[i].Line))
+				continue
+			}
+			if err := typedNode(node.Content[i+1], field, path+"."+key, warnings); err != nil {
+				return err
+			}
+		}
+	case reflect.Slice:
+		if node.Kind != yaml.SequenceNode {
+			return fmt.Errorf("%s must be a sequence", path)
+		}
+		for i, child := range node.Content {
+			if err := typedNode(child, typ.Elem(), fmt.Sprintf("%s[%d]", path, i), warnings); err != nil {
+				return err
+			}
+		}
+	case reflect.Map:
+		if node.Kind != yaml.MappingNode {
+			return fmt.Errorf("%s must be a mapping", path)
+		}
+		for i := 1; i < len(node.Content); i += 2 {
+			if err := typedNode(node.Content[i], typ.Elem(), path+"."+node.Content[i-1].Value, warnings); err != nil {
+				return err
+			}
+		}
+	case reflect.String:
+		if node.Kind != yaml.ScalarNode || node.Tag != "!!str" {
+			return fmt.Errorf("%s must be a string", path)
+		}
+	case reflect.Bool:
+		if node.Tag != "!!bool" {
+			return fmt.Errorf("%s must be a boolean; placeholders preventing analysis require manual migration", path)
+		}
+	case reflect.Int:
+		if node.Tag != "!!int" {
+			return fmt.Errorf("%s must be an integer", path)
+		}
+	case reflect.Interface:
+		if node.Kind != yaml.ScalarNode {
+			return fmt.Errorf("%s must be a scalar", path)
+		}
+	default:
+		return fmt.Errorf("unsupported value at %s", path)
+	}
+	return nil
+}
diff --git a/internal/migration/lock.go b/internal/migration/lock.go
new file mode 100644
index 00000000..9ff14465
--- /dev/null
+++ b/internal/migration/lock.go
@@ -0,0 +1,266 @@
+package migration
+
+import (
+	"bufio"
+	"bytes"
+	"context"
+	"encoding/base64"
+	"fmt"
+	"slices"
+	"strings"
+
+	"golang.org/x/mod/semver"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+// Repository verifies the v0 installed-tree hash (when supplied), then returns
+// independently hashed v1 tracked contents and metadata for that same commit.
+// It is called only when Options.ResolveLock explicitly permits resolution.
+type Repository interface {
+	FetchMigration(context.Context, string, string, string) (modules.Fetched, error)
+}
+
+type legacyPin struct{ source, version, hash string }
+
+func parseLegacyLock(raw []byte) (map[string]legacyPin, error) {
+	pins := make(map[string]legacyPin)
+	scanner := bufio.NewScanner(bytes.NewReader(raw))
+	for line := 1; scanner.Scan(); line++ {
+		text := strings.TrimSpace(scanner.Text())
+		if text == "" {
+			continue
+		}
+		fields := strings.Fields(text)
+		if len(fields) != 3 {
+			return nil, fmt.Errorf("easyp.lock:%d: expected SOURCE VERSION h1:HASH; a native v1 lock is only accepted as an unchanged protobuf.lock", line)
+		}
+		if err := validIdentity(fields[0]); err != nil {
+			return nil, fmt.Errorf("validIdentity: %w", err)
+		}
+		version, err := migrationVersion(fields[1])
+		if err != nil {
+			return nil, fmt.Errorf("migrationVersion: %w", err)
+		}
+		if !strings.HasPrefix(fields[2], "h1:") {
+			return nil, fmt.Errorf("easyp.lock:%d: invalid legacy hash", line)
+		}
+		digest, err := base64.StdEncoding.DecodeString(strings.TrimPrefix(fields[2], "h1:"))
+		if err != nil || len(digest) != 32 {
+			return nil, fmt.Errorf("easyp.lock:%d: invalid legacy hash", line)
+		}
+		if _, ok := pins[fields[0]]; ok {
+			return nil, fmt.Errorf("easyp.lock:%d: duplicate dependency %s", line, fields[0])
+		}
+		pins[fields[0]] = legacyPin{source: fields[0], version: version, hash: fields[2]}
+	}
+	if err := scanner.Err(); err != nil {
+		return nil, fmt.Errorf("Err: %w", err)
+	}
+	return pins, nil
+}
+
+func migrateLock(ctx context.Context, module v1.Module, pins map[string]legacyPin, hadLock bool, repository Repository) (v1.Lock, error) {
+	if len(module.Replaces) > 0 {
+		return v1.Lock{}, fmt.Errorf("full lock migration with local replacements requires manual migration; the preview preserves replacement structure")
+	}
+	if repository == nil {
+		return v1.Lock{}, fmt.Errorf("--resolve-lock requires a dependency repository")
+	}
+	source := migrationSource{repository: repository, metadata: make(map[migrationRevision]v1.Module)}
+	if !hadLock {
+		lock, err := modules.Resolve(ctx, module, source, nil)
+		if err != nil {
+			return v1.Lock{}, fmt.Errorf("Resolve: %w", err)
+		}
+		if err := validateRuntimeLock(module, lock, source.metadata); err != nil {
+			return v1.Lock{}, fmt.Errorf("validateRuntimeLock: %w", err)
+		}
+		return lock, nil
+	}
+	// Never run the normal version-selection algorithm on historical pins: every
+	// legacy entry is verified at its recorded SHA/tag, including indirect pins.
+	names := make([]string, 0, len(pins))
+	for name := range pins {
+		names = append(names, name)
+	}
+	slices.Sort(names)
+	resolved := make(map[string]modules.Fetched, len(pins))
+	lock := v1.Lock{Version: 1, Modules: []v1.LockedModule{}}
+	for _, name := range names {
+		if err := ctx.Err(); err != nil {
+			return v1.Lock{}, fmt.Errorf("Err: %w", err)
+		}
+		pin := pins[name]
+		fetched, err := repository.FetchMigration(ctx, name, pin.version, pin.hash)
+		if err != nil {
+			return v1.Lock{}, fmt.Errorf("FetchMigration: %w", err)
+		}
+		if err := checkFetched(name, pin.version, fetched); err != nil {
+			return v1.Lock{}, fmt.Errorf("checkFetched: %w", err)
+		}
+		resolved[name] = fetched
+		source.remember(fetched)
+		lock.Modules = append(lock.Modules, fetched.Lock)
+	}
+	requirements := slices.Clone(module.Requires)
+	for _, name := range names {
+		requirements = append(requirements, resolved[name].Module.Requires...)
+	}
+	verifiedVersions := make(map[string]string)
+	for _, requirement := range requirements {
+		pin, ok := resolved[requirement.Module]
+		if !ok {
+			return v1.Lock{}, fmt.Errorf("legacy easyp.lock is missing required dependency %s; recover its historical pin before migration (HEAD will not be selected)", requirement.Module)
+		}
+		version, err := checkPinRequirement(ctx, requirement, pin.Lock, source)
+		if err != nil {
+			return v1.Lock{}, fmt.Errorf("checkPinRequirement: %w", err)
+		}
+		previous := verifiedVersions[requirement.Module]
+		if version != "" && (previous == "" || semver.Compare(version, previous) > 0 || semver.Compare(version, previous) == 0 && version > previous) {
+			verifiedVersions[requirement.Module] = version
+		}
+	}
+	// Every comparison above uses the original historical pin. Assign labels only
+	// after all required tags are verified, so a higher tag cannot hide a moved
+	// lower tag. The historical commit and its freshly verified hash stay intact.
+	for i := range lock.Modules {
+		if version := verifiedVersions[lock.Modules[i].Source]; version != "" {
+			lock.Modules[i].Version = version
+		}
+	}
+	if err := validateRuntimeLock(module, lock, source.metadata); err != nil {
+		return v1.Lock{}, fmt.Errorf("validateRuntimeLock: %w", err)
+	}
+	return lock, nil
+}
+
+type migrationRevision struct{ source, commit, hash string }
+
+type migrationSource struct {
+	repository Repository
+	metadata   map[migrationRevision]v1.Module
+}
+
+func revisionKey(entry v1.LockedModule) migrationRevision {
+	return migrationRevision{source: entry.Source, commit: strings.ToLower(entry.Commit), hash: entry.Hash}
+}
+
+func (s migrationSource) remember(fetched modules.Fetched) {
+	key := revisionKey(fetched.Lock)
+	if _, exists := s.metadata[key]; !exists {
+		s.metadata[key] = fetched.Module
+	}
+}
+
+func (s migrationSource) Fetch(ctx context.Context, source, version string) (modules.Fetched, error) {
+	version, err := migrationVersion(version)
+	if err != nil {
+		return modules.Fetched{}, fmt.Errorf("migrationVersion: %w", err)
+	}
+	fetched, err := s.repository.FetchMigration(ctx, source, version, "")
+	if err != nil {
+		return modules.Fetched{}, fmt.Errorf("FetchMigration: %w", err)
+	}
+	if err := checkFetched(source, version, fetched); err != nil {
+		return modules.Fetched{}, fmt.Errorf("checkFetched: %w", err)
+	}
+	s.remember(fetched)
+	return fetched, nil
+}
+
+func validateRuntimeLock(module v1.Module, lock v1.Lock, metadata map[migrationRevision]v1.Module) error {
+	if err := lock.Validate(); err != nil {
+		return fmt.Errorf("Validate: %w", err)
+	}
+	if err := validateRuntimeRequirements(module, lock); err != nil {
+		return fmt.Errorf("validateRuntimeRequirements: %w", err)
+	}
+	for _, entry := range lock.Modules {
+		dependency, ok := metadata[revisionKey(entry)]
+		if !ok {
+			return fmt.Errorf("selected dependency %s at %s has no verified metadata", entry.Source, entry.Commit)
+		}
+		if err := validateRuntimeRequirements(dependency, lock); err != nil {
+			return fmt.Errorf("validateRuntimeRequirements: %w", err)
+		}
+	}
+	return nil
+}
+
+func validateRuntimeRequirements(module v1.Module, lock v1.Lock) error {
+	err := modules.ValidateRequirements(module.Requires, lock)
+	if err == nil {
+		return nil
+	}
+	for _, requirement := range module.Requires {
+		if legacyPseudo.MatchString(requirement.Version) {
+			return fmt.Errorf("ValidateRequirements: %s retains legacy pseudo-version %s@%s; manual migration is required to replace this metadata requirement with a full commit or verified semantic tag: %w", module.Name, requirement.Module, requirement.Version, err)
+		}
+	}
+	return fmt.Errorf("ValidateRequirements: %s metadata is incompatible with the native lock; manual migration is required: %w", module.Name, err)
+}
+
+func checkFetched(source, version string, fetched modules.Fetched) error {
+	if fetched.Lock.Source != source || fetched.Module.Name != source {
+		return fmt.Errorf("resolved dependency identity differs from %s", source)
+	}
+	if version != "" && fetched.Lock.Version != version {
+		return fmt.Errorf("resolved version for %s differs from historical pin %s", source, version)
+	}
+	if v1.IsCommitRef(version) && !strings.EqualFold(version, fetched.Lock.Commit) {
+		return fmt.Errorf("resolved commit for %s differs from historical pin %s", source, version)
+	}
+	if len(fetched.Module.Replaces) > 0 {
+		return fmt.Errorf("dependency %s has local replacements; full lock migration requires manual migration", source)
+	}
+	for _, requirement := range fetched.Module.Requires {
+		if err := validIdentity(requirement.Module); err != nil {
+			return fmt.Errorf("validIdentity: %w", err)
+		}
+		if _, err := migrationVersion(requirement.Version); err != nil {
+			return fmt.Errorf("migrationVersion: %w", err)
+		}
+	}
+	if err := (v1.Lock{Version: 1, Modules: []v1.LockedModule{fetched.Lock}}).Validate(); err != nil {
+		return fmt.Errorf("Validate: %w", err)
+	}
+	return nil
+}
+
+func checkPinRequirement(ctx context.Context, req v1.Requirement, pin v1.LockedModule, source migrationSource) (string, error) {
+	version, err := migrationVersion(req.Version)
+	if err != nil {
+		return "", fmt.Errorf("migrationVersion: %w", err)
+	}
+	if version == "" {
+		return "", nil
+	}
+	if v1.IsCommitRef(version) {
+		if !strings.EqualFold(version, pin.Commit) {
+			return "", fmt.Errorf("incompatible requirement %s@%s: historical commit is %s", req.Module, version, pin.Commit)
+		}
+		return "", nil
+	}
+	if semver.IsValid(pin.Version) {
+		if semver.Compare(pin.Version, version) < 0 {
+			return "", fmt.Errorf("incompatible requirement %s@%s: historical version is %s", req.Module, version, pin.Version)
+		}
+		return "", nil
+	}
+	// A SHA-only pin has no semantic ordering. Only a tag resolving to that exact
+	// commit proves compatibility; do not infer ancestry or silently repin it.
+	tag, err := source.Fetch(ctx, req.Module, version)
+	if err != nil {
+		return "", fmt.Errorf("Fetch: %w", err)
+	}
+	if !strings.EqualFold(tag.Lock.Commit, pin.Commit) {
+		return "", fmt.Errorf("incompatible requirement %s@%s: tag differs from historical commit %s; reconcile the pins manually", req.Module, version, pin.Commit)
+	}
+	if tag.Lock.Hash != pin.Hash {
+		return "", fmt.Errorf("incompatible requirement %s@%s: content hash differs at historical commit %s; reconcile the pins manually", req.Module, version, pin.Commit)
+	}
+	return version, nil
+}
diff --git a/internal/migration/lock_test.go b/internal/migration/lock_test.go
new file mode 100644
index 00000000..fa921025
--- /dev/null
+++ b/internal/migration/lock_test.go
@@ -0,0 +1,381 @@
+package migration
+
+import (
+	"context"
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+const testCommit = "0123456789abcdef0123456789abcdef01234567"
+const testHash = "h1:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="
+const testNewHash = "h1:AQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQE="
+
+type mockRepository struct {
+	fetched       map[string]modules.Fetched
+	calls         []string
+	wantOldHash   string
+	wantOldHashes map[string]string
+	err           error
+}
+
+func (r *mockRepository) FetchMigration(_ context.Context, source, version, oldHash string) (modules.Fetched, error) {
+	r.calls = append(r.calls, source+"@"+version)
+	if r.err != nil {
+		return modules.Fetched{}, r.err
+	}
+	wantOldHash := r.wantOldHash
+	if r.wantOldHashes != nil {
+		var ok bool
+		wantOldHash, ok = r.wantOldHashes[source+"@"+version]
+		if !ok {
+			return modules.Fetched{}, fmt.Errorf("unexpected integrity request %s@%s", source, version)
+		}
+	}
+	if oldHash != wantOldHash {
+		return modules.Fetched{}, fmt.Errorf("unexpected legacy integrity input %s", oldHash)
+	}
+	value, ok := r.fetched[source+"@"+version]
+	if !ok {
+		return modules.Fetched{}, fmt.Errorf("unexpected revision %s@%s", source, version)
+	}
+	return value, nil
+}
+
+func TestMigrateLockTaggedHistoricalPins(t *testing.T) {
+	t.Parallel()
+	const dependency = "example.com/acme/dep"
+	const consumer = "example.com/acme/consumer"
+	for _, tt := range []struct {
+		name, legacyVersion, directVersion, transitiveVersion, wantVersion string
+	}{
+		{name: "sha_direct", legacyVersion: testCommit, directVersion: "v1.2.3", wantVersion: "v1.2.3"},
+		{name: "pseudo_direct", legacyVersion: "v0.0.0-20260101123456-" + testCommit, directVersion: "v1.2.3", wantVersion: "v1.2.3"},
+		{name: "transitive_higher", legacyVersion: testCommit, directVersion: "v1.0.0", transitiveVersion: "v1.2.0", wantVersion: "v1.2.0"},
+		{name: "direct_higher", legacyVersion: testCommit, directVersion: "v1.2.0", transitiveVersion: "v1.0.0", wantVersion: "v1.2.0"},
+		{name: "tag_pin_retained", legacyVersion: "v1.3.0", directVersion: "v1.0.0", wantVersion: "v1.3.0"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			pins, err := parseLegacyLock([]byte(dependency + " " + tt.legacyVersion + " " + testHash + "\n"))
+			require.NoError(t, err)
+			module := v1.Module{Name: "example.com/acme/local", Requires: []v1.Requirement{{Module: dependency, Version: tt.directVersion}}}
+			pin := migrationFetched(dependency, pins[dependency].version, testCommit)
+			repo := &mockRepository{
+				fetched:       map[string]modules.Fetched{dependency + "@" + pin.Lock.Version: pin},
+				wantOldHashes: map[string]string{dependency + "@" + pin.Lock.Version: testHash},
+			}
+			if tt.transitiveVersion != "" {
+				module.Requires = append(module.Requires, v1.Requirement{Module: consumer})
+				pins[consumer] = legacyPin{source: consumer, version: testCommit, hash: testHash}
+				repo.fetched[consumer+"@"+testCommit] = migrationFetched(consumer, testCommit, testCommit, v1.Requirement{Module: dependency, Version: tt.transitiveVersion})
+				repo.wantOldHashes[consumer+"@"+testCommit] = testHash
+			}
+			if pin.Lock.Version == testCommit {
+				for _, version := range []string{tt.directVersion, tt.transitiveVersion} {
+					if version != "" {
+						repo.fetched[dependency+"@"+version] = migrationFetched(dependency, version, testCommit)
+						repo.wantOldHashes[dependency+"@"+version] = ""
+					}
+				}
+			}
+			lock, err := migrateLock(t.Context(), module, pins, true, repo)
+			require.NoError(t, err)
+			require.NoError(t, modules.ValidateRequirements(module.Requires, lock))
+			for _, entry := range lock.Modules {
+				assert.Equal(t, testCommit, entry.Commit)
+				assert.Equal(t, testNewHash, entry.Hash)
+				if entry.Source == dependency {
+					assert.Equal(t, tt.wantVersion, entry.Version)
+				}
+				metadata := repo.fetched[entry.Source+"@"+pins[entry.Source].version].Module
+				require.NoError(t, modules.ValidateRequirements(metadata.Requires, lock))
+			}
+		})
+	}
+}
+
+func TestMigrateLockDoesNotInventTagLabels(t *testing.T) {
+	t.Parallel()
+	const dependency = "example.com/acme/dep"
+	const otherCommit = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+	for _, tt := range []struct {
+		name, tagCommit, returnedVersion, tagHash, wantError string
+		missingTag                                           bool
+	}{
+		{name: "tag_moved", tagCommit: otherCommit, returnedVersion: "v1.0.0", tagHash: testNewHash, wantError: "incompatible"},
+		{name: "tag_missing", missingTag: true, wantError: "unexpected integrity request"},
+		{name: "tag_label_differs", tagCommit: testCommit, returnedVersion: "v1.2.0", tagHash: testNewHash, wantError: "resolved version"},
+		{name: "tag_hash_differs", tagCommit: testCommit, returnedVersion: "v1.0.0", tagHash: testHash, wantError: "content hash"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			module := v1.Module{Name: "example.com/acme/local", Requires: []v1.Requirement{{Module: dependency, Version: "v1.0.0"}}}
+			pins := map[string]legacyPin{dependency: {source: dependency, version: testCommit, hash: testHash}}
+			repo := &mockRepository{
+				fetched:       map[string]modules.Fetched{dependency + "@" + testCommit: migrationFetched(dependency, testCommit, testCommit)},
+				wantOldHashes: map[string]string{dependency + "@" + testCommit: testHash},
+			}
+			if !tt.missingTag {
+				fetched := migrationFetched(dependency, tt.returnedVersion, tt.tagCommit)
+				fetched.Lock.Hash = tt.tagHash
+				repo.fetched[dependency+"@v1.0.0"] = fetched
+				repo.wantOldHashes[dependency+"@v1.0.0"] = ""
+			}
+			lock, err := migrateLock(t.Context(), module, pins, true, repo)
+			require.ErrorContains(t, err, tt.wantError)
+			assert.Empty(t, lock.Modules)
+		})
+	}
+}
+
+func TestMigrateLockInitialResolution(t *testing.T) {
+	t.Parallel()
+	const dependency = "example.com/acme/dep"
+	const transitive = "example.com/acme/transitive"
+	for _, tt := range []struct {
+		name, version, fetchedVersion, wantError string
+	}{
+		{name: "tagged_transitive", version: "v1.2.3", fetchedVersion: "v1.2.3"},
+		{name: "pseudo_transitive_requires_manual_migration", version: "v0.0.0-20260101123456-" + testCommit, fetchedVersion: testCommit, wantError: "manual migration"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			module := v1.Module{Name: "example.com/acme/local", Requires: []v1.Requirement{{Module: dependency}}}
+			dep := migrationFetched(dependency, testCommit, testCommit, v1.Requirement{Module: transitive, Version: tt.version})
+			repo := &mockRepository{
+				fetched: map[string]modules.Fetched{
+					dependency + "@":                     dep,
+					transitive + "@" + tt.fetchedVersion: migrationFetched(transitive, tt.fetchedVersion, testCommit),
+				},
+				wantOldHashes: map[string]string{dependency + "@": "", transitive + "@" + tt.fetchedVersion: ""},
+			}
+			lock, err := migrateLock(t.Context(), module, nil, false, repo)
+			if tt.wantError != "" {
+				require.ErrorContains(t, err, tt.wantError)
+				assert.Empty(t, lock.Modules)
+				return
+			}
+			require.NoError(t, err)
+			require.Len(t, lock.Modules, 2)
+			require.NoError(t, modules.ValidateRequirements(module.Requires, lock))
+			require.NoError(t, modules.ValidateRequirements(dep.Module.Requires, lock))
+		})
+	}
+}
+
+func TestMigrateLockRejectsHistoricalPseudoMetadataMismatch(t *testing.T) {
+	t.Parallel()
+	const dependency = "example.com/acme/dep"
+	const transitive = "example.com/acme/transitive"
+	module := v1.Module{Name: "example.com/acme/local", Requires: []v1.Requirement{{Module: dependency}}}
+	pins := map[string]legacyPin{
+		dependency: {source: dependency, version: testCommit, hash: testHash},
+		transitive: {source: transitive, version: testCommit, hash: testHash},
+	}
+	repo := &mockRepository{
+		fetched: map[string]modules.Fetched{
+			dependency + "@" + testCommit: migrationFetched(dependency, testCommit, testCommit, v1.Requirement{Module: transitive, Version: "v0.0.0-20260101123456-" + testCommit}),
+			transitive + "@" + testCommit: migrationFetched(transitive, testCommit, testCommit),
+		},
+		wantOldHash: testHash,
+	}
+	lock, err := migrateLock(t.Context(), module, pins, true, repo)
+	require.ErrorContains(t, err, "manual migration")
+	assert.Empty(t, lock.Modules)
+}
+
+func TestMigrateLockChecksEveryRequiredTagBeforeLabeling(t *testing.T) {
+	t.Parallel()
+	const dependency = "example.com/acme/dep"
+	const consumer = "example.com/acme/consumer"
+	module := v1.Module{Name: "example.com/acme/local", Requires: []v1.Requirement{{Module: dependency, Version: "v1.2.0"}, {Module: consumer}}}
+	pins := map[string]legacyPin{
+		dependency: {source: dependency, version: testCommit, hash: testHash},
+		consumer:   {source: consumer, version: testCommit, hash: testHash},
+	}
+	repo := &mockRepository{
+		fetched: map[string]modules.Fetched{
+			dependency + "@" + testCommit: migrationFetched(dependency, testCommit, testCommit),
+			consumer + "@" + testCommit:   migrationFetched(consumer, testCommit, testCommit, v1.Requirement{Module: dependency, Version: "v1.0.0"}),
+			dependency + "@v1.2.0":        migrationFetched(dependency, "v1.2.0", testCommit),
+			dependency + "@v1.0.0":        migrationFetched(dependency, "v1.0.0", strings.Repeat("a", 40)),
+		},
+		wantOldHashes: map[string]string{
+			dependency + "@" + testCommit: testHash,
+			consumer + "@" + testCommit:   testHash,
+			dependency + "@v1.2.0":        "",
+			dependency + "@v1.0.0":        "",
+		},
+	}
+	lock, err := migrateLock(t.Context(), module, pins, true, repo)
+	require.ErrorContains(t, err, "incompatible requirement example.com/acme/dep@v1.0.0")
+	assert.Empty(t, lock.Modules)
+}
+
+func TestMigrateLockValidatesOnlyFinalSelectedMetadata(t *testing.T) {
+	t.Parallel()
+	const dependency = "example.com/acme/a"
+	const consumer = "example.com/acme/b"
+	const provisional = "example.com/acme/c"
+	const selectedCommit = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+	module := v1.Module{Name: "example.com/acme/local", Requires: []v1.Requirement{{Module: dependency}, {Module: consumer}}}
+	repo := &mockRepository{
+		fetched: map[string]modules.Fetched{
+			dependency + "@":               migrationFetched(dependency, testCommit, testCommit, v1.Requirement{Module: provisional, Version: "v0.0.0-20260101123456-" + testCommit}),
+			consumer + "@":                 migrationFetched(consumer, testCommit, testCommit, v1.Requirement{Module: dependency, Version: "v1.0.0"}),
+			provisional + "@" + testCommit: migrationFetched(provisional, testCommit, testCommit),
+			dependency + "@v1.0.0":         migrationFetched(dependency, "v1.0.0", selectedCommit),
+		},
+		wantOldHashes: map[string]string{
+			dependency + "@": "", consumer + "@": "",
+			provisional + "@" + testCommit: "", dependency + "@v1.0.0": "",
+		},
+	}
+	lock, err := migrateLock(t.Context(), module, nil, false, repo)
+	require.NoError(t, err)
+	require.Len(t, lock.Modules, 2)
+	require.NoError(t, modules.ValidateRequirements(module.Requires, lock))
+	for _, entry := range lock.Modules {
+		assert.NotEqual(t, provisional, entry.Source)
+		if entry.Source == dependency {
+			assert.Equal(t, selectedCommit, entry.Commit)
+			assert.Equal(t, "v1.0.0", entry.Version)
+		}
+	}
+}
+
+func migrationFetched(source, version, commit string, requirements ...v1.Requirement) modules.Fetched {
+	return modules.Fetched{
+		Module: v1.Module{Name: source, Roots: []string{"."}, Requires: requirements},
+		Lock:   v1.LockedModule{Source: source, Version: version, Commit: commit, Hash: testNewHash},
+	}
+}
+
+func TestLockMigration(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct{ name, version, resolved string }{
+		{name: "sha", version: testCommit, resolved: testCommit},
+		{name: "pseudo", version: "v0.0.0-20260101123456-" + testCommit, resolved: testCommit},
+		{name: "tag", version: "v1.2.3", resolved: "v1.2.3"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeFixture(t, root, "easyp.yaml", "deps: [example.com/acme/dep]\n")
+			legacyLock := "example.com/acme/dep " + tt.version + " " + testHash + "\n"
+			writeFixture(t, root, "easyp.lock", legacyLock)
+			repo := &mockRepository{wantOldHash: testHash, fetched: map[string]modules.Fetched{
+				"example.com/acme/dep@" + tt.resolved: {
+					Module: v1.Module{Name: "example.com/acme/dep", Roots: []string{"."}},
+					Lock:   v1.LockedModule{Source: "example.com/acme/dep", Version: tt.resolved, Commit: testCommit, Hash: testNewHash},
+				},
+			}}
+			plan, err := Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api", Repository: repo})
+			require.NoError(t, err)
+			assert.Empty(t, repo.calls)
+			assert.NotEmpty(t, plan.Warnings())
+			require.ErrorContains(t, plan.Apply(), "--resolve-lock")
+			assert.Equal(t, "deps: [example.com/acme/dep]\n", string(mustRead(t, root, "easyp.yaml")))
+			plan, err = Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api", ResolveLock: true, Repository: repo})
+			require.NoError(t, err)
+			var lock v1.Lock
+			require.NoError(t, yaml.Unmarshal(outputContent(t, plan, "protobuf.lock"), &lock))
+			require.Len(t, lock.Modules, 1)
+			assert.Equal(t, testCommit, lock.Modules[0].Commit)
+			assert.Equal(t, tt.resolved, lock.Modules[0].Version)
+			assert.Equal(t, testNewHash, lock.Modules[0].Hash)
+			require.NoError(t, plan.Apply())
+			assert.Equal(t, legacyLock, string(mustRead(t, root, "easyp.lock")))
+			calls := append([]string(nil), repo.calls...)
+			second, err := Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api", ResolveLock: true, Repository: repo})
+			require.NoError(t, err)
+			require.NoError(t, second.Apply())
+			assert.Equal(t, calls, repo.calls, "repeat migration must not refresh")
+		})
+	}
+}
+
+func TestUnsafeLockMigration(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct {
+		name, old, errorText, requirement string
+		mismatch                          bool
+	}{
+		{name: "missing_pin", old: "", errorText: "missing", requirement: ""},
+		{name: "branch", old: "main", errorText: "full Git commit"},
+		{name: "short_sha", old: "0123456", errorText: "full Git commit"},
+		{name: "short_pseudo", old: "v0.0.0-20260101123456-0123456", errorText: "full Git commit"},
+		{name: "hash_mismatch", old: testCommit, mismatch: true, errorText: "legacy hash mismatch"},
+		{name: "transitive_missing", old: "v1.0.0", requirement: "other", errorText: "missing"},
+		{name: "transitive_incompatible", old: "v1.0.0", requirement: "v1.2.0", errorText: "incompatible"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeFixture(t, root, "easyp.yaml", "deps: [example.com/acme/dep]\n")
+			lock := ""
+			if tt.old != "" {
+				lock = "example.com/acme/dep " + tt.old + " " + testHash + "\n"
+			}
+			writeFixture(t, root, "easyp.lock", lock)
+			dep := v1.Module{Name: "example.com/acme/dep", Roots: []string{"."}}
+			if tt.requirement == "other" {
+				dep.Requires = []v1.Requirement{{Module: "example.com/acme/missing"}}
+			} else if tt.requirement != "" {
+				dep.Requires = []v1.Requirement{{Module: "example.com/acme/dep", Version: tt.requirement}}
+			}
+			repo := &mockRepository{wantOldHash: testHash, fetched: map[string]modules.Fetched{
+				"example.com/acme/dep@" + tt.old: {Module: dep, Lock: v1.LockedModule{Source: "example.com/acme/dep", Version: tt.old, Commit: testCommit, Hash: testNewHash}},
+			}}
+			if tt.mismatch {
+				repo.err = fmt.Errorf("legacy hash mismatch")
+			}
+			_, err := Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api", ResolveLock: true, Repository: repo})
+			require.ErrorContains(t, err, tt.errorText)
+			_, err = os.Stat(filepath.Join(root, "easyp.yaml.v0.bak"))
+			assert.ErrorIs(t, err, os.ErrNotExist)
+		})
+	}
+}
+
+func TestLegacyManifest(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct{ name, manifest, wantError string }{
+		{name: "blocks_and_inline", manifest: "direct (\nexample.com/acme/a@v1.2.3\n)\nindirect (\nexample.com/acme/b@" + testCommit + "\n)\nexample.com/acme/c@v1.2.0\n"},
+		{name: "local_replacement", manifest: "direct (\nexample.com/acme/a@v1.2.3\n)\nreplace example.com/acme/a@v1.2.3 => ../a\n"},
+		{name: "ambiguous_replace", manifest: "direct example.com/acme/a@v1.2.3\nreplace example.com/acme/a@v1.2.3 => ../a\nreplace example.com/acme/a@v1.2.0 => ../b\n", wantError: "ambiguous"},
+		{name: "wrong_replace", manifest: "direct example.com/acme/a@v1.2.3\nreplace example.com/acme/a@v1.2.0 => ../a\n", wantError: "version-specific"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeFixture(t, root, "easyp.yaml", "lint: {}\n")
+			writeFixture(t, root, "protobuf.mod", tt.manifest)
+			plan, err := Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api"})
+			if tt.wantError != "" {
+				require.ErrorContains(t, err, tt.wantError)
+				return
+			}
+			require.NoError(t, err)
+			candidate := string(outputContent(t, plan, "protobuf.mod"))
+			assert.Contains(t, candidate, "require example.com/acme/a v1.2.3")
+			if strings.Contains(tt.manifest, "indirect") {
+				assert.Contains(t, candidate, " // indirect")
+			}
+			if strings.Contains(tt.manifest, "replace") {
+				assert.Contains(t, candidate, "replace example.com/acme/a => ../a")
+			}
+			assert.Equal(t, tt.manifest, string(mustRead(t, root, "protobuf.mod")))
+		})
+	}
+}
diff --git a/internal/migration/manifest.go b/internal/migration/manifest.go
new file mode 100644
index 00000000..5175b762
--- /dev/null
+++ b/internal/migration/manifest.go
@@ -0,0 +1,219 @@
+package migration
+
+import (
+	"bufio"
+	"bytes"
+	"fmt"
+	"regexp"
+	"strings"
+	"time"
+
+	"golang.org/x/mod/semver"
+
+	"github.com/easyp-tech/easyp/internal/adapters/gitmodules"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+var legacyPseudo = regexp.MustCompile(`^v0\.0\.0-([0-9]{14})-([0-9a-fA-F]+)$`)
+var fullSemver = regexp.MustCompile(`^v[0-9]+\.[0-9]+\.[0-9]+(?:[-+].*)?$`)
+
+type requirements struct {
+	items    []v1.Requirement
+	indirect map[string]bool
+}
+
+func (r *requirements) add(raw string, indirect bool) error {
+	name, version, hasVersion := strings.Cut(raw, "@")
+	if hasVersion && version == "" {
+		return fmt.Errorf("empty dependency version in %q", raw)
+	}
+	if err := validIdentity(name); err != nil {
+		return fmt.Errorf("validIdentity: %w", err)
+	}
+	if err := gitmodules.ValidateSource(name); err != nil {
+		return fmt.Errorf("ValidateSource: %w", err)
+	}
+	version, err := migrationVersion(version)
+	if err != nil {
+		return fmt.Errorf("migrationVersion: %w", err)
+	}
+	if r.indirect == nil {
+		r.indirect = make(map[string]bool)
+	}
+	for i, previous := range r.items {
+		if previous.Module != name {
+			continue
+		}
+		if previous.Version != "" && version != "" && previous.Version != version {
+			return fmt.Errorf("conflicting legacy versions for %s (%s and %s); choose one explicit pin before migration", name, previous.Version, version)
+		}
+		if previous.Version == "" {
+			r.items[i].Version = version
+		}
+		r.indirect[name] = r.indirect[name] && indirect
+		return nil
+	}
+	r.items = append(r.items, v1.Requirement{Module: name, Version: version})
+	r.indirect[name] = indirect
+	return nil
+}
+
+func migrationVersion(value string) (string, error) {
+	if value == "" {
+		return "", nil
+	}
+	if strings.Contains(value, "$") {
+		return "", fmt.Errorf("dependency version placeholder prevents safe analysis; migrate manually without persisting expanded secrets")
+	}
+	if match := legacyPseudo.FindStringSubmatch(value); match != nil {
+		if _, err := time.Parse("20060102150405", match[1]); err != nil {
+			return "", fmt.Errorf("Parse: %w", err)
+		}
+		if !v1.IsCommitRef(match[2]) {
+			return "", fmt.Errorf("legacy pseudo-version %q requires a full Git commit; recover the original pin manually", value)
+		}
+		return strings.ToLower(match[2]), nil
+	}
+	if v1.IsCommitRef(value) {
+		return strings.ToLower(value), nil
+	}
+	if semver.IsValid(value) && fullSemver.MatchString(value) {
+		return value, nil
+	}
+	return "", fmt.Errorf("unsupported ref %q: use a semantic version or full Git commit; resolve branches, short hashes and non-semver tags manually", value)
+}
+
+func validIdentity(value string) error {
+	if value == "" || value == "." || value == ".." || strings.ContainsAny(value, " \t\r\n@#$()\\") {
+		return fmt.Errorf("invalid module identity %q; supply a literal canonical identity with --module", value)
+	}
+	return nil
+}
+
+type legacyReplacement struct{ module, version, target string }
+
+func parseManifest(raw []byte, deps *requirements) ([]v1.Replacement, error) {
+	var replacements []legacyReplacement
+	block := ""
+	scanner := bufio.NewScanner(bytes.NewReader(raw))
+	for line := 1; scanner.Scan(); line++ {
+		text := strings.TrimSpace(manifestComment(scanner.Text()))
+		if text == "" {
+			continue
+		}
+		if text == ")" {
+			if block == "" {
+				return nil, fmt.Errorf("protobuf.mod:%d: unmatched closing block", line)
+			}
+			block = ""
+			continue
+		}
+		if strings.HasSuffix(text, "(") {
+			if block != "" {
+				return nil, fmt.Errorf("protobuf.mod:%d: nested block", line)
+			}
+			block = strings.TrimSpace(strings.TrimSuffix(text, "("))
+			if block != "direct" && block != "indirect" && block != "replace" {
+				return nil, fmt.Errorf("protobuf.mod:%d: unknown block %q", line, block)
+			}
+			continue
+		}
+		directive, value := block, text
+		if block == "" {
+			fields := strings.Fields(text)
+			if len(fields) > 1 {
+				directive, value = fields[0], strings.TrimSpace(strings.TrimPrefix(text, fields[0]))
+			} else {
+				directive = "direct"
+			}
+		}
+		switch directive {
+		case "direct", "indirect":
+			if len(strings.Fields(value)) != 1 {
+				return nil, fmt.Errorf("protobuf.mod:%d: expected module@version", line)
+			}
+			if err := deps.add(value, directive == "indirect"); err != nil {
+				return nil, fmt.Errorf("add: %w", err)
+			}
+		case "replace":
+			fields := strings.Fields(value)
+			if len(fields) != 3 || fields[1] != "=>" {
+				return nil, fmt.Errorf("protobuf.mod:%d: expected replace module[@version] => local-path", line)
+			}
+			name, version, hasVersion := strings.Cut(fields[0], "@")
+			if hasVersion && version == "" {
+				return nil, fmt.Errorf("empty replacement version for %s", name)
+			}
+			version, err := migrationVersion(version)
+			if err != nil {
+				return nil, fmt.Errorf("migrationVersion: %w", err)
+			}
+			if err := validIdentity(name); err != nil {
+				return nil, fmt.Errorf("validIdentity: %w", err)
+			}
+			if strings.ContainsAny(fields[2], "$@()#") || strings.Contains(fields[2], "://") {
+				return nil, fmt.Errorf("replacement for %s must be a literal local path; manual migration required", name)
+			}
+			replacements = append(replacements, legacyReplacement{module: name, version: version, target: fields[2]})
+		default:
+			return nil, fmt.Errorf("protobuf.mod:%d: unknown directive %q", line, directive)
+		}
+	}
+	if err := scanner.Err(); err != nil {
+		return nil, fmt.Errorf("Err: %w", err)
+	}
+	if block != "" {
+		return nil, fmt.Errorf("protobuf.mod: unclosed %s block", block)
+	}
+	var result []v1.Replacement
+	seen := make(map[string]bool)
+	for _, replacement := range replacements {
+		if seen[replacement.module] {
+			return nil, fmt.Errorf("ambiguous version-specific replacements for %s; v1 replacements apply to all versions", replacement.module)
+		}
+		seen[replacement.module] = true
+		if replacement.version != "" {
+			matched := false
+			for _, dep := range deps.items {
+				matched = matched || (dep.Module == replacement.module && dep.Version == replacement.version)
+			}
+			if !matched {
+				return nil, fmt.Errorf("version-specific replacement %s@%s does not match a unique required pin; manual migration required", replacement.module, replacement.version)
+			}
+		}
+		result = append(result, v1.Replacement{Module: replacement.module, Target: replacement.target})
+	}
+	return result, nil
+}
+
+func manifestComment(line string) string {
+	for i := range line {
+		if line[i] == '#' || (strings.HasPrefix(line[i:], "//") && (i == 0 || line[i-1] == ' ' || line[i-1] == '\t')) {
+			return line[:i]
+		}
+	}
+	return line
+}
+
+func formatManifest(module v1.Module, indirect map[string]bool) []byte {
+	var out strings.Builder
+	fmt.Fprintf(&out, "module %s\n\nroots (\n", module.Name)
+	for _, root := range module.Roots {
+		fmt.Fprintf(&out, "\t%s\n", root)
+	}
+	out.WriteString(")\n")
+	for _, req := range module.Requires {
+		fmt.Fprintf(&out, "\nrequire %s", req.Module)
+		if req.Version != "" {
+			fmt.Fprintf(&out, " %s", req.Version)
+		}
+		if indirect[req.Module] {
+			out.WriteString(" // indirect")
+		}
+		out.WriteByte('\n')
+	}
+	for _, replacement := range module.Replaces {
+		fmt.Fprintf(&out, "\nreplace %s => %s\n", replacement.Module, replacement.Target)
+	}
+	return []byte(out.String())
+}
diff --git a/internal/migration/manifest_test.go b/internal/migration/manifest_test.go
new file mode 100644
index 00000000..1f30e198
--- /dev/null
+++ b/internal/migration/manifest_test.go
@@ -0,0 +1,93 @@
+package migration
+
+import (
+	"context"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+func TestManifestBackupAndCombinedDependencies(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	legacy := "// exact original formatting\ndirect (\n  example.com/acme/a@v1.0.0 // preserve me\n)\nindirect (\n  example.com/acme/b@v1.0.0\n)\n"
+	writeFixture(t, root, "protobuf.mod", legacy)
+	require.NoError(t, os.Chmod(filepath.Join(root, "protobuf.mod"), 0o640))
+	writeFixture(t, root, "easyp.yaml", "deps: [example.com/acme/a@v1.0.0]\ngenerate:\n  inputs:\n    - git_repo: {url: example.com/acme/c@v1.0.0}\n")
+	repo := &mockRepository{fetched: make(map[string]modules.Fetched)}
+	for _, source := range []string{"example.com/acme/a", "example.com/acme/b", "example.com/acme/c"} {
+		repo.fetched[source+"@v1.0.0"] = modules.Fetched{
+			Module: v1.Module{Name: source, Roots: []string{"."}},
+			Lock:   v1.LockedModule{Source: source, Version: "v1.0.0", Commit: testCommit, Hash: testNewHash},
+		}
+	}
+	plan, err := Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api", ResolveLock: true, Repository: repo})
+	require.NoError(t, err)
+	var generation v1.Generate
+	require.NoError(t, yaml.Unmarshal(outputContent(t, plan, "easyp.gen.yaml"), &generation))
+	assert.Equal(t, []string{"example.com/acme/c"}, generation.Generate.Modules)
+	candidate := string(outputContent(t, plan, "protobuf.mod"))
+	assert.Contains(t, candidate, "require example.com/acme/a v1.0.0")
+	assert.Contains(t, candidate, "require example.com/acme/b v1.0.0 // indirect")
+	assert.Contains(t, candidate, "require example.com/acme/c v1.0.0")
+	require.NoError(t, plan.Apply())
+	assert.Equal(t, legacy, string(mustRead(t, root, "protobuf.mod.v0.bak")))
+	for _, name := range []string{"protobuf.mod", "protobuf.mod.v0.bak"} {
+		info, err := os.Stat(filepath.Join(root, name))
+		require.NoError(t, err)
+		assert.Equal(t, os.FileMode(0o640), info.Mode().Perm())
+	}
+	second, err := Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api"})
+	require.NoError(t, err)
+	assert.True(t, second.AlreadyV1())
+	require.NoError(t, second.Apply())
+}
+
+func TestDirectoryPathIsRelativeToRoot(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct{ name, extra, wantError string }{
+		{name: "same_import_names"},
+		{name: "scope_widening", extra: "proto/other.proto", wantError: "scope"},
+		{name: "hidden_scope_narrowing", extra: "proto/api/.hidden/extra.proto", wantError: "scope"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeFixture(t, root, "easyp.yaml", "generate:\n  inputs: [{directory: {root: proto, path: api}}]\n")
+			writeFixture(t, root, "proto/api/a.proto", "syntax = \"proto3\";\n")
+			if tt.extra != "" {
+				writeFixture(t, root, tt.extra, "syntax = \"proto3\";\n")
+			}
+			plan, err := Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api"})
+			if tt.wantError != "" {
+				require.ErrorContains(t, err, tt.wantError)
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, map[string]string{"api/a.proto": filepath.Join("proto", "api", "a.proto")}, plan.sources)
+			assert.Equal(t, []string{"proto"}, plan.roots)
+		})
+	}
+}
+
+func TestOutputCopiesCannotChangeApplication(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeFixture(t, root, "easyp.yaml", "lint: {}\n")
+	plan, err := Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api"})
+	require.NoError(t, err)
+	for _, output := range plan.Outputs() {
+		for i := range output.Content {
+			output.Content[i] = 'X'
+		}
+	}
+	require.NoError(t, plan.Apply())
+	assert.Contains(t, string(mustRead(t, root, "easyp.yaml")), "version: v1")
+}
diff --git a/internal/migration/migration.go b/internal/migration/migration.go
new file mode 100644
index 00000000..a4616485
--- /dev/null
+++ b/internal/migration/migration.go
@@ -0,0 +1,399 @@
+// Package migration plans explicit, conservative EasyP v0 to v1 migrations.
+// Build is read-only unless ResolveLock explicitly permits repository/cache
+// access. It never invokes generation plugins or expands environment variables.
+// Apply stages all outputs and byte-identical legacy backups before replacing
+// anything, rechecks observed files, and rolls back ordinary application errors.
+//
+// Multiple filesystem renames are not a crash-atomic transaction. Process or
+// machine failure during Apply may leave a partially migrated set; the legacy
+// .v0.bak files and immutable easyp.lock are the recovery inputs. A failed
+// rollback retains its private staging directory and reports its location.
+// Noncooperating writers cannot be excluded between the final state check and
+// rename; callers should stop other writers while applying a migration.
+package migration
+
+import (
+	"bytes"
+	"context"
+	"errors"
+	"fmt"
+	"maps"
+	"os"
+	"slices"
+	"strings"
+
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+// Options identifies the legacy project and explicitly authorizes optional
+// dependency resolution. Repository is unused unless ResolveLock is true.
+type Options struct {
+	Dir         string
+	Module      string
+	ResolveLock bool
+	Repository  Repository
+}
+
+// Output is one complete candidate file, including historical backups.
+type Output struct {
+	Name      string
+	Content   []byte
+	Mode      os.FileMode
+	Unchanged bool
+}
+
+// Plan owns immutable candidate contents and the observed source state.
+// Use Outputs to preview, then Apply to opt into writing that exact plan.
+// A Plan is not safe for concurrent use.
+type Plan struct {
+	tx        *transaction
+	outputs   []Output
+	warnings  []string
+	blocked   string
+	alreadyV1 bool
+	inputs    []legacyDirectory
+	roots     []string
+	sources   map[string]string
+}
+
+// Outputs returns copies of all candidate files; mutating them cannot alter Apply.
+func (p *Plan) Outputs() []Output {
+	result := slices.Clone(p.outputs)
+	for i := range result {
+		result[i].Content = bytes.Clone(result[i].Content)
+	}
+	return result
+}
+
+// Warnings returns migration caveats, including prerequisites for application.
+func (p *Plan) Warnings() []string { return slices.Clone(p.warnings) }
+
+// AlreadyV1 reports a validated native project for which migration is a no-op.
+func (p *Plan) AlreadyV1() bool { return p.alreadyV1 }
+
+// NeedsLockResolution reports whether dependency verification must be explicitly
+// authorized before this preview can be applied. It never performs resolution.
+func (p *Plan) NeedsLockResolution() bool { return p.blocked != "" }
+
+// ValidateModuleIdentity checks a proposed local identity without reading or
+// writing project files. Interactive callers can correct input before planning.
+func ValidateModuleIdentity(identity string) error { return validIdentity(identity) }
+
+// CheckUnchanged verifies that a preview still describes the observed project.
+// It performs no writes or dependency access and does not replace Apply's checks.
+func (p *Plan) CheckUnchanged() (resultErr error) {
+	if err := p.verifySourceSelection(); err != nil {
+		return fmt.Errorf("verifySourceSelection: %w", err)
+	}
+	root, err := p.tx.openRoot()
+	if err != nil {
+		return fmt.Errorf("openRoot: %w", err)
+	}
+	defer func() { resultErr = errors.Join(resultErr, closeRoot(root)) }()
+	if err := p.tx.verify(root); err != nil {
+		return fmt.Errorf("verify: %w", err)
+	}
+	return nil
+}
+
+// Apply writes the prepared candidates after checking all application gates and
+// source state again. It never resolves or refreshes dependencies.
+func (p *Plan) Apply() error {
+	if p.blocked != "" {
+		return fmt.Errorf("%s", p.blocked)
+	}
+	if err := p.verifySourceSelection(); err != nil {
+		return fmt.Errorf("verifySourceSelection: %w", err)
+	}
+	if err := p.tx.apply(); err != nil {
+		return fmt.Errorf("apply: %w", err)
+	}
+	return nil
+}
+
+func (p *Plan) verifySourceSelection() error {
+	if len(p.inputs) > 0 {
+		sources, err := proveLocalSelection(p.tx.root, p.inputs, p.roots)
+		if err != nil {
+			return fmt.Errorf("proveLocalSelection: %w", err)
+		}
+		if !maps.Equal(sources, p.sources) {
+			return fmt.Errorf("local .proto source selection changed since planning; preview again")
+		}
+	}
+	return nil
+}
+
+// Build prepares policy, generation, manifest and (when authorized) lock files.
+// Unknown or unrepresentable legacy behavior is an error, never a lossy guess.
+func Build(ctx context.Context, options Options) (*Plan, error) {
+	if err := validIdentity(options.Module); err != nil {
+		return nil, fmt.Errorf("validIdentity: %w", err)
+	}
+	if options.Dir == "" {
+		options.Dir = "."
+	}
+	tx, err := newTransaction(options.Dir)
+	if err != nil {
+		return nil, fmt.Errorf("newTransaction: %w", err)
+	}
+	p := &Plan{tx: tx}
+	for _, name := range []string{v1.PolicyFile, v1.GenerateFile, v1.ModuleFile, v1.LockFile, "easyp.lock", "easyp.yaml.v0.bak", "protobuf.mod.v0.bak"} {
+		if _, err := tx.capture(name); err != nil {
+			return nil, fmt.Errorf("capture: %w", err)
+		}
+	}
+	policy := tx.expected[v1.PolicyFile]
+	if !policy.exists {
+		return nil, fmt.Errorf("easyp.yaml is missing from %s", options.Dir)
+	}
+	node, err := document(policy.data)
+	if err != nil {
+		return nil, fmt.Errorf("document: %w", err)
+	}
+	if nativePolicy(node) {
+		if err := p.checkNative(options.Module); err != nil {
+			return nil, fmt.Errorf("checkNative: %w", err)
+		}
+		p.alreadyV1 = true
+		p.warnings = append(p.warnings, "Already v1: no files changed and no dependencies refreshed.")
+		return p, nil
+	}
+	cfg, legacyWarnings, err := parseLegacy(policy.data)
+	if err != nil {
+		return nil, fmt.Errorf("parseLegacy: %w", err)
+	}
+	p.warnings = append(p.warnings, legacyWarnings...)
+	roots, inputs, err := localRoots(cfg)
+	if err != nil {
+		return nil, fmt.Errorf("localRoots: %w", err)
+	}
+	p.roots, p.inputs = roots, inputs
+	p.tx.beforeApply = p.verifySourceSelection
+	if err := checkManagedLocal(cfg, options.Module, len(inputs) > 0); err != nil {
+		return nil, fmt.Errorf("checkManagedLocal: %w", err)
+	}
+	p.sources, err = proveLocalSelection(tx.root, inputs, roots)
+	if err != nil {
+		return nil, fmt.Errorf("proveLocalSelection: %w", err)
+	}
+	for _, source := range p.sources {
+		if _, err := tx.capture(source); err != nil {
+			return nil, fmt.Errorf("capture: %w", err)
+		}
+	}
+	deps := requirements{}
+	for _, dep := range cfg.Deps {
+		if err := deps.add(dep, false); err != nil {
+			return nil, fmt.Errorf("add: %w", err)
+		}
+	}
+	var selected []string
+	if len(inputs) > 0 {
+		selected = append(selected, options.Module)
+	}
+	for _, input := range cfg.Generate.Inputs {
+		if input.GitRepo == nil {
+			continue
+		}
+		git := input.GitRepo
+		if (git.Root != "" && git.Root != ".") || (git.SubDirectory != "" && git.SubDirectory != ".") {
+			return nil, fmt.Errorf("git_repo custom root/sub_directory requires manual migration; an entire dependency module cannot represent this selection")
+		}
+		if err := deps.add(git.URL, false); err != nil {
+			return nil, fmt.Errorf("add: %w", err)
+		}
+		name, _, _ := strings.Cut(git.URL, "@")
+		if !slices.Contains(selected, name) {
+			selected = append(selected, name)
+		}
+	}
+	manifest := tx.expected[v1.ModuleFile]
+	nativeManifest := manifest.exists && v1.IsModuleManifest(manifest.data)
+	var replacements []v1.Replacement
+	if manifest.exists && !nativeManifest {
+		replacements, err = parseManifest(manifest.data, &deps)
+		if err != nil {
+			return nil, fmt.Errorf("parseManifest: %w", err)
+		}
+	}
+	moduleRoots := slices.Clone(roots)
+	if len(moduleRoots) == 0 {
+		moduleRoots = []string{"."}
+	}
+	module := v1.Module{Name: options.Module, Roots: moduleRoots, Requires: deps.items, Replaces: replacements}
+	for _, req := range module.Requires {
+		if req.Module == module.Name {
+			return nil, fmt.Errorf("dependency %s has the new local module identity; reconcile this ambiguity manually", req.Module)
+		}
+	}
+	moduleBytes := formatManifest(module, deps.indirect)
+	if _, err := v1.ParseModule(bytes.NewReader(moduleBytes)); err != nil {
+		return nil, fmt.Errorf("ParseModule: %w", err)
+	}
+	if nativeManifest && !bytes.Equal(manifest.data, moduleBytes) {
+		return nil, fmt.Errorf("existing native protobuf.mod conflicts with the migration candidate; reconcile it manually (it will not be overwritten)")
+	}
+	policyBytes, err := convertPolicy(cfg)
+	if err != nil {
+		return nil, fmt.Errorf("convertPolicy: %w", err)
+	}
+	generateBytes, err := convertGenerate(cfg, selected)
+	if err != nil {
+		return nil, fmt.Errorf("convertGenerate: %w", err)
+	}
+	if err := validatePolicy(policyBytes); err != nil {
+		return nil, fmt.Errorf("validatePolicy: %w", err)
+	}
+	if err := validateGenerate(generateBytes); err != nil {
+		return nil, fmt.Errorf("validateGenerate: %w", err)
+	}
+	// Preflight every local destination before any explicitly allowed cache work.
+	if err := p.addOutput(v1.PolicyFile, policyBytes, true); err != nil {
+		return nil, fmt.Errorf("addOutput: %w", err)
+	}
+	if err := p.addOutput(v1.GenerateFile, generateBytes, false); err != nil {
+		return nil, fmt.Errorf("addOutput: %w", err)
+	}
+	if err := p.addOutput(v1.ModuleFile, moduleBytes, manifest.exists && !nativeManifest); err != nil {
+		return nil, fmt.Errorf("addOutput: %w", err)
+	}
+	oldLock := tx.expected["easyp.lock"]
+	pins := make(map[string]legacyPin)
+	if oldLock.exists {
+		pins, err = parseLegacyLock(oldLock.data)
+		if err != nil {
+			return nil, fmt.Errorf("parseLegacyLock: %w", err)
+		}
+		for _, req := range module.Requires {
+			if _, exists := pins[req.Module]; !exists {
+				return nil, fmt.Errorf("legacy easyp.lock is missing required dependency %s; recover its historical pin before migration", req.Module)
+			}
+		}
+		p.warnings = append(p.warnings, "easyp.lock is retained byte-for-byte as a historical backup; it is never rewritten or removed.")
+	}
+	if nativeLock := tx.expected[v1.LockFile]; nativeLock.exists {
+		if _, err := validateNativeLock(nativeLock.data); err != nil {
+			return nil, fmt.Errorf("validateNativeLock: %w", err)
+		}
+	}
+	needsLock := len(module.Requires) > 0 || len(pins) > 0 || len(module.Replaces) > 0
+	if needsLock && !options.ResolveLock {
+		p.blocked = "dependency integrity/lock verification is required before writing; preview again with --resolve-lock (this explicitly permits repository/cache access)"
+		p.warnings = append(p.warnings, "protobuf.lock cannot be prepared without --resolve-lock; --write is blocked until every required pin and legacy hash is verified.")
+	} else if needsLock {
+		lock, err := migrateLock(ctx, module, pins, oldLock.exists, options.Repository)
+		if err != nil {
+			return nil, fmt.Errorf("migrateLock: %w", err)
+		}
+		content, err := yaml.Marshal(lock)
+		if err != nil {
+			return nil, fmt.Errorf("Marshal: %w", err)
+		}
+		if err := p.addOutput(v1.LockFile, content, false); err != nil {
+			return nil, fmt.Errorf("addOutput: %w", err)
+		}
+	} else if nativeLock := tx.expected[v1.LockFile]; nativeLock.exists {
+		lock, err := validateNativeLock(nativeLock.data)
+		if err != nil {
+			return nil, fmt.Errorf("validateNativeLock: %w", err)
+		}
+		if len(lock.Modules) != 0 {
+			return nil, fmt.Errorf("existing native protobuf.lock contains dependencies absent from the migration candidate; it will not be overwritten")
+		}
+	}
+	if !needsLock && !tx.expected[v1.LockFile].exists {
+		content, err := yaml.Marshal(v1.Lock{Version: 1, Modules: []v1.LockedModule{}})
+		if err != nil {
+			return nil, fmt.Errorf("Marshal: %w", err)
+		}
+		if err := p.addOutput(v1.LockFile, content, false); err != nil {
+			return nil, fmt.Errorf("addOutput: %w", err)
+		}
+	}
+	p.warnings = append(p.warnings, "Relative paths and variable placeholders are preserved; no plugin is executed. Stop other writers before applying; multiple file replacements are not process-crash atomic.")
+	return p, nil
+}
+
+func (p *Plan) addOutput(name string, content []byte, replaceLegacy bool) error {
+	current, err := p.tx.capture(name)
+	if err != nil {
+		return fmt.Errorf("capture: %w", err)
+	}
+	mode := os.FileMode(0o644)
+	if current.exists {
+		mode = current.mode
+	}
+	unchanged := current.exists && bytes.Equal(current.data, content)
+	if current.exists && !unchanged && !replaceLegacy {
+		return fmt.Errorf("existing %s conflicts with the migration candidate; it will not be overwritten", name)
+	}
+	if replaceLegacy && !unchanged {
+		if err := p.addOutput(name+".v0.bak", current.data, false); err != nil {
+			return fmt.Errorf("addOutput: %w", err)
+		}
+		backup := &p.outputs[len(p.outputs)-1]
+		// A pre-existing backup must match both bytes and permissions exactly.
+		if backup.Unchanged && backup.Mode != mode {
+			return fmt.Errorf("existing %s.v0.bak has different permissions; it will not be overwritten", name)
+		}
+		backup.Mode = mode
+		if !backup.Unchanged {
+			p.tx.changes[len(p.tx.changes)-1].mode = mode
+		}
+	}
+	p.outputs = append(p.outputs, Output{Name: name, Content: bytes.Clone(content), Mode: mode, Unchanged: unchanged})
+	if !unchanged {
+		p.tx.changes = append(p.tx.changes, fileChange{name: name, content: bytes.Clone(content), mode: mode})
+	}
+	return nil
+}
+
+func nativePolicy(node *yaml.Node) bool {
+	for i := 0; i < len(node.Content); i += 2 {
+		key := node.Content[i].Value
+		if key == "linters" || key == "linters-settings" || key == "issues" || (key == "version" && node.Content[i+1].Value == "v1") {
+			return true
+		}
+	}
+	return false
+}
+
+func (p *Plan) checkNative(identity string) error {
+	if err := validatePolicy(p.tx.expected[v1.PolicyFile].data); err != nil {
+		return fmt.Errorf("validatePolicy: %w", err)
+	}
+	manifest := p.tx.expected[v1.ModuleFile]
+	if !manifest.exists {
+		return fmt.Errorf("already-v1 policy requires a native protobuf.mod; reconcile this partial migration manually")
+	}
+	module, err := v1.ParseModule(bytes.NewReader(manifest.data))
+	if err != nil {
+		return fmt.Errorf("ParseModule: %w", err)
+	}
+	if module.Name != identity {
+		return fmt.Errorf("native protobuf.mod module is %s, not the requested identity %s", module.Name, identity)
+	}
+	gen := p.tx.expected[v1.GenerateFile]
+	if !gen.exists {
+		return fmt.Errorf("already-v1 policy requires easyp.gen.yaml; reconcile this partial migration manually")
+	}
+	if err := validateGenerate(gen.data); err != nil {
+		return fmt.Errorf("validateGenerate: %w", err)
+	}
+	if lock := p.tx.expected[v1.LockFile]; lock.exists {
+		parsed, err := validateNativeLock(lock.data)
+		if err != nil {
+			return fmt.Errorf("validateNativeLock: %w", err)
+		}
+		if err := modules.ValidateRequirements(modules.RemoteRequirements(module), parsed); err != nil {
+			return fmt.Errorf("ValidateRequirements: %w", err)
+		}
+	} else if len(modules.RemoteRequirements(module)) > 0 {
+		return fmt.Errorf("native protobuf.lock is missing; repair this partial migration explicitly before proceeding")
+	}
+	return nil
+}
diff --git a/internal/migration/migration_test.go b/internal/migration/migration_test.go
new file mode 100644
index 00000000..8e3e46cd
--- /dev/null
+++ b/internal/migration/migration_test.go
@@ -0,0 +1,329 @@
+package migration
+
+import (
+	"bytes"
+	"context"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/core"
+	"github.com/easyp-tech/easyp/internal/rules"
+)
+
+func TestBuildAndApply(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct {
+		name   string
+		legacy string
+	}{
+		{name: "empty_rule_set", legacy: "lint: {}\n"},
+		{name: "single_rule", legacy: "lint:\n  use: [SERVICE_SUFFIX]\n"},
+		{name: "default_group", legacy: "lint:\n  use: [DEFAULT]\n  except: [SERVICE_SUFFIX]\n"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeFixture(t, root, "easyp.yaml", tt.legacy)
+			require.NoError(t, os.Chmod(filepath.Join(root, "easyp.yaml"), 0o640))
+			plan, err := Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api"})
+			require.NoError(t, err)
+			entries, err := os.ReadDir(root)
+			require.NoError(t, err)
+			assert.Len(t, entries, 1, "preview must not create backups or staging files")
+			var policy v1.Policy
+			require.NoError(t, yaml.Unmarshal(outputContent(t, plan, "easyp.yaml"), &policy))
+			assert.Equal(t, "MINIMAL", policy.Linters.Default)
+			require.NotNil(t, policy.Linters.AllowCommentIgnores)
+			assert.False(t, *policy.Linters.AllowCommentIgnores)
+			cfg, err := policy.LintConfig()
+			require.NoError(t, err)
+			actual, _, err := rules.New(cfg)
+			require.NoError(t, err)
+			legacy, _, err := parseLegacy([]byte(tt.legacy))
+			require.NoError(t, err)
+			expected, _, err := rules.New(legacy.Lint)
+			require.NoError(t, err)
+			assert.ElementsMatch(t, ruleNames(expected), ruleNames(actual))
+			require.NoError(t, plan.Apply())
+			backup, err := os.ReadFile(filepath.Join(root, "easyp.yaml.v0.bak"))
+			require.NoError(t, err)
+			assert.Equal(t, tt.legacy, string(backup))
+			for _, name := range []string{"easyp.yaml", "easyp.yaml.v0.bak"} {
+				info, err := os.Stat(filepath.Join(root, name))
+				require.NoError(t, err)
+				assert.Equal(t, os.FileMode(0o640), info.Mode().Perm())
+			}
+			second, err := Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api", ResolveLock: true})
+			require.NoError(t, err)
+			assert.True(t, second.AlreadyV1())
+			require.NoError(t, second.Apply())
+			assert.Equal(t, tt.legacy, string(mustRead(t, root, "easyp.yaml.v0.bak")))
+		})
+	}
+}
+
+func TestSettingsTransfer(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	legacy := `lint:
+  use: [MINIMAL, BASIC, DEFAULT]
+  except: [PACKAGE_DIRECTORY_MATCH]
+  ignore: [generated]
+  ignore_only:
+    DEFAULT: [old]
+  enum_zero_value_suffix: ZERO
+  service_suffix: API
+  allow_comment_ignores: true
+breaking:
+  ignore: [old]
+  use: [FILE]
+  against_git_ref: release
+generate:
+  inputs:
+    - directory: {root: proto, path: .}
+  plugins:
+    - command: [./generator, "${TOKEN}"]
+      out: ../generated
+      opts: {paths: source_relative, token: "${TOKEN}", repeated: [a, b]}
+      with_imports: true
+    - remote: registry.example.com/go:v1.2.3
+      out: gen
+  managed:
+    enabled: true
+    disable:
+      - module: example.com/dependency
+        file_option: go_package
+    override:
+      - file_option: go_package_prefix
+        value: "${GO_PREFIX}"
+        path: foo
+`
+	writeFixture(t, root, "easyp.yaml", legacy)
+	writeFixture(t, root, "proto/foo/a.proto", "syntax = \"proto3\";\n")
+	plan, err := Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api"})
+	require.NoError(t, err)
+	var policy v1.Policy
+	require.NoError(t, yaml.Unmarshal(outputContent(t, plan, "easyp.yaml"), &policy))
+	assert.Equal(t, "ZERO", policy.LinterSettings["ENUM_ZERO_VALUE_SUFFIX"]["suffix"])
+	assert.Equal(t, "API", policy.LinterSettings["SERVICE_SUFFIX"]["suffix"])
+	assert.True(t, *policy.Linters.AllowCommentIgnores)
+	assert.Equal(t, "git:release", policy.Breaking.Baseline)
+	assert.Equal(t, []string{"FILE"}, policy.Breaking.Categories)
+	assert.Equal(t, []string{"old"}, policy.Breaking.Ignore)
+	assert.Contains(t, policy.Issues.ExcludeRules, v1.IssueExcludeRule{Path: "generated"})
+	var gen v1.Generate
+	require.NoError(t, yaml.Unmarshal(outputContent(t, plan, "easyp.gen.yaml"), &gen))
+	require.Len(t, gen.Plugins, 2)
+	assert.Equal(t, []string{"./generator", "${TOKEN}"}, gen.Plugins[0].Command)
+	assert.Equal(t, "../generated", gen.Plugins[0].Out)
+	assert.Equal(t, []string{"${TOKEN}"}, gen.Plugins[0].Opts["token"])
+	assert.Equal(t, []string{"a", "b"}, gen.Plugins[0].Opts["repeated"])
+	assert.True(t, gen.Plugins[0].WithImports)
+	assert.Equal(t, "registry.example.com/go", gen.Plugins[1].Remote)
+	assert.Equal(t, "v1.2.3", gen.Plugins[1].Version)
+	assert.Equal(t, "${GO_PREFIX}", gen.Generate.Managed.Override[0].Value)
+	assert.Equal(t, "foo", gen.Generate.Managed.Override[0].Path)
+	assert.Equal(t, []string{"example.com/acme/api"}, gen.Generate.Modules)
+	module, err := v1.ParseModule(bytes.NewReader(outputContent(t, plan, "protobuf.mod")))
+	require.NoError(t, err)
+	assert.Equal(t, []string{"proto"}, module.Roots)
+}
+
+func TestRejectedInputsDoNotWrite(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct{ name, input, want string }{
+		{name: "multi_document", input: "lint: {}\n---\nlint: {}\n", want: "one YAML document"},
+		{name: "null", input: "null\n", want: "null"},
+		{name: "nested_null", input: "generate: {plugins: null}\n", want: "null"},
+		{name: "empty", input: "", want: "empty"},
+		{name: "alias", input: "lint: &lint {}\nbreaking: *lint\n", want: "alias"},
+		{name: "duplicate", input: "lint: {}\nlint: {}\n", want: "duplicate"},
+		{name: "sliced", input: "generate:\n  inputs: [{directory: {root: ., path: selected}}]\n", want: "scope"},
+		{name: "external", input: "generate:\n  inputs: [{directory: {root: ../external, path: .}}]\n", want: "manual"},
+		{name: "placeholder", input: "generate:\n  inputs: [{directory: '${ROOT}'}]\n", want: "placeholder"},
+		{name: "git_slice", input: "generate:\n  inputs: [{git_repo: {url: example.com/acme/deps, sub_directory: api}}]\n", want: "manual"},
+		{name: "unsupported_ref", input: "deps: [example.com/acme/deps@main]\n", want: "full Git commit"},
+		{name: "unpinned_remote", input: "generate:\n  inputs: [{directory: .}]\n  plugins: [{remote: registry/go:latest, out: gen}]\n", want: "semantic version"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeFixture(t, root, "easyp.yaml", tt.input)
+			writeFixture(t, root, "selected/a.proto", "syntax = \"proto3\";\n")
+			writeFixture(t, root, "other.proto", "syntax = \"proto3\";\n")
+			_, err := Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api"})
+			require.ErrorContains(t, err, tt.want)
+			assert.Equal(t, tt.input, string(mustRead(t, root, "easyp.yaml")))
+			for _, name := range []string{"protobuf.mod", "easyp.gen.yaml", "easyp.yaml.v0.bak"} {
+				_, err := os.Stat(filepath.Join(root, name))
+				assert.ErrorIs(t, err, os.ErrNotExist)
+			}
+		})
+	}
+}
+
+func TestPlanConflictsAndChanges(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct{ name, existing, changed string }{
+		{name: "output_conflict", existing: "easyp.gen.yaml"},
+		{name: "backup_conflict", existing: "easyp.yaml.v0.bak"},
+		{name: "native_manifest", existing: "protobuf.mod"},
+		{name: "source_changed", changed: "easyp.yaml"},
+		{name: "output_created", changed: "easyp.gen.yaml"},
+		{name: "proto_added", changed: "new.proto"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			legacy := "generate:\n  inputs: [{directory: .}]\n"
+			writeFixture(t, root, "easyp.yaml", legacy)
+			if tt.existing != "" {
+				writeFixture(t, root, tt.existing, "module example.com/other/api\n")
+			}
+			plan, err := Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api"})
+			if tt.existing != "" {
+				require.Error(t, err)
+				assert.Equal(t, legacy, string(mustRead(t, root, "easyp.yaml")))
+				return
+			}
+			require.NoError(t, err)
+			writeFixture(t, root, tt.changed, "changed\n")
+			require.Error(t, plan.Apply())
+			_, err = os.Stat(filepath.Join(root, "protobuf.mod"))
+			assert.ErrorIs(t, err, os.ErrNotExist)
+		})
+	}
+}
+
+func TestProtoAddedDuringStaging(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	legacy := "generate:\n  inputs: [{directory: .}]\n"
+	writeFixture(t, root, "easyp.yaml", legacy)
+	plan, err := Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api"})
+	require.NoError(t, err)
+	originalStage := plan.tx.stage
+	plan.tx.stage = func(fsroot *os.Root, name string, content []byte, mode os.FileMode) error {
+		writeFixture(t, root, "added.proto", "syntax = \"proto3\";\n")
+		return originalStage(fsroot, name, content, mode)
+	}
+	require.ErrorContains(t, plan.Apply(), "source selection changed")
+	assert.Equal(t, legacy, string(mustRead(t, root, "easyp.yaml")))
+	_, err = os.Stat(filepath.Join(root, "protobuf.mod"))
+	assert.ErrorIs(t, err, os.ErrNotExist)
+	entries, err := filepath.Glob(filepath.Join(root, ".easyp-migrate-*"))
+	require.NoError(t, err)
+	assert.Empty(t, entries)
+}
+
+func TestManagedModuleSelectorSafety(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct {
+		name, selector     string
+		enabled, wantError bool
+	}{
+		{name: "new_local_identity", selector: "example.com/acme/api", enabled: true, wantError: true},
+		{name: "unknown_selector", selector: "${MODULE}", enabled: true, wantError: true},
+		{name: "dependency_selector", selector: "example.com/acme/dep", enabled: true},
+		{name: "disabled_mode", selector: "example.com/acme/api", enabled: false},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			enabled := "false"
+			if tt.enabled {
+				enabled = "true"
+			}
+			legacy := "generate:\n  inputs: [{directory: .}]\n  managed:\n    enabled: " + enabled + "\n    override:\n      - {module: '" + tt.selector + "', file_option: go_package_prefix, value: api}\n"
+			writeFixture(t, root, "easyp.yaml", legacy)
+			_, err := Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api"})
+			if tt.wantError {
+				require.ErrorContains(t, err, "managed module selector")
+				return
+			}
+			require.NoError(t, err)
+		})
+	}
+}
+
+func TestNativeNoOpValidation(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct {
+		name, policy, gen, manifest, lock string
+		wantError                         bool
+	}{
+		{name: "valid_option_list", gen: "version: v1\nplugins: [{name: go, out: gen, opts: [paths=source_relative]}]\n"},
+		{name: "bad_plugin", gen: "version: v1\nplugins: [{name: go}]\n", wantError: true},
+		{name: "unknown_preset", policy: "version: v1\nlinters: {default: MADE_UP}\n", wantError: true},
+		{name: "missing_lock", manifest: "module example.com/acme/api\nrequire example.com/acme/dep v2.0.0\n", wantError: true},
+		{name: "mismatched_lock", manifest: "module example.com/acme/api\nrequire example.com/acme/dep v2.0.0\n", lock: "version: 1\nmodules:\n  - {source: example.com/acme/dep, version: v1.0.0, commit: '" + testCommit + "', hash: '" + testHash + "'}\n", wantError: true},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			if tt.policy == "" {
+				tt.policy = "version: v1\n"
+			}
+			if tt.gen == "" {
+				tt.gen = "version: v1\nplugins: []\n"
+			}
+			if tt.manifest == "" {
+				tt.manifest = "module example.com/acme/api\n"
+			}
+			writeFixture(t, root, "easyp.yaml", tt.policy)
+			writeFixture(t, root, "easyp.gen.yaml", tt.gen)
+			writeFixture(t, root, "protobuf.mod", tt.manifest)
+			if tt.lock != "" {
+				writeFixture(t, root, "protobuf.lock", tt.lock)
+			}
+			plan, err := Build(context.Background(), Options{Dir: root, Module: "example.com/acme/api", ResolveLock: true})
+			if tt.wantError {
+				require.Error(t, err)
+				return
+			}
+			require.NoError(t, err)
+			assert.True(t, plan.AlreadyV1())
+			require.NoError(t, plan.Apply())
+			assert.Equal(t, tt.gen, string(mustRead(t, root, "easyp.gen.yaml")))
+		})
+	}
+}
+
+func writeFixture(t *testing.T, root, name, content string) {
+	t.Helper()
+	path := filepath.Join(root, name)
+	require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+	require.NoError(t, os.WriteFile(path, []byte(content), 0o600))
+}
+
+func mustRead(t *testing.T, root, name string) []byte {
+	t.Helper()
+	data, err := os.ReadFile(filepath.Join(root, name))
+	require.NoError(t, err)
+	return data
+}
+
+func outputContent(t *testing.T, plan *Plan, name string) []byte {
+	t.Helper()
+	for _, output := range plan.Outputs() {
+		if output.Name == name {
+			return output.Content
+		}
+	}
+	t.Fatalf("missing candidate %s", name)
+	return nil
+}
+
+func ruleNames(input []core.Rule) []string {
+	var names []string
+	for _, rule := range input {
+		names = append(names, core.GetRuleName(rule))
+	}
+	return names
+}
diff --git a/internal/migration/policy_test.go b/internal/migration/policy_test.go
new file mode 100644
index 00000000..053c0160
--- /dev/null
+++ b/internal/migration/policy_test.go
@@ -0,0 +1,97 @@
+package migration
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestExclusionsPreserveLegacyLiteralAndPrefixSemantics(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct {
+		name, input string
+		match, miss []string
+	}{
+		{name: "directory", input: "lint: {ignore: [generated]}", match: []string{"generated/a.proto"}, miss: []string{"generated_extra/a.proto", "generated.proto"}},
+		{name: "literal_star", input: "lint: {ignore: ['*']}", match: []string{"*/a.proto"}, miss: []string{"a.proto", "other/a.proto"}},
+		{name: "literal_bracket", input: "lint: {ignore: ['[foo]']}", match: []string{"[foo]/a.proto"}, miss: []string{"f/a.proto"}},
+		{name: "prefix", input: "lint: {ignore_only: {SERVICE_SUFFIX: [generated]}}", match: []string{"generated/a.proto", "generated_extra/a.proto", "generated.proto"}, miss: []string{"other/a.proto"}},
+		{name: "slash_prefix", input: "lint: {ignore_only: {SERVICE_SUFFIX: ['foo.proto/']}}", match: []string{"foo.proto/a.proto", "foo.proto/a/b.proto"}, miss: []string{"foo.proto", "foo.proto2/a.proto"}},
+		{name: "prefix_literal_question", input: "lint: {ignore_only: {SERVICE_SUFFIX: ['foo?']}}", match: []string{"foo?.proto", "foo?bar/a.proto"}, miss: []string{"fooX.proto"}},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			legacy, _, err := parseLegacy([]byte(tt.input))
+			require.NoError(t, err)
+			raw, err := convertPolicy(legacy)
+			require.NoError(t, err)
+			var p v1.Policy
+			require.NoError(t, yaml.Unmarshal(raw, &p))
+			for _, file := range tt.match {
+				rules, all, err := p.Issues.ExclusionsForPath(file)
+				require.NoError(t, err)
+				assert.True(t, all || len(rules) > 0, file)
+			}
+			for _, file := range tt.miss {
+				rules, all, err := p.Issues.ExclusionsForPath(file)
+				require.NoError(t, err)
+				assert.False(t, all || len(rules) > 0, file)
+			}
+		})
+	}
+}
+
+func TestPolicyBlocksImplicitInheritance(t *testing.T) {
+	t.Parallel()
+	raw, err := convertPolicy(legacyConfig{})
+	require.NoError(t, err)
+	var mapping map[string]any
+	require.NoError(t, yaml.Unmarshal(raw, &mapping))
+	for _, key := range []string{"linters", "linters-settings", "issues", "breaking"} {
+		assert.Contains(t, mapping, key)
+	}
+}
+
+func TestUnknownLegacyFieldsAreReportedAndIgnored(t *testing.T) {
+	t.Parallel()
+	legacy, warnings, err := parseLegacy([]byte("breaking: {ignore_unstable: true}\n"))
+	require.NoError(t, err)
+	assert.Empty(t, legacy.Breaking.Ignore)
+	require.Len(t, warnings, 1)
+	assert.Contains(t, warnings[0], "config.breaking.ignore_unstable")
+	assert.Contains(t, warnings[0], "ignored by v0")
+}
+
+func TestLegacyCompatibilityMetadata(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name        string
+		input       string
+		want        string
+		wantDeps    int
+		wantVersion string
+	}{
+		{name: "version", input: "version: v1alpha\n", want: "legacy version \"v1alpha\"", wantVersion: "v1alpha"},
+		{name: "nullable deps", input: "deps:\n", want: "empty dependency list"},
+		{name: "unknown nested key", input: "lint: {use: [DEFAULT], future_key: true}\n", want: "config.lint.future_key"},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			cfg, warnings, err := parseLegacy([]byte(tt.input))
+			require.NoError(t, err)
+			assert.Equal(t, tt.wantVersion, cfg.Version)
+			assert.Len(t, cfg.Deps, tt.wantDeps)
+			require.NotEmpty(t, warnings)
+			assert.Contains(t, strings.Join(warnings, "\n"), tt.want)
+		})
+	}
+}
diff --git a/internal/migration/roots.go b/internal/migration/roots.go
new file mode 100644
index 00000000..117928f0
--- /dev/null
+++ b/internal/migration/roots.go
@@ -0,0 +1,129 @@
+package migration
+
+import (
+	"fmt"
+	"io/fs"
+	"maps"
+	"os"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	"github.com/easyp-tech/easyp/internal/core/path_helpers"
+)
+
+func localRoots(cfg legacyConfig) ([]string, []legacyDirectory, error) {
+	var roots []string
+	var inputs []legacyDirectory
+	for _, input := range cfg.Generate.Inputs {
+		if input.Directory == nil {
+			continue
+		}
+		dir := *input.Directory
+		if dir.Path == "" {
+			dir.Path = "."
+		}
+		if dir.Root == "" {
+			dir.Root = "."
+		}
+		for _, value := range []string{dir.Path, dir.Root} {
+			if strings.Contains(value, "$") {
+				return nil, nil, fmt.Errorf("directory placeholder %q prevents safe source analysis; supply a literal path or migrate manually", value)
+			}
+			if !filepath.IsLocal(value) || strings.ContainsAny(value, "*?[]\\ \t\r\n#") {
+				return nil, nil, fmt.Errorf("directory %q is external or sliced; manual migration is required to preserve import paths", value)
+			}
+		}
+		dir.Root = filepath.Clean(dir.Root)
+		dir.Path = filepath.Clean(dir.Path)
+		if !slices.Contains(roots, dir.Root) {
+			roots = append(roots, dir.Root)
+		}
+		inputs = append(inputs, dir)
+	}
+	if len(inputs) == 0 && len(cfg.Generate.Inputs) == 0 && len(cfg.Generate.Plugins) > 0 {
+		return nil, nil, fmt.Errorf("generation plugins have no legacy inputs; choose explicit inputs before migration to avoid widening scope")
+	}
+	return roots, inputs, nil
+}
+
+// proveLocalSelection compares both the physical files and their import names.
+// A subset can only migrate when whole v1 roots select exactly the same files.
+func proveLocalSelection(root string, inputs []legacyDirectory, roots []string) (map[string]string, error) {
+	legacy, current := make(map[string]string), make(map[string]string)
+	for _, input := range inputs {
+		importRoot := filepath.Join(root, input.Root)
+		search := filepath.Join(importRoot, input.Path)
+		if err := collectProto(root, importRoot, search, false, legacy); err != nil {
+			return nil, fmt.Errorf("collectProto: %w", err)
+		}
+	}
+	for _, moduleRoot := range roots {
+		importRoot := filepath.Join(root, moduleRoot)
+		if err := collectProto(root, importRoot, importRoot, true, current); err != nil {
+			return nil, fmt.Errorf("collectProto: %w", err)
+		}
+	}
+	if !maps.Equal(legacy, current) {
+		return nil, fmt.Errorf("v1 roots would change generation scope or .proto import names (including hidden/vendor/nested modules); split the module or reorganize legacy inputs manually; no v1 directory selection syntax can preserve this configuration")
+	}
+	return current, nil
+}
+
+func collectProto(root, importRoot, search string, native bool, files map[string]string) error {
+	// WalkDir does not follow links, but a linked starting directory/parent must
+	// also be rejected before traversal.
+	rel, err := filepath.Rel(root, search)
+	if err != nil {
+		return fmt.Errorf("Rel: %w", err)
+	}
+	part := root
+	for _, segment := range strings.Split(rel, string(filepath.Separator)) {
+		part = filepath.Join(part, segment)
+		info, err := os.Lstat(part)
+		if err != nil {
+			return fmt.Errorf("Lstat: %w", err)
+		}
+		if !info.IsDir() {
+			return fmt.Errorf("source %s is not a regular directory; manual migration required", part)
+		}
+	}
+	err = filepath.WalkDir(search, func(name string, entry fs.DirEntry, walkErr error) error {
+		if walkErr != nil {
+			return walkErr
+		}
+		if entry.Type()&os.ModeSymlink != 0 {
+			return fmt.Errorf("source symlink %s prevents safe scope analysis", name)
+		}
+		if entry.IsDir() {
+			if native && path_helpers.ShouldSkipV1SourceDir(importRoot, name) {
+				return filepath.SkipDir
+			}
+			return nil
+		}
+		if filepath.Ext(name) != ".proto" {
+			return nil
+		}
+		if !entry.Type().IsRegular() {
+			return fmt.Errorf("source %s is not a regular file", name)
+		}
+		importName, err := filepath.Rel(importRoot, name)
+		if err != nil {
+			return fmt.Errorf("Rel: %w", err)
+		}
+		physicalName, err := filepath.Rel(root, name)
+		if err != nil {
+			return fmt.Errorf("Rel: %w", err)
+		}
+		importName = filepath.ToSlash(importName)
+		if previous, ok := files[importName]; ok && previous != physicalName {
+			return fmt.Errorf("roots collide on import %s (%s and %s); manual migration required", importName, previous, physicalName)
+		}
+		files[importName] = physicalName
+		return nil
+	})
+	if err != nil {
+		return fmt.Errorf("WalkDir: %w", err)
+	}
+	return nil
+}
diff --git a/internal/migration/validate.go b/internal/migration/validate.go
new file mode 100644
index 00000000..1d1dcd16
--- /dev/null
+++ b/internal/migration/validate.go
@@ -0,0 +1,89 @@
+package migration
+
+import (
+	"fmt"
+	"strings"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func validatePolicy(raw []byte) error {
+	var policy v1.Policy
+	if err := decodeStrict(raw, &policy); err != nil {
+		return fmt.Errorf("decodeStrict: %w", err)
+	}
+	if policy.Version != "" && policy.Version != "v1" {
+		return fmt.Errorf("unsupported policy version %q", policy.Version)
+	}
+	switch policy.Linters.Default {
+	case "", "MINIMAL", "BASIC", "STANDARD", "COMMENTS":
+	default:
+		return fmt.Errorf("unknown v1 linter preset %q", policy.Linters.Default)
+	}
+	if _, err := policy.LintConfig(); err != nil {
+		return fmt.Errorf("LintConfig: %w", err)
+	}
+	if _, err := policy.BreakingConfig(""); err != nil {
+		return fmt.Errorf("BreakingConfig: %w", err)
+	}
+	if policy.Breaking.Baseline != "" && (!strings.HasPrefix(policy.Breaking.Baseline, "git:") || policy.Breaking.Baseline == "git:") {
+		return fmt.Errorf("breaking.baseline requires git:<ref>")
+	}
+	for _, settings := range policy.LinterSettings {
+		for key := range settings {
+			if key != "suffix" {
+				return fmt.Errorf("unknown linters-settings field %q", key)
+			}
+		}
+	}
+	return nil
+}
+
+func validateGenerate(raw []byte) error {
+	var gen v1.Generate
+	if err := decodeStrict(raw, &gen); err != nil {
+		return fmt.Errorf("decodeStrict: %w", err)
+	}
+	if gen.Version != "" && gen.Version != "v1" {
+		return fmt.Errorf("unsupported generation version %q", gen.Version)
+	}
+	if err := gen.Generate.Managed.Validate(); err != nil {
+		return fmt.Errorf("Validate: %w", err)
+	}
+	for _, plugin := range gen.Plugins {
+		if err := plugin.Validate(); err != nil {
+			return fmt.Errorf("Validate: %w", err)
+		}
+	}
+	return nil
+}
+
+func validateNativeLock(raw []byte) (v1.Lock, error) {
+	var lock v1.Lock
+	if err := decodeStrict(raw, &lock); err != nil {
+		return v1.Lock{}, fmt.Errorf("decodeStrict: %w", err)
+	}
+	if err := lock.Validate(); err != nil {
+		return v1.Lock{}, fmt.Errorf("Validate: %w", err)
+	}
+	return lock, nil
+}
+
+func checkManagedLocal(cfg legacyConfig, identity string, hasLocal bool) error {
+	if !hasLocal || !cfg.Generate.Managed.Enabled {
+		return nil
+	}
+	var selectors []string
+	for _, rule := range cfg.Generate.Managed.Disable {
+		selectors = append(selectors, rule.Module)
+	}
+	for _, rule := range cfg.Generate.Managed.Override {
+		selectors = append(selectors, rule.Module)
+	}
+	for _, selector := range selectors {
+		if selector == identity || strings.Contains(selector, "$") {
+			return fmt.Errorf("managed module selector %q may newly match local files named %s in v1 (v0 used an empty local identity); migrate this selector manually", selector, identity)
+		}
+	}
+	return nil
+}
diff --git a/internal/modules/bsr.go b/internal/modules/bsr.go
new file mode 100644
index 00000000..863d95e0
--- /dev/null
+++ b/internal/modules/bsr.go
@@ -0,0 +1,13 @@
+package modules
+
+import (
+	"context"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// BSRResolver chooses a pinned Git source while preserving the original Buf request.
+// Implementations may use local mappings or a service; the Git graph consumes the same requirement.
+type BSRResolver interface {
+	Resolve(context.Context, v1.BSRDependency) (v1.BSRResolution, error)
+}
diff --git a/internal/modules/collisions.go b/internal/modules/collisions.go
new file mode 100644
index 00000000..e493f3ad
--- /dev/null
+++ b/internal/modules/collisions.go
@@ -0,0 +1,33 @@
+package modules
+
+import (
+	"fmt"
+	"path/filepath"
+)
+
+// CheckSourceCollisions respects each module's source selection when comparing import names.
+func CheckSourceCollisions(roots SourceRoots) error {
+	seen := make(map[string]string)
+	allowed := roots.FileAllowed()
+	for _, root := range roots {
+		err := root.Walk(func(path string) error {
+			if allowed != nil && !allowed(path) {
+				return nil
+			}
+			importPath, err := filepath.Rel(root.Path, path)
+			if err != nil {
+				return err
+			}
+			importPath = filepath.ToSlash(importPath)
+			if previous, ok := seen[importPath]; ok && previous != path {
+				return fmt.Errorf("duplicate import path %q: %s and %s", importPath, previous, path)
+			}
+			seen[importPath] = path
+			return nil
+		})
+		if err != nil {
+			return err
+		}
+	}
+	return nil
+}
diff --git a/internal/modules/effective_graph.go b/internal/modules/effective_graph.go
new file mode 100644
index 00000000..89a45694
--- /dev/null
+++ b/internal/modules/effective_graph.go
@@ -0,0 +1,157 @@
+package modules
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"os"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// EffectiveModule describes source metadata without inventing a local revision.
+type EffectiveModule struct {
+	Directory string
+	Module    v1.Module
+}
+
+// EffectiveGraph is an ephemeral selection of local sources and verified remote
+// snapshots. It is never serialized to the shared protobuf.lock.
+type EffectiveGraph struct {
+	Modules map[string]EffectiveModule
+	Sources SourceRoots
+}
+
+// EnsureEffectiveGraph resolves main-module replacements at every graph depth.
+// localPath optionally maps a used replacement into a historical snapshot.
+// Unused replacements are neither opened nor acquired.
+func EnsureEffectiveGraph(ctx context.Context, root string, module v1.Module, cache Cache, localPath func(string) (string, error)) (EffectiveGraph, error) {
+	return ensureEffectiveGraph(ctx, root, module, cache, localPath, false)
+}
+
+func ensureEffectiveGraph(ctx context.Context, root string, module v1.Module, cache Cache, localPath func(string) (string, error), refresh bool) (EffectiveGraph, error) {
+	graph := EffectiveGraph{Modules: make(map[string]EffectiveModule)}
+	existing, err := ReadLock(filepath.Join(root, v1.LockFile))
+	if err != nil && !errors.Is(err, os.ErrNotExist) {
+		return graph, fmt.Errorf("ReadLock: %w", err)
+	}
+	pins := make(map[string]v1.LockedModule, len(existing.Modules))
+	for _, entry := range existing.Modules {
+		pins[entry.Source] = entry
+	}
+	locals := newLocalReplacements(root, module, localPath)
+	remote := &effectiveRemoteSource{cache: cache, pins: pins, refresh: refresh, historical: localPath != nil, modules: make(map[[4]string]cachedEffectiveModule)}
+	loader := revisionLoader{source: remote, fetched: make(map[string]Fetched), pins: pins, local: locals.lookupRequirement}
+	if refresh {
+		loader.pins = nil
+	}
+	pass, err := loader.resolve(ctx, module)
+	if err != nil {
+		return graph, fmt.Errorf("module %s: %w", module.Name, err)
+	}
+	appendModule := func(name string, entry EffectiveModule) error {
+		roots, err := ModuleSources(entry.Directory, entry.Module)
+		if err != nil {
+			return fmt.Errorf("ModuleSources: %s: %w", name, err)
+		}
+		graph.Modules[name] = entry
+		graph.Sources = append(graph.Sources, roots...)
+		return nil
+	}
+	for _, name := range pass.locals {
+		if err := appendModule(name, locals.modules[name]); err != nil {
+			return graph, err
+		}
+	}
+	for _, entry := range pass.lock.Modules {
+		selected, err := remote.installed(ctx, entry)
+		if err != nil {
+			return graph, fmt.Errorf("installed: %w", err)
+		}
+		if err := appendModule(entry.Source, selected); err != nil {
+			return graph, err
+		}
+	}
+	return graph, nil
+}
+
+type effectiveRemoteSource struct {
+	cache      Cache
+	pins       map[string]v1.LockedModule
+	refresh    bool
+	historical bool
+	modules    map[[4]string]cachedEffectiveModule
+}
+
+type cachedEffectiveModule struct {
+	module EffectiveModule
+	bsr    []v1.BSRResolution
+}
+
+func (s *effectiveRemoteSource) Fetch(ctx context.Context, name, version string) (Fetched, error) {
+	// Reuse the published identity for this revision. A higher old tag is not
+	// an extra requirement and must not override explicit tag/commit constraints.
+	// Install verifies hashes even for already cached contents.
+	if pin, ok := s.pins[name]; ok && !s.refresh && (version == "" || version == pin.Version || (v1.IsCommitRef(version) && strings.EqualFold(version, pin.Commit))) {
+		entry, err := s.installed(ctx, pin)
+		if err != nil {
+			return Fetched{}, fmt.Errorf("installed: %w", err)
+		}
+		return Fetched{Module: entry.Module, Lock: pin}, nil
+	}
+	if s.historical && version == "" {
+		return Fetched{}, fmt.Errorf("historical local replacement dependency %s has no locked commit or explicit version; cannot substitute current HEAD for the baseline", name)
+	}
+	source, ok := s.cache.(Source)
+	if !ok {
+		return Fetched{}, fmt.Errorf("protobuf.lock does not satisfy %s %s; repository cannot resolve new local-overlay dependencies", name, version)
+	}
+	guard := lockedVersionSource{Source: source, locked: s.pins}
+	fetched, err := guard.Fetch(ctx, name, version)
+	if err != nil {
+		return Fetched{}, fmt.Errorf("Fetch: %w", err)
+	}
+	return fetched, nil
+}
+
+func (s *effectiveRemoteSource) installed(ctx context.Context, entry v1.LockedModule) (EffectiveModule, error) {
+	key := [4]string{entry.Source, entry.Version, entry.Commit, entry.Hash}
+	if selected, ok := s.modules[key]; ok && slices.Equal(selected.bsr, entry.BSR) {
+		return selected.module, nil
+	}
+	if err := s.cache.Install(ctx, v1.Lock{Version: 1, Modules: []v1.LockedModule{entry}}); err != nil {
+		return EffectiveModule{}, fmt.Errorf("Install: %w", err)
+	}
+	dir, module, err := s.cache.Cached(entry)
+	if err != nil {
+		return EffectiveModule{}, fmt.Errorf("Cached: %w", err)
+	}
+	selected := EffectiveModule{Directory: dir, Module: module}
+	s.modules[key] = cachedEffectiveModule{module: selected, bsr: slices.Clone(entry.BSR)}
+	return selected, nil
+}
+
+func validateLocalOverlay(ctx context.Context, root string, module v1.Module, cache Cache, refresh bool) error {
+	graph, err := ensureEffectiveGraph(ctx, root, module, cache, nil, refresh)
+	if err != nil {
+		return fmt.Errorf("ensureEffectiveGraph: %w", err)
+	}
+	own, err := ModuleSources(root, module)
+	if err != nil {
+		return fmt.Errorf("ModuleSources: %w", err)
+	}
+	if err := CheckSourceCollisions(append(own, graph.Sources...)); err != nil {
+		return fmt.Errorf("CheckSourceCollisions: %w", err)
+	}
+	unresolved, err := findUnresolvedV1ImportsWithSources(root, module.Roots, graph.Sources)
+	if err != nil {
+		return fmt.Errorf("findUnresolvedV1ImportsWithSources: %w", err)
+	}
+	if len(unresolved) > 0 {
+		return fmt.Errorf("module %s: cannot resolve imports %v", module.Name, unresolved)
+	}
+	return nil
+}
diff --git a/internal/modules/effective_graph_test.go b/internal/modules/effective_graph_test.go
new file mode 100644
index 00000000..6c7a1ee4
--- /dev/null
+++ b/internal/modules/effective_graph_test.go
@@ -0,0 +1,96 @@
+package modules
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestEffectiveGraphRemoteRequirements(t *testing.T) {
+	t.Parallel()
+	const remote = "example.com/remote"
+	old := v1.LockedModule{Source: remote, Version: "v1.0.0", Commit: versionlessCommitA, Hash: versionlessHash}
+	newer := v1.LockedModule{Source: remote, Version: "v1.1.0", Commit: versionlessCommitBOld, Hash: versionlessHash}
+	for _, tt := range []struct {
+		name, version     string
+		pin               *v1.LockedModule
+		commitRequirement bool
+		historical        bool
+		wantCalls         []string
+		wantError         string
+	}{
+		{name: "matching tag uses verified published pin", version: "v1.0.0", pin: &old},
+		{name: "versionless uses published pin", pin: &old},
+		{name: "new fork remote dependency without lock", version: "v1.0.0", wantCalls: []string{remote + "@v1.0.0"}},
+		{name: "explicit tag and commit are not constrained by higher old pin", version: "v1.0.0", pin: &newer, commitRequirement: true, wantCalls: []string{remote + "@v1.0.0"}},
+		{name: "baseline cannot invent historical HEAD", historical: true, wantError: "cannot substitute current HEAD"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root, cached := t.TempDir(), t.TempDir()
+			writeV1GenerateFixture(t, root, "fork/protobuf.mod", "module example.com/local\nrequire "+remote+" "+tt.version+"\n")
+			module := v1.Module{Name: "example.com/app", Requires: []v1.Requirement{{Module: "example.com/local"}}, Replaces: []v1.Replacement{{Module: "example.com/local", Target: "fork"}}}
+			if tt.commitRequirement {
+				module.Requires = append(module.Requires, v1.Requirement{Module: remote, Version: old.Commit})
+			}
+			var lock []byte
+			if tt.pin != nil {
+				var err error
+				lock, err = yaml.Marshal(v1.Lock{Version: 1, Modules: []v1.LockedModule{*tt.pin}})
+				require.NoError(t, err)
+				require.NoError(t, os.WriteFile(filepath.Join(root, v1.LockFile), lock, 0o600))
+			}
+			dep := v1.Module{Name: remote, Roots: []string{"."}}
+			source := &fakeSource{revisions: map[string]Fetched{remote + "@v1.0.0": {Module: dep, Lock: old}, remote + "@" + old.Commit: {Module: dep, Lock: v1.LockedModule{Source: remote, Version: old.Commit, Commit: old.Commit, Hash: old.Hash}}}}
+			repository := &overlayTestRepository{fakeSource: source, trackingCache: &trackingCache{modules: map[string]v1.Module{remote: dep}, directories: map[string]string{remote: cached}}}
+			var localPath func(string) (string, error)
+			if tt.historical {
+				localPath = func(target string) (string, error) { return filepath.Join(root, target), nil }
+			}
+			graph, err := EnsureEffectiveGraph(t.Context(), root, module, repository, localPath)
+			if tt.wantError != "" {
+				require.ErrorContains(t, err, tt.wantError)
+			} else {
+				require.NoError(t, err)
+				assert.Len(t, graph.Modules, 2)
+				assert.Equal(t, []string{filepath.Join(root, "fork"), cached}, graph.Sources.Paths())
+				assert.Len(t, repository.installed.Modules, 1)
+				assert.Equal(t, remote, repository.installed.Modules[0].Source)
+			}
+			// Each distinct revision is loaded at most once. An explicit commit
+			// may be read before the equivalent tag, as in the published resolver.
+			if tt.commitRequirement {
+				assert.Contains(t, source.calls, remote+"@v1.0.0")
+			} else {
+				assert.Equal(t, tt.wantCalls, source.calls)
+			}
+			after, err := os.ReadFile(filepath.Join(root, v1.LockFile))
+			if tt.pin == nil {
+				assert.ErrorIs(t, err, os.ErrNotExist)
+			} else {
+				require.NoError(t, err)
+				assert.Equal(t, lock, after)
+			}
+		})
+	}
+}
+
+type overlayTestRepository struct {
+	*fakeSource
+	*trackingCache
+}
+
+func TestEffectiveGraphRejectsContradictoryLocalPaths(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, "dep/a.proto", "syntax = \"proto3\";\n")
+	module := v1.Module{Name: "example.com/app", Requires: []v1.Requirement{{Module: "example.com/A"}, {Module: "example.com/B"}}, Replaces: []v1.Replacement{{Module: "example.com/A", Target: "dep"}, {Module: "example.com/B", Target: "dep"}}}
+	_, err := EnsureEffectiveGraph(t.Context(), root, module, nil, nil)
+	require.ErrorContains(t, err, "directory already supplies module")
+}
diff --git a/internal/modules/fixtures_test.go b/internal/modules/fixtures_test.go
new file mode 100644
index 00000000..c0467340
--- /dev/null
+++ b/internal/modules/fixtures_test.go
@@ -0,0 +1,18 @@
+package modules
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func writeV1GenerateFixture(t *testing.T, root, name, content string) {
+	t.Helper()
+	path := filepath.Join(root, name)
+	err := os.MkdirAll(filepath.Dir(path), 0o755)
+	require.NoError(t, err)
+	err = os.WriteFile(path, []byte(content), 0o644)
+	require.NoError(t, err)
+}
diff --git a/internal/modules/frozen.go b/internal/modules/frozen.go
new file mode 100644
index 00000000..d1fcf12b
--- /dev/null
+++ b/internal/modules/frozen.go
@@ -0,0 +1,121 @@
+package modules
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"os"
+	"path/filepath"
+	"slices"
+
+	"golang.org/x/mod/semver"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// EnsureFrozenSources verifies a native manifest and its complete locked graph
+// without resolving revisions or writing project files. Replacements in the main
+// manifest are forbidden; replacements in dependencies are ignored. The cache
+// may install missing contents, but only at the exact identities in the lock.
+func EnsureFrozenSources(ctx context.Context, root string, repository Cache) (SourceRoots, error) {
+	sources, err := ensureFrozenSources(ctx, root, repository)
+	if err != nil {
+		return nil, fmt.Errorf("frozen graph %s: %w", root, err)
+	}
+	return sources, nil
+}
+
+func ensureFrozenSources(ctx context.Context, root string, repository Cache) (SourceRoots, error) {
+	_, module, err := ReadManifest(root)
+	if err != nil {
+		return nil, fmt.Errorf("ReadManifest: %w", err)
+	}
+	if len(module.Replaces) > 0 {
+		return nil, fmt.Errorf("frozen mode rejects replace directives in protobuf.mod; remove replace before using --frozen")
+	}
+	lock, err := ReadLock(filepath.Join(root, v1.LockFile))
+	if err != nil {
+		if errors.Is(err, os.ErrNotExist) {
+			return nil, fmt.Errorf("frozen mode requires %s; run easyp mod tidy without --frozen and commit the generated lock: %w", v1.LockFile, err)
+		}
+		return nil, fmt.Errorf("ReadLock: %w", err)
+	}
+	err = validateFrozenRequirements(module.Requires, lock)
+	if err != nil {
+		return nil, fmt.Errorf("validateFrozenRequirements: %w", err)
+	}
+	if len(module.Requires) == 0 {
+		if len(lock.Modules) > 0 {
+			return nil, fmt.Errorf("protobuf.lock contains unreachable locked module %s; run easyp mod tidy", lock.Modules[0].Source)
+		}
+		return nil, nil
+	}
+	if repository == nil {
+		return nil, fmt.Errorf("frozen mode requires a cache for locked dependencies")
+	}
+	return frozenCachedSources(ctx, module, lock, repository)
+}
+
+func frozenCachedSources(ctx context.Context, module v1.Module, lock v1.Lock, repository Cache) (SourceRoots, error) {
+	locked := make(map[string]v1.LockedModule, len(lock.Modules))
+	for _, entry := range lock.Modules {
+		locked[entry.Source] = entry
+	}
+	visited := make(map[string]bool, len(lock.Modules))
+	sources := make(map[string]SourceRoots, len(lock.Modules))
+	queue := slices.Clone(module.Requires)
+	for len(queue) > 0 {
+		err := ctx.Err()
+		if err != nil {
+			return nil, fmt.Errorf("Err: %w", err)
+		}
+		requirement := queue[0]
+		queue = queue[1:]
+		if visited[requirement.Module] {
+			continue
+		}
+		visited[requirement.Module] = true
+		entry := locked[requirement.Module]
+		// An unrelated stale lock entry is not permission to acquire its repository.
+		// Install only reached exact pins while walking their verified metadata.
+		if err := repository.Install(ctx, v1.Lock{Version: lock.Version, Modules: []v1.LockedModule{entry}}); err != nil {
+			return nil, fmt.Errorf("Install: %w", err)
+		}
+		directory, dependency, err := repository.Cached(entry)
+		if err != nil {
+			return nil, fmt.Errorf("Cached: %w", err)
+		}
+		err = validateFrozenRequirements(dependency.Requires, lock)
+		if err != nil {
+			return nil, fmt.Errorf("dependency %s: validateFrozenRequirements: %w", dependency.Name, err)
+		}
+		dependencyRoots, err := ModuleSources(directory, dependency)
+		if err != nil {
+			return nil, fmt.Errorf("ModuleSources: %w", err)
+		}
+		sources[requirement.Module] = dependencyRoots
+		queue = append(queue, dependency.Requires...)
+	}
+	var roots SourceRoots
+	for _, entry := range lock.Modules {
+		if !visited[entry.Source] {
+			return nil, fmt.Errorf("protobuf.lock contains unreachable locked module %s; run easyp mod tidy", entry.Source)
+		}
+		roots = append(roots, sources[entry.Source]...)
+	}
+	return roots, nil
+}
+
+func validateFrozenRequirements(requirements []v1.Requirement, lock v1.Lock) error {
+	for _, requirement := range requirements {
+		version := requirement.Version
+		if version != "" && !v1.IsCommitRef(version) && !semver.IsValid(version) {
+			return fmt.Errorf("require %s: expected semantic version or full Git commit, got %q", requirement.Module, version)
+		}
+	}
+	err := ValidateRequirements(requirements, lock)
+	if err != nil {
+		return fmt.Errorf("ValidateRequirements: %w", err)
+	}
+	return nil
+}
diff --git a/internal/modules/frozen_scope_test.go b/internal/modules/frozen_scope_test.go
new file mode 100644
index 00000000..c6e4b88c
--- /dev/null
+++ b/internal/modules/frozen_scope_test.go
@@ -0,0 +1,52 @@
+package modules
+
+import (
+	"context"
+	"fmt"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestFrozenDoesNotAcquireUnreachableLockedModules(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, v1.ModuleFile, "module example.com/app\nrequire example.com/a v1.0.0\n")
+	lock := v1.Lock{Version: 1, Modules: []v1.LockedModule{
+		{Source: "example.com/a", Version: "v1.0.0", Commit: versionlessCommitA, Hash: versionlessHash},
+		{Source: "example.com/unreachable", Version: "v1.0.0", Commit: versionlessCommitA, Hash: versionlessHash},
+	}}
+	raw, err := yaml.Marshal(lock)
+	require.NoError(t, err)
+	writeV1GenerateFixture(t, root, v1.LockFile, string(raw))
+	cache := &frozenScopedCache{dir: t.TempDir()}
+
+	_, err = EnsureFrozenSources(t.Context(), root, cache)
+
+	require.ErrorContains(t, err, "unreachable locked module example.com/unreachable")
+	assert.Equal(t, []string{"example.com/a"}, cache.installed)
+	assertFrozenFile(t, root, v1.LockFile, string(raw))
+}
+
+type frozenScopedCache struct {
+	dir       string
+	installed []string
+}
+
+func (c *frozenScopedCache) Install(_ context.Context, lock v1.Lock) error {
+	for _, entry := range lock.Modules {
+		c.installed = append(c.installed, entry.Source)
+		if entry.Source != "example.com/a" {
+			return fmt.Errorf("must not acquire an unrelated pinned repository: %s", entry.Source)
+		}
+	}
+	return nil
+}
+
+func (c *frozenScopedCache) Cached(entry v1.LockedModule) (string, v1.Module, error) {
+	return c.dir, v1.Module{Name: entry.Source, Roots: []string{"."}}, nil
+}
diff --git a/internal/modules/frozen_test.go b/internal/modules/frozen_test.go
new file mode 100644
index 00000000..83a46bd5
--- /dev/null
+++ b/internal/modules/frozen_test.go
@@ -0,0 +1,234 @@
+package modules
+
+import (
+	"context"
+	"errors"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestEnsureFrozenSourcesPreflight(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name     string
+		manifest string
+		lock     string
+		wantErr  string
+	}{
+		{name: "missing_manifest", lock: "version: 1\nmodules: []\n", wantErr: "protobuf.mod"},
+		{name: "legacy_manifest", manifest: "direct (\nexample.com/a v1.0.0\n)\n", lock: "version: 1\nmodules: []\n", wantErr: "legacy"},
+		{name: "missing_empty_lock", manifest: "module example.com/app\n", wantErr: "run easyp mod tidy without --frozen"},
+		{name: "malformed_empty_lock", manifest: "module example.com/app\n", lock: "version: 99\n", wantErr: "unsupported protobuf.lock"},
+		{name: "empty_lock", manifest: "module example.com/app\n", lock: "version: 1\nmodules: []\n"},
+		{name: "unreachable_replace_before_lock", manifest: "module example.com/app\nreplace example.com/unused => ./missing\n", lock: "invalid yaml: [", wantErr: "replace"},
+		{name: "required_replace_before_cache", manifest: "module example.com/app\nrequire example.com/a v1.0.0\nreplace example.com/a => ./missing\n", lock: "version: 1\nmodules: []\n", wantErr: "replace"},
+		{name: "missing_direct_requirement", manifest: "module example.com/app\nrequire example.com/a v1.0.0\n", lock: "version: 1\nmodules: []\n", wantErr: "does not satisfy example.com/a"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			if tt.manifest != "" {
+				writeV1GenerateFixture(t, root, v1.ModuleFile, tt.manifest)
+			}
+			if tt.lock != "" {
+				writeV1GenerateFixture(t, root, v1.LockFile, tt.lock)
+			}
+			cache := &frozenTestRepository{}
+
+			roots, err := EnsureFrozenSources(t.Context(), root, cache)
+
+			if tt.wantErr != "" {
+				require.ErrorContains(t, err, tt.wantErr)
+				require.ErrorContains(t, err, "frozen graph "+root)
+			} else {
+				require.NoError(t, err)
+				assert.Empty(t, roots)
+			}
+			assert.Zero(t, cache.installs)
+			assert.Empty(t, cache.cached)
+			assert.Zero(t, cache.fetches)
+			assertFrozenFile(t, root, v1.ModuleFile, tt.manifest)
+			assertFrozenFile(t, root, v1.LockFile, tt.lock)
+		})
+	}
+}
+
+func TestEnsureFrozenSourcesGraph(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name         string
+		requirement  string
+		locked       []string
+		aRequires    []v1.Requirement
+		bRequires    []v1.Requirement
+		aReplaces    []v1.Replacement
+		wantErr      string
+		wantInstalls int
+	}{
+		{name: "direct", requirement: "v1.0.0", locked: []string{"a"}, wantInstalls: 1},
+		{name: "semantic_minimum", requirement: "v0.9.0", locked: []string{"a"}, wantInstalls: 1},
+		{name: "versionless", locked: []string{"a"}, wantInstalls: 1},
+		{name: "exact_commit", requirement: versionlessCommitA, locked: []string{"a"}, wantInstalls: 1},
+		{name: "invalid_direct_version", requirement: "latest", locked: []string{"a"}, wantErr: "expected semantic version or full Git commit"},
+		{name: "invalid_transitive_version", requirement: "v1.0.0", locked: []string{"a", "b"}, aRequires: []v1.Requirement{{Module: "example.com/b", Version: "latest"}}, wantErr: "expected semantic version or full Git commit", wantInstalls: 1},
+		{name: "outdated_direct_version", requirement: "v1.1.0", locked: []string{"a"}, wantErr: "does not satisfy example.com/a"},
+		{name: "wrong_direct_commit", requirement: versionlessCommitBOld, locked: []string{"a"}, wantErr: "does not satisfy example.com/a"},
+		{name: "transitive", requirement: "v1.0.0", locked: []string{"b", "a"}, aRequires: []v1.Requirement{{Module: "example.com/b", Version: "v1.0.0"}}, wantInstalls: 2},
+		{name: "transitive_cycle", requirement: "v1.0.0", locked: []string{"a", "b"}, aRequires: []v1.Requirement{{Module: "example.com/b"}}, bRequires: []v1.Requirement{{Module: "example.com/a"}}, wantInstalls: 2},
+		{name: "missing_transitive", requirement: "v1.0.0", locked: []string{"a"}, aRequires: []v1.Requirement{{Module: "example.com/b"}}, wantErr: "does not satisfy example.com/b", wantInstalls: 1},
+		{name: "outdated_transitive", requirement: "v1.0.0", locked: []string{"a", "b"}, aRequires: []v1.Requirement{{Module: "example.com/b", Version: "v1.1.0"}}, wantErr: "does not satisfy example.com/b", wantInstalls: 1},
+		{name: "wrong_transitive_commit", requirement: "v1.0.0", locked: []string{"a", "b"}, aRequires: []v1.Requirement{{Module: "example.com/b", Version: versionlessCommitBOld}}, wantErr: "does not satisfy example.com/b", wantInstalls: 1},
+		{name: "stale_extra", requirement: "v1.0.0", locked: []string{"a", "b"}, wantErr: "unreachable locked module example.com/b", wantInstalls: 1},
+		{name: "dependency_replaces_ignored", requirement: "v1.0.0", locked: []string{"a", "b"}, aRequires: []v1.Requirement{{Module: "example.com/b"}}, aReplaces: []v1.Replacement{{Module: "example.com/b", Target: "./missing"}}, wantInstalls: 2},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			manifest := "// retain comments\nmodule example.com/app\nrequire example.com/a " + tt.requirement + "\n"
+			writeV1GenerateFixture(t, root, v1.ModuleFile, manifest)
+			lock := v1.Lock{Version: 1}
+			cache := &frozenTestRepository{modules: make(map[string]v1.Module), directories: make(map[string]string)}
+			var wantRoots SourceRoots
+			for _, name := range tt.locked {
+				source := "example.com/" + name
+				lock.Modules = append(lock.Modules, v1.LockedModule{Source: source, Version: "v1.0.0", Commit: versionlessCommitA, Hash: versionlessHash})
+				cache.directories[source] = t.TempDir()
+				cache.modules[source] = v1.Module{Name: source, Roots: []string{"."}}
+				wantRoots = append(wantRoots, SourceRoot{Path: cache.directories[source], Module: source})
+			}
+			cache.modules["example.com/a"] = v1.Module{Name: "example.com/a", Roots: []string{"."}, Requires: tt.aRequires, Replaces: tt.aReplaces}
+			if _, ok := cache.modules["example.com/b"]; ok {
+				cache.modules["example.com/b"] = v1.Module{Name: "example.com/b", Roots: []string{"."}, Requires: tt.bRequires}
+			}
+			raw, err := yaml.Marshal(lock)
+			require.NoError(t, err)
+			writeV1GenerateFixture(t, root, v1.LockFile, string(raw))
+
+			roots, err := EnsureFrozenSources(t.Context(), root, cache)
+
+			if tt.wantErr != "" {
+				require.ErrorContains(t, err, tt.wantErr)
+				require.ErrorContains(t, err, "frozen graph "+root)
+				assert.Empty(t, roots)
+			} else {
+				require.NoError(t, err)
+				assert.Equal(t, wantRoots, roots)
+				assert.Len(t, cache.cached, len(lock.Modules))
+			}
+			assert.Equal(t, tt.wantInstalls, cache.installs)
+			if tt.wantInstalls > 0 {
+				assert.Equal(t, lock.Version, cache.installed.Version)
+				assert.Len(t, cache.installed.Modules, tt.wantInstalls)
+				if tt.wantErr == "" {
+					assert.ElementsMatch(t, lock.Modules, cache.installed.Modules)
+				} else {
+					assert.Equal(t, []v1.LockedModule{{Source: "example.com/a", Version: "v1.0.0", Commit: versionlessCommitA, Hash: versionlessHash}}, cache.installed.Modules)
+				}
+			} else {
+				assert.Empty(t, cache.cached)
+			}
+			assert.Zero(t, cache.fetches)
+			assertFrozenFile(t, root, v1.ModuleFile, manifest)
+			assertFrozenFile(t, root, v1.LockFile, string(raw))
+		})
+	}
+}
+
+func TestEnsureFrozenSourcesStaleEmptyGraph(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, v1.ModuleFile, "module example.com/app\n")
+	lock := v1.Lock{Version: 1, Modules: []v1.LockedModule{{Source: "example.com/stale", Version: "v1.0.0", Commit: versionlessCommitA, Hash: versionlessHash}}}
+	raw, err := yaml.Marshal(lock)
+	require.NoError(t, err)
+	writeV1GenerateFixture(t, root, v1.LockFile, string(raw))
+
+	_, err = EnsureFrozenSources(t.Context(), root, nil)
+
+	require.ErrorContains(t, err, "unreachable locked module example.com/stale")
+	assertFrozenFile(t, root, v1.LockFile, string(raw))
+}
+
+func TestEnsureFrozenSourcesCacheErrors(t *testing.T) {
+	t.Parallel()
+	failure := errors.New("cache verification failed")
+	for _, method := range []string{"install", "cached"} {
+		t.Run(method, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeV1GenerateFixture(t, root, v1.ModuleFile, "module example.com/app\nrequire example.com/a v1.0.0\n")
+			lock := v1.Lock{Version: 1, Modules: []v1.LockedModule{{Source: "example.com/a", Version: "v1.0.0", Commit: versionlessCommitA, Hash: versionlessHash}}}
+			raw, err := yaml.Marshal(lock)
+			require.NoError(t, err)
+			writeV1GenerateFixture(t, root, v1.LockFile, string(raw))
+			cache := &frozenTestRepository{}
+			if method == "install" {
+				cache.installErr = failure
+			} else {
+				cache.cachedErr = failure
+			}
+
+			_, err = EnsureFrozenSources(t.Context(), root, cache)
+
+			require.ErrorIs(t, err, failure)
+			require.ErrorContains(t, err, "frozen graph "+root)
+			assert.Zero(t, cache.fetches)
+			if method == "install" {
+				assert.Empty(t, cache.cached)
+			}
+			assertFrozenFile(t, root, v1.LockFile, string(raw))
+		})
+	}
+}
+
+func assertFrozenFile(t *testing.T, root, name, want string) {
+	t.Helper()
+	raw, err := os.ReadFile(filepath.Join(root, name))
+	if want == "" {
+		require.ErrorIs(t, err, os.ErrNotExist)
+		return
+	}
+	require.NoError(t, err)
+	assert.Equal(t, want, string(raw))
+}
+
+type frozenTestRepository struct {
+	modules     map[string]v1.Module
+	directories map[string]string
+	installed   v1.Lock
+	installs    int
+	cached      []string
+	fetches     int
+	installErr  error
+	cachedErr   error
+}
+
+var _ Repository = (*frozenTestRepository)(nil)
+
+func (c *frozenTestRepository) Install(_ context.Context, lock v1.Lock) error {
+	c.installs++
+	c.installed.Version = lock.Version
+	c.installed.Modules = append(c.installed.Modules, lock.Modules...)
+	return c.installErr
+}
+
+func (c *frozenTestRepository) Cached(entry v1.LockedModule) (string, v1.Module, error) {
+	c.cached = append(c.cached, entry.Source)
+	return c.directories[entry.Source], c.modules[entry.Source], c.cachedErr
+}
+
+func (c *frozenTestRepository) Fetch(_ context.Context, _, _ string) (Fetched, error) {
+	c.fetches++
+	return Fetched{}, errors.New("frozen must not fetch")
+}
diff --git a/internal/modules/get.go b/internal/modules/get.go
new file mode 100644
index 00000000..91a5a57f
--- /dev/null
+++ b/internal/modules/get.go
@@ -0,0 +1,131 @@
+package modules
+
+import (
+	"bytes"
+	"context"
+	"errors"
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// Get adds or promotes one direct requirement. In published mode it also records
+// resolved transitives; local overlay mode preserves the shared lock.
+func Get(ctx context.Context, root string, requirement v1.Requirement, repository Repository) error {
+	original, module, err := ReadManifest(root)
+	if err != nil {
+		return fmt.Errorf("ReadManifest: %w", err)
+	}
+	if module.Name == requirement.Module {
+		return fmt.Errorf("module %s cannot require itself", module.Name)
+	}
+	updated, err := addDirectV1Requirement(original, requirement)
+	if err != nil {
+		return fmt.Errorf("addDirectV1Requirement: %w", err)
+	}
+	updatedModule, err := v1.ParseModule(bytes.NewReader(updated))
+	if err != nil {
+		return fmt.Errorf("ParseModule: %w", err)
+	}
+	if len(updatedModule.Replaces) > 0 {
+		if err := validateLocalOverlay(ctx, root, updatedModule, repository, false); err != nil {
+			return err
+		}
+		if bytes.Equal(original, updated) {
+			return nil
+		}
+		return writeV1Manifest(root, updated)
+	}
+	updatedModule = directV1Module(updated, updatedModule)
+	existing, err := ReadLock(filepath.Join(root, v1.LockFile))
+	if err != nil && !errors.Is(err, os.ErrNotExist) {
+		return fmt.Errorf("ReadLock: %w", err)
+	}
+	lock, err := resolveV1LockWithPins(ctx, root, updatedModule, existing, repository)
+	if err != nil {
+		return fmt.Errorf("resolveV1LockWithPins: %w", err)
+	}
+	versions, err := manifestRequirementVersions(lock, repository)
+	if err != nil {
+		return fmt.Errorf("manifestRequirementVersions: %w", err)
+	}
+	updated = syncV1IndirectRequirements(updated, updatedModule, lock, versions)
+	return writeV1ResolvedFiles(root, original, updated, lock)
+}
+
+// addDirectV1Requirement changes one requirement while preserving the rest of
+// the manifest. A repeated get leaves an existing version in place unless the
+// user explicitly requests another one.
+func addDirectV1Requirement(original []byte, target v1.Requirement) ([]byte, error) {
+	lines := strings.Split(string(original), "\n")
+	found := false
+	for _, line := range parseV1RequirementLines(lines) {
+		if line.module != target.Module {
+			continue
+		}
+		if found {
+			return nil, fmt.Errorf("protobuf.mod: duplicate require %s", target.Module)
+		}
+		found = true
+		if target.Version != "" {
+			line = line.withVersion(target.Version)
+		}
+		lines[line.index] = line.direct().String()
+	}
+	if found {
+		return []byte(strings.Join(lines, "\n")), nil
+	}
+	return appendV1Requirements(original, []v1ManifestRequirement{{Requirement: target}}), nil
+}
+
+func syncV1IndirectRequirements(original []byte, module v1.Module, lock v1.Lock, versions map[string]string) []byte {
+	lines := strings.Split(string(original), "\n")
+	indirect := make(map[string]v1RequirementLine)
+	for _, line := range parseV1RequirementLines(lines) {
+		if line.indirect() {
+			indirect[line.module] = line
+		}
+	}
+
+	direct := make(map[string]bool, len(module.Requires))
+	for _, requirement := range module.Requires {
+		direct[requirement.Module] = true
+	}
+
+	var additions []v1ManifestRequirement
+	for _, entry := range lock.Modules {
+		if direct[entry.Source] {
+			delete(indirect, entry.Source)
+			continue
+		}
+		if line, ok := indirect[entry.Source]; ok {
+			line = line.withVersion(versions[entry.Source])
+			lines[line.index] = line.String()
+			delete(indirect, entry.Source)
+			continue
+		}
+		additions = append(additions, v1ManifestRequirement{
+			Requirement: v1.Requirement{Module: entry.Source, Version: versions[entry.Source]},
+			indirect:    true,
+		})
+	}
+
+	if len(indirect) > 0 {
+		stale := make(map[int]bool, len(indirect))
+		for _, line := range indirect {
+			stale[line.index] = true
+		}
+		kept := make([]string, 0, len(lines)-len(stale))
+		for index, line := range lines {
+			if !stale[index] {
+				kept = append(kept, line)
+			}
+		}
+		lines = kept
+	}
+
+	return appendV1Requirements([]byte(strings.Join(lines, "\n")), additions)
+}
diff --git a/internal/modules/get_test.go b/internal/modules/get_test.go
new file mode 100644
index 00000000..4439b1b1
--- /dev/null
+++ b/internal/modules/get_test.go
@@ -0,0 +1,105 @@
+package modules
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestAddDirectV1RequirementPreservesFormatting(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name     string
+		original string
+		version  string
+		want     string
+	}{
+		{
+			name:     "update preserves spacing and comment",
+			original: "require\thttps://example.com/dep\t v1.0.0  // keep this\n",
+			version:  "v1.1.0",
+			want:     "require\thttps://example.com/dep\t v1.1.0  // keep this\n",
+		},
+		{
+			name:     "versionless stays versionless",
+			original: "require (\n\thttps://example.com/dep\t// keep this\n)\n",
+			want:     "require (\n\thttps://example.com/dep\t// keep this\n)\n",
+		},
+		{
+			name:     "pin versionless and retain comment",
+			original: "require https://example.com/dep  // indirect needed by clients\n",
+			version:  "v1.1.0",
+			want:     "require https://example.com/dep v1.1.0  // needed by clients\n",
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			original := []byte(tt.original)
+			target := v1.Requirement{Module: "https://example.com/dep", Version: tt.version}
+
+			updated, err := addDirectV1Requirement(original, target)
+
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, string(updated))
+		})
+	}
+}
+
+func TestAddDirectV1RequirementAddsAndRejectsDuplicates(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name     string
+		original string
+		version  string
+		want     string
+		wantErr  string
+	}{
+		{
+			name:     "promote indirect requirement without changing other entries",
+			original: "module example.com/app\nrequire ( // dependencies\n  example.com/dep v1.0.0 // indirect\n  example.com/other v1.0.0 // indirect\n)\n",
+			version:  "v1.1.0",
+			want:     "module example.com/app\nrequire ( // dependencies\n  example.com/dep v1.1.0\n  example.com/other v1.0.0 // indirect\n)\n",
+		},
+		{
+			name:     "append versionless with missing final newline",
+			original: "module example.com/root",
+			want:     "module example.com/root\nrequire example.com/dep\n",
+		},
+		{
+			name:     "append version without editing other directives",
+			original: "module example.com/root\nroots proto\nrequire example.com/other v1.0.0 // keep\n",
+			version:  "v1.1.0",
+			want:     "module example.com/root\nroots proto\nrequire example.com/other v1.0.0 // keep\nrequire example.com/dep v1.1.0\n",
+		},
+		{
+			name:     "duplicate in block and standalone requirement",
+			original: "require (\n example.com/dep v1.0.0\n)\nrequire example.com/dep\n",
+			wantErr:  "duplicate require example.com/dep",
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			original := []byte(tt.original)
+
+			updated, err := addDirectV1Requirement(original, v1.Requirement{Module: "example.com/dep", Version: tt.version})
+
+			assert.Equal(t, tt.original, string(original))
+			if tt.wantErr != "" {
+				require.ErrorContains(t, err, tt.wantErr)
+				assert.Nil(t, updated)
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, string(updated))
+		})
+	}
+}
diff --git a/internal/modules/immutable_versions.go b/internal/modules/immutable_versions.go
new file mode 100644
index 00000000..d2a19170
--- /dev/null
+++ b/internal/modules/immutable_versions.go
@@ -0,0 +1,33 @@
+package modules
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"strings"
+
+	"golang.org/x/mod/semver"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// ErrLockedVersionChanged indicates that a previously recorded version was republished.
+var ErrLockedVersionChanged = errors.New("locked version changed")
+
+type lockedVersionSource struct {
+	Source
+	locked map[string]v1.LockedModule
+}
+
+func (s lockedVersionSource) Fetch(ctx context.Context, source, version string) (Fetched, error) {
+	fetched, err := s.Source.Fetch(ctx, source, version)
+	if err != nil {
+		return Fetched{}, fmt.Errorf("Fetch: %w", err)
+	}
+	old, ok := s.locked[source]
+	if ok && semver.IsValid(old.Version) && old.Version == fetched.Lock.Version &&
+		(!strings.EqualFold(old.Commit, fetched.Lock.Commit) || old.Hash != fetched.Lock.Hash) {
+		return Fetched{}, fmt.Errorf("%w: %s@%s: locked commit %s hash %s, fetched commit %s hash %s; restore the published version or select a new version", ErrLockedVersionChanged, source, old.Version, old.Commit, old.Hash, fetched.Lock.Commit, fetched.Lock.Hash)
+	}
+	return fetched, nil
+}
diff --git a/internal/modules/immutable_versions_test.go b/internal/modules/immutable_versions_test.go
new file mode 100644
index 00000000..9ee86b71
--- /dev/null
+++ b/internal/modules/immutable_versions_test.go
@@ -0,0 +1,47 @@
+package modules
+
+import (
+	"context"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+type revisionTestSource struct{ entry v1.LockedModule }
+
+func (s revisionTestSource) Fetch(context.Context, string, string) (Fetched, error) {
+	return Fetched{Lock: s.entry}, nil
+}
+
+func TestLockedVersionGuard(t *testing.T) {
+	t.Parallel()
+	old := v1.LockedModule{Source: "example.com/dep", Version: "v1.0.0", Commit: "old", Hash: "hash-old"}
+	tests := []struct {
+		name, version, commit, hash string
+		reject                      bool
+	}{
+		{"unchanged", "v1.0.0", "old", "hash-old", false},
+		{"commit case", "v1.0.0", "OLD", "hash-old", false},
+		{"retagged", "v1.0.0", "new", "hash-new", true},
+		{"hash changed", "v1.0.0", "old", "hash-new", true},
+		{"new version", "v1.1.0", "new", "hash-new", false},
+		{"versionless refresh", "head-commit", "new", "hash-new", false},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			entry := v1.LockedModule{Source: old.Source, Version: tt.version, Commit: tt.commit, Hash: tt.hash}
+			guard := lockedVersionSource{Source: revisionTestSource{entry: entry}, locked: map[string]v1.LockedModule{old.Source: old}}
+			got, err := guard.Fetch(t.Context(), old.Source, tt.version)
+			if tt.reject {
+				require.ErrorIs(t, err, ErrLockedVersionChanged)
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, entry, got.Lock)
+		})
+	}
+}
diff --git a/internal/modules/imports.go b/internal/modules/imports.go
new file mode 100644
index 00000000..fbe8b1a0
--- /dev/null
+++ b/internal/modules/imports.go
@@ -0,0 +1,196 @@
+package modules
+
+import (
+	"bytes"
+	"errors"
+	"fmt"
+	"io/fs"
+	"os"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	"github.com/bufbuild/protocompile/ast"
+	"github.com/bufbuild/protocompile/parser"
+	"github.com/bufbuild/protocompile/reporter"
+
+	"github.com/easyp-tech/easyp/wellknownimports"
+)
+
+// ReadProtoImports reads and parses import declarations in a proto file.
+func ReadProtoImports(path string) ([]string, error) {
+	raw, err := os.ReadFile(path)
+	if err != nil {
+		return nil, fmt.Errorf("ReadFile: %w", err)
+	}
+	return ParseProtoImports(path, raw)
+}
+
+// ParseProtoImports follows protobuf syntax, including comments and escaped paths.
+func ParseProtoImports(path string, raw []byte) ([]string, error) {
+	file, err := parser.Parse(path, bytes.NewReader(raw), reporter.NewHandler(nil))
+	if err != nil {
+		return nil, fmt.Errorf("Parse: %w", err)
+	}
+	var imports []string
+	for _, declaration := range file.Decls {
+		if imported, ok := declaration.(*ast.ImportNode); ok {
+			imports = append(imports, imported.Name.AsString())
+		}
+	}
+	return imports, nil
+}
+
+func unresolvedV1Imports(moduleDir string, roots []string) ([]string, error) {
+	return unresolvedV1ImportsWithRoots(moduleDir, roots, nil)
+}
+
+func unresolvedV1ImportsWithRoots(moduleDir string, roots, dependencyRoots []string) ([]string, error) {
+	unresolved, err := findUnresolvedV1Imports(moduleDir, roots, dependencyRoots)
+	if err != nil {
+		return nil, fmt.Errorf("findUnresolvedV1Imports: %w", err)
+	}
+	missing := map[string]struct{}{}
+	for _, imported := range unresolved {
+		missing[imported.path] = struct{}{}
+	}
+	paths := make([]string, 0, len(missing))
+	for path := range missing {
+		paths = append(paths, path)
+	}
+	slices.Sort(paths)
+	return paths, nil
+}
+
+// ValidProtoImportPath reports whether an import is a portable relative file
+// path without empty, dot, or parent components.
+func ValidProtoImportPath(path string) bool {
+	return path != "." && fs.ValidPath(path) && !strings.ContainsAny(path, "\\:\x00")
+}
+
+type v1UnresolvedImport struct {
+	owner string
+	path  string
+}
+
+func (i v1UnresolvedImport) String() string {
+	return fmt.Sprintf("%s imports %q", i.owner, i.path)
+}
+
+type v1ImportSource struct {
+	path    string
+	builtin bool
+}
+
+func (s v1ImportSource) imports() ([]string, error) {
+	if !s.builtin {
+		return ReadProtoImports(s.path)
+	}
+	raw, err := wellknownimports.Content.ReadFile(s.path)
+	if err != nil {
+		return nil, fmt.Errorf("ReadFile: %w", err)
+	}
+	return ParseProtoImports(s.path, raw)
+}
+
+// findUnresolvedV1Imports parses root sources and only the dependency files
+// reachable from them. Unrelated dependency protos need not be valid or complete.
+func findUnresolvedV1Imports(moduleDir string, roots, dependencyRoots []string) ([]v1UnresolvedImport, error) {
+	sources := make(SourceRoots, 0, len(dependencyRoots))
+	for _, root := range dependencyRoots {
+		sources = append(sources, SourceRoot{Path: root})
+	}
+	return findUnresolvedV1ImportsWithSources(moduleDir, roots, sources)
+}
+
+func findUnresolvedV1ImportsWithSources(moduleDir string, roots []string, dependencyRoots SourceRoots) ([]v1UnresolvedImport, error) {
+	allRoots := make(SourceRoots, 0, len(roots)+len(dependencyRoots))
+	for _, root := range roots {
+		allRoots = append(allRoots, SourceRoot{Path: filepath.Join(moduleDir, root)})
+	}
+	allRoots = append(allRoots, dependencyRoots...)
+	allowed := allRoots.FileAllowed()
+	var queue []v1ImportSource
+	seen := make(map[v1ImportSource]bool)
+	for _, sourceRoot := range allRoots[:len(roots)] {
+		err := sourceRoot.Walk(func(path string) error {
+			if allowed != nil && !allowed(path) {
+				return nil
+			}
+			source := v1ImportSource{path: path}
+			if !seen[source] {
+				seen[source] = true
+				queue = append(queue, source)
+			}
+			return nil
+		})
+		if err != nil {
+			return nil, fmt.Errorf("WalkProtoFiles: %w", err)
+		}
+	}
+	var unresolved []v1UnresolvedImport
+	for len(queue) > 0 {
+		source := queue[0]
+		queue = queue[1:]
+		imports, err := source.imports()
+		if err != nil {
+			return nil, fmt.Errorf("imports: %w", err)
+		}
+		seenImports := make(map[string]bool, len(imports))
+		for _, importPath := range imports {
+			if !ValidProtoImportPath(importPath) {
+				return nil, fmt.Errorf("%s: invalid import %q", source.path, importPath)
+			}
+			if seenImports[importPath] {
+				continue
+			}
+			seenImports[importPath] = true
+			imported, err := resolveV1ImportSource(importPath, allRoots, allowed)
+			if errors.Is(err, os.ErrNotExist) {
+				unresolved = append(unresolved, v1UnresolvedImport{owner: source.path, path: importPath})
+				continue
+			}
+			if err != nil {
+				return nil, fmt.Errorf("resolveV1ImportSource: %s imports %q: %w", source.path, importPath, err)
+			}
+			if !seen[imported] {
+				seen[imported] = true
+				queue = append(queue, imported)
+			}
+		}
+	}
+	return unresolved, nil
+}
+
+func resolveV1ImportSource(importPath string, roots SourceRoots, allowed func(string) bool) (v1ImportSource, error) {
+	for _, root := range roots {
+		candidate := filepath.Join(root.Path, filepath.FromSlash(importPath))
+		if allowed != nil {
+			// The shared filter checks both owners. This root still needs to own
+			// the import's spelling, but a selected target may belong to another root.
+			if !allowed(candidate) || !root.allowsPath(candidate, root.Path) {
+				continue
+			}
+		} else if !root.allows(candidate, root.Path) {
+			continue
+		}
+		info, err := os.Stat(candidate)
+		if errors.Is(err, os.ErrNotExist) {
+			continue
+		}
+		if err != nil {
+			return v1ImportSource{}, fmt.Errorf("Stat: %w", err)
+		}
+		if info.Mode().IsRegular() {
+			return v1ImportSource{path: candidate}, nil
+		}
+	}
+	info, err := fs.Stat(wellknownimports.Content, importPath)
+	if err != nil {
+		return v1ImportSource{}, fmt.Errorf("Stat: %w", err)
+	}
+	if !info.Mode().IsRegular() {
+		return v1ImportSource{}, os.ErrNotExist
+	}
+	return v1ImportSource{path: importPath, builtin: true}, nil
+}
diff --git a/internal/modules/imports_closure_test.go b/internal/modules/imports_closure_test.go
new file mode 100644
index 00000000..41c01968
--- /dev/null
+++ b/internal/modules/imports_closure_test.go
@@ -0,0 +1,101 @@
+package modules
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestUnresolvedImportsReachableClosure(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name       string
+		root       string
+		dependency map[string]string
+		missing    []string
+		wantError  string
+	}{
+		{
+			name: "missing_transitive_import", root: `syntax = "proto3"; import "dep.proto";`,
+			dependency: map[string]string{"dep.proto": `syntax = "proto3"; import "missing.proto";`},
+			missing:    []string{"missing.proto"},
+		},
+		{
+			name: "fake_wellknown", root: `syntax = "proto3"; import "google/protobuf/not_real.proto";`,
+			missing: []string{"google/protobuf/not_real.proto"},
+		},
+		{
+			name: "cycles_and_shared_imports", root: `syntax = "proto3"; import "a.proto"; import "b.proto";`,
+			dependency: map[string]string{
+				"a.proto":      `syntax = "proto3"; import "b.proto"; import "shared.proto";`,
+				"b.proto":      `syntax = "proto3"; import "a.proto"; import "main.proto"; import "shared.proto";`,
+				"shared.proto": `syntax = "proto3"; import "missing.proto";`,
+			},
+			missing: []string{"missing.proto"},
+		},
+		{
+			name: "unreferenced_broken_dependency_is_lazy", root: `syntax = "proto3"; import "dep.proto";`,
+			dependency: map[string]string{
+				"dep.proto":    `syntax = "proto3"; import "google/protobuf/api.proto";`,
+				"broken.proto": `this is not protobuf`,
+				"unused.proto": `syntax = "proto3"; import "absent.proto";`,
+			},
+			missing: []string{},
+		},
+		{
+			name: "reachable_invalid_syntax", root: `syntax = "proto3"; import "dep.proto";`,
+			dependency: map[string]string{"dep.proto": `syntax = "proto3"; message Broken {`},
+			wantError:  "dep.proto",
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root, dependency := t.TempDir(), t.TempDir()
+			writeV1GenerateFixture(t, root, "main.proto", tt.root)
+			for path, source := range tt.dependency {
+				writeV1GenerateFixture(t, dependency, path, source)
+			}
+
+			missing, err := unresolvedV1ImportsWithRoots(root, []string{"."}, []string{dependency})
+
+			if tt.wantError != "" {
+				require.ErrorContains(t, err, tt.wantError)
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, tt.missing, missing)
+		})
+	}
+}
+
+func TestUnresolvedImportsRejectsInvalidPaths(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name string
+		path string
+	}{
+		{name: "empty", path: ""},
+		{name: "directory", path: "."},
+		{name: "parent", path: "../outside.proto"},
+		{name: "embedded_parent", path: "nested/../dep.proto"},
+		{name: "absolute", path: "/outside.proto"},
+		{name: "backslash", path: `nested\\dep.proto`},
+		{name: "windows_drive", path: "C:/outside.proto"},
+		{name: "nul", path: `dep\x00.proto`},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root, dependency := t.TempDir(), t.TempDir()
+			writeV1GenerateFixture(t, root, "main.proto", `syntax = "proto3"; import "dep.proto";`)
+			writeV1GenerateFixture(t, dependency, "dep.proto", `syntax = "proto3"; import "`+tt.path+`";`)
+
+			_, err := unresolvedV1ImportsWithRoots(root, []string{"."}, []string{dependency})
+
+			require.ErrorContains(t, err, "invalid import")
+			assert.ErrorContains(t, err, "dep.proto")
+		})
+	}
+}
diff --git a/internal/modules/local_overlay_test.go b/internal/modules/local_overlay_test.go
new file mode 100644
index 00000000..7d7528c0
--- /dev/null
+++ b/internal/modules/local_overlay_test.go
@@ -0,0 +1,100 @@
+package modules
+
+import (
+	"errors"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestLocalOverlayGraph(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name, aManifest, bManifest, wantError string
+		absolute                              bool
+	}{
+		{name: "root replacements apply transitively", aManifest: "require example.com/B v1.0.0\n"},
+		{name: "absolute root replacements", aManifest: "require example.com/B\n", absolute: true},
+		{name: "ignore dependency replacements", aManifest: "require example.com/B\nreplace example.com/B => nonexistent\n"},
+		{name: "ordinary dependency cycle deduplicates", aManifest: "require example.com/B\n", bManifest: "require example.com/A\n"},
+		{name: "identity mismatch", aManifest: "require example.com/B\n", bManifest: "module example.com/wrong\n", wantError: "want example.com/B"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeV1GenerateFixture(t, root, "a/protobuf.mod", "module example.com/A\n"+tt.aManifest)
+			b := "module example.com/B\n" + tt.bManifest
+			if tt.wantError != "" {
+				b = tt.bManifest
+			}
+			writeV1GenerateFixture(t, root, "b/protobuf.mod", b)
+			target := "b"
+			if tt.absolute {
+				target = filepath.Join(root, "b")
+			}
+			module := v1.Module{Name: "example.com/app", Roots: []string{"proto"}, Requires: []v1.Requirement{{Module: "example.com/A"}}, Replaces: []v1.Replacement{
+				{Module: "example.com/A", Target: "a"}, {Module: "example.com/B", Target: target}, {Module: "example.com/unused", Target: "missing"},
+			}}
+			repository := &fakeRepository{fetchErr: errors.New("unexpected remote fetch"), installErr: errors.New("unexpected remote install")}
+			roots, err := EnsureSources(t.Context(), root, module, repository)
+			if tt.wantError != "" {
+				require.ErrorContains(t, err, tt.wantError)
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, []string{filepath.Join(root, "a"), filepath.Join(root, "b")}, roots.Paths())
+			_, err = os.Stat(filepath.Join(root, v1.LockFile))
+			assert.ErrorIs(t, err, os.ErrNotExist)
+		})
+	}
+}
+
+func TestLocalOverlayOperationsPreserveFiles(t *testing.T) {
+	t.Parallel()
+	for _, existing := range []bool{false, true} {
+		tests := []struct {
+			name string
+			run  func(*testing.T, string, *fakeRepository) error
+		}{
+			{name: "tidy", run: func(t *testing.T, root string, r *fakeRepository) error { return Tidy(t.Context(), root, r) }},
+			{name: "download", run: func(t *testing.T, root string, r *fakeRepository) error { return Download(t.Context(), root, r) }},
+			{name: "get", run: func(t *testing.T, root string, r *fakeRepository) error {
+				return Get(t.Context(), root, v1.Requirement{Module: "example.com/A"}, r)
+			}},
+			{name: "update", run: func(t *testing.T, root string, r *fakeRepository) error { return Update(t.Context(), root, r) }},
+		}
+		for _, tt := range tests {
+			t.Run(tt.name+map[bool]string{false: " without lock", true: " with lock"}[existing], func(t *testing.T) {
+				t.Parallel()
+				root := t.TempDir()
+				manifest := "module example.com/app\nroots proto\nrequire example.com/A v1.0.0 // keep\nreplace example.com/A => a\n"
+				lock := "# keep these bytes\nversion: 1\nmodules: []\n"
+				writeV1GenerateFixture(t, root, v1.ModuleFile, manifest)
+				writeV1GenerateFixture(t, root, "proto/app.proto", "syntax = \"proto3\"; import \"a.proto\";\n")
+				writeV1GenerateFixture(t, root, "a/protobuf.mod", "module example.com/A\n")
+				writeV1GenerateFixture(t, root, "a/a.proto", "syntax = \"proto3\";\n")
+				if existing {
+					writeV1GenerateFixture(t, root, v1.LockFile, lock)
+				}
+				repository := &fakeRepository{fetchErr: errors.New("unexpected fetch"), installErr: errors.New("unexpected install"), versionsErr: errors.New("unexpected tag lookup")}
+				require.NoError(t, tt.run(t, root, repository))
+				raw, err := os.ReadFile(filepath.Join(root, v1.ModuleFile))
+				require.NoError(t, err)
+				assert.Equal(t, manifest, string(raw))
+				raw, err = os.ReadFile(filepath.Join(root, v1.LockFile))
+				if existing {
+					require.NoError(t, err)
+					assert.Equal(t, lock, string(raw))
+				} else {
+					assert.ErrorIs(t, err, os.ErrNotExist)
+				}
+			})
+		}
+	}
+}
diff --git a/internal/modules/local_sources.go b/internal/modules/local_sources.go
new file mode 100644
index 00000000..892449b2
--- /dev/null
+++ b/internal/modules/local_sources.go
@@ -0,0 +1,142 @@
+package modules
+
+import (
+	"bytes"
+	"fmt"
+	"os"
+	"path/filepath"
+	"slices"
+
+	moduleconfig "github.com/easyp-tech/easyp/internal/adapters/module_config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+type localReplacements struct {
+	directory string
+	targets   map[string]string
+	modules   map[string]EffectiveModule
+	paths     map[string]string
+	localPath func(string) (string, error)
+}
+
+func newLocalReplacements(directory string, module v1.Module, localPath func(string) (string, error)) *localReplacements {
+	targets := make(map[string]string, len(module.Replaces))
+	for _, replacement := range module.Replaces {
+		targets[replacement.Module] = replacement.Target
+	}
+	return &localReplacements{directory: directory, targets: targets, modules: make(map[string]EffectiveModule), paths: make(map[string]string), localPath: localPath}
+}
+
+func (l *localReplacements) lookupRequirement(name, version string) (v1.Module, bool, error) {
+	if err := v1.ValidateModuleVersion(name, version); err != nil {
+		return v1.Module{}, false, fmt.Errorf("ValidateModuleVersion: %w", err)
+	}
+	// A local replacement has no published version. Go allows a native local
+	// module to replace a legacy +incompatible requirement; provenance checks
+	// belong to published Fetch/Install/Cached and the overlay never writes lock.
+	return l.lookup(name)
+}
+
+func (l *localReplacements) lookup(name string) (v1.Module, bool, error) {
+	target, ok := l.targets[name]
+	if !ok {
+		return v1.Module{}, false, nil
+	}
+	if entry, ok := l.modules[name]; ok {
+		return entry.Module, true, nil
+	}
+	directory := ResolveReplacementPath(l.directory, target)
+	if l.localPath != nil {
+		var err error
+		directory, err = l.localPath(target)
+		if err != nil {
+			return v1.Module{}, true, fmt.Errorf("local replacement %s => %s: %w", name, target, err)
+		}
+	}
+	entry, err := readLocalReplacement(directory, name)
+	if err != nil {
+		return v1.Module{}, true, fmt.Errorf("local replacement %s => %s: %w", name, target, err)
+	}
+	canonical, err := filepath.EvalSymlinks(directory)
+	if err != nil {
+		return v1.Module{}, true, fmt.Errorf("EvalSymlinks: %w", err)
+	}
+	if other, ok := l.paths[canonical]; ok && other != name {
+		return v1.Module{}, true, fmt.Errorf("local replacement %s => %s: directory already supplies module %s", name, target, other)
+	}
+	l.paths[canonical] = name
+	l.modules[name] = entry
+	return entry.Module, true, nil
+}
+
+func readLocalReplacement(directory, name string) (EffectiveModule, error) {
+	info, err := os.Stat(directory)
+	if err != nil {
+		return EffectiveModule{}, fmt.Errorf("Stat: %w", err)
+	}
+	if !info.IsDir() {
+		return EffectiveModule{}, fmt.Errorf("%s is not a directory", directory)
+	}
+	raw, err := os.ReadFile(filepath.Join(directory, v1.ModuleFile))
+	if err != nil && !os.IsNotExist(err) {
+		return EffectiveModule{}, fmt.Errorf("ReadFile: %w", err)
+	}
+	var module v1.Module
+	if v1.IsModuleManifest(raw) {
+		module, err = v1.ParseModule(bytes.NewReader(raw))
+		if err != nil {
+			return EffectiveModule{}, fmt.Errorf("ParseModule: %w", err)
+		}
+		if module.Name != name {
+			return EffectiveModule{}, fmt.Errorf("%s declares module %s, want %s", directory, module.Name, name)
+		}
+	} else {
+		// Compatibility reads only roots/requirements, never dependency plugins.
+		module, err = moduleconfig.ReadGitDependency(directory, name)
+		if err != nil {
+			return EffectiveModule{}, fmt.Errorf("ReadGitDependency: %w", err)
+		}
+	}
+	if _, err := ModuleSources(directory, module); err != nil {
+		return EffectiveModule{}, fmt.Errorf("ModuleSources: %w", err)
+	}
+	return EffectiveModule{Directory: directory, Module: module}, nil
+}
+
+func localDependencySources(moduleDir string, module v1.Module) (SourceRoots, error) {
+	locals := newLocalReplacements(moduleDir, module, nil)
+	visited := map[string]bool{module.Name: true}
+	queue := slices.Clone(module.Requires)
+	var roots SourceRoots
+	for len(queue) > 0 {
+		requirement := queue[0]
+		queue = queue[1:]
+		if visited[requirement.Module] {
+			continue
+		}
+		visited[requirement.Module] = true
+		dep, local, err := locals.lookupRequirement(requirement.Module, requirement.Version)
+		if err != nil {
+			return nil, err
+		}
+		if !local {
+			continue
+		}
+		source, err := ModuleSources(locals.modules[requirement.Module].Directory, dep)
+		if err != nil {
+			return nil, fmt.Errorf("ModuleSources: %w", err)
+		}
+		roots = append(roots, source...)
+		queue = append(queue, dep.Requires...)
+	}
+	return roots, nil
+}
+
+// ResolveReplacementPath resolves relative replacements from their owning manifest.
+// Absolute replacement paths are used directly.
+func ResolveReplacementPath(moduleDir, target string) string {
+	if filepath.IsAbs(target) {
+		return filepath.Clean(target)
+	}
+	return filepath.Clean(filepath.Join(moduleDir, target))
+}
diff --git a/internal/modules/local_test.go b/internal/modules/local_test.go
new file mode 100644
index 00000000..5d21cc81
--- /dev/null
+++ b/internal/modules/local_test.go
@@ -0,0 +1,70 @@
+package modules
+
+import (
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestLocalV1DependencyRootsFromLegacyAndBuf(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name      string
+		files     map[string]string
+		module    v1.Module
+		wantRoots []string
+	}{
+		{
+			name: "legacy_easyp_and_buf_workspace",
+			files: map[string]string{
+				"old-easyp/easyp.yaml":       "generate:\n  inputs:\n    - directory:\n        path: proto\n        root: proto\n",
+				"old-easyp/proto/item.proto": "syntax = \"proto3\";\n",
+				"old-buf/buf.work.yaml":      "version: v1\ndirectories: [schemas]\n",
+				"old-buf/schemas/item.proto": "syntax = \"proto3\";\n",
+			},
+			module: v1.Module{
+				Name:     "example.com/root",
+				Requires: []v1.Requirement{{Module: "example.com/old-easyp", Version: "v1.0.0"}, {Module: "example.com/old-buf", Version: "v1.0.0"}},
+				Replaces: []v1.Replacement{{Module: "example.com/old-easyp", Target: "old-easyp"}, {Module: "example.com/old-buf", Target: "old-buf"}},
+			},
+			wantRoots: []string{"old-easyp/proto", "old-buf/schemas"},
+		},
+		{
+			name: "dependency_without_config",
+			files: map[string]string{
+				"dependency/item.proto": "syntax = \"proto3\";\n",
+			},
+			module: v1.Module{
+				Name:     "example.com/root",
+				Requires: []v1.Requirement{{Module: "example.com/dependency", Version: "v1.0.0"}},
+				Replaces: []v1.Replacement{{Module: "example.com/dependency", Target: "dependency"}},
+			},
+			wantRoots: []string{"dependency"},
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			for path, content := range tt.files {
+				writeV1GenerateFixture(t, root, path, content)
+			}
+			want := make([]string, 0, len(tt.wantRoots))
+			for _, path := range tt.wantRoots {
+				want = append(want, filepath.Join(root, path))
+			}
+
+			roots, err := LocalSources(root, tt.module)
+
+			require.NoError(t, err)
+			assert.Equal(t, want, roots.Paths())
+		})
+	}
+}
diff --git a/internal/modules/locked_sources.go b/internal/modules/locked_sources.go
new file mode 100644
index 00000000..41ff81ea
--- /dev/null
+++ b/internal/modules/locked_sources.go
@@ -0,0 +1,144 @@
+package modules
+
+import (
+	"bytes"
+	"context"
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+
+	"golang.org/x/mod/semver"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// EnsureLockedSources loads import roots from verified cached modules
+// selected by the module's lockfile.
+func EnsureLockedSources(ctx context.Context, moduleDir string, module v1.Module, repository Cache) (SourceRoots, error) {
+	remoteRequires := RemoteRequirements(module)
+	if len(remoteRequires) == 0 {
+		return nil, nil
+	}
+	lock, err := ReadLock(filepath.Join(moduleDir, v1.LockFile))
+	if err != nil {
+		return nil, fmt.Errorf("read protobuf.lock for module %s; run easyp mod tidy: %w", module.Name, err)
+	}
+	if err := ValidateRequirements(remoteRequires, lock); err != nil {
+		return nil, err
+	}
+	replaced := replacedModules(module)
+	remoteLock := v1.Lock{Version: lock.Version}
+	for _, entry := range lock.Modules {
+		if !replaced[entry.Source] {
+			remoteLock.Modules = append(remoteLock.Modules, entry)
+		}
+	}
+	if err := repository.Install(ctx, remoteLock); err != nil {
+		return nil, err
+	}
+	return cachedSources(lock, replaced, repository)
+}
+
+// RemoteRequirements excludes requirements supplied by local replacements.
+func RemoteRequirements(module v1.Module) []v1.Requirement {
+	return unreplacedRequirements(module.Requires, replacedModules(module))
+}
+
+func replacedModules(module v1.Module) map[string]bool {
+	replaced := make(map[string]bool, len(module.Replaces))
+	for _, replacement := range module.Replaces {
+		replaced[replacement.Module] = true
+	}
+	return replaced
+}
+
+func unreplacedRequirements(requirements []v1.Requirement, replaced map[string]bool) []v1.Requirement {
+	var remoteRequires []v1.Requirement
+	for _, requirement := range requirements {
+		if !replaced[requirement.Module] {
+			remoteRequires = append(remoteRequires, requirement)
+		}
+	}
+	return remoteRequires
+}
+
+// ReadLock parses a lockfile without installing or changing dependencies.
+func ReadLock(path string) (v1.Lock, error) {
+	raw, err := os.ReadFile(path)
+	if os.IsNotExist(err) {
+		if _, legacyErr := os.Stat(filepath.Join(filepath.Dir(path), "easyp.lock")); legacyErr == nil {
+			return v1.Lock{}, fmt.Errorf("%w: easyp.lock needs verified conversion, not renaming", v1.ErrLegacyConfiguration)
+		}
+	}
+	if err != nil {
+		return v1.Lock{}, fmt.Errorf("ReadFile: %w", err)
+	}
+	lock, err := v1.ParseLock(bytes.NewReader(raw))
+	if err != nil {
+		return v1.Lock{}, fmt.Errorf("ParseLock: %w", err)
+	}
+	return lock, nil
+}
+
+// CachedSources reads installed module roots and validates their transitive requirements.
+// It does not install or verify cached contents; call Install first.
+func CachedSources(lock v1.Lock, repository Cache) (SourceRoots, error) {
+	return cachedSources(lock, nil, repository)
+}
+
+func cachedSources(lock v1.Lock, replaced map[string]bool, repository Cache) (SourceRoots, error) {
+	var roots SourceRoots
+	for _, entry := range lock.Modules {
+		if replaced[entry.Source] {
+			continue
+		}
+		installDir, dependency, err := repository.Cached(entry)
+		if err != nil {
+			return nil, fmt.Errorf("cached %s: %w", entry.Source, err)
+		}
+		if err := ValidateRequirements(unreplacedRequirements(dependency.Requires, replaced), lock); err != nil {
+			return nil, fmt.Errorf("dependency %s: %w", dependency.Name, err)
+		}
+		dependencyRoots, err := ModuleSources(installDir, dependency)
+		if err != nil {
+			return nil, fmt.Errorf("ModuleSources: %w", err)
+		}
+		roots = append(roots, dependencyRoots...)
+	}
+	return roots, nil
+}
+
+// ValidateRequirements checks that the lock satisfies every requested version or commit.
+func ValidateRequirements(requirements []v1.Requirement, lock v1.Lock) error {
+	locked := make(map[string]v1.LockedModule, len(lock.Modules))
+	for _, entry := range lock.Modules {
+		if err := v1.ValidateModuleVersion(entry.Source, entry.Version); err != nil {
+			return fmt.Errorf("ValidateModuleVersion: %w", err)
+		}
+		if _, duplicate := locked[entry.Source]; duplicate {
+			return fmt.Errorf("duplicate locked module %s", entry.Source)
+		}
+		locked[entry.Source] = entry
+	}
+	for _, requirement := range requirements {
+		if err := v1.ValidateModuleVersion(requirement.Module, requirement.Version); err != nil {
+			return fmt.Errorf("ValidateModuleVersion: %w", err)
+		}
+		entry, ok := locked[requirement.Module]
+		if !ok || !v1RequirementSatisfied(requirement.Version, entry) {
+			return fmt.Errorf("protobuf.lock does not satisfy %s %s; run easyp mod tidy", requirement.Module, requirement.Version)
+		}
+	}
+	return nil
+}
+
+func v1RequirementSatisfied(required string, entry v1.LockedModule) bool {
+	if required == "" {
+		return true
+	}
+	if v1.IsCommitRef(required) {
+		return strings.EqualFold(entry.Commit, required)
+	}
+	return semver.IsValid(entry.Version) && semver.Compare(entry.Version, required) >= 0
+}
diff --git a/internal/modules/locked_sources_test.go b/internal/modules/locked_sources_test.go
new file mode 100644
index 00000000..ed93323e
--- /dev/null
+++ b/internal/modules/locked_sources_test.go
@@ -0,0 +1,98 @@
+package modules
+
+import (
+	"context"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestEnsureSourcesExcludesReplacedModuleFromCache(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name      string
+		bRequires []v1.Requirement
+		wantError string
+	}{
+		{
+			name:      "replacement satisfies transitive requirement",
+			bRequires: []v1.Requirement{{Module: "example.com/A", Version: "v1.1.0"}},
+		},
+		{
+			name:      "unreplaced transitive requirement must be locked",
+			bRequires: []v1.Requirement{{Module: "example.com/C", Version: "v1.0.0"}},
+			wantError: "protobuf.lock does not satisfy example.com/C",
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			localA := filepath.Join(root, "local-A")
+			writeV1GenerateFixture(t, root, "local-A/protobuf.mod", "module example.com/A\n")
+			writeV1GenerateFixture(t, root, "local-A/a.proto", "syntax = \"proto3\";\n")
+			writeV1GenerateFixture(t, root, "proto/app.proto", "syntax = \"proto3\";\n")
+			cacheRoot := t.TempDir()
+			cachedA := filepath.Join(cacheRoot, "A")
+			cachedB := filepath.Join(cacheRoot, "B")
+			writeV1GenerateFixture(t, cachedA, "a.proto", "syntax = \"proto3\";\n")
+			writeV1GenerateFixture(t, cachedB, "b.proto", "syntax = \"proto3\";\n")
+			module := v1.Module{
+				Name: "example.com/app", Roots: []string{"proto"},
+				Requires: []v1.Requirement{{Module: "example.com/A", Version: "v1.0.0"}, {Module: "example.com/B", Version: "v1.0.0"}},
+				Replaces: []v1.Replacement{{Module: "example.com/A", Target: "local-A"}},
+			}
+			lock := v1.Lock{Version: 1, Modules: []v1.LockedModule{
+				{Source: "example.com/A", Version: "v1.0.0", Commit: versionlessCommitA, Hash: versionlessHash},
+				{Source: "example.com/B", Version: "v1.0.0", Commit: versionlessCommitBOld, Hash: versionlessHash},
+			}}
+			raw, err := yaml.Marshal(lock)
+			require.NoError(t, err)
+			require.NoError(t, os.WriteFile(filepath.Join(root, v1.LockFile), raw, 0o600))
+			cache := &trackingCache{modules: map[string]v1.Module{
+				"example.com/A": {Name: "example.com/A", Roots: []string{"."}},
+				"example.com/B": {Name: "example.com/B", Roots: []string{"."}, Requires: tt.bRequires},
+			}, directories: map[string]string{"example.com/A": cachedA, "example.com/B": cachedB}}
+
+			roots, err := EnsureSources(t.Context(), root, module, cache)
+
+			if tt.wantError != "" {
+				require.ErrorContains(t, err, tt.wantError)
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, []string{localA, cachedB}, roots.Paths())
+			assert.Equal(t, []v1.LockedModule{lock.Modules[1]}, cache.installed.Modules)
+			assert.Equal(t, []string{"example.com/B"}, cache.cached)
+			own, err := ModuleSources(root, module)
+			require.NoError(t, err)
+			assert.NoError(t, CheckSourceCollisions(append(own, roots...)))
+		})
+	}
+}
+
+type trackingCache struct {
+	modules     map[string]v1.Module
+	directories map[string]string
+	installed   v1.Lock
+	cached      []string
+}
+
+func (c *trackingCache) Install(_ context.Context, lock v1.Lock) error {
+	c.installed = lock
+	return nil
+}
+
+func (c *trackingCache) Cached(entry v1.LockedModule) (string, v1.Module, error) {
+	c.cached = append(c.cached, entry.Source)
+	return c.directories[entry.Source], c.modules[entry.Source], nil
+}
diff --git a/internal/modules/major_test.go b/internal/modules/major_test.go
new file mode 100644
index 00000000..30723cb2
--- /dev/null
+++ b/internal/modules/major_test.go
@@ -0,0 +1,48 @@
+package modules
+
+import (
+	"context"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+type majorSource struct {
+	result Fetched
+	calls  int
+}
+
+func (s *majorSource) Fetch(context.Context, string, string) (Fetched, error) {
+	s.calls++
+	return s.result, nil
+}
+
+func TestMajorFetchedIdentity(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct{ name, requested, declared, version string }{
+		{"wrong_identity", "example.com/repo/v2", "example.com/repo", "v2.0.0"},
+		{"head_identity", "example.com/repo/v2", "example.com/repo", ""},
+		{"commit_identity", "example.com/repo/v2", "example.com/repo", strings.Repeat("a", 40)},
+		{"missing_identity", "example.com/repo/v2", "", "v2.0.0"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			source := &majorSource{result: Fetched{Module: v1.Module{Name: tt.declared}, Lock: v1.LockedModule{Source: tt.requested, Version: tt.version, Commit: strings.Repeat("a", 40)}}}
+			_, err := Resolve(t.Context(), v1.Module{Requires: []v1.Requirement{{Module: tt.requested, Version: tt.version}}}, source, nil)
+			require.ErrorContains(t, err, "identity")
+		})
+	}
+}
+
+func TestMajorRequirementsBeforeFetch(t *testing.T) {
+	t.Parallel()
+	source := &majorSource{}
+	_, err := Resolve(t.Context(), v1.Module{Requires: []v1.Requirement{{Module: "example.com/repo", Version: "v2.0.0"}}}, source, nil)
+	require.Error(t, err)
+	require.Zero(t, source.calls)
+	err = ValidateRequirements([]v1.Requirement{{Module: "example.com/repo", Version: "v2.0.0"}}, v1.Lock{Version: 1, Modules: []v1.LockedModule{{Source: "example.com/repo", Version: "v2.1.0"}}})
+	require.Error(t, err)
+}
diff --git a/internal/modules/manifest_comments_test.go b/internal/modules/manifest_comments_test.go
new file mode 100644
index 00000000..fc64df5d
--- /dev/null
+++ b/internal/modules/manifest_comments_test.go
@@ -0,0 +1,20 @@
+package modules
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestManifestEditsPreserveHashComments(t *testing.T) {
+	t.Parallel()
+	original := "\ufeffmodule example.com/app\nrequire (\n  # ignored-module v9.0.0\n  https://example.com/dep v1.0.0 # keep this comment\n)\n"
+	parsed, err := v1.ParseModule(strings.NewReader(original))
+	require.NoError(t, err)
+	require.Equal(t, parsed.Requires, directV1Module([]byte(original), parsed).Requires)
+	got := rewriteV1RequiredVersions([]byte(original), map[string]string{"https://example.com/dep": "v1.1.0"})
+	require.Equal(t, strings.Replace(original, "v1.0.0", "v1.1.0", 1), string(got))
+}
diff --git a/internal/modules/manifest_edit.go b/internal/modules/manifest_edit.go
new file mode 100644
index 00000000..32923f0c
--- /dev/null
+++ b/internal/modules/manifest_edit.go
@@ -0,0 +1,164 @@
+package modules
+
+import (
+	"strings"
+	"unicode"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// v1RequirementLine keeps the source spelling so edits preserve comments and
+// whitespace outside the version or indirect marker being changed.
+type v1RequirementLine struct {
+	index         int
+	body          string
+	comment       string
+	commentPrefix string
+	hasComment    bool
+	module        string
+	version       string
+}
+
+func parseV1RequirementLines(lines []string) []v1RequirementLine {
+	var requirements []v1RequirementLine
+	block := ""
+	for i, line := range lines {
+		body, comment, hasComment := splitV1ManifestComment(line)
+		parseBody := body
+		if i == 0 {
+			parseBody = strings.TrimPrefix(parseBody, "\ufeff")
+		}
+		trimmed := strings.TrimSpace(parseBody)
+		if strings.HasSuffix(trimmed, "(") {
+			block = strings.TrimSpace(strings.TrimSuffix(trimmed, "("))
+			continue
+		}
+		if trimmed == ")" {
+			block = ""
+			continue
+		}
+		if block != "" && block != "require" {
+			continue
+		}
+		fields := strings.Fields(parseBody)
+		if block == "" {
+			if len(fields) == 0 || fields[0] != "require" {
+				continue
+			}
+			fields = fields[1:]
+		}
+		if len(fields) < 1 || len(fields) > 2 {
+			continue
+		}
+		entry := v1RequirementLine{index: i, body: body, comment: comment, hasComment: hasComment, module: fields[0]}
+		if hasComment && strings.HasPrefix(line[len(body):], "#") {
+			entry.commentPrefix = "#"
+		}
+		if len(fields) == 2 {
+			entry.version = fields[1]
+		}
+		requirements = append(requirements, entry)
+	}
+	return requirements
+}
+
+func (line v1RequirementLine) withVersion(version string) v1RequirementLine {
+	if version == line.version {
+		return line
+	}
+	if version == "" {
+		at := strings.LastIndex(line.body, line.version)
+		line.body = strings.TrimRight(line.body[:at], " \t") + line.body[at+len(line.version):]
+	} else if line.version == "" {
+		at := strings.LastIndex(line.body, line.module) + len(line.module)
+		line.body = line.body[:at] + " " + version + line.body[at:]
+	} else {
+		at := strings.LastIndex(line.body, line.version)
+		line.body = line.body[:at] + version + line.body[at+len(line.version):]
+	}
+	line.version = version
+	return line
+}
+
+func (line v1RequirementLine) indirect() bool {
+	words := strings.Fields(line.comment)
+	return line.hasComment && line.commentPrefix != "#" && len(words) > 0 && words[0] == "indirect"
+}
+
+func (line v1RequirementLine) direct() v1RequirementLine {
+	if !line.indirect() {
+		return line
+	}
+	line.comment = strings.TrimSpace(strings.TrimPrefix(strings.TrimSpace(line.comment), "indirect"))
+	line.hasComment = line.comment != ""
+	if line.hasComment {
+		line.comment = " " + line.comment
+		return line
+	}
+	line.body = strings.TrimRight(line.body, " \t")
+	return line
+}
+
+// directV1Module excludes requirements recorded as derived // indirect lines.
+// The parsed module keeps roots and replacements, while explicit requirements
+// remain the only inputs to dependency resolution during an update.
+func directV1Module(original []byte, module v1.Module) v1.Module {
+	module.Requires = nil
+	for _, line := range parseV1RequirementLines(strings.Split(string(original), "\n")) {
+		if !line.indirect() {
+			module.Requires = append(module.Requires, v1.Requirement{Module: line.module, Version: line.version})
+		}
+	}
+	return module
+}
+
+func (line v1RequirementLine) String() string {
+	if line.hasComment {
+		prefix := line.commentPrefix
+		if prefix == "" {
+			prefix = "//"
+		}
+		return line.body + prefix + line.comment
+	}
+	return line.body
+}
+
+type v1ManifestRequirement struct {
+	v1.Requirement
+	indirect bool
+}
+
+func appendV1Requirements(original []byte, requirements []v1ManifestRequirement) []byte {
+	if len(requirements) == 0 {
+		return original
+	}
+	updated := append([]byte(nil), original...)
+	if len(updated) > 0 && updated[len(updated)-1] != '\n' {
+		updated = append(updated, '\n')
+	}
+	for _, requirement := range requirements {
+		line := "require " + requirement.Module
+		if requirement.Version != "" {
+			line += " " + requirement.Version
+		}
+		if requirement.indirect {
+			line += " // indirect"
+		}
+		updated = append(updated, []byte(line+"\n")...)
+	}
+	return updated
+}
+
+func splitV1ManifestComment(line string) (string, string, bool) {
+	tokenStart := true
+	for i, char := range line {
+		if tokenStart && char == '#' {
+			return line[:i], line[i+1:], true
+		}
+		if tokenStart && strings.HasPrefix(line[i:], "//") {
+			return line[:i], line[i+2:], true
+		}
+		tokenStart = unicode.IsSpace(char)
+	}
+	return line, "", false
+}
diff --git a/internal/modules/manifest_edit_test.go b/internal/modules/manifest_edit_test.go
new file mode 100644
index 00000000..1b6a5f37
--- /dev/null
+++ b/internal/modules/manifest_edit_test.go
@@ -0,0 +1,110 @@
+package modules
+
+import (
+	"bytes"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestV1RequirementEditsRespectModuleBlocks(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name        string
+		original    string
+		wantDirect  string
+		wantUpdated string
+	}{
+		{
+			name:        "versionless_looking_roots_are_not_requirements",
+			original:    "module example.com/app\nroots ( // source directories\n  require example.com/dep\n)\n",
+			wantDirect:  "module example.com/app\nroots ( // source directories\n  require example.com/dep\n)\nrequire example.com/dep v1.1.0\n",
+			wantUpdated: "module example.com/app\nroots ( // source directories\n  require example.com/dep\n)\n",
+		},
+		{
+			name:        "version_looking_root_is_not_rewritten",
+			original:    "module example.com/app\nroots(\n  require example.com/dep v1.0.0 // directory names\n) // end roots\n",
+			wantDirect:  "module example.com/app\nroots(\n  require example.com/dep v1.0.0 // directory names\n) // end roots\nrequire example.com/dep v1.1.0\n",
+			wantUpdated: "module example.com/app\nroots(\n  require example.com/dep v1.0.0 // directory names\n) // end roots\n",
+		},
+		{
+			name:        "roots_do_not_duplicate_standalone_requirement",
+			original:    "module example.com/app\nroots (\n  require example.com/dep v1.0.0\n)\nrequire example.com/dep v1.0.0 // indirect\n",
+			wantDirect:  "module example.com/app\nroots (\n  require example.com/dep v1.0.0\n)\nrequire example.com/dep v1.1.0\n",
+			wantUpdated: "module example.com/app\nroots (\n  require example.com/dep v1.0.0\n)\nrequire example.com/dep v1.1.0 // indirect\n",
+		},
+		{
+			name:        "require_block_after_replace_with_comments",
+			original:    "module example.com/app\nreplace ( // local development\n  example.com/dep => ./local\n)\nrequire( // dependencies\n  example.com/dep v1.0.0 // indirect\n) // end dependencies\n",
+			wantDirect:  "module example.com/app\nreplace ( // local development\n  example.com/dep => ./local\n)\nrequire( // dependencies\n  example.com/dep v1.1.0\n) // end dependencies\n",
+			wantUpdated: "module example.com/app\nreplace ( // local development\n  example.com/dep => ./local\n)\nrequire( // dependencies\n  example.com/dep v1.1.0 // indirect\n) // end dependencies\n",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			original := []byte(tt.original)
+			module, err := v1.ParseModule(bytes.NewReader(original))
+			require.NoError(t, err)
+			target := v1.Requirement{Module: "example.com/dep", Version: "v1.1.0"}
+
+			direct, err := addDirectV1Requirement(original, target)
+			updated := rewriteV1RequiredVersions(original, map[string]string{target.Module: target.Version})
+
+			require.NoError(t, err)
+			assert.Equal(t, tt.wantDirect, string(direct))
+			assert.Equal(t, tt.wantUpdated, string(updated))
+			assert.Equal(t, tt.original, string(original))
+			for _, result := range [][]byte{direct, updated} {
+				parsed, err := v1.ParseModule(bytes.NewReader(result))
+				require.NoError(t, err)
+				assert.Equal(t, module.Roots, parsed.Roots)
+				assert.Equal(t, module.Replaces, parsed.Replaces)
+			}
+		})
+	}
+}
+
+func TestDirectV1Module(t *testing.T) {
+	t.Parallel()
+	const commit = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+	tests := []struct {
+		name     string
+		manifest string
+		want     []v1.Requirement
+	}{
+		{
+			name:     "explicit commit remains a direct constraint",
+			manifest: "module example.com/app\nrequire example.com/dep " + commit + " // user pin\n",
+			want:     []v1.Requirement{{Module: "example.com/dep", Version: commit}},
+		},
+		{
+			name:     "derived commit is excluded",
+			manifest: "module example.com/app\nrequire (\n  example.com/direct\n  example.com/dep " + commit + " // indirect\n)\n",
+			want:     []v1.Requirement{{Module: "example.com/direct"}},
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			original := []byte(tt.manifest)
+			module, err := v1.ParseModule(bytes.NewReader(original))
+			require.NoError(t, err)
+
+			direct := directV1Module(original, module)
+
+			assert.Equal(t, tt.want, direct.Requires)
+			assert.Equal(t, module.Name, direct.Name)
+			assert.Equal(t, module.Roots, direct.Roots)
+			assert.Equal(t, module.Replaces, direct.Replaces)
+		})
+	}
+}
diff --git a/internal/modules/manifest_requirements.go b/internal/modules/manifest_requirements.go
new file mode 100644
index 00000000..8fb397d8
--- /dev/null
+++ b/internal/modules/manifest_requirements.go
@@ -0,0 +1,120 @@
+package modules
+
+import (
+	"bytes"
+	"errors"
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// augmentV1ManifestRequirements records selected transitive modules. A module
+// imported by a root .proto file is direct even if it arrived transitively.
+func augmentV1ManifestRequirements(original []byte, root string, module v1.Module, lock v1.Lock, repository Cache) ([]byte, error) {
+	lines := strings.Split(string(original), "\n")
+	indirect := make(map[string]v1RequirementLine)
+	for _, line := range parseV1RequirementLines(lines) {
+		if line.indirect() {
+			indirect[line.module] = line
+		}
+	}
+	existing := make(map[string]bool, len(module.Requires))
+	for _, requirement := range module.Requires {
+		existing[requirement.Module] = true
+	}
+	imports, err := v1RootImports(root, module.Roots)
+	if err != nil {
+		return nil, fmt.Errorf("v1RootImports: %w", err)
+	}
+	versions, err := manifestRequirementVersions(lock, repository)
+	if err != nil {
+		return nil, fmt.Errorf("manifestRequirementVersions: %w", err)
+	}
+	var additions []v1ManifestRequirement
+	for _, entry := range lock.Modules {
+		if _, derived := indirect[entry.Source]; existing[entry.Source] && !derived {
+			continue
+		}
+		installDir, dependency, err := repository.Cached(entry)
+		if err != nil {
+			return nil, fmt.Errorf("Cached: %w", err)
+		}
+		direct := false
+		for _, depRoot := range dependency.Roots {
+			base := filepath.Join(installDir, depRoot)
+			for importPath := range imports {
+				if !filepath.IsLocal(importPath) {
+					continue
+				}
+				info, err := os.Stat(filepath.Join(base, filepath.FromSlash(importPath)))
+				if errors.Is(err, os.ErrNotExist) {
+					continue
+				}
+				if err != nil {
+					return nil, fmt.Errorf("Stat: %w", err)
+				}
+				if info.Mode().IsRegular() {
+					direct = true
+					break
+				}
+			}
+			if direct {
+				break
+			}
+		}
+		if line, ok := indirect[entry.Source]; ok {
+			if !existing[entry.Source] {
+				line = line.withVersion(versions[entry.Source])
+			}
+			if direct {
+				line = line.direct()
+			}
+			lines[line.index] = line.String()
+			delete(indirect, entry.Source)
+			continue
+		}
+		additions = append(additions, v1ManifestRequirement{Requirement: v1.Requirement{Module: entry.Source, Version: versions[entry.Source]}, indirect: !direct})
+	}
+	if len(indirect) > 0 {
+		stale := make(map[int]bool, len(indirect))
+		for _, line := range indirect {
+			stale[line.index] = true
+		}
+		kept := make([]string, 0, len(lines)-len(stale))
+		for index, line := range lines {
+			if !stale[index] {
+				kept = append(kept, line)
+			}
+		}
+		lines = kept
+	}
+	updated := appendV1Requirements([]byte(strings.Join(lines, "\n")), additions)
+	if _, err := v1.ParseModule(bytes.NewReader(updated)); err != nil {
+		return nil, fmt.Errorf("ParseModule: %w", err)
+	}
+	return updated, nil
+}
+
+func v1RootImports(moduleDir string, roots []string) (map[string]bool, error) {
+	imports := make(map[string]bool)
+	for _, root := range roots {
+		sourceRoot := filepath.Join(moduleDir, root)
+		err := WalkProtoFiles(sourceRoot, func(path string) error {
+			paths, err := ReadProtoImports(path)
+			if err != nil {
+				return fmt.Errorf("ReadProtoImports: %w", err)
+			}
+			for _, importPath := range paths {
+				imports[importPath] = true
+			}
+			return nil
+		})
+		if err != nil {
+			return nil, fmt.Errorf("WalkProtoFiles: %w", err)
+		}
+	}
+	return imports, nil
+}
diff --git a/internal/modules/manifest_requirements_test.go b/internal/modules/manifest_requirements_test.go
new file mode 100644
index 00000000..8effe192
--- /dev/null
+++ b/internal/modules/manifest_requirements_test.go
@@ -0,0 +1,58 @@
+package modules
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestAugmentManifestPromotesExistingIndirect(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name     string
+		original string
+		want     string
+	}{
+		{
+			name:     "standalone",
+			original: "module example.com/app // keep\n\nrequire\texample.com/dep\t v1.0.0 // indirect\n",
+			want:     "module example.com/app // keep\n\nrequire\texample.com/dep\t v1.0.0\n",
+		},
+		{
+			name:     "block_with_other_comments",
+			original: "module example.com/app\nrequire ( // dependencies\n\t// keep above\n\texample.com/dep\t v1.0.0  // indirect needed by clients\n) // keep below\n",
+			want:     "module example.com/app\nrequire ( // dependencies\n\t// keep above\n\texample.com/dep\t v1.0.0  // needed by clients\n) // keep below\n",
+		},
+		{
+			name:     "versionless",
+			original: "module example.com/app\nrequire example.com/dep // indirect keep HEAD\n",
+			want:     "module example.com/app\nrequire example.com/dep // keep HEAD\n",
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root, dependency := t.TempDir(), t.TempDir()
+			writeV1GenerateFixture(t, root, "root.proto", `syntax = "proto3"; import "dep.proto";`)
+			writeV1GenerateFixture(t, dependency, "proto/dep.proto", `syntax = "proto3";`)
+			module, err := v1.ParseModule(strings.NewReader(tt.original))
+			require.NoError(t, err)
+			lock := v1.Lock{Version: 1, Modules: []v1.LockedModule{{Source: "example.com/dep", Version: "v1.2.0", Commit: "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}}}
+			before := v1.Lock{Version: lock.Version, Modules: append([]v1.LockedModule(nil), lock.Modules...)}
+			repository := &fakeRepository{directory: dependency, module: v1.Module{Name: "example.com/dep", Roots: []string{"proto"}}}
+			original := []byte(tt.original)
+
+			updated, err := augmentV1ManifestRequirements(original, root, module, lock, repository)
+
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, string(updated))
+			assert.Equal(t, tt.original, string(original))
+			assert.Equal(t, before, lock)
+			assert.False(t, repository.installed)
+		})
+	}
+}
diff --git a/internal/modules/manifest_test.go b/internal/modules/manifest_test.go
new file mode 100644
index 00000000..6248c288
--- /dev/null
+++ b/internal/modules/manifest_test.go
@@ -0,0 +1,110 @@
+package modules
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestWriteV1ResolvedFiles(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name          string
+		updated       string
+		lockDirectory bool
+		wantManifest  string
+		wantErr       bool
+	}{
+		{
+			name:         "write manifest and lock",
+			updated:      "module example.com/root\nrequire example.com/dep\n",
+			wantManifest: "module example.com/root\nrequire example.com/dep\n",
+		},
+		{
+			name:          "restore changed manifest when lock cannot replace",
+			updated:       "module example.com/root\nrequire example.com/dep\n",
+			lockDirectory: true,
+			wantManifest:  "module example.com/root\n",
+			wantErr:       true,
+		},
+		{
+			name:          "preserve unchanged manifest when lock cannot replace",
+			updated:       "module example.com/root\n",
+			lockDirectory: true,
+			wantManifest:  "module example.com/root\n",
+			wantErr:       true,
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			original := []byte("module example.com/root\n")
+			require.NoError(t, os.WriteFile(filepath.Join(root, v1.ModuleFile), original, 0o600))
+			if tt.lockDirectory {
+				require.NoError(t, os.Mkdir(filepath.Join(root, v1.LockFile), 0o755))
+			}
+
+			err := writeV1ResolvedFiles(root, original, []byte(tt.updated), v1.Lock{Version: 1})
+
+			if tt.wantErr {
+				var pathErr *os.LinkError
+				require.ErrorAs(t, err, &pathErr)
+				assert.Equal(t, "rename", pathErr.Op)
+				assert.Equal(t, filepath.Join(root, v1.LockFile), pathErr.New)
+			} else {
+				require.NoError(t, err)
+				lock, err := ReadLock(filepath.Join(root, v1.LockFile))
+				require.NoError(t, err)
+				assert.Equal(t, 1, lock.Version)
+			}
+			current, err := os.ReadFile(filepath.Join(root, v1.ModuleFile))
+			require.NoError(t, err)
+			assert.Equal(t, tt.wantManifest, string(current))
+			entries, err := os.ReadDir(root)
+			require.NoError(t, err)
+			assert.Len(t, entries, 2)
+		})
+	}
+}
+
+func TestReadModuleOrDefault(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name     string
+		manifest string
+		want     v1.Module
+		wantErr  string
+	}{
+		{name: "missing manifest", want: v1.Module{Roots: []string{"."}}},
+		{name: "declared roots", manifest: "module example.com/app\nroots proto\n", want: v1.Module{Name: "example.com/app", Roots: []string{"proto"}}},
+		{name: "invalid manifest", manifest: "roots proto\n", wantErr: "missing module directive"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			if tt.manifest != "" {
+				require.NoError(t, os.WriteFile(filepath.Join(root, v1.ModuleFile), []byte(tt.manifest), 0o644))
+			}
+
+			module, err := ReadModuleOrDefault(root)
+
+			if tt.wantErr != "" {
+				require.ErrorContains(t, err, tt.wantErr)
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, module)
+		})
+	}
+}
diff --git a/internal/modules/manifest_versions.go b/internal/modules/manifest_versions.go
new file mode 100644
index 00000000..cf8432e7
--- /dev/null
+++ b/internal/modules/manifest_versions.go
@@ -0,0 +1,33 @@
+package modules
+
+import (
+	"fmt"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// manifestRequirementVersions keeps an inferred Git HEAD out of protobuf.mod.
+// Exact commits declared by a dependency remain explicit requirements.
+func manifestRequirementVersions(lock v1.Lock, repository Cache) (map[string]string, error) {
+	explicitCommits := make(map[string]bool)
+	for _, entry := range lock.Modules {
+		_, dependency, err := repository.Cached(entry)
+		if err != nil {
+			return nil, fmt.Errorf("cached %s: %w", entry.Source, err)
+		}
+		for _, requirement := range dependency.Requires {
+			if v1.IsCommitRef(requirement.Version) {
+				explicitCommits[requirement.Module] = true
+			}
+		}
+	}
+	versions := make(map[string]string, len(lock.Modules))
+	for _, entry := range lock.Modules {
+		version := entry.Version
+		if v1.IsCommitRef(version) && !explicitCommits[entry.Source] {
+			version = ""
+		}
+		versions[entry.Source] = version
+	}
+	return versions, nil
+}
diff --git a/internal/modules/mixed_versions_test.go b/internal/modules/mixed_versions_test.go
new file mode 100644
index 00000000..d1f2349d
--- /dev/null
+++ b/internal/modules/mixed_versions_test.go
@@ -0,0 +1,84 @@
+package modules
+
+import (
+	"slices"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestMixedRequirementKindsAreOrderIndependent(t *testing.T) {
+	t.Parallel()
+	a, b := strings.Repeat("a", 40), strings.Repeat("b", 40)
+	for _, tc := range []struct {
+		name     string
+		weak     bool
+		pin      string
+		conflict bool
+	}{
+		{name: "tag and same commit", pin: a}, {name: "tag and different commit", pin: b, conflict: true}, {name: "tag and versionless", weak: true},
+	} {
+		t.Run(tc.name, func(t *testing.T) {
+			t.Parallel()
+			var first *v1.Lock
+			for _, reverse := range []bool{false, true} {
+				requires := []v1.Requirement{{Module: "a", Version: "v1.0.0"}, {Module: "bridge", Version: "v1.0.0"}}
+				if reverse {
+					slices.Reverse(requires)
+				}
+				version := tc.pin
+				source := &fakeSource{revisions: map[string]Fetched{
+					"a@v1.0.0":      {Lock: v1.LockedModule{Source: "a", Version: "v1.0.0", Commit: a}},
+					"a@" + a:        {Lock: v1.LockedModule{Source: "a", Version: a, Commit: a}},
+					"a@" + b:        {Lock: v1.LockedModule{Source: "a", Version: b, Commit: b}},
+					"bridge@v1.0.0": {Module: v1.Module{Requires: []v1.Requirement{{Module: "a", Version: version}}}, Lock: v1.LockedModule{Source: "bridge", Version: "v1.0.0", Commit: b}},
+				}}
+				got, err := Resolve(t.Context(), v1.Module{Requires: requires}, source, nil)
+				if tc.conflict {
+					require.ErrorContains(t, err, "conflicting requirements")
+					continue
+				}
+				require.NoError(t, err)
+				require.Equal(t, "v1.0.0", got.Modules[0].Version)
+				if first != nil {
+					require.Equal(t, *first, got)
+				} else {
+					first = &got
+				}
+				require.NotContains(t, source.calls, "a@")
+			}
+		})
+	}
+}
+
+func TestSupersededHeadDoesNotLeakDependencies(t *testing.T) {
+	t.Parallel()
+	a, b := strings.Repeat("a", 40), strings.Repeat("b", 40)
+	source := &fakeSource{revisions: map[string]Fetched{
+		"a@":              {Module: v1.Module{Requires: []v1.Requirement{{Module: "obsolete", Version: "v1.0.0"}}}, Lock: v1.LockedModule{Source: "a", Version: a, Commit: a}},
+		"a@v1.0.0":        {Lock: v1.LockedModule{Source: "a", Version: "v1.0.0", Commit: b}},
+		"bridge@":         {Module: v1.Module{Requires: []v1.Requirement{{Module: "a", Version: "v1.0.0"}}}, Lock: v1.LockedModule{Source: "bridge", Version: b, Commit: b}},
+		"obsolete@v1.0.0": {Lock: v1.LockedModule{Source: "obsolete", Version: "v1.0.0", Commit: a}},
+	}}
+	got, err := Resolve(t.Context(), v1.Module{Requires: []v1.Requirement{{Module: "a"}, {Module: "bridge"}}}, source, nil)
+	require.NoError(t, err)
+	require.Len(t, got.Modules, 2)
+	require.Equal(t, "a", got.Modules[0].Source)
+	require.Equal(t, "v1.0.0", got.Modules[0].Version)
+}
+
+func TestUnavailableDependencyOfSupersededHeadIsIgnored(t *testing.T) {
+	t.Parallel()
+	a, b := strings.Repeat("a", 40), strings.Repeat("b", 40)
+	source := &fakeSource{revisions: map[string]Fetched{
+		"a@":       {Module: v1.Module{Requires: []v1.Requirement{{Module: "unavailable", Version: "v1.0.0"}}}, Lock: v1.LockedModule{Source: "a", Version: a, Commit: a}},
+		"a@v1.0.0": {Lock: v1.LockedModule{Source: "a", Version: "v1.0.0", Commit: b}},
+		"bridge@":  {Module: v1.Module{Requires: []v1.Requirement{{Module: "a", Version: "v1.0.0"}}}, Lock: v1.LockedModule{Source: "bridge", Version: b, Commit: b}},
+	}}
+	got, err := Resolve(t.Context(), v1.Module{Requires: []v1.Requirement{{Module: "a"}, {Module: "bridge"}}}, source, nil)
+	require.NoError(t, err)
+	require.Len(t, got.Modules, 2)
+}
diff --git a/internal/modules/operations.go b/internal/modules/operations.go
new file mode 100644
index 00000000..b2a2709c
--- /dev/null
+++ b/internal/modules/operations.go
@@ -0,0 +1,104 @@
+package modules
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"os"
+	"path/filepath"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// Tidy resolves v1 requirements and records published commits and hashes.
+// With local replacements it only validates/installs the ephemeral graph.
+func Tidy(ctx context.Context, root string, repository Repository) error {
+	original, module, err := ReadManifest(root)
+	if err != nil {
+		return fmt.Errorf("ReadManifest: %w", err)
+	}
+	if len(module.Replaces) > 0 {
+		return validateLocalOverlay(ctx, root, module, repository, false)
+	}
+	existing, err := ReadLock(filepath.Join(root, v1.LockFile))
+	if err != nil && !errors.Is(err, os.ErrNotExist) {
+		return fmt.Errorf("ReadLock: %w", err)
+	}
+	lock, err := resolveV1LockWithPins(ctx, root, module, existing, repository)
+	if err != nil {
+		return fmt.Errorf("resolveV1LockWithPins: %w", err)
+	}
+	updated, err := augmentV1ManifestRequirements(original, root, module, lock, repository)
+	if err != nil {
+		return fmt.Errorf("augmentV1ManifestRequirements: %w", err)
+	}
+	return writeV1ResolvedFiles(root, original, updated, lock)
+}
+
+func resolveV1LockWithPins(ctx context.Context, root string, module v1.Module, existing v1.Lock, repository Repository) (v1.Lock, error) {
+	if len(module.Replaces) > 0 {
+		return v1.Lock{}, fmt.Errorf("module %s: remove local replacements before writing a reproducible lock", module.Name)
+	}
+	return resolveV1Lock(ctx, root, module, existing, repository, true)
+}
+
+func resolveV1Lock(ctx context.Context, root string, module v1.Module, existing v1.Lock, repository Repository, preserveHeads bool) (v1.Lock, error) {
+	pins := make(map[string]v1.LockedModule, len(existing.Modules))
+	for _, entry := range existing.Modules {
+		pins[entry.Source] = entry
+	}
+	guard := lockedVersionSource{Source: repository, locked: pins}
+	if !preserveHeads {
+		pins = nil
+	}
+	lock, err := Resolve(ctx, module, guard, pins)
+	if err != nil {
+		return v1.Lock{}, fmt.Errorf("module %s: %w", module.Name, err)
+	}
+	if err := repository.Install(ctx, lock); err != nil {
+		return v1.Lock{}, fmt.Errorf("module %s: %w", module.Name, err)
+	}
+	dependencyRoots, err := CachedSources(lock, repository)
+	if err != nil {
+		return v1.Lock{}, fmt.Errorf("module %s: %w", module.Name, err)
+	}
+	own, err := ModuleSources(root, module)
+	if err != nil {
+		return v1.Lock{}, fmt.Errorf("ModuleSources: %w", err)
+	}
+	if err := CheckSourceCollisions(append(own, dependencyRoots...)); err != nil {
+		return v1.Lock{}, fmt.Errorf("module %s: %w", module.Name, err)
+	}
+	unresolved, err := findUnresolvedV1ImportsWithSources(root, module.Roots, dependencyRoots)
+	if err != nil {
+		return v1.Lock{}, fmt.Errorf("findUnresolvedV1ImportsWithSources: %w", err)
+	}
+	if len(unresolved) > 0 {
+		return v1.Lock{}, fmt.Errorf("module %s: cannot resolve imports %v", module.Name, unresolved)
+	}
+	return lock, nil
+}
+
+// Download installs published pins, or needed unreplaced snapshots in local
+// overlay mode. It never changes the shared manifest or lock.
+func Download(ctx context.Context, root string, repository Cache) error {
+	_, module, err := ReadManifest(root)
+	if err != nil {
+		return fmt.Errorf("ReadManifest: %w", err)
+	}
+	if len(module.Replaces) > 0 {
+		return validateLocalOverlay(ctx, root, module, repository, false)
+	}
+	lock, err := ReadLock(filepath.Join(root, v1.LockFile))
+	if err != nil {
+		return fmt.Errorf("read protobuf.lock; run easyp mod tidy: %w", err)
+	}
+	if err := ValidateRequirements(RemoteRequirements(module), lock); err != nil {
+		return err
+	}
+	if err := repository.Install(ctx, lock); err != nil {
+		return err
+	}
+	_, err = CachedSources(lock, repository)
+	return err
+}
diff --git a/internal/modules/operations_test.go b/internal/modules/operations_test.go
new file mode 100644
index 00000000..941e9d5e
--- /dev/null
+++ b/internal/modules/operations_test.go
@@ -0,0 +1,250 @@
+package modules
+
+import (
+	"context"
+	"errors"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestTidyPreservesFilesOnDependencyFailure(t *testing.T) {
+	t.Parallel()
+	dependencyErr := errors.New("dependency failed")
+	tests := []struct {
+		name                            string
+		fetchErr, installErr, cachedErr error
+		wantInstall                     bool
+	}{
+		{name: "metadata fetch failed", fetchErr: dependencyErr},
+		{name: "installation failed", installErr: dependencyErr, wantInstall: true},
+		{name: "cached metadata failed", cachedErr: dependencyErr, wantInstall: true},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			original := []byte("module example.com/app\nrequire example.com/dep v1.0.0 // keep\n")
+			require.NoError(t, os.WriteFile(filepath.Join(root, v1.ModuleFile), original, 0o600))
+			lock := []byte("version: 1\nmodules: []\n")
+			require.NoError(t, os.WriteFile(filepath.Join(root, v1.LockFile), lock, 0o600))
+			repository := &fakeRepository{fetchErr: tt.fetchErr, installErr: tt.installErr, cachedErr: tt.cachedErr}
+
+			err := Tidy(t.Context(), root, repository)
+
+			require.ErrorIs(t, err, dependencyErr)
+			assert.Equal(t, tt.wantInstall, repository.installed)
+			manifestAfter, err := os.ReadFile(filepath.Join(root, v1.ModuleFile))
+			require.NoError(t, err)
+			assert.Equal(t, original, manifestAfter)
+			lockAfter, err := os.ReadFile(filepath.Join(root, v1.LockFile))
+			require.NoError(t, err)
+			assert.Equal(t, lock, lockAfter)
+		})
+	}
+}
+
+func TestTidyPreservesFilesOnReachableImportFailure(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name       string
+		dependency string
+		wantError  string
+	}{
+		{name: "missing_transitive", dependency: `syntax = "proto3"; import "missing.proto";`, wantError: "missing.proto"},
+		{name: "fake_wellknown", dependency: `syntax = "proto3"; import "google/protobuf/not_real.proto";`, wantError: "google/protobuf/not_real.proto"},
+		{name: "invalid_syntax", dependency: `syntax = "proto3"; message Broken {`, wantError: "Parse"},
+		{name: "traversing_import", dependency: `syntax = "proto3"; import "../outside.proto";`, wantError: "invalid import"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			for _, existingLock := range []bool{false, true} {
+				root, dependency := t.TempDir(), t.TempDir()
+				original := "module example.com/app\nrequire example.com/dep v1.0.0 // keep\n"
+				lock := "# keep existing lock\nversion: 1\nmodules: []\n"
+				writeV1GenerateFixture(t, root, v1.ModuleFile, original)
+				if existingLock {
+					writeV1GenerateFixture(t, root, v1.LockFile, lock)
+				}
+				writeV1GenerateFixture(t, root, "root.proto", `syntax = "proto3"; import "dep.proto";`)
+				writeV1GenerateFixture(t, dependency, "dep.proto", tt.dependency)
+				repository := &fakeRepository{directory: dependency, module: v1.Module{Name: "example.com/dep", Roots: []string{"."}}}
+
+				err := Tidy(t.Context(), root, repository)
+
+				assert.ErrorContains(t, err, tt.wantError)
+				assert.ErrorContains(t, err, filepath.Join(dependency, "dep.proto"))
+				manifestAfter, err := os.ReadFile(filepath.Join(root, v1.ModuleFile))
+				require.NoError(t, err)
+				assert.Equal(t, original, string(manifestAfter))
+				lockAfter, err := os.ReadFile(filepath.Join(root, v1.LockFile))
+				if existingLock {
+					require.NoError(t, err)
+					assert.Equal(t, lock, string(lockAfter))
+				} else {
+					assert.ErrorIs(t, err, os.ErrNotExist)
+				}
+			}
+		})
+	}
+}
+
+func TestTidyPromotesIndirectWithoutChangingLock(t *testing.T) {
+	t.Parallel()
+	root, dependency := t.TempDir(), t.TempDir()
+	original := "module example.com/app\nrequire ( // keep block\n\texample.com/dep\t v1.0.0  // indirect needed by clients\n)\n"
+	writeV1GenerateFixture(t, root, v1.ModuleFile, original)
+	writeV1GenerateFixture(t, root, "root.proto", `syntax = "proto3";`)
+	writeV1GenerateFixture(t, dependency, "dep.proto", `syntax = "proto3";`)
+	repository := &fakeRepository{directory: dependency, module: v1.Module{Name: "example.com/dep", Roots: []string{"."}}}
+	require.NoError(t, Tidy(t.Context(), root, repository))
+	lockBefore, err := os.ReadFile(filepath.Join(root, v1.LockFile))
+	require.NoError(t, err)
+	writeV1GenerateFixture(t, root, "root.proto", `syntax = "proto3"; import "dep.proto";`)
+
+	err = Tidy(t.Context(), root, repository)
+
+	require.NoError(t, err)
+	manifestAfter, err := os.ReadFile(filepath.Join(root, v1.ModuleFile))
+	require.NoError(t, err)
+	assert.Equal(t, "module example.com/app\nrequire ( // keep block\n\texample.com/dep\t v1.0.0  // needed by clients\n)\n", string(manifestAfter))
+	lockAfter, err := os.ReadFile(filepath.Join(root, v1.LockFile))
+	require.NoError(t, err)
+	assert.Equal(t, lockBefore, lockAfter)
+}
+
+func TestAugmentManifestClassifiesTransitiveImports(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name   string
+		source string
+		suffix string
+	}{
+		{name: "imported transitive dependency is direct", source: "syntax = \"proto3\"; import \"dep.proto\";", suffix: "\n"},
+		{name: "unreferenced transitive dependency is indirect", source: "syntax = \"proto3\";", suffix: " // indirect\n"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root, dependency := t.TempDir(), t.TempDir()
+			writeV1GenerateFixture(t, root, "root.proto", tt.source)
+			writeV1GenerateFixture(t, dependency, "proto/dep.proto", "syntax = \"proto3\";")
+			original := []byte("module example.com/app // keep\n")
+			module := v1.Module{Name: "example.com/app", Roots: []string{"."}}
+			lock := v1.Lock{Version: 1, Modules: []v1.LockedModule{{Source: "example.com/dep", Version: "v1.0.0"}}}
+			repository := &fakeRepository{directory: dependency, module: v1.Module{Name: "example.com/dep", Roots: []string{"proto"}}}
+
+			updated, err := augmentV1ManifestRequirements(original, root, module, lock, repository)
+
+			require.NoError(t, err)
+			assert.Equal(t, "module example.com/app // keep\nrequire example.com/dep v1.0.0"+tt.suffix, string(updated))
+			assert.Equal(t, "module example.com/app // keep\n", string(original))
+			assert.False(t, repository.installed)
+		})
+	}
+}
+
+func TestLatestCompatibleTag(t *testing.T) {
+	t.Parallel()
+	const commit = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+	versionsErr := errors.New("cannot list versions")
+	tests := []struct {
+		name, current string
+		versions      []string
+		sourceErr     error
+		want          string
+		wantErr       error
+		wantMessage   string
+		wantRead      bool
+	}{
+		{name: "versionless uses HEAD without listing tags"},
+		{name: "explicit commit stays pinned", current: commit, want: commit},
+		{name: "stable stays in major and excludes prereleases", current: "v1.2.0", versions: []string{"v2.0.0", "v1.3.0-rc.1", "v1.2.1", "v1.1.0"}, want: "v1.2.1", wantRead: true},
+		{name: "prerelease accepts newer prerelease", current: "v1.2.0-rc.1", versions: []string{"v1.2.0-rc.2", "v1.1.0"}, want: "v1.2.0-rc.2", wantRead: true},
+		{name: "older tags never downgrade", current: "v1.2.0", versions: []string{"v1.1.0"}, want: "v1.2.0", wantRead: true},
+		{name: "missing tags preserve current version", current: "v1.2.0", want: "v1.2.0", wantRead: true},
+		{name: "invalid current version", current: "branch", wantMessage: "invalid required version"},
+		{name: "listing error preserves cause", current: "v1.2.0", sourceErr: versionsErr, wantErr: versionsErr, wantRead: true},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			repository := &fakeRepository{versions: tt.versions, versionsErr: tt.sourceErr}
+
+			version, err := latestCompatibleV1Tag(t.Context(), "example.com/dep", tt.current, repository)
+
+			assert.Equal(t, tt.wantRead, repository.readVersions)
+			if tt.wantMessage != "" {
+				require.ErrorContains(t, err, tt.wantMessage)
+				return
+			}
+			require.ErrorIs(t, err, tt.wantErr)
+			assert.Equal(t, tt.want, version)
+		})
+	}
+}
+
+func TestDownloadRejectsStaleLockBeforeInstallation(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name string
+		lock string
+	}{
+		{name: "missing requirement", lock: "version: 1\nmodules: []\n"},
+		{name: "older version", lock: "version: 1\nmodules:\n  - source: example.com/dep\n    version: v1.0.0\n    commit: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\n    hash: h1:47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=\n"},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			manifest := "module example.com/app\nrequire example.com/dep v1.1.0\n"
+			writeV1GenerateFixture(t, root, v1.ModuleFile, manifest)
+			writeV1GenerateFixture(t, root, v1.LockFile, tt.lock)
+			cache := &fakeRepository{}
+
+			err := Download(t.Context(), root, cache)
+
+			require.ErrorContains(t, err, "protobuf.lock does not satisfy example.com/dep v1.1.0")
+			assert.False(t, cache.installed)
+			actualManifest, err := os.ReadFile(filepath.Join(root, v1.ModuleFile))
+			require.NoError(t, err)
+			assert.Equal(t, manifest, string(actualManifest))
+			actualLock, err := os.ReadFile(filepath.Join(root, v1.LockFile))
+			require.NoError(t, err)
+			assert.Equal(t, tt.lock, string(actualLock))
+		})
+	}
+}
+
+type fakeRepository struct {
+	fetchErr, installErr, cachedErr, versionsErr error
+	directory                                    string
+	module                                       v1.Module
+	versions                                     []string
+	installed, readVersions                      bool
+}
+
+func (r *fakeRepository) Fetch(_ context.Context, source, version string) (Fetched, error) {
+	return Fetched{Module: v1.Module{Name: source, Roots: []string{"."}}, Lock: v1.LockedModule{Source: source, Version: version, Commit: "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", Hash: "h1:47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU="}}, r.fetchErr
+}
+func (r *fakeRepository) Install(context.Context, v1.Lock) error {
+	r.installed = true
+	return r.installErr
+}
+func (r *fakeRepository) Cached(v1.LockedModule) (string, v1.Module, error) {
+	return r.directory, r.module, r.cachedErr
+}
+func (r *fakeRepository) Versions(context.Context, string) ([]string, error) {
+	r.readVersions = true
+	return r.versions, r.versionsErr
+}
diff --git a/internal/modules/policy.go b/internal/modules/policy.go
new file mode 100644
index 00000000..5f63d8c6
--- /dev/null
+++ b/internal/modules/policy.go
@@ -0,0 +1,129 @@
+package modules
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"os"
+	"path/filepath"
+	"slices"
+
+	moduleconfig "github.com/easyp-tech/easyp/internal/adapters/module_config"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// PolicyModule is a resolved module identity and the directory containing its
+// actual manifest. For nested and /vN modules this differs from the Git cache
+// repository root and from its proto import roots.
+type PolicyModule struct {
+	Name      string
+	Directory string
+	Replaced  bool
+}
+
+// PolicyGraph contains only module identities reached through the consumer's
+// already declared and resolved dependency graph.
+type PolicyGraph map[string]PolicyModule
+
+// ResolvePolicyGraph returns the verified module directories available to an
+// extends reference. It never resolves versions or changes protobuf.mod/lock.
+// In frozen mode it rejects replacements and uses only the exact locked graph.
+func ResolvePolicyGraph(ctx context.Context, moduleDir string, cache Cache, frozen bool) (PolicyGraph, error) {
+	return ResolvePolicyGraphAt(ctx, moduleDir, cache, frozen, nil)
+}
+
+// ResolvePolicyGraphAt additionally maps main-module replacements to a baseline
+// snapshot. No historical policy may read a present-day replacement directory.
+func ResolvePolicyGraphAt(ctx context.Context, moduleDir string, cache Cache, frozen bool, localPath func(string) (string, error)) (PolicyGraph, error) {
+	_, module, err := ReadManifest(moduleDir)
+	if err != nil {
+		return nil, fmt.Errorf("ReadManifest: %w", err)
+	}
+	if frozen && len(module.Replaces) > 0 {
+		return nil, fmt.Errorf("frozen mode rejects replace directives in protobuf.mod; remove replace before using --frozen")
+	}
+	lock, err := ReadLock(filepath.Join(moduleDir, v1.LockFile))
+	if err != nil && (frozen || !errors.Is(err, os.ErrNotExist)) {
+		return nil, fmt.Errorf("ReadLock: %w", err)
+	}
+	if errors.Is(err, os.ErrNotExist) {
+		lock = v1.Lock{Version: 1}
+	}
+	locals := newLocalReplacements(moduleDir, module, localPath)
+	result := make(PolicyGraph)
+	visited := make(map[string]bool)
+	queue := slices.Clone(module.Requires)
+	for len(queue) > 0 {
+		if err := ctx.Err(); err != nil {
+			return nil, fmt.Errorf("Err: %w", err)
+		}
+		requirement := queue[0]
+		queue = queue[1:]
+		dependency, local, err := locals.lookupRequirement(requirement.Module, requirement.Version)
+		if err != nil {
+			return nil, fmt.Errorf("lookupRequirement: %w", err)
+		}
+		if !local {
+			// Every incoming edge is checked, including stronger edges encountered
+			// after the same module has already been loaded. Never resolve a version.
+			if err := ValidateRequirements([]v1.Requirement{requirement}, lock); err != nil {
+				return nil, fmt.Errorf("policy dependency: %w", err)
+			}
+		}
+		if visited[requirement.Module] {
+			continue
+		}
+		visited[requirement.Module] = true
+		var directory string
+		if local {
+			directory = locals.modules[requirement.Module].Directory
+		} else {
+			if cache == nil {
+				return nil, fmt.Errorf("policy dependency %s requires cached locked contents; run easyp mod download", requirement.Module)
+			}
+			var pin v1.LockedModule
+			for _, entry := range lock.Modules {
+				if entry.Source == requirement.Module {
+					pin = entry
+					break
+				}
+			}
+			if err := cache.Install(ctx, v1.Lock{Version: 1, Modules: []v1.LockedModule{pin}}); err != nil {
+				return nil, fmt.Errorf("Install: %w", err)
+			}
+			directory, dependency, err = cache.Cached(pin)
+			if err != nil {
+				return nil, fmt.Errorf("Cached: %w", err)
+			}
+		}
+		if dependency.Name != requirement.Module {
+			return nil, fmt.Errorf("policy dependency %s declares %s", requirement.Module, dependency.Name)
+		}
+		manifestDir, err := moduleconfig.DependencyManifestDirectory(directory, dependency.Name)
+		if err != nil {
+			return nil, fmt.Errorf("DependencyManifestDirectory: %w", err)
+		}
+		result[requirement.Module] = PolicyModule{Name: requirement.Module, Directory: manifestDir, Replaced: local}
+		// Only the main module supplies replacements. Dependency replaces are not
+		// inherited, just as for the ordinary source graph.
+		queue = append(queue, dependency.Requires...)
+	}
+	if frozen {
+		for _, pin := range lock.Modules {
+			if !visited[pin.Source] {
+				return nil, fmt.Errorf("protobuf.lock contains unreachable locked module %s; run easyp mod tidy", pin.Source)
+			}
+		}
+	}
+	return result, nil
+}
+
+// SortedNames returns graph identities in stable lexical order.
+func (g PolicyGraph) SortedNames() []string {
+	names := make([]string, 0, len(g))
+	for name := range g {
+		names = append(names, name)
+	}
+	slices.Sort(names)
+	return names
+}
diff --git a/internal/modules/policy_parent_test.go b/internal/modules/policy_parent_test.go
new file mode 100644
index 00000000..7d84df5c
--- /dev/null
+++ b/internal/modules/policy_parent_test.go
@@ -0,0 +1,109 @@
+package modules
+
+import (
+	"context"
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+type parentPolicyCache struct {
+	entries   map[string]EffectiveModule
+	installed []string
+	fetched   []string
+}
+
+func (c *parentPolicyCache) Install(_ context.Context, lock v1.Lock) error {
+	for _, entry := range lock.Modules {
+		c.installed = append(c.installed, entry.Source)
+		if _, ok := c.entries[entry.Source]; !ok {
+			return fmt.Errorf("unexpected acquisition: %s", entry.Source)
+		}
+	}
+	return nil
+}
+func (c *parentPolicyCache) Cached(entry v1.LockedModule) (string, v1.Module, error) {
+	m, ok := c.entries[entry.Source]
+	if !ok {
+		return "", v1.Module{}, fmt.Errorf("missing cached module %s", entry.Source)
+	}
+	return m.Directory, m.Module, nil
+}
+func (c *parentPolicyCache) Fetch(_ context.Context, name, version string) (Fetched, error) {
+	c.fetched = append(c.fetched, name+"@"+version)
+	return Fetched{}, fmt.Errorf("unexpected revision resolution")
+}
+func parentPolicyWrite(t *testing.T, path, raw string) {
+	t.Helper()
+	require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+	require.NoError(t, os.WriteFile(path, []byte(raw), 0o600))
+}
+func parentPolicyPin(name, version string) v1.LockedModule {
+	return v1.LockedModule{Source: name, Version: version, Commit: strings.Repeat("a", 40), Hash: "h1:" + strings.Repeat("A", 43) + "="}
+}
+func parentPolicyLock(t *testing.T, root string, entries ...v1.LockedModule) {
+	t.Helper()
+	raw, err := yaml.Marshal(v1.Lock{Version: 1, Modules: entries})
+	require.NoError(t, err)
+	parentPolicyWrite(t, filepath.Join(root, v1.LockFile), string(raw))
+}
+func TestPolicyGraphParentDoesNotAcquireUnreachableLockEntry(t *testing.T) {
+	t.Parallel()
+	root, dir := t.TempDir(), t.TempDir()
+	const name = "example.test/policies"
+	parentPolicyWrite(t, filepath.Join(root, v1.ModuleFile), "module example.test/client\nrequire "+name+" v1.0.0\n")
+	parentPolicyWrite(t, filepath.Join(dir, v1.ModuleFile), "module "+name+"\n")
+	parentPolicyLock(t, root, parentPolicyPin(name, "v1.0.0"), parentPolicyPin("example.test/unreachable", "v1.0.0"))
+	cache := &parentPolicyCache{entries: map[string]EffectiveModule{name: {Directory: dir, Module: v1.Module{Name: name, Roots: []string{"."}}}}}
+	got, err := ResolvePolicyGraph(t.Context(), root, cache, false)
+	require.NoError(t, err)
+	require.Len(t, got, 1)
+	require.Equal(t, []string{name}, cache.installed)
+	require.Empty(t, cache.fetched)
+}
+func TestPolicyGraphParentValidatesTransitiveConstraints(t *testing.T) {
+	t.Parallel()
+	root, a, b := t.TempDir(), t.TempDir(), t.TempDir()
+	const name = "example.test/policies"
+	const dep = "example.test/base"
+	parentPolicyWrite(t, filepath.Join(root, v1.ModuleFile), "module example.test/client\nrequire "+name+" v1.0.0\n")
+	parentPolicyWrite(t, filepath.Join(a, v1.ModuleFile), "module "+name+"\nrequire "+dep+" v1.2.0\n")
+	parentPolicyWrite(t, filepath.Join(b, v1.ModuleFile), "module "+dep+"\n")
+	parentPolicyLock(t, root, parentPolicyPin(name, "v1.0.0"), parentPolicyPin(dep, "v1.0.0"))
+	cache := &parentPolicyCache{entries: map[string]EffectiveModule{name: {Directory: a, Module: v1.Module{Name: name, Roots: []string{"."}, Requires: []v1.Requirement{{Module: dep, Version: "v1.2.0"}}}}, dep: {Directory: b, Module: v1.Module{Name: dep, Roots: []string{"."}}}}}
+	_, err := ResolvePolicyGraph(t.Context(), root, cache, false)
+	require.Error(t, err)
+	require.Contains(t, err.Error(), dep)
+	require.Empty(t, cache.fetched)
+}
+func TestPolicyGraphParentDoesNotResolveNewOverlayRevisions(t *testing.T) {
+	t.Parallel()
+	root, overlay := t.TempDir(), t.TempDir()
+	const name = "example.test/policies"
+	parentPolicyWrite(t, filepath.Join(root, v1.ModuleFile), "module example.test/client\nrequire "+name+" v1.0.0\nreplace example.test/unused => "+overlay+"\n")
+	cache := &parentPolicyCache{entries: map[string]EffectiveModule{}}
+	_, err := ResolvePolicyGraph(t.Context(), root, cache, false)
+	require.Error(t, err)
+	require.Empty(t, cache.fetched, "extends cannot resolve an unpinned revision through the concrete repository")
+}
+func TestPolicyGraphParentIgnoresUnrelatedInvalidManifest(t *testing.T) {
+	t.Parallel()
+	root, dir := t.TempDir(), t.TempDir()
+	const name = "example.test/repo/policies/v2"
+	parentPolicyWrite(t, filepath.Join(root, v1.ModuleFile), "module example.test/client\nrequire "+name+" v2.0.0\n")
+	parentPolicyWrite(t, filepath.Join(dir, v1.ModuleFile), "module example.test/unrelated\nrequire (broken\n")
+	parentPolicyWrite(t, filepath.Join(dir, "policies", v1.ModuleFile), "module "+name+"\nroots proto\n")
+	parentPolicyWrite(t, filepath.Join(dir, "policies/proto/readme.txt"), "empty source root\n")
+	parentPolicyLock(t, root, parentPolicyPin(name, "v2.0.0"))
+	cache := &parentPolicyCache{entries: map[string]EffectiveModule{name: {Directory: dir, Module: v1.Module{Name: name, Roots: []string{"policies/proto"}}}}}
+	got, err := ResolvePolicyGraph(t.Context(), root, cache, false)
+	require.NoError(t, err)
+	require.Equal(t, filepath.Join(dir, "policies"), got[name].Directory)
+}
diff --git a/internal/modules/project_files.go b/internal/modules/project_files.go
new file mode 100644
index 00000000..72faaee3
--- /dev/null
+++ b/internal/modules/project_files.go
@@ -0,0 +1,71 @@
+package modules
+
+import (
+	"bytes"
+	"errors"
+	"fmt"
+	"os"
+	"path/filepath"
+
+	"gopkg.in/yaml.v3"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	disk "github.com/easyp-tech/easyp/internal/fs/fs"
+)
+
+// ReadManifest returns parsed metadata and the original bytes for comment-preserving edits.
+func ReadManifest(root string) ([]byte, v1.Module, error) {
+	original, err := os.ReadFile(filepath.Join(root, v1.ModuleFile))
+	if err != nil {
+		return nil, v1.Module{}, fmt.Errorf("ReadFile: %w", err)
+	}
+	module, err := v1.ParseModule(bytes.NewReader(original))
+	if err != nil {
+		return nil, v1.Module{}, fmt.Errorf("ParseModule: %w", err)
+	}
+	return original, module, nil
+}
+
+// ReadModuleOrDefault treats a directory without protobuf.mod as one local
+// source root without dependencies or a module identity.
+func ReadModuleOrDefault(root string) (v1.Module, error) {
+	_, module, err := ReadManifest(root)
+	if errors.Is(err, os.ErrNotExist) {
+		return v1.Module{Roots: []string{"."}}, nil
+	}
+	if err != nil {
+		return v1.Module{}, fmt.Errorf("ReadManifest: %w", err)
+	}
+	return module, nil
+}
+
+func writeV1ResolvedFiles(root string, original, updated []byte, lock v1.Lock) error {
+	changed := !bytes.Equal(original, updated)
+	if changed {
+		if err := writeV1Manifest(root, updated); err != nil {
+			return err
+		}
+	}
+	if err := writeV1Lock(root, lock); err != nil {
+		if changed {
+			if rollbackErr := writeV1Manifest(root, original); rollbackErr != nil {
+				return errors.Join(err, fmt.Errorf("restore protobuf.mod: %w", rollbackErr))
+			}
+		}
+		return err
+	}
+	return nil
+}
+
+func writeV1Lock(root string, lock v1.Lock) error {
+	raw, err := yaml.Marshal(lock)
+	if err != nil {
+		return fmt.Errorf("Marshal: %w", err)
+	}
+
+	raw = append([]byte("# protobuf.lock - GENERATED FILE, DO NOT EDIT MANUALLY\n"), raw...)
+	if err := disk.WriteAtomicFile(filepath.Join(root, v1.LockFile), raw, 0o644); err != nil {
+		return fmt.Errorf("WriteAtomicFile: %w", err)
+	}
+	return nil
+}
diff --git a/internal/modules/proto_imports_v1_test.go b/internal/modules/proto_imports_v1_test.go
new file mode 100644
index 00000000..8caff4fc
--- /dev/null
+++ b/internal/modules/proto_imports_v1_test.go
@@ -0,0 +1,97 @@
+package modules
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestV1ImportsFollowProtobufSyntax(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name    string
+		source  string
+		imports []string
+	}{
+		{
+			name:   "ignore block comment",
+			source: "syntax = \"proto3\";\n/*\nimport \"removed.proto\";\n*/\nmessage Item {}\n",
+		},
+		{
+			name:    "same line imports",
+			source:  `syntax = "proto3"; import "first.proto"; import "second.proto";`,
+			imports: []string{"first.proto", "second.proto"},
+		},
+		{
+			name:    "single quotes",
+			source:  "syntax = \"proto3\";\nimport 'missing.proto';\n",
+			imports: []string{"missing.proto"},
+		},
+		{
+			name:    "escaped path",
+			source:  "syntax = \"proto3\";\nimport \"external\\x2ftypes.proto\";\n",
+			imports: []string{"external/types.proto"},
+		},
+		{
+			name:    "comments inside import",
+			source:  "syntax = \"proto3\";\nimport /* reason */ \"missing.proto\";\n",
+			imports: []string{"missing.proto"},
+		},
+		{
+			name:    "public and weak imports",
+			source:  "syntax = \"proto3\";\nimport public \"public.proto\";\nimport weak \"weak.proto\";\n",
+			imports: []string{"public.proto", "weak.proto"},
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			err := os.WriteFile(filepath.Join(root, "main.proto"), []byte(tt.source), 0o644)
+			require.NoError(t, err)
+
+			missing, err := unresolvedV1Imports(root, []string{"."})
+			require.NoError(t, err)
+			assert.ElementsMatch(t, tt.imports, missing)
+
+			imports, err := v1RootImports(root, []string{"."})
+			require.NoError(t, err)
+			want := make(map[string]bool, len(tt.imports))
+			for _, path := range tt.imports {
+				want[path] = true
+			}
+			assert.Equal(t, want, imports)
+		})
+	}
+}
+
+func TestV1ImportsRejectInvalidSyntax(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name   string
+		source string
+	}{
+		{name: "missing semicolon", source: `syntax = "proto3"; import "missing.proto"`},
+		{name: "unterminated string", source: `syntax = "proto3"; import "missing.proto;`},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeV1GenerateFixture(t, root, "main.proto", tt.source)
+
+			_, missingErr := unresolvedV1Imports(root, []string{"."})
+			_, importsErr := v1RootImports(root, []string{"."})
+
+			assert.ErrorContains(t, missingErr, "main.proto")
+			assert.ErrorContains(t, importsErr, "main.proto")
+		})
+	}
+}
diff --git a/internal/modules/replacement_path_test.go b/internal/modules/replacement_path_test.go
new file mode 100644
index 00000000..3019dd40
--- /dev/null
+++ b/internal/modules/replacement_path_test.go
@@ -0,0 +1,45 @@
+package modules
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestResolveReplacementPath(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	owner := filepath.Join(root, "project")
+	dep := filepath.Join(root, "dependency")
+	tests := []struct{ name, target, want string }{
+		{name: "absolute", target: dep, want: dep},
+		{name: "parent relative", target: "../dependency", want: dep},
+		{name: "child relative", target: "local/../local", want: filepath.Join(owner, "local")},
+		{name: "same directory", target: ".", want: owner},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) { t.Parallel(); assert.Equal(t, tt.want, ResolveReplacementPath(owner, tt.target)) })
+	}
+}
+
+func TestLocalDependencySourcesUseAbsoluteReplacement(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	owner := filepath.Join(root, "app")
+	dep := filepath.Join(root, "dependency")
+	require.NoError(t, os.MkdirAll(dep, 0o755))
+	require.NoError(t, os.WriteFile(filepath.Join(dep, "protobuf.mod"), []byte("module example.com/dep\n"), 0o644))
+	manifest := "module example.com/app\nrequire example.com/dep\nreplace example.com/dep => " + dep + "\n"
+	module, err := v1.ParseModule(strings.NewReader(manifest))
+	require.NoError(t, err)
+	roots, err := localDependencySources(owner, module)
+	require.NoError(t, err)
+	require.Len(t, roots, 1)
+	assert.Equal(t, dep, roots[0].Path)
+}
diff --git a/internal/modules/repository.go b/internal/modules/repository.go
new file mode 100644
index 00000000..f4d77427
--- /dev/null
+++ b/internal/modules/repository.go
@@ -0,0 +1,48 @@
+package modules
+
+import (
+	"context"
+	"fmt"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// Cache verifies locked contents and reads installed module metadata.
+type Cache interface {
+	Install(context.Context, v1.Lock) error
+	Cached(v1.LockedModule) (string, v1.Module, error)
+}
+
+// Repository resolves revisions and installs their locked contents.
+type Repository interface {
+	Source
+	Cache
+}
+
+// VersionedRepository also lists available versions for module updates.
+type VersionedRepository interface {
+	Repository
+	Versions(context.Context, string) ([]string, error)
+}
+
+// VendorDir is the import root used for vendored dependencies.
+const VendorDir = "easyp_vendor"
+
+// EnsureSources resolves the effective overlay or installs published locked contents.
+// Local sources precede locked sources, preserving import and managed-selector order.
+func EnsureSources(ctx context.Context, moduleDir string, module v1.Module, cache Cache) (SourceRoots, error) {
+	if len(module.Replaces) > 0 {
+		graph, err := EnsureEffectiveGraph(ctx, moduleDir, module, cache, nil)
+		if err != nil {
+			return nil, fmt.Errorf("EnsureEffectiveGraph: %w", err)
+		}
+		return graph.Sources, nil
+	}
+	return EnsureLockedSources(ctx, moduleDir, module, cache)
+}
+
+// LocalSources reads only the local-to-local portion of the main replacement
+// graph. Consumers needing remote edges must use EnsureSources instead.
+func LocalSources(moduleDir string, module v1.Module) (SourceRoots, error) {
+	return localDependencySources(moduleDir, module)
+}
diff --git a/internal/modules/resolve.go b/internal/modules/resolve.go
new file mode 100644
index 00000000..09b46c07
--- /dev/null
+++ b/internal/modules/resolve.go
@@ -0,0 +1,293 @@
+// Package modules coordinates v1 dependency resolution and project module files.
+package modules
+
+import (
+	"context"
+	"fmt"
+	"slices"
+	"strings"
+
+	"golang.org/x/mod/semver"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// Fetched contains metadata and a reproducible identity for one requested revision.
+type Fetched struct {
+	Module v1.Module
+	Lock   v1.LockedModule
+}
+
+// Source supplies revision metadata without exposing checkout or cache layout.
+type Source interface {
+	Fetch(context.Context, string, string) (Fetched, error)
+}
+
+type versionRequirements struct {
+	minimum string
+	commit  string
+	weak    bool
+}
+
+type revisionLoader struct {
+	source   Source
+	fetched  map[string]Fetched
+	failures map[string]error
+	pins     map[string]v1.LockedModule
+	local    func(string, string) (v1.Module, bool, error)
+}
+
+func (l *revisionLoader) fetch(ctx context.Context, source, version string) (Fetched, error) {
+	if v1.IsCommitRef(version) {
+		version = strings.ToLower(version)
+	}
+	key := source + "@" + version
+	if err := l.failures[key]; err != nil {
+		return Fetched{}, err
+	}
+	if result, ok := l.fetched[key]; ok {
+		return result, nil
+	}
+	// A tag already verified at this exact commit supplies identical metadata.
+	if v1.IsCommitRef(version) {
+		for _, result := range l.fetched {
+			if result.Lock.Source == source && strings.EqualFold(result.Lock.Commit, version) {
+				result.Lock.Version = version
+				l.fetched[key] = result
+				return result, nil
+			}
+		}
+	}
+	result, err := l.source.Fetch(ctx, source, version)
+	if err != nil {
+		if l.failures == nil {
+			l.failures = make(map[string]error)
+		}
+		l.failures[key] = err
+		return Fetched{}, err
+	}
+	if result.Module.Name != source || result.Lock.Source != source {
+		return Fetched{}, fmt.Errorf("fetched module identity differs from requested %s (manifest %s, lock %s)", source, result.Module.Name, result.Lock.Source)
+	}
+	if err := v1.ValidateModuleVersion(source, result.Lock.Version); err != nil {
+		return Fetched{}, fmt.Errorf("ValidateModuleVersion: %w", err)
+	}
+	l.fetched[key] = result
+	return result, nil
+}
+
+func (l *revisionLoader) head(ctx context.Context, source string) (Fetched, error) {
+	version := l.pins[source].Commit
+	return l.fetch(ctx, source, version)
+}
+
+// Resolve uses the highest semantic minimum. A versionless requirement adds no
+// constraint when a tag or explicit commit exists. Exact commits may coexist
+// with semantic requirements only when the selected tag resolves to that commit.
+// Provisional HEAD edges are rebuilt if stronger requirements supersede them.
+func Resolve(ctx context.Context, root v1.Module, source Source, pins map[string]v1.LockedModule) (v1.Lock, error) {
+	loader := revisionLoader{source: source, fetched: make(map[string]Fetched), pins: pins}
+	pass, err := loader.resolve(ctx, root)
+	return pass.lock, err
+}
+
+func (loader *revisionLoader) resolve(ctx context.Context, root v1.Module) (resolutionPass, error) {
+	hints := make(map[string]string)
+	states := make(map[string]bool)
+	for {
+		if err := ctx.Err(); err != nil {
+			return resolutionPass{}, err
+		}
+		pass := loader.resolvePass(ctx, root, hints)
+		if err := ctx.Err(); err != nil {
+			return resolutionPass{}, err
+		}
+		stable := true
+		for name, used := range pass.provisional {
+			if pass.selected[name] != used {
+				stable = false
+				break
+			}
+		}
+		if stable {
+			if pass.err != nil {
+				return resolutionPass{}, pass.err
+			}
+			return pass, nil
+		}
+		names := make([]string, 0, len(pass.selected))
+		for name := range pass.selected {
+			names = append(names, name)
+		}
+		slices.Sort(names)
+		var signature strings.Builder
+		for _, name := range names {
+			fmt.Fprintf(&signature, "%s@%s\n", name, pass.selected[name])
+		}
+		state := signature.String()
+		if states[state] {
+			return resolutionPass{}, fmt.Errorf("unstable versionless dependency constraints; declare explicit compatible versions")
+		}
+		states[state] = true
+		hints = pass.selected
+	}
+}
+
+type resolutionPass struct {
+	lock        v1.Lock
+	locals      []string
+	provisional map[string]string
+	selected    map[string]string
+	err         error
+}
+
+// deferError postpones errors until the provisional graph is stable. A failed
+// dependency of an unselected HEAD must not poison an otherwise valid graph.
+func (p *resolutionPass) deferError(err error) {
+	if p.err == nil {
+		p.err = err
+	}
+}
+
+func (l *revisionLoader) resolvePass(ctx context.Context, root v1.Module, hints map[string]string) resolutionPass {
+	pass := resolutionPass{lock: v1.Lock{Version: 1, Modules: []v1.LockedModule{}}, provisional: make(map[string]string), selected: make(map[string]string)}
+	requirements := make(map[string]*versionRequirements)
+	visited := make(map[string]bool)
+	localVisited := make(map[string]bool)
+	queue := slices.Clone(root.Requires)
+	for {
+		for len(queue) > 0 {
+			if err := ctx.Err(); err != nil {
+				pass.deferError(err)
+				return pass
+			}
+			requirement := queue[0]
+			queue = queue[1:]
+			if err := v1.ValidateModuleVersion(requirement.Module, requirement.Version); err != nil {
+				pass.deferError(fmt.Errorf("ValidateModuleVersion: %w", err))
+				continue
+			}
+			if l.local != nil {
+				// The main module and replaced nodes have no remote revision.
+				if requirement.Module == root.Name {
+					continue
+				}
+				module, local, err := l.local(requirement.Module, requirement.Version)
+				if err != nil {
+					pass.deferError(err)
+					continue
+				}
+				if local {
+					if localVisited[requirement.Module] {
+						continue
+					}
+					localVisited[requirement.Module] = true
+					pass.locals = append(pass.locals, requirement.Module)
+					queue = append(queue, module.Requires...)
+					continue
+				}
+			}
+			version := requirement.Version
+			if version != "" && !v1.IsCommitRef(version) && !semver.IsValid(version) {
+				pass.deferError(fmt.Errorf("require %s: expected semantic version or full Git commit, got %q", requirement.Module, version))
+				continue
+			}
+			r := requirements[requirement.Module]
+			if r == nil {
+				r = &versionRequirements{}
+				requirements[requirement.Module] = r
+			}
+			switch {
+			case version == "":
+				r.weak = true
+				continue
+			case v1.IsCommitRef(version):
+				version = strings.ToLower(version)
+				if r.commit != "" && r.commit != version {
+					pass.deferError(fmt.Errorf("module %s has conflicting requirements %s and %s", requirement.Module, r.commit, version))
+					continue
+				}
+				r.commit = version
+			default:
+				if r.minimum == "" || semver.Compare(version, r.minimum) > 0 || (semver.Compare(version, r.minimum) == 0 && version > r.minimum) {
+					r.minimum = version
+				}
+			}
+			key := requirement.Module + "@" + version
+			if visited[key] {
+				continue
+			}
+			visited[key] = true
+			result, err := l.fetch(ctx, requirement.Module, version)
+			if err != nil {
+				pass.deferError(err)
+				continue
+			}
+			queue = append(queue, result.Module.Requires...)
+		}
+		pending := make([]string, 0)
+		for name, r := range requirements {
+			if r.weak && r.minimum == "" && r.commit == "" {
+				if _, ok := pass.provisional[name]; !ok {
+					pending = append(pending, name)
+				}
+			}
+		}
+		slices.Sort(pending)
+		if len(pending) == 0 {
+			break
+		}
+		if err := ctx.Err(); err != nil {
+			pass.deferError(err)
+			return pass
+		}
+		name := pending[0]
+		var result Fetched
+		var err error
+		used := hints[name]
+		if used != "" {
+			result, err = l.fetch(ctx, name, used)
+		} else {
+			used = l.pins[name].Commit
+			result, err = l.head(ctx, name)
+		}
+		if err != nil {
+			pass.provisional[name] = used
+			pass.deferError(err)
+			continue
+		}
+		pass.provisional[name] = result.Lock.Version
+		queue = append(queue, result.Module.Requires...)
+	}
+	names := make([]string, 0, len(requirements))
+	for name := range requirements {
+		names = append(names, name)
+	}
+	slices.Sort(names)
+	for _, name := range names {
+		r := requirements[name]
+		var result Fetched
+		var err error
+		switch {
+		case r.minimum != "":
+			pass.selected[name] = r.minimum
+			result, err = l.fetch(ctx, name, r.minimum)
+		case r.commit != "":
+			pass.selected[name] = r.commit
+			result, err = l.fetch(ctx, name, r.commit)
+		default:
+			pass.selected[name] = l.pins[name].Commit
+			result, err = l.head(ctx, name)
+		}
+		if err != nil {
+			pass.deferError(err)
+			continue
+		}
+		pass.selected[name] = result.Lock.Version
+		if r.commit != "" && !strings.EqualFold(result.Lock.Commit, r.commit) {
+			pass.deferError(fmt.Errorf("module %s has conflicting requirements: tag %s resolves to %s, explicit commit is %s", name, r.minimum, result.Lock.Commit, r.commit))
+		}
+		pass.lock.Modules = append(pass.lock.Modules, result.Lock)
+	}
+	return pass
+}
diff --git a/internal/modules/resolve_test.go b/internal/modules/resolve_test.go
new file mode 100644
index 00000000..e26bd959
--- /dev/null
+++ b/internal/modules/resolve_test.go
@@ -0,0 +1,138 @@
+package modules
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestResolve(t *testing.T) {
+	t.Parallel()
+	const commitA = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+	const commitB = "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+	fetchErr := errors.New("module unavailable")
+	tests := []struct {
+		name        string
+		requires    []v1.Requirement
+		revisions   map[string]Fetched
+		pins        map[string]v1.LockedModule
+		fetchErrors map[string]error
+		canceled    bool
+		want        []v1.LockedModule
+		wantCalls   []string
+		wantError   error
+		wantMessage string
+	}{
+		{name: "empty graph", want: []v1.LockedModule{}},
+		{
+			name:     "highest minimum with deterministic module order",
+			requires: []v1.Requirement{{Module: "b", Version: "v1.0.0"}, {Module: "a", Version: "v1.0.0"}},
+			revisions: map[string]Fetched{
+				"b@v1.0.0": {Module: v1.Module{Requires: []v1.Requirement{{Module: "a", Version: "v1.2.0"}}}, Lock: v1.LockedModule{Source: "b", Version: "v1.0.0", Commit: commitB}},
+				"a@v1.0.0": {Lock: v1.LockedModule{Source: "a", Version: "v1.0.0", Commit: commitA}},
+				"a@v1.2.0": {Lock: v1.LockedModule{Source: "a", Version: "v1.2.0", Commit: commitB}},
+			},
+			want:      []v1.LockedModule{{Source: "a", Version: "v1.2.0", Commit: commitB}, {Source: "b", Version: "v1.0.0", Commit: commitB}},
+			wantCalls: []string{"b@v1.0.0", "a@v1.0.0", "a@v1.2.0"},
+		},
+		{
+			name:      "repeated cyclic requirement loads a revision once",
+			requires:  []v1.Requirement{{Module: "a", Version: "v1.0.0"}, {Module: "a", Version: "v1.0.0"}},
+			revisions: map[string]Fetched{"a@v1.0.0": {Module: v1.Module{Requires: []v1.Requirement{{Module: "a", Version: "v1.0.0"}}}, Lock: v1.LockedModule{Source: "a", Version: "v1.0.0", Commit: commitA}}},
+			want:      []v1.LockedModule{{Source: "a", Version: "v1.0.0", Commit: commitA}}, wantCalls: []string{"a@v1.0.0"},
+		},
+		{
+			name:      "versionless dependency resolves head once",
+			requires:  []v1.Requirement{{Module: "a"}, {Module: "a"}},
+			revisions: map[string]Fetched{"a@": {Lock: v1.LockedModule{Source: "a", Version: commitA, Commit: commitA}}},
+			want:      []v1.LockedModule{{Source: "a", Version: commitA, Commit: commitA}}, wantCalls: []string{"a@"},
+		},
+		{
+			name:      "versionless requirement uses existing commit pin",
+			requires:  []v1.Requirement{{Module: "a"}},
+			pins:      map[string]v1.LockedModule{"a": {Source: "a", Commit: commitB}},
+			revisions: map[string]Fetched{"a@" + commitB: {Lock: v1.LockedModule{Source: "a", Version: commitB, Commit: commitB}}},
+			want:      []v1.LockedModule{{Source: "a", Version: commitB, Commit: commitB}}, wantCalls: []string{"a@" + commitB},
+		},
+		{
+			name:      "explicit version ignores previous pin",
+			requires:  []v1.Requirement{{Module: "a", Version: "v1.0.0"}},
+			pins:      map[string]v1.LockedModule{"a": {Source: "a", Commit: commitB}},
+			revisions: map[string]Fetched{"a@v1.0.0": {Lock: v1.LockedModule{Source: "a", Version: "v1.0.0", Commit: commitA}}},
+			want:      []v1.LockedModule{{Source: "a", Version: "v1.0.0", Commit: commitA}}, wantCalls: []string{"a@v1.0.0"},
+		},
+		{
+			name:      "different commits conflict before fetching the second",
+			requires:  []v1.Requirement{{Module: "a", Version: commitA}, {Module: "a", Version: commitB}},
+			revisions: map[string]Fetched{"a@" + commitA: {Lock: v1.LockedModule{Source: "a", Version: commitA, Commit: commitA}}},
+			wantCalls: []string{"a@" + commitA}, wantMessage: "has conflicting requirements",
+		},
+		{
+			name:      "tag and equivalent commit agree",
+			requires:  []v1.Requirement{{Module: "a", Version: "v1.0.0"}, {Module: "a", Version: commitA}},
+			revisions: map[string]Fetched{"a@v1.0.0": {Lock: v1.LockedModule{Source: "a", Version: "v1.0.0", Commit: commitA}}},
+			wantCalls: []string{"a@v1.0.0"}, want: []v1.LockedModule{{Source: "a", Version: "v1.0.0", Commit: commitA}},
+		},
+		{name: "invalid version", requires: []v1.Requirement{{Module: "a", Version: "branch"}}, wantMessage: "expected semantic version or full Git commit"},
+		{name: "fetch error keeps its cause", requires: []v1.Requirement{{Module: "a", Version: "v1.0.0"}}, fetchErrors: map[string]error{"a@v1.0.0": fetchErr}, wantCalls: []string{"a@v1.0.0"}, wantError: fetchErr},
+		{name: "head error keeps its cause", requires: []v1.Requirement{{Module: "a"}}, fetchErrors: map[string]error{"a@": fetchErr}, wantCalls: []string{"a@"}, wantError: fetchErr},
+		{name: "canceled before fetching", requires: []v1.Requirement{{Module: "a"}}, canceled: true, wantError: context.Canceled},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			source := &fakeSource{revisions: tt.revisions, errors: tt.fetchErrors}
+			ctx, cancel := context.WithCancel(t.Context())
+			t.Cleanup(cancel)
+			if tt.canceled {
+				cancel()
+			}
+			root := v1.Module{Requires: tt.requires}
+
+			lock, err := Resolve(ctx, root, source, tt.pins)
+
+			assert.Equal(t, tt.wantCalls, source.calls)
+			if tt.wantMessage != "" {
+				require.ErrorContains(t, err, tt.wantMessage)
+				assert.Empty(t, lock)
+				return
+			}
+			require.ErrorIs(t, err, tt.wantError)
+			if err != nil {
+				assert.Empty(t, lock)
+				return
+			}
+			assert.Equal(t, 1, lock.Version)
+			assert.Equal(t, tt.want, lock.Modules)
+		})
+	}
+}
+
+type fakeSource struct {
+	revisions map[string]Fetched
+	errors    map[string]error
+	calls     []string
+}
+
+func (s *fakeSource) Fetch(_ context.Context, module, version string) (Fetched, error) {
+	key := module + "@" + version
+	s.calls = append(s.calls, key)
+	if err := s.errors[key]; err != nil {
+		return Fetched{}, err
+	}
+	revision, ok := s.revisions[key]
+	if !ok {
+		return Fetched{}, fmt.Errorf("unexpected module revision %s", key)
+	}
+	if revision.Module.Name == "" {
+		revision.Module.Name = module
+	}
+	return revision, nil
+}
diff --git a/internal/modules/sources.go b/internal/modules/sources.go
new file mode 100644
index 00000000..58f2ff59
--- /dev/null
+++ b/internal/modules/sources.go
@@ -0,0 +1,196 @@
+package modules
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/core/path_helpers"
+)
+
+// SourceRoot associates a physical import root with its module identity.
+type SourceRoot struct {
+	Path        string
+	Module      string
+	fileAllowed func(string) bool
+}
+
+// SourceRoots preserves import precedence and module ownership.
+type SourceRoots []SourceRoot
+
+// Paths returns a new slice in the same order as the source roots.
+func (roots SourceRoots) Paths() []string {
+	paths := make([]string, 0, len(roots))
+	for _, root := range roots {
+		paths = append(paths, root.Path)
+	}
+	return paths
+}
+
+// Walk visits only proto files selected by the module's source metadata.
+func (root SourceRoot) Walk(visit func(string) error) error {
+	return WalkProtoFiles(root.Path, func(path string) error {
+		if root.fileAllowed != nil && (!root.fileAllowed(path) || !root.fileAllowed(physicalSourcePath(path))) {
+			return nil
+		}
+		return visit(path)
+	})
+}
+
+func (root SourceRoot) allows(path, importRoot string) bool {
+	return root.allowsPath(filepath.Clean(path), filepath.Clean(importRoot)) &&
+		root.allowsPath(physicalSourcePath(path), physicalSourcePath(importRoot))
+}
+
+func (root SourceRoot) allowsPath(path, importRoot string) bool {
+	if root.fileAllowed != nil && !root.fileAllowed(path) {
+		return false
+	}
+	// A containing consumer root does not own files inside a nested module.
+	// Import lookup must use the same boundaries as source discovery.
+	for directory := filepath.Dir(path); sourcePathWithin(directory, importRoot) && filepath.Clean(directory) != filepath.Clean(importRoot); directory = filepath.Dir(directory) {
+		if path_helpers.ShouldSkipV1SourceDir(importRoot, directory) {
+			return false
+		}
+	}
+	return true
+}
+
+// FileAllowed returns an immutable source filter for physical import lookup.
+// Paths outside these roots remain available to the consumer's own inputs.
+// Overlapping roots select the union of their allowed files. Both the import's
+// spelling and its physical target must pass their respective owning selections.
+func (roots SourceRoots) FileAllowed() func(string) bool {
+	if !slices.ContainsFunc(roots, func(root SourceRoot) bool { return root.fileAllowed != nil }) {
+		return nil
+	}
+	type selection struct {
+		path string
+		root SourceRoot
+	}
+	selections := make([]selection, 0, len(roots))
+	for _, root := range roots {
+		selections = append(selections, selection{path: filepath.Clean(root.Path), root: root})
+		canonical, err := filepath.EvalSymlinks(root.Path)
+		if err == nil && canonical != root.Path {
+			selections = append(selections, selection{path: canonical, root: root})
+		}
+	}
+	allowedPath := func(path string) bool {
+		inside := false
+		for _, root := range selections {
+			if !sourcePathWithin(path, root.path) {
+				continue
+			}
+			inside = true
+			if root.root.allowsPath(path, root.path) {
+				return true
+			}
+		}
+		return !inside
+	}
+	return func(path string) bool {
+		return allowedPath(filepath.Clean(path)) && allowedPath(physicalSourcePath(path))
+	}
+}
+
+func sourcePathWithin(path, directory string) bool {
+	relative, err := filepath.Rel(directory, path)
+	return err == nil && filepath.IsLocal(relative)
+}
+
+func physicalSourcePath(path string) string {
+	canonical, err := filepath.EvalSymlinks(path)
+	if err == nil {
+		return canonical
+	}
+	return filepath.Clean(path)
+}
+
+func moduleFileSelection(directory string, filters []v1.ProtoFileFilter) func(string) bool {
+	canonical, err := filepath.EvalSymlinks(directory)
+	if err != nil {
+		canonical = directory
+	}
+	// Metadata is immutable for the lifetime of an effective graph.
+	filters = slices.Clone(filters)
+	for i, filter := range filters {
+		filters[i].Includes = slices.Clone(filter.Includes)
+		filters[i].Excludes = slices.Clone(filter.Excludes)
+	}
+	return func(path string) bool {
+		base := directory
+		if !sourcePathWithin(path, base) {
+			base = canonical
+		}
+		relative, err := filepath.Rel(base, path)
+		if err != nil || !filepath.IsLocal(relative) {
+			return true
+		}
+		name := filepath.ToSlash(relative)
+		inside := false
+		within := func(directory string) bool {
+			directory = filepath.ToSlash(directory)
+			return directory == "." || name == directory || strings.HasPrefix(name, directory+"/")
+		}
+		for _, filter := range filters {
+			if !within(filter.Root) {
+				continue
+			}
+			inside = true
+			included := len(filter.Includes) == 0 || slices.ContainsFunc(filter.Includes, within)
+			if included && !slices.ContainsFunc(filter.Excludes, within) {
+				return true
+			}
+		}
+		return !inside
+	}
+}
+
+// FileModules maps import paths to their owning modules for managed selectors.
+// Callers check import collisions before using this mapping.
+func (roots SourceRoots) FileModules() (map[string]string, error) {
+	modules := make(map[string]string)
+	allowed := roots.FileAllowed()
+	for _, root := range roots {
+		err := root.Walk(func(path string) error {
+			if allowed != nil && !allowed(path) {
+				return nil
+			}
+			relative, err := filepath.Rel(root.Path, path)
+			if err != nil {
+				return err
+			}
+			modules[filepath.ToSlash(relative)] = root.Module
+			return nil
+		})
+		if err != nil {
+			return nil, err
+		}
+	}
+	return modules, nil
+}
+
+// ModuleSources validates module roots and resolves them relative to its directory.
+func ModuleSources(directory string, module v1.Module) (SourceRoots, error) {
+	roots := make(SourceRoots, 0, len(module.Roots))
+	var allowed func(string) bool
+	if len(module.ProtoFilters) > 0 {
+		allowed = moduleFileSelection(directory, module.ProtoFilters)
+	}
+	for _, root := range module.Roots {
+		path := filepath.Join(directory, root)
+		info, err := os.Stat(path)
+		if err != nil {
+			return nil, fmt.Errorf("Stat: %w", err)
+		}
+		if !info.IsDir() {
+			return nil, fmt.Errorf("module %s has invalid root %q: not a directory", module.Name, root)
+		}
+		roots = append(roots, SourceRoot{Path: path, Module: module.Name, fileAllowed: allowed})
+	}
+	return roots, nil
+}
diff --git a/internal/modules/sources_test.go b/internal/modules/sources_test.go
new file mode 100644
index 00000000..fa5b6b61
--- /dev/null
+++ b/internal/modules/sources_test.go
@@ -0,0 +1,256 @@
+package modules
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestModuleSourcesPreserveBufSelection(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct {
+		name    string
+		filters []v1.ProtoFileFilter
+		want    map[string]string
+	}{
+		{name: "excludes", filters: []v1.ProtoFileFilter{{Root: "proto", Excludes: []string{"proto/excluded"}}}, want: map[string]string{"allowed/a.proto": "example.test/dep", "allowed_test/b.proto": "example.test/dep"}},
+		{name: "includes", filters: []v1.ProtoFileFilter{{Root: "proto", Includes: []string{"proto/allowed"}}}, want: map[string]string{"allowed/a.proto": "example.test/dep"}},
+		{name: "union_of_modules", filters: []v1.ProtoFileFilter{{Root: "proto", Includes: []string{"proto/allowed"}, Excludes: []string{"proto/allowed/a.proto"}}, {Root: "proto", Includes: []string{"proto/allowed_test"}}}, want: map[string]string{"allowed_test/b.proto": "example.test/dep"}},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			for _, name := range []string{"proto/allowed/a.proto", "proto/allowed_test/b.proto", "proto/excluded/c.proto"} {
+				writeV1GenerateFixture(t, root, name, "syntax = \"proto3\";\n")
+			}
+			sources, err := ModuleSources(root, v1.Module{Name: "example.test/dep", Roots: []string{"proto"}, ProtoFilters: tt.filters})
+			require.NoError(t, err)
+			owners, err := sources.FileModules()
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, owners)
+			require.NoError(t, writeV1Vendor(root, sources))
+			for _, name := range []string{"allowed/a.proto", "allowed_test/b.proto", "excluded/c.proto"} {
+				_, err := os.Stat(filepath.Join(root, VendorDir, name))
+				if _, selected := tt.want[name]; selected {
+					assert.NoError(t, err, name)
+				} else {
+					assert.ErrorIs(t, err, os.ErrNotExist, name)
+				}
+			}
+		})
+	}
+}
+
+func TestLocalBufSelectionValidatesImports(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct {
+		name     string
+		metadata string
+	}{
+		{name: "buf_v1_excludes", metadata: "version: v1\nbuild:\n  excludes: [excluded]\n"},
+		{name: "buf_v2_excludes", metadata: "version: v2\nmodules:\n  - path: .\n    excludes: [excluded]\n"},
+		{name: "buf_v2_includes", metadata: "version: v2\nmodules:\n  - path: .\n    includes: [allowed]\n"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			manifest := "module example.test/client\nroots api\nrequire example.test/dep\nreplace example.test/dep => ./dep\n"
+			writeV1GenerateFixture(t, root, v1.ModuleFile, manifest)
+			writeV1GenerateFixture(t, root, "dep/buf.yaml", tt.metadata)
+			writeV1GenerateFixture(t, root, "dep/allowed/a.proto", "syntax = \"proto3\";\n")
+			writeV1GenerateFixture(t, root, "dep/excluded/c.proto", "syntax = \"proto3\";\n")
+			writeV1GenerateFixture(t, root, "api/client.proto", "syntax = \"proto3\"; import \"excluded/c.proto\";\n")
+			err := Tidy(t.Context(), root, nil)
+			require.ErrorContains(t, err, "cannot resolve imports")
+			assert.ErrorContains(t, err, "excluded/c.proto")
+			after, err := os.ReadFile(filepath.Join(root, v1.ModuleFile))
+			require.NoError(t, err)
+			assert.Equal(t, manifest, string(after))
+			_, err = os.Stat(filepath.Join(root, v1.LockFile))
+			assert.ErrorIs(t, err, os.ErrNotExist)
+		})
+	}
+}
+
+func TestBufSelectionDoesNotHideConsumerOrCollide(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, v1.ModuleFile, "module example.test/app\nroots api\nrequire example.test/dep\nreplace example.test/dep => ./dep\n")
+	writeV1GenerateFixture(t, root, "dep/buf.yaml", "version: v2\nmodules:\n  - path: .\n    includes: [selected]\n")
+	writeV1GenerateFixture(t, root, "dep/selected/a.proto", "syntax = \"proto3\";\n")
+	writeV1GenerateFixture(t, root, "dep/excluded/b.proto", "this excluded source must not be read")
+	writeV1GenerateFixture(t, root, "api/excluded/b.proto", "syntax = \"proto3\";\n")
+	require.NoError(t, Tidy(t.Context(), root, nil))
+	_, module, err := ReadManifest(root)
+	require.NoError(t, err)
+	deps, err := LocalSources(root, module)
+	require.NoError(t, err)
+	allowed := deps.FileAllowed()
+	require.NotNil(t, allowed)
+	assert.True(t, allowed(filepath.Join(root, "api/excluded/b.proto")))
+	assert.False(t, allowed(filepath.Join(root, "dep/excluded/b.proto")))
+	assert.True(t, allowed(filepath.Join(root, "dep/selected/a.proto")))
+	own, err := ModuleSources(root, v1.Module{Name: "example.test/app", Roots: []string{"."}})
+	require.NoError(t, err)
+	combinedAllowed := append(own, deps...).FileAllowed()
+	assert.False(t, combinedAllowed(filepath.Join(root, "dep/excluded/b.proto")))
+	assert.True(t, combinedAllowed(filepath.Join(root, "api/excluded/b.proto")))
+	directoryAlias := filepath.Join(root, "alias")
+	require.NoError(t, os.Symlink(filepath.Join(root, "dep/excluded"), directoryAlias))
+	assert.False(t, combinedAllowed(filepath.Join(directoryAlias, "b.proto")))
+	writeV1GenerateFixture(t, root, v1.ModuleFile, "module example.test/app\nroots .\nrequire example.test/dep\nreplace example.test/dep => ./dep\n")
+	writeV1GenerateFixture(t, root, "client.proto", "syntax = \"proto3\"; import \"alias/b.proto\";\n")
+	require.ErrorContains(t, Tidy(t.Context(), root, nil), "cannot resolve imports")
+
+	alias := filepath.Join(t.TempDir(), "alias")
+	require.NoError(t, os.Symlink(root, alias))
+	aliasDeps, err := LocalSources(alias, module)
+	require.NoError(t, err)
+	aliasAllowed := aliasDeps.FileAllowed()
+	canonical, err := filepath.EvalSymlinks(root)
+	require.NoError(t, err)
+	assert.False(t, aliasAllowed(filepath.Join(canonical, "dep/excluded/b.proto")))
+	assert.True(t, aliasAllowed(filepath.Join(alias, "dep/selected/a.proto")))
+}
+
+func TestBufFileAliasCannotBecomeConsumerInput(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, v1.ModuleFile, "module example.test/app\nroots .\nrequire example.test/dep\nreplace example.test/dep => ./dep\n")
+	writeV1GenerateFixture(t, root, "dep/buf.yaml", "version: v1\nbuild:\n  excludes: [excluded]\n")
+	writeV1GenerateFixture(t, root, "dep/excluded/b.proto", "this excluded source must not be parsed")
+	writeV1GenerateFixture(t, root, "client.proto", "syntax = \"proto3\"; import \"alias.proto\";\n")
+	require.NoError(t, os.Symlink(filepath.Join(root, "dep/excluded/b.proto"), filepath.Join(root, "alias.proto")))
+	require.ErrorContains(t, Tidy(t.Context(), root, nil), "cannot resolve imports")
+	_, module, err := ReadManifest(root)
+	require.NoError(t, err)
+	own, err := ModuleSources(root, module)
+	require.NoError(t, err)
+	deps, err := LocalSources(root, module)
+	require.NoError(t, err)
+	owners, err := append(own, deps...).FileModules()
+	require.NoError(t, err)
+	assert.NotContains(t, owners, "alias.proto")
+}
+
+func TestBufSelectionHonorsLexicalAndPhysicalAliases(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct {
+		name, alias, target, imported string
+		directory, outside, other     bool
+	}{
+		{name: "excluded_file_to_allowed", alias: "excluded/alias.proto", target: "allowed/model.proto", imported: "excluded/alias.proto"},
+		{name: "excluded_directory_to_allowed", alias: "excluded/alias", target: "allowed", imported: "excluded/alias/model.proto", directory: true},
+		{name: "excluded_file_to_outside", alias: "excluded/alias.proto", imported: "excluded/alias.proto", outside: true},
+		{name: "excluded_directory_to_outside", alias: "excluded/alias", imported: "excluded/alias/model.proto", directory: true, outside: true},
+		{name: "allowed_file_to_excluded", alias: "allowed/alias.proto", target: "excluded/model.proto", imported: "allowed/alias.proto"},
+		{name: "allowed_directory_to_excluded", alias: "allowed/alias", target: "excluded", imported: "allowed/alias/model.proto", directory: true},
+		{name: "excluded_file_to_other_module", alias: "excluded/alias.proto", target: "allowed/model.proto", imported: "excluded/alias.proto", other: true},
+		{name: "excluded_directory_to_other_module", alias: "excluded/alias", target: "allowed", imported: "excluded/alias/model.proto", directory: true, other: true},
+	} {
+		for _, consumerRoot := range []string{"api", "."} {
+			t.Run(tt.name+"/roots_"+consumerRoot, func(t *testing.T) {
+				t.Parallel()
+				root := t.TempDir()
+				manifest := "module example.test/app\nroots " + consumerRoot + "\nrequire example.test/dep\nreplace example.test/dep => ./dep\n"
+				if tt.other {
+					manifest += "require example.test/other\nreplace example.test/other => ./other\n"
+					writeV1GenerateFixture(t, root, "other/buf.yaml", "version: v2\nmodules:\n  - path: .\n    includes: [allowed]\n")
+				}
+				writeV1GenerateFixture(t, root, v1.ModuleFile, manifest)
+				writeV1GenerateFixture(t, root, "dep/buf.yaml", "version: v1\nbuild:\n  excludes: [excluded]\n")
+				writeV1GenerateFixture(t, root, filepath.Join(consumerRoot, "client.proto"), "syntax = \"proto3\"; import \""+tt.imported+"\";\n")
+				dep := filepath.Join(root, "dep")
+				target := filepath.Join(dep, tt.target)
+				if tt.other {
+					target = filepath.Join(root, "other", tt.target)
+				}
+				if tt.outside {
+					target = t.TempDir()
+					if !tt.directory {
+						target = filepath.Join(target, "model.proto")
+					}
+				}
+				targetFile := target
+				if tt.directory {
+					targetFile = filepath.Join(target, "model.proto")
+				}
+				writeV1GenerateFixture(t, filepath.Dir(targetFile), filepath.Base(targetFile), "syntax = \"proto3\";\n")
+				alias := filepath.Join(dep, tt.alias)
+				require.NoError(t, os.MkdirAll(filepath.Dir(alias), 0o755))
+				require.NoError(t, os.Symlink(target, alias))
+				_, module, err := ReadManifest(root)
+				require.NoError(t, err)
+				deps, err := LocalSources(root, module)
+				require.NoError(t, err)
+				assert.False(t, deps.FileAllowed()(filepath.Join(dep, tt.imported)), "both alias spelling and physical target must be selected")
+				own, err := ModuleSources(root, module)
+				require.NoError(t, err)
+				assert.False(t, append(own, deps...).FileAllowed()(filepath.Join(dep, tt.imported)), "a broad consumer or another dependency must not override the alias's selection")
+				require.ErrorContains(t, Tidy(t.Context(), root, nil), "cannot resolve imports")
+			})
+		}
+	}
+}
+
+func TestBufExcludedFileAliasDoesNotCollideWithConsumerSource(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, v1.ModuleFile, "module example.test/app\nroots api\nrequire example.test/dep\nreplace example.test/dep => ./dep\n")
+	writeV1GenerateFixture(t, root, "dep/buf.yaml", "version: v1\nbuild:\n  excludes: [excluded]\n")
+	writeV1GenerateFixture(t, root, "dep/allowed/model.proto", "syntax = \"proto3\";\n")
+	writeV1GenerateFixture(t, root, "api/excluded/model.proto", "syntax = \"proto3\";\n")
+	writeV1GenerateFixture(t, root, "api/client.proto", "syntax = \"proto3\"; import \"excluded/model.proto\";\n")
+	require.NoError(t, os.MkdirAll(filepath.Join(root, "dep/excluded"), 0o755))
+	require.NoError(t, os.Symlink("../allowed/model.proto", filepath.Join(root, "dep/excluded/model.proto")))
+	require.NoError(t, Tidy(t.Context(), root, nil))
+	require.NoError(t, Vendor(t.Context(), root, nil))
+	_, err := os.Stat(filepath.Join(root, VendorDir, "allowed/model.proto"))
+	require.NoError(t, err)
+	_, err = os.Stat(filepath.Join(root, VendorDir, "excluded/model.proto"))
+	assert.ErrorIs(t, err, os.ErrNotExist)
+}
+
+func TestBufAliasSelectionPreservesModuleUnion(t *testing.T) {
+	t.Parallel()
+	for _, tt := range []struct{ name, alias, target string }{
+		{name: "lexical_selected_by_second_module", alias: "excluded/alias.proto", target: "allowed/model.proto"},
+		{name: "physical_selected_by_second_module", alias: "allowed/alias.proto", target: "excluded/model.proto"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeV1GenerateFixture(t, root, v1.ModuleFile, "module example.test/app\nroots api\nrequire example.test/dep\nreplace example.test/dep => ./dep\n")
+			writeV1GenerateFixture(t, root, "dep/buf.yaml", "version: v2\nmodules:\n  - path: .\n    excludes: [excluded]\n  - path: .\n    includes: [excluded]\n")
+			writeV1GenerateFixture(t, root, "dep/"+tt.target, "syntax = \"proto3\";\n")
+			writeV1GenerateFixture(t, root, "api/client.proto", "syntax = \"proto3\"; import \""+tt.alias+"\";\n")
+			alias := filepath.Join(root, "dep", tt.alias)
+			require.NoError(t, os.MkdirAll(filepath.Dir(alias), 0o755))
+			require.NoError(t, os.Symlink(filepath.Join(root, "dep", tt.target), alias))
+			require.NoError(t, Tidy(t.Context(), root, nil))
+		})
+	}
+}
+
+func TestBufSelectionAllowsConsumerAliasToSelectedDependency(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	writeV1GenerateFixture(t, root, v1.ModuleFile, "module example.test/app\nroots .\nrequire example.test/dep\nreplace example.test/dep => ./dep\n")
+	writeV1GenerateFixture(t, root, "dep/buf.yaml", "version: v2\nmodules:\n  - path: .\n    includes: [selected]\n")
+	writeV1GenerateFixture(t, root, "dep/selected/model.proto", "syntax = \"proto3\";\n")
+	writeV1GenerateFixture(t, root, "client.proto", "syntax = \"proto3\"; import \"alias.proto\";\n")
+	require.NoError(t, os.Symlink("dep/selected/model.proto", filepath.Join(root, "alias.proto")))
+	_, module, err := ReadManifest(root)
+	require.NoError(t, err)
+	deps, err := LocalSources(root, module)
+	require.NoError(t, err)
+	own, err := ModuleSources(root, module)
+	require.NoError(t, err)
+	assert.True(t, append(own, deps...).FileAllowed()(filepath.Join(root, "alias.proto")))
+	require.NoError(t, Tidy(t.Context(), root, nil))
+}
diff --git a/internal/modules/unresolved_imports_test.go b/internal/modules/unresolved_imports_test.go
new file mode 100644
index 00000000..138b4a66
--- /dev/null
+++ b/internal/modules/unresolved_imports_test.go
@@ -0,0 +1,44 @@
+package modules
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestUnresolvedImports(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name       string
+		source     string
+		dependency string
+		missing    []string
+	}{
+		{name: "local import", source: `syntax = "proto3"; import "local.proto";`, missing: []string{}},
+		{name: "external import", source: `syntax = "proto3"; import "local.proto"; import "external.proto";`, missing: []string{"external.proto"}},
+		{name: "dependency root", source: `syntax = "proto3"; import "external.proto";`, dependency: "external.proto", missing: []string{}},
+		{name: "well-known import", source: `syntax = "proto3"; import "google/protobuf/timestamp.proto";`, missing: []string{}},
+		{name: "sorted unique missing imports", source: `syntax = "proto3"; import "z.proto"; import "a.proto"; import "z.proto";`, missing: []string{"a.proto", "z.proto"}},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			writeV1GenerateFixture(t, root, "main.proto", tt.source)
+			writeV1GenerateFixture(t, root, "local.proto", `syntax = "proto3";`)
+			var dependencies []string
+			if tt.dependency != "" {
+				dependency := t.TempDir()
+				writeV1GenerateFixture(t, dependency, tt.dependency, `syntax = "proto3";`)
+				dependencies = []string{dependency}
+			}
+
+			missing, err := unresolvedV1ImportsWithRoots(root, []string{"."}, dependencies)
+
+			require.NoError(t, err)
+			assert.Equal(t, tt.missing, missing)
+		})
+	}
+}
diff --git a/internal/modules/update.go b/internal/modules/update.go
new file mode 100644
index 00000000..e7f44fd6
--- /dev/null
+++ b/internal/modules/update.go
@@ -0,0 +1,116 @@
+package modules
+
+import (
+	"bytes"
+	"context"
+	"errors"
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+
+	"golang.org/x/mod/semver"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	disk "github.com/easyp-tech/easyp/internal/fs/fs"
+)
+
+// Update refreshes tagged requirements within their major versions and
+// versionless requirements to Git HEAD; explicit commit pins remain fixed.
+// Local replacements skip remote version lookup and suppress lock/indirect edits.
+func Update(ctx context.Context, root string, repository VersionedRepository) error {
+	original, module, err := ReadManifest(root)
+	if err != nil {
+		return fmt.Errorf("ReadManifest: %w", err)
+	}
+	module = directV1Module(original, module)
+	updatedVersions := make(map[string]string, len(module.Requires))
+	replaced := replacedModules(module)
+	for _, requirement := range module.Requires {
+		if replaced[requirement.Module] {
+			continue
+		}
+		version, err := latestCompatibleV1Tag(ctx, requirement.Module, requirement.Version, repository)
+		if err != nil {
+			return fmt.Errorf("latestCompatibleV1Tag: %w", err)
+		}
+		updatedVersions[requirement.Module] = version
+	}
+	updated := rewriteV1RequiredVersions(original, updatedVersions)
+	updatedModule, err := v1.ParseModule(bytes.NewReader(updated))
+	if err != nil {
+		return fmt.Errorf("ParseModule: %w", err)
+	}
+	if len(updatedModule.Replaces) > 0 {
+		if err := validateLocalOverlay(ctx, root, updatedModule, repository, true); err != nil {
+			return err
+		}
+		if bytes.Equal(original, updated) {
+			return nil
+		}
+		return writeV1Manifest(root, updated)
+	}
+	updatedModule = directV1Module(updated, updatedModule)
+	existing, err := ReadLock(filepath.Join(root, v1.LockFile))
+	if err != nil && !errors.Is(err, os.ErrNotExist) {
+		return fmt.Errorf("ReadLock: %w", err)
+	}
+	lock, err := resolveV1Lock(ctx, root, updatedModule, existing, repository, false)
+	if err != nil {
+		return fmt.Errorf("resolveV1LockWithPins: %w", err)
+	}
+	updated, err = augmentV1ManifestRequirements(updated, root, updatedModule, lock, repository)
+	if err != nil {
+		return fmt.Errorf("augmentV1ManifestRequirements: %w", err)
+	}
+	return writeV1ResolvedFiles(root, original, updated, lock)
+}
+
+func latestCompatibleV1Tag(ctx context.Context, source, current string, repository VersionedRepository) (string, error) {
+	if current == "" {
+		// Versionless requirements resolve the current Git HEAD.
+		return "", nil
+	}
+	if v1.IsCommitRef(current) {
+		return current, nil
+	}
+	if !semver.IsValid(current) {
+		return "", fmt.Errorf("%s: invalid required version %q", source, current)
+	}
+	versions, err := repository.Versions(ctx, source)
+	if err != nil {
+		return "", fmt.Errorf("Versions: %w", err)
+	}
+	best := current
+	for _, version := range versions {
+		if semver.Major(version) != semver.Major(current) {
+			continue
+		}
+		if semver.Prerelease(current) == "" && semver.Prerelease(version) != "" {
+			continue
+		}
+		if semver.Compare(version, best) > 0 {
+			best = version
+		}
+	}
+	return best, nil
+}
+
+func rewriteV1RequiredVersions(original []byte, updates map[string]string) []byte {
+	lines := strings.Split(string(original), "\n")
+	for _, line := range parseV1RequirementLines(lines) {
+		version, ok := updates[line.module]
+		if !ok || line.version == "" {
+			continue
+		}
+		lines[line.index] = line.withVersion(version).String()
+	}
+	return []byte(strings.Join(lines, "\n"))
+}
+
+func writeV1Manifest(root string, raw []byte) error {
+	if err := disk.WriteAtomicFile(filepath.Join(root, v1.ModuleFile), raw, 0o644); err != nil {
+		return fmt.Errorf("WriteAtomicFile: %w", err)
+	}
+	return nil
+}
diff --git a/internal/modules/update_https_test.go b/internal/modules/update_https_test.go
new file mode 100644
index 00000000..b33153f8
--- /dev/null
+++ b/internal/modules/update_https_test.go
@@ -0,0 +1,49 @@
+package modules
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+)
+
+func TestRewriteV1RequiredVersionsHTTPSIdentity(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name     string
+		original string
+		updates  map[string]string
+		want     string
+	}{
+		{
+			name:     "preserve URL and indirect comment",
+			original: "module https://example.com/user.git\nrequire https://example.com/common.git v1.0.0 // indirect\n",
+			updates:  map[string]string{"https://example.com/common.git": "v1.1.0"},
+			want:     "module https://example.com/user.git\nrequire https://example.com/common.git v1.1.0 // indirect\n",
+		},
+		{
+			name:     "leave versionless dependency untouched",
+			original: "module https://example.com/user.git\nrequire https://example.com/common.git // latest head\n",
+			updates:  map[string]string{"https://example.com/common.git": "v1.1.0"},
+			want:     "module https://example.com/user.git\nrequire https://example.com/common.git // latest head\n",
+		},
+		{
+			name:     "leave unselected dependency untouched",
+			original: "module https://example.com/user.git\nrequire https://example.com/common.git v1.0.0 // indirect\n",
+			updates:  map[string]string{"https://example.com/other.git": "v1.1.0"},
+			want:     "module https://example.com/user.git\nrequire https://example.com/common.git v1.0.0 // indirect\n",
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			original := []byte(tt.original)
+
+			updated := rewriteV1RequiredVersions(original, tt.updates)
+
+			assert.Equal(t, tt.want, string(updated))
+			assert.Equal(t, tt.original, string(original))
+		})
+	}
+}
diff --git a/internal/modules/update_test.go b/internal/modules/update_test.go
new file mode 100644
index 00000000..7af96ac5
--- /dev/null
+++ b/internal/modules/update_test.go
@@ -0,0 +1,58 @@
+package modules
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestRewriteV1RequiredVersionsBlockWhitespace(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name    string
+		opening string
+		want    string
+	}{
+		{
+			name:    "single space",
+			opening: "require (",
+			want:    "module example.com/root\nrequire ( // dependencies\n\thttps://example.com/common.git v1.1.0 // indirect\n)\n",
+		},
+		{
+			name:    "no space",
+			opening: "require(",
+			want:    "module example.com/root\nrequire( // dependencies\n\thttps://example.com/common.git v1.1.0 // indirect\n)\n",
+		},
+		{
+			name:    "tab",
+			opening: "require\t(",
+			want:    "module example.com/root\nrequire\t( // dependencies\n\thttps://example.com/common.git v1.1.0 // indirect\n)\n",
+		},
+		{
+			name:    "multiple spaces",
+			opening: "require   (",
+			want:    "module example.com/root\nrequire   ( // dependencies\n\thttps://example.com/common.git v1.1.0 // indirect\n)\n",
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			original := "module example.com/root\n" + tt.opening + " // dependencies\n\thttps://example.com/common.git v1.0.0 // indirect\n)\n"
+			_, err := v1.ParseModule(strings.NewReader(original))
+			require.NoError(t, err)
+
+			updated := rewriteV1RequiredVersions([]byte(original), map[string]string{
+				"https://example.com/common.git": "v1.1.0",
+			})
+
+			assert.Equal(t, tt.want, string(updated))
+		})
+	}
+}
diff --git a/internal/modules/vendor.go b/internal/modules/vendor.go
new file mode 100644
index 00000000..bd6f9992
--- /dev/null
+++ b/internal/modules/vendor.go
@@ -0,0 +1,110 @@
+package modules
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"os"
+	"path/filepath"
+
+	disk "github.com/easyp-tech/easyp/internal/fs/fs"
+)
+
+// Vendor copies the effective dependency sources into one import root.
+// Local replacements are copied without writing or creating the published lock.
+func Vendor(ctx context.Context, root string, repository Cache) error {
+	_, module, err := ReadManifest(root)
+	if err != nil {
+		return fmt.Errorf("ReadManifest: %w", err)
+	}
+	dependencyRoots, err := EnsureSources(ctx, root, module, repository)
+	if err != nil {
+		return fmt.Errorf("EnsureSources: %w", err)
+	}
+	own, err := ModuleSources(root, module)
+	if err != nil {
+		return fmt.Errorf("ModuleSources: %w", err)
+	}
+	if err := CheckSourceCollisions(append(own, dependencyRoots...)); err != nil {
+		return fmt.Errorf("CheckSourceCollisions: %w", err)
+	}
+	return writeV1Vendor(root, dependencyRoots)
+}
+
+func writeV1Vendor(root string, roots SourceRoots) error {
+	stage, err := os.MkdirTemp(root, ".easyp-vendor-*")
+	if err != nil {
+		return fmt.Errorf("MkdirTemp: %w", err)
+	}
+	defer func() { _ = os.RemoveAll(stage) }()
+	allowed := roots.FileAllowed()
+	for _, source := range roots {
+		err := source.Walk(func(path string) error {
+			if allowed != nil && !allowed(path) {
+				return nil
+			}
+			importPath, err := filepath.Rel(source.Path, path)
+			if err != nil {
+				return fmt.Errorf("Rel: %w", err)
+			}
+			if !filepath.IsLocal(importPath) {
+				return fmt.Errorf("invalid import path %q", importPath)
+			}
+			if err := disk.CopyRegularFile(path, filepath.Join(stage, importPath)); err != nil {
+				return fmt.Errorf("CopyRegularFile: %w", err)
+			}
+			return nil
+		})
+		if err != nil {
+			return fmt.Errorf("vendor %s: %w", source.Module, err)
+		}
+	}
+	return replaceV1Vendor(root, stage)
+}
+
+func replaceV1Vendor(root, stage string) error {
+	target := filepath.Join(root, VendorDir)
+	backup := filepath.Join(root, ".easyp-vendor-backup")
+	if _, err := os.Lstat(backup); !errors.Is(err, os.ErrNotExist) {
+		if err != nil {
+			return fmt.Errorf("Lstat: %w", err)
+		}
+		return fmt.Errorf("vendor backup %s already exists", backup)
+	}
+	info, err := os.Lstat(target)
+	if err != nil && !errors.Is(err, os.ErrNotExist) {
+		return fmt.Errorf("Lstat: %w", err)
+	}
+	if info != nil {
+		if !info.IsDir() {
+			return fmt.Errorf("vendor path %s is not a regular directory", target)
+		}
+		if err := os.Rename(target, backup); err != nil {
+			return fmt.Errorf("Rename: %w", err)
+		}
+	}
+	if err := os.Rename(stage, target); err != nil {
+		if restoreErr := restoreV1Vendor(backup, target); restoreErr != nil {
+			return errors.Join(err, restoreErr)
+		}
+		return fmt.Errorf("Rename: %w", err)
+	}
+	if err := os.RemoveAll(backup); err != nil && !errors.Is(err, os.ErrNotExist) {
+		return fmt.Errorf("RemoveAll: %w", err)
+	}
+	return nil
+}
+
+func restoreV1Vendor(backup, target string) error {
+	_, err := os.Lstat(backup)
+	if errors.Is(err, os.ErrNotExist) {
+		return nil
+	}
+	if err != nil {
+		return fmt.Errorf("Lstat: %w", err)
+	}
+	if err := os.Rename(backup, target); err != nil {
+		return fmt.Errorf("Rename: %w", err)
+	}
+	return nil
+}
diff --git a/internal/modules/vendor_test.go b/internal/modules/vendor_test.go
new file mode 100644
index 00000000..7057d342
--- /dev/null
+++ b/internal/modules/vendor_test.go
@@ -0,0 +1,62 @@
+package modules
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestWriteV1Vendor(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name      string
+		files     map[string]string
+		roots     []string
+		wantErr   string
+		wantFiles map[string]string
+	}{
+		{name: "collision preserves existing vendor", files: map[string]string{"first/shared.proto": "first", "second/shared.proto": "second"}, roots: []string{"first", "second"}, wantErr: "shared.proto", wantFiles: map[string]string{"keep.proto": "keep"}},
+		{name: "new sources replace stale files", files: map[string]string{"dep/v1/item.proto": "syntax = \"proto3\";"}, roots: []string{"dep"}, wantFiles: map[string]string{"v1/item.proto": "syntax = \"proto3\";"}},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			for name, content := range tt.files {
+				writeV1GenerateFixture(t, root, name, content)
+			}
+			vendor := filepath.Join(root, VendorDir)
+			writeV1GenerateFixture(t, vendor, "keep.proto", "keep")
+			var roots SourceRoots
+			for _, dir := range tt.roots {
+				roots = append(roots, SourceRoot{Path: filepath.Join(root, dir), Module: dir})
+			}
+
+			err := writeV1Vendor(root, roots)
+
+			if tt.wantErr != "" {
+				require.ErrorContains(t, err, tt.wantErr)
+			} else {
+				require.NoError(t, err)
+			}
+			actual := map[string]string{}
+			require.NoError(t, WalkProtoFiles(vendor, func(path string) error {
+				relative, err := filepath.Rel(vendor, path)
+				if err != nil {
+					return err
+				}
+				content, err := os.ReadFile(path)
+				if err != nil {
+					return err
+				}
+				actual[filepath.ToSlash(relative)] = string(content)
+				return nil
+			}))
+			assert.Equal(t, tt.wantFiles, actual)
+		})
+	}
+}
diff --git a/internal/modules/versionless_update_test.go b/internal/modules/versionless_update_test.go
new file mode 100644
index 00000000..ca25fc09
--- /dev/null
+++ b/internal/modules/versionless_update_test.go
@@ -0,0 +1,219 @@
+package modules
+
+import (
+	"context"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+const (
+	versionlessCommitA    = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+	versionlessCommitANew = "dddddddddddddddddddddddddddddddddddddddd"
+	versionlessCommitBOld = "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+	versionlessCommitBNew = "cccccccccccccccccccccccccccccccccccccccc"
+	versionlessHash       = "h1:47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU="
+)
+
+func TestTransitiveVersionlessRequirementRemainsUpdatable(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name                     string
+		get                      bool
+		transitiveVersion        string
+		changeUpstream           bool
+		updatedTransitiveVersion string
+		wantManifestB            string
+		wantUpdatedManifestB     string
+		wantUpdatedB             string
+	}{
+		{name: "tidy keeps versionless indirect", wantManifestB: "require example.com/B // indirect\n", wantUpdatedB: versionlessCommitBNew},
+		{name: "get keeps versionless indirect", get: true, wantManifestB: "require example.com/B // indirect\n", wantUpdatedB: versionlessCommitBNew},
+		{name: "explicit transitive commit stays pinned", transitiveVersion: versionlessCommitBOld, wantManifestB: "require example.com/B " + versionlessCommitBOld + " // indirect\n", wantUpdatedB: versionlessCommitBOld},
+		{
+			name:                     "changed upstream commit replaces derived pin",
+			transitiveVersion:        versionlessCommitBOld,
+			changeUpstream:           true,
+			updatedTransitiveVersion: versionlessCommitBNew,
+			wantManifestB:            "require example.com/B " + versionlessCommitBOld + " // indirect\n",
+			wantUpdatedManifestB:     "require example.com/B " + versionlessCommitBNew + " // indirect\n",
+			wantUpdatedB:             versionlessCommitBNew,
+		},
+		{
+			name:                 "upstream removes commit pin",
+			transitiveVersion:    versionlessCommitBOld,
+			changeUpstream:       true,
+			wantManifestB:        "require example.com/B " + versionlessCommitBOld + " // indirect\n",
+			wantUpdatedManifestB: "require example.com/B // indirect\n",
+			wantUpdatedB:         versionlessCommitBNew,
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			manifest := "module example.com/app\n"
+			if !tt.get {
+				manifest += "require example.com/A\n"
+			}
+			require.NoError(t, os.WriteFile(filepath.Join(root, v1.ModuleFile), []byte(manifest), 0o600))
+			repository := &movingHeadRepository{
+				cacheDir: t.TempDir(), bHead: versionlessCommitBOld,
+				aModule: v1.Module{Name: "example.com/A", Roots: []string{"."}, Requires: []v1.Requirement{{Module: "example.com/B", Version: tt.transitiveVersion}}},
+				bModule: v1.Module{Name: "example.com/B", Roots: []string{"."}},
+			}
+			for _, name := range []string{"A", "B"} {
+				directory := filepath.Join(repository.cacheDir, name)
+				require.NoError(t, os.MkdirAll(directory, 0o755))
+				require.NoError(t, os.WriteFile(filepath.Join(directory, name+".proto"), []byte("syntax = \"proto3\";\n"), 0o644))
+			}
+
+			var err error
+			if tt.get {
+				err = Get(t.Context(), root, v1.Requirement{Module: "example.com/A"}, repository)
+			} else {
+				err = Tidy(t.Context(), root, repository)
+			}
+			require.NoError(t, err)
+			updatedManifest, err := os.ReadFile(filepath.Join(root, v1.ModuleFile))
+			require.NoError(t, err)
+			assert.Contains(t, string(updatedManifest), tt.wantManifestB)
+
+			repository.bHead = versionlessCommitBNew
+			if tt.changeUpstream {
+				repository.aModule.Requires[0].Version = tt.updatedTransitiveVersion
+			}
+			require.NoError(t, Update(t.Context(), root, repository))
+			updatedManifest, err = os.ReadFile(filepath.Join(root, v1.ModuleFile))
+			require.NoError(t, err)
+			wantUpdatedManifestB := tt.wantUpdatedManifestB
+			if wantUpdatedManifestB == "" {
+				wantUpdatedManifestB = tt.wantManifestB
+			}
+			assert.Contains(t, string(updatedManifest), wantUpdatedManifestB)
+			if tt.changeUpstream {
+				assert.NotContains(t, string(updatedManifest), tt.wantManifestB)
+			}
+			lock, err := ReadLock(filepath.Join(root, v1.LockFile))
+			require.NoError(t, err)
+			for _, entry := range lock.Modules {
+				if entry.Source == "example.com/B" {
+					assert.Equal(t, tt.wantUpdatedB, entry.Commit)
+					return
+				}
+			}
+			t.Fatal("B is missing from protobuf.lock")
+		})
+	}
+}
+
+func TestGetRefreshesDerivedTransitiveRequirements(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name            string
+		updatedRequires []v1.Requirement
+		wantB           string
+	}{
+		{
+			name:            "updated upstream pin replaces derived requirement",
+			updatedRequires: []v1.Requirement{{Module: "example.com/B", Version: versionlessCommitBNew}},
+			wantB:           "require example.com/B " + versionlessCommitBNew + " // indirect\n",
+		},
+		{
+			name: "removed upstream dependency removes derived requirement",
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			root := t.TempDir()
+			manifest := "module example.com/app\nrequire example.com/A\n"
+			require.NoError(t, os.WriteFile(filepath.Join(root, v1.ModuleFile), []byte(manifest), 0o600))
+			repository := &movingHeadRepository{
+				cacheDir: t.TempDir(),
+				bHead:    versionlessCommitBOld,
+				aModule: v1.Module{
+					Name:     "example.com/A",
+					Roots:    []string{"."},
+					Requires: []v1.Requirement{{Module: "example.com/B", Version: versionlessCommitBOld}},
+				},
+				bModule: v1.Module{Name: "example.com/B", Roots: []string{"."}},
+			}
+			for _, name := range []string{"A", "B"} {
+				directory := filepath.Join(repository.cacheDir, name)
+				require.NoError(t, os.MkdirAll(directory, 0o755))
+				require.NoError(t, os.WriteFile(filepath.Join(directory, name+".proto"), []byte("syntax = \"proto3\";\n"), 0o644))
+			}
+
+			require.NoError(t, Tidy(t.Context(), root, repository))
+			before, err := os.ReadFile(filepath.Join(root, v1.ModuleFile))
+			require.NoError(t, err)
+			oldB := "require example.com/B " + versionlessCommitBOld + " // indirect\n"
+			assert.Contains(t, string(before), oldB)
+
+			repository.bHead = versionlessCommitBNew
+			repository.aModule.Requires = tt.updatedRequires
+			require.NoError(t, Get(t.Context(), root, v1.Requirement{Module: "example.com/A", Version: versionlessCommitANew}, repository))
+
+			after, err := os.ReadFile(filepath.Join(root, v1.ModuleFile))
+			require.NoError(t, err)
+			assert.NotContains(t, string(after), oldB)
+			if tt.wantB != "" {
+				assert.Contains(t, string(after), tt.wantB)
+			} else {
+				assert.NotContains(t, string(after), "require example.com/B")
+			}
+		})
+	}
+}
+
+type movingHeadRepository struct {
+	cacheDir, bHead string
+	aModule         v1.Module
+	bModule         v1.Module
+}
+
+func (r *movingHeadRepository) Fetch(_ context.Context, source, version string) (Fetched, error) {
+	switch source {
+	case "example.com/A":
+		if version == "" {
+			version = versionlessCommitA
+		}
+		return Fetched{Module: r.aModule, Lock: v1.LockedModule{Source: source, Version: version, Commit: version, Hash: versionlessHash}}, nil
+	case "example.com/B":
+		if version == "" {
+			version = r.bHead
+		}
+		return Fetched{Module: r.bModule, Lock: v1.LockedModule{Source: source, Version: version, Commit: version, Hash: versionlessHash}}, nil
+	default:
+		return Fetched{}, os.ErrNotExist
+	}
+}
+
+func (r *movingHeadRepository) Install(context.Context, v1.Lock) error { return nil }
+
+func (r *movingHeadRepository) Cached(entry v1.LockedModule) (string, v1.Module, error) {
+	switch entry.Source {
+	case "example.com/A":
+		return filepath.Join(r.cacheDir, "A"), r.aModule, nil
+	case "example.com/B":
+		return filepath.Join(r.cacheDir, "B"), r.bModule, nil
+	default:
+		return "", v1.Module{}, os.ErrNotExist
+	}
+}
+
+func (r *movingHeadRepository) Versions(context.Context, string) ([]string, error) {
+	return nil, nil
+}
diff --git a/internal/modules/walk.go b/internal/modules/walk.go
new file mode 100644
index 00000000..f3a2d3ce
--- /dev/null
+++ b/internal/modules/walk.go
@@ -0,0 +1,27 @@
+package modules
+
+import (
+	"io/fs"
+	"path/filepath"
+
+	"github.com/easyp-tech/easyp/internal/core/path_helpers"
+)
+
+// WalkProtoFiles visits source files while excluding hidden, vendor and nested-module directories.
+func WalkProtoFiles(root string, visit func(string) error) error {
+	return filepath.WalkDir(root, func(path string, entry fs.DirEntry, walkErr error) error {
+		if walkErr != nil {
+			return walkErr
+		}
+		if entry.IsDir() {
+			if path_helpers.ShouldSkipV1SourceDir(root, path) {
+				return filepath.SkipDir
+			}
+			return nil
+		}
+		if filepath.Ext(path) != ".proto" {
+			return nil
+		}
+		return visit(path)
+	})
+}
diff --git a/internal/policy/resolver.go b/internal/policy/resolver.go
new file mode 100644
index 00000000..ec359423
--- /dev/null
+++ b/internal/policy/resolver.go
@@ -0,0 +1,451 @@
+// Package policy resolves producer-policy extends without changing module
+// ownership or acquiring unpinned dependencies.
+package policy
+
+import (
+	"bytes"
+	"context"
+	"fmt"
+	"os"
+	"path/filepath"
+	"slices"
+	"strings"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+const maxExtendsDepth = 16
+
+// GraphProvider supplies the consumer's verified module graph. It is injected
+// so config/v1 parsing remains syntax-only and independent of module resolution.
+type GraphProvider func(context.Context, string) (modules.PolicyGraph, error)
+
+// Resolver is operation-scoped. Its caches are never shared between commands
+// or module contexts.
+type Resolver struct {
+	WorkspaceRoot string
+	Graph         GraphProvider
+
+	loaded   map[loadKey]loadedPolicy
+	graphs   map[string]modules.PolicyGraph
+	resolved map[resolveKey]resolvedSection
+}
+
+// NewResolver constructs an operation-scoped policy resolver.
+func NewResolver(workspaceRoot string, graph GraphProvider) *Resolver {
+	if canonical, err := filepath.EvalSymlinks(workspaceRoot); err == nil {
+		workspaceRoot = canonical
+	}
+	return &Resolver{
+		WorkspaceRoot: workspaceRoot,
+		Graph:         graph,
+		loaded:        make(map[loadKey]loadedPolicy),
+		graphs:        make(map[string]modules.PolicyGraph),
+		resolved:      make(map[resolveKey]resolvedSection),
+	}
+}
+
+type loadedPolicy struct {
+	path              string
+	canonical         string
+	policy            v1.Policy
+	presence          v1.PolicyPresence
+	expandEnvironment bool
+}
+
+type loadKey struct {
+	path              string
+	expandEnvironment bool
+}
+
+type resolveKey struct {
+	path              string
+	section           string
+	graph             string
+	boundary          string
+	expandEnvironment bool
+}
+
+type resolvedSection struct {
+	linters  v1.LinterPolicy
+	settings map[string]map[string]string
+	breaking v1.BreakingPolicy
+	chain    []string
+}
+
+// LintInput describes the nearest-section lint cascade selected by the CLI.
+// Linters and settings may come from different policy files.
+type LintInput struct {
+	PolicyPath     string
+	Policy         v1.Policy
+	Presence       v1.PolicyPresence
+	SettingsPath   string
+	Settings       map[string]map[string]string
+	SettingsSource v1.PolicyPresence
+	ModuleDir      string
+}
+
+// LintResult contains the resolved lint section and its linter settings. Issues
+// stay owned by the consuming nearest-section cascade and are never inherited.
+type LintResult struct {
+	Policy v1.Policy
+	Chain  []string
+}
+
+// ResolveLint resolves linters.extends recursively, then applies the local
+// linter and settings adjustments. Remote references use the checked graph of
+// moduleDir; local references stay inside the workspace or verified module.
+func (r *Resolver) ResolveLint(ctx context.Context, input LintInput) (LintResult, error) {
+	local := input.Policy
+	local.LinterSettings = input.Settings
+	if local.Linters.Extends == "" {
+		return LintResult{Policy: local}, nil
+	}
+	graph, err := r.graphForReference(ctx, input.ModuleDir, local.Linters.Extends)
+	if err != nil {
+		return LintResult{}, fmt.Errorf("resolve %s linters.extends %q for consuming policy %s: %w", input.PolicyPath, local.Linters.Extends, input.PolicyPath, err)
+	}
+	current, err := r.load(input.PolicyPath, true)
+	if err != nil {
+		return LintResult{}, err
+	}
+	basePath, baseBoundary, reference, expandEnvironment, err := r.resolveReference(current, local.Linters.Extends, graph, r.WorkspaceRoot)
+	if err != nil {
+		return LintResult{}, fmt.Errorf("%s: linters.extends %q: %w", input.PolicyPath, local.Linters.Extends, err)
+	}
+	base, err := r.resolveLintFile(ctx, basePath, baseBoundary, input.ModuleDir, expandEnvironment, nil)
+	if err != nil {
+		return LintResult{}, fmt.Errorf("%s: linters.extends %q resolved to %s: %w", input.PolicyPath, reference, basePath, err)
+	}
+	local.Linters = v1.MergeLinterSection(base.linters, local.Linters, input.Presence, true)
+	local.Linters.Extends = ""
+	local.LinterSettings = v1.MergeLinterSettings(base.settings, input.Settings, input.SettingsSource, true)
+	return LintResult{Policy: local, Chain: append(base.chain, input.PolicyPath)}, nil
+}
+
+// BreakingInput describes the nearest breaking section and the module whose
+// files consume it. The module graph is intentionally supplied per checked
+// module because a shared policy can be used by modules with different overlays.
+type BreakingInput struct {
+	PolicyPath string
+	Policy     v1.Policy
+	Presence   v1.PolicyPresence
+	ModuleDir  string
+}
+
+// BreakingResult contains the resolved breaking section and provenance chain.
+type BreakingResult struct {
+	Policy v1.Policy
+	Chain  []string
+}
+
+// ResolveBreaking resolves breaking.extends independently of lint inheritance.
+func (r *Resolver) ResolveBreaking(ctx context.Context, input BreakingInput) (BreakingResult, error) {
+	local := input.Policy
+	if local.Breaking.Extends == "" {
+		return BreakingResult{Policy: local}, nil
+	}
+	graph, err := r.graphForReference(ctx, input.ModuleDir, local.Breaking.Extends)
+	if err != nil {
+		return BreakingResult{}, fmt.Errorf("resolve %s breaking.extends %q for consuming policy %s: %w", input.PolicyPath, local.Breaking.Extends, input.PolicyPath, err)
+	}
+	current, err := r.load(input.PolicyPath, true)
+	if err != nil {
+		return BreakingResult{}, err
+	}
+	basePath, baseBoundary, reference, expandEnvironment, err := r.resolveReference(current, local.Breaking.Extends, graph, r.WorkspaceRoot)
+	if err != nil {
+		return BreakingResult{}, fmt.Errorf("%s: breaking.extends %q: %w", input.PolicyPath, local.Breaking.Extends, err)
+	}
+	base, err := r.resolveBreakingFile(ctx, basePath, baseBoundary, input.ModuleDir, expandEnvironment, nil)
+	if err != nil {
+		return BreakingResult{}, fmt.Errorf("%s: breaking.extends %q resolved to %s: %w", input.PolicyPath, reference, basePath, err)
+	}
+	local.Breaking = v1.MergeBreakingSection(base.breaking, local.Breaking, input.Presence, true)
+	local.Breaking.Extends = ""
+	return BreakingResult{Policy: local, Chain: append(base.chain, input.PolicyPath)}, nil
+}
+
+func (r *Resolver) resolveLintFile(ctx context.Context, path, boundary string, graphKey string, expandEnvironment bool, stack []string) (resolvedSection, error) {
+	loaded, err := r.load(path, expandEnvironment)
+	if err != nil {
+		return resolvedSection{}, err
+	}
+	key := resolveKey{path: loaded.canonical, section: v1.PolicySectionLinters, graph: graphKey, boundary: boundary, expandEnvironment: loaded.expandEnvironment}
+	if cached, ok := r.resolved[key]; ok {
+		if len(stack)+len(cached.chain) > maxExtendsDepth {
+			return resolvedSection{}, fmt.Errorf("policy extends exceeds maximum depth %d at %s", maxExtendsDepth, path)
+		}
+		return cached, nil
+	}
+	if err := checkCycle(loaded.canonical, v1.PolicySectionLinters, stack); err != nil {
+		return resolvedSection{}, err
+	}
+	if !loaded.presence.Has(v1.PolicySectionLinters) {
+		return resolvedSection{}, fmt.Errorf("base policy %s does not define linters", loaded.path)
+	}
+	stack = append(stack, loaded.canonical+"#linters")
+	var result resolvedSection
+	if loaded.policy.Linters.Extends != "" {
+		graph, err := r.graphForReference(ctx, graphKey, loaded.policy.Linters.Extends)
+		if err != nil {
+			return resolvedSection{}, fmt.Errorf("%s: linters.extends %q: %w", loaded.path, loaded.policy.Linters.Extends, err)
+		}
+		basePath, baseBoundary, _, baseExpandEnvironment, err := r.resolveReference(loaded, loaded.policy.Linters.Extends, graph, boundary)
+		if err != nil {
+			return resolvedSection{}, fmt.Errorf("%s: linters.extends %q: %w", loaded.path, loaded.policy.Linters.Extends, err)
+		}
+		base, err := r.resolveLintFile(ctx, basePath, baseBoundary, graphKey, baseExpandEnvironment, stack)
+		if err != nil {
+			return resolvedSection{}, fmt.Errorf("%s: linters.extends %q resolved to %s: %w", loaded.path, loaded.policy.Linters.Extends, basePath, err)
+		}
+		result.linters = v1.MergeLinterSection(base.linters, loaded.policy.Linters, loaded.presence, true)
+		result.settings = v1.MergeLinterSettings(base.settings, loaded.policy.LinterSettings, loaded.presence, true)
+		result.chain = append(base.chain, loaded.path)
+	} else {
+		result.linters = v1.BaseLinterSection(loaded.policy.Linters, loaded.presence)
+		result.settings = cloneSettings(loaded.policy.LinterSettings)
+		result.chain = []string{loaded.path}
+	}
+	r.resolved[key] = result
+	return result, nil
+}
+
+func (r *Resolver) resolveBreakingFile(ctx context.Context, path, boundary string, graphKey string, expandEnvironment bool, stack []string) (resolvedSection, error) {
+	loaded, err := r.load(path, expandEnvironment)
+	if err != nil {
+		return resolvedSection{}, err
+	}
+	key := resolveKey{path: loaded.canonical, section: v1.PolicySectionBreaking, graph: graphKey, boundary: boundary, expandEnvironment: loaded.expandEnvironment}
+	if cached, ok := r.resolved[key]; ok {
+		if len(stack)+len(cached.chain) > maxExtendsDepth {
+			return resolvedSection{}, fmt.Errorf("policy extends exceeds maximum depth %d at %s", maxExtendsDepth, path)
+		}
+		return cached, nil
+	}
+	if err := checkCycle(loaded.canonical, v1.PolicySectionBreaking, stack); err != nil {
+		return resolvedSection{}, err
+	}
+	if !loaded.presence.Has(v1.PolicySectionBreaking) {
+		return resolvedSection{}, fmt.Errorf("base policy %s does not define breaking", loaded.path)
+	}
+	stack = append(stack, loaded.canonical+"#breaking")
+	var result resolvedSection
+	if loaded.policy.Breaking.Extends != "" {
+		graph, err := r.graphForReference(ctx, graphKey, loaded.policy.Breaking.Extends)
+		if err != nil {
+			return resolvedSection{}, fmt.Errorf("%s: breaking.extends %q: %w", loaded.path, loaded.policy.Breaking.Extends, err)
+		}
+		basePath, baseBoundary, _, baseExpandEnvironment, err := r.resolveReference(loaded, loaded.policy.Breaking.Extends, graph, boundary)
+		if err != nil {
+			return resolvedSection{}, fmt.Errorf("%s: breaking.extends %q: %w", loaded.path, loaded.policy.Breaking.Extends, err)
+		}
+		base, err := r.resolveBreakingFile(ctx, basePath, baseBoundary, graphKey, baseExpandEnvironment, stack)
+		if err != nil {
+			return resolvedSection{}, fmt.Errorf("%s: breaking.extends %q resolved to %s: %w", loaded.path, loaded.policy.Breaking.Extends, basePath, err)
+		}
+		result.breaking = v1.MergeBreakingSection(base.breaking, loaded.policy.Breaking, loaded.presence, true)
+		result.chain = append(base.chain, loaded.path)
+	} else {
+		result.breaking = v1.BaseBreakingSection(loaded.policy.Breaking, loaded.presence)
+		result.chain = []string{loaded.path}
+	}
+	r.resolved[key] = result
+	return result, nil
+}
+
+func (r *Resolver) load(path string, expandEnvironment bool) (loadedPolicy, error) {
+	absolute, err := filepath.Abs(path)
+	if err != nil {
+		return loadedPolicy{}, fmt.Errorf("policy source %s: Abs: %w", path, err)
+	}
+	canonical, err := filepath.EvalSymlinks(absolute)
+	if err != nil {
+		return loadedPolicy{}, fmt.Errorf("policy source %s: EvalSymlinks: %w", path, err)
+	}
+	key := loadKey{path: canonical, expandEnvironment: expandEnvironment}
+	if cached, ok := r.loaded[key]; ok {
+		return cached, nil
+	}
+	raw, err := os.ReadFile(canonical)
+	if err != nil {
+		return loadedPolicy{}, fmt.Errorf("read policy source %s: %w", canonical, err)
+	}
+	var parsed v1.Policy
+	if expandEnvironment {
+		parsed, err = v1.ParsePolicy(bytes.NewReader(raw))
+	} else {
+		parsed, err = v1.ParsePolicyLiteral(bytes.NewReader(raw))
+	}
+	if err != nil {
+		return loadedPolicy{}, fmt.Errorf("invalid policy source %s: %w", canonical, err)
+	}
+	presence, err := v1.ParsePolicyPresence(raw)
+	if err != nil {
+		return loadedPolicy{}, fmt.Errorf("policy source %s presence: %w", canonical, err)
+	}
+	result := loadedPolicy{
+		path: canonical, canonical: canonical, policy: parsed, presence: presence,
+		expandEnvironment: expandEnvironment,
+	}
+	r.loaded[key] = result
+	return result, nil
+}
+
+func (r *Resolver) graph(ctx context.Context, moduleDir string) (modules.PolicyGraph, error) {
+	if moduleDir == "" {
+		return nil, fmt.Errorf("remote policy references require the consuming protobuf.mod and its locked graph")
+	}
+	key, err := filepath.Abs(moduleDir)
+	if err != nil {
+		return nil, err
+	}
+	if graph, ok := r.graphs[key]; ok {
+		return graph, nil
+	}
+	if r.Graph == nil {
+		return nil, fmt.Errorf("remote policy references require a verified module graph")
+	}
+	graph, err := r.Graph(ctx, key)
+	if err != nil {
+		return nil, err
+	}
+	r.graphs[key] = graph
+	return graph, nil
+}
+
+func (r *Resolver) graphForReference(ctx context.Context, moduleDir, raw string) (modules.PolicyGraph, error) {
+	reference, err := v1.ParsePolicyReference(raw)
+	if err != nil {
+		return nil, err
+	}
+	if reference.Local {
+		return nil, nil
+	}
+	return r.graph(ctx, moduleDir)
+}
+
+func (r *Resolver) resolveReference(from loadedPolicy, raw string, graph modules.PolicyGraph, inheritedBoundary string) (string, string, string, bool, error) {
+	reference, err := v1.ParsePolicyReference(raw)
+	if err != nil {
+		return "", "", "", false, err
+	}
+	if reference.Empty() {
+		return "", "", "", false, fmt.Errorf("empty reference")
+	}
+	expandEnvironment := from.expandEnvironment
+	var directory, boundary string
+	if reference.Local {
+		directory = filepath.Join(filepath.Dir(from.path), filepath.FromSlash(reference.Path))
+		boundary = inheritedBoundary
+	} else {
+		moduleName, relative, err := matchModuleReference(reference, graph)
+		if err != nil {
+			return "", "", "", false, err
+		}
+		module := graph[moduleName]
+		directory = module.Directory
+		boundary = module.Directory
+		expandEnvironment = false
+		if relative != "" {
+			directory = filepath.Join(module.Directory, filepath.FromSlash(relative))
+		}
+	}
+	if !within(directory, boundary) {
+		return "", "", "", false, fmt.Errorf("reference %q selects a path outside allowed policy root %s", raw, boundary)
+	}
+	info, err := os.Stat(directory)
+	if err != nil {
+		return "", "", "", false, fmt.Errorf("reference %q selects %s: %w", raw, directory, err)
+	}
+	if info.IsDir() {
+		directory = filepath.Join(directory, v1.PolicyFile)
+	}
+	canonical, err := filepath.EvalSymlinks(directory)
+	if err != nil {
+		return "", "", "", false, fmt.Errorf("reference %q policy file %s: %w", raw, directory, err)
+	}
+	info, err = os.Stat(canonical)
+	if err != nil {
+		return "", "", "", false, fmt.Errorf("reference %q policy file %s: %w", raw, canonical, err)
+	}
+	if !info.Mode().IsRegular() {
+		return "", "", "", false, fmt.Errorf("reference %q policy file %s is not regular", raw, canonical)
+	}
+	canonicalBoundary, err := filepath.EvalSymlinks(boundary)
+	if err != nil {
+		return "", "", "", false, fmt.Errorf("reference %q boundary %s: %w", raw, boundary, err)
+	}
+	if !within(canonical, canonicalBoundary) {
+		return "", "", "", false, fmt.Errorf("reference %q resolves outside allowed policy root %s", raw, canonicalBoundary)
+	}
+	return canonical, canonicalBoundary, raw, expandEnvironment, nil
+}
+
+func matchModuleReference(reference v1.PolicyReference, graph modules.PolicyGraph) (string, string, error) {
+	if reference.Fragment {
+		if _, ok := graph[reference.Module]; !ok {
+			return "", "", fmt.Errorf("module %s in reference %q is not declared and resolved in the consumer's protobuf.mod/protobuf.lock", reference.Module, reference.Raw)
+		}
+		return reference.Module, reference.Relative, nil
+	}
+	var candidates []string
+	for _, name := range graph.SortedNames() {
+		if reference.Raw == name || strings.HasPrefix(reference.Raw, name+"/") {
+			candidates = append(candidates, name)
+		}
+	}
+	if len(candidates) == 0 {
+		return "", "", fmt.Errorf("reference %q does not match a declared and resolved module identity", reference.Raw)
+	}
+	slices.SortFunc(candidates, func(a, b string) int {
+		if len(a) > len(b) {
+			return -1
+		}
+		if len(a) < len(b) {
+			return 1
+		}
+		return strings.Compare(a, b)
+	})
+	module := candidates[0]
+	if len(candidates) > 1 && len(candidates[0]) == len(candidates[1]) {
+		return "", "", fmt.Errorf("reference %q is ambiguous across module identities %s and %s; use <module>#<policy-path>", reference.Raw, candidates[0], candidates[1])
+	}
+	relative := strings.TrimPrefix(strings.TrimPrefix(reference.Raw, module), "/")
+	return module, relative, nil
+}
+
+func checkCycle(canonical, section string, stack []string) error {
+	key := canonical + "#" + section
+	if len(stack) >= maxExtendsDepth {
+		return fmt.Errorf("policy extends exceeds maximum depth %d at %s", maxExtendsDepth, key)
+	}
+	if slices.Contains(stack, key) {
+		return fmt.Errorf("policy extends cycle at %s through %s", key, strings.Join(stack, " -> "))
+	}
+	return nil
+}
+
+func within(path, root string) bool {
+	if root == "" {
+		return false
+	}
+	relative, err := filepath.Rel(root, path)
+	return err == nil && filepath.IsLocal(relative)
+}
+
+func cloneSettings(settings map[string]map[string]string) map[string]map[string]string {
+	if settings == nil {
+		return nil
+	}
+	result := make(map[string]map[string]string, len(settings))
+	for rule, values := range settings {
+		copyValues := make(map[string]string, len(values))
+		for key, value := range values {
+			copyValues[key] = value
+		}
+		result[rule] = copyValues
+	}
+	return result
+}
diff --git a/internal/policy/resolver_breaking_test.go b/internal/policy/resolver_breaking_test.go
new file mode 100644
index 00000000..39d00263
--- /dev/null
+++ b/internal/policy/resolver_breaking_test.go
@@ -0,0 +1,254 @@
+package policy
+
+import (
+	"context"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+func writeBreakingResolverPolicy(t *testing.T, root, name, body string) string {
+	t.Helper()
+	path := filepath.Join(root, filepath.FromSlash(name))
+	require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+	require.NoError(t, os.WriteFile(path, []byte(body), 0o600))
+	return path
+}
+
+func parseResolverPolicy(t *testing.T, raw string) (v1.Policy, v1.PolicyPresence) {
+	t.Helper()
+	policy, err := v1.ParsePolicy(strings.NewReader(raw))
+	require.NoError(t, err)
+	presence, err := v1.ParsePolicyPresence([]byte(raw))
+	require.NoError(t, err)
+	return policy, presence
+}
+
+func TestResolveBreakingLocalInheritance(t *testing.T) {
+	t.Parallel()
+
+	root := t.TempDir()
+	base := writeBreakingResolverPolicy(t, root, "base.yaml", "version: v1\nbreaking:\n  baseline: git:base\n  categories: [WIRE]\n  ignore_unstable: true\n  ignore: [base]\n")
+	localRaw := "version: v1\nbreaking:\n  extends: ./base.yaml\n  categories: [FILE]\n  ignore_unstable: false\n  ignore: []\n"
+	local := writeBreakingResolverPolicy(t, root, "easyp.yaml", localRaw)
+	policy, presence := parseResolverPolicy(t, localRaw)
+
+	result, err := NewResolver(root, nil).ResolveBreaking(t.Context(), BreakingInput{
+		PolicyPath: local,
+		Policy:     policy,
+		Presence:   presence,
+	})
+
+	require.NoError(t, err)
+	assert.Equal(t, "git:base", result.Policy.Breaking.Baseline)
+	assert.Equal(t, []string{"FILE"}, result.Policy.Breaking.Categories)
+	assert.False(t, result.Policy.Breaking.IgnoreUnstable)
+	assert.Empty(t, result.Policy.Breaking.Ignore)
+	assert.Empty(t, result.Policy.Breaking.Extends)
+	canonicalBase, err := filepath.EvalSymlinks(base)
+	require.NoError(t, err)
+	assert.Equal(t, []string{canonicalBase, local}, result.Chain)
+}
+
+func TestResolveBreakingRemoteReferencesUseConsumerGraph(t *testing.T) {
+	t.Parallel()
+
+	root := t.TempDir()
+	consumer := filepath.Join(root, "consumer")
+	require.NoError(t, os.MkdirAll(consumer, 0o755))
+
+	baseRoot := filepath.Join(root, "remote-base")
+	teamRoot := filepath.Join(root, "remote-team")
+	writeBreakingResolverPolicy(t, baseRoot, "team/breaking.yaml", "version: v1\nbreaking:\n  baseline: git:wrong\n")
+	teamPolicy := writeBreakingResolverPolicy(t, teamRoot, "breaking.yaml", "version: v1\nbreaking:\n  baseline: git:team\n")
+	fragmentPolicy := writeBreakingResolverPolicy(t, baseRoot, "nested/base.yaml", "version: v1\nbreaking:\n  baseline: git:fragment\n")
+
+	graph := modules.PolicyGraph{
+		"example.test/policies":      {Name: "example.test/policies", Directory: baseRoot},
+		"example.test/policies/team": {Name: "example.test/policies/team", Directory: teamRoot},
+	}
+	calls := 0
+	resolver := NewResolver(root, func(_ context.Context, moduleDir string) (modules.PolicyGraph, error) {
+		calls++
+		assert.Equal(t, consumer, moduleDir)
+		return graph, nil
+	})
+
+	tests := []struct {
+		name      string
+		reference string
+		want      string
+		wantPath  string
+	}{
+		{
+			name:      "longest module prefix",
+			reference: "example.test/policies/team/breaking.yaml",
+			want:      "git:team",
+			wantPath:  teamPolicy,
+		},
+		{
+			name:      "explicit fragment",
+			reference: "example.test/policies#nested/base.yaml",
+			want:      "git:fragment",
+			wantPath:  fragmentPolicy,
+		},
+	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			localRaw := "version: v1\nbreaking:\n  extends: " + tt.reference + "\n"
+			local := writeBreakingResolverPolicy(t, root, filepath.Join("consumer", strings.ReplaceAll(tt.name, " ", "-")+".yaml"), localRaw)
+			policy, presence := parseResolverPolicy(t, localRaw)
+
+			result, err := resolver.ResolveBreaking(t.Context(), BreakingInput{
+				PolicyPath: local,
+				Policy:     policy,
+				Presence:   presence,
+				ModuleDir:  consumer,
+			})
+
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, result.Policy.Breaking.Baseline)
+			canonicalBase, err := filepath.EvalSymlinks(tt.wantPath)
+			require.NoError(t, err)
+			assert.Equal(t, canonicalBase, result.Chain[0])
+			assert.Equal(t, local, result.Chain[len(result.Chain)-1])
+		})
+	}
+	assert.Equal(t, 1, calls, "consumer graph should be cached across references")
+}
+
+func TestResolveBreakingRejectsInvalidInheritance(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name  string
+		setup func(t *testing.T, root string) (BreakingInput, GraphProvider)
+		want  string
+	}{
+		{
+			name: "cycle",
+			setup: func(t *testing.T, root string) (BreakingInput, GraphProvider) {
+				aRaw := "version: v1\nbreaking:\n  extends: ./b.yaml\n"
+				a := writeBreakingResolverPolicy(t, root, "a.yaml", aRaw)
+				writeBreakingResolverPolicy(t, root, "b.yaml", "version: v1\nbreaking:\n  extends: ./a.yaml\n")
+				policy, presence := parseResolverPolicy(t, aRaw)
+				return BreakingInput{PolicyPath: a, Policy: policy, Presence: presence}, nil
+			},
+			want: "policy extends cycle",
+		},
+		{
+			name: "base lacks breaking",
+			setup: func(t *testing.T, root string) (BreakingInput, GraphProvider) {
+				raw := "version: v1\nbreaking:\n  extends: ./base.yaml\n"
+				path := writeBreakingResolverPolicy(t, root, "easyp.yaml", raw)
+				writeBreakingResolverPolicy(t, root, "base.yaml", "version: v1\nlinters:\n  default: MINIMAL\n")
+				policy, presence := parseResolverPolicy(t, raw)
+				return BreakingInput{PolicyPath: path, Policy: policy, Presence: presence}, nil
+			},
+			want: "does not define breaking",
+		},
+		{
+			name: "local escape",
+			setup: func(t *testing.T, root string) (BreakingInput, GraphProvider) {
+				workspace := filepath.Join(root, "workspace")
+				require.NoError(t, os.MkdirAll(workspace, 0o755))
+				writeBreakingResolverPolicy(t, root, "outside.yaml", "version: v1\nbreaking:\n  baseline: git:outside\n")
+				raw := "version: v1\nbreaking:\n  extends: ../outside.yaml\n"
+				path := writeBreakingResolverPolicy(t, workspace, "easyp.yaml", raw)
+				policy, presence := parseResolverPolicy(t, raw)
+				return BreakingInput{PolicyPath: path, Policy: policy, Presence: presence}, nil
+			},
+			want: "outside allowed policy root",
+		},
+		{
+			name: "undeclared remote module",
+			setup: func(t *testing.T, root string) (BreakingInput, GraphProvider) {
+				raw := "version: v1\nbreaking:\n  extends: example.test/missing#base.yaml\n"
+				path := writeBreakingResolverPolicy(t, root, "easyp.yaml", raw)
+				policy, presence := parseResolverPolicy(t, raw)
+				provider := func(context.Context, string) (modules.PolicyGraph, error) {
+					return modules.PolicyGraph{}, nil
+				}
+				return BreakingInput{PolicyPath: path, Policy: policy, Presence: presence, ModuleDir: root}, provider
+			},
+			want: "not declared and resolved",
+		},
+		{
+			name: "remote needs module context",
+			setup: func(t *testing.T, root string) (BreakingInput, GraphProvider) {
+				raw := "version: v1\nbreaking:\n  extends: example.test/policies#base.yaml\n"
+				path := writeBreakingResolverPolicy(t, root, "easyp.yaml", raw)
+				policy, presence := parseResolverPolicy(t, raw)
+				return BreakingInput{PolicyPath: path, Policy: policy, Presence: presence}, nil
+			},
+			want: "require the consuming protobuf.mod",
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			root := t.TempDir()
+			input, provider := tt.setup(t, root)
+			workspace := root
+			if tt.name == "local escape" {
+				workspace = filepath.Join(root, "workspace")
+			}
+
+			_, err := NewResolver(workspace, provider).ResolveBreaking(t.Context(), input)
+
+			require.ErrorContains(t, err, tt.want)
+		})
+	}
+}
+
+func TestMatchModuleReference(t *testing.T) {
+	t.Parallel()
+
+	graph := modules.PolicyGraph{
+		"example.test/policies":      {Name: "example.test/policies", Directory: "/base"},
+		"example.test/policies/team": {Name: "example.test/policies/team", Directory: "/team"},
+	}
+
+	tests := []struct {
+		name         string
+		raw          string
+		wantModule   string
+		wantRelative string
+		wantError    string
+	}{
+		{name: "exact", raw: "example.test/policies", wantModule: "example.test/policies"},
+		{name: "longest prefix", raw: "example.test/policies/team/base.yaml", wantModule: "example.test/policies/team", wantRelative: "base.yaml"},
+		{name: "fragment", raw: "example.test/policies#nested/base.yaml", wantModule: "example.test/policies", wantRelative: "nested/base.yaml"},
+		{name: "unmatched", raw: "example.test/other/base.yaml", wantError: "does not match"},
+		{name: "fragment undeclared", raw: "example.test/other#base.yaml", wantError: "not declared and resolved"},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			reference, err := v1.ParsePolicyReference(tt.raw)
+			require.NoError(t, err)
+
+			module, relative, err := matchModuleReference(reference, graph)
+
+			if tt.wantError != "" {
+				require.ErrorContains(t, err, tt.wantError)
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, tt.wantModule, module)
+			assert.Equal(t, tt.wantRelative, relative)
+		})
+	}
+}
diff --git a/internal/policy/resolver_environment_test.go b/internal/policy/resolver_environment_test.go
new file mode 100644
index 00000000..85599976
--- /dev/null
+++ b/internal/policy/resolver_environment_test.go
@@ -0,0 +1,130 @@
+package policy
+
+import (
+	"bytes"
+	"context"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+	"github.com/easyp-tech/easyp/internal/modules"
+)
+
+func TestResolverEnvironmentIsolation(t *testing.T) {
+	const (
+		environmentName = "EASY_SECRET_PROBE"
+		secret          = "consumer-secret-value"
+		moduleName      = "example.test/policies"
+	)
+	t.Setenv(environmentName, secret)
+
+	t.Run("remote module stays literal even inside workspace", func(t *testing.T) {
+		workspace := t.TempDir()
+		dependency := filepath.Join(workspace, ".deps", "policies")
+		base := filepath.Join(dependency, "base.yaml")
+		writeResolverPolicy(t, base, `version: v1
+linters:
+  default: MINIMAL
+linters-settings:
+  SERVICE_SUFFIX:
+    suffix: ${EASY_SECRET_PROBE}
+`)
+		result := resolveLintPolicy(t, workspace, moduleName+"#base.yaml", moduleName, dependency)
+
+		assert.Equal(t, "${EASY_SECRET_PROBE}", result.Policy.LinterSettings["SERVICE_SUFFIX"]["suffix"])
+		assert.NotContains(t, result.Policy.LinterSettings["SERVICE_SUFFIX"]["suffix"], secret)
+	})
+
+	t.Run("consumer local base still expands", func(t *testing.T) {
+		workspace := t.TempDir()
+		writeResolverPolicy(t, filepath.Join(workspace, "base.yaml"), `version: v1
+linters:
+  default: MINIMAL
+linters-settings:
+  SERVICE_SUFFIX:
+    suffix: ${EASY_SECRET_PROBE}
+`)
+		result := resolveLintPolicy(t, workspace, "./base.yaml", "", "")
+
+		assert.Equal(t, secret, result.Policy.LinterSettings["SERVICE_SUFFIX"]["suffix"])
+	})
+
+	t.Run("dependency local chain stays literal", func(t *testing.T) {
+		workspace := t.TempDir()
+		dependency := filepath.Join(workspace, ".deps", "policies")
+		writeResolverPolicy(t, filepath.Join(dependency, "base.yaml"), `version: v1
+linters:
+  extends: ./nested.yaml
+`)
+		writeResolverPolicy(t, filepath.Join(dependency, "nested.yaml"), `version: v1
+linters:
+  default: MINIMAL
+linters-settings:
+  SERVICE_SUFFIX:
+    suffix: ${EASY_SECRET_PROBE}
+`)
+		result := resolveLintPolicy(t, workspace, moduleName+"#base.yaml", moduleName, dependency)
+
+		assert.Equal(t, "${EASY_SECRET_PROBE}", result.Policy.LinterSettings["SERVICE_SUFFIX"]["suffix"])
+	})
+
+	t.Run("invalid remote placeholder never leaks value", func(t *testing.T) {
+		workspace := t.TempDir()
+		dependency := filepath.Join(workspace, ".deps", "policies")
+		writeResolverPolicy(t, filepath.Join(dependency, "base.yaml"), `version: v1
+linters:
+  default: ${EASY_SECRET_PROBE}
+`)
+		_, err := resolveLintPolicyResult(t, workspace, moduleName+"#base.yaml", moduleName, dependency)
+
+		require.Error(t, err)
+		assert.NotContains(t, err.Error(), secret)
+		assert.Contains(t, err.Error(), environmentName)
+	})
+}
+
+func resolveLintPolicy(t *testing.T, workspace, reference, moduleName, dependency string) LintResult {
+	t.Helper()
+	result, err := resolveLintPolicyResult(t, workspace, reference, moduleName, dependency)
+	require.NoError(t, err)
+	return result
+}
+
+func resolveLintPolicyResult(t *testing.T, workspace, reference, moduleName, dependency string) (LintResult, error) {
+	t.Helper()
+	policyPath := filepath.Join(workspace, v1.PolicyFile)
+	raw := []byte("version: v1\nlinters:\n  extends: " + reference + "\n")
+	writeResolverPolicy(t, policyPath, string(raw))
+	parsed, err := v1.ParsePolicy(bytes.NewReader(raw))
+	require.NoError(t, err)
+	presence, err := v1.ParsePolicyPresence(raw)
+	require.NoError(t, err)
+
+	var graph GraphProvider
+	if moduleName != "" {
+		graph = func(context.Context, string) (modules.PolicyGraph, error) {
+			return modules.PolicyGraph{
+				moduleName: {Name: moduleName, Directory: dependency},
+			}, nil
+		}
+	}
+	resolver := NewResolver(workspace, graph)
+	return resolver.ResolveLint(t.Context(), LintInput{
+		PolicyPath:     policyPath,
+		Policy:         parsed,
+		Presence:       presence,
+		Settings:       parsed.LinterSettings,
+		SettingsSource: presence,
+		ModuleDir:      workspace,
+	})
+}
+
+func writeResolverPolicy(t *testing.T, path, body string) {
+	t.Helper()
+	require.NoError(t, os.MkdirAll(filepath.Dir(path), 0o755))
+	require.NoError(t, os.WriteFile(path, []byte(body), 0o644))
+}
diff --git a/internal/rules/builder.go b/internal/rules/builder.go
index 66dc9a38..ef1714cf 100644
--- a/internal/rules/builder.go
+++ b/internal/rules/builder.go
@@ -48,24 +48,27 @@ func AllRuleNames() []string {
 // group keys, grouped rule names, and uncategorized rule names.
 func AllLintUseValues() []string {
 	groups := AllGroups()
-	values := make([]string, 0, len(groups)+len(AllRuleNames())+1)
+	values := make([]string, 0, len(groups)+len(AllRuleNames()))
 	for _, group := range groups {
 		values = append(values, group.Key)
 	}
 	values = append(values, AllRuleNames()...)
-	values = append(values, core.GetRuleName(&PackageNoImportCycle{}))
 
-	return lo.FindUniques(values)
+	return lo.Uniq(values)
 }
 
 // New returns a map of rules and a map of ignore only rules by configuration.
 func New(cfg config.LintConfig) ([]core.Rule, map[string][]string, error) {
+	if err := validateConfigRuleNames(cfg); err != nil {
+		return nil, nil, fmt.Errorf("validateConfigRuleNames: %w", err)
+	}
 	allRules := []core.Rule{
 		//	minGroup
 		&DirectorySamePackage{},
 		&PackageDefined{},
 		&PackageDirectoryMatch{
-			Root: ".", // TODO: fix me
+			Root:   ".",
+			Prefix: cfg.PackageDirectoryPrefix,
 		},
 		&PackageSameDirectory{},
 
@@ -114,8 +117,6 @@ func New(cfg config.LintConfig) ([]core.Rule, map[string][]string, error) {
 		//	unaryRPCGroup
 		&RPCNoClientStreaming{},
 		&RPCNoServerStreaming{},
-		//	UNCATEGORIZED
-		&PackageNoImportCycle{},
 	}
 
 	rules := make(map[string]core.Rule)
@@ -199,7 +200,7 @@ func unwrapLintGroups(use []string) []string {
 		}
 	}
 
-	return lo.FindUniques(res)
+	return lo.Uniq(res)
 }
 
 func removeExcept(except, use []string) []string {
diff --git a/internal/rules/builder_test.go b/internal/rules/builder_test.go
index 42048f20..03a5e536 100644
--- a/internal/rules/builder_test.go
+++ b/internal/rules/builder_test.go
@@ -66,7 +66,7 @@ func TestAllLintUseValues(t *testing.T) {
 	for _, ruleName := range rules.AllRuleNames() {
 		require.Contains(t, values, ruleName)
 	}
-	require.Contains(t, values, "PACKAGE_NO_IMPORT_CYCLE")
+	require.NotContains(t, values, "PACKAGE_NO_IMPORT_CYCLE")
 	require.Equal(t, len(values), len(uniqueStrings(values)))
 }
 
diff --git a/internal/rules/check_lint_ignore_test.go b/internal/rules/check_lint_ignore_test.go
index a464711c..b5112564 100644
--- a/internal/rules/check_lint_ignore_test.go
+++ b/internal/rules/check_lint_ignore_test.go
@@ -10,7 +10,7 @@ import (
 	"github.com/easyp-tech/easyp/internal/rules"
 )
 
-func TestCheckNoLint(t *testing.T) {
+func TestRuleDiagnosticsAreFilteredByTheEngine(t *testing.T) {
 	t.Parallel()
 
 	tests := map[string]struct {
@@ -37,7 +37,7 @@ func TestCheckNoLint(t *testing.T) {
 			rule := rules.MessagePascalCase{}
 			issues, err := rule.Validate(protos[tc.fileName])
 			r.NoError(err)
-			r.Empty(issues)
+			r.NotEmpty(issues)
 		})
 	}
 }
diff --git a/internal/rules/package_directory_match.go b/internal/rules/package_directory_match.go
index 942b6e7d..7c8990f3 100644
--- a/internal/rules/package_directory_match.go
+++ b/internal/rules/package_directory_match.go
@@ -1,6 +1,7 @@
 package rules
 
 import (
+	"fmt"
 	"path/filepath"
 	"strings"
 
@@ -11,7 +12,8 @@ var _ core.Rule = (*PackageDirectoryMatch)(nil)
 
 // PackageDirectoryMatch is a rule for checking consistency of directory and package names.
 type PackageDirectoryMatch struct {
-	Root string `json:"root" yaml:"root" env:"PACKAGE_DIRECTORY_MATCH_ROOT"`
+	Root   string `json:"root" yaml:"root" env:"PACKAGE_DIRECTORY_MATCH_ROOT"`
+	Prefix string `json:"-" yaml:"-"`
 }
 
 // Message implements lint.Rule.
@@ -23,13 +25,30 @@ func (d *PackageDirectoryMatch) Message() string {
 func (d *PackageDirectoryMatch) Validate(protoInfo core.ProtoInfo) ([]core.Issue, error) {
 	var res []core.Issue
 
-	preparePath := filepath.Dir(strings.TrimPrefix(protoInfo.Path, d.Root))
-	preparePath = filepath.ToSlash(preparePath)
+	name := strings.TrimPrefix(protoInfo.Path, d.Root)
+	if protoInfo.ImportPath != "" {
+		name = protoInfo.ImportPath
+	}
+	preparePath := filepath.ToSlash(filepath.Dir(name))
 	expectedPackage := strings.ReplaceAll(preparePath, "/", ".")
+	qualifiedPackage := expectedPackage
+	if d.Prefix != "" && expectedPackage != "." && expectedPackage != d.Prefix && !strings.HasPrefix(expectedPackage, d.Prefix+".") {
+		qualifiedPackage = d.Prefix + "." + expectedPackage
+	}
 
 	for _, pkgInfo := range protoInfo.Info.ProtoBody.Packages {
-		if pkgInfo.Name != expectedPackage {
-			res = core.AppendIssue(res, d, pkgInfo.Meta.Pos, protoInfo.Path, pkgInfo.Comments)
+		if pkgInfo.Name == expectedPackage || pkgInfo.Name == qualifiedPackage {
+			continue
+		}
+		sourceName := protoInfo.Path
+		if protoInfo.ImportPath != "" {
+			sourceName = protoInfo.ImportPath
+		}
+		res = core.AppendIssue(res, d, pkgInfo.Meta.Pos, sourceName, pkgInfo.Comments)
+		if qualifiedPackage != expectedPackage {
+			res[len(res)-1].Message = fmt.Sprintf("package %q does not match module-relative directory %q; expected %q or module-qualified %q", pkgInfo.Name, preparePath, expectedPackage, qualifiedPackage)
+		} else {
+			res[len(res)-1].Message = fmt.Sprintf("package %q does not match module-relative directory %q; expected %q", pkgInfo.Name, preparePath, expectedPackage)
 		}
 	}
 
diff --git a/internal/rules/package_directory_match_test.go b/internal/rules/package_directory_match_test.go
index b3a60a10..8a714a3c 100644
--- a/internal/rules/package_directory_match_test.go
+++ b/internal/rules/package_directory_match_test.go
@@ -41,7 +41,7 @@ func TestPackageDirectoryMatch_Validate(t *testing.T) {
 					Column:   1,
 				},
 				SourceName: "./../../testdata/auth/service.proto",
-				Message:    "package does not match directory path",
+				Message:    "package \"Session\" does not match module-relative directory \"auth\"; expected \"auth\"",
 				RuleName:   "PACKAGE_DIRECTORY_MATCH",
 			},
 			wantErr: nil,
@@ -73,3 +73,28 @@ func TestPackageDirectoryMatch_Validate(t *testing.T) {
 		})
 	}
 }
+
+func TestPackageDirectoryMatch_ModuleQualifiedPackage(t *testing.T) {
+	t.Parallel()
+
+	r, protos := start(t)
+	info := protos[validAuthProto]
+	info.ImportPath = "v1/service.proto"
+	rule := rules.PackageDirectoryMatch{Root: ".", Prefix: "user"}
+
+	info.Info.ProtoBody.Packages[0].Name = "user.v1"
+	issues, err := rule.Validate(info)
+	r.NoError(err)
+	r.Empty(issues)
+
+	info.Info.ProtoBody.Packages[0].Name = "v1"
+	issues, err = rule.Validate(info)
+	r.NoError(err)
+	r.Empty(issues)
+
+	info.Info.ProtoBody.Packages[0].Name = "other.v1"
+	issues, err = rule.Validate(info)
+	r.NoError(err)
+	r.Len(issues, 1)
+	r.Contains(issues[0].Message, `expected "v1" or module-qualified "user.v1"`)
+}
diff --git a/internal/rules/package_no_import_cycle.go b/internal/rules/package_no_import_cycle.go
deleted file mode 100644
index 00f23bdc..00000000
--- a/internal/rules/package_no_import_cycle.go
+++ /dev/null
@@ -1,31 +0,0 @@
-package rules
-
-import (
-	"github.com/easyp-tech/easyp/internal/core"
-)
-
-var _ core.Rule = (*PackageNoImportCycle)(nil)
-
-// PackageNoImportCycle this is an extra uncategorized rule that detects package import cycles.
-// The Protobuf compiler outlaws circular file imports, but it's still possible to introduce package cycles, such as these:
-type PackageNoImportCycle struct {
-	// cache is a map of package name to a slice of package names that it imports
-	cache map[string][]string
-}
-
-func (p *PackageNoImportCycle) lazyInit() {
-	if p.cache == nil {
-		p.cache = make(map[string][]string)
-	}
-}
-
-// Message implements lint.Rule.
-func (p *PackageNoImportCycle) Message() string {
-	return "package should not have import cycles"
-}
-
-// Validate implements lint.Rule.
-func (p *PackageNoImportCycle) Validate(protoInfo core.ProtoInfo) ([]core.Issue, error) {
-	p.lazyInit()
-	panic("implement me")
-}
diff --git a/internal/rules/protovalidate.go b/internal/rules/protovalidate.go
deleted file mode 100644
index 6725dfd1..00000000
--- a/internal/rules/protovalidate.go
+++ /dev/null
@@ -1,79 +0,0 @@
-package rules
-
-import (
-	"github.com/easyp-tech/easyp/internal/core"
-)
-
-var _ core.Rule = (*ProtoValidate)(nil)
-
-// ProtoValidate this rule requires that all protovalidate constraints specified are valid.
-type ProtoValidate struct{}
-
-//This rule requires that all protovalidate constraints specified are valid.
-//
-//For a buf.validate.field to be valid, it must ensure:
-//
-//skipped is the only field if set.
-//At most one of required and ignore_empty are set.
-//required isn't set if the field belongs to a oneof.
-//Neither required nor ignore_empty is set if the field is an extension.
-//Its CEL constraints are valid.
-//Its type specific rules, such as (buf.validate.field).int32, are valid.
-//For a buf.validate.message to be valid, it must ensure:
-//
-//disabled is the only field if set.
-//Its CEL constraints are valid.
-//For a set of CEL constraints on a message or field to be valid, each constraint must:
-//
-//Have a CEL expression that compiles successfully and evaluates to a string or boolean. These are the only two types that the protovalidate runtime allows, and it's a runtime error for a CEL expression to evaluate to another type.
-//Have a non-empty message if the CEL expression evaluates to a boolean value. This message is used by the protovalidate runtime report validation failure.
-//Have an empty message if the CEL expression evaluates to a string value. The validation failure message in this case is the value this CEL expression evaluates to, while message won't be used in any way.
-//Have a non-empty id, consisting of only alphanumeric characters, _, - and .. The id must be unique within the buf.validate.message or buf.validate.field it's specified on. A unique id is useful for debugging and locating the CEL constraint that fails, and can be used as a key for i18n.
-//For a set of rules specified on a field, such as (buf.validate.field).int32, to be valid, it must additionally:
-//
-//Have a type compatible with the type it validates: (buf.validate.field).int32 rules can only be set on a field of type int32 or google.protobuf.Int32Value. A type mismatch causes a runtime error.
-//Permit some value: setting contains: "foo" and not_contains: "foo" isn't valid because it rejects all values.
-//Have no obviously redundant rules. For example, it's redundant to set lt: 5 and const: 3.
-//Numeric rules, timestamp rules and duration rules
-//The field to validate must match the rules type or its corresponding wrapper type (if any).
-//If a lower bound (gt or gte) and an upper bound(lt or lte) are both specified, they must not be equal. If they are both inclusive (gte and lte), they must be replaced by const. Otherwise, all values are invalid.
-//Durations and timestamps defined in options, such as (buf.validate.field).timestamp.lt, must be valid.
-//If the rule is timestamp:
-//within must be a positive duration.
-//lt_now and gt_now must not both be specified.
-//String rules
-//The field to validate must be string or google.protobuf.StringValue.
-//If len is specified, min_len or max_len must not be specified. If both are specified, min_len must be lower than max_len.
-//If len_bytes is specified, min_bytes or max_bytes must not be specified. If both are specified, min_bytes must be lower than max_bytes.
-//If min_len and max_bytes are both defined, min_len must be less than or equal to max_bytes. It's impossible for a string to have 3 or more UTF-8 characters while having less than 2 bytes.
-//If min_bytes and max_len are both defined, min_bytes must be less than or equal to 4 times max_len. It's impossible for a string to have 2 or less UTF-8 characters while having 9 or more bytes, since each UTF-8 character takes at most 4 bytes.
-//If prefix, suffix, or contains is specified, its length must not exceed max_len and max_bytes. Otherwise, all values are invalid.
-//Any value of prefix, suffix and contains must not contain, or be a substring of not_contains, if they're both specified.
-//If strict is set to false, well_known_regex must also be specified.
-//If pattern is specified, is must be a valid regular expression in RE2 syntax.
-//Bytes rules
-//The field to validate must be bytes or google.protobuf.BytesValue.
-//If len is specified, min_len or max_len must not be specified. If both are specified, min_len must be lower than max_len.
-//If any of prefix, suffix and contains is specified, its length must not exceed max_len. Otherwise, all values are invalid.
-//If pattern is specified, is must be a valid regular expression in RE2 syntax.
-//Map rules
-//The field to validate must be a map.
-//min_pairs must not be higher than max_pairs.
-//The set of rules in keys must be valid and compatible with the map field's key type.
-//The set of rules in values must be valid and compatible with the map field's value type.
-//Repeated rules
-//The field to validate must have label repeated.
-//min_items must not be higher than max_items.
-//The set of rules in items must be compatible with the field's type.
-//If unique is set to true, the field must be a scalar or a wrapper type.
-
-// Validate checks that all protovalidate constraints specified are valid.
-func (p *ProtoValidate) Validate(protoInfo core.ProtoInfo) ([]core.Issue, error) {
-	//TODO implement me
-	panic("implement me")
-}
-
-// Message implements lint.Rule.
-func (p *ProtoValidate) Message() string {
-	panic("implement me")
-}
diff --git a/internal/rules/selection.go b/internal/rules/selection.go
new file mode 100644
index 00000000..c8200579
--- /dev/null
+++ b/internal/rules/selection.go
@@ -0,0 +1,52 @@
+package rules
+
+import (
+	"errors"
+	"fmt"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	"github.com/easyp-tech/easyp/internal/core"
+	"slices"
+)
+
+// ValidateNames checks every rule/group, including names that will be disabled.
+// The executable registry is also the source for schemas and completion values.
+func ValidateNames(names []string) error {
+	allowed := AllLintUseValues()
+	var issues []error
+	for _, name := range names {
+		if name == "PACKAGE_NO_IMPORT_CYCLE" {
+			issues = append(issues, fmt.Errorf("%w: %s is not implemented", core.ErrInvalidRule, name))
+			continue
+		}
+		if !slices.Contains(allowed, name) {
+			issues = append(issues, fmt.Errorf("%w: %s", core.ErrInvalidRule, name))
+		}
+	}
+	return errors.Join(issues...)
+}
+
+func validateConfigRuleNames(cfg config.LintConfig) error {
+	var issues []error
+	for _, selection := range []struct {
+		path  string
+		names []string
+	}{
+		{path: "use", names: cfg.Use}, {path: "except", names: cfg.Except},
+	} {
+		err := ValidateNames(selection.names)
+		if err != nil {
+			issues = append(issues, fmt.Errorf("%s: %w", selection.path, err))
+		}
+	}
+	keys := make([]string, 0, len(cfg.IgnoreOnly))
+	for name := range cfg.IgnoreOnly {
+		keys = append(keys, name)
+	}
+	slices.Sort(keys)
+	err := ValidateNames(keys)
+	if err != nil {
+		issues = append(issues, fmt.Errorf("ignore_only: %w", err))
+	}
+	return errors.Join(issues...)
+}
diff --git a/internal/rules/selection_test.go b/internal/rules/selection_test.go
new file mode 100644
index 00000000..5f6e0631
--- /dev/null
+++ b/internal/rules/selection_test.go
@@ -0,0 +1,65 @@
+package rules_test
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/easyp-tech/easyp/internal/config"
+	"github.com/easyp-tech/easyp/internal/core"
+	"github.com/easyp-tech/easyp/internal/rules"
+)
+
+func TestRepeatedLintSelectionIsIdempotent(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name           string
+		base, repeated config.LintConfig
+	}{
+		{name: "enable preset member", base: config.LintConfig{Use: []string{"DEFAULT"}}, repeated: config.LintConfig{Use: []string{"DEFAULT", "ENUM_VALUE_PREFIX"}}},
+		{name: "duplicate rule", base: config.LintConfig{Use: []string{"ENUM_VALUE_PREFIX"}}, repeated: config.LintConfig{Use: []string{"ENUM_VALUE_PREFIX", "ENUM_VALUE_PREFIX"}}},
+		{name: "duplicate group", base: config.LintConfig{Use: []string{"DEFAULT"}}, repeated: config.LintConfig{Use: []string{"DEFAULT", "DEFAULT"}}},
+		{name: "duplicate disable", base: config.LintConfig{Use: []string{"DEFAULT"}, Except: []string{"ENUM_VALUE_PREFIX"}}, repeated: config.LintConfig{Use: []string{"DEFAULT"}, Except: []string{"ENUM_VALUE_PREFIX", "ENUM_VALUE_PREFIX"}}},
+		{name: "disable group and member", base: config.LintConfig{Use: []string{"DEFAULT", "BASIC"}, Except: []string{"DEFAULT"}}, repeated: config.LintConfig{Use: []string{"DEFAULT", "BASIC"}, Except: []string{"DEFAULT", "ENUM_VALUE_PREFIX"}}},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			names := func(cfg config.LintConfig) []string {
+				selected, _, err := rules.New(cfg)
+				require.NoError(t, err)
+				result := make([]string, 0, len(selected))
+				for _, rule := range selected {
+					result = append(result, core.GetRuleName(rule))
+				}
+				return result
+			}
+			assert.Equal(t, names(tt.base), names(tt.repeated))
+		})
+	}
+}
+
+func TestInvalidLintNamesAreRejectedBeforeFiltering(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name string
+		cfg  config.LintConfig
+		want string
+	}{
+		{name: "unknown enabled", cfg: config.LintConfig{Use: []string{"NO_SUCH_RULE"}}, want: "NO_SUCH_RULE"},
+		{name: "unknown disabled", cfg: config.LintConfig{Except: []string{"NO_SUCH_RULE"}}, want: "NO_SUCH_RULE"},
+		{name: "unknown cannot cancel itself", cfg: config.LintConfig{Use: []string{"NO_SUCH_RULE"}, Except: []string{"NO_SUCH_RULE"}}, want: "NO_SUCH_RULE"},
+		{name: "unknown exclusion", cfg: config.LintConfig{IgnoreOnly: map[string][]string{"NO_SUCH_RULE": {"generated"}}}, want: "NO_SUCH_RULE"},
+		{name: "unimplemented enabled", cfg: config.LintConfig{Use: []string{"PACKAGE_NO_IMPORT_CYCLE"}}, want: "not implemented"},
+		{name: "unimplemented disabled", cfg: config.LintConfig{Except: []string{"PACKAGE_NO_IMPORT_CYCLE"}}, want: "not implemented"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			_, _, err := rules.New(tt.cfg)
+			require.ErrorIs(t, err, core.ErrInvalidRule)
+			assert.Contains(t, err.Error(), tt.want)
+		})
+	}
+}
diff --git a/internal/schemagen/schemagen.go b/internal/schemagen/schemagen.go
index b8ed076e..4b317f93 100644
--- a/internal/schemagen/schemagen.go
+++ b/internal/schemagen/schemagen.go
@@ -1,3 +1,4 @@
+// Package schemagen writes the JSON Schemas used by v1 configuration validation.
 package schemagen
 
 import (
@@ -5,56 +6,40 @@ import (
 	"os"
 	"path/filepath"
 
-	"github.com/easyp-tech/easyp/mcp/easypconfig"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
 )
 
-const (
-	DefaultVersionedOut = "schemas/easyp-config-v1.schema.json"
-	DefaultLatestOut    = "schemas/easyp-config.schema.json"
-)
+const DefaultOutDir = "schemas"
 
+// Options controls where v1 schema artifacts are written.
 type Options struct {
-	VersionedOut string
-	LatestOut    string
+	OutDir string
 }
 
+// Run creates versioned schemas and latest aliases for the three YAML files.
 func Run(opts Options) error {
-	versionedOut := opts.VersionedOut
-	if versionedOut == "" {
-		versionedOut = DefaultVersionedOut
-	}
-
-	latestOut := opts.LatestOut
-	if latestOut == "" {
-		latestOut = DefaultLatestOut
-	}
-
-	data, err := easypconfig.MarshalConfigJSONSchema()
-	if err != nil {
-		return fmt.Errorf("marshal schema: %w", err)
+	dir := opts.OutDir
+	if dir == "" {
+		dir = DefaultOutDir
 	}
-	data = append(data, '\n')
-
-	if err := writeFile(versionedOut, data); err != nil {
-		return fmt.Errorf("write versioned schema: %w", err)
+	if err := os.MkdirAll(dir, 0o755); err != nil {
+		return fmt.Errorf("MkdirAll: %w", err)
 	}
-
-	if err := writeFile(latestOut, data); err != nil {
-		return fmt.Errorf("write latest schema: %w", err)
+	for _, name := range []string{"easyp", "easyp.gen", "protobuf.lock"} {
+		data, err := v1.SchemaJSON(name)
+		if err != nil {
+			return fmt.Errorf("SchemaJSON: %w", err)
+		}
+		versioned, latest := schemaNames(name)
+		for _, filename := range []string{versioned, latest} {
+			if err := os.WriteFile(filepath.Join(dir, filename), data, 0o644); err != nil {
+				return fmt.Errorf("WriteFile: %w", err)
+			}
+		}
 	}
-
 	return nil
 }
 
-func writeFile(path string, data []byte) error {
-	dir := filepath.Dir(path)
-	if err := os.MkdirAll(dir, 0o755); err != nil {
-		return fmt.Errorf("mkdir %s: %w", dir, err)
-	}
-
-	if err := os.WriteFile(path, data, 0o644); err != nil {
-		return fmt.Errorf("os.WriteFile %s: %w", path, err)
-	}
-
-	return nil
+func schemaNames(name string) (string, string) {
+	return name + "-v1.schema.json", name + ".schema.json"
 }
diff --git a/internal/schemagen/schemagen_test.go b/internal/schemagen/schemagen_test.go
index 4dcd5604..8eabd068 100644
--- a/internal/schemagen/schemagen_test.go
+++ b/internal/schemagen/schemagen_test.go
@@ -2,41 +2,83 @@ package schemagen
 
 import (
 	"bytes"
+	"encoding/json"
 	"os"
 	"path/filepath"
 	"testing"
+
+	yamlvalidator "github.com/Yakwilik/go-yamlvalidator"
+	"github.com/stretchr/testify/require"
 )
 
-func TestRun(t *testing.T) {
+func TestRunWritesSeparateV1SchemasAndAliases(t *testing.T) {
 	t.Parallel()
+	dir := t.TempDir()
+	require.NoError(t, Run(Options{OutDir: dir}))
+	for _, tc := range []struct {
+		name       string
+		wantField  string
+		legacyName string
+	}{
+		{name: "easyp", wantField: "breaking", legacyName: "breaking_check"},
+		{name: "easyp.gen", wantField: "plugins", legacyName: "inputs"},
+		{name: "protobuf.lock", wantField: "modules", legacyName: "direct"},
+	} {
+		t.Run(tc.name, func(t *testing.T) {
+			t.Parallel()
+			versioned, latest := schemaNames(tc.name)
+			versionedRaw, err := os.ReadFile(filepath.Join(dir, versioned))
+			require.NoError(t, err)
+			latestRaw, err := os.ReadFile(filepath.Join(dir, latest))
+			require.NoError(t, err)
+			require.True(t, bytes.Equal(versionedRaw, latestRaw))
+			var document struct {
+				Schema     string                     `json:"$schema"`
+				Properties map[string]json.RawMessage `json:"properties"`
+			}
+			require.NoError(t, json.Unmarshal(versionedRaw, &document))
+			require.Equal(t, "https://json-schema.org/draft/2020-12/schema", document.Schema)
+			require.Contains(t, document.Properties, tc.wantField)
+			require.NotContains(t, document.Properties, tc.legacyName)
+		})
+	}
+}
 
-	tmp := t.TempDir()
-	versionedPath := filepath.Join(tmp, "nested", "easyp-config-v1.schema.json")
-	latestPath := filepath.Join(tmp, "nested", "easyp-config.schema.json")
+func TestGeneratedSchemasValidateConfigRules(t *testing.T) {
+	t.Parallel()
 
-	err := Run(Options{
-		VersionedOut: versionedPath,
-		LatestOut:    latestPath,
-	})
-	if err != nil {
-		t.Fatalf("Run() error = %v", err)
+	tests := []struct {
+		name     string
+		schema   string
+		contents string
+		valid    bool
+	}{
+		{name: "policy settings", schema: "easyp", contents: "linters-settings:\n  UNKNOWN:\n    suffix: BAD\n"},
+		{name: "plugin without identity", schema: "easyp.gen", contents: "plugins:\n  - out: gen\n"},
+		{name: "plugin with two identities", schema: "easyp.gen", contents: "plugins:\n  - name: go\n    remote: example.com/go:v1.0.0\n    out: gen\n"},
+		{name: "managed disable with selector", schema: "easyp.gen", contents: "generate:\n  managed:\n    disable:\n      - module: example.com/repo\n", valid: true},
+		{name: "managed disable without selector", schema: "easyp.gen", contents: "generate:\n  managed:\n    disable:\n      - {}\n"},
+		{name: "managed disable with conflicting options", schema: "easyp.gen", contents: "generate:\n  managed:\n    disable:\n      - file_option: go_package\n        field_option: json_name\n"},
+		{name: "managed override without value", schema: "easyp.gen", contents: "generate:\n  managed:\n    override:\n      - file_option: go_package_prefix\n"},
+		{name: "valid generator", schema: "easyp.gen", contents: "plugins:\n  - name: go\n    out: gen\n", valid: true},
 	}
 
-	versionedData, err := os.ReadFile(versionedPath)
-	if err != nil {
-		t.Fatalf("os.ReadFile(versionedPath) error = %v", err)
-	}
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
 
-	latestData, err := os.ReadFile(latestPath)
-	if err != nil {
-		t.Fatalf("os.ReadFile(latestPath) error = %v", err)
-	}
+			versioned, _ := schemaNames(tt.schema)
+			dir := t.TempDir()
+			require.NoError(t, Run(Options{OutDir: dir}))
+			rawSchema, err := os.ReadFile(filepath.Join(dir, versioned))
+			require.NoError(t, err)
+			compiled, err := yamlvalidator.CompileJSONSchema(rawSchema)
+			require.NoError(t, err)
 
-	if !bytes.Equal(versionedData, latestData) {
-		t.Fatalf("schema files differ")
-	}
+			issues := yamlvalidator.NewValidator(compiled).ValidateBytes([]byte(tt.contents))
 
-	if len(versionedData) == 0 {
-		t.Fatalf("schema file is empty")
+			require.Equal(t, tt.valid, !issues.HasErrors(), issues.FormatAll(false))
+		})
 	}
 }
diff --git a/internal/version/version.go b/internal/version/version.go
index d319be35..e26fb8c3 100644
--- a/internal/version/version.go
+++ b/internal/version/version.go
@@ -26,11 +26,13 @@ type buildMetadata struct {
 }
 
 var (
-	metadata     buildMetadata
-	metadataOnce sync.Once
+	// releaseVersion is set by release builds using the Go linker's -X flag.
+	releaseVersion string
+	metadata       buildMetadata
+	metadataOnce   sync.Once
 )
 
-// System returns application version based on build info embedded into binary.
+// System returns the release version, falling back to embedded build info.
 func System() string {
 	return getBuildMetadata().easypVersion
 }
@@ -50,10 +52,16 @@ func getBuildMetadata() buildMetadata {
 func readBuildMetadata() buildMetadata {
 	bi, ok := debug.ReadBuildInfo()
 	if !ok {
-		return buildMetadataFromVersions(develVersion, unknownVersion)
+		bi = nil
 	}
+	return buildMetadataFromBuildInfo(bi, releaseVersion)
+}
 
-	easypVersion := easypVersionFromBuildInfo(bi)
+func buildMetadataFromBuildInfo(bi *debug.BuildInfo, release string) buildMetadata {
+	easypVersion := release
+	if easypVersion == "" {
+		easypVersion = easypVersionFromBuildInfo(bi)
+	}
 	protocompileVersion := dependencyVersion(bi, protocompileModulePath)
 
 	return buildMetadataFromVersions(easypVersion, protocompileVersion)
diff --git a/internal/version/version_test.go b/internal/version/version_test.go
index 56c3ff41..cd882a12 100644
--- a/internal/version/version_test.go
+++ b/internal/version/version_test.go
@@ -3,8 +3,104 @@ package version
 import (
 	"runtime/debug"
 	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
 )
 
+func TestBuildMetadataFromBuildInfoReleaseVersion(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name           string
+		release        string
+		mainVersion    string
+		revision       string
+		modified       bool
+		dependency     string
+		missingInfo    bool
+		wantVersion    string
+		wantDependency string
+		wantSuffix     string
+	}{
+		{
+			name: "stable release overrides local VCS", release: "v1.0.0", mainVersion: develMainVersion,
+			revision: "abcdef1234567890", modified: true, dependency: "v0.14.1",
+			wantVersion: "v1.0.0", wantDependency: "v0.14.1", wantSuffix: "v1.0.0-bufbuild-protocompile-easyp",
+		},
+		{
+			name: "nightly release overrides main module", release: "v1.0.0-nightly.20261005", mainVersion: "v0.17.1",
+			revision: "abcdef1234567890", modified: true, dependency: "v0.14.1",
+			wantVersion: "v1.0.0-nightly.20261005", wantDependency: "v0.14.1", wantSuffix: "v1.0.0-bufbuild-protocompile-easyp-nightly.20261005",
+		},
+		{
+			name: "stable release without build info", release: "v1.0.0", missingInfo: true,
+			wantVersion: "v1.0.0", wantDependency: unknownVersion, wantSuffix: "v1.0.0-bufbuild-protocompile-easyp",
+		},
+		{
+			name: "nightly release without build info", release: "v1.0.0-nightly.20261005", missingInfo: true,
+			wantVersion: "v1.0.0-nightly.20261005", wantDependency: unknownVersion, wantSuffix: "v1.0.0-bufbuild-protocompile-easyp-nightly.20261005",
+		},
+		{
+			name: "empty override preserves go install version", mainVersion: "v1.2.3", dependency: "v0.14.1-rc1",
+			wantVersion: "v1.2.3", wantDependency: "v0.14.1-rc1", wantSuffix: "v1.2.3-bufbuild-protocompile-rc1-easyp",
+		},
+		{
+			name: "empty override preserves VCS revision", mainVersion: develMainVersion, revision: "abcdef1234567890", dependency: "v0.14.1",
+			wantVersion: "abcdef1", wantDependency: "v0.14.1", wantSuffix: "abcdef1-bufbuild-protocompile-easyp",
+		},
+		{
+			name: "empty override preserves modified VCS revision", mainVersion: develMainVersion, revision: "abcdef1234567890", modified: true, dependency: "v0.14.1",
+			wantVersion: "abcdef1-modified", wantDependency: "v0.14.1", wantSuffix: "abcdef1-bufbuild-protocompile-easyp-modified",
+		},
+		{
+			name: "empty override preserves main dirty marker normalization", mainVersion: "v1.2.3+dirty", dependency: "v0.14.1",
+			wantVersion: "v1.2.3+modified", wantDependency: "v0.14.1", wantSuffix: "v1.2.3-bufbuild-protocompile-easyp-modified",
+		},
+		{
+			name: "empty override without build info", missingInfo: true,
+			wantVersion: develVersion, wantDependency: unknownVersion, wantSuffix: "devel-bufbuild-protocompile-easyp",
+		},
+		{
+			name:        "empty override without module or VCS metadata",
+			wantVersion: develVersion, wantDependency: unknownVersion, wantSuffix: "devel-bufbuild-protocompile-easyp",
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			var info *debug.BuildInfo
+			if !tt.missingInfo {
+				info = &debug.BuildInfo{Main: debug.Module{Version: tt.mainVersion}}
+				if tt.revision != "" {
+					info.Settings = append(info.Settings, debug.BuildSetting{Key: "vcs.revision", Value: tt.revision})
+				}
+				if tt.modified {
+					info.Settings = append(info.Settings, debug.BuildSetting{Key: "vcs.modified", Value: "true"})
+				}
+				if tt.dependency != "" {
+					info.Deps = []*debug.Module{{Path: protocompileModulePath, Version: tt.dependency}}
+				}
+			}
+
+			metadata := buildMetadataFromBuildInfo(info, tt.release)
+
+			assert.Equal(t, tt.wantVersion, metadata.easypVersion)
+			assert.Equal(t, tt.wantDependency, metadata.protocompileVersion)
+			require.NotNil(t, metadata.compilerVersion)
+			assert.Equal(t, tt.wantSuffix, metadata.compilerVersion.GetSuffix())
+			if tt.dependency != "" {
+				assert.Equal(t, int32(14), metadata.compilerVersion.GetMinor())
+				assert.Equal(t, int32(1), metadata.compilerVersion.GetPatch())
+			} else {
+				assert.Zero(t, metadata.compilerVersion.GetMinor())
+				assert.Zero(t, metadata.compilerVersion.GetPatch())
+			}
+		})
+	}
+}
+
 func TestEasypVersionFromBuildInfo(t *testing.T) {
 	t.Parallel()
 
diff --git a/internal/workspace/discovery.go b/internal/workspace/discovery.go
new file mode 100644
index 00000000..ed1311f6
--- /dev/null
+++ b/internal/workspace/discovery.go
@@ -0,0 +1,141 @@
+// Package workspace finds command context without crossing repository boundaries.
+package workspace
+
+import (
+	"fmt"
+	"io/fs"
+	"os"
+	"path/filepath"
+	"strings"
+)
+
+// Boundary finds the nearest Git repository, or the outermost EasyP ancestor
+// below the home directory when working in a source tree without Git metadata.
+func Boundary(start string) (string, error) {
+	start, err := filepath.Abs(start)
+	if err != nil {
+		return "", fmt.Errorf("Abs: %w", err)
+	}
+	root := start
+	home, _ := os.UserHomeDir()
+	for dir := start; ; dir = filepath.Dir(dir) {
+		if dir != start && dir == home {
+			break
+		}
+		if _, err := os.Lstat(filepath.Join(dir, ".git")); err == nil {
+			return dir, nil
+		} else if !os.IsNotExist(err) {
+			return "", fmt.Errorf("Lstat: %w", err)
+		}
+		for _, name := range []string{"protobuf.mod", "easyp.yaml", "easyp.gen.yaml"} {
+			if _, err := os.Stat(filepath.Join(dir, name)); err == nil {
+				root = dir
+			} else if !os.IsNotExist(err) {
+				return "", fmt.Errorf("Stat: %w", err)
+			}
+		}
+		if dir == filepath.Dir(dir) {
+			break
+		}
+	}
+	return root, nil
+}
+
+// FindUp returns the nearest named regular file within boundary, or an empty path.
+func FindUp(start, boundary, name string) (string, error) {
+	for dir := filepath.Clean(start); ; dir = filepath.Dir(dir) {
+		rel, err := filepath.Rel(boundary, dir)
+		if err != nil || !filepath.IsLocal(rel) {
+			return "", fmt.Errorf("directory %q is outside workspace %q", dir, boundary)
+		}
+		path := filepath.Join(dir, name)
+		info, err := os.Stat(path)
+		if err == nil {
+			if !info.Mode().IsRegular() {
+				return "", fmt.Errorf("configuration %q is not a regular file", path)
+			}
+			return path, nil
+		}
+		if !os.IsNotExist(err) {
+			return "", fmt.Errorf("Stat: %w", err)
+		}
+		if dir == boundary || dir == filepath.Dir(dir) {
+			return "", nil
+		}
+	}
+}
+
+// SkipDirectory excludes storage, vendored sources, and nested repositories.
+func SkipDirectory(root, dir string) bool {
+	if dir == root {
+		return false
+	}
+	name := filepath.Base(dir)
+	if strings.HasPrefix(name, ".") || name == "easyp_vendor" || name == "node_modules" {
+		return true
+	}
+	_, err := os.Lstat(filepath.Join(dir, ".git"))
+	return err == nil
+}
+
+// Policy finds an ancestor policy or one unambiguous outermost policy below start.
+// Descendant policy discovery never executes generation plugins.
+func Policy(start string) (string, error) {
+	boundary, err := Boundary(start)
+	if err != nil {
+		return "", fmt.Errorf("Boundary: %w", err)
+	}
+	path, err := FindUp(start, boundary, "easyp.yaml")
+	if err != nil || path != "" {
+		return path, err
+	}
+	var found []string
+	err = filepath.WalkDir(start, func(path string, entry fs.DirEntry, walkErr error) error {
+		if walkErr != nil {
+			return walkErr
+		}
+		if !entry.IsDir() {
+			return nil
+		}
+		if SkipDirectory(start, path) {
+			return filepath.SkipDir
+		}
+		candidate := filepath.Join(path, "easyp.yaml")
+		if info, err := os.Stat(candidate); err == nil {
+			if !info.Mode().IsRegular() {
+				return fmt.Errorf("configuration %q is not a regular file", candidate)
+			}
+			found = append(found, candidate)
+			return filepath.SkipDir
+		} else if !os.IsNotExist(err) {
+			return err
+		}
+		return nil
+	})
+	if err != nil {
+		return "", fmt.Errorf("WalkDir: %w", err)
+	}
+	if len(found) == 1 {
+		return found[0], nil
+	}
+	if len(found) > 1 {
+		return "", fmt.Errorf("multiple independent policies found: %v; select one with --cfg", found)
+	}
+	return "", fmt.Errorf("no easyp.yaml found within %s", boundary)
+}
+
+// Module finds the nearest protobuf.mod without leaving the workspace.
+func Module(start string) (string, error) {
+	boundary, err := Boundary(start)
+	if err != nil {
+		return "", fmt.Errorf("Boundary: %w", err)
+	}
+	path, err := FindUp(start, boundary, "protobuf.mod")
+	if err != nil {
+		return "", fmt.Errorf("FindUp: %w", err)
+	}
+	if path == "" {
+		return "", fmt.Errorf("no protobuf.mod found within %s", boundary)
+	}
+	return filepath.Dir(path), nil
+}
diff --git a/internal/workspace/discovery_test.go b/internal/workspace/discovery_test.go
new file mode 100644
index 00000000..ee6d866f
--- /dev/null
+++ b/internal/workspace/discovery_test.go
@@ -0,0 +1,45 @@
+package workspace
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestDiscoveryHonorsBoundariesAndNearestFiles(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	require.NoError(t, os.Mkdir(filepath.Join(root, ".git"), 0o755))
+	require.NoError(t, os.MkdirAll(filepath.Join(root, "module/deep"), 0o755))
+	require.NoError(t, os.WriteFile(filepath.Join(root, "easyp.yaml"), []byte("version: v1\n"), 0o644))
+	require.NoError(t, os.WriteFile(filepath.Join(root, "module/protobuf.mod"), []byte("module example.com/module\n"), 0o644))
+	deep := filepath.Join(root, "module/deep")
+	boundary, err := Boundary(deep)
+	require.NoError(t, err)
+	require.Equal(t, root, boundary)
+	policy, err := Policy(deep)
+	require.NoError(t, err)
+	require.Equal(t, filepath.Join(root, "easyp.yaml"), policy)
+	module, err := Module(deep)
+	require.NoError(t, err)
+	require.Equal(t, filepath.Join(root, "module"), module)
+	require.NoError(t, os.WriteFile(filepath.Join(deep, ".git"), []byte("gitdir: /unused\n"), 0o644))
+	boundary, err = Boundary(deep)
+	require.NoError(t, err)
+	require.Equal(t, deep, boundary)
+	_, err = Policy(deep)
+	require.ErrorContains(t, err, "no easyp.yaml")
+}
+
+func TestIndependentPoliciesRequireExplicitSelection(t *testing.T) {
+	t.Parallel()
+	root := t.TempDir()
+	for _, dir := range []string{"one", "two"} {
+		require.NoError(t, os.Mkdir(filepath.Join(root, dir), 0o755))
+		require.NoError(t, os.WriteFile(filepath.Join(root, dir, "easyp.yaml"), []byte("version: v1\n"), 0o644))
+	}
+	_, err := Policy(root)
+	require.ErrorContains(t, err, "multiple independent policies")
+}
diff --git a/mcp/easypconfig/README.md b/mcp/easypconfig/README.md
index ac4b17be..228fd4ff 100644
--- a/mcp/easypconfig/README.md
+++ b/mcp/easypconfig/README.md
@@ -1,39 +1,50 @@
-# easypconfig
+# EasyP configuration MCP
 
-`mcp/easypconfig` is the source-of-truth package for `easyp.yaml` schema metadata and the MCP tool `easyp_config_describe`.
+<code>easyp_config_describe</code> describes four v1 configuration formats without reading a project, fetching dependencies or executing plugins. The tool name and existing YAML response fields are preserved.
 
-## Go usage
+| File selector | Output format | Reference |
+|---|---|---|
+| <code>easyp.yaml</code> | <code>yaml</code> | Policy fields, examples and the actual JSON Schema |
+| <code>easyp.gen.yaml</code> | <code>yaml</code> | Generation fields, examples and the actual JSON Schema |
+| <code>protobuf.lock</code> | <code>yaml</code> | Locked dependency fields and the actual lock JSON Schema |
+| <code>protobuf.mod</code> | <code>text</code> | Directive grammar, fields and text examples; no fabricated JSON Schema |
 
-```go
-import (
-    "github.com/easyp-tech/easyp/mcp/easypconfig"
-    "github.com/modelcontextprotocol/go-sdk/mcp"
-)
+## Run
 
-func register(server *mcp.Server) {
-    easypconfig.RegisterTool(server)
-}
-```
+~~~sh
+go run ./cmd/easyp-mcp
+~~~
 
-Programmatic access:
+Start this command from the EasyP source repository or run a built <code>easyp-mcp</code> binary from any directory. Protocol messages use stdout and process diagnostics use stderr.
 
-- `easypconfig.Describe(...)`
-- `easypconfig.SchemaByPath()`
-- `easypconfig.MarshalConfigJSONSchema()`
+Go programs register the same reference with <code>easypconfig.RegisterTool(server)</code> from <code>github.com/easyp-tech/easyp/mcp/easypconfig</code>.
 
-## Non-Go usage
+## Requests
 
-Versioned and latest JSON Schema artifacts are generated into:
+The default <code>file</code> is <code>easyp.yaml</code>; empty <code>path</code>, <code>$</code> and <code>root</code> select the root. Array indices normalize to <code>[]</code>. The file argument is an exact format selector, never a filesystem path or URL.
 
-- `schemas/easyp-config-v1.schema.json`
-- `schemas/easyp-config.schema.json`
+~~~json
+{"file":"protobuf.mod","path":"require[].version"}
+~~~
 
-This allows external tooling (for example Kotlin/JetBrains plugins) to consume the same schema without linking Go code.
+~~~json
+{"file":"protobuf.lock","path":"modules[0].commit"}
+~~~
 
-Generate/update artifacts:
+<code>include_schema</code>, <code>include_fields</code>, <code>include_examples</code> and <code>include_children</code> default to true. For a text manifest, <code>include_schema</code> controls the grammar instead; <code>schema</code> is always omitted. With <code>include_children=false</code>, only the selected field/directive is described. <code>examples_limit</code> defaults to 10 and must be an integer from 1 through 50. Out-of-range values now return a validation error instead of silently clamping.
 
-```sh
-go run ./cmd/easyp schema-gen
-# or
-task schema:generate
-```
+Output always includes <code>format</code>. YAML examples retain <code>examples[].yaml</code>; text examples contain <code>format: text</code> and <code>text</code>, with no misleading YAML value. Manifest syntax is described by <code>grammar.dialect</code>, <code>grammar.syntax</code> and <code>grammar.notes</code>. Unknown files, paths and invalid arguments return tool errors.
+
+## Contracts
+
+YAML schemas come directly from <code>internal/config/v1.SchemaJSON</code>, the same source used by <code>schema-gen</code>. Lock descriptions distinguish structural constraints from semantic checks: unique source identities, valid module major suffixes, matching commit-valued versions and verified content. Example commits and hashes are explicitly synthetic and do not certify fetched content.
+
+Manifest directives are <code>module</code>, <code>roots</code>, <code>require</code> and <code>replace</code>. Examples are checked by <code>ParseModule</code>; lock examples by <code>ParseLock</code> and the generated schema. Main-module local replacements do not alter the published lock. Frozen mode rejects replacements and requires a consistent pinned graph. The reference does not resolve unknown imports, query BSR, load policy dependencies or expand environment variables.
+
+## Verification
+
+~~~sh
+go test -race -count=1 ./mcp/easypconfig
+~~~
+
+The external <code>easyp-test</code> suite invokes the built stdio server using <code>EASYP_MCP_BIN</code>. When omitted, the test builds that server from an explicit absolute <code>EASYP_SOURCE</code>. It verifies initialization, tool listing, real calls, valid examples, schema equality, legacy YAML compatibility, input errors and lack of project-file access. The full audit builds both binaries from the same source revision before testing.
diff --git a/mcp/easypconfig/describe.go b/mcp/easypconfig/describe.go
index 2e90db4c..12e3c749 100644
--- a/mcp/easypconfig/describe.go
+++ b/mcp/easypconfig/describe.go
@@ -5,25 +5,31 @@ import (
 	"regexp"
 	"sort"
 	"strings"
-	"sync"
 
-	"github.com/easyp-tech/easyp/internal/rules"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
 )
 
 const (
-	ToolName      = "easyp_config_describe"
-	SchemaVersion = "easyp-config-v1"
+	// ToolName is the stable MCP tool name.
+	ToolName = "easyp_config_describe"
+	// SchemaVersion identifies the v1 configuration model returned by the tool.
+	SchemaVersion = "v1"
 )
 
+var arrayIndex = regexp.MustCompile(`\[(?:\d+|\*)\]`)
+
+// DescribeInput selects a v1 configuration file and a dot path within it.
 type DescribeInput struct {
-	Path            string `json:"path,omitempty"`
-	IncludeSchema   *bool  `json:"include_schema,omitempty"`
-	IncludeFields   *bool  `json:"include_fields,omitempty"`
-	IncludeExamples *bool  `json:"include_examples,omitempty"`
-	IncludeChildren *bool  `json:"include_children,omitempty"`
-	ExamplesLimit   *int   `json:"examples_limit,omitempty"`
+	File            string `json:"file,omitempty" jsonschema:"Format selector: easyp.yaml, easyp.gen.yaml, protobuf.mod, or protobuf.lock; never a filesystem path. Defaults to easyp.yaml."`
+	Path            string `json:"path,omitempty" jsonschema:"Dot path to a section or field. Empty means the full file."`
+	IncludeSchema   *bool  `json:"include_schema,omitempty" jsonschema:"Include JSON Schema for YAML or textual grammar for protobuf.mod. Default true."`
+	IncludeFields   *bool  `json:"include_fields,omitempty" jsonschema:"Include field documentation. Default true."`
+	IncludeExamples *bool  `json:"include_examples,omitempty" jsonschema:"Include valid v1 examples. Default true."`
+	IncludeChildren *bool  `json:"include_children,omitempty" jsonschema:"Include descendants of the selected path. Default true."`
+	ExamplesLimit   *int   `json:"examples_limit,omitempty" jsonschema:"Maximum examples, from 1 to 50. Default 10."`
 }
 
+// FieldDoc describes one field from the current v1 configuration schema.
 type FieldDoc struct {
 	Path          string   `json:"path"`
 	Type          string   `json:"type"`
@@ -35,304 +41,162 @@ type FieldDoc struct {
 	Notes         []string `json:"notes,omitempty"`
 }
 
+// Example is a v1 configuration snippet that can be parsed by EasyP.
 type Example struct {
 	Title       string   `json:"title"`
 	Description string   `json:"description,omitempty"`
-	YAML        string   `json:"yaml"`
+	YAML        string   `json:"yaml,omitempty"`
+	Format      string   `json:"format,omitempty"`
+	Text        string   `json:"text,omitempty"`
 	Paths       []string `json:"paths,omitempty"`
 }
 
+// DescribeOutput contains the selected schema, field details, and examples.
 type DescribeOutput struct {
-	SchemaVersion string         `json:"schema_version"`
-	SelectedPath  string         `json:"selected_path"`
-	Schema        map[string]any `json:"schema,omitempty"`
-	Fields        []FieldDoc     `json:"fields,omitempty"`
-	Examples      []Example      `json:"examples,omitempty"`
-	Notes         []string       `json:"notes,omitempty"`
-}
-
-type nodeDoc struct {
-	Fields   []FieldDoc
-	Examples []Example
-	Notes    []string
-}
-
-type spec struct {
-	SchemaVersion string
-	SchemaByPath  map[string]map[string]any
-	DocsByPath    map[string]nodeDoc
-}
-
-var (
-	specOnce sync.Once
-	specData spec
-
-	arrayIndexPattern = regexp.MustCompile(`\[\d+\]`)
-)
-
+	SchemaVersion string            `json:"schema_version"`
+	File          string            `json:"file"`
+	SelectedPath  string            `json:"selected_path"`
+	Format        string            `json:"format"`
+	Grammar       *GrammarReference `json:"grammar,omitempty"`
+	Schema        map[string]any    `json:"schema,omitempty"`
+	Fields        []FieldDoc        `json:"fields,omitempty"`
+	Examples      []Example         `json:"examples,omitempty"`
+	Notes         []string          `json:"notes,omitempty"`
+}
+
+// Describe explains a v1 config path using the same JSON Schema as schema-gen.
 func Describe(input DescribeInput) (DescribeOutput, error) {
-	s := getSpec()
-	return s.describe(input)
-}
-
-func getSpec() spec {
-	specOnce.Do(func() {
-		specData = newSpec()
-	})
-	return specData
-}
-
-func (s spec) describe(input DescribeInput) (DescribeOutput, error) {
-	selectedPath, ok := s.resolvePath(input.Path)
-	if !ok {
-		return DescribeOutput{}, fmt.Errorf("unknown path %q", input.Path)
+	if input.ExamplesLimit != nil && (*input.ExamplesLimit < 1 || *input.ExamplesLimit > 50) {
+		return DescribeOutput{}, fmt.Errorf("examples_limit must be from 1 to 50")
 	}
-
-	includeSchema := boolOrDefault(input.IncludeSchema, true)
-	includeFields := boolOrDefault(input.IncludeFields, true)
-	includeExamples := boolOrDefault(input.IncludeExamples, true)
-	includeChildren := boolOrDefault(input.IncludeChildren, true)
-	examplesLimit := intOrDefault(input.ExamplesLimit, 10)
-	if examplesLimit < 1 {
-		examplesLimit = 1
+	file, _, err := configFile(input.File)
+	if err != nil {
+		return DescribeOutput{}, err
 	}
-	if examplesLimit > 50 {
-		examplesLimit = 50
+	if file == v1.ModuleFile {
+		return describeModule(input)
 	}
-
-	paths := s.pathsFor(selectedPath, includeChildren)
-
-	out := DescribeOutput{
-		SchemaVersion: s.SchemaVersion,
-		SelectedPath:  selectedPath,
+	index, err := SchemaByPathFor(file)
+	if err != nil {
+		return DescribeOutput{}, fmt.Errorf("SchemaByPathFor: %w", err)
+	}
+	path := normalizePath(input.Path)
+	schema, ok := index[path]
+	if !ok {
+		return DescribeOutput{}, fmt.Errorf("unknown path %q in %s", input.Path, file)
 	}
 
-	if includeSchema {
-		out.Schema = cloneSchemaMap(s.SchemaByPath[selectedPath])
+	out := DescribeOutput{SchemaVersion: SchemaVersion, File: file, SelectedPath: path, Format: "yaml"}
+	if enabled(input.IncludeSchema) {
+		out.Schema = schema
 	}
-	if includeFields {
-		out.Fields = s.collectFields(paths)
+	paths := selectedPaths(index, path, enabled(input.IncludeChildren))
+	if enabled(input.IncludeFields) {
+		out.Fields = describeFields(file, index, paths)
 	}
-	if includeExamples {
-		out.Examples = s.collectExamples(paths, examplesLimit)
+	if enabled(input.IncludeExamples) {
+		out.Examples = selectExamples(file, path, exampleLimit(input.ExamplesLimit))
 	}
-	out.Notes = s.collectNotes(paths)
-
+	out.Notes = notesFor(file, path)
 	return out, nil
 }
 
-func (s spec) resolvePath(rawPath string) (string, bool) {
-	path := normalizePath(rawPath)
-	if s.hasPath(path) {
-		return path, true
-	}
-
-	normPath := removeArrayMarkers(path)
-	for _, candidate := range s.allPaths() {
-		if removeArrayMarkers(candidate) == normPath {
-			return candidate, true
-		}
+func normalizePath(path string) string {
+	path = strings.TrimSpace(path)
+	if path == "" || path == "$" || strings.EqualFold(path, "root") {
+		return "$"
 	}
+	path = strings.TrimPrefix(path, "$.")
+	path = strings.TrimPrefix(path, ".")
+	path = arrayIndex.ReplaceAllString(path, "[]")
+	return strings.TrimSuffix(path, ".")
+}
 
-	return "", false
+func enabled(value *bool) bool {
+	return value == nil || *value
 }
 
-func (s spec) pathsFor(selectedPath string, includeChildren bool) []string {
-	if !includeChildren {
-		return []string{selectedPath}
+func exampleLimit(value *int) int {
+	if value == nil {
+		return 10
 	}
+	return *value
+}
 
-	allPaths := s.allPaths()
-	paths := make([]string, 0, len(allPaths))
-	for _, p := range allPaths {
-		if isPathWithin(selectedPath, p) {
-			paths = append(paths, p)
+func selectedPaths(index map[string]map[string]any, path string, children bool) []string {
+	if !children {
+		return []string{path}
+	}
+	paths := make([]string, 0, len(index))
+	for candidate := range index {
+		if within(path, candidate) {
+			paths = append(paths, candidate)
 		}
 	}
+	sort.Strings(paths)
 	return paths
 }
 
-func (s spec) collectFields(paths []string) []FieldDoc {
-	seen := make(map[string]struct{})
-	out := make([]FieldDoc, 0)
-	for _, p := range paths {
-		doc, ok := s.DocsByPath[p]
-		if !ok {
-			continue
-		}
-		for _, f := range doc.Fields {
-			if _, exists := seen[f.Path]; exists {
-				continue
-			}
-			seen[f.Path] = struct{}{}
-			out = append(out, cloneFieldDoc(f))
-		}
-	}
-
-	sort.Slice(out, func(i, j int) bool {
-		return out[i].Path < out[j].Path
-	})
-	return out
+func within(parent, path string) bool {
+	return parent == "$" || path == parent || strings.HasPrefix(path, parent+".") || strings.HasPrefix(path, parent+"[]")
 }
 
-func (s spec) collectExamples(paths []string, limit int) []Example {
-	out := make([]Example, 0, limit)
-	seen := make(map[string]struct{})
-	for _, p := range paths {
-		doc, ok := s.DocsByPath[p]
-		if !ok {
+func describeFields(file string, index map[string]map[string]any, paths []string) []FieldDoc {
+	fields := make([]FieldDoc, 0, len(paths))
+	for _, path := range paths {
+		if path == "$" || strings.HasSuffix(path, "[]") {
 			continue
 		}
-		for _, ex := range doc.Examples {
-			key := exampleKey(ex)
-			if _, exists := seen[key]; exists {
-				continue
-			}
-			seen[key] = struct{}{}
-			out = append(out, cloneExample(ex))
-			if len(out) >= limit {
-				return out
-			}
-		}
+		fields = append(fields, schemaField(file, index, path))
 	}
-	return out
+	return fields
 }
 
-func (s spec) collectNotes(paths []string) []string {
-	seen := make(map[string]struct{})
-	out := make([]string, 0)
-	for _, p := range paths {
-		doc, ok := s.DocsByPath[p]
-		if !ok {
-			continue
-		}
-		for _, note := range doc.Notes {
-			if _, exists := seen[note]; exists {
-				continue
+func schemaField(file string, index map[string]map[string]any, path string) FieldDoc {
+	schema := index[path]
+	field := FieldDoc{Path: path, Type: schemaType(schema), Description: fieldDescription(file, path)}
+	field.Notes = notesFor(file, path)
+	if description, ok := schema["description"].(string); ok && description != "" {
+		field.Description = description
+	}
+	if values, ok := schema["enum"].([]any); ok {
+		for _, value := range values {
+			if name, ok := value.(string); ok {
+				field.AllowedValues = append(field.AllowedValues, name)
 			}
-			seen[note] = struct{}{}
-			out = append(out, note)
 		}
 	}
-	return out
-}
-
-func (s spec) hasPath(path string) bool {
-	if _, ok := s.SchemaByPath[path]; ok {
-		return true
-	}
-	if _, ok := s.DocsByPath[path]; ok {
-		return true
+	parent := "$"
+	name := path
+	if lastDot := strings.LastIndex(path, "."); lastDot >= 0 {
+		parent, name = path[:lastDot], path[lastDot+1:]
 	}
-	return false
-}
-
-func (s spec) allPaths() []string {
-	seen := make(map[string]struct{})
-	paths := make([]string, 0, len(s.SchemaByPath)+len(s.DocsByPath))
-
-	for p := range s.SchemaByPath {
-		if _, ok := seen[p]; ok {
-			continue
-		}
-		seen[p] = struct{}{}
-		paths = append(paths, p)
-	}
-	for p := range s.DocsByPath {
-		if _, ok := seen[p]; ok {
-			continue
+	if parentSchema, ok := index[parent]; ok {
+		if required, ok := parentSchema["required"].([]any); ok {
+			for _, item := range required {
+				field.Required = field.Required || item == name
+			}
 		}
-		seen[p] = struct{}{}
-		paths = append(paths, p)
-	}
-
-	sort.Strings(paths)
-	return paths
-}
-
-func boolOrDefault(v *bool, def bool) bool {
-	if v == nil {
-		return def
-	}
-	return *v
-}
-
-func intOrDefault(v *int, def int) int {
-	if v == nil {
-		return def
-	}
-	return *v
-}
-
-func lintUseAllowedValues() []string {
-	return append([]string(nil), rules.AllLintUseValues()...)
-}
-
-func normalizePath(path string) string {
-	path = strings.TrimSpace(path)
-	if path == "" || path == "$" || strings.EqualFold(path, "root") {
-		return "$"
 	}
-
-	path = strings.TrimPrefix(path, "$.")
-	path = strings.TrimPrefix(path, ".")
-	path = strings.ReplaceAll(path, "[*]", "[]")
-	path = arrayIndexPattern.ReplaceAllString(path, "[]")
-	path = strings.TrimSuffix(path, ".")
-
-	return path
-}
-
-func removeArrayMarkers(path string) string {
-	return strings.ReplaceAll(path, "[]", "")
+	return field
 }
 
-func isPathWithin(base, candidate string) bool {
-	if base == "$" {
-		return true
+func schemaType(schema map[string]any) string {
+	if typ, ok := schema["type"].(string); ok {
+		return typ
 	}
-	if base == candidate {
-		return true
+	if _, ok := schema["oneOf"]; ok {
+		return "oneOf"
 	}
-	if strings.HasPrefix(candidate, base+".") {
-		return true
+	if _, ok := schema["anyOf"]; ok {
+		return "anyOf"
 	}
-	if strings.HasPrefix(candidate, base+"[].") {
-		return true
-	}
-	if candidate == base+"[]" {
-		return true
-	}
-	return false
-}
-
-func cloneFieldDoc(in FieldDoc) FieldDoc {
-	out := in
-	out.AllowedValues = append([]string(nil), in.AllowedValues...)
-	out.Examples = append([]string(nil), in.Examples...)
-	out.Notes = append([]string(nil), in.Notes...)
-	return out
-}
-
-func cloneExample(in Example) Example {
-	out := in
-	out.Paths = append([]string(nil), in.Paths...)
-	return out
-}
-
-func exampleKey(ex Example) string {
-	return strings.Join([]string{
-		ex.Title,
-		ex.Description,
-		ex.YAML,
-		strings.Join(ex.Paths, "\x1f"),
-	}, "\x1e")
+	return "any"
 }
 
-func newSpec() spec {
-	return spec{
-		SchemaVersion: SchemaVersion,
-		SchemaByPath:  SchemaByPath(),
-		DocsByPath:    docsByPath(),
+func fieldDescription(file, path string) string {
+	if description := descriptions[file][path]; description != "" {
+		return description
 	}
+	return "Configuration value."
 }
diff --git a/mcp/easypconfig/describe_test.go b/mcp/easypconfig/describe_test.go
new file mode 100644
index 00000000..375ea029
--- /dev/null
+++ b/mcp/easypconfig/describe_test.go
@@ -0,0 +1,271 @@
+package easypconfig
+
+import (
+	"bytes"
+	"context"
+	"encoding/json"
+	"strings"
+	"testing"
+
+	"github.com/modelcontextprotocol/go-sdk/mcp"
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestDescribeV1Files(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name       string
+		input      DescribeInput
+		wantFile   string
+		wantPath   string
+		wantField  string
+		wantSchema bool
+	}{
+		{name: "default policy", input: DescribeInput{Path: "$.linters.default"}, wantFile: v1.PolicyFile, wantPath: "linters.default", wantField: "linters.default", wantSchema: true},
+		{name: "generator plugin", input: DescribeInput{File: v1.GenerateFile, Path: "plugins[3].out"}, wantFile: v1.GenerateFile, wantPath: "plugins[].out", wantField: "plugins[].out", wantSchema: true},
+		{name: "plugin binary path", input: DescribeInput{File: v1.GenerateFile, Path: "plugins[0].path"}, wantFile: v1.GenerateFile, wantPath: "plugins[].path", wantField: "plugins[].path", wantSchema: true},
+		{name: "custom plugin command", input: DescribeInput{File: v1.GenerateFile, Path: "plugins[0].command"}, wantFile: v1.GenerateFile, wantPath: "plugins[].command", wantField: "plugins[].command", wantSchema: true},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			got, err := Describe(tt.input)
+
+			require.NoError(t, err)
+			assert.Equal(t, "v1", got.SchemaVersion)
+			assert.Equal(t, tt.wantFile, got.File)
+			assert.Equal(t, tt.wantPath, got.SelectedPath)
+			assert.Contains(t, fieldPaths(got.Fields), tt.wantField)
+			if tt.wantSchema {
+				assert.NotEmpty(t, got.Schema)
+			} else {
+				assert.Empty(t, got.Schema)
+			}
+		})
+	}
+}
+
+func TestDescribeRejectsUnknownSelection(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name  string
+		input DescribeInput
+		want  string
+	}{
+		{name: "unknown file", input: DescribeInput{File: "buf.yaml"}, want: "unknown config file"},
+		{name: "filesystem paths are not formats", input: DescribeInput{File: "/tmp/protobuf.mod"}, want: "unknown config file"},
+		{name: "legacy lock is not a current format", input: DescribeInput{File: "easyp.lock"}, want: "unknown config file"},
+		{name: "removed v0 path", input: DescribeInput{File: v1.GenerateFile, Path: "generate.inputs"}, want: "unknown path"},
+		{name: "unknown policy field", input: DescribeInput{Path: "lint.use"}, want: "unknown path"},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			_, err := Describe(tt.input)
+
+			require.ErrorContains(t, err, tt.want)
+		})
+	}
+}
+
+func TestDescribeNotesForReservedFields(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name string
+		file string
+		path string
+		want string
+	}{
+		{name: "package filter", file: v1.GenerateFile, path: "generate.packages", want: "exact protobuf packages"},
+		{name: "linter inheritance", file: v1.PolicyFile, path: "linters.extends", want: "declared-module#policy-path"},
+		{name: "issue path matching", file: v1.PolicyFile, path: "issues.exclude-rules[0].path", want: "relative to the easyp.yaml"},
+		{name: "breaking unstable", file: v1.PolicyFile, path: "breaking.ignore_unstable", want: "both comparison revisions"},
+		{name: "breaking inheritance", file: v1.PolicyFile, path: "breaking.extends", want: "declared-module#policy-path"},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			got, err := Describe(DescribeInput{File: tt.file, Path: tt.path})
+
+			require.NoError(t, err)
+			require.Len(t, got.Fields, 1)
+			assert.Contains(t, strings.Join(got.Notes, " "), tt.want)
+			assert.Contains(t, strings.Join(got.Fields[0].Notes, " "), tt.want)
+		})
+	}
+}
+
+func TestDescribeUsesGeneratedSchema(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name string
+		file string
+		key  string
+	}{
+		{name: "policy", file: v1.PolicyFile, key: "easyp"},
+		{name: "generator", file: v1.GenerateFile, key: "easyp.gen"},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			got, err := Describe(DescribeInput{File: tt.file})
+			require.NoError(t, err)
+			raw, err := v1.SchemaJSON(tt.key)
+			require.NoError(t, err)
+			var want map[string]any
+			require.NoError(t, json.Unmarshal(raw, &want))
+
+			assert.Equal(t, want, got.Schema)
+		})
+	}
+}
+
+func TestFieldDescriptionsMatchSchema(t *testing.T) {
+	t.Parallel()
+
+	for _, file := range []string{v1.PolicyFile, v1.GenerateFile} {
+		file := file
+		t.Run(file, func(t *testing.T) {
+			t.Parallel()
+
+			index, err := SchemaByPathFor(file)
+
+			require.NoError(t, err)
+			for path := range descriptions[file] {
+				assert.Contains(t, index, path)
+			}
+		})
+	}
+}
+
+func TestDescribeOptionsAndIndependentResults(t *testing.T) {
+	t.Parallel()
+
+	falseValue := false
+	withoutDetails, err := Describe(DescribeInput{File: v1.GenerateFile, Path: "plugins", IncludeSchema: &falseValue, IncludeFields: &falseValue, IncludeExamples: &falseValue})
+	require.NoError(t, err)
+	assert.Empty(t, withoutDetails.Schema)
+	assert.Empty(t, withoutDetails.Fields)
+	assert.Empty(t, withoutDetails.Examples)
+
+	withoutChildren, err := Describe(DescribeInput{File: v1.GenerateFile, Path: "plugins", IncludeChildren: &falseValue})
+	require.NoError(t, err)
+	assert.NotContains(t, fieldPaths(withoutChildren.Fields), "plugins[].out")
+
+	first, err := Describe(DescribeInput{File: v1.GenerateFile, Path: "plugins[].out"})
+	require.NoError(t, err)
+	first.Schema["type"] = "mutated"
+	second, err := Describe(DescribeInput{File: v1.GenerateFile, Path: "plugins[].out"})
+	require.NoError(t, err)
+	assert.Equal(t, "string", second.Schema["type"])
+}
+
+func TestDescribeExamplesAreValidV1(t *testing.T) {
+	t.Parallel()
+
+	for _, file := range []string{v1.PolicyFile, v1.GenerateFile} {
+		file := file
+		t.Run(file, func(t *testing.T) {
+			t.Parallel()
+
+			got, err := Describe(DescribeInput{File: file})
+			require.NoError(t, err)
+			require.NotEmpty(t, got.Examples)
+			for _, example := range got.Examples {
+				switch file {
+				case v1.PolicyFile:
+					assert.Empty(t, v1.ValidatePolicyYAML([]byte(example.YAML)), example.Title)
+					_, err = v1.ParsePolicy(strings.NewReader(example.YAML))
+				case v1.GenerateFile:
+					assert.Empty(t, v1.ValidateGenerateYAML([]byte(example.YAML)), example.Title)
+					_, err = v1.ParseGenerate(strings.NewReader(example.YAML))
+				}
+				require.NoError(t, err, example.Title)
+			}
+		})
+	}
+}
+
+func TestRegisterToolViaMCP(t *testing.T) {
+	t.Parallel()
+
+	server := mcp.NewServer(&mcp.Implementation{Name: "easyp-test", Version: "v1"}, nil)
+	RegisterTool(server)
+	serverTransport, clientTransport := mcp.NewInMemoryTransports()
+	serverSession, err := server.Connect(context.Background(), serverTransport, nil)
+	require.NoError(t, err)
+	t.Cleanup(func() { require.NoError(t, serverSession.Close()) })
+
+	client := mcp.NewClient(&mcp.Implementation{Name: "easyp-test-client", Version: "v1"}, nil)
+	clientSession, err := client.Connect(context.Background(), clientTransport, nil)
+	require.NoError(t, err)
+	t.Cleanup(func() { require.NoError(t, clientSession.Close()) })
+
+	listed, err := clientSession.ListTools(context.Background(), nil)
+	require.NoError(t, err)
+	require.Len(t, listed.Tools, 1)
+	assert.Equal(t, ToolName, listed.Tools[0].Name)
+
+	response, err := clientSession.CallTool(context.Background(), &mcp.CallToolParams{
+		Name: ToolName, Arguments: map[string]any{"file": v1.GenerateFile, "path": "plugins[0].out"},
+	})
+	require.NoError(t, err)
+	require.False(t, response.IsError)
+	data, err := json.Marshal(response.StructuredContent)
+	require.NoError(t, err)
+	var described DescribeOutput
+	require.NoError(t, json.NewDecoder(bytes.NewReader(data)).Decode(&described))
+	assert.Equal(t, v1.GenerateFile, described.File)
+	assert.Equal(t, "plugins[].out", described.SelectedPath)
+
+	invalid, err := clientSession.CallTool(context.Background(), &mcp.CallToolParams{
+		Name: ToolName, Arguments: map[string]any{"file": v1.GenerateFile, "path": "generate.inputs"},
+	})
+	require.NoError(t, err)
+	assert.True(t, invalid.IsError)
+}
+
+func fieldPaths(fields []FieldDoc) []string {
+	paths := make([]string, 0, len(fields))
+	for _, field := range fields {
+		paths = append(paths, field.Path)
+	}
+	return paths
+}
+
+func TestDescribeLintSelectionMatchesExecutableRules(t *testing.T) {
+	t.Parallel()
+	for _, path := range []string{"linters.enable", "linters.disable", "issues.exclude-rules[].linters"} {
+		t.Run(path, func(t *testing.T) {
+			t.Parallel()
+			got, err := Describe(DescribeInput{File: v1.PolicyFile, Path: path})
+			require.NoError(t, err)
+			items, ok := got.Schema["items"].(map[string]any)
+			require.True(t, ok)
+			values, ok := items["enum"].([]any)
+			require.True(t, ok)
+			assert.Contains(t, values, "ENUM_VALUE_PREFIX")
+			assert.Contains(t, values, "UNARY_RPC")
+			assert.NotContains(t, values, "PACKAGE_NO_IMPORT_CYCLE")
+		})
+	}
+}
diff --git a/mcp/easypconfig/docs.go b/mcp/easypconfig/docs.go
new file mode 100644
index 00000000..1b0d6ea3
--- /dev/null
+++ b/mcp/easypconfig/docs.go
@@ -0,0 +1,150 @@
+package easypconfig
+
+import v1 "github.com/easyp-tech/easyp/internal/config/v1"
+
+var descriptions = map[string]map[string]string{
+	v1.LockFile: {
+		"version":                              "Lock format version: integer 1, not the YAML configuration string v1.",
+		"modules":                              "Published dependency graph, with one verified revision per module identity. An empty list is valid for a dependency-free module.",
+		"modules[].source":                     "Exact module identity; separate v2+ lines use their matching /vN suffix.",
+		"modules[].version":                    "Selected semantic version or a full commit. A commit-valued version must equal commit; major suffix and legacy +incompatible provenance are checked.",
+		"modules[].commit":                     "Full 40- or 64-character hexadecimal Git commit. Tags and short SHAs are not commit pins.",
+		"modules[].hash":                       "h1: followed by standard base64 encoding of a 32-byte SHA-256 content digest. Fetch/install verify tracked contents; a sample hash is not proof of a real repository.",
+		"modules[].bsr":                        "BSR requests declared by this Git dependency and their recorded Git targets; frozen commands replay these bindings without calling a resolver.",
+		"modules[].bsr[].dependency.module":    "Original BSR identity, separate from the selected Git source.",
+		"modules[].bsr[].dependency.reference": "Requested Buf label or BSR commit; preserved even when a compatibility snapshot cannot prove equivalence.",
+		"modules[].bsr[].dependency.commit":    "Optional 32-character hexadecimal BSR commit from buf.lock; not a Git commit.",
+		"modules[].bsr[].dependency.digest":    "Optional opaque BSR digest from buf.lock. Compatibility snapshots preserve but do not verify it.",
+		"modules[].bsr[].dependency.config":    "Declaring buf.yaml path relative to the verified Git checkout, including v1 workspace directories.",
+		"modules[].bsr[].git.module":           "Git module selected by the BSR resolver; it participates in the existing dependency graph.",
+		"modules[].bsr[].git.version":          "Pinned Git semantic version or full commit. Moving references and implicit latest are not accepted.",
+		"modules[].bsr[].resolution":           "compatibility_snapshot does not guarantee BSR revision equivalence or verify its digest. exact is reserved for a backend that proves the correspondence.",
+	},
+	v1.PolicyFile: {
+		"version":                       "Configuration version; v1 is the only supported value.",
+		"linters":                       "Lint rule selection for this module.",
+		"linters.default":               "Preset used before enable and disable rules.",
+		"linters.enable":                "Implemented lint rules or groups to enable; repeated selections are idempotent.",
+		"linters.disable":               "Implemented lint rules or groups to disable; disabling takes precedence over enabling.",
+		"linters.allow_comment_ignores": "Allow scoped comment suppressions (default true). easyp:disable RULE annotates a declaration or a block; paired easyp:enable ends an explicit region. Legacy nolint:RULE and buf:lint:ignore RULE are also recognized.",
+		"linters.extends":               "Base lint policy from a workspace-relative file or a declared, locked module; local adjustments override it.",
+		"linters-settings":              "Settings for supported lint rules.",
+		"linters-settings.ENUM_ZERO_VALUE_SUFFIX": "Suffix for zero enum values.",
+		"linters-settings.SERVICE_SUFFIX":         "Suffix for service names.",
+		"issues":                                  "Rules for suppressing lint findings.",
+		"issues.exclude-rules":                    "Suppress lint findings matching a rule.",
+		"issues.exclude-rules[].path":             "Policy-source-relative path or glob; literal directories include descendants, ** matches directory segments.",
+		"issues.exclude-rules[].linters":          "Implemented lint rules or groups suppressed by this exclusion; unknown or unimplemented names are rejected.",
+		"breaking":                                "Compatibility checks against a Git baseline.",
+		"breaking.baseline":                       "Empty or git:<ref> baseline; an explicit --against overrides it, while the CLI default does not. Runtime and config validation enforce the same syntax.",
+		"breaking.ignore":                         "Paths ignored by breaking checks.",
+		"breaking.categories":                     "Compatibility profiles: FILE, PACKAGE, WIRE_JSON and WIRE. Omitted or empty defaults to FILE for v1 policies; profiles use compiled descriptors.",
+		"breaking.extends":                        "Base breaking policy from a local file or declared, locked module; evaluated separately for every checked module.",
+		"breaking.ignore_unstable":                "Ignore only declarations in packages with unstable version suffixes; stable package checks remain active.",
+	},
+	v1.GenerateFile: {
+		"version":                                  "Configuration version; v1 is the only supported value.",
+		"generate":                                 "Select modules for this generation run.",
+		"generate.modules":                         "Module identities selected from protobuf.mod dependencies or the local workspace.",
+		"generate.packages":                        "Exact protobuf package names among selected modules. Empty means all module sources; imports remain available for compilation.",
+		"generate.managed":                         "Managed file and field option rules.",
+		"plugins":                                  "Generators executed for selected modules.",
+		"plugins[].name":                           "Local or built-in plugin name.",
+		"plugins[].path":                           "Explicit plugin binary path, relative to the generation working directory when not absolute.",
+		"plugins[].command":                        "Custom plugin executable and arguments, run from the generation working directory.",
+		"plugins[].remote":                         "Remote plugin endpoint; requires a pinned version.",
+		"plugins[].version":                        "Pinned version for a remote plugin.",
+		"plugins[].out":                            "Output directory for generated files.",
+		"plugins[].with_imports":                   "Generate transitive imports with this plugin only; false by default. Not the descriptor include_imports flag.",
+		"plugins[].opts":                           "Plugin options as a list or map of scalar values.",
+		"options":                                  "Language-specific generator options.",
+		"options.go":                               "Go generator options.",
+		"options.go.package_prefix":                "Go package prefix; may be inherited. Changes only Go options unless generate.managed.enabled explicitly enables full managed mode.",
+		"generate.managed.enabled":                 "Enable managed descriptor options.",
+		"generate.managed.disable":                 "Rules that prevent managed mode from changing matching options.",
+		"generate.managed.override":                "Rules that set file or field options.",
+		"generate.managed.disable[].module":        "Limit the disable rule to a module.",
+		"generate.managed.disable[].package":       "Limit the disable rule to a protobuf package.",
+		"generate.managed.disable[].path":          "Limit the disable rule to a file or directory path.",
+		"generate.managed.disable[].file_option":   "File option that managed mode must leave unchanged.",
+		"generate.managed.disable[].field_option":  "Field option that managed mode must leave unchanged.",
+		"generate.managed.disable[].field":         "Fully qualified field selected with field_option.",
+		"generate.managed.override[].module":       "Limit the override to a module.",
+		"generate.managed.override[].package":      "Limit the override to a protobuf package.",
+		"generate.managed.override[].path":         "Limit the override to a file or directory path.",
+		"generate.managed.override[].file_option":  "Supported managed file option to set; unknown names are rejected before generation.",
+		"generate.managed.override[].field_option": "Supported managed field option to set; currently jstype.",
+		"generate.managed.override[].field":        "Fully qualified field selected with field_option.",
+		"generate.managed.override[].value":        "Typed value for the selected option: a string, boolean, or supported enum name. Wrong types and enum values are rejected.",
+	},
+}
+
+func examplesFor(file string) []Example {
+	switch file {
+	case v1.ModuleFile:
+		return moduleExamples()
+	case v1.LockFile:
+		return lockExamples()
+	case v1.PolicyFile:
+		return []Example{
+			{Title: "shared_lint", Description: "Create .policies/lint.yaml with a linters section in this workspace before execution.", YAML: "version: v1\nlinters:\n  extends: ./.policies/lint.yaml\n  disable: [PACKAGE_VERSION_SUFFIX]\n", Paths: []string{"linters.extends"}},
+			{Title: "lint_policy", YAML: "version: v1\nlinters:\n  default: STANDARD\n  enable: [FILE_LOWER_SNAKE_CASE]\n", Paths: []string{"linters", "linters.default", "linters.enable"}},
+			{Title: "breaking_policy", YAML: "version: v1\nbreaking:\n  baseline: git:main\n  categories: [FILE]\n", Paths: []string{"breaking", "breaking.baseline", "breaking.categories"}},
+		}
+	case v1.GenerateFile:
+		return []Example{
+			{Title: "package_selection", Description: "Requires an api.v1 package in the selected module sources.", YAML: "version: v1\ngenerate:\n  packages: [api.v1]\nplugins:\n  - name: go\n    out: gen\n    with_imports: true\n", Paths: []string{"generate.packages"}},
+			{Title: "local_plugin", YAML: "version: v1\nplugins:\n  - name: go\n    out: gen/go\n    opts: [paths=source_relative]\n", Paths: []string{"plugins", "plugins[]", "plugins[].name", "plugins[].out", "plugins[].opts"}},
+			{Title: "remote_plugin", YAML: "version: v1\nplugins:\n  - remote: plugins.beta.easyp.tech/protocolbuffers/go\n    version: v1.36.11\n    out: gen/go\n    opts: [paths=source_relative]\n", Paths: []string{"plugins", "plugins[]", "plugins[].remote", "plugins[].version"}},
+			{Title: "binary_path", YAML: "version: v1\nplugins:\n  - path: ./tools/protoc-gen-custom\n    out: gen/custom\n", Paths: []string{"plugins", "plugins[]", "plugins[].path"}},
+			{Title: "custom_command", YAML: "version: v1\nplugins:\n  - command: [sh, ./tools/protoc-plugin.sh]\n    out: gen/script\n", Paths: []string{"plugins", "plugins[]", "plugins[].command"}},
+			{Title: "managed_mode", YAML: "version: v1\ngenerate:\n  managed:\n    enabled: true\n    override:\n      - file_option: go_package_prefix\n        value: example.com/gen\nplugins:\n  - name: go\n    out: gen/go\n", Paths: []string{"generate", "generate.managed", "generate.managed.override"}},
+		}
+	default:
+		return nil
+	}
+}
+
+func selectExamples(file, path string, limit int) []Example {
+	var selected []Example
+	for _, example := range examplesFor(file) {
+		if path != "$" {
+			matches := false
+			for _, examplePath := range example.Paths {
+				if within(examplePath, path) || within(path, examplePath) {
+					matches = true
+					break
+				}
+			}
+			if !matches {
+				continue
+			}
+		}
+		selected = append(selected, example)
+		if len(selected) == limit {
+			break
+		}
+	}
+	return selected
+}
+
+func notesFor(file, path string) []string {
+	switch {
+	case file == v1.LockFile:
+		return []string{"Schema comes directly from v1.SchemaJSON. ParseLock adds semantic checks for duplicate sources, matching module majors and commit-valued versions. Examples contain synthetic commits/hashes, not fetched data.", "Local replace never rewrites the published lock. --frozen requires a valid complete manifest/lock graph and rejects replacements; it may download exact pinned contents but never resolves a new version. Preserve the lock when investigating a cache mismatch.", "BSR compatibility_snapshot bindings preserve the original request and Buf lock pin, but do not prove BSR revision equivalence or verify the BSR digest. Frozen commands validate metadata and reuse recorded Git targets; older locks with BSR dependencies require easyp mod tidy."}
+	case file == v1.GenerateFile && within("generate.packages", path):
+		return []string{"Names match exact protobuf packages, not prefixes or file paths. Matching is across the selected modules of each project. Unknown names fail before plugins. with_imports is independent per plugin; descriptor include_imports controls exported dependencies."}
+	case file == v1.PolicyFile && path == "linters.extends":
+		return []string{"Use ./ or ../ for local files, or declared-module#policy-path. Versions belong only in protobuf.mod/protobuf.lock. Local adjustments override the base; issues are not inherited. validate-config requires verified cached content and never downloads it."}
+	case file == v1.PolicyFile && path == "issues.exclude-rules[].path":
+		return []string{"Paths are relative to the easyp.yaml providing the effective issues section, not the invocation directory. Supports *, ?, character classes and whole-segment **. A matching exclusion without linters suppresses every rule for that file."}
+	case file == v1.PolicyFile && path == "breaking.categories":
+		return []string{"FILE checks generated-source and file identity; PACKAGE permits moves within a package; WIRE_JSON protects binary and JSON; WIRE protects binary encoding. Multiple profiles select their union without duplicate findings. Omitted or empty categories default to FILE for v1 policies. Profile catalog and limits are documented in .spec/config/breaking-profiles.md."}
+	case file == v1.PolicyFile && path == "breaking.ignore_unstable":
+		return []string{"Filters unstable version-suffixed packages in both comparison revisions. Stable package declarations, imports and references remain checked."}
+	case file == v1.PolicyFile && path == "breaking.extends":
+		return []string{"Use ./ or ../ for local files, or declared-module#policy-path. Baseline and ignore paths apply at the consuming policy. Explicit false and empty lists override the base. Frozen mode uses verified pins and rejects local replacements."}
+	default:
+		return nil
+	}
+}
diff --git a/mcp/easypconfig/easypconfig_test.go b/mcp/easypconfig/easypconfig_test.go
deleted file mode 100644
index 2c76ab09..00000000
--- a/mcp/easypconfig/easypconfig_test.go
+++ /dev/null
@@ -1,430 +0,0 @@
-package easypconfig
-
-import (
-	"context"
-	"encoding/json"
-	"net/http"
-	"net/http/httptest"
-	"os"
-	"path/filepath"
-	"strings"
-	"testing"
-	"time"
-
-	"github.com/easyp-tech/easyp/internal/rules"
-	"github.com/modelcontextprotocol/go-sdk/mcp"
-	"github.com/stretchr/testify/require"
-)
-
-func TestDescribe_GitRepoPath_NoOutField(t *testing.T) {
-	t.Parallel()
-
-	out, err := Describe(DescribeInput{Path: "generate.inputs[*].git_repo"})
-	require.NoError(t, err)
-
-	require.Equal(t, SchemaVersion, out.SchemaVersion)
-	require.Equal(t, "generate.inputs[].git_repo", out.SelectedPath)
-	require.Contains(t, fieldPaths(out.Fields), "generate.inputs[].git_repo.url")
-	require.NotContains(t, fieldPaths(out.Fields), "generate.inputs[].git_repo.out")
-
-	props, ok := nestedMap(out.Schema, "properties")
-	require.True(t, ok, "expected properties in schema fragment")
-	_, hasOut := props["out"]
-	require.False(t, hasOut, "git_repo.out must not exist in schema")
-}
-
-func TestDescribe_UnknownPath(t *testing.T) {
-	t.Parallel()
-
-	_, err := Describe(DescribeInput{Path: "unknown.section"})
-	require.Error(t, err)
-	require.Contains(t, err.Error(), "unknown path")
-}
-
-func TestDescribe_FlagsAndExamplesLimitClamp(t *testing.T) {
-	t.Parallel()
-
-	f := false
-	out, err := Describe(DescribeInput{
-		Path:            "$",
-		IncludeSchema:   &f,
-		IncludeFields:   &f,
-		IncludeExamples: &f,
-	})
-	require.NoError(t, err)
-	require.Nil(t, out.Schema)
-	require.Empty(t, out.Fields)
-	require.Empty(t, out.Examples)
-
-	tv := true
-	zero := 0
-	out, err = Describe(DescribeInput{
-		Path:            "$",
-		IncludeExamples: &tv,
-		ExamplesLimit:   &zero,
-	})
-	require.NoError(t, err)
-	require.Len(t, out.Examples, 1)
-}
-
-func TestDescribe_IncludeChildrenToggle(t *testing.T) {
-	t.Parallel()
-
-	f := false
-	withoutChildren, err := Describe(DescribeInput{
-		Path:            "generate",
-		IncludeChildren: &f,
-	})
-	require.NoError(t, err)
-	require.NotContains(t, fieldPaths(withoutChildren.Fields), "generate.inputs[].directory.path")
-
-	withChildren, err := Describe(DescribeInput{
-		Path: "generate",
-	})
-	require.NoError(t, err)
-	require.Contains(t, fieldPaths(withChildren.Fields), "generate.inputs[].directory.path")
-}
-
-func TestDescribe_PathNormalization_GenericArrayIndex(t *testing.T) {
-	t.Parallel()
-
-	out, err := Describe(DescribeInput{Path: "$.generate.inputs[12].git_repo"})
-	require.NoError(t, err)
-	require.Equal(t, "generate.inputs[].git_repo", out.SelectedPath)
-
-	out, err = Describe(DescribeInput{Path: "generate.plugins[99]"})
-	require.NoError(t, err)
-	require.Equal(t, "generate.plugins[]", out.SelectedPath)
-}
-
-func TestDescribe_LintAllowedValuesFromRules(t *testing.T) {
-	t.Parallel()
-
-	out, err := Describe(DescribeInput{Path: "lint"})
-	require.NoError(t, err)
-
-	var lintUse FieldDoc
-	var found bool
-	for _, field := range out.Fields {
-		if field.Path == "lint.use" {
-			lintUse = field
-			found = true
-			break
-		}
-	}
-	require.True(t, found, "lint.use field must be present")
-
-	require.ElementsMatch(t, rules.AllLintUseValues(), lintUse.AllowedValues)
-}
-
-func TestDescribe_OutputSlicesAreIndependent(t *testing.T) {
-	t.Parallel()
-
-	out, err := Describe(DescribeInput{Path: "lint"})
-	require.NoError(t, err)
-	require.NotEmpty(t, out.Examples)
-
-	lintFieldIdx := -1
-	for i := range out.Fields {
-		if out.Fields[i].Path == "lint.use" {
-			lintFieldIdx = i
-			break
-		}
-	}
-	require.NotEqual(t, -1, lintFieldIdx)
-	require.NotEmpty(t, out.Fields[lintFieldIdx].AllowedValues)
-	require.NotEmpty(t, out.Examples[0].Paths)
-
-	firstAllowed := out.Fields[lintFieldIdx].AllowedValues[0]
-	firstExampleTitle := out.Examples[0].Title
-	firstExamplePath := out.Examples[0].Paths[0]
-
-	out.Fields[lintFieldIdx].AllowedValues[0] = "__MUTATED__"
-	out.Examples[0].Paths[0] = "__MUTATED__"
-
-	outAfterMutation, err := Describe(DescribeInput{Path: "lint"})
-	require.NoError(t, err)
-
-	var lintUseAfter FieldDoc
-	found := false
-	for _, field := range outAfterMutation.Fields {
-		if field.Path == "lint.use" {
-			lintUseAfter = field
-			found = true
-			break
-		}
-	}
-	require.True(t, found)
-	require.Equal(t, firstAllowed, lintUseAfter.AllowedValues[0])
-	require.NotEqual(t, "__MUTATED__", lintUseAfter.AllowedValues[0])
-
-	var exampleAfter Example
-	found = false
-	for _, example := range outAfterMutation.Examples {
-		if example.Title == firstExampleTitle {
-			exampleAfter = example
-			found = true
-			break
-		}
-	}
-	require.True(t, found)
-	require.Equal(t, firstExamplePath, exampleAfter.Paths[0])
-	require.NotEqual(t, "__MUTATED__", exampleAfter.Paths[0])
-}
-
-func TestCollectExamples_DeduplicatesByFullExampleContent(t *testing.T) {
-	t.Parallel()
-
-	s := spec{
-		DocsByPath: map[string]nodeDoc{
-			"a": {
-				Examples: []Example{
-					{Title: "same_title", YAML: "x: 1", Paths: []string{"a"}},
-					{Title: "same_title", YAML: "x: 2", Paths: []string{"a"}},
-					{Title: "same_title", YAML: "x: 1", Paths: []string{"a"}},
-				},
-			},
-		},
-	}
-
-	got := s.collectExamples([]string{"a"}, 10)
-	require.Len(t, got, 2)
-	require.Equal(t, "x: 1", got[0].YAML)
-	require.Equal(t, "x: 2", got[1].YAML)
-}
-
-func TestSchemaByPath_GitRepoOutAbsent(t *testing.T) {
-	t.Parallel()
-
-	index := SchemaByPath()
-	node, ok := index["generate.inputs[].git_repo"]
-	require.True(t, ok, "expected schema path generate.inputs[].git_repo")
-
-	props, ok := nestedMap(node, "properties")
-	require.True(t, ok)
-	_, hasOut := props["out"]
-	require.False(t, hasOut)
-}
-
-func TestSchemaByPath_PluginOptsAllowScalarBooleansAndNumbers(t *testing.T) {
-	t.Parallel()
-
-	index := SchemaByPath()
-	node, ok := index["generate.plugins[].opts"]
-	require.True(t, ok, "expected schema path generate.plugins[].opts")
-
-	additionalProperties, ok := nestedMap(node, "additionalProperties")
-	require.True(t, ok, "expected additionalProperties for generate.plugins[].opts")
-
-	topLevelTypes := collectOneOfTypes(t, additionalProperties)
-	require.Contains(t, topLevelTypes, "array")
-
-	arraySchema := findOneOfByType(t, additionalProperties, "array")
-	itemsSchema, ok := nestedMap(arraySchema, "items")
-	require.True(t, ok, "expected items schema for generate.plugins[].opts array")
-	arrayItemTypes := collectOneOfTypes(t, itemsSchema)
-	require.ElementsMatch(t, []string{"string", "number", "boolean"}, arrayItemTypes)
-
-	var scalarTypes []string
-	for _, schema := range oneOfSchemas(t, additionalProperties) {
-		typeName, _ := schema["type"].(string)
-		if typeName != "" {
-			scalarTypes = append(scalarTypes, typeName)
-		}
-	}
-	require.ElementsMatch(t, []string{"string", "number", "boolean", "array"}, scalarTypes)
-}
-
-func TestSchemaByPath_PluginOutOptional(t *testing.T) {
-	t.Parallel()
-
-	index := SchemaByPath()
-	node, ok := index["generate.plugins[]"]
-	require.True(t, ok, "expected schema path generate.plugins[]")
-
-	var required []string
-	requiredRaw, ok := node["required"].([]any)
-	if !ok {
-		requiredRaw = nil
-	}
-
-	for _, item := range requiredRaw {
-		field, ok := item.(string)
-		require.True(t, ok, "expected string required field, got %T", item)
-		required = append(required, field)
-	}
-
-	require.NotContains(t, required, "out")
-}
-
-func TestDescribe_ManagedRulePackageFieldPresent(t *testing.T) {
-	t.Parallel()
-
-	out, err := Describe(DescribeInput{Path: "generate.managed.override"})
-	require.NoError(t, err)
-	require.Contains(t, fieldPaths(out.Fields), "generate.managed.override[].package")
-
-	out, err = Describe(DescribeInput{Path: "generate.managed.disable"})
-	require.NoError(t, err)
-	require.Contains(t, fieldPaths(out.Fields), "generate.managed.disable[].package")
-}
-
-func TestMarshalConfigJSONSchema_Golden(t *testing.T) {
-	t.Parallel()
-
-	got, err := MarshalConfigJSONSchema()
-	require.NoError(t, err)
-
-	goldenPath := filepath.Join("..", "..", "schemas", "easyp-config-v1.schema.json")
-	want, err := os.ReadFile(goldenPath)
-	require.NoError(t, err)
-
-	var gotObj any
-	var wantObj any
-	require.NoError(t, json.Unmarshal(got, &gotObj))
-	require.NoError(t, json.Unmarshal(want, &wantObj))
-	require.Equal(t, wantObj, gotObj)
-}
-
-func TestRegisterTool(t *testing.T) {
-	t.Parallel()
-
-	ctx, cancel := context.WithTimeout(context.Background(), 15*time.Second)
-	defer cancel()
-
-	srv := mcp.NewServer(&mcp.Implementation{Name: "test-server", Version: "v1.0.0"}, nil)
-	RegisterTool(srv)
-
-	mux := http.NewServeMux()
-	mux.Handle("/mcp", mcp.NewStreamableHTTPHandler(func(*http.Request) *mcp.Server {
-		return srv
-	}, &mcp.StreamableHTTPOptions{}))
-
-	httpSrv := httptest.NewServer(mux)
-	defer httpSrv.Close()
-
-	client := mcp.NewClient(&mcp.Implementation{Name: "test-client", Version: "v1.0.0"}, nil)
-	session, err := client.Connect(ctx, &mcp.StreamableClientTransport{Endpoint: httpSrv.URL + "/mcp"}, nil)
-	require.NoError(t, err)
-	defer session.Close()
-
-	tools, err := session.ListTools(ctx, nil)
-	require.NoError(t, err)
-	require.Contains(t, toolNames(tools.Tools), ToolName)
-
-	res, err := session.CallTool(ctx, &mcp.CallToolParams{
-		Name: ToolName,
-		Arguments: map[string]any{
-			"path": "generate.plugins[]",
-		},
-	})
-	require.NoError(t, err)
-	require.False(t, res.IsError)
-
-	var out DescribeOutput
-	decodeStructured(t, res, &out)
-	require.Equal(t, "generate.plugins[]", out.SelectedPath)
-
-	errRes, err := session.CallTool(ctx, &mcp.CallToolParams{
-		Name: ToolName,
-		Arguments: map[string]any{
-			"path": "unknown.section",
-		},
-	})
-	require.NoError(t, err)
-	require.True(t, errRes.IsError)
-	require.Contains(t, toolText(errRes), "unknown path")
-}
-
-func nestedMap(schema map[string]any, key string) (map[string]any, bool) {
-	v, ok := schema[key]
-	if !ok {
-		return nil, false
-	}
-	m, ok := v.(map[string]any)
-	if !ok {
-		return nil, false
-	}
-	return m, true
-}
-
-func fieldPaths(fields []FieldDoc) []string {
-	out := make([]string, 0, len(fields))
-	for _, f := range fields {
-		out = append(out, f.Path)
-	}
-	return out
-}
-
-func toolNames(tools []*mcp.Tool) []string {
-	out := make([]string, 0, len(tools))
-	for _, tool := range tools {
-		out = append(out, tool.Name)
-	}
-	return out
-}
-
-func decodeStructured(t *testing.T, res *mcp.CallToolResult, dst any) {
-	t.Helper()
-
-	data, err := json.Marshal(res.StructuredContent)
-	require.NoError(t, err)
-	require.NoError(t, json.Unmarshal(data, dst))
-}
-
-func oneOfSchemas(t *testing.T, schema map[string]any) []map[string]any {
-	t.Helper()
-
-	raw, ok := schema["oneOf"]
-	require.True(t, ok, "expected oneOf in schema")
-
-	items, ok := raw.([]any)
-	require.True(t, ok, "expected oneOf to be an array")
-
-	out := make([]map[string]any, 0, len(items))
-	for _, item := range items {
-		itemSchema, ok := item.(map[string]any)
-		require.True(t, ok, "expected oneOf item to be an object")
-		out = append(out, itemSchema)
-	}
-
-	return out
-}
-
-func collectOneOfTypes(t *testing.T, schema map[string]any) []string {
-	t.Helper()
-
-	out := make([]string, 0, 4)
-	for _, item := range oneOfSchemas(t, schema) {
-		typeName, _ := item["type"].(string)
-		if typeName != "" {
-			out = append(out, typeName)
-		}
-	}
-
-	return out
-}
-
-func findOneOfByType(t *testing.T, schema map[string]any, wantType string) map[string]any {
-	t.Helper()
-
-	for _, item := range oneOfSchemas(t, schema) {
-		typeName, _ := item["type"].(string)
-		if typeName == wantType {
-			return item
-		}
-	}
-
-	t.Fatalf("expected oneOf branch with type %q", wantType)
-	return nil
-}
-
-func toolText(res *mcp.CallToolResult) string {
-	parts := make([]string, 0, len(res.Content))
-	for _, c := range res.Content {
-		if text, ok := c.(*mcp.TextContent); ok {
-			parts = append(parts, text.Text)
-		}
-	}
-	return strings.Join(parts, "\n")
-}
diff --git a/mcp/easypconfig/generate.go b/mcp/easypconfig/generate.go
deleted file mode 100644
index 37c886d3..00000000
--- a/mcp/easypconfig/generate.go
+++ /dev/null
@@ -1,3 +0,0 @@
-package easypconfig
-
-//go:generate go run ../../cmd/easyp schema-gen --out-versioned ../../schemas/easyp-config-v1.schema.json --out-latest ../../schemas/easyp-config.schema.json
diff --git a/mcp/easypconfig/input_schema.go b/mcp/easypconfig/input_schema.go
new file mode 100644
index 00000000..f2c370eb
--- /dev/null
+++ b/mcp/easypconfig/input_schema.go
@@ -0,0 +1,20 @@
+package easypconfig
+
+import v1 "github.com/easyp-tech/easyp/internal/config/v1"
+
+// describeInputSchema constrains the reference selectors, not filesystem access.
+// The typed handler still validates bounds for direct Go callers.
+func describeInputSchema() map[string]any {
+	return map[string]any{
+		"type": "object", "additionalProperties": false,
+		"properties": map[string]any{
+			"file":             map[string]any{"type": "string", "enum": []string{"", v1.PolicyFile, v1.GenerateFile, v1.ModuleFile, v1.LockFile}, "description": "Known format selector, never a filesystem path. Empty/omitted selects easyp.yaml."},
+			"path":             map[string]any{"type": "string", "description": "Field or directive path. Root is empty or $. Array indices normalize to []."},
+			"include_schema":   map[string]any{"type": "boolean", "description": "Include JSON Schema for YAML or grammar for text; default true."},
+			"include_fields":   map[string]any{"type": "boolean", "description": "Include field or directive documentation; default true."},
+			"include_examples": map[string]any{"type": "boolean", "description": "Include parseable examples; default true."},
+			"include_children": map[string]any{"type": "boolean", "description": "Include descendants of the selected field or directive; default true."},
+			"examples_limit":   map[string]any{"type": "integer", "minimum": 1, "maximum": 50, "description": "Maximum examples, 1 through 50; default 10."},
+		},
+	}
+}
diff --git a/mcp/easypconfig/main_parity_test.go b/mcp/easypconfig/main_parity_test.go
new file mode 100644
index 00000000..3447f8fb
--- /dev/null
+++ b/mcp/easypconfig/main_parity_test.go
@@ -0,0 +1,54 @@
+package easypconfig
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestDescribeFileBreakingCategory(t *testing.T) {
+	t.Parallel()
+	got, err := Describe(DescribeInput{File: v1.PolicyFile, Path: "breaking.categories"})
+	require.NoError(t, err)
+	require.Len(t, got.Fields, 1)
+	assert.Contains(t, got.Fields[0].Description, "FILE")
+	assert.Contains(t, strings.Join(got.Notes, " "), "Omitted or empty categories default to FILE")
+	assert.Equal(t, "array", got.Schema["type"])
+	items, ok := got.Schema["items"].(map[string]any)
+	require.True(t, ok)
+	assert.Equal(t, []any{"FILE", "PACKAGE", "WIRE_JSON", "WIRE"}, items["enum"])
+	require.NotEmpty(t, got.Examples)
+	for _, example := range got.Examples {
+		policy, err := v1.ParsePolicy(strings.NewReader(example.YAML))
+		require.NoError(t, err)
+		cfg, err := policy.BreakingConfig("")
+		require.NoError(t, err)
+		assert.Equal(t, []string{"FILE"}, cfg.Use)
+	}
+}
+
+func TestDescribeRemoteExampleUsesCurrentRegistry(t *testing.T) {
+	t.Parallel()
+	got, err := Describe(DescribeInput{File: v1.GenerateFile, Path: "plugins[].remote"})
+	require.NoError(t, err)
+	require.NotEmpty(t, got.Examples)
+	found := false
+	for _, example := range got.Examples {
+		assert.NotContains(t, example.YAML, "api.easyp.tech")
+		gen, err := v1.ParseGenerate(strings.NewReader(example.YAML))
+		require.NoError(t, err)
+		for _, plugin := range gen.Plugins {
+			if plugin.Remote == "" {
+				continue
+			}
+			found = true
+			assert.Equal(t, "plugins.beta.easyp.tech/protocolbuffers/go", plugin.Remote)
+			assert.Equal(t, "v1.36.11", plugin.Version)
+		}
+	}
+	require.True(t, found, "MCP must provide an executable remote-plugin example")
+}
diff --git a/mcp/easypconfig/module_reference.go b/mcp/easypconfig/module_reference.go
new file mode 100644
index 00000000..73fc36c7
--- /dev/null
+++ b/mcp/easypconfig/module_reference.go
@@ -0,0 +1,103 @@
+package easypconfig
+
+import (
+	"fmt"
+	"sort"
+	"strings"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+// GrammarReference describes textual directives, never an executable config or
+// a substitute JSON Schema for the non-YAML protobuf.mod format.
+type GrammarReference struct {
+	Dialect string   `json:"dialect"`
+	Syntax  []string `json:"syntax"`
+	Notes   []string `json:"notes,omitempty"`
+}
+
+func moduleFields() map[string]FieldDoc {
+	return map[string]FieldDoc{
+		"module":             {Path: "module", Type: "directive", Required: true, Description: "Exactly one module identity. Native v0/v1 share an unsuffixed identity; v2+ uses /vN. Identity does not rewrite proto package or import names."},
+		"roots":              {Path: "roots", Type: "directive", DefaultValue: ".", Description: "One or more module-relative import roots. Absolute paths and paths escaping the module are rejected."},
+		"roots[]":            {Path: "roots[]", Type: "relative-path", Description: "Physical source directory below the manifest directory; the root prefix is removed from proto import names."},
+		"require":            {Path: "require", Type: "directive", Description: "Direct or derived module requirements. Duplicate sources are rejected; versions are declared here, not in generation or extends settings."},
+		"require[]":          {Path: "require[]", Type: "requirement", Description: "Module identity followed by an optional semantic version or full commit."},
+		"require[].module":   {Path: "require[].module", Type: "module-identity", Required: true, Description: "A known Git module identity, including a matching /vN for native v2+. Unknown proto imports do not infer a Git repository."},
+		"require[].version":  {Path: "require[].version", Type: "version-or-commit", Description: "Semantic version, a full 40/64-character hexadecimal commit, or omitted. Versionless first use resolves HEAD; ordinary use retains its lock pin. +incompatible requires verified pre-native published metadata."},
+		"require[].indirect": {Path: "require[].indirect", Type: "comment-marker", Description: "The comment // indirect marks a derived requirement. A direct proto import promotes it; it is not a separate grammar directive or a runtime version constraint."},
+		"replace":            {Path: "replace", Type: "directive", Description: "Main-module local overrides. A replacement does not add a require; duplicate replacement sources are rejected."},
+		"replace[]":          {Path: "replace[]", Type: "replacement", Description: "A required module identity, =>, and an unversioned local directory. Only the main module's replacements apply throughout its graph."},
+		"replace[].module":   {Path: "replace[].module", Type: "module-identity", Required: true, Description: "Exact identity being replaced, including any /vN suffix."},
+		"replace[].target":   {Path: "replace[].target", Type: "local-path", Required: true, Description: "Absolute path or path relative to this manifest. A local overlay can change the effective graph without rewriting published protobuf.lock; --frozen rejects replace."},
+	}
+}
+
+func moduleGrammar(path string) GrammarReference {
+	syntax := []string{"module <identity>", "roots <relative-path> [<relative-path> ...]", "require <module> [<semantic-version-or-full-commit>] [// indirect]", "replace <module> => <local-directory>", "roots (\n    <relative-path>\n)", "require (\n    <module> [<version-or-commit>]\n)", "replace (\n    <module> => <local-directory>\n)"}
+	if path != "$" {
+		directive := strings.Split(strings.TrimSuffix(path, "[]"), ".")[0]
+		directive = strings.TrimSuffix(directive, "[]")
+		selected := make([]string, 0, len(syntax))
+		for _, line := range syntax {
+			if strings.HasPrefix(line, directive+" ") {
+				selected = append(selected, line)
+			}
+		}
+		syntax = selected
+	}
+	return GrammarReference{Dialect: "protobuf.mod/v1", Syntax: syntax, Notes: []string{
+		"Whitespace-delimited, unquoted tokens. One module directive; block entries and closing parentheses occupy separate lines. Inline and nested blocks are rejected.",
+		"BOM, blank lines, and // or # comments at token boundaries are accepted. Environment variables are not expanded by the text manifest parser.",
+		"roots defaults to dot. require and replace reject duplicate source identities. Legacy direct/indirect blocks require explicit easyp migrate; no automatic conversion occurs here.",
+	}}
+}
+
+func describeModule(input DescribeInput) (DescribeOutput, error) {
+	path := normalizePath(input.Path)
+	fields := moduleFields()
+	if _, ok := fields[path]; !ok && path != "$" {
+		return DescribeOutput{}, fmt.Errorf("unknown path %q in %s", input.Path, v1.ModuleFile)
+	}
+	out := DescribeOutput{SchemaVersion: SchemaVersion, File: v1.ModuleFile, SelectedPath: path, Format: "text", Notes: []string{
+		"protobuf.mod is a text manifest, not YAML. No JSON Schema is fabricated; grammar describes its actual directives. This tool returns reference data and never reads the supplied file as a path.",
+		"Module identities, roots and versions remain separate from protobuf package names. Policy extends uses declared, locked modules; exact generate.packages selectors never acquire new dependencies. Buf dependencies inside Git modules use an explicit BSR resolver with fixed compatibility snapshots; direct BSR require directives and repository inference are not supported.",
+	}}
+	if enabled(input.IncludeSchema) {
+		grammar := moduleGrammar(path)
+		out.Grammar = &grammar
+	}
+	if enabled(input.IncludeFields) {
+		paths := make([]string, 0, len(fields))
+		for candidate := range fields {
+			if candidate == path || (enabled(input.IncludeChildren) && within(path, candidate)) {
+				paths = append(paths, candidate)
+			}
+		}
+		sort.Strings(paths)
+		for _, candidate := range paths {
+			out.Fields = append(out.Fields, fields[candidate])
+		}
+	}
+	if enabled(input.IncludeExamples) {
+		out.Examples = selectExamples(v1.ModuleFile, path, exampleLimit(input.ExamplesLimit))
+	}
+	return out, nil
+}
+
+func moduleExamples() []Example {
+	return []Example{
+		{Title: "module_and_roots", Format: "text", Text: "module example.com/acme/contracts\nroots proto\n", Paths: []string{"module", "roots"}},
+		{Title: "versioned_requirements", Format: "text", Text: "module example.com/acme/service\nrequire (\n    example.com/acme/common v1.2.3\n    example.com/acme/types/v2 v2.1.0 // indirect\n)\n", Paths: []string{"require"}},
+		{Title: "explicit_commit", Description: "Synthetic SHA for syntax demonstration; not a fetched revision.", Format: "text", Text: "module example.com/acme/service\nrequire example.com/acme/common 1111111111111111111111111111111111111111\n", Paths: []string{"require[].version"}},
+		{Title: "local_overlay", Description: "The local directory must exist to run commands; it is not included in the published lock.", Format: "text", Text: "module example.com/acme/service\nrequire example.com/acme/common v1.2.3\nreplace example.com/acme/common => ../common\n", Paths: []string{"replace"}},
+	}
+}
+
+func lockExamples() []Example {
+	return []Example{
+		{Title: "empty_lock", YAML: "version: 1\nmodules: []\n", Paths: []string{"version", "modules"}},
+		{Title: "version_pin", Description: "Synthetic revision and content hash; demonstrates the format, not a real downloaded module.", YAML: "version: 1\nmodules:\n  - source: example.com/acme/common\n    version: v1.2.3\n    commit: \"1111111111111111111111111111111111111111\"\n    hash: h1:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=\n", Paths: []string{"modules"}},
+		{Title: "commit_pin", Description: "Synthetic 64-character Git commit; version equals commit. Not fetched content.", YAML: "version: 1\nmodules:\n  - source: example.com/acme/types/v2\n    version: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\n    commit: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\n    hash: h1:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=\n", Paths: []string{"modules[].version", "modules[].commit", "modules[].hash"}},
+	}
+}
diff --git a/mcp/easypconfig/module_reference_test.go b/mcp/easypconfig/module_reference_test.go
new file mode 100644
index 00000000..3b90a723
--- /dev/null
+++ b/mcp/easypconfig/module_reference_test.go
@@ -0,0 +1,204 @@
+package easypconfig
+
+import (
+	"context"
+	"encoding/json"
+	"reflect"
+	"strings"
+	"testing"
+	"time"
+
+	yamlvalidator "github.com/Yakwilik/go-yamlvalidator"
+	"github.com/modelcontextprotocol/go-sdk/mcp"
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
+)
+
+func TestModuleReferenceExamplesAndGrammar(t *testing.T) {
+	t.Parallel()
+	out, err := Describe(DescribeInput{File: v1.ModuleFile})
+	require.NoError(t, err)
+	assert.Equal(t, "text", out.Format)
+	assert.Nil(t, out.Schema)
+	require.NotNil(t, out.Grammar)
+	assert.Equal(t, "protobuf.mod/v1", out.Grammar.Dialect)
+	assert.Contains(t, out.Grammar.Syntax, "module <identity>")
+	assert.Contains(t, fieldPaths(out.Fields), "replace[].target")
+	require.Len(t, out.Examples, 4)
+	for _, example := range out.Examples {
+		assert.Equal(t, "text", example.Format)
+		assert.Empty(t, example.YAML)
+		_, err := v1.ParseModule(strings.NewReader(example.Text))
+		require.NoError(t, err, example.Title)
+		data, err := json.Marshal(example)
+		require.NoError(t, err)
+		assert.NotContains(t, string(data), `"yaml"`)
+	}
+	_, err = SchemaByPathFor(v1.ModuleFile)
+	require.ErrorContains(t, err, "text manifest")
+}
+
+func TestLockReferenceUsesActualSchemaAndValidExamples(t *testing.T) {
+	t.Parallel()
+	out, err := Describe(DescribeInput{File: v1.LockFile})
+	require.NoError(t, err)
+	assert.Equal(t, "yaml", out.Format)
+	assert.Nil(t, out.Grammar)
+	raw, err := v1.SchemaJSON("protobuf.lock")
+	require.NoError(t, err)
+	var schema map[string]any
+	require.NoError(t, json.Unmarshal(raw, &schema))
+	assert.Equal(t, schema, out.Schema)
+	for _, example := range out.Examples {
+		_, err := v1.ParseLock(strings.NewReader(example.YAML))
+		require.NoError(t, err, example.Title)
+		assert.Empty(t, example.Text)
+		compiled, err := yamlvalidator.CompileJSONSchema(raw)
+		require.NoError(t, err)
+		checked := yamlvalidator.NewValidator(compiled).ValidateWithOptions([]byte(example.YAML), yamlvalidator.ValidationContext{StrictKeys: true, StrictTypes: true})
+		assert.Empty(t, checked.Collector.All(), example.Title)
+	}
+	field, err := Describe(DescribeInput{File: v1.LockFile, Path: "$.modules[2].commit"})
+	require.NoError(t, err)
+	require.Len(t, field.Fields, 1)
+	assert.True(t, field.Fields[0].Required)
+	assert.Equal(t, "modules[].commit", field.SelectedPath)
+	assert.Equal(t, "string", field.Fields[0].Type)
+	version, err := Describe(DescribeInput{File: v1.LockFile, Path: "version"})
+	require.NoError(t, err)
+	assert.Equal(t, "integer", version.Fields[0].Type)
+	assert.Equal(t, float64(1), version.Schema["const"])
+}
+
+func TestModuleReferenceSelectionAndFlags(t *testing.T) {
+	t.Parallel()
+	disabled := false
+	for _, tc := range []struct{ path, want string }{
+		{path: "", want: "$"}, {path: "root", want: "$"}, {path: "$.require[12].version", want: "require[].version"}, {path: ".replace[*].target", want: "replace[].target"},
+	} {
+		t.Run(tc.want, func(t *testing.T) {
+			t.Parallel()
+			out, err := Describe(DescribeInput{File: v1.ModuleFile, Path: tc.path})
+			require.NoError(t, err)
+			assert.Equal(t, tc.want, out.SelectedPath)
+			require.NotEmpty(t, out.Grammar.Syntax)
+		})
+	}
+	only, err := Describe(DescribeInput{File: v1.ModuleFile, Path: "require", IncludeChildren: &disabled})
+	require.NoError(t, err)
+	require.Len(t, only.Fields, 1)
+	assert.Equal(t, "require", only.Fields[0].Path)
+	omitted, err := Describe(DescribeInput{File: v1.ModuleFile, IncludeChildren: &disabled, IncludeSchema: &disabled, IncludeFields: &disabled, IncludeExamples: &disabled})
+	require.NoError(t, err)
+	assert.Nil(t, omitted.Grammar)
+	assert.Nil(t, omitted.Schema)
+	assert.Empty(t, omitted.Fields)
+	assert.Empty(t, omitted.Examples)
+	limit := 1
+	limited, err := Describe(DescribeInput{File: v1.ModuleFile, ExamplesLimit: &limit})
+	require.NoError(t, err)
+	assert.Len(t, limited.Examples, 1)
+}
+
+func TestReferenceRejectsInvalidSelectorsAndLimits(t *testing.T) {
+	t.Parallel()
+	for _, file := range []string{v1.PolicyFile, v1.GenerateFile, v1.ModuleFile, v1.LockFile} {
+		t.Run(file, func(t *testing.T) {
+			t.Parallel()
+			for _, limit := range []int{-1, 0, 51} {
+				_, err := Describe(DescribeInput{File: file, ExamplesLimit: &limit})
+				require.ErrorContains(t, err, "examples_limit")
+			}
+			_, err := Describe(DescribeInput{File: file, Path: "unknown.directive"})
+			require.ErrorContains(t, err, "unknown path")
+		})
+	}
+	for _, file := range []string{"../protobuf.lock", "https://example.test/protobuf.mod", "${HOME}/protobuf.mod"} {
+		_, err := Describe(DescribeInput{File: file})
+		require.ErrorContains(t, err, "unknown config file")
+	}
+}
+
+func TestReferenceResultsDoNotShareState(t *testing.T) {
+	t.Parallel()
+	for _, file := range []string{v1.ModuleFile, v1.LockFile, v1.PolicyFile, v1.GenerateFile} {
+		t.Run(file, func(t *testing.T) {
+			t.Parallel()
+			before, err := Describe(DescribeInput{File: file})
+			require.NoError(t, err)
+			changed, err := Describe(DescribeInput{File: file})
+			require.NoError(t, err)
+			for i := range changed.Fields {
+				changed.Fields[i].Description = "changed"
+			}
+			for i := range changed.Examples {
+				changed.Examples[i].Text = "changed"
+				changed.Examples[i].YAML = "changed"
+				for j := range changed.Examples[i].Paths {
+					changed.Examples[i].Paths[j] = "changed"
+				}
+			}
+			for i := range changed.Notes {
+				changed.Notes[i] = "changed"
+			}
+			if changed.Grammar != nil {
+				changed.Grammar.Syntax[0] = "changed"
+				changed.Grammar.Notes[0] = "changed"
+			}
+			if changed.Schema != nil {
+				changed.Schema["properties"].(map[string]any)["new"] = true
+			}
+			again, err := Describe(DescribeInput{File: file})
+			require.NoError(t, err)
+			assert.Equal(t, before, again)
+		})
+	}
+}
+
+func TestMCPInputSchemaMatchesTypedArguments(t *testing.T) {
+	t.Parallel()
+	properties := describeInputSchema()["properties"].(map[string]any)
+	typ := reflect.TypeFor[DescribeInput]()
+	assert.Len(t, properties, typ.NumField())
+	for i := range typ.NumField() {
+		name := strings.Split(typ.Field(i).Tag.Get("json"), ",")[0]
+		assert.Contains(t, properties, name)
+	}
+}
+
+func TestModuleReferenceActualMCPRegistration(t *testing.T) {
+	t.Parallel()
+	ctx, cancel := context.WithTimeout(t.Context(), 10*time.Second)
+	defer cancel()
+	server := mcp.NewServer(&mcp.Implementation{Name: "reference-test", Version: "v1"}, nil)
+	RegisterTool(server)
+	serverTransport, clientTransport := mcp.NewInMemoryTransports()
+	ss, err := server.Connect(ctx, serverTransport, nil)
+	require.NoError(t, err)
+	defer func() { require.NoError(t, ss.Close()) }()
+	client := mcp.NewClient(&mcp.Implementation{Name: "reference-client", Version: "v1"}, nil)
+	cs, err := client.Connect(ctx, clientTransport, nil)
+	require.NoError(t, err)
+	defer func() { require.NoError(t, cs.Close()) }()
+	listed, err := cs.ListTools(ctx, nil)
+	require.NoError(t, err)
+	require.Len(t, listed.Tools, 1)
+	raw, err := json.Marshal(listed.Tools[0].InputSchema)
+	require.NoError(t, err)
+	for _, file := range []string{v1.PolicyFile, v1.GenerateFile, v1.ModuleFile, v1.LockFile} {
+		assert.Contains(t, string(raw), file)
+	}
+	for _, file := range []string{v1.ModuleFile, v1.LockFile} {
+		out, err := cs.CallTool(ctx, &mcp.CallToolParams{Name: ToolName, Arguments: map[string]any{"file": file}})
+		require.NoError(t, err)
+		require.False(t, out.IsError, "%+v", out.Content)
+		require.NotNil(t, out.StructuredContent)
+	}
+	for _, args := range []map[string]any{{"file": "/tmp/protobuf.mod"}, {"file": v1.ModuleFile, "path": "module.unknown"}, {"examples_limit": 0}, {"examples_limit": 51}, {"unexpected": true}} {
+		out, err := cs.CallTool(ctx, &mcp.CallToolParams{Name: ToolName, Arguments: args})
+		require.NoError(t, err)
+		assert.True(t, out.IsError)
+	}
+}
diff --git a/mcp/easypconfig/schema.go b/mcp/easypconfig/schema.go
index 24e49ea8..7109d6c6 100644
--- a/mcp/easypconfig/schema.go
+++ b/mcp/easypconfig/schema.go
@@ -2,170 +2,98 @@ package easypconfig
 
 import (
 	"encoding/json"
+	"fmt"
 	"sort"
-	"sync"
 
-	invjsonschema "github.com/invopop/jsonschema"
+	v1 "github.com/easyp-tech/easyp/internal/config/v1"
 )
 
-var (
-	schemaCacheOnce sync.Once
-	cachedByPath    map[string]map[string]any
-)
-
-func SchemaByPath() map[string]map[string]any {
-	ensureSchemaCache()
-	return cloneSchemaByPath(cachedByPath)
-}
-
+// MarshalConfigJSONSchema returns the v1 easyp.yaml schema.
 func MarshalConfigJSONSchema() ([]byte, error) {
-	schema := reflectConfigSchema()
-	return json.MarshalIndent(schema, "", "  ")
-}
-
-func ensureSchemaCache() {
-	schemaCacheOnce.Do(func() {
-		root := buildRootSchemaMap()
-		cachedByPath = buildSchemaByPath(root)
-	})
+	return v1.SchemaJSON("easyp")
 }
 
-func buildRootSchemaMap() map[string]any {
-	root := invSchemaToMap(reflectConfigSchema())
-	if len(root) == 0 {
-		return map[string]any{}
+// SchemaByPath returns independently owned easyp.yaml schema fragments.
+func SchemaByPath() map[string]map[string]any {
+	index, err := SchemaByPathFor(v1.PolicyFile)
+	if err != nil {
+		return nil
 	}
-	return root
+	return index
 }
 
-func reflectConfigSchema() *invjsonschema.Schema {
-	reflector := &invjsonschema.Reflector{
-		Anonymous:      true,
-		DoNotReference: true,
+// SchemaByPathFor indexes the JSON Schema of a v1 EasyP YAML configuration file.
+func SchemaByPathFor(file string) (map[string]map[string]any, error) {
+	_, schemaName, err := configFile(file)
+	if err != nil {
+		return nil, err
 	}
-	return reflector.Reflect(configSchemaRoot{})
-}
-
-func buildSchemaByPath(root map[string]any) map[string]map[string]any {
-	if len(root) == 0 {
-		return map[string]map[string]any{}
+	if schemaName == "" {
+		return nil, fmt.Errorf("%s is a text manifest, not a JSON Schema document; use Describe for its grammar", file)
 	}
-
-	index := map[string]map[string]any{
-		"$": root,
+	raw, err := v1.SchemaJSON(schemaName)
+	if err != nil {
+		return nil, fmt.Errorf("SchemaJSON: %w", err)
 	}
-	walkSchemaPaths(index, "$", root)
-	return index
+	var root map[string]any
+	if err := json.Unmarshal(raw, &root); err != nil {
+		return nil, fmt.Errorf("Unmarshal: %w", err)
+	}
+	index := map[string]map[string]any{"$": root}
+	indexSchema(index, "$", root)
+	return index, nil
 }
 
-func walkSchemaPaths(index map[string]map[string]any, basePath string, schema map[string]any) {
-	for _, key := range []string{"allOf", "anyOf", "oneOf"} {
-		branches, ok := asSchemaArray(schema[key])
-		if !ok {
-			continue
-		}
-		for _, branch := range branches {
-			walkSchemaPaths(index, basePath, branch)
-		}
+func configFile(file string) (string, string, error) {
+	switch file {
+	case "", v1.PolicyFile:
+		return v1.PolicyFile, "easyp", nil
+	case v1.GenerateFile:
+		return v1.GenerateFile, "easyp.gen", nil
+	case v1.LockFile:
+		return v1.LockFile, "protobuf.lock", nil
+	case v1.ModuleFile:
+		return v1.ModuleFile, "", nil
+	default:
+		return "", "", fmt.Errorf("unknown config file %q", file)
 	}
+}
 
-	props, ok := asSchemaMap(schema["properties"])
+func indexSchema(index map[string]map[string]any, base string, schema map[string]any) {
+	properties, ok := schema["properties"].(map[string]any)
 	if ok {
-		names := make([]string, 0, len(props))
-		for name := range props {
+		names := make([]string, 0, len(properties))
+		for name := range properties {
 			names = append(names, name)
 		}
 		sort.Strings(names)
-
 		for _, name := range names {
-			child, ok := asSchemaMap(props[name])
+			child, ok := properties[name].(map[string]any)
 			if !ok {
 				continue
 			}
-			childPath := joinSchemaPath(basePath, name)
-			if _, exists := index[childPath]; !exists {
-				index[childPath] = child
+			path := name
+			if base != "$" {
+				path = base + "." + name
 			}
-			walkSchemaPaths(index, childPath, child)
+			index[path] = child
+			indexSchema(index, path, child)
 		}
 	}
-
-	if items, ok := asSchemaMap(schema["items"]); ok {
-		arrayPath := basePath + "[]"
-		if _, exists := index[arrayPath]; !exists {
-			index[arrayPath] = items
-		}
-		walkSchemaPaths(index, arrayPath, items)
-	}
-}
-
-func joinSchemaPath(base, child string) string {
-	if base == "$" {
-		return child
-	}
-	return base + "." + child
-}
-
-func asSchemaArray(v any) ([]map[string]any, bool) {
-	arr, ok := v.([]any)
-	if !ok {
-		return nil, false
+	if item, ok := schema["items"].(map[string]any); ok {
+		path := base + "[]"
+		index[path] = item
+		indexSchema(index, path, item)
 	}
-	out := make([]map[string]any, 0, len(arr))
-	for _, item := range arr {
-		m, ok := asSchemaMap(item)
+	for _, keyword := range []string{"oneOf", "anyOf", "allOf"} {
+		branches, ok := schema[keyword].([]any)
 		if !ok {
 			continue
 		}
-		out = append(out, m)
-	}
-	if len(out) == 0 {
-		return nil, false
-	}
-	return out, true
-}
-
-func asSchemaMap(v any) (map[string]any, bool) {
-	m, ok := v.(map[string]any)
-	if !ok {
-		return nil, false
-	}
-	return m, true
-}
-
-func invSchemaToMap(schema *invjsonschema.Schema) map[string]any {
-	if schema == nil {
-		return nil
-	}
-
-	data, err := json.Marshal(schema)
-	if err != nil {
-		return map[string]any{}
-	}
-
-	var out map[string]any
-	if err := json.Unmarshal(data, &out); err != nil {
-		return map[string]any{}
-	}
-	return out
-}
-
-func cloneSchemaMap(in map[string]any) map[string]any {
-	return cloneJSON(in, map[string]any{})
-}
-
-func cloneSchemaByPath(in map[string]map[string]any) map[string]map[string]any {
-	return cloneJSON(in, map[string]map[string]any{})
-}
-
-func cloneJSON[T any](in T, fallback T) T {
-	data, err := json.Marshal(in)
-	if err != nil {
-		return fallback
-	}
-	var out T
-	if err := json.Unmarshal(data, &out); err != nil {
-		return fallback
+		for _, branch := range branches {
+			if child, ok := branch.(map[string]any); ok {
+				indexSchema(index, base, child)
+			}
+		}
 	}
-	return out
 }
diff --git a/mcp/easypconfig/schema_model.go b/mcp/easypconfig/schema_model.go
deleted file mode 100644
index b03ecd6e..00000000
--- a/mcp/easypconfig/schema_model.go
+++ /dev/null
@@ -1,190 +0,0 @@
-package easypconfig
-
-import invjsonschema "github.com/invopop/jsonschema"
-
-type configSchemaRoot struct {
-	Version  string                `json:"version,omitempty"`
-	Lint     *configSchemaLint     `json:"lint,omitempty"`
-	Deps     []string              `json:"deps,omitempty"`
-	Generate *configSchemaGenerate `json:"generate,omitempty"`
-	Breaking *configSchemaBreaking `json:"breaking,omitempty"`
-}
-
-type configSchemaLint struct {
-	Use                 []string            `json:"use,omitempty"`
-	EnumZeroValueSuffix string              `json:"enum_zero_value_suffix,omitempty"`
-	ServiceSuffix       string              `json:"service_suffix,omitempty"`
-	Ignore              []string            `json:"ignore,omitempty"`
-	Except              []string            `json:"except,omitempty"`
-	AllowCommentIgnores bool                `json:"allow_comment_ignores,omitempty"`
-	IgnoreOnly          map[string][]string `json:"ignore_only,omitempty"`
-}
-
-type configSchemaGenerate struct {
-	Inputs  []configSchemaInput  `json:"inputs"`
-	Plugins []configSchemaPlugin `json:"plugins"`
-	Managed *configSchemaManaged `json:"managed,omitempty"`
-}
-
-func (configSchemaGenerate) JSONSchemaExtend(schema *invjsonschema.Schema) {
-	setMinItems(schema, "inputs", 1)
-	setMinItems(schema, "plugins", 1)
-}
-
-type configSchemaInput struct {
-	Directory configSchemaInputDirectory `json:"directory,omitempty"`
-	GitRepo   *configSchemaInputGitRepo  `json:"git_repo,omitempty"`
-}
-
-func (configSchemaInput) JSONSchemaExtend(schema *invjsonschema.Schema) {
-	schema.OneOf = []*invjsonschema.Schema{
-		{Required: []string{"directory"}},
-		{Required: []string{"git_repo"}},
-	}
-}
-
-type configSchemaInputDirectory struct{}
-
-func (configSchemaInputDirectory) JSONSchema() *invjsonschema.Schema {
-	reflector := &invjsonschema.Reflector{
-		Anonymous:      true,
-		DoNotReference: true,
-	}
-	objectSchema := reflector.Reflect(configSchemaInputDirectoryObject{})
-	objectSchema.Version = ""
-	objectSchema.ID = ""
-	objectSchema.Definitions = nil
-	objectSchema.Title = ""
-
-	return &invjsonschema.Schema{
-		OneOf: []*invjsonschema.Schema{
-			{Type: "string"},
-			objectSchema,
-		},
-	}
-}
-
-type configSchemaInputDirectoryObject struct {
-	Path string `json:"path"`
-	Root string `json:"root,omitempty"`
-}
-
-type configSchemaInputGitRepo struct {
-	URL          string `json:"url"`
-	SubDirectory string `json:"sub_directory,omitempty"`
-	Root         string `json:"root,omitempty"`
-}
-
-type configSchemaPlugin struct {
-	Name        string                 `json:"name,omitempty"`
-	Remote      string                 `json:"remote,omitempty"`
-	Path        string                 `json:"path,omitempty"`
-	Command     []string               `json:"command,omitempty"`
-	Out         string                 `json:"out,omitempty"`
-	Opts        configSchemaPluginOpts `json:"opts,omitempty"`
-	WithImports bool                   `json:"with_imports,omitempty"`
-}
-
-func (configSchemaPlugin) JSONSchemaExtend(schema *invjsonschema.Schema) {
-	schema.OneOf = []*invjsonschema.Schema{
-		{Required: []string{"name"}},
-		{Required: []string{"remote"}},
-		{Required: []string{"path"}},
-		{Required: []string{"command"}},
-	}
-}
-
-type configSchemaPluginOpts map[string]any
-
-func (configSchemaPluginOpts) JSONSchema() *invjsonschema.Schema {
-	return &invjsonschema.Schema{
-		Type: "object",
-		AdditionalProperties: &invjsonschema.Schema{
-			OneOf: []*invjsonschema.Schema{
-				{Type: "string"},
-				{Type: "number"},
-				{Type: "boolean"},
-				{
-					Type: "array",
-					Items: &invjsonschema.Schema{
-						OneOf: []*invjsonschema.Schema{
-							{Type: "string"},
-							{Type: "number"},
-							{Type: "boolean"},
-						},
-					},
-				},
-			},
-		},
-	}
-}
-
-type configSchemaManaged struct {
-	Enabled  bool                              `json:"enabled,omitempty"`
-	Disable  []configSchemaManagedDisableRule  `json:"disable,omitempty"`
-	Override []configSchemaManagedOverrideRule `json:"override,omitempty"`
-}
-
-type configSchemaManagedDisableRule struct {
-	Module      string `json:"module,omitempty"`
-	Package     string `json:"package,omitempty"`
-	Path        string `json:"path,omitempty"`
-	FileOption  string `json:"file_option,omitempty"`
-	FieldOption string `json:"field_option,omitempty"`
-	Field       string `json:"field,omitempty"`
-}
-
-func (configSchemaManagedDisableRule) JSONSchemaExtend(schema *invjsonschema.Schema) {
-	schema.AnyOf = []*invjsonschema.Schema{
-		{Required: []string{"module"}},
-		{Required: []string{"package"}},
-		{Required: []string{"path"}},
-		{Required: []string{"file_option"}},
-		{Required: []string{"field_option"}},
-		{Required: []string{"field"}},
-	}
-	schema.Not = &invjsonschema.Schema{Required: []string{"file_option", "field_option"}}
-	schema.DependentRequired = map[string][]string{
-		"field": {"field_option"},
-	}
-}
-
-type configSchemaManagedOverrideRule struct {
-	FileOption  string `json:"file_option,omitempty"`
-	FieldOption string `json:"field_option,omitempty"`
-	Value       any    `json:"value"`
-	Module      string `json:"module,omitempty"`
-	Package     string `json:"package,omitempty"`
-	Path        string `json:"path,omitempty"`
-	Field       string `json:"field,omitempty"`
-}
-
-func (configSchemaManagedOverrideRule) JSONSchemaExtend(schema *invjsonschema.Schema) {
-	schema.AnyOf = []*invjsonschema.Schema{
-		{Required: []string{"file_option"}},
-		{Required: []string{"field_option"}},
-	}
-	schema.Not = &invjsonschema.Schema{Required: []string{"file_option", "field_option"}}
-	schema.DependentRequired = map[string][]string{
-		"field": {"field_option"},
-	}
-}
-
-type configSchemaBreaking struct {
-	Ignore        []string `json:"ignore,omitempty"`
-	AgainstGitRef string   `json:"against_git_ref,omitempty"`
-	Use           []string `json:"use,omitempty"`
-}
-
-func setMinItems(schema *invjsonschema.Schema, fieldName string, min uint64) {
-	if schema == nil || schema.Properties == nil {
-		return
-	}
-
-	itemSchema, ok := schema.Properties.Get(fieldName)
-	if !ok || itemSchema == nil {
-		return
-	}
-
-	itemSchema.MinItems = &min
-}
diff --git a/mcp/easypconfig/spec_docs.go b/mcp/easypconfig/spec_docs.go
deleted file mode 100644
index 0e575e78..00000000
--- a/mcp/easypconfig/spec_docs.go
+++ /dev/null
@@ -1,286 +0,0 @@
-package easypconfig
-
-func docsByPath() map[string]nodeDoc {
-	return map[string]nodeDoc{
-		"$": {
-			Fields: []FieldDoc{
-				{Path: "version", Type: "string", Required: false, Description: "Legacy compatibility field.", DefaultValue: "omitted", Examples: []string{"v1alpha"}},
-				{Path: "lint", Type: "object", Required: false, Description: "Linter configuration and rule selection."},
-				{Path: "deps", Type: "array<string>", Required: false, Description: "Dependency repositories in format <repo>@<version>."},
-				{Path: "generate", Type: "object", Required: false, Description: "Code generation configuration."},
-				{Path: "breaking", Type: "object", Required: false, Description: "Breaking changes check configuration."},
-			},
-			Examples: []Example{
-				{
-					Title:       "minimal_config",
-					Description: "Small valid configuration with local input and one plugin.",
-					YAML:        "lint:\n  use:\n    - DIRECTORY_SAME_PACKAGE\ngenerate:\n  inputs:\n    - directory: proto\n  plugins:\n    - name: go\n      out: .\n      opts:\n        paths: source_relative\n",
-					Paths:       []string{"$", "lint", "generate"},
-				},
-				{
-					Title:       "full_config_reference",
-					Description: "Reference config touching all top-level sections.",
-					YAML:        "version: v1alpha\nlint:\n  use:\n    - DEFAULT\n  enum_zero_value_suffix: _UNSPECIFIED\n  service_suffix: Service\n  ignore:\n    - vendor\n  ignore_only:\n    RPC_REQUEST_STANDARD_NAME:\n      - proto/legacy\ndeps:\n  - github.com/googleapis/googleapis@common-protos-1_3_1\ngenerate:\n  inputs:\n    - directory:\n        path: api\n        root: .\n    - git_repo:\n        url: github.com/acme/contracts@v1.2.3\n        sub_directory: proto\n        root: .\n  plugins:\n    - name: go\n      out: gen/go\n      opts:\n        paths: source_relative\n    - remote: plugins.beta.easyp.tech/grpc/go:v1.5.1\n      out: gen/go\n      with_imports: true\n  managed:\n    enabled: true\n    disable:\n      - module: github.com/googleapis/googleapis\n    override:\n      - file_option: go_package_prefix\n        value: github.com/acme/contracts/gen/go\nbreaking:\n  against_git_ref: main\n  ignore:\n    - proto/legacy\n",
-					Paths:       []string{"$", "lint", "deps", "generate", "breaking"},
-				},
-			},
-		},
-		"lint": {
-			Fields: []FieldDoc{
-				{Path: "lint.use", Type: "array<string>", Required: false, Description: "Rule groups and/or individual lint rule names.", AllowedValues: lintUseAllowedValues(), DefaultValue: "[]"},
-				{Path: "lint.enum_zero_value_suffix", Type: "string", Required: false, Description: "Required suffix for enum zero value.", DefaultValue: "UNSPECIFIED (runtime default)"},
-				{Path: "lint.service_suffix", Type: "string", Required: false, Description: "Required suffix for service names.", DefaultValue: "Service (runtime default)"},
-				{Path: "lint.ignore", Type: "array<string>", Required: false, Description: "Paths to exclude from linting.", DefaultValue: "[]"},
-				{Path: "lint.except", Type: "array<string>", Required: false, Description: "Rules to disable globally.", DefaultValue: "[]"},
-				{Path: "lint.allow_comment_ignores", Type: "boolean", Required: false, Description: "Allow inline ignore comments in proto files.", DefaultValue: "false"},
-				{Path: "lint.ignore_only", Type: "map<string, array<string>>", Required: false, Description: "Disable specific rules only for selected paths.", DefaultValue: "{}"},
-			},
-			Examples: []Example{
-				{
-					Title:       "lint_groups_and_exceptions",
-					Description: "Rule groups with selected exceptions and comment ignores enabled.",
-					YAML:        "lint:\n  use:\n    - DEFAULT\n    - RPC_NO_CLIENT_STREAMING\n  except:\n    - COMMENT_RPC\n    - COMMENT_SERVICE\n  allow_comment_ignores: true\n",
-					Paths:       []string{"lint"},
-				},
-				{
-					Title:       "lint_ignore_only_rules",
-					Description: "Disable specific rules only for selected paths.",
-					YAML:        "lint:\n  use:\n    - DEFAULT\n  ignore_only:\n    PACKAGE_VERSION_SUFFIX:\n      - proto/legacy\n    RPC_REQUEST_STANDARD_NAME:\n      - proto/public\n",
-					Paths:       []string{"lint"},
-				},
-			},
-		},
-		"deps": {
-			Fields: []FieldDoc{
-				{Path: "deps[]", Type: "string", Required: false, Description: "Dependency in format <repo>@<version>.", Examples: []string{"github.com/googleapis/googleapis@v1.0.0", "github.com/bufbuild/protoc-gen-validate"}},
-			},
-			Examples: []Example{
-				{
-					Title:       "deps_with_and_without_revision",
-					Description: "Dependencies can be pinned or float to repository default revision.",
-					YAML:        "deps:\n  - github.com/googleapis/googleapis@common-protos-1_3_1\n  - github.com/bufbuild/protoc-gen-validate\n",
-					Paths:       []string{"deps"},
-				},
-			},
-		},
-		"generate": {
-			Fields: []FieldDoc{
-				{Path: "generate.inputs", Type: "array<object>", Required: true, Description: "Input sources for proto files.", DefaultValue: "must be provided"},
-				{Path: "generate.plugins", Type: "array<object>", Required: true, Description: "Plugin definitions for generation.", DefaultValue: "must be provided"},
-				{Path: "generate.managed", Type: "object", Required: false, Description: "Managed mode rules for file/field options.", DefaultValue: "{}"},
-			},
-			Examples: []Example{
-				{
-					Title:       "generate_local_and_remote_plugin",
-					Description: "Local directory input with remote plugin execution.",
-					YAML:        "generate:\n  inputs:\n    - directory:\n        path: api\n        root: .\n  plugins:\n    - remote: plugins.beta.easyp.tech/protocolbuffers/go:v1.36.10\n      out: .\n      opts:\n        paths: source_relative\n",
-					Paths:       []string{"generate", "generate.inputs", "generate.plugins"},
-				},
-				{
-					Title:       "generate_all_sections",
-					Description: "Generate section with local+git inputs, multiple plugin styles, and managed mode.",
-					YAML:        "generate:\n  inputs:\n    - directory: proto\n    - git_repo:\n        url: github.com/acme/contracts@v1.2.3\n        sub_directory: api\n  plugins:\n    - name: go\n      out: gen/go\n    - command: [\"go\", \"run\", \"example.com/protoc-gen-custom@latest\"]\n      out: gen/custom\n      with_imports: true\n  managed:\n    enabled: true\n    disable:\n      - module: github.com/googleapis/googleapis\n    override:\n      - file_option: go_package_prefix\n        value: github.com/acme/contracts/gen/go\n",
-					Paths:       []string{"generate", "generate.inputs", "generate.plugins", "generate.managed"},
-				},
-			},
-		},
-		"generate.inputs": {
-			Fields: []FieldDoc{
-				{Path: "generate.inputs[].directory", Type: "string | object", Required: false, Description: "Local input directory. Shorthand string or object with path/root."},
-				{Path: "generate.inputs[].git_repo", Type: "object", Required: false, Description: "Remote git repository input."},
-			},
-			Examples: []Example{
-				{
-					Title:       "inputs_directory_and_git_repo",
-					Description: "Each item uses exactly one source: directory or git_repo.",
-					YAML:        "generate:\n  inputs:\n    - directory: proto\n    - git_repo:\n        url: github.com/acme/contracts@v1.0.0\n        sub_directory: api\n  plugins:\n    - name: go\n      out: .\n",
-					Paths:       []string{"generate.inputs"},
-				},
-			},
-			Notes: []string{
-				"Each input item must contain exactly one of `directory` or `git_repo`.",
-			},
-		},
-		"generate.inputs[].directory": {
-			Fields: []FieldDoc{
-				{Path: "generate.inputs[].directory.path", Type: "string", Required: true, Description: "Directory with .proto files (relative to config root unless absolute).", Examples: []string{"proto", "api/proto"}},
-				{Path: "generate.inputs[].directory.root", Type: "string", Required: false, Description: "Import root for path normalization.", DefaultValue: "."},
-			},
-			Examples: []Example{
-				{
-					Title:       "input_directory_shorthand",
-					Description: "Shorthand string form for directory input.",
-					YAML:        "generate:\n  inputs:\n    - directory: proto\n  plugins:\n    - name: go\n      out: .\n",
-					Paths:       []string{"generate.inputs[].directory"},
-				},
-				{
-					Title:       "input_directory_object_with_root",
-					Description: "Object form with explicit path and root.",
-					YAML:        "generate:\n  inputs:\n    - directory:\n        path: api/proto\n        root: api\n  plugins:\n    - name: go\n      out: .\n",
-					Paths:       []string{"generate.inputs[].directory"},
-				},
-			},
-		},
-		"generate.inputs[].git_repo": {
-			Fields: []FieldDoc{
-				{Path: "generate.inputs[].git_repo.url", Type: "string", Required: true, Description: "Git repo URL with optional revision.", Examples: []string{"github.com/acme/common@v1.0.0"}},
-				{Path: "generate.inputs[].git_repo.sub_directory", Type: "string", Required: false, Description: "Subdirectory inside checked-out repository."},
-				{Path: "generate.inputs[].git_repo.root", Type: "string", Required: false, Description: "Import root under repository contents.", DefaultValue: "\"\""},
-			},
-			Examples: []Example{
-				{
-					Title:       "input_git_repo_full",
-					Description: "Git input with revision, subdirectory and import root.",
-					YAML:        "generate:\n  inputs:\n    - git_repo:\n        url: github.com/acme/contracts@v1.3.0\n        sub_directory: proto/public\n        root: proto\n  plugins:\n    - name: go\n      out: .\n",
-					Paths:       []string{"generate.inputs[].git_repo"},
-				},
-			},
-		},
-		"generate.plugins": {
-			Fields: []FieldDoc{
-				{Path: "generate.plugins[]", Type: "object", Required: true, Description: "Plugin item with exactly one source and optional output directory."},
-			},
-			Examples: []Example{
-				{
-					Title:       "plugins_all_source_variants",
-					Description: "Plugins can use name, remote, path, or command as a source.",
-					YAML:        "generate:\n  plugins:\n    - name: go\n      out: gen/go\n    - remote: plugins.beta.easyp.tech/protocolbuffers/go:v1.36.10\n      out: gen/go\n    - path: ./bin/protoc-gen-custom\n      out: gen/custom\n    - command: [\"go\", \"run\", \"example.com/protoc-gen-alt@latest\"]\n      out: gen/alt\n",
-					Paths:       []string{"generate.plugins"},
-				},
-			},
-		},
-		"generate.plugins[]": {
-			Fields: []FieldDoc{
-				{Path: "generate.plugins[].name", Type: "string", Required: false, Description: "Built-in/local plugin name (one source option).", Examples: []string{"go", "go-grpc"}},
-				{Path: "generate.plugins[].remote", Type: "string", Required: false, Description: "Remote plugin endpoint (one source option).", Examples: []string{"plugins.beta.easyp.tech/protocolbuffers/go:v1.36.10"}},
-				{Path: "generate.plugins[].path", Type: "string", Required: false, Description: "Explicit path to plugin binary (one source option)."},
-				{Path: "generate.plugins[].command", Type: "array<string>", Required: false, Description: "Command invocation for plugin (one source option).", Examples: []string{`["go","run","github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.25.1"]`}},
-				{Path: "generate.plugins[].out", Type: "string", Required: false, Description: "Output directory for generated files.", DefaultValue: "\"\" (resolved generate root)", Examples: []string{".", "gen/go"}},
-				{Path: "generate.plugins[].opts", Type: "map<string, string | number | boolean | array<string | number | boolean>>", Required: false, Description: "Plugin options; value can be scalar or array of scalars."},
-				{Path: "generate.plugins[].with_imports", Type: "boolean", Required: false, Description: "Include dependency protos in generation.", DefaultValue: "false"},
-			},
-			Examples: []Example{
-				{
-					Title:       "plugin_remote",
-					Description: "Remote plugin source.",
-					YAML:        "generate:\n  plugins:\n    - remote: plugins.beta.easyp.tech/grpc/go:v1.5.1\n      out: .\n      opts:\n        paths: source_relative\n",
-					Paths:       []string{"generate.plugins[]"},
-				},
-				{
-					Title:       "plugin_command",
-					Description: "Command-based plugin source.",
-					YAML:        "generate:\n  plugins:\n    - command: [\"go\", \"run\", \"github.com/bufbuild/protoc-gen-validate@v0.10.1\"]\n      out: gen/go\n",
-					Paths:       []string{"generate.plugins[]"},
-				},
-				{
-					Title:       "plugin_name",
-					Description: "Built-in plugin selected by name.",
-					YAML:        "generate:\n  plugins:\n    - name: go-grpc\n      out: gen/go\n",
-					Paths:       []string{"generate.plugins[]"},
-				},
-				{
-					Title:       "plugin_path",
-					Description: "Plugin binary loaded from explicit local path.",
-					YAML:        "generate:\n  plugins:\n    - path: ./bin/protoc-gen-openapi\n      out: gen/openapi\n",
-					Paths:       []string{"generate.plugins[]"},
-				},
-				{
-					Title:       "plugin_opts_scalar_and_array",
-					Description: "Plugin opts values can be scalar or arrays of scalars.",
-					YAML:        "generate:\n  plugins:\n    - remote: plugins.beta.easyp.tech/community/stephenh-ts-proto:v1.178.0\n      out: gen/ts\n      opts:\n        env: node\n        outputServices:\n          - grpc-js\n          - generic-definitions\n        useExactTypes: false\n",
-					Paths:       []string{"generate.plugins[]"},
-				},
-				{
-					Title:       "plugin_with_imports_enabled",
-					Description: "Enable generation for dependency protos as well.",
-					YAML:        "generate:\n  plugins:\n    - name: go\n      out: gen/go\n      with_imports: true\n",
-					Paths:       []string{"generate.plugins[]"},
-				},
-			},
-		},
-		"generate.managed": {
-			Fields: []FieldDoc{
-				{Path: "generate.managed.enabled", Type: "boolean", Required: false, Description: "Enable managed mode option rewriting.", DefaultValue: "false"},
-				{Path: "generate.managed.disable", Type: "array<object>", Required: false, Description: "Disable managed mode for matching modules, protobuf packages, paths, or options."},
-				{Path: "generate.managed.override", Type: "array<object>", Required: false, Description: "Override file/field options with values. Without module/package/path, applies to all files."},
-			},
-			Examples: []Example{
-				{
-					Title:       "managed_mode_full",
-					Description: "Managed mode with both disable and override rules.",
-					YAML:        "generate:\n  managed:\n    enabled: true\n    disable:\n      - module: github.com/googleapis/googleapis\n      - package: acme.v1\n        file_option: java_package_prefix\n      - field_option: jstype\n        field: acme.v1.Message.count\n    override:\n      - file_option: go_package_prefix\n        value: github.com/acme/contracts/gen/go\n      - file_option: go_package\n        package: acme.v1\n        value: github.com/acme/contracts/gen/go/acme/v1\n      - field_option: jstype\n        field: acme.v1.Message.count\n        value: JS_STRING\n",
-					Paths:       []string{"generate.managed"},
-				},
-			},
-		},
-		"generate.managed.disable": {
-			Fields: []FieldDoc{
-				{Path: "generate.managed.disable[].module", Type: "string", Required: false, Description: "Apply disable to an exact EasyP module source (dependency/git_repo URL without @version)."},
-				{Path: "generate.managed.disable[].package", Type: "string", Required: false, Description: "Apply disable to an exact protobuf package from the .proto file package declaration."},
-				{Path: "generate.managed.disable[].path", Type: "string", Required: false, Description: "Apply disable to path."},
-				{Path: "generate.managed.disable[].file_option", Type: "string", Required: false, Description: "Disable this file option."},
-				{Path: "generate.managed.disable[].field_option", Type: "string", Required: false, Description: "Disable this field option."},
-				{Path: "generate.managed.disable[].field", Type: "string", Required: false, Description: "Field selector for field_option."},
-			},
-			Examples: []Example{
-				{
-					Title:       "managed_disable_variants",
-					Description: "Disable rules by path, file option, and field option.",
-					YAML:        "generate:\n  managed:\n    disable:\n      - path: proto/third_party\n      - package: acme.v1\n        file_option: java_package\n      - field_option: jstype\n        field: acme.v1.Message.count\n",
-					Paths:       []string{"generate.managed.disable"},
-				},
-			},
-			Notes: []string{
-				"At least one key in each disable item is required.",
-				"`file_option` and `field_option` cannot be used together.",
-				"`field` requires `field_option`.",
-				"`package` matches the protobuf file package exactly.",
-			},
-		},
-		"generate.managed.override": {
-			Fields: []FieldDoc{
-				{Path: "generate.managed.override[].file_option", Type: "string", Required: false, Description: "Target file option to override."},
-				{Path: "generate.managed.override[].field_option", Type: "string", Required: false, Description: "Target field option to override."},
-				{Path: "generate.managed.override[].value", Type: "any", Required: true, Description: "Override value."},
-				{Path: "generate.managed.override[].module", Type: "string", Required: false, Description: "Optional exact EasyP module selector (dependency/git_repo URL without @version)."},
-				{Path: "generate.managed.override[].package", Type: "string", Required: false, Description: "Optional exact protobuf package selector from the .proto file package declaration."},
-				{Path: "generate.managed.override[].path", Type: "string", Required: false, Description: "Optional path selector."},
-				{Path: "generate.managed.override[].field", Type: "string", Required: false, Description: "Optional field selector (for field_option)."},
-			},
-			Examples: []Example{
-				{
-					Title:       "managed_override_file_option",
-					Description: "Override a file option with a custom value.",
-					YAML:        "generate:\n  managed:\n    override:\n      - file_option: java_package_prefix\n        value: com.acme.generated\n      - file_option: go_package_prefix\n        package: acme.v1\n        value: github.com/acme/generated/go\n",
-					Paths:       []string{"generate.managed.override"},
-				},
-				{
-					Title:       "managed_override_field_option",
-					Description: "Override a field option for a selected field.",
-					YAML:        "generate:\n  managed:\n    override:\n      - field_option: jstype\n        field: acme.v1.Message.count\n        value: JS_NUMBER\n",
-					Paths:       []string{"generate.managed.override"},
-				},
-			},
-			Notes: []string{
-				"Each override item requires exactly one of file_option or field_option.",
-				"`field` can only be used with `field_option`.",
-				"`package` matches the protobuf file package exactly.",
-			},
-		},
-		"breaking": {
-			Fields: []FieldDoc{
-				{Path: "breaking.ignore", Type: "array<string>", Required: false, Description: "Paths excluded from breaking-change checks.", DefaultValue: "[]"},
-				{Path: "breaking.against_git_ref", Type: "string", Required: false, Description: "Branch/tag/commit used for comparison."},
-				{Path: "breaking.use", Type: "array<string>", Required: false, Description: "Additional breaking-check options; FILE also compares generated-code compatibility.", DefaultValue: "[]"},
-			},
-			Examples: []Example{
-				{
-					Title:       "breaking_with_ref_and_ignore",
-					Description: "Compare against selected git ref and ignore selected directories.",
-					YAML:        "breaking:\n  against_git_ref: origin/main\n  ignore:\n    - proto/experimental\n",
-					Paths:       []string{"breaking"},
-				},
-			},
-		},
-	}
-}
diff --git a/mcp/easypconfig/tool.go b/mcp/easypconfig/tool.go
index c6d4f8cb..5eea351e 100644
--- a/mcp/easypconfig/tool.go
+++ b/mcp/easypconfig/tool.go
@@ -6,17 +6,17 @@ import (
 	"github.com/modelcontextprotocol/go-sdk/mcp"
 )
 
+// RegisterTool adds the v1 configuration description tool to an MCP server.
 func RegisterTool(server *mcp.Server) {
 	mcp.AddTool(server, &mcp.Tool{
-		Name:         ToolName,
-		Description:  "Describe easyp.yaml schema and field usage. Supports full schema or a specific path with examples.",
-		InputSchema:  describeInputSchema(),
-		OutputSchema: describeOutputSchema(),
+		Name:        ToolName,
+		Description: "Describe four EasyP v1 formats: policy/generation YAML, protobuf.lock JSON Schema, and protobuf.mod text grammar. This reference never reads project files, downloads dependencies, or executes plugins.",
+		InputSchema: describeInputSchema(),
 	}, func(_ context.Context, _ *mcp.CallToolRequest, input DescribeInput) (*mcp.CallToolResult, DescribeOutput, error) {
-		out, err := Describe(input)
+		output, err := Describe(input)
 		if err != nil {
 			return nil, DescribeOutput{}, err
 		}
-		return nil, out, nil
+		return nil, output, nil
 	})
 }
diff --git a/mcp/easypconfig/tool_schemas.go b/mcp/easypconfig/tool_schemas.go
deleted file mode 100644
index 11ed5e1f..00000000
--- a/mcp/easypconfig/tool_schemas.go
+++ /dev/null
@@ -1,149 +0,0 @@
-package easypconfig
-
-import "github.com/google/jsonschema-go/jsonschema"
-
-func describeInputSchema() *jsonschema.Schema {
-	return &jsonschema.Schema{
-		Type: "object",
-		Properties: map[string]*jsonschema.Schema{
-			"path": {
-				Type:        "string",
-				Description: "Dot path to a section of the schema. Empty means full schema",
-			},
-			"include_schema": {
-				Type:        "boolean",
-				Description: "Include JSON schema fragment in output. Default: true",
-			},
-			"include_fields": {
-				Type:        "boolean",
-				Description: "Include field documentation in output. Default: true",
-			},
-			"include_examples": {
-				Type:        "boolean",
-				Description: "Include examples in output. Default: true",
-			},
-			"include_children": {
-				Type:        "boolean",
-				Description: "Include descendants of selected path. Default: true",
-			},
-			"examples_limit": {
-				Type:        "integer",
-				Description: "Maximum number of examples to return. Default: 10, range 1..50",
-				Minimum:     jsonschema.Ptr(1.0),
-				Maximum:     jsonschema.Ptr(50.0),
-			},
-		},
-	}
-}
-
-func describeOutputSchema() *jsonschema.Schema {
-	fieldDocSchema := &jsonschema.Schema{
-		Type: "object",
-		Properties: map[string]*jsonschema.Schema{
-			"path": {
-				Type:        "string",
-				Description: "Field path",
-			},
-			"type": {
-				Type:        "string",
-				Description: "Value type",
-			},
-			"required": {
-				Type:        "boolean",
-				Description: "Whether field is required",
-			},
-			"description": {
-				Type:        "string",
-				Description: "Field purpose",
-			},
-			"allowed_values": {
-				Type:        "array",
-				Description: "Allowed values or enum options",
-				Items: &jsonschema.Schema{
-					Type: "string",
-				},
-			},
-			"default_value": {
-				Type:        "string",
-				Description: "Default value if omitted",
-			},
-			"examples": {
-				Type:        "array",
-				Description: "Value examples",
-				Items: &jsonschema.Schema{
-					Type: "string",
-				},
-			},
-			"notes": {
-				Type:        "array",
-				Description: "Extra constraints or caveats",
-				Items: &jsonschema.Schema{
-					Type: "string",
-				},
-			},
-		},
-		Required: []string{"path", "type", "required", "description"},
-	}
-
-	exampleSchema := &jsonschema.Schema{
-		Type: "object",
-		Properties: map[string]*jsonschema.Schema{
-			"title": {
-				Type:        "string",
-				Description: "Short example title",
-			},
-			"description": {
-				Type:        "string",
-				Description: "Example purpose",
-			},
-			"yaml": {
-				Type:        "string",
-				Description: "YAML snippet",
-			},
-			"paths": {
-				Type:        "array",
-				Description: "Schema paths covered by this example",
-				Items: &jsonschema.Schema{
-					Type: "string",
-				},
-			},
-		},
-		Required: []string{"title", "yaml"},
-	}
-
-	return &jsonschema.Schema{
-		Type: "object",
-		Properties: map[string]*jsonschema.Schema{
-			"schema_version": {
-				Type:        "string",
-				Description: "Schema metadata version",
-			},
-			"selected_path": {
-				Type:        "string",
-				Description: "Resolved path used for this response",
-			},
-			"schema": {
-				Type:        "object",
-				Description: "JSON schema fragment for selected path",
-			},
-			"fields": {
-				Type:        "array",
-				Description: "Field documentation",
-				Items:       fieldDocSchema,
-			},
-			"examples": {
-				Type:        "array",
-				Description: "YAML examples",
-				Items:       exampleSchema,
-			},
-			"notes": {
-				Type:        "array",
-				Description: "General notes and caveats",
-				Items: &jsonschema.Schema{
-					Type: "string",
-				},
-			},
-		},
-		Required: []string{"schema_version", "selected_path"},
-	}
-}
diff --git a/protobuf.lock b/protobuf.lock
new file mode 100644
index 00000000..330fca93
--- /dev/null
+++ b/protobuf.lock
@@ -0,0 +1,3 @@
+# protobuf.lock - GENERATED FILE, DO NOT EDIT MANUALLY
+version: 1
+modules: []
diff --git a/protobuf.mod b/protobuf.mod
new file mode 100644
index 00000000..187d2af4
--- /dev/null
+++ b/protobuf.mod
@@ -0,0 +1,3 @@
+// The CLI has no production protobuf dependencies. Its runnable example is local.
+module github.com/easyp-tech/easyp
+roots examples/proto
diff --git a/schemas/easyp-config-v1.schema.json b/schemas/easyp-config-v1.schema.json
deleted file mode 100644
index 81128b07..00000000
--- a/schemas/easyp-config-v1.schema.json
+++ /dev/null
@@ -1,369 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "properties": {
-    "version": {
-      "type": "string"
-    },
-    "lint": {
-      "properties": {
-        "use": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "enum_zero_value_suffix": {
-          "type": "string"
-        },
-        "service_suffix": {
-          "type": "string"
-        },
-        "ignore": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "except": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "allow_comment_ignores": {
-          "type": "boolean"
-        },
-        "ignore_only": {
-          "additionalProperties": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "type": "object"
-        }
-      },
-      "additionalProperties": false,
-      "type": "object"
-    },
-    "deps": {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "generate": {
-      "properties": {
-        "inputs": {
-          "items": {
-            "oneOf": [
-              {
-                "required": [
-                  "directory"
-                ]
-              },
-              {
-                "required": [
-                  "git_repo"
-                ]
-              }
-            ],
-            "properties": {
-              "directory": {
-                "oneOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "properties": {
-                      "path": {
-                        "type": "string"
-                      },
-                      "root": {
-                        "type": "string"
-                      }
-                    },
-                    "additionalProperties": false,
-                    "type": "object",
-                    "required": [
-                      "path"
-                    ]
-                  }
-                ]
-              },
-              "git_repo": {
-                "properties": {
-                  "url": {
-                    "type": "string"
-                  },
-                  "sub_directory": {
-                    "type": "string"
-                  },
-                  "root": {
-                    "type": "string"
-                  }
-                },
-                "additionalProperties": false,
-                "type": "object",
-                "required": [
-                  "url"
-                ]
-              }
-            },
-            "additionalProperties": false,
-            "type": "object"
-          },
-          "type": "array",
-          "minItems": 1
-        },
-        "plugins": {
-          "items": {
-            "oneOf": [
-              {
-                "required": [
-                  "name"
-                ]
-              },
-              {
-                "required": [
-                  "remote"
-                ]
-              },
-              {
-                "required": [
-                  "path"
-                ]
-              },
-              {
-                "required": [
-                  "command"
-                ]
-              }
-            ],
-            "properties": {
-              "name": {
-                "type": "string"
-              },
-              "remote": {
-                "type": "string"
-              },
-              "path": {
-                "type": "string"
-              },
-              "command": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "out": {
-                "type": "string"
-              },
-              "opts": {
-                "additionalProperties": {
-                  "oneOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "number"
-                    },
-                    {
-                      "type": "boolean"
-                    },
-                    {
-                      "items": {
-                        "oneOf": [
-                          {
-                            "type": "string"
-                          },
-                          {
-                            "type": "number"
-                          },
-                          {
-                            "type": "boolean"
-                          }
-                        ]
-                      },
-                      "type": "array"
-                    }
-                  ]
-                },
-                "type": "object"
-              },
-              "with_imports": {
-                "type": "boolean"
-              }
-            },
-            "additionalProperties": false,
-            "type": "object"
-          },
-          "type": "array",
-          "minItems": 1
-        },
-        "managed": {
-          "properties": {
-            "enabled": {
-              "type": "boolean"
-            },
-            "disable": {
-              "items": {
-                "anyOf": [
-                  {
-                    "required": [
-                      "module"
-                    ]
-                  },
-                  {
-                    "required": [
-                      "package"
-                    ]
-                  },
-                  {
-                    "required": [
-                      "path"
-                    ]
-                  },
-                  {
-                    "required": [
-                      "file_option"
-                    ]
-                  },
-                  {
-                    "required": [
-                      "field_option"
-                    ]
-                  },
-                  {
-                    "required": [
-                      "field"
-                    ]
-                  }
-                ],
-                "not": {
-                  "required": [
-                    "file_option",
-                    "field_option"
-                  ]
-                },
-                "properties": {
-                  "module": {
-                    "type": "string"
-                  },
-                  "package": {
-                    "type": "string"
-                  },
-                  "path": {
-                    "type": "string"
-                  },
-                  "file_option": {
-                    "type": "string"
-                  },
-                  "field_option": {
-                    "type": "string"
-                  },
-                  "field": {
-                    "type": "string"
-                  }
-                },
-                "additionalProperties": false,
-                "type": "object",
-                "dependentRequired": {
-                  "field": [
-                    "field_option"
-                  ]
-                }
-              },
-              "type": "array"
-            },
-            "override": {
-              "items": {
-                "anyOf": [
-                  {
-                    "required": [
-                      "file_option"
-                    ]
-                  },
-                  {
-                    "required": [
-                      "field_option"
-                    ]
-                  }
-                ],
-                "not": {
-                  "required": [
-                    "file_option",
-                    "field_option"
-                  ]
-                },
-                "properties": {
-                  "file_option": {
-                    "type": "string"
-                  },
-                  "field_option": {
-                    "type": "string"
-                  },
-                  "value": true,
-                  "module": {
-                    "type": "string"
-                  },
-                  "package": {
-                    "type": "string"
-                  },
-                  "path": {
-                    "type": "string"
-                  },
-                  "field": {
-                    "type": "string"
-                  }
-                },
-                "additionalProperties": false,
-                "type": "object",
-                "required": [
-                  "value"
-                ],
-                "dependentRequired": {
-                  "field": [
-                    "field_option"
-                  ]
-                }
-              },
-              "type": "array"
-            }
-          },
-          "additionalProperties": false,
-          "type": "object"
-        }
-      },
-      "additionalProperties": false,
-      "type": "object",
-      "required": [
-        "inputs",
-        "plugins"
-      ]
-    },
-    "breaking": {
-      "properties": {
-        "ignore": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "against_git_ref": {
-          "type": "string"
-        },
-        "use": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        }
-      },
-      "additionalProperties": false,
-      "type": "object"
-    }
-  },
-  "additionalProperties": false,
-  "type": "object"
-}
diff --git a/schemas/easyp-config.schema.json b/schemas/easyp-config.schema.json
deleted file mode 100644
index 81128b07..00000000
--- a/schemas/easyp-config.schema.json
+++ /dev/null
@@ -1,369 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "properties": {
-    "version": {
-      "type": "string"
-    },
-    "lint": {
-      "properties": {
-        "use": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "enum_zero_value_suffix": {
-          "type": "string"
-        },
-        "service_suffix": {
-          "type": "string"
-        },
-        "ignore": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "except": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "allow_comment_ignores": {
-          "type": "boolean"
-        },
-        "ignore_only": {
-          "additionalProperties": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "type": "object"
-        }
-      },
-      "additionalProperties": false,
-      "type": "object"
-    },
-    "deps": {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "generate": {
-      "properties": {
-        "inputs": {
-          "items": {
-            "oneOf": [
-              {
-                "required": [
-                  "directory"
-                ]
-              },
-              {
-                "required": [
-                  "git_repo"
-                ]
-              }
-            ],
-            "properties": {
-              "directory": {
-                "oneOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "properties": {
-                      "path": {
-                        "type": "string"
-                      },
-                      "root": {
-                        "type": "string"
-                      }
-                    },
-                    "additionalProperties": false,
-                    "type": "object",
-                    "required": [
-                      "path"
-                    ]
-                  }
-                ]
-              },
-              "git_repo": {
-                "properties": {
-                  "url": {
-                    "type": "string"
-                  },
-                  "sub_directory": {
-                    "type": "string"
-                  },
-                  "root": {
-                    "type": "string"
-                  }
-                },
-                "additionalProperties": false,
-                "type": "object",
-                "required": [
-                  "url"
-                ]
-              }
-            },
-            "additionalProperties": false,
-            "type": "object"
-          },
-          "type": "array",
-          "minItems": 1
-        },
-        "plugins": {
-          "items": {
-            "oneOf": [
-              {
-                "required": [
-                  "name"
-                ]
-              },
-              {
-                "required": [
-                  "remote"
-                ]
-              },
-              {
-                "required": [
-                  "path"
-                ]
-              },
-              {
-                "required": [
-                  "command"
-                ]
-              }
-            ],
-            "properties": {
-              "name": {
-                "type": "string"
-              },
-              "remote": {
-                "type": "string"
-              },
-              "path": {
-                "type": "string"
-              },
-              "command": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "out": {
-                "type": "string"
-              },
-              "opts": {
-                "additionalProperties": {
-                  "oneOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "number"
-                    },
-                    {
-                      "type": "boolean"
-                    },
-                    {
-                      "items": {
-                        "oneOf": [
-                          {
-                            "type": "string"
-                          },
-                          {
-                            "type": "number"
-                          },
-                          {
-                            "type": "boolean"
-                          }
-                        ]
-                      },
-                      "type": "array"
-                    }
-                  ]
-                },
-                "type": "object"
-              },
-              "with_imports": {
-                "type": "boolean"
-              }
-            },
-            "additionalProperties": false,
-            "type": "object"
-          },
-          "type": "array",
-          "minItems": 1
-        },
-        "managed": {
-          "properties": {
-            "enabled": {
-              "type": "boolean"
-            },
-            "disable": {
-              "items": {
-                "anyOf": [
-                  {
-                    "required": [
-                      "module"
-                    ]
-                  },
-                  {
-                    "required": [
-                      "package"
-                    ]
-                  },
-                  {
-                    "required": [
-                      "path"
-                    ]
-                  },
-                  {
-                    "required": [
-                      "file_option"
-                    ]
-                  },
-                  {
-                    "required": [
-                      "field_option"
-                    ]
-                  },
-                  {
-                    "required": [
-                      "field"
-                    ]
-                  }
-                ],
-                "not": {
-                  "required": [
-                    "file_option",
-                    "field_option"
-                  ]
-                },
-                "properties": {
-                  "module": {
-                    "type": "string"
-                  },
-                  "package": {
-                    "type": "string"
-                  },
-                  "path": {
-                    "type": "string"
-                  },
-                  "file_option": {
-                    "type": "string"
-                  },
-                  "field_option": {
-                    "type": "string"
-                  },
-                  "field": {
-                    "type": "string"
-                  }
-                },
-                "additionalProperties": false,
-                "type": "object",
-                "dependentRequired": {
-                  "field": [
-                    "field_option"
-                  ]
-                }
-              },
-              "type": "array"
-            },
-            "override": {
-              "items": {
-                "anyOf": [
-                  {
-                    "required": [
-                      "file_option"
-                    ]
-                  },
-                  {
-                    "required": [
-                      "field_option"
-                    ]
-                  }
-                ],
-                "not": {
-                  "required": [
-                    "file_option",
-                    "field_option"
-                  ]
-                },
-                "properties": {
-                  "file_option": {
-                    "type": "string"
-                  },
-                  "field_option": {
-                    "type": "string"
-                  },
-                  "value": true,
-                  "module": {
-                    "type": "string"
-                  },
-                  "package": {
-                    "type": "string"
-                  },
-                  "path": {
-                    "type": "string"
-                  },
-                  "field": {
-                    "type": "string"
-                  }
-                },
-                "additionalProperties": false,
-                "type": "object",
-                "required": [
-                  "value"
-                ],
-                "dependentRequired": {
-                  "field": [
-                    "field_option"
-                  ]
-                }
-              },
-              "type": "array"
-            }
-          },
-          "additionalProperties": false,
-          "type": "object"
-        }
-      },
-      "additionalProperties": false,
-      "type": "object",
-      "required": [
-        "inputs",
-        "plugins"
-      ]
-    },
-    "breaking": {
-      "properties": {
-        "ignore": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "against_git_ref": {
-          "type": "string"
-        },
-        "use": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        }
-      },
-      "additionalProperties": false,
-      "type": "object"
-    }
-  },
-  "additionalProperties": false,
-  "type": "object"
-}
diff --git a/schemas/easyp-v1.schema.json b/schemas/easyp-v1.schema.json
new file mode 100644
index 00000000..207ec44b
--- /dev/null
+++ b/schemas/easyp-v1.schema.json
@@ -0,0 +1,280 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "easyp.yaml v1",
+  "description": "Structural v1 YAML schema. EasyP CLI validation applies additional semantic checks.",
+  "type": "object",
+  "properties": {
+    "breaking": {
+      "type": "object",
+      "properties": {
+        "baseline": {
+          "type": "string",
+          "pattern": "^(git:.+)?$"
+        },
+        "categories": {
+          "description": "Selects FILE, PACKAGE, WIRE_JSON, and/or WIRE compatibility profiles. Multiple profiles apply their union; omitted or empty defaults to FILE.",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "FILE",
+              "PACKAGE",
+              "WIRE_JSON",
+              "WIRE"
+            ]
+          }
+        },
+        "extends": {
+          "description": "Base policy for this section only, applied before local adjustments. Use ./ or ../ for a policy file or directory relative to this file, or a module identity already declared in protobuf.mod and locked in protobuf.lock, optionally with #\u003cpolicy-file-or-directory\u003e. A module reference without # loads that module's easyp.yaml. Versions are not repeated here and no new module or revision is acquired. Remote policies are read from the verified module contents of the consuming module; a base's own relative references stay inside its module. Only the referenced section and linters-settings are inherited: issues.exclude-rules, generation settings and the other section are not. Base breaking.ignore paths and the baseline are applied at this file's location, not in the module cache.",
+          "type": "string",
+          "pattern": "^(|\\.\\.?|\\.\\.?/[^\\r\\n\\\\@]+|[^\\s@#]+/[^\\s@#]*(#[^\\s@#]*)?)$"
+        },
+        "ignore": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "ignore_unstable": {
+          "description": "Ignore declarations in packages with unstable version suffixes; stable package checks remain enabled.",
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false
+    },
+    "issues": {
+      "type": "object",
+      "properties": {
+        "exclude-rules": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "linters": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "MINIMAL",
+                    "BASIC",
+                    "DEFAULT",
+                    "COMMENTS",
+                    "UNARY_RPC",
+                    "DIRECTORY_SAME_PACKAGE",
+                    "PACKAGE_DEFINED",
+                    "PACKAGE_DIRECTORY_MATCH",
+                    "PACKAGE_SAME_DIRECTORY",
+                    "ENUM_FIRST_VALUE_ZERO",
+                    "ENUM_NO_ALLOW_ALIAS",
+                    "ENUM_PASCAL_CASE",
+                    "ENUM_VALUE_UPPER_SNAKE_CASE",
+                    "FIELD_LOWER_SNAKE_CASE",
+                    "IMPORT_NO_PUBLIC",
+                    "IMPORT_NO_WEAK",
+                    "IMPORT_USED",
+                    "MESSAGE_PASCAL_CASE",
+                    "ONEOF_LOWER_SNAKE_CASE",
+                    "PACKAGE_LOWER_SNAKE_CASE",
+                    "PACKAGE_SAME_CSHARP_NAMESPACE",
+                    "PACKAGE_SAME_GO_PACKAGE",
+                    "PACKAGE_SAME_JAVA_MULTIPLE_FILES",
+                    "PACKAGE_SAME_JAVA_PACKAGE",
+                    "PACKAGE_SAME_PHP_NAMESPACE",
+                    "PACKAGE_SAME_RUBY_PACKAGE",
+                    "PACKAGE_SAME_SWIFT_PREFIX",
+                    "RPC_PASCAL_CASE",
+                    "SERVICE_PASCAL_CASE",
+                    "ENUM_VALUE_PREFIX",
+                    "ENUM_ZERO_VALUE_SUFFIX",
+                    "FILE_LOWER_SNAKE_CASE",
+                    "RPC_REQUEST_RESPONSE_UNIQUE",
+                    "RPC_REQUEST_STANDARD_NAME",
+                    "RPC_RESPONSE_STANDARD_NAME",
+                    "PACKAGE_VERSION_SUFFIX",
+                    "SERVICE_SUFFIX",
+                    "COMMENT_ENUM",
+                    "COMMENT_ENUM_VALUE",
+                    "COMMENT_FIELD",
+                    "COMMENT_MESSAGE",
+                    "COMMENT_ONEOF",
+                    "COMMENT_RPC",
+                    "COMMENT_SERVICE",
+                    "RPC_NO_CLIENT_STREAMING",
+                    "RPC_NO_SERVER_STREAMING"
+                  ]
+                }
+              },
+              "path": {
+                "description": "Relative to the policy providing this issues section. Supports *, ?, character classes and ** directory segments; a literal directory includes its subtree.",
+                "type": "string"
+              }
+            },
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "linters": {
+      "type": "object",
+      "properties": {
+        "allow_comment_ignores": {
+          "description": "Enable scoped easyp:disable, nolint and buf:lint:ignore comments; defaults to true. State is local to each effective lint policy.",
+          "type": "boolean"
+        },
+        "default": {
+          "type": "string",
+          "enum": [
+            "MINIMAL",
+            "BASIC",
+            "STANDARD",
+            "COMMENTS"
+          ]
+        },
+        "disable": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "MINIMAL",
+              "BASIC",
+              "DEFAULT",
+              "COMMENTS",
+              "UNARY_RPC",
+              "DIRECTORY_SAME_PACKAGE",
+              "PACKAGE_DEFINED",
+              "PACKAGE_DIRECTORY_MATCH",
+              "PACKAGE_SAME_DIRECTORY",
+              "ENUM_FIRST_VALUE_ZERO",
+              "ENUM_NO_ALLOW_ALIAS",
+              "ENUM_PASCAL_CASE",
+              "ENUM_VALUE_UPPER_SNAKE_CASE",
+              "FIELD_LOWER_SNAKE_CASE",
+              "IMPORT_NO_PUBLIC",
+              "IMPORT_NO_WEAK",
+              "IMPORT_USED",
+              "MESSAGE_PASCAL_CASE",
+              "ONEOF_LOWER_SNAKE_CASE",
+              "PACKAGE_LOWER_SNAKE_CASE",
+              "PACKAGE_SAME_CSHARP_NAMESPACE",
+              "PACKAGE_SAME_GO_PACKAGE",
+              "PACKAGE_SAME_JAVA_MULTIPLE_FILES",
+              "PACKAGE_SAME_JAVA_PACKAGE",
+              "PACKAGE_SAME_PHP_NAMESPACE",
+              "PACKAGE_SAME_RUBY_PACKAGE",
+              "PACKAGE_SAME_SWIFT_PREFIX",
+              "RPC_PASCAL_CASE",
+              "SERVICE_PASCAL_CASE",
+              "ENUM_VALUE_PREFIX",
+              "ENUM_ZERO_VALUE_SUFFIX",
+              "FILE_LOWER_SNAKE_CASE",
+              "RPC_REQUEST_RESPONSE_UNIQUE",
+              "RPC_REQUEST_STANDARD_NAME",
+              "RPC_RESPONSE_STANDARD_NAME",
+              "PACKAGE_VERSION_SUFFIX",
+              "SERVICE_SUFFIX",
+              "COMMENT_ENUM",
+              "COMMENT_ENUM_VALUE",
+              "COMMENT_FIELD",
+              "COMMENT_MESSAGE",
+              "COMMENT_ONEOF",
+              "COMMENT_RPC",
+              "COMMENT_SERVICE",
+              "RPC_NO_CLIENT_STREAMING",
+              "RPC_NO_SERVER_STREAMING"
+            ]
+          }
+        },
+        "enable": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "MINIMAL",
+              "BASIC",
+              "DEFAULT",
+              "COMMENTS",
+              "UNARY_RPC",
+              "DIRECTORY_SAME_PACKAGE",
+              "PACKAGE_DEFINED",
+              "PACKAGE_DIRECTORY_MATCH",
+              "PACKAGE_SAME_DIRECTORY",
+              "ENUM_FIRST_VALUE_ZERO",
+              "ENUM_NO_ALLOW_ALIAS",
+              "ENUM_PASCAL_CASE",
+              "ENUM_VALUE_UPPER_SNAKE_CASE",
+              "FIELD_LOWER_SNAKE_CASE",
+              "IMPORT_NO_PUBLIC",
+              "IMPORT_NO_WEAK",
+              "IMPORT_USED",
+              "MESSAGE_PASCAL_CASE",
+              "ONEOF_LOWER_SNAKE_CASE",
+              "PACKAGE_LOWER_SNAKE_CASE",
+              "PACKAGE_SAME_CSHARP_NAMESPACE",
+              "PACKAGE_SAME_GO_PACKAGE",
+              "PACKAGE_SAME_JAVA_MULTIPLE_FILES",
+              "PACKAGE_SAME_JAVA_PACKAGE",
+              "PACKAGE_SAME_PHP_NAMESPACE",
+              "PACKAGE_SAME_RUBY_PACKAGE",
+              "PACKAGE_SAME_SWIFT_PREFIX",
+              "RPC_PASCAL_CASE",
+              "SERVICE_PASCAL_CASE",
+              "ENUM_VALUE_PREFIX",
+              "ENUM_ZERO_VALUE_SUFFIX",
+              "FILE_LOWER_SNAKE_CASE",
+              "RPC_REQUEST_RESPONSE_UNIQUE",
+              "RPC_REQUEST_STANDARD_NAME",
+              "RPC_RESPONSE_STANDARD_NAME",
+              "PACKAGE_VERSION_SUFFIX",
+              "SERVICE_SUFFIX",
+              "COMMENT_ENUM",
+              "COMMENT_ENUM_VALUE",
+              "COMMENT_FIELD",
+              "COMMENT_MESSAGE",
+              "COMMENT_ONEOF",
+              "COMMENT_RPC",
+              "COMMENT_SERVICE",
+              "RPC_NO_CLIENT_STREAMING",
+              "RPC_NO_SERVER_STREAMING"
+            ]
+          }
+        },
+        "extends": {
+          "description": "Base policy for this section only, applied before local adjustments. Use ./ or ../ for a policy file or directory relative to this file, or a module identity already declared in protobuf.mod and locked in protobuf.lock, optionally with #\u003cpolicy-file-or-directory\u003e. A module reference without # loads that module's easyp.yaml. Versions are not repeated here and no new module or revision is acquired. Remote policies are read from the verified module contents of the consuming module; a base's own relative references stay inside its module. Only the referenced section and linters-settings are inherited: issues.exclude-rules, generation settings and the other section are not. Base breaking.ignore paths and the baseline are applied at this file's location, not in the module cache.",
+          "type": "string",
+          "pattern": "^(|\\.\\.?|\\.\\.?/[^\\r\\n\\\\@]+|[^\\s@#]+/[^\\s@#]*(#[^\\s@#]*)?)$"
+        }
+      },
+      "additionalProperties": false
+    },
+    "linters-settings": {
+      "type": "object",
+      "properties": {
+        "ENUM_ZERO_VALUE_SUFFIX": {
+          "type": "object",
+          "properties": {
+            "suffix": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        },
+        "SERVICE_SUFFIX": {
+          "type": "object",
+          "properties": {
+            "suffix": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "version": {
+      "type": "string",
+      "const": "v1"
+    }
+  },
+  "additionalProperties": false
+}
diff --git a/schemas/easyp.gen-v1.schema.json b/schemas/easyp.gen-v1.schema.json
new file mode 100644
index 00000000..2f13755b
--- /dev/null
+++ b/schemas/easyp.gen-v1.schema.json
@@ -0,0 +1,803 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "easyp.gen.yaml v1",
+  "description": "Structural v1 YAML schema. EasyP CLI validation applies additional semantic checks.",
+  "type": "object",
+  "properties": {
+    "generate": {
+      "type": "object",
+      "properties": {
+        "managed": {
+          "type": "object",
+          "properties": {
+            "disable": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "field": {
+                    "type": "string"
+                  },
+                  "field_option": {
+                    "type": "string",
+                    "enum": [
+                      "jstype"
+                    ]
+                  },
+                  "file_option": {
+                    "type": "string",
+                    "enum": [
+                      "go_package",
+                      "go_package_prefix",
+                      "java_package",
+                      "java_package_prefix",
+                      "java_package_suffix",
+                      "java_multiple_files",
+                      "java_outer_classname",
+                      "java_string_check_utf8",
+                      "csharp_namespace",
+                      "csharp_namespace_prefix",
+                      "ruby_package",
+                      "ruby_package_suffix",
+                      "php_namespace",
+                      "php_metadata_namespace",
+                      "php_metadata_namespace_suffix",
+                      "objc_class_prefix",
+                      "swift_prefix",
+                      "optimize_for",
+                      "cc_enable_arenas"
+                    ]
+                  },
+                  "module": {
+                    "type": "string"
+                  },
+                  "package": {
+                    "type": "string"
+                  },
+                  "path": {
+                    "type": "string"
+                  }
+                },
+                "additionalProperties": false,
+                "anyOf": [
+                  {
+                    "properties": {
+                      "module": {
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "module"
+                    ]
+                  },
+                  {
+                    "properties": {
+                      "package": {
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "package"
+                    ]
+                  },
+                  {
+                    "properties": {
+                      "path": {
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "path"
+                    ]
+                  },
+                  {
+                    "properties": {
+                      "file_option": {
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "file_option"
+                    ]
+                  },
+                  {
+                    "properties": {
+                      "field_option": {
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "field_option"
+                    ]
+                  },
+                  {
+                    "properties": {
+                      "field": {
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "field"
+                    ]
+                  }
+                ],
+                "allOf": [
+                  {
+                    "if": {
+                      "properties": {
+                        "field": {
+                          "minLength": 1
+                        }
+                      },
+                      "required": [
+                        "field"
+                      ]
+                    },
+                    "then": {
+                      "required": [
+                        "field_option"
+                      ]
+                    }
+                  }
+                ],
+                "not": {
+                  "required": [
+                    "file_option",
+                    "field_option"
+                  ]
+                }
+              }
+            },
+            "enabled": {
+              "type": "boolean"
+            },
+            "override": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "field": {
+                    "type": "string"
+                  },
+                  "field_option": {
+                    "type": "string",
+                    "enum": [
+                      "jstype"
+                    ]
+                  },
+                  "file_option": {
+                    "type": "string",
+                    "enum": [
+                      "go_package",
+                      "go_package_prefix",
+                      "java_package",
+                      "java_package_prefix",
+                      "java_package_suffix",
+                      "java_multiple_files",
+                      "java_outer_classname",
+                      "java_string_check_utf8",
+                      "csharp_namespace",
+                      "csharp_namespace_prefix",
+                      "ruby_package",
+                      "ruby_package_suffix",
+                      "php_namespace",
+                      "php_metadata_namespace",
+                      "php_metadata_namespace_suffix",
+                      "objc_class_prefix",
+                      "swift_prefix",
+                      "optimize_for",
+                      "cc_enable_arenas"
+                    ]
+                  },
+                  "module": {
+                    "type": "string"
+                  },
+                  "package": {
+                    "type": "string"
+                  },
+                  "path": {
+                    "type": "string"
+                  },
+                  "value": {}
+                },
+                "additionalProperties": false,
+                "oneOf": [
+                  {
+                    "required": [
+                      "file_option"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "field_option"
+                    ]
+                  }
+                ],
+                "allOf": [
+                  {
+                    "if": {
+                      "properties": {
+                        "field": {
+                          "minLength": 1
+                        }
+                      },
+                      "required": [
+                        "field"
+                      ]
+                    },
+                    "then": {
+                      "required": [
+                        "field_option"
+                      ]
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "go_package"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "go_package_prefix"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "java_package"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "java_package_prefix"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "java_package_suffix"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "java_multiple_files"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "boolean"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "java_outer_classname"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "java_string_check_utf8"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "boolean"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "csharp_namespace"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "csharp_namespace_prefix"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "ruby_package"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "ruby_package_suffix"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "php_namespace"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "php_metadata_namespace"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "php_metadata_namespace_suffix"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "objc_class_prefix"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "swift_prefix"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "optimize_for"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string",
+                          "enum": [
+                            "SPEED",
+                            "CODE_SIZE",
+                            "LITE_RUNTIME"
+                          ]
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "cc_enable_arenas"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "boolean"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "field_option": {
+                          "const": "jstype"
+                        }
+                      },
+                      "required": [
+                        "field_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string",
+                          "enum": [
+                            "JS_NORMAL",
+                            "JS_STRING",
+                            "JS_NUMBER"
+                          ]
+                        }
+                      }
+                    }
+                  }
+                ],
+                "required": [
+                  "value"
+                ]
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "modules": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "packages": {
+          "description": "Exact protobuf packages among selected modules. Empty means all source files. Imports remain available for compilation; with_imports separately controls dependency generation.",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Za-z_][A-Za-z0-9_]*(\\.[A-Za-z_][A-Za-z0-9_]*)*$"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "options": {
+      "type": "object",
+      "properties": {
+        "go": {
+          "type": "object",
+          "properties": {
+            "package_prefix": {
+              "description": "Sets go_package without enabling managed defaults for other languages; full managed mode requires generate.managed.enabled.",
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "plugins": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "command": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "name": {
+            "type": "string"
+          },
+          "opts": {
+            "oneOf": [
+              {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              {
+                "type": "object",
+                "additionalProperties": {
+                  "oneOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "type": "array",
+                      "items": {
+                        "oneOf": [
+                          {
+                            "type": "string"
+                          },
+                          {
+                            "type": "number"
+                          },
+                          {
+                            "type": "boolean"
+                          }
+                        ]
+                      }
+                    }
+                  ]
+                }
+              }
+            ]
+          },
+          "out": {
+            "type": "string"
+          },
+          "path": {
+            "type": "string"
+          },
+          "remote": {
+            "type": "string"
+          },
+          "version": {
+            "type": "string"
+          },
+          "with_imports": {
+            "description": "Generate code for transitive imports with this plugin only; defaults to false. Independent from descriptor --include_imports.",
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false,
+        "oneOf": [
+          {
+            "required": [
+              "name"
+            ]
+          },
+          {
+            "required": [
+              "path"
+            ]
+          },
+          {
+            "required": [
+              "command"
+            ]
+          },
+          {
+            "required": [
+              "remote"
+            ]
+          }
+        ],
+        "allOf": [
+          {
+            "if": {
+              "required": [
+                "remote"
+              ]
+            },
+            "then": {
+              "required": [
+                "version"
+              ]
+            }
+          },
+          {
+            "if": {
+              "not": {
+                "required": [
+                  "remote"
+                ]
+              }
+            },
+            "then": {
+              "not": {
+                "required": [
+                  "version"
+                ]
+              }
+            }
+          }
+        ],
+        "required": [
+          "out"
+        ]
+      }
+    },
+    "version": {
+      "type": "string",
+      "const": "v1"
+    }
+  },
+  "additionalProperties": false
+}
diff --git a/schemas/easyp.gen.schema.json b/schemas/easyp.gen.schema.json
new file mode 100644
index 00000000..2f13755b
--- /dev/null
+++ b/schemas/easyp.gen.schema.json
@@ -0,0 +1,803 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "easyp.gen.yaml v1",
+  "description": "Structural v1 YAML schema. EasyP CLI validation applies additional semantic checks.",
+  "type": "object",
+  "properties": {
+    "generate": {
+      "type": "object",
+      "properties": {
+        "managed": {
+          "type": "object",
+          "properties": {
+            "disable": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "field": {
+                    "type": "string"
+                  },
+                  "field_option": {
+                    "type": "string",
+                    "enum": [
+                      "jstype"
+                    ]
+                  },
+                  "file_option": {
+                    "type": "string",
+                    "enum": [
+                      "go_package",
+                      "go_package_prefix",
+                      "java_package",
+                      "java_package_prefix",
+                      "java_package_suffix",
+                      "java_multiple_files",
+                      "java_outer_classname",
+                      "java_string_check_utf8",
+                      "csharp_namespace",
+                      "csharp_namespace_prefix",
+                      "ruby_package",
+                      "ruby_package_suffix",
+                      "php_namespace",
+                      "php_metadata_namespace",
+                      "php_metadata_namespace_suffix",
+                      "objc_class_prefix",
+                      "swift_prefix",
+                      "optimize_for",
+                      "cc_enable_arenas"
+                    ]
+                  },
+                  "module": {
+                    "type": "string"
+                  },
+                  "package": {
+                    "type": "string"
+                  },
+                  "path": {
+                    "type": "string"
+                  }
+                },
+                "additionalProperties": false,
+                "anyOf": [
+                  {
+                    "properties": {
+                      "module": {
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "module"
+                    ]
+                  },
+                  {
+                    "properties": {
+                      "package": {
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "package"
+                    ]
+                  },
+                  {
+                    "properties": {
+                      "path": {
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "path"
+                    ]
+                  },
+                  {
+                    "properties": {
+                      "file_option": {
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "file_option"
+                    ]
+                  },
+                  {
+                    "properties": {
+                      "field_option": {
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "field_option"
+                    ]
+                  },
+                  {
+                    "properties": {
+                      "field": {
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "field"
+                    ]
+                  }
+                ],
+                "allOf": [
+                  {
+                    "if": {
+                      "properties": {
+                        "field": {
+                          "minLength": 1
+                        }
+                      },
+                      "required": [
+                        "field"
+                      ]
+                    },
+                    "then": {
+                      "required": [
+                        "field_option"
+                      ]
+                    }
+                  }
+                ],
+                "not": {
+                  "required": [
+                    "file_option",
+                    "field_option"
+                  ]
+                }
+              }
+            },
+            "enabled": {
+              "type": "boolean"
+            },
+            "override": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "field": {
+                    "type": "string"
+                  },
+                  "field_option": {
+                    "type": "string",
+                    "enum": [
+                      "jstype"
+                    ]
+                  },
+                  "file_option": {
+                    "type": "string",
+                    "enum": [
+                      "go_package",
+                      "go_package_prefix",
+                      "java_package",
+                      "java_package_prefix",
+                      "java_package_suffix",
+                      "java_multiple_files",
+                      "java_outer_classname",
+                      "java_string_check_utf8",
+                      "csharp_namespace",
+                      "csharp_namespace_prefix",
+                      "ruby_package",
+                      "ruby_package_suffix",
+                      "php_namespace",
+                      "php_metadata_namespace",
+                      "php_metadata_namespace_suffix",
+                      "objc_class_prefix",
+                      "swift_prefix",
+                      "optimize_for",
+                      "cc_enable_arenas"
+                    ]
+                  },
+                  "module": {
+                    "type": "string"
+                  },
+                  "package": {
+                    "type": "string"
+                  },
+                  "path": {
+                    "type": "string"
+                  },
+                  "value": {}
+                },
+                "additionalProperties": false,
+                "oneOf": [
+                  {
+                    "required": [
+                      "file_option"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "field_option"
+                    ]
+                  }
+                ],
+                "allOf": [
+                  {
+                    "if": {
+                      "properties": {
+                        "field": {
+                          "minLength": 1
+                        }
+                      },
+                      "required": [
+                        "field"
+                      ]
+                    },
+                    "then": {
+                      "required": [
+                        "field_option"
+                      ]
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "go_package"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "go_package_prefix"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "java_package"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "java_package_prefix"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "java_package_suffix"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "java_multiple_files"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "boolean"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "java_outer_classname"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "java_string_check_utf8"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "boolean"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "csharp_namespace"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "csharp_namespace_prefix"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "ruby_package"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "ruby_package_suffix"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "php_namespace"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "php_metadata_namespace"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "php_metadata_namespace_suffix"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "objc_class_prefix"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "swift_prefix"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "optimize_for"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string",
+                          "enum": [
+                            "SPEED",
+                            "CODE_SIZE",
+                            "LITE_RUNTIME"
+                          ]
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "file_option": {
+                          "const": "cc_enable_arenas"
+                        }
+                      },
+                      "required": [
+                        "file_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "boolean"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "field_option": {
+                          "const": "jstype"
+                        }
+                      },
+                      "required": [
+                        "field_option"
+                      ]
+                    },
+                    "then": {
+                      "properties": {
+                        "value": {
+                          "type": "string",
+                          "enum": [
+                            "JS_NORMAL",
+                            "JS_STRING",
+                            "JS_NUMBER"
+                          ]
+                        }
+                      }
+                    }
+                  }
+                ],
+                "required": [
+                  "value"
+                ]
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "modules": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "packages": {
+          "description": "Exact protobuf packages among selected modules. Empty means all source files. Imports remain available for compilation; with_imports separately controls dependency generation.",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Za-z_][A-Za-z0-9_]*(\\.[A-Za-z_][A-Za-z0-9_]*)*$"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "options": {
+      "type": "object",
+      "properties": {
+        "go": {
+          "type": "object",
+          "properties": {
+            "package_prefix": {
+              "description": "Sets go_package without enabling managed defaults for other languages; full managed mode requires generate.managed.enabled.",
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "plugins": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "command": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "name": {
+            "type": "string"
+          },
+          "opts": {
+            "oneOf": [
+              {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              {
+                "type": "object",
+                "additionalProperties": {
+                  "oneOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "type": "array",
+                      "items": {
+                        "oneOf": [
+                          {
+                            "type": "string"
+                          },
+                          {
+                            "type": "number"
+                          },
+                          {
+                            "type": "boolean"
+                          }
+                        ]
+                      }
+                    }
+                  ]
+                }
+              }
+            ]
+          },
+          "out": {
+            "type": "string"
+          },
+          "path": {
+            "type": "string"
+          },
+          "remote": {
+            "type": "string"
+          },
+          "version": {
+            "type": "string"
+          },
+          "with_imports": {
+            "description": "Generate code for transitive imports with this plugin only; defaults to false. Independent from descriptor --include_imports.",
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false,
+        "oneOf": [
+          {
+            "required": [
+              "name"
+            ]
+          },
+          {
+            "required": [
+              "path"
+            ]
+          },
+          {
+            "required": [
+              "command"
+            ]
+          },
+          {
+            "required": [
+              "remote"
+            ]
+          }
+        ],
+        "allOf": [
+          {
+            "if": {
+              "required": [
+                "remote"
+              ]
+            },
+            "then": {
+              "required": [
+                "version"
+              ]
+            }
+          },
+          {
+            "if": {
+              "not": {
+                "required": [
+                  "remote"
+                ]
+              }
+            },
+            "then": {
+              "not": {
+                "required": [
+                  "version"
+                ]
+              }
+            }
+          }
+        ],
+        "required": [
+          "out"
+        ]
+      }
+    },
+    "version": {
+      "type": "string",
+      "const": "v1"
+    }
+  },
+  "additionalProperties": false
+}
diff --git a/schemas/easyp.schema.json b/schemas/easyp.schema.json
new file mode 100644
index 00000000..207ec44b
--- /dev/null
+++ b/schemas/easyp.schema.json
@@ -0,0 +1,280 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "easyp.yaml v1",
+  "description": "Structural v1 YAML schema. EasyP CLI validation applies additional semantic checks.",
+  "type": "object",
+  "properties": {
+    "breaking": {
+      "type": "object",
+      "properties": {
+        "baseline": {
+          "type": "string",
+          "pattern": "^(git:.+)?$"
+        },
+        "categories": {
+          "description": "Selects FILE, PACKAGE, WIRE_JSON, and/or WIRE compatibility profiles. Multiple profiles apply their union; omitted or empty defaults to FILE.",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "FILE",
+              "PACKAGE",
+              "WIRE_JSON",
+              "WIRE"
+            ]
+          }
+        },
+        "extends": {
+          "description": "Base policy for this section only, applied before local adjustments. Use ./ or ../ for a policy file or directory relative to this file, or a module identity already declared in protobuf.mod and locked in protobuf.lock, optionally with #\u003cpolicy-file-or-directory\u003e. A module reference without # loads that module's easyp.yaml. Versions are not repeated here and no new module or revision is acquired. Remote policies are read from the verified module contents of the consuming module; a base's own relative references stay inside its module. Only the referenced section and linters-settings are inherited: issues.exclude-rules, generation settings and the other section are not. Base breaking.ignore paths and the baseline are applied at this file's location, not in the module cache.",
+          "type": "string",
+          "pattern": "^(|\\.\\.?|\\.\\.?/[^\\r\\n\\\\@]+|[^\\s@#]+/[^\\s@#]*(#[^\\s@#]*)?)$"
+        },
+        "ignore": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "ignore_unstable": {
+          "description": "Ignore declarations in packages with unstable version suffixes; stable package checks remain enabled.",
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false
+    },
+    "issues": {
+      "type": "object",
+      "properties": {
+        "exclude-rules": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "linters": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "MINIMAL",
+                    "BASIC",
+                    "DEFAULT",
+                    "COMMENTS",
+                    "UNARY_RPC",
+                    "DIRECTORY_SAME_PACKAGE",
+                    "PACKAGE_DEFINED",
+                    "PACKAGE_DIRECTORY_MATCH",
+                    "PACKAGE_SAME_DIRECTORY",
+                    "ENUM_FIRST_VALUE_ZERO",
+                    "ENUM_NO_ALLOW_ALIAS",
+                    "ENUM_PASCAL_CASE",
+                    "ENUM_VALUE_UPPER_SNAKE_CASE",
+                    "FIELD_LOWER_SNAKE_CASE",
+                    "IMPORT_NO_PUBLIC",
+                    "IMPORT_NO_WEAK",
+                    "IMPORT_USED",
+                    "MESSAGE_PASCAL_CASE",
+                    "ONEOF_LOWER_SNAKE_CASE",
+                    "PACKAGE_LOWER_SNAKE_CASE",
+                    "PACKAGE_SAME_CSHARP_NAMESPACE",
+                    "PACKAGE_SAME_GO_PACKAGE",
+                    "PACKAGE_SAME_JAVA_MULTIPLE_FILES",
+                    "PACKAGE_SAME_JAVA_PACKAGE",
+                    "PACKAGE_SAME_PHP_NAMESPACE",
+                    "PACKAGE_SAME_RUBY_PACKAGE",
+                    "PACKAGE_SAME_SWIFT_PREFIX",
+                    "RPC_PASCAL_CASE",
+                    "SERVICE_PASCAL_CASE",
+                    "ENUM_VALUE_PREFIX",
+                    "ENUM_ZERO_VALUE_SUFFIX",
+                    "FILE_LOWER_SNAKE_CASE",
+                    "RPC_REQUEST_RESPONSE_UNIQUE",
+                    "RPC_REQUEST_STANDARD_NAME",
+                    "RPC_RESPONSE_STANDARD_NAME",
+                    "PACKAGE_VERSION_SUFFIX",
+                    "SERVICE_SUFFIX",
+                    "COMMENT_ENUM",
+                    "COMMENT_ENUM_VALUE",
+                    "COMMENT_FIELD",
+                    "COMMENT_MESSAGE",
+                    "COMMENT_ONEOF",
+                    "COMMENT_RPC",
+                    "COMMENT_SERVICE",
+                    "RPC_NO_CLIENT_STREAMING",
+                    "RPC_NO_SERVER_STREAMING"
+                  ]
+                }
+              },
+              "path": {
+                "description": "Relative to the policy providing this issues section. Supports *, ?, character classes and ** directory segments; a literal directory includes its subtree.",
+                "type": "string"
+              }
+            },
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "linters": {
+      "type": "object",
+      "properties": {
+        "allow_comment_ignores": {
+          "description": "Enable scoped easyp:disable, nolint and buf:lint:ignore comments; defaults to true. State is local to each effective lint policy.",
+          "type": "boolean"
+        },
+        "default": {
+          "type": "string",
+          "enum": [
+            "MINIMAL",
+            "BASIC",
+            "STANDARD",
+            "COMMENTS"
+          ]
+        },
+        "disable": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "MINIMAL",
+              "BASIC",
+              "DEFAULT",
+              "COMMENTS",
+              "UNARY_RPC",
+              "DIRECTORY_SAME_PACKAGE",
+              "PACKAGE_DEFINED",
+              "PACKAGE_DIRECTORY_MATCH",
+              "PACKAGE_SAME_DIRECTORY",
+              "ENUM_FIRST_VALUE_ZERO",
+              "ENUM_NO_ALLOW_ALIAS",
+              "ENUM_PASCAL_CASE",
+              "ENUM_VALUE_UPPER_SNAKE_CASE",
+              "FIELD_LOWER_SNAKE_CASE",
+              "IMPORT_NO_PUBLIC",
+              "IMPORT_NO_WEAK",
+              "IMPORT_USED",
+              "MESSAGE_PASCAL_CASE",
+              "ONEOF_LOWER_SNAKE_CASE",
+              "PACKAGE_LOWER_SNAKE_CASE",
+              "PACKAGE_SAME_CSHARP_NAMESPACE",
+              "PACKAGE_SAME_GO_PACKAGE",
+              "PACKAGE_SAME_JAVA_MULTIPLE_FILES",
+              "PACKAGE_SAME_JAVA_PACKAGE",
+              "PACKAGE_SAME_PHP_NAMESPACE",
+              "PACKAGE_SAME_RUBY_PACKAGE",
+              "PACKAGE_SAME_SWIFT_PREFIX",
+              "RPC_PASCAL_CASE",
+              "SERVICE_PASCAL_CASE",
+              "ENUM_VALUE_PREFIX",
+              "ENUM_ZERO_VALUE_SUFFIX",
+              "FILE_LOWER_SNAKE_CASE",
+              "RPC_REQUEST_RESPONSE_UNIQUE",
+              "RPC_REQUEST_STANDARD_NAME",
+              "RPC_RESPONSE_STANDARD_NAME",
+              "PACKAGE_VERSION_SUFFIX",
+              "SERVICE_SUFFIX",
+              "COMMENT_ENUM",
+              "COMMENT_ENUM_VALUE",
+              "COMMENT_FIELD",
+              "COMMENT_MESSAGE",
+              "COMMENT_ONEOF",
+              "COMMENT_RPC",
+              "COMMENT_SERVICE",
+              "RPC_NO_CLIENT_STREAMING",
+              "RPC_NO_SERVER_STREAMING"
+            ]
+          }
+        },
+        "enable": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "MINIMAL",
+              "BASIC",
+              "DEFAULT",
+              "COMMENTS",
+              "UNARY_RPC",
+              "DIRECTORY_SAME_PACKAGE",
+              "PACKAGE_DEFINED",
+              "PACKAGE_DIRECTORY_MATCH",
+              "PACKAGE_SAME_DIRECTORY",
+              "ENUM_FIRST_VALUE_ZERO",
+              "ENUM_NO_ALLOW_ALIAS",
+              "ENUM_PASCAL_CASE",
+              "ENUM_VALUE_UPPER_SNAKE_CASE",
+              "FIELD_LOWER_SNAKE_CASE",
+              "IMPORT_NO_PUBLIC",
+              "IMPORT_NO_WEAK",
+              "IMPORT_USED",
+              "MESSAGE_PASCAL_CASE",
+              "ONEOF_LOWER_SNAKE_CASE",
+              "PACKAGE_LOWER_SNAKE_CASE",
+              "PACKAGE_SAME_CSHARP_NAMESPACE",
+              "PACKAGE_SAME_GO_PACKAGE",
+              "PACKAGE_SAME_JAVA_MULTIPLE_FILES",
+              "PACKAGE_SAME_JAVA_PACKAGE",
+              "PACKAGE_SAME_PHP_NAMESPACE",
+              "PACKAGE_SAME_RUBY_PACKAGE",
+              "PACKAGE_SAME_SWIFT_PREFIX",
+              "RPC_PASCAL_CASE",
+              "SERVICE_PASCAL_CASE",
+              "ENUM_VALUE_PREFIX",
+              "ENUM_ZERO_VALUE_SUFFIX",
+              "FILE_LOWER_SNAKE_CASE",
+              "RPC_REQUEST_RESPONSE_UNIQUE",
+              "RPC_REQUEST_STANDARD_NAME",
+              "RPC_RESPONSE_STANDARD_NAME",
+              "PACKAGE_VERSION_SUFFIX",
+              "SERVICE_SUFFIX",
+              "COMMENT_ENUM",
+              "COMMENT_ENUM_VALUE",
+              "COMMENT_FIELD",
+              "COMMENT_MESSAGE",
+              "COMMENT_ONEOF",
+              "COMMENT_RPC",
+              "COMMENT_SERVICE",
+              "RPC_NO_CLIENT_STREAMING",
+              "RPC_NO_SERVER_STREAMING"
+            ]
+          }
+        },
+        "extends": {
+          "description": "Base policy for this section only, applied before local adjustments. Use ./ or ../ for a policy file or directory relative to this file, or a module identity already declared in protobuf.mod and locked in protobuf.lock, optionally with #\u003cpolicy-file-or-directory\u003e. A module reference without # loads that module's easyp.yaml. Versions are not repeated here and no new module or revision is acquired. Remote policies are read from the verified module contents of the consuming module; a base's own relative references stay inside its module. Only the referenced section and linters-settings are inherited: issues.exclude-rules, generation settings and the other section are not. Base breaking.ignore paths and the baseline are applied at this file's location, not in the module cache.",
+          "type": "string",
+          "pattern": "^(|\\.\\.?|\\.\\.?/[^\\r\\n\\\\@]+|[^\\s@#]+/[^\\s@#]*(#[^\\s@#]*)?)$"
+        }
+      },
+      "additionalProperties": false
+    },
+    "linters-settings": {
+      "type": "object",
+      "properties": {
+        "ENUM_ZERO_VALUE_SUFFIX": {
+          "type": "object",
+          "properties": {
+            "suffix": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        },
+        "SERVICE_SUFFIX": {
+          "type": "object",
+          "properties": {
+            "suffix": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "version": {
+      "type": "string",
+      "const": "v1"
+    }
+  },
+  "additionalProperties": false
+}
diff --git a/schemas/protobuf.lock-v1.schema.json b/schemas/protobuf.lock-v1.schema.json
new file mode 100644
index 00000000..8d14fe7d
--- /dev/null
+++ b/schemas/protobuf.lock-v1.schema.json
@@ -0,0 +1,118 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "protobuf.lock v1",
+  "description": "Structural v1 YAML schema. EasyP CLI validation applies additional semantic checks.",
+  "type": "object",
+  "properties": {
+    "modules": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "bsr": {
+            "description": "BSR requests and their pinned Git targets, recorded on the requiring Git module. Frozen commands replay these bindings without consulting a resolver. compatibility_snapshot does not guarantee BSR revision equivalence or verify the BSR digest.",
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "dependency": {
+                  "type": "object",
+                  "properties": {
+                    "commit": {
+                      "type": "string",
+                      "pattern": "^[0-9a-fA-F]{32}$"
+                    },
+                    "config": {
+                      "description": "Declaring buf.yaml path relative to the verified Git checkout.",
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "digest": {
+                      "type": "string",
+                      "pattern": "^[^:\\s]+:[0-9a-fA-F]+$"
+                    },
+                    "module": {
+                      "type": "string",
+                      "pattern": "^[^/:\\s]+/[^/:\\s]+/[^/:\\s]+$"
+                    },
+                    "reference": {
+                      "type": "string",
+                      "pattern": "^[^:\\s]*$"
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "module",
+                    "config"
+                  ]
+                },
+                "git": {
+                  "type": "object",
+                  "properties": {
+                    "module": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "version": {
+                      "type": "string",
+                      "pattern": "^(v[0-9]+\\.[0-9]+\\.[0-9]+([+-][0-9A-Za-z.-]+)?|[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$"
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "module",
+                    "version"
+                  ]
+                },
+                "resolution": {
+                  "type": "string",
+                  "enum": [
+                    "compatibility_snapshot",
+                    "exact"
+                  ]
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "dependency",
+                "git",
+                "resolution"
+              ]
+            }
+          },
+          "commit": {
+            "type": "string",
+            "pattern": "^([0-9a-fA-F]{40}|[0-9a-fA-F]{64})$"
+          },
+          "hash": {
+            "type": "string",
+            "pattern": "^h1:[A-Za-z0-9+/]{43}=$"
+          },
+          "source": {
+            "type": "string",
+            "minLength": 1
+          },
+          "version": {
+            "type": "string",
+            "pattern": "^(v[0-9]+\\.[0-9]+\\.[0-9]+([+-][0-9A-Za-z.-]+)?|[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$"
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "source",
+          "version",
+          "commit",
+          "hash"
+        ]
+      }
+    },
+    "version": {
+      "type": "integer",
+      "const": 1
+    }
+  },
+  "additionalProperties": false,
+  "required": [
+    "version"
+  ]
+}
diff --git a/schemas/protobuf.lock.schema.json b/schemas/protobuf.lock.schema.json
new file mode 100644
index 00000000..8d14fe7d
--- /dev/null
+++ b/schemas/protobuf.lock.schema.json
@@ -0,0 +1,118 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "protobuf.lock v1",
+  "description": "Structural v1 YAML schema. EasyP CLI validation applies additional semantic checks.",
+  "type": "object",
+  "properties": {
+    "modules": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "bsr": {
+            "description": "BSR requests and their pinned Git targets, recorded on the requiring Git module. Frozen commands replay these bindings without consulting a resolver. compatibility_snapshot does not guarantee BSR revision equivalence or verify the BSR digest.",
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "dependency": {
+                  "type": "object",
+                  "properties": {
+                    "commit": {
+                      "type": "string",
+                      "pattern": "^[0-9a-fA-F]{32}$"
+                    },
+                    "config": {
+                      "description": "Declaring buf.yaml path relative to the verified Git checkout.",
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "digest": {
+                      "type": "string",
+                      "pattern": "^[^:\\s]+:[0-9a-fA-F]+$"
+                    },
+                    "module": {
+                      "type": "string",
+                      "pattern": "^[^/:\\s]+/[^/:\\s]+/[^/:\\s]+$"
+                    },
+                    "reference": {
+                      "type": "string",
+                      "pattern": "^[^:\\s]*$"
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "module",
+                    "config"
+                  ]
+                },
+                "git": {
+                  "type": "object",
+                  "properties": {
+                    "module": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "version": {
+                      "type": "string",
+                      "pattern": "^(v[0-9]+\\.[0-9]+\\.[0-9]+([+-][0-9A-Za-z.-]+)?|[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$"
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "module",
+                    "version"
+                  ]
+                },
+                "resolution": {
+                  "type": "string",
+                  "enum": [
+                    "compatibility_snapshot",
+                    "exact"
+                  ]
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "dependency",
+                "git",
+                "resolution"
+              ]
+            }
+          },
+          "commit": {
+            "type": "string",
+            "pattern": "^([0-9a-fA-F]{40}|[0-9a-fA-F]{64})$"
+          },
+          "hash": {
+            "type": "string",
+            "pattern": "^h1:[A-Za-z0-9+/]{43}=$"
+          },
+          "source": {
+            "type": "string",
+            "minLength": 1
+          },
+          "version": {
+            "type": "string",
+            "pattern": "^(v[0-9]+\\.[0-9]+\\.[0-9]+([+-][0-9A-Za-z.-]+)?|[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$"
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "source",
+          "version",
+          "commit",
+          "hash"
+        ]
+      }
+    },
+    "version": {
+      "type": "integer",
+      "const": 1
+    }
+  },
+  "additionalProperties": false,
+  "required": [
+    "version"
+  ]
+}
diff --git a/scripts/check-dev-tools.sh b/scripts/check-dev-tools.sh
new file mode 100644
index 00000000..5fe8d811
--- /dev/null
+++ b/scripts/check-dev-tools.sh
@@ -0,0 +1,185 @@
+#!/bin/sh
+# Offline Taskfile regression checks. No real installer, Go tool or Docker is run.
+set -eu
+repo=$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)
+task_bin=$(command -v task) || { echo 'Task 3 is required on PATH.' >&2; exit 1; }
+work=$(mktemp -d)
+work=$(CDPATH= cd -- "$work" && pwd -P)
+trap 'rm -rf "$work"' EXIT HUP INT TERM
+fixture="$work/repo with spaces and 'quotes'"
+trace_bin="$work/trace bin"
+mkdir -p "$fixture/bin" "$fixture/nested/dir" "$trace_bin" "$work/tmp dir"
+cp "$repo/Taskfile.yml" "$repo/.mockery.yaml" "$repo/Dockerfile" "$repo/go.mod" "$repo/go.sum" "$fixture/"
+cp "$fixture/go.mod" "$work/go.mod.before"
+cp "$fixture/go.sum" "$work/go.sum.before"
+
+# An allowlist PATH prevents regressions from reaching real network/system tools.
+for utility in sh cat cmp mkdir mktemp rm; do
+    ln -s "$(command -v "$utility")" "$trace_bin/$utility"
+done
+ln -s "$task_bin" "$trace_bin/task"
+cat > "$work/trace-tool" <<'SH'
+#!/bin/sh
+set -eu
+tool=${0##*/}
+entry="$tool cwd=<$PWD>"
+for arg do entry="$entry <$arg>"; done
+printf '%s\n' "$entry" >> "$TRACE_DIR/$tool.log"
+test "$PWD" = "$FIXTURE" || { echo 'Tool ran outside repository root' >&2; exit 1; }
+case "$tool" in
+    go)
+        case "$*" in
+            'mod download') ;;
+            'install gotest.tools/gotestsum@v1.13.0'|'install github.com/vektra/mockery/v2@v2.53.7')
+                test "$GOBIN" = "$FIXTURE/bin" ;;
+            *) echo "Unexpected Go command: $*" >&2; exit 1 ;;
+        esac ;;
+    golangci-lint)
+        test "$#" = 2 && test "$1" = run && test "$2" = ./...
+        exit "${GO_LINT_EXIT:-0}" ;;
+    gotestsum)
+        test "$*" = '--format pkgname -- -coverprofile=coverage.out -race -count=1 ./...' ;;
+    mockery)
+        test "$#" = 6 && test "$1" = --name && test "$3" = --dir && test "$5" = --output
+        test "$6" = "$4/mocks"
+        case "$2:$4" in
+            Rule:./internal/core|CurrentProjectGitWalker:./internal/core|Console:./internal/adapters/console|Example:'./interface dir') ;;
+            *) echo "Unexpected mock owner: $*" >&2; exit 1 ;;
+        esac ;;
+    docker)
+        case "$1" in
+            run)
+                test "$*" = 'run --rm -i ghcr.io/hadolint/hadolint:v2.12.1-beta'
+                cmp - "$FIXTURE/Dockerfile"
+                exit "${DOCKER_LINT_EXIT:-0}" ;;
+            build)
+                test "$#" = 6 && test "$2" = -f && test "$3" = "$FIXTURE/Dockerfile"
+                test "$4" = -t && test "$6" = "$FIXTURE"
+                case "$5" in easyp:local|easyp:smoke|easyp:alias-smoke) ;; *) exit 1 ;; esac ;;
+            *) echo "Unexpected Docker action: $*" >&2; exit 1 ;;
+        esac ;;
+    curl)
+        test "$#" = 4 && test "$1" = -fsSL
+        test "$2" = https://raw.githubusercontent.com/golangci/golangci-lint/v2.14.0/install.sh
+        test "$3" = -o
+        cat > "$4" <<'INSTALLER'
+#!/bin/sh
+set -eu
+test "$#" = 3 && test "$1" = -b && test "$2" = "$FIXTURE/bin" && test "$3" = v2.14.0
+printf '%s\n' installed >> "$TRACE_DIR/installer.log"
+exit "${INSTALLER_EXIT:-0}"
+INSTALLER
+        exit "${CURL_EXIT:-0}" ;;
+    *) echo "Unexpected tool: $tool" >&2; exit 1 ;;
+esac
+SH
+chmod +x "$work/trace-tool"
+for utility in go docker curl; do
+    ln -s "$work/trace-tool" "$trace_bin/$utility"
+done
+for utility in golangci-lint gotestsum mockery; do
+    ln -s "$work/trace-tool" "$fixture/bin/$utility"
+done
+
+run_task() {
+    (cd "$fixture/nested/dir" && env -i PATH="$trace_bin" TMPDIR="$work/tmp dir" LC_ALL=C \
+        FIXTURE="$fixture" TRACE_DIR="$work" \
+        GO_LINT_EXIT="${GO_LINT_EXIT:-0}" DOCKER_LINT_EXIT="${DOCKER_LINT_EXIT:-0}" \
+        CURL_EXIT="${CURL_EXIT:-0}" INSTALLER_EXIT="${INSTALLER_EXIT:-0}" \
+        "$task_bin" "$@")
+}
+pass() {
+    if ! run_task "$@" > "$work/task.log" 2>&1; then
+        cat "$work/task.log" >&2
+        echo "Expected task to succeed: $*" >&2
+        exit 1
+    fi
+}
+fail() {
+    if run_task "$@" > "$work/task.log" 2>&1; then
+        echo "Expected task to fail: $*" >&2
+        exit 1
+    fi
+}
+contains() {
+    grep -F -- "$2" "$1" > /dev/null || { cat "$1" >&2; echo "Missing: $2" >&2; exit 1; }
+}
+
+pass --list
+pass lint:go
+pass lint:docker
+pass lint
+pass test
+pass mocks
+pass mock NAME=Example 'DIR=./interface dir'
+# Aggregate subprocess tasks must preserve explicit local-tool overrides.
+alternate_bin="$fixture/alternate tools with 'quotes'"
+mv "$fixture/bin" "$alternate_bin"
+pass lint "LOCAL_BIN=$alternate_bin"
+pass test "LOCAL_BIN=$alternate_bin"
+pass mocks "LOCAL_BIN=$alternate_bin"
+mv "$alternate_bin" "$fixture/bin"
+contains "$work/mockery.log" '<Console> <--dir> <./internal/adapters/console>'
+contains "$work/mockery.log" '<Rule> <--dir> <./internal/core>'
+contains "$work/mockery.log" '<CurrentProjectGitWalker> <--dir> <./internal/core>'
+
+# Each aggregate must attempt both checks, including when the first one fails.
+for failing_linter in go docker; do
+    : > "$work/golangci-lint.log"
+    : > "$work/docker.log"
+    if test "$failing_linter" = go; then
+        GO_LINT_EXIT=23; export GO_LINT_EXIT
+    else
+        DOCKER_LINT_EXIT=24; export DOCKER_LINT_EXIT
+    fi
+    fail lint
+    contains "$work/golangci-lint.log" '<run> <./...>'
+    contains "$work/docker.log" '<run> <--rm> <-i>'
+    unset GO_LINT_EXIT DOCKER_LINT_EXIT
+done
+
+for spec in 'golangci-lint lint:go install_linters' 'gotestsum test install_gotestsum' 'mockery mocks install_mockery'; do
+    set -- $spec
+    mv "$fixture/bin/$1" "$fixture/bin/$1.saved"
+    fail "$2"
+    contains "$work/task.log" "task $3"
+    mv "$fixture/bin/$1.saved" "$fixture/bin/$1"
+done
+mv "$trace_bin/docker" "$trace_bin/docker.saved"
+fail lint:docker
+contains "$work/task.log" 'Docker is required'
+fail docker:build
+contains "$work/task.log" 'Docker is required'
+mv "$trace_bin/docker.saved" "$trace_bin/docker"
+
+pass init
+contains "$work/go.log" '<mod> <download>'
+contains "$work/installer.log" installed
+cp "$work/installer.log" "$work/installer.before"
+CURL_EXIT=22; export CURL_EXIT
+fail install_linters
+unset CURL_EXIT
+cmp "$work/installer.before" "$work/installer.log"
+INSTALLER_EXIT=25; export INSTALLER_EXIT
+fail install_linters
+unset INSTALLER_EXIT
+
+: > "$work/docker.log"
+pass docker
+pass docker:build DOCKER_IMAGE=easyp:smoke
+pass docker DOCKER_IMAGE=easyp:alias-smoke
+contains "$work/docker.log" '<-t> <easyp:local>'
+contains "$work/docker.log" '<-t> <easyp:smoke>'
+contains "$work/docker.log" '<-t> <easyp:alias-smoke>'
+for obsolete in docker_base docker_lint docker_push; do
+    fail "$obsolete"
+done
+if grep -E '<(push|prune|system|tag)>' "$work/docker.log"; then
+    echo 'Docker helper attempted a forbidden action' >&2
+    exit 1
+fi
+cmp "$work/go.mod.before" "$fixture/go.mod"
+cmp "$work/go.sum.before" "$fixture/go.sum"
+test ! -e "$fixture/nested/dir/bin"
+test ! -e "$fixture/easyp"
+printf '%s\n' 'Dev tools: offline dispatch, quoting, failures, local Docker builds and manifest checks passed.'
diff --git a/scripts/check-proto-example.sh b/scripts/check-proto-example.sh
new file mode 100755
index 00000000..86494993
--- /dev/null
+++ b/scripts/check-proto-example.sh
@@ -0,0 +1,23 @@
+#!/bin/sh
+set -eu
+repo=$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)
+work=$(mktemp -d)
+trap 'rm -rf "$work"' EXIT HUP INT TERM
+cd "$repo"
+go build -o "$work/easyp" ./cmd/easyp
+cp easyp.yaml easyp.gen.yaml protobuf.mod protobuf.lock "$work/"
+mkdir -p "$work/examples"
+cp -R examples/proto "$work/examples/proto"
+cd "$work"
+export EASYPPATH="$work/cache"
+./easyp validate-config
+./easyp mod tidy
+cmp protobuf.lock "$repo/protobuf.lock"
+./easyp lint --root examples/proto
+./easyp generate --descriptor_set_out first.pb --include_imports
+cp -R examples/generated first-generated
+./easyp generate --descriptor_set_out second.pb --include_imports
+cmp first.pb second.pb
+diff -r first-generated examples/generated
+test -s examples/generated/python/hello/v1/hello_pb2.py
+printf '%s\n' 'Native v1 example: validation, lint, lock and deterministic generation passed.'
diff --git a/scripts/release_test.go b/scripts/release_test.go
new file mode 100644
index 00000000..175dedd7
--- /dev/null
+++ b/scripts/release_test.go
@@ -0,0 +1,320 @@
+package scripts
+
+import (
+	"bytes"
+	"os"
+	"os/exec"
+	"path/filepath"
+	"strings"
+	"testing"
+	"text/template"
+
+	"github.com/stretchr/testify/require"
+	"gopkg.in/yaml.v3"
+)
+
+type releaseConfig struct {
+	Builds []struct {
+		ID      string   `yaml:"id"`
+		Ldflags []string `yaml:"ldflags"`
+	} `yaml:"builds"`
+	Release struct {
+		Prerelease string `yaml:"prerelease"`
+		MakeLatest string `yaml:"make_latest"`
+	} `yaml:"release"`
+	Dockers []struct {
+		Tags  []string `yaml:"tags"`
+		Flags []string `yaml:"flags"`
+	} `yaml:"dockers_v2"`
+	Brews []struct {
+		SkipUpload string `yaml:"skip_upload"`
+	} `yaml:"brews"`
+}
+
+type releaseTemplateData struct {
+	Tag        string
+	Version    string
+	Prerelease string
+	IsSnapshot bool
+}
+
+func TestReleaseChannels(t *testing.T) {
+	t.Parallel()
+
+	contents, err := os.ReadFile("../.goreleaser.yaml")
+	require.NoError(t, err)
+	var config releaseConfig
+	err = yaml.Unmarshal(contents, &config)
+	require.NoError(t, err)
+	require.Equal(t, "true", config.Release.Prerelease)
+	require.Len(t, config.Builds, 2)
+	require.Len(t, config.Dockers, 1)
+	require.Empty(t, config.Brews)
+
+	tests := []struct {
+		name       string
+		data       releaseTemplateData
+		wantLatest string
+		wantTags   []string
+		wantBuild  string
+	}{
+		{
+			name:       "accidental stable version cannot update release defaults",
+			data:       releaseTemplateData{Tag: "v1.0.0", Version: "1.0.0"},
+			wantLatest: "false",
+			wantTags:   []string{"v1.0.0"},
+			wantBuild:  "v1.0.0",
+		},
+		{
+			name:       "nightly requires an explicit tag",
+			data:       releaseTemplateData{Tag: "v1.0.0-nightly.20261005.1", Version: "1.0.0-nightly.20261005.1", Prerelease: "nightly.20261005.1"},
+			wantLatest: "false",
+			wantTags:   []string{"v1.0.0-nightly.20261005.1"},
+			wantBuild:  "v1.0.0-nightly.20261005.1",
+		},
+		{
+			name:       "other prereleases cannot overwrite defaults",
+			data:       releaseTemplateData{Tag: "v1.0.0-rc.1", Version: "1.0.0-rc.1", Prerelease: "rc.1"},
+			wantLatest: "false",
+			wantTags:   []string{"v1.0.0-rc.1"},
+			wantBuild:  "v1.0.0-rc.1",
+		},
+		{
+			name:       "snapshot keeps its build identity",
+			data:       releaseTemplateData{Tag: "v0.17.0", Version: "SNAPSHOT-1234567", IsSnapshot: true},
+			wantLatest: "false",
+			wantTags:   []string{"v0.17.0"},
+			wantBuild:  "SNAPSHOT-1234567",
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			require.Equal(t, tt.wantLatest, renderReleaseTemplate(t, config.Release.MakeLatest, tt.data))
+			var tags []string
+			for _, raw := range config.Dockers[0].Tags {
+				tag := renderReleaseTemplate(t, raw, tt.data)
+				if tag != "" {
+					tags = append(tags, tag)
+				}
+			}
+			require.Equal(t, tt.wantTags, tags)
+			for _, build := range config.Builds {
+				flags := renderReleaseTemplate(t, strings.Join(build.Ldflags, " "), tt.data)
+				var versions []string
+				fields := strings.Fields(flags)
+				for index, field := range fields {
+					var assignment string
+					switch {
+					case field == "-X":
+						require.Less(t, index+1, len(fields))
+						assignment = fields[index+1]
+					case strings.HasPrefix(field, "-X="):
+						assignment = strings.TrimPrefix(field, "-X=")
+					default:
+						continue
+					}
+					value, ok := strings.CutPrefix(assignment, "github.com/easyp-tech/easyp/internal/version.releaseVersion=")
+					if ok {
+						versions = append(versions, value)
+					}
+				}
+				require.Equal(t, []string{tt.wantBuild}, versions, build.ID)
+			}
+			var dockerVersions []string
+			for index, raw := range config.Dockers[0].Flags {
+				flag := renderReleaseTemplate(t, raw, tt.data)
+				var assignment string
+				switch {
+				case flag == "--build-arg":
+					require.Less(t, index+1, len(config.Dockers[0].Flags))
+					assignment = renderReleaseTemplate(t, config.Dockers[0].Flags[index+1], tt.data)
+				case strings.HasPrefix(flag, "--build-arg="):
+					assignment = strings.TrimPrefix(flag, "--build-arg=")
+				default:
+					continue
+				}
+				value, ok := strings.CutPrefix(assignment, "RELEASE_VERSION=")
+				if ok {
+					dockerVersions = append(dockerVersions, value)
+				}
+			}
+			require.Equal(t, []string{tt.wantBuild}, dockerVersions)
+		})
+	}
+}
+
+func renderReleaseTemplate(t *testing.T, raw string, data releaseTemplateData) string {
+	t.Helper()
+
+	tmpl, err := template.New("release").Option("missingkey=error").Parse(raw)
+	require.NoError(t, err)
+	var output bytes.Buffer
+	err = tmpl.Execute(&output, data)
+	require.NoError(t, err)
+	return output.String()
+}
+
+func TestReleaseTagValidation(t *testing.T) {
+	t.Parallel()
+
+	script, err := filepath.Abs("validate-release-tag.sh")
+	require.NoError(t, err)
+	root := t.TempDir()
+	git := func(args ...string) string {
+		t.Helper()
+		cmd := exec.Command("git", args...)
+		cmd.Dir = root
+		output, err := cmd.CombinedOutput()
+		require.NoError(t, err, string(output))
+		return strings.TrimSpace(string(output))
+	}
+	git("init", "-b", "v1.0")
+	git("-c", "user.name=Release Test", "-c", "user.email=release@example.invalid", "commit", "--allow-empty", "-m", "v1 nightly source")
+	git("update-ref", "refs/remotes/origin/v1.0", "HEAD")
+	git("branch", "unrelated")
+	git("checkout", "-b", "main")
+	git("-c", "user.name=Release Test", "-c", "user.email=release@example.invalid", "commit", "--allow-empty", "-m", "v1 source on main")
+	git("update-ref", "refs/remotes/origin/main", "HEAD")
+	git("tag", "v1.0.0-nightly.20261005.4")
+	git("checkout", "unrelated")
+	git("-c", "user.name=Release Test", "-c", "user.email=release@example.invalid", "commit", "--allow-empty", "-m", "outside v1.0")
+	git("tag", "v1.0.0-nightly.20261005.2")
+	git("checkout", "v1.0")
+
+	tests := []struct {
+		name   string
+		tag    string
+		want   string
+		wantOK bool
+	}{
+		{name: "v1 stable cannot be published", tag: "v1.0.0", want: "Unsupported release tag"},
+		{name: "v0 stable uses its original release pipeline", tag: "v0.17.1", want: "Unsupported release tag"},
+		{name: "nightly on v1.0", tag: "v1.0.0-nightly.20261005.1", want: "nightly\n", wantOK: true},
+		{name: "nightly on main after merge", tag: "v1.0.0-nightly.20261005.4", want: "nightly\n", wantOK: true},
+		{name: "nightly outside release branches", tag: "v1.0.0-nightly.20261005.2", want: "is not in origin/v1.0 or origin/main history"},
+		{name: "rc", tag: "v1.0.0-rc.1", want: "Unsupported release tag"},
+		{name: "other v1 nightly base", tag: "v1.1.0-nightly.20261005.1", want: "Unsupported release tag"},
+		{name: "date missing", tag: "v1.0.0-nightly", want: "Unsupported release tag"},
+		{name: "leading zero sequence", tag: "v1.0.0-nightly.20261005.01", want: "Unsupported release tag"},
+		{name: "zero sequence", tag: "v1.0.0-nightly.20261005.0", want: "Unsupported release tag"},
+		{name: "leading zero semver", tag: "v01.0.0", want: "Unsupported release tag"},
+		{name: "nonexistent tag", tag: "v1.0.0-nightly.20261005.3", want: "does not resolve to a commit"},
+	}
+	for _, tt := range tests {
+		if tt.tag != "v1.0.0-nightly.20261005.2" && tt.tag != "v1.0.0-nightly.20261005.3" && tt.tag != "v1.0.0-nightly.20261005.4" {
+			git("tag", tt.tag)
+		}
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			cmd := exec.Command("bash", script, tt.tag)
+			cmd.Dir = root
+			output, err := cmd.CombinedOutput()
+			if tt.wantOK {
+				require.NoError(t, err, string(output))
+				require.Equal(t, tt.want, string(output))
+				return
+			}
+			require.Error(t, err)
+			require.Contains(t, string(output), tt.want)
+		})
+	}
+
+	branchTests := []struct {
+		name string
+		keep string
+		tag  string
+	}{
+		{name: "main only after deleting v1.0", keep: "main", tag: "v1.0.0-nightly.20261005.4"},
+		{name: "v1.0 only", keep: "v1.0", tag: "v1.0.0-nightly.20261005.1"},
+		{name: "no source branches", tag: "v1.0.0-nightly.20261005.1"},
+	}
+	for _, tt := range branchTests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			clone := t.TempDir()
+			cmd := exec.Command("git", "clone", "--no-hardlinks", "--local", root, clone)
+			output, err := cmd.CombinedOutput()
+			require.NoError(t, err, string(output))
+			for _, branch := range []string{"main", "v1.0"} {
+				if branch == tt.keep {
+					continue
+				}
+				cmd = exec.Command("git", "update-ref", "-d", "refs/remotes/origin/"+branch)
+				cmd.Dir = clone
+				output, err = cmd.CombinedOutput()
+				require.NoError(t, err, string(output))
+			}
+			cmd = exec.Command("bash", script, tt.tag)
+			cmd.Dir = clone
+			var stdout, stderr bytes.Buffer
+			cmd.Stdout = &stdout
+			cmd.Stderr = &stderr
+			err = cmd.Run()
+			if tt.keep == "" {
+				require.Error(t, err)
+				require.Empty(t, stdout.String())
+				require.Contains(t, stderr.String(), "is not in origin/v1.0 or origin/main history")
+				return
+			}
+			require.NoError(t, err, stderr.String())
+			require.Equal(t, "nightly\n", stdout.String())
+			require.Empty(t, stderr.String())
+		})
+	}
+}
+
+func TestReleaseWorkflow(t *testing.T) {
+	t.Parallel()
+
+	contents, err := os.ReadFile("../.github/workflows/release.yml")
+	require.NoError(t, err)
+	var workflow struct {
+		On   map[string]yaml.Node `yaml:"on"`
+		Jobs map[string]struct {
+			Steps []struct {
+				Uses string            `yaml:"uses"`
+				Run  string            `yaml:"run"`
+				With map[string]string `yaml:"with"`
+			} `yaml:"steps"`
+		} `yaml:"jobs"`
+	}
+	err = yaml.Unmarshal(contents, &workflow)
+	require.NoError(t, err)
+	require.Len(t, workflow.On, 1, "this workflow must publish only on explicit tag pushes")
+	push, ok := workflow.On["push"]
+	require.True(t, ok)
+	var trigger struct {
+		Tags []string `yaml:"tags"`
+	}
+	err = push.Decode(&trigger)
+	require.NoError(t, err)
+	require.Equal(t, []string{"v1.0.0-nightly.*"}, trigger.Tags)
+	job, ok := workflow.Jobs["release"]
+	require.True(t, ok)
+	guard := -1
+	checkedOut := false
+	releaseAction := false
+	for index, step := range job.Steps {
+		if strings.HasPrefix(step.Uses, "actions/checkout@") {
+			require.Equal(t, "0", step.With["fetch-depth"])
+			checkedOut = true
+		}
+		if strings.Contains(step.Run, "scripts/validate-release-tag.sh") {
+			require.True(t, checkedOut)
+			require.Contains(t, step.Run, `"$GITHUB_REF_NAME"`)
+			guard = index
+		}
+		if strings.HasPrefix(step.Uses, "docker/login-action@") || strings.HasPrefix(step.Uses, "goreleaser/goreleaser-action@") {
+			require.GreaterOrEqual(t, guard, 0, "release must validate the tag before accessing publishing credentials")
+			require.Less(t, guard, index)
+		}
+		if strings.HasPrefix(step.Uses, "goreleaser/goreleaser-action@") {
+			require.Equal(t, "v2.18.2", step.With["version"])
+			releaseAction = true
+		}
+	}
+	require.True(t, releaseAction)
+}
diff --git a/scripts/validate-release-tag.sh b/scripts/validate-release-tag.sh
new file mode 100644
index 00000000..f67e0410
--- /dev/null
+++ b/scripts/validate-release-tag.sh
@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+tag=${1:-${GITHUB_REF_NAME:-}}
+nightly='^v1\.0\.0-nightly\.[1-9][0-9]{7}\.[1-9][0-9]*$'
+
+if [[ ! $tag =~ $nightly ]]; then
+  echo "Unsupported release tag: $tag" >&2
+  echo "This branch only publishes v1.0.0-nightly.YYYYMMDD.N (N starts at 1)." >&2
+  exit 1
+fi
+
+if ! git rev-parse --verify --quiet "refs/tags/$tag^{commit}" > /dev/null; then
+  echo "Release tag $tag does not resolve to a commit." >&2
+  exit 1
+fi
+
+for branch in origin/main origin/v1.0; do
+  if git rev-parse --verify --quiet "refs/remotes/$branch^{commit}" > /dev/null &&
+     git merge-base --is-ancestor "refs/tags/$tag^{commit}" "refs/remotes/$branch"; then
+    printf '%s\n' nightly
+    exit 0
+  fi
+done
+
+echo "Nightly tag $tag is not in origin/v1.0 or origin/main history." >&2
+exit 1